+ 4jkURtRt^RIt]PR8Ht]^RI t Rt RitRjRkRlRRPRR 43RmRnRoRpRqRrRsRtRuRvRw3tRxtRytR t.RzOt]!]!]]4R R R R R R R R R R R 7 t]!R{/]BtRt]!4t]!R]!4P7444tRt]!R]P7444t]!R]P7444tR|Rlt /] n!R}Rlt"] PF!R4t$R~t%R}Rlt&Rt'RRlt(] !R4t)] !R4t*Rt+RRlt,R],n-/RRbRR bR!R bR"R#bR$R%bR&R'bR(R)bR*R+bR,R-bR.R/bR0R1bR2R3bR4R5bR6R7bR RbR8R9bR:R9b/R;RR?bR@RAbRBRAbRCR%bRDR%bRER%bRFR%bRGR%bRHRIbRJRKbRLRMbRNRObRPR?bRQR#bRRRSbCRTRURVRWRXRYRZR[R\R]R^R_R`Ra/C],n.Rbt/]0Rc8Xd]PbRd,'g(]2!Re4]2!RfPg]4!]444R#]Pb^,Rg8Xd*]F!t5]2!]5Rh,4]2!]]5,4K# R#]PbRd,Ft5]2!]]5,4K R#R# ]d]tELVi;i ] d ^RI t Rt ELci;i)uu Parsing and validation of URIs (RFC 3986) and IRIs (RFC 3987). This module provides regular expressions according to `RFC 3986 "Uniform Resource Identifier (URI): Generic Syntax" `_ and `RFC 3987 "Internationalized Resource Identifiers (IRIs)" `_, and utilities for composition and relative resolution of references. API --- **match** (string, rule='IRI_reference') {match.__doc__} **parse** (string, rule='IRI_reference') {parse.__doc__} **compose** (\*\*parts) {compose.__doc__} **resolve** (base, uriref, strict=True, return_parts=False) {resolve.__doc__} **patterns** A dict of regular expressions with useful group names. Compilable (with regex_ only) without need for any particular compilation flag. **[bmp_][u]patterns[_no_names]** Alternative versions of `patterns`. [u]nicode strings without group names for the re_ module. BMP only for narrow builds. **get_compiled_pattern** (rule, flags=0) {get_compiled_pattern.__doc__} **format_patterns** (\*\*names) {format_patterns.__doc__} Dependencies ------------ Some features require regex_. This package's docstrings are tested on python 2.6, 2.7, and 3.2 to 3.6. Note that in python<=3.2, characters beyond the Basic Multilingual Plane are not supported on narrow builds (see `issue12729 `_). Release notes ------------- version 1.3.8: - fixed deprecated escape sequence version 1.3.6: - fixed a bug in IPv6 pattern: >>> assert match('::0:0:0:0:0.0.0.0', 'IPv6address') version 1.3.4: - allowed for lower case percent encoding version 1.3.3: - fixed a bug in `resolve` which left "../" at the beginning of some paths version 1.3.2: - convenience function `match` - patterns restricted to the BMP for narrow builds - adapted doctests for python 3.3 - compatibility with python 2.6 (thanks to Thijs Janssen) version 1.3.1: - some re_ compatibility: get_compiled_pattern, parse - dropped regex_ from setup.py requirements version 1.3.0: - python 3.x compatibility - format_patterns version 1.2.1: - compose, resolve .. _re: http://docs.python.org/library/re .. _regex: http://pypi.python.org/pypi/regex Support ------- This is free software. You may show your appreciation with a `donation`_. .. _donation: http://danielgerber.net/¤#Thanks-for-python-package-rfc3987 z1.3.8NiTF IPv6addressa(?: (?:{h16}:){{6}} {ls32}| :: (?:{h16}:){{5}} {ls32}| (?: {h16})? :: (?:{h16}:){{4}} {ls32}| (?:(?:{h16}:)? {h16})? :: (?:{h16}:){{3}} {ls32}| (?:(?:{h16}:){{,2}}{h16})? :: (?:{h16}:){{2}} {ls32}| (?:(?:{h16}:){{,3}}{h16})? :: (?:{h16}:) {ls32}| (?:(?:{h16}:){{,4}}{h16})? :: {ls32}| (?:(?:{h16}:){{,5}}{h16})? :: {h16} | (?:(?:{h16}:){{,6}}{h16})? :: ) pathipathc /p\RRR1,\RRR1,,\RRR1,,FLwr#W 9d.W,p\V4'd V!V4pM RV: RV: R2pVP!R/VBW&KN V#)atReturns a dict of patterns (regular expressions) keyed by `rule names for URIs`_ and `rule names for IRIs`_. See also the module level dicts of patterns, and `get_compiled_pattern`. To wrap a rule in a named capture group, pass it as keyword argument: rule_name='group_name'. By default, the formatted patterns contain no named groups. Patterns are `str` instances (be it in python 2.x or 3.x) containing ASCII characters only. Caveats: - with re_, named capture groups cannot occur on multiple branches of an alternation - with re_ before python 3.3, ``\u`` and ``\U`` escapes must be preprocessed (see `issue3665 `_) - on narrow builds, character ranges beyond BMP are not supported .. _rule names for URIs: http://tools.ietf.org/html/rfc3986#appendix-A .. _rule names for IRIs: http://tools.ietf.org/html/rfc3987#section-2.2 Nz(?P<>)) _common_rules _uri_rules _iri_rulescallableformat)names formattednamepatns, Y/home/user/pdf2html-billing-ledger-validate/.venv/lib/python3.14/site-packages/rfc3987.pyformat_patternsr!s4I"4R4(:dd+;;j2>NNN  = A{{f'(-**1y1 O ) path_abempty path_absolute path_noscheme path_rootless path_empty ipath_abemptyipath_absoluteipath_noschemeipath_rootless ipath_emptycBVPR4PR4#)asciizraw-unicode-escape)encodedecode)strings&r_interpret_unicode_escapesr(^s == ! ( ()= >>rc#@"TFwrV\V43xK R#5iN)r(.0kvs& r r/es&86BE18;<6c2\P!RRV4#)z\\U[0-9A-F]{8}-\\U[0-9A-F]{8}r)_resub)ss&rr5hs92qArc#@"TFwrV\V43xK R#5ir*)_bmpr+s& rr/r/ks=,>> uri = get_compiled_pattern('^%(URI)s$') >>> assert uri.match('http://tools.ietf.org/html/rfc3986#appendix-A') >>> assert not get_compiled_pattern('^%(relative_ref)s$').match('#f#g') >>> from unicodedata import lookup >>> smp = 'urn:' + lookup('OLD ITALIC LETTER A') # U+00010300 >>> assert not uri.match(smp) >>> m = get_compiled_pattern('^%(IRI)s$').match(smp) On narrow builds, non-BMP characters are (incorrectly) excluded:: >>> assert NARROW_BUILD == (not m) For parsing, some subcomponents are captured in named groups (*only if* regex_ is available, otherwise see `parse`):: >>> match = uri.match('http://tools.ietf.org/html/rfc3986#appendix-A') >>> d = match.groupdict() >>> if REGEX: ... assert all([ d['scheme'] == 'http', ... d['authority'] == 'tools.ietf.org', ... d['path'] == '/html/rfc3986', ... d['query'] == None, ... d['fragment'] == 'appendix-A' ]) >>> for r in patterns.keys(): ... assert get_compiled_pattern(r) ) get_compiled_patterncache NARROW_BUILDREGEX bmp_patternsbmp_upatterns_no_namespatternsupatterns_no_namesgetr2compile)ruleflagsr;keypatsps&& rr:r:qsfB&++d]3  <#(5<.DD$u8*>> assert match('%C7X', 'pct_encoded') is None >>> assert match('%C7', 'pct_encoded') >>> assert match('%c7', 'pct_encoded') z ^%%(%s)s$)r:match)r'rDs&&rrJrJs d 2 3 9 9& AArzm^((?P[^:/?#]+):)?(//(?P[^/?#]*))?(?P[^?#]*)(\?(?P[^#]*))?(#(?P.*))?cT\'gV'dV\9d \V4hV'dL\W4pV'g\V: RV: R24h\'d\ VP 44#\ \ PV4P 44#)a Parses `string` according to `rule` into a dict of subcomponents. If `rule` is None, parse an IRI_reference `without validation `_. If regex_ is available, any rule is supported; with re_, `rule` must be 'IRI_reference' or some special case thereof ('IRI', 'absolute_IRI', 'irelative_ref', 'irelative_part', 'URI_reference', 'URI', 'absolute_URI', 'relative_ref', 'relative_part'). :: >>> d = parse('http://tools.ietf.org/html/rfc3986#appendix-A', ... rule='URI') >>> assert all([ d['scheme'] == 'http', ... d['authority'] == 'tools.ietf.org', ... d['path'] == '/html/rfc3986', ... d['query'] == None, ... d['fragment'] == 'appendix-A' ]) z is not a valid .)r=REFERENCE_RULES ValueErrorrJ_i2u groupdict_iri_non_validating_re)r'rDms&& rparserSss( 5Td/9 & EF F 5 & & &,,V4>>@ AArclRF-wrVPV4eKVPV4W&K/ V#) authority))rU iauthority)rr)queryiquery)fragment ifragment)rB)dicrinames& rrOrOs6J  774= CIJ Jrc  \\44Rp VeWR,, p VeV RV,, p Y;'gR, p VeV RV,, p VeV RV,, p V #)ziReturns an URI composed_ from named parts. .. _composed: http://tools.ietf.org/html/rfc3986#section-5.3 r:z//?#)rOlocals) schemerUrrWrYrVrrXrZkwress &&&&&&&&&, rcomposerest  N C  | ti::2C  sU{ sX~ Jrz$^(?:\.{1,2}(?:/|$))+|(?<=/)\.(?:/|$)z/?%(segment)s/\.{2}(?:/|$)c|\PRV4p^pV'd\PRV^4wrK#V#)r/) _dot_segmentsr3_2dots_segmentssubn)rcs& r_remove_dot_segmentsrls9   b$ 'D A "''T15a KrcF\V\4'd\VR4pM\\ V44pVP R4'g\ RV,4h\V\4'd\VR4pM\\ V44pVR,'d"V'gVR,VR,8wdTpEM1/pVR,VR&VR,e&VR,VR&VR,VR&VR,VR&MVR,VR&VR,'dVR,R,R 8XdVR,VR&MmVR,e$VR,'gR VR,,VR&M?R PVR,PR 4R ,4VR,,VR&VR,VR&M0VR,VR&VR,eVR,VR&M VR,VR&VR ,VR &\VR,4VR&V'dV#\R/VB#)aResolves_ an `URI reference` relative to a `base` URI. `Test cases `_:: >>> base = resolve.test_cases_base >>> for relative, resolved in resolve.test_cases.items(): ... assert resolve(base, relative) == resolved If `return_parts` is True, returns a dict of named parts instead of a string. Examples:: >>> assert resolve('urn:rootless', '../../name') == 'urn:name' >>> assert resolve('urn:root/less', '../../name') == 'urn:/name' >>> assert resolve('http://a/b', 'http:g') == 'http:g' >>> assert resolve('http://a/b', 'http:g', strict=False) == 'http://a/g' .. _Resolves: http://tools.ietf.org/html/rfc3986#section-5.2 IRIrbz&Expected an IRI (with scheme), not %r. IRI_referencerUrrW:NNrgz/%sr:NNrYr ) isinstance basestringrSrOdictrBrNjoin rpartitionrlre)baseurirefstrict return_partsBRTs&&&& rresolver~s.$ ## $  d  55??ADHII&*%% &/ * f  {{!H+8"<  k( [> %{^AkN& AfI7AgJ{^AkNyyV9R=C' !& AfI{^/& %& 1AfI "& (<(r?r:r;rJrCrQrMrSrOrerhrirlr~test_cases_base test_casesr__name__argvprintrusortedrr rrrs&jV &(  E  *1 ;O R( *7(:AE*7($'%A" J) \7 t#L  301BCvVV'' 1  10 1?$%8,.44688B=HNN,<== D):)@)@)BDD)T  BAB4 B>(%%LM &'DEDL/* u*'* '* ( *  | *  z * +* )* -* )* +* (* )*-*+* !*" #*$ }%*& }'*( ~)** {+*, {-*.|/*0|1*2|3*4 |5*6 |7*8 (9*: (;*< )=*> )?*@ ~A*B (C*D )E*F '-' -. -.S*Z  z 99R== ?@ diix()* 1 D $*  (4. !IIbMMD (4. !"_J  Es"I%I5% I21I25 JJ