pyproject.toml

[project]
name = "m4-2-sql-to-arc"
dynamic = ["version"]
description = "The FAIRagro SQL-to-ARC client"
readme = "README.md"
requires-python = ">=3.12"
dependencies = [
  "sql_to_arc",
]

[dependency-groups]
dev = [
  "httpx>=0.28.1",
  "pylint>=4.0.4",
  "pytest>=9.0.2",
  "pytest-asyncio>=1.1.0",
  "pytest-cov>=7.0.0",
  "pytest-env>=1.2.0",
  "pytest-mock>=3.10.0",
  "mypy>=1.19.0",
  "bandit>=1.7.0",
  "ruff>=0.15.10",
  "pre-commit>=4.0.0",
  "respx>=0.20.0",
  "fastapi>=0.135.3",
  "uvicorn>=0.42.0",
]

[tool.uv.sources]
sql_to_arc = { workspace = true }
api_client = { git = "https://github.com/fairagro/m4.2_advanced_middleware_api.git", branch = "main", subdirectory = "middleware/api_client" }
shared = { git = "https://github.com/fairagro/m4.2_advanced_middleware_api.git", branch = "main", subdirectory = "middleware/shared" }

[tool.uv.workspace]
members = [
    "middleware/sql_to_arc",
]

[tool.ruff]
# Exclude directories from linting and formatting
exclude = [
  ".venv",
  "venv",
  ".git",
  "__pycache__",
  "*.egg-info",
  ".pytest_cache",
  ".mypy_cache",
  ".ruff_cache",
  "build",
  "dist",
]

# Welche Regel-Sets aktiviert sind:
lint.select = [
  "E",   # pycodestyle errors
  "W",   # pycodestyle warnings
  "F",   # pyflakes
  "I",   # isort (import sorting)
  "C90", # mccabe (Komplexität)
  "N",   # pep8-naming
  "D",   # pydocstyle (Docstrings)
  "UP",  # pyupgrade
  "B",   # bugbear
  "SIM", # flake8-simplify
  "A",   # flake8-builtins
  "ARG", # flake8-unused-arguments
  "BLE", # flake8-blind-except (fängt zu generische Exceptions ab)
  "PLR", # Pylint Refactor (inkl. complexity rules wie too-many-return-statements)
  "SLF", # flake8-self (Private member access)
]

# Muss für PLR0917 aktiviert sein
preview = true

# Maximale Zeilenlänge wie in pylint (Standard: 100)
line-length = 120

