# We keep the ruff configuration separate so it can easily be shared across
# all projects

target-version = 'py310'

#src = ['progressbar']
exclude = [
    '.venv',
    '.tox',
    # Ignore local test files/directories/old-stuff
    'test.py',
    '*_old.py',
    # Benchmark/tooling scripts are not held to the package lint standard
    'benchmarks',
]

line-length = 79

[lint]
ignore = [
    'A001', # Variable {name} is shadowing a Python builtin
    'A002', # Argument {name} is shadowing a Python builtin
    'A003', # Class attribute {name} is shadowing a Python builtin
    'B023', # function-uses-loop-variable
    'B024', # `FormatWidgetMixin` is an abstract base class, but it has no abstract methods
    'D205', # blank-line-after-summary
    'D212', # multi-line-summary-first-line
    'RET505', # Unnecessary `else` after `return` statement
    'TRY003', # Avoid specifying long messages outside the exception class
    'RET507', # Unnecessary `elif` after `continue` statement
    'C405', # Unnecessary {obj_type} literal (rewrite as a set literal)
    'C406', # Unnecessary {obj_type} literal (rewrite as a dict literal)
    'C408', # Unnecessary {obj_type} call (rewrite as a literal)
    'SIM114', # Combine `if` branches using logical `or` operator
    'RET506', # Unnecessary `else` after `raise` statement
    'Q001', # Remove bad quotes
    'Q002', # Remove bad quotes
    'COM812', # Missing trailing comma in a list
    'ISC001', # String concatenation with implicit str conversion
    'SIM108', # Ternary operators are not always more readable
    'RUF100', # Unused noqa directives. Due to multiple Python versions, we need to keep them
]

select = [
    'A', # flake8-builtins
    'ASYNC', # flake8 async checker
    'B', # flake8-bugbear
    'C4', # flake8-comprehensions
    'C90', # mccabe
    'COM', # flake8-commas

    # Docstrings are required throughout `progressbar/`, which is fully
    # documented. Everything else is exempted below: test names are
    # already the documentation, and docs/scripts/tools are not the
    # published API.
    'D', # pydocstyle

    'E', # pycodestyle error ('W' for warning)
    'F', # pyflakes
    'I', # isort
    'ICN', # flake8-import-conventions
    'INP', # flake8-no-pep420
    'ISC', # flake8-implicit-str-concat
    'N', # pep8-naming
    'NPY', # NumPy-specific rules
    'PERF', # perflint,
    'PIE', # flake8-pie
    'Q', # flake8-quotes

    'RET', # flake8-return
    'RUF', # Ruff-specific rules
    'SIM', # flake8-simplify
    'T20', # flake8-print
    'TD', # flake8-todos
    'TRY', # tryceratops
    'UP', # pyupgrade
]

[lint.per-file-ignores]
'tests/*' = ['D', 'INP001', 'T201', 'T203']
'tests/**' = ['D']
'examples.py' = ['D', 'T201', 'N806']
'docs/examples/**' = ['D', 'T201']
'docs/**' = ['D']
'scripts/*' = ['D', 'T201']
'tools/**' = ['D']
'docs/conf.py' = ['D', 'E501', 'INP001']
'docs/_theme/flask_theme_support.py' = ['RUF012', 'INP001']

[lint.pydocstyle]
convention = 'google'
ignore-decorators = [
    'typing.overload',
    'typing.override',
]

[lint.isort]
case-sensitive = true
combine-as-imports = true
force-wrap-aliases = true

[lint.flake8-quotes]
# No `docstring-quotes` setting: it used to ask for `'''`, which
# contradicts pydocstyle's D300 and was contradicted by the code itself:
# every one of the 666 docstring markers in `progressbar/` is `"""`.
inline-quotes = 'single'
multiline-quotes = 'single'

[format]
line-ending = 'lf'
indent-style = 'space'
quote-style = 'single'
docstring-code-format = true
skip-magic-trailing-comma = false
exclude = [
    '__init__.py',
]

[lint.pycodestyle]
max-line-length = 79

[lint.flake8-pytest-style]
mark-parentheses = true