sglang/scripts/release/README.md

Release Scripts

This directory contains scripts to automate version bumping for SGLang releases.

Scripts

bump_sglang_version.py

Updates SGLang version across all relevant files following the pattern from PR #10468.

Usage:

python scripts/release/bump_sglang_version.py 0.5.3rc0

Files updated:

• Makefile
• benchmark/deepseek_v3/README.md
• docker/rocm.Dockerfile
• docs/get_started/install.md
• docs/platforms/amd_gpu.md
• docs/platforms/ascend_npu.md
• python/pyproject.toml
• python/pyproject_other.toml
• python/pyproject_npu.toml
• python/sglang/version.py

bump_kernel_version.py

Updates sgl-kernel version across all relevant files following the pattern from PR #10732.

Usage:

python scripts/release/bump_kernel_version.py 0.3.12

Files updated:

• sgl-kernel/pyproject.toml
• sgl-kernel/pyproject_cpu.toml
• sgl-kernel/pyproject_rocm.toml
• sgl-kernel/python/sgl_kernel/version.py

Manual Testing Instructions

Test SGLang Version Bump

1. Run the script:

   python scripts/release/bump_sglang_version.py 0.5.4rc0
   

2. Verify changes with git diff:

   git diff
   

3. Check specific files contain the new version:

   grep -r "0.5.4rc0" python/sglang/version.py
   grep -r "0.5.4rc0" python/pyproject.toml
   grep -r "0.5.4rc0" docs/get_started/install.md
   

4. Reset changes (if testing):

   git checkout .
   

Test Kernel Version Bump

1. Run the script:

   python scripts/release/bump_kernel_version.py 0.3.13
   

2. Verify changes with git diff:

   git diff
   

3. Check specific files contain the new version:

   grep -r "0.3.13" sgl-kernel/python/sgl_kernel/version.py
   grep -r "0.3.13" sgl-kernel/pyproject.toml
   

4. Reset changes (if testing):

   git checkout .
   

Version Format Validation

• SGLang versions: X.Y.Z or X.Y.ZrcN (e.g., 0.5.3 or 0.5.3rc0)
• Kernel versions: X.Y.Z (e.g., 0.3.12)

The scripts will validate the version format and exit with an error if invalid.