pyproject.toml

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "scrython"
version = "2.1.0"
description = "A wrapper for using the Scryfall API."
readme = "README.md"
requires-python = ">=3.10"
dependencies = [
    # NotRequired needs the backport before 3.11; TypeVar(default=...) (PEP 696,
    # used by ScrythonRequestHandler) needs it before 3.13.
    "typing-extensions>=4.6.0; python_version<'3.13'",
]
license = "MIT"
authors = [
    {name = "Nanda Scott", email = "nanda1123@gmail.com"}
]
keywords = ["Scryfall", "magic", "the gathering", "scrython", "wrapper"]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Typing :: Typed",
]

[project.urls]
Homepage = "https://github.com/NandaScott/Scrython"
Repository = "https://github.com/NandaScott/Scrython"

[tool.setuptools.packages.find]
include = ["scrython*"]

[tool.setuptools.package-data]
scrython = ["py.typed"]

[project.optional-dependencies]
dev = [
    "black>=24.0.0",
    "ruff>=0.1.0",
    "mypy>=1.8.0",
    "pytest>=8.0.0",
    "pytest-cov>=4.1.0",
    "pre-commit>=3.6.0",
    "build>=1.0.0",
]
progress = [
    "tqdm>=4.65.0",
]

# Black configuration
[tool.black]
line-length = 100
target-version = ["py310", "py311", "py312"]
include = '\.pyi?$'
extend-exclude = '''
/(
  # directories
  \.eggs
  | \.git
  | \.hg
  | \.mypy_cache
  | \.tox
  | \.venv
  | build
  | dist
)/
'''

# Ruff configuration
[tool.ruff]
line-length = 100
target-version = "py310"

[tool.ruff.lint]
select = [
    "E",      # pycodestyle errors
    "W",      # pycodestyle warnings
    "F",      # pyflakes
    "I",      # isort
    "B",      # flake8-bugbear
    "C4",     # flake8-comprehensions
    "UP",     # pyupgrade
    "ARG",    # flake8-unused-arguments
    "SIM",    # flake8-simplify
]
ignore = [
    "E501",   # line too long (handled by black)
    "B008",   # do not perform function calls in argument defaults
    "B905",   # zip() without explicit strict parameter
    "B019",   # Use of functools.cache on methods (will address in future phase)
    "C417",   # Unnecessary map usage (will address in future phase)
]

[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401"]  # Allow unused imports in __init__ files
# Usage tests inject a payload fixture purely to arm the stub seam; the
# fixture parameter is intentionally unreferenced in the test body.
"tests/usage/test_*.py" = ["ARG001"]

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

# Mypy configuration
[tool.mypy]
python_version = "3.10"
warn_unused_configs = true
disallow_untyped_defs = true
disallow_any_generics = true
disallow_subclassing_any = true
disallow_untyped_calls = true
disallow_incomplete_defs = true
check_untyped_defs = true
disallow_untyped_decorators = true
no_implicit_optional = true
warn_redundant_casts = true
warn_unused_ignores = true
warn_return_any = true
warn_no_return = true
strict_equality = true
no_implicit_reexport = true
ignore_missing_imports = true
show_error_codes = true
extra_checks = true

# Pytest configuration
[tool.pytest.ini_options]
minversion = "8.0"
testpaths = ["tests"]
python_files = ["test_*.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
addopts = [
    "-v",
    "--strict-markers",
    "--strict-config",
]
markers = [
    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
    "integration: marks tests that require network access",
]

# Coverage configuration
[tool.coverage.run]
source = ["scrython"]
omit = [
    "*/tests/*",
    "*/test_*.py",
]

[tool.coverage.report]
precision = 2
show_missing = true
skip_covered = false
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "raise AssertionError",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
    "if TYPE_CHECKING:",
    "@abstractmethod",
]