"jsdZddlZddlZddlZddlZddlmZmZddlm Z ddl m Z m Z ddl mZmZddlmZmZmZmZmZddlmZd Zej2eZgd Zd d gZGd deZGddeZGddeZ GddeZ!y)a= Abstract base class for DAV resource providers. This module serves these purposes: 1. Documentation of the DAVProvider interface 2. Common base class for all DAV providers 3. Default implementation for most functionality that a resource provider must deliver. If no default implementation can be provided, then all write actions generate FORBIDDEN errors. Read requests generate NOT_IMPLEMENTED errors. **_DAVResource, DAVCollection, DAVNonCollection** Represents an existing (i.e. mapped) WebDAV resource or collection. A _DAVResource object is created by a call to the DAVProvider. The resource may then be used to query different attributes like ``res.name``, ``res.is_collection``, ``res.get_content_length()``, and ``res.support_etag()``. It also implements operations, that require an *existing* resource, like: ``get_preferred_path()``, ``create_collection()``, or ``get_property_value()``. Usage:: res = provider.get_resource_inst(path, environ) if res is not None: print(res.getName()) **DAVProvider** A DAV provider represents a shared WebDAV system. There is only one provider instance per share, which is created during server start-up. After that, the dispatcher (``request_resolver.RequestResolver``) parses the request URL and adds it to the WSGI environment, so it can be accessed like this:: provider = environ["wsgidav.provider"] The main purpose of the provider is to create _DAVResource objects for URLs:: res = provider.get_resource_inst(path, environ) **Supporting Objects** The DAVProvider takes two supporting objects: propertyManager An object that provides storage for dead properties assigned for webDAV resources. PropertyManagers must provide the methods as described in ``wsgidav.interfaces.propertymanagerinterface`` See prop_man.property_manager.PropertyManager for a sample implementation using shelve. lockManager An object that implements locking on webDAV resources. It contains an instance of ``LockStorageDict`` lockStorage An object that provides storage for locks made on webDAV resources. LockStorages must provide the methods as described in ``wsgidav.interfaces.lockmanagerinterface`` See lock_storage for a sample implementation using shelve. See :doc:`reference_guide` for more information about the WsgiDAV architecture. N)ABCabstractmethod)Optional)quoteunquote)util xml_tools)HTTP_FORBIDDENHTTP_NOT_FOUNDDAVError#PRECONDITION_CODE_ProtectedProperty as_DAVError)etreereStructuredText){DAV:}creationdate{DAV:}displayname{DAV:}getcontenttype{DAV:}resourcetype{DAV:}getlastmodified{DAV:}getcontentlength {DAV:}getetagz{DAV:}getcontentlanguage{DAV:}lockdiscovery{DAV:}supportedlockceZdZdZdededefdZdZe de e fdZ de efd Z de efd Zd Zdefd Zd ZdZde e fdZde e fdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dddd dd!d"Z#d#Z$d$d%d&Z%d'Z&dd(d)Z'd*Z(d+Z)d,Z*d-Z+d.Z,d/Z-d0Z.d$d1d2Z/d3Z0d4Z1d5Z2d6Z3d7Z4d8Z5d9Z6d:Z7d;Z8d<Z9d=Z:y$)> _DAVResourceaARepresents a single existing DAV resource instance. A resource may be a collection (aka 'folder') or a non-collection (aka 'file'). _DAVResource is the common base class for the specialized classes:: _DAVResource +- DAVCollection \- DAVNonCollection Instances of this class are created through the DAVProvider:: res = provider.get_resource_inst(path, environ) if res and res.is_collection(): print(res.get_display_name()) In the example above, res will be ``None``, if the path cannot be mapped to an existing resource. The following attributes and methods are considered 'cheap':: res.path res.provider res.name res.is_collection res.environ Querying other attributes is considered 'expensive' and may be delayed until the first access. get_content_length() get_content_type() get_creation_date() get_display_name() get_etag() get_used_bytes() get_available_bytes() get_last_modified() support_ranges() support_etag() support_modified() support_content_length() These functions return ``None``, if the property is not available, or not supported. See also DAVProvider.get_resource_inst(). path is_collectionenvironctj|sJ|dk(s|jdsJ|d|_||_||_||_tj|j|_y)N/zwsgidav.provider) ris_str startswithproviderrrr get_uri_namename)selfrrrs C/srv/dav/.venv/lib/python3.12/site-packages/wsgidav/dav_provider.py__init__z_DAVResource.__init__se{{4   rzT__S111%,-?%@  #0$ **4995 cN|jjd|jdS)N()) __class____name__rr's r(__repr__z_DAVResource.__repr__s$..))*!DII=::r*returnc(|jryt)a9Contains the Content-Length header returned by a GET without accept headers. The getcontentlength property MUST be defined on any DAV compliant resource that returns the Content-Length header in response to a GET. This method MUST be implemented by non-collections only. NrNotImplementedErrorr0s r(get_content_lengthz_DAVResource.get_content_length   !!r*c(|jryt)aContains the Content-Type header returned by a GET without accept headers. This getcontenttype property MUST be defined on any DAV compliant resource that returns the Content-Type header in response to a GET. See http://www.webdav.org/specs/rfc4918.html#PROPERTY_getcontenttype This method MUST be implemented by non-collections only. Nr4r0s r(get_content_typez_DAVResource.get_content_typer7r*cy)afRecords the time and date the resource was created. The creationdate property should be defined on all DAV compliant resources. If present, it contains a timestamp of the moment when the resource was created (i.e., the moment it had non-null state). This method SHOULD be implemented, especially by non-collections. Nr0s r(get_creation_datez_DAVResource.get_creation_datesr*c |jsJy)aReturn a list of dictionaries with information for directory rendering. This default implementation return None, so the dir browser will traverse all members. This method COULD be implemented for collection resources. N)rr0s r(get_directory_infoz_DAVResource.get_directory_infos!!!!r*c|jS)aProvides a name for the resource that is suitable for presentation to a user. The displayname property should be defined on all DAV compliant resources. If present, the property contains a description of the resource that is suitable for presentation to a user. This default implementation returns `name`, which is the last path segment. )r&r0s r(get_display_namez_DAVResource.get_display_namesyyr*c|jrddiStj|jvrO|jj tjdj }t |dkrd|diSddiS)zReturn additional info dictionary for displaying (optional). This information is not part of the DAV specification, but meant for use by the dir browser middleware. This default implementation returns ``{'type': '...'}`` type Directoryz-FileFile)rosextsepr&splitupperlen)r'exts r(get_display_infoz_DAVResource.get_display_infoss   K( ( YY$)) #))//")),R0668C3x!|3%u ..r*cy)z See http://www.webdav.org/specs/rfc4918.html#PROPERTY_getetag This method SHOULD be implemented, especially by non-collections. Nr;r0s r(get_etagz_DAVResource.get_etag r*cy)zReturn used bytes of the DAV collection. See http://www.webdav.org/specs/rfc4331.html#quota-used-bytes This method COULD be implemented for collection resources. Nr;r0s r(get_used_bytesz_DAVResource.get_used_bytesrPr*cy)zReturn available bytes of the DAV collection. See http://www.webdav.org/specs/rfc4331.html#quota-available-bytes This method COULD be implemented for collection resources. Nr;r0s r(get_available_bytesz _DAVResource.get_available_bytes"rPr*cy)aContains the Last-Modified header returned by a GET method without accept headers. Return None, if this live property is not supported. Note that the last-modified date on a resource may reflect changes in any part of the state of the resource, not necessarily just a change to the response to the GET method. For example, a change in a property may cause the last-modified date to change. The getlastmodified property MUST be defined on any DAV compliant resource that returns the Last-Modified header in response to a GET. This method SHOULD be implemented, especially by non-collections. Nr;r0s r(get_last_modifiedz_DAVResource.get_last_modified*sr*cyNFr;r0s r(is_linkz_DAVResource.is_link;r*ct)z@Set last modified time for destPath to timeStamp on epoch-formatr5)r' dest_path time_stampdry_runs r(set_last_modifiedz_DAVResource.set_last_modified>!!r*ct)zReturn True, if this non-resource supports Range on GET requests. This method MUST be implemented by non-collections only. r\r0s r(support_rangesz_DAVResource.support_rangesB "!r*c&|jduS)zReturn True, if this resource supports Content-Length. This default implementation checks `self.get_content_length() is None`. N)r6r0s r(support_content_lengthz#_DAVResource.support_content_lengthIs &&(44r*ct)z-Return True, if this resource supports ETags.r\r0s r( support_etagz_DAVResource.support_etagPrar*c&|jduS)zReturn True, if this resource supports last modified dates. This default implementation checks `self.get_last_modified() is None`. N)rVr0s r(support_modifiedz_DAVResource.support_modifiedVs %%'t33r*c|jdvry|jr*|jjds|jdzS|jS)aReturn preferred mapping for a resource mapping. Different URLs may map to the same resource, e.g.: '/a/b' == '/A/b' == '/a/b/' get_preferred_path() returns the same value for all these variants, e.g.: '/a/b/' (assuming resource names considered case insensitive) @param path: a UTF-8 encoded, unquoted byte string. @return: a UTF-8 encoded, unquoted byte string. r r!r!)rrendswithr0s r(get_preferred_pathz_DAVResource.get_preferred_path]sG 99 !   dii&8&8&=99s? " yyr*cbt|jj|jzS)aReturn the quoted, absolute, unique URL of a resource, relative to appRoot. Byte string, UTF-8 encoded, quoted. Starts with a '/'. Collections also have a trailing '/'. This is basically the same as get_preferred_path, but deals with 'virtual locations' as well. e.g. '/a/b' == '/A/b' == '/bykey/123' == '/byguid/abc532' get_ref_url() returns the same value for all these URLs, so it can be used as a key for locking and persistence storage. DAV providers that allow virtual-mappings must override this method. See also comments in DEVELOPERS.txt glossary. )rr$ share_pathrnr0s r( get_ref_urlz_DAVResource.get_ref_urlts'$T]]--0G0G0IIJJr*cd}t|jj|jjz|j z|S)a*Convert path to a URL that can be passed to XML responses. Byte string, UTF-8 encoded, quoted. See http://www.webdav.org/specs/rfc4918.html#rfc.section.8.3 We are using the path-absolute option. i.e. starting with '/'. URI ; See section 3.2.1 of [RFC2068] z /!*'(),$-_|.)safe)rr$ mount_pathrprn)r'rss r(get_hrefz_DAVResource.get_hrefsK( MM $ $mm&& '%%' (   r*ctzReturn child resource with a given name (None, if not found). This method COULD be overridden by a derived class, for performance reasons. This default implementation calls self.provider.get_resource_inst(). r\r'r&s r( get_memberz_DAVResource.get_member "!r*c|jstg}|jD](}|j|}|J|j |*|S)zReturn a list of direct members (_DAVResource or derived objects). This default implementation calls self.get_member_names() and self.get_member() for each of them. A provider COULD overwrite this for performance reasons. )rr5get_member_namesryappend)r' memberListr&members r(get_member_listz_DAVResource.get_member_lists`!!% % ))+ &D__T*F% %%   f % &r*ct)zReturn list of (direct) collection member names (UTF-8 byte strings). Every provider MUST provide this method for collection resources. r\r0s r(r|z_DAVResource.get_member_namesrdr*TFinfinity collections resources depth_firstdepthadd_selfc |dvsJg}|r|s|j||dk7r|jr|jD]}|s|j|xr |jxs|xr |j }|r|s|j||jr*|dk(r%|j|j ||||d|s|s|j||r|r|j||S)acReturn a list _DAVResource objects of a collection (children, grand-children, ...). This default implementation calls self.get_member_list() recursively. This function may also be called for non-collections (with add_self=True). :Parameters: depth_first : bool use , to list containers before content. (e.g. when moving / copying branches.) Use , to list content before containers. (e.g. when deleting branches.) depth : string '0' | '1' | 'infinity' )01rrrFr)r}rrextendget_descendants) r'rrrrrreschildwants r(rz_DAVResource.get_descendantss2.... K JJt  CJJ--(3&/(3"'%* .KJJu%' &(  JJt  r*cg}|jd|j|jd|j|jrJ|jd|j |jd|j |jd|j |jd|j|jd|j|jd|j|jd |jjr%|js|jt|jjrO|j!}|j|jjj#||j$|S) aReturn list of supported property names in Clark Notation. Note that 'allprop', despite its name, which remains for backward-compatibility, does not return every property, but only dead properties and the live properties defined in RFC4918. This default implementation returns a combination of: - Supported standard live properties in the {DAV:} namespace, if the related getter method returns not None. - {DAV:}lockdiscovery and {DAV:}supportedlock, if a lock manager is present - If a property manager is present, then a list of dead properties is appended A resource provider may override this method, to add a list of supported custom live property names. rrrr{DAV:}quota-used-bytes{DAV:}quota-available-bytesrrr)r}r<r6rr9rRrTrVr@rOr$ lock_managerprevent_lockingr_lockPropertyNames prop_managerrqget_propertiesr)r' is_allprop propNameListrefUrls r(get_property_namesz_DAVResource.get_property_names s( 01  ! ! # /    4 5  " " $ 0)) ))    8 9  " .    6 7    ,    8 9  # # % 1    = >  ! ! # /    7 8  " .    3 4 ==? &    0 == % %d.B.B.D    2 3 == % %%%'F    **99&$,,O r*N) name_listc|dvsJ|dvr|J|j|dk(}n|Jg}|dk(}|D]=} |r|j|dfn$|j|}|j||f?|S#t$r}|j||fYd}~cd}~wt$rc}|j|t |f|j jdk\r$tjdtjYd}~d}~wwxYw) aReturn properties as list of 2-tuples (name, value). If mode is 'name', then None is returned for the value. name the property name in Clark notation. value may have different types, depending on the status: - string or unicode: for standard property values. - etree.Element: for complex values. - DAVError in case of errors. - None: if mode == 'name'. @param mode: "allprop", "name", or "named" @param name_list: list of property names in Clark Notation (required for mode 'named') This default implementation basically calls self.get_property_names() to get the list of names, then call self.get_property_value on each of them. )allpropr&named)rr&Nr)rr& ) rr}get_property_valuer Exceptionrr$verbose traceback print_excsysstdout)r'moderpropList namesOnlyr&valuees r(rz_DAVResource.get_propertiesBs(3333 & &$ $$//49;L/MI( ((FN  8D 8OOT4L1 33D9EOOT5M2 8 +q ** 8{1~ 67==((A-''CJJ7 8s$:A44 D=B D!AC??Dc ~ |j}|jj}|r)|dk(r#|j|}t j |}|D]}t j |d}t j |d}t j |djd|dt j |d} t j | djd|d|d t j |d _|d r)tj|d } |j| |d } | d krd} n1|d} dtt| tjz z} | t j |d_t j |d} |dt j | d_|jj|d}|jj!||j"}|j%}t j |d}|t j |d_|S|r|dk(rt j |}t j |d}t j |d} t j | dt j |d}t j |dt j |d}t j |d} t j | dt j |d}t j |d|S|j'dr|dk(r3|j)#t+j,|j)S|dk(r |j/|j/S|dk(r:|j0r-t j |}t j |d|Sy |d!k(r|j3S|d"k(r|j5S|d#k(r3|j7#t+j8|j7S|d$k(r)|j;t|j;S|d%k(r |j=|j=S|d&k(r |j?|j?StAtB|jjD}|r4|jG|||j"}|tj|StAtB)'aReturn the value of a property. name: the property name in Clark notation. return value: may have different types, depending on the status: - string or unicode: for standard property values. - lxml.etree.Element: for complex values. If the property is not available, a DAVError is raised. This default implementation handles ``{DAV:}lockdiscovery`` and ``{DAV:}supportedlock`` using the associated lock manager. All other *live* properties (i.e. name starts with ``{DAV:}``) are delegated to the self.xxx() getters. Finally, other properties are considered *dead*, and are handled by the associated property manager. rz{DAV:}activelockz{DAV:}locktypez{}{}{DAV:}rBz{DAV:}lockscopescoperz {DAV:}depthownertimeoutrInfiniteexpirezSecond-z {DAV:}timeoutz{DAV:}locktokentokenz {DAV:}hrefrootz{DAV:}lockrootrz{DAV:}lockentryz{DAV:}exclusivez {DAV:}writez {DAV:}sharedrrrz{DAV:}collectionr rrrrrr)$rqr$rget_url_lock_listrElement SubElementformattextr string_to_xmlr}strinttimeref_url_to_pathget_resource_instrrur#r<rget_rfc3339_timer9rrRrTrVget_rfc1123_timer6rOr@r r r get_property)r'r&rlmactivelocklistlockdiscoveryELlock activelockEL locktypeEL lockscopeELownerELrr locktokenELlockPathlockReslockHref lockrootELsupportedlockEL lockentryELresourcetypeELpmrs r(rz_DAVResource.get_property_valuers,!!#]] ' ' $// 11&9N#mmD1O&( K$//AST "--l* *]] ' ' OOFD$,,?E  ..u55~&&r*r_cJ|tj|sJ|tvrttt |j d}|jdg}|jdrH|tvr@||vr<|dvr) |j|j|j|Stt|jd r|j jd d }t!j"|d d }|jdd}|r?d|vr;d|vr(|j|j|j|Sd|vry d|vry d|vry |j$j&} | ru|jdsd|j)} || j+| |||j St-j.|}| j1| ||||j Stt#t$r4tjd|jdYttwxYw)aSet a property value or remove a property. value == None means 'remove property'. Raise HTTP_FORBIDDEN if property is read-only, or not supported. When dry_run is True, this function should raise errors, as in a real run, but MUST NOT change any data. This default implementation - raises HTTP_FORBIDDEN, if trying to modify a locking property - raises HTTP_FORBIDDEN, if trying to modify an immutable {DAV:} property - handles Windows' Win32LastModifiedTime to set the getlastmodified property, if enabled - stores everything else as dead property, if a property manager is present. - raises HTTP_FORBIDDEN, else Removing a non-existing prop is NOT an error. Note: RFC 4918 states that {DAV:}displayname 'SHOULD NOT be protected' A resource provider may override this method, to update supported custom live properties. ) err_conditionwsgidav.configmutable_live_propsr)rz{DAV:}last_modifiedrz/Provider does not support set_last_modified on .z{urn:schemas-microsoft-com:}HTTP_USER_AGENTNonehotfixesT)as_dictemulate_win32_lastmodFz MiniRedir/6.1Win32LastModifiedTimeWin32FileAttributesWin32CreationTimeWin32LastAccessTime)r is_etree_elementrr r r rgetr#_standardLivePropNamesr`rrr_loggerwarningrget_dict_valuer$rrqremove_propertyrtostringwrite_property) r'r&rr_configmutableLivePropsagentr win32_emurrs r(set_property_valuez_DAVResource.set_property_values%6} : :5 AAA % %.Q  ./!::&:B? OOH %..((GG11 5::w2>* * ??9 :LL$$%6?E**6:tLH %* * s:'G%%,H"!H"c|jjr?|jjj|j|jyy)z&Remove all associated dead properties.N)r$rremove_propertiesrqrr' recursives r(remove_all_propertiesz"_DAVResource.remove_all_properties\s> == % % MM & & 8 8  "DLL  &r*cy)zReturn True, to prevent locking. This default implementation returns ``False``, so standard processing takes place: locking (and refreshing of locks) is implemented using the lock manager, if one is configured. Fr;r0s r(rz_DAVResource.prevent_lockingesr*c|jjy|jjj|jS)zReturn True, if URI is locked.F)r$r is_url_lockedrqr0s r( is_lockedz_DAVResource.is_lockedns9 == % % -}}))778H8H8JKKr*c|jjr6|jjj|j|yy)N)r)r$rremove_all_locks_from_urlrqrs r(remove_all_locksz_DAVResource.remove_all_locksts@ == % % MM & & @ @  "i A  &r*c<|jsJttaCreate and return an empty (length-0) resource as member of self. Called for LOCK requests on unmapped URLs. Preconditions (to be ensured by caller): - this must be a collection - must not exist - there must be no conflicting locks Returns a DAVResuource. This method MUST be implemented by all providers that support write access. This default implementation simply raises HTTP_FORBIDDEN. rr r rxs r(create_empty_resourcez"_DAVResource.create_empty_resource|s"!!!!~&&r*c<|jsJttaCreate a new collection as member of self. Preconditions (to be ensured by caller): - this must be a collection - must not exist - there must be no conflicting locks This method MUST be implemented by all providers that support write access. This default implementation raises HTTP_FORBIDDEN. rrxs r(create_collectionz_DAVResource.create_collection!!!!~&&r*c*|jrJt)a Open content as a stream for reading. Returns a file-like object / stream containing the contents of the resource specified. The calling application will close() the stream. This method MUST be implemented by all providers. r4r0s r( get_contentz_DAVResource.get_contents%%%%!!r* content_typec<|jrJttzOpen content as a stream for writing. This method MUST be implemented by all providers that support write access. rr'r s r( begin_writez_DAVResource.begin_writes %%%%~&&r*cyzhCalled when PUT has finished writing. This is only a notification that MAY be handled. Nr;r' with_errorss r( end_writez_DAVResource.end_writes r*cy)aHandle a DELETE request natively. This method is called by the DELETE handler after checking for valid request syntax and making sure that there are no conflicting locks and If-headers. Depending on the return value, this provider can control further processing: False: handle_delete() did not do anything. WsgiDAV will process the request by calling delete() for every resource, bottom-up. True: handle_delete() has successfully performed the DELETE request. HTTP_NO_CONTENT will be reported to the DAV client. List of errors: handle_delete() tried to perform the delete request, but failed completely or partially. A list of errors is returned like ``[ (, ), ... ]`` These errors will be reported to the client. DAVError raised: handle_delete() refuses to perform the delete request. The DAVError will be reported to the client. An implementation may choose to apply other semantics and return True. For example deleting '/by_tag/cool/myres' may simply remove the 'cool' tag from 'my_res'. In this case, the resource might still be available by other URLs, so locks and properties are not removed. This default implementation returns ``False``, so standard processing takes place. Implementation of this method is OPTIONAL. Fr;r0s r( handle_deletez_DAVResource.handle_deleteFr*c*|jsJt)zReturn True, if delete() may be called on non-empty collections (see comments there). This method MUST be implemented for collections (not called on non-collections). r4r0s r(support_recursive_deletez%_DAVResource.support_recursive_deletes!!!!!!r*ct)aRemove this resource (recursive). Preconditions (ensured by caller): - there are no conflicting locks or If-headers - if support_recursive_delete() is False, and this is a collection, all members have already been deleted. When support_recursive_delete is True, this method must be prepared to handle recursive deletes. This implies that child errors must be reported as tuple list [ (, ), ... ]. See http://www.webdav.org/specs/rfc4918.html#delete-collections This function - removes this resource - if this is a non-empty collection, also removes all members. Note that this may only occur, if support_recursive_delete is True. - For recursive deletes, return a list of error tuples for all failed resource paths. - removes associated direct locks - removes associated dead properties - raises HTTP_FORBIDDEN for read-only resources - raises HTTP_INTERNAL_ERROR on error This method MUST be implemented by all providers that support write access. r\r0s r(deletez_DAVResource.deletes :"!r*cy)aHandle a COPY request natively. This method is called by the COPY handler after checking for valid request syntax and making sure that there are no conflicting locks and If-headers. Depending on the return value, this provider can control further processing: False: handle_copy() did not do anything. WsgiDAV will process the request by calling copy_move_single() for every resource, bottom-up. True: handle_copy() has successfully performed the COPY request. HTTP_NO_CONTENT/HTTP_CREATED will be reported to the DAV client. List of errors: handle_copy() tried to perform the copy request, but failed completely or partially. A list of errors is returned like ``[ (, ), ... ]`` These errors will be reported to the client. DAVError raised: handle_copy() refuses to perform the copy request. The DAVError will be reported to the client. An implementation may choose to apply other semantics and return True. For example copying '/by_tag/cool/myres' to '/by_tag/hot/myres' may simply add a 'hot' tag. In this case, the resource might still be available by other URLs, so locks and properties are not removed. This default implementation returns ``False``, so standard processing takes place. Implementation of this method is OPTIONAL. Fr;)r'r]depth_infinitys r( handle_copyz_DAVResource.handle_copy rr*ct)aCopy or move this resource to destPath (non-recursive). Preconditions (ensured by caller): - there must not be any conflicting locks on destination - overwriting is only allowed (i.e. destPath exists), when source and dest are of the same type ((non-)collections) and a Overwrite='T' was passed - destPath must not be a child path of this resource This function - Overwrites non-collections content, if destination exists. - MUST NOT copy collection members. - MUST NOT copy locks. - SHOULD copy live properties, when appropriate. E.g. displayname should be copied, but creationdate should be reset if the target did not exist before. See http://www.webdav.org/specs/rfc4918.html#dav.properties - SHOULD copy dead properties. - raises HTTP_FORBIDDEN for read-only providers - raises HTTP_INTERNAL_ERROR on error When is_move is True, - Live properties should be moved too (e.g. creationdate) - Non-collections must be moved, not copied - For collections, this function behaves like in copy-mode: destination collection must be created and properties are copied. Members are NOT created. The source collection MUST NOT be removed. This method MUST be implemented by all providers that support write access. r\r'r]is_moves r(copy_move_singlez_DAVResource.copy_move_single/s H"!r*cy)a9Handle a MOVE request natively. This method is called by the MOVE handler after checking for valid request syntax and making sure that there are no conflicting locks and If-headers. Depending on the return value, this provider can control further processing: False: handle_move() did not do anything. WsgiDAV will process the request by calling delete() and copy_move_single() for every resource, bottom-up. True: handle_move() has successfully performed the MOVE request. HTTP_NO_CONTENT/HTTP_CREATED will be reported to the DAV client. List of errors: handle_move() tried to perform the move request, but failed completely or partially. A list of errors is returned like ``[ (, ), ... ]`` These errors will be reported to the client. DAVError raised: handle_move() refuses to perform the move request. The DAVError will be reported to the client. An implementation may choose to apply other semantics and return True. For example moving '/by_tag/cool/myres' to '/by_tag/hot/myres' may simply remove the 'cool' tag from 'my_res' and add a 'hot' tag instead. In this case, the resource might still be available by other URLs, so locks and properties are not removed. This default implementation returns ``False``, so standard processing takes place. Implementation of this method is OPTIONAL. Fr;r'r]s r( handle_movez_DAVResource.handle_moveUsHr*c*|jsJt)CReturn True, if move_recursive() is available (see comments there).r4r$s r(support_recursive_movez#_DAVResource.support_recursive_move{s!!!!!!r*c tt)aMove this resource and members to destPath. This method is only called, when support_recursive_move() returns True. MOVE is frequently used by clients to rename a file without changing its parent collection, so it's not appropriate to reset all live properties that are set at resource creation. For example, the DAV:creationdate property value SHOULD remain the same after a MOVE. Preconditions (ensured by caller): - there must not be any conflicting locks or If-header on source - there must not be any conflicting locks or If-header on destination - destPath must not exist - destPath must not be a member of this resource This method must be prepared to handle recursive moves. This implies that child errors must be reported as tuple list [ (, ), ... ]. See http://www.webdav.org/specs/rfc4918.html#move-collections This function - moves this resource and all members to destPath. - MUST NOT move associated locks. Instead, if the source (or children thereof) have locks, then these locks should be removed. - SHOULD maintain associated live properties, when applicable See http://www.webdav.org/specs/rfc4918.html#dav.properties - MUST maintain associated dead properties - raises HTTP_FORBIDDEN for read-only resources - raises HTTP_INTERNAL_ERROR on error An implementation may choose to apply other semantics. For example copying '/by_tag/cool/myres' to '/by_tag/new/myres' may simply add a 'new' tag to 'my_res'. This method is only called, when self.support_recursive_move() returns True. Otherwise, the request server implements MOVE using delete/copy. This method MAY be implemented in order to improve performance. r r r$s r(move_recursivez_DAVResource.move_recursivesV~&&r*ct)zReturn a _DAVResource object for the path (None, if not found). `path_info`: is a URL relative to this object. DAVCollection.resolve() provides an implementation. r\r' script_name path_infos r(resolvez_DAVResource.resolverzr*cy)zPerform custom operations on the response headers. This gets called before the response is started. It enables adding additional headers or modifying the default ones. Nr;)r'rresponse_headerss r(finalize_headersz_DAVResource.finalize_headersrPr*);r/ __module__ __qualname____doc__rbooldictr)r1rrrr6r9floatr<r>r@rMrOrRrTrVrYr`rcrfrhrjrnrqruryrr|rrrrrrrrrrrr rrrrrrr"r%r(r+r0r3r;r*r(rr{s/b6S666; "HSM " " "(3- " 8E?   #   Xc]"""5" 4.KD :" "4p5n15.`J'X:?\'|L '(' "+/'#J"">#J$"L$L" +'Z"r*rceZdZdZdedeffd ZedZdZ edZ edZ ed Z d Z d d d ZdZdZxZS)DAVNonCollectionz A DAVNonCollection is a _DAVResource, that has content (like a 'file' on a filesystem). A DAVNonCollecion is able to read and write file content. See also _DAVResource rrc(t||d|yrXsuperr)r'rrr.s r(r)zDAVNonCollection.__init__s ug.r*ct)zReturns the byte length of the content. MUST be implemented. See also _DAVResource.get_content_length() r\r0s r(r6z#DAVNonCollection.get_content_lengths "!r*c`|jd}tj|j|S)aContains the Content-Type header returned by a GET without accept headers. This getcontenttype property MUST be defined on any DAV compliant resource that returns the Content-Type header in response to a GET. See http://www.webdav.org/specs/rfc4918.html#PROPERTY_getcontenttype This default implementation guesses the type from the filen name. r)rrguess_mime_typer)r'rs r(r9z!DAVNonCollection.get_content_types*./##DIIv66r*ct)aOpen content as a stream for reading. Returns a file-like object / stream containing the contents of the resource specified. The application will close() the stream. This method MUST be implemented by all providers. r\r0s r(r zDAVNonCollection.get_contents "!r*cy)a. See http://www.webdav.org/specs/rfc4918.html#PROPERTY_getetag This method SHOULD be implemented, especially by non-collections. Return None if not supported for this resource instance. See also `DAVNonCollection.support_etag()` and `util.get_file_etag(path)`. Nr;r0s r(rOzDAVNonCollection.get_etagr*cy)zgReturn True, if this resource supports ETags. See also `DAVNonCollection.get_etag()`. Nr;r0s r(rhzDAVNonCollection.support_etagrEr*cy)z~Return True, if this non-resource supports Range on GET requests. This default implementation returns False. Fr;r0s r(rczDAVNonCollection.support_rangess r*Nr c ttr r*rs r(rzDAVNonCollection.begin_write s ~&&r*cyrr;rs r(rzDAVNonCollection.end_writes r*c|dvr|Sy)zReturn a _DAVResource object for the path (None, if not found). Since non-collection don't have members, we return None if path is not empty. rlNr;r-s r(r0zDAVNonCollection.resolves  !Kr*)r/r4r5r6rr8r)rr6r9r rOrhrcrrr0 __classcell__r.s@r(r;r;s/S/4/"" 7 " "    +/' r*r;ceZdZdZdededdffd ZdeefdZ deefdZ d ede fd Z d Z d Zd ZedZdZdZdZdZdZdZdZxZS) DAVCollectiona A DAVCollection is a _DAVResource, that has members (like a 'folder' on a filesystem). A DAVCollecion 'knows' its members, and how to obtain them from the backend storage. There is also optional built-in support for member caching. See also _DAVResource rrr2Nc(t||d|y)NTr=r?s r(r)zDAVCollection.__init__3s tW-r*cyNr;r0s r(r6z DAVCollection.get_content_lengthZr*cyrQr;r0s r(r9zDAVCollection.get_content_type]rRr*r&c ttrr*rxs r(rz#DAVCollection.create_empty_resource`s"~&&r*c<|jsJttrrrxs r(rzDAVCollection.create_collectionsrr*cy)z See http://www.webdav.org/specs/rfc4918.html#PROPERTY_getetag For non-collections we default to None, because it is harder to implement. See also `DAVCollection.support_etag()`. Nr;r0s r(rOzDAVCollection.get_etagsr*c|jsJ|jjtj|j ||j Srw)rr$rrjoin_urirrrxs r(ryzDAVCollection.get_membersB!!!!}}.. MM$))T *DLL  r*c*|jsJt)zxReturn list of (direct) collection member names (UTF-8 byte strings). This method MUST be implemented. r4r0s r(r|zDAVCollection.get_member_namess !!!!!!r*cy)zReturn True, if this resource supports ETags. For non-collections we default to False, because it is harder to implement. See also `DAVCollection.get_etag()`. Fr;r0s r(rhzDAVCollection.support_etag r*cy)zReturn True, if delete() may be called on non-empty collections (see comments there). This default implementation returns False. Fr;r0s r(rz&DAVCollection.support_recursive_deleter[r*c tt)zRemove this resource (possibly recursive). This method MUST be implemented if resource allows write access. See _DAVResource.delete() r*r0s r(rzDAVCollection.delete~&&r*c tt)zCopy or move this resource to destPath (non-recursive). This method MUST be implemented if resource allows write access. See _DAVResource.copy_move_single() r*r s r(r"zDAVCollection.copy_move_singler^r*cy)r'Fr;r$s r(r(z$DAVCollection.support_recursive_movesr*c tt)z}Move this resource and members to destPath. This method MAY be implemented in order to improve performance. r*r$s r(r+zDAVCollection.move_recursives ~&&r*c|dvr|S|jdsJtj|\}}|j|}||dvr|S|j tj |||S)zReturn a _DAVResource object for the path (None, if not found). `path_info`: is a URL relative to this object. rlr!)r#rpop_pathryr0rX)r'r.r/r&restrs r(r0zDAVCollection.resolvesr  !K##C(((]]9- dood# ;$)+J{{4==d;TBBr*)r/r4r5r6rr8r)rrr6r9rrrrOryrr|rhrrr"r(r+r0rKrLs@r(rNrN's .S.4.D.NHSM(3-'#','&'   ""''' Cr*rNceZdZdZdZdZdZdZdZdZ dZ d Z e d e d efd Zd e d efd Zd e d efdZdZy) DAVProviderzAbstract base class for DAV resource providers. There will be only one DAVProvider instance per share (not per request). cfd|_d|_d|_d|_d|_d|_d|_y)Nr r)rtrprrr_count_get_resource_inst_count_get_resource_inst_initr0s r(r)zDAVProvider.__init__s7   ()%-.*r*c.|jjSrQ)r.r/r0s r(r1zDAVProvider.__repr__s~~&&&r*cyrXr;r0s r( is_readonlyzDAVProvider.is_readonlyrZr*cb|dvs$|jdr|jdrJ||_y)zSet application root for this resource provider. This is the value of SCRIPT_NAME, when WsgiDAVApp is called. rlr!N)r#rmrt)r'rts r(set_mount_pathzDAVProvider.set_mount_paths: Y&  ! !# &z/B/B3/G  %r*c~|dk(s|jdsJ|dk(rd}|dvs|jdrJ||_y)zSet application location for this resource provider. @param share_path: a UTF-8 encoded, unquoted byte string. r r!rlN)r#rmrp)r'rps r(set_share_pathzDAVProvider.set_share_pathsNR:#8#8#===  JY&j.A.A#.FFF$r*cD|rt|ds td||_y)Ncheck_write_permissionzAMust be compatible with wsgidav.lock_man.lock_manager.LockManager)hasattr ValueErrorr)r'rs r(set_lock_managerzDAVProvider.set_lock_managers)  6N OS )r*cD|rt|ds td||_y)Ncopy_propertieszIMust be compatible with wsgidav.prop_man.property_manager.PropertyManager)rtrur)r'rs r(set_prop_managerzDAVProvider.set_prop_managers)  6G H[ )r*cxdttj||jj dzS)zConvert a refUrl to a path, by stripping the share prefix. Used to calculate the from a storage key by inverting get_ref_url(). r!)rr removeprefixrplstrip)r'ref_urls r(rzDAVProvider.ref_url_to_paths1 WT..wHIPPQTUUUr*rrct)aReturn a _DAVResource object for path. Should be called only once per request and resource:: res = provider.get_resource_inst(path, environ) if res and not res.is_collection: print(res.get_content_type()) If does not exist, None is returned. may be used by the provider to implement per-request caching. See _DAVResource for details. This method MUST be implemented. r\r'rrs r(rzDAVProvider.get_resource_inst&s ""!r*c*|j||duS)aReturn True, if path maps to an existing resource. This method should only be used, if no other information is queried for . Otherwise a _DAVResource should be created first. This method SHOULD be overridden by a more efficient implementation. N)rrs r(existszDAVProvider.exists9s%%dG4D@@r*cF|j||}|xr |jS)zReturn True, if path maps to an existing collection resource. This method should only be used, if no other information is queried for . Otherwise a _DAVResource should be created first. )rr)r'rrrs r(rzDAVProvider.is_collectionCs' $$T73(s(((r*c|||S)zOptionally implement custom request handling. requestmethod = environ["REQUEST_METHOD"] Either - handle the request completely - do additional processing and call default_handler(environ, start_response) r;)r'rstart_responsedefault_handlers r(custom_request_handlerz"DAVProvider.custom_request_handlerLsw77r*N)r/r4r5r6r)r1rmrorqrvryrrrr8rrrrr;r*r(rfrfs /'% %))V"c"D""$A3AA)#)) 8r*rf)"r6rGrrrabcrrtypingr urllib.parserrwsgidavrr wsgidav.dav_errorr r r r r wsgidav.utilr __docformat__get_module_loggerr/rrrrr;rNrfr;r*r(rs KZ #'#" $  * ,-BCA3AN"_|_JsCLsCvs8#s8r*