pyproject.toml

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


[project]
name = "scipy-stubs"
version = "1.15.2.3.dev0"
description = "Type annotations for SciPy"
readme = "README.md"
authors = [
    {name = "Joren Hammudoglu", email = "jhammudoglu@gmail.com"},
]
maintainers = [
    {name = "SciPy Developers", email = "scipy-dev@python.org"},
    {name = "Joren Hammudoglu", email = "jhammudoglu@gmail.com"},
]
license = "BSD-3-Clause"
keywords = ["scipy", "typing", "pep484"]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Developers",
    "Intended Audience :: Science/Research",
    "License :: OSI Approved :: BSD License",
    "Operating System :: OS Independent",
    "Programming Language :: Python",
    "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 :: Stubs Only",
]
requires-python = ">=3.10"
dependencies = ["optype>=0.9.3"]

    [project.optional-dependencies]
    scipy = ["scipy>=1.15.2,<1.16"]

    [project.urls]
    Homepage = "https://scipy.org/"
    Repository = "https://github.com/scipy/scipy-stubs/"
    Issues = "https://github.com/scipy/scipy-stubs/issues"
    Changelog = "https://github.com/scipy/scipy-stubs/releases"


[dependency-groups]
extras = ["scipy-stubs[scipy]"]
ci = ["packaging>=24.2"]
mdformat = [
    "mdformat>=0.7.22",
    "mdformat-gfm>=0.4.1",
    "mdformat-gfm-alerts>=1.0.1",
]
lint = [
    {include-group = "extras"},
    {include-group = "mdformat"},
    "ruff>=0.11.4",
    "sp-repo-review[cli]>=2025.1.22",
]
type = [
    {include-group = "extras"},
    {include-group = "ci"},
    "basedmypy[faster-cache]>=2.10.0",
    "basedpyright>=1.28.4",
]
dev = [
    {include-group = "lint"},
    {include-group = "type"},
]


[tool.hatch.build]
packages = ["scipy-stubs"]

    [tool.hatch.build.targets.sdist]
    exclude = ["CODE_OF_CONDUCT.md", "README.md", "SECURITY.md", "uv.lock"]
    force-include = {".mypyignore" = ".mypyignore"}                         # for scipy-stubs-feedstock


[tool.poe.tasks.clean]
cmd = """
rm -rf
    scipy-stubs/**/*.pyc
    scipy-stubs/**/__pycache__
    scripts/*.pyc
    scripts/__pycache__
    tests/**/*.pyc
    tests/**/__pycache__
    ./**/.cache
    ./**/.mypy_cache
    ./**/.ruff_cache
    ./**/.tox
"""

[tool.poe.tasks.stubtest]
cmd = """
uv run
    --no-editable
    --reinstall-package=scipy-stubs
    stubtest
    --mypy-config-file=pyproject.toml
    --allowlist=.mypyignore
    --ignore-unused-allowlist
    $modules
"""
args = [{name = "modules", positional = true, multiple = true, default = "scipy"}]


[tool.typos.files]
extend-exclude = ["*.pyi", ".mypyignore"]


[tool.mypy]
strict = true
strict_bytes = true

enable_error_code = [
    "ignore-without-code",
    "redundant-expr",
    "truthy-bool",
]
warn_unreachable = false
warn_unused_ignores = true
# basedmypy/mypy compat
disallow_any_decorated = false
disallow_any_explicit = false
disallow_any_expr = false
disallow_subclassing_any = false
# https://github.com/python/mypy/issues/18744
disable_bytearray_promotion = true
disable_memoryview_promotion = true
# optype numpy compat
always_true = ["NP123", "NP124", "NP125", "NP126", "NP20", "NP21", "NP22"]
always_false = ["NP23", "NP30"]


[tool.pyright]
include = ["scipy-stubs", "scripts", "tests"]
ignore = [".venv"]
stubPath = "."
pythonPlatform = "All"
typeCheckingMode = "strict"
deprecateTypingAliases = true
enableReachabilityAnalysis = false
enableTypeIgnoreComments = false
reportCallInDefaultInitializer = true
reportImplicitOverride = true
reportImportCycles = true
reportMissingSuperCall = true
reportPropertyTypeMismatch = false
reportShadowedImports = true
reportUninitializedInstanceVariable = true
reportUnnecessaryTypeIgnoreComment = true

# overridden in the execution environments
reportInvalidStubStatement = false

# type-checkers should type-check; linters should lint
reportImplicitStringConcatenation = false
reportPrivateImportUsage = false
reportPrivateUsage = false

# basedpyright
failOnWarnings = true
reportIgnoreCommentWithoutRule = true
reportImplicitAbstractClass = true
reportImplicitRelativeImport = true
reportInvalidCast = true
reportPrivateLocalImportUsage = true
reportUnannotatedClassAttribute = false
strictGenericNarrowing = false

[[executionEnvironments]]
root = "scipy-stubs"
reportInvalidStubStatement = true
reportUnusedCallResult = true

[[executionEnvironments]]
root = "tests"
reportAny = true
reportExplicitAny = true
reportPrivateUsage = true
reportUnreachable = true
reportUnsafeMultipleInheritance = true # base

    [tool.pyright.defineConstant]
    # optype numpy compat
    NP123 = true
    NP124 = true
    NP125 = true
    NP126 = true
    NP20 = true
    NP21 = true
    NP22 = true
    NP23 = false
    NP30 = false

[tool.repo-review]
ignore = [
    "PY004", # no /docs
    "PY006", # pre-commit should not be used
    "PY007", # tox configured in tox.toml
    "PP301", # pytest is irrelevant
    "PC111", # no blacken-docs because markdown has no code
    "PC170", # no pygrep-hooks because no rST
    "RTD",   # no RTD
]


[tool.ruff]
src = ["scipy-stubs", "scripts"]
extend-exclude = [".venv", ".git", ".mypy_cache", ".tox"]
force-exclude = true
# https://typing.readthedocs.io/en/latest/guides/writing_stubs.html#maximum-line-length
line-length = 130

    [tool.ruff.format]
    docstring-code-format = true
    line-ending = "lf"

    [tool.ruff.lint]
    preview = true
    select = ["ALL"]
    ignore = ["D", "FBT", "COM812", "CPY", "EM", "TD", "FIX", "DOC"]

        [tool.ruff.lint.per-file-ignores]
        "*.pyi" = ["F", "E741", "N", "A", "PYI054", "PLC2701", "PLW3201", "PLR", "FURB"]

        [tool.ruff.lint.flake8-import-conventions]
        banned-from = ["numpy", "numpy.typing", "optype", "optype.numpy", "optype.typing"]
            [tool.ruff.lint.flake8-import-conventions.extend-aliases]
            "ctypes" = "ct"
            "datetime" = "dt"
            "numpy" = "np"
            "numpy.typing" = "npt"
            "optype" = "op"
            "optype.numpy" = "onp"
            "optype.typing" = "opt"

        [tool.ruff.lint.isort]
        combine-as-imports = true
        known-first-party = ["scipy"]
        no-lines-before = ["typing", "first-party", "local-folder"]
        section-order = ["standard-library", "typing", "third-party", "first-party", "local-folder"]
        split-on-trailing-comma = true

            [tool.ruff.lint.isort.sections]
            typing = ["collections.abc", "types", "typing", "typing_extensions"]

        [tool.ruff.lint.flake8-annotations]
        allow-star-arg-any = true
        mypy-init-return = true