ADR: HTTPX Async-First Architecture with Thin Sync Wrappers

caldav/__init__.py

@@ -10,7 +10,9 @@
     warnings.warn(
         "You need to install the `build` package and do a `python -m build` to get caldav.__version__ set correctly"
     )
-from .davclient import DAVClient
+
+# Import from the new async-first implementation with sync wrappers
+from ._sync.davclient import DAVClient
 from .search import CalDAVSearcher
 
 ## TODO: this should go away in some future version of the library.

caldav/_async/__init__.py

@@ -0,0 +1,9 @@
+"""
+Async CalDAV client implementation using httpx.
+
+This module contains the primary async implementation of the caldav library.
+The sync API in caldav._sync wraps these async implementations.
+"""
+from .davclient import AsyncDAVClient
+
+__all__ = ["AsyncDAVClient"]