pyproject.toml

[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

[project]
urls = { homepage = "https://douglasrizzo.com.br/catsim" }
authors = [
    { name = "Douglas De Rizzo Meneghetti", email = "douglasrizzo@gmail.com" },
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Education",
    "Intended Audience :: Science/Research",
    "Natural Language :: English",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Topic :: Education :: Testing",
]
name = "catsim"
version = "0.21.0"
description = "Computerized Adaptive Testing Simulator"
dependencies = [
    "scipy",
    "numexpr",
    "matplotlib",
    "tqdm",
    "numpy",
]
requires-python = ">=3.11"
readme = "README.md"
license = "BSD-3-Clause"

[tool.setuptools]
package-dir = { "" = "src" }

[tool.ruff]
line-length = 120
indent-width = 2
preview = true

target-version = "py311"

[tool.ruff.lint]
select = [
    "F",
    "E",
    "W",
    "I",
    "N",
    "D",
    "U",
    "ANN",
    "B",
    "A",
    "BLE",
    "C4",
    "EM",
    "EXE",
    "G",
    "PIE",
    "Q",
    "RSE",
    "RET",
    "SLF",
    "SIM",
    "TCH",
    "ARG",
    "PTH",
    "TD",
    "PD",
    "PLE",
    "PLW",
    "PLC",
    "PLR01",
    "PLR02",
    "PLR04",
    "PLR1",
    "PLR2",
    "PLR5",
    "PLR6",
    "TRY201",
    "TRY400",
    "FLY",
    "NPY",
    "PERF",
    "FURB",
    "S",
    "RUF",
]
ignore = ["ANN401", "D100", "E111", "E114", "S101"]

# Allow fix 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.pydocstyle]
convention = "numpy"

[tool.ruff.lint.per-file-ignores]
"tests/*" = [
  "ANN",      # Test fixture wiring and local helpers do not need exhaustive annotations
  "ARG005",   # Mocked call signatures often intentionally ignore parameters
  "D",        # Test names already communicate intent; per-test docstring churn is low value
  "PLC0415",  # Local imports in tests are acceptable when improving isolation
  "PLR6301",  # Test methods don't need to use self
  "PLR2004",  # Magic values are fine in tests - they're explicit test expectations
  "RUF069",   # Exact float expectations are acceptable in tests
  "S",        # Security rules are too noisy for intentionally non-production test code
  "SLF001",   # Tests may access private members to set up or inspect internal state
  "TC001",    # Test-only type imports do not justify TYPE_CHECKING indirection
  "TC003",    # Test-only type imports do not justify TYPE_CHECKING indirection
]

[tool.ruff.format]
# Like Black, use double quotes for strings.
quote-style = "double"

# Like Black, indent with spaces, rather than tabs.
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"

[dependency-groups]
dev = [
    "black>=26.3.1",
    "hypothesis>=6.127.0",
    "ipykernel>=7.1.0",
    "mutmut>=3.5.0",
    "nbmake>=1.5.5",
    "pre-commit>=4.5.1",
    "pylint>=4.0.5",
    "pytest>=8.4.2",
    "pytest-cov>=7.0.0",
    "ruff>=0.15.9",
    "scikit-learn>=1.7.2",
    "ty>=0.0.28",
]
docs = [
    "bibtex-pygments-lexer>=0.0.1",
    "matplotlib>=3.10.6",
    "myst-parser>=4.0.1",
    "numpydoc>=1.9.0",
    "sphinx>=8.1.3",
    "sphinx-autodoc-annotation>=1.0.post1",
    "sphinxcontrib-bibtex>=2.6.3",
    "pydata-sphinx-theme>=0.16.0",
]

[tool.mutmut]
paths_to_mutate = [
    "src/catsim/engine.py",
    "src/catsim/state.py",
    "src/catsim/simulation.py",
]
tests_dir = ["tests/"]
also_copy = ["src/catsim"]
do_not_mutate = [
    "*/__init__.py",
    "src/catsim/plot.py",
]
max_stack_depth = 8

[tool.ty.src]
include = ["src/catsim"]

[tool.ty.rules]
all = "ignore"
division-by-zero = "error"
possibly-missing-import = "error"
redundant-cast = "error"
unused-ignore-comment = "error"
unused-type-ignore-comment = "error"

# ---------------------------------------------------------------------------
# Pylint
# ---------------------------------------------------------------------------
[tool.pylint.messages-control]
enable = [
  "duplicate-code",
  "too-many-ancestors",
  "too-many-instance-attributes",
  "arguments-differ",
  "signature-differs",
  "arguments-renamed",
  "invalid-overridden-method",
  "overridden-final-method",
  "subclassed-final-class",
  "attribute-defined-outside-init",
  "super-init-not-called",
  "non-parent-init-called",
  "useless-parent-delegation",
  "unused-private-member",
  "redefined-slots-in-subclass",
  "bad-classmethod-argument",
  "bad-mcs-method-argument",
  "no-classmethod-decorator",
  "no-staticmethod-decorator",
  "bad-except-order",
  "duplicate-except",
  "return-in-finally",
  "lost-exception",
  "cyclic-import",
  "pointless-statement",
  "duplicate-key",
  "missing-parentheses-for-call-in-test",
  "redefined-outer-name",
]
disable = ["all"]

[tool.pylint.design]
max-parents = 7
max-attributes = 12

[tool.pylint.similarities]
min-similarity-lines = 10
ignore-imports = true
ignore-docstrings = true
ignore-comments = true