This release is a pre-release and may not be stable for production use.
caldav
This project is a CalDAV (RFC4791) client library for Python.
Features:
- create, modify calendar
- create, update and delete event
- search events by dates
- async support via
caldav.aiomodule - etc.
Quick Start
from caldav import get_davclient
with get_davclient() as client:
principal = client.principal()
calendars = principal.get_calendars()
for cal in calendars:
print(f"Calendar: {cal.name}")
Async API
For async/await support, use the caldav.aio module:
import asyncio
from caldav import aio
async def main():
async with aio.get_async_davclient() as client:
principal = await client.principal()
calendars = await principal.get_calendars()
for cal in calendars:
print(f"Calendar: {cal.name}")
asyncio.run(main())
Documentation and other links
The user documentation (up-to-date with version 3.2) is embedded under docs/source - a rendered copy is available at https://caldav.readthedocs.io/
Other documentation:
- This file
- Changelog
- Contributors guide
- Contact information
- Code of Conduct
- Security Policy
- AI policy and AI disclaimer
- Apache License
- GPL license
There is also a directory docs/design containing lots of documents, mostly AI-generated, containing things like design decisions and other things that neither is deemed important enough to have a document on the root of the project nor deemed to be "user documentation".
The package is published at Pypi
HTTP Libraries
The sync client uses niquests by default (with fallback to requests). The async client prefers niquests as well, falling back to the httpx family (httpx2, httpxyz, httpx) - the first one installed wins. See HTTP Library Configuration for details.
Licences
The caldav library is dual-licensed under the GNU GENERAL PUBLIC LICENSE Version 3 or the Apache License 2.0.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file caldav-3.3.0a1.tar.gz.
File metadata
- Download URL: caldav-3.3.0a1.tar.gz
- Upload date:
- Size: 691.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ce83337ef28f0a76100061188229a311ad51109dfc6f16faaba290553d661f1
|
|
| MD5 |
5911b65360c22c20f7a2ddb04f5e12e6
|
|
| BLAKE2b-256 |
03bbb3d0558d3eb97bfda2fab5c2bab9e1fab622ba26ed81e334ad08e5b19689
|
File details
Details for the file caldav-3.3.0a1-py3-none-any.whl.
File metadata
- Download URL: caldav-3.3.0a1-py3-none-any.whl
- Upload date:
- Size: 256.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
12ec027aa1fe1069c88bf4d74c6f1acd34248a2aed9325fe98a3a1eaa8cd140a
|
|
| MD5 |
89dc4730d7090acc62ec51ce9a951572
|
|
| BLAKE2b-256 |
78fab8e287e80aec450c9b6c9fce64301b3645c5fecc85a6d78b7be7f9b6719b
|
