Table of contents

• Configuration translation

• pipx usage

• pre-commit usage

Configuration translation

Below is an example of a flake8 configuration as it would appear in a .flake8 file:

[flake8]
max-line-length = 80
extend-select = B950
extend-ignore = E203,E501,E701

[flake8:local-plugins]
paths = ./assets/flake8
extension =
    CL1 = custom_repo_linter:Plugin1
    CL2 = custom_repo_linter:Plugin2
reporter =
    CR = custom_repo_reporter:Plugin

Below is the equivalent configuration, suitable for use in a pyproject.toml file. Note that the flake8:local-plugins section requires quotes in the TOML format:

[tool.flake8]
max-line-length = 80
extend-select = ["B950"]
extend-ignore = ["E203", "E501", "E701"]

[tool."flake8:local-plugins"]
paths = ["./assets/flake8"]
extension.CL1 = "custom_repo_linter:Plugin1"
extension.CL2 = "custom_repo_linter:Plugin2"
reporter.CR = "custom_repo_reporter:Plugin"

Alternatively, multi-line TOML strings can be used for clearer config parity:

# ...
[tool."flake8:local-plugins"]
paths = ["./assets/flake8"]
extension = """
    CL1 = custom_repo_linter:Plugin1
    CL2 = custom_repo_linter:Plugin2
"""
reporter = """
    CR = custom_repo_reporter:Plugin
"""

pipx usage

If flake8 is installed using pipx, you can inject this plugin:

pipx inject flake8 flake8-toml-config

pre-commit usage

Add this plugin as an additional dependency:

- repo: "https://github.com/pycqa/flake8"
  rev: "c48217e1fc006c2dddd14df54e83b67da15de5cd"  # frozen: 7.3.0
  hooks:
    - id: "flake8"
      additional_dependencies:
        - "flake8-toml-config==1.1.0"

Note that the pre-commit autoupdate command, and pre-commit.ci, do not update additional dependencies. Consider using upadup to auto-update additional dependencies as needed.