OwlCyberSecurity - MANAGER
Edit File: idav.pyc
� �t�ac @ sl d Z d d d d d d d d d d g Z d d l m Z m Z d d l m Z d d l m Z m Z d d l m Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S( s WebDAV interfaces t PropertyStoreErrort PropertyChangeNotAllowedErrort IPropertyNamet IPropertyStoret IDataStoret IDataStoreObjectt ITransactiont INotifiert IStoreNotifierFactoryt IStoreNotifieri����( t Attributet Interface( t IMapping( t Valuest ValueConstant( t PushPriorityc B s e Z d Z RS( s Property store error. ( t __name__t __module__t __doc__( ( ( s /opt/cpanel-ccs/txdav/idav.pyR - s c B s e Z d Z d � Z RS( s$ Property cannot be edited. c C s t j | | � | | _ d S( N( R t __init__t keys( t selft messageR ( ( s /opt/cpanel-ccs/txdav/idav.pyR 8 s ( R R R R ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR 3 s c B s/ e Z d Z e d � Z e d � Z d � Z RS( s Property name. t Namespacet Namec C s d S( sd Returns the string representation of the property name. @return: a string N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt toStringH t ( R R R R t namespacet nameR ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR A s c B s e Z d Z d � Z d � Z RS( s2 WebDAV property store This interface is based on L{IMapping}, but any changed to data are not persisted until C{flush()} is called, and can be undone using C{abort()}. Also, keys must be L{IPropertyName} providers and values must be L{txweb2.element.dav.base.WeDAVElement}s. c C s d S( sD Flush the property store. @return: C{None} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt flush^ R c C s d S( sO Abort changes to the property store. @return: C{None} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt abortd R ( R R R R R ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR P s c B s# e Z d Z d d � Z d � Z RS( s8 An L{IDataStore} is a storage of some objects. c C s d S( sY Create a new transaction. @param label: A label to assign to this transaction for diagnostic purposes. @type label: C{str} @return: a new transaction which provides L{ITransaction}, as well as sub-interfaces to request appropriate data objects. @rtype: L{ITransaction} N( ( t label( ( s /opt/cpanel-ccs/txdav/idav.pyt newTransactionp R c C s d S( s� Set the "migrating" state to either True or False. This state is used to supress push notifications and etag changes. @param state: the boolean value to set the migrating state to @type state: C{boolean} N( ( t state( ( s /opt/cpanel-ccs/txdav/idav.pyt setMigrating~ R N( R R R t NoneR R" ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR k s c B sM e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( sL An L{IDataStoreObject} are the objects stored in an L{IDataStore}. c C s d S( ss Identify the name of the object @return: the name of this object. @rtype: C{str} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR � R c C s d S( sX The content type of the object's content. @rtype: L{MimeType} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt contentType� R c C s d S( sV The MD5 hex digest of this object's content. @rtype: C{str} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt md5� R c C s d S( sR The octet-size of this object's content. @rtype: C{int} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt size� R c C s d S( sV The creation date-time stamp of this object. @rtype: C{int} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt created� R c C s d S( s_ The last modification date-time stamp of this object. @rtype: C{int} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt modified� R c C s d S( sf Retrieve the property store for this object. @return: an L{IPropertyStore}. N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt properties� R ( R R R R R$ R% R& R' R( R) ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR � s c B s; e Z d Z d � Z d � Z d � Z d � Z d � Z RS( s[ Transaction that can be aborted and either succeeds or fails in its entirety. c C s d S( s� Abort this transaction. @raise AlreadyFinishedError: The transaction was already finished with an 'abort' or 'commit' and cannot be aborted again. N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR � R c C s d S( s� Perform this transaction. @raise AlreadyFinishedError: The transaction was already finished with an 'abort' or 'commit' and cannot be committed again. N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt commit� R c C s d S( s7 @see: L{IAsyncTransaction.postCommit} N( ( t operation( ( s /opt/cpanel-ccs/txdav/idav.pyt postCommit� R c C s d S( s6 @see: L{IAsyncTransaction.postAbort} N( ( R+ ( ( s /opt/cpanel-ccs/txdav/idav.pyt postAbort� R c C s d S( sd The store that this transaction was initiated from. @rtype: L{IDataStore} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt store� R ( R R R R R* R, R- R. ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR � s t ChangeCategoryc B sJ e Z d Z e e j � Z e e j � Z e e j � Z e e j � Z RS( s� Constants to use for notifyChanged's category parameter. Maps types of changes to the appropriate push priority level. TODO: make these values configurable in plist perhaps. ( R R R R R t hight defaultt mediumt inboxt attendeeITIPUpdatet organizerITIPUpdate( ( ( s /opt/cpanel-ccs/txdav/idav.pyR/ � s c B s> e Z d Z e d � Z d � Z d � Z d � Z d � Z RS( s� Interface for an object that can send change notifications. Notifiers are associated with specific notifier factories and stored in a dict with keys matching the factory name. s5 Dict of L{IStoreNotifier}'s to send notifications to.c C s d S( s Add an L{IStoreNotifier} to the list of notifiers for this object. @param factory_name: the "type" of notifier based on its factory name @type factory_name: C{str} @param notifier: the notifier @type notifier: L{IStoreNotifier} N( ( t factory_namet notifier( ( s /opt/cpanel-ccs/txdav/idav.pyt addNotifier� R c C s d S( s! Return a notifier for the specified factory name if it exists. @param factory_name: the factory name for a notifier to look for. @type factory_name: C{str} @return: the notifier if found, else C{None} @rtype: L{IStoreNotifier} or C{None} N( ( R6 ( ( s /opt/cpanel-ccs/txdav/idav.pyt getNotifier R c C s d S( s� Send a change notification to any notifiers assigned to the object. @param category: the kind of change triggering this notification @type: L{ChangeCategory} N( ( t category( ( s /opt/cpanel-ccs/txdav/idav.pyt notifyChanged R c C s d S( s7 Return a notification id. This is a tuple of two C{str}'s. The first item is the overall service type "CalDAV" or "CardDAV". The second is the object identifier. For a home that is the home's ownerUID, for a home child the ownerUID/name. @return: a tuple of two C[str} N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt notifierID R ( R R R R t _notifiersR8 R9 R; R< ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR � s c B s# e Z d Z e d � Z d � Z RS( s� A factory class for a particular type of store notification. App-layer clients of the store may need to be notified of changes happening to objects in the store, and act in a particular way when such changes occur (e.g., send a push notification, invalidate an app-layer cache etc). To do that they create a class for the interface defined here and pass that in when the store itself is created. When the store creates a home object, it will pass in the list of factories and the home will instantiate an L{IStoreNotifier} to use for sending notifications. Home child resources "inherit" notifiers from their home parent using the IStoreNotifier.clone() method - object resources do not have notifiers. s. The store associated with the notifier factoryc C s d S( s� Generate a notifier for the corresponding store object. @param storeObject: the store object. @type storeObject: L{CommonHome} or L{CommonHomeChild} N( ( t storeObject( ( s /opt/cpanel-ccs/txdav/idav.pyt newNotifier0 R ( R R R R R. R? ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR # s c B s, e Z d Z e d � Z d � Z d � Z RS( s� A notifier provided by the app-layer through an L{IStoreNotifierFactory} that the store uses to indicate a change to a store home or home child object. sR The store object associated with the notifier: L{CommonHome} or L{CommonHomeChild}c C s d S( s^ Called by the store when the object associated with the notifier is changed. N( ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt notifyA R c C s d S( st Called by the store when a home child is created and used to give the home child a notifier "inherited" from the home. @param label: a new label to use for the home child. @type label: C{str} @param storeObject: the store object associated with the notifier. @type storeObject: L{CommonHome} or L{CommonHomeChild} N( ( R> ( ( s /opt/cpanel-ccs/txdav/idav.pyt cloneF R ( R R R R t _storeObjectR@ RA ( ( ( s /opt/cpanel-ccs/txdav/idav.pyR 9 s N( R t __all__t zope.interfaceR R t zope.interface.common.mappingR t twisted.python.constantsR R t calendarserver.push.ipushR t RuntimeErrorR R R R R R R R/ R R R ( ( ( s /opt/cpanel-ccs/txdav/idav.pyt <module> s2 8( /