# Formatierungs-Einstellungen (konsistent mit Black)
[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "lf"

# Für cyclomatic complexity, entspricht pylint's R1260 etc.
[tool.ruff.lint.mccabe]
max-complexity = 10

# Import sorting (replaces isort)
[tool.ruff.lint.isort]
known-first-party = ["middleware"]
force-single-line = false
combine-as-imports = true

[tool.ruff.lint.per-file-ignores]
"middleware/*/tests/**/*.py" = ["SLF001"]

# Black and isort replaced by ruff format - configurations removed to avoid conflicts

[tool.mypy]
python_version = "3.12"
mypy_path = "middleware/sql_to_arc/src"
namespace_packages = true
explicit_package_bases = true
strict = true
plugins = ["pydantic.mypy"]

[tool.pydantic-mypy]
init_forbid_extra = true
init_typed = true
warn_required_dynamic_aliases = true

warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
disallow_incomplete_defs = true
explicit_package_bases = true
namespace_packages = true

# Exclude directories from type checking
exclude = [
  ".venv",
  "venv",
  ".git",
  "__pycache__",
  "build",
  "dist",
  ".pytest_cache",
  ".mypy_cache",
  ".ruff_cache",
]

# arctrl has no type stubs and no py.typed marker — suppress the resulting noise.
# The Fable-transpiled internals live under arctrl.py.* so both patterns are needed.
[[tool.mypy.overrides]]
module = ["arctrl", "arctrl.*"]
ignore_missing_imports = true

# Docstring-Regeln aktivieren, damit es wie pylint C0114/15/16 meckert
[tool.ruff.lint.pydocstyle]
convention = "pep257" # oder "numpy", oder "google"

[tool.pytest.ini_options]
# Test discovery
testpaths = ["middleware/*/tests"]
python_files = ["test_*.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]

# Output and behavior
addopts = [
    "-v",                        # Verbose output
    "--strict-markers",          # Treat unregistered markers as errors
    "--tb=short",                # Shorter traceback format
    "--cov=middleware",          # Enable coverage for middleware packages
    "--cov-report=term-missing", # Show missing lines in terminal
    "--cov-report=html",         # Generate HTML coverage report
    "--cov-report=xml",          # Generate XML coverage report (for CI)
    "--cov-fail-under=80",       # Fail if coverage is below 80%
]

# Asyncio mode
asyncio_mode = "auto"

# Custom markers
markers = [
    "asyncio: marks tests as async",
    "unit: marks tests as unit tests",
    "integration: marks tests as integration tests",
    "system: marks tests as system tests",
]

[tool.coverage.run]
# Coverage measurement settings
source = ["middleware"]
omit = [
    "*/tests/*",
    "*/__pycache__/*",
    "*/.venv/*",
    "*/venv/*",
    "*/.pytest_cache/*",
    "*/build/*",
    "*/dist/*",
    "*/*.egg-info/*",
]
branch = true  # Measure branch coverage

[tool.coverage.report]
# Coverage reporting settings
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",
    "@abc.abstractmethod",
]

[tool.coverage.html]
directory = "htmlcov"

[tool.pylint.format]
max-line-length = 120

[tool.pylint.master]
# Ignore directories
ignore = [".venv", "venv", ".git", "__pycache__", "build", "dist"]
ignore-patterns = ["^\\..*", ".*\\.egg-info"]
# Fail if the score is below 8.0
fail-under = 8.0

[tool.pylint.messages_control]
# Disable checks that are already covered by ruff
disable = [
    # Docstring checks (covered by ruff pydocstyle D-series)
    "C0114",  # missing-module-docstring -> ruff D100
    "C0115",  # missing-class-docstring -> ruff D101
    "C0116",  # missing-function-docstring -> ruff D103

    # Import checks (covered by ruff pyflakes F, isort I)
    "C0411",  # wrong-import-order -> ruff I001
    "C0412",  # ungrouped-imports -> ruff I001
    "C0413",  # wrong-import-position -> ruff E402
    "W0611",  # unused-import -> ruff F401
    "W0614",  # unused-wildcard-import -> ruff F403, F405

    # Code style checks (covered by ruff pycodestyle E/W)
    "C0303",  # trailing-whitespace -> ruff W291
    "C0304",  # missing-final-newline -> ruff W292
    "C0305",  # trailing-newlines -> ruff W391
    "C0321",  # multiple-statements -> ruff E701, E702
    "C0325",  # superfluous-parens -> ruff UP034
    "W0311",  # bad-indentation -> ruff E111, E117
    "W0301",  # unnecessary-semicolon -> ruff E703

    # Naming checks (covered by ruff pep8-naming N-series)
    "C0103",  # invalid-name -> ruff N801-N807

    # Complexity checks (covered by ruff mccabe C90)
    "R0912",  # too-many-branches -> ruff C901
    "R0915",  # too-many-statements -> ruff C901

    # Bugbear/pyflakes checks (covered by ruff bugbear B, pyflakes F)
    "W0101",  # unreachable -> ruff F401
    "W0102",  # dangerous-default-value -> ruff B006
    "W0107",  # unnecessary-pass -> ruff PIE790
    "W0125",  # using-constant-test -> ruff B015
    "W0511",  # TODO comment found
    "W0612",  # unused-variable -> ruff F841
    "W0613",  # unused-argument -> ruff ARG001-005
    "W0621",  # redefined-outer-name -> ruff F811
    "W0622",  # redefined-builtin -> ruff A001-A003

    # Simplification checks (covered by ruff flake8-simplify SIM)
    "R1705",  # no-else-return -> ruff SIM103
    "R1714",  # consider-using-in -> ruff SIM118
    "R1715",  # consider-using-get -> ruff SIM401
    "R1720",  # no-else-raise -> ruff SIM102
    "R1724",  # no-else-continue -> ruff SIM114
    "R1728",  # consider-using-generator -> ruff C417

    # Pyupgrade checks (covered by ruff pyupgrade UP)
    "R1711",  # useless-return -> ruff UP034
    "C0206",  # consider-using-dict-items -> ruff UP015

    # Additional opinionated/style checks often handled by formatters
    "R0903",  # too-few-public-methods (opinionated, often not relevant)
    "R0913",  # too-many-arguments (opinionated, case-by-case basis)
    "R0917",  # too-many-positional-arguments (handled by ruff PLR0917)
    "C0301",  # line-too-long (handled by ruff formatter)
    "R0801",  # duplicate-code (can be noisy in tests)
    "R0914",  # too-many-locals (handled by ruff PLR0914)

    # Exception checks (covered by ruff BLE001)
    "W0718",  # broad-exception-caught
    "W0703",  # broad-except

    # Private member access
    "W0212",  # protected-access
]

[tool.hatch.version]
source = "vcs"

[tool.hatch.build.targets.wheel]
include = ["README.md"]

[build-system]
requires = ["hatchling", "hatch-vcs"]
build-backend = "hatchling.build"