qi SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK Jr SSKJrJr SSKJr SSKJr SSKJrJrJr SSKJr SS KJr SS KJrJ r J!r!J"r"J#r#J$r$J%r%J&r&J'r'J(r( SS K)J*r*J+r+J,r,J-r- S r.S r/\R`"\/5r1SRe\ RfSSVs/sH n\4"U5PM sn5r5\ Rl"5r7S\3r8S\53r9"SS5r:S\\4S\;4SjrSr?S|Sjr@S|SjrASSS.S\B4SjjrC\:4SS.S jjrDSS!.S"jrESS#SS$.S%jrFS&rGS'rHS(SS).S*\4S\44S+jjrIS}S,jrJS}S-jrKS}S.jrLS/rMS0rNS1rOSS2.S3jrPS4rQS5rRSS#S6.S7jrSSS8.S9jrTS~S*\4S:\4S;\;S\44S<jjrUS=rVS>rWS?rXS@rYSArZSBr[SCSD.SEjr\SFr]SGr^S#SS#S#SH.SIjr_S#S#S#SJ.SKjr`SLraSMrbS}SSSSN.SOjjrc"SPSQ5rdSRreSS\4S\44STjrfSS\4S\\44SUjrgSV\4SW\4S\;4SXjrhSYriS}SZjrjSS[jrkSS\.S]jrlS^rmSSS_.S`jrnSaroSbrpScrqSdrrSSe.SfjrsSgrtShru\R"Si5rw\R"Sj5rxSkrySlrz\R"Sm\R5r|Snr}Sor~\R"Sp5r\R"Sq5r\R"Sr5r\R"Ss5rStrSurSvSvSwSxSySySz.rS{rgs snf)z. Miscellaneous support functions for WsgiDAV. N)deepcopy) formatdate parsedate)md5)pformat)IterableOptionalTuple)quote) __version__) HTTP_BAD_REQUEST HTTP_CREATEDHTTP_NO_CONTENTHTTP_NOT_MODIFIEDHTTP_OKHTTP_PRECONDITION_FAILEDHTTP_RANGE_NOT_SATISFIABLEDAVError as_DAVErrorget_http_status_string)etreeis_etree_elementmake_sub_element xml_to_bytesreStructuredTextwsgidav.zWsgiDAV/zPython/c\rSrSrSrSrg) NO_DEFAULT=N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r#A/home/kali/flask_env/lib/python3.13/site-packages/wsgidav/util.pyr r =s r*r min_versionreturnc[RU:aTSRUSSVs/sHn[U5PM sn5n[R "SUS[ S3[SS9 g g s snf) z$Check for deprecated Python version.rNrz&Support for Python version less than `z` is deprecated (using )) stacklevelFT)sys version_infojoinstrwarningswarnPYTHON_VERSIONDeprecationWarning)r,smin_vers r+check_python_versionr<Aso +%((KO$%Q (    =sA*c.[U[[45$)zNReturn True for any string type (for str/unicode on Py2 and bytes/str on Py3).) isinstancer5bytesr:s r+ is_basestringrATs a#u &&r*c"[U[5$)z>Return True for bytestrings (for str on Py2 and bytes on Py3).)r>r?r@s r+is_bytesrCYs a r*c"[U[5$)z8Return True for native strings (for str on Py2 and Py3).)r>r5r@s r+is_strrE^s a r*c@[U5[La [X5nU$)zLConvert a text string (unicode) to bytestring (str on Py2 and bytes on Py3).)typer?r:encodings r+to_bytesrJcs Awe !  Hr*c~[U5[La [X5nU$[U5[La [U5nU$)zGConvert data to native str type (bytestring on Py2 and unicode on Py3).)rGr?r5rHs r+to_strrLjs; Aw%   H a  F Hr*F)or_none raise_errorc[5n[U5[LaUnU$[U5[La4[[[RUR S555nU$[ U[[[45(a[[[U55nU$Uc U(aSnU$U(a[US[U535eU$)N,, ) setrGr5mapstripsplitr>dictlisttuple TypeError)valrMrNress r+to_setr\ss %C CyC J cc #cii301 J C$e, - -#c3-  J  J 3%r$s)-.. Jr*)as_dictcU(a[X0S9nUbU$0$U[ La [X5$UR S5nURS5nXnU(aURS5n[U[5(aXvnOr[U[[45(aKURS5(aURS5(d [S5eUSSnU[U5nO [Xv5nU(aMU$![[[[4a 0s$f=f![[[[4a Us$f=f![a ef=f) aReturn the value of a nested dict using dot-notation path. Args: d (dict): key_path (str): default (any): as_dict (bool): Assume default is `{}` and also return `{}` if the key exists with a value of `None`. This covers the case where suboptions are supposed to be dicts, but are defined in a YAML file as entry without a value. Raises: KeyError: ValueError: IndexError: Examples:: ... Todo: * k[1] instead of k.[1] )defaultrr[]z(Use `[INT]` syntax to address list items)get_dict_valueAttributeErrorKeyError ValueError IndexErrorr rUpopr>rVrWrX startswithendswithintgetattr)dkey_pathr_r]r[seg_listsegvalues r+rdrdsH2  b9C/3 1r 1j  !!. .~~c"H ,,q/C FE ll1o eT " "JE e} - ->>#&&cll3.?.? !KLLa)C#c(OE + ( L;*jA I  *jA N ("  s3DD D&. ED#"D#&EE E)in_placec^U4SjmU(d [U5nUR5H nT"U5 M U(agU$)Nc>[U[5(a+SU;aSUS'UR5H nT"U5 M g[U[5(a([U[5(dUH nT"U5 M ggg)Npasswordz )r>rVvaluesrr5)vele_purges r+rzpurge_passwords.._purgesj a  Q +* xxzs " 8 $ $Z3-?-?s .@ $r*)rrw)rnrsrxrzs @r+purge_passwordsr|s:  QK XXZq  Hr*T)msgrNrequiredc U(dS5e[U5nUnUSLa Un[5nO4U(a-[U5nURU5nURU5n[U5n/nURU5nU(a/UR SR SR U555 U(aGURU5nU(a/UR SR SR U555 U(aU(aURSU5 U(aGU(a@UR SR SR U5SR U555 OmU(a0UR SR SR U555 O6U(a/UR S R SR U555 S R U5nU(a [U5eU$g ) zCheck if `tags` only contains known tags. If check fails and raise_error is true, a ValueError is raised. If check passes, None is returned. zmust not be emptyTz Unknown: {!r}z', 'z Missing: {!r}rz"Required: ({!r}). Optional: ({!r})zRequired: ({!r})zOptional: ({!r}) N) r\rRunion differenceappendformatr4insertrg) tagsknownr}rNr~optionalr[unknownmissings r+ check_tagsrs %%%5 5MEH45 (# H%##H- $?@%%d+  JJ--fkk'.BC D  JJq#   JJ4;;KK)6;;x+@   JJ)00X1FG H  JJ)00X1FG Hiin S/ ! r*cLUR[S5RS5$)zDConvert an environment variable to a WSGI 'bytes-as-unicode' string.surrogateescape iso-8859-1)encodefilesystemencodingdecode)us r+unicode_to_wsgirs" 88&(9 : A A, OOr*c$URS5$)zConvert a native string to a WSGI / HTTP compatible byte string. WSGI always assumes iso-8859-1 (PEP 3333). https://bugs.python.org/issue16679#msg177450 r)rr@s r+ wsgi_to_bytesrs 88L !!r*zutf-8)rIfallbackr:c[U5[LaURU5$URS5RU5$![a U(aUs$ef=f)zConvert a WSGI string to `str`, assuming the client used UTF-8. WSGI always assumes iso-8859-1. Modern clients send UTF-8, so we have to re-encode https://www.python.org/dev/peps/pep-3333/#unicode-issues https://bugs.python.org/issue16679#msg177450 r)rGr?rrUnicodeDecodeError)r:rIrs r+re_encode_wsgir sV 7e 88H% %xx %,,X66  H s"AAAAc[USSS9$)zMReturn in rfc 1123 date/time format (pass secs=None for current date).FT)timeval localtimeusegmt)rsecss r+get_rfc1123_timer9s deD AAr*cX[R"S[R"U55$)zReturn in RFC 3339 date/time format (pass secs=None for current date). RFC 3339 is a subset of ISO 8601, used for '{DAV:}creationdate'. See http://tools.ietf.org/html/rfc3339 z%Y-%m-%dT%H:%M:%SZtimestrftimegmtimers r+get_rfc3339_timer?s ==-t{{4/@ AAr*cX[R"S[R"U55$)zCReturn in log time format (pass secs=None for current date).z%Y-%m-%d %H:%M:%Srrs r+ get_log_timerHs ==,dkk$.? @@r*cT[U5nU(a[R"U5$g)aPReturn the number of seconds since the epoch, for a date/time string. Returns None for invalid input The following time type strings are supported: Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123 Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036 Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format N)_parse_gmt_timecalendartimegm) timestringresults r+parse_time_stringrMs#Z (F v&& r*c*[R"US5$![a Of=f[R"US5$![a Of=f[R"US5$![a Of=f[U5$![a gf=f)zMReturn a standard time tuple (see time and calendar), for a date/time string.z%a, %d %b %Y %H:%M:%S GMTz%A %d-%b-%y %H:%M:%S GMTz%a %b %d %H:%M:%S %YN)rstrptime Exceptionr)rs r+rr^s }}Z)DEE     }}Z)CDD     }}Z)?@@     $$    sA &&A A AA)) A65A6: B BBcSSKJnJn URSS5nURS5=(d 0nURS/5nUc/nURSU5nURS U5n[R "Xv5n[R "[R5n U RU5 [R"[5n US :a U R[R5 OUS:Xa U R[R5 OkUS :Xa U R[R5 OEUS :Xa U R[R 5 OU R[R"5 S U lU R&SSH5n U R)5 U R+5 U R/U 5 M7 U R1U 5 US:auUHon U R3[S-5(d [S-U -n [R"U R555n U R[R5 Mq g![,a Nf=f)a8 Initialize base logger named 'wsgidav'. The base logger is filtered by the `verbose` configuration option. Log entries will have a time stamp and thread id. **Note:** init_logging() is automatically called if an application adds ``"logging": { "enable": true }`` to the configuration. Module loggers ~~~~~~~~~~~~~~ Module loggers (e.g 'wsgidav.lock_man.lock_manager') are named loggers, that can be independently switched to DEBUG mode. Except for verbosity, they will inherit settings from the base logger. They will suppress DEBUG level messages, unless they are enabled by passing their name to util.init_logging(). If enabled, module loggers will print DEBUG messages, even if verbose == 3. Example initialize and use a module logger, that will generate output, if enabled (and verbose >= 2):: _logger = util.get_module_logger(__name__) [..] _logger.debug("foo: {!r}".format(s)) This logger would be enabled by passing its name to init_logging():: config.logging.enable_loggers = ["lock_manager", "property_manager", ] util.init_logging(2, enable_loggers) Log Level Matrix ~~~~~~~~~~~~~~~~ +---------+--------+---------------------------------------------------------------+ | Verbose | Option | Log level | | level | +-------------+------------------------+------------------------+ | | | base logger | module logger(default) | module logger(enabled) | +=========+========+=============+========================+========================+ | 0 | -qqq | CRITICAL | CRITICAL | CRITICAL | +---------+--------+-------------+------------------------+------------------------+ | 1 | -qq | ERROR | ERROR | ERROR | +---------+--------+-------------+------------------------+------------------------+ | 2 | -q | WARN | WARN | WARN | +---------+--------+-------------+------------------------+------------------------+ | 3 | | INFO | INFO | **DEBUG** | +---------+--------+-------------+------------------------+------------------------+ | 4 | -v | DEBUG | DEBUG | DEBUG | +---------+--------+-------------+------------------------+------------------------+ | 5 | -vv | DEBUG | DEBUG | DEBUG | +---------+--------+-------------+------------------------+------------------------+ r)DEFAULT_LOGGER_DATE_FORMATDEFAULT_LOGGER_FORMATverboserloggingenable_loggersNlogger_date_format logger_formatr0rbFr)wsgidav.default_confrrgetr Formatter StreamHandlerr2stdout setFormatter getLoggerBASE_LOGGER_NAMEsetLevelDEBUGINFOWARNERRORCRITICAL propagatehandlersflushcloser removeHandler addHandlerrjrT)configrrrlog_optsrrr formatterconsoleHandlerloggerhdlrelgs r+ init_loggingrstWjjA&Gzz)$*H\\"2B7N!&: collectionsabcMappingrrGboolfloatrlr5copy deep_update)rnrkrxprev_vals r+rr s  a00 1 1uuQxH4>dE35L#Lvvx#155B<3aD Hr*cSSKnSU;a[SU<35eURSS5up#URU5n[XC5nU$![a"n[ R SU<SU35 eSnAff=f)zBImport a class from a module string, e.g. ``my.module.ClassName``.rNrz%Expected `path.to.ClassName` string: rbzDynamic import of z failed: ) importlibrgrsplit import_moduler_loggererrorrm)namer module_name class_namemoduler the_classs r+dynamic_import_classr"s $@IJJ"kk#q1K((5+I   *4()A3?@ sA A9A44A9)expandrNc^U4Sjn[USS1SU3S9 URS5=(d /nUb)[U[[45(d[ SU35eURS5=(d 0nUb#[U[ 5(d[ SU35eSn[U5n[[XE55nUR5V V s0sH upX"U 5_M nn n U"U0UD6nUV s/sHoPM sn UR5V V s/sH upU S U <3PM sn n -n [RS RUS RU 5U55 U$s sn n fs sn fs sn n f![a? S US US3n U(a[RU 5 e[R!U 5 W$f=f)a?Import a class and instantiate with custom args. Equivalent of ```py from my.module import Foo return Foo(bar=42, baz="qux") ``` would be ```py options = { "bar": 42, "baz": "qux" } => ``` Examples: # Equivalent of name = "my.module.Foo" from my.module import Foo return Foo(bar=42, baz="qux") ch>T(a)[U5(aUR5T;aTU$U$)z2Replace some string templates with defined values.)rAlower)rxrs r+_expand*dynamic_instantiate_class.._expandIs, mA&&1779+>!9 r*argskwargsz(Invalid class instantiation options for )r}Nz(Expected list format for `args` option: z*Expected dict format for `kwargs` option: =zInstantiate {}({}) => {}rQz Instantiate (z) failed)rrr>rXrWrgrVrrSrrdebugrr4rr exception)roptionsrrNrpos_argsrinstrrrxo disp_argsr}s ` r+dynamic_instantiate_classr2s.  6zl C {{6"(bHJx%$G$GCG9MNN [[ " (bF *VT":":EgYOPP(4 W/0,2LLN;NDA!WQZ-N;(-f-%-.XsVX.%+\\^2 %3TQqc1%L^2    & - -j$))I:NPT U  K3</2 ZL'(;  MM#  # Ks=4E9E('E96 E.E9E3+;E9(E99AGGrc[U5[LaSU0nOUR5n[U1SkSSS9 UR S5n[ X US9$)aImport a class and instantiate with custom args. Construct from class path, without constructor args: ```py dynamic_instantiate_class_from_opts("wsgidav.lock_man.lock_storage.LockStorageDict") ``` Construct with constructor args: ```py opts = { "class": "wsgidav.lock_man.lock_storage.LockStorageShelve", "kwargs": { "storage_path": "~/wsgidav_locks.shelve", } } dynamic_instantiate_class_from_opts(opts, expand=...) ``` class>rr rz#Invalid class instantiation options)r~r}r)rGr5rrrir)rrrs r+#dynamic_instantiate_class_from_optsr |sV& G}G$,,.# 1  W%J $Z HHr*prefix ignore_casecU(a5UR5RUR55(dU$OURU5(dU$U[U5S$)zDReplacement for str.removeprefix() (Py3.9+) with ignore_case option.N)rrjlen)r:r r s r+ removeprefixrsSwwy##FLLN33H4||F##H S[] r*cURX5n[U5U::a"URS5 [U5U::aM"U$)zGSplit string, always returning n-tuple (filled with None if necessary).N)rUrr)r:sepmaxsplittoks r+ save_splitrs; ''# C c(h  4 c(h  Jr*cUS;agURS5(deURS5RS5upnUSU-4$)z!Return '/a/b/c' -> ('a', '/b/c').r"/)r"r"r)rjlstrip partition)pathfirst_seprests r+pop_pathrsO y ??3    C(2237E 3: r*cRUS;ag[U5up[U5up2XSU-4$)z$Return '/a/b/c' -> ('a', 'b', '/c').r)r"r"r"r)r)rrrseconds r+ pop_path2r!s2 y4.KED>LF 3: &&r*cv[U5up#U[URS5U5URS54$)z,Return ('/a', '/b/c') -> ('b', '/a/b', 'c').r)rjoin_urirstrip) script_name path_infosegmentrs r+ shift_pathr(s6Y'MG Xk005w?SAQ RRr*cxURS5(a!SU;aURSS5upUSSU4$SU4$)zReturn (namespace, localname) tuple for a property name in Clark Notation. Namespace defaults to ''. Example: '{DAV:}foo' -> ('DAV:', 'foo') 'bar' -> ('', 'bar') {}rbNr")rjrU) clark_namens localnames r+split_namespacer/sLS!!cZ&7"((a0 12 ""  r*c[US5nU$![a* [RSU<S35 [US5nU$f=f)zHConvert a binary string to Unicode using UTF-8 (fallback to ISO-8859-1).utf8zto_unicode_safe(z%) *** UTF-8 failed. Trying ISO-8859-1z ISO-8859-1)rLrgrr)r:rs r+to_unicode_safer2sS$ 1f  H $ (-RST 1l # H$s 0AAbackslashreplaceerrorscU(dSn[U5(a URXS9RU5nU$URXS9RU5nU$)uRe-encode str or binary so that is compatible with a given encoding (replacing unsupported chars). We use ASCII as default, which gives us some output that contains ™ and 香 for every character > 127, for easier debugging. (e.g. if we don't know the encoding, see #87, #96) ASCIIr4)rCrr)r: encoding_tor5s r+safe_re_encoder9sY  {{ HH[H 0 7 7 D H HH[H 0 7 7 D Hr*c[U5(a6U<S3nUH(n[U5[La [U5nUSU-- nM* U$U$)zReturn a string as hex dump.z: z%02x )rCrGr5ord)r:r[bs r+ string_reprr=sP{{RjAAw#~F 7Q; C SMr*cJ[RRU5SnU$)Nrb)osrsplitext)rexts r+get_file_extensionrBs ''  4  #C Jr*) thousands_seprbase1024 append_bytescSnSnU(aASnU(aUS:aUS- nUS- nUS:aMOUS:aUS- nUS-nUS:aM/SQUnU(a US:XaS nOS nU(aUS:dU(aUS nO [U5nUUU3$) z1Convert bytes into human-readable representation.r"rirb ig@@)r"KMGTPz Bytez Bytesz,d)r5) numberrCrrDrE magsuffix bytesuffix magnitudesnums r+byte_number_stringrR sIJ D.Q 2D.D.Q & D. 2)<  Q; J!J&D.I6{VI;zl ++r*) expand_vars must_exist allow_nonecUS;aU(ag[SU<35e[RRU5(dU(d[R"5nO_[ U5[ LaMURS5nU(a [RRU5nO[R"5n[RR[RRX55nU(a<[RR[RRU55nU(a3[RRU5(d[SU<35eU$)zConvert path to absolute, expand and check. Convert path to absolute if required, expand leading '~' as user home dir, expand %VAR%, $Var, ... Nr"Nz Invalid path _config_filezInvalid path: )rgr?risabsgetcwdrGrVrdirnameabspathr4 expandvars expanduserexists)rrootrSrTrU config_files r+fix_pathrb1s z =122 77==  99;D $Z4 ((>2Kww{3yy{wwrww||D78ww!!"''"4"4T":;"''....>$233 Kr*c n[S[URSS555$![a gf=f)zDReturn a positive CONTENT_LENGTH in a safe way (return 0 otherwise).rCONTENT_LENGTH)maxrlrrg)environs r+get_content_lengthrgWs71c'++&6:;<< s $' 44c URS5(dURS5(ag[U5nUS:deUS:XagSnSUS'U(aSUS'USn[US5(a{[US 5(ajURS:XaYURS:aHU(a URnOSnUR U5n[ RS US USS <S 35 ggg[US5(a[URS5(a~URnUR5nURS5 U(aUnOSnUR U5n[ RS USUSS <S 35 URU5 ggg![a%n[ RSWSU35 SnAN>SnAff=f![a. [ RS[R"535 gf=f)aCRead 1 byte from wsgi.input, if this has not been done yet. Returning a response without reading from a request body might confuse the WebDAV client. This may happen, if an exception like '401 Not authorized', or '500 Internal error' was raised BEFORE anything was read from the request stream. See GC issue 13, issue 23 See http://groups.google.com/group/paste-users/browse_frm/thread/fc0c9476047e9a47?hl=en Note that with persistent sessions (HTTP/1.1) we must make sure, that the 'Connection: closed' header is set with the response, to prevent reusing the current stream. zwsgidav.some_input_readwsgidav.all_input_readNrTrb wsgi.input _consumedlengthzReading z= bytes from potentially unread httpserver.LimitedLengthFile: 2z..._sock settimeoutz* bytes from potentially unread POST body: z-> read z bytes failed: z--> wsgi_input.read(): )rrghasattrrkrlreadrrrn gettimeoutroOSErrorrrr2exc_info) rfclREAD_ALL wsgi_inputnbodysocktimeoutses r+read_and_discard_inputr}ks {{,--=U1V1V G $B 7N7 QwH)*G %&,-()&Jz;''GJ,I,I   1 $):):Q)>%%??1%D MM1#Z[_`cac[dZggjk *? $ W % %'*2B2BL*Q*Q F##Doo'G OOA  AAA!q) qc!KDQTRTI=X[\ OOG $++R %" A ?2$?@@ A  F MM3CLLN3CD E Fs<-G =FG  G"G=G GG 5HH src_exception err_condition add_headersc[U[5(a [U5nO [UUUUUS9n[R SUR 535 Ue)z$Wrapper to raise (and log) DAVError.r~zRaising DAVError )r>rrrrr get_user_info)rr context_inforrrrs r+failrsW%##     ''#   MM%aoo&7%89: Gr*cb^\rSrSrU4Sjr\S5r\S5r\S5rSSjr Sr U=r $) SubAppStartResponseicL>SUl/UlSUl[TU]5 grW)_SubAppStartResponse__status&_SubAppStartResponse__response_headers_SubAppStartResponse__exc_infosuper__init__)self __class__s r+rSubAppStartResponse.__init__s$ "$ r*cUR$r)rrs r+statusSubAppStartResponse.statuss }}r*cUR$r)rrs r+response_headers$SubAppStartResponse.response_headerss&&&r*cUR$r)rrs r+rtSubAppStartResponse.exc_infos r*c(XlX lX0lgr)rrr)rrrrts r+__call__SubAppStartResponse.__call__s "2"r*) __exc_info__response_headers__statusr) r$r%r&r'rpropertyrrrtrr) __classcell__)rs@r+rrsN''##r*rcdSRU5nU(dU$URS5S-U-$)z=Append segments to URI. Example: join_uri("/a/b", "c", "d") r)r4r$)urisegmentssubs r+r#r#s2 ((8 C  ::c?S 3 &&r*rcHURS5RS5S$)z,Return local name, i.e. last segment of URI.rrc)rTrUrs r+ get_uri_namers 99S>   $R ((r*cU(aUR5S:XagURS5RSS5SS-$)zReturn URI of parent collection with trailing '/', or None, if URI is top-level. This function simply strips the last segment. It does not test, if the target is a 'collection', or even exists. rNrbr)rTr$rrs r+get_uri_parentrs< #))+$ ::c? ! !#q )! ,s 22r* parent_uri child_uric[U5=(aD [U5=(a2 URS5RURS5S-5$)zReturn True, if child_uri is a child of parent_uri. This function accounts for the fact that '/a/b/c' and 'a/b/c/' are children of '/a/b' (and also of '/a/b/'). Note that '/a/b/cd' is NOT a child of 'a/b/c'. r)rr$rjrrs r+ is_child_urir sM Z K O K   S ! , ,Z->->s-Cc-I Jr*cU=(a> U=(a5 URS5S-RURS5S-5$)zReturn True, if child_uri is a child of parent_uri or maps to the same resource. Similar to _ , but this method also returns True, if parent equals child. ('/a/b' is considered identical with '/a/b/'). r)r$rjrs r+is_equal_or_child_urirsI  S  S   c "S ( 4 4Z5F5Fs5Kc5Q Rr*cUSS-nURS5(aX S- nO9X S- nUSS:XaUSS:wa USUS-- nOUSS :wa USUS-- nU[URS S 55- nUcAU[URS S 55- nURS 5(a USUS -- nU$X!- nU$)zkURL reconstruction according to PEP 333. @see https://www.python.org/dev/peps/pep-3333/#url-reconstruction zwsgi.url_schemez:// HTTP_HOST SERVER_NAMEhttps SERVER_PORT443:80 SCRIPT_NAMEr" PATH_INFO QUERY_STRING?)rr )rf local_uriurls r+make_complete_urlr$s # $u ,C{{; {## }%% $ % 0}%.sW]333}%-sW]3335]B/ 00C uW[[b122 ;;~ & & 300 0C J  Jr*c,UVVs0sHup#UR5X#4_M nnn[U5H1unupgURUR5S5nUcM-XU'M3 UR5Hn UR U 5 M gs snnf)z@Modify or append new headers to existing header list (in-place).N)r enumeraterirwr) target new_itemsrrxnew_dictidxr_valuenew_valrrs r+update_headers_in_placerAs.78ida A6!iH8(0^d,,tzz|T2  !3K 1" e# 9sB) allow_emptyc vURSS5R5nUS:XaSnOE[U5nUS:a[[S5eUS:XaSnOUSR U5nSUS 'US:XaU(ag[[S 5e[R"U5nURS 5(a>[RSRUS[[USS9555 SUS 'U$![ a [[S5Sef=f![an[[S US 9SeSnAff=f)a}Read request body XML into an etree.Element. Return None, if no request body was sent. Raise HTTP_BAD_REQUEST, if something else went wrong. TODO: this is a very relaxed interpretation: should we raise HTTP_BAD_REQUEST instead, if CONTENT_LENGTH is missing, invalid, or 0? RFC: For compatibility with HTTP/1.0 applications, HTTP/1.1 requests containing a message-body MUST include a valid Content-Length header field unless the server is known to be HTTP/1.1 compliant. If a request contains a message-body and a Content-Length is not given, the server SHOULD respond with 400 (bad request) if it cannot determine the length of the message, or with 411 (length required) if it wishes to insist on receiving a valid Content-Length." So I'd say, we should accept a missing CONTENT_LENGTH, and try to read the content anyway. But WSGI doesn't guarantee to support input.read() without length(?). At least it locked, when I tried it with a request that had a missing content-type and no body. Current approach: if CONTENT_LENGTH is - valid and >0: read body (exactly bytes) and parse the result. - 0: Assume empty body and return None or raise exception. - invalid (negative or not a number: raise HTTP_BAD_REQUEST - missing: NOT: Try to read body until end and parse the result. BUT: assume '0' - empty string: WSGI allows it to be empty or absent: treated like 'missing'. rdr"rzNegative content-length.zcontent-length is not numeric.NrjrbrizBody must not be empty.zInvalid XML format.)rzwsgidav.dump_request_bodyz{} XML request body: {}REQUEST_METHODTprettyF)rrTrlrr rgrqr fromstringrrinforrLr)rfrclHeader requestbodycontent_lengthrootELrs r+parse_xml_bodyrSs^L{{+R0668H2~   Y ]N!/1KLL" Q K!,/44^DK01G, -b +-FG G!!+.{{.// & - -()|F489  05+, MA Y+-MNTX X Y"  31  s#!C:D:D D8#D33D8c8U"SSS[54SU4/5 S/$)4Start a WSGI response for a DAVError or status code.z301 Moved PermanentlyContent-Length0DateLocationr*)r)rfstart_responselocations r+send_redirect_responsers4 # %' (  "  5Lr*)ris_headc P[U5n/nU(aURU5 [U[5(a,UR(aURUR5 U[ [ 4;aU"USS[54/U-5 S/$U[[4;a [U5n[U[5(deUR5upxU(aSn[U5(dU5eU"USU4S[54S[[U554/U-5 U/$)rrrr* Content-Typer)rextendr>rrrrrrrget_response_pagerCr5r) rfrrrrrheaders content_typerys r+send_status_responsers$A &FG{#!X1==q}}%   00 ,v7G7I.JKgU u Wl ## QK a " "" ",,.L D>>4> \ * %' ( s3t9~ .    6Mr*c "URS5(a*SRUS[[USS955nX0S'[USS9n[ U5(dU5eSS[ 54S [ [U554/nU"S U5 U/$) Nzwsgidav.dump_response_bodyz{} XML response body: {}rTrF)rzapplication/xml; charset=utf-8rrz207 Multi-Status)rrrLrrCrr5r)rfrmultistatus_elemxmlxml_datars r+send_multi_status_responsers{{/00)00 $ % < 0> ? 14,- ,U;H H  'x'  ; !#$ 3s8}-.G%w/ :r*cSn0n0n0nUHyupxSn [U[5(a [U5n Sn[U5upU S:waX;aU S:waSXJ'XSU3'US- nUR U /5R Xx45 M{ [ USUS 9n U[R"U S 5l UHn [R"U S 5n [R"U S 5nXiHgupxUc[R"X5 M [U5(aUR U5 MC[U5[R"X5l Mi S U 3[R"U S5l M g)aAppend element to element. node depends on the value type: - str or unicode: add element with this content - None: add an empty element - etree.Element: add XML element as child - DAVError: add an empty element to an own for this status code @param multistatus_elem: etree.Element @param href: global URL of the resource, e.g. 'http://server:port/path'. @param prop_list: list of 2-tuples (name, value) rbz200 OKNzDAV:r"TNSz{DAV:}response)nsmapz {DAV:}hrefz{DAV:}propstatz {DAV:}propz HTTP/1.1 z {DAV:}status) r>rrr/ setdefaultrrr SubElementtextrr2)rhref prop_listnsCountnsDictnsMappropDictrrrrr-_ responseEL propstatELpropELs r+add_property_responsersmG F EH  eX & &+E2FE % "` header. Note that we also reject weak entity tags (W/""), since WebDAV servers commonly use strong ETags. N"W/Invalid ETag format: ''.)rTrjrg)etagrUs r+ checked_etagr `sJ |  ::? 77>>+ , ,9~'')) GG% &E ||w9~'')*!E$--,@+A5CVBW X K $%QuT]]';&Q=RS Kr*z(([0-9]+)-([0-9]*))z (-([0-9]+))c /nURS5nUGH&nSnU(d[RU5nU(a[UR S55nXq:a[ [ SUSUS3SSU34/S 9 UR S 5S :XaUS - nO[UR S 55nXx::a#Xq:aX:aUS - nURXx45 S nU(aM[RU5nU(dMU[UR S55- nUS:aSnUS - nURXx45 S nGM) UR5 /n Sn [U5S:aUR5up[U5n U S:aBX-S - upXS - :dXS -:aO[X5n [X5n X-S - U S - n U S:aMBU RXX- S -45 X-U - S -n [U5S:aMX4$)aP See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range Return tuple (range_list, total_length) range_list content ranges as values to their parsed components in the tuple (seek_position/abs position of first byte, abs position of last byte, num_of_bytes_to_read) total_length total length for Content-Length rPFr0z)Requested range starts behind file size (z >= r/z Content-Rangezbytes */)rrr"rbTr)rUreByteRangeSpecifiersearchrlgrouprrrreSuffixByteRangeSpecifiersortrriminre) range_headerfilesize list_rangesrequest_rangessubrange is_matchedmatch range_start range_end list_ranges_2 total_length rfirstposrlastposcounter nfirstposnlastposs r+obtain_content_rangesr2s)K!'',N" (//9E!%++a.1 *2CK=PTU]T^^_`&5(7L%M$N ;;q>R' (1 I!$EKKN 3I+ 0F ,$,qL && '?@!%Jz.55h?Eu&U[[^)<< ?"#K$qL ""K#;<! I#NML k Q  + 1k"k$/! $< !Ya-'9!|+C 5 x2! ,kGk i83G!3KLM#.:Q>  k Q   ((r*izsecond\-([0-9]+)c SnURS5nUHknUR5nUR5S:Xa g[R U5nUH'n[ U5nU[ :a gUS:wdM#Us s $ Mm g)z-Return -1 if infinite, else return numofsecs.rrPinfinitercN)rUrTrreSecondsReaderfindallrlMAX_FINITE_TIMEOUT_LIMIT) timeoutvalue timeoutsecstimeoutvaluelist timeoutspeclistSRrs r+read_timeout_value_headerr=sK#))#.' !'')    * ,$,,[9F!$i !99!#&&  ( r*cU(dgSU;aTUR5(a?[US5nSnUHnXb:XdUS:XdMSn O U(d[[S5eSnSU;a1UR 5(a[ US5nU(aX:aSnSn SU;aiUR5(aT[US5nUH>nXb:XdUS:XdMUS S ;aU(d[[ S 5e[[S 5e Sn S U;a?UR 5(a*[ US 5n U (aX:a[[S5eU(aU (d[[ S5eg)aHandle 'If-...:' headers (but not 'If:' header). If-Match @see: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.24 Only perform the action if the client supplied entity matches the same entity on the server. This is mainly for methods like PUT to only update a resource if it has not been modified since the user last updated it. If-Match: "737060cd8c284d8af7ad3082f209582d" If-Modified-Since @see: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25 Allows a 304 Not Modified to be returned if content is unchanged If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT If-None-Match @see: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26 Allows a 304 Not Modified to be returned if content is unchanged, see HTTP ETag If-None-Match: "737060cd8c284d8af7ad3082f209582d" If-Unmodified-Since @see: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28 Only send the response if the entity has not been modified since a specific time. N HTTP_IF_MATCHF*Tz If-Match header condition failedHTTP_IF_MODIFIED_SINCEHTTP_IF_NONE_MATCHr)GETHEADzIf-None-Match header failedz%If-None-Match header condition failedHTTP_IF_UNMODIFIED_SINCEz+If-Unmodified-Since header condition failedz)If-Modified-Since header condition failed) support_etagr rrsupport_modifiedrr) dav_res last_modified entity_tagrf token_listr(tokenifModifiedSinceFailed ifmodtimeignoreIfModifiedSince ifunmodtimes r+evaluate_http_conditionalsrQs0 '!g&:&:&<&<*7?+CD E"esl 35WX X"7*w/G/G/I/I%g.F&GH 2$( !"w&7+?+?+A+A*73G+HI E"esl,-@1"#46STT,.U !%!W,1I1I1K1K'0J(KL ;6(*W %:(*UVV r*z(\<([^>]+)\>)|(\(([^\)]+)\))z\<([^>]+)\>([^<]+)z \(([^)]+)\)z(\S+)c SU;agSU;a SUS'/US'gUSR5nURS5(dSU-n[/5n/nSn[R U5HupVpxUS:waUnM/n S n [ R U5Hn U R 5S :wa}U RS 5(a$U RU S U RS 545 OCU RU SU RS545 URU RS55 U R 5S :gn M XB;aX$n O/n XU'U RU 5 M X S'X0S'[RS[U535 g)zParse HTTP_IF header into a dictionary and lists, and cache the result. @see http://www.webdav.org/specs/rfc4918.html#HEADER_If zwsgidav.conditions.ifNHTTP_IFzwsgidav.ifLockTokenListr@r"TNOTr`entityz"[] locktokenz<>zparse_if_header_dict ) rTrjrV reIfSeparatorr6reIfTagListContentsupperrrrr) rfiftextifDict ifLockList resource1 tmpURLVarURLVar_tmpContentVar contentVarlistTagContentstestflaglistitemlistTags r+parse_if_header_dictrgxs ')+/'(-/)* Y  % % 'F   S ! ! "XFJI9F9N9Nv9V5 > ?I OH/77 C>>#u,**3//'..%x1FG(..%{HNN44HI#))(..*>?#>>+u4D" +$+y! NN? +1:W4(. #$)3 %& MM*76?*;<= r*c h[RSUSUSUS35 X!;aXnO SU;aUSnOgUR5nUHQnSnUH=upn U S:Xa U(aXK:Hn OU S:XaU n O U S:XaX;n OSn X:Hn U (aM;Sn O U(aMQ g [RS 5 g) Nztest_if_header_dict(rQr/r@TFrVrWz -> FAILED)rrrF)rHif_dictfullurllocktoken_listrJlistTestsupportEntityTag listTestConds matchfailedrd checkstyle checkvalue testresult checkresults r+test_if_header_dictrts MM( N3C2j\QRST# 3<++-!  0= ,H*X%*:'5 x'% {*'9 ! $0K;" 1>{#"$ MM- r*z audio/oggz video/oggz video/webmzapplication/yaml)z.ogaz.oggz.ogvz.webmz.ymlz.yamlc[R"U5upU(dR[RR U5Sn[ R U5n[RSUSU35 U(dSnU$)zzUse the mimetypes module to lookup the type for an extension. This function also adds some extensions required for HTML5 rbz mimetype(z): zapplication/octet-stream) mimetypes guess_typer?rr@ _MIME_TYPESrrr)rmimetype _mimeencodingrAs r+guess_mime_typer{sg !* 4 4S 9X ggs#A&??3' #c(45 - Or*)r1r)F)r-N)r(rrcollections.abcrrrvr?rerr2rr6rr email.utilsrrhashlibrpprintrtypingrr r urllib.parser rr wsgidav.dav_errorr rrrrrrrrrwsgidav.xml_toolsrrrr __docformat__rrrr4r3r5r8getfilesystemencodingrpublic_wsgidav_infopublic_python_infor rr<rArCrErJrLrRr\rdr|rrrrrrrrrrrrrrr rrrr!r(r/r2r9r=rBrRrbrgr}rrr#rrrrrrrrrrrrrr r rcompilerrr2r7Ir5r=rQrX reIfHeader reIfTagListrYrgrtrxr{r@s0r+rs  -,,   VU"    , -3+;+;BQ+?@+?a3q6+?@A..0 ! .~./   eCj T &'     !e  )3:u:@$) ,$(TE2pP"(/c32B BA "Fy x9>  .  >BtGT<@INC4C'S  .@ &  "UTPT$,N)-$ L(GFX   4##>')c)c) 33 3 S S T  :  $,1TD 04U(V@=QJ &+",Lzz"78ZZ 6G)^3**0"$$70S l :; ZZ- . jj( jj*2 jR        a5As5K