qiwb SrSSKrSSKrSSKJr SSKJr SSKJr SSK J r J r J r J r SSKJrJrJr SSKJr S r\R*"\5rS rS rS S SSS/SS\R4R7\S5\R4R7\S5/S.SSSSS/SS\R4R7\S5/S.SSR95SS/SS\R4R7\S5/S./rS rS!r"S"S#\5r "S$S%\5r!"S&S'\5r""S(S)\5r#"S*S+\5r$"S,S-\$5r%"S.S/\$5r&"S0S1\5r'g)2aN Sample implementation of a DAV provider that provides a browsable, multi-categorized resource tree. Note that this is simply an example with no concrete real world benefit. But it demonstrates some techniques to customize WsgiDAV. Compared to a published file system, we have these main differences: #. A resource like ``My doc 1`` has several attributes like ``key``, ``orga``, ``tags``, ``status``, ``description``. Also there may be a list of attached files. #. These attributes are used to dynamically create a virtual hierarchy. For example, if ``status`` is ``draft``, a collection ``/by_status/draft/`` is created and the resource is mapped to ``/by_status/draft/My doc 1``. #. The resource ``My doc 1`` is rendered as a collection, that contains some virtual descriptive files and the attached files. #. The same resource may be referenced using different paths For example ``/by_tag/cool/My doc 1``, ``/by_tag/hot/My doc 1``, and ``/by_key/1`` map to the same resource. Only the latter is considered the *real-path*, all others are *virtual-paths*. #. The attributes are exposed as live properties, like "{virtres:}key", "{virtres:}tags", and "{virtres:}description". Some of them are even writable. Note that modifying an attribute may also change the dynamically created tree structure. For example changing "{virtres:}status" from 'draft' to 'published' will make the resource appear as ``/by_status/published/My doc 1``. #. This provider implements native delete/move/copy methods, to change the semantics of these operations for the virtual '/by_tag/' collection. For example issuing a DELETE on ``/by_tag/cool/My doc 1`` will simply remove the 'cool' tag from that resource. #. Virtual collections and artifacts cannot be locked. However a resource can be locked. For example locking ``/by_tag/cool/My doc 1`` will also lock ``/by_key/1``. #. Some paths may be hidden, i.e. by_key is not browsable (but can be referenced) TODO: is this WebDAV compliant? The *database* is a simple hard coded variable ``_resourceData``, that contains a list of resource description dictionaries. A resource is served as an collection, which is generated on-the-fly and contains some virtual files (*artifacts*). In general, a URL is interpreted like this:: //// An example layout:: / by_tag/ cool/ My doc 1/ .Info.html .Info.txt .Description.txt MySpec.pdf MySpec.doc My doc 2/ hot/ My doc 1/ My doc 2/ nice/ My doc 2/ My doc 3 by_orga/ development/ My doc 3/ marketing/ My doc 1/ My doc 2/ by_status/ draft/ My doc 2 published/ My doc 1 My doc 3 by_key/ 1/ 2/ 3/ When accessed using WebDAV, the following URLs both return the same resource 'My doc 1':: /by_tag/cool/My doc 1 /by_tag/hot/My doc 1 /by_key/1 N)BytesIO)quote)util)HTTP_FORBIDDENHTTP_INTERNAL_ERRORDAVError#PRECONDITION_CODE_ProtectedProperty) DAVCollectionDAVNonCollection DAVProvider)join_urizreStructuredText eni zc:\temp\virtfiles1zMy doc 1 developmentcoolhotdraftz/This resource contains two specification files.z MySpec.docz MySpec.pdf)keytitleorgatagsstatus description resPathList2zMy doc 2nice publishedz This resource contains one file.z My URS.doc3uMy doc (euro:€, uuml:��) marketingzLong text describing itcU[R;deUS:Xa-[Vs/sHo"RS5U:XdMUPM sn$US:Xa.[Vs/sHo"RS5U:XdMUPM nnU$US:Xa,[Vs/sHo!URS5;dMUPM nnW$s snfs snfs snf) by_statusrby_orgarby_tagr)RootCollection_visibleMemberNames _resourceDataget)attrNameattrValdataresLists Y/home/kali/flask_env/lib/python3.13/site-packages/wsgidav/samples/virtual_dav_provider.py_get_res_list_by_attrr-s ~99 99 9;!.P((82D2OPP Y $1QMDXXf5E5P4MQ N X $1QMD@P5P4MQ N QQQs#B2B2B74B7 B<(B<c8[HnUSU:XdMUs $ g)r rN)r&)rr*s r,_get_res_by_keyr/s" ;# K cF^\rSrSrSrSr\S-rU4SjrSrSr Sr U=r $) r$zResolve top-level requests '/'.)r"r#r!)by_keyc&>[TU]SU5 g)N/super__init__)selfenviron __class__s r,r8RootCollection.__init__s g&r0cUR$N)r%r9s r,get_member_namesRootCollection.get_member_namess'''r0cvXR;a*[[URU5UR5$gr>)_validMemberNamesCategoryTypeCollectionr pathr:)r9names r, get_memberRootCollection.get_members- )) ))(499d*CT\\R Rr0) __name__ __module__ __qualname____firstlineno____doc__r%rCr8r@rG__static_attributes__ __classcell__r;s@r,r$r$s+)<+k9'(r0r$c>^\rSrSrSrU4SjrSrSrSrSr U=r $)rDz/Resolve '/catType' URLs, for example '/by_tag'.c$>[TU]X5 gr>r6r9rEr:r;s r,r8CategoryTypeCollection.__init__ 'r0c SS0$)Ntypez Category typerIr?s r,get_display_info'CategoryTypeCollection.get_display_infos ((r0ct/n[HnURS:Xa!USU;aURUS5 M2M4URS:Xa!USU;aURUS5 McMeURS:XdMwUSHnX1;dM URU5 M M UR5 U$)Nr!rr"rr#r)r&rFappendsort)r9namesr*tags r,r@'CategoryTypeCollection.get_member_namess!DyyK'>.LLh0/i'[U5nU(a+[[URU5UR U5$g[ [URU5UR UR5$)Nr3)rFr/VirtualResourcer rEr:CategoryCollectionr9rFr*s r,rG!CategoryTypeCollection.get_members_ 99 "4(D&x 4'@$,,PTUU!(499d";T\\499UUr0rI rJrKrLrMrNr8rZr@rGrOrPrQs@r,rDrDs!9()"VVr0rDc>^\rSrSrSrU4SjrSrSrSrSr U=r $)rdz8Resolve '/catType/cat' URLs, for example '/by_tag/cool'.c0>[TU]X5 X0lgr>)r7r8catType)r9rEr:rkr;s r,r8CategoryCollection.__init__s ' r0c SS0$)NrYCategoryrIr?s r,rZ#CategoryCollection.get_display_infos  ##r0c[URUR5Vs/sHoSPM nnUR5 U$s snfNr)r-rkrFr^)r9r*r_s r,r@#CategoryCollection.get_member_namessE&;DLL$))&T &TdM&T      sAc[URUR5H9nUSU:XdM[[ UR U5UR U5s $ grq)r-rkrFrcr rEr:res r,rGCategoryCollection.get_membersL)$,, BDG}$&x 4'@$,,PTUUCr0)rkrgrQs@r,rdrdsB$r0rdc^\rSrSrSrSr/SQrU4SjrSrSr Sr S r S r S r S rU4S jrU4SjrSSjrSrU=r$)rci zGA virtual 'resource', displayed as a collection of artifacts and files.) .Info.txt .Info.html.Description.txt) {virtres:}key{virtres:}title{virtres:}status{virtres:}orga{virtres:}tags{virtres:}descriptionc0>[TU]X5 X0lgr>r7r8r*r9rEr:r*r;s r,r8VirtualResource.__init__s ' r0c SS0$)NrYzVirtual ResourcerIr?s r,rZ VirtualResource.get_display_info"s*++r0c[UR5nURSH3n[RR U5nUR U5 M5 U$Nr)list_artifactNamesr*osrEbasenamer])r9r_frFs r,r@ VirtualResource.get_member_names%sLT(()=)A77##A&D LL * r0cpXR;a5[[URU5URUR 5$UR SH_n[ RRU5nX1:XdM)[[URU5URUR U5s $ gr) rVirtualArtifactr rEr:r*rrVirtualResFile)r9rF file_pathfnames r,rGVirtualResource.get_member,s && &"8DIIt#* *"oodiiooc.BCKe("""ii'''' &  %r0cSU;a[[5e[R"UR S5SS5up4nUS:XdeX@R S;aUR SR U5 g)z-Change semantic of COPY to add resource tags.rr5rr#rT)rrrrrr*r])r9 dest_pathdepth_infinityrkr`rs r, handle_copyVirtualResource.handle_copyCsn Y &>* *"ooiooc.BCKe(""" ii' ' IIf  $ $S )r0c SUR;a[[5eSU;a[[5e[R"URR S5SS5up#nUS:XdeX0R S;deUR SRU5 [R"UR S5SS5up#nUS:XdeX0R S;aUR SRU5 g)z0Change semantic of MOVE to change resource tags.rr5rr#rT) rErrrrrr*rr])r9rrkr`rs r, handle_moveVirtualResource.handle_moveNs TYY &>* * Y &>* *"oodiiooc.BCKe("""ii'''' &  %"ooiooc.BCKe(""" ii' ' IIf  $ $S )r0cjSURS-n[URRU-5$)Nz /by_key/%sr)r*rprovider share_pathr9refPaths r, get_ref_urlVirtualResource.get_ref_url_s/5!11T]]--788r0c`>[TU]US9nUR[R5 U$)zaReturn list of supported property names in Clark Notation. See DAVResource.get_property_names() ) is_allprop)r7get_property_namesextendrc_supportedProps)r9r propNameListr;s r,r"VirtualResource.get_property_namescs1 w1Z1H O;;<r0c<>US:XaURS$US:XaURS$US:XaURS$US:XaURS$US :XaS RURS 5$US :XaURS $[TU] U5$)z:Return the value of a property. See get_property_value() ryrrzrr{rr|rr},rr~r)r*joinr7get_property_value)r9rFr;s r,r"VirtualResource.get_property_valuens ? "99U# # & &99W% % ' '99X& & % %99V$ $ % %88DIIf-. . , ,99]+ +w)$//r0c.Uc[[5eUS:Xa)URRS5URS'gUS:XaURURS'gU[ R ;a[[[S9e[[5e)zDSet or remove property value. See DAVResource.set_property_value() Nr}rrr~r) err_condition)rrtextsplitr*rcrr )r9rFvaluedry_runs r,set_property_value"VirtualResource.set_property_values =>* * # # % 0 0 5DIIf  , ,',zzDIIm $ _44 4.Q  >* *r0r*)F)rJrKrLrMrNrrr8rZr@rGrrrrrrrrOrPrQs@r,rcrc sPQN O,   "9 0,r0rcc\^\rSrSrSrU4SjrSrSrSrSr Sr S r S r S r S rU=r$) _VirtualNonCollectioniz5Abstract base class for all non-collection resources.c$>[TU]X5 gr>r6rUs r,r8_VirtualNonCollection.__init__rWr0cgr>rIr?s r,get_content_length(_VirtualNonCollection.get_content_lengthr0cgr>rIr?s r,get_content_type&_VirtualNonCollection.get_content_typerr0cgr>rIr?s r,get_creation_date'_VirtualNonCollection.get_creation_daterr0cUR$r>)rFr?s r,get_display_name&_VirtualNonCollection.get_display_names yyr0c[er>)NotImplementedErrorr?s r,rZ&_VirtualNonCollection.get_display_infos!!r0cgr>rIr?s r,get_etag_VirtualNonCollection.get_etagrr0cgr>rIr?s r,get_last_modified'_VirtualNonCollection.get_last_modifiedrr0cg)NFrIr?s r,support_ranges$_VirtualNonCollection.support_rangessr0rI)rJrKrLrMrNr8rrrrrZrrrrOrPrQs@r,rrs8?("r0rcP^\rSrSrSrU4SjrSrSrSrSr Sr S r S r U=r $) riz1A virtual file, containing resource descriptions.c0>[TU]X5 X0lgr>rrs r,r8VirtualArtifact.__init__s ' r0cP[UR5R55$r>)len get_contentreadr?s r,r"VirtualArtifact.get_content_lengths4##%**,--r0cFURRS5(agg)Nz.txtz text/plain text/html)rFendswithr?s r,r VirtualArtifact.get_content_types 99  f % %r0c SS0$)NrYzVirtual info filerIr?s r,rZ VirtualArtifact.get_display_infos+,,r0cg)NTrIr?s r,prevent_lockingVirtualArtifact.prevent_lockingrr0cSRURSUR5n[URR U-5$Nz /by_key/{}/{}r)formatr*rFrrrrs r,rVirtualArtifact.get_ref_urls;!((5)9499ET]]--788r0c .URSVs/sH)nS[RRU5SUS3PM+ nnURR 5nSR U5US'UR S:XaSU-nOUR S :XaURS S [URS 5-URS S SURS-SURS-SSR URS5-SURS-/nSR U5nO=UR S:XaURS nO[[SUR -5e[[R"U55$s snf)Nrz z z, fileLinksrwa0 %(title)s

%(title)s

Description %(description)s
Status %(status)s
Tags %(tags)s
Orga unit %(orga)s
Files %(fileLinks)s
Key %(key)s

This is a virtual WsgiDAV resource called '%(title)s'.

rvr=rr z Status: %srz Orga: %8srz Tags: '%s'z', 'rz Key: %sr rxzInvalid artifact '%s') r*rrErcopyrrFrrrrrto_bytes)r9rrdicthtmlliness r,rVirtualArtifact.get_contentsYY}- -((+,Bqc 8-  yy~~ IIi0[ 99 $89 >YY+ % '"c$))G,-- -(tyy22 & 11TYYv->!??tyy// E99U#D YY, ,99]+D.0G$))0ST Tt}}T*++m s0Fr)rJrKrLrMrNr8rrrZrrrrOrPrQs@r,rrs.; . -97,7,r0rcV^\rSrSrSrU4SjrSrSrSrSr Sr S r S r S r U=r$) ri"zCRepresents an existing file, that is a member of a VirtualResource.c>[RRU5(d[R SU-5 [ TU]X5 X0lX@lg)Nz"VirtualResFile(%r) does not exist.) rrEexists_loggererrorr7r8r*r)r9rEr:r*rr;s r,r8VirtualResFile.__init__%s?ww~~i(( MM>J K ' "r0ch[R"UR5nU[R$r>)rstatrST_SIZEr9 statresultss r,r!VirtualResFile.get_content_length,s#ggdnn- 4<<((r0c[RRUR5(dg[R "UR5$)Nr)rrEisfilerrguess_mime_typer?s r,rVirtualResFile.get_content_type0s3ww~~dnn-- ##DNN33r0ch[R"UR5nU[R$r>)rrrST_CTIMErs r,r VirtualResFile.get_creation_date9#ggdnn- 4==))r0c SS0$)NrYz Content filerIr?s r,rZVirtualResFile.get_display_info=s ''r0ch[R"UR5nU[R$r>)rrrST_MTIMErs r,r VirtualResFile.get_last_modified@rr0cSRURS[RR UR 55n[ URRU-5$r) rr*rrErrrrrrs r,rVirtualResFile.get_ref_urlDsO!(( IIe bgg..t~~> T]]--788r0c8[URS[5$)Nrb)openr BUFFER_SIZEr?s r,rVirtualResFile.get_contentJs DNND+66r0)r*r)rJrKrLrMrNr8rrrrZrrrrOrPrQs@r,rr"s3M#)4*(*9 77r0rc2^\rSrSrSrU4SjrSrSrU=r$)VirtualResourceProvideriUz? DAV provider that serves a VirtualResource derived structure. c8>[TU]5 [Ulgr>)r7r8r& resourceData)r9r;s r,r8 VirtualResourceProvider.__init__Zs )r0c[RSU-5 U=RS- sl[U5nUR SU5$)zReturn _VirtualResource object for path. path is expected to be categoryType/category/name/artifact for example: 'by_tag/cool/My doc 2/info.html' See DAVProvider.get_resource_inst() zget_resource_inst('%s')r )rinfo_count_get_resource_instr$resolve)r9rEr:roots r,get_resource_inst)VirtualResourceProvider.get_resource_inst^sB  .56 %%*%g&||B%%r0)r) rJrKrLrMrNr8r'rOrPrQs@r,rrUs* & &r0r)(rNrrior urllib.parserwsgidavrwsgidav.dav_errorrrrr wsgidav.dav_providerr r r wsgidav.utilr __docformat__get_module_loggerrJrr FILE_FOLDERrErencoder&r-r/r$rDrdrcrrrrrIr0r,r3s]|  NM!%   *  # H GGLLl 3 GGLLl 3   9 [,?@4;;=0 [,?@- D ]&!V]!VH6OmOj,TQ,+Q,n-7*-7f&k&r0