.pre-commit-config.yaml

default_stages: [pre-commit, pre-push, manual]
exclude: ^(python/sglang/multimodal_gen/csrc|python/sglang/kernels/ops/diffusion/render|python/sglang/kernels/ops/attention/flash_attn/cute)

repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v6.0.0
    hooks:
      - id: check-symlinks
      - id: destroyed-symlinks
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
        args: [--allow-multiple-documents]
        # Helm chart templates embed Go template syntax ({{- ... -}})
        # that is not valid YAML on its own; the rendered output is
        # validated by `helm template` / `helm lint`.
        exclude: ^experimental/sgl-router/helm/.*/templates/.*\.(yaml|tpl)$
      - id: check-toml
      - id: check-ast
      - id: check-added-large-files
        args: ['--maxkb=1500']
      - id: check-merge-conflict
      - id: check-shebang-scripts-are-executable
      - id: detect-private-key
        exclude: ^sgl-model-gateway/tests/.*_test\.rs$
      - id: debug-statements
      - id: no-commit-to-branch
  - repo: https://github.com/PyCQA/isort
    rev: 7.0.0
    hooks:
      - id: isort
        exclude: '^python/sglang/srt/grpc/.*_pb2\.py$|^python/sglang/srt/grpc/.*_pb2_grpc\.py$|^python/sglang/srt/grpc/.*_pb2\.pyi$|^python/sglang/srt/grpc/.*_pb2_grpc\.pyi$'
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.15.1
    hooks:
      - id: ruff
        args:
          - --select=F401,F821,UP037
          - --fix
        files: ^(benchmark/|docs/|examples/|python/sglang/|sgl-model-gateway/py_*|test/)
        exclude: |
          (?x)^(
          .*/__init__\.py$|
          .*\.ipynb$|
          python/sglang/kernels/aot/.*|
          python/sglang/srt/grpc/.*_pb2\.py$|
          python/sglang/srt/grpc/.*_pb2_grpc\.py$|
          python/sglang/srt/grpc/.*_pb2\.pyi$|
          python/sglang/srt/grpc/.*_pb2_grpc\.pyi$|
          )$
  - repo: https://github.com/psf/black
    rev: 26.1.0
    hooks:
      - id: black-jupyter
        exclude: '^python/sglang/srt/grpc/.*_pb2\.py$|^python/sglang/srt/grpc/.*_pb2_grpc\.py$|^python/sglang/srt/grpc/.*_pb2\.pyi$|^python/sglang/srt/grpc/.*_pb2_grpc\.pyi$'
  - repo: https://github.com/codespell-project/codespell
    rev: v2.4.1
    hooks:
      - id: codespell
        args: ['--config', '.codespellrc']
  - repo: https://github.com/pre-commit/mirrors-clang-format
    rev: v20.1.7
    hooks:
    - id: clang-format
      types_or: [c++, cuda]
      args: [--style=file, --verbose]
  - repo: https://github.com/kynan/nbstripout
    rev: 0.9.0
    hooks:
      - id: nbstripout
        args:
          - '--keep-output'
          - '--extra-keys=metadata.kernelspec metadata.language_info.version'
  - repo: local
    hooks:
      - id: forbid-docs-new-path
        name: forbid docs_new/ (renamed to docs/)
        # docs_new/ was renamed to docs/ in #32123. `language: fail` fires only
        # when a staged path matches `files:` below, then prints the offending
        # paths — no shell/merge-base logic, so none of the shallow-checkout or
        # silent-diff pitfalls of the old legacy-docs/ gate apply here.
        entry: >-
          docs_new/ was renamed to docs/. Move these changes under docs/ instead.
        language: fail
        files: ^docs_new/
      - id: check-chinese-characters
        name: check chinese characters in multimodal_gen
        entry: >-
          python3 -c 'import sys, re; p=re.compile(r"[\u4e00-\u9fff]"); ec=0; [ ([(print(f"{f}:{i+1}: {l.strip()}") or (ec:=1)) for i,l in enumerate(open(f, "r", encoding="utf-8", errors="ignore")) if p.search(l)]) for f in sys.argv[1:] ]; sys.exit(ec)'
        language: system
        files: ^python/sglang/multimodal_gen/.*
        exclude: ^(python/sglang/multimodal_gen/configs/sample|python/sglang/multimodal_gen/apps/ComfyUI_SGLDiffusion/workflows|python/sglang/multimodal_gen/runtime/pipelines_core/stages/model_specific_stages)(/|$)
        types_or: [python, markdown, json, text]
      - id: sort-ci-permissions
        name: sort CI_PERMISSIONS.json
        entry: python3 .github/update_ci_permission.py --sort-only
        language: system
        files: ^\.github/CI_PERMISSIONS\.json$
        pass_filenames: false
      - id: check-workflow-job-names
        name: check for duplicate workflow job names
        entry: python3 scripts/ci/check_workflow_job_names.py
        language: system
        files: ^\.github/workflows/.*\.yml$
        pass_filenames: false
      - id: check-registered-tests
        name: validate registered test CI registries
        entry: python3 scripts/ci/check_registered_tests.py
        language: system
        files: ^test/registered/.*\.py$
        exclude: ^test/registered/.*/utils\.py$
        pass_filenames: false
      - id: check-no-registered-tests-in-package
        name: reject CI-registered tests inside the sglang package
        entry: python3 scripts/ci/check_no_registered_tests_in_package.py
        language: system
        files: ^python/sglang/.*\.py$
        pass_filenames: false
      - id: rustfmt-sgl-model-gateway
        name: rustfmt sgl-model-gateway (nightly)
        entry: bash -c 'rustup component add --toolchain nightly rustfmt >/dev/null && cd sgl-model-gateway && cargo +nightly fmt -- --check'
        language: system
        files: ^sgl-model-gateway/.*\.rs$
        pass_filenames: false
      - id: rustfmt-sgl-router
        name: rustfmt experimental/sgl-router
        entry: bash -c 'cd experimental/sgl-router && cargo fmt -- --check'
        language: system
        files: ^experimental/sgl-router/.*\.rs$
        pass_filenames: false
      - id: clippy-rust-workspace
        name: clippy rust/ workspace (auto-fix)
        # Three steps: apply machine-applicable fixes, then fail on anything
        # left (combining --fix with -D warnings can abort the fix phase), then
        # cover sglang-mm's PyO3 bindings + rayon fan-out — both sit behind
        # non-default features, so `--workspace` alone never compiles them. protoc
        # is not required: sglang-grpc's build.rs falls back to a vendored binary.
        entry: bash -c 'cd rust && cargo clippy --workspace --fix --allow-dirty --allow-staged && cargo clippy --workspace -- -D warnings && cargo clippy -p sglang-mm --features python,parallel --lib -- -D warnings'
        language: system
        files: ^rust/.*\.rs$
        pass_filenames: false
      - id: rustfmt-rust-workspace
        name: rustfmt rust/ workspace
        entry: bash -c 'cd rust && cargo fmt'
        language: system
        files: ^rust/.*\.rs$
        pass_filenames: false
      - id: mint-broken-links
        name: check docs links (Mintlify; opt-in, requires `mint` on PATH)
        entry: bash -c 'cd docs && mint broken-links --check-anchors --check-redirects'
        language: system
        pass_filenames: false
        always_run: true
        stages: [manual]
  - repo: https://github.com/lycheeverse/lychee.git
    rev: lychee-v0.22.0
    hooks:
      - id: lychee
        name: check doc links (offline)
        args: ["--config", ".github/linters/lychee.toml"]
        stages: [manual]
        files: |
          (?x)^(
            README\.md
          )$