pydantic--pydantic-ai/.pre-commit-config.yaml

repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.3.0
    hooks:
      - id: no-commit-to-branch # prevent direct commits to the `main` branch
      - id: check-yaml
        args: ["--unsafe"]
      - id: check-toml
      # gh-aw compiles *.md agentic workflows into *.lock.yml, and also
      # auto-generates `.github/workflows/agentics-maintenance.yml` as a
      # standalone maintenance workflow. Both are generated artifacts (like
      # uv.lock) and must stay byte-identical to `gh aw compile` output, so
      # the whitespace/text hooks skip them.
      - id: end-of-file-fixer
        exclude: ^\.github/workflows/(agentics-maintenance\.yml|[^/]*\.lock\.yml)$
      - id: trailing-whitespace
        exclude: ^\.github/workflows/(agentics-maintenance\.yml|[^/]*\.lock\.yml)$
      - id: check-added-large-files
        args:
          - --maxkb=1024 # 1MB
          - --enforce-all # Allow to run in the whole source code, instead of only the changed files.
        exclude: |
          (?x)^(
              tests/models/cassettes/.*|
              tests/cassettes/.*|
              uv.lock
          )$

  - repo: https://github.com/sirosen/texthooks
    rev: 0.6.8
    hooks:
      - id: fix-smartquotes
        exclude: (?x)(cassettes/|^\.github/workflows/(agentics-maintenance\.yml|[^/]*\.lock\.yml)$)
      - id: fix-spaces
        exclude: (?x)(cassettes/|^\.github/workflows/(agentics-maintenance\.yml|[^/]*\.lock\.yml)$)
      - id: fix-ligatures
        exclude: (?x)(cassettes/|^\.github/workflows/(agentics-maintenance\.yml|[^/]*\.lock\.yml)$)

  - repo: https://github.com/codespell-project/codespell
    # Configuration for codespell is in pyproject.toml
    rev: v2.3.0
    hooks:
      - id: codespell
        args: ["--skip", "tests/models/cassettes/*"]
        additional_dependencies:
          - tomli
  - repo: https://github.com/zizmorcore/zizmor-pre-commit
    rev: v1.23.1
    hooks:
      - id: zizmor

  - repo: local
    hooks:
      - id: no-rst-syntax
        name: No RST syntax (use Markdown in docstrings and docs)
        description: |
          Bans RST-only constructs that mkdocstrings/Markdown won't render:
          `` ``foo`` `` (use single backticks), trailing `::` (use ```` ```python ```` fences),
          and Sphinx roles like `:mod:`foo`` / `:class:`Bar`` (use `[Bar][pkg.mod.Bar]` reference links).
        language: pygrep
        entry: '(?<!`)``(?!`)|::\s*$|:[a-z][a-z_:]*:`'
        types_or: [python, markdown]
      - id: clai-help
        name: clai help output
        entry: uv
        args: [run, pytest, "clai/update_readme.py"]
        language: system
        types_or: [python, markdown]
        pass_filenames: false
      - id: format
        name: Format
        entry: make
        args: [format]
        language: system
        types: [python]
        pass_filenames: false
      - id: lint
        name: Lint
        entry: make
        args: [lint]
        types: [python]
        language: system
        pass_filenames: false
      - id: typecheck
        name: Typecheck
        entry: make
        args: [typecheck]
        language: system
        types: [python]
        pass_filenames: false
      - id: check-cassettes
        name: Check cassettes
        entry: uv
        args: [run, python, scripts/check_cassettes.py]
        language: system
        files: ^tests/
        pass_filenames: false