repos:
  # Ruff mne
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.11.5
    hooks:
      - id: ruff
        name: ruff lint mne
        args: ["--fix"]
        files: ^mne/|^tools/
        exclude: vulture_allowlist.py
      - id: ruff
        name: ruff lint mne preview
        args: ["--fix", "--preview", "--select=NPY201"]
        files: ^mne/|^tools/
      - id: ruff
        name: ruff lint doc, tutorials, and examples
        # D103: missing docstring in public function
        # D400: docstring first line must end with period
        args: ["--ignore=D103,D400", "--fix"]
        files: ^doc/|^tutorials/|^examples/
      - id: ruff-format
        files: ^mne/|^doc/|^tutorials/|^examples/|^tools/

  # Codespell
  - repo: https://github.com/codespell-project/codespell
    rev: v2.4.1
    hooks:
      - id: codespell
        additional_dependencies:
          - tomli
        files: ^mne/|^doc/|^examples/|^tutorials/|^tools/
        types_or: [python, bib, rst, inc]

  # yamllint
  - repo: https://github.com/adrienverge/yamllint.git
    rev: v1.37.0
    hooks:
      - id: yamllint
        args: [--strict, -c, .yamllint.yml]

  # rstcheck
  - repo: https://github.com/rstcheck/rstcheck.git
    rev: v6.2.4
    hooks:
      - id: rstcheck
        additional_dependencies:
          - tomli
        files: ^doc/.*\.(rst|inc)$
        # Credit is problematic because we generate an include on the fly
        exclude: ^doc/credit.rst$

  # sorting
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v5.0.0
    hooks:
      - id: file-contents-sorter
        files: ^doc/changes/names.inc|^.mailmap
        args: ["--ignore-case"]

  - repo: https://github.com/pappasam/toml-sort
    rev: v0.24.2
    hooks:
      - id: toml-sort-fix
        files: pyproject.toml

  # dependencies
  - repo: local
    hooks:
      - id: update-env-file
        name: Copy dependency changes from pyproject.toml to environment.yml
        language: python
        entry: ./tools/hooks/update_environment_file.py
        files: '^(pyproject.toml|tools/hooks/update_environment_file.py)$'
  - repo: local
    hooks:
      - id: dependency-sync
        name: Copy core dependencies from pyproject.toml to README.rst
        language: python
        entry: ./tools/hooks/sync_dependencies.py
        files: '^(pyproject.toml|tools/hooks/sync_dependencies.py)$'
        additional_dependencies: ["mne==1.9.0"]

  # zizmor
  - repo: https://github.com/woodruffw/zizmor-pre-commit
    rev: v1.5.2
    hooks:
      - id: zizmor

# these should *not* be run on CIs:
ci:
  skip: [dependency-sync]  # needs MNE to work, which exceeds the free tier space alloc.

# The following are too slow to run on local commits, so let's only run on CIs:
#
#   - repo: https://github.com/pre-commit/mirrors-mypy
#     rev: v1.9.0
#     hooks:
#       - id: mypy
#
#   - repo: https://github.com/jendrikseipp/vulture
#     rev: 'v2.11'  # or any later Vulture version
#     hooks:
#       - id: vulture
