pyproject.toml

[build-system]
requires = ["hatchling>=1.27.0", "hatch-vcs"]
build-backend = "hatchling.build"

[tool.hatch.version]
source = "vcs"

[tool.hatch.build.hooks.vcs]
version-file = "caldav/_version.py"

[tool.hatch.build.targets.sdist]
exclude = [
  ".#*",      # Emacs lock files
  "#*#",      # Emacs auto-save files
  "*~",       # Backup files
  "*.swp",    # Vim swap files
  "*.pyc",    # Python bytecode
  "__pycache__",
]

[tool.hatch.build.targets.wheel]
exclude = [
  ".#*",
  "#*#",
  "*~",
  "*.swp",
  "*.pyc",
  "__pycache__",
]

[project]
name = "caldav"
authors = [{ name = "Cyril Robert", email = "cyril@hippie.io" }, { name = "Tobias Brox", email = "caldav@plann.no" }]
license = "GPL-3.0-or-later OR Apache-2.0"
license-files = ["COPYING.*"]
description = "CalDAV (RFC4791) client library"
keywords = []
readme = "README.md"
requires-python = ">=3.10"
classifiers = [
  "Development Status :: 4 - Beta",
  "Intended Audience :: Developers",
  "Operating System :: OS Independent",
  "Programming Language :: Python",
  "Programming Language :: Python :: 3.10",
  "Programming Language :: Python :: 3.11",
  "Programming Language :: Python :: 3.12",
  "Programming Language :: Python :: 3.13",
  "Programming Language :: Python :: 3.14",
  "Topic :: Office/Business :: Scheduling",
  "Topic :: Software Development :: Libraries :: Python Modules",
]

dependencies = [
  "lxml",
  "niquests",
  "recurring-ical-events>=2.0.0",
  "typing_extensions;python_version<'3.11'",
  "icalendar>6.0.0",
  "icalendar-searcher>=1.0.5,<2",
  "dnspython",
  "python-dateutil",
  "PyYAML",
]
dynamic = ["version"]

[project.urls]
Repository = "https://github.com/python-caldav/caldav"
Issues = "https://github.com/python-caldav/caldav/issues"
Documentation = "https://caldav.readthedocs.io/"
Changelog = "https://github.com/python-caldav/caldav/blob/master/CHANGELOG.md"

[project.optional-dependencies]
test = [
  "vobject",
  "pytest",
  "pytest-asyncio",
  "coverage",
  "manuel",
  "proxy.py",
  "tzlocal",
  "xandikos>=0.3.3",
  "radicale",
  "pyfakefs",
  "httpx",
  #"caldav_server_tester"
  "deptry>=0.24.0; python_version >= '3.10'",
]
[tool.setuptools_scm]
write_to = "caldav/_version.py"

[tool.setuptools]
py-modules = ["caldav"]
include-package-data = true

[tool.setuptools.packages.find]
exclude = ["tests"]
namespaces = false

[tool.deptry]
ignore = ["DEP002"]  # Test dependencies (pytest, coverage, etc.) are not imported in main code

[tool.deptry.per_rule_ignores]
DEP001 = ["conf", "h2"]  # conf: Local test config, h2: Optional HTTP/2 support
DEP003 = ["aiohttp"]  # aiohttp: optional dep used only in caldav/testing.py (XandikosServer)

[tool.ruff]
line-length = 100
target-version = "py310"

[tool.ruff.lint]
select = [
    "E",    # pycodestyle errors
    "F",    # pyflakes
    "W",    # pycodestyle warnings
    "I",    # isort
    "UP",   # pyupgrade (modernize code)
    "B",    # flake8-bugbear (find bugs)
]
## See https://github.com/python-caldav/caldav/issues/634 for ongoing work to reduce this list
ignore = [
    "E501",    # Line too long (formatter handles this)
    "E402",    # Module level import not at top of file (common with conditional imports)
    "E722",    # Bare except — 28 violations, each needs case-by-case review
    "F401",    # Unused imports — many are re-exports or conditional; needs audit
    "F821",    # Undefined names — often in TYPE_CHECKING blocks or docstrings
    "F841",    # Unused variables — often intentional (e.g. unpacking)
    "UP031",   # %-format — 31 violations; ruff only offers unsafe auto-fix
]

[tool.ruff.lint.per-file-ignores]
# Examples and docs may have undefined names for illustration
"examples/*.py" = ["F821"]
"docs/**/*.py" = ["F821"]
# Tests may use assertions and have unusual patterns
"tests/*.py" = ["B011", "B017"]

[tool.ruff.format]
quote-style = "double"
indent-style = "space"

[tool.ruff.lint.isort]
known-first-party = ["caldav"]

[tool.pytest.ini_options]
asyncio_mode = "strict"
filterwarnings = [
    # Treat all warnings as errors by default
    "error",

    # Allow missing _version.py warning during development/testing (generated by hatch-vcs on build/install)
    "ignore:You need to install the `build` package:UserWarning",

    # Ignore deprecation warnings from external libraries we can't control
    # https://github.com/jawah/niquests/pull/327 https://github.com/jawah/niquests/issues/326
    "ignore:.*asyncio.iscoroutinefunction.*:DeprecationWarning:niquests",

    # Radicale upstream bugs: unclosed resources during server shutdown
    # https://github.com/Kozea/Radicale/issues/1972
    "ignore:unclosed.*:ResourceWarning",
    "ignore:Exception ignored.*:pytest.PytestUnraisableExceptionWarning",

    # Radicale uses deprecated importlib.abc.Traversable (Python 3.14 removal)
    "ignore:.*importlib.abc.Traversable.*:DeprecationWarning",

    # Show conf_private.py deprecation warning once (not as error) during migration period
    "once:conf_private.py is deprecated:DeprecationWarning",

    # Zimbra test server uses HTTPS with self-signed cert (ssl_verify_cert=False)
    "ignore:Unverified HTTPS request:urllib3_future.exceptions.InsecureRequestWarning",
]