OwlCyberSecurity - MANAGER
Edit File: carddavxml.pyc
� �t�ac @ s� d Z d d l m Z m Z d d l m Z m Z d d l m Z m Z d d l m Z m Z d d l m Z d d l m Z d Z dB Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ e d e f d � � Y� Z e d e f d � � Y� Z e d e f d � � Y� Z e d e f d � � Y� Z e d e f d � � Y� Z e d e f d � � Y� Z e d e f d � � Y� Z e d e e f d! � � Y� Z e d" e f d# � � Y� Z e d$ e f d% � � Y� Z e d& e f d' � � Y� Z e d( e f d) � � Y� Z e d* e f d+ � � Y� Z! e d, e f d- � � Y� Z" e d. e f d/ � � Y� Z# e d0 e f d1 � � Y� Z$ e d2 e f d3 � � Y� Z% e d4 e f d5 � � Y� Z& e d6 e f d7 � � Y� Z' e d8 e f d9 � � Y� Z( e d: e f d; � � Y� Z) e d< e f d= � � Y� Z* e d> e f d? � � Y� Z+ d@ � Z, e, e _- e e � e � � e _. e e � e � e* � � e _/ dA S(C s� CardDAV XML Support. This module provides XML utilities for use with CardDAV. This API is considered private to static.py and is therefore subject to change. See draft spec: i����( t registerElementt dav_namespace( t WebDAVElementt PCDATAElement( t WebDAVEmptyElementt WebDAVTextElement( t ResourceTypet Collection( t config( t Components urn:ietf:params:xml:ns:carddavt addressbookt CardDAVElementc B s e Z d Z e Z RS( s CardDAV XML element. ( t __name__t __module__t __doc__t carddav_namespacet namespace( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR / s t CardDAVEmptyElementc B s e Z d Z e Z RS( s+ CardDAV element with no contents. ( R R R R R ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR 6 s t CardDAVTextElementc B s e Z d Z e Z RS( s, CardDAV element containing PCDATA. ( R R R R R ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR = s t CardDAVDataMixinc B s\ e Z d Z d � Z d � Z e d d � � Z e Z e Z d � Z e Z d � Z e Z RS( sF A mixin to support accept/returning data in various formats. c O sg d | k r | d | _ n d | _ d | k rA | d | _ n d | _ t t | � j | | � d S( Ns content-types text/vcardt versions 3.0( t content_typeR t superR t __init__( t selft childrent attributes( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR I s c C sl t � } | j d � t j r/ | j d � n x6 | D]. \ } } | | j k r6 | | j k r6 t Sq6 Wt S( s� Make sure any content-type and version matches at least one supported set. @return: C{True} if there is at least one match, C{False} otherwise. s text/vcards 3.0s application/vcard+json( s text/vcards 3.0( s application/vcard+jsons 3.0( t sett addR t EnableJSONDataR R t Truet False( R t allowedTypest formatR ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyt verifyTypeVersionW s c C s� i } | d k r+ | d k r+ | | d <n t | t � rb | sO t d � � n | t | � | � St | t � r� | j � d k s� t d | f � � | t | j | � � | � St d | f � � d S( Ns text/vcards content-types Missing address datat VCARDs Not a vCard: %rs Not an address: %s( t Nonet isinstancet strt ValueErrorR R t namet AssertionErrort getText( t clazzt addressR! t attrs( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyt fromAddressg s % c C s0 | j � } | r( t j | d | j �Sd Sd S( sI Returns an address component derived from this element. R! N( t addressDataR t fromStringR R$ ( R t data( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR, z s c C s2 x% | j D] } t | t � s# d SPq Wt | � S( sE Returns the address data derived from this element. N( R R% R R$ R& ( R R1 ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR/ � s N( R R R R R" t classmethodR$ R. t fromTextDatat fromComponentR, t generateComponentR/ t textData( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR D s t AddressBookHomeSetc B s- e Z d Z d Z e Z i d e d f 6Z RS( se The address book collections URLs for this principal. (CardDAV, RFC 6352 section 7.1.1) s addressbook-home-seti t hrefN( i N( R R R R( R t hiddenR$ R t allowed_children( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR7 � s t AddressBookDescriptionc B s e Z d Z d Z e Z RS( s� Provides a human-readable description of what this address book collection represents. (CardDAV, RFC 6352 section 6.2.1) s addressbook-description( R R R R( R R9 ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR; � s t SupportedAddressDatac B s3 e Z d Z d Z e Z e Z i d e d f 6Z RS( se Specifies restrictions on an address book collection. (CardDAV, RFC 6352 section 6.2.2) s supported-address-datai s address-data-typeN( i N( R R R R( R R9 t protectedR$ R R: ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR< � s t MaxResourceSizec B s e Z d Z d Z e Z e Z RS( se Specifies restrictions on an address book collection. (CardDAV, RFC 6352 section 6.2.3) s max-resource-size( R R R R( R R9 R= ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR> � s t AddressBookc B s e Z d Z d Z RS( sX Denotes an address book collection. (CardDAV, RFC 6352 sections 5.2, 10.1) R ( R R R R( ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR? � s t AddressBookQueryc B sd e Z d Z d Z i d e d f 6d e d f 6d e d f 6d e d f 6d e d f 6Z d � Z RS( s_ Defines a report for querying address book data. (CardDAV, RFC 6352 section 10.3) s addressbook-queryi t allpropt propnamet propi t filtert limitc O s7 t t | � j | | � d } d } d } x� | j D]� } | j � } | t d f t d f t d f f k r� | d k r� t d � � n | } q5 | t d f k r� | } q5 | t d f k r� | j t � | } q5 t d � � q5 Wt | j � d k r| d k rt d � � qn | | _ | | _ | | _ d S( NRA RB RC sC Only one of CardDAV:allprop, CardDAV:propname, CardDAV:prop allowedRD RE s We shouldn't be herei s CARDDAV:filter required( R R@ R R$ R t qnameR R' R t childOfTypet NResultsR) t lent propsRD RE ( R R R RJ RD RE t childRF ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR � s2 N( i N( i N( i N( i i ( i N( R R R R( R$ R R R: R ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR@ � s t AddressDataTypec B s( e Z d Z d Z i e d 6e d 6Z RS( s� Defines which parts of a address component object should be returned by a report. (CardDAV, RFC 6352 section 6.2.2) s address-data-types content-typeR ( R R R R( R t allowed_attributes( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRL s t AddressDatac B sX e Z d Z d Z i d e d f 6d e d f 6d e 6Z i e d 6e d 6Z d � Z RS( s� Defines which parts of a address component object should be returned by a report. (CardDAV, RFC 6352 section 10.4) s address-datai i RA RC s content-typeR c O s� t t | � j | | � d } d } x� | j D]� } | j � } | t d f k rw | d k rn t d � � n | } q/ | t d f k r� y | j | � Wqt k r� | d k r� | g } q� t d � � qXq/ t | t � r| d k r� | } q| | 7} q/ t d � � q/ W| | _ | d k r�y/ | d k rYt d | t | � f � � n Wn# t k r| j � s�� q�q�X| f | _ n d S( NRA s4 CardDAV:allprop and CardDAV:prop may not be combinedRC s We shouldn't be heres5 Only one of allprop, prop (%r) or PCDATA (%r) allowed( R RN R R$ R RF R R' t appendt AttributeErrorR% R R) t propertiesR& t isWhitespace( R R R RQ R1 RK RF ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR ' s> # ( i i N( i N( i N( R R R R( R R$ R R: R RM R ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRN s t AllPropertiesc B s e Z d Z d Z RS( sa Specifies that all properties shall be returned. (CardDAV, RFC 6352 section 10.4.1) RA ( R R R R( ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRS X s t Propertyc B s1 e Z d Z d Z i e d 6e d 6Z d � Z RS( s\ Defines a property to return in a response. (CardDAV, RFC 6352 section 10.4.2) RC R( t novaluec O s� t t | � j | | � | d | _ d | k r� | d } | d k rT t | _ q� | d k rl t | _ q� t d | f � � n t | _ d S( NR( RU t yest nos Invalid novalue: %r( R RT R t property_nameR RU R R' ( R R R RU ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR n s ( R R R R( R R RM R ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRT a s t Filterc B s4 e Z d Z d Z i d e d f 6Z i e d 6Z RS( sa Determines which matching components are returned. (CardDAV, RFC 6352 section 10.5) RD i s prop-filtert testN( i N( R R R R( R$ R R: R RM ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRY s t PropertyFilterc B sU e Z d Z d Z i d e d f 6d e d f 6d e d f 6Z i e d 6e d 6Z RS( sb Limits a search to specific properties. (CardDAV-access-09, RFC 6352 section 10.5.1) s prop-filteri i s is-not-defineds text-matchs param-filterR( RZ ( i i N( i N( i N( R R R R( R R$ R: R R RM ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR[ � s t ParameterFilterc B sA e Z d Z d Z i d e d f 6d e d f 6Z i e d 6Z RS( sX Limits a search to specific parameters. (CardDAV, RFC 6352 section 10.5.2) s param-filteri i s is-not-defineds text-matchR( ( i i ( i i ( R R R R( R R: R RM ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR\ � s t Limitc B s- e Z d Z e Z d Z i d e d f 6Z RS( s, Client supplied limit for reports. RE i t nresults( i i ( R R R R R R( R: ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR] � s RH c B s e Z d Z e Z d Z RS( s" Number of results limit. R^ ( R R R R R R( ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRH � s t IsNotDefinedc B s e Z d Z d Z RS( sd Specifies that the named vCard item does not exist. (CardDAV, RFC 6352 section 10.5.3) s is-not-defined( R R R R( ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR_ � s t TextMatchc B sD e Z d Z d Z d � Z e e � Z i e d 6e d 6e d 6Z RS( sn Specifies a substring match on a property or parameter value. (CardDAV, RFC 6352 section 10.5.4) s text-matchc C sg t | � t k r" | t | � � St | � t k rM | t | j d � � � S| t t | � � � Sd S( Ns utf-8( t typeR& R t unicodet encode( R+ t string( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR0 � s t collations negate-conditions match-type( R R R R( R0 R2 R RM ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR` � s t AddressBookMultiGetc B sW e Z d Z d Z i d e d f 6d e d f 6d e d f 6d e d f 6Z d � Z RS( ss CardDAV report used to retrieve specific vCard items via their URIs. (CardDAV, RFC 6352 section 10.7) s addressbook-multigeti i RA RB RC R8 c O s� t t | � j | | � d } g } x� | j D] } | j � } | t d f t d f t d f f k r� | d k r� t d � � n | } q/ | t d f k r/ | j | � q/ q/ W| | _ | | _ d S( NRA RB RC s7 Only one of DAV:allprop, DAV:propname, DAV:prop allowedR8 ( R Rf R R$ R RF R R' RO t propertyt resources( R R R Rg Rh RK RF ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyR � s ( i i ( i i ( i i N( i N( R R R R( R R$ R: R ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRf � s t NoUIDConflictc B s' e Z d Z d Z i d e d f 6Z RS( s� CardDAV precondition used to indicate a UID conflict during PUT/COPY/MOVE. The conflicting resource href must be returned as a child. s no-uid-conflicti R8 ( i i ( R R R R( R R: ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRi s t SupportedFilterc B s4 e Z d Z d Z i d e d f 6d e d f 6Z RS( s� CardDAV precondition used to indicate an unsupported component type in a query filter. The conflicting filter elements are returned. s supported-filteri s prop-filters param-filterN( i N( i N( R R R R( R$ R R: ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRj s t DirectoryGatewayc B s3 e Z d Z d Z e Z e Z i d e d f 6Z RS( s^ CardDAV property on a principal to indicate where the directory gateway resource is. s directory-gatewayi R8 N( i N( R R R R( R R9 R= R$ R R: ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRk ( s t Directoryc B s e Z d Z d Z RS( sV CardDAV property on a principal to indicate where the directory resource is. t directory( R R R R( ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRl 4 s t DefaultAddressBookURLc B s' e Z d Z d Z i d e d f 6Z RS( sD A single href indicating which addressbook is the default. s default-addressbook-URLi i R8 ( i i ( R R R R( R R: ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyRn < s c C s t | j t � � S( N( t boolt childrenOfTypeR? ( R ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyt _isAddressBookJ s N( R (0 R t txdav.xml.elementR R R R R R R R t twistedcaldav.configR t twistedcaldav.vcardR R t carddav_complianceR R R t objectR R7 R; R< R> R? R@ RL RN RS RT RY R[ R\ R] RH R_ R` Rf Ri Rj Rk Rl Rn Rq t isAddressBookR Rm ( ( ( s+ /opt/cpanel-ccs/twistedcaldav/carddavxml.pyt <module> s| R 5C )