pyproject.toml

[build-system]
requires = ["poetry-core>=2,<3"]
build-backend = "poetry.core.masonry.api"

[project]
name = "py-app-dev"
version = "2.21.0"
description = "My application development modules."
readme = "README.md"
license = { text = "MIT" }
authors = [
  { name = "cuinixam", email = "cuinixam@me.com" },
]
requires-python = "<4.0,>=3.10"
classifiers = [
  "Development Status :: 2 - Pre-Alpha",
  "Intended Audience :: Developers",
  "Natural Language :: English",
  "Operating System :: OS Independent",
  "Topic :: Software Development :: Libraries",
]

dependencies = [
    "mashumaro<4.0,>=3.5",
    "loguru<1.0,>=0.7",
    "psutil>=7.1,<8.0",
]
urls."Bug Tracker" = "https://github.com/cuinixam/py-app-dev/issues"
urls.Changelog = "https://github.com/cuinixam/py-app-dev/blob/main/CHANGELOG.md"
urls.repository = "https://github.com/cuinixam/py-app-dev"

[dependency-groups]
dev = [
  "pytest<9.0,>=8.3",
  "pytest-cov<7.0,>=6.0",
  "pre-commit<5.0,>=4.0",
  "ruff<1.0,>=0.9",
  "pypeline-runner<2.0,>=1.0",
  "wrapt",
  # docs
  "myst-parser>=4.0,<5",
  "sphinxcontrib-mermaid>=1.0,<2",
  "mlx-traceability>=11.0,<12",
  "sphinx-copybutton>=0,<1",
  "sphinx-new-tab-link>=0,<1",
  "sphinx-book-theme>=1.1,<2",
  "sphinx-design>=0,<1"
]

[tool.ruff]
target-version = "py310"
line-length = 180
lint.select = [
  "B",   # flake8-bugbear
  "D",   # flake8-docstrings
  "C4",  # flake8-comprehensions
  "S",   # flake8-bandit
  "F",   # pyflake
  "E",   # pycodestyle
  "W",   # pycodestyle
  "UP",  # pyupgrade
  "I",   # isort
  "RUF", # ruff specific
]
lint.ignore = [
  "D203", # 1 blank line required before class docstring
  "D212", # Multi-line docstring summary should start at the first line
  "D100", # Missing docstring in public module
  "D101", # Missing docstring in public class
  "D102", # Missing docstring in public method
  "D103", # Missing docstring in public function
  "D104", # Missing docstring in public package
  "D105", # Missing docstring in magic method
  "D106", # Missing docstring in public nested class
  "D107", # Missing docstring in `__init__`
  "D401", # First line of docstring should be in imperative mood
]
lint.per-file-ignores."conftest.py" = [ "D100" ]
lint.per-file-ignores."setup.py" = [ "D100" ]
lint.per-file-ignores."tests/**/*" = [
  "D100",
  "D101",
  "D102",
  "D103",
  "D104",
  "S101",
]
lint.isort.known-first-party = [ "py_app_dev", "tests" ]

[tool.pytest.ini_options]
addopts = """\
    -v
    -Wdefault
    --cov=py_app_dev
    --cov-report=term
    --cov-report=xml
    """
pythonpath = [ "src" ]
markers = [
    "exploratory: local-only exploratory tests; skipped by default (run with --run-exploratory)",
]

[tool.coverage.run]
branch = true

[tool.coverage.paths]
source = [
  "src",
  ".tox/**/site-packages",
]

[tool.coverage.report]
exclude_lines = [
  "pragma: no cover",
  "@overload",
  "if TYPE_CHECKING",
  "raise NotImplementedError",
  'if __name__ == "__main__":',
]

[tool.mypy]
check_untyped_defs = true
disallow_any_generics = true
disallow_incomplete_defs = true
disallow_untyped_defs = true
mypy_path = "src/"
no_implicit_optional = true
show_error_codes = true
warn_unreachable = true
warn_unused_ignores = true
exclude = [
  'setup.py',
]

[[tool.mypy.overrides]]
module = "tests.*"
allow_untyped_defs = true

[tool.semantic_release]
version_toml = [ "pyproject.toml:project.version" ]
version_variables = [
  "src/py_app_dev/__init__.py:__version__",
]
build_command = """
pip install uv
uv lock
git add uv.lock
uv build
"""

[tool.semantic_release.changelog]
exclude_commit_patterns = [
  '''chore(?:\([^)]*?\))?: .+''',
  '''ci(?:\([^)]*?\))?: .+''',
  '''refactor(?:\([^)]*?\))?: .+''',
  '''style(?:\([^)]*?\))?: .+''',
  '''test(?:\([^)]*?\))?: .+''',
  '''build\((?!deps\): .+)''',
  '''Merged? .*''',
  '''Initial [Cc]ommit.*''', # codespell:ignore
]

[tool.semantic_release.changelog.environment]
keep_trailing_newline = true

[tool.semantic_release.branches.main]
match = "main"

[tool.semantic_release.branches.noop]
match = "(?!main$)"
prerelease = true