pyproject.toml

[build-system]
# wget is used to download the MOA jar file
# stubgenj is used to generate the Python stub files for the MOA classes
requires = ["hatchling", "hatch-build-scripts", "wget", "stubgenj", "invoke"]
# Build system: https://hatch.pypa.io
# The main reason I chose hatch is its support for plugins allowing us to
# download the MOA jar file before the build starts.
build-backend = "hatchling.build"

[project]
name = "capymoa"
dynamic = ['version']
description = "Python wrapper for MOA to allow efficient use of existing algorithms with a more modern API."
readme = "README.md"
license = "BSD-3-Clause"
license-files = ["LICENSE"]
homepage = "https://capymoa.org"
repository = "https://github.com/adaptive-machine-learning/CapyMOA"
authors = [
    {name="Heitor Murilo Gomes", email="hmugomes@gmail.com"},
    {name="Anton Lee", email="anton.lee@vuw.ac.nz"},
    {name="Nuwan Gunasekara"},
    {name="Marco Heyden"},
    {name="Yibin Sun"},
    {name="Guilherme Weigert Cassales"}
]
keywords = [
    "MOA",
    "Machine Learning",
    "Data Stream",
    "Online Learning",
    "Stream Learning",
    "Data Stream Mining",
    "Data Mining",
    "Incremental Learning",
    "Concept Drift",
    "Concept Evolution",
    "Concept Shift",
    "Big Data",
    "Data Science",
]

long_description_content_type = "text/markdown"
requires-python = ">=3.9"
# Defines the pip packages that are required by this package. These should be
# as permissive as possible, since capymoa should collaborate with other
# packages.
# The '~=' operator is used to specify compatible releases: newer features or bug fixes
# within the same major version are allowed.
# For example: ~= 2.2 is >= 2.2, == 2.*.*
# See: https://packaging.python.org/en/latest/specifications/version-specifiers/#compatible-release
dependencies = [
    "deprecated~=1.3",
    "jpype1~=1.6,!=1.7.0",
    "matplotlib~=3.10",
    "numpy~=2.2",
    "pandas~=2.2",
    "scikit-learn~=1.7",
    "seaborn~=0.13",
    "tqdm~=4.67",
    "torch~=2.9",
    "torchvision~=0.24",
]

[project.optional-dependencies]
# Development dependencies
dev=[
    "commitizen~=3.24",
    "invoke~=3.0",
    "jupyter~=1.1",
    "nbmake~=1.5",
    "pytest-cov~=7.0",
    "pytest-subtests~=0.15",
    "pytest-xdist~=3.8",
    "pytest~=9.0",
    "ruff~=0.14",
    "stubgenj~=0.2",
    "wget~=3.2",
]

doc=[
    "myst-parser",                 # Parses markdown files
    "nbsphinx",                    # Sphinx extension to include Jupyter notebooks
    "pydata-sphinx-theme",         # Theme for the documentation
    "sphinx_design",               # Sphinx extension for design elements
    "sphinx==8.1.3",               # Documentation generator
    "sphinxcontrib-programoutput", # Output of commands in the documentation
]

[project.urls]
Documentation = "https://capymoa.org"
Source = "https://github.com/adaptive-machine-learning/CapyMOA"

[tool.pytest.ini_options]
addopts = [
    "--import-mode=importlib",
    # pytest and jpype can raise irrelevant warnings and segfault when faulthandler is used.
    # https://github.com/jpype-project/jpype/issues/561
    "-p no:faulthandler"
]
pythonpath = ["src"]
testpaths = ["tests", "src"]
norecursedirs = [
    "docs/*"
]

[tool.hatch]
[tool.hatch.version]
path = "src/capymoa/__about__.py"
[tool.hatch.build.targets.wheel]
# Defines the directories included in the wheel package
packages = ["src/capymoa", "src/moa-stubs", "src/com-stubs"]
artifacts = ["src/capymoa/jar/moa.jar", "src/capymoa/jar/Home.class"]

# src/moa-stubs and src/com-stubs are included in the git ignore file
# that hatch inherits. To include them anyway we need to set ignore-vcs to true.
ignore-vcs = true

[tool.hatch.build.targets.sdist]
# Defines the directories included in the source distribution package (sdist).
packages = ["src/capymoa", "src/moa-stubs", "src/com-stubs"]
artifacts = ["src/capymoa/jar/moa.jar", "src/capymoa/jar/Home.class"]

# src/moa-stubs and src/com-stubs are included in the git ignore file
# that hatch inherits. To include them anyway we need to set ignore-vcs to true.
ignore-vcs = true

[[tool.hatch.build.hooks.build-scripts.scripts]]
# Ensures that the MOA jar file is downloaded before the build starts.
commands = [
    "python -m invoke build.download-moa",
    "python -m invoke build.stubs"
]
artifacts = []

[tool.semantic_release]
assets = []
commit_message = "chore(version): increment version to {version}"
commit_parser = "angular"
logging_use_named_masks = false
major_on_zero = true
allow_zero_version = true
tag_format = "v{version}"

# Find and replace version variables in the following files
version_variables = [
    "src/capymoa/__about__.py:__version__",
    "docker/.env:CAPYMOA_VERSION"
]

[tool.semantic_release.branches.main]
match = "(main|master)"
prerelease_token = "rc"
prerelease = false

[tool.semantic_release.changelog]
template_dir = "templates"
changelog_file = "CHANGELOG.md"
exclude_commit_patterns = []

[tool.semantic_release.changelog.environment]
block_start_string = "{%"
block_end_string = "%}"
variable_start_string = "{{"
variable_end_string = "}}"
comment_start_string = "{#"
comment_end_string = "#}"
trim_blocks = false
lstrip_blocks = false
newline_sequence = "\n"
keep_trailing_newline = false
extensions = []
autoescape = true

[tool.semantic_release.commit_author]
env = "GIT_COMMIT_AUTHOR"
default = "semantic-release <semantic-release>"

[tool.semantic_release.commit_parser_options]
allowed_tags = ["build", "chore", "ci", "docs", "feat", "fix", "perf", "style", "refactor", "test"]
minor_tags = ["feat"]
patch_tags = ["fix", "perf"]
default_bump_level = 0

[tool.semantic_release.remote]
name = "origin"
type = "github"
ignore_token_for_push = false
insecure = false

[tool.semantic_release.publish]
dist_glob_patterns = ["dist/*"]
upload_to_vcs_release = true

# Configuration for the formatter
[tool.ruff]
target-version = "py310"


[tool.coverage.report]
exclude_also = [
    'pass',
]

[tool.coverage.run]
omit = [
    # omit pytorch-generated files in /tmp 
    # https://stackoverflow.com/a/79415891
    "/tmp/*"
]