id = "pycodestyle"
name = "pycodestyle"
homepage = "https://pycodestyle.pycqa.org/"
description = "A tool to check your Python code against some of the style conventions in PEP 8."
executables = ["pycodestyle"]

[dotfiles]

# https://pycodestyle.pycqa.org/en/stable/intro.html documents ~/.pycodestyle
# on Windows and XDG_CONFIG_HOME/pycodestyle otherwise. [configHome] is the
# catalog's XDG_CONFIG_HOME spelling and follows a moved XDG directory.
paths = ["~/.pycodestyle", "[configHome]/pycodestyle"]
exclude = []
secret = []

[commands]
format = 1
label = "Check Python style"
description = "Check Python files or directories against PEP 8. Config-file options and testing options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://raw.githubusercontent.com/PyCQA/pycodestyle/main/docs/intro.rst"
revision = "2026-10-27"
evidence = """
Usage: pycodestyle [options] input ...
  -v, --verbose        print status messages, or debug with -vv
  -q, --quiet          report only file names, or nothing with -qq
  --first              show first occurrence of each error
  --exclude=patterns   exclude files or directories which match these comma
                       separated patterns (default: .svn,CVS,.bzr,.hg,.git)
  --select=errors      select errors and warnings (e.g. E,W6)
  --ignore=errors      skip errors and warnings (e.g. E4,W)
  --show-source        show source code for each error
  --statistics         count errors and warnings
  --count              print total number of errors and warnings to standard
                       error and set exit code to 1 if total is not null
  --max-line-length=n  set maximum allowed line length (default: 79)
  --diff               report only lines changed according to the unified diff
                       received on STDIN
"""

[[commands.field]]
id = "inputs"
label = "Files or directories"
type = "path"
position = 0
multiple = true
path = { kind = "any", role = "input", must_exist = true }
sources = ["help"]

[[commands.field]]
id = "max_line_length"
label = "Max line length"
type = "integer"
option = ["--max-line-length"]
sources = ["help"]

[[commands.field]]
id = "select"
label = "Select errors"
description = "Comma-separated codes, e.g. E,W6."
type = "string"
option = ["--select"]
sources = ["help"]

[[commands.field]]
id = "ignore"
label = "Ignore errors"
description = "Comma-separated codes, e.g. E4,W."
type = "string"
option = ["--ignore"]
sources = ["help"]

[[commands.field]]
id = "exclude"
label = "Exclude patterns"
description = "Comma-separated patterns."
type = "string"
option = ["--exclude"]
sources = ["help"]

[[commands.field]]
id = "show_source"
label = "Show source"
type = "boolean"
option = ["--show-source"]
sources = ["help"]

[[commands.field]]
id = "statistics"
label = "Statistics"
type = "boolean"
option = ["--statistics"]
sources = ["help"]

[[commands.field]]
id = "count"
label = "Print total count"
type = "boolean"
option = ["--count"]
sources = ["help"]

[[commands.field]]
id = "first"
label = "First occurrence only"
type = "boolean"
option = ["--first"]
sources = ["help"]

[[commands.field]]
id = "verbose"
label = "Verbose"
type = "count"
option = ["-v", "--verbose"]
sources = ["help"]

[[commands.task]]
id = "check"
label = "Check files"
fields = ["inputs", "max_line_length", "show_source", "statistics"]
required = ["inputs"]

[[commands.task]]
id = "summary"
label = "Summarize errors"
set = { statistics = [true], count = [true] }
fields = ["inputs", "statistics", "count", "select", "ignore"]
required = ["inputs"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["inputs", "max_line_length", "show_source", "statistics", "count"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["select", "ignore", "exclude", "first", "verbose"]