pyproject.toml

[build-system]
requires = ["setuptools>=60", "setuptools-scm>=8.0"]
build-backend = "setuptools.build_meta"

[project]
name = "linopy"
dynamic = ["version"]
description = "Linear optimization with N-D labeled arrays in Python"
readme = "README.md"
authors = [{ name = "Fabian Hofmann", email = "fabianmarikhofmann@gmail.com" }]
maintainers = [
    { name = "Fabian Hofmann", email = "fabianmarikhofmann@gmail.com" },
    { name = "Felix Bumann", email = "dev@fxbumann.de" },
]
license = { file = "LICENSE" }
classifiers = [
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Development Status :: 3 - Alpha",
    "Environment :: Console",
    "Intended Audience :: Science/Research",
    "License :: OSI Approved :: MIT License",
    "Natural Language :: English",
    "Typing :: Typed",
    "Operating System :: OS Independent",
]

requires-python = ">=3.11"
dependencies = [
    "numpy",
    "scipy",
    "bottleneck",
    "toolz",
    "numexpr",
    "xarray>=2024.2.0",
    "dask>=0.18.0",
    "polars>=1.31.1",
    "tqdm",
    "deprecation",
    "packaging",
]

[project.urls]
Homepage = "https://github.com/PyPSA/linopy"
Source = "https://github.com/PyPSA/linopy"

[project.optional-dependencies]
oetc = [
    "google-cloud-storage",
    "requests",
]
remote = [
    "paramiko",
]
docs = [
    "ipython==9.15.0",
    "numpydoc==1.10.0",
    "sphinx_rtd_theme==3.1.0",
    "sphinx==9.0.4",
    "sphinx_book_theme==1.2.0",
    "sphinx-copybutton==0.5.2",
    "nbsphinx==0.9.4",
    "nbsphinx-link==1.3.0",
    "docutils<0.21",
    "numpy<2",
    "gurobipy>=13.0.0",
    "ipykernel==7.3.0",
    "matplotlib==3.11.0",
    "highspy>=1.7.1",
]
dev = [
    "pytest",
    "pytest-cov",
    'mypy',
    "pre-commit",
    "netcdf4",
    "paramiko",
    "types-paramiko",
    "types-requests",
    "gurobipy",
    "highspy",
    "jupyter",
]
# Perf-relevant deps pinned exactly so run-to-run deltas reflect linopy
# changes, not dependency bumps.
benchmarks = [
    "highspy==1.15.0",
    "netcdf4==1.7.4",
    "numpy==2.4.6",
    "scipy==1.17.1",
    "xarray==2026.4.0",
    "pandas==3.0.3",
    "polars==1.41.2",
    "dask==2026.6.0",
    "pytest==9.1.1",
    "pytest-benchmark==5.2.3",
    "pytest-memray==1.9.0",
    "pytest-codspeed==5.0.3",
]
solvers = [
    "gurobipy",
    "highspy>=1.5.0,!=1.14.0; python_version < '3.12'",
    "highspy>=1.7.1,!=1.14.0; python_version >= '3.12'",
    "cplex; platform_system != 'Darwin'",
    "mosek",
    "mindoptpy",
    "coptpy!=7.2.1",
    "xpress; platform_system != 'Darwin'",
    "pyscipopt; platform_system != 'Darwin'",
    "knitro>=15.1.0",
    # "cupdlpx>=0.1.2", pip package currently unstable
]

[tool.setuptools.packages.find]
include = ["linopy"]

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

[tool.setuptools_scm]
write_to = "linopy/version.py"
version_scheme = "no-guess-dev"

[tool.pytest.ini_options]
testpaths = ["test"]
norecursedirs = ["dev-scripts", "doc", "examples", "benchmark", "benchmarks"]
markers = [
    "gpu: marks tests as requiring GPU hardware (deselect with '-m \"not gpu\"')",
]
filterwarnings = [
    # Silence our own EvolvingAPIWarning inside the test suite so the
    # piecewise tests don't emit 500+ warnings.  Users still see them.
    # Match by message prefix on the builtin FutureWarning base class
    # rather than on ``linopy.EvolvingAPIWarning`` directly — using the
    # class reference here would force pytest to import linopy at
    # config-parse time, which loads ``linopy.variables`` from
    # site-packages and then conflicts with ``--doctest-modules``
    # collection of ``linopy/variables.py`` in the source tree on
    # Windows CI.
    "ignore:piecewise:FutureWarning",
]

[tool.coverage.run]
branch = true
source = ["linopy"]
omit = ["test/*"]
[tool.coverage.report]
exclude_also = ["if TYPE_CHECKING:"]

[tool.mypy]
exclude = ['dev/*', 'examples/*', '^benchmark/', 'doc/*']
ignore_missing_imports = true
no_implicit_optional = true
warn_unused_ignores = true
show_error_code_links = true
disallow_untyped_defs = true
# disallow_any_generics = true
# warn_return_any = true

# [[tool.mypy.overrides]]
# module = "linopy.*"
# disallow_untyped_defs = true

[tool.ruff]
extend-include = ['*.ipynb']

[tool.ruff.lint]
select = [
    'F',   # pyflakes
    'E',   # pycodestyle: Error
    'W',   # pycodestyle: Warning
    'I',   # isort
    'D',   # pydocstyle
    'UP',  # pyupgrade
    'TID', # flake8-tidy-imports
    'NPY', # numpy
]

ignore = [
    'E501', # line too long
    'E741', # ambiguous variable names
    'D105', # Missing docstring in magic method
    'D212', # Multi-line docstring summary should start at the second line
    'D200', # One-line docstring should fit on one line with quotes
    'D401', # First line should be in imperative mood
    'D404', # First word of the docstring should not be "This
    'D413', # Missing blank line after last section

    # pydocstyle ignores, which could be enabled in future when existing
    # issues are fixed
    'D100', # Missing docstring in public module
    'D101', # Missing docstring in public class
    'D102', # Missing docstring in public method
    'D103', # Missing docstring in public function
    'D106', # Missing docstring in public nested class
    'D107', # Missing docstring in __init__
    'D202', # No blank lines allowed after function docstring
    'D203', # 1 blank line required before class docstring
    'D205', # 1 blank line required between summary line and description
    'D400', # First line should end with a period
    'D415', # First line should end with a period, question mark, or exclamation point
    'D417', # Missing argument descriptions in the docstring

]

[tool.ruff.lint.per-file-ignores]
"benchmark/notebooks/**.ipynb" = [
    "F821", # undefined-name - e.g. "snakemake is undefined"
]
"benchmark/scripts/**.py" = [
    "F821", # undefined-name - e.g. "snakemake is undefined"
]

[tool.ruff.lint.flake8-tidy-imports]
# Disallow all relative imports.
ban-relative-imports = "all"