iJ3
$ d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddl
m Z m Z ddl
mZ dd lmZ d
d lmZmZmZmZ ej e Z d$d
ededefdZ d%d
ede dede e fdZ d%d
ede dede e fdZ d%d
ede dedefdZ d%d
ede dede e fdZ!de"de"fdZ#de de e e z fdZ$de de%e"e e e"dz f fd Z&d e e de'e"ef fd Z(d e defd Z)d!e"dz ddfd"Z*d!e"dz de fd#Z+dS )&z
Pure functions for parsing CalDAV XML responses.
All functions in this module are pure - they take XML bytes in and return
structured data out, with no side effects or I/O.
N)Any)unquote)etree)_Element)cdavdav)error)URL )CalendarQueryResultMultistatusResponsePropfindResultSyncCollectionResultFbody huge_treereturnc t j | }t j | | }g }d}t | }|D ]}|j t
j j k r|j }$|j t
j j k r?t | \ }} }
t | } |
rt |
nd} | t || | t || S )aX
Parse a 207 Multi-Status response body.
Args:
body: Raw XML response bytes
huge_tree: Allow parsing very large XML documents
Returns:
Structured MultistatusResponse with parsed results
Raises:
XMLSyntaxError: If body is not valid XML
ResponseError: If response indicates an error
r N )href
propertiesstatus) responses
sync_token)r XMLParser
fromstring_strip_to_multistatustagr SyncTokentextResponse_parse_response_element_extract_properties_status_to_codeappendr r
)
r r parsertreer r response_elementselemr propstatsr r status_codes
V/root/projects/butler/venv/lib/python3.11/site-packages/caldav/protocol/xml_parsers.py_parse_multistatusr- s $ _y
1
1
1F D& ) )D&(I !J .d33!
8s}( ( ( J 8s|' ' ' "9$"?"? i(33
17@of---S %"
z J J JJ r+ c |dk rg S |dvrt j d| | sg S t | | }|j S )a
Parse a PROPFIND response.
Args:
body: Raw XML response bytes
status_code: HTTP status code of the response
huge_tree: Allow parsing very large XML documents
Returns:
List of PropfindResult with properties for each resource
r r/ z PROPFIND failed with status r )r
ResponseErrorr- r )r r+ r results r, _parse_propfind_responser5 J sa c *$$!"N"N"NOOO
:
:
:F r. c |dvrt j d| | sg S t j | }t j | | }g }t | }|D ]}|j t j j k r t | \ }} }
|
rt |
nd} d} d}
| D ]q}| t j j }|)|D ]E}|j t j j k r|j } $|j t j j k r|j }
Fr| t% ||
| | |S )a
Parse a calendar-query REPORT response.
Args:
body: Raw XML response bytes
status_code: HTTP status code of the response
huge_tree: Allow parsing very large XML documents
Returns:
List of CalendarQueryResult with calendar data
r2 zREPORT failed with status r r Nr etag
calendar_datar )r r3 r r r r r r r! r" r$ findPropr CalendarDatar GetEtagr% r )r r+ r r& r' resultsr( r) r r* r status_code_elemr9 r8 propstatpropchilds r, _parse_calendar_query_responserC g s *$$!"L{"L"LMMM
_y
1
1
1F D& ) )D)+G-d33!
8s|' ' ' "9$"?"? i6<E?6222#$(
" & &H== ..D|
&
&9 1 555$)JMMY#+/11 :D
& +'
Nr. c B |dvrt j d| | st S t j | }t j | | }g }g }d}t
| }|D ] } | j t j j k r| j
}%| j t j j k r@t | \ }
} } | rt | nd}
|
dk r| |
d}d}| D ]q}| t j j }|)|D ]E}|j t" j j k r|j
}$|j t j j k r|j
}Fr| t) |
|||
"t ||| S ) a3
Parse a sync-collection REPORT response.
Args:
body: Raw XML response bytes
status_code: HTTP status code of the response
huge_tree: Allow parsing very large XML documents
Returns:
SyncCollectionResult with changed items, deleted hrefs, and new sync token
r2 z#sync-collection failed with status r Nr r1 r7 )changeddeletedr )r r3 r r r r r r r r r r! r" r$ r% r: r; r r< r= r )r r+ r r& r' rE rF r r( r) r r* r r? r9 r8 r@ rA rB s r, _parse_sync_collection_responserG s *$$!"U "U"UVVV &#%%%
_y
1
1
1F D& ) )D)+GG !J-d33! %
%
8s}( ( ( J 8s|' ' ' "9$"?"? i6<E?6222# s " " NN4 $(
! & &H== ..D|
&
&9 1 555$)JMMY#+/11 :D
& +'
r. c $ t | || S )ah
Parse a calendar-multiget REPORT response.
This is the same format as calendar-query, so we delegate to that parser.
Args:
body: Raw XML response bytes
status_code: HTTP status code of the response
huge_tree: Allow parsing very large XML documents
Returns:
List of CalendarQueryResult with calendar data
)rC )r r+ r s r, !_parse_calendar_multiget_responserI s $ *$ Y G GGr. r c d| v r| dd } t | }d|v r!t t | j }|S )u
Normalize an href string from a DAV response element.
Handles the Confluence double-encoding bug (%2540 → %40) and converts
absolute URLs to path-only strings so callers always work with paths.
z%2540z%40:)replacer r
path)r r s r, _normalize_hrefrN
sP $||GU++ 4==D d{{s4yy~&& Kr. r' c | j dk r;t | dk r(| d j t j j k r| d S | j t j j k r| S | gS )aN
Strip outer elements to get to the multistatus content.
The general format is:
...
...
But sometimes multistatus and/or xml element is missing.
Returns the element(s) containing responses.
xmlr )r lenr MultiStatus)r' s r, r r s[ x5SYY]]tAw{co>Q/Q/QAw x3?&&& 6Mr. responsec H d}d}g }| D ]}|j t j j k r|j }t | 3|j t j j k rt
|j pd }d|j t j j k r| | |pd||fS )z{
Parse a single DAV:response element.
Returns:
Tuple of (href, propstat elements list, status string)
N ) r r Statusr _validate_statusHrefrN PropStatr% )rS r r r* r) s r, r" r" 1 s FD "I # # 8sz~ % %YF V $ $ $ $
X
%
%"49?33DD
X )
)
) T " " " JB 6 **r. r* c H i }| D ]}| t j j }||j r
d|j v r9| t j j }|`|D ]9}|j }t
| dk r |j ||< 't | ||< :|S )z
Extract properties from propstat elements into a dict.
Args:
propstats: List of propstat elements
Returns:
Dict mapping property tag to value (text or element)
N 404 r )r: r rV r r r; rQ _element_to_value)r* r r@ status_elemrA rB r s r, r# r# J s "$J ; ; mmCJN33 "{'7 "+*** }}SX\** < ; ;E)C5zzQ"'*
3 #4E":":
3 ; r. r) c | t | dk r| j S | j }|t j j k r d | D S |t j j k r d | D S |t j j k r)d | D }t | dk r|d n|S |t j j k r d | D S |t j j k r1| D ],}|j t j
j k r|j r |j c S -dS g }| D ]}|j r| |j $| d r)| | d bt | dk r| |j t | dk r|d S |r|S | S ) z
Convert an XML element to a Python value.
For simple elements, returns text content.
For complex elements with children, returns dict or list.
Handles special CalDAV elements like supported-calendar-component-set.
r c b g | ],}| d | d -S )name)get.0rB s r,
z%_element_to_value.. s5 IIIeuyy7H7HI &!!IIIr. c ^ g | ]*}|j t j j k |j #|j +S r r rX r rb s r, rd z%_element_to_value.. s1 YYYu SX\0I0Iej0I
0I0I0Ir. c ^ g | ]*}|j t j j k |j #|j +S rf rg rb s r, rd z%_element_to_value.. s1 ZZZchl1J1Juz1J1J1J1Jr. r c g | ] }|j
S rf )r rb s r, rd z%_element_to_value.. s ,,,e ,,,r. Nr` )
rQ r r r SupportedCalendarComponentSetCalendarUserAddressSetCalendarHomeSetr ResourceTypeCurrentUserPrincipalrX r% ra )r) r hrefsrB children_textss r, r\ r\ p s 4yyA~~y (C d0444IItIIII d)---YYYYYY d"&&&ZZZZZ u::??uQxx5 c """,,t,,,, c&*** " "EyCHL((UZ( z!!!t N - - : - ! !%* - - - -
YYv
- ! !%))F"3"3 4 4 4 4
ZZ1__ ! !%) , , ,
>a a Kr. r c r dS d}t fd|D st j dS )z
Validate a status string like "HTTP/1.1 404 Not Found".
200, 201, 207, and 404 are considered acceptable statuses.
Args:
status: Status string from response
Raises:
ResponseError: If status indicates an error
N)z 200 z 201 z 207 r[ c 3 K | ]}|v V d S )Nrf )rc coder s r, z#_validate_status.. s' 55$tv~555555r. )anyr r3 )r
acceptables ` r, rW rW sT ~5J 5555*555 5 5 *!&)))* *r. c | sdS | }t | dk r& t |d S # t $ r Y nw xY wdS )z
Extract status code from status string like "HTTP/1.1 200 OK".
Args:
status: Status string
Returns:
Integer status code (defaults to 200 if parsing fails)
r r )splitrQ int
ValueError)r partss r, r$ r$ si s LLNNE
5zzQ uQx== D 3s A
AA)F)r/ F),__doc__loggingtypingr urllib.parser lxmlr
lxml.etreer caldav.elementsr r
caldav.libr caldav.lib.urlr
typesr r
r r getLogger__name__logbytesboolr- rz listr5 rC rG rI strrN r tupler" dictr# r\ rW r$ rf r. r, r s{ % % % % % % % % a a a a a a a a a a a ag!!
/K /K
/K/K /K /K /K /Kh
. > ; ;
;; ;
; ; ; ;@ J J
JJ J J J J J^ H H
HH H
H H H H0# # & XX-F (++
3Xd
*++ + + +2#4> #d38n # # # #L8H 8 8 8 8 8v*S4Z *D * * * *(C$J 3 r.