147 lines
3.4 KiB
TOML
147 lines
3.4 KiB
TOML
#####################
|
|
# Python packaging: #
|
|
|
|
[build-system]
|
|
requires = ["setuptools", "setuptools-scm"]
|
|
build-backend = "setuptools.build_meta"
|
|
|
|
[project]
|
|
name = "${REPO_NAME}"
|
|
description = "${REPO_DESCRIPTION}"
|
|
authors = [
|
|
{ name = ..., email = ... },
|
|
]
|
|
maintainers = [
|
|
{ name = ..., email = ... },
|
|
]
|
|
requires-python = ">=3.9, <4.0"
|
|
keywords = [
|
|
...
|
|
]
|
|
license = { text = "Apache Software License Version 2.0" }
|
|
classifiers = [
|
|
"Development Status :: 4 - Beta",
|
|
"Programming Language :: Python :: 3 :: Only",
|
|
"Programming Language :: Python :: 3.9",
|
|
"Programming Language :: Python :: 3.10",
|
|
"Programming Language :: Python :: 3.11",
|
|
"Operating System :: OS Independent",
|
|
"License :: OSI Approved :: Apache Software License",
|
|
# "Intended Audience :: Developers",
|
|
# "Framework :: AsyncIO",
|
|
# "Topic :: Internet",
|
|
...
|
|
]
|
|
dynamic = [
|
|
"dependencies",
|
|
"readme",
|
|
"version",
|
|
]
|
|
|
|
[project.optional-dependencies]
|
|
full = [
|
|
...
|
|
]
|
|
dev = [
|
|
"black==23.7.0",
|
|
"build==0.10.0",
|
|
"coverage[toml]==7.2.7",
|
|
"isort==5.12.0",
|
|
"mkdocs-material==9.1.18",
|
|
"mkdocstrings[python]==0.22.0",
|
|
"mypy==1.4.1",
|
|
"ruff==0.0.278",
|
|
]
|
|
|
|
[project.urls]
|
|
"Repository" = "https://github.com/${REPO_OWNER_LOWER}/${REPO_NAME_LOWER}"
|
|
"Issue Tracker" = "https://github.com/${REPO_OWNER_LOWER}/${REPO_NAME_LOWER}/issues"
|
|
"Documentation" = "http://${REPO_OWNER_LOWER}.github.io/${REPO_NAME_LOWER}"
|
|
|
|
[tool.setuptools.dynamic]
|
|
dependencies = { file = "requirements/common.txt" }
|
|
readme = { file = ["README.md"], content-type = "text/markdown" }
|
|
version = {attr = ..."${REPO_NAME}.__version__"}
|
|
|
|
#########################
|
|
# Static type checking: #
|
|
|
|
[tool.mypy]
|
|
cache_dir = ".cache/mypy"
|
|
files = [
|
|
"src/",
|
|
"tests/",
|
|
]
|
|
warn_unused_configs = true
|
|
strict = true
|
|
show_error_codes = true
|
|
plugins = []
|
|
|
|
#######################
|
|
# Unit test coverage: #
|
|
|
|
[tool.coverage.run]
|
|
data_file = ".cache/coverage"
|
|
source = [
|
|
"src/",
|
|
]
|
|
branch = true
|
|
command_line = "-m tests"
|
|
omit = [
|
|
".venv*/*",
|
|
]
|
|
|
|
[tool.coverage.report]
|
|
show_missing = true
|
|
skip_covered = false
|
|
exclude_lines = [
|
|
"if TYPE_CHECKING:",
|
|
'''if __name__ == ['"]__main__['"]:''',
|
|
"@overload",
|
|
]
|
|
omit = [
|
|
"tests/*",
|
|
]
|
|
|
|
###############################
|
|
# Linting and style checking: #
|
|
|
|
[tool.ruff]
|
|
cache-dir = ".cache/ruff"
|
|
select = [
|
|
"E", # pycodestyle errors
|
|
"W", # pycodestyle warnings
|
|
"F", # pyflakes
|
|
"D", # pydocstyle
|
|
"C", # flake8-comprehensions
|
|
"B", # flake8-bugbear
|
|
"PL", # pylint
|
|
"RUF", # ruff-specific
|
|
]
|
|
ignore = [
|
|
"E501", # Line too long -> handled by black
|
|
"D203", # 1 blank line required before class docstring -> D211 is better
|
|
"D212", # Multi-line docstring summary should start at the first line -> ugly, D212 is better
|
|
"D401", # First line of docstring should be in imperative mood -> no, it shouldn't
|
|
"D407", # Missing dashed underline after section -> different docstring style
|
|
]
|
|
|
|
[tool.ruff.per-file-ignores]
|
|
"src/**/__init__.py" = [
|
|
"D104", # Missing docstring in public package
|
|
"F401", # {...} imported but unused
|
|
]
|
|
"tests/*.py" = [
|
|
"D100", # Missing docstring in public module
|
|
"D101", # Missing docstring in public class
|
|
"D102", # Missing docstring in public method
|
|
"D104", # Missing docstring in public package
|
|
]
|
|
|
|
###################
|
|
# Import sorting: #
|
|
|
|
[tool.isort]
|
|
profile = "black"
|
|
extra_standard_library = ["typing_extensions"]
|