idZddlmZddlmZddlmZddlmZeGddZ dd Z d dZ d!dZ d"d#dZ d$dZd%dZdS)&z Principal operations - Sans-I/O business logic for Principal objects. This module contains pure functions for Principal operations like URL sanitization and vCalAddress creation. Both sync and async clients use these same functions. ) annotations) dataclass)Anyquotec<eZdZUdZded<ded<ded<ded<dS) PrincipalDataz Data extracted from a principal. str | Noneurl display_namecalendar_home_set_urlz list[str]calendar_user_addressesN)__name__ __module__ __qualname____doc____annotations__Z/root/projects/butler/venv/lib/python3.11/site-packages/caldav/operations/principal_ops.pyr r sE**OOO%%%%&&&&&&rr r r returncD|dSd|vrd|vrd|vrt|S|S)a] Sanitize calendar home set URL, handling server quirks. OwnCloud returns URLs like /remote.php/dav/calendars/tobixen@e.email/ where the @ should be quoted. Some servers return already-quoted URLs. Args: url: Calendar home set URL from server Returns: Sanitized URL with @ properly quoted (if not already) N@://z%40r)r s r_sanitize_calendar_home_set_urlrs> {t czze3&&5+;+;Szz Jr addresses list[Any]c&t|dS)a/ Sort calendar user addresses by preference. The 'preferred' attribute is possibly iCloud-specific but we honor it when present. Args: addresses: List of address elements (lxml elements with text and attributes) Returns: Sorted list (highest preference first) cJt|dd S)N preferredr)intget)xs rz/_sort_calendar_user_addresses..?sCk10E0E,F,F+Fr)key)sorted)rs r_sort_calendar_user_addressesr'2s )!F!F G G GGrlist[str | None]c8t|}d|DS)z Extract calendar user address strings from XML elements. Args: addresses: List of DAV:href elements Returns: List of address strings (sorted by preference) cg|] }|j Sr)text).0r#s r z4_extract_calendar_user_addresses..Ms - - -qAF - - -r)r')rsorted_addressess r _extract_calendar_user_addressesr/Bs'5Y?? - -, - - --rNr addressstrcalendar_user_typercddlm}m}||}|r|||jd<|r|||jd<|S)a> Create an icalendar vCalAddress object from principal properties. Args: display_name: The principal's display name (CN parameter) address: The primary calendar user address calendar_user_type: CalendarUserType (CUTYPE parameter) Returns: icalendar.vCalAddress object r) vCalAddressvTextcncutype) icalendarr4r5params)r r0r2r4r5 vcal_addrs r_create_vcal_addressr;Psp -,,,,,,, G$$I5!&|!4!4 ?%*U+=%>%> " rresultslist[Any] | Nonecr|sdS|D]/}|jd}|rt|cS0dS)aR Extract calendar-home-set URL from PROPFIND results. This pure function processes propfind results to find the calendar-home-set property, handling URL sanitization. Args: results: List of PropfindResult objects from parse_propfind_response Returns: Calendar home set URL, or None if not found Nz0{urn:ietf:params:xml:ns:caldav}calendar-home-set) propertiesr"r)r<resulthome_sets r'_extract_calendar_home_set_from_resultsrBks_ t==$(()[\\  =28<< < < < = 4rr client_hostnameboolc`|dSd|vr%ddlm}||}|jr |j|krdSdS)a Check if client base URL should be updated for load-balanced systems. iCloud and others use load-balanced systems where each principal resides on one named host. If the calendar home set URL has a different hostname, we may need to update the client's base URL. Args: calendar_home_set_url: The sanitized calendar home set URL client_hostname: The current client hostname Returns: True if client URL should be updated NFrr)urlparseT) urllib.parserFhostname)r rCrFparseds r_should_update_client_base_urlrJs_$$u %%%))))))/00 ? v/AA4 5r)r r rr )rrrr)rrrr()N)r r r0r1r2r rr)r<r=rr )r r rCr rrD)r __future__r dataclassesrtypingrrGrr rr'r/r;rBrJrrrrNs#"""""!!!!!! ''''''' '0 H H H H . . . ."&*64r