U k;d@sPdZddlmZddlmZmZddlmZddlm Z dZ GdddeZ d S) a WSGI middleware that finds the registered mapped DAV-Provider, creates a new RequestServer instance, and dispatches the request. .. warning:: The following documentation was taken over from PyFileServer and is outdated. WsgiDAV file sharing -------------------- WsgiDAV allows the user to specify in wsgidav.conf a number of realms, and a number of users for each realm. Realms Each realm corresponds to a filestructure on disk to be stored, for example:: addShare('pubshare','/home/public/share') would allow the users to access using WebDAV the directory/file structure at /home/public/share from the url http:////pubshare The realm name is set as '/pubshare' e.g. /home/public/share/WsgiDAV/LICENSE becomes accessible as http:////pubshare/WsgiDAV/LICENSE Users A number of user_name/password pairs can be set for each realm:: adduser('pubshare', 'user_name', 'password', 'description/unused') would add a user_name/password pair to realm /pubshare. Note: if developers wish to maintain a separate users database, you can write your own domain controller for the HTTPAuthenticator. See http_authenticator.py and domain_controller.py for more details. Request Resolver ---------------- WSGI middleware for resolving Realm and Paths for the WsgiDAV application. Usage:: It *must* be configured as the last item on `middleware_stack` list. from wsgidav.request_resolver import RequestResolver config = { ..., 'middleware_stack': [ ..., RequestResolver, ], } The RequestResolver resolves the requested URL to the following values placed in the environ dictionary. First it resolves the corresponding realm:: url: http:////pubshare/WsgiDAV/LICENSE environ['wsgidav.mappedrealm'] = /pubshare Based on the configuration given, the resource abstraction layer for the realm is determined. if no configured abstraction layer is found, the default abstraction layer fileabstractionlayer.FilesystemAbstractionLayer() is used:: environ['wsgidav.resourceAL'] = fileabstractionlayer.MyOwnFilesystemAbstractionLayer() The path identifiers for the requested url are then resolved using the resource abstraction layer:: environ['wsgidav.mappedpath'] = /home/public/share/WsgiDAV/LICENSE environ['wsgidav.mappedURI'] = /pubshare/WsgiDAV/LICENSE in this case, FilesystemAbstractionLayer resolves any relative paths to its canonical absolute path The RequestResolver also resolves any value in the Destination request header, if present, to:: Destination: http:////pubshare/WsgiDAV/LICENSE-dest environ['wsgidav.destrealm'] = /pubshare environ['wsgidav.destpath'] = /home/public/share/WsgiDAV/LICENSE-dest environ['wsgidav.destURI'] = /pubshare/WsgiDAV/LICENSE environ['wsgidav.destresourceAL'] = fileabstractionlayer.MyOwnFilesystemAbstractionLayer() )util)DAVErrorHTTP_NOT_FOUND)BaseMiddleware) RequestServerreStructuredTextcs$eZdZfddZddZZS)RequestResolvercstt||||dS)N)superr__init__)self wsgidav_appnext_appconfig __class__(/opt/wsgidav/wsgidav/request_resolver.pyr szRequestResolver.__init__c cs|d}|d}|ddkr|dkrd}|dksB|sB|jdkrFd}dd d |fd tfg}|d d drx|d|d|dVdS|dkrttd|t |}|||}|D] } | Vqt |dr| dS)N PATH_INFOzwsgidav.providerREQUEST_METHODOPTIONS)/*z1,21)z Content-Typez text/html)zContent-Length0DAVDatezwsgidav.configadd_header_MS_Author_ViaF)z MS-Author-Viarz200 OKz)Could not find resource provider for '{}'close) is_readonly lock_managerrget_rfc1123_timegetappendrrformatrhasattrr) r environstart_responsepathproviderZdav_compliance_levelheadersappapp_itervrrr__call__sB      zRequestResolver.__call__)__name__ __module__ __qualname__r r. __classcell__rrrrrs rN) __doc__wsgidavrwsgidav.dav_errorrrwsgidav.middlewarerZwsgidav.request_serverr __docformat__rrrrrs [   6