pyproject.toml

[build-system]
# AVOID CHANGING REQUIRES: IT WILL BE UPDATED BY PYSCAFFOLD!
requires = ["setuptools>=46.1.0", "setuptools_scm[toml]>=5"]
build-backend = "setuptools.build_meta"

[tool.setuptools_scm]
# For smarter version schemes and other configuration options,
# check out https://github.com/pypa/setuptools_scm
version_scheme = "no-guess-dev"

[tool.ruff]
# Ruff configuration for code formatting and linting
line-length = 80
target-version = "py313"

# Exclude directories
exclude = [
    ".bzr",
    ".direnv",
    ".eggs",
    ".git",
    ".git-rewrite",
    ".hg",
    ".mypy_cache",
    ".nox",
    ".pants.d",
    ".pytype",
    ".ruff_cache",
    ".svn",
    ".tox",
    ".venv",
    "__pypackages__",
    "_build",
    "buck-out",
    "build",
    "dist",
    "node_modules",
    "venv",
    "docs/conf.py",
]

[tool.ruff.lint]
# Enable pycodestyle (`E`) and Pyflakes (`F`) codes by default.
# Add other rules as needed:
# - isort (I) for import sorting
# - pyupgrade (UP) for Python version upgrade suggestions
# - flake8-bugbear (B) for common bugs
# - flake8-comprehensions (C4) for comprehension improvements
# - flake8-simplify (SIM) for simplification suggestions
select = [
    "E",     # pycodestyle errors
    "F",     # Pyflakes
    "W",     # pycodestyle warnings
    "I",     # isort
    "UP",    # pyupgrade
    "B",     # flake8-bugbear
    "C4",    # flake8-comprehensions
    "SIM",   # flake8-simplify
    "S",     # flake8-bandit (security)
]

ignore = [
    "E203",  # whitespace before ':' (conflicts with black/ruff format)
    "B904",  # raise from - will be addressed in a future update
]

# Allow autofix for all enabled rules (when `--fix` is provided)
fixable = ["ALL"]
unfixable = []

# Allow unused variables when underscore-prefixed
dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"

[tool.ruff.lint.per-file-ignores]
# Ignore import rules in __init__.py files
"__init__.py" = ["F401", "F403"]
# Ignore rules in test files
"tests/**/*.py" = ["B", "SIM", "S101", "S105", "S106", "S110"]  # S101: assert; S105/S106: credentials; S110: bare except
# Ignore import order in examples (they need to modify sys.path first)
"examples/**/*.py" = ["E402", "S105", "S106"]  # S105/S106: example mock credentials
# Ignore assert_used in CLI rich output (acceptable for non-library code)
"src/nwp500/cli/rich_output.py" = ["S101"]

[tool.ruff.lint.isort]
known-first-party = ["nwp500"]

[tool.ruff.format]
# Use double quotes for strings
quote-style = "double"

# Indent with spaces
indent-style = "space"

# Like Black, respect magic trailing commas
skip-magic-trailing-comma = false

# Like Black, automatically detect the appropriate line ending
line-ending = "auto"

[tool.mypy]
# Enable strict mode for comprehensive type checking
strict = true

# Python version target
python_version = "3.13"

# Module discovery
files = ["src/nwp500", "tests"]
mypy_path = "src"
namespace_packages = true
explicit_package_bases = true

# Import discovery
follow_imports = "normal"
ignore_missing_imports = false

# Platform configuration
platform = "linux"

# Warnings
warn_redundant_casts = true
warn_unused_ignores = true
warn_return_any = true
warn_unreachable = true

# Error reporting
show_error_context = true
show_column_numbers = true
show_error_codes = true
pretty = true

# Incremental mode
incremental = true
cache_dir = ".mypy_cache"

# Per-module overrides
[[tool.mypy.overrides]]
module = "awscrt.*"
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = "awsiot.*"
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = "aiohttp.*"
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = "click.*"
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = "nwp500.cli.*"
ignore_errors = true

[[tool.mypy.overrides]]
module = "pydantic.*"
ignore_missing_imports = true

[tool.pyright]
# Pyright configuration for strict type checking
pythonVersion = "3.13"
typeCheckingMode = "strict"
include = ["src/nwp500", "tests"]
exclude = [".venv", "build", "dist", ".tox"]

# Strict error reporting
reportGeneralTypeIssues = "error"
reportUnboundVariable = "error"
reportUnusedImport = "error"
reportUnsupportedDunderAll = "error"
reportPrivateUsage = "error"
reportConstantRedefinition = "error"
reportOptionalCall = "error"
reportUnnecessaryComparison = "error"
reportPossiblyUnboundVariable = "error"
reportUnnecessaryIsInstance = "error"
reportUnusedVariable = "error"
reportIncompatibleMethodOverride = "error"
reportIncompatibleVariableOverride = "error"

# Type stub warnings
reportMissingTypeStubs = "warning"
reportUnknownParameterType = "warning"
reportUnknownMemberType = "warning"
reportUnknownVariableType = "warning"
reportUnknownArgumentType = "warning"
reportMissingParameterType = "warning"
reportPrivateImportUsage = "warning"

# Untyped decorators and base classes from third-party libraries (Click, Pydantic)
# These libraries don't have complete type stubs, so we report these as warnings
reportUntypedFunctionDecorator = "warning"
reportUntypedBaseClass = "warning"

# Ignore missing imports for external libraries without stubs
reportMissingImports = false