idZddlmZddlmZmZddlmZddlm Z edGdd Z eGd d Z dddZ d dZ d!dZd!dZ dd"dZd S)#a Base utilities for the operations layer. This module provides foundational types and utilities used by all operations modules. The operations layer contains pure functions (Sans-I/O) that handle business logic without performing any network I/O. Design principles: - All functions are pure: same inputs always produce same outputs - No network I/O - that's the client's responsibility - Request specs describe WHAT to request, not HOW - Response processors transform parsed data into domain-friendly formats ) annotations) dataclassfield)Any)URLT)frozenc^eZdZUdZded<dZded<dZded<d Zd ed <d Zd ed<ddZ d S) QuerySpeca Base specification for a DAV query. This is an immutable description of what to request from the server. The client uses this to construct and execute the actual HTTP request. Attributes: url: The URL to query method: HTTP method (PROPFIND, REPORT, etc.) depth: DAV depth header (0, 1, or infinity) props: Properties to request body: Optional pre-built XML body (if complex) strurlPROPFINDmethodrintdepthztuple[str, ...]propsNz bytes | Nonebodynew_urlreturncRt||j|j|j|jS)z#Return a copy with a different URL.)r rrrr)r rrrr)selfrs Q/root/projects/butler/venv/lib/python3.11/site-packages/caldav/operations/base.pywith_urlzQuerySpec.with_url-s0;**     )rr rr ) __name__ __module__ __qualname____doc____annotations__rrrrrrrrr r s   HHHFENNNNED      rr cNeZdZUdZded<eeZded<dZded <d S) PropertyDataz Generic property data extracted from a DAV response. Used when we need to pass around arbitrary properties without knowing their specific structure. r href)default_factorydict[str, Any] propertiesrstatusN) rrrrrrdictr%r'rrrr!r!8sVIII!&t! value Returns: List of resource type tags (e.g., ['{DAV:}collection', '{urn:ietf:params:xml:ns:caldav}calendar']) z{DAV:}resourcetype)get isinstancelist)r%resource_type_keyrts r_extract_resource_typer<fsR- )2 . .B"d"  !ttr!rboolc,t|}d}||vS)z Check if properties indicate a calendar resource. Args: properties: Dict of property tag -> value Returns: True if this is a calendar collection z'{urn:ietf:params:xml:ns:caldav}calendarr<)r%resource_types calendar_tags r_is_calendar_resourcerB|s!,J77N ))rc,t|}d}||vS)z Check if properties indicate a collection resource. Args: properties: Dict of property tag -> value Returns: True if this is a collection z{DAV:}collectionr?)r%r@collection_tags r_is_collection_resourcerEs!,J77N'N ^ ++r prop_namedefaultrcX||vr||Sgd}|D]}||}||vr ||cS|S)az Get a property value, handling both namespaced and simple keys. Tries the full namespaced key first, then common namespace prefixes. Args: properties: Dict of property tag -> value prop_name: Property name (e.g., 'displayname' or '{DAV:}displayname') default: Default value if not found Returns: Property value or default )z{DAV:}z{urn:ietf:params:xml:ns:caldav}z{http://calendarserver.org/ns/}z{http://apple.com/ns/ical/}r)r%rFrG namespacesnsfull_keys r_get_property_valuerLst&J)$$J((%)%% z ! !h' ' ' ' " Nr)N)r"r r)r*rr )r%r$rr5)r%r$rr=)r%r$rFr rGrrr)r __future__r dataclassesrrtypingrcaldav.lib.urlrr r!r4r<rBrErLrrrrQsT  #"""""(((((((( $        @          @"""", * * * * , , , ,$#######r