o .j@sZdZddlmZddlZddlmZmZddlmZddl m Z ddl m Z m Z m Z ddlmZdd lmZmZdd lmZdd lmZdd lmZmZdd lmZddlmZe r`ddlmZe dZ!ddiZ"d;dd+d,Z)   -   . -  .d?d@d7d8Z* -   . - dAdBd9d:Z+dS)Cz Base class for DAV clients. This module contains the BaseDAVClient class which provides shared functionality for both sync (DAVClient) and async (AsyncDAVClient) clients. ) annotationsN)ABCabstractmethod)Mapping)datetime) TYPE_CHECKINGAnyNoReturn)etreecdavdav) BaseElement)error)extract_auth_typesselect_auth_type) to_normal_str)URL) FeatureSetcaldav Content-Typeztext/calendar; charset="utf-8"namestrvalue Any | NonereturnBaseElement | Nonec Cstjtjtjtjtjtjtjd}tj tj tj tj tj tjtjtjtjd }|dr7d|vr7|ddd}|dd}||fD]*}||vrm||}z|durY||WS|WStyl|YSwqCdS) zQConvert a property name string (plain or Clark-notation) to a DAV element object.) displayname resourcetypegetetagzcurrent-user-principalownerz sync-tokenzsupported-report-set) z calendar-datazcalendar-home-setzcalendar-user-address-setzcalendar-user-typezcalendar-descriptionzcalendar-timezonez supported-calendar-component-setzschedule-inbox-urlzschedule-outbox-url{}_-N)r DisplayName ResourceTypeGetEtagCurrentUserPrincipalOwner SyncTokenSupportedReportSetr CalendarDataCalendarHomeSetCalendarUserAddressSetCalendarUserTypeCalendarDescriptionCalendarTimeZoneSupportedCalendarComponentSetScheduleInboxURLScheduleOutboxURL startswithsplitlowerreplace TypeError)rr dav_props caldav_props name_lower props_dictclsr@G/home/thesage/.local/lib/python3.10/site-packages/caldav/base_client.py_prop_name_to_element"s>   " rBc@seZdZUdZdgZgdZdZded<dZded<dZ ded <dZ ded <dZ d ed <dZ d ed<ddZ dlddZddZdmddZdndoddZdpd$d%Zdqd)d*Zdrd-d.Zdsd2d3Ze  4dtdud8d9ZedndvdReturns a calendar object. Typically, a URL should be given as a named parameter (url) No network traffic will be initiated by this method. If you don't know the URL of the calendar, use client.principal().calendar(...) instead, or client.principal().get_calendars() r)CalendarclientNr@)caldav.collectionrK)selfkwargsrKr@r@rAcalendarfs zBaseDAVClient.calendarrrcCs"|r|dst|j|S|S)zMake a URL absolute by joining with the client's base URL if needed. Args: url: URL string, possibly relative (e.g., "/calendars/user/") Returns: Absolute URL string. http)r6rrJjoin)rNrJr@r@rA_make_absolute_urlus z BaseDAVClient._make_absolute_urlcCs|SNr@)rNrr@r@rA_value_or_coroutinez!BaseDAVClient._value_or_coroutineheaderset[str]cCst|S)aExtract authentication types from WWW-Authenticate header. Parses the WWW-Authenticate header value and extracts the authentication scheme names (e.g., "basic", "digest", "bearer"). Args: header: WWW-Authenticate header value from server response. Returns: Set of lowercase auth type strings. Example: >>> client.extract_auth_types('Basic realm="test", Digest realm="test"') {'basic', 'digest'} )r)rNrWr@r@rArsz BaseDAVClient.extract_auth_types auth_typeslist[str] | NonecCs|j}|s |s td|r |r ||vr tjd|d|d|s@|r@t|t|jt|jd}|s@d|vr@|js@tjdd|S)a Select the best authentication type from available options. This method implements the shared logic for choosing an auth type based on configured credentials and server-supported types. Args: auth_types: List of acceptable auth types from server. Returns: Selected auth type string, or None if no suitable type found. Raises: AuthorizationError: If configuration conflicts with server capabilities. zlNo auth-type given. This shouldn't happen. Raise an issue at https://github.com/python-caldav/caldav/issues/zConfiguration specifies to use z, but server only accepts )reason) has_username has_passwordbearerzeServer provides bearer auth, but no password given. The bearer token should be configured as password)rHrAuthorizationErrorrboolrErF)rNrYrHr@r@rA_select_auth_types,zBaseDAVClient._select_auth_typemethodbodyheadersMapping[str, str] | Nonetuple[URL, dict]c Csv|pi}|j}|||dus|dkrd|vr|d=t|}td|dt|d|dt|||fS)zCombine headers, strip Content-Type for empty bodies, objectify URL, and log. Returns: (url_obj, combined_headers) ready to pass to the HTTP library. Nrzsending request - method=z, url=z , headers=z body: ) rdcopyupdater objectifylogdebugrr)rNrJrbrcrdcombined_headersurl_objr@r@rA_prepare_requests   zBaseDAVClient._prepare_request status_codeintr`cCs,|dkod|vo|j o|jduo|jduS)zReturn True when a 401 response warrants auth negotiation. True when: status is 401, WWW-Authenticate header present, no auth object yet, and credentials are configured. izWWW-AuthenticateN)rGrErF)rNrprdr@r@rA_should_negotiate_authsz$BaseDAVClient._should_negotiate_authwww_authenticateNonecCs&||}|||jstddS)zBuild auth object from a WWW-Authenticate header value. Raises: NotImplementedError: If the server offers no supported auth method. zhThe server does not provide any of the currently supported authentication methods: basic, digest, bearerN)rbuild_auth_objectrGNotImplementedError)rNrsrYr@r@rA_build_auth_from_401s  z"BaseDAVClient._build_auth_from_401url_str reason_sourcer cCs0z|j}Wn tyd}Ynwtj||d)zFRaise AuthorizationError, extracting reason from reason_source.reason.z None given)rJr[)r[AttributeErrorrr_)rNrxryr[r@r@rA_raise_authorization_errors   z(BaseDAVClient._raise_authorization_errorFpropsallpropbytescsf|r tt}n|r!fdd|D}tt|}ntt}tj|dddS)z Build PROPFIND request body XML.c g|] }t|durqSrTrB.0rer@rA  z6BaseDAVClient._build_propfind_body..utf-8Tencodingxml_declaration)r PropfindAllpropPropr tostring xmlelement)r|r}propfind prop_elementsr@rrA_build_propfind_bodysz"BaseDAVClient._build_propfind_body set_propsdict[str, Any] | NonecsRt}|rfdd|D}|r|tt|7}tj|dddS)z4Build PROPPATCH request body for setting properties.cs&g|]\}}t||durqSrTr)rrrrr@rArs z7BaseDAVClient._build_proppatch_body..rTr)r PropertyUpdateitemsSetrr rr)rpropertyupdate set_elementsr@rrA_build_proppatch_bodys z#BaseDAVClient._build_proppatch_bodystartdatetime | Noneendexpand comp_filtereventtodojournallist[BaseElement] | Nonefilterstuple[bytes, str | None]c Cst} |r|r |std| t||7} | g|rt|ng} t| } td} |p<|r3dn |r7dn|r;dnd} |rCt|ng}|sI|rR| t ||| rdt| }|r_||7}| |7} n|rj| |7} t | t | g}t j|ddd | fS) zmBuild calendar-query REPORT request body. Returns (XML bytes, component type name or None). z!can't expand without a date range VCALENDARVEVENTVTODOVJOURNALNrTr)r r-r ReportErrorExpandlistr r CompFilterappend TimeRange CalendarQueryFilterr rr)rrrrrrrr|rdata props_listprop vcalendar comp_type filter_listcomp_filter_elemrootr@r@rA_build_calendar_query_body$s2     z(BaseDAVClient._build_calendar_query_bodyThrefs list[str] include_datacCsXg}|r|tt|D] }|t|qt|}tj| dddS)z,Build calendar-multiget REPORT request body.rTr) rr rr r-HrefCalendarMultiGetr rr)rrelementshrefmultigetr@r@rA_build_calendar_multiget_bodySs z+BaseDAVClient._build_calendar_multiget_body1 sync_token sync_levelcstj|pddtj|dg}|r%fdd|D}|r$|t|n|tttgt|}t j | dddS)z*Build sync-collection REPORT request body.rgrcrrTrrrr@rArmrz=BaseDAVClient._build_sync_collection_body..rTr) r r+ SyncLevelrrr(r r-SyncCollectionr rr)rr|rrrsync_collectionr@rrA_build_sync_collection_bodyas  z)BaseDAVClient._build_sync_collection_bodyr descriptiontimezonesupported_componentscCst}|r |t|7}|r|t|7}|r|t|7}|r5t}|D] }|t|7}q'||7}|tt t g7}t t |}t j|dddS)zBuild MKCALENDAR request body.rTr)r rr&r r1r2r3Compr' CollectionrK Mkcalendarrr rr)rrrrrsccscomp mkcalendarr@r@rA_build_mkcalendar_bodyusz$BaseDAVClient._build_mkcalendar_bodyrcCsb|rtttggtj|dgng}t|tttg}t | S)z:Build the XML body for a principal-property-search REPORT.r) r PropertySearchrr&MatchPrincipalPropertySearchr r.r rr)r name_filterqueryr@r@rA_build_principal_search_querys,z+BaseDAVClient._build_principal_search_queryprincipal_dictdictrc Csddlm}m}ddlm}m}g}|D]x}||}|jj|vr!q||jjj} t ||jj t ||jj ||j j} t | t | j | } t t| dkt | d t | d | dj} ||| d} ||||| | dq|S)zFParse principal-property-search REPORT results into Principal objects.r) CalendarSet Principalr r#)rLrJ)rLrJrcalendar_home_set)rMrrcaldav.elementsr r r&tagtextrassert_ getchildrenrr.lenr)rNrrrr r retxprchschs_hrefchs_urlrr@r@rA _parse_principal_search_responses.    z.BaseDAVClient._parse_principal_search_responserPcCs|j|d||dS)zGet events from a calendar, optionally filtered by date range. For sync clients returns a list directly. For async clients returns a coroutine that must be awaited. T)rrrsearch_calendar)rNrPrrr@r@rA get_eventsszBaseDAVClient.get_eventsinclude_completedcCs|j|d|dS)zGet todos from a calendar. For sync clients returns a list directly. For async clients returns a coroutine that must be awaited. T)rrr)rNrPrr@r@rA get_todosszBaseDAVClient.get_todoscCsdS)a5 Build authentication object based on configured credentials. This method must be implemented by subclasses to create the appropriate auth object for their HTTP library (requests, httpx, etc.). Args: auth_types: List of acceptable auth types from server. Nr@)rNrYr@r@rArus zBaseDAVClient.build_auth_object)rJrrr)rWrrrXrT)rYrZrrD) rJrrbrrcrrdrerrf)rprqrdrrr`)rsrrrt)rxrryrrr NF)r|rZr}r`rr~)rrrr~) NNFNFFFNN)rrrrrr`rrDrr`rr`rr`r|rrrrr)T)rrrr`rr~)NNr)rrDr|rZrrrr~)NNNN) rrDrrDrrDrrZrr~)rrDrr~)rrrrNN)rPrrrrrrr)F)rPrrr`rr)rYrZrrt)#__name__ __module__ __qualname____doc__CALENDAR_HOME_SET_PROPSCALENDAR_LIST_PROPSrE__annotations__rFrGrHrIrJrPrSrUrrarorrrwr{ staticmethodrrrrrrrrrrrrur@r@r@rArCFsr          /     .     rCcs^eZdZdZ   ddfdd Zed d Zd d ZddZddZ ddZ ddZ Z S)CalendarCollectiona A list of calendars that can be used as a context manager. This class extends list to provide automatic cleanup of the underlying DAV client connection when used with a `with` statement. Example:: from caldav import get_calendars # As context manager (recommended) - auto-closes connection with get_calendars(url="...", username="...", password="...") as calendars: for cal in calendars: print(cal.get_display_name()) # Without context manager - must close manually calendars = get_calendars(url="...", username="...", password="...") # ... use calendars ... if calendars: calendars[0].client.close() N calendars list | NonerLrclientscsDt|pg|durt||_dS|dur|g|_dSg|_dSrT)super__init__r_clients)rNrrLr __class__r@rArs   zCalendarCollection.__init__cCs"|jr|jdS|r|djSdS)z(The underlying DAV client, if available.rN)rrLrNr@r@rArLs   zCalendarCollection.clientcCs|SrTr@rr@r@rA __enter__rVzCalendarCollection.__enter__cCs\t}|jD]}t||vr|||||t|q|js,|r,|dj|||dS)NrF)setrid__exit__addrLrNexc_typeexc_valexc_tbseencr@r@rAr s   zCalendarCollection.__exit__cs|SrTr@rr@r@rA __aenter__szCalendarCollection.__aenter__cst}|jD]&}t||vr-t|dr||||IdHn|||||t|q|jsP|rP|dj}t|drI||||IdHdS||||dS)N __aexit__rF)rrr hasattrrr r rLr r@r@rArs       zCalendarCollection.__aexit__cCsXt}|jD]}t||vr||t|q|js(|r*|djdSdSdS)z,Close all underlying DAV client connections.rN)rrr closer rL)rNrrr@r@rAr%s   zCalendarCollection.close)NNN)rrrLrrr) rrrrrpropertyrLrr rrr __classcell__r@r@rrArs   rc@sleZdZdZddddZedd Zed d Zd d ZddZ ddZ ddZ ddZ ddZ ddZdS)CalendarResulta A single calendar result that can be used as a context manager. This wrapper holds a single Calendar (or None) and provides automatic cleanup of the underlying DAV client connection when used with a `with` statement. Example:: from caldav import get_calendar # As context manager (recommended) - auto-closes connection with get_calendar(calendar_name="Work", url="...") as calendar: if calendar: events = calendar.date_search(start=..., end=...) # Without context manager result = get_calendar(calendar_name="Work", url="...") calendar = result.calendar # or just use result directly # ... use calendar ... result.close() NrPrrLcCs||_||_dSrT) _calendar_client)rNrPrLr@r@rArHs zCalendarResult.__init__cC|jS)z#The calendar, or None if not found.rrr@r@rArPLszCalendarResult.calendarcCs|jr|jS|jr |jjSdS)zThe underlying DAV client.N)rrrLrr@r@rArLQs zCalendarResult.clientcCrrTrrr@r@rArZszCalendarResult.__enter__cCs|j}|r ||||dSr)rLr rNr rrrLr@r@rAr ]szCalendarResult.__exit__cs|jSrTrrr@r@rArcszCalendarResult.__aenter__cs@|j}|rt|dr||||IdHdS||||dS)NrF)rLrrr rr@r@rArfs zCalendarResult.__aexit__cCs|j}|r |dSdS)z+Close the underlying DAV client connection.N)rLr)rNrLr@r@rAros zCalendarResult.closecCs |jduSrTrrr@r@rA__bool__vs zCalendarResult.__bool__cCs&|jdur td|dt|j|S)Nz"No calendar found, cannot access '')rrzgetattr)rNrr@r@rA __getattr__ys  zCalendarResult.__getattr__r)rPrrLr)rrrrrrrPrLrr rrrrr!r@r@r@rAr0s     robjrrcCs$|sgSt|ttBr|gSt|S)z8Convert a string or None to a list for uniform handling.) isinstancerr~r)r"r@r@rA_normalize_to_lists r$rL calendar_url calendar_name raise_errorsr`csddl}|dfdd}||jid}|sgSg}t|}t|} |D]$} dt| vr6|j| d} n|j| d } || jid | rK|| q'| D]} ||jd | id | d } | rd|| qN|sv|sv| sv||jid} | rv| }|S)z Fetch calendars from a single connected client, optionally filtered. Returns a (possibly empty) list of Calendar objects. On error the behaviour is controlled by ``raise_errors``. rNrc snz|di|}|durtd||WSty6}zd|d|r+WYd}~dSd}~ww)NzMethod returned None: z(Problems fetching calendar information: z - r@) ValueError Exceptionr)methrOerrmsgrrrkr'r@rA_trysz)_fetch_calendars_for_client.._tryzgetting principal/)cal_url)cal_idz calendar rzcalendar by name 'rzgetting all calendars) logging getLogger principalr$rrPget_display_namer get_calendars)rLr%r&r'r1r-r3r calendar_urlscalendar_namesr/rPcal_nameall_calsr@r,rA_fetch_calendars_for_clients<        r:TF client_classtypecheck_config_file config_filerDconfig_section testconfig environmentc  slddlm} td|d|||||d| } | dur&t| ||| } t| | dS|s1| r.tdtS|}|rA|sAddl}|jd}|}|rQ|sQddl}|jd }| ||}|sb| r_tdtSdd l m g}g}|D]A}| d d}| d d}|dur|n|}|dur|n|}fd d| D}|di|}t|||| }||||qnt||dS)u Get calendars from one or more CalDAV servers. Configuration is read from multiple sources in priority order: 1. Explicit keyword arguments (``url``, ``username``, ``password``, …) 2. Test server (``testconfig=True`` or ``PYTHON_CALDAV_USE_TEST_SERVER``) 3. Environment variables (``CALDAV_URL``, …) 4. Config file — supports meta-sections so a single ``config_section`` can expand to multiple servers (see below) **Multi-server / meta-sections** Sources 1–3 always produce a single connection. When the config file is used (source 4) the ``config_section`` value is passed through ``expand_config_section``, which supports: * ``"*"`` – every non-disabled section in the file * ``"all"`` – a meta-section defined as ``{"contains": ["work", "personal"]}`` * Glob patterns such as ``"work_*"`` * A plain section name (normal single-server behaviour) Each expanded leaf section can carry its own ``calendar_name`` or ``calendar_url`` to filter which calendars are returned for that server. Function-level ``calendar_name`` / ``calendar_url`` arguments override per-section values when provided. The returned :class:`CalendarCollection` is a list that can be used as a context manager; on exit **all** underlying connections are closed. Args: client_class: The client class to use (``DAVClient`` or ``AsyncDAVClient``). calendar_url: URL(s) or ID(s) of specific calendars to fetch. calendar_name: Name(s) of specific calendars to fetch by display name. check_config_file: Whether to look for config files (default: True). config_file: Explicit path to config file. config_section: Section name in config file (default: ``"default"``). Supports ``*``, meta-sections, and glob patterns. testconfig: Whether to use test server configuration. environment: Whether to read from environment variables (default: True). name: Name of test server to use (for testconfig). raise_errors: If True, raise exceptions on errors; if False, log and skip. **config_data: Explicit connection parameters (url, username, password, …). Returns: :class:`CalendarCollection` of matching calendars (may be empty). Example — single server:: from caldav import get_calendars with get_calendars(url="https://...", username="...", password="...") as cals: for cal in cals: print(cal.get_display_name()) Example — all sections in config file:: with get_calendars(config_section="*") as cals: for cal in cals: print(cal.get_display_name()) rconfigF)r;r=r>r?r@rArN)rLz4Could not create DAV client - no configuration foundCALDAV_CONFIG_FILECALDAV_CONFIG_SECTIONCONNKEYSr%r&csi|] \}}|vr||qSr@r@)rkvrFr@rA Isz!get_calendars..)rr@)rrC get_davclientr:rr(osenvirongetget_all_file_connection_params caldav.configrGpoprextendr)r;r%r&r=r>r?r@rArr' config_data_configrLrresolved_config_filerLresolved_section all_params all_calendars all_clientsparams sec_cal_url sec_cal_name eff_cal_url eff_cal_name conn_paramsr section_calsr@rFrAr5s\ J           r5c Ksddlm}|jd ||||||d|} | durdS| dd} | dd} | dd} | dd|d i| } | durA| | _| durH| | _| durO| | _| S) aS Get a DAV client instance with configuration from multiple sources. This is the canonical implementation used by both sync and async clients. Configuration is read from various sources in priority order: 1. Explicit parameters (url=, username=, password=, etc.) 2. Test server config (if testconfig=True or PYTHON_CALDAV_USE_TEST_SERVER env var) 3. Environment variables (CALDAV_URL, CALDAV_USERNAME, CALDAV_PASSWORD) 4. Config file (CALDAV_CONFIG_FILE env var or ~/.config/caldav/) Args: client_class: The client class to instantiate (DAVClient or AsyncDAVClient). check_config_file: Whether to look for config files (default: True). config_file: Explicit path to config file. config_section: Section name in config file (default: "default"). testconfig: Whether to use test server configuration. environment: Whether to read from environment variables (default: True). name: Name of test server to use (for testconfig). **config_data: Explicit connection parameters passed to client constructor. Common parameters include: - url: CalDAV server URL, domain, or email address - username: Username for authentication - password: Password for authentication - ssl_verify_cert: Whether to verify SSL certificates - auth_type: Authentication type ("basic", "digest", "bearer") Returns: Client instance, or None if no configuration is found. Example (sync):: from caldav import get_davclient client = get_davclient(url="https://caldav.example.com", username="user", password="pass") Example (async):: from caldav.async_davclient import get_davclient client = await get_davclient(url="https://caldav.example.com", username="user", password="pass") rrB)r=r>r?r@rArN_setup _teardown _server_nameprotocolr@)rrCget_connection_paramsrQsetupteardown server_name)r;r=r>r?r@rArrSrCr_ setup_func teardown_funcrhrLr@r@rArKRs2 2     rKrT)rrrrrr)r"rrr) rLrr%rr&rr'r`rr) NNTNNFTNF)r;r<r%rr&rr=r`r>rDr?rDr@r`rAr`rrDr'r`rr)TNNFTN)r;r<r=r`r>rDr?rDr@r`rAr`rrDrr),r __future__rr1abcrrcollections.abcrrtypingrrr lxmlr rr r caldav.elements.baser caldav.librcaldav.lib.authrrcaldav.lib.python_utilitiesrcaldav.lib.urlrcaldav.compatibility_hintsrr2rkICALHrBrCrrrr$r:r5rKr@r@r@rAsZ           $[ O ?