pyproject.toml

# License: MIT
# Copyright © 2024 Frequenz Energy-as-a-Service GmbH

[build-system]
requires = [
  "setuptools == 80.9.0",
  "setuptools_scm[toml] == 8.3.1",
  "frequenz-repo-config[lib] == 0.13.4",
]
build-backend = "setuptools.build_meta"

[project]
name = "frequenz-client-electricity-trading"
description = "Electricity Trading API client for Python"
readme = "README.md"
license = { text = "MIT" }
keywords = [
  "frequenz",
  "python",
  "lib",
  "library",
  "client-electricity-trading",
  "client",
  "api",
  "python",
  "trading",
  "electricity-trading",
]
classifiers = [
  "Development Status :: 3 - Alpha",
  "Intended Audience :: Developers",
  "License :: OSI Approved :: MIT License",
  "Programming Language :: Python :: 3",
  "Programming Language :: Python :: 3 :: Only",
  "Topic :: Software Development :: Libraries",
  "Typing :: Typed",
]
requires-python = ">= 3.11, < 4"
# TODO(cookiecutter): Remove and add more dependencies if appropriate
dependencies = [
  "click >= 8.1.8, < 9",
  "entsoe-py >= 0.6.16, < 1",
  "frequenz-api-common >= 0.6.5, < 0.7.0",
  "grpcio >= 1.72.1, < 2",
  "frequenz-channels >= 1.6.1, < 2",
  "frequenz-client-base >= 0.11.0, < 0.12.0",
  "frequenz-client-common >= 0.1.0, < 0.4.0",
  "frequenz-api-electricity-trading >= 0.8.0, < 0.9.0",
  "protobuf >= 6.31.1, < 8", # Do not widen beyond 8!
]
dynamic = ["version"]

[project.scripts]
trading-cli = "frequenz.client.electricity_trading.cli.__main__:main"

[[project.authors]]
name = "Frequenz Energy-as-a-Service GmbH"
email = "floss@frequenz.com"

# TODO(cookiecutter): Remove and add more optional dependencies if appropriate
[project.optional-dependencies]
dev-flake8 = [
  "flake8 == 7.2.0",
  "flake8-docstrings == 1.7.0",
  "flake8-pyproject == 1.2.3", # For reading the flake8 config from pyproject.toml
  "pydoclint == 0.6.6",
  "pydocstyle == 6.3.0",
]
dev-formatting = ["black == 25.1.0", "isort == 6.0.1"]
dev-mkdocs = [
  "black == 25.1.0",
  "Markdown==3.8",
  "mike == 2.1.3",
  "mkdocs-gen-files == 0.5.0",
  "mkdocs-literate-nav == 0.6.2",
  "mkdocs-macros-plugin == 1.3.7",
  "mkdocs-material == 9.6.14",
  "mkdocstrings[python] == 0.29.1",
  "mkdocstrings-python == 1.16.11",
  "frequenz-repo-config[lib] == 0.13.4",
]
dev-mypy = [
  "mypy == 1.16.0",
  "grpc-stubs == 1.53.0.6",
  "pandas-stubs == 2.2.3.250308",
  "types-Markdown == 3.8.0.20250415",
  "types-protobuf == 5.29.1.20250403",
  # For checking the noxfile, docs/ script, and tests
  "frequenz-client-electricity-trading[dev-mkdocs,dev-noxfile,dev-pytest]",
]
dev-noxfile = ["nox == 2025.5.1", "frequenz-repo-config[lib] == 0.13.4"]
dev-pylint = [
  "pylint == 3.3.7",
  # For checking the noxfile, docs/ script, and tests
  "frequenz-client-electricity-trading[dev-mkdocs,dev-noxfile,dev-pytest]",
]
dev-pytest = [
  "pytest == 8.3.5",
  "frequenz-repo-config[extra-lint-examples] == 0.13.4",
  "pytest-mock == 3.14.0",
  "pytest-asyncio == 0.26.0",
  "async-solipsism == 0.7",
  "deepdiff == 8.5.0",
]
dev = [
  "frequenz-client-electricity-trading[dev-mkdocs,dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]",
]

[project.urls]
Documentation = "https://frequenz-floss.github.io/frequenz-client-electricity-trading-python/"
Changelog = "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/releases"
Issues = "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/issues"
Repository = "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python"
Support = "https://github.com/frequenz-floss/frequenz-client-electricity-trading-python/discussions/categories/support"

[tool.black]
line-length = 88
target-version = ['py311']
include = '\.pyi?$'

[tool.isort]
profile = "black"
line_length = 88
src_paths = ["benchmarks", "examples", "src", "tests"]

[tool.flake8]
# We give some flexibility to go over 88, there are cases like long URLs or
# code in documenation that have extra indentation. Black will still take care
# of making everything that can be 88 wide, 88 wide.
max-line-length = 100
extend-ignore = [
  "E203", # Whitespace before ':' (conflicts with black)
  "W503", # Line break before binary operator (conflicts with black)
]
# pydoclint options
style = "google"
check-return-types = false
check-yield-types = false
arg-type-hints-in-docstring = false
arg-type-hints-in-signature = true
allow-init-docstring = true
check-class-attributes = false

[tool.pylint.similarities]
ignore-comments = ['yes']
ignore-docstrings = ['yes']
ignore-imports = ['no']
min-similarity-lines = 40

[tool.pylint.messages_control]
disable = [
  "too-few-public-methods",
  "too-many-return-statements",
  # disabled because it conflicts with isort
  "wrong-import-order",
  "ungrouped-imports",
  # pylint's unsubscriptable check is buggy and is not needed because
  # it is a type-check, for which we already have mypy.
  "unsubscriptable-object",
  # Checked by mypy
  "no-member",
  "no-name-in-module",
  # Checked by flake8
  "f-string-without-interpolation",
  "line-too-long",
  "missing-function-docstring",
  "redefined-outer-name",
  "unnecessary-lambda-assignment",
  "unused-import",
  "unused-variable",
]

[tool.pytest.ini_options]
addopts = "-vv"
testpaths = ["tests", "src"]
asyncio_default_fixture_loop_scope = "function"
asyncio_mode = "auto"
required_plugins = ["pytest-asyncio", "pytest-mock"]
filterwarnings = [
  "error",
  "once::DeprecationWarning",
  "once::PendingDeprecationWarning",
  # We ignore warnings about protobuf gencode version being one version older
  # than the current version, as this is supported by protobuf, and we expect to
  # have such cases. If we go too far, we will get a proper error anyways.
  # We use a raw string (single quotes) to avoid the need to escape special
  # characters as this is a regex.
  'ignore:Protobuf gencode version .*exactly one major version older.*:UserWarning',
]

[tool.mypy]
explicit_package_bases = true
namespace_packages = true
# This option disables mypy cache, and it is sometimes useful to enable it if
# you are getting weird intermittent error, or error in the CI but not locally
# (or vice versa). In particular errors saying that type: ignore is not
# used but getting the original ignored error when removing the type: ignore.
# See for example: https://github.com/python/mypy/issues/2960
#no_incremental = true
packages = ["frequenz.client.electricity_trading"]
strict = true

[[tool.mypy.overrides]]
module = [
  "mkdocs_macros.*",
  "sybil",
  "sybil.*",
  "deepdiff",
  "entsoe",
  "entsoe.",
]
ignore_missing_imports = true

[tool.setuptools_scm]
version_scheme = "post-release"