OwlCyberSecurity - MANAGER
Edit File: ical.pyc
� �t�ac @ sa d Z d d d d d d g Z d d l Z d d l Z d d l m Z d d l Z d d l Z d d l Z d d l m Z m Z d d l m Z d d l m Z d d l m Z d d l m Z m Z d d l m Z d d l m Z m Z m Z m Z d d l m Z m Z d d l m Z d d l! m" Z" d d l# m$ Z$ d d l% m& Z& d d l' m( Z( d d l) m* Z+ d d l, m- Z- d d l. m/ Z/ d d l0 m1 Z1 d d l2 m3 Z3 d d l4 m5 Z5 d d l6 m7 Z8 d d l9 m: Z: d d l; m< Z< e � Z= d Z> d! d" d# f a? t? d$ f a@ t@ d% f aA d& � ZB d' ZC d( ZD d) ZE d* ZF d+ ZG d, ZH d- ZI i0 d. i d/ d0 6f d1 6eJ i d/ d0 6f d2 6eJ i d/ d0 6f d3 6eJ i d/ d0 6f d4 6eJ i d5 d0 6f d6 6eJ i d/ d0 6f d7 6eJ i d/ d0 6f d8 6eJ i d/ d0 6f d9 6eJ i d/ d0 6f d: 6eJ i d; d0 6f d< 6eJ i d/ d0 6f d= 6eJ i d> d0 6f d? 6d@ i d> d0 6f dA 6eJ i d/ d0 6f dB 6eJ i d/ d0 6f dC 6eJ i d/ d0 6f dD 6eJ i dE d0 6f dF 6eJ i dE d0 6f dG 6eJ i dE d0 6f dH 6eJ i dE d0 6f dI 6eJ i dJ d0 6f dJ 6eJ i dK d0 6f dL 6dM i d/ d0 6f dN 6eJ i d/ d0 6f dO 6eJ i d/ d0 6f dP 6eJ i dQ d0 6f dR 6eJ i dQ d0 6f dS 6eJ i d5 d0 6f dT 6eJ i dU d0 6dV dW 6dX dY 6dZ d[ 6d\ d] 6d^ d_ 6f d` 6eJ i d/ d0 6f da 6eJ i dU d0 6f db 6eJ i dE d0 6f dc 6eJ i d/ d0 6f dd 6eJ i d5 d0 6f de 6eJ i d/ d0 6f df 6eJ i dE d0 6f dg 6eJ i dh d0 6f di 6eJ i dE d0 6f dj 6eJ i dh d0 6f dk 6eJ i d/ d0 6f dl 6d@ i d> d0 6f dm 6eJ i dJ d0 6f dn 6eJ i dE d0 6f do 6eJ i dE d0 6f dp 6eJ i dE d0 6f dq 6d@ i d> d0 6f dr 6eJ i d/ d0 6f ds 6eJ i dU d0 6dV dW 6dX dY 6d\ d] 6d^ d_ 6f dt 6ZK i e" d` 6e" db 6e" dt 6ZL d% eC f ZM e/ du dv dv d@ d@ d@ dw e: jN �ZO e/ dx dv dv d@ d@ d@ dw e: jN �ZP d eQ f dy � � YZR d eS f dz � � YZ7 d eS f d{ � � YZ* d| � ZT eU d} � ZV e eW eU d~ � � ZX d � ZY d� d� f d� � ZZ d� � Z[ d S(� s iCalendar Utilities t InvalidICalendarDataErrort iCalendarProductIDt allowedComponentst Propertyt Componentt tzexpandi����N( t unified_diff( t inlineCallbackst returnValue( t Logger( t IStream( t allDataFromStream( t accountingEnabledForCategoryt emitAccounting( t config( t timeRangesOverlapt normalizeForIndext differenceDateTimet normalizeForExpand( t InstanceListt InvalidOverriddenInstanceError( t hasTZ( t normalizeCUAddr( t definitions( t Parameter( t Calendar( R ( t ComponentBase( t DateTime( t Duration( t ErrorBase( t Period( R ( t Timezone( t UTCOffsetValues, -//CALENDARSERVER.ORG//NONSGML Version 1//ENt VEVENTt VTODOt VPOLLt VFREEBUSYt VTIMEZONEc C s | a t d a t d a d S( NR$ R% ( R$ ( R% ( t allowedStoreComponentst allowedSchedulingComponentsR ( t allowed( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt _updateAllowedComponentsK s s X-CALENDARSERVER-PERUSERs X-CALENDARSERVER-PERUSER-UIDs X-CALENDARSERVER-PERINSTANCEs X-CALENDARSERVER-PRIVATE-COMMENTs! X-CALENDARSERVER-ATTENDEE-COMMENTs X-CALENDARSERVER-ATTENDEE-REFs X-CALENDARSERVER-DTSTAMPt GREGORIANt TEXTt VALUEt CALSCALEt METHODt PRODIDt VERSIONt URIt ATTACHt CATEGORIESt CLASSt COMMENTt DESCRIPTIONt FLOATt GEOt LOCATIONt INTEGERs PERCENT-COMPLETEi t PRIORITYt RESOURCESt STATUSt SUMMARYs DATE-TIMEt COMPLETEDt DTENDt DUEt DTSTARTt DURATIONt PERIODt FREEBUSYt OPAQUEt TRANSPt TZIDt TZNAMEs UTC-OFFSETt TZOFFSETFROMt TZOFFSETTOt TZURLs CAL-ADDRESSt INDIVIDUALt CUTYPEs REQ-PARTICIPANTt ROLEs NEEDS-ACTIONt PARTSTATt FALSEt RSVPt SERVERs SCHEDULE-AGENTt ATTENDEEt CONTACTt ORGANIZERs RECURRENCE-IDs RELATED-TOt URLt UIDt EXDATEt RECURt EXRULEt RDATEt RRULEt ACTIONt REPEATt TRIGGERt CREATEDt DTSTAMPs LAST-MODIFIEDt SEQUENCEs REQUEST-STATUSt VOTERil i t tzidi4 c B s e Z RS( ( t __name__t __module__( ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR � s c B s� e Z d Z i d d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d d � Z d d � Z d � Z d � Z d � Z d � Z d � Z d d � Z RS( s iCalendar Property c K s� | d k rm | d k s t � | d k s0 t � | d } t | t � sa t d j t � � � n | | _ n] | j d � } t | | d | �| _ x3 | j � D]% \ } } | j j t | | � � q� W| | _ d S( s� @param name: the property's name @param value: the property's value @param params: a dictionary of parameters, where keys are parameter names and values are (possibly empty) lists of parameter values. t pycalendars Not a Property: {0!r}t valuetypeN( t Nonet AssertionErrort isinstancet PyPropertyt TypeErrort formatt propertyt _pycalendart gett itemst addParameterR t _parent( t selft namet valuet paramst parentt kwargst pyobjRi t attrnamet attrvalue( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __init__� s c C s t | j � S( N( t strRq ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __str__� s c C s( d j d | d | j � d | j � � S( Ns0 <{self.__class__.__name__}: {name!r}: {value!r}>Rv Rw Rx ( Ro Rw Rx ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __repr__� s c C s t t | � � S( N( t hashR� ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __hash__� s c C s | j | � S( N( t __eq__( Rv t other( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __ne__� s c C s# t | t � s t S| j | j k S( N( Rl R t FalseRq ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C s | j | � p | j | � S( N( R� t __lt__( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __gt__� s c C sN | j � } | j � } | | k r( t S| | k r8 t S| j � | j � k S( N( Rw t TrueR� Rx ( Rv R� t my_namet other_name( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C s | j | � p | j | � S( N( R� R� ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __ge__� s c C s | j | � p | j | � S( N( R� R� ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt __le__� s c C s t d d d d | j j � �S( sg Duplicate this object and all its contents. @return: the duplicated calendar. Rh N( R Rj Rq t duplicate( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C s | j j � S( N( Rq t getName( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRw s c C s | j j � j � S( N( Rq t getValue( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRx s c C s t | j j � � S( N( R� Rq R� ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt strvalue s c C s/ t | d d � } | d k r+ | j � n d S( NRu ( t getattrRj t _markAsDirty( Rv Rz ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� s c C s | j j | � | j � d S( N( Rq t setValueR� ( Rv Rx ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� s c C sQ t � } xA | j j � j � D]* } x! | D] } | j | j � � q, Wq W| S( sM Returns a set containing parameter names for this property. ( t setRq t getParameterst valuest addR� ( Rv t resultt pyattrlistt pyattr( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt parameterNames s c C s- y | j j | � SWn t k r( | SXd S( sA Returns a single value for the given parameter. N( Rq t getParameterValuet KeyError( Rv Rw t default( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt parameterValue s c C s- y | j j | � SWn t k r( | SXd S( sH Returns a multi-value C{list} for the given parameter. N( Rq t getParameterValuesR� ( Rv Rw R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt parameterValues& s c C s | j j | � S( N( Rq t hasParameter( Rv t paramname( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� / s c C s' | j j t | | � � | j � d S( N( Rq t replaceParameterR R� ( Rv R� t paramvalue( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt setParameter2 s c C s | j j | � | j � d S( N( Rq t removeParametersR� ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt removeParameter6 s c C s | j j i � | j � d S( N( Rq t setParametersR� ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt removeAllParameters: s c C s� | j � } x� | j � D]� } | j � | k r xl t | j j � | � D]N } xE | j � D]7 } | | k r^ | j | � s� | j j | � q� q^ q^ WqK Wq q W| j � d S( N( t upperR� t tupleRq R� t getValuest removeValueR� R� ( Rv R� R� t attrNamet attrRx ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt removeParameterValue> s %c C sw d d d d g } | j � | k r( t S| j j � j � } t | t � sa t d j | � � � t | d | | | � S( s� Determines whether this property contains a date/date-time within the specified start/end period. The only properties allowed for this query are: COMPLETED, CREATED, DTSTAMP and LAST-MODIFIED (caldav -09). @param start: a L{DateTime} specifying the beginning of the given time span. @param end: a L{DateTime} specifying the end of the given time span. C{end} may be None, indicating that there is no end date. @param defaulttz: the default L{PyTimezone} to use in datetime comparisons. @return: True if the property's date/date-time value is within the given time range, False if not, or the property is not an appropriate date/date-time value. R? Ra Rb s LAST-MODIFIEDs! Not a date/date-time value: {0!r}N( Rw R� Rq R� Rl R Rk Ro R Rj ( Rv t startt endt defaulttzt allowedNamest dt( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt containsTimeRangeJ s $N( Rf Rg t __doc__Rj R R� R� R� R� R� R� R� R� R� R� Rw Rx R� R� R� R� R� R� R� R� R� R� R� R� ( ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR � s4 c B s� e Z d Z d Z d Z d Z d Z d Z i e d 6e d 6e d 6e d 6Z i d d d e f d 6d� d 6d� d 6d� d 6d� d 6d� d 6Z d� Z d! Z d� Z e d" � � Z e d� d# � � Z e d� d$ � � Z e d� d% � � Z e d� d& � � Z e d� d' � � Z e d� d( � � Z e d) � � Z e d* � � Z e d+ � � Z d, � Z d- � Z d. � Z d/ � Z d0 � Z d1 � Z d2 � Z d� d3 � Z d� d4 � Z! d� d5 � Z" d� d6 � Z# d7 � Z$ d8 � Z% d9 � Z& d: � Z' d; � Z( d< � Z) d= � Z* e d> � Z+ d? � Z, e- d@ � Z. dA � Z/ dB � Z0 dC � Z1 dD � Z2 d� dE � Z3 d� dF � Z4 dG � Z5 dH � Z6 dI � Z7 dJ � Z8 dK � Z9 dL � Z: dM � Z; dN � Z< dO � Z= dP � Z> dQ � Z? dR � Z@ dS � ZA dT � ZB dU � ZC dV � ZD dW � ZE dX � ZF dY � ZG dZ � ZH d[ � ZI d\ � ZJ d� d] � ZK d^ � ZL e- d_ � ZM d� e- eN d` � ZO d� e- eN da � ZP db � ZQ dc � ZR dd � ZS e- d� e- de � ZT df � ZU e- dg � ZV eW e- dh � ZX di � ZY dj � ZZ dk � Z[ d� dl � Z\ dm � Z] dn � Z^ eW eW e- do � Z_ eW dp � Z` dq � Za eW dr � Zb ds � Zc dt � Zd du � Ze dv � Zf dw � Zg dx � Zh dy � Zi dz � Zj d{ � Zk d| � Zl d} � Zm d~ � Zn e- e- d � Zo d� � Zp d� � Zq d� � Zr d� � Zs eW d� � Zt d� � Zu d� � Zv d� � Zw d� � Zx d� � Zy d� � Zz d� d� � Z{ d� � Z| d� � Z} d� � Z~ e- d� � Z e- d� � Z� e- d� � Z� d� � Z� e- d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� eW d� � Z� d� � Z� e- d� � Z� d� d� eW d� � Z� d� d� � Z� d� i eW d� � Z� d� � Z� d� � Z� d� � Z� e� eW d� � � Z� e� eW d� � � Z� d� � Z� d� e- d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� e� eW e- d� � � Z� d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� d� � Z� e- d� � Z� d� � Z� d� � Z� RS(� s! X{iCalendar} component. s X-CALENDARSERVER-ACCESSt PUBLICt PRIVATEt CONFIDENTIALt RESTRICTEDR/ R0 R- t VCALENDARRX s RECURRENCE-IDRc Rb R= RG RB R@ RC R] R\ R[ RY R! R? RA R" t VJOURNALRE R$ R% R> R9 s X-CALENDARSERVER-HIDDEN-INSTANCEc C sA | j d k r: d g | _ t j r: | j j d � q: n | j S( Ns text/calendars application/calendar+json( t allowedTypesListRj R t EnableJSONDatat append( t cls( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt allowedTypes� s c C s | j | | � S( s< Just default to reading a single VCALENDAR ( t fromString( t clazzt stringRo ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt allFromString� s c C s | j | | � S( s< Just default to reading a single VCALENDAR ( t fromStream( R� t streamRo ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt allFromStream� s c C s | j | t | � S( s� Construct a L{Component} from a string. @param string: a string containing iCalendar data. @return: a L{Component} representing the first component described by C{string}. ( t _fromDataR� ( R� R� Ro ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C s | j | t | � S( s� Construct a L{Component} from a stream. @param stream: a C{read()}able stream containing iCalendar data. @return: a L{Component} representing the first component described by C{stream}. ( R� R� ( R� R� Ro ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C s� | r nQ t | � t k r- | j d � } n | j d � | d t j k rZ | d } n d } y t j | | � } Wn1 t k r� } d j | j | j � } d } n X| s� | r� | j d � | j � } n t d j | | � � � n | d d | �S( s8 Construct a L{Component} from a stream. @param stream: a C{read()}able stream containing iCalendar data. @param format: a C{str} indicating whether the data is iCalendar or jCal @return: a L{Component} representing the first component described by C{stream}. s utf-8i t Unknowns {0}: {1}i s {0} {1}Rh N( t typet unicodet encodet decodet codecst BOM_UTF8R t parseDataR Ro t mReasont mDataRj t seekt readR ( R� t datat isstreamRo t errmsgR� t e( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s& c s% � � f d � } t t | � | � S( s� Construct a L{Component} from a stream. @param stream: an L{IStream} containing iCalendar data. @return: a deferred returning a L{Component} representing the first component described by C{stream}. c s � j | � � S( N( R� ( R� ( R� Ro ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt parse� s ( R R ( R� R� Ro R� ( ( R� Ro s% /opt/cpanel-ccs/twistedcaldav/ical.pyt fromIStream� s c C s8 y | j | | � } Wn t k r* d SX| j | � S( s� Need to split a single VCALENDAR in text form into separate ones based on UID with the appropriate VTIEMZONES included. N( R� R Rj t componentsFromComponent( R� R� Ro t vcal( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt componentsFromData� s c C sy g } t j � } i } x^ | j � D]P } | j � d k rS | | | j d � <q% | j | j d � g � j | � q% Wx� | j � D]� } | d � } | j t d d � � | j t d | j d � � � t � } x! | D] } | j | j � � q� WxC | D]; } y! | | } | j | j � � Wqt k r;qXqWx! | D] } | j | j � � qGW| j | � q� W| S( s� Need to split a single VCALENDAR in Component form into separate ones based on UID with the appropriate VTIEMZONES included. R% RH RX R� R0 s 2.0R/ ( t collectionst OrderedDictt subcomponentsRw t propertyValuet setdefaultR� R� t addPropertyR R� t updatet timezoneIDst addComponentR� R� ( R� t sourceComponentt resultst by_uidt by_tzidt subcomponentt componentst newvcalt tzidst componentRe t tz( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s0 & c C s< | d � } | j t d d � � | j t d t � � | S( s� Create and return an empty C{VCALENDAR} component. @return: a new C{VCALENDAR} component with appropriate metadata properties already set (version, product ID). @rtype: an instance of this class R� R0 s 2.0R/ ( R� R R ( R� Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt newCalendar" s c K s | d k r� d | k rd | d } | d k rX t | t � sX t d j | � � � qX n | | _ n t d � � d | k r� | d } | d k r� t | t � s� t d j | � � � q� n | | _ q d | _ n9 | d k r� t d t � n t j | d � | _ d | _ d S( sG Use this constructor to initialize an empty L{Component}. To create a new L{Component} from X{iCalendar} data, don't use this constructor directly. Use one of the factory methods instead. @param name: the name (L{str}) of the X{iCalendar} component type for the component. Rh s Not a ComponentBase: {0!r}s name may not be NoneRz s Not a Component: {0!r}R� t add_defaultsN( Rj Rl R Rn Ro Rq Rk R Ru R R� t PyComponentt makeComponent( Rv Rw R{ R| Rz ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR 0 s" 0c C s; t | d d � } | d k r" | St | j � | _ | j S( sX NB This does not automatically include timezones in VCALENDAR objects. t _cachedCopyN( R� Rj R� Rq R� ( Rv t cachedCopy( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� S s c C s8 d | _ t | d d � } | d k r4 | j � n d S( sI Invalidate the cached copy of serialized icalendar data Ru N( Rj R� R� R� ( Rv Rz ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� ] s c C s d j d | d t | j � � S( Ns& <{self.__class__.__name__}: {pycal!r}>Rv t pycal( Ro R� Rq ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� f s c C s t t | � � S( N( R� R� ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� l s c C s | j | � S( N( R� ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� o s c C s# t | t � s t S| j | j k S( N( Rl R R� Rq ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� r s c C s | j d t j d | � S( sP Return text representation and include non-standard timezones. t includeTimezonesRo ( t _getTextWithTimezonesR t NONSTD_TIMEZONES( Rv Ro ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getTextw s c C s. | r t j n t j } | j d | d | � S( sW Return text representation and include timezones if the option is on. R� Ro ( R t ALL_TIMEZONESR R� ( Rv R� Ro ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getTextWithTimezones} s c C s | j d t j d | � S( sI Return text representation without including timezones. R� Ro ( R� R t NO_TIMEZONES( Rv Ro ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getTextWithoutTimezones� s c C sa | j � d k s' t d j | � � � | j j d | d | � } | d k r] t d � � n | S( sW Return text representation and include timezones if the option is on. R� s Must be a VCALENDAR: {0!r}R� Ro s+ Unknown format requested for calendar data.N( Rw Rk Ro Rq R Rj t ValueError( Rv R� Ro R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s ' c C s | j | j k S( N( Rq ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt same� s c C s | j j � S( sL @return: the name of the iCalendar type of this component. ( Rq t getType( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRw � s c C s | j � t k S( sk @return: where this component is one of the L{ignoredComponents}. @rtype: L{bool} ( Rw t ignoredComponents( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt ignored� s c C s� | j � d k s' t d j | � � � d } xV | j d t � D]B } | rv | | j � k rv t d j | � � � q@ | j � } q@ W| S( s� Determine the primary type of iCal component in this calendar. @return: the name of the primary type. @raise: L{InvalidICalendarDataError} if there is more than one primary type. R� s Must be a VCALENDAR: {0!r}t ignores< Component contains more than one type of primary type: {0!r}N( Rw Rk Ro Rj R� R� R ( Rv t mtypeR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt mainType� s 'c C sv | j � d k s' t d j | � � � d } xB | j d t � D]. } | j d � sY | S| d k r@ | } q@ q@ W| S( s� Return the primary iCal component in this calendar. If a master component exists, use that, otherwise use the first override. @return: the L{Component} of the primary type. R� s Must be a VCALENDAR: {0!r}R s RECURRENCE-IDN( Rw Rk Ro Rj R� R� t hasProperty( Rv R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt mainComponent� s ' c C s[ | j � d k s' t d j | � � � x- | j d t � D] } | j d � s: | Sq: Wd S( s� Return the master iCal component in this calendar. @return: the L{Component} for the master component, or C{None} if there isn't one. R� s Must be a VCALENDAR: {0!r}R s RECURRENCE-IDN( Rw Rk Ro R� R� R Rj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt masterComponent� s 'c C s� | j � d k s' t d j | � � � t | t � rT | rK t j | � n d } n x^ | j d t � D]J } | j � } | r� | r� | | k r� | S| d k rg | d k rg | Sqg Wd S( s� Return the overridden iCal component in this calendar matching the supplied RECURRENCE-ID property. This also returns the matching master component if recurrence_id is C{None}. @param recurrence_id: The RECURRENCE-ID property value to match. @type recurrence_id: L{DateTime} @return: the L{Component} for the overridden component, or C{None} if there isn't one. R� s Must be a VCALENDAR: {0!r}R N( Rw Rk Ro Rl R� R t parseTextRj R� R� t getRecurrenceIDUTC( Rv t recurrence_idR� t rid( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt overriddenComponent� s ' c C sa | j � d k s' t d j | � � � | j t j � } | rN | j � } n t j j | | � S( sv Return the access level for this component. @return: the access level for the calendar data. R� s Must be a VCALENDAR: {0!r}( Rw Rk Ro R� R t ACCESS_PROPERTYR� t accessMapRr ( Rv R� t access( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt accessLevel� s 'c C s= t d d | j j � �} t | d � r9 | j | _ n | S( sg Duplicate this object and all its contents. @return: the duplicated calendar. Rh t noInstanceIndexingN( R Rj Rq R� t hasattrR ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c s � � f d � � j j � D� S( sx @return: an iterable of L{Component} objects, one for each subcomponent of this component. c 3 s@ | ]6 } � s" | j � t k r t d d | d � �Vq d S( Rh Rz N( R R R Rj ( t .0t c( R Rv ( s% /opt/cpanel-ccs/twistedcaldav/ical.pys <genexpr> s ( Rq t getComponents( Rv R ( ( R Rv s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� s c C s* | j j | j � | | _ | j � d S( s� Adds a subcomponent to this component. @param component: the L{Component} to add as a subcomponent of this component. N( Rq R� Ru R� ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� s c C s* | j j | j � d | _ | j � d S( ss Removes a subcomponent from this component. @param component: the L{Component} to remove. N( Rq t removeComponentRj Ru R� ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR s c C s | j j | � S( s� @param name: the name of the property whose existence is being tested. @return: True if the named property exists, False otherwise. ( Rq R ( Rv Rw ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR # s c C s` t | j | � � } t | � d k r/ | d St | � d k r\ t d j | | � � � n d S( s Get one property from the property list. @param name: the name of the property to get. @return: the L{Property} found or None. @raise: L{InvalidICalendarDataError} if there is more than one property of the given name. i i s- More than one {0} property in component {1!r}N( R� t propertiest lenR Ro Rj ( Rv Rw R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getProperty* s c s� g } | d k rD g � j j � j � D] } | j | � ^ q( n- � j j | � d k rq � j j | � } n � f d � | D� S( s� @param name: if given and not C{None}, restricts the returned properties to those with the given C{name}. @return: an iterable of L{Property} objects, one for each property of this component. i c 3 s- | ]# } t d d d d � d | �Vq d S( Rz Rh N( R Rj ( R t p( Rv ( s% /opt/cpanel-ccs/twistedcaldav/ical.pys <genexpr>F s N( Rj Rq t getPropertiesR� t extendt countProperty( Rv Rw R t i( ( Rv s% /opt/cpanel-ccs/twistedcaldav/ical.pyR 8 s 2 c C sf t | j | � � } t | � d k r5 | d j � St | � d k rb t d j | | � � � n | S( Ni i s- More than one {0} property in component {1!r}( R� R R! Rx R Ro ( Rv Rw R� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� J s c C s) | j d � } | d k r% | j � Sd S( s� Return the start date or date-time for the specified component converted to UTC. @param component: the Component whose start should be returned. @return: the L{DateTime} for the start. RB N( R� Rj t duplicateAsUTC( Rv t dtstart( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getStartDateUTCR s c C so | j d � } | d k rU | j d � } | j d � } | d k rU | | } qU n | d k rk | j � Sd S( sI Return the end date or date-time for the specified component, taking into account the presence or absence of DTEND/DURATION properties. The returned date-time is converted to UTC. @param component: the Component whose end should be returned. @return: the L{DateTime} for the end. R@ RB RC N( R� Rj R( ( Rv t dtendR) t duration( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getEndDateUTC\ s c C s{ | j d � } | d k ra | j d � } | j d � } | d k ra | d k ra | | } qa n | d k rw | j � Sd S( s Return the due date or date-time for the specified component converted to UTC. Use DTSTART/DURATION if no DUE property. @param component: the Component whose start should be returned. @return: the L{DateTime} for the start. RA RB RC N( R� Rj R( ( Rv t dueR) R, ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getDueDateUTCm s c C s) | j d � } | d k r% | j � Sd S( s� Return the completed date or date-time for the specified component converted to UTC. @param component: the Component whose start should be returned. @return: the datetime.date or datetime.datetime for the start. R? N( R� Rj R( ( Rv t completed( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getCompletedDateUTC} s c C s) | j d � } | d k r% | j � Sd S( s� Return the created date or date-time for the specified component converted to UTC. @param component: the Component whose start should be returned. @return: the datetime.date or datetime.datetime for the start. Ra N( R� Rj R( ( Rv t created( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getCreatedDateUTC� s c C s) | j d � } | d k r% | j � Sd S( s� Return the recurrence-id for the specified component. @param component: the Component whose r-id should be returned. @return: the L{DateTime} for the r-id. s RECURRENCE-IDN( R� Rj R( ( Rv R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR � s c C sG | j d � } | d k rC | j d � } | d k rC | d k Sn t S( s� Determine whether a RANGE=THISANDFUTURE parameter is present on any RECURRENCE-ID property. @return: True if the parameter is present, False otherwise. s RECURRENCE-IDt RANGEt THISANDFUTUREN( R" Rj R� R� ( Rv t ridpropt range( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getRange� s c C sQ t � } xA | j d � D]0 } x' | j � D] } | j | j � � q, Wq W| S( sH Get the set of all EXDATEs in this (master) component. RY ( R� R Rx R� R� ( Rv t exdatesRp t exdate( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getExdates� s c C s | j � d k s' t d j | � � � | j d � } | d k rZ t d j | � � � n | j d � j d � } | d k r� t } n | d k } | j d � } | d k r� d } n t | � } | j d � } | d k r| d k rt d j | � � � n | | | | f S( s� Return the trigger information for the specified alarm component. @param component: the Component whose start should be returned. @return: a tuple consisting of: trigger : the 'native' trigger value related : either True (for START) or False (for END) repeat : an integer for the REPEAT count duration: the repeat duration if present, otherwise None t VALARMs Component is not a VAlARM: {0!r}R` s% VALARM has no TRIGGER property: {0!r}t RELATEDt STARTR_ i RC s4 VALARM has invalid REPEAT/DURATIOn properties: {0!r}N( Rw Rk Ro R� Rj R R" R� R� t int( Rv t triggert relatedt repeatR, ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getTriggerDetails� s ' c C s | j j � S( N( Rq t getRecurrenceSet( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRD � s c C s� | j � d k r( | j � | j � f S| j � d k r� | j � } | j � } | d k rt | d k rt | | f S| | f Sn d Sd S( NR! R� R" ( R! R� ( NN( Rw R* R- R/ Rj ( Rv R� R. ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getEffectiveStartEnd� s c C sM | j � d k r d S| j d � } | d k r5 d S| d k rE d Sd Sd S( NR! t FREER= t CANCELLEDt TENTATIVEs BUSY-TENTATIVEt BUSY( R! ( Rw R� ( Rv t status( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getFBType� s c C s7 | j j | j � | j j � | | _ | j � d S( sw Adds a property to this component. @param property: the L{Property} to add to this component. N( Rq R� t finaliseRu R� ( Rv Rp ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C sv t | t � r? x` t | j | � � D] } | j | � q% Wn3 | j j | j � | j j � d | _ | j � d S( s� Remove a property from this component. @param property: the L{Property} to remove from this component. N( Rl R� R� R t removePropertyRq RL Rj Ru R� ( Rv Rp ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRM s c C s+ | j j | � | j j � | j � d S( sl remove all properties with name @param name: the name of the properties to remove. N( Rq t removePropertiesRL R� ( Rv Rw ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRN s c C sU x* t | j | � � D] } | j | � q Wx! | j � D] } | j | � q: Wd S( s� Remove all properties with the given name from all components. @param pname: the property name to remove from all components. @type pname: C{str} N( R� R RM R� t removeAllPropertiesWithName( Rv t pnameRp R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRO s c C s1 | j j | j � � | j | � | j � d S( s� Add or replace a property in this component. @param property: the L{Property} to add or replace in this component. N( Rq RN Rw R� R� ( Rv Rp ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt replaceProperty* s c C s� t � } | j � d k r] x� | j � D]. } | j � d k r( | j | j � � q( q( WnC x@ | j � D]2 } | j d � } | d k rj | j | � Pqj qj W| S( s� Returns the set of TZID parameter values appearing in any property in this component. @return: a set of strings, one for each unique TZID value. R� R% RH N( R� Rw R� R� R� R R� Rj R� ( Rv R� R� Rp Re ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� 5 s c C sv | j � d k s' t d j | � � � t � } x? | j � D]1 } | j � d k r= | j | j d � � q= q= W| S( s� Returns the set of TZID's for each VTIMEZONE component. @return: a set of strings, one for each unique TZID value. R� s Not a calendar: {0!r}R% RH ( Rw Rk Ro R� R� R� R� ( Rv R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt timezonesJ s ' c C s� t } | j � } | r�| j � r�| j j � } | r�x�| j � D]{} | j � r� | j � | k r�| j | � t } q�qF | j � r| j � } t | | j � � } | j � d d d | j � } i d t j 6d t j 6d t j 6d t j 6d t j 6d t j 6d t j 6| j � | j � } | | | k r�| j t � | j t � | j | � | j � t } q�qF | j � t j k rF | j t � | j | � | j � t } qF qF Wq�n | r�| j � n | S( s! Truncate RRULEs etc to make sure there are no more than the given number of instances. @param maximumCount: the maximum number of instances to allow @type maximumCount: C{int} @return: a C{bool} indicating whether a change was made or not i i< im i i i i8" i i�3�i� i�� i �' i� i`' i�: i i� i�Q i ( R� R t isRecurringRq RD t getRulest getUseCountt getCountt setCountR� t getUseUntilR* R t getUntilt getDayst getSecondsR t eRecurrence_YEARLYt eRecurrence_MONTHLYt eRecurrence_WEEKLYt eRecurrence_DAILYt eRecurrence_HOURLYt eRecurrence_MINUTELYt eRecurrence_SECONDLYt getFreqt getIntervalt setUseUntilt setUseCountt changedR� ( Rv t maximumCountRg t mastert rrulest rruleR� t difft period( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt truncateRecurrenceZ sJ " c C s� | j � s d S| j � } | rR| j j � } | r� xs | j � D]b } | j t � | j t � | j � } | j � r� | j d � n | j d � | j | � qD Wn x� t t j | j d � | j d � � � D]s } xB t | j � � D]. } | j � | k r� | j � j | � q� q� Wt | j � � d k r� | j | � q� q� Wn xT t | j d t � � D]: } | j � } | d k rk| | k rk| j | � qkqkWx� t | j � � D]� } | j � t k r�xN t | j � � D]: } | j � } | d k r�| | k r�| j | � q�q�Wt t | j � � � d k rV| j | � qVq�q�W| j � t | d � r�t | d � n d S( s) Remove all recurrence instances at or beyond the specified recurrence-id. Adjust the bounds of any RRULEs to match the new limit, remove RDATEs/EXDATEs and overridden components beyond the limit. @param rid: the recurrence-id limit @type rid: L{DateTime} Ni����R\ RY i R t cachedInstances( RS R Rq RD RT Re R� Rf R� R� t isDateOnlyt offsetDayt offsetSecondst setUntilt listt itertoolst chainR Rx R� t removeR! RM R� R Rj R Rw t PERUSER_COMPONENTR� R t delattr( Rv R Ri Rj Rk t untilRp Rx R� t c_ridR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt onlyPastInstances� sJ c C s� | j � s d S| j � } | r�| } d } d } t } | j j � } | rt | j � � d k r| j � d } | j � } | j d � g } | j | j d � t t d d d � | � | � xK t t | � � D]. \ } } | | k r� | } | } | } Pq� q� Wt } n | j | d t �} | d k r:d S| d k rl| j � rl| j | j � | � n | j | j d � � xW t t j | r�| j d � n d | j d � | j d � � � D] } | j | � q�W| j | � | } | j | � x� t t j | j d � | j d � � � D]� } xf t | j � � D]R } | j � | k s|| j � d k r@| j � | k r@| j � j! | � q@q@Wt | j � � d k r'| j | � q'q'Wn xT t | j" d t � � D]: } | j# � } | d k r�| | k r�| j | � q�q�Wx� t | j" � � D]� } | j � t$ k r/xN t | j" � � D]: } | j# � } | d k rZ| | k rZ| j | � qZqZWt t | j" � � � d k r�| j | � q�q/q/W| j% � t& | d � r�t' | d � n d S( s� Remove all recurrence instances from the specified recurrence-id into the past. Adjust the bounds of any RRULEs to match the new limit, remove RDATEs/EXDATEs and overridden components beyond the limit. This also requires "re-basing" the master component to the new first instance - but noting that has to match any RRULE pattern. @param rid: the recurrence-id limit @type rid: L{DateTime} Ni i RB il t allowExcludeds RECURRENCE-IDR] R\ RY R Ro ( (( RS R Rj R� Rq RD R! RT R� t offsetYeart expandR� R R t enumeratet sortedR� t deriveInstanceRU RW RV RM R" Rt Ru Rv R R� R R� Rx R� Rw Rw R� R Rx R� R Ry ( Rv R Ri t adjusted_ridt adjust_rrulet adjust_countt continuing_rruleRj Rk t upperlimitt rrule_expandedt ctrR' t derivedRp Rx R� R{ R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt onlyFutureInstances� s| 6 c C s | d k r6 t | t � r6 t d | j d � � } n | } t d � } x! | j � D] } | j | � qU Wx! | j � D] } | j | � qy W| j | d | d t �} t } xd | D]\ } | | } t t | j � t | j � | | | � r| j | j | | � � n t } q� W| S( s� Expand the components into a set of new components, one for each instance in the specified range. Date-times are converted to UTC. A new calendar object is returned. @param start: the L{DateTime} for the start of the range. @param end: the L{DateTime} for the end of the range. @param timezone: the L{Component} or L{Timezone} of the VTIMEZONE to use for floating/all-day. @return: the L{Component} for the new calendar with expanded instances. Re RH R� t lowerLimitt normalizeFunctionN( Rj Rl R R R� R RM R� t expandTimeRangesR R� R R R� R� R� t expandComponentR� ( Rv R� R� t timezonet pytzt calendarRp t instancest firstt keyt instance( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR 5 s * c C s` | j j � } x< t | j � � D]( } | j � d k r" | j | � q" q" Wx^ | j � D]P } | j � } t | t � r[ | j � r[ | j d � | j | j � � q[ q[ Wx' | j d � D] } | j | j � q� Wx' | j d � D] } | j | j � q� Wx. | j d � D] } | j | j | j � qW| j � s\| j t d | j � � n | S( s Create an expanded component based on the instance provided. NB Expansion also requires UTC conversions. @param instance: an L{Instance} for the instance being expanded. @return: a new L{Component} for the expanded instance. R] R\ R[ RY s RECURRENCE-IDRH RB R@ RC ( R] R\ R[ RY s RECURRENCE-ID( R� R� R� R Rw RM Rx Rl R t localR� R� R( R� R� t isMasterInstanceR� R R ( Rv R� R� t newcompRp Rx ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� \ s$ c C so t | d � r= | j j } | d k s3 | | k r= | j Sn | t d d � } | j | d | �| _ | j S( s� Expand instances up to the specified limit and cache the results in this object so we can return cached results in the future. The limit value is the actual value that the requester needs, but we will cache an addition 365-days worth to give us some breathing room to return results for future instances. @param limit: the max datetime to cache up to. @type limit: L{DateTime} Ro t daysim t ignoreInvalidInstancesN( R Ro t limitRj R R� ( Rv R� R� t cachedLimitt lookAheadLimit( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt cacheExpandedTimeRanges� s c C s. | j � } | j | | d | d | d | �S( s� Expand the set of recurrence instances for the components contained within this VCALENDAR component. We will assume that this component has already been validated as a CalDAV resource (i.e. only one type of component, all with the same UID) @param limit: L{DateTime} value representing the end of the expansion. @param ignoreInvalidInstances: C{bool} whether to ignore instance errors. @return: a set of Instances for each recurrence in the set. R� R� R� ( R� t expandSetTimeRanges( Rv R� R� R� R� t componentSet( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C s� t d | d | � } y | j | | d | �Wn` t k r� } t d � r� t d | j � j d � d d j t | � t | � � � n � n X| S( s� Expand the set of recurrence instances up to the specified date limit. What we do is first expand the master instance into the set of generate instances. Then we merge the overridden instances, taking into account THISANDFUTURE and THISANDPRIOR. @param componentSet: the set of components that are to make up the recurrence set. These MUST all be components with the same UID and type, forming a proper recurring set. @param limit: L{DateTime} value representing the end of the expansion. @param componentSet: the set of components that are to make up the recurrence set. These MUST all be components with the same UID and type, forming a proper recurring set. @type componentSet: C{list} @param limit: the end of the expansion @type limit: L{DateTime} @param ignoreInvalidInstances: whether or not invalid recurrences raise an exception @type ignoreInvalidInstances: C{bool} @param normalizeFunction: a function used to normalize date/time values in instances @type normalizeFunction: C{function} @return: L{InstanceList} containing expanded L{Instance} for each recurrence in the set. R� R� R� s Invalid Instancet base64i����s {} {}( R R� R R R t resourceUIDR� Ro R� ( Rv R� R� R� R� R� R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s "c C s` | j � d k rI d } x* | j d t � D] } | | j � 7} q+ W| S| j � } | f Sd S( sd Get the R-ID value for each component. @return: a tuple of recurrence-ids R� R N( ( Rw R� R� t getComponentInstancesR ( Rv R� R� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C sj | j � d k rB xQ | j d t � D] } | j � r% t Sq% Wn$ x! d D] } | j | � rI t SqI Wt S( sW Check whether any recurrence properties are present in any component. R� R R] R\ RY s RECURRENCE-ID( R] R\ RY s RECURRENCE-ID( Rw R� R� RS R R� ( Rv R� t propname( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRS � s c C sc | j � } | r_ | j d � } x; | D]0 } | j � j � r( | j � j � r( t Sq( Wn t S( s1 Check for unbounded recurrence. R] ( R R Rx RU RX R� R� ( Rv Ri Rj Rk ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt isRecurringUnbounded� s & c C sH | r! | d k r! t d � � n | j � } | d k r= d St | t � rj | ra t j | � n d } n t } t } x� t | j d � � D]� } x� | j � D]� } | j � | k r� | r!| j � j | � t | j � � d k r� | j | � n t } t | d � r t | d � n Pq8| r1t } Pq8d Sq� q� Wq� W| s t � } xI | j d � D]8 } | j g | j � D] } | j � j � ^ qx� q_W| | k r | j d � } t t | � � r�| j | � } t | � } t | � | j k rd Sqd Sq n | d k r$| j � } n | j d � } | j d � rj| j d � } | j � | j � } n | j � } | j � j � s�| j � j � r�| j | j � j � � q�n | j t � | j! | � | j d � r�| j! | | � n | j" t# d | j � d i �� | r7| j" t# d d � � n | j$ j% � | S( s Derive an instance from the master component that has the provided RECURRENCE-ID, but with all other properties, components etc from the master. If the requested override is currently marked as an EXDATE in the existing master, allow an option whereby the override is added as STATUS:CANCELLED and the EXDATE removed. IMPORTANT: all callers of this method MUST check the return value for None. Never assume that a valid instance will be derived - no matter how much you think you understand iCalendar recurrence. There is always some new thing that will surprise you. @param rid: recurrence-id value @type rid: L{DateTime} or C{str} @param allowCancelled: whether to allow a STATUS:CANCELLED override @type allowCancelled: C{bool} @param allowExcluded: whether to derive an instance for an existing EXDATE @type allowExcluded: C{bool} @return: L{Component} for newly derived instance, or C{None} if not a valid override s2 Cannot re-use master component with allowCancelledRY i Ro R\ R] RB R@ s RECURRENCE-IDRy R= RG N(& Rj R R Rl R� R R R� R� R Rx R� Rw R! RM R� R Ry R� R� R( R� R R� t masterDerivedR" R R� Rp R� t adjustTimezonet getTimezonet setDateOnlyR� RQ R Rq RL ( Rv R t allowCancelledR� R} Ri t didCancelt matchedExdateR: t exdateValuet rdatest rdatet itemRj R� t instance_ridR) R+ t olddurationt newdtstartValue( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � sn 6 " c C sk | j � } | d k r d S| j � } x< t | j � � D]( } | j � d k r; | j | � q; q; W| S( sT Generate a component from the master instance that can be fed repeatedly to deriveInstance in the case where the result of deriveInstance is not going to be inserted into the component. This provides an optimization for avoiding unnecessary .duplicate() calls on the master for each deriveInstance. R] R\ R[ RY s RECURRENCE-IDN( R] R\ R[ RY s RECURRENCE-ID( R Rj R� R� R Rw RM ( Rv Ri R� Rp ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� h s c C s� t � } g | D] } | d k r | ^ q } | rc t | � } | j | t d d � d | �n x9 | D]1 } | j | d t d | �rj | j | � qj qj W| S( s� Test whether the specified recurrence-ids are valid instances in this event. @param rid: recurrence-id values @type rid: iterable @return: C{set} of valid rids R� i R� t clear_cacheN( R� Rj t maxR� R t validInstanceR� R� ( Rv t ridsR� t validR t non_master_ridst highest_rid( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt validInstances s % c C s} | j � d k r( | t | j � � k S| d k r8 t S| j | d | �} t g | D] } | | j ^ qW � } | | k S( s� Test whether the specified recurrence-id is a valid instance in this event. @param rid: recurrence-id value @type rid: L{DateTime} @return: C{bool} R� N( R Rj R� R� R� R� R ( Rv R R� R� R� R� t new_rids( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s &c C sy | j d � } | d k r\ | j � j � r\ | j � j � r\ | j | j � j � � n | j t d | g � � d S( s= Add an EXDATE to a master recurring component and ensure the value type, TZID etc match the DTSTART of the master. This method assumes that L{self} is the master component - no checking of that will be done. @param exdate: the exdate to add @type exdate: L{DateTime} RB RY N( R" Rj Rx Rp R� R� R� R� R ( Rv R: R) ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt addExdate� s 1 c C s� x� t | j d � � D]m } xd | j � D]V } | j � | k r) | j � j | � t | j � � d k r | j | � q q) q) Wq Wd S( s� Remove an EXDATE from a master recurring component if present. If not present, do nothing. This assumes L{self} is the master component @param exdate: the exdate to add @type exdate: L{DateTime} RY i N( R� R Rx R� Rw R! RM ( Rv R: t exdatePropR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt removeExdate� s c C sy | j � d k s' t d j | � � � t | d � sr x9 | j d t � D] } | j d � | _ PqI Wd | _ n | j S( sJ @return: the UID of the subcomponents in this component. R� s Not a calendar: {0!r}t _resource_uidR RX N( Rw Rk Ro R R� R� R� R� Rj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s ' c C s~ | j � d k s' t d j | � � � | d k rE t t j � � n | } | j j | j � | � | | _ | j � | j S( sI Generate a new UID for all components in this VCALENDAR R� s Not a calendar: {0!r}N( Rw Rk Ro Rj R� t uuidt uuid4Rq t changeUIDR� R� R� ( Rv t newUID( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s '$ c C s� | j � d k s' t d j | � � � t | d � s� t } x{ | j � D]C } | j � } | d k rp t } qI | j � r� qI qI | | _ PqI W| r� d | _ q� t d j | � � � n | j S( sm @return: the name of the iCalendar type of the subcomponents in this component. R� s Not a calendar: {0!r}t _resource_typeR% s5 No component type found for calendar component: {0!r}( Rw Rk Ro R R� R� R� R R� R ( Rv t has_timezoneR� Rw ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt resourceType� s ' c C s | j j � S( s? Remove timezones that this server knows about ( Rq t stripStandardTimezones( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� s c C s3 | j � d k r4 t j d d | �t d � � n | j � sb t j d d | �t d � � n | j j d | � \ } } | r� | j d | � \ } } | j | � | j | � n | rt j d d d j | � �| rt d j d j | � � � � qn | r)t j d d d j | � �n | | f S( s� @return: tuple of fixed, unfixed issues @raise InvalidICalendarDataError: if the given calendar data is not valid and cannot be fixed. R� s Not a calendar: {s!r}t ss Not a calendars Unknown resource type: {s!r}s Unknown resource typet doFixs+ Calendar data had unfixable problems: {d}t ds s+ Calendar data had unfixable problems: {0}s) Calendar data had fixable problems: {d}( Rw t logt debugR R� Rq t validatet validRecurrenceIDsR% t joinRo ( Rv R� t doRaiset validateRecurrencest fixedt unfixedt rfixedt runfixed( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt validCalendarData s$ $ c C s� g } g } | j � } | d k r�t | j � � } d | k rR | j d � n | j � r i } xD t | j d � � D]- } x$ | j � D] } | | | j � <q� Wqz Wx� | D]� } | | k r� | ri| | } x= | j � D]/ } | j � | k r� | j � j | � Pq� q� W| j | � t | j � � d k rI| j | � n | | =| j d j | � � q�| j d j | � � q� q� W| j | d t �} g } xC | j d � D]2 } | j g | j � D] } | j � ^ q�� q�W| j t | � � | j d � } | d k r x� t | j d � � D]� } g } t } xw | j � D]i } | j � } | | k r�| r�| j d j | � � n | j d j | � � t } qJ| j | � qJW| r+| r+| j | � | r�| j | � | j | � q�q+q+Wq n t � } | | } x} | D]r } | j | � } | j d � } | rv| j t d | g � � | j d j | � � q| j d j | � � qWn | | f S( NRY i s& Removed EXDATE for valid override: {0}s EXDATE for valid override: {0}R� R\ RB s Removed earlier EXDATE: {0}s EXDATE earlier than master: {0}s RECURRENCE-IDs' Added RDATE for invalid occurrence: {0}s Invalid occurrence: {0}( R Rj R� R� Rw RS Rt R Rx R� RM R! R� R� Ro R� R� R% R� R� R� R� R R ( Rv R� R� R� Ri t all_ridsR9 Rp R: R Rx t valid_ridsR� t _rdateR) t newValuesRg R� t invalid_ridst invalid_ridt brokenComponentt brokenRID( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� ' sz 0 c C s� | r8 | j d � r8 d } t j | � t | � � n d } d } t � } t � } t � } t } x3| j � D]%} | j � d k r� | j | j d � � qr | j � r� qr qr | d k r� | j � } nF | | j � k rd j | | j � � } t j | � t | � � n | t k rMd j | � } t j | � t | � � n | j d � } | d k r�d } t j | � t | � � n | j � } | d k r�| } nC | | k r�d j | | j d � � } t j | � t | � � n | d k r@| r7d j | | j d � � } t j | � t | � � q@t } n | | k rwd j | � } t j | � t | � � n | j | � | j | j � � qr Wt j s�xK | D]@ } | | k r�d j | | � } t j | � t | � � q�q�Wn x0 | D]( } | | k r�t j d d | �q�q�W| | } x | D] } t | � q6Wt | � } t | j d d � � t | � k r�t d � � n d S( s� @param methodAllowed: True if METHOD property is allowed, False otherwise. @raise InvalidICalendarDataError: if the given calendar component is not valid for use as a X{CalDAV} resource. R. s7 METHOD property is not allowed in CalDAV iCalendar dataR% RH s_ Calendar resources may not contain more than one type of calendar component ({0} and {1} found)s Component type: {0} not allowedRX s All components must have UIDssU Calendar resources may not contain components with different UIDs ({0} and {1} found)sj Calendar resources may not contain components with the same UIDs and no Recurrence-IDs ({0} and {1} found)sP Calendar resources may not contain components with the same Recurrence-IDs ({0})s2 Timezone ID {0} is referenced but not defined: {1}s= Timezone {tz} is not referenced by any non-timezone componentR� s s, iCalendar contains illegal control characterN( R R� R� R Rj R� R� R� Rw R� R� R Ro R R R� R� R� R t EnableTimezonesByReferenceR R� R! t translate( Rv t methodAllowedt msgt ctypet component_idt component_ridst timezone_refsRR t got_masterR� t uidR t timezone_refR� t missing_timezonesRe R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt validCalendarForCalDAV� s� $c C s | j � } d } d } t � } xv | D]n \ } } | r� | rz | | k r� d j | � } t j | � t | � � q� q� | } | } q( | j | � q( W| r | r | r� t j d � | j | � j d � } x3 | D] } | j | � j | � q� Wq t d � � n | S( sK Check that the ORGANIZER property is valid for scheduling s9 Only one ORGANIZER is allowed in an iCalendar object: {0}s# Fixing missing ORGANIZER propertiesRV s8 iCalendar missing ORGANIZER properties in some instancesN( t getOrganizersByInstanceRj R� Ro R� R� R R� R R" R� ( Rv R� t organizerst foundOrganizert foundRidt missingRidst organizerR R� t organizerProperty( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt validOrganizerForScheduling s, c C s| | j � d k r( t d | j j � � S| j � d k rt x; | j � D]" } | j � d k rG | j � SqG Wd Sn d Sd S( s� Get the Timezone for a Timezone component. @return: L{Timezone} if this is a VTIMEZONE, otherwise None. R% Re R� N( Rw R Rq t getIDR� t gettimezoneRj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� - s c C s< y# | j d � } | d k r" t SWn t k r7 t SXt S( s� Verify that this calendar component has a valid iTIP METHOD property. @return: True if valid, False if not R. t PUBLISHt REQUESTt REPLYt ADDt CANCELt REFRESHt COUNTERt DECLINECOUNTER( R� R� R� R� R� R� R� R� ( R� R� R R� ( Rv t method( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt isValidMethodB s c C s� y� | j d � } | d k r" t S| j d t � | d k r� | j � d k r� t g | j � D] } | ^ q` � d k r� t Sn Wn t k r� t SXt S( s Verify that this calendar component is valid according to iTIP. @return: True if valid, False if not R. R� R� R� R� R� R� R� R� R� R$ i ( R� R� R� R� R� R� R� R� ( R� R� R� R� R R! R� R ( Rv R R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt isValidITIPR s + c C sb | j � d k r9 xI | j d t � D] } | j � SWn% y | j d � SWn t k r] n Xd S( s� Get the organizer value. Works on either a VCALENDAR or on a component. @return: the string value of the Organizer property, or None R� R RV N( Rw R� R� t getOrganizerR� R Rj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR q s c C s� | j � d k rI d } x* | j d t � D] } | | j � 7} q+ W| Sy, | j d � } | j � } | | f f SWn t k r� n Xd S( s� Get the organizer value for each instance. @return: a list of tuples of (organizer value, recurrence-id) R� R RV ( ( ( Rw R� R� R� R� R R ( Rv R� R� t orgR ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c C sd | j � d k r; g | j d t � D] } | j � ^ q% Sy | j d � SWn t k r_ n Xd S( s� Get the organizer value. Works on either a VCALENDAR or on a component. @return: the string value of the Organizer property, or None R� R RV N( Rw R� R� t getOrganizerPropertyR" R Rj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getOrganizerProperties� s ) c C sb | j � d k r9 xI | j d t � D] } | j � SWn% y | j d � SWn t k r] n Xd S( s� Get the organizer value. Works on either a VCALENDAR or on a component. @return: the string value of the Organizer property, or None R� R RV N( Rw R� R� R R" R Rj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR � s c C s[ t } | j � } | d k rW | j d � rN | j d � d k rT t } qT qW t } n | S( Ns SCHEDULE-AGENTRS ( R� R Rj R� R� R� ( Rv t is_servert organizerProp( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getOrganizerScheduleAgent� s c C sv t } xi t | j d t � � D]O } | j � } | d k r | j d d � d k rn | j | � t } qn q q W| S( si Remove components whose ORGANIZER property does not have SCHEDULE-AGENT=SERVER. R s SCHEDULE-AGENTRS N( R� R� R� R� R Rj R� R ( Rv Rg R� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt cleanOrganizerScheduleAgent� s c C s | j � d k r d Sd S( NR# t VVOTERRd RT ( R# R ( Rw ( Rv ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt recipientPropertyName� s c C s� | j � d k r9 x� | j d t � D] } | j � SWn} | j � d k r� g } xE | j � D]7 } | j � d k r^ | j | j | j � � � q^ q^ W| St | j | j � � � Sd S( s� Get the attendee properties. Works on either a VCALENDAR or on a component. @return: a C{list} of the the Attendee properties R� R R# R N( Rw R� R� t getRecipientPropertiesR% R R Rt Rj ( Rv R� R� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR � s #c C s# g | j � D] } | j � ^ q S( s� Get the attendee value. Works on either a VCALENDAR or on a component. @return: a C{list} of the string values of the Attendee property, or None ( R Rx ( Rv R# ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getAttendees� s c C s | j � d k rO d } x0 | j d t � D] } | | j | | � 7} q+ W| Sd } t � } | j � } x� t | j � � D]� } | r� | j d � r� | j d � d k r� q} q� q� n | j � } | r� | | k r� | j | � q} | | | f f 7} | j | � q} W| Sd S( s� Get the attendee values for each instance. Optionally remove duplicates. @param makeUnique: if C{True} remove duplicate ATTENDEEs in each component @type makeUnique: C{bool} @param onlyScheduleAgentServer: if C{True} only return ATETNDEEs with SCHEDULE-AGENT=SERVER set @type onlyScheduleAgentServer: C{bool} @return: a list of tuples of (organizer value, recurrence-id) R� R s SCHEDULE-AGENTRS N( ( ( Rw R� R� t getAttendeesByInstanceR� R R� R R� R� Rx RM R� ( Rv t makeUniquet onlyScheduleAgentServerR� R� t attendeesR t attendeet cuaddr( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR s& c C sg t � } x! | D] } | j t | � � q Wx3 | j d � D]" } t | j � � | k r= | Sq= Wd S( s� Get the voters matching a value. @param match: a C{list} of calendar user address strings to try and match. @return: the matching Voter property, or None Rd N( R� R� R R Rx Rj ( Rv t matcht testR� t voter( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getVoterProperty( s c C s� t � } x! | D] } | j t | � � q W| j � d k r~ xo | j d t � D]% } | j | � } | d k rR | SqR Wn3 x0 | j � D]" } t | j � � | k r� | Sq� Wd S( s� Get the attendees matching a value. Works on either a VCALENDAR or on a component. @param match: a C{list} of calendar user address strings to try and match. @return: the matching Attendee property, or None R� R N( R� R� R Rw R� R� t getAttendeePropertyRj R Rx ( Rv R R R� R� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR < s c C ss | j � d k s' t d j | � � � g } x? | j d t � D]+ } | j | � } | r@ | j | � q@ q@ W| S( s Get all the attendees matching a value in each component. Works on a VCALENDAR component only. @param match: a C{list} of calendar user address strings to try and match. @return: the string value of the Organizer property, or None R� s Not a calendar: {0!r}R ( Rw Rk Ro R� R� R R� ( Rv R R� R� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getAttendeePropertiesW s 'c c sn | j � d k rN xU | j d t � D]" } x | j � D] } | Vq8 Wq% Wn x | j � D] } | Vq[ Wd S( s� Yield all attendees as Property objects. Works on either a VCALENDAR or on a component. @return: a generator yielding Property objects R� R N( Rw R� R� t getAllAttendeePropertiesR ( Rv R� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR j s c C sF | j t d | �} t � } x! | D] \ } } | j | � q% W| S( NR ( R R� R� R� ( Rv R t attendeesByInstanceR R t _ignore( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getAllUniqueAttendees{ s c C sb | j � d k r9 xI | j d t � D] } | j � SWn% y | j d � SWn t k r] n Xd S( s� Get the X-CALENDARSEREVR-MASK-UID value. Works on either a VCALENDAR or on a component. @return: the string value of the X-CALENDARSEREVR-MASK-UID property, or None R� R s X-CALENDARSERVER-MASK-UIDN( Rw R� R� t getMaskUIDR� R Rj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR � s c C sb | j � d k r9 xI | j d t � D] } | j � SWn% y | j d � SWn t k r] n Xd S( s� Get the X-CALENDARSERVER-EXTENDED-FREEBUSY value. Works on either a VCALENDAR or on a component. @return: the string value of the X-CALENDARSERVER-EXTENDED-FREEBUSY property, or None R� R s" X-CALENDARSERVER-EXTENDED-FREEBUSYN( Rw R� R� t getExtendedFreeBusyR� R Rj ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR � s c C s | j i | | 6| | � d S( s� Add or change the parameter to the specified value on the property having the specified value. If C{paramvalue} is L{None} remove the parameter. @param paramname: the parameter name @type paramname: C{str} @param paramvalue: the parameter value to set @type paramvalue: C{str} @param propname: the property name @type propname: C{str} @param propvalue: the property value to test @type propvalue: C{str} or C{None} N( t! setParametersForPropertyWithValue( Rv R� R� R� t propvalue( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt' setParameterToValueForPropertyWithValue� s c C s� x� | j d t � D]� } x� | j | � D]p } | d k sM | j � | k r) xI | j � D]8 \ } } | d k r� | j | | � qZ | j | � qZ Wq) q) Wq Wd S( s Add, change or remove a set of parameters to the specified value on the property having the specified value. Parameters are specified in a name:value L{dict}. If the value is L{None} the parameter will be removed. @param params: the parameter name/value pairs to set/remove @type params: C{dict} @param propname: the property name @type propname: C{str} @param propvalue: the property value to test @type propvalue: C{str} or C{None} R N( R� R� R Rj Rx Rs R� R� ( Rv Ry R� R" R� Rp R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR! � s c C sm t | t � r | f } n x! | D] } | j | � r" t Sq" Wx' | j � D] } | j | � rL t SqL Wt S( s� Test for the existence of one or more properties in any component. @param properties: property name(s) to test for @type properties: C{list}, C{tuple} or C{str} ( Rl R� R R� R� t hasPropertyInAnyComponentR� ( Rv R Rp R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR$ � s c C s� t | t � r | f } n x1 | D]) } t | j | � � } | r" | d Sq" Wx- | j � D] } | j | � } | r\ | Sq\ Wd S( s� Get the first of any set of properties in any component. @param properties: property name(s) to test for @type properties: C{list}, C{tuple} or C{str} i N( Rl R� R� R R� t getFirstPropertyInAnyComponentRj ( Rv R Rp t propsR� t prop( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR% � s i c C s� g } t | t � r! | f } n x9 | D]1 } t | j | � � } | r( | j | � q( q( W| d k r� x4 | j � D]# } | j | j | | d � � qv Wn | S( s� Get the all of any set of properties in any component down to a specified depth. @param properties: property name(s) to test for @type properties: C{list}, C{tuple} or C{str} @param depth: how deep to go in looking at sub-components: 0: do not go into sub-components, 1: go into one level of sub-components, 2: two levels (which is effectively all the levels supported in iCalendar) @type depth: int i i ( Rl R� R� R R% R� t getAllPropertiesInAnyComponent( Rv R t depthR� Rp R& R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR( s $c C sY xR | j d t � D]> } | j | j � � } | sM | j � | j � k r t Sq Wt S( s� Test for the existence of a property with a specific value in any sub-component. @param property: property to test for @type property: L{Property} R ( R� R� R" Rw Rx R� ( Rv Rp R� t found( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt hasPropertyValueInAllComponents s c C s. x' | j d t � D] } | j | � q Wd S( s� Add a property to all top-level components except VTIMEZONE. @param property: the property to add @type property: L{Property} R N( R� R� R� ( Rv Rp R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt addPropertyToAllComponents. s c C s. x' | j d t � D] } | j | � q Wd S( s~ Replace a property in all components. @param property: the L{Property} to replace in this component. R N( R� R� RQ ( Rv Rp R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt replacePropertyInAllComponents9 s c C s� | j � d k rN x� | j d t � D]" } | j | | | | � r% t Sq% Wn] xZ t | j | � � D]C } | j | � } | d k r� | s� | | k s� | d k rd t Sqd Wt S( s] See if property whose name, and parameter name, value match in any components. @param property: the L{Property} to replace in this component. @param param_name: the C{str} of parameter name to match. @param param_value: the C{str} of parameter value to match, if C{None} then just match on the presence of the parameter name. @param param_value_is_default: C{bool} to indicate whether absence of the named parameter also implies a match @return: C{True} if matching property found, C{False} if not @rtype: C{bool} R� R N( Rw R� R� t hasPropertyWithParameterMatchR� R R� Rj R� ( Rv R� t param_namet param_valuet param_value_is_defaultR� t oldpropt pvalue( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR. B s *c C s� | j � d k rH x� | j d t � D] } | j | | | | � q% Wnp xm t | j | j � � � D]P } | j | � } | d k r� | s� | | k rd | j | � | j | � qd qd Wd S( s� Replace a property whose name, and parameter name, value match in all components. @param property: the L{Property} to replace in this component. @param param_name: the C{str} of parameter name to match. @param param_value: the C{str} of parameter value to match. @param param_value_is_default: C{bool} to indicate whether absence of the named parameter also implies a match R� R N( Rw R� R� t& replaceAllPropertiesWithParameterMatchR� R R� Rj RM R� ( Rv Rp R/ R0 R1 R� R2 R3 ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR4 ] s " c C s� | j � d k rH x� | j d t � D] } | j | | | | � q% Wn] xZ t | j | � � D]C } | j | � } | d k r� | s� | | k r^ | j | � q^ q^ Wd S( sf Remove all properties whose name, and parameter name, value match in all components. R� R N( Rw R� R� t% removeAllPropertiesWithParameterMatchR� R R� Rj RM ( Rv R� R/ R0 R1 R� R2 R3 ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR5 r s c C s� | j � d k s' t d j | � � � | j � d k ri x� | j d t � D] } | j | | � qL Wnq | j � } | j | � } | s� | j � } n | r� x8 | D]- } x$ | j | � D] } | j | � q� Wq� Wn d S( sn Transfer specified properties from old calendar into all components of this calendar, synthesizing any for new overridden instances. @param from_calendar: the old calendar to copy from @type from_calendar: L{Component} @param properties: the property names to copy over @type properties: C{tuple} or C{list} R� s Not a calendar: {0!r}R N( Rw Rk Ro R� R� t transferPropertiesR R R R R� ( Rv t from_calendarR R� R t matchedR� R' ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR6 � s ' c C s� | j � d k s' t d j | � � � g } d } t } x� | j d t � D]� } t } xp | D]h } | j | f � } | d k r� t } Pn | r_ | j d � r� | j d � d k r� t } Pq� q� q_ q_ W| s� | j | � n | j � d k rL | } | s t } q qL qL Wg } xC | D]; } | j � } | d k rJ| j | � n | j | � q W| r�| d k r�x* | D] } | j t d | g � � quWn d S( s� Filter out any components that all attendees are not present in. Use EXDATEs on the master to account for changes. R� s Not a calendar: {0!r}R s SCHEDULE-AGENTRS RY N( Rw Rk Ro Rj R� R� R� R R� R� R� R R R� R ( Rv R R t remove_componentst master_componentt removed_masterR� t found_all_attendeesR t foundAttendeeR9 R R: ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt attendeesView� s> ' c C sY xR t | j d t � � D]4 } | j � d k r | j | f � d k r | Sq Wd Sd S( s� Find the VVOTER subcomponent with a VOTER property matching the specified attendee (voter). @param voter: the calendar user address of the attendee (voter) to match @type voter: L{str} R R N( R� R� R� Rw R Rj ( Rv R t voterComponent( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt voterComponentForVoter� s *c C s^ i } xQ | j � D]C } | j � d k r | j d � } | d k rV | | | <qV q q W| S( s\ Get a dict mapping each VOTE component POLL-ITEM-ID to the VOTE component. t VOTEs POLL-ITEM-IDN( R� Rw R� Rj ( Rv R� R� t poll_id( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt voteMap� s c C s� | s d | k r t S| j � d k s> t d j | � � � t | j d t � � } t | � } x@ | D]8 } | j � } | | k ri | j | � | d 8} qi qi W| d k S( NR� s Not a calendar: {0!r}R i i ( Rj R� Rw Rk Ro R� R� R! R R ( Rv R� R� t remainingR� R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt filterComponents� s ' c C s | j � d k s' t d j | � � � x� | j d t � D]� } | j � d k r� x� t | j � � D]R } | j � d k re | j | j � � j � | j � k r� | j | � q� qe qe Wq: xQ t | j | j � � � D]4 } | j � j � | j � k r� | j | � q� q� Wq: Wd S( sN Remove all ATTENDEE properties except for the one specified. R� s Not a calendar: {0!r}R R# R N( Rw Rk Ro R� R� R� R� R t lowerR R Rx RM ( Rv R R� t vvoterR# ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt removeAllButOneAttendee� s ''" c C s3 | j � d k s' t d j | � � � t g | D] } | j � ^ q1 � } x� | j d t � D]� } | j � d k r� x� t | j � � D]L } | j � d k r� | j | j � � j � | k r� | j | � q� q� q� Wq_ xK t | j | j � � � D]. } | j � j � | k r� | j | � q� q� Wq_ Wd S( sO Remove all ATTENDEE properties except for the ones specified. R� s Not a calendar: {0!r}R R# R N( Rw Rk Ro R� RF R� R� R� R� R R R Rx RM ( Rv R R R� RG R# ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt removeAllButTheseAttendees s '%!"c C sd | j � j � d k s- t d j | � � � x0 | j � D]" } | j � j � d k r: t Sq: Wt S( sX Test whether the component has a VALARM as an immediate sub-component. R! R" s Not a VEVENT or VTODO: {0!r}R< ( R! R" ( Rw R� Rk Ro R� R� R� ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt hasAlarm s -c C sC d j d d � j | � } y# t j | � } | d k r= t SWn t k rR t SXy* t t | j � � d j � � d } Wn t k r� t SX| j t d d � � t } | j d � } | s� | r?| j � d k r?x` | j � D]O } | j � j � d k r q� n | j � r q� n | j | j � � t } q� Wn | S( su Add an alarm to any VEVENT or VTODO subcomponents that do not already have any. @param alarm: the text for a VALARM component @type alarm: C{str} @param ignoreActionNone: whether or not to skip ACTION:NONE alarms @type ignoreActionNone: C{bool} @return: indicate whether a change was made @rtype: C{bool} s� BEGIN:VCALENDAR VERSION:2.0 PRODID:-//CALENDARSERVER.ORG//NONSGML Version 1//EN BEGIN:VEVENT UID:bogus DTSTART:20110427T000000Z DURATION:PT1H DTSTAMP:20110427T000000Z SUMMARY:bogus {0}END:VEVENT END:VCALENDAR s s i s X-APPLE-DEFAULT-ALARMt TRUER^ t NONER! R" N( R! R" ( t replaceRo R R� Rj R� R R� R� t IndexErrorR� R R� R� Rw RJ R� R� R� ( Rv t alarmt ignoreActionNonet caldataR� t valarmRg t actionR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt addAlarms& s. * c C s | j � d k r< xf | j d t � D] } | j � q% Wn? x< t | j � � D]( } | j � d k rO | j | � qO qO Wd S( s. Remove all Alarms components R� R R< N( Rw R� R� t removeAlarmsR� R ( Rv R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRU _ s c C s� t } | j � d t f k re x� | j � D]3 } | j � d k rI q+ n | j | � p[ | } q+ Wn� t � } x� t | j � � D]q } | j � d k r� | j d � | j d � f } | | k r� | r� | j | � n t } q� | j | � q� q� W| S( sw Test and optionally remove alarms that have the same ACTION and TRIGGER values in the same component. R� R% R< R^ R` ( R% ( R� Rw Rx R� t hasDuplicateAlarmsR� R� R� R R� R� ( Rv R� Rg R� t action_triggerR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRV l s c C s� | r6 x� | j � D] } | j | | d t �q Wnm | j � rF d SxZ t | j � � D]F } | rw | j � | k s� | rY | j � | k rY | j | � qY qY Wd S( sK Remove all properties that do not match the provided set. t do_subcomponentsN( R� t filterPropertiesR� R R� R Rw RM ( Rv Rw t keepRX R� R# ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRY � s 0c C sX xQ t | j � � D]= } | j � j d � r | j � | k r | j | � q q Wd S( sD Remove all X- components except the specified ones s X-N( R� R� Rw t startswithR ( Rv t keep_componentsR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt removeXComponents� s 'c C s8 | rH | j � d k rH x| j � D] } | j | | d t �q% Wn� | j � rX d Sx� t | j � � D]� } | j � j d � } | r� | j � | k r� | j | � qk | sk | j | j � t � � } | j | j d t � � � xB | j � D]1 } | j d � r� | | k r� | j | � q� q� Wqk qk Wd S( sD Remove all X- properties except the specified ones R� RX Ns X-t ( Rw R� t removeXPropertiesR� R R� R R[ RM Rr R� R� R� R� ( Rv t keep_propertiest keep_parametersRX R� R# t xpnamet preserveR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR_ � s c C s� | j � d k rB x� | j d t � D] } | j | | � q% Wn� | j | � } x, | D]$ } x | D] } | j | � qe WqX W| j � d k r� x- | j d t � D] } | j | | � q� Wn d S( s: Remove all specified property parameters R� R R# N( Rw R� R� t removePropertyParametersR R� ( Rv Rp Ry R� R& R' t param( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRd � s c C s� | j � d k rB x� | j d t � D] } | j | | � q% Wn� | j | � } x5 | D]- } x$ | D] \ } } | j | | � qe WqX W| j � d k r� x- | j d t � D] } | j | | � q� Wn d S( s: Remove all specified property parameters R� R R# N( Rw R� R� t removePropertyParametersByValueR R� ( Rv Rp t paramvaluesR� R& R' Re Rx ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRf � s c C sh yC | j d � } | j d d � } | j d � } | j d � } Wn t k rW d SX| | | | f S( s� Get property value details needed to synchronize iTIP components. @return: C{tuple} of (uid, seq, dtstamp, r-id) some of which may be C{None} if property does not exist RX Rc i Rb s RECURRENCE-IDN( NNNN( R� R Rj ( Rv R� t seqt dtstampR ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt getITIPInfo� s c C s9 d t j | � } d t j | � } t j | | | � S( s� Compare synchronization information for two components to see if they match according to iTIP. @param component1: first component to check. @type component1: L{Component} @param component2: second component to check. @type component2: L{Component} @param use_dtstamp: whether DTSTAMP is used in addition to SEQUENCE. @type component2: C{bool} @return: 0, 1, -1 as per compareSyncInfo. N( N( N( Rj R Rj t compareITIPInfo( t component1t component2t use_dtstampt info1t info2( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt compareComponentsForITIP� s c C s� | \ } } } } } | \ } } } } } | | k s< t � | | k rL d S| | k r\ d S| r� | d k r� | d k r� | | k r� d S| | k r� d Sq� | d k r� | d k r� d S| d k r� | d k r� d Sn d S( s Compare two synchronization information records. @param info1: a C{tuple} as returned by L{getSyncInfo}. @param info2: a C{tuple} as returned by L{getSyncInfo}. @return: 1 if info1 > info2, 0 if info1 == info2, -1 if info1 < info2 i i����i N( Rk Rj ( Ro Rp Rn t _ignore_name1t uid1t seq1t dtstamp1t _ignore_rid1t _ignore_name2t uid2t seq2t dtstamp2t _ignore_rid2( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyRk � s$ c C s� x� | j d t � D]| } | j | j � � } | d k r[ | j � } | d k r[ q q[ n | j d d � } | j d d � } | | k r t Sq Wt S( s� Compare this calendar with the old one and indicate whether the current one has SEQUENCE that is always greater than the old. R Rc i N( R� R� R R Rj R R� R� ( Rv t oldcalendarR� t oldcomponentt newseqt oldseq( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt needsiTIPSequenceChange s c C sj | rJ d � } | | d k r$ | n | � d } | j t d | � � n | j t d t j � � � d S( sK Change DTSTAMP and optionally SEQUENCE on all components. c S s8 | j d d d �} | r4 t | d d � �j � Sd S( NRc R) i R� c S s | j � S( N( Rx ( t x( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt <lambda>8 R^ i ( R( R� Rx ( R� t seqs( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt maxSequence6 s i Rc Rb N( Rj R- R R t getNowUTC( Rv R| t doSequenceR� R~ ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt bumpiTIPInfo/ s "c C sY d � } d � } | | � } | | � } | rU | | k rU | j t d | � � n d S( sI Make sure SEQUENCE does not decrease in any components. c S s8 | j d d d �} | r4 t | d d � �j � Sd S( NRc R) i R� c S s | j � S( N( Rx ( R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� I R^ i ( R( R� Rx ( R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� G s c S s8 | j d d d �} | r4 t | d d � �j � Sd S( NRc R) i R� c S s | j � S( N( Rx ( R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� M R^ i ( R( t minRx ( R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt minSequenceK s Rc N( R- R ( Rv R| R� R� R t currentseq( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt sequenceInSyncB s c C sW x%t | j � � D]} t j | j � � } | rC | \ } } n d } i d d 6} xH | j � D]: } | j | � } | | j | � k rc | j | � qc qc Wt | j � � d k r� | d k r� | j � | k r� | j | � q q� n t j | j � � } | r | j | | j � � � q q W| j � x | j � D] } | j � q?Wd S( NR+ R, i ( R� R t normalizePropsRr Rw Rj R� R� R� R! Rx RM t normalizePropsValueR� t normalizeDateTimesR� t normalizeAll( Rv R' R� t default_valuet default_paramsRw Rx t normalize_functionR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� W s( c C s� | j � d k r�| j d � } | j d � } | j d � } t d | j � d | d k ri | j � n d d | d k r� | j � n d � } | j d � r� | j d | j d � � | j d � n | j � j � | d k r/| j d � r | j d | j d � � | j d � n | j � j � n> | d k rm| j | � | j t d | j � j � � � n | j d � } xm | D]e } | j d � r�| j d | j d � � | j d � n x$ | j � D] } | j � j � q�Wq�W| j d � } xm | D]e } | j d � r@| j d | j d � � | j d � n x$ | j � D] } | j � j � qMWqW| j d � } | d k r�| j d � | j | j � j � � q�n d S( s� Normalize various datetime properties into UTC and handle DTEND/DURATION variants in such a way that we can compare objects with slight differences. Also normalize the RRULE value parts. Strictly speaking we should not need to do this as clients should not be messing with these properties - i.e. they should round trip them. Unfortunately some do... R! RB R@ RC R� R� R, RH t _TZIDR\ RY s RECURRENCE-IDN( Rw R" R Rx Rj R� R� R� R� t adjustToUTCRM R� R t getEndR( R R� R� ( Rv R) R+ R, t timeRangeR� R� Rx R9 R: R ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� { sL ! % c C s� | j � d k r? x� | j d t � D] } | j | � q% Wn� x� t | j | � � D]| } t | j � � t k rU t | j � � d k rU | j | � x6 | j � D]% } | j t | | j � g � � q� WqU qU Wd S( s� Convert properties that have a list of values into single properties, to make it easier to do comparisons between two ical objects. R� R i N( Rw R� R� t normalizePropertyValueListsR� R R� Rx Rt R! RM R� R R� ( Rv R� R� R' Rx ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s 0 c C s� | j � d k r< x� | j d t � D] } | j � q% Wn� | j d � } | d k r[ d Sxl t | j d � � D]U } | j d � } | d k rq | j � } | j | � d k r� | j | � q� qq qq Wd S( sH Remove any ATTACH properties that relate to a dropbox. R� R s X-APPLE-DROPBOXNR2 R, R1 i����( NR1 ( Rw R� R� t normalizeAttachmentsR� Rj R� R R� Rx t findRM ( Rv R� t dropboxPrefixt attachmentt valueTypet dataValue( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s c c s8 i } x+| j d t � D]} x�t j | j d � | j d � | j d � � D]�} t | j � � } | | k r� | | | t � V} | | | <n | | \ } } } } | d k r� qP n | j d � } | r d j | � } t j j j r | j d � r d } q q n | j d � } | r>| j d j d | � � nL| ro| j d � ro| j | j d d � � n| j d � s�| j d � r�| r�| } n� d } d } d } d } xx | D]p } | j d � r�| } Pq�| j d � r�| s+| } q+q�| j d � r | s+| } q+q�| s�| } q�q�W| r>| } n3 | rM| } n$ | r\| } n | rk| } n d } | r�| j | � q�n | r�| | k r�| j d | � q�n | j d � | r�| | k s�| d k r�| r�| j d � r | | k r | d } n4 x1 | D]# } | j d � r| d } PqqWd } t j j j ro| ro| j d � rod } qon | r�| j d | � q�| j d � n | | j d � k rP | r�| d k r�t j j r�| d k r�d } n | j d | � q| j d � qP qP W| j � d k r | j | | | � Vq q Wd S( sx Do the ORGANIZER/ATTENDEE property normalization. @param lookupFunction: function returning full name, guid, CUAs for a given CUA @type lookupFunction: L{Function} @param recordFunction: function taking a CUA and returning a record @type recordFunction: L{Function} @param toCanonical: whether to convert to the canonical CUA form (True) or to the mailto: form (False) @type toCanonical: L{bool} @param toURN_UUID: whether to convert to urn:x-uid to urn:uuid: for compatibility with older servers @type toURN_UUID: L{bool} R RV RT Rd t EMAILs mailto:{0}s @do_not_replyt CNs urn:x-uid:{uid}R� s urn:x-uid:s urn:uuid:s mailto:t /s http:i R^ RN RM t GROUPs X-SERVER-GROUPR# N( R� R� Ru Rv R R Rx R Rj R� Ro t Schedulingt Optionst FakeResourceLocationEmailt endswithR� R[ RM R� R� t GroupAttendeest EnabledRw t normalizeCalendarUserAddresses( Rv t lookupFunctiont recordFunctiont toCanonicalt toURN_UUIDt cacheR� R' R R� Rw R� t cutypet cuaddrst oldemailt oldCNt newaddrt first_mailtot first_patht first_httpR� t addrt email( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � s� $ c C s� t } x�| j d t � D]�} t | j d � � } t g | D] } | j � ^ q> � } t � } xb | D]Z } | j � } | | k r� t j d d | d | �| j | � t } n | j | � qi Wx� | D]� } | j d � r� | j d � } | t | � k rp| j � | k r�| j | � t | � d k rd| j | � t j d d | j � d | �n t } q�q�| j � | k r�| j | � t } q�q� q� Wq W| S( sm Make sure there are attendee properties for every member of the group, and no other attendee properties marked as a member of the group. Note that attendee properties already present with a MEMBER parameter are not given a MEMBER parameter if they are in the group. This ensures that manually added attendees are not automatically removed when they dissappear from a group. @param groupCUA: calendar user address of the group @type groupCUA: L{str} @param memberAttendeeProps: list of member properties @type memberAttendeeProps: L{tuple} R RT s& Group reconciliation: Adding {m} ({g})t mt gt MEMBERi s( Group reconciliation: removing {a} ({g})t a( R� R� R� R� R R� Rx R� R� R� R� R� R� Rw R! RM R� ( Rv t groupCUAt memberAttendeePropsRg R� t oldAttendeePropst attendeePropt oldAttendeeCUAst memberCUAst newAttendeePropt memberCUAt memberValues( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt _reconcileGroupAttendeey s4 % " c C sj t } t � } t � } xo | j � D]a \ } } | | j | | � O} | t g | D] } | j � ^ qT � O} | r% | j | � q% q% Wx� | j d t � D]� } x� t | j d � � D]� } | j d � r� | j � } | | k rH| j d � } xc t | � | D]; } | j | � t | � d k r;| j | � n t } qWq^| j | � t } q� q� Wq� W| S( s� Reconcile the attendee properties in this L{Component}. @param groupCUAToAttendeeMemberPropMap: map of group to potential attendees @type groupCUAToAttendeeMemberPropMap: L{dict} R RT R� i ( R� R� t iteritemsR� Rx R� R� R� R� R R� R� Rw R! RM ( Rv t groupCUAToAttendeeMemberPropMapRg t allMemberCUAst nonemptyGroupCUAsR� R� t memberAttendeePropR� R� t attendeeCUAR� t orphanGroupCUA( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt reconcileGroupAttendees� s, ) c C s^ | j d � } | d k rF | j � d k rF | j d � j � rF d S| d k rV d S| Sd S( s� Determine the TRANSP value for this component. Note that for all-day VEVENTs we are going to treat the default as TRANSPARENT and not OPAQUE RG R! RB t TRANSPARENTRF N( R� Rj Rw Rp ( Rv t transp( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt adjustedTransp� s 3c C sO t � } x? | j � D]1 } | j � t k r | j | j t � � q q W| S( N( R� R� Rw Rx R� R� t PERUSER_UID( Rv R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt allPerUserUIDs� s c C s� t | d � s;i | _ x | j � D]} | j � t k r� | j t � } x� | j � D] } | j � t k rY | j d � } | j d � d k } | j d � } | j d � } | | | f | j j | i � | <qY qY Wq% | j � s% | j d � } | j d � d k } | d d f | j j d i � | <q% q% Wn g } x� t | j j � d d � �D]i \ } } | } | | k r�d } n | | k r�| j | | | f � q`| j | t d d f f � q`Wt | � S( Nt _perUserDatas RECURRENCE-IDRG R� s X-APPLE-TRAVEL-DURATIONs X-APPLE-TRAVEL-RETURN-DURATIONR^ R� c S s | d S( Ni ( ( R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� � R^ ( R R� R� Rw Rx R� R� t PERINSTANCE_COMPONENTR� R Rj R� Rs R� R� R� ( Rv R R� R� R� t instanceridR� t adjusted_startt adjusted_endR� t cachedRidst lookupRid( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt perUserData� s2 , ,+ c C sS | j | � } | j d k r" t Sx* | j j � D] } | j | k r2 t Sq2 Wt S( s Determine whether an event exists completely prior to a given moment. @param limit: the moment to compare against. @type limit: L{DateTime} @return: a C{bool}, True if the event has any instances occurring after limit, False otherwise. N( R� R� Rj R� R� t itervaluesR� R� ( Rv R� t instanceListR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt hasInstancesAfter s c C s� | j � d k rW x� | j � D]1 } | j � d k r= q n | j | � r t Sq Wnn t � } xb t | j t � � D]K } | j t � } | | k r� | r� | j | � q� t Sn | j | � qv Wt S( s Test and optionally remove "X-CALENDARSERVER-ATTENDEE-COMMENT" properties that have the same "X-CALENDARSERVER-ATTENDEE-REF" parameter values in the same component. @return: C{True} if there are duplicates that were not fixed. R� R% ( R% ( Rw R� t hasDuplicatePrivateCommentsR� R� R� R t ATTENDEE_COMMENTR� t ATTENDEE_COMMENT_REFRM R� R� ( Rv R� R� t attendee_refsR' t ref( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� s c C s� | j � d k rN x� | j � D]( } | j � d k r= q n | j � q WnN xK t | j t � � D]4 } | j t � sd | j t t j � j � � qd qd Wd S( s� Some clients are leaving out the datestamp from comments; this method adds this parameter where it's missing (using a value of now in UTC) R� R% N( R% ( Rw R� t# repairMissingDatestampsFromCommentsR� R R� R� t DTSTAMP_PARAMR� R R� R ( Rv R� R' ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� 9 s c C s} | j � d k r` d } xA | j � D]3 } | j � d k rC q% n t | | j � � } q% W| St t | j d � � � Sd S( NR� i R% R2 ( R% ( Rw R� R� t maxAttachmentsPerInstanceR! R� R ( Rv t countR� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR� I s ( RX s RECURRENCE-IDRc Rb R= RG RB R@ RC R] R\ R[ RY ( RX s RECURRENCE-IDRc Rb R= RB R? RA RC R] R\ R[ RY ( RX s RECURRENCE-IDRc Rb R= RB R] R\ R[ RY ( RX Rb RB R@ RC RE N( R> R9 ( ( (� Rf Rg R� R t ACCESS_PUBLICt ACCESS_PRIVATEt ACCESS_CONFIDENTIALt ACCESS_RESTRICTEDR Rj t confidentialPropertiesMapt extraRestrictedPropertiest HIDDEN_INSTANCE_PROPERTYR� t classmethodR� R� R� R� R� R� R� R� R� R� R R� R� R� R� R� R� R R R R� R Rw R R R R R R R� R� R� R� R R R" R R� R* R- R/ R1 R3 R R8 R; RC RD RE RK R� RM RN RO RQ R� RR Rn R| R� R R� R� R R� R� R� RS R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R R R R� R R R R R R R R R R R R R R R R# R! R$ R% R( R+ R, R- R. R4 R5 R6 R> R@ RC RE RH RI RJ RT RU RV RY R] R_ Rd Rf Rj t staticmethodRq Rk R� R� R� R� R� R� R� R R� R� R� R� R� R� R� R� R� R� ( ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR d sd #- # ' 8 < g ' % ' j _ � # $ + 9 # $ D � / ( $ c C sI t j | � } d } xE | j � D]" } | j � d k r" | } Pq" q" Wt d j | � � � | j j | | � } g } | j t � | r� | | d d k r| j t | � t | d d � j � f � qn1 | j t | � t | j j | � � j � f � x? | D]7 \ } } } } | j | j � t | � j � f � q W| S( s� Expand a timezone to get onset/utc-offset observance tuples within the specified time range. @param tzdata: the iCalendar data containing a VTIMEZONE. @type tzdata: C{str} @param start: date for the start of the expansion. @type start: C{date} @param end: date for the end of the expansion. @type end: C{date} @return: a C{list} of tuples of (C{datetime}, C{str}) R% s No VTIMEZONE component in {0}i i N( R R� Rj R� Rw R Ro Rq t expandAllR� R� R� R� R R t getTimezoneOffsetSeconds( t tzdataR� R� t icalobjt tzcompt compt tzexpandedR� t tzstartt _ignore_utctzstartt _ignore_tzoffsetfromt tzoffsetto( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyR Y s& 31 c C se t d d | �} d } xE | j � D]" } | j � d k r% | } Pq% q% Wt d j | � � � | j j | | d t �} g } | j t � | r� | | d d k r | j | | d d | d d | d d f � q n= | j | | j j | � | j j | � | j j | � f � xB | D]: \ } } } } } | j | rJ| n | | | | f � q#W| S( s� Expand a timezone to get onset(local)/utc-offset-from/utc-offset-to/name observance tuples within the specified time range. @param tzdata: the iCalendar data containing a VTIMEZONE. @type tzdata: L{Calendar} @param start: date for the start of the expansion. @type start: C{date} @param end: date for the end of the expansion. @type end: C{date} @param utc_onset: whether or not onset values are in UTC. @type utc_onset: C{bool} @return: a C{list} of tuples Rh R% s No VTIMEZONE component in {0}t with_namei i i N( R Rj R� Rw R Ro Rq R� R� R� R� R� R� t getTimezoneDescriptor( R� R� R� t utc_onsetR� R� R� R� R� R� t utctzstartt tzoffsetfromR� Rw ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt tzexpandlocal� s: c c s� | t | � | t � V\ } } } } | rJ | r�t d j | � � q�n7| rx | j d � rx t | j d d � � n | j d � s� | j d � r�d } d } d } d } xx | D]p } | j d � r� | } Pq� | j d � r� | s%| } q%q� | j d � r| s%| } q%q� | s� | } q� q� W| r8| } n3 | rG| } n$ | rV| } n | re| } n d } | r�t | � q�n t | � d S( Ns urn:x-uid:{0}s urn:x-uid:s urn:uuid:s mailto:R� s http:( R R R Ro R[ RM Rj ( R R� R� R� R� t _ignore_nameR� t _ignore_cuTypeR� R� R� R� R� R� R� ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt normalizeCUAddress� sF % c g s� g } x? | D]7 } t | � } x" | D] } | j | | f � Pq& Wq Wt j | � xT | r� | d \ } } | Vx2 | D] } t j | | | f � Pqz Wt j | � qX Wd S( s� Merge sorted iterables into one sorted iterable. @param iterables: arguments are iterables which yield items in sorted order. @return: an iterable of all items generated by every iterable in C{iterables} in sorted order. i N( t iterR� t heapqt heapifyt heapreplacet heappop( t iterablest heapt iterablet iteratorRx ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt merge s s! ATTENDEE;X-CALENDARSERVER-DTSTAMPs( ATTENDEE;X-CALENDARSERVER-RESET-PARTSTATc C s] t | � j d d � } | j d d � } g | j � D] } | j d � s7 | ^ q7 } x� | D]� } | j d � \ } } x� t | � D]� \ } } | j | d � r� | j d j | � � } | d k r>| | t | � d } | j d � } | d k r| j d � } n | | | | t | � d | | | <q>q� q� Wq_ Wd j | � } | d S( sR Normalize a string representation of ical data for easy test comparison. s R^ s Rb t ;s ;{}=i����i t :s ( R� RM t splitlinesR[ t splitR� R� Ro R! R� ( t icalstrt filter_paramst linet linesRe R� R� R� t post next_segmentt end_pos( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt normalize_iCalStr s . 6c C s: t | � j � } t | � j � } d j t | | � � S( Ns ( R R R� R ( t icalstr1t icalstr2( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt diff_iCalStrs/ s (\ R� t __all__R� R� t difflibR R Ru R� t twisted.internet.deferR R t twext.python.logR t txweb2.streamR t txweb2.dav.utilR t twistedcaldav.accountingR R t twistedcaldav.configR t twistedcaldav.dateopsR R R R t twistedcaldav.instanceR R t twistedcaldav.timezonesR t' txdav.caldav.datastore.scheduling.utilsR t pycalendar.icalendarR t pycalendar.parameterR t pycalendar.icalendar.calendarR t pycalendar.icalendar.componentR R� t pycalendar.componentbaseR t pycalendar.datetimeR t pycalendar.durationR t pycalendar.exceptionsR t pycalendar.periodR t pycalendar.icalendar.propertyR Rm t pycalendar.timezoneR t pycalendar.utcoffsetvalueR R� R R& R' R R) Rx R� R� t PRIVATE_COMMENTR� R� R� Rj R� R� R t UTCTimezonet minDateTimet maxDateTimeR R t objectR R� R R� R R R R ( ( ( s% /opt/cpanel-ccs/twistedcaldav/ical.pyt <module> s " $$�� � � � � � � � � � � � � , ><