pyproject.toml

[project]
name = "python-backoff"
version = "2.4.0"
description = "Function decoration for backoff and retry"
authors = [{ name = "Bob Green", email = "rgreen@aquent.com" }]
maintainers = [{ name = "Edgar Ramírez-Mondragón", email = "edgarrm358@gmail.com" }]
requires-python = ">=3.9"
readme = "README.rst"
license = "MIT"
keywords = [
    "retry",
    "backoff",
    "decorators",
]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Developers",
    "Natural Language :: English",
    "Operating System :: OS Independent",
    "Programming Language :: Python",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Programming Language :: Python :: 3.15",
    "Topic :: Internet :: WWW/HTTP",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Utilities",
]

[project.urls]
Documentation = "https://python-backoff.github.io/backoff"
Repository = "https://github.com/python-backoff/backoff"

[dependency-groups]
dev = [
    { include-group = "docs" },
    { include-group = "lint" },
    { include-group = "test" },
    { include-group = "typing" },
]
docs = [
    "mkdocstrings[python]~=1.0.2",
    "zensical==0.0.53",
]
lint = [
    "ruff>=0.16.0",
]
test = [
    "coverage>=7.2.7",
    "dirty-equals>=0.11",
    "importlib-metadata>=8.5.0",
    "packaging>=25.0",
    "pytest>=7.1.2",
    "pytest-asyncio>=0.18.3",
    "requests>=2.26.0",
    "responses>=0.20.0",
    "tomli>=2.3.0",
]
typing = [
    { include-group = "test" },
    "mypy>=0.942",
    "pyrefly>=1.1.1",
    "ty>=0.0.59",
    "typing-extensions>=4.1; python_version < '3.10'"
]

[tool.hatch.build.targets.sdist]
include = ["backoff", "tests"]

[tool.hatch.build.targets.wheel]
include = ["backoff"]

[tool.tox]
requires = [ "tox>=4.53", "tox-uv" ]
env_list = [
  "format",
  { product = [
    { prefix = "3.", start = 9 },
  ] },
  "coverage",
  "lint",
  "typing",
  "docs",
]

[tool.tox.env_run_base]
description = "run unit tests on Python {py_dot_ver}"
dependency_groups = [ "test" ]
uv_python_preference = "managed"
commands = [
    [ "coverage", "run", "-m", "pytest", { replace = "posargs", default = [ "tests" ], extend = true } ],
]

[tool.tox.env.coverage]
description = "generate coverage report"
depends = ["3.*"]
dependency_groups = [ "test" ]
commands = [
  [ "coverage", "combine" ],
  [ "coverage", "report" ],
  [ "coverage", "xml" ],
]

[tool.tox.env.format]
description = "format code"
dependency_groups = [ "lint" ]
commands = [
    [ "ruff", "check", "--fix", { replace = "posargs", default = [ "backoff", "tests", "docs" ], extend = true } ],
    [ "ruff", "format", { replace = "posargs", default = [ "backoff", "tests", "docs" ], extend = true } ],
]

[tool.tox.env.lint]
description = "lint code"
dependency_groups = [ "lint" ]
labels = [ "check" ]
commands = [
    [
      "ruff",
      "check",
      { replace = "if", condition = "env.GITHUB_ACTIONS == 'true'", then = ["--output-format=github"], extend = true },
      { replace = "posargs", default = [ "backoff", "tests", "docs" ], extend = true },
    ],
    [
      "ruff",
      "format",
      "--check",
      { replace = "if", condition = "env.GITHUB_ACTIONS == 'true'", then = ["--output-format=github"], extend = true },
      { replace = "posargs", default = [ "backoff", "tests", "docs" ], extend = true },
    ],
]

[tool.tox.env.typing]
description = "run type checking"
dependency_groups = [ "typing" ]
labels = [ "check" ]
commands = [
  [
    "mypy",
    "--show-error-codes",
    { replace = "posargs", default = [
      "backoff",
      "tests",
    ], extend = true },
  ],
  [
    "ty",
    "check",
    { replace = "if", condition = "env.GITHUB_ACTIONS == 'true'", then = [ "--output-format=github" ], else = [], extend = true },
    { replace = "posargs", default = [
      "backoff",
      "tests",
    ], extend = true },
  ],
  [
    "pyrefly",
    "check",
    { replace = "if", condition = "env.GITHUB_ACTIONS == 'true'", then = [ "--output-format=github" ], else = [], extend = true },
    { replace = "posargs", default = [
      "backoff",
      "tests",
    ], extend = true },
  ],
]

[tool.tox.env.docs]
description = "build the documentation"
deps = [ "-r ./requirements/docs.requirements.txt" ]
commands = [
    [ "zensical", { replace = "posargs", default = [ "build", "--strict" ], extend = true } ],
]

[tool.pytest.ini_options]
filterwarnings = [
    "error",
]

[tool.coverage.paths]
package = [
  "backoff/",
  "*/site-packages/backoff/",
]

[tool.ruff]
line-length = 88
preview = true
required-version = ">=0.16.0"

[tool.ruff.format]
docstring-code-format = true
docstring-code-line-length = 20

[tool.ruff.lint]
extend-select = [
  "YTT",   # flake8-2020
  "ASYNC", # flake8-async
  "B",     # flake8-bugbear
  "C4",    # flake8-comprehensions
  "DTZ",   # flake8-datetimez
  "FA",    # flake8-future-annotations
  "ISC",   # flake8-implicit-str-concat
  "ICN",   # flake8-import-conventions
  "LOG",   # flake8-logging
  "G",     # flake8-logging-format
  "PIE",   # flake8-pie
  "T20",   # flake8-print
  "PT",    # flake8-pytest-style
  "RET",   # flake8-return
  "SIM",   # flake8-simplify
  "TC",    # flake8-type-checking
  "I",     # isort
  "PERF",  # Perflint
  "UP",    # pyupgrade
  "FURB",  # refurb
  "RUF",   # Ruff-specific rules
]
ignore = [
  # converting to a `yield from` expression is not safe because this library sends values via `send`
  # https://docs.astral.sh/ruff/rules/yield-in-for-loop/#fix-safety
  "yield-in-for-loop",
]

[tool.mypy]
check_untyped_defs = true
follow_untyped_imports = true
warn_unreachable = true
warn_unused_configs = true
warn_unused_ignores = true

[tool.ruff.lint.per-file-ignores]
"**/doccmd_*.py" = [
  "redefined-while-unused",
  "undefined-name",
  "print",
  "unused-async",
]
"tests/**.py" = [
  "assert",
  "unused-async",
]

[tool.coverage.report]
fail_under = 100
show_missing = true

[tool.coverage.run]
branch = true
parallel = true
relative_files = true
source = [
  "backoff",
]

[tool.pyrefly]
preset = "legacy"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"