carbon-lang/.pre-commit-config.yaml

# Part of the Carbon Language project, under the Apache License v2.0 with LLVM
# Exceptions. See /LICENSE for license information.
# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception

# Update versions with:
#   pre-commit autoupdate --freeze && pre-commit run -a
# See https://pre-commit.com for more information
# See https://pre-commit.com/hooks.html for more hooks

default_language_version:
  python: python3 # Defaults to python2, so override it.

repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: db7346d375eda68a0174f2c057dd97f2fbffe030 # frozen: v4.2.0
    hooks:
      - id: check-added-large-files
      - id: check-case-conflict
      - id: check-executables-have-shebangs
      - id: check-merge-conflict
      - id: check-symlinks
        exclude: ^bazel-(clang-toolchain|execroot)$
      - id: check-yaml
      - id: detect-private-key
      - id: end-of-file-fixer
        exclude: '^(.*/fuzzer_corpus/.*|.*\.svg)$'
      - id: mixed-line-ending
        args: ['--fix=lf']
        exclude: '^(.*/fuzzer_corpus/.*|.*\.svg)$'
      - id: trailing-whitespace
        exclude: '^(.*/fuzzer_corpus/.*|.*/testdata/.*\.golden|.*\.svg)$'
  - repo: https://github.com/google/pre-commit-tool-hooks
    rev: cb78d9293306d9f737c64d9702bbaa88e157caaa # frozen: v1.2.2
    hooks:
      - id: check-google-doc-style
      - id: markdown-toc
  - repo: local
    hooks:
      - id: fix-cc-deps
        name: Fix missing C++ deps
        entry: scripts/fix_cc_deps.py
        language: python
        files: ^.*/(BUILD|[^/]+\.(h|cpp))$
        pass_filenames: false

  # Formatters should be run late so that they can re-format any prior changes.
  - repo: https://github.com/psf/black
    rev: ae2c0758c9e61a385df9700dc9c231bf54887041 # frozen: 22.3.0
    hooks:
      - id: black
  - repo: https://github.com/pre-commit/mirrors-prettier
    rev: 5e374fda194d7f7ce9eebbd582b2a5594838c85b # frozen: v2.6.2
    hooks:
      - id: prettier
  - repo: local
    hooks:
      - id: buildifier
        name: Bazel buildifier
        entry: scripts/run_buildifier.py
        language: python
        files: |
          (?x)^(
            .*BUILD.*|
            .*WORKSPACE.*|
            .*\.bzl
          )$'
      - id: clang-format
        name: clang-format
        entry: clang-format
        types_or: [c++, proto]
        language: python
        args: ['-i']
        additional_dependencies: ['clang-format==13.0.1']
      - id: explorer-format-grammar
        name: Format the explorer grammar file
        entry: explorer/syntax/format_grammar.py
        language: python
        files: ^explorer/syntax/(lexer.lpp|parser.ypp)$
        pass_filenames: false
        additional_dependencies: ['clang-format==13.0.1']

  - repo: local
    hooks:
      - id: check-header-guards
        # This should run after clang-format, which may reformat a guard.
        name: Check header guards
        entry: scripts/check_header_guards.py
        language: python
        files: '^.*\.h$'
      - id: check-sha-filenames
        # This may rename files, so it's deliberately between formatters and
        # linters.
        name: Check fuzzer SHA filenames
        entry: scripts/check_sha_filenames.py
        language: python
        files: ^.*/fuzzer_corpus/.*$

  # Run linters last, as formatters and other checks may fix issues.
  - repo: local
    hooks:
      - id: forbid-llvm-googletest
        name: Checks for deps on LLVM's version of GoogleTest
        entry: scripts/forbid_llvm_googletest.py
        language: python
        files: ^.*/BUILD$
        pass_filenames: false
  - repo: https://github.com/PyCQA/flake8
    rev: cbeb4c9c4137cff1568659fcc48e8b85cddd0c8d # frozen: 4.0.1
    hooks:
      - id: flake8
  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: 'a04404bdf52c2cbc9c5bd705454b89bd83b84383' # frozen: v0.950
    hooks:
      - id: mypy
        # Use setup.cfg to match the command line.
        args:
          - --config-file=setup.cfg
        # This should match the requirements added in the WORKSPACE pip_install.
        additional_dependencies:
          - gql >= 2.0.0, < 3.0.0
          - PyGitHub
        # Exclusions are:
        # - p#### scripts because they're not tested or maintained.
        # - lit.cfg.py because it has multiple copies, breaking mypy.
        # - Unit tests because they sometimes violate typing, such as by
        #   assigning a mock to a function.
        exclude: |
          (?x)^(
              proposals/(?!scripts/).*|
              .*/lit\.cfg\.py|
              .*_test\.py
          )$
  - repo: https://github.com/codespell-project/codespell
    rev: 01da43d753cdff4ea7dff952b4f5317450af31e3 # frozen: v2.1.0
    hooks:
      - id: codespell
        args: ['-I', '.codespell_ignore', '--uri-ignore-words-list', '*']
        # Test data may contain intentional misspellings, as well as short,
        # meaningless identifiers that codespell incorrectly identifies as
        # typos but that we would want to detect in other contexts.
        exclude: |
          (?x)^(
              .*/testdata/.*|
              .*/fuzzer_corpus/.*
          )$
  - repo: https://github.com/google/pre-commit-tool-hooks
    rev: cb78d9293306d9f737c64d9702bbaa88e157caaa # frozen: v1.2.2
    hooks:
      - id: check-copyright
        args:
          - --copyright
          - |+
            Part of the Carbon Language project, under the Apache License v2.0 with LLVM
            Exceptions. See /LICENSE for license information.
            SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
          - --custom_format
          - '\.(carbon|proto|ypp)$'
          - ''
          - '// '
          - ''
          - --custom_format
          - '\.(l|lpp|y)$'
          - '/*'
          - ''
          - '*/'
        exclude: |
          (?x)^(
              .bazelversion|
              compile_flags.txt|
              third_party/.*|
              bazel/llvm-patches/.*\.patch|
              .*\.def|
              .*\.svg|
              .*/fuzzer_corpus/.*|
              .*/testdata/.*\.golden
          )$
      - id: check-links

# Most third-party code is in submodules; local commits are excluded here.
# We fully exclude fuzzer corpus directories as they are generated binary data.
exclude: |
  (?x)^(
      third_party/examples/.*/carbon/.*|
      third_party/llvm-project/.*|
  )$