A. HISTORY OF THE SOFTWARE =l Python was created in the early 1990s by Guido van Rossum at Stichting Mathematisch Centrum (CWI, see http://www.cwi.nl) f&Netherlands as a successor of a language called ABC. remains 4's principal author, although it includes many contributions from o`s. In#5,h+inued his work onv.pCorporaNa for N al Research Initiatives (CNRnri.reston.va.us) inAton, Virginia where he released several vers of softwareMay 20000and&core development team moved to BeOpen.com tom=DALabs7. In Octobe#same year,:3j Digital C, which becCWZope pmH2001Y# Sa Found` (PSF,r https:p.org/psf/) formed, a non-profit organizM 0pspecifiy$owA-relSIntellectual Property. ya sponsoring memBPSF. Allp`s are  Source (svQopens 3@Defion). Histor, most, but not all, s have also been GPL-compatible;table below summarizesuvarious. R @Deri @YearDOwne z= R? (1)0.9.0 thru 1.261991-1995 CWI1yes41.3:5<A7<9<%NR=<6P !1.C  <!now42.0&1.K2  ;T1.6.1 ; ;'y#2){#D2.0+Td PSF {92.0{;-;2.1<$1+Pw<L5200<3 <1< 2 babove <=@-now[ x Footnotes: (1) GPL@-compatible doesn't mean that we're distributing Python under the GPL. Alllicenses, unlike&, let youUeFa modified version without makyyour changes open source. ThE8GPLBe it possto combinemother softwarat is released; 3s don't. (2) Accord to Richard Stallman, 1.6.1W0not=,`becaus#s  has a choice of law cl'|qBCNRI, however,| 's81yerOPtold *G@is "&in)"GPL. Thanks tomany outside volunteers who have workJGuido's direct"toTtheseys). B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE UPYTHON =+# 'and documenta=59S`RFound2L4# V2. Starw3.8.6, exampldPrecip  code in th DdualX] PSF  VHaZero-CrD BSDA6ome4,rporated into#is?differentDes. The >sA@fallS|b SOFTWARE FOUNDA LICENSE VERSION 2 - 1. ThisHAGREEMENT`betwee1M ("PSF"), NaIndivior Organiz #("e") accessAand awise ut"("D") i  or binary form its associ . 2. SubjectPterms;` condis` Agree,Ihereby grantsWe a nonexclusive, royalty-free,@ld-w;reproduce, analyze, test, per0/orVplay publicly, prepNderivati5s, e[PaloneC0in G, providedoFEPSF'G3notcopyright, i.e., "C (c) 2001,23456789q10, 201<1<13, 2014, 2015a, 2016789!201$2 Python Software Foundation; All Rights Reserved" %retained inAalone or.any derivative version prepared by Licensee. 3. In the event 08s aNwork that is based on ycorporates0or @partb reof, and wants to make }cavailable& others as provided herein,W$n by agree`tincludeRsuch ` brief summary ofchanges madz. 4. PSFdmaking on an "AS IS" basis. AMAKES NO REPRESENTATIONS OR WARRANTIES, EX IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMIK,hAND DISCLAIMS ANYzyZMERCHANTABILITYFITNESS FORAPARTICULAR PURPOSE&THAT THE UF PYTHON WILL INFRINGEC`THIRD IY RIGHTS. 5d2SHA3 BE LIABLE TO LICENSElPOTHERm RSoPINCID^L, SPECIAL,CONSEQUENTIAL DAMAGEf LOSS AS A RESULTTMODIFYING, DISTRIBUT1OR 0WIS3ING#, $DERIVATIVEREOF, EVEN IF ADVISEDb0SPOSSInEOF. 6. This Amwill automatically terminate up| material breach of irAermsPcondihs. 7. Nothi wshall be deemed0cretqany rel@shipnagency, 0ner,`joint jure between5and/. does not grant ps0useK trademarkssB nam  s9aendorsApromote productB}@icesQthird y. 8. By copying, installZ1or pwise us^,&e @be b   t$ $. BEOPEN.COM; AGREEMENT 2o 2.0 -Y e` SOURChVERSION 1 1%J BeOpen.com (" p"), hav0(an office at 160 Saratoga Avenue, Santa Clara, CA 95051tthe IndividualqOrganiz4 ("") acces  tsin source or binar:y form and its associated documentation ("the Software"). 2. Subject to QtermsLPcondi9s of this BeOpen Python License Agreeg,!hereby grants(e a non-exclusive, royalty-free, world-wide l[reproduce, analyze, test, per and/or display publicly, prepare derivatived0ks,,atributVd otherwise use ' alone or in anyMversion, provided, however, thatI4 is retainedYDthe r,sEd by`T. 3.is making\ available[0e of "AS IS" basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITK,kAND DISCLAIMS ANY}|Y]MERCHANTABILITYFITNESS FORAPARTICULAR PURPOSE&THAT THE UF SOFTWARE WILL INFRINGEI`THIRD OY RIGHTS. 4.2SHA6 BE LIABLE TO LICENSEuPOTHERv RSETHE xPINCIDpL, SPECIAL,CONSEQUENTIAL DAMAGELOSS AS A RESULTZUSING, MODIFYINGADISTRIBUT{_ANY DERIVATIVEREOF, EVEN IF ADVISED]<SPOSSIxEOF. 5. T3d % will automatically uinate up material breach( O. 6lshall be goverm!byinterpretall respectsS0lawx Stof California, dbconflict of 6F@Noth%"inDdGd to crerp1rel@shipPagenc`artner,joint venture betweeny?e. does notp permis-trademarksy` names!a  s =aendorsGpromote tCqserviceiany third party. A| epi3e "w" logosat http://www.plabs.com/-.html may-used accorts! ed9web page. 7. By copying, install8or h]s, aRs9qbe boun-d conditions: of this License Agreement. CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 ---a 1. Tn Tis between the Corporation for N :al Research Initiatives, having an office at 1895 Preston White Drive, Re, VA 20191 ("q"), andIndividual or Organiz3 (",e") access|d otherwise ubPython% software in source[`binarym}its associated docu{. 2. Subject toQterms;Pcondi2s  , hereby grante a nonexclusive, royalty-free, world-wide l.reproduce=alyze, test, perfor /or display publicly, prepQderivd0ks,,atributV Y(e WQ alonJwin any Mversion, provided, however, that 3's &O)`'s notQof copyright, i.e., "C (c) 1995-2001 p; All RYs`rved" retained in   ]Dd bye. Alternately,W@lieu/ ,= may substitute}`followtext (omitthe quotes): " is made availableU #in". UP togei with ~abe loc`oo in#etq uniquesistent identifier (known as a handle):|.22/1013SIalso be ob`from axy server  V  URL: http://hdl.P.net/". 3. I eve,?Bwork(ased on or inc*es!or@part @reof1d wito make i"toI   in$ene@by as`includeAsuchU a brief summr!ofcchange)toQ. 4.wk N Oo "AS IS" basis. HMAKES NO REPRESENTATIONS OR WARRANTIES, EX IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMIK iAND DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILIR FITNESS FOR ANY PARTICULAR PURPOSEETHAT THE UF PYTHON 1.6.1 WILL NOT INFRINGEIQTHIRDOY RIGHTS. 5. CNRI SHA4 BE LIABLE TO LICENSEsPOTHERt RSv vINCIDENTAL, SPECI OR CONSEQUENTIAL DAMAGESLOSS AS A RESULTZMODIFYING, DISTRIBUT1OR 0WIS9ING#, 7DERIVATIVE'REOF, EVEN IF ADVISEDhCSPOSSILEOF. 6. This License Agreement will automatically terminate upon a material breach of its (s and conditions. 7l+shall be governed by the federal intellectual property laws)United States, including without limitaY copyrightM,A, to#0extsuch U.S.* does not apply, Commonwealth of Virginia, ex 's*PflictFbprovis:0NotAstanforegoing,p regardderivative works based on Python?@that(Porpornon-separable (was previously distribusQunder1pGNU Genu PublicW`(GPL),& of  #   ' t ponly asissues aris$or spect to Paragraphs 4, 5 7rdp. NothT!in (@be d90creQqany relu@shipagency, partner , or joint venture between4andH1e. pgrant ps@!2useLptradema1or  name in a ! s to endorseppromoteducts or servicesDeQthirdy. 8. By clickQoQe "ACCEPT" button wherqdicatedL!by installBr otherwise u,5 a*ube boun`3 d CWI@ AGREEMENT &7 0.9.0 THROUGH 1.2 -5 C(c) 1991 -5, StichtPMathesch Centrum Amsterdam, The Ne4lands. All @s reled. P=,, modify8 this software and its documentation for any purpose &Fwithout fee is hereby granted, provided that the above copyright notice appear in all1iesa9R bothC9n]is permiss T supporting ,cname of Stich.Mathematisch Centrum or CWI not be used pdvertiseor publicity@tainto distribuR!ofxsoftware N specific, written prior P. STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDV7xIMPLIED?OF MERCHANTABILITY AND FITNESSA NO EVENT SHE BE LIABLE FOR ANY SPECIALLDIRECT OR CONSEQUENTIAL DAMAGES2 WHATSOEVER RESULFROM LOSS OF USE, DATA;PROFITS, WHETHER IN AN ACTION.CONTRACT, NEGLIGENCE9O.TORTIOUS 1`, ARIS;`OUT OF) IN"NER{0THEPERFORMAV8F T . ZERO-CLAUSE BSD LICENSE (@CODENPYTHON DOCUMENTA/ -26 PX to,y, modifyCE/or ue this 7 7D;0.  IS PROVIDED "AS IS"w %oAUTHOR $ R f  S AND . C, IN    >O6?CON  """Recordy#phased-in incompatible language changes. Each linvGform: FeatureNC= "_P(" OpzalRelease "," MandatoryGKCompilerFlag ")" w, normally,js. O4also be None, meaning a planned vgot dropppstancessclass _ two correspondXmethods, .getp() and  (). CompilerFlag i(bitfield) fpp shouldpassed iourth argument&builtin funcP" ci ()"\enabl| dynamicallvd code. Thisvis stor.[ r_ attribute on _FW3 inVKese values mus1tch appropriate #definaCO_xxxsInclude/cpython/u.h. No@lineV evPdelettile. """ all__names = [&"nested_scopes",Pgenerdivision"absolute_Wwith_statedprint_0uni_literalkbarry_as_FLUFL.T_stop`annota ?P] ___" ]"] +  # The symbols are d here undn@he s\H"Bin #Thubpc.h, son editor search@find+mmp. # How,2y'rt ex,;at`y don' be@ to #is. CO_NESTED = 0x0010 )# !8GENERATOR_ALLOWC 9%# @s (o.Pete, rp0x1000)LFUTURE_DIVIuI2000$# ~3ABSOLUTE_IMPORT:4:# perform [0 byault CO_FUTUR E_WITH_STATEMENT = 0x80000 # with statement CO_FUTURE_PRINT_FUNCTION919:# print function9UNICODE_LITERALS;2; # unicode string literalsBBARRY_AS_BDFL?4?#GENERATOR_STOP$PStopIY becomes RuntimeError in generator~`ANNOTAY # annotaXsYbs at rc class _Feature: rdef __init__(self, opLalRelease, mandycompiler_flag):JNA.@, =K (W- =c * o9 = JgetO"""Return first r{which this f" was recognized.iT&$is a 5-tuple, of the same form as sys.version_info.5""" r ;kKgetM 4ill!|/, or, ifCdropped, is Nonec__repr>"@" + *(&,{2 )) nested_scopes =s((2, 1, 0, "beta", 1)i020@alph100 CO_NESTED) K R3final", 6CO_QALLOW@divi 2(2 * DIVISION) absolute_import5[ 20& ABSOLUTE_IMPORT) _*6 1) G_G fd# 00, "alpha", _0), t# _aix_#is used in distutils by setup.py to build C extens# before s dependencies like _posix#are availabX_boot*s[b deftag(vrtl, bd)# type: (List[int], int) -> stBInfeABI bitwidth from maxsize (assuming 64#default)G_sz = 32 if sys.=== (2**31-1) else 641 # @[verB , release, technology_level]/return "aix-{:1x}{:1d}{:02d}-{:04}".format B[0],e1 2]", _sz) #\ract G and `a VRMFD6ing\(vrmf1struv, r, tl = 5.split(".")[:3q(v[-1])#(rHtl)]bosmp64(~Tuple[strDadnR\+a % e.g., ['7.1.4.34', 1806>1Theset bos.|1 iskernel. It's3T<Adateqreflect4current oAs ofruntime environment.?0# WpK2allS`ystemshave lslpp installt1locQQWout =d .check_output(["/usr/bin/N", "-Lqc""]J`out.de~("utf-8"tstrip()0:")ignore # U'se str() and int() to help mypy see types return (3out[2]),6 -1])) def aix_platform():=#Ip: () ->v1"""-AIX filesets are identified by four decimal values: V.R.M.F.AV (versionR (release) can bereived using ``uname``ASince 2007, start#Pwith 5.3 TL7, the M has been@included 4' bos.mp64erepresentsKTechnologyELevel (TL) ofy. The F (Fix)walso incrs, but is notDvant for comparAasesbbinarytibilityHOFor pso-calluilddatezReeded@RAgain'b$Pof an 6associat3'HjIX ABI7#described as guaranteed at: https://www.ibm.com/\support/knowledgecenter/en/ssw_72/install/_>#ta Qhtml M%pep425 purpoW* tag becomes "aix-{:1x}{:1d}{:02d}-{:040}"./at(v, r, tlf, bitsize)ae.g., P6107-1415-32"06.1@ bd r, 32-bi =and</64<%64<Pvrmf,^!= ;0bos(r(Atag( Pvrtl(8)9*# extract Q fromfBUILD_GNU_TYPE ang[L?bgtWList[int]'@gnu_ = sysconfig.get_ j_var("n" ifO A`aise VMErro@not definedO=^ 6446Ri{w_w!ofIsystem Python wruilt ond#_ @DATE|-1ure # lslpp -Lcq | awk -F: '{ print $NF }'_5 6AIXA2tryy Hexcept (a, TypeYIr)f"}  or invalid: F 6f"{3!r} ) Basic subprocess implementationPOSIX which only upos func&s. Only < features required: by setup.py to build C extension modules when subprocess is unavailable.F*is not used on Windows. """ import os # distutils.spawn3'bycommand._ext # calls .Popen().wait() class : def __init__(self, cmd, env=None)'+p._cmd =$?Penv =7 returncode = Q wUd pi^os.fork(),d1if 6= 0@# Chz1:try-0if t ._*.os.execveC[0],C*N:OelseX W Lofinallos._exit(11u# Parent %_, status = os(pid(pid, 0V 1A1_to()=89 (0 `_check\C(cmd.# Use regex [a-zA-Z0-9./-]+: reject empty string, space, etc. safe_char![]for first, last in (("a", "z"), ("A Z 0 39")A ch8range(ord(Q0), VW) + 148.append(chr(ch)e\"./-" = ''.join(2gif isinstanceI, (tuple, listp!st1cmd/elB7str 8B[cmdU trb False40arg5B!if ar {D Z>6argR#%O RRif ch&n  w YskATrue_aix_sup.;Poutpu9 **kwargs2if raise NotImplementedError(repr(/)TMRValueDCf"un3ed : {cmd!r}"Wtmp_filenam"Q.tmp"5 2" "@= f"zH} >{s"}" "# system() spawns a shell status = os.system(cmd) exitcode"Bwait2D_to_(54if :Jq'raise ValueError(f"Command {cmd!r} returned non-zero "CG  f"l { e!r}") ;:trywith open(tmp_filename, "rb") as fp1ustdout = fp.read(except FileNotFound EA1b''gfinall os.unlink y/OSoBpassW  # Copyright 2007 Google, Inc. All Rjs Reserved. # Licensed to PSF under a Contributor Agreement. """Abstract Base Classes (ABCs) for collections, according b EP 3119. Unit tests are in &_c<.m from abc import ABCMeta, absmethod sys GenericAlia type(list[int]) EllipsisTyp...) def _f(): e1Fun( _f'l _f __all__ = ["AGable", "Coroutine",g "AsyncIter)0tor:a ?DHash:F /' "< "Reversi JPSizedpAaine}DCall`C 0Set90Mut+ [wMapping$(@View,DKeys EItem Y AqSequencq *qByteStr ] # This module has been r9!d }8to _ # speed up interpreterrtup. Some of the s`s such( # required early butYps a lot^SothersSee issue #19218 __""Private 1Rthat we want-Pregistpvariouss !o 4they willTs like: #i~iter(somebytearray)!crt isinstance(it, 0ble(`Note: GAimpl"atDthesxm not be distinct # may have`ir own~QScificA!reWincluded on t`L . s_! ==(a(b''))!%())) #callable _iterator = ??? dict_keyPtype(({}.keys())))PvalueB +-Oitem,+HlistSQ[])) oreversy d(/) rangeP (0Along* 1 << 1002/se1set ?strM"")) tupl>?zip>1zip!## views ##1 = /(~p## miscemappingproxy+m1.__4e_) genL((lambda: (yield))TcoroutineYasync def _(): pass $ = 5!)(.close() # Pnt ResourceWarning delMA ## vhronous 1##  ag@ _ag#_62ag)fag ### ONE-TRICK PONIES ### heck_methods(C, * ): mro = C.__mro__Bfor &3 in s/3B&ro#if.B %)[l] is None/3return NotImplementedUbreak;elsNF True class Hashable(meta=ABCMeta): e__slots__ = ()@abstract(_hash__(self~y0>h ;1subhook__(cls, CE`if clsB Fe,_c#"_!") k_Await9aQ@(2!__@_get (GicAlias) JC(Y!AsendU!, r"""Send a into the .aRaQnext |#ed6or raise StopI6ion:5"""F)Iteration ) @abstractmethod def throw(self, typ, val=None, tb !):-1"""Raise an exception in the coroutine.0Return next yielded`que or rJStopIteraK:5"""F if5@ is _if tbd5typMPval =%()I?noth3val.with_Jeback(tbDnAval W_Qclose_G0GenorExit insidH:try. P) (), {#Apass JelsetRuntimeError(" ignored p"")k@classQ__subhook__(cls, C`if clsCh lr_check_`s(C, '__await__', 'send1 '-rHNotImplemented w.register(A) a Asyncble(meta=ABCMeta):__slots__ = (__aiter__Gs5torMwfV,bl"j""PX!___getitemicAliasc _a0__ae$ @ whe hausted.9z 4 .J./orNP__", !( (AfromDhronous g|uW,6ion2 'l  .am(/:'ue"""Send a ue into Retur$n next yielded value or raise StopAsyncIteration. 5""" . "@abstractmethodaV def athrow(self, typ,=None, tb !):4yA"""Ran excep in the Uhronous gen&or_Retur3 if@ is _if tb-5typPval =%()I?noth3val.with_ceback(tbDn2val#xQclosex`G?Exit inside coroutineT:try `await . W) (,6Epass/JelseRuntimeError(" % ignored "")6g@classQ__subhook__(cls, C`if cls E[ r_check_es(C, '__aiter__'  `'asend8y 'vrzNotImplemented .register(;_YA)  ble(meta=ABCMeta):B__slots__ = (VY while Fa!m.2"__"\!__#_getitem{icAliasdDtor([#D ['F" Q fromYator. Wheyhausted,('E 5-3?tor'4 __/__6&or0Qbytes=/) "Warray&#'callable&%dict_keyp$valueiterator) Iterator.register(dict_itemi%1lis%<!reverseI PrangeoJ?ong&/se ?strf Otupl 7zipB class RQible(K ble): __slots__ = ()@abstractmethod(cdef __,d__(self):Hwhile Falseyield None] Z1subhook__(cls, C`if cls i ireturn _check_ahs(C, ""E__")=NotImplemented @2Gen??tor? +Nnext'B"""R@the $ ` from gk. When exhausted, raise StopFtion-5"""9`.send( (2`, valu("""Send a_ into#ed6/orEQthrowQ, typ=A, tb Saa_0cepJ? inK if  _if tb5typPval =(I1not| h3val.with_eback(tbDn2valsQclose_G&Exit inside :try{. P ex) (,#Epass4eRuntimeError(" ignored p"Gmb'/__V !'___', '__a |'6^ 'Zu )%Sized(meta=ABCMeta* i_len__(self)3: return 0 @classmethoddef __subhook__(cls, C)Eif cls is Sizedebr_check_\s(C, "__len__")k,NotImplemented ~ Container(meta=ABCMeta):__slots__ = ()@abstract|mcQs__(self, xSFalseIs F"'B!___getitem (GenericAlias)Zllection(, Iterable,vd da?Jqiter__" 4[P_Call  -""" Represent `7[argtypes, result 2]`.9This sets ``__args__`` to a tuple ing the flattened ``Z!``Yfollowed by ``m`m0Exa<6: `[int, str], float]``c4``(0/)^_2"""iU4new$origin, Zif not (isinstance(", ) and leng) == 2=raise TypeError(" must be used as [d, ...]'].ctB, t_c! =j7if .Klist*$R#el_is_param_expr(2 P f"Expect @ of ~s, an ellipsis, "&0f"PySpec, orcatenate. Got {}$"super().__3@property-Deteras = []20for@ in !._"__"# Looks like a gaJ(if hasattrl<u"Rarg._$ ]Js.extend` :.NelseD0if 0varI$;q3appqbreturn tuple(dict.fromkeys(params)) def __repr__(self):aif len .__args__) == 2 and _is_MZ_expr'7[0]IMreturn super().t)o" (f'collections.abc.Callable',Rf'[[{", ".join([_type(a) for a in [:-1]])}], Q{D 8 -16':Nduce<.* =yif not (^)UL M = list( 1), 5-1]jT_BGenericAlias, (: sgetitem ,  # < ed during TypeVar substitu", s the custom!Uclass# rather than*default (s. object. Most of0Jcode is copied Fying's _JwbuiltinEw.,q# A special case^PEP 612 where if X =[P, int],bhen X[int, str]T&X[%].-a0len@eter-1if _06= 0QraiseError(f'{}22a g 'isinstance(w, tuplef2 = " C{1Eai 99$'),:y!if&!=gb Too {"many"UD>C else "few"} f'auments;6tctual {}, expected {m} = dict(zip-B1new'F = [ rg*o ;!ifQ}pvarlike  )z?arg(,0argF[arg BU8 K$"EPaypes, an ellipsis, "RG 0f"PSpec, or Concatenate. Got {arg}"~MO:  arg = subst[arg]  # Looks like a GenericAlias(#elif hasattr(arg, '__parameters__') and isinstance&.$, tuple):[1subM{s = arg8 / if2MQ0argOs(x] for x inA)_A6parg[subK 8@new_p.append%) I# s[0] occurs due to thingmZ[[int, str, bool]] from PEP 612Mhif notZ}[0], listRt_result = +*-1t":#<B = (/$, [5return _CallableC((S)) def _is_typevarH`obj = 8# lTypeVar/PASpec% (obj.__module__ == 'typing''+0nam)Uin {'SC', 'h6'})}P_expri"""Checks if matches either a1 ofs, ``...`` rQ`` or``_ConcatenatY"``,1.py01"""}is EllipsisSDTrue,=objR 22obj ;m(9'6Z~S0anyc0.__f  0in s5<_reRAthe ) an ecpecial-casing (internal helper).bCopiedb:mod:`` since collections.abshouldn't de6 on that . [r(if27& #builtins'3d@qualq!__ 2f'{#C__}.4}  E'...- 1Fun_r% class Q(meta=ABCMeta):p__slotsz# (@abstractmethod_call__(self, *$, **kwdsRFalsee@{ N1subhook__(cls, CI`if clsFe:  return _check_methods(C, "__call__") -NotImplemented __class_getitem__ = S(_CallableGenericAlias) ### SETS ### 4 Set(Collection):c """A set is a finite, iterX container.BThis provides$rcrete g$ iais of allom  except for __eps__, __|__ and __len__|o override the comparisons (presumablyUspeed, as*zsemantics are fixed), redefinekvQge__,6@thenC other operwill automatiyllow suit.>2"""7q__slots"()3defvb(self,cPif noinstance(,'+Daif lenf1) > JEQFalse<elem in 61if n "& YITrue1t__H{<y.~"__u gaeHO XD o X 4 Y !X/eqOX/==Y@|Afrom@(cls'''Construct an )r"> FF anySinputVIHMust\2is 1 iflor signatur*Adoes!acGxs1''' <icls(itn?andIz-f lm ._6|QvalueZ i!value in self)  __rand__ = __   def isdisjoint(self, other):!=$'Return True if two sets have a null intersection.'<pfor val9nYX\&if~ "r}UFalseWFTrueo__or__if not isinstance(, IterablewNotImplementedchain = (e Ys in ye%s)6._from_i}(Q)0__r ___sub;Set"R? =  /W !inQFjNqV@rA~B! Ax V" -B) | ! -t1__r AhashFc"""Compute the #@of a=.B!No'at we don't define __:1__:0all:Bs arS.0But4you?ay&8 type, itsXg shoulcthis funTmust be compatiblGeq__Aought to.re equalthey contF"6sameos, regardless of howOyiF, an 4]PorderA ]@; soNAre's_EmuchMqfreedom __5 or8. We matchC algorithm us%!bybuilt-in frozenset5"""y0MAXAys.maxsizMASK = 2 * %5+ 152len h = 1927868237 * (n + 1) h &= MASKfor x in self:0hx = hash(xB ^= (hx ^<< 16) ^ 89869747) * 3644798167U hN` >> 11G (h &25uh * 69069 + 907133923[if h > MAX" -@.\== -1.= 59092371n+return h Set.register(frozenset) class MutableSet(Set)^b"""A m set is a finite, iter4 container. RThis Wprovides$crete generic implementations of all@methods except #__eps__, __| alen__,8add(), and discard()o override the comparisz(presumablylspeed, as*Ysemantics are fixedhll you have to do redefine __le__D@thenQ other operwill automaticalllow suit.>2"""\__slots__ = ()@abstract91@def /s, valuerdd an e.araise NotIedErroro tshRemovev Do not sion if absentrg(!Ifa member,A Key "ifQ4=(`..1pop RbpoppedA. Rk6Zempty1t =Zl2try  = next(itPStopI ; from Nonemte Rclearl1"""`@is s$(creates N newators!) but effective while Truej v 4Fpassq__ior__4*itFv"{+ e?andfD - iP sxAif i-V self.clear()# Uelse: if not isinstance(it, Set)(,t = self._from_iterabl3)Ufor value in itJf Q"p.discard(P g$>-ad:areturn def __isub__(68, i@if i"3 .v.clear(H @ Muts0Set.register(set) ### MAPPINGS ### class Mapping(Collection)D"""A is a generic container associating key/;bpairs.GRThis rprovidesHUcreteYimplementas of allLmethods excepty__getitem__,0ter and __len__.;2"""__slots__ = ()# Tell ABCMeta.__new__ that tshould have TPFLAGS_NB seti__abc_tpflagf1 << 6 # Py_7@abstractru7keyuraise KeyErrorL86get0, default=None>0'D.)k[,d]) -> D[k] if k0D, d d. dCPs to G!.'D2try+ U[key]*6#__isz  )yVFalse FTrueAkeysjW1"D.Sa-like object 'a view on D's5%s"nKeysViewdxyz5 {OItem|}~n . wVxE__eqWotheru",+DNotIm,ed}2dicG."q()) == ]__reversed[&# XmiPproxy 'tSized):U#'_="',e__init".:3 = "B def __len__(self): return len._mapping) #def __repr__!; '{0.__class__.__name__}(M!r})'.formatF^7getitem__ = Imethod(GenericAlias)  KeysView(M t, Set):WQslotsO(@<Xfrom_iterable0, iH cset(itKcontains^, keypkey in u[F|B=`yield : .register(dict_key"OItem#key, value = {6try:v = U[key]0`exceptZError<VFalse2?lse'Cv isror v ==0for  g(  "V9Collection   ?if Z -6TruB6 ^ "0Mut=CZ"""A "_2a g 0er associatingAkey/pr pairs.BThis' providesHUcreteYimplementa s of allV#s 5y%__T, __s 0delz1__,>_0__, and __len__.2"""/__abstract1nFEaiseg@SSL __marker = object96popI, default=4[P'''D./k[,d]) -> v, remove specified'?the correspondingsVA If5is not found, dMDed if given, otherw1ror is raiseCd. 5''' Etry: value = self[key]except KeyError7if default is=.__marke)dUraiseXTeturnCJelseh1del^ C Bdef popitem()KT'''D. ) -> (k, v), remove and rsome (key, ]a) pairbx as a 2-tuple; but +P if D_emptykey = next(iter)wStopIteration from Nonyf gCclea2'D.a{C. R`0ll !s /D.while Tru  Fpassaupdate_, other=(), /, **kwds63 D.1[E, ]**FUL" Dmapping/aable EWFIf E present hO.keys() method, does:0 for k in E: D[k] = E[k% Uolacks U  ZvSW@n ei# case, thisfollowed by:0, vI!F.%()Qif isinstance(2, M@ ey^(p " = elif hasattrk"n"j >q QCo( F 3set=7'D.0Qk[,d]D.get(k,d), also set =dPk notD]/- ==R` MutW`.regisZdict) ### SEQUENCES ### class SequeReversible, Collecw""""All the ops on a read-only sK.Concrete subles must override __new__ or __init__,P__get^1__,8r__len__^""" __slots_F_ = () # Tell ABCMeta.__new__ that this class should have TPFLAGS_SEQUENCE set. M__abc_tpflags_g1 << 5 # Py_8@abstractmethoddef __getitem__(self, index):"npraise IRErrorP<Citer92Ui = 0@6tryMQwhile True@v = 5[i]A}yield vei += 1gexcept fhreturncontainsw, valuefor v in N ifs3 ("== ){XFalsereversed i#(range(len'))-w8Vz2, start=0 hop=NonR'''S.5!1, [0op]]) -> integer -- RfirstV2 of@ Ra0s Vvbr if the+ is not present.%;Supporting and stop arguments@optional, but@recommended5'''$#ifYezart < 0f = max" +EJ, 0)Z opY/opX opnw[a1is Zaor i <  Mi #Ybreak5 7Xcount2'S.`numberoccurrences5isum(1 'v2 p) SequU.register(tuple)?strmemoryview) XByteString(z@"""Tunifies bytes SarraysRXXX Spadd all2ir RsA2"""b__slotc?s) ~tMutableA` operas on a read-write sy`Concre!ub+`es musodovide or __init__,9R, __sF__, __delitem__, __len and insert(). """ __slots__ = ()@abstractmethod(def __setitem__(self, index, value):)^praise I_ErrorW >delWP& 3'S.' 3 --)r before' #cappend 3'S. nnto the end of sequence|1lenk)iRclear2'S.) -> Noneremove all s from Ss6tryDwhile TrueUpop()/gexcept 6Fpassreverse)' *IN PLACE*En = for i in range(n//2cP[i], [n-i-1] =&i];extsW3'S.!iterable B by ing element<"if3As is S`sBist( v  ;Q8=-1@''S."[O]`M`nd returng2 atW (default lastK RI if list`empty h0out8G&''7v1delFv-u@'"\ first occurr%VQ;*not present9.)e__iadd^<=s?#` MutS.register()bytearray) # Multiply inheritingl e ByteString # This module used to map-old Python 2 names>3new4Din #* 3 %cpickle`". nDneedf3ke $ streams # generated withU`2 load43. is a copylib2to3.fixes _imports.MAPPING. We can3 # 7 use the mapping d0efined there, because lib2to3 uses pickle. # Thus, this could c.@the module to be imported recursively. IMPORT_MAPPING = { '__builtin__' : '2s', copy_reg': ' PQueueq SocketServerss$ConfigPars$cp$1rep@4libtkFileDialotkinter.filedAotkSimp,s .ColorChooZcc\nCommonc \& PTkdnd,sjHFontfMessageBox$m4box8ScrolledTexNstVTkconstantsU(iu%tin8ttk:4markupbasT_;@_win3: ' QthreaA_ TdummyI: '_%Pbhashtdbm.bsdtdumbdbmn#Kg 0: 'I4gnu.`xmlrpc2: ' t.client"fXMLRPC;+ <ChttpK Ihtmlentitydefs'.%ieCHTML$ QCookig@c 4jarBaseHTTPI Ptest.@_supn.[X1andsubproces1urlrurllib.?Qrobotr$*>2 u.reques6anyq_abcoll\ ections.abc', } ntains rename rules that are easyhandle. We ignore& more # cox stuff (e.g. mapping'ZAs in  and types."s)U$es!shWbPn befvN Rfixed. NAMEN(('O, 'xrange'):l6 ('^# 'w :Wreduc:functools', '<nv!sy66funichr68$od Zstr')8tin__', 'lonRg'): ('builtins', 'int'), ('itertool6zip6* 88/ma88efilters p; Pfalse@ <Azip_longestA AUserDictFIterable): ('collectiokC1LisC ;;`String=?Apwhichdb> ;9dbm0a_sockebfromfd(1multiprocessBConn> #&.c 8, '.V 2`PkZ1tex(TCfork_PopenRp_,}JQurlli]ContentTooShortErro"('$!.e*.kgetproxiesP.requ8, '"@pathname2urlB $Dquote_pluPparse > { 9H(unT_; "v x84rl2 =ru$Dacleanu B"@Sencod $rl<5 y:zretrievx ># B2 OHTTP=?URL< , } PYTHON2_EXCEPTIONS = ("ArithmeticP"l`"Asser ttributeBaseExcep0AjBuffer(ytesWarning'pDepreca: 9EOF>Environmen*B zFloatingPoi+FutureWarning", " GeneratorExit", "IOError_mportuWarning(ndentation-Index', bmultipii .context # Same, but o03.xO2.x REVERSE_IMPORTa = dict((v, k)4`(k, v) +.items()) assert len(VA) == B) ) ) Non-mutualmpings. .update({,cPickle': 'p *"_et1trePxml.e ".ET-FileDialogI0tkib.filed( Si*s ,DocXMLRPCServerYxmlrpc.s TFHTTP)Khttp'?CGI$ # For compatibility with broken !ps savedB5old@ vervsX@Dict`collecs^?Lis QStrinP@whichdb': 'dbm', 'StringIO': 'io', 'c}) REVERSE_IMPORT_MAPPING.update({;_bz2': 'N@_dbmfunctools g,1: '`pickle1 , ONAME('__builtin__', 'basesc'): ('sRstr')k('exceptionStandardError:E-@UserDictY secollec[{Qsocke9_ bobjectwVS'@Typev k 'reduceZ *tkinter.filedialogRFileD7, 'YHHLoad.<, '" GSave@ " PHsimpS 9, 'xmlrpc.server3S rHTMLDoc{DocXMLRPC& N8DocGenerat/('[3`@RequestHandlee 8j/):b0Z 2CGI;pHhttp)OHTTPl -&A :k?CGI.9#ebsk< 3, '!PYTHON3_OSERROR_EXCEPTIONS = ('BrokenPipeF'ChildProcess2onn(cAborte}75_Refus5YReset:.ZExistzNotFounI objectBdoes" |S3Dec}`ReaderYave!arguments.PA# If5Ucontains multiple 2ed ws, eachA will need a separate#ory. A newNqis alsoQed when implea backwards&()"# =rt.comp_args = decomp_args bself._ressor = _factory(**F%) H# Exception class to catch from bsignifying invalidHPtrail@dataFeignore"&A_err def close(5+):D V= Nonfreturn super().FW}seekablZ8W5fp.(<readinto7, bwith memoryview(b) as ,.cast("B"Pbyte_9lU(len(,%))- [:'<P)] = )!_`^, size=-1!ifJ < 0P8.BCall(!bif not<#or?eofE5b""  # Default if EOF is encounteres`Dependton the input, our call 60may## 1any@0. IS is case, try again after yanother block.Pwhile TrueZc.#M1rawU1 = q .unused_:%ory: 1_fp(BUFFER_SIZES8} !]breaks# Continuesnext stream= f??try3g B.( {fe6 v9# T!isn't a G #ed4"; ?> it?;elsn(raneeds_/?BPraiseE c("Compf>ended before0?"end-of- marker was_ched">e O.!ifr  break  if not data: self._eof = Truersize = *9pos#return b"") += len(v)2 def readall(<)chunks = []+# sys.maxmeans the maxngth of output buffer is unlimited,Jao that@whole in7can be decompressed within on+6# .#() call.fQwhilez# :F(s.append>O?b"".join(-)K# Rewindfxte beginning.r stream!_r> ._fp.seek(0=FFals po0,%orX_factory(**,S_args! , offset, whence=io.SEEK_SETUcalculate3 as an absolute .position#if[G == ^&6pas/el5:CUR5-+2L:ENDL`# Seek relative to EOF - we needEknow0's C#ifJ < 0h#.io.DEFAULT_BUFFER_SIZE5 * w*se raise ValueError("Invalid vC for: {}".format(')L# Make it s+#at4)`number7PbytesF@skipaFward>$if:}Omin()WqUbreak-1!>  .te4B"""R{current" ^`"""Sha7psupportB scaAPdocumS1typ@lara5s in HTMLX . This modu]0s uD{a found9`html.parser3. It has no zublic APImashouldbe used directly0. """ import re _declname_match = re.compile(r'[a-zA-Z][-_.a 0-9]*\s*').2BstringlitG(\'[^\']*\'|"[^"]*")Dcommentclose--\s*>') _markedsection,@]\s*/D # An analysis of the MS-Word extensions is available at # http://www.planetpublish/xmlarena/xap/Thursday/UtoXML.pdf _ms1del class ParserBase: """b base %which provides some Gaon supmethods usedI!bySGML/HTML and X pt!s.!udef __init__(self)0if 1.__ __D)raise RuntimeError(" up.I must be subjQed") >\resetlineno = 1-goffset = 0FlgetposG"""Return current Tq number8L1`r2k/2no,),t# Internal -- update] This should be# called for ea@iece data exactly once, in orderm CtherGQwordsconcatenaZI1allbinput s to this?1fun{jqentire B.3qj, i, jZfi >= jmYjG!aw=`rn~sJ.count("\n"s+2if . r eTCno +0B(ponhrindexoB # Snot fail?n% = j-(pos+1)$$el m 2U+ j-i:j| _o@char"''# "ar(nfuse by&s)3a3S7, i#s(ofh;"ai# deployed,"t@only!q@docuFB typ*;#cl ("".ISO 8879:1986, however, has moreEplexbabsyntax les ":"# the empty comment $return j + 1_`in ("-,")eStart ofd followed by buffer boundaryror just a).)-<# A simple, practical version could look like: ((name|stringlit) S*) + '>' an = len() 2ns'--': #X,I# Locate --.*-- as@body'7O&&(i(el[marked sec+[statusWord [...arbitrary SGML...]][ gWhere Y`is oneTEMP, CDATA, IGNORE, INCLUDE, R Note that this is extendMMicrosoft Office "SaveWeb" funto include [if and [endif]i_X Pse: #gother @ eleps!`type, e`_scan_G(j, if j < 0n$jW!ifwVN0doc k_chars = 'Qwhilesns6c =m]yAif cv zP# endwy syntaxE,Jzj[i+2:jk&*RhandlE(eI#Jelse# AccordingHTML5 specsjs "8.2.4.44 BoguH#*!e"95 Markup*Mopen(KC5, aUtoken shbZitted=`# Callqunknownd provides more flexibility thoughMfHg hD{in "\"'Am = d_match, j) if not m:  return -1 # incomplete+j = m.end()2elif c in "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ":N`name, pself._scan__(j, i~,decl_othercharsWYj + 1w_== "[# this could be handled a separate doctype parser`0if #i/o.O_._subset( 9iin {"attlist", "link element"}.Q# must tole[]'d groupscontent model#n T=ion]@also5data attribute specifications ofS 1 ?! s 1 WsSraise AsserError("unsupported '[' (%sR1" % ROelset\expecsB"ea]%%r\` % raw:[j]iif j < 0j  # Internal -- a marked sec)Override#to MS-word extension syntax U2deft_r_r(p, i, re6=1) = %.Oa67i:i+3] == ' o%ng#smatch= tionclose.search(U,=/ ifLndif*MS Office sl s 4 'unknown status keyword %r in marked section' % rawdata[i+3:j] )if not match:)return -1if report)2j =@.start(0^HSself.h_decl(6 j]/s@.endK~# Internal -- parse comment, 6length or -1 terminatedG2def=_=(0, iE6=1)0 = &.Ib:i+4] != '=*A/g=> <`scriptQobjec blockquotepre> ' +!c + ''ulookup(name, frclocalsX"""Find the value for a given 81 inenvironment."""%if)\o1',  s[X]<.f_globalsE'* O'__builtins__'Y(" =S FwDype(;`) is t#{}S'.!"3', %) if hasattr, ,g?get;.eNone, 2canvars(reader{"""Scan one logical line of Python and 2 upys@varies usedbq , lasttoken, parent, prefix,Bt", ('' t#, Lstart, end,gize.generate_-PO2 ==Q6NEWLINE: breakT,1AMEb@ notkeyword.kwlist8&if w:'.'!l%U,0$= =%>)6.append((F )ASVwhere(1up(! q 3P elG=o+ '.' parent = value Uelse:p), prefix = None, ''&lasttoken = return vars def html(einfo, context=5)mB"""R0a nice HTML documdescribing a given traceback."""qetype, e, etb = pif isinstance(-36.__name__? pyver = 'Python ' + sys.version.split()[0] + ': executabld@date'ime.ctime(.1())j@headi z`pydoc.R./Aing(<a'A%sA problem occurred in a C!pt. Here is the sequence of function calls leadQup to-`error,U;Porderyp.

''' 0indNa= '$aa>' % 9\.N$! =g?Pargs, kw, local>1arg!s(&U unc != '?'.ixW""^'b4+= fformat RJBr=lambdaK: '=Qrepr(*"))Ehighligh!{}vpreader(m =[]%<[0]] = 1D#Stry: Pcache 6[6[0]9finally:[p = scan (,&%0row4['=>%s%s' % (num, pydoc.html.preformat(line)) rows.append('had> M) + strong()A%elx== 'local'j O ?# = .split('.')[-1]"%sw@= %s 5Qrepr()2_@+ ' Nundefined') s}taasmall(`.join(m)Vframe'' >0>''B'\n'x)exception = ['

%s:Nescape(str(etype))), @Rdir(e~P[:1] /_'5( =7Pgetat!,Z`\n
b#\ncbindentC0Lreturn head + 'n}o' mA)>._:", 'P, etbI def text(einfo,Sext=52B"""Rqa plain. documenttbing a givenA.""" |1 = qif isinstance. etype = et2ype.__name__ pyver = 'Python ' + sys.version.split()[0] + ': executableGdate = time.c(.1())#head = "%s\n" % (str(etype), , O)q '' A problem occurred in a .script. Here is the sequence of function calls leading up to-`error,U;Porderypa. ''' frames = []`recordinspect.getinner*(etb, contextAfor , file, lnum, p, lines0dex`:m3! =: and os.path.abs( ) or '?'5args, var kw, localargvalues(x='U!if0 !=l.iQ <""C'u4+= \fformat ,qNB=lambda @: '=`pydoc.a.repr("))Ahighlight = {}ddef reader( =[*])<[0]] = 1D_try: return PcacheT06[0]9finally:N[0var@scan (, 0row0[' %s %s'Z,E)wQif ins not None1i =" -* s<b0numx@%5d i@!.append(num+Ht.rstrip{'0i +Gdone, dump,0,p, whereC0lueF 0if +S:2inu N[("ifK__UNDEF__hF"if == 'global':j:%el@?! +Nv'.')[-1F6{ '%2,xM ;els2 ZM  undefined'\n'.join(xOs'O'2GQexcep4t= ['%s:  /Bir(e< = fPgetat!,| pR" "*48return head + ''.join(frames) + 'exception ' The above is a descri# of an error in a Python program. Her8 the original traceback: %s ''' %.format_(etype, evalu tb)) class Hook: """A hook to replace sys.Ihat showssHTML.""" K+def __init__(self, display=1, logdir=None, context=5, fileE="html")].\$ =fh# sendto browser if truenM# =G# LsJ@not N$ =J# numbersource code lines per f Po! =+1 orstdout # #to;[utputCE Ecall6 xhandle(` &]a, info! =@exc_%()0if CB == q#ile.write(reset(Jater = R=]P and hplain = Fals6:try5doc^@ter(,\:`# justb case something goes wrongA|*)=TWyf ifv*inM`pydoc.N.escape(docv- '

' + GP+ ':6P'
Ablem occurred.Y
0I4is 
suffix = ['.txt', ')2'][]`0(fd, path) = temp@.mks(Z={!r=R)G
with os.fdopennq'w') as{
1wmsg = '%sPains Bthis.	2	~^PTriedFsave%s, but failed^	K'g'html':
      self.file.write('
%s
\n' % msg)
/y  else:Gmsg + '\n'>:try95fflush(+except: pass

handler = Hook()..
def enable(display=1, logdir=None, context=5, format="html")"""Install an vBion acr that9s tracebacks as HTML.
	The optional argument '' can be set to 0suppress sending theLe&the browser, and 'Sa directory7KcausNs0be 0tensxare."""~Bsys.Dhookq=c,:)
"""Simple clasread IFF chunks.

An (used in C`s suchqAIFF, TRMFF (RealMedia File
FQ)) hap follow}structure:

+-+
| ID (4 bytes)   |&Gsize(&Gdata*w|
| ..._
fID is a 4-@ strwhich identifiertype ofG!.
?field (a 32-bit value, encoded usS@big-yte order)
giv_K of@@ whot, inclu" 8header.

UsuallynAIFF-Psists onqR more@s.  proposed
usag"CyAdefined here+@to i`ntiatew`ce at
>PstartvBeachokAfrom6until it r0!esDend, after Sa newz$ceEad.  At[Cend
I
p, creatFwill fail withEOFError
1ioncage:
while Tru	~\1 = ;(w|H X%Qbreak;=..getnamex>/Y (nsu"pif not )u	# do someth 3interfacS-like;f0ed @Pods a, close, seek, tell, isatty.
Extra4 skip() (called by@1kipZ0endX55),
+ (return?Z (ID)0__init__"requiredrE, a  object
(g a chunk inLstance), and one optional argument, a flag which
specifies whether or not chunks are aligneP 2-byte boundaries.  The
default is 1, i.e. 6.
"""

class CU:
    def __init__(self, file,8=True, bigendianinclheader=False)LPimport structbY.closed = 4
" =v25  ##toto word ()O&ifS1strrU= '>'0Oelse(<(! ="AcRCname.read(4)&aif lenb.-Z) < 4}raise EOFError?:try(v0sizvr.unpack_from(B+'L'E)[0][Texcep .ew
k
 [U NoneB6if 
<2elf- 8 # subtract UY>(_OE = 0offset = :f.tell((AttributehA, OS	3pseekable
;0?
h0get#i"""Return the " (ID) ofrcurrent
.r6T	o<o"j 7jh!if

.Gskipkfinall1Z
poisatty5
BValu("I/O operaC on l\"W :`, pos,Znce=0Seek to d-ipBinto`.YD3pos)s 0 (start)0IK@not , this will res>Qn an 
Cy"ifb
D41[T("can#ifhZ == 1APpos =_" +])elA2AjF
        if pos < 0 or pos > self.chunksize:
 raise RuntimeError7file.seek(offset +ZJ, 0)-_p_read =!
def tellA)~#ifVlosedBValu("I/O operation on c7 "breturnY , 7=-1@"""Rqat most" bytes from the F."If&is omittedvnegative, p \l>5end;!ofQ2"""^"BU">=0S5b''D0izef
,> O" -`r
H
2f*Ddata/.(8.`+ len(J4Z&=Uand \"  
malign 8 & Tdummy1&L9:Askip
'ASkip_rest If you are not inte.Qed in<contents@,,this method should be called so thatH@ poiK'to@ee starLnextoXkeekabl~:tryn
0# maybe fix ^Mment&"s
^]n + 1Vo(;n, ?%*	=+ nY	except OS<Epass1\whilei<\
Dmin(8192,*
=	cn!!if
(
v?1EOF
"""A generic class to build line-orienqcommand interpretehrs.

Interpreters constructed with this class obey the following conventions:

1. End of file on input is processed as Dcommand 'EOF'.
2. A 0arsed outOeach line by collectI`prefix<posed
  2acharac!inPidents member.
3u`foo' is dispatched to a method 'do_foo()';P3do_ssa single argumentT!is!of<remainder.
4. Typan emptybrepeat80lasR=.  (Actually, it call'`Ia
', which may be overriddea a sub.)
5. Therea predefined `help'.  Given anp`topic'C_&@.  Wf%noAs: lists all )sKa_ func~a, brokPto upSthree@Q; doc#ks, miscellaneous W3 , &un9As.
6!1 '?;a synonym for, . K*!*-Pshell7qf a do_i0 exp.
7. IfL0pleenabled,n!`s willdone automati y,z1comN ngs_:w0all/e
%Jqs text,, begidx, endidx. V0strMw'0e mp1ingIqgainst,Preturx"qes mustVnzQ it. lUJpcurrentJ}0 (lqTpped)A are nn!enN0xesa0 be%dWPcouldmu to@videPdiffe`on depsng uponAposimDis in.

The `default@to i5cep.st`
is nolg`hI!onk
Kthat haveo]>uCdata `self.ruler' se `draw separator#s
messages. 7	,[07Gn##t s?0"="PvalueBintr.1nonXB wheiscmdloopTapSed,
i{ startup32is u
@
vias op( al6#()	cembers `self.doc_header', `self.misBand
'un- set the =s used forlp function's
listings of document/"0s, uellaneous topics, and w2
TLs respectively.
"""

import string, sys

__all__ = ["Cmd"]

PROMPT = '(Cmd) '
IDENTCHARS = ?.ascii_letters +V`.digit'_'

class Cmd:
    """A simple framework0wri line-ori@comminterprek!.
KThese are often_1fulLtest harnesse%dministraP tool!ndI%prototypes that will later be wrapped in a more soph caCfaceA instance or subKis aG.  There is no good reason tohRtiatext; rather,K1it'}azRsupergof an } you define yourULrn order|Pheritx's methodspencapsuD! a%prompt = rcdentchars = Ixruler = '='plastcmdintro = None"lU = ""Dnn0s (q help ):<=FMisc10s/0U" o,!no@= "*** NoRon %s|use_rawinpu41def __init__(,Ypletekey='tab', stdin=1out
)A"""IN?`The opaal arg@ 'co'@read@ nam! aF/ion key; it@ault:0TabH. If5 isF1not	rQmodulLavailable/e}Jis done automatically.seuestdoutGify altern0outfile objects; if 82ied"Asys.h1out
cg8#ifH "<[5dinOelse-	1no%p1q/r3cmdqueue]( =:Gcmdloop(self, intro=None):
 4"""Repeatedly issue a prompt, accept input, parse an initial prefixLoff the received8and dispatch to action methodsXPssing<mMImainder oZline as argument.
06"""
self.preloop()$1if quse_raw completekey '+trimport readdSDold_W5r =.F.get:W).s)UQ26_and_bind(7tkey+": F"G!exIZErrorgEpass
if intro is not qD(=0Rc">stdout.write(str2[)+"\nastop =	kQwhile"lcmdqueue"" =_*j.pop(0`,?elsFlpH
{6?EOF)_Y'EOF'S
|7_flush?_34in.#5!if@len(@-S#? = 1	"G.rstrip('\r\n'	$kbprecmd
)/on)@postS= , l
L%\kfinall)qy
=?	
;
(r0def63elf6s"""Hook executed just beforemu& icinterpreted, but after3qPgenerfd.

        """#
 return line
def postcmd(self, stop,"!):#;6"""Hook method executed just after a command dispatch is finished."""Njareloopzonce when the cmd=){is callyGpassr1ost6s2about to.tI@arseP"'W intovPname a string containings,arguments.  Rs a tuple3# (c, args.J''t'$' may be None ifcouldn'tpdI"=}.5p()qaif notSNu,{9Aelif7[0] == '?'Av'help ' +-?1:]C!Cif hasattr'do_shell'Yq!r'Jelse
i, n = 0, len(kDwhile i < np[i] in .identchars: i = i+11cmd B[:i]iM[i:]5*s6oner&"""InterpretC as though it had be@ypedresponse!to@gpromptDThisoverridden, but shknormally need to be;\3see])PJs for useful5ion hooksQThe r` value8a flag indicatpwhether atL%ofAs byiF$ers	|
" =J
OQempty= if
<{defaultw!laZEOF' ];(''91cmd8:tryyfunc = get$o6cmd .except AttributeErrorU        return func(arg)

    def emptyline(self):"""Called when an+ , is entered in response to the prompt.eLIf this method>not overridden, it repeatsBlast nontcommand{a5"""&0if .D6cmdbreturn!aonecmd-qdefault,oQinput%.dprefixrecognized aprintsrror message ands[stdout.write('*** Unknown syntax: %s\n'%complete*ignoredMc?4to =+n-specific8G_*()=available ByM.H lis52 []ySnamesotext,  do = 'do_'+
\a[3:] for a2Bget_a) if a.startswith(T)	Zstate}Rnext possible1ion''B@If a%P has Dbeenp,n#
 against4cfpOtherwi ry,=#_<> ge=Tst of"Uions.GZ == 0PimporJ ad?@origR = re ._buffer()24 = 9{.lstrip%ped = len(-1) -D
Vlbegidx(7R	?end662if Y>)cmd, args, foo =Pparse(
6`if cmd|*''}<iR:	0OelseJ?try7Wgsgetattr'q@_' +@except AttributeEUoe	2	B	@ion_matches =D(,", try:
            return self.completion_matches[state]
 except IndexError:"MQNone
def get_names(e)2$# This method used to pull in base class attributesUj# at a time dir() didn't do it yet.,'1.__W6__)ae_helpw, *argscommands = set%3e2)zTtopic0a[5:] for a5if a.startswith('P_' + F[0])9Ulist("| (do7arg'List available H~  "~" or detailed  u cmd".'&rg# XXX checku syntax3#:try4`func =P), 0A>'lxdoc=getm$do|).__doc__7nif docstdout.write("%s\n"%str(doc/
vJ6pasI
!no% (arg,)(Jelse9R?lf.@cmdsnF = [@undoI= {}-usU0if t[:5] ==c(,e[.i5:]]=1lgs.sort6ere can be duplicates if routines overriddenV@prevZF = 'jW3r)zcontinue?! =X$@cmd=:[3:A if\s,.append(cmdI1delO[cmdw1eli0Nleader))
            self.print_topics(doc_header,   cmds_doc15,80)
 2D7misElist(help.keys()),J(un#, DMdef $, 7,len, maxcol):: ifs	stdout.write("%s\n"%str(Y)"ifSZrulerMQn9e * lenb
c'columnize(/-1+
Q\n")
0GV , , displaywidth=80&B"""D! a-
 of strings as a compact seta"s.sREach  is only:@widenecessary.2C+s are separated by two spaces (one was not legible enough)J5"""V"if,:ist
.5q<freturn4non
= [i for i in range(b4Nisinstance(1@[i],g*)]n
raise TypeError("CaH6ing&%s% ", ".join(map(str, )asize =t:= 1n'c'cE7[0]bv# Try every row count from 1 upwards7Vnrows&1,[ncols = (+8q-1) // V,1col10[1totY = -256colrC^I = 0BFiF-1i ='+M*colQ(pf i >= 
_break@x	Zist[i
:Dmax(x5"s.append3g'q +=k}*+ |)5if ,>B/<=C
?Jelseg8!en
I = 1pV = [0l            texts = []
 	for col in range(ncols):%0i = row + nrows*col$f i >= sizeBFmx = ""9?els1jlist[iM.append(x)Vawhile " and notN[-1]6del	I
!Alen(X)&s[col] =Q
.ljust(colwidths"
self.stdout.write("%s\n"%str("  ".joiz&)
"""Utilities needed to emulate Python's interactivepreter.
B

# Inspired by simila deJeff EplerEFredrik Lundh.


import systraceback
from codeop (CommandCompiler, c
"_c

__all__&"I8", pConsole(","d"]

class U`"""Base *#.t!.
hCThis(deals with parsing7^0 st(the user'sDnamespace); it doesn't POinput bufferWor prompt
E$f0namg` is always passedexplicitly)2"""def __init__(, locals=None0"""`tructoYThe optional '=' argument specif1dic*Qry inCQwhichF will be executed*pefaultsa newly createdDZpkey "__p__" set>B"__cL35keyD`"__doc/26#if)r(SF = {:,p : B}.C	
; = o&()runsource
$, -1="", symbol=" that justu7redTdoesn't dCra stack5 because`*EIf a&$given, istuffed inCuinstead%@of w0was*re before (Python's parser6use|"">`n readBPfrom 3outpwritten|s.e(), below:	=Bype,8@, tbIys.exc_info(5last_type = =QAb &if9\
# Work hard to s
tuff the correct filename inexception
 Itry:msg, (dummy_G, lineno, offset) = value.argsIp  V^ErrorhQ# Notformat we expect; leave it aloneZ;paso?lsebSFrigh
U = Syntax()Ksys.last_T'0if "$qhook is&__*__s = traceback.73ion_only(type,
self.write(''.join(T)'eG# If someone has set, leat take precedencv# over 
a, tb)
-def show(N)+"""Display[ ioat just occurred.S|We remove5first stack item becausis our own codeDThe outputigten by(), below71"""8?", b = ei =f_info(6$$ =;j
_
(ei[0], ei[1].tb_next"9':Q	"md#vfinallyCNGej, dataW a stringU bamplementa OAs to=pstderr;Aubclass may|`replacis with a different iZ|f2


nInteractiveConsole(cpreter"""Closely emulate behavior oiW Python LRThis builds on s2 and adds prompting%Rusing2qamiliarW1ps12Aps2,
 in bu?,K__init__plocals=,B=""):
        """Constructor.

 #The optional locals argument will be passed to the;Interactivepreter base classgfilenameishould specifyf  (&)'q!ofinput stream; ishow up in traceback5"""I
.__init__(self,)6.4 = 
!resetbuffer()hHdef I%):7@"""R5@.5.V = [][ibanner=None, exitmsg
sClosely emulate} Python consolem1iesPto printRbeforsdfirst ion; by default:Bs a MDssimilarB onee edAthe reala,Cffollow1@curr Pin paheses (so as no to$0fusqis withx -- since it's soc/!)dev messag6qed whening. PasPemptyC0ingBsuppress@a?aA. IfPQmsg i
 given or sCa0X'ed6tryusys.ps1Texcept AttributeError3 = ">>> ]2]2]7...]cprt = 'Type "help", "copyright
predits"*"license" for m
pinforma%.'#if=`elf.write("%s on %s\n(%s)\n" %RW(cversion, 
@plat , .5!__-P__.__16__)1%el0" %(B5= 0zwhile 1O
!ifX
*PprompsOelse;7qline = 8Araw_(5*?EOF!L:\n"F        brea;k
 ]else:%more = self.push(line)+	except KeyboardInterruptQFwrite("\n1:\n"Z4resetbuffer(#0if exitmsg is NonTA'now-ing %s...\n' %__class__.__name__}'elfZ!= ''d"%sU!)
Adef S+!, YD"""Push a to the i]rpreter.F$2The&should not have a trail0newb; it may AWCnal &Es.  Uis appended"a @ and
E's runsource() methodcalled with<	concatenated contents of%p"s R@.  I'is| diAas that6@commwas execu[or invalid,%G!s k; otherwise(Mis incomplete,Gpleft asnQafterr TkereturnCPvalue2Q1 if Pinputrequired, 0VUdealtFhin some way (th'`e same)V5"""I.-.
	 = "\n".join(47Px>,v@filen5!if<!cP:)oAraw_G, prompt="")X@"""W# aCread#$i"edAdoesqinclude.XAWhen#`user e	EOF key sequence, EOFErrs raised`base imentation usePbuilt-in func); a sub!`replac"is@a di&enb
p># jtP)



{act(banner= , oSlocalE"""Closely emulat-active Python@Ta backwards SatiblDfUqConsoleJ81.  pspecifiit attemptsM`importF9`module"0ena1GNU ifX@vail y@Argus (all opal, all default t'o None):

    banner -- passed to InteractiveConsole.i!()6readfunc8aif notU, replacesDraw_inputEPlocalBzpreter.__init__9exitmsg;1"""c/ =(5if %is:E=I.% =2%Felse/6try
@aimport3Aline3except IZError81-#, #)


if __name__ == "__main__"TargparseDr = .ArgumentP%r'c.add_a p('-q', >on='store_true',"help="don't print version and copyright messages"sargs = s ifs.q or sys.flags.quiet0Q = ''
2 i)
""" codecsPython C Registry, APIers.


Written by Marc-Andre Lemburg (mal@l
.com).

(c) C
CNRI, All R
s Reserved. NO WARRANTY.
#

builtinssys

###& stateless utions

cfrom _f.*
c as whraise Systemb('Fail}load the ]: %s' % why)

__allA ["rger", "lookup
@open En@PdFile3BOMI_BE"s"BOM_LE!32! &32&64!64M!  /S_UTF8G)16
4)!16PD'328U	8w@Info8
	PIncre"al
* De#rStreamRead[	x+!$ "]AgeteDgetdf "geti'	r
$
=J@writ
	>T:
'	;strict_es8 gn#	?xmlcharref'
backslash&  "	clookup_error"]
T
### Constants

#
# Byte Order Mark (BOM = ZERO WIDTH NO-BREAK SPACE = U+FEFF)
# and its possible bNstring values
# for UTF8/UTF1632 output B	little/big endian machin=0

#<p-8
BOM_F = b'\xef\xbb\xbf'$B16, LH4L=116_Aiff\xfe=:B::Fe\xfw/32w\UTF32n@\x00v<v9m1uif sys.byteoB== '':

    3cnativeAness 5 = 8_LEDD&32>o

else0B*># Old broken names (don't use in new code)+# BE"64?0032_{dec base class@efin/the API)

 CodecInfo(tuple):1""" details when lookD0up Gc registry"""aPrivath to allow Python 3.4denylistIknown non-UniV#5 csCoOdard library. A more general mechanism toBreliably distinguish test encodings from otherqwill hopefullyK@be dE!edj5  See http://bugs.p.org/issue19619,_is_text_ = True # Assume@are ) byBaultsdef __new__(cls,+Pe, deO, streamreader=NoneDwritincremental! ZMXE=*, #ciqself = z.(y
%))tP.! =
S# =
# =3
E8r =
5]5
5# =))).if is not =
. =Dareturn self

    def __repr__(self):
 #return "<%s.%s object for encoding %s at %#x>" % \;B S.__class__.__module__, n	pqualnam
I.A, idWA))

X Codec:
5
""" Defines the interfacestatelessers/decoders.@QThe .Re()/."() methods may use different error@Phandlschemes by provi40s argument. TheseA0str?Pvalue&ae preddh  ')ct' - raise a V4E (or a sub,)d 'ignore=
0character and continue with GnextDareplacE+rsitable  ^;DPython willa+official U+FFFD REPLACEMENTDCHARACTERBbuiltin Uni _cs on@~b'?' on-Fing.2'surrogateescapqprivaten points U+DCnnF0xml3ref'RUJappropriP6XML7R!rece (onlyHing)backslash9 - "2ed  sequencesJEJ\\N{...}G
5set of allowed Acan be extendia register_1"""O2defej, input,R$s=w)xEx.9KrNs a tuplGutpuL#  c, length~csumed)M#    yto apply. It(aults toG7gQnot store F1 in} instance. UjStreamWriT=which have to keepX\orderBmakee<oper must"tode zeroc	 an emptyZo0typfY thisEsituationWaNotImple!edD	uple (output'
 object, length consumed).
'input must be an 8 which provides the bf_getreadbufEbuffer slot. Python strings, Xs and memoryCmapped files are examp
#ofsing thisp
errors defina handl:o apply. It(aults to'5ct'76The method may not store state in1Codec instance. UsefSMmReader for c1s|have to keepX or-make decodefficient%&er!blede zero29and`return)Sempty1 of0outOC typ)isEsituation5"""$raise NotIpmentedE

class Incre@alEn6"r(t!):EM/An+! e3 in multiplPeps. 1canTbe passed piece by	!toV#()CLBmberY5CGprocess between call1().Kdef __init__(self, $s=$5PCreatu,h	`use di
2entC schemes b`a keyword arguQ. Seecmodule doc!ng=`a listPpossibvalues('#.r=B= ""cea!, final=FalsedsoH0res~#ngNQresetR!urb|92iali
f_1getb S@curr4w
b& 0oss,1Set%w
Ba2bee edh @B.ed	(?GT"ub/of0canupaBbase3incremental encoder if the must keep some ooutput in a
    buffer between calls toF1().&1"""def __init__(self, errors='strict'):)[IncrementalE.<)2B# un@d inthat is keptA.Q= ""
__dw, final# Overwrite this metho subclasses: It l[x# and return an (	, length consumed) tuple8raise NotImplF0edEkp
i=False, (taking. into accountxdata = V+D(result,1_[rL,K3pK#QuntilAnext3 = c[Q%:]&~@Qreset?+(S
yigetstateY9For 0s9!, E9=1 or !Des(objectE/An+! d3s"multiple steps. TheA can@be pd piece by	!toV#():CL,Qmbers:G~process
"e* `Create
 instance.0*may use die2ent.` handlschemes byK`providyword arguR@. See module doc%ngHfor a listFpossible valuesoc" =sBc%,
oT0RYra2ialQ
K
aS@curr)er4Rbbe a (/1ed_, additional_JS_info'.
        buffered_input must be a bytes object containingcthat
 	were passed to decode() % have not yeZ enMuverted.Badditional_state_infonon-negative integer=representAthe C@ of 
r WITHOUTehavingARproce hePtentsA7bufQ.  InUrinitialjHand after t(), get"()return (b"", 0)5"""H%
Tdef sNRself,~!):D1Setrcurrent,.Z;Rbeen Wed by.  The eff%ofbe equival$to

class BrIncrementalDP.r(This subJ>of 2@ canu!as#Bbase3afor ani:r iR,0blePhandlcompleteIH sequences __M2__(errors='strict'.<)w2B# un"d `is kep twPcalls,(A.b = b""1_4*,e", w, final# Overwrite tPmethoSes: I[Uf an (output, lengthsumed) tuplraise NotIY0edElp0i=False,T (tak|o accountPpdata = -W+D(result,1_[rL,K
pKm# keepQuntilPnext 3 = cA[conQ%:]&~@C+(S6jC$Z&# 66is always 0_geZ# ignoresg=_[0]

#
# 4pStreamWi"d rReader provide generic wor] 
#Terfaces whichDto i new encodsubmodules
# very easily. See enctodings/utf_8.py for an example on how this is
# done.
#

class StreamWriter(Codec):

    def __init__(self, stream, errors='strict'26""" Creates a ^ instance.`.sU must be a file-like object open{writingA:Theimay use different handling
wschemes by proviOB the4
s keyword argument. TheseDparameters are predefined: 2p - rais`ValueEQ  (A sub)c 'ignore' - 
characted continue with KnextHreplace'- 
.a suitable aF0xml3refFR[QDappropriate XMLD
V!re1	#'backslash{9 - |"ed escap	O
sequences.V'namel1q\\N{...}n K	Lset of allowed =  vPs can	extended viaDregister_e65"""(Sself.Z=
=3s =ee.s`!!'s{ents enco7to Pdata,;rsumed =2B([,s[L)SlinesOlistconcatenated ,0str]1 toPGrusing .)"''.join(a)QresetRlX@c busd@keepinternal state0Cal
method should ensure thatI7*th5output is nto a cleanr,Cps appenL	/of new fresh ipout hav@to rnJwholrrecover|FpassAseekd, offset, whE=0):g.2
,#if? == 0 andWQ'U__getattrai,:*=tr):

      .  """ Inherit all other methods from the underlying stream.
 5"""return getattr(self.0, name)
+def __enter__&!):SD<	.3xit-, type, value, tb>7s.close()

###

class SReader(Codec):gcharbuffer^  ='inerrors='strict'LZCreates ax instance.`.U must be a file-like object open for readingA:Theimay use diAent  handlinguchemes by provia4
s keyword argument. TheseD
parameters are predefinedeh2p - raisVEQ (or a sub)c 'ignore' - 
acter and continue with KnextHreplace'- 
.yditable aFbackslashERZP!ed escape sequences;`set ofUowed RPs canextended viaPregisZ&5eamE=2s =1sBbyte+G = b;p_empty_0%b(:
I
6linBNoneLadecodeZ, input,#  NotImple!edQpOsize=-1,s
Pfirstl=FalseDfs dataSrCs`result\qs indicr`numberMde points or Ks toi.c() will neveuR more`than rYsted,Gbut it might  less, ifre is not enough availvpapproximate maximum 
y0or !toQ"R )erCxmodify this set1as apriate default	F(-1s as muchpossible.  	Gi tohv0hav"3to OAhugeG0 $            swtep.

 If firstline is true, and a UnicodeDeError happensCafter theJ Kterminator ininput onlyv,	Mwill be returned,-qrest ofH(kept until	Knext call to read()The method should use a greedy4 strategy, meaning thati$it?f as much data
is allowed with	AdefinitionPencodm[given size, e.g.  ifD op@5al ; enBs or state markers are availableEastream{$seuad too.55"""# If we have`s cachPmergem back into characterUif self.Iubuffer:e8" =/v_empty_a.join(.K)Kv = None#!ifZs < 0# For compatibilitya other<#()^s4y take a# single argumenYs'iz#]`we getU required numberKA]F (ifwhile True"ca
Wbe satisfied fromub ??,>=@Sif leICB) >=v
2Ybreakg#wneed morey	 Q>izeO1newF.(');els%?
C1# dM bytes (those remai[W3lasincludedIL:3 + 1notRN>try'0new#s,dv(,e/s0excWnas excvi\+[:exc.start]?.Q.spli@s(keepends=Q
?FO)<=1.Jrais0# keep undecoded bytes until the next call
 Pself.+buffer = data[decoded9s:]2# put new characters ind O	9k"0 +=Fs(#Kre was no available*Qif no:Ubreak!ifZs < 0,# Return everything we've got@Rresult = 	%.p_empty_5OelseSfirst>t>	 [:1s*[r
zdef readline(R
, size=None, keepends=True):3""" Read one <P from0 inYstream and v*th.Z^	, if given, is passed as argument tou:() methodZ5"""(# If we havs cachedan earlier,?them unconditionally"ifY
O$*[0ize or 72,o	^E$is!weP() only oncE`while i
s(]!, RW!if
Lwe're at a "\r"Qextra (which 	`K!beB0n") geQaproper ending.ni*Ktemporarily exhausted@YwrongZ
if (isinstance(>a, str).Pwith( ))\H/  HIJbKnu'(1=1,hFs=1)0line += data
 lines = `.split
s(keepends=True)
21 if.)s:"1en(B^) > 1#'# More than oneN result; the firstis a full
rOto return Os[0]$"dea!@cache remainings|4	s[-1] += self.charbuffer5(:(0X = None/Oelsea# only
, put it back into piO(_[0] +
tif not -_oFalse)%]breakT0withend\F(:out+5inet!o\P: # W}ally have aM endQ# Put|3restogether and\Quntil)next callQv_empty_C.joi2[1:]) + \Q
QJ6!ifE%FI# we didn't get anyth7or this was oury9tryXdata or size isC:qif readn< 8000!E*= 2r
"deL s(,Phint=,:8F""" Read aZs available on inastreamq9`them aVlist.a(QLine s are implemented uscodec's de

amethodAncluded it entries|a	,given, is ignored since there is no efficient
 way to finding1 true end-of-line.
25"""data = self.read()preturn "`.splitGs(keepends)Qdef reset(D"):P""" Rscodec buffers used for Ointernal statK0Not atstream reposition?should take place.AThis methodIprimarily w@nded?pbe ableyrecoverDfrom decodoerrorsVR.byteG = btEcharv_empty_~~1BNonejAseek, offset, whence=0):F1Setbinput J's current R>5jr.
x)Sd__next__g@the &0ed 4 .'	!ifIJ+braise StopIteraf__iterEI-dgetatt0u, name,j9*=Inherit all oKsqunderlyH]='h.	e4exi, type, value, tb%s.close()

###

class SReaderWrp
 instancesow wrappus whichvwork in both .` and wiX modeThe designqsuch that one canfactory func1snoQed by*A.lookup()1construct)A@# Opj0al bibutes setiBfileQbelowT#en= 'unknown''in", ", 8='strict'@Creaak` must ;-like object2
:
A or ZevQproviXv,}_Prface$pEC` handltis done in the s
ame way as defined for the
 StreamWriter/Readers.
#5"""aself.s02 = 	
r@2 = I($, errors)-wt2 = }-B# =K@def s(, size=-1):preturn  .*!er(+)'EHlineIONoneK7?izeOsP_hint=Ts6Y__next__XR""" R@the & decoded P fromc input.+;_))er~%~a:eSIh, data1.(r()DIOlistI4.NQresetC."4AseekN, offset, whence=0):&_.2
,l#if[ == 0 andsmqU__getattrq, name, =*=4n
Inherit all other methodskunderlyingpiyhSf#Pse areto make "with zS...)" work propd__ente	.$xi{, type, value, tb>close()

###

classrQ instances translateG^one encod\Qto anThey use5 complete set of APIs Ped by%
cs.lookup() function to iH@ment2wir taskuData writte/us first!in~i@mediformat (depenBhe "!" )EthenG
0 us;%aniprovidedKK  InAdire%  i_"adVea2!ed!to~ccaller"""
    # OptioBbe factory functions or classes provi=]ks respE` handl,pis donesame way as defined for	q/si5"""/R.u=
b=
t=
Cer =o(g", )--(-B# =K*s&hize=-1U!= *"erWFsize&r, bytes#d 4(!F<areturn[
HlineHNone0if @ is :qT|Oelse8n<bBsPhint=z(>`.split4s(keepends=True)T__nexiR& d SSinputI.j;{/er>7)-,data, bytesdecoded = self.deb(data,errors)
 breturnqwriter.4!)
(Adef `lines(Z, list):!Ld = b''.join( ?r, bytes@Qreset.reader."AseekN, offset, whence=0):&# Seeks must be propagated to both the Rs andK'rsC as%y might ne=ir internal buffers.>_.
)S__getattr__Qname, *=z""" Inherit all other methods from underlying stream5"""urh.0 , 0__e/D3Cexit-, type, value, tb>7s
.close()

### Shortcuts

Qopen(file, mode='r', encoding=None, ='strict',!$-1IErOpen an@0ed \0 us2\Qgiveng_8a wrapped version vi transparent]Aing/Bing.#Note: TheL winly acceptobject formatdefined by%cs, i.e. Uni :s;0 moReuiltinE&cs. Output is also p dependgusually beClwas wellUks are always ed in binaryx$rdefaultAmeanoH!in"M1specifie(` which^k@e us orXD`u0 ma ;2to 9` handl0 It4to causes V8EdPe raiin case aP occuh!d same Ea'b&Uf() API#-1GOau` size `Kmeeoiep extra UFibut.allows quer(V. ThiRbute is only available if an encoding was specified as
 parameter.
1"""&if=is not None and \"a   'b'in mode: # Force openof the fin binary43A! =  +Z2= builtins.Q(Qname,., buffering)4areturn6tryinfo = lookup(>W1	srw = StreamReaderWriter , ?!.sr	w+, errorsU# Add attributes to simplify introAtion.% = 1srwfexceptAv.close(raise

def E7cedFileTdata_r,?=b='strict'):`R""" Rua wrapped version ofK which providransparent}  t la0Dat_PittenAon is decod@ccor]!toigiven 3theL$ed]underlyingFh us!P. TheermediatedU type=will usually be Uni but depends on"'cs ByA}Q from/E arepassed backbcallern2ed G	.IFd0, iQfaultF,1 ma<adefine" handling. IY4to kcauses ValueEW1be d in casErXoccur{x%ed|gobjectwo extrag..FI-@reflVBs` Psame 2k0canmu5forD	w by PythonDgram.
!is/
s=wBxg
&
&'sr%R??"e,,Sg)
+sr0!sr_encoding = 4file_encoding
    return sr

### Helpers for codec lookup

def gete=4er(E1):
HQ""" L+s up the?Idgiven 6C and{>2its er function.]Raises afError in casep\cannot be foundD1"""k.?e deE^a{incrementalEIiED class or factory:9!orcs doesn't provide an 4# =7=&y$ifK is None:rO$OzjPD&n3if &@TOread#FqStreamRcK[
9sOwritLWcx(Rator,`ing, es='strict', **kwargs)'*Ding E!es`input Jngs from0terw using an Inc6rementalEncoder.

    errors and kwargs are passed through to the IncECconstructor.1"""ejv = geti=(Ring)(B, **)@for input in iterator:0out!= H2er.(3B'2if *:SyieldS% O"", TrueRN	JA
def deg(,Cing,t='strict'@DC1ingP!es Jngs from.0 usA(an@,E;r6P..GrOb### Helpers charmap-baU1cs
)	make_identity_dict(rng):O""" "@ -> /)Return aionary where elAs ofrng sequenceC@mappsmselvessrfA{i:iiGrng}ing_map(K
`CreateyB map$a 7If a targetp!in2 occurs multiple`times,05$atL!isONone (undefined,G%caWexceptionmnuntered byi  C0durptranslaAOne exampleWre this hns is cp875.p2ich/%es^}Pacters\\u001aiam = {};0k,vO.items()qif not *mm[v] = kQOelse#h&U0m

: handlers

try?1ct_ s = lookup"(""Rgnore+i+oreplac,-0xml3refc
)Abackslash@(?Oname:#")
except Look$upError:
    # In --disable-unicode builds, these e0 handler are missingCqstrict_%s = Noneoignoreoreplacxmlcharref$backslash#Oname
# Tell modulefinder that u cs probably needs encodings
# package
_false = 0
if Xgimport50
##{Asts
,___ == '__main__':
9"# Make stdout translate Latin-1 output into UTF-8=Csys.:0= EvedFile(B, 'lK', 'utf-8'){1Hav{/inz+inyx?in w%ink)
r"""Utilities to compile possi inlete Python sources.

This0vidI wo 	erfaces, broadly similari"thtin
function~(), which tprogram text, a file and a 'mode'
and:

- ReturKde object ifD@comm3!isiVvalid:ONone3	+aise Syntaxq, Value or OverflowQa
  s?(2R`can bea)duced by
  malformed literals).

Approach:

First, checknsists entirely of blank lines\
1Pents;=Cso, 	 it with 'pass', becausefbuilt-in
parser doesn't always do&right thing fosese.

Cthree times: as is,s0\n,
\n appended.  If its86it'&BilesJL,
we exp>Emore6(either way, w mpAthe
pget whe]> \n*'\nxh>#s
MQ samex0 isTpken.  B5$different
!Nouitive; not even guaranteedhold in future
releases; b@atchhiler's behavior from61.4
through 2.2, at Qtaveat:

It|0e (jrlikely)+\`stops 
Ua
successfulcome before reacrC0end;this
casm@railXsymbols mayYAsteaE*"an.
For example, a backslash followed by two newlines may be  
arbitrary garbage.  This will-ixed once the API forparser is
better.

Thes4interfaces are:

compile_command(source, filename, symbol):

    Co0s a single :1 in}manner described above.

CbA$r(R`Instan@of tclass have __call__ methods identical insignature to;pdiffere*is that ije@i<s program text containing a __fuk__ statement,FJ'remembers' andZall subsequentisGAwith_W@forcBmodule also@0vidqnother 9:kcract likBbuilt-in functionAbut 'memory'^sense"""

import80warTas

_fes = [getattr(i0, f)-.,P_7`s]

____"C", "r"]

PyCF_DONT_IMPLY_DEDENT = 0x200# Matches pythonrun.h.

def _maybb?r, lU# Check +@sistof only blank Hm!s.2<(D.split("\n"):$l$=Gv.strip(r!if([0] != '#'@DPbreak	@# Leit aloneFelse<#ifdVf"eval"L = "pass" # Replace i0a ''6tryOUreturrexcept SyntaxError:  #t q>@() e<Spagat0# C%! sP R afte@firstd# em3" (W, Depreca) at most ts .c_).simplefilter(""")(pcode1 =r2 = NonW#	z40 + u:G as E%!rr?\n"1`etry:
        i f not code1 and _is_syntax_error(err1, err2):
 Praise1Kelse%eturn None&vfinally%_  =G22 =(O
defrep1 = rep)a0repI2	if "was never closed" in>2rBFals"ifA=*2Tru)	:compile(source, filename, symboln:.
, PyCF_DONT_IMPLY_DEDENT)
n?_commandu=""="single"B"""C3 a H2determine whether it is invalete.
Arguments: -- the string; may contain \n charactersK-=optionalB from whichVread; defaultF 	^grammar start$; &# (Y), "exec"Hbor "eval"RKvalue / exce!s Wd##- )sde object if3 ispkQvalid@7/SE0, V or OverflowaI"  DJor (6hVcan be produced byDmalformed literals)."""_`_maybeR	,\

class """Instances ocY(behave much likebuilt-in}"il@funcA, bu0onetused to,@ texwing a futurEPstate+,L"remembers"Wiles all subsequentA['AwithQdforce.Dm_init__(self.flags =aECcallE|m_vDob =
&,  , VEpfor fea<_sg&!ifbob.co_&7.Qr
8<|? |=5,fvmrbnl"__O methods identical inpBsignXl;differenc1thathe
    instaNnce compiles program text containing a __future__ statement,
    the instance 'remembers' andZall subsequentisGPwith L_ in force."""
%def __init__(self,):.Rr = C(()<Dcall< source, filename="", symbol="single"hCr"""\  aAmanddetermine whether it is inRlete.@ArguF&s:2 --
 string; may \n character@SAoptional from which was read;DFdefault &	f70mar#rt=$; ># (ME) orGis  "evalReturn value / exces raised3#- -de object ifC1com ispUvalidDONone;3 SyntaxError, V or OverflowaM1  sG  eH* (:^Z`can beBduced byHmalformed literals).G^rbp_maybe_1ileSC,' )
'''This module impls specializeder datatypcviding
alternatives to Python's gen purpose built-inPs, dict,
list, set,@tupld * d   factory funcW` creat&subclasses A fields
* d9v@-lik:$"er5fast appendspops on eiend
* ChainMapKL
"a 
 view of multiple mappingqCounterNOiMing hashabl#;OrderedDict ;Uthat Mo.` entri&ere addeIw>s ato supply misBUserP   wrWr around#rys@easink * MAList&MGGSIKBA

__A = [''\'&defaultdict',
    'deque',

namedtupl]

import _collections_abc
sys as _sys

from itertools ;Qchain%
&arepeat'(qstarmap)*tkeywordv$is,operator-!eqP/eqitemgetter'/treprlibMrecursive_2
6_weakref7Qproxy.
a

try:W3
except IRError7pass
elseA.MutableSnce.register(W)faultdict?

#<Q OrderedD`<#

class _eKeysView(M1):
def __reversed__(self)hayield %#._mapping)OItemfor key in `(key, _[key]_ValueKYLink(object
__slots__ = 'prev', 'next0key_4__'K#(
O'ionary that remembers inserN  o'5# An inherited JP mapsas to vQ.-Oi_hardroot%($N7@(to #ent circular ref0erences).
    # Individual links are kept alive by the hard ref? in self.__mapKLThos*(s disappear when a key is deleted from an OrderedDict.
def __init__(o, other=(), /, **kwds):-'''InitializeToT dictionary.  The signatureusame asKvregular:ies.  Keyword argument bEpreservedP6tryu.__root%0excyAttributeError7; = _Link()E]4 = )QproxyI4.__B
9+S.prev7S.nextbmap = {}qupdate(usetitemkey, value,L_5=
$._A__, !=_ , =(od4(i, y) <==> od[i]=y'z# Setting a new  creates-1 ataend ofved listQ# and`inheri>0ad with)vAkey/V pairX!ifD4not$map[key] =! =*$ ={4las
1ink,a, = >,,
=1ast2	Z" =(X=`A)h0del
h?M-__3(00del4(y]2D3an exis?|T usesb1Sto fi which get# removed[2s
predecessord3sucVnodes42RVzpop(key#_/_.
</
#AX#4	#JNone<1 = @3ter
iH(od)TraversecCGCcurrFawhile 0is 8
Qyield$E.key;X@X!red__(self):
        'od.__reversed__() <==> s(od)'
 Q# Tra+ the linked list in4u order.5root = selfk5ootpcurr = "U.prevawhile ais not$: Qyield$I.key9=Xdef clear()N) -> None.  Remove all items from od.0nexs.__map.Cdict&!)
0pop, last=True$''nd return a (key, value) pairnrionary.iPairs areC edBLIFO1 if is true or FVfalse
&'';!ifvraise KeyError('hqempty')
.]
^ rM_0! =k	"."8DPDOelseT+MMv	"o"_	"D3"4key\E4delmap[key]3A0 = C.pop7keytqVUv_to_end:Mn existing element toend (or beginn!-)R\S2doelmN
UN:Psoft_##_	(
#X:#	>=$asU.k&ass	:y:	"G6firr,UfG	;t6ink__sizeof__ = _sys.get{nL"en7@ + 1# number ofs includ
Q` = sizeof(self.__dict__) # instance tionary
!size += of(self.__map) * 2&   FaternalF and inheritedShardrootXnX# link objects?
;@}# proxy@areturn
Uupdate = __collections_abc.MutableMapping.)@def keys!):T1"D.) -> a set-likeviding a view on D'sK"E_OrderedDictKeysViewpOitem5
Io_valuen
.
Vj`__ne__)Acrker ="()1popm,, default=4`'''od.0Qk[,d]v, remove specifiedH#the corresponA.  Id is not found, dCed if given, otherwise KeyErrorPis raised.6''' h n (result =U[key]7?del @4$ifJoZxU(key)E[3setJNoneaInsert@with]' o0in 3QRc A for[iC
?d, else.:elfY$ =^]>@_recursive_repr(mU_!__S@5od.q) <==> ;9od)[/'%s()' % _.__class__.__name__,l3/%r5R listS7())Oduce stpinformapickling1nst`c = varS.copyC
2 in#'()Q*PO!, N+Q, (),: or None, None, iter(self.items())

    def copy!):A'od.) -> a shallow,u of od',qreturn ^__class__Qe@amethod6vfromkeys(cls, iterable, value=None''Create a new ordered dictionary with Q ZQB andTs set to.' = cls()!0forY5 inV)B6r[key] =];C__eq!z, other3od.#y) <==> od==y.  Comparison!an=b OD is-sensitivezwhile c: regular mappingA%inC.'$if isinstance(2, OGDict;0all(map(_eq,HG^?ior_{c.updat
b"NMoif notNotImplemente
%=.B?new8newrgY]B
tryVa_colles importd
except IRError=# Leave the pure Python versionRplacepass


#<Q namedtupleb:
-_{ogetter.% = lambda index, doc: property(_8O(!)"p=doc)

yP(type, field_qs, *, rp=False,~Qaultsy, modulA"""R^s1subMadms>>> Point =!('', ['x', 'y']0.__doc__u#0str2fr_b(x, y)WX2p =(11, y=22)Z"# P ti poonal argQwordsiW[0] + p[1]O
# indexable 
like a plain tuple
    33>>> x, y = p# unpack KwregularMFS(11, 22)
p.x + p.y]   # fields also accessible by namd._asdict()V# convert to a &eionaryad['x']!11Point(**dSdXNfromZ@ x=*y=_replace(x=100a%#  B) isiDstr.6) but targetsd5zB00, {A"""
	# Validate the;Gas.  Atuser's option, either gener8an errorP
message or automatically Sh with a v.Iif isinstance(0_s, str):%~" =)$',', ' ').split(
8list(map(str,F).@type = _sys.intern.("))SAif r,seen = se}or index, in enumU7qif (not4.isidentifier$or _iskeyword( "orK`startsO('_'(JR[]1'_{
%}'-D4.adfd[W8] +U0if $6str"hraise TypeE ('Cs an-pmust beaGings0if ^BtnOValuo
	&f'@s: {:!r}(0canb#b		0jKame.[%vF8Qnn underscore: mpf'Encou4ed duplic;	;DZ
$_defaults = {}j5if !isFNonelts = tuple(defaults)
 uif len(! >field_names):-4raise TypeError('Got more D values than H H'u_0s = dict(reversed(list(zip1G)),
Yr)
H# Variables used in the methods and docstrings3
 = tuple(map(_sys.intern,AAnum_;t
#Y@arg_ = ', '.join(&8if K6= 1B+C'Vrepr_fmtVH(' +\ '{T}=%r' foru2)KD_new ._!__i_1, _&, _len, _map, _zip,2,g!, 4zipCreate allRnamed1to be addo'QclassRspaceM<A = {('"':ZU'__builtins__': {}V f'd`_{type"}'.}qcode = f'lambda _cls, {#}:-(()vd = eval(U,]$Pame__
a.__doc #f'minstance of G$ifs is not Nonehlmz@c)0def*1ke("@iter{Presulq;new+H!if{(2G) !=0+f'Expected {d} arguments, got {_}rreturn _make.__func__~(f'Make a s object from a sequeD'or 7"')}Vreplace(self, /, **kwd0 = #.(((I.pop,')w0if )ZV
'f(4uneac0: {p?)!rS

MR|O4ing specified S'as with	X_X_X'PicelyW0matS1esentation S>_"2WP__ + @% as{ a new dict which maps field names to their values.'
 	return _dict(_zip(self._>0s, 1))
0def __getnewargs__-!):Q"'RO6 as a plain tuple.  Used by copy and pickle2_}# Modify function metadatahelp with introspe$ddebugging0for:hod in (__new__,pmake.__p	wreplace*Y_repr$ asQ#78method.__qual__ = f'{type5}.{$D__}'Build-upb classPpace aionary#v@use Z ()<b@=bresultD/N_qsN1= {1'__doc__':({arg_list})'.Qslots0(()kGn
 _defaults(+=':  '_4
	)#		*bmatch_Sv'}uaindex,enumerate(E<Xdoc = _sys.intern(f'Alias M4 number {[1}')l[]Oqgetter(6S, doc%rD=af81, (62,),_U8R# For0ingQwork,	__module__ variable need`be set1the frameq# whereAd is created.  Byp0this stepUvironmentsDPGdHnot defined (JythonYexample) or 5P;Bargurgr than 0 (IronP\ ),Quser hasOPifiedwarticular ;.%#ifFNone6try
8	(1).f_globals.get('___', '__main__H
except (AttributeError, Vzm
k.='O


#4IP  CouS
X2!

`cWA_ele(mapping, iter,'Tally elements from the iterable.'
    mapping_get =A.getfor elem in9:<["]>L(, 0) + 1

try:2
# Load C helper function if availfrom _colle"s import@unt_ents
except IRError
pass

class Counter(dict)'''Dict sub$c(ing hashms.  Sometimes called a bagor multiset.  Elem are stor, s zionary keys and their tsJ3values.
&u>>> c =`'abcdeabcaba')  #WOa stringH.most_common(3)# three & &T[('a', 5), ('b', 4
qc', 3)]#sorted(caq# list all uniquefe`'['d', 'e'a''.join(i. 0())ua with repeti 'abbbbcccddeBRum(c.(Q# total of'15nS['a']3of letter 'a5J'shazam'{# update"s I1...cA+= 1# by add1 to each"'s`N!c0now"reEeven7Hdel c['b'# removeg"'b5*# Tzero A0dZsimsalabimUG # make anothe%er"c. (dv2	#Sthe secondJDLEnineK9c.clear(%Pempty8)UNote:  If a1p is setPor reduced, it will1ainW(inta untilPentryUdeleted orP er2ed:aaabbc')hMI-= 2
Qh0'b'6twoI	+T#N stin, but it+%Q73-1
A20)]"''# References#   http://en.wikipedia.orgH/wiki/Multiset
    #   http://www.gnu.org/software/smalltalk/manual-base/html_node/Bag.Mdemo2s.com/Tutorial/Cpp/0380__set-m/CatalogL.htm\code.activestatebrecipes/259174/4Knuth, TAOCP Vol. II section 4.6.3
,def __init__(self, iterable=None, /, **kwds):2?('''Create a new, empty Counter object.  And if given, c elementsMfrom an input~p.  Or, ialize theC2other mappingO%ofc0 to6"ir8"s.t>>> c = ()#%erqK'gallahad'UK3er U{'a': 4, 'b': 2}[U
a=4, b=2KSkeyword argsJ5'''super().R)elf.update(bZNumissing8keyzT`not in is zero.# Needed s0at [pitem] does Nraise KeyErroreturn 0Qtotal;aSum of0sC1sum6.values())Tmost_common$1, nba''Listb n 1 10andnG/7,P leas@If nD`then lp4allbV('abracad0').s3[('a', 5), ('b', 2
r
]f`# Emul~sortedByxSiYFm.
s(), key=_getter(1), reverse=TrueG# Lazy importxspeedup Python startup time.Uheapq.nlargest(n,	Fd
5Itor over	s repeating each as manys2itsD'ABCABC's5(c.)!b['A', B
C
'C'!# 
's example for prime factorso1836:  2**2 * 3**3 * 1c7**1
 !>>> prime_factors = Counter({2: 2, 3: 3, 17: 1})9oduct = QBfor O: in_.elements():# loop ove4sd1...$"prh$*=W
# and multiply themLHU1836
Note, if an @'s c
 has been set to zero or is a negativeJtnumber,Fs() will ignore it.v5'''8# Emulate Bag.do from SmalltalkMset.begin"EC++.Ereturn _chain.B_iterable(_starmap(_repeat, self.items()))# Override dict methods where necessary-b@class#1defkeys(cls, , v=None):)1# TUis no equivalent J erPcause semantic-# would be ambiguouscases such as'aaabbc'&2)G# Initializingvalues isn't2 be!(Qlread default E
ikups. J`to oney	easily accomplished withT(set(|)).  ForJmqexotic %P, cre~aionary first usJrehension7cVraise NotImp	edError(O'Dundefined.  Use instead.'pupdate(, /, **kwdsb'''Lik.=) but add	Yi of replacqSource cann	I,2tanotherGanceOcz'which'c@'witO#s xCndnaP	!n#d)dn	
LV['h']@
# four 'h',1ch,wN4A
^The regular,) operatAmakeasense &th#e behavior result0ome original untouc be@mixed-inPh all?Bthe 6/a mismash thatQ# doehave a straight-forward interpretation in most counting
 !# contexts.  Instead, we implement straight-addiN.  Both the inputsOpand out are allowed tojain zero (negative5s.
H	if iterable is not None:!%sinstance(0, _collecs_abc.Mapping)?CNselfp_get = I.get$for elem,m.items(z9Z[>3] =@+oz(M, 0)x;elsM# fast path whenU erH]emptyL6super().updatM
yu_U_Pents(,Bzif kwdsl-u)def subtractQ=	q, /, **2Q'''Like dictUU) butLs s 7ead of replacing%m.C,s can be reduced belowK#dSource%anT1, aionary, or another Tt>>> c =#('which'!.w@'wit #KU fromVA('wa^)[Vc*erUP['h']?0# 2, minus 1
]0
?['wgUM
Ug"-15'''u8"E,&
" -ZX8fs
1oWAcopy'Return a sh &.r .__class__FZ"__W?0, (F,+__delitem__(self, eleSm):
 :'Like dict.__delitem__() but does not raise KeyError for missing values.'Rif elem in selfkrysuper()l.!)
@def __eq__(<x, otherTrue if all counts agree. Mre treated as zeroisinstance(j0, CT	sreturn NotImplemented1allb[e] ==.cEec/ne$ny?disuQl= are a subset of thos5X<&/ltopropereA and# !g+?perm>g2dCrepr!if#H
50f'{.__class__.__name__}()'E:try?#() preserves the ordery_ed by most_common()S2d =H	()except Typehandle case where Oable|n 	r{d!r})'a# Multiset-style mathematical  ations discussed in#   Knuth TAOCP Volume II section 4.6.3 exercise 19
    #   and at http://en.wikipedia.org//Multiset9% Outputs guaranteed to only include positive counts.: To strip nega&Czero/, add-in an empty3er:B`c += CaBer() When the mplicities are all mror one,$set opera:sG/
be equivalentecorrespondingFfor regular seTGivens such asV  cp a=1, b=0, c=1U'cq*c*d*e* Th would bes{'a', 'c'}.ws{0{'ceaAll of`follow02reluoMholdqet(cp + cq) == sp | sqy&-&-&|&L&&&L$==$(L= sq'!'!'<'<'tL>L>L>LY	def __add__(self, other)b'''Adds from twQers.
H*5>>>'abbb') +Bbcc'5-q{'b': 4e: 2, 'a': 1})X5'''dif not isinstance(,gfreturn NotImplementedMgresultDRelem,@ in {.items(f1new# =.+F[B]o.6> 0g:4 = [E0if 4*~PB?subB	 Subtract!, but keepSPns withX~
aTc') -o('bccdc[unt = count - other[elem]
 if newcount > 0:(bresult:% =-(@for W", E"inl.items()R!if- not in self and<<20 -.rreturn 
def __or__(c,'''Union is the maximum of value ei4"RinputzBers.h!P>>> C@er('abbb') |Qbcc')-)
{'b': 3, 'c': 2, 'a': 1})X5'''72sinstance(,gfNotImplementedM)$ ==(@_=b'j^#1"ifL" <:Belse	Ev'y?and	 Intersect$incorresponding7
&'	 	.3pos'Adds an emptyper, effvely strippnegativeSBzero1sI/;
8?neg''Subtracts from
@.  Sos posi,kBflipsign on 7B;>;Tkeep_(self):
        :'''Internal method to strip elements with a negative or zero count'''
   qnonposi%0= [AA forJ,/ in self.items() if notE> 0]N:3Z:!t1delPm<Rreturj
0def __iadd__(, other)Oplace add from an&er, keeping only 
"s.k>>> c = Cou_('abbb') +!
(=2/anli!Hsect$incorrespondw/ &"Y7vRgRw<D/
#4I  ChainMapY2u

classYb(_colls_abc.MutableMapU''' A5 groups multiple dicts (orr mappings) #together
    to create a single, updateable view.
*$The underlying mappings are stored in a list.  That is public and canObe accessed ort0d u the *maps* attributeT0erePEno oSstateLookups searchH!su{ively until a key\afound.In contrast, writes!s,deletions only operL!on{QfirstJ.2'''Tdef __init__(self,!):6'''InitializChainMap by sett+!tovUgivenJUIf noprovided, empty dic!arCusedI.! =()@[{}]"# always east one	0mis7key
raise KeyError(=getitem=0forni:tryUreturQG[key@   #'t use 'E-' with defaultUZeexcept{Epass2&__,	N# support subclasses twdefine =A3getDkey,X=None	"if8 n T else<\S__lenMlen(set().union(*JT!))P# reughash values if possiblepNiterqed = {}Qreversed
"d.(.fromkeysW3   8(d)zCains,h=0any
!m BRCboolNI7@_recursive_repr()<N1f'{M!____.__name__}({", ".join;(H,>t3)})@<emethodywPcls, 8w, *args$'C2 d V=Q!.'r;cls,}AcopyHENew %or%`a new 90 ofAs[0]e@refs[M[1:]
kxL@[0].Q(), *self.maps[1:])

    __copy__ = 	def new_child(self, m=None, **kwargs):?  # like Django's Context.push()d)'''New ChainMap with af map followed by all previous%s.FPIf no is provided, an empty dictFused6
Keyword arguments update theM!orD<5'''~@if m^	:Bm = Celif,.~(1#preturn o.__class__(m, *Cmaps@propertyn0par(op	@from's7./__setitem__, key, value)#[0][key] =$\__delJC6tryP2delWDX<except KeyError;Uraise(f'Key not found inEPfirst$ping: {key!r}'0pop'Remove and P0an *f pair |Y0]. R
`a.0'Nos
.*H
Y*key* 2its"f ; inOs[0] ((&Qclear%&C, leaving1:] intact	TU__iorWothern	<$KUiinstance(S, _collections_abc.MapFrNotImple%ed#m.!tuVmrjAfor orreverse*m3F return self.__class__(m)


#<Q UserDict
`:!

aD(_collections_abc.MutableMapping):

    # Start by filling-out the abstract methods0def __init__(self, dict=None, /, **kwargs):0d'.data = {}!if; is not B48pupdate(e);f1 )3lenreturn len	6sgetitem:W, key? ifE in 
`X[key]rhasattr~, "__missing__"rU3.1Nlraise KeyError(s , |
! = E0del3-6del'	Citer9s# Modify __contains__ to work correctly when swpresentCi>9key# Now, add ;m2)Qs but:in ?rep8o6w, other=if isinstance(,#(Ts" |^2b^#oNotImplementedmrJ,& |+^Yi47 |=Felse2-"Ncopy" =V3new-r`nst.__\3__.q,# Create a  and avoid triggering descriptors
    
inst.__dict__["data"] = self.copy()
9preturn D
Adef $?!):)$ifQclass__ is UserDict'+T(J.}~aimportpi):tryhXU = {}(1c =Vr)uofinallL	vc.updateEc5@amethodFfromkeys(cls, iterable, value=None_d'lsfor key in<
Pd[keyQw_d


#<Q@List
`:!

Fa(_collections_abc.MutCtSequenc?8"""A more or less complete user-defined wrapper around list objects."""__init__ , 
-VU = []%if2#@not 
# XXX should this accept an arbitrary s?]if type(B) ==Y2 [:4=	Z els
6ancb,Y&[:Jelse	! =Creprw)8l^other=<Bast(/	Le", LcM/eqM=M
g>g>
3J | ?ycontainsNNitemMnD3len?9?len[0getV:7, i=
ei, sli5!__M6[i]r:
            return self.data[i]

    def __setitem__("P, i, !):$(:! =A0del1A;?dely5add4Wother8if isinstance(, UserList(&res__classX1 + @
)/eldAtype	/k#fBlist())VrK& +8kf
7i57 +=)k^	"UP&se[b	-3&"3mul7, n/.3* nj1__rEQ = __
`i

aO*= n
Ccopy" =zc.__new-6.__dict__.updat,# Create a  and avoid triggering descriptors	e ["3&"]}5[:]9y@HcappendF(I.& <dinsert<.)B4pop?7=-1{*icRremov]y&Qclearxrkl/!%Ecoun 7temo@.,QindexV, *argsH	3H-brevers6D!%so/Rx, **kwdC0'3extnf, other):
  if isinstance(other, UserList):
&self.data.extend/))Oelse7_)


#<Q`Stringb:w

classc(_collections_abc.Sequence):
def __init__(BW, seqZ
seq, str!}9i  =?Z/el?FQ7[:]Nx0tr(3strk`returng)6?rep78$inEn?int6Ofloa8:complex >Ohash;8getnewargs>:I[:],\#eq6G7ing+,%/0 ==1ing7(l@<'	e0G<0(g0H>0'	0H>0(tcontain5X, chaG
! =C 5in 3lenT|%6len	sgetitem:~, indexAr!__,[0]S3add#, other):
        if isinstance(other, UserString):
 return self.__class__(qdata + B.
):/elf?str_#Z2str1))
def __radd,*" +$

65mulnQzC * n1__rEQ = __
&mo
Oargsc!% 1NrOtemplateS5tr(-! %@*# the following methods are defined in alphabetical ordercapitalizeD.:CcasefoldO8	MQenterK, width, *X".cD	>@Countbsub, start=0, end=_sys.maxsiz
	7sub = sub".cremoveprefix
7, /
"!2 = 	.A6suf
	"!SY!C(Rencod
coding='utf-8', errors='strict'v9#= .E if is None elseW4 = Y<l :8Cp!e(4ingEendswithAnLF8drxpandtabstWize=8?\ieE?2fino,g!erString):
  sub = sub.data
return self.find(sub, start, end)
0def format(0, /, *args, **kwds):(\X9
0XC_map\mappingS4.QSindexL!=0=_sys.maxsizec	FqisalphahH
(J;?num;(
;Oscii;(	;decimal=*
?2igid(	;identifier}-	E?low@(	;numeric}*	?printableA,	COspac?(	;?titz(	;?upp3(;Ajoin_, seq	*q=Bljus)s, width-G__class__qC	=a

S5)GDstrivchars=NonTB<Zmaketransu5tr.partitiocp./pDreplV, old, new, wplit=-1Wif isinstance(.zUserStrmPold =R
ClCPnew =
CRb`r@elf,
4&rG%Ghjust(self, width, *args):
 return self.__class__(data.rjust(width=!)
>def rpartition3_, sep]N0pISstripEchars=NoneLB<)ZSsplitY1sepWQ, max?=-1d$F(sep2[r!lf\>]\Slineskeepends=Fals;5startswithYprefix, =0, end=_sys.&/izlN	HF	v,qwapcase/s8,OtitlJ5	GrranslatK7tt@G_upper5QzfillG!, :<6)
from _collecs_abc import *__all__%CallableGenericAlias
"""Conversion fun}2 between RGB and other color systems.

This modules provides two Jfor each=P ABC:`rgb_to(r, g, b) --> a, b, c
  abc"Crgb("/

All inputs"ut0re of floats in the range [0.0...1.0]
(PexcepQ of ITaQ, whi+ a slightly largerQB).
IqoutsidePRvalid! may cause frs or in&o`.

Sup)ed8)s:
RGB: Red, Green, Blue components
YIQ: Luminance, Chro
 (used by0Psite o signals)
HLS: Hue,C`SaturaC
HSV p, ValueM

# References:
# http://en.wikipedia.org/O/YIQ#
0HLSor_space/)SV/
S = ["nyiq","yiqY$",hls","hls  "rgb_to_hs8v","hsv_to_rgb"]

# Some floating point constants

ONE_THIRD = 1.0/3.0
SSIXTHu6.0
TWO("2.( 
# YIQ: used by composite video signals (linear binations of RGB)D: perceived grey level (0.0 == black, 1Pwhite7I, Q: coloZ@pone#
# There aQat many vers|6thein these formulae.Ka ones is library3sB@from?D FCCiNTSC.

def rgbyiq(r, g, b):
    y = 0.30*r + 0.59*g	A11*b!i!74*(r-y) - 0.27*(b-y) q #48 E'41 return (y, i, q)0yiq5rgb# r = y +A27*qp41*i) /q74*0.41 2786# b:A74*q/48:g:-`'301|
0.9468822170900693*i6235565819861433*q8fB478764629897834*i63569107918738019- 1.1085450346420322q#1.284064666*qif r < 0.0^10.0Lif g  b  0r >
`1` ` b@` =
VHLS: Hue, Luminance, Satura
# H: 
2ion<e spectrum
# LlightnesssI:;hls:maxc = maxT1min*in0sum(8+%Urange-@l = 4&/2MDrcp0.0, l,`if l <5,Cs = s/_+Oelse$P(2.0-rLEggbb=Hch = bc-gcZ!el&2.0+rc-b*F4.0+gc-r (h/6.0) %`gh?s4hls2@if s
UlBlUm2 = l * (1.0+sT
~#c+s-(l*!m1 = 2.0*l - m2_(_v(m1, m2, h+>R8), -(-#ue`hue = +!if< ONE_SIXTH:
     !   return m1 + (m2-m1)*hue*6.0
    if hue < 0.5:62$TWO_THIRD*`((U-hue)lV1


# HSV: Hue, Saturation, Value`: posi in the spectrum
# S: color s; ("purity")
# V!brightness

def rgb_to_hsv(r, g, b)maxc = max1min*inv-c%2if (AcRIQ0.0, v0Ps = (r-70) /xKrnr';g g b b lif r =h = bc-goelif g&2.0+rc-b*&seF4.0+gc-r (h/6.0) % 1u	rh, s, v0hsvCrgb(@if s60.0jB0v, i = int(hp) # XXX assume) truncates!1f.1- ip = v*(1.0 - s)q"*ft32-f)!%6>Aif iIt, p&1&q
&2&p&tL3&O	&4&qv, p, qL4# Cannot get here
"""Module/script to byte-compile all .py files to
c.

When called as a Fwith arguments, this Ss%directories
given@2 recursively;0Q-l opf@prevV it from
, ng?'o Zhithout&ifms on sys.path, ?try:
        names = os.listdir(dir)
    except OSError:if quiet < 2print("Can't P {!r}".formatZ[-names = []Zb.sort($@for 1 insl!if == '__pycache__'"acontinue_AfullRpath.join,Qy+b ot' is@)hdyield nelif (maxlevels > 0 andi! !lcurdir$paL @	Tlink()rom _walk_%, =
[ - 1,	=)

def compileb8dir]None, ddir=force=Falsel#rx&^=0, legacy0 optimize=-1, workers=invalidation_modeW*, strip
gprepenlimit_sl_destG@hard|b_dupes~"""Byte- all modulesthe given directory tree.
Arguments (only% is required):'Cdir:QK7o b~T:imum recursion  (default `sys.get!2()`3yxhat will be C`ed to (\file as it5d into each0de +.@Cif True, 0, egif timestamps are up-to-dat2jMJ` outpu1th  or 0, e!s Owith+)no>2asproduceP pyc $"stead of PEP 3147K : !}$ofs -11 ofEvinterpreter. MultiplPleadsmKs?one1max`numberparalleli
Q: how\@nessBRqcheckedIp:  part/yQleft-   f4Rsourcv@9DbeginningYoriginalCs, appliUafterjyw: ignore symx s 1hey0poig}Hside           the defined path
    hardlink_dupes: duplicat-yc files21"""ProcessPoolExecutor = Noneif ddir is not and (stripor prepen4!):Nraise ValueError(("Destination S(?P) cantbe used C"in combFUwith 	1"));=0u=8workers < 0Y
''must be greater or equal to 0'/F!= 1W# Check if thisa system where can funcy.
from concurrent.futures.p* import _cr_eb_limitZ)6try.(Pexcep_tImplemented
G5= 1Jelse&Mif maxlevelBY=Z.getrecursionc	 = _walk_dir(dir, quiet=,g=V0suce = Tru~.
T# If ?== 0, let
Bhooss5?!or+"dS(max_?=c) as e`TGresults = .map(partial(compile_W,|9=, force=CZrx=rxrlegacy=yoptimize=	>qinvalidPm_mode=P
=	>4=B^_sl_dest=H
%=)KsCmin(,Pault=1
1for1 ins!ifpfile(file, d	dir, force, rx, quiet,
 legacy, optimize, invalidation_modeEstripdir=	, prependJlimit_sl_dest==hardlink_dupes=-):success = False sreturn 

def compile_file(fullname, CNonex=F~=/=0v1|?=-1,
^4*, oi		Q% '-"""Byte-P one !.
[Arguments (only  is required):,R:  thFW to b_TU:if given,2directory ~@d inH"th:[dm.^ _dif TruP, even if timestamps are up-to-datlM output withQ or 0, errors #)no>2%aproduce  pyc paths instead of PEP 3147Kb`:  int@list-p levels -1L1 ofEVinterpreter. MultiplCPleadsmDdKPbs each:d
Q: hown!of will be checke9a:  par	GQleft-  from sourcDQj:9beginningbqriginal:.s, appliRUafterj	: ignore syms1heyQpointuoutsidefqdefined[
: duplicat.!ycs2"""!if@not a and (F9dir'ortraise ValueE=(("DestinS()P) cantbe used "C0"inbF	2"))! =,]"if[A < 2 is|8ancos.PathLike'p= os.fstQ)_P.base&'d7 = None

    if ddir is not None:
 dfile = os.path.join(/, name)
*if stripG@full0_parts = t.split(_Asep)RS55	1Tlist(k`Pfor s0, o in zip(g1,)E="==F
#.remove(vf*8+if prepen+isS7elsE	isinstance(optimize, intID = [][# Use set() to A duplicates./&Rorted)create pyc sa deterministic orderAvB = sFs)hardlink_dupes and lenV) < 2raise ValueError("H@fing of	d bytecode makes sense "w`"only more than one ation level"/rx9mo = rx.search5	Vif moreturn successif limit_sl_destn. isGi[if Path(H).resolve()"in% .parentsRRopt_cE= {}v>_\u,Zegacy>|_I]i + 'c'I ifA^ >= 0l'0opt#pt*7 1 _* 's: = (importlib.util.cache_from_source(;	sV=opt)k2'
l0? = !head, tail =)R[:-3]4U[-3:]*#if'z= '.py'!ifKforcZ$/trX@mtim!in[6sta).st_mtime)
      ,expect = struct.pack('<4sLL', importlib.util.MAGIC_NUMBER,
I0, mtime & 0xFFFF_)Afor cfile in opt_
s.values():6}with open(3, 'rb') as chandle;?actual =..read(1223if >2!= ?c_break?elsreturn successAexcept OSError+pa9if not quiet3print('Compiling {!r}...'.format(fullname)>tryMaindex,Plevelenumerate(optimize! => s[I]ok = py_c#e.,d0, dko, True   =@invalidation_mode=
[1if M > 0 and hardlink_dupes5previousR
O[[O- 1]YI0if 6tcmp.cmpn
_, shallow=FalsNPos.unM)1os.+q
;	"Pye,/er3k1 = 
d"if:_ >= 2s
lD?B*** ,X`', end=''=@# escape non-3@able#practers=msg!Pencod= sys.stdout.!orgetdefault(msg = err.msgC$e(0,ors='backslashreplace').decod,[J(msg7q(SyntaxP, UniNm_@|ror compiling {!r}...'.format(fullname))
 ]else:%print('*** ', end=''@&e.__class__.__kp__ + '::
5qif ok == 0success = Falsesreturn &

def compile_path(skip_curdir=1, maxlevels=0, force=M, quiet=0,Wdlegacy(optimize=-1,invalidation_mode=None)"""Byte- all module on sys.!.
Arguments ((wbonal):: if true,  current directory (default True	0:   recursion !401-@: as7dVdir(),L0P0
\b-
]3
"-1
9!r_z1"""U! =70forW& i-aif (nox (b== os.Q) and:>3J < 2c'Skipping^
i>dir55=
==	#
=
5%LMVmain(pScript  program.0import argparse5r =.P%%r(z1des]ion='Utilities to supZpinstall@Pythibraries.oc.add_aA('-l', ac='store_const', 	:, dest=''G3help="don't[Ae inbBies"{r', type=int||
('control theCimum5. '
'if `-l`P`-r` xons are specified,IQthen Btakes precedence.'f'd',
              )help='force rebuild even if timestamps are up to date')
B%parser.add_argument('-q', action='count', dest='quiefault=0,GK output only error messages; -qq will suppress 'N^K'theF as well.
bstore_truelegacy'
Buse + (pre-PEP3147) compiled file loca<s
d', metavar='DESTDIR', hAddirgONone('directorypprependpaths for /ink
# '-C tracebacks and in run' ';in cases where 0soui 'unavailable')	s`YSTRIPaQstripes/de}part of huQleft-eR from,(o -example _root.A`-d`q`-s` op cannot beAspecifieBgether.pppyPREPENDrt: thl0add`prefixm+/H?mak+it absoluteqn some is removedr7by pSxaREGEXPr3Askip2s matchingregular exOion;>Lregexp is search orOfullqof each considerNi-EFILE+_flistn
!('!ll s and directories listed in '
 
'FILE to the7
 considered for compilation;Nif "-", names are read from stdin'))parser.add_argument('le_dest', metavar=P|DIR'Yrgs='*',Ghelp=('zero or more file and directory #toe; if no s given, defaultsh
equivalent of -l sys.path
-j', '--workers'y/=1
type=int, D'Run0allcurrently'qinvalid_modes = [	..lower().replace('_> IB3py_W.PycInQMode](---Pchoices=sorted(;)5+('set .pyc = x;/to"checked-hash"GnSOURCE_DATE_EPOCHIpenviron. variable is set,"timestamp" otherwise.x`o', ac='append', Y='opt_levelsYqOptimizc 5r_with.D-1 which usesokQ!of;Python interpreter itself (see -O)8e,limit_sl9/@'Ign
symlinks pointing outsiteDPb?@hardCP-dupe@store_trueD_DHs duplicaRAs')
?0argd"s(.-(/.F ifQs.rx:VQimport re=trx = reE(I	f == ""Z3"[ None`ecursiGQs not#F3max=0Oelse->

    if args.opt_levels is None:
 9arg!q= [-1]
 {if len(#) == 1 and hardlink_dupesZparser.error(("H'ing of duplicated bytecode makes sense ""only for more than one optimization E."))@ddir1not(i$\strip("orlprepenGA)p"-d cansbe used in combinwith -s or -p"# if flistprovided then load itw"if+6try
>e(sys.stdin^8=='-' elseT0$op.
, encoding="utf-8")) as frB@line#compile_dests.ap`(4.5())except OSES
nquiet < 2jqprint("=@ reaa file g{}".format~Creturn Fa+xqinvalidG_modb1ivl" =
+
.replace('-', '_').upper(
4c = py_=W.PycITMode[w]O/success = Tru	P ifX$
'+if os.path.is(9J%0if ES/,VSforce1rx,F	A=olegacyA
W=MAdir=@BDUeBGBlimit_slG	J
gK
9
w1dirQ, maxgs-lH	 workers=args.workers,
  invalidation_mode=/,
J  stripdir=args.?uprependACoptimizeopt_levelsAlimit_sl_destF	Ihardlink_dupesJ
/):Xsuccess = False(sreturn #JelseQ)compile_path(legacyc, forc1Cquie2
Tf)	except KeyboardInterrupt1if _zF < 2print("\n[i<Bed]"^!YTrue


if __name__ == '__main__'g ex@tatuk@not #"()d@sys.&(!_s+>)
# This directory is a Python package.
# Copyright 2009 Brian Quinlan. All Rs Reserved5,Licensed to PSF under a Contributor Agreement.

"""Execute !uts asynchronously using threads or proes."""

__author*) '0 (b@sweetapp.com)'

from concurrfutures._base import (FIRST_COMPLETED_"  7EXCEPTION7?ALLlCancelledErrorkTimeout4I_State9bBrokenF^Owait\0as_aleted)n!llk(*'&'X	

M-
POLPool;Tu`)


decdir__(A__all__ + ('__autDhor__', '__doc__')


def __getattr__(name):
    global ProcessPoolExecutor, ThreadP
40if B_ == '9'Z^rfrom .p] importla as pe]7U( =!`return4T
t#1t!'=  "teraise AttributeError(f"module {__<__} has no *  {}")
# Copyright 2009 Brian Quinlan. All Rs Reserved.
# Licensed to PSF under a Conor Agreement.

__aut1I = 'd0 (bs@sweetapp.com)'

collectionstloggingd5imeypes

FIRST_COMPLETED'$EXCEPTION$Z'
ALLF	Z'
_AS 	$'

# Possible future states (for internal use by th's package).
PENDINGc'
RUNNU'
# T@ was cancelled\user...
CANCELL
B...and _Waiter.add_F#()VSa workerQ_AND_NOTIFI^	~BNISH$"FI'

_FUTURE_STATES = [,

	ogB
]

a_TO_DESCRI_MAP = {fs: "pending"F~v: "runn5: "34	): "finished"
}GLogger 6.
LOGGER = >B.getD("concurrs")

class UPExcep"""Base $3all-related e5Qs."""EDpassZCc_F"	KTimeoutIPopera edhe given deadlineZInvalidS_iht allowed in this`Yv(objectProvidesevent that wait() as_completed() block onginit__(self^.W%= A .Ei!()'y_futures = []

    def add_result(self, future):
 .finished_s.append(!)
.PexceptionS7cancelledS+class _AsCompletedWaiter(_"""Used by as_c,f()."""__init__;50supS
f , L%).8)73elf.lock = threading.Lock(]AwithfMd7.event.set-a>-a_Firstwait(return_when=FIRST_COMPLETED').*:(
be\(-?All-EXCEPTION and ALL@num_Hing_calls, stop_on_/Y&
4= = 
Y
T. =h
3<_decrement(v
E-= 1bif not

/w\*e#s-t"if

self.event.set()#
 Uelse:self._decrement_pending_calls()
-def add_cancelled(7, future)Rsuper().-'Ktclass _AcquireFfs(objectn"""A context manager that does an ordered aFB of J7ditions."""__init__sqs = sorted(, key=id4s__enterRI3for=@ in M.FLqR._con.G__exH*argl'preleasel_create_and_install_waiters(fs, return_when(if == _AS_COMPLETEDG  sCompletedW\!()8.elM_FIRSTO_FirstR@ount1um(yf._state not[CANCELLED_AND_NOTIFIED, FINISHED] ~,#fsMEXCEPTION/,ll	, stop_on_excepR=TrueELI?ALLG/{+IFals|s_
raise ValueError("Invalid9s: %r" %fc7$f.0.ap#( 1


yield_finished_})if_coll(@Iteron the list *fs*, WDing Zs one by!inFrreverse.fBeforeFa?2, ** is removed from itssC1and
/qeach se0ion52setF5*re"*.|pThe aim(this funcudto avoid keep3e referencAfterw2Bnd b!kator resumes Kwhile fs = fs[-1]d%,P_;,(._&(fHgwith f=<AUdel f# Careful\!to5& a.1 topopped v3>1p fs.pop
def as_completTed(fs, timeout=None):
    """An iterator over the given futures that yields each as it completes.

MBArgsWfs: The sequence of FQ(possibly created by different Executors) toQe.pmaximum numbervseconds to wait. If ,n%reLfs no limit o!9A.gReturnGt0N ass$y ? (finished orcancelled)3anyGre duplicAy will be r%edODonceGaiseT`Error:entire result!could note0gen8f=`before1"""!ifNPout int>@end_9% =(+
.monotonic()fs = set(fs)\dtotal_U= lenwith _AcquireKzURf for f in fsif f._state"[CANCELLED_AND_NOTIFIED, FINISHED]]pending = fs - cber = _5_and_install_s_AS_COMPLETED`Mu = listr6tryq from __=S>,5er,ref_collect=)7cwhile 	
1
 $6W=R	Oelse6z-pe!ift>< 0`1rt j($'%d (of %d)$unO' % @G9), ps5er.event.
(-? ~er.lock! =4er.?
P(_ = []-Tclear# reverseCkeepK\Forded.v.5(Hdgfinall# Removeb2res
        for f in fs:
 with f._condition*f._waiters.remove()

DoneAndNot
Futures = collecOs.namedtuple(z'/
9', 'done not_	p')
def o(fs, timeout=None, return_when=ALL_COMPLETED)"""Wait Sthe f0in 
given sequence to complete.
7Arg-vfs: The14of (possibly created by different Executors) to[We upon.mmaximum number of ses=R. If 1the%reLcis no limit o!PLvL: Indicates \ this funs should}.!op	wBare:GVFIRSTA - Re3any finishes or isVH
cancelled!mEXCEPTIONmby raising anuAexce$noAees an "Jit is equival19to 
	J -  I#llsJHGare +!A 1 2-o"tsfirst set,&', containsUXlEthatX0d (Jd) beforeEJd	.%un8Ja. Dupl)to *fs* -d and will be J.ed only once1"""$fqset(fs)f_Acquire61Q = {f< ifPstate[CANCELLED_AND_NOTIFIED, FINISHED]}F) = fs - tBif (RB == EW
56 (/,5/elq)qwif any(+f_ if{5 f.i(U%f. ()~1notH<@aif len)M
+fs_[#ber = _o_and_install(fs, return_when)

    waiter.event.
(timeout)for f in fs:4ith f._condition0f._Iers.remove(rdone.updat.finished_futures|return DoneAndNot
F"(Fp, fs - )

class  (object)$"""Represents the result of an asynchronous computaB."""%def __init__(selfY"""Initialize^. Should not be called by cli`CVR = threading.Ch(0state = PENDINGNk= NonePexcep ks = []:o_Cback"#&finvoke /Q=X
T:tryC_$ E=rLOGGER.)Uion('1ing P%r', Nreprw,
!ifL#._= FINISHED(,$(r,'<%s at %#x ^=%s raised %s>' % (-<_H__.__name__,1"id"_STATE_TO_DESCRIPTION_MAP[m]@&-._Oelse% A'$+!

jbcancelkA"""Cs if possible.R`s True#1Bwas `	led, False otherwise. A )5canif it is runn=or has alyTeleted.G[2in [RUNNING,<]U

            if
 self._state in [CANCELLED, _AND_NOTIFIED]:
 return True
]=P$condition.notify_all()NJinvoke_callbacks()K
def cancelled(@)F"""R if the future was:E."""eCwith2UoVrunningis currently executing/== RUNNINGOdoneoP or finished9, FINISHED]__get_result#ifPexcep
:tryLaise8D"ofinall;# Break a reference cycle {h	ei u = NoneJelse		@add_v$J, fnPAttaches a able that will bexed whenn
"s.sJArgsQfn: ABXDthisas its only^argumentcompletesVBB. Th
Qgalwaysby a threadsame process]whichO!itadded. IO`has alT$y dMbeenJtyimmediatelys44;Bs areRorderthey were M~0not2
G.s.append(fnQ,
!fn9/ E2rLOGGER.%Uion('1ing for %r',M#, timeout=
w e call that 
the future represents.

 UArgs:timeout: The number of seconds to wait for ]result ifk	PTisn't done. If None,0nre is no limit oekReturnocall that^
[RaisePCancelledError:d was c".T970didfinish executing beforeYgivenQ::outjExceptionrdMCDat e( will be #N5"""s:try
with self._ir/i$state in [CANCELLED, _AND_NOTIFIED]iG -()r+elt== FINISHEDY9R_get_2&()
.(/OelseD^ kfinall@# Break a reference cycle ZV#in	! =:6def(#, =`)2""":5
1 byC64.7	m7$
OGd2 orVcompleted1out{8ing_=l-*4%
 elif self._state == FINISHED:
 return self._exception
(Pcondi.wait(timeout)+#ifK{in [CANCELLED, _AND_NOTIFIED]aise CancelledError()+ell!
OelseT8# The following methods should only be used by Executors and in tests.
 de7t_running_or_notify_c()"""Mark tuture as > or procesk"y C Q0ica&s.S implement:Dunit(Ifhas beenRled (() was caO%edKPTrue)Nn any threads xj on" f cotq(though\sNcto as_'@ed()"Ls()) are!edFalse is ,
7notpthen it>1put%he(talls to'3ill 3
ZCThis!be
|
ebeforeeJZwork associated with tk!. {yKP82be q'eddRs\JibFRAled,) otherwiseQLP0Run!: XY als= or%set_result0or  C'5"""oQ%._]
C
)[Jf/ =l|11forX erC+er3-C.add2led
\#.py_all() ne ar.FcausoH() triggers ae5 >	=PENDINGX
yRUNNINGOl	WLOGGER.critical(' %spunexpecui: %s',Wsid(self),
        self._state)
%raise RuntimeError('Future in unexpected @1')
Bdef set_result(b", 
!):"h"""Sets the return value of work associa_Awith)f}.hF0Should only be used by Executor implementations and unit tests.np._condi:vi8{CANCELLED, _AND_NOTIFIFINISHED}MQiInvalidSn{}: {!r}'.formaN , ).{# =wl"4 = 	#for waiter1sC.addwN.notify_all()hinvoke_callbacks(VPexcepg%, \VjA as beingUVgivenH^s& =7	AdB}>g*__class_getitem__ = 
method(types.GenericAlias)

!us(object"""This i} abstract baseY nconcrete asynchronous eRs."""]Bubmi, fn, /, *args, **kw
}i1@s a Wpable to0a1ed !
@argu6s
rcheduleIlas fn(xs)%a Lstance represent4ionwR=A\
SH.^+DNotI;"ed1map**V0s, *out=None, chunksize=1A an =equivalentc);ArgWfn: Ahat will take as many arguments as there are
 passed iterables.")timeout: The maximum number of seconds to wait. If None,qnris no limit o%= l
~chunksize
vBthe b will be broken intobefore being 	to a child process. ThisC is onlyNu;Bby P7PoolExecutor; it8ignored b>hThread5%.
cReturns:"Antor equivalent to: map(func, *Q) but$calls ma
be evaluated out-of-orderKaiseT`Error:entire resultcould notPgenern	IQgivenIout.*Exceptionvfn(*args) r for any 5"""G$if[
g@end_% =,+
.monotonic()fs = [self.submit(fn, rgs in zip(]C# Yield mus)Ahidd closure so tha`future"e r5ted'# MGfirsr?6red`3def_AZtor():try# reversekeep finishaM.3fs.3-(){while fr7# CarefulR1to qa referencErpopped *
eK
	$yfs.pop().0Nelse&Jq-g
"ofinallgi?"w.cancelrmshutdown(,=True, *, P_^ws=False;"""Clean-uppresourcPssociQ withAIJ1saf  tmethod s!al;@s. OPwise,ho2sKed afterS7oney;Arg}$n ROuntil all running
2S have7Aed eC@0andd2r.thexecutor have been reclaimed.
 cancel_futures: If True then shutdown will + all pendingJUG2. FP that are completed or runningWmnot beKnl5"""'Qpass
def __enter__(self):preturn 	.3xit-, exc_type
2val	'tbHA.`(wait=')iFalse


class BrokenExecutor(RuntimeError\Raised wv3a e2" has become non-functional after a severe failureU# Copyright 2009 Brian Quinlan. All Rs Reservip# Licento PSF undgpContrib Agreement.

"""Is ProcessPool.

The follow	diagram and text describs data-flow through system:

|=R In-p} "|== Out-of(U|

+-+0  
"-31+
|E|  => | Work Ids 0| CSQ5|H+ |P -}#  G	#0|  !PP| ...{H	"kac  6;?5, call() | 5| 7	X	
!
L .(t| Local@LP.
#er"	|  #1..n P).oThread"Pk"- -"! #1| <P Item  <=Result Q'<=o0D| 6:^JG! P2   	b| 4, rK PpP3>ept
------+     &+-V+    J+

Executor.submit() called:
- creates a uniquely numbered _WorkItem and adds it to the " Items" dict
- #the id of'D
8ds" queue

Local worker threas ids fromR"yA looks up"corresponding
  1
D2: i  ihas been cance0]0n
 is simply removed\, otherwise.repackaged as a
  _Call`put inb  " Q". New'os are (
  until9 is full. NOTE:UDsizea(kept small because
 s placed no longer be with Future.6b().
- p_Result" Q", upd?fC@ sto.
 s@dele9| entry

Process #1..n^e'!es0"!s,a2putrT	6in 
"""

__author__ = 'Brian Quinlan (b@sweetapp.com)'

import os
concurrent.#s "T_base/Ebmultip0ingk$mp*.connectionq ZuQh
rweakrefIfunctool<tpartialAiter 4systraceback


_gs_wakeups = h.WeakKeyDiary()
_global_shutdown = False


class _T]WN :
(def __init__(self)._closedLSBer,  wr = mp.Pipe(duplex=%)
qSncif notJ"dr` = Tru.'!()s [!"d$.send_bytes(b""?ear\ZwhileWpoll(Crecv@)


_python_exY/ 7q\list(."(){cfor _,Q%#rprotected by EPool_lock
        thread_wakeup.
()
    for t, _ in items:t.join()

# Register0`_python_exit()` to be called just before Aing all
# non-daemons. This is used instead of `at^#.ryg4for
# compatibility with subinterpreters, which no longer support d~
# See bpo-39812context.
6Ting.__( Controls how many ms than processes will0Aqueu2 th> .
# A smOr number50mea;'atNRspendntime idle waitx2@workle a lar	W ake Future.cancel() succeed less frequently
# (+s3
` canno
 ce0).
EXTRA_QUEUED_CALLS = 1


# On Windows, WaitForMultipleObject!toMto finish6 Itx'on, at most, 63 oOr0eresan overhr4two%Q:
# -bresult Ee  O_MAX_WINDOWS_WORKER`63 - 2@Hack1embed stringificationremote traceb-in local

class _R,T+`(ExcepI)def __init__(self, tb.tb = tb13str0,sreturn 3sEWith;exc.format_e(type(exc), =<"''"tbPexc =505\n"""\n%s"""' %oreduce_rebuild!, Y.`1)

I'exc.__cause__ =v5excrWorkItem(q
f0, frgs, kwargs2((2 = 	
. fnnF0 = 
a# =jRH1_idr=None, 
43 = 

MV
#]# =fOCalln
p,_SafeQueue(Queue):
    """Safe Q set exception to the future object linkeda job"""H:def __init__(self, max_size=0, *, ctx, pending_work_items, shutdown_lock,Nthread_wakeupf.Q/ =fV5	r* =
+	}9 = +uuper().a=ctx)
-'@on_qo_feeder_error5 e,i
if isinstance(obj, _CallItem' tbraceback.format_(type(e), e, e.__t+1__)Ecause__ = _RemoteT.('\n"""\n{}"""'h(''.join(tb))Ok?elf@.pop.,{d, NoneGNith $	.=(Q"# ntem can bev if another process terminated. In this2q# case,0executor_manager_ fails allwEwrBrokenPzIPoolj&if?q is not.8.se^Jelse@s1


get_chunks(*iterables, 'izl  Ites over zip()ed 53 in7.Ait =*\while TrutPuple(Xtools.islicG7!ifI>

areturn)Ryield$3(fnbC""" Bes a;  ocR passUBmap.+ARunsPAfunc	&X() onP1theUUThis Q`is runta separate [fn(*args) for 
?8]@send_result(,2d, =,v<0ly S TSgiven@6 or=6tryhq.put(_RB(%-,J
[=
e BaseEP7as 0exc]FWithd	
0ion))


def _process_worker(call_queue, resultinitializer, 
	args):
    """Evaluates Cas from@ and places the\Cs in'!.
PRThis p is run)a separate process/BArgsN: A ctx.Q of _CallItemat will b ad}DeAd by.% kR>muwrittenDi/tobgtaqallable, or NoneS52PtupleA for"?61"""(ifZz1not]^6try
M (*
k)Pexcept BaseE:ionA_base.LOGGER.critical('.X:', exc_info=Truelp# The parennotice that<~ stoppeb# mark+ool brokRretur`while gitem =.get(block"if&2+isqWake up  managemethreado.p.put(os|Zpid()-9
rU.fn(*.7, * kwbV as e*vuexc = _WithTraceback(e, e.__t&__a>P_send*_(,Y.1_id=eption=excM;els[|&=rVRdel ra# Libe
Pource@soonpossible, to avoid holding onto# open filesshared memor$atAneedFymor,


classqecutorMh!rTd(kBing.(Ue communicac between tz$ererblocal "expreferenoP3SPoolE(EownsRg A weakref-4ownas well aIsinternal objects usedbrospec st+of$e .	`def __"p__(self	# Store es to necessary internals of the executor.

 # A _ThreadWakeup to allow waking he queue_manager_t2P fromZORmain Q and avoid deadlocks caused by permanently "ede%s.ORself.l"_w=_+
Fshutdown_k F	
weakref.refDProcessPoolEO that owns thiOe. Used#Adetermine iN	has been garbage collectM[w can exit.v@When -^ gets\,% callbackI@wille |Rment 2 so!it7ateLre is no pendkwork itemCdef e_cb(_,F}=99	9	)):smp.util.debug(': triggerHY for'H0' Q`M_gIup')2Ywith 
J	.3&()
_reference =e(!,7_cbE4DlistWCctx. instances 0as ,erpG)esma Ybe filled _CallItems derivedAr# _Work"Cfor k!by_	bSimpleof _Resultrgenerat
~r;
.~ ids e.g.n([5, 6, ...])s$/O_idss
odict mappR#m(tox{U{5: <~...>, 6E...}:4_k_4JSsuper().__init__!l@run(`0# M@loop,"rYwhile True]Q.add_:2_tof$, is_broken,C1 = KRwait_*_broken_or_wakeup()

 if is_broken:%self.terminate'}(cause)-ireturnif result_item is not Nonelprocess_6(u# Delete reference touto avoid keeping*s# while wait+con newO-s.03del
[Qpattemptincrement idle m count[executor = _(4if (m* ._
_worker_semaphore.releaseg>
"ifpis_shutE_down()Tflag_L4
\@# Si0no  [s can be added, it1saf
e# this thread if there are no pendf!if0Js-Fjoininternalsn3r\0defQ_callg_to_queue(Zj`# Fill"ll" with _WorkItems from0# T#afunctiver block7;Tru_.full>tryB4_idsQ.get(L=Falrexcept OEmpt_;elsy[$.d]2if tem.future.set_running_or_notify_cance2.^put(_Call(c!d,8/;n@+OargsB+ kwD)E$P	)continueA]wd	Wait for aN.0be @y incheckingaat all^er processes are still running, or for a wake up
 # signal send. The#s come either from new tasks beingLubmitted,*the executor- shutdown/gc-(U8theI&@ of Epython interpreter..result_reader = self.cqueue.2assert not- th=_up._closed.D`3@%er3Ss = [,]#upM]1worker_sentinel:$p.p in list(processes.values())Ony = mp.connection.wait(lers + t%)
cause = Nonis_broken = TruMitem4#f x
%y:l+tr9W=er.recv()D3FFalsexcept BaseEion as e+traceback.format_Dion(type(e), e, e.__+'__JJelifBwithsZ_lock
gclear(dreturnY%, x!, Cdef b_z/{,A)2# Preceived a/bis can bU0PIDa# that exited gPfullyAa _RBItemif isinstance(,@-u# Clean{using its PID7(avoids mark&(
u0is_Pting_
pfhes.pop
[kp.joinE&ifH?__fKnalsR/C;els>6# R1 so,`future|completedg_r
0end.
.!d,
!MQ|q if ano# terminan(see aboveN2orkO!isgO]i.=*	. 8.seqJ         elsOe:
 
work_item.future.set_result(!)
Edef is_shutting_down(self)e# Check whether we should start = = the executor.d0 = ^._reference()-# No more  s can be added if  - The interpreter is'OR`2 that owns thisxer has been collected G**%return (_global"5 orFENoneQ$.:w_threadterminate_brokey, causeT)	1 be+0 itRin a I1te.|## argumentused to displayinformation onvArrorMBleadYoSoming.a# Mark3process pool)1 sob submits fail right now)if@not R. = ('A child 5d '>'abruptly,0is Eusable anyx'sej = Tru-! =All pendtasks arebe markedqed withfollowing1# BPPe5"^bpe =&5("AbimqUwas "E"zb while{ L@runn
$or&."{"ifvNabpe.__{__ = _RemoteTraceback(f"\n'''\n{''.join(>c)}'''"4A*5ed.X1for-C_id,	btem in@_~!s.(xo PexcepF(bpe0# Delete ?sHobject. See issue16284:6deliclear(%Qremaiers forcibly:`queuesUtheirm# locks mayQRdirtyP` and b#Pever.
        for p in self.processes.values():
 p.terminate()
# clean up resourcesYjoin_executor_internalsEdef flag#shutting_down(D# Flag the TD as 4 4 and cancel remaining tasks if# requestedCPearly	possible if it is not gc-ed yet.A=C_referenc*C4if  SJNonee" .__thread = True{V2# C@pendwork item6"._%_A_futures5kCall . .ndupdate__	Kto only haveEthat are currently run
C5newj] = {}oBfor $#d,	6tem;.w!if
RBtem..I6:[JFd] =
.w? = V
As# Draincds_queue since we no longer need toB3add]!toc
IQwhileM?try.get_nowait()5rexcept OEmpta]breakF# Make surd"iso)"toaste time loopingK$on ZQ over/	5Oes = False~9&. 0Z2.inrange(d< - CG85.pu
q] += 1	OFull`break

    def join_executor_internals(self):
 .shutdown_workers() # Release the queue's resources as soonpossible.=]Qcall_9g.close] jgthread&Qwith +Flock ;}_wakeupn`# If .d() is not Qed oncreated processesn# some ctx.Q	 methods may deadLMac OS X
for p in`.values(p
{	def get_n_children_alive`# Thisan upper bounnumber of H Hreturn sum(p.isg/) 
)


_system_limits_checked = FalsepNone


.
Bzglobal 1:ed,!ed1*if3#&edraise NotImplementedError("ed*	oq = True6trybimport multiing.synchroniz4except I.~C	rP(h"Python build lacksu	, usually due "Pto named semaphores being unavailabletplatform.F*]	;nsems_max = os.sysconf("SC_SEM_NSEMS_MAX"oC(AttributeG0, Vx{## O`r sett4!87if F= -1# indetermined *p, assum_"at'V6U# by | memory only#h>= 256minimum eY# accordto POSIXv"T0vidShoo fewH6(%d(",0 nevary)" %m[{ain_from_iter_of_lists(%"""Specialized i!Pation^5tools.chain.\mEach item*1x* should be a ". Afunc_!iswqcareful	to keep references to yielded objects.
    """	for element in iterable:).reverse()Twhile=15Tyield.pop()


class BrokenProcessPool(_base.Executor)QRaised when a p='a J= terminated abruptlya future wasDthe running state.-|et def __init__(self, max_workers=None, mp_contexto8Arializer# sargs=()k-r"""Init+s a newinstance.
mBArgsfJP: Theimum number of{es that can be u%to[Me e bgiven calls. If  or not tRs manCB@will|2crechine has-#orL: A multiS to launch}s. This\p shouldxvide SimpleQueue, D andfr([  fCeI)FPtuple@argusp!to.Wr_check_system_limits  if&1 is
X'._^ = os.cpu_count()	1Vif sys.platform == 'win32'\`
min(_MAX_WINDOWS_WORKERS,f>
V7els#AN<= 0r ValueError("@mustgraFn 0"vhoelif (^
c/> Pc

W&fO<= {g6}")}?
a( =L-]3cETp.getdrL=	pq
()HD4Typ+ a/=r( %

        # Management thread
 self._executor_manager_& = None
.# Map of pids to processes#QX = {}AShutdown is a two-stepI.Hs._False&clock =ing.Lock()/idle_worker_semaphore7S,(0=broken = queue_count = 0xqpending{b_items ;tcancel_-`future*qTA# _TbWakeupPcommunication channel usedinterrupge waitNof the main loofrom anothernV (e.g# when calling I.submit or). We do not_result_dbsend wasignaloNas it could Y in a deadFRif a % dies with
awrite Estill acquired#_s_3bmust b@ acc
K5_=>(()Create ;@s foe@Make
 slightly larg!an$anumber<47 toNBprevex1es q idL. But don't mit too bigNbecause ?i0cani2be rl@_sizc1max	ers + EXTRA_QUEUED_CALLS}/j= _SafeQ('Te=pb, ctx=Dmp_context,7I1
9	k4	
/E/j.# Killed0canRduce spurious "XUpipe"# tracebacks+0's Dewe detect kLanyway, so silencm`._ignore_el = TruQc.Simpl
,_X=.1def _start(G%):if self._executor_manager_thread is None:
 
# Start the processes so thair sentinels are known.Eself._execuxC= _EMT(7)I .s(2s_wakeups[UY] = \r3
Y
6def _adjust_.b_count[@# ifTre's an idl`, we don't need to spawn a new one^2if A_worker_semaphore.acquire(blocking=False)breturn	a = len.&esd$if# <3maxso4p =#p_context.P[(Fttarget={S,(Sargs=call_queue(X4oresult*initializerS))"r/p.oes[p.pidpNRsubmi?, fn, /, *b`, **kw
Cwith]shutdown_
5jbrokenqraise BCPool_6
SwU\RuntimeError('cannot schedulefutures after W'w_global_"r5'c'interpre	<f = _base.FwWorkItem(f#, {6aendingT_itemKw<'r_ids.puZ.6
b2UY += 1U# Wake up ' W0men Z	.QM./()_sv! ft.__doc__. 1map#*iterables, @out=`, chunksize=1A"""R=tor equivalN o c\").{;Argg`fn: A  will take as many arguments as there are
 passed iterables.")timeout: The maximum number of seconds to wait. If None,qnris no limit o%= l
~chunksize:Ygreater than e will be chopp9ntoS iz,b and submittedthe process poolLIt,Bms iElist0sence at aReturns:_"Antor equivalDto: map(func, *P) butsP callyObe evaluaout-of-order.
([RaiseTQErrorentire resultcould notPgenern_abeforeQgiven:outcExceptionvfn(*args) rP for 5"""q2if :< 1aIa Value&("-1musv>= 1.")#s = super().partial(_2_Je, fn),B_get/&s(,=LLCCout=){ra _chain_from_9@_of_#s(def shutdown(self,=True, *, cancel_futures=False)bPwith 8$._GV_lock"!KtpendingS+ =d:[thread = 	)ilf._executor_manager_4_wakeup t
n# Wake up queuC` F	s2t.{(s7
y
z
f.join(# To reduc@riskopening tooPfiles, remove reference# objectqpat use 7 descriptor`
! =Z-_ 7%,
5g.close"{#e
S5.__doc__ = _base.E."
# Copyright 2009 Brian Quinlan. All Rights Reserved.
# Licensed to PSF under a Contributor Agreement.

"""Implements ThreadPoolExecutor."""

__author__ = 'B0 (b'@sweetapp.com)'

from concurrent.futures import _base

itertoolsEqueut4ingEtype+tweakrefbos


_3!s_HCs = &.WeakKeyDictionary()
_shutdown = FalseGock that ens
(new workers are not created while the interpreter is
# aPting f. Must be hel7Amuta"Eand .
_global _l"= ing.Lock()

def _python_exit():
    AT_with \59tq = True9@item`[list(.1())*for t, q in Zq.put(None+`t.joinp# Regisd[``be called jrPfore Aall
# non-daemonDs. This is uHinstead of `atJ#.ry	()` for
# compatibility N7sub s, ch no longer sup
~
# See bpo-39812bHftext.
__(p)

# At<k, reinitializ`!` Mi
e child process
if hasattr(os, '}c_fork'^%os1_at0(bex=t.acquire,$gafter_in_Fl_N paOrelease)


class _WorkItem(objectd_]__(self, , fn, args, kw2)# =1*fnF! =U
a# =j
1run|!iff.set_running_or_notify_cancel5breturnb6tryresult = b1n(*	2, *
4except BaseEion as exc]Ka9vion(excPT
# Break a reference cycle>a 'exc'6;j0 = Oelse()&!__B@_get_Aqmethod(.GenericAliasvdef _worker(executor_reference, work_queue, initializer
args):
    if is not None $6try
Q (*
QPexcept BaseE:ionA_base.LOGGER.critical('.8 in:', exc_info=True)lpR = ex(,%if$QJ ._?{_failedTareturn	+`while 
gitem =.get(block"if*6]K.run # Delete -s to object. See issue1628466del
# attemptSincrement idle count2g -] .__semaphore.release7
continue/# Exit if#   - The interpretershutting down OR6that owns theer has been collectedJ..Dif _9 orjS.*
a# Flag0as [
as early as possiblee#Kgc-ed yettY$	! =	W# Notice others'P.put(-
Lrh
|x.err


class BrokenThreadPool(UE^1"""Raised when a! tC&a OB kAing.MU8G"):0# Uto assign uniqueRnames_t_prefix>supplied_er = itertools.().__next__}Qdef _H__(self, max_j s=,xA='',zer=None, initargs=()):
 #"""Initializes a new ThreadPoolExecutor instance.
;FArgsIPmax_workers: The maximum number of t[s that can be used toYKe}e the given calls.)Q_name_prefix: An optional  1 toHD our
MiAr: Ao5abl   GkDPtuplearguments1pasUr5""" ifIZ is None{#ts oftenb3* CPU bound task which releases GILx# * I/O2(3,zcourse)?
! WY
 cpu_count + 4 for both type# But we limit itT 32avoid consuming surprisingly large resourceon many corVchine = min(32, (os.() or 1)J<= 0raise ValueError("l@must)`greatefan 0")'ifr#1not'P and 
<(p	4Typ+ ahself._=k(=_queue = .SimpleQ(9/idle_semaph=vTing.S,(06}s = setTbroken = Falsqshutdow
h_lock MLockkO = (%or(.("r-%d" % N\er())=3yB( %mdef submit(*, fn, /, *#`, **kw
YCwithW8, _global_
#if;
 B"._5'2SwUcRuntim@'canFschedule (Pfutur6fP'upk5'b'interpreter shutdown')

 f = _base.Future()w	WorkItem(f, fn, args, kwOself._work_queue.put(wT$adjust_thread_count|return fsubmit.__doc__Executor. _def _h!):X# if idle s are available, don't spin new&@0if R ._D
_semaphore.acquire(timeout=0tx# When the e gets lost,weakref callback will wake up#,Torker.H_cb(_, q=qGNone3nums = len(FE8if ,<.1max*6ersA_name = '%s_%d' % `_prefix orT,G.3t =/Qing.T(=, target=u)#=(tA.ref#, O_cb)F b9initializer: )4\.star	
j.add(t7:'ms[t] =_q_failedDCwithB@shutZ_lock\broken = ('A b bs pool 'a
'is not us7 anymore'# Drain l $ and mark pending fs	twhile True>tryl__itemd.get_nowai:bexcept_.EmptbYbreak>!if{E.R.set_Qion(BAPool"._),s! , =1, *, cancel_bs=FalseE$h! =	ij	a@ork as from,t)irlj# associated?.
                while True:
 ?try,work_item = self._queue.get_nowait()[rexcept .OEmptj_breakF1if uis not Non	.future.cancel()
a# Send a wake-up to prevent threads calling8p(block=d) from permanently Iing.E
N@put(K:aitfor t in
$ct.joinshutdown.__doc__ = _base.Executor."
"""Configuration fGparser.

A cconsists of sec7s, lead by a "[]" header,
and followe&"name: value" entries, withsAtinu s :such in
the style{RFC 822.

I?nsic defaultn be specifitpassing them into

P{structor as a diary.

class:
3p-- resp@ble ?ia list ofZ!s,Pmanag@Lqed data`methodJ__init__(=b,s_type=__0, aA_no_z=False,delimiters=('=', ':'), comment_prefixe#;;')A}inline_1astrictL8eA_<Bs_ins)_`='DEFAULT'DinterpolC=Anver)R`Create tr. When `;s' is given, it
vvializedPjionary or)ri. The keys mustqtrings,s$approprilP%()s N nge.*1ict@will~@usedc	qobjects	!opDin a#P.fs	!as; seuB subFthat divid{k
tz z6Es 2. C^Hindentedn `inline_co*mment_prefixes' is given, it will be used as the set of
 substring2at J1 coYs in non-empty lines.
=`When `@0ct`{QTrue,gparser won't allow for any section or op
P&duplicates while reading from a single source (file, Vng orGiaary). Default
__in_valuHFalse (dA : ), each 6v@markEe end of an. Otherwise, internalCspa multi? are kept0pard
m2_no#),_s withoutXswaccepted;q#asentedPthese^MNone=_@name+uspecial%is'pd accorsly. By \is called ``"DEFAULT"`` but thnNbe customized to point	oe valid. Its curren+@ cangretrieved u3"``
_instance.%``attribute and mayU`modifit runtimfT@polaNdit shouldJ@an I}) subclash/ I=qhandlero*%uepre-procesw!
getters. RawConfigP#objects d+%doL"so	, whereas I@usesuVYBasic
. The library also providE ``zc.buildbotinspired ExtendedT` imple
`conver% dq5keyPrepreoEua type eFa'6ablh@sw`!to1des@dataof. Ever>ter gets i4orrespon*() method onV$ 9%xi}5s())`ReturnkRcc!ur	s, sans '4has(^
\1whe&aXTexistKJkR9 Q~
m.

    options(section)
 	Return list of configura&0 ops for the named D!.
Eread(files, encoding=Nonehad and parseNiterablex=d~Us, given byn,.  A single ( is also allowed.  Non-existing(sFare ignor)successfully =_v1(f,~?oneAas aI object.'Thdefaults to f.u@; itonly used in errorBmessages (if f has no `>' attribute,0str)p`'YT)#(
=cfrom a0IPdict(oionaryK.p. Keys %s,Rvalue"7ies with k=3nd &that should be presentL"in<A. If ]Sy typ<rves order,.y nd?"ir@willu2add86. Vautomaticallconverted`sa4get,, raw=False, vars, fallback=_UNSET"a [+
 ll % interpol=|CSexpanJrw@, baoh0pas@into2MconstructorSQtDEFAULTo0ddial substitus may beNPproviuPi  `!' argument, which mustFwhosMcontents override anyQH`Cla5 in* T-insPLike @`), butfQto an6gerzOfloa|R jy|booleanA l (currently cainsensitively defined as 0fxqno, offFv1, trueqyes, on(True).  !s 8@ or 
Titemsse, vars=NonCe)
 4If section is given, return a list of tuples with (name, value) forLreach opMTn the\. Otherwise^L(_n`proxy)v n
, including DEFAULTSECT.
Psremove_,ZR E fil and all itssXW,%_1W fromu\eLSafe:Raw	B	^\Basic "Extended	LkLegacy"# "PbConvertery)",F.
MAX_INTERPOLATION_DEPTH"]

_1_dict = 
?C = "?"

I = 10



# exceS classes
 z$(E!):r"""Base, gM0s."
def __init__(self, msg=''S$.message = n.E)bCreprbZa5Q__stro"__;#


~(
S"""Raised when no matches a requested
_%'Nj: %r' % )QS$ =Lfargs =? )


class DuplicateSectionError(
):
    """Raised when a s* is repeated in an input source.
>Possible+ tics that rU this excep are: multiple creaJusing the API ortstrict parsersfound moreuan onceN R#le`file, R ng_!diAary.22"""def __init__(self,,=None, lineno
LPmsg = [repr(K), " already exists"]u1#ifWr@not ^pmessageXA"Whio ad0pfrom ","r()[<#if_'c.append(" [ {0:2d}]".format(Eno))<:1/ ")0exte;msg <cKelsesg.insert(0, "n."".join(xy.$ =~	
# =h
targs = C>)


class DuO+!by
1n o<Current implement	Conlyf
az2?uD
7$in1!),&@.<m7==h"NoA reques^IP was U.	1l.__init__(self, "No option %r in sec: %r" %
 (4,/%))*Rself.# =\
c$ =>
}args = c


class InterpolaaError(!):I"""Base - fo1-related exceas."""
<def __init__(,S, msgjz.4#P"GAMissingO(6"""A string substituZ required a sett which was not availableArawval, reference-0msg"Bad value:W {!r}contains "|S   "an i6B key5it$idf_name.N0Raw)1ue:D".format", (FEzWC& =O
#O)LoSyntaxE
Raised when the source text invalid sU.vCurrent implement  rQfs this`Aintos are made doe0con1 to7r_Depth0nestoo deeplyC!8`RecursQlimit8@eded-P
7P|F0can.b{} steps. R"d	MAX_INTERPOLATION_DEPTH,CJ/  Dh]0ParB8"""DaoRfigur7filfollow legalN=None, filename=None):
 0# Exactly one of `source'/`filename' arguments has to be given.H0kept for compatibility.-4if ]R and sraise ValueError("Cannot specify both uI5. "mM
E"Use5.").Pelif g	Required4fV6pl
q% =,.__init__(self, 'S contains parsing e?s: %r' %l=.k	i@Z = []args = (5A, )
 @property&de}"""Deprecated, u"warnings.	(Wd"The 'A' attribute will
removed in future versions. ''' instead.",rBionW, stacklevel=2-dqreturn N^*q.setter;
10, v8
rg/."92" =:%aappendT, lineno*A.0(++message += '\n\t[- %2d]: %s@
?


class MismSectionHeader"(P
@"""Rd when a key- pair is found before any sZ! h[/
V@HQ
V'FileW+no@s.\nsbsa: %d\np	\('S'#.Cno =b
r


# Us(:Aer g@indi the default behaviourpic
# op< it<qan exce&P. Creenable `' as
# aid fallbackue.
_UNSET = object()
Interpolation:
    """Dumbmy interpolation that passes the value through with no changes."""

    def before_get(self, parser, section, optU,5qaults):D    returnv
dZ/seZP_read(Q_writeR+
class BasicI(9""" as implemented i!e Tic ConfigPa._3Theu"s can contain format strings which refer to other7!in4Vsame #Stspecial*pFor exa:something: %(dir)s/whatever%would resolv3e ")"v of dir.  AllAence%expansions are done late, on demand. If a user needs]puse a b4#% aDRfigurXfile, she`escape it by 6ing %%. OSb% usag isJtsidered{error and rai`pSyntaxE%%'._KEYCRE = re.compile(r"%\(([^)]+)\)s")Ov*aL = []^Velf._r e_()o "L,V;1def,E, 1)O.''.join(L3 Btmp_+=.replace('%%', '') # d percent signsDa.|.sub('', !Lqvalid sCaif '%''L  VB("inJ`XIu%r at "cF
Q"posiq%d" % (.find('%')),B
`accum,tOmap,Sdepthrawval = N.zraw=True, fallback=rest1if Y > MAX_INTERPOLATION_DEPTH	~D
oQwhile
Wp"stm6"%"3if p < 05K.append(    return
      if p > 0:
accum.append(rest[:p])'0 = I[p:] # p is no longer used"c;:1:2<if c == "%"?"%"2%el](]m = self._KEYCRE.matchh@if mNNoneNraise InterpolationSyntaxError(opQ, sec		@h"bad iG
 variable reference %r" %var = parser.xxform(m.group(1)5 m.)O?tryv = map[var6except KeyB@MissingO;;(7` rawval,=p) from 
@ if{_ in v#re_some(_$, xGM, v,b
;, depth + 1?elswxv:6i%"'%%' must be followed by or '(', "=cfound:,))


class Extended`()"""Advancedziant ofR, supports the s1 by`zc.buildout'. EnsF betweenas."""
?SQ.compile(r"\$\{([^}]+)\}"),def before_get(p,Pvalue,cfaults`VL = [}H/._L"S2 de\,return ''.join(LsAtmp_1 = .replace('$$', '') # escaped dollar signsfCKsub('', !KSvalidC`if '$',K`2Vz2"inJ_3ionXI_%r atRP"posi
0 %d(.find('$'),A	some(self, parser, option, accum, rest, secomap,
 udepth):"rawval = p^U.get(Ljraw=True, fallback=v)F1if Y > MAX_INTERPOLATION_DEPTHrraise InterpolaDdError(woQwhile
W1p =.find("$"3vif p < 05K.append(ereturnP>PJ[:p]AjI[p:]]# p is no longer used"c;:1:2<if c == "$"
$2%el]{]m = self._KEYCRE.matchS@if mNNone(oSyntax)	@h"bad ioq variabGference %r" %Apath = m.group(1).split(':'- m.T)G/
Sopt =
?try2pif len()1'atQxform=/[06v
jap[opty&	2/[0PT1F$, r?els
4n-

"More than one ':' found:^.,)except (Key0R, NoS(OMwMissing<(tval, ":".joip) from 
K if_ in vFrre_some(2, vu#		CdictMa.items">)OO + 1
r        accum.append(v)
 Yelse:raise InterpolationSyntaxError(04 op'Q, sec	%
"'$' must be followed by or '{', ";found: %r" % (rest,))


class Legacy()"""Deprecated i1 us old versions of ConfigParser.Use Basicc or Extendedinstead."""
A_KEYCRE = re.compile(r"%\(([^)]*)\)s|.").def before_get(self, pq value, varsrawval = depth = MAX_INTERPOLATION_DEPTH(awhile .:8# Loop through this until it's doneL<JY -= 1"if and "%(" in;replace = functools.partial#).__0,qMf=
<3M0 = .T.sub(m9>tryRZ%
except KeyO as OMissingO@?T G, e.args[0]) from NZUbreakDtSreturG
QsQK
P@staticmethodd(matchWAs = .group(1qif s isf
787/"%%(%s)sK.Fvxform(sX8Raw(MutableMapping8"""% that does no	
h# Regular expresr1for4ingN headerssg_SECT_TMPLK_ \[
1# [E%B(?P.+)
#`y permB5ve!>-\].5# ]/?_OPO>.*?	s*(?P{delim})\9s* # any number of space/tab,
(
# followed byRoof theDaCdelimiters,(?P.*)$# everything up to eolB1"""_OPT_NV_TMPL = rTfoption>.*?) # e permissive!V'`\s*(?:
Avi>{M<})\R   # Hally @FI/)?# Interpola algorithmbe used ir does not specifQother	_DEFAULT_INTERPOLATION =e!()-# Compiled regular expression for matc0secs8pSECTCRE2e.cC (_, re.VERBOSEi8	s with typical separator/OP52.format(="=|:")71al !# lpited us
;_NV:>@leadQwhite in a linDNONSPACETr"\S"Possible booleanLthe configur.%BOOLEAN_STATES = {'1': True, 'yes
Ftrue$onH
'0': FalsI'no
f4off!}
Ndef __init__(self, defaults=None, dict_type=__0A_no_=*Rf=('=', ':')Acomment_prefixes=('#.p;'), in_$rstrict=_`empty_@Bs_ins:=Bi=_UNSET, converters=_UNSET):

 self._dict = [_typesections = 0+()&default&BconvD = C
Mapping(_XoproxieW%[_R] = SQProxya+, &r`delimi2 = tuple(-6if  == ('=', ':'):h._optcreDOPTCRE_NV if allow_no_value elsej&M
[d = "|".join(re.escape(d) for d in
x
Z#re.compileH._OPT_NV_TMPL.format)E=d),Ire.VERBOSEHAxcomment_prefix"
Vor ()?}inline_-h M2str	rkU=f.`empty_Bs_int
<N=
-_interpolaS9 = ,"if/2is 
	Jh_DEFAULT_INTERPOLATIONhONonefI7if ois not,.update(EsgSread_$s(	) de=creturns87Ns7B"""R:a list o- names, excluding [E]"""#tb will never have6%it9v.`s.keysz,4add,#, o"""Create a new"v0theQfigur.Raise DuplicatelQErrorH0by Hspecified G aly exists. WVLQC is G.=P8== self.default_section:
 raise ValueError('Invalid / name: %r' %%)
D$if in self.isjDuplicateSul)W
I[ 3] =c\dict(/xproxies.f`Proxy(U,tdef has$a"""Ind whether the,is present configura{.8The DEFAULT is not acknowledged.5"""Preturnkyg opxs	RMa list of 4Bs foFgiver.6try,_EoptsW.copyexcept Key
K#No"(S) from None{q.update._defaults1B(0gkeys()Aread?`, files, encoding=r)"""Read and parse a7 or an iterablecRFiles that can	be opened are stly ignored; this isPdesig/"soH0youL specifypotentialB	A locs (e.g. currdirectory, user'Whome systemwid!),+all existingsNDwill be .  A singla may also-rsuccessfullyYsif isinstance(o
s, (str, bytes, os.PathLike).!3E = [
]j = io.text_(	Pad_okLCZB
Awith~f as fp:6(fpE)!OSIvcontinu5|
nK  =efspath
_ok.append%r4(oi:, source0ga() butNPargum^@mustF-like objectDM`f' 6'le, returning one line at a time.
 $Optional second argument is the `source' specifyingpname ofLpfile be#read. If not given, iUaken from f.F'`f' has noN`' attribute, `'Fused5"""72if 'UNone::try1=	1except A_ErrorC'D`self._3(f,!)
@def _string(+", 
+2='<6>')v"""Read configuraUaoG.sa= io.Sr2IO(])-(3CdictH$ry-0='<.C.Keys ares, value8ies with k5#nd&that should be presnbc ]ey typeK<rves order,>Ps andO"ir@willmadded in01All[Qs hel"}xconverted to@s du6ing, includ8sec5o C)90eler"s_$f= set(4for^,T'inw.items(8=.(T#
Cadd_3;(DuplicateSi0, Vwe!ctm

;Frais
6O.addL3key@pCX@key 2lf.=Pxform5Z(key)Q1"ifu}&]1tr(M.+)
2 	P
ea	:zJ#fpG@fp, x=<A"""Deprepbd, use=0P instsX     warnings.warn(
 $"This method will be removed in future versions.  "@Use 'parser.read_file()' instead.",1DeprecationWarning, stacklevel=2-)
Gself\fp, source=laname)
-def get(1P, secfB, op*, raw=False, vars=None, fallback=_UNSET):N&"""Get anE value for a giveng.5@If `^' is provided, it mustaAa diary. The_is looked up$inP5(ifQC), `Q', an`DEFAULTSECT that order.PIf the keynot foundD`is used asJa;0. `RP' cang as a \G
3interpolPenablp!ndal argument `raw9ll Os are expandbreturnsA`sa,~eTkeyword onlyC vspecial&""O6tryyH@d = ._unify_5#s(X&except NoSZErrorQ&if2is 
#xUraiseMOelse(@22bxform(
R = d[+]U?Key,A NoOH. ifa2 orT
:v:a'	.before_G
xdJaGconvQw*kwargs1(.9o_85/, K>, *
x	J2raw=p}(,\         return fallback

    # getint,float and
boolean provided directly for Bwards compatM0def:int(self, section, op	*, raw=False, vars=None,?=_UNSET, **kwargs):+0retj._get_conv(su3rawsx
sz	;5- 0iD/:
sert_to_

ZitemsVB"""Ra list of (namlue) tuplesnCeachDT in aY.All % interpolaos are expanin the rvvalues, based o[defaults pasAinto=constructor, unlessal argumen`raw' is true.  Addial substitus may beoPusing]`'c, which must:Aa dio
ary whose contents overridesMany pre-existjT4Thej DEFAULTspecial.L5"""%if32is super().D)ABd = Vcopy(":tryRd.update#._#s[	];except KeyErrorG!S
0aise NoSVworig_keys =0(d.&()#1# UP withq entry m0fic-Giabl ifs0key0lue.6f
,!d[mxform(key)] = #h0terSambda:	p.before3
"d[F], d if1
H  return [(option, value_getter(or)) for 
 in orig_keys]

    def popitem(self):"""Remove a secd from the parser and return it as=3a (4d_name,B_proxy) tuple. If no is present, raiseOKeyError.5The9pDEFAULTASnevered becausecannot be r%d._5"""00key-.'s(n0 = %U[key]B?delr/3key8 Bxfor,7strX-str.lower()HBhas_PM"""Check>existence of a given*-Z!If/specified `#'`None oG empty string, qassumed4SPdoes ,s False.iytA%or=.default_G.).	/4#._b5Eelif!inE.sXqJelse'A#s[	
	m
?set=
TSet as
_interpola.before_Mqa,eEdict-:try
I?ioneexceptP2NoS) Bo[
	*2] =Swrite!fp, space_around_delimiters=True&W:(P.ini-2Sat reV@configurWstate^OIf `w{  (H6), between r-&s are surys`Pleasee that commentsthe original configuration file are not
 
preserved when writing the c>Uback.75"""if space_around_delimiters:$nd = " {} ".format(self.0E[0])3NelseA32R[fault;Pe_secQ(fp, !de3,U:_;s.items(), dCfor m2 inlen#s[	]Zdef _	<", oP_name%, )"""Write a single!toIspecified `fp'.<1fp.("[{}]\nx)Okey, valueR)$=uinterpol
r.befores , f-Jw<$ifs~ None orz._allow_no_>
B& =q + str().replace('\n', '\n\t'OWG{}{}Q\n")
6cremove_opke", 
GR13 an	+#if/># =_
E-Sdict -":tryE'
I6ionqR/except KeyErrorPraise NoS&(Ta) from/U9xQ(`existew/O3if (
1del-[@]5dreturn9

X1	
@eb(oproxie'P__get}#__7key ifK# !wC anddlf.has(FJ)I!self._proxies[key]

    def __setitem__(self, key, value):'+)# To conform with the mapping protocol, overwrites existLGs inN>section. if}@ in A and	[key] isXreturYXXX this0(not atomic if read_dict fails at any point. Then again,# no update methodigparserfbnxmplementa!==.default_
#._#s.clear()*el*.FsGbsG
Lkb({key:i(})&@, fp8nam{@"""Pm$ a!edAigureb file.DEach,a/ a header, indicated by a G
square brackets (`[]'), plus/0 opsO`N'`0 ' [RmitedYa specific substr@(`='O8`:'p)Ys can span multiple lines, as longPthey Pindenedeeper0thaqe firstB1 of}. Dependo*'s mode, blankP may be trelas partsZ&swignoredJConfsUinclude coms, prefixVcharacter#;`C). CLarappear Vir ow{in an otherwSempty3r>0be f!reGQs hol>O~s. Please"%atP get &pped offVc,ation files.#
 5"""elements_added = set()cursect = None@
#, or a dictionaryFCCnameG?optlineno = 0*indent_levelT
	pn excep_Bfor v, in enumerate(fp, start=1):4a0com>_=ys.maxsize(# strip inf 7s$_prefixes = {p: -1 ;s self._(D0}MTwhileh6= sC andD
Enext
g# , x={.items(>>6=zb.find(8P&+1/#ifp^== -1(zcontinu	[x2] =Z	S2w0(1> 0T[-1].isspace()VFImin(	g9 = 	Afullk
s.esl!ifS.1().SswithZ0	Ybreak$ifi	R@valuM:/]	1qif not 8p#if`empty_VQs_in_/Aa# add 1Nr to thec, but only ifre was noH# 0 on.Q*:if n1 is2`it0?andT
[,]c@7.append('') # new}\ed at joinNelse_#marks end of
J4w
/a?:first_non^zNONSPACECRE.search(line)
      cur_indent_level = first_nonspace.start() if else 0
Iif (cursect is not None and optnam	4:
(> /):2f[V].append(value)/@# a ,ion header or?1r< = 	B#-it}
l*mo = self.SECTCRE.match/^if moe= mo.group(''.!if5"in_GOionse7lf._strict6Helements_addedHL
raise DuplicateSectionError(T@, fp\,gBolineno@[]{
E.addp(elw=stdefaultz59s
KOict(/s*;jproxie:`Proxy(b,tA# SoXq can't  with a continua} .p! =
#5# nfmin the file!isV'sMissing4H+!1no,@D# an/se_optcreNP, vi, va opa', 'viP!iftW(eu_handle_erekBJDmNcxform( .r&>p()A9Q
])b8Z) in 8                raise DuplicateOptionError(sectname, op	
2 "fpHlineno)Gelements_added.add()@# This check is fine because the OPTCRE cannot# match if it would setval to None?$if*ais not.:/P0optZ=9.strip(40cur[@] = Oval]lOelse# valuelession handlingV%# a non-fatal parsing e occurred. upa# exce but keep going.8owill b#'Bd at:Qnd offile and Dcontain a@list>atPogus s2e = self._!e_J(e, W,H44join_multif_sZ#:anyisj,6 an0;if OO!e
#_def _)defaults_Cion,,4all$<itertools.chain((11,),.Uw.items(tEfor o^ s m2#inXs\
.2ysinstance(val'st1&Vp= '\n'.m0?).rC[4interpola.before_read( =
2
A,)d_ 5q"""Readp passed!initializer.PNote:t0ues<1 beceng."""+1key ueVi^.[xform(key)	6,aif not exc:
   exc = ParsingError(fpname)
$exc.append(lineno, repr
)'return exc
;def _unify_values(self, section, vars):,k"""Create a sequence of lookups with '5' taking priority overISthe 'fp' which1*es0 (DEFAULTSECT.NIdict = {}6try6
*#._#s[	]?except Keyv
K$if'A != KtdefaultR
0raise NoS`V(w) from NoneP# UpdoY
entry specificeiables3>var if*spfor keyalue in$w.items(E*Qs not
R&Lq = str([8 opnxform(key)] = 8_ChainMap(@
Clf._"s).convert_to_booleanhB"""R&#a * translat
other types if necessary.5"""?.lower()D"in:BOOLEAN_STATESV5V1U'Not r: %s' %i2`
^[]%@valio
_'*]R="", N;=""Ds a Type ppnon-strC8sThe only legal +cwe allow6lesAs is, so we need to checkCE{*a&if|-@!dovFs, o0)A but{BFor compatibil3reasons this method;@usedclassic set(kRawConfig9pers. It>Rinvok=every case@mappprotocol ac1 ansV.xisinstance,/-#(" s must be9Vings"yof
e+cK_2_no$2 or7/eError("option values must be strings")

    @propertydef converters(self):,preturn &._'



class ConfigParser(RawG8""" implementing interpolation."""_DEFAULT_INTERPOLATION = BasicI5(1setP, secRB, opS=None"""Set an'.  Extends p.set byZ1idatype and,	 syntax on the8!uexS0valP!e__T"s(=,<=!)mpsuper()(Cadd_%
 
Create a newB" ic"ur(0s8!if name isIa-H="*_read_default$, 
QReads t passed$initializer,dicitly_5ingCs toas like]brest o%BAPI.3Does not perform> for backwards compatibility.ycL6tryZhold_=	N5	 < = *2xQict({T:}kfinall>
HSafe(
_aliasb	 purposes! __#__w*args, **#gsm1+S*@warn.	(\"The  has been resd|* "Kin Python 3.2. This @willWRremovfuture versions.LI Use+` direcinstead.",aDeprecmW, stacklevel=2-)Proxy(MutableMappingh`"""A p a singlefrom a p
#,]"""Ds a viewa`specified ``?`R`vK# =B = name
        for conv in parser.erters:
 key = 'get' +5	$getter = functools.partial(self.get, _impl=getattr(qy, key))Ms": ", `!)
(def __repr___)return ''.format-i._nameKsgetitemNsSpif not "._p.has_opaT9?raise KeyError(	Y(geRsw, value	R_validate	ue_types(C=key?=E
s>	O?delO8PE and7	oremove:_Vcontains_	3lenUP3len9s()R?ite93.__/C-#if3 !=default_sL(EQfh,FelseBs#s(@property|/S# The object of troxy is read-only.Mx"vm+ on a pzBx", P, fallback=None, *, raw=False"rsn1w*kwargs1"""Get aneE.@Unless `|`Cprovided, `Z` will be rBed iu!isDWfoundd5"""#a# If `kit shouldiap methodiM@thatsdesired fersion
 %5getw,3rawUvars,=uv=	4, *


class ConvMapping(MutableP"""Ens reuse of get*-() methods between the parser and section proxies.

    If a&class implements a getter directly,Uvalue forQgivenLkey will be ``None``. Tresence of4`converZname here enablesJ to find1useDao.L2"""GETTERCRE = re.compile(r"^get(?P<r>.+)$")2def __init__(self,+!):[A#._h= data = {}=\ in__H_cAm = gr.match(B)V-if not m or	@callY-Iattri,)rIcontinue^_[m.group('7`')] =    # See  docstringpSugetitemV7keybreturnlHkey]s@!, G6tryk = 'get' + keyexcept TypeError6praise V@('In<`atibleI: {} (type
%)'Yu
''.format(keQ0ype
&))cif k =0can)@"" a[" == pfunc = tools.partial=`._get_ , =	E.d?set!k,v*4y im.o's(lGp.get, _>=j>+5, k!~?delw
*z2Key,d=del(:@inst9Biterichain(3,),EZ[
f1delj6, kAttribut_'# don't k si*entry was pA, silentlI# clean up&+	?len89len7"""Utilities9with-statej?qtexts. ;PEP 343.import abc
2syst _collections_abc
from collections import dequefunctoolRwrapsEtype.MethodType, GenericAlias

__all__ = ["asynccontextmanager", "`losingCnull!F",
 "AbstractCQMQAp
D"ExitStackp/Decorato!	>redirect_stdout?!er>suppress#ac]


class y(abc.ABC):
ss"""An ab base @Cfor ! URs."""8!__&_getitemm()3def __enter__(self):|"""Return `q` upon -ing the runtime;r<;m@l3xit`, exc_u
pvalue, [ebackaise any6 ep triggered withinCNone:1subhook__(cls, @if cC^.#_._check_$es(C, "[1__e.!")KNotImplemdy&~thronous3Z ah
k(
O"__aDs(object("A8aor mixat enable to work as d#s.^recreate_cmn.$a 'd instance of 
.^1Allows an otherwone-shot[U like_Isupport use as
 a decorator via implicit recreation.

- This is a private interface just for _GeneRContextManager.GSee issue #116477vdetails&5"""2return selfdef __call__(, func):3q@wraps(7inner(*args, **kwds7Awithl#._[e_cm(&*eRs#v


class AsyncDs(objectg"A base 1or mixin that enables aG" cg" mhs to work as7s.":>tB"""Rnaed instance ofA,Qawait4BBase|"""Shared]AQality@a and @
.Ubi__init", a.gen =}',LQ>d1# I19330: ensure.s have good docstringsMdoc = getattr, "__doc__", None)- ifC~lIAtype#).E=  =I# Unfortunately, tstill doesn't providhelp output whenJinspecting the B/ed@, siUWpydocHcurrently bypassesPLBBshow!LyC6eadf # http://bugs.python.org/Q19404Umore dNw# _GCMBare one-shotPs, so\`# CM m['beeach time q& id # %%edRr^[.)(a,"Abstract#,
"""HelperF7e):
        # do not keep args and kwds alive unnecessarily
  # they are only needed for recreation, which iscpossible anymoreMdel self.,Efunc,Etry:
return next(EEgen)"except StopIter@aise RuntimeError("gen,
or didn't yield") from None
bdef __exit__}	, typ, value, traceback)s if#G
&!FFalssJelserWstop"f
J"ifh# Need to5ce instanti so we can reliab{=# tell if*0getb same @ion }1  =(U.throw(	e
u0 asp# Suppress1*unless* it'sIthatx# was pass]).  This prevents anH	d1ide"with" statementsbeing s=ed.L0excn	(43 Do1re- ing ep. (issue27122+ if+%>u# Avoid	,if\f	Alater wrappeIto aN(see PEP 479Xe sync Ks; a_ alsoJ0havis behavior). But do tJhqQ!by	is actually (A) L^9692)nMif (4m"isd1ce(,tm!5exc.__cause__0
d:B
	J	QBaseE=	"if.Q*not*pOD/n            )# passed to throw(), because __exit__() must not raise
 # an exception unless@itself failed.  ButpM0haslG the[to signal propagaq0, s/isLQfixesEimpedance mismatch betweenX_tocolL1and+1pro../ if1 is8mvalue:%H
return Falp/ RuntimeError("generator didn't stop aftergp")

cladAsyncG3ContextManager(_QBase,"AbstractL
C!eADeco2,
)"""Helper for @a-cm$ d5Q."""
u' def __aenter__(YVNA# dorkeep args 	kwds alive unnecessarilyX8they are only neededSrecreiTwhichpossible anymor@del .,Efuncy2tryawait anextU.gen)6mQ Stop It;ionL-
yield") from Nonen
q, typ,  , Weback if#&N

"+@:?elsP"~
J"ifB# Neiforce instantiYwe can reliab=# tell if we geAXe sam$5  =(s".a	l0 as
	p# Suppr-" *CR* it'Ithat}O>was.  This prevents a8nHd1ide"with" statement.sbeing s.ed0excC	t93 Do1re-i. (issue27122     if exc is value:
 return False!$# Avoid suppressing if a Stop(Async)Iteration excep
Hwas passed to athrow() and later wrapped in  RuntimeErrorO(see PEP 479 for @ genkors; a_ alsoJhave this behavior). But do@only6theQ0by + is actully:Kissue29692).Mif (isinstance(0, (,/))Kexc.__cause__U
/)_ ;raiuCd BaseEN0 asy`!# 1re-Iit's *not*Othat was#A, be __exit__() must not lGax unless@itself failed. cpM0has(lo signal propag|2, sLQfixesEPimped mismatch betweenX_tocolL1pro.0exc387
n/ a%(" didn't stop af[n
")


def contextmanager(funcJ"""@ decorator.
Typical usage:8,qUsome_(x)u=>try7qyield bequivalentde
b/ =k##1"""@mshelper(*args, **kwds$_GdCEME", =;Y6\~
eJ#asynccontextmanaSger
 async def some_	_generator():5<y:try%)yield bXequivalent toq
3.open)fa?is 
f_' f.2e()__init__(self,#ng\p.?=:Senter;4;3xm*exc_info=6akbJ1"""" c" m for safely *!iz!n hronously Qed-upresource sucha2  , vNaits ``e()`` methodj
b<q^fetchrOagenu(?xf	y#`await g.8/a
:
_RedirectStreamM!_s&r = None	new_target_6 = 
^&# We use a listBold Ns(s CM re-entrantBh3oldhs = []qself._old_targets.append(getattr(sys, self._stream))
 s$2new_target5creturnS!
Vdef __exit__(v, exctype	Ainst	Atb):13olds.pop())


class redirect_stdout(_RSf"""Context manager for temporarilyIBing L to anoth.Bile.P# How send help()UtderrEwithYQsys.s(UGOdir)hWwriteija filei`open('F.txt', 'w') as fdf)KB(pow2"""HB = ")"?err60err_	6errsuppress(AbstractM4to < specifiedreptions
After the5 is: ed0ecu3 proceeds 5Anextstatement follow!*D(FileNotFoundErroros.remove(some;D# Exstill resumes here if5 was alread1Qd'inC*exc6&._& =D^LSenterM@:pas's# Unlike isance and issubZ, CPython handling<
# currently only looks at3concrete  hierarchy (ignorH	` checkh\	). While Guido considersthat a bug rathan a feature, it'sairly hard oneb7fixJ!duvarious inal impladetails.Jvide1e s9rf based semantics,0try'to@exacoreproducekQlimitAs ofp&r.H
 See http://bugs.pP.org/ae120290Smore APnot NQ
R(#]_BaseExitStackA"""A( # and AsyncExitStack."""

    @staticmethoddef _create_exit_wrapper(cm, cm!):+Areturn MASType($-)e&cbc
allback, /, *args, **kwdsr	exc_type, exc, tb.cW(Sl_init__(selfZ.4as = deque(@|pop_all?4"""Preserve the context stack by transferring it to a new instance.Bnew_; = o%()!9}	gAApush'itC"""Registers a GQ withbdard _i"_  signature.hCan suppress
reptionsI}ame wayIEcan.Also accepts any object-an=#(rL!toyaead ofX it])# We use an unboundrather than a to follow#rJ
lookup behaviour for special`s1_cb[ Vxs6try _$= >. exe AttributeErrorKP# Notmanager, ssume it'8Fable[ ._}<^(Jelsey93@UP  # A|decoratorcenter_*cmE$uupplied"	RIf successful, ames itsa2 anIxdresult"__l
b2 upw
Y1 onBmatc#ftementh9_cm&cm q$q
#e8__(Jap( UTx

n arbitraryand argusoCannot6      _exit_wrapper = self._create_cb_
(callback, *args, **kwds)

 # We changed the signature, so using @P
s is not appropriate, butL@sett1_d__ may still help with introspection.AS_exit;(r.E$= -Bpush7!(Eper)0ereturnH
  # Allow use as a decoratorQdef _`!cmT(s@, cm%):_`"""Helto correctly registerxas to _>ethods."""J"(?.-c, True	
2K,, is_sync=;'.m s.Cnd((4GP))


# Inspired by discussions on http://bugs.python.org/issue13585
class ExitStack(_BaseExitStAbstractContextManager3"""" m for dynamicment of a sb
"s.%For example ()_G#files = [.enter_c(open(fname))@ in 7%s]N 7!ed$0s wvautomatiy be closed atkend ofJ	Pstate, even if attemptnl[laterG!inclist raihvn excep7__kjx.0-, *exc_details;ceived_exc =%4[0]BNoneYn`manipu teit behavesathoughDwe were actually nesmultiplecs<Sframe@sys.info()[10fix)R=0newA, oly2finUchainGzwhile 13 = $._)__G2!if50is  ]c8tF$# is already setQ(see Jf 20317 Ao]breakG	&1# Cy	ain to point to the exception
 0# wppect it,reference(
new_exc.__context__ = old
+# Callbacks are invoked in LIFO orderfQmatchbehaviour ofHsnested n managers"suppressev = Falspending_raisewhile self._exit_c:a%is_sync, cb =0i.pop()5sassert <	:tryaef cb(*exc_details)%)
6Tru"&v = (None, 
C+0ys.[Kinfov# simulatestack ofs by setting#	NJ@_fix(@[1],]:[1]K5^; = g9if N
30# b1"g[1]" replaces (carefullyp#44-up7
!fixed_ctx =
7	%d BaseEh

r5 = 	Y7~return receivJand def close(W"""Immediately unwindi E."""yC"._0_*

# Inspired*discussions on https://bugs.python.org/issue29302
class AsPExitS"(_U, Abstract'CM1"""= for dynamic@mentya.MFor examplea\ withB) asV.`connecs = [await(q.enter_S0get3.()ibrange(5)]l# All openOJs will automatiy be released atK0end$PPstateK, even if attempts|+ aJ rWQlist 0 an.?	@sicmethod_create_async_exit_wrapper(cm, cm_exit):
 return MethodType($-!)
(@staticm$def _create_async_cb_wri
allback, /, *args, **kwdsx6 H=exc_type, exc, tb4sawait cc(_&[xTenterontext(self!@"""E*s the supplied Hc8 manager.dIf successful, also pushes its __a"_ VU as aK andresult ofE_F.55"""1_cmS0 = ZF(cm)4 = $$._#t"= {	*~	RC ._\t~b<=
"""Register;oroutine function with(standardvsignature1Can@ress epVsame wayRF canAaccepts any object.an>#(r3ing!to0tinsteadY it)
bQ_&ry_n!=-._! ex AttributeErrorL# Not an7, so assume it'ev, FalsegJelse@;({#itF"  # Allow usedecoratory,"

n arbitrary cand arguments?not$20 = .# We changedj us@:Ps is appropriate, butL@sett1_day still help[introspe~;(r.E=n	F
l&.*	aaclose
PImmedly unwinK}hstack.await self.__aexit__(None, )

    def _push_async_cm_exit(self, cm!):04"""Helper to correctly registeroutine function)0__aZ%__Hmethod."""kP_wrap_ = ._createE"(E5-callback(^s, False_aenter__areturn=
5h}, *exc_detailsBceived_exc = %[0] is not`m# We manipulate the8!epX stso it behaves as though# we were actually nesting multiple with OUments<Sframe@sys.info()[1]&G0fix)_context(newA, olC)A may beBU, so findQnd ofUchain}Gvwhile 13 = $.__. ifa!6< ortF$# is already setly (see issue 20317)Ev
]breakG)	&s# ChangzPpoint		Dw@pectto reference($ =9C
s are invoked in LIFO ordQmatch2uiour ofs#3ed hFagersuppress4Apending_raise =R.zs0is_|T, cb 	js.pop(:tryF,3if M 4cb_i = cb(+OelseI^awaitO
P7if Zr:Tru%}"? = )nexcept	
V# simPstackaaions b=
J_Z
A[1],details[1])
    pending_raise = True
!exc_details = new_.9if N:D:try# bare "~U[1]" replaces our carefullyVEset-up context!fixed_ctx = d3.__5-__7	%except BaseE>ionr5 = 	Y~return received and suppress


class null(AbstractCManager, ZAsync)3"""" m6 that does no additional processing.
Used as a stand-in for a normalY, when a particularGblock of code is only sometimes ugOwithZ:rcm = opP_cm iTnY else5)~Y"cm# Perform operaN0, u\&isU2"""def __init__(self, enter_result=Nonex".!0U'VCB
J	;x*excinfoDBpass0a5 ar"
ByTfrom vars import ,	Var, Token, copy4


__all__ = ('74', 0Var;	=')
"""Generic (shallowQdeep)j6ingPs.

Iface summaZeU.0(y)`# makeOy ;?;8
For module specific errors8 .E
vd.

The difference between f
relevant
compound objects (	_ain other$, like lists or in^ces).

- Ad@struba ytx`(to thextent possible) inserts *the same* into it?Porigi{?con,ursively,
 fcopies of! f\"inl.

Two prob&lems often exist with deep copy operations that don't+
+|shallow.:

 a) recursive objects (compoundX, directly or in#,
    contain a reference to themselves) may cause%uloop

 b) becopies *everything* itItoo much, e.g.administve data structure!should be shared even betweenFy

Python'sn` avoidSese prob#byXkeeping a table ofOpalreadypied dur)the currentyBpass"@lettuser-defined classes overridetZ<1theY0setPnents/ied

This version does noty types like module,z`, func, method,
nor stack trace,
pframe,  fiAsocket, windowany
similartC.

C@can @*same interfaco1rol'y5&
t!pickling:WN
s called __getinitargs__(),
Pstate0 an&5setR.  SedocumentC for;!
"!e"binform$ on$se.
"""

import
weakref
fromCreg )dispatch_{!

$ Error(Excep!):_e" =#   # backward 'atibility

try8xQorg.p%T.core@PyStQMap
ep! I@$ = None

__all__ = ["+@", "a]

def#(xO"""S on arbitrary !.
's __doc__9H2nfogAls =2(x)O=Pr = __.get(cls)ti2ier
K`return5ierNif issub@,n8p# treat!as\ gu>2
_Aimmuhrgetattrk""_01_"," i"
jRapreducto
*^Dv = #^Helsekax, "__7Ze_ex_C%ifV%r}4
l6ctor:
       rv = reductor()
   else:,raise Error("un(shallow)copyable object of type %s" % cls)
Lif isinstance(rv, str)hreturn x-
_reconstruct(x, None, *rv)


_z	_dispatch = d = {}

def Pimmut#(xjYx
for t in ((Z
), int, float, bool, complex, tuple,  bytes, frozenset,	, range, slice, property:ws.BuiltinFunctionTypeC(Ellipsis)@NotI~mented)K
Dweakref.refld[t] =
t = getattrs, "Code"s@)
if-Qs notRa
d[lism.a
d[dic!se4setQParray
PyStringMap iACdel d, t'@deep]Pmemo=, _nil=[]9"""Deep ) a on arbitrary Python"s.	See the module's __doc__@ing more info.V2"""<0if qtBid(x1y =7b.get(d@if yMQyxQcls =T`copier;/vh if$,
Lo
p(subclass(clsHL_jatomicV&
ZVx, "_J_.'a(_
Z+%if
!_e_ex_"=n
%
44)" toBS%
("OfpmDif isinstance(rv, str):
 ]y = xOelse0_reconstruct(x, memo, *rv)
J# If is its own copy, don't,Aize.)@if y)Vnot xpPq[d] = y'_keep_alives) # Make sure x s at least as longdGreturn y

_deep	_dispatch = d = {}

def !eatomicsJx
d[type(None)8!Ellipsis%
NotImplemented+?intjOfloaObool7 coux_bytes?strs.CodeType%Orang7	s.BuiltinFunctiong/s.)weakref.refproperty97lisq=	![]Aid(xPappen"y.*for a in4(_"(a!))2@y
d[
Etupli$, Wt # We're going to put the k
, but it's still important weq# checkh0it,=GcaseOcontains recursive mutableructures2tryg)[qexcept KeyError0Apass"@k, j0zip1yXDif kj?"(yQbreak]
1B
(di!{}|ey, valuex.items($y[^ (k,I>l

if PyStringMapRU'd[@`method: # Copy instance !(x)(x.__func__ @selfS)1s.Mlc0l d/f """Keeps a refere!toobject x in the memo.

    Because we remember objects by their id,!Ahave5to assure that possibly temporaryCare kept7PaliveVreferencingb!m.We store a !@e at"a id of
memo, which should=&normally not be used unless someone tries to deepcopy:@the U itself..2"""1ry:	.(@[id()].append(x)!except KeyError6# aha, this is`first ":->_
=[x]

def _reconstruct(x,, func, args,Bstate=None, listiter7dic;=	)! =}i`A!ifUA and2@ = (>tB(argP) for.0 ins	1y = (*;_Vrx)] = y1if 3
D0=&if hasattr(y, '__set)3__''(y.(&Felseif isinstance/, tuple)M2lenj) == 2=AbR, slo" =%x4M"P__.updat%K!ispkey, value{.items(o_4set@)s?"?>y0%"{O51 ke7@[key&v)yU`return1del types
akref, PyStringMap
"""Helper1provide extensibilitypickle.

T@only~0ful:Badd $ support7I"on defined in
C,!sTuser-(classes.

__all__ = ["mE", "33or""      "add_extension", "remove_eVclear#_cache"]

dispatch_table = {}

def pickle(ob_type,!_function, constructor_ob=None):
    if not callU(K;&*raise TypeError("redu` is must beP!")f
[<] =
/[# Thee
 is a vestige of safe for unFing.G re1no reason)t^	aller to pass it anymore<,if!is*<;Y(B_ob)s(objectSy	[
pKi
# Example: provide_ing support co%x numbers.

try
except Nam*b
else:|_9#(cceturn , (c.real, c.imag)E%e(&QPPunionQo"imools, operator
r.De, ('.or_, obj.__args__)

m(U(int | str)`g)

# S^5snew-styleWBects7_re (cbase, statWSobj =T.__new__Gk(,J*k'3if $init__ !a1	.	Soobj

_HEAPTYPE = 1<<9
S0 = ZMPPytho7d2.__Q_ex__protocols 0 and 1a0ducU`(self,
#to)bassertA < 2`cls = -.__class__V in cls.__mro__if hasattr((, '__fla@!')^.5 & JVAreakyTnew =if isinstance(new, WwPew.__ __Em
3*`! # lyC ch'5^`0 = -,
c:6cls7Pf"canEX2e {name__!r}	iB}0 = *,V	B4getEB4.__Attribut$@aif get@, "__slots__", None):
 +raise TypeError(f"cannot pickle {cls.__name__!r} object: "GRf"a class that defines __slots__ withoutG:ing __getstate__ #bedHp protocol {
}") from :try#dict = self.__%__.except AttributF@eFelse"P4 = !()[0if '
return _reconstructor, args,+7
[4

# Helper for __reduce_ex__'	2

def __newobj__(cls, *vHd&*ew$@^CB@, kwJ"""Used by4, instead o to allowl!esW
keyword-only&`uments15correctly.4"""
C, ** sR`a list( )tra given!.
This needPfind 6sA2the4 and its bases, so weGcan't simply 7a.  We must walk downD0Method Resolution Orderyconcatenate ,\qof eachFPfound&are.  (rassumesPes do`modify+!irAWmisrepresent.)PafterY1 isGG2ed.^A# Ge@b valuea cache inHf possiblc"= __.get(" 2__"q#if!otq
3R# Notd -- calculk3Q = []g`ot has-#, ss!# bhas noAH2pas;
T0# S -- gather=S1alleKXoc\:Vmro__"(if+x
*. 5= c$"['Bs__'(B# if( a single0, ivCn be as"UtringJPif isQance(S, str'!3 = *-'# special descriptor_"ame in ("__di	ct__", "__weakref__"):
 continue!# mangled names$Aelif
.startswith('__') and not7endstripped = c.__yA__.l_('_')1if &?ped_)Ts.append('_%s%s' % (>,)jOelsecpMI8
!)
# Cache the outcome inclass if at all possibl6trycls.__slotZQs__ =fexcept.pW# But don't diegwe can'tcreturnG-
# A registry of extension codes.  This is an ad-hoc compres&*
# mechanism.  Whenever a global reference to , <>W`bout
#be pickled,((0p) tuple7looked up her]Psee
# it!aKered for it.  E0 arDuniversal, so thatpmeaning&aQ does? de` on
#  ex`!(Tare also sY reservedlocal us/a0hav is.triction.)  C<@itiv\ts; 0 is
#/]E.

__@= {}d# key ->
_inverted5  de78keylci'  6PobjecD<rebind those": p~`grabs Ythem whe~it's initializLw`1see;aing.

def add&(_,A"""R*nTA."""p = int(S~qot 1 <=RB0x7fraise ValueError("D@vbrange"R)= Fif (.get(key) =1and0}19B# Redundantl rasabenignb!if\?in W
%}clreadyhMQ%s" %j
,{S[key]B"ifL
	$ !inf             (code, _inverted_registry[@]))
-_extension pkey] = '$C = key

def removeN(module, name,L!):NR"""Uneer an &.  For testing only.""";ikey = [Fif (|.get(key) !1 orI
/08.raise ValueError("%s is not qed withe %s" %qG	Odel [G!
!"ifz(inIVcacheFv_DWclear!(..()

# Standard assignments'Reserved range
First  Last Count  Purpose
#4t1   127Cfor Python s~qlibrary:012849@Y 64  :2Zopa192   239m+48'3rd partiesU0240. 55.+16.private use (will never be	2ed)G56   Inf	Tfutur3<;E5s a"ed by thePSoftw 
Foundation.
"""Wrapper to.OSIX crypt 9 call andociated funcDBalit	
import sys as _sys

tryi_Z
except M1NotI.f@.platform == 'win32'!jIv<S("Thep0suped on Windows"e7elsTrequired  ^"waPbuiltR of C4")
Terrno
0str&P
fromCdom +SystemRan+1Qcolles6`Pdtupl+& _


_saltchars = _.ascii_letters +Pdigit'./'
_sr4
class _Method(o#('@', 'p ident _total_size')):
A"""CSrepresena7! mf "he>Aar CpFormat ,!heLlegacy 2-oTacterHG) __rs__(selfeeturn '<.METHOD_{}>'.!at1.")
 mk(=None, *, rxs`"""Generf specified.!If^,@stro:t available metho	d will be used.

    """if method is None:#=!As[0]if rounds31not7P and 
isinstance(&f, int)Wraise TypeError(f'{).__class__.__name__} object can]Abe 'f'interpreted as an{aeger')6!if.ident:  # traditional(ZRs = 'mAelse(ymodular$Hf'${Q2}$'bZi!)[0] == '2'\Blowfish variantsf	p
Blog_AU = 127
*int.bit_length"-1).{!= 1 << n*CValu'@musta power of 28G4 <=d/31j0out^the range 2**4 to'31ts += f'{002d,elin ('5', '6')FSHA-n*!ise@1000s<= 999_)Y(toOz=w	
#f"} doesn't support %argument")''.join(_sr.choice(_saltchars) for 2 in(:$_"s)return s


def crypt(word, ,=}B"""R.a string represent
one-way hashIba passPawith aWWuprependSPIf ``u$``Aspecified or ``1``,!strongestOavailablepQselec#nd generated.  Otherwise,H0mayu0one!`` .METHOD_*`` v s,a|[ded by : mkN()``HP
A, _Mjcalt = V&	_v)


#  19Aing/)o@1s
mo"[]R_add_(b, *args,.&$ =0globals()['Q@' + W]}<YsrRAresuC;7try2(''<except OSV as e:
        # Not all libcraries supporencryption methods.
 if e.errno == 	.EINVAL:$+return False3raiif result and len()Vu.total_size[s.append()av2Truu	b
_add_3	('SHA512', '6', 16, 106)$ 25#'5$63)

# Choose the strongestCped vers>
of Blowfish hashing.
# Early%s have flaws.  V;'a' fixesQ of
#pinitial implementaL, 'b1@ 'a'oa'y' is=psame as-, for compatibility
# with openw$#_b .
2R_v inA 'y?a'9if eBLOWFISH#2' + _v, 22, 59 +_v), rounds=1<<4)ICjbreak
 MD'1', 8, 34CRYPT', None, 2, 11dely 

"""
csv.py - read/write/investigate CSV files.1
im#re
from _csv7Error, __A__, P!r,]egister_dialect, \Lunre'6get45lissCQfield8__limihQUOTE_MINIMAL, %ALNONNUMERICONONEp~__doc__Dq_
&$io9StringIO

__all__ = ["3", 6ALL
	8E",V""Uexcel	K_tab@N,/ er
3)	PSniffT	,fDictRead>  "WrDunixG"]

class v"""Describe a!.
This must be subCed (see MN)alid attributes ar!dequotechar, escapadoublec, skipRspacelineterminatx-]M _nA= ""!_v=# placeholders&! =G`
x4ing`def __w__(self30if 1.____ != Dialect:
 self._valid = True
aate()
Bdef 0$!):76try
_Dialect()(except TypeError as e:# We do this for compatibility with py2.3Uparaise T(str(e))

class t#l(2"""Describe the usual properties of Excel-generated CSV files."""}delimiter = ','quotecha"adoublelskipinitialspace = FalslineterminatoMB\r\nPJing = QUOTE_MINIMAL
register_d}""",
Q_tab( (DTAB-d	?\t'D-tabEunixOUnixy/AL0", $)
DictReader;_K!__q, f, fieldnames=None, restkey2valHC=C*args, **kwds3.&._m' =z   # listQ2keyrEdictvD$ =^	# key to catch long rowsA3valA
>default valueX_shortGZF	C(f, 
*, 
%$ =/
_num = 0R_@Vpreturn -@yVs=!if9	0is 1
t	;R= nex!.rw)-Ept StopIt-:ionh&;past\.dq.setter8!,(v
ZC __bZ == 0# Used onlyoits side effect.Orow 	8	Hum

        -# unlike the basic reader, we prefer not to return blanks,
 # because2 will typically wind up with a dict full of NoneEevalueswhile row == []:v next(self.)$1d =lB(zip"fieldnames,U),lf = len("r"6rowif lf < lr#d[stkey] =pU[lf:]"el=>=for key in FK[lr:
#d[e/urestvalid


class DictWritedef __init__V, f, v#, S
="", extrasaction="raise"dialect="excel", *args, **kwds)/m' =zJ`# list,Pkeys FDl>#7writing shortj)if.lower()Din ( "ignore"d  VxError("( (%s) must be '-b' or 'N%'"M
%	i=*V)e	C(f, 
9+h
e
wq!dBrow(R)~_@_to_"if(
	#= kXawrong_s+ owN.\B() -J)	88if ?
Y!	] containssUf/: ]+ ", ".join([repr(x)x*]i#(rget(key,4Ht.4.)cs1eCs(ma	jsl# Guard Sniffer'spe check  agt builds that exclude complex()
try
qpt Name	Dloat|$1'''h"!s"Qformapa CSV f(i.e. delim, quotecharRRs a D object.`hdef __init__(selSf):
 # in case there is mor
an one possible delimiter<self.preferred = [',', '\t; Q:']

6def sniff(<, sample,\gs=None1""":Returns a dialect (or 1 corresponding to_@L
quotechar, double, skipinitialspace = \@._guess_FU_and_0()Gfif not]Dx*nbH!R"s)Eraise Error("CouldgterminD"TTclass"(Dx@_nam">&edBlinecator = '\r\n'= QUOTE_MINIMAL$q# escapF'r.,( =:I*0(&# _csv.reader won't accept a Fof '[ =,Nr '"-rc	elf, data>sxLooks for text enclosed between two identicals5(the proba) which areceded and followedA$by e jacter W%).8aFor ex
a,'some%',<2TheQ withmost winse|{ If3"noJ70 caBbc
this wayUpmatches]Prestr q(r'(?P<>[^\w\n"\'])1> ?
!>[q.*?(?P==?)', # ,".*?"$C	nP:^|\n7 1rOs1ax(, key=lambda x: x[1]0adjd - subtract the sum of all
 # other frequencies(
items.remove(modes[char]).!8 = 0W[0], ?[1]B-([1] for 1 in.s)_else:[~" =@I[0]
,# build a listApossible delimiter)VL,=.*s(total = float(min(chunkLength *ration, len(data)p# (rowsconsistent * / (number&) = 100%7 cy).0# minimum (threshold,i = 0.9Rwhile1s) == 0 andY5>= F@k, va&,if v[0] >dv(?> 0.2 (('/I) >=*an4(	 is None or k/))N*s[k] = vA-d*01,ifc1pd! =s.keys())iskipinitialspace`[0].countD
H
<r"%c " %G2rreturn d,, )# analyze anQ;linstart = ewend += =hbif nots^W'', 0P# if Xe's more than one, fall back to a 'preferred'S+> dmUself.F
R1if ('+nP.Nd
#Phing  indicates a ence, pib0he Pactert_p# domin:&(? = [(v,k)jP(k,v)iA#&()W.sort-`0-1]~i6ma% delim))
   return (delim, skipinitialspace)


(def has_header(self, sample):"&# Creates a dictionary of types	data in each column. If anyG! i3a singleE (say, integers), *except* for the firstM@row,n@ row^presumed to be labelsIHPcan't'determined, itH(asGa string0whi7aseJ]`length1saDfactor: if all0LRrows 
A areNRsame o'.HFinally, a 'vote'taken atH1endbP, add'orKsubtractAfrom>likelihood be+$a Lrrdr = ruSU3IO(x , d.sniff)M = next(rdr) # {#isv9}0s =5(G)TE= {}ibrange((3s):2[i] = Noneohecked = 0LVn rdra# arbitrZ`numberQ@to cN,@keep6san|A"if&zed > 20^!UbreakVved += 1!if&srow) !=sTcontinue #dat have irregular B
pf0colhClistg]w.keys()@this# x#.ry<(row[col]~(ValueError, Overflow8# fallback

37len
.5if -s):>cdd new
xH=4OelseN#minconsistent, removem]C9@dera(3delP4# f)@compdDlts against]Pand "M"n# on whether it#AhasH
@col,d{.items(j!yp4) == type(0): # it's a length
  if
(header[col]) != colType:0?AhasH0] += 1#?els9-95 # attempt typecast^?try	
>except (ValueError, )Y5vreturn X
> 0
"""create and manipulaC datas in Python"""

import os as _os, sy4sysJ


__version__ = "1.1.0"

from _c% ZUnion, Structure, Array,_PointerCFuncPtr
*3RTLD_LOCAL, oGLOBAL,Argumentscalcsize
X

if $!=,=qraise Egbion("Vl number mismatch",O,M)qos.name == "nt"cTFormaDEFAULT_MODE =Taposix"r_sys.platformqcdarwinu# On OS X 10.3, we use\o0default modee# beca* does not work at least on som8libraries. xQ is D` 7, socheck forqathat.

if int(_os.uHP().reme.split('.')[0]) < 8]@1&FUNCFLAG_CDECL_1, \ PYTHONAPI.2USE_ERRNO22LASTERROR6

# WINOLE-> HRESULT _()
#
# STDMETHODCALLTYPE(j)(=#, 5API@R
def _string_buffer(init, S=None,.aBytes) -> character abanInteger7k/, ?1"""sinstancebz!if! =&)+{audit("ctypes.create_string_buffer", init, size)
 buftype = c_char *! 3 = &(8P.valu:X1`return2elif isinstance(,1t): _sys.audit("cs.create@None>)it4e^?bufraise TypeError)

def cCA=P):
##"deprecated, use  Cead"5import warnings.	$("{O is e,PDBionWx, stacklevel=2V)

_c_funP_cach
!{}4CFUNCTYPE(res`, *arg
ss, **kw?""",
use_errno=FalserP_last"orQ) -> ion proto|!.
P: the result : a sequence specifying4rargumen6sU?Ther can be called in di=sways to/! a)able object:](integer addresseoreignI3S,b and r1a Cv4EfromQindex, method name[, paramflags]qfUISa COM=a(ordinal number, dll)c ex]ced by Kba*A^1"""@ = _FLAG_CDECLif kw.pop("1", C|DUSE_ERRNOHMLASTERRORQV"unexpected keyword (s) %s" %bkeys()K7trySo
6[$|!, !)]except KeyRclass CF0ion!(_7PtrNR_\0_ =s__!
 	* =Ft

if _os.c == "nt"_|#s LLoadLibrary as' _dlopen
    from _ctypes import FUNCFLAG_STDCALL as _
?_win_funA_cache = {}pdef WIN:TYPE(resh`, *arg
s, **kw):/# docstring set later (very similar to CT.__doc__)Bflags =`
if kw.pop("use_errno", False+M|NUSE_ERRNOrP@lastU/orULASTERRORY'raise ValueError("unexpected keyword argument(s) %s" %fkeys()(;try[oeturn [%)]except Key
\class WinF+ionType(_C;Ptrv_j0_ =/m"_S%$"		 , =	NrB#i
%'. =.replace("G", ">
")

elif _os.name == "posix"o/

'sizeof, byref, addressPalignt@, re'@!ge0no,%/no)_SimpleCData

Hp_check_[`(typ, code=Non0# C&@ if )1of( s_-) against struct.calc'q.  This
# should protect somewhat=a misconfigured libffi.>4^Le %if@ is q# Most  _ s are the sas used inT;1  =`.C`actual0qui=dtyp), TeC!2if :b != re<aSystem ("Iof(%s) wrong: %stead of %d\,wB))

>py_object(;a = "O"d4_repr__(self)xsuper()._8
3y
"%s()|0.__8__
@, "Poc_shor)h"K4-9c_uECData):
    6_type_ = "H"
_check_size(c_ushort)

class c_long(_SimpleCData):
    _DlD3BuCLC4)

if _calcx"i") ==#l"# if int and q have the same A, make c_( alias for=u2b
else:.&?int )!i"4
q inn)rmMIM;zOfloafz4DodoubleEdE5FJ g"2of(}7 =l=q=>C ? anH	!c_DR!0.~q
;")
vnWQW ##ndef from_param(cls, val}$(return ('d', K('-PLvmethod()/
-[OubytQB"
c_(A.__c0le_b
# backward compatibility:
##c_uchar\Jvb'	vuucu'u	uuu/_pwz^X__repr__(selfRL"%s(%s)" % "1__.__name__, c_void_p.@abuffer.).value)w_p, "P"DP0)p
6_p )s* (to a bug:~Obool|@?"

 
s import POINTER, pointer, _
]cache

class c_wchar_p(_SimpleCData):
    _type_ = "Z"def __repr__(self)-return "%s(%s)" % ".__class__.__name__, c_void_p.from_buffer.).value)

5@ c_wAu"

reset_cache(_pointer.clear()q_c_funcpif _os. == "nt"O_win=	(# S.1_p_QparamPOINTER(!) $ =,7
_)^	 
]\6a[None]tcreate_unicodeinit, size=7?"""/aString) -> acter array6nInteger8n?, aA"""if isinstance(#tr
!if@ is &%ofN2%)# UTF-16 requires a surrogate pair (2 _t) for non-BMP(C#Js (outside [U+0000; U+FFFF] range). +1NtrailingO6NULS.! = sum(2 if ord(c) > 0xjb else ePc in EY) + 1J&d32-bit5 (1Rper U~	]$#  1len
_sys.audit("=/s.!",r0bufrN! *?cbuf = '9"! =Y1~1buf/el7intraise TypeErrorm


# XXX DeprecatedBSetP1(S, clsget(cls,)1not
ocRuntima"This already existsAthe 4"sd ) a?in LsWhat's this???\.v`@[cls57delype_cache[id<(pointer)]

# XXX Deprecated
def ARRAY(typ, len):
    return typ * len

###*


class CDLL(objectm"""An instance of this /r
sents a loaded dll/sharedlibrary, exporting functions us@the _dard C calling>`conven- (named 'cdecl' on Windows).
,3Thee'eddcan be accessed as attributes, or by@PindexPwith  {.  Examples:q.qsort ->Rable @T#!['$/']&'C	us releasesPython GIL dur,2 ank
reacquires it afterwards.d1"""_
_flags_ = _FUNCFLAG_CDECL#prestype%Qc_int# default values for _) = ''handle = 0FuncPtr = NoneU __=__(self,~, mode=DEFAULT_MODE, P==,Ruse_errno=False"@last'/or'1win}he.]2 = "p"5if R<|USE_ERRNO?DLASTERRORH_sys.platform.startsg("aix"q"""When contains ".a("` ends BM ")"ue.g., "libFOO.a(	bso)" -[`is takfon
   archive(member) syntaxdlopen()," is adjusted
JOtherwisei,0preded to S9 file argumentLaU!if-.Q(")")6!in)
B|= ( _os.RTLD_MEMBER |UNOW )#!ifp == "nt"X3if 1not|
$|=,`Nelse1 im ((= nt._LOAD_LIBRARY_SEARCH_IDIRSh@sif '/' #5'\\4wvgetfullpathW99|"LL2DIR:_3(_C
D_flags_ = flWags
 _restype_ = self._func,FuncPtr = _
"if handle is None:pA"= _dlopen(name, mode)5?elsCLdef __repr__T)~return "<%s '%s',%x at %#x>" % \z1   H.__class__.__3__,),56	 & (_sys.maxsize*2 + 1))7!ido)2dgetatt , !if.startswith('__') and7end*raise AttributeError(b"/_getitem__&s , :Q;_or_ordinal:(0)w ot isinstance27intgk! =He	: PyDLL(CDLLT"""This 
esents the Python library it.  It allowaccessing01API^tions.  The GILnot released,hQexcep5C ared correctly.-1"""Pflags1_FUNCFLAG_CDECL | PYTHONAPI

if _os.E == "nt":;Win"r&a dll exportu1theEWindows stdcall 4`conven6,rSTDCALL"# XXX Hm, what about HRESULT as normal parameter?# Mustn't it derive from c_longn* _c@s im _check_f, _SimpleCData_T (T""l#]pretval_=10ed Fd's result when it|Fpis used^Qs forKFAILED bitAqs an OS0 if-fis set#u`method#mented in C, so t-## 2`definiDGbincludEtraceback eD" -q"is-we want (E@does"have a way toS"r'Efu).
        _check#_retval_ = _check_HRESULT

    class OleDLL(CDLL):s"""This$represents a dll exporting functions us5theEWindows stdcall $`conven6, and return.C error values are automatiTy raised as OSE+APexcepksU5""" _a_flags(FUNCFLAG_STDCALL)prestype+"

HLibraryLoader(objectQdef __init__(self,EH!rP._dll$ ="BugetattrEGnameB0if [0] == '_'a$ Attribute'(1))= "s>COitem5])EYd!E!__B_get" =method(_ys.GenericAlias)

cz"er-?
py PyJ

if _os.#B"nt"pythonapi = -"("5", None, _sys.dllhandle)
elQplatformVocygwinZ2lib]P%d.%dQ2" %]version_info[:2]d/se/)
?win1Win?ole#qGetLast2 = V.kernel32.qfrom _c0 im get_last_69, sS1Winh`(code=q, descr
Z#1 is$(= ("ifS<n = Formaw).stripH(2)sizeof(c_uint)(cvoid_p c_ _t	,R7c_s2int|UOlongV-W
X\1`&
#/

._memmove_addr, 1Tng_atcYP

## P# *B(s, const , S_t);
'@ = CgpTYPE(c_5O_p, 
=()|5set{int, size_t)
memset = CFUNCTYPE(c_void_p, 
0intsize_t)(_9_addr)

def PYCrestype, *arg
s):
    class CFunctionType(_3Ptr$(_8D_ = B`Pflags_FLAG_CDECL | PYTHONAPI8jreturn`

_caspy_objec&!)(>M(obj, typx+!

_string_a@c_in4z`(ptr, 3=-16""" ["b]) -> 
%R%3the@ at 2A.""""66_atqb)

tryqfrom _c import _w5
except IRError=pass
else8( =&m),{7"""%1/5&9Z)


if _os.name == "nt": # COM stuffpDllGetCeO(rclsid, ri3ppvw
ccom = __q__("com.server.inproc
", globals(), loc
R['*']UV-2147221231LASS_E_CNOTAVAILABLE7I.
DllCanUnloadNow(%0 # S_OK
!

lk._endiansABigEStructure, Little


# Fill in specifically-Jd1es
[8 = c_byte
c_uintufor kindGq[c_shorGY@long]!if0of(<)12: nA16 =R
/el+4+/32+8+$64+uu	
9,,2del-

_reset_cache()
Lib/ctypes.uti*l.find_library() support for AIX
Similar approach as done!eDarwin4by using separate files
but unlike 2- no extensioAYctypes.macholib.*

dlopen() is an interface to initAndLoad() - primary documentata	at:
https://www.ibm.com//knowledgecea/en/ssw_aix_61/com2aix.basetrf1/O.htmZ=AloadXD
AIX]s two styles|(): svr4 (System V Release 4) which:common on posix
platforms, also a BSDb - aka SVR3.

Froml5.3 Difference Addendum (December 2004)
2.9<`4 link0affy
Nowadays, there aremajor object5mats used by0p operatQss:
XCOFF: The 
r enhanc3IBM and ol!s.%original.!(C"
OyFile Format) wasu0 of3O&C4.2 .
ELF:   Executable'LPQ thatT@deveAAT&T.
kySVR4 UNIX.

Whthe shared  contentidentical5 - is locatedaYpath name
(8R)d,S	9m ofarchive (\4
o
@).

Vkey dDarises whe{`multipJ%bi(i.e., 3264 bit).
For eiQ only0ABI`ed, orxdirectories
2CSmost QAsoluay
fO   (iEAIX)z20y (b
sufficient
as i
"ies can be in G@- evp0harmAsameK.
In= ;-Prefer to\#""
?is ;a"Z(read)QcallsEs	.
Default activity occurb1no  inis provided. W#
# does not seB anyj 3ies-X2!of'9 expected:/aFOO.so3N is40res50as (\)search is for the
base (e.g., libFOO.a) and once the #is found`shared0rary - identified by
memberV	so, or shr.o) is locatedl:loaded.

The mode bit RTLD_MEMBER tells initAndLoad() that it needs to usVAIX (SVR3)
naming style.
"""
__author__ = "Michael Felt "

import re
from os environ, path
&syxecutabl8Uctypec_void_p, sizeof?ubproces(
Popen, PIPE, DEVNULL

# E^0EP - 32i64
# Usedbfilterearch in an aive by", 	-X64
AIX_ABI =4of(s) * 8

0max
def _last_version(libnames, sep):
    & [!, ]S4pparts =sp.split(w#0num"[52tryBawhile L
@.insert(0, int(*.pop()))iexcept ValueErrorLEpass,preturn \[M`max(reU%edT), key=_K!)
get_ld_header(x# "nested-functibut plactule levelEq = Nonefor lineJp.stdout!if0.stwith(('/', '.G./')XgZgelif "INDEX"ok"!B.rstrip('\n'"__info#)@# asQ3 wa2#, |Qknown'$s,z5"d 1
#!se?!s @ @ a digit3 = re.match("[0-9]"+neT`.appen]"ne8^Jelsepq# blank ^arator), consumAend 1oopRQbreak Ts(fil=BPars0 of8 IAr see$l Th0 cac/usr/bin/dump -H% sJs a listk(%, [) tuples.>)# sqBsingl# 1. Findbn"atsQ/, ./V../ - set{mg# 2. I@n occurs in (a following line - return ld_header
    # 3. get info (+ps start:with [0-9]).3ldr=as = [] p = Popen(["/usr/bin/dump", f"-X{AIX_ABI}", "-HQile],=universal_new=True, stdout=PIPE
err=DEVNULL# be sure to readthe end-of-fil1getall entries} wh l:  =_"(pt%&ifG;".append((C,R_tF(p))YJelseQQbreak"p.r.close(5cp.wait
Q

defvfshared"s)h1"""^extract >,able objects from>0cha2er "[" is usestrip offMApath^rmation.oQNote: =and "]" Ss that are part of R -H outputEnot removed here_d2forg, _) is# potential memberCs contain-otherwise, no process>eneeded* if9u+in6# S5@rail@colon (:m]/[.index("["):-13one_match(expr,@Must^only one 1%, p result3Nonx@When rea5@leadt""]#wPnames2Gsbetween squrbracket = rf'\[({Q})\]'elist(filter(, (re.sear! ) =ks3en(Sf) == 1O[0].group(1
-

# addi5(alYto deal AIX legacy /c64-bitGs((This rout/provides historical akaj@sche1in AIX4 u library supportEPe.g.,aJlib/libc.aU/a shr.oN!320binh"anrcshr_64##il if&64# ; of_,	i@, or
4dv'shr4?_?64\.oXls(.#if5member
    eclse:
 # 32-bit legacy names - both shr.o and
4.o exist.="is the preferredF so we look forC.o firstA` i.e.,`is returned only when.o does notC[a in ['0', 	V4.o']member = get_one_match(re.escape(J2), (%s)f=#if
T5None

defrqversionfeO1"""9Sort list opsRhighest nu3ed Us - if isThis function is calledWSan un>ed libFOO.a(	qso) haswbeen found.
V1ing8is expected to follow9GNU LIBTOOL conven!s:E@ (x,Un X.y
3Y.z* find [oo.so.X]e /.Y	2.Z]`Beforev b becamstandard scheme regardless ofbinary size AIX packagers used[q"as-is"KEsarchive[Rs but?an "distinguishing"x!64Pinsereither 64 or _64 betwP!OOy1.so- generally-q_64.so,@occa;#U`expres-D end@s must start 0# 's[0-9]',3*aa.ne digit# while multiple, mspecifics could be !ed# sep1X, $.Yc.X.Y.Z1Qafter` requiR'dot'+`ny com%@addi7al 0s pairs are accept@anytCthan
)s.|%shCas aaCoutside normal,@ectas = [rf'lib{6q}\.so\.+Q.]*',q"*O_?64.as E#2= [-1@line13!rm = re.(T , 1C#   >m8s.append(m.group(0)>$if=rs _last_J(bs, '.'E(
-,
R`0an ' Yrequest in name.
    Name is the library nwithout any prefix lik%U, sufA.so,Kor version number.Given a list of mes find and returnmost appropriate resultHPrioritygTto generic0XXXHo&eda.a.b.cMxfinally, legacy AIXing scheme1"""3# look first for a~pmatch -(1penr!ap1.soBexpr = rf'lib{fa}\.so' = get_one_U(4,4)*iD:rCD@elif_ABI == 64.T&64QJ6# since an exact  dt .so asS`was noa1undxr? DIf a{ edG, orHh(#&seql(mqs)

deflibpaths()8w On, buildtime search1stored iEexecutablas "loader heinformation"The comm	/usr/bin/dump -H extract%0is =5PibrariesLD_LIBRARY_PATH (Geerred)11LIBif defined. These Ps areended to totPpythodalinkedThis mimics\ dlopen() behavio = environ.get(""1gis Non	KC![](ellc.split(":`@obje2ld_&s(:(_, lines)`;)#s#second (opsal) argumentit includes a /D! =2)[1`if "/"-
 pextend(&L,b_share6!s,dPsqdirecto#to< n #ivh<`abbrev"()Process:^""fqrchive,if an archive is found
    return the result of get_member().'If an archive is not F;nGANone01"""for dir in paths:y`# /libKa symbolic link to /usr, skip it7!ifP@== "!"QUrcontinup# "lib"gprefixed`emulate compiler namolution,p# e.g., -lc9Elibcbase = f'lib{BE}.a'-=.join(dir, 7)'"if sexists(6)1s =pshared(ld_header:[:9
(re.escape(2), s:#if=
arA(J
IOelse8V , 6P
def find_libraryU"""AIX implementactypes.util.=iHFind that will dlopen(). Ifavailablepalso se a file (or) with a .'quffix.
supports two rschemescan be usedKFThe so-called SystemV Release4 (svr4)0matcommonly se wh(default) 0 ha#e  bendingCc1 .a(AshJmultipleb2s (f32-bit and 64):1one[M_@argu@ pas#to must include bothaDsea single string
8 looks firsr5(.a@suit(C$noC+ pasK,`6P=P1libI(
50,,1!if 0f"{2}({2})"@# To here, aN-\Bbeen# In other words, ei@# a)T'war?b!1did{have a 2/SobPCheck+`"QNote,Qrinstallkt`prepar|@from#so<to a versioned`# This practice by GNUdtool o.platformsZ so-so~libpaths:
        # /lib is a symbolic link to /usr, skip it
3if dir == "!%":continue she	= path.join(dir, soname)'"if"qexists(6)[creturn:9# if we are here,
have not found anything plausiblM
None
import sys
from ctypes *

_array_0 =  (A	)

def _other_endian(typB"""R1the7` with '4' byte order.  Simpl*Rs lik	c_int and so on already !__Q_be__$Ale__%attributes which 1ains, for more complicatedsCs_structuresv0sup<1ed.)1"""# check _OTHER_ENDIAN  (present0typprimitiv`if has7V,Oeu?get, ifoif isinstancehf
.)@_) *]._length};wsubclasswS\u1typ6raise TypeError("Thiswae does b p: %s" %*1)

t _swapped_meta&e("_sY__(self,s, value,%if"_fields_"Q = [];rdesc in[
7#x0 = &*[0>l1Drest=.2: .@nd((l,@) + Kw2 = Esuper()._G]5O)

#,

# Note: The  s*Pce* (.Rthe
#uv!) of a!!s_J!determineH2bite in
# sn%P.

ifq.[/clittle-
=4= "!"
aL1Ez=';Big*,*=6"""d3biga__slots__ = (/bs?
el?big
 cture
    class LittleEndianStructure(
, metaclass=_swapped_C):
 5"""0q with lU! eV byte order"""6__slots__ = ()e5sNone

elserraise RuntimeError("Invalidji8)
Files in this directory come from Bob Ippolito's py2app.

License: An/ponents of the( suite may be distributed under
*	MIT or PSF open source l`Ps.

T	is version 1.0, SVN reviB789,2006/01/25.
Th{in reposiis http://svn.red-bean.com/bob/macholib/trunkEnough Mach-O to make your head spin.

SeerelevantDer fk/usr/includeb-o

And also Apple's documentation.
3
__Q'1.0'dyld emul-
import os
tctypes..framework )__info5Tdylib1
-itertools!R*
try___shared_cache_contains_path
except IMOdef =
g(*argsNotImpleY!edTq

__allR[a'find', '#.(',
]

# These ardefaults as per man i(1)
#
DEFAULT_FRAMEWORK_FALLBACK = 0os.	.expanduser("~/Library/FAs"),"0Net#	oSystem"%]
LIBRARY6lib	`local/"1ib"S3_env(env, varif env is )z= os.environ`rval =1P.get(F1if 
Freturn []'+.split(':')

image_suffix="x1env'DYLD_IMAGE_SUFFIXw)y
ARvIPATHTl`R
Pfallback_',f$FALLBACK_LIBLRARY_PATH')

def dyld_image_suffix_search(iterator, env=None):
    """For a potential path 1add DYLD_IMAGE_SUFFIX semantics"""
Ip. =Q(env)$3if '0is ?treturn w/u_inject=",K=RK3forPi"!if!.endswith('.dylib'F(Qyield/f[:-len,3] +4 + B8JelsezRA	6 	overrideMnameB# IfFRAMEWORK4 is set and this0ib_Da}# framework , use the first filat exists in6FpTpf any. Ptherehnone go on to Ct5LIBKiF
=`_info()&&iftt4EY_
0os. `.join(
,j ['#']Othen\#bmKBoriginal.3
library@base_executableY
we haven't d3any1ingfound a 1the#pstarts ; "@ /"\n constructDZ:"ifGSR-('R!')i,nog_8,r[ik:N{defaultk
s 2,allback_QfIp
1u,V+e$

7P=dath:
        for path in DEFAULT_FRAMEWORK_FALLBACK:
 yield os.9`.join(
, framework['name'])
9	if not fallback_library_6[LIBRARY@base())

def dyld_find, executable=None, env
)1"""sFind a 6 ora using_ semantics5=image_suffix_search(chain(8tW_override,/),18
D{default<+nv0):%if%aisfile'Q!areturn2tryv!Aif _1shared_cache_contains\;`except NotImplementedErrorwBpassraise Value(("dylib %s couldbe found" % \sx/fnv#Gka very loose manner.Will take input such asePython.s/Versions/Current*eV0 = U	gQ=env)PV as ee.fmwk_index = fn.rv''V8if +F= -1Sr len(fn6phfn += Ry5n =3
Ffn[:_"])X4N5WinallPBtestMenv = {}Fbassert%'libSystem.I') == '/usr/lib	F$/N"/Lo$/Fs(0'

k_X!____main__'$
pGeneric!ib|ipulation$
import re

__all`1 ['_info']

DYLIB_RE = re.comp7r"""(?x)
(?P^.*)(?:^|/>)'QshortB\w+?H(?:\.(?P[^._]+))?
    (?:_(?P[\.dylib$
)
""")

def _info(filename):L1"""A$  can take one of the following four formsCLocation/Name.SomeVersion_Sj/
(	K
hreturns N`if notnd or a mappequivalent toQdict(Hl$=')',!;/='
2Vshort7vB'='O#"='e)Note that DR and 2p are op!alamay be59present.41is_p = DYLIB_RE.matche0D/em)a.group")
Btestu(,=i[F
Pg	


!
)
bassert'completely/invalid') i4e_debug;RP/Foo') == d('P', '
'CpI	O", #='_/.A[W/'ARX^
".A,	^X%, `
if __ __'__main__'
L:
#!/bin/sh
svn export --force http://svn.red-bean.com/bob/macholib/trunk// .J7

Generic framework path manipul(1
imre

__all5 ['8*
']

STRICT_FRAMEWORK_RE = repile(r"""(?x)
t>^.*)(?:^|/h>'e>\w+).v/": s/.>[^/]+)/(?P=shortnam6e)
    (?:_(?P[^_]+))?
)$
""")

def framework_info(filename):C1"""A(  can take one of the following four forms:?Location/Name.w/Versions/Some
$!_SA':f,
Rreturns N`if notnd, or a mappequivalent toQdict(Il$='$)',!r ='8DVshortIv'='#F"=')Note that DR and 2p are op!alamay beHLqpresent5is_2
 = STRICT_FRAMEWORK_RE.match?R>-a.group/Ftest4,N%d(,-=t_
Pg	2


!
lfassert&'completely/invalid') i<B8/_debug?6P/F*3 m'/F') == d('P', '!/F'1
	%/FS!j2', #='+b	
ixs,!<//A>+;	dFO, 'AKB5,a 'A_`
if __g __'__main__'f-
import os
eshutilubproces ys

# find_library(u") s the pathname of8 a library, or None.
if os.name == "nt":

    def _get_build_version():""""Return the ! of MSVC that was used to H Python.dF3For 2.3 and up,Snumber is included inCsys.}0.  Otearliers, assumeUbcompilO%6.K5"""# This functioncopied from Lib/distutils/msvcZ5.pyFprefix = "MSC v.`Hi = Rfind(/)?@if i5-1:5rx6N}i + lenEzs, restp[i:].split(" ", 1uqmajorVe = int(s[:-2]) - s)f *Z>= 13	 E+= 1>mind2:3]) / 10.0*# I don't think paths are affected by P5 inK== 6
i;
Jselse we`know w.CRPEs isBmH@_?rt(!of	VC runtime dll=%iff!isO
O# better be safvan sorr \<Aclib2= ''*el;
<t%d' % (F* 100CRT no longer directly loadable. See issue23606 fors# discuss]
about alternative approaches7
a# If pZk`t withdebug moderimport lib.machineif '_d.pyd'E+.EXTENSION_SUFFIXES,lV+= 'd{+'.dll'(0if ('c', 'm'_	#DMSDN REAL search orderr0orytos.environ['PATH'E1os.+epf=f!e.join(T,q-qisfile(DX*c1if 4.lower().endswith(".dll"):
 continuefname = "+ >	#if os.path.isfile(-bbreturnLCNone

elNv= "posix" and sys.platform == "darwin"from ctypes.macholib.dyld import _find as _@def _library(ppossibl	p['lib%s[`ib' % +,FP/ ''framework/%sU,\%)]]1forD in {:tryb^)W$except ValueErrorG
 X emscripte_is_wasm(DV2# R<True if the given . is an WASM modulR_header = b'\x00asm'U openxp, 'br')(0the`

.read(4)m
aY soVk)]m0s =environ.get('LD_LIBRARY_PATH', ''Y1dirXaths.split(":()*
0lib6.join(dir/,EE(uif not 4.6Gp.startsCT("aix/# AIX has two styles of storing shared n1ies
# GNU auto_tools refer to seAsvr43aix4(System V Release 4) regular&, often A .soR5uffLA useRarchive (s(B .a)?members (e.g., shr.o,bssl.so[# see issue#26439_aix.py Lmore detailsu*F(# Andreas Degert's functions, us
gcc, /sbin/ldconfig, objdump_;re, temp|5elf7"1ELF"k:elf_7fELF+turn thefile$.read(4) == elf_header

    def _findLib_gcc(name): 0# Run GCC's linker with the -t (aka --trace) option and examine(Llibrary e it prints out. ThehP commBwill fail because weK
haven't supplied a properBgram
main(), but that does notKumatter.expr = os.fsencode(r'[^\(\)\s]*lib%s\.' % re.escapeA)^Bc_compileTshutil.which('gcc')w if 0HG`# No Cfavailable, give upvreturn Noneptemp = file.NamedTempoVFile(:tryargs = [, '-Wl,-t'
1o',[.&Al' +3]env = dict(os.environy#['LC_ALL'] = 'C'env['LANG
Sproc = sub
ess.Popen(,].xstdout=F?IPE@8err@oSTDOUTB{env=env0
xcept OSError:  # E.g. ba@ecut+
&+'
#3  ="c.kfinall>X.closyfeNotFound
# Raised if p was al?y removed, 1 is'onormalNbehaviour of!ifA1ings46pas re$0re.@all(!, 6"3:resah2for=in 2t# Checkn.@s an8: gcc caC6porGna# some(aat areer scriptMdKactu:# shared objects. See bpo-41976 more detail.}_is_elf("vcontinuJ/!de?
pif sys.platformG"sunos5"w # /usr/ccs/bin/dump on solarit`get_so+(ff]

    proc = s$ubprocess.Popen(("/usr/ccs/bin/dump", "-Lpv", f),
 stdout=sb?IPE@8err@DEVNULL)except OSError:  # E.g. command not found6return NonePwith :3adata =.j.read( res = re.search(br'\[.*\]\sSONAME\s+([^\s]+)', U
A!if>res	os.fsdecode(res.group(1)aFelseSdef _get_soname(f)# assuming GNU binutils / ELFf@D
e0obj\P = shV.which(''B`f## 1 is;available, give upT	>tryb0y`, '-p'j.dynamic'4bad execut;	21	?ump1#+?ump+;if sys.platform.starts(("freebsddragonfly")):
F$hnum_version(libq
o"libxyz.so.MAJOR.MINOR" => [ !, % ]]ap3 = X.split(b"."-0num[>awhile Y
tL.insert(0, int(.c.pop()p)RValue	#IpasshP or [maxsize]\find_library(Yebescape%	n@expr#':-l%s\.\S+w@\S*/a)' % (P!, 
aF!en)qa0'/sldconfig^?-r').PIPE,
      stderr=subprocess.DEVNULL)
=except OSError:  # E.g. command not found6Bdata = b''Yelse:-Pwith L!.stdout.read()
Jres = re.findall(expr, >
!if>respreturn _get_soname(_PLib_gcc()O
res.sort(key=_num_version'Zos.fsdecode(res[-1]elif sys.platform == "sunos5":Edef Acrlez, is64)
os.path.exists('/usr/bin/>'4rFNonexenv = dict(os.envirenv['LC_ALL'] = 'C'D!if
]0argz, '-64'NIBbe
j>tryx7 = ,`Popen(m,GrOPIPE@C{env=envIbad executable"for line inqP)=0z.strip($$if$@arts~(b'Default Library Path (ELF):H).split()[4]9$	A
1dir	Caths`?":"libfile = join(dir, "lib%~A" % 	h%if8Qk0%
7i""_ln = FalsekGdBF) orS_ldconfigPimport structBF.calcsize('l')4@machu4().o+ '-322G*64G1	_map = {
               	 'x86_64-64': 'libc6,x86;,
 K'ppc,o64bit'+Ospar-@390xtX+ia IA9}	abi_type = mach_map.get(
Cine,9')
7!# XXX assuming GLIBC's ldconfig (with option -p)=regex = r'\s+(lib%s\.[^\s]+)\s+\(%s'1os.fsencode(E% (re.escape(name), )vItry:V
subprocess.Popen(['/sbin/', '-p']MDgstdin=WDEVNULL@?errA+8outAOPIPEenv={'LC_ALLCBLANG
~}) as pM	0rese.search, p.stdout.read(8oif resX qreturn #des.group(1Uexcept OSErrorUFpassdef _findLib_ldK
5# See issue #9998 for why this is neededd@expr'[^\(\)\s]*lK' % 	Dcmd = ['ldI-t']libpath =qenviron'LD_LIBRARY_PATH'3if ;
jDd in".split(':')-1cmd.extend(['-L', d]o
"0o',pdevnull_0l%s	:result = NoneGp = {Rcmd, $;stdSuniversal_newlines=True"Hout, _ = p.communicate()h@all(jT#fs;outb@filen# Check if the given 6s an elf: gcc can reportna# some0	s that are linker scriptUd not actualHhared objects.bpo-41976more detailsE!ifg_is_elf(             continue

	return os.fsdecode(file)-except EIion:Qpass  # result will be Nonwo'
Gdef find_library(name)g# See issue #9998>Y_F So?_ldconfigMY or \37   _get_s3(?rLib_gcc7)8##ld"?

#,
# test  


(from ctypes import cdll if == "nt"5`print(+v.msvcrtbload("!,")#O&}Wposix#P and e_version;|b
c!
0bz2#f#}if sys.platform6gdarwin>SLoadL"libm.dylibg*2ocrypto7_Systen4framework/#F-26439 - fix brokenall for AIX9+el;.startswith("aix"ECDLLQ(Smaxsize < 2**32$[f"Using G|,RTLD_MEMBER): {'libc.a(shr.o)'(&}"`
d
\
h)X # pm.so is only available as 32-bit shared-9ary'%H"rpm'
r5Oelseu:?_64xUk){!f"{i\t:: {k''8
JIJoo:o'))}")
        else:
 print(cdll.LoadLibrary("libm.so"))/_crypt3dfind_l^,\
if __name__ == "__main__"$test()
# The most useful windows datatypes
import cs
BYTE =.c_byte
WORDushort
Dlong

#UCHAR1\char
WwIUINTBKint
i
DOUBLdouble
FLOACfloat

BOOLEAN = iclass VARIANT_3("._SimpleCData)n_<q_ = "v" derepr__(self)Areturn "%s(%r)" % "1.__t4__. , ;.value)

ULONGui
USHOR

# in the"header files,se are structures.
_LARGE_INTEGE4 c_<
_U$
56
LPCOLESTeP	4> _p1W/	$#"E0VOI#LP	#void_p

# WPARAM is defined as _PTR (unsig&L00	.$ifdsizeofR) y\s/el|%-D
ATOM = lQ
LANG
COLORREF = Q
LGRP @CTYP7
LC/
#,
# HANDLE #s

I \T :  *

HACCEL =N
HBITMAPGRUSH@SPACwG
HDC"HDESKWOENHMETAFI8@!FOrgGDIOBJDXGLOBA8HOOd0ICOU@iINSTAN7KEYPKL9LOC\GMENU,IMODU`MONITO!QPALETE)RG'SRBHSTR = HANDL	E
HTASK = HANDLE
HWINSTA&ND2SC_)ERVICE_STATUS/
#,-
# Some important structure definitions

class RECT(ctypes.S)):
    _fields_ = [("left", LONG), $_("top	Origh@
dbottomCP]
tag@ = _1L =a_SMALL#'Left', SHORTO'Top 
R"
B#&]
_COORDXX%'Y]]OPOINx[$"yV	
	~OSIZE/"c~
cW0 = |

def RGB(red, green, bluereturn red + ( ` << 8)(416)FILETIMdwLowDateTime", DWORDa}"dwHigh+4]
_r4 = ?MSGGhWnd", HWN~`messag?UIN`"wParaoWPARAMl$L$t

p8)U	MSG = MSG
MAX_PATH = 260WIN32_FIND_DATAAdwFileAttributes
`ftCrea$ftLastAccess05Wri'_
nSizeHigh
*?Low)
dwReserved0(1(
c!NatCHAR * 2cAlternate9514)Wf      ("ftLastAccessTime", FILETIME),
 ("ftLastWrite/nFileSizeHigh", DWORDY*?Low)
dwReserved0(1(
c!NaWCHAR * MAX_PATHcAlternate:14)]

#,
# Pointer types

LPBOOL = c.POINTER(!)
oEAN =  @EAN)I1YTEI)aYTE)
P	
FCCOLORREFh&j	k)r,/)
PFLOAT}QQHANDL
M~)
PHKEYJIKt< KL INP#INT)
PLARGE_>GERe	/?CID&0CIDo@LONG!q&!MS%$0MSG#3J	'1)
PJ1RECH&GP	(Q2SC_p)
PSHORwGp1SIZ'4IZE&P'	(LnPMALL_RU
PPI)
PUS
 1O!PUH2)
P
WIN32_FIND_DATAA"JWJJWJ OR	P-)
import re
4sysDcopy'
tinspecttkeywordubuiltinGfunctool4abc,_thread
from F6ionType, GenericAlias


__all__ = ['dataclass'ik'fieldFrozenInstanceError6lInitVaKW_ONLY',
           'MISSING',

# Helper functions.'fields',masdict[tuplemake_dataclasHlreplac3/is1]

# Condi  for adding methods.  The boxes indicate what au the
#  decorator takeAFVPll of-'se tables, when I talk
# about init=, repr=, eq=, orde
unsafe_hash frozen=, I'm
# referr toj arguments @.  When
# check?if a dunder already exists, I mean37Bentry in~@s ____.  I never7pto see nn attributMis definedLqa base O.Key:
# +=
+8 Value   | Mean|8Up|  | No7D: no\ isu6ed.p-+	|NK| Generatedl+p+BraisPTypeError is jp+0NonoD | A6p0setKqp"P
# ____
#
#    parametere2  vqc	 1yesB<---0 ha3r??
# | False |e898 Tr7@!<-pdefaultHCx __'(=( 
*o)a/__)Q0set- $elI;=I8 orO====+======="+=+
# | False | <- the default
# +-
HTrue  | add 0raiX8o=xA
# R&because not@0ing{se methods would break "frozen-ness"
# ofclass.

# __eq__
#
# eq= parameter|v$ A  no@ yesa <--- pC hasp in __dict__?z8i-jj# lt#S __le	gg~o orderAHany comparisonP2.  U/--`!to allow this caseinterfere with using
# functools.total_o3ing`hash__%   unsafe_)"	9(jT,/K9   $c.
.	n7oexplicitlyained _
i=C| No ,  b	b{-Nxq
P{BNone)<-,zOable	zKzF@, sovhp,is overrid!q` | Has_U, but xx?--------+
# | True  False | add  Arais"Not frozen, but hashable
# +--G-+
#m}uFq)sop=+==p
For boxes that are blank, __
__ is untouched and thereforinheritedm base class.  Ifis object,pn
# id-.d1inglsed.
#
# NoteP may already have=None if it specifi
# __eq__ method in|Obody (not >was creaby
# @data)BSee action (below) for a coded verso@is t
!.
match_args__!  % = parameter
#kv	|
R|  no0yesS <---fhas __gn __dict__?5+$| k" | 
	8A  <-defaults alwaysed unles})defines it. Itca
# tuple of __init__s names; non- fields must beed by keyword.
Rd when an attempqmade to modify a-2zen!.
_ InstanceError(Attributp): passlA sentinelTIP valuo signalF 
# factory willuv`  This"0giv nice repr() which1PappeaO2funo1turZ:es' construvs
_HAS_DEFAULT_FACTORY_CLASS:
] de__(self)return '<?>'
O? = f/()Kto detectRais suppl]or not.  Us	a=a betterAMISSING_TYPE"dindica#`followDa-only qKW_ONLY"Since most per-aHPbe un{,u85zRproxy0can@sharmong all.
_EMPTY_METADATA = types.MappingPJqType({}qMarkers>the various kin	ds of fields and pseudo-".
class _FIELD_BASE:
    def __init__(self, name)".! =7Crepr71ureturn 8
u( =~"('#')_CLASSVAR(1OINIT0')

# The#an attribute on the where we storeFP
# objects.  Also used to check if aCis a Data Cp.S = '__datak_?__'Bthatsparameters to
# @^.
_PARAMv3svfunction, jif it exists, is called at~end of
#=u@OST_xR_NAMECpost_String regexis`annotaRs for@Var or Initmust match.
# Allows "identifier. ["9 ["4https://bugs.python.org/issue33453}details.
_MODULE_IDENTIFIER_Rre.compile(r'^(?:\s*(\w+)\s*\.)?X__slots__ = ('type', )
[	!aZ0 = 8sinstance.9,?)/_not i$GenericAliasE_!._!__'Belse#z	Y, e.g. List[int];-f)(u%f'3es.8%[{B8}]'._getitem__(clsZL(KTIOx(0 arRly ever created from withimis module,
#yBonly$q6() although dsnp
# expoexternally as (conceptuq) read-ipR.
#
#,P1 fiin afterafact,  nVAy're@knowY20tim?5> ti, but it's
# convenientH1theSavailable laterWhen cls.;SXbp a list.u will have been popuud4J
%',default5_o?ory$         'halsh',
 _'initcomparemetadatakw_only_field_type',  # Private: not to be used by~r code.!)
`def ____(self, default	_factory, ', repr, hash, #, !):q?h.name = None$ =
8'
/! =
! =
! =
$ =
 = (_EMPTY_METADATA)	5if 8!is'F els,	.
8s.MappingProxyType(F%))m$ =
h!1$1return ('F!('1 f'!={O!r},'''*-
5=.2'''J''X*-./.-
1}3')'`# This isdsupport the PEP 487 __set___ protocol in%E# case where we'raing a  that contains a descriptor as aE" value.  For details onB, sem# https://www.python.org/dev/peps-0487/#implementation-\#BNotein _process_class, t.?p object;overwrittenD@with
A, soend resul?	)E9hadp called
Bit aright timE5powner, func = getattr(0.H), '!',0if D;JTi?2!ho^,AB# iti	, owner, name)

	    __class_getitem__ = method(GenericAlias)


a _DataParams:
LQslotsD('init',_'repr/eqOorde1unsafe_hash:ofrozen!)
`def ____(self, 
 , a, eq, ~', k", X);.:! =A]M! =T
zeq = eqq" =y
( =
'# =return ('%('Zf%={O!r},'k''#eq%/eq#&) /5.0
>!r}0')''# This function is used instead of exposing Field crea+0directly,
# so that a type checker can be told (via overloads) 0t}fis a
#RwhoseIdepends @ts ppeters.
f(*, default=MISSING_factoryR=True~=None, compare# metadataekw_onlYB"""R~an object to identify Ai %s.~4the` value1$. 4a0-argumentKacallednitialize a}"'saV.  IfAis tuP willaS!&'sw)P\1XaincludvA theB=!'sh"()II&=IL	/Eison[5s. , if specified, must0qmappingEPwhichrstored but not otherwise examin*oI0comkeyword-	?")~ Itan errordy bothqD and}.Q2"""$if!Q<#~ raVEP('canMt and default_factory')
    return Field(default, 	,
, init, repr, hash, compare,FJmetadata, kw_only)


def _ffPs_in_Pr_order(!):I1# Rbs the R as _2_ will output#cm.  Its 2 tuplesME	rst for normal args, andAq second qkeyword!!.
(W!(f'Df inPif f.Pdnot f.
B>TBF_str(obj_name,A a stringPesent
Beach1D of Dba;w# member.  So,  is ['x', 'y']Cis "self"#0 "(1.x,3y)"Z# Special case !0-.1if S}A'()''a# NotePtrailcomma, neededPthis s? to be a 1pYf'({",".join([f"{P}.{f.u!}"
])},)'


# Tjfunction's logic;copied from "recursive_V$" 1@ in
=prlib moduleavoid dependency.S
Gd(user_KDecoratorI0makvuB"...%a ZdBcall;P_runnir= set()/@{ools.wrapsJ
1perkey = id, _thread.get_idenh(0if /!in%$B'...*$pr/.add(key<-",'!\nn(f'  {b}' for b in body)

    # Compute the text ofentire function./txt = f' def {name}({args}){return_annota3P}:\n{l"}'mlocal_vars = ', '.join(s.keys())h"g__create_fn__({.E })artxt}\n ~"Eng!{}exec(txt, globals, nsl:Ins['kQ'](**nQs)


field_assign(frozen, , value, self_!):y# If we're a 2p class,f"n L to our `s__init__Evia object.__setattr__.  Otherwise, just usicsimple<cBment# is what ""`calledEthiss: don'tAhard-code9`, sincKat might b'#if
#f'BUILTINS. ({]!},}Q!r},{y1})'H,.,#}=*'g3(f, mu, slotsR	1Bline1ebI  t_Awill # vPializ.aY.'qdefaultn_dflt_{f.X}D.*pfactorynot MISSING^-su1# T|` has a| R . a parameter is?P# givx"it0Pnot, B$K	8[]	6x = (f'{:B}() 	Tf'if ;!_HAS_DEFAULT_FACTORY=Eelse?'1`MiF0's !inPRs, buLS#`pt needs3b:Wd here by1ingP,_`# becaUe  o@ wayqD#itzP# ForO*fd with\=R dict8j4Q(cls.wJ	cs).  Butp work fGc(  m`!beQFband we0}}!to@.  WPSG# fall backv"'se, both_v__ callPif f.]X\if not (f.is MISSING_factory !CH2Tru Xelif %
'raise TypeE0(f'argument CB!r} l<'rs^ G"')locals = {f'P': f. }9.update({'E$':O'1/: 6}body_line![]nQ(2 = /D(f, 5,!sU!# Bis None means that tP doesfrequir # maializa@(it'lB).  Just skip it}.append($P# Doeis class a -?*if9lparams_str,'.join(KwEis _FIELD_INITVAR)B5f'{}.{_POST8_NAME}({$})0# I Os, use 'pass'c#OB = [5]%D_t6(f):if nQ# Addrkeywordargs.  Becaa* can be added if=#E rect least V,' needs toPRa tesO(instead of just concatenting the lists together).
 _init_params += ['*']/(f) for f in kw_only_fieldsAreturn _create_fn('_@5_',c[self_name] + .2body_lines"rlocals=%@glob&'_type=None)


def _repr#, H!):Kfn =	1	 ('?',)"[' &.__class__.__qual>__ + f"(' +_', '.join([f"{f.5A}={{R_!r}}"@J/])tO)"']0=8v_recursiveg5(fnw
frozen_get_del_attr(cls,  = {'cls': ,k!'FTInstanceError': }:#ifmI}_str = '3 ',o(p@2) + ',)'XFelseS# Special casetzero-length tupleSVS(0set;_$    '*>ovalue'  (f'if )(T@) isn@ or B5{/}:  ' raise(f"cannot assign to  {f_!r}")Zcf'supe25.__(B!, ) U`


?delvodelete-|MM0cmp1op,__W0, o9
1# C a comparison function.  Ifobject are#d 'x' and 'y',6nD;cstring7'(self.x,self.y)' and other_tuple is the string
    # '("2.x,Qy)'.
return _create_fn(name,<
('self', 'H/'))R[ 'if.__class__@/:'AC f' {4a}{op}{|A# '@NotImplemented']sglobals=)


def _hashfields,  :%2 = E_str*6),m"'___Ikf(.)"isvar(a_type, typing)@# Thcest uses a  internal , but it'b0away to0# t@if tOiHC'AVar."-<.'&@or (/)0_GenericAlias5=?.__originn)xis_init"Adata'es'e module we're checking againsth%# currently in (^O.py)'qInitVarO ore"3)is_kw_only1', .@#.KW_ONLYG!isO(annotation, cls, a_m'
#, +_predicateor# Givens&e J, does it refer to n#m?  For exaf, whenHthat_PdenotF,knU7,}v#5ing0# I&possiblevlook upYgBZ involve^5_rin sys.U1s (o"!)	seems like a waste since:caller already knows- rY- "he! ewas found i-}@ we want1Umatchkx"inp;

{t`a func d with (objT2#  ideterminPf objIoe desiredQSnot do a local space lookup (example),EBplusexpensivwould requir0 ev"orP Eo, make a best effort+1if lG0 us Pregex+"ndC!theHng referencedFZ@ly one correct.1For cote discussion, [Rbugs.U3.orRT33453K If[t been imported,hnfassible3anyD+b?Uo2loo3 ifB1	 by any module (not necessarily cls'Tm$)Qb= sys.rs.get('!')zlif (_is_cQvar(a2ing8Gor (I;,b
(,Y(*4clsZ.;L+))/f._CLASSVAR heeWy'orAmatc9 #$$an:if #isrMew3u0aga %# currentlyQ(datae) ![_5__]UHinitD
3_', 
.  _is_initvawr))):
 f._field_type = _FIELD_INITVAR
,# Validations for individual >s.  This is delayed until now,Einstead of in the Fz() constructor, since only here do weCAknow:v name, which allowbetter error reporting.Special restricClassVar and InitVar.z:if )Cin (+CLASSVAR,<i?default_fay+not MISSINGraise TypeE2(f'0{f.P} can=have a '	'z z%')/# Should I checkRother@ set<3s? ECQseemsmost serious toT.  Maybe add `27ForGexample, how about init=False (BallyO#!)?  It makes no senseys(#fyeanything>H1kw_v9assignment<33# FUds, if rwasn't iy se @G/is$f."=bFelse# Make surei etx ns>lassertasO`0	F#Eis a6 buFsT
$')Vas, dis mutable> n usi is?sance(f.p, (listk0ct,DVE  {P!)}	%f'iVt}eed: us*#return f

def _set_qualR(cls,6A# EnE@thatC funIed from _create_fn}Rprope\5# _g@__ (wcUy belong to)j03, F{._= f"{cls4}.{+A__}"new_attribute7 	Never overwrites an exis @.  Returns True if the
    # attribute already exists. 	if name in cls.__dict__:Areturn TruQ_set_qual7(cls, value)20setp"	LFalse


# Decide if/how we're going to crea hash function.  Key is
# (unsafe_!, eq, frozen, does--P).  V0 is! aL
 to
# take.  The common case*o do nothing, so instead of provid5a
#P that<a no-op, use Noneqsignify%q.

def UBnone9fields, globals)>L;?add6	flds = [f for f_&(f.compar0 f.2dS else!)]
0fn(o)Pexcep	# Raise an 0rTypeError(f'Cannot overwri+_1_ '!f'Rass {__}')

#
#,/+- ?F|K/  M
? eq=D
AH n-explicitCL|m
	 @qvcB  v
A= {(/, !):,A4! 4-", v4;h&a+):l
>r-yr?addm9m_m9mp*xx9x1x               (True,  aFalse, ): _hash_exception,
 ?F??add9@x}
# See https://bugs.python.org/issue32929#msg312829 for an if-statement
# version of this table.


def _process_class(cls, init, repr, eq, order, unsafe2, froze0   match_args, kw_only, slots):`# Now that dicts retain inserr	there's no reason to useF"an)!edH.  I am leveragingdoNf, becaDderived  fields overwrite base, but the{is defined by9, which is found first.:pQ= {}

if cls.__module__ in sys.sAglobals =[=@].__b!__]FelseA# Theoreticallis can happeF someone sD{# a custom strZ+ton#ca<such dataswon't be fuintrospecs(w.r.t. typing.get_type_hints)pwill st@funcJAcorrectly{Dsetattr(_PARAMS, _DParams(i"m\M"))# Find our es
rbse MRO, and excludourselves4d12 soYmore e#ride earlieriVjAs long aFwe're iterat$Um, see if any areLBany_\_a!= [Ehas_9 b'ro__[-1:0:-1]SOnly "eshave been1our# decorator.  T0is,!y ?a _FIELDS KRibute>_go$b,4u, None)n!if3i
t$XoK'#f#.values('[f.name] = fN8if /").
RS# Annota_V"in4D(not>es).  If __annota0tions__ isn't present, then this class
    # adds no new annota?.  We use2to compute fields that areGRed by/a." F7are found from cls_v, which is guaranteed to bh	ordered.  Default valuesSass attributes, if arhas a dAP.  IfRa#()=#itAcontains>i0`al infyond (and possibly including)gCjactualt.  Pseudo-eCPVars QBInit
w[ed, despitbe factthey're not reals.  That'dealt with later  =.__dict__.get('___', {})
`Now fibin ourahile doing so,xidate somqthings, see4Cs (aU) whe&fwe can^C= []Get a references*Pmodulr _is_kw_only() testUKW_ONLY_seen = FalsAdata
es = sys.mRs[__name__@for , type ink[.items():0Seei`markerRchang
 C of BHif ({', )m/or (isinstance(.:str&*Y#(9cls[	
.@,pJ	S'))
%# Switch	0R=TrueFPignori>#P: it'8;13if raise TypeError(f'{0!r}]<T, butI/ 'A   'lready bpspecified'a0 = 	^Jelse# OtherwNU
;f.append(_get_(
,)9
f3s0[f.AR] = fnq## s% (W+th@ nC#%r) exist{ is! '', replace i:"thno is"sobnormal` introK seK%z     if isinstance(getattr(cls, f.name, None), Field):
 if f.default is MISSING%0# If there's no 4, deletep class iibute.jE
This happens if we specify f(repr=Fals?forDexample (tha,FRied aJ object, butE value).  Also're using aDfactory.  The should not be set aaall in@post-processedQE0delc)Nelses!)
C@# DoNhave any4 members qpdon't a,'notations?EBfor yZcls.__dict__.items(sif isin52 anCQJ5_anr
raise TypeError(f'{80!r}abut ha0typO'Check ruleRapply are derived from*Adata"es iff_f_bases1# Ran excepBawqof our 2oafrozen0 we2nothY if_&i9w/(!'cS inherit non-8 ! 'F'74oneM'4\none 	Q=anyF4 B# Re* o0As on" (includ`}[#\@mark|"is	` as be3a	_FIELDS,y)WaNdefined with plicit __hash__?  Noef`__eq__NA,n python will automaticallyF
h1 toF is[a heuristic,it's possibleCesuch a1 ==K! wt|-generatedai# close enoughH9 = Tget('$','xbhas_ex?>(P[ #7'|'.__dict__))

    # If we're generating order	methods, we must b(`the
  F3eq ,."ifE and not eq:/raise ValueError('?_Utrue ?0is 1')
># Include InitVarsaregular fields (so,uPClass&).  This isHinitialized here, outside of the "if %:" test, because std__nPs used with match_args72low8all: = [f for j .v1s()X.Rif f.|_type in (_FIELD, _INITVAR)]E(, kw_onlyB) = [Bs_in(#Q	`Does tkc} have a post-6 function?5@has_ p = hasattr(cls, _POSTS_NAMEy_set_new_-Ribute2!'_I3__'-%,fn5
GS	rnofrozen,	N3# The name toUself"p# param.  Use "E if,Rsible5^q'__datan_j0__'@''G
Relse BCglobals-Oslot+
)Q# Get as a liYi
T realEdin allgfollowoi_ccs]vif reprfn1)! _
0fn(^#, A)ify# Create __eq__ere's no needea __ne&# since python will cZV0negh"itVTvcompare`_tuple	S_str( T*_other/', flds)
        _set_new_attribute(cls, '__eq__',
 _cmp_fn(-O '==3Mself_tuple, other
o	<globals=1))
6if order:-# Create and set the$ing methods./flds = [f for f in field_list if f.compare]42 = `_str('0', T)./
00nam$p[k lt_ '<')*e*=+gU>*U>U]Oif _k#-n0P op, dtEdDL
&raise TypeError(f'Cannot overwri`=  {?} 'f'in class {cls.__:__}. Consider usL'functools.total_Fing'ffrozen[ fnU__get_del
#, ))B%fnK, fn9=YP`*	# Decide if/how we're gosCto c:a hash a2ion-p_action[bool(unsafe_	!  2/eq)-has_explicit!if# No need ?all here, since byMEtime#D(!Sis uncondi7"alJ-H__ =0get.'__doc__'qrdoc-string<0 = M% +inspect.signaturB
)).replace(' -> None', ''match_argsI could probably tute this oncqR6'__\            ( tuple(f.name for f in std_init_fields))

    if slots:cls = _add_(cls, frozen5abc.update_abstractmethods-%return cls


# _dataclass_getstate andsre neededpickling1
# Hres with.  These could be slighly more performantwe generated
# th7de instead of ituRover 5.  But that canfa project
# another day,ky	ce becomes an issue.
defb(self)G[getattr", )uL)]

Z[!!, a"`, valuX zip(R
2&r# use sa@ may7\ ob+3.__9#__m)2is_T# Need to creTB new!, since we 't" _!__#  after a3 has beenO"d.'# Make sureB isn't already^.UEif 'g'}cls.__dict__Draise TypeError(f'{)6__}Zpecifies|'f8# Cc6our	1cls0 = ')_~H$5W[2] =3M]hK# Remove bibutesMpresent.y'll still beaSqvailablr_MARKER!3.poe, NoneT0 itF	B'#'BAnd finallyKgH@qualk4 = j4'__%__Wp = type)!._0__,i.__bases4if Uq is noty$E__ =15if |71hiswU
ss%//5|e5=, /, *, =True, repr#eq	order=False,  unsafe_hash!match_argsM@tkw_only.m
A"""REs<s as was passed in, with dunde"r methods
    added based on the fields defined iqclass.
5Examines PEP 526 __annotations__ to deter&P;If init is true, an __C__()!to}1 If@repr#A0 __@. If orde0ArichGcomparison dun$B are@unsafe_hashvC_z@func*C`frozenc1mayGnot be assigs`to aftnstance cre]Nmatch_argsRG&__@uple&pkw_onlybthen bdefault all
keyword-9Fslot~1 an!____ attribut|"2"""Cdef wrap(cls):return _process_$,7 , R, eq,', ,GK&, "#, !, )# See if we're being called as @data7 or1().Qif clFNone1# WPJwith parens8	5
C9outFB9@)


ms(S_or_i[}B"""R|1a t5pdescribY@ of this Accepts a4an i;aone. T_`elemen2Bre o`type F.# Might i(worth cachis, per ?6tryxP= get, _FIELDS)> ex$ AVErrorPraise TypeQ('mus	%or'hExclude pseudo-.  Note thatpis sortyH erf#s-e isDwerel7p(f for .values()1f.__#is=jE_is_hL(objlQs Trui0obj/D.!1has["}
al!= Df isr , `) and GenericAlias) else1;=cls`asdict3P, *, 
_factory=
s """Return t2he fields of a dataclass instance as a new dictionary mapping
   ? names tovalues.
"Example usage:5  @l%"  x#C:    x: intyc = C(1, 2)assert as(c) == {'x': 1, 'y': 2}If given, ',_factory' will b!ed0eadbuilt-in.pT>!un applies recursively that are>flrs. Thisalso look%o containers*tuples, lists, ands1"""mif not _is_x_R(obj)Nvraise TypeError("O) shouldcalled on3"s"return _?`_innerk,r)


def'/ifesult = []for f ins"+ =cgetatt f.)>r|.append((2!, ])+~(;$xelif is!, )6has"'_'q# obj iAamed<A.  ReXit, but the r%ed2B1ectEanotherK7same type. 'isBpsimilarBhow EB- or-derived%es#'# treated (see below)we just need`c)mdifferently because's __init__JbIpo-34363)/1I'mmWusing0i(/tmethod,- it doesPZz`  conv@them6n2s (
0xI don't actually wantA$+rict herie main{hAcase%Bjson.dumpit handlesT <6s.  Admittedqe're lok8som  informawhen we produ <a'r.  Note ifD
eo`D	B s,;cGnPnger a)U	Dstructure wv	 was usedG key(obj)(*[_asdiBct_inner(v, dict_factory) for v in obj])
    elif isinstance(obj, (list, tuple)):)-	# Assume we can create aQect of this type by passingsaF
generator (which is not trueQnameds, handled@uabove).areturnvQ)(_asC
fgko,<

2%k,.items()2Uelse:vcopy.deep	


def asb3, *-=C"""Rche fieldsa dataclass B as a new B'1 values.
Example usage::5  @P&"  \C  x: int yc = C(1, 2eassertcc) ==  1If given, '' will b!ed0eadbuilt-inTunction applies recursively to7 that areg@s. THalso look%o containers0s, as, ands2"""f!iflE_is_y_
[raise TypeError("4) should!called on"s"_@mw))?if esult = []sKfs"; = pgetattr1@, f.)?Dr~.append(V!	(2%/)6has"'_'#d a YA.  ReWit, but the r	s0objis anotherK7Asame". %ism# similarBhow EB- orM-derived%es"E1# tod (see below)we just need`Gthemdifferently becausek's __init__JsKbIpo-34363	+*[Gv4#      # Assu*me we can create an object of this type by passing in a
 (# generator (which is not true for namedtuples, handled@uabove).areturnv(obj)(_as>_inner(v, factory)ev/Helif isinstanceH, dict): 
hiki/, 
)^b
4k, .items()3Melsecopy.deep	)


def make_dataclass(cls_e, fields, *, bases=(),space=None, init=True,Brepr3 eq		order=False, unsafe_hashGcfrozen! match_argsRtkw_only Rslots
B"""R	a new dynamically%d !.
6The will be '$R'.  '''an iterableDof either (S"),, ) 0, Fq)2Qs. If)2 isNmitted, use the strC'typing.AnyFEE are!byH;equivalen
J# [-info])'\  C =:'C', ['x', ('y't"'zR(35))]\rBase,))}7is 2to:5  @!  0 C(?*8x: /gy: intz" =w1ForpA and parameters, secbuiltiv) function<Y6A , )a, eq, 	,s<Qed to(2"""'if0is zB= {}2`# Whil're lookqthrough"Wp, valid@thata#identifi`keyworVGot duplicatesseen = set(`annotaA!s wdefaults
&,=	0   =mYhOtp =L@len(Sf) == 2u;d\, tp,X:3:Lspec?\[e]35pec
0raise TypeError(f'In0: {C!r}'5C(otn>not name.isidentifier():
  raise TypeError(f'Field names must be valid ideF@s: {"U!r}')Pif keyword.is
('t!noxEo] in seen duplicatedOB.addannotations[zq] = tp
 # Update 'ns' with the user-supplieUpace plus our calculeAues.O
def exec_body_callback(nsKAns.utsXdefaultsG['__0__'W `types.new_class()` instead of simply&to allow dynamic cre8#3generic dataS0clsWp@cls_s, bases, {},!) Apnormal decorator`freturn~(cls, init=p, repr=, eq=eq, order=,Funsafe_hash=, frozen==match_args=, kw_only=, slots=@)


)	replace(obj, /, **change-B"""Ra new objectlacing spec0d fs+1valThis is e0@allysful for   ExamplABage:5  @(T=True>( Cax: intgyc = C(1, 2D31 =e(c, x=3assert c1.x == 3 andy2R2"""# We're go%ato mut_
', but that's okay because iaQ#tdict, even if2ledg'S**my_`2)'.0if E_is_>_"an"_) shouldQGed oP%s"FI0n e to have&TFalse/Cin ''`b# If a 3&abad its>m2`provid#bj^rgetattr_FIELDS).# Only consider or InitVarmWaif f._"_b_CLASSVAR ]RtinueC f.B
-!# ^tEhcJf3in CBR"
]&Vj(f'field {f.name} is declared with '
 
'init=False, it cannot be specifiLreplace()')zcontinue
if f.name nin changes:"&_field_type is _FIELD_INITVAR and f.default zMISSINGIM
raise ValueError(f"InitVar {Y!r} "8
O'mus"[e] = getattr(obj,)# Create the new object, which calls __@__()# __post(if defined), using all of\B Zss we'veGPaddedW/or left in 'Q'.  I@re are vNps suppl*#inG1P that*3n'tn, this will correctly a>2Typ.`return.__class__(**d)
"""Concrete date/time related =s.

See http://www.iana.org1-zones/repository/tz-link.html for
X']0DSToa sources.

__all__ = ("1", =TdeltaYqzinfo",~"MINYEAR 1MAX)


import TP as _	Amath	sys
from operator CQindex/


def _cmp(x, y)P0 if x == y else 1>C-1

S = 1
 = 9999
_MAXORDINAL = 3652059  #Oe.max.toordinal()

# Utility functions, adapPython's Demo/#es/Dates.py>
# also assumescurrent Gregorianc`endar f'ely extenin
# both di.  Difference:  xLls January 1|year 0 day
# number 1.  The code here919
7is is
# to matchi*tL"proleptic"h Dershowitz)nd Reingold's "Calendrical Calcula^ s"\2it'R1basX 
#8xbcomput60.  Cbook$Athmspconvert`betweex (smany other`system@# -1#!a aholdernxl`purpos
_DAYS_IN_MONTH = [-1, 31, 28+30 	2]

GhBEFOREK]dbm = 0
for dim[_IN_MONTH[1:]:
    _DAYS_BEFORE_MONTH.append(dbm)#dbm += dim
del dbm,

def _is_leap(year)T" -> 1 if  , else 0."Wareturn % 4 == 0 and K % 100 !%or&!00(")
}days_before_c;number of / / January 1st>2y =p9- 1*365 + y//4 -(00in_month!, #rin that3 assert 1 <=%S<= 12R#ifA== 2R!298"IN[]A( preceding firsto'& must be'n1..12'B + (@>\xymd2ord,ordinal, consider01-Jan-0001 asC/ 1*pdim = __k>0day1pdim, ('
<P%d' %
(c
1) +aB	&Z'.day)

_DI400Yd@401)X.# 1400sB1B1B@   "L0  "@O4Y  54  #;E@0  4U

# A 4- cycle has an extrai`over wwe'd get from pasting
# together 4 single#.
,YB4 * 1Similarly, a 400&$
#1Rsy = 1_DI!+ @OTOH
>one fewerYthan )25i	|B5 * *ord2ymd(n)
# n is a 1-based index, starB at 1.  The patternsLrepeats exactly everyBbasic strategyto find theJpclosest<
Pboundat or before n, thNen work with the offset
    # from that boundary to n.  Life is much clearer if we subtract 1@Kn first --gn	 values of n at 400-yearmies are exactlyIthose divisible by _DI400Y:" D  M   Y
n7n-11B-- -- -=31 Dec -400+C   -	u 1 Jan -399(9-+1G(=8...0' 0P*(-2// 06 00T
0	>	! 2	L2C. 3/3*	C:%  48HRn -= n400, n =dmod(n,z) = (  * 0 + ba# ...,2, 1, 401,
6p# Now n(non-negative), in days,Nu1wC, toNEdesired date. acompute how many 1cycles precede nBNoteOit's posfor n100]equal 4!  I%at case 4 fulli
y, which implLI0day&December 31(0end
auX100Y)
"4K #itW4U4SvAnd nowqpsingle 
s.  Again n1 can be 4, and asmeaning
-133652 +=*P + n4	 ifT== 4 
F`assert%1= 0areturn-1, 12, 31{is correct.  We findk#month via an estima's eitherone too large%AleapQ == 3(n4 != 23:`= _is_(K&= (n + 50) >> 5{ing = _DAYS_BEFORE_MONTH[month] + (8month > 2 and leapyear)
    if preceding > n:  # estimate is too large
/OA-= 1BC-= _DAYS_IN_MONTH[/Q] + (
? ==Fn -=Z
assert 0 <= n < _days_in_I(!, !)
1# Now the  are correct,nhe offset from9Gstart of thatc:  we're done!(areturnl, n+1

# Msoday names.  For localized versions, see} calendar module.
CNAMES = [None, "Jan", "Feb0Mar!Ap0MayQJun",	@"Jul#0Aug0Sep0Oct0Nov`Dec"]
|!Mo|0Tue(0Wed0Thu0Fri!SaK.Sun"]


def _build_struct_time(y, m, d, hh, mm, ss, dstflag):w<= (_ymd2ord4) + 6) % 7'cdnum =dbefore"0, m-d(.X
~ , ])Sforma@us, spec='auto'Qs = {'hours': '{:02d}'w'minute:$nsecond$+_milli0\.{:03?cro7A6d}'}%if# Skip trailv&mig when us==0.S1RH = '-'us else '7,el
%\us //= 10006tryafmt = []'except KeyError3raise Value('Unknownv'=QBfmt.b(]D(offe" if@not 9g.NF < 0sign = "-"off = -off
%<+< = divmod#adelta(2=1)D1|0	2s += "%s%02d:P" % (^if ss or ss.KRL3ss.]MG$'.%06d' %wLbs

# Cly substitute for %z%Z escapes in strf"Rmats.mwrap_strftime(obLject, format, timetuple):
    # Don't call utcoffset() or tzname() unless actually needed.
Afreplace = NoneRthe string to use~1 %fqz0z0Z0!Z
1`# Scans0mat %z and %Z escapes, U8as 2new+Q = []Qupush = q.appendi, n = 0, len(:)while i < nj-cI&"[i^ai += 17 f )V= '%'<R18matZbijfj5if !is
%*06d' % getattr(ob4'microsecond', 0b:(/&elz*O= ""hif has% "t"2 = J.9(43if ;ois not30sig?'+''b.days < 0#02= -
i9-hst = divmod(gdelta(hours=1)CxmM3resPKominuteM@s = @.su.8Oif ut'%c%02d#.%(|, h, m, s, u6is-H
}z/sex)tq`assertZ4in G
.^9_= 'Z'5if 
             Zreplace = ""
if hasattr(object, "tzname"):6HBs = 3.1/()0
if s is not None^b# strftime8going to have at this: escape %|
N#s.('%', '%%'newformat.append(E/?els@pushi4*chM+'($Oe.join(rreturn _f.o% , tuple)

# Helpers for parshe result of iso3()
def _'%e__date(dtstra@# Itassumed th function will only be called with a)of length exactly 10, and (though5mused) ASCII-]Lyear = intR[0:4],1if [4] != '-'raise ValueError('Invalid  separator: %s' %I!)
vYmonthwC5:7]x7x''L9daygD8:10hr[!, x, day]
hh_mm_ss_ff(`Parsesb0ngs0the)
m HH[:MM[:SS[.fff[fff]]]]`len_sts2lenQyP_compiC[0, 7 po0C) in range(0, 3^dDif (h- pos) < 2$UAlete TonentL7[ ]][pos:pos+2a1A+= 2qnext_chv	7"1]	%!if8,!or< >=Zbreak:b:[	cRD1w ifd  <i4if .microsecondcos += $remaindev *iM_-4in (3, 6^,I	on-[3Gg
== 3:
       time_comps[3] *= 1000

 vreturn "

def _parse_isoformat_!q(tstr):81# F supported is HH[:MM[:SS[.fff[fff]]]][+HHHlen_str = lena if2< 2taise ValueError('I too short')`# Thisequivalent to re.search('[+-]', , but fastertz_pos = .find('-') + 1 or6+)82imeX"[:Hr-1] if 
 > 0 elseEi$ =hh_mm_ss_ff( .zi = Nonet	Z5'tz{":]AT#P"id@zone strings areF!# 2alen: 5~%0:SS%8%&1fff(%&15() not in (5, 8, 15;M   r0Male</tzn
:-if all(x == 0 for xDtUE.utcZ[tzsign = -1!Bstr[P - 1]r2'-'.1$;1d =delta(hours=[0], minute51],Cgsecond02E=cro#3]hC
C* td)t.append(tzis
# Just2Typ%he arg isn'ta.check_tzname(0if [DB andhsinstanc2,R7l("tzinfo.e1) m[Y orCoing, "y"'%s'" % typ}U))

#the offset-producing method, "utc"	"dst".
#1what it h ed&If!HR,|%s 7|,Vs#E}!ed8 bein range- Ifis, its integer v=!  WdButc_|,cassertW7n (;!, 9iL7z,x?	?%s(;0~3imenot '%s'" % (name, type(offset)))
    if not -timedelta(1) < %8 < :26&raise ValueError("%s()=%s, must be strictly between ">B	"hours=24) and?" %Jc(name,))

def _check_date_fields(year, month, day) = _index%&)6dayIVMINYEAR <= Z`<= MAXo
K'+Gin %d..%d' % (Q,G!),Yu1o	/12k	'lc1..12'W0dimdays_in_3	&}o<= dim|	&
z2dimJareturnp	', minute, second4cro
Cfold.@G%mih!&,0t/23,	&-0..23', TV/59V	(
X 59@ZZ(ZZ%_9k
h;#qin (0, 1
.^either 0 or 1', Xl|
zinfo_arg(tzif tz isANoneisinstance(tz, t=64Typ" argumentVsor of aG subclass"71mpe4x, "bcan't compare '%s' to"tPx).__#__ydivide_and_round(a, b2"""q a by b'&p resultthe nearest integer
PWhen Pratioo1exavhalf-wa4two<!s,=8Deven?1ed.""""# Based omeference implen for divmod_D# in Objects/longo".ccPq, r h67up if either r / b > 0.5, or r == and q is odd.
    # The expression0@)equivalent to 2 * r > b ifsDpositive,"<"@negamar *= 24greater_than_half =Z> 0 else r < b2>if 5C== b% 2 == 1:3qq += 1
return q


class timedelta0P"""Re
he difference between two date; objects._Supported operators:- add, subtractx- unary plus, min"ab]- compareu8multiply, divide by intu Invfition,ss/off5Ving a,p1add_hOarEy?B givRKCa: (days, second3cro).  Why?  Because Ilfelt like itx1"""__slots__ = '_[S', '_P&miahashcode'Udef __new__(clsYEys=0D1=0,{Smilliu0AnuteFAhour	weeks=0):@# Do4this efficientlyccuratel  Cg.2o bUicult#7error-prone, dudubiquitous overflow possibilities8thaNC double doesn't have enough bits of precifDto rj:~ 10K years faithfully. 0 he@ries GmakeOexplicit w'go-fast assumpaPs can!@relin, in order toK gu_0the]mplement; it's way more convoluw speed-KPignorTauto-d-to-long idiomatic Python could be#XXX Check  all inputs + inqer floa9Final valu8Rteger+%s`us fit32-bit signedbas; d icboundeO?d = s = u07# Normalize everythtP%*7QI;tes*60 + KU*3600+	_8+= I*100pGet rid^f3ionn,# Take a deep bh %if isinstance60day{i = _math.modf5)        daysecondsfrac, dayswhole = _math.modf(day& * (24.*3600.))
 nassertGP= intA^)  # can't overflowM/s 7	%r& =0
dJYelse:MZ= 0.0!! =isinstanceDv, floatu1;abs*g) <= 1p*[,GLs?P24 * #0 isfreferenced again before redefinition
;7if |
8

<5
+#" +xJ#B .	bs}lp.(VD#, civmod(A, 24kd]ks5)d"? * paausdoubGoe * 1e60) < 2.1e6	exact value not criticalC#\_tSmicro	
y" = round(%+ W	.2= dA, 10B:5,:


O(, #dD"j, int)
        assert abs(s) <= 3 * 24 * 3600
 'microsecond2u 3.1e6
*# Just a little bit of carrying possible for LS and X.O, us = divmod(7A, 10)44 +=Jgdays, E`s, 24*:d:*isinstance(d, int5"s"0U4s  9:Yraise OverflowError("timedelta # is too large: %d" % d)l
self = object.__new__(cls#!._N5= dK = sL = u hashcode = -1<preturn ]def __repr__()
0arg%[]?!if;)3-.append("=T0GJ"	MPU'	Z	_@not U6'0'2g"%s.%s(%s)_.__class__.__module__,aJD9qualnam;', '.join()/stPmm, s-|sF, 60ghh, mmXm Fr"%d:%026eJ9
dplural(n%j!n,qn) != 1:"s" or ""]("%d day%s, _G)) +q
Ws + ".%06N2sctotal_e(@"""T  in the duration."\(E. * 86400Celf.f) * 10**6 +U2) /-# Read-only field accessor@propertyZ
pPSV Y^microseconds""3"
 return self._microseconds
#def __add__($, other):Dif isinstance(, timedelta)-# for CPython compatibility, we cannot use`7our __class__ here, but need a realu	<._days +,7w	#._:=_B)NotImplemented1__r$ =?sub-&:&Br6-C43neg /# #&)
>posRH/ab,#if*?6< 0-KwOelse'r3mulf7intl 7#<" *49CLfloa6cusec =)to(Pba, b =.as_integer_ratio,
	0, 0, _divide_and_round( * \)o?-
):
        return ((self._days * (24*3600) + seconds) * 10K +
 +Tmicro0
%def __floordiv__n, other):#Kif not isinstance(", (int, timedelta)48return NotImplementedVcusec =8to_%()'/ifysr["///._]?intvy(0, 0, g)SOtrueR(OfloaYXM_divide_and_round(j<ca, b =as_integer_ratiolC1b *I, a)?modK	Glr# %rE?div60q, Sn,}y44q# Comparisons of objects with/eq4;2cmpre) == 0Oelser1/leK<-tL?+g?L>= 0
        eglse:
 return NotImplemented
#def __gt__(self, other)@if isinstance(, timedelta)piJR._cmp0Q) > 0n$eISoassert
xN._getstate()Z) Chash"2if Icode == -1<" -l
n,
7Nbool7Ydays != 0 or^[osecond&
Xmicro+# Pickle support.Wi/,@auporeduce
_class__OE))

f.min =4(-9)&)ax&Z=)9, hours=23, minutes=59y]
T{resolutio	6A1)

C dat"""ConcreteS typeConstructors:__new__()@from$SstampStoday ordinal(YOperaQ@reprq__str__YB__eq#letg@, __!52add&r
sub__ (add/ only withC argdMethodStuple&toFweek5iso, isocalendar2isoformatKc\CstrfProperties (readyear, month, day01"""__slots__ = '_+Q', '_.
1day4'/Pcls, ;fQ=Nonek
9 2@Argu5FRMquired, base 1Q,Aif (@ is A andoe(bytes, str))/P len()r4	B1 <= ord$`[2:3])'12j	E
n
G>try5! =}0.en('latin1')except Uni)E/_Error\# More inive error message.
 raise ValueError(&9"Failed to encode latin1 string when unpickl"Ja date object. *Ne.load(data,|Ring='') is assumed.")vdself =i__new__(cls'.__setstate(year"AhashI= -1ipreturn pF, month, day = _check_q_fieldsl&xM# ._i0 = }}" =;day1# Additional constructors
@classmethoddef fromtimestampQ, t):bCG "1 a POSIX :a (like.F()).Dy, m, d, hh, mm, ss, weekday, j0dst=`.local
&(t|Ccls(P)Ptodayi (.=t	+pordinal8, n/""hproleptic Gregorian H.January 1 ofu  1P1.  Only theA and5arenon-zero in0fresult-""ord2ymd(n&isoformat *`output=.Q().if not isinstance"e_l,<q^3Typ': argument must beC'
@6tryRassert len{u) == 10**_parse_	Aexcept E:ionbf'Invalid ^`ing: {M4!r}N isRendart]"3ISO*q number7day@This8pinverse2cal`) func&`# YearDPboundUTway because 9999-12-3\(v, 52, 5x\MINYEAR <MAXYEAR:
       $raise ValueError(f"Year is out of range: {year}")

8	   if not 0 < week < 53:&qout_of_Bv = True?!"if;-==<`# ISO ys have 530s in them onstarting with aKThursday and leap:on a Wedne'
B`first_E= _ymd2ord(, 1, 1) % 79Kif (=o= 4 or3
B@_is_:)))5NFals%G)qInvalid0: {!3:< 8WSday: {day} (Cis [1, 7])# Now compute offset from (Yvin daysCday_+0= (  -p* 7 + (# Calculah`rdinalW for monday,% 1h1 = _isof1(&@ord_s=OA_1 +return cls(*_ord2ymd(;)# Conversions to stringEdef __repr__(self32""":t6cformal=,72().J]p>>> dt tetime(2010r&;5dt)2'da3.	<, 0, 0)'j, tzinfo=zone.utcj%W.`'5""""%s.%s(%d, Q)" % q.__class__.__module__,AW	AqualnamCu_month2day# XXX These shouldn't depend on Y`.local
(), becaus!atq# clipspusable [1970 .. 2038).  AtBst cP3 isEeasily done, us:Cstrf.-- that's better tooH."%c", ...)5e specific.
vsRzSstylet.V7@B.too{(sLx %s %2d 00: %04d" % (
   _DAYNAMES[weekday],
   _MONTH"self._month&Rday, ayear)
Jdef strftime(q, fmt):k"Format using+5)."#return _wrap_Mvbwtuple()|1__f`/__~if not isinstance(fmt,	raise TypeError("must be+,D%s" % typD).__name__)`if lenbf) != 0b$.,@1str2isoYB"""RXthe date )ted accordwrto ISO.This is 'YYYY-MM-DD'Referencesk
- http://www.w3.org/TR/NOTE-y	-	cl.cam.ac.uk/~mgk25/iso-2U.html7-"""%04d-%02 ._
3day<_OU__ = B# Read-only fiel-aessors@propertyny90""" (1-9999)yYrZ[/12Y%Z?dayX0dayV/31V2dayT# Standard conversions, __eq__#letgg=# __hash__ (and helpers[.``local ' ( compatible with.&%(]PbuildAuct_&mF
-820, (-1oz/alproleptic Gregorian 5 ^!,  <7dayJanuary 1 of +  1P1.  OFb valuecontribute to{qresult."_ymd2ordJdreplac-S=None1day

Ra new9specified(s.i.0is z' =#if89:86x
p )(&&, # Comparisons of date objects with other.

    def __eq__(self,!):!if isinstance(;g, date$(preturn ER._cmp+e) == 0M%NotImplemented/leF<tGgG>gG>Zdoasserty, m, d =Syear,Tmonth
6day52, m2, d2 =""._9#._:;(}U), (yS())Chash{bu"Hash."#if/@codeh&-1(&._" ._getstate())U
7# Computations;3adda"Add a. to a timedeltaa)otoordinal() +Edays.if 0 < o <= _MAXORDINAL&)Atype d).frombo#-aise OverflowError("result out of range"7`1__rCQ = __
^?sub^""Subtract twogTs, ors an~K9.""Av& +"(-x161	%t	&(7@1 - 2(rweekday%""R0day@the *, where Mont ... Su6{\. + 6) % 7# Day-of-the-f 	w1accgX2ISO>isoweekday(self):
 "Return day of the week, where Mon== 1 ... SuC7."
D # 1-Jan-0001 is a8!reself.toordinal() % 7 or 7
*def isocalendar(/!):j$""a named tuple containing ISO year, number, andBday.kPThe first7C(Mon-Sun)Bu&2#'sOThursday; everythelse derivesFfrom thatSis 1;P	Gis 7;> algorithm taken lyhttp://www.phys.uu.nl/~vgent/C/E.htm>(used with permission)&""0 =  ._
&#1m`W _iso(+R!to _ymd2ordP,\Tmonth
6day=# InternallyRhave origin 0,= divmod(-6, 7d!ifF < 0eU -= 1^/ =0$elZ>= 522if >~:+1)1+' =BS_IsoCADate!+12+1)# Pickle suppor`_getst?Fyhi, ylo !6256tbytes([9/<2]),(_s, stringO4 = yhi * 256 +zreduce__r.__class__0))

_date"(ate  # so functions w/ argsU"1" can get atc 

C.minK@(1, )$ax9999, 12, 31`resolus = timedelta(days=
dr tzinfo"""Abstract base #1forA` zone /#es
1Sub*es must override<(), utcoffset()" ds
methods.__slots__ = (!tzMG, dtF3 ->2`c1imeCraise NotImplementedError("# s')"	      "datet!ime -> timedelta, positive for east of UTC, nega%we3"
 raise NotImplementedError("tzinfo subclass mu@verride utcoffset()")
Pdef dst(self, dt):jp"""dateBDST >? as.bKReturn 0 if Hnot in effect. include the1./""0	fromutc inQlocal&."1if sinstance(dt, 8t-CType) requires a=P argu%")cif dt.!is|hDValui5*3pdtoff =^L
x"is Nonep
@non-=	
x"resultB# Se@long com% block atZ0endwthis fil%an# explanation*algorithmRdtdstMB2\ S~|!- 	t
adt += :*P<L.n	?T:6gave inconsistent Y`s; canL`converre# Pickle support__reduce__getinitargs = getattr%W, "__A__",	!
xR`(9;els4/$getstate
Mk"-
Fdictv1 or2if ;_1.__0__,s	8,qA)


P	 IsoCalendarDate(tuple):
new__(cls, year, weekgday, /!|super().__=(> week, weekday))

    @propertydef year(self):&preturn ?[0]:Oweek:	1:
?day=	2=__reduce__2,# This code is intended to pickle the object without making&# class public. See https://bugs.python.org/msg352381>/(tuple, ,y.pr@0f'{s1.____.__name__}'m0f'(=3`[0]}, 13day
2]})')


_IsoCalendarDate = M
delr_tzinfo2 = !

R timeAq"""Timeob zone.FConstructors:__new__(YOpera re5, __str__
`__eq__#letggbhash__kdMethody@strf!()Sisoformatutcoffse tz ds8PRies (readonlyLhour, minute, second4cro
Fa, foldO1"""__slots__ = '_JR', '_MC%miSV 
f'{Pcls, c =0
a
`_=None, *#=07"""ArgumentywCbquired " (defaultFzero.	!! (keyword /, Nif (isinstance((bytes, str)) and len`) == 6B1ord[0:1])&0x7F < 24>'2# PysupportD=if ?>try! =0.en!('latin1'+)except Uni)E/_Error\p# More .PPive e. message.araise Value\(&*R"Fail qwhen unQ:""a"/. *Ne.load(data, |Eing=9assumed."G# =>cls'.__setstateJ or Y$._B = -        return self
 hour, minute, second4cro
fold = _check_time_fields(FMJ)5Qzinfo_arg(t" = object.__new__(cls# ._|0 = _="._# =# =%miA(2 = 	hashcode = -1[Dretu# Read-only y accessors @property1def(!):0""" (0-23)"""qJ
WLY[/59[&]]]
&]bg9		*	k>Pzone F5b	!=# Standard conversions, ____ (and helpers)4Comparisons of s with other./wa__eq__,if isinstance(;,T$	4cmp+allow_mixed=True) == 07FelseINotImplemented/leD?) <-tG5+g5G>5,g5G>5*(, WFalseoassert,AmytzClf._)!otd._tzinfo
        myoff = otsNone

 if mytz is ottz: base_compare = True Jelse.iself.utcoffset()3S_other&yZ	*
return _cmp((r_hour, dminuteysecond,52cro,)-(o
pED (&mirJ0is 3 or
if allow_mixed+2 # arbitrary non-zero val0	raise TypeError("cannot Anaive and awQftimes"myhhmm =s * 60 +C" - //Abdelta(6s=1N#otNIO6" -;P$O= Dhmm,
def __hash__)"""Hash.""",#if3code == -15%?foltreplace('&=0aC	;+ tz?= t0if /)Q:  # ~!or	LP (t._getstate()[0]0h, vvdivmod(U2!s=h", 0
A) - W*1)&aassertFm % 3l, "whole@_m //=;
Bif 0 <= h < 24KyFf@ime(7.
E2"=
kg
L1# Conversion to string`_tzstr^RIformatted^Rzone  (+xx:xx)an empty_	_i_]W(off)__reprt to formal string, for repr()."""
 if self._microsecond != 0:#*s = ", %dR" % (61,D)?%eld._	[ZF/ses= "%s.%s(0%s)M_class__.__module__,\;qualnam=Fhourvnute, stzinfo is not Nonassert s[-1:] == ")s[:-1] +Q0=%r<JfoldatC'=1]return s
kdef isoformat, timespec='auto')B"""R?1the(	matted according to ISO.b	The full.S'HH:MM:SS.m+zz:zz'. By default, ffractionalO@partD1omiz0/K== 0"opH argument Qifiessnumber of addi5}Pterms+include. Valid jbs are E0, 'w&s'0'mi|Rs', 'Tmillig and '5s'.3k__ ._t
[bX
|-Ctz =iftzstr(Vif tz<]us += tz
__str__ =C@)amethod<Ffrom2clsD:ingConstruct a =`outputL
isinstance(`gW, strlraise TypeError('m^:~pmust beC"')@:try6&cls(*_parse_O)except E;ionVCValuQf'Inv^ging: {b0!r}@strfsW, fmtA"""F\0 us-@).  Qdate !ofKpstamp po underlyIq shouldbe used"#oTyear y>= 1000 else Python's` imple(ab# can a bogus k6ion|tuple = (1900, 1, 1,
         self._hour, dminutesecond,
40, 1, -1)return _wrap_strftime(Yp, fmt, qtuple)
5def __format__*!):kif not isinstance(J7str%)raise TypeError("must be str,D%s" % typD).__name__`if lenbf) != 0b.6fmt@1str# Timezone functionsutcoffset3sB"""Rr1the;C-1 asdelta, positive east of UTCCa (nega%weU)."""$#iftzinfo is None9=?.-!_check_utc_9%("+2", /P3 tz0+.<Note that VP100% ional --"re's no requiremen9%at)it mean anything in particular. For example, "GMT", "UTCV-500"^@"-5:B "ED'S/Eastern.America/New York" are all valid replies.2"7
/ds0 if DSTn effect, or( (
	Wward)TiP@Thispjpurely;t
has already been added to`3UTC eed by (applicab# sojwL!ne\ consult <) unless you're interestedpdisplay5DSTM&<(%?dst$acT=a", 

Xmicro=True, *, fold=bQa new|Q withvalues fspecified fieldsji
bF#if8 :<f second is wNone:
 second = self.!if microN is A!FK`tzinfoF;TruA<@fold:8_
7return type()(hour, minute, ", { , J=!)
Q# Pickle support.def _getstatf, protocol=3)lus2, us3 = divmod'._,a, 256)n0us1222D	$h_;"ifE andF > 3gh += 128=Abase = bytes([h- lf;A:O&3]p(,A;elsC.c*_sdstring#if1notQ
isinstance(d2, _	g_classIraise TypeError("bad_qFarg"v [if h > 127
.5= 1/Ji = h -q/$O = 0J2 = (((us1 << 8) | us2)
3<_# =8_reduce_ex__\%$__)6b_UT&2)

_timejime  # so functions w/ args named "1" can get at the R 

C.minK@(0, )$axb23, 599$`resoluy+gdelta(qs=1)


rP dateu(	0"""0yeaTonth, day[, B[X-[]dj"[,]fGThe Oh0dayuments are required. may be q, or an5T of a,1sub . mremainingcNQints.H1"""__slots__Fate. + new__(cls,=3day
4$=05
^1=0,~)IH*0    if (isinstance(year, (bytes, str)) and lenp) == 10'
 1 <= ord%[2:3])&0x7FI12):-# Pickle supportif isinst
C{>try1 = , 'latin1')l-except UnicodeEnOrror\# More informative e. message.aeraise ValueE.(&*"Failed to e ing when unpA"Ja datetime object. .Re.load(data,Eing== is assumed."Kdself =i__new__(cls'.__setstatp_month)@hashY = -1preturn w!, M, day = _check_	s_fields&xhour, minute, second4cro
FfoldW\WJ{ tzYR_arg("a# ._0 = " ="/;day0 = (O11# =G%miTA(2 = 	64# Read-only  accessors @propert1def(b0""" (0-23)""eq ._$
WLY[/59[&]]]
&]bg9		*	k2zonF5b	!=classmethod%P_fromPstamp, t, utc, tz:Construct @ a POSIX Ia (like.B()).sA
 may be passed in as well    """
    
    frac, t = _math.modf(t)
us = round(+f * 1e6if us >= 10:9=it += 1Eus -."elI<< 0B.(U!usVo%0
converterptime.gm Ztc else _`.local
=y, m, d, hh, mm, ss, weekday, j ds&g%s%@min(7059)	# clamp out leap secondsthe platform has themQresull?ls(ius, tztz is NoneA## As of version 2015f max fold in IANA database is23 hours at 1969-09-30 13:00:00BKwajalein.<Let's probe 24H in
 past to detect a transition@max__A=LW* 360On Windows __ran OSError for negative values,thus we can't perOH?eTL lesD2thax%G. See commentsIP_date |module'Hof this method@moreJails`if t <
Gand sys..startswith("win")brreturn |7 = /- -Y)[:6]w,19|;:-s@1 - Mdelta(0,	{(m.days h+: //{.1)R2:"ifC2 ==). 
3+ = tz.fromutc(lb@classS@def @~stamp(cl=["""Constru@ a POSIXLIa (like.^F()).Azone info obj\`may ber!sea&ll(1"""0_check_tzCP_arg(kZcls._t1not)#:utcB& na0UTC)'.	romtimestamp(t, True, None)

    @classmethoddef now(cls, tz=,:0"Construct a datetime from 
.() and optional zone info."MPt = _27return cls.[#Pstamp/tz	3utc)?UTC;utc	rcombine[<,g=/kqa givenl#it isinstance(H0, __qraise TypeError("* argument must be W%")s,s1ss tzB1 is=m.ja.year,Xc.monthEday,4UR.hours.minute
csecond
SmicroJq, fold=W
O	zisoformatUw_string/""	he output of}YF).""!tW, stry%Q':Cstr'@# Split this ae separatorIadstr =e[0:10]!t!B11:]h:try7componentseparse_F({except ValuB
U(f'Invalid WEaing: {8!r}0if 
]
Oime_(O:#,CKelse
E[0, *+)^tuple(self""R4loc( Katible with].&L'()~ dsYV.dst(^0if !is
E= -1"el/'&CI 0
        return _build_struct_time(self.year, Smonthoday,
 85houCSinuteDosecondGQdst)
oudef _mk!):B"""Rinteger POSIX ,stamp.""".epoch = date"(1970, 1, 1)%`max_fos = 24 * 3600%At = ,1 - VA) //v`delta(VSwlocal(uy, m, d, hh, mm, sp.2eu)[:6]}9r(J)
O# Our goal is to solve (u) for u.3Ba = tetu1 = t - at-ug0if 6= t# We found one
ution, but it may not be the$vwe needHALookan earlierO` (if ``g0), orBQlaterc
/*1)lu2 = u1 + (-?,, !)["}
bV u2W%u2Eif a == b1%u11Jelse(^Wt1 - &<assert a != b@t22*1*4hav
both offsets a and brneithert2 no
Eb is5# a.  This means t!inI6gap(max, min(u1, u2)
n as float"ifpp_tzinfo;Non<2s +LRmicroqe / 1e6< - _EPOCH).total_D's(0utcBtupl51UTC & compatible with0.gmG6()." =2utc(#if

3 -=Q2	V.9FX7, 0Q~I W part*o;'.___day)

    def time(self):
 "Return the time part, with tzinfo None."2r1Mp.hour, Xs.minute
csecond
TmicroQfold=1
!)
\1def/tzCsame:$_ , breplackp, year=Ds, month3day
@
uP >
Pm=True,I*"a new datevalues for#specified fields.""!if1 is4eA" ='"if738
9?day7m8day3n4568:<<<<A!FK F#
A<:?
:86'"yp	 )(p, day, f", 2(0B6
,{Hp_local_3zon"if$tsv0_mkI%()FelseN. - _EPOCH) //bdelta(6s=1GQtm = .X+ts&% ="(*(Vm[:6]'# Extract TZ,agmtoff = 8B.tm_#%
!0ime(
P0),   as,_if tzz'Melif not isinstance(tzihraise TypeError("tz argument must be an J  oI"F5mytC*8boffset = 5B.utcF,"my):tcoffset(selGf)
 if myoffset is None:!,mytz = self.replace(tzinfo=1)._local_timezone(dCe = NB.utc(V%)
tPif tz'
areturn0# Convert
 to UTC, and attach the new   object.tautc = % -)'tzx@fromu|Qtz's 
oc0tz./sutc(utcO`# Ways?produce a string.Pdef c)""Rt) style<"tweekdaytoordinal() % 7 or 7,@"%s 2d %02d: %04d" % (3_DAYNAMES[m*], RMONTH"{._month&:day=Qhour,._minuteosecond4CyearfEisoformatI?ap='T',spec='auto'c"eH Cqted accKg3ISOThe full. looks like 'YYYY-MM-DD HH:MM:SS.m'2By default,fractional part#@omit"ifRmicro
W == 0I#=1not^BUTC Calso?ed, giving) a/of	+'#Oppargumen p Qifiesseparator between date,)8 'Tcog2glnumber of addif@ermsto include. Valid jbs are F0, '&s''Rs', 'Tmilli' 's&""s"-!%c2#lfo
bu sep) +" _$ ._8B	j)04offD}7(of4Srs += tz@s
__repr__
S"tolT, 78().RL = [u # These'never zeroIy__]Hif L[-1]:
            del L[-1]
 "ife == 0:-s = "%s.%s(%s)" % (self.__class__.__module__,LP
6qualnam8
", ".join(map(str, L)))k2if [tzinfo is not Noneassert s[-1:]5")"Fs[:-1] + ", Q0=%r	d(+ <Ofoldt,C'=1return s
def __str__)oP"Convto string, for6().Qisoformat(sep=' ')g@emethodxstrptime(cls, dateh7mat'mat -> new5C parsed from aing (like  .lA)).'pimport w.
_SZutcoffse'lfB"""R"thRzone -1 asdelta positive east of UTC (nega!wevUTC).""M~J=.._check_utc_9%("+#",eq+1 tz
.+.<Note that TP100% ional --"0re' requiremen9%atit mean anythO ingticular. For example, "GMTY0UTCV-500"@"-5:B "ED'S/Eastern.America/New York" are all valid replies.2"n7
/ds0 if DSTXin effect, or( (	Wward)TP@Thispjpurely;t
has already been added to`eed by (applicab# sojwL!ne\ consult <) unless you're interested in display5DSTM&<offset = self._tzinfo.dst(self)
 
_check_utc_offset("dst", )creturn
@# Comparisons of datetime objects with other.3def __eq__,!):Pif isinstance(;,X(,T._cmp/allow_mixed=True) == 0celif notieNotImplementedL&seXFalse/leH?) <WkYerror	tKVgK>ygK>wMW(, S&_asserNEpmytz = [1._tK!ot
myoff = ot3Non^t1if Z0is F
abase_c@e = t,eli2utc(p&# Assume thatBb meanswe are called from q(if@
 !]replace(fold=').JNX2#if!
hi)=q2offf*
 _cmp((self._year, self._month
oday,
 16hou=Tinute>osecondARmicro,)-s(other.
%
m () if myoff is None or ot:+Rif allow_mixed return 2 # arbitrary non-zero valuePOelseFaise TypeError("cannot compare naive and awdatetimes"# XXX What fos could be dmore efficiently...adiff =]" -A # this will take offsets into accountF0if I.days < 0+%-1041!0
 def __add__(,)Tt"Add a Ba timedelta."H0if Nisinstance,-W1NotImplementedO_& =>.toordinal(!    s= ._ .0	00	#5\"+=	 rem = divmod(*.zvs, 3600G 5grem, 6)rif 0 < MN= _MAXORDINALAtype).combine(T.fromR
VQ(
Y	=y]s?ctzinfo6
)Xr?OverflowCresult out of range")\1__rY$ =ct?subtSubtract two{ s,+kin`A + -!#n1	!#2 "EsecsC_+]"._Dd * 60 ^! *-gE2 = other._se
cond + other._minute * 60hour * 3600
 
base = timedelta(days1 - %2,(/1sec(( lfQcrose-)iPif se3tzinfo is/:*preturn rmyoff =Gutcoffset(c"ot!,"3if F!= .v3is None or;Caise TypeError("cannot mix naive andzone-aware"-
def __hash__(V)hcode == -1!_%Jfoldtereplace('&=0%Oelse;' tzO= t."2if %eY. (t._getstate()[0] = _ymd2ord@b.year,ZSmonth:daySs%~# +C	5	L		as	Vlf.mi_" -9=u07# Pickle support.NG9, protocol=3[yhi, ylo = divmo<_=6256us2, us3++, 21222D	$mt_N_aJ > 3Mm += 128=dB = bytes([3, mtO_day5 _2C
"us3)x1(,%.c)$_sastring, *]
isinstance(:2, _	g_classgrG3bads 7arg3( )q=f > 127.5= 1/i = m -self._fold = 70
 self._month = myear = yhi * 256 + ylo%microsecond = (((us1 << 8) | us2)
3<tzinfo = 	
def __reduce_ex__(, protocol):'qreturn !.__class__, 1._getstate(:)b_UD	2)


datetime.min = @(1, )!(ax!9999, 12, 31, 23, 59'99:resolutiobmgdelta(k1s=1,isoweek1monday(# Helper to calculate the day number ofM> starting S! 1k# XXX This could be done more efficiently.THURSDAY = Pfirstq= _ymd2ord1$s((+ 6) % 7  # Seeq) abover85 = ;-"da)if4 > U0NA+= 7cj1


p timezone({__slots__ = '_offset', '_name'ntinel valuedisallow Nonp_Omitte^object()(new__(cls, e , b=6dif not isinstance(2c.2raise TypeError("1P musta:"6h@ame /4ls.b%#ot
pqcls.utc& =  elu
(_, str
)kstring0ot C_min#<=3 <="ax
EVF) "	"ctly between -(hours=24) andJ8.@_creG`J@amethod0c5.__L#.? rj=!linitargsX"""pickle support""#ifVn!is	.US#eqh, othe)if,!t self._offset == other._offset
 return NotImplemented
def __hash__(self)::7X);Nrepr;
"""Convert to formal string, 72().Jm>>> tz = timezone.utc35tz)P'date/.4' 5	S((delta(hours=-5), 'EST'V6
k"k(U-1, 68400V"&""0if k1 isv
z
H`._nameNONoneJ"%s.%s(%r)" % _class__.__module__,'._=@qual?v/, },l	/st, tz(92utcG, dt{if isinstance(dt, o) or dt
v
aise TypeError("`) argu must be aq ""3zS_froml0
8r:7B1dst43sBy?utc
if dt.tzinfo1not
&DValu:BCD"is f"OAdt +J\(`>_maxoffset = time(delta(hours=24, microseconds=-1)
    _minoffset = -_max
@staticmethoddef _name_from_-(k!):"Vqif not return 'UTC'/+q < time'(0P:sign = '-8-	SJelsez@+@P, resbdivmod,&2=1)1t|minutes:H9'	;! =v.$))if
e (fg{!}{s:02d}:{Hf'.{f:06d}'4if E<)C0'

>zone.utc =_create( ((0))
# bpo-37642: These attrib are rounded to the nea @ for backwards
# compatibility, even though>0constructor will accept a wider range of
# values. This may chaiQe future. mi	-0=23W=59))B/ax1A_EPOCH = dateo(1970, 1ptzinfo=utc)

# Some  algebra.  For aL x, let
#M0 x.x stripped of itsHG!--Bnaiv^.:Po = x), and assuming that doesn't rai@n excion orK CNone1x.dcOdst(]@s]'s standar, x.o - x.d
#
# Now s\derived rulwhere k is^@urat!).?!1.P+2s +Vfollows adefiniJbof x.sEq2. If x`@y haPhe sap membery:hctually a requirementpuwmake abou,Rsane }s classe3T"e #1UTC= correspond0o x*p[oGJgain-a w4. (x+k). x.+"  	U #2dP.=0tz+ preservese5ek).n = x.n +: k
#    Again follows from how arithmetic is defined.
#
# Now we can expl?0tz.:utc(x).  Let's assume in interesting case
# (mean4that the various tzinfo methods exist, and don't blow up or return
ne when called)The function wants to6 a datetime y with zone tz, equivalent4`x.
# xalready in UTCh`By #3,e+ay.n - y.o = x.n1[1]8Aalgo starts by attach1znH`y.  SoP.n = ^J@.  T%&it0add1ura&k]ay, so  becomes true;eeffect5solve [2] for k:   (y+k)


"[2Rp1, thisu same asWX3s +l,d)q&[3W#5,'"+ k, which1als0+ k@ause=L
# Substitu/into [3],K-u$s 
d;'terms cancel, leavingk6
@0; rearranging,-=m;E$#40s =s6'y._!On4RHS:d
e computed directly, but F#"bewapproximateYry ignore d  at first.  Notekw
# very large, since all offset-ZCof magnitud@lessgn 24 hours.  Fortbson, if yQfirml1std5must
# be 0[it has no consequeBthenCaIn anye new value i  z! +cK"[4Iqhelpfultep backi1loo2[4]a higher level: simply
# mapp[Q@tz'sBndarAis point?Rzz5we have an#imf ar@most(e insecurity herLQ] of daylight.  Picture US Easter&rcretenes awall
#8S jumpG@1:59C3:00Zq~form 2:MM't make good
# sens#en0docUk%an-Pclasssider such atbe EDT (becau^se it's "after 2"), which is a redundant spelling of 1:MM EST
# on the day DST starts.  We want to return the9Nbecause that's
#'Fonly# makes senset6local wall clock.
#
# In fact, if [5] holds at this point, we do havepstandard-timey`,
# bu9>Pa bitRprooffirst prove a stronger result#h
# difference betwee?LHS and RHS^[5]?  Let1   8 = x.n - (z@z.o)1[6]8QNow
#0=
cby [4])(y + y.s).n 1Sby #5(2y.n)
&@  si"2[2zfy are ame tzinfo membery.s = z.s 21z.s"PPluggcback into [6] give&\' =EB- ((qz.s) - 4expanding0.'0s +-Bcanc]1'1z.d$So%3z.dis true now,$0, so z.d = 0 too,~w{%
#=Bed iendcase described above0e'rkn
Contrarily$if,nWa UTC equivalealso done>notB!= 0	he offsetpneed to
# ad	 z (in effeBzDz's $ $T3we BP shif*Be
# Ot@daylight@) z'2z +
"[7	we can again ask whether7"z'.3'.oB"[8YPIf so'aIf notRclass%sane, accor thassumptions we've madTr rep_As before, le `comput1e!N@8] (+Pskipp0somnjustifica0for` kindssubstitu severalalready):|7()  replac#Avia 	E@- z'xEw E
E- (z.n + x.n - (z.n - z.o)'H=
# x#)%+ 5 + z'.o =0cancel x.nA`n+Io7;AzA5;  #1 twice|0z.s".dusd=
z and z' have same tzinfoLBz'.dLp
#
# So4is UTC-equivalent to x iffh%z.d at this point.  If they are equal,
# we've foundX!so/@doneB	n fact, we stop with [7]
# return z', not botheringqcompute.How could d differ? 0= z; .dd, so merely movWz' by
# a dst() offset,` start%*from* a time already in DST (we knowQ!= 0)to changecresultn2s: 3artVlittle fur	 into it takes us out of
There isn't a sane case wt	can happen.  The closestXgets is at
#3end`,D`ere's F0our2UTCno spell=in a hybridLb classUS Eastern, that's 5:MMG@ = 0qEST = 1pDT.  DuOhat hour, onK"ck3!is'sn as bestandardp(6:MM
#t) becausdocs insistaR, butZqdayligh9/ (4BUTC)g no local@mapp%to-%#
#`jumps  1:59 back1:00 again9qrepeats7#  i	p.  SincywO2thewua*does*"wa)1map3M$MMZmbiguous
#;
`sgoes -- i1way/clock worksWhen x =F8Ainpu	algorithm, x.o=0, y.o=-5Py.d=0Pso z= . =60 (minutes)nO@[5] !iAholdDeep going.
#3the=p = -60 S[8]
# (correctly) conclude atd!is6 Bsaid z wa `(else w"he !pe"n)i!!= U(8]<U nd8O), and there are only 2 possible values dst() can
# return in Eastern, it follows that z'.d must be 0 (which it is in the example,
# but the reasoning doesn't depend on  e30 --qsre being
# twooutcomes, one zero andother non-).  Therefore
# z'in standard time,C!isFPspellpwe wantthis case.
#
# Note agaa$
not UTC-equivalent as farhybrid tzinfo class is
# concerned (becausePtakes"as	1 ra1thaW
# daylight we intend 	0), rrit givereal-life "locallock repeats an hour" behavior when mappM1"un?Pable"
2oz?W7/Pinput;6:MM, z=1:MMRz.d=0we stop at ',y@withT1he 6
wy`So how break?  One ofassumptions/violatedQwSilities:1) [2] effectively sayZPat y.p invariS	across all y belong to a"  @zonew isHtrue if, for poBcal q@s orNtinental drift   a region decidpo changnPs basfset from7"2)I0 maQ vers!pof "dou]x"wpQPtail Pof
# he analysiss up a step too early.  I have0hou@abou`"atK en:2sayaIn any's cleartbdefaulPutc()0strPPhandl6p"almostqs:  so aQ!ofCiomatter if`transi|t pointsy o n, or
#Bis skipped,1ome/ s;P
RlargeL smd@get din its bounds;4it L!ev0som50per$e1js a nega"Sg{
# pretty bizarraD2subGcan overridefis.

try:
MP_date import *
except IRError0pass
elsep# Cleanunused names[del (_DAYNAMES, S_BEFORE_MONTH&INPI100Y I4	JP _DI4@EPOC:MAXORDINAL, ?hbuild_struct_timDe,
 _check_date_fields, 5tim
1tzinfo_arg0Uznameutc_offset"mpXerrorz@clasydays_before_month, _Dyear#in#pformat_3, _index, _is_leaisoweek1monday, _mathord2ymd, T[_wrap_strf%, _ymd2ordPdivide_and_rounYparse_iso<, _T hh_mm_ss_ff, _IsoCalendarDate)/,# XXX Since import * above excludes names that start with _# docstring do.ot get overwritten. In the future, it may beappropriate to maintain a single module levelq3andB0remePollowQline.!@from- te*__doc__

try:(decimal'*B1d
<__version__F	libmpdec.except IE:pydi
#'R"""
Mdifflib -- helpers for computdeltas between objects.

Function=`_closep`ches(w( possibilities, n=3, cutoff=0.6)Use SequenceMatcherRreturn list ofbest "good enough" m1	context_S(a, bhqFor twoRsS3s, k!a C in D D8matn\RB:$ er;`a` and `b` ()brestore(s, whichl0one?sBgenerated an dunified)*D)CA flexible g^laBpairof any type.

[bDifferR`produchuman-readad@!s #0of ii,X@Html\ZHTML side by#barison`change highligh$h
__all__ = ['get+A', '	'   'Differ','IS_C	HARACTER_JUNK', 'IS_LINEcontext_diff',
 'unified  '#`_bytesIQHtmlD5 'Match']

from heapq import nlargest as _
(collections.amedtuple02Etype,GenericAlias

U = _n4(, 'a b size')

def _calculate_ratio(mes, length):
#ifreturn 2.0 * 6# /'5"1.0

class SequenceAer:
(1""" is a flexible B	for comparing pairs of sY
L@any %, so longG5the* elements are hashable.  The basicHlgorithm predat2and
little fancier than, an a5Cpublished in n 1980's by Ratcliff XObershelp undTeEhyperbolic   "Kalt patternHing"P ideaqto findK onA eiguousAD subOt%ains no "junkA(R-O doesn't address ()Fsamehen applierecursively to"PpiecesAleft./Qright!of2!!is not yield minimal ediCnR, but/@tend}3#a"look "#rpeople.Atrieute a "human-friendly \" between two.  Unlike e.g. UNIX(tm)7,Pfunda al1ionhH*1* &_-free;at's wha&cqs' eyes(e Windows0wina another interesting no,&up@that.ear uniqu&uin each.G@Thatdmethod here,A$to0oreauitive= erI resn3is Yaappear!berleast vulnerLLsto syncon blockKp lines"aough (Rblank1 inIordinary @ filor maybe "
"1R HTML$ at(" b`becaus#isT onlyE3t 0cept* of" Example,`two stspconside CQ|>>> s =1(lambda x: x == " "0...  "private Thread currentT;",
    ...
"private volatile 8F)FA>>>
	2.ratio() returns a float in [0, 1], measuring the "similarity" ofJsequences.  AHQrule !uumb, a lvalue over 0.6`.nsH are close matches:>>> print(round(sYB, 3)Q0.866
If you're only interestedPwhere uuAget_ing_blocks() is handyAfor  V/s.8:"a[%d] and b
n O%d elements" %^4a[03"0]281j4a[8'(17(,21)$29*(38*0)S0Not/!at4last tupleGoed by 6always aLdummy, (len(a), qb), 0),@this5}@case_UwhichL/ (numbers&!ed"0.Q want to know howPchangue first Ao}bsecond)2useopcodes()(@%6s :	7 equal a[0:8] b
insert a[8Q8:17]3 8:b[17:38]"SeDiffer classW	a fancy human-friendly fmd-1r, icuses SMar both\0ompsof lines2o c#L	'characters within q (near-?Bing)Qalso function dtcmodule` shows im` build-oncan be used doful workTiming:  Basic R-Ocubic time,1st !@quadexpected%-. ;is 6ZR wo7m1hasHU-behavior dependen a@licaF`way on!R manyF(!A havcommon; be!is1ar.E2"""def __init__(self, isjunk=None, a='', bAautoRTrue)ra"""Construct a() Op X#rggj  (9default), or a one-arguEg th+0akeTyreturns true iff the
 element is junk.  Nonepequivalto passing "lambda x: 0", i.e.L3no Os are considered to bebFor example,YBax in " \\t""qif you'^@mparlines as sequences of characters, and don'tH@wantsynch up on blanks or hard tabs.
2Optional arg a"the firsto7two coued.  ByIpdefault empty stf.  TheCof a must;hashable.  Sealso .set_seqs()?1()bosecondFb2autojunk should"!sePFalse0dis1	"8Qmatic heuristic" that treats populara(see module docuCa for more infork6on)#6"""R# Members:Y7# abb*+; differ`mputed, "w,doERwe ne doH0'a'change it into 'b'?\# b2jJ b,0[x]uCa li2h& di(U,b)Dat which x appears;
cdo not*Kfullbcoun#2& ==:0 nu gimes xWCb; only materialized if reallyWed (usedF813 utpquick_rW(()matching_blocksKa(i, j, k) triples, where a[i:i+k] == b[j:j+k];HPscend& non-overlappAin ikin j; terminaZbca dummy (len(a), b), 0) sentinel|oopcode	tag, i1, i2, j1, j2) tu]tag iD'ofl'replace'  W1:i2][@d by0_1:j2]GQdeletFG
`insertb7;Qequal:u       # isjSunk
 #'a user-supplied function taking a sequence element andF`return0true iff th2is "junk" -- this hasDsubtle but helpful effects 	he algorithm, which I'llGget around to writup someday <0.9 wink>.<DON'T USE!  Only __chain_b&s.  Use "in self.bK[items in b for isA is TrueH|popularK2non3Otreated as !byheuristic (ifEd).
O"= 	
3a ={ = None1utoo3= a
!set_seqs(a, b)zEdef !, :;a"""Set5twosbe compared>>> s = SMatcher()T".x"abcd", "bcde"'Wratio=E0.75J2"""@V61(aI/2( 1(#O, a)UfirstThe second-Znot chang6/, #(	m/1(e51.0d6>>>d@utes caches detailed informan abouGX*, so if you wantg^0 onYS againstJEmanyr s,\ 	`2(S) o2and call61(x$1rep!lybeach o9Vother` Ses\)	62()C	@if aw&.au#J = amWing_blockq*`opcode:2b
i"2(4	O[uence, so if you want to compare one sequence S against
 Emany s, use .set_seq2(S) o8and callE1(x)Drepeatedly for each of the other`%.
5See also m@s() gE1().,6"""9if b is self.b:%ereturn#J = bmatching_blocks =M`opcodeJNone3fullbcount = __chain_b()4# Felement x in b,p b2j[x]da list0indices i# b where x appears;X(in increasing order; note tha#5anumberkFimesTTBlen(B) ..#n"`isjunk*defined, s don't show up in thisJ
# map at all, which stopscentral find_longest_s methodDfrom start%
a	2b2js@does" contain ~1ies"popular" , meaning`2 ac1morvn 1 + 1%lhe totalP$an0whe%0is onably large (>= 200B)Uis ca(e viewed as an adaptive0ionPsemi-,iQyield,tenormouqspeedups, e.g.,Ngprogram files with hundreds of"c anBof "w NULL;"&VAonlyi!ed` b chaA; socross-produc1kin~ 
es, it's besX2,u1Fdef M)o`# Beca/a?#r- (not C) functionxbwe tes#c a LOTcimportpminimiz\&e sJ2BefPe tridescribed G, was by far
9 motime-consumrroutinee whole module!  If anyjeGpJim Rossrank him0proI.py -- I never woul!Ghave guessedupThe firGto buildg` ignorpossibility`!of3.  I.e., we a  yet.  ThrowE!utIPlatermuch cheapeh"anw"right"b
.b2j = b2j =c {}

 for i, elt in enumerate(b):$+indices = b2j.setdefault(elt, [])..append(i)q# Purge junk elements=aself.b=#f= set(_#is+?2if 
[keys(> $}A.add#xe%: # sepaN loop avoidspist of 	JN0delj^[elt]=upopular@ that are not8Q'b1&= 

Xn = len(bk!f >@auto and n >= 200bntest = n // 100 + 1`, idxskOitem,A) > ^
qT(ditto; as fast 1% deletionbdef find_longest_match(,, alo=0, ahi=None, bbX"""Find G G0ing3 ck%a[alo:ahi]|b[blo:bhi].3By  it willJ theZQentirety|aXOI1 isNdefined:rReturn (i,j,k) suchp[i:i+k];	equal to b[j:j+k], where`alo <= i +k9ahi#b#jj#b#all (i',j',k') meetJthose condi)s,\k)k'
e[ == i', 'In other words,Zll maxima0tchblocks, rB1one9starts earliQQin a,0of XLKy} ub@>>> SequenceM2er(" abcd", "
B<.,0, 5, 0, 9-Y (a>b=4, size=5;	~, firsto& i_`determ@abovu7tBe ad*al restric8Z5 no !arYr.  Then9xtended a0farpossible by	a(only)on both sides.  SQresulwnever matches on 
junk except as identical #
 happens to be adjacent	an "interesting" match.
;Here's the same examplembefore, but considering blankmHjunk.  That prevents " abcd" fromz@l!at{EtailKaend ofsecond sequence directly.  Instead only,"l5canJR, and~eleftmost 3!inAm:%>>> s = SMEer(lambda x: x==" ",,[)H.find_longest_(0, 5, 0, 9-e(a=1, b=0, size=4)If no blocks, return (alo,G, 0)ANone&c"121-00 6"""# CAUTION:  stripp`commonBfix or suf
PwouldPincor.Vw# E.g.,[   abcL7yG0 is":if 'isTped, it'7" (tied with "b").  UNIX(tm) diff does soE, so ends up claimtJ abqchangedgcab byCPinserc "ca" cmiddle's minimalunintuitive:I"obvious" someone eed "ac" Xfront1Win(XAplacV"`aby paiS'up unique 'b'sFthen"first two 'a'sa, b, b2j, isb = self.a,b$'.__contains__`if ahi%1{v= len(aOif b11b1b , j7 =  # ? ?R-free'!duZan iterationVloop, j2len[j] 0gthXHAbaa[i-1]Eb[j]6[U = {}@noth86= [(Pfor irJahi)f`# lookv0all`tances@a[i]@rb; noteubecause{#@ has3a keys,skipped Xs_	HRget =@I.get!1new$
j 2j7(,        # a[i] matches b[j]
 if j < blo:+continue9o>= bhi:]break7k = newj2len[j] = get(j-1, 0) + 17if k > bestsizerQesti,%j, = i-k+1, j

|# Extend theU# by non-junk elements on each end.  In particular,L@"pop"Caren't in b2j, which greatly speedsJinner loop above, but also means "&/"w so farG@doesvain any S*or* .CBwhili > alo and tj\0O  not isbj1(b[.A-1])<,a i-1] == .
DU	j	+b+(a < ahijb7'H+= 1Now that we have a wholly inter#ng(albeit possibly# empty!),Gmay as well suck upQ2ing/Dside of it too.  CaiPthinka good reason1to,n(itG@avest-processt(@ connrable) expens|GPfigur:Pout w"to do with itV!ca;2 anD
C, this is clearlyPright1ng ebecause no other kindOKe	regionsr-n.I
'j=utreturn M_(()def get_ing_blocks(self)B"""RT@listtriples describD subsequences.hbEach triple is of the form (i, j, n), and means that
 4a[i:i+n] == b[j:j+n].  The triples are monotonically increasing in
J! idin j.  New in Python 2.5, it's also guaranteed5 ifM(i', j', n')adjacent!inAlistIsecond is not($as<%;then i+n != i' orIjj'.  IOW, never describe UequalHblocks.
dls a dummy, (len(a), Sb), 0iee onlyI with n==0d>>> s = SequenceMatcher(None, "abxcd"	Ecd")R7(s.get_m6Bing_&()*[Rp(a=0, bsize=2), 3=2, 5450)]~6"""&if self.::oreturn5(la, lb =__l
&b)`# Thisomost naturexpressed arecursive algorithm, bujp# at leone user bumped into extremP caseat exceeded#oon limit oir box.  So, now we maintain a H('queue`) of 1qstill no look a] append parti# results to ``iaH!p; XIsortaEend. = [(0, b1R+Nawhile D
)alo, ahi,r, bhi =(V.pop(VIrk = x =]find_longes#(S
F# a[alo:i] vs b[blo:j] unknowJq+pk] sameek(T+k:ahUPj+k:bWif k:   # 
 0,Pre wa( M%ckl.*(x*if alo <bj(LGjn+if i+k <)j?bhi_3i+kj
7bhic(IpossiblePwe haBs5theJ#cDt\"ng8t2cod+ad
o collapse them.#
 `i1 = jk0non_adjacent = []for i2, j2, k2 in matching_blocks:+e# Is this  Uto i1, j1, k1?4if i1 + = i2 and*j2dh	Yes, so collapse them --~just increasee length of}Mthe first byO3qsecond,1M#so?ened remain tmpare ag-t.Lk1 += k2Oelse5Noto.  Remember(k1==0 means it's^dummy we started with)1makq 6?theL4new ^if k1n.append((U-))} Y(me>+ (la, lb, 0) [self.9 = list(map(MT ._W(, Xreturn K
def get_opcodes(*)KB"""RCw of 5-tuples describing how to ka into b.`QEach 60 isD	orm (tag,/e2).  T[7J0has=2= 0Z)/cs have)lpi2 fromK*p preced:"itLlikewise =7)vious j2Ptags strings,5!se1:'replace':  a[i1:i2] should be d by b[j1:j2Ya'delet;<d<0Notat j1==juFcase3p'insertSed at&1]=hp_i1==ipQequaloQU2] ==|9>>> a = "qabxcd"bjabycdfs = Sequence2er(None, a, bnE(s.&"0...print(("%7s a[%d:%d] (%s) b5" %:>+  H)  a[0:1] (qnf0:0] (!  b a[1:3] (ab&2replace a[3:4] (x) b[2:3] (y)
 equal a[4:6] (cd'23:5(insert a[6(&5
fME"""
2
if self.opcodes is not None:%ireturn- i = j = 0	T= answer = []#for ai, bj, size i^get_matching_blocks()'# invariant:  we've pumped out correct diffs to change{# a[:i] into b[:j], and the next  = is?`ai:ai+] == b[bj:bjp.  So wL edBa!0 a[VR!],B
move (i,j) beyo*	Btag = ''if i < aijj < bj@;zreplaceB%elD9_delet8q
pnif tagkw.append( (tag, i,wjz&) !i,"	##{list of&@terminated by a=sentinel with7f''Ij@def `grouped_(W, n=3i""" IsolateA clusters1eliPing r_sno"s.tR>a generator=7 uppn linescontext.@QEach 3!insame format as z)>>> from pprint importn&@a = (map(str,v(1,40));,0b =RP[8:8]@'i']	 # Make an 9iontb[20] += 'x'1 3 mLment423:2if4he3eyeonotherk4(SequenceM0er(5`,a,b).{c15[[(`5, 8, R), (''898, 11, 9, 12)], SP16, 1"g7, 20)%3 ('E'# 20#K, 21'p!2!K, 23%]Pe', 2"n3&K@7, 3p%6    [('equal', 31, 34, 27, 30),
 ('replace'P4, 35#3'Pequal%!8!T5)]]ME"""

codes = self.get_op%()#qif not :a = [("wr", 0, 1)r
# Fixup leading and trail
groups if they show no changes.q"if[0][0] == 'u'tag, i1, i2, j1, j2 =:NL 6Bmax(:2-n)AE%j2A/-1&&-1$R-1] =@min(0i1+j6+n)nn = n + n]i6for]YRRj2 in&
O0# Ehe current S	start a new one whenever~#re is a large r_ with6'ag4i2-i1 > nn2.append((>)FRyield	f
PnPj1 = 4
!i24c*-nmMG ,j2"ifQ(len(BA)==1
),def ratio(."""Return a measure o sequences' similarity (floatIv[0,1]).pWhere Tthe total numberTelements<Fbotha,dMA;matches, this2.0*M / T;Note that%1pi  adenticalwU 0 if|@haveh2Gmmon.K)expensiv computex@you In't alreadydoing_blocks() or ,4which case ]5mayHwant to try .quick_LZreal_Afirs3Vget aLupper bound@>>> ASMr(None, "abcd", "bcde"6,E0.75
#	).51.0	_um(triple[$^u0r*_calculatef3ISa) + f.b))

    def quick_ratio(self):
 
"""Return an upper bound on 1) relativelyJEly.
AThis isn't defined beyond that it is\.]U, andMis faster to compute.6"""x# viewing aC
 b as multisets, set matchesMthe cardinalityT# of their intersection; t`counts p number.VCwithout regardoorder, so{clearly@0if a.fullbr5FNone%'= 2E= {}R.for elt in^bM#qh[elt] Q.get(elt, 0) + 1\	t%# avail[x]|?times x appearsq'b' lesiD4we've seenWPn 'a'cfar ... kinda@ Ehas,=.__contains__, 0EFaF"if@0has-X` ff[;els4j	@W! =' -L"if:> 0% =r_calculateB6Q, lenO .a#2b))def real_,?verzbn either X or .)la, lb ='4%b)@# ca@have moreKthan~PelemeiE@shor;sequence2in(), la + lb__class_getitem__ = method(GenericAlias)


get_close_"(word, possibilities, n=3, cutoff=0.64"""Use SM@list~Mbest "good enough"2yz$a 
 awhich 1 are desired (typical>sstring)V	_g@s agF"t l"toi Sd ?hsi Opal arg n (default 3)vqmaximum	 to
    retuPrn.  n must be > 0.

    Optional arg cutoff (default 0.6) is a float in [0, 1].  PossibilitiesKthat don't score at least similar to word are ignoredThe best (no mBthan n) matches among the pLreturnedin a list, sorted by 2ityd, mostc first>>> get_close_("appel", ["ape", l	Ppeachpuppy"])['apple', 'ape']\import key3s _#1whe,0.kwlHwhileBA%",n
B;oaccept<0'ex 2"""`if not n >  0:wraise ValueError(": %r" % (n,)Hd0.0 <=_<= 1.V
i0.0,7]e%j0res2= [s = SequenceM"r(s.set_seq2(Pfor x*	521(x2
if s.real_quick_ratio() >Uand \@_   s.+
P.cnd((s.0R, x))a# Move| rsqhead ofpO = _nlargest(n, r# Strip s 5ZnL1 [x%v,aPp]


def	ep_original_ws(s, tag_s)"""Replace whitesp1ith:characters0`s`0''.join(Ac ifuc == " " Ac.isnr() else"5cch6zip&)



class Differr'Tomparing ss!ne	Ptext,d`produc.human-readable drs or deltas. 3 us$0 boZ1o ce}A#	ewithina(near-ing) linesAEacha begins N a two-letter code:@'- 'Xp unique! 1"/'+*2* *`commonT)Ys.?.Dppresent#either inputYL	nning with '
? ' attempt to guide the eyeBintraline
    differences, and were not present in either input sequence.  These LsMcan be confusing ifzs3stain tab characters.
?0NotAat D makes no claimproduce a *minimal*P.  TolI coCry, %$s are often counter-intuitive, becausey synchLup anywhpossible, sometimes accidental matches 100 pagQpart.HRestrict^p pointseiguousD~Arvesk notion ofLlocality, at occasional cost of *na longerkExample: Compar'two textFirst we set uph ,siindividual 0le- "ng0endbwith new ws (suchK=@alsoB ob&ped fromzQ`read=()` method!fiuke objects):Q1>>>1 = '''  1. Beautiful is better than ugly...   2. Explicit+"im/@3. Se- cojx,!4.x?lex-ficated1'''.splitkeepends=True)@len(14q[0][-1]A'\n'	72 !3%e$m5. Fla{?nes@Nextinstantiat@c203d ="()FVwhen Ga-{hmay pass func0filo@out p 'junk'.  SeeV.__init__ for detailsFinally,sd7tworesult = list(d.**,#2)'-'a1^` let'sptty-pritnpcmport Bas _
z(v ['A\n',H? '-30O+   2?7 ++5HM3  ^
---- ^\n',
     '+   4. Complicated is better than cex.\n',
  '?c++++ ^
^4i|5. Flatb`nesteda!]
b"As a single multi-line string it looks like this:7>>> print(''.join(result), end="")^1. BeautifulQugly.*-   2. Exii4&it-@3. SeTEWO3.  ,k!++9/exd</  a---- ^]]Fa.ex]
]'2"""def __init__(self, junk=None, char!):?C%Construct a text differencer, with optional filters.>vThe two#keyword parame. are for>P funcPG4- `E`: A$^t should accepargumentyO and return true iff th s  . module-levely+  `IS_LINE_JUNK` may be used to1out}s2wvisibleI acA, exat most op('#').  INrecommendedMto leavev ;punderly@SequMatcher class hasKan adaptive no of "noise"`s'any staticL0def1ion`authorp ever been able;WcraftL0- `#of length 1CHARACTER
NwhitespaceW (a blank or tab; **note**: bad ideahinclud
0new  i)0is!0Usez:IS_d\.Tajunk =
!b! =!"N3areMGa, b5rnvsdss; generat{1e rbWdeltaTEach @	 must contain individualsQTWs. SuXPs can obZqed fromQ`read()` methoe   of file-l.ike objects.  The delta generated also consists of newline-
 atermin-
strings, ready to be prinJs-is via the writeI%()J`methodea file-l%.
'Example:2>>>g$(''.join(Differ().compare('one\ntwo\nthree\n'.splits(True),c3...0'orQK?emuP)Rfend=""U- onezE?  ^
O+ orU- two)!- 6?  V+ treGU+ emu*6"""Hcruncher = SequenceMat`(self.,junk, a, bfor tag, alo, ahi, b
tbhi in W.get_opcodes():d ifB == 'replace'!%Ag = s_fancy_*)(az}>'ele_deletddump('-'Soinsert
S_+', b_equalR .seL
raise ValueError('unknownp%r' % (9))
yield from gQdef _,AP, x, 'hiC"""GZ ison results Ga same-tagged range.$U(c$e'%s %sS x[i]UplainCI@ as  <@ ande < bhi* # pshorter%ck first -- reduces#burden on --TKpmemory "heHPs are+avery dent sizes; if  -4-0\/('
ksecond2*,elr@r
'g|j", ?
'

[r0Whe0ing ckEs with anotherBarchFlock*similar* <;(Pest-mbpair (if any) is us5s asynch point, and intraline difference marking is done on the
 similar pair. Lots of work, but oftenuth it.
9Example:>>> d = D}%()+%results = d._fancy_replace(['abcDefghiJkl\n'], 0, 1,A3...AxdefGhijA
print(''.join(), end="",(- ?{0^  +,z,6""",#'t synch up unless s have a ity score%atj# least cutoff; best_ratio trackR?seen so farE5,I = 0.74,5(cruncher = Sequ_0Mat(self.charjunkLeqi, eqj = None,   # 1st indiceqSequal(if any).search for#q that ms without bedenticalD# (im0mus0 c, & weuwant toK"on5$--"we&toj in range(blo, bhi):JXb"Ib[j]p.set_seq2(bjZ8^i^a^a^*ai = a[ibnzi == bj`if eqiA$(Ii, j vcontinuJ1(ai&# computis expensive,1use(]quick# upper bounds first --!this speed_messyFares by a factor/3.-0not1at  ()QFonlyiTu*eKtime it's called3a s;F par5J#3theU6n`cached
4if a.real_jEA() >m and \B E@-Uz"i,I(), "if+n# <.
h# no non-k"pretty close"	b
SO0eit-- treat it as a straight replace
 yield from self._plain_/(a, alo, ahi, b, b
Mbhi)Iireturn# no close pair, but an identical -- synch up on thatGPbest_1j, ratio = eqi, eqj, 1.07Uelse:# there's aso forget z(if anyeqi = None
bA# a[i] very similar to b0j];1 is<@ iffsvy're no#`pump out diffs`beforeFAFpoinJ
fancy_helperf)|do intraline markingey5air
@aeltFlt =,	*(ifa '-', '?+p?' quad0ed s_atags = b)""cruncher.set_seqs(
for tag, ai1`2, bj1U2 in Iget_opcodes()`la, lbBi2 -M bj9bj1. iftS == ''S)+= '^' * laK&&b&'elsodeleter-r	LoinsertL+L_equalK	 K	
&qBA
raise ValueError('unknownp%r' % (*)A
wqformatr!, ,?}WW	wp'  ' + 
%# cVVafterV UP+$4R9Ydef _~/, pag = []F@lo <%b:bhiGt.`
TQdump( ifL= < E	zgdef _qformat(self, aline, batags, bC):
 Er"""
Format "?" output and deal with tabs.
/Example:>>> d = Differ()+results = d._qfl('\tabcDefghiJkl\n', rdefGhijI3...`'  ^ ^G

@for C in : print(repr()35...='- C? \t6\n'+55 = _keep_original_ws(!).rstrip|9!9yield "- " +O1if pJw1Qf"? {F}\n"!"+O|OOO0# WBrespect to junk, an earlier version of ndiff simply refused to
# *start* a match aM element.  The  was cases like this:
#q beforeAvate Thread current;,pafter: m,volatil5If you consider whitespace!be, the longest,tiguous 
# not s2ing7_ is "{c".  SoAreported
# th$#e "@inse  between1't'B0'e'k@"prip".
# Whan accur8Pview,Ppeopldat's absurdU
# looks bblocksare entirely,Q-free1n extend*eJ@0one=those as farpossible but onlyIvR7Cow ""l+)ed} suck up9
# preced@ank;%n >	KJmfollowJ;fV)lys-e # "V"`quibbl]`remainipat perhaps itE`reallyh"iAe"
#'lJ.  I can live.

im re

def IS_LINE_JUNK, pat=re.compile(r"\s*(?:#\s*)?$").@<Return True`ignora(F : ``blank orains a single '#'`\s]@	B'\n'vH>>> IS_LINE_
JUNK('  #   \n')
    True	>>> IS_LINE_*Uhello)BFals*A"""
3return pat(line) is not None

defQCHARACTERVch, ws=" \t"):GQRP for ignorable character: iff `ch`ma space or tab.Examples:/' (/\t)R){xR)ch in ws


#4I  Unified Diff]2_format_range_ui(start, stop'Convert ) to the "ed"Amat'
Q# Perdspec at http://www.unix.org/singls x_(ification/Jbeginning = @ + 1o0 # s`number(Pwith &alength<Bop --Y4if 2= 12R'{}'.(u!if(>9&3 -= Rempty0!s % just before-U,,)_m(a, b, fromfile='', to1datn- Q n=3,j`term='Rr6PCompawo sequences of6s; generatdelta as a   s U0a c_`ct wayU@showA chs and a fewcontext.  The #Dset by 'n' whichGdefaults3ree3By , S3rolSq(those ---, +++,0@@)`rcreated&pa trail0new ishelpful soat inputsE P.read@s() resul0e`s thatQ suit1forH;Twrite<since bothtj0outU haveFs*Fz!do:	8 4 , OnSargument%""( will bePTormlyS& f1uni  nQlly h`headerHBnameY5modtimes.  Any0allUthese may@ed u0 sts^C'tB', 'r
~', and 'tofiled:ate'.
    The modification times are normally expressed in the ISO 8601 f#1t.
KExample:0>>>P line8unified_diff('one two three four'.split(),M0...a'zero 72 'Original', 'Current'I2005-01-26 23:30:5062010-04-02 10:20:52Bterm=''):`print( )	# doctest: +NORMALIZE_WHITESPACEID--- 9,C+++ + ,@@ -1,4 +!@@+R
W	C-two	Q+tree

2"""_check_types(a, b, fromfile, to5dat*J)Vstarted = Falstfor groupCSequenceMatcher(None,a,b).get_'ed_opcodes(nsif not bb = Truv = '\t{}'.f(E) if else ''G!toI$GEpyield '& {}
P,z^D>B}@first, last =C[0],
7-1]*le1_range = _8_(N2[1]Q2[2]]2/?3?4?{} +{} @@^ , 
k4or tag, i1, i2, j1, j2s
N if- == 'equal'!orBa[i1:i2]&*A ' +2kcontinin {'replacedelete'}ke-xoinsertx
ob[j1:j	+x?

#4I  Context Diff]2[

defAext(vc, stop'Convert 5t`e "ed"H2matQQ# PerJ spec at http://www.unix.org/singleox_specification/
    beginning = start + 1 # lines`number(with one?alength<Bop --rif not !:Wp#-=i   # empty ranges1 at just before the%Q#if`V <= 1ereturn '{}'.format(x):",%,+d- 1)

# See http://www.unix.org/single_'_specification/
def context_diff(a, b, fromfile='', to-)8dat-An=3,-term='\n')Ar"""OPCompaAwo sequences of6s; generatbdelta as a #.
K s U'mpact wayU@show,B2 chand a fewFr.  The hD is set by 'n' whichGdefaults to three3By ,53rolSq(those *** or ---)[rcreated!pa trail0new ishelpful sat inputsE P.read@s() resul0M@that suitable forH;Twrite<since botht e0outU haveFs%3For z!do	8 4,iSargument%""( will be uni$lyS& f+@at nQlly h`headerMPnames5modt times.  Any0allUthese may@ed uD stsb'yB', '
~ ',~.Hexpressed inISO 8601~2matJII~TblankExample:>>> print(''.join(l'one\ntwo\nD\nfour\n'.splits(True),3...r'zero\n@?ree: 'OriginalECurrent')Sbend=""6zC--- ;*P 1,4  Q! two!.   `<A---- + 	G"re<k)_check_types4o_prefix = dict(insert='+ ', dele-
replace='!equal='  'Fed = False
    for group in SequenceMatcher(None,a,b).get_'ed_opcodes(n):
 if not startedu = True3
fromdate = '\t{}'.format(@fileX) if  else ''K to,
I)toGEyield '*** {}
,k, lineterm)D<---D}", @Afirst, last =C[0],
5-1]*g*5' +
,`1_rangj_d_context(z2[1]}6[2]k@ {} q3ile\if any(tagb{'replace', 'delete'} etag, _-qe21or +bi1, i20-
y0 if/ != 'insert'$(Ka[i1:i2]*.prefix[tag]w
s2c? = s	3s4sE[ ----s\ss#`j1, j2(%s$Esob[j1:js#
def _check_types(a, b, *args>0# C Aing # is weird, but the alternativegarbled output whenO"# someone passes mixed bytes and str to {unified,`}_diff(). E.g.KQwitho1is ,W0namVs_presults{2likQ0#  &` b'old;B.txt!+++ b'newbecause of how) incorporarobjectsisinstance(a3str}raise TypeError('ls)compare must be,L%s (%r)' %.F(p@).__.@__, )Oif bb\p!ar+SY0rg, X
\all argumentsY: %r' % (arg,) )

def diff_bytes(dfunc, a, b, fromfile=b'', to*
 )9dat-n=3, lineterm=b'\n'):GAr"""	Compare `a` and `b`, two sequences ofDs represented as q ratherLthan str. This is a wrapper for ``, which typically eiGunified_!() or context. Inputs losslessly&0ver!tostrings so that	 only has to worry about0,	qencodedI@back-on returnnecessary&cSas withEpunknowninconsistent iing. All o" i(except `n`) must beL{wce#(s?2try
B s.d-'ascii', 'surrogateescape')`4AttributeError:err^msg = ('all argumentsB, not %s (%r)' %fj(type(s).__name__, s)&raise TypQ(msg)L2 era = list(map(3, aGbbj2 = 8(*"(4
&$H!)
7sQ(PLbmn/rU2 inQyield./e(;	nVjunk=None, charIS_CHARACTER_JUNK	  (#);	 a `Differ`-style delta.0Optional keyword param/4s ``xCfiltpK s,pcan be :i-)D: A .t should aca single6 true iff th.0is eP.  ThPfaultj%isGcommended;Dunderlying SMatcher class4an adaptiv 0ion'q"noise"sc-']racter (OCleng=B  1))s ?
*module-level
wSs outEwhitespaces (a blank@tab;e: it's a bad idea to
 
include newline in this!).

!Tools/scripts/ndiff.py is a command-9front-end toC functionJExample:X@>>> M1 = U('one\ntwo\nthree\n'.split^s(keepends=True),0...0'orD>?emuC
)Cprint(''.join(), end=""%Q- one/A?  ^	K+ orQ- two!- A?  -	R+ tre3Q+ emu1"""return Differ(junk, char
).compare(a, b)

def _mP(from2Ss, to	context=None, Fq4`=IS_CHARACTER_JUNK):(Qr"""Rs generator yielding marked up /to side byserencesArguments_6s -- list of sKW9 be5<k>!>`numberyto display on each!ofN2if u5alltwill beM1ed.s`passedu"toS (see1docBa[={EThis ss an itVwhich1 tu~	boolean flag)+6B numh,0num*Pintegrk (to indicateg separ&G-- originalext with followrs insertedIP'\0+'as starQadded`+O'\0-/_delet1^1_chang1101of /e/<O$s N , #Feither "" or "to"]F1ain50, o-wise False 	/%asly developoJ{Gfile for makHTML pages\@Html~a class*eJTusageZNote, utilizes th;e#Y'Qpup.  Op#ala8@ may@%lLqa1heyXupassed to ndiff.
    """import re
## regular expression for finding intraline change 1ces>_re = re.compile(r'(\++|\-+|\^+)')lcreate the difference iterator to gen
$o4_%s_40= nQ(from2,tojunk,char	def _makeK(' s,mat_key, side, num"s=[0,0]):LReturns > of text with user's.markup and+formatting.PEs -- listN,(produce aW%ofQD.  When 4dl'Ato r,qL-sd are removed ^@ thi"sti|M3'+'^b first"in5d"add" -^roundZaentireKx/'-xodelete{??{Badd/~/G#(t obtainCsecoj)O0Non#noDwo)$0(0=V,1=toIB /to currennumber.  TL`is NOTePendedEbe a	passed parametE`It is aas a keywor0gum/toO@mainRq memory!/hes between call	function@Noten4is urposefully not def!atrmodule scope sthat data it needs0itsg(tin whose con%it$iswa) doesUGof mf[>e] += 1b# Handle case where nobr|
0to dded, jus ##Pallowd usage& if)5r.+ (,Ps.pop(0)[2:]
 of	ZC
j== '?',)Qers =w, lines.pop(0)'
 # find intraline changes (storq type a)dices in tuples)Osub_info = []def record_%(match_object,=	)):A.append([B.group(1)[0],zspan()]Pyreturn -F	}_re.sub({,marker# process each. inserting our special @s that won't be~# noticed by an xml/html escaper..for key,(begin,end)reversed(E`ptext = 1[0:@]+'\0'+key+@:end"1'Jend:,J2# Handle case of add/delete entire JelseZ&s.pop(0)[bA# ifHb1is just a new<, a space so there is~L`someth[the user to highlight:see ifO
X[= ' 'o$N`\0' + format_key +f + '\1|2# R
7P, fir6Allow"'sXPtVdo it6"# .(such as>:^pnumber)p`n repl#`with w &~#'s"&upyP(num_ns[side],!)
[_iterator(
"""Yields from/tos aindication.]This func0 iskP.  It0elf pullRn! aDdifferenc;=,Ue0!emxythem.  When it canL3it %both a "">aa "to"0, o@wiseBBwill86 on or+n"to09oJ,boolean flag( ed\YeL;v(s) hav*PNote,
purposefullyX defined atmodule scopK@data"3nee'v parent(+in whose con%itM$iswa) doesUb m5"""Ee	qpblanks_(ing, num_blanks_to_yield = 0, 0
 while True:2# Load up next 4 lines so we can look ahead, create strings whichNare a concatenation of the first character@each{Pdo some very readable comparisons.;Alen(Z) < 4.append(a(diff__iterator, 'X'))_s = ''.join([/q[0] for@1 in*s]5if s.startswith(W# When no moreI, pump out anmaining blank$9the# correspond3add/delet\ get a match S? soN1allqa pairs>sQed atIj levelAnum_b	9ingy-el;o-?+?')>simple intras.nga _make),'?',0),11),E	zcontinuf?-++3in block, add @ing:do NOT want to}
# caught)on"yet, just processw,
M] -= 1(M-MONone:+('--?+', '--? ')I and see an or unchanged
>m~1^t
@Afrom_1,to/ =['
B,0> = 6-1,HiA$BH?A</DOFROMyzyield _make_Pline(s,'-',0), None, True
 kcontin
elif s.startswith('+--'):?# in add block, delete coming: we do NOT want to getKcaught up on blank  yet, just process thew 
JAnum_?s_pending += 1(Syield`_make_O<_+',1)6+('+ ', '+-')=will be leavaM": 
AfromA, to	/ =
C61to_|,J.= I+1,0PA?Xside ,/' unchanged textiPboth s6x A[:],<0),1),Falss# Catchkifopso when!Pnext g9/top# pair,Qy areEYd up.'gwhile(<eO < 0*
('','\n'),>-Ez

PX6ireturn7Nelsew,@Adef __iterator(j@"""YsAs of 2 a  indication.
bThis func0 isk.  It itself pulls`.K	7s difference@ thaMjtKbalwaysF1s ay2/toG1s (D)@f neyqary it collect singl^YHPuntil3 hamw3
"to_@NoteYepurposefully not defined at the module scope so
 6that data it needs from its parent function (within whose context it
L is defined) does noU to be of.5"""line_iterator = _%())As,toe=[],[] while True:# Collecting 9until we have a/to pairD\U(len()==0 or )~>tryLC, to	found_diff = next("Aexcept StopIG?ionoireturnA!if;NonG*s.append(=,)$ifePcag# Once, remove them
# con and yield8DZpop(0.v<?do$orJ!)
	# Handle case where user|Ewanterencing, justL0up `out do 0any@g eld0ith3m_Y	%if:is R
VsZp.  We msdo someJastorag%s know for sur( at0y a"ed\A+= 1j:a_to_write = 0FQStore
Fs upufind a  e,da[z# circular queue becauae onlypkeep ariF whaF"we*dindex,PLines0, [3]*(6
 r = FalsQ(%"is&QD	
V/1 = )$ %*	e(Bg[i] = M&, c+= 1
          +  # Yield lines that we have collected so far, but first y5'
 # the user's separator.$if index > context: OZg None,
'_to_write =Q	)Nelseb
;	9I = 0jwhile(C)d3i =%aI+= 1b$L=[i]&
, -JR# NowPRafterYhange_[_->try#Pfrom_lC, to	found_diff = nextn_pair_iteW)J# If another cr withins, extendO6if rs++M
$!?	except StopIE>ion# Catch .@ion c) and return normallyd 


_file_templa4"""


<&Aead>`%(2s)s&/Q>
q!
_E@s = =!  =.d{font-family:Courier; border:medium;}=4_er {backgr-color:#e00*td26-align:right*(X c0.?add-laaffaa-?chg-lffff77-?sub-Paaaa}K!
_E%< class="fB" id
lib_chg_%(prefix);pb cellspacing="0"Dpaddprules="yBps" x1col5>
%(data3s)s}3 """ _legend =  class="diff" summary="L.7s">xr> ! nos"=""9' \ % (idt_, Create unique anchor . esmP# Gen ?e a0Hmultiple tZ# can existBsameApage"ouVlicts'1 =  %d_" % HtmlDiff._default&to8/to6Wff._default_prefix += 1 # store es so line format method has access:bself._8 = [from2,to !] .def _convert_flags(=,2qlist,to context,num1s):H"""Makes ) of "next"Rks"""r*+# all anchor names will be generated using the unique "to" t0 = #[1n0pro  change $s,kfmiddle columnfs/link]0_idX'']*len(Q)%Ohref' um_chg, in_= 0, FalseMlast = 0`for i,v in enum4!if 6not}"&6TruiA# at`beginnrCof a, drop anq` a few7evG0# ()P) bef.!orvpreviouMi = max([0,i-]id[i] = ' id="difflib_%s_%d"' % (CP3Ak to#in {W_[0="#a>npW Nelse# 0eck@ casN@herere is no - nt,avoid exception0if X ]&0;*''8T  "if*xtM`%s' + \F8/ '64\n'7for i in range(len(flaglist)):'^4if ] is None$(0# mb yield% on separator  skip the bogus onesoKgenerated /QfirstD /if i > 0Ms.append(k \n<I\n')f?elsZ 0% (q_id[i], @href @from[ Xt E#toC)romdesc or to header_rown i"%s"
;?>',5olspan="2"A2er" h>w%J <<[J'table = self.__template % dictT@dataHs=''.join(s)l= #rprefix=u 7[1]pqreturn .replace('\0+','< add">').\A-A?subA^A?chgA1@/t',' ') del ref restore(delta, whichAr"""G1 oftwo sequences that !a O."Given a `` produced by `Differ.compare()` `nI()`, extract@originating 3p file 1802 (lqmeter ``), stripp06offB3#esExamples:@>>> 2 = 'one\ntwo\nthree\n'.split@(keeecs=True3...=0'orD>?emuC (dprint(Diff, 1)), end=""11oneG2two eK 2KrK"re emu """ ctry: tag = {1: "- ", 2: "+ "}[int(which)]-except KeyErrorBraise Value('unknown delta choice (must be 1 or 2): %r'Z "%  from None.prefixes = (" Atag)for line i|!if@[:2]E!~Ryield(2:] def _test())import doc, difflib}dreturn.!Cmod(# ) if __name__ == "__main__"\i """Disassembler of Python byte codto mnemonics.""" 4sys Etype collectionAio \"opV*__all__ as _/s$ @= ["F_info", "dis#tb Aco",;| "findQstart>AabelPshow_e 8get_instru`IAByte::] +:dela _havehdF.MethodType, 1FunnACode classmC, staticM ) FORMAT_VALUE = opmap[')']%_CONVERTERSq(%R, '')X(str, 'str0repascii, ') MAKE_FUNCTION *']'Q_FLAG'defaults', 'kw@anno!onclosure') nry_compile(source, 4"""Attempts to * the given 4Pfirstan expression and* 4n!ement if =pproach fails. 9Utility f!acpstringsbs that otherwis 2ectqobjectsa 4c = , 'eval'aSyntaxZOB 3xecBcdis(x=None, *, fileQdepth Bes, %s,- s,#d dWith no arguhlast traceback7C7N currently include generatorrv, async`coroutV ll` store(irIin a special attribute.qif x isadistb(sB@# Ext^,vhif hasattr(x, '__func__'): x = x.__f# Extract compiled code objects from...,if hasattr(x, '__*b # ...a Ztion, or4zw/+elM!giNa'): #KgeneratorS5R+agRn asynchronous `C`+cr` coroutine/+H # Perform the disassembly5 e__dictdClass or moduleQgitems = sorted(8.5())+for name, x1 in !#Nf isinstance(x1, _haveN+print("D of %s:" %kPfile=::try~1dis|7<, depth=Iexcept TypeError as msg]Sorry:",)%, j]0 ! !co$6# CG}_e_recursiveN[h, (bytes, array)): # Rawju1sqd0straSourceWs &seVraise("don't know how toCe %sEs" %'type(x).____) defItb(tb=None, *'""@e a eback (default: lastQ)."""if tb is Q  tb0ys.I_bDAttributP#6bRuntim K("no <!")lwhile tb.tb_next:=*(,qframe.f,/iT) # The inspect interrogates this `ionarybuild its # listFqCO_* co`ts. Itialso used by pretty_flags to # turn^#co0fie[nto a human readablek . COMPILER_FLAG_NAMES = { 1: "OPTIMIZED",2: "NEWLOCALS4: "VARARG8tKEYWORD!16?%STQ3QGENERATORQ6QbNOFREE 12PCOROUTIN 25NITERABLE_COROUTIN$E", 512: "ASYNC_GENERATOR", } def pretty_flags( ):7 """Return# representation of code 4A."""6names = []for i in range(32]1 9q = 1<") # By now, if we don't have aoQPwe caF5e xO$coxraise TypeError("vknow how e#%sAs" %ARtype(x).__s#__tDHinfomFormatted detailsq5BZ!_fA_],#co8lin9h"Name:0 %a co.co 7@File;7f;Argument countA;1arg;@Posi3al-only aK)s:0posJ /KwB /kwA `Number{locals:8Stack sizxs<FL3< l0iRWconst CSants:fi_c in enumerate(co.co_consts): lines.append("%4d: %r" % i_c)*2if @Vnames> :N"3`for i_n in enumeratIsnU1varBVariable &U'freevar"cFree v/s:U'Ocell OCellUreturn "\n".join(F) def show_cod(, *, file=Noneh"""Print details of methods, functions, or GP to *D1*. #If is not provided, the outputpfed on stdout.@1"""(c_info(co)n) _Instru = colle s.dtuple("'!",[@ "op#0 op`@ arg0valrepr offset starts_A is_jump_target".S.__doc__ = "Human read*  opIion".BN"ici; ?arg8argumentv (if any), otherwise  hargvalWResolved&a valueLYknownNpsame as(U`V 'pdescripf{ RQSj indexBwithin bytesequenceRWBLineed by thisBS C]rTrue ifmsHhere False" _OPNAME_WIDTH = 205ARG5 class +(Dfa# Defined field O - h 1 - -*" F?- r Grepr - human readable description of opera argument offset - start index4 within bytecode sequenceD;s_line - ed by this op<(if any), otherwise NonLis_jump_targrTrue if1 F!s to hereKBFalsLA""" def _disassemble(self, no_width=3, mark_as_current=J", '14):S;"""Forma2Qstruc_details for inclus6in y outputK*1* sets the  $ number field (0 omits it)** inserts a '-->'er arrow as p!ofreK&in0Fes = [] # Column: Source*)if[0if .wais not_ -1bno_fmt = "%%%dd" %bz0.append(B%}9Nelse OY' ' *D%Cuindicator!if ~ zm /F '/SJump e  '>>e.I3rom"ofn  Arepr6.).rjust()O2nam  [ op"!.lU_OPNAME_WIDTHV Oarg  4argm_OPARGY .i ! R'(' +I0arg2W + ')return ' '.join(@).rstrip() Gget_s(x, *, first=rP"""It!orls in methods, funAs or60Gen=e``serieswd tuples givingl21 of5Feach|supplieds.tEIf *e* is not No0ne, it indicates the line number that should be reported fo e first sourc=!inIdisassembled code.DOtherwise,& 9formation (if any) is taken directly fromK fr objectm1"""*co = _get__#2(x) ell_names = co.co_cellvars +@free1#Pstart1dict(findB(co)["if _not None:IT_offset =.-{a&!no5?els?0"breturnpinstrucTs_bytes(Code,c1var LL`nsts, 7J,H%,Ib) defconst_info( 0dexRlist)Kp"""Helpo get opal details about F references R5%de!nstant and itsAr ifO4antFrdefined5  h>)exa"()<aargvalQindexu"if_{c <)[{_G]H ,,(   W8d2 as both value65rep#0 :0Cp1if u([ l1arg=^ #*> * U=,s 03antn "C&=0*Iterate ov8he ` in a  string.1Gen:s a sequV of Idtuples givingqof each opcs. Addi<y@t('s runtime environme(e.g. variableAP) canKspecified us@arguRsPlabelxs (pqn=iMc, op, arg in _unpack_opargs(code):  if linestarts is not None#* _+' =2.get(offset,7)Z78if :_,)+d_ZSis_jump_target = in labels*argval =repr = ''oif arg`# Set$R to the dereferenced value ofargument whene# available, andTUpstring esentationX.N _disassemble_bytes needsOE>theAraw name index for LOAD_GLOBAL, CONST, etc = [Pif ophasconstM <,; = _get_._info(arg, JantsX(elcb-a] Ojabs])*2q"to " +?val OjrelnP+ 2 +;{9Oloca| 8G0varJ kcomparY.[= cmp_op[arg]S; ! ?fref Ocell== FORMAT_VALUEb0_CONVERTERSo & 0x3 .`, bool 2*4)?@nval[1]" $0arg!v += ', $@with1:mat-== MAKE_FUNCTION{Orp.join(sTP i, sAenumerate(Kn_FLAGS  & (1< 0B '1not+"y# ==1- 1~for x in/ co =if hasattr(x, 'Code'E@prin!%"Dy of %r:" % (x,)/:hx5d/)T=-1, &0, n ))Bants', D 6_offset=0]# Omit the number column entirely if we have no*AinfoPshow_cno = bool(qk7if &0max+97max8.values()) +wr-6if >g>= 100"Z_width = len(str(6+Felse =3x ' #0#2maxircode) - 2! 54i|PinstrQ_get_uuctions,@sGH= new_sourcehG = (OO andn .@4is =dB > 0;if Bow9s_curren2 = f"==hJ$/"no;, iX", Q )k)r, **kwargs"""Compile=& string,'n |  object."""_b_try_c`(\, ''), **kw args) disco = disassemble "# XXX For backwards compatibility def _unpack_op`(code): Qextended_arg = 0for i in range(0, len63, 2:>Pop = N1[i]:if op >= HAVE_ARGUMENTo n:h+1] | K+@ = (;b<< 8) i== EXTENDEDmS else??lse|ONoneh  Byield (i, op, argef findlabelsf"""Detect all offsetsLaa byte. which are jump targets. Return the list ofG!1""")}B = [}qy if is not ein hasjrel"# =` + 2 +T!*2#)elK?absK=arg> Tzcontinu2if "in ms.append(3)rsAinestartAFind}?lLcsourceGenerate pairs (T , 2"no st! =gR, end8il@.co_0's(/8ineA andqb != lae ! =){1pV class ByteWa"""The"0 op@ions.pa piece 'Instanti,this with a function, method, otheriled object, string ofYb, or a&R (as Ted byF3())!ItIAver s[0as !ru! iAces. _init__(self, x, *, first=, current_+;.1obj = _get__"(xYibeSV\!no,0j` ZBY+_ - cocell_namesdvars +>0reez;;]dict(%)V4originalw = x self.current_offset = c def __iter__(self):Pco = .codeobjreturn _get_instructions_bytes(co.co_5", varnames PnDrconsts,o_cell_G_linestarts,3G=E)I?repI/"{}({!r})".formatq.__class__._/__original_object@Pamethodfrom_traceback(cls, tbP""" Ccp a Byte : the given DA """_while tb.tb_nextFGtb =6Bcls(;tframe.f< =#SlastiAinfoI Ri@ted (uion about>._@_Bj1dis"a Gqview of}.AperaB "if  is not None8 6?els7%-1& with io.StringIO() as outpu_disassemble=5 Usnstants+Ds B<+9=>Rfile=k,(=) H.getvalue() Qc_test(p"""Simpest program to 0 a import argparse! 5r =.ArgumentP%"r('c.add_a @('in`', type=X .FileType('rb'), nargs='?',ault='-'X3 = _asw$.l Isource =Kile.read?= compile(*,sQ., "exec"49@) i"__ == "__main__"~ # Module doc. # Releasedthe public dom^ain 16-Jan-2001, by Tim Peters (tim@python.org). # Major enhancements and refactoring by: # Jim Fulton # 2Edward Loper # Provided as-is; use at your own risk; no warranty ),ufinal line of output9 "T9ed.". Run i]!th-v switch instea1 -v and a detailed re dof all+ps triedt , along \` assorsummaries9end. You can ce1bos e@passx@"ver`=True", or prohibit it5False". In either6 thjs, sys.argv@not @inedPk.N@ere 0a v tyJoS@ways4run8L@cludrgration@unit`1supvQnon-P text fiacontaies. Thlso many override parts of's default behaviorL!Se Library Reference Manual /s. """ __docformat 'reStructuredText en''1all![cp# 0, Op#a Flags'register_obflag',DONT_ACCEPT_TRUE_FOR_1BLANKLINENORMALIZE_WHITESPACELLIPSIS,DSKIP IGNORE_EXuION_DETAILCOMPARISON_FLAGCREPORT_UDIFF,CNONLY_FIRST_FAILURI:INGt&S_FASTq# 1. Utility Funcjeb# 2. Eu` & DocKeE'@# 3./bParser6'-4-KFind--5-CRunn-'DocTestRunner', 'OutputCheckDocTestFailure+UnexpectedExceptionDebugRunnDP# 6. EP Func,sqttestmod:5filerun_docstring_examples.# 7. Unit6 SupportWESuitLyDocFileSset_uB0_reAFflagb18. Jgingcscript_from'Usourc}dC_src'', ] imx __future__tdifflib0insqlinecache$os %pd5r%sy traceback1 C io SyIO, IncrementalNew|rDecoder3Rcolle<namedtuple Results = '(',', 'failed attempted') # There are 4 basic classes: # - ER: a pair, plus an intra-Q number.J9JD of |, parsed *%a MfF info about w6the*R came@(  ,  :no)Finder: ex3ts sEa given object'sj3andts contained*&s'*srU: runn cases, and accumulates statisticD` # So 0pic iiplist of!+-+(?--- R+ # |C| --1ID-> |C rC| # ol | n| ... )) JeO&!stants. OPTIONFLAGS_BY_NAME = {} def register_o98!):# Create a new  unless `` is already known.8return {.setdefaulti, 1 << len(. )) DONT_ACCEPT_TRUE_FOR_1 ='.)')GBLANKLIN  F-') NORMALIZE_WHITESPACD,') ELLIPSIS ') SKIP'') IGNORE_EXC EPTION_DETAIL = register_optionflag('IGNORE_EXC/') COMPARISON_FLAGS = (DONT_AC-_TRUE_FOR_1 | -BLANKLINE,NORMALIZE_WHITESPAC+ELLIPSISJOSKIP) REPORT_UDIFF+$$')3C3$3N3$3ONLY_FIRST_FAILURE 10') ;__FAST=!6ING'""" /) # Special string markers for use in `want`!5s: _MARKER = '<4>' q ...' #2 ## Table of Contents\6 1. Utility Funcs # 2. Example & DocTest -- store tAcase,%3."`Parser)extracts eGds fromYc47KFind7c9Pobjec6 59BRunn9Kruns16. convenient wrappp0ingp7. Unit Support8. Debugg;9+_Usage9Z3c def __future_s(globs):1"""Return the compiler-. associated with#O@ feaWas thatGhave been imZqed into5given namespace .9t1= 0f2_c_.all_}_s1 = Q.get(Cq, None)X)$if is getattr(e!, 7(2$|=<..\]rK* normalize_module(, depth=2e) sfied by ` `. In particular: - If `module` is a , then return1. -- 5cstring5import and@3the< L with that name[CNoneWthe callingL== Tssumed to be85 ofVstack frame at)given depth in| +x1"""Fif inspect.isE(!):!< el9sinstance3^, str8"__\%__(globals(), loc f["*"])`p P Bsys.# s[ A_get(C).f_g@['__S__']]`'seQaise TypeError("Ex'edY,0or ") def _newline_convert(data#$IOpprovide handy decoder for universal R RAsionIncrementalN{DF(, True).Zload_testfile(, package,_relative, encoding,if#HE = _normalize_(2, 3X1'xV_path5*<@if (er := getattr12'__A__',.))J6try<$ =0.__%2__.)except AttributETEpass8aif hasRp, 'get_?'k\`tents = 1./6 F!;#P() opens > s as 'rb', so one must dobequivalentL@ s would do a!),v=fjxf.read(Sindent(s, #=4E1Addx number of space characters`beginn every non-blank RK`s`,r result,jis regexp matchesPstart ]sre.sub('(?m)^(?!$)'0*' ion_traceback(exc_infoRaacontai%a > messageDX tuple (as returned by sys.exc_info()). """ # Get a traceback message'excout = StringIO()7P`type, 2val Atb =l)X.print_exception(9Cr, file={o`returnZout.getvalue() # Override some methods. class _SpoofOut(!):Edef QCself%Xresul{*A)$# If anything at all was written, make sure there'stWilingGnewline. T'no way for: expected output to indicateG tha W is missing3if sand not.endswith("\n"520+= z `@trun(6, size=NoneU`.seek(i.DWorst-case 4ar-time ellips0atc . _ _m(want, gotEssentiallyqonly subtle l6L>>> R'aa...aa', 'aaa'BFalsbif ELLIPSIS_MARKERv0in `M0 ==R# Find "the real" ssAws =J{.split(lassert len(ws) >= 2]PDeal q exact /es possibly neededone or both .startpos, po!0,knwAs[0]if w: # ;s~& if.'#(wuUdel wxFelsesrl,-1%0end!-=wt $"ifCY>1# E5endrequired more characters than we have, as inc#, OB3# FPrest,eeXfleftmost non-overlapp0#each piec9 Ifc0no 7tOcalone, /bperiod w sRw may be ''Cs, i aUonsecutivaes, or~#P# due&an ate@of `` rat's OKHSearch for an empt"y string succeeds, and doesn't change startpos.  = got.find(w,), endpos)1%ifU < 0:Qreturn Falsec+= len(w) - True def _comment_line()_""RX#a "ed form of the given 1"Z ! = .r"p(!ifVP'# '+6?Oelse#'Q_exception_details(msg# Support IGNORE_EXCEPTION_DETAIL# Get ridpeveryth_ ion name; in particular, drop#.possibly dotted module path (if any)9[pmessage#M). We assume that lon is naqA, ornMiRE.g.,( "foo.bar.MyError: la di da## 9"!!Oro"abc.def" E:\n"8.Q = 0,JThe must appear onsQfirstYri = msgME"\n"}Hi >=4send = inrIwn up toY coq, b@':',?endij  br/'.cK!+1BAmsg[:K] class _OutputRedirectingPdb(pdb.PdbG"""A specialized vers python debuggerrWs stdoutBto am,eam when interaQ withzuser. S>Q*not*G\"ed@traced code)executed _init__(self, out.__out =k@_use4 c # do not play signal games.5pdbSf*._+=out, nosigint=V# still use input()0getrhquse_raw.B = 1xAset_=frame=None h1if <?= sys._get().f_backEcontinue`# CallF& uncondi- ally would break unit tesp# cover reEing, as Bdb.Xcalls sys.settrace(None).  if self.__debugger_used:!(pdb.Pdb.set_continue(7!) (Adef ^_dispatch, *args)M# Redirect stdout to the given streamSsave_)b= sys. u$ =5out # Call Pdb's v methodm6try]treturn pkfinallH  # [XX] Normalize with resp"to os.path.pardir? i_module_relative_"(a, testvif not inT2.is)0%aise TypeError('ExRed a 4s: %r' %)&ifrp.startsM('/'\DValu]M- files mayhave absolute #s'k#.9 . On Windows, replace "/"P2"\"% =Zujoin(*(a.split)sAFindRbase qory forshasattrbP, '__(__Q# A nO/packageFk7dir.UA)[0]4CelifL.__name__ ==vmain__'# An interacC session'~pif len(argv)>0 and[0] != 'T6G5[0]0Felse B cu*?if f fR&in$0 20ull{&Ff6%if\exists(fP-g&R$m(T w/o  (this includes builtins9ro`"Can'tY3olvQ |k"Sp"%r (it|& n)3.TqCombine@Wj):9dir/ #2 ## 2. Example & DocTest_8-""eb " is a parwhere ") fragment of a code,"want" is the Fexpected output for ## "source." The Example class also includes information aboutBwhere the e=was extrarfrom. ##. - A "doctest" is a collecU$ofCs, typicallyKG a string (such as an object's doc").wDocTestG K  (60: R!""A single, consist2of  code and EC. `d` definesr`followIattributes: :3 -[%: Python statement, always endFwith a newline.IDtructor add( if needed.|Qwant:T|rom runnr8u(eitherz> stdout, z Xeback in case 80cepE`|`sH unless i.`empty,NRwhichT1an F Utexc_msg message genera!byNE, if.>Z%to@ #ex^;3h`None`G it>5notm BiSis compared againstreturn valu8`!.fP__only()`/ DyecD"no q number!inK i0taiYEthisIGq begins8is fizero-based,}@ resEvFinde2's a+;RQI.e.,pace charat precedp's firs$Gomptos!diary mapp#` flags TrKrFalse, pis used(override,Rault Is  c. Any'p0con"ed,6is Dare left a%irw@(as bified =Runner's$ByMC, no s s2set"q def __init__(self, source, want, exc_msg=None, lineno=0, indent=0, qoptions3%): # Normalize inputs. if not source.endswith('\n'Bi#@ += Awant andJ H !F1 isHUX $ [# Store propertieSself.= =  # = # =3if :E= {})|+=$ =+ def __eq__(Fw, otherqif type) *return NotImplementedjjI=s\11V$ =/-q/111p233!ChashX(/%,   X:)) class DocTest1"""A collec1 of doctest exas that should be run in a singleDnamespace. Each `k` defineFe following attributes:!5 -r: the list.)globs: The z` (aka Bals)G?"XM1: AU i]0ifyI (typically,55 ofY,object whoseQ2strGi was extracted from)@fileZ \OW`, or `c ` 0he D^wunknown|gz number &in=where thxobeginszPis unavailabl;EThisC *zero-based,P respe!tornf 2doc Pe w l QG hCinitc,!s,y, filename, lineno, docstring): 5""" )Create a new DocTest containing the given examples. TheA4's globals are initialized with a copy of `(5s`.Bassert not isinstance({, str), \< no longer accepts2T; usepParser \6ead Tself.i% =k!O& =[ #! = s.*()"pname =  @file4 = !l2 =  def __repr__(aif lenf) == 0D5'no'a!lK1K1JI/se1$%d2Os' %return ('<%s %s from %s:%s (%s)>' %,__class__.__n=__,* H., ,())#eqz, otherAtypeA) is *@NotI|bmentedj=uN and35673/GtUi1b3)Chash`(. d # This lets us sort tests by#lt  6, ! A, id)F<"(.!"W)-#2d ## 3. Z21#  \"A #used to pTjHings>0doc'G4regular expression\@findk HQ in a#w. It defines thr ee groups: `source` is the  code # (including lea indentation and prompts); `OC0!ofhfirst (PS1) line ;\BT`wantV expected output !).E_EXAMPLE_RE = re.compile(r'''"S consistsRa PS1 followed by zero or more PS2"snLB(?P<>` :^> [ ]*) >>>0.*)#s ; \n ;@ \.@ .*)=;<5\n? j# Wantny non-blank that do not start with > (?:(?!$fNot a R5@>>>)m5tvwAb.+$\n?M # But any other75)*)@''',MULTILINE |VERBOSE) )# A regular}@ressfor handl`stringMadCtainDPexcep>s. It divides Cinto three pieces:AA ->traceback headr (`hdr`# - st3!(`) message (`msg`), as generav&by% .format_Gd_only(K may have multipleWe assume/require$thXLR!edUBca wordcharacter &Y_EXCEPTIONB1"""Yuo# Grab. Different verEaaPythonHesaid d1!thY!on\4`dhdr> T+E\ \(]$ (?: most\ recent\ call\ last)| inner. R) \) X P\s* $ `# toss7i8whitespace ,Q> .*?_,don't blink: absorb stuff until..B ^ Dmsg> \w+)a,*o"s*alphanumB1"""'% 4gDOTALL3Pable returne a true value iff its argum.is3#c0conIsingle com3_IS_BLANK_OR_COMMENT'^[ ]*(#.*)?$').match def parse(self, string, name='<A>'):.25""" Divide the given? into examples andervening text,D`returnHm as a list of alternat7EP%s.GLine numbers forM 3 re 0-based. The optionalAargument `0` i identifyCthis,es onlyGAusederror message@# =R.expandtabs()R0# I l lines begin withpsame ina,Fp it!Bmin_(pVelf._(u6if F > 0/ = '\n'.join([l[2!:]2l ing.split(02)])}Joutput = []qcharno,no = 0, 0# Find all doctestkiEOmEXAMPLE_RE.finditer4P# AddQS pre-R to ``d4s.appendW[:m.start(,# Update(0for_$is<'Eno +ABcoune", t%, u <# Extract info fromqregexp $ (source,<s, want, exc_msg) = \\!._h_F"(me 0Cre$ano`add it~u' rif not qIS_BLANK_OR_COMMENT v0 >=3=I+len(m.group('?'))N#s=,) ev2insv"ny)u Q = m.;Nany remaiGOpost ].Cget_f "Tglobs@file,HrKpcollectto a `DocTest` object.``, `name`, `filename`, and `lineno` are attributes for the new `DocTest` object. See documentation=-Gfor more inform+.5""" sreturn o (self.get_examples(string, ), globs,?%B, fi", ", E!) 8Jdef c4elf$i2='<3A>'):5bExtract all doctest Q from,Sgiven~Sthem as a list of `Ezs. Line numbers?0-based, because it's most common ins that nothingCinteresting appears onAsameC@open$triple-quote`!so6hfirst W is called \"01\"0"n.a`The opXaal argh ``Aa identify5hisiiqly used0erressages ![x2x>Zparseuif isinstance(x, ")]w_I2, mtqGKa regular expressRmatchu`_EXAMPLE_RE` (`m`)| a pair `(source, want)`, where `q^%ed2's ) code (with promptso inepped);G2`ziYexpected output]QFYF0"Ang's; i_Y A starts; bothZP# Get&7's f level = len(m.group('#')v# DivideAintos; checkpthey'reUperly#1ed;#thp#ir&@_Es = ').split('\n')uT__3c_blankN,{ EIefix?[1:], ' '*6o + '.'M 0 = .join([sl[;A+4:]!sl,]1pro|#{7'paces befb@last should * # be preserved, so plain rstrip() isn't good enough. want = m.group(')')_lines = .split('\n&pif len( - ) > 1 and re.match(r' *$',E%e[-1]):k;del!forget final new & spaces after itIself._check_prefix, ' '*indent, name,9 kAno +bsource)$0 = .join([wl[b:] for wl in5]) u`# If `;` contains a traceback message, then exFt itBm = EXCEPTION_RExZJif msxexc_msg7msgOelse3HNoneEoptions from ;!Sfind_(- 2creturnS#, 6Z#, # This regular ex'sion looks@ directives1the#g code of aample. O;are commentsAtarting with "doctest:". Warning: tmay give falsBposiIng-literals that6hStringz("#mqEliminaCthesh b@woulDquiractually parsBthe ; but we Ytm by ignoC anyDis *followed*Ea quote mark6"_ODIRECTIVE_RE =`compile(r'#\s*\s*([^\n\'"]*)$' re.MULTILINEuZdef _0elfi +1"""]RPa dic8aryoverrides!edCG( 8.~`0` i1"'s`%no#u number|Pwhere1 ex ss; both  usor errorsX%{}e# (note:-lpcurrent0expis will X at most once:.m=.Ip _#1).replace(','P)F P&*Bif ($p[0] not5f'+-' o) option[1:] not in OPTIONFLAGS_BY_NAME): "raise ValueError('line %r of the doctest for %s 'F Y'has an invalid option: %r' %C(no+1, name,D-))?oflag =[x]7 s[?R] = ([0] == '+'j#if~d self._IS_BLANK_OR_COMMENT(sourceld<r 'directive on a 6 with no examplexpndreturn O# This regular expression findsApindentaTevery non-blankGiqstring._INDENT_RE = re.compile(r'^([ ]*)(?=\S)',MULTILINE)def _min_(7, s""Rminimum -'an\qin `s`"2s = [len()0 }..fall(s)6if Ajs) > 0$mifsOelse.0check_prompt_#s,(no0"QGiven's"a 4  (including s=81lea%r1),  to make sure that 7H5 isFfollowed by a space character. If 1 is 3G ;,,n " %i,enumerateSr9C) >=ua+4 andC[+3] != ' 'D q'lacks P afte;Eno+i]:I)z_prefixCN~glist startsDq7; iY1doe[ 5aV74&.startswith(prefix): (raise ValueError('line %r of the docstring for %s has 'H W 'inconsistent leadDwhitespace: %r' %I(no+i+1, name, o)) #2 ## 4. DocTest Finder\5d class]\1""""A #used to extract~s that are relevant*qa givenFobject, from its1andMs$containedC0s. tests can currently be"edi"followingE types: modules, functions,methods, staticG properties."? def __init__(self, verbose=False, parser=MP1(),>  recurse=True, exclude_emptyA<Create a newx<! fG%. f`The opal argum`` specifies a#5 or<?`should4c 7s (GNQimplesame interface au). Thesignaturethis factory Qmatch{5G_,0truH3I6!` `then `wf` willknly exam6!,]not any s )1 in[ *sIQwith rJ{ow"._@# =h $ = H3 = * =v|2objc=None, Sglobs \Return a list60def1 byp\'@, or,!of0 9 parameter `cs!o3. 70is d2is Z KNx will attempt to automatically determine the correct module. The object's is used: 7>- As a default namespace, if `globs`;not specified.CTo prevent DocTestFinder from extractingsD 's that are importedCthersAfind1 of file containtBUhelp GlidnumberN within itFile.cCx#edss whose` does [rmatch ``@gnorl)&If"is False, no attempt toK will be made@Thisobscure,ustly in tests: Kt%oris None but canbe found,Un all (arnsidered`belong (non-existent)=A, soN%eds(recursively) `searchTaor doc=als for each5formed by combU*Qand `Js` (bindings] override "E$in). A new copy[dictionaryWcreat  0. I=%itsme`'s `__z1__`-u, or {}Ao0wiszi<0theX`Wto {}5"""c#/waRuRct itK@'!ifE:_)^= getattr(obj, '__A__',)2O Sraise ValueError(":.:@mustfgiven G "w?Dobj.dPn't e@y: %r" %@ P(typeF),)) # "e ]@ (if& i3# a=mmR=pNote: tmay fail,6UwhichA# ca!be \ =7ZCelif8 7 inRt.get1.2Rea 's sourcd2 by # DocTestFinder._find_lineno to P the  number for a  # given object's docstring.$Etry: 8 file = inspect.getsourceU(obj).except TypeErrorH6s = None::lse.pif not e p# Checksee if ione of our ial internal "J%s"rG0# (C__patcheQcache_getK&s)2M  (@[0]+)[-2:] == '<]>': ;/1 is/ T AeXif moduleYf]+# SupplyYm5globals in case=wasbGoriginally loaded via a PEP 302_r andA qa valid8system path: # s(Z,.__dict__L# No accessa, so assumea normal#8 "# Initialize ,` mergePextras6!if-sok aPU = {}-f.copy(=9 /6if <vupdate(1wif '__name__'"in I[+0] =9@main9 # provide a default ] ) # Recursively explore `obj`,cting DocTesttU = []MBselfy(,K,rB,F, {}a# Sort8F by alpha order!s,consistency in# verbose-mode output. This was a featur0dockfPython# <= 2.3 that got lostpccident62.4. It[repaired#462.5xgs.sort~qreturn def _from_(lU object):  A""" ! Return true if the given object is defined in@umodule.\2if FUNone:'r{ETrueelif inspect.get@()HOnot L/'Dkisfunctionl`.__dict__i.__globals__bmethoddescriptorjif hasatt , '__objclass__')Jobj_mod =.1 ._7ule5kki/\s # [XX] no easy way to tell otherwis=o.__name__ =!is8lT;^7d&isinstance, propertycIXS-gbe sur,elraise ValueError(" must be a FD or (1") rdef _is_routine(self,Safely unwrap(ects and determinUy arepsdTmaybe}3:try, -%()Ggexcept UEpass,Y$is \1;Cfind5Qtests< , ,?, source_lines, js, seeneQFind OF forpoany conta s,A0add<m`O`0if |._verbo_pprint('3ingin %s' %Lt# If we've alreadyPcesse#is,n ignore itBd4)& !"[i1R] = 1! aJ# it!;qlist of0;# =#@get_ !esVs.append( W # Look for tests in a module's contained objects. if inspect.is1 (obj) and self._recurse:4;kvalname, valrobj.__dict__.items()6:6 = '%s.%s' % (H )) k52# R to functions & classe.Rif ((is_routine(val) orA zLGSfrom_#)5Aind(-,, source_lines,Nglobs, seen&o# Look __0__ oionaryCpgetattrA4, 'wo', {})if not isinstanc$?str^raise ValueError("DocTestFinder.find:  keys "^ e"must be strings: %r" %=E(typM),))7(w= orJ  S,PvyR&,, methods,0es,$ A)70C# Special handlingbstatic/ R (>,?=0.__=/__b Os, propertiobnestedtv5 !y)  self._from_module(, val)): % valname = '%s.%s' % (6 )8mind(tests/4$, {source_lines,Jglobs, seen) -def _get_e(uz, obj, f9m1"""MjReturn a DocTest for the given\ect, if it def a docstring;Jotherwise, rUUNone. v# Extractkobject'sVB. Iroesn't have one3#;nkP (no #is)sinstance(:7str =BJelse6:try? if6.__doc__ is (,k%''jr94objn B,if not i>., 3) =*(  except (TypeError, Attribut b_Kl'`# Find's location in7fil]P no1indd#no l Do_bis emptyAv._exclude_ A andd; }} wBO ! =l@@# __.__ can be12Aspace packages7$ = getattrQ'U!',PC) or0.__5%__L4if O[-4:] == ".pyc"9,)& =4E:-1]Q^pparser.$0doc#, Ke ", gfjU number of} 7Notthis method assumes thaXH hasA"%$\nspect.is}eGi0fXclass!#  Pcouldfooled if a cla ss is defined multiple  # times in a single file." if inspect.isclass(obj):!Jif source_linOjs None%)areturn Apat = re.compile(r'^\s*p\s*%s\b' %3O pgetattr, '__name__', '-'))<pfor i, enumerate( lif pat.match(>$(ino = iwebreak # Find thepnumber functions & methods): obj =0.__C%__m _7Ocode7traceback8vtb_frama o 4 f_l1 A` co_first!',h?)-1kQwheredocstring starts. Assu# that it's2r begins with a quote mark# Note: this could be fooled by a # signature, a continuaC !if4 no+1not7 Eno+1t(^|.*:)\s*\w*("|\')'NQrangezzno, len [V]4%A"We_n't fC ? #2 ## 5. DocTest Runner\5 o]\1""""A #used to run/ tcases, and accumulateKctisticThe `run`xSvprocess[Q. It\'tuple `(f, t)`0`t`VTO'ofDRtried/`f/ vfailed. 1>>>T4s =Per(). (_C55r6l(verbose=False2^s.sort(key = lambda:.5 >>> for test inCs: 1... `print(%.name, '->', runner.run%))9_TestClass -> Results(failed=0, attempted=29.__init__B'?get='osquare@11) The `summarize` method =Bs a y of all thep cases thatGhave been`1 by)k, and returns an aggregated `(f, t)`Dbtuple:0>>>Nize(verbose=14 items passed7estA 2s0wk!*"ge O1p.M7%.Rnd 0   7`numbertried exampledy!isalso available via`B!s``0urettributes6X?7 M0*comparison betwPexpeccboutputtactual qis doneR by!`O.Checker`. This ` may be customized with aEIoption flags; seedocumenta@or `mod` forDmore inform'Q. If>T insufficient,#nF  !by?1ing!bc!of? 0 toZ constructor.~'s displaye0 ca:ptrolledtwo waysPFirst&4Afunc"d(`out)D"toR@`; t<Awillavgstring`should' edp`t defa`sys.stdout.writeI)PcaptuU Y is not  #XRby su6Doc.d=poverrid"s `report_start`,uccess`,=&3une/Q_exce`d9`1"""A# divider `uto separateGure messages^#(!ses$hewDIVIDER = "*"$ * 70 def __init__(self, checker=None, verboseoptionflags=0):CG5""" Create a new test runner.r/OGal keyword arg `y` is the `OutputCe` thatf should be used to compare;expected oCs and actualBaof docexamples '' prints lots of stuff if true,knly failuresfalse; byault, it's7 iff '-v'%inEsys.argvargument `Z` can"ntrol how&ZF+s CbAT,T5howGit displaysR. Se1docaC` for `y@mod`Gmore inform+.f#._3$ =I or 7%()?$ifZ# =~$n sCv) 7 =  'riginal_" 01# Keep trackh` we'vee*tries = 0G _name2ft = {}%# Cfakep target capturingJ] _? ou`_SpoofOut()i/#/-# Reportrmethods^-/0rbc_start4Aout,#, 40ner abto procesFgive`P. (OWsa messageaV=TrueA1if _+ $ifZ.want- out('Trying:\n' + _indent(source) +4!'E?w)<OelseI nothing\n' uc_, gotab ran s^Tfully81bose:  out("ok\n") #def report_failure(self, out, test, example, got):7;5""" RC that the given9 Z5ed..:r._header(|5) +>|2 checker.output_difference(!, .optionflags)unexpected_exce, exc_info"raised an v v'9$'E u:\n' + _indent(_traceback(' S  pout = [%.DIVIDER]!ifX.filenameRlineno is not None andS. GK$=o+C5+ 16;els>Y= '?'/out.append('File "%s", 0 %s, in %s' %5R 9"no[.%));~ILines ./+1WEUFaileg&:'}source =@F_"return '\n'.join(out/#/-# DocTest Running\-/.S__runqcompile[9 1Runs`C`. Writeoutcome of eachp5Pwith !of0`3er.*` methods, using,Dn`r funcP `out``~0setrFshould be uto executeRs. Rua tupleG`(f, t)`, where `tz`number}5atried, 5`f`E is 1F Th are runEw@spacest.globs`p# Keep ?k0wAuressF!= B = 0gS# Sav nr(since  directives can # to modify them).  original_optionflags = self. 1$SUCCESS, FAILURE, BOOM = range(3) # `outcome` state=Tcheck__1er.v_output,# Process each example4forDnum,  in enumerate(test.;6s):^# If REPORT_ONLY_FIRST_ is set,2n suppressAreporting after, first failur1quiet = (`/ &9andwJdls > 0)PMerge4the2's sHJ /=  $ifV))s: X(rZ`, val):.items()BF if8 #|=u 3OelseQF&= ~ jIf 'SKIP'3kip this( -iff0 & HwcontinuJ# Record that wen0rteutries += 1Anot ~`_start(ou5estw Use a special filename compile(), so`can re)ve#Qsource code durninteractive debugg<(se@__patched_linecache_get sOp= '' % M=num1Run`given ext (globs), and r any exce gets raised. (But don't + Dkeyboard!yrupts.)$>try1# DWblink! Tis wherebuser's*unRQTexec(.,, "single",A Is, True), .L >per.set_~G(b==== EV Finished  JZ= Nond# KlIkX ]<*0ion,ys.exc_info(  Example Finished ==== $got = self._fakeout.getvalue() # the actual output@ :truncate(0)&outcome = FAILURE Zguilty until proved innocent or insaneA# If!example executed without raising any exceptions,# verify its.!&if< is None:"Dif check(.want, got,So}nflags)?C|SUCCESS ThVed an":  if it was expected?els exc_msg = traceback.format_<u_only(*[:2])[-1]not quieto7+= ]x(a)'`g`,n we weren't=ing#? $jo.gfOBOOMW |: see whether~matches-elk, r5Q# Ano`chance]they did^pcare abnodetail! & IGNORE_EXCEPTION_DETAIL`g_strip:ws}) H @ t`Report# F$ifE(?if x rn_success(out, testD z$is-failureK1is += 1 -$unEp  0 assert False, ("unknown6me", outcomeG) if failures and self.optionflags & FAIL_FAST::EVbreakQ# Restore the F Gq(in casy were modified)W }= original_NM qAcordareturn{number ojtries.o@__reC_outcome(test,!, 5fTestResults(A,bMdef ]#, cF, t)T1"""8XRfact thae given Doc0 (`J`) generated `f`F@ out 1`t`d exampl ~f2, t2 = _name2ft.get.v, (0,0).,[(q] = (f+S;+t20E+= fKwR += t__LINECACHE_FILENAME_RE = re.compile(r'.+)9 \[;Onum>\d+)\]>$'patched_linecache_get s(`, file,ule_globals=None$m .mj(OAif m%m.group('oC') =48w&es[int(Pynum'))]}3".source.splikeepends=TrueJelseJ5_.saveR L3runy#, ?]s,3 Qclear5"Ru{Rs in ,yqdisplayr9` using/writer funcr `out`.5The are runjpRspacex.Dfs`. I[`` is true (?default),6is SEwill1be HPed af@Ks, to help with garbage=Qcolle you would like<C!in+jFr@letewhen use h=FalseD`31ile`Ss1 se's!sh beWId bydPython>0r wCrunn5not?Aspecn0it b uture-imporDPapply5` 2output of each example is checked using `DocTestRunner.%_output`, and the results are formatted byG% Kreport_*` methods..5""" self.test =  if compileflagsUNone:! "= _extract_future_:(Xv.globs)_save_stdou{Bsys. _0if >is wencoding = H.D4if 5 or.lower() == 'utf-8'D kYwriteh;els:# Use backslashreplace error handl>on Q?!de>(s) sBtr(s$e(<, 'u5'),)JL&(s)t7_fakeout# Patch pdb.set_ @e toWtore E0dur@inte3&ivO# debugg (so it's not still redirec1to )# Note thatEiYPput wN goU*our*#W, even ifLrGrealg; thisDallows usaPc` cases(behaviorE=j1get(Im=}'Wqer = _OfRLqingPdb(qb;g.reset =.%linecache.get s, so we can seeC's sourc%when we're insid1{ fs_s5 = : _p5ed_$TsMake sudisplayhook just printsAvalu,9 +7ys.Wys.__&__:tryVPretur{lf.__run,,=kfinallH 6m 8  +PP26c'; Qlear_F test.globs.clear() import builtins ._ = None #/#/-G SummarizationZ-/GSdef s]e(self, verbose=!):'5""" sPrint a;y of all the test cases that have been run byD-this DocTestRunner, and return a tuple `(f, t)`, where `f` isotal numberfailed examplesW `t8087tri7.`The op|Cal `  ` argument controls how det5theedy is. IfH it not specified, nA )#'s=Uused.+#if*Ae is@e = #._L noes = []jpassedt (thAt = Uf = 0Dfor x inxname2ft.items(v", E = xErt f <= tv?t +ff0if t == 0#e.append( %oelif f>0= ? D.se{Y=x3 5 ifMJestspS(len(A), "tq had no6s:"g71_.sort"Pthing,IP" ":ingm2if 1?;"$p, count22%3d51q%s" % (A# RvDIVIDER3j =ure/edT2in / } " !of3in G O2, "YPin", _Z52ft.D# -Y2, "@UxBf, "D: p!rint("***Test Failed***", totalf, "failures.") elif verbose:pROhpassed8preturn Results(h1t) N/#/-G* Backward compatibility cruft to maintain doctest.master.?-/Gdef merge(seRfother)7@d = ._name2ft6M@for , (f, t) in >+w.items(N8!if7/dh# Don't  here by default, since doing7# so breaks some of the buildbots6jgA Docaunner.b: '" +@+ "'~both" \K " ers; summing outcom+f2, t2 = d[M]Uf = f + f2t = t + tJ8 , t class OutputCheckerx1"""T"A #@usedxc%70whe `actualput from aGexample matches5expected7I. `` in.!woFmethods: `!_o`, which+res a given pair(!s,EBand s true iy ; `2_differenceeC?Pa strpdescrib R7s between twosbf_toAsciiis'tConvertvto hex-escaped ASCIIc4@#(s.encode('7 ', 'backslashreplace'), ""zwant, got, optionflagRJz{ ?$n 4f(`got`D0 (``). Theseings arealways considerV are identical; bu`dependson what ! r* is using}several non-exactz@ typre also possible. SeeXdocumentam m`` moRnform&7abo ,eR# If O+msp character such as "\u1234"#nGi3uof six Es(e.g. [\,u,1,2,3,4])# On the other hand, `got` could be another sequence of # characters such as [\u1234], so `want` andX shYBbe folded to hex-escaped ASCII stringcompare.< got = self._toAscii(got)!| "%) $ # Handle the common case first, for efficiency:8 if4Cy're-identical, always return tru1if = SU1HTrueThe values PFalse replaced 10rz?pbooleanparisons in Python 2.3cif not (optionflags & DONT_ACCEPT_TRUE_FOR_1)0if ,p) == ("\n", "1\n"0 LM0M can@used8a specialto signify aEblank line, unless  g 7@ is g[B *2# R !inO with a sO = re.sub(r'(?m)^%s\s*?$' %(_MARKER),I 1'',} a# If a(bcontains only spaces,=qn remov i#& L [^\S\n]+$', z 5c ~"iscauses doctestPignor&y differ$P5the # ents of white:ps. Notxat thisFiPnjuncELLIPSIS):if NORMALIZE_WHITESPACEX' '.join.split()H)*u&)e sRPto le$eP"..."an00matcny subK"in'x if _ellipsis_Z(, MWe didn't find any L;-f1# SE we do a fanc?def _do_a__((,lags):  # Not unless they asked for a fancy diff. if not optionflags & (REPORT_UDIFF |-4 -C-N-)):Zreturn False !# If expected output uses ellipsis, a meaningful7 isGtoo hard ... or maybe. In two real-life failures Tim saw,IaC@ wasyajor help anyway, so this is commenu# [todo] __match() knows which pieces do and don't ( nd could bec basiskick-ass"inGcase;#ifELLIPSISx _MARKER in want ##np does intralineerence marking70can0useGevenw+1-?s k9TruiThe other types need at leastE0ew @s to6ful $.count('\n') > 2Ps X bev,En replace blankCWwith E|l( & DONT_ACCEPT_got = re.sub('(?m)^[ ]*(?=\n)', 8()W@# Check if we sh0"us  oq._do_a_/(BT|eQSplit &o=e+P_F=0 .s;(keepends=)v85got7H63# U0lib@findijKkO O/! =9lib.unified>D :n=2HPlist(Tq)[2:] #Lpc header " kind = 'unified diff with -expected +actual' elif optionflags & REPORT_CDIFF:-8Z=alib.context_(want_lines, go On=2)HPlist(=)[2:] # strip thec} header>,followed by Nvengine Differ(charjunk=IS_CHARACTER_JUNK X.compareE)Cnw.seassert 0, 'Ba: *return 'ences (%s):\n' %+ _indent(''.join%) # If we're not using,n simply  Axoutput / .00if @ and E$:\n%sGot(D%),7gotE"^Bhing9 bS?gotR JRQ  M ' class DocTestFailure(Exce8)D"""A$ example has failed in debuggRmode.TThe eL instanc:variables:+q- test: object beW4run*-E-Cthat/kX G>1"""def __init__(self,, *#.! =)E$ =? Pgot =|3str{g1strr)$UnAencountered an uLsexc_infoS!fo]Kg*P:%DebugRunner(D2ocTestRunner): r"""Run doc tests but raise an exception as sothere is a failure. MP If7unexpectedBpoccurs, U Ea"isw%d.Lt contains the, pexampleLdoriginalo:q >>> r = Debug(verbose=False)x1/5Parser().get_doc!('Y,KeyError\n42',J0...g {}, 'foo'|.py', 0"ryNZP.run(4" qOas fPK = fC.gOTrue1V.want1k'42\n'3exc_info\:w[1] # Already ha1raceback;T (most recent call lastb9We wrap to give^ing applicaPY`access.0 an6 !rm2 d-output doesn't matchRn a DFDd $'' T_x = 12_''', 0ot z 9objects provide  `U4pAs wellj!to88T W VM-ractual 4Q(go1P or e bglobals are left intactl1del.0s['__builtins__']2est({'x': 1} u7  &.: >>> del test.globs['__builtins__'],({'x': 2}WBut the Pals are cleared ifre is no error:: e = DocTestParser().get_docF('''2...=_x = 2''', {}, 'foo'.py', 0)runner.run(m)NResults(failed=0, attempted=1K@XE{*2"""|@def pQself, , compileflags=None, out P_bs=True):ar<RZUv, False"ifb\h.(7return r eport_unexpected_exception(4out, exc_infoeaise UHEG3 < ?urex=gots@Fail= n2? #2p ## 6. eP Func%s\6 These should be backwardsjatible. # Forility, a instance of ap # class, updated bymod. maste TSmod(mCname +, verbosrf 1, o^707traG 9VA_on_=3`clude_y?""" y / r=-ex6As in docstringfPB andes reachable_from module m (or currentBif mt supplied), startingIwith m._2__.AAlso {Adict7 __,it exists!is_@not (. .Pmaps :Us to ,;H$\5ped evenbrprivateJW4pdirectl3s<gy weredR6#(#@s, #F#s)!See help() for an overview(Optional keyword arg "name" gives the 1 of module; by default use m.__+A__. Optional keywor^Tglobs_a dict to beE2d at&1alsHwhen executing examples,=P__. A copyiI is actually5d for each docstring, so that'G start with a clean slate Pextra +"rywshould bemerged int e = al(Sat ar9#to$e"Q. ByC0, n&5traE@p. Thisnew in 2.4 verbose" prints lotsostuff if true,only failures"IfalsMa, it's: iff "-v"in sys.argv ereporta summary atAend OCelseP nothc.c. In a mode,IXZetailed, O very brief (in fact, emptyall tests passed) oFflags" orpogetherule constants,4andsZ0 3. Possible values (seeF  d2s):DONT_ACCEPT_TRUE_FOR_17 BLANKLINENORMALIZE_WHITESPACELLIPSIS.ESKIP IGNORE_EXzION_DETAIL REPORT_UDIFFCNONLY_FIRST_FAILUREraise_on_error" 0s a!ce5 onWfirst unexpected ex&r.dallowspost-mortem debuggedEAdvanced tomfoolery: omod runs methoda local iBQce of9Pclassq.Tester!n }e results(or creates)D =b1docU maUF. M F0cancalled directly too,Lqyou wanCPdo sounusual.E@Pass =0is especi0ful n,&CdelaC`isplayGWEvoke+Cize(;{Pyou'r2ne fiddling1""":L}@# IfmA was`__main~@if m:QNone:V# DWA - m will still be None if this wasn't invoked from the command # line, in which case*following TypeError is about as good an ePas we should expectm = sys.modules.get('__main__') )# Check thatKwere actually given a C.2Pif nosn2.isA(m): Vraise("testmod:J required; %r" % (m,)IbP nameZ,'3n u0t!'s&3vis NoneI`= m.__ $__ Find, parse, and run all sqjfinder = DocTestHer(exclude_empty=1if A_on_BrunnTQebugR(verbose=, optionflags= )y7elsQST1for .1(m,z, globs=q, extra = P.run(c\eport.summarize(+Qmaste =1ner "r.merge(Wpreturn sResults .failures,W.tries) defPfile([,_relative=True+=nRckage09''! rM:=0,Cv:o@=Fal#r=P>> c0doc15{=..@O.set+(REPORT_NDIFF |:0...)2ONLY_FIRST_FAILURE) ==EHTrue;  ROnly 'V@ canU9set?ELLIPSIS Traceback (mostPent cNClastlB ..D0 V Error: ('allowed', 8)S1old[ORq?al 2if |2 & ING_FLAGS) !=\sGaise)/("' "",@0 =t classQCase(,est.TestCase+): def __init__(self, test, optionflags=0, setUp=None!barDownGKqcheckerh@unit].TestCase.z)JW._dt_( =+u3 = #|! =" ="te@ A<>%):;n3 5if ? is not cE+ ((H)I'B+.globs.clear(0runL0oldys.stdoutUnew = StringIO(3 *33^!ifj( & REPORTING_FLAGS4S# The  don't include any reporting",Bso add thewLault2 1D|= _?_grunner = DocpR=Q E=J, verbose=False=:try.DIVIDER = "-"*70failures, tries = 6Irun(*cut=new.write, q_},kfinallsVS&ldC4if Baise!AExce!.format_(getvalue())% )^W, errnL1elf !ifp.lineno0= 'unknown  number'KJelse'no = '%s' %j6Plname#q.'.join ..split('.')[-1:]return ('Failed doc` for %s\n' File "%s",a%s, in0N\n%s4&% pst.fileCAno, wqQdebugqr"""Runcase withousults andPcatche4ss! XrameworkYAs a method on*ysusuites to sup post-mortem debugging. The test code  is run in such a way that errors are not caughtK!is&aHcaller can catch theCnd initiate post-mortem debugg LDocTestCase provides a2r methodhraises?UnexpectedException ifre is an u*@e6:R >>>E#= Parser().get_docc ('(P KeyEGh\n42',eV ... {}, 'foo'.py', 0)8^c%({*Jtry:@xD.(8" LOas fTfailure = f<Kcontains[, example, andToriginal ?ion.Ji True9Z.want9o'42\n';exc_info. B  [1] # Already haraceback?T (most recenll last) A I output doesn't m4n aFXdr )*''y "_x = 1 2_''', b/ ^cbJT]^  Atobjects5 access toZ]0As well ]4` #W V ane actual] ,go16"""=self.setUp`runnerR!(oFaflags=6G_dt_ vchecker;, verbose=FalseU.run(o, clear_globs5*tearDown() def id(self): preturn ._dt_test.name #def __eq__9w, other@qif type) is not *qnNotImplementedj 2 ==ua and \55optionflags<C ZsetUp=7 tearDown:= zchecker<"ChashY(.,,SZY())NreprA& =sV.split('.')n"%s (%s)" % (A[-1], '.'.joinD:-1]__str__ = object.shortDescri6@"Doc_: " + class SkipDocTestCase( UCinit, module RP# = S9.__IGNone{ \@skip( Suite willwork with -O2Mgabove"]_H aOpass`9Pping Xs from %s 0.__"__`F  _.P(unit`."):K`removeqAtIndex0, i  4 _=s, globs Xextra _fXr#"**sy1"""%Convert d0Cor a*d to a ! s.bThis cG`s eachMuja@ str'inS1hatcontains3_sscase. If any of theC7!s ^4docnPfail,$nW C s. An exceHis raised show@the !nP file ~E(sometimes approximate) line number72e `Q` arg1 provides !beed. The0tcan be ei)dxUIf noA@Qgiven,P callzsis used:AM@ may|d as keyword arguments: setUp 0 A!-up function. This is called before running the<tests in each file. TheRUQ will be passed a DocTestFaobjectw ;can accessw q globals aEs attribute of1x.tearDown8 A _-down_afterUfT>?1!diary contaisinitialr variables for_sY op>SflagsW\1doc$ %b expres an integer.>2"""!ifp_finderQNone:%X=ZF-"()Cmodule = _normalize_m()NJ8s =o.v%,!s=9q, extra = qaif notIad sys..mize >=2s# Skip 'es whenowith -O2AsuitHS( @.adde(Z)CCase)/qreturn V1 S.sortVAIr 0est :pif len(.examples) == 0$t4inuX' B.X7nam32 = 0.__!__#!if@P[-4:]}j".pyc",?)& =4I:-1]Q*%,~1z;@, **Cons). PclassAFile7C)def id(self)I'_'.joinP._dt_y..split('.'}J__repr__1PfG*?fUt_failureE^, errJP('FaiR"M`%s\n  "%s", line 0\n\n%s'\!% g/,  D0) 0Docw+bpath, O _relative=True, package=~,M  parser=P.()4encodingS"ifqmQ = {}Belse3globs.copy()  if package and not module_relative: raise ValueError("P; may only be specified forM%-"EL"i paths.") -2# Rqize the.Adoc, = _load_testfile(D,,?| encoding or "utf-8`if "__d1__"(in globs!['1] =AFindGprread itname = os.P.baseConvert it to a ,L@wrapin a DocFileCase](rser.get_doc(N , p?ath, 0).hreturnQ(7, **options) def"pSuite(*s%2kw)""""A unit? s'#0oneoSmore  !"s.8TIeach% is given as a string;einterpreta of that' depends on1 keyword argumentB""A numberT be provided T"s: Vk] If pPTrue,$_Ss areBRos-in$en-rC By?qdefaultlss^ 3 toP call($'s@irectory; but^"c"[)nnB@they r$at. To ensure $ce" " should use "/" charactersOrseparat0segsUb s absolu0p (i.e.,s&Bbegin withs)1OFals&Fc %he&or](0urr"@workdCA Pythonta ewhose VG be0E+$g^X"Y"ed]<"us9n`s. ItG@an e#e&y #if95SsetUp-A set-up func isp`ed befF@runn$thss in each file. The setUp function will be passed a DocTest object. Th;can access the test globals aEs attribute of1x!. +tearDown @ A U-downis is callfter runningY>s in each file<fT>?1AA diary contaisinitialr variables forsY opUflagsW0set0doc* # $b expres an integerNeparserI2P (or subclass) that shouldfudto extraceas fromencodingm$n [YvconvertH to unicode.E1"""suite = _S"()# We do this here s at _normalize_modulexBrigh# level. If it wJ ink@Fileo,np4# w=e=r and we mj4 gupackage incorrectlyif kw.get('m_relative', True):nCkw['I ']! (K&)6z@pathusUn@.addD(Doc()d, **kwGqreturn 3? #2 ## 8. Debugg(Support_5 def script__examples(s[Rr"""E)ext with 3fB C=s t%a PythonPB. Ev input i8 ed7regular 40out5[all other wordF:areJcomments:6b >>>T= '''T0...Z@ HH si+R mathX .. >has super@uratP addi~ D_2 + 25 =And very friendly error message?1/0_`To Infy!?AndEBeyo ... F... You can use logic if you want: )7... 0>>>10*lOblah@!: boHo humD''' print(script_from_examples(text))-# Here are "` of si-U math#4Python has super accurate integuddition8 T2 + 2 # Expected^E## 5 u And very friendly error messagesD841/0 kTo Infinity)#ieBeyond ]?6if I8 7 4#i 1""" output = []for piec DocTestParser().p 5(s);isinstance(92, EA'# Add th?'s source code (strip trailing NL{? r.appendk.@Z[:-1]-m3@U" =. *if '-'.- += ['## '+l eAl in_.split('\n');JelseCnon- y5q_comment_line(l1  # Trim junk on both endsTwhile}3and [-1] == '#'R.pop(=0< 0=# Combine^\ , return it>a courtesy new to prevent exec P chok(see bug #1172785v\b.join(y@) +  def test(module, name"""Extract-sQa doc0doc ng as a .bProvidf (or dottedpz) contain1thefto be debuggedC7 (withinH!ofaobjectG%Cdoc  iaU = _normalize_<x4s =AFindMfind)ttp<if t.name == name] if not test: raise ValueError(name, "*found in31s")5?! ="[0Y src = script_from_examples(.docstringFSreturYrc def debug_src(src, pm=False, globs=None)@"""D- a single docgg,argument `src`'"""2src)&"/". s is theE@, as5.import pdb "if+" =b.copy(Nelse'%{}I&pm6try W3exeaWexcepVprint(sys.exc_info()[1]!0p =.Pdb(nosigint=True'c.reset9p.interaction( +, p2p ?pdbra.run("q%r)" %  (module, 2.|qProvideS (or dotted]7 of) containing ORto beGpged and CP(with2he f)WaobjectG%4 Zests `.2TT = _normalize_({ Source!I'zT.__dict__) #2 ## 9. Eo Usage[5class _TestC \:A pointless *, for sanity-check&of~3ingBrMethodsWgsquare.g<7>>>Q(13).( +3-1251;Fhex(?nHa'0xa9'6 __init__(self, val0"""val - passociav@@tjB(123 t1123  .=m )  <'s RjZ 5169  self.val **C 2 return self def get(!):+0"""S) -> 4TestClass's associated value.M:>>> x = _0U(-42)Z print(x.c&-46"""T.val __test__ = {"j'":w,s"string": r[Example of a 1 object, searched as-is.]Jg1; y =y# '+ y, x * yNG(3, ;:F""",#"bool-int equivalence 7In 2.2, H ean expressions displayedF 0 or 1. By default, we still acceptIthem. This can beabled by passingKDONT_ACCEPT_TRUE_FOR_1 to the newFoptionflags argument o4 == 4i1&UOTrueX>0T@OFals lank linesB#Zmarked with  z'foo\n\nbar\n'.?foo$g ?bar8 ellipsi !If'  is used,tn '...'&. telide sub:@s in> desired outputM list(range(1000))) #doc: +ELLIPSIS[0, 1, 2, ..., 999](whitespace normaliza5,7< `differ"Kare ignoredRs&3$NORMALIZE_WHITESP_ACE [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14,G 15, 16, 17, 18, 19, 20, 2]2, 23, 24, 25, 26E27, 28, 29]f9"""2} def _test():-import argparse  5r =.ArgumentP%r(description="docR runner")Cc.add_a<('-v', '--verbose', acD'store_trudefault=False help='print veryW output for all /s' ooappend'choices=OPTIONFLAGS_BY_NAME.keys(), /[]H('specify a T flag to apply'a  '*1the; may be `ied moreHhan onceR| multiple ?s')Y fYfail-fast\0topAnings after first _ure (thisis a shorthand'-o FAIL_FAST, I`n addi!ny other -o)  0filnargs='+i '0r contai s3runO2 = ."s(Js s. 2# VP usedU0be %pled by U0"inG3v" magic in DocTestR# but siAwe are usn 1pasit manually now.-A = 0.&_s |= [H if s.__F8O@namel<4if ".endswith(".py"Q# It module -- insert its dir into sys.pathatry toD## it. If iVpart of a package, that possiblyCwon't work because=;ast0dir,B = ot.split(4.0(0,K (bm = __%__MZ[:-3]*5del&"[0j ures, _ = testmod(m, verb ose=verbose, optionflags= Cs) Uelse:failures, _ = testfile( name, module_relative=False,DH4if return 1u 0 if ____ == "__main__"?sys.exit(_%()) # Copyright (C) 2001-2007 Python Software FoundaJ # Author: Barry WarsawLntact: email-sig@pG.org """A package for parsing, handl and generatingI messages.""" __all! ['base64mime''charsetencoders6rro@feed$er oFhead itB?`_from_8obinary ostring;5yte hquopri Dutil9#] # Some convenience routines. Don't import PT r M as side-effects # of/ siVthose cascadingly(P most7ethe re # #1T. def ["(s, *argR*kws)1"""2 a ( into a `objectAel. JO*al _class=0ct passed to ^r:structor.E.9,r(5~str(s) b'}B  d?(fppRead a &@ its_tents?(fpX6er(*args, **vkws).parse(fp) """ Routines for manipulating RFC2047 encoded words. This is currently a package-private API, but will be considered ipromotion to a public API if therebdemand. # An e looks like this: # # @=?cht[*lang]?cte?_string?=1 moq`nformas about C0 sebemodule. Htqone # op preferEMIME8names (hopefully; you never know when ing). # cte (Content Transfer E#y ei0 'q' or 'b' (igno case). In #WQory o/letters could be use +Qings,in practic is # (almost?)happens. TZ n0add``entrieK to CTE tableuQYAGNIQnow. is Quoted Prin.,bBase64P meanh$of4 sh`obviou'''Q opal # as indicaq!bybrackets (they are nottrsyntax):"s )# #)[@unteX.The general i%Afacea drthat it takesZ3dedts argument, and returns a tuple (cte_X;, defects= Th%e original binar%dat wasv0 ustGspecifiedizQa lisFMessageD instancePany # problemmV"duonversioni'correspon!Ps ext1romd1EW,Woserveda8psequencmx1put0the5_JPwhichan ascii-only REach r must also suppllength func [X4 # Y QQresulTKAmainoj", BcallAr # zG#d DwrG2addFappropriatARFC "chrome" >dbRDcan 9S0utoKaselectAshortest possible(ring. Sjbir docps below # detailimport re b!in  import functools from string import ascii_letters, digit)Temail(errors __all__ = ['decode_q', ?'en.b. =lenY (VT ] # # Quoted Printable # # regex based R r. _q_byte_subber = functI.partial(re.compile(br'=([a-fA-F0-9]{2})').sublambda m: Y s.hex(m.group(1).~())) def2_q(V1d):l3 = .replace(b'_', b' ')*zreturn NP, [] dict mapp to theirc form class _QByteMap(91): lsafe = b'-!*+/' +_.!('uC') +p N__missing__(self, keys if@ in .![key] = chr(?Oelse/"={:02X}".*at<X` 0Wmap =")`In headers spaces areq edj6'_'rmap[ord(2'_'AB_q(b ''.join(G x] x#5LNIlsum(leI)JU`Base64K%_bec# First tryRjwith validate=True, fixthe padd if needed. # This will succeed only if[ed includes no incp characH`pad_er]ad) % 4g{==='[:4-;]s  OA b''=2tryi(ob64.b6420; + z,#)RH[".IP:Defect()&[]F*except bin .E# Since we had correct0, tis likely anw w# e non-alphabet&ignored as farDgoes, butdon't know how many reOQ. So}Bout +M_0seeit works [False;C6 except binascii.Error: # Add as much paddingcould possibly be necessary (extra. Pis ignored).:try|return (*base64.b64decode(en d + b'==', validate=False),G [eAs.In/BVCharactersDefect(= =P(:]x)except bin# This only happens when the string's length is 1 morerO than a multiple of 4, whic8i :Lbpo-27397: Just ` sincere's noMrway to \/, LS def&B_b(b()sQQ[&.!('"')M=lenJgroups_of_3, leftover = divmod(lenU2, 3 # 4 bytes out for each 3(or nonzero f!ioreof) in  * 4 + (4 ifelse 0) _cte_ars = {C'q':y"_q&'bb}>3(ewHA"""Did word and(x, charset, lang, dfs) tuple. An RFC 2047/2243V0hasF1"m:1#=?[*ZR?cte?"d_|"?=-qwhere ''A' maomitted but]other parts#Tnot bPfunctexpects exactly s3"a u (that is, it doept checkiasyntax/SraiseaLNi?AwellAed),8sO0 d first from its Content Transfer EJ$ndLn0V0res4#nginto uni0 us9'specifiedT. IfPR cte-Bd&0sucOSfullyYL QaMPaddedKdQ list-unknown octet8are replac y'0'vs\\uFDFFMThe oRuage aPed. 2bdefaul(k`rarely eTuntered,SemptyL1"""%_scte, cte_string, _ = ew.split('?') charset, _, lang =.partition('*. te!te.lower(D"# Recover the original bytes and do CTE decoding.zRbstriq2te_ .encode('ascii', 'surrogateescape<, defects = _cte_bers[cte](&ATurn#edinto uni}Atry:%3 = R.h(=aexcept UFVErrorB.append(eAs.UnIPableB-D1("Ed word ""contains2notXE0 usR${}".format)J |kLookupT $if] != 'unknown-8bit'Q2UC2("U?[; {}QIB"in zt;Sced as pQ0ret^,nS1 kr{C'q':2_q,bb}?_length = D9lenA>3deff(='utf-8', ing=NoneB='')y#"" @pTthat producessshorter result. P"an RFC 2047/2243e1 ofC:9#=?~*Q?cte?#edL"?=-qwhere ''' is omitted unles'D' parameis given a value Opal argument (defaults IL) specifi !se#toSto binary before:Z]it. N'%5cteBr fo' should be used ('q'Nor 'b'); if it7 (X)OYwhichI#std sequenceTt#, R!'qpreferred!upPqto fivezacters longer A '')PytDuage#to=2y i8"""/ =?# =dBelseFbioding is NonCe: qlen = _cte_encode_length['q'](bstring)0b0b0# Bias toward q. 5 is arbitrary.Z~ing = 'q' if !- s< 5 else 'b'3/*ed1rs[;ingvif langkA*' +Vreturn "=?{}{}?=".format(charset,1$, l ed) """Header value p1r implement various email-related RFC."rules. ThBmethods defined in this moduleb _ _ G[ Principal among them5322, whichthe followon to2822 and primarily a clarification ofU ;er. It also s mB2047Jed word decoding. !@ goeF considerable trouo maintain backlcompatibility withN;Zqe phasele clean'!upstructure ooqe gener 9@. T_er supports correct,9 by tagggwhite space asf{ only when@e non-obsolete  sets. Actually,is even morcQaccepinput than mandates,0low`spiritPostel's LawT ch? ?/@uragWhere possiAdeviVas from stord are annot('defects' attribute`tokens"t UeH'l s,uses its terminology wt1 dispondence. # requires a somewhat differenttAused:rmal grammar, new!s +QmimicCclosest exis~ e Pus, it re(Q helpihave a copyXChandRstudyidkI8o[$Jhas already been unfolded accor!touaAie very firsO!ep +@leavT#he~=step to a higher level messag2r` will (Pdetecline breakwat needl`while 3Z~6Qbegin^0end~aeach hX0outdhTList object is a list s@ubclass. A TokenList is a recursive data structure. The terminal nodes of the&d are T$objects, which s{e<2strXse do not correspond directly toxT1 inzformal grammar, buth instead more practical higher level combination6trus. All =and have a 'value' attributeproducesa semanly meaningful = Lrat part e se subtre.@ allZtespace ts (no matter how manyA-they may contain) single J, as per RFC rule-This includ'CFWS'is herein !dgeneral s:whi reone excepq to the_ thatVcollapset8to aQs: inOBbare-quoted-string' (a  with no leading or trail 0), mappeared betwee`z marks is preserv{returnedr. NoteT0in jsa pairsB inDpheir un|VDalsolp@mptsb`"canontA" re"nteY-compliant 3subd Cd0par,@mini 0useI fing. Wz2run"u@. CommentO'47enta proviBx found parens (+`nesteds"s)iA90defy possibly empty lN=qle creatJB. Df N1 on"0d abpositev!ofr availablQroughS'all_5O0ny . (For "notes x.7g == x.H.) Each aaPcalle''e5 ha<u_type' 2giv name from`D5322.&it6as. Not)-tGFnon-2ode that may be produced: 'ptext'. A  is a string of printable ascii characters. It.returned in place7Plists (cc/quoted-pair) and (qp. XXX:vide complete ML token types. """ import re 4sys urllib # For .parse.unT fromLhexdigitsoperator itemgetter Temail_encoded_words as _ew(Serrora A utils # # Useful constants6 functions # WSP = set(' \t') CFWS_LEADER = |(') SPECIALS3 r'()<>@,:;.\"[]') ATOM_END"-|GX DOT_ -a.') # '.', '"','(' do not end phrases&order to supBobs- } PHRASEh"T5= ( t/?=')) 1') TOKENR<A@(= WP"*'%"eTRIBUT4DEXTENDED_AT* %') def _m(value): TLC+str1.re`@('\\if\\\\')yr'\"')+'"' # Match a RFC 2047  , looks like =?utf-8?q?some`?= rfc. _m?er = re.ile(r'''0=\?# literal =?T[^?]*90set : ;:UqQbB]; 'q' or 'b', case insensitiveW).*3 # e \?=t xp?= ''',VERBOSE | MULTILINE) TAListits subclasse  &(0):  _a = Non syntactic_break = Truew_combine_allowedP_ __init__(self, *args, **kwgsuper().-'K&elf.defects = []f3streXp'.join(x) for x)E?repF{}({})'.format1.__Q__.__name__, m)0@pr!ty@g!x.& C if ]Call_Lcwsum((x.) f0), Ajstartswith_fws_): return self[0].startswith_fws() @propertydef as_ew_allowed(>!):/"""True if all top leve kens of this part may be RFC2047 encoded."""Pr@all(3.}B forJicommentsU = []uWctoken X5.extend(+.)GPB2fol9, *, policyD80_re)_parse_tree1=8Wcpprint%indent=''Y s.ppstr(%)>",  J'\n'.joinuO._ppSQ yield '{}{}/{}('.format(My,S.__class__.__name__%V_type if not hasattrh, '_ppW@ + '!! invalid eleU) '.'list: {!r}D)<JelseQfrom 5+'F!if.defectsMextra = ' D& {8QFG'{})P 0A)  WhiteSpaceTUList( "):BvaluB/ '7:[x.contentx!x.ns3=='J%']Unstructured Ezu4'JoPhrase; p%'H?ord2 FwordeACFWSn Fcfws?OAtomp Fatom12 qH?_" = False!E\WG"d-cte = None chtDlang_QuotedStringEq,!-s-i x 8if  == 'bare-quoted-string': return x.value @propertydef quoted_$f(self)Jres = []-^for x in )( if x.token_type == 'bare-a s.append(str(x))oXJelsej%re56''.join(res)</pp$A} class BareQS( "):9ji'~__str__"Ding(4 )F_R Comment(WhiteSpaceTJOListc1'Ium([`No["("],# .9:(x)&; /")^ T], []mit!, k"if   :I .replace('\\', '\\\\')9; '(', r'\(7)7/)'p@cont. M Ss[k.x]pAddress( a+S-list%ex t3=='C"']dmailboxdusum((x.' )Eall_hy +2ldisplay_name!if.<[0][groupp2YHperty def mailboxes(self): 0if [0].token_type == '3',3return [5]I/elKinvalid-S Led.71es n@propertydef all_% class M`List(T "): b-list'!-)v[x for x inW if x%==]d hc t(w<, 'R4)] 0PGroup$. g),$bif not !or C!CdH d"O  }y "y" 8`2hQf/2][49 X display_name'_l.+NameAddr '`_-addrN_ bif lenS1ENone  local_partjeMF-1].*|SdomaiH&DOrout %Bq__spec )BAnglTokenList):  token_type = 'angle-addr' @propertydef local_part(self):Kfor x in Xif x.klddr-spec',0return x.nodomainQj_route,Aobs-H s_W,H J*Oelse= quote_string(n) + x.ZRK'<>' class ObsRTbList):P& ' lu2[x.!  @k2= ')%']Mailbox( m'display_nam!if<[0]. 6]#(&M)K$G %C_ B.Vs w M(Invalid i.-)BNone2 = [1 = 5 = iD X' as_ew_allowed = FalsXP''.jouper().value.split())YtAtomhft-atomE!Do8OText<_-textETrueNoFoldLiteral\ no-fold-l.^D class AddrSpec(TokenList): t_type = 'addr-spec'as_ew_allowed = False8@property)def local_part(self):dpreturn F[0].)KldomainGSif leF < 3aeONoneyB-1].Xv_valueu"B~10]..rstrip()+412#.l%_ nameset = sen)J.1) >Y-DOT_ATOM_ENDSflp = quote_!ngeJelse=0 is not  EMlp + '@' +X& class ObsLP Aobs--  ^DisplayName(Phrasead(-lXew_combineiD_Deres = dBres) == 0Z2res70res.= 'cfws'Evs.pop(0n 2if QT C61:]lZ?O-1][U=-1]F7:-1tu]=py#iffefects/36Tru'rfor x i BF[if x.`Z"d- 4$~) != 0 andd z pr0pos'>V P"==1 or?[0]! hPl/' f  g#i jApre+5 n )+6return super().value class LocalPart(TokenList): t_type = 'l)a-part'as_ew_allowed = False9@property)Adef tq(self):`0if H[0].k= "quoted-string"26ereturn:+_aZOelse6 /0_ # Strip whitespace from nt, back, and around dots.fs = [DOT]last = DOTe_is_tlV>0for% i" +Q if' Vj'cfws')Ucontinue@if (tok v.appendRZ[1:])A:tok23 = + !=  reyV?1VV;res DomainLiteral$d-"-l.( A w''.join(super(.split()){,ipOFxD Lif x_ptext8x1MIMEVersion/ bmime-v,-major = Non6minParametera p)^wsectionpkextend`charse'us-ascii'bW|_numbern# Because the first1en, attribute (name) eats CFWS esecond#< is alwaysE @here8one{521]./.?0ed / 0Ok@Thisx81 of"handle  jIvs" hack   token.stripped_value if token. _type == 'quoted-string':4?2for92 in $(`_bare-e Am,u4Sretur.p=$ '' class InvalidParameter( 1): Ad2 'i0$-p1KAttribute(TOListDa)'b@propertypJdef f(self) ZI.endswith('}Wtext'Q6.x'Section s''number = NoneqVH |$0 = 1[0]5Kcfws_ C1C Zim(!, }#', 'extended-)  o$EMimest Fmimessyntactic_break = Falses# The RFC specifically states that the ordeA of Is is not # guaranteed and may be re@Qed byO transport layer. So we havN# to assume52231 pieces can come12any. However, wLQoutpum1we first see a given name, whichs@us a&ble __str__."s = {} # Using preservdict from Python 3.7+DI2not)k'Nocontin7[0]S8 != LL<" =P6%()?!ifiIsf[XV] = [E.append((+._,)iV,&tsy.items( parts = sorted(parts, key=itemgetter(0)) first_param = 4i[0][1]&charset = 0. *&# Our arbitrary error recovery is to ignore duplicatexameters,Nto use appearance order if there aIrfc 2231RtM7andgaps. This mimicsS Sof ge".iif notextended j2leni) > 1:<"if[1][0] == 0%)1.defects.1nd(_s.InvalidHeaderD#(pK'xf name;3(s)+d'2C4:2"@# ElQssume\`*0* waossing...not@at tis differentf# from, but we registery "B forSzearlierPvaluejts = [Yi = 0~Msection_number,Pam in .ts:if 3^ != i(*We could fancier qnd looka completeD# ]|0theoond onMseen. Bf1'redoing that=e old code didn'ti-. /(*M Hcontinu.OelseTp"inconsdnt RFCD Oing"mi += 1>1am._ */am ?tryZ = urllibose.unquote_to_bytes(& except Uniz!Enkt# source had surrog{escaped sa. WhaTmdo now}#a bit of an open ques%a. I'm/0sur_is isNbest choice itfw ialgorithmnP  value = urllib.parse.unquote(, encoding='latin-1') _else:-?try!n" =.decode(cht, 'surrogateescapeIexcept LookupErrory "# XXX: there should really be a custom defect for~# unknown acter set to make it easy_find,M because oIwise_Yis a silentL failure.' 'us-ascii'if utils._has_sZ) bparam.vs.append(eAs.Un ableBytesD.()U_partD * = ''.join6 )yield name, Mdef __str__(selfas = []+$8forD@ in 6:ams"ifi FZ'{}={}'.format(2ing)$ [L-#; /#return ' ' + 4 if s '' class PeterizedHeaderV(TokenList):g0# SJhis false so that& doesn't wind up on a new line even#ait and=1s w!fiVre but notJthe firstNHsyntactic_break = F@propertyu&is%t reversed%1if (._type == 'mime-\'.8iV%{}ContentType(R2 'c9-'aas_ew_allowedw@main(LBtext04subVplain)Disposition#dAs_3} = None+ransferE. (7-ftV'7bit6_Labelx header-label' % as_ew_allowed = False class MsgID(TokenList): 4t_type = 'msg-id'N5def fold(self, policyQ # message-id bs may not be;1ed.f/return strQ3) +S.linesepW1ID(sb$InvalidM? Ci/-'oHeaderH h%5# # Terminal es and instances #(q(str):  ATrueew_combinesyntactic_break = :__new__(cls, value,G = super().8)T+. %defects = []2elfbrepr__l-"{}({})".format&1.__h __game__,P&))eRpprin=R + '/' + V@propertyCall_i2lis.(L>1_pp6, indent=''Ar["{}{}/%{}5@,6% B_ Q'' ifl else ' {}')D')]op_trailing_ws# This txtes the recursionzBNone]}commentdr[__getnewargs,<WhiteSpace [ (2' 'Mstartswith_f</V!( # /EW#'(O__st{*__EwError(e"s.*QParse3"""0 encoded word found while parsing Hs.""" # XXXse need to become c6lasses and used as instances so # that a program can't change them inarse treeLscrew # up other p s. Maybe should have tests forq%, too. DOT = ValueTerminal('.', 'dot') ListSeparator*,*dlist-s%') RouteComponentMarke<@<r+$-c,!-m-') # # PDr #  strings according to RFC822/2047/2 5322 rules.HThis is a stateless0 r. Each get_XXX functiona2ept3su # returns eiu$a 6 or a Token4 represent he object named # byp methodantcontain=3rem!und!racters # fromLinput. Thu,rbconsumes*next syntactic truct # of a given typp0a tAA pluc0der]Athe For example, iffirst element;ured heaR'phrase',Q1en:B 0, v! =()*Clete;^Astar&W,Wany # left in0@afte^is removed. _wsp_split&P= re.ile(r'([{}]+)'.format(''.join(WSP))).7 _non_atom_end_matc J0"[^J"I (re.escapeXATOM_ENDS)_K_printable_fin _\x00-\x20\x7F]").(2all?B/_TOKENattributee/ATTRIBUTEiextended_r8EXTENDED_{ def _validate_xtext(!):S"""IfcmPs ASCII non-s, regisra defect.""" LO+1 = a2 if`_#sd.cs.append(errors.NonPXD(|$))_utils._has_surrogatesmpUndecodSBytesqaR"Non-03cham` found~`B")) Iptext_to_endchars(value, endc): """Scan printables/quoted-pairs until5 and return un) ptext. OThis function (s a run of qcontent, c -without-comments, orIdU-g- into a single string by 1anyG<S. ItDs th?, `remainA.1andHa flag that is True iff5re were any o decoded1"""O@frag2, *sder = _wsp_splitter!1)3vQ = []escape = Falseihad_qpfor pos in range(len(~)4if [pos] == '\\'&"2if x  };OelseO 08?2inu-el%in Ubreaku.appendI2 {=1+ 1E=''.join(P4), [e:]] + "2), G def get_fw"""FWS = 1*WSPPisn't RFC defini. We're uN fws to represent tokens whern@fold!5be done, but#n we are parO`D*un*5has alreadAbeenC0 so< do@needwatch out KCRLFG1new1 =  .l "p(= WhiteSpaceTerminalY [: 7 )- M)], 'fws'FTfws, #!enR_wordX - = "=?" bet "?" L 0ed-R "?="2bew = EnWmcif not`startsSS('=?' raise errors.HeaderParseE('"expected1ed found {}".format;tok\Q[2:].s('?=',  if[f'xPPremsttyf1if ,(P) > 1'0[0][hexdigits#1#tok.count('?') < 2# The ? afterCTE was followeda(=XX).  rest, *remainder = remstr.split('?=', 1) `tok =  + ! +D if len(tok>q)) > 1:@ew.defects.append(errors.InvalidHeaderD#(6:"whitespace inside encoded word")ew.cte = valueB = ''.join(26trytext, charset, lang, A = _vw('=?' +Nexcept (VEQ, Key )hsraise _!Ew  format i': '{}'".($ =0ew.! =@.ext`while !if[0] in WSPatoken,# = get_fws(CS$$ew2 ccontin. Q_wsp_1terb vt1 = Terminal(I''v_~Pate_x8(  -[7# E s should be followed by a WS"ifB and f no jG#missing trail XTafterW-Wreturn ew,Q defunstructured(k8""" = (*([FWS] v) *WSP) / obs-+ )  = *((*LF *CR *(0z#) )G5FWS#c = %d0eNO-WS-CTL / LF / CR q 0is 1rolCsacters WSP/CR/LF.>So, basically, we have printable runs, pluVor nulls in0theolete syntax, separat2 . Since RFC 2047 uses th8obsGits specification, but requires \ on eithers of\#zs, I can see no reason to needs;KEnon--v@from* @ yhey occur, so wp@ thiB1to :ens83WSPBecause an ''P must`defini.qstituteRentir,'get' routine does Gac0ain6@onlyQ 0d TLCList1"""a# XXX:what about bare CR=`LF? T.might signal` start or #F end of an encoded word. YAGNI for now, since our current parsers # will never sTus strings with bare CR or LF. 6unstructured = UTokenList()+while value:@"if[0] in WSP tE,$ = get_fws(FW&.append(> 'continuevalid_ew = Trp.startsk('=?')*ryx _except _In~EwError[FFalsxEe;s.HeaderPM# XXX: Need to figur"Pt howregister defects when;s# appropriate here.$2pash17els|have_wsxif len(^) > 0(.*Q[-1]._type != 'fws'=A>.\elD&(L "missing whitespace before*")?% 4if #?and218if 9[-22C== '-;y` = EWWSTerminal, 21],)+ tok, *remainder = _wsp_splitter6, 1K0# Sthe middleatom if t is a rfc2047##ch does not on both sides. The 4be 'edOnext time throughV loop# This needsonly be performF1hen9W;toTwise,? itBan i  can cau#m gob@kfiniteh_matcher.search  P.partition vtP0= V8''_Pate_x6(  # = ''.join(Freturn unstructured def get_qp_ctext(value): r""" = 0This is not the RFC @, since we are handling nested comments in Pand unquot-ed-pairs here. We allow anyth&A'()'Hcharacters, but if@find8 ASCII other thandefined N/, a NonP`Defectadded toFtoken's ds list. SM `converC#ir1ed as, whakPretur!isM@a 'p!' x@. Iis case i5a WhiteSpaceTerminal, so it'scMris ' '.1"""_,&p, _ = _>p_to_endmsG , ):/ =}(>,/_validate_x$ 6jcontenC"""q@ = qQ2 / {PM pDQUOTE KJNyJHN3AnyH POL/soO KN`is a V2J0-""'* =]*4a1"""matches __r) non-ATOM_ENDS2 adb1 InSAText)!toA $aT}!s.>mnon_atom-!ifm aise errors.HeaderParseE(5'`"expecFfound '{}'".formau)= m.group(" =BQ[len((1):]p 1, '! !d!!Rbare_s_string%0""""-"-"3 = *([FWS] O") GA=bwithou@leadqor traiw st)"isGext betweeebP markAith FEIpreserved/d pairs decoded. """ if value[0] != '"': raise errors.HeaderParseE('+"expected '\"' but found '{}'".format(j!)): bare_quoted_string = BareQS(,8# =11:]BC andK0] =btoken, = get_qcontenM.append(ESwhileO y >Zfin WSPZnT 3fws$%elH":2'=?Jvalid_ew = False=:tryxencoded_word3!tdefects)-!In4D# 0N"w w inside  "0.]:Truoexcept  # Collapse the whitespace between two s that occur in a # U--."q@len(4 =^) > 1?if -Q[-1].Q_type4@fws'J |t=[-2G-.')NJ1] = EWWPSPTerminal8G0, ''Jelse zEfbif notj;-$"end of h&areturnX $% [fA def2Fcomm13""" = "(" *([FWS] c_") "")k%  = ctext /-pair / R We handle nes\ps here, ?in our qp-]rroutineO >Y(W#(C = CWG p 2")"(p token, value = get_fws(value) Qelif [0] == '(':%btoken,$H~commentL/se<}qp_ctex=T.append(vbif not_0tdefects8errors.InvalidHeaderD#("end of h" inside U"")zdreturnK[1:] defqcr"""CFWS = (1*([FWS][!) ) / FWS c1"""H0 = ;RList(RwhileB and !in+r_LEADERzfin WSP u&/elJ #nK3fwsDquoted_stringP2"""-@ = [#] Y'!' is an intermediate class defined by this aparserxe RFC grammar. ItTBthe  @without any attached.9A = QS =veY| xGS_8U Qbx Catomxo01*a b1An %could be[rfc2047 encoded word30= AsHgATOM_ENDS!craise ohPE lrxpectedbut found '{}'".forma p.starts,f('=?')6try h_hoexcept [# XXX: need to figure 0howregister*U whenk# approprWBhereT y2 ) atom.append(token) if value and [0] in CFWS_LEADER:*.9,( = get_cfws(CQ'matom.alpreturn DQ defG@dot_S_textPx""" dot-a = 1*a T*("."!) 1""" M = DotAtomT[cif not"or ATOM_ENDS raise errors.HeaderParseE("expected at a start of E"but found '{}'".formaRwhile ?in 4W# '$ f== '.' *N2DOT"*" =A[1:] if[-1] is DOTe0end r A'.'+) g@ = [W]-Any place we can have a2^,ould instead"n rfc2047 encodedYQword. (%(Tf.!swith('=?')/#6try ov_p/oexcept [# XXX: need to figure out howregister defects whenko# appropriate hereq TFelse:Ss ?,p -0"""! = / quoted-stringbEither!*or"C mayqPR. Weto peel off thisj` firstdetermine which type<@. AfterwardaspliceNthe leading~,Xany, into pCad sub-.SIf ne[ or a#is'abeforeQnext special, a Draised. \The token returned is either an Atom or a QuotedString, as appropriate. This means the 'word' level of formal grammarknot represent~Qn thePparse tree; t\"is because having that extra layer when manipulat# Nwmore confus%Pan ithelpful. 1""" if value[0] in CFWS_LEADER: leader,) = get_cfws(:)(Lelse2b = Non0if 2(raise errors.HgPE(Y`"ExpecJ`'atom'!'q!-s' but foundlbhing."V=='"'$ U_U H.SPECIALSO  "a'{}'".t J2m#if1B[:0] = []8dqMQ def+cphrasegMB"""  = 1*word / obs-U1 = '!*(q/ "." /)TKa^can be a sequenceAs, periods, andH1any}0ord)`s longit starts with at*ast one. If anyty! oiAthanOsU1detv ObsoleteQDefecadded to2UA's dNlist. We also accept = followed by a dot;Lregisteredan Invalid@, siDQ `supporb81eve xB = P2try!nNvGI'J.append(5M!ex^hA`sI7 ?P doesw&%"")SwhileCq vGin PHRASE_ENDOpG=='.2DOTj.{ C"$'O'" =2[1: ~ +   if value[0] in CFWS_LEADER: btoken,4 = get_cfws(E)3phrase.defects.append(errors.ObsoleteHeaderD$(G"comment found without atom")~OelseYraisegQrreturn Q deflocal_partpA""" -p = dot- / quoted-string / obs-, 1"""_@ = LlPkl4b = Non6bif not~5 `ParseE "expected$bu'{}'".forma86tryp @dot_Gm$oexceptO\`Hword\'`,!= '\\' andJdPHRASE_ENDS=d@ = TzRList(+2if 1 isQ7[:0] = [)]XS+U Q[0]==&or7in )|Fobs_g  V(str(+2) +c if!O._type == 'invalid-G'FcIF"Gu,@, or"Z)a|(contains)=t9 0.1.encode('ascii':0UniE"-H!NonASCIIAnon-? characters  s0 = ?a *("."  Me = Obs last_non_ws_was_dot = FalRwhile#" if value[0] == '.': if last_non_ws_was_dot$/$obs_local_part.defects.append(errors.InvalidHeaderD#(nJ""i* repeated9"))- sk:DOT'y = TrueN1 = I[1:]gcontin3Celif,{0]=='\\9VlTerminal(l90],l 'misplaced-special'\ (" character outside of quotptring/cD /_--tJ! =NO-WS-CTL /;Qpair 1We allow anyth,a0thelVludeds, but if we find8IASCII other than the RFC defined printable ASCII, a NonPDefect is added to the token'sJects list. QuotXairs are conver9!irL2unq*values, so whal` returis a ptexto, in this case aJVATerminal. Ifre were f-s, an ObsoleteHeader  1"""!, , had_qp = _get__to_endchars('V'[]')?9 = (91, '*#if^:9!.ds.append(errors.(:>"% Pfoundmdomain-literal")_validate_x1  def _check_for_early_dl i_i)"ifO_QFalse 8 !In"end of input inside O e b']', '*@S-end'4BTrue/Y ;""" = [CFWS] "[" *([ d") 3"]"$  hA = DL(n0[0]kv_LEADER0 = 3cfwG p1=%mif notSaise `ParseEp("expecJ_f"SUf!= '['rY'[' at start i R"but .'{}'".format" =A[1:]i#yK=\  [ 6WSPQs!G@:`JIPOue[0] != ']'3:  raise errors.HeaderParseE("expected ']' at end of domain-literal "OV "but found '{}'".format(value))0E_E.append(V"Terminal(']', '*oS-end'DP1 = A[1:]Z"ifB and [0] in CFWS_LEADERbtoken,( = get_cfwsQ =creturn(XQ def[G]3"""6 = dot-atom /r / obs-@1 = 8Q*("." 1)) (""";A = D(lq = None0?5 66bif notYHr 'Vf== '['{ Y2if 1 is$PT[:0] = [-^+u 0z6tryd5h@dot_oexceptO KB >L@L 'Invalidk'O KG.?tdefectsObsoleteD$("@a(containsY#)"5#ifA[0].`_type G3g [:J 0KRwhileLK2DOT TF /N=!addr_spec- = local-part "@ /I = AddrST Q_QxD2 oreH!= 'ELKB with no1Fa6 :@::ess-at-symbol')) token, value = get_domain( [1:]) addr_spec.append(:freturn#PQ defSobs_routeV!):S""" obs-! = }-list ":"((= *(CFWS / ",") "@" *("," [6] [5]) ORAs anv with the appropriate sub-s (that is,Mthere is noN!inLparse tree).8"""q = ObsR%VSwhileBand <[0]==',' orp[0] in s_LEADER_7/if%$Bcfwss'  (eluj== ','m BListSeparatorn# =11:]>bif not W!= '@oraise errors.HeaderPE(L"expected but found '{}'".format ComponentMarkelhQs T:p (o Ck? gkXUbreakC  6j3sh /- dB; "end of h >6ing"a: ':' marka}"| !V[Terminal(':', 'end-of-Y-Ber')P\/T`angle_8U-$ = 1"<"-5 ">"/W3 Jf ThD@ = ARAddr(7Shue or value[0] != '<':  raise errors.HeaderParseE('.$"expected angle-addr but found '{}'".format(value))@._..append(VTerminal('<', '&Ts-start'>J1 = A[1:]T2# Although it is not legal per RFC5322, SMTP uses '<>' in certainFcircumstances.#ifl0] == '>. >4endC@tdefectsrInvalidD# Pnull MP-specU:"4k0 8breturn,6tryStokena = get0_z5oexceptFP]aobs_routea,.@ObsoleteAG#"o' j ificationScX/\2ddrror obs-hH!lc!I #B and<[-Felsegmissing trail S'>' o m in CFWS_LEADERfLcfws9A defdisplay_nam.C""" - = phrase Because this<simply a ,-rule, we don't QG@ conPyaf,rather a9 5BwithD!heBent of theD.1"""(B = DN.X tF@.ext92[:]G "" =s[3% SC = [E] 3M0 = RAddr(a# BothA op"alyay name and &the angle-addr can start with cfws. leader = None if value[0] in CFWS_LEADER: 6,)p = get_T(:)(bif not'>Braise errors.H`ParseE(A+"expected nambut found '{}'".format()f!= '<'in PHRASE_ENDS$|G.jZtokenVdisplay_^q]$ifC!isH @3[0][:0] = []]_.append(K0 ,0* H} areturnpQ def smailboxC""" ! =< / a-spec 1"""# The only way to figure out if we are dealingaYSor anJc0 isJtry pars9each oneMq"ry60yoexceptP]a_&a,e,&vif any(isinstance(x,rInvalidbDefect_ Pfor xna.all_d2&s):.$_type = 'ig-' M!N_ , endcharRead everyth[ upmpone of 1=.@Thisqoutside,l grammar. A T3List that ised acts like a 3 , data attributesM : = (RwhileB and E%in. V Terminal(value[0],  'misplaced-special')) Avalue = E[1:]Uelse:4btoken,+ = get_phrase(> Yinvalid_mailbox.append(D*{return )`Q defcAS_listiC""" -C = (U *(",)) / obs-mbox+  = *([CFWS] ",")^N[]!/ $!) GdaddresLt@ = mailbox /x)Note that counter-intuitively, an Acan be either a single!or a 8Res (ar). ThisWwhy the rBed A object hasP' estribute which treatsaalengthNone. When you need to differentiate betweentwo cases, extractRelement,&is!8 .za# The l grammayn't very helpful w0par}$. #B, especially>allowingn obsolet{s, start offwMsimilarly. It$onNBreach oneP@, <,:R!CknowLwf you've got. So, we try H0in Awithw2mor# likelyuE0twoe could perhaps mBake this more efficient by looking # for a phrase and then branching based on next character, but thatLwould beQremature optimization.)address = A !()Atry: token, value = get_group(1 except errors.HeaderParseELY]xmailbox_*c,_raise(+"expected Ofound '{}'".format+.append(&dreturnL:Q def=9D_lisR!4"""5C = (-U *(",)) / obs--H  = *([CFWS] ",")^N[?!/ $!) GWe depart fromnl grammar herepcontinu@to pa until51endP!ofinput, assum21he 0 toentirely compoAf anC@. TOis always truK e:Aing,Callows usGto skip invali es@addi  alip2es.1"""G;LPwhile@"uee TXZhm*ut#" 0 as3ly = Nonep"ifa[0] in!z_LEADERBF#Ocfws0bif not`2 or in== ','a5u$ 0tdefects9ObsoleteD$U"R entry with no ^ent")7elsM3 6_,YC2if 1 isT@/r[:0] = [9]% n!([F] :wIviZ s(elQ "empty elemin address-listW")) Yelse:token, value = get_invalid_mailbox(Z, ','Q?if leader is not Nonf+j[:0] = [5]address_list.append(A!([B][ 6tdefects>errors.IHD#(~L" U4 in -W#if92and `[0] !=, k# Crap afterO; treat it as an zy.c# The  info will stbe available82=w\j[-1][0*.g@_typ'-'+>#P@.extJ `.(!: # Must Z , at this pointb VPTerminal(',', '>-separator'f# =G"1:Uretur oa defno_fold_literal)p""" no- -  = "[" *dtext "]"""" M = NoFoldL]!ifi<craise rk`ParseE o"expectedbut found '{}'".format~zn/[',2'['e start o 6" K [ -# 2 *;Kc#or]X.]X?endVY]V4endTY !O[_cmsg_idWi"""msg-idCFWS] "<" id-left '@' right ">" [% (= dot-atom-c/ obs-F-I. 6 / obs-id-righ2t no-fold-literal = "[" *dtext "]"("""msg_id = MsgID()if value and [0] in CFWS_LEADER:*rbtoken,( = get_cfws(CQ'j.append(5cif not@"or qf!= '<'i raise errors.HeaderParseE(m"expected msg-id but found '{}'".format VTerminal('<', 'L-start')6# =11:]!# id-left.6try 6dot_atom_9oexceptTac# obs- is same as local-part of add-spec9Aobs_;_;1EtdefectsObsoleteD$ C#"o'>z{"u',:/>@dot--8 orPA0"geJ @d Invalidc"K with noeXright\# Even though there>.@, ifJ  b# endsa`>` let's just(se it too^greturn;Ralong<Bthe IW== '>"&p >4end8V3_ido @oaddress-at-symbolvnCD_0no_b_b  eU xldomaino-2{#G z, 03, no-fold-literal or obs-id-right" " but found '{}'".format(value))5msg_id.append(token1if (B and [0] == '>':;s#=!11:]Felse$ctdefectskerrors.InvalidHeaderD#(D^"missing trail '>' on msg-id"VTerminal('>', '0S-end'4in CFWS_LEADER, = get_cfwsNQQretur3_idH def parse_message_idT|3"""0-id = "M/S-ID:" Q CRLF""":c_id = 22ID(2trycVW)S;Ssexcept PEk as extLunstructures3 = 2 sP'N"Ve: {!r}>3ex)@ !# va aftera1 idKshould be None.k TB"Unexpected3W_id # # XXX: As I begin to additional hers, I'm realizwe probably # have two level or routines: the]XXX methods that1 a R in #*qrammar,H 9 an entire fielp. So #\_address_list above  lya_,. #)9. #ime_versiona""" mime-@ = [] 1*digit4"."  T# The)is implicit he RFC 2045 BNFDThis is a bit verbose,P factAut aE3intNCIMEV2`if not&u4 .MRequired A#P MIMEt number (eg: 1.0)"1 T &-\G  mi0me_version.defects.append(errors.HeaderMissingRequiredValue( "Expected MIME Y number but found only CFWS"))Edigits = ''pwhile vfB and [0] != '.'anot inP_LEADER:EY%+=C^11:]0if P81.is &()R/mi3rInvalid:DV , (_major.{!r}".format(#s)8 Terminal4, 'xtext'<OelseE= inqop"if ctoken,2= get_cfws(5;#5 dRH9if H!is 7Non* w8H"Incomplete3;)E1=Q  ;ireturn Sc'.', '-separatorr k W8uKmE7 ine7`7 mime_version.append(token) if value:mime_version.defects9errors.InvalidHeaderD#(@D"Excess non-CFWS text after MIME `"")4 xVTerminal(@, 'xN';xreturn > def get_i_parameterD)""" Read everything up to the nQ';'. This is outside#formal grammar. The Ps TnList that isPed acts like a 5@, bu0 e data attributes are None1"""O - =(mRwhileB and [0] != ';'in PHRASE_ENDS$( f/A[0],9'misplaced-specialE# =51:]g7els0,+! =+cphrase ;- [FT +dtfF1""" = We allow anyZQTOKENA in 38Cadd '{lif we findTF characters. xso regis@1for)Q*any*>printablesTn though,RFC doesn't exclud0 ofmqbecauseo`spirit*EK5322m = _non_D_end;jif not mwcraise `ParseE expectedhfound '{}'". toK= m.group~ Alen(() : = ;1, ''__Aate_G. @ = [A] 1*<equivalen(!isUS-ASCII@sept space, ctls, 3t`?tab? pimpliesF i|iplicit about it)che BNFGAm<" = (!inir_LEADERDOBpVCcfwsl'jEnm "expected token but found '{}'".format(value)) )!,  = get_ttex%$mN.append( =#if92and [0] in CFWS_LEADER:CkCcfws'nrreturn Q defGattrw4""" = 1*(any non-ATTRIBUTE_ENDS character) We allow 04in X,fadd defects to theH,%'slist if we findIAs. so registerObfor *any*Aprintables even though RFC doesn't exclud1 ofPthem, becauseothe spirit ofER5322.1"""=m = _non_ibute_end_matcherif not m  raise errors.HeaderParseE(_'"expectedrqO{!r} = m.group(T[len(+1):]y@ = V)Terminal)4, '$'U_validate_xu*4@4'P""" [HD] 1*<This versionBNF makes? explicit, as usuala# t `N0act+!ru`%1Theequivalen+LiR, wit@subtx'*', "'"A'%'.QRWe in0tab_d set just as"do iq = Attr Bq<   4"}#7%q Y ZextendedU plus '%'&is a special parsing routine s  atRget a%Q thats % escapes a E`le strN`(whichE@decotBinglgstring later). """m = _non_extended_attribute_end_matcher(value)3if not m:M raise errors.HeaderParseE('+"expected q q text but found {!r}".format{|,= m.group(1 = T[len(+1):]@ = VTerminal)4, '--'^_validate_x3ereturn, def get[B""" [CFWS] 1*l This is like the non-3 version except we allow % characters, so thatP we can pick up an encoded as a single string.?# XXX: shouldr@haveHEOAN TokenList?{bg5 = %$ifnp[0] in &r_LEADER<StYu! =rCcfwsdm'q.append(8qEXTENDED_ATTRIBUTE_ENDS}"zO'{}') !"UE ssectionT '*' digitsmAThe Pl BNFmore complicaMbecause leading 0s artqed. We PcheckQ and add a defect) also assumFyyQed betweenPI , though0RFC>7crystal clear on.IdcallerQalready Vdealt with UC = S_ 2 oraWb!= '*'~( $"EiN )R c'*', '#-marker'9E1!or a[0].is/()'anumberL 3 ")as = ''@Rwhile,<+0value = value[1:] if digits[0] == '0' and! !:+/section.defects.append(errors.InvalidHeaderE(:>"C number has an i; leading 0"))</./b= int( !ValueTerminal)2, '2'Usreturn \0, v5 def get_()""" quoted-str/ attribute 1"""Av = (bif notdMcraise 92RParse7"Expected7 but found end of "b5er = None"if9in CFWS_LEADER6! =CcfwsH8  "only {}".format(&"'Ztoken_1Oelse: extended_?!ifQer is} P [:V" [rv5vparameterz`# [] ["*"] [R] "="1Theimplied by the RFCamade explicit in!BNF. Thiss@fBGBNF from3T1is Oato con+Ewith 1BNFPthrough som|tra checks. We do it this way becausemakes bothINrecovery@workx`resultpn tree easier.?@# It,spossibl=would also be citly allowSRetwee7W#''W-' marker (!Q*') ,we've never sW#atP wind we will^refore ignTRilityYE = Pa@2 or;AH Dek%("Mjtains P"name ({})<"no}E)Ev a*2tryAV>1/*l.!ed = Tru#^bexcept,s.6 2pas9value:   raise errors.HeaderParseE ("Incomplete parameter") < if value[0] == '*':$4.append(V* Terminal('*', 'extended-*^-marker')fJg# =o?1:]hMq = True"W!= '= P not followed byF=! se %tolj = NonC and0] in CFWS_LEADERwbtoken,( = get_cfws(nTm4remainderBto =ZEw "w4# Now for some serious hackery to handle the common invalid case of # double quotes around an . We also accept (with defectPa;d as encoded that isn't really.qstring, ?{"d_ ainner_3 = D.,Bppedc@semiid = Fals"if.section_numb6= 0*u:"'"6: ^Nelse4W#stattrtext(v}Jqif restF  0?try>_ exPUEpass!if_D!6if  =sILD(v "QQ d #ngs4 is"?( St Qif t.KQ_typehRbare-\-`5t[:] = [/t%Ybreak Y)RP but 2arsTve a "  "quoted string value that is non-encoded")) 4#if$2and [0] == "'":"&token = NoneKelse,?q = get_y(inot param.extended orsection_number > 0_0if ;M2 !appendto. (if remaindertr&fassert~ & =W "breturn Btdefectserrors.InvalidHeaderD#(Y"Apparent initial-Y-but attribute "= wat marked as >eZ 88p# Assumre charset/langg@missjAthe  .+Mjrequireddelimiters/8 4 A +&ifAH@for ( dhB.<P_type'-^text'8<UbreaketKB '  RQ = t.Cfcraise P=E p("ExpecqRFC2231XV " , #found {!r}".format VYTerminal("'", '-^'e" =%M[1:] ''BhUs ?#=q %1T^ # Treat erest owzs bare vcontentAv = s(while value:' if value[0] in WSP: +btoken,( = get_fws(8).(elPo== '"'P@ = VyTerminal('"', 'DQUOTE'Wn" =K[1:]y/sei qcontentv.append({s(elk c`V/to_if remainder is not NonaassertYlGreturn param2@ defse_mime_DeterA0"""& amh *( ";!) aThat BNF+meant to indicate this routine should only be called afterKf7 ng and handling the lead ';'. Thereono correspon qrule inM8 formal RFC grammar, but it?more convenient for us=aset ofL!be treats its own TTList. isfu'parse'pbecauseconsumesw8Wnever9 to se a full header. Insteadc$isg!toK J0ythnEnon-_ of a specific MIMEg1"""W H = MimePv>"s(ERwhile[d6try KgO, }^&except errors.H-PE0 as xAer =Iin CFWS_LEADERB,F c8&ifJabq 6;!ifn k /tdefects7rInvalidD#(z"& entry with &*")$ Bi)<+[[:0] = [ % 5 * .C derDefect(  "invalid parameter {!r}".format(token))) ;if value and [0] != ';':&.# Junk afUthe otherwise8s. Mark it asDP, but!will have aG9ue.1 = mime_ ^s[-1](._type = 'k-7'3-,us = get_2i(.Os.extendP X .defects.app2errors.IqHeaderD#(Gk"lc with trailing text `Must bw';' at this point V6Terminal(';', '0-se Gtor'lQ" =w2[1:lreturn def _find_yClist)"""Do our best to > us in anNaMIME h 1"""Awhil E;in PHRASE_ENDSs  E[0], 'misplaced-specialHeOelsew(ophrase bif notc2,& @]parse)R1:]))$'qcontent_""" main!q"/" sub g*( ";"4) 6The1!Asubs2Aare s. Theoreticallylqy couldbe checked again=0ffi` IANA 3Q + x-T!we@don't do thac2= CRType(recover = FalsIDMissingRequired "#  fication"0 z2try1sexcept KP*E]Lc"Expected<Zfound|] ')) # XXX: If Bwe really want to follow the formal grammar we should make # mantype and subt %specialized TokenLists here. Probably not worth it.O!ifvalue or [0] != '/':%xctype.defects.append(errors.InvalidHeaderD#(9=""` conteeype"))%"ifzp7_find_mime_parameters(,0Bqreturn W B.mai.0= t..strip().lower(F1VTerminal('/', '- 0-seCtor'Y" =A[1:]6tryq = get_(<sexcept ZS`ParseElL%ExpectedIbut found {!r}".t4j ];6POnly @ areid after^2 , \"B"k# The RFC requires that a syntacticOiu be treatedy# as text/plain gerhapsopostel thispMPo"do ifHwere checking against IANA2del,>u0 ;<p 0 @ def33se_P_disposition_hDpG""" #`*( ";"I1 ) """b1MB = CwDiB=MissingRdJ #"#y>Fi DU".format(valsue))) _find_mime_parameters(disp_header, value2wreturn #M.append(token9content_osition = -.l.strip().lower(Bbif not:r"if)[0] != ';'3w.defectserrors.InvalidHD#(rvf"Only 0@ areqid after %z, but "Hfound {!r}".format(UVTerminal(';', '0-se Ctor'1;]parse@C[1:]9@ defC3se_._transfer_encoding""" mechanism O"""W# We should probablyaate thues, sinclist is fixed.O3cteyB = CTE AaZMissingRequired h#P" ""ae~2try9#eq = get_b1sexcept PELhGExpected5& OelseF?cte{-N>Cwhilhr%Extra textc in PHRASE_ENDS 40], 'misplaced-specialH, =y ue  hphrase)j?b # # @ folQcomplex, with lots of rules an rnases. The #Slowing code does its best to obeyuHRhandlx coS@ # cUyou can be sur(!re\few bugs:) Tholder generally;onicaliz0 gopreferring the stringified # version of each token. The s contain informat/that supports the # folder, including whiSs can be encoded inways. # # FAd text is accumulat.a simple lists ('lines'),` # one!`should{0lesan policy.max_<_length ('maxlen') def _steal_trailing_WSP_if_exists(=s): wsp = '' 1if B and J[-1]bin WSPBF< Q& =TQ[:-1]#`return re_parse_tree( C, *,B"""RBYB@ents <d!orto RFC rules. 1""",# f00/Nmeans no limit, ie:cinitely long.B# = `or sysAsize3e= 'utf-8' if@utf8 else 'us-ascii`b = [''Rlast_ew = Zwrap_as_ew_blocked = 0Gant_zDFalsd1not_allow5Terminal('', 'X!')V pab'stawhile #C.9b.pop(0-C!ar_,enC+Q -= 1  2inu`tstr =dty.`_type == 'p'@set(?) & SPECIALS1# E=*s special characters;w(Tr*ryh\.!e(6ingPhRset =5ingexcept UniZErrordif any(isinstance(x, e(s.UndecodableBytesDefecLPfor xLa.all_d-''unknown-8bit"!  :# I?@is fc this c`reallyjtaken from aI3# '' property onF 41a "  zmime-parame0'Q# MimZ Q0(usRFC2231)Textra x_kKs,,Elen,I i9onta:if aNnot  if not part.as_ew_allowed: want_encoding = False&last_ew = Non1if lsyntactic_breakn}m0ed_2" =9fold(policy=s)[:-len.linesep)]S=( not in l?# It fits on a single sn30if `) > maxlen -Aos[-1]){LQ# But`on thie, so start a new one.G0newr = _steal_trailing_WSP_if_exists(%/s)K # XXX what ifE has no lea1OFWS?K n.append(}.39 +=xd~continu# EitherRiKemajor  mwe don'tk # %2 it by itself even&iCo, or iEadoesn'&I$. way, fall throughto unpackpthe subQs and wrappm6!ifjhasattr(42, '''=Terminal, do each piece individuallyods = listq1) +sNelse)5a t|a& word, possiblyZ# combinit with previouslyFs1 __`a(tstr,3#s,#, +,(B.ew_e, charset7 C) <= ; d0# T is too long tob. The RFCT0s u#& a6?# "!s"tunless s consid#u be:D0eck ll<Anext1if .4ik$1c X!!orE.%s_fws():  lines.append(new + tstr) $last_ew = Nonevcontinuif not hasattr(part, 'encode'):Aa# It's0a terminal, try folding the subG)s.=1newq = listj &.as_ew_allowedRwrap_$blocked += 1q(u>0endX4not\ |Ds = 81 +  YD& A and+ V doesn't need CTE ing, bute it anyway so we can # m: it{s.insert(0, Twant_sW = Tr#I 1# W't figure out how toP, it,vgive up= _steal_trailing_WSP_if_exists(s!or.startswith_fws(@u 8Lelse0olduAontoPnext X either..'Ps[-1]return policy.$sep.joing p def _V2(to!e,s, maxlen, , ew_combine, charset@"""F1strT i3 asnd word, T03if Rnew value for!or? if is False. ' Ifd realready an0 in$a1 ofs (indicated byP`a non-)2|true, denM$ew} 1re-LPe. O'Swise,N1S. InM0 ca'VsplitSnecessarFthatd segments fit #in!]1"""z!if=#i!q = str(Lget_unstructured[ :]o)t*!ne=#[:7]g&if0[0]6WSP@'re Q@thisRd tex dog^#PA leaRblanki_wsp =@ 2[1:Ecif (leC) ==' lines.append(_steal_trailing_WSP_if_exists(lines)) [-1] += lead31wsp!Dwsp = ''if to_encode:qin WSP:W# Likewise for the Ju space.+_b X%n' =zA:-1]#new_last_ew nT) if is None else B0_as`utf-8'9charset == 'us-ascii'??# The RFC2047 chrome takes up aracters plusalength~A# ofUC nam#LC_lenR) + 7Gif ()+ 1) >= maxlen raerrors.HeaderPE(P"max_z gth is too small to fit an d word")VwhilePemain_ X - leTtext_-r?-i25F<= 0Ps.app)6' 'continue_ 0.B_ew.(J#, =6_asPexces dRK) - w;>s# Sincef0unk[guaranteed`into lthan 100,v# shrinking it by eat a time shouldn'tV longA e[-? = f#Ij!D]2[6):]k  pxreturn Fif ew_combine_allowed@ def _fold_mime_parameq(part, r,,&Bing)"""Fold TokenList '7!' t-'A0' l0as f f.5 Usr0 ded0'of+ and values,0matpm accor1 toHpRFC rul,Qinclu ug52313\ cannot beKexpressed in '"@ing'/+A`J@withD'1"""# Special case for +RFC2231 encoding: start from decoded values and use # : iff needed.# Note that the 1G2s being ada!tolength calculations arqpaccount61for1possibly-xS spacpsemicolCwe'll bem8ingIRname, in part.params:PXXX Wif this ';' puts us over maxlenfirst timProughNloop? We should spli!cheaderonto a newlineIWcase,Obut to dGQat werecognizearlier or reparsN, so I'm gosto ignor-qat bug =pow. Itb@only7 usNone charactu2verWpif not s[-1].rstrip().endswith(';')5.0 +=lfUset =error_handler = 'h5ct'!:tryf.!e(Eing)0_required = Fal""xcept UniIEd eE lI2TruH if utils._has_surrogates( $1'unknown-8bi%]fescape&.:lsemFtf-84%if) @1ed_ = urllibse.quote(xp,, safe='', !s= 0tst"{}*={}''{}".format(,EeS0'{}R Ns_stringKuif len(1) +Q 31 ) co/H#elz+iO2 <=j.append(_ `# multiple sec.are allowed4mixnc# non-C ,  we5n't[1kmfhE = 0dextra_chrome ==e+ "''"&Rwhile 9_=ESCstr(t)3t K#if\:+ 3xxgAroom[0leap blank,` trail, - # and at least one character of the value. If we don't # have that, we'd be stuck, so in case fall back toIsRFC standard width.*maxlen = 78splitpoint = maxs 0- chrome_ 2<while True:partial =&[:i]-encoded_< = urllib.parse.quote(4e, safe='', errors=_handler)<yif len(w6) <o]breakMY -= 1 lines.append(" {}*{}*={}{}".formatname, section, extra_*, *Y = ''Q, +u[:"if@[-1]\%';' # Copyright (C) 2002-2007 Python Software Founda5ntact: email-sig@p0.org """E address @ing <+. Lifted directly from rfc822.py. This should eventually{rewritten.f __all__ = [D'mktime_tz',|]edate%!] import J`, calep SPACE ' EMPTYSTRINGu' COMMA", ' # P0 a field _month;['jan', 'feb0mar!ap0may!ju#3jul@'aug$0sep0oct0nov?dec2ajanuarZDfebr Pmarch6Papril eOjulyOQaugusvseptembeCocto 5nov2dec v] _day !mo!tum0wedt0thu0fri"sah@un']_1Thez@tables not include military- .s defined #RFC822, othern Z. Accordto RFC1123,<pdescripP in #822 gets!signs wrong* we can't rely on any such" # . Ig recommendPat numeric/ indicators#usQstead1ime)c@. _y{'UT':0, 'UTC #GMZ>e 'AST': -404!AD 3 # Atlantic (QjCanadaB 'EE58"'EER # EasternxC363C3@ # Central 'MST': -700, 'MD 6 # Mountain "'P48'"'P4700 # Pacific3 } def parsedate_tz(data):*"""Convert a string to a time tuple. /0Accs for military'azones.%1"""~res = _{if not resRretur if[9] is None&s1= 0I5R(res)xCto extendedJThe last (additional) element2the6 offset in seconds, except if/.pwas spe ed as -0000. In that case 3vK. This indicates a UTCRstampHexplicitly declaims knowledge oRsourc,Poppos+ _~1the H really 3UTC\(  R =a.split()=bhappenwhitespace-only inputh # FWS after~Wcommaday-of-week"op, so search and# adjust13thi#!if[0].endswith(',') orplower()Mx_daynam+0re' here. Skip it4delT7elsMiUQrfind)=if i >= 06[0]<a[i+1:]7bif lene == 3: # RFC 850e, depre%RVstuffP2'-'#Y*)Zq1 = +k/a[4;"[3K"s.+iz&-1@ 0 ?i >> 3:?[s[:i], s[i:] b.d('') # Dummy tz&V) < 5.*#h":5s[dd, mm, yy, tm, tz+4mm = mm.Qif mmin _monthU:I, dd>B& p.index(mm) + 1F> 12mm -= 12!`dd[-1]6','' ddRd[:-1 #yy : 9! =>$yyf)yyf yy = yy[:-1] if not0].isdigit(): yy, tz = tz, yyif tm[-1] == ','. tm*m_.split(':')Bplen(tm)C2A[thh, tmm]I-tss = '0'Welif A3AW, tssF 41 and '.' in&0]E# Some non-compliant MUAs use4 to separate time elements. $0].  0g  /K Felsereturn Noneb " 6try?yy = int(yyP#dd&dd3thh7thhm2B7tmm"ssexcept ValueError # Check for a yy specified1wo- mat, then convert it to # appropriKfour<according6 POSIX standard. RFC 822NPcallsyE a tq1but,2822 (which obsoletes2822 0# m^3a 4yy. For more information, seeP docu#thbmodule if9V< 100i # The year is between 1969Y1999 (inclusive)JNF> 68Myy += 190dA2000dO2068d ^;tzoffset =r.upper(_z*_VzonesE2[tzZ +=zqApass "==tz.startswith('-'3z3# Ca Wconds ; -0500 -> -1807 < ;sign = -1v4= -! S/GF6AzT* ( (//100)*3600 + %B)*60# Daylight SavT@flag;to -1, since DSTrunknown[`mm, dd`q, 0, 1,G] def parsedate(data:"""@ str toEtuple."""6parsedate_tz(data) if isinstance(t, tuple):!return t[:9]Nelse def mktime_tz(dataG@"""TDQa 10-`B as Yed by parsedat:) into a POSIX Qstamp."""0if ^[9] is Non # No zone info, so localF. better assumption than GMT[Bime.[:8] + (-1,)< t = calendar.o!gm8,Y$ -6quote(str1Prepare string to be used in a 2d!. ds backslash and double/ charactersbEpairs. TheseJythe only6that needAninsideDoes not add Tsurround!s.{.replace('\\', '\\\\')""') class AddrlistC0"""2essm"r +by Ben EscotoIpo under0d wCthis2does, it helps 0havcopy of RFC 2822 inPfront3youbgNote: Uinterfacedeprecated0mayRremovHbfuture5Use email.utils.PList 2ead)^__init__(self, field"""Initializ1newM)'`8'Ran unrmbheader], containing@tor more5e  .specials = '()<>@,:;.\"[]'S( po#00LWS8; \t. CRK\r\nF2R=!+ *CRXpatomendr 0; tet5Anow ?fies `.',obs-phrase, meaA7%it#obsolete syntax. Yrequires9we recogn6L@@allow dot7 .'9>" =!pcommentR = []gotonext Skip whipP0ext RsJV&wsbRwhileHQ< lenm.s."if+[@pos] b'\n\r'6>5?in 7?w.appendn self.posw += 1 elif self.field[ pos] == '(':.9"commentlist.append(3get9());NelseMUbreak( return EMPTYSTRING.join(wsi!) )def getaddrx)Z"""Parse all %besses.<Re@s a ? containing2hof the941""" result = []RwhileKpos < lenZBBad =-Jess(2Vif ad6|U+= ad}b/w('', ''t'&ba(Dnext-."5. h ,@goto@(0old=5posToldcl4Y!pg\etphraseazu.W/>= # Bad emai{ technically, no domain.`}1if b(SPACE"),DR[0])][kin '.@#is just anIspec # this isn't very efficient since we start over<W"=  &)cl%L M I WI)*:'#/ es a group Mlen p DA sL%< 2and >;Pl "  4 +R<e# AddrDn a rout 3|H :%8= [') + ' (' +: ' '.join(self.commentlist) + ')', routeaddr)] Yelse:`returnA = [(SPACE.join(p)P?M1if 2cvself.co,D=[0]1if /afield[ rpos] inspecials,e += 1 gotonext()ipos < len(*xR) andpj== ','~9Hzos eudef getw)Q"""Parse a aess (R-path value).SnThis method just skips all theKQstuffsaW.5""" ( [!= '< VRexpec = FalseX5 adBU = ''BRwhile} T!7if  zetdomain)>  l+4>+2s 8Ubreakeb @b 6Truo:oIb 4get#-0JJ |~<n RFC 2822-7.#as"[][O.preserve_ws = } .3if 3not[-1].strip(7O.popappend('.'r@ 4B " "%s"' % quote~B.get*))matomenda.pop()  ebreak  else:aslist.append(self.getatom()).Rws = !otonext(!if preserve_ws and wsr Ews) g"ifapos >= lenfield) or[pos] != '@'j return EMPTYSTRING.join(t6'@'bU += 1gedomain$"et%rif not  # Invalid#, an empty address instead of#Uing a# local part to denote failedYsing.3n/ J# +Udef g,)"""Get the complete= name from anE.""" sdU = []Rwhile3<2z^ ?"inC:LWS15.] /elQ[== '(2Lpcommentu3get yi [i, _xliterale.e, ''.W 2# bpo-34155: Don'tAs with two `@` like'?# `a@malicious.org@important.com`3 VUJ?end X>relimite, beginchar, end s, allowjs=TrueParse a header frag$ d] by special Tracters.'\`xA' is st.A for^I+9TAlook t@$@ance%fEthen?p1str&0`sa sequee-@ableA-s:stops when onPtheseencountered1AIf `jnon-zero, embedded RFC 2822 comments are allowed within the parsed frag0.$5""" if self.field[ pos] != beginchar:.ereturn '' slist = ['']quote = FalsebU += 1Rwhilepos < len(+)1if ] w.append@)s/J /el`in endsO QYbreakg"nd  == '('t 3getO.()continueP# havMready advanced Vfrom O /\\p6TruOelse  }EMPTYSTRING.join(0)0def<v"""Get ax-delimit] &~1's .f E.get@('"', '"\r',) 9parenthesis9() domainliteral)Pw6 an2-3'[%s]' % "[]K Aatom , ends=None.-.}OptionalE specifies a diffejp set oft token %rsm(}default is to usw). This uue.g. inEgetphrase() since ings must not include`.' (whichMis legal inC)s)i &if0is Y 9" =Z %in TL )O*a y` sequeof RFC 2822 phraseSs. 4A phrase is a sequence of words, which are in turn either RFC 2822 J atoms or quoted-strings. PcsFcanonicalized by squeezing all@runscontinuous`tespacqto one .65""" plist = []while self.pos < len(ufield):>"if+['@pos]  :FWS15]I+= 1O/elQn== '"'Lr.append1get^?())\(\pcomment* gi"in.PNends[break.se(`c&))!re< class AddressList( CX"""An& encapsulate1eparsed" aY4es.tdef __init__!, 9j .-"if? |=u0get(,el]@ 3lenZ-k0essn=3add=0, o%D# Set union0newK( =V(None$.)t 5[:]VPfor x9 Lbif not+  *3x*-i, in-placeL *?sub `differJ r 2+ ".remove(* def __getitem__(self, index): b# Make ing, slices, and 'in' work/preturn L.addresslist[W] """Policy frame;4 for the email package. Allows fine grained feature control of how?9q parsesemits data.z import abc fromsoheader chSct as _ &s.utils E _has_surrogates __all__ = [%'"',Compat32c] class _8aBase: <LObject basicY.'RThis Dis useless un1subted. A  should de~n' attributes with!Qaults any values that are to beAmanaged by! oQ. Thstructor will)0n aCpnon-defri`A setXtheseat instanccreation timev!sbe callable, takingbse samEkeyword argument;Za newidenticalp%ed%d excep4oseqchanged F C. Is may be added, yield1newDb)right han@operaoverriY th in1B lef. *o"s,bA + B == A(<}bof B>)/"@repr&an/0can@usedRRreconGbfqonly ifQPE,c2"""def __init_PG**kwO@"""Ce, possibly MEsome`i23See`docstrC a iE CK;Rname,f in kw.items(+`if has,8 $(gsuper(,p).__set?0__(;s)W9 el raise TypeError(3)p"{!r} i invalid !'{}".formatIQ1.__P__.__3__)D@argsP "{}=tDx"ddict__% ]oiE({})h7 , ', '.join(args)) def clone(self, **kw):-"""Return a new instance with specified attributes changed. E:The=has the same; values current object,Nexcept forDos passed in@keyword arguments5"""Lnewpolicy = .__class__.__new__);,yBdict__.items(LP`.__set>5__(, Pi /kw^if not has\U raise TypeError("{!r} is an invalid \{}".formatIQ,gfame__),( rOnd, namei+if;' ;bmsg =  .read-onlyjFelsejJ+noQDAk4msgz[())3addw, other"""Non-defaults from right operand override those"Gleftm'sM!of1sub~@AA!**2.__tA) append_doc(doc, adde doc = doc.rsplit('\n', 1)[0] 1& ==.,1,T + I& +43extstrings(clsisPoc__ Z%clp.startspC('+'4A%G = _bases__[0]\", diq(#!ifRnce!(c7t1s__&g.mro()Hp2= gH(c@, '_2__'3 if  WK4ttrZFQbreakFacls ! Po"(_Base, meta=abc.ABCMeta):r"""Controlshow messag,re interpret nd%EmattSMost cclasses and many of the methods in*email package accept Policy objects as parameters. A! contains a setmvalues andPfunctions that0rol how input iterpreted83outrendered.PFor example, 'raise_on_defect'ns whether or not an RFCPPviolap result error being Xd= , while 'max_line_length'O0role maximum !7n a Messis serializOAny valid attributVy be overriddenIpis creaMby passingN ita keyword argument toKconstructor. re immutable,Pbut a new anwith only cer.$changed byO@callonstance D )1canL@alsoadded, produc]iC1ichnon-defaulyt@right hand oper verwrite those specified4Dleft2!. 1SetT"s:x -- If tru"n s should7ds9>Ds: False)ep.`-- strC0ain C0useu seS E between 3. S '\n'cte_type< Tof allowedransfer encodingsM? A7bitPQASCII 8/Content-To#-Eo!: $$is 5`aEpdisposiP? of q(RFC in0) binary dataheaders; seeI 1docAPS_foldM \/--Vp, exclu! '2ep'O:!duvp. None0 means no O Pwrappwis donepUis 78ngle_from_-- a flagen True escapes F/C/thc 7bod0uttPa `>'@fronW them. ThJs used when the message is being serialized by a generator. Default: True. F[_factoryX-- the class to usecreate newobjects.K<!IfNAvaluQNone,dM2"""raise_on_defect = Falseolinesep = '\n'cte_typeB8bit@max_-_length = 78/mangle_from_[  = def handle(self, obj, !):_  """Based on policy, either 2 or call register\J xr$ should be a=1sub, but in any case must+nException 7 . Twhichh{Med if itE2notCd. $!is.M#is? as an error, o\ wi he8and"arB/0pas/to{This methodintended!bemparsers that discover$The email pack9aalwaysR&Dwithinstances'0if .C%P7 x(\ Record ''-W'obj'BCall= ' :. qpart ofPmr API soein implement customN1ingwe=D7a%e append/%ofP6Ts attribute3obj]Usq3 *%byP>nFget tSwill Y0havJr*anrJ.()1pheader_Scount2Jname%aReturnmaximum allowed number)N s ?0d 'Lrwhen a -#ad#a gy%ed0#, J@re aPlreadfKO` equal@lr, a ValueError is raised. 8Because the default behavior of Message's __setitem__ is to append the N` valueP@listDheaders, it:@easy#create duplic (#without realizing it. This method allows certain B^be limitedP!inQnumbeinstancesCthatA may be addedRaI programmatically. (Thynot observed byuparser,Mwhich will faithfully[duce as manys exXmN be(d6d.)implementation returns None forUpu names.^5""" 76g@abc.abstract-3defO_source_r(self, qlines):0L"""Given a F#ep terminated strings constitutznPa single,(,`) tuplat shouldNstorIQmodele input 8!reUtheir&%ep0cha33ersM! passed in:email package 0condJsurrogateescaptinary dataT NotIedError P_1 anD vir/"ap5ionx  K}N ._fetch7Afrom l to>Zis reques4%atJe=1 ifQwere $a BytesP'e  + 4Cfold*aA 9^ing of the headCer *according to the policy controls. The value passed in by-UemailLpackage ma@ain surrogateescaped binary data ifFlines wereKrjby a BytesParserreturnedshould notw5anyL |%. 5""" raise NotImplementedError/@abc.abstractmethod;def fold_(self, name,!):(u"""Givenaheader*A andlAfromrmodel, ?MK`ep chaers that iS.oM*M  @_extend_docstrings class Compat32(P"):A"""+This particulari4e backward cGibility LQ. ItEreplicate6ehavior \ version 5.1.>| pmangle__ = True[_sanitize_` 1# I ,$ssT2a HQusing#,unknown-8bitW0set,aencode#bB as rd wordsI!ifisinstance(W, str+# Assume it is alreadRobjecy/Sif _has_st o<].), =_Lset.UNKNOWN8BIT,iT_=)3Felse=(Bsource_pSwF;d`veryth up1':'|ed unmodifiedPQpdetermi by0ippT1leaKwhitespace ofrn!`first `, joinHall subsequens together,P}any trailBPcarri1 orcAfeedoactersn87 = m[0].split(':', 1=m!.l(' \t') + ''.(K61:]?(z#.rEv\r\n')):tor> The name and value are returned unmodified. 5""" )r (name,A!) def header_fetch_parse(self, /:/\E"""+ bIf theS contains binary data, it isverted into a Hvu objectPQusingSunknown-8bit cht. OtherwiseX._sanitize_Ofold s:  algorithm, which preserves Pexist,line breaks in,wraps each resul3 to,P@max_K_length. Non-ASCIICTE encodJO + uj$, W=True*_EȰIf cte_type"7bit, non-asciieis CTEW  .original sourceOused, with its hand/or.Oed =  0==' %')FP.!('&', 'surrogateescape'I_4Cz)parts = []y.append('%s: ' %if isinstance(7strZif _has_s, '+3h =.XK,)M#=_ .UNKNOWN8BITD3_"=tOelse# If we have raw -a byte string,(no idea`# what6is. Ther\no safe way to spli0io#~ . Qit's m-subset,jnpcould donormal>v`, but 5Wm7theS the  .# string. There's no way to know so the least harm seems to E@# be<not split>e and risk it being too long.Mparts.append(value)(h = NoneYelse:+header.HX", `_name=jI# AssumeRis a K-like objectv`if h int #V class interpretpL1 of; for maxlinelen astj# default :078,*recommended by RFC 2822]9= 0Zif self.max_o_lengt P? c h.encode(mAsep=? ,=e) L;#return ''.join(2) compat32 = C () :mod:`email` Package Architecture = Overview -a The V# pUconsiststhree major onents: 8QModel l#Anu that repres83 anlmessage,provides anN!PIocreating, query Pmodif3 a M.eParserI0TakZ sequencecharacters or byt"nd produc m,&th(oothose [Generatols_nto a MchPither%w`human umption (a printabl0uniFing)'1sui*transmissH@over wire. Iatter case all dataproperly oAd us heQtent gf+ings specifie relevantas. Conceptuallyiganized around Yboth "external" API/^0useqapplica_programslibrary, "P @0J. This diviia bit fuzzy;API describ?is documenttll a public, s1API# 1owsan application with: special needs to implement its own parser and/or generator. In addition;the three major funcal components, there is a third key !I architecture: Policy An object thatfies various behavioral settings carriesIaMs ofC -controlling methods. The framework provides[u`onveniY0wayS |Glibrary, maksit possible for4 $Kbe used in a very flex.ashion while leveragSgcommon code requiredP, represent,e message-likes. For exaA,d default :rfc:`5322` emailQ! p, we also have amanages HTTP headersm# fKliant withn2616`. IndividualV s, such as]maximum lin6@ngthduced by$qor, canC be Qlnl3meealized applicx|\]tModel -r mIf8:class:`~a.3".M!` .dG,Q into0two dac9arts discusvQ RFC:01 se;mpbody. 4`@acts{a pseudo-di=0aryTnamed"interface|oRaccess]`. HowT, allk are kept cQnallym`n orde.plist, s*ae informBabou0Dthe ~!in1vorigina1is zCrvedg3!g`payload`#0hol3he s&A "0can1onew: data, or a  u`latter{wE to + a multipart MIME. Lists,pbe nestrbitrarily deeply i^XC,Aterm;`leaves2@non-  Vz Lifecycle^ f4l l)a3 is1CreO,A 7c+1a PWq#it"Dinstantia#e empty0by s?.$zManipuljn may examine one or more headers, and/or the qpayload it may modifyCB>Cthe Bq. ThisAAbe dnl top level `Message`Bpobject,on any sub-!. 'FinalizationThe Model is converted into a unicodbinary stream,@Cdiscarded. H2 Policy Control During Lifecycle -0 Of PmajorRBs ex!byq!ismanagement of" d{O$ l. Most applic4s't need to be aware of this. A^c enter~^n f two ways: via a ParserPby beset to a specific value by an program afte already exists. Similarly, a?xit  ri?ed by a Generatoretrieved from a#e  vides hooks for all four os0 thH0. mgqstorage3Qa lisb(name,Op) tupleB identifi#s +rparsingQpasse>m  :meth:`~email.p.._source_J0e` 0#od&QresulDthat*0be `. Whe9 su&esk(vexample, throughV .`__setitem__`;perface)7 e q<x 5@H ;?tor: , which return *9+(qP dictr i s: s / _fetchQ IRobtaiEk$0 request"se! jEare  Ofold a,0con line breaks appropriate placesacy.cte_type`P Policy control determines whether or not Content Transfer Encoding is performed on the data in header. There is also a :meth:`~email.p..binary_fold` (od for use by generators that produce 7 output, which returnsQ2ed 4 as2data, possibly 'at differPplaceF!anKcorrespon string would be. HandlB Data - In an ideal world all messageNZconform toRFCs, meanh the parser cadecode/Q#in@rized uni'#LAsendiginally wrote. Ir,eP packQmust pbe ableqith badotrmatteds, inclu[s ai non-ASCII characterAt eihave no indica[) set or ar"xt validH;. Since O*primarily* text, and options on  :98.q(exceptpayloads ofBrse)|model storesCqs. Un-]@insi0@ext h ed{"usk e `surrogateescape` error -rAthe  ]c. As wqqfilenam\eDPwas iRd to ^i owwto "carry"jreceived du-along until4E stage, atNptime it#reed in its or'm. This i>most entirelymplementation;Q one I vi#e 0API"internal" API~" P" dE$of!Hinpu0pasx"0to appropriate[ @faceZAG to accessvalues preserv. pd` bytePAll o  kCAvert6@backpoF&,aa safeA (loiin some cases)Backward Compatibility --(e :classG432`Xprovides j( cjf@versI45.1email package$. It does this via the following implementation of 8 four+1 Policy methods described above: header_source_parse SplitsKirst line on0col ro obtai name, discards any spacesOVafter<, and joine remaindernwith allI*#s, preserv1thesep characters tavalue.LPTrail9pcarriag@turn1/orLHfeedMare stripped fromN`resultOc&6ng.c8torb Rel=v ;exactly as receivlq applic]WfetchIO0con`surrogateescaped` binary data, ras a :class:`~"l.:!.HA` object, usA setG`unknown-8bit`. Otherwise just| . d=OUses q's foldo  "s Hsame way5.1 generator did. _P6S6aa, but encod o 'ascii'. New Algorithm -  m]legacy behaviors<1 is already a"Hs it!, 2new#rG$Dytes get 'ed into univ I mpoints:r)aAspec-p;0sets =! bd``qset for``cte_type=7q` or ``#aMAt some re will also be a Z3"`` foaBserializeWA ide dx@mess)rRFC-lik1Ding, conver4 o2g_glyph ?]tBback:`. ReturFns bytes. At some point there will also be a ``cte_type=unicode``, and for that Jpolicy binary_foldIserialize^d message according to :rfc:``5335``. # Copyright (C) 2002-2007 Python Software Foundation # Author: Ben Gertzfield Nntact: email-sig@pyI.org """Base64 conteransfer encoper RFCs 2045-2047. This module handlesGmethod defined inUT2 ton e arbitrary 8-bit data us,hF3reeG`four 7/ charactersQ8known as . It is usthe MIME standards0attach images, audio,Rtext HP setsBw7provides an interface0zecdecode both headand bodies witha. RFCYmCs a ~for inclu informaRWBan `qd-word'2. is commonlyXhreal names in To:, From:, Cc:, etc. \@s weps Subje1linoqdoes not dou$` wrappoQd-of-conversion nec!ry0prondas; it zEdumbo 0ing0o d\various @issuO use.! m. __all__ = [a'body_r7e', !dstring"m_7clength*] from b+import b64<inascii 22a_1S, a2b  CRLF = '\r\n' NL n' EMPTYSTRING' # SeeCharset.py MISC_LEN = 7 # Helpers def_(%qarray):*"""Return8 of s wheni;e#thA."""Agroups_of_3, leftover = divmod(lentA, 3)62# 4zA outseT3(or nonzero f!ioreof) in.EGn = A * 4%ifCn += rn-#(*0s, .set='iso-8859-1'<E3TgivenZ|h8KP. ItQaults6to (. ding is defi ned in RFC 2045. """if not header_bytes:%vreturn +isinstance(2f, str)8) =].encode(charset)lrd = b64 `A).de6r"ascii"6p'=?%s?bT=' % [", Jd) def body_ (s, maxlinelen=76, eol=NLQr"""E aing with base64. PEach D will be wrapped at, at mosti acters (defaults toN'76)c$ofR texts2endeol, which X "\n". Setc0thio "\r\n" if youJPbe usthe result of 2function directlyMin an emailUJ:encvec = []bmax_un * 3 // 4(Pfor irange(0, len(s)cB# BAW: should@() inherit b2a_()'s dubious behavimnxJ0add Qa new0to -ustring?2 encps[i:i +y]siP.ends|(NL) andf != NLs/penc[:-1] +(@vec.ind(encEEMPTYSTRING.join!6vec;`A"""Dc a raw.1, r>2Ys objectTY1oesp a full MIME?c value (like =?iso-8859-1?b?bmloISBuaWgh?=) -- pleaseAhighGSlevelp class sTthat _ality (oWelif FP @94a2b(='raw-uni-escape')a-se I# For convenience[backwards compatibi@ w/ Ddardqmodule U2 =  !# Copyright (C) 2001-2007 Python Software Foundas # Author: Ben Gertzfield, Barry Warsaw \bntact:a-sig@pW.org __all__u"'C"',add_alias9setCodecr] fromools import partial %JmimeaquopriP/Lgerrorsrn _7or8bit # Flags for types of header encodings QP = 1 # Quoted-Printable BASE64&= 2 # Base64 SHORTEST= 3 # the shorternQP and b/, but only fors # In "=?charset?q?hello_world?=",V=?, ?q?,Q@?= add up to 7 RFC2047_CHROME_LEN = 7 DEFAULT_CHARSET = 'us-ascii' UNKNOWN8BIT nknown-8bit' EMPTYSTRING' # Defaults R`S = { p# input g` bodyq@ out#Aconv4'iso-8859-1': (QP,< kNone),/2/3/4/%# 5 is Cyrillicnot especially used666AArab4@lso 5particular777Greek, QP will9make it readFo88oHebrew99 /O10': 11OThai101/56/windows-1252':0vis:1(6L J0big]" (1 /Qgb231u2/`euc-jp9 /Ug>@2022)shift_jis;g8 L:8 gakoi8-rd) /Tutf-8.$ (4, /'#`}qAliasesother comm- C nam ac0sets. Map ImQreal onesI in email. ALIASEp'latin_Na\?- _:)2': _:3: _:4: _:9:5': 'iso-8859-9', 'latin_6': 'iso-8859-10- *_7<3< *_8<4< *_9<5< W_10':6<@cp94X 'ks_c_5601-1987?euc_jp': 'euc-jp%kr$krPasciiR 'us-} # Map charsets to their Unicode  c strings. CODEC_MAP = {agb2312a2euc4_cnDbig5!0 '3_tw)# Hack: We don't want *any* conversion for stuff marked , as all# sorts of garbage might be sentPus in` guise,U7-bitR.KLet thatxpass through withouttto/from;Ft: FNone}P # Cnience functionsextendingabove mapp def add_(, header_enc=mW bodydoutput8$!):a"""Add acter set propertie global registry. = i#Pe inp5harK, and musthe canonical namaL7` Op'alPyeither C0.QPGRquoted-printable,%`BASE64) base64 encov$SHORTEST&Oshortest?^qp or@0or 75 noY4. RNis only valid- . It describes how mess&sH0bod0are"beed. DefaultB!noJ | <1 1- should beZBin. `s willeQceed ? , "thI^|2wheemethodA0t()AcallRThe dS8s_aBBothR KDhaveWBentr6module'srset-to-R; useFodec&I)Mo%i[ does not know about!eegF"s ,!'sKdocumenta0morAform""" if body_enc == SHORTEST: raise ValueError('$ not allowed for boI!')> CHARSETS[charset] = (headero,0, output_)) def add_alias(, canonical)"""Add a 9acter seQias. : is the name, e.g. latin-1*]. U&'s~ Biso-8859E1"""MALIASES[r^`codec(gQset, [ ( that mapAs inQgivento/from UniS gK< ofF&. 5/bPython&, as appropriatessecond argument tou(*built-in, or" en() method string.sCODEC_MAPpDc # Convenience functiono3ing[`s, takinto account #.they might be unknown-8bit (ie: have surrogate-escaped bytes)Bode("ifTUNKNOWN8BISeturn.e('ascii', 'yxBelse6rC-} class C7H"""M~ksir email TertieRThis NpprovideQforma|Qaboutprequire&s imposed onYda specific@. I sohcroutinesM rtSbetweAQ2s, Wavailability1theEapplicableQs. G , it will do its bes N&in`on how_2useva CRFC-compliant waybCertai$DQs musDd with quoted-printQase64c`when uis0bod/ r J0utrO1, a-e\hnstances!isImodule ex5M foUm :)'in: The initialied. CommonXe^ arpnvertedtheir `official'6s (_K MN). Default 7-1us-}ding: If the" character set must be encoded before it can be used in an email header, this attribute will^j/toLCharset.QP (for quoted-printable), #aBASE64'Lbbase64ing), or>SHORTEST fthe shortest ofO QP@v"ing. Otherwise,)aNone. JTbody_1: Same as&, but describes 5O rmessage's m, which indeed maywdifferent than`O5.. 2is not allowedI poutput_uset: SomesvconvertOthey sbodies. If7 in? isa one o0macontaiH n.M  /toIM7be ]odec: The Python !c 3to v `Op to Uni?>n>%siW@0nec/ry; _fA\  O@haveE sAvaluwF.N1"""def __init__(self,=DEFAULT_CHARSET):7# RFC 2046, $4.1.2 says?sets are case sensitive. We coerce v2# up becaus0s .r() is locale inLCargumentlready a\p, we le)Ait aztPensur@Z#`ASCII,-Vstandard ( XXX) requiresf'6try4pif isin=3ce(W, strc/ %.e('ascii')*Jelseo @ =f y NdexceptoZErrorYpraise e#s.' [ arset.lower(3)  # Set the input charset after filtering through*ualiasesDQself.?_?= ALIASES.get(,j+We can try to guess which encodand conversion'`use by#_map dictionary. T\hat first, but luser overrideM5it.qhenc, b = CHARSET ,<s (SHORTEST, BASE64, None)#aif not:W~&attributes, allowXargumentsWYw defauliuheader_ = r$Hbody": "doutput :,`# Now codecs. If one isn'tined foro#aRrPa UniN Rc wit`same n$asMuODEC_MAP!a= B{"| a?!) def __repr__(')breturn=<y.lower(C#eqA, otherH"trb == str((MIget_r7B"""R<ntent-transfer-#us=N~.This is ei%!st*`quoted-printable' or `base64' depen!onHN |,4 itbQa fun3 incase you should callM3a single ,Message object beingF ed3&heq0the:"CoGTGEM*0 it(^whateverppropriatea]`imilar| e()` exceptju1fit@intoPimum  as given@xargumen[\: Max iterator. Each ele04<red from7`provid ie nexta Km1. 0eMpis used4an {built-inY(and should neverexhaustedee5 @counBew;ese2re only aJRhint;@plitAdoes@best46canLU.e s, each with RFC 2047 chrome. 5""" # See which encoding we should us8codec = self.output_or 'us-ascii'\header_bytes = _`e(string, ;).r_modulegC_get9(r(Q 9 = partial(K.7, charset= # Calculate the number of1acters that ]U will# contribuLo each linLR(xtra = len(0) +_CHROME_LENNow comeae hard. We must"e 0butcan't split onO&ecause some sets are variableqgth andIbd word st'on its own. Sodproblem is you have toM3 toto figure ou!ish#'s , LO&ons. This cs two s: first,2 do2know howMmany oct specific subY0univHG getJ31to,Rosecond~ tWASCIISJTthosej d to. Unless`try it1WseemsLinefficien$!Ininterest beKcorrect rather@n fast (andOA0hop~e"reebe fewPs in dGsuchImessage), brQforce%:('%[]current_7 = maxlen = next(gths) - eD6fory:!iq.appendb+DthisEMPTYSTRING.join(H 70len~=2S(V(e)O#if?2 > #-lP doesfit so pop Y&ff=G.pop# Does nothZUowa?k6 if2s?Hnot n7sJNone#Oelse=separator = (' ' CPines 4> ''MQ/ed =header_bytes = _encode(joined_line, Oc) !s.append(<r(header_bytes)8qcurrent] = [character]cmaxlen = next(gths) - extra2 = EMPTYSTRING.(t qreturn 3 def _getgr(self, !):*l0if ._ing == BASE64+/oemail.base64mimeO/elQ/QPMoquopriMSHORTESTSlen64 = jlength>UlenqpAA2if <*qpcD $Oelse: 6lFNoneCbodygstring"""Body-Be a " by convert%it first to .eThe type of F1(3 or quoted-printable) will be $Ed oning. If @ is , we assume thpoutput 0set.ea 7bitr, so re`the ded)4 us!Rascii producesx correct9Wversi#of&entent.a5""" Tif noB 1,if isinstance(J, =e=.Y_Y8 z8C&n^s, key, Ql t[key] =+ScSmsg, *args, **kwW)_type = msg.@((9if 1=in  H &[H-](%EOmain  (D _if ''e)/''_ raise KeyE(/)Cb0G 2#s[-K)z[?objP-ifDM() == 'multipart'*# XXX: is this  a good idea or not? We can remove it later,37q# but w*f't add)` so dofTwzBType{" valid on "#`_find_B6obj3udclear_l 6 x hs, , nmfull_path_for_he= NoneB0typ(A.__mro__Ih3if )p.s)- *]}*@qnamtyp.__qual)__%0mod = getattr(typ, '__module__', 'e = '.'.join((K!, y)) if modname else wqname if full_path_for_error is None:,7-=C 0\ in self.set_handlers__retur*[x]c_-E [+ = typ.__ ,__{z-Dy!ifxU*Qraise KeyE(G) raw_data_manager = ContentM(&def get_text_c a(msg, 5s='replace')$p = msg.;payload(decode=True)Vycharset+Sram('', 'ASCII'0b.P(-)P.add_ ('-',=non for maintype'audio image video application'.split(a  Z xmessagee} 00) 5subrfc822 external-body'3/'+[and_fixup_unknown_- # If we don't understand a 5 wwe are supposed to treat it as@# ifHwere/octet-s0cm, per/tools.ietf.org/html/rfc2046#sec-5.2.4. Feedp`r doesdo that,Nso do our bestfix things up. Note3is *not*`ropriaoMTmodel/partial KR as M# objects, s!ey&3dLhs well. (Howreassembl emPout of scope Qthis comment :nbytes()';T_prepare_set,,J0heaiSmsg['I-Type'] = '/'.join(()3if IHif not hasattr( `[0], 'Dt,#mpLpolicy  headers = [mp._factory(*source_parse([(B])) F Bfor %3 in %s].Etry: =0 #'#ifL.defects#'[raise*&[0$3msg.name] =5except email.errors.H3Dz as exc`ValueE3("Invalid^: {}".format(kG.fold(policy=msg. ))) from def _finalize_set(msg, disposition, file, cid, params)(if, is None and71not5b = 'attachment'XC'Content-D'`Q#0setDam('-!',? ! =4replace=True* ifu[_!ID1cid#if;>`key, vtrs.items( 8) # XXX: Thisk6a cleaned-up version of base64mime.body_encode (including a bug # fixthe calculaD"un6&d_bytes_per_line). It would be nice to # drop both tmquopriin favorhenhanced binascii # routines that aced a maxr_lengthvReter.\_l(data,4n*dN_, =H // 4 * 3iJrange(0, len?), U2^0 = _[i:i+76 .append(HD.b2a _@).de !('k'"return ''.join(Ww_text(string, chqt, cte, wY+.>(1q).split$(| Cep =G.:oembedded_(.3): "ep A) + %epCnlACb'\n6?=) te1# Uuristics to decide on fq"best" Aing.O;if max((len(x) for x in lines), default=0) <= policy.max_!_length: :try return '7bit', normal_body(Is).decode('ascii')Sexcept Uni$D*^ErroriIpass<$ifcte_type == '8?, 'surrogateescapesniff = embeddedV[:10]*_qp = quoprimime.0_en("%latin-1'),j base64 = binR.b2a_2# This is a little unfair to qp; it includesRReps, M doesn't.bif leneg_qp) >5)rcte = ''IOelse)quoted-printable37*10F%"Qcte, 1_qpy1if =;odata ='elJJ ]  i  "m$),  .raise Valuec ("Unknown content transfer ing {}".fbt(cte)W) def set_text_O(msg, strin ub ="plain", charset='utf-8',d_=Nonedisposition' filename2cid  bparams"r headerz_prepare_set'B', s,6(payload = 4(b, msg.B5E( Sram('J'cemail.".ALIASES.get(mVreplace=True|2['C#-T -Eping'] =g_finaliz7,r, cid, `) raw_;_manager.addy_handlerB,R)jzmessageme="rfc822", cte=None, disposition) filenam8B cidBbparams$r header!):3if subtype == 'partial' raise ValueError("message/, is not supported for M% objects")ngrfc822maif cteOAin ( '7bit', '8sbinary'# http://tools.ietf.org/html/rfc2046#secM-5.2.1 mandate.D " As do={}".format(cte)B #  will get coerced on serializa if policy.cte_=U. We# may end up claimingdhen it isn't needed, but the only negativOresult of that should be a gatewayPCs to 0havto look through}whole embedded XDdiscover whetherP!orgit actually hado anythingO=;N0is ZP else^+el external-body-3.  =r5p4 says all futurpsjprestricQ0to V, so assume~ %'_prepare_set(msg, '_$',,msg.set_payload([1]['Content-Transfer-Encoding'] =K@_fin~,,, ams) raw_data_manager.add_handler(email..b , "_cq) defTbytes f`, mainR'base64'V 5P = _e"e_ (x_line_length=m)mah" jquoted-printable!# XXX: quoprimime.B won't encode newline characters in data, # so we can't use it. This means max_G _length is ignored. AnotherObug to fix later. (Note: encoders.quopriIbroken on bu ends.)M = binascii.b2a_qp(, istext=False, headerquotetabs=TrueQA0.de!('['$elif cte == '7bit':<`in ('8=0, 'Ory')H, 'surrogateescapemsg.set_payloadmsg['Content-Transfer-Eiping'] =0_finalize_set(msg, disposition, filename, cid, params) for typ pbytes, array, memoryview@raw_#_manager.addq_handler(typ, F2s_c#) # Copyright (C) 2001-2006 Python Software Founda # Author: Barry WarsawLntact: email-sig@pG.org """$s and re`d funcZs.""" __all__ = [D'B_7or rbase64'\+Knoop] from >s import,$b as _bz+A +astring,+ def _q#(srenc = _-O(s, ;T# MusP spacPwhich0Ipri.G`) doesP!do"`return .replace(b' ', b'=20') E_ e the message's B|!. oAlso, add an approOate *@.?porig = ~g~9Z0enct = str((?9), aL(;''3O(msg3d-printable=m9/. 9 :1Setj/ &@ or 5:0if FNone%`# Ther$no. For backwards compatibilityuse 7bit  msg['Content-Transfer-Encoding'] = '7bit' areturn# We play a trick to make this go fast. If deS from ASCII succeeds,N we know the data must be , otherwise treat it as 8bit.AAtry: Qorig.ue('ascii')except UnicodeError6qOelse<' def ege_noop(msg)LN"""Do nothing.""" # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry WarsawLntact: email-sig@pG.org """ package 1ion classes! r MessagH!(E\6ionBBase9` for epAs in iWCPars\i_m parsingo ZnHeaderY^e whileSh@ Bw!ry0(QCouldn't find terminatbC MultipartConversionc R, Typ%1JJ is prohibitedn ChntU WAn illegal c. was givenL# These pdefectsJ!ch!er=@ablepwork ar.]D?\(Valu _$a sp __init__(self, line=None'!if&@not super().LFZ@elf.! =I'$No$%In0E"""Apclaimed%8be but had no AbameterTStart1Not)r!Thzs?cqnever f_Closei/A _Y , correspon ciRFirst`LineIs1inutVda cont:rPits fd MisplacedEnvelope{ `'Unix- 'Zi 2middle of a$[blockuBodySeparatorDefect(MessageDe(fect): """Found line with no leading whitespace andcolon before blank:Z.""" # XXX: backward compatibility, just in case (it was never emitted). MalformedHeaderDefect = MissingHBodySeparato# class MultipartInvariantViolationDL(Message2A m claimed to be a mS@ but0subbs were f?z5lidContentTransferEnco]n invaliG@# tA# eBAset on thehitselfUndecodableBytes~ Hg contained b4 that coul tU ed Base64Padb+ed sequence had a@corrolengthlCharacter o cD1 no.alphabet}LU K  (1 mod 4)p # These errors are specifichparsing.  ss for a Ld+@&def __init__([, *args, **kwE)super().-'!  P2"""1 is,gives details62RequiredValue(gAm0havv6AnonedNonPrintQO\WSCII Yqoutsidetascii-pIS rangRlS|Enon_5s,  *) : =  .3strnreturn ("}`follow5A6non_e#inj1: "^"{}".format`.$))<Obsoletez# uses syntax declared oG by RFC 5322rLocalPart l&_2!n-Cai only occurs durBunicode ,Awhen4# K0d from binarynDateDefect(HeaderDefect): """Hn has unparsable or invalid date""" # Copyright (C) 2004-2006 Python Software Foundation # Authors: Baxter, Wouters and Warsaw[ntact: email-sig@pyV .org """FeedParser - An)` feed er. The implementn interface f!crAallyCSing aY message, line byq. This-advantagesOcertain applicas, such as those reade bs off a socket. .() is the primary@pushU0newao0  It returns whenre's not;more it can do with$` avail data. W>you have no :@ to ~Rcall .close(). @ co#te0arsDroot&` objeceother P of t0 atwill never raise aing excep. Instead, it finds some#unexpected,Wadds a 'deMP' to ecurren2. n s just instancat live o B's ._s attribute.  __all__ = ['/', 'Bytes] imporc from9gerrors._policybase@;Bat32'`collec9s!Rdeque$ioStringIO NLCRE = re.Kile(r'\r\n|\r|\n')"L_bol&(')(e( %\Z*_crackT # RFC 2822 $3.6.8 Oal fields. ftextX%d33-57 / %d59-126, Any character # Y controls, SP, a":". hp0^(F|[\041-\071\073-\176]*:|[\t ]EMPTYSTRING = '' NL\n' NeedMoreData =4 () class BufferedSubFlA file-ish>B thafbloadediO1YouE3als1pop>Q-matcq@pred%pes ontoDtackb1theO/ B<$e , a false EOF responsE(i.e. empty sQi6lete@hereasTP abst`ion --|D1tilL.JT5def __init__(self0# Tybstream`e lastAtialYzt#is. # See ,issue 22233 for why this is a text stream and not a list. self._partial = StringIO(newline='')- # A deque of full, pushed +s(U" =2(FThe stackH alse-EOF checking predicates2eof9E= []pqflag in8Dwhether the file has been closed or a0= F c1def_eof_matcher(,!):&Q.'.append()K op# JD{return KGpop(D:p# Don't get any trail v.seek(05sn+R.read)2NP@trunq_d = True7q if0#ifX !q%''NeedMoreData Q# PopZpA off jsee if it /s wcurrentGfe$\= s.popleft30# RFC 2046, section 5.1.2 requires us to recognize outer level # boundaries a<"inner nesting. Doe, but be sure it'A# inPorderD@mostQleastL&edPateof8reversedN1if 2(  p# We'rej EOF. ButlD b8firJ's)Q/)un,EQ# Letconsumer"ne0inte bufferRaassertS  g, data"""Push some new  is object."""Msuawrite(V"qif '\n'"inS9'\r A# Nocompleteas, waiV more#@# Crs@servFJep character P$s 8ialI # H self._partial.truncate() # If the last element oist does not end in a newline,8wn treatPit as a partial +. We only check for '\n' here because a-L ending with '\r' might b+ that was split`middleaM0'\rrsequence (see bugs 1555570 and 1721862).:!ifs[-1].ends(%):)S`self._,r`write(s.pop())-)@push s$Fdef ),sl!._<.extend( C__iter__(,;preturn pn__next-U! =-P.read(!ifj == '' raise StopIterationM class FeedParserJ"""A feed-styleR0seremail."""4ini, _factory=No*, policy=compat324"""/ is calledupno argu`s to c~new message obj3Thek keyword specifie32ectpcontrolAnumb*a= tspS's opT0. stdefault{maintainsIbackward ibility.N.1# =TJQ_old_;u= False(%ifWb#if[.JK>is /3Rfrom 4 import M~./ =(Jelse: qE {3f>try{*(t=J |>except TypeErro9# Assume thisTan olS :q6Tru'input = BufferedSubFilgK(msgstack = []si@segen(). 0Qcur =% qheaders=#H-public interface0sup^8's HAflagDDGset_ y!1 = OB6j, dataPush moreoljinput.push(dcata) self._call_parse() Hdef (!)::6try  .Cexcept StopIteration8Fpassr`close(Ll@"""P+ all remaining data and return the root message object."""Z._input.l  W"= >Cpop_c(>assert not'msgstack|# Look for final set of defects(!if.get_content_type() == 'multipart' \8! E.is_,(S,x = errors.MUInvariantViolD@policy.handle_S({,"E_newNR#ifKold_style_facto{Dmsg !Jelses0=. 1cur_&I_cur/digest'@.set/Qault_:'T/rfc822'S N[-1].attach(msgF '.append#U= msgZ;Rlast " 'eretvalG.pop] `$._(-9ENone+rpolicy._Q(b_cur,  =ms = []  HZs.append( .set_payload(EMPTYSTRING.join(lines)) ireturn2# Make sure a valid content type was specified per RFC 2045:6.4. cif (str(self._cur.get('P-transfer-encoding', '8bit')).lower(`not in ('7-5, 'binary')):4defect = errors.InMultipartCTED7policy.handle_c",  p# Creat_ match predicRwhiches the inter- # boundary as well1end-of-m). Don't pushMthis ontot put stream until we've scann0ast* Fp1:ble separator = '--' + @re = re.compile(%'(?PKre.escape(h@) + (0r')6end>--)? ws>[ \t]*T\r\n|\r|\n)?$'capturing_y = Trueo)[]dz = Fals6dclose___seen(Qwhileu`1 = _input.read0if  is NeedMoreDataWHYyield( #+inm_== ''c]breakVEmo =01re.2 e/mo]@# Ifre looking aE end`,#done wit'c!# /b . ]Bther"Qa new[c-ofL e ,]n we need to initializeKrepilogu(` empty^(see below)if mo.group('end'K( +Wsep =f i2# We saw an'A. WE?@>if N~ if_amble%)p# Accor26 lJ/?ngsJ#D,    lastline = preamble[-1]  eolmo = NLCRE_eol.search(M)? 1if B:& }4 = _q[:-len(E.group(0)) self._cur.U = EMPTYSTRING.join(capturing_, = False{input.unreadq(hoontinuV'# We saw a boundary separating two parts. Consume any# multipleKs that may be following. OurJ'interpretation of RFC 2046 BNF grammar does not producBbody within such doubOies.while Trueg8 = 1if 9is NeedMoreDatagYyield0+c !`re.mat?ine v/mo _break# Recurse t phis suba; the !0 st pointsM!at1>'s first push_eof_30, "_zRs feddAQ no :gpno lead9WS"N:[:i"@ = [# Done with all the lines, so handleast header. rif last:self._cur.set_raw(*rpolicy.3_source_parse(K value)) class BytesFeedP#&r( )p"""Like , but feed accepts bFQ.""" 1def (c, dataNpuper().B(b.decode('ascii', 'surrogateescape')) # Copyright (C) 2001-2010 Python Software Foundation # Author: Barry Warsaw Lntact: email-sig@pyG.org """C%es to generate plain text from a message object tree__all__ = ['G@ orDd] import re 4sys 5timrandom Scopy :@deep$ioStringIO,"IO!d.utils*U_has_s UNDERSCORE = '_' NL \n' # XXX: no longer used by below. NLCAre.compile(r'\r\n|\r|\n') fcre = ! ^Fp ',MULTILINE >pes outpC?a MThis basicpor writ%he!togiven fil"as#'## Public interface;__init__?outfp, mangle_`_=Nonex3len!*,No! reeor forflattening.T1 is\Pile-l( F;1ing()uto. It muRave ak() methodr Op)alPa flaaat, when True (default if tis not set), b s a_ he body ofby puttingOPa `>'4Sfront1m specifi\7st lengtha non-continuedp@. Wa5J r (in characters, with tabsHexpanded8 spaces) than ma,u will split aJpdefinedzH ai. SetQp@zerobdisabl\g@rappve The s 78, as recomme(required)by RFC 2822S keyworda.@hat rols a number ofea#ts;'s operation. If no policy is specified, 4the!associated with  Message object passed toDflatten methodieused. !6""" if mangle_from_/UNone:. "= True if0is 3D els.2Kself._fp = outfp4) = *maxheaderlen) )l=def write(F, s)# Just delegate[D filu aC_fp.L)^`msg, unixa=False, linesep=9r"""Print* mtree roodat msgaoutput^Q whenP Generator instance was creg"a flag that forcesLping of a Unix FAdelimiterabefore6TfirstiQ. If*originalNlhas nomP, a `dard' one crafted. By default, thisO1is Kbinhibi| ,nyp- No)B sub&s,U 5sep ]characters 0dicQa new@5 ind. The@ vals determined bycM1@ or,nnIJm7msgOt@# WeBq_XXX co ts0 opbn datacomes directly%# and _encoded]Nalready been0ver(to bytes B W) andJ2ins8 into a temporary buffer.,=. 0if D!if?wiLtz[:s.clone(=)Sj ]@max_Y_length=QoE_NL 9,seR*5L._NLTEMPTY = ''8$d_!NQ# Because we use clone (below) when we recursively process message 4# subparts, and because clone uses the computed policy (not None), J K`s will automatically get set toTthey areed by this code.+old_gen_r= self. %6msg%= (6_NL!#ifUT Vs[-1]84# XXX logic tells me this else should be needed, but the tests fail# with it and pass out it. (NLCRE.split end a blank elementO!ifJponly ifwre was a trailing newV.X#<jRdef _sVh, msg)>We can't % headers yet because op followscenarioLsay a multipart message includes^boundary strIpomewher'# its body. We'd have to calculat%w Q/before/ weOpso that'2can+correct Content-Typeparameter.Z 0 ThyXdcis, so as2mak _handle_*() methods simpler,Mi6cache any subT`s into[ruffer. |Jb4" cs=5ay,f rsK!DoiRight Thing,Gstill modify FU7 ifO0nec"&ryPoldfp = E._fp.6try#"munge_cte = None0#PR_new_(W0dispatch(+Pofinall[.N (3del2 @# IfPdWcte, copecQagainare-fix+6CTEZ1if F- Jmsg = deepW # PreservPc orderD CTEalready existsJsg.get('-transfer-encoding') is AUmsg[':E:6] =5[0]H< 8msg.replace_ ,_ >J Hype'= WAFirs4seeg0obj@want'"# !itw Dnot, we'll dopgeneric = getattr 2, '?_headers', None3) if meth is None: self._write_headers(msg>;els3M(8%Q._fp.I(sfp.getvalue()) rdef _dispatch@ , j # Get the Content-Type: formessage, n try to R1 tog"# handle__[, str_raise TypeError('str3 expected: %s' %'P{if _has_surrogn7#._G uycharsetSram('3if (# XXX: This copy stuff4an ugly hack[avoid modify5the?Jp# exist msg = deepp 0del#['-transfer-encoding']}tmsg.set@r, gj T[IT_munge_cte =  ,I 7msgEVype']#ifMpmangle__ fcre.sub('>From ', payload)   self._write_lines(payload) ## Default body handler6B2= _R_text:5defmultipart(pq, msg):EdThe trick here is to out each ? separately, merge them allNtogether, and!n make sur0 at boundary we've chosen isn'tLpresent in5."0msgps = [] 0submsg.get_:%()%5if (vis None F\elif isinstance(DW, strVB# e.g. a non-sbtHse of a message with no startingN.u!ereturn?notMlistsScalar -J]j r fo6r N1 = _new_buffercg#zclone(sg.flatten(, unixfrom=False, ?2ep=e*NL>m).append(svvalue()*# BAW: What abQies tPre wrEddouble-quotes? 60y =lk_0if  0# Create a0doe% ar0anyQ5the#a# M0allr_encoded_NL.join(m0S7U 46set&E'@# Ifre's a preamble, it,(pa trail'PCRLF !ifk<]vpmangle_D_|PI= fcre.sub('>From 'B."8;elsH,$   b('(._t# dash-d-nsport-padd6Lf'--' +m+ ^-yMsF\3_fpmRi.pop(0u*encapsulatio# --> delimiter 7*( _0m #j  \ k ? + E # body-part self._fp.write(%_%)&# close-delimiter transport-padding,NJ _NL + '--' + boundary$m if msg.epilogue is not None:f2if >mangle_from_#'I= fcre.sub('>From ',k8+lsq=; t_lines(!) )def _handle_multio_signed(>)# The contents of - 9s has to stay unmodified in ordao keep|Q# theC ature intact per RFC1847 2.1, so we disable heaMwrapping.ORDM: This isn't enoughcompletely preserve}, but it helpsP2p =epolicyh. = p.clone(maxf_length=06tryDB zF(msg5ofinall9{pessage_#very_statusPWe ca)Qjust *cs directlyB's file objec# becausS is will leave an extra new betweenf0last\# block and$v. Sigh'es = []=1forrget_payload(_new_buffer(}#g#s.flatten(C@unix=False, @sep=7J._NL>@text_.getvalue|>0 = (a.split._encodedQ# Strip off8Punnec  ry%iling empty3!ifsuzc[-1] =tZEMPTY?b.appen7b.join(VZ:-1]) e S6`# Now VA all/Q withr". he lovel# effectaeparat'3achS-  q#{aone afu6one3)!ge P.2a mhr/rfc822Zshould be a 3 sequenceW#B  1. The zeroth e lement of the list should beMessage # object for!subpart. Extract that&, stringify it, andJwrite it out.pExcept,Pturns , when it's aV insteadich happens*Oand only HeaderParser is useB a m mime typ/rfc822. Such5s are generated by,"example,Groupwiseforwarding unadornedV. (Issue 7970.) SoK"inm caNe just emie%Fbody^payload = msg._TPif isWSance(,%):& g.flatten(I4getL(0), unixfrom=FalseAnesep=self._NL)Lh = s.getvalue(#Jelse}1QUencod:o1fp.k!) ~D# Th to a module level function; we( a classmethodCthisMg_compile_re so7can continue to provid\mmN_@back Vatibility by doing* _make_boundary = G:or.2a e. It *is* internal,Adropr"..R@];def(cls, text=NoneF# Craft a random f3given, ensur8achosenu#> doesn't 1ar %eO/stoken =z.range(sys.maxsizeG = ('=' * 15) + (_fmt % NE'=='i  re5>b =0couE = 0)while Trucre = cls.('^--' + re.escape(b(--)?$',MULTILINE+if not cre.search(%UbreakP + '.Cstr( iU += 1G(pums, flagsG3re.-(%A e Bytes<( H3"""eb. version5#a -b tree.FKally identicalxb\Aor eicsoutput jxn`@. Wsurrogates werd inEto encode bytes, these are decoded back to b! for output. If0 policy has cte_type set9A7bitYn.message is transformed such that%Hnon-ASCII{properly contentCQer enp, usingE charsetMunknown-8bit. 0Thefp object must acceptsin its write method.<2"""E2def(self, s):! Q._fp.@2(s.('ascii', 'surrogateescape'))V_new_buffer\Yreturn B8IO(5c{ 4 <_headerstW, msgy`# ThisQalmos same ass0str~version, exN6handling"# .ps with wcB8`, v in.raw_items()kBelf..fold_binary(h, v))A blank line always separates  from body:p0(H._NLJae_text H;; Joriginal source wasE, so0# j2 it6outC!if:_payloadFNone?Vif _has_T(msg.D) and not h0==''b"if-_mangle_S_#g = fcre.sub(">F"I<_ _s,;elsasuper(OGenerator,O8)._ # Default %rc`Body =G2ndl :b@classL0B _compile_re(cls, s, flagNC re.- Q)5 _FMT = '[Non-@ (%()s) part of omitted, filen$%( a)s]' " D&( 3"""Qes a xrepresentationwayALike@<or base uFVssubstitutedROa3mate 1the'As_init__xoutfp, =?x3len3fmt !*,U'!,1"""$._)>pan addiBRal op gPargumis allowed\f@WalkWPrough  subparts of a message. If the subpart is of main type `text',,n it prints decoded payload@R%. IOtherwise, fmka format string thaused instePumessageNo$. MPexpanAwith`followYkeywords (#%(#)s&):: Full MIME o5@non- ;=& : Main93sub8 : Sub-qfilename qF  description: D associated GPencod\vContent transfer ,The default valueNone, meaning$[Nw0(%(11)s)z& omitted, $%( 5)s]5""" Generator.__init__(self, outfp, mangle_from_xheaderlen,D1 rpolicy=)*(if:<w ._%e= _FMTOelse+2fmt'def _dispatchFmsg);2for4in msg.walk( =+b.get_c_(3i<P == ''v#>(6U(Jr=False)=  d,elfPmultiNk# Just skip thisK:pasd'K=% {K('' 9/()1'V@:u @B? @!@?U('[noQ/]']'G#('%-p'? _ T#-E!e} # Helper u7by u!make_boundary _width = len(repr(sys.maxsize-1)) !'%%0%dd' % 4 # Backward compatibility _make_bounda:ry = Generator._make_boundary # Copyright (C) 2002-2007 Python Software F3tion # Author: Ben Gertzfield, Barry Warsaw\ntact: email-sig@pW.org """Header encoding and de @funcq ality.""" __all__ = [ 'A"',;1e_hV ] import re binascii.quoprimim)abase64R from.errors ^`ParseE*# chct as _ # C=. NL = '\n' SPACE D ' B 3b' 8 * 8 EMPTYSTRING' MAXLINELEN = 78 FWS \t' USASCII = vQ('us-`') UTF[tf-8') # Matched-word strings in the form =??q?Hello_World?= ecre = re.compile(r''' =\? # literal =? (?P[^?]*?) # non-greedy up tonext ? is7? i ji>[qQbB])ieither a "q" o b", case insensitivefBed>. =eq=== ''',}VERBOSE | PMULTI-F name regexp, incluPtrailcolon, but not separatwhitespace, # accor;o RFC 2822. xacter rangedPtildepexclama mark. # For use with .mO() fS[\041-\176]+:$rFind a ' embedded`a putavalue. UsedPcheck$ ##Ainje attack. _T \n[^ \t]+: # Helpers _max_append =i defD (!):%@"""Dbe a messageAout conver !. BReturns a list of (#, )p) pairsC@tain@each+dMTparts0set1Non96o0wisalower-%oft1setrspecifi/}M ` may buQ that!or0conD2047* *s2r i8MA0 obNq#Anl.$e may be raised &when certain decoding error occurs (e.g. a base64)xception)./1"""2# If it is a Header object, we can just return the encoded chunksOif hasattr(hEB, '_!1'):jF[(_charset._N(string, str(+))GK0for5=9B in .];"no1 6 with no Pnot ecre.searchIt, None)~First stepo@to pI allXparts into triplets of#Cform(9$d_:). For un#ed(!s,LClastL!twts will bewords = [oGlinedPsplit's( =0#($)sfe= TruePwhile&ts6.=f.pop(0O%1if V ;? .l<*p(E/Fv = Fals&ifPg-.append((i)n"ifL o.lower0+ed_ e7ed,C# Now loop over ? and removethat consistwhitespacm# between uPdropl> @n, wenumerate(aif n>1Bw[1] \[n-2]1][0].is2n-1$dreversed(+2del A[d] w# The nex$be eachv!ed8 by applymKor quopri trans@ration. 1ed_"anow a UoK5" (/,M ,("if!isz* is&an%  : 8(elj== 'q' = email.cRmime._y j`#QsX_)) elif encoding == 'b': paderr = len(*ed_string) % 4 # Postel's law: add missS0pad[ S2if V ju a += '==='[:4 -5]L>tryFword = email.base64mime.decode Pexcept binascii.Errorbraise HeQParse(1('Bm ie?*')c>lseR30ed_s.append((@, chc&t)HeDAssertionUnexpectedU: ' +S# Now convert all ys to bytes and collapse(secutive runs of# similarly`"edH.@[Alast` q = None71forF2 ina.Mif isinstance=Fstr)"e" =%'raw-uni w-escape6if !is S=l #e2 !=k fB [,7*& $g  += BSPACE + W+ereturnd def make_h(_seq, maxlinelen=g", %R_name?continua\s_ws=' 'V"""Create a from a sequence orirs as Sed by!) v@ takr value QspJ patof the format Ut) wherek6hN acter set.This func#!on_those#ndNlP. OpP'al , @ arem!inO^rtructor1"""$3h =( u=1,?$ =rs~6seqne means us- but we canrply pass it onh l&ifs not None a nd not isinstance(charset, C G): $ = 1)'h.append(s, / return h class Headerc def __init__(self, s=NoneGimaxlinelen"! hWR_name4continuation_ws=' ', errors='strict' """Create a MIME-compliantm that can Zain manyacter sets. Opzal s is the 4ialPvalue. If $M,Hset. You la}1 tojd with Smethod calls. s may bPbyte ng or a Unicod, but seeea documentt0 foomantic< serves two purposes: it ha8same meaning }D1arg{hat also defaultLall subsequentK<AomitOO{f( seprovided in=onstructor,us-asciiO_used both5s'sZ$0andQKThe maximum }q lengtht be specified explicitly via4/len. ForuPplittRfirstXto a shor(`ccountUfieldNhich isn't incluSs, e.g. `Subje pn85 ofN!el[\0. D 78drecommendeby RFC 2822Q7P mustw+ r@fold*whitespace (usuallyPeithe hard tab) w@willc0pre edN)89`hroughA.`G.H5""" i= USASCII:Aelif':s&._v v 8! = 0hunks = []"ifhC'ifMK= MAXLINELEN self._maxlinelen = # if header_name is None: 'sJ'I0 ;els.$# Take the separating colon and space into account.NnBlen(~a) + 2 4def __str__()"""Return trvalue ofSA."""L|normalize()uchunks = []Plastc4 =MQfor s, charset in "._`# We must preserve>s between encodedYDnon-EwordxK boundaries, which means us we need Bdd ajP when+goOefrom a!to/us-ascii, or $_ J . Only do thiE2consubsequent / :# Don't ai  already has`(trail:por lead Qdepen on transition,p2nex a4if 3= _".UNKNOWN8BITPoriginal_bytes.!('u', 'surrogateescape'K:: = T0.deLKlreplacC3if 4hasf@nonctext(>[0]3if T!no(4, 'W'R>in 5 tJ0.apn(SPACE. "&elA# =h\` +-1> |riEMPTYSTRING.join(7)0# Rvcomparison operatorequality only. BAW: does it mTrsense t`# havegexplicit=isable <, <=, >, >=g?5#eq4w, otherY# may be a H"kaYoth are fine so coercec# ourselves@ unia# ("und p), swapKAargsQdo an Ireturn other == str(self) def append, s, charset=None, errors='strict'):8<A"""A; aWing to the MIME header.h0Optionala , if given, should be a C instance orVEname}Aof aIacter set (which willIconvertedVU). AOvalue of (default) means that0 inHconstructor is usedPs mayda byte6or a Unicod. If itE -j(i.e. is&0(s,P)2pfalse),n%ipe encod%ofLV, andEX`raised&%ngJ`cannot debd with=9s M s a hint specify}R ofEs inL/ n either case, when produc[an RFC 2822 compliantJ0 us+(047 rulesq#ed1'th`utput (c|0set YPloM, `'0pasa1s argumentN@callM.$5""" 3if rvY- = #._@Pelif k$,B Sb(1)VTV Tinput$ =.@odec'us-ascii'a3if )4== M.UNKNOWN8BITt:bs = s.z(^, 'surrogateescape'8OelseN F# Ensure`s we'r or8can #/0, owise an earlyumCL.{|#if?!y?try<.(x9TxceptEeTX &!=/^#^ = UTF8 ) self._chunks.append((s, charset)) def _nonctext(5Q, s): """True if string s is not a 5Racter of RFC822.@ return s.isspace() orPn ('(', ')7\\'dencodeAplit =';, \t', maxlinelen=None, sep='\n'Qr"""EM a message header into an-compliant format.) There are many issues involved in convert(ta given7for use inan email. Only certaL2harXAsetswpreadablFU mostKHclients, and asXqs can ob!onba subset ofJ7-bit ASCII, cust be taken to properoe (withM`Base64quoted-print). In addition, tkEis aM075-length limit on pd`field, soH `-wrappm0perPed, e double-byte | Op'al specifiesSimum of each generated, exclusiveQ4the+dividual@ mayelongerO@than}0len`a foldPpointbe found. The first[L@willc@shor!byOname plus ": "wO#5was*bd at HconstrucXS timedefault valudetermineUz UsaHar<17s which should bextra weight ._lgorithm duWnm Ki{in very rough suppor 2822's `higher levelMsyntactic breaks':  s precededa{wpreferr],!, 9 ;Y=$"orwLPthey aav@. S3k4tabPinclu in.O6indicate wheUvferenceto one overNo93as 0R"n GBs do6ppe& beJ4C doe\RffectD047 Gs|linesep is a string to be used separate the lines of value. The default 1 is6@mostPful for typicalEPython applications, but it can0set@\r\nproduce RFC-compliantP ors when needed.%5""" self._normalize()`if maxQ0lenUNone: "= J*8# AJof 0 means don't wrap. For all pract% purposes,KPchoosa huge number here ac0she~at and makeF _VF0ttexgorithm much simpler2 O== 0 !10ofg+= y(5headerlen,)kAqcontinuA_ws, splitcharslastcs = hasspace = ! $s"!, USet injchunks5if Xais notu %&"= anonctext(6[0]<!ifcd@in (, 'us-ascii')u9%orJN.add_transiO'OelifkyF h+-1i>9<Bf= Falsf>r. `feed('',5[0] ;elsHL B_s[1:] 0new( w.`_encod <  Q' ' + .lg?p():w@s(5inem & fw/`[:len( )- D/)]6).f;6]os) > 1if self._chunWks:  formatter.add_transition()'value = +_str(linesep( if _embedded_header.search(C)zqraise H(ParseError(": 3 appears to contain "D"an y ?: {!r}".breturnd P`def _n lize(self# Step 1: N# the chunks so that all runs of identical ch!tsh# get collapsed into a single unicode string.6lE= []Slast_`| = NoneIunk 43for\,@ in "._e %if(8== s (@unk.2nd({&Nelse<)if]q is not-Gi(SPACE.join()),U)F,(b"&$ =m:unk+xq class _VF{q_init__,len, maxQ@inua_ws, splitN4# == J7ont\0 _len = len(Ji' = _?current_! = _Accumulator(8Glen); , 3a@.new.[2sep+vs^GqA4'NL5q5aend_ofcXelf._G.pop8if 2!= (' ', ''T JWush(*?!enr V) > 0;Z$ifs.is_onlyws() and#M ?C.s[-1] +=!7~MR}KCw.reset( W3d + .p`Afeed1, fTC# Ifhas no header encoding (i.e. it is an ASCII3) # then we must split header a"highest level syntactic break"Opossible. Note that^don't have a lot of smarts about fieldHc x;<jbtry top on semi-colons,sn comma Iwhitespace. Eventually5is should be plugga=if charset.__is None:,Pself._ascii_J(fws, string, W=ereturnP# Otherwise, we're do ei a Base64 or a quoted-printGwhich meansV@needXHQ lineaLs. We can basicN find enough9`acters_0fitT7theNqcurrentrq, minusRFC 2047 chromWF@make!is trickierM!thw-"wem#to at octet boundaries, notM$ but it's only safe/a>Xh so atO:w3Gget close.&0ed_1s = ye(Qmaxlengths()S# The first elemi`extendD*e }f@noth}0morU Fstart a new:try-" =f.pop(0except IndexErrorIre are noK}o>nor"if/!is  oappend_chunk Blast`9#wa1onep0newc(l_c.push(ontinuation_B#X"ry#2elsAfull@s inQvmselves1for! r"s.x! +N!) UWdef _)Y662's FyI -%~2 while TruM:._ccG_lenO0*, Uplitchars):  ,# The RFC 2822 header folding algorithm is simple in princi Cbut JP # co"x#actice. Lines may beZed any place where "rMwhite space" appears by insert l[ep character{front of thePQFWS. picationthat not allq s or tabs qualify as FWS,Pand we are also supposed to prefer break at "higher levelGAsynt+ +s". We can't do eit7se without intimatknowledge structur ds, which doo8havPP. SoJP best+0can= thxecified@plit0s, >Qhope }2we achoose(L0arePlegal. (Thisat least betAthan6oldwe would sometimes *introduce*f0 afQ4a s,* i5RbeforldAturnqP runsoPsinglQ5ace%.)"parts = re. ("(["+FWS+"]+)", fws+string51if 8E[0]:J:0] = ['']Oelse+f.pop(0Y0forq,_zip(*[iter(\Z)]*2)I`self._nd_chunk(fwsC!) Jdef "5,U._current_%R.pushV Nlen(4B) > fmaxlen`)a# FindW| point, workbackward from,Aend.Dpre migh none, on a long first 9j chc^ e,i+_range._count()-1, 0, -1Jif ch.is(%) fwV[i][0[+ ifC#fws[0]==ch3< X@prev# = _-1][1$=J?[-1 Bvcontinu|IE/)  if self._current_line._initial_size > 0: # There will be a header, so leave it on a Wa by itoO0new,/()#if not fws# We don't use continuation_ws @becathe whitespacesSUafter should alwaysB.Cfws = ' '" push(fws, part ireturnJremainder =pop_from(iN}rs.append(str()8!u.reset() class _Accumulator(list): Qdef _l!__s(, y6=0)) =.Rsuper().Z)nYK,D, stringg #ELIicpoppedF[i:]0elfF = [ 7!op_count()==Ov('', ''Gpop(S__lenr5`m((len )+ R) forF1 inx%),* V ~?str~EMPTYSTRING.join((+z  artval=Nonet@ is ss U0[:] - "F = 0is_onlyws ==0 and (2_0 orA1.is'()[1f\1) """Rep4ggrPmanip@ing l)s via custom objects. This module provides an implement@ of HdRegistry API. The.is designed to flexibly follow RFC5322 rules. ` typesLort MappingProxyType $0imp$_utils_error_%_value_parsZs4ser5Address*display_name=Euser doaddr_spec): ")""Create an object representing a full email address. $An can have a 'display_name',Duser nddomain'. InPaddition to specifyDthe BR and = separately, they may beOCied together by usT_% keyword *instead of*SK5sfBP0stre#is%itNmust be properly quoted accord:to RFC 5322 rules;aerror willraised if it is notAHhas ,],Z,fattributes, all of which are read-only. The^NPvalueD~IObothF, buRwithout any Content Transfer EncoV6"""inputs = ''.join(filter(None, (,1ddr5)))if '\r' in _gor '\n:-O VE("invalid argumentPpartstnot contain CR or LF")# This clause &p its po"Qial 'x'; happen when a# applicaprogram c>s efa!#o)^library codeAelf (always supplJN_.'if  t%if;E #CType8 if0&U/or "G"tD alsFied"H5a_s, rest = parser.get_Z( 8!if6lIl!; O'{}'q "couldpd from >".format(  a_s.all_defects '9[0]~ = *`local_T &$  hself._) =U *r "aF@"!ty-9defd()preturn  Mty def username(self): preturn 3._u% @propertydef domainC #Aaddr_specDu"""The $ (@R) portion of t+ess, quoted4according to RFC 5322 rules, but with no Content Transfer Encoding.L5""" Blp ='if not parser.DOT_ATOM_ENDS.isdisjoint(lpxS6p_string*]Alp + '@' ++B/lp=E'<>'+Q__repr__+"{}(display_`t={!r}, $ )".format(v__class__._Y?__,1 , )/stJ  ySPECIAL7 $ =& )^ r= '' if ==[ elseXcU <{}>q,1mB#eqw, other'isinstance(", Address+NotImplemen.2 ==z &an^84:2A) x Group:EinitR=NonekQesses """Create an object Pesent!anPess gw.wA consists5(a followed by colon and a.Alist7ues (see terminatBqa semi-I0. OAis cq1ify  possibly empty M@Rs. A c`lso bed> a singleIIqthat isBin aZp, whichpconveni0when manipulaN!s Lare a comb$shindividualRe%InM th31ase `should0setSP. In^ticular, the st)ring representation of a Group whose display_name is Nonthe same 0as Address object, ifr4;and only -5 inNKaKes list. 5""" iself._= *U= tuple()S else#)|@propertyT9defi(!):preturn  M{J &G __/__8H"{}(!u={!r}, I".format(_class__._ ?__,*k,kI>str"if3Fx=1len.U6==1w{+tr+E[0])c. =o!i2not parser.SPECIALS.isdisjointlk5quote_st.sadrstr = ", ".P(str(x) for x iQ;c' ' + J$if 4)u"{}:{};! #eqw, other0if isinstance(",N)xNotImplemented"==x.&an<^& 9) # Header Caes # R Base"):m0""" $message hHss generic behavior Aprovides tools1subVeD$A  must define a}pmethod 1d 'X' that takes an unfoldWbvalue sPa dicary as its argu`s. Th"Awillqcontainkey, 'defects', initialized toRemptyp After3 caNb0twoil keys: P_tree[tg"th 0 obqed from4m,'decoded'K(5oC idem 3ZBdatap;.2 (Tais, enpP wordn#e 4Fat have canonicaz w@&so3ed.7intended to collect parsing defects, which the message '%er will subsequently dispose of as appropriate. The9should not,Ppinsofar4practical, raise any errors. D Abe added toLlist insteadvstandard headers register for RFCHcompliance issues,obsolete( syntax, andunrecoverabl1ingN   method mayitional keysA dicry. In this cassubclass must in:s 'init'gb ss<hHf0itsword argumentuse (usually by@settH@themNAvalu similarly named attributes)Jremove allPextras$`ed by Pthen PsuperBcI-1ent-2wit`remain0key&s.jalso make sure that a 'max_count'3 isd, is either None or 1. XXX: neSo bet3API2"""def __new__(cls,\!, u!):pkwds = {'e': []}Acls.T(9 , 0) if utils._has_surrogates('['decoded']qu$ =Fsanitize@rself = str. q11delpM.(y@, **Gpreturn 'U0S"*,A`_tree,+- ._c! = _a>' =K &$ =b@S2erthi(t=f@Qtuple#._*)Jy__reduce__#(_nstruct_ /1.__ __Zame__7)_bases*"tr E)y#__@x9  (NAfold , bWolicyGe"""Fol`accordAto p-fd representaCfolded accordisng to RFC5322 rules, as modified by the policy. Ifarse treeEcontains surrogateescapDtWH bytes are CTE encoded usingI( chat 'unknown-8bit". %Any non-ASCII /acters inn ; set utf-8. XXX: make this a settingThe returned value 1!n -only string possibly $ulinesep, and end'swith a .0. aincludesNDheader nameR': ' separator5"""=# At somint we need to put fws here if it wauusource.I0= p1r.H%([! [Label!%VgTerminal(self.2, 'k-9'),a@6':':ksep')];%])J1if p__:c.append(7r.CFWSList([WhiteSpace ' 0fws a ( /Rfold(=) def _reconstruct_.P(cls_DP, bas)YNtype)H{}).R(: class UjBured:max_count = NonQ=kr = staticmethod(9Wget_uU)O@o+3,c, kwds!['''] = cls.15!de2Bstr(Kq~ Unique ()1NIDateF2"""b whosepsists of a fle timestamp`Provid n additional attribute, date6p, whicheither an awar'! ajzone, or a naiveM?Y% inis -0000. Also acceptq2put{''onormalized form<Pmeans!isU0out!of;5at_ovT 0# Tcis used 1@for ing, notiP crea}$ 'l`%ured) @classmethod def parse(cls, value, kwds):!%bif not)!['defects'].append(errors.HeaderMissingRequiredVc5())^Hatetime'] = None$aecoded#/''!B_treGr.TokenList(yereturnGif isinstance(7str +G$:try,' = utils.date_to_v qexcept ;E\Z InvalidDateD#(' x or format'a (8 o=d!UO(Z Acls.i_"r(&dh!) 8init(self, *args, **kw+. = kw.pop('t'super().UOp@property~DuH |1 p Unique( "):kmax_count = 19rAddress6*{@statice T a]S_list" =hr.get_! !fassert, 'this shouldh.$V@&    6"# We are translating here from the RFC language (/mailbox-0# to our API4cgroup/:!)./+|= =  Hdis = []@for O1 in1essW.^essesL9G.display_name,g[9(mb>/''DXmb.localtB%bdomain> h D$mbBS.all_;es]x0 = 97s3ll_ ) elWse: # Assume it is Address/Group stuff/if not hasattr(value, '__iter__')^i$A = [ ]Oggsq(None, [item]) mB, 'aIes')Ll0els/em4@for oO in adefectbkwds['R'] = p ;! "Qcoded"', '.join([str(() d] if 'parse_tree'0in } [+Acls._D"r(&#de!) def init(self, *args, **kw"._ = tuple(kw.pop(')/0 = osuper().wq@property1yrreturn m#A D#if@": be%f-sR"inu.&es`  class UniqueyHeader("):)max_count = 1?_Singl?f1len:!=1epraise VError(("Q of s a! h0 {}"i+"a5").formaW.nameTfUes[0]Vb MIMEVersion3 = staticmethod(.r_mime_vU@-L.R(cls,,PW''xM= = ZBirR*'].exten+S.all_\ 7Qmajor[b@.minsz 2;d2O)G) in=}1 c s:)BMappingProxyType'.$Eams)pContent"()DGk= static3r`Bse_cZb_type_)6#t`._mainc< = !G.,#?subC+o% %EeD $C~H  + '/' +N]&Disposition-Ddb4, **kw):   super().init(*args, **kw) cd = self._parse_tree.content_disposition2-" = cd ifs None else utils._sanitize(cd) O@propertyOdef W(q!):#creturn0 class CTransferEncodingHeader:max_count = 1Rvalue rtaticmethod(#!r._|ta#_eb!_hcABa(cls, pg, kwds![''V'] = l1ls.<( Bqdecoded?2strR*fects'].exten+q.all_de V(, \>}._cte ='C.cte~9/te) %teMessageID jQ^  mQ%_ir # The  factory # Cault_map = {'subject':OUniqueUnstructured,>Odate;2 >IDate6resent-= 0Oorig.fosenderSingleAddressF9/tot`xr@3/ccl+@lb-9@3OfromD@loreply-v9mime-versionRMIMEVY 'content-tlype': ContentTypeHeader, #"'c-disposition>7D>transfer-encodingD>TE Cmessage-id4M(ID5} class Registry: a"""A h_factory and# r.B."""1 def __init__(self, base_dD=Bas3 defaultUnstructuredU Duse_=map=True):#"""Create athat works with the Policy API.D1 is' Aaill beRlast !inc|d=$P's __\s__ list. nPused if "name" (see __call__) does not appear GE rols whether orH#m mapping of }Es toPspecialized es@copiAn toh1W%isMDd. The"Ovl.^E= {}Owl' = %( +;if ~ .update(nR_map)q3map_to_type6bZ, cls er" a | for handl*xs?[}.lower()] =m__getitem/acls = vP.get('V, a)bqreturn '_'+cls.__@__, (cls@W), {}R O?val, instanceD 'z' from 'D'GnsoC1by /a uparsing^represent9;fJ ZTombin"FG_5theE ,0pas#coe" 'sf'orA=]6!, c#) # Copyright (C) 2001-2006 Python Software Founda # Author: Barry WarsawLntact: email-sig@python.org """Various types of useful iterators and gen.""" __all__ = [ 'body_line_9"',Yd_subpartCwalk*# Do not include _structure() since it's Ithe debugging API.r] import sys from io "StringIO # This function will become a methodiMessage class def q(self):x"""Walk over m3tree, yieldSeach !. ;1TheO is performed in depth-first order. Ais aBu &!if .is_multiJ(/4for~8.get_payload+/^b)^uese twocSs are!to+In.py interface module.ob(msg, decode=False2"""Qes, returns  s @-by- Op#ald (default massed through to 1  `Bmsg.1BT$ = P)5if isinstance(CS, str% /l@main ='text',?Non} s with a given MIMExoTUse `cA' as+bmatch aga0; tAs to"E". @`sub'W!ifIomitted, onlyJI/edcontent_[d() == ;&z  NM LP}g0fp=k, level=0,_{ wA handy4aidTif fp fpys.stdouttab = ' ' * (}B * 4`print(" + MK!(), end='', file=fp91fU' [%s]' %Y_Y QLelseC !!ifIz yC, fp-+1 ) # Copyright (C) 2001-200<7 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@pyG.org """Basic message object for the 6W pack model.""" __all__ = ['MC', 'Email] import re $uu quopri from io * BytesIO, StringIO # Intra)s9_ utilXerror._policybaseyP, compat32`charset as _ &._encoded_wordsX deC_b C>==. SEMISPACE = '; 'Regular expression that matches `special' acters in parame, # existence of whichce quoting: value. tcps = re.ile(r'[ \(\)<>@,;:\\"/\[\]\?=]') def _splitQ(): # Sw header. BAW: this may be too simple. It isn'tGstrictly RFC 2045 (secQ 5.1)liant, but it c8CmostsMfP<wild. Weeventually need a full fledgedCser.HRDM: we might have a HPhere;x now just ngify itCa, sep, b =;`.partiQ(';')m`if not.Y]return a.Yp(), None/b&" Xforma,=E,,ce=True"""Conveni[2fun tomat and yQ key=Wq pair. TBwill_u eeded or e is truf)1s aLthree tuple (set, language ), r3be  accordingIoU2231 rules}f7cSins non-ascii{!t Xrlikewisxe+ ta@, us~Qutf-8Wj!nd0a nv-i |Alen(sV) > 0(3# A(pis used Ij0s wR item9} # p%. @is aAing,$a J# instancsqRnever5`d, perHTif isK,%1# EFv! y += '*'" =y.@_rfcGv3[2]z%[0 "1]\$ '%s=%s' % (param, value)# Uelse::tryvalue.encode('ascii')7except Uni$E*^ErrorMparam += '*'Dj = utilsr_rfc2231(, 'utf-8', 'Areturn '%s=%s' % (p!, = # BAW: Please check this. I n at if quote is set it shouldq# force'ing even7not necessary./Qor tspecials.search)4H"%s"&;I 62B def _parse#(s# RDM This might be a Header, so  now stringify its = ';' +"(splist = []5while s[:1] =/ @Bs[1:*end = s.find(';"H > 0 and (s.count('"', 0, end) - '\\V) % 2{mBB + 1# ifVO < 0;4len-fV[:endif '=' in fBi = f.index('=J`f[:i].up().lower() +O+ f[i+1: k:~.append(f?s3endu$ %!uns#'is different thancollapse_B) because~qdoesn't# try to converLe2a u@. M`ge.get@am()F sre both curly defined]the tuple inMface of RFC  2Retersif isinstance#,IUd3[0]C[1],0h@2[2]+ 1) class """Basic m6 object. Aas someth that has a bunch1822Jh#s a payloadt may optionally have an envelope ;Fp(a.k.a.|x-From or _&)S f icontainer (i.e. aOmultipartGa/rfc822),Gn a JJ6s, otherwi{#ngQ4fs implem`mapping 0terb, which assumesuk exactly one occurrence of th e header per message. Som4s do in fact appear multiple times (e.g. Received) and for thosK,L you must use the explicit API to set or get all#bs. No!ofM@mapping methods are implemented.)1"""def __init__(self, policy=compat32):) .# =( _[ = []unixfrom = Nonepayload@char :# Defaults]4artreamble = pepiloguzdefectsq content typd_ = 'text/plain' t3strsb"""Return`entiredmatted as a string rE2as_+&()$$, =False, maxUlen=0(,Optional '}', when trueans includUnix From_ envelo|. For backward ibility reasons, if& i*not specified it se0, so override'%ly!if+want a differ4\B. 'R' is passedk&thXGenerator instance-'serializ!; itQ5not'v associa^AwithxGn!isq.@)If*aobjectains binary data tha encoded`accordpto RFC adards,`@non- liEOwill be replaced br0uni` "unknown 9qacter" opoints4vemail.gqemport ?K#if{,S else;afp = SEIO()6g =i2(fp n pmangle__D *w[=0.fln#= +rzfp.getvaluew__bytes_lJ$C s2.astself, unixfrom=False, policy=None): +"""Return the entire formatted message as a bytes object. COptional 'unixfrom', when true, means includegUnix From_ envelopeNheader. '' is passed to?BGenerator instance u$Kserializu; if not specifiW#he associaEwithKAp!iss.&5"""  email.gjmport 3 = self.$if0is D els;Bfp =WEIO()g.(fp, mangle_*_=vB0.fl  n($, = +rHfp.getvalue()&def is_multipartL@Truepconsists of C0le G(s.q$isf._payload, list#"'# 2linDset_M.(% =#gI? F;2# PPipulaou"cattachfa"""Add>cgiven #StcurrentKThe  will always be a[s after this methodpsis called. If you want1seta scalaru,pK,!()2eadj"ifT TL2SC = [ ]s{ 4:try I.append(M0*except AttributeErrorQraise Typ!1("Avalid on a& amb" non-W%ar")[`iF, decodeB mTa refereJ bZheitherZs or a string>Rmutat92bamodify]$'s in place. "i s that index inA`a flag;picatingshould b\dnot, accord@~Content-Transfer-Enco!header (default is False).  When True and the message.not a multipart, payload will beJdecoded if this header's valuO`quoted-printable' or `base64'. IfNsome other encodingPused,6bqmissinghas bogus data (i.e.V!uum!ed%)Jis returned as-isOI D@c+A flakVn Noni.5""" Q# Her[alogic YB for , Ad onemail5.0.0 :O1 iT is_m result/-! -G" -5!  -P"  Z_(a list)g1:element i (a M:G Orerror (g; ;1l1 d (bytesNote that Barry plan to factor out~'E' case, baVisn't so easy nowYwe handlhqe 8 bit, which needs to# convertan bothCnon-Fpathiif self.&().#if # @if ir6yw?Oelse75[i]:# For backward compatibility, UsDtinstanc 2is L*Sead oAore }*al2ItestQR|(, raise TypeE>p('ExpecA, got %s' % typeQ)= l# cte might be a H,]stringify i8R= str|get('content-transfer-ging', '')).lower($# 0mayrZ hereQs;1,{):  if utils._has_surrogates(payload): b3 = .encode('ascii', 'Iescape')Fif not de:et?try{4 = .L (self.get_param('charset), 'replac]except LookupError!nOelifl0Unim!# This won't happen for RFC compliant messages ( E # containing only ASCII  points in the u input).OIf it doesR, turB0strginto byte[_a wayMguaranteedto fail{sCraw--!re if cte == 'quoted-printable'Acquopri( jYkbase64O# XXX: tis a bit of a hack;_b should probably be factored out somewhere, but I have]figured %!J yet~value, defects =(b''.join.splitlines())Dn sL'6policy.handle_,P [lin ('x-uu !'gin_file = B%IO dded as n5"""V Ud "Q.del_#('1&R! =1c! Bw 3Hif 'Z' n 9Badd_(8g, '1.0Z?ypeZ 80, '7/B'B =Z.get_/()n  R 9!!=?set4\6Rbody_(Z h uJcte body_encodingG() Itry:cte(self+except TypeError8-# This 'if' is for backward compatibility, it allows unicode# through even th that won'rk correctly if thGpmessageserialized.ppayload = #._ (3if =R:$ =D0.en ('ascii', 'surrogateescape'EU=)vcharset.output_r 3 = )c.body_e=add_header('Content-Transfer-Eing', cte) tedef ges"""Retur2e C instance associated with %'s}i"5""" rW#$ # MAPPING INTERFACE (partial(__len__ total number of ( s, including duplicates.1lenb.csC__getitemy, name)ISGet awr value.fCNoned*pis missx0ead1rai2an 7ionOQNote M appeared multiple times, exaQwhichpoccurreRgets  edundefined. UseFall() to zI2theps match Qfield10+Aget([;s|,p 1Set|E 90: tadoes not overwrite n0ist@Qsame S__del!p) first(AdeleXIy exYs max_countBrpolicy._%5if l" =[lower@foun07vsk, v ins^+Sif k.ZA == r'+lI+= 1m2if "/>='$0e Vj ("There may be at most {} GT"in a".format(max_count, name)) self._headers.append(rpolicy._store_parse(C, val)) Idef __delitem__@j:!m"""Delete all occurrences of a h, if present.]< Does not raise an exception13the@ is missing.z ! =v.lower( 2newes = []4for k, v in 0Dif kT" !d "&en(\ncontainsoireturn[]hCiterd)<Qfield ue[y+ 1\Akeys+XB"""Raa list0ll message'sPs,These will be sortedCPorderM y (areiginalo, or were added to@ and may  duplicates2Any1s d d 7qre-inseaaQlwaysnk[5"""0[k V _value+C|n ;Sfetch;q[1GetQ "smy#1get , failobj=NoneSLike __get__() but U instead/` when the field  is missing. 5""" pname = .lower() for k, v in self._headers:#RDif k<" =L "&SreturHrpolicy.N_fetch_parse(o4failobj v#$ "Internal" methods (public API, but only intended use by a orLor generator, not normal application codeD#def set_raw(,F, value)"""StoreB and"Vthe model without#ifs.h>@This@an "F.append(()raw_items R ? o pairsC?Aiterccopy()R@Addial useful stuff$ qget_allRK=Nona list of all ,&syyd fieldese will be sorted8PorderKy8earaiginalmessage,~may contain dues. Any`s delel5andEqre-inseare always} toIf no suchcsexist, ;ed (defaults to TDE= []IR}:O it Nu3add_1, _)@, **Y:ams#ExAsett#pG% add. keyword arguments can@used'5setOa\parametera,+0 uniPcoresvwOqto dashN!ly}]5 ad as!="" unlessOl,awhich caseE:keyVu. If aG}Qes non-ASCII charac$it1specified asOthree-tuple9(<set, languh)se it will b3e +encoded according to RFC2231 rules. Otherwise it will be :UusingPthe utf-8 charset and a language of ''. 1Examples:8msg.add_header('content-disposition', 'attachment', filename='bud.gif')cP <'g!('', Fußballer.ppt'))@|A'o5"""{parts = [] for k, v in _params.items():% if%js NoneZ.append(k.replace('_-.?elsD q_formatQ7, vTif _value is notinsert(0,0`self[_1] = SEMISPACE.join(=)Cdef <!, =Y$B"""R2 a 'first matchx,` found#message, retaini/Qorderdcase. If noV2wasZ, a KeyError isuraised.I" =v.lower(KT@i, (X)zip(range(len(..;Zs)), 9+Dif ka# =r #' C [irpolicy.`_store se3IUbreak4( #7# Use theree methods instead thRabovei#dCget_Q_type8W@turni 3's 4 4h0The4urned strai.Perced 5P`mainU@/sub'\  e OCno CCType&th`,qdefault as given by )g reed. Sinced 2045,s always have a ^OR thisi-e1 a _P1RFC`Hdines ai 's totext/plain unless it|9!ar idPmultivq/digest`ainer,PRwhichmould bcr/rfc822Zmissing = objecSt() value = self.get('content-type', missing22if 5$is:OV# This should have no parameters-ereturn_default_~c = _splitL()[0].lower.,# RFC 2045, section 5.2 says if its invalid, use text/plain1if u.count('/') != 1'A'BF def get_cP_main(~)ZB"""Rthe message's 0 = 9.Xvt0is 2`) 'wAt ofrstring Qed by>95().5""" /5(dBB2[0] 1subB  Osub- X~1 `+' DMost4s#a 5 4, except forq~at are subparts=Pmultiq/digest^ainers. SuchI7q/rfc822\&.0[9seta, h?SetWbe either "j" or "", although thiis not enforced. The+stored inYCType header6/" =7_]s_preserve;failobj,dEa# Like;t() but A=`e quot}o>"6BAW#1'9 bepublic interface? = objec !s}U = []Pfor pa_parse#s:tryPname,`S = p.9V=', 1(,0 = .p val = val.strip()  except ValueError: # Must have been a bare attribute2name = p.strip()!val = ''params.append((Ef, val)@# = utils.decode_(-rreturn  ktdef get2)self, failobj=None, header='content-type', unquote=True)$B"""Rgthe message's C>BTypeeters, as a list.eThe elements of K!ed, oq2-tuple"Pkey/vB paiWNsplit onG`=' sign. f0leftnd sidel%!is0Ekey,JQwhileHrigh9.A. Ire is no Pu5 inLT=2`empty /#ng %asFdescribed i() methodXOptionalmobject to f* i{5. VUto search instead ofDY7WEZ,%d.B5""" missing = hj@s = %._&s_preserve(>7"ifs&b68$if&/c[(k, _(v)) for k, v]ROelseL)B (,m DEfounUKA, or?z1 haBsuch P^Q keysalways compared caseensitivelyYYcan either be a%2a 3~Guwas RFCLp2231 en0d. When it'D| kform (CHARSET, LANGUAGE, VALUE). Not>at both +E and6 2be in which)you should conrdb}Hus-ascii charset. You can usually ignore LANGUAGE. #The parameter value (either the returned string, oVALUE item inN23-tuple) is always unquoted, unles#set to False. JIf your application doesn't care whewas RFC 2231LPencod~i< n cinto a as follows:41rawo = msg.get_u('foo')u, = email.utils.collapse_rfc_t(W)n5"""Nif header not in self:m failobjfor k, v5%._s_preserve(6,f)[if k.lower() ==1 +$if _v;(OelseB vSDUdef s1,,='Content-Type', ree=True,c charset=None, language=';aplace=F"""Set al!in|~ TI6already exists R, its will be!read withy2new, oK qand hasyet been defidEthisnpmessage"text/plain" V%ndJDappended2per7045An alternateP can be specified7 argument,5all~s0nec$ry8<3If 6,fe according:5RFC:P. Op%alsZ  ,uaultingM!to-Semptyu. Bothq shouldRsO sinstance(#, T 'C = (d%#'ct tcF = ''!/V(n!if+ $x4 9a } = _formatP(ote)  `else: ctype = SEMISPACE.join((4[-, _formatparam(, value, requote)])BxGU = ''%_for old_R V in self.gets(header=,GK!un= Sappenh&if.lower() == Y; ]X ^Y] \,g eqif not 8 = u G? qVZ"if5 !=!)if replac[_QE,_W1del[A]f" =Y &rdef del((,<", M='content-'W=True"""Remove the givenIeter completely from$CXTm.3The will be re-writtenQ withoutQToaor itsLbR. All*sSd as necessary unlessM& iHFalse. Optionalspecifies an alternati o5"""$if[ Uereturn2Dnew_@p, v1  Dif pOl "&+ =5, vj 8R   d$q- ;W @set_ q "Se;Pmain D and sub >O+@musta string in the form "maintype/sub", otherwise a ValueError is raised. *This method replaces the Content-Type header, keeping all%Fparameters in F. If requote{False, tqCleavhexistingLl0's :ms is. OE'e tqwill be2ued (theOdefault)An alternativ@ canDspecified  argument. When`#,set, we'll always also add a MIME-VersioMl.]5""" # BAW: should weetrict?$pif not .count('/') == 1:% P# Set , you get#if$q.lower(t#'cD'del self['mime-v %']!*'] = '1.0'){!inW mH\@?hVreturZ1s =JR.get_(C=@, un#e=)T* a# Skip{RfirstR; it'2oldhfor p, vN[1:]$.s(/,,)0def_filename(, failobj=None)]A"""R84 associated withpayload if presFr}DThe r6`extrac@Afrom@`Disposition%'s `E':, and itXdCthatDHmissQ1falls back to look`L = object(O $('3', A%, wd/'N)ifo7WrnVgxa utils.collapse_rfc2231_v().strip(boundary4#>?is TOD's `6ted. c """ missing = object() boundary = self.get_param('3', A74if 4 is :Wyreturn failobj# RFC 2046 says thatMies may begin but not end in w/sE\utils.collapse_rfc2231_value().rstrip() @def set_ (,&y)"""Set the @eterContent-Type to 4.l@This%subtly differenXan deletf Pheader andK0add+a new one with via add_J(). TheNEmain ceu- ') method preserveN or!of/!inoriginal message*HParseErrorraised iX4 has no g.s_$s_(C, 'cYtype'G #zOre w, we don't know wl#kset it to, so & an exception3 eU,s.g?('NK f3newE= []'p = Falsfor pk, pv+9\if pk.lower() ==@ )-}.append('"%s"' %)>6TruOelser[!ifZ B @ hadattributea# Tack!onDend. BAW: should8# instead???Y'# Replace1xisS2new WQr h, >.shIif hD  ,KpartjkrB+Aif v' $jk$z B`'%s=%s(+ val = SEMISPACE.join(parts) newheaders.append(self.policy._store_parse(h, val)) KYelse:h]?)m_gFs = 2`def get_content_cht, failobj=None)"""Return the 3 parameter ofCTb-Type .vQThe rFed string is always coerced to lower case. I[ re+%nok`, or i/#at~~ has no,I_.5""" @miss= object(t!= ~_#('3', ?5%if$iss2if isinstance(ch, tuplB # RFC 2231 encoded, so de it, and it betend up as ascii Mpk$ =0[0]uA'us-0'0:try # LookupError will be raisedaisn't known tG# Python. UniU Y textKaains a acanot in ;pas_bytel$B[2].nr('raw-u-escape'?8 =(Q$, q 2except (H,)vb 5[2]#1setPs muse range7 [8 046, $4.1.2 s6`s are 6 sensitivWb(rL sa list 9Q(s) u?oessageKof items describes{sjffor tht1allM1sub5itswpayloadAEach`eithera(Tvalue `G< at t)P WE'',|(defaults;,H@ doet have aLmain MIME t@of ""Gis not definedC. 4The list will contain one string for each part of the message, plusL6/"J$er, (i.e. self), so that a non-multi`Ka streturn aof length 1.65""" /[WP.get_ent_charset(failobj)&1 in.walk()]%Hdef ?disposition(:sB"""R!'sVGent-; if it exists, or Nonevalues can be either 'inline', 'attachment'I`accordtre rfc21834j" =Sget('5%')^2if 3!is ^2c_d = _splitparam(A)[0].lower(^@2c_d0# IB~2 .. from email.iterators import 0 class MIMEPart(M"):`Y__init__, policy=)#if @udefault %",= 0sup.*&) 2as_@unix}=False, maxheaderlen `entireemattedCas a Op Dal '', when trueans include>Unix From_ envelope). h re ed backward compatibility withbNSbase  T, butmAs toa, mean'oP@max_{_#@rolsy CimumB. 'OE' isM`passedp2Gen instance userializ>X;CNis not specifiX$hepassocia#nyUV# D els}f!0lenXWl# =.sS"+ )C_BYFelf.V=x. .clone(utf8=True)[6is_aJh>{k@c_d.f%==ent' def _find_body(self, part, preferencelist): !if".is_attachment(!(ereturn4maintype, sub " =Eget_content_().split('/')?4if B == 'text'q%if[+in *.zyield (s.index() 8 != 'multi?' or not R*) Q{related0fori art.iter_sbBfrom ub7 }@' , o{kE mcandidate = NoneXstart>qparam(' 3 :"#['P-id']a-sb Ubreak6if 9!is Lsjyload(I=-Vs[0] as elsee OwQe@def p >%=(, 'html', 'plain')fA"""ReW best8Amime] display as 't' of message. Do a depth firsaarch, ing with=`, look`3the2$PPmatch$@eachs(^items0b, and c ( JcorrespondO!to"P that has a u,{0no %sDhave*e. If n1 isincludedconsiderPBrootquof any /% encounteredaJBgnorsu"'C!-Disposition: |%'.E5""" _prio = len- f; 7+ T)< G%r bN== 0[" `dbody _body_types = {('text', 'plain'), &Ohtml%multiparPrelated-alternative')} def iter_attachments(self): """Return an-ator over the non-main us of a %. GASkip1Pfirst(each occurrence(/%!, .X/F, orn/1 inn3 (unlessthey have a 'Content-Disposition:  ' header) and include allN rering sub r=%ed<. When applied to aHAndaexceptAroot5. MUemptyx, wv;'ort.[5""" , 0 = Eb.get_cZ().split('/')?4if BU != ''2subS7= ''$Sxpayload(x`# Certmalformed messages can 0set`5/*`u# but still;asingle` body,which casp.copy()sL fail with AttributeError:tryw#= XT7 O B#< is not a list, itmost probably a stringv=L c# For , we treat everythsx as a# The )may be indicFp by 'st[@; if`0re' %we#p't find00 naF/,1 as, 8 Cram({"if @founJFals)[]!2forb'!if&#('%-id') ==8>Tru!Oelsew.append( )1if kKyield from A _rss.pop(0y yield from parts ereturn4# Otherwise we more or less invert the remaining logic in get_body.LThis only really workI edge cases (ex: non-text related orHalternatives) if@sendagent sets content-disposition.Gseen = [] # OAskipLfirst example of each candidate typeJ1forJR:eZ1P, sub ! =/.#_().split('/')C]if ((H)qQself.jDYs and<2notwis_attachment()1%0in )C.append( %IinueQyield def iter_0(pA"""R1 an'ator over all immedi1subApa multi.eHVemptyNah721""" 0if E.is_*($S,payload()x(, *args,_manager=None, **kwi,if(@ is + bM" ={policy.rq Cset_< (a . W_make, disallowed_s, boundary:K_u() == 'Y'existingaI(/ =4 + ,C=if /inD  ra2ValueError("Can]"co6{} to {}".format(? C)keep_headersJ pname, vHH 0if -.rt7cwith('\'-'7(Jw3JelseyE !ifb L# There is existing content, move it to the first subpart.  = type(self)(policy= . )2._headers = B)payload = R_ * @ = [T]#Uelse: 1-Mkeep%2['C/-Type'] = 'multi}@/' +1zif boundary is not Nonset_param('2%',=!) Sdef make_related&=\)!._1#('< ', ('alternative', 'mixed')R x0|"@q,r"l":f^V_add_,`, _sub, *args, _dispXg, **kw^1if S.get_HP_mainAH() !A' ort >~=s9qgetattr{{/(}..("ifc and '+-'osition'!inbEDDisp4Llhpattach(8sC 5wp='inlinpmq='XeOmentd >RyGBcleaE`1 [%! = NV (n, v) for 3 inz|0 !if]n.lower().startswith(/')  class EmailMessage(MIMEPart):  i"up ='iX-Vers,^P[-%"'1.0' # Copyright (C) 2001-2006 Python Software F # Author: Keithx Dart # Contact: email-sig@python.org """Class representing application/* type MIME documents.""" __all__ = ["MIMEApplication"] fromw import encoders .mime.nonmultipart-MIMENonMA cAk()u): for genera= >def __init__(self, _data, _sub='octet-stream',u;_="s. _base64, *, policy=None, **_paramsJreate an%.  is a strc  in xthe rawP @C/)C@ent  !`, defaUng to ZrZ`a func2 which will perform xbactual;5forcQtransZ"of-  yMAny addial keyword argu are passed tomM constructor,Pturns0qm into eters onent-TypeJuheader.q%ifD<`raise PError('Invalid%')iN.'' }i.set_payload(R)pyright (C) 2001-2007 P` SoftwQFound # Author: An y BaxterN-!_udio/''^A1C'] csndhdr0$iowBytesIO,@G&2 _t_map = {'au' : 'basic 'wav' :'x- `'aiff'# $c$ } # Therez0oth22in  that don't havePs. :(@ones beG? midi, mp3, reala, wma?? whatsnd(`"""TryR id2 fyebQ file[g.EP() hapretty cruddy erface, unfortunately. This1why"we re-do it  . It would be easier to reverse engineer the Unix 'file' command 1use$standard 'magic' / , as shipped with a modernT.N1"""hdr = data[:512]@fakeJ = BytesIO(hdr)or testfn in sndhdr.!s: Sres =&:$, RD$0if 'is not None@ return _b_MIMEmap.get(res[0]K'@ class .`Audio( NonMultipart)fA"""C*for generating a5!/*A documents..def __init__(self, _4B, _subtype=,2@_enc="s. _base64, *, policyB **_paramsJreate anv %.  is a strpcontain q2rawO. If thisLcan be deJd byPython `'y@ule,%nH*P willQautomatically includeddContent-Type headerOtherwise, you specify s #icz0via rBeteragiven,4no Nv%beMguessed, a PError}hraiseda function whichpperform actual 45forstransport oqe imaget takes one arg,h!isKI: in`"ce>pshould {get_payload() s%toJRchang21 to0ed bpalso adyHPfer-EJ@or os`@mess%asE0necpry. ThVfaultOAis B0Anyial keywordCs are pa{ {constructoruxvem intow#&ypZ %ifm= _whatsnd(S(I1('C fiI"'^ .S'S'PZ :. ) # Copyright (C) 2001-2006 PSoftw`Founda& # Author: Barry WarsawL ntact: email-sig@python..org """Base class for MIME specializations.""" __all__ = ['&9'] import email.policy from message oE(".M#): 0def __init__(self, _maintype, _sub 2*, =None, **_paramsxL"""This constructor adds a Content-Type: and a5-Version: header. N;The7# is taken /6theZJarguments. Addi1al Betertc;aredMkeyword U#if03L" =.compat32R .F=)6c = '%s/%s' % (0R.add_(('1', Pj: ']y1.0' # Copyright (C) 2001-2006 Python SoftwkQFound6 # Author: Barry WarsawLbntact:2a-sig@pG.Crepresenting image/* :C doc  I1oimghdrencoders.mime.nonmultipart{DNonM v(%Z2"""iogenerahFdata:_="s. _base64, Create an_>Pa strpcontain 2rawO a. If can be dePd by <standard`' module,%nH P willQ automatically included i6 S Otherwise, you <fH3ficy0viaBr@@funcb whichqperformSqactual 4^5for^Qtranso_edst(Us one,h5hisK0 in}"ce> should use get_payload()s%toJachange21 to edmb@alsoE anyHPfer-E@or o headers to the message as 0necry. The default encoding is Base64. 5-Any additional keyword arguments are passed to the base clas{ constructor, which turns0m into parameters on Content-Typeuheader.5""" if _subtypeUNone:= imghdr.what(), _imagedata)5R`raise Error('Could not guess Uc MIME '_NonMultipart.__init__(self, '>%',, policy=,1**_[sw].set_payload(_!er) # Copyright (C) 2001-2006 Python Softw `Founda0 # Author: Barry WarsawLntact: email-sig@pG.org """C@ represent"/*O2doc. __all__ = ['XMge'] fromjt import.mime.nonm,MQ h('){!Kdef F_msg ='rfc822', *yE}treate a1/*  Ce=1 object and must be an instance of e, or arderived  'Ptherw9a;uNd OpH%al1ine9Q\xcontainedBis "<p" (this{1def;!by|dard, eveEoughOsFtermMis technically outdated by RFC 2822)od  !if$is(,'+{3('A# It's convenientAuse c method. We ne8Udo it[#40waySwe'll geQ exce-.q.attach , P# Andsure ourOis set correctlyc13_/#('z/M'%2%I`for MIME multipVart/* type messages.""" __all__ = ['MIMEMultipart'] from email.mime.base import MIMEBase class @(Base): """ +1forB$ mp:def __init__(self, _sub='mixed', boundary=None!sL*, polic1!*_params:"""Creates a%. MBy default, c9, with properCContent-T1and6-Version headerss is the )1 ofo" cY,eing to}`'_g_Pstring. e it isWcalculated as neededdea sequence0ial"Hpayload. Ithmust be an iterable object, such~a list. You can alwayattach newu"toLIa by us:2he 0() methoAdditional Ydeters  are taken 5thekeyword arguments (or passed in&%).A.f''Rs8?5, *)# Initialise _0 toQemptyvMIQsuper 'p# implea?%s_p assume&atlib#ws\.F= []!ifuv:Op in $Z%p)%if T0Dset_V( ) # Copyright (C) 2002-2006 Python Softw<F5 # Author: Barry WarsawLbntact:a-sig@pGo.org  AQ that6nota`?Noncort errors|!\Fnon-K #, # The public APIchibits ilI}# derivedq@s si1non@themo,z1def0on,M # type multipart/* raise errors.M!ConversionE(/6'Cannot attach additional sub_s to non-mP&/*') # Copyright (C) 2001-2006 Python Software FoundaU # Author: Barry WarsawLntact: email-sig@pGJ.org """Class representing text/* type MIME documents.""" __all__ = ['MIMEText'] from i.charset import C"mime.non,r5Nonfa cPText( $!):|for generadef __init__(self, _ `, _sub ='plain', _=None, *, policyTreate aU!. 0q is the strthis message object69e content`, defaj1o ""GG`acter `paramePaddedCcU-Typeheader. Tx"us-ascii". Note that as a side-effect,Odransfer-Encodi will also be.;Zu# If no was specified, check`see if0re jY%# #s ;.`t, use '', otherwCVutf-8b# XXX:,0canremoved once #7304Vfixed8&if0is :tryc .eB&e()%' = &except Unicodee v.GM'.'umt,C**{' ':Y(6)}).set_payload(-7, Thomas Wouters, Any Baxter0A phr of RFC 2822 and8P<Q', 'H[Bytes $v['Feed.$ioS@IO, IOWrapper CfeedES!, 9_Dbasepcompat32 I_init__(self, _class=None, *, policy=compat32):  """Parser of RFC 2822 and MIME email messages. 8"Creates an in-memory object tree representing theKu, whichO0can%n be manipulated turned over to a Generato re =MvtextualPationpThe str@mustaformats a blockA"`header"d  couulines, opally preceded by a `Unix-from'He. TheN]is termin`eitherH0end oaK`blank + Z1he 8finstantiate for newQs wheyb?cd#isVhave a construcAhat &ak zero arguments. DefaultM. keyword specifi! ty`ontrolAnumb a=$tsXp*P's op1ion3e d{maintainsIbackward wibility5"""-Sself.= h=Adef (AS, fp,Ssonly=False% a@ure V data in a fileReads all'5+s#DrootKsure. O-ca flagy1wheuto stopN after readO s +ot1is %,I@mean;"it[ ret.;@feeder = Feedt.)M(if ]c._set_(Bwhile True>P= fp.'V(81925_aif not :Ubreak (`Q .close()1str , .a 81?uct  =H Mn tire contentcs of the file.5""" return self.parse(StringIO(text), headersonly= ) class H#P?"r(!):cBdef WbJ, fpQCTrue+C9- XBstr("] >bRBytes:x__init__x*args, **kw2"""9 of binary RFC 2822 and MIME email messages.d Creates an in-memory object tree representing  Kq, which+O0can%n be manipulateded over to a Generator 5theMi6ualPationThe input mustaformats a block@!h ~ coutlines, opally preceded by a `Unix-from'G. T]is termin`eitherH0end oa`blank _ Y2he to instantiate for newQs wheyb>cd#isVhave a construcAhat &akzero arguments. Default is M.7sBr = (  HFals2"""% a@ure  data in;ZReads all.<+Xs#DrootMC. OiM4a flag specify1whe?uto stopN  after readW s !ot6e d,,I@mean;"ita retfp = TextIOWrapper(@enco='ascii', errors='surrogateescape')2tryrb\r3bWC0fin Gfp.detach(tYWb 2 ^ a S! sRd-1oucture% *- % Mn-he default i$s False, meaning it parses the entire contents of Ufile.5""" ptext = .decode('ASCII', errors='surrogateescape')>return self.r@str(S, headersonly) class BytesHP!r( !):_2def(^I, fpMS=True+H>  ib0 pE """This will behome for policy that hooks in@new adds allemail6 features.f import re sys from 0"._kSbase ,P}, Compat32, c _extend_docstringMTutilsGU_has_: (registry1R:as tmanagerBraw_data_2emessagE.M __all__ = ['"',$M tdefault"-cDSMTP%HT ] linesep_splitter = re.~ile(r'\n|\r') @\("):A"""+PROVISIONALThe API sions enabled b2is ( aeurrently provi0"al^Refer todocumentationdetails.vX3new0and fold lgorithms. Insteadpsimple h5ngs*stom objectvQth cuattributesQdepenlopqtype offield. - a fullyEs RFCs 2047 C5322qIn addi.@setts listed abov&at apply toj`ies, tSOQollow>p'alb@utf8ER-- ifu (K$) KQB serializ!s `@, us enpd words;N any non-H character&Usourc - J?e  L1notBain @(see!L 6532 for mo%re on this serialization format). refold_source -- if the value2 a header iUe Message objectK> came fromRparsing of some y,attributeP indicates whether or not a generator shouldN Cthatwhen trans#mback intoN `stream1m. The possiblKbs are:z (Anone3alls use original ?ing AlongKeGhave any line /isM  V er3`n max_A_length will b Hz/edu A#edS default is ''3_factory8-- a callatakes two arguments, 'name' an ' ',$re5&isJ`field MLPan un$edHo,J `returnstring-likt repres ET. A hXis providedNunderstandsozRFC5322otypes. (Currently address )s#T date J special t@ile oZr Aed as unstructured*is listBcompleted before extensis marked st".)pcontent_managern with at leastmethods: get_@* Vand s+A. WT(heB? orE A -ar ?ed,M !its|correspond\%M 1pas!itO: ite5rst/P /\pkeywordat were xA{ it as additional arguments. The default content_manager is. :data:`~email.<;P.raw_ L1`. L2""" message_factory = EHM,utf8 = Falserefold_source = 'long'gheaderNHRegistry()&< =  def __init__(self, **kw):FA# Ensure that each new instance gets a unique  E(as opposed to clones, which shaae9%).;Bif 'V' not in kwobject.__setattr A,, 56Esuper()..max_count6Gname6E"""+Pimpleation for this class returns the Z ibute fromO%specializedtJwould be uoonstruct a/Nof type ''x .[6%].(#`logic `he next three methods hosen such` itpossible to# switch a 7  between a Compat32 policy and a sderivedMN~+0have results stay consis+\is allows aK 0h`ed wit$is to3pasa libraryLonly handles0s, 7o receive8$an $anconvert itm"usnewer style by just changing it@. Ibalso c@becaNit postprelatively expensfull rfc5322Mparse until as latePwhen %@, sindin man2aapplicR!s :Sa fews will actually} in93tedh_|e_lines dpeveryth up1':'red unmodifif+PvalueQdetermined`strippT@leadwhitespace offfHrDnder`first `, join@all subsequens together,P}any trailBcarriagec@feedZ`racter7(Thdi1sam)a", = sourcelines[0].split(':', 1) value = .lstrip(' \t') + ''.join(sourcelines[1:]?return (name,ErE\r\n')) ldef header_store_parse(self, >!):/E"""+ 1The'B is u ed unchanged. If the input has a '^'I attribute and it matches>+ ignoring case,{OOtherwise4Ld=are passed to ufactoryNqmethod,aresultSustom8x object! aJuan this@ a VQError= aii;containsPCR or LF characters.* ifyg(,)..lower() ==Z a~if isinstancen2strk2len .sZ())>1bR# XXX%emessage isn't quite right when we use TP# (se<&sue 22233), but I'm not sure what should happen here.Kr1("HAQs mayR ifeed "G "or carri`"_._fetchTI S,to unmodifiedEY_with any;7sep removedK D   J8`. Any" rogateescaped bytes get mAintolunicode unknown-o glyph !3p# We ca" P beca"it)s on morQan \r &\n_% =sAsep_h2ter) Ofoldwr5Iqontroll} re_$ policy set4DRsider  be?$A' if!@only pit doesN1hav9L'P (havme' attribut e means it is a header 8object of some sort). If a source value needs to be refolded accordingPto the policy,vconverted into a custom by passiNhe name andXwith any linesep characters removed5the_factory method. Folis done byMcalling its O scurrent%. :SSs are spl uV%isN0not,&8^rejoinedVFpep from.Nkpreturne!The exceptionC@ containnon-asciiJbinary datan that caseqQi>ed regardlessk_setting, which causesTsCTE encoded\unknown-8bit?7set5"""5 p self._(,, _b=True)1def(A,<%):dE"""+ ss_if cte_typeS7bit,["ed 'WbytesIO , bASCII nAbackZ1 HUs@ ed/  Asinc8r`no way whetherAsistXYl!te2or multi 1@utf8Strue,d%0, o wi!o j0unip renderPsX wordOed =y.A0=='@%')=pset = 'B' ifYq else ''3l2ed.(H, 'surrogateescape'A ,g=False if hasattr(0, ''##.P(=qdmaxlen@@max_u_length  sys.maxsiz\=2s =y.(r1 = .== 'all' o1Plong'/ (lines and len(lines[0])+name)+2 > maxlen or @any(1&x),for x in Te1:])))?if refold or _binary and _has_surrogates(value):? return self.header_factory(, ''.joi0)).o(policy=6K7 + ': ' +Y(epI  default = EmailPc() # Make the #2 usUclass D del ` stricqX.clone(raise_on_defect=True) SMTP =K+='\r\n') HT%,_9_length=Non`pUTF8 = kCutf8V# Copyright (C) 2001-2006 Python Software Foundation # Author: Ben Gertzfield # Contact: email-sig@pyIN.org """Quoted-printable content transfer encoding per RFCs 2045-2047. This module handles G`methode@ined1RFCT2 tone US ASCII-like 8-bit data called `q'. It is2d to safelyQtext tha#in a character set similar to7r ,D, buLncludes som, 0at normally not allowp bodiesMs. is very space-ineffici@`files;  h.base64mime;znstead.Pprovian interface#oedecode both l with ding. Cs a "ia~W0infSBBan `qd-word'2. yis commonly  d hbPreal  s in To:/From:/Cc: etc. fXs, as wellPSubjecl@does" dW$` wrappo]Qd-of- conversion necess0proncalized`s; it  zEdumbly` To dvarious  pissues,+K KG.I __all__ = [a'body_r7e', ' 4$ng" ] _ aL(un] import re from string import a scii_letters, digits, hex  CRLF = '\r\n' NL n' EMPTYSTRING ' # Build a mapping of octets to the expansionBthat . Since we're only # goDto have 2565ese things,&s isn't terribly inefficient # space-wise. Remember {headers and bodiesjdifferent sof safe # charac*. Initialize bothas withFfull,dpthen ovdOZW byte<more compact form. _QUOPRI_MAP = ['=%02X' % c! c in range(256)]0cHEADER7E&[:$OBODY" # Safe ) hich need no encoding. forb'-!*+/' + a^.,1e('C') +o d: [c] = chr(c) # Hone other special;s become unVcoresXeord(' ')l!'_Obody(b' !"#$%&\'()*+,-./0123456789:;<>' b'?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`1abcdefghijklmnopqrstuvwxyz{|}~\t')E C Helpers def q_check(G"""Return True if" should be escapedL quopri."""rF>O) !=1] z3J8 _length(]array-aRsted-printable D!. 0Not"atdoes not include any RFC 2047added byA`j#)`Ya:paramQ: An Ss (a.k.a.1s).Q:S: Thek2o MwRit is K:quo5sq )sum(len( ) )<e  HBNM QUOPRI_BODY_MAP[octet]) for H in bytearray) def _max_append(L, s, maxlen, extra=''): if not isinstance(s, str)#s = chr(s)2L!#L.js.lstrip()+elif len(L[-1]) + Ss) <=E#2 +=A + snGelse%junquote(s"""Turn a ng'0the8m =AB to ASCII character with value 0xab"""0retNint(s[1:3], 16)sc0_QUOPRI_crd(c)]header_encode(!s,set='iso-8859-1A"""E3bingle <R lined-printable (like) lQing. pDefinedRFC 2045, this `Q'- is similar3 \Q, butOused specificallykd email`fieldsGTallowsmostly 7N1bits (and some 8 bit)Dr\n more or less readin non-RFCOq aware sclients set names{ `to use)2-6B. Iqdefault.H2# RJSemptyCs as an 7i_d!''b# Iterate over every,f necessaryaCed =d1.de'latin1').translate(`HEADER# Now addA%0chrrto eached chunk gfS# together`=?%s?q`=' % (3set edBODY_ENCODE9 = 0:] Bcrb'\r\n'Y *D3[c]"c)qDbody cinelen=76, eol=NLaGwrapping atIEK%ofStext will endNeol, which "\\n". Septo "\\r2youMPbe usresult of$function directly"in=ail1be aed at,8ost<@ bef1the^4eol($'76@RximumHpermitted by ). LongIqll haveQ'softb breaks {R "="  edrthem, st^%d be ident>3 original text.> The minimum maxlinelen is 4 to have room for a quoted character ("=XX")Lfollowed by a soft P break. Smaller values will generate aCVbError.2""" (ifA< 4:1fraise ;'("must be at least 4if not bodyKQeturnw# specials>! =0.translate(_QUOPRI_BODY_ENCODE_MAP)S_ = '=' + eolO#ve spaces1the$0at end of aY381 =#2- 1pencoded_![]80appM(= .8i`.split6s()3#1 up into pieces no longer thanstart = 0Dlast@len(Yw) - 1 -E/bwhile 15<= >Ucstop ='+H1I'# make sure we don'tan escape sequence=!if[la- 2] = gn[:491])S-!iop - 2!+elv1vr #Oelse0] + u# handle rest,Case ends in white7#2and0-1]+Z' \t'-=L"if J>= 3?# It's a-~rend-of-&we_ iOfthree-rMing.;2q =Y-M,?= 2rThere'sb$nd[~&+  N#Aonly]r _Rq!beLcontent on2sub/ +g q5]6# add back final newX qpresent!ifovin CRLFappend('') @ return eol.join(encoded_body) # BAW: I'm not sure if the intent was for `signat$o$is function to be #:same as base64MIME.deyP() ori... def ,`=NL): A"""D7 a quoted-printable string. * Lines are separated withP, which defaultsA\\n.91""" if @7+2see comm##in:() above. Again, we're building up!Hd concatena\could be done much moreNefficiently_B= '''Uline pd.split#s(w0 =  .r1p()h-*r +=y0continueUi = 0$nn0en(Ujwhile i < njc/eine[i]CUf c != '='1c6ii += 1# Otherwise, c == "="re we atQ end e/? If so, addOaa soft'b breakelif i+1j Z ## :Rn form =ABo2^A andP[i+1] hexdigits2c !unv[i:i+3]3 vi, pass literally9Oelse  G2A1eol6# Special cas;original3did\;#if6Qd[-1]$in '\r\n'uoP.endsG(eol# =FRd[:-1"0ForVvenienceabackwardspatibility w/ standard module 8_Wx &&ng! _q_match(@"""T!a veASCII character(value 0xab2s =H.group(0n  (s# Header9"isUa bit differKh.&(sea@RFC 2045  DB `Q'(ThHAdoes parse a fullCkOnd-printable `(like =?iso-8859-1?q?Hello_World?=) -- please use the high level email.header class for that functionality.>1"""s = s.replace('_', ' ')freturn re.sub(r'=[a-fA-F0-9]{2}', _unquote_match, s, flags=re.ASCII) # Copyright (C) 2001-2010 Python Software Founda # Author: Barry Warsaw Lqntact: p-sig@pyG.org """Miscellaneous utilities. __all__ = [ 'collapse_rfc2231_value',decode_params1!en+ formataddr(5date_5tim!ge8Eesse{make_msgidO mk44_tzXparseq] " 6o@] import os $re  drandomdsocketl,qurllib.b from.} wq# AddressList as _9 O %, R_tz, _tz # Intrapackages cht" C COMMASPACE =  EMPTYSTRING=' U@CRLF\r\n' TICK = "'" specialsre =compile(r'[][\\()<>@,:;".]') escape,0\\"! def _has_surrogates(s):6B"""R9True if s contains 0-ed binary data # This check is based onBfact`unless0re B^qs, utf82# (j's default ing) cane any string. i] fastestNcway to6fors, see issue 11454qimings.@2try'!s."e(pt3Falexcept UniaEgVErrorG4os0Howdeal with aing bytes before hand it9the # applica throughj0 'nl' interface.sanitize(D0# TD\{binto u 'unknown' Q. Ifm3:#`happen be -8+y will instead get pd, evenCtheyKwere invalid iY{ se\e source wa0ppo@to b5Jaseems  itnot a bad thing; aw2ectNtregistered. 8 original_bytes = string.encode('utf-8', 'surrogateescape') returnF;.de=`replac5 # Helpers def formataddr(pair, charset=|!):j"""The inverse of p'8), this takes a 2-tupl%1thebD(realname, email_>ess) and s 3 value suitableDfor an RFC 2822 From, To or Cc header. ,!IfMfirst elementir is false!en)esecond*!isFed unmodified`optional7XFacter set thatused to _ in case %0not ASCII safe. Can beqinstancfastr orO2a C-like object which ha#_ method. DefaulH. 1"""0 = 1 # MUST (per)scii, so raise a UniError if iz2n'tqJa@0if 6try ;eexcepth Dsd(@set,L$ =}1's d_$ =2.( 7!re"%s <%s>" % (K#, /7Jelse2quoa!''if specialsre.search @0D"E2 = Hub(r'\\\g<0>',L0'%s'd2$,  ;" !geesses(field>sB"""RHQa lis(REALNAME, EMAIL)f each A.0allOMMASPACE.join(str(v9v9sa = _AddressList(all._Q_timeL_and_zone( , L'%s, %02d %s %04d :1 %sfP['Mon`0Tue0Wed0Thu0Fri1SatUun'][U[6]],I2A['Ja_0FebC0Mar!Ap0MayFJun'IP 'Jul0Aug0Sep!Oc0Nov9Decg1] - 1yF0], 345@[Y2dat|val=None, local["=FIbusegmtwzD string as sp0ecified by RFC 2822, e.g.: Fri, 09 Nov 2001 01:08:47 -0000%Optional timeval if given is a floating point% value as acceptq gmE() and local, otherwise the curreNis used.?ag that when True, interprets@val,{`returndate relative to_6zone instead of UTC, properlyK0takdaylight savingto LountPargumusegmt means~s written out aswan ascii string, not numeric (so "GMT" "+r"). ThiIis needed for HTTP'YAonlyW==False.1"""# Note: we can0usef3p() becaPhonore eL require'aat day%month names b3English abbrevias!ifqs None:c=#.!()"if0 or6gmt:Pdt = ;!. 1fro`stamp(v B.utci7elsW?utcZC Dt.asur!= rDmat_C(dt,o) def!)"""Turn a& 5Tas sp in+#If|pdt mustAwareR with an offsetzero. Inthis case 'GMT' willJrendered*qnormal 4QM0RFC!. Kto supportG headers invol =0nowQtStupleiWif dt.tzinfow!sDH rarVsError("o%1UTCM"vBX" =M/elw1b'3!bdt.str93"%zs _f t_+P_and_:`(now, ") make_msgid(id*=0, domain R, suitable compliant Message-ID\[<142480216486.20800.16526388040877946887@n2shade.la.mastaler.com> # to strengthen t8he uniqueness of the message id. Optional domain if given provides3I0por+F` after( '@'. It defaults toqlocallyIdefined hostname.1"""timeval = int(.q()*100)#pid = os.getpid(randint = om rbits(64%if idstring is None:T+A= ''?els E.' +K,%ifD Y\= socketCfqdn1msgQ'<%d.%s@%s>' % val, pid,Eint,z,tqreturn Q def parsedate_to_MRdata)!r_tz = _3!z(*, A raise ValueError('Invalid z v or format "%s"2strh*dtuple, t.tzk. (QB[:6]b*,kttzinfo=S@zoneendelta(seconds=tz)))Paddr({P o its constituent real) and email-qparts. R!a ?9P, unlAc fails, inMwhich case rX%2-Z('', '')sCAddressList.qesslist`aif notsgk](?@s[0] # rfc822.unquote() doesn't properly de-backslash-ify in Python pre-2.3. C6strqRemove ]s from a 4.pif len(8F > 1 if+0.stwith('"')str.ends6str[1:-1].replace('\\\\oH\\')"""'C}<}#>'6g}|Astr xRFC2231-related func0s -h0amePencod`"de  Pe_rfcG#(s@"""D'e:9AccorCpto RFC /z = s.split(TICK, 2$f) <= 2d,8, s5@, ch"t=?languageE If neitherZT nor X,>0n sed as-ishf is given but not language, the string is encoded usempty &5for?.1"""s = urllib.parse.quote(s, safe='',``ing=ch"t or 'ascii')D4if is None andq:-return s/if*Q = ''/<A"%s'S" % (,J-, s) rfc2231_continuation = re.compile(r'^(?P\w+)\*(um>[0-9]c?)?$',~.ASCII) def de{_params()A"""D eters list accord`o RFC !. `,s2a sequence of 2-tuples 0ain>p ,jvalue)3newB = [bA[0]]qV# Map!'sPR to a!oft>s. The iss are aI36y numberB,*ca flagGpspecifywhether aticular segment$#%-Q = {}T&t0 inPrams[1:]L! =.endswith('*%BB= un) mo_vp.match(.Vif moA!,/ = mo.group('w', 'num0!if-ais not| P$num = int(num~ 3.setdefault, []).append(=,6ed)NJelse{xCame, '"%s"' % CK:if T[s 3s.items(Pexten?q= False2# Sort bye9ber f.sort(>And now CB allAnumerical ordconvertin C## Pings _cIf any #8d1a *nXTentir_[, aft#|concatena, must haveV) i'!at5Qbegin!ofsenum, s D2"if.ed ## Pas "lq-1", so!acin s directls?# represtpercentc octet # col(lapse_rfc2231_value treats this as an octet sequence.  s = urllib.parse.unquote(s, encoding="latin-1")Dextended = True$.append(sD2 = uEMPTYSTRING.join()34if r:l cht, language, D = decod6[ Anew_params(name, (['"%s"' %d)Nelsea Mvreturn 5 def col, errors='replace',Kfallback_='us-ascii')if not isinstancehtuple) or leR != 38^Vr# While; comes to u@ uni string, we need it&be a bytes# object. We doBwant$() normal utf-8 rU&agSaightOinterpretation of the%0ing^,Ractera\)se|btext =[3if 'w is Non"# Issue 17369: +/0, couldn't fz#q0, sYe 2,= $U1rawr" =(s, 'raw--escape'=try Dstr(I, 7except LookupEF#3a known ,c w) # # datetim'!es7ProvidQQlocalAfuncyCso p% one. Code # adapted from\patch in i9527. T1maybe perfect, butis # betOAthan(0havlRit. #@(dt=:, isdst=-1B"""R0,  Vaware/ If called without arguments, JqcurrentS. Otherwise *dt*F40 sh m;A, anis converA to?Gzone accorQystem "pdatabas!If" inaive (tha, dt.tzinfo>B"), assumedd beU"InZcase, a posit^ror zeroa for ** causes J!to0prem initially bsummer(H example, Daylight Saving Time) is ornot (respectively) in effect for the ified time. AE@nega5a value.*isdst* causes=Plocal8() function to attemptJ to divine whether summerp H1"""Pif dt8QNone:return date. Enow( zone.utc).as(;\p.tzinfocBgt=# We have a naive Convert% (8)tuple and pass to# system mkB tog@Awith hint. S-Rwill Meconds since epoch.tm = dt.e()[:-1] + (b,sA=.2(tmKH.Cime(7&6tryPdelta|:5=Gm.tm_gmtoffG,tz;(@', 97except AttributeError# Compute UTC offsetcompare y@impl9aby tm_+RA# If,s match, useo name F 6t -O (*20.gm4R)[:6]Cdst rdayligh!A > 05lP = -([A.alt|Pst el/p#='=b)}w E0.tz5G[dstJreplace(=tz) """ Standard "encodings" Package"tPython ( modules 4`storedycthis pAdirectory.PUCodec=BmustOPs cor onHnormalizedz/as defin|%e 0_below, e.g'utf-8' bemented #he *c_8.py'gEach cE@expohOllowing interface:* getregentry() ->J!s.IRobjec];The12APIo,a 9`er, de!r,<Aincr%al!, streamwriter#areaderJaes which adherew3$ IuJpIn addiW4, aq`may opally also define the following APIs which ar!n used by.package's codec search function: F'* getaliases() -> sequence of encoding name strings toiC as 9KAF*s return amust be normalizedeis[CdefiA,_(). Written Marc-Andre Lemburg (mal@l @.com2 (c) Copyright CNRI, All Rs Reserved. NO WARRANTY. """#" importNssys from .  _cache = {} _unknown = '-- R--' _6_tail = ['*'] _D$ =b. class CRegistryError(Lookup , System !):Ypass def{OX)T""" N5 an.%aSQ works: all non-alphanumeric=characters except0dot_d for Python ~sDPollap$and replaced with a single underscore, e.g. ' -;#'Fbecomes '_'. LeaQPtrailCP remo+ t*at-s shouldASCII onlyC1"""if isinstance(s, bytes2 =)"ascii")YsN]^p = False[6c i$c if c.isalnum() or c == '.'$(X'q $.append('_')}j( >c<{2Jelse(2Tru ''.join(d)!_!^1# Clientry = E.get6$, iN.eis notT2# ItSmodul#~# First Vpto find+>7= i#M }e u9M!ed-,no< Ddardscheme, i.e. fE in^<suat top-level.7/ = 14o Q\8` 8.P('.',V) 3Nonfmodnames = [aliased_encoding, Enorm#]#Qelse: 0modnames = [-Cfor #4 in s@dif notw or '.'+*ncontinue:try")# Import is absolute to prevent the possibly malicious i5Eof a\q# ule with side-effects thaf!inY'Ms' package.Omod = __o6__(2@.' +mN, fromlist=+Otaillevel=0)rcexcept_Error, may occur because (q)' doesZexist#?#itW@s a 3 @ (see mbcs and oemFpass {Qbreak  = None  (getregentry =t./:Attribute"=# Not a codecA&ul{ if"ECache misse _c[J]greturnQw askpmodule xPregis(tisinstance(6,0s.CVInfo)44 <= len2)7%Qaise CRV2('m"%s" (%s) failed1er'G % 0.__n0__,y.__file__)Ascallabl@[0]) 1\0[2]4 A12])\B3B3Br1> 4~/[4U4U5U5U75]) orincompatiblefEule ?9 <766 P += (f,)*(6-B:) +x.split(".", 1)[1],{K=S!(*)"# e 1ry '*"# ger its as (without o verwriting previously registered # aliases)Atry: Scodec = mod.get(1except AttributeErrorCApassPFelse2forxH in g##if&0not*_| &*["]Qname ~# Return thery entry r .%0search_functionGSPythoT $s.f(=) if sys.platform == 'win32'Bdef _mbcs(encoding) import _winapiPansi__page = "cp%s" %.s.GetACP34if y F+3 s. &g&T1reg|YI VL"#  s may fail while we are shutIdowncws) """ E|" A%@ SupjV@Thisule is used by4 P packy  F!to5mapi s Ds toV.nNote thata OnormalizesRabeforeq dolookup, so3@mappwill have5ap [2 [Contents:The followfQes diUary contain0s oal IANAGcharacter setOQwhichpre libr\rprovideGs. In addit se, a few Ispecific+also beeN@ed. ? #2= {# Please keep t@ list sorted alphabeticallyLtvalue !>WasciiP'646'1: '(!','x3.4_1968/$_$ # some emgaheadernon-standardx8 xRcp367 $s!< $=ibmI $so646_usp$_646.irv_1991+$3ir_ $ e# =us_HE# base64'_'base64_codec', 'base_64' :p64_code+,q# big5 '=_tw=4ig5` cs% " `#GX]hkscs]>:  (g"z2 g&z2`>,3', ?Xcp037;?037;(;ibm)9: '$ebcdic_cp_caQ$/nl$/us$/wt$  $9B83H10264 6\QcsibmY]%# J)12L1125_ )&kcp866uN &oruscii&)40/;1408$40d  (%^*25^/25^windows_1 hI1251?251^-%2^ 92-%^3^33^-^%^4^ rS4^-^%^ -259-%^ ?2566-^%^ S=125T97^-%^8x88^-^%^)273%27&(0ibm \$$)42T%42&5[ 'csibm424'  : 'cp424', 'ebcdic_cp_he'< $0ibm2$I# cp437 codecD'437R4[$37Pcspc84Cpage1[$ K$m8500?500Pcsibm$"b"$$chu$j l87754775R[F775baltic. $0ibm2D $)85F/85F850multilingual'E%0ibmw', 238526[2Ep)[$ K$ ~/85~] )[5"H C/85C  )g "$8}8}8C)85)$ "$6|6|*60 )$ "$1/61%61Kp_is&$e8M $ o$ 6c%86862latinhebrew$ KH3"3Y3" )[$ " H446)$ "$ 6[ ) $ "H666', 'csibm866&' : 'cp866', @'ibm $% # 3q9 codecH'869V;79[[cp_gr& $s M $"' $8932;932}7 ms [$YkanjiL$_%$4F)9474F.ms& $9uhcI$)50"/507$50=ms9&[$[euc_jis_2004bjisx0213g8: '/i`eucjisA-+n ,+ pqE(, Ep?p9q^pKujis$ % &J+krk`^$krjkorean_^%isc5601&%;_c_'%R_1987Q%?x10o+x_'Jigb18033: ''Ygb2313rchinese)Rrcsiso588b_N%cw5% $o2euc6_, o"#19%#<iso_ir_58Jwk79360~[kX.cp$X" F"wAhex_}?hex},hp_roman8? B5: ',r (QcsHPRfTPZcp105tP=ibm) Pz 'hzgb'  : 'hz', p'hz_gb' !V_2312&!C# iso2022_jp codec3'cs%jp:3: '4_jp'/ )_iR|(_1l/_1C'_1n- +p2p? E2p-+p;004s@2004 H, }_., y3v@jp_3qM v3-+p?extr3extt G- v(krr#krp ,'kr ')+R}8859_10klatin6-_j*A_199)eir_157z?{lvR )  Fthai@   1 .R x jlG) -R !}mA43iso4 8[)`celtic#Q x R4/99) lmJ{4 - ) 5B5A5l) - R 6:A666', 'iso_ir_226' : 'iso8859_16', F'l10"? )Katin- )S$# fq2 codecp'csisolE2q@2Piso_8'(Q_1987TPair_101#(lp% x + P33?3'(8TP9# Plp% ( , x 44?4'( (1xlpP , P 5cyrillic'5 (=5VP(/ P/4( 6@arab rasmo_70-g(DZ(wecma_11x&x(/ l (/2# /7/Qgreek?7/(olot_92(nx( N Wx/(W (W( W8W`hebrewX8W( ( -(3#x 95' : 'iso8859_9', 'iso_: (`_1989')(air_148#' (&l5 %/ (Katin, P# johab codecz'cp1361g1: '(/ms$ I# koi8_r\sr]0: 'T_r', 9Xz104890kz_98(,rk#k$"st&R_2002NHl>'_1#Note that the ( is implemented internally in C and aGlot fasterMnMrcharmapu# ir1 which uses'CsameFencoding. Th}s why we discourage<1 of>WClias it toinstead.-'9 Bcp81& Asiso:p1: '$_1L=ibmM&1 &_p'L17z&!00!&lj# G)L P &# mac_cyrillicvD'macl : /E[greekB?, ?@icelC-V2centraleuropeHB-^?*'%U):# )Z[romandintoshf,ch {turkishijAC8bcs<Fansi6|EDmbcsd _Xxptcp154[#cs`4: '1Wpt154"c&]&b_asian/ Lqquopri_'quopri'  : 'quopri_codec', ted_printable' + *+W# rot_13 l`'rot13_x : a_13', &# shift_jis<!cs6jisA1: ', & ( $P5 ( X_2004}0jisD12jisqs.Z :x02Iv2jisuD-.Zxtis_620?ctis620D3: '*8_)&D2529+& 1z&iso_ir_166" &hutf_16'u137s)=utf'5: '% ^9_bea nixbigunmarked'<7_bedA_16b ( glgolittlejlj^j(j)32&32b= '32 '% ^ /_tf_32"32/ ? ?<32_777 &$P_1_1_1$888 %[$ J$H_ucs$4r $ccp6500 u uW:+Nzlib?=zip@6: '-2 * )&temporary mac CJK aliases, will be replaced by propers in 3.1J 'x_mac_japanese' : 'sh ift_jis', 'x_mac_korean': 'euc_kr& simp_chinese' : 'gb2312&Jtrad&:big5', } """ Python 'ascii' Codec Written by Marc-Andre Lemburg (mal@le .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. import c|bs ### APIs class($.1): 5$# Note: Binding these as C functions will result in$ X3notFsconvertCm to methods. This ntended.4 en# =.E_!/de!IncrementalEPr#):W"f f (self, input, final=False*?oreturn(8E.errors)[0]DpBdef %> `Stream1er( ,i8cs.5pasFORead99C#2er(I, < ! !7 ings module cgetregentry( QInfo(lSname=nd!e=0.  i8.r=/J /F/srwriter=`m#r#F)\qbase64_%2 - 0 cot transfer\aing. 7B de/s from bytes& .5 K"""  sg='strict'rassert D == E3(QVc), len )},`}*Q}    y N)&ZZ#<errors) class IncrementalEncoder(Mcs.I): def e, (self, input, final=False*.passert *.errors == 'strict'Q'return base64._abytes(^) class Ded,F_StreamWriter(Codec, 8cs.charbuffertype = S10ReaLL 2###ings module API )getregentry(IxUInfo(bname='%',=_3i}9'r=/J //sw=V #rl#^#_is_text2ing! ) # # big5.py: Python UniG E for BIG5+&ten by Hye-Shik Chang # import _QTcs_twYPmultiB# as mbc =:A.get (''n " =d(mbc.M N"   4&pM !-6^Mp^! ^^,>ig5Q#()>h4=Q ? _hkscs_HKSCS2$hk c codec = _codecs_hk.get ('big5hkscs') class C'( !s. ): en0 = "c. dePIncrementalEBr(mbc.Multibyte ,Us h>cs.4 D 4 StreamReader(T), !,a(s.^OWrit^ ! ^^def getregentry(&dreturnUInfo(Wname=[N4=4#()C9iJI.r= /J //sr={ #wi#@#) """Python 'bz2_'R - bz2 compressionQing. ThisRB de/ps from $Cs to and is therefore usable with ,.transform() /'un. Adapted by Raymond HettingerzBzlib.py which was ten by Marc-Andre Lemburg (mal@l `.com). imports6# tAneed optional7module ! ###Q`APIs l4(input, errors='strict'cassertD == @(bz2Pc), len )tWt/NR v oself,  Z>)W?de(W9 iv__init__ ".A# =Pobj =S.BZ2CQor() 0|final=FalseZ1if WAc = t m->c +8flush() else7: return self.compressobj (input) 5def reset(0)J3obj = bz2.BZ2CTr() class IncrementalDecoder(>cs.ez__init__}, errors='strict')cassert!D == $"A# =) 'de%M/#de3, final=False6try8?G_6bj.0except EOFEQ/''d  StreamWriter(Codec, charbuffertypeDDytes10ReaLL ### encodings module API getregentry(InxUInfo(name="bz2",bbe=bz2_ @d i6'r=E/er/J /d/sw=MR#rc#U#_is_text2ing!) """ Generic Python Character Mapping E.mUse this directly rather than through the automaticlconversion mechanisms supplied by uni() and .X`(). 0ten& Marc-Andre Lemburg (mal@l 3 (c) Copyright CNRI, All R s Reserved. NO WARRANTY. #" import0s   "):*# Note: Binse as C functions willrPult i:"e 1not2"# 4tthem to methods. Tis intended.45# =.2mape## 2, mXH=Non9 #C.Q)-U$ =_ = 8,J[ {O)[0]:::1decs.IncrementalDecoder.__init__(self, errors) .mapping =  Qdef dG=input, final=False):*Mpreturn vcs.charmap_@:n!, q)[0] class StreamWriter(Codec,U&): s@,g='strict',jH=Non[ 4 P: en[: <.94,, )ORead))B[)3#,)94 )A### Pings module API getregentry(e UInfo(cname='%',f!e=2 pincremeE6r=IEGr/J //wN=A #rH## ) """ Python Character M56 cp037 generated from 'MAPPINGS/VENDORS/MICSFT/EBCDIC/CP037.TXT' with?4`c.py. v#" importX sDAPIs (=!s. WK_B king_table)o)B oo.+e h@:.,(@' 5pas9=994)( name='cp037', encode=Codec().)deincremental:6r=IE\r/J /Dl/streamreader=S R R#Ewrit#W #) ### [ing Table ~Ping_tA = (a'\x00'# 0x00 -> NULL11START OF HEADING+2+2+ETEXT(3(3(0ENDQ&(9c&4&dCONTROt " 5"HORIZONTAL TABULATIONx"862060 R8x7f"7"dDELETEC(97!8! C(8d"9"e"A"(0b"B"oVERTIC0)C.FORM FEEDrP+D$CARRIAGE RETUR%0E*SHIFT OU 'F$IG1V1VDATA LINK ESCAPT1b1bsDEVICE [6 ON-d1d -3TWO(x1i1i -5HRE\91r2x85IB1rs(08"dBACKSPACh8E1f F1FgDANCE8x19gfCdMEDIUM9/l81l `1`ILE SEPARATORm1@e_GROUP*e1eoRECORD+ lNUNIT)8r2r 8i2i "/2^ "S2S "42Fn 2FHLINE(x1$2HTRANSMISSION BLOCK72X j8W2W S(x8X2X a2R R8R2R f0i2KtENQUIRY02CACKNOWLEDGE '\Px07' # 0x2F -> BELL W'\x90 30fCONTRO"1"1"(16"2"SYNCHRONOUS IDLEo3+3+ o4"4"5"5" 6"0f7"END OF TRANSMISSION8r8. 9"9"a"A"b"B"1C"sDEVICE T FOUR1(D.NEGATIVE ACKNOWLEDGeDE ->VQ KSUBSTITUTG D1 p4QCSPAC 8\xaq4ONO-BREAK )"e2LIVLATIN SMALL LETTER A WITH CIRCUMFLEXe,4j?DIAERESIS> >EGRAVe/4:%AC:8\xe4:FTILDt4:RING ABO#4?CjdEDILLA)f<N< asENT SIGy.MFULL STOP<$LESS-THANM()LEFT PARENTH++ GPLUSO|$VERTICAL LIN&(5AMPERSAND8\xe?5FEF 55&:&t5&?&5&> &d5&I5&:fy+?c>*> dx(SHARP S (GERMAN) !u5,EXCLAMATION MARK+$' # 0x5B -> DOLLAR SIGN '*'p# 0x5C&ASTERISK#)#D#RIGHT PARENTHESIS,;,E,SEMICOLOsB\xac'sF$7NOT- 1 # 60#HYPHEN-MINUn/'1'TSOLID"B\xc2%I2"LATIN CAPITAL LETTER A WITH CIRCUMFLEXH\xc4A3A VDIAERH\xc0@4@ UGRAVE|1<5< FACUT<3<6< FTILD<5<7< RING ABO7A8ACvdEDILLAd9>N> (a6zA<BROKEN BARa,"^B%CCOMM% hPERCEN_'sLOW LINJ>#GREATER-THAN?,QUESTION MARB\xf8+7ESMALO STH\xc9;0; E= Qa<J<JbAJAJ J@ Jd|JIe<J<fAOA07N@`y7L 0 AC:'7# 2XNUMBEL@&8XERCIAL ATn0"'"p90APO#PH;=M;gEQUALS5"&5=OTA6d>86 8F88 s@/+ /B'/ /C// /D 'e' # 0x85 -> LATIN SMALL LETTER E 'f'/6/F/g/7/G/h/8/H/i/9/I/B\xab2A/EFT-POINTING DOUBLE ANGLE QUOTATION MARKDbDBDORIGHE(f0CEtTH (ICELANDIC)(fd=D=Y WITH ACUTH\xfe:E:_THORNy(b1?F?PLUS-MINUS SIGNb 90*gDEGREE&jM1  91&JUk/2/l/3/L^m/4/M/n/6o/6O^p/6P/q/6Q/r/6R/B\xaa26FEMININE ORDINAL I5ATO5b5'oMASCUL6 (e6kIGATURE A(b82 tCEDILLAcTCAPITAL LV(a4VCURRENCYG\xb5(AWMICRO%~"ACTILDs St/T/u/U/v/V/w/W/x/X/y/Y/z/Z/8\xaAINVERTED EXCLAM A4MQUES/d A~`dA# ?dAETTER THORN (ICELANDIC) '\xae' # 0xAF -> REGISTERED SIGN*^'" * B0*CIRCUMFLEX ACCENT,B\xa3/V B1,HPOUNQH\xa5%2%7YENtH\xb7#3#MIDDLE DOm9%4%COPYRIGHTNaN5)kSECTIOu6P6'yPILCROWN(bc'7'VULGAR FRAVONE QUARTER(bd686EHALF3/B93ETHREkS9[iA9`LEFT SE BRACKEG].B.C/B\xaf2C/SMACRO0H\xa8!D!DIAERESIH\xb4$E$[ACUTEOdMULTIPLICA{RCZCURLYA-LATIN CAPITAL LETTER AUB11B1C11C1D11D1E11E1F11G11GbH11H1I11I18\xaICSOFT HYPHEfaCWESMALvO WITH ef C? "f2#C>CGRAV8\xf@C:2UC+:CTILDt}7D78J.8JK18K1L18L1M18M1N18NO18ObP18P1Q18Q1R18ETTER R p'\xb9'  # 0xDA -> SUPERSCRIPT ONE X'\xfb*B*LATIN SMALL LETTER U WITH CIRCUMFLEX?c?C? DIAERESIS> D> FGRAVaxE: FACUT:f:F:Y \<! Y E0>REVERSE SOLIDU7,*1*DIVISION SIGNS% R2(eCAPITAYT131TbU141U1V151V1W161W1X171hY181YbZ191Z1B\xb24 34TWO*(d4*3 OD5(d6A5A )xd7@ 9(d3|9< ;(d5<;<CTILDw09F9DIGIT ZERZ1%4%I0I$#$3HRE&&BFOUR% %I%%#SI $$3EVE8&CEIGH5L&&NIbF 8\xdFdFA@  F< 9FCONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB! cp1006 generated from 'MAPPINGS/VENDORS/MISC/CP- .TXT' with gencodec.py. """#" import codecs ### C APIs class($.): def en(self,input,errors='strict'):,0creturno.charmap_B=,ing_table)o/deo-B ooIncrementalEr  h final=False*Y.S 4[0]D"e!@QStreamWriter(N,8cs.5pasORead9 9Js module getregentry(7 UInfo(name='cp1006',e!e=12().ig:'r=z/J //sqr8=E #w##") [Ping TE5cod2 = (`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDLE p'\x17' # 0x17 -> END OF TRANSMISSION BLOCK )48484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTE%b%B%VESCAP!c!C!FILE SEPARATORJd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &1 j 20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq0"'"H uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIX\3Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I1 1TTER I '3J' # 0x4A -> LATIN CAPITAL LETTER J )+'K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1Z1[1EFT SQUARE BRACKET$\\/o5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMAL<AVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /k/ /l/C /m//n//o/p/7^q/r/s/"t/u/# 0x75 -> L ATIN SMALL LETTER U 'v'# 0x76 -> L/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F UDELET!'80! 80!H\x81$1$2$2$3$3$4$4$5$5$6$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACAu06f+AEEXTENDED ARABIC-INDIC DIGIT ZERO;;\; O\::r: (TWt:: 8HRE<< GFOUR;; (IVv; ;IC-INDIC DIG+IT SIX '\u06f7' # 0xA8 -> EXTENDED ARABIC-INDIC DIG:GEVEN<8<9< WEIGHT<9<A< FNINE;&0c;B;f COMMA'&1b'C'SEMICOLO0xad)D+SOFT HYPH 1f(+E&xQUESTION MARKFfe81/F/LETTER ALEF WITH MADDA ABOVE ISOLATED FORML{/B0L;e/B1;\FINALs828&.B38?BEH91/B4:LNITI6b5659Ps&b5/B6:s6e93s79 TE_RBUTA5ByNB9Bw:'b6(t 9t'b6)t;u&e9B:H&e9B ;u0uOJEEM;u5b7aC!TC&b7C<w&ea7C/HAqaC:sCK:&eaC;uIC?DAL6b84 ARABIC LETTER JEH :6eb1:D:?SEEu6eb3;E;jNITIAL6eb5:F:Hv 7</D0<w9;1;/AD`6ebb:2:sd939Dsf:4:sc.D59/TA c.D6:Z:Z7:&ec/D8:=FINBc97IcWA9>MEDcB8/GH et<9&d0t;d@FLdE:dyE?QAFdE:sEKs{E:s5b92EGs6b94::s&edE?LAMY{E:seyE9wewE?MEEex;&b9ENOON GHUNNA(eB{eNOON INITIAL FOR ARABIC LETTER WAW WITH HAMZA ABOVE ISOLATED FORK%edK/F0K:6ba6:1:HEH GOAL ?8?2? jNITIAL6ba9>3>?MED=a=4=DOACHASHME:&80F5F|'e86<?YEH87K NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ&(9c&4&dCONTROt  5"HORIZONTAL TABULATIONx"86260 R8x7f"7"dDELETEC(97!8! C(8d"9"e"A"(0b"B"oVERTIC0)C.FORM FEEDrP+D$CARRIAGE RETUR%0E*SHIFT OU 'F$IG1V1VDATA LINK ESCAPT1b1bsDEVICE [6 ON-d1d -3TWO(x1i1i -5HRE\91r2x85IB1rs(08"dBACKSPACh8E1f F1FgDANCE8x19gfCdMEDIUM9/l81l `1`ILE SEPARATORm1@e_GROUP*e1eoRECORD+ lNUNIT)8r2r 8i2i "/2^ "S2S "42Fn 2FHLINE(x1$2HTRANSMISSION BLOCK72X j8W2W S(x8X2X a2R R8R2RfL '\x05' # 0x2D -> ENQUIRY `'\x06'  "E"ACKNOWLEDGE&7&F -> BELL'90 30fCONTRO"1"1"1 32"SYNCHRONOUS IDL(93M3+ o4"4"5"5" 6"0f7"END OF TRANSMISSION%8r8. 9"9"a"A"b"B"1C"sDEVICE T FOUR1(BNEGATIVE )(9eOVQ KSUBSTITUT D" 4QCSPAC 8\xaq4ONO-BREAK )"e2L4VLATIN SMALL LETTER A WITH CIRCUMFLEXe,4j?DIAERESIS> >EGRAVe/4:%AC:8\xe4:FTILDt4:RING ABO{gLEFT CURLY BRACKETflN c4:eCAPITAC<rCEDILLAx.FULL STOP$<$ LESS-THAN SIG()vPARENTH ++GPLUSO!$EXCLAMATION MARK&+5AMPERSAND$8\xeM5#) E' C54:454?4&54> 4d54I54:fy9?c>8> dxEMALL LETTER >SHARP S (GERMAN) '\u011e' # 0x5A -> LATIN CAPITAL LETTER G WITH BREVE <&30<B<I<DOT ABOV@*;J|C@ASTERISK)#D#RIGHT PARENTHESIS,;,E,SEMICOLON$^$F$CIRCUMFLEX ACCENT,-, 60,HYPHEN-MINUw/'1'TSOLID"B\xc2%d 62"dA(H\xc4A3A VDIAER1\xc/64@ 4GRAH\xc1|5< CACUTH\xc3<6< FTILD<5<7< HRING^[>!68AEFT SQUARE BRACKE9\xd9.NPu015foDESMALBS:rCEDILLA,76DCCOMM % $0PERC SIG_'(sLOW LINQ>#GREATER-THANO?,'QUESTION MARB\xf8+7# OSSTROKH\xc9;7; yE= Xa<Q<QbAQAQ Q@ Qd|Q6 7Q<AVAcU'@Au013e-c -DOTLESS I":p7^B\xd6#WBI V@b@1"'"y0APO#PH=%{gEQUALSu9\xd\uU (xd80 -> LATIN CAPITAL LETTER O WITH STROKE 'a'# 0x81 -> LATIN SMAL;A/b/2/B/c/3/C/d/4/D/e/5/f/6/F^g/7/G/h/8/H/i/9/I/3\xa{A/EFT-POINTING DOUBLE ANGLE QUOTATION MARKDbDBDORIGHE}CE CURLY BRACKETs`.D.GRAVE ACCEN'B\xa6*E'BRN BARLH\xb1%F%PLUS-MINUS SIGN*0* 90*gDEGREE&j#1 u9JUk/ml/L^m/M/n/o/O^p/P/q/Q/r/a FEMININE ORDINAL INDICATO5b5oMASCUL6 e9 IGATURE ASB\xb8cCEDILL19\xcTTACAPIV(a4VCURRENCYG\xb5(AYMICRO%fADIAERESISs`%A/t/u/Uv/V/w/W/x/X/y/Y/z/Z/8\xaAINVERTED EXCLAM# 0xAB -> IN VERTED QUESTION MARK ']'# 0xAC -> RIGHT SQUARE BRACKET/$/D/DOLLAR SIGN&@&E&COMMERCIAL ANB\xae+}F(REGISTEREDRG\xa2* B0*JCENT$3$1$KPOUNI5%2%9YENH(b7#3#MIDDLE DO9%4%CCOPY< 9\xaN5)1SEC3H\xb6P6'zPILCROWc'7'VULGAR FRAV@ONE 2TERH\xbd686EHALF3/B93ETHREkS9aA9(NO|1  BB#ICAL LINEKf+(SMACROhH\xa8!uIAERESI(b4$ACUTE ACBldMULTIPLICAe.CLATIN SMALL LETTER C WITH CEDILLAjAC<PCAPIT>1B11BbC11C1D11D1E11F11G11GH11H1I11I18\xaFCSOFT HYPHEfpCW OIRCUMFLEXe~CTILDI8\xf C_FGRAV:C :#8\xf4C:Au011D(G 4BREJD&JK1&L1&LbM1&M1N1&<O1&ObP1&APITAL LETTER P 'Q'# 0xD8 -> LATIN CAPITAL LETTER Q1R191R1B\xb94bA1SUPERSCRIPT ONE*(fb*B*ESMALU WITH CIRCUMFLEX?\=" iC?REVERSE SOLIDUS*)xfD*iFGRAVafdE: FACUT:f:F:YDIAERESIc>/E0>>7>1>DIVISION SIGNS% B E2( T131TbU141U1V151V1W161W1X171hY13YbZ13Z1B\xb24fE34TWO*(d4*3 OX 5#>5gNUMBER9\xd1g 3"d3e3< 5(d5<5<CTILDq09F3DIGIT ZER@1%%II$ $3HRE&&3FOU0%%I6%#SII$3EVE8J&CEIGH/L&&NIbF 8\xdF "`QUOTATEMARK#j F< 9FCONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB for CP1125 """#" import codecs ### C APIs class($.): def en(self,input,errors='strict'):,0creturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.5pasORead9 9Fs module getregentry(7 UInfo(name='cp1125',e!e=12().ie:.r=^/J //sqr8=E #w##)Zping MapB0codTmap =make_identity_dict(range(256)) 5.update({F0x0080: 0x0410, # CYRILLIC CAPITAL LETTER A51515&BE62626V63636'GH74747D65656I66666Z7777m8686I{9595gSHORT ;a;a;K"b6b6&ELc6c6M6d6d6N6e6e6O5f5f5P9d0420, #  CYRILLIC CAPITAL LETTER ER 0x0091:@421,? # 6S62626&TE63636U54545&EF65656&HA66666'TS7777'CH78787S9797C9a9a9HARD SIGNb=b=7YERc8c8KSOFTud=d=We5e5Yf6f61"a06.306ESMALr3q3q 3Bao3o 4V4m3m 4Gam3m 5Dik3k 4I4i3i 4Zg3g 5id3d 4Ia`3` 3gSHORT 9`3` 9KW3W 4&ELS3S 4M4J3J 4aI3I 4OgF3F 3PbD6259LIGHT SHAgb86259lMEDIUM(,6259LDARK&6250NBOX DRAWINGS vVERTICA{b 6252 7 AND LEFT b,6256 @qu SINGLEAg DOUBL4@=256WINGS VERTICAL DOUBLE AND LEFT SINGLE 0x00b7: 0x2556, # BOX DRAWINGS DOWND8D5Dx9D/63DVERTICALHAaA/51A8b878 E=c=d= /UPd;c;/UPweBbBu fB/10BRLIGHT #c0<4< RI6"c1;3;HORIZONTAL@2@2; B3B1B m 4A0: z593zF6F/5e}TKfI IZIaI@5<z/69zM6{C6N B |6R|G 6#UP;A Rd/68 H Qd%6/WN/6 &75k d95 gCCC/52b DOWN SINGLE AND RIGHT DOUBLE 0x00d6: 0x2553, # BOX DRAWINGS DOWN4EHSINGE7E/6bEVERTICALIHORIZONTAL N8NaN 8N 9N/18NL!UPGFLEFTa:/0c: !_=b=8wFULL BLOCK&c&4cLOWER HALF,d,+e+%90WWf,8,?UPP e0,6044, CYRILLIC SMALL LETTER ER#e1414S42424 T#e34hUg43~3&EF4545 &HA4dO04464 'TSTO04475 'CH5;6044vS"O0449j 8SHC76044lHARD SIGN60440;7YER-60446KSOFTq<O044d KDO044e3 YLO044f4 fT0 @CAPI!V%IOBfV56 4V@ jGHE WITH UPTURfe9w As0s UKRAINIAN If5@ >0 ~BYELORUSSIAN-M5L J0 &YI56 LETTER YI 0x00fa:@b7, # MIDDLE DOT &b&E221a&SQUARE RO'c'5116'NUMERO SIGNNd'E00a4'CURRENCY)e)E25a0)bBLACK }Qf('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'" #(00 -> NULL!1!1!START OF HEADING-2-2-2TEXlx3*3*0ENDU (4(4(RANSMISSIOvX5050UQUIRY6$6$ACKNOWLEDGE(7(w7 -> BE8!8!2ACKY2'\t$ c9&HORIZONTAL TABULATn2a2LINE FEEDb(b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETURme.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /4TWOX11 /6HRE` 1 1EFOURa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE )191YeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAMC MAR"-LQUOT+#+fNUMBERm-'$(HOLLA(%(wPERCENTQ&)AMPERSAN0"'" *2APOSTROPH(MLEFT PARENTHESISf)-RIGHT PARENTHESIS '*'# 0x002a -> ASTERISK%+%b%PLUS SIGN&,&c&RCOMMA"-"d"HYPHEN-MINU.)e)FULL STOPO/&f&TSOLIDJ0$ 30$DIGIT ZEROK1'1'2ONE&2&2&#TWL3&3&3HREN4(4(BFOURu5'5'#IVN6'6'2SIXM7&7&3EVE8(8(REIGHTP9(9($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sQUESTION MAR4@*4yERCIAL ADA*|LATIN CAPITAL LETTER IB33BC33C3D33D3E33F33FfG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33O33-P35'3Q30QR30wS30T30U30UV30V3W3 # 0x0057 -> LATIN CAPITAL LETTER W 'X'# 0x0058 3X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKET0$\\1c0REVERSE SOLIDUS,]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)1)ESMALAZb121B1c131C1d141D1e151f161Fbg171G1h1 WH1i1 1I1j1 1J1k1 1K1l1L1m11M1n11N1o1O1p17bP1q1Q1r1R1s1Pt1"u1Uv1V1w1 x1y1z1{1ZCURLY|/`VERTIC|}*RZ~0CTILD3\x7R7TDELET#Pu0410J#8CYRILLIC\6166Bm '\u0412' (# 0x0082 -> CYRILLIC CAPITAL LETTER VE '\u0413' 737 (GH84848 D75757 I76767 Z7878 o8787 IK9696 hSHORT <a<a< 'KAsb7b7 'EL7c7c7 M7d7d7 N7e7e7 O6f6f6 P'207/907 &ERn(21717 S727u Tu9u Ums9s 'EF7s9s H[2s9s (TSs9s C2t9t Sv9v C:t9t HARD SIG2{9{ 8YER}9} LSOFTw9 9 Y9 Y;3aESMALA3a 4Bl3a 53}a} 5 3}a} 63{a{ 53yay 5'\u0437' #& 0x00a7 -> CYRILLIC SMALL LETTER ZE '\u0438' #585I49494hSHORT :a:a:'KAob5b5'EL5c5c5M5d5d5N5e5e5O4f4f4PG25915 b05LIGHT SHAD(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS uVERTICAH2524_48 AND LEFT&92565Asu SINGLEBg DOUBL66I9IY(56c CDOWN~E5EsEzE6 E #^5^B {(579 wdb>%UPzb </UP}Mb C{ (10 C1c=R3<<HORIZONT@cAC1C   0?c|3|y G5c ]5cJc54' # 0x00c29 -> BOX DRAWINGS DOUBLE DOWN AND RIGHT '\u2569' # 0x00ca ?!UP=HORIZONTALB6BbD0DcDVERTICAL 5CdC~c~e; ~H7HfHUP SINGLEBS8I/d0II_I4I1I55K2K5t-d3K#UP95#4DDD25D F3F6F{(6bF7F}J aO8O%Oe*1neLU %7LEFa0]da;kdy8y]FULL BLOCK' @LOWER HALF- *,9Vd-8-?UPP8044-e CYRILLIC SMALL LETTER ERG0441e5S5e5'TE5e5U4e4'EF5Xe5'HA5tet5(TSed6(CH6eK6Se26C8e/8HARD SIGN '\u044b'( # 0x00eb -> CYRILLIC SMALL LETTER YERU '\u044c'7c7SOFT SIGN<d<d<E4e4e4Yf5f5Aj'015)f05eCAPITA&IO75717 H5(90l25 lGHE WITH UPTURN9y3D yB(044B UKRAINIAN I5A5A ?(066? BYELORUSSIAN-N M7M K(078K 'YI 797 5!xb3 fa5MIDDLE DOT\H221aSQUARE RO()11hNUMERO!xawxURRENCY*Iu25abBLACK x'SuNO-BREAK SPACE ) ### Encoding Map e_map = {Q100:000,~FNULL 1 1 START OF HEADING,2,2,2TEXiu3)3)0ENDS '4'4'RANSMISSIOV5/5/VQUIRY6#6#ACKNOWLEDGsJ7'7'(BE8 8 2ACKGE9%9%pHORIZONyTABULATa1a1LINE FEEDb%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE REe+e+SHIFT OUf%f%I1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 ."TWZ11 .7HRE^1 0FOUR 0x0015: 0x0015,  # NEGATIVE ACKNOWLEDGE ("6:060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCKa8585fCANCEL"9"9"WfMEDIUM)a)a)SUBSTITUTb&b&WESCAP"c"c"FILE SEPARATORrd*d*_GROUP+e+e+oRECORD,f,f,OUNIT*"20*%20*FSPAC#21!1!EXCLAMAT6MAR#22,2,OQUOT*3*3*NUMBER SIGN#24'4'\DOLLA'5'{PERCENTO2AMPERSANDt2APOSTROPHv2vLEFT PARENTHESISR2ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZEROI3p3p&&ON~3i3i%'TWJd3d%7HRELd3d6FOU3c3cM7FIVLa3a&6SIXa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F047: 0x0047,  # LATIN CAPITAL LETTER G 0x0048: , 2H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R23232 S24242 T25252 U26262 V27272 W2 /582 X2 5  Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5uOW LINE66\GRAVEL66ESMALAX6 0B06 0C06 0D06 06 0F`6 0 66 066 066 066 066 06606606677`77ATIN SMALL LETTER Q 0x0072:, # LATIN SMALL L0R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKENc.c.VERTICAL LINEWd)d)ORIGHXe/e/GTILDPf!f!VDELET""a0"f"NO-BREAK SPAC*CfCURRENCY SIGNbfLMIDDLE DO3401y0CYRILLIC CAPIT$IO\$406UKRAINIAN I#40f@BYELORUSSIAN-ML%YI61q8A5-/81-B1U/826V6[8['GH78#41h8hm18Z8umZ{88kgSHORT ;8?;K"86&ELX86M68 E#418l185P2d9dET#42e9eEZ#42e9e TE 0x0423: 0x0093, # CYRILLIC CAPITAL LETTER U !c0x0424545&EF65656&HA666666TSE77777'CH78787S9797C9a9a9HARD SIGNb=b=7YERc8c8KSOFTud=d=We5e5Yf6f61"306.a06ESMAL31313 B#32424 V4mam G3mam 5Dikak 4I4iai 4Zgag 5idad 4I3`a` 3gSHORT 9`a` 9KWaW 4&ELSaS 4M4JaJ 43IaI 4OgFaF 3P4DeD %ERh4EeE &ES4EeE TEeE I4CeC 4CeC 4CeC 4CeC 4DeD 4Fe9, # CYRILLIC SMALL LETTER SHCHA 0x044a:@0ea,_ # C7HARD SIGN;b;b; FYERU6c6c6 KSOFTqd;d; Ene3e3 Yf4f4 G"514/f14 %IO#54454 UKRAINIAN I#56>7> BYELORUSSIAN-K7J9J %YI4#90424eCAPITApGHE WITH UPTUR?933C A4211JhNUMERO63221fSQUARE ROOT3250%c4BOX DRAWINGS LIGHT HORIZONTAL92 b9hVERTIC7dy7DOWN AND Rt1b= 6LEF1w/c0 /UPw8d*w; uc%{2b fA 2o3cB@@ F5c FoDOUBLEbq:l5d4aSINGLEw NE3:6uE4EVE@L4"55/b8r? sbu ~#WN4DTob D=UP SINGLE AND RIGHT DOUBLE 0x2559: 0x00d3, # BOX DRAWINGS UP2R AND CHSINGCaC/c8CrJCb</be<2UP n>LEFcBdB~BRdBcB?%UP;e;/c6;VERTICALDUIfI7I 8I #60I I"61B/b5 zWH2H 8HXH3H9? A4A/d1A(WNHORIZONTALJ5J2JYJ 6J/cbJQ DOWNJ7CfC ;A 8H/d0HJ/caHEGHdHL  ZdRfc G8dUPPER HALF BLOCK,?LOW,OLFULLRd+)}9&,1ALkFSHADj9{MEDIUM (eKDARK&afcs.xe, h final=False*@:.,][0] D"N!@StreamWriter(Codec,TDpassORead9 9D### 4s module API getregentry(7 2UInfo(Sname='cp1140',e!e=12().ig:.r=`/J //sqr8=E #w##@) K[Ping TE5cod2 = (`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ&(9c&4&dCONTROt  5"HORIZONTAL TABULATIONx"86260 R8x7f"7"dDELETEC(97!8! C(8d"9"e"A"(0b"B"oVERTIC0)C.FORM FEEDrP+D$CARRIAGE RETUR%0E*SHIFT OU 'F$IG1V1VDATA LINK ESCAPT1b1bsDEVICE [6 ON-d1d -3TWO(x1i1i -5HRE\91r2x85IB1rs(08"dBACKSPACh8E1f F1FgDANCE8x19gfCdMEDIUM9/l81l `1`ILE SEPARATOR '\Px1d'  # 0x1D -> GROUP SEPARATOR X'\x1e*E*oRECORD+f+F+NUNIT)'80) 20)tCONTROLv(81"1"2"2"3"3"4"4"n ! ( 25"LINE FEED"17&$6$ END OF TRANSMISSION BLOCK4b474TSCAPE!(88!8! #9"9"a"A" B"cDC"(05"KtENQUIRY(06"CACKNOWLEDG0G>5BEL94349434134SYNCHRONOUS IDL9=3=9=3=(x93= 9; "0f)]j963696369636963616sDEVICE F FOUc (BNEGATIVE )93OV1KSUBSTITUT  4QCSPAC 8\xaq4ONO-BREAK )e4VLATIN SMALL LETTER A WITH CIRCUMFLEXe,4j?DIAERESIS> >EGRAVe/4:%AC:8\xe4:FTILDt4:RING ABO#4?CjdEDILLA)f<N< aENT SIGN^.MFULL STOP$<$LESS-THANM()LEFT PARENTH++ GPLUSO|$ # 0x4F -> VERTICAL LINE '&'# 0x50 -> AMPERSAND$B\xe9'$1$LATIN SMALL LETTER E WITH ACUT^H\xea:2: CIRCUMFLEXyb?3? DIAERESIS>8>4> FGRAVd:5:Ie:6: f?7? c>8> dx9:SHARP S (GERMAN)i!u2 A>EXCLAMATION MARK+$+B+DOLLAR SIGN&*&C&sASTERISI)#D#RIGHT PARENTH ;,E,SEMICOLOs9\xa<F$7NOT-G6+HYPHEN-MINUw/'.TSOLID"B\xc2%06PCAPITRAa'(c4AA )(c0@@ +(c1<< (c3<<ETILD(c5<<RING ABO(c7A ACvbEDILLA9\xd" >N> (a6z BROKEN BARa,"E6CCOMM% hPERCEN_'7LOW>#GREATER-THAN?,KQUES8\xfl7#O ST8\xc^70; Z`c`7J<Jb7JAJ J@ Jf7Jhch7JI WITH CIRCUMFLEX '\xcf' " # 0x77 -> LATIN CAPITAL LETTER I WITH DIAERESIS@c@8@ RGRAVE<`9# |9< r ACCENT':'A'RCOLON # B NUMBER SIG&@&C&COMMERCIAL An1"'"D(APOSTROPH=ME%gEQUALSs"&F&QUOTATION MARKB\xd8, 80)OKa:&81=ESMALAlb/2/B/^3/C/d^4/D/e/5/6/F^g^ G/h/ /H/i/ /I/3\xa{ LEFT-POINTING DOUBLE ANGLE (bDORIGHE"f0 ETH (ICELANDIC)f==YCACUT3\xf:3:_THORNy(b1LPLUS-MINUv8\xb9MgDEGREEjMK96Jk/6l/6L^m/6M/n/6o/6O^p/6P/q/6Q/r/6R/3\xa696FEMININE ORDINAL I5ATO5b5'oMASCUL6 "e6kIGATURE Ab9 cCEDILLm9\xcT^ VAu20awGEUROG\xb5A9MIC%~"xA1 -> TILDE 's'# 0xA2 -> LATIN SMALL LETTER S/t/3/T/u/4/U/v/5/V/w/6/W/x/7/X/y/8/Y/z/9/Z/B\xa12xA/ INVERTED EXCLAMATION MARK4(bf4B4MQUES1(d01C1eCAPITAETH (ICELANDIC)p(dd?D?Y WITH ACUTE<e<E<_THORN}aAFAREGISTERED SIGNk^h1 K B0*CIRCUMFLEX ACCENB\xa3/,1,HPOUNQH\xa5%7YENtH\xb7#MIDDLE DOm9%COPYRIGHTNaN1SECH\xb6PyPILCROWN(bc'VULGAR FRAVONE QUARTERF8\xbB6EHALF3B 3ETHREkF[`LEFT SE BRACKEG].C/8\xa&BSMACRO0B\xa8SDIAERESIH\xb4$ OdMULTIPLIC{RCZCURLYA-AB11B1C11C1D11D1E116F11G11GH11H1I11I18\xaICSOFT HYPHEfaCW xOZef C?S '\xf2' # 0xCD -> LATIN SMALL LETTER O WITH GRAVE /`'\xf3'  :E: FACUT:5:F: CTILD:}7" t D0:RIGHT CURLY BRACKETJ.1.eCAPITAJ1K121K1L131L1M141M1N151N1O161O1P171P1Q181Q1R191R1B\xb94[ DA1SUPERSCRIPT ONH\xfb*B* UCIRCUMFLEXi(fc?C? DIAERESIS> <} <ax<: <f:<Y \<@E@EVERSE SOLIDU7,E<DIVISION SIGoS%E3YT13U13UV13V1W13W1X13hY13YbZ13Z1B\xb24 3#TWH\xd4*3 5(d6A5A )xd7@ 9duE9< ;dwE;<y0F9DIGIT ZERZ1%4%I0I$#$3HRE&&3FOUJ% % FIVE '6#' # 0xF6 -> DIGIT SIX +'7$7$BEVEN&8&8&REIGHT&9&9&BNINE%B\xb3(A%SUPERSCRIPT THRE,(db,B,LATIN CAPITAL LETTER U WITH CIRCUMFLEH\xdcACA DIAERESISdD@ FGRAVa|E< EACUT<(9f<F<CONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1250 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import svAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ing)CoBo*B ooIncremental$er h final=False*Y.S 4[0]Dd(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z/J //sqr8=E #w##") [T ~2 = (W'\x00= 00=ANULL011START OF HEADING+2+2+3TEX8\x0 03(0ENDQ &4N4&RANSMISSIOsH\x05.5.UQUIRY6"ACKNOWLEDGE '\x07' # 0x07 -> BELL 88ACKSPACE$t"" C9$HORIZONTAL TABULATION0n0A0LINE FEED$2x0b&TB$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR2x0e,|E*SHIFT OUTf$F$IG'10# 10#DATA LINK ESCAPB8x11+1+EVICE CONTROL ON-2-2-4TWO(13-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+1 END OF TRANSMISSION BLOCK1UCANCE(19UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt0"'"2uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF[3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3F4COLz;' # 0x3B -> SEMICOLON '<'p# 0x3C$LESS-THAN SIG)=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK@( 40(COMMERCIAL AT(A(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1CL1LbM1bM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'LSMALb/ /c/ /d/ /e/ /f/ /g' # 0x67 -> LATIN SMALL LETTER G 'h'# 0x68/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f# 7TDELET!Pu20ac#!8EURO SIGf\ufffe$UNDEFINEDf\u201a$ SINGLE LOW-9 QUOTATION MAR ZZ~ODOUBZ F2026HORIZONTAL ELLIPSI&20.SDAGGEc!1! ( +3mPER MILLEx7016)@CAPIS WITH CAROF2039EFT-POINTING A70156ACUXF0164<TF017d<<Z<< 9 %189 L]I620196RK '\u20(1c' # 0x93 -> LEFT DOUBLE QUOTATION MARK '\u201d545ORIGH6&22656gBULLETW3!6!wEN DASH"4"7"M"Ffffe"8"UNDEFINEDF19$QTRADET SIGN*F0161NA*LATIN SMALL LETTER S WITH CARO:F203a:B:qSINGLE *-POINTING AhF015bECEWACUTE5:D:T7017AE:Z:F: 0xa0 A0:NO-BREAK SPAC02c7+ A1) vF02d8 2 FBREV@&14AeCAPITALTSTROK=!xa{CURRENCY50* eAeTOGONE[0xa6eBSN BAR!xa%1SEC!xa ' DIAERESISK9p ACOPY 5A   eEDILLAggp!xaD8NOT!xa#SOFT HYPHE!xa&REGISTEREDPAu017 uDOT ABOp(xbBhDEGREEf!xbBPLUS-MINUS*Fu02dB ?Fu014dB bd ACCEN!xbX'XMICRO(xbBzPILCROW'BMIDDLE DOqBC]Au010Bq oPu015f; ;b 7Au013 b <G  j# 0xBE -> LATIN+ SMALL LETTER L WITH CARON '\u017c' # 0xBF -> LATIN:Z:DOT ABOVE>%54>&C0>eCAPITAzR@DACUT<0xc1:z/C1<A<2<2< CIRCUMFLEX0C/C3A 5BRE!xc4< DIAERESIS| 39|5@5Vu0106<6<C57:7< vCEDILLA0)/C8>e!xcz9<EPu0118.A< cOGONEK0xcb;yB=  1aB}C@ Z0xcd:|D<I8xce<E< C D}r0<D<TSTROKVu0143=Ny 4y<!xdvnDOx(xdD<n52AxDOUBLE !xdC U!xd:@MULTIPLICATION SIG5UDjFu016[DUjIRING5!xdSA'j<jC jDY 6wDT< 0xdfZ SHARP S 0'\u0155' # 0xE0 -> LATIN SMALL LETTER R WITH ACUTE '\xe18:1:A:2:2: CIRCUMFLEXyPu0103A3? FBREV484: DIAERESISx 3a@x5>L7:6:C:!xe87: vCEDILLA&0dv8< CARON:0xe98v9:EAu011<$A: eOGONEKubuB; 1@yC> C%D:I8xeeE: fAF?Dyf1:F:TSTROKAu014uFNu:8u:!xfbFOt!xf::b5(?jDOUBLE f6A 1(xfFDIVISION SIGo5FZFu016CFUZRING ABOf? 7Z:ZcZA ZFY 6T: Q'2d3DOTS) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB9 cp1251 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP1251.TXT' with gencodec.py. """#" import s ### C% APIs class($.): def W(self,input,errors='strict'):,0creturno.charmap_B=,ing_table)o deo)B ooIncrementalE>r  h final=False*Y.S 4[0]D"eN!@QStreamWriter(N,8cs.5pasORead9 9Js module getregentry(7 UInfo(name='cp1251',e!e=12().ig:'r=z/J //sqr8=E #w##") [Ping TE5cod2 = (`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k116 -> SYNCHRONOUS IDLE '\x17'  # 0x17 -> END OF TRANSMISSION BLOCK48484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATORod)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" j 20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq1"'"r uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIXQ3Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I1LATIN CAPITAL LETTER I 'J' # 0x4A -> LATIN CAPITAL1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1Z1[1EFT SQUARE BRACKET$\\/o5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMAL<AVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /j/ /k/ /l/C /m//n//o/p/7^q/r/s/"t/T 'u'  # 0x75 -> LATIN SMALL LETTER U 'v'/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F TDELET!Pu0402#! 80!CYRILLIC CAPIT(DJ63616 G6F201a626 SINGLE LOW-9 QUOTATION MARKW\u045l36  jej44ODOUBj F20266pHORIZONELLIPSISF2020.gDAGGER!1! (&ac(EURO SIGNL3mPER MILLE)F0409M. L36EFT-POINTING A0zNz70406K6b68TSH7(DZ75$9$ "E20189"LWC62019!6 C9!kmkd"k6 2 "DBULLV\u2019vEN DASH&14y)EM"6fff9UNDEFINEDF1QTRADE: 5T   9$5E  y 5  4 5 9  4 5 9 5TTER DZHE '\xa0'  # 0xA0 -> NO-BREAK SPACE p'\u040e+)1)CYRILLIC CAPITAL LETTER SHORT U:5:2:OSMAL8&08r38 rJ0xa43" 45URRENCY SIGN9(5(GHE WITH UPTURB8xa6j6BBROKEN BARg8xa7%7%{SECTION 01)8']%IO\9395OPYRIGHT^^A)UKRAINIAN ISbhB?LEFT-POINTING DOUBLE ANGLE QUOTAEMARKcDCD)NO8xad#D#SOFT HYPHEvKE&REGISTERED}F*T$YIb_BhDEGREE[!xb& PLUS-MINUS*6'B BYELORUSSIAN-Gu045K  GI9# I'b5B;XMICRO!xb#zPILCROW'' MIDDLE DOT  Au211JNUMESB YbB{B S(3 S$DZi686 i 4j B 4@Au041B3C@g A1CN4B 12iY V535 C (GH6&C0 6D5pC%j>C55ZCD6E '\u041&8' # 0xC8 -> CYRILLIC CAPITAL LETTER I '\u0419494 YSHORT:a:A: 'KAob5B5 'EL5c5C5 M5d5D5 N5e5E5 O4f4F4 &PE5%205/D05 'ER51515 S52525 T3535 Ui4444 'EF55555 HE&26565 (TS7676 (CH6TDT SVDV C8TDT HARD SIG2[D[ 8YER]D] LSOFTsdDd cDc YdDd Y'3dEdESMAL 2aEa 2B 3_E_ 3V3]E] 3G3]E] 4Dg[E[ 3I3YEY 3ZWEW 4gTET 33PEP 2 3PEP 83GEG 33CEC 33:E: 339E9IC SMALL LET#TER O '\u043f' # 0xEF -> CYRILLIC SMALL LET2&PE3%403/F03'ER31313S32323T3333Ue4242'EF35353'HA36363(TS7474(CH48484S9494 C6a6A6HARD SIGN b:B:8YERc5C5LSOFTod:D:Ee2E2YDFD YA ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1252 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import svAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ing)CoBo*B ooIncremental$er h final=False*Y.S 4[0]Dd(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z, incrementaldecoder=IncrD3, streamrea)S R #rwriter=#W #) ### [ing Table ~Ping_tA = (ua'\x00'~# 0x00 -> NULL11START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt"" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&TB$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$F -> SOLIDUS '0'# 0x30 -> DIGIT ZERO%1%1%2ONE$2$2$#TWH3$3$3HREJ4&4&BFOURo5%5%#IVJ6%6%2SIXI7$7$BEVEN&8&8&REIGHT&9&9&$NI):%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK @(4YCOMMERCIAL A4A(\LATIN CAPITAL LETTER AYB1i1B1C1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151PQ1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *R SQUARE BRACKET '^' # 0x5E -> CIRCUMFLEX ACCEN,_,F,LOW LINEO`# 60#YGRAVEJa'1'LATIN SMALL LETTER AVb/2/B/c/3/C/d/4/D/e/5/f/6/F^g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/cN/o/O/p/7^P/q/Q/r/R/s/S/t/u/U^v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKi|-VERTICALB}(ORIGHV~.CTILD~3\x77TDELET!Au20a1!8EURO SIGQ\ufff$UNDEFINEQ\u201$ SINGLE LOW-9 QUOTATION MAR`\u01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI(&20.SDAGGEx!1! (702cwMODIFIERtd3PER MILLE7016)CAPITAL LETTER S WIT)H CARON '\u2039' # 0x8B -> SINGLE LEFT-POINTING AQUOTATION MARKDF0152DCD LATIN CAPITAL LIGATURE OE4Ffffe4D4UNDEFINED$F017d$E$ XETTER Z WIT `F< ` $/90$E2018 91$%6201U 925_RIGHT6ck36kDOUBLE k$ 945k6 2 956dBULLET{F20136!wEN DASH"4"7"M"702d8"SMALL TILD (219&QTRADEbE SIGF0161rA*VL S F203a:, 99V7017v<YDIAERESIS0xa0ANO-BREAK SPAC!xav)INVERTED EXCLAM!xa_40CEN!xaO$XPOUND!xae%CURRENCY(5:YEN#6#BROKEN BAR7%1SEC!xa{a$ACOPYs ) FEMININE ORDINAL INDICATOb.!xay+NO^#SOFT HYPHE!xa&REGISTEREf6MAC(xbBiDEGREE3bBPLUS-MINUS*BSUPERSCRIPT TWObB *5HREbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DO(xbBCEDILLA '\x@b9'  # 0xB9 -> SUPERSCRIPT ONE X'\xba*A* MASCULINE ORDINAL INDICATOR6b6B6RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKEcECEVULGAR FRAC/ ON=FARTE{d6D6EHALFie3E3ETHREkS9f9F9INVERTED QUES'c01 C01LATIN CAPITAL LETTER A WITH GRAV(c1<1< FACUT<2<2< CIRCUMFLEX(c3A3A FTILD}4<4< DIAERESIf(c5@5@ R_7ABO:6A6A7272CuCEDILLA-8>8>E> C"< C< CA C@IC< C< CA dD4ETH%dDN, RdDO< adD< hdD<hdDA D<DpMULTIPL}ESIGNDnUSTROK?dDUD< DTAL LETTER U WITH CIRCUMFLEX '\xdc'  # 0xDC -> LATIN CAPITAL LETTER UADIAERESIS@d@D@Y@UACUTE<e<E<UTHORN5f5F5ESMALeSHARP 'e05/E05AEGRAV(e1:1: (e2:2: (e3?3? FTILD4:4: (e5>5> RING ABO06?6?7070CtCEDILLA (e8<8<E< 9:9: a:A: b?B? E IE: E:E fF4ETHfFN" 6fFO: MfF: \fF:\fF? F:FDIVISION SIGfFfUSTROKfF F: F:F?TFFfFMALL LETTER THORN '\xff' 8 # 0xFF -> LATIN SMALL LETTER Y WITH DIAERESIS ) ### Encoding table e _t =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1253 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import svAPIs class ($. 1): CPdef ee(self,input,errors='strict'):,icreturnoB=,4ing)CoBo*B ooIncremental$er h final=False*Y.S 4[0]Dd(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z/J //sqr8=E #w##") [TE2 = (W'\x00Y 00YANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIO(05.5.UQUIRYv6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt"  09$HORIZONTAL TABUn0A0LINE FEEDb& 0B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUz"0e,|E*SHIFT OU0$I1h1hDATA LINK ESCAPE '\x11'  # 0x11 -> DEVICE CONTROL ONE '\x12' -2-5TWO-3-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATOFd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" N 20)CSPAC! EXCLAMAT3MAR"+LQUOT)#)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq1"'"V uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZER1%`%3Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:MFCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D14 -> LATIN CAPITAL LETTER D 'E'# 0x45 -> LATIN CAPI1E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/d5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'ESMALbA,b/ /B/c/ /C/d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/  /l/8 /m//n//o/ALL LETTER O 'p'# 0x70 -> LATIN SMALL LETTER P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#F TDELET!Pu20ac#!8EURO SIGNf\ufffe$UNDEFINED$F201a$ SINGLE LOW-9 QUOTATION MARK6F01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI(f\u2020.SDAGGEx!1! ( @@3mPER MILLEM9EFT-POINTING A  h $$ $ $ 9 $E20189L6201-9q6 89kkdk6 2%9DBULL[&13WtEN DASHhF2014")EM" 91QTRADE929 999 '\ufffe' # 0x9F -> UNDEFINED '\xa0"$ A0$NO-BREAK SPACE)Pu0385+M A1)GREEK DIALYTIKA TONOS06020 CAPITAL LETTER ALPHA WITH@0xa3>3@POUND SIGNe8xa4%4%CURRENCY(M5(:YEN##6#BROKEN BARp7p7%kSECTIOL8'8'DIAERESI 8xa9$9$COPYRIGHTPufffe+yA)b"B$LEFT-POINTING DOUBLE ANGLE QUOTAEMARKcDCD)NO8xad#D#SOFT HYPHEE&REGISTEREAu201pHORIZON!xbB DE*7xb1BPLUS-MINUS*2*SUPERSCRIPT TWObB *8HRE#BKbBZMICROBzPILCROW'BMIDDLE DOT ~EPSILONBBBT>ao>>/IO?(xbB%O(xbBVULGAR FRAONE HALFye uUy fB!BOOMEG{9:C8@ESMALy9ANDAu039_K]K F9j5h5GBETA4t4r4HGAMM5{C{ 9DELjjj77Z44 3C*TH59' # 0xC9 -%> GREEK CAPITAL LETTER IOTA '\u039a' # 0xCA -4HKAPP5b5B5HLAMD5c5C5'MUd2D2N2e2E2'XIdf2F2vOMICRON7%a07/D07Pi&a12124RHOe6fff D23UNDEFINED$F03a3W3$GSIGM&a4545'TAZ&a5353YUPSIL(6767(PH)7373C38383(PSf9393HOMEG8-D-a WITH DIALYTIKC;D;HFLDLESMALRALPHABWTONOS4XDX >E@f @T|pDp <A bvEv =;\ AND NE NE:%b26En 3(BE`bE 28GAMbE 39DELfE 3E 5ZE 2 1E 1*TH3E 3!E 2 bE 3 bsEsbeEebUEUbIEI SMALL LETTE*R OMICRON '\u03c0' # 0xF0 -> GREEK SMALL LETTER PI010107RHO12121FINAL SIGMA93939 343437TAUd5151YUPSIL36565(PH47171C18181(PSb9191HOMEG_a3A3IOTA WITH DIALYTIKAbABA<DcDCDDWTONOSd@D@ @e@E@8~7fff>F>UNDEFINED ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1254 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import svAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ing)CoBo*B ooIncremental$er h final=False*Y.S 4[0]Dd(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z/decoder=IncrementalDecoder, streamreader=S R #Ewrit#W #) ### [ing Table dkPing_tA = (ua'\x00'~# 0x00 -> NULL11START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt"" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&TB$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0' # 0x30 -> DIGIT ZERO '1'v# 0x31%2ONE$2$2$#TWH3$3$3HREJ4&4&BFOURo5%5%#IVJ6%6%2SIXI7$7$BEVEN&8&8&REIGHT&9&9&$NI):%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK @(4YCOMMERCIAL A4A(\LATIN CAPITAL LETTER AYB1i1B1C1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151PQ1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY'^' # 0x5E -> CIRCUMFLEX ACCENT '_'#,F,LOW LINE#`# 60#YGRAVEJa'1'LATIN SMALL LETTER AVb/2/B/c/3/C/d/4/D/e/5/f/6/F^g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/cN/o/O/p/7^P/q/Q/r/R/s/S/t/u/U^v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICALB}(ORIGHV~.CTILD~3\x77TDELET!Au20a1!8EURO SIGQ\ufff$UNDEFINEQ\u201$ SINGLE LOW-9 QUOTATION MAR`\u01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI(&20.SDAGGEx!1! (702cwMODIFIERtd3PER MILLE7016)@CAPIUSMCARON '\u2039' # 0x8B -> SINGLE LEFT-POINTING A QUOTATION MARK '\u0152DCD LATIN CAPITAL LIGATURE OE4Ffffe4D4UNDEFINED$E$F$/90$E2018 91$ F2019525_RIGHT6c636kDOUBLE kd545k6 2 956dBULLETcF2013W6!wEN DASH"4"7"M"702d8"SMALL TILD(219&QTRADEJT SIGNrF0161rA*OVLETTER S WITH CARO:F203a:, 997017HYDIAERESIS90xa0ANO-BREAK SPAC!xa`)INVERTED EXCLAM!xaI40CEN!xa9$XPOUND!xaO%CURRENCY(5:YEN#6#BROKEN BAR7%1SECv!xa{a$ACOPY] ) FEMININE ORDINAL INDICATOb!xay+NOH#SOFT HYPHEK!xa&REGISTEREf6MAC(xbBiDEGREE3bBPLUS-MINUS*BSUPERSCRIPT TWObB *5HREbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DO(xbBuCEDILLAB&ON0xBA -> MASCULINE ORDINAL INDICATOR '\xbb' ' # 0xBB -> RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKEcECEVULGAR FRAC/ ON=FARTE{d6D6EHALFie3E3ETHREkS9f9F9INVERTED QUES'c01 C01LATIN CAPITAL LETTER A WITH GRAVEm(c1<1< FACUT<2<2< CIRCUMFLEX}3A3A FTILD}4<4< DIAERESIf(c5@5@ R_7ABO:6A6A7272CuCEDILLA-8>8>E> 9<9< a<A< CC@IC< C< CA Au011DG6BREdDN< [dDO< jdD< qdD<qdDA D< (xdDpMULTIPLDSIGNdDnUSTROKHdDUD< D<DATIN CAPITAL2 LETTER U WITH DIAERESIS '\u0130' # 0xDD -> LATIN CAPITAL @I@OT ABOVE@&5e@E@S@sCEDILLA>0xdf<~F>ESMAL|dSHARP !xe5/E05Aq5GRA7xe1o/E1: DACUT8xe2:2: CIRCUMFLEX(e3?3? FTILDy4:4: 8xe5>5> IRING8xe6?6?7070C (e8<8<E< 9:9: a:A: b?B? c>C>x d: 6: ;:Ey Au011@kFG6BREfFN: ?fFO: efF: efF:efF? F: (xfFDIVISION SIGNfFfUSTROK fF F: F:F? T^DOTLESS IcGu015*Sff' # 0xFF0 -> LATIN SMALL LETTER Y WITH DIAERESIS ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1255 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import svAPIs class ($. ): def ee(self,input,errors='strict'):,0creturnoB=,4ing)CoBo*B ooIncremental$er h final=False*Y.S 4[0]Dd(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z/J //sqr8=E #w##") [T ~2 = (`'\x00'. # 0x00YANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABUn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ONE '\x12'  # 0x12 -> DEVICE CONTROL TWO-3-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATOFd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" N 20)CSPAC! 1 EXCLAMAT3MAR"+LQUOT)#)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq1"'"V uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZER1%`%O3Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI):MFCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11 'E' # 0x45 -> LATIN CAPITAL LETTER E 'F'161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/35 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'ESMAL1A,b/ /B/c/ /C/d/ /D/e/ /f/ /g/ /h/ /i/ /j/ /k/  /l/8 /m//n//o/p/# 0x70 -> L ATIN SMALL LETTER P 'q'# 0x71 -> L/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#yF TDELET!Pu20ac#! 80!EURO SIGNf\ufffe$UNDEFINED$F201a$ SINGLE LOW-9 QUOTATION MARK6F01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI(f\u2020.SDAGGEx!1! (702cwMODIFIER*CIRCUMFLEX ACCEN7d3PER MILLE&39EFT-POINTING A  h $$ $ $ 9 $E20189L6201-96 P9kkdk6 2=9DBULLs<&13WtEN DASHF2014")EM"702dSg8u21QTRADE9L9 999 '\ufffe'  # 0x9F -> UNDEFINED '\xa0' $ A0$NO-BREAK SPACE)1)1) INVERTED EXCLAMATION MARK42424CENT SIGN$3$3$XPOUND%Pu20aa' A4%NEW SHEQEL*0xa5( A5*:YEN#6#6#BROKEN BAR7%7%1SEC 8'8'DIAERESISK9$9$COPYRIGH dtA)MULTIPLIC] {bWB.LEFT-POINTING DOUBLE ANGLE QUOTD cDCD*NO(ad#D#SOFT HYPHEe&E&REGISTERE8xaf*UMACROKbBiDEGREEbBPLUS-MINUS*BSUPERSCRIPT TWObB *5HRE'b4BACUTE ACSBZMICROBzPILCROW'BMIDDLE DOTqBuCEDILLA"B%ONfqPDIVISbBbBVULGAR FRAy ONEARTEbB6EHALFe 3T1 QUkbBAQUES^2u05CqHEBREW V-- -HATAF SEGOL333WPATAH333Qg4 4GIRIQa- -DTSERaZ- - - -  - - . .THOLAM1fffB- V$ QXQUBUTa. .DAGESH OR MAPk77OINT METEG $ '\u05be' # 0xCE -> HEBREW PUNCTUATION MAQAF 3f3F3OINT RAFE,%c0,(D0,_WPASEQ31313_SHIN DOT02020 /3/3/SOF PASUf47 LIGATURE YIDDISH DOUBLE VAVf5= wVAV YOD:6: w =7=gGERESHq484dSHAYIM76fffG D97UNDEFINE $A$B$C$D$  $605dELETTER ALE=d E-'BEdE,TGIMEL605dE.9DAL\EH%d5E+ &d6, ,WZAYIN7.H8,,T,9,, %&da, ,xFINAL K&db2 2 ,c, ,6LAM"F05dd. .%MEx605dxE 2 ,E ,^'NUeF ,FWSAMEKheF (eFPeF +F\VTSADIeF .F'QOeF eF+a' # 0xFA -(> HEBREW LETTER TAV '\ufffe' # 0xFB -> UNDEFINED$C$7200HD$LEFT-TO-RIGHT MARKQF200fuE-%.6 - F-) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1256 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import svAPIs class ($. 1): VAdef e(self,input,errors='strict'):,creturnoB=,4ing)CoBo*B ooIncremental$er h final=False*Y.S 4[0]Dd(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z/J //sqr8=E #w##") [T ~2 = (P'\x00j  00?ANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt"Q9$HORIZONTAL TABULATn0A0uLINE FEb2x0b&0oVERTICR8x0c.HFORMRr' # 0x0D -> CARRIAGE RETURN '\x0e' # 0x0E*SHIFT OUT$f$F$IG'10# 10#DATA LINK ESCAPEN(11+1+EVICE CONTROL ON-2-2-5TWOZ3-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B% c!C!FILE SEPARATOFd)_GROUP*1oRECORD+1LUNIT) {" 2CSPAC! EXCLAMAT3MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSAND1"'" uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDFP3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AA(1 -> LATIN CAPITAL LETTER A 'B'# 0x42 -> LATIN C1B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R1R1S1S1T1T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'LSMALb/ /c/ /d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/ /l/C -> LATIN SMALL LETTER L 'm'# 0x6D -> LATIN SMALL/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f#57TDELET!Pu20ac#!8EURO SIGf\u067e$dARABICu2PEHf\u201a, SINGLE LOW-9 QUOTATION MARK6F01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI0&20.SDAGGE!1! (702cw`MODIFICIRCUMFLEX ACCEN?d3PER MILLE9 (TT3-EFT-POINTING A5@CAPIPLIGATURE Ov7068  &CHF0698 .J,8, ,3DDASa 9 -4GAF6201Y9L06201`96 9kUkd%9 k6 29 DBULLx&13WhEN DAS4")EM"706a g"KE '\u2122'  # 0x99 -> TRADE MARK SIGN '\u0691' *A*ARABIC LETTER RREH-F203a-B-SINGLE RIGHT-POINTING AQUOTATIONwEF0153ECELATIN SMALL LIGATURE OE2F200c2D2ZERO WIDTH NON-JOINER0d0E0 ,706bF, NOON GHUNNA`0xa0^4 A04NO-BREAK SPAC'06 A1)]FCOMMP2P2'HCENT!xa4t3$ZPOUND%4I4%CURRENCY(5(5(:YEN#6#6#BROKEN BAi8xa7%7%1SECd8xa8'8'DIAERESIST9$ACOPYXPu06be+AHEH DOACHASHME0xab6A7LEFoDOUBLE !xaD+NOz#SOFT HYPHEv!xa&REGISTEREfUMACROKbBhDEGREE6!xbqBPLUS-MINUS*BSUPERSCRIPT TWObB *&HR~bBACUTE ACSBZMICROBzPILCROW'BMIDDLE DOTqBeCEDILLbB$ONbAu061dBwSEMICOL)BbBVULGAR FRAONE QUART(xbB6EHALF%eB 3TkAQUES(hAu06c/C/FGOAL121 14AMZAu062_ .ALEF WITH MADDA ABOV2>>Hv >> g2WAW{=={MZA BELOW . '\u0626' # 0xC6 -> ARABIC LETTER YEH WITH HAMZA ABOVE =7=7=GALEF-8-8-7BEH,9,9,TEH MARBUTA4a4A4,b,B,Hc-C-GJEEMZd-D-(HAe,E,K-f-F-6DAL%30,.D0,)TH-1-1-R &32,2,GZAIN3-3-8SEE-4-4-H.5.5.'ADDD,!xdDMULTIPLICATION SIG0<DT3DZ,D eD)GH.4gTATWEEB4F4'QA4K,!xeELATIN SMALLA8GRA4ME$LA!xeffCIRCUMFLEX^4EM4E7NOO^4^E 4^E3WAW!xeVCWdCEDILLd!xef<<E<!xe::DACUTe!xe:: !xe?!?DIAERESIS-Au064E1t MAKSUR&55=Y=!xe=IR?P?DIAERESIS '\u064b' # 0xF0 -> ARABIC FATHATAN '*c*1*KDAMM*d*2*KKASR*e*3*~{0xf4%4'LATIN SMALL LETTER O WITH CIRCUMFLEX?fA5?'&50'6''0xf7%7'DIVISION SIG0 51*v8(veSHADDAP9&P9(USGRAVE:Pu0652<bA:b4UKU!xfaB'a >!xf?C? DIAERESIS7200D>EFT-TO-RIGHT MARK-E-%.:LEF-706dF-YEH BARREE ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1257 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import svAPIs class ($. 1): eAdef e(self,input,errors='strict'):,creturnoB=,4ing)CoBo*B ooIncremental$er h final=False*Y.S 4[0]Dd(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z/J //sqr8=E #w##") [T decoding_table = ( '\x00'  # 0x00 -> NULL11START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDFP3[DIGIT ZER%`%$Y$$TDIGIT THREE s '4' # 0x34 -> DIGIT FOUR +'5%5%2IVE%6%6%2SIX$7$7$BEVEN&8&8&REIGHT&9&9&3NIN:%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK @( 40(COMMERCIAL A4A(1(LATIN CAPITAL LETTER AYB121B1C131C1D1D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa' 0x61 -> LA TIN SMALL LETTER A 'b'# 0x62 -> LA/B/c/3/C/d/4/D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/R/s/S/t/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x7:7TDELET!Au20a1!8EURO SIGQ\ufff$UNDEFINE`\u201a$ SINGLE LOW-9 QUOTATION MAR ZZ~ODOUBZ F2026HORIZONTAL ELLIPSI&20.SDAGGEc!1! ( +3mPER MILLExM9xEFT-POINTING A h0xa8f" gDIAEREF@02c7&$DCAROH)xbDCEDILLA '\ufffe' # 0x90 -> UNDEFINED '\u2018$1$ LEFT SINGLE QUOTATION MARK59525ORIGH6c636kODOUBk d545k6 &22656gBULLET3!6!wEN DASH"4"7"M" _8"_19$QTRADEOT SIGNp NA*N603aB$-POINTING A iCE i0xafg:D$UMACRO@02db#[E!UOGONE# fF!f0CfANO-BREAK SPACEAMM0CENd!xa$XPOUND!xa%rCURRENCY( ^Ad6gBROKEN BAR8xa7%j1SECu!!xdoLATIN CAPITAL LETTER O WITH STid=ACOPY7 1015AfRfuCEDILLAgg!xa%D+NO#SOFT HYPHE!xa&REGISTEREc*A(xbBhDEGREEM7xb1BPLUS-MINUS*BSUPERSCRIPT TWOcbB *6HREBACUTE ACS5ZMICRO$BzPILCROW'BMIDDLE DO~(xfBOSMAL bB$ONAu015B ebB+bBVULGAR FRA ONcEARTEbB6EHALFe 0xBE -> VULGAR FRACTION THREE QUARTERS '\xe6'  # 0xBF -> LATIN SMALL LETTER AE0Pu010420&C00fCAPITA2 WITH OGONEK=&2e=1=I=&00=2=A=fMACRONz03=C=DACUT!xc #/C4<yDIAERESIc c5@5@ RING ABOVPu0118C6AE t&12=7= 7c=8=7&CAs0xc9:9<sAu017>A<Z <1B<xK> 2a6E>! &3b= L{6_DS>Uu0143zDN< 4 D< o!xdxeDOzD< m!xdy=DTILD!xd"<< Q d7m@MULTIPLICA7SIG7DU# > 41mTTSTROKFu015DS 6< != aJDC&7d6@ 7 df: dSHARP c# 0xE0 -> LAT,IN SMALL LETTER A WITH OGONEK '\u012f' # 0xE1 -> LAT;I;&01;2;vfMACRONv&07;3;CvSACUTE:0xe484:uDIAERESIS>5>5> RING ABOV}Pu0119A-6?E h&13;7; -d;8;-&CAg!xe-9:gVu017atA:Z :1B:tGxsCEDILLAGu013zD<K<&2bE< &3c;F;Lw6C/F0<S<Au014 FN: %46F: c!xfQFOvF: a(xfF;DTILD!xf: -fN>DIVISION SIG7U &42<TSTROKFu015F; 6: ; QU@)U&7e,>Au02d x^) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1258 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import codecs ### Codec APIs class (c!s.): def en(self,input,errors='strict'):,0preturn 1cs.charmap_B=,ing_table)o de>o)B ooIncrementalEr  h final=False*Y.S 4[0]D"eN!@QStreamWriter(N,8cs.5pasORead9 92###ings module getregentry(7 UInfo(name='cp1258',!e=12().ig:'r=z/J //sqr8=E #w##@) K[Ping TE5cod2 = (`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL# 0x17 -> END OF TRANSMISSION BLOCK '\x18'  # 0x18 -> CANCEL!9!9!EUeMEDIUM(a(A(SUBSTITUTE%b%B%VESCAP!c!C!FILE SEPARATORJd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" 6 20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq1"'"> 7$POSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIX7$Q$3EVEw3R&E-L&M&$NI):qFCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J1 0x4A -> LA TIN CAPITAL LETTER J 'K'# 0x4B -> LA1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1EFT SQUARE BRACKET$\\/>5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMAL<AVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /k/ /l/ /m//n//o/p/7^q/r/s/"t/u/ LETTER U S 'v' # 0x76 -> LATIN SMALL LETTER V '+'w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F TDELET!Pu20ac#! 80!EURO SIGNf\ufffe$1$UNDEFINED$F201a$2$ SINGLE LOW-9 QUOTATION MARK6F0192636-F WITH HOO9720149ODOUBo F2026o56HORIZONTAL ELLIPSISF2020.gDAGGER!1! (702cwMODIFIERCIRCUMFLEX ACCEN7W\u203PER MILLE&39EFT-POINTING A5@CAPIGLIGATURE Oe A $$ $ 9 $E20189L 6201=96 `9k)kdk6 29DBULLL&13WvEN DASH&14")EM"702dSw8u21QTRADE9\9 997017n 2YfDIAERE!xa! ANO-BREAK SPACg!xa) INeED EXCLAM!xa34!xa9$QPOUND% '\xa4'  # 0xA4 -> CURRENCY SIGN `'\xa5' (5(:YEN#6#6#BROKEN BARH7%7%kSECTIOL8'8'DIAERESISK9$9$COPYRIGHTa)A) FEMININE ORDINAL INDICATOb5B5LEFT-POINTING DOUBLE ANGLE QUOTAEMARKcDCD+NOd#D#SOFT HYPHE~e&E&REGISTEREDf*F*UMACROK'b0! B0!iDEGREEG(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWO(b3*3*EHREE,4,ACUTE ACCENT'BZMICROBzPILCROW'BMIDDLE DOqBuCEDILLAB&ONBoMASCUL bBbBVULGAR FRA ONEARTEbB6EHALFe 3T1 QUkbBINVERTED QUESlcCLATIN CAPITAL LETTER A WITH GRAVcC< cC< CIRCUMFLEXAAu010CCA 7BRE'C'< Cc@C@@ R7ABO\C\AlgCg2C ^cC>E> C< C< (xcCA Au030&@COMBG cCqL LETTER I WITH ACUTE '\xce'  # 0xCE -> LATIN CAPITAL LETTER I W<CIRCUMFLEXAfAFA DIAERESIS@Pu0110B/D0@DUSTROK d1; /D1=N=DTILD<Pu0309>y2<COMBINING HOOK ABOV/0xd3-k3/)Ok e(d4<4< eGu01a%5A CHORN`8xd6|6; 8xd7@7@MULTIPLICATION SIGn8.8.& c9=Uc7GRAayA< b<B< 8xdcACA dFD@ ;!xdc^ESMALdSHARP !xew5E 5AeE: 'e2NED: Fu010E?6BREDeE: 8xe5>Re `eE ?eE&CtCEDILLAeE lE< geE: E: (xeE? &&E&u ACCENT"d oA:QE:E?&11FTIN SMALL LETTER D WITH STROKE '\xf1' # 0xF1 -> LATIN SMALL LE;N;DTILD:Pu0323<:2:COMBINING DOT BELOWh, h3.hOhDACUTh0xf4f:4: CIRCUMFLEXyAu01a5? CHORN98xf6x69 DIAERESIS>7>7>DIVISION SIGf8(8( 9;9;USFGRAVSa:A: b:B: 8xfc?C? TPu01b0@D> Au20a9E9JDONGf[gF$YN) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB cp273 generated from 'p5"-m+s/CP273.TXT' with0P.py. g#" import sdAPIs class ($. 1): Adef e(self,input,errors='strict'):,`creturno B=,4ingCo0o*B ooIncremental$er h final=False*Y.S 4[0]DR(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(aname='%',d!e=02(). if:'r=y/J // streamreader=StreamReader, sTwrite#W # ) ### Decoding Table d _tA = (Rb'\x00'[# 0x00 -> NULL (NUL)&1&1&START OF HEADING (SOH22222TEXT (STX/3/3/0END_-E-)9c-4-0STRTERMINATOR`_t0" 52 CHARACTER TABULATION (HT53x867565SELECTED AREA (SSA8)7f878DELETE (DEU)97(8(UGUARD]&EP])8d595REVERSE LINE FEED (RI)8e2A2SINGLE-SHIFT TWO22)0b2B2\)V)0C0CFORM$FFZrXD*CARRIAGE RETURN (CR0*x0E0 OUBO* uF*VIN (S11DATALINK ESCAP%LEZ11DEVICE CONTROL ON4&C14 1 4v&DCv11 41HREj3j91 `OPERATSYSTEM COMMAND (OSC:#851N'(N)08+ BACKSPACE (BSU 1 2E21` CANCEL (CAN^)19^MEDIUM (EM.9PRIVATE USE&PU8D1 *&SS11ILE SEPAR5IS41ZGROUP1a 1jRECORD21 JUNIT0821PAD%E(PAD82HIGH OCTET PRESET (HOP3 2pBREAK PTL0HEROPG822NO 9/'NB/'4'2INDEX (INn%2=L)x12rTRANSMISS8BLOCK (ETB1F2 `E# 0x28 -> CHARACTER TABULATION SET (HTS) '\x89' # 0x29 -> C:WITH JUSTIFICMF(HTJIaIAIMLINE~V~b5B5PARTIAL =FORWARD (PLDkc6C6DBACK7U7)057D7ENQUIRY (ENQ)6)E)ACKNOWLEDGE (ACK-7-F-BELL (BEL&(90& 30& DEVICE CONTROL STRING (DC)91717PRIVATE USE ONE (PU1h1 321SYNCHRONOUS IDLE (SYN2793'!332ET TRANSMIT STn'(S)94444gCANCEL<F(CCHf | 352MESSAGE WAIT&MW0 60 START OF GUARDED AREA (SPA70770END5 SSE(EOT5)9885l'SO 434SINGLE GRAPHICIDUCER (SGCIw 131F >= 939IEQUENCE =&CSz1&@ @FOUR41>NEGATIVE &NA)9e\KP4CY 6(PMf NSUBSTITUT#UB," ' 4TTSPACEau4>NO-BREAK *#e2N472N SMALL LETI!A CIRCUMFLEXj{=ELEFT CURLY BRACKET.:\xe?nEGRAVe4H;FACUT; 4S;FTILD; 4W;7ABO $4b@C_dEDILLA.fn=N= c4c;PCAPITe DIAERESIS|.g0FUL"OP%<%OLESS-THAN SIGN*(*D'vPARENTH{+,:7LUSQ!%F -> EXCLAMATION MARK '&'# 0x50 -> AMPERSAND%C\xe9(%1%LATIN SMALL LETTER E WITH ACUTE;a;2; CIRCUMFLEX@b@3@ DIAERESIS?8?4? FGRAVd;5;Ie;6; f@7@ c?8? ~82 9;ETILDd\A! eCAPITA U $bBADOLLAR SIGN*'C'sASTERIS)$D$RIGHT PARENTH ;-E-SEMICOLOv^%F%r ACCENT--6;HYPHEN-MINU/(>TSOLID#C\xc2&w6& VAV[?6(EFT SQUARE BRACKEC\xc02qq%I\xc1== )c3== ~)c5==RING ABO)c7B BCjbEDILLAg:\xd N? )f6|< GO; :,<:CCOMM%!40PER\_(8sLOW LIN>$/GREATER-THANQ?-7iQUESTIn9\xf73?SSTROK9\xc7G< c7a= a9\xc7a :\xcs s 7sce' # 0)x76 -> LATIN CAPITAL LETTER I WITH CIRCUMFLEX '\xcf' # 0x77B DIAERESISAcA8A RGRAVE=`: ~9=!r ACCENT(:(A(RCOLON!#!B!NUMBER SIG'C\xa7*C'vSECTION(2"'"D(APOSTROPH=K&E&fEQUALSM,'"'F'QQUOTAwBMARKC\xd8- 80*OKa;&81>ESMAL Anb020B0`30C0d`40D0e050 F`g` 0G0h0 0H0i0 0I04\xa LEFT-POINTING DOUBLE ANGLE 3bEORIGHF#f0ETH (Icelandic)f>.>YCACUT4\xf;C;_THORN{)b1\PLUS-MINU9\xb9]gDEGREEjOV9FJk0Fl0FL`m0FM0n0Fo0FO`p0FP0q0FQ0r0FR04\xaB9F FEMININE ORDINAL INDICATO6b67oMASCUL7 #e6m(Ab9cCEDILL:\xcT V$a4 0x9F -> CURRENCY SIGN '\xb5'  # 0xA0 -> MICRO&)df&1&LATIN SMALL LETTER SHARP S (German)es< e2?0t030T0u040U0v050V0w060W0x070X0y080Y0z090Z0C\xa13A0 INVERTED EXCLAMATION MARK5bB5MQUES2)d0gC2&eCAPITA(ETH (Icelandic'I\xdd@D@Y WITH ACUTE)de=E=_THORNaBFBREGISTERED(a2mB6JCENT%3%5KPOUNK B9YENJ)b7JMIDDLE DOI\xa9&COPYRIGH@'BCOMMERCIAL AS#b6,9BzPILCROWc(VULGAR FRAC*ONE QUARTERbB7EHALF4 B 4ETHREmS:a(NO|( IC$INoBu203VOVERL$3xa8P$DIAERESI)b4%0 ACSdMULTIPLICeWC AJ AC? AB22B2C22C2D22D2E22F22G22GH22H2I22I23\xa\ # 0xCA -> SOFT HYPHEN '\xf4' " # 0xCB -> LATIN SMALL LETTER O WITH CIRCUMFLEX@)a6@C@BROKEN BAR&)f2&D&fUGRAVE;3;E; FACUT;5;F; FTILD;c;/D0;UDIAERESISJ< V&D1?eCAPITAXJ2K222K2L232L2M242M2N252PO262OdP272P2Q282Q2R292#b95 DA2SUPERSCRIPT ON,b+C, C}=-CRIGHT CURLY BRACKET:\xfLo LamL; Lf;LY9\xd'EP i RH\xf7ERDIVISION SIGS&NEIT2IU2IUV2IV2W2IW2X2IY2IYdZ2IZ29\xbEI#TW 9\xdEI% K%\\EKEVERSE SOLIDU:\xdGm IdEI= KdEK=0FIDIGIT ZERJ1& 0xF1 -> DIGIT ONE '2'# 0xF2 -> DIGIT TWO%3%3%3HREL4'4'BFOURM5&5&#IVL6&6&2SIXK7%7%BEVEN'8'8'REIGHT'9'9'$NI14\xb1A&SUPERSCRIPT TC\xdbV-B-LATIN CAPITAL LETTER U WITH CIRCUMFLE]?2 BCBR SQUARE BRACKE4\xd0D0r 4GRAuC\xdap=E= CACUTI\x9f=F=*APPLICATION PROGRAM COMMAND (APC) ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB- cp424 generated from 'MAPPINGS/VENDORS/MISC/CP424.TXT' with6P.py. m#" import sjAPIs class ($. 1): uAdef e(self,input,errors='strict'):,creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(aname='%',d!e=02(). if:'r=y/J //spr7=D #w##") [T ~2 = 'R'\x00K 00JANULL011START OF HEADING+ # 0x02 -> START OF TEXT '\x03' # 0x03 -> END&(9c&4&TSELECGt G5!HORIZONTAL TABULATIONw"862w60REQUIRED NEW LINE,(7f,7,UDELET!(97!8!GRAPHIC ESCAP)(8d)9)SUPERSCRIP8x8e&A&UREPEA!(0b!B!oVERTIC0<C.FORM FEEDrP?D$CARRIAGE RETUR90E*SHIFT OU 1F$IG"10s 10#@DATAxK5(11+1+EVICE CONTROL O(12-2-3TWO(x1|1|DZETHRE91RESTORE/ENABLE PRESENTj5 a(08#BACKSPAC}8d1 PROGRAM OPERATOR COMMUNIC1]eCANCEL9~dMEDIUM(9[PUNIT  1CUSTOMER USE1ILE SEPA~1}_GROUP*1oRECORD+  ~82YIGIT (x82qSIGNIFI|8S2OFIEL82W0UND?&OR)42BYPASS OR INHIBITn72((x12,TRANSMISSION BLOCK12 2SET ATTRIBUg82^4eEXTEND2x8ac2W@MODE dSWITCH8^qSEQUENC5FIX22rMODIFY 0 2 ENsYS02ACKNOWLEDG05BEL93j93%13SYNCHRONOUS IDL93INDEX RETURN '`\x94'  # 0x34 -> PRESENTATION POSI  %X'\x95050TRANSPARENT&6&6&NUMERIC BACKSPACE,07,qEND OF YtMISSION.(98Z8.SUBSCRIP~9$9$INDENT TABULPa,A,REVERSE FORM FEED,b,B,CUSTOMER USE THRE1C-DEVICE CONTROL FOUR[1WD.NEGATIVE ACKNOWLEDG](9eE -> T F%+STITUTJ G1 !40%Pu05d0% 1 HEBREW LETTER ALEFr-1-2-$BE,2,3,WGIMELZ3. 9DAL\~ .H\{+ +7VAV, ,DZAYIZ7 .HZ ,T,!xa7C3SIG|.wFULL STOP<$LESS-THAN M()RLEFT RHESIST++GPLUSO|$VERTICAL LIN&(5AMPERSANd85(YO,,FINAL KA2 ,c,5LAMJd.2MEMZ` ,f^^#NU0^e5 ,5bSAMEKH!5aEXCLAMR MARK+$+gDOLLAR@*&sASTERISI)#ORIGH;,vSEMICOLuas57NOT-G6HYPHEN-MINU!/'TSOLID"6 de6PU^4' # 0x64 -> HEBREW LETTER PE '\u05e5' # 0x65+FINAL TSADI46464 .7.7.7QOFZ8,8,GRESH-9-9-CSHIN-!xaA-BROKEN BAR%,M B%RCOMMA % C PERCENT SIGl_'D'sLOW LINw>#E#GREATER-THANO?,F,QUESTION MARK`\ufffe- 70(UNDEFINED$F05ea$1$ 4TAV, P2, P $3$0xa0r{ 74$NO-BREAK SPAC q |$ r $62017jzDOUBLE `"7gGRAVE AC.:'aCCOLO# \gNUMBER@&bERCIAL ATn1"'"cAPOSTROPHP=MegEQUALSs"&_?OTA` 8`[8`LATIN SMALLQb|8c/B+'c/n/C/d/y/;/^f^/g//Gh// i//#xa{LEFT-POINTING ANGLE QU)xbDORIGHE 8  d8$  $2xb1'PLUS-MINU8\xb9gDEGREE9jM9Jk/l/L^m/4 -> LATIN SMALL LETTER M 'n'# 0x95 -> LATIN SMA/N/o/6/O/p/7/P/q/8/Q/r/9/R/`\ufffe4A/UNDEFINED$B$C$0xb8j" lD$CEDILLAjE" 8xa4FF$CURRENCY SIGG\xb5( A0(WMICRO%~" A1%RTILDEs 2  S/t/3/T/u/4/U/v/V/w/W/x/X/y/Y/z/Z/ AAA A u $ILREGISTEREDv^ BCIRCUMFLEX ACCEN$B\xa3/5BHPOUNQ8\xaB7YENtH\xb7HMIDDLE DOm9%COPYRIGHTNaNkSECTIOu6PyPILCROWN(bc'{VULGAR FRAVONE QUARTE8xbd66CHALFW(xbB 3ETHREk[i(B`LEFT SE BRACKEG].C/B\xaf2UMACROa9BDIAERESI8\xbB[ACUTEOdMULTIPLICA{CZCURLYA-,eCAPITAgB11BC11C1D11 CAPITAL LETTER D 'E' # 0xC5 -> LATIN CAPITAL LET1E1F161F1G171G1H181H1I191I1B\xad4A1SOFT HYPHEN&Pufffe(&B&UNDEFINE?\$C$D$E$F$} D0$RIGHT CURLY BRACKETJ.1.J1K121K1L131L1M141M1N1O1ObP1P1Q1Q1R1R1B\xb94UPERSCRIPT ON DDDDD"\\ EEVERSE SOLIDUS"f7,EDIVISION SIGS% RYT1KU1UV1V1W1W1X1X1Y1Y1Z1Z1B\xb24 #TWu EEEEE0fFDIGIT ZER1%%$II!3H$3HRE4&# 0xF4 -> DIGIT FOUR '5'# 0xF5 -> D%2IVE%6%6%2SIX$7$7$BEVEN&8&8&REIGHT&9&9&3NINB\xb3(A%SUPERSCRIPT THRE,Pufffe.,B,UNDEFINEDu\$C$D$E$0x9f" F$ ONES ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB) cp437 generated from 'VENDORS/MICSFT/PC/CP437.TXT' with2P.py. i#" import sfAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturno B=,ing_map)m0m*B mm)Incremental$er  h final=False*W.Q ?[0]DP~L!@OStreamWriter(J,W5pasORead9 9Fs module API getregentry(7 UInfo(aname='%',d!e=02(). id:.r=]/J //spr7=D #w##Z0MapATmap =make_identity_dict(range(256)) map.update({F0x0080: 0c7,iLATIN CAPITAL LETTER C WITH CEDILLA?1?+fc?ESMAL=U=DIAERESIS?2?/e9? E?BACUT#83;2; A;CIRCUMFLE@4@4@LATIN SMALL LETTER A WITH DIAERESIS 0x0085:0e0, # LATIN SMALL ?VGRAVE;6;5;RING ABO@7@7@ CvCEDILLA}8=a= E=IRCUMFLEX@9@b@7a?8? 7b;f; Izc?e?Cd@c@ e;+c4;lCAPITA.fA 2A4#90B9 FACUT"91=+e6=IGATURE A323c3535f(hO#94@ u@f9/f2  9f Uf @ {f Y{d4 Ad AAawCENT SIGNw9%a3[POUND&a(;YEN$620a>kPESETA's&19FWEHOOKak%e1:Y iaid;  ;qf!v< ;w  ;r N&FTILD"and; 8=pa FEMININE ORDINAL INDICATORfb6cMASCUL7INAL INDICATOR 0x00a8:0bf, # INVERTED QUESTION MARK292E23102REVERSED NOT SIGN-a-E00ac-$b$%bd$VULGAR FRACONE HALFXc4X4gQUARTEd7%a1kqEXCLAMAp e5b5LEFT-POINTING DOUBLE ANGLE QUOTEfEbEORIGHF b0F6259LFe SHADE#b1'2lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS 4FICAL47%24]7P AND W@5@6 @q1 SIyAH6HHXH7H/56CDOWN| DnO2555D &56 ?255Y A8O2557u6255%UP<x6255 ;/UPw6255} Bu '25 Bc1  c3;HORIZONTc2; B1B m 0/:z3zF/5eT) I?IZIa@5<zx00ca: 0x25609, # BOX DRAWINGS DOUBLE UP AND HORIZONTAL -0x00cb: 0x2566A ODOWNCcC0C VERTICALGVRIGHTdB5B e:/6c|GfG7GUP SINGLEA`#d0H8H ^H1H4H2J5J3J5k#UP$ 4CC5C2E6E3Ey7E/6bEI:8NaN 8NdN9N1iL6LEF"da:0Q:wM8wFULL BLOCK&08LOWER HALF,8+ 9E,8,?UPPeE03b1 GREEK SMALL LETTER ALPHAeE00df4ZLATIN4vSHARP S66039jeCAPITAlGGAMMl603c6 &PIg?03ag 8SIGgy<03c6 g 4h600b}MICRO SIGNI603c6TAU2-603a2 )'PH60394GTHET]603a6GOMEG6?03b 8DELj521e3INFINITY203c # GREEK SM ALL LETTER PHI 0x00ee:@3b5, # GREEK SM2vEPSILON6f6E22296INTERSECTI("f0(&61(DENTICAL TOP f1(600b(PLUS-MINUS SIG{ f2+9226ATER-THAN OR EQU_344OLESS14153201TOP HALF FGRAL5-oBOTTOM060E00f7]DIVISION7)E2248)oALMOST8+600b DE R9'6221BULLET OPERATORa+600bMIDDLE DOT&b&E221aSQUARE RO'c'607f'UPERSCRIPT LATINrd<O00b2<'TWG625abBLACK '00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00'AX00 -> NUL(!1!1!START OF HEADINGN2-2-2TEXW3*3*0ENDU (4(4(pRANSMIS5050UQUIRY$6$6$ACKNOWLEDGE(7(w7 -> BE8!8!2ACKY2'\t$ c9&HORIZONT0ABUK<'\n2a2LINE FEEDb(# 0b&3VER V:x0c0c0HFORMVr$d&CARRIAGE RETURe.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /J'\x11 /6HRE` 1 12FOUa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2d BLOCKM11UCANCE )191YeMEDIUMMa*SUBSTITUT 1ESCAPE '\x10c'  # 0x001c -> FILE SEPARATOR Z'\x1d+d+_GROUP,e,e,oRECORD-f-f-LUNIT+ (3 20+RSPACE!"1"EXCLAMATION MARK-"-2-LQUOT+#+3+NUMBER SIGNS$(4(XDOLLA(%(5(wPERCENTQ&)6)AMPERSANDw0"'"7&POSTROPH(M8'LEFT PARENTHESIST-')-9-ORIGH.*.a.sASTERISq+%b%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3{DIGIT ZEROK1''#ON2&y&#TWL3&t&3HREN4(t3FOU5'sO3FIVN6'q'2SIX7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33K 'L'  # 0x004c -> LATIN CAPITAL LETTER L (0'M'3d3M3N3e3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.rOW LINE`%6YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1! 1m11n11o1p17bq1r1s1Pt1"u1 ALL LETTER U 'v'# 0x0076 -> LATIN SMALL LETTER V1w171W1x181X1y191Y1z1a1Z1{1b1EFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%f"UDELET#)c7# 80#PCAPITC WITH CEDILLAJ\xfc@1@ U>DIAERESIS@*e9@2@E@6ACU*e2<3<A<CIRCUMFLE-J\xe4A4A 0@5@ EGRAVy*e5<<RING ABOA L*eaYx<bAiA<8@x@ < 8xI|e| @ A cu< r c;B =cw9 y6@9IGATURE Ac46f-9OfwA lfd9@ f#9 A } $9Y: d99 -> LATIN CAPITAL LETTER O WITH DIAERESIS '\xdc'  # 0x009a -> LATIN CBUB*a2BbBCENT SIGNh*a3&c&ZPOUND'5'd'8YEN%Pu20a7'e%iPESETA(1019(f(ESMALFDHOOK e1a /a0;A;UACUTE<d<1<I<f'/a2< x*fax3< < 4<NETILDd<5< C>a6> FEMININE ORDINAL INDICATOReb777oMASCUL8 f%88INVERTED QUESTION MAR Pu23105G a93REVERSED NO QaQ %b#4VULGAR FRACONE HALF ZC5eQUARTE+aTqEXCLAMAr0xabeLEFT-POINTING DOUBLE ANGLE QUOTFbFORIGHGAu259bGE SHA(b{mMEDIUM)jQhLDARK'0PSBOX DRAWINGS L?CICALPu2524?_O8P AND ]A6T As1 SIBI _IYI(56q ICDOWN~E~E  E# ^B 9zb9 w>%UPAz< <UP DOUBLE AND LE&FT SINGLE '\u255b' # 0x00be -> BOX DRAWINGS UP3 AND LEFT DOUBC(10CfC@LIGH6%WND'14=/c0=!UP;RJ<3<1< HORIZONTALA(2c}2A#DOC1C3CVERTICAL0?/c4B|3|5: |G(5e6GA< (5fJ7JCJ[(5aJ8JA59= W(69|a?|R(66BbBD cD 5CdC~ [ ~H7  _B ['68Id(#UP3UI Z6d55 K(65?K5 KaK5tdG D #I lDD2SF3FRF{FW6dN SdSO1ne%8;0]da;%8y]FULL BLOCKe8 0x00dc -> L!OWER HALF BLOCK '\u258c' # 0x00dd -> LEFT,(90,e,ORIGH-8-f-?UPPG03b1Z e0- GREEK SMALL LETTER ALPHA0xdf3 e15ZLATIN5sSHARP S7Pu03939 e27leCAPITAnDGAMMnHu03c&e37 &PIiai42 i9SIGi 757 i50xb5 65MICRO SIGN c4)7' \6TAU3(a6383 'PH(98595GTHETd(a97a7GOMEG7bb7 6DELlH221elc5INFINITYc0 c%3eEPSILO9222/INTERSECTI)6+f+IDENTICAL TOxRfPLUS-MINUS1226AfATER-THAN OR EQUaHu226wfOLESS2(32Df2TOPlCGRALIu232 oBOTTOM10xf7DIVISION4flALMOST!xbV DE T1fBULLET OPERATOR+xbMIDDLE DOT'Pu221aSQUARE RO(!07 (SUPERSCRIPT z0xb2c=$TWTAu25aibBLACK x'UNO-BREAK SPACE ) ### Encoding Map e_map = {Q100:000,2NUL- 1 1 START OF HEADINGL2,2,2TEXU3)3)0ENDS '4'4'pRANSMIS5/5/BQUIRxy6#6#ACKNOWLEDGEJ7'7'&BE008: 0x0008, # BACKSPACE 0x0009: , # HORIZONTAL TABULATION1a1a1LINE FEED%b%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUTf%f%II"10$%10$DATA LINK ESCAPJ#11,1,EVICE CONTROL ON.2.2.5TWO#13.3.7HRE^4040FFOUR_5/5/NEGATIVE ACKNOWLEDG_6060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCK8585fCANCEL"%19"WfMEDIUM)1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2AMPERSAN22APOSTROPH2v2vLEFT PARENTHESISW22ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZER3p3p&3i3i% 3d3d% 3d3d 3c3cM6FIV3a3a&5SIX+3a3a%6EVE3b3b'E<N]3]''NIC3V3V5COL003b: 0x003b , # SEMICOLON 0x003c: %LESS-THAN SIG*d*d*kEQUALS'e'e'GREATERTf-f-QUESTION MARK"40)%40)COMMERCIAL AT)1)1)LATIN CAPITAL LETTER A22222 B23232 C24242 D25252 E26262 F27272 G28282 H29292 I2a2a2 J2b2b2 O/4c2 Ld4XM2 4 2b442Od552P2 5  Q2 5  R2 5  S2 5  5 5  Ud 5  V2 5  W2 5  X2 5  Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5fOW LIN66\GRAVEL66OSMAL66 066 066 066 06: 0x0066,  # LATIN SMALL LETTER F 0x0067:,0G08080 H09090 I0a0a0 J0b0b0 K0c0c0 L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V0/770 W07 X07 Y07 Z07EFT CURLY BRACKEN7VERTICAL LINEW7ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARa9(CENT SIGa9[POUND&9;YEN$a FEMININE ORDINAL INDICATOMaaGLEFT-POINTING DOUBLE ANGLE QUOTaB+NObmjDEGREEbjf=PLUS-MINUS+`fSUPERSCRIPT TWb@e[MICROQfMIDDLE DObhPMASCUibimjbj/VULGAR FRAC ONFARTEb\a76HALb@aAQUESm 0x00c4: 0px008e, # LATIN CAPITAL LETTER A WITH DIAERESIS -0x00c5: /8fARING ABOVEB6B/92BIGATURE A575/805CvCEDILLAt9?9? E?FACUT|"d1=/a5| N=GTILD=9= O=q"dc~/9aA UAfA+e1AESMALfSHARP "e068 6'7GRAe0 m; k#e2v3 vCIRCUMFLEX#e4@4@le6?eke7s #e8  j 8; av8 vb@ {/8d I dzaD; e;/8cv/8b@fT fT9  0"f3a% ; 0f9 ;0fK @0WfDIVISION SIGN2f9 ] a ; 9 ; @ESIS 0x00ff: 0x0098, # LATIN SMALL LETTER Y WITH DIAERESIS +c0x0192?f? F?DHOOK:2393:%e2:GREEK CAPITA{VGAMMA68696 FTHET6al46 7SIGl#a6l5PHI#a94aj FOMEG#b1606 GALPH444b4 7DEL#b54e4 uEPSILON#c0636 Pco51 mc74 6TAUd2 3207%fc2SUPERSCRIPTB20a79;PESETA SIG'#21fBULLET OPERATORB221aRfSQUARE ROOT'e'eINFINITY$2veINTERSECTI3224>feALMOST EQUAL TOS6f{IDENTIC(fLESS-THAN ORYfOATER4#31aV0REVYD NOT#32-fTOP HALF DGRAL$32oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi#50)b(91VERb250cdP7DOWN AND R=7b= 5LEFw#51c</UPwfd; uc%{2b fA 2o3%c1dB8@ a F5GS DOUBLE HO RIZONTAL 0x2551: 0x00ba, # BOX DRAWINGS DOUBLE VERTIC828/d58WN SINGLE AND RIGHTN}3E6EEVE4E/c9EFDOWN>5>/b8> >LEF6D7DD 7DbD D8=/d4=/UP9C3C aCcK/UPb</ben< LcBdBBRFdBcB?B;e;c?fIKI#60I PI6;G6*b ],-b HA)/d1 $HO. l65/d2JJ-;cJC:/cf A E0HJcR GHdHLyG ZdRNdfc"NG8dUPPER HALF BLOCK,?LOW,OFULL BLOCK  0x258c: 0x00dd, # LEFT HALF BLOCK +#90+e+ORIGH,1,%b0,L,VSHADES2'1'{MEDIUM (3(2(KDARK&aflBLACK SQUARE } """ Python Character Mapping Codec cp500 generated from 'MAPPINGS/VENDORS/MICSFT/EBCDIC/CP500.TXT' with gencNP.py. v#" import ccs ###sAPIs class($.1): 0Qdef eW(self,input,errors='strict'):,creturno.charmap_B=,ing_table)o deo)B ooIncrementalEr  h final=False*Y.S 4[0]D"eN!@QStreamWriter(N,8cs.5pasORead9 9Js module API getregentry(7 UInfo(aname='%',d!e=02(). if:'r=y/J //spr7=D #w##") [TD5cod2 = '`'\x00'1 #  -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ&(9c&4&dCONTROt  5"HORIZONTAL TABULATIONx"86260 R8x7f"7"RDELETrX'\x97!8! C(8d"9"e"A"(0b"B"oVERTIC0)C.FORM FEEDrP+D$CARRIAGE RETUR%0E*SHIFT OUT '\x0f'  # 0x0F -> SHIFT IN '\x10' # 10#DATA LINK ESCAPE+1+1+EVICE CONTROL ON-2-2-5TWOZ3-3-5HRE\(9d/4/Q(85"5"(08"6"BACKSPACh(87$7$ h1F8"TANCEL(19C9!END OF MEDIUM(9/A( k(8fJB"(1c"C"FILE SEPARATORm1@D)_GROUP*eSE*oRECORD+ lNUNIT)8r2r i2i "/2^ "S2S "42Fn ?2FLINE FEEDL$2HTRANSMISSION BLOCK4bZ2X j8W2WcC8X2X aeR R8R2R f0i2KtENQUIRY(06CACKNOWLEDGk0G>5BELG94349434134SYNCHRONOUS IDL9=3=9=3=(x93= <9; "0f)>]j963696369636963616D(6FOU (BNEGATIVE )93O 51KSUBSTITUT  4Q aq4ONO-BREAK )e4VLATIN SMALL LETTER A WITH CIRCUMFLEXe,4j?DIAERESIS> >MALL LETTER A WITH GRAVE '\xe1'  # 0x45 -> LATIN SMALL LETTER :FACUT:3:6: FTILD:5:7: RING ABO7?8?CtCEDILLAf9<N<[s# )A:EFT SQUARE BRACKETh..B.FULL STOP$<$C$LESS-THAN SIGN)()D)FT PARENTHESIS+++E+GPLUSO!$F$EXCLAMATION MARKO&+ 50+AMPERSAND$B\xe9'B 51$BES Ba:2: CIRCUMFLEXyb?3? VDIAER*H\xe8>4> 3d:3Ie:3:f?8?c>7> dx5SHARP S (GERMAN)]u959ORIGH:$/:gDOLLAR*&<sASTERIS)#6x 7;,7SEMICOLO^$7c ACCEN-,68HYPHEN-MINU/';TSOLID"B\xc2%]6#lCAPITA~H\xc4A%A 6(c0@'@ 8cm6)< c^6+<8\xc`6(<bcb6+ Add/ >fH\xa6o-BROKEN BAR,"R6#CCOMM% x6C -> PERCENT SIGN '_'# 0x6D -> LOW LINE#>#E#GREATER-THANO?,F,QUESTION MARKTB\xf8+w 70(LATIN SMALL LETTER O WITH STROKH\xc9;1;eCAPITA=E=FACUT<a<2< CIRCUMFLEX(cbA3A DIAERESIS@ 4@ FGRAVd|5<Ie<6< fA7A c@8@ `92 -9< r ACCENT\:'A'CCOLO# B gNUMBER@&C&COMMERCIAL An0"'"590APO#PH=M;gEQUALSs"&5=OTA6d>86 8F88 sAN/+ /B// /C// /D// /w/ /F^g8 /G/h/ /H/i/I/3\xa{X8LEFT-POINTING DOUBLE ANGLE QU(bDORIGHE"f0 ETH (ICELANDIC)f==Yf:3:_THORNy(b1LPLUS-MINUv8\xb9MgDEGREEjMK96Jk/6l/6L^m/6M/n/ 0x95 -> LA TIN SMALL LETTER N 'o'# 0x96 -> LA/O/p/7/P/q/8/Q/r/9/R/B\xaa2A/ FEMININE ORDINAL INDICATO5b5B5oMASCUL6 (e6kC6 'IGATURE AE(b82D2tCEDILLA"cTE"TCAPITAL LV(a4VF4CURRENCY SIGG\xb5( A0(WMICRO%~"1 @ A1%CTILDs 2  KSt/3/T/u/4/U/v/5/V/w/W/x/X/y/Y/z/Z/B\xa12 INVERTED EXCLAMATION MARK4(bf44MQUES1(d01~*ETH (ICELAJ)p(dd? ?Y WITH ACUTXH\xde<{_THORN}aAREGISTEREDG\xa2kBJCENT$3$KPOUNIQB 9YENH(b7HMIDDLE DOH\xa9%COPYRIGH N1SEC EBzPILCROWcwVULGAR FRAVONE QUARTE,B6DHALFbB 3ETHREk>9\xa(NO|B!IC,N`a BUMACROaBDIAERESIbjB0 ACBdpMULTIPLw{CLEFT CURLY BRACKE+A-cQB12 -> LATIN CAPITAL LETTER B 'C'# 0xC3 -> LATIN C1C1D141D1E151E1F161F1G171G1H181H1I191I1B\xad4WA1SOFT HYPHEN&(f4&B&}ESMALO WITH CIRCUMFLEX?6?C? DIAERESIS>2>D> CGRAVH\xf3:E: FACUT:5:F: CTILD:}71 Q D0:RIGHT CURLY BRACKETJ.1.Y J1K121K1L18L1M18M1N18NO18ObP18P1Q18Q1R18R1B\xb948UPERSCRIPT ONH\xfb*<U<c?<?< <> <ax<: <f:<Y \<@E@EVERSE SOLIDU7,E<DIVISION SIGoS%E3YT13U13U>V13V1W13W1X13Y13YbZ13Z18\xbE3IPT TWO p'\xd4' ## 0xEB -> LATIN CAPITAL LETTER O WITH CIRCUMFLEX 6A6ACA DIAERESIS@2@D@ UGRAVE<3<E< FACUT<5<F< CTILD<091 5 F0<DIGIT ZERO1%1%#ONII2$#TWH$3$3HREJ&4&BFOUR%5%IU%6%#SI77$BEVENo8&8&REIGHT&9&9&$NI)3\xbrA%SUPERSCRIPT T B\xdbT,UcAA@ a|< (9f<CONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """Python Character MappVCAJ cp720 generated on Windows: Vista 6.0.6002 SP2 Multiprocessor Free with the command: pvTools/uni`/genwiec.py 720#" import '"csAPIs class ($. 1): Adef e(self,input,errors='strict'):, creturnoDB=,4ingRCoko*B ooIncremental$er h final=False*Y.S 4[0]D(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7codecs.CodecsInfo( name='cp720',encode=Codec().)deincremental:6r=IE\r/J /Dl/streamreader=S R R#Ewrit#W #) ### [ing Table ~Ping_t2 = 'b'\x00'0 # 0x00 -> CONTROL CHARACTER>-1-1- 2-2- 3-3- 4-4- 5-5- 6-6- 7-7- 8-8- t+" 9- n-A- 3x0b/ZB- c-C- r+D- 3x0e/E- f-F- 11 11 11 11 11 11 11 11 11 8x191 9x1a- 11 11 9x1d 11 11   W2RSPACE!!EXCLAMATION MARK,",LQUOT*#*NUMBER SIGNQ$'XDOLLA'%'wPERCENTO&(AMPERSANDt2"'"27 -> APOSTROPHE '(' # 0x28 -> LEFT PARENTHESIS,),9,ORIGH-*-A-ASTERISKQ+$B$PLUS SIGN%,%C%RCOMMA!-!D!HYPHEN-MINU.(E(FULL STOPM/%F%TSOLIDH0# 30#DIGIT ZEROI1&1&#ON~2%2%#TWJ3%3%3HREL4'4'BFOUR5&5&#IVL6&6&2SIXK7%7%3EVE8'b/E<N9']'$NI1:&VCCOLOn;!SGSEMI%<%SLESS-THAN}=*\XEQUAL>'[|GREATERT?-cQUESTION MAR@)4iERCIAL AT<A)lLATIN CAPITAL LETTER 4B2y2BdC22C2D22D2E22F22FdG22G2H22H2I22I2J22J2K22OL2&LdM2dM2N2 2O22P252Q2 QR2 YS2 T2 U2 UV2# 0x56 -> LATIN CAPITAL LETTER V 'W'# 0x57 -> L2W2X282X2Y292Y2Z2A2Z2[2B2EFT SQUARE BRACKET/%\\0C/REVERSE SOLIDUS+]* +D+?IGH[^0E0CIRCUMFLEX ACCEN_-F-LOW LINE`$ 60$YGRAVELa(1(ESMALAXb020B0c030C0d040D0e050f060F`g0 G0h0 0H0i0 0I0j0 0J0k0 0K0l0L0m00M0n00N0o0O0p07`P0q0Q0r0R0s09t0 u0Uv0w0x0y0z0{0ZCURLY|.`VERTIC_})RX~/CTILD4\x707CONTROL CHARACTETR\x80'E\x81 #e9gC8E WITH ACUT~!e2; # 0x83 ->! LATIN SMALL LETTER A WITH CIRCUMFLEX '\x84' 0e0' # 0x85 ->KTGRAVE;&86F7F7FCdEDILLAH)ea=8=E= )eb@9@ DIAERESIS8?A? )ef;B;Ize?C? d&8e f $90 Qu0651n 91lARABIC SHADD)2)2)DUKUN7!f4&9 93(Oa@4@CURRENCY SIGiBu064uTATWEEL  96SU)f9@ Hu062_GHAMZe2e /BALEFME ABOzn3?x ?}? ?2WAW}>"xa{[POUND'25D deSBELOW6?E??YEH>F>}l..A0.7BEH-&-HTEH MARBUT5T5b-Y :)THc)AG .GJEEM\d.L(HAO [K..= .$DAGu063A/)TH.]A.R3[A7ZAI]3 8SEE.9A *SH/A3SAD"xaWALEFT-POINTING DOUBLE ANGLE QUOTATION MARK '\xbb' '# 0xAF -> RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK ;q'\u2591HF B0FLFg SHADE'2'1'mMEDIUM(3(2(LDARK&0N3&BOX DRAWINGS VERTICAL'24]47 AND LEFT@65@q1 SI3AIH6HXH'567HCDOWN|D5D8D9DHYAA 87B8ud=C=%UP<xc;D;/UPw7EBu '101 C<3;;HORIZONT;C@B1B  0:Cz3z wzF&5eCT'5fIpGIZIaI5z'69zzM6CCNI 5B|R: |GC UP SINGLE AND HORIZONTAL DOUBLE '\u2568' # 0xD0 -> BOX DRAWINGS UP2W AND HISINGH4H1HRDOWN 4 J 5J2J4 J`'59J3J SRIGHTC4CuCC25C E3E6Ey'6bE7EeVERTIC$I aN8N N1i9NL!UPGFLEFT:'0cA:f_=8wB=FULL BLOCK&C&LOWER HALF,D,?EFT+'90E+,8,F,?UPPF0636XEARABIC LETTER DADG0637- -7TAH-/E -Z-E -7AINZNEi -)GH/'41U /$FE"xbP! E=MICRO SIG4E S6QAF4E -K-?E -7LAMZ -8MEE. .8NOO .H6Hu064 -7WAW -ALEF MAKSURA6 6Y7226FBIDEN'TOUFxFATHATAFKDAMM+dqFKKASR+e+f(~(5F&{((22F7 -> ALMOST EQUAL TO '\xb0' # 0xF8 -> DEGREE SIGN'Qu2219)'9'BULLET OPERATOR+1xb7)RA+MIDDLE DOT&Qa(QB&SQUARE RO'707f'C'UPERSCRIPT LATIN SMALL LETTER 1xb2:D<$TWBu25aE+bBLACK x&SF(NO-BREAK SPACE ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB) cp737 generated from 'VENDORS/MICSFT/PC/CP737.TXT' with2P.py. i#" import sfAPIs class ($. 1): Adef e(self,input,errors='strict'):,screturno B=,ing_map)m0m*B mm)Incremental$er  h final=False*W.Q ?[0]DP~L!@OStreamWriter(J,W5pasORead9 9Fs module API getregentry(7 UInfo(aname='%',d!e=02(). id:.r=]/J //spr7=D #w##Z0MapATmap =make_identity_dict(range(256)) map.update({F0x0080: 0x0391,K CAPITAVALPHA61626 7BET52535 GGAMM63646 8DELl4656 bEPSILO5868 Z657, # GREEK CAPITAL LETTER ETA 0x0087:@398, # GREEK 4)TH68696 (IOk95a5 GKAPPa6b6 GLAMD6b6c6 &MU c3d3 N3d3e3 &XIfe3f3 vOMICRON8f8/a08 Pk#90313 5RHOg#91434 FSIGMn#92646 &TA<#93454 WUPSIL #94868 'PH 5474 C464 'PShMa GOMEG>MbESMALGALPH4L+b2 4B9Ib 38GAMGb 47DEL9Hb 4EKb 6ZKb 3 2Eb 2 aFb 4 aEb 3 aCb 4 aCb 4a<b 1a9b 1a6b 1 a8c 6a3c3 a1c a2ce kFINAL :8c8 a6c6 a6c6ALL LETTER PHI 0x00ae:@3c7, # GREEK SMALL LETTER C2f282 &PSd b02E25912LIGHT SHADE#b1'2'lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS VERTICAL47%24]7 AND LEFT@5@6 @qu SINGLEAg DOUBL 6HH8HX7H/56CDOWN|D8D5DxD9D6 / YaA5Y Ayb8yuc=d5 UPxd;c;/UPwO255bBu O2510Bc1  Rc3;HORIZONTc2; B1B m 0: z3zF/5eTfI ?IZIaI@5<z/69zM6C6GB |6R|Gcf: 0x2567, % # BOX DRAWINGS UP SINGLE AND HORIZONTAL DOUBLE 40x00d0: 0x2568,H2 H^H1H4HODOWN2J5J3J/59J#UPSRIGHT4C CC5C2  E6E3E47E/6bEeVERTIC$I: N8NaN 8 N9N1iL!UPGFLEFT:a:/0c:f _=b=8wFULL BLOCK&c&LOWER HALF,d,+e+%90,f,8,?UPPe603c GREEK SMALL LETTER OMEGAe603a4ALPHA WITH TONOS?E03ad?EPSILONAO03aeA T~603c~$IO>DIALYTIKO03af B ?03c= _OMICR?03c? U?603c A?03c 8K0386D@CAPI{yE'03 AG <038 C  <038I ? <038  @  <038 C UPSILON WITH TONOS 0x00f0:@38f, # GREEK CAPITAL LETTER OMEGA WITA1A50b1APLUS-MINUS SIGNl2+E2265+ GREATER-THAN OR EQUAL TO43444OLESS141E03aa13IOTDIALYTIKAu5DbD rUPSILONG6G50f7GDIVISION7)E2248)oALMOST8+E00b0+ DE R9'E2219'BULLET OPERATORa+600bMIDDLE DOT&b&6221WSQUARE RO'c'&07OSUPERSCRIPT LATIN SMALYd<E00b2<'TWe+625abBLACK f('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00'*A00 -> NULL!1!1!START OF HEADING-2-2-2TEXx3*3*0ENDU (4(4(pRANSMIS5050UQUIRY$6$6$ACKNOWLEDGE(7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZON@TABUKO=<'\n2a2LINE FEEDb(# 0b&`VERTICv V:x0c0c0HFORMVr$d&CARRIAGE RETUR2x0e.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /J'\x11 /6HRE` 1 12FOUa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2d BLOCKM11UCANCE )191YeMEDIUMMa*SUBSTITUT 1  1c -> FILE SEPARATOR '\x1d' # 0x001d -> GROUP SEPAR,e,e,oRECORD-f-f-LUNIT+ ($ 20+RSPACE!"1"EXCLAMATION MARK-"-2-LQUOT+#+3+NUMBER SIGNS$(4(XDOLLA(%(5(wPERCENTQ&)6)AMPERSANDw1"'"7&POSTROPH(M8'LEFT PARENTHESIST-')-9-ORIGH.*.a.sASTERISq+%b%GPLUS,&c&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3{DIGIT ZEROK1''#ON2&y&#TWL3&t&3HREN4(t3FOU5'sO3FIVN6'q'2SIX7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33L3LATIN CAPITAL LETTER L 'M' # 0x004d -> LATIN CAPITA3M3N3e3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1 5c0REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.rOW LINE`%6YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1 1m11n11o1p17bq1r1s1Pt1"u1 v1 0x0076 -> L ATIN SMALL LETTER V 'w'# 0x0077 -> L1W1x181X1y191Y1z1a1Z1{1b1EFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%of"TDELET#Pu0391%# 80#GREEK CAPITRALPHA\727178BET63626HGAMM747379DELn5747wEPSILON6959Z7666 585*TH7977)IOa66HKAPPb7"7HLAMD7c7(7'MUzd4-4N4e474'XIh;4XOMICR(a0mR9Pmac9c6RHOa+9a8SIG+a+9b'TABa)9`U)a)9b(PH(9^C5(9](PSj&9]GOMEGb]  b9\ 5 bY 4 bW 5 bX 5 b[ 7ZETA '\u03&b7' # 0x009e -> GREEK SMALL LETTER ETA '\u03b83f3*TH595/a05)IOia414WKAPPAb525HLAMD5c535'MUgd242N2e252'XIdf262vOMICRON7(c0777Pi(c12827RHOe3393GSIGMg(c25a5lFINAL ;4;b;'TAq(c53c3YUPSIL?67d7(PH@EaEC3EaE%PSf8259bCLIGHT SHADE8259fb7mMEDIUM)b+LDARK'0PBOX DRAWINGS VERTICAL2b#8 AND LEFTA62 Asu SINGLEBg DOUBL6II9IY5b[ ICDOWN~EbnEzE6 E #^5^B {5b9 w9b>%UPzb </UP}b C{ 1`b C1c=R3<<HORIZONT@ 0x00c2 -> 4BOX DRAWINGS LIGHT DOWN AND HORIZONTAL '\u251c' # 0x00c3 -> CVERTICALGRVB(00B4B|3|5: |G(5e6GAfSINGLEv DOUBLE(5fJ7J9J[JaJ8JA&UPD=4=9= (69?a?|R(66BbBD cD 5CdC~ [e; ~H7 fH2UP B ['68I/d0I I_6-d1I552K5t-d3K#UP95#I lDD2S F3FRF{(6bFN SdS1ne<%FLEFTe0]da;%d>8y]FULL BLOCK' @LOWER HALF- *,9Vd-8-?UPP803ce GREEK SMALL LETTER OMEGA803ae5ALPHA WITH TONOS@d' # 0x00e24 -> GREEK SMALL LETTER EPSILON WITH TONOS '\u03ae' # 0x00e3 B/TA>(ca>4$IO?DIALYTIKAfC5C (cc?6?_OMICR(cdB7BUD(cbB8B c9FOOMEG(86a@eCAPITAOALPHB8BbBP (89DcD 8Rd@T A eA 8fD 8/f0D0xb1I f1BPLUS-MINUS SIGNF@2265. f2, GREATER-THAN OR EQUAL TO545OLESS2803af da/f E ^ H0xf7 DIVISION4flALMOST:xb0V DEU T1fBULLET OPERATORi+xbMIDDLE DOT'Iu221^SQUARE RO()07[dSUPERSCRIPT LATIN*:xb2a=&TW!!5aVLbBLACK x'1NO-BREAK SPACE ) ### Encoding Map e_map = {Q100:000,FNULL 1 1 START OF HEADING,2,2,2TEXu3)3)0ENDS '4'4'pRANSMIS5/5/VQUIRY#6#6#ACKNOWLEDGE'7'7'BELL 0x0008: 0x0008, # BACKSPACE 9%9%HORIZONTAL TABULATION1a1a1LINE FEED%b%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUTf%f%II"10$%10$DATA LINK ESCAPJ#11,1,EVICE CONTROL ON.2.2.5TWO#13.3.7HRE^4040FFOUR_5/5/NEGATIVE ACKNOWLEDG_6060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCK85fCANCEL"1WfMEDIUM)1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2AMPERSAN22APOSTROPH2v2vLEFT PARENTHESISW22ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZER3p3p&3i3i% 3d3d% 3d3d 3c3cM6FIV3a3a&5SIX+3a3a%6EVE3b3b'E<N]3]''NIC3V3VCOLON 0x003b: 0x003b, # SEMICOLON c%c%LESS-THAN SIG*d*d*kEQUALS'e'e'GREATERTf-f-QUESTION MARK"40)%40)COMMERCIAL AT)1)1)LATIN CAPITAL LETTER A22222 B23232 C24242 D25252 E26262 F27272 G28282 H29292 I2a2a2 J24O4&Ld4dM2 4 2b442Od552P2 5  Q2 5  R2 5  S2 5  5 5  Ud 5  V2 5  W2 5  X2 5  Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5fOW LIN66\GRAVEL66OSMAL66 066 066 066 0E 0x0066: 0px0066,  # LATIN SMALL LETTER F 0(27: 0 G08080 H09090 I0a0a0 J0b0b0 K0c0c0 L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U060 V0/77` W07 X07 Y07 Z07EFT CURLY BRACKEN7VERTICAL LINEW7ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*b*DEGREE SIGZbfPLUS-MINUS+fSUPERSCRIPT TWb0fMIDDLE DOhf&DIVISIONz#38eOpK CAPITALPHA WITH TONOP#38eAEPSILONCeCTe=?/IO@e<@_OMICRe<CUfXCOOMEG9o8A h#39z8wFBETA5t8GREEK CAPITAL LETTER GAMMA 0x0394:@083, # GREEK CAPITAL 6GDELT65646 vEPSILONn6858 (ZEm7565 48474 )TH69686 (IOa595 GKAPPBb6a6 GLAMD6c6b6 &MUsd3c3 N3e3d3 &XIff3e3 WOMICR#a08f8 Pk"a13/903 5RHO#a3414 7SIGa/926 &TA<a9P Ua9R 'PH 9N C49M 'PSh9M FOMEGaf M WITH DIALYTIKD&f NG7eESMALRALPHACVTONOS>Ce ?AQe AT~[e =F b.  >#b2.  4B:ba  3 {b_  4 yb_  4]  6 ub\  3 Z  2 qbZa 4Wa m 0x03bb: 0x`00a2,  # GREEK SMALL LETTER LAMDA 0x03bc: 0x00a34 &MU1d141 N1e151 &XIbf161 uOMICRON6#c0676 Pg#c1181 6RHOc22a2 FINAL SIGMf#c3:9: 444b4 &TAj#c52c2 XUPSIL966d6 'PH:72e2 C282f2 'PSd92/e02 GOMEGfa4 IOTA WITH DIALYTIKBbB BESeEVTONOShce Aseo =3207fHSUPERSCRIPT LATINT3221f{BULLET OPERATOR3221fSQUARE ROOT'4<fALMOST EQUAL T32263fLESS-THAN OR12f2OATER4#50icfBOX DRAWINGS LIGHT HORIZONTAL#50?b9hVERTIC7Odv7DOWN AND Rt1by= 5LEFy#51Nc</UPwd$; uc%{2b fA 2o3%c1B@1@ HORIZONTAL  0x2550: 0x00cd, # BOX DRAWINGS DOUBLE HORIZONTAL &:1:/ba: hVERTIC828/d58WN SINGLE AND RIGHT}3E6EEVE4E/c9EFDOWN>5>/b8> >LEF6D7DD 7DbD D8=/d4=/UP9C3C aCcK/UPb</ben< LcB#UP2BRFdBc;e;c?fIKI6 PI6;GWH*b 8HXH-b  6)/d1 .:5/d2JJ ;cJ:/cf A E0HJcR GHdHL1G ZdRNdfc"NG8dUPPER HALF BLOCK, LOWER HALF BLOCK 0x2588: 0x00db, # FULL&c&d&LEFT HALF+#90+e+ORIGH,1,%b0,L,USHADE#92'1'{MEDIUM (3(2(KDARK&afZBLACK SQUARE } """ Python Character Mapping Codec cp775 generated from 'VENDORS/MICSFT/PC/CP775.TXT' with2cAP.py. i#" import cs ###fAPIs class($.1): #`def en(self,input,errors='strict'):,creturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.5pasORead9 9Fs module API getregentry(7 UInfo(aname='%',d!e=02(). id:.r=]/J //spr7=D #w##)Y0Map@0codTmap =make_identity_dict(range(256)) 5.update({E85106@LATIN CAPITAL LETTER C WITH ACUT3008+fc=ESMAL;U;DIAERESIS|/e9? E? z&10 zA;fMACRONw43/e4w <5??123? G{vCEDILLA|6=?0e5= |RING ABOVr7@?107@ C WITH ACUTE 0x0088:P142, # LATIN SMALL LETTER L WITH STROKE (<9</13< E<fMACRON<a<+56<eCAPITAzR>vCEDILLA?b?7? =c=/2b= Iz d<+79< Z>GACUT1e=?0c4= A=DIAERESISfA5ARING ABOV#90B  "91=evIGATURE Ap23c30535;14dhO& !94<,0fq<b!95?,12}G} !96?&0a?CENT SIG!97%;15a dSd 5 ;,0d xY?0dc UA;0f8A n9&0an[POUND\,0db ddWMULTIPLICATIONmaCURRENCY)av;100  aw/120 af8 la7l ;DOTna,171 ?7? 6201CRIGHT DOUBLE QUOTEMARKaa&0a#BVN BAR&&0aEBCOPYa as%aeREGISTEREa]a,+NO:a@bVULGAR FRACONE HALF8bc, # VULGAR FRACTION ONE QUARTER 0x00ad:@141, # LATIN CAPITAL LETTER L WITH STROKE>e>60ab> EFT-POINTING DOUBLE ANGL|1OTAFMARKEfEbEORIGHF b0F7259FV SHAD#b1'2lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS LVERTICAL"b47%24]7 AND LEFT@5@6010@AVOGONEp#b6>c~>C>VCARON{7=/18= E= {8>6>DOT ABOV9A6256 :pr;aA5'A b878ODOWNuc=d= /UP;%2e;Ip?160> S> 6251= c1<jc3;HORIZONT]c2{B1B d 0: z?253zF74U c/6a4 >8MAC c6255> ~5< u%69z76ACpC; ?255;|256c, # BOX D#RAWINGS DOUBLE VERTICAL AND HORIZONTAL 0x00cf:@17d, # LATIN CAPITAL LETTER Z WITH CARON="d0=+05=ESMAL;A;fOGONEK<1< y <C< w2;/19w E; w3<7<DOT ABOVE4?/2f? I{5</61< S< 6;/73; U; 7</6b<9MAC8</7e< 9;E2518;TBOX DLIGHT UPFLEFTda:/0c: ADOWN<RI=b=8wFULL BLOC}c&4cLOWER HALF,d,+e+%90W,y6258,?UPPeh,0d OFACUTei/0d SHARP S (GERMAN)Qem4!| Aeo4 Nm/0f_ yGTILDl,0d;2 =n&0b=MICRO SIGeX4D W%36(uKvCEDILLA[?013 =^<013 L|`<013 =w<014 =3 O01125  6014s}0sSINGLE QUOTATION MARhfaSOFT HYPHEKfbPLUS-MINUSvf7201EFT DOUBLE QU OTATION MARK 0x00f3:0be, # VULGAR FRAC0THREE QUARTERS:4:6:PILCROW SIGN(5(%a7("SEZ (6(f(PDIVIS )7)6201DOUBLE LOW-9 QU87E00b00DEG ^9'E2219'BULLET OPERATORa+600bMIDDLE DOT&b&QSUPERSCRIPT ONE+c+3|+-d-2-&WO+e+625apBLACK Sf('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (}d'\x00'Yp00 -> NULL!1!1!START OF HEADING-2-2-2TEXxx3*3*0ENDU (4(4(pRANSMIS5050UQUIRY$6$6$ACKNOWLEDGq7(w7 -> BE8!8!2ACKY2'\t$ c9&HORIZONTAL TABULn2a2LINE FEED&2x0b(#+ 0b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETUR=!e.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROLJ'\x11 /T/ 1 /u11 12FOUa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2R BLOCj 1UCANCE )191YeMEDIUMa*SUBSTITUT 1  1ILE SEPAdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"021 -> EXCLAMATION MARK '"'# 0x0022 -> QUOT+#+3+NUMBER SIGNS$(4(XDOLLA(%(5(wPERCENTQ&)6)AMPERSANDw0"'"7&POSTROPHE'-'(M8'LEFT PARENTHESIS-)-9-ORIGH.*.a.sASTERISq+%b%GPLUS,&c&RCOMMA-"d"HYPHEN-MINU.)e)FULL STOPO/&f&TSOLIDJ0$ 30$DIGIT ZEROK1'1'#ON2&yM#TWL3&t&3HREN4(tBFOUR5'sO3FIVN6'q'2SIXM7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33L31LfM3fM3N33O33-P35'LATIN CAPITAL LETTER P 'Q' # 0x0051 -> LATIN CAPITA3Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1.c0REVERSE SOLIDU]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1" 1L1m11M1n11N1o1O1p17bq1r1s1Pt1"u1 v1 w1 x1y1z1a -> LATIN SMALL LETTER Z '{'# 0x007b -> LEFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%f"TDELET#Pu0106%# 80#LATIN CAPITC WITH ACU>0xfc<$ >1>6SMA=U<DIAERESISJ\xe9@2@E@|1>|3<A<eMACRONy4;4= Pu0123B}5@G}uCEDILLA~5<~6>RING ABOV7C7AXu0142<8<LWSTROKy19= uIu015la= lR| 7@ z n>(2b >I| 7q= Z?+xcn> p+xc2B 4!xcu9 e>IGATURE A-+xc45 6d9Oi +xfs= h9a>'CENT SIG~a fS>9<+xd  z"*xd9 f8$ !xa=XPOUNDb+xddf'\xd7' # 0x009e -> MULTIPLICATION SIGN '\xa4' # #0f0CURRENCY*Pu0100,* a0*LATIN CAPITAL LETTER A WITH MACROiXu012a?1?I?0xf3= &a2?ESMAL|O=SACUTEPu017b>3< Z>DOT ABOVBcB4B ~@ 5@ H201d|6<RIGHT DOUBLE QUOTCMARK0xa66278BROKEN BAR'9'8'BCOPYc ,e+9+REGISTERED.!xa0~a,9NOT%b%b%VULGAR FRACONE HALFbZc5dQUARTEPu0141d8L ST-waCYLEFT-POINTING?ANGbFojGHu259bESHADG2592bu|MEDIUM )ab_LDARK'0PJBOX DRAWINGS LVERTICAL=Au252h_@8P AND ]A9010AA }TOGONE 6DC)CA(18FJ>E> }1}b? 9256y ? x @92551B yH25579ODOWNw>-UP<1012p<1 v6bS 9251> 1c=p3<<HORIZONTk '\u252c' 4# 0x00c2 -> BOX DRAWINGS LIGHT DOWN AND HORIZONTAL '\u251c' C3CVERTICALGRVB(00B4B|(3c:5: |GH0172G6GLATIN CAPITAL LETTER U WITH OGONEKH016a?7? dMACRON?9255?8? DOUBLE UP<(54|9= {(69?a?|<H2566BbBD cD  5CdC~ Ee; ~HH017d fHFZF'CAG0105>&d0>ESMALA< 0{/d1=C= y1d yE< y(17=DOT ABOVEH012f@@I}(61==S= (73< b== H017e=%H2518<DLEFTj8250d; _8yFULL BLOC 8258dLOWER HALF- ,9d-8-?UPP!xdex OGSACUTEV!xd>ySHARP S (GERMAN)@Hu014e}~ L4|e ?Nxf5' # %0x00e4 -> LATIN SMALL LETTER O WITH TILDE '\xd5' A # <5<oCAPITA> b>6>MICRO SIGNePu0144ge7'NDACUTXu0136<8< K>vCEDILLA|(37@9@ >b>a> ~L~c@b@ ~>4c>8 (12|d> EXMACROe?H2019f@ RIGHT SINGLE QUOTATION MARK0xad6  f08SOFT HYPHE:xb1(1(PLUS-MINUS8201 f2,LEFT DOUB*bec37VULGAR FRAC@THREdARTERSbxPILCROW!xa)"SE\E+xf)lPDIVISB*Au201fo_LOW-9z*b0k0DEG `2fSBULLET OPERATOR AMIDDLE DOT'+(SUPERSCRIPT ON:xb3,ZZ .#WO,Au25a9BLACK SQUAR'UNO-BREAK SPACE ) ### Encoding Map e_map = {zy100:400,FNULL 1 1 START OF HEADING,2,2,2TEXuu3)3)0ENDS '4'4'pRANSMIS5/5/VQUIRY#6#6#ACKNOWLEDGf7'7'(BE8 8 2ACKGE9%9%pHORIZON@TABU1a1a1LINE FEEDb%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE RETURe+e, # SHIFT OUT 0x000f:, # SHIFT IN$"10$%10$DATA LINK ESCAPE,1,1,EVICE CONTROL ON.2.2.6TWO\3.3.7HRE^4040FFOUR_5/5/NEGATIVE ACKNOWLEDG_6060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCK8585fCANCEL"9"9"WfMEDIUM)a)a)SUBSTITUTb&b& c"c"FILE SEPARATONd*d*_GROUP+e+e+oRECORD,%1f,OUNIT*22FSPAC22EXCLAMAT6MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2AMPERSAND22APOSTROPHv2vLEFT PARENTHESISR2ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZER3p3p&3i3i% 3d3d% 3d3d 3c3cM6FIV3a3a&5SIX+3a3a%6EVE3b3b'E<N]3]''NIC3V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL A4l4l# LATIN CAP ITAL LETTER A 0x0042:, # LATIN CAP2B23232 C24242 D25252 E26262 F27272 G28282 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q2 /522 R2 5  S2 5  T2 5  U2 5  V2 5  W2 5  X2 5  Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5fOW LIN66\GRAVEL66OSMAL66 066 066 066 06 0 66 0 66 066 066 066SMALL LETTER K 0x006c:, # LATIN SMALL LETTER L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKEN%7c.VERTICAL LINEW7ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*9CENT SIGXa9[POUND&9uCURRENCY)Wa'BROKEN BA aMf{SECTIONNaEBCOPYb aYLEFT-POINTING DOUBLE ANGLE QUOTAo6MARaaT,NO0fXSOFT HYPHEWaREGISTERE\bjDEGREE bfPLUS-MINUS+fSUPERSCRIPT TW'bf +6HREQbdeQ[MICRO~f{PILCROW(nMIDDLE DObfOb*bVULGAR FRA ONCFARTEba7EHALF=b%f 4T1 QUmc8PCAPITA WITH DIAERESIA8f, # LAT IN CAPITAL LETTER A WITH RING ABOVE 0x00c6:092,x # LATBIGATURE A59505wEwFACUT="d3=e= O=5=5z =GTILDz9=DIAERESIS-"d7~%9eAMULTIPLICATION SIGN/8/d/ \'WSTROKc>a> U(fA+e1AESMALSHARP S (GERMAN)"e4?/84? Z~e/86?eIe8 fa;  fe( ; f;cffc]DIVISfb  f82100Fa HUMACROB2101>/83 <b+ >dOGONEK#10d L<8< C O#10/87 ;bp=)CAkdkd ;"12;e z 1{8 j<j+b8- j>:DOT#11nda ?Yb d1du } <2t9# LATIN CAPITAL LETTER G WITH CEDILLA 0x0123:@085, # LATIN SMAL=a=+a1=8CAP|I|fMACRON{b>+8c> {<e<+bd<zfOGONEKzf>+d4>z <"36<+e8< zK p#37?9? {=2+ea= |L|c|b? |="41=ar ?eSTROKEr"42>86{ <+e3 NGACUTy4y+e7= y;5;e;x 4) z =2| O Z"4d92 <58d Rz 58d =P9 rS| 59c ;"600b =(CA6dB ;c U 6d> <7/c6` > 7d>z <9l8H Z 71al ;.a \=DOT ABOVJ7a5 ?/cfr A d7d ;H CARON 0x2019: 0x00ef, # RIGHT SINGLE QUOTATION MARK #7c7%f27LEFT DOUB6d6%a66m7 e7%f771_LOW-92%f97BULLET OPERATOR2500b&c4+OX DRAWINGS LHORIZONTAL929/b39 hVERTIC7?/da7 DOWN ANDt1bB=<4/c0y /UPw8;dOw; uc%{2b fA 22 3/c18@5@ F5/cdF:1bq:058m>7vb > "5a=/c8= q yi/bc< w6d; *m }"63b4 B 6Ac76c =AeB G8NdUPPER HALF BLOCT#58ldz?LOW,#LFULLRd0i}9,ME!USHADE94{MEDIUM (0KDARK&af1BLACK SQUARE } """ Python Character Mapping Codec generated from2 'VENDORS/MICSFT/PC/CP850.TXT' with gencodec.py. """#" import cs ### C APIs class(=!s.): def W(self,input,errors='strict'):,0creturno.charmap_B=,ing_map)m dem)B mmdtable)IncrementalE<r  h final=False*W.Q ?[0]D ~eL!@OStreamWriter(J,8cs.5pasORead9 9Fs module getregentry(7 UInfo(name='cp850',d!e=02(). id:.r=]/J //spr7=D #w##)Zping MapA0codTmap =make_identity_dict(range(256)) 5.update({F0x0080: 0c7, # LATIN CAPITAL LETTER C WITH CEDILLA?1?+fc?ESMAL=U=DIAERESIS?2?/e9? E?VACUTE;3;2; A;CIRCUMFLEX@4@4@5?0?GGRAV6;5;RING ABO@7@  t8=a} r79@b@7a?8? 7b;f; Izc?e?d@c, # LATIN SMALL LETTER I WITH GRAVE 0x008e:0c4,` # LA;eCAPITA=A=DIAERESISAfA5ARING ABO#90B9B EFACUT"91=+e6=IGATURE A323c3535f(hcOCIRCUMFLEX'#94@ u@f#95?2  #96;b; U7@  @ {8;f{ Y{9?d4 AaAc AAbA+f8A WSTROKgc<%a3<POUND SIGNd&db d%d7dMULTIPLICATIONm/19F FEHOOKa%e1i' % ad;  ;fCv ;av  ; N&FTILDad; =aFEMININE ORDINAL IND&ORb6oMASCUL7 bINVERTED QUES=7MAR%aeRREGISTEREaxax:NOTa[bVULGAR FRACONE HALFSbX4gQUARTE#dabEXCLAM, [a7EFT-POINTDOUBLE ANGLE QUOTEq&0bEORIGHFb}6259LFG SHA}b1: 0x2592,  # MEDIUM SHADE 0x00b2: 0x2593,(LDARK&3&%02& BOX DRAWINGS LIGHT VERTICAL]47/247 AND LEFT@5@E00c1@LATIN CAPITAL LETTER A WITH ACUT6== CIRCUMFLEX7B0GGRAV8=%a9=QCOPYR*FSIGNg9*6256 ]eDOUBLE^'aA5'A yb878ODOWNuc=d= /UP;d;600aZCENT e%5`;YEN$f$6251 #c0< 8"c1;3;HORIZONTct%2c B1B  0: z?253zFeLSMAL7TILc ; =O255azk5<n q6 >z3/66 C67 ?255B |?2568|G600aCURRENCYd600fb5ETHd<00d2 Y 4600cPf 4ddE00cbB DIAERESISL00c8AAPITAL LETTE R E WITH GRAVE 0x00d5:@131, # LATIN SMALL LETTER DOTLESS I868;0cd8eCAPITA:IuGACUTu7=e=CIRCUMFLEX8BfBDIAERESISA9AE2518ABOX DRAWINGS LIGHT UP AND LEFT:a:/0c: ADOWN<RI=b=8wFULL BLOCK&c&4cLOWER HALF,d,E00a6,BROKEN BARRe&c $f=E2580c?UPP e0,E00d3,iO#e1=  fSHARP #e26. sN#e3B2 "e4=+f5= }FTILDe},0d; =b=MICRO SIGNekfk GTHOR4]d4 6RK00da 6UUO00db=ZO00d9B q<00f &Yd; =aWMACRO|600bLf ACCENfxaSOFT HYPHEOfbbPLUS-MINUS:fWE2017QDOUBLE LOW LINf@b1VULGAR FRACTION THREE QUARTERf=b{PILCROW*a"SEZ ff(PDIVIS )buCEDILLA;fb0DEG JaJofb`MIDDLE[rbSUPERSCRIPT Osbh+o 0x00fd: 0x00b2, # SUPERSCRIPT TWO #fe: 0x25a0+BLACK SQUARE(f('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'@ # 00 -> NULL!1!1!START OF HEADING-2-2-ETEXT*3*3*0ENDU (4(4(RANSMISSIONX5050UQUIRY$6$6$ACKNOWLEDGq7(w7 -> BE8!8!2ACKY2'\t$ c9&HORIZONTAL TABULATn2a2LINE FEEDb(b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETURme.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /J'\x11 /6HRE` 1 1DFOUR11NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE )191YeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&) AM"AN0"'" *2APOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&COMMA '-'  # 0x002d -> HYPHEN-MINUS '.')e)FULL STOP&/&f&TSOLIDJ0$ 30$DIGIT ZEROK1'1'2ONE&2&2&#TWL3&3&3HREN4(4(BFOURu5'5'#IVN6'6'2SIXM7&7&BEVEN(8(8(REIGHT(9(9($NI9:'a'CCOLOq;"b"GSEMI&<&c&LESS-THAN SIGQ=+lgEQUALS(>(k|GREATERV?.sQUESTION MARK@*4yCOMMERCIAL ADA*|LATIN CAPITAL LETTER A]B33B3C33C3D33D3E33F33FfG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33tO33-P35'3Q30QR30wS30T30U30UV30V3W30W3X30\Y3 0PITAL LETTER Y 'Z'# 0x005a -> LATIN CAPITAL LETTER Z3[3b3EFT SQUARE BRACKET0$\\1cc0REVERSE SOLIDUS,]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)1)<ESMAL:AZb121B1c131C1d141D1e151f161Fbg171G1h181H1i191I1j1 J1k1& 1K1l1L1m11M1n11N1o1O1p17bP1q1Q1r1R1s1Pt1"u1Uv1V1w1W1x1X1y1z1{1ZCURLY|/`VERTIC`|}*RZ~0CTILD3\x7R7UDELET#"c7H#8 C WITH CEDILL3\xf@U>DIAERESIJ\xe9E@6ACU*e2<A WITH CIRCUMFLEX '\xe4' " # 0x0084 -> LATIN SMALL LETTER A WITH DIAERESIS@0@5@ UGRAVE<5<6< RING ABOA7A7ACuCEDILLAa>8>E>hIRCUMF<bA9A <8@a@ <f<b<I|e@c@ CcAdA cue<oCAPITAwc;fB =)c9/90CFACUT6>1>8IGATURE A4c4246f-&936jOfwA +*f2@ f#9U A } $9Y} d9 |B %9 B Bf$9}USTROKq*a3POUND SIGN dd fd9MULTIPLICATIONoAu019Rs9 FDHOOK)e1a ; d<2 <fIa x  < ga < N+ETILDd<a5 -> LATIN CAPITAL LETTER N WITH TILDE '\xaa'  # 0x00a6 -> FEMININE ORDINAL INDICATOR7b777oMASCUL8 fo88INVERTED QUESTION MARKk*ae393REGISTERED SIGN,c,a,9NOT%*bd%b%VULGAR FRACONE HALFZbZc5eQUARTE)*a1md8qEXCLAMAr b6e6LEFT-POINTING DOUBLE ANGLE QUOTFbFfFORIGHGAu259# b0GLGE SHAK(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS =CICALXu2524_48 P AND ]A!xc  b5AkLATIN RAREACUTRc>R> CIRCUMFLEX0C^C EGRAV*a9>dACOPY Iu256\ cgd ,Au255.rB 9799ODOWNw>>,UP<+xa:CEN& a5;YEN@1b 1cX=>3<l<HORIZONT%cAC1C  0?c|3|  G!xecESMAL: :c<>C z5WINGS DOUBLE4 DOWN AND RIGHT '\u2569' # 0x00ca -> BOX DRAWINGS DOUBLE UP =HORIZONTALB6BbBD0DcDVERTICAL5CdC~c~e; ~ H0xa4FLfHCURRENCY SIGN4!xf* d0*LATIN SMALL LETTER ETH3d313oCAPITA5)ca/d25 WITH CIRCUMFLEXx*cbC3C DIAERESISB8B4B SGRAVE>Pu0131@&d5> +DOTLESS I90xcd7d69 1IDACUTw:xce>7> :fC8C :Au251<9B L7LEF0d; 8yFULL BLOCKcAu258LOWER HALF-!xa&ROKEN BART!xc' .1258(?UPP)d3e kO"de eSHARP d2euY*d2C#:xf5> <TTILDEd<2 >b>ZMICRO {e{ ETHORRd5m 7 !ebnU ee> ~jC  eHL LETTER Y WITH ACUTE '\xdd'  # 0x00ed -> LATIN CAPITAL LETTER Y W>*af>e>dMACRONa*b4#f#t ACCENT)a f0)SOFT HYPHEQ1Q f1(PLUS-MINUS SIG,Pu2017. f2,DOUBLE LOW LIN  be*  f3,VULGAR FRACTION THREE QUARTERS*b6;4;xPILCROW!xad5)"SE\+xf)6)PDIVIS**b8|7*uCEDILLA0$8$0DEGLaL9(vIAERESI a&MIDDLE DO*b9ub'SUPERSCRIPT O|3,c,x2.Z3TWO,Au25apBLACK S'NO-BREAK SPACE ) ### Encoding Map e_map = {zL100:T400,cFNULL 1 1 START OF HEADING,2,2,2TEXuu3)3)0ENDS '4'4'pRANSMISi5/5/VQUIRY#6#6#ACKNOWLEDGf7'7'(BE8 8 2ACKGE9%9%pHORIZON@TABU1a1a1V FEEDb%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUf%f%II1x1x@DATAvK ESCAP11DEVICE CONTROL11 .z.1 .N11 0FFOUR/1NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1tSUBSTITa1 c: 0x001c, # FILE SEPARATOR 0x001d:, # GROUP+e+e+oRECORD,f,f,OUNIT*"20*%20*USPACE#21!1!EXCLAMATION MARK,2,2,OQUOT*3*3*NUMBER SIGNQ4'4'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt7%7%POSTROPH8&8&LEFT PARENTHESISR9,9,ORIGH-a-a-wASTERIShb$b$KPLUSc%c%VCOMMA|%2d!HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZEROI3p3p&&ON~3i3i%'TWJd3d%7HRELd3d6FOU3c3cM7FIVLa3a&6SIXa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G242H242I242J242n44&Ldd: 0x004d, # LATIN CAPITAL LETTER M 0x004e:,/ #2N2f2f2 O2"502/502 P21212 Q22222 R23232 S24242 T25252 U26262 V27272 W28282 X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKE[c/c/REVERSE SOLIDUd+d+?IGH[%5e0CIRCUMFLEX ACCEN5uOW LINE66\GRAVEL66ESMALAX6 0B06 0C06 0D06 06 0F`6 0G06 0H06 0I06 0J06 0K06 0L0606606677`77 77 77 977  77 77 77 W 0x0078: 0x0078,  # LATIN SMALL LETTER X (9090 Y0a0a0 Z0b0b0EFT CURLY BRACKET.c.c.VERTICAL LINE)d)d)ORIGHXe/e/GTILDPf!f!VDELET""a0"f"NO-BREAK SPAC*1*a INED EXCLAMATION MARK"a25b5CENT SIGN%3%9[POUND&4&cCURRENCY)5)b;YEN$6$dBROKEN BAR7&%f5?1SEC 8(nDIAERESISMbBCOPY O%a6w FEMININE ORDINAL INDICATOaLEFT-POINTING DOUBLE ANGLE QUOTa,NO%f0SOFT HYPHEaREGISTEREeVMACROMb=jDEGREEb%f1PLUS-MINUS+fSUPERSCRIPT TWObf +6HRE'beACUTE ACUe[MICRO&f4kILCROW(MIDDLE DOb7NvCEDILLAfObNPMASCUb!bVULGAR FRA ONFARTE%ba7FHALF%f36 4T1 QUmba3AQUESJ 0cbTPCAPIT/A WITH GRAV{cb= cb= CIRCUMFLEtc'cTc78LATIN CAPITAL LETTER A WITH DIAERESIS 0x00c5:08f, # LATIN CAPITAL ARING ABOVEB6B/92BIGATURE A575/805CvCEDILLAt8?/d4? E?8GRA9=9| =GACUTa=d=CIRCUMFLEXbB3cAeA Id=6= e=7=fB8B#d0A1A 5ETHr"d14/a54 N1FTILD"d2=e O= k#d3=k = n#d4=k =nde B 96 =9MULTIPLICATION SIGN/9dpWSTROK/eb> Ue = /eaz9Bje; Y e GTHOReESMAL6fSHARP ne8 6 Ke K; e8;ec4@ Ee8;e8zE 0x00e6: 0x0091,  # LATIN SMALL LIGATURE AE +"e73/873ETTER C WITH CEDILLA=8=a= E=GGRAVx9;2;GACUT;a;8;CIRCUMFLEXb@9@DIAERESIS?c?d? Id;am; e;/8cvf@b@"f0?/d0? 5ETH'"f12/a42 N'FTILD"f2;/95; O; W"f3;aW ; b"f4;/93vb"f5@e { 6;9;%f6DIVISION SIGN9 WSTROK9) UaZ ; 9 2;r @Zev Y e0 GTHOR9 o #13sd8 DOTLESS I$19pf@eFCHOOK:4201zoDOUBLE LOW LIN@3250BcBOX DRAWINGSHT HORIZONTALd#50b>9hVERTIC7d7DOWN AND RIGHTt1b= 7LEF<Hc+</UPwd;u0x251c: 0x00@c3, # BOX DRAWINGS LIGHT VERTICAL AND R -0x2524: 0x00b4AFLEFT@c@/c2@ ADOWN}HORIZONTALB3/c1B /UP@5@ #50dFDOUBLE :1:/ba: 598 ; #57vb> "5a=/c8= t yd</bc< w6d; * }#63}4 B 6Ac7#69C =AeB G8N%dfGUPPER HALF BLOCKl8ldz?LOW,8d#KFULLR90~lUSHADEy"92Mb{MEDIUM (GKDARK&af:XLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP852.TXT' with genc;P.py. c#" import ccs ###`APIs class($.1): Qdef eW(self,input,errors='strict'):,creturno.charmap_B=,ing_map)m dem)B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~eL!@OStreamWriter(J,codecs.StreamWriter): pass class StreamReader(Codec,c(s. 9### encodings module API def getregentry(7sreturn XeQInfo(name='cp852',d!e=02(). deQincremental:6r=IE/er/J /Dl/s7r7=*R#wy##0) IZping MapAWd_map =2make_identity_dict(range(256)) 0ing5.update({F0x0080: 0c7,k # LATIN CAPITAL LETTER C WITH CEDILLA?1?+fc?ESMAL=U=DIAERESIS?2?/e9? E?VACUTE;3;2; A;CIRCUMFLEX@4@4@5??16f? RING ABOV6@0x 9v 7;/0e; 8=/147 L7WSTROK9<?0eb 3a?;150? kO}{DOUBLE bD1D 7B cB?0eeB I8d@,17 ZB e=,0cu =DfA;106 A99  9/13= ; =;13a ;f3 ;9f2@q9+3d qUCARONd93l ;,152 xSg95R S WITH ACUTE 0x0099:0d6, # LATIN CAPITAL LETTER O WITH DIAERESISAaAcA UAbA?164A TAVCARON~c=5=ESMAL;d;+41; LxWSTROK8e>50d7>MULTIPLICATION SIGf/510d/g Ck !a0;,0e ;A;7ACU#a1;v I;2;/f3  v3;a;  ;4;/10  eOGONEK #a5>  <6<7+ Z- 7=e ;8;+18; xEx ;119> <a:NOTa7  0_ /5f SvCEDILLA&ab=EFT-POINTING DOUBLE ANGLE QUOT7MARL&0bEORIGHFb7259FV SHADMbE2592lMEDIUM(6259LDARK&6250NBOX DRAWINGS LVERTICAL7b|6252|7 AND LEFT@~'0cJ .b&0c.=CIRCUMFLEX1 p  b5 =rb6256 ;qs<6255<A 62558DOWN AND LEFT  0x00bc: 0x255d, # BOX DRAWINGS DOUBLE UP AND LEFT ';d;E017b;LATIN CAPITAL LETTER Z WITH DOT ABOVEAeAcAOSMAL?f?E2510? LIGHT DOWN#c0<4< RI"c1;3;HORIZONTAL@2@2 B3B1B VERTICAL 4A0: z593zF6FE0102}9A97BRE5#c7=3= 5;8;E255a; z  39<<n >a>/69z3bA6A C67 ?255B |?2568|G600aCURRENCY SIGNddE0111/b %D`VSTROKd'01W< >K010ez>GCARO?00cR EDIAERESISK010f~ |K0147; N| =&0cF4I=GACUTq/0c3 =CIRCUMFLEX<0118 6 %18 E  d0: d8wFULL BLOCK8LOWER HALF,?016U ER T WITH CEDILLA 0x00de:@16e, # LATIN CAPITAL LETTER U WITH RING ABOVEBfBE2580BUPPER HALF BLOCK, e0,E00d3,nOnFACUTi#e1=f=ESMALvSHARP Ss2646 sCIRCUMFLEXB3B/14 N4=  ;5;8;VCARON6;6hS =7=1x ;8;5 mRx 9=;0dax = =a=;155= -xb;7- x{DOUBLE cD?0fd Yd;d; =  Tx*CEe600bu ACCENTNfaSOFT HYPHEuf2, V52db3VOGONE.fy52c7" f]&2d"7BREfC&0aBSECTION SIG0&0f(^DIVIS)&0br Vf&0bOkDEGREEsaJDIAERESIf52d9;DOTf  f&15/? &15= ;625a+BLACK SQUARf(NO-BREAK SPACE }) ### Decoding Table d _tA = (d'\x00'00 -> NULL!1!1!START OF HEADING-2-2-2TEXNx3*3*0ENDU (4(4(pRANSMIS5050QUIRY '\x06'  # 0x0006 -> ACKNOWLEDGE '\x07' (7 -> BELL!8!8!tACKSPACGt$o9&HORIZONTAL TABULATIONXn2a2LINE FEED&2x0b(b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETUR2x0e.e,SHIFT OUTf&f&IK)10% 10%DATA LINK ESCAPR:x11-1-EVICE CONTROL ON/2/2/4TWO*13/3/6HRE`4141EFOURa5050NEGATIVE*161SYNCHRONOUS IDL 1 END OF TRANSMISSION BLOCK 1UCANCE*19YeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+ Z2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAN1"'"HAPOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ>b3{DIGIT ZER8''2/&y&)&&t& (t'sO3FIV$ 'q'2SIX3&qDIGIT SEVEN p '8' # 0x0038 -> DIGIT EIGHT -'9(9(BNINE':'a'RCOLON";"b"GSEMI&<&c&LESS-THAN SIGQ=+d+gEQUALS(>(e(|GREATERV?.f.QUESTION MARK@* 40*COMMERCIAL ADA*1*LATIN CAPITAL LETTER A]B323B3C333C3D343D3E353F363FfG373G3H3eH3I33I3J33J3K33[L31LfM3fM3N33tO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&R]^1$CIRCUMFLEX ACCEN_.EOW L+`%6YGRAVENa)LSMAL5b1N SMALL LETTER B 'c'# 0x0063 -> LATIN SMALL LETTER C1d141D1e151E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s1S1t1T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LIN^}*ORIGHZ~0CTILDR3\x7C7UDELET#"c7H#8PCAPITh WITH CEDILLA3\xf@U>DIAERESIJ\xe9E@6ACU*e2<A<CIRCUMFLE-J\xe4A"A Au016b1RING ABOV~Au010AACA :$ <L< Au014>>YLzTSTROK:xeb8e8 50B}008a -> LATI LATIN SMALC0xeeACcCICIRCUMFLEX 79CdA ZC0xc4<e>A>DIAERESIS 06DfBCB /90>E>Au013@|/91>L>a&92> <*xf8/93<= !xf54A w(3d5@ VCARON3x96> <577< zSu(5b8> z<+xd49< zw 60xdc|vaBU BAu016: TB < 65><4m9TSTROK0xd7yMULTIPLICATION SIG#0a !xela <T ev< < <)f3a <x<Hu010a fOGONEK0a =72Sa |Hu017 a {< 18pz z 1a {=*xaa;NOT7 bZ WITH ACUTE 0 '\u010c' # 0x00ac -> LATIN CAPITAL LETTER C WITH CARON >(5f>d>ESMAL<S<cEDILLA>0xab<|e>EFT-POINTING DOUBLE ANGLE QUOTATION MARKFbFfFORIGHGPu2591  b0GLGc SHADEo(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS VERTICAL(24_48 AND LEFTA!xc~ b5AADACUT!xc>6> CIRCUMFLEXXu011a7CE {e>8>}Iu2569@ x|y AAu255C2aB H2557b9ODOWNwd>-UP<1017. ZsDOT ABOVHu0170b0 @H2510 1c=u3<<HORIZONTqcAC1C  0?c|3| G)01c8BRE>0uc >r <8255/c 5 w'69c|8H2566BD  \u2550' # , 0x00cd -> BOX DRAWINGS DOUBLE HORIZONTAL '\u256c' # ;e;VERTICAL ANDH0xa4FHfHCURRENCY SIGNr@0111,r d0*LATIN SMALL LETTER D WITH STROKE=0=1=oCAPITA? (0e?2? DCARO0xcb</d3>EDIAERESIS 0fD4B~Xu0147<5< N~>0xcd<6>I>DACUTw!xc6>7> CIRCUMFLEX1?8C ;Pu2518<9< LIGHT UPDLEFTw8250/da;ADOWN=RJ>8yb>FULL BLOCK'c'LOWER HALF-H0162 TtCEDILLAm1016m@U@RING ABOVIu258F?UPP0xd3e Op :d> dSHARP )!xdP7uq4(e0n><6e < 8016eSn >\e z<5 Rz0:xda& >Pu0155@n> zIu0172<  *xfeY <>Iu016  xb4' # 0x00e f -> ACUTE ACCENT '\xad' # 0x00f0)SOFT HYPHEN(Au02d*(1(PDOUBLR X0bZ020fOGONEKS(c7#3#HCAROu8"4"SBREVED!xaB 5"SECTION SIGK+xf)6)\DIVIS*bsS7*tCEDILLAw b0$8$iDEGREEvaL9(IAERESISN,9P,a&eOT ABOXu0171&b& LATIN SMALL LETTER U WITH i!15icCeCAPITAERE )15d> <125a3ze<BLACK SQUAR'ZNO-BREAK SPACE ) ### Encoding Map e_map = {100:400,FNULL 1 1 START OF HEADING,2,2,2TEXVu3)3)0ENDS '4'4'pRANSMIS5/5/VQUIRY#6#6#ACKNOWLEDGf7'7'(BE8 8 2ACKGE9%9%pHORIZONJ@TABU1a1a1LINE FEEDb%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE RETUR(e+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .5TWOP11 .7HRE^1 0FFOUR_1pNEGATIVz11SYNCHRONOUS IDL1FR BLOCV11VCANCE11WfMEDIUM1SUBSTITUT1 1ILE SEPARATON1_GROUP+1dRECORD,OR 0x001f: 0x001f, # UNIT SEPARATOR ""20*%20*VSPACE!1!1!EXCLAMATION MARK,2,2,OQUOT*3*3*NUMBER SIGNQ4'4'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt7%7%POSTROPH8&8&LEFT PARENTHESISR9,9,ORIGH-a-a-wASTERIShb$b$KPLUSc%c%VCOMMAd!d!HYPHEN-MINUe(e(FULL STOPMr2rWSOLIDH3k3kDIGIT ZEROI3p3p&&ON~3i3i%'TWJd3d%7HRELd3d6FOU(3c3cM7FIVLa3a&6SIXa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G242H242I242J242n44&Ld4dM2 4 244 LATIN CAPITAL LETTER O 0x0050:, # LATIN CAPIT2P21212 Q22222 R23232 S24242 T25252 U26262 V27272 W28282 X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKE[c/c/REVERSE SOLIDUd+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE6%60$\GRAVEL66ESMALYAX6 0B06 0C06 0D06 06 0F`6 0G06 0H06 0I06 0J06  0K069 0L060M060N0677`77 77 77 977  77 77 77 77 77 707a, # LATIN SMALL LETTER Z 0x007b:, # LEFT CURLY BRACKET.c.c.VERTICAL LINE)d)d)ORIGHXe/e/GTILDPf!f!VDELET""a0"f"NO-BREAK SPAC*4*c*CURRENCY SIGN"a7)%f5u{SECTION(8(9(DIAERESISMiai -POINTING DOUBLE ANGLE QUOTAjFMARKE%aaj;NOT{%f0$SOFT HYPHEb08'jDEGREENb-e-ACUTE ACCENb7OuCEDILLAbK"c1mbPCAPITqA WITH #c2=6= CIRCUMFLEXB8`cU8C E"c99? E? /d3 =\d@ I~d#=}"d3e Od/e2 =69B?d9=MULTIPLIC "dapep U+9+=eAY~+e1m fSHARP $ea 6e8;e/84 {-e8 e8 = e8# SMALL LETTER E WITH DIAERESIS 0x00ed:0a1, # LATIN SMALL LETTER I?VACUTE;e;/8c;CIRCUMFLEX@"f3@/a2@ O{"f4;/93;{6@4@5"f7?%f6?DIVISION SIGNa)a Uc;8 ;e Yz2102zceCAPITAA=EBREV#10%c7= P;axdOGONEKk2105/a5y <+8f< zC #10 8/ ;axECARO\#109x ;dz xD =fid x;#10; xVSTROK[#11>0y <8<+a8< z( #19>9> z<bz l"1bydy ;39l L 39! x;  = 9L ;4+9dx 48i y <e zNj4eN ;ydjAL LETTER N WITH CARON 0x0148:@0e5, # LATIN SMALL LETTER N ;"50;+8a;eCAPITA=O=DOUBLE ACUTE#51DbD B 4B+e8B R 5= ;9/fcx v"59x+fd=x ;a;+97; Sb= - x;e;b;xvCEDILLAf?a z =6j/e6 16ce1 ;2d Tl 3?+ee z=9| 69z ;d xURING ABOV68S @7 BX7fD B 8 Z X7a ;bx;DOT"7cvb |?d?al A 17=al ;22c7x%f3- \$2dq4!6BREx#2df #2d_%f2FdOGONEK#2d%f1"cs ACCENT/3250c OX DRAWINGS LIGHT HORIZONTAL9]bB9hVERTIC7d7DOWN AND RIGHT 0x2510: 0x00bf, # BOX DRAWINGS LIGHT DOWN AND LEFT (b0x2514</c0< !UP:RI;8;/d9; uc:/c3: VERTICAL{2/b4A 22@ 2HORIZONTAL3/c1B 8@5@ F5/cdFDOUBLE :1/ba: 5r; 3#57vbv > "5a=/c8= t yd</bc< w6d; *#63}4 B 6Ac7#69C =AeB G8NdUPPER HALF BLOCKl8ldz?LOW,#KFULLR9USHADEy"92-b{MEDIUM (GKDARK&af:XLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP855.TXT' with genc;P.py. c#" import ccs ###`APIs class($.1): Qdef eW(self,input,errors='strict'):,bcreturno.charmap_B=,ing_map)m dem)B mmdtable)IncrementalEr  h final=False*W.Q 7[0]rementalDeco der(codecs.IncrementalDer): def d (self, input, final=False*.preturn Acs.charmap_@:F.errors,ing_table)[0] class StreamWriter(C,UzJpass90Rea9 9 ### encodings module API getregentry(7 eQInfo(1name='cp855',d!e=02(). i:'r=E/er/J //spr7=c* #w##0) IZping MapAWd_map =make_identity_dict(range(256)) map.update({F0x0080: 0x0452,k # CYRILLIC SMALL LETTER DJE51505oCAPITA727/53l Gl3505 l 747/51l &IO5404 k666/54j UKRAINIAN IK7>0> t@8@/55~ 'DZu9505 u 7a7/56l BYELORUSSIAN-jbJ0J LcL/57 &YId404 6e6/58j f404 j699j L55 k 7al Nl5 l 7bl 6TSH96 m 8cn K5 mKJE 0x0098: 0x045e, # CYRILLIC SMALL LETTER SHORT U %q0x0099:909oCAPITA;a;/5ft FDZHEqb606 q 8c84 Yd424 l6e6/4a HARD SIGNf;2; q="a0=/30x Ap"a1313 p525/31h B"a3414 i646/46j 'TSk5525 k 767/34l Dk7414 k686/35j Ijg14 j6b4 &EF`24 j6^/33 Ga_15 k 7`50ablLEFT-POINTING DOUBLE ANGLE QUOTATION MARKj&0bEORIGHFbs6259LFG SHAbgE2592lMEDIUM(Z6259LDARK&L6250NBOX DRAWINGS VERTICALbM'257P AND W@X4 MH+bU24 6W%38/IT13 i5U6256o HJ`6255A dE25578ODOWNukO255d= /UP;q#39; CYRILLIC SMALL LETTER SHORT I 0x00be:@419, # CYRILLIC CAPITA;f;E2510;BOX DRAWINGS LIGHT DOWN AND LEFTw#c0<4< !UP:RI;1;3;HORIZONTAL@2@/2c{ B3B1B VERTICAL4A0: z593zF6FE043aS-&KA67414 (68662556 #DOUBLE 9<< &a>6z%bA6%ACcC) dB5B |?256*|G600aCURRENCY SIGN dE043b/TEd?0414 T6'04jM'044 j6O043d ?0414 j6ej O3 i5O043fh &PEi%184  d0:B d8wFULL BLOCKc8LOWER HALF,M?041 2I?0446 -Y-d66258?UPPe92` be;4b LETTER ER 0x00e2:P420, # CYRILLIC CAPITAL LETTER ER "636.416FSMAL4S44424 j656/42j &TEj6424 j676/43j Ui8323 i595/36h 'ZHa515 j 7b73  Vkc414 k6d6/4c SOFT SIGNFe;2; q=f='21jNUMEROd f0'E00adLVHYPHE!f1'544b' 06YERfD6 8F/37n ZfF14 l6F8j 5SHAfG5 k 7HkDH3 j5H/49CJ27 l)SH9L4z CfM25 n 7N&0a7{SECTION;625aBLACK SQUAR,&'00(NO-BREAK SPACE }) ### Decoding Table d _tA = ( `'\x00'" #I00 -> NULL!1!1!START OF HEADING-2-2-ETEXT*3*3*0ENDU (4(4(RANSMISSIO5050UQUIRY|6$6$ACKNOWLEDGqL7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZON`TABULAn2a2LINE FEED '\x0b'  # 0x000b -> VERTICAL TABULATION %`'\x0c' 0c0FORM FEED&r$Vd&CARRIAGE RETURRe.e,SHIFT OUTR:x0f&f&IK)10% 10%DATA LINK ESCAPER*11-1-EVICE CONTROL ON/2/2/5TWO^3/3/6HRE`4141EFOURa5050NEGATIVE ACKNOWLEDGa616 -> SYNCHRONOUS IDL-7-7- END OF TRANSMISSION BLOCK8686eCANCEL#9#9#YeMEDIUM*a*a*SUBSTITUTb'  1ILE SEPARATOVdN_GROUP, 1oRECORD- 1LUNIT+ 2CSPAC!"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSANV1"'"yAPOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ>b3{DIGIT ZER8''2/&y&)&&t& (t'sO3FIV$ 'q'2SIX3&q&3EVE(r(EKP(m($NIk:3f4COL;"cGSEMI&<&cLESS-THAN SIGN C'='  # 0x003d -> EQUALS SIGN -'>(e(GREATER-THAN.?.f.QUESTION MARKX@* 40*COMMERCIAL AT*A*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353E3F363F3G373G3H383H3I393I3J3a3J3K3b3[L3c3LfM3dM3N33LO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.cOW LIN`%6YGRAVENa)LSMAL5b1 13c1 11d1 1/e1 1f1SMALL LETTER F 'g'# 0x0067 -> LATIN SMALL LETTER G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t141T1u151U1v161V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LINEY}*ORIGHZ~0CTILDRB\x7f%7TDELET#Pu0452%#8CYRILLIC'DJ6066PCAPIT 8(53n8  n 66 nG8(51n8 nIY\u04055 m7(54l 7 lUKRAINIAN IQ ?? vA(55)A (DZw 6.6 w 8(56n58 nBYELORUSSIAN-p KOK M(57mM Y 5x5 7&58l08e -> CYRIL&LIC SMALL LETTER JE '\u0408' # 0x008f -> CYRIL5oCAPITA7'597)907 lLm 616 m 8(5an28 nNn 636 n 8(5bn48 n8TSHJ 757 o 9(5cp69 pK 676 o 8(5en88 nwSHORT U+ :9: r <(5fva< v)DZT 7b7 s 94c9 pY25d5 n74he7 lHARD SIGNT2< >'30VaAr14 6(31jB15 7(46l m26 8(34n~D515} 7(35l|Il 5w 74r&EF25p 7(33nG16o 8!xagapLEFT-POINTING DOUBLE ANGLE QUOTATION MARK+xbFzORIGHGHu259bLGF SHAG2592#bwmMEDIUM)bjLDARK'0P\ BOX DRAWINGS LIGHT VERTI6CAL '\u2524' # 0x00b4 -> BOX DRAWINGS LIGHT VERTICAL AND LEFT AH0445A5A CYRILLIC SMALL LETTER HAv9042565oCAPITA7(38l77 lIk1484 k6H2563j96 oDOUBLEH2551BaB H25579b9MDOWNH255d>c>-UP<H0439<d<eSHORT /9041:e: e <H2510vf< k1/c0=Ri3<1< HORIZONT<c/c2AC1C3C  0?c|3|y |GH043a  K15  1792557 5 i6c|*H2566*D   5CE~ 3; ~ H!xavcCURRENCY SIGNG043b4dE904155 ^7 d7 &EM d5 l73d7 l 155 l73e' # 0x00d6% -> CYRILLIC SMALL LETTER O '\u041e' # 0x00d74oCAPITA6(3f686 j$PEkH2518595BOX DRAWINGS LIGHT UP AND LEFT;(0c;a;ADOWN=RJ>8yb>FULL BLOCK'4ec'LOWER HALF-9041d-l 890447e7 9'YA0f5?UPP2b e0-d8044d)e17 $ER9042525 7'41)e37 lSl 545 l7(42l57 l'TEl 565 l7(43l L lUk 4 J k6(36jK j'ZH16F6 l 83@8 nVm 5N5 m74eX lSOFT SIGNL < ] s >*21fhNUMEROf0xadz2faNWHYPHE 4b*ZfR7YER27T 9(37pVZ 5V 74RfV%SH90426W 84tJX24X 6(49DX9SHC 8Z :4\C26]IC CAPITAL LETTER CHE '\xa7' # 0x00fd -> SECTION SIGN)Pu25a0+)e)BLACK SQUARR' Rf)NO-BREAK SPACE ) ### Encoding Map e_map = {z100:400,FNULL 1 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSIOE5/5/VQUIRYy6#6#ACKNOWLEDGfJ7'7'(BE8 8 2ACKGE9%9%HORIZONTAL TABULA a1a1LINE FEED%b%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .5TWOP11 .7HRE^1 0FFOUR_1NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2fNUMBERFr22LOLLA'2{PERCENTO2AMPERSAN22APOSTROP v2vLEFT PARENTHESISW22ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUS 0x002e: , # FULL STOP %f%f%uSOLIDUS#"30#%30#DIGIT ZERO&1&1&6ONE%2%2%'TWJ3%3%7HREL4'4'FFOURr5&5&'IVL6&6&6SIXK7%7%FEVEN'8'8'VEIGHT'9'9'(NI1a&a&GCOLOnb!b!KSEMI%c%c%LESS-THAN SIGOd*d*kEQUALS'[%3e'GREATERTc3cQUESTION MARK4i4iCOMMERCIAL A<4l4lLATIN CAPITAL LETTER A[y4y2B242C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 2b4425525 5  Q5 5  Y5 5  H5 5  5 5  U 5  V2 5  W2 5  :5 5  Yd 5  Z25b: 0x005b, # LEFT SQUARE BRACKET 0x005c: ,/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(LATIN SMALL LETTER AX2020 B03030 C04040 D05050 6060 F`7070 G08080 H09090 I0a0a0 J0b0b0 K0/6c0 L06@M060N06O077`P07 Q07 R07 977  77 U7 V07 W07 X07 Y07 Z07]CURLY77VERTICAL_77RX7FTILD77VDELET"af"NO-BREAK SPAC*Cc*CURRENCY SIG\af{SECTION(Da' -POINTING DOUBLE ANGLE QUOTAE6MARYa2fSOFT HYPHEblYm#408CYRILLIC CAPITETTER IO 0x0402: 0x0081, # CYRILLIC CAPITAL LETTER DJE #073737G74777UKRAINIAN Iw5@9@'DZ767b7BYELORUSSIAN-7LdL&YI686f6/969L7a7N7b757TSH^c8Koe7vSHORT UNf;'DZ"108aPAm#115NB1X/ecMV6Wa]GWaDmMa1L/ea {7/f477/b86l16/be5Y;:cIK"9dW&ELX7dX&EM6dd&EN6ldO5fdP2d/e2~%ERl2ee&ES6e6lTeeUs2cs&EFcbHP2ca'TScs TTER CHE 0x0428:P0f6, # CYRILLIC CAPITAL LETTER SHA #797a7C9a9/9f9HARD SIGNvb=/f2=FYERU8c8/ee8KSOFTud=/f8=Ere5/9d5Yf6/e06"306a6ESMAL313I 3B"324.eb 4V434/ac4 'GH545 iD454 4I464/e9 Z75/f35 id/b74 I@3`b@ gSHORT 9`c= KWdA &ELSdB &EM4J/d4 E3Id OgFd  P4D/e1 Rh4Ee  &ES4E5h TEe? I4C ?&EFCb 4Ca 'TSCI Cx4Df 4Ff (SH4D9/ >4KfH 4Me 4Tf 0x044e: 0x00@9c,  # CYRILLIC SMALL LETTER YU 0x044f: 0x00de4 A4"514/844 &IO42404 6DJE53525 G54565 UKRAINIAN Is5>8> 'DZ565a5 BYELORUSSIAN-7JI484 %949 L5a5 N5b5- 7TSHRc6 Kke5 fSHORT 59 %DZ3211%efNUMERO SIGNB2500cBOX DRAWINGS LIGHT HORIZONTAL93%b3`9hVERTIC7;d7DOWN AND Rt1b= FLEFT<ycT</UPw/d9 ; uc%{2b fA 2o3/c1@5@ F5/cdFoDOUBLEbq:058; 5*/bb > 5c* {q ydb< w6d; *m }6b4AWINGS DOUBLE VERTICAL AND LEFT 0x2566: 0x00cb, # BOX DRAWINGS DOUBLE DOWN=HORIZONTALC9CaC /UPAcAeA "80G%dfGUPPER HALF BLOCK#84,c,?LOW,8,#KFULLR"91&&b0RIGHT SHADEy#92'1'lMEDIUM(3(2(KDARK&af: NUL11START OF HEADING[+2+2+2TEX(3(3(0ENDQ &4&4&RANSMISSION|5.5.UQUIRY"6"6"ACKNOWLEDGJ7&v7 -> BE08' # 0 x08 -> BACKSPACE '\t' # 0x09$HORIZONTAL TABULATION0n0A0LINE FEED$2x0b&TB$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR2x0e,|E*SHIFT OUTf$F$IG'10# 10#DATA LINK ESCAPB8x11+1+EVICE CONTROL ON-2-2-4TWO(13-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK84eCANCEL!9!UeMEDIUM(a(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) {2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt3"'"2uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF[3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3F4COLz; CGSEMI$<$C -> LESS-THAN SIGN '='# 0x3D -> EQUALS&>&E&GREATER-THR?,F,QUESTION MARKz@( 40(COMMERCIAL AT(A(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1CL1C1LbM1LM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'LSMALb/ /c/ /d/ /e/ /f/ /g/ /h' # 0x68 -> LATIN SMALL LETTER H 'i'# 0x69/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f#7TDELET!Pu05d0#!8dHEBREW<BALEF\-1- -B,2, ,CGIME.3. .9DAL\4. .H5+ +#VA6, ,CZAYI2.7. .H8, ,T,9, ,7YODa, ,FINAL KAb2 2 ,c, ,HLAMEd. .#MEBe2 2 , ,^'NUe9 ,9SSAMEKGe9 (e9Pe9 +5' # 0x95 %-> HEBREW LETTER FINAL TSADI '\u05e6' # 0x96 4 .7.7.7QOFZ8,8,GRESH-9-9-GSHIN-a-A-4TAV,Ffffe,B,UNDEFINED$0xa3"C$POUND SIGu ID% IdIE$MULTIPLICATIONRF. Ruv/A0$1$2$3$4$5$w m$ e $!xaA\REGISTERE7xac AY8NOT8xbd#PVULGAR FRACtONE HAL )xbV_3sQUARTER p(abpLEFT-POINTING DOUBLE ANGLE QUOTCMARKh)xbDORIGHEPu2591FBLEc SHADEk&2&mMEDIUM'MLDARK%0LBOX DRAWINGS VERTICAL&246P AND Q? BBB!xaBACOPYGu256/   7255@  1255 7ODOWNsG<<,UP:!xa:CEN a5$*YE{@2510% >1CC;23::HORIZONTIC?DOWN AND HOR4IZONTAL '\u251c' # 0xC3 -> BOX DRAWINGS LIGHT VERTICAL AND R@&00@4@=HORx3x58 xEFfffe}6EUNDEFINED $7$F255aH8$ DOUBLE UP&54;9;ODOWN=&69=A=xF2566@B@}BCB R5ADAzE9 z F!xa}FFCURRENCY SIGN D0(* /D1$2$SlS8%$$$ EI (D mE2518pD-DLEFT6250D9 b8uFULL BLOCKa8 DLOWER HALF+!xa33DROKEN BARP 8D|?UPPtuOEEEEE~E~0xb5LE~_MICRO|E~E~ E~  $i$ Q$ P$ I $8xaf!HTMACRO!xbBEACUTE ACCENA7xadHFASOFT HYPHEM1&CPLUS-MINUS SIGN  '\u2017' # 0xF2 -> DOUBLE LOW LINE *0xbe(*3*VULGAR FRACTION THREE QUARTERS96949PILCROW SIGN'a`5'"SEX'f'6'PDIVIS((b8v7(tCEDILLAq(b0"8"0DEGHaH9&vIAERESI A$MIDDLE DOTo9oB%SUPERSCRIPT Oj3*C*fV2,D,#WO*Au25aE*pBLACK S%F'NO-BREAK SPACE ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB# generated from 'VENDORS/MICSFT/PC/CP857.TXT' with2}P.py. c#" import s`APIs class ($. 1): ?Adef e(self,input,errors='strict'):,/creturnoB=,ing_map)m*m*B mm)Incremental$er  h final=False*W.Q ?[0]DJ~L!@OStreamWriter(J,W5pasORead9 9Fs module API getregentry(7 UInfo(name='cp857',d!e=02(). id:.r=]/J //spr7=D #w##Z~0MapATmap =make_identity_dict(range(256)) map.update({F0x0080: 0c7,x LATIN CAPITAL LETTER C WITH 7"81?+fc?ESMAL=U=D0x0082: 0x00e9,  # LATIN SMALL LETTER E WITH ACUTE '0x0083: 0e2,;A;CIRCUMFLEX@4@4@DIAERESIS?5?0?GGRAV6;5;RING ABO@7@7@ CfEDILLA8=a= r79@b@7a?8? 7b;f; Izc?e?d@?131@ DOTLESS Iqe8,0cheCAPITAfA /A1#90B9 B h"91=+e6=IGATURE A"923c3p5f(h O9fu@f9fO  9f Uf @ {,13j7+OTL9d6 A8+dc AAf WSTROKi%a3}POUND SIGN9,0db d,158 >S p9/15 =aet : adZ ;fV;. ;^  ACUTE 0x00a4: 0x00f1, # LATIN SMALL LETTER N WITH TILDE '3"a5;d;oCAPITA= 6=;11ex =GzGBREVz7=f= ;8;&0b;INVERTED QUESTION MARK92aREGISTERED SIGN+a+c;NOT$b$%bd$VULGAR FRACONE HALFXc4X4vQUARTER7d7aqEXCLAMAp e5bLEFT-POINTING DOUBLE ANGLE QUOTEfEbEORIGHF b0F6259LFG SHA#b1'2lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS 2EICALlbHE2524]7P AND W@Mc AFACUTbM&0c=CIRCUMFLEXR50c0B 7GRAbT%a9=ACOPY bL6256 &\^'b6255'A vE25578ODOWNu6255=/UP;;CENbs5;YEN:R6251 cH1 8c\3;HORIZONTct2 B1B 2 0: z?253zFeZ Tac ; =E255aUzNGS DOUBLE UP AND RIGHT 0x00c9: 0x2554, # BOX DRAWINGS DOUBLE DOWN>a>/69> UzHORIZONTALbA6A CcC0C VERTICALdB5B |e:/6c|GfG600aCURRENCY SIGN/"d0)%bap MASCULINE ORDINAL INDICATOR717a7_FEMIN6 26c6LATIN CAPITAL LETTER E WITH CIRCUMFLEXx3BbB DIAERESISA4A8AVGRAVE=r5: None; UNDEFINED%6bd'?# IGACUTb7=d= "8Bf"1" L 6LEFd0:z 7d8wFULL BLOCK]8LOWER HALF,700a ROKEN BAq600c g6258?UPPej/d3 OepdESMAL8fSHARP epd.psNep/d2 el+f5= }FTILD"e5d; *=b=ZMICRO/e7eN%d7pMULTIPL;IONT<?00d U??00d =D600d=B /fc Y WITH DIAERESIS 0x00ee:0af, # MACRON"f"%b4"ACUTE ACCENT("f0(%ad(SOFT HYPHEO"f1'%b1'PLUS-MINUS SIG+r2: None) UNDEFINEDw3P'# VULGAR FRACTION THREE QUARTER#f4:6a# PILCROW5(%a7("SEZ 6(f(PDIVIS )7)%b8QvCEDILLA8#0#0DEG J9'aJwDIAERES"fa%bMIDDLE DOb&9rSUPERSCRIPT ONEc+3+o-d-2-&WO+625apBLACK S(NO-BREAK SPACE }) ### Decoding Table d _tA = (}d'\x00'00 -> NULL!1!1!START OF HEADING-2-2-2TEXxx3*3*0ENDU (4(4(pRANSMISj5050UQUIRY$6$6$ACKNOWLEDGq7(w7 -> BE8!8!2ACKY2'\t$c9&HORIZONTAL TABULAn2a2sLINE FEb(# 0b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETURe.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROLJ'\x11 /T/ 1 /[*x11 1EFOUR0 1pNEGATIV_ 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE )191YeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVduGROUP SEPARATOR '\x1e'  # 0x001e -> RECORD SEPARATO-f-f-LUNIT+ ($ X 20+RSPACEz!"1"EXCLAMATION MARK-"-2-LQUOT+#+3+NUMBER SIGNS$(4(XDOLLA(%(5(wPERCENTQ&)6)AMPERSANDw1"'"n7&POSTROPH(M8'LEFT PARENTHESIST-')-9-ORIGH.*.a.sASTERISq+%b%GPLUS,&c&RCOMMA-"d"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3{DIGIT ZEROK1''#ON2&y&#TWL3&t&3HREN4(t3FOUh5'sO3FIVN6'q'2SIX7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33L31LfM3d -> LATIN CAPITAL LETTER M 'N'# 0x004e -> LATIN CA3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1 5c0REVERSE SOLIDU]+ ,d,?IGH]^1$CIRCUMFLEX ACCEN_.rOW LINE`%6YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1 1L1m11n11o1p17bq1r1s1Pt1"u1 v1 w1# 0x0077 -> LATIN SMALL LETTER W 'x'# 0x0078 ->1X1y191Y1z1a1Z1{1b1EFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%>f"UDELET#)c7# 80#PCAPITC WITH CEDILLAJ\xfc@1@ U>DIAERESIS@*e9@2@E@6ACU*e2<3<A<CIRCUMFLE-J\xe4A4A 0@5@ EGRAVy*e5<6< RING ABOA 7A*eaYx<bAiA<8@x@ < 8GI|e| @ Pu0131CY8ADOTLESS Icr9 o c8B :ct9} v6# 9IGATURE Ac46f-9O +xfwA lfa9@ f 9 A}p:DOT^d; B =d9CAPITAL LETTER U WITH DIAERESIS '\xf8'  # 0x009b -> LATIN SMALL LETTER O@dSTROKE=*a3=c=POUND SIGN'ddd'doCAPITAf Pu015ehe?SsCEDILLA@f@f@ >0xe1< !/a0>A|EACUT *ed<1<I<f\/a2< x*fax3< < 4<NETILDd<5< >Hu011/a6>G|DBREV|>&a7> <!xb:8<INVERTED QUESTION MARKU!xa393REGISTERE*aca,9NOT%b,VULGAR FRACONE HALFbZ5tQUARTER8aqEXCLAMAr bEFT-POINTING DOUBLE ANGLE QUOTFbFORIGHGAu259bGE SHA(2(mMEDIUM)s)qLDARK'0P\BOX DRAWINGS L=CICALsXu2524X8 AND LEFTA!xcrb]c>]>CIRCUMFLEX0Cb C5GRA:xa9>dACOPY Iu256\ +gd ,Au255.rB 9799ODOWNw>>,UP<+xa:CEN& a5;YEN@10' # 0x00bf .-> BOX DRAWINGS LIGHT DOWN AND LEFT '\u2514' # 0x00c0 =!UP;RJ<3<1< HORIZONTALA(2c}2AC1C3CVERTICAL(004B|3|5: | G0xe36GLATIN SMALL LETTER A WITH TILDEB+xc<7<oCAPITA> Pu255a|8> :DOUBLE 59= =(69|a?| 8Xu2566BbBD cD  5CdC~ Ae; ~ H!xaBfHCURRENCY SIGN0b*d MASCULINE ORDINAL INDICATOR8a8_FEMIN7 c7 ECIRCUMFLEXz cbC DIAERESISB8BB DGRAVbPufffe@$dUNDEFINEDdd$ IDACUTd!xcb>>'fC ' )G E0d; A8yFULL BLOCKcAu258LOWER HALF-!xaRROKEN BAc'6 8258dw?UPPdezkO"de>$ETTER SHARP S '\xd4' % # 0x00e2 -> LATIN CAPITAL LETTER O WITH CIRCUMFLEXC2C3C TGRAVE>*f5>4>LSMALETILD<d<5< >b>6>MICRO SIGNPufffe"7'UNDEFINED&0xd7$ H8&MULTIPLICATIONV:xda090xUxFACUTb>a> 9CbC *ec>c> I <*ff<d<Y<DIAERESIa@e@TMACRO+xbf#Bt ACCENT)ad f0)SOFT HYPHEQ1(1(PLUS-MINUS 1fS 1bU1f6VULGAR FRAC2THREE QUARTER*b63xPILCROW*xaf "SE\+xf) \DIVIS*b8|tCEDILLAU*b0$ 0DEGvaL bMIDDLE DObfSUPERSCRIPT ON?*b3,x f .#WO,Au25a-fpBLACK S'NO-BREAK SPACE ) ### Encoding Map e_map = {z100:400,FNULL 1 1 START OF HEADING,2,2,2TEXuu3)3)0ENDS '4'4'pRANSMISi5/5/VQUIRY#6#6#ACKNOWLEDGf7'7'(BE8 8 2ACKGE9%9%pHORIZON@TABU~1a1a1sLINE FE1%b%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE RETURN 0x000e: 0x , # SHIFT OUT f%f%%IN$"10$%10$DATA LINK ESCAPE,1,1,EVICE CONTROL ON.2.2.6TWO\3.3.7HRE^4040FFOUR_5/5/NEGATIVE ACKNOWLEDG_6060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCK8585fCANCEL"9"9"WfMEDIUM)a)a)SUBSTITUTb&b& c"c"FILE SEPARATONd*d*_GROUP+%1e+oRECORD,1OUNIT*22FSPAC22EXCLAMAT6MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2AMPERSAND22APOSTROPHv2vLEFT PARENTHESISR2ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZER3p3p&3i3i% 3d3d% 3d3d 3c3cM6FIV3a3a&5SIX+3a3a%6EVE3b3b'E<N]3]''NIC3V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL AT 0x0041: 0x0041,  # LATIN CAPITAL LETTER A *2222 B23232 C24242 D25252 E26262 F27272 G28282 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P212  Q2 5  R2 5  S2 5  T2 5  U2 5  V2 5  W2 5  X2 5  Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5fOW LIN66\GRAVEL66OSMAL66 066 066 066 06 0 66 0 66 066 066 006b: 0x006b,  # LATIN SMALL LETTER K 0x006c: , 0L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKEN%7c.VERTICAL LINEW7ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARab5CENT SIGa9[POUND&cCURRENCY)b;YEN$dBROKEN BAfaf1SEC fnDIAERESIabBCOPY Od= FEMININE ORDINAL INDICATOaLEFT-POINTING DOUBLE ANGLE QUOTa,NOf SOFT HYPHEaREGISTEREeVMACROMb=jDEGREEbf:PLUS-MINUS+fSUPERSCRIPT TWbf +6HRE'beACUTE ACbe2[MICROf{PILCROW(MIDDLE DObvvCEDILLAfO 0x00ba: 0x0P0d0, # MASCULINE ORDINAL INDICATOR #0x00bb: %af7RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKFcFcFVULGAR FRAC0 ON>GARTE}d7b7 FHALFke4/f34ETHREmS:f:%a8:INVERTED QUES "c02%b72LATIN CAPITAL LETTER A WITH GRAVEo#c1=5=GACUT=2=6=CIRCUMFLEX3BcGTILD4=/8eDIAERESIl#c5AW: Ri8ABO?6B/92IGATURE A758wCvCEDILLA48?/d4tE? 9=9| = a=d zdd Id = d =dBda N .de{ O= 7de7 = :de7 =:de B 90 =wepMULTIPLgESIGNd/9dpVSTROKden%Ue = /ea =9BTAL LETTER U WITH DIAERESIS 0x00df:0e1, # LATIN SMALL LETTER SHARP 6"e06/856 AuUGRAVEq"e1;/a0;GACUT;2;/83;CIRCUMFLEX{3@/c6@GTILD{4;/84;f#e5?zRING ABO56@9IGATURE A73/87 CvCEDILLA*8=a= E= 9;2; a;8;b@9@c?/ec? Id;aF; e;8v/8bf N f9 O; %fa% ; 0f9 ;0fe @ ;kfDIVISION SIGN~f~9 VSTROKf9 UaZ ; z9F;{8@ @Z/ed Y ?#11aeCAPITAGA6BRE#11|aq ;3F9 x8:DOT#138LETTER DOTLESS I 0x015e:@09e, # LATIN CAPITAL LETTER S WITH CEDILLA?f?f?OSMAL= B2500=%c4=BOX DRAWINGS LIGHT HORIZONTALvB25029/b39 hVERTIC7c7/da7 DOWN AND Rt1b=FLEFT<4y/c0y /UPw8;/d9; uc%{2b fA 22 23/c1B 8@5@ F5/cdFoDOUBLE"51bq:058; #57vb > "5a=/c8= t yd</bc< w6d; *m }#63}4 B 6Ac7*#69C =A e G8NdUPPER HALF BLOCKl8ldz?LOW,#KFULLR9USHADEy9{MEDIUM (GKDARK&af:BLACK SQUARE } """ Python Character Mapping Codec for CP858, modified from cp850. D import c3cs ###?APIs class($.^1): `def en(self,input,errors='strict'):,creturno.charmap_B=,ing_map)mdecode(self,input,errors='strict'):  return codecs.charmap_deT(inpu=,ing_table) class IncrementalEn6 r(>cs.xQdef e,r(self, h final=False*@:F.,map)[0]D~e'@OStreamWriter(C,RDpassORead9 92###ings module API getregentry(7 UInfo(Qname='cp858',!e=02(). id:.r=]/J //spr7=D #w##0) IZping MapA0codTmap =bmake_identity_dict(range(256)) 5.update({F0x0080: 0c7, # LATIN CAPITAL LETTER C WITH CEDILLA?1?+fc?ESMAL=U=DIAERESIS?2?/e9? E?VACUTE;3;2; A;CIRCUMFLEX@4@4@5?0?GGRAV6;5;RING ABO@7@  t8=a} r79@b@7a?8? 7b;f; Izc?e?d@  e;ck dfA 2A49 i B k90e6, # LATIN SMALL LIGATURE AE 0x0092:0c6,B # 3oCAPITA535+f45hETTER O WITH CIRCUMFLEXu4@ u@DIAERESIS?5?2GGRAV6;b; U7@9@ {8;f; Y{9?d4 vAaAc AAbA+f8AWSTROKxc<%a3<POUND SIGNd&db Z de>7dMULTIPLICATIONmf//19F FEHOOK!a0:50e1i4 A:FACUT#a1;d; I;fCv vav  ; NGTILDd; =aFEMININE ORDINAL IND&ORb6oMASCUL7 bINVERTED QUES=7MAR%aeRREGISTEREaxax:NOTa[bVULGAR FRACONE HALFSbX4gQUARTE#dabEXCLAM, [a7EFT-POINTING DOUBLE ANGLE QUOTEq&0bEORIGHFb}6259LFG SHA}bi'25lMEDIUM(V6259VLDARK&A6250,BOX DRAWINGSZ0HT 2EICALb=6252(7 AND LEFT@Bc B k 0x00b6: 0x`00c2, # LATIN CAPITAL LETTER A WITH CIRCUMFLEX .0x00b7: /c0BVGRAVE=8=%a9=COPYRIGHT SIGN*9*E2563*BOX DRAWINGS DOUBLE VERTICAL AND LEFTAaA/51A8b878 ODOWNuc=d= /UP;d;600az3/66 C67 ?255B |?2568|G600aCURRENCYd600fb5ETHd<00d2 Y 4600cPf 4ddE00cbB DIAERESISO00c8A d&0aKEUROKcIFACUTde =dO00cfBDIAERESIS 0x00d9: 0x2518, # BOX DRAWINGS LIGHT UP AND LEFT &0:a:/0c: ADOWN<RI=b=8wFULL BLOCK&c&4cLOWER HALF,d,E00a6,BROKEN BARRe&cLATIN CAPITAL LETTER I WITH GRAVE=f=E2580c?UPP e0,E00d3,iOiFACUTi#e1=f=ESMALuSHARP S#e26.sCIRCUMFLEXB3B2x B "e4=+f5= ;GTILD5;d;x =6=b=MICRO SIGN7&/fe GTHOR484d4 6RK00daj 6UUO00db=ZB qK00fd= Yd; =aWMACRO|600b4f ACCENfxaSOFT HYPHEOfb%b1PLUS-MINUS:fWE2017+DOUBLE LOW LINf@b1VULGAR FRACTION THREE QUARTERf=b{PILCROW*a"SEZ ff(PDIVIS )buCEDILLA;fb0DEG JaJDIAERESIbMIDDLE DO%b9sSUPERSCRIPT Osbh+ob -&WO+625apBLACK S(NO-BREAK SPACE }) ### Decoding Table d _tA = (}`'\x00'e@ # i00 -> NULL!1!1!START OF HEADING-2-02 -> START OF TEXT '\x03'  # 0x0003 -> END (4(4(RANSMISSIONX5050UQUIRY$6$6$ACKNOWLEDGE(7(7 -> BELL!8!8!tACKSPACGt$ 9&HORIZONTAL TABULATn2a2LINE FEED~b(Cb&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETURme.e,SHIFT OUf&f&IK)10% 10%DATA LINK ESCAPR:x11-1-EVICE CONTROL ON/2/2/4TWOX11D^FTHRE` 1 1EFOURa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE*19GYeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAN1"'"APOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ>b3{DIGIT ZER8''2/&y&)&&t&  '4'  # 0x0034 -> DIGIT FOUR '5''5'2IVE'6'6'2SIX&7&7&BEVEN(8(8(REIGHT(9(9(3NIN:'a'CCOLOq;"b"GSEMI&<&c&LESS-THAN SIGQ=+d+gEQUALS(>(e(|GREATERV?.f.QUESTION MARK@* 40*COMMERCIAL ADA*1*LATIN CAPITAL LETTER A]B323B3C333C3D3D3E33F33FfG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33tO33OfP35'3P3Q30Q3R30wS30SfT30U30UfV30V3W30W3X30\Y30YfZ30Z3[30EFT SQUARE BRACKEb$\\1?5-REVERSE SOLIDU]+5&R]^1$CIRCUMFLEX ACCEN_.# 0x005f -> LOW LINE '`' # 0x0060 -> GRAVE ACCENT)a)1)LATIN SMALL LETTER A1b121B1c131C1d141D1e151f161Fbg171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p17P1q1Q1r1R1s1S1t1u1Ubv1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL|}*ORIGHZ~0CTILD3\x77UDELET#"c7H#8PCAPITC WITH CEDILL3\xf@U>DIAERESIJ\xe9E@6ACU*e2<A<CIRCUMFLE-J\xe4A"A0@1@HGJ\xe5<<<RING ABOVeL  '\xea' 0 # 0x0088 -> LATIN SMALL LETTER E WITH CIRCUMFLEX '\xeb' A9A DIAERESIS@8@a@ UGRAVE<f<b<I|e@c@ cAdA *c4<e<eCAPITA|A*c5BfB RING ABOB)c9C/90CFACUT6>1>=IGATURE A4c4246f-&936jO+fw4A +*f25@ f#/96<U 7A } $9Y} d9 |B %9 B Bf$9USTROKq*a3POUND SIGNLdd f*d7fMULTIPLICATIONoAu019R79 FDHOOK)e1ka ;7 d<2 <fIa x  <ax < N+ETILDd< >aFEMININE ORDINAL IND$ORb7oMASCUL8 aINVERTED QUESG5MAR aaREGISTEREaaa -> NOT SIGN '\xbd'  # 0x00ab -> VULGAR FRACTION ONE HALF5c5c5tQUARTER8*a18d8INVERTED EXCLAMArEMARK6b6e6LEFT-POINTING DOUBLE ANGLE QUOTFbFfFORIGHGAu2590 b0GLGc SHADE(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS LFICAL(24_48 P AND ]A!xc ! b5ALATIN CAPITAL LETTER A WITH ACUT!xc>6> CIRCUMFLEX0C7C EGRAV*a9>8>ACOPY5 SI Iu2569+ cgd ,Au255.aB 979{ODOWNw>>,UP<+xaHCENT0xa58YEN%Au251b 1cX=>3<l<HORIZONT%cAC1C  0?c|3|  G!xecLSMAL5TIL+xc<>aa z5 w6#|| 886D   5CES DOUBLE HOR:IZONTAL '\u256c' # 0x00ce -> BOX DRAWINGS DOUBLE VERTICAL AND HORIH0xa4FHfHCURRENCY SIGNr9xf0* d0*LATIN SMALL LETTER ETH3d313oCAPITA5*cah25 WITH CIRCUMFLEXx*cbC3C DIAERESISB8B4B SGRAVE>Hu20a d5>IEUROQ*cdd6&Q IDACUTd:xce>7> 'fC8C 'Au251) d9B LIGHT UP ELEFT$)50$a;ADOWN=RJ>8yb>FULL BLOCK'c'LOWER HALF-:xa6d-BROKEN BART!xc2dz !58p?UPP)d3es "O"de~ eSHARP d2euY*d2C#:xf5>| <TTILDEd<z>b>;MICf{e{ ETHOR?d5m 7 ebU ee> 9jC  e5Y <z>aUMACRObed ACCEN*xafSOFT HYPHEQ1,frPLUS-MINUSPu2017. fgLOW LINE '\xbe' ! # 0x00f3 -> VULGAR FRACTION THREE QUARTERS 0`'\xb6' ;4;PILCROW SIGN)*a7)5)"SE\)f)6)PDIVIS**b8S7*tCEDILLAw*b0$8$0DEGLaL9(vIAERESI a&MIDDLE DOTu9ub'SUPERSCRIPT ONE,3,c,x.2.d.#WO,Au25ae,pBLACK S'f)NO-BREAK SPACE ) ### Encoding Map e_map = {zB100:J400,FNULL 1 1 START OF HEADING,2,2,2TEXuu3)3)0ENDS '4'4'pRANSMISi5/5/VQUIRY#6#6#ACKNOWLEDGf7'7'(BE8 8 2ACKGE9%9%HORIZONTAL TABULAa1a1LINE FEED%b%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL11 .Tz.1 .N11 0FFOUR/1NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*3: 0x0023, # NUMBER SIGN 0x0024:,'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt7%7%POSTROPHE&8&8&LEFT PARENTHESIS,9,9,ORIGH-a-a-ASTERISKQb$b$KPLUSc%c%VCOMMAFd!d!HYPHEN-MINUe(e(FULL STOPMf%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&&ON~#32%2%'TWJ3%3%7HRELd+34'FFOURc3c7FIVLa3a&6SIXKa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cQUESTION MAR4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G242H242I242J242O4&Ld4dM2 4 24425525 5  Q5 5  R 0x0053: 0x0053,  # LATIN CAPITAL LETTER S *24: 2 T25252 U26262 V27272 W28282 X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKE[c/c/REVERSE SOLIDUd+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(ESMALAX2020 B030  `C0/64` D06 `6 0F`6 0G06 0H06 0I06 0J06s 0K06L060M060N06O077`P07 Q07 R07 977  77 77 77 77 77 77 77]CURLY77`VERTIC_77RX07e: 0x007e, # TILDE 0x007f: , # DELET""a0"%ff"NO-BREAK SPAC*1*%ad* INVERTED EXCLAMATION MARK"a25b5CENT SIGN%3%%9cZ[POUND&4&cCURRENCY)5)%beO;YEN$6$dBROKEN BAR7&%f5J1SEC 8(9(DIAERESISM9%%b8%COPYRIGHa*%a6* FEMININE ORDINAL INDICATOb6LEFT-POINTING DOUBLE ANGLE QUOTcEa{,NOd$%f0$SOFT HYPHEe'aREGISTEREeVMACROMb=jDEGREEb%f1PLUS-MINUS+fSUPERSCRIPT TWObf +6HRE'beACUTE ACUe[MICRO&f4kILCROW(MIDDLE DOTt7NvCEDILLA#%fb#'ONNoMASCUL b!bVULGAR FRA ONFARTE%ba7FHALF%f3 4T1 QUmba3AQUESJ 0cbTLATIN CAPITAL LETTER A WITH GRAVcb= cb= CIRCUMFLEXB'c c78 _cP8WA R8ABO?l%92 BIGATURE Aty8  5C ocd?E? c9: 0x0090,  # LATIN CAPITAL LETTER E WITH ACUTE )0x00ca: 0d2,= CIRCUMFLEXBbB3BDIAERESISAcAeA IGGRAVd=6= e=7=fB8B#d0A1A 5ETH1"d14/a54 N1FTILD1"d2=e O= n#d3=0z = n#d4=k =n#d5B B 6=/997AMULTIPLICATION SIGN8/dpWSTROK9>/eb> Ue = /eaz9Bje; Y e GTHOReESMALCfSHARP e8 6A Ke K; e8;ec4@ Ee+84;e8zRING ABOeIGATURE AIe8 CuCEDILLAe8 =Y 8; 8;CIRCUMFLEX 0x00eb:@89, # LATIN SMALL LETTER E WITH DIAERESIS +?c?d? I?VGRAVE;d;/a1;GACUT;e;/8c;CIRCUMFLEX{f@b@"f0?/d0? 5ETHq"f12/a42 N'FTILD"f2;/95; O; b"f3;/a2; b"f4;/93;b"f5@e  6;9;7?%f6DIVISION SIGN8)9 WSTROK9<7e6Ua;aZ ; 9vr {Zev Y e0 GTHOR/98d o 320ad8IEURO$19]fd FCHOOK>4201g\DOUBLE LOW LIN-3250/cBOX DRAWINGS LIGHT HORIZONTALd#50b+9hVERTIC7a7DOWN AND Rt1b= FLEFT<5c</UPwd; uc%{2b fA 2 o3cB8@@CAL AND HORI ZONTAL 0x2550: 0x00cd, # BOX DRAWINGS DOUBLE HORI:1:/ba: hVERTICr48/c98 DOWN AND RIGHT7>/bb>7LEF=a=/c8= /UPyd</bc< w6d; *}#63}4 B 6Ac7#69C =AcAeB G8N%dfGUPPER HALF BLOCK.8ldz?LOW,8d#KFULLR90~Le SHADEy"92M%b1'lMEDIUM(2(KDARK&af:XLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP860.TXT' with genc;P.py. c#" import ccs ###`APIs class($.1): Qdef eW(self,input,errors='strict'):,creturno.charmap_B=,ing_map)m dem)B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~eL!@OStreamWriter(J,8cs.5pasORead9 9Fs module API getregentry(7 UInfo(name='cp860',d!e=02(). id:.r=] /ementaldecod er=IncrementalDecoder, streamreader=S R #Ewrit#W #q) ### Zing Map dhing_map = ucs.make_identity_dict(range(256))5.update({0x0080: 1c7,# LATIN CAPITAL LETTER C WITH CEDILLA?1?+fc?ESMAL=U=DIAERESIS?2?/e9? E?VACUTE;3;2; A;CIRCUMFLEX@4@3@GTILD{5;0;GGRAV;6;+c1; o 7=e m8=az =k09@c@ BaB/e8 7b;+cd; }I 7c=/d4= O=dBe } e;cg  if= =9 a B 99c = 9c =z =f 9+f5@ t9ft; d#  mf x; xc k9d+ =m -dz 9anCENT SIGN9aD[POUND&dA  C620a[gPESETAdx009f: 0x00d03, # LATIN CAPITAL LETTER O WITH ACUTE )0x00a0: +e1=ESMAL;A;1;d; I;2;f v3;av Uv4; N;GTILD'5;d; d=6=a FEMININE ORDINAL INDICATOR76b6oMASCUL7 87f INVERTED QUESTION MARKi92%d22@ GGRAVa=%ac=NOT SIGNab$b)VULGAR FRACONE HALF4c4X4gQUARTE5d7aqEXCLAMAp e5bLEFT-POINTING DOUBLE ANGLE QUOTEfEbEORIGHFb6259LFG SHAb{6259lMEDIUM(h6259hLDARK&S6250NBOX DRAWINGS DEICALbOE252477P AND W@T6256 @q1 SIyAH_?256HXHqO2556CDOWN| D~O2555D 6256 ?255Y A8O2557u6255%UP<x6255 ;/UPw6255} Bu O2510c1  c3;HORIZONTc2: 0x252c, 2 # BOX DRAWINGS LIGHT DOWN AND HORIZONTAL 0x00c3: 0x251c, BVERTICALFRUA4A/00A z59/3c9 zF6F/5eF@fSINGLEv DOUBLE7IfI 8IZI8IaI@&UPC<9<4<  a>/69> zMbA6A CcC dB5B |e:6R|GfG72UP A R#d0H8HH^#d1H/WN2J575k#UP$95 CCC/52EB3EyV>/6bEIC6CNNdU1i%FLEFT:Q0Q:6=M8wFULL BLOCK&08LOWER HALF,8+ 9E,8,?UPPeE03b1 GREEK SMALL LETTER ALPHAe600dZZLATIN4vSHARP S66039jcCAPITAlR GAMMA 0x00e3: 0x03c0,  # GREEK SMALL LETTER PI 141+a31eCAPITA3VSIGMA656c6 g 46450b5jMICRO SIGNZ7&53c4&6TAU282+a62 'PH94/984 GTHETa6/a96 GOMEG6b6b 8DELjc4E221ejINFINITYd$<03c  e2\gEPSILOf66222INTERSECTI("f0(&61DENTICAL TO f1(600b(PLUS-MINUS  f2+62263GREATER-THAN OR EQU_6226oOLESS162323TOP HALF FGRAL6232oBOTTOM0%f7DIVISION6224oALMOST&0b DE R6221BULLET OPERATOR&0bMIDDLE DOT&E221aSQUARE RO'607f'UPERSCRIPT LATINlf?0b2<'TWG625abBLACK '00(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'@0 # m000 -> NUL(!1!1!START OF HEADINGN2-2-2TEXW3*3*0ENDU (4(4(pRANSMIS5050BQUIRp|6$6$ACKNOWLEDGEL7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZON@TABUK<'\n2a2LINE FEEDb(b&3VER V:x0c0c0HFORMVr$d&CARRIAGE RETURIe.e,SHIFT OUf&f&IK10' # 0x0010 -> DATA LINK ESCAPE '\x11' # 0x0011-EVICE CONTROL ON/2/2/5TWO^3/3/6HRE`4141EFOURa5050NEGATIVE ACKNOWLEDGa616 -> SYNCHRONOUS IDL-7-7- END OF TRANSMISSION BLOCK8686eCANCEL#9#9#YeMEDIUM*a*a*SUBSTITUTb'b' c#c#FILE SEPARATOVd+d+_GROUP,e,e,oRECORD-f-f-LUNIT+ ($ 2CSPAC!"EXCLAMAT3MAR"-LQUOT+#+NUMBER SIGN$(HOLLA(%(wPERCENTQ&)AMPERSANDw1"'"APOSTROPH(MLEFT PARENTHESIST-')-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3{DIGIT ZER83'2/&y&)&&t& (t'sO3FIV$ 'q'2SIX3&q&3EVE(r(EKP(m($NIk:fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER A 'B'# 0x0042 -> LATIN CAPITAL LETTER B3C333C3D343D3E353E3F363F3G373G3H383H3I393I3J3a3J3K3b3K3L3c3L3M3d3M3N3e3N3O3f3O3P3/503P3Q313Q3R30R3S30S3T30T3U30U3V30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\1+5-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.cOW LIN`%6YGRAVENa)ESMAL5b1 13c1 11d1 1/e1 1f1 1+g1 1)h1 1'i1 1%j1 1#'k' # 0x006b -> LATIN SMALL LETTER K 'l'#1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t141T1u151U1v161V1w171W1x181X1y191Y1z1a1Z1{1EFT CURLY BRACKEU|/VERTICAL LINEY}*ORIGHZ~0CTILDRB\x7f%7UDELET#)c7#8PCAPITC WITH CEDILLAJ\xfc@U>DIAERESIJ\xe9@E@6ACU*e2<A<CIRCUMFLE-J\xe3A"A \*e0<-<FGRAVu1<8 u> E*ea|Rq5cAb C*e8tA <d< I <*d4> >O>eC  q<  sc> co9| ACUTE '`\xc0'  # 0x0091 -> LATIN CAPITAL LETTER A WITH GRAVE 3Z'\xc8>2>E>*f4>3>ESMALzO<CIRCUMFLEX*f5A4A ETILD*f2<5< *da<6< 5UFACUTz9>7> < z*cc<8< zIz >d09>s 2d|a>DIAERESISatbBCENT SIGN&3c&YPOUND'dGd' Pu20a7ge>jPESETAf f(f3  e1d# f&a0> \ <d< < <fa <faV x N _ < >a FEMININE ORDINAL INDICATORlb7oMASCUL8 fINVERTED QUESTION MARKkda}*xa}a}*NO:b3`VULGAR FRACONE HALFbZo5eQUARTE;aqEXCLAMAr*ab9xLEFT-POINTING DOUBLE ANGLE QUOTFbFORIGHGAu259bGE SHA,((mMEDIUM)z)xLDARK'0PcBOX DRAWINGS LOCICALAu2523__8P AND ]A61' # 0x00b<5 -> BOX DRAWINGS VERTICAL SINGLE AND LEFT DOUBLE '\u2562' # 0x00b6 I9IYI(56I7CDOWN~E5E8EzE(63E9E#B(51BaB 979b9 wd>c>%UPzc<d</UP}bCeC{ (10CfC@LIGH/WN'14=/c0=RJ3<1< HORIZONTALA2@/c2AC1C3C 0?/c4B|3|y |G(5e ]P(5fJJ[JaJ5 |(69| |R6cD SZ5C~ [; ~Hc(UPB ['68d( I Z6d55K)d?K5 KaK5tdGLE AND RIGHT$ SINGLE '\u2558' # 0x00d4 -> BOX DRAWINGS UP3 AND RIGHT DOUBD2D5DODOWNF3F6F{ (6bF7FVERTICALJHORIZONTAL(6aO8O OO1n9OL`!UPHFLEFT;(0ca;k>8yb>FULL BLOCK'4ec'LOWER HALF- d-?EFT,(90Ye,LY -f-?UPPG03b1Z e0- GREEK SMALL LETTER ALPHA0xdf3 e15ZLATIN5sSHARP S7Hu039 e27l@CAPI?nDGAMMnHu03c&e37 &PIiaii9SIGi 77 i5:xb5 xMICRO SIGNceY\6TAU3 a6\\e=3 /'PH9e#5GTHETd(a9l7GOMEG7b7 26DELlH221el&INFINITYcZ 0%3eEPSILO9222/INTERSECTI)6+f+BIDEN#TOxRfPLUS-MINUS1226AfATER-THAN OR EQUAL aHu226wfOLESS2(32Df2TOPlCGRALIu232 oBOTTOM10xf7pDIVISIO8224flALMOST!xbV DE D1fBULLET OPERATOR+xbMIDDLE DO/&2100fb -> SQUA6RE ROOT '\u207f' # 0x00fc -> SUPERSCRIPT LATIN SMALL LETTER N =0xb2;=d=5TWOi05a0.ie,BLACK SQUARE)x'Uf)NO-BREAK SPACE ) ### Encoding Map e_map = {Q100:000,FNULL 1 1 START OF HEADING,2,2,2TEXXu3)3)0ENDS '4'4'RANSMISSIOqV5/5/VQUIRY6#6#ACKNOWLEDGfJ7'7'(BE8 8 2ACKGE9%9%HORIZONTAL TABU?a1a1LINE FEEDb%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .z11 .7HRE^1 0EFOUR11NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22EXCLAMATION MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2 AM&AN22APOSTROPH2v2vLEFT PARENTHESISW22ORIGH-2wASTERISh2CPLUS 0x002c: 0px002c, # COMMA 02d: !HYPHEN-MINUS(e(e(FULL STOP%f%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&6ONE%2%2%'TWJ3%3%7HREL4'4'FFOURr5&5&'IVL6&6&6SIXK7%7%FEVEN'8'8'VEIGHT'9'9'(NI1a&a&GCOLOnb!b!KSEMI%c%SLESS-THAN SIGO\%3dOkEQUALS'[3[GREATERTc3cQUESTION MARK4i4iERCIAL A<4l4lLATIN CAPITAL LETTER 44y4y2B42C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 2b4425525 5  Q5 5  Y5 5  5 5  5 5  U 5  V2 5  W2 5  :5 5  R Y 0x005a: 0x005a,  # LATIN CAPITAL LETTER Z *b2b2EFT SQUARE BRACKET/c/c/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(5ESMAL3AX2020 B03030 C04040 D05050 6060 F`7070 G08080 H09090 I06 J06 0K06L060M060N06O077`P07 Q07 R07 977  77 U7 V07 W07 X07 Y07 77]CURLY77`VERTIC>_77RX7FTILD77VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARa9(tF SIGa9[POUND&ac FEMININE ORDINAL INDICATO)aa# LEFT-POINTING DOUBLE ANGLE QUOTATION MARK 0x00ac: 00a, # NOT SIGN "b0$%f8$kDEGREE'1'1'PLUS-MINUS+2+d+SUPERSCRIPT TWO}5+%e6+[MICROQ7&fMIDDLE DOTLa&&a7L ASCULINE ORDINAL INDICATOR7b7f7RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKFjcFVULGAR FRAC0 ON>GARTE}d}b7 FHALFkf4INVERTED QUESm c9LATIN CAPITAL LETTER A WITH GRAVEoc8= GACUT= 8]= CIRCUMFLEX3%8e"B GTILD9/80= CvCEDILLA|8|/92? E? 89=| = 8/89z89&8I8= d1/a5 Nz d1a O= sd,9n = 48=sd9 /5U/9 = *^z DIAERESIS'de_ESMAL]fSHARP 6e8' 6eb [; e`+83;ec/84@ eh {e8 =E WITH GRAVE 0x00e9:082, # LATIN SMALL LETTER E WITH ACUTE (;a;8;CIRCUMFLEX@c@d@ I{GGRAV{d;/a1; #f1;4; NvFTILDv"f2;/95; O; "f3;ag ; 4;/93vg#f5@ { 7;%f6{DIVISION SIGNfF%97)FUFa ; A ;DIAERESIS#39eGREEK CAPITAVGAMMA68%e96FTHET6al67SIGl#a6lb65PHIa/ea FOMEGb+e06 GALPH4/eb4 7DELb/ee4 eEPSILO_33c0$ Pco1 mc45TAUkc2B207f%fcSUPERSCRIPTz320a9;hPESETA3221fBULLET OPERATOR3221{fSQUARE ROOT'eeINFINITY$2v%efINTERSECTI3224>feALMOST EQUAL TOS6f{IDENTIC(fLESS-THAN ORYfOATER4#32fTOP HALF DGRAL$32~oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi#50b91VER5 0x250c: 0x00da, # BOX DRAWINGS LIGHT DOWN AND R )0x2510: =/bf=FLEFT<4</c0< /UPw8;/d9; uc:/c3: VERTICAL{2/b4A 22@ oHORIZONTAL83/c1B 8@5@ F5/cdFDOUBLE :1bq:"528d4fSINGLE NE3E6#WN4EVEt4"55/b8r?6D7DDTD7DbDWD=2UP o5 9d#UP2CTaCcK <b</be AQBIb B dcq B}e;c?fIKI JZ6 PIB;G(H*b HXH-b HA)d\u. 5d7JJ`;cb, # B+OX DRAWINGS DOUBLE DOWN AND HORIZONTAL 0x2567: 0x00cf,X # BCUP SINGLEA\H8H/d0H ^H9H/caHE+UPAaA/d8AVERTICALy G bN7N  cN/ceNE N"80GdUPPER HALF BLOCK,4,cs?LOW,b,LFULLR%dd&OLEFT}9ORIGH,1bAL,USHADE#92'1~{MEDIUM (3(2(KDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP861.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,creturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.5pasORead9 9Fs module API getregentry(7 UInfo(name='cp861',d!e=02(). id:.r=]/J //spr7=D #w##)Z~0MapAcoding_map = co6decs.make_identity_dict(range(256)) decoding_map.update({ 0x0080:0c7, # LATIN CAPITAL LETTER C WITH CEDILLA?!1:?+fc?ESMAL=U=DIAERESIS?2?/e9? E?VACUTE;3;2; A;CIRCUMFLEX@4@4@5?0?GGRAV6;5;RING ABO@7@  t8=a} r79@b@7a?8? 7b;dr 6ETHc4f4 + 2d2+de fVTHORNhe6cM 6fA A9 K B M9+e6(IGATURE A9c3p5f(hlO9fu@f9f ? 9f 19+dd[(Y f= ;d+ xm-d AAf WSTROK^%a36POUND SIGw9 b d620aHkPESETAe/19i FEHOOKa%e1\  aALL LETTER I WITH ACUTE 0x00a2:0f3, # LATIN SMALL LETTER O;3;a; U;4;+c1;eCAPITAxA=5=d= I=6=d z7= =8=%bfINVERTED QUESTION MARK92E23102REVERSED NOT SIGN-a-E00ac-$b$b:VULGAR FRACONE HALFXc4X4vQUARTER7d7aqEXCLAMAp e5bLEFT-POINTING DOUBLE ANGLE QUOTEfEbEORIGHF b0F6259LFV SHAD?#b1'2lMEDIUM(g6259wLDARK&R6250NBOX DRAWINGS 4EICALlbNE25247P AND W@Q6256 @q1 SIyAH\?256HXHgO2556CDOWN| DnO2555D &56 ?255Y A8O2557u6255%UP<x6255 ;/UPw6255} Bu '25 Bc1  c3;HORIZONTc2; B1B m 0/BOX DRAWINGS LIGHT HORIZONTAL 0x00c5: 0x253c, # BOX DRAWINGS L9VERTICAL ANDF6F/5eF@aSINGLEGRZfDOUBLE7IfI 8IZI8IaI@&UPC<9<4< ODOWN>a>/69> zbA6A CcC0C dB5B |e:6Rz |GfG72UP A `#d0H8H2 H^H1H/WN2J53J5k#UP4C CCC/52EB3EyV>/6bEtI: NC6CN8NdU1iiFLEFT:Q0Q:6dM8wFULL BLOCKc08LOWER HALF,8+ 9EW8,?UPPeE03b1 GREEK SMALL LETTER ALPHAe600dZZLATIN4vSHARP S66039jeCAPITAlGGAMMl603c6 &PIg?03ag 8SIGgy<03c6gETTER SIGMA 0x00e6:0b5, # MICRO SIGN &7&53c4&GREEK SMALL LETTER TAU282+a62eCAPITA46PHI494/984 VTHETA6a6/a96 GOMEG6b6b 8DELjc4E221ejINFINITYd$<03c * e2\gEPSILOf66222INTERSECTI("f0(&61DENTICAL TO f1(600b(PLUS-MINUS  f2+62263GREATER-THAN OR EQU_34oOLESS1415320TOP HALF FGRAL5-oBOTTOM0%f7]DIVISION6224oALMOST&0b DE R6221BULLET OPERATOR&0bMIDDLE DOT&E221aSQUARE RO'607f'UPERSCRIPT LATINlf?0b2<'TWG625abBLACK '00(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'00 -> NUL(!1!1!START OF HEADINGN2-2-2TEXW3*3*0ENDU (4(4(pRANSMIS5050BQUIRp|6$6$ACKNOWLEDGEL7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZON@TABUK<'\n2a2LINE FEEDb(# 0b&3VER V:x0c0c0HFORMVr$d&CARRIAGE RETURIe.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /I'\x1013 -> DEVIC E CONTROL THREE '\x14'  # 0x0014 -> DEVIC1EFOUR05050NEGATIVE ACKNOWLEDGa616 -> SYNCHRONOUS IDL-7-7- END OF TRANSMISSION BLOCK8686eCANCEL#9#9#YeMEDIUM*a*a*SUBSTITUTb'b'VESCAP#c#c#FILE SEPARATOVd+d+_GROUP,e,e,oRECORD-f-f-LUNIT+ ($  20+CSPAC!"1"EXCLAMAT3MAR"-2-LQUOT+#+3+NUMBER SIGN$(HOLLA(%(wPERCENTQ&)AMPERSANDw1"'" APOSTROPH(MLEFT PARENTHESIST-')-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3{DIGIT ZEROK1''#ON2&y&#TWL3&t& 3t'sO3FIV 'q'2SIX&q&3EVE(r(EKP(m($NI9:fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33APITAL LETTER D 'E'# 0x0045 -> LATIN CAPITAL LETTER E3F363F3G373G3H383H3I393I3J3a3J3K3b3K3L3c3L3M3d3M3N3e3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U30U3V30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.cOW LIN`%6YGRAVENa)ESMALiA:b1 1B1c1 1C1d1 1/e1 1f1 1+g1 1)h1 1'i1 1%j1 1#k1U 1!l1 1m11n' # 0x006e -> LATIN SMALL LETTER N 'o'# 0x006f1O1p1/701P1q111Q1r121R1s131S1t141T1u151U1v161V1w171W1x181X1y191Y1z1a1Z1{1b1EFT CURLY BRACKEU|/c/VERTICAL LINEY}*d*ORIGHZ~0CTILDRB\x7f%7UDELET#)c7#8PCAPITMC WITH CEDILLAJ\xfc@U>DIAERESIJ\xe9@E@6ACU*e2<A<CIRCUMFLE-J\xe4A"A0@1@EGRAVy*e5<<<RING ABOA L*eaYx<bAiA<8@x@ <dx 5ETH 553*de3 hCTHORn;\xcW7 cB cY9b [69IGATURE Ac4.6f-9OFLEX '\x@f6' "# 0x0094 -> LATIN SMALL LETTER O WITH DIAERESIS 5Z'\xfe@5@UTHORN5b565UuCIRCUMFLEXA*ddA7AeCAPITAYCTACUTE>f>8> <d09< z2*dcaBt8BbB USTROK*a3=c=POUND SIGddd' fPu20a7hWe?hPESETAgXu0192(f(g FDHOOK e19# c/a0;A; e/a1<I<fA/a2<~ x*fa3< <c c >d >d*bf4INVERTED QUESTION MARPu23105REVERSED NOT*xaa %b@tVULGAR FRACONE HALFbZl5tQUARTER8a}qEXCLAMAr*xaVatLEFT-POINTING DOUBLE ANGLE QUOTFbFORIGHGAu259bGT SHAD(bmMEDIUM)QwLDARK'0PbBOX DRAWINGS L?CICALsWu25243b^8P AND ]A6a As1 SIBI lIYI52wBOX DRAWINGS DOW8N DOUBLE AND LEFT SINGLE '\u2555' # 0x00b8 -> BOX DRAWINGS DOWN 5EUE(63E9EVERTICALIB(51BaB 979b9D>d>c>/UPc<d</UP}bCeC{ (10CfCRLIGHT'14=/c0=RJ;3<1< HORIZONTALA2@/c2AC1C3C w 0?/c4B|3|5: |G(5e6GA ]P(5fJ7JJ[JaJ5 |(69| |R(66BD [ 5C~ [; ~Hc#UP B ['68Sd( I Z6d55d?K*5tdG 95#I lDD2gSF53' # 0x0:0d6 -> BOX DRAWINGS DOWN DOUBLE AND RIGHT SINGLE '\u256b' # 0x00d7FVERTICALJHORIZONTALOaO8OO(18O9OL!UPHFLEFT;(0c;a;%>8yb>FULL BLOCK'4ec'LOWER HALF- d-?EFT,(90Ye,Y -f-?UPPG03b1Z e0- GREEK SMALL LETTER ALPHA0xdf3 & e15ZLATIN5sSHARP S7Pu03939#] e27l@CAPI?nDGAMMnHu03c&e37 &PIiai42 i9SIGi 757 i50xb5 xMICRO SIGNc/e7\6TAU3 a6\/=/'PH9e#5GTHETd(a9l7GOMEG7b7 26DELlH221el&INFINITYcZ 0%3eEPSILO9222/INTERSECTI)6+f+BIDEN#TOxRfPLUS-MINUS1226AfATER-THAN OR EQUAL aHu226wfOLESS2(32Df2TOPlCGRALIu232 oBOTTOM10xf7DIVISION4flALMOST!xbV DE T1fBULLET OPERATOR+xbMIDDLE DO/(21fSQUARE RO(!07 SUPERSCRIPT z:xb26=$TWTAu25aibBLACK '\xa0' % # 0x00ff -> NO-BREAK SPACE ) ### Encoding Map e_map = { C100:K000,ZFNULL 1 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSIONV5/5/VQUIRY#6#6#ACKNOWLEDGE'7'7'(BE8 8 2ACKG#09%9%HORIZONTAL TABULATa1a1LINE FEEDb%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .5TWOP11 .7HRE^1 0FFOUR_1NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2AMPERSAN22APOSTROPH2v2vLEFT PARENTHESISW22ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3k # DIGIT ZERO 0x0031:, # DIGIT ONE%2%2%'TWJ3%3%7HREL4'4'FFOURr5&5&'IVL6&6&6SIXK7%7%FEVEN'8'8'VEIGHT'9'9'(NI1a&a&GCOLOnb!b!KSEMI%c%c%LESS-THAN SIGOd*d*kEQUALS'e'e'GREATERTf-f-QUESTION MARK"40)%40)COMMERCIAL A<4l%41)LATIN CAPITAL LETTER A[y4y2B242C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 2b442552P5 5  Q2 5  Y5 5  Sd 5  5 5  Ud 5  V2 5  W2 5  :5 5  Yd 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5 # RIGHT SQ UARE BRACKET 0x005e:, # CIRCUMFLEX ACCEN-f-f-LOW LINEQ"60$%60$\GRAVEL#61(1(LATIN SMALL LETTER AX2020 B03030 C04040 D05050 6060 F`7070 G08080 H09090 I0a0a0 J0b0b0 K0c0c0 L0d0d0 M0/6e0 N06O077P07 Q07 R07 S07  77 U`7 V07 W07 X07 Y07 Z07EFT CURLY77VERTICAL_77ORIGHX7FTILD77VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARa9POUND SIGaNaLEFT-POINTING DOUBLE ANGLE QUOTkea:NOTibGkDEGREE'fPLUS-MINUS+fSUPERSCRIPT TWDbTe$[MICROQfMIDDLE DOb200af, # ( RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK 0x00bc:0ac, # VULGAR FRAC0 ON>VARTER7d7b7 FHALF4f484INVERTED QUESm #c1242LATIN CAPITAL LETTER A WITH ACUTEo"c4=/8e=DIAERESISA5AfARsGABOV6B/92BIGATURE A575/805CvCEDILLA9?9? E? 45| I="d0z85ETH"d34/a6q Oq_9="d8~/9dAVSTROK"da>/a7> Ux/9a=9~ Y~e8 VTHORN+e1ESMALfSHARP Ge T 67GRA@e ; #e23 vCIRCUMFLEXe> {{e< ?:ek8e8  s6e 8 =4 q8; B82;b @Caehf7f' f9LL LETTER O WITH CIRCUMFLEX 0x00f6:094, # LATIN SMALL LETTER O @DIAERESIS?7?%f6?DIVISION SIGN)8)%9b)hfSTROKE<a</a3< UGACUT;b;9w;c@/81{d?/98? Ye;5; ETHORe31924f4 FoDHOOKc2393:%e2:GREEK CAPITA VGAMMA6/e96 FTHET6alsl7SIGlaeK65PHI#a9a FOMEG#b1606 GALPH444 47DEL#b54eh eEPSILO33c06 jPcoI1 mc7 5TAUkcd2 B207f%fc2SUPERSCRIPT320aw9;hPESETAu3221fBULLET OPERATOR3221dfSQUARE ROOT'eINFINITY$2veINTERSECTI3224>feALMOST EQUAL TOS6f{IDENTIC(fLESS-THAN ORYfOATER4#31aV0REVYD NOT#32-fTOP HALF DGRAL$32oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi#50)b(91VERb#50dP7DOWN AND R=7b= 5LEFw#51c<*UPw 0x2518: 0x0P0d9, # BOX DRAWINGS LIGHT UP AND LEFT &0x251c: 0x00c3: VERTICAL@RMA"24A/b4A 22@ ADOWN}HORIZONTAL3/c1B @5@ F"50/cdFDOUBLE :1:/ba: "528d4aSINGLE; E3E6}#WN4EVEt >5/b8r?D6D7DDTD7DbDD=8=d2UP o 9C#UP2CTaCcK <b</be BIb B dcB}e;c?fIKIOJZ6 PIB;G 6*b HX-b HA)d\u. 5d7JJ`;cJC:/cf ;A E0H NTAL SINGLE  0x2569: 0x00ca, # BOX DRAWINGS DOUBLE UP AND HORIZONTAL .AaA/d8AVERTICAL SINGLEG`NbN7N  dNcN/ceNE NG"80G%dfGUPPER HALF BLOCK,4,c,?LOW,8,b,LFULLR%dd&OLEFT}9ORIGH,1}&b0W,USHADE#92'1'{MEDIUM (3(2(KDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP862.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,,creturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.5pasORead9 9Fs module API getregentry(7 UInfo(name='cp862',d!e=02(). id:.r=]/J //spr7=D #w##)Z~0MapA0codTmap =make_identity_dict(range(256)) 5.update({F{_&5dHEBREW LETTER ALEF.&5d .6BET-!5d # HEBREW LETTER GIMEL 0x0083:@5d3, # HEBREW /VDALET/4/4/&HE,5,5,6VAV-6-6-VZAYIN/7/7/H8-8-T-9-9-6YODa-a-FINAL KAF3b3b3 -c-c-GLAMEd/d/6MEMe3e3 -f-f-`&NU"903/e03 -1-1-eSAMEKH#92020 49eP9e,e^VTSADIe /e&QOi9e7RESKe'SH9eT9&0aCENT SIG(&0a[POUND&&0ae;YEN$620a%kPESETA'&19LATIN SMALLF WITH HOOKa&0e:A:FACUTQa&0e;I;&0f!;O;&0f;U;/0f N;GTILD,0d;eCAPITAc=&0aFEMININE ORDVINDICATOR &0b6oMASCUL7 *&0bINVERTED QUESTION MAR.6231REVERSED NOa-&0a$$bVULGAR FRACvONE HALa3bX 4NE QUARTER 0x00ad:01, # INVERTED EXCLAMATION MARK !5e5b5LEFT-POINTING DOUBLE ANGLE QUOTEfEbEORIGHF b0F6259LFe SHADE#b1'2lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS FFICAL47%24]7P AND W@5@6 @q1 SIyAH6HHXH7H/56CDOWN| D8D5D 9D6 aA5Y A8b87uc=d= %UP<xO255c;/UPw6255} 3#UP}RO2510c1  wc3;HORIZONTc2; B1B m 0: z3zF/5ev cfI ?IZaI@5<z/69zM6 C6GB HORIZONTAL  0x00ce: 0x256c,  # BOX DRAWINGS DOUBLE VERTICAL AND HORIZONTAL 3GfG7GUP SINGLEA`H#d0H8H ^H1H4HCDOWN4 2J5J3J/59J#UPSRIGHT4CgCC5C2 E6E3Ey7E/6bEtI{ 8NaN !Nd&9N1iL!UPFLEFT:a:0Q:f_=b=8wFULL BLOCK&c&LOWER HALF,d,+ %90B,8,?UPPeE03b1X GREEK SMALL LETTER ALPHAeE00df4ZLATIN4SHARP S (GERMAN)?6039seCAPITAuGGAMMu603c6 &PIg?03ag 8SIGg<03c6 g 4q600bMICRO SIGNR603c6TAU26E03a6h2 )'PH60394GTHET]603a6GOMEG6?03b 8DELj521eINFINITY<03c  '03 2gEPSILO(&22INTERSECTI(f$6226$BIDENt%TOfLPLUS-MINUS f62263GREATER-THAN OR EQUAL TO 0x00f3: 0x2264, # LESS-THAN O14153201TOP HALF INTEGRAL^5-1-oBOTTOM060E00f70DIVISION SIGNY7)E2248)oALMOST8+600bkDEGREER9'E2219RBULLET OPERATOR}a+600bMIDDLE DOT&b&E221aQSQUARE RO'c'607f'UPERSCRIPT LATIN SMALL LETTER d<O00b2<'TWe+625abBLACK f('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00'\s00 -> NUL(!1!1!START OF HEADINGN2-2-2TEXW3*3*0ENDU (4(4(pRANSMIS5050UQUIRY$6$6$ACKNOWLEDGE(7(w7 -> BE8!8!2ACKY2'\t$ c9&HORIZONT0ABUKO=<'\n2a2LINE FEEDb(#. 0b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETUR2x0e.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /J'\x11 /6HRE` 1 12FOUa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2d BLOCKM11UCANCE )191YeMEDIUMMa*SUBSTITUT 1  1ILE SEPAVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"0021 -> EXCLAMATION MARK '"'# 0x0022 -> QUOT+#+3+NUMBER SIGNS$(4(XDOLLA(%(5(wPERCENTQ&)6)AMPERSANDw0"'"7&POSTROPHE'-'(M8'LEFT PARENTHESIS-)-9-ORIGH.*.a.sASTERISq+%b%GPLUS,&c&RCOMMA-"d"HYPHEN-MINU.)e)FULL STOPO/&f&TSOLIDJ0$ 30$DIGIT ZEROK1'1'#ON2&yM#TWL3&t&3HREN4(tBFOUR5'sO3FIVN6'q'2SIXM7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33L31LfM3fM3N33O33-P350 -> LATIN CAPITAL LETTER P 'Q' # 0x0051 -> LATIN CAPIT3Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1.c0REVERSE SOLIDU]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)ESMAL8AZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1" 1L1m11M1n11N1o1O1p17bq1r1s1Pt1"u1 v1 w1 x1y1z1a -> LATIN SMALL LETTER Z '{'# 0x007b -> LEFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%f"TDELET#Pu05d0%# 80#dHEBREWBALEF\/1/1/B.2.2.WGIMEL^30309DAL`4040H5-5-7VAV6.6.WZAYIN07070H8.8.T.9.9.7YODa.a.FINAL KAb4  .c. .HLAMEd0 07MEMe4 4 . .b'NUe9 .9fSAMEKHe9 @e9Pe9 -9`WTSADI9 09'QOve98RESR9(SHe9T!xa# B9CENT SIG4!xa&ZPOUND'k'8YEN%Iu20a,iPESETA(1019LATIN SMF WITH HOOK!xea;A;5ACU!xe<<I<f'a<O<x <U< <N< ,d< 0x00a5 -> LATIN CAPITAL LETTER N WITH TILDE '\xaa'  # 0x00a6 -> FEMININE ORDINAL INDICATOR7b777oMASCUL8 fo88INVERTED QUESTION MARKkPu2310593REVERSED NOT SIGN.0xac, a. %*bd%b%VULGAR FRACONE HALFZbZc5eQUARTE+*a1md8qEXCLAMAr:xab6e6LEFT-POINTING DOUBLE ANGLE QUOTFbFfFORIGHGAu259 b0GLGE SHAM(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS ?CICALXu2524_48 P AND ]A65As1 SIBI _ IYI(56q ICDOWN~E5E~E  E ^B 979 w>%UPAz< </UP}C C{ b C1c=&3<<HORIZONT@cAC1C   0Jc|3|y G'5ec ]5JMc7 -> BOX DRAWING BOX DRAWINGSA&UPD=4=9=ODOWN?(69?a?|HORIZONTAL(66BbBD0DcDSL5CdC~c~e; ~H7HfH#UPB'68I/d0IUI Z6-d1I552K5t-d3K#UP4 #4DDg(525D F3F6F{(6bF7F}J SdSO%Oe*1neL%FLEFT;0]da;k8y]FULL BLOCKe8@LOWER HALF- *,9VdY -?UPPG03b1e GREEK SMALL LETTER ALPHA0xdf3*eZLATIN5SHARP S (GERMAN)@Hu039eueCAPITAwDGAMMwHu03ce7 &PIiai2 i9SIGi 77 i5!xbMICRO SIGNc$eb\6TAU3aeF3 !PH '\u0398' (# 0x00e9 -> GREEK CAPITAL LETTER THETA '\u03a9' 7a7GOMEG7(b47b7ESMALl6DELlH221e5c5INFINITY(c6%d% Z6PHI3(b53e3tEPSILON79222f7INTERSECTI)'61`!f0)DENTICAL TOR!xb'M f1)PLUS-MINUS SIG~6 f2,GREATER-THAN OR EQUaHu226w f35OLESS2832042TOP HALF CGRALAu232 f5.oBOTTOM10xf7]61DIVISION 48,[7*lALMOST!xbV8, DE T1fBULLET OPERATOR+xbMIDDLE DOT'Xu221aSQUARE RO(807f(SUPERSCRIPT LATIN 0xb2;=$TWTAu25a8bBLACK x'UNO-BREAK SPACE ) ### Encoding Map e_map = {QD100:L000,.$2NUL- 1 1 START OF HEADINGL2,2,2TEXU3)3)0ENDS '4'4'pRANSMIS5/5/BQUIRxy6#6#ACKNOWLEDGEJ7'7'(BE8 8 2ACKGl9%9%pHORIZON@TABU?1a1a1LINE FEEDb%b%3VERTc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .z11 .7HRE^1 02FOU_1NEGATIVE z11SYNCHRONOUS IDLE 0x0017: , # END OF TRANSMISSION BLOCK !58585fCANCEL"9"9"WfMEDIUM)a)a)SUBSTITUTE&b&b&WESCAP"c"c"FILE SEPARATORLd*d*_GROUP+e+e+oRECORD,f,f,OUNIT*"20*%20*FSPAC#21!1!EXCLAMAT6MAR#22,2,OQUOT*3*3*NUMBER SIGN#24'4'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt&27%POSTROPHv2vLEFT PARENTHESISR2ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZEROI3p3p&&ON~3i3i%'TWJd3d%7HRELd3d6FOU3c3cM7FIVLa3a&6SIXa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G24 2 LETTER H 0x0049: ,  # LATIN CAPITAL LETTER I 2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R23232 S24242 T25252 U26262 V27272 W28282 X2 /592 Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5uOW LINE66\GRAVEL66ESMALAX6 0B06 0C06 0D06 06 0F`6 0G06 0H06 066 066g 066 06606606677`77 77 7073, # LATIN SMALL LETTER S 0x0074:,O # 0T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKENc.c.VERTICAL LINEWd)d)ORIGHXe/e/GTILDPf!f!VDELET""a0"f"NO-BREAK SPAC*1*a INED EXCLAMATION MARK"a259(CENT SIGN%3%[POUND&9;YEN$a FEMININE ORDINAL INDICATORaGLEFT-POINTING DOUBLE ANGLE QUOTaB+NObmjDEGREEbj%f1PLUS-MINUS+`fSUPERSCRIPT TWOb@e[MICROQfMIDDLE DObhPMASCUibimjbj/VULGAR FRAC ONFARTEb\a7FHALF4@aAQUESm da9PCAPITN WITH TdoeSHARP S (GERMAN)e|08?Az7ACUez I;fv4v f/a2; OvPDIVIS ]f3d Ud#19]9PF;5HOO#39e+K TGAMMA#39e6BTHET60x03a3: 0x00@e4, # GREEK CAPITAL LETTER SIGMA "0x03a6: 0x00e86 6PHI494a4 FOMEGj#b1606ESMALGALPH444b4 GDELT454e4 uEPSILON#c0636 P#c3151 mc74 6TAUd2 #5d8gdHEBREWDALEF`#5d%81` .6BET-2/82-VGIMEL/"8S \8DAL^8 /&HE[8} ,6VAV-D/86EZAYI 35d7 \H8-? -T-8/896YODaZe ZFINAL KAb3. 3 -c-cGLAMEd/ \6MEMe3 3 -f-f`&NUe9 -9eSAMEKHe9 4e9Pe9,9^ETSAD#5e9 /9&QOie97RESK9'SHe9T32076fSUPERSCRIPT LATIN `?420a`PESETA"'#21fBULLET OPERATOR43221fSQUARE ROOG3221eINFINITYK2veINTERSECTI22240f7, # ALMOST EQUAL TO 0x2261: 0x00f0, # IDENTIC(4(3(LESS-THAN ORY5121GREATER423104%a94REVERSED NOT SIGN#32-%f4-TOP HALF INTEGRAL-5-oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi2502b(91VERb250c7'da pDOWN AND R=7/bf=FLEFT<c/UPw8; uc%{2b fA 2o3/c1t 8@  F5doDOUBLE5bq:05d4aSINGLEw NE3:6#WN4EVEt 45/b8r?6/b7DDTD7DbDD=2UP o9d#UPCTaCcK <b</be BIb B dcB}e;c?fIKIOJZ6c, # BOX D&RAWINGS DOUBLE VERTICAL AND RIGHT 0x2561: 0x00b5, # BOX DB;aSINGLEBCLEFT[H2H6H HXH3H9H?HA4A/d1A2WN uHORIZONTAL5J2JJ`6J/cbJKDOWNC7CfC/UP8H/d0H9H/caHE/UPaA/d8AL G bN7N  cN/ceNE N"80GdUPPER HALF BLOCK,cs?LOW,OLFULLR&ddR}9&91ALRe SHADE9lMEDIUM(eKDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP863.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,creturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.): pass cl ass StreamReader(Codec,c(s.(): pass ### encodings module API def getregentry(7sreturn XeQInfo(TXname='cp863',d!e=02(). deQincremental:6r=IE/er/J /Dl/s7r7=*R#cwriter#W #)IZping MapAWd_map =2make_identity_dict(range(256)) 0ing5.update({F0x0080: 0c7,k # LATIN CAPITAL LETTER C WITH CEDILLA?1?+fc?ESMAL=U=DIAERESIS?2?/e9? E?VACUTE;3;2; A;CIRCUMFLEX@4@c@ B5B/e0GGRAV6;%b6;PILCROW SIGN7(e _8=ae =]"9@b@a?8? b;f; Izc?e?d@6201vDOUBLE LOW LINe+<00cF f=ahzSECTION9 & e (9c= 9cC=L9/f4 O@  9cL AN9f Gf@ a=CURRENCY"d) h0dc, # "LATIN CAPITAL LETTER U WITH DIAERESIS 0x009b:0a2, # CENT SIGN%c%3%[POUND&d&%d9& VGRAVEce=b=CIRCUMFLEXBfB&19ESMAL F EHOOK:!a0:50a6|BROKEN BAR&1&%b4&ACUTE AC2(2(f-OB;3;ac; ;4;%a8;"a5%b%vCEDILLA6#SUPERSCRIPT THRE"a7-%afuVMACRO:"a8"%ce" I a9BE2310BREVERSED NO aa-E00ac-$%bd$ VULGAR FRACTION ONE HALFbX4gQUARTE3b 7Q 9aaEFT-POINTING DOUBLE ANGLE QUOTA7MAR&0bEORIGHFbE25910LFV SHAD b'25lMEDIUM(6259aLDARK& 6250BOX DRAWINGS VERTICALb62527 AND LEFT@!6256 @q1 SIyAHF?256HXHa7255CDOWN| DE2555 D &56 D?255YA8O2557yu6255%UP<x6255 ;/UPw6255} Bu '25 BAND LEFT  0x00c0: 0x2514, # BOX DRAWINGS LIGHT UP AND R  ';1;3;HORIZONTAL@2@/2c{ ADOWN}B3B1B VERTICALF 4A/00 z593zF6F/5efSINGLEv DOUBLEK7IfI 8IZI8IaI@9<< a>/69zMbA6A CcCdB5B |e:6R|GfG72UP A Rd/68HH^Qd%6/WN//6575k#UP$95 CCC/52EB3EyV>/6bEIC6CNNdU1i FLEFT:Q0Q:6=M8wFULL BLOCK&08LOWER HALF,8+ 9E,8,?UPPe0: 0x03b1,  # GREEK SMALL LETTER ALPHA 0x00e1:0df,4ZLATIN4vSHARP S62653936jeCAPITAlGGAMMl36+c06 &PIg41ag 8SIGg56c6 g 46450b5MICRO SIGN7&53c4& Z6TAU282+a62 )'PH94/984 GTHET]a6/a96 GOMEG6b6b 8DELjc4E221ejINFINITYd$<03c * e2\gEPSILOf66222INTERSECTI("f0(&61DENTICAL TOfb(PLUS-MINUS f62263GREATER-THAN OR EQU_6226oOLESS162323TOP HALF FGRAL6232oBOTTOM0%f7DIVISION6224oALMOST&0b DE R6221BULLET OPERATOR&0bMIDDLE DOT&E221aSQUARE RO'&07SUPERSCRIPT lf60b2c<'TWG625abBLACK '00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00'00 -> NUL(!1!1!START OF HEADINGN2-2-2TEXW3*3*0ENDU (4(4(pRANSMIS5050BQUIRp|6$6$ACKNOWLEDGEL7(w7 -> BE8!8!2ACKY2'\t$ -c9&pHORIZON@TABUK<'\n2a2LINE FEEDb(# 0b&3VER V:x0c0c -> FORM FEED '\r' # 0x000d -> CARRIAGE RETURN,2x0e.,e,SHIFT OUT&f&f&IK)10% 10%DATA LINK ESCAPER*11-1-EVICE CONTROL ON/2/2/5TWO^3/3/6HRE`4141EFOURa5050NEGATIVE ACKNOWLEDGa616 -> SYNCHRONOUS IDL-7-7- END OF TRANSMISSION BLOCK8686eCANCEL#9#9#YeMEDIUM*a*a*SUBSTITUTb'b' c#c#FILE SEPARATOVd+_GROUP, 1oRECORD- 1LUNIT+ =2CSPAC!"EXCLAMAT3MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAND3"'"UV2APOSTROPH(MLEFT PARENTHESIST-')-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ>{3{DIGIT ZER8''2/&y&)&&t& (t'sO3FIV$ 'q'2SIX3&q&3EVE(r(EKP(m($NIk:3fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(e -> GREATER-THAN SIGN '?' # 0x003f -> QUESTION MARK*@* 40*COMMERCIAL AT*A*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353E3F363F3G373G3H383H3I393I3J3a3J3K3b3[L3c3LfM3d3M3N3e3O3OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.cOW LIN`%6YGRAVENa)LSMAL5b1 13c1 11d1 1/e1 1f1 1+g1 1)h' # 0x0068 -> LATIN SMALL LETTER H 'i'# 0x00691I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t141T1u151U1v161V1w171W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LINEY}*ORIGHZ~0CTILDRB\x7f%7UDELET#)c7#8PCAPITsC WITH CEDILLAJ\xfc@U>DIAERESIJ\xe9@E@6ACU*e2<A<CIRCUMFLE-;\xcA" C*e04AEGRAV|*b6<?PILCROW SIG;\xe7*eagDc'*ebATA8@c@ $e8nI|e|Q@ Au201~D8DOUBLE LOW;\xc mP ah # 0x008f - > SECTION SIGN '\xc9' # 0x0090 -> LATIN CAPITAL LETTER E WITH ACUTE>8>1> FGRAV>a>2> CIRCUMFLEX*f4C3CESMALOA*cbA4ADIAERESIS*cfB5BI Bf6B U@f7A aB8<CURRENCY+d*9*+n*dc,aC ,*a2BbBICENT*a3&c&YPOUND'd8d' :de> Au019~fC FDHOOKw)a6aBROKEN BAR'ba0 AC8)f3a C< aF <aCa b&etCEDILLAbGSUPERSCRIPT THRE}aa4VMACROec@2310Ea4REVERSED NO a % bdQ aVULGAR FRAONE HALF Z5fQUARTE? " 8X :aaEFT-POINTING DOUBLE ANGLE QUOTA5MARbF"ORIGHGPu25917b.LGT SHAD(b/mMEDIUM)oQ/LDARK'0PBOX DRAWINGS VERTICALAu252_8 AND LEFTA61' # 0x00b5 :-> BOX DRAWINGS VERTICAL SINGLE AND LEFT DOUBLE '\u2562' # 0x00b6 I9IYI(56I,7 ICDOWN~E5E8EzE(63E9E#B(51BaB 979b9 wd>c>%UPzc<d</UP}bCeC{ (10CfC@LIGH/WN'14=/c0=RJ3<1< HORIZONTALA2@/c2AC1C3C 0?/c4B|3|5: |G(5e ]P(5fJJ[JaJ5 |(69| |R6cD SZ5C~ [; ~Hc(UPB ['68d( I Z6d55K)d?K5 KaK5tdG AND RIGHT S$INGLE '\u2558' # 0x00d4 -> BOX DRAWINGS UP S3 AND RIGHT DOUBD2D5DODOWNF3F6F{(6bF7FVERTICALJHORIZONTALOaO8O OO1n9OL`!UPHFLEFT;(0ca;k>8yb>FULL BLOCK'4ec'LOWER HALF- d-?EFT,(90Ye,LY -f-?UPPG03b1Z e0- GREEK SMALL LETTER ALPHA0xdf3 e15ZLATIN5sSHARP S7Hu039 e27l@CAPI?nDGAMMnHu03c&e37 &PIiaii9SIGi 77 i5:xb5 xMICRO SIGNceY\6TAU3 a6\\e=3 /'PH9e#5GTHETd(a9l7GOMEG7b7 26DELlH221el&INFINITYcZ 0%3eEPSILO9222/INTERSECTI)6+f+BIDEN#TOxRfPLUS-MINUS1226AfATER-THAN OR EQUAL aHu226wfOLESS2(32Df2TOPlCGRALIu232 oBOTTOM10xf7pDIVISIO8224flALMOST!xbV DE D1fBULLET OPERATOR+xbMIDDLE DO/(21fb -> SQUARE4 ROOT '\u207f' # 0x00fc -> SUPERSCRIPT LATIN SMALL LETTER N =0xb2;=d=5TWOi05a0.ie,BLACK SQUARE)x'Uf)NO-BREAK SPACE ) ### Encoding Map e_map = {Q100:000,FNULL 1 1 START OF HEADING,2,2,2TEXXu3)3)0ENDS '4'4'RANSMISSIOqV5/5/VQUIRY6#6#ACKNOWLEDGfJ7'7'(BE8 8 2ACKGE9%9%HORIZONTAL TABU?a1a1LINE FEEDb%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .z11 .7HRE^1 0EFOUR11NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22EXCLAMATION MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2 AM&AN22APOSTROPH2v2vLEFT PARENTHESISW22ORIGH-2wASTERISh2EPLUS 0x002c: 0x0P02c, # COMMA 0x002d: !HYPHEN-MINUS(e(e(FULL STOP%f%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&6ONE%2%2%'TWJ3%3%7HREL4'4'FFOURr5&5&'IVL6&6&6SIXK7%7%FEVEN'8'8'VEIGHT'9'9'(NI1a&a&GCOLOnb!b!KSEMI%c%SLESS-THAN SIGO\%3dOkEQUALS'[3[GREATERTc3cQUESTION MARK4i4iERCIAL A<4l4lLATIN CAPITAL LETTER 44y4y2B42C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 2b4425525 5  Q5 5  Y5 5  5 5  5 5  U 5  V2 5  W2 5  :5 5  Y 0x005a: 0x005a,  # LATIN CAPITAL LETTER Z *b2b2EFT SQUARE BRACKET/c/c/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(5ESMAL3AX2020 B03030 C04040 D05050 6060 F`7070 G08080 H09090 I0a0  J06 0K06L060M060N06O077`P07 Q07 R07 977  77 U7 V07 W07 X07 Y07 77]CURLY77`VERTIC>_77RX7FTILD77VDELET"af"NO-BREAK SPAC*9?F SIGXa9[POUND&9CURRENCY)WawBROKEN BA aM8{SECTIONNEaDIAERESI*a0ae, # &LEFT-POINTING DOUBLE ANGLE QUOTATION MARK 0x00ac: a, # NOT SIGN$f$7$VMACRO""b0"%f8"jDEGREEI#b1'1'PLUS-MINUS+2+d+SUPERSCRIPT TWO"b3+/a6+FHREE-4-ACUTE ACCENT(5(eU[MICRO6&8&{PILCROW(7(ffMIDDLE DOt8&%a5vCEDILLAb#f#ORIGHbcFVULGAR FRAC% ON3VARTER}d}b7 FHALF4e4 kT1 QUmS:cT%8enLATIN CAPITAL LETTER A WITH GRAVc?/84=CIRCUMFLEX/80B C c9hE? 959| =a=2 =e9= BDIAERESIIs9 B d/99 OdUB dC =d93 CeESMAL>fSHARP ev y 6tet3s;erg @pep8/ = e81; lel8;'8@ee: 0x008c, ## LATIN SMALL LETTER I WITH CIRCUMFLEX 0x00ef:08b,/ #@ DIAERESIS?"f3?/a2? OVACUTE;4;/93;"f7@%f6@DIVISION SIGNi9)%97)#UGGRAVa;a ; b;9vc@/81 2192?/9f? FDHOOK/#39eGREEK CAPITATVGAMMA68p%e9p6FTHET6al46 7SIGl#a6l86 5PHIa/ea4 FOMEG#b1j06 ^GALPH4eR  47DEL#b5heh eEPSILO33c06jPco5g mc>e5TAUkcdf 320182DOUBLE LOW LIN3207%fc]SUPERSCRIPT03221fBULLET OPERATOR3221fSQUARE ROOT'eINFINITY$2veINTERSECTI3224BfiALMOST EQUAL TOS6f{IDENTIC(f!LESS-THAN ORYfOATER4#31aV0REVXD NOT3232-fTOP HALF DGRAL$32oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi#50-b(91VERb#50dT7DOWN AND R=7b= 5LEFw#51c# BOX DRAWINGS LIGHT UP AND R  0x2518: 0x00d9, # BOX DRAWI;FLEFT:c:/c3: VERTICAL{"24A/b4A 22@ ADOWN}HORIZONTAL3/c1B 8@5@ F"50/cdFDOUBLE :1:/ba: "528d4aSINGLE;3 E3E6}#WN4EVEt "55/b8r?6D7DDTD7DbDD=2UP o9d#UPCTaCcK <b</be BIb B dcB}e;c?fIKIOJZ6 PIB;G 6*b HX-b HA)d\u. 5d7JJ`;cJC:/cf ;A E0, # BOX DRA*WINGS UP DOUBLE AND HORIZONTAL SINGLE 0x2569: 0x00ca, # BOX DRAHE+UPHAaA/d8AeVERTICy GNbN7N  cN/ceNE N"80G%dfGUPPER HALF BLOCK,4,c,?LOW,8,b,LFULLR%dd&OLEFT}9ORIGH,1}&b0W,FSHAD #92'1'{MEDIUM (3(2(KDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP864.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,Zcreturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.5pasORead9 9Fs module API getregentry(7 UInfo(name='cp864',d!e=02(). id:.r=]/J //spr7=D #w##)Z~0MapA0codTmap =make_identity_dict(range(256)) 5.update({F{!25;&66ARABIC PERCENT SIGN/DEGREE SIGN 0x0081:@b7, # MIDDLE DOT &2&E2219&BULLET OPERATOR+3+a+SQUARE ROR4'5592'MEDIUM SHADEO5(%00(FORMS LIGHT HORIZONTAL262Z2hVERTIC070/3cb0O ANDo8?/24?7LEFT99xODOWNta;1; R(b:3/UPsc91 d505 e61 4f48 903603b(GREEK SMALL BETA79&E221e_INFINITY$$E03c6$P6PHI+$E00b1+PLUS-OR-MINUS SIGN.+E00bd.FRACTION 1/2(+700bn(4(!&24,ALMOST EQUAL TO+E00ab{D POINTING GUILLEME9600b34  6fef`ARABICATURE LAM WITH ALEF HAMZA ABOVE ISOLATED (7fefXINALUcb: Non  # UNDEFINEDzc%6fef+ 06fefG fa600aSOFT HYPHEa 6fe8YWETTERDMADDa6fe8 J J67%3fe8?# %8fL 9?BEHa/95;T;fe99, # ARABIC LETTER THEH ISOLATED FORM 0x00ac:@60c, # ARABIC COMMA(d(Lfe9d(dOJEEMde</a1</HAf;5;K< b0<K0660<-INDIC DIGIT ZERO#b13 36ONE2222e 'TWd3232 7HREf4444 FFOUR53 : 7FIVf636f 6SIXe7272 FEVEN48484 VEIGHT49494 (NIa3;9)y;a:a;f: 0xfea9, '# ARABIC LETTER DAL ISOLATED FORM 0x00d0: 0xfeab, ;/TH<1<d<?REHw2;f;OZAIN<3</b3<SEEN INITIAL4;7;H<5<*?SADv6:D:7:/c1/TAb8;5;Z;9;`a:/GH<b<E00a6BROKEN VERTICAL BARc/c/NOT SIGN$d$fDIVISION)e)d)MULTIPLICAT/f/Efec9| ppepL0640;uTATWEELe^dF^e] ?QAFe[dK:Zd?LAMtXe?MEE;Ye ?NOO eZeH^Ye?WAWeYe%ALEF MAKSURADcf/Ya?febm6fecm i=MEDqeLfece NULL!1!1!START OF HEADING-2-2-ETEXT*3*3*0ENDU (4(4(RANSMISSIONX5050UQUIRY$6$6$ACKNOWLEDGl7(w7 -> BE8!8!tACKSPACGt$c9&HORIZONTAL TABULATn2a2LINE FEEDb(# 0b&oVERTICV:x0c0c0 Vr$d&CARRIAGE RETURme.e,SHIFT OUf&f&IK11DATA LINK ESCAPR*x11DEVICE CONTROL ON/ 1 /4TWOX11 /6HRE` 1 1EFOURa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE )191YUSZ'\x1a*SUBSTITUT 1  1ILE SEPARATOVduGROUP SEPARATOR '\x1e' # 0x001e -> RECORD SEPARATOR "-f-f-LUNIT+ (3 X 20+RSPACEM!"1"EXCLAMATION MARK-"-2-LQUOT+#+3+NUMBER SIGNS$(4(XDOLLA(`\u066a-5(ARABIC PERCENTX&+/60MPERSAND~1"'"# 7&POSTROPH%(M8'LEFT PARENTHESIST-')-9-ORIGH.*.a.sASTERISx+%b%GPLUS,&c&RCOMMA-"d"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3DIGIT ZEROK1''#ON2&&#TWL3&{&3HREN4({3FOUo5'zO3FIVN6'q'2SIX7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33L31LfM3004d -> LATI N CAPITAL LETTER M 'N'# 0x004e -> LATI3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1 5c0REVERSE SOLIDU]+ ,d,?IGH]^1$CIRCUMFLEX ACCEN_.rOW LINE`%6YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1 1L1m11n11o1p17bq1r1s1Pt1"u1 v1 w1 # 0x0077 -> LATIN SMALL LETTER W 'x'# 0x00781X1y191Y1z1a1Z1{1b1EFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%>f"UDELET#)b0#"80#GREE SIGNJ\xb7(1(MIDDLE DO`\u2219)r 82'BULLET OPERATORS,a,3,SQUARE ROT8592(4(MEDIUM SHAAu250}5)qFORMS LGHORIZONTAL)50\631(3cd1_ AND q(24@@6LEF[)52z:ODOWNv1<< t ;/UPu : 06 1 7 58 5803b291/KEBETA=721ea96sINFINITh\u03c6%4R3PHIQ0xb1*# 94PLUS-OR-MINUSd/;FRACTION 1/2XtX;)4)Hu224391ALMOST EQUAL TO,:xab~,L POINTING GUILLEM/;\xb4 5Aufef`ARABICATURE LAM WITH ALEF HAMZA ABOVE ISOLATED Y 8YZFINALV)ffSUNDEFINED| &?&!ef2/ H@H P xa0' # 0x00a0 -> NON-BREAKING SPACE '\xad' A # /1/SOFT HYPHEN(Pufe82*(2(ARABIC LETTER ALEF WITH MADDA ABOVE FINAL FORMK0xa3I s3KPOUND SIGr:xa4'4'CURRENCY*,5*OHAMZPufffewK6KUNDEFINED &7&)e8L8& "f9:BEH ISOLATED^Xufe95<a<T<9<b<H=H060c=c=UCOMMA>!e9udd)KOJEEM(a1fe=/HAaf<K=G0660ybX-INDIC DIGIT ZERO8066b]4$ONHu066hbh g(TWfRPbPfHTHREh4b^5GFOUR@bh 8FIVh67Qh7SIXg73^3&EVH06685m WEIGHTjbh 5&NI9fed`F#(1b`SEMICOLOIufebiP'OSEEN'bd/SH> e?SADz8061beQUESTION MARK!xacYLCENTcK8LcV>NqcqN NcN2WAWYMeca' # 0x.00c5 -> ARABIC LETTER AIN FINAL FORM '\ufe8b' # 0x00c69 YEH WITH HAMZA ABOVE INITILdL7LALEF ISOLATED(91=8=?BEHx(93;9;TEH MARBUTA7DaD9Cb;Hfwc<OJEEMad</HA2ae;K<9f<?DALfa+.d0</TH=_.d1=Rg^ah.d2<Z!bi.d3=OSEENbj/d4<H= /?SADx D;cdTXh'c5dZ< zc/GH=0xa6dBROKEN VERTICAL BAR3:xac0NOT SIGN%fUDIVISION*d*MULTIPLICAT0Hufecd@0640esTATWEELHufedenFnfm?QAFdekK;ej/LAJehMei?NOOej9e e8 -> ARABIC -LETTER WAW ISOLATED FORM '\ufeef' # 0x00e9 -> ARABIC <ALEF MAKSURAE(f3EaEYEH INITIAL(bd;b;?DADw(cc<c<~AIN MEDv(ce:d: GH<=FINce;o1yf>OMEEM7{'f0=oSHADDA8065s-f16H 5'f2+ ONOON(e9=3=H/f4<(f0v5: (f2B6B9d{79Edj8<?QAFif< IGATURE LAM WITH  M"_ABOVEY6  Y' /dTK' x925aBLACK SQUARE2(ffIfUNDEFINED ) ### Encoding Map e_map = {L}100:000,FNULL 1 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSIONV5/5/VQUIRY#6#6#ACKNOWLEDGa7'7'(BE8 8 wACKSPACE9%9%HORIZONTAL TABULATa1a1LINE FEEDb%b%oVERTICTc/c/ Td%d%CARRIAGE RETURde+e+SHIFT OUT 0x000f: 0x000f, # SHIFT IN "10$%10$DATA LINK ESCAPE,1,1,EVICE CONTROL ON.2.2.6TWO\3.3.7HRE^4040FFOUR_5/5/NEGATIVE ACKNOWLEDG_6060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCK8585fCANCEL"9"9"WfMEDIUM)a)a)SUBSTITUTb&b& c"c"FILE SEPARATONd*d*_GROUP+e+e+oRECORD,1OUNIT*22FSPAC22EXCLAMAT6MAR22OQUOT*2NUMBER SIGT22LOLLA'd2dAMPERSAND2]2]APOSTROPHN2NLEFT PARENTHESISRX2XORIGH-\2\wASTERIS@Z2ZKPLUS]2]VCOMMAT2THYPHEN-MINUQ2QFULL STOPMJ2JWSOLIDH3C3CDIGIT ZER3H3H&3A3A%3<3<% 3<3< 33M6FIV3a3a&5SIX+3a3a%6EVE3b3b'E<N]3]''NI3V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES_4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4yLATIN CAPITAL LETTER B 0x0043:, # LATIN CAPITA2C24242 D25252 E26262 F27272 G28282 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R2 /532 S2 5  T2 5  U2 5  V2 5  W2 5  X2 5  Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5fOW LIN66\GRAVEL66ESMALA366 066 066 066 06 0 66 0 66 066 066 066 0660 LETTER L 0x006d: ,  # LATIN SMALL LETTER M 0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKENc.c.VERTICAL LINEW%7d)ORIGHX7GTILDP7VDELET"aaNON-BREAKING SPAC.c.CENT SIG\aa[POUND&aCURRENCY)[dkuBROKEN D&BAa9ZPPOINTwGUILLEMad,NOaSOFT HYPHEbO8!jDEGREEb9#LUS-OR-MINUS.-8|MIDDLE DOeb#<b9FRACTION 1/4b9(2(ddMULTIPLICAV *f/PDIVIS)#3bx9WUKDBETA#3c09K,4PHI+#60aARABIC COMMS#61[b(SEMICOLO#61sbs,AQUESEMARK42e0uTATWEEL*55f*uSHADDAH*6TbT-INDIC DIGIT ZER#66]b] 3O#66bh 2'TWdb2-INDIC DIGIT THREE 0x0664:@0b4, # ARABIC-INDIC DIGIT FOUR35353 'IVf6363 6SIXe7272 FEVEN48484 VEIGHT49494 7NINa32 PERCENT SIG3221b%82bBULLET OPERATOZ3221Z%83+SQUARE ROOB221e%91'INFINITY3224 9rLMOST EQUAL TO+2500O8pFORMS L* HORIZONTAL222]2hVERTIC0c0d0DOWN AND Rqf1c6 5LEF#51/8e5/UPi,/8f4 ga3m2  : s2s9E3tb9tt ?9(]MEDIUM SHADR325afbBLACK Bfe7dH%f0P0DA ^0AL 58]c.5LETTER HAMZA ISOLATED=1rc =ALEF WITH MADDA ABOVEMaM=FIN3) aMc J2WAW-bd L?YEHLMNITI.7c Kla< fa 9?BEH(9ut;9 uIC LETTER TEH MARBUTA ISOLATED FORM 0xfe95: 0x00aa, # ARABIC LETTER TEH;7;c; kNITIALu9:/abuHvb<c< wd;/adwOJEEMf</cc< w"a1;/ae;/HAc"a3;c;ufuK;a<wcw?DALba/d0/TH</d1<RPa/d2;OZAINbb?SEE</d3x<ebb/SHx/d4x=yb?SAD+5w;ueD:b6u;uc/d7:Tc/d8;Z;`d>#ca*`;cs.~Qdef d,'@XtableStreamWriter(C,DpassORead9 9D### 2s module API getregentry(7 UInfo(name='cp865',d!e=02(). i:'r=E r/J //spr7=D #w##0) IZping MapA0codTmap =make_identity_dict(range(256)) 5.update({F0x0080: 1c7,# LATIN CAPITAL LETTER C WITH CEDILLA?1?+fc?ESMAL=U=DIAERESIS?2?/e9? E?VACUTE;3;2; A;CIRCUMFLEX@4@4@5?0?GGRAV6;5;RING ABO@7@  t8=a} r79@b@7a?8? 7b;f; Izc?e?d@  e;ck dfA 2A49 i B k9/e6;IGATURE A9c3p5f( O 0x0094: 0x00f6, # LATIN SMALL LETTER O WITH DIAERESIS +7@95: /f2?VGRAVE;6;b; UzCIRCUMFLEX@7@9@ {8;f; Y{9?d4oCAPITA6aAc AbA+f8AWSTROKxc<%a3<POUND SIGN^d&db  de>F20a7d[ESETAef'?019> FEHOOK!a0:50e1aA:FACUT#a1;d; I;2;f;v v3;av  ;4; NGTILDd; =a FEMININE ORDINAL INDICATORb6oMASCUL7 bINVERTED QUESTION MARE2310RREVERSED NOTjarar$UbVULGAR FRACONE HALFMbX4gQUARTE%^aqEXCLAMAp U700a1EFT-POINTING DOUBLE ANGLE QUOTEs50a46CURRENCY2bb6259LIGHT SHAbbN'25lMEDIUM(;6259;LDARK&&6250BOX DRAWINGS EICALb"62527 AND LEFT@'6256 @q1 SI\ArH2?256HXHD6255a CDOWN| DQE2555D DOWN SINGLE AND LEFT DOUBLE 0x00b9: 0x2563, # BOX DRAWINGS/ VERTICALHAaA/51A8b878 ODOWNuc=d= /UP;d;c;$UP3HSING3eBbB2}RfB/10B@LIGH#c0<4< RIw"c1;3;HORIZONTAL@2@2; B3B1B m 4A0: z593zF6F/5e} #c7IfI JIZ8IaI@5<z/69zM/66A C6 B |6R|G 62UP A Rd/68N H^d%6/WN//65&75k 95 gCCC/52EBp#WNV>6AL DOUBLE AND HORIZONTAL SINGLE 0x00d8: 0x256a, # BOX DRAWINGS VERTIC89 ANNHDOUBN9N/18NLIGHT UPGFLEFTa:/0c: ADOWN<RI=b=8wFULL BLOCK&c&4cLOWER HALF,d,+e+%90W,f,8,?UPP e0,E03b1X GREEK SMALL LETTER ALPHA!e1450df4ZLATIN4vSHARP S62653936j@CAPI4lGGAMMl36c6 &PIg41ag 8SIGg56c6 g 46450b5MICRO SIGN7&&3c6TAU2-E03a6X2 )'PH60394GTHET]O03a9j GOMEG6?03b 8DELj521ejINFINITY<03c  '03 2gEPSILO&22INTERSECTI(f6226BIDEN%TOfCPLUS-MINUS f62263GREATER-THAN OR EQUAL _6226oOLESS1623232TOP)FGRAL6232oBOTTOM0%f7DIVISION6224oALMOST&0b DE R6221BULLET OPERATOR&0bMIDDLE DOf6221SQUARE RO'&07SUPERSCRIPT lf50b2/<'TWG625abBLACK '00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00'00 -> NUL(!1!1!START OF HEADING '\x02' # 0x0002 -> START OF TEXT*3*3*=END(4(4(RANSMISSIONX5050UQUIRY$6$6$ACKNOWLEDGE(7(7 -> BELL!8!8!tACKSPACGt$ 9&HORIZONTAL TABULATn2a2LINE FEED~b(mb&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETURme.e,SHIFT OUf&f&IK)10% 10%DATA LINK ESCAPR:x11-1-EVICE CONTROL ON/ 1D/4TWOX11 /6HRE` 1 1EFOURa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE*19vYeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAN1"'"APOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ>b3{DIGIT ZER8''2/&y&) '3' # 0x0033 -> DIGIT THREE '4'(4(BFOUR'5'5'#IVN6'6'2SIXM7&7&BEVEN(8(8(REIGHT(9(9(3NIN:'a'CCOLOq;"b"GSEMI&<&c&LESS-THAN SIGQ=+d+gEQUALS(>(e(|GREATERV?.f.QUESTION MARK@* 40*COMMERCIAL ADA*1*LATIN CAPITAL LETTER A]B323B3C3fC3D33D3E33F33FfG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33tO33OfP35'3P3Q30Q3R30wS30SfT30U30UfV30V3W30W3X30\Y30YfZ30Z3[30EFT SQUARE BRACKEb$\\1f5-REVERSE SOLIDU]+ ,&R]^1e -> CIRCUMFLEX ACCENT '_'# 0x005f -> LOW LINE%`% 60%YGRAVENa)1)LATIN SMALL LETTER AZb121B1c131C1d141D1e151f161Fbg171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1O1p17P1q1Q1r1R1s1S1t1"u1Ubv1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL|}*ORIGHZ~0CTILD3\x77UDELET#"c7H#8PCAPITC WITH CEDILL3\xf@U>DIAERESIJ\xe9E@6ACU*e2<A<CIRCUMFLE-J\xe4A"A0@1@HGJ\xe5<<<RING ABOVe7 -> LATIN SMALL LETTER C WITH CEDILLA '\xea' # 0x0088 -> LATIN SMAL>E>IRCUMFLEXAbA9A DIAERESIS@8@a@ UGRAVE<f<b<I|e@c@ CcAdA *c4<e<eCAPITA|A*c5BfB RING ABOB)c9C/90CFACUT6>1>=IGATURE A4c4246f-&936jO+fw4A +*f25@ f#/96<U 7A } $9Y} d9 |B %9 B Bf$9USTROKq*a3POUND SIGNLdd fPu20a7hH9hPESETAgAu019J( FDHOOK e1a a ;/ d<* <fAa x < _a < N+ETILDd< >a FEMININE ORDINAL INDICATORb7oMASCUL8 aINVERTED QUESTION MAR Pu2310GaREVERSED NOT SIGN '\xac' # 0x00aa -> NOT SIGN Z'\xbd%b% VULGAR FRACTION ONE HALF5 Zc5tQUARTER8*a1md8INVERTED EXCLAMArEMARK6b6e6LEFT-POINTING DOUBLE ANGLE QUOTF4FfFCURRENCYAu2598 b0*LIGHT SHADE(2T(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS /FICAL248 P AND @A65As1 SIcByI 6IYI(5627ICDOWN~E5E8E 9E|# ^  B979 w>%UPAz< </UP}C C{ (10 C1c=R3<<HORIZONT@cAC1C   0?c|3|y|G'5ec ](5fJLJ[JaJ5 |(69| |R6cNGS DOUBLE D BOX DRAWINGS DOUBLE VERTICALHVRIGHTC5CdC~c~e; ~H7HfHUP SINGLEB'68I/d0I Q_I4I1ID5K2K(59K3K#UP( 5#4DD(525D F3F6F{(6bF7F}JB(6aO8O9OeO1n9OL1 UPH7LEF0]/da;kdy8yb>FULL BLOCK' @LOWER HALF- *,9Vd-8-?UPPG03b1e GREEK SMALL LETTER ALPHA0xdf3(eZLATIN5sSHARP S7Hu039eleCAPITAnDGAMMnHu03ce7 &PIiai2 i9SIGi 77 i5!xb xMICRO SIGNceY\6TAU3 a6he=3 'PH9e#5GTHETda e7GOMEG7b7 26DELlH221e&INFINITYcZ 0%3MALL LETTER EPSILON '\u2229' # 0x00ef -> INTERSECTI)'61)!f0)DENTICAL TOR!xb'R f1)PLUS-MINUS SIG~(65U2,GREATER-THAN OR EQUaXu2264535OLESS28320242TOP HALFCGRALAu232 f5.oBOTTOM10xf7]61DIVISION 48,[7*lALMOST!xbV8,kDEGREET1 f9(BULLET OPERATOR+xba,MIDDLE DOT'Xu221ab'SQUARE RO(807f(c(UPERSCRIPT LATIN SMALL LETTER 0xb2;d=$TWTAu25a8e,bBLACK x'UNO-BREAK SPACE ) ### Encoding Map e_map = {Q100:000,3)2NUL- 1 1 START OF HEADINGL2,2,2TEXU3)3)0ENDS '4'4'pRANSMIS5/5/VQUIRY#6#6#ACKNOWLEDGE'7'7'(BE8 8 2ACKG9%9%HORIZONT0ABU?1a1a1LINE FEEDb%b%3VERTc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .z11 .7HRE^1 02FOU_1NEGATIVE z11SYNCHRONOUS IDL1Fe BLOCK@11VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPAN1GROUP SEPARATOR 0x001e:, # RECORD SEPARATOR ,f,f,OUNIT*"20*%20*USPACEK#21!1!EXCLAMATION MARK,2,2,OQUOT*3*3*NUMBER SIGNQ4'4'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt7%7%POSTROPH8&8&LEFT PARENTHESISR9,9,ORIGH-a-a-wASTERIShb$b$KPLUSc%c%VCOMMAd!d!HYPHEN-MINUy%2e(FULL STOPMr2rWSOLIDH3k3kDIGIT ZEROI3p3p&&ON~3i3i%'TWJd3d%7HRELd3d6FOUR3c3cM7FIVLa3a&6SIXa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G242H242I242J242n44&Ld4dM2 4  # LATIN CA PITAL LETTER N 0x004f:, # LATIN CA2O2"502/502 P21212 Q22222 R23232 S24242 T25252 U26262 V27272 W28282 X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKE[c/c/REVERSE SOLIDUd+d+?IGH[e0e0CIRCUMFLEX ACCEN%5f-LOW LINE66\GRAVEL66ESMALAX6 0B06 0C06 0D06 06 0F`6 0G06 0H06 0I06 0J06; 0K06k 0L060M0606677`77 77 77 977  77 77 77 77 79: 0x0079,  # LATIN SMALL LETTER Y 0x007a:,0Z0b0b0EFT CURLY BRACKET.c.c.VERTICAL LINE)d)d)ORIGHXe/e/GTILDPf!f!VDELET""a0"f"NO-BREAK SPAC*1*a INED EXCLAMATION MARK"a359POUND SIGN&4&aCURRENCY)%a6 FEMININE ORDINAL INDICATOR_a'LEFT-POINTING DOUBLE ANGLE QUOT%aa{:NOTbM8$kDEGREE'J%f1'PLUS-MINUS+2fuSUPERSCRIPT TWO"b5+e[MICROQ7&fMIDDLE DObh7PMASCUib$VULGAR FRAC ONbFARTEbaM7FHALFakAQUESm ce8PCAPITA WITH DIAERESISsca8TARZFABOVC"c6}%92W BIGATURE A5/805CvCEDILLA9t? E?7ACUd/a5| N=T}d9= O=q#d8 /AVSTROK8d9>UceA DfSHARP &e83 6e7GRAen ; e(+83l;CIRCUMFLEX&e4@e|+e+ke sETTER C WITH CEDILLA 0x00e8:08a, # LATIN SMALL LETTER E WITH GRAVE;9;2;GACUT;a;8;CIRCUMFLEX{b@9@DIAERESIS?c?d? Id;/a1; e;/8c;f@b@"f1?/a4? NFTILD"f2;/95; O; %"f3;a% ; 0"f4;/93v0#f6@ {07?%f6DIVISION SIGNNfC9 hWSTROKZD%97eUZDa ; Z?9vZ@ {Z9 Y ?$19f4 F?DHOOK#39eGREEK CAPITAEGAMM##39em6FTHET6al~67SIGlae65PHIaDe4FOMEGb%e0F6 GALPH4e47DEL"b5G/eeh eEPSILOT33c06jPco1 mc}45TAUkc923207fSUPERSCRIPTl320a9;hPESETA3221f BULLET OPERATOR 0x221a: 0x00fb, # SQUARE ROOT b0x221e'%ec'INFINITY$#29$f$TERSECTION("48(%f7(ALMOST EQUAL TO+#61+0+{IDENTIC(4(3(LESS-THAN ORY5121GREATER423104%a940REVD NOT SIG#32-%f4-TOP HALF INTEGRAL$325-oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi2502b(91VERb250c7'da pDOWN AND R=7bt=5LEFw#51c</UPwfd; uc%{2b fA 223/c1 8@  F5doDOUBLE5bq:l5d4aSINGLEw NE36#WN4EVEt 45/b8r?6bg F{DTD7D DKD=2UP oSd#UPCTcK <be AQBIb B dzB}cAWINGS VERTI CAL SINGLE AND RIGHT DOUBLE 0x255f: 0x00c7, # BOX DRAWINGS VERTII8IZI#60IcI@PB1B/b5B;z=LEF#62H6H HX3H9H?HA4A/d1A(WNHORIZONTAL#65J2JJ 6J/cbJQ DOWNaJ7CfC/UP8H/d0H9H/caHE/UPaA/d8AL G bNRf;mcN/ce G8dUPPER HALF BLOCK,?LOW,OLFULLR%ddq}9,1ALFSHAD9{MEDIUM (eKDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP866.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,creturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~eal=False):   return codecs.charmap_de(input,self.errors,ing_table)[0] class StreamWriter(CO,D8cs.0): xJpass9ORead9 9### encodings module API def getregentry(7 QInfo(name='cp866',d!e=02(). incremental:6r=IE/er/J /D/spr7=c*R#w##0) IZping MapAWd_map =make_identity_dict(range(256)) map.update({F0x0080: 0x0410,k # CYRILLIC CAPITAL LETTER A51515&BE62626V63636'GH74747D65656I66666Z7777m8686I{9595gSHORT ;a;a;K"b6b6&ELc6c6M6d6d6N6e6e6O5f5f5P9d2d%ERl9e2e&ES6e2eTe2eUkc2c&EF6c2cHP9c2c'TSc2cC9d2dSf2fC9a: 0x042a, # CYRILLIC CAPITAL LETTER HARD SIGN 0x009b:@42b,/ #=FYERU8c8c8KSOFTud=d=Ere5e5Yf6f6Al"a06.306ESMALQ31313 B#a2424 V43434 'GH54545 D45454 I46464 Z7575 i8484 I9393 gSHORT 9a9a9 KW3W A&ELS3S 4M4J3J 4aI3I 4OgF3F 3PbD6259LIGHT SHAgb86259lMEDIUM(,6259LDARK&6250NBOX DRAWINGS vVERTICA{b 6252 7 AND LEFT b,6256 @qu SINGLEAg DOUBL4@?256H8HXS6255 CDOWN|Dc6255DxDt6256 D Y|?255YpAy6255Tyu6255U=%UPx6255 ;/UPw6255: BuLE 0x00bf: 0x2510, # BOX DRAWINGS LIGHT DOWN AND LEFT (c0x00c0<4< !UP:RI;1;3;HORIZONTAL@2@/2c{ B3B1B VERTICAL4A0: z593zF6F/5efSINGLEv DOUBLEK7IfI 8IZI8IaI@9<< Na>/69zMbA6A CcCN dB5B |e:6R|G /672UP A Rd/68HH^Qd%6/WN//6575k#UP$95 CCC/52EB3EyV>/6bEIC6CNNdU1i dQ0Q:6wM8wFULL BLOCK&08LOWER HALF,8+ 9E , 0x00df: 0px2580, # UPPER HALF BLOCK 0x00e0: 0x044, CYRILLIC SMALL LETTER ER4141`4S42424 &TE43434 U34343 &EF45454 &HA46464 'TS7575 'CH58585 S9595C7a7a7 HARD SIGNb;b; 7YERc6c6 KSOFTqd;d; Ke3e3 Yf4f4 fT0 eCAPITAV%IOBfV56 4V0 jUKRAINIAN Ifb5@ t>m0 ~&YIo56 t4o0 jfSHORT fu5; o 9y&0bjDEGREEfk6221kBULLET OPERATO8f_&0bMIDDLE DOT J6221SQUARE RO';6211kNUMERO''0a{URRENCY)625abBLACK }0(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'0 # 000 -> NULL!1!1!START OF HEADING-2-2-2TEXlx3*3*0ENDU (4(4(RANSMISSIOX5050UQUIRY6$6$ACKNOWLEDGL7(w7 -> BE8!0x0008 -> BACKSPACE '\t' # 0x0009 -> HORIZONTAL TABULATION2n2a2LINE FEED&2x0b(Xb&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETUR2x0e.e,SHIFT OUTf&f&IK)10% 10%DATA LINK ESCAPR:x11-1-EVICE CONTROL ON/2/2/4TWO*13/3/6HRE`4141EFOURa5050NEGATIVE ACKNOWLEDGa616 -> SYNCHRONOUS IDL-7-7- END OF TRANSMISSION BLOCK8686eCANCEL#9#YeMEDIUM*a*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+ 2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAN3"'"2APOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ>{3{DIGIT ZER8''2/&y&)&&t& (t'sO3FIV$ 'q'2SIX3&q&3EVE(r(EKP(m(NINE ':'  # 0x003a -> COLON ';'"b"GSEMI&<&c&LESS-THAN SIGQ=+d+gEQUALS(>(e(|GREATERV?.f.QUESTION MARK@* 40*COMMERCIAL AT*A*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353E3F363F3G373G3H383H3I393I3J3J3K33[L31LfM3fM3N33tO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\1Y5-REVERSE SOLIDU]+5&ORIGH]^1$CIRCUMFLEX ACCEN_.cOW LIN`%6YGRAVENa)LSMAL5b1 13c1 11d14 -> LATIN SMALL LETTER D 'e'# 0x0065 -> LATIN SMA1E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t141T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LIN^}*ORIGHZ~0CTILDR3\x77TDELET#Pu0410J#8CYRILLIC CAPIT:A\6166Bm277V7377(GH84886577In67 7Z788o877966hSHORT <a<*<K,b707Ec7877d7008d -> CYRI(LLIC CAPITAL LETTER EN '\u041e' # 0x008e -> CYRI7O6f6f6 &PE7'207/907 'ER71717 S72727 T3737 Um4646 'EF75757 'HA76767 (TS7878 (CH88888 S9898 C:a:a: HARD SIG(2b>b> 8YERc9c9 LSOFTwd>d> ]9 Y9 Y;3aESMAL&Ao3a 4B3a 5V5}a} 5G3}a} 6Dk{a{ 5I5yay 5Zwaw 6ktat 5Ipap 4hSHORT :pap :Kgag 5'ELcac 5M5ZaZ 53YaY 53VaV 48259 bTLIGHT SHAs8259bHmMEDIUM)b<LDARK'0P.BOX DRAWINGS LIG)HT VERTICAL '\u2524' # 0x00b4 -> BOX DRAWINGS LIG8 AND LEFTA(61A5Asu SINGLEBw DOUBLEI2I6I9IYI(56I7ICDOWN~E5E8EzE(63E9EIB5^aB 97{b9 (5d>c>/UPc<d</UP}bCeC{ (10CfC1/c0=R"y3<1< HORIZONT@/c2AC1C3C 0?c|3|y |G'5ec ](5fJJ[JaJ5 |(69| |R6cD SZ5C~ [; ~Hc(UPB ['68d( I Z6d55K)d2 -> BOX DRA BOX DRAK(UPI^RIGHTD8D/4 DwD2D5DF3F6F{W(6bF7FVERTICALc(6aO8OO1n9OL!UPHFLEFT;(0ca;k7>8yb>FULL BLOCK'4ec'LOWER HALF- d-?EFT,(90Ye,-8-f-?UPP8044- e0- CYRILLIC SMALL LETTER ERG0441/e15S5/e25'TE5eU4e4'EF555'HA565t5(TS76d6(CH6eK6Se26C8e/8HARD SIGNDe-<8YERe=70SOF sdSL<Qe4T4Yf5\5'0/fd@CAPIf&IOH57f50ff lUKRAINIAN I5Ar ?0f} 'YI 750e' # 0x00f.6 -> CYRILLIC CAPITAL LETTER SHORT U '\u045e' # 0x00f7<OSMAL:0xb08:8:DEGREE SIGNb@2219*b9(BULLET OPERATOR,0xb7*Ta,MIDDLE DOT'Pu221a)Sb'SQUARE RO(8116(c(hNUMERO0xa4&wd(CURRENCY*Au25aze*bBLACK x'Sf)NO-BREAK SPACE ) ### Encoding Map e_map = {Q100:000,FNULL 1 1 START OF HEADING,2,2,2TEXiu3)3)0ENDS '4'4'RANSMISSIOV5/5/VQUIRY6#6#ACKNOWLEDGE'7'7'(BE8 8 2ACKG9%9%pHORIZON8yTABULATa1a1LINE FEEDb%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .5TWOP11 .7HRE^1 02FOUz11NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPAN1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2@NUMBx22VOLLARm'2{PERCENT(6: 0x0026, # AMPERSAND 0x0027:,%POSTROPHE&8&8&LEFT PARENTHESIS,9,9,ORIGH-a-a-ASTERISKQb$b$PLUS SIGN%c%c%VCOMMA!d!d!HYPHEN-MINUe(e(FULL STOPMf%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&&ON~#32%2%'TWJ3%3%7HREL4'4'FFOUR5&5&'IVL6&6&6SIXKa,37%6EVE3b3b/E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cQUESTION MAR4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G242H242I242J242O4&Ld4dM2 4 24425525 5  Q5 5  Y5 5  5 5  5 55, # LATIN CAPITAL LETTER U 0x0056:, # LATI2V27272 W28282 X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKET/c/c/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(ESMAL-AX2020 B03030 C04040 D05050 /660 F`6 G06 0H06 0I06 0J06 0K06L060M060N06O077`P07 Q07 R07 977  77 77 77 77 77 77 77]CURLY77`VERTIC8_77RX7FTILD77VDELET"af"NO-BREAK SPAC*Cfd, # CURRENCY SIGN 0x00b0:0f8, # DEGREE'7'a'MIDDLE DOTM3401&0& CYRILLIC CAPITAL LETTER IO64626UKRAINIAN IE@4@&YI6ev66uSHORT U;148A5/81pB"128V6363l'GH78ID65m5m#166Z/87mZ8m959k!\#1a;.pK"b6bq&ELc6c6M6d6d6-#414/8e6#1fkf5P2d9d%ER2e9e&ES6e9eTe9e;2c9c&EFc9cHP2c9c'TSc9cC2d9dSf9fC9d9dIHARD#42k9k7YERm9mKSOFTut9ts9sYt9f, # CYRILLIC CAPITAL LETTER YA 0x0430:@0a0,r # CYR6ESMAL431313 &BEg2424 V43434 'GH54545 D45454 I46464 Z7575 i8484 Im9393 gSHORT 9a9a9 Kb4b4 &ELc4c4 M4d4d4 N4e4e4 O3f3f3 P4DeD %ERh4EeE &ES4EeE TEeE UgCeC &EF4CeC H:4CeC 'TSCeC Cx4DeD SFeFC7DeD HARD SIG4KeK 7YERMeM KSOFTqTeTSeS YTeT 5 f  I5fKRAINIAN 5Zf Y15f j3211fhNUMERO3221fBULLET OPERATOQ3221xfb, # SQUA RE ROOT 0x2500: 0x00c4, # BOX DRAWINGS LIGHT HORIZONTAL929/b39 hVERTIC7c7/da7 DOWN AND Rt1/bf=6LEF"14y/c0< /UPw8;/d9; uc%{2b fA 22 o3/c1B 8@5@ F5/cdFoDOUBLE"51bq:l5d4aSINGLEw NE3}/d6#WN4EVEt 4"55/b8r?6D7DDTD7DbDD=2UP o9d#UPCTaCcK <b</be BIb B dcB}e;c?fIKIOJZ6 PIB;G 6*b HX-b HA)dRAWINGS DOWN" SINGLE AND HORIZONTAL DOUBLE 0x2565: 0x00d2, # BOX DRAWINGS DOWN4 J`J6J/cbJyQ C7CfC/UP8H/d0H 9H/caHE+UPHaA/d8AVERTICALbN7N  fdcN/ceNE NG"80GdUPPER HALF BLOCK,4,cs?LOW,OLFULLR&ddR?EFT}9ORIGH,1bAL,FSHAD=#92'1~{MEDIUM (3(eKDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP869.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,wcreturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.5pasORead9 9Fs module API getregentry(7 UInfo(name='cp869',d!e=02(). id:.r=] /ntaldecoder=IncrementalDecoder, streamreader=S R #Ewrit#W #q) ### Zing Map dhing_map = ucs.make_identity_dict(range(256))5.update({0x0080: None,# UNDEFINED%1%2%3%4%5%6: 0x0386# GREEK CAPITAL LETTER ALPHA WITH TONOS7f8f50b7fMIDDLE DOTK9&%ac&NOT SIGN$a$BROKEN BAR&b&E2018J0LEFKNGLE QUOTATION MARK6c696ORIGH7d76038mCEPSILONEeCE2015zpHORIZON f*6038mT#90?ai?/IO@1@a@DIALYTIKAg"92D8_OMICR09%9%#95U9C/abT C7&0aDCOPY9N?38fq OOMEGi%b2ASUPERSCRIPT TWOp/b3+FHREE-w'03OSMALK9600alZPOUND9o%adem9m<03a Ea| =?ac?>&a/90 BK ANDac !a3&3cGREEK SMALL LETTER UPSILON WITH TONOS 0x00a4:@391, # GREEK CAPITAL CVALPHA65626 7BET56535 GGAMM67646 8DELl8656 E9868 Za575 4b450bd4 VULGAR FRACTION ONE HALFc453984)THjd696 (IO@e550ab5LEFT-POINTING DOUBLE ANGLE QUOTAFMARKfEbEORIGHF b0F'25LFe SHADEm#b1'lMEDIUM(2(LDARK&3&0NBOX DRAWINGS VERTICALN62527P AND W@XawFKAPP#bYh6GLAMD6Ycl &MUViN3Q6256o HJ]6255A a62558ODOWNuj6255=/UP;oeW &XIm?39f3 vOMICRON8`E25108 cV1 wcj3;HORIZONT%c2y B1B T 0: z?253zFaHP$ca3RHO 0x00c8: 0x255a, # BOX DRAWINGS DOUBLE UP AND RIGHT (c0x00c9<4< ODOWN>a>/69> zHORIZONTALbA6A CcC0C VERTICALdB5B |e:/6c|GfGE03a3G GREEK CAPITAL LETTER SIGMA<#d0666TAU4145j vUPSILON828l6PHI4347l C44484 'PSh54GOMEG>66+b1jESMALrGALPH47424 7BET383  g8GAM1 L6LEFd0:N d8wFULL BLOCKo8vLOWER HALF,Y603b, 8DEL1S<03b 4EB6258?UPPe8b bZe7b 3 21bM)TH41b f'IO.e0bgFKAPPe0/bb GLAMD4.YhMie+de N1)e1 Xe&O03bf1 WOMICRe"603c)Pg?03c( 5RHO"e"?03c e*cZ TFINAL 0x00ee: 0px03c4,  # GREEK SMALL LETTER TAU 0x00ef: 0x0382UTONOS'!f0'50adYSOFT HYPHEN'1'%b1'PLUS-MINUS SIG+2+53c5+gUPSILO63666 6PHI4272 C252&0a2{SECTION6(?3c8Z 'PS728DIALYTIKA w8150b0c DE' 9'aDIAERESIa%53c9LJ VOMEGA=b4b4 e WITH EcEyEL ANDdO/ce  Se?625aSBLACK SQUARE0(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'x0 # t000 -> NULL!1!1!START OF HEADING-2-2-ETEXT*3*3*0ENDU (4(4(RANSMISSI5050UQUIRY|6$6$ACKNOWLEDGqL7(w7 -> BE8!8!2ACKY2'\t$ c9&HORIZONTAL TABULAn2a2LINE FEED&2x0b(b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETUR!e.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /4TWOX11 /6HRE` 1 1EFOURa 1NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE )191YeMEDIUMMa' # 0x001a -> SUBSTITUTE '\x1b' # 0x001b'VESCAP#c#c#FILE SEPARATORNd+d+_GROUP,e,e,oRECORD-f-f-LUNIT+ ($ 20+CSPAC!"1"EXCLAMATION MARK"-2-LQUOT+#+3+NUMBER SIGNS$(4(XDOLLA(%(5(wPERCENTQ&)6)AMPERSANDw1"'"7&POSTROPH(M8'LEFT PARENTHESIST-')-9-ORIGH.*.a.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3{DIGIT ZEROK1''#ON2&y&#TWL3&t&3HREN4(t3FOU5'sO3FIVN6'q'2SIX7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J3 3LETTER J S 'K' # 0x004b -> LATIN CAPITAL LETTER K +-'L3c3L3M3d3M3N3e3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[30EFT SQUARE BRACKEb$\\1`5-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.rOW LINE`%6YGRAVENa)ESMAL7AZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1# 1!l1T 1m11n11o1p17bq1r1s1Pt14 -> LATIN SMALL LETTER T 'u' # 0x0075 -> LATIN SMALL1U1v161V1w171W1x181X1y191Y1z1a1Z1{1b1EFT CURLY BRACKEU|/c/VERTICAL LINEY}*d*ORIGHZ~0e0CTILDRB\x7f%f"TDELET#Pufffe%# 80#UNDEFINED\&1&2&3&4& H0386GREEK CAPIT ALPHA WITH TONOS h0xb7f$ LMIDDLE DOJ\xac'NOT SIGNr!xaLBROKEN BAR'Pu2018NsSINGLE QUOTATION MARK797k8 9038oJEPSILONLH2015|pHORIZON9038oTG038ak9@/IOAaAA DIALYTIKAm10389E_OMICR5 9595803895UH03abZS D !xa9YDCOPYAu038G^OOMEG0xb2mySUPERSCRIPT TWO:xb3, ,5HREF"03 :`+xanXPOUNDPu03adg g}03ae' # 04x009e -> GREEK SMALL LETTER ETA WITH TONOS '\u03af' # 0x009f>/IO?'ca?/a0?DIALYTIKA(90C1CL AND(ccM2MOMICRON(cdB3B_UPSILB(91B4BeCAPITAHALPH27578BET63666HGAMM747779DELn5787E6999Z76a65!xb ab5 VULGAR FRACTION ONE HALF8jc5E &THlXu03997d7@m0xab4LEFT-POINTING DOUBLE ANGLE QUOTADMARKFbFf|ORIGHG9u25bLGc SHADEo(bmMEDIUM)bLDARK'0PhBOX DRAWINGS VERTICAL2b^8$]A8039bhHKAPP2q)biHLAMD7bi'MUkfN49256va SP 8255bmB 8255bq9ODOWNw z>-UP<@039eK)$XI8039b}$98251bp 1cf=y3<z<GS LIGHT UP 4AND HORIZONTAL '\u252c' # 0x00c2 -> BOX DRAWINGS LIGHT DOWN C1C3CVERTICAL GRV(004B3|5: |G903a6GGREEK CAPITAL LETTER PIH03a1744RHO5H255a585 oDOUBLE UP'(54=9=D f(69?a?|'H2566BbBD kcD  5CdC~ 0e; ~HH03a3 fH1TSIGMA803a/d077TAU55l/d15wUPSILON9d(PH7n5C5855(PSjd5GOMEGDbxdESMALHALPH52 58BET4d 46GAM9251 PdDLEFT8250d;] 8yFULL BLOCKe8LOWER HALF-903b-i9DEL7 c5E8258dR?UPPeH ZeG 4 3TeA 3*TH5eA 5)IO4e@ 4HKAPPbe@5TTER LAMDA # '\u03bc' # 0x00e6 -> GREEK SMALL LETTER MU 2d272N2e282'XIdf292vOMICRON7(c07a7Pi(c12b27RHOe33c3WSIGMA525d5lFINAL ;4;e;'TAq83f3STONOS!xa f0(SOFT HYPHEX!xb$(1(PLUS-MINUS,Wu03c5 f2,QYUPSIL6737(PH7343C3!xa153|SECTION8\'PS8DIALYTIKA b DE-!xa(DIAERESIy9HOMEGb5e WITH HEEfFI AND1f.YIu25a3BLACK SQUAREx'Z)NO-BREAK SPACE ) ### Encoding Map e_map = {QA100:I000,0XFNULL 1 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSI5/5/VQUIRYy6#6#ACKNOWLEDGfJ7'7'(BE8 8 2ACKGE9%9%HORIZONTAL TABULAa1a1LINE FEED%b%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETUR-e+e+SHIFT OUf%f%II1x1xDATA LINK ESCAPE 0x0011: 0x`0011, # DEVICE CONTROL ONE 0x0012: .6TWO.3.3.7HRE^4040FFOUR_5/5/NEGATIVE ACKNOWLEDG_6060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCK8585fCANCEL"9"9"WfMEDIUM)a)a)SUBSTITUTb&b&WESCAP"c"c"FILE SEPARATONd*d*_GROUP+e+e+oRECORD,f,f,OUNIT*"20*%20*FSPAC#21!EXCLAMAT6MAR2%22MOQUOT*2NUMBER SIGN22LOLLA'2{PERCENTO2AMPERSANDt2APOSTROPHv2vLEFT PARENTHESISR2ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZER3p3p&3i3i% 3d3d% 3d3d 3c3cM6FIV3a3a&5SIX+3a3a%6EVE3b3b'E<N]3]''NIC3V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd4 # LATIN CA PITAL LETTER C 0x0044:, # LATIN CA2D25252 E26262 F27272 G28282 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R23232 S2 /542 T2 5  U2 5  V2 5  W2 5  X2 5  Y2 5  Z2 5 EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5fOW LIN66\GRAVEL66ESMALA366 0B06 066 066 06 0 66 0 66 066 066 066a 066 0660LL LETTER M 0x006e:, # LATIN SMALL LETTER N 0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKENc.c.VERTICAL LINEWd)d)ORIGHX%7e/GTILDP7VDELET"af"NO-BREAK SPAC*s9POUND SIGYa 8IBROKEN BAaf_{SECTIONNfDIAERESIa9LBCOPY9 a0LEFT-POINTING DOUBLE ANGLE QUOTAEMARKa8;NOTf/SOFT HYPHE-b}jDEGREENbMfMPLUS-MINUS+H9SUPERSCRIPT TWb +6HREb8MIDDLE DOb`Mab=a\VULGAR FRA%ONE HALF#38ezHeK TONO+#38f+'DIALYTIKA11PCAPITZALPHA WITHA8AEPSILONC8 /ET9/IO@9@_OMICR9CU98, # GREEK CAPITAL LETTER OMEGA WITH TONOS 0x0390:@0a1, # GREEK SMAL?3IOT>DIALYTIKA ANDL1L4L VALPHA2656 7BET53565 GGAMM64676 8DELl5686 vEPSILON6898 Z75a5 484c4 )TH696d6 a5b GKAPPxb6 GLAMD6c6 &MUd3 N3e3 &XIff3e: WOMICRalc PkaSc 5RHOa/cf 7SIGa/d06 &TA<ad= Ua/d2l 'PH /d34 C4d 'PShd Rt9  MID&9 NG7+9b) C aC9 ?AQ9 AQ ~[9 =F >baf  >@b}d OJbd 4 bd 3 bGREEK SMALL LETTER DELTA 0x03b5:@0de, # GREEK SMALL 4vEPSILON666/e06 (ZEi7313 28222 )TH49434 (IOa343 GKAPP6b454 GLAMD4c464 &MUed171 N1e181 &XIbf191 WOMICR#c06a6 Pg#c11b1 5RHO#c22d2 FINAL SIGMf#c3:c: 444 &TAjc6f U6c6f 'PH:5f C25ff 'PSd3f GOMEGf4a g WITH DIALYTIKBBf BESa EVTONOShca Asf =3201H8zHORIZONTAL BAR320180 LEFT SINGLE QUOTATION MARK68ORIGH7 #50cwBOX DRAWINGS LDp#50bP9VERTICAL7d7DOWN AND =1%bf= 6<c</UPwd<; uc%{2b fCAL AND LEFT 0x252c: 0x00c2, # BOX DRAWINGS LIGHT DOWN AND HORIZONTALB#34B1B /UP@5@ VERTICALF#50dFoDOUBLE"51:/ba: 598 ;RJ>7vb>FLEFT=a=/c8= t yd</bc< w6d; * }#63}4 B 6Ac7#69C =AeB G8N%dfGUPPER HALF BLOCK8ldz?LOW,8d#KFULLR90~USHADEy"92Mb{MEDIUM (GKDARK&af: NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pCRIGH,THESIS '3*' # 0x2A -> ASTERISK +'+#B#PLUS SIGN$,$C$RCOMMA - D HYPHEN-MINUS'.'E'FULL STOP$/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%2ONE$2$2$#TWH3$3$3HREJ4&4&BFOURo5%5%#IVJ6%6%2SIXI7$7$3EVE8&8&REIGHTL9&9&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL A4A(\LATIN CAPITAL LETTER B1i1BC1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1UV1V1W1W1X1Y1 # 0x59 -> LATIN CAPITAL LETTER Y 'Z'# 0x5A -1Z1[1B1EFT SQUARE BRACKET.$\\/_C.REVERSE SOLIDUS*]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE~`# 60#YGRAVEJa'1'_ESMAL]AVb/2/B/c/3/C/d/4/D/e/5/f/6/F^g/7/G/h/8/H/i/9/I/j/ J/k/5 /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/Uv/V/w/W/x/X/y/z/{/ZCURLY|-`VERTICMB}(RV~.CTILD~3\x77TDELET!Au20a1!8EURO SIGQ\ufff$UNDEFINE $$ $  $@2026pHORIZONsELLIPSI  R UNDEFINED '\ufffe' # 0x88 -> UNDEFINED '$9$A$B$C$D$E$F$/90$E2018D 91$ LEFT SINGLE QUOTATION MARKUF2019525ORIGH6c636kODOUBk d545k6 &22656gBULLET3!6!wEN DASH"4"7"M" 999999990xa0@ANO-BREAK SPACEk@0e01+ATHAI CHARACTER KO KAI0A 0YHO KH2A{2%UA"60e0Ay3Wf5v3'ON622wRAKHANG575 5wNGO NGU1A 10CHOnA2Ia3 b3 3WSO SO@A /OY=A 2JYO YRA 1D)'DAf  2uTO PATA=10e1B 2gHO THA1 B THO NANGMONTH11(B(8hPHUTHA5+B+XNO NE(B(XDO DE%B%ITO T#B6 -> THAI C$HARACTER THO THUNG '\u0e17' # 0xB7 -> THAI C3GAHAN48484Og9393WNO NUba/A/BO BAIMAI3b3B3gPO PLA0c0C0KHO P,d3D3HFO Fbe/E/Pb Yf2F2a%200/C00bvSAMPHAO&21515GMO M&22/2/gYO YAK_3030XRO RU`4040&25,5,XLO LIw&26161] C hWO WAE~CXSO SAs2CSS2Cb LCgHO HIPCiLO CHUC9O ACHO NOKHU@CPAIYANNO'3DWSARA s3DAI HAN-AKAT-3 D fg D 1Mb D 1D01D1'UED12Dv3D01DePHINTH16fffDUNDEFINED $ $ $  $60e3DURRENCY SYMBOL BAH|4E41' # 0xE1 "-> THAI CHARACTER SARA AE '\u0e42' # 0xE2 1O03030AI MAIMUAN94949 GALAI:5:5:LAKKHANGYA6565MAIYAMOKg7272gTAIKHU38383( Ec9090(THa1A1R,b1B1CHATTAWAc6C6THANTHAKHAT5d5D5xNIKHAHI2e2E2iYAMAKK5f2F2XFONGM1%501%F01DIGIT ZER[&51*1*'ON"5"F"S(TWRF)8HRET F +FFOURf5F*(IVTF*7SIXSF)7EVE5F+GEIGH5F+)NIQF0ANG j5FUKHOMU6fffkFUNDEFINED $$ $ $) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB6 cp875 generated from 'MAPPINGS/VENDORS/MICSFT/EBCDIC/CP875.TXT' with?P.py. v#" import ssAPIs class ($. 1): nAdef e(self,input,errors='strict'):,creturnoB=,4ing&Co?o*B ooIncremental$er h final=False*Y.errors,encoding_table)[0] class IncrementalDecoder(>cs.): def d, (self, input, final=False*.sreturn Ucharmap_@:F.errors,Ming_StreamWriter(Codec,UzDpass0Rea9 9 ### encodings module API getregentry(7 eQInfo(1name='cp875',d!e=02(). i:'r=E/er/J //spr7=D #w##@) J[Ping T~DZ2 = '`'\x00'- # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ&(9c&4&dCONTROt  5"HORIZONTAL TABULATIONx"86260 R8x7f"7"dDELETEC(97!8! C(8d"9"e"A"(0b"B"oVERTIC0)C.FORM FEEDrP+D$CARRIAGE RETUR%0E*SHIFT OU 'F$IG1V1VDATA LINK ESCAPT1b1bsDEVICE [6 ON-d1d -3TWO(x1i1i -5HRE\91r2x85IB1rs(08"dBACKSPACh8E1f F1FgDANCE8x19gfCdMEDIUM9/l81l `1`ILE SEPARATORm1@e_GROUP*e1eoRECORD+ lNUNIT)8r2r 8i2i "/2^ "S2S "4' # 0x24 -> CONTROL '\n' # 0x25 -> LINE FEED$2x17&$6$ END OF TRANSMISSION BLOCK4b474TSCAPE!(88!8! 8x89"9"a"A" B"cDC"(05"D"tENQUIRY(06"E"ACKNOWLEDG0GF -> BEL7x90E 30 (91"1"1 32"SYNCHRONOUS IDL(93M3+ o4"4"3= D ; "0f)]j963696369636963616dDEVICE`T FOUR1(BNEGATIVE )(9eyO 51KSUBSTITUT D4QCSPAC B\u03Q4O GREEK CAPITAL LETTER ALPHA52Z5b58BET4m4k4HGAMM5d5~59DELjk55wEPSILON77Z44 333*TH555$IO[4LEFT SQUARE BRACKET..FULL STOP$<$LESS-THAN SIGK(){PARENTHESIST++GPLUSO!$EXCLAMATs3MARr&+5AMPERSAN:5HKAPP5HLAMD5Y5"MUd2N2*2 XI '\u0+39f' # 0x56 -> GREEK CAPITAL LETTER OMICRON '\u03a0777'PI212827RHO33393RSIGMA5]0A5RIGHT SQUARE BRACKET/$/B/DOLLAR SIG*&C&ASTERISKI)#D#xPARENTHESIS,;,E,tSEMICOLb^$F$CIRCUMFLEX ACCEN-, 60,HYPHEN-MINUw/'1'TSOLID"4' 62"2TAU35333EUPSI76747(PHB7353C383(PSf93COMEGua5IOTA WITH DIALYTIKCbCHF|A6`VERTIC2INE,(4COMF% 0PERt_'ULOW Lj>#GREATER-THANO?,QUESTION MARl1\xa7VDIAERd8a7CALPHCTONO-@f 7 E BJ7E>x`!NO-BREAK SPAC|7|hPu038cy#eB2  7?t `}7<9AVE':'s# XNUMBE @&;ERCIAL A1"'"Z7APOSTROPH=MgEQUALS"& LATIN SMALL LETTER A $0'b'/2/B/c/3/C/d/4/D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/`\u03b14xA/[GREEK3LPH323B38BET232C2HGAMM343D39DELf53E3wEPSILON65F5Z0xb00! 2 902 DE4C SIGXj# &Jk/K/l/L/m/M/n/o/O^p/P/q/Q/r/R/74081*TH393)IOa2HKAPP0EHLAMD3I3#MU,!xbAACUTE ACCENT'~ ACTILD.s SOt/~u/v/Vw/W/x/X/y/Y/z/Z/ AN0 0XJf' # 0xAC ->& GREEK SMALL LETTER OMICRON '\u03c0' # 0xAD ->5'PI010E07RHO131F1SSIGMA3!xa1 B03POUND SIG%acX B1%ALPHA WITH TONOScVu03ad>2>EPSILON@e@3@T|&ca<4<$IO=DIALYTIK fA5A c86=&c:7@U:&cb8@c~9DOOMEG2A>PFINALr,49B96TAUf&c51C1,565H71C181#PSb{,/%CLEFT CURLY BRACKETA-LATIN CAPITAB11BbC1}1C1D1r1D1E1b1E1F1V1F1G1G1G1H181H1I1%1"\xwCSOFT HYPHEx c9\1C|d9dCL ANDbKR>N6201 C:SINGLE QUOTATION MARK6201C>pHORIZON2BAR)}%6D6ORIGH7J.7J_K17N CAPITAL LETTER K 'L' # 0xD3 -> LATIN CAPITAL LE1L1M141M1N151N1O161O1P171P1Q181Q1R191R1B\xb14WA1PLUS-MINUS SIGH\xbd*B* VULGAR FRACTION ONE HALF](1a3C3SUBSTITUTE%Pu0387'D%GREEK ANO TELEIA+F2019+E+RIGHT SINGLE QUOTA3MAR:@\xa64" aF6BROKEN BA\#% E0%REVERSE SOLIDUSx E1* SNt E2%VT1TU1U1V1V1W1W1X1X1Y1Y1Z1Z1B\xb24ESUPERSCRIPT TW1\xa"SE  # #H\xabLEFT-POINTING DOUBLE A cD NO0  FDIGIT ZER%%#ONH$$E3m$3HREJ4&&3FOU5%%#IVJ%#SIe$$3EVE8o&EaO|F&$NI)3\xbtFt 3\xaT,vDCOPY\SFxFxbxFxoy"9f2yCONTROL ) ### Encoding table e_=codecs.charmap_build(decoding_table) # # cp932.py: Python Unicode Codec for CP932-*Written by Hye-Shik Chang # import _Rrcs_jp, multibyte as mbc =:A.get!('') class(!s.): en" =t.doPIncrementalEBtr(mbc.M ,Us >cs.4 D 4 StreamReader(T,!.^N^ ! ^^def getregentry(&breturn"UInfo(Sname=WJ0=#()?5iFI.r=/J //sr=w #cwriter#<#)_cp949!49-?)$kr*kr/49D249'ter, ) #Z # cp950.py: Python Unicode Codec for CP950 # # Written by Hye-Shik Chang # import _Rrcs_tw,  multibyte as mbc =:A.get!('') class(!s.): en" =t.doPIncrementalEBtr(mbc.M ,Us >cs.4 D 4 StreamReader(T,!.^N^ ! ^^def getregentry(&breturn"UInfo(Sname=WJ0=#()?5iFI.r=/J //sr=w #cwriter#<#)euc_jis_2004 qEUC_JIS*;M )$jp 'jp A ^9j streamwriter=StreamWr 4, ) # # euc_jisx0213.py: Python Unicode Codec for EUC_JISX0213 ;M&ten by Hye-Shik Chang # import _Yrcs_jp, multibyte as mbc =:A.get(('') class(#!s.!): en" ={.dvPIncrementalEBtr(mbc.M fj >cs.4 D 4 DqReader(T,!.^U^ ! ^^def getregentry(&breturn"QInfo( Zname=^Q7=#()F<iMI.r= /J //sr #w#C#pPJAup F"p'! Ltreamreader=StreamReader, srwriter=#W #!) # # euc_kr.py: Python Unicode Codec for EUC_KR/A&ten by Hye-Shik Chang # import _Srcs_kr, multibyte as mbc =:A.get"('') class(!s.!): en" =u.dpPIncrementalEBtr(mbc.M Tz >cs.4 D 4 2U(T,!.^O/er^! ^^def getregentry(&breturn"QInfo( Tname=XK1=#()@6iGI.r=/J //r # gb18030 !GB%2$cn'cnAYHB streamreader=StreamR 3, sEwrit#W #) # # gb2312.py: Python Unicode Codec for GB$/A&ten by Hye-Shik Chang # import _Srcs_cn, multibyte as mbc =:A.get"('') class(!s.!): en" =u.dpPIncrementalEBtr(mbc.M Tz >cs.4 D 4 U(T,!.^O/er^! ^^def getregentry(&breturn"QInfo( Tname=XK1=#()@6iGI.r=/J //1k K{kC&k'[H streamreader=StreamReader, sEwrit#W # ) """Python 'hex_codec' C! - 2-digit hex content transfer encoding. This <A de/es from bytes to 0. ten by Marc-Andre Lemburg (mal@l `.com). importdsbinascii ###APIs def_ (input, errors='strict'):(cassertD == return (l.b2a_hexTc), len )x dex4?a2bxRclass(z1cs. oself,  <9 3)WW9 W IncrementalEg$er final=False*. ' D;: 3*1er(&,X.charbuffertype = LvLL fings module APIPgetregentry(IQInfo(Pname='b&e= iA.r=/J // #r_is_text2ingg Character Mapping4 generated'hp_roman8.txt' with$qQ.py. jBased on data:ftp://dkuug.dk/i18n/Cmaps/HP-ROMAN8 (Keld Simonsen)O@Orig source: LaserJet IIP Prin User's Manual HP part no33471-90901, Hewlet-Packard, June 1989 (Upermissio\"""#"s c@ "):2(f,l  4eI=,Ving_table)  def decode(self,input,errors='strict'): ,preturn 1cs.charmap_B=,ing_table) class IncrementalEnG r(>cs.xe, h final=False*@:.,?[0]D"N!@StreamWriter(Codec,TDpassORead9 9D### 4s module API getregentry(7 2UInfo(Sname='hp-roman8',h!e=42().ij:.r=c/J //stwt=H #r^#Q#@) N[Ping T)H5cod2 = +`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT'\x1b' # 0x1B -> ESCAPE '\x1c' ! #!C!FILE SEPARATOR)d)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" 20)CSPAC! 1 EXCLAMATION MARK"+2+LQUOT)#)3)NUMBER SIGNO$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq1"'" 7$POSTROPH(I8%LEFT PARENTHESISP+')+9+ORIGH,*,A,sASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIX7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM14D -> LATIN CAPITAL LETTER M 'N'# 0x4E -> LATIN 1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/ 5C.REVERSE SOLIDU]) *D*?IGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/P /K/l/ /L/m//n//o/p/7^q/r/s/"t/u/v/w/x/X 'y'  # 0x79 -> LATIN SMALL LETTER Y 'z'/A/Z/{/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F UDELET!'80! 80!H\x81$1$2$2$3$3$4$4$5$5$6$6$7$7$8$8$9$fDa$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACc)EPCAPITEA WITH GRAV<]A]< CIRCUMFLEXcAzAE}A< }AA DIAERESISA@IAA bAACUTE ACCEN"Q\u02cAMODIFIER7 (MANDARIN CHINESE FOURTH TONE) '\u02c,6' # 0xAA -> MODIFIER LETTER CIRCUMFLEX ACCENT '\xa8:<B<DIAERESIS$Pu02dc&`C$SMALL TILDE&0xd9$JD&LATIN CAPITALU WITH GRAV<b<E< }Pu20a4CFAIRA SIGN$0xaf" B0$UMACRO!(dd!1!YEACUTf<2<*:(b0v3:iDEGREE(c7&4&CtCEDILLAe>5> <(d1z6< Nz f<7< x:a:8: INVERTED EXCLAMATION MARKb94MQUES149CURRENCY}(a3%ZPOUND%5%&:YEN# #1SECPu0192LB 6Fp5HOOa7 e$CI ]A] i0xeacC$ ?E?f?'O?(C,bUCE  eCA :f<C? t : k= :eSC=' eCC: :fXL: : \^: :eNs: )xeM> >fs>Q>| >ck # 0xD0 -># LATIN CAPITAL LETTER A WITH RING ABOVE '\xee' # 0xD1 ->AESMAL?I?CIRCUMFLEX?(d8?2? OAUSTROK|(c6=3=A2(e5242 d?5?EACUTyf6:e7;(c480 SDIAERESIS(ec@9@ $6GRA dA: z zdzB@U  @(c9C@E@ (ef<D< zd>E>SHARP S (GERMAN)rdF>8F'c1/E0A (c3< }<ETILDe< 5:(d0vETH (ICELANDIC2f?=cE  .E<  . < x(d20< xEx f< v:Au016ESSCARON<< v:8xda( CdAu017v <Y fE >dIF_THORN A ? '\xb7' # 0xF2 -> MIDDLE DOT '\xb5'  %3%CRO SIGN%6%4%zPILCROW'e'5'VULGAR FRACTION THREE QUARTERS`Pu2014;69sEM DASH"0xbc  7" [%ONY6d686DHALF3(aa393 FEMININE ORDINAL INDICATOR5b5A5oMASCUL6 (abkB6 LEFT-POINTING DOUBLE ANGL1OTADCMARKzPu25a0F:CDpBLACK SdE')xbkD'ORIGHl0xb1jEEPLUS-MINUS ufffe' ) ### Encoding table e_ =codecs.charmap_build(de3$) # # hz.py: Python Uni: C?q for HZ'*Written by Hye-Shik Chang # import _Orcs_cn, multibytec as mbc &' =:A.get('hz') class(!s.!): 2e =q.PIncremental\er(mbc.M ,U 4 D 4 StreamReader(T,!.^K^ ! ^^def getregentry(&breturn"UInfo(Pname=TG-=#()<2iCI.r=/J //sr=t #cwriter#9#) # This module impl s the RFCs 3490 (IDNA) and1 (Nameprep)`stringD, rer from uG@datad ucd_3_2_0 @ # m$ section 3.1 dots = re.compile("[\u002E\u3002\uFF0E@61]" D 5 ace_prefix = b"xn--" sassumes query s, so AllowUnassigned is true def nameprep(label): # Map 1newQ = []for c in 04if stringN.in_table_b1(cV&^ to nothingWcontinue.append(e4mapfQ2(c))4 = "".join(@!) # Normalizc/unicodedata.n"("NFKC",BProhibitQ c1Q or \?/ ;/c2+O3(c)U4*5*6*7*8*9brraise UError("Invalid character %r" % cCheck bidi`RandALs`d1(x) x  !A "c# There is a /R3the. Must perform furtherE|# tests^ 1)aSsYsection 5.8 MUST be p;ed.X@This C.8, which was already c:+ed;s2) If a ains any6Cat&, J4NOTDCL> if#,2 RCQViola<of BIDI requirement 2"J??# 3a .GfirsC0 ofE EU, andgS2las#` s3not0[0]:-1][e3eSretur yToASCII6tryv# Step 1: try -*0.en ("ascii"XiexceptU[ApassLFelse`# Skipsz3: UseSTD3}ARule\false, soC 98kif 0 < lenV < 64s> lUnicodeError$("label empty or too long") # Step 2: nameprep6=( 43: UseSTD3ASCIIRules is falseF]q4: try &Atry: Z1 = .encode("ascii")&except UniVError?Bpass&6lse# Skip to s!8.$pif 0 < lenV < 64:$breturn9Yraise^5: Check ACE prefixV"ifc.startswith(sace_$)|L; <_ A6: EY(PUNYCODEx @punyn I7: Prependm G" + i8 2siz%  cdef To=Y17forif isinstance8w, bytesQpure_b = True ^ &_ ! ;Fvif not  22: Perform#, $# It doesn't say this, but apparently, it should berE nowf1$9 Invalid character in IDN3) X!62strA%, p4: Removel1[h]rP5: Dey using dresultJ11.d*/("6: Apply To2(U -`7: ComR the #2 of65one3bwill already:in lower caseiQ V.'e() != u2v#1DNA:round-trip",%2B8: rF 5  ### Codec APIs class(1cs.I. self, input, errors='stricst'): if errors != 'strict':&$# IDNA is quite clear that implementations must be H Fraise UnicodeEs("unsupported handling "+)not inputreturn b'', 01= 64hd[,g = bytearray(YCdotsWA1and55 @trai0_do= 4del5-1]e I'- #if% # Join with U+002EW-.extenda !To=Vq"s(3+)adef dehRself,{,$s=rPUM;)""Lballowsto operate on2@ngs,9.isinstance(,s# XXX obviously wrong, see #3232VH sV)if ace_prefix"in K?# F Gs z.I - YDY/]':"."'J== 0V = '.%&''#F = [5@.app#To3".".join)nput) class IncrementalEncoder(cs.Buffered"): def _b&!_e< (self, input, errors, final48#if != 'strict'S# IDNA is quite clear that impltions must be HBraise UniE("unsupported handling "+%) Fbif not return (b'', 03labels = dots.split()V@trair_dot = b''2if A nJ[-1] U.V 3del_Du#eld_# Keep potentially unfinishedU until the next calldhcQresulQytearray(tsize = 0.3for"in s0if 5 # Join with U+002EU.extend(b'.' ]Y += 1> :ToASCII()D@3len F^2i;!aRytes(O!),) class; Dec; ";d<;6U<*""qallows Qto operate onngs, too.if isinstance1,+11 ^ Jelse3# M%NW5ing{X =}v"ascii"(17"."Q? = A'U = []F.append(ToUnicode(label)) if size: Y += 13lenO result = ".".join() + trailing_dot1M!sreturn I, ) class StreamWriter(Codec,8cs.)Jpass9ORead9 9### encodings module API def getregentry(7UInfo(name='idna',c!e=/2(). dePincremental:6r=IE/er/J /Dl/sowo=bR#rY#L#) # # iso2022_jp.py: Python Uni for ISO(!JP7&ten by Hye-Shik Chang # import _W3cs_w", multibytc as mbc &, =?A.get#('QE_jp'(!!s. " =~{d(mbc.M j 4  4 kH!6^] ^! ^^,$@ /_1/_1!/_1#atibyteIncrementalEncoder,  cs.Increm4!):5 1 =  class . Der(mbc.Multibyte T StreamReader(Codec, !,(s.^OWrit^ ! ^^def getregentry(&dreturnQInfo(name='iso2022_jp_1'Qe=72().di:'r= @/J /^sr=~ #wl#C#g) # # 2.py: Python Uni for ISO%AJP_2;M&ten by Hye-Shik Chang # import _Y3cs_{m(0 as" =?A.get(42')S(#!s. P s T   z b 4 q%2%?004(?004+?004. encode = codec.encode de 0 = "c. class IncrementalE3r(mbc.Multibyte ,UY a.s.4!):5 D 4 StreamReader(C?), !,G(s.^OWrit^ ! ^^def getregentry(&dreturnQInfo(name='iso2022_jp_2004'T:=:#()I?iPI.r=/J //sr= #wo#F#g) # # 3.py: Python Uni for ISO(AJP_3;M&ten by Hye-Shik Chang # import _Y3cs_{mr(0 as" =?A.get(43')V(#!s.  P(3%?ext'?EXT)_ codec = _codecs_iso2022.getc#('_jp_ext') class C%!s. ): en0 = "c. dePIncrementalEBr(mbc.Multibyte ,Us h>cs.4 D 4 StreamReader(T), !,a(s.^OWrit^ ! ^^def getregentry(&dreturnUInfo(\name=`S9=9#()H>iOI.r=/J //sr= #wn#E#d) # # ]kr.py: Python Unic for ISO1_KR7I&ten by Hye-Shik Chang # import _Wmm(0 as~" =?%/kr!I2kr';4"""Character Mappingiso8859_1 generated from 'MAPPINGS/ISO#/-1.TXT' with2codec.py. """#" import codecs ### C APIs class($.): def en(self,input,errors='strict'):,0creturno.charmap_B=,ing_table)o/deo-B ooIncrementalEr  h final=False*Y.S 4[0]D"e!@QStreamWriter(N,8cs.5pasORead9 9Js module getregentry(7 UInfo(name='iso8859-1',h!e=42().ij:'r=}/J //str;=H #w##") [Ping TH5cod2 = +`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDLE '\Px17' # 0x17 -> END OF TRANSMISSION BLOCK )X'\x18484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTE%b%B%VESCAP!c!C!FILE SEPARATORJd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &1 j 20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq0"'"H uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIX\3Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11ER I 'J' # 0x4A -> LATIN CAPITAL LETTER J )0'K'1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1Z1[1EFT SQUARE BRACKET$\\/>5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMAL<AVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /k/ /l/C /m//n//o/p/7^q/r/s/"t/u/ 0x75 -> LAT IN SMALL LETTER U 'v'# 0x76 -> LAT/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F UDELET!'80! 80!H\x81$1$2$2$3$3$4$4$5$5$6$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACaEAE INBED EXCLAMATION MARKaUAUCENT SIGN$UAUZPOUND%VAVCURRENCY(ZAZ:YEN#YAYBROKEN BARZAZ1SEC ]A]DIAERESISK]A]BCOPYT MbAb FEMININE ORDINAL INDICATOR '\xab' ' # 0xAB -> LEFT-POINTING DOUBLE ANGLE QUOTATION MARK :DcDCDNOT SIGN#d#D#SOFT HYPHE&e&E&REGISTEREDPf*F*UMACROK'b0! B0!iDEGREEG(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWO(b3*3*EHREE,4,4,ACUTE ACCENT'5'5'ZMICRO6%6%zPILCROW'7'7'MIDDLE DOq8%8%uCEDILLA9"9"&ONa*A* MASCULINE ORDINAL INDICATOR`BORIGHbBVULGAR FRAC ONFARTE{B6EHALFe 3T1 QUkS9BINVERTED QUESlcCLATIN CAPITAL LETTER A WITH GRAVcC< cC< CIRCUMFLEXACA FTILD'C'< DIAERESIfc@C@@ R7ABO:\C\AgCg2C ^cC>E> C< C< CA C@IC< C< CA dDETH (Icelandic)^dDR N WITH TILDE '\xd2'  # 0xD2 -> LATIN CAPITAL LETTER O WITH GRAV<3<3< FACUT<4<4< CIRCUMFLEX5A5A 7TIL6<6< DIAERESIS|7@7@MULTIPLICATION SIGN.8.8.c VSTROK(9=9=Ua<A< b<B< cACA dd@D@Y e<E<THORN (Icelandic)fAFAESMALSHARP S (German>'e0>/E0>A R(e1:1: eE teE? LeE: eE>RING ABOeE ?NeE 0CtCEDILLAeE <E< E: E:E?E >IE: E:E fF?ETH3fFN. BfFfF:ACUTE '\Pxf4' !# 0xF4 -> LATIN SMALL LETTER O WITH CIRCUMFLEX 4X'\xf5?5? UTILDE:6:6: DIAERESIS>7>7>DIVISION SIGN(8(8(VSTROK9;9;UFGRAV:a:A: FACUT:b:B: c?C? Td>D>Y e:E:THORN (Icelandic)f?F?y) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_10 generated from 'MAPPINGS/ISO$/-10.TXT' with3P.py. o#" import slAPIs class ($. 1): 9Adef e(self,input,errors='strict'):,creturnoB=,4ingCo8o*B ooIncremental$er h final=False*Y.S 4[0]DZ(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='U-10',i!e=52().ik:'r=~/J //sur<=I #w##") [T ~2 = ,W'\x00S 00SANULL0'\x01' # 0x01 -> START OF HEADING '\x02' ! #+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&7 -> BELL88tACKSPACCt" 9$HORIZONTAL TABULATn0A0LINE FEEDxb&[B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG'10# 10#DATA LINK ESCAPB8x11+tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE(19fUeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDFP3[DIGIT ZER%`%$Y$$T$&T '5'  # 0x35 -> DIGIT FIVE '6'%6%2SIX$7$7$BEVEN&8&8&REIGHT&9&9&3NIN:%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK @( 40(COMMERCIAL A4A(1(LATIN CAPITAL LETTER AYB121B1C131C1D141D1E1F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU])5RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa'LSMALb/x62 -> LATIN SMALL LETTER B 'c'# 0x63 -> LATIN/C/d/4/D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/S/t/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x7 7UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$G$$C$$9$=8= $9@9@9@9@9@9@93' # 0x93 -> '\x94' # 0x94 -$5$5$6$6$7$7$8$8$9$9$a$A$b$B$c$C$d$D$e$E$f$F$'a0$ A0$NO-BREAK SPACEAu010 A1)LATIN CAPITAL LETTER A WITH OGONEK= 12h=2=E=fMACRON=2=3=G=wCEDILLA>{I> {@== GTILD13<<Ky (xaASECTION SIG3ueeLeAu011>>D>WSTROK6==S=)CA6*<T< y7!C=Z=y!xa: A[SOFT HYPHEV64]bUb 44=v=3ENG!xbIBkDEGREE09BOSMAL3B ;~;~ ;|B| <zz; x<:x :vb:vMIDDLE DOTAu013at ar1r <p;p ;nn :li;C -> LATIN SMALL. LETTER Z WITH CARON '\u2015' # 0xBD -> HORIZONTAL BAR)F016b)E)LATIN SMALLcUc7MACd7014;F;6ENGl%00l&C01@CAPIAn0xc1;/C1= SACUTEy8xc2<2< CIRCUMFLEXA3A3A FTILD}4<4< DIAERESIS|5@ RING ABOV66A2Pu012e4>/C72IcOGONEKVu010c=8=C=0xc9:9<E<Pu0118>A< !xcyB= }f}C@+OTd r!xc<<f}A !xdDETH (Icelandic)14<DNwCEDILLA>oDO> (xdD= wdD<wd7A Udn<< Fu016-D |:||WSTROK[7y 'daD= D<gA s(xdDY  0xDE -> LA TIN CAPITAL LETTER THORN (Icelandic) '\xdf' # 0xDF -> LAAESMAL?SHARP S (German>Pu0101@>/E0>A WITH MACRONye9 y/E1; UACUTE:2s:2: CIRCUMFLEX?3?3? FTILDy4:4: DIAERESISx5>5> RING ABOV}6?6?0Au01270IcOGONEKdm;8;C;(CA989:E:Au011<tA: 8xebuB; y7@yC> +OT)D>f0xeev:E: ?y 7xf0}F?ETH3Au0142FNvCEDILLA[42<O< 1fF; kfF:kfF? 1f(F: Fu016FU, x8xWSTROK77hu (fav; F:cy? g!xfYg F{Au013k KRA ) ### Encoding table e_table=codecs.chaVrmap_build(decoding_table) """ Python Character Mapping Codec iso8859_11 generated from 'MAPPINGS/ISO$/-11.TXT' with gencGP.py. o#" import cs ###lAPIs class($.): def W(self,input,errors='strict'):,0creturnoA.chaB=,Co8eo)B ooIncrementalE>r h final=False*Y.S 4[0]DZe(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(rname='iU-11',i!e=52().ik:'r=~/J //sur<=I #w##") [TI2 = ,`'\x00'2 # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{-CONTROL THREE '\x14'  # 0x14 -> DEVICE CONTROL FOUR.5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATOFd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &"  20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq1"'" uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ3T%SK3FIVJ%Q%2SIX$Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11F 'G'  # 0x47 -> LATIN CAPITAL LETTER G &0'H'181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /h/ /i/ /j/ /k/ /l/ /m//n//o/p/7^q/r/ # 0x72 -> LATIN SMALL LETTER R 's'# 0x73 -> /S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#F UDELET!'80! 80!H\x81$1$2$2$3$l4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACAu0e0GAETHAI CHARACcKO KAI0S0Q 0YHO KH2a2_2#UA\ep3n3Wf3}3ON '\u0e06'& # 0xA6 -> THAI CHARACTER KHO RAKHANG '\u0e07'575wNGO NGU181810CHOtN29292Ia3A3 b3B3WSO SOc/C/'OE2d2D2JYO Ye1E1D)'DAcf2F2TO PATAK2%102/B02 HO&11212NANGMONTH1&12828hPHUTHA53535XNO NE4040XDO DE5050ITO T60#T/U1!B!38AHA$B$4Og%B%*1!B!BO BAIMAI+!B!WPO PL1"B"jPHO PH,#B#HFO Fb!B!b Y!B!a2CbISAMP2"C"GMO M2C2CXRO RU`CR2CILO L2CL] C XWO WA2CAs2CSS2Cb LCfHO HIP42CLUC)O 2CHO NOKHU2CF -> THAI CHARAC$TER PAIYANNOI '\u0e30' # 0xD0 -> THAI CHARAC3gSARA A01010MAI HAN-AKAT62626fg3131Mb4141505016161'UE717128282b9090U1a1A1ePHINTH1Tfffe'> F0e3feFeURRENCY SYMBOL BAH 4E*4EP1EO60e4EI MAIMUAN9EA97ALAa4ELAKKHANGYAEM7MOKEvMAITAIK60e4EEcE0(THE1R,bd&EBd1wCHATTAWU&4c6C6THANTHAKH&4d5D5xNIKHAHIe2E2iYAMAKK53E3XFONGM150F0DIGIT ZER[5*F**'ON"5"F")(TWRF)8HRET F +FFOUR5F*(IVTF*7SIXSF)7EVE5F+8EIG5F+)NIQF0ANG j5FUKHOMUk '\ufffe' ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_13 generated from 'MAPPINGS/ISO$/-13.TXT' with3P.py. o#" import slAPIs class ($. ): def e(self,input,errors='strict'):,0creturnoB=,4ingCo8o*B ooIncremental$er h final=False*Y.S 4[0]DZ(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='U-13',i!e=52().ik:'r=~/J //sur<=I #w##") [T ~2 = ,`'\x00'2 # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v-E CONTROL TWO '\x13'  # 0x13 -> DEVICE CONTROL THREE/4/4/EFOUR.5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATOFd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" ! 20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq1"'") uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZER1%`%#ONt2$Y$#TWH3T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI):)FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11E 'F'  # 0x46 -> LATIN CAPITAL LETTER F 'G'171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU])]5ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /g/ /h/ /i/ /j/ /k/ /l/ /m//n//o/p/7^q/ # 0x71 -> LATIN SMALL LETTER Q 'r'# 0x72 -> /R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#JF UDELET!'80! 80!H\x81$1$2$H3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACAu201AEDOUBLE QUOTATION MARKaWAWCENT SIGN$WAWZPOUND%XAXCURRENCY(\LOW-9 QUOTATION MARK '\xa6'  # 0xA6 -> BROKEN BAR%7%7%SECTION SIGN'(d8'8'LATIN CAPITAL LETTER O WITH STi=(a9=9=COPYRIGHTfAu015A)fRfuCEDILLAgbgB>EFT-POINTING DOUBLE ANGLE QUOTA 4cDCD)NO8xad#D#SOFT HYPHE1(ae&E&REGISTERED!xc F*$AE'b0\ B02iDEGREEX(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWOz3*3*4HREAu201M B4,DLEFT(b5a55ZMICRO2BzPILCROW'BMIDDLE DOTfBOSMAL bB7%ON 1015  ebB9bdBVULGAR FRA ONEARTEbB6DHALFO(be 3T%1 QUkS9e #Pu0104kSC6+TOGONEAu012==I=0=.=A=TMACRO=A=C=DACUTF!xcCQyDIAERESIcc\C\|@R3DABOVAu011.xAE t1g== 7= 7&CAs(xcCy sAu017>x xZ <1x KDOT n21@G WITH CEDIL0LA '\u0136' # 0xCD -> LATIN CAPITAL LETTER K WITH CEDILL>&2a>E>I>gMACRON{b=F=L= {%60>/D0>S>Az&43<1<N<VACUTE&45<2< !xdxo/D3>Ozcz4< m!xdy5= DTILD!xd"<6< DIAERESIS30xd7@7@MULTIPLICATION SIG 720 D8.U#cOGONEKkVu0141=9=TTSTROKFu015/DA=S 6<B< !C= aFu017JDZ3DOT ABOV&7d6@CL0xdf:ESMAL?SHARP S (German)0E >A 2{; ;z ;0&E ;v Au010v ;C"7xe4)E :u !xe'gE>LRING 19 ?E -1;; -XE ;- Ve :g E : :1 :tD2' >Gb z <E <I WITH MACRON - '\u013c' # 0xEF -> LATIN SMALL LETTER L WITH CEDILLA <%61</F0<S<FARON:&44:1:N:WACUTE:6:2: 0xf3:/F3<Ovd<&/F4: 6MAC0xf59u5; DTILD!xf:6: DIAERESIS)8xf7x7>DIVISION SIG78(UcOGONEKcPu0142e;9;<TSTROKVu015b;A;; 6:B: QC; QAu017@D>Z)DOT ABOV&7eE> C,F2019:RIGHT SINGLE QUOTAT MARK ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_14 generated from 'MAPPINGS/ISO$/-14.TXT' with3P.py. o#" import slAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ingCo8o*B ooIncremental$er h final=False*Y.S 4[0]DZ(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='U-14',i!e=5().encode,  decode=Codec().3, incrementalen*6r=IE/J /Dlr/streamreader=S R #Ewrit#W #) ### [ing Table ~Ping_tA = (a'\x00'# 0x00 -> NULL11START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt"" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&TB$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- # 0x2D -> HYPHEN-MINUS '.'# 0x2E -> FULL STOP$/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%2ONE$2$2$#TWH3$3$3HREJ4&4&BFOURo5%5%#IVJ6%6%2SIXI7$7$BEVEN&8&8&REIGHT&9&9&$NI):%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&K|GREATERR?,SQUESTION MARK @(4YCOMMERCIAL A4A(\LATIN CAPITAL LETTER AYB1i1B1C1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151Q1QR1;S1jT1U1UV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET r '\\'  # 0x5C -> REVERSE SOLIDUS !$']) *D*IGHT SQUARE BRACKET/^/E/CIRCUMFLEX ACCEN,_,F,LOW LINEO`# 60#YGRAVEJa'1'LATIN SMALL LETTER AVb/2/B/c/3/C/d/4/D/e/5/f/6/F^g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/Uv/V/w/W/x/X/y/Y/z/Z/{/EFT CURLYi|-VERTICALB}(RV~.CTILD~3\x77UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$h[$# 0x8B -> '\x8c' # 0x8C -> !xa< wA{POUND SIGN1010c|c C1010@@ >(1e~> ~D~(xaAySECTION11e8gWg5GRA(xaACOPYRIGHTee HACUTF< FGu1efz > FY8A8SOFT HYPHE&(xa:A:REGISTEREP7>k@ DIAERESIS11e1l@B\@F31@s J>6012)Bq JG~10128~s ~>71e4~M~71e4~>(xb>B{PILCROW5)sCAPITAL LETT4ER P WITH DOT ABOVE '\u1e81' # 0xB8 -> LATIN SMALL LETTER W >8GRA:&57:9:x3>A>xGACUT&60:B:eCAPITASfzC@ Y> &84zD: zDIAERESISl5@E@ z>6F>!xc4&C0> A!xcx<1< 0xc2<2< CIRCUMFLEX5!xcA3A DTILD+!xc<4< !xc@5@ IRING^8xc66ATs72CuCEDILLA-8p E>8xc9<< a<<bAc@ Id<< e<xfAA Au017DVdDN: `dDO< odD< vd%D<DA D< 11e6.T5 (xdD O WITH STROKE '\xd9'  # 0xD9 -> LATIN CAPITAL LETTER U WITH GRAV<a<A< FACUT<b<B< CIRCUMFLEXcACA DIAERESIS@d@D@YPu0176>5E< f? vFAESMALteSHARP 'e05/E05A (e1:1: 8xe2:2: (e3?3? ETILD (e4:4: (e5>5> RING ABOe/E6?7o70CtCEDILLA(e8<8<E< E E: E:E?E >IE: ee:E ..FW}fFN? DfFO: [fF: jfF:*zF? F: 11e6T+:DOT0fF|FSTROfF~fF:ACUTE '\xfb ' !# 0xFB -> LATIN SMALL LETTER U WITH CIRCUMFLEX 4X'\xfc?C? DIAERESIS>d>D>Y}SACUTE:Pu0177<E: f=" ?F? ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_15 generated from 'MAPPINGS/ISO$/-15.TXT' with3P.py. o#" import slAPIs class ($. 1): xAdef e(self,input,errors='strict'):, creturnoB=,4ingCo8o*B ooIncremental$er h final=False*Y.S 4[0]DZ(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='U-15',i!e=52().ik:'r=~/J //sur<=I #w##") [T ~2 = ,W'\x00S 00SANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDG!x0a07 -> BE8E8tACKSPACCt"C9$HORIZONTAL TABUn0A0LINE FEEDb&# 0x0B -> VERTICAL TABULATION '\x0c'  # 0x0C -> FORM FEED$r" $D$CARRIAGE RETURNe,NE*SHIFT OUTN8x0f$F$IG'10# 10#DATA LINK ESCAPEN(11+1+EVICE CONTROL ON-2-2-5TWOZ3-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B% 1ILE SEPARATOFdJ_GROUP*1oRECORD+1LUNIT) { 2CSPAC! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSAN"1"'"C uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDFP3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3F4COL(; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MARK '@' # 0x40 -> COMMERCIAL AT(A(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1CL1C1LbM1D1M1N1E1N1O1F1O1P15P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/P5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'LSMALb/ /c/ /d/ /e/ /f/ /g/ /h/ /i/ /j// J 'k'  # 0x6B -> LATIN SMALL LETTER K %0'l'/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/EFT CURLY BRACKEG|-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f#d7UDELET!'80!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@ 0x9E -> '\x9f' # 0x9F -> LATIN CAPITA<FACUT<a<A< CIRCUMFLEX}bABA DIAERESIS@c@C@Id<D< e<E< fAFA 'd0@/D0@4ETH,(d1313N,ETILD(d2<2<O< a(d3<3< h(d4<4< h(d5A5A 6<6< 7@7@MULTIPLICATION SIGN8.8.cVSTROKDUD< D<DAdDY DFTHORDESMAL-eSHARP eE 5A =eE: eE:eE? 7eE: eE>RING ABOeE ?9eEv 0CtCEDILLAeE <teE: E :ITH CIRCUMFLEX '\xeb' # 0xEB -> LATIN SMALL LETTER E WITH DIAERESIS>c>C>I>UGRAVE:d:D: FACUT:e:E: CIRCUMFLf?F? 'f0>/F0>4ETH(f1111N"ETILD(f2:2:O: \(f3:3: \(f4:4: \(f5?5? 6:6: 7>7>DIVISION SIGN8(8(SVSTROK9;9;Ua:A: FtF?TFY FFTHORFm) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_16 generated from 'MAPPINGS/ISO$/-16.TXT' with3P.py. o#" import slAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ingCo8o*B ooIncremental$er h final=False*Y.S 4[0]DZ(@Qclass StreamWriter(Codec,cs.Stream): pass class ORead9 9### encodings module API def getregentry(7sreturn QInfo(name='iso8859-16',i!e=52(). deVincremental:6r=IE/er/J /Dl/s[r<=IR#w##@) O[ing TableI_ _t2 = ,`'\x00'2 # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSAND "'" # 0x27 -> APOSTROPHE 0'('%8%LEFT PARENTHESIS+)+9+ORIGH,*,A,ASTERISKO+#B#PLUS SIGN$,$C$RCOMMA - D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$2$#TWH3$3$3HREJ4&4&BFOUR5%5%#IVJ6%6%2SIXI7$QCSEVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1UV1ETTER V C'W' # 0x57 -> LATIN CAPITAL LETTER W )+'X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET.$\\/C.REVERSE SOLIDUS*]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE~`# 60#YGRAVEJa'1'ESMALAVb/2/B/c/3/C/d/4/D/e/5/f/6/F^g/ G/h/ /H/i/ /I/j/ /J/k/ /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/Uv/V/w/x/y/z/{/ZCURLY|-`VERTICB}(RV~.CTILD~3\x77UDELET!"80D!8H\x81$$2$$3$$4$ '`\x85' # 0x85 -> X'\x86$6$7$7$8$8$9$9$a$A$b$B$c$C$d$D$e$E$f$F$'90$/90$1$1$2$2$3$3$4$4$@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACEAu010AELATIN CAPITAL LETTER A WITH OGONEK==^=OSMAL; 4;u; xLxUSTROK120ap=EURO SIGN1201L$ DOUBLE LOW-9 QUOTATION MAR6:6SDCAROr(xaA1SECc7016cS5aACOPYRIGHT1021 c ]eOMMA BELOW>(xaALEFT-POINTING L_ANGLEL7ZLDACUT(xa,A,SOFT HYPHErAu017b.b K`::D: "<DOT ABOVb&! @B`hDEGREE!xb&]PLUS-MINUS*BJ C,xAu014K Iu017d' # P0xB4 -> LATIN CAPITAL LETTER Z WITH CARON '\u201d' # 0xB5 -> RIGHT DOUBLE QUOTATION MARK60xb6466rPILCROW SIG]8xb7'7'MIDDLE DOTLPu017e'8%OSMAL 70109:CF0219tA:S:OMMA BELOW0xbb>B@R6-POINTING?OANGLEPu0152GCEIGATURE OEy434D4-2&782E2fYDIAERESISr&7c@F@r>[DOT ABOV0xc0<)&C0> ~A~7GRA<1<1< FACUTxZx2< CIRCUMFLEX0C/C3A 7BRE4s0`| u :<A+C2nsCEDILLA(!xc]p E<< ad< (xcC !xcI< < -<<f:} Au011DDTSTROKmFu014DN= dDO< Ldv<< xD< r2ADz DITAL LETTER 2O WITH DIAERESIS '\u015a' # 0xD7 -> LATIN CAPITAL LETTER S@VACUTE<&70<8<U<xDOUBLE C0xd9A9C DGRAV!xd<A< xbxB< CIRCUMFLEX8xdcACA x 18BxD@E<cOGONEK}Au021=E=T=COMMA BELOWB0xdf}<FBFSMALTHARP ,!xe5/E05Au 'e1o/E1: (e2:2: Pu0103A*/E3? 6BRE^ e484:  07@x5>C+ 68x6:Aeh0 jtCEDILLAe< < E: t: (xeE? (xeE >I d: e::E Au011{FDTSTROKYAu014;N; fF ffF: t:: f(?fFAlSlGu017 LL LETTER U WITH DOUBLE ACUTE '\xf9'  # 0xF9 -> LATIN SMALL LETTER U AFGRAV:a:A: tb:B: CIRCUMFLEXc?C? DIAERESIS>Au011D>EeOGONEK;!21;E;T;COMMA BELOW@8xffF@Y@) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_2 generated from 'MAPPINGS/ISO#/-2.TXT' with2P.py. m#" import sjAPIs class ($. 1): 7Adef e(self,input,errors='strict'):,creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='E-2',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +W'\x00P 00PANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDG(07&7 -> BELL '`\x08' # 0x08 -> BACKSPACE 2'\t"" $9$HORIZONTAL TABULATION0n0A0LINE FEED$2x0b&TB$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR2x0e,|E*SHIFT OUTf$F$IG'10# 10#DATA LINK ESCAPB8x11+1+EVICE CONTROL ON-2-2-4TWO(13-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK1eCANCEL!9UUeMEDIUM(a(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt0"'"2uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF[3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3F4COLz; CGSEMI$<' # 0x3C -> LESS-THAN SIGN '='p# 0x3D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARKz@( 40(COMMERCIAL AT(A(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1CL1LbM1LM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'LSMALb/ /c/ /d/ /e/ /f/ /g//R G 'h'  # 0x68 -> LATIN SMALL LETTER H &0'i'/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f#7UDELET!'80!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@x9A -> '\x9b'  # 0x9B -> zT z 79<<Z< = SOFT HYPHE7(bb <&< uDOT ABO!xbBBhDEGREE?5B?OSMAL=B= ^6142\> \<b<v ACCENT3<B;b ^59 :{t!2c9B7Z(xb0B0CVB.|\Au015<|,: v* <(eB( :&Fu02dB&qDOUBLE S 7.h 7,: *Vo>C*jRcC@J!xc<AxCIRCUMFLEXAC3 -> LATIN CAPITAL LETTER A WITH BREVE '\xc4'  # 0xC4 -> LATIN CA<DIAERESIS@Pu0139B@5@L|DACUT|Vu0106<6<C<0xc7: 7< vCEDILLA 0c@8>CARON<!xcz9<EVu0118xA< eOGONEKyb;yB=  1aBC@ Cd:|D<I8xce<E< CIRCUMFLEX(CFAD}r0</D0< WSTROK&43=1=Ny 4y2< !xdvn/D3<Ox(xdD<n52AxDOUBLE !xdC U!xd:@MULTIPLICATION SIGFu015UDR.jFu016[DU<RING ABO@dSA'Gu017j<jC jDY &62T< 0xdf<ESMALgSHARP n 557UE 50xe18oE :" :::O0? eE: '\u013a' + # 0xE5 -> LATIN SMALL LETTER L WITH ACUTE '\u0107' :6:C:!xe8:7: wCEDILLAvdv8< CARON:0xe98v9:EAu011<$A: eOGONEKubuB; DIAERESIS>y@yC> C%D:I8xeeE: CIRCUMFLEX 0fAF?Dy1:/F0: WSTROK&44;1;Nu &48:2: 0xf38b/F3:Ot!xf:4: b5(yiDOUBLE8xf6A (xfFDIVISION SIGoFu0155FR ZFu016CFU:RING ABOV 8xfa? 7Z:Zc{A ZFY 6uFT: Q'2d3DOTS) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_3 generated from 'MAPPINGS/ISO#/-3.TXT' with2P.py. m#" import sjAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ingCo6o*B oo IncrementalEncoder(cs.Incremental): def e, (self, input, final=False*.sreturn Ucharmap_@:F.errors,ing_table)[0] class DeOd,'@StreamWriter(Codec,8cs.Dpass0Rea9 92###ings module API getregentry(7 eQInfo(name='iso8859-3',!e=42().iP:'r=c/J //str;=H #w##@) N[Ping TH5cod2 = +`'\x00'1 # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP* 0x1E -> RE CORD SEPARATOR '\x1f'  # 0x1F -> UNIT) &" ) 20)RSPACEI! 1 EXCLAMATION MARK+"+2+LQUOT)#)3)NUMBER SIGNO$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq1"'"1 7$POSTROPH(I8%LEFT PARENTHESISP+')+9+ORIGH,*,A,sASTERIS_+#B#GPLUS,$C$RCOMMA- D HYPHEN-MINU.'E'FULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU<5%SK3FIVJ6%Q%2SIX7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM1bM1N11O11O 'P'  # 0x50 -> LATIN CAPITAL LETTER P 'Q'111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/C.REVERSE SOLIDU])sD*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/ /L/m//M/n//N/o/O/p/7^q/r/s/"t/u/v/w/x/y/z/{/CURLY BRACKET c '|'  # 0x7C -> VERTICAL LINE +'}(D(RIGHT CURLY BRACKET.~.E.CTILDNB\x7f#vF UDELET!'80! 80!eH\x81$1$2$2$3$3$4$4$5$5$6$6$7$7$8$8$9$9$a$A$b$B$c$Gd$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACAu012AELATIN CAPITEETTER H WITH STROK=!2d=^DBREV (xaZAZPOUND SIGNa[A[CURRENCY(cufffe'57zH CIRCUMFLEXA(xaeAexSECTIONu!xa" hhDIAERESISKAu013n$hICuDOT ABO&Au015@@S@vCEDILLA~1>>G>F<J<FASOFT HYPHE 7PtZt .\xb0' #  0xB0 -> DEGREE SIGN '\u0127' # &1&LATIN SMALL LETTER H WITH STROKE;0xb29;2;SUPERSCRIPT TWO*3*3*6HREV4,4,ACUTE ACCENTS5'5'\MICRO'6%CIRCUMFLEXd7?MIDDLE DO88%sCEDILLAGPu0131$9"DOTLESS I7&5f7A7S s1<B<G<DBREV3C:J:3d3D? VULGAR FRACTION ONE HALFTfffe' @017cB,F@,ZuDOT ABO0xc0<~C>eCAPITAA@7GRA<< <(xc C x 7u(xcCN DIAERESISPu010aDC@C F@@6 @ (xc8C8 !xc}Q>E 9<k < 5<p<b}uA !xc{ @IxCx5< eEtxlA dDNDTILD(xdDO< ;dDB< BdD< BsD 7xd6D6 -> LATIN CAPITAL LETTER O WITH DIAERESIS '\xd7'  # 0xD7 -> MULTIPLICATION SIGN.Pu011c0.8.LATIN CAPITnGnCIRCUMFLEXA0xd9? o9AUAUGRAVE<a<A< FACUT<b<B< CA hAu016B:D@ 5BREGu015<E<S5fFAESMAL#eSHARP 'e05/E05At (e1:1: (e2:2: dufffe'/(e4L4L 03/E5>CxDOT ABO0>6> (xeEg }uCEDILLA8 <E E: E:jy? !xe> >Id+: e::E flFlNETILDflFl8 )'f3/F3: 8fF: 8Au012WF} 8xf6} v(xfF_DIVIS#W (xfFf# 0xFA -> LATIN SMALL LETTER U WITH ACUTE '\xfb' # 0xFB -> L:CIRCUMFLEX?c?C? DIAERESIS>Pu016d@}D> DBREVGu015:E:S Vu02d9yF?DOT ABOVE ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_4 generated from 'MAPPINGS/ISO#/-4.TXT' with2P.py. m#" import sjAPIs class ($. 1): Adef e(self,input,errors='strict'):,9creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='E-4',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +P'\x004 , 006ANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDG8x07&w7 -> BE88tACKSPACCt"Q9$HORIZONTAL TABUn0A0LINE FEED'\x0b' # 0x0B -> VERTICAL TABULATION '\x0c' ! #.C.FORM FEED$r" $D$CARRIAGE RETURNe,NE*SHIFT OUTN8x0f$F$IG'10# 10#DATA LINK ESCAPEN(11+1+EVICE CONTROL ON-2-2-5TWOZ3-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb% 1ILE SEPARATOFdJ_GROUP*1oRECORD+1LUNIT) { 2CSPAC! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSAN"1"'"C uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDFP3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3F4COL(; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,# 0x3F -> QUESTION MARK '@' # 0x40 -> COMMERCIAL AT(A(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1CL1C1LbM1D1M1N1E1N1O1F1O1P15P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/P5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'LSMALb/ /c/ /d/ /e/ /f/ /g/ /h/ /i/ /j/SMALL LETTER J 'k'# 0x6B -> LATIN SMALL LETTER K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/EFT CURLY BRACKEG|-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f#7UDELET!'80!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@x9e' # 0x9E -> '\x9f' # 0x9F$'a0$ A0$NO-BREAK SPACEMPu0104+M A1)LATIN CAPITAL LETTER A WITH OGONEK=&38=2=ESMAL;6KRA1&56131 nRndCEDILL>!xa A4>CURRENCY SIGNf25(IfGTILD&3b6<L< 7<7>xSECTION!xa'8'DIAERESIS69$S7ARO 12<A<E<9MAC=2=B=G= Gu016C>T>TSTROK}0xadD=SOFT HYPHE7($ZcC(xa<A< !xbuB9hDEGREE65B6 4&2daB4 U5F\$ \"b"B"ACUTE ACCENT\&29! cc: :Gu02c bB]1~ ~3: :; ; < Vu014a 6ENG&7e3 nmm : k0)C'1  dcdC>=!xc<?y CIRCUMFLEXAA_}(xc_C_} !xc5|x|LETTER A WITH RING ABOVE '\xc6'  # 0xC6 -> LATIN CAPITAL LETTER A2Pu012e4272I WITH OGONEKoVu010c=8=C=SCARON<0xc9: 9<E<GACUT 18>A< 0xcb;yB= DIAERESISAu011f}C@+OTdD@r!xcE< CIRCUMFLEX 2aFA 6MAC0=/D0=DWSTROK&45=1=N=vCEDILLA4j/D2>O> 3/D3=K= {0xd4t/D4>{ t!xdA5A DTILD6!xd<} 8xd7MULTIPLICATION SIGdVnn  72m[DUf dz= dD<[}A eAu0169@<<< 0xdfqESMALgSHARP  017rE 5A pe9pE; e:: e3??`(xeE: (xeE>eE ?0TTER I WITH 2OGONEK '\u010d' # 0xE8 -> LATIN SMALL LETTER C WITH CARON :0xe98:9:E:VACUTEt1<tA: 8xebuB; DIAERESISy7@yC> tOT ABOV!xe)D>I0xeev:E: CIRCUMFLEX2F? 6MACPu0111|;/F0;DTSTROKVu0146;1;N;vCEDILLA4-w2<O< 3/F3;K; w0xf4h/F4<w h8xf5?5? DTILD,!xf*y6: !xf>7>DIVISION SIGr(f8  73=UV s fa9;!xf::cy? UFu016eF>:,: '2duDG) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_5 generated from 'MAPPINGS/ISO#/-5.TXT' with2P.py. m#" import sjAPIs class ($. 1): Adef e(self,input,errors='strict'):,acreturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S )[0] class IncrementalDecoder(>cs.): def d, (self, input, final=False*.sreturn Ucharmap_@:F.errors,ing_table)[0] class StreamWriter(Codec,UzJpass90Rea9 9 ### encodings module API getregentry(7 eQInfo(1name='iso8859-5',h!e=42().i:'r=E/er/J //str;=g. #w##@) N[Ping TH^2 = +`'\x00'1 # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+ 0x22 -> QUOTATION MARK '#'# 0x23 -> NUMBER SIGN&$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq0"'"7$POSTROPHE%+'(I8%LEFT PARENTHESIS+)+9+ORIGH,*,A,sASTERIS6+#B#GPLUS,$C$RCOMMA- D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$2$#TWH3$TmCTHREJ4&TBFOUR5%SK3FIVJ6%Q%2SIXI7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUES@@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM1bM1N11O11P151Q1QR1;S1 # 0x53 -> LATIN CAPITAL LETTER S 'T'# 0x54 ->1T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/C.REVERSE SOLIDU]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE`# 60#YGRAVEJa'1'ESMALAVb/2/B/c/3/C/d/ D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/[ /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/v/w/x/y/z/{/ZCURLY|-`VERTICsB}(RV~.CTILD~3\x77DELETE '\x80' # 0x80 -> `'\x81'  $1$2$2$3$3$4$4$5$5$6$6$7$7$8$8$9$9$a$A$b$B$c$C$d$D$e$E$f$F$'90$9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACEAu040GAE CYRILLIC CAPITAL LETTER IO5X5V5(DJkj6h6G6|6z6UKRAINIAN Iu??(DZ666BYELORUSSIAN-,KK'YI555 *55L666N6668TSHX)7'7Km(xa9A9SOFT HYPHEN4=\;\wSHORT U:S:Q:(DZ1f7BdCYRILLIC CAP%ITAL LETTER A '\u0411' # 0xB1 -> CYRILLIC CAP4'BE52525 V53535 (GH64646 D55555 I56565 Z7676 k8585 It9494 hSHORT :a:A: Kb5B5 'ELc5C5 M5d5D5 N5e5E5 O4f4F4 P%205/C05 &ERj2UCU 'ES5UCU TUCU UiSCS 'EF5SCS HE2SCS (TSSCS C2TCT SVCV C8TCT HARD SIG2[C[ 8YER]C] LSOFTsdCd cCc YdCd Y'3dDdOSMAL3aDa 23_D_ 33]D] 3 3]D] 43[D[ 33YDY 3ZHE '\u0'437' # 0xD7 -> CYRILLIC SMALL LETTER ZE '\u0438383I29292hSHORT 8a8A8'KAkb3B3'EL3c3C3M3d3D3N3e3E3O2f2F2P%403/E03&ERf&41313S32323T3333Ue4242'EF35353H/&46363(TS3E3(CH44E4S6E6 C64E4HARD SIG4;E;8YER=E=LSOFToDED CECYDEDY6211FDkNUMERO57F7I57F7'DJ858F8G4:F:UKRAINIAN IqDFDD52EBYELORUSSIAN-~5ZFZY#5YFY XFXL4VFVN4PFP(TS)5PFPKi!xa5FJ|SECTION? 0xFE -> CYR)ILLIC SMALL LETTER SHORT U '\u045f' # 0xFF -> CYR8 DZHE ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_6 generated from 'MAPPINGS/ISO#/-6.TXT' with2P.py. m#" import sjAPIs class ($. 1): .Adef e(self,input,errors='strict'):,^creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='E-6',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +P'\x00EG 00GANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt"Q9$HORIZONTAL TABULATn0A0LINE FEEDb& 0B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUN$IG1h1h DATA LINK ESCAPE '\x11'  # 0x11 -> DEVICE CONTROL ONE "`'\x12' -2-5TWO-3-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATOFd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &{ 20)CSPAC! EXCLAMAT3MAR"+LQUOT)#)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq1"'"V uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZER1%`%3Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:MFCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D14 -> LATIN CAPITAL LETTER D 'E'# 0x45 -> LATIN C1E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/d5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'ESMALbA,b/ /B/c/ /C/d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/  /l/8 /m//n//o/ATIN SMALL LETTER O 'p'# 0x70 -> LATIN SMALL LETTER P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#F UDELET!'80!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACcufffe' (xaACURRENCY SIGNB \ffe' '\ufffe' '\u 060c' # 0xAC -> ARABIC COMMAA0xad%'D'SOFT HYPHEN&gb@061b BBSEMICOLOF061fRFRQUESTION MARK*E0621<'C1<LETTER HAMZVu0622.2.ALEF WITH MADDA ABOVEyF0623>3> v >4>4>2WAW{=5=5=>WBELOW6>6>?YEH{ 7=7={j8-8-7BEH,9,9, TEHRBUTa4A4`C)THC-GJEEMZC-(HAeEK- C Y6DAL%30Y.D0Y)TH-'D'R 3%D%5ZAI6063D&SE6063D*SH.D7SAD DD,DT3DZ,D 7D'GH..6064,E,gTATWEEU4(E(F(4(E(6QAF4'E'K,&E&'LA4$E$M4%E%TER NOON  '\u0647' # 0xE7 -> ARABIC LETTER HEH ,8,8,7WAW,9,9,ALEF MAKSURA5a5A5Yb,B,FATHATANVc*C*KDAMM*d*D*KKASR*e*E*~{f'F'{'%50''F0'x'1'1'WSHADDG&52(2(5UKUTfffe'\ ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_7 generated from 'MAPPINGS/ISO#/-7.TXT' with2P.py. m#" import sjAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='E-7',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +A'\x0/01ANULL0')START OF HEADING '\x02'  # 0x02 -> START OF TEXT (3(3(=END&4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&7 -> BELL88tACKSPACCt"" 9$HORIZONTAL TABULATn0A0LINE FEEDxb&TB$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG'10# 10#DATA LINK ESCAPB8x11+1+EVICE CONTROL ON-v1vD-4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE(19fUeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt0"'"2uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF[3[DIGIT ZER%`%$Y$$T$&T%SKFIVE '6' # 0x36 -> DIGIT SIX 0'7'$7$BEVEN&8&8&REIGHT&9&9&BNINE%:%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK@( 40(COMMERCIAL A4A(1(LATIN CAPITAL LETTER AYB121B1C131C1D141D1E151F1FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa'LSMALb/ /B 'c'  # 0x63 -> LATIN SMALL LETTER C 'd'/4/D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/S/t/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x77UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$C$$9$=8= $9@9@9@9@9@9@9@9@x94' # 0x94 -> '\x95' # 0x95$6$6$7$7$8$8$9$9$a$A$b$B$c$C$d$D$e$E$f$F$'a0$ A0$NO-BREAK SPACEAu201K A1) LEFT SINGLE QUOTATION MARK5\525ORIGH6 8xa336POUND SIGN[aK[iLEURO$$ixDRACHMA'(xalAlBROKEN BARp(xamAm1SEC!xa% ApDIAERESISK$pDCOPY1037wuGREEK YPOGEGRAMMENIWA-POINTING DOUBLE AxT NO(xaASOFT HYPHESfffe'<HORIZONTALebB DE 'b1 BPLUS-MINUS*2*SUPERSCRIPT TWO(xbtBt *5HRE @0384XB{dK TONOFu038B}&DIALYTIKA0V0@CAPI(LETTER ALPHA WITH@(xbBMIDDLE DOTee~EPSILONgBBBT>B /IO?(xbB6:B_OMICR(xbBVULGAR FRAONE HALFye4uUy BEBOOMEG{9^C\@cSMALL ^y9ANDkAu039KKCAPITAL LETTE+R ALPHA '\u0392' # 0xC2 -> GREEK CAPITAL LETTER BET43434HGAMM545459DELj5555wEPSILON6767Z7474 38383*TH59595)IOa4A4HKAPPqb5B5HLAMD5c5C5'MUld2D2N2e2E2'XIdf2F2XOMICR%a07/D07Pi&a12124RHOTfffe' 603aD8SIGaD'TACaDUaD(PHDC3D(PSfDGOMEGaDJ WITH DIALYTIKC$D$HF5D5ESMALBwBWTONOS4ADA >@ODO @/TA<YDY <A b_E_ =;\ AND N{E{ NE:bE 3 bE 2 bE 3 bE 3E 5 bE 2ETA '\u03b8'$ # 0xE8 -> GREEK SMALL LETTER THETA '\u03b9'393)IO2a2A2HKAPPeb3B3HLAMD3c3C3'MUd0D0N0e0E0'XI`f0F0vOMICRON5%c05/F05Pe&c10107RHOa2121FINAL SIGM_&c3939 34343'TAc&c5151YUPSIL36565(PH47171C181%(PSb#F#HOMEG_$F$V WITH DIALYTIKA2F2<DCFCDWTONOS]SFS @cFc8~fffe' ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_8 generated from 'MAPPINGS/ISO#/-8.TXT' with2P.py. m#" import sjAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@Q[0] class StreamWriter(Codec,cFs.St): pass class ORead9 9### encodings module API def getregentry(7sreturn QInfo(name='iso8859-8',h!e=42(). deUincremental:6r=IE/er/J /Dl/sZr;=HR#w##@) N[ing TableH^ _t2 = +`'\x00'1 # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSAND "'"  # 0x27 -> APOSTROPHE 0'('%8%LEFT PARENTHESIS+)+9+ORIGH,*,A,ASTERISKO+#B#PLUS SIGN$,$C$RCOMMA - D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$2$#TWH3$3$3HREJ4&4&BFOUR5%5%#IVJ6%6%2SIXI7$QCSEVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1UV1 L LETTER V s 'W' # 0x57 -> LATIN CAPITAL LETTER W )+'X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET.$\\/C.REVERSE SOLIDUS*]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE~`# 60#YGRAVEJa'1'ESMALAVb/2/B/c/3/C/d/4/D/e/5/f/6/F^g/ G/h/ /H/i/ /I/j/ /J/k/ /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/Uv/V/w/x/y/z/{/ZCURLY|-`VERTICB}(RV~.CTILD~3\x77UDELET!"80D!8H\x81$$2$$3$$4$ '\x85' # 0x85 -> $6$6$7$7$8$8$9$9$a$A$b$B$c$C$d$D$e$E$f$F$'90$/90$1$1$2$2$3$3$4$4$@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACEcufffe' (xa.A.CENT SIGN$.A.ZPOUND%/A/CURRENCY(3A3:YEN#2A2BROKEN BAR3A3kSECTIOL6A6DIAERESISK6A6COPYRIGH dt;MULTIPLICA{EAELEFT-POINTING DOUBLE ANGLE QUOTDEMARKeAe*NOadAdSOFT HYPHEfAfREGISTERElAlUMACROKbiBiiDEGREEbBPLUS-MINUS*BSUPERSCRIPT TWObB *4HRE(xbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DOTqBuCEDILLA"B%ONfq\DIVISb# 0xBB -> R%IGHT-POINTING DOUBLE ANGLE QUOTATION MARK '\xbc'  # 0xBC -> VULGAR FRAC/ ON=UARTER6d6D6EHALF3e3E3ETHREkS9oufffe' @2017B DFxLOW LINEE05d0* E0*HEBREW LETTER ALE0Vu05d1-1-7BETY2,2,WGIMEL.3.3.9DAL\4.4.H5+5+7VAV6,6,WZAYIN.d.E7.H8Z8,T,9,9,7YODa,A,FINAL KAb2B2 ,FE HLAME. .7MEM2 2 ,f ,^'NUeF ,FfSAMEKHeF (eFPeF +F\WTSADIF .F'QO\eF8RESDF(SHleFT6200pFLEFT-TO-RFu200qF%.6 -t) ### Encoding table encoding_table=codecs.charmap_build(de$) """ Python Character Mapping CB iso8859_9 generated from 'MAPPINGS/ISO#/-9.TXT' with2P.py. m#" import cs ###jAPIs class($.): def ee(self,input,errors='strict'):,0creturnoB=,A)o6o*B ooIncrementalEr  h final=False*Y.S 4[0]DXeN!@QStreamWriter(N,[5pasORead9 9Js module API getregentry(7 UInfo(cname='E-9',h!e=42().ij:'r=}/J //str;=H #w##") [TH2 = +`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH13' # 0x13 -> DEVICE CONTROL THREE '\x14' # 0x14 -/EFOUR.5.5.NEGATIVE ACKNOWLEDG]6/6 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATOFd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &"  20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq1"'" uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3T%SK3FIV%Q%2SIX$Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F1LATIN CAPITAL LETTER F 'G'# 0x47 -> LATIN CAPITA1G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /g/ /h/ /i/ /j/ /k/ /l/ /m//n//o/p/7^q/TTER Q '3r' # 0x72 -> LATIN SMALL LETTER R '+'s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#JF UDELET!'80! 80!H\x81$1$2$H3$$4$$5$$6$$7$|$8$q$9$f$a$[$b$P$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACaEAE INBED EXCLAMATION MARKaUAUCENT SIGN$UAUZPOUND%VAVCURRENCY(ZAZ:YEN#YAYBROKEN BAR p'\xa7'  # 0xA7 -> SECTION SIGN '8'8'DIAERESIS$9$9$COPYRIGHTMa)A) FEMININE ORDINAL INDICATOR^b5B5LEFT-POINTING DOUBLE ANGLE QUOTAEMARKDcDCD+NOd#D#SOFT HYPHEe&E&REGISTEREDf*F*UMACROK'b0! B0!iDEGREEG(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWO(b3*3*EHREE,4,4,ACUTE ACCENT'5'5'ZMICRO6%6%zPILCROW'BMIDDLE DOqBuCEDILLAB&ONBoMASCUL bBbBVULGAR FRA ONEARTEbB6EHALFe| 3T1 QUkbBINVERTED QUESlcCLATIN CAPITAL LETTER A WITH GRAVcC< cC< CIRCUMFLEXACA FTILD'C'< Cc@C@@ R7ABO:\C\AgCg2C ^cC>E> C< C< CA C@IC< C< cf' # 04xCF -> LATIN CAPITAL LETTER I WITH DIAERESIS '\u011e' # 0xD0@G@SBREVE<0xd1:<1<N<FTILD<2<2<O<7GRAx3<3< FACUTx4<4< CIRCUMFLEX5A5A 6<6< 8xd7@7@MULTIPLICATION SIGN8.8.cVSTROK(9=9=Ua<A< b<B< cACA dPu0130BD@QeOT ABOGu015QE@S9uCEDILLAf|SESMALdSHARP !xe5&E0s 5Aq JeE: eE:eE? DeE: (xeE>IRING(xeE ?FeE 0C eE <E< E: E:E?E >x d6E: ;:E |@kFzf 0xF1 -> LATIN SMALL LETTER N WITH TILDE '\xf2' # 0xF2 -> LAT:O:FGRAV:3:3: FACUT:4:4: CIRCUMFLEX5?5? 6:6: DIAERESISx7>7>DIVISION SIGN(8(8(SVSTROK9;9;Ua:A: b:B: c?C? TPu0131@D>DOTLESS IcVu015f7E7S(sCEDILLA<!xf: F<Y<) ### Encoding table e_ =codecs.charmap_build(de3$ ) # # johab.py: Python Uni= CB for JOHAB-*Written by Hye-Shik Chang # import _Rrcs_kr, multibytec as mbc &' =:A.get!('') class(!s.!):d2e =t. PIncrementaleer(mbc.M ,U 4 D 4 StreamReader(T,!.^N^ ! ^^def getregentry(&breturn"UInfo(Sname=WJ0=#()?5iFI.r=/J //sr=w #cwriter#<#T) """Character MappV9 koi8_r generated from 'MAPPINGS/VENDORS/MISC/KOI8-R.TXT' with gencodec.py. """#" import codecs ### C APIs class($.): def en(self,input,errors='strict'):,0creturno.charmap_B=,ing_table)o/deo-B ooIncrementalEr  h final=False*Y.S 4[0]D"e!@QStreamWriter(N,8cs.5pasORead9 9Js module getregentry(7 UInfo(name='koi8-r',e!e=12().ig:'r=z/J //sqr8=E #w##") [Ping TE5cod2 = (`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDLE '\x17'  # 0x17 -> END OF TRANSMISSION BLOCK48484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTE%b%B%VESCAP!c!C!FILE SEPARATORJd)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" j 20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq1"'"r uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIXQ3Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11AL LETTER I p 'J'# 0x4A -> LATIN CAPITAL LETTER J &+'K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1Z1[1EFT SQUARE BRACKET$\\/o5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMAL<AVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /k/ /l/C /m//n//o/p/7^q/r/s/"t/u' # 0x75 -> LATIN SMALL LETTER U 'v'# 0x76/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F TDELET!Pu2500#! 80!BOX DRAWINGS L|HORIZONTAL\828186c626DOWN AND <13< 3LEF|&14w4;/UPu8:5: sX y2@ 2(?i3:A3?J? E8`UPPER HALF BLOCK8^?LOW+aMFULLPX_z9b+1M9l_5SHAFu259Z9Z|MEDIUM '3MKKDARK%&32942TOPhINTEGRa,%LACK SQUAR16219xULLET OPERATOR621a*KF ROO&249ALMOST EQUAL TOP69LESS-THAN OR05GREATER3x! 9NO-BREAK SPAC'32oBOTTOM\!xbZXDEGREE SIGN!xb&SUPERSCRIPT TW 0xb7*MIDDLE DZ)xf%DIVISIONwAu255A DOUBLE HORIZON)TAL '\u2551' # 0xA1 -> BOX DRAWINGS DOUBLE VERTIC72727WN SINGLE AND RIGHTM{(04{3D CYRILLIC SMALL LETTER IO3F2553w43 #WNfwD4D5DFDOWND=5=6= {e:F:efH/B0H&60H6=B 7040G oCAPITA 6B || 6RBNLG6NBpHORIZONIZBI `BI_B# @ 6256jB( G oB- GmB2wFB>M McBJT|F!xaBVDCOPY"GN)\u044e' # $ 0xC0 -> CYRILLIC SMALL LETTER YU '\u0430' # 313A21222&BE3&46333'TS4&34444D35353I34f63&EF&33f73(GHg84Hg8g93I92A2hSHORT 8a8B8Kb3C3'ELc3D3M3d3E3N3e3F3O2f2D4P34Y14gD5&ER4hD5'ES324TD42D3Z34V0D3SOFT SIG4D:8YER7;=ZD8S4D9 D89SHCh;C4D<KHARDr2vEDoCAPITAz1EF 5G1EG 4~2EI 5 1EL 61EN 52j Q 51ERCYRILLIC CAP'ITAL LETTER GHE '\u0425' # 0xE8 -> CYRILLIC CAP6&HA5&18595 I494A4 hSHORT :a:B: Kb5C5 'ELc5D5 M5d5E5 N5e5F5 O4f4/F04 P515 Y=&20j25 &ER&21535 S52545 T3555 Ui&16464 Z176 VFFS SOFT SIG2FZ 8YER7] ZFX S2FY }2FX 9SHCl[ C20F\ BHARD) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCBp koi8_t* # http://ru.wikipedia.org//КОИ-8( www.opensource.apple.com//libiconv %-4 /tests/KOI8-T.TXT import APIs class ($. 1): Adef %e(self,input,errors='strict'):,rcreturnoIB=,4ingWCopo*B ooIncremental$er h final=False*Y.S 4[0]Der(codecs.Increm entalDecoder): def d (self, input, final=False*.preturn Acs.charmap_@:F.errors,ing_table)[0] class StreamWriter(Codec,UzJpass9ORead9 9 ### encodings module API getregentry(7 QInfo(1name='koi8-t',e!e=12().aincrem:6r=IE/er/J //sqr8=d+ #w##@) K[Ping TE[2 = (`'\x00'. # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#' # 0x23 -> NUMBER SIGN '$'p# 0x24&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq0"'"mq7$POSTROPHE%+'(I8%LEFT PARENTHESIS+)+9+ORIGH,*,A,ASTERISKO+#B#GPLUS,$C$RCOMMAD- D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$2$#TWH3$3$3HREJ4&TBFOUR5%S3FIVJ6%Q%2SIXI7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1S 'T'  # 0x54 -> LATIN CAPITAL LETTER T &0'U'151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/TC.REVERSE SOLIDUSX])D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE~`# 60#YGRAVEJa'1'TESMALRAVb/2/B/c/3/C/d/ D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/* /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/v/w/x/y/z/{/ZCURLY|-`VERTICBB}(RV~.CTILD~3\x787TDELET!Au049`!8CYRILLIC SMALL LETT:ER KA WITH DESCENDER '\u0493' # 0x81 -> CYRILLIC SMALL LETTER GHE CdSTROKE@F201a@2@ SINGLE LOW-9 QUOTATION MARK6F0492636voCAPITAxeB4BODOUBx F2026656pHORIZONrELLIPSISF2020.6.FDAGG=F2021!7! (7fff8(UNDEFINEDm3m9$PER MILLE SIGN)704bA)< HF2039BBEFT-POINTING AbCD F04b7DD #CH|bEC E FE 6049 90$lE20189lSLEFT }i62019aORIGH6ckak$kd5Tk6 2 9TdBULLET62019GwEN DASH"4yH)EM" 9B1BQTRADEz C NC 7203%& i& i $$ $  lA HE04efA USWMACROeA> @5SA@ ~#IO>!xa<ACURRENCY604eA[!xahfB DN BAN!xa%1SEC  $  $ D '\xab' &# 0xAB -> LEFT-POINTING DOUBLE ANGLE QUOTATION MARK 9`'\xac'  DCDNOT SIGN#d#D#SOFT HYPHE&e&E&REGISTEREDPAufff,sF*UNDEFINEDt'b0N B0$hDEGREEJ8xb1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWOzAu040V B3* CYRILLIC CAPITAL LETTER I5 B45 Au04eY5$Y WITH MACROa(b66@zPILCROW7'7'MIDDLE DOT 8% 1211r9$hNUMEROo  BA& J8xbbORIGH i i $$  $8xa9ACOPY @044e+$CESMAL+$YU{104333A2C2&BE34C 'TS4&34gD353  gI34ff&EF&33f3(GHg4Hg8g3I)2hSHORT 8aj8KEk3'EL3 3M333Gu043+/ ,E043fD4P34Y14gD5&ER4hD5'ES3D4TD42D6 -> CYRILLIC %SMALL LETTER ZHE '\u0432' # 0xD7 -> CYRILLIC 4V3&4c383SOFT SIGNm&4b:9:FYERU5&375A5Z83B36SHAg&4d4C4f92D29SHChE6C&4ajF4KHARDr%2e:)E0:eCAPITAYr&10515 ?&11424 BB&26535 'TS6&14646 D55555 I52j65 &EFI&13j R sG2 U 6L1EP 5IEO 4hSHORT :EV :KEW 5'ELbEZ 5M5EY 51  Z 5OifFT PK5T Y=2FU &ER2FU 'ES5FT TFT \FS 1T 2FFS 2FZ 1F] 2FX 2FY LETTER E ) '\u0429' # 0xFD -> CYRILLIC CAPITAL LETTER SHCHA 878E8 7CHE6a6F6 HARD SIGN ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB koi8_u generated from 'p6"-m,s/KOI8-U.TXT' with1P.py. i#" import sfAPIs class ($. 1): 1Adef e(self,input,errors='strict'):,creturno B=,4ingCo2o*B ooIncremental$er h final=False*Y.S 4[0]DT(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(`name='E-u',e!e=12().ig:'r=z/J //sqr8=E #w##") [T ~2 = (P'\x00E 00GANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGU!x0w7 -> BE8E8tACKSPACCt"C9$pHORIZONvTABULATn0A0LINE FEEDb&Z 0B$VERTICAL R8x0c.C.HFORMRr"ARRIAGE RETUR[e,|SHIFT OUT '\x00f' # 0x0F -> SHIFT IN W'\x10# 10#DATA LINK ESCAPE+1+1+EVICE CONTROL ON-2-2-5TWOZ3-3-6HRE\4/4/EFOUR]5.5.NEGATIVE ACKNOWLEDG]6/ 6 4YNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B% c!C!FILE SEPARATOFd)D)_GROUP*e*E*oRECORD+1LUNIT) Q1 2CSPAC! EXCLAMAT3MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSAND0"'" uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF[3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1L LETTER B s 'C' # 0x43 -> LATIN CAPITAL LETTER C )+'D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S1S1T1T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'ESMALA,b/ /B/c/ /d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/k /l/ /m// M 'n'  # 0x6E -> LATIN SMALL LETTER N %0'o'/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.CTILDNB\x7f#7TDELET!Pu2500#!8BOX DRAWINGS L|HORIZONTAL\82886c66DOWN AND <1< 3LEF|&14w;/UPu8:: s9 y2@ 2(?i3:A3?J? E8`UPPER HALF BLOCK8^?LOW+aMFULLPX_z9b+1M9l_5SHAFu259Z9Z|MEDIUM '3MKKDARK%&32942TOPhINTEGRa,%LACK SQUAR16219xULLET OPERATOf\u221a*KF ROO&249ALMOST EQUAL TtP69LESS-THAN OR0L TO '\u&2265' # 0x99 -> GREATER-THAN OR EQUAL TO '\xa013A3NO-BREAK SPACE)Pu2321+\B)BOTTOM HALF INTEGRAL/)xbXC/DEGREE SIGN&2S~D&SUPERSCRIPT TW(b7*E*MIDDLE DOTOf%F%DIVISIONwAu255 A0( BOX DRAWINGS DOUBLE HORIZONT9/A19iVERTIC7p27WNGLE AND RIGHTGu045{3DCYRILLIC SMALL LETTER I4346w43UKRAINIAN I'55=5=$FDOWN6z6=BYELORUSSIAN-I7IEYI (@)?7255?8? 4LEFM8M <_UP SI F2559B\ BjSaBu.UPF255b; }l; q9qw GHE WITH UPTURJd e: :ifHBH69B[6UB  0G oCAPITA0B 5&63DD6040B 0B K6 6 @ e6256eB# G  '\u2569' 2 # 0xBB -> BOX DRAWINGS DOUBLE UP AND HORIZONTAL '\u256a' @C@VERTICAL SINGLEF_MF0490MDM"CYRILLIC CAPITAL LETTER UKRAINIAN GHE WITH UPTURNLF256cLEL0xa9DFFCOPYRIGHT SIGo@044e+!C0)ESMAL$YU6043/C13A21e22&BE3&46333'TS4&34444D35353I34f63&EF&33f73(GHg84Hg8g93I)A2hSHORT 8>C~ 6Kbq3E6043 CW f'EMdf>f3+OefeD4P34Y14gD5&ER4hD5'ES324TD42D3Z34V0D3=SOFD:8YER7;=ZD8S4D9 D89SHCh;C4D<KHARDx2vED 3z10' # 0xE1 ->% CYRILLIC CAPITAL LETTER A '\u0411' # 0xE2 ->4&BE5&26535 'TS6&14646 D55555 I52j65 &EF&13j75 (GHk86 Hu8k95 I94A4 hSHORT :a:B: Kb5C5 'ELc5D5 M5d5E5 N5e5F5 O4f4/F04 P515 Y=&20jU &ER2FU 'ES52jT TFT Ui1FS Z1T VFFS SOFT SIG2FZ 8YER7G] ZFX S2FY }2FX 9SHCl[ C20F\ BHARD) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB! kz1048 generated from 'MAPPINGS/VENDORS/MISC/KZ-.TXT' with7P.py. o#" import slAPIs class ($. 1): Adef e(self, input, errors='strict'):.|creturnqD >,Z4ing#Es< serrors='strisct'):  return codecs.charmap_de(input, errors, ing_table) class IncrementalEn8 r(>cs.zQdef e,s(self, jfinal=False*@:G.?[0]De'@StreamWriter(C,DpassORead: :2###ings module API getregentry(7 UInfo([name='kz1048',!e=12().im:.r=f/J //ssr9=F #w##@) K[Ping T,E5cod2 = (`'\x00' # 0x00 -> NULL1 1 1 START OF HEADING,2,2,ETEXT)3)3)0ENDS '4'4'RANSMISSIONV5/5/UQUIRY#6#6#ACKNOWLEDGE'7'w7 -> BE8 8 tACKSPACEt#Z9%HORIZONTAL TABULATn1A1LINE FEEDb'B%oVERTICT9x0c/C/HFORMTr#D%CARRIAGE RETURde-E+SHIFT OUf%F%II1x1xDATA LINK ESCAPJ)x11DEVICE CONTROL ON. 1 .4TWOP11 .6HRE^ 1 0EFOUR_ 1NEGATIVE z11SYNCHRONOUS IDL 1Fe BLOCK 1UCANCE(191WeMEDIUMKa)SUBSTITUTb' # 0x1B -> ESCAPE '\x1c' # 0x1C"FILE SEPARATOR*d*D*_GROUP+e+E+oRECORD,f,F,LUNIT* ' 20*CSPAC!!1!EXCLAMATION MARK",2,LQUOT*#*3*NUMBER SIGNQ$'4'XDOLLA'%'5'wPERCENTO&(6(AMPERSANDt2"'"7%POSTROPH(K8&LEFT PARENTHESISR,'),9,ORIGH-*-A-sASTERISh+$GPLUS,%RCOMMA-!|HYPHEN-MINU.(yFULL STOPM/%rTSOLIDH0#3kDIGIT ZEROI1&p&#ON~2%i%#TWJ3%d%3HREL4'd3FOU5&cM3FIVL6&a&2SIX7%a%3EVE8'b'E<N9']'$NI1:&VCCOLOn;!SGSEMI%<%SLESS-THAN}=*\XEQUAL>'[|GREATERT?-cKQUES@)4iERCIAL AT<A)lLATIN CAPITAL LETTER 4B2y2BdC22C2D22,'E22F22FG22G2H22H2I22I2J22J2K22nL2C -> LATIN CAPITAL LETTER L 'M'# 0x4D -> LATIN CAPIT2M2N2E2N2O2F2O2P2/502P2Q212Q2R222R2S232S2T242T2U252U2V262V2W272W2X282X2Y292Y2Z2A2Z2[2B2EFT SQUARE BRACKE[%\\0 5C/REVERSE SOLIDU]* +ORIGH[^0CIRCUMFLEX ACCEN_-rOW LINE`$6YGRAVELa(ESMALAXb0 0B0c0 0C0d0 0D0e0 0f0 0F`g0 0G0h0 0H0i0 0I0j0 0J0k0 0K0l0 0m00n00o0p07`q0r0s09t0 u0v0w' # 0x77 -> LATIN SMALL LETTER W 'x'# 0x780X0y090Y0z0A0Z0{0B0EFT CURLY BRACKET.|.C.VERTICAL LINE)})D)ORIGHX~/E/CTILDPC\x7f$7F!TDELET"Qu0402$" 80"CYRILLIC CAPIT(DJ73717 G7G201a727 SINGLE LOW-9 QUOTATION MARKX\u045n37 1 lel45ODOUBl G2026757pHORIZON ELLIPSISG2020/6/gDAGGER"1" )'ac)EURO SIGNN3pPER MILLE*G0409O5 L37EFT-POINTING A0|N|804977KA WITH DESCENDp804bEEDSHHAZ2040. ,87DZH 5B9B @F20189@L@kW72019?7 Y9?mmd@m7 2@DBULLW\u20193tEN DASHG2014|4)EM#7fff9.UNDEFINEDH1.QTRADE_ /5\ /  -l9-+.5F . { ,b# , 5* C * C (5(9( 6&"xa! ^A0 -> NO-BREAK SPACE '\u04b0' ## 0xA1 -> CYRILLIC CAPITAL LETTER STRAIGHT U WITH(OKJ1J2JOSMALH'd8H3H CCHWA1xa47" 49URRENCY SIGN)Hu04eb5)BARRED O<9xa6e6<BROKEN BAR&7&7&{SECTION048(~I9^96AOPYR !92,A*?GHE1xabAVBCLEFT-POINTING DOUBLE ANGLE QUOTAEMARKcECE8NOT 9xad$D$SOFT HYPHE9xae'E'pREGISTE -F+^ B0>iDEGREEb'APLUS-MINUS+Bu040>B"  BYELORUSSIAN-UKRAINIAN IHu045L & nJeP7$ J (b5BHXMICRO"xb!2zPILCROW( 4B4MIDDLE DOTq 2 0Bu21140JNUMEQu0493' - [+b+B+,Hu04d, SGu04aB?7 ]"ENDESCENDEE]E |C fF u C sGu041Cs 5C5B1/C V6 Cv (GH7ZCc 7D6a6_I6CoCYRILLIC CAPIT AL LETTER ZHE '\u0417' # 0xC7 -> CYRILLIC CAPIT768686 Ik9595 hSHORT ;a;A; 'KAqb6B6 'EL6c6C6 M6d6D6 N6e6E6 O5f5F5 P&206/D06 &ERl'21616 S62626 T3636 Uk4545 'EF65656 HP'26666 (TScDc C2dDd SfDf C9dDd HARD SIG2kDk 8YERmDm LSOFTutDt sDs YtDt Y13tEtESMAL3qEq 3Ba3oEo 4V4mEm 4G3mEm 5DikEk 4I4iEi 4 3gEg 5idEd 43`E` 3 3`E` 93WEW 43SxEC -> CYRILLIC SMALL LETTER EM '\u043d' # 0xED -> CYRIL4N4e4E4O3f3F3&PE4&404/F04'ER41414S42424T3434Ug4343'EF45454'HA46464(TS7575(CH58585S9595 C7a7A7HARD SIG'4b;B;8YERc6C6LSOFTqTFT SFSYTFT YA ) ### Encoding table e_ = codecs.charmap_build(de5& ) """ Python 'latin-1' C: Written by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s import APIs class(1): y# Note: Binhese as C functions will result in the X3notFqconvertXhem to methods. This ntended.4yeqG2_1_#v#Incremental$er#):Y"f h (self, input, final=False*creturnc.(:F.errors)[0]DBqBdef '@ `Stream1er(, 5pasLORead99C)2er(I, <"# #;e ### encod(ings module API def getregentry(): return codecs.CQInfo(!name='iso8859-1', en6=4. 'de incremental86r=IEXr/J /Dj/streamreader=S R R#Ewrit#W #) """ Python Character Mapping generated from 'VENDORS/APPLE/ARABIC.TXT' with/`c.py. `#" import~S ###]APIs class(=1): A (self,input,errors='strict' charmap_B=,ing_map)mm)B mmdtable)  h final=False*W.Q ?[0]~eL!@O (,W5pasF9 9F9mac-arabic/() 1().!eC0Map0codSmap =C.make_identity_dict(range(256)) 5.update({K0x0080: 0c4, # LATIN CAPITAL LETTER A WITH DIAERESISA1A%a0A NO-BREAK SPACE, right-left626%c76wCwvCEDILLA?3?9? E?VACUTE=4=/d1= N=GTILD=5=6= O=06AcA UA7Ae # LATIN SMALL LETTER A WITH ACUTE 0x0088:0e0, # LATIN S;GGRAV;9;2;CIRCUMFLEX{a@4@DIAERESIS?b?56ba?dARABICNOON GHUNNA5c550ab5&LEFT-POINTING DOUBLE ANGLE QUOTATION MARK, right-leftQdQ&e7Q@C{gCEDILLe=9= E= f;8; #90;9v#91@D@#92?d I 93;E2026;HORIZONTAL ELLIPSIS 94;E00ee;v5@f@6?/f1? NFTILDg#97;3; O; %9bORIGH(9f Gf@G&0fnPDIVISOSIGNf UAf ; ff|;*/fc @*a2_SPACE"a2oEXCLAM a23a6002NUMBER a2w_DOLLA3 &66qPERCENTna[AMPERSAND42APOSTROPHf2EFT PARENTHjt29 0x00aa: 0x002a,  # ASTERISK, right-left (2ab:0b0PLUS SIGN1c1560c1ARABIC COMMAYd(502d(HYPHEN-MINUS\e4e4FULL STOP1f1f1_SOLID`!b0/5660/-INDIC DIGIT ZEROn (need override)#b1O1O ?ONEN2N2N /TW3N3N ?HRE4P4P OFOUR5O5O /IV6O6O ?SIX7N7N 9EVE#(8P8P _EIGHT9P9P /NIyaO&033ICOLO0&610CQ SEMI8,+&03+LESS-THANab939_EQUALb838GREATERl @&61@QUESTION MARKcA6274+ TEARDROP-SPOKED PROPELLER~ cB2B LETTER HAMZTc#2#/ALEF WITH MADDA ABOVE2?x ?2?2WAW}>2>?VBELOW2??YEH}2>}l2.6BEH-2- TEGRBUTs6ETbs2s-HEH 0x00cc: 0x062c, # ARABIC LETTER JEEM c0x00cd.d.6HAH-e-e-K.f.f.5DAL["d0-/30-(TH.1.1.&RE#d2-2-FZAIN3.3.7SEE.4.4.H/5/5/&AD6-6-D-7-7-T#d8-8-Z-9-9- >a-a-)GH/b/505b/LEFT SQUARE BRACKET, right-leftc;REVERSE SOLIDUS7&05ORIGHs&05CIRCUMFLEX ACCEN &05 LOW LINEe 4 fTATWEE7e 4 F e 4 5QAF`e4K-4&LAse4Me46NOOe4H46WAW4LEF MAKSURA64Y&64wFATHATA&64+JDAMM+&64+JKASR+&64+&64(~(f5{(5VSHADDOf5FSUKUf7Pwf7(TT.8(TCdfd&AEaFVa # ARABIC LETTER GAF 0x00f9:@688, # ARABIC L-FDDAL.a./91.FRREH.b.507b.LEFT CURLY BRACKET, right-left:c:c:VERTICAL LINE5d5d5ORIGHpe;/69Jf-%d2h 3YEH BARREE }) ### Decoding Table d _tA = (d'\x00'00 -> CONTROL CHARACTER.1.1. 2.2. 3.3. 4.4. 5.5. 6.6. 7.7. 8.8. t, '9. n.a. 2x0b0#/0b. c.c. r,d. 2x0e0e. f.f. 11 11 11 11 11 11 11 11 11 9x191 :x1a. 11 11 :x1d 11 11   j2pSPACE, -!.EXCLAMATION MARK9"9MQUOT7right '##' # 0x0023 -> NUMBER SIGN, left-right ,-'$444_DOLLA4%454PERCENTi&565AMPERSAND0"'"72POSTROPHE3-'(e83LEFT PARENTHESIS9)999ORIGH: *:a:ASTERISKk+1b1OPLUS;,2c2XCOMMA`; in Arabic-script context, displayed as66C ARABIC THOUS SEPARATOR-xdxHYPHEN-MINUJ.5e5FULL STOP'B|DECIMAL/zfz_SOLID00 300DIGIT ZERO; Q0v-INDIC HN1o1o_ONE; o1o2ONEn2n2n TW2n2TWOn3nz_THREE3nHp4pOFOUR4pHo5o0FIV{5o#IV6o+o?SIX*6o2SIX7ngnOEVEN7nHp8ppEqp8pHp9pp!NIy9pHo:oOCOLO;. OSEMI2<203c -> LESS-THAN SIGN, left-right '='# 0x003d -> EQUALS4>4e4GREATER-n?:f:QUESTION MARK@6 406COMMERCIAL ATA*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353E3F363F3G373G3H383H3I393I3J3a3J3K3b3K3L3c3L3M32dM3N313N3O3*3O3P35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKET$\\=859REVERSE SOLIDUS8]7 8>ORIGHu^=HCIRCUMFLEX ACCEN_:O~OW LINE`16MSGRAVEfEa)CLSMALqb1A 1oc1? 1md' # 0x0064 -> LATIN SMALL LETTER D 'e'# 0x00651E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t1T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKET, left-right;|;VERTICAL LINE6}6ORIGHr~<*CTILD3\x77CONTROL CHARACTEB\xc4S.8PCAPITfA WITH DIAERESIJ\xa0B)NO-BREAK SPACE, 6-A;J\xc77/ yCyuCEDILLA@9@> @E@EACUT%*d1>K >N> c*d6>X >O> 5*dcBi BUBez e<EGRAV:*e2<CIRCUMFLE;\xerAH DIAERESIS ' '\u06ba' # 0x008b -> ARABIC LETTER NOON GHUNNA 60xab46c6&LEFT-POINTING DOUBLE ANGLE QUOTATION MARK, right-leftR*e7RdRATIN SMALLC WITH CEDILL*e9>e>E>UACUTEz8<f< FGRAV<</90< CIRCUMFLEX} I/91A DIAERESIS@d/92@IPu2026> 93<HORIZONTAL ELLIPSISe:4<LxfA5A *f1@6@NETILD*f3<7<O< .b8<ORIGH'*f49SLLfaA L |9PDIVISOSIGNfUFf9< tf</cpA / =3a^SPACE'!.oEXCLAM "9I #7NUMBER $4_DOLLA496>a9qPERCENTp&dAMPERSAND:0"'"lbAPOSTROPHm(e PARENTH< l-')9: *:}ASTERIS+1nAPLUS/k0 jkRCOMMAd-[WHYPHEN-MINUS, right-left '.'# 0x00ae -> FULL STOP, right-lef2/2f2~SOLIDUS0`\u06605b b00ARABIC-INDIC DIGIT ZERO@ (need override)P1P1P?ONEO2O2O/TW3O3O?HRE4Q4QOFOUR5P5P/IV6P6P?SIX7O7OOEVENQ8Q8Q_EIGHTQ9Q9Q/NI:K aPICOLO 1b3.b.NQ SEMI9-<( [c-LESS-THAN SIGd=7d7oEQUALS4>4HGREATERn  1f?PQUESTION MARKg\u274a1cQ TEARDROP-SPOKED PROPELLER ASTERISKQ8062RcR LETTER HAMZA03c30ALEF WITH MADDA ABOVE@$c$@z @c@2WAW?c?@WBELOWc@?YEH c?nc/7BEH.c. TEHRBUT RTdc.H/c ]GJEEMd/} /(HAe.w .K/'\u062f' # 0x00cf -> ARABIC LETTER DAL '\u0630' #..d0.)TH/1/1/7REH]2.2.GZAIN/3/3/8SEE/4/4/H05050'AD6.6.D.7.7.(TA8.8.Z.9.9. Ea.a.%GH0[+ b0LEFT SQUARE BRACKET, right-left$\==c<REVERSE SOLIDUS8]7td8?IGHu^=e=CIRCUMFLEX ACCEN_:LOW LINE4egTATWEEH4eF4e3QAFgHu064eK.e7LAM\e8MEE/e7NOO4eHe7WAWeLEF MAKSURA7 e Yb8eMxFATHATAc,,KDAMM,d,,KKASR,e,,f)))5f~)fWSHADDW5fGSUKU&7fP7f(TT/8f)TCrdf&AE aYfVafG8fD9IC LETTER RREH '{'# 0x00fb -> LEFT CURLY BRACKET, right-left;|;c;VERTICAL LINE6}6d6ORIGHr`\u0698Ae<ARABIC LETTER J.(d2.f.YEH BARREE ) ### Encoding Map e_map = {(100:0000,> # CONTROL CHARACTER-1-1-2-2-3-3-4-4-5-5-6-6-7-7-8-8-9-9-a-a-b-b-c-c-d-d-e-e-f-f-1111111111111111111111111111111122pSPACE, --a-(22EXCLAMATION MARKe8a8 p@2@OQUOTn 6a6QUOTATION MA RK, right-left 0x0023:, # NUMBER SIGN, --8 3/a33. f4f43_DOLLAf 3a3f5f5fPERCENT6464AMPERSAND1a17b7bPOSTROPHEc2a2d8d8dLEFT PARENTHESISj8a8 p9p9pORIGHq9a9 rararASTERISK0a0`b`b`OPLUS91a1bcbcbXCOMMA; in Arabic-script context, displayed as66C ARABIC THOUS SEPARATORdwdwHYPHEN-MINU4a4ehehFULL STOP'BDECIMALyayff_SOLID /a/^"30^%30^DIGIT ZERO; 0v-INDIC H#31n1n_ONE; n1n6ONEm2m2m TW2m6TWOm3f_THREE)3mHoo3oOFOUR4oHn30FIV5nIVE 0x0036: 0px0036, <# DIGIT SIX; in Arabic-script context, displayed as 0x0666 ARABIC-INDIC H Y0e 7:*<037m_EVEN;m7mHo8o8o_EIGHTo8oHo9o9o_NINE;K9oHnananCOLON, left-right-b-(-3-bZbZOSEMI^c1c1LESS-THAN SIG6b6dldloEQUALSi3b3fefefGREATER 9b9 rfrfrQUESTION MARK"405%405COMMERCIAL AT#41)1)LATIN CAPITAL LETTER A22222 B23232 C24242 D25252 E262F242G2h4h2H2+4+2I242J242K24&L2[4[dM2!4!2N242O2552P2 5  Q2 5  R2 5  S2 5  5 5  U 0x0056: 0px0056,  # LATIN CAPITAL LETTER V 0*27: 2 W28282 X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKET, left-right;d; 6-A;cvcvREVERSE SOLIDUSr7d7ndndn?IGH<d< xexexCIRCUMFLEX ACCENZ9d9 rfrfrLOW LINEQ0d0`"60`%60`SGRAVE#61(1(PESMALNA02020 B03030 C04040 D05050 E060 @ F0>/67` G0<6< `H0:6: 0I0868 0J0660 0K06L0v6v0M01610N06O077`P07 Q07 R07 S07 T07 U07 >77 <77 :77 Y 0x007a: 0px007a,  # LATIN SMALL LETTER Z 0(2b: 0EFT CURLY BRACKET, left-right:/fb: 5-@:ctc:VERTICAL LINEo5f5jdjdjORIGH;f; vevevVTILDEf!f!CONTROL CHARACTER-"a0-%81-NO-BREAK SPACE, a8/LEFT-POINTING DOUBLE ANGLE QUOTATION MARKQbQ%98KR'#c40RPCAPIT A WITH DIAERESIS#c7A2A CAvCEDILLA?9?3? E?FACUT#d1=4= N= #d6=5= O=d /86A UAeU| 'zFGRAVe7|; 5#e29;CIRCUMFLEXe2 6e0.#e8=, 2i; 2av9$ mv2={29b If 9!;$9$@f9" ?#f3t  f9 ;f9 @ 0x00f7: 0x00@9b, # DIVISION SIGN, right-left !0x00f9: %9d5LATIN SMALL LETTER U WITH GRAVE;a;c;GACUT;b;e;CIRCUMFLEX{c@f@DIAERESIS?#60?aARABIC COMMA(1bR(SEMICOLON,fb,PQUESTEMARK0"210%c10tFHAMZ#22/2/BALEFMADDA ABO3623?3?x ?4?4?2WAW}>5>5>?VBELOW*6?6??YEH}7>7>}l8.8.6BEH-</c9-TEH MARBUT6/ca5bc%(THc.FJEEM\d e- -7KHA. c 5DAL"30[/d0H.7d7R35d56ZAI3$d$7SEE.d)SH/d6SADdD-dT3dZ-d >d(GH/4efTATWEE 4eF4e5QAFg4eK-e&LA\4eM4e'NOi4eABIC LETTER HEH 0x0648:@0e8, # ARABIC LETTER WAW-9-9-ALEF MAKSURA6a6a6Yb-b-FATHATANXc+c+JDAMM+d+d+JKASR+e+e+~f(f(~("50(,f0({(1(1(VSHADDO#52)2)6UKU6yby-INDIC DIGIT ZERO, right-left (need override)6b O?ONENb N/TW3+b3 N?HRE4P4P OFOUR5O5O /IV6O6O ?SIX7N7N OEVENPQbQ _EIGHTPtbt P/NIya PERCENT SIGE7~f 'TT7<f.P-8fz(TC8Xf\EDDAL9ft'RR9\ J-af1V-&f-5GAFb8NOON GHUNNdJf5YEH BARREEidfBA,32029HORIZONTAL ELLIPSISg3274c TEARDROP-SPOKED PROPELLER ASTERISKPA} """ Python Character Mapping Codec mac_croatian generated from 'MAPPINGS/VENDO)RS/APPLE/CROATIAN.TXT' with gencodec.py. """#" import s ### C% APIs class($.): def W(self,input,errors='strict'):,0creturno.charmap_B=,ing_table)o deo)B ooIncrementalE>r  h final=False*Y.S 4[0]D"eN!@QStreamWriter(N,8cs.5pasORead9 9Js module getregentry(7 UInfo(name='mac-croatian',k!e=72().im:'r=/J //swr>=K #w##") ![Ping TK5cod2 = .`'\x00' # 0x00 -> CONTROL CHARACTER=,1,1, 2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, t* 9, n,A, 2x0b.B, c,C, r*D, 2x0e.E, f,F, 11 11 11 11TER '\x104' # 0x14 -> CONTROL CHARACTER !X'\x15,5, 6,6, 7,7, 8,8, 9,9, a,A, b,B, c,C, d,D, e,E, f,F, )1  20,RSPACE! 1 EXCLAMATION MARK+"+2+LQUOT)#)3)NUMBER SIGNO$&XDOLLA&%&wPERCENTM&'AMPERSANDq0"'" APOSTROPH(ILEFT PARENTHESISP+')+ORIGH,*,sASTERIS_+#GPLUS,$~2MMA- rHYPHEN-MINU.'mFULL STOPK/$eTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ3T3FOU%SK3FIVJ%Q%2SIX$Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YCOMMERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F1LATIN CAPITAL LETTER F 'G' # 0x47 -> LATIN CAPITAL1G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /g/ /h/ /i/ /j/ /k/ /l/ /m//n//o/p/7^q/TER Q 'r#' # 0x72 -> LATIN SMALL LETTER R '+'s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#JF CONTROL CHARACTEGG\xc4, 80,vPCAPITxA WITH DIAERESIXH\xc5@1@ RING ABOV(c7A CrCEDILLA9H\xc9> >E>EACUTz(d1< <N< c(d6<  <O< 7(dc@1 @U@eB (e0zM:6GRA(e2:X:CIRCUMFLE9\xejh? 1(e3}w> e X:e?e<(e8: a:9 tb??d> >I 9: et:-9? f9 >Bf3' # 0x97 -> LATIN SMALL LETTER O WITH ACUTE '\xf2' # 0x98 : FGRAV:4:9: CIRCUMFLEXy6?A? DIAERESIS>5>B> FTILDa:C:U+9:D: +b:E: +c?F? +Pu2020@ A0>dDAGGERLb !A1!EGREE SIGN&a) A2&JCENT$3iJ3$ZPOUND%7%4%xSECTION'r5'dBULLETbA A6!xPILCROWH8xdfo7'eSHARP _(ae5REGISTEREAu016?eCAPITA|SQDCAROSGu212TRADE MARKblA0 AC(a82NOT EQUAL TOKPu017dM Z)xd <TSTROKAu221}yBINFINITY0xb1gBPLUS-MINUS8Au226:MLESS-THAN OR1226Y0GREATER303INCREMENU[MICRO0BARTIAL DIFFEREN (xN-ARY SUMMAO*0**dPRODUCR E!22bINTEGRAL(xawB FEMININE ORDINAL INDICATO 5oMASCUL6 Au03a,K CMEGAw fB :!xbCVERTED QUES !xa1#IN1EXCLAMATION MARK '\xac'  # 0xC2 -> NOT SIGN#Pu221a%#3#SQUARE ROOT&F0192&4&LATIN SMALL LETTER F WITH HOOVu2248959ALMOST EQUAL TOc&06*6*ceCAPITAeCeSACUTE<0xab: 7<EFT-POINTING DOUBLE ANGLE QUOTATION ,Au010. 8DFCAROE'029<pHORIZONELLIPSIS0A.NO-BREAK SPACc)B)AFGRAV<3eC< ETILD<(d5<D<Ox<Gu015*E<IGATURE Op4{F4^212&D02 DUSTROKo@2014=1=sEM DASHFu201 D8DLEFTGAF201dWJORIGH6!DZk/SIF2019kVk6 0xf74&DbPDIVIS  &5cDNUOZENGB@f8ffLB,Apple logoE!xaoDCOPY'04AFRAC)SLwJEURO!03x$  7203DE!xc 5AV(xbD p6201LE(EN(xbEMIDDLE D'20E_LOW-9DE201eE6 3EPER MILLE!xcZSE CIRCUMFLEXEASb c1{vE.vX!xcvC: E WITH GRAVE '\xcd'  # 0xEA -> LATIN CAPITAL LETTER I WITH ACUTE<e<B< CIRCUMFLEXAfACA DIAERESIS@c@D@ EGRAV(d3<E<O(d4<F< Pu0111Cv&F0AESMALtD{VSTROK29 &F1;  a<2<Uy (db<3< 8xd9A4A Gu01305< 0OTLESS I Pu02c6ug67MODIFIERv ACCENT<d^<7<mETILDa F8&eMACRONG63c09!bGREEK M^P)xcgE Au02dRING ABO b8DxsCEDILLA!xcE"ZFAeyA_ AI7S CAH) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB8 mac_cyrillic generated from 'MAPPINGS/VENDORS/APPLE/CYRILLIC.TXT' with:P.py. x#" import suAPIs class ($. 1): TAdef e(self,input,errors='strict'):,creturnoB=,4ing(CoAo*B ooIncremental$er h final=False*Y.S 4[0]Dc(@Q StreamWriter(Codec,codecs.StreamWriter): pass class SReader(Codec,c(s. 9### encodings module API def getregentry(7sreturn XeQInfo(name='mac-cyrillic',k!e=72(). deXincremental:6r=IE/er/J /Dl/s>r>=1R#w##@) Q[ing TableKa _t2 = .`'\x00'4 # 0x00 -> CONTROL CHARACTER=,1,1, 2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, t* 9, n,A, 2x0b.B, c,C, r*D, 2x0e.E, f,F, 11 11 11 11 11 11 11 11 11 7x191 8x1a, 11 11 8x1d 11 11   D2RSPACEt! EXCLAMATION MARK+"+LQUOT)#)NUMBER SIGNO$& 0x24 -> DOLLAR SIGN '%'# 0x25 -> PERCENT'&'6'AMPERSANDK0"'"GK7$POSTROPHE%+'(I8%LEFT PARENTHESIS+)+9+ORIGH,*,A,ASTERISKO+#B#GPLUS,$C$RCOMMAD- D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$2$#TWH3$3$3HREJ4&4&BFOUR5%S3FIVJ6%Q%2SIXI7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1ER T 'U' # 0x55 -> LATIN CAPITAL LETTER U )0'V'161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET.$\\/#C.REVERSE SOLIDUS*]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE~`# 60#YGRAVEJa'1'#ESMAL!AVb/2/B/c/3/C/d/4/D/e/ f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/v/w/x/y/z/{/ZCURLY|-`VERTICB}(RV~.CTILD~3\x77CONTROL CHARACTEG`\u0410Q,8CYRILLIC41' # 0x81 -> C&YRILLIC CAPITAL LETTER BE '\u0412' # 0x82 -> C5V53535 (GH64646 D55555 I56565 Z7676 k8585 It9494 hSHORT :a:A: 'KAob5B5 'EL5c5C5 M5d5D5 N5e5E5 O4f4F4 P%205/905 &ERj&21515 S5U9U TU9U UiS9S 'EF5S9S HE2S9S (TSS9S C2T9T SV9V C8T9T HARD SIG2[9[ 8YER]9] LSOFTsd9d c9c Yd9d Y''20dAdEDAGGP!xbpAPkDEGREE9(AA GHE WITH UPTUR!xaLhNIPOUN!xa%?ySECTION6202A1cBULLET`!xbHyPILCROWH1040) BYELORUSSIAN-UKRAINIAN !xar#REGISTERED SIGN '`\xa9'  # 0xA9 -> COPYRIGHT SIGN p'\u2122+)A)TRADE MARK*7040*B* CYRILLIC CAPITAL LETTER DJE`70456C6OSMAL4F2260D4NOT EQUAL TO[&03'E'G6F6 4E221ej B04INFINITY0xb1!! H B1#PLUS-MINUSH@2264,*2*LESS-THAN ORF2265030GREATER3F0456343 BYELORUSSIAN-UKRAINIAN Iz5IYMICRO10496%nGHE WITH UPTURF04087@ Y0F85 ?  "=&074 YKGu0455 ? r30Y < hL56> i 4&0aK Nj6K 4CKg0C[3 $DZ0xacCgE &21CZSQUARE ROOTFu019CMiLATIN MFDHOOK97224=^ALMOS6220CBINCREMEN8xab&LEFT-POINTING DOUBLE ANGLE QUOTATION)xbD5EGu202;pHORIZONELLIPSISsa,NO-BREAK SPACAu040  7TSH757 $  50l # lK56 % k 4#Fu201D#sEN DASHU"DEM DASH '&\u201c' # 0xD2 -> LEFT DOUBLE QUOTATION MARK '5d535ORIGH68646kOSINGk 9555k6 0xf7466PDIVISGSIGNe*7(_LOW-97040686CYRILLIC CAPITAL LETTER SHORT Up7045:9:OSMAL8&0fA8 rGDZHEo7B7 o5F2116lC5xNUMERO :F0401&D&'IO5E5 34F3&YAf%30/E032/E12B[&32e8 V33363G&34444Dg5323I3E/3 \3e;E;4gE8 4IE08a 0 jKb3,'EL<E*'EM3:E7 E60434E5g34E4P44F4&ER45F5'ES35F5T5F5d43F3'EF3F3H/43F3(TS3F3C44F4S6F6ALL LETTER S0HCHA '\u044a' # 0xFA -> CYRILLIC SMALL LETTER HARD SIGN :b:B:GYERUoc5C5LSOFTod:D:Ele2E2Y720aF3BEURO) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB2 mac_farsi generated from 'MAPPINGS/VENDORS/APPLE/FARSI.TXT' with7P.py. r#" import soAPIs class ($. 1): UAdef e(self,input,errors='strict'):,&creturnoB=,4ing"Co;o*B ooIncremental$er h final=False*Y.S 4[0]D](@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(name='mac-%',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +P'\x00lI 00;CONTROL CHARACTER=,1,1, 2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, t*9 -> CONTROL CHARACTER '\n' # 0x0A -> CONTROL CHAR,2x0b.,B, c,C, r*D, 2x0e.E, f,F, '10,/10, 1,1, 2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, 9,9, a, 11 11 8x1d 11 11  2SPACE, left-right!,EXCLAMATION MARK7"7OQUOT5 #5NUMBER SIGNg$2_DOLLA2%2PERCENTe&3AMPERSAND3"'"&'2APOSTROPHd(aLEFT PARENTHESISh+')7ORIGH8 *8ASTERIS+/ OPLUS/,08MMA; in Arabic-script context, displayed ash66C ARABIC THOUvS SEPARATO-vXHYPHEN-MINU@.3_FULL STOP'B|DECIMAL/x_SOLIDj3DIGIT ZERO; IF0 EXTENDEDv-INDIC Q '1' L# 0x31 -> DIGIT ONE; in Arabic-script context, displayed as 0x06F1 EXTENDED ARABIC-INDICQ '2'u2u?TWOu2u 2TWOu3u3u_HREE;3u Qw4w4w_FOUR;a4w Qv5v5v IV5v 2IVEv6v6v?SIX6v 2SIXu7u7uOEVEN7u Qw8w8w_EIGHTw8w Qw9w9w!NI9w Qv:vAvCOLON, left-right,;,B,OSEMI0<0C0LESS-THAN SIGe=5D5oEQUALS2>2E2GREATERj ?8F8QUESTION MARK@4 404COMMERCIAL AT+A(}LATIN CAPITAL LETTER A1B191B1C11C1D11D1E1j1%F1%1FbG11G1H11H1I1U1I1J11J1K11K1L1L1M1bM1N' # 0x4E -> LATIN CAPITAL LETTER N 'O'# 0x4F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET, left-right:$\\; 5C:REVERSE SOLIDUS6]5 6D6?IGHq^;(CIRCUMFLEX ACCEN_8/~OW LINE`/6-SGRAVEba'#ESMALA/b/! /B/c/ /C/d/ /D/e/ /E/f/ /F/g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/ /L/m//M/n//o/p/7^q/r/s/ t/ u/ v/w/x/LATIN SMALL LETTER X 'y'# 0x79 -> LATIN SMALL /Y/z/A/Z/{/B/EFT CURLY BRACKET, left-right9|9C9VERTICAL LINE4}4D4ORIGHn~:E:RTILDEB\x7f#%F CONTROL CHARACTER,'c4, 80,QPCAPITA WITH DIAERESIS@(a0@1@NO-BREAK SPACE, *-55(c7525uCuuCEDILLA>9>3>E>EACUT(d1<4<N< W(d6<5<O< +(dc@6@U@e7@  e8: EGRAV0(e2ptCIRCUMFLE9\xe^? 1Pu06ba8dARABICNOON GHUNN ab2" 4LEFT-POINTING DOUBLE ANGLE QUOTATION MARKe ue<(e8: 29 t?9y 7xed9 }IAu202^9pHORIZONELLIPSISett,9? f9 >M(f3K+)xb8&f9Bfr?B`9DIVISION SIG N, right-left '\xfa'  # 0x9C -> LATIN SMALL LETTER U WITH ACUTE:9:D: FGRAV:b:E: CIRCUMFLEXyc?F? DIAERESIS> ;" A0>^SPACE!,1,EXCLAMATION MARK7"727OQUOT5 #535NUMBER SIG$242_DOLLA2Q\u066 A52ARABIC PERCENTl*&`6.MPERSAND1"'"HZ70POSTROPH_(a81LEFT PARENTH h+')797ORIGH8 *8A8ASTERIS+/B/APLUS#]0]J]RCOMMAV-W7HYPHEN-MINUSZ.30FULL STOP0/0!_SOLID^ f03BEXTENDED -INDIC DIGIT ZEROu (need override)W1W<W)ON#V2V[ /TW3V|V ?HRE4XX OFOUR[5WW /IV6WW ?SIX7VV 9EVE 8X=X E"^X /NI: W}ICOLO;1",zQ SEMI7+ ARABIC LETTER NOON '\u0647' # 0xE7 ->-7HEH,8,8,7WAW,9,9,ALEF MAKSURA5a5A5Yb,B,xFATHATAc*C*KDAMM*d*D*KKASR*e*E*~f'F'{'%50''F0'x'1'1'WSHADDG&52(2(7UKU7'F3'(Pn7.F4,(TT-&865-CV&d5.6.&AE&a4+Va{F6GAFX8FFDDAL-9$RR{i_FLEFT CURLY BRACKET, right-leftf|9VERTICAL LINE4}4ORIGHn9 J,d^,YEH BARREE ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB2 mac_greek generated from 'MAPPINGS/VENDORS/APPLE/GREEK.TXT' with7P.py. r#" import soAPIs class ($. 1): Adef e(self,input,errors='strict'):,*creturnoB=,4ing"Co;o*B ooIncremental$er h final=False*Y.S 4[0]D](@QStreamWriter(N,[5pasReader(Codec,codec6s.StreamReader): pass ### encodings module API def getregentry(7return codecs.CQInfo(TXname='mac-greek',h!e=42(). deUincremental:6r=IE/er/J /Dl/s!r!=.R#cwriter#W #") N[ing TableH^ _t2 = +`'\x00'1 # 0x00 -> CONTROL CHARACTER=,1,1, 2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, t* 9, n,A, 2x0b.B, c,C, r*D, 2x0e.E, f,F, 11 11 11 11 11 11 11 11 11 7x191 8x1a, 11 11 8x1d 11 11   D2RSPACEt! EXCLAMATION MARK+"+LQUOT)#)NUMBER SIGNO$&XDOLLA&%&PERCENT SIGN '&'  # 0x26 -> AMPERSAND 0"'"$7$POSTROPHE%0'('!%8%LEFT PARENTHESIS+)+9+ORIGH,*,A,ASTERISKO+#B#PLUS SIGN$,$C$RCOMMA - D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$2$#TWH3$3$3HREJ4&4&BFOUR5%5%#IVJ6%Q2SIXI7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1U 'V' # 0x56 -> LATIN CAPITAL LETTER V 'W'171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET.$\\/C.REVERSE SOLIDUS*]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE~`# 60#YGRAVEJa'1'ESMALAVb/2/B/c/3/C/d/4/D/e/5/f/ F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/Uv/w/x/y/z/{/ZCURLY|-`VERTICB}(RV~.CTILD~3\x77CONTROL CHARACTEGB\xc4O,8 A WITH DIAERESIXH\xb9@SUPERSCRIPT O&E\xb2*0x82 -> SUPERSCRIPT TWO '\xc9'  # 0x83 -> LATIN CAPITAL LETTER E WITH ACUTE<(b3<4<ESUPEf5HRE,(d6,5,hOhDIAERESISl(dc@6@U@Pu0385B7@GREEK DIALYTIKA TONOp e0. 80ESMALAnEGRAV(e2:9: CIRCUMFLEX(e4?A? '@B> (a8dC& J8xe7$D$CuCEDILLA UE<SeF: wa/90: wb?1? -a  92>POUND SIGNAu2129kTRADE MARK*8xeeY|I|Cf?l ? 8u20jcBULLET8xbd_K VULGAR FRACTION ONE HALF3Au203PNPER MILLEfw9=%ff9=? )xa>=BROKEN BARa<AEURO # before Mac OS 9.2.2, was SOFT HYPHE(xf'9c fa:'ff? '!AjUDAGGE#1039#AL TDGAMM4Au0395C5HDELT515S59THE5?5^5HLAMDj5T5$XI)703a'H2P2(xdAYeSHARP aA[ REGISTERED SIGN '\xa9 '  # 0xA9 -> COPYRIGHT SIGN p'\u03a3+)A)GREEK CAPITAL LETTER4'MA5a5B5IOTA WITH DIALYTIKC0xa7A" xCCpSECTIONk@2260)'D'NOT EQUAL TO!xb%NE' DEM)xbtF&MIDDLE DOTKUu0391r B0%I EALPHb3 B15PLUS-MINUSVu2264_2*LESS-THAN OR05030GREATER3!xa143*YEWF0392V5#4BETY/B64eEPSILOF0396k77Zkk84 39gBHKAPPci&MUga7PHI3be3Uld8FF(PSyG#3GOMEGaC3ESMALB1VTONOS%9dC<sNQxnCD &9fU7XOMICRayC;$RH{Fu224eCK]ALMOSCA&TA=LEFT-POINTING DOUBLE ANGLE QUOTACCMARK`)xbDMEFu202C_pHORIZON$tELLIPSI(xaCYNO-BREAK SPACETCM7 CRCR8R8L&15jC[cLATIN &IGATURE O62012DXtEN DASH 6201@D1 -> HORIZONT,AL BAR '\u201c' # 0xD2 -> LEFT DOUBLE QUOTATION MARK5d535ORIGH68646kOSINGk 9555k6 0xf7466PDIVISDSIGN7038^7(GREEK CAPITAL LETTER ETA WITH TONOS>ah<8>/IO?{9?OMICRONeAB_UPSILBaBBFSMAL@ C@&afD<=c=E=; }F@ OOMEGc9&E0@ 9y %b1/E1@VALPHAo&b23 s7BET2crE27PSIc4c18DELd&b533EBh&c655(PH31 GGAMMbE 3 .b E 1bE 2X1EnHKAPPbaHLAMD3EX'MUKN0;E; {e%c0F0P+c[F ^F+7RHO`F*8SIG`c,F,(TA8F*)THcF(&F*EEK SMALL LE*TTER FINAL SIGMA '\u03c7' # 0xF8 -> GREEK SMALL LE97CHI15191vUPSILON5&b65A58ZETa2B2IOTA WITH DIALYTIKAbACAD&90DDD AND TONOSKEK N0xadFN:SOFT HYPHEN # before Mac OS 9.2.2, was undefined ) ### Encoding table en_ =codecs.charmap_build(de$ ) """ Python Character MappWCB6 mac_iceland generated from 'MAPPINGS/VENDORS/APPLE/ICELAND.TXT' with9P.py. v#" import ssAPIs class ($. 1): Adef e(self,input,errors='strict'):,3creturnoB=,2ingJ)o?o*B ooIncremental$er  h final=False*Y.S 4[0]DaN!@QStreamWriter(N,[5pasORead9 9Js module API getregentry(7 UInfo(name='mac-%',j!e=62().il:'r=/J //svr==J #w##") [ Ta ~2 = -A'\x0h 00hCONTROL CHARACTER=,1/01, 2,2, 3,3, 4,4 -> CONTROL CHARACTER '\x05'  # 0x05 -> CONTROL,6,6, 7,7, 8,8, t* 9, n,A, 2x0b.B, c,C, r*D, 2x0e.E, f,F, '10,/10, 1,1, 2,2, 3,3, 4,4, 1 11 11 11 8x19 8x1a, 11 11 8x1d 11 11   D2RSPACE! EXCLAMATION MARK+"+LQUOT)#)NUMBER SIGNO$&XDOLLA&%&wPERCENTM&'AMPERSANDq1"'" APOSTROPH(ILEFT PARENTHESISP+')+ORIGH,*,sASTERIS_+#GPLUS,$~2MMA- rHYPHEN-MINU.'mFULL STOPK/$eTSOLIDFP3[DIGIT ZEROG%`%#ONt $Y$#TWH$T$3HREJ&T3FOU%SK3FIVJ # 0x36 -> DIGIT SIX '7'# 0x37 ->$BEVEN&8&8&REIGHT&9&9&BNINE%:%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK@( 40(COMMERCIAL A4A(1(LATIN CAPITAL LETTER AYB121B1C131C1D141D1E151F161FbG1&G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa'LSMALb/ /c/63 -> LATIN SMALL LETTER C 'd'# 0x64 -> LATIN /D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/3/S/t/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x77CONTROL CHARACTEGB\xc4O,8PCAPIT9A WITH DIAERESIXH\xc5@@RING ABOV(c7A ACrCEDILLAH\xc9> >E>EACUTz(d1< <N< c(d6<  <O< 7(dc@1 @U@eB (e0zM:6GRA(e2:X:CIRCUMFLE9\xejh? 1(e3}w>TILDE '\x@e5' !# 0x8C -> LATIN SMALL LETTER A WITH RING ABOVE 4X'\xe7?D?C?uCEDILLA<9<E<E<FACUTv8:F: 7GRAa:/90: CIRCUMFLEXb?1? DIAERESIS>d>2>Ic:3: e:4: f?5? (f1>6>NETILD(f3:7:O: (f2:8: +(f4:9: +(f6?A? +/9B> + U+9: + :+ ? +dGAeCAPITAY'b0ADEGREE SIGNaDAJCENT$AZPOUND%A~xSECTION'Au202rAfdBULLETb\AIxPILCROWH(xdA6eSHARP a"A1REGISTERE0A!COPYRIGH8u21 TRADE MARKbtA0 ACraA Au226ENOT EQUAL TOKcK >Ad} 2TSTROK=Au221`BINFINITYb&BPLUS-MINUS.0MLESS-THAN OR0W0GREATER-THAN OR EQUAL TO '\xa5'  # 0xB4 -> YEN SIGN#b#5#XMICRO%Pu2202JH6%PARTIAL DIFFEREN TVu2211/7/N-ARY SUMMATIO~Yf*8*tPRODUCTRF03c0(9(GREEK SMALL LETTER PI0F222b0A0INTEGRAL#0xaa! B# FEMININE ORDINAL INDICATOR5b5C5oMASCUL6 Pu03a9m?D6eCAPITATOMEGAk e63E5ZLATIN$AE0(f80F0O WITH STROK;bk C0;INVERTED QUEST MARKla111REXCLA 4c C24;NOTg1`( C3#SQUARE ROO &19CF4HOOAu224$_{ALMOST 8~*INCREMEN!xaaLEFT-POINTING DOUBLE ANGLE QUOT bDORIGHEGu202pHORIZON[ELLIPSISHNO-BREAK SPACq) g AiFGRAV<3'< ETILD<dC-<<Gu0154IGATURE Op48262012D/sEN DASHePu2014TD ,EM"">5/WdW /6D0 EFzkD,k/SI60xf74D8yDIVISIOuFu25cD<TOZENG(xfD Y|fDIAEREGu017>1@7204%AFRAC)SLa%*EU=(xdrD $ET@)xf3 1 '\xde' " # 0xDE -> LATIN CAPITAL LETTER THORN '\xfe' 5F5OSMAL3d3/E03Y WITH ACUTEm(b7:1:MIDDLE DOT%Pu201a' E2% SINGLE LOW-9 QUOTATION MARK6636ODOUB6&30l46PER MILLE SIG' c2' ' E5)\ACIRCUMFLEX!xcA6AEA17A x(cb<8<}DIAERESIS8@9@ EGRAVc.A<I 5B< vfCA c@D@ (d3<O(d4< < Auf8fFApple logodFf F<UF< 7xd9FA Au013J DOTLESS I,Pu02c6u7MODIFIERXe ACCEN102dH<mETILD)aFTMACROAu02dG5BREj  jyDOT ABO$$RIRING%!xbg6vCEDILLAdGn. UOGONE102c! CA) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB) mac_latin2 generated from 'MAPPINGS/VENDORS/MICSFT/MAC/z2.TXT' with=.py. Written by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All Rs Reserved. NO WARRANTY. (c) Copyr)ight 2000 Guido van Rossum. """#" import codecs ### C APIs class($.): def en(self,input,errors='strict'):,0creturno.charmap_B=,ing_table)o/deo-B ooIncrementalEr  h final=False*Y.S 4[0]D"e!@QStreamWriter(N,8cs.5pasORead9 9Js module getregentry(7 UInfo(name='mac-latin2',i!e=52().ik:'r=~/J //sur<=I #w##") [Ping TI5cod2 = ,`'\x00' # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k '\x16'  # 0x16 -> SYNCHRONOUS IDLE '\x17' +7+ END OF TRANSMISSION BLOCK48484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATORod)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" j 20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&4&XDOLLA&%&5&wPERCENTM&'|AMPERSANDq1"'"r uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIXQ3Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I' # 0x49 -> LATIN CAPITAL LETTER I 'J'# 0x4A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/o5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALmAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /j/ /k/E /l/t /m//n//o/p/7^q/r/s/"t/IN SMALL LETTER T 'u' # 0x75 -> LATIN SMALL LET/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#F UDELET!'c4! 80!PCAPITA WITH DIAERESIS`\u0100Ba/81@ gMACRON=1=2= [{ ;0xc99" x3; E5ACU<4<ycOGONEK8xd6y yOy 18xdc@  @U@e21 5|<: 2;H C&CA!xelUw /zdd~x:q< +7v< :)xe:7<: dZd %7a9 :&0e:Dv 9I: 09 tVu0112b 5=3= w;N9=DOT ABOVhfy,5 ,19x~9 O WITH CIRCUMFLEX '\xf6' # 0x9A -> LATIN SMALL LETTER O WITH DIAERESIS>5>B> UTILDE:a:C:UxDACUT:Au011<D:eCAPITAE<SCARONv<bx<E< :0xfc8 (F: (Pu2020@x A0>cDAGGER!xb_!A1!EGREE SIG8G2&dOGONEKc a3;c3=XPOUNDb8xa7%4%xSECTION'2)5'dBULLETmbW A6!xPILCROWH0xdfF7' eSHARP u(ae585REGISTERE9*9*COPYRIGHTGu212TRADE MARK*1011UB )!26 _NOT EQUAL TO_Au012'GgEDILLA<A< EI> y=B;B;x7MAC@2264xESS-THAN OR!12260GREATER36012B  1013n; KSC6220}B,ARTIAL DIFFEREN F2211 4N-ARY SUMMA*7014Y) LWSTROKe3 :; = 1013/O>y<daz 3Bbx :Bx:v 3* :4N *4vC<DILLA '\0u0143' # 0xC1 -> LATIN CAPITAL LETTER N WITH ACUTE '\xac:<2<NOT SIGN#Pu221a%_3#SQUARE ROOT&F0144&4&OSMAL 7:5:GCARO&06<6<INCREMEN0xab"7$LEFT-POINTING DOUBLE ANGLE QUOTATION MARK)xbD8DORIGHEGu2029EpHORIZONELLIPSISs(a0A.NO-BREAK SPAC@8+B)z >1015e:C: zO9(@ d5{]DC GTILD 51>E< 3}cAFA8MAC;&016 D0=sEN DASHFu201DX,EM"D>[RLWdDPL6D` EFk9k[k/SI6!xfDUPDIVIS &5cDYWOZENG47 7015}-; RAu015YD;< Y:fLv N7203mNgohGu203SODE7015X 6015DQ<dEDILLA01015:wERwC<6El< yS '20E5_LOW-9eE6 6016El [6015E Z6 -> LATIN SMALL LETTER S WITH ACUTE '\xc1' # 0xE7 -> LATIN CAPITA<A<Pu0164><8<T<SCARONx<5<9<ESMALv:0xcd8 A: IvAu017>B<Z< 7ez<C< :&6a:D: Uv6MAC)0xd3;E=O=!xd<F< CIRCUMFLEXb&F0A /&F1;RING ABOVd4/F2A }f3< {'0?4?iDOUBLEXCZ:5CA26AfOGONEK77~~ ;!xd!wYpf<:Vu0137 KtwCEDILLA9DOTiGu014 jL~TSTROKc {2G{ '2c5) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB2 mac_roman generated from 'MAPPINGS/VENDORS/APPLE/ROMAN.TXT' with7P.py. r#" import soAPIs class ($. 1): Adef e(self,input,errors='strict'):,creturno.B=,4ing"Co;o*B ooIncremental$erentalEncoder): def encode(self, input, final=False*.preturn /cs.charmap_@:F.errors,ing_table)[0] class IncrementalDeO r(>cs.d,'@StreamWriter(Codec,DpassORead9 92###ings module API getregentry(7 QInfo(name='mac-roman',!e=42().i:'r=EQr/J //str;=H #w##@) N[Ping TH5cod2 = +`'\x00'1 # 0x00 -> CONTROL CHARACTER=,1,1, 2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, t* 9, n,A, 2x0b.B, c,C, r*D, 2x0e.E, f,F, 11 11 11 11 11 11 11 11 11 7x191 8x1a, 11 11ONTROL CHARACTER '\x1d' # 0x1D -> CONTROL CHARA,e,E, f,F, )" 20,RSPACE! 1 EXCLAMATION MARK+"+2+LQUOT)#)3)NUMBER SIGNO$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq1"'" 7$POSTROPH(I8%LEFT PARENTHESISP+')+9+ORIGH,*,A,sASTERIS_+#B#GPLUS,$C$RCOMMA- rHYPHEN-MINU.'mFULL STOPK/$eTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ6%Q%2SIX7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM1bM1N10x4E -> LATI N CAPITAL LETTER N 'O'# 0x4F -> LATI1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/z 5C.REVERSE SOLIDU]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALxAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/N /L/m//M/n//o/p/7^q/r/s/"t/u/v/w/x/y/Y 'z'  # 0x7A -> LATIN SMALL LETTER Z '{'/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F CONTROL CHARACTERzG\xc4, 80,PCAPITA WITH DIAERESIS@5@1@ RING ABOV(c7A2ACuCEDILLA9>3>E>EACUTz(d1<4<N< c(d6<5<O< 7(dc@6@U@e7@  (e0z8: 6GRA(e2:9: CIRCUMFLEXejh 1(e3}w> e+e?e<(e8: a:9 tb??d> >I 9: et:-9? f9 >Bf9@ +f9: +f9:+f9?+9> f+ +9 LETTER U WITH GRAVE '\xfb' ! # 0x9E -> LATIN SMALL LETTER U WITH CIRCUMFLEX?c?F? DIAERESIS>Pu2020@} A0>cDAGGER!!xb !A1!EGREE SIGN& a2E&2&JCENT$3$3$ZPOUND%7%4%xSECTION'r5'dBULLET(b6H6!xPILCROWH8xdf'7'|dSHARP 48xae585REGISTERE9*9*COPYRIGHGu212A)TRADE MARK(b4SB*ACUTE ACr(a8'C'!26ED$NOT EQUAL TOKcKeCAPITAAd} 2OTSTROK=Au221`BINFINITY'b1BPLUS-MINUS.Au2260MLESS-THAN OR05\0GREATER3!xa1B)YE)xb#[MICRO0BARTIAL DIFFEREN 'N-ARY SUMMA1*0**dPRODUC3Fu03cBK&PIX2XINTEGRAL#0xaaM FEMININE ORDINAL INDICATOr 5oMASCUL6 Au03am tDMEGAeB {fB 0!xb CVERTED QUESa1#IN1REXCLA 4 C8`(CSQUARE ROO &19CFCHOOKAu224$_]ALMOSWAu220~*INCREMEN!xaaLEFT-POINTING DOUBLE ANGLE QUOT bDEppHORIZONVELLIPU!xaHA -> NO-BREAK SPACE '\xc0'  # 0xCB -> LATIN CAPITAL LETTER A WITH GRAV<3<C< ETILD<(d5<D<Ox<Pu0152>E<IGATURE Op44F4~SMALL L262012 D02sEN DASH<Uu2014!D1"M"c"2" LEFT DOUBLE QUOTATION MARKWd535ORIGH68646kOSINGk 9555k6 0xf74 4 D66PDIVISESIGN05ca*t D7(dLOZENG0xff J8"~|YDIAERESIS`70179> @7204A@AFRAC)SLa%YEURO '03K E-POINTING A 31DE@fb01VvT$FIH6fb0PD$FL26202dEcDAGGER((xb*E"MIDDLE DOT%GE%_LOW-9&eE&6 3E&PER MILLE!xcE CIRCUMFLEXxA%AEAbA> EACUTX cb<X <} Z!xcX@Z@ <VI <i< 5QEA @ d/<y u d<< 2uf8LF Apple logo '\xd2' (# 0xF1 -> LATIN CAPITAL LETTER O WITH GRAVE '\xda'  <2<U<FACUT<b<3< CIRCUMFLEX}9A4A Pu0131>5<ESMALDOTLESS IsVu02c6767MODIFIER'v ACCENT<&dc<7<mETILD af$ R8&gMACRONG8#9!5BREAu02d A yDOT ABO$$B$IRING%!xbgC%wCEDILLAdD"qDOUBLE uE.fOGONEKO&c7OF! CA) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB8 mac_romanian generated from 'MAPPINGS/VENDORS/APPLE/ROMANIAN.TXT' with:P.py. x#" import suAPIs class ($. 1): $Adef e(self,input,errors='strict'):,creturno.B=,4ing(CoAo*B ooIncremental$er h final=False*Y.S 4[0]Dc(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(name='mac-%',k!e=72().im:'r=/J //swr>=K #w##") ![T ~2 = .P'\x00>!00@ONTROL CHARACTER=, # 0x01 -> CONTROL CHARACTER '\x02' # 0x02 -> ,3,3, 4,4, 5,5, 6,6, 7,7, 8,8, t* 49, n,A, 2x0b.B, c,C, r*D, 2x0e.E, f,F, '10,/10, 1,1, 1 11 11 11 11 11 11 8x19` 8x1a, 11 11 8x1d 11 11   D2RSPACEH! EXCLAMATION MARK+"+LQUOT)#)NUMBER SIGNO$&XDOLLA&%&wPERCENTM&'AMPERSANDq1"'"0 APOSTROPH(ILEFT PARENTHESISP+')+ORIGH,*,sASTERIS_+#GPLUS,$~2MMA- rHYPHEN-MINU.'mFULL STOPK/$eTSOLIDFP3[DIGIT ZEROG%`%#ONt $2 -> DIGIT TWO '3'# 0x33 -> DIGIT THREE&4&4&BFOUR%5%5%#IVJ6%6%2SIXI7$7$BEVEN&8&8&REIGHT&9&9&3NIN:%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK @( 40(COMMERCIAL A4A(1(LATIN CAPITAL LETTER AYB121B1C1vbC1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151PQ1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/<5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`# # 0x60 -> GRAVE ACCENT 'a'# 0x61 -> LATIN SMALL LETTER A/b/2/B/c/3/C/d/4/D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/Q/r/R/s/S/t/u/U^v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x7i7CONTROL CHARACTEGB\xc4O,8PCAPIT WITH DIAERESIXH\xc5@@RING ABOV(c7A ACcCEDILL%H\xc9> >E>EACUTz(d1< <N< c(d6<  <O< 7dw1 @U@eBA> (e0M:H\xe2:XETTER A WITH CIRCUMFLEX '\xe4' # 0x8A -> LATIN SMALL LETTER A WITH DIAERESIS>3>B> UTILDE:5:C: RING ABOV?7?D?CuCEDILLA{9<E<E<FACUTv8:F: 7GRAa:/90: b?1? d>2>Ic:3: e:4: f?5? (f1>6>N f/97:O: (f2t8: +f/99: +(f6y+9> + U+9: + :+ ? +Pu2020k+AdDAGGERYb LADEGREE SIGN&a)AJCENT$AxZPOUND%AcxSECTION'rKdBULLETbAA.xPILCROWH(xdAeSHARP !aAREGISTEREACOPYRIGHGu212TRADE MARKbYA0 ACraA!26ENOT EQUAL TOKGu010lCAPITAP5BRE#Au021c <SR%COMMA BELOW # for Unicode 3.0 and later '\u221e' # 0xB0 -> INFINITY '\xb1' #1#PLUS-MINUS SIGN*Pu2264,M2*LESS-THAN OR EQUAL TO05030GREATER3!xa1438YEN)xb#5#XMICRO%Vu2202{6%PARTIAL DIFFEREN 17/N-ARY SUMMATIO&0fY8*tPRODUCTRF03c0(9(GREEK SMALL LETTER PI0F222b0A0INTEGRAL#0xaa!B# FEMININE ORDINAL INDICATOR5b5C5oMASCUL6 Pu03a9mD6eCAPITASOMEGAkVu01035E5ZLATINA WITH BREVE:'21oF:S:COMMA BELOW # for Unicode 3.0 and later\!xb6CVERTED QUEST MARK1a 1#IN1REXCLA 4c4;NOT1SC SQUARE ROO7&19CDF 4HOOPu2248_oALMOST&06*INCREMEN!xaLEFT-POINTING DOUBLE ANGLE QUOT% bD*ORIGHEGu202GpHORIZONELLIPSISsENO-BREAK SPACqx)Kg 5GRA!xc<R< ETILDxdCX<O<Gu015_IGATURE Op4Y262012D/sEN DASHeFu201D ,EM"vD>5/WdD /6D0 EFzkoD,k/SI60xf7D8yDIVISIOFu25cD<TOZENG(xfD YfDIAEREGu017>ETTER Y WITH DIA ERESIS '\u2044' # 0xDA -> FRACTION SLASH)&ac)B)EURO SIGN$&39$C$SINGLE LEFT-POINTING AQQUOTAiGMARKDaDDDORIGHE7021EEE4LATIN CAPITAL LETTER T WITH COMMA BELOW # for Unicode 3.0 and laterF021bF^OSMAL\,E2021\ E0\DOUBLE DAGGER0xb7& E1(@MIDD(#OT%7u20 E2%_OW-9  1e] E36L6 &30646PER MILLE%0xc2'5)AIRCUMFLEX!xcA6AEAbA7AUACUTE}<8<}9DIAp8xc89@ FGRAV|d<:I < Cvf}A >@ (d3|Odx < Auf8fFApple logodFf F<UF< !xdFA Au013J DOTLESS I,Pu02c67MODIFIERe ACCEN102dH<mETILD)aUMACRO102dG5BREj2u02 jyDOT ABO$$RR%!xbg6vCEDILLAdGn. UOGONE?102c!CARON ) ### Encoding table en_ =codecs.charmap_build(de$ ) """ Python Character MappWCB6 mac_turkish generated from 'MAPPINGS/VENDORS/APPLE/TURKISH.TXT' with9P.py. v#" import rs ### sAPIs class($.): def e(self,input,errors='strict'):,0creturnoB=,2ingJ)o?o*B ooIncrementalE$er  h final=False*Y.S 4[0]DaN!@QStreamWriter(N,[5pasORead9 9Js module API getregentry(7 UInfo(name='mac-%',j!e=62().il:'r=/J //svr==J #w##") [T ~2 = -`'\x00' # 0x00 -> CONTROL CHARACTER=,1,1, 2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, t* 9, n,A, 2x0b.B, c,C, r*D, 2x0e.E, f,F, 11L CHARACTER '\x11'  # 0x11 -> CONTROL CHARACTER ",2,2, 3,3, 4,4, 5,5, 6,6, 7,7, 8,8, 9,9, a,A, b,B, c,C, d,D, e,E, f,F, )"  20,RSPACE! EXCLAMATION MARK+"+LQUOT)#)NUMBER SIGNO$&XDOLLA&%&wPERCENTM&'AMPERSANDq0"'"z2APOSTROPH(ILEFT PARENTHESISP+')+ORIGH,*,sASTERIS_+#GPLUS,$~2MMA- rHYPHEN-MINU.'mFULL STOPK/$eTSOLIDF0"3[DIGIT ZEROG3`%#ONt $Y$#TWH$T$3HREJ&T3FOU{%SK3FIVJ%Q%2SIX$Q$3EVE&R&E-L&M&$NI):rFCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YCOMMERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1PITAL LETTER C 'D'# 0x44 -> LATIN CAPITAL LETTER D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T1T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'ESMALbA,b/ /B/c/ /d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/: /l/i /m//n/ /ER N 'o' # 0x6F -> LATIN SMALL LETTER O '0'p'//70/P/q/1/Q/r/2/R/s/3/S/t/4/T/u/5/U/v/6/V/w/7/W/x/8/X/y/9/Y/z/A/Z/{/B/EFT CURLY BRACKEG|-C-VERTICAL LINEU}(D(ORIGHV~.E.CTILDNB\x7f#CONTROL CHARACTEGG\xc4,8PCAPITA WITH DIAERESIXH\xc5@@RING ABOV(c7A ACrCEDILLA9H\xc9> >E>EACUTz(d1< <N< c(d6<  <O< 7(dc@1 @U@eB (e0zM:6GRA(e2:X:CIRCUMFLE9\xejh? 1(e3}w> e:e?e<(e8: a:9 tb??d> >I 9: et:CIRCUMFLEX '\xef'  # 0x95 -> LATIN SMALL LETTER I WITH DIAERESIS 3X'\xf1>6>N>UTILDE:3:7:O:FACUT:2:8: FGRAV:4:9: CIRCUMFLEX6?A? +5>B> +a:C:U+9:D: +b:E: +c?F? +Pu2020@ A0>dDAGGERb" !1!EGREE SIGN&a) A2&JCENT$ A3$ZPOUND%7o4%xSECTION'rKdBULLETbAA.xPILCROWH(xdAeSHARP (aeREGISTEREACOPYRIGHGu212TRADE MARKbYA0 ACr(a8!26ENOT EQUAL TOKcKeCAPITAAd} 2sTSTROK=Au221`BINFINITYb BPLUS-MINUS.Au2260MLESS-THAN OR0<0GREATER3!xa1B)YE)xb#[MICRO0BARTIAL DIFFEREN 'N-ARY SUMMA1*0**dPRODUC3Fu03cBK&PIX2XINTEGRAL#(xaOB FEMININE ORDINAL INDICATOr 5oMASCUL6 Au03am tDMEGAeB fB 0TROKE '\Pxbf' # 0xC0 -> INVERTED QUESTION MARK &X'\xa1111~EXCLAMA4c424NOT SIGNWPu221a%3#SQUARE ROOT&F0192&4&LATIN SMALL LETTER F WITH HOOVu2248959ALMOST EQUAL TOcF2206*6*INCREMEN0xab"" 7$LEFT-POINTING DOUBLE ANGLE QUOTbD8DORIGHEGu2029EHORIZONTAL ELLIPSIS8xa0A.NO-BREAK SPACE)c)B)g@CAPIZiAiFGRAV<3eC< ETILD<(d5<D<Ox<Gu015E<IGATURE Op4F4O262012D/sEN DASH<Pu2014TD ,EM"">5/WdW /6D0 EFzk9k,k/SI60xf74D8PDIVIS@ &5cD<TOZENG(xfD~YfDIAEREGu017> @ 1e%@G5BREAu011<8 :3t:6IvxDOT ABOz3@: zDOTLESS I70155mSwwCEDILLA>?< 6202EI5cDAGGERd(xbWEOMIDDLE D'20=ER_LOW-9ES6 ESPER MILLE!xcEGIECIRCUMFLEX(ARAEAbAkATIN CAPITAL LE TTER A WITH ACUTE '\xcb' # 0xE8 -> LATIN CAPITAL LE<E<DIAERESIS@8@9@ FGRAV|d<A<I| e<B< CIRCUMFLEXfACA c@D@ (d3<E<O(d4<F< Auf8f F0AApple logo'd2f F1% a<2<U/F3< 8xd9}4A Puf8a0>5<undefined1Vu02c6%6%MODIFIER,v ACCENT<d6a7<SMALL TILDa FgMACRONGvGt5BREX2u02 XyDOT ABO$$@IRING%!xbg$wCEDILLAGbDOUBLEf.fOGONEKO&c7] CA) ### Encoding table e_ =codecs.charmap_build(de3$) """ Python 'mbcs' C7 for Windows Cloned by Mark Hammond (mh $@skippinet.com.au) from ascii.py, which was writtenMc-Andre Lemburg (mal@l L). (c) Copyright CNRI, All R s Reserved. NO WARRANTY.  # Import them explicitly to cause an#Error # on non- systems S" iT0_u1e, ^1e #?IncrementalDvGer, C... R`RAPIs 2e =fsb def r(input, es='strict'):Jbreturn<0, True) class(.bs(self, final=False*^60=.O)[0]JBuffered"p!_b"_decode = mbcs_ decode class StreamWriter(8cs.): en = mbcs_ CLReadCCxCR ###]ings module API def getregentry(Gpreturn cs.CodecInfo(`name='%',==incremental26r=IE r/J /Dp/ssr0=l)R#w##) """ Python 'oem'  for Windows $ # Import them explicitly to cause an#Error # on non-G systems fromv" iT3oem  , ! #1 ES ... PbAPIs ! =e q(input, es='strict'0 /t, True)as(self, final=False*5/<.O)[0]GBuffered"o!_b"_&? ^~[XJB B BBwB N<)rbeCharacter MappingPalmOS 3.5.  ten by Sjoerd Mullender (s@acm.org); basediso8859_15.py.R?#"  Y  fe0 2.charmapx=,ing_tabl?qo)B,oC Mding_table)[0] class IncrementalDecoder(>cs.): def d, (self, input, final=False*.sreturn Ucharmap_@:F.errors,ing_table)[StreamWriter(Codec,UzDpass0Rea9 9 ### encodings module API getregentry(7 eQInfo(1name='palmos',e!e=12().i:'r=E/er/J //sqr8=E #w##@) K[Ping TE[2 = (`'\x00'. # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"' # 0x2 2 -> QUOTATION MARK '#'p# 0x23)NUMBER SIGN&$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq0"'"7$POSTROPHE%+'(I8%LEFT PARENTHESIS+)+9+ORIGH,*,A,sASTERIS6+#B#GPLUS,$C$RCOMMA- D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$YI#TWH3$T$3HREJ4&TBFOUR5%SK3FIVJ6%Q%2SIXI7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUES@@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM1bM1N11O11P151Q1QR1;S' # 0x53 -> LATIN CAPITAL LETTER S 'T'# 0x541T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/C.REVERSE SOLIDU]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE`# 60#YGRAVEJa'1'ESMALAVb/2/B/c/ ^C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/[ /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/v/w/x/y/z/{/ZCURLY|-`VERTICsB}(RV~.CTILD~3\x77F -> DELETE  '\u20ac' # 0x80 -> EURO SIGN '\x81"$1$$Pu201a&H2$ SINGLE LOW-9 QUOTATION MARK6F0192636LATIN SMALL LETTER F WITH HOO9F201e949ODOUBo F2026656HORIZONTAL ELLIPSISF2020.6.gDAGGER!7! (702cw8(MODIFIERCIRCUMFLEX ACCENTd39<PER MILLEGu016)A)K@CAPIMSMDCAROVu2039B<EFT-POINTING A5CD IGATURE OE'66D4BLACK DIAMOND SUI 6663E-LCLUB*5*F*\HEART+69ZSPADE+5018V9SLEFT *6201Z9ORIGH69kkdk6 29VBULLEw&01w9uEN DASH6014y)EM"702dSFTILD1 TR2 y9V0x9b9 7015^ !x9yV V!x9$ $Gu017c DYfDIAERE!xadANO-BREAK SPACk!xa?)INVERTED EXCLAM!xa(4!xa9$0POUOa.%CURRENCYM(:YEN#?#BROKEN BA7xa7A1SECa{La$BCOPYh M ) FEMININE ORDINAL INDICATOAbxy NOo'\xad' # 0xAD -> SOFT HYPHEN '\xae' ! #&E&REGISTERED SIG*f*F*UMACRO!'b0! B0!iDEGREEG(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWO(b3*3*EHREE,4,4,ACUTE ACCENT'5'5'ZMICRO6%6%zPILCROW'7'7'MIDDLE DOq8%8%uCEDILLA9"9"&ONa*A* MASCULINE ORDINAL INDICATOR`b6B6RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKEcECEVULGAR FRAC/ ON=FARTE{d66EHALFie3 3T1 QUkS9BINVERTED QUEScCLATIN CAPITAL LETTER A WITH GRAVcC< cC< CIRCUMFLEXACA FTILD'C'< DIAERESIfc@C@@ R_7ABO:\C\AgCg2C ^cC>E> C< C< CA C@IC< C< CA dDETH (Icelandic)^dDN8 ^dDO< mdDER O WITH ACUTE '\xd4' # # 0xD4 -> LATIN CAPITAL LETTER O WITH CIRCUMFLEXA5A5A FTILD}6<6< DIAERESIS|7@7@MULTIPLICATION SIGN.8.8. VSTROK9=9=U(FGRAV<a<A< (ACb<B< cACA dd@D@Y e<E<THORN (Icelandic)fAFAESMALSHARP S (German>'e0>/E0>A (e1:1: (e2:2: (e3?3? LeE + eE>RING ABOeE ?eE 0CtCEDILLAeE <E< E: E:E?E >IE: E:E fF?ETH3fFN. BfF  YfF: hfF:hfF?H TILDE p'\xf6'  # 0xF6 -> LATIN SMALL LETTER O WITH DIAERESIS 3>7>7>DIVISION SIGN(8(8(feSTROKE;9;9;UFGRAV:a:A: FACUT:b:B: CIRCUMFLEXc?C? Td>D>Y e:E:THORN (Icelandic)f?F?y) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB generated from 'PTCP154.txt' with"m.py. Written by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY.62000 Guido van Rossum. #" import s>APIs class ($. 1): Adef _e(self,input,errors='strict'):,creturnoB=,4ingCoo*B ooIncrementalU$er h final=False*Y.S 4[0]D(@Q`Stream1er(N,[5pasORead9 9ings module API getregentry(7 QInfo(name='ptcp154',f!e=22().ih:'r={/J //srr9=F #cwriter##") [TZ ~2 = )W'\x00 00ANULL01' # 0x01 -> START OF HEADING '\x02' # 0x02 -+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&7 -> BELL88tACKSPACCt" 9$HORIZONTAL TABULATn0A0LINE FEEDxb&[B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG'10# 10#DATA LINK ESCAPB8x11+1+EVICE CONTROL ON-v1vD-4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE(19fUeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDFP3[DIGIT ZER%`%$Y$$T$&T # 0x35 -> DIGIT FIVE '6'v# 0x36%2SIX$7$7$BEVEN&8&8&REIGHT&9&9&3NIN:%A%CCOLOk; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK @( 40(COMMERCIAL A4A(1(LATIN CAPITAL LETTER AYB121B1C131C1D141D1E151F1FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa'LSMALb/ATIN SMALL LETTER B 'c' # 0x63 -> LATIN SMALL L/C/d/4/D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/j/A/J/k/B/K/l/C/L/m/D/M/n/E/N/o/F/O/p//70/P/q/1/Q/r/2/R/s/S/t/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x7 7DELETE (DEL)`\u0496L'8CYRILLIC CAPIT7ZHE WITH DESCENDEE2EEGETSTROKAu04e`BUSMACRO3 @ 7201 DOUBLE LOW-9 QUOTATION MARW\u202=!pHORIZON7sELLIPSI~b.  kC&ka6EASTRA@D="HAgZYDSf&a0e; BASHKIR KAe 0x8B -> CYR2ILLIC CAPITAL LETTER I WITH MACRON '\u04a2' # 0x8C -> CYRI@"ENADESCENDERD&9aDDD /KADbDED FSHHA{&b8{F7 2CHE|VERTICAL STROKEK%97K)90KESMALHZI 6201 91C LEFT SINGLE QUOTATION MARKxF2019x25ORIGH6c636kODOUBk d545k6 2# 956gBULLET3W6!wEN DASH"4"7"M"704bD8" ~"HA }704b9BCF04a1ACBASHKIR KeB;>   b  B B  B   5u~0xa0A~NO-BREAK SPAC 0e+Ad) SHORT U (Byelorussian)7045IxI G 0AG Je55BARRED O9;;Z+oDDASTRAUw 4!xar1SEC7SIGe0XA $I!xaY\2OPY ^d  ^DSCHW!xaaC-POINTING A!xaD NO&efb !xaapREGISTE049c' # 02xAF -> CYRILLIC CAPITAL LETTER KA WITH VERTICAL STROKE '\xb0' # 0xB0JDEGREE SIGN&u04b1' &1&pESMALnSTRAIGHT Uv mVu0406G2G BYELORUSSIAN-UKRAINIAN I5K3K I&994I"ZEDESCENDEReB5BBARRED O9!xbV69xPILCROW}0xb7'7'MIDDLE DOTLGu0458%IAu21193hNUMERO~Gu04dA&YSSCHWA8xbbB6R-POINTING DOUBLE ANGLE QUOTATION MARKE8GCE{JVu04aa3D3 b/ESawED [B&9d  B Au041C z4 C 4B7%12C V535  j(GH646 p 6D555 c 5I5C_>Zptn6kC~ 1YCiXSHORT1C nKCo'ELcx  j'EM5C b&1ej u jF041f4 g 4P2TDT 2UDU &ES2UDU TUDUTTER U '&\u0424' # 0xD4 -> CYRILLIC CAPITAL LETTER EF '55555 'HA56565 7TSE67676 (CH68686 S9696 C8a8A8 HARD SIGNb<B< GYERU7c7C7 LSOFTsd<D< Qe4E4 Yf5F5 '%305)E05ESMAL21212B&32323V33333G3]E] Dg[E[ 3I3YEY 3ZWEW 4gTET 3I3PEP 2hSHORT 8PEP 8KGEG 3'ELCEC 3M3:E: 339E9 3Oe6E6 2P44F4&ERf45F5'ES35F5T5F5443F343F343F3 43F3 44F4 46F6 44F4HARD SIGN & '\u044b' # 0xFB -> CYRILLIC SMALL LETTER YERU 5c5C5SOFT SIGN:d:D:E2e2E2Yf3F3 A ) ### Encoding table e_ =codecs.charmap_build(de3$p) """ C) for the Puni; O), as specified in RFC 3492 Written by Martin v. Löwis.\ import R!cs#  def segregate(str):z"""3.1 Basicse point,aion"""+base = bytearray()extended = setc2striSif ord(c) < 128_.append(&`Jelse.v0.adQ dorted(&JPreturz@tes(o4), ""lective_len&V, max+RBlength of str, consider\Ponly Eacters belowI.Kqres = 0+:max?A+= 1@ 262Rp digitab"abcdefghijklmnopqrstuvwxyz0123456789"generate_ lized_integer(N"""3.3 G2) variable-length 9As"""G = bytearray()jrwhile 1[7t =s.if N < t)a.append(2[N]e!M"s(2! Bt + ((N - t) % (36 )YDN = "%//#bj += 1Baadapt(, first, numvU"if/r //= 70Oelse 2u02+= %//cA# ((-1) *) // 2 == 455)divisionJxW>( tB35 #hSW+U7 = H*5b + 38)Bias ^$tesBlen,Hcq4 Bias Tationqinitial = 72, damp 00, skew8L7for points in enum; 26@.exts>;2==0Blen+"+19w6yteDBp 0_enS(text*p", ed = segregate&XPinserq_unsort$?M 1len)X!if+ b"-" +"n? # Decoding  d4 ptnumber(n2post, error$ &ry06e = ordw[extposexcept IE D#ifp"strict"#kraise UniPG("incomplete pu string")   return extpos + 1, None 5= 1if 0x41 <= char0x5A: # A-Z'?cdigit (-7 !elI 30AI539:#C22 # 0x30-26(Kerrors == "strict"Iraise UnicodeE-("Invalid`ended  point '%s'"c%;[+E-1])5Kelsep l)T(j, biasEresult += N5* wa#if?< ti E8w = w * (36 - tmjh 1 def insertion_sort(base,", q)x"""3.2 I30 un5QRing""Ja= 0x80u2= -\Q = 72O2 = *Pwhile}3< len(extnewpos, delta = de_generalized_number=4uD@!isL V# There was anD2 ining. We can't continue becausL# synchroniza is lost.'BN+{+0+= @// (c8)""if> 0x10FFFF"ifn acter U+%x" %r@$ = ord('?'%0 = [:pos] + chr(TUpos:]4 = adapt(^ , DoQ= 0),:)NfApunyU(textV\if isinstance!7str50 = 0.enO("ascii"BmemoryviewIQbytesj@_rfind(b"-[ 3 = a = str\$, r.upper(m 7J4:*]h[pos+1:]6)p ### Codec APIs class(z1cs.1): Kself, inpu"=''eres = =7"2res|sO serrors='strisct'): if errors not in ('strict', 'replace hignore:Araise UnicodeEH("Unsupported[ handling "+l)res = punyB0_der(input,>s-turn res, len') class IncrementalEnG r(>cs.Qdef e,s(self, yfinal=False*e:4D\0if &.JSq ,StreamWriter(Codec,DpassORead9 92###ings module API ogetregentry(7rUInfo(dname='%',=32().i:.r=/J /Y/ssws=G #r]#P#Q) """ for quoted-printablee. This AB de/s from bytes to .T@ im'2sqquopri 63io $B@"IO#_a-=cassertJD == Cf = ZGgrb(f, g, tabs=True(E(g.getvalue())zSr^Q bO'D HTZZ"<d . D)[0]zU~ retur4n quopri_decode(input, self.errors)[0] class StreamWriter(Codec, c(s.): charbuffertype = bytesLOReadLL # encodings module API def getregentry(GdreturnQInfo(bname='%',e"e=_<incremental96r=IE/er/J /D/sw=R#rj#\#_is_texting=False!) """ Python 'raw-uni.-escape' I0 ten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s importR ###f(1cs. 1): # Note: Bin? these as C functions will result in$ 3notFconvertingm to methods. This ntended.4# =S.raw_R_Re.. #Y].(#, Rfinal *$ EL B4.ed"_Z !, 4I G_d_v5pasz99='strict'.()?K</Vq!e=.  U) #!/usr/bin/env p?JCharacter Mapp@ for ROT13. A_B de/"s from strlOstr.ym). """ import codecs ### C APIs class($.): def en(self, input, errors='strict'.2return (str.translate(7rot13_map), len5)) l/delOIncrementalEr final=False*  uDe01StreamWriter(,8cs.5pasJORead9 9dings module getregentry(7cQInfo(F{name='rot-13',e!e=12().Li1:'r=D/J //sqwq=E~ #r[#N#_is_text_2ing!)UMap # =.make_identity_dict(range(256))2@.upd{X0x0041: eh 2f3&50415263748596a7b8c9dae4f#50505050450450450450450%4b50&4c0%4d66666767067067067067067067067067067066676707070670670670677: 0x006a, 0x0078: 0x006b, #79cad, }) ### Filter API def rot13(infile, out ):V.write(codecs.en 2.read(), 'rot-13')) if __name__ == '__main__'Vimport sysesys.stdin, out) # # shift_jis.py: Python Uni C for SHIFT_JIS5"Written by Hye-Shik Chang # _Vrcs_jp, multibyte as mbc &= :A.get%('') classMnY" =xh#dsPIncrementalEtr(mbc.M   .s.4 D 4 StreamReader(T,!.^R^ ! ^^getregentry(&breturn!s.QInfo( [=[NC=4#()C9iJI.r= /J //s08er={ #n#@# __2004,(): return codecs.CsInfo( name='shift_jis_2004', en;=92().)deincremental:6r=IE\r/J /Dl/streamreader=S R R#Ewrit#W #e) # # x0213.py: Python Uni for SHIFT_JISX,?Q&ten by Hye-Shik Chang # import _[ccs_jp,multibytc as mbc 1' =:A.get(') class(%!):" =}}Pd(mbc.M lp 4  4 m(,!.^W/er^! ^^def getregentry(&Oretu#`SH#4"""Character Mapping^ tis_620 generated from 'pG"-m-s/TIS-620.TXT' with2.py. """#"!cs ###hDAPIsw "f  (self,input,errors='strict' charmap_B=,ing_table) o#o)B oo.e h final=False*Y.S 4[0]V(decode(input,se)lf.errors,decoding_table)[0] class StreamWriter(Codec,c(s.): pass9ORead9 9b### ens module API def getregentry(7sreturn QInfo(name='tis-620',f!e=22().incremental:6r=IE/er/J /D{/srr9=e,R#w##@) L[Ping TF\2 = )`'\x00'/ # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE'191UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) { 2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&PERCENT SIGN '&'  # 0x26 -> AMPERSAND 0"'"$7$POSTROPHE%0'('!%8%LEFT PARENTHESIS+)+9+ORIGH,*,A,ASTERISKO+#B#PLUS SIGN$,$C$RCOMMA - D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%#ONt2$2$#TWH3$3$3HREJ4&4&BFOUR5%5%#IVJ6%Q2SIXI7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1U 'V'  # 0x56 -> LATIN CAPITAL LETTER V 'W'171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET.$\\/C.REVERSE SOLIDUS*])MD*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE~`# 60#YGRAVEJa'1'ESMALAVb/2/B/c/3/C/d/4/D/e/5/f/ F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/Uv/w/x/y/z/{/ZCURLY|-`VERTICB}(RV~.CTILD~3\x787UDELET!"80D!8H\x81$$2$$3$ '\x84' # 0x84 -> $5$5$6$6$7$7$8$8$9$9$a$A$b$B$c$C$d$D$e$E$f$F$'90$/90$1$1$2$2$3$3$@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@9@cufffe'Au0e0+A)THAI CHARACTER KO KAI0705 0YHO KH2E2C27UATeT3R3Wfc3a3'ONeq2o2wRAKHANG55 5wNGO NGU11 10CHOn22I33 3 3WSO SO/ /'OE22 2JYO Y1 1D)'DAc2 2TO PATAK21=2B; 2gHO THA1 B THO NANGMONTH11(B(8hPHUTHA5+B+XNO NE(B(XDO DE5' # 0xB5 -!> THAI CHARACTER TO TAO '\u0e16' # 0xB6 -0HO THUNG37373GAHAN48484Og9393WNO NUba/A/BO BAIMAI3b3B3gPO PLA0c0C0KHO P,d3D3HFO Fbe/E/Pb Yf2F2a%200/C00bXSAMPH%&21515GMO M&22/2/fYO YAKX&23030XRO RU`4040&25,5,XLO LIw2CL] C hWO WAE~CXSO SAs2CSS2Cb LCgHO HIPCiLO CHUC9O ACHO NOKHU@CPAIYANNO'3DWSARA s3DAI HAN-AKAT-3 D fg D 1Mb D 1D01D1'UED12Dv3D01DePHINTH1Tfffe' 60e3DURRENCY SYMBOL BAH 4E*4E\AE '\u0e4"2' # 0xE2 -> THAI CHARACTER SARA O '\u0e43030AI MAIMUAN94949 GALAI:5:5:LAKKHANGYA6565MAIYAMOKg7272gTAIKHU38383( Ec9090(THa1A1R,b1B1CHATTAWAc6C6THANTHAKHAT5d5D5xNIKHAHI2e2E2iYAMAKK5f2F2XFONGM1%501%F01DIGIT ZER[&51*1*6ONE5"F"S(TWRF)8HRET F +GFOUR~F*(IVTF*7SIXSF)7EVE5F+GEIGH5F+)NIQF0ANG j5FUKHOMUTfffe' ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python 'undefined' C< QThis L% will always raise a ValueError exception when beingC0used. It is intended for use by the site.py file to switch off automatic strPo Uni coercion. Writt| y Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All Rs ReservNO WARRANTY. 8r imports8 APIs classJ(1cs."):YAdef e(self,input,eK0s='Qct'):Brr%("JVing")^^>Incremental$er  final=False*ror("undefined encoding") class IncrementalDecoder(>cs.): def d, (self, input, final=False*.raise UniWError("undefinStreamWriter(Codec,:8cs.aDpass0Rea9 95###s module API getregentry(7sreturn eQInfo(ename='%',{!e=42().Qi:'r=E/er/J //stwt=H #r^#Q#) """ Python 'u-escape' 0 Uten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s import 5 1): # Note: Bin2 these as C functions will result in$ W3notFconvertingm to methods. This ntended.4# =.N_N_** 0o (+8 .e _s)[0]Buffered"!_b&_ m4  I C/G<t='strict'++?ing;:m .:_tf-16YANTY. """ i mport codecs, sys ### C APIs en# =&.utf_16_ def de#(input, errors='strict'): returnE9 , True) class IncrementalE r(m>cs.k__init__(selfM.C)9Y.r = None }final=FalseG9if J!isK5!oresultxG}A)[0]=f ys.byteorder == 'little'k.Jn u$le+OelseIbI(4Qreseto/Cp getstatec!#  info weto the caller+ # 0: stream is in natural for this platform# 2: endianness hasn't been determined yet3(we're never writingu)unwr0(2 D5elf 6 0)s,H8kb .DD"Buffered"( WU!_b_ #, !, +4r  A(out1consumed, U) = \Sx 0 A&if_*-1a #lep W,elYXbX^ >= 2raise UniE("UTF-16Rdoes notrt with BOM")   return (output, consumed) 3 "self.decoder(in-errors, final) 8def reset(#!):Q?cs.BufferedIncrementalD[.76E|v = Nonehgetstatek# additional " info from the base class must beZe here,|# as it isn't passed along toHecaller1k/=  5[0]D!we z^"# 0: stream is in natural order for this platformq1:)un<*2: endianness hasbeen determined yet39if !isig(?6, 21add = int((sys.byte== "big") !=rQA$isutf_16_be_)u sx,b#[1] will^ignored by XK5i?&[1h<Z == 0I33= ( 3do _6 elcodecs.ol: el^1NM _2_p SdWriterut__init__ ", ='strict'1O.E ! enBr+9cs.m)Z r6r[uresult u4d9^ #'little'c. m2le_p3(I bIresult else: $return self.encoder(input, errors) class StreamRea#)8cs.1): Zdef reset(U)o4.)=6try52del deD)except AttributeE ;Fpass@), ='strict'(object, consumed, byteorder) = \cs.utf_16_ex_m g, 0, False)=&ifWj == -1F.M: = g#legN,elPObO:>=2raise Uni~("UTF-16 s. does not start with BOM" mq) ### ings module API dgetregentry(Lcs.CodecInfo(name='utf-16',e"e=u=incremental26r=IEE/J /Dr/9rg=` #cwriter#W #) """ Python Q-be' 0 -ten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s import2s B 2be_9    <e, True(Dk Obfinal=-B$v4[0]y.Buffered"!_b"%fZkp $ereWO O3 ;O6[ B;h  ) """ Pytho+n 'utf-16-le' Codec Written by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All Rs Reserved. NO WARRANTY. """ import c|bs ### APIs en# =!.utf_16_le_ def de&(input, errors='strict'): returnH< , True) class IncrementalE r(p>cs.ns(self, final=False* B<I.O)[0]DBuffered"|!_b"_fk`Stream eeWO OLReadOOO6[ings moduleAgetregentry(S QInfo(*Wname=,h"e==i;2'r=N/J //srA=: #cwriter##)SPytho $32  O, sy/320#32 3__init__X 5 .C)*1 = None 9if J!isKjresult$?GA9f ys.byteorder == 'little'k2J#'32+OelseIbEP4QresetI./C.p getstatec!#  info weto the caller+R# 0:  is in natural for this platform# 2: endianness hasn't been determined yet # (we're never writing in unnatural order)3return (2 if self.encoder is None else 0) 3 de&ptstate(/!, !):H,[=Z2b .Dqys.byte == 'little'*\cs.utf_32_le_o3s IbI class IncrementalDe, r(cs.Buffered"(G__init__Gerrors='strict')U.Kd |b_ rinput, w, final+4+ A(outFconsumed, Q) = \$ex 0 A&if_/*-1e  p#lep W,elYXbX^ >= 4raise UniE  ("UTF-32 stream does notrt with BOM" &" (v  Qreset4 .7mhQ 'gesk# additionalte info from the base qmust be{e here,|# as it isn't passed along toHecaller1? =  5[0]D!we zD# 0: is  for this platformq1: *2: endianness hasbeen deter{g(?6, 21add = int((s"big") !=.A$isN)u #t[1] will^ignored by $.sKsetstate(self, sstate) s1 = 5[1]"ife == 0:7self.decoder = ( cs.utf_32_be_ 48_ys.byteorH= "big"6 Zelse olo el^?= 1N _2,/se None class StreamWriter)Jdef __init__(1, s:, errors='strict'1(0.ennw8cs.k.a !) QQresetmQ)=yZ[, input 6Pr is 2lresult =u4(d9^ #'little'c. Q2le_p/ IbIrreturn c_(  LRead/):4.:tryAdel except AttributeE ;Fpass@K(object, consumed, U) = \W #ex/ M, 0, Fals&ifW- &POO:>=4^raise Uni~("UTF-32 does notvrt with BOM"W mq) ### $ings module API getregentry(tLcs.CodecInfo(name='utf-32',e"e=/=incremental26r=IE\/J /Dq/rg=, #writer=StreamWriter, ) """ Python 'utf-32-be' Codecimport cbs ### APIs en# =!.utf_32_be_ def de& (input, errors='strict'):nreturnH< , True) class IncrementalE r(p>cs.ns(self, final=False*(B<I.O)[0]DBuffered"|!_b"_fkqStreamWWO OUReadeOOO6[ings moduleAgetregentry(S qQInfo(*Wname=h"e==i;2'r=N/J //srA=: #w##l0l4#le r^ S O OO C2le' D7@ ten by Brian Quinlan (b@sweetapp.com).p%7l'strict'): return codecs.utf_7_de(input, errors, True) class IncrementalEn. r(>cs.): def e,s(self, `final=False*.>8E.O)[0]DBuffered"x!_b"/ =gStreamWriteaS K KLReadKK KR ###^ings module API xgetregentry(O aCQInfo(name='utf-7',==i'2'r=~:/J //sr9=}2 #w##) """ Python 18' 0 )ten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s importr2s > "8_1 ='strict'8 8o[  _93K Km@8D-sig-This work similar to UTF-8 with the following changes: * On{/k a; ed BOM will be prepended.c as_ first three bytes.a@ing/a if31_ are ~,/se bytes will be skipped. """ import codecs ### C APIs def en(input, errors='strict'): return (*cs.BOM_UTF8 +Z.utf_8_KQ)[0],EI2lenn")) deXprefix = 0L1if t[:3] ==m&# =.13:]?R3A(outconsumed) Wq, True)B% I+j) class IncrementalE|rX__init__(self'M>cs.M.C9Y.first = 1 z,I, final=FalseB0if &E9A + \#',|w>Jelse sLMQresett/C igetstate^7s3!, ?3" =DBuffered"YK 7U%!_b_6if J < 31>.startswithl2$# not enough data to decide if this really is a BOM-D# => try again on the next call4=f("", 0OR 51P-2D[3:]4. 3;Rm ij6 _H"7Kmt = 1 def getstate(self):  = codecs.BufferedIncrementalDe*r.BA!# C+[1] must be 0 here, as it isn't passed along to the callerJreturn (P@0], .first) 'Xdef s,~@willignored by X)k  5@" = [1] class StreamWriter(j\reset3.)6try2delZ enD)except AttributeError;@, input, e5s='strict'w 3pbutf_8_ (Y)>LRead>y>3>d>@>bif len Z) < 3%ifOM_UTF8.startswith6 2# not enough datadecide if this is a BOM9# => try again onAnext 0f("", 0dBelif=f[:3] = F; F xA(outconsumed)5"R[3:], N&+3(# (else) no/ p%ntn2cs."eq) ### 'ings module API getregentry( \CUInfo(name='utf-8-sig',h"e==iA2'r=TEzr/J //s<r=5 #w_#l#) """Python 'uu_n!'  - UU content transferi@. T3B de/s from bytesH 0. v0ten~ Marc-Andre Lemburg (mal@l .com). Some details were adaptedauu.py which was ` Lance Ellinghouse and mo,dified by Jack Jansen and Fredrik Lundh. """ import codecsbinascii from io &BytesIO ### C3 APIs def uu_enH4(input, errors='strict', filename='', mode=0o666): assert<D == ? inD3 = k);outrread = ;./write = 7. # Remove newline chars c) % =.replace('\n','\\n', r,4r')EKf(('begin %o %s\n' % (> & 0o777_3)).'"')chunk = 2(45@whil2unkr.b2a_uu(@L& PW(b' \nendreturn (ogetvalue(), len)K/deK,J 04Find start of  d <i1es;^(Vif not s)praise V2EW('Missing " " GA in }wy?if s[:5]QbI'aTbreak}D}FTrue0 R or sj:j :try15 = }0a2b}s"fexcept"Z as vJ # Workaround for broken uu rs%/ nb = (((s[0]-32) & 63) * 4 + 5) // 35"[:O]d#sys.stderr("Warning:" % str(vy(iL3/Truncated!Rclass(1cs.[b(self,k .z; WW82) Incrementalorfinal=False* .O)[0]fdecode(self, input, final=False): return uu_decode(in.self.errors)[0] class StreamWriter(Codec, 78cs.acharbuffertype = bytesLOReadLL ### encodings module API def getregentry(IUInfo(name='uu',aRe=uu_ 6 incremental56r=IE/er/J /D/sr=={/R#w##_is_text2ing !) """Python 'zlib_4!' 40 -  compressionr. ThisB de/bs from2 to 0. ten by Marc-Andre Lemburg (mal@l `.com). importds6# t~needs the optionalm*0! BBAPIs8H ='strict'Nrassert D == <l(O*cc), len )v,Yv(OS x(!s. E(#,  UB)X/deX!: )Xf__init__ *=# =6Qobj =aobj() /%}"ifoAc = slm->c +8bflush(,Jelseo>rsQresettX ?$'dyZ  self.decompr essobj.decompress(input) return c + self.<fflush(2_else:@<x9def reset(4)N z = zlib() class StreamWriter(Codec, c(s.ccharbuffertype = bytesLOReadLL ### encodings module API getregentry(I~QInfo(*`name='%',c e=_ vd incremental76r=IE/er/J / Del/srC=5R#w##_is_texting=False!) import sys from #s  MappingProxyType, DynamicC0Attribute __all__ = [V'EnumMetajp', 'Int @Flag2Int B@autoguniqueH"] descriptor(obj 1"""GRs True if obj is a 6!,  otherwise.:BSCGahasattq, '__get__') or<# 's'`deleteQ N) unY Qa __d.0__ 0!@len(<) > 4 andq[:2] ==bA[-2: O'__'.2] != '$-3 is 2a _-320 !-1 1+ 2:D#private(cls_w,{ # do not use `re` ass `enum`]pattern  %s'% W`pat_le% 3:if ".8i1and.startswith(R%)[F:!+1]['_']Z[A1 orn%[-ub0 )T retu$rn False def _make_class_unpicklable(cls): """Make the given 3E un-4.'/]break_on_call_reduce(self, protocgraise TypeError('%r cannot be e`ed' % ?)kScls._V_ex__ = _s.amodule+'' _auto_null = object()  )Instances are replaced with an appropriate value in Enum6jsuites0(&= # _;Dict(dict4hpTrack e] member order and ensure 3namUreused. aMeta will us1Pfoundy"._M_ asCyerationq q_init__ super()._ ;elf{A= []y Qlast_H/s oignoreDed =Xssetitemb, key,7PChanglnything qdundered ora descriptor< IfBNG0 isd twice,#':d; duplicate checked fqqSingle sc"!(s #) @serv0if _is_privatQ._cls&0)=import warnings. ("jP varis, such as %r,be normal attributesB3.11K 1% (/),zaDeprecW(stacklevel=2">u~ -fr4?in !'__', '_create_pseudo'P'_genSe_nex?Grmissing =_F U V#s_3P@ fut'Ii?== +!# 3 ifDs already defined*(lA!ifc..edc*"LA mus{0beffI.s"0set ' (el-:  if isinstance(value, str): !1 =  .replace(',',' ').split();OelseQ Blist>self._ignore| calready = seJ! & @member_namesd3if Bpraise V mError(.'_ cannot specifyd _: %r'L 3% (., velif _is_dunder(keyif key == '__order__'$# '"a>in _ H# descriptor overwriting an enum?iBTypeh'Attempted to reuse8 % 5 Epasss. 94 #  1 %%r"defined as,nf[key])LKauto,_*^_null2).bgenerate_next_ Ekey,yV 1 Nlen(m)5 13lasOs[:]2 XH'called = True 3 $Ip.append |+*d,super().__setitem__M,) # Dummy for Enum asMeta explicitly checks' it, but of course # until9finishes runnthe first time nclass doesn't exist. # This is also why1dre are&innlike `if7aNone` e = " mS(type 1"""&@amethod def __prepare__(metacls, bases, **kwdsj<# that previous) j8^!._Q_for_!Cing_9(y r# creatwcpace dict\ enum_dict = _EnumDict()  enum_dict._cls_name = cls",# inherit previous flags and _generate_next_value_ functionDmember_type, first_y = metacls._get_mixins_(cls, bases(if9is not None:fW/[''] = getattr(:>/, D,y,?ureturn  0def __new__(,p 0ass, **kwds)P# an  class is final oncejion items have been defined; itP# canGbe mixed with other s (int, float, etc.) if it haK%$ed unless a new$is (or the resultingNwill fail).  remove any keys listed in _ignore_-QV.setdefault(''', []).appendP[>]g0for2rrpop(keyJg)0]P, savw, use_argspAfind/, )#zinto sepa* mapping sopy don'tA bak%toQ#$BV2{k:A[k] 7"._/%s}J*&inC - 6del)[;]aadjustfsunderKx_order_F. ''q# checkrillegalYw0s (&s?Erinvalidx = set(0) & {'mro', '' ; praise VError('I-] : {0}'.format_','.join()))Ccreate a.p docstr8aif oneen provided9if '__doc__'+ "[2%"'AR&.'M7^super().xM u' []Q#asig WQs._member_map_ = {} # name->value map "enum_class._member_typeH 0# save DynamicC9Attribute a s from super ^es so we knowN ifcan take the shortcut of storing As in#SU dictKd_5= {pk for cI]mro(),*@k, v-@c.__p__.items/if isinstance(v,%g}^Reverse  ->shashabl%s._9203_macIf a custom  is mixed into`Enum, and it does not) hto pickle itself,.dumps will succeed butBload# fail. Rather than hlPerrorw up laterpossibly farK~8source, sabotagaprotocol\Bthis7 soJ5thaAalso#20HowA, ifL3newYimplements. own __reduce_ex__, doiM-- it's o`m to m10sur| works correctly. We useL l 0eade0any0o|0s appreferryKBFover_2handles all m5Iif ''mWn:t#ifjobject*. methods = ('__getnewargsk ',|9_',lB ;._'!ifPany(mkEt)$`new__'L+Q# too#_E_V1_unb(RiOelsep# final@empt`verifyOQwouldL travel mro until __found, checkR&fo#=`friend1ong@way j&f m=a# are before/whe Y shRS= Non  for chain in bases: 0'/8.__mro__7 M!ifa is object37continue )elif any(m.__dict__ methods)|# found one, we're goodsabotage = Fals5_break_'__new__'?not"/Tr5if (0is ONone) WK _make_class_unpicklable(enum) # instantiate them, checkingaduplicates as w,=)we@Qfirstoead ofK)7 caE# a custom X do so funky with values -- such asauto-number:;<e@_nam 1[6._m ;n1 = L'"s[I]~a if"ise1ce(@, tupletargs = 'N?elsE3Y }@typeJv: # specialAuc(0, ) # wrap itH more tim@use_;F$ =tRrhasattr+A, '_/_'Y@n.+" =@ 9h>0, * w"2if _f  N( $ hL.=4_ =-A_obj__ = enum_class'  enum_member.__init__(*args)(# If another 0 with the same value was already defined,$ M4newFbecomes an alias to1 existing one.?for name, canonicalA in cclass._map_.items():K -ifH!._B_ ==PDHy)- =S w3YbreakNelse_0# Aes don't appearpps (only_Js__)<v "@ _.X2nd(U_ performance boost 4anythat would not shadow# a DynamicCAttribute&#ifRLBin d8$_a4s-0set(,K, pnow addC= X a[6)] 8 ?>try# This may fail ifP!ishashable. We[hx b#map, and by- lookupstvjwill bJolinearH D2p[  except TypeErrorUpass # double check iAreprfriends are1ixin's or variousLqthings  (such as pickle# however,Uethod ispEnum itself,freplacSE# it8b@@('____', '__str ntreduce_ex__'!ifONdictSvcontinu0"_m?= gA5>obj3Qtype,W, NonQ:A n`first_:7if wa %)} r__new__our own (as longN,#Gway) -- again& isXto support6Z`@` beSEbothJ prtzys (which liveT y$L =themselves@if _is_dunder(-i1(q;try[7 except Key C @) from Nonelgetitem2G0ite!x0pshs`defini i  oQember_names_ ) def __len__(cls):return len._member_names_>@property6L(sP1"""&\R\s a mapping of 9 a->value.2EThis-lists all enum9s, includOaliases. Note that thisi|read-only viewthe internaln.5MProxyType+4map)MreprJ!"<%r>" % cls._l"__BmversedF^Qqs in re8inition order [Q] forYd,'3s_)%csetatt,@!, t Block attempts to reassign E$A simple '@ment7Qclassuaspace changes ones0al possible wayYget a` from ej,I`result in9inconsist10erac_map =dict__.get('ie', {})x!ifES raise AttributeError('Cannotl>6s.'\super().__acreate[!, s, *, module=None, qualK4typstart=1-Convenience method~b a new53`ms` can be:p* A strpcontain  Z s, separated either with saEs or commas. V@s arh0crered by 1H``* An itera 'R4(i pairs,22 -> 3umetacls%__#b0 = Gp, ) if @ is p else (Gs_, first_>%get_mixinsz_5~I =.P.__pre[3ass;p# speci`rocesseneeded%s?/if isinstance(n,Yo" =Z .replace(',', ' ').split(W(tuple, b)) andP isinstance(names[0], str): original_names, " =I, [].last_values =for countF in enumerate(h V = first_9Q._gen>C_nexx _(Dart,pI[:])] .append(p*^s$l+%) Wb# Here s is either an iterable of ? or a mapping.K5@item.| if isinstance() amember#,  =m[D JelsevP-classdict[z9] =2_3"tacls.__new__(me!, !0basg &TODO: replace the frame hack if a blessed way to know(ucalling# modulever developed#'if$;Non:?tryKUP= syst(2).f_globals['_;__' xcept (AttributeError, V 1Key VOpassR_make_unpickl(/4&A.__m __ @qual fNnot F L/N Rreturjdef _convert_(cl,, filter, source=@5"""Create a new Enum subT thatzs a collection1 cot^# @ all sts fromC (or)sU() to#!ed, and exportc3its0s b2 N;`Dlso,K __reduce_ex__ method so Ding works inHprevious Python version%{! = vars(C"s[#if2 B 0a2@map_populatedsorder every timeG5pnsistenKe'E nu4@whenvrHare multiple s [the same numbSer. members = [ (name, value)Gfor ! in source.items(2if filterY%)]SEtry: ~# sort by} ." (key=lambda t: (t[1], t[0])except TypeErrorkunless someos aren't comparable,which case- clu1cls #, , module=cls.__reduce_ex__ = 9by_?_globals.update(Ek&__^ /[Ku] = clsareturn@staticmethod def _check_for_existing_pa(class, bases)NPchaini (.__mro__'+if issubo(5, Enum) andy.sCGVraise6("%s: cannot extend enumeration %r"? -% !._y!) Yget_mixins_a~&""Rs the type {@creaQ(first inherite ."s:`quple ofsat was given to __new__<0if oO"&bobjectfind_data_%E;setCPcandiyy = None!E/i)B is '~continus/el$R}<9_ vQA.addt M/ ]breakB&'+'LT.__dict"5 7\ ! !or /sec=vo if len(data_types) > 1: raise TypeError('%r: too many ? ?: %r' % (class_name,^)ZGelifwWeturn#\.pop(E/se:UNone t# ensure final parent  is an Enum derivative,* d concreteM, and check thatGhas no members8pfirst_ei= bases[-1]if not issub(1,Y) P"new _erations should be created as "r "`Name([mixin, ...] []b 6)`" = _find_6() or object6if #._F>/s_ 0Can0aextendrHX!@staticmethod3defBnew_Sdict,I&""aR~s the __L@_ toused for1ing$c"s.:& ionary givenYd9;V whosEwillby defaul:jtan overrid R# nowbtcorrect#,QEto see of one was2ineA# byuser; also? earlieres in case amU0R# sav&A_"2_ =Rc.get('0', z)#"gfu later?m'6Q __dc%if!is ;#all possibles~P befo%0all~ baop4@bX5', *9=?8 ;?target = getattr(L- 3if @WIin { /x,".#*  ,*}__new__ = target/ ]breakif __new__ is not None:(UB?els,Q= object. V# if a non-#used then whatever value/tuple wasH`assign1o4 enum member name will be pasXoQand t6P8newD's __init__% 3 9use_args = FalseC8+6Tru*dreturn`, save$, 2 class Enum(meta=RMeta)1"""qGenericeration.Derive from this H#tdefine 7!s.QY%deKR(cls,~?Q# allx instances are actually created duringconstrucqLwithout call-rmethod; R$Qed by##'O __%__ (i.e. Color(3) ), (by picklif type()f"lsk# For lookups likeX^U.RED)0RQ# by- search for a match50seedqit's inrKpse mapp9(Ihashables:tryQcls._2ga_map_[]except KeyErrorJ# Not found, no nedo long O(n)Q bOTypecPtherec$w \D"--fbehaviorWh;.'s(5#if{"B_ ==Y ,S]@# st% -- try _missing_ hoo Qexc =Tnrsult = L*XE{ion as `  ]?M Tif is0(re,N%Sm?2ve_V.@("%rKaid %s" % {p.__qual.6__)T2if Jk!isfRaise T_elif C!%= (GK 'error 4in %s._missing_: returned %r instead of None or a valid member'  % (cls.__name__, result)5 if not isance(exc, ValueError):R exc.__context__ = ve_exc-hraise zfinallyX# ensure all variables that could hold anKeption are destroyedyQexc =W def _generate_nv _(X, start,nt, last_ s1"""LGKP the Oque whenjugiven. 1g:.0ame:%&rinitial]*orRcount/ nuKWexisting^s]3YPassig b7for in reversed(K0(+trM5+ 1"except Typ E"6pasJelse#cQ@classmethoEe,FE4_repr__(self-"<%s.%s: %r>" % (8U'__*2_, (_)~/st}|w@_f X/diXRsQs andrpublic _?added_behavior = [mu0clsn Nmro(0m.5mdict__Vif m[0] != '_'m#inxN_map>u] + [m kl \]|LD(['_', '__doc__ module__'c 0 cformat,Gspec|9 u` actualue type unless __d has been overridd_# mixed-in Enums sh1usef'aotherwise*# we can get strangeas withTi ,mw'upmNiHF0# pDpbranch, dexplicitly str_overridden = type(self).__str__ not in (Enumd, Flag3) 0if =._member_O_ is object or Uos:;BPcls =" 2val# mix-in branchOelseX:elf3}g%evalue_ return cls.__format__(val, aspec) 1def __hash__Iy._name_:reduce_ex?, proto)Fj_class__, R#, U# DynamicC(Attributepused to`vide accessPthe `Q` and1# `Z`/perties of enum s while keeping some measure ofGection from modifica,Bstill allowIafor ank!er)L`to haveo s d. This works becauseP1areset directly on u -- __getat*#isY@look4Rm up.@89a"""ThequA."""?`L_vwx2B_ %0Int`(int, 0"""V wherzalso (and must be) ints &_$!byC *  @pSupportR flagu[x0genre_next_(], start, cou3las sgDMGK  O On|Sgiven61g:. amP %&rinitial]uor None// nuCPexistw\]3Yassigned b!ifuZD E s0P % 15reversed({f6tryEhigh_bit = _ D-Ubreakexcept E>ione raise TypeError('InvalidGC: %r' % ) o)d2 ** (#+1@rRmethomissing_(cls,m): ""3" 6Returns member (possibly creating it) if one can be found for value. L6 ""Yoriginal_v$" =,x"ifU < 0:I0~ #e_q= cls._e_pseudo!_(;)< v_~Nr3  @classmethodOdef Bcls,)CCe a composite$if?contains onlys $ @*2T_map_.get@i, NoneF C!is"# verify all bits are accounte7,_, extra_flags = _de'e(" 4(if4 Tpraise VyError("%r is not asid %s" % L_qualname__)Q# construcAsingleton enum -D  = object.__new__ g 0!._! =eX.b_cuse setdefault in case another thread al(edt z# with thisH)ue b 9j rW___(self, N@True2 has at least the same bset asTR!ifSisinstance( , \1.__ '__BType"unsuppor0operand type(s)w'in': '%s'   JR97)._ Bl&?C_ =='Crepr  cl (#if_ '<%s.%s: %r>'=_ is, uncovered ; '|'.join([str(mDor mum=]),I  ) def __str__(self): `cls = .__class__#ifname_ is not NoneAH return '%s.%s' % (cls.__7(_,E)]members, uncovered = _decomposeC:fvalue_;sif len(B) == 1 and B[0].} rG |?els "'|'.join([str(mcor m._ f4 in?]),M!) Nboole;o5w, other<!ifisinstance("O2 vNotImplemented  " |3andv&x^^cinverta0  ^ 1&(0 # Bif m'Xz# & 5| m (+A) R IntFlag(int, l1"""LqSupportinteger-based-s$, @TRmetho7missing_7e=Rs@ (possibly creating it) if one can be foundZ.MY-W, int7praise VError("%ra valid %s"JD>BqualU)Bnew_1 = (e_pseudo!_(J7>_R@cls,'ueCSBe a 4itew2iff: contains onlysb 2_map_.get(value, None)   if pseudo_member is None: ! need_to_create = [value]% # get unaccounted for bits'_, extra_flags = _decompose(cls, [)4# timer = 10XwhileP <I-= 1<0bithigh_bit( -_p = 2 ** SGif (*not in cls.<2i_map_ andAkE 9)P >w.append(if[V == -eA: = ;els\:6^= i Sin reversed(# construct singleton-  = int.__new__ 8._name_ =W ,- .# use setdefaulZase another thread al"y Bd a b?iteTwith this{ " .(,`Z_Tretur~ vdef __or__(self, 1if Qsinstance("!, 0.__class__,)9lxNotImplemexsR = zJY<_ |)_ reU?andct & +xe^0__ro1__r  cinvertq O~P0 g.]1"""s index of .0est, or -1 ifzero or negative """(return value.bit_length() - 1 def unique(enumeration):<DClass decorator for .s ensuringKr memberu)s.Lduplicates = []PTname,9(in`2.__Qs__.items(0if <3 !=>. u.append((%p2!))6if .Falias_detail', '.join(6e["%s -> %s" % (:,): 'inp]Jpraise VuError('X found in %r: %s' %!,  _mpose(flag,uxExtract all}s from the1 &# W is only called if61not5dnot_covered =[tegativeA < 02 e3_% HM#if':and&$ =A)fFjs#B&= ~$Magtmp = @/Twhile tmp-Y = 2 ** _high_bit(tmp7if 0!in.?2Jmap_cgF8[O@ -'3  6z0[Q3sort(key=lambda m: m<_, reverse=Truelsif len(?Q) > 1A[0].ge # we haveGbreakdown, don't need7u itselfBgb.pop(0 ,^"""Utilities Qcompa Qfilesdirectories. CK"esdircmp Funcwcmp(f1, f2, shallow#V1int1cmpd(a, b, common)"R([], clear_cache()  import os Qstat itertools %filterfalse"EtypeGenericA! __all__w'x/0cmp  DEFAULT_IGNORES'] = {} BUFSIZE = 8*1024 1ES = [ 'RCS', 'CV@tagsA.git!hg0bzrQ_darc! __pycache__'] def clear_(): """C the filecmp "A."""#1.=#()Jmp(f1, f2, shallow=TrueVompare twoX1s. NArguments:f1 -- First(S name2lSecondu!Btrea<s as identical ifir stat signatures (type, size, pmtime) J. Otherwise,s considered differentOizes or cont4. [default: C]Return value+same, False oqThis function uses a for past cisons and7 results!Cwith5entries invalidatedjpinformapchanges. TheFbmay beed by callingt#()Ks1 = _sig(os.R(f1))22if s1[0] != .S_IFREG/s2r[gL*M= s22121[1}M2[1]+]-poutcomeFget(jG1, s.vis NoneYu= _do_c*rif len(h) > 100: # limitqmaximum+! oP0 \['C] = )`#stL"(MT(st.st_mode) <0buf< = BUFSIZEAopenP'rb')iRfp1, 72,  Qwhileabfp1.read(w'b?fp2#Pif b1bs<8]if not b14 # Directory! class. # r dircmpKB"""A that managesJcH28\$ieJ(a, b, ignore=R, hid "A|BdI IGNORE i@listrWCs toZ7}DEFAULT_A!S._ HIDNL[os.curdir, os.pa ]High level usag0x =cmp(dir1, dirA2) x.report() -> prints a  on the differences between dir1 and 2M3 or W_partial_closuregeaNm, =scommon immediate subdirectories.F;fulClike ,>@but ?y recursive. "Attributes: left_list, righ : The files iEjfiltered by hidecignore@: a br of namT@both4Donly :9 ,?26jk_dirs:Y0n8:0Dunny>in 0a where4typ} A, or3' is not stat-ablUSsame_Widentical *9^`s whic51f2.Qcouldbe compared=sdictionarydircmp insta(or MyDirCtif this`object1of D40, aVclassab), keyI in1mon2""" def __init__(self, a, b, a=None, ): # Ini/4ized :.J = aXE = b!ifQ_JP= [os.curdir, os.pa Q] # NHnever to be shownbOelseW^+#if  = DEFAULT_IGNORESEp8 raphase0pRCL ything except-xw0 = pter(os.1dire)lQ +  q %rTs Zr!.s l  i1i!ut )P a = (zip(mapFpath.normcase,)+bMNlf.right_lisSt)) *self.common = list(map(a.__getitem__, filter(b.__contains,a)Jleft_onlyM_falseRNrighS Sbdef phase2(): # Distinguishes, directori qfunnies@390_dirs = []Ofile 0unn&5[] ?for x in f:a_path = os. Q.join.{6, x0b0Y1 biok = 1:tryZba_stat ( except OSErrorE# print('Can\'t I2', K, ':', why.args[1]]0b Q$K ^if oka_type =.S_IFMT(t.st_modeb553if m2!= B^_y.append(t,EelifRSDIR(d)[VZ?REGZ[ /se /elB9  3Find out differences between Btxx = cmpI ?_)FBsame, R = xx4z7subpp# A newcmp (or MyDirCmp ifwas subclassed) object is createdP\Deach<y'y,(these are storeda dictionary indexed by1Wname.@The hide and ignore propertiesY inherited from the parentGC%{} #  a_ %n(self.left,W x) b_x = os.path.join(self.right,.subdirs[x] = __class__(a_x, brignore,&ahide) def phase4_closurew): # Recursively call)b() on }ectoriesLmQ(for sd in<s.values():?C"d.AfreportPrint a the differences between a and bk # Output format is purposUlousy+pe ('V'CCleft "if"[_only .s=nzOnly inq(':_=z{|4&, }b~same_files~~Identical G >wwwD5w_funnyxyTrouble with commonI3_ sCwzE'm cases _partial/s ,%!5sd.UQrO_fulR 6s rLaQQB ~methodmap = dict(=,(!3,? O" =#2,A@i2U$51, :Blist'0, right_list=phase0) def __getattr__(self, !):!%!if not in $.methodmap'+raise AttributeError(ON ?[]x)#sreturn p__classitem__ = (GenericAlias) cmpfiles(a, b, common, shallow=True"""Compare& 9two directories.R5 --qy nameshqlist ofM!` foundXEboth?i;<if true, doparison based solely on stat() informationRPs a tuple`three sCthatdqe equal !s different#n't regular=/1"""4res = ([], Pfor x; ax = os.path.joinx5|b 7b, res[_cmp(ax, bx)].append(-res # $B. # S0: #zP 0 01)2funny cases (ca., etc.) #sh, abs=abs, cmp=cmp6try'Aabs(A)-except OS :2 a copy with lPoccurskip removed.filter(f_ , #(%`false(#.__contains__, =)# Demonstr and testingrSdemo(dimport syRgetop op`s, arg.(sys.argv[1:], 'r'4pif len(3g) != 27?!.GhY('need exactly ??r', NoneW@dd =brgs[0]2[1]"if ('-r', '' Pdd.re_full_closure(?Oelse+P() i@= '__main__'0T """Helperb to quickly write a loop over all@ndar5putTypical use is:VBinpuI@line_. (encoding="utf-8"process(;p) ThisRrates thnf^se40aulg`stdin Jst is empty. If aS '-' it is also replaced byiM#he aluments mode openhook x ignored. To specify an asPnativks, pass it as t8he argument to input(). A single file name is also allowed. Functions&%(), lineno() return thF and cumulative, number of+? that has just been read;i"a`s its  Jiu@curr; isfirst(s true if{Drm1rst1itsQ[stdinM M11was from sys.4C. F<P next() closes 2 so/ iteration willbzq 1a (if any);"Rs not;,vScount toward  ";;iYchanged until after(N $1() sequence. BeforeFhave5,0Non2ad both7s are zero;no effect 1all<%s s ; szf%values pertaining:a]Q Allpopened #ext mode by default, you can override this by sett"he6aparame' or FileI6.__init__(). Ii I/O error occurs durUr a,"0OSE5a excepqis raist&IfG`used m th2nceGasecondqfurther use "no", l perhaps for inec@use,Bif i explicitly reset (e.g. u;.seek(0)). Empty #immediately dYonly timPeir pk1ncehC stsnoticeable at@whenb lP0 !0s eP. It+Ppossi> 2of  doesn't endPa new character; oz0wis"nexPncludctrailing G. Classe*Pimple;r method1(),* A, is,!()8w`orrespOt&e \%ule. In addi,a~c which"|,a __getitemZ >A behavior. The mL accessed in strictly sequential order;Tce access and readline() cannot be mixed. Optional in-place filtering: if the keyword argument inp+=1 is passed toput() or:FileInput constructor,  file is moved to a backupestandard outDis directoFi]L@. ThOakes it possiblepwrite aZter that re,sQe in O. I="."also given,specifies, f&(he,b remains around; by defaultISis ".bak"H it@dele0AwhenL[is closed ?isabled @w!is\. XXX The curre!@mple+a^` does yAworkMS-DOS 8+3vsystems. """ import io sys, os from typ$ GenericAlias __all__ = ["A", " @next @name  no & "#pisfirst&2pisstdin  hook_compre)",Oencoded"] _state = None def(x s=,ucFalse,8="", *, mode="r", open`6wp2ingb error\!):'"""Return an inBce o class, whichQNaiteratQ6 parameter&e &a.Ir%ed P addi\Qbeing"ornkeeps global bu@func>s~8bodule,w<2if c ._D6raise RuntimeEg(P() aly active")UG5 = e  ,h;(C-Fz?ce.+r=Q"if>7.z=x2 soi; ion willJ ^1he 5K(if any); ",'WHcount toward`cumulaG ".1?91notEchanged Al after the first line of the next file has been read. Before(first lin), this functionFno effect;F it cannot be used to skipYq. After$lanI*f 1"""B0if q_state:raise RuntimeError("no active input()")0rreturn C.?q() defJbname()^yR6r%am~; currently beingos NoneL/noacumulaF,t number|Athat0jus"0AE ACa\LwLZjJ!S!in8L. $, CGCC S withHSLc$ WS3S5 SqWhen noa6 isfopenedP/-1P6!isRs tru% t@aof its,Ptherw*OfalstM _stdin i1wasZ from sys.Ek<class FileIn ([0s[, lace[, backup]]], *, mode= , Ahook!) Class FileInp ut is the implementation ofmodule; its methods filename(), lineno  visfirstPstdin&0J@next () and close() correspond to@funcsPsame H!in&.pIn addi5 it has a read which return BQinput,a __getitem__()BBE@sequence behavior. The  must be accessed in strictlyAtial order; random2QcannoRRmixedA""" Mdef __init__(self,s=None, inplace=False, backup="", *,@mode="r", openhookGencodingBrrorc%):Gif isinstance( s,#j3 = ")@/elBos.PathLikeJos.fspathT8), V&se"if#&& "sys.argv[1:]!0if (?V('-',9,elHs = tupl:7$._#$ = # = savestdout =  0out1:Astar-kno = 0X<U!isu1 =  U[4 = Fe  j# We canuse io.text_I`() her ca 5oldL doesn'tme# take parameterq@if (flags.warn_defauls0S41"b"0in $h!is  cpimport y2ing(`4("'`' arguwspecified."sIEcWarning, 2)x"reDa!to1ing!ifin ('r', 'rU;rb'raise ValueEq("FileI/'e 0one"~"{vV'rb'"`if 'U') Qarn("'U' mode is deprecated", D'ionWarning, 2)1self._mode =  Xwrite .replace('r', 'w') if 'U' not inEP elseNif openhook:Qif inR raise ValueError("FileInput canqause an\@ing `S"U!ifcallable()7 must be Qo]*= def __del__(+.close()-+:try .nextfil?ofinall-_*Hs = m~__enterpreturn gc__exit-, type, v, traceback>?__iss[while True0linzP_read( 9=6( qno += 1# tEaStopIterationC< # repeat with % &sgetitem.7, i1import wsw. (A"Sup5for index~zobjects:. "E@Use ator protocol instead. Nstacklevel=2h1 !=.7no(dRuntimq`access4s out of order   __'__yexcept  I[0end{ireached"e L`avestd%_s*u = None 6if  Fsys.a[<0out~z v XHN BU( 3  2del[Z estore . qAttribut} pass  Ttry: if file and not self._isstdin/70.close()Pofinalle`backup8cname =f  Kh %} = None,;if )  os.unlink(+ except OSError: pass L = False'def readline(() whFTrueu,<= 0if ' 9=d ._ }no += 1areturnC 'ifEa;y@next7 1# repeat with %#_G$ sif 'b' ink;modN9b''?els-,T Es[0]T(s%,1:&Sstart(;PO = 0m ,7  YZ # EncodingWarning is emittedj__init__() aly;aif "b"De_%or "locale"T/%+#ifvZ= '-'4#1 '<>[M = getattr(sys.S, 'buffer',  %O#I!Voinplac (Uvos.fspathC) + J j.bak")J_I TvS# The!ews may raise PPos.reb, s = openH 8N$, = ) try:  perm = os.fstat(self._file.no()).st_modeAexcept OSErroraQ`outputi7penebname, $Qwritei, encoding= )}?lsesks.O_CREAT |O_WRONLY]TRUNCW! if hasattr(os, 'O_BINARY')q4u|J/ ]"fdo F , f*NAs.fdI/fdG$Vos.chmod[Mpass$savestdo5Bsys. .# =H *e,# This may raise ;$if[penhook# Custom #Xde previous to Python 3.10 didn't havWs# argument() is Non3a3 ,Yf>j59!%0, e#s= 8TLreadlineyo. # hide FileInput._/creturn"()l@def S 9%7/no5 Rstart(# +IKO ' ;3 | Gf_ValueJ%-19A$%aisfirs,V == 1bisstdi*$5 __class_getitem__ = classmePthod(GenericAlias) def hook_compressed(filename, mode, *, encoding=None, errors=None): if$@ is 'c: # E9pWarningemitted in FileInput() already. Ot = "locale"ext = os.path.splitextA)[1](+r= '.gz'Yimport gzip)stream =U.openQ)+(elV>bz2W1bz2+ Vpbz2.BZ2X&sereturn !) ~# and bz2 are binary by defaultpif "b" notio.TextIOWrapper( 5{1ed(5ingF) B"c) %Bkc_test(?Qetoptminplace = Falseibackupopts, argsh?!.g(sys.argv[1:], "ib:"qfor o, a@if o == '-i': 2Tru%Eb': a\@line\i,L=T,8=?^@Q[-1:]P\n': ! =3[:-/r/ print("%d: %s[%d]%s %s" % (cdno(),  vpisfirst4nd "*" or "",) )) if __N!__#__main__9Z@ """)` match- with shell patterns. fn!(FILENAME, PATTERN):es accordCqto the @ convention.FOcaseJalways takes %%Wunt. The funcLs@rateVtranslat|$he into a regular exm They cacheDiled- - s [speed y%e(qswJ correspon'7. (It doesP it.) $os Pposix$re #ools __all ["filter", " l"] # Build a th&@-saf@cremng counter to help create unique rege2xp group # names across calls. from itertools import count _nextg=Rnum =A()._b__ del def fnmatch(h, pat): """Test whether FILENAME /es PATTERN. /Patterns are Unix shell style:$*X% BeverythingC?any single character)W[seq]H)"r in seq)!*)D not()An initial period!is1special.2FBoth4andfirst case-normalized8if the operating system requires ita If you don't want this, use`(,)@1"""q = os.path.8)"?pat!  ireturnu=-q @func.lru_cache(maxsize=256, typed=True)s_compile_p5(kvif isinstances, bytes"pat_str = str#'ISO-8859-1')3res)translatR %" =d(1., PBelseZ9 = VR+3re.T!).oQilternsBW"""Construct a list those elements o@Pable bS thatW.Presul![] ? = B$ifJ is posixW$# b2 on!*NOP. Optimize it awaybe loopD1forjs_"ifEr.append% e9wt x, includDI@Thisqa version2) which doesW8% it!gunN)ymRNone 7m# a;a to a regular expres2ereg Tto quote meta-s@STARdbject(Cs = ,add = resI6i, n = 0, len|9while i < n0c =O"[i|qi = i+1K f c == '*': # compress consecutive `*` into one if (not res) or[-1] is YSTAR:1<@add()elif c == '?'1-?'.',[,Uj = iUkif j < n and pat[j]f!:,>?j+1@]@^whileO!= 'CJ>= n7\\[Nelse-qstuff =Ii:j]7qif '--'1in 0G*" =#.replace('\\', r/chunks = [ kR+2 if S+ i2y?Tru  Zpat.find('-', k, j,if k < 0"]break].append(Oi:k]tO = kP?k+3pljl# Escape backslashes5hyphens for set difference (--).z3# H7that create ranges shouldn't be evdGh'-'.join(smKr'\-)B in +operations (&&, ~~"/||re.sub(r'([&~|])"B\1',?tLi = "if2$[0{S'^' +3.1:]u-Rin ('^', '[')Y %\\Z Af'[{Y'}] Y,2re.2(c) assert i!n a# Deal with :s0Pinp =t%'reF2addk"i, n = 0, len(inpq# Fixed piect the start?8MiI_inp[i ]B += Yy# Now d! f "..# For an}verior `&` pairing, we want to do a minimal # .*? match followed by `v`, with no possXibility of backtracking. # We can't spell that directly, but can trick it into working by matching N .*?fixed`in a lookahead assertion, save theDed part 0`group,nG`consum01at a via areference. If6 overall[s fails,Jr0 wotry alternatives. SoRptranslaC is:M(?=(?P`))(?P=)*G s are create needed: g0, g1, g2, ..The number9obtained from _nextnum() to ensur*ey're uniqueacross calls and threads. This is because people rely on Jundocumendto join multi86e() results togetherM0"|"build largrRgexpsm@"onemany" sh0pats,while i < nqp inp[i]ASTARwfi += 1hf i ==@&add(".*"Ubreak; hInot lU = []5>sC.append(- 0` = "".(2i @Jelse, =L"9$g{6}@{e}B)iV7res2resreturn fr'(?s:{res})\Z' # Originally contribu6by Sjoerd Mullender. # Significantly modified by Jeffrey Yasskin . """Frac>, infinite-precis Dreala.""" decimal import D Dmath #operator$re sys __all__''] # Constantst@hash le 0; 0(x)Zsbased #(Q redux9"ulJprime _PyHASH_MODULUS. p = sys.a_info.modulus # Value2@e us Aor r2als%p_ulo #{=INFw inf _RATIONAL_FORMAT = repile(r"""P\A\s*@# opal whitespace atTg startQsign>[-+]?)NF# anK% 8=\d|\.\d)   # lookahead for digit or .  '(?P\d*) # numerator (possibly empty)<:/ # followed by-p (?:/p@denor@+))?6# an optional  inw9|#A# or$]"\.^Qcimal:)? ]CfrachGpart=E<exp>[-+]?\d=drexponen7_\s*\Z'an=whitespace to finish """, re.VERBOSE | IGNORECASE) class F(numbers.Ra!):"""This .implements r(9 0In the two-argu,$Am ofconstructor,}8, 6) willEproduce af equivalent4/3. Both lRs musH4be P. ThevdefaultsD 0 N !&1 so thatq3) == 3?F"0. s can also be ed from:-2 -ic strings similarthose acceptN-%VfloatZY0exa, '-2.3'v'1e10')tlform '123/456''b+!De instances%Uotherv" (including integers2"""@__slots__ = ('_#W', '_# We're immutable, use __new__ not __init__*4defR(cls,p8=0,  =None, *, _normalize=TruesD"""C5s a#@Takec like '3/2.5', an51, aI / ` pair,!a zEsB-lT6>>>b10, -8zf(-5, 4 5%1, 7), 5(3@ 5_2, 3)MO3, 1_'314'4V14, 1 _'-35/7/-3'3.1415') #tqversionS6283, 2000Q47e-2]9Bmay Ad 5 _47, 1b1.47) # direc7O (exact conversion3) Fraction(6620291452234629, 45035996273704965E>>> 9F2.25A 2Decimal('1.47')&=147, 100) 5""" self = super(5, cls).__new__( >if denominator is None:Rif type(numer')(:int'+%._)5 = S,~== 1&preturn Y?elif isinstanc,tpbers.Ra?al)...2(float, )# Exact conversionz:,K'._.as_integer_r?(v!?str`HandleAstrur from strings. m = _RATIONAL_FORMAT.match 6@if mraise ValueError('Invalid literal for}: %r' %hJ #L = int(m.group('num') or '0'75 = /)6p;els?1C$ 1!$scale = 10**len(d=-k "* I+E"*=<8exp?exp?expI?exp0if *O>= 0L *=?exp- -Rsign') == '-'5= - 3Typ"argument should be a_ "   "or a Rational instance") , elif type(numerator) is intqdenomin::B pass # *very* normal casea4(is}h, numbers.Y) anda8:)', 8I = (_+. ( *6.B,? AM? >)Jelseraise TypeError("both arguments should be "F "_s(if_ == 0ZeroDivisionP'Frac[(%s, 0)' %EBif _+izg = math.gcdT! <$U%-gZ //= l fself._<=^$D=N(preturn /@classmethodef from_float(cls, f"""Converts a finite ,t to a rU, exactly.pBeware that .tu0.3) !=w(3, 10)B&""k7if fIntegral~Vcls(f nom""f, A (%s) only takes@0s, Z%r (%s)" % s.__name__, f,%f))p*f.as_i1er_#()bpdecimalucD0  p import O ?decTdec =H(int(dec"X{ "(Uqz?dec B"""R 0thedBeger aWtupleq.!a t of two9s, whose ratio is equal to the Fraction and with a positive denominator.25""" return (self._numer-", @!) 5def limit_?X, max1=10!)::"""Closest !tomU at mostW.O5>>>H('3.141592653589793').510)f(22, 7X#Y311, 99[4321, 8765/00T6 &# Algorithm notes: For any real number x, define a *bUupper# approximaa*zxb2rNp/q such that#O` (1) ) >=~:andR2) if!P r/s 'n s > q, f}6r/slD\lower similarly. Then it can b\# proved< a Vis a :A or k C=Qx if,Aonly 1it Jconvergent oHsemif (unique shortest) continued fpssociat?o x6tTo find fW<= M,l"weG8the  s? [.take whichever o se:cSr]1 In(!evQf a tie,4bou.xsmaller+7 ischosen. If both*Ss are(CghappenDwe $Q == 1qmidway betweDtwo integers)Lr---i.e.Afloo"T,GnC,if`F < 1graise ValueError("pshould t least 1"!if.< <=z vp0, q0, p1, q1 = 0, 10ycn, d =| 2while Trueva = n//q2 = q0+a*q1Bif q2 > )Ybreak; 1 = p1, q1, p0+a*p1, q2 n, d = d, n-a*d  k = (max_denominator-q0)//q1%bound1 = Fraction(p0+kh :q1),2,"qif abs(U2 - self) <=!1-:Urreturn 7Oelse(1@property7def numer6(a)?c5a._ A/C"Ex__repr__(0"""1"""'%s(%s, %s)' % (.__class__.__name__,8<w,}.)/st1str).ifNV == 1aeCEg'%s/%s _fallbacks(monomorphic_$,  `"""Gen9es forward and reverse Gs given a purely-ra7%al*?Qa funY from thK module.AUse this lik__op__, __r 5 = Tjust_E_op,3.opeAIn gl, we want to impleme he arithmeticFuions sothat mixed-mod&either call anY)e whoseGauthor knew about"types of both argus, or convertG!to8nearest built in Id!0ion/ere. InD", Beans we define __add__S3__r &s:bL0, oo&0# Bfs have's/g attributes ]# so rdirectllif isinstance(u, (int,)?*." *.+`A JIL 6Bq# float corx don'ttv, but wH6knoo,special caMhem.+elther, float)?:  return float(self) + other/elif isinstance(&, complex)` %b # Let the type take over.@NotIymented 'def __radd__~,\ # ' handles mores than add becauseIre'sj]# nothing left to fall back toQnumbers.Rationall@Frac(.numerator *.denomin+I  JI,H 6)Jf/Re  dCi   (There are 5 different cases for a mixed- @addi5 onA. I'll referyx of above codat doesn'tC4L,D, or as "boilerplate". 'r'C wiTe an F of Qwhich is a sub%of?U (r :6D <: ), and b : B 1, we're working with smaller integersNote, that t,oDand are pairwise coprimeDoIndeed> sh@ no common factors (they wereremoved) |Tda ismna (since input fX5s aDnormalized), he-V na,W. By symmetry, ndma too. -33t, =&17K7O3== 7=Above allows us optimize redup` of thsult to lowesterms. W3 g2)Q(*g"g)CI^t//g2 :4  @c (g) 2Vis a Ts isuseful becauseq&un3denominator d could be much larger:n gXQWe sh-special-case8P= 1 (b= 1), 60.8% ofyrandomly-chosen:, https://en.wikipedia.org/"/C_F#Probability_of_%aPZ always forL s, obtained from floats: hgjpa power2$la numerdt1Tn odd Z2multiplica1 n|pnb, da)B5na* (n/P1)*(nx3 a*--6. d jj;after divisionsJyN Iers. # 4 # Also, the resulting fraction is normalized, because each of Btwo factors inKnumeratorBcoprime to9$7 I=pdenomin?.P Indepick (na//g1). It's fpwith (d&2)SinputHWs areKLalsoPbmPJecommonO removed by g1 == gcd(na, db)As for addimS/subty , we should special-caseS1`and g2e1K0samason. That happens omcplyingF ra als, obtained from floats. (def _add(a, b):"""a + b"""ea = a. G, a.,bH = b,b,g = math.TdTIAif g return FZ(na * db + d n Udb, _u=False)]0s =02// 6ZAt = N@(db ) + nb * s8Ft, gT At, s t2;___, __radd__ = _op_fallbacks('$, W.add) ?sub - -/* ;- 3sub   7sub 8sub ?mul * T1AbZ1 > 1na //= gu  8 ]2]:A= g2Yds xdp 3mulmul__ = _operato%r_fallbacks(_mul, operator.mul) def _div(a, b):"""a / b"""# Same as O(), with inversed b.+na, da = a.numv, a.denomin,b, db = b,b,g1 = math.gcd(f5nb)Jif g1 > 1na //= g1)b(g2]da]2]d]2]d]n, d = na * [ nb a6if d < 06e-n, -d,return Fraction(\, _normalize=False__truediv__, __rD = _+7div+/M/_floor4 5( 9 * i) // (#:}$__z"Uodivmod( b, a % b)d ,U@n_moo p GGPiT_3mod$l/__" ", D ' wdb) % ( .a) 7mod8modo_pow__ba ** b"~.If b is not an integer, the result will be a float or complexsince roots are generally irraDal. l hF p9 if isinstance(b, numbers.Rq*if< ==O'Zpower 2if ',>=r5a._@,Z; 7a._]=; _Yelif  - <  _normalize=False) ]else:%return Fraction((-a._denominator) ** -power,AEA_numer?" S# A f1al will generally produce an`# irraal number.%(qfloat(a bn6!b \def __rpow__(b, a)@"""awAb"""-`Iif b == 1 andqV >= 0K:# If a is an int, keep it that way if possible%._g^if isinstance(a,B3s.RS0Rq%a.UL, a.{/: ^"fkpos__(+a: Coerces a subclass 5 toBlBi,>neg/-an  \o/aboabs(a)s "')^trunc {Gif aj, <}-0 //8gfa i A >^floorQmath. _Oceil^ ]# The negs cleverly convince 0div@the L6ing LS ) round__(self, ndigits=None1"""( &HRFs half toward even$ifhk , remainder = divmod $'ifDl* 2 < 1 y5C N-elP>P return floor + 1  # Deal with the half case:'aelif fB% 2 == 0!Sbreturn' > P / shift = 10**abs(ndigits)T # See _operator_fallbacks.forward to check thatresults ofGbthese Hions will always be Fraction andFPrefor%'veFround().3if , >)%Z(=qself * #),P,el@F/>O Hdef __hash__(o)0"""2"""2# To make sureN/W of a#@greeBJ!shzH- numerically equal integer,6at or Decimstance, wm`follow rules for X es outlined in)documenta@. (Ilibrary docs, 'Built-in Types').6try6dinv = pow=._denomin, -1, _PyHASH_MODULUSexcept ValueErrorZ#` means re is no modular inverse|5_ =|5INFL# The generagorithm now specifie}Iabsolute vP{#5 isu (|N| * 7[) % P"pwhere N!._MP Q. That'moptimized T 0wo : first,;a non-negative; i,P0(i)iB, buV3intEmpleZ doesn't needMto divide,is faster]pn doingd explicitly. So we doL! ~V "pinsteadCbecond,^0unbed, so its product K mayMbe arbitrariPxpens6oaomputePe finLPnswer&th psame if usZ#e  $C% P , which can againBdone!an ) j. If 0 <= i < P,3 Pso thc0est<Bash(H wps a bit@timearedundant copy when=Psave TLlarg+Qamounsce.Yhash(hash(abs( self._numerator)) * dinv) result = hash_ if 4 >= 0 else -$;pturn -26HB= -1. /def __eq__(a, b):"""a == b"""if type(b) is int04!reyaC and a._denomin1Xisinstance(b, numbers.Rationali(j.St`4'b.?if Complex)cp b.imag0 b = b.real R[floatif math.isnanj$orHinf('# comparisons with an infinity or nan should behave inGthe same way for any F e a, so treat a as zero.E00.0b  %{2nqa.from_&(b:# Since a doesn't know how toe b, let's give `# a chw7 itm>a@NotIgmentedMrichcmp(A, other, op"""Helperb2 op!s,internal use only.g4| between a 7 T ` `, ei1 an5 ! `$e`. IfA  noxC", ;> Cf. `op` one of 0ix Edard?9" Rnvert$where reasonable  o *v, 8=%~\ c)&xgcop(0.0]r,pJFB 6/lt<I4a._b|H.lt)UgU>Ugt) def __le__(a, b): """a <= b"""return a._richcmp(b, operator.le) +def __geV>VgV@boolX H!= 0# bpo-39274: Use 9() because (a._num >d) can n # object which is not aQ.&8f[# support for pickling, copy, and deepCPreducGGselfm(.__class__, (str3),)yY"__rif type == Fraction#nm # I'm immutable; therefore I am my own clone Ez", pdenominV $g, memo&My components are also0"""An FTP client some helper fun2s. Based on RFC 959: File Transfer Protocol (FTP), by J. Postel TJ. Reynolds Example: >>> from ftplib im2FTP@tp = ('ftp.python.org') # connto host, default D@p.login(0, i.e.: user anonymous, passwd@ '230 Guest F ok, access restri! apply.'tretrlines('LISTlist director nt total 9 drwxr- 8 rootQwheel  1024 Jan 3 1994 .9& :2s:binu;etc d-wx@ 2Sep 5 13:43 incg{aNov 17)Z3 lib;a6 1094|{13 19:07 pu;3,usr -rw-r-;312 Aug 14 welcome.msg '226n!Gleter`quit()(1 Goodby A nice tthat reveals  of5 network dialogue would be: vlib.py -d localu -l -p -l  # # ChangesPimprovem suggested Steve Majewski. # Modified by Jack to work on the mac. # Modifi'pSiebren* support docstrings and PASV6Phil Schwartz<add storbinary8lines callbacksGGiampaolo Rodola'KCTLS q. # im5sys ocket from s  %(_GLOBAL_DEFAULT_TIMEOUT __all__ = ["FTP", "error_replyFtempGpermroto", "VI@s"] _agic number <.h> MSG_OOB = 0x1E # Process data out of band dThe standard FTP server control / FTP_PORT = 21 # 5 izehint parameter passed{@read!()s MAXLINE = 8192zException rai8when an  or invalid response is received class Ex(K!):I()$# unexpected [123]xx  CBb # 4xxs55556#  does not begin with [1-5]ZTAll e^ s (hopefully) that may bewAhereharen't # (always) programmingour side 2 = A, OSpQ, EOF )Line terminators (we hput CRLF, but ac @ anyCR, LF)  = '\r\n' B_b#citselfAFTP:tQ'''Anqclient -!. To create a 0nec,-0 usthese arguments_chost, user,0wd,t, timeout, source_address, encodinghe first fsg a3ll b,have default value ''.'he#´p´ mustqnumericIDspNone ifpJb, meanTat noP willP0set*3ftp]2(s)EIf a3!is0ed,_`n this0now for all ftp` operas"Fn"cev8las!iscwmfilenames, whichTutf-8)@use c@.con+"()o0al VM*Co download a z0P.retrGs('RETR ' +")<%or*3~slightly differ= Lo upx ftp.storlinJes() or ftp.storbinary(), which have an open file as argument (see their definitions ?below foqtails).WThe download/upQ func: first issue appropriate TYPE?and PORTPASV commands^A''' (debugging = 0host = ''0por@FTP_Omaxline = MAXLINrsock = None&`welcom6#passiveserver = Tru<# Disables https://bugs.python.org/ 43285 security if set toJbtrust_c _pasv_ipv4_address = False f __init__(self, ='', user !wd @acct timeout=_GLOBAL_DEFAULT_TIMEOUT, source=2, *RF encoding='utf-8'):n@"""IKPaliza method (called by class instanti&a]?e:Plocal!, 0to <@dardZA Opx%alM(connect().5O", L , I 0wlogin()5""".4 = ! \+ =m -3 = !ifp')0!if) 48)Senterpreturn H.# Context manageiprotocol: try`quit()Ractiv_ de'exW*argsoK1lf.ais not :tryx except (OSError, EOF w@ =ofinallnT?w.close(u4=0,_=-999B'''C~!C. A1-a@name3 (string, default previous1y-:9DintegerE ET: theOT0agaE@ftp Iet(sA y: a 2-tuple ( R)cDbHbind to?3its sbefore 6ing !q! A.! =Gw"if@> 0: self.port = # if timeout != -999:#s9"=,#9if "is not None and ! ]raise ValueError('Non-blocking socket (C=0) `0supIed')ource_address- xs-*= X sys.audit("ftplib.connect",S.host m0ck c.create_HQion((& DP, =a  afyu.familyt@Ifile%@make('r', encodingm gewelcomGgetresp(&areturn\.- sdef get3)'''Get the " message fromqserver.NAA(thi(Areadsquirreled away by e())''';debuggingZprint('*#*'sanitize)Aset_pQlevelC!, S,%`The rerrgument%f meansf0: no Joutput (default11: commandsPonses butbody text etcs2: alsoDraw lines before stripp$XCR/LF=G\_CpasvY:valWUse passive or act mode for data transfersWith a false amQ, usenormal PORT L9?tru8DPASVl.b = val# Internal: "1" aT!ng3ing6$f (s[:5] in {'w ', 'PASS '}H i Qn(s.rw('\r\n'&sS+ '*'*(i-5) + s[i:]&r&~repr(s)Psend G1 tolp, appenQ CRLFT]0put. @'\r'5'\n an illegal newBcharacter shoul. beqItain5cmdSline = line + CRCLF if self.debugging > 1:&print('*put*',/sanitize(line))0Lsock.sendall!.encode( aing)) 7# Internal: 5 one command to the server (through puty(z0def1cmdc , ) $: ?cmds[areturn"W from, strippaSCRLF.Raise EOFError if4connection is closed1"geMv=file.read@.max F + 1aif len2) ><)=r ("got more than %d bytes" %A fc/gecaif notL0ine[-2:] ==  9=RU[:-2];%el=o1:] in=1=]/get a response.which may possibly# consist of multipleRs. Ra singlesng with noAUtrail2 Isasb,Bphese ar`parate '\n' characters.Qtring; G5A[3:4:'-'c 3\while1nexO ;x&}_A + ($+ @,]1[:3\& P=!= 2UbreakHn( various esindicates an$' ^3UJ1k@last! =dRc@if c{'1', '2:3'}adYN9[== '43F`_temp(7 c/'58Kperm8WSproto @voidk """Expect a response beginning with '2'.""" ( = self.get%()0if p[:1] !==:Araise error_reply(/@areturnD 9def abort(r)N@'''A a file transfer. Uses out-of-band data.OThis does not follow the procedure fromRFC to send TelnetG0IP \Synch; thatUn't seem7BworkF_servers I'veFtried. Instead, jusA!ndABOR commkbas OOB5'''Dline = b'.' + B_CRLF "if`debugg6> 1Jprint('*put urgent*',6sanitize(g)`.sock.1all!, MSG_OOB)2PmultiL7!3]in {'426', '225:6'}M_protoM1cmdOZ, cmdTSas3nd %. 0putVPx9 +@void4 ?"""expect a  [. &()s&pv, host, .EPORT36-qcurrent=+Qgivenwort number\hbytes =E.split('.']p!`[repr(//256), %]u2\"+ D qcmd = 'N','.join(9{DJF#epF On EPG?6aaf = 0f = et.AF_INETR"/ 196:2:L:= 0'`'unsuped address familyPfield3[''4af)SV), ''X|O@make8 Create a new^1 a Hjfor it?0ockqocket.cM_,(("", 0),=af, backlog=1Hname()[1] # Get1per7 host = self.sock.getname()[0] # Get proper host @if s8`af == 6et.AF_INET:&-bresp =.sendport(L , )-Oelse; /ep;timeout is not _GLOBAL_DEFAULT_TIMEOUC.set<( areturn def makepasv4))"""Internal: Does the PASV or EPSV handshake -> (address1"""c>huntrusted_] = parse227.Pcmd('&')lH_server_c_ipv4_4p: = "8qPgetpe7D@</9i3'),{aTntransfer6, cmd, rest=Noneitiate a 9Q overdata connection.f !If!3is activeAnd a+` comma nd08!!, &Pccept)u# m5 isGIpasst4asvt,Db to itbAstaraC . Either way6FQet foA*expected size o+e. The? ,pmay be  if it couldbe determined Op@al `' argument canMa string thaisa5to a RESTH is es;ially a Bmarker usedrAtell'Bskip\Aany \ uptbgiven M.]aU=$ ut , X#ocket.create_( 3lf.},H dsource=. :trya!if@9%)_0end"Q%s" %? i/ 6>cmd)c# Some s apparently  a 200 reply to # a LISTfDSTORu, beforeB150 reply  !# (and way before the 226 reply). This seems to 7# be in violation ofC protocol (which only allowsE$1xx or error messages for LIST), so we just discardFtresponse.!0if [0] == '2':#$ = self.get-()*M_!= '1MBaise_R(P Onexceptconn.closerYJelseABwithmakeport() as sock*t is not NonO%sendcmd("REST %s" %Zt/L6>cmd)# See abov`ckaddr`ock.ac"ifetimeouq_GLOBAL_DEFAULT_TIMEOUTsC.setD( ZBp[:3;150!# 1is condi al@caseoreceived a 125msize = parse150`returnW0n, + =def transfer@a, cmd,?=w)"""Like n4b) but asVaet."""j$o CqF)[0]QloginMP, use'', passwd = Aacct @'''L;, default anonymous.'''!if\[U7 4 68 / - +x6= 'y Z@in {J'-'}N1# I"re1B ftp2ord specifiewen we'll6useC@1# We don't @ any otherng becau0# -7want to remainb a ,stop SPAM%W1let@siteriminate byd,L` hostzcountry]z+@['USER ' + p[0] == '3':' resp = self.sendcmd('PASS ' + passwd)20if 1[0] == '3':T MAACCTMOacctK\!= '2Kaise error_reply(]?areturn detrbinary(, cmd, callback, blocksize=8192,>vt=None)"""Retrieve data in T mode. A new port is created for you.FArgsX : A RETR command.- $single parameterable to beed on eachEK2 of9ream : The maximum number6Pbytesn: from thej socket at one tim&[default: l]:rest: Passedbtransfer{F). :]QR T`onse ci5""" B.voivTYPE I'MBwith=) as conn while 1{7=2e.recv(ns(aif notI!Ubreak(l V# shutdown ssl layer@if _SSLS!isk and isinstance(,,&#.unwrap(v"()_lines0 = m?8, LIST, or NLST n optional "ha!Yalled:4  the trailing CRLF strippe=-`print_J/()52!ifh; 6 = } {A{u5, \T" \makefile('r', encoding=wG*fp>` = fp.@.max F + 1pif len(!2) >H1 w1rE("got more than %d z9" %Iv`debugg.?> 2pprint('*retr*', repr(line)) pif not :,]break!if3[-2:] == CRLF@Z" =.M:-2]K%elM1MO'\n'M1Mcallback l# shutdown ssl layer!if _SSLSocket is None and isinstance(conn,,)#.unwrap(ureturn self.voidresdef storbinary($ , cmd, fp, blocksize=8192, =a, rest """Store a file in \ mode. A new porcreated for you. HArgscmd: A STOR command.-@ fps-like object with a read(num_bytes) metho@: The maximum data 1 toF from fp{send ov@the ection at onc[default: XPbp: An op8al single parameterable thaHalled onBeach2 of afHi=vsent. : Passed transfercmd():R{ ^0ons&de5""":d'TYPE I'$A) as{B@ wh1"buf = fp.) p%>bufE .-all(bufXQ?bsaF@Dn(?@t 7u:Auon: while 1:  buf = fp.readline(self.max ] + 1)4if len(buf) > 0`oraise Error("got more than %d bytes" %Iunot bufe_breakbuf[-2:] != B_CRLFA if]t[-1] in* =][:-1]`C+7 'conn.sendall8 "if callback?# shutdown ssl layer`if _SSLSocket is INone and isinstance(,,)#.unwrap(breturnpvoidresdef acctY, password\'''Send new*ount name.'''Cfcmd = 'ACCT ' +H! cmd(cmd) "4nlsZ*argsRa list of files a given directory (default the current)FNLSTqfor argT:rgs^A+ ('6argd6= [{@retrs,v.append=D3dirLain long form.U4By 98to stdout5pOptiona stAumenP func%U; allnnon-empty5Ps befPiIe concatenated to>LIST command. (This *should* only be usedq a path)N`unc = Wp ifas[-1:]lPtype({g)'''U#," =C~, R  f^d = +jW7uncKCmlsd;$="", facts=[]?'''G a qbdardizlmat by using MLSDD (RFC-3659). IfAomit{Eis assumed. ""=strings representGPof ina desired (e.g. [",", "sizeperm"]).qzdgenerator object yieldupa tupleptwo elesQevery@ founaFirst element is the file name,second one!a dictionary including a variabBumber of "facts" depen'#on[ErverGand whether4 argument has been provided.85''' 1if n:self.sendcmd("OPTS MLST " + ";".join(8))?zif pathPcmd = "MLSD %s" %$4Oelse1"'lines = []Aretra(cmd, 0.ap=1for1 insq_found, _,! =*.rstrip(CRLF).partiF(' '_6entry = {}z_zsg[:-1].split(";")91keyqvalue =:"="4[key.lower()] = A ryield (4!) !`def re(\`, from@, toA'''R+! a.Ypresp = EJ'RNFR ' +Vixsp[0] != '3'raise error_reply(a?breturno1voiQ'RNTOoddelete!il D#ADELEl)P0:3]{'250', '200'}? 33cwd1dirg'''Change to yrectory3if :{ == '..6tryRLCDUP(Sxceptperm as msgR if.args[0][A;500+el 6 '.' # does nothing, but could ^A'CWDM47cmdh?siz Retrieve0izel# The SIZE commis definedsRFC-3659A0,21R[3:].1Wint(s/mk HMake,its fullJ ~}9'MK# fix ar non-compliant impleQas such as IIS shipped  # with Windows server 2003#if not resp.starts3('257'):'Qreturn ''parse257(F!) def rmd(self, dirnameQ'''Remove aectory.']A.voidcmd('RMD ' +3Qm"pwm dcurrent working?rZsp = rQPWD')'# fix around non-compliant implementations such as IIS}Aquit - Quit, and close the connec +GQUIT,HJ(A3*%0 Cout assumQanyth b)it:tryDfile .y = None1if !is4 [B".kfinallDsock l " import ssl except IRError_SSLSocket}OelseEssl.,class FTP_TLS(FTPAB sub(0whi%dds TLS sup!to'as describin RFC-4217.svCpusual to K!21icitly secur+0FTPEtrol{ before authenticatingsSL@dataM, requires userCexpl5askpfor it by callprot_p() methodqUsage exai>>> from ftplibj'Ptps =\'ftp.python.org-.login() #  anonymously previ Y0conQv channeY'230 GuestIok, access}1tries apply.d0 #  chXy+e '200 Prot level set<Pfretrlines('LIST'6ist4tN|%lynutotal 9`drwxr- 8 roota wheel  1024 Jan 3 1994 .A 1024 Jan 3 1994 .. `drwxr- 2 rootQwheel 1024 Jan B?binC-6etcC2-wx2ftp{Sep 5 13:43 incomingHE1r-xHaNov 17_3 libCa6 109413 19:07 puC3T5usr`-rw-r-C312 Aug 14 welcome.ms '226 Transfer complete.'l>>> ftps.quit()'221 Goodby/#'Gssl_version = ssl.PROTOCOL_TLS_CLIENT ;def __init__(self, host='', user apasswd 1accAkeyfile=None, certbontext@ timeout=_GLOBAL_DEFAULT_TIMEOUT, source_addressK? *,Nencoding='utf-8'):(Bif c is not S and  <raise ValueError("OC arguments are mutually "O "exclusive"&s)DC\5 or- import warningsE. $("le deprecated/ av"custom3nstead", DLBionW:, 2Y.=_ #= % _create_stdlib_.+Bn = H$==$ = =_prot_p = False!uuper().2r,  ,   %, l )d login(self, user='', passwd Aacct secure=True): 2if  and not isinstance(self.sock, ssl.SSLSocketDO+iauth()`return super().login( , %) 6Adef IS j'''Set upcontrol connection by using TLS/SSL.''']/if$ raise ValueError("Alreadq"^Dpsl_vers!>=MPROTOCOL_TLSpresp = .voidcmd('AUTH'eOelseB;SSLBgsWext.wrap_)et erver_hostname=@ DfileWJP.make(mode='r', encodingI MI ,1ccc+ witch back to a clear-text1 9(',L (%?CCC Q unxY /oprot_p2 ]@data)Z ! #  defines whether orHBthe Bhannel is0be iected.# Though RFC-2228Zfour possibl?L{levels,G@ 4217 only recommends two, C|Private!(C) means that nox6ityused on the"-c#, n YPY,. Ixshould ;6'}raise error o(s IC __all__.append('FTP_TLS'7Q`s = (E[C, OS 3EOF qssl.SSL) _150_r7`None parse150@'''P the '150' onse for a RETR request.tR s3expected '@ or x;!isIguarante.oJbe presenf150 messagem1'''+"!=zRreply:sglobal $if1 isKimport re*]: = re.compile(" r".* \((\d+) bytes\)"(.IGNORECASE |CRASCII4m =g.match!if6mZint(m.group(1)?2272227bU =227KPASVs if it doe ain '(h1,h2,h3,h4,p1,p2)B0 ('i.addr.as.numbers', #) tuple.;+ !r', ' O_.sear S03 = sV = '.'.join()B[:4]w`P:4]) << 8) + 54m\ V1229Xc, peer ^9^On EP_)0||||V .numbers', port#) tuple.''' if resp[:3] != '229':raise error_reply(-) aleft =>.find('('1if X< 0: CWprotoCKrighD2)',=5+ 1N(Oz W # should contain '(|||port|)1+ 1[gO- 1]hSparts[O:Fq].split5+1]Alen(<)s5m0hos+rpeer[0] or2intO#[3dpreturn 3 , def parse257)x@'''P the '257'onse for a MKD or PWD request.This is a1/to0: a directory nameBRs{ 1 inA257 x/5713:58' ":" '' # Not compliant to RFC 959, but UNIX ftpd doe!is1dir$= [A = 5@n = fwhile i < ncLiqi = i+1Gf c == '`i >= ni"[i )-UbreakT h 1+ c2]Zrint_line(\Default retrs callbackYp70 a G^ftpcp(source, l, target `, type &I'`Copy fyfrom one FTP-instanceuanothercif notg_{' =$~TYPE ' +.voidcmd()O2 # =#27A.senTy'PASV')W7, N,#:}user must "listen" [...] BEFORE T0ing,# transfer(# So: STOR before RETR, because hereEfS"~"'t# =!T_2if 5in {'125', '150'} % s 53(1Utest('Test progra m. Usage: ftp [-d] [-r[file]] host [-l[dir]d 2p] &Q ... Ib-d dir bl list p password2'''0if len(sys.argv) < 2:#print(test.__doc__)3sexit(0)Kmport netrcdebugging = 09 rcq = None`while M[1] == '-d'G !+1?8delA(if3[:2XrX # get name of alternate ~/. A[2:]p=/`= FTP(!Uftp.set_alevel( A"userid = acct = ''V6tryRobj =(Pexcept OSError;2if 'q is notstderr.write("Could.open accountD"7p" -- us(anonymous login."6lse R,t&t,.authenticatorss=;Key@# noW!or  D&"NG (d1forZ6 in\62:]%!if!lg@dir(Y-el=# cm~B'CWDz9 %r+ ' ' +34`resp =.sendcmd(cmdp7Ppasv(2iveserverKH}-retrbinary('RETR?, \9! ybstdoutb, 1024nXquit() if __h!____main__`() """functools.py - T  @work Qwith & ions and callable objectsH # Python module wrapperL_@[C  # to allow utilities 0tendNto be added32theOmm. # Writ;by Nick Coghlan , # Raymond Hettinger Copyright (C) 2006-2013Software Foundation8See C source code8credits/c_p __all ['update_u@', ' s WRAPPER_ASSIGNME NTS', 'WRAPPER_UPDATES', 'total_ordering0Qcache mp_to_keyElru_kreduceKppartial- `methodsingledispatch* od_property'] from abc import getb_token collections(namedtuple #types, weakref # Deferred to _"()\treprlibDrecursive_#t_thread#RRLockrGenericAlias #<Q update_wrapper() and s() decorator+~:? #{ are toolsjhelp writsper funthat can handle naive introsp$  ASSIGNMENTS = ('__module__t __ Hqual0doc) '__annotaYE__')v[r@dictI\) def fdassigned = 32!):A"""U ! awlook like the"d D# Ar is(B#bed-d-originalV Qis a q namingeattributes *directlyk+k (defaultF.w)&k!of r DHAwith)correspond E~^  81"""@for c5 inW+6try value = get6(!d,D except AZErrorJApassWJelsesara!, hDC ?").((R, {})[# Issue #17482: set _Rd__ last so we don't inadvertently copy it#ion when-"__E7X(r.v=wY# Return the wrapper s8o this can be used as a decorator via partial() return wrapper def "s(!d,'+ assigned = WRAPPER_ASSIGNMENTS*Yupdat)UPDATES):PE"""Dfactory to apply >_1r()per function JA R that invokesPwith the$edL]:! argument and:s&3s()5Lremaining>s. Default@ are9=for.KTiconvenience simplifyCu4 toH Za1"""! 9 -, d=)pe  #=,,"d=Ood) #<Q total_orderTclass or#v:r # Thew wASs all1root magic method directly # rather than us}correspond1ope1. avoids possible # infinite recursionRt could occur whe$e O dispatch logic # detectmNotImpleaed res`n call'`reflec!. H_gt_from_lt(self, o*, W="' a > b. CompucKby @e (not a < b)(a != b).'3op_a= type).__lt__ 6if 2+isr|,lE9%/le%1/<=&"or (a =!k1or "==$g2> 5t HImplemented=LNotImplemented): 'Return a >= b. Computed by @total_ordering from (not a <= b) or (a = !.'Qop_result = type(self).__le__ , other)/6if 2:is r,=7notE0or sh def _lt_from_l,q= %<$a and (a !!k6 "!=g2>"6t%(gt%EA> b)(/gtIS,eJ%+o!a "oj!GIf2< H GHm+egktg%*t ing from (a >= b) and (a ! .' op_result = type(self).__ge__ , other)/'if2is NotImplemented:$Wfreturn, pe def _lt_from_g,n=})~"'R{a < b. Computed by @total_ordering e (not a "g _conver{< '__': [('__gt__', Q_lt),(}("le("leR(P(]QyEy y)eyl( &e)yylQg ( (gtyy 4, _Cg( Re)] } C(cls"""Class decorator that fills in missmethods"""# Find user-defined comparisonsthose inheri3[ object).Groots = {op for op}if getattr@, oppne) is U!}_!if&fraise ValueError('must at least one operation: < > <= >='^p = max( s)d # prefer k0 to 2e__  1e__@nameHfunc[^]<-0in s opF0.__(p__ = op o!sc cls #<Q cmp_to_key() k  er$w:vWmycmp/a=into a keycQ"K(L`q__slotsu['obj']V_init'bj=A@.obj+bj< Y %'I [) < 0S,( ret urn mycmp(self.obj, other s) > 0 def __eq__,(%):!(?retS -==T/leT,T__hash__ = NonebK tryfrom _functools import cmp_to_key except IRError:pass #<Q reduce() sequence to a single item'z: _initial_misj = object() K-Eion,#, ;=Dl3"""Biterable[C]) -> value 4Apply a 5 of two arguments cumulatively)"th$s+aN or?t!, @left6right, so as M2N. For example,lambda x, y: x+y, [1, 2, 3, 4, 5]) calc!esN((((1+2)+3)+4)+5). If\ is present, itlaced beforemM&!in!sand servesa default whe.qaempty. Ait =T()i E V = next(it)gPStopI9FtionH"raise Type(;") with noq"")'EFelseu$<f len in it0(A2, e/;b0par3%() applica@P# PurA0al, descriptor behaviour class f"""NewM"Ugiven[7keywords q__slotsw"", "args4 __dict__ weakref__"An __new__(cls, func, /, *args, **keywords): if not callable(func&raise TypeError("the first argument must beH8") cqhasattr^0, "e"fpargs = . +^sFa = {**+}5'Y self = super(partial, cls).__new__( 1.DPhJ=4 = :preturn (h`def __0__(`, /, *>T3.2t!(*5c-@recursive_repr()qualname = typeZ!__Ct@ = [I())]!.extend(%x) for x i=~Q0f"{k}={v!r}"5e(k, v):-.items()F*ifmodule__ ==ftools"N{^f!$.{}({', '.join(E)})":0 1zNduce|Kx&, X),)}@,Z  or None,1__dict__tsetstat!, xisinstance("w, tuple) xVto __maH"2lenfk) != 4 f"expected 4 1v, got {O}h,, kwds, @spac fNif (~Q+5 orA@ (e1 isA and @$ , ,))@E )J invalid [@ # jKin case it's a subclas!if]  $el)7b: # XXX does it need to*exactly*:?v~= i*iB= {}_nW=9z"b self.k2eywords = kwds try: from _functools import partial except ImRError7pass # Descriptor version classAmethod(object)<A"""M& d>Dwith5 application of the given argumentsSand k!. 0Sups wrapping exist m s :handles non-F`callabas instance !s.#2"""rdef __init__(self, N, /, *args, **ytif not k(5)qhasattr, "__get__"@Draise Type("{!r} iZW or ak"?q.format~"))-# could beWa like ) which isn',}# so we ca rinherit}@ (itVRifiesz%is1)JTif is,J 6# flattenis mandatory in order to plac s/ before allx[other# it's also m?efficient siSonly one@will[)edl.'! =0 "t" +2K` = {**Y.}cBelseDH:q+=zmUCreprUR", ".join(map(+!, )Y6 = 3@"{}=,"Fk, v4@for +*m^w.items(xC@_strg= "{module}.{cls}({7@}, {K&})yreturn LO=!__yR__.__&__k>clsCqualnameEF y=/= *make_unbound_6(w(cls_or_:'s)7) 5. v*&G.__isabstractB__ =A _method._partialmethod = self return _ def __get__(-, obj, cls=None):&Aget = getattr,.func, "@1", 32Presul5 ifEq is not2dh@new_Ym()A%5if (J O.# Assume `ing so new indicates theqGcreation of an appropriate callabl6(1, *rargs, * keywords~>trya0.__NE__ = except AttributeError_Epass@2if o 4@# If; underlyXdescriptor didn't do anything, tSF thie`# likeeinstance %od&._make_unbound3().J@Aertyhisabstract+I?", False)tp__classAitemo (GenericAlias) # Helper '1s dunwrap(while isM#, %R4! =ZM? #<Q LRU Cachez decorator!t:1 _l@Info.amedtuple("", ["hits", "misse `axsizeAcurr A])  _HashedSeq(listW""" This %guaranteeat hash() will bHed no more than oncXelement. Yis important becaus:pe lru_cWam the key multiple times on a 6 .2""" q__slots'Pbvalue'F_iniPAtup,=-[:] = tup.*W! =;C(tup-b! CBkey(okwds, typed,| kwd_mark = 3{ect(),)%@fast=s = {int, str}%T=k=3, len=len P"""Matpfrom opBallyR posi@ andword arguments  The key is constructed in a way thatflat as possible rather n Ias a nes>G0ure t would take more memory. 80If Ieeonly a single argument and its data typ,known to cacheK$hash value,XnKis returned withoutprapper.!isLsaves space@mprolookup speed1"""4# All of code below relies on kwds preserving order input bmse user.OFormerly, we sorted()9M0befOqloopingQe newis *much*L faster; however, it means" f(x=1, y=2) will now be treaJdistinct call from f(y=2, x=1) whichD"bed separatelys=n!if:bN +=U_markfor item. 6s():>:!if7d&``tuple(S@(v) ]vZQargs):N A 2s()Jelif len(key) == 1X|pkey[0]){s1[0]_HashedSeqU def lru_(maxsize=128,c=False-"""Least-recently-used decoratorCIf *P*0set|2Nonh LRU features are disabledh can growDbounMjdh Trs]`differ'sj For example, f(3.0)3f(3  ^!thsresultsAstd function mustI8AViewP statWcs named  (hits, misse`, curr[1 f.J_info(). Cleazg 5c,"()PAccesPe und91__w63d__See: https://en.wikipedia.org/ /C_replace_policies#__b_(LRU)(e# Users shW4 through;public APIX#" 4,  ,.'f.|0internaltencapsul8Tthread safetyZLPto al%Dia7hange (includaC version)~if isinstanceS, int# Negative maxsize is treated as 0 aif max#E< 0:=0elif callable() and isinstance(typed, bool)P## The user_function was passed in directly via theargument F,(= U, 128.wrapper = _lru_cache_(K#, _C.\Info)P.I parameters = lambda : {'&':'U"':]}Qreturn updat,4bnot Noneoraise TypeError(m`'Expec dfirst a to be an integer, aA, ore1') Ndef decorating S r*A# Co[ts shared by all lru  |s3sentinel = object()# unique_dcsignalQamissesmake_key K # build a "AfromZKPREV, NEXT, KEY, RESULT = 0, 1, 2, 3 Unames forNlink fieldsz2= {D0hit}M0fulQFalse6b_get =. pbound metho clookup3or cK5lenKp__len__Vl VqwithoutHing len(lock = RLockVpecause cedlists aren't threadsaf0roo$[]!# !ofKcircular doubly` a,p[:] = [ ,=,`# initialZ`by poirgH2elf[ ==\c(*args, **kwds/(A# No9P-- ju statisticsY5nonlocal  Y += 1PresulA  29 /:eSimpleBPorder "or[Flimidhits, misses' key = make_key(args, kwds, typed).result = cache_get(key, sentinel.3if 1eis not':Uhits += 1creturnI _misse6t= user_function(* ** [key] =j aelse: def wrapperi # Size limitedGing that tracks acceby recencygknonlocal root, :", i, full.with lockwLlink F&1if )NNoneK)# Move th Qnk to front of circular queueCma_prev,xp_next, ,! => P[NEXTPE0U[PREV00 as-2&, R&?astY9inkY&A{a w>z0if !in/P@GettLhere meansWhis sameFwas addedr#jS whil@ock <released. Sinc?inkIupdate is already done, we need onl/thp# compu1YCand ZB2cou6.MpassAelif5"Us1oldq7Bstor1newV|0old^/oo#@[KEYY*kev'QRESULx 1q# EmptyMaoldest  1 it# Keep a refereP ? to)!ent irO s from goto zero dur0. T<Twill _0pot ally arbitrary object  )# clean-up code (i.e. __del__) from running while we're I # still adjust2the links.1root = old o[NEXT])oldkey = (?KEY'PresulU*_RESULT!KW-o = NonNow update cache dictionaryAdel *[R# SavWpotentially reentrantCkey] assignment0# for last, afterB and hnbeen put inJa consiso state S]else:Mc# Put in a new1 atfront of OqueuOPREVn@ = [.,Xc, key,52ast a( =="Us. _len bound method insteadlen() fun`Swhich could 9be wrappeW an lru_x itselffull = (*() >= maxsize)creturn3 2def v_info()"""ReporListics"""<with lock9j _CqIZhits, misse,|9)rBClea  nonlocal 6 W.-`oot[:], {# =I = 0M = False!r. > $%&-R try)_qools im_t_4except I!RErrorBpass #<Q -- simplified access toPinfinity+5:% R(user*cion, /# 'S0ghtweight un"ed. Sometimes called "memoize".'x(maxsize=None)(user_function) #<Q singledispatch() -- generic decoratorB: def _c3_merge(sequences): """Ms MROs in *#c* to a u the C3 algorithm. K0Adapted from https://www.python.org/download/releases/2.3/mro/.E1"""Mresult = []while True'as for if s] # purge empty ZJfif notdrreturn 4o12P:kQfind n candidates amongbe headsGa'r = s1[0i2i ?%&ifm+Z2[1:](oMNoneM%Pbreak >arejectqcurrent, it appears laterK7elsL! Y( s raise RuntimeError("Inconsistierarchy")W.5nd(!# removeVhosenAG{!eqQ9 beq[0] ==A $0delro(cls, abcs=PCompu8m`method0oluc orderextendedlineariza&I *e* are given, works exactly likbuilt-in C3 a0 us=or |n+is a list of abstract base classes that should be insertedAinto0ing`. Unread ABCs ignored and don't end up"thFV. ThersKAwher %irpality imtroduced,.e. issub") Ds% itself but&LQFalse+0all%@ dir-. ImplicitaPK(either reg4or infer @pres specialN__len__)fly after1las2 exYs$ in"O0MROpBsaid. If two i@nextaeach oM, their orderi%ng depends on the order of types in *abcs*. """for i, base$ enumerate(reversed(cls.__!as__)):7Cif hasattr(, '__abstractmethods__'15boundary = len]E - i_.reak # Bases up tolast explicit ABC are considered first.NFelse0@ist( P) if  91 []&l 0 $[:\!])44LUotherly IH:Idif issubclassO) and not any(P3b1da ; # If *cls* is that introduces behaviour described byZA# an**, insert saidto its MRO c0.ap ,DRw.remove:c3_mros = [_ &,$==() g9s>{AM9M?J6Gqreturn Ferge'[[cls]] +v%+ c>[?E + [??<) def _compose"""Calculate} resolution a given Includes relevant2es (with ircqpective$qs) from** iterable. Ua modified C3 linearizaalgorithm` = set ._ "__1# R entries whichalready presen ? or unre<dYq3is_C(typhr3]"inn 1typ 0mro=isinstancea, GenericAliasCG@cls,);nnC"n)Tcstrict1of |(they will end up#p he9waypTtb in#es if typ != other and typ in.__mro__: return TrueBFalstypes = [n for nX if not is_strict_base(n)]M # Subclasses of the ABCs@*A* which are also implemented byF*cls* can be used to stabilizS ordering.3\_set = set(!s)0mro'#Vfound)5-0subutyp.__sF__()<-0if , n s$is6P(cls,% :>~.append([su54sub ce]@G 4mroX6typ26gcontinp# FavorAwithbiggest numberbusefulkT.sort(key=len, reverse=t_5 $cl ks^n mro&*0_c3-abcs=mro) def _find_registryA"""RPs$!matchingation from *A* !. CPWhereL@re i 1MeredQor a specifice, its methodParesolu1UP a more genericcPNote:0doe t Ekain an=!he!*object*this funcCmay CNone{1""";_composery.keys()^0 = H>Mt; "2if *it/ @a# If *%*:@icitF but"anunrelated,|# equallyu!L&1fusb tempt6to guessIAif (lt 4cls6 ; 8;#JC, t)lraise RuntimeError("Ambiguous disp8: {} or {}".format(j Ubreak9if % CA = t0{PQ.get(" dsingle(A"""S-N&decoratorPTrans6s aminto a>,3have differen>t behaviours depending upon the type of its first argument. The decoratedLfunction acts asCdefault imple:a#, and addi!al@ #s can be registered us() attribut1theLgeneric .1"""#re are many programbat use9ools without |ledispatch, so wm# trade-off mak - marginally slower for benefit ofAptart-upsuch applic>s slightly faaimports, weakref W/qry = {}_cache =0.WeakKeyDiQary()1(_token = None[Ddef Ma(cls):/]3"""_.'P -> < >[D0Runed algorithm to retur bevailableRxgiven *cls*bHon *&*.>nonlocal d(ifq is not3EucurrentU2gety* V9!= @ [1oTk.clearT' T:try`% =cU[cls]4except KeyError@ QU O!S !B`_find_ ,"ry) n! =8_J_is_valid_B)k;sinstance ,)iGfAlias)r"erC5=n k2)q;WRZqs a new+"3F!ifH I!klambda f:0Jelse@]aaise Type( ~Af"In +`B)`. 8f"{cls!r}a class./= an0get #'__annot/__', {}) if not ann: raise TypeError(!0%f"Invalid first argument to `register()`: {cls!r}. "IUse either `@;some_class)` or plain!`P@on anotated function.))y = cls # only import typing if>cion parss necessaryDEfrom;Iget_type_hints.argname, = next(iQ 4().items())A_is__dispatchu_(cls).!aneSfor { 2 is ry[cls] =if cache_tokenXNone and hasattr, '__abstractmethods__'I = n(aLg.clearbreturndef wrapper(*args, **kw~  0f'{ } requires at least 'pp'1 posi%al&')(R[0]._9__)9 4st`__', '"$leZ'Wiobject;.$Ter =  \$= 5@ry =`es.MapPProxy("X__ \hsupdate_7(,R_ # Descriptor version  0m"""Single- generic '% dU.0SupsPexist ,s6@ndle&n-`callabas instancet!s.#2"""r__init__(selfUJ0"__'_"4D "0!r} H_Fa".L` }u/@#erCcls,=3"""__A) ->=R{R\ps a new lezaL the given *cls*  *generic_methoSd*. 5""" #return self.dispatcher.register(cls, func=method) ;def __get__(<, obj, cls=None):&p*<(*args, **kw &*%- =(5[0].__class__)gAH.):_4isabstract$__.__A85)update_wrapper(8,h#@propertyQ\^Jqgetattr.l?, '', False) #<Q cached_() - computed once per instance,0@ as PibuteH: _NOT_FOUND =@ect(l&niX{l! =Gspname = 7 Q__docT. $lock = RLockZ@set_[`wner, "if{!isO EAelifW# !M Eraise TypeError(Ab"Cannot assign the s / to two different}&s MIf"({!r} and {Z!r}).5oG %if A{6 9C msg) from[4Rval =B.get<&,  0if 6'is lock:  .# check if another thread filled cache while we awaited lock ERval =2.get(self.attrname, _NOT_FOUND);0if >'is&:&i'!= [func(instanceT.?tryG[K0] =zexcept TypeErrorYmsg = (Fyf"The '__dict__' ibute on {type0.__Dd__!r} / "a does not support item assignment forYing {hproperty.huVraise,(msg) from Noneareturns__class_get __Qmethod(GenericAlias) """ Path ations common to more than one OS Douse directly. OS specific modules im4`the ap `riate ujCthis3 themselves.B3os stat __all"['prefix', 'exists getatime c m 1l 'getsiz.Pisdir7QisfilHsame Bopen E''] # D@0a pbP? # Tis falseBPdanglCsymbolic linkspsystems'a. def U s(a)N"""Test whe~Qs. R05s F~zbroken | 0os.o1(OSb, ValuEs7ATrue({follows, so both isq() and () can be tJ#MovoC0symNsFF is a regulare'_st = ,=y.S_ISREG(st.st_mode)@I# a5orylY!( #[Y'Sdir(s 2"""~2p refersx"anhOory.lsN+i:DIRi def getsize(filename): """Return the size of a ' , reported by os.stat()."""<r93Z@.st_J def getmtime{ last modification 43aZoaccess8ycmetadata change8}W # longest prefix}ll list elements.bcommon'$(mLrGiven a1pof pathsJesffE leading component^if not m: h!''v# Some people pass iu parts to operate'n OS-agnosticPfashion; don't try6ctransl8that case aat's an abus13theMpAPI andy are already dowIthey needh(be<#soM)most likely wPbe usN anPathLike object ub!s.MOisinstance(m[0], ($, tuple)2m =(map(os.fsQ, m))Qs1 = min(m2$axfor i, cAenum7(s1dif c != s2[i]{as1[:i]pAre two  buffers (obtained from1, f#@or l ) # describ@'1ame?@same*s(s1, s2@"""T~whether|reference ET +0(s1Pino = 1and'6dev'Adev)os really pointo4o(f1, f  aactual or directory This is determ!bydevice numberXi-nodBQraise]Qexcep  ifmh) call on eiS faily:'f12`  tAopenu"xBN# (Not neFBaril eptor!)|cpp ,le""" s1 = os.fstat(fp1) s22return same0&s1, s2) # Split a path in root and extension. # The is everything start at the last dotN! #aname component;/q Rbefore that} Itralways tru+ == p. # Generic implementation of sext, to be parametrized with # setors def _8(p, sep, alt ex!):y2"""I:S from\!. -EZI.AB!toend, ignoringC@leadsdots. R@s "(N,0)";@ mayempty."""?# NOTE: This code must work for texbytes styssepIndex urfind(sepj#if 0 25&U0maxQ2o )?1dot if}"> # skip all F<@file7% =BE + 1%jwhile +F  sys.argv. It suppor>!heq conveno1 asMUnix getopt() q (incluspecial mean%ofs%form `-' `--'). Long similarTthoseed by GNU software ?@usedwell via anNal third". WmA provides two qan excex4: A -- * ions gnu_getopt() -- Like get , but allow option and non- rguments to be intermixed. GFPErrorZBexceD#(class) raised with 'opt' attribute, which is the ndinvolv3Ethe U. """ # Long2support added by Lars Wirzenius . # # Gerrit Holl mo|string-baqs # to ePeter ÅstrO"Dgnu_@TODO for :S- GNU _long_only mechanism # -`callerspecify orde)RETURN_IN_ORDERWg`extens-' as first charac#of8 1?Dal aA", idouble colonSJ- anH8`a W fo8Asemi5 should # treat "-+ o""--foo" __all__ = ["@","e2","| a"] im[os try: from|Stext 1getRas _ %! I;9`# Bootpping Python:L's dependencies not built yetzdef _(s): return s  $(E)wopt = ''C6msg P_init__(self, msg,3=''?.;1msgI_"op/._]!) C3str~q0elfx! ( = # backward compatibility Z`(args,&r0s, /@opts ]s#""/"s[._P]) -> s,s`Parsesm@line$AionsGQparam plist. / @be pU!d,0outP lead7reference,7E@runnprogram. Typiy, this means "sys.argv[1:]".  lrascript wants to=recogniz7 that requireaCP(i.e.`e samemxpat Unix2 uses). If?\Bis a[#ofsXUPnamesIcj ed`%he2'--_sY ulFt:Pinclu!inx A. O2st/ 9n equal signBb('=').The return val@ue consists of two elements: the first is a list of (option, value) pairs; 2`second35 program argu_Gleft aftermUiwas stripped (thisSa trailing sliceFa). Each UQ-and- returned hasE+s as its, prefixed with a hyphen (e.g.,C'-x'), andW Xor an emptyFXng ifEehas no>c. Thes occur in2Dv same orde"Pwhich( y were found, thus allowingCmultiple]rences. LongUshortmay be m!!. A2""" opts = []ype(long`) == tA""):#a9 AOelse(WJPwhile6sargs[0].startsX('-')v != '-'a!if@0[0]('-T" =$"1:QbreakJ '-'),R` = do_srs[0][2:], -U[1:])n 'W X1X YZ7 def gnu_getopt(', B]9"""/y"s[_Y]) ->lT @func works like R), except that GNU style scann0odeQused by default. _Rmeans@#Bnon- #s Rinter BstopopprocessSs @soon&a l 3" i;Pencouk#edkI,`characS`MXs `+', orcpenviron variable POSIXLY_CORRECT/0set- en1ion=  1:_VAqif isinstancJ,a)y  ! =zCm0# As!s?0&if +!& =/D4all _R= Truelif os.k.get("OMfirst = True else:  all_options_first = False #while args3!if[0] == '--'SPprog_32 +=*11:]NRbreakaQ?[:2UQopts,N = do_longs([0][2:], E1:])|(elk1kQ' and[! P}\short~1~/[z  M& QQ  J.append('[0#* srreturn L\ def(sys.argvF, "a:b", ["alpha=", "beta"])) """Utilities to get a password and/or the current user `. get+(prompt[, stream]) - P Q , '` echo ped off.IPuser(91Getq iQ frompenviron6 ordatabase. GetPassWarning - This Useris issued whenP) canqpreventVT!of6%contentsreading. On Windows,2msvcrt module will beQ0d.  # Authors: Piers Lauder (original) # Guido van Rossum (oA supand cleanup:regory P. Smith (tty6&Fncxtlib $io $os ws __all3 ["8 ", :",""] class(!): Sunix_Z ='4: 'S=None?"""DArgs: Written onM1askthe input. Default: W :: A writable fPbjectRqdisplayN{SI#yptty. I~ is avail_d;J.stderr.GRuThe seKr3t%$1EOF:p2our*wor stdin was closed. GetPabssWarning: When we were unable to turn echo off on the input. Always restores terminal settings before returl . 81"""passwd = Nonewith contextlib.ExitStack() as s :*H6try ## try reading and wri directlytty firstDfos.open('/dev/tty', os.O_RDWR| uNOCTTY)<S= io.FileIO(fd, 'w+'&s.enter_J(tty%l MTextIOWrapper*O> Qf not stream;qexcept OSError7# If that fails, see if stdin can bejrolledgjclose( fAsys.]{.fileno9(Attributeb, Valu )Yfallback_get(prompt,L z5 = KXi>2errn<Qfd is 7 ol8os.tcgetattr(fd)S # a copy2savnew = old[:] new[3] &= ~cECHO # 3 == 'lflags'92tcs_!4 = @TCSAFLUSH4aif has-0, '/_SOFT' i|j; iIMAermiG cZ, new<<Q_raw_) K,c=EfalZ.>oldY@.flush()issue7208#foeN3if '&#  succeeded. The  jnReraisRinstead of leav nal in an unknown[*teGe@# We$'t "or. Give upuse normal IOk-# e!) |sappropriate wDz$F% " # clean up unused file objects before blocking stack.close()"passwd = fallback_get(prompt, stream) ;.write('\n'Vpreturn @wd def winT0='Pvdord: 'aq=None):fA"""P~B forNord with echo off, using Windows getwch()."""Eif sys.stdin is not!__"__l2Rc in !Fmsvcrt.pucSpw = wh12Cc = 6if c == '\r' or &n'?'_break5;003*raise KeyboardInterrupt<b:upw[:-1]/Jelse'A + c& A#pw9>warnings. Q("CanscontrolAn the terminal.", GetW>,bJrlevel=2!if[! =pastderrOsprint("c : pwinput may be ed=Mp#Q_raw_4t !9=""i!, ?u# This doesn't save$0strhi2GNU readline history. /:9!in[j#tr-if6tryO@J=except UnicodeEnJrrorD# Use replace e! handler to| as muchpossible "ed o# =!.eu(cing, 'o_? de ?4\!Sflush!# NOTE: The Python C API calls fo() (and unA) du+ *=p.i#q@EOFEh0if $B[-1]" =!rOgetuser(d1Getname fromenvironment|database.First try various 9`ables,T?JN {works on Windows as long as USERNAME is set. """ for name in ('LOG,@', '8L !):CGuser = os.environ.get(P)$0if '59areturn"# If this fails, the exception will "explain" why`import pwdV0pwdpwuid(os ))[0] # Bind` getpass toappropriate funcB tryqqtermiosu# it's possibleE renan incompat5P from&>McMillan Installer, make sure we have a UNIX-OF.tcgetattr, s N1 (I5Error, AttributeamsvcrtnIH.N= fallback_;?lse-5win(e$:u = unix!"""InternaAaliz and loc0sup @. TZmodule provides iEn(I18N)Ls(L10N) S 8your PythonUgrams by @viditterfacea0GNUttext message catalog library. e referBoperby which alxpmade aware of multiple languages. VRadaptW1of 0proT{, once &4ed,l `3cultural habits. j(# representsgof work, conions, feedM,f # suggessPp followxpeople: # # Martin von Loewis, who wrot initial implemenunderlying # C-basedRintlmQ(later reP d A), a0witskeletal #;.pyv. PePHFunkfs`.py, a%@rly lete wrapper aroundS4, #,0lsoPluded:Cure- to read .mo fil+7f #V wasn't availableJames Henstridgeayoa>$has someh erng, but currently uned experil features:S no o3a C^ cl&ikAncesP3pability1add via # a2APIBarry Warsaw#eea2se tp.~ll() APIP codepconformAll C ' 's8standards. # # Francois Pinard and Marc-Andre Lemburg also contributed valuably to this # module. # # J. David Ibanez implemented plural forms. Bruno Haible fixed some bugs.LTODO: # - Lazy loading of .mo files. Currenthe entire catalog is7ed into # memory, but that's probbad for large translapprogrampInstead,Mthe lexical sort`origintrings in GNU should be exploitedN`o do by searcheslinitializationOr you might want2useNhe undocudouble-hash algorithmPa with "atables(Oyou'll needf`study gettext coded.`- SuppuSolaris }0mat Unfortunately, we've been un Pfind y< anywhere. imr$os $re sys __all__ = ['NullT[|', 'GNUCVF', '1/0ionpinstall QdomaiHbind M__Q;setsdp]'dn  l 1 nl=lJ 2pVd n d?-] _default_localedir = os.path.join(sys.base_prefix, 'share4') # Expression parspe` selec,CThe library ss a small subseC syntax. :only # incompatidifferencejNheger literals start[pzero arrdecimalhttps://www.gnu.org/software/t/manualq.html#P-U0 # H://git.savannahPEcgit= 5tre]-runtime/intl/F .y _token_pattern = re.ile(r"""(?P[ \t]+)) | # spachorizontal tabsRNUMBER>[0-9]+\bO0 RP G_AME>n@G nyallowedIPARENTHESIS>[()]|5OPERATOR>[-*/%+?:]|[>q# <=, >=, ==, !=, &&, ||,  o# ? : 5/# unary and bitwise opsM%not allowedC(?P\w+|.){# invalid tokenE""", re.VERBOSE|re.DOTALL) def _+ize(plural) for mo in<finditer(-_pattern, 3kind = mo.lastgroup2if = 'WHITESPACES'q"continue7RvalueTP(E)V) R raVGyError('& form: %s' % wgRyield{#''EeY4"if.xreturn unexpecteOelseScend ofp') _bi_ops = (('||',), '&& ==', '!='<><>+-,*/%)`{op: i0 i,<enumerate(A, 1)( op$ops} _c2py{P: 'orm&&': 'and / C//'}aparse(s, priority=-1result = ''nexttok = 9Qwhile!G= '!~I@+= 'N H1;Rn!ifG= '(PFsub,( _]v= '%s(%s)(V, sub*kW!= ')kI 9unbalanced parenthesisB'a'el_=_c"%spE6tryqs = int(8B, 10<!gexceptt @_A) from Non dQqA (qj = 100 57in 8i =[^]Ceif i <:Ubreak+0# B chained comparisonOin (3, 4)je: # ' ?, 'p4%# Replace some C opors by their Python equivalent op!ps.get(nexttok, nexttok) Uright = _parse(tokens, i + 1/esult = '%s a' % (ra, op, R2Qj = ioif j == priority 4: # '<', '> <=1>='3\s@(%s)o "$ifOv'?' andcQ<= 0:)Kif_true0Zf!= ':'HLraise _error(Wif_falskhP%s ifVpelse %s(($, [B&if=`@treturn ] def _as_int(n)2try Wi = round(nexcept TypeE++('Plural value must be an integer, gots(n.__class__.__name__,)) from None;import warnings . ,,i DeprecationW2, 4;nwac2py(p#y """Gets a C expression as used in PO files for < !ms`1s aPython func that implemenfn equivalentp.>5"""z4leng > 100lV'('V is too long' h _4ize=u depth = 0Nc` NAif cu(LE+= 1M2if j7> 21## compiler limit,about 901# The most ;plex exao has 26[|%el)-sns = {'i$':s}"exec('''if Trueo3instance(n,bT#nZ#C@F  ''"F, ns5@ns['!']8)PRecur%#  ^@ can!Q) or !)& or('plural f= 0modifier2a[pos:]. V[:poso6|= ;Oelseb!'' d. codeset, `_ territory,,dBuagev4r$[for i in range(#+1if not (i & ~): # if all] I@thisbo exist ...sJ0val0ang 0if d) : 75+= 9 4: 97 :7 8ret.append(val0reverse(urn ret class NullTranslationst_init__(self, fp=None._info = {}Bchar7 output_$ pfallbac BPif fp)~p}Q(fp) z Fpass(Dadd_|40if J.+G.T  \4 = 5sgettexthmessag 0ret  i.UO>/l2I#, )mrwarningQ. %('H)deprecated, use e) instead',MD:BionWs6, 2j2;+ Pwith t.catch_(Kt.filter('ignore', r'.*\blgettext\b.*', DeprecationWarning)< return self._fallback.lgetq(message8#if,output_charset:YU=.encode(d 8Y4locale.getpreferredNqing()) vTdef ne, msgid1V2, n)XH`Z:if n == 1Q9-Oelse(2l{rmport wsm. &('Sc) is d'ved, useL) insteadtb6, 2i Ewithp.catch_Wings(st.filter('ignore', r'.*\bFW6ctmsg =-6(2(c nqB1p0con_#, #_ Yq`n<`BD>jdNCAinfor ._!2 $5 t < E % cJset_#, ;R DeprecationWarning, 2) self._output_charset =  (def install(0, names=None):#Nimport builtins.__dict__['_'] = L.gettext."if^ is not edhallowed = {'>X', 'l n Y;'#E 'np0% ' }<1forD in a& set( f*wgetattrN) class GNUTranslations(Nulli # Magic number of .mo filezLE_MAGIC = 0x950412deBde120495# The encodingUa msgctxt and !idp" ir#++ "\x04" +Cid (_ version >= 0.15CONTEXT = "%s94%s"Acceptablep@qVERSIONS = (0, 1)5T_get_-g@"""Returns a tupleTmajorV, min1"""D>r;# (Xt >> 16,9 & 0xffffp`*fp Override this method to supXalternativ formats.# Delay struct Aspee4up Awhen]=Q# areUused.Kfromafunpack"0ile =kPfp, ''eP3 th ile header, which consistsp5 littludian 32u# bit wordsb_catalog {%plural = lambda n: int(n != 1) # germanic *by defaulbuf = fp.read(`buflen\fen(buf# Are we big en*or?m"= o('>*sesraise OSError?C'Bad7T!',O[ ~gD5jor8"in[0' +(sion), filensame) %# Now put all messages from the .mo file buffer intowcatalogIdictionary. for i in range(0, msgcount):%mlen, moff = unpack(ii,w[masteridx: J+8])@Rend =A + N t_t_Ptrans^ ]t]? + L ]@if m"<len and 4 @sg =0[:@]U%%tm&|:T &Nelse]raise OSErroru 'Fis corrupt',n j# See if we're looking at GNU `conven s metadata N== 02# C= descripN @lastk = Nonez`b_item](.split(b'\n'\N/"= 8.decode().strip(O/pif not :!~continu # Skip over comment linesP!ifm.startswith('#-!')[N.endT gvk>`if ':'k|f0k, H%o':', 1]Z{ko.lower.]v. "self._info[k] = v*dk"Qelif #l*P] += ! +Yif k == 'ent-type'e pcharset]Z=')[1mplural-formsmdN?';'P4[1]5* = c2py( mte: we uncondi)Qally prt bothS1idsmsgstrs toyP# Uni0 us<acter encodspecified$;setL`parame:!of @ContType header. The gettext docua Ostrongly!ur0msgto be us-asct some applicNsOrequire alternative encodings (e.g. Zope's ZCML and ZPT). For # traditional gettext applica s, the msgid conversion willJ.cause no problems since us-ascii should always be a subset ofLt@charencoding. We may want to fall back R8-bitsN!ifxUnicodeifails./w= self._Aor ''/if b'\x00' in:l# Plural form\ 1,<Pid2 = s.split(Z)Sptmsg = + _r = str( #, Yfor i, xenumerate(h)catalog[[3i)]mxhNelseMI<O `# advam@to nPentryJseek table~masteridx += 8RUtransSdef l#(, messageimport warningo. %('H) is deprecated, De) instead',p D:BionWs6, 2elocaleC`missin@vobject(1dS.get(#, =3]$is #ifI kreturn'.$|s4ndoutput tpC.^e*._5q1TpreferredKqing()) 2n3J?, n= S>?A:tryOH 5!.pQ(n))]except KeyErrorT62j{if n == 1y915020 V oZ1le.getprefer redencoding()) def gettext(self, message): $missing = object()0tms:._catalog.get(F#, =31if 6$isjn2if Ofallback#kreturn'w{r3Jnsgid1, mG2, n:tryJ# =![(;"1,plural(n))]except KeyErrorT&zif n == 1x915Oelse0 20gpg0conctxt_msg_id\CONTEXT % (9w|lY ITP&, Zk Cc]  N 9k[ # Locate a .mo file uw4the strategy find(domain, localedir=None, languagesall=Fals# Get some reasonableaults for arguments that were not supplied/&if{@ is ~p = _def]_AA6= [%envar in ('LANGUAGE', 'LC_ALL MESSAGESGANG'0vals.environE(Y(fif valf =!.split(':'?+Qbreakaif 'C'O&in b^.append('CY# now normalize and exp/9 nelangs = [] for lang inauages:$ne!_expand_()*.3if -0notRP&.append()w# select afif allquresult OelseANone@p!ifmv == 'C'GQbreakCmofile = os.path.join(localedir,H, 'LC_MESSAGES', '%s.mo' % domainP%ifJrexists(b[ ;H;" rreturn 10Q # a mapping between absolute .mo  and Translation object _ts = {} _unspecified''] def 6(/%, a=fbclass_ fallback=False, codeset=p2if ;@ is k W= GNUs|INfind,R=True6#ot HNull(O" from errno import ENOENT! raise FileNotFoundError(',(,8'No fHR)',# Avoid opening, read ?@parsj'th]after it's bdq# once.! = Yrkey = (,0absNe .get(key#Nif t2:AwithX, 'rb') as fp/lsetdefauls,F(fp)p# Copy <=0 torpow settdWs2{ # output charset. All othnstance dataqshared "thbEccached|pDelay c@spee up gettextEwhenigJ@are bFusedbUaO.&(t2M  Y0war. ('paramed^deprecated'Z D'BionWk6, 2n ings.catch_():  warnings.filter('ignore', r'.*\bset_output_charset\b.*', GDeprecationWx)@.t.o(codeset2if result is None:M5= t?els%.add_fallback(ccreturnc def install(domain, localedir=#, =_unspecified, names")t = transl O$, V=TrueYa$t.b) # a mapping b/w Ss and directories _os = {}@ }6:current global{%, `messages' used for compatibility w/ GNU gettext _I_E = 'C(=_ G#if4;not8 3# =.< $Mbind !|`#if?dir2[6] =5F+C.get&, _default7__:itimport 5 . /('V)d/edI/2, 2 Cs$ifc4IF GsK7d(2try"b,)except OSErrorSut()l C , a)1/ea3 = -1* rEwithp.catch_(  paramete ""3 return message.encode( set or locale.getpreferred%ing()) with warnings.catch_1():$(#efilter#'ignore', r'.*\blgettext\b.*',?CDeprecationWb,return t.T() def dnl(domain, msgid1C2, n6tryt = translw=_.@dirs2CNone-except OSErrorSif n == 1 Oelse(2(Eleimporti. '('Nc) is dwed, uses) instead2, 2m#= <  parameter dx",=Tctmsg =t((?msgdt $.lU(kqpq0con,pT%t.  2%dn#8+AXZd_current_>/_  }b{nstead',  DeprecationWarning, 2) #bwith ws.catch_1():$(#efilter#'ignore', r'.*\bldgettext\b.*',@D,ureturn S(_current_domain, message) def n{(msgid1, C2, nQd)Q :[l3T\eimportK&. &('Ec) is dved, use) instead@2H9T~p0con](  9 n3" e3f Dt # dc) has been deemed unnec`ry and"not implemented.CJames Henstridge's Catalog couctor from GNOME sr. DocuK u8 # was: # #p0Ucat =Cj(PACKAGE, localedir=LOCALEDIR)9_ = cat.Nprint _('Hello World')The resulting9sobject ly don't supm ac1 through ab icary API, whics5ed (but appaLly unusedv2% ## = translF """Filename globbutility.""" MV4lib$os $re 0fnmzitertool*Dstatsys __all_d ["T", "i escape"]P(path, *, root_None, dir_fd= recursive=False9B"""Ra list of S!s ad atern. 0pat@ mayatain s shell-style wildcards a la>. However, unlike 3, fas star?@ dot are special cases thabed by '*'|1'?'~s5If true, theP '**'lA anysWSzero or more{e!ie!t subdir.1Nr(ir=root_dir, dir_fd=, recursive= )) def iglob(pathname, *, root_dir=None,L @%=False): """Return an iterator which yields the fs matching aw atern. OT, may contain simple shell-style wildcards a la>!fnb. However, unlike `, filewps startRwith @dot are special casea2noted by '*' and '?'~0pats&If} is true, )P '**'lVA anysWSzero or moreqectorie!t subdir.11"""sys.audit(". ",m)0//22'"D%if@.:(,^ = os.fs(DOelse1,A[:0]lit = _N", > f Vd~E _is$C[:2]6trys = next(it) # skip empty string|*Jif s@Itools.chain((s,), it%'except StopIv:ionMApasspr"it4sdironly0dirQ, basHGe.split+ighas_magicaassertm%ifi0_lexists(_joinG)8p ~-3# PF end/ slash should(WI ifS=dirT giL- "`from _92^3]F Q1Qg# `os.p2)` e argument itself a` if itp# drive1UNCp. PrevAtnfinite onCa7#gic characters (i.e. r'\\?\C:') if/Q1 != T20diridirname, root_dir, dir_fd, recursive, True) else: dirs = [dirname]if has_magic(base)5&if[ and _isl1jglob_in_dir = _2n  /1/ +'0'0for0 in sB(_join(rootI'4), ]wdironlyyield os.path.O[!, K # These 2 helper functions non-I0ly  inside a literalrectory.Ly return#Ust of2s. k 1 accepts a pattern while0 # takeg (so it  to check Gits existence). defT%1(r=_listdir9m`if notushidden(_R!(xx ="x)Dfnmatch.filter(5,3)0*iQif _l:sx/P)Qe[( 4# `split()`'s an empty'%s ending with aor#u separator. 'q*x/' should :(1dirEies.F/is]C`Follow>1arepublic but can be used by third-party codeg Ow%, None, FalseOO% O,,is)~1ly rs relativeh 9 2xQasserz}a2[:0from _rP # IfqzP is f],Pall f s AEtrue@V-"s.a 6tryAfd =-@fsen^ i0_fd;I;# iParg =`Dopen, _dir_open_flags, dir_fd=7) Yelse:Sarg =7 if isinstance(dirname, bytes)Hfsencode = os.R@eliffE = 0C(os.curdir, 'ASCII':4:try@withscandir(arg) as it(Sfor entry in!% b`if not0Tonly P@.is_}:4if 1 isJ?Non-Uyield<(.C/ W]Tl%except OSError[,EpassAkfinalld rlose(fd~return def _listl{1contextlib.closing(_iteR @ X y(it) # Recursively Ys relative paths inside a lu alQrectory.rTO=x8_ishidden(x-! xE = _join56x) Q  7_J1_fdnqdx, y) pexists(IE3_fd`# Same0os.$#.l1q), but !_f  IVz Dos.lstat (bq, Valuen~QFalseaCTrue isF/.Gv"st[n.S_ISDIR(st.st_mode), Abase_@# Ithcommon4or ,!empty if not dirname or not base3: hreturn($#os.path.join(T,N) magic_check = re.compile('([*?[])')$j_bytes*b+ def has_X2(s)if isinstance(s, Gmatch = 7k.search(s)BelseS6 0_!isLQNone _ishidden(%3[0] in ('.', b'.'[0]);recursive>CternA 0path == b'**'*)Qescaph A"""E all special characters.f1"""!# -ing is done by wrappany of "*?[" between square bracketQf# Metag1 dor@workIthe drive part and shouldn't be d) , 4 = Qsplitz z{Tqub(br'[\1]'G_.sub(@% + _dir_open_flagb|os.O_RDONLY | getattr(os, 'O_DIRECTORY', 0) __all__ = ["TopologicalSorter", "CycleError"] _NODE_OUT = -1 _NODE_DONE = -2 class _NodeInforq__slotsgP"nodeYnpredecessors4suc __init__(self, =Q# Theq this c~is augmenting-B.A! =3e# Number, generally >= 0. Whenkvalue falls to 0,N2is  edget_ready(),A`is set<U9wcePis markedh0a c!toY QLDONEH = 0@List&!s.dl can contain duplicated elemGs aslong as they'reP`reflec4iG%e l9's  [ibute2%[]s (VE+b"""Sub6of R rais P.prepif cycle ex bgraph.MIf multiple8 4p, only $undefined choice am-them willreportedRincludedexception. The detected% cycle can be accessed via the second element in*args* attribute ofexception instance and consists?aa listU of nodes, such that each@ is,0 graph, an immediate prede#or~TCnext@n2. I reported,Qfirstj3las?qwill beUsame, to make it clearQit isM1ic.2A""" pass class TopologicalS!r:$"""Provides funcAPalityot4ly sort a hashablesvdef __init__(self,3b=None)v ._2info = {}Qready#@s = @ !nedout = 0finished"if71notW}1for,Aw.items(5@add(7, *("s)1get#2Rif (result := X2+A.getc )) 0[]C] = R= _NodeInfoGcreturn(T, |"""Add a new+:itsI!toMf>0Bot0e **<Call  z`* must?.N If called multiple times wigV0rguc0setdependencies! unm0of . 8 inPpossi4Bto a+2ode9no F(0is p%d)as well ah& aKy twice. Ifo"haPTbeen Ub beforzivcluded among*pautomatb ly!edE#heqz*no0of )(ow5Raises ValueError iafter "prepare"#if=KI8ron ("(szd {aa3()"{P# Cre.8 ->G edgZ"  %,(.nb += len($Q &s_ pred_info!.successors.append(node) def prepare(self):&"""Mark the graph as finished and check for cycles in..aJbIf any% is detected, "C9Error" will be raisbut "get_ready" can#st-used to obtainmlspossible untils block moreRprogress. After a call[this function,0notbmodifiRtherefore nol 0can4added using "add".:5""" 0if ._C0is zFNonek<a ValueVP("can+)than once" =h5= [" i.i2p2info.vys() if i.nprede}U == 0M] !#  seS8iwe loocon purpos#ouser wantsQcatchf1at''e,@they continueWinstanceU@grabXf? pbq i>## =Qfind_%()#"if3(f" rea5"",VReturn a tuple of hdes that arenitially it rFs<@with ;a thoseTemarked as/B@ed b!ll0done", furfsAyx#ewsUAhave Ptheir!alv0. O+gbe madGRempty8s'ed&Rsk0ed #1out"viously&"e`() mus|ed first!Q# GetRW1ady"moresult =q 5n2iaTHhT @n2i[ ]x _NODE_OUTp# CleanP list= Vupdat*#6@coun('ofdA we _7+^g.clear"pnpassedr+= len(K] is_active(self): . """Return ``True`` if more progress can be made and ``Fals+otherwise. P7if cycles do not block the resolution] eiT%reTare still nodes ready that haven't yet been red by "get_-@" orUSnumber ofSmarked "done" is l@than7 /s lV tRaises ValueErrorgcalled without  ing "prepare" previously.c5""" if self._is None:&r(e`() mus<ed first")?Qinfinished <`passedor bool()`def __#!__%)fis_active(951, *="""Marks a setU  as ceThis method uns any suc-o0Aeach53 in0* fet@iB`futureaj8 to,v:exec:`3}ahas al%as0pro aYt,a1wasPadded&thPgraph usA"addg%if& DJfTn2i =ode2infor!inL&s: p# Checkmwe know abF:@(it ~  qFadd(T@if (: := n2i.get ))8  f"G {1!r}"FB# If1Dode b% ()@ly, !rmEFuser`astat =Q(p.nprede&or*-!= _NODE_OUTo"&N>= 0" 5! (tJ $el=ODONEe!r} was already marked done") ]else:%assert False, f"node {!r}: unknown status {9}" K# Mark the 8 as processed)info.nprede"ors = _NODE_DONEZGo to all_4suc5and reducenumber of [, collectingEIones# that are rL@to b turned incext get_%() call.JEfor 8s_u = n2i[]b0 MM-= 12&if5N== 0lBelf._s.append( ms0nfinished +def _find_cycle(*)u`n2i = .i2 9tack = [>itsAseenG&t(2-c&{}d&2it"if0in W !continuePwhile TruqSA# If we havez1 als is5the%=# current%ckPfound a  ;:0 re(h[2 r] :] + ` go onPget nkb 71P.add(8Piter(q2%].uPs).__/__H0q = len(i3y@);# Backtr!todtopmosentry with# at least anotheM?try3 = NG[-1]r!]break"except StopIterationu1delxf.pop()W' L 3Nonic_orderA"""RPs an g@able;a topological F.The particularis returned may depend on the specific order in which$items were inserted!?ugraph. >8Using this method does not require to call "prepare" or "done". If any cycle is detected, :exc:`CError` will be raised.5""" Sself.q%()awhile is_active(): node_group =+get_readyJ*yield from 5 Lj&(*") """Functions tha-ad and write gzipped files. The user ofjqn't havfworry about%compression, but random accessfallowed.>q # base-Andrew Kuchling's mini.py distribu2wit8zlib module import struct, sys, time, os1 ubuiltin$io_ __all__ = ["BadGzipFile", " @open< %de8] FTEXT, FHCRC, FEXTRA, FNAME, FCOMMENT = 1, 2, 4, 8, 16 READ, WRITE  _COMPRESS_LEVEL_FAS; TRADEOFF = 6!BE69 def ( na7mode="rb", llevel=}G,encoding=None, eEs qnewline"""Open a-k`binary@texte argument canan actual0 (a Jbytes object), oran existdX!S{#or5'to. "rC "w wN "x x aSab" fQ@ "rt0w#xt1t1  bdefaul$1 isQ"h9IFor mf?*h0valk!to B con"or X SR). InQcase,UHCEnas mustbe provid1%D, a qis crea^1wra Qin anCio.TextIOWustance ;ed P handJbehavior,{ 0 en,3(s)`if "t" Mba Value("Invalid4: %r" % (Q",)Ielse]!fArgument 'encoding' not supported in binary mode") if errors is4UNone:&raise ValueE+("Argument '<nnewlineo#=p0gz_! =.replace("t", "#if isinstance(filename, (str, bytes, os.PathLike))Q_5 = GzipFilE, compresslevel|elif hasattrx"read") orowrite"/,  , s4Typ- must be a str object,aZ1") ~`if "t"y61enc = io.text_( |Peturn*TextIOWrapper(|$, 7,#, (H)elRAa def \32u(output, vl# The L format,s the bit pattern correctly whether signed##"un.j.zquct.pack("raw = _GzipReadec'D_buffer = io.B #ed6?raw2'Z#el0('wa,x'5if S<import warnings . (#" File was aed forhing, but this will "F`changewfuture Python rexOes. :qSpecifyh(it&."F|W?, 2cy= WRITEPinit_cJEw = zlib.Dobj(  MDEFLATED<-=MAX_WBITS>=DEF_MEM_LEVELA0'I_!= t else:  raise ValueError("Invalid mode: {!r}".format(D)) =self.fileobj =  1if #8 == WRITE:?G _write_gzip_header(compresslevels@propertyB1defrPname(G)Zimport warnings0n. ("use the C attribute", DeprecationWDE, 2)GB andO[-3:] != ".gz"freturn," +&` !R>mtip"""Last2ifi ) read from stream, or None"""|_buffer.raw._last_r__repr__@s = "@ '< ' + s[1:-1] + 'ahex(id? ))'>'vBinit4",. crc = zlib.crc32(b""#size = 09buf = []?buf4`offsetL # Current for seek(), tell7etcx &*, ,l}.=(b'\037\213')# magic  C+10?H#ion methodI6try.RFC 1952 requiresFNAME field to be Latin-1. Do notSFqincludeKFat cannot?esented tha)y.Ef8 = os.path.base]Du if isinstance(Bw, bytes-V.encode('l']/.endswith(b'.gz'W F[:-3except UnilEr je = b''@flag1if ) <(>tAchr(U)Z" =nB2if %!is =.(\232ua, int(7)+%if{_COMPRESS_LEVEL_BEST}1xflFF\002J/elN/FAN4N/sev0(xfl) self. fileobj.write(b'\377') if fname:Zself.:& + b'\000') 1Bdef Z3f,data)K._check_not_closed(~$mode != WRITE@import errnosraise OSError( .EBADF, ") on read-only GzipFile object"L1if { is NonqRValuetgd isinstance(*, (bytes, garray)>length = len4<;els# accept any a that supCs the buffer protocolR3= memoryviewr - .ns  if:> 0`compress. uX*asize + 9gth crc = zlib.crc32I,?crcRgoffsetTUcreturnM(m , 7=-1JREAD%"H.C1"""Implements BVedIOBaseO#1(LtReads up to a's worth ofis negative."""N`8/1(a< = io.DEFAULT_BUFFER_SIZE?+1(Cpeeknp'Cn9@propertyeI ; :.=%o3if %/1=A;tryr=O1zflush()5write32u(fileobj, self.crc) #size may exceed 2 GiB, or even 4 <write32u(filehLS& 0xf vBelifumode == READ:^_buffer.close(Izfinally6#my# =a ]5if * Aw y = None@&!#def flush(G`,zlib_= .Z_SYNC_FLUSH)z+._check_not_d 0VWRITE@ # Ensure the compressor's A2 is!ed4|6..C.) ?+!) a QilenoQ"""Invokunderlying object'sno() method.WuThis will raise AttributeError ifYEdoesn't supporto."5""" breturnU@obj.lrewindB'''R?$un[ed stream| position indicator to`beginn*o5'''! (!X1!OS*@("CaA in  "#gseek(0readable2Q.m:;;JTrue- , offset, whence=io.SEEK_SET F1== | n#ifCG != F &g*=*>CUR*.+*OelseHBValu('Seek from end no6ed'V#ifp" <ieL'Negative  M btcount =g-g chunk = b'\0' * 1024!flbrange(Y!//)w!e([ qR%Q/O & cup 2%line(self, size=-S1):  self._check_not_closed()!rreturn (*buffer.readline(size) class _GzipReader(_compression.Dedef __init__(aC, fpsuper().$_PaddedFile(fp), zlib.d^Eobj,B qwbits=-4MAX_WBITS# Set flag indicating start of a new memberdb._new_{ = True last_mtime = None !PBrc =crc32(b""stream_siz`V0 # q1ed of unconcatenat7a_exact7, n0''' ly *n* bytes from `2fp`QyThis method is required becauseSfp may be un_&edTi.e. Phort !s.Ae6'''redata =Y&(n0while len(*V) < n Nb>& -1J-if not bCraise EOFError("C @ed f1endfore the "?"end-of- marker waWWached?U += bYE1Nr_gzip_h@magiB._fpS2 3if $Z= b'' tCFals3!3\037\213;C0BadTp'Not a pIr(%r)' %)c(w,N)truct.unpack("oneAinitMI__a(.WRN=pos/i Fc= Fals*pa chunkQ fromS z5buf!fp(io.DEFAULT_BUFFER_SIZE$un@$6or. B(bufR +0or.Xnsumed_tail !=&fp.prepend/._L /elQused_8}2# PvU al yTbyteso0objRthey can~# be seen by y _e1 e A  0if sn 1if <PraiseError("Compressed file ended before the "  "end-of-stream marker was reached") Dself._add_read_data( uncompress )*pos += len(&%greturnAjKdef ey , p+):dcrc = zlib.crc32(& , 2V._crcos_size ='+E@eof(Ep# We've-Ad totaend of , check that!;uted CRC and >9>!ed matchesEstored values. NotcRK-i;Btrue;' mod 2**32.2U1, i = struct.unpack(">> import5lib4m =.x.)+b"o/")% .(Ab'\\xbbd\\x9c\\x83\\xd1e\\xa5\\xc9 a1-(f0\\xff\\xe9'condensedplib.shaK .4'a4337bc45a8fc544c03f52dc550cd6e1e87021bc896588bd79e901e2' """ # {Qtuple__get_builtin_Op() mustmodified if a new # always available algorithm is added. __' _supported = ('md5', 'sha14224 #56 $38512', 'blake2b5 s,Vsha3_l63_2n_p/3_r shake_128t HE) s_guaranteNset( )0J/= /Qnl__ = N + ('newY'9Qpbkdf2_hmac' __builtin_constructor_cache = {} # Prefer our " implementation # OpenSSL 1.1.0 comes with a limi1 43 ofMb/s. TheD+ #_s neither ~c keyed?# (#MAC) nor advanced # features like salt, personaliz, or tree hashing.-only # variants are-$s kD andsL, thoughCblock_openssloiK} def __getq(name):B(1 = 6B.getK"7if  not Nonejlhreturn(;6try$0if in {'SHA*61'}%M imZ _NG[<][v2.7)elw!MDu?md5t9cAX_md5.3 p2SHA /24?256B0sha0256?224?056'-??~ 7SHAq8 ?512B 0512/38 ??~ l {(*b`_ .b/s/s/ D cache['sha3_224'] = _.' c/-56//56/-38^?384/<512^5512/elif name in {ke_128', e256'}:1bimport F 1j 12 except IzVError pass # no extension module, this hash is unsupAed. constructor = P.get()"8if %is not Nonehreturn(^raise Value'('type ' +) def __get_openssl_y__block2,# Prefer our builtin blake2 implementation.44/8trylMD5, SHA1, and A2 argEall  OpenSSL versM|#5q3/shake;availablE7e1.1.1+5f = getattr(_dlib, 'Kib# Allow the C6L to . The func# will bey# defined butN~,actually . Don't f wback toKj1 ifJ current security policy s a digest, bpo#40695f(usedfor=b=False1UsegCdirectly (very fast2f(Attribut,):O apy_new, data=b'', **kwargsY?"""& B - RQa newwing object us "thd algorithm; opinitialized with (which musta bytes-likeg)1"""6 ([&)  w q! lib.new(name, data, **kwargs) except ValueError:## If the _hashlib module (OpenSSL) doesn't support.WnamedE=, try using our builtin implementations.7This allows for SHA224/256 andu384/512}even thoughH library prior to 0.9.8pprovidemreturn __get__constructor( )(]r) tryC!im=qnew = _A_newZ'gxopensslg+algorithms_available = q.union(7xDlib.`md_meth_3s) I8q = NoneT/py 0### 's PKCS5_PBKDF2_HMAC requires% 1.0+ with Ffrom{pbkdf2_hmac9warningsP as _ ` _trans_5C = bytes((x ^ 0x5C)x in range(256)]6,366/366mGdef (, password, salt, iter<, dklen=)C"""P4 based key deriv8P func}@ 2 ( #5 v2.0) D]PythoToy e j%PaboutEEfastKa shsPmuch I%erK,Elong?5"""( "* ow) is deprecated.",Tcgory=D#BionWI )stacklevel=2B!Hif not isinstance7str/raise Typ-SO1, (,karray)a+memoryview(lh'd)# Fast inline 7Tinner = new?out blocksizQgetattr(R1, '_Y', 646len1 > ,+~; ).digest(_5 + b'\x00' * (m9 - D inner.update(password.transl_ s_36)) outer.upd!4U5C)) 5def prf(msg, inner=!, O=%):0l# PBKDF2_HMAC uses the s as key. We can re-use#KsameK digest objects and just P copi`o skip initialization.Lbicpy =f.copy(o  @?>msg=)(dpreturn k."mqif iterZs < 1Xraise ValueError(-if dklen is NoneC=F_sizv@M, kea5b''xloop = 1from_bytes&t.$while len(dkey) < aprev =psalt + l2.to^(4, 'big'# endianness doesn't matter herelong to / r(in(|for i in rangeK - 1C0I ##  ^ & r%=(B( +BJ`BR@![:-b] try # OpenSSL's scrypt requiresQ 1.1+O_hashlib import6 except Iap0 w__func_name__always_supJ"ed2P# try m all, some may not work due# version*ViFhat algorithm]globals()[] = __get( Pqlogging.:ion('code Vq %s wasfound.', x # Cleanup loc^ del M : 0`py_new{ %openssl_constructor """Heap queueL (a.k.a. pri^y!@). /0s aQrrayswhich a[k] <= a[2*k+1]P  2]0 all k, countelementsI 0. For, sake of comparison, non-exis;`ideredIbf`e. ThAtere9 property^0a his that a[0] is !always its smallest element. Usage: heap = [] # creates an empty (-Ppush(, item) # ,A newr on the5&! = 1pop;51ops%)Afromc <$[0# m without popping itiify(x)transforms list into a, in-place linear time!re# and return| , Wadds  #M; size is unchanged Our API differs @qextbook0 algorithms as follows: - We use 0-based indexing. This makes~relationship betwee" 5 for a nodeNeqrchildren slightly lesobvious, but more suitable since Pythons3cv) metho gQ, not`largesThese two iE0ssiqto view1eHa regularF surprises:iS.sort() maintain- invariant! """ # Original cqby Kevin O'Connor, auged by Tim Pet~Raymond Hettinger __about__ = """Hqueues [explanNFrançois Pinard] 0s are arrtwhich a[k] <= a[2*k+1]  2]> all k, counq0. For sake of comparison, non-exis; considered to be infiniteAtere9 property^ cthat aV PThe sZgYQ abovSmeantZ fficient memory representnGa tourna@numbQbeloww2`k'Z/: \ p0&1 273+4+ 56>789"10 1#12k"14B15 16 17 1D@19 2;@21 23@23 2@25 2(@27 2(29 30 IR tree, each cell `k'C`' 2'. In a usual by` we sex sports^winner ovex~R topswe can trace8F dow1 topall opponents s/he had. However, in many computer applications of such tournaments, we do not need to trace the history of a winner. To be more memory efficient, when, is promoteditry to replcit by something else at a lower level, and rule becomes th)Ecell!@two s it tops contain three different items, butZ1top9 "wins" over woI1ped s. If this heap invariaRatectedpll timePdex 0 clearly d4allW The simplest algorithmic wa6p removecand fic"next"Ge1to )X loser (let's say0 30*the diagram above) into`0 posi7n percolatis new 0 downtree, exchangvalues, untilV /re-established. TV3is %T logaoe total number of @. By0ratd e you get an O(n ln n) sort. A nice feature^Vp@6canly inser=!w fP whil"eZ<!go n,0vidgO? edpms are "better" thalast 0'th elem ex teA especially useful"Qsimul!ex2her=` holds0` incom"ev&!"Bda meansAsmalscheduled P. Wh!n L b others for execusAthey .d fu1, s!y asily go'. So, a a good strucFxtRqArs (@is waI used1my MIDI sequencer :-). Various_`0haven extensively studi0s&1, au$ reasonably speedy, Plmost0staZ|0wor0ase'wm'e}average caseperepresentj:rich are0e)brall, ye s might be terrible. Heap also verbig diskss. You Aproball knowRc3Qmplie0duc0"rua(which@pre--4ed s 1siz@1usut re#dJhe amountPBCPU 2`), foldQa mer3Rpasse6`these imerging is often very cleverly organised[1]. It is #important thaBe initial sort produces the longest runs possible. Tournaments are a good way toYuf, using allO memory available to hold a tR, you replace and percolate itemat happenB"fiacurrenDC'll QwhichQtwiceqsize of for random input, much better "a fuzzipdered. Moreover, ifb outpuA0'th on diskbget anl may not !in) (becausvalue "wins"  4ast"), it can_heap, sol  decreaseshe freed 0could be~reused immediately 3progressively build second k, grows at exactlyp same r Qfirst5melting. Wh!acomplev1hes$q switchFsstart a new run. CU quite effective! In a word,Dre useful structurT`o know%e a few applications,ppI think"isdto keep a `0' module around. :-) - [1] Theyabalanclgorithms{Care n, nowadayPre mo@nnoy:Cthan@thisa consequenc^seeking capabilitiesz \pOn devi <, like big tape driv  stXAwas ` diffe pone had-!be *ensure (far in advance)a each o@moveP will th5st "! (\4is,.st participEat "0ng"  merge). Someus were even 0read backward nd% s @alsoY@avoiqe rewinltime. Believe me, realZVwKspectacular.watch! From im7has always be Great Art!""" __all__ = ['rpush', $op 4ify 'F', P'nlar nsmallest ^pop'] defq(Aem):Ne"""Pusmaintainn9 invariant.. d()U_siftdownpR0, le G)-1)!op#!op;fheap, maintaining the heap invariant.""" lastelt =!`.pop()# raises appropriate IndexError if1 is emptyM: Freturnitema5[0]T[0] =_siftup("E, 0)P WF2 desreplaceG/)"""Pop andK"current smallest value,'1add$@new I!. z@Thismore efficiBAthanOfollowed byRush()Yacan beMEaopwhen usa fixed-siz. Note thatHed may be larger*n@! T6constrains reasonable u!ofJt!routine unless written as part of a conditional vRment:& !if|! >2[0]T#@1D? "b@=h}u.| f@pushK,Gf FaGbersion*&2 a5popJ|3<]8,:2[0]Z BVify(xTransform list into Q, in-[ O(len(x)) timen&# Qbottom-up.d0dexre's any point to look tN is)pst with`hild irange, so must have 2*i + 1 < n,L < (n-1)/2. If n0eveQ2*j, qis (2*j( = j-1/2 soH0j-16oust, whichn//2 - 1_odd = 2*j+1`Kf%+1h^/Pgain f1-1.Ffin reversed(($)#Rx, i)_uqpop_max/`"""Max S W[$LM&5ush:mPis empty  heap[0] = item _siftup_max(A, 0)rreturn /` def _%1ify11x):, """Transform list into a max0, in-place  O(len(x)) time."""FBn = pfor i iversed(range(n//2)y x, i) # 'wa' is a at all indices >= startpos, except possibly zPpos.  #F0the<ex of a leaf with a$7out-of-order value. Restore the #invariant.RCdown3pos0new! =BQ[pos]$# Follow_ path to root, moving parents e until f  ngMgQfits.Pwhile% >1{Yppos = (- 1) >> 1=#!4if w<a!# = ]w9poscontinueQbreakV8The child*!oft!ex are alreadys, and we want0mak{3ind=too. We dis by bubblfssmallerAof #u@up (fRso on{Bthat'"'sren, etc)@hittX0, #@n us to*P oddb)originally;P. # #*could* ]@ out$loop as soon!wexuos where= # both it@but sY's not a good idea`despitat # many books wrgorithm J way. Dur@pop,' last array # element e wIPtendsbe large, sAompaairagainst sT~0fro e A usu{doesn't pay (= # get u"ofuearly). See Knuth, Volume 3,zpthis isxplainedquantifi an exercise"CuT#c0sonO important, sinc esutines have no #~3extract "R0pri1y" "anWintelligenckis likelyR`be hidVin custom methods, a a=(, record) tupleCthus potentiVSensiv8On randoms;length 1000, makv ch che number `s madeAPify()Tittleose made by exhaustive # heappop() a lot, in accord with theory. Here are typical results from 3 # runs (3 just to demonstrate how small the variance is): # # Compares needed by@ify A1000$pops # -A8 # 1837 cutA16638T14996 A86803$55F1659. G14963!7834f0)T15024SP8703 Building` by usaush() !times instead required # 2198, 2148, and 2219 cox!: W ify() is more efficient, when # you can use it.The totalMlist.sort() onPsame 0s wT8627, # 8632 (this should be]dDgsum of an1): ois (unsurpriBKly!)p # for ing. def _siftup(b@, poendpos = len ) Rstart1posnewitem =Q[pos]# Bubble up"maller child until hittqa leaf.8 c 2*0+ 1{# leftmostCposition6Rwhile4"< :?#Se:!to indexn2Crigh5+ 1R5if #p2not 72] <0]j(% =Rfo# MoveBpzRd=!_)5 = n # 0 atAempty now. Put RtherebSit upIlS"inaplace (by its parents down)pX($, $O_max(@'Maxh t`'o{aaFollow pa]o roy0mov1fin!a e#RBfits>10= (w- 1) >>|1#ifx$ <ae_Nw=Ccontinue1QbreakV^'up nt of _siftu p' endpos = len(heap)Rstart1posnewitem = 'Q[pos]## Bubble up the larger child until hitting a leaf.7 b 2*0+ 1# leftmostCposition6Rwhile4<:?#Se:!to index of1Crigh5+ 1Q5if #o and not 2] <H]j% =Rfo# Move@pwQc=^)5 = l0# Tpeaf at >is empty now. Put athere,bSit upIjts final resplace (by sifits parents down)pX_8(A_max$, ,") def merge(*iterables, key=None, reverse=False)@'''M3 multiple sorted inputs into a singoutput. Similar to;(}tools.chain )) but returns a generator,LAdoesPApullBdatamemory all3oncassumes that each ofM streams is already (smallest3st)>>> list(T[1,3,5,7], [0,2,4,8 5,10,15,20B25])=[0, 1, 2, 3, 4, 5p7, 8, 15, 20, 25]LIf *key*W`applie/key funcaelemendetermineco order'dog', 'horse'@'cat@fishkangarooM4len= 2L6, ';2''' Rh = [h_append. $q_ dify =  4pop >pop "reD (Bdiref2= -Oelse"pop3eap>z1 0is 2for, it in enumOQe(map )6tryKnext = it.__ %__ ([!2(),5 * , ]4except StopI2pasf3&(hKZ) > 1C35Tru  value, order, next = s = h[0] Ryield8 as[0] =K'()@# raises StopIteration when exhaustedR_heapreplace(h, sW# restore !` condiT Ejexceptu:"cSpop(h\gmove empty i%orDJif hR# fast caseonly a singleB remainsJq Afrom.__self__cqreturn 4forit in enum`e(map(,fbles))6try 9Pit.__ r}h_append([key()) * direc,r%])C2pasbRify(h?while len6> 1 +FTrue%Akey_ M ;Q1d2 A0s[2H   Q#P=+6   # Algorithm notes nlargest() and nsmallO # = # # Make> over the data qkeepingk most extreme0s #Sa. Memory@sump is limited to Qk@>Rlist.easured performancerandom inputs:,$ number of comparisonC nKA*k- (average<q5 trial0% mthan min() # -* >---1*1- #b 1,000 1s 3,317 c231.7%G/10Gd14,046@C40.5G/10Gt105,749?5 %U7,751? 00.8G %9,401  *0.1% # # Theoretical number of comparisons for k smallestn random inputs:IStep C:n Action # ----   a- # 1U1.66 * k heapify the first k-A2/?n ->#  e remaining elements to topfP3Pk * (1 + lg2(k)) * ln(n/k) replacetopmost value onL4LGp - (k/2D final sor!k QrextremeYsBComband simplifya rough estimate givena= n + log(k, 2"og&+  )0putypsM#3:* # * ForNi-th new R fromterable,probability bei W is k/i. m_exampPQ101stMXseen iO 100g100/101.!IfGAis a c\of inserrPit in!hel`fHThe QtimesyW @(k/iO)@SummURacrosHR6n-kVZOsum(^1i ige(k+1, n+1)xThis reducoO(H(n) - H aWhere -inXharmonic6>Kd byjgamma = 0.5772156649" ^=9n, e) + 5+ 1 / (2 * n http://en.wikipedia.org/#/H_series_(mathematics)#Rate_of_divergenc * Substit{formula 33n/k0(1/e12/ 2 Worst-case A # I w9 9P datareversed` that y+ # must be" edG 4= 1w(kAlternative Algorithms # Other a, wyPnot uabecaus=a$1) Took much more auxiliary memory, # 2) Made multi(ple passes over the data. # 3) Made more comparisons in`mon ca:(small k, large n, semi-random input)R1SeebRdetailedL[0 of approach at: # http://code.activestate.com/recipes/577573-ce-algorithms-for-heapqest def n(n, iterable, key=None): """Find$n 3 elementa-Qset. 3Equivalent to: sorted(ckey)[:n]22""";# Short-cut for n==1 is to use min()2if n == 1Ait =j+sentinel = objectGPresul<^it, default=5{4turn [] if A4is 2r else []When n>=sizerp's fastq)6try3k = len except (TypeError, Attribut\K0>= d1!reR!# 0keyQnone,simpler decoration/ ifg+ju Q# putrange(n) first so that zip() doesn'tg# consume one too manyAfromV5tor:P = [(A, i)!i,>s)xV#otW`o_ify_max( 3Stop =MV[0][0iorder = Z-Jreplace = ]ra*it"ifZ< top c#, ')0atop, _$"E+= 1. [ 8qGeneral, slowest methodlH 1keyg3),  1> -68in 0k = j1k, & 1, _rvE 9 { st(n, iterable, ke+y=None): """Find the n largest elements in a dataset. 2,Equivalent to: sorted(iterable, key=key, reverse=True)[:n]@2"""I# Short-cut for n==1 is to use max()2if n == 1Pit = sx+sentinel = objectGPresul<^it, default=5Preturn [] if A4is 2r else [] When n>=size, it's faster7g6try3k = len except (TypeError, AttributApass=\K0>= d1[`!# 0keyQnone,simpler decoration/ if + [P = [(A, i)1!i,zip(range(0, -n, -1)w)t#otyhheapify(Stop =HV[0][0dorder = -._Greplace = i*it0if p<  ^#, &)0atop, _$"E-= 1 .%("- D)General case, slowamethodVH1keyg! @   ,58in 0k =2ke1k,  1, _rvE <[R( # If availw!C DA'Qfrom q$cort * aImport  ; IO_maxJ,?ifyF0?popF if __name__#"__main__":i doctest # pragma: no cover print(doctest.mod()) # pr0<"""HMAC (Keyed-Hashing for Message Authentication) module. Implements the H)algorithm as described by RFC 2104. """ import warnings/_ Q try:&_hashlib& openssl except IMRError81%q = NoneP_functypefrom _operator tcompare_digest{ R elseo 8 = . (1_sha256) # builtin -= lib trans_5C = bytes((x ^ 0x5C)x in range(])1,361/361 # The size of $s returndepends on(underlying # mQ used. Use O_bdqinstanct\Xead. / class )4""" !`. Als>mplies witha4231. This sup1APIMCryptographic > Fbions (PEP 247).FQblock@= 64q512-bit; can be chd1sub#es__slots__ = (]Y"_hmac", "_inner 2out wS3"A) def __init__(self, key, msg=F,rmod='')[}""Create a news object&Bkey: or bufferbNk>9?msg=Initial inputG\cBbmod: Adname suitable>:lib.new(). *OR*!@@~construc<MKc?;;|Requiredpof 3.8,lpite its posia aftery op/almsg argup. PassiaEword#? isF recommended, though not rTplegacy ?vreasons Y!if= is((,Cgarray)"raise Type!("raexpect0tesHA, but got %r" %al@).__#__^G |"MiJ`parame'D:'."b W and 6mod, (str, _functype)): :tryself._init_hmac(key, msg, digestmod)Fexcept _hashopenssl.UnsupportedD6_Errorp ?oldo JelseB>Gdef 8/, `$.* =O_new='J_size = ]._block1 1Z if callable(v_cons =r elif isinstancH[, strk Mlambda d=b'':[@lib.R)Wmod, h( Q2modR)&ENoneUouter^($?inn$  7 |if hasattr(c6, ''P K`y^1if 2J< 16#_warnings. (| of %d seems too small; using our 'mN 'defaultKe.' % (, /),O RuntimeW6, 2yNl]U "No7Q ibute on given object; `'Assum3"%d  F`if len2) > ;keyCkey)(K# is the .)I%is# effective as wellTpublic API.DG_=JIkey.ljust~Vb'\0'BO_ p.update3p.transl L_5C)44'364 ifW7@not  M3msg{@propertyAname8#if self._hmac:' return self._hmac.name#Uelse:81 f"-"-{9Qinner:1}" /def update(#f, msg)J"""Feed data from  into this hashing object."""Vginst =3 or ).~Acopy R a separate )? ofO#An 8 won't affect the original# Call __new__ directly[QavoidJexpensive __init__.MUother!_class__.Q$._)7.digest_sizeC-#ifr KBX(p,3 = ;1out?Non .9 = -\!._j.{. .~_current_VA for7r state.PTo be used onlyernally with () and hexTLhhqQp zhE(;CDE_valueTJgsn =as bytes. Th5 is not altered in any way by  function; you can continu{0 afBcall4is Jt+C# h&()KNELikeAb, but Jps a str ofVadecimal.@its {?ead(0) qnew(key =,mestmod=''`"""Cre[a new3 itFBkey: qbuffer,Pstart5keyX?msg9Initial input6,`?amod: A Q suitable;m@lib.u). *OR*xF# <0libXstructorSGmodule supporting PEP 247. &Required as of 3.8, despite its position after the op,alK msg argument. Passing it\a keyword#< isB recommended, though not rfor legacy API reasonsYou can now ferbitrary bytes intosbject us update()method, andP@ask yhash value at any time by calls digestOdor hex ^!s.k1"""return HMAC(key, msg,Gmod) def "!):E"""Fast inline implea_,Ckey:or buffer, Theakeyed o3?msg=Input message)2: ADname suitablee[lib.new()best performance. *OR*Nlib constructor CRa newrDPmodulPpport8$i@if _openssl isANone!`isinst(, (str, _functype)V2try  cb.hmac_M jexcept:AUnsu1edDmodErroruBpass !if_e# =|_elif ?str?lambda d=b'':h2, dFelse F=#PUinner7ublocksize = getattr(H1, '_R', 64`if lenA) > #";keyRkey).$+ b'\x00' * (N% -ev.key.transl B_36)*o* #5C**?msg@#!h 3General AionsHTML manipul.-0 im|0 re"_re from html.entiti$5' __all__ = ['escape', 'un ]4(s, quote=True5Replace special characters "&", "<"p">" to -safe sequence"If^ R flagv7`true (Edefault)e!Q marka, both dou3A (")l@Xe (')are also translated. """"s = s.replace("&", "&") # Must be done first!6<6_lt;")>gif quote:- 0'"'$R%!\'&D#x27&$return s # see http://www.w3.org/TR/html5/syntax. #tokenizing-character-references _invalid_0ref{0x00: '\ufffd', # REPLACEMENT CHARACTER-d-r)# CARRIAGE RETURN'8T@20ac+# EURO SIG!1H0x81uB2!Pu201a## SINGLE LOW-9 QUOTATION MARK333B01923LATIN SMALL LETTER F WITH HOO646B201e6ODOUBi 53"263HORIZONTAL ELLIPSIS6+0+EDAGGN$87## | %8%302cnMODIFIERCIRCUMFLEX ACCENT|993203|PER MILLEa&3016&6@CAPI8S8ECAROb9B2039EFT-POINTING AcA9015zIGATURE OE}!x85eR7#/# Zf90x8fZ9!x9$!8Dd# LEFT9@ORIGH3 3201We5ee3 TBULLEU9"13sEN DASH9#14MdSDTILD9#12QTRADE9;P9 W9 y 999 P9Du017p=9Y`DIAERE} odepoint # R01 to 8`1, 0x234567!8,,CEC!1F00xe%f!10T1U1V1W1X1Y17, 0x18, 0x19, 0x1a,bcdef(# 0x007F to #9F? 7f'!80123456789ac10x88888d9d9d9d9d9d9d$96L9h9h9h99d9d9d9d9BFDD04FDE1fdd1fdd1fdd1fdd1fdd1fdd1fdd1fddDfdd81fdd1fdd1fdd1fdd1fdd1fdd1fdd3fde&e1Leeeeeee3fdee3fdeeeee'cothers6"ff&!ff#1f 2 3 \40x4 (5 6 7 L8 (9 a b Lc (d e f L$10 f } def _replace_charref(s):gs = s.group(1)if s[0] == '#''# numeric E.21] in 'xX3num = int(s[2:].rstrip(';'), 16t)Felsen;1;7 if|_invalidsN}return &X[num]0xD800 <=Y<= 0xDFFF or>_0FFFF`'\uFFFD'Ri{odepoint'=rchr(num )# named_html5_&[s # find the longest matchingg (as defined by)standardPfor x|range(len(s)-1, 1, -1z)=!:x> $[s[:x]] + s[x: 70'&'-4  =.compile(r'&(#[0-9]+;?|Cr'|#[xX])oa-fA-F/ [^\t\n\f <&#;]{1,32};?)')unescape1"""6Convert allvPd and|~acter references (e.g. >, >`&x3e;)z@ng scorrespondqunicodeI`!s.This function usesrules defined by the HTML 5 standard for both valid and in character references,"the list ofEYonamed 7p define\ html.entities.!5.F1"""if '&' not in s:return s _oref.sub(_replace, s) """)}y.{ __all__ = ['@', '2codepoint 2Pdefs'] # maps %y .1 to0UniG Z iA = {'AElig': 0x00c6, # latin capital letLAE = igature AE, U+00C6 ISOlat1^Qacute_^1^a with 0L1LAcircK L2L 0cumflexQ2QGgrav0Q 0 k0kElpha!39\greekfa*E$39E8rin5 0o above$g;0C5Gtild3o 0L3L2uml4L diaeresisP4P3BetGP!39HAbetaD2392RCcedi@7C0lF:0C73ChiaN2chi"A7aDagger>Q0x202 double d0s3pub7$elQ0x039Lrd*D&DBgrk3E1ETHy /0d1ETHC+0DEFH9HEH0L C9 EK/caL 0 AQR8Q 08L`psilonMqxqe*G3395kk/39""E7b 7BCGamm8g*;Id, # latin capi%tal letter I with acute, U+00CD ISOlat1 'Icirc': 0x00ce, # latin capiL0cumflexQEQQgraveRQcQ 0LCL1otaJ 0x0399L\greekAiotaD33996uml<00cf< diaeresisH:0CFCKappaPk*E239ARLambd>=b=l*>BBgrk3F#Mu[#muBC:VNtild d1 N20D00D12NdLnDROElig`0x0152: igature OE~3152~2DE_/d3DO0L30D3LOK_?0d4L 0+D4QR 02meg2/3ao*E03A92pOmicronxo*G#9FmPslash>?0d8! stroke =B!O Pd00D8WOsl5l 0L5L /d6L *D6P1Phi yaPG1phi!3ACPBK03a0CB0B2rima 0x203double p = seconds = inche+JBtech%Psas9RhoQC3rho3Sca !16  %S0D!163latHSigm%s*E!3ARTHORN*E+0D%TaTL#ta"A44The;9t**39'Uacute': >0x00da, # latin capital letter U with acute, U+00DA ISOlat1 'Ucirc': 0LbL circumflexQBQ`grave'R9Q 0L9L`psilonM`0x03a5L\greeku*G03A5GCgrk30umlDcG0 diaeresisP00DCP4#XiN 4039eP!xiB039EBYF%dBYDLY?178L 3178P2.AZeta6PCzeta6<a e1<Esmala#E1ah"/e2J .,E2O"ut00b4O accent = spacing. B4G3diaGelig3e =igature a E6Ya[0Z9. d!a ;0E0g`lefsymhQ0x213Qalef symbol = first transfinite cardinalS4C NEW3lph,b+(?103B 0amp2Sampersand4!02-3numv&nd3A2227,ogical and = wedgjDtech>1222jDangl03Camso03rin2e3.] abov  "E$syQ0x224almost equal to = a'totic toJ+CamsrBtild3#" O.J@00E3J ^!0e9 \!0E@NRbdquoQ0x201: double low-9 quotation markF201Esbbs(>103B rabrvbararbroken bar = AvertT1barK*0A6bulX1202eObblack oa!022pub'ca12220intersec = ISOtech 'ccedil': 0x00e7, # latin small letter c with . la, U+00E7 ISOlat1 'KL b8Lla = spacingD B8D4diaC"ntBC"a2Crnt signw A233num3#hi23!3c[greek!hi@!3CCgrk3A3ircB`0x02c6tmodifierircumflex accentL02C63pubKBlubsL`0x2663Kblack club suit phamrockD& D2ongCp 0x2245Dapproximately equal to@0245@Ctech5opyA@00a9AcopyrighI99IBrarr9Q0x21bydownwards arrow1orn"ft= carriage retur21B5 NEW"up\i@222aunion = cup 2AQurren9 a46c(cy48$dAD!1dbdoublex01D3@3amsRdagge `0x2020x100201d;q9q<9!19je"0bieBn51lta5!3b3 Bdelt!3B!TdiamsC12661ond*66adivide=frsFiVeacut7ekee.100Ei%eceLJ.OeOGgravO.JJ3mpt|0Ce0 seCnull g@eterJ1220Bamso/4ems00Q!emEe3!00J*en2;)en2:2Qpsilo^B0x03Ge(v103BIQequiv 0261*widentic 610e103bD|Mx"thvA!0f9!th!0FD"umA ebAdiaeresisN EBN#ro acNEeuroF20ACCexis*athere g"227Efnofg1019fhook = functq= flori0192 ISOtech  'forall': 0x2200, # for all, U+ ISOtech 2Srac122@00bd2 vulgar fraction one half =W@00BDW7numV4VcV|quarterY\C\3\e\cthree Gs_ bEbsEF0044b Pslash82044 NEWQgammap 0x03b35greek small let(?@03B3wCgrk3Ce@#65Cater-than or equal toC@2265C'gtC10036greC@sign<:003ChArr=Q0x21dleft right double arrowA@21D4}Bamsa)haB9B;9;QeartsB0x26pblack h suit = valentine63pubTellipF0026Ahorizontal  sidot leaderP0026PRiacutQ0x00eZlatinqi with .I100EBlat1Qicirc!0eJ.cumflexOO5exc@00a1inverted 1amaBmarkD A1Wigrav.IE2magI/!11@capiI = imaginary partQ1211Camso-Dnfin-1221-i1ity3!21%in"2bStegra 2B3#ot03b93@iotau@03B9BRiquesx bfB> = turned X00BFXsP0208Welement of4@22084#um!0ediaeresisN100ECkappa(C03BAlOO_wardsN0ARlambd(2angIK!32@-poiHg angle brackeb!br12322quoMa L#SFquot0 = , x@guil100AlK >J+2190 ISOnum 'lceil': 0x2308, # left ing = apl upstile, U+& ISOamscEEdquoE501cEdouble quotation markE001CE3numDeA 0x2264Dss-than or equal to?0264?Ctech@QfloorDa@1ft HdownAETowastE0217Easterisk operator 17<!oz9"5cRozeng7!5Cn3pub'rm1000em{-to-right.0E NEW RFC 2070B$say`0x2039Basingle`-pointa 39 proposedYX&01^J 18JHZ3003@signI:003 2mac @00afon = spacoverline = APL !ba@00AF2diaRmdashs/1c0em 1201UEmicrA00b5 B5eRmiddoQ0x00bCle dot = Georgian commaVreek $100B`X5nus22125nus@2212"mu2103bgosmall letter mut!3BBgrk32RnablaC0 = backward differenc!20BnbspE  a0no-break2nonN@00A0nN3M(en31nY~tPgie;@220bhcontains as membei@220Bs==100ax5not100AkBotinrj2an element of1220n2sub;!28<f subse:8CamsnBtild  f1ilatin qn with .@00F1Clat1J jdJjnjD@jWoacuto.RocircJ.cumflexO#OEeligO.15igature o$152Wograv.12032Ascor1203< 'omega': 4 0x03c9, # greek small letter omega, U+03C9 ISOgrk3 'omicron': C/bfC(EcBF NEWA`plus':M`0x2295Acircled  = direct sum@%CamsbDrA0 D 28Dlogical or = vee; 28;Dtech;#df=`0x00aa; feminine ordinal indicatorE@00AAE5numDmDbDomasculEBEQslashGfKatin with stroke, = l$MFClat1VtildeiqEi.J5 J"mew 97<Qtimeszctor productI@2297I1uml@00f6IdiaeresisN@00F6NGparaNbNpilcrow sign = $QgraphHBHEpartG@2202ial differential> YRpermia0x2030?er millew 9pxaup tack = orthogo to@erpe1ula122A#hiQc0phi103C p@AA@0@vdpi symboF<03DzAlusm^z10b1Flus-minusG'or00B1Boundd!a3NI4*A342rim.\"030 = t2fee0032@~#rotA!20"Tn-ary@220FG$8pro!1dsroporti@221D:sZs26quo 1002az@ mar@APL i&{4rArQ0x21dDrightwards double arrow+1DHTradic1221fsquare root = #'alF1e BrangD!32E-pointing angle brackeVk-32M2quoNO bb MT 4- z gumpJ00BBCaC9C<9<}#ce0right ceiling, U+2309 ISOamsc 'rdquo': 0x201d, # right double quotation markF001DF3numE2ealDp 0x211cEblackletter capital R = real part symbolR011CRDamsoSgRp 0x00aeSregistered signMQtradeW@00AEWQfloorYa0x230bV5@230B5$h" 03c16greek small 0rhoA@03C1ACgrk3!lmt A@200fAe-to-left=200F NEW RFC 2070B$sa 3aBbsingle-pointing a 3A proposedZY0019Z `K1GX*sbE_low-9FAascaron&Q0x016dZlatindqs with .0+Clat2J1dotHm02c5dot operator7@22C57Camsb7&ec7@00a771secn7@00A77#hyl!0a?soft hyphe`discreG3aryL FRsigmaN`0x03c3g(B03C3ifDC2CPfinal'#maI2I!23UtildeG = varie= similar t1223CtechbSpades@2660& sP suit$pu!ub7@!28subset of3!28n3ube5`0x2286n4 or equal 86s@ 1 n-Asummz1J#upyR!28Ysuperp#p17b6cript one = Adigi;00B8up2Q5Q?twoQcquared[]8up3[[?hret5cub] ] ?K3zli>KdoLharp s = ess-z DF Blat13tau03c4J1tau.03C4Aathere4D3A@fore412234Gthet /b8u(CM03B8wtasym': 0x03Vd1, # greek small letter theta symbol, U+03D1 NEW 'thinsp': 0x2009, # thin space, U+2009 ISOpub41orn3p 0x00fez\latinzorn withx0FE ISOlat1HEildeH02dcHt602DC64dia55mes500d75multiplication sign=00D7=3num=&rar@2122=tU mark9 9BuArru'1mupwards double arroww@21D1>3amsRuacut2ax2u. .J@00FAJ4)ua99Rucircb .cumflexBGgrav6.JK"ml L a8diaeresis = Eing H A8RupsihIQ0x03d "loZ hook 2 *GE c5ER(03C5Bgrk3c%uuj FUweier!11script capital P = power set = W4strass p1211.Bamso xiv!3b xi@103ByDd*yD/#yeJt"yeb = yua !0Anymf mFAzeta03b6N(03B6B3zwjA'!00zero width joiner<@200Dz RFC 20704zwnB0>AInon-ECE} # maps HTML5 named characreferences to(equivalent Unicode/(s) html5 = {Ar'\xc1',ae,O;': -.RbreveUu0102] 3c.F223edfEee\u033GAue*H%xca+,&b4#utx2Acy?Vu0410,3AElig': '\xc6', 'aelig': '\xe6', 'AElig;c+,"afUu2061A"frU0001d504a$1ecAgraveu0ae,c%xc-.ralefsymUu2135^OlephSAlpha5039abCAmacFu010 0CamalaTu2a3f0AMP&9amp1AMP! 1Ande\u2a53H7227a&a5'ndFc0Vslopea8va&22%ngD&9a5ngl /%ms&22Fdngmsda729ab79a96cl;9ab6'9al;9ad6%9aa~%9aTangrt*21v(2bMFrtvb9s7222sf'xcDgzar5237SAogon'01 J3Aop3 5pc62240Epaci&a6$pE/&a7`&24%pi &240posD4"'"pplyFuncti`approx4:'\u&eq}CAringle7B,svc%49abTAssig6225*#?symn`Atilde6\xce,a-.3umlXeCAuml=ca*sawconinFu223w%a1rubackcon%24qUepsil4503ftEprim@0%si%23NjcBackslasA%21n6Barebarvee;': '\u22bd', 'Barwed;': '\u2306',b5&ge45brkbtfDcong3424ce3BcyD0411b3Cdquo.E201e.Tecaus%23BbTmptyvN69b0g3psi603fSernou62125lli #ta4F0392ebh.7213{Ttween&26|"frU0001d50b%1f|Rigcap7Fu22c~digcirc)5e3u33LDodot3&a0GVigopl&a0uigotime0(a06sqclaSigsta7u26igtriangledow(75bd"\(5bu4;&ve]c6wed9&2cTkarow&90lacklozen859eblUsquarq95aa]&5b> E$5lef5$Frigh%'b8n&42JElk12Flk14F7lk3H%oc`&58xnf=\u20eUnequi;261 Nen%31BBopfX%39 5L&2aRottomN)u22wti\Toxbox2'9c|4xDL65576xDl87oxd0&xd0VboxDRHY5oxDx5'xd06oxd00FboxH_n5box5BEoxHD/6H(56h0h0U`fH(56fh0h036min&29P(oxn&29)ox(2a'Ud', 'boxUl;' : '\u255c', 'boxuL;'bl'18%UR(5ar9u0Hu0'140VG1v'02%VH6&Vhv0v03H(63x6v0 02(60`'5fv0(5e01Tprime 40351DBrev602dAvbar'4xa6F br_5Bsc&12U0001d4b7IBsemiHFu2044sim623d/'2cof\+4olbC%9cubsolhsu&7c#ulFFu202TulletK $mp&24DumpE)aa{&22dBumpeq1 ITCacutK5010ch&Cadc2dcapand%a4ucapbrcuJ(a44M%a4y9cap2UcapdoV%a4CapitalDifferentialD%14Dcaps229\ufe0D7car4Scaron6502ceCayleyP%12Zch%a4CK%10c2BedilJz&ccex-.2ircEu010)cceCconin|&238&cuV'a4Eupss%a52C5010XcbxC-laecempty&9b2ent_aCtCenterD~xc'Cfc&522HcyyEu042'ch43eck/5271ocheckmar$Ch9703aJc7', 'ci r;': '\u25cb', 'circH02c6#eqH2257learrowleft"?1ba"Grigh# uUledas,29;229^Tddash|429d|CircleDoX9QBledR7;xaeSTu24c8PTMinus%29%(Pl5;GTime;GER49c35Dcire uEfnin7a1024mid47aef5sci49c2 ClockwiseContourIntegralE7232+seCurlyDoubleQuot&01x#lo( "~5lub &66%uiVColon<:4a74c+251mmaw,F2mma@p&h\u2201f1Kcompleme 66lex+%10Econgi4`d&a6Xongrui6(CoH&22/ %2"$pf xU0001d5}5pro2 Co"uclZ1OPY&xaV'95&55fb#vW<OVery@a@Dsp13@6004YFsp14Femsp3ENG5014=$enS6014unC:UEogonE1 2opf/%3c 5`$pa622dEpars%9eFeplu%71c2psi~Eu03bHVEpsil3J 4Depsi503fLceqcirce'226qcoe722535sim24\eqslantgt&a96lesEEqua'a7k2ual1=,ETild26ues'5f6uilibriu&1c%qu6226$DD&a71+qv5rar9rG%EsD2130e2e%25/E%a7]e(3Eta5039peb2ETHdm2ethf2ETHRx'(2uml<ce3Eumx)R*BeuroFu20a"xcA!R'xi0$EfexpectatimExponentialE%147efallingdotseq?]$Fc50423f4Eemale%64Tffili&fb)ff1l '\ufb04', 'Ffr;': '\U0001d509', f%23Bilig6Tufb01FilledSmallSquare$J25fc$OVery($aa($fjd%fj4latS666d+\24tns0%5bCfnof5019/3Fop 3b $57ecForAllOD2200Oforak0'd40$kv%adFouriertrFu213epartin&a0Qrac12+xbg 3Fu215F4Ff/*xb5F506I8b22'Grac2d623ea*xbF3 428b5Grac5K 7sK'042ownFu232#sc %4bWTgacut501fSGammac5039gb0d1d(13gap/52a8VGbrev1 gfpTGcedi&&01SGcircc6011 4Gcy.%41g34Gdod5012g#gEY5226Zg5226w$gE62a8e&2d&eqWB'eqnGqsla7Zeac>52aa6ges62a8o%a83o%a8&gev2db\ufe296G0dg24&22Lg6X+&im%13Y'GJ!0!'gj?g%27C$glj62aal6a5gljba(gnMunapprox28^u2269', 'gne;': '\u2a88', q6269/4sim042e7BGopfU0001d53eg5}2rav`.GreaterEqualQ_u2265ELess#+db#KFullFelD;aa2D b7?YSlantc%a7\BTilde\u2273a2scrx04|gTu210a2gyIa%a8A4a90G GT>)gt!GT!Gt6ag%Dgtcc'%aa&CgtciFu2a72tdoBWd05lPa1%99egtques36a7curapprox(86rO7u/trOreqlUYgtreq(a8 7*?gtrxvertneqdU\ufe0DgvnE:269SHacek502cDchairsp&20>3hal4xbd#UhamilX%10cHARDcyG5042Ghard4Al61d4b9%94Sharrwy521a"Ha^Zb,410fDHcir6012r \UheartF6i"uiw9\u26llif2tdhercon%2b7%Hf%108h%52HilbertSpacuhksearo)9:Jhksw'oaf4Uhomth%23hookleftarl%1a Lrigh!Hh5Sr&01orizontalLi50H7l4TslashEEstro_1 xHumpDownQ%24 )&24~Eybul%04#UhypheM%01`Iacute5\xcUie 'Iacute;': '\xcd', 'iacute;': '\xecTu2063,RIcirc*$ceie*Bx+,yVu0418W3DIdot-4130-6IEc.$15'ie32xcl&a1,2xcl[x"ffTu21d4,5Ifr1BU0001d5260Rgraver$ccieI_x-."iiEu214%Tiiiin'52a0\ &22TinfinJ'9d14ota4129SIJligD0132)ij9m-&210DImacHE012aE bguHuginaryIe gmaglin85uimagpar)SimathN6013%mo62b75ped/bisImplies621d)n&20Fncar0H %21f%ti3&9d)no+I&22rCntcaFu22bfnteger2r62O/erQIntersectioc/dtlarhkJ&a1|Tntpro~52a3InvisibleComm!6Tim%06w'IO@0C'io55Iog6012 f63IopM14 5{I5039ibbiquestbex%Is6211&4bsO6sin622fBsinEyFu22f5sinf%2ffiv1j\Dtild>6012 7Iuk0i53Iumjcfe(x)*JoEu013jZJ'\u0419', 'jcy;': '\u0439', 'JfrU0001d50dj%27Bmath6Eu023BJopfM%413 $5b9Jsc44a5j$bfGJser$08j58Juk141 5RKappaTu039a0kbv1$f01dKcedil4136kIK1a3K%0e_ 2 fkgreen'KHd2'kh4'KJ%0cxj5K%422 6 a? csClAarUEu21d-fLacutel2tlaempty529b!TlagraF5211WLambd;lbCLang727e}Tlangd/%99el727e1p/%a8LaplacetruQlaquo/%xaJLl9(lA . b[Gu21eeTrrbfs%91Hlarr$hk2'1a5rrl 14rrp&29K4simL4973t3%1a4lat/ab5Ata7291S 72aa%teaad\ufe0FB^9 )lbElbbr*&77BbracJ{-[k'V\u298Vbrksl8u#%98TLcaroO5013lbL@ &ce352lcu}L3o$dc&29Tldquo&01%01eldrdha%96Xldrus4}s621bE;': '\u2266', 'le;': '\u2264',LeftAngleBracket#97e8#Drrow8190adJleft 8A85BarWeQRight)&$c6}aEtail $a2 tCeiling)30ODoubbBDownTeeVecto8961f$ !?1c3!8959$6Floa430aharpoondown?1bd"&up c Fs!$c7!k9rCBd!_!B !m"$b$Zsquiga 494eH"&Tea:Teeta9 Y5threetime%2cA0riatH)2bT+)cf"EEqua)2b.Up)95/Up*Up)1b5b ?^ = %lE%a8>%le'2duqK7leqgUqslan%a78l $cc`%aaWlesdoGo38uG%a8x8lesU\ufe096vsapproxn5*8les'2desseqgt MALessuoGreate@#AFull'%26| >78S(aaWDssim%27F1S !FTild =Ulfish%97/lf#LfU0001d50 2l4lgE&a9H.%96Tlhard/ 'lharu;': '\u21bc', 'lharul;': 696a4blk4584CLJcyD0409'lj5L[52d8,pClarrYF21c7-Ucorne431eLleftarrow8dd496b6Tlltri%5f1cLmidotE013f1 &404ous2;23bCacheO 4nap%a8*lnapproxE&26Fn^&a8/4neq-  E4sim052e6Doang&7e/o&fd0%br.7HLongLeftA47f58 &7f?ong @`LRigheer% 07lj%J%emapstofgU!_?ong!BAloop&1a F!l@'98H"pfU0001d543+lo5Bplus8Gu2a2Ftime3?Flowa4'21[2wba_{PLower ?%191!t'19Az%5celozeng@  Fu29eYp(Ulparl&990r#crb#rh_cv`r%00'lr&2b_Esaqu&03?"scrw%12 44c14LshO1[7^%imz&a85sims'a8!qbt[(ls1%01TLstro5014l LTbGxdEu222Cmidak*SmidciFu2afSiddoto\'xb2nusFu221Uinusb92m&38Tnusdu3aM3(Plh%lcd%adC5mld&02/npGFodela3Mop4R 5%215Msc'mb4Vmstpo3`M'6039bFltim &2bquEnabl%20 TNacut5014n"Dnang220\u20d"n45napEva70\u03#Fnapi;-4b-)01SEprox%tu%66_tnatural2%11Bnbsp5aKFx&um +4eDbumpfK224fc7aTNcaro5014nTNcedi6014 =7ncocFongd]9a6d'ncup;': '\u 2a42', 'Ncy;': '\u041dn3Cdash.E2013.e6260Darhk69244Arr61d7a9%ow24dot250\u0338PNegativeMediumSpac<00b&_Thick%n$ VeryThi(enequiv6Unesea%92Unesim1,42stedGreater-6'@Less!a CwLin#nVnexisd0sI#NfU0001d511M 25ngEJ*67#ngFu227L5geq3 KUqslan=a7em%Ggs,d99%75Gm26b\u20dgf2#gtAFu226'Gt6b~hT%ceLhTapk&afi#%ni52fc[5isd-fGnC'NJQ0-j5ll90d2&02{lU61lUwLeftarrnc~ :Lrigh?sOleft"l7leq d/a7&26%Ll,d8Q Lalf6ltrre6trieuLa&mipeNoBrea01Non7ing%xa{DNopf&11Y5!otN%xaNa *vCongrue2!NotCupCap%26NotDoubleVerticalB226', 'NotElement;': '\u2209', 'NotEqual,60UTilde 42\u0338&Uxists"'04uGreater.6f .71"JFull&-67krb*6Les7DJSlan?a7eN ''75HumpDown4J *4foUnotinC&do/f59E:/f9%va Z%vb$f7t&vc6NotLeftTriangl</ea"%Ba"+9c M )ecR+6e 97 7!*6a@/ss1d* .3cNestedy.aa0*1yTnotni%209 S4dmvPrecede[8l .aa)T(2eQReverseEleNotRighb #*d0H O (2e SquareSubse8( O2'pQ9 * S3S i2\u20du" C8wSucceed A/abGQ AUu(/83$ (28  h4 ;4 4B1Not$4Vertical%22e&np9%22allel;': '\u2226', 'nparsl;': '\u2afd\u20e5t202\u0338Eolin 6a14r6'805cueeH&90dvinfin'9dl:&90'vl4il<b8&90z)vrbsG+3cwUwarhk23', 'nwArr; ': '\u21d6', 'nwarr;9/ow5nea34927KaOacuteK4xd3of,^ -.BoastUu229b[%ci429aSOcirc4of*Y%xd+,yVu041eW3Cdash.D229d.cOdblacD0150o1#iv0F2a38o9Dsold049bcSOEligD0152)oe'of[49bf0#OfqU0001d51J 2|Dogon{%2dTOgrav.Gf,E%xdo-.%og&9cJ'hb$b52ohmBFu03aJ%inE&22l.bs)ol00Scrossa529bToline0;lx%9c COmaczFu014\ iCmega^ cVOmicr%39o 7omik9Uominu2RBOopf=44 6(oplpenCurlyDoubleQuotN1 O' !IBperpEu29b8opl.O62a51&22Zr+r6%a5EordeF'13[Cdero8*u2fa#rd+xm)#rdx&igk&2b%ro'a5Eslopw%a5&or5Si%4c'$Os4 bOslashdHof,wx-.BosolgEDtild ofOE%xd- .%me,&a3A'ti+29a4COumlouml': '\xf6',  'Ouml;': '\xd6', ofBvbar+Tu233d-VOverB903eErace6d5ket(b4:Parenthesis"$dc"pr7225abBparaAx3lle*u2D2sim2Wu2af3]s1%af5par4202/PartialDJ#cyD041f1p3Bercn`%*QeriodC.%mi7030p+V\u22a+dertenk40311#PfU0001d51 23PhiJ603a{cv-dBhmmaV\u213v5honC%60CPscetchfor%2dk'piElanc/&10h&21TplankL23u+bsplusacigFu2a2Dlusb^%293 2h%do31Tlusdua&5lusQ%a7JsPlusMin5\xbd#mnZ a -B2VEustw5a27qGPoincareX&10SointiU\u2a1KBPopfUu2119e6BoundaHxP%bb[627aaz&ab5rcu&27"rEmFu2abr,&aa4rec- recapprox xeccurlyeq~rPrecede+EEquab YSlant%`ETild&27^\precn&eq9b962e8(ecEPrim0 4p5m(rnnneProduc/2fprofal'32dofline;': '\u2312', 'profsurf;': '\u2313p421dProportion.37%al<opropto5sim$7ePVprureJ$b0BPscr0U0001d4abp$c52Psi5Tu03a8pcEuncs%00)Qfz4514Iq2CqintzD2a0c15Qopz411aq%56dqprimeK%05zQafq%c6juaternionsT%10Hquat18"es?KTesteqG425f@QUOT_"Iquot"9 # CrAaryEu21d5rac23d\u0331jTRacut5015r#QradiczF\u22raemptyv%9b)DRang'7e9Trangd/%99729a5ngl'7eI0quoG7\xbu#quaR;aE(rAR5rra'974rrb*1efY&92y5arre%93JGrarr11@%hkda+l1p:)94m%97&t3L)1aw99WrAtaiJ*ra#tiEu223i raj%alF''RB&91^ 0(rb0Erbbr\&77b\}-]k&98Vbrksl8u:%99ERcarZ5015vrERcedl6015; +5rce15230J2rcu3Rcy'044Crdca-&29erdldha&96od6u20%r1 $shb1|&11|e11c', 'realine;': '\u211b', 'realpartcsdc/%5a1REG_6xae*g2REGS ' ReverseElemeno%20!quilibriumDLu21c%>UpE'596fEfishe%97drfloorY3~f&112U0001d52b%Ha15964yDhard_81c1u0l%96z3Rho703aG]%ov-f-RightAngleBracke47e9$CrrowAI2192adr^  :A:B'91e5Z ALeft cMc5tai%91a3GtCeiling@*30ODoub7DDownTeeVect%957'% "%1c "*95FQharpoondownF#&up!O!Aleft T"G$| G[Qsquig#93%Te*2a,:Tee)a6~threetime%2c@Tria*2b: dL CEEqua*2b.Up%94+I/Up +Up^bxC 5-#!*1c ?rCD02darisingdotseqW&2565lar1f'lh%rl%00!Urmous%3b5achF5nmik%ae,6roa%7e(rof04brk%7e6rop&984opf/'11_,6&Eoplu'a2{ &a3XoundImpli970', 'rpar;': ')', 'rpargt;': '\u2994Upolin5a12Drarr341c9Rrightarrow$dbdrsaquo403a6RscN10U0001d4c72hH41b1/rs!qb-](1Ursquo0QthreeEe\u22ccJVtimesDrtri&5bb6triH&b5H6rif08lK49ceRuleDelayed9&9fUuluha&96Sx/%11MTSacut5015s)sbD1$Sc_%ab's&27B6cap,cScaronD0160sDsccuF227d1EG52ab%sc,%ab]cScedil/5015sf^DScir7015 n17scn6_cscnsim522eC,sc3437yI704274%do%2cBsdotFa/P6Searhkv6292I'eA;d(seS9O!ct%xa3sec m;)7esw2]fetminu1$tm(22xsEu273/#Sf}51 3Usfrowd%32pEshar,&66FHCHc7hch4S0f .ShortDownA9r!KLeft!B%mi%22<stparallez&22*\RQ ]"+Up#hy h.%xaSSigma603a c503cs1vJ3)'iml&a6%imS'24x3meq^2g&a96imgYa0', 'siml ;': '\u2a9d', 'simlEf$ne7246Dplus7a24Drarr5972l4190SmallCirclj$18sfsetminp&21Tmashpo6a339deparsl&9e4mid'222i3t.6aaa`t8aacvac\ufe0SOFTcyN604277oft4/a3olbA629cEolbaw%33BSopf0U0001d54 6OEpade%66s%ui 52255qca&29pd:293,Gsqcu77475Sqr&215qsu8%28s6291VsubseL 4RseteqY+u289Gqsupiipi8u%5aUSquargs2IntersectionW%SBEqua\$phW ! G&)Un3uar7u25/qu&19f#sc654ae c?/sm\'st%2c&St/%60.&60{traightepsil=03f"3phiX803dnk%xa4SJd8IUsubdo&abs&ubrcr%ub&288ubeHcFVubmulbc Gsubncb'ub8#)ubb8sub(4979L     Wai  :n setneqq;': '\u2acb', 'subsim;': '\u2ac7%ub)d5p3$cc'27bccapprox8ab84tcurlyeq427dSucceedsVTEqual Bimes$d72t-xbYu22a0/4bar9a31d4$nt522d04oea&92o&a4-5pboF7336&cifBTopf_U0001d54b4 6Artopfork9Fu2ad'osUtprim%03TTRADEH5122}&ra UianglK&5brDdownR65bfR5lef"%5c5t>$eq@%2b!5Frigh]b] ^d(5e[2rTminus%a3vTripleDN&0d6s&9c rihLUpeziu%%3e3TscmV&4a cCTScyh6042s47TSH0'sh5TTstro5016It5wix&26`wohead*Sarrow5219t# $%cUacutejuf,ixn-.rEu219{'uAd'ua9U5%947Ubrc0u5TUbrev&01JuvSUcircuf*+,`uE(udcbUdblac[Eu017uI6udh %96Fufis.%97!Uf'\U0001d518' , 'ufr;': '\U0001d532'aUgrave4xd9uf,I -.3uHauUu2963[Bharl-Xu21bf061be4blk05580Tlcorn:31ceL 5rop40}Dltri45f8LDUmacID016aublKaC#umxcUnderB_=Drace%3d5ket)b5<Parenthesis#&dd#%io0%2cUnionPlu4%28}5Uog450176uL2opf{i4 %66bpArrow9Vu2191ad*up4N_U\u291UkADown&tcKp9Jdown|d.up<Equilibriumz%96nupharpoonlef# Grigh!ApperLeft9@perRV "7s!503dP'upDh/VUpsilR'3a: LEUpTe22 #up!&1cr;#u; ;tTUring1 )urk]sj;&4b c5tdo %2f3TUtild66016 uYTu25b4Duuar2\3Uumdf(6x)*duwangl529aUvangr%99]Kvarejfjvarkappai6u036vvarnoth82208'ph Uvarproptoj5221O'vA>@vU9hG503fvvarsigmc2', 'varsubsetneq;': '\u228a\ufe00', 'varsub%&?acb&p&K%KcKSthetaGG03d1triangleleft"O22b2"Grigh#3#DVbar:4aeb(vB8v/93Vcy60413SVDash.522as)Vd\v0 0`la5ae6$ee&2cF2]'ee%2b7vee$5a]evellip`$ee7VerJ%01v|- + )Gical&220ert2Lin 8Separato%75V>BTild? 4VeryThinSpac %00 #VfVU0001d51 3Uvltri>Ensubu82\u20dFvnsut*83BVopf;$4dhv%676proT13r9Vsc&4b[ cGRsubnE.u2A\8sup> 4> y Vv"|%2atvzigzag%99SWcircD0174-w5'ed4a5fFWedgcTw2%25KUweier%11Wd1w3W4w6jww 6u222VwreatW"w$ccE5xca{%2cx525et'xc%c'xd%5bX'1x3ExhAr%7fs8xhaX5039kxblZ})xlZm&7f33nis622fodot;': '\u2a00', 'Xopf;': '\U0001d54f',x'692lus8Vu2a01Ftime2DrArr&7fJ(ra603Xsc/44b3x&cdDqcupg%a0O9xup42Dutri15e%ve&2cGwedg0HaYacuteI%xdyf,u -.2AcyEu042'yaTYcirc/%17y7F$2by4"en%a5)"enmx)Yf551c. 3'YIr0'yi5Y5y$6a~Y8by%ce6U2'yu4"ml$fBYuml%Tu0178Yyx,Z1.(zSZcaro`fzZ1Tz3FZdot zSzeetrOEu212ZeroWidthSpac?%00QDZetah%39zbZH ez25H1G'zh8zig1Z]y>zz6 Yb;zc23zwj 6200'wnu} # maps the Unicode point toHTML entity name #"2J = {K 1Icharacter # (or a  reference ifvis outsideLatin-1 range) CdefsPfor (,A) in2.items():[1] =8%k[`Echr(-a) del0| """A parser Pand X @."""This file is based on sgmllib.py, but0API$slightly dif< t.H XXX There should be a way distinguish between PCDATA (7d #qdata --vnormal case), RCDATA (replaceable character # data -- only and entity referencesd tags are special) #g[ Y/en:. import re _markupbase from html (hunescape __all__ = ['HTMLParser'] # Regular expressions used for parsing interesting_normal = re.compile('[&<]') inKlete &[a-zA-Z#& 4P#(?:[1`+|[xX] a-fA-F]+)[^0-9') starttagopen<') piclos>oommentpr'--\s*%# Note: # 1) if you;0ngefind/attr remember to update locate0oo;O2Ooand/orC!heper willN "lode, so don't do it. # see http://www.w3.org/TR/p5/tokenization.P#tag-Yc-stateBCnameB0tag#_tolerant&r'8^\t\n\r\f />\x00]*)(?:\s|/(?!>))*') rO r'((?<=[\'"\s/])[^\s/>] =>V\s*=+\s*'0\'[^\']*\'|"[^"]*"|(?!B?>\s]*))? ur""" [@ #\ ?0 *@# opal whitespace before -TibuteQS685 # value indicatorY*(?:'[^']*' # LITA-endE;$  7;:%'"30# bl) /\sp possibly followed by a yD + )*_)? d # trailingP """,VERBOSE) endendtagX'@the 7! 5P, sec/ 8.1.2.2, does2as between #  %9L #u#ed- ) s6M:.L- = 1:N 1R"P Losll unproceu.0rawZ = ''plasttag;???interesto'= z_normalKcc_elem = Non _Rbase.dB q , P r"""Feed1CNas oftenyou want,as little/as much text4as 4 (include '\n')k.+_goahead(0ROA"""H any bufV1V_h_q:get" ~Return full source of a: '<...>'r5.Bset_9Amode{ , DB%elem = elem.lower()  self.interesting = re.compile(r'' % /cdata_elem,-1I) Odef clear_!Pmode(1!): r o}z_normal.Mnr = Nonen0# Inal -- handle p as far reasonable. May leave stateeR# and6#to be processed by a subsequent call. If 'end' isBtrue, forceF2allWas if folyVEOF marker.B7qgoahead.W, end31raw=};RUi = 0n = len(&while i < n@fXconvert_charrefs3not >Bj4.find('<', i|%if j < 0C#)we can't I the next <, either we are at5endD@# or!re's more tGincoming^latter is TM@passXO"to e_ in case2havaC# a b@ cut4@half end. Try to determine if@thisx0bef edpby look ofor anKQ& nea1| se{Y it'spa space`;gampposr('&', max(i, n-34) BCif (B@>= 0, [\s;]').search", Q)U?break # wait till@get cA YNelsecmatch  i)',  S Sunescapej[i:n])f KF*n]An%L@  G0# Ih%nal -- parse html declarations, return length or -1 &terminat# See w3.org/TR/M5/tokenizO.#markup-g-open-statJBalso_,R in _C2bas03def)a.(.[i:i+2] == 'B 'h_&)''if=4i+4~6--'e# this case is actually already d2lgoaheaccomment(M3[O`ed_secNV 9].lower()m{doctypeda# find-closing >~Vgtpos./('>', i+9)  if gtpos == -1: return -1self.handle_decl(rawdata[i+2:P)])1G+LJelset)aparse_bogus_comment(i) Y# Internal -- * * *#, Klength or -1not terminatedMsee http://www.w3.org/TR/html5/tokenization.#l-la-stateK2def 0, ivport=1)=0 = &.Osassert  [i:i+2] in ('', i+2%1if (OKPif re ^b a7pos_Wu?+ 1processing instr?end 0pi(?, i-`== '0if 8 _1-Aj = )v.start($pio' jB7end@lj s?tag ;$__"_text = Nonh0end6wcheck_for_whole;@_tagt/3if 6?< 0W62[i:O]@R# NowcP the w between i+1 and j into a tagUattrsU = [] =1_tolerant.h1#/, kt 2@last)group(1).lowerfwhile k < @m =  kf> JUbreak7\@name1st,lPvalue.o, 2, 3eNresthVF sFelifh@[:1]@'\'';P[-1:]\ attrvalue[:1] == '"'Qattrv{-1:]:  5 = i[1:-1],&ifF unescape(O)Js.append(%name.lower(),g)8`k = m.5%) Qend = rawdata[k:endpos].strip(A0if +not in (">", "/>") lineno, offset = self.getposNDpif "\n"O%__starttag_textX1\3 = +] 8p.count([?Olen(v5) \1 -q_rfindqNelse /+  phandle_(i `return5posJswith('/>'# XHTML-style empty tag: Z*endtag(tags >;k if=CDATA_CONTENT_ELEMENTS~dPset_cDP_mode 7"# Internal -- check to see if we have a complete Vtag; NJPor -17$in/.2def[_for_whole_7, ibKm'Tocateend_tolerant.matchBY9Jif m7j7[0nexz^[j:j+%Z= ">"VFUj + 15if 9/9$if.7, j%Lm2m!Q"P# buffer boundaryUYv- #  bogus inputAif j > i:A[j7X3 iq p#G? of /abcdefghijklmnopqrstuvwxyz=/" "ABCDEFGHIJKLMNOPQRSTUVWXYZy/ or beforeaibute C, ore the   # '/' from a '/>' ending " return -1if j > i:30jOelse+Fi + ^!raise AssertionError("we should not get here!") h# Internal -- parseStag, end or -1 if incomplete?2def5_endtag(self, i)rawdata = .>a [i:i+2] == "3!if:gtpos = -e.end()H{tagfind.{y's0=9i+3;5n_bogus_comment(i0tag! =D.group(1).lower`# consume and ignore other stuff between(HNote: thisw100% correct, since we might have.rngs likJ@# ">, but looking for > afterYcovera# most of,Qcasesis much si 4$ =.W('>',X SU( (f"+1Z4  # script^Fstyl41if g!a/#!I!bclear_Gmode20# Overridablefinish process(of start+tag: PROCESSING = 102, 'Processing'#EARLY_HINTS$3, 'Early Hints' &P# suc8%OK = 200, 'OK', 'Request fulfilled, document followsnqCREATED?pCreatedDD1cZ, URL>RACCEP?!(2QAccepA1a,+`continues off-line+NON_AUTHORITATIVE_INFORMATION = (203'Non-Authoritative Information  from cachs_CONTENT4, 'No ContentDQ, not( VYRESETL58setOClear inpurm for furtheyPARTIALQ6;hartialSPW MULTI_STATU\207, 'Multi-StatuALREADY_REPOR208, 'Already ReporRIM_USC2uIM Usedpredirec0PLE_CHOICE!(3ple Choices'Object has several resources -- see URI listBMOVED_PERMANENTLY6 30Moved Permanently'km$p$g@FOUNA3AFoun? FtemporarilyFSEE_OTHER = 30PSee O y MMethod andLNOT_MODIFI2(30t Modifi)[ not changed since given tim%USE_PROXN0Use(xFYou must useqxy specq in Loc@ to uss thisTEMPORARPDIREC!(3TVd (8_REi)# Ri0 wP# cliQerrorBAD_REQUES4CBad orsyntax or unsup! mA#UNFZ42Una-z0No dission+sschemes_qPAYMENT$IRc!ayp.irgPcharg _FORBIDDE4Forbiddene @willS help+FOUND = (404, 'Not Found', 'Nothing matches the given URI'))METHOD_NOT_ALLOWED = (405, 'Method Not Allowe^Specified m( is invalid for this resourcengCCEPTABLEj06, AcceptableURI not avail in preferrei3mat^ PROXY_AUTHENTICATION_REQUIR7 Proxy Authentication RequirYou must a,be withpIbefore proceedingEST_TIMEOUT@8, 'kest Timeout timed out; try again later]pCONFLICV409, 'Conflict'ac2GONz10, 'Gonp longer exists and has been permanently removedjLENGTHr11, 'Length\bClient_sRy Content-7]PRECONDICFAIL12, 'PrecondiJFail in headers is fals>TY_TOO_LARG.3REntity Too LargBis too ll`2URI]1ONG&14\-Y8ongUTUNSUPPORTED_MEDIA_TYPUnsupported Media Typ@body\u16for^ED_RANGE3uSATISFI'16`ed RangeHpSatisfi0CansW qur8bEXPECT7, 'Expect !QcouldV2be tiIM_A_TEAPOU0(41I\'m a TeapoServer refusb o brew coffee because itk1a t@.MISDIREC]23MisdirecI1x!isO0 to|`duce ax5ponUNPROCESS_P = 42=!Un!ssG'+ALOCKg 42bLocked_DEPENDENCYO Dependency1NBEARL)CEarl!xUPGRADE? 42vUpgrade? ?2 A The origin s("reVto be<#alAMANYBESTSAManyHestswAuserPs&m/sF 4#'aamount of  ("rate limiting!")') REQUEST_HEADER_FIELDS_TOO_LARGE = (431,,0'Request Header Fields Too Large'+The server is unwilling to process the rRbecause its h^'xfiare too lmUNAVAILABLE_FOR_LEGAL_REASONS5Unavailable For Legal Reasons@deny"acoresource as a consnce of a lgdemand') # aerrorsINTERNAL_SERVER_ERROR500, 'Internal SZE:0gotJelf in troubleNOT_IMPLEMENTED]1, 'Not ImplementedWdoes not support this operationaBAD_GATEWAY]2, 'Bad GatewayYInvalid resp4s from another!c/proxy^GICE_f@3, 'Gice n0can duf a high loa_TIMEOUTwC4, ' TimeoutsgA didEreceive a timelyHTTP_VERSION_eSUPPOR@5, '$ Version S CtfulfilltgVARIANT_ALSO_NEGOTIATE;506, 'Variant Also NegotiatesINSUFFICIENT_STORA71507sufficient Storage7LOOP_DETEC508, 'Loop DetecaEXTEND 51ExtendedPNETWORK_AUTHENTICAT5!IR:8(51Network Authentic *ir=5!clPneedsa7,cgain nT$p') r"""S/1.1 Clibrary <,0> E`Connecg.through a numberh0"st", which define whenB mayuly makemor fetch for a particular /0. Tdiagram detail1se p transi"s:R(null1 |J | (!v!AIdle 23put .est-started90( p() )* endysK4entH/\_ &5T| get`() raise + =(R&| sv v Unread-response PIdle #[R"-headers-8]_ |\_@ ||.R!()*| putrequest()+v v  Req-started-u6 2/ / | ('() )* ends/ &?ent21  +| 9R-sent This diagram pres the following rules: -- a second  may not be  until { }G [object] canIretrievedK`Bthere is no differentiation between an L= body and aApartially  ( Note: t$enforcementvapplied by-HTTPConnecclass. Th  @ doe#t Zgstate machine, which0 imss sophisticated clientspaccelerB/kHpipeline. Cau`shouldtaken, though: QSsI0bey above patterny knowledge of)tserver'Cc4 -close behavior for certainls. For example, it isossible to tell whe%wb will i~IQUNTIL14 @ have2ad;@mean.`at furnI{splaced in4he iW0Tn tha40NOT. Logical SH !__ $__( - O--- -_CS_IDLEu None  7REQ_STARTED 7 73ENT7E 7 <_> jC C @5 CENT """ import email.parserumessageDrrno Dhttp ir-dsocket"4sys collections.abc from urllib urlsplit # HTTPM!, _headers(), and the& status code constants are # inten{ally omitted for simplicity __all__ = ["x"Re<1", BConnF", PExcepb.3Not- edUnknownProtocol?TransferEncoding9ementedFileMode?IncompleteReaoInvalidURLDImproper|ionStatFCannotSendRequest;Hu0Notpy0Bad_`usLine0RTooLoRemoteDiscN![errorJrPs"] _PORT = 80S443 _UNKNOWN = ' 'Ag1ion!es _CS_IDLE*QIdle'REQ_STARTED-started$ EN'!Pent' j hack to maintain backwardmpatibilhglobals().update(S.:.__members__)Zanother b# Mappingsofficial W3C names h = {v: v.phrase_v in .values()}maximal line length when call@read(). _MAXLINQ65536HEADERS = 100Sy/la ABNF 4://tools.ietf.org/html/rfc7230#s-3.2) # # VCHAR= %x21-7E # obs-text80-FF # p-field = -= ":" OWSSOWS #%Tu= token+O#*(-!co! /efold )1vchar [ 1*( SP / HTAB )L]?perLCRLF\" #;o|C?ing)Rsee S` 3.2.4OP= 1*t "!" / "#$%&'.*"~A/ "+-.^_`|~ADIGIT / ALPHAbR; anya1, e  delimitersxtdefinedW5234#appendix-B.10he patternsAboth Vare more lenie\nt than RFC # definitions to allow for backwards compatibility _is_legal_header_name = re.compile(rb'[^:\s]r\n]*').fullmatch B)ilDNvaluE\n(?![ \t])|\r \n])').search # These characters are notLed within HTTP URL paths. # See https://tools.ietf.org/html/rfc3986#section-3.3 and the # ;appendix-A pqPrevents CVE-2019-9740. Include~Xntrolsuch as \r\nEWe don't restrict-s above \x7f.putrequest() limits uASCII. _contains_dis qed_url_+_r'[\x00-\x20c]') # Arguably only t_should_:{ dser"^[/!$&'()*+,;=:@%a-zA-Z0-9._~-]+$"x!Wemore lenientassumed real world purposes.Kmethod names #=p Q inje=`Fc 1f_0 # lways see Content-Lengthw~as because som@serv-will otherwiseB2pon4! a 411 _METHODS_EXPECTING_BODY = {'PATCH', 'POST UT'} def _encode(data,( =' '): """Call .,"latin-1") but show a better error message."""G2tryPToreturnS/except UniEEY asbLa)(Hn2errMing, ob^start:end"%s (%.20r) isrvalid L(. Use %se('utf-8') "if you wao send it vd in UTF-8." %(.title(),X[: Bend])) from None classvMt(email. P# XXX:u of this !in#d.@.CGIRHandler. Maybe m@the rG@that @doesB@needrbe parte public API. sAPI hasFnever beenRed soc {Sa# issu@Cgeta42ingPcs(selfpp"""Findbalines ring a given header name.  Look through the list of he/s and find all lines matching a givenM4c (9their continuationCU). AkwZ%isL returned, without interpretIQ. Ifvdoes not occur, aRemptyo4is Z B9s multiple times,#rences areLbCase iimportan }5"""Z! =<.lower() + ':'"p = len(*)lst = [] hi01foru in self.keys():! !if$E[:n]~= )-b1AAelif~#[:1].isspacejAnif hitmlst.append([r! lst def _read_ Cs(fp"""Reads potentialsV2o afrom a file pop+`Lengthlimited by _MAXLINEtd number of 2HEADERS.' / whFTrueP= fp.(F + 1#"en8% >Jyraise LineTooLong("!"Nsk$)nqHTTPExcep("got more than %dAs" %Jq0ine(b'\r\n', b''Qbreakj7;Wparse;, _class=sMessageQ@"""P.s only RFC2822 Baemail <r wants to see strings ratherRbytesBut a TextIOWr r aroundrwould buffCoo many Girstream, which we lat0eedX2 as% So'Grcorrect"e here,1 , t1to iS 7h  = b''.join().decode('iso-8859-1'".v"r.|()Cstr(hA)  Response(io.B]pedIOBasP# See 2616 sec 19.68RFC 19456sdetailsS# TheDocket objaf-|32.2notes an exceptionF for MIME-encoded # text following RFC 2047. The basic status line parsing only Caccepts iso-8859-1. ^(def __init__(self, sock, debuglevel=0, method=None, url !):Cb-If the response includes a content-length header, we need toGmake sure thatSclient doesn't read mo"n"?specified number of bytes. If iG, will block untilF server times out and closestqnection0is QEhappen if a Y@.fp.() is done (with\ size) whetherF:3 buffered or not. So, no^b=qs unlesy know w_y are doing.xv= .file("rb")&(' =5 %_@# =I|THTTPR:`objectreturned viav1libm#e f#Ahttpurllib expI!di8nt attributesk7theA) used hereXsupportsgmsg isFprovided abackwards compatibility layer?!=v = IAfromS P-LinekWversion = _UNKNOWN # "-V /d.3 # m6CodM]Jreas\A # Rv-Phrase1xchunked#"!@" be?"]_leftF# "toGpin curr_; N#`X%in K_>Aconn>`p at endNC_Q= strq(_MAXLINE + 1), " pif len(1D) > 4`raise ]TooLong(" 8 N":> 0Mprint("reply:", reprg if^ =# Presumably,id\f befor`# sendMua valid (RemoteDisUBed("vX"H " response") Etry: version, status, reason = line.split(None, 2Gexcept ValueErrorU fjb1b2)"" ;# empty  will cause next test to fail.]>6'= zdif notR.startswith("HTTP/") self._close_conn(raise BadS}PLine(w%) S# The code is a three-digit number2 }r = int( $ifa< 100 orZ> 999 Adreturnj  def begin(h{zpheaders3 # we've already@rtedding theFar#3 until we get a non-QCwhile Trueu 0 = .__ KE != CONTINUE]Ubreaka# skip/Q from42Bped_1Bs = >.fpfdebuglevel > 0 pr"L1:",o W=1xsUnknownProtocol(kmsg = parse[Kt.H hdr, valnw.items(/\ zyphdr + " 7valP# are$us'chunked-style of transfer encoN?dtr_encd.get("6-6iU:Band E .lower() == "chunked":  self.chunked = True  _left = Non#_else:1QeFalse "# will the connection close ataend of response?@C_4!= b_check(()o do we have a Content-LengthV# NOTE: RFC 2616, S4.4, #3 saysB ignore this if tr_enc is "="lc /headers.get("c#%")O2if  and notw }:trylCb= int( c&except ValueErrorI B "ift < 0: # Pnnsical negativesG yUa# doesgDbody#Sfixed? (of zero+ if (status == NO_CONTENT or T_MODIFIED orud100 <=-P< 200= # 1xx codep_methodxz"HEAD")%0 sremains open,Zwe aren't using a0# aFk1wasprovided,Tpn assum1MBWILL.b5and$-$ !!is2c=FIdef WO@   @P.versZ== 11# An HTTP/1.1 proxy`H@d to3yj unles## explicitlySdT0 ifn'! ">A" inw.lower(1breturn DSome0 implementasdsupport for psNt^##s,rules differen(a,.For older, Keep-AlWindicateswm. kIaI x At least Akamai (es a "C:"" r, `which d8!se @be s bymy client1"" in conn.lower(): return False # Proxy-Connection is a netscape hack./ pconn = self.headers.get("pGG%")52if 8and "keep-alive" in?.lootherwise, assume it will closex3TruQdef _$_(&$fp%fpE$.6Non\1fp.I"()L[1U:try0sup? # set "=ud" flag}kfinallA"if*fpY}.# These implementas are for the benefit of io.BufferedR.,# XXX This class should probably be revised to act more lik;#j"raw stream" that n expectsv\\flushK q  ".0h^readablea"""Always r> s M1""":q#0EndD rmethods#r"isrc1 if*P3.p# NOTE:is possibleU"wenot ever call<J1().# case occurs whenGVTRUE, length , wGL[0 upelast byte, but p&ite#IMPLIES:`FALSE,&n ALWAYS blled, meaning?)6fulF&`, amt= : ^2b""RE4_@ == "HEAD"; FZ zchunkedP1W_'C(amtRY ifc H+(.Ramt >}" >b`# clip F""edresponse5\\Ts.X0if s0Ide , iraise Incoh te=content-u# wasn't satisfi"it might break Zatibility self._close_conn() elif self.length is not None:*5)-= len(sP&!ifC-J(!?_clreturn s;els# Amountgiven (unbounded read) so we must check^ " =D0fp.c U ]?tryNa_safe_Qaexcept IncompleteRead\dYraise I = 0  Y2#m everything;1defPinto(VF, b)0"""a up torb) bytes 2 array b an6the numbere!of-sn.E"""  fpS02_method == "HEAD"}./tXkchunke/Uk _+>(b)K$if\>1 p# clip `y `"end oysponse"9b = memoryview(b)[0:j]A!doEGuse ) here beca`this me a .willd~ # qection,!@user `ing moUUPthan I be providedO(for exay,KAain 1k n')nbl# Ideally,Oawould  1 ifcontent-Ng# wasn't satisfied, but it might break Matibility BZ EAEY -= n $  nESGR_nextQ_size`]!# \* *Q fromY6filKline(_MAXLINE + 1U"D) > % LineTooLong("H"M0 = J.find(b";f i >= 0[line = line[:i] # strip chunk-extensions Etry: return int(line, 16)!except ValueError<# close the connection as protocol synchronisai~#*bably lostyaself._b_^(araise 2def _read_and_discard_trailer(H) # *S and * *a up toCRLF terminatorfu### note: we shouldn't have anyJ%s!2while TrueJm0 = @.fp.(_MAXLINE + 1aif lenD) > ) W[ LineTooLong("c"W@not K!# a vanishingly small number of sites EOF withou# sendingX"Ybreakine in (b'\r\n', b''@DEAget___left(,Ra newJ if necessary.cr#` == 0: at0endburrent+`, needf& i1 MNone: No cAvX nextThis funs non-zero or V3las6 haa# beena\!&oS: # Can be 0~.B"if. itkWe arec,I endgkQ_safe+(2) # tossI L B]we_Ksize_ YIncompleteRead(b'' J&# : 1*("0") [+0 ]  ??e p!weEp everytB;1o"file"hZ- E # )r8!ed6`, amt=:vbassert- != _UNKNOWNOv<U = [] B$@\ Zeft()  if chunk_left is None:  mbreak Qif am;1not?A and'<=]Uvalue.append(self._safe_read(amt))q*i -}7 f"- 0$return b''.join(except IncompleteRead[raise"(P)Adef Qinto_eF, b)Wvassert ed != _UNKNOWNtotal_bytes = mvb = memoryview(b6tryiwhile Tru=B_get(YL}(Gif len(mvb) $n m@8\e NO - n5N + nStemp_Fvb[:P]XDjY.n:PV? +=0&W(b[0:(]),V0"""d the number of requested.This function should be used when B"!""present for qing. Ifxare truly available (due to EOF),0nM 6 S0canto detect; problem.D5""" Ddata0fp.!,(0) a buffer.=!?Oif nr(b[:n])na1Fn=-1 """Read with at most one underlying system call. If(2lea)# byte is buffered, return that instead./5""" if self.fpAN"or_method == "HEAD":6xcbMchunked0ns_read1_(5(n)Z`lengthAnot and (n < 0 or n >*)m8n =_dresult1fp. r)tn[close_conn(/elE -= len(rM` def peek(g, n=-1P# Hav5this enables IOBaseline() to P more"nu`!# Nat a time*\) @.fp.'("z, limit0W# Fallback} which uses ) v[fuper()9_0is C/G K "O(6 !_Zf 8naStrictly speaking, _get_left() may causeb,P# buttok, sincto satisfy the + protocol| u"ifI/"isYNJ== 0o8b''@p(0 <= n~)p # if nnegative`largerno.eJ/ad{aaise IncompleteRead(b"";_k$ed/# &ay cause more than one read, P# butt is ok, sinc/to satisfy the chunked protocol.IEtry: ]+_left = self._get_%()0except IncompleteReadOreturn b'' # peek doesn't worry aboutZ"ifis NoneZ5eof<his allowed to 1mor%n requested. Just0KSentirA , and truncate what we getPh90fp.(<6)[: !] hdef fileno(6) L%)7getheader:, name, default=3NA'''Rs value of F matching *J"*.jI(re are multiple0@!s,MZs*?combined into apgle strnseparated by commasjjspaces,novcfound,3s *A* or:& i!is not specifiedn, unknown, raises http.client.ResponseNotyJ5''' "ifVW_ Rz>.@all() ~isinstance(7,/ vhasattr'__iter__'NFd?els', '.join\sj2"""P list?,) tuples."""f3x..items()# We override IOBase.53 sotcheck for closed-nessm;t &-0# FDompatibility with old-style urllib rNg=infs%4an )u class mimetools.Message containingPmeta-brmation associP7URL&AWhenA`methodAHTTPU3se |Sthose7xWserver atN8retrieved HTML px(includContent-Length_Type) F$a 2Eer will bepresent if (as is now usual) the server passed back a file #length in response to the FTP retrieval request. A;Content-Type header will be present ifL`MIME t(Vcan b0gue%. VAWhen4method is local-,SurnedqsrfincludWa Date re1ingTD 's last-modified time, aL0giv?;@ siz+Tnd a '<pcontain1!a 8 at{. See alsi<description o8mimetools module(5''':return self.sQPdef g l(%):3@'''Rlreal URLx8paglIn some cases,DHTTP_redirects a clito anotherrURL. The urlopen() funchandles this transparently, but inGcaller needsknow which5wasEo'#) x u9 toFiFsX2url%Ocode g`tatus . that was _Awith,tor Noneis not an Ws}q class9QConne:_http_vsn = 11_str = 'rR/1.1'3_W=YRBdefault_port Q_PORTPauto_Erdebuglevel = 0e@"ic&f _is_textIO(stream"""Test whe--like object a @ or a binary J.e5""" isinstancexa, io.T_Base) @get_]Bent_c(body, "Get1-10 bao>O!IfH;0, wBts: 0 foryat expect!a I(RFC 7230, S2 3.3.2). WsNdaM#nym]io^or bytes2and"if!is+0# dlicit checkX!A her/distinguishDbetween unYempty.#if.upper()_METHODS_EXPECTING_BODYlf 0 else: return None  if hasattr(body, 'read')?# file-like object.Bf[ u: self._tunnel_headers = # Uelse:9.clear() *def _get_hostport(4 ,  , )S!if{ is Nonliost.rfind(':')bj 0]') # ipv6 addresses have [...]Dif i > j?n tryp = int(j[i+1:]'except ValueErrorN!ifF == "": # http://foo.com:/ /rw.default_1G raise InvalidURL("nonnumeric: '%s'" % (:[:i" =<B and 0](6'['"-1.]'R1:-1]aeturn set_debuglevel &1 = "F?8connect = b"CONNECT %s:%d HTTP/1.0\r\nr(pT|.encode("ascii"),N#bC = [3for0, v: inL>w.items(Kappend(f"{A}: {O}latin-1").C!b"2 # Making a single sk) call instead of one per line euragesIQ# theL OS to use a more optimal packet size[Cpotentially emittPeries smH%s.:b"".join(*s 3delsKcresponse2a_classb.sock, method=k_ G(version, 9-ssage) = R._read_status!if51 !=.S&:.OK{}fclose(|Dn!OS/A(f"T ion failed: {Q} {me.strip()}"Qwhile TruV0fp.(_MAXLINE + 1Jpif len(&D) > ) )LineTooLong("t-aif notJ # ysites which EOF withoutX trrGYUbreak if line in (b'\r\n', b'['): ibreak if self.debuglevel > 0;print('header:', line.decode())Udef connect(VB"""C to the host and port specified in __init__."""sys.audit("http.client.p!",.\ ^)Easock =0._create_GEion(->P.O[stimeoutsource_addresss# Might failOSs that don't implement TCP_NODELAY;try@.set@opt(et.IPPROTO_TCP, V6, 1except OSError as ejif e.errno != A.ENOb:OPT-+Rraise Z_tunnel_ 5(CAlosey A<NHTTP server6__state = _CS_IDLEa7 *:ock/y = None6!Pock.cq() # it manually...re may be other refsN0fin+ prespons$__84if  @ 9AAsendj, data`Send `'```` can a string object, a bytesvn arrayLfile-likeo0sups a .read() method, n iterabl6.P !is P"auto_openo(;els\C NotE$ed1r ":", repr()if hasatt0, "(:") nr`Ing a N ()c"u* enGv_is_textIO{+.; 3eR0 us iso-8859-1zwhile 1M3"blA KJsize6aif not&X& 5 datablock = da .encode("iso-8859-1") sys.audit("http.client.send", self,S?elf.sock2Eall( -ereturnwEEtry:?{1except TypeError>if isinstance , collections.abc.Iterable);}for d in#!Nelse;Vraise ("Q should be a bytes-like object "\ "or an i, got %r" % typ1)) Hdef _output(7, s"""Add a line of * to the current request buffer.ZAssumes that2H does *not* end with \\r\\n.:&""#._]append(sPread_!if.debuglevel > 0pprint("`Ing a H ()YQn" =P_is_textIO(.,3if .2and03ing file us  wh!;Tru^I&. .Fsizevaif not" "Ubreak- VyieldO message_body=None,o_chunked=Fals@"""Sw#ly%edQclear}AshSextra0+(A @ mayspecified,8V edY0ext(b"", b"")msg = b"\r\n".joinR)2del5[:]C(msg|*if!isB:.*p# creatpconsist;interface$z<if hasattr($0, ''.Q# Let>=take precedence over]y. ThistF2eedQallow@posiDmmap'edEs0be n into accountss_read_readable(message_body) Yelse:>try # this is solely to check see if mem ZE!implements the buffer API. it /would/ be easierG}QapturxPyObject_CBTwas exposedEPython.!memoryview( Fexcept TypeErrorAZCchunks = itero 0s*Vraise(("0 shpoa bytes-like "O !"oza or anable, got %rHj% typej#e einterface an0can passed directly into socket methods" 9,) .Afor *2 in s3bif notif self.debuglevel > 0,0print('Zero length^ ignored'p7continueif encode_ edY_http_vsn == 11#"edG9ing'c] = f'{len():X}\r\n'.('ascii') +U/ \LPA+ b'< "OCsende )R# ended transf0b'0'?def putrequest(,,, url, skip_host=False," $ ac_<2ing/)@"""S#a nvserver.`' specifiesEHTTP;", e.g. 'GET'pH`url<dTbeingE$ed@/index.htmlH'True doesDadd automatically a 'Host:' head`H Snn!'Ab -E >ingj6"""F# a prior response has been co6tthen forget about itO__response and self.__response.isclosed():  ( = None %# in certa*ases, we cannot issue another request on this connection.Poccurs when`# 1)_0arex the process of sending aj. (_CS_REQ_STARTED)kA 2). to a previousE has signalled that ii goingO DK  upon compleA 3)/headers forPhave Zbeen read, thusdetermineMpoint (2) is true'7ENT$Y ifzs no prio en cawat will P G8 Apassye socketd7theKP (effSvely meaning, "e w"), andLyopen a new o;is madeNote: ifO'v exists*can* startpaY0We Pallowo begin fetchv"toi7newOg, however, until 9i{Pstate == uFIDLEvN&%Jelse9qraise CURSendRJ(Q)validate_method('0# SO3 yuse laterbOFphasve9"= `url = eor '/'8path(urlq = '%s C' % ,U,http_vsn_strBdcoutput%sencode_\()5U*111# I@somehndard 0bet=HTTP/1.1Viance !ifskip_hosth"#]Od *only*f^8#^s. more specificallyBeansChd>e client uses$;C() class. backwards-R#atO#:` be usQ@/1.0T thos6y b>#<this header themselves. we should NOT issue ## it twice; some web servers (such as Apache) barfCwhen they see two Host: headers 3 Ifneed a non-standard port,includei[C^P. If} request is going through a proxy,D1but<bhost oHactual URL, no F_.netloc = ''6 if url.startswith('http'):+Rnil, P", @il =Isplit(url)#if:[?tryx0_en.encode("ascii")except Uni,E2_Errork#Oidnajself.put ('{',Oelse1if P_tunnel_*. =21 11K| C)`t  & `J0 = E\g# As per RFC 273, IPv6 addressbe wrapped k? []M uss5"iffind(':') >= 00 ab'[' +?o+ b']'g# =kdefault_met 0.de  Z"%s:%s" % (,)# e:6are assumat clients will( attempt to ses## s since *this* library must deal6/thD@cons| ncvC also means that Xpthe sup9ingz@ies pupdatedrecognize other forms,is B # code should be changed (removed or updated). 4&# we only want a Content-Encoding of "identity" since4[don'tKsupport e<s such as x-gzipx-deflate.=if not skip_accept_F:)self.putheader('A1D', '/')Bcan e "chunked" TransferGs, but no othersp# NOTE:2TE implies *Q*\ : TEpif TE iLp_d in theu, n it must appear#avsnection: #3Con0(TEJelse# For HTTP/1.0 server will assume ""BpassBdef e_request(#, ){# ASCII also helps prevent CVE-2019-9740dreturnK.ee('ascii@vali3s_method C"""V*2 a  name for put6.""#ChttpB inj match = _contains_disallowed_pchar_re.search()D1if G5Craise ValueError(0"f"Ns can't 0rolhracters. {*F!r} Hf"(found at least {.group()!r})" Cpath?url|?urlt P m=urlj7g !InMURL(f"URLO?urlLPU'%hoW V0 soaOdoes  qV18348rs!^t@-@, *v~sz Se"line to the server.  !For example: h.putheader('Accept', 'text/html') 6U """ if self.__state != _CS_REQ_STARTED:,@raise CannotSendHr%) &if hasattr(, 'encode')L2 = .&('ascii'Snot _is_legal_1S_namee [ValueError('Invalidl ;s %r' % B',)rv:s = list(Afor i, one_ in enumerate. 7iYfs[i] =i#wlatin-14elif isinstance(j;int#1e6str1)j 8!if)ilN?[i]pC  = b'\r\n\t'.joinw#] + b': ' + Wcoutput rdef endI s() , message_body=None, *, _chunked=False"""Indicathat the last@line6 been sent to&vserver._This method)!ds'lreques6 The optionalPargumqcan be used}dpass a4  associated withzH.f =f l,5ENT`Jelsed^WSsend_  a, url,(90={}$ ^4`P a co3te wAh-(+,us_$CV IQ# Honplicitlyed Host: and  -E'Ding:NMfrozenset(k.lower() k,s @skip6%{}if 'host'1]: ['_/1Fal-?ingQ:_:\]wt(method, url, **skips) .# chunked encoding will happen if HTTP/1.1 is used and eitherFthe caller passesP#e__=True or )followingAconditions hold:1. content-length has not been explicitly set8!2.n@bodyQa filiterable, butIPa strbytes-likeI3. Transfer-E'?NOT1 byzmJif ''~in header_namesb# only f6 for backwardsBcompatibility, assumclient code&lready handl$ N2et%L<#h B can automatiNy determined, fallM2 to3 +v = FalsN_}= self._get_(, method)o$ifKzis Nones#if)-debuglevel > 0Y0print('Un 1\ size of %r' %C F *2put-('YC', '5'u?els/ YC3L3 ',()`X phdr, value s.items()} :if isinstanceL;strI# RFC 2616 Sec2 3.7.1 says that text default,a#pcharsetiso-8859-1.-B = _'2ends&3 def getresponse(Ja"""GetM#Q fromvserver.`!IfCConn is orrect state, returns ani~GRof whatever objI#isEUed byFl_class varig a reques@en s ora previouj$k4NotReady is raised. If the HTTP response indicates that) connection should be closed,!nFvit will p before& cs returned. When Eo(ish underlying socket !.?E""" # if a priorhas been complet forget about itUif self.__ 0RL" =zVb_classZ,K, rmethod= tOelse%L Y:tryY v.begin(vexcept ZErrorV( APasser._'yUNKNOWN3b!__ 8FIDLEX%ifT#0eff`vely p toU q/# remembhis, so wep tell w6|Tsponse = respwonse return resp{except:,%.close() ai\2try5import ssl L! IRError#pass elseclass HTTPSConnection()+b"This 5allows communica: via SSL."default_=lV_PORT## XXX Should key_file and certbe deprecated in favour of context?Q def __init__(self, host, e=None,hj htimeout=socket._GLOBAL_DEFAULT_TIMEOUT,=source_addressg4 *,;`check_Bname* blocksize=8192Qsuper , %).R#, T B! Eif (pis not 7 or% L: O 6 FUwarningsU. $(", m are "Lp", use a custom3 instead."t D;BionW:, 2b.% =  %+& = 'i]D =._create_.chttps_$ B # send ALPN extension to indei/1.1 protocolD!if ._m_vsn == 11-.set_alpn_W@s(['Al*']T9 # enable PHA for TLS 1.3qs if avail)~post_handshake_authb =i= Trueswill_verify].r_mode !CERT_NONE? !is =._ ^kr+a Value*("dq needs _ with "either OPTIONAL or CERT_REQUIRED") if key_file or cert :&1context.load_(achain( @,J c=#Z@ and% / means the user wants to authenticate.# enable TLS 1.3 PHA implicitly even fcustom sJ$if.post_handshake_ is not None Z=i= Truecself._5$ =| $heck_hostname S*.c:*=  j!dePnect(C)@"Con on a gi[(SSL) port."Ssuper().c?*()0if m._tunnel yEQerver=50?elssF Tsock i`.wrap_e%. ,| =&__all__.append("HTTPSion") class Exception( Q# Sub)e[at define an __init__ must call ?.# 9"args. Otherwise, str() will fail^Dpass3Not9ed(-InvalidURL+UnknownProtocol0, version|$ =4 TransferEncoding UnementedFileMode6IncompleteReaLpartial, expected=-3 = Y% =d!arepr__~u<fe = ', %i moreb2' %Bs C'! return '%s(%i bytes read%s)V1.__>P__.__&__f 2lenE/B), e __str__ = object.QImproper2ionStatCannotSendRequest(JectionState),: pass class CannotSendHeader(ImproperConnectionState);ResponseNotReady;0BadVusLine(HTTPExcepnidef __init__(self, linaif not( = repr( )Hq.args =8,-TooLongH_typ ."got more than %d bytes when reading %s"% (_MAXLINE3)RemoteDisc6ed(ResetError, *pos, **kw$ < "{ 0b # for backwards compatibility e9 = pP r""" cookie handlUK web clients. This modul'"s (now fairly distant) origins in Gisle Aas' Perl; n1::Cos, from the libwww-p+library. Docstrings,m and debug otcode refer toW attribu5 ofsystem a--/,Binguish them cleavPython 4A. C;pdiagram$trt BSDDB1JaraMSIE* q`es are xad withoj@dard2&Q, but:availableV http://wwwsearch.sf.net/): 0O____&/! \) \'EFileE! ( D4| G \ MozillaIV| LWP{gS  0---SBase + , &,-,X  e,|/C """ __all__ = ['3', 6Jar `PolicyrDefault.l'3o1oad '] import os Dcopy datetimer urllib.parse, trequest:$thEas _. # onlykd from calendar import timegm debug = False # set to Trueqenable (ging via the logpmodule er = NoneX1f _5(*args): if notNareturn!aglobal]!er3`41ing*K ing.getLogger("http.cookiejar")5|q. HTTPONLY_ATTR = "Fnly"`PREFIX#HttpOnly_" DEFAULT_1_PORT = str(elient.) NETSCAPE_MAGIC_RGQ re.compile("#( Netscape)? :! C File") MISSING_FILENAME_TEXu("a filename wassupplied (norQQJar "O "instance initialised with one)"dHEADERu """\ # 0 # ://curl.haxx.se/rfc/_spec.html # This is a generatedQ! Doedit. """ warn_unhandled_exception(UPere a few catch-all -: statements in tB, fo#7+input that's bad4punexpecways. Warn1anyx#nAionsPcaughHAere.#@io, ings, traceback#f = io.StringIO($`.print(2, f! msf7Svalue8f. J bug!\n%s" % msg,'cklevel=2) # Date/u conversion # -9 EPOCH_YEA1970 def _xSgm(ttyear, month, mday, houin, sec = tt[:6]KPif ((4F >= c) and (1 <=L )120day!31NS (0t!24 0min(59c<= 61)F`Felse'$ DAYS = ["Mon", "Tue0Wed0Thu0Fri1Satun"] MONTH;!Ja;0Feb0Mar!Ap0MayQJun",` "Jul0Aug0Sep!Oca0Nov5DechP_LOWEc[] for]2in :'.append(.lower())2isoz(t=<A"""Rr arepresent 7seconds sipepoch, T!If@funcECcall out an argu., it will use8qcurrent&p!. 0TheIRmat oa$edis like "YYYY-MM-DD hh:mm:ssZw Universal Tim3K <+ 6R3R1) == '-']P2= - < k]2q(Dmon, yr, hr, min,%, {Ayr ="yrvif yr >.vMAXYEARup|# translate  name to number#`s star3th 1 (January6trynbmon =  _LOWER.index(mon.lower())+1dexcept ValueErrorG# maybe it's already ae zi"onj#if 1 <= SV<= 12 j1mon Y'ke sure clock eles are defined+Pif hr: "= Ci mit6sec7 8S3day?#dahQhQMint(min) sec = int(sec) if yr < 1000:# find "obvious" yearcur_yr = time.local (.e())[0]0Cm = 4%ivtmp = yZVDyr +05- m.Gum - tmpif abs(m) > 5if m > 0:g) +~$Felse - ]# convert UTC tuple to seconds since epoch (not'zone-adjusted)LPt = _gm((yr, mon, day, h0in,TV, tz)Pt is VHNone]ma using x string,0getQolute!Pif tzi etz = "UTC".tz.upper(+Poffse _from_tz_6(tz+2if %upreturn vj# -8(t STRICT_DATE_RE = re.compile(Cr"^[SMTWF][a-z, (\d\d) ([JFMASOND#") !r"&*:)p GMT$",sASCII) WEEKDAY(?:Sun|Mon|Tue|Wed|Thu|Fri|Sat)b*,?\s*W7I |^LOOSE_HTTP 1""^ ?)#w (?:\s+|[-\/]I(\w+00 #$th45d51&(?s:e # separator before clocklm # hour:min"#?: )?# optionalQ*!* t1\s*3([-+]?\d{2,4}|(?![APap][Mm]\b)[A-ZXA+) #hC4 N!)?U\k\!# B representa5 ofT in parens.M _2$""1X1def http2~b(text)A"""Rks`\sed by ai.J` value aneCeger! edvthe format0str!unrecognized, #qoutside(ble range, or4?H[P. If+O@taintB,is assumed"ThS#;Fmay be numerical (like "-0800""+0100") aR3{, "GMT", "BST?EST"). Currently, onlyGs equivalent t&o UTC (zero offset) are known to the function. T loosely parses/ollowing formats:8Wed, 09 Feb 1994 22:23:32 GMTY -- HTTP:o uesday, 08-Feb-94 14:15:299-- old rfc850B} D-- brokenE  (no weekday)@$-->FA Mr ignores leadand trail whitespace.time may beIcabsent$!If year is given with only 2 digits,&` will selectWcentury that makeZtclosestcurrent date1"""F# fast exit\ strictly con!ng/m = STRICT_DATE_RE.search(textQif m:.rg = m.groups(!mon = MONTHS_LOWER.index(g[1].lower()) + 1Jtt = (int(g[2]), mon, E0]),)` 3)$4 @floaA65])return _bgm(tt)# No, we need so2essSing..N# clean up 0 =  .l>p = WEEKDAY>aub("",,, 1) # U$ss# tz2 zone specifieryr, hr, min, sec, tz = [None]*7Vr regexp`LOOSE_w @not Z Felse>S0bad2matP_str2(n d) ISO = re.compile(Qr"""^ r(\d{4})D # W [-\/]?m(\d\d?.numerical!th+90day-&(?  (?:\s+|[-:Tt]!separator before clock93 !:? # hour:min$#?: ].\d*)?))?j opaopconds (1fra!al6+%# =0\s*wa([-+]?:A:?(: )Pq |Z|zY # 0 (Zn"ddian", i.e.3 t@)?$"^`re.X | ASCII) def iso=): """ As for http2time, but parses the ISO 8601'mats: 1994-02-03 14:15:29 -0100,--74/-- zone is optional5( -- only date.T2-- Use T as separator70203T141529Z3 scompact  <+  /1"""# clean upptext = .lstrip()j@# tz#specifier )!ngA day, mon, yr, hr, min, sec,A= [None]*7Vloose regexpH0m =_DATE_RE.search()!@if m@not S:P# XXX5re's an extra bit of I'm ignoring here: isIR thiPrightng to do?( , _ = m.groups(Felseareturnt # baddA_str(hr{ q) # HeaderRing # -9 def unmatched()B"""R ~@re.M3 object.start, end,"r.span(0/f.n![:4)]+ end:] HEADER_TOKEN_RE =0re.<ile(r"^\s*([^=\s;,]+)")8QUOTED_VALU}= = 8=\s*\"([^\"\\]*(?:\\.V)*)\"OH/ OM*_ESCAP@\\(.(qsplit_hs_words( cvaluesPr"""PR   into a liss containAkey,+r pairs.The func$ knows how eal with ",", ";" and "="@wellaquoted]ps after'E. ATspace(ed tokens areU0sedMiyN8wer0 byI(_x3pasGarguments multiple,,?nlYtreat da sing;by commaTf@meanlags^is usefulRfield7@follRsyntax (BNF&@from HTTP/1.1  catwe relaxMzqrequire) Ms2= #D"= (token | parameter) *( [";"] (token | parameA)  = 1*A@ = "(" | ")<>#@"6,A| ",$;:\$<"l. @| "/$!"[]?=l {$}tSP | HTquoted-stringh= ( <"> *(qdtext | %apair ))#9!= ODTEXTO4<">J01"\"~t! = attribute "=" value/!=  , Each header is represented by a list of key/[rs. Thea for absimpleP (not@a iNone. Syntactically incorrectMps will Lnecessarily beQsed as you would want.@Thisjeasier to describe with some exa"s:4>>> split_}%_words(['foo="bar"; port="80,81"; discard, bar=baz']+0[[(5', 'bar'), (':<?0', a)], [(18Qz')]]  /html; charset="iso-8859-1"+n57w r'Basic realm="\"foo\bar\"r%n0l1Oj"""aassertisinstance(bs, strgresult = [(3 in_4:eQorig_$ = K,0whi6ext@ m = HEADER_TOKEN_RE.search(S)Jif m?( = unmatched(m6$name = m.group(1"QUOTED_VALUE Z3 # ",g '>RESCAPub(r"\1",NelseHU5"unx0 , +3 .r.p( else:   # no value, a lone token ." ,} = None%pairs.append((name,1))),elif text.lstrip().startswith(","):0$# concatenated headers, as per RFC 2616 section 4.2Ds* =zM[1:])1if : result J = [JOelseskip junkx@non_A, nr _chars = re.subn(r"^[=\s;]*", "",kassertFm> 0, (ur"split_V_words bug: '%s',_%s" %?`(orig__,? i$4 = Nrcreturn HEADER_JOIN_ESCAPE_RE*compile(r"([\"\\])") def joinc(listso"""Do the inverse (almost) of!co`d,>by 9!. PTakesU0ist@j D(key( and produc3csingleM. AttributeXs are quoif needed?>>>@[[("/plain",Q), ("k etXiso-8859-1")]]_'6#; ,'="*'vO], [x,xy1"""43forg1in Jattr.rk, v in6- ifQs not: "Pearch\w+$", vi'Ov = q(r"\\\1? # escape "5\L P'"%s"' % v#k = "%s= (<k0if :P"; ".[(N!) _ s(Z3'"',52endC32:-1Oparse_ns &s( """Ad-hoc , r ,2Netprotocol cookie- sThe old 2)F0mata Set-C?A caninstance2taiQan un=Pd "," expires field, so we have to, use this ad-hoc parser instead of split_header_words. +PXXX T?may not makQ e best possible effort to] all the crapIthat Netscape Cookie qs contain. Ronald Tschalar's HTTPClientHs probably better, so could do woran following !ifHever gives any troubleCurrently,AD0lsoRQd forWRFC 2109 c;1"""jknown_attrs = ("expires", "domain @pathsecure",:%# jN(turn up in_o, too)Kr"versio{0ort{max-age")result = []B#ns$n !s:!1pai4j0_seMRFalsea# XXX: TheAdoeslstrictly adhere^@RFCs}Uempty|Q# nam`d valu re legal (former will onXppear once andPbe overwritten if multiple occcfpresent)..'isG0mosto deal with backwardmpatibility.7o0ii,e amenumerate(y.f(';'))Xrparam =>.H#p(key, sep,-+partition('=';key = keyP!if:keylif ii == 0 UbreakOelse007inuI0#v!owa distinc"Sween = ymissingLtogetherPval =3@sep K Non!#lcQjlower(oPif lcD&lc[@ if}C#6 anjKS if " iZ08_quotes(val,3ITrue#'eleR~#_Svert (A datMseconds si]epochimhttp2time(A) #(9yinvalidvD.append((*1if % iversion_set:  pairs.append(("version", "0")) -dresult,9!) "rreturn ! IPV4_RE = re.compile(r"\.\d+$", ASCII) def is_HDN(text):PB"""RSTrue if  is a host domain name."""5S# XXX This may well be wrong. Which RFCMHDN defined in,hany (forH the purposes of:c2965)?"1For%+current implementation, what about IPv6? Remember to lookI at other ulFAalsochange this.63if %x.searchETFalse2KR== ""m( @[0] +0." dext[-1?x _match(A, B*# A-3#es B, accordingB.qA and B-be-sIP addresses7FP, sec2 1:QHohPs canKspecified eifas an Vd a ]bstringSometimes we care onb with an. (Such+isons SHALLbe case-insensitive.) 1A's3B:bB's if0 * "ir,"s -equal; or>AJ0hasW form NBRere N-non-empty" tI, B CA.B',Y"B'C_*)o,K0x.yx !.Ybut not .0Not[a]7m+a muqve operp: a.b.cV;2es $, qN redeyAE B $Y1es,Uonly relevant part"th#i!of2 algorithmkdirectA = A.lower(YB = B@if A&B!ifqA*rrrfind(Bs@if ia -1 0l#,!esbFhaveu"orrp~B.startsO("." 3_B[1:]/ liberal_A@ sort-of-likeaccepting/blocking domains. """ if IPV4_RE.search(text):)return FalseTrue def user_^_match(A, BC"""For blocking/acceptA and B may be host names or IP addresseA = A.lower()YB = B if not (liberal_is_HDN(A){ #B)if A == By# equal|+Pinitial_dotstartswith("."8if '+RA.end'l_ > 7 cut_port_re = re.compile(r":\d+$",aASCII)request_( PB"""RS-% , as defined by RFC 2965Variation from": ed value is cased, for convenientcarisonV1url.get_full_urlL = urllib.parse.url (url)[1]c"ifV== ""-@bheader("Host", "")# remove p, if presI.sub("",x2, 10Ceff_ a tuple effective F)VA@, ex both are9Berhn Oq1req(Q.find3!-1 0% r+ ".local$ri , 0T_path+Y"""Path wonent of6?URIp)Qsplit$ = escape:.0&.#/"&# fix bad 2396 absoluteURIk'E = "/" + D:;ort:".D2i =5':'fi >= 0q=-R[i+1:6try'@int(/LVWZError1_debug("nonnumeric: '%s'", MQ2NonBFelseT} = DEFAULT_HTTP_PORT;$ # Characters in ito A-Z, a-z, 0-9, '_', '.', and '-' that don't # need to be escapform a valid HTTP URL (RFCs 2396 and 1738). _PATH_SAFE = "%/;:@&=+$,!~*'()" ESCAPED_CHAR_R% re.compile(r"%([0-9a-fA-F] )") def uppercase__char(match): return "%%%s" % .group(1).B(ND`_path(BA"""Er any iniacters in ,UC all?Qs."""# There's no knowing w|Ta encodRas us}`creatersIpcontain)"%-s, but since we haveqpick on *L s,=5UTF-8, as recommendedthe HTML 4.0Especification"# http://www.w3.org/TR/REC-html40/appendix/notes.#h-B.2.1W@And 4, kind of: draft-fiel(-uri-rfccbis-03:(;"in/Z IRI -duerst-iri-05)<wfor new UAchemes: RFC 27180@= urllib.parse.quoteL,# 4 U.sub(D  , g= dreach(B"""R of host hdefined by965, secA 1. BThe =R?aAname H is Eas follows:9 * IfR - 56qdomain O2of ^;A,8@has 91A.B' & A &no embed(is, interior) dots>B>at least*Hdot, or B0strt"local".-mAthen;"of#.BVOtherwise,,H+2>>> (">1acm"$'.'.*)U']i = h.find(".Uif i >= 0 #a([:i] # this line7AonlyBshow2a i?b>Qi+1:]zbzf is_HDN(h)4" (Sb == 3rQ"."+bdhCis_third_party(requestD 4 2V3.3.6 An unverifiable transa^ isa1rd-iYQtfu-k.PU doe39-=-8ONaoriginsaction.  """ req_host = Auest@(req )%if not domain_match!*R, rea1.origin_X1)):Clturn TrueMelseFalse class Cooki%s"""HTTP!. DRThis ,represents both Netscape and RFC 2965 cRs?is deliberately a very simple] . It just holds attributes!'spossible to construct instances thaNn't comply with theM.@dardbJar.make_ iLe factory function forvJobjects -- it dealsrH parsing, supplying defaults,>Epnormali)ravused in t#. Policy i'brespon*Pcheckv@them]see whether y should be accepted from re[ ed=cserverBNotetport mayM1e headers, but unspecified ("Port2a!anQ=80",r0exa2R); ifacase, ysis Nonedef __init__(self,sion, name, value,-LV\_',+|ial_dot?`path, f _securexpiresZdiscardocommenO_url8?res5rfc2109=a7"):RZ$ifc:= int(ver$7 77cfloat()>;ny4r>5vpraise V Error("if9/J  mb8Vlse")z.$ =u! = 6 =#-$# "e Nfas per"seU3.3.38# =v.lower(y%{/V# Sigh. We nevHknowmc givenaAz-G` had a)`itial 60ordo followK!(arin draft errata). Needed for the returned $Domain # value.aself.d%_initial_dot =  5ppath = _specified# -secure = expires = `discarb `commen s_url = # 'rfc2109 =  B_resdpy.copy()& def has_nonstandard_attr(w, name):Pareturn@ in $._"L?getL , default=NonZRP.get(3)ese CW[S2] =f2is_d,owif now is : p= time.(1if G#.e ais not8[) and <=MEmATrueVFalseq__str__sE"ifFportep = ""Raelse: 1:"+)0 @limi>rc + p +\5ath,qrB#= "%s=%s" %,[#Tk H="?"n,b!, ___repP0arg%[]dQI ("version", "b%",1"i&/~1 3# "#IGE1   ~ m` = get w |.append(4h , (?&))0 2h-/2V 5d7ia%s(%s)]__class__.__@__, $`.join(Q)) % bPolicy."""Defines which cs+ accepted fromQed to server.!May also modifyG, though thisprobably a bad ideaBrThe subDt)FR rulesNetscape and RFC 29665 cookies -- override that if you want a customized policy. """def set_ok(self,X, request):' 3Return trueh(and only if): should be accepted from serverPCurrently, pre-expiredGs never get this farQthe C5Jarclass deletes suchG itw" raise NotImplementedError()'r"B[Ted to rdomain_K AfalsM0notSed, givenS Z.} ,V TrueAMpathAX 3rDefaultRP!( 5"""" s standard rules for@ing =].(5DStrictNoDots = 1n*G = 2RFC2965Match = 4i+Liberal = 02k2 = %z|rS__init__T9blocked_s=None, allow=netscape=0P, rfc =F,/ u109_as_:p+Rhide_y2Ps& }965_unverifiabl~Y*ns./F= 1ial_dollar 0ns_5'+ecure_protocols=("https", "wss"))"""Construct0rguZspassed as keyword a&P,L4 = !$ =G <+  7H8 =  )9 = + #9le self.strict_ns_unverifiable = # s=idomain71set_initial_dollar=I Mpath? 5ecure_protocols3  2if blocked_s is not None:( _/= tuple();?elsI)()_allow )  ; = -de$(A) """Return the sequence o9 ]R(as a2U)."""&r@Y.d%0 h, ?Set  V $is;forO in p^|sif userr_match(_ o:]ATrueLVFalse QM, orYB6sS , G ,ifYQ! w(sis_not_Q#ifB(/is   > s :s #okcookie, ri'stYRIf you override .Lok(), be sure to call this method. If it f), so should]r subclass (assumingPwantsifbe morz about which .accept)._debug(" - checkw= %s=%s", cookie.name, cookie.value) dassertname is not None(for n in "version", ifiability@@pathQdomai+eport":w~0fn_0 = "set_ok_"+n" = getattr(self, 5)(!if2fn(, request)rvreturn Fals3TruCdef b$ifG2JF 2# VB`alwaysj to 0 by parse_ns_headers if it's a Netscape#v, so this must be avalid RFC 2965,.B_debug(" Set-C*2 without ibute (%s=%s)",G^$ b v"r `.uq> 0 and@.rfc T s are switched off"<.el,==n#a.unver;l(d is_third_party(( @sstrict__d #y-y  during "jG"l transact .P y /ns# UA8Q# Trystop sert%V0designedhack other#<that know both VV1 protocols3if  initial_dollar``.startkh("$")illegal 6" (7  '$'): '%s'"& x tA/_specifiedm req_path = request_( 7)  if ((cookie.version > 0 or'2 ( == 0 and self.strict_ns_ser )) H2not2_return_ok^,=)):@_debug(" , attribute %s is `a prefix ofK- "J1 "GS%s", : 25e FalseVQTrue @def ok_domain()e`i1lf.is_blockedA+  in user DV-list)  not_allow$H(_specified'req_host, erhn = eff_ U$ =o"" ( .count(".") >= 2D(# XXX This should probably be compared with the KonquerB# (kqjar.cppr Mozilla implementations, but it's alosing battle.!Ci = Qrfind &j&j, 0, issPif j EC: #\ like .foo.bae tldem[i+1:]^s'_j+1:i(0ld.r() in ("co", "ac0com0edu0org_net",wp "gov%0mil inA"aerV0biz!caOcoopJ1inf50jobP"mobi>Qmuseu@namep^Qtrave2eu"%len(tld)2?? _co.ukg ry-code second levelpQ~#ifHp.starts-undotted< :Oelse? aembedddkts = (u.20!if DX != ".local"s non-local domain %s contains no embedded dot", d<)return Falseif cookie.version == 0:$kif (not erhn.endswith(oM and263Rstart5O".")2 eP("."+j)k.))j_debug(" effective request-hostP`(even ! aL"P "initialrP) doeRt endC/%sC#, #ir(m> 0 orG(self.strict_ns_o1 & DRFC2965Match@!ifv; _m'(s(7^-^ x Yi>rS\oNoDots>]_prefix =s_d[:-len!]P(:P.findo) >= 0IPV4_RE.search(reqrq c%s forma I QTrue def set_ok_port,,S/_specified C^ % ifh! is NoneNKR:"80?els2 1str |Cp in.".split(",">tryZint(p]except ValueError>*@bad numeric)", aec@if pZBQbreak4VA(%s)PfoundRK QUjx= ?_ok&""=If you override .r"eturn_ok(), be sure to call this method. If it r9s false, so should your subclass (assumingwants toPbe more strict about which cookie. v5). 85""" # Path has already been checked by .path_Gand domainIPblockAdone9#;.0_debug(" -l9 %s=%s",U.name fvalue)for n in "version", ifiability`secure `expire^P"port%":0fn_xE = "6_"+% = getattr(self, 8)Mif not fn(, request)uTn F$EBTrue3defC_ok_d$ifT2P > 0 .rfc2965` RFC !I0s awitched off" .el,==netscapeN!*[Kaa.unver;!lecis_third_party(( __d &Jy-y @ dur|L I"transactj &M  /ns# O8r1.1*Q.type92in $_protocolsM[ with non-` eN2is_5d5[._now20yQ/e req_port = request_( 7)  if%! is None:!,2req"i= "80" for p in cookie.k.split(",")Maif p =U"sYbreaki?els_debug("   %s does not match)",]s,2 5*return FalseKQTrue  de`*_ok_domain(self^,*host, erhn = eff__Z$ =2if A and.startswith(".2dot' = "." +EW3<# strict check of non-&s: Mozillathis, MSIE55n't}Cif (upversionW0$p.{3_ns0 & !.DS2Non)EHm_specified,1 !=D q6 unDUng-compare tT "equal toD"#ifs.=!> <_:(,\effective-Y name[-[RFC 2965{B %s"r'==+R).endkNetscape l>_1_ok/l# Liberalp. Thishere as an optimizatgto avoid# havingload lotsfiles unless necessary.EiCtq `+M}I "E A2N oSe$ if not (req_host.endswith(dotdomain) or erhnG): #_debug(" request F %s does not match cookie *",LX,*)&return False if self.is_blocked(  is in user =o-list" ~not_allow'A3Trudef path_@_ok(&,,#- checkingGB=%s"<$ =O_` )len = len( if=91 == g uPelif h8b.start]E and4v1"/"[8Clen:0+1]'#Kd< SL->mH vals_sorted_by_key(adictrkeys = !."()X3mapPget, "0) `deepvalues(mappingZ """Iterates over nested &, depth-first,:@ ordByeA."""b? = Qpfor objP4(# =6try%obj.items{except AttributeError57pas0:lse} ~]yield from M2obj##ifa Z?obj # Used as second parameter to .get() method,stinguish absent #+@one @ a N Z. class A4!: C#Ja$"""Collection of HTTP"s.qYou may@needknow about this qQ: trysurllib.1.build_opener(bProcessor).a(url).@] non_word_re.compile(r"\W"_quote!([\"\\])'rstrict_/\.?[^.]*/( %/tsKb^\.+")>_magic$R#LWP- s-(\d+\.\d+)"c.ASCIIC__init__`olicy= if policy is None: policy = DefaultCookieP%()+eself._-  c< s_lock = _threading.RLockO0R = {}Lsdef seti(v", m)A_X_for_domainJ , requestS3U = []xif not o.C_return_ok(Tf(U _debug("Checking %s for 2to 52", \$_by_path =[0X)$in`<g.keys(@CcontinueEUs|lname =[W4 Bm.value8QR D! ??".Oit's a matchG`s.append(n=3 A"""R a list ofRc to be edserver."""s,3)k0ext 1T c_attrsn-9`ibutes|like ['foo="bar"; $Path="/"', ...],The $Version g is also added when appropriate (currently onlyonce per.j#Yin ordermost specific (ie. long e firstqF .sort(key=lambda a: len(a.4)verse=True)ion_set = FalseSsS s}#. Yu header+;XXXWhat should itif multipleISet-YZs hav# diffes themselves?{pAnswer:" reAno a; was suppos beftled b RFC 2965 errata, but tmay never appear.G.. version = cookie. %sif not Y_set: P} = True#$ifCN > 0CGattrs.append("$Vd=%s" %>)) [s# quotep value ecessary.(for Netscape protocol, which already has any`sG intact, due to the poorly-specifiedcC^: syntax)LTif ((sqNone) and/'self.non_word_re.searchF:4r)s-!= PGMub(r"\\\1",W.* OelseS 3addX-`ibutesEbe returned in 6y header#ifA@ is .`QOname <3"%sfG,p)O Upath_0 '$Path="%s"' %G 9gdomain.startswith("."6, ~'NX*_initial_dot:/ 12 = :O[1:] 1D3=. @portRVp = "$Port"~P Rep + ('ZB4 pH def add_T_V(, request}A"""ASrrect:3 (urllib.".RK object).}3TheH2Hpis alsoed unless policy.hide2GtrueN&""x_debug(""6.Ps_lock.acquire(%Ftry:7S_now / int(time.'()>ls4S_for_1( : 8_sj"ifDif not reques t.has_header("Cookie"):  request.add_unredirected?5HX, "; ".join(attrs)) 5 # if necessary, advertise that we know RFC 2965<if (self._policy.rfc% and not ahide_c2" K2#?2")%Bfor T3 in sL#if .version != 1,|cr2", '$VSm="1"')OVbreakzfinally4s_lock.release(&clear_expired[s&def _normalizq_tuples!, G_setZ"""Return list of 3 containing W3sedS@ infkVtion.`u is theS[s\key,value pairs extraU fromI<BSet-.F or "2 LsyT are name, d, standard, rest, whe#&65the}I&LPa dic8ary)t P-ibutes (discPsecurP", smax-age,Idomain, pathQport)  $%ofOU5""",(NV = []boolean_Ss = "B", "H*#(""8"M-",$?ort1pcomment* Gurl"yq&inG z# =)5'[0/x# BuildF%of<$ (VLtof othe% C)=RNote:w`y timeG to seconds since epoch. V0$s should havU1e Es,#V1sOGMax-Age, butV1 includes4109J\ (andO%V0$may be a mish-mashNetscapev109), w 8accept eio(prefer Max-Age).  max_age_set = False bad_cookie standard = {}:0resT for k, v in X_attrs[1:]:@lc = k.lower()# don't lose case distinction kunknown fieldsAPif lcRvalue3 orrbooleanok = lcXkW B@ andos NoneP## 3-ibute is present, but has no # (like "discard", rather than "port=80"X>v = True[1if only firstsignificantXuocontinu== "domain"u/if` e_debug(" missing1` wH +&_break# RFC 2965 se_3.3.3-v #expires$H# Prefer max-age to ZXMozilla?C&or invalid"9p"p: treatpas sess40|a?try_int(v{except V_ErrorJ _(non-numeric)meFXvconvertNRMax-Aseconds since epoch&# XXX Strictly you're supposedbfollowe?616F age-calcularules. Remembst zero Kis a requN toQ (oldQCnew)-, though.Nk = "expires"  v = self._now + v % if (k in value_attrs) orsboolean:?OCv is None and&*Pk notm("port", "commen ourl"))kE_debug(" missing for %s ibute" % k)bad_cookie = True*Oreakstandard[k] =^OelseDrest6 [6if <continue 5_tuples.append((name,$, , {&))Ayreturn DCdef $T_from h(YP, tupSWquest#qvdict ofm-sD(st,&th#BEthem =6`domainb.get("", Absent.Mpath.,>ort, X}expires/^# set the easy defaults nversio!",3if o k:tryD6c= int(X#except VM^ErrorFot # invalid, ignorePsecur", False# (discardAalsoE3if i 2=ef  zO_url4 !ifZ!= ""?_specified" = escape_(^ U#Q = re+W Z)1i =.rfind("/" f i != -1<N== 0!%Q# Net  parts company  reality her<I[:i]$#3Z[:i+1<bif lenp  f = "/"efault domai3n domain_specified =  is not Absent0,# but first we have to remember whether it starts with a doEb_initial_dot = Falseh#if:DRbool(.~e("."))>[ [ req_host, erhn = eff_request( T/&rhaAelifI z$r = "."+  # set default porQ )M" z!ifR#JNone# Port attr pre,  ha)u value:2X.L# Cookie should then only be ^ back on thaE#= _?els0 76Tru& e.sub(r"\s+", "",dA# No% 7$. =can1any3 expires and discardu4if #is != dM9 = 7<= self._nowY0# Ey date in pastg>delete c. This can't b#BD@Policy, because7 Rs]*reR:trySclearF, path, name+except KeyErrorLEpass2_debug("3ing,R='%s'p u )",IM# 72breturn@<(version_! ,# I,0D@osecureJcomment O_url#Rrest)Rdef _ps_from_g`s_set(,@,)r:_tuples rmalized[e_tuples(attrs_set) cookies = []for tup in _tuples:"> = self._T_from 6(tup, request)B#if`:s.append(M.Tretursdef _process_rfc2109z s(,V)(@as_nqgetattr0._policy, ''etscape', None8if 'As is"m& #S= not1m.!5965} z8.version == 1x|Gb109 = Truei" H&# treat fXS as Nrather thankIas RFC29655)& 0KmakeresponselB"""RBsnce of C objects extracted  P E."""S# get-@pibutes ARFC 6andprotocolsD`headerjf.info(a1_hd'1.get_all("Set-f2", []:/ns5 42U._now int(time.'()D0n*2(#Pif (()ZPE) orM62 -B- _3 ad[] # no relevan5 : quick exit6tryN ,m(8bsplit_lx_words(),;except E:ion_warn_unhandled_.7ionyW\9if j c P#2| ub,$ns4?`parse_( ?drs105"9, : # Look for Netscape cookies (from Set-C headers) that match  # corresponding RFC 2965R2S.IFor eachf, keep theT and ignore O% ( section 9.1). Actually,`5109;areMbundled in withx7 for this purpose, which isNreasonable behaviour`if rfcI:<zlookup = {}$inCG"[(/.domain,4U.path name)] = None uqdef no_Cing_B(ns_]", =)ekey = 5 preturn R0notz -Ls = filter(,*s)'ifs.extendG+_T3setA_if_ok(self, requestN"""Set a if policy says it's OK to do so."""\.os_lock.acquire()%:try6e._now =  int(time..()<-A#ok6.42") <"0fin4`releas w qh,out checkwhether or t should be setzc4#ifBrn c: c[c EMc2 ='_]T2: c2_]3] & \$c3BB%(dextracRsOE5Q!s 4where allowQgivenN _debug("P: %s"Epse.info+m# Dmake_cookies(response, request):  if self._policy.set_ok(cooki9 H_debug(" setting 7c: %s", )s:tl2p,zfinally5_2s_lock.release() gdef clear(,, domain=None, path Aname @"""C;S some"s.XPInvokthis method without arguments will a Ias. IfKgiven a single=d, only{q belongrco thatc%beOqremovedd \5twoWssSe specifiedM&)inuOare i6hreus, thenM$thJSs D and%ish} Raises KeyError if no match!h exist5"""3ame is not  _Bif (1$ a) or (!is20ra Value(r"ZQtmust beo# a1 by!"L3del"s[Y ][V ][T]AelifB# t %G*se1.]R = {}~S_session$c"""Discard.BNote[u.save()QPon't  B anyway, unlessyou ask otherwisebs] a true ignore_d* h`acquirh+tr3for1 in a5#if#.#'6..A %:-_expired.You probably dneed to cG+: G nUneversent backA9Pserve rovided you're using DefaultCookiePolicy),  this method is called by 0Jar itself every so often, and theJt.save()M`won't  expired c s anyway (unless you askIotherwisepassing a true ignore_Rs argument). ?5""" #._x_lock.acquire()%Etry: now = time.+3for@ in b >$#if#3.isnd(now)+/Er.clear(.domain,FEpath FnamekfinallQ `releasdef __iter__(/return deepvalues!H)lB>lenAB"""RDnumber oVntain.Qi = 0c "Ui + 1&i?repU = []9_r.append(B)fl"<%s[%s]>" % _class__.____, ", ".join(r)./st,$st#5 # derives from OSError %backwards-compatibility with Python 2.4.0 Q Load>(F0):  EFileX( {5""" that can be loadedvUd to a fileICinit,!=None, delayP=False, plYe NOT@the ^dh until ei .kQ() or[ .rIt)viJar.__!if@not s1"p= os.fsZ(L.% =Y!N = bool(+ tdiscard CSavesb ra@NotImple#e6O !ifW5is * =&delse: raise ValueError(MISSING_FILENAME_TEXT)  with open(filename) as f:")self._really_load(f, 1, ignore_discardsexpiresndef revert(O@i=None,p+ Tl=FalseZ) """Clear all cookies and refrom a saved.Raises LoadCq (or OS 3) i sion is not successful; theobject's state will0be alteredOthis happens5"""I!ift00if T.&*<=&`Cpelse: ra Value@w_k_lock.acquire()`Ftry:anBold_= copy.deep .QC5 lU = {}bf 4E@dexcept v(`5 = *[0finN R NN`releasN C3lwpoR_str(z """Return string representatAof C0 inC LWP%s format@Actu,+Yextended a bit -- see module doc|ESh = [.,y .vm)u("path"! fdomain"!)]t$ifZ@port !h.h@d(("B)n@ath_specified: >0", e<?ort<<_initial_dot|?dotAisecure51 2"time2isoz(float@-))y njcommen pI_urlt=urlD,)keys = sorted`_rest.(pPfor kY5 k, A0[k])@"ver`"10r join_header_words([h]) class LWPCookieJar(File): """9The- saves a sequence of "Set-B3" lines.> is the format used bylibwww-perl library, not knownK2to be compatible with any browser, but which is easy to read and doesn't lose inion about RFC 2965 c1s. {Additional methodsas_lwp_str(ignore_discard=True, bexpire):^[Gdef GEself8Msb"""Return! aQtring\\n"-separateddheaderQA s: see docsdIfor I.*Qnow = time.!() er = []U@ in +!if&6. 6:continuek OesO2is_Wd(now>Wr.append(: %s" % B^I )"\n".join(r+[""]I@h(, filename=NonV=Falss%ifGHJ ?!if.m&*<=& ielse: raise ValueError(MISSING_FILENAME_TEXT^Topen(|`, "w")fp# ThereQlly i an Ss 2.0<this indicates`# that reYextraB1in q(domain_dot: Fport_spec)le still be , I hopeW f.write("#LWPs-2.0\n"B*'.qi{)|f_really_loadnq:lJmagic = f.-i)_re.search(msg = ("%r look like a c (LWP) C"WH EBLoad3msg!D_) =v:boolean_attrs(", "path5 _%",a q"secure1iscard")  value_attrs = ("version", "port", "path_domai1 expiresSacommenV eurl") Etry: zwhile 1line = f.read )()9$0if  == "": break%1not).startswith(header)yYcontinueMoME[lenF].strip(Hfor data in split_{_words([S]Rname,! =F=[0]fstandard = {}"OrestkrbooleanJp[k] = Fals-(X0, v[O[1:]Vif k is ONone*\lc = k.lower#?elsIp9D# don't lose case distinction unknown fieldsI`if (lcD) or ok = lcl R if s : v = Tr+z v"elna _[ Dh = oO.get%c = h(" "Bdisc3h(" +3if L-= iso2time( ` ' _specifie/".>Cookie(h7), "h( ),/"):", 6I?dotJb1athN:osecure, expires,  discard(h("comment")-?url0_rest)if not ignore_s and c.:9continue! Ze/Z2is_od(now)b$self.set_cookie(cexcept OSError`Frais*E1:ion,_warn_unhandled_.Fion(l TQ Loadq("invalid Set-C3 format file %r: %r" %<S(, name, line)) class Mozilla[Jar(FileRA""" `WARNING: you may want to backupr browser's Ps if# u4Rthis tto save/. I *think* it works, but there h-Abeenpbugs inb past!T`differs from T only9S its1anddDloadNa7. oAuses\/Netscap,`S.txt's. lynx|b, too.PDon't35ect@d wh4the is running beqiced by,(in fact, on unix will overwriter!ifO`changemACdisk5it';Windows,R probably can'tOs at allC)0Notya%{ downgrade RFC2965K!to| on3ingmIn particular,+ versionport number inris lost@togeY with'about wh or Path, PZDB wer_qspecifi9W2 (orI) header, h"thPdomain as set.CHTTP= started a dot (yes, I'm aware somMcsFD8! d-- trust 1youcreally"know any more Dl(Dough+ usMce same<y}`slight^3entse using the Netscape& header by default (Mozilla can cope with that). 52""" def _really_load(self, ilename, ignore_discardexpires):Rnow = time."()dif not NETSCAPE_MAGIC_RGX.match(f.readline()R;raise LoadError(o"%r doesblook like a Netscape format cookies file" %I6trymzwhile 18 = arest = {};2if B= "": break&# httponly is a flag asined in rfc6265# when encod*4a n(! ,:2theis prepenC]"#HttpOnly_":p.starts0(HTTPONLY_PREFIX0[+`ATTR]  b-?N[lenc]P#last field may be absent, so keep any trailing tab}2enda"\n"):! =O[:-1skip comments and blannes XXX what$?}(.strip()e("#", "$")) or;5; =\continueDdomain,  _specified, path, secure, e0 , c, value = \plit("\t"))ZD = ( = "TRUE, 6@!if$#s.txt regards 'Set-Cz`: foo' H#1 nor,Areas!.cJ5jara!itRK0"nov.," ="!?Noninitial_do[/".massert;fPt = False$ifoK/""e1 = | _ = Tr# assumefBc = )(0 q,e,  domain,  _specified, initial_dot, 8path, False( _secur# expiresG discard$ ?Noni !]rest)if not ignore_s and c.:5*continue ReR2is_od(now)Zself.set_cookie(c) ~except OSErrorYFrais*E1:ion,_warn_unhandled_.Jion(<TQ Loadq ("invalid Netscape format s file %r: %r" %K (,name, line)def save(,Q%= =usw%ifG@ is J 0if n.&0*<=& belse: 0RValue1MISSING_FILENAME_TEXTwith open"w") as ff.write(NETSCAPE_HEADERRMnow = time. 3for1 in hFU# =). 'iW\?Wa+$if":  = "TRUE"&OFALS'#ifp.startsh("."):g +lt#.e|!is )j= str(> .H "+]vJ#s.txt regards 'Set-C`: foo' a+ # k@ no +, whereas http.5jara!itRK0R.,mA9C- FY >name = cookie.n_ame value = cookie. )$if has_nonstandard_attr(HTTPONLY_ATTR):?wdomain = -PREFIX +  6f.write(O"\t".join([?, initial_dot,_path,AEsecure, expires, name, ?])+?8"\n") #### # Copyright 2000 by Timothy O'Malley # #PAll RJs Reserved'Permission to usepy, modify, and distribute this software #its documentatKfor any purpose&+without fee is hereby # granted, provided that the above cnotice appear in all #!1iese;BbothE;n_Eis p= # Xsupportinge^ of #T0 beRdpdvertisSor publicitppertain&tolH!ofp Dspecific, ten # priY. 04DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS # SOFTWARE, INCLUDING 9xIMPLIEDAOF MERCHANTABILITY # AND FITNESSC NO EVENT SHG BE LIABLE FOR@Y SPECIAL@DIRECT OR CONSEQUENTIAL DAMAGES4ANY # WHATSOEVER RESULTFROM LOSS OF USE, DATA=PROFITS,:ETHER IN AN ACTION0CONTRACT, NEGLIGENCE;O.pTORTIOU;3`, ARISv0OUT@OSRCONNETy0THE PERFORMAZF # Id: C`py,v 2.29+/08/23 05:28:49 %A ExpG_a Python@ule  Phandl0of gUs as 70dic ary. See RFC 2109J!moSr informJ#onrs The original ideaStreat rk came fromDave Mitchell (davem@magnet.com)1995, when he releas first ver6Rof ns1.py r""" Here'sample sekPshow wYmodule. A moS,!is Jonly0. Basics -D Imis easy... v1>>>q http i'hs Most {time you startcreating a cookie. >>> C = cookies.SimpleC() Once you've created"r #, can add values just as if it were a dictionaryy["fig"] = "newton"r["sugarVwafer.output().R'Set-b: fig=JH\r\nN=I' Notice that the printable representaS of a0 is, appropriate format8 a oheader. This:default behavio1YouaPchang"e ;B anded attributes by using A fun~RrockycFroadb#["b["path#/G&5$(C#="!") P=fs; Path=N MSs=[],W The load() methodextracts  from a string. In a CGI scriptwould us$isX3to OsRthe HTTP_COOKIE environment varif%. "chips=ahoy; vienna=finger"hD >  L'Fis darn-tootin smart about identifyx withinZEscaped quoWmarks, nesssemicolons,other such trickeries do not conf/itF &'keebler="E=everybody; L=\\"Loves\\"; fudge=\\012;";'N`UTSR Each ele!ofE) also supports allRFC 2109 ). Here's an exa which setsG:b["oreodoublestuffC! ,5U=PR)qhas a ' ' ",PgivesQ backT+` assoc d /keBtwix1nonlAC["t".u')ZP expe;As shvbe standard@s. J0to Uure, Rkie invokes the str() builtin to convert Pvaluea(ing, when (s are set dictionary-style. >>> C = cookies.SimpleC%()"["number"] = 7astringw"seven"4.0'7'v$["= D$r.outputR'Set-": \h=7\r\nT=H! Finis. """ # # Import our required modules # i$re Ntypes __all__ = ["Error", "Bas=M"] _nulljoin = ''. _semispace%; Define an excepq visiblExternalgclass $(E: ): pass # These quoting routinesx@formn_RFC2109 specifica ich in # turn referencescharacter di5ps from QP068. y provide # a two-way algorithm. Any non-text _ is translated # into a 4#@sequ: a forward-slash followed byhree-digit octal >valent of&Z'\' or '"' is #ed with a precedb(x. # BecauseTbrowsers really handle (as opposedAwhateR says) we also encode "," and ";".P+Ytaken*0109 _LegalChars rahe lis@s whTdon'tq0 "'6#_T"or hash-tafor fast:hing # w=.ascii_lett&+s + "!#$%&'*+-.^_`|~:" _Unescaped(= Z+ ' ()/<=>?@[]{}' = {n: '\\%03o' % nA@n inz(range(256)) -map(ord, 8))}i.update({_ord('"')z6"',#\\\\', }) _is_l _key = re.compile('[%s]+2re.()).fullmatch def _ Se(str)r"""Quote v? Cin ar headerg" I#P does not nebe double-m d,QPn jus7I1theC. Otherwise, surround6}SRs F("\)&al!s.#4 ifS@None ^.!re1strEBelse_.(`or) + '"' _OctalPatt = re.compile(r"\\[0-3][0-7") _Quote.[\\].") def _unq)(str): # If there aren't any double,#s,(Cthen* ca)!be,special characters. See RFC 2109.Aif str is None or lenB < 2`return,7[0] != '"'9dstr[-1;<# We have to assume that we must decod isq2ing`# Down6cwork. N@RemoMQhe "s=;d[1:-1])Check for sequenceExamples#\012 --> \nX1" "Qi = 0 5n =Cres = [] while 0 <= i < nmlo_match = dp.searchA, i)B,q,b,tif not _1andC:OP# Neiw %eds$res.appendF[i:] Ubreak2f# elsej = k = -1#$if'I+.start(0j4if I5\5  (or k < j) %# Tk ';k+1!-Uk + 2*&# j~qchr(intj+1:j+4], 8))nQj + 4 _nulljoin(res) # The _getdate() routine[@used0set expiration time i cookie's HTTP # header. By default,bsSycurrentPappropriate # "v0es"0mat a Set-Cyppal argum_is an # offfrom now,`secondKRFor eOD, an.of -3600 means "chour # ago". C[@may  floating point number. # _weekdaynamec'Mon', 'Tue0Wed0Thu0Fri1Satun'] _month@W1'JaT0Feb80Mar!Ap0MayNJun'8 ul0Aug0Sep!Oc~0Nov0Dec8future=0, =%, =8Tmport gm,Qnow =(CyearT, day, hh, mm, ss, wd, y, z = gmtime(now + future) return "%s, %02d %3s %4d : GMT" % \59 (weekdayname[wd], day, month ], year, hh, mm, ss) class Morsel(dict):\R"""A to hold ONE (key, value) pair. /In a cookie, each such" may have several attributes, so thisk!isNused to keep the2 associated with`ppropr }.PTbalso includesBded_1, which is L network representation ofMy1"""5# RFC 2109 lists(s KBrved# pathscomment domain] max-ageQsecur versio'-For historical reasons,1re /bexpire#Xeis an exteny from Microsofthttponly< Bionary provirmappingPlowercase<variant onP leftB+aPtradi#al9pformatt]<Rright_A = {1b"U" : , "* WPath"=C ?A: "D?xMax-Age ?S y"HttpOnly!3`V@ samesiteAPSameS } `_flags3'D', 'y'%def __init__(selfy7# Set defaultf&._key = k&cob= None< SP0for<3 in\D.__setitem,:R, "")q@2ert_class___ame__z?js_# Print javascript%""<# type="text/9&">(!-- begin hiding@docu<!.c = \"%s\";" // end hiding --> <@,:/\$\*\+\-\.\^\|\)\(\?\}\{\="BVD+= U+Jq[\]' _Cm.compile(r"""0\s*@# Op^al whites% at start of A(?P 4# S5group 'key'[++"""]+? # Any worduat least onfhH)wA# En@ (% nal group: there may not be a value. \s*=\s* # Equal Sign2(?P/ # Start of group 'val'<"(?:[^\\"]|\\.)*"E # Any doublequoted stringA|1 A# or,\w{3},\s[\w\d\s-]{9,11}d:]{8}\sGMTpecial case for "expires" attNz[""" + _LegalVmChars + r"""]nword or empty) _# Endf,)?+ 8optional: 1`numberbspacesP(\s+|;|$|ing either at >, semicolon,2EOSP""", re.ASCII | qVERBOSEb#be removed if safe. # At long last,  is the cookie class. UsBthis is almost just like # u'Qa dicCry. See :module's docUexample usage. # ua BaseC(O!):"""A containerAa se\Morsels.""" 32def_decode(self,T"""real_ , (d =+$ue>qSTRING)[:Called prior tot-aD"'s@Q from\unetworkBrepresenta5. The VALUEgR readFEHTTP?bheadersOverridu1funamodifyPbehav#ofB;`return3 S en+S%>R)!%ryU!bessignedFEstrval =F(val`!, 6valf__init__binput=None1if "a.load()T3setQ0keyHc"""Private method?set@Melf.get(n&() M.,.__setitem=M # value):  """Dictionary style assignment.""" 'if isinstance(value, Morsel):&*w# allowI of constructed7s (e.g. for pickling)J dict.__setitem__(self, key, /Jelserval, cval = 9.3c_encod@%o(cB!) def output!attrs=None, header="Set-Cookie:", sep="\015\012"* """Return a string suitableIHTTPresult = []sQorted.&()`A in # .^r.append.Xrsep.join(+__str__ =1Ac__reprBl'%s=%s' % 3epr)'<%s: %s>6! class__.__name__, _space#l)-3js_E;!, K0  JavaScriprY.Q_null 2loa, rawdataaLoad c7fs from (pN`mably _COOKIE) or 210. SW V$E 'd'B is equivalent to calling'Bmap(, d.keys() LsH ,2.__parseMCing(/#update() wouldn't our custom  %__x/vZ 3r[key] =Q$ 9, patt=_\wPatternPi = 0k # Our startUpoint{n = len(str)6# Lengthw1 d_T![]60# Pyd (type} triplesBm@_see}False # A= pair was previously runtered+zTYPE_ATTRIBUTE = 1hpKEYVALU26# We first the whole cookie string and reject it if it's -# syntactically invalid (this helps avoid some classes of inT7ionLattacks).while 0 <= i < n:# Start looking for a ce)match = patt. (str, i)'qif not ! jnsNo morebibreak Skey, value =Y.group("key"),Kval"7jend(0)^if key[0] == "$"orsel_seeC# We ignattributes which pertain to th C # mechanism as a whole, such"$Version"8# See RFC 2965. (Does anyone care?8zcontinuparsed_items.appF(TYPE_ATTRIBUTE,D31:])c"elf.lower() in MO._reservedx)I3 string]Vretur0#ifa~is None&?key_flags59Bk, True=A?els/# 0 e_unquote() 1 is,qprKEYVALUuq, self.Qo_decodxmt! =l %ZRR5# TP, appt1M =|# current25selZ!tptpQ1 Pif tp  %sZ@rt Mv!M[key] =2 AV =\rval, cval`#a__set(3 t,S01 < SimpleCC(Bas )1"""& supportssmzs. When sett| the value using the dictionary assignment nota , SimpleCookie calls; builtin str() to convertPvaluea ping. VsFreceived from HTTP are kept as3!s.,1"""Adef W_decode(self,!):!return _unquote(val)$ #D/enDstrval =A;^!2, _dQ) """ server classes. Note: Base RequestHandler doesn't i~2anyr*b; see AQfor s>D s of GET, HEAD and POST, ?CGILCGI script!It, however, opFallyp/1.1 persistFQconne_As, avcon 0.3_s on / - b Thisfs BsPcgi-bfos.fork() fun0 isP presP(e.g. Windows), subprocess.Popen()5@useda fallback, with slightly altered semanticdn all cases, Z inTynaive --8 C`executaRynchronously. SECURITY WARNING: DON'T USE THIS CODE UNLESS YOU ARE INSIDE A FIREWALL -- it may ejp arbitrBpPython Y or external program  that status-0200lPprior0iona$S, so  cannot send otherY`s such302 (redirect). XXX To do: - log,even later (to capture byte count)2puser-ag"aheadery@restigoodies -Qerrorsto separate fileC # See also: # #]P WorkMPGroupT. Berners-Lee # INTERNET-DRAFTC$#R. T. Fielding # : H. Frystyk Nielsen # Expires September 8, 1995; TMarch/.PURL: p://www.duci.edu/pub// / N1andNetwork!R7 0Coms: 2616et al # Obsolete>>068)  Z June 1999 # Category: Standards Track # # URL: http://www.faqs.org/rfcs/rfc2616.html # Log files # --H Here's a quote from the NCSA`d docs about loH format.CP| Theb is as follows. Each line consists of: # |0 host rfc931 authuser [DD/Mon/YYYY:hh:mm:ss] "request" ddd bbbbC N: EitherDNS name oIP number of!0remhclientK: Any inion returned by identd this person,G@ - oXwise. Q: If asent a i\$entication,+n pxDD: DayMon: Month (caler5)&X Yearhh: hour (24- *`machinftimezoneSmm: minute|+ss: second:tRfirstWSHTTP $G!by- xAddd:status code  server, - if not availablMWtotalb`bytes *Rincluding/1.0 header*{ You can determbaccessed through%(Actually`latteronly trueyou knowQfigurQ # at was made!) __version__ = "0.6"1all [ "S{", "Threa" @BaseRHandler",C_Simpl _ "CGI9] import copy @dateemail.utilsl;.p$io mimetype:o posixpath,eselecthrocket # For getbyaddr()$ypurllib.parse+contextlib functools partial ]SV %Default error message template DEFAULT_ERROR_MESSAGE""\ <>8Eresponse Bbody h1>Error response """ DEFAULT_ERROR_CONTENT_TYPE = "text.;charset=utf-8" class HTTPServer(sockets 3.TC1): /allow_reuse_address = 1;# Seems to make sense in testing environmentMBdef i_bind(self):hQ"""OverridM'astore th` name. 9.onhost, port = ,E[:2]- {38.getfqdn(O)0c Threading!gMixIn,1daemon_t(ETrue`@Base[RequestHandljStream"0"""?" r@" hAa base C.`The fo%1 of& guyou through3as well a-expose any misunderstan4s I may have aboutE@(so bdon't need?mm ito figure out I'm wrongE3:-)O HyperText Transfer Protocol) is an extensible p1 onN0toppa relia"su tM (e.g. TCP/IP). QGDrecognizes7qee part#W1. One line identify70typUad path`2. An op`al setRFC-822-style ?1ers030Adata.Q and  arparated by a blankoQfirsthk"rmi <> fwhere &p (case-itive) keyword suchyGET or POST,]>0strOpcontain zq informA forhoD should bTnP/1.0";1". en@d us"AURL scheme (%xx to signifyJ2`ASCII acter with hex$xxspecifica-s cCRLF bcompatibilityowidest rangeclients Rmmendpcs also LF. Similarly, whitespache request li8ne is treated sensibly (allowing multiple spaces between componentsEEand 4Ptrail=Qwhite91). (Similarly, for output, lines ought to be separby CRLF pairsEbut most cli grok LF characters just fineyIf the firsto" orequest has"2orm (i.e. ?@left)A`n thissassumedqan HTTPC0.9 x;/Aformno optional head]data part andEreply consists1BThe *g 1.x protocol againQthreeo"s:b1. One:0givfresponse codOV2. An0setRFC-822-style03. jA,K( !; arqa blank ew<%> cstringZwhere>N0 ("Z/1.0" or A1"),^mis a 3-digit O indicatlsuccess orDpfailureZL,)`@human-readab explainpAwhat Umeanshis server*"se@ th;aalls a@func specific.7Getype (S). S+BallySaN SPAM willDhandled by a method do_$(IQIf noDsuch"!exLsends an error to#A. If it D, `is calwith no argum[fNote t@name0casnsitive qAspam)differenWEsquvarious:Pdetaictored in instance /,-}P_addrG#heE IP xb (hostbport);-Ok , jObroken-down7Ci%aof email.message.M (or a deriveR`class)OtyX0 in=asArfil!a object openh aN poRoned W stRinputlwb. l0wri*IT IS IMPORTANT TO ADHERE TO THE PRO+TOCOL FOR WRITING! The first thing to be written mustthe response line.:nCfollow 0 or more header(s, then a blankR, and1theCactual data (if any)cP mean of3 \ depends o@comm_executed by8 server; in most cases, ww!isreturnedre shouldat least on BformTContent-type: <a>/L .rwp('\r\n1 ($ =XZwordsz$if len(words) == 0: return False ,if len(words) >= 3: # Enough to determine protocol versionDe1 = KI[-1] :try5dif notP.startswith('HTTP/')48raise ValueErrorj!Sbase__number =hplit('/', 1)[? :P!.sFM".")*# RFC 2145 section 3.1 says there can be only one "." andJ - major r minor `s MUSTGtreated asA separate integers;*!- x2.4 is a lower8T than!13, which i @#! p#isF>O12.3Leading zeroignored by recipients. o) != 2I$ K =@(_[0]),*1]except (q, Indexself.send_e(gStatus.BAD_REQUEST,,"Bad requesv (%r)" % b 9$if5dP>= (1V6d"^/1.1"5close_conn?={O2, 0L0_VERSION_NOT_SUPPORTED[qInvalid A (%s\@hG OH2 <=< QY U QesyntaxPJlinePcommand, pathF&:2F_) 9ITrue3if n_'GET'# ',+1E/0.9Etype2 .<27self.path = command, path $# Examine the headers and look for a Connection dir 5ve.CEtry: WTself.K= http.client.parse_()irfile,AEq_class=HMessageC)OiexceptLineTooLong as errsend_error(LHTTPStatus.REQUEST_HEADER_FIELDS_TOO_LARGE"~ too long"!str(err)wreturn FalseE_Too manyJ(conntype = Ff.get('V', ""P4if 9.lower() == 'close'_4on = TruvPlif ( Tkeep-alive'C protocol_vers@>= "o/1.1") n ExpecteU4Q(4"100-continue"8request7bif notprhandle_[_100(d^-Ndef OS"""Decide what to do with an "Q*: -.!If4B is i<i response, we mustd|Peithe6100=UfinalHu beforeF@waitw! body. The defaultto alwaysOdG . You can behave differently (pXexamp0rejunauthorized s) by overridthis methodYT should  (possibly after 5ingaRse) o,; cF5"""U.w_`_only()zCONTINUE5Ps() return True def handle_one_request(self):"&A"""H% a single HTTP /.L*$You normally don't need to override this method; seue classq__doc__ string for infXtion on howU specificFcommands such as GET and POST5"""46try D.rawrline = file.readu(65537)K>aif lenP E@) > 26p6]ZY = ''X &P_vers*Lsend_error( Status.REQUEST_URI_TOO_LONGireturncif not* Aclose_connec=am FparsDQ# An  code has been sent, just exit=y@mnamr'do_' +l @qhasattr!, > JNOT_IMPLEMENTED,0"Unsupported (%r)" %m = get *(Vw@flush() #actu9 the response = almZ%e.eexcept TimeoutEef0#a = or a write timed out. Discardeq3log%""RH: %r", erEt+$multiples(ecessary.qT Vwhile R suOrO.,0, mge=None, explain ASendTlog aWreplyArguments are{*l: !an:&v3 digit*:m opQal 1 reason phrasS*( HTAB / SP / VCHAR / %x80-FF |-defaultsshort entry match3 >code * )explain: a detailed message defaults to the long entry matching+response code. 0This sends an error ,(so it must be calbefore anvoutput has been generated), logs], and finallyya piece of HTML @Guser6"""Etry:Ushortmsgngmsg = self. s[]5except KeyENq'???', F%ifzis NoneI$= ; ;=5msg:Alog_/ ("E %d,A%s",)=_(@* header('Connection vclose')3# M@bodyomitted for cases described in+# - RFC7230: 3.3. 1xx, 204(No Content), 3t ModifiedC1: 6.3.6. 205(ResetC=1if p >= 200e) not in (HTTPStatus.NO_CONTENT,040_RESET3NOT_MODIFIED)):_#Ln to prevent Cross Site Scripthyattacks# (see bug #1100201Zcc =)1lf.z__format % {V9'"':B': html.escape(, quote=False)['# > > {} !.eHp('UTF-8`replacI"r-Type",)[Z_type| Fe-Length', str(len(&))?;Bend_'s("if@comm!= 'HEAD' J CLwfile.writem deM&nd1. a=a"""Addh s buffer!lo:E AAlsoY two standard`as withzserver softwareXqversionte@curr08dat9r log_request(  Q_only&[sage) self.send_header('Server',version_string()) :DDate8date_time:;Adef presponse_only(N, code, message=None):6t"""Send the =  DE."""-iflf.request_ != 'HTTP/0.9'\`$ifz@ is } $2 ins+/+ =.[EE][0].OelseL )''7if not hasattrJ's_buffer'Iht.(J = [& .append(("%s %d %s\r\n" %d.protocol P)).en(DH'latin-1', 'act')) /Vr, keyword, valuKda MIMEE!to\C"s 9V0e9:+ (!jL$if[.lower() == 'connectionZ .Klose)]pc_Qy = TrueBelif Xkeep-aliv]VFalseKsK=blank line ending@Ss>-  }!b"u>Tflush6(# ]/ifD@.wfile.write(b"".join4 Z;}Clog_R20='-e0ize """Log an accepted >.w@Thiscalled by'(), Pisinstance( , HgStatuse! =.3p('"%s" F5s','+ 8pQ, str) Hsize dDerroformat, *args):  """Log an error. This is called when a request cannot be fulfi#U. By?default it passes the message on to log_'(){Arguments are8same as for6AXXX should godvseparateAm6"""Xself.format, *args))0defD5,*: barbitraryis used by all othe ging functions. Overrideeit if you have specific=iwishespe first am, FORMAT,aA str} orpa!befped. If& <contains=any % escapesRiepmeters,G#y b ed @subsns (it's just lik:xprintf!gThe client ip and currpdate/titre prefixed to?eve Nys.stderr.write("%s - - [%s] %s\n" %Sx(Y.address_?(),1 1_7%tversionC])`Return server softw<@.r6O.7_.r+ ' ' +4sysx G , stamp=None80ted $ ay header&ifk(nR! =+.%()email.utils.(->, gmt=True[4mat0log ?nowyear, month, day, hh, mm, ss, x, y, z<PlocalsF(nows = "%02d/%3s/%04d :U" % (-Qn.Qname[ 2], mks>pweekday< = ['Mon', 'Tue0Wed0Thu0Fri1SatBun']EuC1'JaZ0Feb>0Mar!Ap0MayOJun'; ul0Aug0Sep!Oc0Nov4Dec % lient address.""C" return self.client_address[0]'# Essentially static class variables*The version of the HTTP protocol we support.# Set this to,@/1.1 enZa automskeepalive9R_o0= "kC/1.0# MessageC@usedYparse headersL 'c= http .S@hackHmaintain backwards compatibility[responses = {y v: (v.phrase, v.description)%for v in Status.__members__.values(1B} `SimpleRequestHandler(Bas"):2""":o" r<" h= with GET and HEADbmands.@Tserves fil1romcurrent directoryE0any#"it4sub `ies. KMIME type Wis determined bgqcallingop.guess_7() methodes are idcal excepae0a omitsnactual contentsu#""rrd/" + _!__nPextenLs_map = _encoding_default['.gz': 'applicaSq/gzip',S~<'.Z"octet-stream*y = os.getcwd r.%ufspath(L.uuper().ado_GETP! ar9. `2f =yPsend_Jif f:tryD@copyq2(f,Qw)0finBYose()$)}  RCommon cod "ndAaz$er8Rbneither a object (which habe copied!to!`output1 byer unles@comm1waslPmust ` lo Fdll circumstances), orNone, in which case the caller has nothing further to do. 5""" path = self.translate_( ).f = None`if os.%p.isdir( %): rparts = urllib.parse.urlsplitf5 if <`endswith('/'b1# redirect browser - do@basiy what apache doesFsend_response(HTTPStatus.MOVED_PERMANENTLY=Anew_A = ( B[0],%[1 2] + '/',EA37/4]r?urla"unc=header("Location", 8?url6Content-Length", "0"8]m.s(#jreturnefor index in " P.htmlk"y8% =Ajoin,Oqexists(Ds`" =LYbreakNelseRlist_1oryTctype`guess_ &# check 8Ptrail "/" which should u404. See Issue17324# The testLhis was added_httpserver.py<However, some OS platforms accept a `Slash [ filenamh# discussion on python-dev and34711 regardingw,Prejec5 ofm s _ sD0if .;"/"?Xerror<NOT_FOUND, "File[found) g:try24opeF'rb'"!exZ0OSE 9=os.fstat(f.6o()@U# Usecifossibl,if ("If-Modified-Since"V4<Wq-Match""in< ># compare {x@timeG la#mG (d im1email.utilW@rsed0to_k(  self.headers["If-Modified-Since"]) - except (TypeError, Index OverflowBValu'-):KQ# ignore ill-formed v5s/>pasOelse^if ims.tzinfo is Non+obsolete at with no timezone, cf.@ https://tools.ietf.org/html/rfc7231#section-7.1NQims =replace(P=date.N.utc <=@# compare to UTC @ of last m2 ca*_*% =C.LP.fromostamp(Fafs.st_.,J=  <# remove microseconds, like in   .`O=0) HiD<send_response(HTTPStatus.NOT_MODIFIEDDHG(/ f.close& areturnd n*OK}.("Content-type", c4Length", str(fs[6]); ELast -",_x_string(bm7fhc Rraiseldef list_directory(g, path}"""Helperproduce a 6Eing (absent i.").kARY either a file object, or` (indi$Vng an@s). In Acase, the  s }P, mak5theBinterface3psame as oD(5"""<:tryd?` = os. Adir(<11 OS <l.te ^FOUND["No permission";1.sort(key=lambda a: a.lower()3) er = []Etry: #displaypath = urllib.parse.unquote(self.!,:> errors='surrogatepass'except UnicodeDeE4X html.escape(!, f=False<enc = sys.getfilesystemencoding(*title = 'Directory listing for %s' % q>r.append('z(>\n6encNYR>%s=sreturn f }def translate_C , D"""T' a /-separated PATHthe local  syntax.kComponents that mean special things to the local file system 0(e.g. drive or directory names) are ignored. (XXX They should F probably be diagnosed.) h5""" # abandon query parameters#ppath = .split('?',1)[0]$ #$4# Don't forget explicit trailing slash when normalizing. Issue17324p4_4rstrip().endswith('/')5%y: . = urllib.parse.unquote(, errors='surrogatepassSexcept UnicodeDeE4iwm@osix .  (Pwords)4ath filter(None, DW = self.m!1for11 ins`if os.C<(_) 7(os.curdir,- )H1# I components thatnot a simple7/Jcontinue" =qth.joinR%if\ Ge+= '/'_areturn ddef copy(^, source, output """Copy all data between two objects.` The SOURCE argument is a0P openo readingq(or any )! a$() method) andDESTINATION?r@writ6(or7 r$es @only"so`overriQ0s wto changgblock sizLaperhap replace newlines by CRLF-- note however0thie default ser0usei/bbinarywas welltshutil.3Oobj(0\guess_type^ PG#'3 ofA7bPATH (?)*RRvalueeh ngWkPform h@/sub,L@usabp MIME Content-(w headerkbation lookk's extensionnpvtw|.'s_map, us ap~Z/octet-streaaM; &itxpermissi1(if slow) to! look inside the data to make a better guess. 5""" base, ext = posixpath.splitext()-!if*in self.extensions_map:'g_retur(U[ext],zext.lower(mJ , _ = mimetypes._ L'application/octet-stream' # Utilities for CGIHTTPRequestHandler def _url_collapse_path(Given a URL , removera '/'s and '.' element_any '..' reference%Ds a /dKM4ImpSsomething akinRFC-2396 5.2 step 6parse relativeN!s.QThe u#y of this funcN is limitedEpis_cgi s!odQhelpsGpprevent security attack R0s: wreconstituaURL, which will always start with ^ Raises: IndexError if toWQoccur;h@# Query component should not be involved-A_, q5=I`.parti0B('?'K) = urllib!se.unquote6# Similar_0os.7(@norm7) but specific63URLK& semantics rather than local operaVystem-_s3('/Ehead![OU41 in R[:-1]91if $!==V.pop() #Amore8QpriorP{D$elc|l!l'kqappend(H C"th9Atail s{}(;  & Y)'' BFelseC2 ''"if&?'.join((<"))@ = I +#55), Ab = "/"6RbrS+1 nobody = None b_uid()"""Internal routineVBget -'s uid""" global nobody if:creturn6tryimport pwdexcept IVError+J!-1* F =H.getpwnam('Q')[2]4^;Key[) = 1 + max(x[2] for x inVaall())L: def executable(path)q"""TestO" file."""Nos.access@ , os.X_OK) class CGIHTTPRequestHandler(Simple1): ^P"""Co#0te & server with GET, HEAD and POST commands.?1GET%qlso supprunningt script49TheL is *only* amented;CGI=# Determine platform specifics# have_fork = hasattr(os, '"')# Make rt unbuffered -- we need to read one lpthen paskp# the rto a subpro@, soJcan't use cainput.rbufsize = 050do_uS(self28@"""S" aHr"@ThisWVU3Y 0if t.is_cgi(|2runBelse)`send_e(+rStatus.NOT_IMPLEMENTED,,Q"Can "6qOhead8Version o0nd_'U thatU r0.iGrwhetherg corresponds2a/Ras Truequpdatescgi_info @PibuteJUtupleQ(dir,).Tires  ^pFalse oGwiserIf any is raised,0allhould assumewas rejeckas invalidact accordinglyvdefaultW atdtests normalized urlbbeginsfW!of`string|directoriek,( next charactera '/' orP0end[)Mcollapsed_t= _url_N7dir_sep = +ed_path.find('/', 1) while dir_sep > 0 and not collapsed_path[:$ ] in self.cgi_directories:T[.+ =HR.find#+(if Rhead, tailU,o[e):]vinfo = ^ 'return TrueqFalse   = ['/cgi-bin', '/ht ].def is_executable( , h) """Test whether argument(v is an D file."""#(a opython%! P?y script}P` = os.{.splitext.lower()e(".py", 6w")qrun_cgi 0ESe a CGI`dir, rV=6 = + '/' +0 1i =len(dir)Xfi >= 0snextdirG:[:iS[i+1:8>oD:.translate(C5%ifeisdir(FC)'N , W.+JelseRbreak # %plicit query string, if present.C, _,+=.partition('?'Ccdissect the &a aftery name into aN&w# a possible addm!al#, to be storedPATH_INFO=P?if A=F'[in<F, ''|! t J !I ZcexistsK send_error(}HTTPStatus.NOT_FOUND,&"No such (%r)" % ZK!if is3FORBIDDEN;qa plain ispy = self.is_python(scriptname) "if&have_fork or not ispy:'.!ifUexecutableYZfile)370send_error(T!HTTPStatus.FORBIDDEN,*R"CGI 1 is (%r)" %! hureturn ^&# Reference: http://hoohoo.ncsa.uiuc.edu/cgi/env.html>"XXX Much of the following could be prepared ahead)Eime!Eenv = copy.deep (os.environenv['SERVER_SOFTWARE']version_string(77NAM3rserver._0['GATEWAY_INTERFAC;'CGI/1.1'-PROTOCOLprotocol_72ORT33tr(5KportREQUEST_METHOD=ucommandguqrest = urllib.parse.unquote( YPATH_INFOT?N"TRANSLATE|translate_path(< _vSCRIPT_ eQUERY_STRINGZquery$REMOTE_ADDR#:client_address[0]4authorization9ers.get("""9if   * =+g.splityif len(9j) == 2Z,m base64, binascii$AUTH_TYP ` 0 [0].lower(~"basic"<+tr$ z [1].encode(''jA I0.de?[bytesF-.\L E except (w .EP, UnikOpassOelseX; R/':7aqEW2USEW ~G # /UIDENT\4ead_'content-type');NonvCONTENT_K_K] else:  $env['CONTENT_TYPE'] = self.headers['content-type'] =klength.U.get(2#%')42if :O aLENGTH,+referers lmHTTP_REFERERk+loacceptkb_all('V', ()ZaACCEPTY','.join(3./ua^('user-agent/uaUSER_AGENq%uaco = filter(None,cookie', []0_str3', &co6if &RCOOKIY-# XXX Other <#* z#Since we're setting the env in parent, provide emptyCvalues to overr#previouslyU "3Pfor k^('QUERY_STRING REMOTE_HOST@,C'", )M.setdefault(k, "") hsend_response(pStatus.OK, "Script output follows"Ccflush_(adecoded_query = .replace('+' '1#ifkave_fork# Unix --  as we should9args = [s|if '=' not m-I.append(+'Pnobod Z_uid("(awfile..() # Always q before9ingpid = os. Y0if N!= 01# P Nppid, st%os.waitpid(0.# throw away additional data [see bug #427345n?@whilplect.se!([r]@^0)[0]E!if7{.read(1+]break@exitRsD_to_N(sts4if !log_error(f"CGI : x{E}Hireturn[# Chi>tryY os!ex0OSE[ p[ass os.dup2(self.rfile.no(), 0)0 w+010execve(script2, args, env1}except:userver.handle_errorequest, 'client_address`os._exit(127) kJelsey # Non-Unix -- use subproceGoimportcmdline = []x"ifis_python,)/nterp = sys.]iutableS(1f i+.lower().endswith("w9"]9# On Windows,4b, not E wBx# =t[:-5] +:-4:3(>`, '-u'7 jaif '='in query*9.append(& 3 log_message("command: %s",c.list2R()Ntbnbytes z(length6p (TypeEb, Valu Q0d.Popen,*o fstdin=_.PIPE8?out9#?err9 Penv == ih == "post" and _>> 0Q@datay-Rread(3 mQsA:Non # throw away additional 0[see bug #427345=PwhileAect.select([_sock], [^0)[0]!ifM 9.recv(1YbreakPstdoutderr = p.ounicate( (qIbwrite(B %Q@q'%s', s- D"p..close(?outPstatup.returncod%R"CGI   ]0%#xoj I Yed OK") def _get_best_family(*address): infos = socket.get ( $3,Stype=3SOCK_STREAM!Tflags"AI_PASSIVE!)H , L, proto, canonname, = next(iter("s)Atreturn H0 def test(HandlerClass=BaseHTTPRequestT Serv-Threading2*Pcol=" /1.0", port=8000, bind=Nonef"""Test the 2" r" h c!. This runs an.s1 ond dA (orOv argument)C1"""K.3ess ,  = _get_!))F_version =1colrHwithI(g(, D) as httpd|Bhostu" =. a()[:2]g4@url_8p = f'[{ }]' if ':' in Q else 8VprintK f"*2ingp2on Op{d"} S/0f"(D://{"}:*f/) .../56tryC!d._forever(/ except KeyboardInterruptD4"\n($ i) received, exiting."_@sys.(0) if __j__ == '__main__'q im mRparse 5r =#.AP%'_('--cgi', action='store_true'mhelp='RunF3CGIm'g ', '-b', metavar='ADDRESSl mSpecify alternateAUess 'Z '[default: allofaces] directoryCd', H0=os_cwd()'Eive Yvcurrent6 ! ` O=intnargs='?S rU.Cs ifRs.cgi_` = CGI \8partial(Simpl w=.y) # en,sure dual-stack is not disabled; ref #38907 class DualS0Server(ThreadingHTTP!):04Qdef s)_bind(self## suppress exception when protocolEIPv4V7with contextlib.E$(EE h5.socket.set Iopt(Y(et.IPPROTO_IPV6, V6_V6ONLY, 0)@`returnXer().!) *7testHandlerC^"=h _l,.X# %port=args. y ) """IMAP4 client. Based on RFC 2060. Public:;@vari3!TDebug@funcsInternaldate2tuple^oInt2APParseFlags#XTime2r # Author: Piers Lauder December 1997. #<`enticaQ code"ributed by Donn Cave JuneT8. # String methodL@vers by ESR, February 20012GET/SETACL/t{Anthony Baxta @ixlink.comUAprilR=_SSQTino Lange < . @isg.de> MarchF2^QUOTAdreas Zei (,j0LOS% '"OP(N"RE' ADELE.2ACLh VENABL.eEXAMIN%$+ .GPUNG.*RFETCH*5GET6.NNOTATION': GETQUOTA.AROOT MYRIGHTS\0LIST  SLOGINYp&FLSUBh 5MOVNAMESPAC, INOOPcPARTIA o # NB: obsoleteQPROXYc  RE#GSEARVU@OSETA@S@:SOR9ED'BvSTARTTL9ZTSTATU$M 'STORE'#: ('SELECTED',),  'SUBSCRIBE'+('AUTH', /.bTHREAD+? U&UI$' N~| "UN~|C} #LPatterns to match server responses Continuation = re.compile(br'\+( (?P.*))?') Flags+.*FLAGS \(1f$>[^\)]*)\)') InoalDate=INTERNALDATE "'0br'Pday>[ 0123][0-9])-mon>[A-Z][a-zQyear>) )Z E8hou, ):7min@8secJzonen>[-+])Dh2m G$"') # Literal is no longer used; kept for backward atibility. < 0.*{size>\d+)}$',ASCII) MapCRLF\r\n|\r|\n'Weexclude the ']' character from8A por]!of| # code, even though it violates-RFC. Popular IMAP s such as Gmail # allow yP withP, andIre are programs (in ing imaplib!) that can #)1ducam. Th<Bblem\@thisio'text'o@es a we'll parsc wrong (which`\cpoint >PRFC #0@tricW). However,seems less likely@be a@in pPice #5@n be `unable0correctlyX"1s, # was re eda real-world~issue #21815. R_[AtypeL-]+)\]') Untagged_aJ*K KQstatuC Bbr'\& 2A# Weihese in _mode_xxx. _?br', _/= $ class14: @r"""4 client #.Instanti:;([host[,P[, timeout=None]]])= ,! -'s name (default: localhost); qport - number (default: standard IMAP4%)).?`timeouBtsocket EYNone)5%If1is not given or is :,:the global  is used A2Allrev1 commands are suped by methods of bAsame@name (in lower-case).[arguments to^convertedstrings, except for^AUTHENTICATE, and}Tlast Z?APPEND which passed asE"an literal. If necessary ( contains any=non-printing characterswhite-spaceisn't enclo~AwithCeither parenthese>double quotes) each dSHowever,'Yword'TLOGINeERalwayPyou want:avoid hav&anT8B(eg:Zflags`STORE)n nCO"(\Deleted)"7E ` retur tuple: (type, [data, ...]) where ''hually 'OK'B'NO'B';' <text fromDtagged response,E&unBults2!. _C3is ca Fa. n|` first-tDdheader~asecond7@=s (ie: 'e' valuErrors raiseion class .e,("" qserver $P<Xabort<ba sub-sAof 'H'. Mailboxw0tus2ngeREAD-WRITEOONLYreadonlyP '""ions imply a program"<.pconnectxshould be!et$0 re-trie0"f6c@cPNote:Juis module, ;Pmust c*RFCs per6D toGprotocol, as semanticL$:D\1lefPinvok0to d70resb. AlsobAmost s implement a" sub-set of the commands available here. """ class error(Exception): p # Logical$s - debug requiredFaabort(LBo# ServiceFclose and retryGreadonly(PJ# Mailbox status changed to READ-ONLY,def __init__(self, host='', port=IMAP4_PORT, timeout=None):7.0= D e = 'LOGOUT'literal = WPD# A argumenta Jutagged_C= {}L1# T9s awaitinjsponseL#unN"re$s O# {typ: [data, ...]}Bcontinua)_F'-Hast " " E4is_ = False& #@ desd tagnum = 0Z_tls_established_ &mode_ascii()2# Open sockevserver."Popen(OLAJ6tryI[9_connect()eu | 6 GKshutdownKO0OSE M |Rraise4 putf8_enO[Pencod1= 'b Lre.compile(_, re.ASCII#$.Uvu> F  ;Trus__utf-8)') D# Create unique tag for this session,#{~,Gn matchPtagprInt2AP(random.int(4096, 65535)1tag9br'(?PG + .y" + br'\d+) Rype>[A-Z]Y>.*)'9b# Get  welcome message01est8store CAPABILITY*i>*___cmd_log_len = 1 #9idx"_cmd_log = {&} # Last `_cmd_log_len' interactions - if self.debug >= 1: ,!_mesg('imaplib version %s' % __?__)? new IMAP4 conneb, tag=Iktagpre) Jwelcome =_get_response(vif 'PREAUTH-untagged1sa@stat_'<} elS/OKN%IV\('Non-blocking# (<4=0)[supported'! =u$elsys.audit("q.open",?s uraddress = (V$3if  I.h,J:xv=Hport=IMAP4_PORT, timeout=None): $"""Setup connection to remote server on "host:port"<C(default: local&standard IMAP4 5%).6HThisn will be used by the routinesl`read, line, send, shutdownb&""Pself.0 = ! = qsock = %_create_3et(I)1Dfile1)P.make('rb') /1def(Y[, siz`Read '' bytes from.breturnh.(: m-q kcc(_MAXLINE + 1 pif len("D) > % 0aisY lf.error("got more than %etes" %BccS j, dataASend Isys.audit("imaplib.P"`#lfR.%Aall(r Close I/O established in "open"vc6(:tryS|ocket.SHUT_RDWR>except OSE~z as excP@# Thmight al_qy have d6'# On Windows, tmay resultWSAEINVAL (g 10022/FAn invalid operawas attemptedxpif (exc[no != errno.ENOTCONN^ and getattr7a, 'winP', 0)A>rPofinall2(C/et$R0 inMc$to9^.`ZD = <=>'etDJ= #N Utility methods?cenpmost re% 'RECENT'ponses if any exist,Kelse promptfor an updat 1ing~'NOOP' commandp(typ, [*])  ''' is Noneno new messageslist of (, Flastp0nam+4datG_untagged_res3('OK', [0], I ifC[-1] return typ, dat  = self.noop() # Prod server for response;breturn7_untagged_'(Z, name) 95defJ(r, code):B"""RZIdata{ ',0' iDceived, or None.`BOld value=s cleared3(Y0, [s]) = .$)   90, [].upper()F# IMAP4 commands5cappend3mailbox, flagse_time, messagQA=1 to#d H 4|  All args except `' can be/1"""> = 'APPEND'dif not@47YINBOX64 0Aif (B[0], -1]) != ('(',')'b)dr(%s)' %Jelseg1 ' if /2dat = Time2Internal(r%! =cvliteral = MapCRLF.sub( C-"ifutf8_enabledOb'UTF8 (' + V+ b').=&n Mssimple_( ,Ofauthenticate7echanism, gobjectG"""A6 - requires processing>$'mb' specifies whichrEion *e is tobe used - it must xXar incapabilitaVin thform AUTH='cbe a call :! =$()-pIt willR edo.Pcontinuat D)s;8Pument`is pas da bytes. It should BY6thabase64 en@d an nt3theYLa.0cliVabort&4'*'bRunstead.M& =(-c# XXX:Tn't thisCqAremo4ented out?   #cap = 'AUTH=%s' % mech #if not 'in self.capabilities:% # Let the server decide!I)@rais"lf.error("S.oesn't allow %s authentication.")Pliteral = _A10or(?object).process:typ, dat =_simple_command( ENTICATE',xif typ != 'OK':Vdat[-1].decode('utf-8', 'replace')YTstate']`returny! 0def y(A)A"""([data]) = &y(VFetchSies list fromB."""~1namCAPABILITY|g<{._untagged_responseRdat, 7OheckCpoint mailbox o.?Z#B3 @xCHECK')Olose currentlyTectedADeleessages are removedwritable=qThis is re`ended and before 'LOGOUT'v 6try  v'CLOSE'kfinallF#"op=0_seJ3ew_ 7rCopy 'mi,#' s onto end of 'nB5MZ', Dk1OPYBreat,# "  8(L#REk;d<? ol7Z'BDELE"\:aclZ, whou:bACLs ( any rights) set for=mailbox, who)  A""" + return self._simple_command('DELETEACL', mailbox, who) @def enable(@, capability):"f"""Send an RFC51615 string to the server.[9 (typ, [data]) = .vpo if 'ENABLE' not i86iestraise IMAP4.error("SQ doesEsupport Y%")n/ =P3')?if typ == 'OK' and 'UTF8=ACCEPT'y.upper(h._mode_utf8(gRxpungO"""Permanently remove deleted items from ec"Generates 'EXPUNGE' response for eachTwmessage@ '|' is list ov#d ] numbersMorder received.fname =%I9 ~untagged_ Rdat, 7Sfetch^T_set,j_partsF4! (D of),sZ\, ...axrw&q' should be a&of&&G`enclosQn parentheses, eg: "(UID BODY[TEXT])"are tuplesKt envelopeK eFETCH'J{dgetacl 1Get<AACLsQa*_Hb  I'GET#G'A") Unnotation, entry, attribute VPRetrieve ANNOTATIONs."=H T7Z >Qquota9, root):  %"""Get the quota root's resource usage and limits. 8qPart of=IMAP4 QUOTA extension defined in rfc2087?(typ, [data]) = .get()q5""" =dat = self._simple_command('GET!',Fcreturn6untagged_responsebdat, '@") Ddef (x, mailbox):T1lis#Qs for3Tnamed?[~@ROOTrs...], ]? F' AS@@D O[P,] directory='""', pattern='*'LH s? matchingBEw&'@P' is 5t8LIS#@ = ','"#96%,  l/._ K>Slogin}@user\jsswordpIdentify client us]laintext pa6hv p\TNB: 'R' will b5ed.7YC 'LOGIN', u)$e(i)Oif typ != 'OK'GRraiseerror(dat[-1]>]PstateFAUTH_cram_md52 Foe~CRAM-MD5 authocation|$q) .# =c>.4e('"',X_P_MD5_= %challenge Authobject to` with ]* Pimport hmacapwd = u..encode('utf-8') if is7 ,V, str'M  else self.password) %breturn,user + " " + hmac.HMAC(pwd, challenge, 'md5').hexdigest() Pdef logout(n!):j"""Shutdown connection to server.A+ (typ, [data]) = .\)-RsF 'BYE' response. .state = 'LOGOUT'}Rdat =_simple_command(1AP(YQ#1sub!, directory='""', pattern='*'>List 'subscribed' mailbox names inL matchingO^], ...c |'' are tuples of message part envelope and .?SUB6A< _untagged_hAdat,CUmyrightsi Show my ACLs for a(i.e. the G that I have on() 5""" f MYRIGHTS',<''F-Qspace. % AIMAPf*s ala rfc2342Pj GNAMESPACELUrOnoopSend NOOP FNif __debug__e>"ifZ >= 3 $qdump_ur.sy  '1ialW,F_num #, start, T*th8Fetch truncatedM ofd_A6m"is-PARTIAL6C gth) 8 return self._untagged_response(typ, dat, 'FETCH') def proxyauth(?, user):#"""Assume authentication as ","".L-Allows an-orised administrator tor into anyq%'sqwmailboxV[data]) = .)E6"""name = 'PROXYAUTH'( 9simple_command(06 reV(33oldS, new ER1S old  B?newuo RENAME', Tsearc#charset, *criteriaS-for matching messageswqpon, ...)' ' is space separated list of numbers.8pIf UTF8Eenabled, z MUST be None2j= 'SEARCc$ifEU"ifSutf8_p "&raise IMAP4.error("Non-W not valid inVmode"I" =w_, 'CHARSET'*Jelse_0K  cselect ='INBOX', readonly=False:$ aFlush all  F]( Bcoun$I ('EXISTS')AMand are ('FLAGS', >, 'RECEN'UIDVALIDITY'), soUotherjs shouldobtained viays_) etc*5.``s = {}"# ,W?4is_% =%if F vEXAMINE +fSELECT*if typ != 'OK'Astat  # Might have been_ED'  return typ, dat self.state = 'SELECTED' if 'READ-ONLY' in 2untagged_responses \4[ and not readonly:"if __debug__@"ifi!^ >= 1$(_dump_ur()yRraise^q('%s iswritable' % mailbox@Gm .get('EXISTS', [None]) deAtacl,bP, who6at)"""Set a&R acl.I([data]) = .sedY^>5"""  _simple_command('SETACL' nnotationZ*args B[, entry, attribute]+ ANNOTATIONs. Rdat ==2', @  Wfdat, ''Squotaroot, limitAthe . ('s resource2E(Em qQUOTA',N!H 3ortsort_criteria, charset, *search J IMAP4rev1 extension SORT 0 V, ...|L2namB6ORT>1#ifT<capabilities: # Let server decide!#( error('ungmented @: %sIif (uJ[0],-1]) != ('(',')'| -;@(%s)i k ), < Xa ~ttarttlssl_context=:STARTTLSHAVE_SSL!SSL support missing'`tls_es_ishedV ab'TLS ses al!y ?lished')  if name not in self.capabilities: &Rraise%abort('TLS<supported by server')<# Generate a default SSL context one was passed.=uif ssl_+js None!=/._create_stdlib>(typ, dat =_simple_command(.if typ == 'OK'}5@sockK`.wrap_1et(Y ,U NP_host=KC@fileP.makeG('rb1_tls_established = TrueZX_get_K;els)error("Couldn't m <session"Sretur_untagged_response(,1) def statusj, mailbox&&s)"""RequestAd7ditions for@._/z[data]) = .z t:5"""  = 'STATUS'#PROTOCOL_VERSIONsIMAP4': # Let the decide!Ir a'%s un0men1in Vd (obtaCrev1, or re-code)' %/n? (4oreessage_set, k, flagaAltersx disposFsm?Aif (B[0], -1]) != ('(',')'%51(%s # Avoid quotingx 'STORE', y'FETCH'uubscribD"""S% to new>( 'SUBSCRIBccthread ing_algorithm, char*search_criteria{lPextent THREAD ?e, z(eria, ...)  B"""  name = 'THREAD'typ, dat = self._simple_command(8", threading_algorithm, charset, *search_criteria)^creturnZuntagged_response(},1) 9def uid(#, , *args):#"""Execute "% arg ..." with messages identified by UID,FJrather than8 number.%[data]) = .,1 2,)BR$s  appropriate to 'D%'.$ =v.upper(rdif notR in Cs:Rraiseerror("Unknown IMAP4%Et: %s" % l0.stwo[]x ( %s illegalTF%s,  "only allowed:sE 7({,s*', '.join(X&))7o/UIl$if('SEARCH@SORT$WOJelse)f'FETCH"'nsubscribewmailboxF"""U' from old *|B(9? 'UNSUBSCRIBE', qnselect 0FreMQrver'ources assocd th'EeBand "s )P@authacated $EThissperformE`action CLOSE, except{tthat no s are permanently removedAcurrDU:try3afELECT'RkfinallJn= 'AUTmQxatomA b extensions4&no!seKAPABILITY0UeAssume is legal in current state. !(typ, [data]) = .xatom(name, arg, ...):$Returns response appropriate to extension command `L%'.|5""" 0 = .upper()q#if not in self.capabilities: # Let the server decide!I(@rais"lf.error('unknownq: %s' %y C%s:gf[Q] = (,LrE_simple_/z*args) y#\p Privhsmethodsdef _append_untaggedx!, Fdat)if dat is NonecU= b''Bur =Z_s%if __debug__Q"if=Z >= 5 u"P_mesge[%s] %s += ["%r"]' %y?len(ur.getP'')),) ifV*urur[typ].P(<o;els1.! =L]check_bye?byeTY'BYE'+byyabort(bye[-1].decodt._encoding, 'replace')U46u,", {:z*:in  DN.literal =hDQ"pillegalqF%s, 2@ "only allowed:_s %s".Gpp,$ ', '.join()Z*4fora@('OK4 NOGBAD' 0h ]32delX- 'READ-ONLY'G8% \ypis_reada !('mailboxpus changedM4tag _new_tagD = bytes#0 = P+ b' ' +0argZ if continue>tTif is'(;str)g'r-6argH3if not None:  self.literal = None if type(#B) is9_command):5;1btor = l$Oelse6 Wqdata = + bytes(' {%s}' % len", encoding) if __debug__"if6Z >= 4 Wmesg('> %ry)`&<-lo;<:trys3Psend(ev + CRLFlexcept OSError as valBRraiseabort('socket e3@: %s:val# Teturn tagWzwhile 1)# Wait for continuation response?6CT_get_&(bdtaggeds[tag]: # BAD/NO?\bre# Send <#if:tor:0Ator(l=J (%_Swritecl size% }U}x# '!8cif notVbreakgDdef >Qpletep, name,logout = ( == 'LOGOUT'P# BYE:expected after )wR RS_check_bye(\ Btyp,=;BRtag, Q=Wx'LG3 =>d,)b{b %/('b PJBAD'3%s @ v |capabilities|qP ,y if[]self.error('no CAPABILITY response from server') dat = str(dat[-1], self._encoding+dat.upper(2capabilities = tupleU.split()) vdef _get_(?"):f# Readand store.A#  Returns None for continuationF's,3potherwiEirst% line received.()&()!`# Commicomple|?(#if`Qmatchq.tagre,%):4tagvmo.group('tag'pif not ."in`tagged_csW4 ra{.abort('unexpectedJ&ger: %r' %G?typ;ype(otr(typdSkKdataS [tag] = fV[dat]Jelse adat2 =: # '*' (un`)Gs{_U5=9 >ostatus<@8 +'2'+xBmo i+ $q# Only a possiy2X'+' (Y'..)HpC hFg{r # NB: indicates# / "  "~0if @ P= b''t# Null  xF#2:?R+ b' ' +23P# Is Re a literal to come/RwhileL5,] \bdirect`connecosize = intj%&')fif __debug__""%_ >= 4(,)_mesg('r0 %sU :(' b# Store response with literal as tuple self._append_untagged(typ, (dat, data))9# Read trailer - possibly containing anotherFbdat = get_line(n7dat-# Bracketed response information?if typ in ('OK', 'NOBAD') andsmatch(RMQ_code)):JLmo.group('type')("trbencoding+h'if __debug__"ifQ >= 1 {, 'BYE'=~_mesg('%si: %r' % areturn, Pdef _r_(_ , tag, expect_bye=False):<zwhile 1UresulQZcommands[tag] if2is not NoneRk2del6Q.6ult'ifh=w ;4bye(3Rs.popw G=0if @ (# Server replies to the "LOGOUT" K with "BYE"H7bye # If we've seen a BYE at this point,x so will bek# closed, so1ort3JInow.-Sp._checkM `# Some haveKbed "unLp" excepKsb# Note that ignorthem here causes loop9`Insteaend me details of # I'll upda e `d]:)'.>try09 p ab|nas valK F(print_log(\raisebT;@R@readQ!if b#('error: EOF'# Protocol ates all Ys terminauby CRLFgP.endss|(b'\r\nbort('socket error: unterminated line: %r' % C) ! =U[:-2]if __debug__:6if self.Z >= 4 $!_mesg(' %r" % (cre.pattern,Qmo.groups()) kqnew_tagmeRtag =_tagpre + bytes(str..tagnum)_encodingB&Lunum + 1I&ged_commands[tag] =9)8tagQquoteX, arg ar arg.replace('\\', '\\\\'("''"'aP'"' +kh + '"'dsimplename, *argN2bplete(5 I)wPuntag?tresponstyp, dat, O)nif typ == 'NO'^<~!ifJ2 in ysL[DdataGA.poppX 'oA[%s]bsXy9aOa .50, s&0cs=q cs, B!secs = time.($tmAstrf!'%M:%S',4QlocalJ>sys.stderr.write(' %s.%02d %s\nPtm, (=*100)%100 Igflush(:bdump_u<,^_dict; (!|@item5(f'{key}: {value!r}')-for key, 'z.V(Ba!4^ s :2'\n\t\t'.join(K)$log(self, ligne): .# Keep log of last `_cmd_log_len' interactions for debugging.JTself.;[_idx] = (line, time.?())C5Y += 1#=if [; >=:len8E= 0 ^def print(- +._mesg(')%d IMAP4#:' % lenB \i, n Nidx,owhile >try2* :[i]}.oexceptJIpass1i?f i/  0n - if HAVE_SSL:Rclass}()D1""" client 1over SSL conneP3Instantiate with:`[host[, porkeyfile[, cert ssl_contex#out=None])koV0 - 's name (default: local-);w! -w number94dar0G` - PEMpmatted P that)tains yourv7keyp] ^@ificJRchainpQa@ - aCp object m L?and >`Note:  is provided, then parameters u-orM|should not be set otherwise ValueErrorhjraised - socketu1d_PORT,$ i 1S g wz'(" G1argOs are mutually "  "exclusive") !if ssl_context is not None and certfile:AMraise ValueError("T H arguments are mutually "TX  HThis{pwill bed by the routinesx`read, line, send, shutdownj*""$.C@1p__all__.append(";_") class qstream( "):"""1 client 0rover a 1) In4tiate with:Uscommand"2" -Oing that canJ`passedsubprocess.PKfor more doca1see`docstrW!of6parjb ~3 = \Y n_C  v|~b'""" self.host = None # For compatibility with parent class - self.porF Csock_ Ofileprocess = sub q.Popen(kcommand,O bufsize=DEFAULT_BUFFER_SIZE)hstdin=ZIPE, stdout dshell=True, close_fds)(Swrite} ,Oread+Aout -@def ( , !):"""Read '' bytes from remote."""-breturnS{. (>*) qAlineuog6(gAsendcj, dataiASend? to]n. (G #Zflushbhutdow] C I/O established in ""YhIR(.%Await h _Authenticator:"""Private!provide en/decoding)for base64-6d aYion conversation.:: __init__mechinst30 = y# Callable object/ml reln%.eyi:At isC @b'*'P # Ab-uencode(ret)!W, inp#F# Invoke binascii.b2a_64 iterativelp7 sheven length buffersrip the trail0# rR feed' result and append. "Even(# means a number that factorsaboth 6E8c# so when it get,u!ofP8-bit$(utthere's noiatial 6*boutputPoup = b''HPif isyance(inp A in7Cinp.v'utf-8'8 wh:inp3 if~Wj) > 48[inp[:48]xJ[48:OelseNI_PX&(t'if e:  `oup = + e[:-1] `return def decode(self, inp):3`if notG5b''+inascii.a2b_base64(TJ Months = ' Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec'.split(' ') Mon2num = {s.enc ):n+1 for n, s in enumerate(w[1:])} Internaldate2tuple(res"""Parse an IMAP4 INTERNALDATE string.>RN0corA onding local time. The r&value is a4!pstruct_  or None if theo has wrongAmat.C2"""Tmo = Date.match+&monFCn = `[mo.group('mon')C@zone%"')Bday = int(!aday'))Myear !>hou!! mi~ a4min=sec`4sech!#\ c#m##! must be subtracted to get UT '0= (ph*60 + Qm)*60[!ifn == b'-'(@ = -M`tt = (?, mon, day, .@, mi dec, -1 ut#calendar.gm(tt) -{\. u(utc) E2AP(num):4"""Conver0Pteger4A-Prepresentation.@val Q'; AP ABCDEFGHIJKLMNOPf1abszwhile num.0numd = divmod/B, 162vAP[mod:mod+1] + valRFlagsW.f#  sebpythonP(i3l|A').s/)TTime2(v   form: '"DD-Mmm-YYYY HH:MM:SS +HHMM"' puargument canNaber (intufloat) 1ingCseconds since epoch (asRed by)), a 9-C@Q, PinstaW"ofD3(asA\i:nn aware  Vrdouble-quo>NQ. In 0lasase, itJssumed to already be in the correct format.1"""if isinstance(date_time, (int, float)):,VPdt = '&P.from Wstamp>/39zone.utc).as!()?/elWtuple6tryocgmtoffB.tm_]%except AttributeErrorH0if .daylightE$dsg5[8]`1if &N= -1A"jPlocalt(0.mkZ/))bB = -64Z,T0altZ)[dstNelseOI.@qdelta =] (seconds=:D (*8':6], tzinfo=`(L)>F4c.W{ is Nonraise Valu ("NP must6baware" 'str) and E[0],g[-1]) == ('"','"'areturn_l~q# Assum  not of a known typ fm '"%d-{}-%Y %H:%M:%S %z"'.;(Months[dt.m ]%`t.strf(fmt) if __name__'__main__': 2# To test: invoke either as 'python imaplib.py [IMAP4_server_host\#]'L/or5-s "rsh < exec /etc/ri$d"MtB;tream classimport getopt,p optlist, args =*Bopt.9(sys.argv[1:], 'd:s:'[( .e6val \b(), ()sP_comm=.@for 0val(EV if6-d'Debug = int(val2opt7s7 1val;0if $:*(6,+$''! =D2[0] BUSER{|CusernjPASSWD' (" @wordD %s on %s: " % (X!, rAor "#")@_mes3'From: %(|5)s@.%(lf)sSubject:rdata... ' % {'user':USER, 'lf' :'\n'} test_seq1 = ( ('login', (USER, PASSWD)),`create '/tmp/xxx 1',!^renam! /Fyyy',fCREATEMXyyz 2Mmappend!c None,FmesgXElist5w', 'yy*wVselec!/w`searchBi'SUBJECTKoL2fet* '1 (FLAGS INTERNALDATE RFC822)5Bstor#54', r'(\Deleted.PAspac2kexpungQrecen)Iclos'!) 2@`responC('UIDVALIDITY"ui`SEARCH 7ALLC ('EXISTS?p Ylogoudef run(cmd, args):0M._Z('%s %s' % ')' typ, dat = getattr(M, cmd)(*R*Q;=> WH)[if typ == 'NO': raisel5[0]V`return&ryif stream_command = IMAP4_&(-Oelse;V(host*if M.stateZAUTH':X [1:] # Lb not needed>PROTOCOL_VERSION =,M.>CAPABILITIES:rM.capabilities,)$0for,6 in F? ml9"'}/ Wyy%')w5mo = re.match(r'.*"([^"]+)"$', ml/ if mo: path = mo.group(1&%l.split()[-1MN dejV2M]i"ifRZ) != ('+ [=continueSPuid = C8!if]Uuid: D2FET0uidY1'D.SIZs.HEADERP.TEXTprint('\nAllncs OK.'fexcept.Tests failed.VDebug8<'' If you wo6uld like to see debugging output, try: %s -d5 ''' % sys.argv[0]) lraise """Recognize image file formats based on their first few bytes.""" from os import PathLike __all__ = ["what"] #---L# # headers # 8 P def a(, h=None):@f =   qif h is,if isinstanceUd(str, )^.jCopen1U'rb')m%h = f.read(32Jelse5location8ile.tell(9'X ["d.seek(SFfor tf in testsres = tf(h, f4T[if re/`returnvfinallyWif f: f.close4( >0Subroutines perOtype8 H a = [] LR_jpeg"""JPEG data*JFIF or Ex01"""Z`[6:10])0(b',P', b'-'<'m"' .append())pnj.startswith(b'\211PNG\r\n\032\no?pngn8pngm#gi GIF ('87 and '89 variants)$:6aGIF87a /9a?gif8gif= 3\ph[0] ==7a(b'P') 1h[13Sb'14'Eb' \t\n\r')D?pbm9pbmgGOgray6/25ggpP?pix%') and h[1] in b'36' and h[2]  \t\n\r':  return 'ppm' tests.append( _ppm) def rast(h, f)Cp"""Sun er file"""]if h.startswith(b'\x59\xA6\x6A\x95'DI;xbmX bitmap (X10 or X11)#define /xb )xb 8bmp/BM^?bmp8bmp?web_ cRIFF')8:12] == b'WEBPQyz?exr \x76\x2f\x31\x01?exrmexr) #-# # Smalll program #.(Jimport sysrecursive = 0 if.argv[1:];3sys?('-8del2!2]G]12try jKFall({E:], A, 1)R,Oelse>O['.'7 except KeyboardInterruptGystderr.write('\n[(fed]\n'.gexit(1&Ilisttoplevelo"fo1@nameMif os.path.isdir(\+[Uprint + '/:', end=' ,&ifd!v&V'ng down:O)Eglob@s = .(Pjoin(u.escapev), '*'){H2T s0-/? *** directory (use -r) ***B>dc+stdout.flush( #_6wha OSErrornot found` if __7 __'__main__!Y() """This module{!vides the components needed to build your own __  __ function. Undocumented s are obsolete. In most cases it is preferrec consider usingo3lib's functionalit0y over this module. """ # (Probably) need to stay in _imp from import (lock_held, acquire_, releas- get_frozen_object, ispackage,84ini92qbuiltin P6_fix_co_filename) try:_ create_dynamic except IRError8# Platform doesn't sup; loading.h W = None SNlib._bootstrapc_ERR_MSG, _exec, _W3, _4 m_L_externalUSourcelessFileLoader,machinery` Rutil 4lib$os %sy tokenizeEtypewarnings . P("the` is deprecatedfavour of&ortlib and sl"""for removn Python 3.12; -@see 1's documentation L!aldtive uses"DBionW,_cklevel=2) # DEPRECATED SEARCHOR = 0 PY_SOURCE = 1 COMPILED = 2 C_EXTENSION = 3 %RE0 4 PKG_DIRECTORY = 5 C_BUILTI060PFROZE7GCODEB 8 IMP_HOOK = 9 def new_()V"""**1** }CZ a6.3Thenot enter2ys.fs1qreturn B!.MBTypekomagic( RL/q numberP.pyc >s .MAGIC_NUMBER{7tagy e!`0 = RAWAwithXGreadFelse1 return sBuper().get_data(path) class _LoadSourceCompatibility(_HackedGetData, machinery..@File<er): """C support for implementing load_su().""" def`name,  file=None):nDOer =8 B)<spec = util. `_from_b_location(>p=G0if & in sys.modulesPexec(j,*[>]LOelse:p:'# To allow reO`to pot\ally work, use a non-h]er whichp# won'tIAy on.w-closed  object..0.__ver__ =  ?C 2__.JH:\rrreturn 6 h@iledOless.@compq """**DEPRECATED**'j]UL2-Awpackaged)`if os.b.isdir6extensions = (OURCE_SUFFIXES[:] +b~ 5yBYTECOD7r2o )Pinit_% =AjoinQ, '__"U_' + DhCqexists(3U2&5 = # Ubreak xEraise ValueError('{!r} is not a '.format),w Asubm#u_search3s=[@ .modules:  return _exec(spec, sys.modules[name]) +Qelse: 8Aload8) def _?(>b, filedetails)M"""**DEPRECATED** drLoad a I, given information ed by findt").A3The> w must include the full package#, if anyA1"""psuffix,Me, type_ = "!if and (not.startswith(('r', 'U')) or '+' in&R aise ValueError('invalidAB ope3r {!r}'. d(mode)"if,qis None in {PY_SOURCE, PY_COMPILED}pmsg = ' object required for import (S code {})_Mr2msgDelifH=JgsourceJNNPcompiledRC_EXTENSIONPdynamic is mo (g'rb') as0ed_ 6: %A9 KD KG_DIRECTORYSU MC_BUILTINIinit_builtinI?PY_FROZE?Zfroze> "Don't know how to+{}"vI%Amsg,[=1"p, path=EaSearch!IfDpomittedhR8, s6RR-in, '1ialpcontinueA!in,. ^acannotC8ain '.';M 3subcDof a ssB%WP's __#__!ifisinstan73strY3Typg "'f'!be a str,J%{}no,4(}), list)~# Backwards-atibilityeRuntimZ\a_", ="mat(type(pat h))) if path is None:is_builtin(name)!areturn6,P('', C_BUILTIN)Pelif is_frozeQPY_FROZEQs`= sys. for entry inpackage_directory = o<a.join(8!, Q`suffixR['.py', machinery.BYTECODE_SUFFIXES[0]]uyPfile_^ = '__init__' + `s4, $, 4`K%if is$(_] . Z3%, PKG_DIRECTORYr0, mode, type_=Bget_;es({! =FUbreak,elxcontinue#1P # B:p out ofer loop when &0ing 3inn .J iraise ImportError(_ERR_MSG.format=9Pencodg=[if 'b' notwith open, 'rb') as Q,L`tokenize.detect_J.readline)[0]L l$, <= ;,2, (H c) def reload(modul"""**DEPRECATED**.R+@ theule and u2it.&Tmust have been successfully ied before=1"""U%Jlib.HLoad!a <4-in!byOA, orDsuch qdoesn'tBexis 6try%mCHcept @x if create_dynamic)\"th=@= extensiop" #Oer =%$.Ef@File{'erF# Issue #24748: Skipmps check_u_e_shim;# always #F new spec = importlib.machinery.ModuleSpec( Pname=, loader=, origin=path)3return _%(spec) else:"_dynamic = None """A pure Pythonlementation ofort.""" __all__ = ['__c__', ' mnvalidate_caches re'] # Bootstrap help #!HtUntil bN ping is complete, DO NOTR any s that attempt # to%_Y (directly or in). Since this # partially ini ised package would be present in sys., those #1get an unT@copythe source version, instead #!La fu* (either Efrozen one##below if1is not available). F ( # Just6qbuiltinaonent,pFsys try[bSF as  except IrRError?dfrom .1{._setup(sys,)N#? &iW!e !-iPort, ensfwe don't create# a second .#_v '1} 4)S Q_file3_ .replace('__P__.py2py'{GNameye$# Q5guaranteedbe defined, e.g.mqde getsK by a tool like cx_Freeze>+2pas8n[A8] =Ev_external:_,(. E 4/._ H_C X.>=I@_ozen by a tool like cx_Freeze. Apass sys.modules['importlib._bootstrap_external'] =  # To simplify E s in test code _pack_uint32G.#O _un2 %eFully ped at this point, whatever you%<, circular # dependencies and startup overhead minimisation permitting :)  warnings Public API #%w from "__t__ def invalidate_caches():"""Call the% method on & meta path finders stored inN=Aeta_$`(wherelemented)."""*3forD 8if hasattr(p=, ''1*.(#() !_loader(name,S=NoneK"""Return+ &specified '!. TTis a backward-compatible wrapper around_I(()?AfuncA issQrecat] favor ofMQutil. Ian. T('DepOsince Python 3.4lkpremoval'V':a12; us instead',IBionW,Xcklevel=2)46try!= 13]._!__73if 10is Iraise ValueError('{}G 5'.format,)?KelseQ4texcept Keyb/o"Attribut({not set $ h&._<B # We won't worry about mal 0ed Nps (miss"s)R!if#C#E).40 2subn_search_locls4X8I{ ('4{} w ;S-=,n!`space ages do ChavesRCir;/ ckage=None): """FImport a module. The 'package' argument is required when performing a relative iTA. ItMspecifies the V to use aanchor point from which&presolve=O g#an absolute}1"""4level = 0 if name.startswith('.'):!$otmsg = ("# $to! K!"i4 for {!r}")&raise TypeError(msg.y0at().Acharacter in 6if "j!= '.'!rYbreakDA+= 1return _bootstrap._gcd_[24:],I!, ) _RELOADING = {} def reload(A"""RS and 'it: must have been successfully ed before=)6try [# =t0.__0__.except Attribut? LT9P!__KO # "2)%be"") rif sys."Cs.ge;3not"0@ {} %(inEL,=d0ame [;]- T wpparent_<! =.rpartition"[0U_7if 1 W.( =[t[.1Key$ `!tAv 3~ M!),!3+=5INone>Nelsepkgpath =I0.__ 84 ejtarget) =Afind#, d", VN0pec~ YMNotFound1(f"f0G u5Pexec(M,#R2mayreplaced itselfA!BC finally:  Stry: del _RELOADING[name]!except KeyError:pass """Subset of importlib.abc used to reduceCutils.""" from . _bootstrap QD abc warnings class Loader(meta=abc.ABCMeta): P"""AbRct base *D fortlF3def create_module(self, spec)"""Return a ( initialize and into whichk. This method should raise IMx if anything prevents itEA"Sa new. It may r@NoneindicateDthat theTeT4# By default, erh semanticswhQ## We don'tSine exec) here sincAat wBQbreak# hasattr checks wO0sup backward compatibilityq@full) 3$ed$3The must be add'Bsys.Cs64hav5-relatedHpibutes {properly. b is a str: Vskd on failure+is depre2` favor)r.E. If p existsQ@n it'provide a$s-lfunctionaLBdif not ''& 2# W:qlemente_ '_shim().6./ [5mS_repr0's 1U by{type whenAdoes/dNotImp],$. "("9. )*W"!"s- removal in Python 3.12", D3ion)O#Fion will cause MaType._ __LPignorG ?`contex5R@ort Rress !BSpec'cAdaptec a package spec to adapt the underlying loader. """ def __init__(self, spec,Cer=lambda:.H!):@M7.6! =" /$ =R(*)~ugetattrGname_sreturn &n!, ) class TraversableResourcesLAa/provideB0 hSget_r0_reDegenerateFiles,)._native() -M er for an existqor non-Dant  4to 5a d1 .f)!Path(abc.$qiterdir"3((),8/s_7 RFalse`40is_" =Qs = iC # type: ignor3gPjoinp, other z.@propertyO`&''/Aopen/ , mode='rb', *args, **kw aise ValueError.>j ?with suppress(Attribut'q^.,.=bF`hRE-a if itPorts +#s(9ECelf.*%`if has(1, ']') else _;^& !, ,Mh#A Pwrap_t(packagConstruct a " t compatibili!on^//AFBSpec$er!._?__,4 ) """Core implementation ofort. ThisMule is NOT meto be directly1`ed! It been designed such thatH0can< bootstrapped into Python as@ As QLsrequire2DnjecDCifics and attribnutes in order to work. One should use importlib as the public-facing version of this module. """ # # IMPORTANT: Whenever mak<changes to<, be surerun a top-level # `make regen-` followed by#`A getsfrozen 1 # "e  updated. Not doso will resultUqMakefil'fail for # all others who don't have a ./python aroundafreeze$ #aearly sta!of compilation. # # Se._setup()p what ijected inde global namespace.JP editt@code0awaOPexecuQ` time CANNOT # reference any in ob @s! T^includes not onlydbut alsoO@nythspecified aaclass . def _d_(obj): try return obj.__qual-!__)except AttributeError;Atype^ A # Bootstrap-relE #" MoJmanually _thread = None _warningsdeakrefAdoneKinstall_external_Wers() _b Kxwrap(new, oldv"""Simplbstitutefunctools.k_>qper."""for replace B['__q__', '_ vdoc__']if hasattr(old,Z1set#},3 9)new.__dict__`#) 3new(kxLBsys) P lockC"!##& A P mappKLws_rQLock nces # Dicwary protR!byP2 _[{} # !idy _bBing_on = {} P_Dead@(Run bFpass/"""A recursivealementc` whichC"ab de# dzsc(e.g. 1ldk0s A(`n B, a2,It0B01A). _init__(self,0lf.u3 = .allocate() self.wakeup = _thread.allocate_lock() self.name =  owner = Nonecount = 0qwaitersdef has_dead{q!):3# D avoidance for concurrent circular imports.>get_ident`tid = t.:Aseen.while TrueLb ing_on.get(tidJ)0if #1 is3 F!return FalsQ= 1if ;= mT60in  # bpo 38091: the chain om's we enjer herb!# eventually leads to a fixpoint or a cycle, butAdoes not reach 'me'. This meanPwould%@#aca>can happen if other?s are atbeginning acquire() belowz}tB.add%{ Q1"""#SAtamoduleU. If a potential odetected,G4a _[PError&fraisedOQwise,n'salways Qd andEu_EQ[tid]%lf:try,Bwith 8 "if"P == 0k?tid=A+)gO+= 1(DS$ 9.t  %(' by %r' % G{A.(a# Waita releasWMcallN&QL0fin Mdel  4FZ R0 !=B xqRuntimeR('can-C un-d'assert self.count > 0 Rself.I-= 17if Y== 0: G!owner = None"F~waitersCG" "mwakeup.release() rdef __repr__(()ireturn '_ModuleLock({!r}) at {}'.format7.name, id)) class _DummyB_"""A simple _ equivalent for Python builds without multi-threading support."""Cinit , ! =X/6= 0Oracquire /+ ?FTrueD}v 3 raise RuntimeError('cannot RC un-d lock')$  Manager: /____=Oenteq.4a_get_m.l 6.Y 5'ex\*args, **kw y| # The followtwo functions arr consump3 by1/imAc.  4"""Get or create the &gta given?.A/ei]QnallyIrglobal Pto protecfsD_impVc(x6tryY j T[]?%except Key(OBq4"if!is 2Bif _g AV (&Jelse`@,;&bcb(ref=_N\D [# bpo-31070: Check if another Kqd a new< L1aft6e previous. was destroyed<but beforweakref callbackD ?ed.BaRs.getW>ref:del _module_locks[name] finally:(_imp.release_lock() )b_modulb = _weakref.ref(7Q, cb)9 ocpreturn ?q def 0_uny()"""Acquires then  O for a givenH. This is used to ensure a+is completely initialized, inzevent itJbeing imported by another thread.21"""E3get"'tr/".a(eexcept _DeadRError%# Concurrcircular, we'll acCPa par KXbobjectApass&Felse{QL# Frame stripp&magic #call_with_fU s_removed(f, *args, **kwds1"cortlib:P.c wiblways 0 sequence#of=Blib { that end 0 a Mt]functionp1Use(nstead of a normal6in places where includ,6thezn~pintrodu4Punwanv0noii0nto traceback (e.g.\n executingMBcodeX*f(Vverbose_message( Vity=1QPrint/. stderr if -v/PYTHONVERBOSEW ded on.if sys.flags.gRe >= 'it7sif not mp.starts(('#', '3 ')2 = '# ' +C3!p .ft*), file=)4"re_builtin(fxny"""Decoratoraverify+d=&-i7 \_wrapper(self, fullIo%if&!inX_$in5s9 raeIv`('{!r}n!a C$-ix' ,HPu=.-,xn#/(_  , o*I+ _froze$<  \B.is_7(fullname):  4raise ImportError('{!r} is not a frozen module'.format(fullname), L %=.-return fxn(self, #_wrap(_requires_@per,8)LH*: # Typically used by loader classes as a method replacement. def _load_\_shim:"""Load the specified6 into sys.G@s anjAit. BDThisis deprecated. Useb.exec_H() insteadC1"""Kmsg = ("0 ` slk for removal in O"Python 3.12;K "_warnings. s(msg, DBionW,0! =7ms%ere , $,%if+URs[a]"'_(},cX_ AFelser/R)yM4ifications ##! b_repr( )"""The implnB of aType._8T__().+er = getattUA, '_er__', None!if. :30"__N3__"1PAfrom12(elif has2, '6'-6tryb8m6+except E:ionHApass+ # Fall through to a catch-which always succeeds.9 # =d0.__!__(Attribute*a = '?'. VCfile  0.__Z#ifQuJ"'<[ >w,  > (D)E,M IE4 , ! BSpec!a,dB3ingWA!"'s"isQource0"inion about!<a. Fordata associnGwith*, including s]"'#er``absolute  `loader` i s the loader to use when1ing#module. `parent` i<pname of%Appackage 5*in. The >derived from.J!. EC`is_I` determines ihXconsidered a 2" onot. On/ iszreflected byz`__path__` attributeeoriginspecific location/IIwhich tok,at informJis availabjW@file1 isIRset, will matchDhas_` indicatePat a B's "@#" 5s a.f{"th/True, `__ $a[4setecached94 bytecode ]any. Itcorresponds2`__< v2subcu_searchsqsequenc` entri&9`importYs!f  should be4--and False otherwisWP&s are simplyF(may) have zg hanon-None value in `4,EbsystemNPC4 aslsxOnly finders (see alib.abc.MetaPathF#A and{ %!REntry&)Tmodify MSpec instance2"""9def __init__(self, >,Ter, *>=2b_state "%):#b.a! =h <3r =} # = :@ )P = []g e-#y-o#A_set!" = 6 = cCrepr=@args'Ar={!r}'. X%),d'1%)]3i3lf.lais notS.append('-_-))_sAE={}'p .Dreturn '{}({})'.f0ormat(self.__class__.__name__, ', '.join(args)) def __eq__:, other):!qsmsl = W submodule_search_locations/6try<@qreturn ^.2 ==e5and=0qfloader24 forigin44 Aqfcachedu4 5hasA:)except AttributeErroriNotImplemented@propertyP"if_ is Noneh%Xais not(#Aset_fileattif _bootstrap_externalo0jraise ":=jS._get".pKKq.setter| P", #XG# = P RparenCq"""The Arof the 2's 2A."""lp.rparti('.')[0]d;els >D_GM< Xw, value_X = bool(*0 spec_from_s( ", R, *, 2= , is_packagepB"""Ra X based on variousW methods`if hasC(y'Y'hSKlN."x y = s = [] if h,<l=s > try:  is_package = loader.u(name) . except ImportError: ,A = None # aka, undefined4JelseB# the default( XaFalse return ModuleSpec,, origin=&, = ) def _spec_from_mP(N=S )# This function is meant for use in _setup().2try;w2 = m".__(sAttributevBpass( K1if Tais notnr6%G_#ifMK XFIK# ##qwill stay:! AlocaOCfile} >Z#ifDp!is sq_ORIGINm  #KW(m hcached9,]2sub_search_s3isti.__path__x V / ="y3._<qattr = u  qU Truep.  A Cinit_ s(,L, *, override= e DSed-in0q may be50sup V{ assignment,#which case we simply don't setBsJ# __`(p or get24, '.!',c) o.;! =.w$_ #!0 Y/ #"n{i8# A backward compatibility hackj) if spec.submodule_search_locations is not None: if _bootstrap_external40? raise NotImplementedError^_NamespaceLoader =n.' Il? R.__new__(D)D._path = spec.subm7 ?0 % # While the docs say that g.__file__b_set f:# built-in:as, andYcode below will avoid setting it if5hasfalse, thi(incorrec$ nNpackages.   have no P, buti$@# ____.origin}"us: Cshould also b ne^ consistency. a bit of a hack,Obest place to ensur)is]E See # https://'.python.org/3/library/importlib.html#Babc.Q._\j2bpo-32305 7P! =$':try00urer__ = 4except Attribute FApass02!__if override or getattr(xU, '__0!',)-d=aparent{? u.n(c /th-/if J{N O Q a 9/__cachedyRV9 B;9d__', None) is None: if spec.cached is not(3:try=module.__FH__ =V q0except AttributeError[Apass@rreturn kc def `_from_()I"""Create a( based on the provided1"""f # Typically loaders willimplement cZ_1().<! =>if hasattr.R9, '@'L# If^ 0s ``n it means defaultpBdion should be used*(.6eP[/elCexec1raise Import"('d`s thatGine >A() 'm'must also< 1)')>i3QC_newBname?S_init_s",F%4OreprR(0 to@ forQ.We mostly replici() using> Vst = '?' R elseBK~.originGH k"#''.format(kJ,> (D)E,R Nhas_locationlT poo s}c UP # UAby i?`lib.re() and _ @shim_O """Execute*!'s<Sifiedy in an existUm0's Uspace 9qwith _M6LockManager2ys.^Cs.geJ040msg6n sK`@Amsg,= $u er V_(2subu_searchxs<@A'mis{':@a# Name package.   _init_module_attrs(spec, , override=True) 9 else:R)@if not has.loader, 'exec.')|@msg = (f"{_object_nameH7)}.H!()pfound; "T"falling back to :()"4 _warnings. (msg, ImportW7g2HJzfinallyT# Update the order of insertion into sys.NSs for: H# clean-up at shutdown.$C( =PB.popw[#8] =dreturnq def _ward_compatibl#U# It is assumed that all callers have been ed about usb(b# appropriately beforeN1this funcV'trV)er ffexcept5if "8 inZ%%|;XQraiseS# The must be cpoint!7pMove itn0end/96aif get~WA, '_7er__', None) J >.<b1pec!er( AttributeErrorX#Apass0packaged# Sinc.__path__ mayline up with{#V2subq_search@@s, wn't necessarily relyE"onHparent hered^!._)__T ;@3% e6p.rparti('.')[0]r/g:O pass P return module def _load_unlocked(spec): # A helper for direct use by the import system.40if B.Uer is not NoneTX Not a namespace package.C#!if8qhasattrS, 'exec_'4msg = (f"{_object_e@7)}.@!()hfound; "L"falling back to I()")5_warnings. (msg, Im'W /`ward_compatible!) c# =`_from_m%# This must be done before puttL in.sf# (otherwise an optimization shortcut in .c become>bwrong)._initializ}a= Truej6try4sys[7]1 5q m$(2sub_search_locs<@ raError('missAer',= DQ ` so doBhing9-7els8bu wfexceptd< @8delx'PA Key Y!2pas 5Dw# Move !tohend of1# W't ensur@!at7-related 1ibutes get}!sen replacement case. SuchOs are onHtheir ownz) =1pop.|i_verbose_message('q {!r} #"',nb ovfinally: RFalsec `methodPd dur1tesIo=) and by #WJ_shim().pB"""RSa newy ,neU"'s"r.4The5pPaddedits parent,GIf a-palready, that exim/OclobberedU""":qwith _M.LockManage ~ zLoaders #+###### class BuiltinImporter: """Meta path i` for b.-in modules./All methods are either class or static#to avoid the need towinstantiateAd2"""m_ORIGIN = "@hQ3defb_repr(!):pReturn (z(3The is deprecated. #machinery doesjob itselfNV_warnings. +(".)}e and "N0"sl removal in Python 3.12", DBionW)Pr2f'<" {.__name__!r} ({B})>'@ find_spec(cls, fullU,s=None, target !if$ @not +if _imp.is_54in(s[>_from_loader/!, origin=cls.9Oelsedb"""FinFl@If ''1Pever 0ifiw1hen`search"considered a failureNOThis FUse  ) 7ead>J '.format(m.__w;__,?.) find_spec,m=, target if _imp.is_(e*m%er/!, ?origin=cls?FelseV ;"""Find a[5OThisFUse O ) B7ead>sIsyError("Hn, Pythonlikely "E `"shutt}qdown") ,fif not@_war s. -('sempty',W.W# We check;$odules here for the reload case. While a passed-in# target will usually indicat/EtZis no guarantee, w#asKprovides one{3is_M= name inD`finder5bwith _LockContext()#:tryY_spec = 0er.~%except Attribute%PK_E_legacy(1er, , )`d1if @ continue>7els +M(c},} # The parent ih may have alreadyed this m1and. }>N[ s[] +_ D__ = DVz1usecRfound@sinc at0"on nGwe wouldU@used9xohadn'tEbeaten us toZpunchoareturn NU64if 7,%c $g>o :2. & def _sanity_:#ckage, levelI"""Verify arguments are "sane"."" instanceT3strIq2TypJ#(' must be st2ot {}'.format(typR"))"ifF < 05DValua[[>= 0'A>A#pa #__.!__0seta3ingz elif not package: raise ImportError('attempted relative i  with no known parent 'P[ 1'pax!')) if not name and level == 0SValueEmpty module< ') _ERR_MSG_PREFIX = 'No&5d '%< = 0+ '{!r}' def _get_mc_not_found_e)return M)@NotF'`.format(6,= ifind_and_load_unlocked/,l_npath = None?u=U.rpartition('.')[0]%#if~rin sys.s&*`_call__frames_removed(#_,]3# Crazy side-effects!u U[1E( =[,:tryE(D0.__%__except Attribut{ Itmsg = (` + '; C1 isY%a 3I8msg7V from@specG :0if :s7els-,w hubo# Set thetas an acs on itsQ.wH ochild 20set(m!, P,Pf"Can=set{mr!r} forlk! {zE!r}"y_warnings. (WBNEEDS_LOADING = object(8>B|r"""Find7oad2.""(" _LockManagerPG 2.ge#9, _7$if+is%e)_Z ` \ &pmessage' of {} halted;'E ')7 D|_&fh hgcd_import(name,@ package=None, level=0): """Import and return the module based on its name,S qcall isObeing made from,VOv adjustment. 0 This function representsYgreatest common denominator of7QalityNbetween i"_m#__1_. tincludes sett#__Q__ ifOoader did no1"""!_sanity_check(nFh)("ifvB > 0w{0 = _resolve_E_find_and_load0C_gcd) def _handle_Rlist(,,', *, recursive=FalseFigure out what Jd shoul5eX parameter is a (able which take2 to5@. It?required to decouple%=` assumBlib' leaq`is desX# The hell t0rom8A ...d# If a^@ was_orted, trywQstuffzGDfor x in ifr isinstance(x, strB&if=swhere =!._e__ + '.__all__'-OelseG1"``g"''6raise TypeError(f"Item{} must be*, =Af"not {type(x)"}"Q+elif x == '*';uhasattr' Q\=;C DB [=True xy = '{}.{}'.forma&6, x`:try!_p_with_fs_removed(_+s Oexcept M_NotFound~ as excm# Backwards-compatibiP dict we ignore failedS#_s trigge%by: LWat don'tGRexist if (exc.!==Y? G6Qsys.mes.get(, _NEEDS_LOADING) IcontinuejYsWcalc_(globals): """Calculate what __package__ should be. is not guaranteed to be defined or c>@ setANoneHto represent tv its proper value is unknown|1"""< = globals.get('!'))Nspec&#__#4if O:?0if 0E and5!!= v.parent8<_warnings. '("` != __Z#__< 9Cf"({0!r}?{><e!r})",@rImportW, stacklevel=3,4dreturnO/el26&se% can't resolvenU from</,"falling back on __namDOth__zL$['g!']?1if q'$in*P .rpartition('.')[0W`& def __i0__(,d=, locals Vlist=(), "0)2""" a modulSThe '[p' argumsinfer where the %`occurrzto handle relativ01s. k jqignored"F'P(wRifiesexist as attributesmP beed (e.g. ``f<zr>``). <'J!spEin aJ T..pkgqmod`` wUhave a '{' of 2))"ifR == 0~s = _gcdLJ (el_4 ifr81 {}g= _calc_W(Vr.,"3!ifa2# R upqfirst dot in '3'X iscomplicated byEfact#7@ may.'kr m 3vYN/| (# Figure outao slic module's na me up to the first dot # in 'name'.cut_off = len(!5) - .partition('.')[0])># Slice end needsbe positivealleviate"special-caseOwhen ``'.' not*``return sys.modules[0.__0@__[: #)-!]]welif hasattr(,, '__path__'):&Fq_handle_fromlist5, _gcd_import+MelseIm def _builtinW6-B = B$IZer.find_,0if x is NonvRaise <Error('no wB-in  :Qd ' + load_unlocked(f)setup(sys_H ,  D@"""S' clib by 1ing,eds and inject&Bthemnaglobalqspace. As`ed for.b acces_*0to Ps, those two4 s must be explicitly passe1"""Fq,( =3Psys =%HQ# Set"heAexis in/frozes;m(_type = E,w\s.items(if isinstancec,0`Xs-.er %D0.is@zPF+erOezcontinuzmbJS_init)_wsLy)PDirecLEs/0durbootstrapCselfcC[('_thread' warnings heakref"if!in; n)=@D(< EN(Lv[E30sets(!,V ll2ZI#ll1ersz _E 1eta.append(BuiltinImporter) sys.meta_path.append(Froze) def _install_external_iKAs():NB"""I%  that require < filesystem access"""Dglobal _bootstrappX1 _f:lib&>/ =5T.(0 odules[__name__]) """Corelementation of X`-basedort. This mF is NOT meant to be directly1ed! It has been designed such ^`it can<6pqnto Python as thQP. As Q% i2Dnjecspecific!s and attributes in order to work. One should usdortlibpublic-facing vers9t% . a # IMPORTANT: Whenever mak:pchangesC:,@surerun a top-level # `make regen-lib` followed by#`A getL/ #dupdated. Not doso will resultU0@Makefail for # all others who don've a ./pQround:Qreeze!inearly # sta!of compil. # # Se._setup() wiV`space.JP edit@code0awaOpexecute@ time CANNOT # reference any iPed ob1s! Gincludes not only dbut alsoO@nythyaclass Mqmanually]j6() p = None k builtin4 j  o 4sys _warning marshal _MS_WINDOWS =  platform == 'win32') if + nt8_osXwinreg else-Tposix0 W _separators = ['\\', '/']R("# Assumpl@made _join() asserl(len(sep)10sep1 ^$) ! =5[0]_tuple = (5Fa = ''. + seps_with_colon = {f':{s}' } 4B@-rel@ #" _CASE_INSENSITIVE_PLATFORMS_STR_KEY = 'win', _CASE_INSENSITIV-TBYTES/1cyg2P 'dar ; _ = ([/  /+ H  ) def _make_relax_case():a if sys.platform.startswith =A#oIM0key`PYTHON1OK'Belse/*b'01:"""True if filenames must be checked ,,-insensitively and ignore environment flags are not set."""qbreturn1ys.1.J_Jasin _os.K CQFalseO' / =opack_uint32(x"""Convert a 32-bit integer to little-endian(int(x) & 0xF).to_bytes(4, '@' (unNdata!4 @: in$an0assAlen(PX == 4,int.from% "16I!2/2 if _MS_WINDOWSpath_join(* p:J"""Replace `or os.+.6)>.!if_JjR0if o1)u17%1[0]Tgoot = T(F = [$for new_root, tail@map(_1b_split! lGd0sep_tuple) nB.end % ]|% =.rstrip(8qarators^+<)a_sep +%(el;':'-0if j.?fold() !?# Drive v `s havebsolved by the OS, so w et Z tail but do not add a path_sep prefix. root = new_ $I = [tail]"]else:k8.append(<)&8@ or  :\ vp.rstrip(arators) for p in"V if paif len4) == 1 andUG:[0]# Avoid losing the's trail2sepz when join@withXIhingareturnG! +#.W& ZPdef __ * fparts)"""Replacement0os.+V\)."""#[Tp;4art_Lsart]) Rsplit,qi = max>.rfind(p sif i < 0m1'',B[:i][i + 1:],taAStat9?!. QsMade a ; e function to make it easieroverrideB`experisJ(e.g. cache sjresults)j@_os.'% {is_mode_type , Ip"""Test th!he 1 isspecified5 EW6try`~s_info =qexcept OSError9QFalse(@R1.st & 0o170000 Risfil$-vv400o1y0]2dirUisdirp ifFl:K@os.getcwd(< 04if _MS_WINDOWS\Xisabsw 5abs-[R[0].r('/', '\\'?U43) >(0rts@('\\:yE.end?'))^/   write_atomic(path, data, 'mode=0o666): """Best-effort function to write dataa path atomically.@Be prepared&handle a FileExistsError if concurrent[ing of theItemporary file is atqted."""$`# id()"usppgeneratrpseudo-randomEBname_tmp = '{}.{}'.format(,W !))gfd = _os.open"<,4%O_EXCL |2uO_CREATWRONLY, x2 & zI2tryN# We firsvP, and4n use os.replace() toYP0per3 an6 re$with _io.IO(fd, 'wb') as?/.(*E,-$except OS U IeunlinktBFEpassraise _code_type = !(__"._!_) # Finder/loader utility C/ #NMagic worreject .pycX$s 6d by other Python versions. # It should change for each incompatible  toP byte. # # The valuej!CR= LFACrq`ted soyou ever read orVe # a in textQthe m number will be wrong; also, # Apple MPW iler swaps"irs, botch0strconstant`re werpvarietyold schemes'@sett? X0ork(< to_0rem?previous by # 10`AStarhM.AadopAof PEP 31475A3.2,e`y bumpA3 # C4ludes a new "$ tag", i.e. a humana/ #drepresAcin __pycache__ directories. When XM ,AmustC setTuniquqtag. Glly this # can"pd afterTmajorT 7, but # itO reV@anyt>,@longit's diffe| th)@ els0tha&come before. >tags ared`follow<t3, s 1 # a.RKnownGTs: # 1.5: 201216.1: 1/.26KP50428K Python 2.0: 50823 # Python 2.0.1:1: 60202414/2:42N<717N3a0: 620112l11 (!)84R4814a3l5!b165N781 (ast-branchA91 (wit!2 (changed WITH_CLEANUP opcodeYb101 (fix wrong +: for x, in ...:@ :x += yield7c%)12qplnotab wloops andp Qstorinstants that should have been removej9213listcomp/genexp6 151 (peephole optimization STORE_MA"6a K61 (L ~7~C71 (u e  `rehens/ LIST_APPENDLLPcondi2al ?es: introduce POP_JUMP_IF_FALSE OTRUEP 621M`SETUP_121BUILD_SET00qMAP_ADD0SET :@3000c3010 (w UNARY_CONVER 3020 (added ,3,keyword-only parameters :4:signature an}8 50 (print becomes a func6m60 (PEP 3115 metaclass syntax6Q1 (stliteralsu@ uni;q09 raise 337 make __file__P__nam { kill str8 interningpmerge from 2.6a0, see/51853 (1poio source ;`3.0a4:Q .6 b1631 (lexical exception stacking, including POP_EXCEPT #3021) #!0Python 3.1a1: 3141 (optimize list, set and dict comprehensions:FK change LIST_APPENDFSET_ADD, add MAP o #21835Pcondial branche introduceJUMP_IF_FALSE2OTRUE8 M471528@60 (SETUP_WITH #610h qtag: cp|3-32F02a27TDUP_TOP_TWO, remove XROT_FOUR #922sd3 318sELETE_DEREF #461703a12 90 (__class__ super closure d; 200 (PEP 3155 __qualname__ed #13448>1@ed smodulo 2**32 to the pyc headerL%64j3a2 3220 ( 80 implementao #142304A30 (revertsCVicit !^#1485U4U250 (evaluate posdefault argus beforeA keyword-only ?s #1696~LOAD_CLASS; allow locals of overridfree var|>785various tweakID>237J-> !4a} u&93TF3%moK#arc2 33Jlter& 62065P3465: Matrix multiplicoperator=176 5b3Je48: Ad2Unp GeneralizXs #2292Oy340 (fix\ionary display "or>120 5b33GET_YIELD_FROM_ITER opcode #24400!5.g`BUILD_aUNPACKV_CALLH>728"t6a0 33>FORMAT_VALUE:>548661 (lineno deltacode.co_lnotab becomes signed #26107) # Python 3.6a2 3370 (16 bit wordcode2/6421 (add BUILD_CONST_KEY_MAP opAO7140s2 (MAKE_FUNCTION simplification, remove %sCLOSURE n#27095n!b13gSTRING?078:5:SETUP_ANNOTAS and STORETs /9836 ( ey CALL 3s &nMAP_UNPACK_WITH_' o#272137 (set __class__ cell from type.__new__ #23722GB8']TUPLEo #2825S0rc19 (more thoroughQvalid!7a"90LOAD_METHOD$s.117 91 (update GET_AITER #3170907a4f92 (PEP 552: Deterministic pycs>/65qC93 (W_ #325A54Astored docstring as the first stmt in_body;this might affected8Jline number=91180400ve frame block handlto compilH?176HtEND_ASYNC_FO?304|!10C570 @Posiaal-Only Pa0ter/65 8b411 (Reverse evaluorder of key: eaOdict\rehensionzN5224Azq2 (Swap~ps qal argso3in ast.argument>759/ 8b413 (Fix "break"r"continue""finally" #37839a0 342PASSERWA_ERR?488;1%ied byterfor withc>2942/dBEGIN_FINALLY, a :4POP(xi>3389J#42}IS_OP, CONTAIN ?JUMP_IF_NOT_EXC_MATCH]M9156]4 y bytecodes for *value unpacking) # Python 3.9a2 3425 (simplify bytecodes for *D 10a1 3430 (Make 'annotations' future by default@ 1 (New line number tablemat -- PEP 626C2p2 (Func{ A' MAKE_FUNCTION is changed from dict to tuple bpo-42202i3 (RERAISE restor._lasti if oparg != 0B614 ( 34: Structural Pattern Match@10a7@5 Use ins<ion offsets (as opposed,).110b6 (Add GEN_START #4368397 (Undo maa - We likedance among core devs!k8 Safer"handling9ROT_N) # # MAGIC must p whenevwh emittedthe compiler may no # longer bhqderstoo.`older VCemen@ of Geval loop (usually # du Aaddiof new opD # Ww_NUMBER,drAs inamagic_`s arrarin PC/launcher.cAalsopdated. h= (3439).to_^s(2, 'little') + b'\r\n' _RAW_;@int.s:EQ # Fo>ort.c _PYCACHE = '__pycache__' _OPT"opt-' SOURCE_SUFFIXES = ['.py'] if _MS_WINDOWS:  ..append(2w') EXTENSIONQ_imp.extension_suffixes() BYTECODc'] # DeprecToDEBUG_1OPTIMIZED 2b def Zsource(path, debug_override=None, *, optimiz)r"""Give4Ca .py file, retur0its!c"!. Z0The does not neexist; this yyXsx1theM2.py]p calculB0 ask-P werer"or'' parameter controlvyresumed level ofn[. If _ik2string rs P@argu$taken and verifi1be alphanumeric (else VQErrorNis raised). The debug_override parameter is deprecated. If+is not None, a True value?the same as setting 'optimization' to &empty stringKwhile a FalsRequivalent:TQ'1'. IIf sys.implementx.cache_tagdn NotI)aedErrocraisedQ1"""Yi :#_warnings. ('su; use 'JN"Jinstead", DBionW})E8if fmessage = '*orCpmust beN ?Q TypeR([ ^= '' ]e1path = _os.fs (Ohead, tail"g_split#base, sep, rest =/p.rpartiB('.'N!=@ 0if *!is HU/('almost_filenM!.join([(-#)Btag]i'cflags.fe == 0$F~, `= RHstr(!n!if8.isalnum()'VT'{!r}alphanumeric'.formatJu{}.{}{}: #y, _OPT,?P 4 + BYTECODE_SUFFIXES[0];"pydprefix # We need an absolut th0py Pavoid possibility ofu# collisions within& , someone has two differentM`foo/bar.py` onz irQatem any import both of%@m usT7theNrm . Let's say[.7 isC`C:\Bytecode`;k idea her at we get `Foo\Bar`, we firsvmake itv(_PSomewP\= ),i$n 0root-relativ/(`< so}end up plac# bin an # # unambiguous `C:\Bytecode\Somewhere\Foo\Bar\`.  if not _path_isabs(head):")# =&join(_os.getcwd(), %) 3# Strip initial drive from a Windows r. We know we have an absoluteO, , so the second part ofcheck rules out a POSIXiW thatQhappens to contain a colon atNacharacter3[1] == ':' and1[0]N!inu_separatorsOF?2:]9FB`7`ampleteconversion@back*a root-relatXpbefore 6inghreturnR sys.pycache_prefix, 0.ls(h)*filename)JT, _PYCACHE, :) def source_b_z"""Given'.J#, rY!qits .py!.0ThecQ does@needSexist; this simplyXszi] calculatFpcorresptsQ. IfZ}JpconformPEP 3147/488 at, ValueError will be raised. IfFementation.G_tag is Nonf`n NotIv)"edU$isP(1"""V?if Yc/('I'? =  fs  IGWsplit/found_in_2r = Fals "i91pedn! = 8!.r$9~!ifj.startswith(2V+!<6! =>J[len75):]c-5Tru}*x#, ju%if'%!=J$#D(f'{} bottom-level directory in 'N 0f'{.3!r}Idot_count =_3.3('.,6if /in {2, 3}Pexpeconly 2 or 3Is{5uelif dot_count =c= 3: #optimization = pycache_filename.rsplit('.', 2)[-2];xif not B.startswith(_OPT)ipraise ValueError("=A por4of Q doesgZ% "~P  f"{ {|U!r}")/opt_level =C[len4.isalnum( fq{R!r} i/an "alphanumeric v86basPpartiN2)[0 return _path_join(head, O+ SOURCE_SUFFIXES[0]) def _get_source(bytecodeS"""Convert a ! yb to a D(if possible). This func exists purely for backwards-compatibilit@@PyImQ_ExecCodeModuleWithFs() in the C APIz"""f0if V == 0QANonevrest, _, extensU B*.r7K>6 or=.lower()[-3:-1] != 'py' bR6try&l# =za_from_ @except (NotImplemented, e [W0,#if!isRe) elseC d(7i?B.endktuple()2 1d-o+-,(Apass5/elvBYTECODN&sei"calc_mode(alculate!p permissg . /:=Bstath1.stvQ!OSD<Q0o666)# We always ensure write access so we can updd`^ # r even whe' are read-only on Windows (#60748|= 0o200r@`check_v(method_Decoratorverify thatn ule being requested matches#!onzaloaderchandleThe first argu (self) must define _name which t#he second argument is compared against. If theison fails n ImportError is raised. K1"""def _check_name_wrapper(self, =None, *args, **kw !):?!if(c+B0 = O. 6Felif1 !=E =('loader for %s cannot handle %s' %a~)=)>return method3' P# FIXME: @Nused to define classWs beforey# _bootstrap moduleCset by _set !_m 1().;(if<0is  ' =(.@Felse} (new, oldUreplace in ['_r__', '_M @qual^vdoc__']oRif hasattr(old, b |*1set++3, g A9new.__dict__.updatep)(Cper,V*(1 IDfindCshimO1ful`"""Try+07 a specifiedby delegating toiA_? 4ThixTdeprecatedfavor of :0er._q?0_warnings. !("* YBand fv1"slzFPmovalPython 3.12; use Qead",M DBionWb# CallH52it ps a strBc(indicNhs#a sppackage [@ion)rnerate a K1and#f ,@sI(E$if !isI YClen(sB msg = 'Not idirectory {}: miss__init__'f= msg.formatjS[0]), jNify_pyc(dataDpexc_det`"""Pern basic validity of a pyc hew flags field$which determines howkDshould be furtherq^,csource5**qcontents8file. (Only?first 16 bytes aremrequired, though.) *name* is the name of module being imported. It-used for logging. *exc_detailsUa dictionary pas7Ato IOError if it rai1forIimproved debub :s7Bwhenagic numberincorrect or &QflagshRfield)valid. EOF^@data-found to be trunca1"""Zm = 4A[:4]2if != MAGIC_NUMBER:Bmessage = f'bad/0n {a!r}: {JE!r}'=_bootstrap._verbose_Qs('{}', )3x(#8, *2pif len(o) < 16preachedL while readHpyc headerg0 = _unpack_uint32R[4:8]&a# Only@first two ;are defined.4#if& ~0b11!inN+{LV!r} ibreturnZ def _mate_timestamp_pyc, source_mQsize,,{)@"""V*`ate a Pagain6#hem last-modified z!;ocontents N{file. (16 bytes arerequired.)w*a p4 s G F@None<;=5 5mS(And@codeSstale/if`8:12]) != (hc & 0xFTzw9yterk.8F1qis not 1and`Z12:16D u=(f'{  Nhash , name, exc_d6etails): """Validate a hash-based pyc by checking the real source+ againstaone inU,@header. *data* is.contents of/file. (Onlyfirst 16 bytes areIrequired.)Y_`importlib.util.#$()t wKEnameD ,module be ]`ed. Itu1for loggingRexc_doUa dictionary pas7Ato IError if it rai1forimproved debub*An=s:iV9@codeSstale2"""Y f [8:16] != K $i(= f'z1 inodoesn\'t match,#of^ {YY!r}',H'**0) def _compile_( , Me=None,S_pathCP6 as founda.(= marshal.loads)s Pance(-,sde_typer+_bootstrap._verbose_message('8 object from {$qLiP@not (_imp._fix_co_1Ypreturn FelseS P'Non-."in.format() =!,  : Zo_timestamp_pycm3=0,ls_size=0"Produce^>  a 4I.!%=array(MAGIC_NUMBER3#.extend(_pack_uint32(0)! % +Qdumps% 72a,ded=Tru510!flags = 0b1 |qQ << 1nO8;wrt len(m) == 8F" A de_OxLD$0s represent47VS and +6str5Universal newline supi"ink8D tokenize # To avoid bootstrap issues. source_bytes_readline = _io.B8IO($$).%? encoding = tokenize.detect_ ?c)?0newp_decoderxIncrementalN!D (None, True@{return G.O y[0])) # Module specifications ## _POPULATE = object(h1defc_from_file_lomt(name, =*Bader/Asubmu_search[%s=!):CB"""R5"a 4 based on a !. 7`To inde that the@is a package, set2 to a list of directory paths. AnARempty'is sufficient, though its not otherwise useful`1theEimport systemPhe lo[ must take a!asWonly __init__() arg=2"""Yf#@ is a # The caller may simply want,rtially populatedM-^E or!ed. So wea~0a bogus value andFfill in as muchwnkK= ''Dif hasattr(8a, 'get'\Kp# ExecuILhJ6try*c.a"-except I^ErrorUApass{Felsel`_os.fsy(g!if__f_isabs%N CPjoin(rgetcwd()uO/OS J# If  is, but doesn't actu}cexist,HSould Sd here,."no#id. However, dou0havdgood way@testT@sincg (e.g. a zipor URL) wplook liBAnon-2ent1relative+ }bootstrap.ASpec}2, origin=@3._s*! =>`# Pick if one waprovidediYk[k3forr_class,0xes_20sup!ed_Ls():  if location.endswith(tuple(suffixes)): +loader = _class(name,P)6Rspec.2; %UbreakJelsereturn None '# Set submodule_search_paths appropriately.0.if-s is _POPULATEy# Check theLif hasattr(, 'is_package'>6tryW?/.X Nexcept ImportErrorUApassbL6if kF# a4A= []j b7TO3' =|0dir1 = t_split(2)[0+ .append(V)<a # L%?s #1! d WindowsRegistryFinder:"""Meta ! fR for s declared inL# rMB."""JREGISTRY_KEY = ('Software\\Python Co{sys_version}'61\\Ms\\{full"}'lo_DEBUGrFs\\Debugyl`_BUILDr _MS_WINDOWS and '_d.pyd'.EXTENSION_SUFFIXES@staticmethoddef _open_WG(key 8winreg.OpenKey(HKEY_CURRENT_USER, Ok /OSYLOCAL_MACHINEZ[@n [Tcls, wif cls.a Aa_key =,@:_n.format(= ,5s='%d.%d' % sys._info[:2]F b% as hke"Afile#= QueryValue(33, 'v return NoCne return filepath @classmethoddef find_spec(cls, fullname, 8=None, target !)::g] = cls._search_registry(K)2io@ is ]OS5:try%_d_stat(cexcept OSError9^for loader, suffixes in _get_supported_i_('s(.endswith(tuple(R)37t = _bootstrap.S_fromjB, 9D )O"porigin= r^o omoduleq-"""Find 2 dDthe i.oRThis adeprecated. Use) instead>5"""i_warnings. ("WindowsR1er.=*()rV and P0"sl premovalPython 3.12; u"DBionW 0if ?not%.h9Oelsew! 1 _LtrBasics:"""Base "of common code needed by both SourceEjslessFil.is_package(self sConcrete implementation of Intz.Pchecking ifr]! r\Ia has aof '__init__.py'J5#= Aplit.UU))[1]? _bh=u1.rsH'.', 1)[03Qtail_=p.rpartiv('.')[20Zj=' W! screate_\z default semanticsU9 G1ionF]Jexec[/ ]Execute  F = |((_3&__i deS "paise ImmP('can{]{!r} when o) '  'returns None'.format(module.__name__)) ;"_bootstrap._call_with_frames_removed(exec, code, Kdict__) Kdef load_(self, fullr!):%t"""This method is deprecated.""") # Warning implemented in _h_shim().6 /  class SourceLoader(_Basics):path_mtime OptionalRthat Ps theDPifica' K (an int) for#specified h (a str).QRaises OSError whenA/cannot be handled*lrDC[ro_statsa`adata * gPossible keysA1- '~' (mandatory)HYqnumericTstamp of last st  ;- 'size' (oaPbytes]v\RItRallow er to read Vff files2# {> : .| &)}t_cache__-", "  which wri;/ (] s)aL 6]o-ofL3Thenris need]2ordcorrectly transfer permissionsMF# For backwards compatibility, we delegate@set_(= d$, , T:Bget_[h;ConcreteDPof InZt.P U" =b#h(o6tryusDq(YdexceptQz as excNsaImport"('a `availathrough data()',  name=full ) from exc .return decode_source(_bytes) ,Cdef 0to_-(self, data, path, *, _optimize=-1):;kB"""Rj@the ? object compiledc.t9PThe 'd' argument can be anyEtype thaO() supports. _bootstrap._call_with_frames_removed( u'exec',Q dont_inherit=True, +5m8getg TConcrete impleation of InspectLoader.NZpReading,requires_stats tomaed. To writeA`, set_ must als>5"""B_H0 = [@file( 2mtime = NonNsLhash_based = FalsRScheck 0 = 6tryxP`cache_|Bb)Hexcept NotIedError_ Jelse/ $stg./OS Epassint(st['&'] ,b'(vM X xc_detailf{ '4': 6'9': /}o3@flag_classify_pyc(=,FGs= memoryviewMo)[16:]; f& 0b1 != 066if 9 U c0d Eif (_imp.Ft,s@'never' andJ(F? or1 |== 'always')\  source_bytes = self.get_data(mpath) ; -hash = _imp.(@O_RAW_MAGIC_NUMBER,7h2_validate_P_pyc(#, i, fullnamer exc_details_else: timestamp5 &m]st['size'],=*W H except (ImportError, EOF )^Opass  _bootstrap._verbose_message('{} matches {}', Pcode_b A5return _compilx(s , =X LU= = $ifks is Non/:"dobjectE0to_T  E bBfrom e Hif (not sys.dont_writJ andD1  g- 0if n_based$|&Hq( r)N9M46_toEc, check_W Q cHh=9len:)>try?V_cachE) A Xexcept NotImplementedError: Epassreturn code_object class FileLoader: 0"""Base file l +which imple{Es th"protocol method!atPcrequirPsystem usage."""sdef __init__(self, fullname, path)"""Cache}pmodule )A and01 to found by*afindery.K=0[=%eqWothery1.__Ha__ == *5andmuj__dict5)ChashF) ^ J@_check_%!_miCh0"""E2 a *q from aE.CThis" is deprecated. Use execl) instead@2H# The only reason for tb".AIssue #14857: AvoiCzero-arguWm of super sZWationTrof that6can be upd without breaking*3zen8:u( , ()., @get_ R+JSsourc8as T L@elf.GOCdata H( ms as raw bytesPif is.CanceY!(Ser, ExtensionK)x _io.open_,Q(str()}@3u.read()Jelse1d!IO]_, 'r'ab_"re_#erimportlib0ers1ort RemZ)Krv )kConcretewWQp25 us0HZa_stats:\Bmeta`6ecQest = _V{'mtime': st.st_f, 'siz } _c_fp, ,  # Adapt between the two APIs mode = _calc_ (source_path)' return self.set_data(bytecod, , !, E=J!) ?Edef 3A , \0*3q0o666):4"""Write gs^ to a file."""*qparent,1namcp_split( _parts = []E# Figure out what directories are missing.3bwhile ~ and not 9r_isdir( rtz/"thp.appendVt$# Create needed0fort in reverseHZ@joinud:}6tryg_os.mk5except FileExistsErrorF# Probably another Python process already cd6dirocontinue!OS as excCould be a per @on e , Q-onlysystem: just forgettA# abgbriting>ata_bootstrap._verbose_message('cua {!r}:-',uy:exc1P  _wq_atomicn  Q '"5 0# S as`#veadon't jP n j  3 d class Sm@less vLoader( 2, _Basics):S2""" which handles N imports-@get_(@full5" =.q#(,M+# Call _pify_pyc@do b validation of"but ignoreq# result. There's noUcheck againstexc_detail{N'4': :' +':}B (,JOxP _compile_(UmemoryviewVj)[16:]= bytecode_path=path, !) def get_source(self, fullname):$2"""Return None as there is no > code."""6r3 class ExtensionFileLoader( 2, _Basics):2"""d for eC modules.&The constructordesigned to work with pcFinder:__init__  , >).0 = =)-! =4W%eqUo?P*s1.__+a__ == *5andmquj__dict5c__hashF) ^ Jrcreate_4g, specUA"""C& an unitializedQ = _bootstrap._call__frames_removed( S_imp.sdynamic'Uverbose_message('Xp {!r} lad from'E !, 4#JexecH" JI@N B9,z*v,)Q?ute.>elf.1pis_packM pTrue if ` #a M Pfile_qa_split.A)[1]Gany(94= '3' + suffix48 in EXTENSION_SUFFIXES^O .anrcannot ! ay objectK os have',q@_checkIv1the  Cfound by1f Fz  _NpacePath#presents as#u!'s. It use@.0to 0 it/Crent#C, anU9e it looks up pa.!'sG ____. When thi*s changes, the module's own path is recomputed, using_finder. For top-levelGTcparent!'s9Hpis sys.gQ."""  def __init__(self, name,7v!):1( ._(! =/ c! =C Rlast__&Qtuple{I._ge;())@4a%dsb"""Returns a R of (--R-|Q-attr)C 6, dot, me = #.rpartition('.' if0f == ''\O`# This a. containsKt.5Mr 'sys', ''!P# Not L". P !._)__tF/ {K4, 'F' 9<_0th_mq0get=( X.s[g]h)recalculatG# If4 ha d,? YJ" = # Make a copyC#ifZ$ ! { sEspecJX~ XVdGe that no are made if a loadered, but weL do rememberK3newa /1if is not None and.s l=B.sub _search_locas48.4?pecB 9 dSbP# SavRe;_S_iter3)CitemE , pxL G[+]>setMWSLC(thJ3len9?len?rep'_NamespacePath({!r})'.format[ )| , item in self._recalculate() def append(self, item): s._path.'!V # We use this exclusively in module_from_spec() for backward-compatibility. class _NamespaceLoader__init__`name, _finder6 = X_Path(>@staticmethodRrepr( m"""Return 3the.WLTX is deprecated. import machinery does Jajob itN1"""Z_warnings. &("J._*()~V and KO "s.dpremovalPython 3.12", DBionW)r"'<a {!r} s)>'.formatX0.__'__is_package@full&hBTrue$get_sourc9*''7?cod5compile('', ' exec', dont_inherit=rcreate_+`"""Useault semantics9 G@ion.v [/]FpassJload1d0"""P0 a }2is ? i0. ) instead&#system never calll.9 _bootstrap._verbose_mess?' qed withR%',NR##  implemented3_jcv_shim() /n%, "re0_re;P rortlib.-s$ NRE d ) F?s #1" Y:r"""Meta@sys./! ___ attributes)pinvalidwcaches(5q"""Call)0on &bentry sSBstor_2er_wp (whereG)Q,]e[list(Rer_cache.items()): if finder is None*del sys.path_importer_cache[name]Qelif hasattr([, 'invalidate9+s'i..,1() c@staticmethodQdef _`hooks( Y"""Search(d for a ':Q'."""X,if6ais not&A and Y =_warnings. *(',qempty', IVW/)X; in i:trypreturn @Wcexcepty^ErrorBcontinue9;els e9_class ;`(cls, w xGet the) entry from V.!IfH9!in,happropriat}/ it. If no86available, store! UZ== ''r- _os.getcwd(FileNotFound# Don't Sfailure as cwd can easily change topA# a  directory later on.."> / =[h?KeyLMcls.  En# =3ai@legacy_get_spec@full/s'er # This would be a good placeDeprecation'5 if# we ended up going that route|_loadermsg = (f"{_bootstrap._object_1)}.F)f&; OP"fallbback tM:()" F?msg0` , Eions(k[omodule3nd_module(fullname) portions = []if loader is not None:@ return _bootstrap.spec_from_<2(fur,Mz+( ==ModuleSpec7v 5Q.subm+_search_locao @classmethoddef _get_$f(cls, path, target="""Find the@ or a`space_< for this /package'A."""NB# If*ends up being a+R =,e'isGpist of s that will become its _<%__; entry inU!if$isinstance(-, (str, bytes))48continue0finxb= cls. imser_cach]53if 8'hasattr(/0, ' '5# =`./! :;els5Tflegacyl.erX1if A/is_]>.,D> C5if > qraise IpError('lP miss#''0# T{is possibly parW.# Remembe1ese ies (if any)jwhen w# createDand  iteratingoy .extend([F9+ = OaTry to" a+'Z' on sys. ' "'.#BThe ` Xbased4p_hooks G_0athTN % =n ,  is None:  return None  elif spec.loader is!:"*namespace_path =2 submodule_search_locations=:if @ \`# We found at least one8 xB. Rai whichlMcan create thFmckage.4origin =#T = _N'Path(full,?, cls._get_w)j Nelse<.  *&TU@classmethoddef find_f(cls, =e)0"""2e6 on sys..P or ' x' based_hooks an|7_importer_cache. "RThis deprecated. Use() instead>5"""J_warnings. ("pFinder.)g E0"sl for removal in Python 3.12; u%",Q DBionW/! =Muz-fUr@static.9distribu(*args, **kw 79{v 9n iterable of all Dkances cap&a2ingqetadata!pa ps match#``context.%``D1(orvps if ``,q`` indiS) alogzs}ElistIof directories q3&``Rfrom Tlib.m# Mo" w 1 #P File2er:0"""-|#er IncQ withx@filetem are d`erformq, beingrefreshed whenE9yvPhandlhas been modifieLU__init__(self,W0, *%er_detailsInitializeB to aQ varinumber ofy`2-tuplPontai~{[/+wuffixes!Hrecognizes.[Gs = [] for loader, suffixes in loader_details: s.extend((8,4S) forLJ5es)Dcself._F# =8s # Base (directory) path @! =u or '.' if not _#u_isabs(3)# =0join(_os.getcwd(), % amtime = -11@cachLset(?relaxed)Kdef invalidate_KE"""I$U the 7 A."""Ofind_modul_a_shim %X, fullnamepTry to /# aspecified ms,HQspacep package portions. Returns (, list-of-#").?This method is deprecated. Use_() instead>=_warnings. ("FileFinder.GgV and 0"slpremoval5Python 3.12; u%",#Q DBionW{Rpec =S0if 3JNone7r E, []59. 2sub_search_loca"[]^B_getUf_classj,, smsl, target~|[>(=_from_file 7=d=)=w:"""krQP iG'matchingf Kefound.5is_v = Fals=Tp.rpartiv('.')[2B:tryk&Astatu.|<Q).st_1except OSError["if5# !#wT =.*l" =Y(# Qkeepsoriginal casing,_i1e__Lffriend/Aif _Kg_case(6(s_cache  cache_module = tail.lower() )u else:= = self._path_%T b'# Check if the m!isname of a directory (and thus a package).O1if u"in Abase1 = a_join(,  for suffix, loader_class in sr;init_fileQ= '__C_' +T0Afull !, CV A#if is%(Q)0Treturget_spec( , D 5, []?JrgetDp0# IOTspace#, "we don't'# find aAnAext section%x6is_x eisdir( a M0 w/Dropev existsl.0 >tryxn Texcept ValueErrorgyINonei_bootstrap._verbose_message('trying {}'(Zity=2 HU 4$8if [ F possible AVMDS2K , 9Q.subm/_search_loca.8s = !Ag @def l]tq"""Fillpotential s  s FthisA."""n &  M0coni_os.list5@ or getcwd()4:(FileNotFoundB, PermissionTNotAD%#  has either been removed, ed into r,:mad# unreadablezg [] 4# We store two cached versions, to handle runtime changes of the # PYTHONCASEOK environment variable. + if not sys.platform.startswith('win'):/7self._path_ = set(contents)-Jelse;# Windows users can import modules w case-insensitive fil# suffixes (for legacy reasons). Make(` lowerXM herL o it's done once instead\_Severy. This is safe asthe specified escheck aga^ are always/Kin aP- fmanneru__*item in ) &name, dot,0 = 6.partition('.'Z8 if5P@new_X = '{}.{}'.n0at(i..()\NVZK ? S T.add(: nCi/ifA__INSENSITIVE_PLATFORMSWzrelaxed_4{fn (fn!} @classmethodAdef  hook(cls, *loader_detailsQ"""A B C which returns a closuo2 onasn8Cwill= @nstaXRusing#Qs andO`calledoX.oI ,a directory, IuvError igraised^5""" P_for_FileFinder(O"""Path lib.machinery.C.l@ Oisdif*e('only1iesn0suplAed',1=KA cls3zI_ )5__repr__(Y%A'e({!r})0.3 #mOup #+! rfix_up_}(gB c S=None#@func cused by Py\_ExecCodeMObject() = ns.get('__loader__') spec = ns.get('__if not l4:15!if8%! =.2elif pathname == c ESourcelessFileL(=,G{OelseH D G_from_file_location,$=6tryO6ns[^]Y =0__'  " A "ccachedDf%except E6ion # Not important enough to re.@kpass def _get_sup!$ed^2s()\"""Returns a list of -based module<1s. gEach item i7rtuple (, suffixes)1"""5extensions = E u, _imp.'_H(sp2 = y9SOURCE_SUFFIXESobytecode1 , BYTECOD7r % [2s, z$, S]_set_bootstrap_m+(jvglobal ' =Miinstall\B"""I#A the2 components._E^ 60ys.b_hooks0d([fFinder-(*c#)]ys.meta_K.append(PathD#) $os )4lib@tempfunctool0xcontext35ype` gs typing Union, Any, Opz"al(D.abc&"ReF Re, Traversable ._adapters4wV Packago [t!.MrType, str2s(p3~#Ce: (JI) ->;XGet a# r #a ]6;"_ ( #))normalize( 1Any4strkN6 th by ensurt st!If`result& Aains/ separators, an 0ionQjraised1str("trqparent,E_B = ot.split(;wrent: 4 raise ValueError(f'{path!r} must be only a file name') return _ def get_resource_reader(package):9# type: ( s.ModuleType) -> Optional[RERD];1"""R|Cthe \P's lom if it's a B.:B# We can't use# a issubclass() check here because apparentbc.'s __2/2__(# hook wants to create a weak referenceobject, butzipimport. er does not sup Os, resulting in aM_. That seems terribledspec =R0.__!__C =Pattr(.s?, '', None) Rignorl3if R!is'X<zth/woX|lve(candqPh }l<HsinstancO, Relse Blib. !_m`"""TakEJB or q FD and\!. Rqan excel':dMiia@A.=rosqif wrapD(-R).sub_search_loca.s J r~Sfrom_ Ta TraversableQ@for #Vgiven ' =o0 = '8.6^f?.ms() @contextu qmanagerP_temp.(:, suffix='' No)-.NamedTew@aryFas it leaddeeper 'try'# blocks du@needQclose9bRoraryGto work on WindowsLproperlyfd, raw_0 = E@.mks (h6tryKos.write(IH"()(j1os.6(fd3del(`yield nTPath(8gfinally Cos.remove: nNotFound&@pass functools.singledispatch0as_!(Ga Traversable object, return that o as a path oe local file system in a context manager.81"""\P_temp:(Q.read_bytes, suffix=name) @as_..register7lib.Path) @t ~a def _/!):Degenerate behavior forHZsQyield( """Abstract base classes related to import.xcfrom .` _boot=p_external "machinery tryN _frozen_lib except InPError3exc8`f exc.R] != 'A'(Qraise- & = Nonej \3/ =D_abcBrLoader D abc warningsPdtyping5 BinaryIO, Iterable, Text,Protocol, runtime_check5" \a s_cls, * vZ0cls"o9Acls)#.ifq is notM.- 1= getattr(, cls.__(&__FAttributee z'ir aO Finder(meta=abc.ABCMeta): I"""Legacy XIfM"s.7Iy be sub]!ed.compatibility with l`@thir"1rtyz reimplementations of the?. Otherwise, ? =should derive 3Mmore specific H0or REntryD ABCpDeprecasince Python 3.3> S_init__(selfy. ("jdfBand : ""sA9premoval={12; usePinstead", BionWR)@_FamethodDq_module`, fullQ,5=A3DnN~R2 a T5The[[`a str Vw opj!alt!or1F Returns a Loader object or None. 5""" warnings. ("importlib.abc.FinHalong with its find_module() K^ "method are deprecated and3A "sl%for removal in Python 3.12; useAMetaPath.`spec() "4_Entry9instead",5DBionWO) class Q(meta=`0ABC 1): ["""Abstract base * {ers on sys.N`_path.D# We don't define4_ here since that would break>hasattr checks wMp to sup backward compatibility.2defoself, fullname, !):j<"""Return a lBthe AW,SIf no is found, r@U Then%Pa strss\plist of&#JwSThis (isF4favor ofo(er3. I$exists then]$s-^&leLunctionaqprovided!t6ymD9"3. Kstacklevel=2)eig#t ('C'TC0 = < /C6."if%1notQ else linvalidate_cachesRBn op8eclearingyQer's F, if any1 used by -)> _register(y, machinery.BuiltinI(erVFroze> ?:WindowsR5&UeBNs'cf 9@o to support0 backward compatibility. def find_loader(self, fullname): %"""Return (+ , "space portion) for the path entrhC5TheZ is a str.  L!equence ofG\ies contributing to part of apackage.iFsZmay be empty. If not None,U willHbe ignoredR.adiscarded if another(%erXqlocatesymodule a3normal moC~is methodPdepreM@d siLPython 3.4 in favor`0er._spec().VPproviEthand$s-e%le@funcax<.#5""" warnings. p("PathEJDFind ()NR" b E(availableVe3.4)",p DBionW*stacklevel=2)N0if dhasatt''or%[]Gfound = )2if ,!isyJ c&B.sub_search_Jions59Gs = Oelse0 m N40,s*t8,+j = _bootstrap_external._#R_shim`invalidate_cachesf"""An op%LQclear<1's F,HyE)Thqused by<)? _register(, machinery.FileR) class ResourceLH"):b1ct base 4s which can data fromi-end stor_PABC rgsents on5<Yprotocols 3ifi!cEP 302Ac@abc.aO @get_, 8when implemented should: by"fo4 P must_M raise OSError class InspectLoader( ): """Abstract base 3Qfor l0s which support iMion about theJpmodulesQy can@.f This ABC represents one of/ optional protocols ified by PEP 302M2"""Vdef is_package(self, fullname):Obcmethodwhen implemented should return whetherLc is a ye. Theyqstr. RI,CboolRaises ImT" i acannot be found.BrFEget_cod M  : object Bthe types.CodeTypepossible, els8(NIif aPdoes make sen:(e.g. built-in?). aZisource = d.\(nF2if  3z\<3_toy)c@abc.aD? k 9 r@staticOdata, path=''*Compile ',j' into (@arguEbe anything that cU!()phandle.6''"F be re @ wasrieved (applicable).V}@ , 'exec', dont_inherit=Truek_ = _boot%p_external._HwBasics.0<@0 _register(, machinery.B"in@(erUFroze)PExecuh \uwish to4a1 of@s as scripts<)/in @abc.abstractmethod def get_filename(self, full!):&*"""Abstract A which should return the value that _Z__ is to bePset to. Raises ImportError ifPmodule cannot be found.:5""" rFEa?cod M6 object forS@None applicable (e.g. built-in m)DR*source = .(-2if 3:try%HpathmJohexcept Kp@_to_}()Oelse= , &) _register(ExecutionLoader, machinery.ExtensionFile) class `(_bootp_external.B, ReC+, s"):^Rbase ipartially implementing Y2 an `` ABCs.!S8m  (Fless,F!-@loadg . (and op=1anycorrespon2@byte/)`To sup~ UDfrom#+,{as inherited 0j P needh&beed. To alsO  s specified directly by this Ois requiredI }@ed iL*xAdatap" #. E_mti RtP(int)RPifica ;B=a (str)@elf._stats.__func$ zs!OS1intT>(m1)[';'])4n3"""aaa3 di@poinsy the path (strC). Possible keys:- 'mtime' (mandatory) is the numeric !stamp of last sourceF code modification;`- 'sizb op%ala in bytes]v\R5"""Qif self.path_.__func__SgLoader$raise OSErrorZreturn {:h(s1)} 1 dept_data( ,  , )o"""WriteS!to /c (if p").[Accepts a strZA and]2 as3/2ny needed intermediary directories are to be created. If for somezareasonfile cannot7written becausepermissions, failGsilently _register(, machinery.BFile) class Re ReQ(meta=abc.ABCMetaz"""Abstract base )ls provide rY reading support.x@caRamethodTopen_C : Text) -> BinaryIORs0an F@ed, t-like objectb<TThe 'm' argument expected`represaonly afV name!IfMpfound, @NotF9fJdF2F# This deliberately 0sLnstead ofY@NotImple"edus>@at i2is accidentally called,Mit'll still dEe right thing  ;_ r system,specifiedSPdoes hexist ,g %X,is"$OboolBTruee0d ':'  Files are resources, directories are not. 5""" raise FileNotFoundError !@abc.abstractmethoddef contents(self) -> Iterable[str]:)q"""Return an i$q of entin `package`. @runtime_checku class Travers(Protocol)ZAn object with a subsetpathlib.Path `s suitPA fortd:inggpnd openRfilesqw7M 2dirL;; XYieldPs in *rread_byte]ERead QA as : Z='.`('rb')2Fstrme*r."()^Atext, encoding=NoneDHe  %s_Fbool qTrue ifP is aU  t qCu Aib v @join1w, child/ __truediv__d=Eelf. , mode='r', *args, **kw 0 may be 'r' or A1 toCHbinary. Dq handle _P(sameF").;AWhenp30as s, accepts parameter  chWFthos2ed by io.TextIOWrappernUpropertyAname?str>The base 0Cthispout anyent referenc9RG( r#er>required interface&` provi ,@r\Lh  a Traversab4le object for the loaded package.""" def open_resource(self, r!):'+preturn .files().joinpath(? ).Nf('rb')b_,B,baise FileNotFoundError]R,is[,@.is_(contentsN(item.nameY+ i#iterdir()) """The machinery of importlib: finders, hooks, etcfrom ._bootstrap> ModuleSpec #BuiltinIo/er(_Froze'_external{(SOURCE_SUFFIXES, DEBUG_BYTECOD9=OPTIMIZED2 EEXTENSION) WindowsRegistryF~7OPath,,So2L 2Oless6Extension5 all_suffixA"""Rs a listall recognized m~ ; this process]1 1. +> +  +4 os $re 4abc 4csv %sy+Temail4lib0zipoperatortextwrapuwarning[functool PposixuCcollections rPa_adaptS_meta $PfMetada#V* FreezableDefaultDict, Pai_3method_cache}%unique_everseen(# , Simple?]x4suppressP4lib_p $D.abc(h{ rstarmapGdtyping@List, Map@, Opal, Union __,Q_ = [ 'DC0ibu).',   das)entry_points', 'files', 'metadatapackages_distribution.frequir>version', ] class PBNotFoundError(Module!):s"""The x was not f<Q.""" &def __str__(self=return f"NoFOK` for {;c.name}X@propertyf c(Q,) = AAargs0"0Sec7%ed/A simple entry point config parserperformance1>>>item in _f.read(0_sa`0...p print(=)APair='sec1', value='# comments ignored'2 _a = 1% _b = 2%2|J%Wres =sTo_pairs9 = next(resR+ $a1gJbJJY+!2'6.gg7lis![]Ja; = textwrap.dedent((,[:C:61 8G2G,2,p0).l2p()9@hamethod- Acls, l(7._replace(R=.(")N:T 2clsC, filter_=Zvalid=3if <" iANoneakstatic k=1linF(_, map(str.W)a.split1'()0 = Y3_match =_.startswith('[') and3end]'F$M h"<('[G)vcontinu\`yield  v (i\ 5#')"EPBcollsdtuple(',Base', ' group')Y"""An_as defined by Python packaging conventions. See `the%docs on entry points,->A/>`_Bfor more inform+.2"""pattern = re.compile(# r'(?P[\w.]+)\s*'!@:\s*&Dattr$,)?&?P\[.*\]"$I)Ot A regular expression describU>psyntax a:,Kwhich might look like:c"- -d/e. :_ibute<:object.*#! [11, "2]Other combins are possible as wellW8The.is lenient about whitespace around F2':'0dfollow]f, and 2anys@dist: Opal['Distr!ion'] = Nonedef load(self):Ab"""Loa from its definib. If only a`is indQed byvalue, return that6!. `Bwise'e named  match = .E..{\W = import_(1.group('&')6s = filter(K*, 5#') or '').split('.Efunctools.reduce(get= , #s,)@property6 yw@W'sw3list(re.fr'\w+', rzA_for , n~}! =oh WHq_iter__LFy9pSupply ) so one maystruct dicts of EPo2GSfmsg = T 2ConQ!ofW Viprecated in "D[favor5.$Gwarnings. (msg, DeYBionW/=(,.,)_J__(self): return ( self.__class__,(aname, Dvalu fgroup)1!) <def matches?, **params):!|attrs = (get *(a) for 2 in %s);all(map(operator.eq,,.Ps(), \as))  DeprecatedList(list1"""c"Allow an otherwise immutable object to implement Qility@compatib. >>> recwarn = getfixture(''(Ldl =range(3)&q[0] = 1x8.append(3'el dl[3]'reverse('jl.sort0extN9[4])bpop(-14WSmove(h += [5~R + [6[1, 2, 5, 4B (6,a#.insert(0, 0);C[0, ZhM == ATrue5$U?[ $Clen(AH_functools.partialx"Pings. B"EntryPoints  interface is dQ. Cas&f needed."MionWarningstacklevel=2__setitem__P*args kw 29super().P J3___delv:Pv/,, ' . K EtMm-Lnm1Kli1Hf!re]i1Klo__iadd6Mp o{fif not isinstance("w, tuple)~  other = tuple(3) return self.__class__(+2) +A!) 4def insert(, *args, **kw !):'^ ~._warn(psuper().K El/soj4Ihc__eq__$if not isinstancF,SV .z.8A)  EntryPoints(DeprecatedList1"""V An immutable collection of"ecO objects.>F __slots__ = (__getitem7name): # ->HT wGet the(" i matching Q2>(if(D, in.|Pings. (p"AccessjeU! pV by index is db". W>"Cast to  (eeded.",nionWarning$stacklevel=2Bx-sF -6try:next(iter0.se(<=&))Cexcept StopIteraD Taise KeyErrorF(\'cparamsS @frombf that:aagiven Xeters (typically group and/orO)PQ s(ep for epaif ep.Qes(**s#s)@property(JsaR}pthe set1alls   pset(ep.t  8For coverage while Gs`vpresent(>><Bs().oY>!"ep7 JamethodX_i_text_for(cls, 6, d\g cl$.-"lFcls.P(G'| x4rtools.starmap(!, tparse_groups(text o r '')) @staticmethod def _parse_groups(text):3return ((item.value.name, );1for- in Sectioned.s S_pair6) class Deprecated1"""&Compatibility add-in imapping to indi;Q that6`behavi5s db.2 >>> recwarn = getfixture(''( VDict(, dict): pass5Gdd =4foo='bar\dd.get('baz', Nonexdd['foo']U9 _rlist(dd-'.keys()$Zd1LTrue^ Cg3en(.d1A _^functools.partialu"Pings. ,6"SelectableGc interface ia Use s3&."FionWarningstacklevel=2K9@_get__(self, .(Rsuper()._E?y`CX, default=fK^E Citer{< PcontainsT, *args[GAU8sJ: A backward- and cle result from;entry_points fully implemee.;v @ load(cls, ep"by = operator.attrgetter('4`orderesorted(eps, key=J<,C3by(H., 7rQcls((/0, EPq ))L 0eps#ed0@pr!tylL_all4Reconstruct a W of all B the}s{?KBs = 0ed,%f)O>4`chain.z_able(groups))  @property def groups(self):preturn b._all.' !EMnameD1"""/Pfor coveragef>>> SelectableG!).N;Uset()U 9,s[, **paramsrif not [O `Z class PackagePath(pathlib.PurePosix"""A reference to a 01 in Fread_textencoding='utf-8'YBwithlocate().open(3 ) as stream.{"()abinary{O'rb'n$iB"""R9-like object tAthisSFb.dist.]R_fileFileHash__init__)g, spec.mode, _,~qvalue =*.partition('='Mc__reprVP4f'< ^5: {j!} b 5}>'DistribuvwpPython " p.-s@abc.abstractmethod >i`ttemptload metadata / given by the =.`:(3: T$1 of0B!in Qinfo.HD@; if found, otherwise None4 6,i G )is", %thC_to itu Pfrom_8Q(cls,\ 8y"6e@`X  Ato searcha:E Pinstaq(or subPreof)F r,nEaise@NotFError: WheMd 'k0canJ"beYrI*resolvercls._dis_'s(7ODs = !('Finder.Con(=)2 dist = next(iter(dists), None) 0if q is not!:!,areturn)Jelse*raise PackageNotFoundError(name) <@classmethod!decover(cls, **kwargs)`B"""R0an able of Distribution objects for all p"s.{Pass a ``context`` or pkeyword argumenHconstructingF#a ?Z:h: A ``Finder.Cr.O:ao: Iter5"""P2 = Ic.pop(''$ifC and3{]RValue@"can0oaccept@"gx% =')or (tools.chain.from_ (.AesolQu)r in cls._disx_&s(kstaticat(path zthe indicated metadata Ca:param@: a "ngsth-like9Zcrete|instancer"4dHPath@lib. ) SM"""Search _.declared = getattr(f^0, ' s_ erEsys.{L 0fil<4$, b_localroot='.'! pep517 import build,system =.compat_(X@er = funczpartial-..,source_dir=Z =z) 4rzipfile4{_as_zip(5er)Jproperty4!(self) -> _.]M@ X XHparsgIthisQThe r_#edc will have keys that various bits ofO. See PEP 566vdetails `.read_('METADATA't6or *text('PKG-INgFO') 0# This last clause is here to support old egg-info files. Its J # effectA'to just end up using the PathDistribution's self._path(which pointsA B) atKe unchanged.G"oraread_text(' return _adapters.Message(email.m`_from_0ng(N1)) o@propertydef name(!):+B"""Rh'Name' metadata for$d  package."""G].>[N]_normalized_ &a + version of:Prepared.;.0"\*%V(7Q+bentry_w {E#P. A_for1.nNq.txt'),`G FxP in t%.b:`: ListP@xa8is = or NoneDQResul`2` ik@ thaumerates(i.e. RECORDxs@or SOURCES6) iC0mis7may be emptyexists bu$ADf_lines =!._ s_ ()i2egg5Pmake_A(p, hash=C`, size8rp'= B'.U0 = PHash() R else3b.p = int( : > ,ar dhand list(starmap(0Q, csv56er(2)^]NARead#of-*0/ a.splitf( 0might contain literal commas, so wrap each win quotes text = self.read_text('SOURCES.txt') preturn # and map('"{}"'.format,.splitlines()) ?@propertydef requires(|!):h"""Generated%ments specified for this Distribution"""EDreqs_dist_info_R() or8eggI4Plist(B a ;.metadata.get_all('R -'[ D0dsource$('a7Q._deps_from! )@classmethod$;Scls, @ cls._convert__to_simplePs(Sec!ed(QlstaticYsYsNEHistorically, setuptools would solicit)e 'extra', including those with environ# markers,@pin sepa  . More modeexpect each< dependency to be definedRany relevant?s attached directle6thaA0. T Ps the0mer5the}latter. See _test@p an exa/.B @maken diKW(namef` == "{2}"'.Trquoted_( Vx'#Lla$p,0R.part'':91if <sh"s = f'({*})2con7filter(None, [7 I6)])%s'; ' + 'v'.join(i@) ifxkelse 'd0url`_spacey `rtPEP 5089As a ; betweenvUM FURef python/importlib_J#357/ # '@' is uniquely indicative of a :reqGAa ' * (Cn^)_ =eGsection.value)'  yield section.value + spacquoted_marker(&name) class DistribuAFinder(MetaPath!):r1"""*A  capable of discovering installedb!s.EM rContexti Keyword arguments presented by the ciAr toT57``ds()`` or ``.;to narrow[Ascopa search for:oin allR5s. %OEach# may expect any parameters: and should attempt to honorcanonical2E` defin2elow when appropriate9z@*u = None!)Specific )ywhich a!! fWVmatchqA=Pof ``i1`` "!esM 6 def __init__(self, **kwargsAvars").update('@Ierty_Bpath9QThe sequenc6directorth thatnJq<0Typly refersgPythonspackage @s suIGc"site-(4s" ix nd0Aault_```sys.L&``F wreturn gPget(';4', F)n@abc.abstractmethod3_~2, c+=3'() Rtan iter PGnces@loadmetadataT##``5``,Da .~r@FastMicro-optimized _LachildrengI@functools.lru_cache() # type: ignor__new__(cls, rootsuper().+ A  C.! =^base = o.26P).low}yp@join%!, "@lib.j*O/N?1ren$Gwith supps(Exceph"!os.listdi!lfk'.') wi th suppress(Exception):  return self.zip_children()'#1[] Idef *<V`path ='file.Path('V.rootZRnames(_3.Glist<@join&1dict.fromkeys(.split(posixH.sep, 1)[0] for %@ in "s)SRsearc,oblookupsmtime).;RQ@propertyM+6X(wiwOSError qos.statBBQ).st_Vd+.cache_clear(qmethod_5!, PL) class iI__init__ , }`: FastTbase = os.#.:(;P.lowe$_is_egg = P.ends?v(".egg"o@infotFreezableDefaultDict(w 0?egg/ 0 ESN &Rlow =q fif low(".dist-1",  )?:# rparti is faster than ext and suitthis purpose.P! =]@("."?.o1("-@ormalized = Prepared.n(`zr[+d].append)DAelif#}b= "eggD xO"vlegacy_  [1 ~@ .feT_8?3, pj(22/.[4)d],%ifX else itertools.chain_Eg.values(? = ] -m I(H , ?Y91"""AK search for metadata on a possibly-named package. """ normalized = None~legacy_def __init__(self, c!):_.! =!if1 ism26ereturn,E (a)/6 =>@staticmethod+<PEP 503 -ation plus dashes as underscores~:F re.sub(r"[-_.]+", "-"\ .lower().replace('-', '_')NjD the.as found inaconveniSolder9 ing tools versions and spec  c__boolzK) class Me"`PathFi(DistribuO@3 gfind_d3s(cls, context=N".C#()X u S.)R an iterable of all j instances cap&DAloadChe m4 foes match##``8%``D1(orvps if ``.`` indicated) alo?4ths/ElistIof directories qopath``!~= cls._search_0(s(.@map(9,E p , esc"in0 heuristically.apreparP {< ].chain.from_(..1(`) th@FastCqinvalidate_cacheD.__new__.&v_clear(g Oo `: SimpleC*"""Construct aIHa:paramH yT! =UPread_ `, file1with suppressFileNotFoeError,CIsAD>y KeyError, NotADirector Permission=)):Hreturn self._path.join (filename).read_text(encoding='utf-8') N!.__doc__ = DistributionB!8def locate_n( , ~parent /*J@propertyX_normalized_]W1""",U@Perf.nce optimiza: where possible, resolve the>i iP from! q system.3}P= os.A.baswA(str%))= r_r_H() or super()./!8ame;Qelf, A$_f, ext Aspli,!if( not in ('.dist-info', '.egg |Fq1seplwf`.partiM('-' 50 uw( |a"""Get(```` insta 1for"]d package.@}:param `R: The!of>#E` as a "ng:O: A (`bclass\Rreof)@PG |5s(**kwargs-?allsqthe curenvironment3: An iterable ofTdiscovermetadataP -> _ ".PM,%E Hto query containing parsed ?%.G>0ver:= $+*`pntdefined%'sw""V"S3 ke W#.Lentry_pointZ8 s)pUnion[E P, SelectableGroups]: h """Return EntryPoint objects for all installed packages. Pass selection parameters (group or name) to filter the<`resultez p{s matching those properties (see:"s.}3())For compatibility, r`s ``SeableGroups``q unless^R are supplied. In future, this funDCwillx7 ``!``Moead of@even when no smaximum puor invoke ``X`` with ou:c:D\s or pQ P1"""norm_name = ator.attrgetter('_"aalized(!')8Puniqu5ools.partial(_everseen, key=F@?eps = itert<chain.from_9(hQdist._/B in o(ributions()g4 $.load(eps)1(**s) def filesZ:`a listh2}1thec U3: T2H>#aquery.L"osek7i.orequir :3menz "A: An"A`, suit'mq*5Ging.-".Rz"Lse8es_8s() -> Mapping[str,  %]]1m.top-levelsQtheir4 lK>>> import colqA.abc30pkgi(aall(is~1nce,U.Sequence)tWce.valuew2Tru@iapkg_to1) =Xdefaultdict(E "()K%0pkg.read_text('top_O`.txt')#'').splitDH[pkg].appendTmetadata['Name'] ?#) re import textwrap import email.message from ._text "FoldedCase class M/(=.): multiple_use_keys = set(!&ap i,%[ 'Cjifier',Obsoletes-Dist"Platformroject-URL?vid\ "ro!_ExtraCoRequirC!ExternalF0Sup?ed- {DynamicA]6)^1"""Kthat may be indicated times per PEP 566.;C def __new__(cls, orig:p 3!re)wuper().A#vars(res).update(_)%return res init__(self, *args, **kw b ._headerelf._repair"()Y # suppress spurious error LHmypy3terpsi'cK ~B#redent(value"Correct for RFC822entation)qif not H or '\n'"in+3 Pbwrap.d' ' * 8 +Q5uy[(key, )l !rs4)['5']]0if -._payloadp.append(('Descrip"',:4get=.()dC@propertBjsonz&Convert PackageMetadata to a JSON-compatible5mat0R^#PtransS H0lf.1all'p if keyc@Aelse"F[keyq<== 'Keywords'"|re.split(r'\s+',$@tk =A.lowreplace('-', '_'3#tkMdict(map( ,  `collecRs #wjaraco.C 3.3)FreezableDefaultDu+".dOften it is desirGprevent the mu1 of#a Q R after its ial construct!ion, such as to prevent mutation during iter!. .>>> dd = FreezableDefaultDict(list)([0].append('1' .f@(e(1[1]<[kblen(dd%12""" def __missing__(self, key):)return getattr#'_frozen'gper().H )(Cc^Y.H = lambda}!: d_factory() class Pair(collechs.namedtuple('@', ' value')v@?amethodparse(cls, text+cls(*map(str.strip*.split("=", 1))) import types functools # from jaraco.P 3.3 mr_cache( !, 0_wrcr=NoneWrap lru81sup1sto2theG data in object instancesAbstracts%common paradigm where explicitly saves anZ underscore-prefixed protect perty on first call and o~!atJsubsequently@ MyC0...LQs = 0@4...@/ >o]DRs += T }4a ="a."(330Pfor xrange(75 re@x@:!a.J"750Not!atPapparbehavior will be exac3lik0&of_SPexcepHM@ is q edEeach[B, so s1oneGz{not flush*,another,uwhen anX1 isIqdeletedgadLfor thaIb }3}b}b}!350 2if 9 had been decoraHuwith ``K.Q()``,}  would haveFp76 (due11P of 0+sIQed byC5'b')P@Cleajp.] _c " PSame ahasn't yet=#edTccjAf%l@ mayNlied: >>> cac0he = functools.lru_cache(maxsize=2) >>> MyClass.method2 = m 2lambda self: 3, H_wrapper=L4a =P(\!3 }Caution - do not subsequently bC the with another decorator, suchOas ``@property``, which changesLsemantics of$Bion.See alsoQ&http://code.activestate.com/recipes/577452-a-memoize--for-instance-]!s/Y5forimplementa and addi al justific.=1"""z* =? or)1def`@per(, *args, **kw !):d#R# it'>first call, replaceEd, boundN_1= types.MpRType(,oAd7(T4dsetattX.__name__S6creturnq(E# Supporche clear even beforeF has been createdBper.<"= mb: Nonef/ from iter1 imfilterfalse unique_everseen(3able, key=_b"List /" es, preserving order. Remember all) r b.#Kz'AAAABBBCCD') --> A B C D5BBCcAD', str.lower8xc = setYA_addaen.adda if1 isYG in G(K.__contains3D:*u(JMTyield0Oelsed!E0k =b?!in ;?k _0typ\Any, Dict, Iteru5, Protocol, Var, Union _T =("_T") ch PackageMetadata(FWq__len__) -> int... # pragma: no cover0?D,3 m:LOOboolPsgetitemEN?strMJW_[str]Jsget_allname: str, failobj: _T = ...) -> Union[List[Any], _T]: 5""" $Return all values associated with a possibly multi-(ed key.GS @propertydef json(selfDict[str, _str]]A JSON-compatible form of the metadata class SimplePath(Protocol) A minimal subsetXpathlib.8 required by DistributionuK0oin@''|x ... # pragma: no cover I__div__H.oparentG.read_texJ?str import re from ._functools method_cache # )pjaraco.sC 3.5FoldedCase(strcase insensitive 1ng ; behaves just lik rqexcept eres equal whenfonly varia@ is j.>>> s = 'hello world')'A= 'HW~FTrue% _ == s%?s !JGFalsKs.index('O')E4gvs.split[`', ' w]0orted(map(, ['GAMMA1Palpha rBeta'])s*['#, 2\pSequencmbershipastraightforwardl"@" in [s]G] ,&0You may testU inclusion, but candidate and elementmF`both b$()1{s}{82<uString nk long asOq object<Bis ord"W; C But not i7rnVleft:S+(|!o' cIaQse, u_T Y.in_(U1>xIm C__ltd, othe*rp.lower() <&;?__gJ return self.lower() > other def __eq__(self,$!):!preturn :2 =='K/neK!KChashM)contains?uper(FoldedCase,)T7.__J ?o/in=Q"DoesS appear in;/?"b(qi# cache  since it's likely to be called frequently.g@method_CKD_s lQindexE_, subJ..$ubbTsplitJ ter=' ', max'=0_pattern = re.compile(re.escape(1Pter), !I)?.(vh) import collectionstzipfilepathlib from . 8`abc remove_duplicates(items]Witer(l.OrderedDict.Z4key9) class FileReader(abc.Traversabdsourcege__init lo90 = lib.Path(*.).parent"rej_F]&""RQ@the Iq systemt@prevc`Os@()`  creating a te5ary3copC~r1strTQ.joinl)s-G:?Zip,, modulen_, _, name =p.rpartiF('.'refix = .replace('\\', '/') +W+?D`archivrETopen_3"l6tryO=c*).GPexcept KeyError as excSAaiseNotFound,(exc.args[0],is# workarIc for `@.is_"` Etrue@#4non-existentstarget =.M6s()Of 4}d() andh!s( def files(self): return zipfile.Path(#.archive,  prefix) class Multiplexed3abc.Traversablea1"""iGiven a series of , objects, implement a merged>U0ion7 the interface across allD. Useful for<`namesp-packages which may be mphomed awesingle;.  def __init__&, *pathsT/_ = list(map(1liba, remove_duplicates As)))hHbif not~O message = ' must containleast one 'cG raise FileNotFoundError(_ 1all.is_dir()kX8 inhNotADirectoryi only supports d.aies') @iternjvisited = [],{?for O%&.b^M0if +.]0v Q)2inuT6.append(Rs*Qyieldspread_by; 0f'{*A} isZaRUTDtextargs, **kw  d'7PFTrue0is_,GFals-@join.w, child5# first try to find$@currv@s7" "==W iRc# if it doe`exist,`structPwith AU%R[0] /J__truediv__ = 'JCopen5*8@propertym2m\c__repru< s@, '.P(f"'{?}'"]{f(CEs})'NI{Reader(Resource  *Eif '_N'O?tr(7SValueNqInvalid'K self.path )= MultiplexedPath(*list(namespace_path)) def resoure(self,!):'+5""" Return the file system Z to prevent/`c s.#()` from creating a temporary5Ucopy.~r~1strTQ.join]ls-G1elfC iDt os Aio #. s_common0as_i,s$4abc RibReader contextlib&ssuppres@xOlib.I&LoI)machineryRModuleSpect$ioBytesIO, TextIOWrappMK?TtypesB\EType" CManager, Iterable, UniG7typ3HcastK.Vinary'collections$sSequencfunctool singledispatch __all__ = [u'Package',R 4nts 4is_ aopen_b # Kread00C] " =sf[str, $] "0os.@LikeF("(p#: _2$: Qa) -> B"IOH3""";a%-like object `red for  !ofk.. 3 = .normaliz(")/Cget_+{+er*N_ 2iJ is not None?n:. pspec = (#, 0.__""__0# U| doesn't work well here duelack of 'strict'# argumenteu.lve() priorHPython 3.60if Q.submn_search_locah?s == $elfooriginR "[om@.dir( ab!h(J2))]|g'1 inYsBfull$= S| 6tryF (V, mode='rb';except OSErrorF# Just assume the loader is a resourc; all the relevant # importlib.machineryPs are and an AttributeError forHget_data() will make it clear whatneeded from.L = cast(RLr, spec.#)7}y = Noneif hasattr(<4, '9'):1with suppress(OS(,y.V(full_path1if 1ais notreturn BytesIO(1!) raise FileNotFoundD(f'{6!r}df'Q in { name!r}') def open_text(bpackage: P ,]$: encoding: str = 'utf-8',sstrict', ) -> TextIOB"""Ra file-like object40or @ rear1 ofCC."""=`rWrappersbinary(,/4), = 1, e=c;_M8V4b I contents b as fpeQ0fp.(U a&2str@deco(-ngAThe )ing-related argum4Ahavesame semanticsthose of.I2e()A`&%)`pk4 'CxtManager[Path]'EA5Bxt m!a provi'R {R!to#.ZIPB doe al5y exist on i wn r system@a teW1ary`be cre#. l:4was,Ib le@uponAting*+(no exceptisF32d i] s"deU0priZ Q@0exiq %eq_commonR_(Gu)3_!EL$, Mnormalize_path(resource)) if readerelse _common.as_file(7s(package).joinpath( normalize_r~) def 'b_from_(%, ;:jreturn0C78 or.Topen_T nlm with suppress(FileNotFoundError)&OP;.p) ? 0saved = io.BytesIO#.?i.I('P_temp(W+, suffix=&ish)2: P2, name: str) -> bool"""True if '$e' is a inside 'R1'. Directories are *not*6!s.%1"""<% =Cget_+ .+erK [2wnot NoneX.EuP_contents = set(q; lx Use `)` on eachq"y ,bed her>to check it or&w?_ensure_sequence-transvers"]9if 5/Ndir(list(item.0for Lm inB1terC [] @singledispatchd c@@.register(S')a7Rh """Utility code q tructing importers, etc.Rc ._abc1 LobootstrapamoduleL_spec from ._bootstrap import _resolve_name from .&Pspec__loader)`_find_/ #_external{MAGIC_NUMBER.__RAW_3Rcache^sourc decode_/(cn1file_location :contextlib&manager 4imp functools%sy Etype warnings def Shash( bytes): "Return the $X of *(* as used in"0-ba@pyc 1s."IrHS_imp.@P(,(, package2""R a relative module 1 to an absolute one.""aif not'.startswith('.'^ L#el71*aaise I\Error(f'no ified for {reprA)} 'ZD'(requir8As)')Blevel = 0gcharacter6if f!= '.'QbreakJ\A+= 1 C[)%:]!, )& Apath91ith=Non@; Mm!. First, sys.s is checked asee if! was alreadywaed. IfP0so,,nR[G1]._ __a 8 that happenss"beK etTQValue)D>zr!is"inDD@eta_GGcsearch-a suitable~ ^Mv'<p' given`Pers. X>"noOQcouldLbe foundaDottedYAs do@have|ir parentswhlicitlYou will`most likely ne:exp6N all\aproperLQorderIb@to ghe correct21amei;* Felse0=d|'if>r3try: spec = module.__spec__ except AttributeError:&raise ValuE('{}I is not set'.format(name)) from NoneNJelse\0if F* }7 zpAQeturnf def find, package=J)B"""R81the<T for TifiedS oFirst, sys.kschecked to see ifC! was already imported. IfP0so,,nR[Y]{r8 that happenssbz0setTzr"inDeta_path.searched*a suitabl>@with^MvKP of '<p' given`Aers.:X>"noQcouldLbe found.Ib)<3subq(contains a dot)v parentWautomaticalleAThe b4and> arguments work same asBlib._1().lIn other9ds, relativek1s (Cpleading s)1k1"""M@full1 = resolve_ )Lame.starts[`('.') M5if P +dCi% =3.rpartition]1[0]V2#ifx5JNS = __0"_(-,Ylist=['_U__'])\D:tryUEu# =.B ? V?! M`@NotFF(S+$f"r$ auBS on {B!r} <f"while try!to$ {Q!r}",=L '{#3 _?XCD Z( =>[> *!is  N spec @con!textmanager def _module_to_load(name): is_re0 =  in sys.2!s % ( =B.getI#fif notO^b)# This must be done before open() is called as the 'io' u]G+implicitly imports 'locale' and would otherwise trigger anEnfinite loop.m = type(sys)qputtingH EA6# ( an optimization shortcut.c becomes wrong)0.__ializing__ = True'[8] =W6tryXyieldexcept E6ion+ V8del="oKeyErrornApass2gfinalluqFalse set_package(fxn"""Set _Q__ ontreturne. Afuncis deprecated"1"""@&ools.wrapsu_per(*args, **kw warnings. S('TheUtem now takeJY0f tuautomati_Ay; 'Q '-decorator sl for removalPython 3.12',MDBionW, stacklevel=2m = fxn^if getattr(7, 'q', NoneF 92.00.__%__j>hasrWth__'0e t__.rparti9('.')[0]{m(!erZYroself, G_/ = self  return module  set_loader_wrapper def+C_for a(fxn):<"""Decorator to handle selecting the properHR for h1s. ERThe dFed function is passedEduse instead ofM`name. S2D in<aeither from sys.4As ifMit already exists orSa new8. I@new,@n __"__NPs set first argumentmethod, _i __N4oTaf, andL__package$accordingly (if14.is) ()Mdefined) will btQbefore it&4!to`AdoesMnot worktmo^x` post- ) If an excep0rai"anor creatsubsequently removZ u,Wassumes tha@1tak"e " aesecondi1"""warnings. ('`importtem now dBcareis automatically; 'MT'thisM!sl'w al in Python 3.12',IpDeprecaW, stacklevel=2)4@LPools.4s9Y(self, full:, *args, **kw ]bwith _?1_to(9C) as20.H=!:try60 3Bx H1 (IError, Attributeec G?lse&f J=\ c.egH p.rparti('.')[0][#@was Pabove3__( do)r.O3fxn,*B/%q class _LazyMr(types. bType):M"""A sub2 b 4 which triggersdupon a access.U__get##__#B"""T]!po@mn# All module metada&ta must be garnered from __spec__ in order to avoid # using mutated values. Stop trigger*this method'self.__class__ = types.ModuleTypeQGet the original namemake sure no object substitution occurrein sys.mi]_]#= .0Figvout exactly what attributes were%qbetween@creaO!of and now,V|s_then loader_s['__dict__']]<6now;$ "1updE= {}for key,O.items():- # Code t s3 may have kept a referenc&thKassignedP, makPidentity more importan#an equality>M ifF notP *2s_ur[key] = elif id(/1now+F) !=ag" b.exec_((!)X# If ) was used dire th is0guarante"e TNOD pu7/to9%if< b 6,[]\praise VsError(f"$ {GU!r} "E"9 ed%1 duoa lazyN"USp after !siRhat'sBwould happenEager#=!tuJY.. dreturn getN,!) mdef __del(__!B"""T perform@dele6.""D# To*&@@xcep9" i%O# doesn'=ist5!__1 a LazyLa("):A"""A!Ces aH which ds*Quntilcq access@"ic+pcheck_e_"2er("!if0has! 5, 'le'):  &raise TypeError('loader must define exec_module()') :@classmethoddef factory(cls, J!):3 """Construct a callable which returns the eagerA made lazy."""Mcls.__check_/_p())X lambda *args, **kw S: cls3()__init__(self*# =Rhdcreatem,g, specF.H.60S5", Sq"""Make{u*ilw0.__#__0 = [{-/__( # Don't need to worry abouep-copying as tr to set an attributew@# on object would have triggerf!he,6ue.g. `` cNone``PK! aGW fromKcaccesst8,state = {}['__dict__'] =N. (T: ;o_T4M = _LazyM- """Get useful information/ live Python ts. Thi/ encapsulateinterface provided by1nal/Eial s (co_*, im tbetc.) in a friendlier fashion. It alsofs some help for examinsource code and  layout. Here are@!of@func sf:"isa(), isa } Mgenerator%is.tracebackRframe  builtin()1isroutine() - a typesqgetmembers&Cget 7 of that satisfy a given condi# PgetfiR, getz gFfind]'0docgetcomment@docuM= - determ( aQ came@2tre<rarrange=eo represent8ir hierarchyargvaluesU&rgvKfunction argum4ents getfullargspec() - same, with support for Python 3 feature@formatargvaluesA an argument ]pouterfram/,6inn - info about ,?qcurrentlget the b stack21(), trace3 ^1 onH0 or in a5Rback M@ignaH4a Sb objec,rallable;get_annotation(safely compute0C7's + """ # This module isf','Yury Selivanov ') im'5abc $st 4dis acollec.-Denum#Klib.machineryutertoolOlinecache"or%syutokeniz<Etype*uwarningIfunc{builtins from operat6 ttrgetter  namedtuple, OrderedDictCreate constants*iler flag Include/code.h # We try toEQthem 0disavoid duplic mod_dict = globals() @k, vfdis.COMPILER_FLAG_NAMES.items():7F["CO_" + v] = kDSee P.h TPJS_IS_ABSTRACT = 1 << 20 def 3tobj, *,=None, locals eval_str=FalseC"""CcE[ #an.obj may be a c, class,m.@PassU3H of any other \ raises TypeErrorkReturns a. 5) r#1new'@ eve1imeAit's1ed;ut twice3ameS willXA twoEPdiffe_ but equival'Mion handles sal detailByou:Nt * If btrue, 5,"1strmbe un-stringized uiIB().  etended93use@,!(""@__fu$__-"")doesn't hav.,_lQemptyP. (FV and methods alwaysX; `;3es,!s,GrEs of?callables may qnot.) "* Ignores inherited annotations on classes. If a> doesn't have its ownAdict, returns an empty .F* All acceh to object member6d1 values are done@ using getattr() an1.get() for safetysways, al freshly-creaseval_str controls whether or notof type +replacedEwith the result of call` ()|SthoseO!: 80 *$is true, Q() isH ed@1!If3Epfalse (default),z unchanged.bglobal1loc @re p9@d inQ; seerdocumeni&more inform!eiir3or q!isENone, this funcS may |C tha aext-specificG,`ingentPZ(obj)0objxa module, Gs`obj.__G)__>j=Bsys.e"s[Q5__]]8to namespace_allab 5__,palthough ifvwrapped(5ools.update_1pr()) itDfirst und1"""Cif isinstance,!):>#1obj% ==dobj, '0', Q. 5f1hastJw, 'get'txPann =97'__h-__j8 2anns.GetSetDescriptorTypet@xFelse %&! =p77#if_: 57 = %2 T O P 8;! =tP(varsM)*elE,1s.M # =?! <h' obj_locals = None hunwrapelif callable(obj):.# this includes types.Function,tBuiltinXType,C5%aMethod# fHools.partial,singledispatchPa"class+like" from Lib/test_inspect... on andit goes.ann = getattr, '__annotaQs__',@)4obj_globals<82loc71objgFelse`raise 2Error(f"{obj!r} is not a module, E, orA.") T0if !is^eturn {}'Sisinstance(ann, dict[Value.?either aGA nors?ann eval_str("o5while Trueaif has ?/gped__'/(2 = 5.__/v$vcontinu7if lF{MtUbreak+$"_;__"{ .0G  '= L3if " 4 jr _vv = {key!if'hp, str) m Z(,for key, ) iXn.items() } o # -'e-checking de3eA"""R true if thee0ect(.:M5 s provide40se fibutesN`__cach  pathname to byte compiled filr__doc__4 documenb __<.d@(mis bq3-inXs)"""dobjectL#) J4I5HChG #ofRwhich was defined"""# return isinstance(object, type) def ismethod!):;B"""R>true if the ?t is an U @!. 9Ik3s provideGse attributesop__doc__ documentation stringcf__name. with which thiswas defined@7funnhcontaining imple#ofXLFself/tois bound"""B 1s.MTdescriptor ApBut not) or isclass( -p() are "BTwis new in Python 2.2, and, for exaR,G; of int.__add__.#An:P passtest has a __get__K# bsJk,!beyond that@ set&s varies. d!isJusually sensible @oftel s>ged viausAalso@ oneiAtherusfalse from0() 10, sy becauseJX#mise more -- you can, e.g., count on havG __ y(etc) whenB&es_$).iuQ,WHxl/# mutual exclusionSF.Atp =G'0hasc(tp, "V ")  Y"<GdataD >;:Dat(Ahave}PdeletMB. E]sproperties (`getsetd member,"C)PTypic,qs will ;5and"O(#, SKCboth 9)vot guaranteedp" kn ifB(Qs, 'MDType'): #, CPython and equivalent def ismemberdescriptor(object):$("""Return true if the 'b is a D E%. >M`s are specializeddefined in extensionLmodules."""risinstance, types.DType) else# Other implementations`"False if hasattr(!, 'GetSet#'#BfgetsetABD B B\B"B@func* ,Tuser-EFT]s provideq0se bibutes[p__doc__ Edocuq stringf__name. with which this @ was$B7codB containing compiledM@byte-Jdefaultstuple of anyw values for argcglobalA  PspaceDCannop__ dictparameter (kw6keyword only Csk1  ~P_has_N_flag(f, qR``f``(S method orools.partialwrapper a)ion) whose 0has given ``!``J0set1itsQwhile#(ff = f.__!__G&0_un_(f) if not isfunction(f): return False bool(f.__code__.co_flags & ) def isgeneratorfu^3obj`B"""R_true if the object is a user-defined K L!. GdEs provideYsame attributes as0!s.ISee help(isc) for a list of@A."""6B_has(obj, CO_GENERATORcoroutined,>CWds are ?with "async" syntaxCOROUTINEO?gen!!n >hronousA&  and have "yield" expressions in%ir body_ASYNC0gen?ect oisinstancea, types./ETypeB3l_isfJ__iter__Yto support !a over container8Pclose @raisU new Exit excepL3insH? to terminat6=!gi=$ frp& or possibly None oncm5hasMDbeen exhausted'gi_running*0setf1 whenZ@execg, 0 otherwi<@nextitem from3Dsend<qresumes."+s" a valuat becomeSlcurrent -Pthrow@usedA aO/4 | ww9 awaitabl+turn true if> object can be passed to an ``await`` expression.""" return (isinstance(oK , types.CoroutineType) or7;7Generator79and8<Cboolm.gi_code.co_flags & CO_ITERABLE_COROUTINEcollections.abc.Aable)) def istraceback!):B"""Rtrue if the[Uis a 9!. 2TI&s provide:se attributesbtb_frame  at this levelc#tb_lasti index of epempted !ru in byteW HPinenoE current line number8Python source BCnext@! Vinner  (called by)zB[B-5Fu f_/houter ^! (1's %r)f_builtinsJ-in namespace see2H>: being execu Acglobal~ }l % f_m Vf_loc =82fun57for9, or NoneV 4 4Codco_argcounu of arguments (not includP*, **ss& or keyword only1P!co 90streof raw compi <dellvarp tuple( cell vari=Fonst;=cau in%0ilek pof file"Rwhich* was createO8rstkQ#rs?in yG bitmap: 1=optimized | 2=newlocals | 4=*arg | 8=* / | 16=nestI32=generator | 64=nofree | 128=coroutineS 256=iterable_5 | 512=async_gK0co_kEvarstuple of names #P vari\s=posonlyargcount number5positional # argument@ kw?@{keyword= (not including **Y)elnotab encoded mapp4sof linels to byte%y indiceN  with which this >object was definedIg< jther than- and funcK o Tstacksize8virtual mach! space requir:var f 1"""return isinstance(C, types.CodeType) def isbuiltin'!):FB"""RItrue if the Ja is a 76-inKor method. DBY"s{$s provideYse attributesGp__doc__ 1docaastringj __?.Porigi+>TAFselfA@abound, or None}3inF~ pny kind.(CTor isF" descriptor*rabstracts$n 9 base class (ABC)1if 'BFals#if.__flags__ & TPFLAGS_IS_ABSTRACTD5TruC}1sub(s, abc.ABCMeta 0has;T, '__~Gs__'D# It looks like f.__new__ has finished running;# should have been accurate.9 Enot finished rPunning yet; we're # probably in __init_subclass__. We'll look for abstractmethods manually.Nfor name, valueS object.__dict__.items():0if getattr(5, "__isai__", False:>return Tru:bas{6s__t&}%| zs{+()x% =,UNone)+B A deGmembers(predicate=B"""R7Call 3r of an 9P as (!) pairs sorted by.Optionally, only Xthat satisfy a given A."""GQif isvqcmro = @,) +w3mrojBelse.3results = []mprocessed = set('%9dirZ# :dd any DynamicCAttributes to the listGH$ifMQis a ;~# this ma,Adupl entries if,sexample, a virtualF4Q withAsameaq existsE6try40.__ <^*@k, v*!/instance(v, types.R;X.append(kuexcept VError2paseG## First try1getJ0vialj . Some descriptors don'tI# like calljtheir __get__ (see bug #1785), so fxback toF0ookA!in;# z2key'%# handleYs5key]'Bif k-*1![raisezF @=E>mroa'd)N +B[key#Ubreak @# could be a (currently) missCslotD , !gOIr__; discarRd move on/ccontinfif not9lF: 7results.append((key, value)) processed.add#results.sort=lambda pair:4[0]+Sturn 2 Attribute = namedtuple('@', ' kind defining_class object') def 2ify_attrs(cls):Q"""Re~list of "}-descriptor 1s. 4For eachq in dirSw, the rPcontains a 4-EB@with,se elements:\Tb0. The^(a string)}!1! this is, oneStheseAs@' method'created via9("w'static<;<propertysQ<tQ6 any other flavor%F or tiW'dataHs not a2h'Rwhichl"edj+# (03> a ed by calling getFB; ifT@failre!7UAdoes@livePwhere' mro (includingPAmeta%0es)n@ is looked upRj('sMdict (foun@walk4mro'If` items]Bv`stored< it will nowxbe discove/1and `have N0be  ed|KXPaed. Anywhose home@ can' wre skipped.2"""Aw=1mros Atypev) # for/s  IWC?!clQhi$@in (n,_bases = H@,) +6h5all++.Aamro&?P# :dd DynamicCAs toqE;;3mayduplicate entries if,example, a virtualF\ sC sam\ar exists6mroG@k, v!0.__1__.(cuisinstance(v, /s. ) `v.fgety}V5.append(k(Q = [] = set()?"Q# Getobject assoc!iated with the name, and where it was defined. # Normal objects will be looked upTboth getattrWdirectly inM its class' dict (in case;fails [bug #1785]qalso tovOfor a docstring)For DynamicCrAttributes onsecond pass we onlya! i hsd"Getting an*Q fromd ____ sometimes reveals more tha  usEH. StaticQ methods are dramexampleshomecls = None|get_obj!if(@ notprocessed:Q&:try;D== '''+raise Exception("0 is special, don'!ntXyproxy")MEQ(cls, -epw~ as exc gNelse'ry@, "_uS__", + $ifs5^basess3A# ifQresulQ doesGAlive E# mro, dropRsearc3mro manually? ^_last_x# first4/eswAsrchXP_4i1.,:=1if 1D is0</cl#pn check a metamro=ccls.__+/__V?bx_Error3vcontinuvI5if i;=87?all"0in *.p *[]t(F not in metaomro: homecls = base#Ubreak4if 0zis NoneU*# unable to locate the attribute anywhere, most likely du2f# buggy custom __dir__; discard and move on8vcontinuobj = get_ &if Qs not else dic%P# Classify object or its descriptor.1if isinstance(P, (staticmethod, types.BuiltinMjType))Mkind = "= >"m&=/elcKD D3propertyroutine(objVT{Fdata(result.append(Ap(name, , , )processed.add1rreturn Z_ # -' helpers desmro(cls ""Rrtuple of:es (including 33 inolution order.cls.__mro__)Q funcd punwrap(, *, stop=}X""Get0ped by *70*. qFollows*Pchain:C:`__56__`"s @lastJ &inLc** is an opal callback acceptNQE!r d!asisole argumenFat apR to be terminated early ifMs a true value. IfSnever,K/,,e ed as usual. For example,J::`signature` use isBK if@ pGs haE``__P7__` definedp:exc:`VaError``aised i` cycleencounter;2 ""!if%D{3_isS3r(f@ has}W(f, '' S __wrapped__'() and not stop(f) f = func # remember the originalfor error reporting?%# Memoise by id to tolerate non-hashable objects, bur3 toK`ensure~y aren't destroyed, which would allow)`ir IDswbe reused.Nmemo = {id(f): f} recursion_limit = sys.get(while _is_wrapper(*!):K=9@#._%5d__ 0id_20 = 2uncX;Dif (0in ) or (len(5>= {D ray`ValueE#(' loop when uning {!r}'.format(f)o[]areturn_ # - source code extraction def indentsize(lineB"""Rv$ %, in spaces, at start of a C text."""1exp=.expandtabss+G) - .lstrip()) _findclass 3clsJamoduleR!2.__"__o0if .vis NoneJp@nameCp.__qual__.split('.')[:-1]G\= getattr(cls, 3|"is3clstLu7clssdoc(obj74if LL1bas0objFro__%2if $s  #'>tryQdoc =Cg.__docwexcept Attribut%Ncontinue}<0if jiA05docC4 1gmethodGj =%!._3P__.__0selR Ou_&,D), '|Y') isI!# D g]7els?%1.__J!el$(& S wh$ :objbuiltin U1  + '.' +$ =?():  # classmethod cls = selfUelse:,%1.__J!__!# Should be teste fore isdatadescriptor().2elif isinstance(obj, property)wfunc = obj.fget<pname = 0.__Q_find(')<0if " is None or getattr(cls, M) is noty\areturn:QS@obj)[ SmQ__obj/if)kmember(@slot '1'__A__',a4\*, dict) andeA in  n>f[$]m%for baseXcls.__mro__^6try g do]<g.__docmexcept AttributeErrorMcontinue^0if aJ 11doc3(A de0doc3ect"""Get the\umentation string  anQect. YAll tabs are expanded to spaces. To clean upWL`s that5FPindenpto line,with blocks of code, any white_Ern can buniformly removed frombsecond^ponwards(A.""" b  n  m)q]w(*R, Typ5,x@doc,9 5Bdoc)D D"""CB3doc= t YjBdoc.().split('\n'gg0Uniu ~ # Find minimum !ofnon-blanks after first`margin:ys.maxsizRs[1:]4ent = len(% .l2p()%jontentADC) - Z  margin = min( , indent) !# Removeeation.if lines:4R[0] =[0].lstrip(Y$if< sys.maxsizeJfor i in range(1, len(`3)):^ii2i][%:]any trailing or lead RblankLRwhile and notJ[-1]8.po?0>0return '\n'.joi def getfile(object) """Work out which sourcecompiled 7B an : was defined in."""5if ismodudiCattrP, '__Y__', None.t.,jaise TypeError('{!r} is a built-in '.formaty)/Tclass\lif hasN;__'" =Ds.gep2.__""__zb!62##if{0 ==qvmain__'0rO#OSMAcodeavailable'3 anmethod& =afunc__U<<traceback=tb_framey9 f_v761.conp b!, W", >$, ,!, ,''`expected, got {}?5typK0.__E__))kS(path4B"""R3the % qa givenp`f(P= os.RP.base`q# CheckM$s that loo kedactual|;suffixes = [(-/3), 'B  o importlib.machinery.all_"Bes()`.sort() # try longestpes first\ case they overlap}dneglen]1if =.endswith($+1[:nY] return No"ne def getsourcefile(object): """Return the name that can be used to locate an B2's V.JGNone if no wayDidentifiJ1geto?1"""G=8all_bytecode_suffixes = importlib.machinery.DEBUG_BYTECODE_SUFFIXES[:] K+LOPTIMIZEDPpif any(D.endswith(s) for s in u> = (os.path.splitext[a)[0] +4WSOURC10])</el+clEXTENSIONgrbN4if fexistso59s# only aa non-B6ent!if^ module has a PEP 302 loaderMm h j,K(iBRattr((R, '__JP__', ) is not  x1getRZ"__spec__"X2, "kip# or it1ilinecachea.%W0abs@9_=Adan absolute Wx compiled7p!. The ideaWCeachOhave a unique origin, so this routinnormalizes/result as muchpossible.5if S)8getEcase0abs-(aB)) 00sbyOa = {} `sbymod0,2 was defined U!orxt found,"isCuH ifd@>__'<Bsys.Ss.getd2.__"__Q# Try(2to $BF and0'?| .[cp again 8/ 6tryxtabsfile(object, _filename) except (TypeError, FileNotFound!):+/return None0if P in modulesby 2Csys."S.get( .[3]# Update the\3 to`  cache and check yet againw# Copy sPorderIcope with changes while iteratingE0forso, u"nU.copy().items(%aif ism)shasattrA, '_7__'=f3f =s.#v2 ==`sbymodY , X< # Have already mapped thiss, so skip itv>rcontinu[Y] = fB`getabsH# AlwaysT knows itself byc# [f  .ros.path.real 6(f)60.__~!__7x*8C%maFn=r@['__A__']#tif not YaobjectYY8T", >< 0 = >ain5W7if 7#is_%)9"# builtins  s }# ;3if %= , class C[zTion(E sEpass1_2 inder(ast.NodeVisitor): def __init__(`, qualS.stack = [A0% =;\vo_FunctionDefeOnodea.V0nd(!.n%'' generic_L !GOpop(zCg_Async2 =  +1if d= '.'.joinJJ)2# Rmdecorator Oif presen2de.7tor_list:  line_number = node.decorator_list[0].%8no 9Yelse:) N9no + # decrement by one since -s starts with indexing(:zer/oI-= 1e raise ClassFoundException(7)3self.generic_visit( !stack.pop() def findsource(object)"""Return the entire ) file and rfor an N.:The argu3may be a module, c, method, func, traceback, frame,tor codeb ^Ais red as a q of allsLieD1ne /!atQ. An OSErrorM!s Ad ifh`cannotretrieved.""" R= get3[l# Invalidate cacheuqneeded.3a.check (]  Lq# AllowPnames@formZ@"" to pass through # `doctest` monkeypatches `vFeenables# inspegso let:@.getG s`<b(ll0if .Q('<')R.ends3>')"('ZPavail"')V X,H#if {h! =R,1.__dict__I D 3, Qcould;4getkYif is8Bs, 021@qualb$ =$__%__}= ''.joisDtree = ast.parse(1!_> _CF$r(p.6try!`?.ss2eN = e.args[0]$ J2& 4H&('{p definit O<H<= object = object.tb_frame if is(!):9Wf_cod76if not hasattr , 'co_firstlineno'hlraise OSError('couldHfind function defini %')Flnum hE - 1) pa re.compile(r'^(\s*def\s)| async\s+.*(? 0E:try0 =  s[8]except IndexB 4Jno is out of boundsXif pat.match(3 $YbreakjRbreturn,7 8') def getcomments2b"""Geta& immediately preceding anYs source n!. Rs None when$an't be f3.-1""" 1s0 = f2(a, Typed:dmoduleN# Look for a  block at the top  Bfilei@star0#ifP2and [0][:2] == '#!': 5<Q< len=6s) E].strip() in ('', '#)# =f+#ifc 3[:1'#[s = [O$ndq2Oend rOend]pBtr.append[7.expandtabs()5u = ''.join(b)) $ofssame indenta: el (# =1Csize]= c!ifG>= 0lN#\x<)y.x  Oinesr ;nA OMPs[:0]]  `end = B- 1  !if< 0: break&comment = lines[end].expandtabs().lstrip()?cwhile =Us and C[0].3 == '#':;9[:1] = []"] /-1^?-1:_return ''.join() class EndOfBlock(Exception): pass#bFinder"""Provide a tokeneater() method to detect theof a code blA."""def __init__(self)c8.w00slambda = False`starte5;qcorator!#dehasargs&0lashbody_col0 = None G*r, type,^, srowcol, e ,pif not ;.bN# skip any s"if:"@"?!vaf = Tru$# look forfirst "def", "b" or "8%elJin (6,468%=='*U %_E_E8d!to!of l(j"ifii)i&  0ypee ize.NEWLINEQeI # stopping when a D is seenc*[0v:8ns alwaysay q=Wraisex !`# hitti without  AAends]. !n *> ~ & E-enize.INDENT7: if self.body_col0 is None andzstarted8C 9= erowcol[1]d(indent =T>+ 1*passline = True! elif type == tokenize.DEDENTq-q# the end of matching 1/deQpairs$ua block# (note that this only works for "def"/"class"A+s,C not e.g.2if: else:" Atry: finally:C)CZ <= 0raise EndOfBZMCOMM[i 04# >-# Include comments ifed at least as muchl/3= s0$'A== 0VEin ([,m:NL)# any other&1 onSCsameation levelFprevious#well, excepVe pseudo-#s 9NL.F  def get4(Zs"""Extracd! @code{0top given listIA."""~<fXAr = _F()generate_S(iter.__next__I@W*2 inxs.S eaR*6J^(1, ISError)uPreturXnes[:j{$] pasource's(objectNB"""RDaN- .vq number2an N!. The argu= may be a module, w, method, func , eback, frame1or b ^2is &s !correspond!toU.indicates wher:2@orig 0filnqe first2 watund. An OS" id`O80can beerieved= unwrap, lnum =dV%&spb A.tb_#ofEs tor]$ll4lines if (ismodule(object) or v(isframBand (.f_code.co_name == "")):Dreturn lines, 0Melse"getblock(+[lnum:]),  + 1 def getsourcHB"""Rithe text of . t for an The argument may be a , class, method, function, traceback, #,M"ori$ ^2is  ed as a single string. AnIOSError 0~aised i`cannotretrieved."""AE==6) ''.join}o) # -/ tree ex#-@walk(R children, parent4cursive helperw1getDN)results = []% es.sort(key=attrgetter('__q__', '_Q__'));(Bc in"esdf.append((c, c.__bases__?)2if BC G.V[c], !cY> ]unique=FalseYqArrange@gives*9 into a hierarchyFnested lists.5@Wher' ars, it containsA derived fromqmwhose entry immediately precedes/}t. Each+>q2-tupleHtRing ax !a #@its bes. IV'0'Iis true, exactly on$e edRucturHe-z. Otherwisel@es ud multiinheritancetheir descendants will;e times"PQ = {}Groot2 6 '#if `+/[_] P2XcY2if w"a breakM/(el_  p A 6}w{ Z droots, children, None) # - argument list extraction As = namedtuple('', 'args, var kw') def get (co): """Get informae about thes accepted by a code object. G Three things are returned: (q ), where=A' isu%of}s. Keyword-onlymEappended. 'Q' and1kw'7As ofl*#"**B]!orA."""if not is<@raise TypeError('{!r}1 *"'.c@)6= co.co_varsn6 argcount)kw kw # K(T![:Q!])B2H%$*"+nf2step = 0srgs += %Uv! =<#ifflags & CO_VARARGS~B8 []I(}! 1_varkwtzKEYWORDx:v ]6 + ?  ASpec " ks defaultspec(func;a value a 4's parameters!A 6Dfour/is,!).aZ, including S{  O sbUan n-I?glast nU=EThis^deprecated, as it does0support annot\As orRwill XVY if eitheruSprese!onmlied callableFor a more structured introspeW API, use in`.signa* ()CteadOAlternatively5pgetfullt0) fsnV with a similar2baserface, but L ;K?<G@D since Python 3.5` `@warn. '("6iprecated since Python 3.0, "  "use inspect.signature() orgetfullarg'O()",IDeprecationWarning, stacklevel=2)4DU, var kw, defaults, kwonly qann = \H Bfunce'ifHEann:7raise ValueError("Func has keyword- parametersG!otsKo ", T API which can support them"return ArgSpec(.s) Full- = namedtuple('''N |') def fQ"""GeTs and vy s of a callable object'sq!. !A 0seven things is -"edu- !).x.'g`a list6the-''varkw' are)@*#&**I[CNoneL}En n-Hglast nUMDO <ps@!di+ary mapping4X fromw$tosP5annDYMrW7to 81Not7differences1 -f"self"(@lwayOAed, hfor bound methodsHwrapper chainsined by __d__ *not* un automatiyL"""F4try # Re: `skip__arg=False`6f# a There _N in behaviour betweenLS:1former a$0s 'G'G.N80, w!asP_SBshowaactual7ingIEcpassed6^ o simulat&is, we "unbind", to trick~ T% ir first(m~ usually)cfollow?"r_[ ~) histor_ ignored __wrapped__ attributes, # so we ensure that remains the case in 3.3+ 6sig = _signature_from_callable(funccjfollow_w@r_ch|o=FalseDskip_bound_arg=tigcls=Sveval_strp)except Eion as ex:# Most of^utimes 'H ' will raise ValueError.?But, it can also-A1, and, maybe somethingFelse. So to be fully backwards compatible,catch allB@poss! ions here{2 re\a Typ('unsupported E0') U2 exwargs = []3varDNoneUkw = sposonly(9.kwqannotatA= {}Opdefaultt('kw"{}if sig.return_Jq is notVempty%2s['9A'] =+Hffor paramp peters.v'6s()abkind =1. ~Ename _0if +_POSITIONAL_ONLYZ)W.Z0nd(J$!#if3W.1,bs += (*,^/elR_KEYWORDo7VARW I <[  M yV.+sb!if#ility with '6.__15__'iesc/a _ FullArgSpec(0 + #, G kw, defaults?, .kwonlyargs, kwdefaults, annotations) ArgInfo = namedtuple('@', 'BA varkeywords locals') def getargvalues(frame):"""Get informu about arguments passed into a particular H!. H!A  of four things is returned: (, 3kw,!).H'8`a listQ5thes,' and 'varkw' are 2.s?*#%**Hs or NoneK/y=@ dic4aryISgiven1"""# =to.f_code)1 ^"f_"( , base_module=i9ttr.#'_,A__', ) == 'typing'8repA).replace(2.'if isinstancevtypes.GenericAliasjsRD'ifA. in ('builtins'.?[p.__qualR!__'~__+'.'+A U relativeto(objectnk/,  _^X-",  ^ jrgspec   ;0=()>J6){}E?={}org=str!dq=lambdaq: '*' + 9 ,kw784lue8@: '=p)wsAtext: ' -> C<=A"""F)5 anL Q fromy0 by @full)3pec3The first seUr % $,   @). nother fivPs^qcorresponding op"l t1funPs tha&e called toK names and va.lues into strings. The last argument is an optional func to format the sequence of?1s. 3Deprecated si$Python 3.5: useA`signature`deand `SNobjects. 2"""dfrom warnq import2("`argspec`dh. Use "x  " directly",,BionWstacklevel=2)3def_argandannotaye(arg):Zresult =.! iF in Cs?C+= ': ' +Ks us[arg])_rreturn C[as = []if defaultvSfirst` = lenAs) - sg`for i,Venumerate2x5 Xi >= V/Zdvalue(I[i -A"7s.append( `if varnot Noney*70( "))a7elsOif kwonlyrfj2'*'?1I V6m1uY-p C8$ +A4[ ; H/kw/kw$kw7P = '(x', '.join(s) + ')'Bif 'l'N0s(>[V]75 Nsy, kw, localsSO=str# =lambda name: '* ; ,kw9:4lue:@: '=tQrepr()sB"""F an(- !4 3"s Led by getargpvU fourNos are f )OnextA corresponding optional forHmatting functions that are called to turn names and values into strings. The ninthFargument i40 opa%allWformat the sequence of ;Qs."""Mdef convert(, locals=,%ZEarg= ",  %):?!re)1argm8) +;(t[!]);specs = [] for i in range(len(args)i2.append(%B[i])U`if var 7$( \/kwZ kwX/kwV$kwT<'(' + ', '.join(@P')' _missing_0(f_N, ss, pos,h7eCreprjm0arg As if@ notsz0 = /m7= 1! =N2s[0CWelif ,2,1"{}#B{}".'(*hFelse1tail = ", 6C[-2:e3delm|B", "ro0 + _$raise TypeError("%s()%i required %s%s: %s" %Cg .R"posi"@pos  "keyword-only"?5dS == 1>ss", s))Rtoo_many7@, kw]HH, defcount, givenbsatleastC5) -4R_>(@[arg 9p##inPplura A!= 1oD0sig$2at s%d" % (,,aZLTrueRafrom % T^UD& 7str|_#ifT!ms @a (8%d E )]? u(VQ% ("sXV"4X3 FbM~Ptakesp! but %d%"Z Dsig,a"*  "was" if given == 1 and not kwonly_`else "were")) def getcallargs(func, /, *positional, **named): """Get the mapping of arguments to values. 0A dict is returned, with keysGvl E ps (including' M of! *%**8 s,Qany),v,respective boundN ffrom ''='lad'."""-@ =/"fu/1pec2) AU, var kw, defaults,`ann = bK f_|0 = !._!__Aarg2b = {} cif ismethod=`self__BNoneO# implicit '(' (or 'cls' for clasY%s)g?31 = z0.__Hv__,) + 3num_pos = len(@ +)  0P@min(VPpos, Ti in range(nb[/g[i]] =1[i]$ifO;;WtupleB[n:]possible_kwk1et( +/-p/kwn kwl!{}})!inPd.items(Qif kw% inh!if'8varraise TypeError("%s() got an unex{ edEwordIa %r" %G(C) * qQkw][k Wcontinue inQ multiple( z8>h_too_manyhP; 5>,]! p><%YPreq =Z4s[:x! -)oEk1arg&eqEiY{)_missing_sreq, True,9~ienumerate[':]DEG\VA = 06k if kwarg not in arg2value:  if kwonlydefaults and kw:+in ;FV[3;] =3 t;elsKmissing += 1/3if x__arguments(f_name,xargs, False,)QWretur  ClosureVars = Hdtuple('', 'nonlocals glob builtins unbound') def getcVvars(func)1"""Get the mappof free variables to!ir current 1s. @R2s a of dictsWc@,H references as seen byP body]Otion. A finalH0set!s that couldbe resolved is also provided.F if ismethod>#0 = 0.__"__!ifg is ;raise TypeError("{!r}a PythonZ>".formatF)dFcode~!__3# N H!re d~0co_a @pby lookpthem up5#__J __@posial index<!if., isc_A= {}<  %$wvar : cell.P_cont %0for,(@zip().,B }i1# Ge* ZW__ or __cs _nO2.__!0"_ns.get("N3", +@s.__"__codule(#3_ns(o$ =EdGw{ : +Bset(As]0ame"("None", "Truk"2# BecauseCpse used$bes instead;keywords,/yF# may still show!asYm. We ignorrmS@EinueY6try"J["ns=except KeyJ I Z^M `2d ! P.add( return Clo sureVars(nonlocal_vars, glob / sbuiltin2unbound_names) # - stack frame extraction Traceb = adtuple('', 'file lineno fun? code_context index') def getmQinfo( #, )A=1):P"""Ge8Pforma about a0or object. ;!A  of five things is returned: the , number ofI%qcurrent), a listmBs U fromIasourceQ, andu3 k0 wi@ tha|1st.I`The opal second argumspecifies[J#to, which are centereTVHA.""">Uif is Bno =B.tb_<! Belse)8*fIif not is= raise TypeError('{!r}5F"'.sQ)U- =&0 or$ifF > 0qstart =no - 1 -*1//2<6try5ps, lnum2ind9except OSD" =v = None9 smax(0, min(a, len()%))K=!s[8:+%]/ 0's( (3no, f_1.coA,"s,4cL9, allowing for1mizO0# F}.w a descriptgrovels co_lnotab E! Y0InfQ', ('6V',) +5p._fieldVQouter+s qrecordsuall higher (calling)sREach ?Mains\ , {w2= [Rwhile(3 = ') + getframeinfo(frame, context) list.append(F)aInfo(*[info)01 = q.f_backMbreturnP def getinner/Es(tbA=1):9"""Get a 6 of records for a tracef"'s] and all lower1s. LCEach@bains a$ object, filenline number, functionI *sA,index within thetqext."""GA= []while tb%g = (tb.tb_@,) +A ? dRtb = gAnextqcurrent(R caller or None if this is not possibletssys._gef 1)8hasattr(sys, "q") else__cstack(RU:b aboved egetout )(Rbelow` excepaAexc_/H)[2]O # - static version0get _sentinel =\(_6mro(klass@ type.__dict__['__mro__']._5#__4O_check_instance(obj, TOQ = {}6trye $ oKribute__\""g~Q Attr(VError\ApassrY.get(u%, 7)) c&+entry in ZKif _shadowed(i(? ))~9 ,>.$;Key !1is_3obj &oxKTypeyQFalse+CTruet '_(  5 = t#__[s:pl else:   if not (type(class_dict) is  s.GetSetDescriptorType and CB.__name__ == "_V?__":2objJ_}entry):qrreturn *"_sentinel def getattr_static(obj, , default=1j"""Retrieve*!ibutes without triggering dynamic lookup via theE d: protocol, __F_ orfD__. ?Note: this function maybe able to r'llFDthat can fetch (likeally createdC)D1andz8fin  \$'tXsD,raise AttrError). It1als<eobjectIinstead of ance members in some cases. See`ocumenon for details.1"""V_result = ! 9@_is_(R9kJ! =C4_zRqhadowed(5oV if (.&is5 orPT+M <dcheck_,Felseb = obj5MLi4!isn2 V "3_r=A), '|1__') lM?setM i2F5/if'E0objtw#)NQs we cUQ metaA too7Vt2mroj_)"Yif _sq(I)o>tryF.[](except KeyQ2pas$if=2 I:fr() # - generator introspe' GEN_CREATED = 'GEN_CREATED' GEN_RUNNING = 'SUSPENDED FCLOS ' def getgeneratorstate(): """Get current %e of a *2-itB!. 3Possible-Rs areL CREATED: Waiting to*rt execution.H/2: CPly be7.ed by the interpreter@ B suspended at a yield express04: E has completedk1"""iSP.gi_running return8frame is Non= >=.f_lasti == -1D1 $olocals%F*@mappo < variablesUtheir\cvaluesE`A dicted, withAkeys T names and L$5bou.Pif nod raise TypeError("{!r}=a Python".formatL)=vFattr!a, "gi_!",)mq/E>elsC{} # - coroutino`rospecs CORO_R'w "(*s object0AC `n awaiJ B3?.crZq&if'9?>DXE4 7@s,G;Iariable name s and values the bouA."""frame = getattr(coroutine, "cr_", None)11if q is not:dbreturn".f_localsMelse(o{} #;P Function Signature Object (PEP 362)(z9 _WrapperDescriptor = type(.__call__) _Method/%8all$_Class)int.__dict__['from_bytes']) _NonUsfinedCallables = (, , 1 s.BuiltinType) def _s_get_user_de!_mAb(cls, b_name)c"""Private helper. Checks if ``cls`` ha' Bibut%EGd ``T!``Ns it onlyJ itaCpdpython f~.k2tryj`w :except AttrVErrorD* ^!ifisinstance(o/, 6# Once '__' will be added to 'C'-level: # s, this c{` won't@necessary7partial(wdd#, , extra_args=() acalculGow 'N%' p look like after applying a 'Sools.3' oe@or a64Von it Yold_paramLbameter86new(OrderedDict(A.items()) Z $ =#.R or (&pkeyword.0or 'ifc3l$ +y Xba = 1bin*Z5, *"6f as exsmsg = 'MA{!r}`incorrarguments'.format(4hpraise VUl`(msg) ~D ex 0ansAa_to_kw)b= Fals_0for!amnam in  7Aarg_P = bauments[param_naSme] except KeyError: EpassJelseif param.kind is _POSITIONAL_ONLY/R# If positional-onlyE@eterDqbound bUtial,@# it effectively disappears from the signature?Anew_as.pop( m_name)+continue  R_KEYWORD9n0 in_keywords3This means that t6, and allP amAA# afft should be |(JFvar- JAremoved). Here's why. ConsiderfollowingM@funcwfoo(a, b, *args, c)/ 3 #@"par (foo, a='spam')" will have|V: "(*Ic)". Because attempt@to c with "(10, 20)" arguments0raiqQ Type, sayingS&"aH receivedKmultiple values.'transform_to_kw^= Tru@# See new defaulta_[ T2] =.replace(IQ=arg_`# was Fwed as au d.dihZ\C?'?if  cassert&=not*b4 =H"=ROsC\3.?endf$elE9n (U, _VATq elif param.kind is _VAR_POSITIONAL: Anew_3as.pop( q.name) , return wrapped_sig.replace,geters=Fvalues()) def 3 nature_bound_method(sig)"""Private helper to transform sig@s for unGfunctions2 ^!s. 2"""s = tuple|..bif notICs or 3[0]W1n (XKEYWORD, _ S_ONLYJpraise VError('invalid'o=r1if i~4_OR~',  # Drop firs# '(p1, p2[, ...])' ->-<O A[1:]FelseSsP3(R# Unless we add a newP typeQneverl6# get here{argumentT%')6# It's a var-posiZ&alTt Dohing. '(*args8 MEM8is_builtin(obj`6est if `obj`a callable that mightsupport AClinic's __text_ protocolW8(is* o"isdescriptor'instance, _NonUserDefinedC,s)9# Can't tD'isiG4!)', as it would# also be Truebregular python classes6@obj c, object4is_1likAduckS of FBTypeA good example$Csuchds are s compiled withC , which have all attributes6a pure P.QBR:Q, but  their code statiyEBo$1 isz-U# All-V obviously!s,g ndRFalse =^P, '____', None>* *pdefault;9getX2_void) # Imaao use 2 ..kwdefaults = getatBtr(obj, '__kwdefaults__', _void) # ... and not None here annotations = getattPQ<!) 9return (isinstance(code, types.CodeType)x1n1name, str&(2 is7or ;, tuple)B D!o, dictEs 3, (1)orC) ) def _signature_get_bound_param(spec):""" Privatlper to get first 1Peter 3q from a:g__textf_ of a builtin method, which should9be in the following format: '($r 1,:1)'.2bAssump+are thatAargument won't havb q value 25]2"""Xpassert .startswith('($'z po!find(',')1if B= -1XpP/)Ic:J!O>c=Z=?A~[2:pos]3 strip_non_python_syntax(U@ D@func. Takes a 9AClinic'sDextended,.RMzo@threDingsy* q@re-rY0red}4adard P , >2dexae "self" (generally 0),3 ifD Q does- aP,last "posiRwal only  haAD-Ds !ifA[$ <\,#-h7=!__ !0inebP[l.en('ascii')!! lz.split('\n')]?tor = iter(lPP).__n_%token_stream = Dize. 3tordelayed_comma = Fals` sk#[B = [0addlext.append+ycurrent.0 OP01.OPERRORTOKENO#ralways   ENCODING) , 1 ita@t = (( "t.type == tokenize.ENCODING for t in token_stream:type, string = t."t.D)0if f == OP@.:','"kip_next_comma$(s% = False$OelseBassert not delayedp CG "n = Trul)current_parameter += 1Tcontinue6=%if`O= '/  c+ last_positional_only is Non TT.= -Dif (2ERRORTOKEN) and (0:$')Gselfq # @*if& !ifj(.OP;)')add(', ')E\ J4'Eclean_signature = ''.join(textU{return +*, K/, v def b_fromstr(cls, obj, s, obound_arg=U """Private helper to parse ent of '__g!_'%:5a Sbased on it.(1""" # Lazy import ast because it's relatively heavy8 Du[C0othhan this func|rcP(f= cls.B_cls$"A = \C"$p_non_python_syntax(s)mprogram = "lfoo" + + ": pass"66tryPmodulUAast.(VZexcept Sy_Error<;isinstance(ma,!.M 7raise Value\ ("{!r} builtin has invalid ".format(obj) Bf = i.body[0]as = []empty = .m=Cect(`\& =_dict = {}?0namRpgetattr,1_',G`#if_6 \ule = sys.modules.get(mo _name, None) 2if :s_dict ="!._!__*Jsys_&Bsys.s.copy() *def parsef(node)nassert isinstance!, ast.arg;.annotation is notQraise ValueError("A6Qs are8currently supported"prreturn t&rg`wrap_v\'(s:try# = eval(s,FDfexcept Nam C T X \-` ",SRunti(if{, (str, int, float, bytes, bool, type(g) NT!Co!t(Tclass RewriteSymbolics(MNodeTransformerv}visit_Attribute(self,)aa = []1n =* Xwhilenc XIa.append(n.attrj. m!if!n4iAa*id~ = ".".join(reversed(a)* <kzurode.ctxOLoad ^ p(_, defaultg=empty~1) =1ame5 am! invalid<".)ifJ and_ P&. =7!).((1o =literal_3n R@if o969 =@EIT elseKrparametersPe, kind=e&, ~# non-keyword-only%dwuargs = Rfsxd%)0 =  tools.zip_longest(args, defa*ults, fillvalue=None) if last_positional_only is not ):)-kind = Parameter.POSITIONAL_ONLY)Oelse3R_KEYWORD9*for i, (name, default) in enumerate(reversed(list(iter)))np=Xif i ==?* Zq# *args Pif f.v.varargV RFVAR_:>z)p(A, empty) !# keyword-argument| bW\ XW%zis kwW,3kw_sb @**kw?   : = if self_p # Possibly strip the bound :#u- We *always*5[first75 if9@ ita module.X_don'tUQskip_@_argaGFals^uassert  _" = getattr(obj, '_A__',/.1_isl1 = 'p)R = is (3QTZand (=:or bf.pop(0] ^, # builtins,  D!F6p =5s[0].replace(]=FBRreturn cls(", p_annota}T=cls. def _signature_from_0(clKunc,IS=TrueN"""Private helper funci0 to ^Da callables2"""!if%is_|raise TypeError("{!r}[a Python r"8 "X".format()s, "__text(_"sV)no:g  9str ?)  = ,; globals=None, loc Peval_str=False): """Private helper: constructs Signature for the given python function.""" Ois_duck_f1 = nf not is( Tif _ss5_isGLlike-1oATruen Belse# If it's0a p)PyS, and F typTF"of;Jtionfraise TypeError('{!r} iu p'.format!) s = getattr, "__text"@_", )2Fif shreturnPfromstr(cls,, s, skip_bound_arg}Parameter = cls._pB_cls&# &"in q_code =k!._!__pos_count0.co&arg_name P&1var&posonlyP6argW@posiUal = d%[:]Xkeyword_] kw \5 ^]g8 + /|`annotaGget_"gl%,  %pdefaultXT4.__$kw6.__"__4if 'ss = len(s 40dt"[]4nondD0 - p @_left5X#I-- 5w/o.R0 intR-[:]  kind = _POSITIONAL_ONLY ifCt" &R_KEYWORD|h0P.get(, _emptyu3.append(2U= ,tE=)q  ED-= 1o... w/ooffset, wenumerate([':]a kind=kinOd, default=s[offset]))?if posonly_left:_a -= 1 q# *args if func_code.co_flags & CO_VARARGSSname = arg_ s[pos_count + keyword_]aannotation? `s.get(K, _emptyparameters.append(P2U= XPkind=_POSITIONAL))K- @for 9 in&# =7Sif kws is not None<'"' =.)W]yKEYWORD_ONLYo# **kwupindex =$L_+Z&% ? @Is ''a pure Python5- don't validate theP#<p list (=correct order and s), it should be OK.Ireturn cls( T&_i'#'m D$___j__=is_duck_ ) def _signature_from_callable(obj, *`follow_wrr_chains=True9 skip_bound_arg2globals=n] ?loc*eval_str=Falsrigcls):ep"""Priv/fhelperPuto get Z 5arbitraryg objects'2"""]G_getBof =_ools.partial("  ? M  skip_bound_arg=%, ( globals=10loc0/rsigcls=/eval_str= !) if not callable(obj): raise TypeError('{!r} is4a6 object'.formatE`isinstanc^, types.Method[p# In this case we w the first parameter ofunderlying# function (usually `self` or `cls`)..sig = _get_signature_of0.__J#__!if-wreturn KBmU(sig)zOelse>2sigR# Waswrapped by a decorator?Vif follow_&r_chainsfobj = un , stop=(lambda f: hasattr(f, "_F_"))?if 4# I}6O2a *" *,might want toB#~M its(/xSee tesx for detailsC!6trybPIobj.>except AttributU;Bpass( s ig';Non6dsig, S` v'unexpected )n / '?GDl^ Kspartial=)._yV&2 V,AYools. JA# UnO(seeC0# Tmeans, thatpneed to_aculate B0as t's a regular3ect, but taking inTPaccoumm0osital argument| `,aQ will'0be +ed<automati{Qy (asPs_)b .1 A9ICpartial(wrapped_sig, partialmethod, (None,))  first_wrapped_param = tuple(Asig.eters.values())[0]L?if O.kind is P]C.VAR_POSITIONAL:E0# F argument of the callableV`*args`, as inK`(lambda 6=)`.1return sigNelse2sig4s5- Nassert (notnH-or*.] A:[0]:4new`?= (HG,) + .replace(=_!) ;if isfunction(obj) or nature_is_Alike#_ # If it's a pure Python 3,Nan object that duck type#:a?: (CPs, for instance),nnEfrom(sigcls,,| skip_bound_arg=Gglobals=P, loc, eval_str= is_builti-! $is,@ools)p = _get l ofA.=5+`sig = G ~#qa classQ meta-%@, le@see ^`t has verloaded ____ definedDgin its`23sigSuser_F_&(/D), 'j'7!if}w j#GNsfactoryfV?new1obj_EOinitF2_G# Now we checkS'obj' wnH&hof i.__dict__Z. &4new # or an own '__init__' method Helif#in obj.__dict__:-8factory_L0 = ] & # If not, we take inheritedj0new or =__', if presentL`new isS_ None>newGlH3 J;if  sig = _get_signature_of(D)d0if 4/is# At this point_know, that `obj`a class, with no user-r# defin2'__B, orE`-levelvcall__' `or bas7mro__[:-1]p# SinceN8tex _'implemen)Ias aoscriptorextracts Q:c from theC docstring{A'objrderived@a builtinFT, itseopay be '/'.ETherefore+go through MRO (excepZe las in4I@hichNect') to find"O firG2{n-emptyU>try ! =4.__-__AttributeError^Npass@/ls!ifP%3' h $ aM return a(nd on i7)str(sigcls,f,8>O# No]was found f:'e # Last optis>Pcheck'Pi#Dect."GEtype k1ypexA[# We have P (notae), but &(# Bif ( #V9obj*anP8O 7)4># R7!of F:<sigcls.from_callable(object) ]else:%raise ValueError(&*"'no signature found for builtin type {!r}'.format1)) Qelif not isinstanc, _NonUserDefinedC&s)R# An with __!__Z# We also check that the 'obj' is{4an |7 of=`_Wrappscriptor or _Method to avoid8infinite recursion (and even potential segfaulE = _O_get_user_d!_m}(UH4, ''1if L;Non6tryI+0sig~t0of(K\*gexceptn as exS msS# Ee msg) from exC if # For classes 0s we skipfirst parameter of%ir#[, __new__, _2__ s1Pkip_bJ_arghreturn)GF(sigo>5sig >2s.BFunctionType?Ra nicer ep messag fp  'Psupported by c  _"""A private marker - used in P4& Sd.""" KCempt<B"""MBV7*uW. QKind(enum.IntEnumPOSITIONAL_ONLY = 0IR_KEYWORD = 1FVAR_"A = 2'J3,B = 4def __str__(selfr._name_3@propertyVA"de;?ionE_PARAM_NAME_MAPPING[Y7] |9= _6.) : :) _Ut z ) 3 9p)p0 7p)! < = { _POSITIONAL_ONLY: 'positional-only', _POS)R_KEYWORD/ or keyword57VAR9: 'variadic f,SJ O'L+' } class Parameter:"""Represents a p in a func signature. 8Has the following public attributes:** name : str;52The!ofGwaqstring./* default : objectF@valurPif specified. IpBxehas nolOf, this is set toA`Pt.empty``annota<,? fo,L)KkindDescribes how argument s are bound tomPossible4': (0BNLY`G6%U(`,HLG;>2"""__slots__ = ('_P', '_* t "')?w=+1NLY/; /5 _:= _. c,?RZ def __init__(self, , >D, *,c!=_6&, B)z6try R.x}PKind(b)*except VCErroWraise1(f' {G0!r}Pnot a&id9.!'i$if3 3elfKin (,amsg = '{}1s c>U have%s' =Amsg.format!.dp5 ,6msg&$ = ' =5e!if)D@ '.a required]got isinstance(H,t ms g = 'name must be a str, not a {}'.format(type(*@).__W__) raise TypeError(msg) "0if 5[0] == '.' and1:].isdigit():2[0# These are implicit arguments generated by comprehensions. In C# order to providfriendlier interface"users, we recastQtheirT as "!N"treat thempositional-only.KSee issue 19611if self._kind != _POSITIONAL_OR_KEYWORD4 ms(l'I`passed'< or keywordI8.{}> ,4msgb.descrip89iHValujSJ 49NLYK[1:]!ot.isidentifier '{!r} isWvalid parameteJix)u! ={Udef __reduce__(&=rreturn ,*4.,h)*{'_default':*, '_annota/}tsetstat!, .~" = []*i-"']>@property?a}FZ!=@ $CF 'I,C !=qreplace2A, *,c=_void, + )7" G@"""Ces a customized copy of+$ P B."""i7; $ 99= 9?!E KHEB|),p7&, = ptr__(self):  kind = self.  formattee_name # Add annotation and default value+"if`_.is not _empty:+ z'{}: {}'.(Ited,372z(&)),\ /T_'{} =S repr)))Jelse5_=8]^0if  == _VAR_POSITIONALp U*' + L,elNKEYWORDK LMgreturnf`def __0!__2)\2'<{} "{}">F_class__._1__,ZOhashZ(v.?F #eqbw, otherdX*TrlXisinstance(9, Paramet_ENotImplemented'S.&an.2`H.._4`7A)  BoundArgusF`"""Res"of `Signature.bind` call. Holds the mapping of aI'!to @funcD's pk"s.["HaD`followFpublic attributes:**]q : dictdUAn ordered mutablt ' Fs toL'%s.N2Doexcontain,y44* s"5 : .P6The object that creaTthis s : tupl0Ti@posiT&al p* kwargC ,@DictAkeyword>2"""v__slots__ = ('U', '__weakref__'(Einit3,ye& =%N#{~@property3uo&Ssignature  @property def args(self):U = []for param_name, @ in :._signature.%eters.items(W["if<P.kindA(_VAR_KEYWORD, [_ONLY<@ebreak 6tryRarg =arguments[-except KeyErrorN # We're done here. Other>\ T# will be mappet'BoundA0.kwj'<FNelse M1== LPOSITIONAL2P0# *w v.extend(arg)%;u# plain ;%``&return tuple{"s)6 U = {}T_started = False9Jnot o} ?in A df = Tru" 'S}*continue!ifv Ks=PEpass"LH{IB# ** `a.updat}!keyword j =2),pply_default6`"""SetU values epmissingd..TFor variable-positional,! (U) the]Uis anGRempty;Z 4s (ZUdict.n5""" 5 m#Hnew_' VP,sts.append((n ame, arguments[name])) except KeyError:(if param.default is not _empty04Zval =7 X%elZ@kindW_VAR_POSITIONAL\ (uQKEYWORDN /{}/se3# This BoundA\ was likely produced byW # Signature.bind_partial().0continueEnew_.append((W, valUself.+ = dict(@!) `def __eq__(5, other) 0if return Tr!if1isinstance(9,CdJNotImple!ed$.sO2 ==&an6:6" setstateO_ "&['%'].j$ =-(']g~wl{g:.y6, 'Y}iCrepreargs = [0forTcRue insUw.items(DsH'{}={!r}'.format(argO'<{} ({})>/B__class__.____, ', '.joinRas)) %qF"""A object  es* the overall of a functionIt stores a P'DeterQ*Beach  acoeR, as well"inion specific to51 it 2has1 ollowing public attributnd methods:I*s : OrderedDictBAn oP mappZo(0s' scorrespondingE 0s (keyword-onlye1 arhBsame|Hz@sted`code.co_var`V"* Qp_annota# :KGThe u: type ofS "ed!I&,no\3its\e, thisl0setN`;`s * I(*args, **kwargs) -> BoundArguments  Creates a mapping from positional and keyword a@5 toCparameters. * bind_partial(*args, **kw )=~6to (simulat'functools.c' behavior.)AA""" __slots__ = ('_return_annota@', '#')7{_cls = P Vb_J% +empty = _ ^def __init__(self,=None, *, =E,Y$__validate__=True):0"""Constructs Signature/the given list ofm@obje;P'w'. Allb`are opi"alYF 'if@ is #OrderedDict(Jelse1i` (>] #top_kindPOSITIONAL_ONLY_((_defaultRFalse2for2 in 1T" ='. v&Ename& v'0if C4 < u,0msg<o b'wrong oG: {}`before'M G(msg.format(q.descriBD (;zraise ValueError(msg.$el>N ! = [in (_), R_KEYWORDGp .W8 . 2T# No f@Fthisd, but thea Iwpreviou>sEO hadJa,T'non-D followsL ' \  'argument' $raise ValueError(msg)6_else:S# There is a default for this parameter.E Skind_=s = True 2if name in\smsg = 'duplicate1C: {!r}'.format(V6 s[P2] =u )T7 = OrderedDict((.L,J)\&s)0aself._$ = types.MappingProxyType_s:return_annotation = o@classmethoddef from_func<`(cls, )"""Constructs Signaturethe given python<J.suPDepred since P+3.5, use `T.callable()`6"""Swarnings. ("inspect.H ()d" " W/",CBionW, stacklevel=24 _sW_builtin(BzY3oobj, *bfollow_wrapped=, globals=None, loc eval_str=False@ objj63(psigcls=4O r_chains=d F  '%, " @property3(M return self ._parameters @property def return_annotation(self):!3! "._ .WIQplace?V, *, |~=_void,lm"""Creates a customized copy of the Signature.fPass 'q' and/or '' arguments?to overrideb@m inA newzi2"""'ifA is :$" =D.values()S Z(a5B typ&)(,* 8= _hash_basisos = tuple~B forJyi'% .kind != _KEYWORD_ONLY42kwo{hc.name:0g =}O6s, ,6 ;no_k L GD)  = frozenset(4c ( !)2eq_w, other=!if  kXU Trueif not isinstance(9,E_ENotImple(%edO 22 ==.Abind,Dargs*tial=False"""Private method. Don't use directly.G = {`Qq = iter.v_ex = (parg_valDMFQwhile q# Let'sqthroughm@posi al! correspondingg#0 :tryy. = next(s%except StopIterK# No more  Ub  ) # No more parameters. That's it. Just need to check that # we have no `kwargs` after this while loop@]break]else:if param.kind == _VAR_POSITIONAL6:#POK, jpempty *P. LePstartcOsingL!;%elname in L1__ONLY;rmsg = '{arg!r} is positional only, ' \M'but was passed as a keyword'@ msg.format(arg=)= raise TypeError(msg) from None;_q_ex = (,l @ KEYWORD or;.defaultQnot _)fine too -$a Nvalue fo#. So, lets ,  with the currenSw5@D# No" , nDe,#?%in*Otial5N@'mis a requirrgument: @s3# Waa}process?tryr = next=except StopIteraWS 'Omany/s' p)Ain (*KEYWORD, _KEYWORD_ONLY): &# Looks like we have no parameter for this positionalNargument#raise TypeError()'too many} cs') from None H"if .kind == _VAR_POSITIONAL W an '*args'-%, let's fill it with_# alluleft and move on toOthe next phase)values = [arg_val]+ .extend(//s)0!s[,.name] = tuple(y>_break R` in kwk7!= vmultiple  {arg!r}'.format Barg=)j Y5`# Now,Aiterate through remainings to process# keywordYz_" =i0in tools.chain(sG_ex, ~KEYWORD# Memoriz atRa '**') %{continuWO g# Name[ don't refer [6.0# Wly arrive here ifo endedHbefore reach-Flast #_" =K >try# =B.popAN Dexcept Key?N("noB. InJ4,)#^it has a defaultS@, or;is F2rlone by'of!Haif (notial and param.kind != _VAR_POSITIONAL and  param.default is _empty):N*raise TypeError('missing a required argument: {arg!r}'. \N format(arg=_name)) from None GNelse1if =*7== &^_ONLY3'# This should never happen in case of a properly builtG# Signature object (but let's have tlcheck hereG`to ensG@corrHbehaviour just)@ @eterpositional only, 'M'was passs a keyword&. vS!s[0] =kF_val1if kwargs_@1notS )m# Process h2'**Rf'-like= '1l 6  3'got an unexpected~XIMqnext(iter(F))))Xreturn self._bound_P_cls(,{s;def bind@/, *$, Ug"""Get a B_AEsB, that maps thw`O`Rand `A` to*@funcD's s@. R5s `F!if9@can 71be .x5""" +, $Otial!60parP%ly+30+@2 *I,kW=True8__reduce__6C{R(type,R(tupl.~ am s.values()),)52{'_\q_annotaP: }tsetstat!, ;.`" =*['_return_annotation'] def __repr__(self):return '<{} {}>'.format'.__class__.__name__, @X/stWsult = []knder_pos_only_separator = False*.kw)6Tru(@for DAm in.eters.values(ted = str(1) 0kin. 0if  == _POSITIONAL_ONLYXH/re -_elif 2]# It's not a posi0al-_ , and the flageq# is set to '' (there w7posPs before.)H re.append('/'#  Vi7VARm  OK, we have an '*args'-like  so&won't needrPa '*'e keyword arguments;`IqKEYWORDFLW P[&=n't#/edD, so add /J> ors list ("foo(arg1, *, arg2)" case; ^*^# This cond  should be triggered once!re -F_ S {ops, hence #2 wa41o '',  DU'({})6', '.join(?)<.rC_annj_empty&2 = ;  J 7+= ' -> {}KJ0 4signature(objfollow_wr d=., globals=None, loc eval_str=aP"""Ge`p object passed callable."""|Sb.from_'le(obj, follow_wrapped=foll?, globals=P, loc, eval_str= ) def _main():e-""" Logic for inspecting an object given at command line """Aimport argparseAlib  5r =,.ArgumentP:7r()'c.add_a (''"help="Theto be analysed. >p"It sups the 'module:qualname' syntax"-d', '--details', action='store_true'Display info about rather than its source code')Lrargs = S..#s( btargetl"s.5E@mod_, has_attrs, 2 = 6O ti3(":2try0Ccobj = %= . _(kFexcept Eion as excVmsg = "Failed toX {} ({}: {})".format[type(exc)._ /__H#CUx print(msg, file=sys.stderr$cexit(2&if @part.split(".H:0 in&tsQ40getVQ(obj,&Gsbuiltin0Zp"Can't r8'?s."1.Up!'T')m+iOrigin+2getSLNule):iCached:$c'__6 if3 isiLoaderTCreprA.__l!Y@*, '__path__'(p2Sub/ search 2 .LJelse j1__,no = find\c  \OEpassILine3no)D*2\n' PH%4if a == "_22__"Q() ""v#io provideUPython interfaco stream handlin8g. The builtin open function is defined in this module. At the top of I/O hierarchy<abstract base class IOBase. It _sK basic interface to a stream. Note, however, tha reino separa between reading and writ #toRs; implement7s are allowed|raise an OSError iy do not support a give;. Exten}3Raw which deals say with of raw bytesFileIO subZ6es fto provide anWOS files. Bufferedb5Eon a@% (j)&s $, V@Writ@ReadbWPair o  atQable, ?both respectively.dRandom3s a]^r(daccessz0. Bh IOaeof in-memory cnotherb, TextX,YAenco "de 3 ofisso text.GPWrapp<>ebRs it,@Kext FHc4 (` `). Finally, StringIO is=2for` ArguFQ nameFDpartAifici,Aonlya?s!() ndo be used as keyword 7. data: DEFAULT_BUFFER_SIZE A containsdefaultC sizeb#'s! edKj., ()eS0!lkM`(as obsed by os.stat) ifK`possibK""" # New _plibraryAform o PEP 3116. __author__ = ("Guido van Rossum , "r "Mike Verdone 3/URCA/se", "TextIOWrapper", "UnsupportedOperation", "SEEK_SET 5CUR END"] im:D _io abc from (DEFAULT_BUFFER_SIZE, BlockingIOError,  `open, _code, FileIO, Bytes 1StrX, BufferedReaderM!gWriter1HWPai_andomAIncrementalNewlineDe r, text_encoding, TextIO ) def __getattr__(name):0if  == "Open6"# bpo-43680: Until Python 3.9, _pyio.% was not a static method andlNvuiltins4wset to Jbecome a boundPLSwhen ?a class variable.e isCx-in func} whereasP42F. In(10@() iwO ,  b6 E5().Avwarning. (('8is deprecated, use instead'X# D5BionWo,cklevel=2)hglobal=xmreturn6raise Attribute # Pretend this excep`as cre /. .__module__ = "io"Sfor seek() yB = 0 rCUR = 1 pEND = 25PDecla ABCs in Ctricky so we do it2# Madescrispdefaultls are inhe!d  the C # version however. IOBase(_io._ , a=abc.ABCMetaQ__doc 3. U2RawLX", L' O=T Y , ^V (Rregister(0) 3k[Ein ( >X0.~ }L HAdel SR trys0_ioort _WindowsConso ! I:pass else: RawpIOBase.register(_WindowsConsoleIO) # Copyright 2007 Google Inc. # Licensed to PSF under a Contributor Agreement. """A fast, lU we! IPv4/IPv6 manipulation library in Python. ThisBs us~create/poke/EeZ@ and 6 addresses networks.* __version__ = '1.0' import functools IPV4LENGTH = 326128 class AoValueError( q):  "b relat4theE."""WqNetmask65WnCWsdef ip_(Take an IP string/intV`returnobject of @corratype. BArgsd3: AS or integer,C%IP EitherA4 orPF  may be supplied;Ss less than 2**32 willHbe consider}b<by defaultRA#v4WRaise;2: i:*P* pasrisn't e0a vW a v64i+6trypiHexcept (-, odvn6Qn<rI ('%r does not appearb6U1' % LC) (,sct=True ?"""%e.% (s$iNr$$! D. Ori has host bits seG  )VOFv-alueError):  `pass &raise ValueError('%r does not appear to be an IPv4 or6 network' %JN  address) def ip_interface(:;c"""Takb string/int and return~object of the corrRtype.BArgsRd3: ASAger,C3IP %. EitheF (`es maysupplied; Ss less than 2**32 willHbnsideredTQby defaultRA{I@GIPv6@?2: i>e ed isn't e"a Ga v6cGNoteb0The(?classes descri?A on a particulareNR@, so y're basically a combination@both( XH7L 1"""&6try)b/except (iP, Netmask)Y^pp<( v4_to_packed """Represerb as 4 2 bytes inT (big-endian) ordern$ rm( h5gerRIiis negativetoo large#!an-4  1to_(4, 'big')WOverflowq G"f$4"/v6%/16Y6U/16/16*Address negaBtive or too large for IPv6") def _split_optional_netmask(address): """HelpeK 2S the - and raise A7 ValueError if needed""" LZe = stre.SQ('/')#aif lenR) > 2=f("Only one '/' permitted in %r" % v`areturnSfind_%a_rangeGesseFind a sequence of sorideduplica CIPv# !. rFArgshes: a listI5 objects=WYield?A tuple containingQfirstqlast IPYit = ite"esS!= Q= next(itpZ&itif ip._ip !7 6+ 1#y _,^&pi?count_righthand_zero_bits(number, )@"""C0> 4'1 onO PS side= ?: an integer.s: maximum *iA to VRTh3 $eTf}B== 0o@min(B, (~P3 & H-1)).bit_length()PsummarizeM~S- aLQwork |R give}9vExample1>>>V(CIPv4('192.0.2.0'),0...Cb130'));F #doctest: +NORMALIZE_WHITESPACE[q0Net$`/25'),4h128/31(30/32')]: C<[MiA @ !AnDatord]U(4|6)N IR(2Typ'IfJz are no_@same versionD=1 is greater than the first.  If the version ofirst address is not 4 or 6. ?1"""@if ((isinstance(>, _BaseADQ) and1=1Klast05)):/raise TypeError('aR : must be IP1es,networks')M1if ;.!!=Bs1"%sp!re\+5sam?Q" % (j |,r)! > DValugreater than"') F== 4cip = IPv4N%/el66666&se#punknownzp_bits =._max_prefixlen6F_int%!ip #._RwhileQ< nxmin(_count_righGad_zero:2, i!),} ()' -{+ 1).bit_length() - 1A ne?ip(h1 - +/yield netr+= 1 <<4 1 == ip._ALL_ONES`break def _collapse_ esEeernal("""Loops throughT%#, Ling concurrentcblocksTExample::ip1('192.0.2.0/26*2*,64+3+<128,4,"92,m3 @[ip1D23e4]) ->>7 [ F4')]This shouldn'called directly; it7viaeC([])FArgs: A list 's4IPv "'sgReturnJ?p depend(on what we werecpassed1# FBmerg+1to_ ! =JQsubnex!{}46V.pop(Rsuper"Dnet."Pexist#= sT.get(*K5if ,gis NonR?[;0] =A C! # Merge consecutive subnets 4del[supernet]"to_merge.append(&)&# Then iterate over resulting networks, skippsubsumedvFlast = None0for< in sortev.values()):)1if @ais notE!# Since they areT,7._address <={ nQis a given..broadcastW>W  ^rcontinu PyieldkQ def collapseo3es(#es+C"""C& a list of IP objects. _vExample[b[IPv4N('192.0.2.0/25'),F91128;_]) ->? xB4')]FArgs4: A"or or IPv6 gReturnT I5the~dH_(4|6)LGaiseKTypeError: If passedmixed version1"""*Rs = ['ip +p# split6esses anZ&{ ipz%P if isinstance(ip, _BaseA;i-pbips[-1]._U!= ipa<r*$ T 2("%I!re ofT same$Q" % (H)'4ips&ip!el._prefixlen =6max 3m :try .except Attribut  E sisz` ifGG| HI#xrQdedupet(ips))# find cp ranges? sequence and summarize them if ips: for first, last in _find_address_range(ips)59 s.extend(summarize7Z1)) ureturn _collaps2es_internal(\ + nets) def get_mixed_type_key(objB"""RXa key suitable sorting betweenVworks and kbesses.A0Net) objects are not Q^by default;bAy'refundamentally differen9'@ exp[2iontOCIPv4|('192.0.2.0') <= C/24'Tdoesn't make any sense. Theresome times however, wyou may wishto have ipsQ2anyway. If need to do this,M`can usis function asO`= argu,?ZDed()%rgobj: either a C or 6.v <appropriatet^1"""-sinstanceUs, _BasedcPobj._n!s)M/elOOoNqNotImple'ed class _IPU:M"""The mo*).__slots__ = (=@Aerty"kexploded(selffthe longhC@vers!of$IPUa stringD_#._n`_shortQB_ip_51comD U '"tr `/rNQse_po--Sname #2S DNS 6W?f, e.g.I:6>>>4.ipp("127.0.0.1").`>"'1'`27.in-si.arpa'%g2001:db8::iP8.b.dS2.ip6 E 9 msg = '%200s has no2specified' % (~>,Zaise Error(msghZ`_check,2m$ifJ < 0"%d (< 0) i t permitted as an IPv%d addwress" raise AddValueError(msg % (a, self._version))D3if $# >%ALL_ONES:%pQ= "%d (>= 2**%d) is not permitted as an IPv%dX)max_prefixlen, <def _check_packed_(/,, expected_len).d = len`P&)!=LKSr (len %d != WKOM]@classmethodnip_int_frome(cls, _"""Turn the dgth into a bitwnetmask gJJArgs\`@: An@^eger,[.EkReturnH=*&""r6d cls._:0 ^ #>>Qs00<J", -Y+j -.^+i0 inUandedbformat?|  <A: IfQinputrmingles zeroes & onestrailing_+= _count_righthandb_bits(  =- (; - @lead# = ? >>1Call_-S(1 < 1q 8 ?[0]def __reduce__(selfzI.__class__, (str+c,) __fmt_re = None @functools.total_orde Jr _BaseA4C(_IP "):9"""A genericL@ThisNcontains the version independTsmethods1are0used by singleO"es9*__slots__ = (??int< "ip0#eq/w, otherr?tryor._ip ==5 Band 3cexcept AttributeErrorNotImple(edl,u p+if! aise TypP('%s "!re!of45sam9_' % (^cP6ip +ip)C/ <RFalsen# Shorth@for \0gerpipsubtrac!. " isp# meantever supportB/> ?add?int"zA(int 2) +2 ?subSrn self.__class__(int(self) - other) def __repr__!:return '%s(%r)' % "Q.__clV.__name__, str)X/stW2._string_from_ip_J._ipOOhashE(hex@get_address_key ._version, 7 .Oduce0$,58ip,s_formatFf, fmt)A"""R~s an IP b as a ;0tedwBing.`Supporpresentation types arecR's': ]s thef (default) 'b': converts to binary andQa zero-paddAX' or 'xH`upper-lower-case hexZ1n':@same-0'b'/Q IPv4G%'x678Fort@,ZalternateXm specifier!#'jTgrouping op0'_'$ s.76"""## leatting1`if not92fmt[-1] == &D(y)uuFrom here on dow=u 'bnXx'[uglobal Sefmt_re,ifw is Non im : V = re.compile('(#?)(_?)([xbnX])'[: $, S _bA= m.'s(# Set some{XsP if>Z= 'n'!if4#B # B$istEipv4|9;elsOx' # HexLN bpadlen =max_prefixlen7 V // 4%if !D3+= 8I - 1<=2 0by&0x;:i%'{T2}0{|!}{ Ting}{f} @functools.total_orde% z _BaseNetwork(_IPAE """A generic IP network object. This)class contains the version independent methods which areEtused byb!s.2"""ddef __repr__(self):!return '%s(%r)' % "1.____.__name__, str())X/stW 6/%dV_address, .prefixlenXRhostsn"""Generate Itor over usable 6T in a gkis like __iter__ except it doesn't .or broadcast 'esdtl=a = int.)YV.0Pfor xcrange(XV + 1,RyieldrQ'(xyBcM=sgetitem7, nHBif n >= 0+! (,raise IndexError('s out of 'x5Y6+ n4Jelse{en += 1U&if <` ;,=y %ltWothergot isinstance(", _BaseN0:NotImplemented#if;1!= T#._ CTypep%s and Qre noe5sam+t ,{)  [ " ...u8000::/33FArgsrP@@: AnY h object of the same typeDR \An iterator<IPv(4|6)Zs which is RminuspKaiseoATypeA: IfIB and;@ arediffering l versions,#if=is not a  GValuY: co^tely contained by5"""!ift2 ==#._ r$ TA("%s!rePDU" % (x l$isinstance(s, _Base4`Qs.subnet_of i2('%`in %s'P,)!== n # Make sure we're an8=W?~ _class__/.C_0?essce.Y)UPs1, sV&s(while s1 !r and s2 != other: 1if .subnet_of(s1)$/yield s2=s1, s2 = s1D9s()&/ele2e1? e2e.se# If we got here, e's a bug somew.sraise AssertionError(' performing exclusion: 'D 's1: %s s2~ ?' %A(s,)mif s1 ==  / ,el`\$XBT* P def compare_networks(selfx`B"""C* two IP objects. K This is only concerned aboutlqison ofuintegerCrepresenta& addresses. mmeans tha`Fhost bits aren'tPsidert all in tmethod. Eyou wantH#to%e S , 'can easily enough do a9'HostA._ip < B '+FArgs]=$&An\[kReturn3ID`IP vers1B and"jtsame, rH|0-1 XRelf <7 eg: IPv4N&('192.0.2.0/25') <1128 n ,6J2001:db8::1000/124P 2?IPv626 40-  ==&4'+==9  4> / >5s+ >69R b Typei are different. "C"" # does this need to raise a ValueError?0 if self._version != other:,cL2TypI('%s and  re not of the same type' % (EI ,x%))+#= below herenetwork_address <`.9return -1O>ON   Hmask/ ?!!0 !def _get_`s_key()HB"""N-only key function.H{R{N object that identifi#' s~D0net0. Te is a suitable "key" argument for sorted({Plist.'()"m 0,)?qsubnetsD , prefixlen_diff=1, new_Z=NoneXThA which joinAmake@currh"In as)!at contains eone IP_.0len!32BPIPv4 JM"5128BmIPv6), yield an iterator with just ourEFArgsSd+: An integer,PamounEeVu lengthE should be increased byBbe set if@g0lso(.&$ : pdesired wmIbe aF larger number (smallerC)0existing  0  ~of IPv(4|6)sR ! Atoo e   E OR I are bothX E a2thanbl C@meanr`| r_max_prefixleGn: yield selfureturn  if new_prefix is not NoneN ' 0\len =+ + =>=?max n' %d1 invalid for netblock %s' % (GK ,&))start = int(.network_address.8end(broadcast*E + 1step = (Xhostmask)'L) >>SwW in range(p, end, \)`curren__class__((,iFlen)uFdef superne,(=1T=e"""TheB containing the ko.tJArgs 3@: AnQeger,Laamount +o #p shoulddecreased by. For example, given aT /24 a of 3, aOwithG1G.'ed RA fAn IPvhobject6 5A: If..-< 0. I.e., you havea negative<v.(I ORIsC are both \3 larger number thanaT(']meansPsmallL'5"""i>= ==g Q'_short*e ValueError('cannot set prefixlen_diff and new_G') ,s= self.,Wlen -< ;P$6L+ -8'ifO;E< 0:raise ValueError("w'curren is %d, khave a of %d' %P(,9)1creturn#_class__(2intQnetwork_address) & (mask) <Qf"{a}d{b} are &oSsame Y"HK (b.] <= a"an;-b.d >A except Attribut Unable to t containm.: f"between 0"R;!, 2"""3is >"a D>.].]p3per")F, $T -YwTIETF Afpwithin xhr IPv6 No range%S7W link_local(self):  %"""Test if the address is reserved for link-local. ; Returns:A boolean, TrueY per RFC 4291W5"""Rrc (self.network_@.is__E and77broadcast9)@propertyEdef is_private) 5(is6 alt7@ s=0iana-ipv4-special-registry or 6yv6s oglobalr'_ublicq86not ?peruPs!unOfied6 5i#2Jas defined in12373 2.5.2{| s: loopbackP$a 4W T Y3}YV7) class _BaseV4:0""" IPv4 objectThe following methods are used by4s in both single IP[ es &__slots__ = ()version = 4# Equivalent to 255.H32 bits of 1's.7_ALL_ONES[2**IPV4LENGTH) - 1_max_prefixles&Eq# Thereonly a handfullvalid v4masks, so we cacheSm allJwhen construc(see _make_netmask( )). _netmask_cache = {} def _explode_shorthand_ip_string(self):,Ireturn strF@classmethod+WDmakey(cls, argL"""Make a (, prefix_len) tuple from the givenCbument.z1Argv can be- an integer (D_ length)B0- aing represent 3 (e.g. "24">?C55.20J5""" if not in cls.Lif isinstance(arg,m%Plen =`o!ifsS(0 <=-"<=Emax_C_Creport_invalid(< z7elsE:try# Check for a ]#inmg< _l Dexcept NUValueErroraor hosdotted-quad# This may raise8 [= IPv4Address.#8int3Kt[arg] =5lenlj<x5ip_~@"""T^$IPHinto?kcomparison~sh3: AL,2IP <RN ?EThe -7 as; :  isn't a  0V }? |?o#('<be empty') octets =split('.'4 if(*o) != 4"Expected 4 >[S%r" %o ^rAint. bytes(mapaparse_W,^w), 'big?exc&%sT(exc,)BNoneKparse_octet(cls, octet_str): """Convert a decimal) into aneeger. 5FArgsCJ[: A string, the number to parseEkReturnH3The~/as|[Raise6ValueError: ifxa isn'tGctlyfrom [0..255]5"""bif not6 r zr("Empty/9permitted")T # Reject non-ASCII digits.#w(x.isascii() anda<'()msg = "Only*%s f in %r8 I%qQWe doj length check second, sinceinvalid character e# is likely&be more informative forKEuser8fif len&Z) > 3= "At most 3 8Handle leading zeros asu glibc's inet_pton(I0See6urity bug bpo-36384 z != '0' Q[0] =L*re -@$to+ (we know0 ar"6galPint =7F, 10'#if*Z> 255  "OQ %d (/)$" 6intgrk@classmethod@def {@ing_C_ip_int(cls, @"""T a 32-bitK@o donotationhd5: AgIP address?b.a ng"6'.'.join(map(str .to_bytes(4, 'big')))ZIreverse_pointer(self? I-S DNS 1F namOIPv4This implementsL describedRFC1035 3.5C 0s =7.split('.')[::-1]-SX"_D) + '.in-b.arpa'@propertyI-max_prefix *)._* @prope rty def version(self):preturn #._$ class IPv4Address(_BaseV4, 1): J"""Represent and manipulate singleL 7bes.""";__slots__ = ('_ip', '__weakref__')(__init__2, aWFArgs1: A string or integer r thz:Additionally, an<can be passed, so5I'192.0.2.1') ==(3221225985).Cor, more gener !dHint(t)v < .[RaiseQValueError: If ipi isn't a validd.Y# EfficiHconstructor fromnif isinstance(u,(check_int_+3)-Dip = 24# C:a packedA_bytesN ?, 4@int._[z, 'big'6Assume input argum to9any object<a/# which convertso a formatte`_str =if '/' in]* rj("UnexpecwAQ%r" %G6essb 6P|h@propep"""The binary7 of this$1 v47to_`O._ip0is_OrvedPest ixew is otherwise IETF A! R9  A boolean, True[within the'd&Network rangew,!._5Uants."_nM @functools.lru_cache( qis_private< =`allocagCfor @ sCBI perDiana-ipv4-special-registry. 5""" return any(self in net for0in ._constants._private_networks)Z@property\@functools.lru_cache()def is_globalv!):u@ not TublicA and+($is{multicast~"""Test if the address is reserved@G useYRMsA boolean, True\O.9See RFC 3171wwdetailsq6f9!unspecified#5iixJas defined in($g5735 3w.==o_loopback$a 4  T2per(7330Ylink_loc=A-A$L 7927Y1ink class IPv4Interface(A"):*Y__init__,\t, mask Qsplitu_prefix(%$esUo.dU).! =N(W|), strict=False?NVxk4len/ )d_->@hostc>5r.,]>S__str{='%s/%d' % ^.-ing_from_ip_in e._ip),T  #eqw, otherc_equalA=.__9$ifF;is NotImplemented *ot': return address_equal Etry: .self.network == other1except AttributeErrorP# An interface with an associated fis NOT the`# same as7'un9. That's why>[ hashCQtakesextra infoo account.1aFalse def __lt__(,)_less = IPv4Ar.8T%if:otImplementedb/N#M" <%orAc$ I and)DWe *do* allowIed-s to be sorted  is considered V ths'll\K(\Q_ip, 2_prefixlen,nO_-2)))^__reduce__ = _IP:VBase.,@propertyr!ipf"C._iprF0R'%s/%s' % !._string_from_ip_intAip),P  , qnetmaskZMl ?hosWm) class]N (_%AV4, "):,P"""Th7representhmanipulates 32-bitY+"..Pps: [exaQs for:}('192.0.2.0/27')] :77'N. , 0.(31+broadcast` 4(326 ,E255.(241B: 271"""1# Cjto use when creatingN objects1_ 8[V__ini{> , }wct=True"""Instantiate a new IPv4 network object. UArgs:address: A string or integer representthe IP [&_)].J '192.0.2.0/24'C55.20( 0.<255$are all functionally qsame in. Similarly,1Z$1/*,32*soequivalent. That is to say, failfoprovide a subnetmask will create an with a "gof /32A If(#@(por>a after/=Iargument)given indotted quad form, iAd as ifcstarts Onon-zero field (e.g. 0 == /8) anZ7hos[ M i W03255Z,?C55.20J5""" if not in cls.Lif isinstance(arg,m%Plen =`o!ifsS(0 <=-"<=Emax_C_Creport_invalid(< z7elsE- ~__<r= IPv6Address._ip_intF FKw[arg] = 5len_retur<28 ipo@"""Td!an !o $s2T3: A,e-N>R AA\7ae\Raise6%ValueError:  isn't a 4 %!? r} ?o#('.<be empty')tparts = split(':#3# A| needs at least 2 colons (3 PEQ_min_E = 39 if(F) < ' msg = "Ak"%db expected2v%r" % (D, '7msgA# If 0hasiIPv4-style suffix, convert it to hexadecimalD`if '.'J[-1]:try60pv4 4.@.pop5_ipN4nexcept~ as exce0"%sU5excN)INone{.append('%x'$(i>> 16) & 0xFFFF)=<5s caMhave more than 894# The extra colon comes from using the "::" notation for a Cle `# lead1or trail zero part.)P_max_ s = cls._HEXTET_COUNT + 1+qif len(-F) > ;:$msg = "At most %d colons permitted in %r" % (E-1, ip_str)Oraise AddressValueError(msg) *# Disregar' endpoints, find '::' with<hin between# This indicates that a run of Ces has been skipped@_index = Nonirange(1,OJ- 1)G ifJs[i]h!if~m!is/r+/# Can't have moreQn oneJ, ,F k @iyP_hi ie number to copy.above/bef #W?_loMbelow/afterJ# If we found at,Nn check if it als2verb* ="Jlo =g`-3 r0rv+-=;?!NL':' onlyN!asd-9%r"jU$ %I # ^: requires ^: /-1?lo *loYTT&:$9::$A?ped"- `+Js_lo#ifI>< 1PExpecaRotherD  (LJelse0# Owise, allo entire av[7vhi. Th%#  could still be empty, but fse_hextet() w# # for that.  if len(parts) != cls._HEXTET_COUNT: - msg = "Exactly %d ? expected without '::' in %r"E raise AddressValueError(]=% (, ip_str))Kbif not?[0]Leading ':' only permit!as?? of( # ^: requires ^: /-1_TrailT&:$9::$`W_hi =("olo = 0qskipped:try`# Now,se the hextets into a 128-bitUeger.Jaip_intbPfor iRrangeJ_hi)z.Ai<<= 16[|bparse_U;[i]P *3ts_  ` -o_lo, 0P`returnY5intvexcept z as exc8 "%v % (exc from None m@classmethodYdef _`Ccls, """Convert an IPv6(@ str9:n3cFArgsIb3: AA,number to2se.4R= IT5a~R 7lA: ifyinput isn'tka N [0..FFFF]&""} # Reject non-ASCII digitsQ_DIGITS.issuperset(- 0("Oj3hexfu %0tet{Dq# We do length check second, sinc(invalid character eG# is likelybe more informative sEuser8J > 46= "At most 4sY )J Lmeans we can Q0int vPs int(hextet_ str, 16) @classmethod def _compress_hextets(cls, !):)>C"""C+es a list of*.d*'strings, replacing the longest continuousqsequenceeb"0" in2xwith "" and addNcempty g5 atHg`beginn'Qor atI0end[6 such that sub5tlyI@callC":".join(% will produce\Ued version ofIs@IPv6{<FArgstNe5: As!s,k D to vPkReturnS J15""" best_doublecolon_start = -1$ulen = 0!@  ;for indexenumerate 0iz == '0'R s6+= !8if (Q01# SRof a <ezeros.,a . )-> ?lenqThis is2t  so farn) =%=len ;N = ?Nelse5lm$X^/if=J > 1q 5== (f+b =Ilen):a# For :2add6aF= le A@y+= [''][:_end] Hf|0$ +r f_from_ip_int Z=NoneTj a 128-bit intege toqadecimal notationwgD: AnI/IP7 A string, the hexadecimal representation of"address. uRaises:ValueError: The 6 is bigger than 128 bits]all onesZ5"""Vif ip_intDJNoneq= int(cls._ip)>!> ALL_ONESFr h('IPv6too large'^hex_str = '%032x' %hextets = ['%!3nt(9[x:x+4], 16) for x in range(0, 32, 4)]M0com#s_Wm)~return ':'.join!"def _explode_shor@d_iping(self)*"""Expand a /Xened *;ArgXH: A z?R B :e Fsinstance,wNetwork =-".n(_b elc[Interface]w>elsd1str)T_fromz 2par, c(_Basehu P%s/%dM(2), prefixlen<1<reverse_poiK t-S DNS 1Q name1This implementsLmethod describedRFC3596 2.54P_char?d[::-1].replace&N, '' . M) + '.ip6.arpa'# @scsplit_scope_id(N 6Helper func0to parse`B5ingJQwith O7 idSee RFC 4007dhdetailQA(,_id) tuple,&ep1 =@str.oi7('%if not sep4*`_id = qO2sp or '%'44 JA Znvali: "%r"' % ip_cstr) return addr, scope_id @property def max_prefixlen(self):MJ)._*OoversioI $ class IPv6Address(_BaseV6, "):o"""Represent and manipulate singleL 7bes.""";__slots__ = ('_ip', '_ _weakref__')5 __init__,U7ess$"""InstantiRa newess object.TWFArgse+: A string or integer r thL> itionally, an<can be passed, so9|'2001:db8::') ==+ \(42540766411282592856903984951653826560oor, more gener eHint( ) /1[RaiseValueError: If isn't a validj # Efficiconstructor from.aif isiC3ce( ,(f[check_int_+3 l-Dip =qLy = None"84# Ca packedcHbyte<N O, 16@int._\ , 'big'6Assume input argum toU3anyaR# which convertso a formatteX`_str =if '/' i* Vr[("UnexpecwAT%r" %b", P=EplitHA3!ipC 7x3strw ip_uper()._6__( *|+ '%' +,ifCelse5Nhashd(L._ip%)I#eqGw, otherfess_equal5/Kiss_equal is NotImplemented: zreturn #"if not address_equal@UFalse7Uself._scope_id == getattr(other, '', None) D@propertyDdef E(T)"""Identifier of a particular zone4the"'sL.j  See RFC 4007 for details#R&sx8A string iy kw if specqd, elsed1"""[Aopacked The binary representation$is.|v6_int_to_`O._ipis_multicast0est"Q@ is Arvedz@G useboolean, True\&a Qs.dh2373 2.@ in ._constants._network4is_.9wise IETF=+/vwithin 1 (r IPv6 Nh range'(1any,xx 7b6sg link_local\ ThA-A:/B perH7291W=Osite*A Note that #+ space has been dYcated byF3879fUse is_privaZ5o t "ins`of unique es as definyG4193x4$ 035175.6]E @functools.lru_cache()C R is allocate d for private networks. Returns:A boolean, True if the address is reserved per;iana-ipv6-special-registry, or;ipv4_mapped and isAZ!inuQ4Q5"""E`w= self.''f not None r!,C.is_RN&@any(r0 inm}0net._constants.C_)@property\def is_global[)r"""Test(isallocatePublict+=U&`!unaOfied 5i Jxas defined inMRFC 2373 2.5.2{_ip == 0loopback$a 4 RT 3} 1LFTIPv4 u) IDIPv6/&-a J#, 9thev mj otherwise 1if .>> 32) != 0xFFFF cAN&FJ{ateredo5 xuple of embedded +? IP^T<H(Hr, client)A)odoesn't Har to be a('start withF2001::/32Z #969O0000(QI64) ,<~  5@property def sixtofour(self): """Return the IPv4 6to4 embedded address. 30sDKT>-> if present or None5theVEl doesn't appear to contain a5"""T1if ._ip >> 112) != 0x2002r@A(P80) & 0xF) classI6Interface(IPv6A"):Idef __init__T,j, mask = ._split__prefix( Bess)XGo.d)S`networb8N(W|), strict=False?N@.net k4len/ @functools.cached_propertyR>1hosc>5.,]>S__str{='%s/%d' % (super().1!),hup#eqow, otherv_equal =>0=.__9$if5;is NotImplementedn:not' b?try.2 ==K>except AttributeErrorPd# An i* with an associaf OT`# same as7'un9. That's why>[ hashCQtakesextra infoo account.1cSlMless 8n:  N_3K@* <5 orAn 5 an83We *do* allowedUsbe sorted L/# 0 isLsidered !0 thq'll\I.,@len,n {)?__reduce__ = _IPVBase.@' def ip(sself): return IPv6Address(self._ip) &@propertydef with_prefixlen0R'%s/%s' % !._string_from_ip_intAip),\ o qnetmaskZMl ?hosWmis_unspecified&qip == 0 and network.D$is_loopbacU_g1gA classN(_BaseV6, "):"""This 7representsgmanipulates 128-bitZ "s.E Attributes: [examples for.('2001:db8::1000/124')].N"_aW:6d =&')8 18::f&broadcast` : __ffff:0R: 12442""" 1# Cto use when creating  objects_=/S{__init__,I , ]wct=True"""Instantiate a newX 0yFArgs1: Afng or integer [2the^)1theJ!IP>/.% _/128'_0000:; :Vare all functionally bsame i&. That is to sayAfailo providy3subR will Ce anT a @ of HDAddi,Jcan be passed, soX[') ==+ -42540766411282592856903984951653826560or, more generT e?')) /6 strict: A% boolean. If true, ensure that we have been passed A6$ network address, eg, 2001:db8::1000/124 and not anH$IP<T on aQ IF%. =uRaises:AValueError: isn't a valid IPv6y.F{NetmaskF0theJH9for>O an] Vstrict was True&;nothsupplied5"""$!, = self._split__prefix( Fess)W*+Qess =^5)h1j,i^Dlen {bmake_nY(+Apacked = int(NS+3if .&.Q3 != 2if f 0rD  ('%s has host bits set' %<NelseR ?BN#~"= RC_maxJ- 1) __iter__/elb. a\lambda: [ R]1defs"""Generate Itor over usable6' iD/ This is like except it doe!return the Subnet-Router anycastgFQbroadT Pfor xdrange(kU+ 1, 7- +Qyield.U_class(xK@propertyis_site_localpTest if2hreserved A-A-3Notn]#F@spacsdeprecated by RFC 3879Use is_priv%Eto t%isV `of unique es as definyG4193R4 c,#2per513 2.5.6]T..K self.broadc.ast_address.is_site_local) class _IPv6Constants: _link)_network = )N('fe80::/10')3`multicr3 f0382tprivatecQs = [ n::1/128'),  ffff:0:0/96E1/64!2001::/23" _2::/4Fdb8::/32J 10!fc7F:]reserved/ 02 848 J5'),8!104! :68! :A:C! :EF!F!!FE 9 cR bA$_c+ =: r"""JSON (JavaScript Object Notation) is a subset of J= syntax (ECMA-262 3rd ediJ`used a=plightwe data interchange format. :mod:`x` exposes an API familiar to users of the dard libraryEmarshal` and Xpickle` modules. Itderived from a version` externally maintained simplex. Encoding basic PythH`hierarchies:>>> import J .dumps(['foo', {'bar': ('baz', None, 1.0, 2)}])<'["foo", {"bar": ["baz", null.A]}]'.jgprint(p "\C\?)U7'\u1234'4"1 \-\){"c": 0, "ba}, sort_keys=Truez!{"/?}$ioxStringIO Tio = (*$(['streamAPI'], io)io.getvalue?9'["2"]' Compact e4son >>> %mydict = {'4': 5, '6': 7} >>> json.dumps([1,2,3,4 ], separators=(',', ':')):',{"4":5,"6":7}]' Pretty printing:: 0jaimportq(( , sort_keys=True, indent=4{L6 5,Q6": 7} Decoding JSON obj = ['foo', {'bar': ['baz', None, 1.0, 2]}]bloads('["foo", {"bar":["baz", null;') == objD M0"\\O \\L4'ax08ar'4 =from io sStringIO)]Tio = `streambAPI"]'+p(io)[0]'/ SpecializKjSect dz def as_complex(dct):0...d if '_ __' in dct%*wreturn J['real'],1['imag']^54dctu Ws('{"A": t"_p": 1, "]b": 2}'aobject_hook=R(1+2j qtdecimalD1.1', parse_float=.e (''e3"en2,eN(objisinstance , )P[obj.T,F.SmMraise TypeError(f'O_ of type {B__class__.__name__} Htf'is not,A serCable:...A2 + 1j, default=u0'[29B1.0]e/Et?er(B.R(iQr''.joinZYJiter]^@ UsQtool  the shell to validate and p-G$ echo '{"G":"obj"}' | python -m$.af3 4T 1.2:3.4P PExpec property  enclosedS8ouble quotes: line 1 column 3 (char 2) """ __version__ = '2.0.9' __all_['$Es +s(' er(', ] __authorBob Ippolito ' from .decoder import JSOND, SError2-en2E E cs _default_3=S.( skipkeys=False,ensure_ascii=Trucheck_circularallow_nanindent=Non>separators) def dump(obj, fp, *,   3 cl  @ g sort_3q **kw):: """Serialize ``obj`` as ay formatted stream to ``fp`` (aA``.write()``-suping file-like object). 0TIf `` `` is true then ``dict`` that are not basic typesH(``str``, ``int Cfloa Bbool``) will be1pedFinstead of raisa ``Type(``f0the&Pings 7ten/1canrcontain non-ASCII characters ifKy appear inQ7Bed iH. Otherwise, all such S@Qescap;0str I referenceDfor r r and a GF`resultaRecursion (or worseO/%itDValu1 tots2out  ng N v5s (``nanT2inf - )Ict complia"oxpecification, }u{1theIJavaScript equivalent2NaNxInfinity- .asnegative integer,qnarray elemo"an$P membGpretty-prJbd withu level. And0@onlyert newlines. ``bhe mosT1actGrepresentJsa ed`` shouldYe(item_",q1)``gtuple. The S```(', @: ')^2f ** B10o\Po get  4you&y `to eliminate whitespace'#``function that shoDuld return a serializable version of obj or raise TypeError. The default simply$s% E If *sort_keys* is true (>: ``False``), then output ofDdictionaries will be Ued by key.m2To use a custom ``JSONEncoder`` subclass (e.g. one that overrides}s3``.()`` method to.ae addi l types), specify it withJ the ``cls`` kwarg; otherwS isd1"""C# cached eif (not skip\0 an!sure_ascii*check_circular allow_nan) lsNRiindentseparator*B8 3p Ekw):7Aiter3= _C_. Q(obj)4Gelse>6f cWls = @XtDcls(K= F, enQ= ,EI _=,k=u", Z= Ob= ##=,e= , **kw)?@# coaccelerate writelines in somsPython, at# a debuggability cosfor chunkHi1fp.k($) def dumpsE, *,=" jTrue, j=m"=| c@\a]C"""SGPobj``.aw formatted ``str`` If ``3 ``62eys1are9Rbasicv(W, ``int`` Cfloa Bbool6``)FakippedFpinsteading a ``  fb value can contain non-ASCIIwcharacteOfy appear9tstrings; ed!``a4. OIcNWsuch S3Rescap; U H>referencex"er e/a GF0resSiq ``Recuw`` (or worse)1 a ``ValueEr6ror`` to serialize out of range ``float`` values (``nan``, ``inf` - B) inLtrict compliancePthe JSON specification, instead#using theFJavaScript equivalent2NaNInfinity-1). D0If 0den is a non-negative integer,unarray elemo1andJobject members will be pretty-prJd with that inu level. AnL0H@only ert newlines. ``None`` isB mosT1actGrepresentJa edseparators`` shouldan ``(item_"V, key1)``gtuple. The default```(', @: ')2f ** B10otherwis\]o get ,4youy!',`to eliminate whitespace'#``A(obj@func.return a#able versio of obj or raise TypeError.5bsimply$s%*sort_keysBctrue (: ``False``)RAoutp!diFarieUPed byTo use a custom ```Encodesubclass (e.g. oneoverrides3``.(Gmethod to.`e addiVal types),Ay it3J@``clukwarg; # isd1"""C# cached eif (not skip\0 an!sure_ascii*check_circular allow_nan) ls Z *B8 3XEkw):7_?_.,Fif c@=Z.VAcls( 2= F, en8= 6 B=,N=X.=?KA= ,= , 8= EY**kw)% =!de DDect_hook=,Vpairs) def detSing(bqbstartsF= b.d7if " ((cs.BOM_UTF32_BE, 3LE)_n'utf-32'X UTF16_BE, codecs.BOM_UTF16_LE)): return 'utf-16'if bstartswith(coB8=t8-sig' Alen(b) >= 4mif not b[0]@# 000--  Q32-beO"&!XX#1- -&,16& P-be' [1] else]Z1 XXsL32-l&&/16&# L l2] or b[3"leSelif vF== 2av p bj1# defaulty8' def load(fp, *, cls=None, object_hookparse_floatS#in econstaQXpairsWC**kw*"""Deserialize ``fp`` (a ``.read()``-supporting file-like containing a JSON document) to a Python3.Y#```` is an optional func  that will be called 2 thresult of anyd literal dedict``). The r-value of vused insteadh th*ONis featur0can6to imple s customrs (e.g.1-RPC class hinj)'-L_rdered lis` . @0 D @)r%``FP&ThJ FV. If{NOR0lsoPined,2) takes priority{To use a ``DRqr`` sub, specify i#thiQcls``kwarg; otherwis> K isk!d..1"""_-Cs(fp,::cls9U*H ,7GZb@llow s: -Infinity, ANaN.1 1raiQ exce if invalidqnumbersCare encount1To u ``Dqr`` subp,0y igXc ``clsGqkwarg; Zw K iskd1"""s&0(s,x|Kp.starts('\ufeff'#' Error("Unexpected UTF-8 BOM (Z0 usutf-8-sig)",OQs, 0)(Belse .if not i( , )BType f'3@must2strHsQ1, '  f'not {s.__class__.__name__}') #s = s.decode(detect_encoding(s), 'surrogatepass') ;if (cls is None and obj>Hhook0n parse_int"Ifloa:kconsta?ylpairs_ Ekw):Nreturn _default_rs7if >q= JSOND5rX,ifw:Ckw['H'] =5 H N +TZ}gT%N HF 7intD:intBG (LQcls(**kw)"""Implementation of """ import re from json scanner try"_#string as c_3 except IaRErrorE%! =C __all__ = ['`7', E '] FLAGS = re.VERBOSE | MULTILINDOTALL NaN = ('nan') PosInfinf') Neg-! F<a(Value bb"""Sub-6of  with the follow00ddial properties:cmsg: The unformatted eD message2doc'3P docu0 be`d(2pos(start index doc where5Rfaile5blineno8 correspon q to pos_4col)ocolumn+,t# Note that this /is used n:def __init__(self, msg,,]@no =.count('\n', 0*A + 1T- =C! -2Zrfind2.errmsg = '%s: iC %d %d (char %d)' % (%0no,%#pof}#.i*.{5msg  poE! =*no4ycreduce{lo!, !, 3doc  _CONSTANT{P'-InfBy': ,0NaN+aN, } STRINGFCHUNK = re.compile(r'(.*?)(["\\\x00-\x1f])', FLAGS) BACKSLASH = { '"': '"', '\\':@, '/ 2/',$b \b%f f n n r r t t', } def _decode_uXXXX(s, pos):Yesc = s[pos + 1:!5]if len(esc) == 4 and esc[1] not in 'xX'Jv try return intFQ, 16)Zexcept ValueError;Apass,msg = "Invalid \\Aape"#raise JSONDOc(msg,  py_scanstring Pend, rct=Truen5_b=, _m=STRINGc.matchB"""Scan theJng s for a. End is'index of characterS@s af Qquote that started4 YAUnescapes all )~- sequenc'1nd 6sKon attempt to : aW.ang. If] ct@Falsen literalLcontrol Ps are@owedR 3R2s a tuple&ds!ng;JfY<JAend N2.""5chunks = [@_app&"= .begin = 1- 1vwhile 17S = _m["ifU,FNone5l"Untermina%i!t"iV.end(Tent, U4or *ggroups-# Conten:ains zero or more usH k(Z6ent3# T or,omTng, ab > ^#a backslash denot8L,anr follow6)="UbreakHelif[!!= i*ctN# %r at" % (,;EHP{0!r}Kw.formatONZ:end3;els 6$EinueQ L2end7EIR ZZd  s, begin) from None 0# If not a unicode escape sequence, must be in the lookup tableH if8 != 'u':f:trychar = _b[esc]0except KeyError<msg = "Invalid \\: {0!r}".format(esc)Yxraise JSONDec(msg, s, end3end += 1HJelse0unidO_uXXXX(K5Kif 0xd800 <=0xdbff and s[end: 2] == '\\`HOuni2J + 11ycy2z:fff-0x10000 + (((-) << 10) | !2 Nc00)|O9= 60chrD9_append( return ''.join(chunks) # Use speedup if availscanstrinC'c_Wor py WHITESPACE = re.compile(r'[ \t\n\r]*', FLAGS)._STR = '%q' defuObject(s_and_end, @ct, !_opo%s_hook, Rpairs 3 memo=V, _w=`.matchs)5 = [kB = [1 = ./# Backwards "atibility!if1 isxyQ = {}'a_get =/.setdefault a slice to prevent Index be!d,followingIcheck will 'a a mor.cific ValueS!ifC ng3emp@next>140# Nlly we expect 3Q= '"'&if<"<fin _ws>BCD= _wn.#s K"# Trivial o~} )R 2Presul 8([ 29#:N#if9 C}y.(el1 t  '!"E4property name encloseddouble quotes"end += 1 while True: key, end = scanstring(s , 8ct). = memo_get(=6key!8# To skip some function call overhead we optimize the fast paths where ! #JSON key separator is ": " or just ":".if s[end:+ 1] != ':'`C= _wf).end(#I*`raise DecodeError("Expecting delimiter", boU+= 1 :try] in _wsE ;.?L + 1except Index OpassQvalue[oT_onceeStopIteraBjas errovqn1rr.) from Nonhpairs_app, nextcharn]L5if ! p KL=m-9%'' n[== '}.Vbreak@l0^,0?','F - 1t!  1nd D "PCproperty name encloseddouble quotes&ndif object_@hook1notresult =0(;2rreturn 1j&x = dict3}<)Cr&qA def Array(s_and_end,b, _w=WHITESPACE.matchsR_STR).jMRs = [   j] # Look-afor trivial empty a i]LM72 = ..wh value, end = scan_once(s3)  except StopIteration as err:%,raise JSONDecodeError("Expecting value", b1rr.) from NoneM_append(!nextcharP[end:E+ 1]"5if %jin _ws1C= _w` + 1).jD?= siIO+= 1zj== ']'zUbreak.(el[!= ',0L',' delimiterTfnd - 1:try"if/]  ;&?a OQIndex" Qpass )breturn52nd classdr(object)F"""Simpl drbPerforms the followatransls)4by default:A*+- +|#| Python|**+= T> | dictT Rarray= T?lisT.0str@VS| str number (int)+in T'real) | floaVTDtrueTTFfalsU9| FT#@null:| It also understands ``NaN``, ``Infinityvand ``-1 asDtheir correspondH!``%``which is outsideb spec.2""" `def __|__(self, *, M`_hook=, parse_l2int.0con0ct=,>nVpairstcS"""``&&pecified, will be called witheresultnof everyobject decoded and its return value will be used in place of the given ``dict``. This can:to provide customI,deserializations (e.g. to support JSON-RPC class hinting). D``object_pairs_hook``, if specifiedAcall!thresult ofNQeveryv Wd decod5an ordered lis: we>MF?of _TsteadVPMW|feature_implementa5rs.?I$ is also defined,UtakesLpriorityparse_float, estringY7of L #bePd. Byatiis equival%toL>(num_str). use another datatype or rK"orTdecimal.D B?_in 5?int &?int> 10) & 0x3ffO"s22c2n* 1 bs1, s2g1S"' + @S.sub(, s) + '"' A = (c"/or) classE r(object"""Extensible' Tr fordata structures.Supports the following rs and types by default::.+- + ||1 |*.+= TEdict? |  T-list, tupleEs| arrayT!5str> |fint, floau| numbekPT4Tru) tTJFalsU9| fT:NonS #llw@To eS d this to recognize otherYbs, subimplement aH3``.$()`` method with anIRthat us a serializableJ``o`` if pos,wise it should callQsuperJ(a;a``Typew3``)2"""6tem_separator = ', ':key:0 __init__(self, *, skipkeys= , ensure =s, check_circular=True, allow_nansort_keys=False, indent=None, separatorsbdefaul%):9"""Constructor for JSONEncoder, with sensible E5s. ApIf skipQ is f then ita TypeError to attempt@ejqing of Ethat are not str, int, float or U. IfC8such itemsJasimply:pedensure_asciitythe outpuguaranteed be~robjects*all incom non-ASCII characters esca Fcan contain X M n lists, dicand custom /edall be V!ed% references durG %toK!prevent an infinite recursion (which would cause)R <%).MOtherwise, no  takes placeH bNaN, I0y, -1 wiwQed ast. This behavior[JSON specificatcompliantbZpconsistjmost JavaScript based!rs!des$itv a ValuyM \n!of6pionarie "Ped by0; tis useful7aregresPtestsPgEqerializE s ompared on a day-to-day,ia6negativeS egnUarrayrelementsP memb pretty-printedElevel. A 0only insert newline!Pact represent" (ed 1 shdba("_*,)Qtuple@(', : ') if ** `` ``H5(',0oXQo geti  A4you$y `!')Wliminate whitesp8i#aa func|#ll s%ecan't .s edtPreturJSON encodable  "version of the object or raise a ``TypeError``. 8F """ self.skipkeys = .!ensure_ascii =  )check_circular =  -allow_nan = #Tsort_ #indent =  if separators is not None:#Uitem_.!, 6keyNACelifxbe = ','Gif defaultF &=0%deA(F, o)"""Implem'this method in a subclass such that it returnsa serializablmfor ``o``,xQcallsdbase itUationJ?(to)pFor exaB , to support arbitrary ite, you couldd{'` like "::3; "6tryP=5(o)#uexcept I6pasn;+lsd list({V# LetD.B nJSONEncoder.FoV_YC(f'Of type {o.____.__name__} J#f' "')esA"""R2 a Btring representTa Python data structure>>> from json.sr],O1#()5 ({"foo": ["bar", "baz"]}'"'w0# T0is extremely s cases and benchmarks.sinstance(o,Nl[8lf.d"6_smG +eD>doesn't Jtor directlyJ''.join() because"# ions arePas detailed. Thev 0 shx be roughlyJaquivaluoPySequence_Fas6at wL&dochunks = self.iterenc ode(o, _one_shot=True) if not isinstance(chunks, (list, tuple)):29$0 = $2Treturn ''.joinBdef iterenciself, WFalsepA"""E- the given object and yield each stringgrepresentation as available. &For example::AAfor in JSONGr().2big>mysocket.writ[)e5"""0if .check_circularwmarkers = {}9Oelse'ENone)bensure_ascii9_Br = R_baseW0Mv= floatstrallow_nan=,jH_=<!._ __, _inf=INFINITY, _neg- 0# C` specials. Note that this type of tes processor#/or platform-Rfic, so do@s which don't depend on N`intern/if o != otext = 'NaN'N!el6!==!9Infinity>PA-B '(o traise ValueError(D@"Outarange 0 v4Qs are compliant: " +Kr;(o)| Eif (eu c_make!is| Qindent( _v+ =_ -,Wdefault, qnkey_separator1=temsort_keysIAskip4P L,?str@J@0) ' __ _floatstr, _key_separator, _item@sort&s, _skipkey one_shot, G+## HACK: hand-optimized bytecode; turn globals into localsCValueError= bPdict=afloat=Wid=idWnt=inisinstance= 0Plist=vstr=stratuple=@_int*int.__repr__1): if _indent is not None and ('q, str):=e = ' ' *N^ de_Pterenq_(lst, _current?g_levelW!if6lstkoyield '[]' reif markers J!pid = id)?RCTid inO C(fraise ("Circular refe detected"d"s[id] = lst0bufX[ [U += 1YsnewlinehT\n' + D, =: + b 9/+="Jelse K! = R(first = Trueor value p1if 6 @v = FalsN%= 7if j h'M2+ _W!r(2 \Delifs/LV'nullik C5C OtrueC +D fOE 7int1# Subclasses of/ may override  but we stillNwant to kq them a-Regers\ JSON. One examplNPithinF  dard library is IntEnum.*,see commabove for4 Q/sty  Y if isinstan ce(value, (list, tuple)): chunks = _iterencode_8E_current_indmlevel)Lelif isinstanOdictz0z/se]yield from *if newline is not NonCU -= 1Nlt'\n' + U/* >95%]'if markers4del%[-Aid] C9def Odct,jot dct&{}areturnt = id(dctCTid in kpraise V%Error("Circular refe detected"ds6 =iP<, +" q/= -item_separator+> !,el )! =0Q -first = True\sort_keysYe-.&()#/mfor key, _b. w /7str&Epass[# JavaScript*weakly typed | these, so it makes sense toIalso allow them. Many r7em to do something like this.N Ofloa# see commentAint/.0_i i0key1vstr(key!&!is  }"v= 'true;-Fa#<f=<Onull;A/in?: key = _intstr(key) elif _skipkeys:'continueNelse+raise TypeError(f'S must be str, int, float, bool or None, 'b{ f'not {key.__class__.__name__}'if first = Falsyield item_separator!_encodec ?keyAif isinstance(value,/)Ll, 1 is\FZ'nullw =?Tru_'true= _{f}??int# see comment forZ/Y in _make_iter* X/GbG_u<(list, tuple)chunks = '_8_current_indZlevel%H3)?dic2z0zb]!Rfrom Cif newlineh CU -= 1Nl`'\n' +o? * >95}Eif markers4del%[-Aid] U8def ?(o,P }ooA9o96 11 12 3o})wy  z|&ncode  yield _floatstr(o)  elif isinstance(o, (list, tuple)):+3Jfrom _iterencode_2;_current_ind_levelm Odictd*d*seif markers is not Non$%xid = id$ITid inU m(raise ValueError("Circular ref9e detected"#<"s[yid] = oo = _default>{0 4delhreturn" """JSON token scanner import re tryM`Sjson Smake_6h as c_ except IKpI '! = __all__ = ['H '] NUMBER_RE = re.compile('(-?(?:0|[1-9]\d*))(\.\d+)?([eE][-+]?!',2(re.VERBOSE |PMULTILINDOTALL)) def pyt(contex parse_object = .t]array'&mstring'(match_numberA.#. z f&.in7int"!co',#W_hookt&_pairs,20memuy  _oDwng, idxdpnextchaV2Q[idx]QGndexaStopIteration(q =,6if mR= '"'(` + 1, &ct: W{W (X)Y0R", >  ,  [ \ an' and  ng:idx + 4] == 'null~a4 Xta Htruea return True, idx + 4 elif nextchar == 'f' and string[idx:4"5]ealse':AHreturn Fc%5 #m = match_number(\*)&if m is not Nonecinteger, frac, expU.groups(F!if&0 or( H res = parse_float(^@ + (`:0'')ijor '')d;els Z%inX ;.res, m.endN3?NaNconstant('))sE + 3vqIq8qInfinityv.{8{-{9{-N Q /}9}  raise StopIteration(idx)def scan_once6try _9kfinall<memo.clear(Ma make]ner = c_Yor py r"""Command-line tool to validate pretty-print JSON Usage:: $ echo '{"json":"obj"}' | python -m .^{3 4}T 1.2:3.4P $Expecting property name enclosed in double quotes: 1 column 3 (2) """ import argF sys from pathlib 4pPath !bmain()prog = ''pdescriph = ('A simple crface forV module FT' objects.'>.ArgumentP! r(=', = Ic.add_aB('infile', nargs='?', Utype= FileType(encoding="utf-8")Bqhelp='a y%bed/eddefault=sys.stdin0outp7 write the output of RtRdefault=None) > parser.add_argument('--sort-keys', action='store_true', default=False, `help='N the output of diVaries alphabetically by key')Vno-ensure-asciiBst='_ qfalse',Xdisable escapingnon-ASCII characters json-lineC30 in? usP`JSON Le format. '%'Use with --no-indent or --compact to produce valid a.xgroup =@@mutu_exclusive_&( iQ4, type=intseparate items1newt and use this number'of spacesG a =tabQconstJr.0='\2O'tab 2?Non |rather than    `uppres}ql white Vion (most e) ops=As() tAdumpA = {m_T#: F.'5%" (.}~%ifp:[x@] = #@ors''',', ':'[infile as r6try 5_ #'0objv($p.loads(*) 3 inmq5OelseO(#),;1out!is"Uut = sys.stdoutDI37b .open('w', encoding='utf-8Pt uti<pfor obj objs:   json.dump(obj, outfile, **w_args) 0 *.write('\n'(except ValueError as e:H raise SystemExit(e) if __name__ == '__main__'=2try (uqBrokenPipv&xc2Qsys.el*xc.errno) """Keywords (from "Grammar/python.gram") This B is automatically generated; please don't muck it up! To update the symbols in tY, 'cd' to "top directory of  source tree and run: `PYTHONPATH=Tools/peg_2or @3 -m pegen.kQgen \A[TnsCLib/P .py Alternatively, you can 'make r-3 '.p __allS ["is", "issoft`kwlist2] A = ['False', 5Non 5Tru 4and#&as Fsert5ync 5waiTbreakEclasBfconting4def(4del 5elie&0fino%or 4rom UglobaZXFimpo$in0idlambdafnonlocJ%noyp>Ureturd4tryEwhiluDwithyield' ] _'&caQmatch3) = frozenset( @).__yains__ G /x 3"""Cache linesa1m P#s.%i`tendedHread:modules ed -- hence if ac is not found,Gwill look down%L search path fpF by that O^u` funct  4sys o t:ize0getx clyTheckcBlazy ] # The R. MapKs$either a thunk which tprovideicode, # tuple (size, mtime,i`, full^0) oZloaded. = {} def "()*`0entirely."""F.<(J( zBno, _ s=lQGet aYqxUL=pit does{ an entry for this file already.""" lines = get (filename, module_globals)/qif 1 <=7!no 1en(:!):"Uareturn% s[qno - 1]!'' defzS=None^"""Get the^ for a Python source Q from(acache.{fUpdate if it doesn't contain an entry]BthisR <!if.A in iC=[)%qif len('f) != 1< (V?2[2]6try0,u2 except MemoryErrorMRclearE#[]Rcheck% rDiscardQies that are out of  (Tjqis not _ed upon each call!) | s #Qlist(r.keys())elB C~FFelsel{9 s/ =g# lazyUy, leaveMAinue0siz tips, full! =y-@if m*, ibK\ # no-op1s loaded via a __5r__[ Nstat = os. (!+OS7pop>&9ont 0if }uA.st_#or4!=  PZv 5aR and gP its ;If something's wrong, print a message, d?3,fAmptyk,2 X2#.8V!ifG5or rtswith('<')*C.end3>')1R<[% = 1bas<Z[w# Realise a 5d lookupPtherer&on0# ow?$to2right now jazycache(filename, module_globals): :try data = cache[filename][0]()=except (ImportError, OS hWJpass@>lse~1if ois Non!L# No luck, the PEP302 loader cannot findisource{D# for this (.'return [] %M = ($i@len(/),[line + '\n'!in%`.splitOs()]A@full x  E[2] =# Try looking throughf@ search path, which is only usefulKwhen handlMa relative u`if os.Vt.isabs(# i[0dirb in syH z ;% =}Sjoin(NQ, bas KAType , Attribut {t sufficiently string-like to do anyth+JV with#GzcontinuBstat ( SUbreak L e- tokenize.openj as fpn = fp.reaK#es ~2if D@and 9[-1].ends(~"1 +=size, mtime = SB.st_. f2@,$, 3~ def lazyJ, b"""See1MFK 9.3The`will be askedGf"ge" iqcalled,cimmediatelyg IfF re.an entry[ alPy, it%salteredC: : True if a2Qregis1 Y7otherwise False. To 5P suchR]oad aAth aCget_method must3Rfound{ar6abl% ,  SAd. """ if filename in cache: qif len([(v]) == 1&-return True>7elsL&BFals'fif notDor (h.startswith('<') and*C.endF>'))c# Try for a __loader__, if availablmodule_globalsq0'__0__'  !v#: = [<]Bif (, :1f.get('')) is NonHif specB7__'6try=Z.%except AttributeErrorPEpass@get_source = getattr6, '!',%) :"( s lines = functools.partial(| , )\ 1 = 1O,+[k"""Locale support c. The  provides low-level access to the C lib' L2APIadds high 6`numbermatting +s well as a lPalias"`enginejcomplement these *PincluFmany commonly usedi]P mapsmmvalues suitl  2set"()ion. It also default encodingsT4all| . """ im4sys B . e*$re#_collections_abc from builtins e tr_D_strA" 3Bhe _3. # # If this fails, fback on a basic 'C'Pemula.cYuck: LC_MESSAGESVnon-standard: can't t=whether it exists before # try. So __all__Wfiddled at` end oe$. 0T= ["g0", preferred|(","A!)reR@conv0str LxfrmK trCatofifformat 0ingcurrencyIn2@lize$LC_CTYPE TOLLAT4TIM MONETARYLLC_NUMERICA0ALL CHAR_MAX"] def C(a,bB""" l(string,string) -> int. Compares two strings according to the locale61""">return (a > b) - < b) def _strxfrm(s):/0"""`hsZRV0s a-hat behaves for cmp_-awars try: {bfrom _ import * except ISError01# L emulationHCHAR_MAX = 127[LC_ALL = 6COLLATE = 30TYP0MESSAGES = 5ONETARY = 4pNUMERICp0TIMK2 = Value Sconv(_7dic&numeric and monetary|specific parameters$MS# 'C'6 default vs$L{'grouping': [127],#''currency_symbol': '''n_sign_posn':$p_cs_precedes&n&Hmon_n_sep_by_spaceqdecimal_point.qegative&%Oposi%@int_}y py thousandszR)frac_digitM X2 Q}X2setA(category,[=Nonek-integer,,}:Activates/queries>processing1k"if not in (, faraise 6$(' only sup.Ss "C"%')'C' # These may orAexisa, so be sure]0setasm. if '4'tglobals% =^6Ocoll66 3 # = With this , you can override some items of=3's .is is useful@testpurposes. _Z {} @functools.wraps(#)i'donv() if _override_localeconv: d.update(')'Nreturn d ### Number formatting APIs # Author: Martin von Loewis # improved by Georg Brandl8Iterate ` groupVintervals def __()Elastq = NoneDfor 65 inc7 E# if is -1, we are dG)&ifJ== CHAR_MAXJ%1{# 0: re-use i ad infinitum, `0Y!ifA!is &t raise ValueError("invalid}Bing"-while TrueMZyieldz^=5` #per<E the from right to left(s, monetary=False6 = (thousands_sep = ([B and 'mon_'j' or ']gI"D?eif not_' 0if s[-1] == ' '+stripped = s.r8p_spaces"Q[len(%Rped):)K7els H!''$]O[^ cs|+in "0123456789"3# only non-digit characters remain (sign, Z: sUbreak%.append(s[-&:]fF5s[:  I=sreverse$)+ R.joinBs) +O,A)n(7P) * (2R) - 1)S0 a given amount of excess padd(~"ng #p_)E0lpo30  s[ Q += 175-rXs*a)a Ma:0'+1] _percent_re = re.compile(r'%(?:\((?P.*?)\))?fb  r'-/modifiers>[-#0-9 +*.hlL]*?)[eEfFgGdiouxXcrs%]') def _format(percent, value, grouping=False, monetary*additional): if formatted = peR % ((h7) +6)IOelse@ >.$ifW[-1] in 'eEfFgGdiu'G_localize(ureturn * # TransA as W e number according to thesettings def l |o# floats and decimal ints need special ac!+0'.'#!seps = 0*@part,.split('.'%%if*K>S[0], Y_R( V_point =:tconv()[/Y'mon_/'Jor 'A]B$ =cR.join!if C_strip_p'(ng}$I  ph q:= s$2+bo A"""F?@s a = ngMsame way that_%swould use,but takes*scurrentW5oQunt. 0G is appliedythird parameter"Qtrue.8Conversion|s6 thousands#aaratorAs ifIWforthfo1""")Sclist(__re.finditer(f)new_f = %sub('%s', f)if isinstance, _colleKs_abc.MapB\yval = [As .  ()G=='%]a.append('% : 6_(t 6 Ymif not"Wtuple|BJ (i?for6S else:  starcount = perc.group('modifiers'). h('*') ; new_val.append(_format(J-),59oval[i].?ing0monetary0*u+1:i+1+%.])i += (1 + '%val = tuple((!) preturn f % val def >@ent,Due, =False, *additional):a"""Deprecated, use\_string instead."""1import warnings . (-"This method will be removed in a future version of Python. mFUse 'locale.6()'BionW,qcklevel=2`match = _qent_re.2entqif not  or len( A))!=G]raise ValueError(("p() must given exactly one %%charK FQ specA, %svalid") % reprrQA;(, 5~currency(val, symbol=TrrinternatA"""Fsp accordrtto the eU settk'in#t cconv = (p# check illegalv"uedigits = 4[ and 'int_frac_*'']V2if !r == 127d #"CE!ma" ipossible us J "*3'C'#."_ize(f'{absB):.{F}f}'1,R# '<'>' are markers ifEsigninserted between@v"V+ s + '>'#if/2?smb "_~10ede~Qval<0d'n_cs_ HpFPsepar) Gsep_by_spaceH ]4if s6+ (n T ')@L0JelseB>if psmb[-1]:' '1Gs= smb[:-1]  s = s + (separated and ' ' or '') + smb -`ign_po4conv[val<003n_sn:p]>= = :qegative0<6osi]}4if ca == 0:U` = '('a + ')'+el212M3-2-*?ign-3-.replace('<',)949>9&se+# the default if nothing specified;o,is should be;most fitt5Qign pro8"Nreturn s6'')'') def str(val)"""Convert float to"ing, taklocale into account."""_format("%.12g", es!de@ize(string}Parses as a nHlized numberr!rdo)OAe se+2s."2 =  "()#First, get rid ofGgroupingt[5['thousands_sep'&Rif ts4 l0ts,wcnext, vs decimal point with a dot$dd'(_(/ddrdd, '.'$, =False, monetary/""Le 3?Catof=q, func=a= )[(iz>B an+/eg?int~c_test(y1set>e(LC_ALL, ""5#doWRs1 = _("%d", 123456789,1; prs1, "is", atoi(s1)#standardMaXB3.14,JfJb ### LPname aliasengine # Author: Marc-Andre Lemburg, mal@l .com # Various tweaks by Fredrik Lundh jstore awaylow-level version+k (it's # overridden below) _%=q_P_encot(code, ): if '.' in code: langname = [:.index('.')]*?els4"# Convert the encoding to a C lib compatiblastringAUnorm_8=C s.Ualize(();#print(')8: %r' % 90  kaliases.Iget(..lower(),yD Ipd* = c "**if? in localf_+z*[~9 ! replace('_', ''"\7-7 n!FfounQureturn xu+ '.' + def _append_modifier($, )%if == 'euro'!if\0notB  ISO8859-15'$$U_, _,&.partition$-&if*Win ('R, 'UTF-8']HG<_:. }@yTylm(1): Q""" R1s a?*d9AA forDgiveS>N.MQThe rQeE isH`matted use withJ2set'()QIaq fails,original 5 iszTunchangedR>VRknown^Afuncrdefaults toYB!)=just like GCdoes1"""`# NormeMa[xtrac=< +>':'C!# s sometimesFd asdelimiter.mt.0(':.@q3split('@', 1 modifier = ''  if '.' in code: langname, encoding =#.split('.')[:2]1?els;1"SI1'' # First lookup: fullv (possibly withand modifier)Cp_enc = >%if6@norm-.replace('-', ''[ 2 7_7i1 +=`)+ 9_2%if0WE@' +'7Kocale_alias.get(:b, None!ifq is notnRretur\#print('f failed')# Second try5out0ang90 !i qsucceed03!@'3 7$>_append_(,8a@', 1)[1].lower() ==::ras Uc# Thir(1*, sJ28&3e!4 1nd?3U %P0 _e J + 'CG# Fourth q0%bI(iW5!<u, defmod 2#if/Hr() == modifoier: return _replace_encoding(code, ) + '@' + defmod M=localename def _parse_( "):;P""" P'bs the ! uC forSR and i+y result as tuple (languageF.r4Tk[is normalizedipassed throughwalias engine. A ValueError is rai@win case@ qEcannot be +d corresponds to RFC 1766. a^XNone v&s determined or areCpunknownsthis implementation1"""1=N!!if@6ode# Deal with modifiers9^,! =.split('@', 1),'if)= 'euro'%@'.' v c# Assume Latin-9@=As. Ts bogus,r?since some systems may use otherKs[FtheslCs. Also, we ignorA.{, 'iso-8859-15'z!.' z8=Qr.')[:2]SAelif\v == 'C'@c ,  0WUTF-84# On macOS "LC_CTYPE=%">sa validr settingX"g 7 handlingU6ext '/'L$('s: %s' %)^buildDB(3s aCAAfrom_given)i1No ~%ormatakes 16try## =2l4if -G!%if8?97elsb *.;except (Typ,)&1('LA mus, a string, n iterable of < C'two9Fs --9A.') lQgetdefaultz(envvars=('LC_ALL', ) 4ANGhUAGE')wATrie$mine the default locale settings and returns them as tuple (language code, encoding). 2PAccor to POSIX, a program which has not called;2set(LC_ALL, "") runs using the portable 'C'.B@Call)Jlets it useK8def adefined by)LANG variy. Since we don't wantinterfereAwithAlcurrensCthus emulatbehaviorE!inCway described abovev To maintain compatibility other platforms,~1onlj is tested, but a list of s given 8envvars parameter. The first found)4be afwill b2dused. Gs5search pathd in GNU gettext;it must always coDp name ''IPExceprvj,  correspond5RFCa1766. &W) can be None#ca`values5notG)@term2"""mEtry:*# check if it's sup)_Zf modulp im' O$ =!S._getQ!()5e7!(IPError, Attribute)2paslFelse# make sur /;#are vali7tif sys. == "win32"|F A[:2]!60x"y}p windows identifier=;f=@P.get(int(B, 0)-0# ...add -specific21ceshere, ifq@# neVary..v-@# fajback on kul olookup = os.environ5forP$2 = J(x,#if.B#ikZUAGE''+ qP.split(':')[0].Qbreak  J1'C'#Yc_parse`(.p) def(category=LC_CTYPE):R""" RhV _^N Nncategory may be one of the LC_* value exceptALL. It defaults touCTYPE. E91forScode 'C',language correspondM5RFCFb1766. 'and encoding can be Nqin caseZs&nobe determined1"""glocalename = _set(category)&4if 0 ==@ALL r';' in 6G:1&raise TypeError('C0LC_@is not supported'mreturn _parse_Z( ~) def ,="):q""" Set"D @give@c. TheCF5 bea string, an iterabl4#wo:s ("%),K!or,IP@s ar0nve^v@s us@aliaWengine. LSpassed directlyYKWC lib0mayb 0as j s:M$if<isinstance, _builtin_str).A# co= normalize(Fd)D"C.re#= ?s@,!toCtingU 7 is by calling3get46().2o{ 5e)) trySfrom f0 imS _get_ *I#A1(if hasattr(sys, 'getandroidapilevel'/Rb# On A$ tainfo.hqCODESETJ0mis#d UTF-8 iscJPalway` edmbstowcs()Nwcstombs().8'U'if sys.flags.utf8_mode o;L> = 8[1]d,!isK ab# LANG]Cet, .bservativeUASCIIYZ= 'ascii"'s2NamgetpreferredA6(doW=TrueB"""R  ch a`e userD0lik.| else: # On UnHix, if CODESET is available, use that. def getpreferredencoding(do_setlocale=True):15"""Return the charsetU@userulikely using,=Paccorc1 to/ system configuration."""2if sys.flags.utf8_mode: r'UTF-8' if not d9a_get_l_)H0old5 = (LC_CTYPE)n:try^ BF, ""F$except ErrorSEpassu"kfinall+) ### Database # # The following data was extracted fromO.alias file which # comes with X11 and10n h 0ediGPremovcdexplicit  #0ini.sB!adVsome more y2es.`is usu& # as /usr/lib/X11/E. #  '_h t_ maps lowercase names #!C F# (8-sensitive). Not normalize() # first looks upAoi.s`es dic20ary4hen applies thispxBo fi correct C lib@ fort% #v$ 2= {KP# Map^s@non-standardG_Ted in'`'437':2'C'n/'c' & )/en* 'ISO8859-1Z?jis2 W'JIS7, ,?aje d'eucJPYOkoi8.e'KOI8- microsoftcp12511'CP; .5.5 .6.6.K n12U12b 1b122Python codec#to0?o'asciisolatin_8'ISO8859-1', 'iso8859_1': @'ISO K-1',102102d2d3d 3d42 4252 5262 6221 211 1 1 1 7 781 8191 912022_jp2E'JISshift_jis+d 'SJISXOtact)]FTACT.?eucwd'eucJP[-/kr[TeucKR-Outf_>ZEUTF->_koi8_ZUKOI8-[.t.T.u. U.Oz1041'RK y_cp125C!CP .@.\.&# XXX This list is still incomplete. If you know more:Rmappings, please file a bug report. Thanks. } for k, v in sorted(locale_encoding_alias.items()):hk = k.replace('_', '')l?setdefault(o) # # The 0af table maps lowercnames to C3 @ # (&-sensitive). Ens are always separated from t|! #K using a dot ('.');%y should only be given0w" # languageIis neededinterpret+=\  # correctly (CJK codes often have t T!).90NotaUnormalize() function which us5>[s # removes '_' and '-' charactersppart ofbefore do9the lookup. ThisZ saves a lot of # space in the table. # # MAL 2004-12-10: # Updated alias mapping to most recent locale.a$file # from X.org distribution using make6a52.pyThese aredifferences compared|5old (Python 2.4 # and older):C u 'bg' -> 'bg_BG.ISO8859-5'VCP1251' # 9_<'ulgarian|$"cz9Ucz_CZ2*cs ?cz_?+3ech~Os_CS~4dut?Unl_BE?1Wnl_NL "et{Fet_E<4< ,15_et_ee@("fi=Wfi_FI+  }?fi_@*"iw}Fiw_I!8*he 6_iw_il?'sjapanes;ja_JP.SJIS|\eucJPqlUlt_LT1 -13=v]lv_LV= =s/slFsl_S2ycslovenA!Cth_t#th_TH.TACT/h1WCzh_czh_CN.eucCNk]gb2318R.big57Pzh_TW=%TW="TW! Czh_t^6 o8-05-35 cs_cs.iso2L R UserbocroatUsh_YU*sr GI<#5_hr' -> 'sh_HR.ISO8859-2' to 'hr_HR. # updated 'sh_sp' -> 'YU*?Wsr_CS?/yu?({'p_{5 {,5'{%p_{?!rr{ r@cyrillicE)zGr_SPezr"_yu.cp1251 CP @.isou2 2H5H H Qmicrosoft36Outf8XUTF-8yx@ # AP 2010-04-12: # Ualias mappingmost recent locale.$file # from X.org distribution usABmake65.py. # # These are the differences compared|5old (Python 2.6.5 # and older):VrFru_RX?ru_;%serbocroatian ?q'sr_RS.~m@latin h>+!>; A?lat;+Qr_cs.\ KqX G- HLl  qCC' to 'sr_RS.UTF-8' # updated 'sr_yu@cyrillic' ->CS.ISO8859-5' topRS.UTF-D # SS 2013-12-20: # UTalias mapping<most recent locale.$file # from X.org distribution usABmake65.py. # # These are the differences compared|5old (Python 3.3.3 # and older):V"a3a3_AZ.KOI8-C 'az R_a3_az9&S.koi8xcs_cs.iso27cs_2Z2bhebrew@Uiw_IL+8@*he @8I'"sd<sd_IN@devanagari' ssr@latnD$r_"in sr  E=_csC = D sr@utf8W1H#4-10-01with glibc 2.19 suppor#|su8-05-05N/27N-?6.5 ca_es@valenciaFca_E'159 6Ckk_kkk_KZ.RK104 |ptcp154crussiaUru_RU_inBR' _P = { P'a3':  ',<?<c <Oa_dj7 e'aa_DJ$1'Oa_er?#ER;t;T;f8 'af_ZAOf_zaB?_gr_pe@{'agr_PEk_gh':  'ak_GH.UTF-8', P'am':  l'am_ET;?_et>;oerican> 'en_US.ISO8859-1On_es< 'an_E?5@?p_i} @Kp_INry|Er_AA6{Or_aaB/'a?e?E~/bh?/BH?/dz?/DZ?/eg?/EG? ;?_iqz/IQz/jo?/JO?/kw?/KW?/lb?/LB?y?Y?mMoc/OM~q~Q~s?S?d;/SDsLr_SSf/_sSt+/TNyfYfOabic8#4bss? 'a;tUO'astUOyc_p6{'ayc_PEV6z_AY%9EVz_az':  'az_AZ.ISO8859-9E', &`az.iso@9e':(@/ir6H@IR.UTF-8{bn8 'be_BY.CP1251<o@latinz <w1be_bg.utf8C l'bg_BG?_by6 | 3_byk=<Om_zm~|'bem_ZMOr_dz<Nr_DZ</ma<+MA<g8l 1?g_b? <_hb_in{'bhb_IN?ho__/ho</np{'bho_NPxOi_vu;{ 'bi_VU;On_bd;Mn_BD;N 'bn?o_c  p/.e  11e  'en_US.ISO8859-1', 'c.utf8': ?UUTF-8;/_c8W 'C1.31aao 'ca_EOa_adB?/ADOa_es?~es@valenci~1ES.Z.Oa_fr/FR/it?/IT?_talanA [Oe_ru= 'ce_RU*_extenzhinese- 'zh_CN.eucCNz;7 ; TW;&TW;?r_us 0chr<_kb_iq-{'ckb_IQ-_mn_tw<[mn_TW<Orh_u|'crh_UA<Ooati V'hr_H2+e'cs_CZ?/_cB? z4 ?Ob_pl@{'csb_PL8vvys4Ey_GB4Oy_gbB/'c?1?z_cBsOzech~d;^da_DK;_da_dk~??nis'?s~K.ISO8859-1', 'de':  'de_DE.ISO8859-1'??_atB?/AT?b?B~/ch~/CH~~iIli.utf8 ~LI.UTF-8v/lu6 ;U?uts9?_oi_in{'doi_IN/uty 'nl_NL?@.iso1?0Ov_mv64k'dv_MV?z_bJz_BT;eFee_E4?ee_B'??sti(et~/el<El_GR7Ol_cyBo'el_CY?/gr?~gr@euroD ~?%150Uen_US<On_agz >{ 'en_AG4?n_a;?en_X?en_(?w/BW/ca?/CA?/dk?/DK?lX]en_DLv/gbz/GBzhHi+/I(ni 'en_IL.UTF-8', 'en_in':  (IN.ISO8859-1?/ng?KNG.Uz/nz;Zz/ph?/PH?sc.utf8D -SCs/SGz/uku z/GB?s?/US?Q@euroI~?5/za6@/ZA/zm?Mw/zw;Wzw,ZSzOg_gb{Oglis?Ec?@.iso|1??_t ?_united-state?~ ?J.437-'CeZpoY. e'eo_XX%3~o"6o"?o_ezw/EOw?_usz?UOo_xx;g 9_'es_ENOs_ar~Es_AR>?s_b76s_B7?/cl~/CL~c~C~C/cuUn?s_dD9-1', 'es_ec':  'es_EC.ISO8859-1', 2/es?S?/gt?/GT?/hn?/HN?/mx?/MX?/ni?/NI?/pa?/PA?e?E?r?R?y?Y?/sv?/SV?uvUvuUvzVz_tonia _'et_E?0< ?5?t_e @u?u_E|/u_1?f?u_Ffqfa_IR.UTF-88Ofa_iz;.isiri3342@';aISIRI-)eOff_s/ Kf_SN;7i_FOfi_fC/'f@Ol_phC|'fil_PHOnnis= |ow|n'fo_FOdOfo_fB?,yr?r_bOfr_B%Ofr_c 'fr_ CA.ISO8859-1', 'fr_ch':  (/CH?/fr?/FR?/lu?/LU?an\xe7aisE ~/e_?n<? @.iso1?zench_france=_ur_it8 'fur_IT.UTF-84?y_ds;} 'fy_DE;/nlv;*NL;/ga8^ga_IE,Oga_i?Olegoo'gl_ES~olicianA ?d9 to'gd_GB~Od_gbB?/er0'de cOgerm/ ? (?de_(~_y~?z_e{'gez_EROez_ed< dg&p?l_e 1?Oreek,<~Fel_G7!Ogu_i ?[gu_IN4vw;vv?_ha_ngj'ha_NGohak_tw<'(+TW<Uhe_ILOhe_i/ 'he_IL.ISO8859-8', 'hebrew': '?i;V'hi_IN.ISCII-DEV~Oi_inB? .isciidevH?Of_fj7'hif_FJ.UTF8/ne9` ne </'h<rwu 'hr_HR2q?r_hB?_vatsk ?Osb_d8'hsb_DEOt_htk'ht_HTu8Ou_HUz?u_hB/'h?ongaria ?Oy_amk'hy_AM;@.arm%8D;0ARM_/ia3:'iawOia_fh[ia_FR;celandicz e'is_IS1/id8 o'id_ID?_B?Og_ngk'ig_NG?k_cnk'ik_CA;X  n+s[?s_iB1so-1 _'en_U/?5@ ?5o/so~ @ ?~ ?__ 'en _US.ISO8859-1', 'iso_P_15':9'en?5@t7 Mo'it_ITOt_chB?/CH?i?~_alian ?u: 'iu_CA.NUNACOM-8;Ou_caB? .nunacom8H?w3e'he_ILzOw_ilB? O.utf0'iw~6UTF7j4ja_JP.eucJPr_ja_jp;N? ';omscode>;ISJISO.pck7 :p# t %_panes ;O-eucv c ;p&kLka_GE.GEORGIAN-ACADEMYOka_g/ F.georgianacademyF'F.psA FPtrA Ob_dz}'kab_DZ.Okk_k; 'kk_KZ.ptcp1546l_GOkl_gB/'k??m_k[km_KH2Ln_IN;/_i> 'kn_IN.UTF-8', 'ko':  'ko_KR.eucKR;?_kr>;N? ;Ok_in8 k?rea<;s~>'kss ;@devanagari.utf8;.?u_tu_TR.ISO8859-9?wr e'kw_GB?1??_gbB?y<+Ky_KGOy_kg>.'k;_lb_lu;Zlb_LUvOlg_uvVlg_UG/00_li_be{Ki_BE{Oi_nl;,NL;Oj_it<|'lij_IT<othuani f'lt_LT3On_cd{{ 'ln_CD{lo_LA.MULELAO-_lo_laz?.cp1133F'~aIBM-CP,O.ibmC @ mulelao1@?t_lC@vxo'lv_LV8?v_lC@Ozh_tz'lzh_TWy?mag'( ?maiB'maiMF-8', 'mai_in':  'mai_IN.UTF-8', ./np<+NP<_fe_mu<[fe_MU<Og_mg; 'mg_MG.ISO8859-15Ohr_r|Lhr_R|iy 'mi_NZ|{Oi_nzB??q_n{'miq_NI6/jw.jwkEk_MKq?k_mB/'m?l~ll? 'm;?n_ml 'mn_MnUnUrrr;svEs_MY1Os_myB/'m?t<_Et_MT~3~?t_mB/'m?Oy_mmj'my_MMTonan_tw<'(+TW<b8fUnb_NOs_nb_noB'?_ds_de@{'nds_DEOds_n<+NL</e_3\ 'ne_3onhn_mx[hn_MXwOiu_n[niu_N'(+NZx'Ol_NL?l_a_l 'nl_A_?l_b 'nl_BE.ISO8859-1', 'nl_nl':  (/NL?n<gOn_NO??_noB/'n?<~o~o@nynorsk ?'ny?~p_no.iso1@bokma/'n??orwegia ?r3 Ko'nr_ZAOr_zaB?sI'nso5/soAyz;y;?~7/oc^oc_FROoc_f'?Om_et'om_ET.UTF-8_om_ke;Ko7[or_INz?r_i+ ';Os_ruJs_RUvp$-pa/pa;p | 'pa_PK/p_S ;p_Acopap_aw)'(.AWxc<C<dtn'pd_USOpd_dOpd_D_pd_us~h< 'ph _PH.ISO8859-1', 'ph_ph':  (?l<gEl_PL~2~?l_pB/'p?Oolis?rtuguese e'pt_PT;o?o_brazi?/BR??sixy %'C-osix-utf26 1p) _Op_ANOp_anB/'p?Os_af?s_AF.UTF-8t8Ot_brB?t_p?_quz_pR z'(*PE_raj_it'(+IN<o5Uro_ROOro_rB'?Omani0?uKu_RU?u_r>/'r;/uay;UA.KOI8-U/ru,/ss/ {"RU{R{wEw_RWOrw_rB/'r?/sa\ 'sa_?sat<'( <?c_iZsc_IT"/sd0.sdd/ ';@devanagari.utf8;.^sd_pk6BF+PKe_no':  'se_NO.UTF-8', %'serbocroatian':b'sr_RS;e@latinA_gs_lt:Nr'sgs_LTB<h8?}h_ba.iso88592@bosniaTA`CS.ISO(&-2>_hr/to'sh_HR?~H?'hr?/sp6/yu?_hn_mmB|'shn_MM?s_cj {'shs_CA<it>l'si_LK;?_lk>;?d_eLid_E_inhalw 'sk_SKc?k_sB?l-~Ol_SI~Ol_csBO'sl__?l_s?~?ova_ovene ~ /en ;?m_w;3m_WXOo_dj 3Eo_DJ1?N 'so?o_k1z/KEz/so/SO? rn5/p_?OanisV'es_EKvp?__spaiH ?q8Eq_AL;q_al':  'sq_AL.ISO8859-2', *@mk':  (MK.UTF-8;r8 'sr_RS;@cyrillicD ;Olatn7 ;Cvf@latin?_cs? A ;@.isoD2W|lOr_cs6?l. /me,MEr/_r/_r; /sp/CSOr_yu?yu.cp1251xx CP(%yu<?5?5~5 ~ ?microsoft?Outf8<v ;; 6 :TEs_ZAf1Os_za z?t<~t~t~?v~Ov_SEOv_fiBo'sv_FI?s~?w_k? 'szl_PL{th,ta_IN.TSCII-0Kta_iv  'ta_IN.TSCII-0', in.tscii':(= 0>=/lk6=LK.UTF-8cy_in.utf8A @'tcy <e3 u_ 'te;?_in>;g8 vg_TJ.KOI8-COg_tj?/'t<h9xh_TH.ISO8859-11|?h_tC/'t@ .tactis@VTIS62|@.tis<a <Oe_npA{'the_NPOi_er;~ 'ti_ER;t;T;gwN'tigwOk_tmwKk_TMwl8a7l_Pa`?l_p`?~Fn_ZA5On_za/'t@Oo_to@Ko_TO9Opi_p{'tpi_PG<_Er_TR9Or_cyOr_CY?t/'t~  W9'tss?_;t_RU.TATAR-CYR~Ot_ru;?.tatarcyD/'t?@iqtelif'tt_RU.UTF-8@iqtelif', 'turkish':'tr_TR.ISO8859-9?_ug_cn= 'ug_CN.UTF-8;k8uk_UA.KOI8-U<?_ua?'<?niv; 'en_US.ut+universal> 9No8@ucs4C9 %_nm_us. @'unm <r8E'ur_PK.CP1256a?r_i/'u;@cyrillic;/ve/\j've_ZAOve_z;ivi_VN.TCVNOvi_vv:?.tc? ': O5712:_visci :iVISCII.<?111w<wUwa_BE1{Owa_b'??e_c 'wae_CHUowal_et<Kl_ET<?o_sKwo_Sx|0'xhF1/xh ?y x0'yi$5/yi` <Oo_nglz 'yo_NGl_yue_h&'(,HK<?w_pxb'yuw_Px8', 'zh'/: 'zh_CN.eucCN', 1?cn'>(CN.gb2312<_.big5A <"TW(v9  :/hk7 !HKuWhkscs#hkFz?/sg8{! [SG.GB/_sg.gb {<K/twuh/twh TW()TWu{ ;u%u_ZA.ISO8859-1zOu_zaB-'z?2} # # This maps Windows language identifiers to locale strings. >@list has been updated from # http://msdn.microsoft.com/library/default.asp?url= en-us/intl/nls_238z.asp #include every upRVistasNOTE: t ping is incomplete. If yours missing, please # submit a bug reportsthe Pythontracker atabugs.p".org/ # Make surexJwdP and $suggested #@code" w_1= { 0x0436: "af_ZA", # Afrikaans!1c: "sq_AL!ulbanian 84: "gsw_FR",# Alsatian - France) 5ejBm_ETImharic - Ethiopia* 01*3r_S1rab)pSaudi A-8-"IQWVDIraqRc%*EG%SEgypt&$10&*LY&DLibyq$14&*DZ&UAlger1MtMoroccov*TNPUTunisP2*OM(%Om2*YE%DYeme2S&Sy2*JOLEJords3*LB'dLebanou3*KW(TKuwai3A0UniF Emirate3*BH\dBahrai4QA", # Arabic - Qatar 0x042b: "hy_AM", # Armenian 4d: "as_IN ssamese - India( 2c(Bz_AZ(zeri - LatiM8%CyrillicM6uQba_RUMgBashkiTeu_ES quHRuss3: "be_BY'ielarus5"ncBegali@201aBs_BA@ os; - /14* 047eQBr_FRQreton - Francex@0402'Bg_BG'Pulgar#5Bmy_M3BurNot supportedQ $ca0VCatal004: "zh_CHS",# ChinSimplifiK,!TW,FTaiwT8T7(4PRCc%+HKM`Hong KcS.A.R.21SWSingaporF$14]+MO]iMacao Y7:CHTTraditional1048PoCorsicaBhr_HPCroat1b$hrb A - Bmr0Bcs_C^VCzech6: "da_DGVDanis8`gbz_AF!Da@Afgh(t 46eadiv_MV*@ivehMaldivesq1Qnl_NL[Dutch - The Netherland/8/)BE/uBelgiumV09: "en_U`EnglisXUnited Stat8/!GBV /eKingdo_c0AT0uAustral9$10+C+TCanad$14(N(`New Zee1I-0Ire0$1cVZ~South Afric2J.GJama)C0uCaribbe 2BTBelizc2+TTtTrinida3Z7tZimbabwT3+PHTpPhilipp+4WW4TM 'VMalay34 Q `0042.Cet_E0sto0438: "fo_FdFaroes0046I@fil_0# F5ino?0Qfi_FI9Fin0fKAFren K8'_BE", # French - Belgium 0x0c0c: "fr_CA", # Fren(cCanada'%10'H'Switzerland,4,*LU,Luxembourg+8+*MC+cMonaco'@0462Cy_NL'isian - Neth~s-56: "gl_ES-Galician 37: "ka_GE Heorg 0 Dde_D !rml Ge yH8(C> - $0c,#ATtK - Austrig|;T;4S*LISLiechtenstei08: "el_GR.Dreek046f2l_G_PGreenUic - /4Rgu_INLuujarati 6lQha_NG Hausa - Latd: "he_IteHebrewC 39icFHind` 0e2u_H`iHungarBis_I2Ice_21: "id_ID`IndoneS"5$iuInuktitutuyllabicr8- 83mBga_I[@Iris!Ir} 102t_I.BItal '' 41Qja_JPJapaneset 4bnr0Kane - Ind0043[Qkk_KZGeKazakhE 53E2h_KKhmer - CamboF8qut_GT",# K'icheltuatemal0048lRrw_RWpinyarwandRR ~,1kok# Konkan7 122o_KGKore4tBky_KfKyrgyz[4: "lo_L&1LaoUo PDR%2Qlv_LVHLatv2Blt_LwLithuan" 821dsb{# Lower Sorb 46/3lb_-$&is2Qmk_MKFYROM Macedo| 43MQms_MY(Malay - s8(B Wrunei Darussalaa 44!ml" #Q![a: "mt_M HMalt8Bmi_NzFMaor7<`arn_CLQMapudungu4rGrathA!oh# Mohawk5&Cmn_MCongoCyrillic,8,C,4PRC' 46Bne_NVNepal1yQnb_NOPNorwesTokmalH8*n*an - Nynorsk 0x0482: "oc_FR", # Occitan - France( 48(Br_IN(riya - India%63: "ps_AF%Pashto - Afghanistan,29: "fa_IyWPersi 15KBl_PLKUolish= 163t_B=ortuguese - Brazil+8+#PTI+P8a-!44XatPunjabiL46b: "quz_BO",# Quechua (Bolivia))8))EC)uEcuador)c))PE)EPeru& 41}Qro_ROaRomani y417: "rm_CH*8uRru_RU'usu0243`smn_FISami Finlandb#10$1j_N$dNorway#G1j_S#VSwedeFeE1 # #Northern O$08,N , Xc, , 2sTSkolt{!ma?Sou1{)ma, u44f: "shtSanskrix@0c1a Ar_SPBSerbCyrillic*+BA*{Bosnia 1/08[DLati1'X.10459Bi_LKPinhal Sri Lank$c: "ns_ZSSotho0043$tn&qSetswanRSVAfricX13k_SUlovakP 24QBl_SI@loveC!0rRes_ES!puh - Spa$08'+MX'UMexicc(O (Modern$100GSGuatemal$14+C+vCosta R1Pm,UPanamTDa(Dominican Repubz2+VE uVenezue2 _eColombB2 U2AArgentin3YT3qDChil3U{UUrugu3+PYGPara*4U W4+SVSpEl Salv[-HSpanish - Honduras 0x4c0a: "es_NI", # Spanish - Nicaragua+$50++PR+Puerto Rico-4-+US-United States #r0430: "+0utuot supportedW0441: "sw_KE,ewahili 1d4v_S"eddSweden(8(Fw(fFinlanp5syr_SY",# SyriacG428: "tg_TJTajik - Cyrilli(085f(Pmz_DZFTamazight - Lati0449)Ca_INQ5miln 44Ct_RU6tar%te:Uelugu 1e;Bh_TH;%ha4 85SRbo_BTibetan - Bhuta(C(6PRCi2r_T$uTurkish 42Bk_TMlPurkmel 3 483ug_nUighur - ArabZ 42QQuk_UAQwUkraini2`wen_DE{Upper SorbiuGermany2wBr_PKP%rdE80UrdDIndi$0443: "uz_UZ@0zbe 8% 2Bvi_VrVietnamese5Qcy_GBo7Welm8Bwo_S?Wolof - SenegaW3WBxh_ZCPXhosa'outh Afric 85`!ah`# Yaku 7{$iiXYi - '6Qyo_NGPYorubuWNigerO3p$zuZulu } def _print_locale(): """ Test function.categories = {}MVinit_( = !):1 for k,v in globals().items"if k[:3] == 'LC_'E#bq[k] = vg_)Gdel 1SRALL']1('L defaults as determined by getA'`BR-'*72lang, enc =85Language: ', 7 or '(undefz)dEncoding/`. )settings on startup:d@,?y >ies3S '...ZEMy8(CO'  6#5 '('Locale set&tings after calling resetlocale():') print('-'*72 '$for name,category in ies.items():-U3S '...llang, enc = gMy( Language: ', ? or '(undefined)^6Encoding6o5 !) 6try0LC_ALL, ""fexcept*yDNOTEZH does not support the default Pgiven- OS environment variablesqLelseLO set5A\35E7;,K'? :C9) ### HLC_MESSAGES 6 NameErrorVpass __all__.append("A") if __$__=='__main__'KPaliasG_ _g( 'Number forma ,$_test() # Copyright 2001-2019 by Vinay Sajip. All R$>s Reserved. # # Permission to use, copy, modify, and distribute this softwareits # docu atKany purpose(without fee is hereby granted, # provided thaQabovepnotice  ar0all1iesc9r # bothE ;n_Fis p V$ # g88 ofk! #^ beLd`dvertiEpublicity@taine&todPion #Vmj>specific, writtenM orMD. # VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING # 9xIMPLIEDA"OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL BE LIABLE FOR ANY SPECIAL~ DIRECT OR CONSEQUENTIAL DAMQ OR #4WHATSOEVER RESULTING FROM LOSS OF USE, DATAVPROFITS, WHETHENIN AN ACTION0CONTRACT, NEGLIGENCE;O0 TORTIOUS ACTION, ARISING OUT # OF OR IN CONNECTION WITH THE USEPERFORMANCE0VTHIS SOFTWARE. """ Logging package for Python. Based on PEP 282 and comments thereto in comp.lang.py; Copyright (C) 2001-2019 Vinay Sajip. All R%s Reserved. To use, simply 'import l ' log away! #Dsys, os, time, io, re, traceback, warnings, weakref, collections.abc from string i|TemplateFormatter as Str __all__ = ['BASIC_T', 'Buffee1CRITICAL PDEBUG ERROR', B'FAT&FileHandler,CFilt "KINFOMLogRecord+B CAdapSQNOTSEENullT eStream` 'WARNX!INaddLevelNamebasicConfigcaptureW-critical Qdebug QisablM[errorGPexcep,2fat>9get2ogg [ClassP@infoK!lo~ImakeD2set== 'shutdownII!inMypFactory"S  zlastResort0draiseEDs'] 'threadinguthor__ = "0 " __status7QproduC`" # ThG@llowYmodule attributes are no longer updat__version0"0.5.1.2l!j07 February 2010" #-7 # Miscellaneous mOdatak;@ # #IrtTime isdGthe base when calculatO re !ve` of ev7 # N=. 0() k pto see if &@s du hYxshould be #propag< # Ua= Truep If you don't want z A8`ion inM@, se&is to zero # logT/s ^ multiprocessdM>l gPe ------------- # Level related stuff #9  # # Default lmRs and B names, these can be replaced with any positive set # of values having correspondT. There is a pseudo-~, NOTSET, which ##only really@re a8 lower limit for user-defines. Handlerq # logg}nitializ{ so thatk`y will6 all messageven # atv # CRITICAL = 50 FAT  ERROR = 40 WARNING = 3 3 =  INFO = 20 DEBU$310 a= 0 _7ToName = { f4: ' !',w1: 'l3: ' |0: '1: '2: ' `', } _"To:'1': !: $':=ING : *!: :x } def getX(d!):B1"""`Return% textual or numeric&resentationzL! '1'. L!IfHe3zthe pre$ (, )VPn you  string. If%Ahaveaassociss@s us5add Z "K1rB&eda@B Uto on is passed!in A ?is -ot plno matchW/3or 9 kd'c %s' % i# See Iss#22386, #27937a#29220Pwhy it's this waym0res,(= zC.get&%3if (is not None@p#1.(= ;V0" " ,? A#'T-i'W hen converting levels to text during message formatting. """_acquireLock()@try:#&#unlikely to cause an exception, but you never know..^?_levelToName[ A] = k(pnameToL.(,(finally: 5dreleas if hasattr(sys, '_getframe')6bcurrenambda: sys., (3) else: #pragma: no coverzHdef H(\"""Return the {p object|caller's stack$.Dzi traise Es2rexc_info()[2].tb_.f_back # # _srcfile is used when walk@Check e've gotfirst # , by skippN~s whose uythat of this # module*ource. Ihrefore should contaip1ileLDBA # sDo.Ordinarily we wM __#__"iscfrozenRs don't alwayUhave :Aset,?some reason (see Issue #21736). Thus,!ge! #from a handy codeI@func defined #is. # (TherAno particularqfor pic1add{ue.) # = os.path.normcase(. __Q__.co:+) SBonlyX injKwith) To provide compatibility 1older versions3@Pyth5set #None if )lnot available;s value will prevenQfindC1()  bed. You can also doJ!if@wantPavoid0he H@headUfetchM r Yg & #`. #if #0  _c(if isinstanceS, intQ3rv elif str-3) ="if@in _*&[VError("UnYnAr: %r" % 6UH]&seeRCType` aneger or a id1ingyOp "% ",)rorv #-7 Thread-relate1ufff-------------( # #_lock is used to serialize accesshared data structures in this module. #TAneed6be an RLabecause fileConfig() creates and cW #Handlers,so might arbitraryr threads. Since 5 code updZcthe #s`iction@%_hb5it acquire the . But ifding, # would aly have been Hd - so web (e same argument applie7bLoggerManager.lDict. # =Aing.e() def _y(): """Aa-levelE for?ing!. J!shbe releaCcwith _.11if . C-CRmId by call q # Prev` held Y(p from b ra child(%. if not hasattr(os, 'register_at_fork'): # Windowrfriends 5q_reinitF(instance_@passVno-op when os.FQ doesexist. elsew# A colleAD of f!s $a  method () #T!be"edGe5Pafterk The weakref avoid keepingNdiscardedRalive= 0_\Tset =f.WeakSet>s" oL2tryR  F.addDlfinallHpOfs 6_/ 5.2B\#K was0par`ebefore# d unsed staty(=,R_1in_Z"=_ oJ=BV) #-------------! # The logging record #M!4 class LogR^(object): """A! instance represents an event beAed. <[:s are created9ry time somethB!is0ed.yIcontain all the information pertin!toJImF >assed in ismsg and args, whichqombinedF usstr(msg) %.3 tomessage field ofI also include sugs whenBC wasm!d,Jsource line1!re2c=8Rmade,ny excepIGBto bdef __init__(self, name, level, pathoBAmsg,7,_x, func=None, s @**kwD Initialize a;Zwith interestW:.BNAct =.%()%.! = 8U= msg# p follow`statemaQs pasRof a dicary as a soleK@argu<0, sat you can doF8lik6.debug("a %(a)d b %(b)s", {'a':1, 'b':2}# Suggesby Stefan BehnelBP# Notp0at t1out}test for [0], we get a problem becaus0dur'6Kto see iO0arg +A'if =R:'. I7!Fe.g. 'Value7%d'Kue!{ fails g@n no0matIis done. For exampl8ogger.warning(, 0) wouldK &b!eaj(0's(use casemx, this shu no' az\Issue #21172: a requqPrelax5 isKWcheck\to hasattr(4'__getitem__'). Howevere docs on st6J@` still:msp a mapp$irR# Thu 0le Premov7M , it does now loCok ,# for collections.abc.Mapping rather than, as before, dict.Dif (args and len a) == 1isinstanceO[0],r)UPYZ[0]):o#= Pself.  levelname = getLQName({FQno = JCpathI !:tryOCfile20os.5A.bas(7Pmodul5splitext(VE)[0]except (TypeError, Valu Attribut X V4 = ]"Unknown m"+Lpexc_infH !p = None` # used to cache traceback / ETstackhsp Bline @func0 = created = ctmsecs = (ct - int(ct)) * 1000+relativeCM]- _startTimeBif logThreadsZt2 = ing.get_ident(S' 4current_0(). else: # pragma: no cover!@~#`if notMultiprocessingx0Zh 2b'MainPu'-mp = sys.s_:('m'jif mp is !# s may occur 6 W2 haDfinished loadingO ye@e.g.Ia custom import hook causes third-party codeMto run when c callsX. See issue 82aan exampll 06O 4mp. 9E oion: # 4Epass{Pehasattr(os, 'getpid'EA = o27pid >def __repr__7nreturn ''%(self.name, self.levelno, pathname, clineno Qmsg) 3def getMessage(+!):P5""" Return the m. for this LogRecord.V<0 after merging any user-supplied~arguments with.$msg = str."ifFargs6%#`rmsg # # Determine which class to when instantiatQlog r)ts. # _l8Factory =K 5set]%"(f-1Set bed&a s:param @: A callablqwill be edae& VR}global 7 $ =g o Emake[(dictfMake a whose attributes are defined byspecified RbionaryTbfunction is1ful~aconver\|FPeventheived overa socket conneO(@is s5Gas ah) intoI"ce{Nrv =r(None, p"", 0, $())XPrv.____.update_~rv #-7`Format4nd usq;e_str_frU= Stri() del1  PercentStyle(obje{sdefaultWc = '%(1)s'#yasctime# #bsearchF#E`valida!_p1n = re.compile(r'%\(\w+\)[#0+ -]*(\*|\d+)?(\. )?[diouxefgcrsa%]',EI__init__, fmt, *,6!s=6P._fmt;Rmt or /5s =Xz}usesTimBfmt.find.+_?f) >= 0Q; QB"""VVe Pinputmat, ensure it matches the correct style""" if not self.validation_pattern.search(e_fmt)::Araise ValueError("InF format '%s'  ~6 % Q,{default_7a[0])) jCdef 5, record3if ?Bs :=P_ v6s =1|P.__dict__vOelse>3creturnbfmt % r:trys RT(~)xcept KeyK as !'FKting fieldfound in : % e) class Str:SH(Percent x = '{message}'xasctime! !{B!'G4fmt_spec = re.compile(r'^(.?[<>=^])?[+ -]?#?0?(\d+|{\w+})?[,_]?(\.()?[bcdefgnosx%]?$'b".I_mD \w+)(\.\w+|\[[^]]+\])*$'."**1ate3B"""VDe the inputmat, ensure it isBcorrr)Bset(q 0bfor _,`name, *, conversionC_strter.pars.h&ifS H6q.match(,5iKame/expresv: %r' %VzWs.add&(if!8andin 'rsa'w!if vvKF1badRTifierBe=?)V 6 N"nosHzingTemplater '${message} ' asctime_format = '${}"lsearch"Edef __init__(self, *args, **kw !):)rsuper().1 +*elf._tpl = Template_q._fmt) )|rusesTimk fm20return fmt.find('$') >= 0 or? '&Tvalidwpattern.fields = set()or m in 0GiterSd = m.groupdicLif d['named']9V.add('#"elDObracE(FP(0) =q'raise ValueError('inf  : bare \'$\' not allowed'o!if b^2no 9'g, record efaults :d v# |P0.__%__ Oelse>3@.substitute(**} ) BASIC_FORMAT = "%(level'U)s:%( message)s" _STYLES = {'%': (PercentStyle, Y"),'{'AStrFj)%'{r0}:{p3}:{n$}';$;4ing@$A$B$C} class zEcobject1""" instances eused to convert a LogRRtext. BBs ne5know how6 isMstructed. Theykresponsible*w9ingDto (usually) a str"which canKbe interpreted by either a humanPan exal systemV base2Od0s a@mattqxto be specifiI~ne is supplied, theIs&-dependent  ,e)s", "Q", orB" ",e'Th ialized with :makes use ofi@ledgattributes - e.g. mentionedMhabove d3fact thae}Cr's  and arguJApre-O Hinto@. Currently, the) useful attributes in a LogRecord are described by: 1%(name)s=Name of the logger (ing channel)=wlevelno@qNumeric91"A forOmessage (DEBUG, INFO,L} WARNING, ERROR, CRITICAL~OText{ "|@", "~""+ "JpathDTFull Isource file whereWcall was issued (if availableT 0ile portionly%(modulM 9_:lineno)dS~ number MC 0unciAFuncM%(created)fN1TimonnS.p (time.(R> return valux0asc6 @ual wXmsecsL Millisecond`ArelativeC!d Fin mIs _1 toCz  Haloaded: P(typiy at applicaqstartup7%(threadT? ID1%1!3hprocesPehe resultermR.getM(), computed just as"B is emittP2"""converter =/`.local def __init__(self, fmt=None, datestyle='%',i=True, *defaultsK%):Initializ`formatwith specifiedmat strings.EA@eithVH&Le, or a7 asabove. Allowd"Oy op!al*fmt argument. IfBis o, you get anI ISO8601-like (or RFC 3339)aUse a  parameter of '%', '{' or '$' to specify that you want to use one of %-formatting, :meth:`str.` (``{}``) (5 orKa:class3ing.Template`/ inr@ str+ D.. versionchanged:: 3.2  Added the ``style`` parameter.*5""" 1if * not in _STYLES:! raise ValueError('S^t must b&: %s' % ','.join(DH j.keys())).bself._=[][0](fmt, defaults= @if validateY."&()b bfmt = uZ._fmt\( Eb_time_  = '%Y-%m-%d %H:%M:%S'N.Hmsec.us,%03d'SPTime(, record, }f=None)aReturncreation )ied LogRX3 asstNBext.PThis od shouldcalled from;s() by ater whichHmsQmake kf/d(. o0canloverriddenM2in n1terUpprovideC anyic requirement, butGbasic behaviour is llows: ifq3 (a)%D,K itused with@strf| () K. Otherwise, an ISO8601-like (or RFC 3339The resule&r(#edsAfunc,`uses ar-configurable*to converU to a tuple. By0`.local (W>;* t{Pfor adticula/&teminstance, se'er' attributeZ%a fhe samsignature  "or gms(). To "it~&ll+DAers,pexampleYall logging\ bel wn6GMT7 iFw  (c,(z)edazt1s =.'F, ct? 0r1Brv + N3for3 in sT' X.`PE2* orv #-70Fil}n!es@funcsn;q(object): """& Filter instances are used to perform arbitrary f/ing of LogRecords. MLoggers and Handl can optionally\u#toZGrU as desired. The base( class only allows events whichKbelow a certain point in the l hierarchy. For example, alI initialized with "A.B" willUCd by_s*,F5A.C",D.C.D D" etc. but not B!B.h!IfE empty string,qpassed.>1"""`def __L__(self, name=''):!- I P( r, togetherK5itsrchildren,[uhave itahroughu. If noI}is specified ow ry"nt .?=Slen = len($)NLKDetermine if 80 isbdiReturns Tru?5ushould 6, or False onFwiseIf deemed appropriate,P0mayM1modA in-placD77if !6= 0GbrQ%el5came ==~?2Q.findF, 0,?) !#(Y[]b".") @er(objectA+5for"h"@themQsharecommon codz^u ~o$ 0isti2an D?lis 6F= []2add ,:1AddgUSthis i3t (4"insss.append9oremoveR0_from  .Iy;Determine if a& record is loggable by consulting all the filters. The default@ to,!ow.WQto beZsed; anyG can vetoMthis and> isn dropped. Returns a zero value if aN:{;, else non-:.. versionchanged:: 3.2 Allow"s just call3%s.z5""" rv = Truefor f in self.S:Yif hasattr(f, '$*')%) re4 = I(u)O< 5 # assume - will raisf9not[rif not dFFalsUbreakLr rv #-7 # Handler classebfunctionso;2 _hms = weakref.WeakV!Ditary() #map oAnameZCMList = []@ddeda,be removed^ reeb order initialized def _.cRef(wrdRP3 a h reference from internal cleanup list G0# Tubf`ed duremodule teardown, when globals arCP# setpNone. IQn als"ed another thread. So we ne?y# pre-emptively grabnecessarynd checkkthey're ,J toMvent race>!dibfailures5preter shut4acquire, release,|S_PLock,#.MP +sY(:6try@if wG #X.[QkfinallT#()7addO 7Add!toQ 0 usZaiT X.append(Cref(~)M _!(FeeW instancKqispatch\eCspecific destinabase handler 6class. Acts as a placeholder which defines the Handler interface.s can optionally use Formatter instancK1o fIarecorddesired. Byxtault, n.Es specified; in thix1se,M'raw' messagedetermined by p. is logged.A1"""def __init__(self, level=NOTSET):& 2 Initializ%he - basicqsettingRuto NoneW2and" illist to emptyq}F*9er.)R._name =l = _checkL( BF_closed = FalsB# AdhEglobal _L (for cleanup on shutdownC_add1RefcreateLock() 1get2qreturn :!3s3 , @t_acquiri6try]'if]s(,&de&s[]"! = !if]x[1] =<!fi 8t_releas-> = property(Z$, 1w@AK a thread lock+A serW7daccess?punderly?I/Os.L=ZSing.RL_register_at_fork_re:0 $5r.): <)3I/Ogx R6x2set|u01Set2 ofQ".  must be an or a strH}.PQ9,[ 2.Y@If a5sO,Kit. Otherwise0def)5LF"dmodule """  if self.formatter: [fmt ="!Oelse/_defaultFT2return fmtq(record) #def emit(#, c1"""(#Do whatever it takes to actually log the specifiedCgingX.tL This version is intendedPbe implemented by subclasses and so1raiV NotI5eError.&2/ (' k must 'J'by Handler'hhjConditionWXAEmisTdepends on filters which may have been adu`8AWrap*^!of/ with acquis/release of9`I/O threaQck. RQetherT pdf5forNevBVif rv.Ere()i:try,0 ]!fi7g"rv"&se4Ffmt)S1Set+T0 foO=is 85=(Qflush|wEnsure alloutput hasaD/eddoes noth&  A_close Tidy up any resources usI Premov$het from anrnal map of %s,K_^#s,i}p lookupuname. SHshould e0thais gets calledoverridden methodsW##gkmodule data lock, as we're updat shared structureU_mGLock mB#unlikelyan excep, but you nfknow..^C_d = True( _NY5in t76del[iF]a _re leaseLock() def handleError(self, record):#'5""" H/ e0s which occur during an emit() call.iFThis method should be%sed fromrW!enIxception isencounteredt If raiseE@s is false,Hget silently ignored. i at@0mos ewantedGfor a loggsystem - -@ useill not care about@%inH;theFp, they 5amore isted in applica.LPYou cb, howeverpplace twith a custx if you wishL3The`was bepprocessBs pa Bn toeJGiand sys.stderr: # see issue 13807Ot, v, tb =6exc_info()&&ry7f.write('--- LMz ---\n'M<traceback.print_eF(q, None,FCall stack:x`# Walk& frame up until we're [$ofHp# so asPvcontext2k= tb.tb_ e$qwhile ( os.path.dirname.f_code.co_fp}ame) ==NRP __CW__[0]p=0.f_ N"if  D  , =OelseX#n't findkXright , @0some6aso7 %s, line %s\n' % (N .D(.L>no)2# IP8671:r4putr messageargumentztMQ: %r\n'$'Az:>msg{FOargs  RecursionVS_36272 Tm9Unable to print the message and arguments' ' - possible formatting error.\nUse theN traceback above to help findIYR)except OSE: #pragma: no cover.@pass# see issue 5971)finally:6del t, v, tb def __repr__(self)6level = getL AName$.return '<%s (%s)>' % *__class__.__name__, >  StreamHandler(1"""2A h  4which writes loggrecords, appropriately1ed,Kato a stP. Notsat this]does not clo-0A, asDsys.stdout or err may be used.* terminator = '\n'Cinit,lS=NoneIInitialize.R!fF" ispecified,'is8e7.__ic7Ja' =oFelf.!Qflush<F!!es|Fk[.acquire(+trtqhasattr1, ""rj%o1`releasAemitu", mcEmit a$ ar itEkE3The[1Athenj0ten94the]with a trailnewline. Ifbion inu s present, ted using@v.print_PappendedMhas an 'encoding' Tibute!"dePe how_ doRK`outputD r0msgu(9)~!#35046: merg #wo. into one>Q$(!+  | RecursionE # SY36272UraiseD Exception:   self.handleError(record) %def setStream(,1, s !):!%5""" Sets the 3HY3r's61 tospecified value,@if it is different.ibReturn`3oldTB, ifU was changed, or None`uwasn't.#ifX.result =^Oelse(JwIacquire():tryM0[flush.# = SofinallWhreleasrr __repr__ level = getL AName$.Bname(Battr#0, 'V', ''0# bpo-36015: ! can be an int( B!if7 Q#u += ' 'B'<%s %s(%s)>' % __class__.__=1__,W#, ! !S File( .r"A |"r 8which writes formatted logging sGdisk filesRCinit,&, mode='a', encoding=, delay=False, e s]a BOpent and useaFR # Issue #27493: add support=Path objecaopassed in = os.fspath( Q#keepabsolute *, otherwise derived2es Ethisq#may come a cropper wh0cur directory ?@base/?.ab6! =% =!if "b" not in<  Aio.text_T( L31r p[" =c#h26789:. as a re ceRbuiltin open# function)!bl4(!re C @ durKVPytho;!# 0izaK_|_J="if K#We don't-m , but we still need@call&W!#C construF-2setq,$r, lock etcDC.__init__(seWlf) self.stream = NoneUelse:4S(Handler.__init__(D , ._open()) 8def close#)M1"""!UC!bs the .'_acquire(6tryWO "ifa 1 9~Wflush|kfinall{( =!o2 ' if hasattr(11, "t"p) .., # Issue #19523: call unconditio= to# prevent a h? leak when delay is set;Also see|42378: we arely on9F_pd beingb to Truerr =al`releas-@OpenP curr"base file withP(origa) mode and encoding.RReturLaresult%{T_func@_bui7rX..Filename,7; =., errors ?Aemitq, recordG0Emi]$.~!IfB was not eqcause ''specified iLconstructor,A it beforenuperclass's i,A1'w'`=`Awill!bei\ted ()) uf $0!= !orr 5uSg\& C C ^S_reprlevel = getL 2Nam.?'<%s %s (%s)>' %GQlf.__P__.__#__ T! . _Stderr'(RThis 6is like a 10 usYQsys.sW, but always useswhatever )Ttly set to r6ather than the value of sys.stderr at handler construction time. -1"""5def __init__(self, level=NOTSET):&2 InitializelZ ^ H.f!) _@propertyastreamgreturn _defaultLastResort = _S{(WARNING) l% :O #-7 # Managlasses and funso; cd PlaceHolder(objectB! instancre used i[0loghierarchy to takepp of nodes for which no = s have been defined. This !isMintendedC @rnalQ only:not as partrublic APIF sa- Awithspecified being a child1is hsP\Y.~Map = { : None } aappend,'?Add/as$ifn h:in   [1] =1 #Determine!toCwhen@tiatZ$`s. # AsetLC (k `1Set[b_ae~ashouldP) suc #at name argument is required,"thz") `b call  )w1if 3 !=*si`q1sub ,)raise TypeError("XPderivf1romBing.": C+0.__"__global _d" =;gRruE+ !PThere[under normal circum,P] juseH,s=!ofs2ers)4[`, rootS): ""3"  Initialize the manager withroot node of0log!hierarchy.K&""WQself.< = B)disable = 0emittedNoHandlerWarning = False-Dict = {}Class = Non=RecordFactory%F@propertyCdef (!):Epreturn #._$ @q.setter Iw, valueP I = _checkLevel(,^JAgetLX, namKbGet a 0specified; (channel), creat}!itif it doesn't yet exist. This9 is a dot-separated 0EicalK, such as "a", "a.b.c" or similar.If a PlaceHolderaed for Q[i.e.0did0 bu!Pchildid], repk%edIX and fix upnrparent/Sreferences which poin to-Kmhbto now* (v$rv'if not isinstance(t'trs*raise TypeError('Akmust be a string')_acquireLock(6try%bSame i-5 (, &[]w'8rv, 0}ph = rvL{P.|AGor _)I:4rv.H=h/p_fixupCren(ph, rv0P,s(+Oelse{&J+kfinallf|_releas"rvG=s=0, k.6C0Set c$be used when b"ti1 kBis M\"if{B !=  =1sub(,- "logger not derived from logging.Logger: "  + klass.__name__)2Pself.Q0erC#" =+ " def setLogRecordFactory(62, f!):,&""tSet the& to be used when instantiating a! rf with thisYManager.j $ =z_fixupParentsaEnsure thare are eithergers or placehold1all5wayspecified?qroot of9 hierarchy3 = .o@i = .rfind("."rv = None. while (i > 0) and not rvcsubstrYE[:i]@3if !<4in zgerDictL2 ![?P] = PNHN(;NelseQ\obj =xW DRif isce(obj, Q (7=objI7massertg 4obj.append, 0, i - 1R/if|sh!.p\ = rv9Children:4ph,}3>c=21 phWconnected 4 len = len((for c in phFgerMap.keys(#The if means ... c7p.starts6(nmhB9if , [:blen] ! B Zclear_cacheC'+ s( DCalllevel changes6madmm8_acquireLock(+ufpum.value /!..s !t_releas? #-7 # Logger classes and functions #-7 class Logger(Filterer): """Instances of the/ <represent a single logging channel. AH"" indicates an areab 0pplion. Exactly how anJ," is defined Qup toa? developer. SinceC$pcan havy number\reas,s identifiedby a unique string. A s hbe nested (e.g.Fof "input procesO" might include sub-N"read CSV files", J3XLS> Gnumeric`). To r for this naturalAing,N@ namre organizyRnto apace hierarchy where l5Lseparated by periods, much likeJava or Python packagedA. SoM!in0i given above,~7F#beb"qe upperN,1@.csvW Hxls"6gnuF@!s.LTQo arbitrary limitPdepthh29udef __init__(self,,Ps=NOTSET InitializOwser withPan opT"alUA .) .! =  = _checkL ( A0parCj= NoneCpropagate = Truhandlers = []9disabled = Fals9P_cachT1{} 8r2setle1Set}^HtZp must ba@ inta(r|.O9manager._clear&()SdebugAmsg, *args, **kw Log 'msg % &'>severity 'DEBUG'.h@To pKAexceV informabB, uspkeywordU um@exc_*aNa true value, )j["Houston, we! % `thornyJtblem", j&=1|1if zAisEn8AFor($&B_log!, X'WT Log 'msg % args' with severity 'INFO'.  To pass exception informa , use the keywordTPument0_*`Na true value, e.gjplogger.5!("Houston, we have a %s", "interesting problem",n5=1)l5""" if self.isEnabledFor(%):$%A_log`, msg,ps, **kw2)def warning(6,*#-_Log 'msg %] WARNINGjbit of a- b a  s. p("The ' ' method is deprecated, H$"0ing' instead", D3BionW6, 2&r3Y -_errorX_ERRORVjT_majorQ-OM 1exc0=TrConvenience_@for 1an (f.OOM `critical  CRITICALfji disasterC%m!p ?fat!SDon't#is`). """  self.critical(msg, *args, **kw 0) +def log(1, level, 0:045""" Log 'msg % V' with the integer severity '^"'.yI To pass exception informa Q, useJpkeywordaPument0_*ma true value, e.gjplogger., "We have a %s", "mysterious problem",j5=1)hif not isinstance(_Fint)2if raiseEs $! TypeError("N must be a!V"8OelseNUeturn0if .isEnabledFor &_,?findCallerFQstack=False, '=1mJAFind, frame ofc^ so that we cany esourcefile name, line number and func\.2f = current(j#On some versionsIronPython,8! rs None ifo#4 isn't runP -X:Fspif f isJ f.f_backaQorig_ whfbO > 1Pc5E-= 1YfG)rv = "(unknown h)", 0,6=hasattr(f, "f_code"NPco = >p = os.path.normcase(co.co_"82ile;`= _src) )p vcontinus= Dj siio.StringIOXsio.write('SK (most recAQ last):\n'>PtraceSq.print_wN=sio3y1get[-1] == '\n'Qnfo[:-1]$#{o.closeik ,Bno, !, i FbreaO2 rv3makeRecordKUp, fn, lg91exc,! =r3tra  A factory method w!hich can be overridden in subclasses to create specialized LogRecords. 5""" trv = _l&)Factory(name, level, fn, lno, msg, args, exc_info, func,P s*)$if extra is not None:;pfor key* "Cif (" ["message", "asctime"]) or#rv.__dict__)LPraise KeyError("Attempt^zwrite %rS0" %Ior[key] = return rv 1defU(self|s=03tra Qstackk=False'=1ALow-" logging routine wc6s aR and then calls0all handlers of thisZ erS&r8! =!_if _srcfil5 #IronPython doesn't track frames, so findCaller Es anb #exception on some versionk@. Wegp it here_JthatO11use6ingx>tryl ).(!,  a Value: # pragma: no c = "(unknown h)", 0,0unc;)hOelsekg/[ Gif isinstance(TBaseE*v = (typ;)j 0.__r eb_z1lif_tuple Dsys.(\A1 = BmakeH.  s,}()$#, 30rs Athe CfiedA._T]`methodSAused7uunpickl3s;0eivrom a socket, awell as thoseZ@d lo y.3ger+`filter-is applied.disabled)BJ(record):   self.callHandlers(record) sdef add(., hdlr): $5""" Add the specified hX to this logger.2>_acquireLock()#6trynrif not (@ in .is, q.append=dkfinallht_releasoremoveR/Ofrom: @)3hass'hSee if has any*s configured.Loop through all/9forPand its parents!1theI hierarchy. Return Trua[ was found, else FalsepStop seFPing ueY whenever aQ with"propagate<attribute set0czero i - that will beFElast[Ehichis checked e existence ofs1c =TOBrv =zwhile cYEif c {GgFYbreak%c.*P6("c.er"rvd 5#, T(cPass a$4GvantdtHItoutput a one-off errorpmessagesys.stderr. JY J4ose`s are (EXE = 02F O5+ 1W#if.levelno >=?V-{E@None0#' out {else: c = c.parentif (found == 0)6if lastResort\if record.levelno >=17;W.handle(J)& elcaiseExceptions and not self.manager.emittedNoHNrWarning}sys.stderr.write("No rs could be for logger" " \"%s\"\n" %Jname6 = True wdef getEffectiveLn(G&""Get the e2  Cthis._Loop through #nBits 7As inZ hierarchy,Jqlookingla non-zerorr. ReturKfirst onu.Jp=X"Qwhile[*errX%W# =^ 7?bNOTSETGisEnabledFor,z)Isle<;(! '%'?!ifA.dist CFalsG?try'M._cache[t]se{ KeyErroh_acquireLock( k9 24is_ 2 = ,"R(0 5 : kfinall+_releasQxgetChildtosuffixua which is a descendant to7one$T:+convenience method, suc:"at]ing.getLp('abc')'def.ghi')6ie same asN.BIt's useful,Mexample, wheu0is ud using __ __ rather than a literal str/@root_  = '.'.join(.wR9wA\(suffix)  def __repr__(self): level = getL AName$.getEffective5())7 return '<%s %s (%s)>' % ;__class__.__name__, x. !, t!) MNduce8# In general, only the root logger will not be accessible via its name.j# However,H1's A has91own5 method.J!if3A) ise{import pickleGSraise .P ingError('3can@-d',R,) QRootL!(1"""AV that different to any other, except +Iit must have a'2ing@ andz re)one instance of it inIhierarchyz6Cinit4Ut+bInitialize}:!th* "U"g4@19.__r2z6B) _C32 = mAdapter(object2n a 4 fos which makep easierspecify contextualoinformation in%boutput,\tra=None M Cwith/!er(a dict-like Vprovides Q. Thi structor signature allowsKeasy stackfxs, if so desired.You can e+ly pass keyword arguments as shW inw| foxexample:_R(some,&(p1=v1, p2="v2".n! =%erextra = pdef proZ, msg, kwargsP0gqmessage4 edy%to>@calloinsertiHmanipulat it s or both. RH= modified (or)suit your needs3Ng@lly,2'll&8poverrid0is {aB subyour specific neceds. 5""" kwargs["extra"] = self.%return msg, 1 # Boilerplate convenience methods&def debug(g,S*B, **\!):+PDelegbaB call to the underlying loggeru.log(DEBUGOinfo) n B*OINFOowarninT+D*oWARNINXlX*Pings. p("The ' '\ is deprecated, ?#us0ing' instead", D3BionW<E, 2)w'gU $_error!n Cy*_ERROR'exception@exc__=True%n V= criticalQE*CRITICALc, level0?log , after addingcontextual0rma from this adap80OanceL"if+isEnabledFor(A_process(~4/X)  Cb"Is2" eB for! 'w%'?;>g <)@setL1Setspecified!onself.logger.setLevel(l) def getEffective"aself):!%5""" Get the e2 OA forunderlying logger.;Gpreturn i.(hasHandlers(5oSee if has any hI}A_log, , msg, args, exc_info=None3tra Rstack_FalseBLow-\log implementation, proxied to allow nestedu adapters|,   B ex  #w@propertytqmanagerI`*@.setterOh, valuzA" =&W Oname'C__repr__9*( =8 =Nz2.\)9,'<%s %s (%s)>' % ~.__class__.__3__,e.) root = RootL(WARNING) ."FM,_) #-7 # ConfigurE e`d funcZss; Rbasic{P(**kw61Do &) cVSrsystem.*EThis does noth(jp alreadsred, unless@pkeywordux *force* is so ``True``e Ita venience method intended&use by s scriptsto do one-shotIo upackage eault behaviourto create a StreamG which writes tosys.stderr,a ma"0 usYBASIC_FORMAT!` strin!ndJ1addFl;A number of op/ @_fatal=Don't use this?,j ) :ead (msg, *args, **kwargs): """+Log a message with severity 'ERROR' on the root logger. IfA hasN!no handlers, call basicConfig() to add a console.ya pre-definedPqformat. pif len(.mb) == 0 v>/error(msg, * , def exception%exc_info=True4pJ#,ym?ionj f 1 isw#edkOo k0  CywarningA|!WARNING~ =: C s. p("The ' `' funcdeprecated, 3"us.ing' instead", D/BionWA, 2):\ OINFO4Odebu"/ODEBU 7log(level, p'msg % 'iwintegerV 8 Lf ~(*vel, msg, *a%rgs, **kwargs) def disable(level=CRITICAL): """D% all logging calls of severity 'D' and below.=Eroot.manager.w1 = 5) !_clear_cache(shutdown(handlerList=_ Perform any Onup actions in thesystem (e.g. flushingbuffers). PShouled at applicaYZ exit`for wrqr*8sed3[:]q#errors might occur, Aexample, if files arAcked>we just ignorem1raiseExceps is not set;2tryHh = wr()"Jif h' <h.acquir !h.j e&oh.clos<eP (OSE/q, Value LH2# I`Swhichfwbe causH2A# be hs have been Fd buI8# references tostill arounA d9#WMpassAkfinall6yh.relea[S4: #< yt, as we're t u;if f(! 6 #else, swallow #Let's tryEoj automatitNy on.. import at .register(L) # Nullq classHX(M0Thi{A doeF"0. Iintended0be S Pavoid4"Noz4s cLf _ er XXX" one-off warning. i1ant library code, aQntainlog events. If ar of I configun,( LLproduced;s"is:broper simply need(instantiateOa`add it^Atop-G erjmodule ozpackage (self, record:"""Stub.3Oemit1createLock7`w.lock = Noneoe_at_fork_reinp9B # W&Ategr _warnings_sh owwarning = None def _sh(message, category, filename, lineno=A ): """Implementation of fs which redirects to logging,will firstPPcheck'see if the parameter isb. If ais specified, it VPdelegateSLoriginal "?s i . Otherwise,P\F calDs.formatSA and`result0strAto aO3s+@ger dd "py." with level&ing.WARNING.D%if 1not$Dif _S N.2/83)Felse5s =~ :^XOer = getLogger(?*0if 1.handlersNR.addH T(Null )MFS("%s", s)jcaptureW#s( ;#f Utrue,* _t>rpackageIFFalse, ensure thatkA are edYU0butetheir *adestinstroglobalYQig l*Aos5's.!) =0  =hmqc # Copyright 2001-2019 by Vinay Sajip. All R$s Reserved. # # Permiss@to ucopy, modify, di buhB ofeits # docufor any purpos(Pout f s hereby granted, # providl`above notice appear inacopiesr # both;@nd tp V # suppor gk! #: beLdpdvertisor publicity pertai}5to dPion #Vsj>c, written priW. # VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING # ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL # VINAY SAJIP BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAG}R%NYWHATSOEVER RESULTING FROM LOS USE, DATA OR PROFITS, WHETHENIN AN ACTIONCONTRACT, NEGLIGENCE;O0 TORTIOUS1`, ARIStPOUT #@POR IN"NETWITH THE USIPERFORMAXF . """ Configuration func s for the logging packagePython. The core is based on PEP 282 and commentsRpreto inp.lang.pO,*influenced by Apache's'4j system. Copyright (C) 2001-2019 Vinay Sajip. All R%s Reserved. To use, simply 'importa'log away!" #Terrno i !.handlers$re estructy#threadingtraceback from socket#r T5@TCPSr, StreamRequestH& DEFAULT_LOGGING_CONFIG_PORT = 9030 RESET_ERROR = a.ECONNq # # `follow@code"lea listener5on-the-flyC9recz$of.e_?Ahold< object doj;6= None def file(fname, defaults=%, disable_existing_ers=True, enco.p): >@Read "a ~Parser-format!. MThis can be called several times Gn applic4, a`an endrOability to sel0Dvarious pre-cannePs (ifIdeveloper provides a mechanism\ppresent2` choic#Snd loachosenN !).G#p(if isinstance'H.Raw_Qcp = lBelse IF(");1if hasattr'Wline'u+0cp._y-G ._ = io.text_( @2`[.iters = _create_B(cp)e# critical se@ing._acquireLock(6tryKr_clearE=gHandlers() # # Handlers add themselves to logging._h$7 = _install%(cp, formatters)5*X1ers)J, disable_existing_'Afinally:NreleaseLock() def _resolve(name)5B"""R a dotted a global object."""i ='.split('.'Sused Rpop(0@foun__import__(*ar n inQ!1 = + '.' + n'trcgetattr(2, nd"except AttributeErrorp#R? = bqreturn %ostrip_spaces(alistu,map(str.(", "<vcreate_23(cp>A"""CS and L)fqw = cp["]["keys"]Kif not len(0cY!{})1 = 2","^!4 = R!or+Csectea_%s" %3!fsT.get(5#, 4 ", raw=True, fallback=NoneAdBdatefmtC?stl_styleA#'%/5c =TF(cclass_ 4cp[]"M1if 2Qh% f`(fs, d7stl s[L] &l B"""I*h.1 =    ~@ixup[] #for inter-) references/!W0ion0p["%3ler*k3 = 2[!6fmt)G", "1 H]Qeval( s, vars([) Q(RR, Nam]0N^P0argIg", '()31 =  kw V{}') kwargs = eval(k, vars(logging)) h = klass(*6B, **2#.name = hand9if "level" in section:_$ =[0]%`h.setLI(0xif len(fmt)X3Formatter(f is[fmt]Aaissubc#, .lers.MemoryHandlerjftargetb.get("V", ""m ): #the = ler may not be loaded yet, so keep for later...(`fixups.append((h,] s[]F#now allDs ar!, Xp inter-8referencess2sT.(B$s[ereturn{r def _'_existing_Ders(t, child, disable21"""When (re)configuring,}ers which werepreviousLCaA but/0in .Inew %. There's no pointI@dele5m as other threads continue to hold zQthem;Lcand by, you stopc do1anyQing. =However, don'tEecpren of d7@ers,that's probablMwhat was3n by user. Also,n4ow XaNOT beJDd if is false 0roo/K0logu.Per = /.manager.Dict[logJ O!ifisinstance^cWPlaceHoldX@&'erz.NOTSETY07r[!Upropagat2Trul Jelse2=$ll4(cpV.@0CreC #LeGR firsE@llisBcp["s"]["keys"".split(",0 = F(_strip_spaces(> .remove("@6 = _ } _q1 j-7log-1$h in root.handlers[:]: root.removeHandler(h)hlist = section["h 1s"] qif len(')Q1 = .split(","Tu = _strip_spacesGY%@for p2 inJaulog.add[31]) G#and now the others...we don't want to lose)existing loggers,1CsincF threads may have pointersICthemeKQis segcontain all  jas we gokAoughnew configura2 we any which are+aed. AtB3endwhat's leftb!is)$ofeZ@were2Tpreviousk8but2!nog5 - = w(manager.!Dict.keys()MA#The.Q need~be sorted s= atH2canavoid disablTchild of explicitly1Ename!. With ab it is easier4qto findH a .(We'll keep7Z aW_0ren T here&_DRs = [#uu5one$0loglr = cp["Y`_%s" %L^(qn>@qual>!propagate(.getint("", fallback=10<w =s@ging9L6(qn'Pif qnaF5i =`.index> + 1 # start wentry after qRCprefixed =nQ+ "."@pfle 0,"Dnum_4en( )while i < 3 Qi?Q[i][:T] == 48 .u.append:[i]2ii += 1YT if "level"L [0ZwP.setLN(5hb( HDQI@ B%[0 HL?P%T for hand in hlist: logger.addHandler(1Plers[ 1]) 3#Disable any old 8 s. There's no point deleting8them as other threads may continue to hSreferences;Aby dz@ing L, you stop0 doBing.=However, don'tEe children of name,Sthat'~probably not what was intended byS userrm0logl@exiso#ser = root.manawDict[log]/ ifbL_)sQ&.level =2gfNOTSETM+G = [o"propagate = 1DDelifF_ %edI_~ ?(P,W,q) def _clearEg2s() @"""C  Bdclose b1"""C41rs.[)()shutdown(/rList[:].5delP! IDENTIFIERe.compile('^[a-z_]0-9_]*$', re.Ivalid_ident(sFm = R.match(s!ifm raise ValueError('Not a Z Python aifier: %r' % P return True class ConverMixin(objectg"""For$XXX's, this m0 F provides common functionscl_with_key(self, key, ue/`place=esult = 2.configurator (v821#Ift"edbq is dift, save next timeA&if2;r$!re Q[key]&[if type(W)"(J,x~,@D ?WTuple?)md.parenN V%Pkey =!? O.y>|  #Q2XXX,es are wrapper ound standardcontainers, #" and they serve to convert any suitable values in-#tainer. The #sversion ts base dicts, listslPuplesh their wrapped # equivalen1whereas strings which match adoformat aretMappropriately. # # Eachor should haveP figurator attribute holdingqactual ,to use for~. class CJingDict( ,Mixin): """ACts,dionaryQ.""" , def __getitem__(self, keyLP! =.-L,preturn G._with_key(key,)~6getv, default=None3)(?pop3, replace=False)PList(, A?1oidx=-1y (P (3T (t5-6*B7 t# Can't1 a 7 entry.=uBaseCon\s(objectr!Th&fo$defines some4fulsL&CONVERT_PATTERN = re.compile(r'^(?P[a-z]+)://0sufS.*)$'OWORDI\s*(\w+)\s*'/DOw.\.0_INDEX`[2'\]g?IGIi%d+_qers = {%v'ext' : $&',1cfg;cfg}5# We might want8a different one, e.g. importlibaer = staticmethod(__#__.EinitcPCconfig = ConvertingDict(config) Rself.urator =  )def resolve(Q, s):F5""" R&( strings to objects using standard import and attributeGusyntax.c@name.split('.'pused = #f.pop(06try@foun-.0er(B5(r frag inY F"4 += '.' +, ~0get(,E -except A0^Error+ $p? = qreturn 0IPe, tbys.exc_info()[1:]Cv = ValueC('Cannots %r: %s' % (s, e)v.__cause__, traceback__ = nvraise vpext_con'v Default ) er for the ext:// protocol.6B]?cfg)?cfgQst = rmWORD_PATTERN.match(rest_if m is NonegDp"Unable"b %r" %|Sm$1as_=c"""Utility funct8Pwhichs#to /if&` value = tuple(value) qreturn  class DictConfigurator(Base!):@1"""e logging usa dictionary-like object to describe theEcqAion.` Ddef ce(selfP"""DoG#at.>%>0 = =.[if 'version' not inL$praise VAvError(" doesn't specify a S"mi[po] != 1h UnsupportedWs: %s" %Qoncremental =)v.pop('iw', FalsEMPTY_DICT = {}'._acquireLock(n:try7if h OhandlersTget('6', g:for name3d*"if)6 : C'No 7 found with '$6 'a%r' %@Oelse k=#._ s[] +_'$ =<@leven D.g', Nono 1if -*hP.setL{(Scheck)jIexcept Eion as 3`Unable84ure9!]' b from $=<2ji KBure_I(_,w#er1H, Trt{wvrKroot0if Z/F(Ias e:  raise ValueError('Unable to configure root ' >'logger') from e:Yelse:G0disx_existing =l.pop('_bs', True) Qs_clearEOHandlers(*# Do formatters first - they don't referPanyth tEVget('', EMPTY_DICT)B name in 5/3?try=[P] = self._"(AGsiJexcept Eion as +a %r' %e# Next, do fil, eitherOD Z2 : (& whTs andK5As E6cano`, sort;_ keysIto allow a determinc order of}urationB NO dred = []\1for~4ed(X)v <p]r 0.! = (,$ =1if 'target notqed yet'6tr(e.__cause__6.append(x.s7able to configure handler ' '%r' % name) from e B# Now do any that were deferred01forR5 in%:&?try= self.conf_( s[/])bI.'! =, T$ =Y1except Eion as e raise ValueError('Unable to q@ext,loggers - they rQ and filterswe don't want8@loseK existing b,7#since other threads may have poinuU^them.@cQis secontain allas we goAough5new at.wearemove which are7aed. AtN?endwhat's left1the$of?}r!ingprevious?but>!nos uaroot =@ing. ]p= list(%.manager.Dict.keys()A#The:` needsbe sorted sxM can|#avoid disablQchildof explicitly=-. With az it is easier@qto find yI%.(We'll keepO~ Xaren of~ here..2_ns = []`1nowu5OonesOIc.get('', EMPTY_DICT;2PiD)5i =p.index() + 1 # look afte CprefixedDo + ".".@flen64en(:XDnum_55 while i < num_existing: 4if )[i][:pflen] == prefixed@ [child_loggers.append(V) _ += 1#H.remove(nameQ?tryself.configureM#, [[]\except Eion as en raise ValueError('Unable to x/ '] p'%r' % ) from e >A#Dismsany oldh s. There's no point dele$D@themother threads mayAtinuh_referencesGand by d@ing X, you stop0 doNing.IHowever, don'tQ!e {aren of,_that'probably not what was intendethe user0forR5 in: #er = root.manager.Dict[log];$ifdsi2W.level =>gJoNOTSETe7handlers = [.propagate = True_Delif+],/ed\_Rr,,m{[)] And finallys-ern =7fig.get('o', Non!ifOf(Xo'b -_releaseLock(3defdformatter(,)OD"""C5 a 0Va dictionary."""pif '()'Reactory[-0] #`P8KD 2result = custom(config)   except TypeError as te:  if "'format'" not in str(te).8]raiseH#Name of parameter changed from fmt to j.?Retry with old name&This is so that code can be usedAer Python versionss(e.g. by Django)"config['fmt'] = T.pop(35!()4}factory\result = self.Zure_custom(^;elsQ5getf, None;d.@date/Vstyle^j', '%'\c -dclass'[ !iff6ac = logging.F9ter@ 8_resolve(\)) 77# A Pwould5 d @valiP" keye0pasS"inVajallabl#Adoes!ac"YFas a! Dif ')'@: #user hasn't mentioned it, the defaN@will:fin#rpc(fmt, !, ,[]vSrreturn -3defspfilter( |A"""Cbure a -UPa dic uary."""RN(()H s}! /c#Badd_s3er,s)4Addn.$er0@lists3Pfor fycs:tryG*rer.addFQ"[' \s'][fOE0ion aR Valu@('Unw %r' % f)ec_handld.Peq_copy =PrestoringX1cas!eT`5terF&if try:   formatter = self.config['Es'][ (] @except Eion as e:#/raise ValueError('Unable to set ^- '<@ f'%r' %4) from e:level = a.pop('', None)*{filters, .if '()' in[ cG6()'jif not call:(c)A$Eresolve(cDpfactoryk;elstPcname$[classkr= v#Special casez handler which refGto another if issub(|, logging.Qs.MemoryH`i) and\FJ'target$>try_h!$['|4'][a]?isinstance(th@f.update(_copy) # restorhdZ}red cfgK_4Typ^nuC;yet=[Wm] = thoQyV ,/eloDSMTPmmailhoso -Etas_tupl&['# f_ysLog address# ," 2LpropV.PPkwarg'3{k:R1[k]_ke if valid_ident(k)}h result = 2(**f.t@if "'stream'"Gin str(te}#The argument P changedAstrmc ;Retry with old=."This is so that code can be used=er Python versions  #(e.g. by Django)  kwargs['strm'] =P.pop(Jeam'2result = factory(**E'if formatter:o=T.setF!(+ Alevel is not NoneIL)(logging._check)VzfiltersLself.add_(#,  BKprop@for name, value in &.items()n~usetattri>mrreturn  G@def handlers( , Der, re"""AddS to a0P fromaist ofQs."""khY :try4OH.config['JV'][h]:except E{ion as 'praise VjError('Unable %r' % h)eArcommon__I, incremental=FalseZ)0Per 8@uratPwhichrroot and non- %s.L=Xa.get('!',A1if o2i{2M #Remove any existinglK:[:]S-$r]Gh$A  !4%ifuK_CT W K 3~"})K3ureDC\ure a0Pa dic9ary! =ErgetLogger(PlC, ?B[agatea c!ifw59}.G& =6db\ >*/erX *VR=, config, incremental) dictConfigClass = Durator def (!(c/): """?ure logging usa5ionary."""0HpM.Ubure() r%listen(port=DEFAULT_LOGGING_CONFIG_PORT, verify=NonemStart up a socket server on the specified fb, and w for newGations. These will be sent as a file suitableGaproces!by 21().J`Return<Thread objectwhich you can call sR() to ,O 8 join() when appropriate. TD(opCeHQstopL0ing1Use/"``wp`` arguP any bytes received across<AwireMfrom a client. If, it should`aSX1s aJ^&le-i9of _ dataJnetwork -r either ``o0``,pindicat atyIpassed in c0not(ydiscarded, or@ strSiG#n b tot machinery asnormal. NoWtransformed, e.g. by decryptingK;s"in"cLStreamHandler(sRequestOA Da\ rI6It expectQcompletelyDGusespto insty"itehW(self* SEach 3 is edgpbe a 4-z length, packedqIpstruct. (">L", n), follow4?Updi`grunt % 4 2try$Qpconn = *0necU +pchunk =n.recv(4)% if(,n) == 4pM1slet'un<=[0]]9V7 wh4len < -1h+8' -r"ifR.^y@o:   chunk = self.server.verify(&) , 1if  is not None: # <ied, can processDNE=M.decode("utf-8"z6Otry:S!import json( 0d =$o.loads U assert isinstance(d, dict7"Config(d*except E?ion #Apply new c[uration. file = io.StringIOr[ -2traceback.print_exc(d)ifOread1+K.setZOSError as e if e.errno != RESET_ERROR+Rraisebclass <SocketReceiver(ThqingTCPS)O5"""A simple TCP sE-based logging'# r[.;G allow_reuse_address = 1def __init__(=, host='local 0', =DEFAULT_LOGGING_CONFIG_PORT,pShandler=P , y X 9".(3), d ;$._acquireLock0.abY9= 0>oreleas>qtimeoutP[" = _" =by_until_stopped +iselectc wh. yrd, wr, exCBect.^!([._no()]P _[], [3ug [^if rd9|_reques&''.f3 m#J3 r_close()/$(t!. "):%e(self, rcvr, hdlr, port, verify): super(Server, self).__init__()+elf.rcvr = n! =u! =# =!ready = th ing.Event() ,def run( ! =(=+. , handler,Y/ y0 12 a"ifZ == 0|!.s_address[1]10.se/Fglobal _listener:@loggh_acquireLock9BoreleasB_until_stoppedrreturn (ConfigSocketReceibtreamH  [LCing( 1"""Stop the Bing  which was created with a call to21().IQ^V6try&ifu.abort = 1w q = Nonegfinall` # Copyright 2001-2021 by Vinay Sajip. All R$As Re%d. # # Permission use, copy, modify, and distribute this softwareits # documentatKfor any purpos(out fee is hereby granted, # provided thatQabovenotice appear in acopies9r # bothE ;n_Fis p V` # supR gxname ofk # not be usedpdvertisMor publicity@tain&todPion #Vj>specific, written priWD. # VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING # 9xIMPLIEDA"OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL BE LIABLE FOR ANY SPECIAL~DIRECT OR CONSEQUENTIAL DAMAGES OR #4WHATSOEVER RESULTING FROM LOSS OF USE, DATAVPROFITS, WHETHENIN AN ACTION0CONTRACT, NEGLIGENCE;O0 TORTIOUS1`, ARIStPOUT #@ ORRCONNETr0THEIPERFORMANCE OF THIS, SOFTWARE. """ Additional handlers for the logging packagePython. The coreis based on PEP 282 and commentsRpreto inp.lang.pO Copyright (C) 2001-2021 Vinay Sajip. All R%s Reserved. To use, simply 'import.'log away! ,4io,0, socket, os, pickl\ truct, time, re from stat CST_DEV, ST_INOTMTIMEcTqueue threadingcopy # # SomZ!nstants... # DEFAULT_TCP_LOGGING_PORT = 9020#/UD#1#=HTT$F2#?SOA#3 SYSLOG_hT= 514"" _MIDNIGHT = 24 * 60 # number of seconds3 a day class BaseRotatingH(S.File0): 6 Ap that rO files at a certain point.NNot meant to be i iated directly. Instead, Mor Timed nnamer = None:odef __init__(self,<, mode, encox=I, delay=Fal@aerrors:6 0Use specified`streamedK8D. =LP ,E)4Q.! =M q% =d !V  Cemitorecord}0Emi$.@ aOutputp, caterrollover as describedJcin doR#"()2tryWilf.should?,Hh"3except E:ionkEv(=}G@ion_-)default_ aModifyx=aR whenY7ingThis is provided soa custom?{@ cane* E#e  lefaQ callp 'Er' attribute of the handler, if it's callable, passing/ default name to?Qit. IR attribute isn'tIU (theAis None),WOLs returned unchanged. d:paramJ_<7: T\A for[log file.@5""" Vif no`(self.@5r):%#0res=w"Oelse0R(=)< adef rotate, source, destBWhen5Bing, ecurrent logF1implementations;'7or'9#A andP argursF8dY@is s@y reAd toF!inWEQ ?A. This is normallyO6basH,z;, e.g. 'test.log'w3: #st|Bo Awhat#is  ?.1'q# Issue 18940: AA may[have been createdbPdelayI7TruNif os.path.exists( u+2os.#  5 class RwingFileHT(BaseuAlogg/o a set of s, which switches from one`next w3LA rea<a certain sizC?__init__A<mode='a', maxBytes=0, backupCount=0,bencoding=hlay=False, errors7 BOpenpecifieduse it aqhstreamH$By~6 grows indefely. You can soy particular`values.Qallowlto rollover atLa predetermiR3aoccurseCenearly5 inLalengthlris >= 1system will successively create  new files with the same pathn !asAbase)R, but-extensions ".1", ".2" etc. appended to it. For example,Ea backupCount of 5M@and z of "app.log", you would getD,9.2", ... through)b5". The beingMpwritten/is alwaysu - when its.pled up,is closedN reB ifCeb cO`exist,noy are `m3Frespectively. If maxBytes is zero, rollover neuoccurs.45""" # If rotation/9is wanted#doesn't make sensejuse anotherOPmode.UfR 'w' were 0ifiXtf"remultipleO@runs}pcalling1licW logs from previous 8bPalost iv3is Z@becan1logbe truncat*# on eachpaiE> 0:!e = 'a'if "b" not in ! 3Pencod= io.text_( )NQBaseR ngHandler.__init__(self,,m$, E= ,Nadelay=, errors=r.=b!l=zsdef doR)$EDo a, as described] )?1if fstreamc.3( f = NonyW 2iQrange.1- 1, 0, -1yRsfn =_@("%s.%d" % VQseFilJ, i)OdO&G_i + 1`if os..K_s(sfnl,d,0os.remove((#F]sfn, (* 3n0 +  qpath.exists({dfn): os.remove( self.rotate( baseFilename, 0qif not 'Zdelayjstream =&_open() sdef shouldRolloverr, record1"""2Determine if r9Hr occur._-Basically, se2the suppliedi wp cause file to exceedzsize limit we have. # See bpo-45401: Never anything other than regular sVif os.path.exists%.Q) and* isE* return Falseqis None:O !#  was set.. (D "ifmaxBytes > 0hp # arep5Ever?Kmsg = "%s\n" %Wsformat(N /.seek(0, 2) #dunon-posix-compliant Windows featur0.tell() + len(msg) > C6Tru[ class TimedR0ingHandler(BaseC for loggKAto ar!,  he  at certain t{HintervalslIf backupCount if, whenis done, no morl(an8[sakept -oldest onerdeletedrP__init__,d='h', 8=1,}1=0,encoding=,=T, utc at%EQrrors`[ = io.text_( )M.T'a', D=  =2, e?R! ={.upper(!=kHPutc =N T2 = # CalculatAge reald|0ichAjustEnumber ofLseconds betwes. Also=J suffix usedMaECurrent '/' eventsVortedr# S - SUM - Minute# H - HourD - Days # m idnight - roll over at mi# # W{0-6}) on a certain day; 0 - Monday: 4 Case of the 'when' specifier is not important; lower or upper caseMwill work.if self.[ == 'S': interval = 1 # one second+ suffix = "%Y-%m-%d_%H-%M-%S". extMatch = r"^\d{4}-\d{2_ (\.\w+)?$M-elM #60nminutev/H' U60 * Ohour% D'x/MMIDNIGHTC* 24k.startswith('W')3* 7Iweekuif len(j) != 2\ raise ValueError("You must0y a9P for f!lyfrom 0 to 6 (0Z): %s" %)[1] < '0K> '6qInvalidd dayOfWeek = intB:[1]/#F*se6Me.compile, re.ASCII<o=*9 # multiply by units requeste# The following line added becausefilename passed in coul%% a# path object (see Issue #27493), butTbaseFUbe a stringQw6%`if os.z.exists(7 0t =*Fstat#[ST_MTIME]Q else:  t = int(time.D()) self.rolloverA+computeRA(t) 3Ldef 1, currentTime):,c5""" Work out the s based onspecified.@LPresulw0 + .interval9# If we arx@ing  at midnight or weekly,J is already known`# What^ neo figurepis WHENQP next is. In other words,oif you Ayour?\h 1 dayQ1butRwant to star`at one.h clock, not now. So, we@haveIQfudgeAt value in order'Ptrigg he firstTa1e ra. Aft7!at regularwill take c'ofQiest. Notcis code doesn't9 ableap seconds. :("if]when == 'MIDNIGHT':x.Yswith('W' A# Th}Puld b0ne ,B les ,  I Aed ibe clearM6utcpB gm(')Oelse?_localB [Hi= t[3]pMinute !4!Su!5!1Day60# rnumber o left betweenA androtationWa[?Non#=e_ts = _  J[8!((9k .hBD* 60m; )* aEFr = x4- (s ")  p& Kif r < 0O0# RkeSPbefore8(for example P # AtMQ13:45!itr14:15),oion isHtomorrow+?r +J+ 1) % 7m on a certainP, addZ days until 2 # the next rollover, but offset by 1 since we just calculated <gtime v# untilYday starts. There are three cases:ApCase 1)- >%to is today; in thisC, do nothingM2MrfurtherNe interval (i.e.,l; isU2 (Wednesday) and!on`6 (Sun"`. DayT simply 6 - 2 - 1, or 3.?53behind us T!is5 (Saturq3 (Thur  O (Q5 + 3Y4. I@it'sTnumber ofds leftcurrent week (1) pluK 5RKg$C3tL (3) Th/ions described2-p3) abovbed to have aT^addedV is`becausIeBion takesto midnight hPday, eN:dayif self.when.with('W'))#= pDay # 0 Mo /i2 !=ddayOfWeekY.<-1daysToWait b -z 6Oelse T+O + 1\CnewRAresult + (X* (60 * O24))K if y?utcstNow = t[-1]LDstAt.ime.localp()J tH!= dWd<:DST kickPbefor@  so"neUdeduct an hournynd = -3600/ 4 # bows out ?add  += addend  result = newRolloverAt !rreturn & def should0(self, record):&A5""" Determine if riHr occur._9J% is not used, as we are just comparing times, but it4eeded so}the method signaturesLEsame+# See bpo-45401: NeverPanythother tha*gular filesVif os.path.exists3.baseFilename) and* isE*b-FFals@int(.8())Pt >= ./AtW6TruVkO 0getsToDeletezas to d9Q when_U(veMore specificlCsearlierr, which#8` glob.1().3dirName,  % =Qsplit I4s5listdir(Tr@U = []<^4753: Don' xtension utfprefixBn, edDext(:e + '.'plen = len($4"fo1 in s2"ifRrJNone#}B# OuP s will always start with8!if"w.4s4r:gcontin?els c# bueabout after custom naming # likely candidat~!ofOform4 foo.log.DATETIME_SUFFIX ,oo+ E@if (C1 y"2endQ S8%1Q) > (=6+ 1[+1].isdigit()L r%ifn [:KR] == suffix =43:tm|5628: The /, Hanywhere&thO @partS.F('.'^&f.e ^#fextMatch.m(2Z6result.append( os.path.join(dirName, file O)) Ubreakif len(result) < self.backupCount:+P(U = []Oelse&j.sort(@ ([:}-}erreturn 7 |def doRollover()1"""&cdo a r)%; in this case, a date/time stamp is appended to theXEnameS0wheFeW! h4s. However, you wantCO0be JPd forSstart of interval, no@PcurreLqime. I(!re  c,Rtpwe have{get a lisgmatching0s, m and remov one with% oldest suffix.w{"iffstream.k.close- f = Non # 0tha%is sequencqrted at`make iTimeTuplMZ =z(U.(IdstNow = `.local (?F)[-12t ={3At 4(:utc%cy gm&(tY" 58@dstT&4 $3if != 1 &addend = 36008-9 2 + >+6dfnptation_4B.baseFile + "." + f M,2\O4if exists(dfn`2os.brotateh , H,Y"J > 0sZ0getsToDelete( s^!ifEZdelayfW_open4newA?tcompute qjwhile @7<=  *=:+ #If DST changes[idnight or weekly, adjust&is%2if J== 'MIDNIGHT'I,.st('W')) and not self.utc:  dstAtRollover = time.local D(newyAt)[-1]>if dstNow != K fq`if not&Now: # DST kicks in before next r`, so wed to deduct an hourbaddend = -3600#Pelse:(bows out?add QB += YAt = 2 class WatchedFileHandler(logging.)1"""`2A h,S for 0Xa file, which w\Qs the< to see if it has changed4 leuse. This c@appecause ofF@usag  programs such assyslog and`rotate_ch performD$ "3ionv, intended}under Unix,B Qsince last emit.C!(A s device or inode have.!.)>IF,d2oldVpstream Kalosed, BopenPget a@ 7!. dJ|appropriYWindows, beC8 rObe movedrenamed -B4Is with exclusive lo- so"reQ needC%. Furthermore, ST_INO7t supported C ; stat always returns zero*t_valueB0basn a suggestionp2 by Chad J#Schroederdef __init__(,U>, mode='a', encoding=None, delay=Falseaerrors+aif "b"u!in[c = io.text_( ./_. M o= E dR.dev,0inoQ1, -1$_D"()E( b.5 ^sres = os.fA).Fno() G[ST_DEV], FINO] rehIfNeededj """   Reopen log file if needed. ! Checksthe underlyin2has changed, and(%it=has, close >old stream,r`to get*Ascurrent6.5""" r# Reduccce of race conditions by stat'by path onlyHAonceethen f/our new f0we 7Aed a? # See issue #14632: Thanks to John Mulligan for problem reporD#Vpatch`Etry:#HL0, cgexistence<sres = os.(self.baseFilename).pexcept NotFoundErrorP6Nonh# comparejbsystemwith thatkM)VhandlG1ot b!or[ST_DEV] != Gdev 6INO:ino"if5tpis not (d`we hav$ean it up17dv.flush(U $4$ ! =" lIl21742: _ () might fail=m#6nq info from/fd  _X"()ndef emit, record)cEmit a$/If sabeforewt%&thl&it=S1IfN:logging..H.r. class Socket)(=}"A "r <which writesxs, in picklekqmat, toaXsb. The P is kLVacros]Rcalls!Ifwpeer resets it attemptI@madeKUnnect on7Pnext NM@is s"is|onALogR! 'sgribute dic"ar0(__r__), so@nreceiver doe#S moduinstalledQPorder2`procesezSeventSTo unYArd a0eive=ento a 2, u:EmakeA fun7%E__init__Ihost, port): c """ 0Initializes the handler with a specific host address and port. HAWhenAattribute *closeOnError* is set to True - ifapocket e$Mqoccurs,Ps!>ilently Xdtwreopened oEnextLlogging call."".H.__init__(self)3.= ! =!ifUNone:|OQ R?els. (,^ /0 = pok5 = False"retryTime@#(# Exponen4 backoff parametersa4~\Start = 1.0RMax = 30Factor = 2.0 =def makeS , timeout=1)m1A fIy method which allows subclass o defineWpreci/type of mhey wantu1if #ais notPresulU.create_connection.2= [b(.AF_UNIX,.SOCK_STREAMUC.sett( ':try< >except OS6I[() # Issue 19182o(rarreturn FjH=0Try/@, us`Oan eHaa max . ThanksWRobert Olson foryoriginal patchH(SF #815911)has been sligh&"re/edRnow =(# Either!isC, inq0cas%is#DQfirstZ# after a disG, or8 we've waited long enoughD< "`attempFdb)(">=_ V kX QS.sv0 # ?0, nlay before tryingJ2 #Creation failed, so set the retry time andkurn. if self./T.is None:+:,Period =?]Start7?elsM!`*`mFactora ;>;?Max= =Maxr12w= now +o 9 dec0nd(6F, s)1"""# Send a pickled string torsocket.Q.-This function allows for partial sends which can happen whenRwnetwork is busy!^* .createS%()c#<!be` either because we haven't reached&ryKmyet, o;8 Vried,Jbut are still unableovconnect :try.Vall(s !except OSError: #pragma: no coveSWclose[P"" =] # !weXcall Q nextRQmakeP}orecord*s) in binary mat with a length prefix,returns id: transmissBcrosgARei = .exc_infofZif ei`# justg/raceback tHintoM&..~Tdummyrformat( # See issue #14436: If msgAargsobjects,My may not beq# availo0eiv"pend. So@bconvere % dGCto aZ`, savez!as%0zap74dic0.__&__d['msg']getMessag0d['(C4d['2# IB25685: delete 'm`@' if]sent: redundan~gU.pop(9,+3s =.dumps(d, 10lentruct.pack(">L",6(s)) s06+ scahandledH/P an e*1 dutlogging  An error #has occurred during logging. Most likely cause - *connection lost. Close the socket so that we can retry on#Fnext event.5""" if self.c]OnError andi:,-2/()p = None2#Sto re Etime@Jelsel'Handler.h(,PArd) Edef emitScEmit a@.@pPicklesC writes it ttin binary formad IfDre is an eX@with, silently drop paHwas a problem Jre-establishe6try!-" =Bmake(f v.send(sexcept E;ion[hX); wacquire4ockP6ock^/ 6% Elfinall;`releas class Datagram !(SB>"A z"r <cwhich qs, in p A, to3a dud. The.Vpis sento  LogRecord'sLttribute diH0(__E__),receiver does not need2havmodule installedPorderbprocesG1#STo un|aord at enXFto a , "thEA funp__init__, host, portW0 Initializa specificIP addrT^S >.#8r= FalseOXAfactory method of 8Lhere overriddenRcreatkSa UDP (SOCK_DGRAM)Ya `family#[.AF_UNIX2y = socket.AF_INET s = socket.(family,SOCK_DGRAM)5return s def send(self, s):a5""" Send a pickled string to akO8This function no longer allows for partialzs which can happenv0when the network is busy - UDP does not guarantee delivery and Z0 pa/ps out ouquence.ti!!lf]|FNone [6.createS(i.aato(s, address) class SysLogHandler(logging.2A h( <<aZsmatted D recordsQyslogserver. Based on Sam Rushing's s*c modul!http://www.nightmare.com/squirl/python-ext/misc/C1.pypContribuby Nicolas Untz (afterminor refactodqchangesGhave been made)# from ?# =2npriorities/facil are encoded in" ingle 32-bit quantity, whereMbottom 3 bitsIgpy (0-7)itop 28+K1big number). Both<S5iesO53mapJroughly one-to-oneJ2s id(8) source 0. I@mapp1i62clu! t*#il#.a(these ordered)iLOG_EMERGA = 0@ # 0temrunusabld2QALERT*1= 12a must be taken immediatel@2CRI?F = 2@ccal condi33ERR)3= 3 # error0`WARNIN6= 40@warnBb`NOTICE+0= 5 normal but significantsmBINFO72= 6 G0infB%al-@DEBUV = 7-debug-level messa53# \yBKERNB HkernF#3USEJ random user:@MAIL Cmail-eQDAEMO 0sysSfdaemonDAUTHYsecurity/authorizaE3mQSYSLOM @ generated internal ly by syslogd LOG_LPR c = 6 # line printer subsystem6BNEWS-2= 7  # network news6BUUCP-2= 8 6dBCRON%2= 9 .clock daemonAUTHPRIV"10-# security/authorization messages (private)I#FTU = 11I sN*2*SECURITY3-Log auditqCONSOLE*14)6ler)3SOL!E= 15)Scheduling# (Solaris) e# other codes throughCreserved for'qtem use6*AOCAL\3= 1+9# 7^local6I3= 1+6U3= 1+6^3= 136k1= 2 hx1= 26<1= 26<1= 26 @prio_names = {( "aI ": fALERT,Bcrit!tryhg<0et.?et( :%if@* =oSTREAMu;k.connect(sa`]breakdexcept as excj=excE1 is:G-Zlose(0if gE 39errCselft!  &Sdef _AP_unix0et(U,)@use_#BM|Q9if (!isPF% "   det.AF_UNIX,w` S>6ess6# it workedNU set =p to they d ? +=&>)  %AOet.c6#~ #r didn't specify falling backEfail|  .em( [ -,Cpr) I$xKencodePriorityfacility1""">ME>4c and pP. You can pass\strings otintegers - !1are5)`P_namedn@mappdictionari0rTo convertDm toH integers.  B"""  if isinstance(facility, str):&. = self.t_names[]5 [_prior[[[[ureturn << 3) | + def close(C!s the socket.<'B.acquire()#:try'(I|-Tlogging.Handler.$6(ofinallY`releasCmapP\, levelNamecMap a .  to a key inNF mapThis is useful2 wo scenarios: when customds are beingused, andAphe case;re you can't dstraightforwardCmapping by lowercasbecause of locale-Ispecific issues (see SF #1524081).1+Eget(, "warning")ident = '' # prependedll messages ap0_nul = True # some old syslog daemons expect a NUL terminator;Cemit4orecord10EmiG$.@BThe  tformattts!toNserver. IfHexception inF sB@, itb@NOT KH 4msg`d(w"if E"V + ms#BG+= '\000'P?r# We netconverteNe, maybe tEwill Ldchange]ffuture$r<%d>' %iencodeW,cC y.y).('utf-8'(2# MaY# C5to bytes as red&RFC 5424?msgr &Bunix <$6.send(msg*) OSError_$Jclose()   self._connect_unixsocket(address) 3 "..send(msg*Uelif 'type == 3SOCK_DGRAM:_4!et[ to],LOelseH0allIexcept E:ionChandleError(record) class SMTPHr(logging.)J1""""A G"r :`which 6As anI email for each Qq event.FNdef __init__ , <host, from#@, tos, subject,Ecredentials=NonecCcure timeout=5.06 0Ini>tize the%. k !instance with3 and to @essedKqline of6-. To specify a non-^BdardSport, usH()p) tuplev0mat^N` argumjH@auth=wcation Ls0ppl(username, passw@uH=Aypof a seEprotocol (TLS)mR in am7`his willKponly be8d when  are supplied. ThepMZM`eitherRempty&@, oringle-valu?;Mskeyfile<27s-2fKcertificate O@. (T !ise`starttls` method)#A (pseconds can5ied5 q7E(thedefault is one(onk{!r.Tif isw(P, (li/)+3% =m~3l B , vH hmm( =jE* =S% =eP z+tr[C = [ ]Ef$ = - =>=;%urY self.timeout = timeout def getSubject(self, record):"&5""" Determine the s9A forbemail.\: If you want to specify a9lJwhich isz-dependent,wpoverridvis method.preturn .?emicEmit aaFormat& and send iied addressees6tryf0import smtplibRfrom `message .EuM 3 5Rutils Ol=+D A`f not  >.SMTP_PORTB$ =%f.pQhost,^,=)Khmsg = (!['From']s@elf.5 IA['To&','.join to-sW"46 5ADate2`.local.set_conten!.fp(b c"ifusername"`securea?Non,[.ehlo starttls(*\ ,0P4log{,Ppassw 5n_J(msg|#Gquitexcept E:ion*handleErrorn class NTEventLogH%r(logging.*"A M"r @0s eJs )1NT [ Log. Adds aregistry en^?Ypplication 0. I@ dll1 isH provided, win32service.pyd (nains some basic \Blaceholders)Bused. Notat use ofGse p. will makeIByour logs big, as94irexa sourcqheld in%2logETqslimmerS,k@have`A;or own DLL 0iniasX{h __=!__WP, app,=,;vtype="A"N@ h.VFevtlogutil, win32evtlog self.appname = #_welu = wHIutil)if not dllN:s = os.path.split(a.__file__)=U?[0]4Vjoin(3A, r'service.pyd'H2$ = #`logtypD #AddSourceToRegistry(w,_#, E#efi.EVENTLOG_ERROR_TYPE8ymap = {logging.DEBUG :_INFORMATIONe,I*YI.WARNING C CRITICALC}except ImportError!print("The Python Wk extensions for NT (, event "\ep")1earto be available."e = None _def getMessageID, record)1"""0Return the m81 IDA. If you are usingrJ4ownC s, could do this by hav7Zmsg passed t!eHPer be+ anrather than a@matt0str Then, in hereuse a dictionary lookup|;gete. This0ver! r+s 1, which is99bas="in.M|Q) 1E1Categoryc=)gOverridei@wantpspecify r P2ies ?s 0 0OType"&5L F doe`a mappohandler's ?attributeset up in+__init__()ka dictionary which contains mappings for DEBUG, INFO, WARNING, ERROR and CRITICAL. If you are usingr own levelsU willO6either need to override this method or place a suitable dictionary inNthe handler's typemap attribute.)5""" return self.3.get(record.2no,!0def$!) ?def emit(=", 2!):0gcEmit a$.@$Determin e message ID, event categoryke. Thenj@log @!in#NTF?log"ifV_welu:tryBid =2BgetM#ID-)+7cat0EC4 5OType14msg0Tforma.q.Report.appname, id,v,Az, [msg]Kexcept E>ion'iUError"8Qclosez1Clean up Lr9You can remov>papplica Q from `registF1s asource of& entries. However, i!do,qnot be Rto se2s aintended zE LogViewer - itsXjaccess`to getG1DLL#:SSFromR%20loglogging.Hp. class HTTP(/!"A 2 whSsends*a web ser[:aGET orPOST semanticsar__init__, host, url,i`="GET" cure=False, credentials=None B?1ext| 0IniC"izinstance withrequest URL, O(""u t.3\# =v.upper( #if Ain [~", |]raise Value"`1mus' !if^ se|V1 is|j 3PparamX only makes sense   "with secure=True") !self.host =  url = urlmethod = h# =q credentials =  'Pontexc  def mapLogRecord(1, r !):$5""" Default implementation oJping the logG into a dictEthat is sent as3CGI data. Overwrite in your class.? Contributed by Franz Glasner&creturn0.__&__getConnec,v get a HTTP[S]A.Y;ride when a custom cmrequired, for exa\5 ifPthere*a proxyimport http.clienq#if=8.S( =='. Oelse_ ^HNCemit 0Emi$ASendm1 toweb servera percent-encodedeionary]:tryurllib.parse9wN,  42lf.1SZ_UvB.urlN.)`A2lf. == "GET"nif (url.find('?') >= 0@%sep = '&'M4?4+ "%c%s" % (sep,Y Ph.puty"esS, +Q# sup[multiple s ne IP address..`# needgstrip op`Aal :OAfromK, if pre iGO'":j`Aif i`0=I[:i]V@# SeOsue #30904:  call above alreadyis headerOon Python 3.xj7("Host", ea?POSb P itype",!q"applic/x-www-form- d^ h.putheader("Content-length", str(len(data))) if self.credentials:!,import base64s = ('%s:%s' %O).encode('utf-8'_A'Basic ' +gC.b649s).strip().deK_asciiKbh.puth 'Authorization', s{Rh.end,*s(method == "POST"ah.send[ Sh.getresponse()#can't do anything with the resultlexcept E:ionhandleError(record) class BufferingH$r(logging.)O""" A J"r =qwhich bC#s : b s in memory. Whenever each # is added toJ, a check @madegsee if& should be flushed. If it,.n ()Mbexpectpdo what's needed.Q def __init__(D, capacity. 0Ini#0izew)R sizek5A?y.1.% =T!nQ= [] 2F,Sa hC its?]wReturns truPis ups. This Cacan beIoverridden3implement customstrategiesPr C) >="OemitcEmit a.@aAppend3[x) tells us toU"ll ()uprocess !.a})L"()/Obehaviour.version just zaps>_emptywacquire2try.Rg.clear-ofinall1Prelea Qclose  C!) [es and chai> 1par"' w)flush() finally: logging.Handler.close(self) class Memory!(Buffering)P1"""X2A hJ =qwhich b5#s n records in m^, periodicJ flushing them to a targetb4. F#occurs whenever3tKis full, or$ an event of a certain s<0ity'greater is seen.Hdef __init__,, capacity, cLevel=s.ERROR,a=None,P 80OnCS=TrueZ%y InitializeoAwithla size,lA at y`qshould D@ andoptional%. 70NotyOfithout!beOet either hereMvia setT&()a]nano usefnyone!{aThe ``(`` argumPis ``8`` for backward compatibilityreasons -$old behaviou th1hene1is !dZLsg1ed,_1 if> hasn't been exceeded noPM"r. To prPthis,P to ``False``2> .) ." = %=5# See Issue #26559@why B hasUadded7y{aBQChecka-7theohigherWreturn (len.ZQ) >= )J\(.%%no7x)K[X1Set"}.`.acquire(+trF(b x2`releasZ~CKFor 7t}means just send\osg , reone. Overrideyou want di |;)gUalso cleared bPoperap\+"ifk for record in self.buffer: !target.handle(>)/+Lv.clear($zfinallyd1release() Qdef close()11"""!Flush, if appropriately configured, set the to None and _Pl+tr"if6f0OnCN.#`acquir= |Z=BAingH'r.R -Be class QueueU(logging.<RThis 2r sends events0a qJp. Typic , it would be used togetherwith a multiprocessingRcentralise @file6N4(inM-Klication), so aQvoid IPwritee0ten'Kbetween G2es.code is newPython 3.2, bu2is Z0cancopy paste!tocQuser KAuse earlier Vversions.4 Q__init__T,|,RInitiHan instance, uoQ0pasc8D.dG" =:!enrfnE+# aThe base implement_ s put_nowait. You may want8overridet`methodw5you, blocking, timeouts or custom .y&bprepar+,P+s' Le *object returned by sxdkPforma#he`Pmergev messagi@argu!s,removes unpickleabtems fromG"in-placeEight (f uconvertYl`a dictJSON strobodified E'of0 wh@leava@orig0r intactx##_R oper gem raceback text into record.exc_text  # (if there's exception data), and also returns* formattedFmessage. We can(n use this tA@place original@sg + args, agse might be unpickleablc0zaphFexc_info attribute\y are no longerB`needed@, if not None, will typically7be Emsg = self.*(record)" # bpo-35726: make copy of *0avoid affecting o handlers icu chain.Y?=P.U |#.k = msg@.! = 4n{ X Udef emit(C,!):5""" cEmit a$.@$QWriteGQ LogRVthe queue, prepar[ itVfirstUp6tryi1.enT.Xey]$ EdITError@ class QListener(objectTl. implements an internal threalI which watches\5@s be ad6Dto a@Rremovdm0T pass)Ihrb processingf_sentineldC__init__c,*V&cspect__level=False%i Initialise"stance withV PRifiedn<fsZ" ==9>% = !_`= re ? = A!de@_blockD*Va it, o!GThe base aPuget. You may wantpoverridis methoYeif you,Qimeouts or workbcustomn |Q.get()8Bstar/S!1Cs up a backgroundqmonitorE$to;y=1t =fading.Thread (target=self._monitor) t.daemon = Truestart() def prepare(J, record):M5""" P+# a' for handling.S4This method just returns the passed-inE. You may want toooverride tPif you need to do any custom marshal5 orImanipulation ofb beforPing i Eers.F L5KH6eJ =6@loop4Yrough` offerAthem"toe0 = .DFRer in,&rs"bif not"respect_*j_level/3|processOelse1 .YSno >=rLijR.(WXM{QqueueKs, and askgqeal witmCruns on a sate, internal thread Th0 will terminate ifAseesJntinel objectMq.$dhas_task_done sattr(q, ''TQwhile :tryGy!de{(Q(#if2 is2_seY1 &*%q.(y"Ubreak]]?if qexcept _.EmptG!en. Ris usp<_x e base implement|uses put_nowait ,' timeouts or workLE 8. ./!AstopAStop+listener$ is&to=Pthen -s for it to doc so. Note that if you don't call this before r application exits, thereNmay be some records still left on0 queue, which wpbe processed5"""[qself.en<_sentinel() _thread.join@ = None """Read/write support for Maildir, mbox, MH, Babyl, and MMDF mailboxes.0 # Gs>authors of new * subclasses: # # Remember to fsync() changesDdisk{closing a modified file # or returnfrom a flush() method. See func0s _l_%Sand #ge(). im $os Dtime calendardsocketTerrno Dcopy !waSe u.messagigeneratopi_ntextlib ctypes G8icAlias try:)fcntl except IRError%' __all__ = ['abox', 0dir ' MH+ aMMDF',wl"'MeG%MH D` 'gacNoSuch INotEmpty 'ExternalClashbFormat] linesep = os. .encode('ascii') I2boxV"""A group s in a particular place.V6def __init__(, path, factory=, create=True)o="""Initialize as instang)] ._] @.abs@(os..expanduser()$ = s3add CAdd g assigned keyPraisewImplemented1('MP musti!5 byIcremove:keyREkeye"; "KeDBpit doesC_existG__delitem ddiscar 3fsQ* i`Q }t3yFpass\__set,% 8KeyError if it doesn't exist.""" raise NotImplementedError('Method must be i! by subclass') Mdef get(self, key, default=None):&v"""Return the*ed message, or7O if 6tryUYrV.__getitem__(key)~except KeyBN_"; cqpif not g._facto Cget_= :lsewith contextlib.closing.HAfileEP) as  A d(+ .2a M representation7aJD_str  '=3Uses email..to create a 7bit clean f f9L  m_from_bytesD).as % & }<_ %_-likejriterkeyK0an %ator over+sG list ofu |.N)QCvalu4all !fo2 in)^s  $! =:U[key]j! !CIinue6ayield Z __!__r2Z-7's(."8:a s. Memory intensive."""  return list(self.itervalues()) $@def Qitems&!):B"""RD!an&ator over (key, message) tuples."""=for key in }Wkeys(ae6tryr! =:U[key]Wexcept KeyError?continue6Syield`  E3 of? ` Memorytensive q __aains__,@.True if the$$ed exists, False otherwisaise NotImplementedI('Method must be i! by subclass':S__lenpa count=7szmailbox-9QclearL Delete all9 pdiscard1popu, default=None 7keyCand 7dit, orE , ;oresult84 k6~1pJ0popan arbitraryLYpair P,@.Pkey)) # This is only run once.JelseSroE('No7aupdate_, argaChange that correspond to certain if hasattr(arg, ''{source =7s()M/msI mE 7xl@bad_=TYA  1elf'$ =Y  ![<3if  P with8(s)Qflush`"""Wriny pending csIdisk|('Method mus$t be implemented by subclass') def lock(self):"""Lock the mailbox.""" raise NotI`Error('Method mus/unU if it is/edG_closeFlush and "G_string_to_bytes, messaged# If a(not 7bit clean, we refuse to handleR@sinc # likely came from reading invalidfs in text mode,that wayOes mojibake.6tryw{dreturn].encode('ascii')8except Uni | HQValue1("SEe inputASCII-only; ")sr or a Mr instead"G# Whether eachd0end!a newline_append_ = Falsec_dump_ , target, mangle_!_=A This assumes80 fi`s openabinaryu"""Dumpcontents7H sSance(0, eB..Cibuffer = io.B6IO("Sgen =Lgenerator,G(G =, 0J.flatten !Fk.seek(<sdata = " !.replace(b'\n', :seplLp.write(6 0if .12.endswith(b ># Make sure  ; < 4 c"/ela(str, =,;IO)?5io.2warnings. ("Use of 1is deprecated,s3, D9BionWl:, 3>H=)P.getvu ;str V v if mangle_from_:+ message = .replace(b'\nFrom ', > )C5?', linesep6target.write(C "if self._append_newJ and notendswith(h:# Make sure the; ; <3 a _ < c&elif hasattr, 'read'))lbuffer+warnings. ("Use of text mode files is deprecated, "C"use a binary> instead", DDBionWx:, 3M v@last(y = Nonewhile True]4d.C(# Universal support.oW!if.?r\ns/s! =3q[:-2] +'X. ZX1X!ifZ$]breakif mangle_from_&Db.start!#b'Y/S = b'" +=5:]o, . J<[ w 8P_s raise TypeError('Invalidtype: %s' % U1)) __class_getitem__ = method(GenericAlias)  Maildir(3box"""A qmail-style' rbox."""vcolon = ':'def __init__(, dirname, factory=, create=w """Initializ1dirAance{)q lW._paths = {AQ'tmp': os. Q.join0!, *),4?new4 4?cur4 4}vgexistsS#ifp  os.mkdir(self._path, 0o700) @for !F in /s.values():2Aos.mkdir(;\Nelse< raise NoSuchMailboxError({toc = {}p_mtimes'cur': 0, 'new 0last_read = 0# Records  PA we ({cur/newxskewfactorI!.1G # Adjust if os/fs clocks are 3Aing Jqdef add, messagefd"""Add and return assigned key."""Otmp_file =create_tmp(N:tryHSdump_($, S?except BaseE :ionP4g.closezos.remove('Fname`%b_sync_M50if isinstanceUMdirMX`PsubdiR.get_ dsuffixQtcolon +7Kinfo54if 89 &^%''0" =)Auniq = os.P.baseb pa.split~.E)[0]\GdestDBjoin+D!, l++@os.uw ,(Ngeta6)Qvdate())Q# No *modification should be done after the+0is d to its# final posiG`in ord;o prevent race cond#s with changeJrom other program  {os.linkF )(Attribute, Permission6S,eAL !OSK as CBif e.errno == ~.EEXISTr ExternalClash|('Name cexistingF: %sx %&fq@J,"""Remove the (keyed message; raise KeyError if it doesn't exist.""" os.remove(os.path.join(self._", lookup(key))) @def discard1 , :_"""If the2s, y* i# This overrides an inapplicable implementatiocsuperclass.6tryw*except (8, FileNotFoundK)KFpass__setitem__ ,;"""Replace,`ld_sub. =temp_key%Cadd(1)%NA.XsinstanceM, MaildirM~ # H's subdir and suffix were specified by;BdominantSJelse| defaults from !){oz$= Odirname( K2col + 25,+ 4a.split.$U)[-1]!W%''&1tmp 8?new:EO# +#B{!os.utime(,X ge_1).get_date( ;# No file modificshould be done after+0is |d to its# final posi0ord;o prevent rEAcond#s with changeJother program 0Rsturn a u repres#ora y uEopen tG), 'rb') as f?#if)\facto!4msg)_%&(f#?9 :q9hamsg.seBdir(= if self.colon in name: msg.set_info(.split(self.c8e)[-1])51date(os.path.getmtimBjoinD_!P, sub &))Jreturn msg ^def get_bytes=f, key)B"""R5!a & representation or raise a KeyError."""_with open_lookup(), 'rb') as fOf.read().replace(linesep, b'\n')Ofile%_-like?f =%&rdp_ProxyFfriterkey n %ator overs^_refresh(!fo-#:tocs:try,eexcept?continue6Pyield __*oains__ True if theDed message exists, False otherwise9key"3len count ofsKmailbox$le7toc#Qflush" Write any pending changes to disk}# Maildir&are always written immediately, soqre's nothing#c%o.Fpass9Olock@LockS D/unFUH`it is 3)ed XBclos2 NFfQ and "`P list_folder  ()+< result = []WAentr0os.E1dir\. 0if G4Q) > 1[0] == '.'\e84 ~ isb L)wC0.ap('7[1: (", binstance #qnd<+A,), factory=self._factory, create=False) &def add_folder(H", !):"KA"""C<# a# and return a Maildir instance representing it."""Mpath = os. Q.joinx ._s, '.' +g)6result =l(- 6m` zG')'Aeif notyexists(.W-1os.close(os.open2,UO_CREAT | nWRONLYf0o666)ryoremoveDelete the namedm, which must be empty0for entry inplistdir~ , 'new')) + \P?os.? [cur')qif len(d) < 1 `[0] !=qjraise NotEError('F& contains message(s): %s' %Jd Atmp' .^/isjX +"qsubdireoP '%s'?" %W(,-root, dirs, files5Cwalkstopdown C7@ 2os.* z=1 UTmkS,Bclea 3"""6oldY"tmp"now = time.($X  =/5 D0w -FQ.geta) > 129600: # 60 *)36G; P_coun1@This is used to generate uniqueC&s.{_A_tmp 0ileY:Itmp  @host = socket%if '/' in hostname:' hostname = .replace('/', r'\057')6if ':' in1:YGR:R'72Runiq = "%s.M%sP%sQ%s.%s" % (int(now), % 1 * 1e6), os.getpid(),Maildir._count,`path =Z .join(self._, 'tmp', 5:tryos.stat(4' except FileNotFoundError< Y += 1 m return _create_carefully+oExists(Upass z # Fall through to here if  succeeded or open raised EEXIST.H ExternalClash0('Nc prevented file ion: %s' %Lw(def _refresh)n"""Update table of contents mapping."""Hh&# If it has been less than two seconds since the last~f) call# we haveN un=itionally re-readGmailbox justyCcasemodified, becauseqmtime()0a 2p resolutW7theOmost common wor w(FAT) and a 1E@typiy. ThisOpresultsha few unnecessarhs when1!is4'edJmultiple Q0thaterval, but oclock ticks over, wwwill onqAas nC. BDsystem might be being served by an independent 9with its own p recordULcompare 4as from WotherJ}"'srskewing relati2our' adKextra delta.Awaite default is one Ih# onu'anOPinstaAvariY`so can` ad edg@dealaEparticularly Pirreg}!if;.@R() - _tS> 2 +QLfactS =sS(for subdir^Btoc_,u1gety"s[Q]N:1if .# >k5:  refresh = True  self._toc_mtimes[subdir] =  1sif not S:Qereturn3# R}5tocrU = {}Bfor |E in % l0pat% OSPentryRos.listdir(2)R/pp = os.Q.join(!, B)Y.%if-!isVS)ocontin{buniq =`q.split(colon)[0]t[< ? 6last_read = .1() edef _lookupW, key"""Use TOC to , gPgiven5 , or raise a KeyError."""h:try|Jzexists(j,g[key])Z51toc)|eexcept Epass*5( q('%('No message withOp: %s' % ) from None# This method is backward compatibility only.2nexlAA"""RP the "in a one-3 iterationshasattrEP'_one5g_keys'nc"" =c2xQwhile  Z[.)^TStopI iX>9 class _singlefileMailbox(%R"""A %-&" m'u__init__", %factory=, create=["""Initializj,.q l-fc1pen"._V'rb+'5M!OS;Z as eQif e.errno == z.ENOENT(#ifw(;elscNoSuch)1'elCin (dACCES,GROFS9rb') else: Uraiseself._file = ftoc = Non0next_key = 04pending = False} # No changes require rewrit-@the .M@_synRMneed to @ ?dlocked ps_lengthB# UsYrecord mailbox size Cdef add(;, message)id"""Add and return assigned key."""OvK._lookup()Btoc[!wB] =  app_( B8U += 1^:# _?  s OKc66. W# don't ca fulle + rename,is enough 6Tru`;6- 1cremove:keyREkeye!;  KeyError if it does_existgJ3delEkey]!= G__setitem__TReplaceJfiterkeys  n %ator over s|yield from.l)__containsf - #s,otherwise/&in3lena count ofVAs in 1lenW._toc'- OLockjcif notA&ed__[j#t( un< U`it is 3)ed/if f_flushWrite any |to diskO1 P# # Mes"sages have only been added, so syncing the file # is enough._?_flush(self._D)(qpending5z = Falspureturn ?# In order to be writPanyth out at all, etoc mustEralready generated (and presumabl$s#modifiedH by9wcr delef item)gassertis not NoneCheck length of1B; if it's changme other processDhas  mailbox since we scanned it1p.seek(0, 2cur_len =f.tell($4if '!(9Egth:Uraise ExternalClashError('Size) 'EIp'(expec%i, found %i)' %A,&))1new = _create_temporaryCFpath$:tryBI= {}Cpre_ `_hook(0Sfor key in sorted}toc.keys())w5start, stoptoc[key]-= ' esn 1L0 = Y(while True ebufferK(min(4096,7 -)H!if'_break"e(Il'1 = G,F<Z_ost_m.L jexcept>g.close/os.remove'Jname+-1_M\0# abto get replac@ no needL f^Make sureY1new('qeq;qsame as#3old#mode = os.stat'.&odos.chmod,% UWI(new_file.name, self._path) except FileExistsError: 'os.remove(B"name(new_file./, 1%w = openWv, 'rb+'-`toc = \5tocpending = False@_synC ##ifjlocked_P, dot=J!) odef _pre_mailbox_hook6F, f)W"""Called before writCthe <@ to ja f."""_blreturnooessageobeach m=pCost_4qUafterp Bclosp @Flush and " : 06tryxA-f>(^kfinall* ;?+ !d un ei3f.p() # Shas been done byw above.clookupvkey=None=RE (start, stop) or raise Key H0is UY_generate_tocif key is not=lPU[key] 6 ! E('No@withp: %s' % a) fromQ ap[Y XA*b%to viffsetsl seek(0, 23=$Z.tellnlOtoc) == 0.`:ing4`# ThisQTfirst,@  # hasn't yetc4. Ig{g[True,@\bs haveCx^d, sob[ mustD;~ already.( .w <B <o uinstallWq5ds e QBaseE6ion self._file.truncate(before) Uraiseself._file.flush(-_length =  .tell() # Record current -of mailboxmreturn offsets class _mboxMMDF(_singleM=!):?`"""An (@ or ,^Q.""" $0_ma=_from_ = Truedef get_message(S, key^B"""R2a M( representationz> a KeyError~?start, stop,plookup(l(uQseek(8yElineEP.read().replace(sep, b''@nstring=(-;&ms8-_factory(W|I\n')DA.set([5:].decode('ascii4:msgt!, Qo=False4e.Jebytes(Q3keyb)).as_P(unix=*_):@@]/bif not C/ "Bx V).2_-like1Xlr_PartialFil,_install ]Format a  and blindly write totl6Non}Qif isCnce([r~BFB_to_G Z.)3.swith(b'From '}3new4pfind(b'$-Z!= -1(" N#[:a]L."$ =w[+W + 1:0 else:  from_line = message e = b''elif isinstance(&, _mboxMMDFMP%):4NfauthoroP.get_().encode('ascii')8#b'From ' + O*cemail..c*@unix() # May be None.x0if &ais not& *'=3 Xz TPMAILER-DAEMON*time.asc(0.gm%()yr start = self._file.tell("fwrite( + Rsepc l = Tru 8 Pself._toc = dict(enumerate(zip(s!, -)8pnext_ke76tocfile_length =  .tell() class MMDF(_mbox )Q"""An mailbox.""" Ddef __init__(X, path, factory=None, create=3U"""Initialize ad&Z._message_\! =M,. )5predChookf Called before writing each @ to r! f) f.-e(b'\0014' +y ?ost_after!osep + 1gen& #G key-to-) table of contents&  = [], [] ^v.seek(0 upos = 00Qwhile4 = 84 +@read6(r)> -X!Bine.Owith  G;z ( $( - 5 -z}  >G :#+ph 1. self._next_key = len(self._toc) file.seek(0, 2_length = 2 tell() class MH(Mailbox):a"""An MH mQ.""" def __init__, path, factory=None, create=TrueS"""Initialize abinstancec%.j eif not os.q.exists ._e#ifos.mkdir=v, 0o700n,close(os.opennD.joi, '.mh_sequences'),RHos.O_CREAT |dO_EXCL `WRONLYJ600)Nelseraise NoSucheHErroG1locked = False1add, messag4Add and return assigned keyDkeys (!ifj) == 03new+1Q&Bmax(L&+ 2  =h @str((7keynRf = __carefully(F&I:try#ifz 6__&(f_ LSdump_(+, Y/except BaseE >ion*@# Un so it can be deleted on Windows? )!_uo$Qsync_ 6#os.removeFg BTif isk=MHMAE=> nkfinallXPSOVu<_wU^,#A"""R|@ theea!; qA Key jt doesn't  m  ZLv, 'rb+',"OS;as if e.errnoerrno.ENOENT:  raise KeyError('No message with key: %s' % () >Yelse:R$f.close(Los.remove(path) Adef __setitem__(self,,)"""Replace the&$ed'!;  if it doesn't exist."""v` = os. Q.join~ ._, str(key)6tryCf@1penv, 'rb+'/except OSxK as Kif e.errno == z.ENOENTgk ? 0if ._lockedv_file(f L#osFos.o4os.O_WRONLY |wO_TRUNCw>Sdump_(+, /sinstance*2MHMX/fsequences>B3kfinall@%0_un_ FVb_sync_Zf?5get?6sturn a  representation or>a@ , ` 9UVftsemsg =  %qor name_list inir ).'s(X if41key@ %$msg.add_M(q!re 6msg|QbytesyA&?') else:  f = open(os.path.join(self._, str(key)), 'rb')Cexcept OSError as `if e.errno == ~.ENOENTraise KeyM ('No message with key: %s' % REfx2if jlockedY_z_file(fs>try/return f.read().replace(linesep, b'\nAcofinallM>9_unrdef get,3B"""R a -like representation or B% aA."""b{ Jr;s_ProxyFyiterkeysC)t n %ator overs[b&(sorted(int(entry) for in os.listdirq T.isdigit())) __contains__]GTrue if the%edexists, False otherwise3 3lenu count ofs?mailbox@len(_. ' xALock_oif not}.'.mh_sequences'+f[ 'Ped =  gUbit is L X  _sync_close& $3del\@W" =QflushW  Write any pending changes toIdiskZ ZFrQ and "M2Xlist_folders(self): """Return a list of folder names."""-result = []for entry in os.E1dirhg._pathnu if'0.is*1os.Gjoin7,W)?C.append(~)r$ def get_d,^ n MH instance 1thed8 B?MH({!),factory=#._, create=False)?addC<# aS and arepresenting itMoremove|Delete , which must be emptyU% =m _H2ies3E\!if&= ['.mh_sequences']W2os. R+, ;)d+elf WFpass:lsevraise NotEError('F"ot(: %s' % smkAD<'-to-key-G dictionary to define each P !{}~Mwith openMSP, 'r'Fcoding='ASCII') as f5pall_keyt1set.( l,inC:tryXK, contentfE.split(':'}-0 = !@specz\UO0if 5}Ogit(+3.add(int(9 $estart, stop = T0x) x`?'-'jPupdate(range(^?+ 1@`[]1keyin sorted(_5) \s 3if BO&9yif len(o) == 0=<Idel 1 except ValueM +raise FormatError('Invalid sequence specification: %s' % line.rstrip())5return results def set_wus(self,1s):(xf"""Set using the given name-to-key-list dicuary."""If = open(os.path.joiny ._f, '.mh '), 'r+', encoding='ASCII'6tryos.closeem f., os.O_WRONLY |WTRUNC*@1for, keys inw.items(1pif len(2j) == 0#continuef.write(W + ': prev = Non@pcompletn= Fals#1keyorted(setq if@ - 1,Fnot +/(_ = Tr&/'-%Oelif| x(Pu"%s ( 3/OelseQO6key?g =| (g1str)P/\n:D'8kfinallob_sync_r&f)]Apack]a"""Re- messages to eliminate numbercgaps. @atessN0 = ).g\P0N@chan|E= [] 0elfr 0!= \a.append(f,+O + 1=  pos.link!1I%),<q@4=except (Attribute, Permission:Pos.re.  _os.un` p5= 1v`_next_f + 1 if len(changes) == 0: ereturnfor name, key_list in sequences.items()D5old, new/o %t`if old#^$([ .index(old)] =hself.set_( !) 'def _dump$lf, messag"""Inspect amB MHM* and update appropriately."""wvpendingy$ =u).g)49all0-| C!if  ap.F(key@elif4P-G0del%Y S]Tv I ]%if1 no  . [k^~ ` ;) class Babyl(_singlefileMailboxY"""An Rmail-style1 1box7_zial_labels = frozenset({'unseen', 'deleted n `answerK'forward.S 'ediMresent'}>_init__(, path, factory=None, create=TrueyJitialize a&8/._vq.4&{}3add 4Add assignedokey = hif isinstance(,\f ;(6keycremoveb A"""R@ thee; raise KeyError t doesn't exist  z BX$lf) P__set5keyI_placeC Ed#Ye(self, key)3: +"""Return a Message representation or raise a KeyError."""Cstart, stop = self._lookup(key)(file.seek(8 readline() # Skip b'1,'  specifying labels.doriginal_headers = io.BytesIO(mwhile True `e)"if== b'*** EOOH ***' +0sep:1not gBYbreakT p.write(r.replac sep, b'\n')visibleYOline # Read up to thev,i5endTn-Gtell assert n >= 0;@body>&(np"Nmsg = Babyld(pgetvalu + Vkmsg.set_9(.;4if key in) X(RV[key]Nr#Amsg def get_bY9,o)`X0strW)90 1S(Odata "0 + 6 ;:%_-likerself.get_byte+s(key).replace(b'\n', linesep)) def get_labels(self):"""Return a list of user-defined 7 in the mailbox."""CR._lookup()9W= set2forT_o3in @.values(L.update(? n.difference_-^sspecial7rWs6_generate_toc9G key-to-(start, stop) tableOcontents5+s,s = [], []=file.seek(0pnext_po500Iwhile TrueR3ineFQM  Alf._@read[)> -Ktell)!if == b'\037\014' +:sep[20en(Oas) < l Karts-*.append(-9*s7q,d_ .strip()  A6 Y[1:].split(b','M*@I4se elK6ine '  k1not;8#Ubreaktoc = dict(enum B(zip&))E8[; 4yQkey =I, 3$3 = .getvalue;strL2 = s;A_to_Td body_startAfind\n') + 27if 6- 2 != -1oJ&[:@], Ob'*** EOOH ***' +a <<O:?els!tthasattr94, ';'>if -  +itext mode 3sa binary>1 KGinal_pos0Ktellfirst_pas( H [\s `G# Universal new9support!.endswithr\,! =Qr[:-2] + )*. Z/*X1X :  linesep))  if line == b'\n' or not*: ,if first_pass#)$ = FalseN+self._file.write(b'*** EOOH ***' +Osep)D message.seek(original_pos3OelseYbreakkwhile Tru6@ @read(z/if\ y # Universal new] support.-.endswith(b'\r\n')M=`V[:-2]l Z/el\Z1ZZ [ raise TypeError('Invalid type: %s' % ()Vwstop = |Gtellreturn (start, 0) class Ms(email.^.3"""  +box-format-specific properties.""" def __init__(,S=NonebK"""Initialize a instanceT)Tif is/, 7._become_(copy.deep Pe9t-]._explain_to[bytesS a_from_<m?strk$ostringlio.TextIOWrappey%wthasattr0, "%"$abinary0RT@ is   Y. )") J"""Assume the nonstate of _specific = getattr(message, '_type_specific_ibutes', []) for name in >.__dict__:&-"if)0not- ` *.EselfI[b=] =b hdef _explain_to(B,2)b"""Copy format- state to3 insofar as possible."""mif isinstance;MDr- return # There's nothing3to .kFelsePaise TypeError('CanZpconvert0ed l') class Maildir(3"""T with-(properties. = ['_subdir'WAinfo gdate']z_init__S=None"""Initialize a0 . = 'new'  = time.(s/._)3get} R or 'cur'9\s\", j d3Setk$if(='S  # =?]CValu"_rmust bew s: %s" %X U_flagsTas a strdAthe / that are setht p.startsW('2,'Q5 0O[2:] ',g0"""Rgiven! and unset all other2,' + ''.join(sorted(w)M@add_ 1(s)out changf`%s(!etm.@)) |)oremove U.[-]U e delivery '4 of,5seconds since Yepoch E u~, date): 6 """Set delivery date of message, in seconds since the epoch.""" Etry: aself._O= float( )%except ValueError@raise Typ("can't convert toUq: %s" %) from None gdef get_info()da"""Get@'s "*" as a stringPretur+gsg6*fomf; mhif isinstance(i,Qb0 = Felse N'0 must beMr' % typw&))_explain_tL,$ """Copy Maildir-specific stX$to4 insofarkpossiblek 5,YMz&.Qflags.)~ 0fsubdir120./el_mboxMMDFf = set](^`if 'S' !@add_#J('R'0if " == 'cur'QOQ/'TDCFCFCRCAC<K rom('MAILER-DAEMON', time.gmf/MH4?notPsequeQ{'unseenP6LrepliedMMgMA_BabylD^olabel(AIYdeletJoanswerKP   message.add_label('forwarded') elif isinstance(72, M@%):+2EpassJelse)raise TypeError('Cannot convert to specified type: %s' %Sd ()) class _mboxMMDF(3"""` with .P- or 3-c properties.""" _r_#_attributes = ['_from']+def __init__(self,yS=None"""Initialize an2SA.setu('MAILER-DAEMON', Truecemail..oh@unix$ =T.get_(e.4if @ is E andp.starts|('From 'tJ UF[5:]r.h)m"""Returntents of "i" linetr,xb , m_, time_9Setf, formatting,`appendC6 if "ifen z" kc=I0.gm  += ' ' +)1asc*_." =%Olagsas a str@he f/ that are setget('Status', '') + (X-e,q #the given!unset all other(Q=( #_G, xsA = 'oH!orsp in ('RO0%if#U d!+=/cg<q.removefDFA  A''.join(sorted&s):tryreplace_header9+Eexcept KeyQOM eader('X-Status', xstatus_flags) def addp(self, !):""""Set the given (s) without changing others."""=RA.set`s(''.join(setm%.gP)) | )aremoveB59Uns0strLQif 'S!P' in { or 'X-(-_explain_tozmessageCopy mbox-MMDF-specific Se to : insofar as possibleif isinstance(6, MaildirMO1s =*MOH4 3!q:subdir('cur')GFG/'FCACRCRCSCDCTC4del ['Ius']. "/x-$maybe_date = ' "lfrom().split()[-5:]?try [(calendar.timegm(P.strp (, '%a %b %d %H:%M:%S %Y')) except (ValueError, Overflow_xEpass/el&_(a|( 0]./MH`R' not8pPseque={'unseenyLrepliedM MgM (& "J_Babyl^klabel( if 'D' in flags:  message.add_label('deleted')-_if 'AJmanswerKCdel x['status']m "-x-$elif isinstance(N2, M)Epass`Jelse)raise TypeError('Cannot convert to specified type: %s' %S T()) class mbox!(_ 3MDF3"""Q with3-c properties."""X#MH4(M/MHK__n _attributes = ['_sequencedef __init__(self,S=NoneZ"""Initialize an  ,M.q%.{%) 6getD Return a list of  that include the r@ 6[:]s,f 1Setj$ ! =( 5Add #1ing % wW, strm0if z# 4 !u.appendy must be[QeremovelT R,WAfrom=]!:try 9except Valu H6-explain_to"""Copy ee9/ofar as possible-6, Maildiru1set.)2aunseenA *.ubdir('cur\<*;('Sb?gedsage.add_flag('F')  if 'replied' in sequences:'2message.add_flag('RMelif isinstance(., _mboxMMDFM@)Zq = set(self.get_.()unseen' notOJelse 8< g<!:A/MH5forM ( _BabylFs"slabel('L SansweredEpassraise TypeError('Can convert to specified type: %s' %S ()) class (3"""R with+-zc properties.""" }_f_#_attribute1['_As', '_visible']9def __init__&#, W=NoneW"""Initialize au|Q = []3 = G(..) Return a list of *t on the r3/'[:-3setp,S x1Setawp! =(~${ z2Add fdW, str]iB"3lf.r.appendp must bxcstringzU)bremove,R&/Ofrom try:  self._labels.remove($) $except ValueError:#Qpass def get_visible(\)-"""Return a Message representation of = headers."""]kr?=`.n)s,U Set the$}$ =F(dupdate U! and/or sen?y generate a set 3for4I in g.keys(tL+if/ Ereplace_(,j[ ]4?NelseU1del4<= ('Date', 'FromReply-To  CC Subject' i=not/ ! =_explain_to2, m """Copy Babyl-specific st$to2 insofar as poseif isinstance(h, Maildir)xst.*()if 'unseen'(%!y.zsubdir('cur'M<*add_flag('SbforwardedR or 'ibPbiansweraKRK_deletJTJ/el_mboxMMDF;2  B'RO 9 80#DJ$AK{/MHt;?in pPseque  if 'answered' in labels: message.add_sequence('replied')0elif isinsta#8, BabylMF)`$.set_visible(self.g)d2for-(`0d&(UGpass*se)raise TypeError('Cannot convert to specified type: %s' %S (()) class MMDFg(_mbox 3""""Q with3-c properties."""X_ProxyFil"""A read-only wrapper of a file=def __init__, f, pos=None)"""Initialize a sM#_dE = f$ ifT@ is W 30pos2h.tell( /Apos dOsizeRead byt>rreturn YFCize,.)k1lI1m2lini/, a ) 8tsOhintUmultipleZresult = []4ine 2.2nd(6!ifRV-+&o-= lenK&OJ<= 0"UbreakVc__iterJ =terate over&while Trus" =#0if 0Qyieldv R0the_ition] Cseek<offset, wh*=0c_Chang_#if5Z == 1.i.lV._pos< # (4Bclos  $+gif hasattr ''A':try <._file, 'close'): self._file.close()'~finally<Fdel < 5def _read(, size, w_methodq"""Read$ bytes using/A."""Y"if,zis NonejU = -1/AseekV._posresult =s(J#FWpos =W.tell)rreturn P _enter__} Context management protocol supportc a3xit`g, *excf,Lablea7*)rOwrit>*>>*>_flush'8@property,if not hasattre1, ' 9)ATrueU ?E2, 'qFFFalsG[|d__class_getitem__ = \(GenericAlias)  _PartialFile(_Proxy A"""A-only wrapper of part!a DG__inxf, start= !op d!`"""IniYize a .f {qDAstop"opD Rthe position withrpect to _# -4coffset, whence=0VChang,0sib@ or #if][ == 06A6 = [)elU2U%opXTAf9p, honor|N andH`remain% k5pos6if .U q*V return _Pro xyFile._read(self, size, _method) def close(!):# do *not*  the underlying file object for partial's,Gsince it's global toMsmailboxE2if hasattr@, '_l'@del .0 Q_lockp(f, dotS=True>q"""LockP f us%Pf and2 qing."""F_done = False6try/if fcntl #(.gfLOCK_EX |G.1NB)j6except OSError as ep%if e.errno in ( .EAGAIN, ECCESCROFS Araise ExternalClash|!(':. unavailable: %s' %Q jf.name)?else if 1pre' = _create_temporary(A + ''?.6 !)eturn # Without write access, just skip+=[,G.os.link()/, Z= m(Attribute, PermissionPos.reH^os.unEaExists ,Jmove M)-?dot/w "UNH|U unoA"""Uif os.path.eh  carefully(path): """Cr%eate a file if it doesn't exist and open for reading writing.""" fd = os.-`(path,O_CREAT | DEXCL RDWR, 0o666)BAtry: Oareturn{NR'rb+'*gfinall.os.close(fd) def _cr_temporaryF)aA"""C0 a !based on qcarefully('%s.A' % , int(time.E()),socket.gethostname(D os@dpid())1sync_flush(f(Ensure changes to,f are physic7Fdisk.Kif hasattr(os, 'fm"')1os.0(f.:no(20, e%ll _fF ) class Error(Exception0Rai.module-specific e4s FNoSuchMailboxS%OCThe ABed m*8 no wo2be dgotEmptyb"is`7@dele was requestefExternalClashkAnother process cau,Qan ac\F8ailoFormatOaappearhave an invalid1matO0"""h2cap6Phandl See RFC 1524, iDt os warnings __all__ = ["getcaps","findmatch"] hlineno_sort_key(entry# Sort in ascen;order, with un8ies at the endBif 'c'H&{0Dtry[+]<Felseb, 1, 0 # Part 1: top-levelrerface.(B"""RAa diary contai6}@dataQ!. 5maps a MIME type (%ll lowercase, e.g. 'text/plain`to a l&of;correspoi!toG6`ies. <collects all(OW thatAfrom(available^K`FEachs key-value pairscQwhere@view@commis stored<%Pkey "("fQ = {}@A = 0for mailcap in listmailcapfiles(): 6try fp = open(3e, 'r')1except OSError<continue-zwith fp& morecaps, lineno = _readp4(fpzfor key, value in JY.item`if not3,r $r[key] =WOelse4 @+@preturn _ defB"""R,a$ of all   s found on the system."""# This is mostly a Unix thing, but we use= OS path separator anywayKif 'MAILCAPS'3os.environ?0str$[7]J<1s =sstr.split(os.E"ep eOHOME\Khome4~ U4# Don't bother getpwuid('_'.' # Last resort[-S+ '/.', '/etc/8]Z'/usr$ YlocalRSs # Part 2:qparser.mLnIad a`S and `a dictionary9ed by MIME typevwarnings. +('r0depAted,~0get instead',3 D4BionWa2, 2<?, _+BNone)0 |\ / FEach-mapped to an entry consistingA}Aies;P will8#ta than one suchFif a given ar&r ?cEUXp.Es-@pairrtlb, wher]@view@commlis stored#Pkey "("~Q = {}rwhile 1H@` = fp.q: breakE8# Ignore AentsQblanks*ine[0] == '#' or#.strip()'_ @next! =<^a# Join@inuay!@B[-2:K\\\nv%.readline()  if not nextline: = '\n' , "! =u[:-2] +/(# Parse the)key, fields = p%P()&(key and1%):!continue!iflQno isJNone4z ['oCno']%noEZU += 1# Normaliz5key@typekey.split('/'for j in range(len(2) [j v.strip(L= '/'.joiHg.lower&r# Updatydatabas(Gzin caps![key].append(2;elsT3B = [/]Rreture,\ def2"""4one entry3a mailcap file Wa dictionary. qThe viewing comm;is stored asvalue with "5!",D4qrest of$ produce key-FPpairs2.D1"""82= [i, n = 0, fX whRi < n =4, i'( , I;*s@i+1 # Skip semicolon2$enF < 2gD , 2/!, "=4[0]&[1 "2:# {'=!':}S IU.find('=V0if 20. ^f#= f?M[:i]7K^[i+1:)1if M#in" # Ignore itEpass:[Z'0sl<"""Separ*v .start = i|c\"[i:if c == ';'QbreakL%el)+\\*7i+2, "k[a, i pt 3: us82.C|`match(`, MIME, = lename="/dev/null", plist=[]"""Find X@tch  dR=a tuple 4ain,+H"pused; (, None) if no maXtch is found. This may invoke the 'test' command of several matching entries before deciding whichEentry to use. 1"""ies = lookup(caps, MIMEtype, key)*R# XXXcode should somehow check for needsterminal flag.E De in:$if = subst(e[], filename, plist11if 87s.system(j) != 0c2rcontinuyv{Hkey]dreturn", U`None, _ def{=%)![]7%ifS*. + "[D .split('/'R% =ps[0] + '/*'6 ifm1not![eeE :2n e= sorted(=lineno__)q_field3=[]#Actually, tis Unix-specific0rs'=, n = 0, len(oywhile i < n Ac = $[i]; i = i+1U@if c6'%'3k== '\\UO:i+1Y&"+ JelselNJ Qa = g%el9s39 @t@ @{@Pstart 5y }K5 t":i> %ndparam(TGZTo do# %n == numberPparts:Pmulti)/*@# %F;9alternating <#EsDvD'%' A2res/fi 0 = .lower()=pDif p[:n]E== name:  return p[n:] '' # Part 4: test program. def1():5import syscaps = get !()Qif no$.argv[1:]=vPshow(-,; for i in range(1, len(sysJC), 280arg}b[i:i+2!if=&V) < 2print("usage: mailcap [MIMEtype file] ..."80 = i&[0B 1command, e = findmatch$, O, 'view',[D0No ;er found for", GOelse=Executing:", f7 sttos.system(% waitstatus_to_exitcode(stsVjif stsnRExit H?N<0M#s:\ fn]Clist"C(): :\t" + fn {Paps:  ."}eentrieL@ckeyGasorted% +c! =[iLeI&K; eT;k;& 8" %-15s" % k, e[k]F' ) if __name__ == '__main__'[s() """Guess the Q of a . This module defines two useful functions: gK_(url, strict=True) -- kand encodingxDURL.Lextension(VR *} a given. It also containfollowing,80tunbehavior: Data: knownto parse inited!flag set wheit() has been called suffix_map3!diLary mapp!t$o  1s90 G6,7 F!([]9 a ,)Wault 3(on Windows,% &values are taken from$ registry) read_mime` s("on?", -7 a Mpor None# O$os Yposixpathqurllib.R try?_winapi < _mimetypes_(read_windows_registry except ImportError: _mimetype,9 = None try2iC winreg as m?regc+J__all__ = ["knownfiles", "inited PMimeT"",)`guess_LextensionA=5add;dC,s+suffix_map%encodings ccommon@F ] P/etc/h.<hYhttpd # Mac OS X ;Oconf@ # Apache9a5 9- 1;2< ;2;usr/local ,lib/netscaper *aJ/1.=3z0] Ced = False _db+u class 8"""MIME- datastore. RFThis can handle information from q-style ;Fpand sups basic determinA0of  Na?qname orEPURL, JM a reasonable Z given aS.A2"""`def __*__(self,ms=(), strict=True)&wpif not 8&edQnit()fT.I = __default.copy;85 < = ({}, {}) # dict for (non- BG_invFGAext,R) in bgitems(9(j,!, eb e$ [&in ()1A*d >"""Add a mapping betwe an4<xWhen thPis al!y , 1new5Uwill replace"old one. T(5 W4YObe added5!to'rlist ofsions. % If strict is true, information will be added to 4`list o= andard types, else to the $bnon-st(A0.5""" Qself. R_map[][ext] =i+zexts = 2D_inv6.setdefault(SU, [])?if ext not in %s:_.append(ext) def guess_R(}c, url,Kf=True)J@"""G/39a file which|either a URL o path-like object.~Return value=a tuple encoding) where3'qNone ifGPcan't`ed (nounknown suffix)a%ngE!of4i@/subU, usable fMIME Content- Aheader; and =&no!ornjname oprogram us4e (e.g. compressgzip). Themappings a0driven. EOe%6cas?sensitive; *first tried 6 .,n%in6TheU.tgz, .taz5Q.tz (<:!!)5all]'.tar.gz'. (Thisnt-@ too0ingC0dic3ary.Q!Op 2l `' argument@n Faadds a bunch commonly found,o bu<[s4url = os.fs8F(urlascheme =lib.parse._split 32if 6 == 'data'# syntax > # ` := ":" [ mediat ] [ ";base64" ] ","5k1A:= [S "/" k ] *( ";" parameter C} *urlcharg>:= attribute "="k / es"text/plain}a.find(',' ifjma < 0q@Q# bad!o r ,  "Isemi|b;', 0,p ./>=I [:']g4 5`if '=')dor '/'R'l' = " # never compressed, so encoding is None base, ext = posixpath.splitext(url),Qwhile,in self.suffix_map:&YV , +CV[ext]n)ifksn" =S+VJelse^* =JAtypere[True]" bureturn ,I"elK.lower() i5S7][ostrictID7OFals   def guess_all_extensions(),", R=)X@"""G:1 th_: for a fu2d on its MIMEQ!. {rR4Pvaluea list oftpngs givdpossible\6namq, inclu541lea dot ('.'). Tv5not,guaranteed to have been associated with any particular dataEeam,Lbut would be mappU  `~C' by'()$Optional `' argument when f adds a bunch@commonly foundnon-standard%s.5""" ! ="vs! =2.3OB_invBP.get(V, [])`if not5 C>V WWec in*..fnd(extB&>9!8,$ng/$#g?0str+ but would be mapped to the MIME type `c' by `guess_ (). If no extension can be &ced forDe, NoneGis returned. 6Optional `strict' argument when false adds a bunch of commonly found,Nbut non-standard%s. 5""" s = self.V_all_(", )=it%s:6 [2[0]def read(, filenamevf=True)aRead a single mime.s-formatL, specified by path_#If is true, inB@will1add2@list o0, eZ$Awith open(encoding='utf-8') as fp|E.OTfp(fpE)k$fpm"g-Pjhile 1,line = fp1(M :Ubreak@wordO0k.splitPi in range(len(4)I1if [i][0] == '#'+4del,):]cVvcontinuE, suffixe=C[0],~1~/7l2adddeQ'.' +k_windows_registry JLoads database from W[ [_?-ad" and not :reg'vm H( = lambda,,:h"\Qext, }# AcceleratT0unc'` if itavailabl?if  :  _mimetypes_read_window gistry(add_ 3) Pelif )Ereg:_self.H3@classmethodOdef ;Ucls, s3Aenum s(6db) Qi = 0awhile True*>tryc$ =.EnumKeyt6, i/except OSErrorWYbreak:/lsif '\0' not in Z.Ryield% dui += 1 Ewith@Open.HKEY_CLASSES_ROOT, '') as hkcfor subkeyname/ wE,ds # Only check fextensions!ifj\p.startsO("."?continue`# raises% q 'Content Type' valD`, data `QueryV@?Ex(,|,&ifp!oREG_SZ;^  it 5Qguess6(url, strict=@"""G%P the R of a9based on its URL.FbReturn is a tuple (?, encoding) wherUpis None"th(. can't be ed (no or unknown suffix)a ngDAform@/subQ, usable sa MIME e- header; an9%nozz program useEt0e (e.g. compress=gzip). The mappings adriven. E;e)`case sQtive; "Efirst tried 2,n%inIfes .tgz, .taz!j .tz (M!!)1all".tar.gz". (ThisRt-@ too0ing dictionaryS_map)!Op 2l `p' argum0when false/PbunchPcommofound, but non-standard types. """if _db is None: ainit()`return'p.guess_G(url, strict) def all_extensions(-)b=True)e@"""GNV the 0 for a file based on its MIME!. RPvaluea list ofngs giving`possibleXAnameCv, includ01lea dot ('.'). Tr1notG,guaranteed to have been associated with any particular data@ stream, but would be mappQ  `PA' by;r(VIf noM@ canL&!ed[@,C2is #edZOptional `' argument when false adds a bunchvcommonly found,\Ac)*#3$ng|Dq l)p lEpl KplJp5lDg2add,QAdd acAbetw"p and an>5WmAalready known,1newl will replace olD5e. P(19is O0nKb!ed1!to#jsI ct@truePformaYW1 toZS 0, el wS=* s=)global suffix_map,s @encoG"0s>[0ed,a0 = .0# sxat MimeT __'__() doesn't call us again if files is None or _db3: db = MimeTypes()# Quick return if not supported( db.read_windows_registry() $iq= known 9Oelse- + list(: 72_db1for1 ins`if os.path.isOT)!encodings_map = db.%fsuffix"t~a[True]#qcommon_f 5S[Fals'# Make the DB a global variable now that itfully initializ+q def Bmime~2try f = open!$, ='utf-8'xcept OSError=ifwith f `fp(f, 0hT6db.,"]_default_86, _ 9+9, _1", Y)8, _// =A = {)'.svgz': W.gz',t=tara61bz2l6 mx8x} K  IgzipZcompress: 'bzip2 @'.brI'br*# Before adQ new 0, m1sury are either 8Qered BIANA## at http://www.iana.org/assignments/media-f#extensions, i.e. usingx- prefixa# If you0 to#se, please keep1m s@ by 2.pwb entryl erX  a particularXWappears bS@ny o1@s ofQ same6 + '0js' : 'application/javascript3'.m/.@json^ .{'.webmanifestU+L50doc\ation/mswordC', `'.dot' : 'application/msword*?wiz*?bin*octet-streamZa.+ 01dll20?exe0o.1obj2sa0"od" 0)daG?pdf?p7c'kcs7-mimeUs- postscript./ai."ep] \1m3u] .@vnd.e.mpegurl@m3u865/xljzms-excee0xlbd $0/ppt0powerpoin[p5 p:5  wj @wasm: @bcpi4 ("x-+* !x- * sh|*)shD"dv ~R@gtarS )*h x- )5Q )5olatex'*U/mi) x-)c0net,nVO,1p12 )ipkcs12 pf,!raOpn-realaudio^yython-cody1f f/sh=j/swshockwave-fla_.sv4cpio': ' application/x-sv4cpio',  '.~rc' : '-)rc,@tar'9 ,U?tcl)*clR/ex),ex)i*{Zexinft-OroffZ (. ,t+*+1manXV-!me.Z9-me8/ms. s. uss5 wais-sourc/xsm!rd '1wsdO 5 '/xp'1zip' N&3g'udio/3gppA"2k"2E%#:aacF1adtD !?loa! !as  B!au!Jbasi11snd$#:mp3#Impeg mp  "1opug iVDix-aiffh1aifUF$I$ !rax-pn-reala{ t1wav-P%bmu`image/!g!!!ie!!4jpg!j"jpv?: '"E"4hei`D"heD"!pne!+sv![svg+xtGth ":ico4vnd.microsoft.iconroRx-cmu-raster*fPx-ms-:pnmx-portable-anymap',  `'.pbm' : 'image/x-portable-bitmap', !O'.pg/Mgray0p0 ~3?bad" = Rjnt = 0% =7 if  else []A : = ,ifP processedm = [] # Usedging only1msg, level, str, *args2 <=O Pfor ikQrangeU.@Iprint(" vend=' 'N" o0argq A(arg), G)!in = q&[0"if> J5+ 1* ?outZ-run_scrip 21"m- with io.open_(pathname) as fp:' stuff = ("", "rb", _PY_SOURCE)+elf.load_module('__main__', fp, pathname, V!) ?Adef 6file(self*!):#Pdir, >` = os.Lp.split( \, ext,@ext(+with io.open_codeOf as fp?extz  import_hook 6caller=None, fromlistlevel=-1.G.msg(3, "T"D", PK!, FPparenAKdetermine_(@6=<q, tail = =find_head_packagd]7#m 1B(J$eif not return q5pif m.__"*__,tensure_P&(msV{ PW|in(4, "A"=r2 or_ == 0omsgoutc@ -> "\pv# ='0.__(__Y >= 1: # relative m)M&ifH$NL-= 1;67w!s[]H-sassert 4#is (<G" JfNf \1if .count(".") < Gaaise I{Error("cJ too deeph = ".".join(0y1[:-X]P$' # -#is @b'.' in 2i = .rK('.'t[%:[:i0& termine_parent ->", parent) creturn self.msgout(4, "determine_D -> None"MI Hdef find_head_package(Z, name):/w!inv >:9if '.' inRQU1i =.OF('.'"E[:i]SDtailFi+1:JelsegHD%""#ifo Aq  = "%s.%s" % (m0.__@__, eD(pAq = Zimport_module($!, 2[Jif qBN d@(q, 7)LJ  ,G! =} !R+B Yqraise IError: No #d"P 4+("4B " +)Pload_1tUm = qQwhile 5|s|if i < 0: )@len(-I}! =b[.m* Em@1 N:, mif not mM"e bL > m!ensure_fromlist'4m, , recursive=08 F?", Bpfor subj [!if j== "*"*"& al rall_subk's(.oif allR$P 0(m,56, 1,#elphasattr(7subI&?sub 7}2.import_module(sub, subname, m) `if not#Mmod:.raise ImportError("No module YPd " +C !) Edef find_all_subm/`s(selfkm.__path__~QeturnTHU = {}# 'suffixes' used to be a list hardcod[".py", Gc"].EBut we must also collect Python extensions - althoughGawe canV eparate normal dlls fromRsU = []WA+= ilib.machinery.EXTENSION_SUFFIXES[:>oSOURCE;"BYTECOD=for dir in :tryIps = os.zdir(direxcept OSDj.msg(2, "can'tdirector U}continue|sqmod = Non:>>A*n = len(& 0ame[-n:] == *L.F[:-nYbreak ifA and!= "__init__"tp[mod] =6Urules.keys(._A(@partB, fqvparent)}yin(3, "F?", B Bm = V[|<z?Key{Epass\FelseRY^sgout@ ->"@27#ifNrelf.bad7 m "go  ifH1ent 1 isH3{  fp"thTstuffp (7L|W  !", j Cload9(fqname, fp, pathname, stuff) finally:Zif fpfp.close(?if parent.setattr(,$tm<self.msgout(3, "import_module ->", .return m def load.(LB, fqe fpsfile_info)suffix, mode, type = )cWwin(2, "r"n and "fp"w#if`= _PKG_DIRECTORYkAm = oepackage(W40B @0D  Y_SOURCEco = compile(fp.read(), 'exec'+elWCOMPILEDY+trv@datah%lib._bootstrap_external._classify_pyc(M&{}Jexcept IvError as exc+ hXraise:: " + str(exc rK; amarshal.s(memoryviewf)[16:]LJelseDENoneZO%ad%MHAm.__5_ ="BZif cog"ifreplace_s#4 )_in_code(co0_%coG5sca; `A_AbadmrDBgcaller10if r not in; [9a] = {}{]c >:[0.__I __K1J E2"-"9:Rsafe_Q__hook, fromlist, level=-1# wrapper forP) that won't 5 X 9", " Ve o'KX4?msg1msg5a :"fr(msg)UeSyntaxlf.msg(2, "S yntaxError:", str(msg)) self._add_badmodule(name, caller.Yelse:<if fromlist`for sub in%)0ullr1 = p+ "." += n,v31in s4) fI2continue?tryx import_hook_, [sub], level=sexcept II as msgz msg(2, "9q0def scan_opcodes(<V, co)# Scan the $ , and yield 'interesting' D combinationse: = co.co_ ;sVconstPoparg[(op, arg) 3_, dis._unpack_2(if op != EXTENDED_ARG]p\1i, mJ)`enumerate(s:Tin STORE_OPSZ M"store", h!s[O.], if == IMPORT_NAMEei >= 2qgs[i-1][0]A2LOAD_CONSTIPV2][1]>+y212"ife0: # absolute T+_+^,hg7 # relativn+n,Ju 7, mL ZRner =k^qor what?s'Iner(+!if*0, ==qm.globa4 s[+U] = 1$(elg q zhave_sta 0pt is not Non3)`if "*"){(w D = [f for f in fromlist if f != "*"] self._safe_import_hook(name, m, F, level=0)Cif have_star:p # We've encountered an "r *". If it is a Python module,Qthe code has already been pars`d we can suck out theOpglobal /s.$mm = NonBif m.__path__ Ais pointdon't know whether '' J2sub# of 'm' or a . Let's just tryNP2fulo first} :h`s.get(__ + "." +P1C1mS1jfW 1not[.,Ms.update(mmd m.==0.__/__ q[_] = 1Oelse Jelif what == "relativ""\-} = args!ifFVzkparent = jdetermine_$(mYB0.__1__,S B2 expect anything 1 generatorraise RuntimeError(%) for c in co.co_consts if isinstance(c, type(co))(Ascan-mmdef load_package(}@, fq+ , 7 T!.msgin(2, "="90newJ = replacePr1Maps13 (3 = QaBadd_(-U file__ =B)D = []# As per comm`at topV, simulate r z additions.  m.__path__ = + packagePathMap.get(fqname, []) A fp, buf, stuff = self.find_module("__init__",c)BEtry: WB5loaBy lB5msgout(2, "@0 ->| 1return m{kfinallZif fpnfp.close( edef ad", )>MD2 in(#s#]E.![L]B = Mw2VmP", , parent=None is not # assert H'@fullo# =j0.__p__+'.'+ 0Jelsed> *bYd{excludee.0G3, " R -> E5Dd", lKraise ImportError(!%if$!iflys.builtin2 R(O,yp, ("", _C_BUILTIN)7 Q_#thG* re(4 """Print a ! to stdout, listing the found P with%irs, as well- that are missing, or seemlb.K5""" p(" %-25s %s" % ("NameFoFile")/@----//"# @keysQortedJ.(Ipfor key mEcgF[key'ifg =P", end=' ' m6m6 YV2key`file__#""RP-/TmaybeCany__M  ""M0}*:"&v [r +D@[len=] 6Rbreak"1if debug andL3"in(processedT !J 2msgout(2, "U %r changedK]%r" \D =% (,&,)= remains un* | o )consts = ir\(-# pif isinstance($[i], typ)0K&" =4 '$co4B(co_)P=tupls){=@) Stest(# Parse commAlineGb getop6try op0argO%. (sys.argv[1:], "dmp:qx:"ccexceptW.error as msg\print(msg392# Pj options2= 1@omod00addB = [vexclude@o, a == '-d's+{4m41 if o == '-p': addpath = + a.split(os.Esep)4Bif oJqJdebug = 0,x,exclude.append(a) 5 # Provide default arguments Qif nosscript = "hello.py"-Oelse&targs[0]qSet the based on syA andedirectoryb4=-5[:]c[0] = A.dirname(FM=v@2if L6> 1pprint("&":"Cfor item in15 ", repr(,)oaCreatemodule finderurn its crankamf = M*F)(,#, 0argt61:] ifImdomods = 1tcontinue(+W([Q[-2:]`+.*`%mf.import_hook(arg[:-2], None, ["*"]. OH62mf.load_filet,rmf.run_ $e(*0ret`mf # `"-i{ging if __j!____main__6try+Ctest\ except KeyboardInterrupt2MD\n[i2ed]") # # Package analogous to 'threading.py' but using processes<Smultiing/__init__.py cThis pa0is @ndedcdduplicfunctionality (much of #API) of &es instead+s. A # sub'.dummy' haslsame API`is a simple # wrr%!'.Copyright (c) 2006-2008, R Oudkerk # Licento PSF u Contributor Agree>X  from . YEext }q stuff &%# __allb1 [xxCdir(%#._6_#) x.startswith('_')] globals().update((, getattT , (!)) )XXX These should=really be doc\r public*SUBDEBUG = 5 SUBWARNIN"25ZQAliasza! m -- will\reset by bootstVchildg! #'|Q[+pc ]A higher levelF module for using sockets (or Windows named pipes) # # multiprocessing/connection.py "Copyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = [ 'Client', 'Listener', 'Pipe', 'wait' ] import io 3os &sy TtructEtime eempfilitertools try: ^_' except MtNotFoundError8pass from .ELutilAuthenticasA, BufferTooShortFtcontextMPreduc4 _ForkingPickler = .awinapi_fWAIT_OBJECT_0, ABANDONEDTIMEOUT, INFINITE Im if sys.platform == 'win32' sQraisep= None  # BUFSIZE = 8192 # A very generous out when it comesflocal s... CONNECTION_T = 20. _mmap_countX!.() default_family = 'AF_INET' uies = [] if hasattr(,5bUNIX')V!Z+[[_ X_PIPE'X!] s _init_\(=>areturn.monotonic() +3outVVcheckW> 5> tdef arbitrary_address(yG"''R&an1c free 66the given DB#ifb!('d0hos!0)D-el>>`# Pref2ubstractif possibleavoid problems with o# size. W0codaICapplsps, somelRs havNun_path as s 92 bytes inQ_un sw.0if #.a_-pets_sup&eds?Sf"\0l-{os.getpid()}-{next(5)}"qAt0.mk (prefix='Uq', dir=@get_&o_dir()j `r'\\.\rp\pyc-%d5' %(/, ), dir="") selse: (raise ValueError('unrecognized family') def _validate_()O1'''WChecks if theBA is =A forcurrent environment.?Gif sys.platform != 'win32' an == 'AF_PIPE'F0 %sFnot C.' %!) {e{GUNIX{# double cO0if vhasattr(socket,w,(address_type( aReturn&2s o.This can bedaINET', A, or}X~HtuplyY@ el61str.startswith('\\\\'<WWor util.is_abstract__namespacD f Y  q8%r l#) # # Connection classes # & _$Bax_handle = None__init__(self, &, readable=True, writS/# =8.Nqdex__()#ifO < 0 2"in Y"F%Y "at least ones`[`\`Y`` must 1.WhT% =R "g% =e# XXX should we useFinalize insteada __del__?=5elf!is~ Dcclose(W_d]Y"OSU"9T"mGo% mc8!isroe-onlyuu %utbad_message_lengthxt] = Falsen 1close() % raise OSError("bad message length") @propertydef closed(self):( """True if the connection is35"""/preturn E._handle)ONonexreadablez5|!vOwritv5v!vVofilenoFile descriptor or 0okoZccheck_)~ .C r-if@not '+:tryd(ofinall3 =isend_bytes, buf, offset=0, size= ASend; data from a -like objectom = memoryview(buf# HACK for-indexing of non-wbuffers (e.g. array.Lif m.itemJ > 1 <&m)@0n =&(m#ifSJ < 0ObSValuee}negative"J3n n  AO"m[l:2]^-?obja (pickl)< _ForkingPrer.dumps(Irecv2maxqReceive-s$as.."2ZU and UM6Sbuf =ea N- sel f._bad_message_length() return buf.getvalue()  def recv_bytes_into(self,., offset=0):.P5""" Receive =` data B a writeabl-like object.?the number ofLFread)t._check_closedC with memoryview(buf) as mR# Get0izearbitrary5fer/Pitems)D= m. " " * len(mKfsJ < 0praise VError("negat"O5eliQ>XO too largeYresult = qBm/[.tell!i< + 8BufferTooShort(\ 2# M can fit in destEjseek(0AN3(m[5// (4') <]o  a (pickl)f35?buf ]_ForkingPer.loadsasb'()uApoll, timeout=0.hWhether e is any input avaip to be 5r/__enter__=c__exit-, exc_type  'tbJ if _winapi:Yclass PipeConnection(_ GBaseO% Fbased on a Windows named pipeOverlapped I/Oused, so handles must haeen createdqFILE_FLAG_OVERLAPPEDi_got_empty = Falsef@, _CH=8.@/B"._$dBsend,'' Lov, err = .W AFile4[<5, oTZ=True>try[if err == _winapi.ERROR_IO_PENDING: waitres = _winapi.WaitForMultipleObjects(>Q [ov.event], False, INFINITE)5uassert z= WAIT_OBJECT_04nexceptov.cancel(dYraiseF~finallyGnwritten, err = ov.GetOverlappedResult(Trueh6*= \ == len(buf) def _recv_bytes(self, maxsize=None)0if $._got_empty_message()" =,return io.B+IOV?elsfb = 128 if@ is  5S min(,) F|/tr$ovReadFile-._handle, ,D o=9!"if7<t<|&F5 0 Tnread:0<%?f =! f.Me(ov.getbuffer()4yf&eleMORE_DATA bet_more_data(a OSError as Q.wine(= BROKEN_PIPEA EOFm NA 8SqRuntimeW"("shouldn't get here; expected KeyboardInterrupt"Apoll{ , U>out 9 or:PeekNamedPip)[0] != 0qB return bool(wait([self], timeout)) def _get_more_data(-, ov, maxsize):/6buf = ov.getbuffer()!io.BytesIO.write(buf6 left = _winapi.PeekNamedPipe._handle)[1]pqassert A9> 0$if is not None and len$ +; ._bad_message_length47errzReadFil,pcerlapped=True rb?", Pov.GetOv1~Result(7 6= Z1 == .f  ^f class Connection(_ 4Bas91"""f :&based on an arbitrary file descriptor (Unix only), orKa socket  (Windows).r $ifQBclos1, _ =_multiprocessing.h 2 p-_ QFsend'Oread&Arecv&Oelse"os""osp0os. )2q, buf, =|remaining `b^ whv2n =Pai }^E-= nXD7if |:= 0c#Ybreak5wbuf[n:] ,  ,  =_>"= ;{`!>qchunk =(V -V4 @if n% HKOraise EOFErr 9!OS8("got end of ur@k"$bu9 'uf_e=7b> 0x7f0pre_headestruct.pack("!i", -1+ZQ", n*E(d # self._send(header) self._send(bufYelse:*# For wire compatibility with 3.7 and lower8v = struct.pack("!i", npif n > 16384|0# The payload is large so Nagle's algorithm won't be triggered C#we'd better avoid thst of concatenation.K< # _c# Issue #20540:e before sing, todelays due#&"on a TCP socket# Also note we wantJ% a 0-length buffer separately,A"broken pipe" errors if~other end close)  +!) |def _recv_bytes(., maxsize=None)g0buf4&(40,'unbuf.getvalue()40if 7f == -1g k87 8o0Q",o@not O$ > areturn,3..?(BTCpollNwtimeoutIr = wait([B4], # a bool(r) # # Public funcn s # class Listener(objeck1'''QRSs a l( (.@Thisa wrapper for a bound` which&'E@ing'(bRconne4, o@Windows named}s_init__,qaddressz, family backlog=1, authkeW/# =8(Q T_typeA)) \or default_U#D4 = +rbitrary_(6W_validateQ"$if== 'AF_PIPE'."._eEEPipe|#, *2G JSLT $if O isinstance(!, draise TypeE#('.` shoulz0yteuU1=^aaccept\wAccept a connec%tion on the bound socket or named pipe of `self`. Returns a `ConnecL` object.'5''' 0if F._listener is None:#]raise OSError('-closed')0;c =T.accept($wzauthkeyndeliver_challenge(c,S0JOansw/r#" c5Adef ()#CD1 65if %ois not=#CuD.)@property,|address h#._.MRlast_/edS 4Y__enter__G .3xit-, exc_type Cvalu 'tb vsClient(, family=#, sGqcp1 to-MCa `L_`@h# =q7_validate_7($ifD== 'AF_PIPE'JPipe<7els*Sr ,$if*A andisinstance(8s, bytes:MCTypeO* should be a5 string'{[}\&@c ys.platform != 'win32':X(duplex=Truez-@pair3s at either end$aCO2if t#`s1, s2.=t).setblocking(i!2! Vc1 = i(s1.detach()pJc)2) 7pfd1, fd=0os. 1writable=False fd2, read1r1, c2 49 either end of a pipe 5''' address = arbitrary_('AF_PIPE')/if duplex:Uopenmode = _winapi.9_ACCESS_DUPLEX22accw0GENERIC_READ |GYWRITEBobsize, i = BUFSIZE, .OelseuINBOUNDA0T'h1-CreateNamedPipe(&z%, fFILE_FLAG_OVERLAPPED |?a+QFIRST_INSTANCE,3TYPE_MESSAGE7MOD HJWAITg:1, ,0NMP0_zFOREVER=.# default security descriptor: the handle cannot be inheritedINULL-h2?Fil+7, 06ULLOPEN_EXISTINGAA5SetPH KStat&h2Tb, None overlapped%Vonnec (h*V=True`_, err = LU.GetO0zResult(6bassert:E= 0 c\IC1ionwritable=c 1y2, read1creturn c1, c2 # # Definitions for c}s based on sockets # class SListener(object)Representa^ I which is bound to an a and lZ1ingR`def ____(self,5, family, backlog=1+#._|=.(getattr(I)g2tryK # SO_REUSEADDR has differenpmantics8Windows (issue #2550).Iif os.name == 'posix'p'@.set3opt.SOL_SOCKE;C8et.6, 18 wblocking +Sbind(R()  self._address =socket.get name() except OSError:O5xet.clos9!Uraise3/family = plast_acted = None $#if6 == 'AF_UNIX' and not util.is_abstract__cspace()# Linux 8 8 8As dobneed to be explicitly unlinked" =Finalize(*.R, os.1t, args=,), exitpriority=0A:lse TBdef m($#s, (.Y.<|s.setblocking(Truereturn Connection(s.detach())Hg?try {fgl2Y G#if1 is) w"._@P() SbdClient1'''R5a c t objectz4thegiven by ``JR`3 = F_typ+CwithN.L( getattr(,q) ) as s #s.o" # # Defini"Ts forions based on d pipes # if sys.platform rwin32':[class PipeListener(_: RepresentaW of at3 __!__P,{, backlog=Srjc$handle_queue = [:Bnew_q(first=w]=+  hBsub_debug('l, created 2D=%r''u!._@ize__,h, $ E\[^", a[False@flagS_winapi.PIPE_ACCESS_DUPLEX | FILE_FLAG_OVERLAPPEDzoh/|=LaFIRST_yINSTANCE return _winapi.CreateNamedPipe( self._address, flags,&OPIPE_TYPE_MESSAGE |kwREADMOD L OWAITo UNLIMITED_INSTANCES, BUFSIZE g0NMPe_FOREVER,MNULL;%) def accept(*%):H._handle_queue.append-S._new9()):4? = CZpop(0/:tryz~Eov =vConnectbp, overljd=TrueX ex OSError as ehif e.wine$!tERROR_NO_DATA8Yraise)# ; can occur if a client has already c.ed-# written data and th%is6 -- see Issue 14725.?elsw7res|WaitForMultipleObjectsl: [ov.event], False, INFINITE-^ov.cancel(8<aCloseH(0ofinallc, err = ov.GetOn~Result(t6bassert>9= 05ion+@staticmethod_ize_pipe_listener(#,   util.sub_debug('closing >T with<F=%r'I}Bfor gA in s N(1''')sRa)Qion oPed to  given by `Y`LXtinit_timeoutjzwhile 13)y[, 100h{ ?Fil,KjGENERIC_^WRITEKK0OPEN_EXISTING<~FILE_FLAG_OVERLAPPEDIt{ winerror not in (_winapi.ERROR_SEM_TIMEOUT,  APIPE_BUSY) or _check_timeout(t):UYraiseNelse,Ubreak($H! SetNamedPipeHandleState()4h, 0READMODE_MESSAGE, None 9)preturn gConnection(h) # # Authentica stuff # `_LENGTH = 20 CHALuE = b'##' WELCOM #' FAILUR #' def deliver_challenge(c, authkeyimport hmacif not isinstance(0s, bytes7C ValueErrora"key must be?,^{0!s}".format(typf"))`message = os.urandom(;)a.send_(A3 + K/digest =F.new(, 'md5').+(8presponsrCrecvr@256)# reject large_K"= d\ 11' received was wrong')NOanswM/ dassertV[:lenje)] == yGT%r' %8m$ =[M!:]'HN -5if K3!= zAsentv5 edyB1Supfor using xmlrpclib serializa[fclass Wrapper(ob!__init__(self,, dumps, load# ._$! =*U7" =? L" =TAattr'fileno', 'close @poll'obj = getV , ) setattr(self, , obj) def send:@s = 6._dumps(elf._conn.A_bytes(sWArecvW)R9#98vcreturnyAloadV G_xmlX0xmlrpclib.,), None1).encode('utf-8') ^q\Emethod = f)9.deKobj class XmlListener( laccept/fglobalu}cimport.client as5lib*dobj = r.h$ConnectionWrapper u, 4AXmlC~(*args, **kwdso # # Wait # if sys.platform == 'win32': _exhaustive_wait(handles, timeout2# RCALL ( which are currently signalled. (OnlyoCing the first0 might create starva issues.pIuL = lisready = []vrwhile L> re_winapi.5 ForMultipleObjects(L, FalseUD1if G= WAIT_TIMEOUTh(Ybreak:Belif5OBJECT_0 <=M<w+ len(LR{-{FeABANDONEDhk2 n.seraise RunP Error('Should not get here'@ady.nd(L[res]!6+1:;huout = 0u _ _e{ ERROR_BROKEN_PIPE, NETNAME_DELETED}PL@o:_5=5'''y till anTect i G2 is/Rable.ts  of thoseHsIJyPK$if iINFINITE ?< 09,el=?d= int(* 1000 + 0.5) object_list = list(object_ 3) waithandle_to_obj = {}!ov0U = []Pready,ects = set(RT=Etry: for o in "& 7fileno = getattr(o, ''*except AttributeErrorn+ [o.__index__()] = o5OelseO# start an overlapped - of length zerTX ov, err = _winapi.ReadFile( (), 0, TrueB!OSO as -oNone, e.wineI /!if0not_!y_3s.5_raiseWS=ERROR_IO_PENDINGZ._nd(ovv.event4t# If o.; isRpipe @O andI= 0 then!reOHTomessagEGi< x, but it HAS NOT been consumed...Pif ov sys.getwindowsversion()[:2] >= (6, 2)C... Bon WL! 8alater, wherGCthe  =s !_zuov.GetOResult(Falst?|1z-0if z4uand has)_got_empty_'' Q.o.8! =`Ss.add(ov`timeou)0 RF]_exhaustive_(.keys(), Tukfinall# request thatis stopvVov.cancel() #  C>allm/top"try:  _, err = ov.GetOverlappedResult(True) 0 except OSError as e:%+\`e.wine+%!ifnot in _ready_/sVZ]raiseOK!= _winapi.ERROR_OPERATION_ABORTEDYo = waithandle_to_obj[ov.event]oobjects.add(o1)O== 0~%# If o.fileno() is an ob pipe _ thenJa zero length message HAS been consumed.C if hasattr(o, '_got_empty_M/').o.40 = U vA~update(h] for h$3snreturn [o*o*W_list if >s] else:import selectorsr# poll/P have{p advantT0of requiring any extra # descriptor,}trarily to e`kqueue (also,b"y Re a singl# syscall)ors, 'PollST_Wait& =.29N"or51defL(i, timeout=None=1'''qgQ tillX !s /Rable.t?R!s of those sIwhich arePKYwith  ()v ;objs $b>.register2,EVENT_READ):$ifP(Wbdeadline =0.monotonic() +:out[QwhileOuy9.("if_KrQ [key4<a(key, z s)Fx R 05 = 2-26n< 0 # # Makenection and socket@sharpossible # if.platform == 'win32'qreduce_connection(conn): handle = .fileno()with socket.fromfd(2,uAF_INETSOCK_STREAM) as slsE . import resource_sharerw*Lds =!Q.DupS&(s.return rebuild_ ecb, (ds,readable@writJ?def?=83 = ds.detach>BConn(-(/, YAredu.register(E7Gduce!) 78pip! Paccesa((_winapi.FILE_GENERIC_READ if7 else 0) |nwHUWRITEI>IyD!dhADupH", 8b hk.K9; D0(dhq98h!FPipeDX: B0) ' ,dfz*Fdv#nJUifi?0(dfd fd`f`\/fdLX:7 -#) $os %sy thZing 0pro_  __all__ = () # # Exceps # class PGeError(!Dpass)BufferTooShort(8.rTimeoutW, Authentica3 Base type for?texts. Bound methods of an instanceBthis8are included in ,of __init__.py&r0Conh(object):) =O 7: = $-8 =  !? = current_" = static(.'/pa; &) active_children = staticmethod(process.active_' ) def cpu_count(self):'''Returns the number of CPUs insystem'''7num = os.Y) ifH is Nonelpraise NotImplementedError('cannot determinVcpus'a"s  s such as `Lock()`, `Condition()` and `Queue()`0can be used to create shared objects..cfrom .s import Sync6P(ctx= .get_context()cm.start(rcmUAPipe^, duplex=True]wo connec ed by a pipe7y(a non-recursive locksynchronizej_ _-<R' '\j ,=Ac8f (/, 8HSemaphorvalue=1s/dvT(wvBounded9f?b6 " s ?EveP @an e#kT SBarri, parties, !on, timeout$bH{ (1Queue(self, maxsize=0):  '''Returns a queue object'''%afrom .s import Q,"rD"(mh , ctx=self.get_context()) 7def JoinableM(+#, >3 aw HSimpO1T (RCPoolI processes=None, initializerargs=(),v!tasksperchild1i_ pool><p(J)es  # l} RawValue/typecode_or_ 0, *sosharedcI3q (.1RawArray aP~, lock=Trueynchronized  173, *w   =%freeze_suph Check whether this ifake forked I in a frozen executo.If so then run } specified by commandline and exit?7 if sys.platform == 'win32'9getattr(sys, 'x', FalsoTspawnn . 0^vlogger(self):# .'''Return package logger -- if it does not already exist thenFit is created.5''' from .util import get_m%r1() 0def_to_stderr(self, level=None):)@'''T on4ging and add a handler which prints to W 6logo ( allow_connection_pickling Install sup)for sendBsusocketsbetween processe`# Thisundocumen0 I: evious versions of multiT5ingo# its only effect waORmake  objects inheritable on Windows/#set_execuE;&,  G Sephe patha python.exe orwbinary used+&ruVchildQ instead0sys> when usthe 'spawnstart method. Useful people embedPh'\, 6 () Sforkserver_preload[module_names] l& &=0tryHF in ^Ereally just6int$RL (tcontext h#ifI:try%`ctx = Pcrete x"s[']:except KeyErrorFraise ValueP('canSfind c %r' %!) Kgctx._check_avail%():ctx/_4none=FalsF.]MMZ,cPAset N1conk'@propertyqbreducek Controls howwill be 7Gam that can be]shared with other8es.rlobals().get('dHer.setterg f, reductionC):  globals()['reduction'] =  , def _check_available(selfL pass # # Type of default context -- underlyingcan be set at most once # class Process(pS.Base_start_method = Noner@staticTPopenPC_objHreturn __D.get 3()..._KDC( nD$ =lq_init__d,+8|.$ =*(dactual!%Y", 1=Hu#if1 isdIl0if >+._o-1.=E 5@(Jelse6iuper())9setU(, force=False .1not2P and B aise RuntimeError('~ has already been/%') hd1^,`7> HHallow_nonE 36if K y y  f._name>9allBs .ys.platform == 'win32'x['spawn']Ds = ., 'fork']  odarwin' J" [*-, i3&if.HAVE_SEND_HANDLE/.append([gserver)0 A(` typesmq fixed JL # !C'ARForkP=E # ==KOC pfrom .py_ import @aO`S t_method = 'spawn' @staticmethod def _Popen(process_obj):!>pfrom .p&_V_posix import ? 1breturn X 'class ForkServerPz*S.Baser_start_ = 'forksA>[0Context( Dname! =(?SO[ \E]b1gOlWcheck_available(self"(if not reduction.HAVE_SEND_HANDLE3raise ValueError(1 L LZ~"')f_concrete Qs = {^M!':$&),s!: b!2F  +}R if sys.platform == 'darwin'# bpo-33725: running arbitrary code after {() is no longer reli}p# on macOS since 10.14 (Mojave). Use  by default instead.M_LB = D, o!['X1'])GFelseQ#P MXM9i:_win32,h " =!K#Xp]) # #ice theA # [Yforce:(` ._actual0 = C]CQ that`curren @reades child j0_tlX th-ing.local()2getqAing_(bgetattr(G, 'spawning_popen', None) def set_spawning_popen(): _tls. 1 = "@VasserCC(obj;Nif g]A) is`draise RuntimeError(|%'%s objects should only be shared between processes'A through inheritance' % type.__name__8 ) # # Support for the API of Smultiuing package usqthreadsE */dummy/__init__.py&TCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = [ QP(', 'current_active_childre0'freeze_s !','P'Lock1R Semaphore BodConditionCQEvent.`arrier AQueuBRManag1Pip@Pool$Joinable,!] D Imv! i deading4sys tweakrefarray from .connec J!, %, ,, ?, 2, B0qpclass DP(!.T1): "s(self, group=, target  args=(), kw #{}L l.a\ , W , GO)Kq._pid =" 3 = .WeakKeyDiLary(Nstart_calleW[FalseX pa; = &()6G3i>Clf._Bnis notG $""Pis {0!r} buXH{1!r}".format5GUP,)1 6Tru0if hasattr 6, '-  .&[] Kv@propertyexitcode|D1and.is_alive(7return 0dKelse#7}) = U& =. +&()1  children = current_process()._children for p in list(!):!if not p.is_alive(!4.pop(p, None)?\returZ def freeze_supportSqpass # class Namespace(object}D __init__(self, /, **kwds#.__dict__.update($FCreprF;ritems = H"()gtemp = []VWname, valuea6X&\).startswith('_')e.append('%s=%r' % (=f !.s[q'%s(%s)=kP__.__N__, ', '.join(w@)) D0 =  ,Array(typecode, sequence, lock=Truea1.7#) V=xmu?+4 =  "C" = @property5%xbG?..setterCC |/__ '<r, %r)>'%^`,ef Manager[sys.modules[+]shutdown2SPool(~0es= , wializersargs=()Sfrom ..pool im'p ThreadRGh c ^) JoinableQueue = r Analogue of `multi ing.connection` which uses qFs instead:qsocketsR Ev/dummy/K1.py(tCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = [ 'Client', 'Listener', 'Pipe' ] nm familie [$] LI daddresRybacklog=1J_()\lbacceptDC/(*W@.get\closeL9! =! IPIo__ente= .x@exc_, exc_value, exc_tb): self.close() def Client(address,_in, _out = Queue(), M/`.put(()q, _in))return Connection(PvPipe(duplex=TruexOa, bsV.(),h@b, acXclassobject): __init__(1.! = < in*inqsend = < `_bytes*0out0 /Drecv/ /fin.getCpolltimeout=0.0"ifv_in.qsize() > 0Ft3if Ro <= 0.3UFalse4Fwithonot_emptym c.wait(n.0$Fpass#s__enter'= .xe.Pype, Cvalu Cimport errno $os selectorUignalUocketFtrucy5threading*warnings from . ycp sprocesstcontext6Aredusource_tracker[spawn util __all__ = ['ensure_run', 'get_inherited_fds_to_new_%',n 'set_forkserver_preload'] # MAXFDS_TO_SEND = 256 SIGNED_STRUCTig!.SP('q') # large enough for pid_t]% Fw ZA # S(c .Nf = Nond(`live_f`) /pi$ {pulock = wf.Lock(a_modul['__main__VgAstop# Method used by unit tests to 3R the tl;0_un ed ;aQid is jLG_!#  "a" file descriptor asks!#os Q<_fdte os.waitpid(self._forkserver_pid, 0) ! = None %if not util.is_abstract_socket_namespaceoaddress):Lxos.unlink10 S ydef setRreloa, modules'''Set list of' p to tryIF in H process.''''all(type(mod) is str;^Fp_"raise TypeError('' must be astrings' f = >get_inherited_fds'''ReturntEfds 3 from parent_aThis r@s] if the cur3A waslstarted by;kd.` `connect_to_new_H, fdQquestzPcreat~_child)s a pairY,(status_r, data_w). TdallingI can read)l 's pid and (eventually) itfBcodev4tshould w`pickleeparationzDeensure_running(pif len(} + 4 >= MAXFDS_TO_SEND=DValutoo manyRwith .(.AF_UNIX) as clientc., E_w = os.pipe* #r,/*0all:5= [4 #w,_alive_fd,mresource_ker.getfd()]0s +=N :try'[PreducP.send8=", I $2F/ wm[excep>os.close(6ra #w#D p0finCNyp "&w)n  SPMake q that aj k3..SJ"`be cal{any process. Note that usually a child process will just reus5e forkserver started by its parent, soIensure_running()Rdo nothing.*5''' with self._lock:resource_tracker.d .#ifIp_pid isZ None_c#was launch`efore,?Pit st ?xG@pid,$tus = os.waitpid( ,!WNOHANG)K!if>pidk#]alive>"mreturns# dead, it agai(os.closes>_fd @addrW=x 0O_fd 1, ^ cmD('from multi import main; ' +EF@ 'Q(%d, r, **%r)') .ypreload_modulesdesired_key({a_path', 'sys }_data = spawn.get_preparation_('ignore' = {x: y x, y in .items() if x ?elsAE^}qocket.s(.AF_UNIX) m~istener*@`connec.arbitrary_#('Nl\c.bind(1outil.is_absm"t__namespaceB55hmoi~, 0o600p (LL# all client es own the write end of"}" pipe;;Q# whe:yXqterminaae readLqbecomesycB_r, wr(?try&fds_to_pas[er.fileno()_-r]O%= (8, ,OS9exevexecutable11argqexe] + V___interpreter_flagsG += ['-c', cmdfv_passfds(exe, args, fds_to_pass) }except:'os.close(alive_w>&]raise@finallyYrY self._forkserver_address = r3 fd4 w4 pi/apid # def main(listener_fd, r, preload,$_path=None, sys)v'''Run A.'''$ifJ*Y`if '__|d__' in"F ando is not v<@process.current_()._inheriting = Tru/trspawn.import( Cdel  for modname #__#_(@ ! IZErrorU}5 autil.__stdin()psig_r, w = os.pipe(los.set_blocking(&r, False"w"{ sigchld_handler(*_unusedZp# DummyCnal *, doesn't do anythingW4/b{D# un SIGCHLD allows the wakeup fd toify our event loopKssignal.E:,)# Atectb, from ^C&O1INTN^F_IGNM}1o95sig3IR, val#/.items()} `# callXos.write()/-`PythonAracy2Z0_fdw{!# map child pidsw0clim1fds#0pid{with socket.(.AF_UNIX, fileno=T) as 1, \^selectors.DefaultS(4Nh@.getatT@.regr$, s.EVENT_READ:97QwhileU-10rfdP[key.0obj?b (key,gsa.select()]  if rfds: mbreak if alive_r inC# EOF because no more client processes leftdassert os.read(t, 1) == b'', "Not ati/?"Eraise SystemExit?sigGot SIGCHLDjM, 65536) # exhauswhile True# Scan for child<;?tryP!pid, sts =`waitpid(-1,WNOHANG)_except CP_Errort O~`if pid0G)"@_w =N_to_fd.pop(ONone"if`_w is not 0 returncodeJ`status|@exit^(sts)zp# Send 2 3; to+G%write_signed()&, >BrokenPipe8#vanished 2Opass% os.close?elsZm# This shouldn't happen really warnings. ('forkserver: R]Oed 'J 'unexpected` %d' % Dif listeneIncomingJk reque5ithW0.ac()[0] as 1# Receive fds from(= reduction.recvfds(s, MAXFDS_TO_SEND + 1en(fds) >:  bRuntim("Too many ({0:n})to send".formatGOl)$r,2, *6/fd&!e()  pid = os.fork() 1if +O= 0:%.# Child$ code = 1% ?tryj nlistener.close-selecto1 unused_fds = [alive_r, cp_w, sig/w] N .extend(pid_to_fd.values()B@_serve_one(r, fds,D >!old_handlers except E?ionBsys.6chook(*__info,0stderr.flush$ ofinallzos._exit(Oelse a# Send^to client process !write_signed& w,mr BrokenPipeError 8#vanishe 2/pa !t[pid] ={ #os for fd in?]Ifd) 7!OS/O as if e.errno != .ECONNABORTEDraise def % u%, Pose unne[ary stuff and reset5nal:;al.set_wakeup_fd(-1Q9sig, val?t.items(){Gdignal(4F:n (_'r. _#fdresource_tracker._-*I`._inhe:0) =T# Run object received over pipe<parent_sentineli3duprA = spawn._main +, Bopreturn 9 # # Readed numbers # def read _signed(fd): data = b'' length = SIGNED_STRUCT.size while len(90) < 2gthMQs = os.reaf, - 5)J,if not s> raise EOFError('unexpected'?Q += sQkreturnbunpackx[0] def write 3, n =msg@nu6msgSnbyteX(fd, msg2&6= 0;sRuntimeashouldget hereBmsg[{Q:] # _forkserver = ForkS () ensure_runnin,. get_inhe&@d_fd/  connect_to_new_proces7%G set]_preload = .%) Module which supports allocation of memory from an mmap<Smultiing/heap.pyJCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # im bisect `collec#s defaultdict  $os%sy tempfile thBing g.contextdAreduv, assert_spaw0)util __all__ = ['BufferWrapper'" I3able classTwrapswR, andblocks can be!ed+ f sys.platform == 'win32': r_winapizArena(objectn1"""9 A shared area backed by anonymous (Windows).CO _r$= ._RandomNameSequence()__init__(self, f&~! =ofor i in range(100>%name = 'pym-%d-%s' % (os.getpid(), next.)AQbuf =8.2(-1P, tagb=83if .GetLast) hYbreak# We have reopened a preexist3buf.clos{JelsePFileEWs@'CanPfind  y1newC%=, b=t.ufP_stat!, 8U @1get1D _spawning(seWlf) return self._state def __set0__(&!, %):'Nb.size,Kbname = W_/# Reopen existing mmapZbuffer =.$3(-1kv0tagt= # XXX Temporarily preventbuildbot failures while determiningMthe correct long-- fix. See issue 23060=assert _winapi.GetLastError() == ERROR_ALREADY_EXISTS else:class Arena(object5"""xA shared memory area backed by a t0y f(POSIX).AM if sys.platformz'linux'_dir_candidates = ['/dev/shm']O9]FinityWfd=-1-"5izevyfd = fd0if J= -16#r is created anew (6!6, it means we'r)mFLqfrom re!_az) below.@fd, ! =@.mks(2prefix='pym-%d-'%os.getpid(),32dirJp_choose(G)os.unlink( util.FinalizeCos.close, O.fd,Zftruncat9( #0 89GBelf,] 1# C a non-storage? diUif possibleV# to improve per5:anctfor d i ; st = os.^vfs(dxt.f_bavail * s fr1 >=: # enough free space?%k* *@get_-)fcreducea_if a.iraise Value'uunpicklable because '` 'fork^`was en;`d when'F C, (artion.DupFd()sw, dupfdc]#.detach(Plregister(4!, Z) # # CPallow cation of chuDnks of memory from arenas # class Heap(object): # Minimum malloc() alignment !_B = 85 _DISCARD_FREE_SPACE_LARGER_THAN = 4 * 1024 ** 2fA4 MBq _DOUBLE_ARENA_SIZE_UNTIL5jdef __init__(self, size=mmap.PAGEA!):Z#._lastpid = os.ge ,()$ock = threading.Lock&# CurrentF Qation N* =# A sorted listavailable bl7Bs indsUlengths = []T# FreAmanagement# - map eachhU to a0`(Ap, startBop)`/_to_seq = {}i L)` tuplepJthe  jK ing at tha12fseB # en +op3Map /ir  5useC{1ed_defaultdict(set 9LpO@to fS- see comP() belowC_# StatisticQ1n_m0YnS @sGqcmethodroundup(n,  # must be a power2IV0masDE - 1return (n + )P) & ~ Anew_p PCreat~2newP withY@lease given **XTelf._1maxl ._/:), E# We carve larger and  s, for efficiency, until w1# rPa:A-ish (roughly L3 cache-d2if # < 86*= util.info('H!at7 a<R%d', 1 = (v$@s.ap(A6, 0cwydiscard0 Possibly delete 2 (unused)3X! =a.size  # Reusing an exist rena is faster than crea new one, so # we only reclaim space if it's large enough.6"if length < self._DISCARD_FREE_SPACE_LARGER_THAN::wereturnblocks =Jallocated_`.pop(a)3assert not %3delHstart_toG[C_, 0)]-.op,1s.removeX5seq0lenUBseq[K{4seqABC, 0,U)N!if:seqCdl~!) adef _mv(.v, size)p"# 9s a{ -- it might be much'r_i = bisect.Q_leftn"._sw4`f i == )\Anew_(MFelse7vfgths[i&+Pq ,8p, stop)iO%]'1g&TPadd_free},0b# make available and try to me~ with its neighbours in the  &:try Bprev,except KeyErrorV5asstx5, _svabsorb(# Mnext)_e ? = Patop - F1V.append(uy LA = [Hm.insor]P r 5vstop)] = block def _absorb(self, block):"# deregister this" so it can be merged with a neighbourE(arena, startRop) =J%@del !._'A_to_[>/)]1/op0Bop)]length = stop -N0seqelf._lenOBseq[5useq.remove()Aif not seq>wW)qse)breturnK_allocatedB s X!s[C/()(, +0# A) is entirely free, discardtBfromuprocessE/_@C'T_pending#s$ Free all theAs in; list - call-Ce held.while True:tryum_fs.pop(R4except IndexErrorWEreak5r7add] (]^NM" aO qed by m\q# Since$()jkasynchronously@x0GC,!could happen# that it's!is:a7se,C,.acquire() woAdeadE (issue #12352). To avoid7, aO1try3is used instead, and ifk!Pcan'tivdEimmediately,2Cadded to a"ofxsbZJ Tsometimes law3 or,}7ingQQs() (wretrieving _ isJNstrictly thread-safe but under CPython`atomicn!nk6IL)if os.getpid() !=x0las :raise ValueX("My pid ({0:n}){ N{1:n}".format?C,e85ockWFalseR#23't 2 the lock right now, add the block to list of # pending+s,Ifree%cself._)__Y@s.ap()4Uelse:n# we hol :try04vnpis += 14#3ing((O1addQ( (,remove_allocated4ofinall.release() Qdef m[(nv, size)# return a of right) (possibly rounded up"if&6< 0Rraise ValueError("Size {0:n} ou range".format( Z`ys.max1 <=ieOverflowhtoo lare os.getpid() != #P._las n_init__() M!0ialafter fork/Dwithf?ockc"n_ # wLbe marked availabl[naup(maxS, 1),alignment(arena, startDop) PK 6real_stop+:! +7[6if ( < / ?%A# if#ed1is r than necessary,7 hGremainderU*   ; !s[Bs].add((GH)B o . # # Class wrappKp a Heap -- can be inheritEy child pro:Q # cWpBufferW]er(object):| _hP=W_F U9 = . .._state = +`util.F3izeas, args=I)create_memoryviewJ  Ic= self._state  return memoryview(arena.buffer)[start:>+size] # # Module providing manager classes for dealing # with shared objectsGmultiprocessing/FAs.py ZCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = [ 'BaseM', 'SyncMBaseProxyToken' ] QImpor! i D sys PthreadsignalTarray Tqueue 6tim 5ypeRos from os orgetpid tracebackformat_exc".connection;.context Aredu, get_spawning_popen, PSErrorA:Lpool. !__P__.__.#__Q<P ^&1Fun@hcommunica a/'s serverJdispatch(c, method, args=(), kwds={}GcSend a messageV using connection `c` and return response '''c.send((id, methodname, args, kwds)))Pkind,Dult = c.recv(0if  == '#RETURN':6k1ultraise convert_to_error(Dco) def$ d ~_ERROR} $el1in ('#TRACEBACK', '#UNSERIALIZABLE')cif not isinstance(result, str(,QTypeE!"R<q {0!r}  '{1}') type is {2},rstr".format(IQ@@)% *SRemot'Unserializable message: %s\n' %DOelseV5 1FValurecognized,T{!r}'!)) class Exception___str__(self ('+ '-'*75 + 1str2.%@[0])$) # # Funcjs for finding th9c ds of an object #Ball_Ss(objR`a list@I4Q`obj`)7temp = []8w in dirgfunc = getatt,"pif call (.m@.appWg9Sopublic2 which do/art with '_[ "9 = M.id_to_obj = {'0': (None, ())}Y+arefcou{!local_proxyX ( mutex = threading.Lock()def serve_forever(%):5''' rRun the1#r 2+F.stop_eveE(Iprocess.current()._manager_rfq6trypaccepte)oT(target=(>.daemon = Truen #Wstart while not!.is_set(l0.jwait(1 ex (KeyboardInterrupt, SystemExit`EpasskfinallIif sys.stdout !="____: # what ab ustderr?Sutil.debug('resetting E,Jerr';z y c, er Yerr__,gexit(0  _cI.W zOSErrorXkcontino handle_request, args=(c,)Vt$t.1_W7, cJq0 = 9 !`connec{`.delivhallenge(c,:key:Oansw9kc.recvignore, funcname4, kwds = >eassert22 in public, '%r unrecognized' %- It = getattj+E:ion-msg = ('#TRACEBACK',mat_exc(Jelse= Presulk*G@, **, "/ERETURN', result) # Etry: c.send(msg)except Eion as e7 HL ('#TRACEBACK', format_exc())e1 i d"Epassutil.info('Failure to message: %r', : ... request was2 p681e) def handle_K(self, conn)1'''0H0a a new(eection , t^+._sm@ SystemExit# Server.s_client() calls sys.exit(0) on EOFX= lfinall]onn.close($ l"Rs from the proxies in a particularcess/threadJdebug('st;1ng "r 7UQrviceG*ing.current_d().nam-arecv =. N id_to_obj = #.lVwhile not"stop_event.is_set():-1 A`method2 = qENone$0 = (&!vident, P, args, kwds7p YQ obj, exposed, gettypeid = [u]TKeyErrorkb\t0`local_y: !raise ke'if$inDPLAttribute0('a %r ofbject ismo=%r' %H(Hw , U(obj)^H 1fun5 =%@attrM5 reT"(* **+ msg = ('#ERROR', eO/ls0and>iid.getUNone)  if typeid:  rident, rexposed = self.create(conn,E%/s)Jtoken = T(x,Maddress, nDmsg = ('#PROXY', (!, `)<OelseVsRETURN' except AttributeErrorSif methodname is NonzvTRACEBACK', format_exc(>tryfallback_funcmapping[]Fresult = >S(04/", )Mobj, *args, **kwdsB \D?ult2E?ion2X Z/OFutil.debug('got EOF -- exiting thread servI%r',`/ing.current_0().x@sys.lI(0) Y send(msg@('#UNSERIALIZABLEI ^ ZO as binfo('2oion inu ... message was  , 68e<~.close(2126defgetvalue()Zreturn objy G?strB,?obj?repH-IE = {"'__str__':'6str0'__O !"#GETVALUED>h}TdummyHGpass&J_+5'''ZReturn some info --- useful to spot problems with refcounting 5''' # Perhaps include debug info about 'c'?0Uself.mutex:\result = []keys = list(<did_to_. =())4j.sort(for ident in 9 #if"n!= '0'!%.append(' %s:% 4P=%s\nY%s' %(/, [/],FH str'3obj>[0])[:75],return '\n'.join(!) ndef number_of_objectsaF, c)N0 of shared 7Q-# Doesn'tQ (len^.obj) - 1) as we should.6='0 H.rshutdowoS'P this Ocess6tryQutil.('manager received  message'0c.s[('#RETURN', Nonejexceptrimport traceback.print_exckfinallstop_event.seRVacreate, c, typeid, /, *args, **kwds(C?j a new+S and aits idt<P callable, exposed, metho>Pproxy E = \dhregistry[-2id]%4if o1 is )0if 2 or"g) != 1 )raise ValueError(p "Witho, must have one non-keyword argument"rvPobj =!:s[0Nelse0u( #"!= public_ s( -ifW?not}isinstance(\Ko, dict ?TypMdq {0!r}: {1!s}, m".format )7Q?exposed) + list(method_to_typeid) .ident = '%x' % id(obj) # convert to string because xmlrpclibJU # only has 32 bit signed integersFutil.debug('%r callable retur6object with id %r', !, aself.iAobj[#@] = , set(exposed), ,"ifa not in Zrefcount:=%0(uncref(cBu, tupleDdef get_ s(P, c, token)5'''RUC theAs ofsshared mindicated byQCOxs.id][1]accept_connectionOnameSpawn a new threaderve thisP4ing.current_0().v0 = ; c.send(('#RETURN', None))"s_client(ci%f.mutex:try-{VE+= 1, exc KeyError as keS# If no external references exist but an!0(to, mq # manager) still does andb  rebNfrom it, restorec's trackaof it .?theIpreviously stashMref.3 local_proxy_objL /3 \.2 :Sobj, ,6@( =DSpr re-end& INCREF P?elsraise ke!de#L T  Q !DEPskippY(u (if J<= 0Qraise AssertionError( %"Id {0!s} ({1!r}) has refcount {2:n}, not 1+".formatJ]ident, self.id_to_obj[/],6/y4)))5)Y -= 1,(if Xi == 0:0?del5 01if /in4 ]2# Two-step process in case the object turns out to contain other #D#xy6 s (e.g. a managed list of5s).H0# OXwise, deleting would trigger J? of stored value (anr) which\ P!in q attemp bacquir-mutex that is already held here2= (None, (), p) # thKY-safeutil.debug('dispos, of with id %r',    t # # Classrepresent statear # c)S(en__slots__ = ['!']INITIAL = 0STARTED LSHUTDOWN = 2@Mappfrom serializer nameListener and CliPtypes"_c1= {w'pickle' : (connection.L, T)M'xmlrpclib<?Xml?3XmlBz}`DefiniuVQBaseMLX ^1'''K! 3for!rs$_registry = {}_Server = e`def __0__(>, address=, authkey=L!a1ctx0)$ifJL[ g =s.current_3().$4#._$ =a # XXX6Ufinalif eg ('', 0@JAuthenticasString( >,"= .<. c' = &tl! =[O3`ctx = por get_ Vext()s8j Return server object with s_forever() method and address attribute 5''' if self._state.value != SINITIAL:/B3=3zSTARTED37raise ProcessError("Already started9r")p/elr HUTDOWNsManager has shut downr/seN "Unknownte {!r}".format(l)return Sr*registry,,y %Uuthke4serializer) 8def connec)C## m2xcto the" pXAListener, Client = l!_c[]I# =:" a=?Jdispatch(E, None, 'dummy'&= .c, initP=Zargs=()K{Spawn a5 for thiscM\(ifq is notgz callable(/+BType'+ must be a J';# pipe owhich we will retrieveo8swriter = ion.Pipe(duplex=Falseus yErunsd\*=Cctx.(+target=typefq)._run_ri`o @o)",   q)DD"id':'.join(str(i)Ci in !._06ityB!wname = __name__ + '-' + ident self._process.start() # get address of server writer.close()V7= reader.recv&=># register a finalizt]state.value = SuSTARTEDI*shutdown = util.FQ(' +p, type( 4)._y_manager,0Qargs=+> , :#._juthkey?s 0.zClient).exitpriority=0@classmethod def _run_S(cls,W4ry,3, aii",  c init)a=None,1)):},5''' Create ae0verport its and run iC# bpo-36368: protectO from KeyboardInterrupt signals.(.SIGINT,-C_IGN^!if is not (  (*-H2# cY = cls._S( ^inform parentcof the1'v~b.send(.$!un_*Vp#('ing at %r'Pm_foreverFid, /, *p, **kwds new shared object; returQtokenexposed tuplePasserO 1, 'r@Ayet u&ed/0conN[=$;try4d, = dispatch(j,2, 'R@', (Rid,)+LJl`I KTGT]U, id)wAjoin, timeoutl2Joie (t has been spawned(#if>u'.Z f /is_alive(- *! =q_debug_P*ARsome info about the servers shared objects and connections 5'''  = self._Client( address, authkey=)BEtry: breturn dispatch(c, None, 'debug_info'CkfinallG7.close() adef _number_of_)RBthe 8; of&Z8|Y$_enter__#ifstate.value == SvINITIALCfstart(H!HzSTARTEDH3{ raise ProcessError("Unable to "9/elr SHUTDOWN:sManager ha^}ut downr/seNkn"Unknownte {!r}".forma)fS_exit, exc_type 2val 'tb/AP.shutj@ticmethod|Rize_m"(p,, -,#, TqhSx U U; will be registeTas a rIT$ifB.is_alive(/Putil.('sending q messagf= 1(=D5N? 1 EMexcept E>ionBpassb4.join(timeout=1.0Qp0 st ifFattr'terminate'cg0tryEto `7D()` {I.; ( %:0.1%.-/util.info('manager still alive after terminate') state.value = SSHUTDOWN%Etry: 9del BaseProxy._address_to_local[]5except KeyErrorNBpass@property9Cdef Jf(self)7preturn CclassmethodFregister(cls, typeid, callable=None, prexposedKc4i( create_W=True5'''IR# a with the manY0<Rif '_ry' not in cls.__dict__+0" =*g.copy(&if @ is  P+q = Autoo:4 = or getattr(<C, '_ 1_',fA_= = Eor \ y s F|-ifl for key, 9in list([ .items()): # isinstance?aassertP(key)vstr, '%r a string' %|D F& %[|yid] = (k5,,,K ;*if) _Atemp, /, *args, **kwdsQutil.debug('requestingd ion of a shared %r object' )TQtoken# =f( A& =I Fdhserializer,=,^;qauthkey"#._?exp7EconnqClient(.}#, ^ lJdispatch(S, 'decref', VNid,)<8 .__name__ =%is[ 8) # # Subset whichA cle"a fork # /ProcessLsSet(set|__init__]1er_Z_X(, lambda:.(XnreduceZ$M0), # # Definition of BaseProxy # class(object): '''A base for proxies of shared 2s)1_address_to_local = {}#_mutex = util.ForkAwareThreadLock() )$def __init__(self, token, serializer, manager=None,8rauthkey exposedincref=TrueH_owned=FalseLFwith%.$tls_idset =* Q.get(. , )6if P!is" o s NLt(), ProcessJSet(gE.[6] =@ # ._tls is used to record the connectionbby thi1Bt7communicate uA2 at:3>[0]sidentit3allg# Rwhich`urrentm owns references andD8aare in?1!tDid =&.i"=V BxJ &0Cli = listener_c[?(][# Should be @0to  only when a[#xygbeing create:# oSserver; primary case: nestedX%s.# Rebuild( detects9is |L0ands value appropriatelyyM_by_3if ?not+T'=P.Auth casString('(Celif7?is jz7#._\Jelse1( cb"_p3().$ RZu00regr_after_forkj/)Wdebug('mak$toZ'aOname !4.Ding.@0().+ != 'MainS': name += '|' + threading.current_().name conn = self._Client( token.address, authkey=)Hdispatch(Q, None, 'accept_ection', (&,);RFtls.(0 =  `def _callmethod", M args=(), kwds={}):95''' pTry to K# aA of the refe( and return a copy"EsultMY6tryrvW A ex AttributeErrorGutil.debug(' %r does not ow$nn^]=4Ject(}%a.send(N._idkind, refr.recv()0if ' == '#RETURN'3G)el:[PROXY9exposed, t# =Cproxytypemanager._registry[?.%yid][-1]BVF  0r1 = U(=,serializer, ,@'#, = 7HBF`decref;R(id?8%PraiseGvert_to_ea(@gZagetvalueA;Get3"D$]'#GETVALUE' in #ifowned_by_ 8 * skipped INCREF4%r'@b @6$T E0setSn@Mstat =e!._)@clos>1Fin )p, BasePC"._ +!._H5 self._tls, self._idset Client), exitpriority=10!) @staticmethod def _decref(token, authkey, -1e, _z:=}.discardC3.idp!# check whether manager is still alivePfx rNone or.value == State.STARTEDmEtelldthis process no lon{cares about referentG:tryX util.debug('DECREF %r', 7&sconn = 5uaddressh=p)Gdispatch(H , 2, '3', PJid,)<except Eion as e B... Y failed %s', e;elsE5 --already shutdown- !we can close  thH0's 0ectfbecaus8U# the1ownDmoreces to objects for^qif not  and hasattr( '*')U0 %r>{proxies so1ing'Gping.cur_z().nameFtls..A(#0del'after_fork(t#._)! =0 -.!inUxy may just beaWQwhichXY7binfo(':% %_reduce__kwds = {}\if get_spawning_popen()0 C#['C'] =zZd<, '_isauto', False0YwexposedY_-return (RebuildProxypR(Auto userializer, vvBtype~jw deepcopyg, memo/WQ._getE(CCrepr?9C'<%s3 , idat %#x>' % \j('0.__)__.!bid, id'__str__(selfC): 5''' (Return representation of the referent (or a fall-back i at fails)MY6tryryrjself._callmethod('__~6__'Iexcept E?ionJ6(O)[:-1] + "; '__str__()'ed>" # # Func6used for unpickling # def RebuildProxy(func, token, serializer, kwdsO] pO objects..8 server = getattr(process.curz_(), '_manager_6r', None6 ifL3and .address ==Outil.debug('$ awned by w C=%r' {#[') _o:'] = True%6N.id not inid_to_localfxy_obj=.*[0.ids\p7 ;6obj/+incref = (2b.pop('!',U) and%inheriting', FalsjCr( q=@, **)s to create0ies ty typesAMakeType(name, exposed, _cache={})Qr whose s are given4`Q`/ = tuple( 2[!)]U%KeyError/Qpass #dic = {}yz5exec('''!%sX, /, *argst0 B%r, 3p''' % (w,*r), dic)B(Bas,/,.#._4_ =/5 = <(AAuto=t, authkeyT = ,K"= T#hnc"o-<` P@_Cli= listener_c[B][1]n$if-1 is<{sconn = Q/7  = dispatch([p, 'get_ bods', h&,)Qkfinall;Bs.close(9 ifnot None:  authkey = manager._u if"is None:( = process.current_3().$ 5ProxyType = Makea('Auto[%s]' % token.typeid, exposed)GpG1 = 0O(-, serializer,=,=,K rincref=Gd_ownedM._isauto = True[`returnxy # # s/callables which we will register with SyncM # class Namespace(object) def __init__(self, /, **kwds#.__dict__.update($FCreprF;items = listbH"() gtemp = []Vfor name, value in 6"aif not)p.starts G('_')e.append('%s=%r4(f f.sort(q'%s(%s)= kP__.__N__, ', '.join(w$))V4codp, lock='|+4 = E"A=I"geQ6.s.5. d/__iIr, %r)'%(()G^ Nperty(get@t) QArray\AnquenceSa1.7)Fps used by~Iterator1B(Bas@__ = ('__next__;@sendPthrow bclose'___itev(Y^h, *arg3 ._jimethod3QM4:', IJ5 K!K5KAcquirea,Yreleab1ing, timeout= !. ,)P- Pu else ($M G-QHself._callmethod('release') def __enter__(self):preturn ._callmeDkacquirD3xitC, exc_type 2val /tb^ class ConditionProxy(ArR_exposed_ = ('%, , 'wait', 'notify G_all' , timeout=Nonei ;C', (8&,)fuX?n=1O4QnKOJ3 A_forF, predicatefsult =+(Pif re AE[$if\ is not c :0endH! =+.monotonic() +5outQOelse?[)[ Qwhile Q4if  ^0- 65if J<= 0|"Ybreak<:(2 oQEvent]Q(Base e gQis_seSPclearYj)hI`/@?set=<.x=;0out`bBarrieb __getattribute__\q, 'abor}*re{7JoW.J>.>@propertypartiesNE#('E'g n_I?ingi+Gkobrokenh+DeiNamespaceProxy'(BaseProxy): _exposed_ = ('__getattribute__', '__s0del#A__')CEdef 9__(self, kecg if[0] == '_'}return object.LQp2callmethod =8 &'_-Bth(key,) s, valueR]SM{1', &LMt)) class V 0get 3setD1getW.y ('AVs:;A{1, (k  = property(get, set) V!__Pitem_<(types.GenericAlias$AListb = Mak4iType('Tkd'__add$contains2delE0len)H0mul{Preverr4setE:`appendbAcoun3extPindexQinser0popremove',Er"so(2__iw"#))<#;  1__i%% S`` I b_ DicDiter p 'clear@copyG0, 's@keys0popsetdefaul`update8!s'I&))"._@_to_i{(3'__: 'Iterator} Array33g{wOPoolcbapply', 'apply_async', 'close Dimap_unorderedjoin', '%map_asynCCstar terminateA)) BasePoolProxy._method_to_typeid_ = {mSapplyL@: 'AqcResultN D: 'Iterator\ "} class (!):&def __enter__(selfOpreturn -3xit,Q, exc 2val 'tbG@.j() # # Definition of SyncManager # ![1'''2Sub@of `' ` which supports a numberpshared object 1s. O2Thep registg are those intended for the phronizaD of threads, plus `dict`, `list` and `Namespace`z`multiprocessing.()` funcc creates ?ted instances ofQthis .+ N.`('Queuaq.)+Joinable%?', 3sEvent',!, cnILock:, Acquirer< R, =>SemaphorF0Bou(7 t ACondH b%, 4 yBarrierE#, A Pool', pool. ,{0', o, Lista D0', _, Dic. 1Val!, _ Array', 1 5',  =% #PObed by W&w p=d,o=Falset 90cMemorySBServif HAS_SHMEMh( _/rTracker "Manages one or more shared memory segments."  def __init__(self, name,-_es=[]):4;+.____context2! =G3%:s =g register_B "Adds the suppliedQblock to tracker."util.debug(f"R( {!r} in pid {getpid()}")O).append(J)destroy""Calls unlink() on  Bwith& and removes it from2list of Iss beingHOd.""JDI: Ich!.SM?|.close(M.q   4allM4forOr.Js[:];' 7 S__del" 0$lf.__class__._C__}.G1 @ getstateqreturn )*lf& jsj!, x G?*#  jrServer("):'public = .9+ \+1 ['', 'release6s']k*args, **kw ,, 4 baddres3lf. #c# The QLinux abstspaces can be bytesDif isinstance(L,) :! = os.fsdecode7 $2/ =_TU(f"shm_{v/}_ @Jzx~rted byicreate(self, c, typeid, /, *args, **kw G): ,"""Create a new distributed-shared object (not backed by a  N(memory block) and return its id to be used in a Proxy OaI."""M# Unless set up asu p9, don't make__contextPa standard part of q. ThisJs things easier for supplyingQsimple functions. if hasattr(self.reg^"y[][-1], "_I"*['/Q'] = f Server.c', ; 8 Ddef shutdown8 "Call unlink() on "tr? , terminCthe .e, _segment#, \_name0Add(e3ied :1's j?er.3'er wrelease+!lf "s Qwith  xmoves it from20 in ce 1ide wdestroyDlist(s 1""Ra1s  'at is currently=ing"s qclass SMmManager(Base """Like Sync@ but G@tead.xT Itwvides methodsA7ingXUances**[> { -lsDableList)~MJ. It alsoQthat le -ort synchronizap acrossbcesses (i.e. multi-proU-safesvsemaphores)+,_w) =__init__ *args, **kwargs): if os.name == "posix"#.+# bpo-36867: Ensure the resource_tracker is running beforenK`launch#Cmanager process, so that concurrentDshared_memory manipulation both in]3andLf does not create twoG=es.from . importL V!.er_Z)()aRBaseME.__init__(self, *`, **kw 8util.debug(f"{1.__class__.__3__}d by pid {getpid()}") def __del{ fk.Bk;Jpass|get_server p'BetterWn monkeypatfor now; merge into SJ ultimately'2if .state.value != S~INITIALD7=7~STARTED7rrraise P" Error("Already started SM"I/el HUTDOWNw has shut down/seb {"Unknownte {!r}".format'._) creturn.4registry,@addreauthke>serializer-7zk, sizeA"""Rys a new instance withspecifiedM9 inbytes, to be I."""4[TClien[ =$@) asnisms = . SNone,vR=True= z>tryd1disr(conn, V'_segment', (sm,!Cpexcept `E ^Oas erKkunlinkL mrableList_quenc%< instance po pulated with the values Afrominput sequence, to be tracked by%manager."""Fbself._Client( address, authkey=) as conn:Msl = shared_memory.SpableLis`);>tryPTdispatch(s, None, ' _segment', (sl.shm.name,)_except BaseE 0ioneuN~unlink(Oyraise ereturn sl # # Module providing`Pool` class for a*cess pooBmultipro@ing/1.py^Copyright (c) 2006-2008, R Oudkerk # LicensedPSF under a Contributor AgreeH. # __all__ = ['', 'Thread!] }pImports1i collections itertoolo Tqueue(t_5ing&imraceback5ypeHwarnings # If J is avail{x&n p should* ed. Therefore # we avoi7p-level s which are li] o fail on some systems. .9[ util get_context, TimeoutError(SEBwaitConstants representD0state of aI INIT = "P" RUN RUN" CLOSE " TERMINAT "uMiscellaneoujob_counter = .() def mapstar(args)p(lQmap(*0-4 j-]P[0], JR[1]))@Hackembed stringifica%Rremot3g in localFR-T(L__init__MC, tb4Iqtb = tb913str0,$3" rEWithVM ~;exc~.format_ ion(type(exc), =<''.join(tbPexc =505\n"""\n%s"""' %oreduceprebuild_7&exc.__cause r2exc<Code runHdworkereMaybeEnco p"""Wrapssible unpickleBerrors, so the!y can be safely sent through the socket.""" (def __init__(self, exc, value):$Pelf.exc = repr(exc)2 ! uper(MaybeEncodingError, s)).g.Gi3strreturn "Ta result: '%s'. ReasonA" % a,`")R%<%s: %s>__class__.__name__@) worker(inqueue, out ializer=None, args=(), maxtaskswrap_exception=FalsDif (9 is not \Q) and(isinstance*ztM JdH>= 1aise Asser3("MT {!r}valid".format)Uput =,A.put geL2.geif hasattg'_writer'8r.close(q._reader!|!if]m! (* _completed = 0RUwhileRN7 orm:<.6try7g = get0Q (EOFA, OS J=util.debug('T got 79 -- exiting'EDRbreakU1if !is pOinelejob, i, func, x, kwds =}q .n` = (TrA"(*A **C>FE}Z as e:if {V_helper_rer/s Jq5 = nWithTraceback(e, e.__t*__"6, e Tput((D:p.T6[1]"Possible ek el (9sen!%sN (+)Q= job! =V! =W$ =XA+= 1K0 after %d task8s' % completed) def _helper_reraises_exception(ex): 'Pickle-able h0P func& for use by _guarded_task_genera$!.'Ga ex # # Class representing a process pool # c%_PoolCache(dict1"""WI`that iments a c1@the C O+will notifyF$vp manageE threads every time 'Yis emptied. TheEP!icq is don6$of a queuIsvided whenEinstantia;q._init__(self, /, *args,ier=None, **kwds60.Eer =0b!uper()._bYJ )udelitem kJ)#Dm1# N @ay_ isPimporP becaQtyHkeeps maintainWworkers untilgets drain!isLeliminateKrace condi in which a finished aftereL's _handle_method has en:another it=; ofOloop. In this situq,'P only"ntPcan wake up !isbd to be (no moreps avail)' if< P*bP.put()Pool(obje"''$^0sups an async versionPapplys@argu!s.VV_wrapr = Truer@static6PE(ctxWreturn ctx.0) #esUializA=(),W0maxzsperchildGqcontext# AttribuYkpd early8m" suHthey exist iz# __del__() if !) > _w[ = []}e = INITj4Pctx =w or get_,()IQetup_\s," =!.S+Q.# _change_";%toO  M_!._l)5) re"a  |E_/@vari8runfrkers. self._change_notifier =tx.SimpleQueue() 8ache = _PoolC (D=" Z Amaxtasksperchild =  sinitializ(pargs = %  #if processes is None:= os.cpu_count() or 1, J:< 1F raise ValueError("Number omust be at least 1")ais notA and callable())3Typ'+  J' :tryp5repopulate_pool@except E:ion>for p in< !{.exitcode'p.terminatjgp.join:sentinelqEget_(Qworker_handlthreading.T (^optarget=i.5_C)s,)"=(c,Fiq3ctx P  Iv!1 )inW2out N|Dis Rwrap_O0ion@ 2Sar.daemon = True+P_stat ?RUN* Pstart 'z? = Aquick_put+Dpool.^AOsM )K (I{dresultwJ"CL* K%geKe +! * #self._terminate = util.Finalize( `self, ._terminate_pool,(cargs=((askqueue9)in9outNNchange_notifierTworker_handlEtask Seresult(jcache)exitpriority=15R)"stNARUN # Copy globals as function locto make sure that they are availableK during Python shutdown when5 Pool is destroyed.9def __del__, _warn=Pings. , RUN=RUN):5,#if=$#J(f"unclosed runnmultiprocess {&J!r}"bI ResourceWarB", =4h,if getattr+'_"', None)1not HZ.;Q.put(=>Crepr?!Scls =$_class__> return (f'<{cls.__module__}.pqualnam% '9!f'x=6!._ }(]_size={len.W)}>')get_sentinels(9$B = ['._reader] ; B+/[*?, *b]@icmethod"s|.+R for 1 inVs if has4, "C/") Pjoin_^2ed_= s("""Cleanup after any]es which have O due to reachingtheir specId lifetime.`s Truejs were cRed upW 5"""\ b= Fals$Ii in reversed(r()1 0 = &[ii#if.Ocode #/Lqdebug('$up6z%d' % i8.(JAed =O u=del:trepopult 8#Y ,4!ic3S._ctx:Process,  self._processes, 8'=Rool, inqueueG!2out<KitializerO!initarg"maxtasksperchild!wrap_exception) Y@staticmethoddef _repopulate_pool_&r(ctx, P&,  %/, lZT "  :"""Bring the number ofa up to#specified-kfor use after reapW workers which have exited. Ei in range(Dp - len(I&))4w =uG2et=z,K$=( u- +f-, : )/w.name = .replace('{', 'PoolW{'=daemon = TrueYjstart(2t.append(wutil.debug('added u'? maintain=6-| uf"""Clean3anyas and 9 `ments Uthem.d5""" if Pool._join__>s}-y"tH  H[#E asetup_~ s(#._# =ctx.SimpleQ01quick_put2s._writer.sen3f5#ge5f._outqueue._reader.recv def _check_running(self):"0if ._state != RUN# raise ValueError("Pool not U&")oQapplyf , func, args=(), kwds={}~5'''Equivalent of `< (*<@, **;5)`.-Ptmust be.Wbreturnp_async(`g).get(9map iterable, chunksize=NoneA` to each elemDin `P `, collecting the resultsin a list that is r/edI_mapw, mapstar  ,`Like `E)` method bues are expected to 4be s as well and will unpacked@argups. HenceF^`8(a, b) becomes\*9`5>n, callbacke_!hronous version` @, *,  _guarded_task_generationCL_jobQ Provides a D orVs for imap) _unorderep%thappropriCPhandl>5s which throw exceps duringI.:tryei = -16?n, x in enum!e(P(bl-xyield (*i-(x,), {})c$ E_eQ+1, _helper_reJ"s_Ltion, (eijh 1= E`-- canMUCH slowerMn `Pool.(.G}.E&ifZ == 1^ = IMapI 1torCevqueue.put(! self._guar$ded_task_generation(result._job, func, iterable), 2set_length')))rreturn 9Uelse:iif chunksize < 1"raise ValueError(@"%"CFmust be 1+, not {0:n}".format>B >batches = Pool._getW*s(@, t = IMapIntor(self(.[queue.pu;Oguar Bmapstar7A`=(item forx$ is"in!) def imap_unordered 6=1)1'''G`Like `M()` method but Ycing ofs is arbitrary.COcheck_running( ),==*i`Uim^&!r^EXvNapply_asyncKargs=(), kwds={}, callback=NoneKe_!vAihronous versioni`()` method. ''' self._check_running()result = ApplyR(3, callback, error_=(._taskqueue.put(([(T._job, 0, func, args, kwds)], None)Jrreturn : def map_asyncJiterable, chunksize=PG !%):"1Aqhronous version of `map()` method.< wmapstar,Y)_^nfXmappechm!$aHelpertto implement , map and their  counterpartsDif not hasattr('__len__'B"u = list2L#fJ1 is"i, extra = divmod(lenS , pool) * 4J"ifB `dU += 1!ifUj) == 0>:2= 0#Q_batches = Pool._get,s(Fj = Mapy_   I`O(3qguardedp_genera  ;?O6) R Tr@staticA. _wait_for_updates(sentinelsjange_notifi|timeoutD8'Qwhile)ch[{.empty( %Cget(l@classhandle_workers(c`ache, V, ctx, Process, p .eskC, in@3out initializ ]<0maxsperchild, wrap_excepl&, }E 3thread = ing.current_=# Keep mainta#ining workers until the cache gets drained, unlesscpool # is terminated.while thread._state == RUN or (d;and#!= TERMINATE):Nncls._maintain_(ctx, Process, p e ool, inqueue,GK 2out) initializer?oitargs@maxtasksperchild, wrap_exception) current_sentinels = [*Bget_(E), *0]Pwait_for_updates(f, change_notifier)`# send to stop(*.put(NoneDutil.debug(' handler exiting'@icmethod\Rdef _._d s(jv, put, ,!i# =ODing.(}@for aseq, set_length in iter}a.get, >! =V:try)#Vaw cannot faiL,i>seqU)#ifa!a-1Z?fouFRUN'BYbreak;}Y5$ E<_ as ejob, idxask[:2]} ! [job]._set(idx, (False, e)9KeyError-Mpass?els'ifZ do/()=01] S@ask = -1]A?+ 1 co-ueI=ofinall@-seq = job} B`Ur got # tell result+to finish whenYemptym elp f w jw reqno more1 util. debug('task handler sendingtinel to workers') for p in pool:&put(None5except OSError2_util.%go2P when }Gexiting') ,@staticmethodRdef __results(outqueue, get, cache)thread = ing.current_(nvwhile 1>:try=s(<@(AQ, EOFK( R:/LF -- #Abreturn:#if ._Le != RUNkassert-== TERMINATE, "TJ0notP"rZfoundg=J K^break}0is V1sen4njob, i, objD9ask[job]._set(?'1KeyJpassks= job =}, afi no !PignorEPextra co2)ueif hasattr- '_;er'>Aensu#Tthat i@ is KfullE# If we don't make room available:HIthenT# attempts ad*e C;mayBblock. Thereguaranteed:be no more than 2_)s.JNirange(10=!if".lo.poll(48  aget() except (OSError, EOF )):(/Upass 6util.debug('result handler exiting: len(cache)=%s, thread._state=%s',N` 0 -)x@:icmethod<def _get_tasks(func, it, sizeit = iter(itzwhile 1x = tuple(0tools.islicYCif not xHareturncyield x_reduce__(selfraise NotImplemented(Z 'pool objects can0be ed between processes or pickled'K\close!@ing ~'0if z == RUN$ i CLOSE sworker__P0 change_notifier.put(Noneterminat %e = TERMINAT A'e({OjoinN rN(RValue "Pis still running"+elW1Ain (,jIn unknown e  $"j$f3 inx p#p.VfO help_stuff_finish(inqueue,  a# may be blocked try`to putcms on [ZXQremov5T from0a untilqw(ed0._rp.acquirk.is_alive() andq ._MKoll($Grecvitime.sleep(0 l@class4_0(cl93askkS, out(+, ,R~   a",  his is guaranteQo onlcalled oncepfinaliz' #ify that the Y` has b@d so-n## _workers loop can be unblocked (and exited) in order to # send the finalizationtinel allworkers.: _handler._state = TERMINATE* change_notifier.put(None) #OtaskK )util.debug('helping = /@s toUish')=Pcls._6_stuff_finish(inqueue,I, len(pool)if (not result,.is_alive()) r(<cache) != 0):xraise AssermiError("&@"CanlQhave MX with|0er "|" "1out F0# We must wait forH before terminating$# because we don'Z%nt to restarted behind our backD@joinDc4if threading.current_Q() is>  .q(3# Te`which  aly&ed0if sqhasattrd[0], 'L+e'%sp<k .@code'+$p.ne< H%>  V?ool)KZK2 ha 3yetrlgAclea~#up %d' % p.pid<p,def __enter__(self._check_runj(UPretur"lfL3xitK, exc_type 2val ,tbf # # Class whose instances are rx y `Pool.apply_async()` # c>ARj(object):init__(self, pool, callback, error_C): self._pool =  event = threading.E+()(job = next(job_counter&Scachei!._ H% = " + = .d[pjob] =  '@def y(areturn*!._.is_set():successful?bif not?`\yraise ValueEq("{0!r}61".formatZG 2wai2, timeout=None}.(/geD =T< v99Kelse-_N,-, i, obj,_@ =+E#if3and? q.ZU [N__ 8e3del 3=%0 = Yz__class_getitem__method(types.GenericAlias) AsyncResul^SApply # create a1 -- see #17805 # # Cc whose instances are red by `Pool.map_arq()` # B Mapt("):-q_init__L,, chunksize, lengthhb/._Wo   =M-u = TrueY[3] * &$&if_ <= 0number_lef0=S u&//r+ bool(& %  ,M!_r 7qE-= 18", 99J) >X2[i*)size:(i+1)*s elf._chunksize] = result Aif s)number_left == 0:'2+callback#'O$(mvalue)S3delbcache[-Mjob]+event.set(M"pool = NoneDJelseif not success and . # only store first exceptioni)Lv = Fals"&.consider the ready once all jobs are d#derror_- *j # # Class whose instancereturned by `Pool.imap()` # c7IMapIterator(object): def __init__ , m)! =8*cond = thing.CondiB(fLock()Ujob = next(job_counter&F|!._ items = collec{ws.dequeQrindex = 0Bllengthc4punsorte+{}8! =s \3ter\V - u, timeout=7Awith5 ._x:try ._ Ps.pop) I"E(LXG"._>0W#._?Braise Stoion from.Tc.wait(-9) -'f8" *&2TMW$, S 4- __#__ W# XXX3 , i, obj): with self._cond: #ifindex == i!,=items.append(obj)I(JM+= 1!Ywhileq#in{unsorteV[obj =*S.pop(s:!,M MF.notify(uOelse?[i] = obj mnlengthU3delbcache[.Ijob]Wpool = Nonezdef _set_cK", )qw? v4# == Rc+8# # Class whose instances are returned by `Pool.imap_unordered()` # clATIMapUIterator( *):mf i,f 8 U.C`Threadi(_wrap_exception = Fals@staticmethodm Process(ctx, *args, **kwdsT:from .dummy import 8H#(Js_init__p~0es=a , wializer7=()/._L G B)setup_queues\!in1 = .SimpleQ2,1out%-quick_putkE.putOY,&ge,kG.getget_sentinelchange_nPier._I2er]N%_`gworkerg(jM help_stuff_finish(, task_handler, size# drain .@and I at its head to make  lb6trywhile True:   inqueue.get(block=False) $rexcept &eEmpty:$Epassfor i in range(size)/pput(None) =def _wait_for_updates(self, sentinels, chX_notifier, timeoutep.sleep(  import os signal from . 8util __all__ = ['Popen'] # # Start child process using fork # class 5d(objecmethod = '+'s_init__WG_obj._flush_std_streams().returncode = \Zfinalizer_launch(duplicate'fd6 fd:Dpoll+lag=os.WNOHANG81if @!is =+tr}pid, sts = os.D1pids.Fflag*2zOSErrorc 9# Cnot yet created. See #1731717e:# e.errno == p.ECHILD-100 `if pid5>pidA6status_to_exitF(sts4 vGDc=R $if@ is KISmultiing.connection 's!ifY!([4]3  W# This shouldn't A if f") 9`ed suc ifully.D#eoI0.0 else 0b_send_7sigV*Sos.kiH] GP oLookupR %{<m)P=0.1)EAWVraiseterminate $ A.SIGTERM?GKILL?Xr,7 E = 1^parent_rRild_wGpipe%/&y.pid = os.fork(3) if self.pid == 0:!:tryos.close(parent_rN #w#code = process_obj._bootstrap[sentinel=childjofinall`_exit(e{Jelse`  7izer = util.F@ize(,.Y_fds,])3r, i6w,):d.$M hAdef {)is not Non!b(() import io os from .context #reduction, set_spawning_popen ifr%.HAVE_SEND_HANDLEqraise IuError('No supfor sending fds betweenUCes')forkserver_   __all__ = ['P'] # # Wrapper an fd used while launcha # class _DupFd(object__init__S, indPind =adetach2-`return .get_inherited1()[3indaStart %2 usO(X.Pmetho'sC'# =  8S ]Puuper().D>cduplicate_>=, foe.Vnd(fd_1len;.(V) - 1g_ ,8prep_data = 0araU(f._name0bufo.BytesIO(! Pdump(V, buf8l + -V )>`X, w =connect_to_new_ # Keep a  of the wpipe's w end as am+M!byPI.4_3_wos.dup(#^5 (_ parent_w, self.sentinel)) with open(w, 'wb', closefd=True) as f:/6f.write(buf.getbuffer(Tlpid = forkserver.read_signed(" _def poll, flag=os.WNOHANG)"ifreturncode is None$rom multiprocessing.connection import wait4timeout = 0 ifF == Q elseq 8Rif noP)([3], UkO:try-W2b<except (OSError, EOF # This shouldhappen usually, but perhaps the }## 0 it got killed, .2255)K  $io Pos fDtextAredut_spawning_p 3,_ 6 util __all__ = ['PS'] # # WrAr( an fd used while launching a, # class _DupFd(object5__init__9d(Gfd1adetach/+S"fdStart child uH a fresh interpreter(7.lPmetho'?'# = @C_objN@_fdso]P up.D>cduplicate_=, fJe.Vnd(fdF<7zK{gresource_tracker_ &6fd(?%prep_data = G_0ara(f._nameBfp = io.BytesIO P; `.dump(F, fp7Z * ,0fink=-se6) "02r =%_w 9 )'r,Gwos.pipe)rpC_r, 3\*m5command_line(=tracker_fd,  pipe_handle=child_r) =self._fds.extend(['", /w]1 pid = util.spawnv_passfds(.get_executable(),t Ucmd, ~sentinel = parent_r`with open(w, 'wb', closefd=False) as f:;f.write(fpbuffer()zfinally9qfds_to_aY = []Wfor fd in $r,*w)J!if/s not None#'u@.app&fd$IDizerF@ize(, (, Y/) !r*'1os.~(import os dmsvcrtesignaly'_winapi from .context Ereduction, Ping_p)p*t_G@  __all__ 'PNQ'] # TERMINATE = 0x10000 WINEX (sys.platform == 'win32' and@attr$, 'frozen', )E`SERVICIHo@.lowP.ends ("pythonservice.exe") def _path_eq(p1, p2return p1p2 or os.+.normcase(p1)02) QENV =d , W_base-2s(*sQU s%  .CH(%_# # We define a  class similar to the one Osubprocess, but # whose constructor takes a )p objectfits argument. # my('1'''oStart a x1run}code ofl;CPmetho''s_init__C_obj9prep_data = A_0araI(=g._name0# read end will be duplicated by<# -- seep_main()6py.+  bpo-33929: Previously,has "stolen"P it leaked a V1 if\ had beenHbterminPeforeMcould stealFTx process.  rhandle, w  = _winapi.CreatePipe(None, 0) 4 wfd = msvcrt.open_osfB(J 0 cm0spawn.get_command_line(parent_pid=osepid(),muRpipe_z=w' '.join('"%s"' % x for x in cmd) kpython_exe = executable(- # bpo-35797: When runningXa venv, we bypass the redirectq"# \ or and launch our base P./if WINENV._path_eq(b, sys.T%):<?)@ys._g .env = os.environ.copy(_R env["__PYVENV_LAUNCHER__"]b\JelsejgPwith \(wfd, 'wb', closefd=True) as to_childP# start processz:try-hp, ht, pid, ti J(K:W,Q", @FalsR!, % ]\H:(ht(nexcept< %eVraise # set attributes of self!.p3>pidreturncodT#^ = hpsentinel = int(hpfinalizer = util.F(1, _9hsB.,E);1nd information to  !t__Qing_p PreducY.dump(prep_data,  E 4O_obj6Ol(-sedef duplicate_forB", aassertR@ is  FAh(X,HCwaittimeout=0i.e!is$I3if BE $WmsecsGINFINITE;Rmax(0io* 1000 + 0.5u(repWaitForSingleObject(7self._handle), mwsecs) if res == _winapi.WAIT_OBJECT_0:-8Vcode .GetExitCodeProcess(self._handlem@2if C= TERMINATEf*' -signal.SIG1 ocreturn2 ( ' def poll)4wait(timeout=0)9terminate>,ifn is Noneb:tryT^W1inti[,A gexcept OSErrorc O1.0)Rraiseukill = NMclos|finalizer() # # Module providing the `` class which emulates `threa.!.T `KbmultipCing/ 1.pyXCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = ['Base', 'current_active_children',i 'pa0!] pImportsmi C os &sy !itertool4 from _weakrefset LqWeakSetum ORIGINAL_DIR = os.path.abs(os.getcwd()) v @e Public function? 9(1'''/R4j object representF(;C_$  tlist of_s corresponHQlive ,)es_cleanup(`(*") #qE }_##U# check forSehave finishedi&K in Lbif p._popen.?not= .discard(p)\THQ(? cBsC ity that+0runa separatuis analogous _P" NotImpl!edr9q_init__;, group=None, target=None, name args=(), kw \{}, *, daemon5%):"assert group is _'argument must be for now'Dcount = next(_process_5er)' self._identity = _current31+ (@,?oconfig=l.copy(7"paiid = os.getpid'^c qpopen = Pclosep[False ta2 = Puple(  = dict( $ame or type(@).____ + '-' + \ 9':'.join(str(i)Pi in Gy#ifgK1notm];~_dangling.add def _check_W[#iftraise ValueError("p object8&")p7 `config"('41', @ ,m)ic' Set whether process is a daemon 5''' assert self._popen3tNone, 'Ehas already startedB;config['kC'] =v1ic m@propertydef authkey(A!):creturnW,#']Mq.setter< S,a\1Set"orization key of;U5-._ = AuthenticLsString() exitcodesR+ ,P or `` if it yet to stop heck_closed())#ify  (?o.poll(_ident(ifier (PID)5artV _current_  os.getpiJOelse-z8H andpB.pid+apid = ?sn?nel> a file descriptor (Unix)@ handle (Windows) suitable foYpwaiting q termin.d?tryXexcept AttributeErrorAaise Valu#("D not") from 6Z8__repr__Lut=1 '!status = '8#elF. :q9"pagid != LunknownMAxinitialA 5 ?5if -!is |- pl5Oinfo = [typ}.__name__, ' c=%r' %]= %ae.append('pid=%sS}6nfo0 3H_pid4fo.append(stsatus)  if exitcode is not None:!("4= _ _to_name.get(,MbAinfo.append('-o=%s' %2if self.daemon J!'lreturn '<%s>\' '.join(7!) "##def _bootstrap(r, parent_sentinel= ) from . import util, context\global _curLprocess, _]_counter, _childrenO6try_start_method3y._force9.O<_ = itertools.+(12z = set(5`._clos;din 4olds- =Ff cp*lf$ uSPP|(.V .,=pid( if threading._HAVE_THREAD_NATIVE_IDw2Rmain_()._set_native_id- Jb finalizer_registry.clearB1run_after&Kkers*Ql?# delay !ization oce old A object until j |?# _executed30delf4  !('rcallingWrun()EY. f0I = 06NP_func5qexcept SystemExit as .Uelif isinstance(eIW, intG) ;els4sys.stderr.write(strg{) + '\ns5i1d  )BtracebackF '` %s:\n2 P.print_exc|shutdow$Ewith0 %d E_flush_std_streamreturn exitcodHe # # We subclass bytes to avoid accidental transmission of auth keys over network # JAuthenticationString(_ ): def __reduce__(selffrom .context import get_spawning_popenJ0/if() is Nones)raise TypeError(F'Pickling an p object_'>disallowed for security reasons2)D_returt", @+2,) dCreate`represyng the parent process!_PPS(Base 1): Cinit, name, pid, d'el!._16= (@! =GclPpid =Z _ ! = PcloseV[False% = "config = {}is_aliveVSmultii0ing0necEwaitg@not "([ ], timeout=0)@propertyDm YO2pid=/Ajoin.\T&''Wait untilF terminates9!   OmainCMain(] 'e[??'_key':(os.urandom(32)),'semprefix': '/mp'},# Note that some ver's(FreeBSD only d>semaphorzAhave#? up 14 characters. Therefor# we choose a sh/.j On MacOSX in1andbox it may be ne00aryuV>SdiffeX -- see #19478rpEverythU2in @willtinherited by descendan2#6es.pass _c = None _current_process = _MainP4() _counter = itertools. (1) _children = set() delK # # Give names to some return codes # _exit@_to_+ = {} for:, signum in list( al.__dict__.items()): if6[:3]=='SIG' and '_' notEd,0  [-aum] = f'-{/}' # For debugRleak testing _dangling = WeakSModule implemen.Q queus# multiBing/1.py?Copyright (c) 2006-2008, R Oudkerk # Licensedb PSF under a Contributor Agre.s_all__ = ['QQ', 'SJoinable] import sys o `thread &collection$4ime:Etypetweakreferrno from)<zEmpty, Full_@8.4BconnQtext _ForkingPickl0conQ.redu.#cDutilg, info, Finalize, register_affork, iss-a 0 usBa pipe, buff2nd `aclass 4(object): def __init__(self, maxsize=0, *, ctx$$ifV <= 0# Can raise IError (see issues #3770 q#23400)>.synchronizSEM_VALUE_MAX as>#._/ = pBer, . wr6 = .Pipe(duplex=False5Prlock4tx.Lock(!opid = os.getpid! if .platform == 'win32'IjwjENoneOelse- c3sem BodSemaphore(6`use bycurrent.futuresignore_e1 = 6 #"re !  .$)getstateassert_spawningVo(._=5Z,1C9 4sem G s!, 6, self._wlock, self._sem opid) = state 'reset() def _after_fork(#!):5debug('Queue.(5)')%4"._WKX=Truef!-', 'WFalses'if<._notempty._at`_reini%Oelse;  = threading.Condition(lLock()buffer = collec4s.deque(+Kl = NonOjoin cancelled = " nOclos |send_bytes7vwriter. kKrecv3;6er. 3Epoll`-t1putl, obj, block2, timeout=:  raise ValueError(f" {4r!r} is 9"fif not>.acquire(]lBFullCwithH #if!is %J._start_,\!.append(obj%x.notify$ge{ayD and [r& r7sem.releas/"ifmdeadlineCime.monotonic() + fh<lE T>tryKW5 = - e6 (L , .elRKG pS ofinallQ96# unserialize the data having 6dareturn _ForkingPickler.loads(res:Qqsize.& # Raises N2otImplementedError on Mac OSX because of broken sem_getvalue() Preturlf._maxsize - sesem._semlock.>_? >def empty(/!):U3notIqpoll() !6Ofull5Kuzxis_zeroBget_nowaitH get(False|)pu:^, objput(obj, D\closey3_d = True6try-qreader.4kfinall2%# =R_R1if  hlf = Non`pjoin_th debug('Queue.(&)'XTasser^Ad, "4p {0!r} s".forma#ifd pcancel_/j)/le.;except Attribute Fpass7o_start *W0# SF  which transfers data from buffer to pip3 g.clear[=dRing.TKuqtarget=y._feed, Qargs=~"._p,1notysend_bytesBf 4wL1Dwrityignore_eG@on_q@er_e{CJsem);Rname=,bFeeder '3<t.daemonG.|Sdoingm.(  I... doneL0!if:led!y@ = FEize(M$, / M8[weakref.refj.)]-exitpriority=-5X# Send sentinel3the * ect when garbage collected]$4 [*, self._notempty], exitpriority=10!) @staticmethod def _finalize_join(twr):]pdebug('ing queue thread')&v = twr(#if+ is not None\`:.`9z9...v +e};elsU; al2y d close(buffer,e|"Ltell" to quit*EwithF d.append(_sentinelO1not.notify( =eed , send_bytes, writelock, , ignore_epipec onerror,N_sem Pstart feed data Xnacquire =.ireleas$$HwaitEpbpoplef!h"p5 = | if sys.platform != 'win32'w& =Y w )v`LPjhile 1:try*p o0 if :S#nsXal58wMdobj = [)0if , isp4[$er5got?@ -- 7ing; o0freturna# seriB thedrbefore  e YC  = _ForkingPickler.dumps(obj15if /is){Y BxB DH, !except IndexEQuFpass except Exception as e: if ignore_epipe and getattr(e, 'errno', 0) == n.EPIPEKZmreturnf+# Since this runs in a daemon thread the resources it usesK may be become unusable whilb e process is cleaning up.K#We0orsEch happen afterR/hastarted toplhs_exiting()>Pinfo(s or!@queu: %s', e)w?els1 e object has not been sent, we need#pdecrease size of>AR. Thego acts Ki6dilently removed from`v@step ne0ary`have a1perly workingL_sem.rel(aonerro[Qobj) M@staticmetho`def _on_Wyfeeder_:A1"""F=Private API hook called when G DdatabackgrounhKraises an exC. For overridKby concurrent.futuresiimport tracevi.print_exc() _cinel =a# # A A typch also supds join()task_done() a s D0Notat if you do1 5for each finish0askxn # eventually counter's semaphore 3flow caus9Bad Things <r. # class JoinQ("):/_init__(self, maxq=0, *, ctxa</._1,=0QD._un_ 0s =V$.S&(02Ccond&PCondit0geter6 )1 + ._e", q Mlsl!, zsl)_[:-2]}" =bV[-2:]1put, , block=True, timeout=None#iffclosedHq ValueEG!f" {0!r}closed")  if not self._sem.acquire(block, timeout): raise Full CwithHnotempty,JcondA#ifthread is None%qRtart_,%()s!buffer.append(obj% unfinished_tasks.releaseR.notify()@def =`_done(j wWFalseSrValueError(') called too many*s's |._is_zero( ._H_allOjoin8@wait# # Simplified Queue type -- really just a ed pipe # class<e7H ecr__init__, *, ctx.&$erwriter = connection.Pipe(duplex=cC4wtx.Lock!cpoll =Fq.Hys.platform == 'win32'fOwpC;els -c4"Mclos7"&.PIoggreturnA__getstate=context.assert_spawningdxFc"._ r; H,:__s!, c#G (1getr !0) uR h 2 gzl;specific defions # if c}# Windows<+= ['DupHduplicatTsteal]:r_winapik18(>, target_\9, inheriq=False,V*, source=8 ''2 a rJ. (t5 is not a pid!)recurren3 = R.GetCPn kmY Q if t arget_process is None: t$= curren6-return _winapi.DuplicateHandle((\dsourcey1, h$*, m,40, inheritable,iUPLICATE_SAME_ACCESS) <def steal_b(y$idu)@'''S-# ae from dentified by JA.'''nw% =ROpenPp 80PRO_DUP_HANDLE, False,s)p6try0 /BGetC D), 037D% | CLOSE_SOURCEkfinall]DCloso3endU(conn destination_pid 6endover a local F ec7 dh = Dup ,Qf.send(dhHrecv ReceiveIq_().detach(xWclassjobjectzPPickl wrapper fo3 )ef __init__(self ac`, pid=d] if # We just dD the!in5andvFQ# let.rS5ing0h >pid = os.getpid(\g) q dW.(l 8 z-,!$, 0Ev* ?c# =l "2pida#$ [C'''G . This should only be calle)ceb# retrievr WTwhichVly owns it0if .) =D pThas alreaden duplicated for this process. return self._handle$# We must steal the 'Q from] whose pid isR:pidt, = _winapi.OpenP( PROCESS_DUP_HANDLE, False, Ipid)2Itry:4}DuplicateH (04, ,GetCurrent) acFDUPLICATE_CLOSE_SOURCEofinallDClosr) elsea# Unix__all__ += ['DupFd', 'sendfds @recv ]/import array 4# On MacOSX we should acknowledge receipt of fds -- see Issue14669 WACKNOWLEDGE = sys.platform == 'darwin'sCdef `(sock,X)L'''Send anz@overAF_UNIX <aet.''';=6.B('i'`$ msg = bytes([len(fds) % 256]].msg([msg], [et.SOL_SOCKET,SCM_RIGHTSoK8if 1and5.(1) != b'A' raise RuntimeError('did not(ve3men&')fb1fdsj, sizegRIj-a h=]_p&Q.item *, ancdata, flags, addrC1ock"1gCMSG_SPACE(e)z!if"h.a_1EOF[ g  D'(0if _1Bsqved %d =H5' %fz cmsg_level, Ctype "[06cAif (2> M and4f30i8aGN!= 0I=MBValu4 a.;_ 'y0256omsg[0]w AssertionT@"Leng{0:n} but \ is {1!r}".formaOt( len(a), msg[0]))-return list(a except (ValueError, Index )):HEpassraise Runtim: ('Invalid data received') 5def send_handle(conn, , destination_pidz'''Send a, over a local F ec7A.'''i'with socket.fromfdp.fileno(),uAF_UNIXSOCK_STREAM) as sfds(s, []Hrecv RsV1)[0]{DupFd(fRGa wrapper for an fdpopen_obj =text.get_spawning_!(1if 4is not None~*.duplicate_for_chilhelif HAVE_SEND_HANDLEe/ . import resource_sharerae #(fdvs>v('SCM_RIGHTS Z"arto be availableM# # Try making some cal types pick@ # y_reduce_method(mif m.__self__ istgetattr, (-class__,:func__.__name__(elErDb2 _C f(1{register((_C().f), /) _descriptor 1obj |W.-ndk*) 7int.__add__7 partial(p_rebuild_ P, (p., p.argskeywords or {}) 9(531 l"ctools.m4*5%**7 4E0) CMake  if sys.platform == 'win32',#(s6 ADupS1 XR5, (+B(s),)((d|Mds.detach4.uce_socket)  else: def _reduce_socket(s)f = DupFd(s.fileno()):`returnASbuildB, (df, s.family @typeRproto@z97531fd = df.detach(K.(L", 2=fd=register(4;,) class AbstractR50r(m=ABCMeta?4'''+b base ? for use in implementing a QBtion*esuitable 7`replac4the standard ?mechanismC@usednmultiprocessing.''' ForkingPickler = $$4 = @dump1umpsend_handle = Frecv  if sys.platform == 'win32'VstealDD duplicat DDupH F3fds1fds$ )1\Pmetho ; _descripto:@partial = (&$9%_init__(self, *arg5#((_C().f)Q }P/list.append4?int.__add__?functools.Mt,4a# # Wea background thread@sharRon Unix, ang@s onQindows. ^ A client which wants to p a resources it with ?0 # !er|gets an id@fierBr. The uncU will connect #b`,s}_rits pidthen receivesN%he import os esignaly'|ing from .Jtcontext^ util __all__ = ['stop']  5+6ADupS;.s(object\!1''' wr3rR"a /.def __init__(self, sock): @new_! =i.dup()"def send(conn, pidCNshare = O.(- M,H.Rq_bytes(+ t._id = _resource_(r.register(C,ruclose) opdetach(O '''Get theet. This should only be calleece.'''^Nwith@get_aection|P) as  H! =S.recv *dreturnAfrom<CR else`__all__ += ['DupFd']aclass w(object '''Wrapper for fd which canused at any timq__init__<, f, f!osk*fdDm Aredu]Fchandle2a Z#(T2os.? >E!/fdhVWWB) 7#_RSrA'''Manag= s using background threadQ :~ukey = 0@cachv+{}clock =ging.Lock?lHner = NoneDaddress Eutil_after_fork =."!3Rend, XC'''R g", kan identifierg:6ockSiDlf._!is &*BWstartWE+= 1T[Askey] =  3!%, >9@staticmethodAK ZEP Tto receiveMdo V6.Gimport ClientW , =V3c =0(( authkey=process.current_3()."c((key, os.getpidc())) return c def stop(self, timeout=None):"72'''Stop the background thread and clear registered resources.''' Efrom .connection import ClientpPwith f._lockD#ifaddress is not *.3c =^#._6,m&  authkey=process.current_3()."WBpc.send(nclose(Qc.join(+.is_alive(util.sub_warning('_RdSharerFdid ;'q8 when asked'lOner.! = K% p&for key, (!, C) inXcache.itemsT3A&()h_afterfork( ( RP._at_w_reinit_G`P  9m_startD[L? cassertP, "Alty have >"?Oqdebug('Eing G a whandles#8=j([}ML].3t =Qing.T(target=;Vservet.daemon = TrueI.>?7= tT if hasattr(signal, 'p?_sigmask')(.&?.SIG_BLOCK, )PvalidMWnals( zwhile 14:trysO.accept() as 6:Qmsg = W.recv*0if )!isJ,Ubreak~pdestinaY_pid = msg  send, close = self._cache.pop(key) 4 try:-T(conn, destination_pidMofinallQ(=nexcept if not util.is_exiting()*2ys.Jrhook(*s_info()) _resource_sharer = _RSp() stop ,./ #; # Server process to keep track of unlinked s (like >d memory # segments, semaphores etc.) and clean them. # # On Unix we run a seQwhichs& #c. The >1ignxaSIGINTyqSIGTERM reads from a # pipe. Every oth ofgram has a copythe writable # endR@, soget EOF when allbes have Uped. # T([s any remainingb namesTPThis mportant becausere may be system limits for suchR s: # instance,?6only supbFed numberd,{!"d-1/q live i RAM. If a pythonRleaks%isQ will be+`oved tW next reboot. Without # t6Rl p, "killp" wouldbably le)ed1 i4 os esignaly th4ing0war1s #. L[spawn __all__ = ['ensure_runE', 'register %un] _HAVE_SIGMASK =Rattr(B, 'p_sigmask') _IGNORED6sNALS = /.{", >) _CLEANUP_FUNC2{'noop': lambda: None, } if os.N == 'posix'{ c_multi(;0ashmem h@# Us("m_ ()!upG.57G@missi+P2bui`detect#heKpabsence*^POSIXz Iat case, no#D werPeaopenedz"nol#upPbe ne2ary%if CT, 'se#'NUP_FUNCS.update({ 'semaphore': _multiprocessing.sem_unlink,6!}) _CLEANUP_FUNCS.up]'shared_memory]posixshmem.shX}) class ResourceTracker(object): vdef __init__(self):._lock = threadRLock(&fd = None>%pipLstopmVwith rd#ifQfd ish !%# not runningmbreturnP# clo the "alive" file descriptor gs mainC0os.@eF._fd os.waitpid>opid, 0BCBgetf: sensure_H  2U'''Make Vs that rQ" tR w.^This can be from any6. Usually a child will usS~ created by its parent.'''hS;Wswas launch`efore,Pit st? acheck_r(n$C# =>P( M) <Sdead, it again+ $ # Clean-up to avoid dangling=es.8>tryQ0# _yP if t,N4]otherdOdpython, which has star(=_N!isW2)except CP_Error[U# Thep aly been terminMpass8   B0warkDrn('': died unexpectedly, l2'rebrV Som s might leak.')lGpfds_to_Y = []2.append(sys.stderr.Eno() except Exception: Ipass*cmd = 'from multiprocessing.resource_tracker import main;Y(%d)'Or, w = os.pipe()>trypfds_to_.append(r7##  will out live us, so no need to wait on pid}F exe = spawn.get_executabl-args = [exe] + util.__-_interpreter_flagsC+= ['-c', lM% r]# bpo-33613: Register a signal mask that@bloce /s.QCThis @8 be inherited by the child_is goingPRto be;bed andwprotectI a race condiQcan make@die before it r zhandlerl# for SIGINTSIGTERM. TheTis unRfgbif _HAVE_SIGMASK&.pthread_sig(SIG_BLOCK, _IGNOREDSNNALSO pivTfds(exe, ', nFofinall_9/UNeAos.close(wYraiseoNelseDpself._f3w/Q H%1r) Rdef _check_a(W)@'''C|4 has not been sending a Vbe.''z # We canH@use = here asW calls ensure_running, creat # a cycle@os.wGI, b'PROBE:0:noop\n' OSErrormreturn Fal'FTrue_, name, rtypehT"D of V with ] ._B('REGISTER'l` U(UNREGISTER', name, rtype) def _send(self, cmd, name':'+!.ensure_running()msg = '{0}:{1}:{2}\n'.format(V.encode('ascii'Gpif len(v) > 512 # posix guarantees that writ o a pipe oIsn PIPE_BUFK by4are atomic, andP20 >= 9raise ValueError(' too longnbQ= os.f._fd, msgtassert 0="3, "{0:n} butt {1:n}"e 5,, ) _resource_tracker = RT:() = = 7 q registO,4 un To getfd% main(fd)t'''Run  A.'''# protect the cess from ^C"killall python" etc;rsignal.(.SIGINT, B_IGN1OTERM2if _HAVE_SIGMASKE.pthread_sigmaskU_UNBLOCK, @OREDECNALSfor f in (sys.stdin, 3out@l6tryywf.closeexcept E:ion0BpassVcache = {k: set() _CLEANUP_FUNCS.keys()}r b# keepE6ed/3%edsCwith ope', 'rb') as f@line E  0 = G.strip().de.split(':Kcleanup_func Aget(:b, Noneh79if F!is- 1 ;& f'Cannot  {}automatic": y> f'unknow3ype2#}' 7md == 'REGISTER'[9R].addW'el[/UN]oremove`_PROBEI OelsedRuntim$cognized command %r' % cmd) except EMion:"1?tryBsys.Gchook(*~_info()s40TApassgfinall~0# all processes have terminated; cleanup any remaining resourceVfor rtype,_cache in .items()(if- U)0war s. $('_tracker: There appear to be %d 'Z'leaked %s objects@ up at shutdown' %PQ(len()!> {1nammiO# For some reason the which cre and registered thiy# has fail+Do un; it. Presumably it+ 7# died. Werefore unlinkC 1_CLEANUP_FUNCS[- ](<X ^ as eX[?ing`%r: %s>u?, e ["""Provides shapmemory direct act acrosses. The API of package is currently1visional. RefeGthe documentationr etails. """ __all__ = [ 'SM#',ableList' ] from functools import partial Dmmap $os Terrno estructUecret*s if os. == "nt"fq_winapio_USE_POSIX = False els0posixshmem4@TruePO_CREE1os. @AT |O_EXCL # FreeBSD (w perhaps other BSDs) limit 14 characters. _SHM_SAFE_NAME_LENGTH = 14] #QblockJp prefixQLAPREFw'/psm_'%!wn% def _make_file!"Ccp a rand!L !."a# number?Abyte1useCm-n1= ( ! - q)) // 2Bassert nbytes >= 2, '_SHM_NAME_PREFIX too long' name = & + secrets.token_hex(nbytes)8assert len(C3) = 0raise ValueE0("'B`' mustpa positinteger">#if~ U$.__O_CREX |$A"if=gnumberfrom zero!is )!4elf&JEXCLM ' @only3"") :"#   # DQwhileW make_file($th/_%xshmem.shm_open(1 u," _`) Rmode=. Uexcept FileExistsError: continue!self._name = &YbreakNelsesA = "/" +NB if cprepend_leading_slash G) ]6 fd = _posixshmem.shm_open(15,OOlags!Rmode=& E)-s;>try if create and sizDos.ftruncate(h1fd,1ptats = 5Estat1+ iz&Ps.st_pmmap = .Vexcept OS~unlink(iraise from .resource_tracker import register3, "shared_memory")fz:v# Windows Named S<! M< +while TruDtempq_make_file ()/ is None CNreserve   block with thislLuntil it can be attached to by  r7"h_,_winapi.FileMapping;3INVALID_HANDLE_VALUE6ONULL&PAGE_READWRITV( >> 32) & 0xFc2+CD`last_e@_codMqGetLasto==if D$= EERROR_AL9Y_EXISTSH!if^1not1 9 ,RExist03qerrno.E.or4(>)?*E    continue self._mmap = . (-1, size, tagname=temp_ )Lfinally:j _winapi.CloseHandle(h_mapPp5 = |^ibreak Nelse T[ 4# Dynamic determine the existing :d shared memoryIqblock'sF which is likely a multiple ofwPAGESIZE.L&4 = BOpenFileMapping(1-FILE_MAP_READ,+_False 4/trWp_bufMapViewOf/0J L n*VirtualQuerySize(K )&8uRview(iFdef __del__)q =c(except OSError>hBpassgnreducejzreturn Kn__class__ *k. )24 2) #Orepr1f'{O!._fB__}(2!r}=}2})'"@propert0_Ommap` $ .c_`_USE_POSIX andzfd >= 0#os^/fdfd = -1 def unlinkRequests thatmunderlyingx4 be2ed.a=In orderensure proper cleanup of resources, should beIcalled o( Aonly) across all]des which havexK >;namB. _tracker import unregister_posixshmem.shm_ ._d F#2, "F_F") _encod= "utf8" class SrableList?"""Pattern for a mut" list-like objectRvia ad} C It differsailt-inX type in]stQs can`change|pir overlength (i.e. no append,5Aert,Retc.)Because values a`d into~view as bytQtructP@packObformat(rny stor] must require0morAan 8Fpcharact to,cribe itsR1mat}+=# T @areadorganizedrfollowsR# - 8: number]items (N)1a 64-bit#eg9(N + 1) *CpoffsetsDeach elementPstart"th#@data{a4- KjRie(with ?sizp de ?oY0eirXqpectiversRN!`s`@ strGNPindexKpo _back ns'os_mappF&(iRrecon6corresponbPython_Fi1= {Zint: "q"@floadbool: "x?str: "%ds None.__class__:1 "x?x", }_alignment = 8 back_transforms_mapping = {!>0: lambda value:, # int, float, boolE1E.rstrip(b'\x00').decode(_encoding), # strI2Iu# bytes:3:_@None* 0 # 9!} @staticmethod def _extract_recreation_`!):)] """Used in concert with _ to)v)L!into the appropriate Python objects when retrievthem fromAlist as well6Dstor3E."""2if not isinstance(r, (str,k,8.__class__)return 0UOelifS?str:1: <2<&se3mBType_init__(self, sequence=*, *, namz0aame is5 or9L@ [& =-Uor ()_yats = [e._type[}(item)]04 - )6_else s O % (wA<b* (len3 //\ B+ 1)>@for wZ p_len = l ^0ass1sumfmt) <= 8 s0fmtr: =Dlf._\ Poffseb# The s of each BA ele shared memory',Hdata area (0 mean` start[&, #. r])).*Mallocated_J= [0w3 ?$ +Jif fmt[-1] != "s" @int(J:-1]O.append(n 7 ~ )$ %rosD@sizetruct.calc\ "q" + self._format_size_metainfo + "".join(0/s)$ QpackingT 0back_transi_codes)) =shm = SharedMemory(name, create=True, =requested)LUelse:Z @if sTnce is not NonLp_enc = Zodingi`truct.*i_into( ,2N.buf01_list_len "*("`alloca@voffsetsC s Pzx?shm__data_startG`*(v.enP( ) if isinstance(v, str)  v for v in 0at_/M\sL  >*QQ*(_re2ion4 a = lenp) # Ob s>b from m 0ybuffer.B_)Y>ist? un_c$\XUc0F"Y1 * 8;vdef _ge(, position)Z"Gets the 0ingT0mat a single value storedP0%."\% =gB>= 0JLEif (&#>='Q) or .7< 0 raise IndexError("RUout of range."0v =jJ"8s"k& + )[0]   fmt = v.rstrip(b'\x00')  fmt_as_str = .decode(_encoding) ,`return&3def _get_back_transform(self, position):H"Gets the 2 2a(R func or a single value."rDif (\@ >= n._list_len) or G < 0E raise IndexError("Requested out of range."_3 = struct.unp Ufrom(oI"b",shm.buf]_offsYn5s +SE)[0] R&ws_mapping[3]m S#@ing_fat_andg,H,D"""S%U UO and8$% a<1 ins"1 at wspecifi?.""d{S[_intoQ/8sR#PMJ * 8#.  elf._extract_recre( BC TNkitem__=6 if >= 0 else+|6try@pt]_data_start KallocatedM$s[+Q@(v,)O +_G)P4gexcept i  B)1v =|v'vO_set)o 0' try7: item_offset = self._allocateds[position]< 7_data_start + _ ;current_formazget_packing({)@except IndexErrorWraise("assignment i5 out of range") Zif not isinstance(value, (str, bytes))o3new@types_mapping[H)?encoded_d1 = Jelsejelengthpy + 1] -b .!(_6ing}5 /if4Pstr)  Cqif len(`F) >  yV!("A/str eds available storaA:if [-1] == "s"w  8 Q p >e%str] % (L: ,&^sI_and_transt id Y  pstruct.g_into(AZshm.buf, *, def __reduce__(sreturn partial.__class__, name=3.lC), (Z?lenW!unfrom("q",Z0)[0]/prT1f'{0.____}({list#)}-R!r})'k@propertya?0"Th Bing * used byf!ly!ed=1s."^vjz"".join1 i)lR i in_ ._F_len.N_size_metainfoG rfor the'3agexQq" * f>c5OF?mat 8sW"Lback_transform_codes(self): "The struct packing format used  the items' back trans%5s."Ireturn "b" * e._list_len %@propertydef _offset_data_start# - 8 bytesVq lengthJ((N + 1) *2element os6uA + 2F /_ -atZ^ {# +%allocated_s[-1]{ _ T=|Bcounx, value8"L. -> integer -- |number of occurrences5"."k1Asum( == entry !in3)6QindexB""L.!R)afirst ("Raises VError ifS is not present.""for position,in enumerateQ"ifh)ZJelse.rA(f"{1!r}in this container"[__class_getQ__ = &method(types.GenericAlias) # # Module which supports 0ionac= objects from shared memoryJmultiprocessing/"<".p$Copyright (c) 2006-2008, R Oudkerk # Licento PSF under a Contributor Agre!p. # im lweakref #. %Kheap@get_Q4ext.5Rreducassert_spawning _ForPickler = -.q __allQ['Raw0', PArray 1copsynchronized'] u'@_to_ A = {cC'c':.c_char,8 'uw1b1Bu1hQshort2('Hu2i"in0H 'Iu0lAlonga8 'Lu1qH, 'Q15fBfloa('dadouble1}~Q_new_g_"@size s.#of!EQwrapp2.BufferWrapper(size ) return rebuild_ctype(_, wrapper, None) def RawValu$code_or_0, *args):W1'''R_As a Zs object allocated from shared memory9A[@_ = o!tooA.get'obj = _new_v_.memset(addressof(obj), 0,S.size@obj.__init__(Y5obj9_ArrayTGEializerG aKF\if isinstance(S, int\O_ * 3+, &DBelse ?len1oresultX#QX5k , lock=True!x=? a synchronizationq for a h94!ifi is FaU r)2n (1`ctx = or get_context(&$c.RLockif not hasattr(&, 'acquire' raise AttributeError("%r; no method;1" %N ed#3ctx,2, *D21Raw| B@copy^_7 j$@pointer(3`)[0] =pe rwJaassertobj, Synchronize dBase), 'object already synchronized' ctx =or get_context() if isinstance(obj, ctypes._SimpleCData):-Qreturn Sj7@lock=!x),/el[WArrayTif obj._yD_ isfc_char|oString21Felseq`cls = -S6try%s*class_cache[cls]  except KeyErro@nameh[field[0] for in cls._&s_RVPd = {>: make_property()F E%s}>H = '2' +u_)__6'U8, (TV,), dEJQ^', B # # Functionspickling/un # def reduce_K[assert_spawn!~rrebuildb , d,swrapperrlength_m RQcBPTNone)(25_, )t2if M@not G<3_ *,_ForkingPner.registerpkTbuf =.create_memoryview(&4objq.from_buffer(buf!#._P4Iobj B to p 4ies [?fwLexec(template % (J,)*7 eV = d[o VQ= '''get%s(self .acquirem'_g!%sVgfinall"`releasIYsm, valuetKm" =;u%)!, )  !} pweakref.WeakKeyDi@0aryS3H Rect):-__init__=c )  =-2ock- ! =/else:  `ctx =  or get_context(force=True) *self._lock8v.RLock(%!acquire = 0.Okreleas* +def __enter__(5!):hreturnf+)@3xit?, *argsF 1+JcreduceLEassert_spawning ynchronized, $g._obj,1obj(k 6obj12 !3___rep['<%s wrapper for %s>' % (typeg.__name__obj) class S( CBase@valumake_property(''K_ArrayPs5>len=1lens__getitem:3, ipAwithTP8[i]asR!, YR" =6Zegetslip, start/op^ >\:stopfO%gs00StrK6E? = 7.aw!raw') # # Code used to< processes when using the ! okserver #5methods.USmultiGAing/91.pyCopyright (c) 2006-2008, R Oudkerk # LicenPSF under a Contributor Agreementu import os %sy Trunpys from . 77_(t_ 15N"Ctionutil __all__ = ['_main', 'freeze_supset_executable@ 'ppreparazT_data5command_linI|_path'] p_pythonw1 isassumed '#& . # People embedd2PLP want9modify i f sys.platform != 'win32'XWINEXE = FalseWINSERVICKelse0getattr(sysV0oze`G) WINSERVI$CE = sys.executable.lower().endswith("pythonservice+ ") if WINSERVICE: _)_exe = os.path.join(d_prefix, ',N') elseD7 def setbR(exe);hglobal2exeGgGDireturnD! #|is_forking(argv51'''jR=whether commandline indicates we are G8@bif lenZ >= 2 and i [1] == '--multiprocessing-H'ATrue[YbFalse freeze_support(aun cod v object if this in not the main';mkwds = {}70for_0F[2:]%name, valurarg.split('=')J)$if&w= 'None4 [R@] = $ B J0 4Aint(|`spawn_0(**-wCit()4_52Ke"s I4 ofh 4P used] zing a childpgetattr, 'frozen', $Y ([.,9] +@.['%s=%r' % item 0in . Bs()]& saprog =+m .0 imu; B(%s)Nr%= ', 'C0optutil._args_from_interpreter_flags(3F[*A] + J+ ['-c',gX.p(pipe_hke, parent_pid=p, trackOspecified by data received over e:assert `, "Not+"7!ifiplatformWwin32amsvcrt6h_winapi f1 is1;tsource_#= Ib.OpenPJ(U2%SYNCHRONIZE |;PROCESS_DUP_HANDLE,BB o S3new = reduction.duplV 6X source_process=so3) fd = msvcrt.open_osfhandle(new_ , os.O_RDONLY<parent_sentinel = feQelse: rfrom . import re1utracker' .._95_fd<Cpipewos.dup(-exitcode = _main(fd, ?*@sys..(3) def8 @withV fdva'rb', closefd=True) as 3_};HA.cur()._inheriting = F6tryBFeparation_data = reduc.pickle.load(> prB"e(J &Oself\kfinallCdel  preturn |._bootstrap(Jcheck_not_2ing)4if getattr(7, '', FalseA/raise RuntimeError('''An attempt has been made to start a new before theC#Hfinished its p"uphase. ?@This<bably means that you are not us;Ffork6youPchildG{aes andAhave forgotten=!us,per idiom in  module:0if __name__ == '_2__'#freeze_supz(%)..1Aelif platform != 'win32' or (`WINEXE andoWINSERVICE)vOpath, '__file__'>&0os.)b.isabs;)-   k;t_join(L,[ $U@normreturn d # # Prepare current r # oldDs = [] def p6S(data1'''0Try3]NauthkeyQ4T'Wlog_to_stderr]8 !]Yutil.(UlevelT :logger().setL-&['=]SkRa,@ @+&di!os.chdir%u 8Ps#I6'], force=True\b_fixupWEB]P  c(c'ls# MultiP3ing helpersafix up"in # spawned!es) name(mod_name#): # __main__.py files for packages, directori zip archivetc, runJptheir "O% only" code unconditionally, so we don't even try toFpopulate anything inq, nor dA1mak% changesC attributes]qcurrent = sys.modules['4!']+if mod_name == "E" or.endswith(".!Y]qreturn Q# If this process wakEked, may already be dD`if get(.__spec__, "", None)Otherwisecontain some non-PwhereFneedusupport unpickltperly. We rerun it aspp__ and @# ths@rmal& an aliaQ that+2oldCy.append)*_& = types.MPType("2Pent =cpy.runF(Y,`Y 9=j<alter_sys=True.__dict__.update(.Q'] = Ie def _fixu$from_pathq 1$'][UnfortunateaA ipython launch script hiscd had n|Q"if _ __>t" guardwork around# by treat lib2 # See https://github.com/ssues/46989` = os.x.splitext(@basep6)[0@ r'$ &hahe setwe expectrre's nomore to dwR, '__k'g@e pams a = through ra0n a1uleg!# we assume isexecutableQv$ai 7%3b%HeRent = runpy.run_path(mai ?, 6name="__mp_<1_"): module.__dict__.updateercontent.Bsys.-Cs['_J\'] = ge def importA !):1'''=Set\r_'] to A at dK7?S_fixuKfrom>q) # # Mlementing synchronization primitives3multiprocessing//Ae.py#Copyright (c) 2006-2008, R Oudkerk # Licensed PSF under a Contributor Agre. # __all__ = [Lock', 'R Semaphore BoSdPCondi!REventl2]  threading4sys tempfile_ `time u .\Aort M+xtH util # TryWe mp.pcleanly, if it fails # raise Ip Error for platforms lackQa wor sem_open. # See issue 3770 try @0Sem , Yunlink except ( e("Thiss a funcZ1" +", therefore requiredC v needed will notF OC.") :`nstantk. RECURSIVE_MUTEX, SEMAPHORE = list(range(2)) SEM_VALUE_MAX = ..)uBase class!sEs and mutexes; wraps `ZR` # Fl(object):  _rO$= F._RandomNameSequence(),)__init__(self, kind, value, max c*, ctxB if is NoneTctx =._default_5.ge (5@6!tx!start_method&C_nowh == 'win32' or Nr= 'fork}eRi in 7100!q  slmelf._semlock(;Wtp._make_/()n0ZFileExists (Ipass6els breCak Uelse:)raise FileExistsError('cannot find name for semaphore') Eutil.debug('created) lock with handle %s' % sl.)Aself._make_methods(_ if sys.platform != 'win32'def _after_fork(obj)"obj._sem./'PregisPV,h `80is I;Nony # We only get here if we arR UnixA5ing1# disabled. When the object is garbage collec or# Eprocess shuts down`unlink/ >from .resource_tracker import > 3(H)5, "_"Finalize;, SemLock._cleanup,  T)),9exitpriority=0r@static=Yf(W $unIzBsem_^K, ' 'F.acquire = Jlf.releas-x0_en _ftkreturnl_.VCBxit_B, *argsI4.0geteQJcontext.assert_spawningl# s=sDh = m&gej_popen().duplicate_child(Z)l0(h,GAkind maxvalue (s(!, 6/ ' = _multiEing.k@rebu*C.$rebd"er1 %rvtate[0] :+( B'%s-m(.current_()._config['semprefix']- Vnext( and)) # #" # class2():'in=1, *, ctxn_1SEMAPHORE, <, SEM_VALUE_MAXF=ctx) def get_value(self): preturn ._semlock._/!) +def __repr__C6tryPWi/ =U 'except E?ionI'unknown'8Q'<%s(o=%s)>' % .__class__.__name__, ( ) # # Bounded semaphore # 3S( (): Cinit \=1, *, ctxaASemLT_1SEMAPHORE<@ctx=BkxQ, max]\/  ,,QNon-recursive ] A1, 1%+if_is_mine( !  = process.current_0().! W if threading43 != 'MainT('b ~+= '|' +S .el?^ == 1t = 'NonePcount() > 0KSomeOther /se;P~  UownerMRR8RECURSIVE_MUTEX+()|"%!, P)?, 0Z2() > 0:  name, count = 'SomeOtherThread', 'nonzero' 2Yelse:MProcessNexcept E:ionV RpunknownI return '<%s(%s, %s)>' % (self.__class__.__U@__, ) # # Condition variable # :(object): |def __init__l, lock=None, *, ctx)"! =)0 or#.RLock()TM)sleeping_ctx.Semaphore(00_woken-Tait_sM! =]make_methods()getstatecontext.assert_spawning* ._/, ,#&9w s!, " =g9T^enterQ+>*4.__+ 'exW*argsF1+ xH.acquirel kreleas*rO_rep6tryI@num_Ters = 3._get_value() -H _TE '0', , timeoutfKis_mine(), \)c'must E() c4before using ")'`# indicate that this tg` is go61to u.1^T?6G rfor i in range(1gHp # YPnotif^$or^ AdU(Truekfinall s this thread has woken aself.__count.release() )# reacquire lockfor i in range(I)):#tm>.Kfdef notify(%W, n=1Apassert !._@B_sem is_mine(), '0 isKu owned'C$noG@waitFeaphore1False), ('n: Shouldahave been able to  vEJ+ '_v'e#Bqtake acA of timeouts since last|ify*() we subtract# from sleepingand rezero+ASwhilek( Sres =4 nX7f8resb0BugJGZNP+ '- s1be xhY er0)@< n 'q2@ 1 R0# wbup one%er"sF+= 1$if.sx ?CV )0 0it Sao-H Lcase somejust happened~ KBpassCA_allG0(n=sys.maxsize>1for<, predicate,W=NoneUresult =+%() if:ultcreturn-k :0end$! =.monotonic() +&ouOelse?[z[ 3 Q4if s= $ ^0- 65if N<= 0X&Jbrea:(2  # # Event # class(object):z__init__<g*, ctx+p_cond =.Condition(ctx.Lock()/Cflag/2Sem'(0ais_settlAwith._cond:  if self._flag.acquire(False): %+release()%return True\  de~ t(WnCwithJcond,R&!_.notify_all()_clear42wai, timeout=Nonj 0l%._&"._r,a,XO2" =c,Parray-@.cre memoryview().cast`g8P# @propertyYGu!._3[0]C_2S.settp Hh, valuj H" =!P12 H %1]Module provi various facili to others of the package Fmultiprocessing/util.pyCopyright (c) 2006-2008, R Oudkerk # LicensedlPSF under a Contributor Agreement.3os itertool%sy tweakref+datexitX # we want to install it'sS0 (# cleanup function before multiprocessing does from sub import _args__interpreter_flags 5.,; __all__ = [ 'sub_debug', ' @infoawarnin get_logger',?log_to_stderr2#qtemp_diPregis afDfork<sis_exit\FinalizeEForkAwareThreadLockTLocalGQclose fdR@cept.SUBDEBUG sWARNING6] # # Logging # NOTSET = 0 :Q = 5 D = 10 INFO = 2"P5 LOGGER_NAME = '' DEFAULT_(ING_FORMAn'[%(levelname)s/%(N] %(message)s' q = None = False def2p(msg, */!):3if I T.log(', ;V#RFOiNMT3SUBZ(C1'''KReturns  used by+3dglobalE ._acquire!()6trydif notO!: "! =ping.get0er(W15.propagate X\# XXXu should @if hasattr(atT, 'un-'e'.%(>_C 62U0 FelseS>Bihandlers.remove(O, (), {}) FoappendF/flL._releas-r  i=:atTurn on% and add a  which prints to xE"Xer = \.qformattF(JvrStreamH>&F.setWuJxder.add<6)`1if 42@setLlM_log_to_stderr =6 True return _logger # Abstract socket support def _platform_s3s_a0_0As():[tif sys.1 == "linux" if hasattr(sys, 'getandroidapilevel'_?bFalse i_namespace(addressRsif not  Vwif isinstanEd, byteL'P0[0]0/elD3strBA"\0"Eraise TypeError('j type of {!r} unrecognized') Oed = # # FunctionK%ing a temp directory which will be removed on exit #__<_dir(rmtree,M$di(& current_process = .!()0-# @ canNone if the finalizer is called?late durdPython-a &,iffGcd` ._config['P'] = 3(6get$-`# get ? of automatiy cleaned uptB U.get(Y9Qempdi3 imHr shutil2fil{ @.mkd (prefix='pymp-'k3info('created)v2%s'f(/ # keep a strong reference to.dQ), si 'J3I?ed Edown4FR(,, , args=(8#il,HBpriority=-100 bi1dircrS for reinitivobjects when bootG pp"ta child_afterfork_registry = weakref.WeakValueDi]gary() 4counter = itertools."()&B_run0_e&er0tem"Rlist(#" .i!"()I S.sort; (index, ident, func), obj in&ms6try .B(obj`except EKJas e54Aker "d =6eU"er_fork(obj, func): _afterfork_registry[(next(8counter), id(obj), func)] = obj # # Finalization using weakrefs # _fi %eriX = {}h = itertools.() classge3ect1'''C$which supportsCect  Ddef __init__(self,B, callback, args=(), kw None, exitpriority=\Hif ( is not 'A andisinstance-4,inLraise TypeError('"E ({0!r}) must bew or int,z{1!s}".formatNVZ, typE))) if3nHV#._$ =)@.ref , !)OIelif_Z; VCValu"Without:ect@ can"~$._% ="! = # ="l,{}$Jey =", {1er_6er) {0pid}s.getpid!Y_>50key !wr,S# Need to bind these lo>y because globalsa_ haveK been cleared at shutdown,=sub_debug= ", 0$=o:1Run unless it has alreadPalledc T:tryOdel [ ._Hexcept Key H%(' no longer Vered'GJelseF!ifw ._\#!=*(!p@igno different process}EQres =vkq%s with1 %sS?%s'RmH{ ._ H;72 @"(*@*B(# =II = \!<f:k`'< return res def cancel(self):5''' C" finalization of the object*66tryOSSdel _Eer_registry[ze._key]Hexcept KeyErrorHFpass*:lseOweakref = callbackargs = \J <#kw-ey = NoneEstill_activeK Return whether thisXaer is I waiting to invoke krV/inj__repr__ 5obj2S%()(AttributeR, Typ Q[N: ifE @'<%s%ect, dead>' %_class__.__name__ZIx = ;D0=%sA(.A S,)qgetattr?$._X4, '#',)6#ifV x += ', e=' + seDF HJPey[0]1notVexitpriority\C\x + '>' pF_runUs(minO4vRun all&s whose  : and at least _Fers with highestK"aroed first;|1ithFsame8ewill b<in reverse order31cre?.C/if1# T01unc7mayp4aftRmodule's globals arer# destroyed. See_O$_f[ "inSy for moNRnotes_k(iflambda p : pe2 G(>={# Careful:pOmutated whil#@runn1(eiby a GC run or !nothread).Vlist() shouldratomic,u8.items())2not0keyA[keykey in list(_f+inalizer_registry) if f(key)] keys.sort(reverse=True) 0for!0 in!s:6fYE = _ fA.getd1#A may have been removed from the 6jis not None sub_debug('calling %s', )Q/:try@,(-except E>ion:import tracebackl[.print_exc(`if minpriority is[PclearA# # Clean up on exit # def is_Ring()1'''Returns true xpprocessPshuttBAdown19r9 X6 or % r= False_function(info=!, =f, _run+s=,Ractive_children=.<current_4< A# We holdlto references to s,Targlist due 1thep# situa described below, where thisPed afterJmodule's globals areUrtroyed.!ifK2ing"V0 = .#('* &'2`('runnDpall "at"us with G>= 0D #(0,+f  ()"Tcheck=  x`becaus`pR# it'`, any +``e()`` will raisB# an AttributeError (@` winds0try@+toTget aEs9cutil._l). On{jcan happenJif someone hasmanipulated sys.0s, 9"bgarbage collected. Th`uctor s@F,ypE!th<0pla|dUvaluez:Bdictj2.For instance,[ setuptools runs a test it ren Eja copy cre$earlier. See issueS#9775 and #15881. Als^g: #4106, #9205d7i for p in active_children(): if p.daemon,info('calling terminate() for : %s', p.name)cFp._popen.A *Nop in a Cjoinprocess "p.2debug('runnhe remai"atexit" finalizers'V_run_B() 0.register(_?_function) # # SomeB k aware types # class ForkAThreadLock(objectdef __init__(selfm._lock = tAAing.E&acquire = 5.kreleas**_after_fork,A._at#0_re) D DE0_en hreturn_+?w, *argsFx+ fLocal(lSWlambda obj :.__dict__.clear()]oreduce_j , HClose fds except thspecified2try;MAXFD = os.sysconf("SC_OPEN_MAX") EELis8P256 cv_all_fds_54(fd~a= list + [-1, G]fds.sort(`assertr[-1] ==,, 'fd too large';@or irange(lene3- 1`1os.%fds[i]+1,cQi+1])>psys.stdnd replace @with0pdevnullO_]_$6if Jris NonexB4T (OSError, Value OpassS"fdC(os.,O_RDONLYy Fp`, encoding="utf-8", wfd=FalsVR6(fdxQraise7Flush standard streams, if anyf'_" Aout.1 Attribut Z5errZ except (AttributeError, Valu C): Ppass # # Start a program with only specified fds kept open # def spawnv_passfds(path, args, ppimport _posixsubprocess^= tuple(sorted(map(int,J!))/errpipe_read, write = os.(,6trymreturn.fork_exec(`[os.fsencode)], Truec, None BO-1, ,AsFalse, gs]gfinallos.close(q, D") :_fds(*fds@"""CR each file descriptor given as an>ument"""for fd inI$fdy_cleanup_tests(zc multiAing resources whenGcompleted.Pfrom " 0sup ## U.$()6Stop the ForkServer\ if it's runningJ sC+2ork&._o._stopR_Track(d"_tI .._ bpo-37421: Explicitly call _run_izers() to remove immediatelyy@# teQ ary directories created by.util.get_:q_dir().L x.gc_collect]reap_children() """An object-ninterfacea.netrc7s# Module and doc3PationEric S. Raymond, 21 Dec 1998 os, shlex, stat __all__ = ["qP", "NzBPars"] class `(Excepy raised on syntax0orsf'__init__(self, msg,Pname=, lineno y=0.g*% =5!<# =E Pmsg =s.3strFr"%s (%s %s)" % . !, { q & default_:1 is if file is None: = os.path.join( expanduser("~"), ".netrc")Cself.hosts = {}[macro:trywith open( , encoding="utf-8") as fp5{c_parse;fp, default_except UnicodeDeZErrorXolocale,Cdef ", lexer = shlex.6(fp &.wordchars += r"""!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~"""NCcommenter .replace('#', '' wh`1R# Look for a machine@, or top-level keyGsaved_lineno =  (2topEE= tt)get_token(Vif not ttYbreak[elif tt[0] == '#'5)if( and len(tt) +winstream.read *continuea'qentryname%PXP '' Pdef':# Just skip to end of"sN6.g.[:m] = []Zwhitespac%]' \t')n_5<1or pO\012x3N\r\n1-.append( J4sl+praise NGP(^+U"bad  %r" % tt6Ino) G # We're looking at startX1an dm.Qlogin = 'W`accouns@pass! =i =W) 4V@if (tt.startswith('#') Oor tt in {'', 'machine pdefault macdef'}):Aif password!uself.hosts[entryname] = (login, account,K)lKlexer.push_token(tt-_breakKOelseraise NetrcParseError(I"malformed %s terminated by %s"E % (toplevel,D*`, repr/),? bfile, "nlinenoelif tt == '~D' or_user',# =^3getb TVqW`if os.:posix' and  _n`prop =Efstat(fp.[Nno()1 rop.st_uid !@getuid(<7import pwd ?tryHfowner =N`.getpwO)[0]g except Keys'g%s' % qm  os)?qo : Q("~/. j (%s) does not match@ K " current Eb") % (,J IN (Dif (mode & (;.S_IRWXG | /O) F#Daccess too p`ssive:g/es E "5ons must restrictC to onlyR" the!",Rraise NetrcParseError("bad follower token %r" % tt, file, lexer.lineno) ?def authenticators(self, host):$f&"""Return a (user, account, password) tuple for givenEE."""G!if@ in g.fsfjrg[%]Celif 'default'J7O/seFNone$__repr__ Dump the class dataformat of a .netrc  grep = $?Eg.keys(z,wattrs =L -%a+= f"machine {^}\n\tlogin {Gf[0]}\n;2if *1]$X#\t J1J-/.2.UmacrosW0mac{, T S[.3x"(rep if __name__ == '__main__'>aprint(()) """An NNTP clientB$based on: - RFC 977: Network News Transfer Protocol*2980: CommoYExtensions#3NP (ver5 2) Example: >>> from nntplib import('news')cresp, ,first, la* .group('comp.lang.pythonA7 'G%0', 6u, 'has'W'articles, range', jB'to'p!) B f has 51 C 5770 to 58210sub s.xhdr('subject', '{0}-{1}'.() Qquit( Here '&A' isJpserver Ponse !. `s are ed into except. To post ana:f = open(Warb') #% containingD, includaheaderIs#(fFor descrill method1eadcomments8code below. Note that all argu+Cand |pvalues  es numbers -strings, not`, sincb!eyRrarely u8scalculaX$ # by Brian Kantor Phil Lapsley. # xov/Pxgtit`xpath,(e  by Kevan HeydonR # Incompatible changes from the 2.x nntplib: # - all commands are encoded as UTF-8 data (using C."surrogateescape" # error handler), except for raw message MPOST, IHAVE)responses?decNARTICLE, HEAD, BODY%`file` argument to various methods is keyword-only #NNTP.date() returns aetime object*newgroups() and ?`newnewHtake?1(orL)I,~rather than a pair of ( , w) strings.z Elist0 a LGInfo named tuplesMdescriptionict mapp@BsQ5KUxover=UdictsMSfieldM(header orag f(values; each I representa~Gview*article(),mEbodyD a (2, A;:9\g"internal"Whave been marked private (they now start withan underscore)OK/3.1utomatic queryof capabilitiet conne8get/(;- N&Yhelper func6 _\!poi!cc$ilVs, bytes-likV&rbitrary iterables yDCline An extensive test suite :-[BTODO<Zpuctured6a (,etc.) everywheresupport HDR Im1s i4 re dsocketQcolle*+#sys try: PCssl jE#_J_ssl = False elseaTrue Ebemail.c 9_&_?9_GLOBAL_DEFAULT_TIMEOUT __all__ = ["!",1 "", YReply TeO$ar @Permanent7ProtocolCData G ]maximal \ length when callu@readq(). ThiRto preven$!)aG6s. RFC 3977 limits NNTP line length to # 512 characters, including CRLF. We have selected 2048 just to be on # the safe side. _MAXLINE = 2048 # Exceptions raised when an error or invalid response is received class E0$(EP): """Base (for all nntplib e.As"""0 def __init__(self, *argsOSc.)G(2try O. = X5[0]1a Index? E'No Ngiven' QReplyG( """Unexpe[123]xx r1HpassNTemporarR24xxL DPermanent5DrotocolC#Re& does not begin with [1-5]ODataW6 inrJdataK # Standard port used bydservers _PORT = 1194SSLu563 # numbers that are followZ@addi>al text (e.g. article) _LONGRESP = {h'100', # HELP1CAPABILITIES$21LISTGROUP (also^amulti-Ac")<5X<2tARTICLEgHEAD, XHDR2EDBODY4pOVER, XtB3sdNEWNEW3s1NEW8rXGTITLE }Default decoded valu r  VIEW.FMT if0sup ed _DEFAULT_'_'1= ["subject", "from@datemessage-idreferencesC:byt 0s"]Alternative names2/inD _ALTERNATIVES?qB': '{!','~ ,3LXterminators (we always outputP, but accept any ofCR, LF) _w = b'\r\GroupInfo = colPions.dtuple('$0['gU', 'last3fir lag']) A[z &|B ['w0_idR} # Helper func@(s) _header(F_str0Tak  unicode string Jrepresenting a munged header value and decodes it as a (possibly non-ASCII) readable <A."""@parts = []for v, enc in _email_`_|(a_str):4if isinstance(v, bytes!%l.append(v.W(lor 'ascii'))TFelsebA*return ''.join(d) def _parse_overview_fmt(lin@"""P" a list of strp }the response to LIST OVERVIEW.FMTrO,/metadata names.0 Raises NNTPDataError if nis not compliant: (cf. RFC 3977, section 8.4):fmtsV0if [0] == ':'q8# M (e.g. ":"(, _, suffix =Z@1:].iN(':'6 z! +P2# HkSubject:" or "Xref:full`=v.lower(__FMT_ALTERNATIVES.get(&,A:# Should we do somethnAwith:?4fmt/QKadefaul_DEFAULT>en(fmt) < len(7r -("so short]if fmt[:_T] != mNl0defCs fieldsra?fmt, , q_process_func=None oQto anMX|m`accord tog[ format `fmt`$n_ ?en(J Q = {}/article_number, *tokenE.split('\t 3z = int(`1i, Venumerate( 1 >={ MP# XXXP"@an e ? Some servers might C# supportcstill 91add/alH[ coq_ =q"[iB 5is_=.0.sts  if i >= n_defaults and not is_metadata: r# Non-d4 header names are included in fullthe responseP(unless 'field is totally empty)6Ah = ,_{} + ": "&if token [:len(h)].lower() != h raise NNTPDataError("OVER/X doesn'tO"s of additionalT.s"" =[5:] el*onf(s[fmt[i]]?-overview.append((article_number,h"s)treturn 5 def _parse_datetime( `_str,  b=None)h@"""P0p a pair2.) strings,p a TN object.qIf only;!:given, i assumed to beDVIAconcatenat%gether (e.g.!toaDATE command)"""u0imem= Q[-6:]! !2:-6!hours = int(JB[:2]mminute 32:4!msecond!#4: Cyear^4[:->@montk}D-4:-$-2\# RFC 3977#psay howinterpret 2-char Qs. AQ that##~!re_!noDs before 1970 on Usene!ifKV < 70^ += 2000W&el)/10*#19*. (T!, %q, day, #, #, )(,un*t, legacy=Fals#rFormat 1 or? asA  in>" fNrequired b4qNEWNEWSNEWGROUPSAIf aHzis passed,\+islmidnight (00h00). HT Ded representa0 des R flag*1is 1 (+a ,2 haTYYYYMMDD:cHHMMSS fBTrue WU* compliant servers should understCboth s;dr,0neeowhen talking^4oldanot isinstance(dt, datetime. C): _str = "0"Oelse&{0.hour:02d}{0.minuteasecond".format(dt)Sy = dt.yearif legacyh#qy % 100#!{0[{1.month 1day s4y, v M?4d}MareturnQ$, ? if _have_ssl: def _encrypt_on(sock, context, hostname"""Wrap a , et in SSL/TLS. Arguments1-(: Socket to wrap}<-m:F 'use for the ed!unectionCRsGNew,;.8"""I# Generate a defaultif none was passedI if2w is Non]O = ssl._create_stdlib_(/./_tserver_= ) # The cls<mselves R NNTPp# UTF-8bcharacter setx1all/ commands and responses:]yM# are automaticallywoded (when sending)C2decP@ceivKrby thisd # However, some multi-linea blocks canain arbitrary bytes (fo # example, latin-1 or utf-16N in body of a message). C taking (POST, IHAVE)N HEAD, BODY, ARTICLE) rawUJdata will{refore only accept7sproducetobjects!Furthermore, sinceJ could be-compliant CRs out),0we y'surrogateescape' aN error handler(,toleranceHeasy round-tripping. TausefulHpapplicasJR(e.g.bways).@encoX@ = '!8'4s 7_init__(selfp, port=#`_PORT,  r=,Bwordg@read"de"<netrc=False_.  out=_GLOBAL_DEFAULT_TIMEOUTsInitialize an instl/. r:M0con75 to-: #$ (kBdard#-!r:(H`authenxte withr0assF: password to use with srname - readermode: if true, send ' ' command after@Gconnecting."-unetrc: allow loading Wpassword from ~/.3F filf if not specified explicitly{timeout: (in seconds)d for socket Eons E  is someLs necessary6uyou areBng to anFNNTP server on the local machine0intxuto call<-c s, such as `group'. If 5get?unexpected PermanentErrors,0might needs>} 5"""^self.host =  0por r1 = >_create_0et(_Jout)1 f = NonEtry:&O* SP.makef("rwb"X2_base_init( ( if.@r or {Mlogin(user, ,5VjexceptE"if _v.close(LRraiseGdef (,)y"""Partial ialization5Q protocol!This instance method>Qextrav up L0tes&deH i`debugg25= 0.welcomeUgetresp()## Inquire about capabilities (RFC 3977)Y\_caps{8getC k'MODE READER';to enable 'z ' p# HowevM$order in which dG'AUTHINFO'& # arrive differs between s.G _sA() failsNQan author0ail], it will set tto True;H5`) rout51rpr; at`a requ(to try agaie# perform'its normal func]E}1onlQwe'reX alykv anywayB*B_v = Fals'ifd'Y ' 1lf.md @" de_afterauth;: $# Capabilities might have changed after MODE READERDself._caps = None"Ggetcl5() (# RFC 4642 2.2.2: Both the client and@servUST know ifWre isO a TLS session active. AOM@NOT attempt to start :JD"ifUis already`6tls_on = FalseaLog inpencryptsetup order is lefubclasses.`authenticatedgdef __enter__()preturn .3xit-w, *args4is_connecklambda: hasattrb, "file")8if 8(P6tryf.quit(Hexcept (OSError, EOF U,6pas ofinalln <d_close4create_socketwtimeout1not# 1 raise Value('Non-blocking r# (<4=0)[supported'@sys.audit("nntplib.!",S.host DA2.CAion( ?#, 3getwelcome4&`"""Get " message from`P(thisPsquirrelway by __in&))@I4 response cod@ 200, posteelowed;s1Yt 201'!al+B."""V9!if`.debugging: print('*r*', repC.){b_N QS: .Q, as : & %CAPABILITIES comm0is nP, an Hhy dict=!ed5!is .A_ver5= 1E"implementaJm,N!NNTPPermanent , Temporary2# Sdoesn't > 6'I= {} Jelse5 2caps  if 'VERSION' in caps:   # The server can advertis veral supported versions,Kchoose the highest.*self.nntp_R = max(map(int,[=]))GIMPLEMENTATt implementation = ' '.join('+['W]}qreturn K_- def set_debuglevel(#!, )ya"""Set ,Bging%p. Argu! '7g' meanf0: no 8output (default&1: print commands and responses but not body text etcs2: alsoDraw lines readJsent before strippCR/LF"""f.=2[bug =6;N@_putvH:ineGInternal: send one1 to^, append&LF`aP` mus a bytes-like object.sys.audit("Clib.!",,_! = + _CRLFMi1'lf$> ('*put*', repr(GUfile.writeXzflush()S?cmdR@ U (through /))Z bunicod.)ngW o('*cmd\0.en\ 2ingv.errorsE!(get_crlf=TruIfromH"* Rae@EOFE1 if7aconnecis closed4sZ1lf.((_MAXLINE +1bif lenG4 > $rNNTPData ('T too long'RhP_('*ge!ife": +K< ine[-2:] == #_HU[:-2][%elF01:]GF 1Ff0getUget a Vaise various errors if the response indicates an error.  Returns a unicode string."""%J = self._getline()"ifdebugging: print('*:*', repr( )7! =0.de|(bencoding,Vs7c4H[:1]c == '4':raise NNTPTemporaryE+2if @5@Permanent@not in '123FrotocolEr Adef p0ong. , file=None)"""Internal: get aH plus following text from&Xserve1rvarious.RsSe , 3s) tuple where `7` iHa and `?(list of byvobjects@If `". b-like *, it must be openbinary modeI*edFile = |6tryc# If aH was passedonsa with that nameREif isinstance(r, (str,)/ 2! =n>R"wb")X.#!ifHS[:3] _LONGRESP.nIReplj F = [?"if!islgdR# XXXP (Iead?dQterminat= (b'.' + _CRLF, b'.\n'Y1 wh1z3n(FalseI0!ife\0]breakJp.starts;/.' /! =:[1:l )p.write(/ Nelse =F'C xu+=^2s.append?ofinallthis method creat,%0clota!if:  openedFile.close() return resp, linesdef _shortcmd(self%):; """Internal: send a comma nd get the\Uonse.:0Samzvalue as _gete().""",{A._pu)r">Jlong, file=None( plus following text+BcmdstringV0() p, excepa1e r@ed `%s`are unicode s rather than bytes objectsw5Ust = ;Y0, [0.dec.encoding,IferrorsF1fora in list]getoverviewfmt]V0 format. Queriessserver if notYlready done, else5qcached  6tryr_7&fmpAttributeE  JEpassh5nes"LIST OVERVIEW.FMT"NNTPPermanent# Not supported by @? fm2_DEFAULT_tu_FMT[:]+W 9dparse_(_Q0 P8 = V}uPgroupV<sC0# Ps into "4 last fir6lagyh [G[`Info(*.split())yP7nescapabilities """Process a CAPABILITIES>.. 3allRn-zy0sucr1ful5 - caps: a dictionary mappPy namWos of token( example {'VERSION': ['2'], ',0], ACTIVE', 'HEADERS'] }U = {}("CAPABILITIcES") for line in%s:"name, *tokens =#v.split(D)Pcaps[.B] = /Ireturn resp, ) def newgroups(self, datp, file=None)"""Process a NEWGROUPS command. Argument-S1: a1 ortime objectRn-: server onse if suc5ful>q- list:! os s(5""" if not isinstance(.)raise TypeError(^A"the parameter must be&, E"'{:40}'".format.__class__.__6__)`_str, = _unparse_I , .nntp_version < 2Lvcmd = '{0} {1}'cm=j_longcmdstring(cmdz54(L)4new(?NEWX!: ^5'*'emessage id@6 {2f?-,d_pattern2, *# @LISTfACTIVEju indicating whichs to query-4`: File M8`store result inF A8%(`, last8rblag) (sl ;1 is-o2' ++Bern welse: command = 'LIST'resp, lines = self._longcmdstring(;w, file)9Rturn @8grouplist(P!) -def _getdescriptions(1!, 1_pattern, reSV_all)K# = re.compile('^(?P<@>[^ \t]+)[f(.*)$'# Try the more std (acc. to RFC2980)  NEWSGROUPS firstD$UA:' +aif not9.startswith('215'yQ# Now!deprecated XGTITLE. This either raises an errorGor succeeds nT same output structure as A. \%{}^ fo w_w2 inqmatch =#.search(ra7.6p()|61if 9 L`name, " =$.Z(1, 2E/R'W_ s[y:] =$'if [S}D[Fthing found*J&''"""Get a+ a singleR. Ifvthan one|dQes ('s' is a )R/noG0@mptyBing.2QlidesVBonse code frompserver,ce it cantonly be  or '285' (xgtitle) anyway|iFqis needed, use{'s' methodRNOTE:nccheckswildcard3Vnor does}5A whe> actually exists."""7-.?w, FalseOW2range ofXkX, Tru `Proces . Argument-:W Q:Rs1": j "ifUssful?- count: number garticl- first: first article number q- last:$name: the group C5""" resp = self._shortcmd('GROUP ' +:)/pif not 6.startswith('211'):'raise NNTPReplyError(9Nswords =OVplit(count = firsE = 0en = len(F8J > 1N-5[1]F323}727!;3;>3>$B4B"2 = F4].lower*areturnFa, int()  !), def help(, *, file=None"""Process a HELP command. Argument-Ca: Filestring or object to storeresult inRsW;: serveronse if suc5ful?A- li%rist of "s *Qed byyNi=Q toJ II._longcmdw ('='\)y_statparse wInternal: (@linea STAT, NEXT, LAST,ARTICLE, HEADEBODY2=art_num =&1]message_idy,K&, 4 ` , /^K.M.7c|~.;Ospec  L:(L S id (wVified? rfcurren is0Vected.2_id)5 idx "_P -']{0}'.format(A)OelseP'Anext Process a NEXT# command. No arguments. Return as for STAT.""" rself._statcmd('NEXT') &def last($!):="""Process a LAST<S1_ar, line, file=NoneInternal: pHEAD, BODY or ARTICLE "spa@s = o`._longw)  re0art_num, message_id>X`parse(,:, ArticleInfo(MAheadtAspec?, *3 A7-Z2: ap numberI5 id-:name string. object to store the eers inGs): server onse if suc5ful?-Q : S_30 idZSst of\s)if is not  cm'b{0}'.format(0_PcOelse@' 2cmdObody+(Thl4](@*n96jl"8% else:  cmd = 'ARTICLE' return self._artcmd(cmd, file) (def slave('!):A"""Process a SLAVE command. RZs.- resp: server onse if sucF8ful\ 2sho'r'Axhdr, hdr, str, *_=Nonedn XHDR (optionalextension). Argumenthdr: the header type (e.g. 'subject')-: an article nr, a message id, or a rangW1-nr2?: FilenameN0ing3! op to storeresult inF,q- list:P of (cvalue)sk5""" pat = re.compile('^([0-9]+) ?(.*)\n?+3, lines =longcmdstring('{0} {1}'.format()|remove_number(]m = pat.match! m.group(1, 2)am else0,[{A for31 in&s]xDxovestart, end?OVEp!: -:|dicts contain0_field$ jH{0}-:%),8@ < fm1zP._getviewfmt(% et_parse_*gs, fmt,,w__specZ!Ife isn't supporteM&al@backXE.{B7p- eithe%/tindicatXto fetch~"in'ion about -J7a ( tuple, g&ofQ)s;N pend is E~ up enewest{will beKretrieved\ndicating the current article number must be used  - file: Filename string or object to store the result inFReturns:-%p: server onse if successful.`list:  of dicts containvpDufields >QNOTE:"message id" form isn't supported by XOVER=5""" pcmd = ' ' n self._caps else 'E':if isinstance(_spec, (tuple,&))#start, eny7Z&+= ' {0}-{1}'.7at(?eor '')7Xelif Q is not None^ = y+ ' ' +8R@respSnes =rlongcmd3Q(cmd,55fmt-getoverviewfmt(%r=$, _parse_*(lines, fmt)def date(O`"""ProZ DATE command..z:Ctime_M0shortcmd(""!if-.swith('111'raise NNTPReplyError(9Naelem =JX.splifpif len(#j) != 2^OData]0 = A5[1]XX/14YOb( ,Q_post,7, f0}00# RU@s a ific exceptionh=Wallow=3 Cpf, (byt\array=Rf = f&Sp# We douse _put#() becausT# - w- wa70ddipal CRLF(iterableRualready a# inQright'at m spurious flush() after each hfwrittep3for:n fp:B.endP_ P&! =K .rp(b"\r\n") + 608ine [:lim - 4] + "..."( return s;0tr(2) -74nb_B + 1Aviewn .x(Lkfor artnum,!in9author = decode_header(T ['from']).split('<', 1)[0]`subjec?"']@lined:$"{:7} {:2042} ({})".format(V b, 20),P, 42)6nes@0s.quit() # Module 'ntpath' -- common operations on WinNT/Win95 *xbs """C. manipul:,8dowsNT/95 version. Instead of iming this mdirectly,  os and refer to- -`as os.. # strings representavarious *-related bit[pieces # These are primarily h ex; internalAthey+@hard[ d. # Should be set beforesK`resolv cyclic dependency. curdie'.' pa .' extsep =  \\&#thT;' al&`/' def4;C:\\binPvnullbnul' 4 os &sy 4tatpgenericS 9  * __all__ = ["normcase","isabs","join","r@driv Xext",P"basevc","dir prefix","getsizMgetmtimeEBgeta,c  "islink","existl Qisdir 0K@s[0] 0s) Join two (or more)!s.Cjoin*  Y e`sep = I0>zF,:+ UI2HnG'F6try ifE7p[:0] + j #23780: Ensure compatible data type evenpBnull|Oqresult_#, d7 = L5Pfor pEmap(, p\ p_E WTX3if & )C 1# Secondz{&[\s Z result_drive = p + result_path& %continueDelifWE and 3!= V}:68.lower() 4<@# Different cs => ignore the first entirelyIN+ TN ),mb# SameU in d:cas[/`# Secozis relat&to $ifi[-1] notNseps- ;i + sepl, pr/`## addBarator between UNCnon-absolute;Hif (j)[0M; g< P[-1:]jcolon)dreturnO0$ +n0* except (TypeError, AttributBytesWarningpgenerict ._check_arg_types('join',;0, *%!s)qaise # Split a(aspecification (letter fold by a # /ln B. # It is always truaQpec +8 == p def sl#(p8"""neBinto/Bsharepoint'Aers.Rs a 2-tuple (qr_or_uncD); either part may be empty. GIf you assignjo* =t*`2[1]@fmjained ,c will , everythingOQup to/including`x. e.g."c:/dir") s ("c:", "yy,dp =Phost  3butfourth directorykcharacter //q/computer Paths canX[ bothka F1"""p = os.fs"(pif len(p) >= 2* if isinstance(p, bytes): sep = b'\\'4alt/Qcolon4:OelseYX'W'V@normp.replace(e, sep)Aif (+[0:2] ==t*2) anda2:3] ! # is a UNC path?# v drive letter or=b# \\machine\mountpoint\directory\etc\...5;** ^ 2index = .find(sep, 2!O3if *J= -1 return p[:0], pc2dR:+ 1l#P can't have two slashes in a rowiP# (afTthe initial6 _2DXGlen(m ,&1[ %:]"if#[1: v2E2@ # Split a?head (everything up to ;last '/'tail (the # rest). AgPtrail?0'/' stripped,Jinvariant # join(v , S)p holds. # The_0ultN(0 wo0end`unless itjroot. def s#(p8"""aname. \Rituple Qwhere_URfinaly Either part may be empty."""oPos.fs seps = _get_both0d, 4)p# set i- beyond p's uGi = yqwhile ip[i-1] notUySai -= 1B =i`i:] # now'Uhas n9$ moes from XS's alQ!esA"! =)!.rN s))%r1d +) "extensionm Astar!at\d0t! #HW component;/q7is @@befoZ0hat}Ialways true that 9Q+ ext5ext Qsinstan1pgeneric!._c[, /'.') else:  return genericpath._splitext(p, '\\', '/D.') .__doc__ =< b # Rethe tail (basename) part of a |d def P(p): 2"""D s Efinal componen@T1"""4l(p)[1]head (dir7directory 0]#Is a symbolic link? # This will always false on systems where os.lstat doesn't exist.R isV(dS@Test=Dtheri .N for Windows prior to 6.0<2tryEst =iexcept (OSError, Value AttributNFG.S_ISLNK(st.st_mode)}Being true Pdangl s lso usefulPl]s?"""Q)#. 4s TqPbrokes,5mount pointAny drive letter root (eg c:\) # !share UNC\\server\$qvolume _ edba file: folder # # No one method detects all three situations. Historically we'v!xi# #=.edas and s. The canon> approach toHs (query`reparsg) failsY`most #%mon case:alternatwPwhich{as GetVFPathName #e!if i*Sresul!uSUBST. from nt import _get& I!+q = None!is'[s3 (ah, !0, of2ed ):[ fs >Qeps =_bothsep.\ = ab80, r/!= QlZ"ifW.p[0] in a3A(notM)(W,)Ml AR!if 0.rstrip(seps) == _getvolumepathname( ).rstrip(seps) else:  return False # Expand =s beginning with '~' or '~user'. #means $HOME; Qthat -s home directory=aIf thek doesn'trn,oi'Gi is unknown, #G2is ed unchanged (leaverror reportto whatever # function]bcalledee as argument) See also module 'glob' for 9sVof *, ? _[...] insG&(AbshouldVbe defined to do full *sh-style environ # variab{r.) defdI3"""~ constructs. .!Ifnothing."""0B = os.fs sif isinstanc, bytes)tilde = b'~'5 aif notOp.starts('V'Ui, n = 1, lenwhile i < n1[i]d!innP_bothW7bi += 15if 'USERPROFILE'3os.4!1[;]#el'pOPATHT A&ryq@drivq[dbDRIVE'~(except KeyENE'0Qjoin(h,%])7i != 1: #Nptarget_U! =F[1:i [.bOwdecode(;8/ecurren+Q.get(SNAME'38!= E >P# TryRguesso7@ By ault all%q`# prof6 iee locatedsame place;areHd by correspond5|Cs. iaE]ormaly, this is likely wrong,Dso we bail out.)ifQ6@base(" 32 = *irK),  u,nYg!eng2" +>i:]containing s-hell variable substitutions. # The following rules apply: # - no expansion within single quotes, '$$' is translated into '$'&/%%&0f 'are not seen in %var1%'2%K${varname}waccepted$! SA%!@$s can be made out of letters, digits and the characF '_- (thoughmaverifi'9Lcases) # XXX With COMMAND.COM youxuse anyFin a,F ex. '^|<>='. defdvars(path): I@"""E9d sSs`forms l!, } 1%. DuUnknown s left unchanged."""-| = os.fs if isinstances, bytesqif b'$'B0in B9b'%2Rretur.jimport string0var2s ={( s.ascii_# +7.+ 1, ''%')OHLE'\''qpercent%Qbrace{r}adollar,$environ = getattr(os, 'b', NoneFelse% if VU?O/ED'C'B'A)  remA[:0]index = 0 lez1lenfbwhile ,<6lenw1c =[":"+1arif c ==_: #9 dV + 1:a($6tryZ. "(c8b+= c + ValueErrorq Kvg5- 1$$elIz:J>8or DNfV4 2]Hc5 @=0 +1:]  pathlen = len( ) Mtry:!qindex =E. (percentEexcept ValueErrorSsres += G! +\}=- 1(Oelseh3var![:]=if environ is Nonl,v = os.fsencode(os.D[!de^var)]EFl]?var?KeyRD+?!elif c == dollar: # variable or '$$'.{!if[B + 1W + 2]H 48cI=3jObrac4O\>+2:o&l5r&k1 + Nr y  x9P>[:0ac1Ewhile c and c in_chars>+= f.d  value = dollar + var res += value]if c:Bindex -= 1Jelse-\c#6+6.return res # Normalize a path, e.g. A//B, A/./B and A/foo/.*ll become A\B. # Previously, this function also truncatedanames to 8+3 f~t, # but as?module is called "nt"_sat's obq wrong! def norm(()6""", eliminating double slashes, etc."""=. = os.fs Wif isinstances, bytesvsep = b'\\'44alt/acurdir-.&paspecial_prefixes = (eq\\.\\',qq\\?\\')w "~''{''.4'\\ !if.startswith(AD# in the case o< s 74se d # { -> device r  ?\qliterals do not do anyU!a,C;unchanged apart fromMOK ! =.replace(9R, sep9,& = splitdriv!) # collapse initial back#'epi1sep3qlstrip(!@comp%.9Qi = 0&0whiq < len(4wi!t f[i] or 2== 3[5del$b elPF=WW :A > 0s_-1] !/Xmu-1:i+1]siCi ==l]C.end  {2l f +i# !A# Ifrnow empty, substitute .*2R.append( +D.joi1_abnP_fall_B"""R}Pabsol@verso#ofK$a B!inJ`nt._getfull'`t availaor raises OSError. See bpo-31047Pmore. """ path = os.fs () if not isabs:isinstance, bytes)$(2cwd^getcwdb([Oelse- , = join(cwd,Kreturn norm&b) # Ran absolute6R. tryxfrom nt import _getfullGname except I Error: #running on Windows - mock up somethsensible8!abbC = _ _fallback  # use nativeZN'odlO0def[3"""0the%version of a 1"""L5  Z v0.1(OS+q, Value Z R  5ina, readlink as _nt_#3A is a no-op\systems withoum@ sup).H"re =aR_deep# These eV codes indicate that we should stopdSQs andix;currently have- 1: ERROR_INVALID_FUNCTIONQ2$FILE_NOT_FOUND"3"DIRECTORY'5'ACCESS_DENIEH2fREADY (implies dr no mediao5# 3SHARING_VIOLA (probably an NTFS pag@HfileE$50SUPPORTED$no for reparse pointsJ$67JBAD_NET_NAMEIremote server unavailab8EPARAMETER~9439A_REPARSE_POINT*&R,JDATA+#4TAG(*allowed_win= 1, 2, 3, 5, 21, 32, 50, 67, 87, 2%3 Mseen = setQwhile2cas_)w0in 1GP.add(1% Aold_1=X *# Links may be rel, so resolv`em aga7o theirGown location # If it'sother than a symlink, we don't know &# what it's actually going to be resolved against, soJ just return the old path.0if not islink(old_,/):- =V*(_breakB@norm (join(dirname,)))Cexcept OSError as exif ex.wine&in allowed_4_raiseQValueO # Stop on reparse points t1arev0symws^- +def _getfinal;_nonstrict(# These codes indicatewe should sn~!hewX# and_vcurrently haven # 1: ERROR_INVALID_FUNCTIONV2$FILE_NOT_FOUND"3"DIRECTORY'5'ACCESS_DENIEH2fREADY (implies drive with no media5# 3SHARING_VIOLA (probably an NTFS pagDHfileE$50ySUPPORT$67"BAD_NET_NAMEremote server unavailabg8EwPARAMETERV%12X'l"%92SCANT_Y 'Y'RESOLVE_(S@unfo !  = 1, 2, 3, 5, 21, 32, 50, 67, 87, 123, 19201%BNon- algorithm isW@findCqmuch of-target directory!as!an2Fresttail = ''9BwhilD &:try. =T+" , A) if 0 ely9ath:E"%I3Q OS ck!is` fullyyattemptJ#ab ourselves. IfBsucceed, =(;Qk1new readlink_deep(patOh) if new_path != :)<return join(6, tail) if U elseS Jexcept OSErrorj"# If we fail to readlink(), let's keep traversingfMpass, name = split(# TODO (bpo-38186): Request thebl fileMAfromdirectory{# entry u FindFirstFileW. For now,bwill rklO@as bwe have it%!if and nottok! + M# =?ame5ame:U9 1def:gy, *, strict=False)%p = norm 0if isinstancew, bytesBrefix = b'\\\\?\\']unc_p$tryif _getfinalQname(A) ==E5-1 = + gexcept OSError~.exCA# IfHdoes not exist and origfly did,6nrp# strip z anyway+if ex.wine== initial_8 areturn( # Win9x familyearlier hav Unicode filem support. 2s_u#_#s = (hasattr(sys, "getwindowsversion")n Msys.:()[3] >= 2) def re (!, !S=NoneB"""Ra+cative Q of a 1"""Eq = os.f+V)if isinstances, bytesisep = b'\\'4acurdir.&pa xKJ'2_IQ'..' v"if@ is  2 = .)raise ValueA("no) specified")@T45 0_ab!"ab`@norm{()6/th,1+;c_driveQ_rest1lit`Q c,6j 50if TBF) !=7TX+on mount %r Q" % (F< t'l= [x for x in".split(sep) if x`<c;# Work out how muchn(Bshared byUi = 0`e1, e23zip *e1+e2-1Ubreakubi += 1@rel_jB = [P] * (ZsC)-i)t-6[i:]if not rel_liWst: return curdirjoin(*rel_list)except (TypeError, Valu Attribut BytesWarning, Deprecation)genericpath._check_arg_types('rel0', c, starraise # Rthe longest common sub-=@ of sequence s given as input. # The func is case-insensitive and 'separator', i.e. in # only differwbetween twosa!us'\' versus '/'h0, #y are deemed to be equal. # # However,* !edj will havestandard rd0 (e)1had:qalterna =) g<lthe # firstZ!inS`. Addixally, any trailing h is # stripped fromF c. def(s|B"""G |#s names,=sZUQ.""" "Rif nos+"('g`() argan empty"')U's = tuple(map(os.fs"s)pif isin"ce`[0], b1sep = b'\\'4alt/-.Felse3I'H2'.'6tryGdrivesplit[ (p.replace(,).lower()) for p inM%s]C_#R!p.B(sep4"d,7f"s]  isabs, = set(p[:1] = pM;5) "Can't mix absoluti2rell"")FNone0# C< that all letters or UNC+q match.qAmadeH# now otherwise  es1mixatringsna would 'beNucaught.pif len(WdQLo) != 18 Paths do>2ame"Nu<y4v! =K[!![ccAif c)cb|AsP<b <  s1 = min(split_paths) s2 = max( for i, c in enumerate(s1):AHif c != s2[i]common = I[:i]?$UbreakJelseH;D0len%] 5prefix = drive + sep if isabs S1sreturn 80b.join(m% except (TypeError, Attribut pgenericc._check_arg_types('V@', *raise tryh# The Risdir implementation uses os.stat and ws the mode4# a to tell whether or not0 is a directory.@@Thisoverkill on Windows - just paswGto GetFile.sLu@from"rev ntRort _aCdir aImport9/Us99,sed abovf """Convert a NT @name.a file URL`vice versa. module only exists7provide OS-specific cT urllib.requests, thus do3use0ly. # Testingdone through test_N def url2C(url:"""sBgpa relat8 of 'r' schemJ3to asystem*; re`ended  alC."""2e.g # ///C|/foo/bar/spam.foo*3and ):)byUC:\foo\bar\Ri string,(Dpars<`itselfs ":" evenBURLsPurl =C.replace(':', '|'5!if0'|'82urlB# No 2er,Bcbslashe/3i[:4] == '////'Q"#`someth+@likeb`/host//on/remote^>$# ~tPto \\9\9B\on\9 9@(not@halvy3of " aYcstart UQ&xN6[2:componentsk3('/d:# make sureq%toequoted&:-t71.un1U('\\'); !)2Vq[0][-1]#in|.ascii_letterse^p = 'BadoP: ' +ep%1 OS(0apt.upper() compo"nents = comp[1].split('/') path = drive + ':'1for21 inoG:7!ifL+ '\\' + urllib.parse.unquote( # Issue #11474 - handing8 such as |c/|{!if.endswith(':') and/6/')=FareturnJB deTname2url(p;"""OS-specific conversion from a file systemL to a relatM1URLnof the '/ ' scheme; not recommended qgeneral use.""">c# e.g.  C:\foo\bar\spam.foobM#es ///C:/foo/bar/-`import37First, clean up some  alms. We are gopto sacr"eDadditional informaq anyway(a[:4] =g\\?\\' = p[4:]-]1.upper()99UNC7)!p R| B!elDp1:2] !=p9raise OSError('Bad!: K0if 0':'pAC# NoF0fier, just:t slashesx 2#1 is thlike \\host\\on\remoteX#@this@////7/7B/on/77(notice doublr&oftcstart N*R p[U#\\: A8Q.joinHF)vWQq:', max"=2$Rif le<) E2 or[0]) > 1eT  8/!) V=j.4[0]c0///d;Yx # Copyright 2007 Google, Inc. All Rs Reserved. # Licensed4PSF under a Contributor Agreement. """Abstract Base Classes (ABCs) numbers, accorF to PEP 3141. TODO: Fill out more detailed docum!onoperators 3bc CABCMeta, amethod __all__ = ["N", "Complex ARealo Integral"] c ;Q(meta=q_ inherit from this cla:ss. If you just want to check if an argument x is a number, without Dcaring what kind, use isinstance(x, N8!).u1"""__slots__ = ()# Concreteleric types m provide their own hash impleSation\[ None ## Notes on Decimal-]p all ofr methods specified byReal abc, but it shouldKnot be registered aH2@beca+dPs do 0interoperate jIbinary floats (i.e. ('3.14') + 2.71828undefined). But,G abstract reals are expected {esR1 + R20 beG41wor/`R1 and+VPboth s). class Co#x(:3""" sT0ion1at f!onbuiltin cP"nrt, those: a conversiAo80, ., .imag, +, -,*, /, **, abs(), .conjugate, ==,$!=tfis given he`geneoubBs5doesn't haveI!alsknowledge about m,XL f@backKthe E+apdescribFeloww&x@(cdef __e__(self)"""Return a . Called forwH.gOboold@True~Y != 0T7Qr4]!@pW!tyxS Ariev}> on! is3ber@Thisruld sub#PraiseI)edError $Q[j3addz, otherm+5prq 0 + yq23neg -b6?posb+self""" + raise NotImplementedError def __sub__(self, other):"0"""" -5"""qreturn 1+ -:WrX 1! -AX-Y'X@abstractmethod?mul* prq . *q%truediv/: Should promote to float when necessary.y%r/75powexponent$**?; sPor co xCJbase/ *+83abs iRs the Real distance from 0. Called for abs)"1conjugateS ^(x+y*i).$") ZQs (x-2#eq"==>pC5.register(F) classg('c"""To ,"B addoperationork on rnumbers.  In rt, those are: a conversion, trunc(), divmod,9%, <, <=, >, and >=[@also>Pvides)QaultsAderived .V; __slots__ = ()P)~2Any%ccan be0teda nativecobject@b1!__Uk0: T|Aatesn Integrala i such that4 * i>0 iffS1>0;q * abs(i) <= abs(self); ** for any Integral j satisfying the first two conditions,D abs(i) >= j) [i.e. i has "maximal"A amoWUose].E/"truncate towards 0"#5"""/ raise NotImplementedError #@abstractmethoddef __floor__: """Findsgreatest0<= 9.2Oceil 8lea>9Sround, ndigits=None)R(s4 to)@ dec places, default+Bo 0.T%If5is omitted or l, returns anh, otherwise's Real. Chalf&_ even'"Vdivmo "4): The pair 2 //,2%)Sometimeeis can be compufaster than\%of Qopera{P r ! %) ?div  W_hMQ() ofg/%3r\ p /3% i (2rq q2/lt<PA< ons ines a total ordering, except perhapsq?NaN3/le lf <= other"C""  raise NotImplementedError ## Concrete i!ations of Cox abstract methods.<rdef __c$__(self):}3"""D == RfloatX, 0)"_eturn*)@propertyjBrealM ~Real numbers are their ._oonent.|+mOimagm have no ,_inaryp 0lconjugatecC is a no-op for s .register(|) class R0al(& """.numerator and .denomin should be in lowest term__slots__ = (@UT6x  ^`*)<'s conversion to i+)0 = /0e@It'sortant thai!us integer's "true$Adivi`ratherFn casting one side before 6Ading so:0t rR@0hug$wt without overflowing.Ir6nalT addsrwork on!r5In short,A!seK int, pow modulus,91the!qbit-strRpYd$5'___intL#inZX= yR?dexTCalled wheneve` indexneeded, such asyslicingS__powQ, exp,[S=None0"""$5 **,$ %-, but maybe fa:PAccep3e/ argument if you wYo suppor,?%3-. of Q(). R{aa TypesRE < 0GeyzTsn't 0. Owise, justF 2-argument version described in Complex. 5""" raise NotI%mentedError #@abstractmethod def __lshift__(self, other):!g0"""2 <<t2ruv~u3/>>9ru?>> 6?and&9q &7?xor^9q ^7|9p |7Tinvers l~# Concrete iations of R al and Re  sM Ofloa!R) == 2int)]eturn#property_vnumeratorK xIntegers are their own 3/s.y+Andenominp whave a .M1o11 ral.register(int) opcode module - potentially shared between disnm2s which 5ate on byteTs (e.g. peephole optimizers).| __all__ = ["cmp_op", "hasconst Cname Djrel Qabs",! 8Dloca"dcompar;1fre $opP[opmapCHAVE_ARGUMENTj EXTENDED_ARG", "hasnargst"] # It's a chicken-and-egg I'm afraid: # We're imported before _opcode's made. # With exception unheeded # (stack_effect is not n) # Both ours and eggs are allayedc --Larry Hastings, 2013/11/23 try: 'Sfrom ' s%__all__.append('!A') e! IRError\ pass cmp_op = ('<', '<==!>>=') hasconst = []Ename Fjrel 5abs Floca@compE6freEBnarg9 # unused opmaT{} opt"'<%r>' % (op,) for op in range(256)] def def_op(9R, op)Jp[op] = Mk["opBC YB0has/2op)DD/D?absD9absD# Instrucos;iled codelank lines correspond to available @'POP_TOP', 1)zROT_TWO', 2HREE', 3$DUA4E5ZFOUR', 6eqN9(UNARY_POSITIVr,10DNEGA:0NOT2dQINVER!BIoMATRIX_MULTIPLYA6vINPLACE_&7gL@POWE1`.20:QMODUL|};0ADDpSUBTRAC2 SC2FLOOR_DIVIDh2>GTRUE!7 D8# EpGET_LENVMATCH_MAPPINGpSEQUENC3*@KEYS6*COPY_DICT_WITHOUT_%4_EXCEPT_STA+41AIT5@ANEX5BEFORE_ASYNCyH', 53END FO5s55k5 l5 ST2SUB46vDELETE_EPLSHIF6('BINARY_RSH IFT', 63) def_op('BINARY_AND40XOR56INPLACE_POWE47bGET_IT8YIELD_FROM"9"PRINT_EXPR&70LOAD_BUILD_CLASS', 71V2AWAITABLE TASSERTION_ERR72LSHL7Rj77k7 59) LIST_TO_TUP8RETURN_VALU8IMPORT_STAP8SETUP_ANNOTAQ8QTPOP_BLOCK', 87PEXCEPt8HAVE_ARGUMENT = 90 # Opcodes from here have an argument: nameSTORE_NAM390)M# Index in +V list5VDELET616E# ""_UNPACK_SEQUENC^2( # Number of tuple items jrel4FOR9xPEX', 94)0ATT 95d666Z`GLOBALv7& % &8&%"PROT_NB*@CONS/10zRconst{1has.append(1L$10 !10?  8=a', 103 8. 7"SE46 o?set61MAPl 6dict entries$10 COMPARE_OoComparison operator e7)s59)2JUMP_FORWAR"11Mbytes to skip jabs:IF_FALSE_OR_P11) # Target <@ offUbeginningmQ9TRUP^ {pABSOLUT%11K * 1C*)6*h2#11!hdef_op('IS_OP' , 117) def_op('CONTAINS_OP'8qRERAISE9) jabs4JUMP_IF_NOT_EXC_MATCH'21) jrel&SETUP_FINALLY2) # Distance to target address LOAD_FAST949  # Local variable number hasl.append(124VSTOREN5NM5MWDELETN6NM&6)GEN_STAR9L& Kind of generator/coroutine&_VARARGS*!30B1# N@ raise arguments (1, 2, or 3CALL_FUNCTIONI1IU#argsqJMAKE(g # Fla(BUILD_SLIC?!33NLitembCLOSUR4 5)Efree3"QDEREF6.6/7/0808 A0_KW4D!# Bi + #kwL 3!EX3OM J1WITe4EXTENDED_ARG@84) e = 144LIST_APPEND.ObSET_AD85MAP }UCLASS#4#}&_5} 52S -dASYNC_5FORMAT_VALU5mCONST_KEY_MA5#QSTRIN(57) nameQMETHO&6081Mm&62MQUPDAT6DICT_MERG55^"l #, #, #, r """ Op% Interface This module exports a setfunctions correspondinghe intrinsic oZs6Python. For example, # .add(x, y) is equivalent hion x+y. The s are those used for special methods;without leaand trailA'__'Oalso provided Rconvenience.(is the pure i5a)"mQ.v __all__ = ['abs', 'add1nd_ tt0tercconcat Atain3countOf', @'del#- eqfloordiv "get#gVi~GiandO 'iconcat', 'ifloordiv' alshift bmatmul "od& a'index "Of LBnverK!or1powre J!s_Bs_no61subtemgetteEDtruexYIle',Llength_hinJlmethodcall^m K ne1neg!ot!or0pospsetitem'Ptruth2] from builtins import abs as _abs # Comparison Operations ***!# def lt(a, b):P"Sametqa < b."qreturn 5e5=62= b7/eq7=77nn!77g7>77>># Logical03***lnot_(aZnot aU5RTrue if a is , False otherwiseQ0e&,`?is_.is8/noW0is mMathematf@/Bitn&a6abs+ 2(a)?add++e?and:&7&7r.//<1.__J__()aEvC~A~a ib = inv:<]</mod%%6/uln*6*69@9@9>neg-"-a /or|c|c/po+c+c?pow** b." retur"n a ** b def rshift(a, b): "Same as a >> b."Pretur;;?sub8-7-qtruediv:/:/:?xor6^6^6# Sequence Operations *%#_conca3+ b, for a and b ssIif not hasatt'__getitem__' msg = "'%s' object can't be enated" % type(a).__name__Eraise TypeError(msg)+* containse0b i(note reversed oVCnds)r&-.YuntOfUR'the number of sfwhich are, or eequal,count = 0qi<if i is bDfi == b!CA+= 1D0del del a[b]995r8_index,afirst %1f0, j@enum ifjiFelse<FCValuG'.a(x): x%in"')s3, chs[b] = c< length_hint(obj, default=0G"Tan estimate$cAobj.@This%ausefulpresizingeers when buildpfrom anqrable. M0If psupports len(),result will exact. Otherwise, it mayNPover-eunder- by{arbitrary am k. The `!anJinteger >= 0"5isinstance(_S, intb,( be,erpreted9nager" %Cf#k E7tryC\2obj?fexcept.Bpass EV" ==F7.__pFVAttribut[re`val = k O0if Dis NotImplemented5nce(val, intC): #msg = ('__length_hint__ must be integer, not %s' %;Btype(val).__name__)#raise TypeError(msgif val < 0 () should return >= 0'bLValuc/val # Generalized Lookup Objects *# class attrgetter1"""Ra callable om that fetches the givenH ibute(s) from its operand.SAfter f =-u ('q1'),KlS f(r)*@s r. @@y, 'dateHgH(I@, r.))Rh.first', Y.last]h]a8g8lY__slots__sh_1') Ndef __init__(self,41, *0!if isinstance(%W, str@. '- Na@Bing'? ._4s ,"F.split('.Ffunc(obj2for!insobj = getkK,. -`1obju0 = Jelset,ib1) +s8V&tuple(map/', J) VN ) /0 inJters[ur_ t?rCrepr=8'%s.%s(%s)' % 1.____.__module__,>9@quali;sQ.join  oreduce IhBitemAhHc(p/(2^8[2] \9h, 5, 3? U[2], r[5"3]] Y)0, *s<if not items:' self._items = ( ),)"def func(obj):Hreturn obj[=]!^acall =EJelseM,D1 + @{Ptuple[i] for i inN nf __0__($, .(m') =Crepr=8'%s.%s(%s)' % b.__class__.__module__,Q9?nam7', '.join(map(", Kq+))Oduce9 I! p methodO"er1"""RJ a @ablehect thats the givenH os operand.IAfter f =%P@er('1'),Eb f(r) @s r. (()DgD, 'date', foo=1SgSW 1d__slots__ '_Q_args !kw Cinit , 3`, /, *)B, **3n)! =0Kif not isinstance,W, strF0raise TypeError('U must be a9Fing'd0 = 2 = A  getattr{w2)(*]pb Pc7@ = [)"}.extendB)+a'%s=%rQk, v) .(G8v&jW!GzC,) +xCPAfromttools import partial8vm~N Ak # In-place Otions *%0# }iadd(a, b"Same as a += b.> Fa?nd(a, b): "Same as a &= b."  return a def iconcat(a, b):!"B += b, for a and b sequencesYif not hasattrG'__getitem__'S msg = "'%s' object can't be enated" % type(a).__name__Eraise TypeError(msg) a  floordiv(//&F_lshif'(< >?powPoa **=b@r (>>D?sub-@ ?OtrueJCVCxE^? ?B tryfrom _operator import * except I 0pass else?__doc__ # All of these "__func__ = " assignments have to happen afteking # mto make sureay're setDthe righthtion __ltz lt e ae __eq beq __nng g <g<"no a __abs@0abs"dd ddndnd_ __@" __index vv"eruPinverF% R __moo mo}1mul0mul gneg __or or"po po1powbpow __? a __subcsub __ C __xbbxor __# Btain{1con b __del3 =  3 = (2 =8Ca!ia#ia u ii  {6m iim d4 qirig' (uiv """A powerful, extensible,easy-to-use optiron parser. By Greg Ward Originally distributed as Optik. For support, use the optik-users@lists.sourceforge[ mailing list (http:// s+finfo/o\). Simple usage exa: from import 1onP&9r = ()AP.add_u on("-f", "--file", dest=" `name",6 help="write reto FILE", metavar="xqx_quiethaction="store_falsSverbofault=True don't print status meshs to stdout")F(!s, args) =dD_ () """ __version__ = "1.5.31all"[''S'make SUPPRESS_HELP[USAGEkValues}Container_GroupZ HelpFormattQIndented$ OTitl" 1OptzOErroConflict"(2Bad/check_choice']copyrightC (c) 2001-2006aory P.q. All <s reserved. ?2?P Software FoundaJ5 Reqion andAin sbinary forms, with orout modifich  e permitted provided that$`followPcondis are met** Ds ofcode must reReabove enotice, thismEqn&e disclaim!. 7in produceB0 inXdocumentf/or other materialsn6the@ion.Q* Nei7 author noru {1its2con ors may bo endorseppromoteducts derivedIsout specGz]rAnKs80. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRJIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE7 OF MERCHANTABILITYp@FITNl+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALLqAUTHOR OR CONTRBE LIABLE `NY DIRECT CIDENTAL, SPECIAL, EXEMPLARY,CONSEQUENTIAL DAMAGES (  TO, PROCUREMOF SUBSTITUTE GOOD_SERVICES; LOqF USE, DATAyCPFITS;ABUSI+ INTERRUPTION) HOWEVER CAUSEAD ONTHEORY OF s, WHETHERG*A aSTRICT+'wOR TORT NEGLIGENCEOFWISE) ARISINGS>pWAY OUT0THE IS SOFTWARE, IF ADVI!OFSPOSSI3#CHo. """ import sys, os,textwrap def _repr(self): return "<%s at 0x%x: %s>" % (.__class__.__name__, id1), KJ # This file was generated from: # Id: option_parser.py 527 2006-07-23 15:21:30Z greg70206-11 16:22:03Z gward1Bhelp/7/7_aerrors0#0904-20 00:58:24_B try9@ get` {3, n except IEf>$(message 2W(singular, plural, n?if n == 1lR<VJT _ =1 P OptP1 (E$iou__init__W, msg&`.msg =S__str4/0elf63ion =Raised if anion instance is crewith invalid orinconsistent arguments.` ,  id = str()!ifw.0?_id"0 %s2_ida)OelseN7msgionConflict1Xc33ing.s are added torryionValuew,ya vDencountered on the command line. """ class BadOptionError (OptParse%):/ARaised if an invalid o> is seen on the x tEdef __init__(self,CC_strn%@.opt$ =! A3str@7return _("no such:ion: %s") % XAmbiguous d8 a@m 1, possibilities{ .J)/ L* =\UL(_("X (%s?)")sw!% , ", ".join D))) HelpFormatter:zAbstract base Rfor f04ingrhelp. r instances should use one of ~A sube escAkd; by default IndentedE ise"d.I attributesg0 pz>r :QX`ntroll 1 i_increment : int `numbercolumns to8 per nestgSlevel:@max_P_posi6Xmaximum starA_@D texS calculatedV;qitiallyqsame as *\width^otal &ooutput (pCN>to construct[mis valuebbe taken from$COLUMNS environvariableX @curra({ _ =R (in s~%Pavail& (]=_tag : st0ext4replace with ea%'sz`C, "%N" Q. SeQVfalse1dis<expansion5 ings : {% }tDmaps`psnippetzX  explainingE,Pyntax+Cthat, e.g. "-h, --D6" o6"-fFILE, --file=FILE" _short_opt_fmt : str formating controll Ahow : options with values areD"printed in help text. Must be either "%s%s" ("-f6) oD"%s  , because thoser the two syntaxes thatOptik supports.__longsimilar but  +=; mS-fileg1 o=#)A""" - NO_DEFAULT_VALUE = "nonedef __init__(self,6indent_increment#@max_P_posi$_width_first):~.parser = Non < = L1if }1 isJf:try0T t(os.environ['COLUMNS'])^/except (KeyError, V +^)80FE-= 2=  u1 = 0 E = \8Mmin(*b, max(q]- 20,VV * 2)qBcurr#*6 =  ^levellp# compuFlateP3sA'default_tag% .r_strings = {}G =^ &%gBset_i # = @^delimiterML1if @ not-("", " "#jWraise("invalid metavarWzr: %r" %# $F2" +, +U-Qr=C)   X+25mF+= 1< ded-d assert self.current_indent >= 0, "Idecreased below 0." self.level -= 1 def format_usage(&!, !):#?raise NotImplementedError("subclasses must i"-")csheadingeg8_Ctexte b&""F a paragraph of free-H ; inclusion in thehelp output at1 cu  at6u.6d_width = max. - .RU, 11)Kf = " "*.)areturnwrap.fill(},# #) sinitial=4 vsubsequ79pdescripN"', (if& )Kf + "\n$OelseG-""Tepilo OR\n" + 4)expand_defauloG parser is None or notBO_tagT.q5rvalue =Je.cs.get(>Gdest_AO_DEFAULTD+on #NFf_VALUE#r.replaci, str(`)J y`# The ggReach % consists0two&ts{Q# *p0optings and metavars+ eg. ("-x",:"-fFILENAME, --file=";fuser-suppliedostringgkon expert mode", "read data from qO If possible, we write botqthese o same li -x/ h { But ifV0 lis too longtBa second,Qed to`column it wouldH0artm iffit on the first line. # -fFILENAME, --file= (3 read data from ,result = []@ opts = self.option_strings[ +d_width0help_posi7" -Ecurrent_indent - 2lpif len(sr) > optP:" = "%*s%s\n" % ( ZP, "",D)s)?xP_firs: .Pelse:r# start : on same1 asuF=_-*s 0ir.appendE ifion.helpPE_texexpand_defaultJ:ionE4<Pwrap.(, C EpO[0])I0ext[JPK F2for!in_2fs[1:]]8"elXs[-1] != "\n"] 6\n"?return "".join(+!) def store_fu, parser)l8(bmax_len = 'copt inFFlistQ lformat6optq6+]G:+Cmax(, 2) +K v^groups/:0 J3? = #+ des 9rT= minC + 2 * r#iG, 11WDB"""RRa comma-separated $ o & metavariables."""3takes_value(s?$ =_P4 ordest.uppery<AshorND[%.__fmt % (sopt, metavar) for sopt in option._short_opts]:Along = [self.__fmt % (lopt, metx w,wLvYelse:/ = ,Q+ +1if [Zfirstt 2 =  &+ H[+=+' +Dreturn ", ".join(8) class IndentedHelpFormatter ()2"""" help with i?@ sec bodies.2"""def __init__( , J_increment=2%@max_}P_posip?=24'width=Noneh#=1 . -, !, ,n) fjb_usage @_("U&: %s\n") %* LsheadingNP"%*s%s:\n"P.current_d, "", @ (OTitl&&underlined(a/er)20 ),0J)/ (*lB"%s %glLB")),F,&"G5b, "=-"level] * len( Q)) parse_num(val, typea if val[:2].lower() == "0x":# hexadecimalvradix = 16/elKbK# binary1[D2Qval =2:] or "0"* # have to remove "0b" prefixE"1]Do # oct8B&se5 /# 0+ku)0int2_int) _builtin_cvt = { "int" : (_parse_int, _(eger")), _"long6Bfloam h `ing-pooqcomplexr = ")) } def check_builtin(option, opt, value):(cvt, what) = 0[4a.type],2try5return cvt(P#except VbWError1aaise O (7Q2_("v %s: invalid %s: %r") % )`choice%"ifP0 inBion.3sFelse0 = ", ".join(map(reprfU!))Ar&q (choose from %s)"`d", 9s)) # Not supplying a default is differentXof None, # so we need an explicit "nWBied"\. NO_DEFAULT = ("NO*") classZ1"""+Instance attribute_short_opts : [string0 _ S@ ac2 : 4 Ndest*S: any<@narg3int1con;$callback : funE__T(any*73_kw{ # }FLhelpzmetavaru4# The list of i that may be set through>keyword qto the qructor.'ATTRS = [''U'   +s  1'] "_#ofs allowed by crs. E!ly#edG@here @ canidate itscumentsPCTION("store"" _T?tru;OfalsoappendTs_count70 "help":, "version") -# The set of actions that involve storing a value somewhere;Aalso listed just for constructor argumentA0idadc. (IfA3the{p is onethese, tj mWbe a destinD)@STORE_ACTIONS = ("-e" _$ ?truG Ofals$oappendf _count owhich it makes sense to supply0# type, ie. 71mayfume an@from command line.E_TYPEDu callback *require*# alwaysALWAYS_Y# "Z 0tak'' attribut\^CONST\( }%Qknown-s op parsers. Again,x3forP'84p", "int@longAfloapcomplexfchoice!Di0ary >Pcheck1fun!#s,convert and#j#e Es accordG!to"#DSignatur}C is:*! (K1: O\,~P : st ,%ue) -> anyDS  90ionO instance /"heze:7dactualLqseen on-t (eg. "-aP--fil3# i W ] cjcreturnMshould be iappropriate Pyth3ype@c.@ -- an integer if!"== TIf no8,qdefineda",s will b!un edms remainsg_CHECKER = {F:u_builtin+? /R/uiltin,   "complex": check_builtin, *"choice" /.1} E6# CHECK_METHODS is a list of unbound method objects; they are called ~@# by constructor, in order, after all attributesDinitialized. Theis created and filledV9latVG3the] actually defin\(I just put it here because IGslike to6{documentXclass!inCsameCplace.) Sub/es that adrother _3*()d shoulRZkir ownT^2eir)Nto those from thU. e= NoneF-- C/Sationf?s -g`def __?__(self, *opts, **1s):JSet _short_%Q_long us'r' tuple?1Havbe set nowcase no opbstring'suppliedF.U = [] 2 = $Copt_p()J!se $% # <72@ (ac, type, etc.)!e' dictEj()8CdG "we32set re lots ofc!# !icinterdependencies, but luckil,y can be farme0out $s -- which0uldchandy for s!j0one ngj!seBshari` at"y raise OHError if`discov problemS| er t+.F .J, F0FilsKearly versionk had exactlyAaA, ei/of T1opt-0ptsM6optn`if notls#AType("at lea ne0x m"`return0sh*f `if lenZ) < 2raise OptionErr_or(  "invalid option string %r: "1must be at least two characters long" %Qy, self)Helif len(opt) == 2: pif not #0[0]%a"-" an[1] != "-"):>qraise O?Err+Pshort;of the form -x, (x any non-dash) K)!.__opts.append V.se H#:2JK2K@J start with --, followed bKE*Ddef _set_attrs(!, b1for1 inj.ATTRSt%if#? tdj[]11delTs!/elL6'default'@.seNO_DEFAULTpJ6oneDss = sorted(v.keys();akeyword arguments: %s<", ".joini)),Ng1) # -- Constructor (a&methods - J`check_ac@\"ifS{ is Non.!= "storeV#@[CTIONRAf@: %r6V Otype XLWAYS_TYPED_A=pchoicesb8-s# The "0"Uibute implies " .9 % =/ )'A# No^ given? p"Fmost sensible se:  # Allow type objects or builtinconversion functions %# (int, str, etc.) as an alternative to their names.Aif isinstance(self.,)):,x"5 = 0.__[9__ 0&if# == "str"S #Oing"Ibnot inZ^TYPESRraise Op0Error("invalid or: %r" %J)a} }D_ACTION YMQ"mustXsupply aS for u,)%def _check_choi ' &s is None]list of _t" '$'"Aelif 5s, (tuple, `)B Q Abe aRstrings ('%s' _ied)"H%(LW)).split("'")[1]}.1l SUuRPAdestYP# No i^ on given, and we need oneCthisa. Thea#k callbacks that takVvalue!s_1 = .TSTORE5 orz~ur":UP# Gle &@from first longa,#  4Zshort5 N_q^_opts # eg. "--foo-bar" -> "foo_ P\ [0][2:].replace('-', '_'PA?elsWWX"1]g>con.UCONSTuG, #q'D'>G%be* n %r" % self.action, aself) def _check_nargs(:60if K2 inTYPED_ACTIONS.2O is None#'V$5= 1p$elrois notDraise OpeError(D_!"'Da' mustGbe supplied for !b %r" %3callback6 D== "+" !ifAableI.W),'o ^:e,)>:if _I and3visinstancB, tuple)0P.,Bbe ag:=%r"P  /kw/Do, dict2QhQ ;elsq5elf&0A(%r)Dnon-! o;Sw<U9CHECK_METHODS = [FAsjNtypec"_choic$ OdestF /on# "F "] # -- Miscellaneous methods -J}a_str__oreturn "/".join._short_opts +a._long __repr__ = _repr def takes_value(self):preturn .type is not NoneAget_opt_stringD"if@P_long(s` d$5[0]Oelse4Ashors5 # -- Processing methods -J"Wcheck"q, opt, 3.'Ber =TYPE_CHECKER.getG)4if 6!isWj5Ki oonvert"if nargs == 1 y@0qtuple([M) for v in&])p  s, parser):4u# First, c3B theZa(s) to`right . Howl if any#3are bogus.0h"0P# Andyn whatever actionexpected of k`# This"a separatemake life easierMwsubclasses-sadd newvW_(JY,* deh VI,/, E1== "store"atattr(s]/elIo_constO./T ?truOTrueM OfalsNF*Okappend$s.ensureB[]).3WY J_YOcounso0) + 1callback#0#_For (O!kwS.^or {}]' value, parser, *args, **kw 3) elif action == "help":&parser.print_ (? Gexit Yversion\ #E_ *se raise ValueError("unknown%r" % self.%) return 1 # class Op SUPPRESS_HELP = "0"+"""[USAGE#2" V"s:ydef __init__(, defaults=None)%iffor (attr, val) in)w.items(F10set3t >3strA'1str<.__dict__J__repr__ = P#eqOw, otherVif isinstance(,s&|4[YP u8NotImplementedupdate_careful5+, 5"""bU0a the oues from an arbitraryFionary, but onlyHsuse key8q that already have a corresponding UibuteG"in0R AnyQaict withoutEare silently ignored.cid 2ttr"*ct #adval =[L]jL%pis not jG)'__looseE!us"ll+  regardless of whelA?the Z0 or!o.([, mod"# iaFiGE !?-el Minvalid ": S}bd_modulrmodname=p__impor -dmod = sys.U#s[#'(vars(mod), mode) def read_file(self, name, mode="careful"):37vars = {}exec(open(? ).Y@(), .)*e._update(h)ensure_valu@attrI7lueif not has  ) or get vis Nones)koreturnS class OptionContainer:1"""EAbstract base 2."C>dibutesstandard_oY_list : [h]V4of 0 0s that will be accepted by all in05cesHof this parser (intended toGoverriddenI1sub3es)IW Dthe  objects cT!l`_short0 : { string : 0dicary mapp&;;:s, eg. "-f"OS"-X",j Nuimplement them. If anChas multiple iappear inBItimes. [1"__long#:-"--exclude",BAgain, a give/ can occur-defaults?any  destina. sSs for each5)[1] Thesess are commonVQ(shar)components eG@rollPp, whereuy]initially createdN __'#__(_,{flict_handler,1cri2# Il!iz6pand relP data`uctures.0# T~method mustpPprovi6by n , S!it'B0ialqat leasp follow/3 #&, O%, EQci1ionC($\$ =nk)yset_con{( S44des( def _create_option_mappings(self): # For use by O,Parser constructor -- create the mainAo6 bMdNJthisSwand all<rGroups that it owns.%._short_opt = {}# single letter ->u instanceKOlongJ0 #  I defaults0 #sI@dest1 value def _share 1, p @ Ydp3Q from e q\# =$._ *(YT4set_conflict_handler#, 3$if not in ("error", "resolve"0%praise VE+("invalidhw:u_d %r" %k) $ =) adescriST7 = TGget_TG|return Nve"ncgGion){t_opts:   if opt.startswith("--"): (c_option._long s.remove(opt)8del self8_[opt]0Oelse_short!9if not (5Vs or 6container.GT_listAT!) pdef add@ion(>, *args, **kw t7""".O opt_str, ..., KA=val41"""if isinstance({[0], str)" =|_class(]elif lenX) == 1 andsV3 = I/#,  L3raise TypeError("#an1 p: %r" %26ion( Qpinvalidsuments"._check_conflictNe&6eappend)J#.jH0for0 in s_.# =7Q P OPqdest isPNone:# #p has a %, we needUfaultO4SVO_DEFAULT5!de0s]. m"in1 o+Tretur -s./6ion$  5D# -- aquery/al methods -!ge.1.ge,I) or, /;:hash;\  .}:e  is None:  option = self._long_opt.get(opt_str) ,C if 0is None:# raise ValueError("no such6P%r" % W=0for0 inion._shortsd3del"_[opt]L K! J.container._list.remove#aion) # -- Help-formatting methods -JBdef Dion_help(,Fter)bif not!eturn ""sult = [B/inR wr. is SUPPRESS_HELPu.append(Bter. [~r.join(re)0adescri0Ms} > _)rk d"ifYZ ($3<)'[[3[5K"\n" class OwrGroup ( C?&):__init__6parser, title, =f /2 =  q.f"~C,;conflict_handliI." =ccreate rS !]U_sharEmappingsI.Aset_ M p!qdestroy:3c"""seeP.+7)."H {&24:B3c& =Pcqheading.indent(Q#+=2XZ-deZa) noClass attributeAs:  standard_option_list : [O]&! 4of 0 0s that will be accepted by all in05cesHof this parser class (intended toGoverriddenI1sub'Qes). IIW attributeusage : string."a  for your program. Before it is displayedAto the user, "%8"Dexpa&uname of=kp (self.A or os.path.base7(sys.argv[0])).C. ktcurrentS (to KeI qadescriMApagraph ext giving a briefw@view  @ ry0matK[ito fitterminalwidth and printsAwhen6 requests help (after ,FPbut be8nepilog3par"ofgt"to tN tfgroupsvG{A.i0I(&arirrelevantv>command-line, @very&fue.pgenerat9I)`allow_rspersed_argbool = truf`, posipal argume0mayMP with,Fions=PAssum!-a-b each take a singleZ, -ablah foo bar -bb z#0pre<saKC%--T&baNIflag were false3at  e wouldzqk|q-- ie. we stop0ces!V as soon&eUfirstCnon-bP. (Tiae trad0 foAPython's getopt module, Perl's Ga::Std,Uother-Hlibrarieslly annoy! to5rs.0pro_default_value5 54areRed similarly11Hfrom:E is1ey V2ass&th@type-check@funcEt0's (p (as lo defa,ult value is a string). (This really only matters if you 2have defined custom types; see SF bug #955889.) Set it to false H#restore the behaviour of Optik 1.4.1 and earlier. rargs : [] Jargument list currently being parsed. Oset whenA__!()$active,qcontinu#trimmed down as@we consume ps. Maiothere forbenefit of?callback options.lof leftoverz that we skipped whilr If allow_in pe2V, thiRlways emptyoVx4#ofsaccumulat @. Also m~xasLpBecauseu'ZA', 'r''' attributes,0onPSrnot thread-safe.L,some pervMhEson,Y@needAmmand-linF simultaneously in diffey0s, Ltnstance2"""TRdard__B= []def __init__(selfusage=NoneW# bclass=ZIA?ionE conflict_handler="error"JadescrihN2for!add_help7O=TruOprogCCepil!):NContainer.}"&?_9, ', )?;Q.set_( 0 =  73 = = =  ,process_default_j + ifEhe,  = IndentedHelpF(1 (r K2 = 2Q# Pop ; Lial sources a/# 2e 'Z'Bnt, and (if applicable) the _add_version_option() and #$Fhelp!methods.&self._populate)b_list(V ,0]n= N%) >ninit_parsing_state() %def destroy(-%):<5""" Declare that you done with this OParser. Tcleans upJreference cycles so`> (and all objects 6Ed byL&it) can be garbage-collected promptly. After calling ),yM pis unus.Container.DTfor group in _.slI)E9del<,Esformatter# -- Private / -f`# (uses our or's constructorwL_cre$3Q = []w1 fmappingsD @ h$("-h", "--}" ac&/="' =_("showJ messagecx exit")<  <'-1*program's 9 number",  hGTrue"ifstandard6 TU.GXs.8p(ifP Xz By CN%if< =q# These0set@e_ar qconveni!of>Lbackr7u = Nones/.ldvalues5Simple modifierJ de0t_u?!, "if1 isg self.usage = _("%prog [options]") Relif *is SUPPRESS_USAGE:&-EselfTENone*# For backwards compatibility with Optik 1.3 and earlier.B.lower().starts=!("O: ")$G[7:]U/se1  .def enable_interspersed_args(y"""Set parsing to not stop on the first non-p, allowingmLfDBches+@comm%arguments. This is^Cdefault behavior. See also dis)&thclass docla q descri,0 ofv attribut9/E.""";.)v = TrueG ~ q. Use tBfyou have ap processor which runs another%EthatEBhas s(qits ownc`@want make sur4ese3Gdon't get confusedNGFalsOCset__,b_value#, Yh. 4$ =0bZ%,91t, f W)s[dest] =&M **P/gsK.update(&L_get_all_F1 = g_list[?for group in)sZDs.extend(#.Yqereturn%"ifk P# Old$e-5/u}V!."s)Y&:f.copy(;< [5 = UBget(F.5_0if isinstance(4[, strY-opt_str =w.m7ing.Qs3Rcheck]0 VT") RA# --1onGhmethods -J@add_option_group(self, *args, **kw C): !# XXX lots of overlap with OptionContainer.add_o%()@if isinstance(][0], strelsgroup =VG(\elif lenW) == 1 and not cH!if7, 7raise TypeError("|(an6 : %r" % Y"G"if.parser is -tDValuuyinvalidvr(wrong Q&)"pJelseUQParguments") .._s.append(ibreturn?sdef get&>Jopt_c1 = "a._shor;T.get(05 orP_longl 13if d5 $.c 1 RNone C# ---ing methods -JB_C , !if sys.argv[1:].a2[:][ # don't modify caller's list e_A=0, vs 5""">C : [string] = ,3# `1 : +@s = xB-> ($MhP the command-lineCs found in '' (default). Any e6s result>aJQ to '()', which3by \q printsusage mesto stderrs@bexit()"an=. On succesvs a pail:1) where 'O'|aw! (65allCyourA)CiR}U leftEa after\%s.$Ur@Felf.L#if7bE_(8q# StoreQhalveJH4 as attributeOr2# convenienceVbacksA# 6l@rest7the command-line (the "r" stands for # "remaining" or "right-hand")+Ylargs ^leftover arguments -- ie. what's ! after removingGoptions andSiLl "St"Ir `self.r1 = 94 = *[] values =  Etry: Pqstop = V_process_y(\,~,Ibexcept (BadOrError, V) as errve2(str(err))+breturnbcheck_(,sMIdef $*&"" 6Z1 : s9 : [string]3-> . CP thatG supplied `tfA5areIvalid. RsNEA(possibly adjusted, completely new.*eD5youDlike). Default i6aa. W passed-inBip; subcl`s may :@rideKdesired.4^     60,N +4NP command-linend populate 'G', consumafrom ' '. If 'allow_interspersed6' iMqfalse, <first non-jWtrue, accum5any:mCas in 'z'Rwhile)?4argB&[0%P# We 8 le bare "--" explicitly,yC" is-@d byaM0ard*pr since-a shortcase ensure@ Malen of9Bopt h@greafthan 1 !if`!==  2del# ; "elRo[0:2] W## 7 agle longZBwith6(s)4 self._process_long_opt(rargs, values) elif arg[:1] == "-" and len(arg) > 1:2=## d a cluster of short options (possibly withD (s) for the last one onlyvFselfms9allow_interspersed_lq.append Adel T9[0]NelseQ`return # stop now, leave this2 ina _R# Say!!is.original1ument list# [arg0, a1, ... S(i-1) +!FN-1)# ^(we are about to$vrg(i))., C The1 is7(i)%a *subset* ofKe] (anyPtheir5s will haveK beemoved from  while loopQusually consume 1 or mo #rgzper passd If it6s 1 (eg.n that takes noS'),t[ afParg()KdhuPsitua7 is=H 2 = w l 2# =` j?If cfalse,always b*empty* -- sta W, butnot a very /cestingF!def _matchgg,)H<"""'opt : string) -> X_DetermineU0ch W3ion,q 'opt' ses, ie.,&on  it6an unambiguous abbrevifor. Raises BadOvError i[nxdoesn'tN"ly d5"""a`(opt, A.P)jo(+,$vRarg =c.pop(0L^0# V explicitly attachedarg? Pretend it'm8nex#a`if "="6argrBr0) =.split("=", 1<.insert(0, :CVDhad__value = Tru3e Uelse:opt = arg had_explicit_value = False (: self._match_long_opt(opt)(bion = +%U[opt]%if option.takest*()tnargs =*Bif len(r(A) < " D'error(ngettext(H% "%Sion)su requires %(number)d>ument",F1sGb) % {"+ ":2, """:}{Belif^ == 16l.pop(0B 5X7Rtuples1[0:]@.Adel a$Ir E_("%does not 81 a "'*j = Nonpprocess,T!s,)Sdef _,`_short s(,8Rarg = pEstopk9Ui = 1for ch inxJ[1:])"-" + ch6H7;.ge.`i += 1 # we have consumed a character6 ot:ion#raise BadOE -V# Anycs left-? Pretend they're #C@next^a, and 8ing\ of&.Baif i <7arg_.insert(0,J?[i:<1W= Truu %+. -$3J (K,;@0%<4%s?<2@ l  # option doesn't take a value  = None F.process(opt,Ds, self)6if stop:Ktbbreak -# -- Feedback methods -Jdef get_prog_name(0elfAg isreturn os.path.baseIys.argv[0])Oelse?wekexpandF, s)A|s.replace("%"[.)kadescri X.=WAexitL, status=0, msg= ifHsys.stderr.write(msg9^XtCrroru3VA"""emsg : string:rPrint a usage mesincorporating 'msg' to P and .#If you override this in a subclass, it should not ^U-- itG aeitherc or raise an excey6""">p_(0D%(2, "%s: : %s\n" % F 6 <ep,kformatter. 0-~b)W&""P elf, file8""")#! :* ==outC;theE@for current 3ramb5 to'h' (defaulti. Any ocHQce ofX 5 inJ6aad with:FVD()Jp. Doesh pUemptyH or* defined C 5#()1qversion2 m dl7m"< o+q1s+isl')n dout). As with print_usage(), any occurrence of "%prog" in self.version is replaced by the ? t 1Uram'sHname. Does nothing ifQempty or undefined.C5""" ;:(Cget_(), file=!) 2def format_option_help;,ter=None)di50terT=w #d.storeqstrings)-result = [].append(a. _heading(_("OFs"))R&ter.indent(\Jlistz^Container>P  OF"\n"for group~Xs "0mat(+de(a# DropPlast , Rf no s return "".join(^[:-1]aepilog"M9. ]);[B z .*A() +~8JadescriP0_3VbAJ7ters:v !t7"""(! : = stdoutRP  an extended @ mes3 , 5all0andI21tex viEw|them, to 'p' (defa/s0ile2ys.E4a.write4()) # class Parser  _match_abbrev(s, wordmapT;""""2 : +B : {# :cS}) ->(R9,0key'q' which 's'an unambiguoui iaT. If,found to be ambi2guous or doesn't match any of 'words', raise BadOptionError. #1"""+# Is there an exacP?if s in QAmap:@return sFelseSolate all:s with s as a prefixKpossibilities = [mA for<~q.keys()s9 !if3p.startstE(s)]0H# NoC, sohad better be just one yvif len(ies) == 1# (&[0elif notf;iesD&(s zv# More thanle compleb: ambiG C [.sortuWAE]:(s,) # Some day,oPmightjm@ classes. As of Qk 1.36! #9erred way to instantil.Pons idirectly, via make_o(), # which will beca factory func%S whenGare % # \! =on r"""OS routines NT&Posix depending on what system we're on. This export-N`s fromk ixXnt, e.g. unlink, sta tc- os.path ei;Por nt 1 *Gname* 'p'gD'nt'&`curdir(Pa strrepresent the current _(always '.'p/paJ/paIJ0sep{(or a mostPmon) separator ('/&\\7extIextension 7(al6`alternvN]Vor '/v(w on=w@used$PATH etclgin text files ('\rn6r\n0defHdefault searchDexecutabletdevnull:o0 ofI `devicey@dev/ ',.) ProgramPat im and use 'os'Dnd a`chance-`being 1 ween diffe:platform`Of courseZ0y mthen onlynitdefined byQ (z,{ o1r),Bleav Ymanipulaj$to KQsplit<join). """ #' import abc import sys tat as st from _collections_abc 4&_check_methods GenericAlias = type(list[int]) _namesys.builtin_module # Note: more 0 are added to __all__ later. = ["altsep", "curdir $pa Cpath Aline & @"def$=pdevnullSEEK_SET YCUR",I#0END#fsencode $de get_exec_ckfdopenJ!ex] def _exists(!):sareturn/ in globals()1f s_!(mt=2tryFJ&.c)jexcept AttributeError?[n for n4dirp if n[0] != '_']Any new dependencies of the os and/or changesW1 separator # requires updating0libwell. if 'posix'DuN$ = 1\n'A^! * D%t)dQ0.ap!(''`I ]ApassE0as   have_fun3v&wextend(_h)Adel @ el/nt"ntor/nt "`~9 nts[{"n'nt"ntD"Belsegraise @('nogspecificpfound') `s['os.B'] =p(}", {, w#, _", ", ;a"l  *"_"_' =2add(str, fn0Qif (f>)i + k:>P_set.Y=0[fnr = set(_)"HAVE_FACCESSA; "access"&RCHMOD% "chmod%6OWN%?own%CSTAT$ "stat") _add("HAVE_FUTIMESAT", "utime") %BLINK" "link$TMKDIR%o"mkdir%CFIFO&"mkfifo&3NOD%~ "mknod%DOPEN$n "open$EREAD_"readcRENAMEN_"rena5SYMM_ "symM&UN&O "un&/rm/Nsupports_dir_fd = _set set = set(dFACCESRcaccess8Seffective_idsZPCHDIRF$/chfFCHMOD%mfFCHOWN%/ow FDr_"listq 'Oscan'bEXECVEte"execv@set.0stat) # f always worksv$TqTRUNCATP"truncatP(w|$FPATHCONF'"pathconfif _exists("vfs") and: # mac os x10.3 FSTATVFS", Q)D3# Some platforms don't f lchmod(). Often the function  # anyway, as a stub thatreturns ENOSUP or perhaps EOPNOTSUPP.Jc(No, Iknow whyN'\good design.) ./igure will detectLAthisreject it--so L+0 st6wbe defined on suchH!@. TTis Very Helpful.However, somesbwithout a5ingf *do* haveHf!at (Examples: Linux kernel 3.2 T glibc 2.15,@OpenIndiana 3.x/FAnd W! hAflagaoretically make|p# it beU likeq. So i0ory'would beduitablreplacement forEBut whenP does,'& *either*IadlyiN`sophis3ted'enough to< tPcondi--it only`rminesk"non# fchmodat() minimally works. # Therefore we simply ign fchmodat() when decidingther or notI1os.0 supports follow_symlinks. Just checkGl0S() isDsufficient. After all--if you have a@,rEW@almopdertainJ too _add("HAVE_FCHMODAT", "!")X %6OWN%?own%CSTAT$n "stat$LCHFLAGSn_flags'1MOD% if _exists("lch: # mac os x10.3LCHOWN",5%!4INK "RUTIME "utime%F$n+l"NS&mMS_WINDOW m_ = _set 2del- p_functiongglobaladd # Python uses fixed valu or the SEEK_ constants; y are mapped # to native' if necessary in posixmodule.c # Orpossiblfz\`directm{ed fromFSET = 0 rCUR = 1 pEND = 2bSuper Uory utilities. # (Inspired by Eric Raymond doc strings oshis) def makedirs(name, mode=0o777, e_ok=False):9"""3( [5,][7"])-mkdir; creat[Gleaf0and intermedi&0oneWLQ likeJmcept that an:path segment (not jPrightnswill bedpit doesr @. If@x targetalready5s, raise an OSErrorSq_ok is T.Jw+Pno ex4ionEd. This6recursive.V1"""vhead, tail = a.split!ot#v77  _ Je s("V6tryc1)0istX?2_okk*` FileE~s< N# Defeats rac di1'Qn ano th.j2pasU cdir = curdiaif isi?0ce(w, bytes cdir = bytes(curdir, 'ASCII') if tail == cdir: # xxx/newdir/. exists ifN7areturnAtry: mkdir(name, modeexcept OSError.'# Cannot rely on checking for EEXIST, since the operat esystemw# could give priority to other ews like EACCES `EROFSC0if 0_ok!tpath.is)raise def removedirs)<""" sSuper-rmdir;< a leaf directory and all empty intermediateDones. WorkP oPthat,; Z!isBsuccessfully%d,ies correspondwto rightmost Fegments will buned away until eiQwhole= consumedt"an` occur4Qs durhis latter phase arignored --,y generaPmean % aRy was].1"""HShead,Dg.split"?g#7`while  ? Zo/(.> \Qbreak8)s(old, new 1e; created@eedadelete any left S,Zaion of; 5t`needed2mak:1new good is FQmptedfirst. Af\r\E$ s ofQ old y  B  A non+bySfoundpNote: t%Pfunct3Pcan fAwithy structure madLf you lack permissions ZaunlinkN [!orCfileVii4*if sdv^\}2old6 }cW@c pass __all__.extend(["7", +53s"]walk(top, topdown=True, onerror-=None, followlinks=False): """Directory tree generator. "For each d(gin the9 rooted at top (includingJitself, but ex'.' and '..'), yields a 3-tupledirpath,xnames, file &" i@qstring,81 to %. J2qlist ofZ1 of74sub:`ies in=X(.I dS `Dnon-ayeLpNote thb2he ?s are just, with no componentsNTo get a full#(which begins>@top);a0 or0!inw, do os.me.join()P If optional arg 'topdown'!@truednot specifiedtriple for awsed befor'"e 3s4 nyJits LMF ed `). IffHK%Qafter #llB  bottom up]HWhenPcaller can modify0dir s @ in-place(e.g., via delslice assignment),pwalk winly recurse inqM DwhoscremainQa; thisQbe usQ prunQ`earch,`to impQa4pc orderUvisiting. M2whe@ has:effect oqbehavioY0os.(), sincK' have already been1timW14. No matJ0val5 ~is retriev/p.y1its L ,By default errors frompos.scandir() qignoredae !!onG!it shoul ncWA; itE!beg"ed0oneuu@ OSE instancet{Careport continueQ)AraiseGTto abI.:. &availablk{C!attribute~2exck object. By defauvlt, os.walk does not follow symbolic links to subdirectories on systems that support them. In order to get this functionality, seL"op argument ''atrue. .0Cau/: if you pass a relative pathname fop, don't change thv@currlworking y between resumPs of 0!. a neverVsW SK, and assume#a$@ cliz|1n'tGceitherExample:0imp]!os)@from Pjoin,k2sizProot,s, files in:('python/Lib/email'):` print(@A"con", end="")(psum(get|(9!)) })HA"bytt", len(.U"non-Sif 'CVS'aFdirs.remove('C) #visit CVS%t1"""sys.audit("2a", topdown, onerror,B#return _q fs_(top)=C def7lQ = []:non_%# We mayhave read permissionin which case we ca#yp a list'2thecontains. palways Earessed9Aexce|Pn, ra!p0n b!upaFPminor soen (say) a thousHable are stillH@leftr@. Tlogic is copied here.12trymP# Notb`at sca5`globalt @moduu9to earlier"-*aLT_it =YJ*@ OSEA as $ifFNone c(;rDwith~6_it@while TruT Nentry = next(%StopItera Ybreak<,?4,<D is1 = .( YT# If : raises an OSError, consider that the entry is not  # a directory, same behaviouDn os.path.isdir().Dis_dir = False 2if :dirs.append(i.name)(Nelse:?non= > if topdown and# Bottom-up: recurse into sub-"but exclude symlinks tox#Wies if follow0#is,* (,Qwalk_m= True{5;?tryT3is_" =5.(0except OSError\1# I a() raises an=Z, con s# a`bolic `L>t 0notu 85if /@)P# Yield before0ionwPgoing  ifqyA@top,3s, da?# R1iesY' isE, join = . .0forp0 in sO@new_7! =R(2 # Issue #23605: ()-used instead of cachingr\  result durNhe loop o0sca() becaus#caller can replaceYa""Zabove 41 ort(@)W`p from _d,,P, one,w ew_ +_afterb5 up`u`t__all__"") if {open, stat} <= support1_fds{ '2fd:bPdef fYE="."==None, *s=False, dir_fd=None): """Directory tree generator. &2This behaves exactly like walk(), except that it yields a 4-tupleKxdirpath, dirnames, file Vdirfd1`.0`, %u` and `5` are identical to output,8b0` iD descriptor referringE0the`e advantage of fT over$is's safe against symlinkraces (when follow_#sgFalse) If0_fd@not ,should be a]@opena=" \Ftop Crelative; `will t4be PdO.c (diralways supported for6&.)vCautionRSince($()` s, thoseonly valid unti0nexion step, so youPdup()Am if@wantAkeepOa longer periodExample: im9 osBAroot0s, Rn os.['python/Lib/email'^`print(:, "consumes", end="")s,sum(os.stat(`-Efd).st_size!1 inU(s)8Qi"bytes in", len(s), "non-9[ if 'CVS'{Fdirss.remove(+) # don't visit CVS&ie}5"""sys.audit("s ",down, onerror,8d0if  isance(top, int) orrhasattr'__index__y@= fs,d# Note: To guard] U, we use standard1# l )/B()/ff trick  orig_st =gt )=/=topfd = 1O_RDONLY3*ryKif (r(st.S_ISDIR(Pmode)R .s2G,[fd)))Kr from _Y,, $+`L?topinks) finally: close(topfd) def _fwalk, toppath, isbytesdown, onerror, follow_symlinks)f6# Note: This uses O(depth of the directory tree) file descriptors: if4# necessary, it can be adapted to only require O(1) FDs, see issue G# #13734.scandir_it = )dirs = [] no5 `entriepNone ifG5< or.X elseR@for ADy in6_itUbname =(. $if 6- = fsencode("+tr(#ifmwis_dir(!.appendZ&M#pis not (04iesYy*ID@except OSEEt# Add dangling p, ignorsAaredsBDy.isFa/% $Fpass @yiel^ #, &fdE`*@zip(!,X(ie7s!if. q =aorig_s1tat,A_fd= n=False}Rdassert 3I @y = +n0y.s (dirfd = openO_RDONLY b~ as err$if*(SJ(errlvcontinu' yQ.same1!, )<0 = P.join ,8DfromTfS<TG0topEzI finally:  close(dirfd) if not topdown: Pyieldpath, dirs, non RtopfdI __all__.append("fwalk") def execl(file, *args)f>"""PExecute the?putable D with argument lists, replacing7@curr%process. """xve S, envJ B andanviron;env Anv =B[-1]KDxecvT[:-1]p (which is searched for along $PATH)^p   , v& l n may be aor tuple of string_  v ,y! N  !,0ext["",e p vSvpe"]piS=None iffq_func =!veargrest = (WHOelseCB>\eZev0if r.dirnam!21xec8Tareturn}saved_ex^_Q= get:_(Deame != 'nt'= fsencodV7EZmap(fsencode, p ath_list) for dir in p:ullname =.join(dir, fileB(6try5exec_func(fC, *argrey&cept (FileNotFoundError, NotADirectoryj) as eglast_exc = e!exV!OS76if savedSkis Nonq&#v 8;not<Vraise] def ge0ec_P(env=) """Returns the sequence of, ieat will b%aarched"th' d 'utable (similar to a shell) when launching a process. *env* musthan environment variZqdict orb. If 8_,K3os.=Qused.1""" # Use a local import insteadfa globto limit,number ofK modules loaded at startup:/2os " is alway+3 byNPython. It may also avoid a bootstrap issuewarningsQ ifCrq0env^+# {b'PATH': ...}.get(r) and { 00) eabBytesW usp0 -b b: ignore%JSwith s.catch_(.simplefilter("V8", )7 a5 AType RBpm up_0s_b _ A Vb[w]&2(Ke%, ,*Jpass?/ls!if>is M~BValu(b&"0canPcontain ^jf keys":g bm$` isUance(@!, , = fsdecod8R pf` = defr{da.splitsep) # Change Nutomatically  putenv(Bunse from _collections_abcMMapping, class _E(("def __init__ (self, data, encodekey, de Tvalue C): E.(Vkey =J #V& =b #FaH 'JL '_!Aata def __getitem__7key6tryZ1 = T[ @key(A]a0except KeyErrorMu# raise with the original EtRV 7s from None*breturn&(P)s", ' q2$r`putenvfCMXbkey] =?delwdAunse2) 2delI4kCiter# list()dict object is an atomic operationQbkeys =>"1for ins'=Ryield0y>len1len.o ?rep8'environ({{{}}})'.format(', '.join(('{!r}: , ,O# i}.Ws()))Acopy5setdefault,{mA ifD not [^{!zD__ioww, otherr1.update(fSNM"ifsinstancS, MappingxNotImplemented0new"ic2?new 8newr` Kqd dcreate 1X ame == 'nt': # Where Env Var Names Must Be UPPERCASE def check_str(value):%if not isinstance&[, str+/raise TypeError("str expected,K%s" % typK).__name__)zqreturn encode =#de7str"f 4{key(keye# v.upper(data = {}Ufor key, in environ.items(dA[b2] ==TFelsevl# Wher0CanMixed Case:sZing = sys.getfilesysteme s.!e(ing, 'surrogateescape'2ef H.(X%cekey =Dtg"_E (#,L, ) # uniW p = _cree[) del0 `getenv[fault=Non"""Get ament variable, 2 if it doesn't exist. The optional second arguLcan specifygalternate deCH and the result aregA."""or ) supports_bytes_*@ = (b != 'nt') __all__.extend((".O", "C")) if Rdef _N \/  J%L 6 H## LF+bd*._,Kl~4|b@2I0G 2Tb' 1*"dn fs(c(): encoding = sys.getfilesystemencoding() errors)e 1() .adef fsC e(Taname):N@"""E`$e  (an os.PathLike, bytes, or str) to th0Mg ing with 'surrogateescape' handler, return_ unchanged.OOn Windows, use 'strictH5 if=Etem %isN'mbcs' (which is5udefault1)~5"""<= fspathK # Does type-checkDof `6`Uif isinstanc,YD.!e(Bing,Ms1OelseC Vdecod DAfromN27str5 Ont .X'B, fs[$ ;` = _fs>uc() del8 # Supply spawn*() (probably only for Unix) if _exists("fork") and notFv.execv"):P_WAIT = 0#CP_NO RO = 1-__all__.extend([">D", ". 3O"]F# XXX Should we support P_DETACH? Iqse it c)Q()**2#Qclose-pstd I/Oeams. Also, P_OVERLAYDsameB!s B*()?_)ef(mode,, args, env, funcL# Internal helper;"pb6@tion"us!ifk(tuple, list)o4raise TypeE('argv must be a ;ba?'nc 1not;[0]bIValucfirst elGPt canAbe emptygPpid =kg|:pidlq# Child(:try% ifY;Non  func(file, akrgs) ]else:%func(file, args, env@nexcept>_exit(127/g# Parent|if mode == P_NOWAIT_ return pid # Caller is responsible for waiting!a~while 1Uwpid, sts =:Apid(0if WIFSTOPPED(sts)P(continue status_to6AcodeR4def spawnv(&, t?"""% -> integer ExecuteEP withuments froms in a subprocess. I 1the1of 3 1&0's ( a if its normally; otherwise?-SIG, where SIGx signal that killed it. """zr5_)-efP, None, execv)e0+/the specified@iron3enves# Note:-p[e] isn't curfly supported on Windowspg&`(whichalookedalong $PATH)7arg rp pa,QOupplbif it exits @normally; otherwise return -SIG, where SIG is the signal that killed it. """ A_spawnvef(mode, file, args, env, execvpe) 9__all__.extend(["@3", e p 0e"]Cif _exists(01"):Y # These aren't supplied bybasic Windows code6but can be easily implemented in PythonAdef l*"""& -> integer Execute6P with:u|`s fromsa subprocess. If n == P_NOWAITapid of3 1Yq's exita if it/s AIOvON qe#r')x/Ethe ]penvironQenv =wA[-1]$ dR[:-1]h llp!At moa,@doesavp[e],@# so wo(Bhave#l#0 ei.*pa'\`(whichWlooked for along $PATH)U7arg S )~ g j)p(ess's exit cPode if it exits normally; otherwise return -SIG, where SIG is the signal that killed it. """ env = args[-1]  Xspawnvpe(mode, file,-:-1], env) 6__all__.extend(["<Tlp", e"]) # VxWorks ha0 user space shell provided. As a result, running # command in a4can't be supported. if sys.platform != 'vxw|!':# Supply os.popen()Bdef Pcmd, ="r", buffering=-1)D3if not isinstance(87str%) raTypeError("invalid cmd type (%s, expected stmA)" %W)N!if|1n (?"w"uLValuv0 %r_ Z == 0 or`FNonegCP) doet2 un^Weams"|m subprocess, iofj== "r"0' =:!.PAE=True, text ;ftdout=o.PIPE,<bufsize=6ing _wrap_close(!.ss,0c2;els-h/in]$in# Helper for`) -- a:!xyaq whose d0 wav40the+Qgclass :__init__(self,3eam*!._stream c"jg 7Y.&"XTcd"= .^.'#if.:= 0$O 0ameC3'ntv9a ?8-<< 8 # Shift left to match old behavior]=s__enter Ad 5x*: ;4 tqdgetattsi, name> return get attr(self._stream, name) def __iter__)%):#preturn !H!) '__all__.append("popen") # Supply os.fd0() m fd, mode="r", buffering=-1, encod None, *args, **kw if not isinstance(S3int *aise TypeError("invalid fd type (%s, expected integer)" %B(fd)*import iobif "b"n4 = io.text_( TZ!o.   c0For testing purposes, make sure the function is available when C # implementa)qexists._fspath(YB"""R@u represAPof a -like object.1If str or bytesApass~0, i ed unchanged. Otherw1theos.PathLcPrfacePuNato get @. IfI G^,Ir\dIqrovided$C,,Q1"""(ifc, (strR)$j# Work from!'s to match method resolu@of ona magic#'!s.e_A=N6try (! =4#._U'__8except AttributJaif hasU}6, 'K' FelseM%("_ B", F"9" +u"___$) ({}p)_  {}".format,  AB).__B)2rKno CvPython vers as transparently as possible. D_"('K3 = B = "" class (abc.ABC):"""Abstract base /6forfile systemH protocol.@_aQdef __fspath__(self): !"""Return the file system path representation of'object."""H raise NotImplementedError #@classmethoddef __subhook__(cls, if cls is PathLikerr_check_f$s(Ip, '__fsA__')6 !___getitem__ = \(GenericAlias) if name == 'nt'1 _AddedDllDirectoryRinit_,v, cookie, remove_dll_d?D.! ==_NW"h/ =>\closeSyW..5INonek __Tr)   5x][*args;4. __p1if 8-"<({!r})>".format E{A 2)>":add(L"""Add a1 toDLL search.PxHThisrused when resolving dependencies for importeJ`extens3modules (` 0 it>^Ted through}%),and also by ctypesR"")0all" o2ed 5 org us0it in a with stat.&5 ntjOnt._-!(#K f qoK#) ufnmatchunctools$io nt|o"Xposix$re%%sy&warnings from _collecFSs_abc3 Sequence&TerrnoEINVAL, ENOENTTDIR, EBADF, ELOOP8eoperat attrgetter WAS_ISG PLNK, 2REG 3SOC#BL 2CHRBFIFOQurllib.parseY`quote__bytes as url __allU[P"Pure2", brWindows41ath0,(] # # Interna6ls # _WINERROR_NOT_READY = 21 # drive exists but is not accessible ?INVALID_NAME = 123Cfix for bpo-35306qCANT_RESOLVE_FILE;9>broken symlink pointing to itself # EBADF - guard against macOS `stat` throw9, _IGNORED_S = (ENOENT, ENOTDIR,U, ELOOP) 2,6V ?, ) def _ignore_error(exception):`return (getatt , 'errno', None) in !orCC1winxF$) s_wildcard_pattern(pat# Whether this ! needs actual match us!fn, or can# be looked up directly as a file.'0"*"0patD)"?[ class _Flavour(objecb"""A f implementpparticular (platform-specific) set ofhsemantics.""" _init__(..join = 1sep;`parse_s>!, E"ad = []qYpSUaltsedrv = root = ''ireversed(~"it!ifG  co%ueJ2if 0F! =.replace(,i, sep)HAdrv,U, rel @plit 2 ifF>rel~xPrel.sQ(~if x and x != '.'Z+.append(sys.in`*x)NelseG!ifln j;rell0if !orMv)>drv0# Ibresent, tryfind one[the previousJ#@s. T_`makes 5SresulrW2e.g%7# ("C:", "/a") reasonably intuitivb9  seconds iu la`1 torUfirstA y*se":# Svnon-anchored (common w  class _WindowsFlavour(_ 3# Reference for .(ps can bRund a 6# http://msdn.microsoft.com/en-us/library/aa365247%28v=vs.85%29.aspx sep = '\\'3alt/@has_MR= Tru 2mod = nt is_supporCp= (os.n== 'nt')& _letters)t('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'@ext_gspace_prefix0\\?Brved+A = ({'CON', 'PR0AUX0NULcCONIN$ OUT$'} |<M%s' % cc in '123456789\xb[2\xb39?LPT9pD# Interesting findings about extendees 0# *p?\c:\a'z*an), which bypasses normal1API1#  processing. ThuQs areresolvedPslash$no transla6qto back'. It hasn'"NT}limit of 32767`characY, but a bit less after 5device symbolic links,Jsuch as '\??\C:'1'\D5\HarddiskVolume2'd/a' looks#a mPd 'C: because slash is a  # regular name character in the object&space. # * '\\?\c:\foo/bar' is invalid because '/`llegalTNT filesystemsN0 Tlnly path separator at4` levelmbackslashF* '//?/c:\a' and/ re effectively equivalent to.)#nd thus limited'MAX_PATHqPPrior Windows 8, ANSI API bytes_s areJ,leven with]' prefix. & def splitroot(self, part,/a=sep):(qfirst = U[0:1]dsecond61:2Dif (=UEKbf# XXX extendedshould also disablecollapsing of "."Kcomponents (accord+to MSDN docs)x/ Alf._!__N(%)nY #Felsef-U = ''cEthirc?2:3ctA!p#Qa UNCp ?# v 2F\\machine\mountpoint\directory\etc\..q.=+) ^ gSindexl.find(sep, 22if )Z!= -1l2GJ + 1O3&# # can't have two 4ei a row=0(afpinitial:gC2 !=/+ V,=%?len##if1creturn'$ +a]8?[6+1:AgRart[:J] Qdrv = :4if ~B= ':0in .drive_lettersV[B+[2`!= v3if  jQ" =!2 hp.lstrip:,q + drv,pcasefol2s{Ds.lower()5_s$? return [p.(lower() for p in parts] def compile_pattern(self, !):(,return re.2(fnmatch.translate(6,'IGNORECASE).full-x_split_extendedh}s, ext_prefix= namespace&U = ''pif s.stPwith(C(9 = s[:4]@s*4: Z{'UNC\\'W@[+\3F `'\\' + s[3gi@6, s3is_reserved*}# NOTE: the rules5 G seem somewhatulicated# (e.g. r"..\NUL" is Fbut not r"foo f `" doesKexist). We err onside of caution and ATrueWpathsJwhich areb@ conE re9 by Windows.8!if/+pXFalse/+8[0]C>'\\P# UNC,"hsEever)Sl" =P[-1].ziP('.'):rstrip(' ')bPA.upp0in ._Nmake_uriK)thJTUnderO, file URIs useUTF-8 encodingqQdrive1th. qif len(a) == 20[1]:':'# It's ah?a local 6P => ':///c:/a/by$stas_posix()[2:].lJ/J3W%s/%s' % (' , urlquote_from_bytes(rest.e('utf-8'))Oelse~networkhost/share`\. class _P2Flavour(_ *0sepz/s3althas_drv = cx0modXis_supporte@(os. != 'nt')&9Erootrt, sep=sep!ifZbG![0a:sepxpr+$rtR p# Accor to POSIXQresol _# http://pubs.opengroup.org/online/009695399/basedefs/xbd_chap04.html#tag_04_11!"A/that begins with two successive slashes may be 0# interpreted in an implementation-defined manner, although morMAthan~uleading{shall be treakas a singl)".if len(part) - stripped_Y== 2:4return '', sep * 2, 9 2OelseD @<| odef casefold(self, s)x8s-s3P7;ompile_pattern<uBre.c2(fnmatch.translate(Dq)).fulliis_reservecVFalse8make_urih4# We rep[nt the path u,local filesystem encom,l# for portability to other applicsrbdp= bytes%h)MrRr://' + urlquote_from_5C ) _windows_flavour = _WF() _posix#P! class _A"or/s"""An aNicular ( -specific or not) way ofEAs on_>U.""" dNormal("):stat = os. open = io. `listdi3os. Escan Rchmod] %mk. bunlink- if hasattr(os, "&"y6 " src, dstC{raise NotIFedError("@nk() availabley2is v"")%rm Renamer Eplac  0symV  , target_is_directory=^"Stouch , mode=0o666, exist_ok=True%ifW# First tr3@bumpQC3L tim"note: GNU Q usesYUTIME_NOW opYx#&ubnsat() / fp() func761try  os.utime(path, None) except OSError:'# Avoid (ion chaining+IpassNelseRereturn)pflags =O_CREAT | eWRONLY)if not exist_okYF|GEEXCL8"fd^Copen.W, modos.close(fd) > if hasattr(os, "readlink")}d? Ddef p(self, Koraise NotImplementedU("os.@)  available on this system"s_ownerp6try}import pwd.getpwuidQQ.statR).st_uid).pw_name@7! IZ sRPath.) is unsup/edQgroup `5grp0grp?grgg/gr;Sgetcw expanduser = icmethod(os.u."+@real1 ) _normal_accessoe!_NA(' # # Globbing helpers # _make_selectorDtern_parts, flavourPpat =,#1[0]Rchild6 #"1:$ if< == '**'~ clv_RecursiveWildcardSaAelif80 inG?QValue("Invalid':8can only be an entire$h component"mS_is_w@_patK  s*yPrecise0cls^', K' functool lru_cache  5 = ..,:()('&tclass _aT"""A  matches a specific globE 6 against the"redof a giveRh."""&s_init__1y.$" =k1'(if?C#su(: = (^:B1dirUW= Trunlse:  self.successor = _TerminatingSelector() 4dironly = False "0defRect_from(*, parent_path):(M """Iterate over all child )gs of `:` matched by thisIs. This can contain{0 itE.""";j_cls = type(pPis_di..FPexistD!!DscanC 3._av. 0rif not g ?Creturn iter([]_,_", #, ) class : Zl `1yie{uPrecise_ )s_init__hRname,D_parts, flavourw.*0 = ub*._W Q96tryH( =r._make_0rel">Bif (;! i$f.Celse )(D;for p in.<Qqexcept PpssionError Wildcard(?patb$ =6.compile@tern2kz0oDwith /4 as:_it[`entrieSlist(6_it'+y >iesM m!K 0# "^ya1()"\raise(G=#some cases (see bpo-38894), which isdFamong the ers ignor_ _  /Oinue3!OS+eN} e):  lraise ~continu!name = entry. Cif self.match(#-):%hpath = parent_._make_child_relBAfor p inpsuccessor._select_from(D , is_dir, exists, scandiruyield pyexcept PermissionErrorreturn class _RecursiveWildcardSDor(_ 1): cdef __init__(@r, pat, 0parhflavouH.=8kpiterateectoriesw80 ::tryDwithr(D) as:_it5Jfies = list(E_it)m'+y  ?iesM"y_ o = Fal `W>.M(.-!OS%e)if not _ignore_eT/(e"if1andXsymlink(Z%O _djW GgoHX\ ed = set -:5lf. ;Zstarting_point.g@cI(y0Aif p3in ;5%~$ed.add(pkfinall<4WclearW # # Public API #QPathPs(Sequenc """This object provides s'q-like a to the logical ancestors@of ah. Don't try3construct it yourself."""  __slots__ = ('_pathcls', '_drvAroot parts') def __init__(self, =!):"# We don't store the instance to avoid refereecycles@U. = type(d #Qdrv =~.  !3len2if {#or ]return len#rts) - 1Oelse6sgetitemZ, idx$isj(idx, slice#Qtuple[i] for i in range(*idx.indices(3)))G if5 >= ) Eedx < -4 aise IndexError)8dcls._from_parsed!ts,,Ghrts[:-idx]CreprnF"<{}.parents>".format_name__) class PurePath(objectW"""Base $manipulatings without I/O.M es a filesystem9 and offers operations which5imply any actualGr Dependon your f{z"tiac will 4seither @osix 9arWindows%. You can alsoOk#e R ofiBPdirectly, regardless of.w1""" I#1str/Ahash pU cached_cY hnew__(cls, *argsZ"""Construct8@ath @ one<several strings`r exis?pL^Wys. The7 s are combined so ato yield aonicalizedr,] is incorporated into6new(v `if clsQ Y=K>`if os. == 'nt' x(P} u1ts(oNduce@# Us d helps shNPinterNh&# when picklH1rel6+si_22__,mY@#method def _parse_args(cls, C): 2# This is useful when you don't want to create an instance, just H # canonicalize some constructorxuuments.|parts = []f*0 in/seTif is}(a, PurePath(ZP+= a.%tsaJelse\a = os.fspath(a)3! ?str|+ # Force-cast str subclassesM(issue #21127mF.append(str(a))?raise TypeError(%A"arg should be apobject nooLike "M4returningI, not %r7i% typeB cls._flavour.(!) @^amethoddBfrompWe needHcall.w on theAso a0geth@# right @selfVF.__new__drv, root, 0 = 6 U._drv = drvK! =R _etJ8sedQ R #_Pormat ifj_ ;A+w* +BjoinF[1:]K >make_child(E  V2 6D,* s,D  E  a_str__~A"""Rrepresentation of, suitable for@pass9to system &Fs.""?try&stNexcept Attribut <5f& l   self._parts) or '.' 3rreturn 'Astr def __fspath__(!):<4"tr4as_posix2B"""Rithe string representation of s with forward (/){slashes."""3f =uflavour .replace(f.sep, '/')~__bytes %. This is only commended to use under Unixos.fsencodeP=:"{}({!r})".format@.__class__.__name__,9)aas_uri: as a 'file' URIbif notfis_absolute(RR aise ValueError("relative ccan't be ex4Ased vut""#._V.makeH@propertc( # Cached casefol),P hashand comparison6try cZ_y4except Attribut F? . k (3_eqpw, otherisinstance(", PurePath,qNotImplementedkj2 ==u.+ n"p 46! =R(tupl) :#ltq! $ U<< e Wgf._cparts > other._cparts def __ge__(self, $!):!if not isinstance(", PurePath) or <._flavour is4)SWreturn NotImplementeduV2 >= class_getitem__(cls, typeT$clrive = property(attrgetter('_drv'),doc="""The dEprefix (l>PUNC p, if any.""")sOrootxyx'q of thehg@aanchorconcatenation[@and q, ''TT# =Sdrv + 3(~/OnameQfinal componentiqif len(p) == (1s.u) else 0-%''XXO[-1]asuffixoT5"""JT's last =dThis includesleading period. For exaiv: '.txt~; @i = .rfind('.')f 0 < i <]'_) - 1E[i:]>b*"''& /esH dA listRDO4esePOsP['.tar', '.gz'YfXendswith[[ZEalstrip7T@['.'u f "inuQsplit;O[1:]?temlminus it 6k i;&:i5i$_,) RRa new4)Afile2 changedJ aise ValueError("%r has an emptyYB" % )Cdrv,our.parse_parts((name,)) if (not 1 or [-1] in [self._flavour.sep, ualtsep]NU`or drvL@rootlen(parts) != 1):0 raise ValueError("Invalidq %r" % dreturnrom_parsed2ts(4drv,w> [: 0+ [ 1]) Cdef with_steml , B"""Ra new path4A the- changed."""Vbw(\" +msuffix Rfile WA Ifchas no,, add given.6 is an emptyJstring, removejAfromz.1%2f = &@if fPRor f.F and iQ JhT0.stP('.') == '.')+ k 0%r Dold_ u( {! =`<Oelse/0[:-PY.)]BH_SYrelative_too*other1*Qto an1identified byEssed3argumentsoperationpossible (becausx#isJ@ sub}" o<), R# ForburposeLis method, drive) are consider# separate f, i.e.# Path('c:/').Eva'c:') s%&/'; /: #0if P4Typneed at least one "%tslK5drv7 0if  abs_parts = [drv, root] + c[1:] Uelse:Aabs_(" =01to_N0to_QE, to*Pself.se_args(other)< if.7 n8to_qf J6n = len((Rcf = flavour.casefold%tsH@if ( or drv) if n == 0 ME cf([:n]) != x formattedz#se!raise ValueError("{!r} is not in the subpath of "B" OR one +is relative andG[absolute.JR" .P(str(n0), Vted))dreturn:rom"''1?'', Qn:]) 7tdef is_1_to1, *)B"""R@TrueZ ,Qto an<Hor False.o&""66tryb&.>%+gexcept  X3@propertyC An object providing sequence-like access to'Pcomponentsfilesystem. # We cacheE` tupleRavoid builyQa neweach time .x#ed. XXX theEary?/ ,*_p\gAttributt k8" =V1&ts%m@joinb?0, *k `Combin3!isT0 wi neseveral argum,tahSh represent ei% a?g(if alOE are'NJ s)a totally differentJk!of& izanchored);rnmake_child($C__truediv__F7keyD XW(key, ?TypNotImple}(edr)from_parts([key] + self._parts) except TypeError:!return NotImplemented #@propertydef parent(g)G"""The logical% of the path."""DqSdrv =5drvEroot qif len() == 1 and (f0or HF`._fromD0sed tsM,K,ts[:-1])% s&A sequence!is+'s<s1a_PathP\is_absolutewfTrue iD is / (has both a?,.applicable,(a drive)cif notqpUFalseI8flavour.has_Abool.oreserved B"""R contains one special names U!bybsystem)nyM$._4is_KYQmatchRth_pattern/C 9 H!esPgivenPI.<{%cfFcasefold0h = cf(V6drvt) ^Rparse(H&,)J@#paF ?aise Valut("empty"H:!7drv[S %if DE c^0if  G) != -K =(E[1:].eln>m-1for in zip(reversed',  E!fn.E_ 3 # Can't subclass os.DPLike P PureQ keepI constructor # optimizations5se_args(). ^.register(-B) @osixy 1""" 6athinon-Windows !s. On a POSIX Fsystem, instantiating a PurePath should return this object. However, you can alsoNe it directly on any uA1"""I_flavour = _posix_slots__ = () classpWindows(!):64"""B sub4Cfor 41s. /KOn a|w b# Filedp-access&es<?ath1Pthat Cmake3T call8{ represents a f pEbut unlike1!, *aoffersmethods to doh8Hzs. Depend@on y7,J Dwill`eitherj oIpO. Yo8a PB@ icannotpsta POSIXor vice versa1o2tnormal__4def __new__(cls, *arg0*kw 9+if cls is Q=+ if os.name == 'nt' else<`self =\._from_parts(~%0if +,..is_supported raise NotImplementedError("u %rj6 % 50.__U__,)) Mj2_child_rel(" , l0# TY is an optimization used dir walking. `A` must be@# a !leb relativeTGE@s = .@ + []T2sed0c._drv,GBroot's) _1r__1_ .3xit-, t, v, tb7# https://bugs.python.org/issue39682# In previousLqions ofBlib,r marked1" a3# closed;Qsequent attemptperform I/O w;Qan IO@funcality was nTR docu, and hae effect of mas mutable, contraryPEP 428. In Python 3.9 the 0# _closed attribute was removed, and this method made a no-op. FG # T$4__enter__()/__exit  should be deprecat{'nd{0 inv futurekQpass /# Public APIb@class#def cwd(cls):"""Returnew path pointing toxcurrent workdirectoryG((Hed by os.geto&))5"""2rv0cls._accessor8@home7puser's ? K (asp.expand<O('~'H"~")6) samefile(self, other_path0whe!'1 isH or not a0is Xg.9)(Pst = u.stat()R6try8<0 a 6except AS_ErrorHx \>2os.t1ame,$stT'stvqiterdiru iIterate overYsq&is%q. Doespyield anresult foDqspecialMQs '.';O'..' 8@namew Olist4if 5`{'.', a}[(0# Yae objecse makes little sensB cou D_child_rel(Aglob,Otern is subtree?lall exis9(ofkind, includies) matchthe given relativesys.audit("lib.Path.!",14$otZ raise Value@("UnUptabl: {!r}".format(pat9 drv, rootd_parts_flavour.parse(H&,)I`if drvUNNotImplemdLNon-Cs are unsupported"g1sel=A = _4d(tuple)Z.G4p1P.HQ_fromf]yield p def rglob(self, pattern): 0"""Recursively yield all existing files (of any kind, includingHdirectories) match<the given relative,Nwhere inFthis subtree.5""" sys.audit("pathlib.Path.:", 7drv, root_parts =2._flavour.parse#((/5,))Iif drv orNHOraise NotImplementedError("Non-s are unsupported"g1selO = _make_(("**",) + tuple)Qfor p inZ.RQ_from !p Habsolute-Bturn an % version of @. TPfunctQworksare(i0&h doesn't point to3tX.5No normalizaTis done, i.e.'.' and '..' will be kept alonghUse resolve()p@get canonicalha;# XXX untested yet! ifTf.is_+(y!reM7r# FIXMEKmust deferspecific 0 (aunder Windows,Muse nt._getfullWname(.$a ([._accessor.getcwd()] +()8R9, strict=False@AMakewR,Wsymlinks on-1wayEalso5@it (0exa fslashes into back?KG)check_eloop(@wine  = getattr(e, 'F', 01if e.errno == ELOOPv1_WINERROR_CANT_RESOLVE_FILENAMETsRuntimeSH   %r" % e.A:tryVA1reaR(0exc!OSZ as eZ Mhp2rom0((s$# In non-P modeQ)k[S_s# Ensure weqby callUFtat(cif not S:p.sAi 3%check_eloop(e)# return p def stat(self, *, follow_symlinks=True):-B5""" RKthe result of R) system call on this path, likeG3os.1Udoes.krk._accessor7 )Qownerlogin nameQfile C1tRgroup`,?gidFrAopen, mode='r', buffering=-1, encod UNone, errors= newline^0Ope !e Jpointed byS and a'object, as}hbuilt-in ) function Iif "b" not in| = io.text_( )RNK,9 NWread_bytesl1in 2 , C iUnd closeTPwith .-b') as fG f.f(W3 M%'P"Wwriteo, dataJ? to# type-check for rface before truncating'<view = memory ( NwO (NT_Ui[,0in airZ"ifwsinstanceW, strraise TypeE^ (' must be0,JU%s' %P9  data.__class__.__name__) encoding = io.text_( . with self.open(mode='w', += , errors=, newline=u) as f:return f.write(data) "def readlink():1"""$BRBthe path to which symbolic F points.;G<=_accessor.9._from_parts((F',)Qtouch!, ;0o666, exist_ok=TrueCreate this file bgiven W, if it doesn't_<der of argume($preverse+3os. ,,@hard ( @ A same file as *u* )u?+ e/a qis funcdoes not mgW%to@,Sdespi\bimplica5ands !s.order of% arguments (target, link) is the reverse of Path.sym _to, but `matche4 at-0os.(%. "*Deprecated since Python 3.10 and scheduled for removal in)%2.OUse `hardg_to()` instead%5"""1warnings. ("pathlib.Dd'isO" 5 %",oSBionW, stacklevel=2)8self._accessor(", )# Conveniefunctionsqueryingstat results;def existsY%):|Whether this 46tryG.|(except OSError as e5if not _ignore_e''(eZUraiseeturn FalqQValuet o# Non-encodableUrjFTruePois_dirPis a directoryX~qS_ISDIRqg.st_modepS#e doesn't0 ora broken  S# (see http://web.archive.org/20200623061726/*s://bitbucket)ppitrou/lib/issues/12/ SSqis_fileT regular ?p (also ^Ds pointingp8to 9/s)B1REGBxQmount): """  Check if this path is a POSIX mount point 0U """ # Need to exist and be a dir%if not self.'fs() oris_dir():3lreturn False :try'parent_dev =d.stat().s@except OSErrorKrZS0if $2!= zYETrue4inoW5ino!M(//!Qdef is_symlink(o|Whethersymbolic @.T: qS_ISLNKu&.lUmode)J Z as eEG_ignore_e'(eFraish0# Prdoesn'ty!l_Value.# Non-encodable<UPblock&1iceQ?s?ice#BLu ssbroken 1# (see http://web.archive.org/20200623061726/*s://bitbucket)ppitrou/lib/issues/12/ o[Ochar'>_acter&1CHRYkAfifoOFIFO return S_ISFIFO(self.stat().st_mode) except OSError as e:$if not _ignore_e':(e)%)Yraise;# Path doesn't exist or is a broken symlink8 (see http://web.archive.org/20200623061726/*s://bitbucket) pitrou/pathlib/issues/12/ e07FalQValue # Non-encodable e rUdef is_soE1"""%Whether thisY19.'3:tryASOCKouexpanduser " R8Ra newRwith 5ed ~ and ~? constructsB(as ed by os..@6A@if (P._drv:`_root)wfPparts [0][:1] == '~'8homedir =2accessor\6[0]@3if Cd:"~"'r Runtimq("CoulddetermineL directory."mKQfrom_#([3] +e[1:]) '> class Posix(e, Pure+0"""B sub5 for non-Windows systems.kOn a POSIX, instantiating!sh^bobjectT__slots__ = (){ ' ;vQmountX$NotImplemented(B.is_8)unsupported on ") #! /usr/bin/env python3 VQThe P Debugger Pdb = To use the d1in its sist form:>>> import pd3b `>>> pdb.run('') The debugger's prompt is '(Pdb) '. This will stop in the first function call in b. Alternatively, if  terminated with an unhandled exception, you c seost-mortem facility to inspectcontents of traceback:  < 9>W`import n3pm(^commands recognized byy are lis^qnext se\q. Mostbe abbrevi5as indic ; e.g., h(elp) means that 'help'@typed as 'h' or(but notea', norHHN:HELP'). Opal argu]senclosed in squbrackets. .q syntaxEPsepar by a vertical bar (|)d blank line repeatsNp)Dous Wpliteral` for '|', where itB1 11[Ts. CYt> doesn'tpassumedbe Python Qs and(Wexecu#xtgram being 3d. Rsalso be prefix^pexclamaV point ('!Tis a powerful waS?pro;5is even possiblechange variablesp*f8ps. WhenLQoccurHsuch1,*name is prin="'s*d.@ sups aliases 1ichKsave typing% hmeters (seeJ y entry) whS allows one a certain leveluadaptab under exa2ion. MultiplePs mayentered on?@inglbEne, O pair ';;'. NAtelligenc[b appli;1ingU s;Q inpu:split at&^,#if,amiddle@ quo0strm0 I-file ".pdbrc" existyour home directory^Wcurrent ,w0reaxtGhad been%or4mptPis paularly use6f.#. If both s i,#ad<!O` defin0canoverridden by the locBal file. This behavior can be disabled by passing the "readrc=False" argument toPdb constructor. Aside from aliases,*debugger is not directly programm; but it is implemented as a classZwhich you`derivedr own k 2*, .@makeQPfancy Glike. Dcommands = """ # NOTE:sactual 3A doc$Pation`collecdocstrings ofA$ #<Ps and3 appended to __doc__ after0  haefined. import os $io $re %sy4cmd4bdb &di!%od85glo#dpprint1dsignaleinspecutokenizGtraceback0linecache  Restart(ExcepF): """Cause"Bbe r3Red fo%!d pythonh.M __all__ = ["run", "pm0Pdbsruneval 4ctx !alAset_!",Zpost_morteNhelp"] def find_func( Qname, cre = re.compile(r'def\s+%s\s*[(]' %eescapeH!))2try4Tfp = `.open( m.ei OSError9return None(bnsumer`nfo exs`first 1;vwith fp\&2no,.Pin en\ate(fp, #=1if cre.match(A $\k!no&getsourceWSs(obj\<3 = .2-V%ifqisframe`obj.f_I0alsflocals# must be a modulQqame: do=0try]cut a block out!it)elm]~ 81getv s[+Tno:])#"+1blasti2q(code, Ws = list(disU3s7.reverse(Li}1 inQ@"if}V >= i + 0_rstr(strA"""S that doesn't quote its reprm __s__(selfF} # Intera#mpNwill separate.T`call i^f # text using value of line_prefix string. A new and arrow may # be to your lik.%You can set it once pdb is imported using the # commXP"pdb.f= '\n% '". #= ': ' # Use this0getT old situation back X!->B,# Probably a better default class Pdb(bdb.Bdb, cmd.Cmd): vious_sigint_handler = None%def __init__(self,pletekey='tab', stdin=6 4out 2kip sw"nox=False, readrc=True):/.sY)* *4com!in6out;sys.audit(FPdb" if6out .use_rawinput = 0Ppromp'(Pdb) 'aliases = {}pdisplayhmainpyfile = 'T_wait_for_'c d0tb_Y*noP# TryAload&0 ifeexistsH:try$6)0# remove someEAmon name delimiter_6T.set_!r_.s(' \t\n`@#$%^&*()=+[{]}\\|;:\'",<>?'except IZError6pas|allow_kbdinE4 = 8# Read ~/.pdbrc. iQrcLin %[]!ifI*rc ukwith open(os.path.expanduser('')) as rcFileVE.extend(0I(M/OSI M "$"[l # associates a@listpbreakpoHnumb M5_do {} # for each bp num, tellsaBthe ,:`# must/@. af@exec8M@cmd O Asilestack traceN,Pdefin!= v Pue wh!in+process of defining # a command list8Sself.'s_bnum = None # The breakpoint number for which we areKB# de" a5def sigint_handler(,num, frame):-^0if !.allow_kbdint"raise KeyboardInterrupmessage("\nProgram i*ed. (Use 'cont' to resume).")set_step(btrace( 7Qresetbdb.Bdb.1hforget()HI.lineno  Hstack = []curindex = 0O2tb_mh.clearQsetup|, f, tb 9,gmBack(Qwhile tb# when setting up post-mortem debuggqwith a back, save alla# the or0al s"be displayed along0qcurrent/ OL2s (JAcan E0ffe3, e.g. due_finally clauses6blasti2q(tb.tb_p.f_code' Ca[<1] =)noRtb = ';nex^1curx" =w[d6][0hf_locals dictionary is updated fromTbactual## =Aever+.TaccessorRcalled, so w# cache it herv@ensu hat modificas not overwritten. 6Preturlf.execRcLinesU2# C"uQearliAan 'q' if desiredYs1M!if".rp EKjf copy bec of recursion*N  .r'se@ # @ute y| only onc q 3 = .pop().stri"ifx,ne[0] != '#'Q,ponecmd(db"#' YPs Tru%heAwantS6exiXD # from the interaction, save leftover rc lines  # to execute before nextQ9self.rcLZ += reversed()6return True !# Override Bdb methodsdef user_call(q , frame, argument_list):Ks"""ThisH@ is <ed when therethe remote possibilityFthat we P need%`stop iEais funlE."""70if ._wait_for_mainpyfiler 9c_(5\message('--Call--'i% J{, None)WWpH5J0we or break at tyT$1if .62 !=Srcanonic.f_code.co_[Jname."or,0.f_wno <= 0% E = Falsebp_commands iRG3M0"""#y t as set for current "veUpoint0(if*!."Rs (x normal  must bep,d0 o{Iwise# bpf`in bdbmABdb.aav was hiif getattrJ3, "Bbp",u) and \- n U  W.,0lastcmd_backI (GRsetup[40%s[]7*ponecmd(> F3 =  jif not0_silent~print_stack_entry.[curindex]m_doprompt_cmdloop(Rnkforget #" 1-,|", j_value_a9E tra? if self._wait_for_mainpyfile: ereturnframe.f_locals['__!s__'] = Uvalue4self.message('--RSJ--')#interaction(h, None) 'def user_excep%Y#, +exc_info)"""This funV is called if an K occurs,jbut only)we are to stop at or just below tdlevel."""C0if /._dPtype,_L traceback =o X[p# An 'Inal StopIi'ntC 9debug event# issued by the preter when handling a subgenerator run withJ'yield from'x&a /acontroby a for loop. No7hasQactuallyr ncase. The 0gerqs7 toP'0gee( V such%s.Dprefix ='x@(not_32and6!yp ) else ''K%s%s' % (nv.format_,(a)[-1].strip())C1# G"lI"@_cmd(while Tru6try+# keyboardmrupts al_pasy wayacancel>#current command, soJthem durv)&puGN._kbdint = w)lH FFals*Ybreak_L# K(BP---3]2# Cabefore,es display expression?pre3W=}A.getA.cur-"$ifn:ingQ, old7 in.w.items(pE2new0s_getval5(U5q# checkidentity first;!prls custom __eq__K$be at!ryc, and also p revents instances whose # fields are changed to be displayed5if newvalue is not old6and%!=:Fding[expr] ==0self.message('> %s: %r [old O]' %?s(r,p,1)) >def interaction(}, frame, traceback)# Restore the previous signal handler atPdb prompt.nif Pdb._;_sigint_;j-:tryl.(.SIGINT,\ )Gexcept VError: #[ only workk main threa5Jpassd>lse f = Non0if .setup(H# no desiredis time (happens if .pdbrc contain# a comm`like "'Zinue"Jzforget(ereturn) prstack_entryu.["curindex]M_cmdloope{i6Ahook^W, obj"""Custom*A for exec in default(), whichshq as$qment of<_ variableB$builtins5"""B# reproducRbehaviorPHdard,H=ing04objK 1^{()g, line8!if[:1] == '!':! =E[1:]locals =1cur_&Oglob'3.f_* `code =Ppile( + '\n', ' vsingle'Msave_stdout2ys. o%&in$i#o) R D~f 8'(?out). 3(Q#, x",  7ofinall] js)( Tave_displayhook  except: self._error_exc() def precmd("v, line);!"""Handle alias expansion and ';;' separator."""Uqaif notOw.strip(V!areturn!5aargs =.split()0whirgs[0] in .&es[) =![[E[0]]P)iii = 1for tmpArgd6:1:]`;d.replace("%" + str(ii),W3m&Lii +n u*", ' '.join()R: Z!# Y intoed commands# unless it's an('0if sA!= ''FdmarkerPfind(P 3if (J>= 0A* # queue up everything after9/Cnextv[\c+2:].l 0h1cmdi.append(E ["[:\<].rYn/on Interpret the[ument as though it had been typedresponsef!to@rprompt.Checks whether this3 isNazrnormal Ae or in]a breakpoint9 list definition..-jr_5*ng=cmd.Cmd.7aOelse<gh_m(":#Ws one`ne durf @cmd,`Pparse_?cmdif cmd == 'silent."s_#[bnum] = TruH# continue to 5! oG{!inv'el?endyJ = [1 # end o a0cmdM VHcmd+' '+argo6. # Determine if we must stop:tryfunc = getattr 'do_' + cmd3) except AttributeError:&func = self.default # one of the resuming commands'0if F.__name__ inP*_< {t$doprompt[bnum] = Falses(mdqueue = []return 1 # interface abstraction s'def message(of, msg)print(msg, file=$.stdout)Bev@Q'***'[G# Generic~0ple. Individual"e_foo methods can b@# assigned below to'seX@_comx`e_loca text, line, begidx, endidx(3# C?! a*/module/8M V for break/taclear.!ifm .strip().endswith((':', ',')y2`# HereAes a> number or a condiwhich we. 't2}OGn# First, tryMfind match/s (i.e. expressions)Z6tryWg|<(x,E?ionb6e# Then s as wellglobs = .(q.escapev) + '*' fn%+sif os.path.isdir(fn.append(fn`/`!)elIJ and fn.lower=0.py?M.pywBR:rets:s?ret2"bpo2& Spoint. (This woul more helpful if # display adal info along D`, suchA/P.q[str(i)Pi, bpenumerate(bdb.BR.bpby*I{!if>ps not N_b.start/)]ex%n arbitrary !ifcurframeQllectB1als lst is usually^!re sensiblepalso # complete builtins, and they clutter  namespace quite heavily, so we p# leave3em out.ns = {**self.curframe.f_globals, _locals}Aif '.' in text:z# Walk an attribute chain up to last part, similarKwhatK3rlcr does. This will bail if any ofYTs are noL si_access, which Vhat we wan.dotted =.split('.'):try :obj = ns[CI[0]]5$1forQ'^1:-1]N.R0get`Q(obj,= except (KeyError, A)\return [prefix =c.join(0) + G9@+ n n ir)n.startswithTF-1])Jelse3# C a:1ple!yns.keys(z1)] _mtdefinitiocalled by cmdloop(l# The argumentAthe remaining str!on1com[2lin2# Rr@trueexit from02oopsdef do_I s(,4""" [bpnumberS(com) ..11end?R(Pdb)rSpecify a listiabreakpoint m vd'5themselveentered &`follow7(sD1ypesne contdjust 'end'Bterminat sEh=~@xecu2whevis hit.  Touove all_&a :0, t^ it immediately p end; tpis, givguWith noj,.q refers!heq8 seYou can useT1to  your program upZagain. SkyH5inu|, or step aEtherG9 resumes e7ion /F834 (currently>,pqnext, rq, jump,air abbrevia#ws(000(as5was|immediately "followed by end). This is because any time you $resume execution (even with a simple next or step),@E mayD)encounter another breakpoint -- which could have its ownAcommand list, leading to ambiguities aboutL)5 toA5e. !Ifthe 'silent' k0in Q,UusualGsmessage}PstoppHat ais not printed|Eay be desirable fo#@s thQ reD{vpecificF ndn continue. If none of sB[rnythingwill see no sig!atE&waEreached.V5""" iet arg:ibnum = len(bdb.B.bpbynumber) - 16JelseD:tryYint(arg)?nexcept4self.error("U:0s [0]\n@6... Jend"c#Vretur^{_O0 = 0# Sold definixs!asa keyboard VVrruptv!ifUI in r Cold__defs = (/, 5_doprompt>#<OENone O_ = []! o = TruM_ = False\r_back = z = '(com) 's inV wmdloop(:# K.I- # Restore yT if 5 H%sz &[06 : C1C  A2Af de4lf.$ ( 1 /'Prted,s restored')# finally:self.commands_defining = False+prompt = a_back 'complete_N0 = bpnumber,def do_break(, arg, temporary = 0)P"""b(-) [ ([filename:]lineno | function) [, condi1] ]pWithoutiument, list all "s.,0 a ^ 7Rset a4 at this*Vin th4current 0. % a -, Mue firstexecutableeuof thatH. If a se5 isCApresPit is, trpspecify Pan ex(sion which muvaluate to true before Apoin_whonoredN#ThKmay be prefixed withi and a colon,3to }rn anotheri (probably onaK hasn't been loaded yet). searched for onsys.path;.py suffix PomittA5"""=Qif no|$0if .@: #@re's[PleastH45message("Num TypeDisp Enb Where")Bbp in bdb.B]QR.bpby Y if bp# bp.bpformat()Vretur^u# parse1s; H has lowest1fcedencd#-0can^Poccur_f = Non?,noI *=.find(','#if:> 0stuff after+0: "h(B j[v+1:].lstrip(s* arQarg[:*<].r' -/: H ;".r:xk Dllon >=?lon2f =!lookupmodule(B dfFerror('%rfound from 1' %C ZD NelsemE = fF/T+tr>zint(arg except ValueError:  self.error('Bad lineno: %s' % arg) *ereturnUelse:&# no colon; can beW or functio@2:tryC} = int(except ValueEAVZp = evalY,! &curframe.f_globals9~_localsR=argif hasattr(?P, '__ O__')fj).0 t)acode =0.__/__)#use co_name to identify the bkpt  $sFPcouldFaliased, butXis invariant[_0 = .mu*Rfirst1Kfile] 0 # last thing,=try@T(ok, b, ln) = @info if not okJ The specified object %r isGa'b'or wa<found along sys.path.rE zok # ok contains =#nom&ln@4r :defaultFile(C# Check for reasonable breakpointLc4(f,GZ!if @w seMf g14errjAset_ j, temporary,N!d,DLjif errM:err472$bpgsU)[-1]25kmessage("B[ %d at %s:%d" %8<(bp.number, bp.x 1)) =@# Tooverridden in derived debuggerHdef """Produce a3A."""sy4%if) == '' and self.mainpyfile: lname =('treturn * pdo_b = Breakcomplete_bE = _location=C$%0def_tL(f, arg)2"""T [ ([:]lineno | funcu) [, condi1] ]aSarguments as o, but se temporarypoint: itEis automatically dePd whe8rst hit.15""" .G(arg, 1)OPI,Cinfo+identifier2failed = (None, )H# Input is D , may be in single quotes7idstring =7.split("'"`tif len(0f) == 1?notk#iD@[0].~&p(g/eli3id[1[sF#_M0if o= '': #Qparts3+6'.'q# Prote for derived debugger!f L0[0]Q'W'5del$@09$# Best fipguess ale to look a(fidefaultFile nitem =,el# More than one31# Fis module, se&method/clase6f*"up:(6[0],Nif fKf1answer = find_( !, Kt32or N$Pcheck)%4 , 'no+@"""C.ther specPd,` seemsbe executable.lR7`Z ` V0, 0 (e.g. a doc ngmu, blank"E or EOF). Warning: testt0is PXrehensiveo@# thp should@ bef8Astar[ki3so #"no globals"/eEno current frame7 = getattrA'cur'^'0.f_0alsm c line = l inecache.getline(filename, no, globs) aif not:self.message('End of O'=(return 0=i! =Rv.strip(1# Don't allow setting breakpoint at a blankAUDif (P or (f[0] == '#') or,!":3"1"""$U[o"'''")error('Bor comment  1no def do_enable(SW, argu2""" bpnumber [ A...]HEEWs the2s given as a space separated list ofCil%s.5""" `args =g.splitfor i ins<:tryPbp = R_bpbyz&(i(except ValueE>errRM;errF>lse22bp.dtNd %s' % bp)completeE = _*0disIDG=" Y|aL means it cannotQcauseyprogram to stop execution, but unlike clear^C{,aPremailnWPs and5 beER(re-)d,eIPcondi! SeEnew  ? , an expression whichmust evaluatevtrue beforX is honored. I~is absentuay exis "removed; i.e., mumade un=/alf' ', 1 9S6s[1Q$QIndex$ cond = None Etry: bp = self.get_bpbynumber(args[0].strip())6except IndexErrorQLe('Breakpoint V expected'PQValuePo as erW7err>:lse`bp.conpif not  4ymessage%d is now un;itional.' % bp.Le b1NewO set for b3,%dccomplete_E = _"bp -def do_ignore(f, arg)2""" : [count]ASet the (XgivenU. IfB3is omitted,P!isto 0. ARFbecomes active whenHzero. W @non-,Fdecremented each timeU@is r%edE?and&]disabled #any associat>evaluates to true.c5"""  =v.split(o R= int190w \.!= "ifJ > 0- 1"Rstr = '%d crossings; n2:0L1K'B.DWillnext %s of^ g Gs(},(Qstop lhik.g | _clear cl(ear) filename:lineno\n[0 F...]7With a space separ[ list31s, Wthoses`ithout u4B all*s (but 0 first ask confirmation). With a filename:lineno argument,  clear all breaks at that 22 in H.45""" `if notY:Z:tryreply = input('C|I? ')Eexcept EOFErrorQI'no':j.strip().lower(d1if %('y', 'yes')mbplist = [bp for bp5Pbdb.B<point.bpbynumber if bp]Qself.xR_all_x (cz&N message('Deleted %s' % bpereturn`if ':':arg^# Make sure it works" C:\foo\bar.py:120i =.rfind(':N&:[:i$3argJi+1:W!noXZt(argE_ValueGerr = "Invalidp(%s)" %8Jelse3#4get,]Kno)[>;f=(< _if erGe7K(errpNSEarg.spliti* dQbp = q+(iN ? as<5) do_cl =  # 'c' is already an abbrevi'continue' !@comp _E = _1loc8 (%&0def`where(,&P"""w(uPrint a stack trace, wthe most recent frame{e bottomoAn arrow indicates @U"curr=", which determin&xbext ofycommands. 'bt]bn aliaSthis % .p__Bdo_w2@do_b?)Y_select_^aassert 0 <= number < len(self.stack) curindex = numberframe = /C[ :O][0]5t_locals<1curL#.f 6aprint_ag_entry r lineno = None Vdef do_upEq, arg):"""u(p) [countMove the current  & (default one) levels up in3\ trace (to an olderL%).)5""" "if_TV == 0terror('Oldes' 'ereturnY:tryG= int(arg or 1Bexcept ValueEl =rInvalid#a%s)' %n#if1<2newt5= 0BJelse'kmax(0,?-`_select_b(D%-" =4 C2dow?E_d(ownG1eIO newH0+ 1L  MZ?NewZ O - 1l?in(= ~+~!d~  _untilnt(il) [pWithout ument, continue execution [ ?u with a  greater thaone is reached. t! aL E~0|tFor equal totx In both cases, also stop whe  +s:arg) M;}ROQ #t 1argO: %rR:&if lineno <= self.curframe.f_lineno: self.error('"until" , number is smaller than current 'JY'B-')*ereturnJelse?no = None(Aset_(,&nome! 1? do52 = 2il  efAstepOf, arg)"""s(tepVExecute the , stop atfirst possible occasioP(eith]n a function`tpco`d or iif2%).5""" ( s& OnextVn(extSContinue eH is reache"t s aBn3 1runCrun [args...]bRestardebugged python program. If a stringsuppliedEisplit with "shlex", and=Qresul&qused as5newDsys.argv. History, breakpoints, aWsS@r oplsFare preserved. "r"an alias for "run" if98qimport nD0 = F[0:1_":tryL/:,.>( _except ValueE< `PpCannot %s: %s' % [F, e)T7\ v`[:0] =%v0!`# thisQdcaughtUmain Eloop3craise l#o_3run(u jr cW`c(ont(yb, only0whem!encounteredRnosigintPdb._previous_7P_handG5= \Nrsignal.(.SIGINT, IBValueError:  )# ValueError happens when do_continue() is invoked from G # a non-main thread in which case we just U withoutKSIGINT set. Would pri g a message here (once) makeHmsense?Epassself.setreturn 1$ = ! " efPjump(Wq, arg):0"""j(ump) linenoSet the next that will be executed. Only available inD@bottom-most frame. This lets you back andYDcode again, or-forward to skip $Pdon't wanrto run.QIt shbe notedqnot allgPs areowed -- forinstance it8Ppossi!to@Q intoDmiddle of aAfor loop1out finally clause.-5""" 0if .curindex + 1 != leng.stack2eQ('You can o}#"e %')uDz6tryG Parg =(c(gexcept 6`"The '`' commrequires avnumber"JelseR 2# D_, fix up our copy~;,pdisplayI# new positio2cur"f_Z ={ L-x[ 2] =1[0]N_8g_entry eH K as ^(NJump failed: %s' % eVBdo_jt|dQdebug1"""Enter a recursive %2gerPsteps@ough ?argument ( is an arbitrary expressionQstate/Fto bD-@currUpenviron2)0systrace(Non!Ktglobals6?loc)_&qp = Pdb\.completekey,MdIbstdoutp.prompt = "(%s) " %6v.strip(1F("ENTERING RECURSIVE DEBUGGER sys.call_tracing(p.run, (arg, globals, locals)) except EEion:!self._error_exc(8message("LEAVING RECURSIVE DEBUGGER"3`ys.set!e(@ _dispatch*wlastcmd = p.  complete_debug = _expression+def do_quitrf, arg)"""q(uit)\nexit_Quit from the hger. The program being executed is aborted.G5""" _user_requestedz = True)1setrreturn 1To_q ==0do_?EOF1EOF*qHandles receipt of EOF as a comman +''8OargsVa(rgsQPrintargument lis@currfunctionQco = curframe.f_codLdict$_tbn = co.co_argcount +dkwonly2#if flags & inspect.CO_VARARGS: W?n+15KEYWORD9for i in range(n/!Ename0varEs[i]y%0if FqF*%s = %r' % (8 , 6[ ]9OelseO*** undefined ***^SBdo_a-IWZoretval\\`value H\ _of a e bif '__00__'C-sO "OArepr.4[YYUQ('Not yet3ed!Rdo_rvAt/_gA:try er}5.f_   \2MVraise'ep1!, W=None "if) , q.L  return eval(arg, frame.f_globalslocals) 6uexcept:_info = sys.excj()[:2]*rr = traceback.format_Uion_only(*B)[-1].strip(s_rstr('** raised %s **' % err) |def _errorhf(self)k 5.D(#msg_val_func", 7unc6try0valelf._getF 4(4 # 3) has displayed the-!or-h ymessage(Oval)y 4wFdo_p"""p expressionQPrintvalue of *.+5"""  nh8repoetty-p;pP".p1complete_E = _p&'N6do_list l(ist) [first [,last] | .]yLList source code forcurrent file. Without quments,C 11 lines arounC or continue`previousG3ingl@ . aMgn/, e GnE one Cstarting a!atE two@sAgiven range; iesecond"ar is less than@, ita count.IThe 9i7 ;indicated by "->"bIf an o0ion. bedebugged,Awher8was originallyor propag}8is FP">>",it differs fromz pcmd = '']u = None ifA andj!= '.'m 9if ',' in7 0varg.split(','e)1q = int( $/last = int(last.strip()) if last < first:%8# assume it's a count.T=T! +c ,Oelsep = int(arg -cmax(1,s:- 5except ValueErrorz`self.e!('# in argument: %r' % YereturnQelif Nlineno is None or@z == '.' >curframe.f_I @E>35+ 1 %107filename =code.co_#4breaklist51get&_$s(2N;trypines = cache.get >,vglobalsWa_printK!s(G[10-1:]<!, ,EWreno = min(dR, len| ! <2 qmessage('[EOF]'xKeyboardInterrupApasspdo_l = Bist !ef0ong(q,)C"""l Q | ll9Lthe whole source #P for current functionF5""" %El0.f_WzK,y2gets. "OS>[as erhPd6err;? F+ V  expressioTry to get given object and display it. 4objp_getval' ; T: =L(obj`# (R, Typ3/) K)complete_E = _NIdef $self, lines, start, breaks=(), frame=None): """Print a range of lines."""&"if>8?current_0Bno =$#.f>,3exc = self.tbQ.get(U, -1)7Oelseq V%-1;1for1no, in enumerate(s, start s!tr#no).rjust(3%if len(s) < 4s += ' '4Pineno:B:Pe :== m,->n6== aA>Amessage(s + '\t' +.rstrip()) def do_whatis(:W, arg2"""4qthe typ argument.(:tryPvalue_getval(~?jexcept6$# +) already pA0ed UerrorBereturn0codv # Is it an instance method?$ I.__func__.__%__8! E:ionEpass+0if = ".!'Ma %s' %-.co_name"  OtionF@Func'Vclass4if Q__ isV CEB %s.X(Cmodule__,U@qualo?__)r avabove.. DscompleteE = _expressiondisplay& [?]@#D=A.0 if" chd, each time execuPstopshtWithout c+tst all  s TQl`if not ?$lyoZing:'u@item1ing73cur?{}).items():  self.message('%s: %r' % item) ,Uelse:aval = >_getval_except(arg9+%displaying.setdefault( curframe, {})[arg] = valp*N w,61)) 9complete_,5= _expression-def do_un- , 5"""!& [C]DsDo not FV the ( any more incurrent .FwWithout;, clear all]Y_s forR1""" if:try2del/gea<  KeyError]e'('2`ing %s{S@1pop.MCNone 1, text, line, begidx, endidx)return [ek if e.startswith()Cdo_interack 2SPD an  ivterpreter whose global namespacecontainsa(+and local)6l foundescope.Nons = {**.2.f_`;s, _n%s}MTcode.4("* bive*",7=nsdo_aliasJ1""" [` [comm0[pa, u...] ]]`CreatehDcalled 'KP' thaecutes 'Zh'. Thkqmust *not* be encloseZquotes. Replaceabl?Ps can;indicated by %1, %2, so on, while %* isrZ3TZ. If no is given,eE -cshown.EB&al:es are listedA`es may ne T th7~b-legally typed at pdb prompt. Note! You *can* overridDp1nal8 s  !_+'+then hidden untilD4removed. cursively applied toBfirst word of; all other words in the line are left alone. As an example, her-two useful aliases (especially whenDdplacedp.pdbrc file):i # Print instance variablYusage "pi classInst")_ pi for kg%1.__dict__.keys(): p^("%1.",k,"=",&6[k]P|in self{s~ 6"""%rgs = arg.split(kif len(args) == 0:6 = sorted(a.#esJ/ < N#D0mesQ0("%q%s" % (9,e[*])fVretur if@s[0]v`7e9d1- rgR OelseU[Y[0]] = ' '.joimR[1:])|def do_un4e,)W3"""U nameaDeleteEBfied.$ & h;del6 co+teQtext,, begidx, endidx 1 [ana.startswith(U")]|# List of all7commands making program resume executionT2_4= ['do_continue', Cstep Cnext %',2 <4qui1Ujump'a traceback !at0topck frame # The most recently entered'A is ed last;`# thisdifferent from dbx and gdb, but consist!u>e Python inpreter's IthLalsoMup/down ~p (which7mTpatible : up moves towa{'main()'=` &6Y):q_stack_:try$)G_%noE ,ghentry(C$except KeyboardI{JruptWBpass \s,, prompt_prefix= Cno =Blineno  if frame is self.cur7: prefix = '> 'Oelse( (Ymessage(K+Fg format_stack_entry(_lineno, prompt_K1)) L# Provide helppdef do_(f, arg)"""h(elp)BpWithout(Pumentmint the list of available commands.@$ a n\-asO0 abjDthat0H""pdb" showsfull pdb doc\ation5exec" gives 1 on>!f%""Qif no return cmd.Cmd.OB:try; Ptopic = getattr'@_' ++1<(except AttributeErrorBy.dowTO .elB('Noifor %r' %( if sys.flags.optimize >= 2i; please dorun Python with -OO 'if you need 9f.__doc__.rstrip(=$ = (!) statezqExecuteP(one-)" iacontexucurrentGd. The exclamY0 pocan be omitted unlesFfirst wordh resembles a debuggerlsoFassign to a global variimust always sG2a 'C'lf, e.g._T(Pdb)h_Aons; = ['-l']`9"B . or '').!efxA_pdb9C(Qother,per funcsJlookupmoduleJ`, fileTw"""HelpC  break/clear parsing -- mayverridden.p p) translates (possibly incomplete) L inpn absol#pif os.path.isabs(0U and Sexistame):  return filename  f = os.path.join(syE[0],/)05if 0 exists(f) and self.canonic"==`mainpyy:F~root, extsplitext(@ ,J= ''Z,% = + '.py'm%ifVisabsa L 8`or dirD in 6 =WwhilehSlink(6)+Iread0+Afull| C7I"QNone def _runmodule( ", _\._wait_for_f = Tru)user_requested_quiFFals*import runpy1mod{_spec, code =)c._get_details(J UD.co_t_%__Q.__dict__.clear(:"update({E!"_d__": "4,",$$ )qpackage,@6}.parent,jloader+ +G ) "builtins&&__*}@run({)cscriptjb# The &p has toA 3space (or ^es fromZ%# .will break).  q So we v up the=7t several +ial variablesH(this gets rid of pdb's globalsffns oldC on restartsi!!"_E0__":"68": @}G]# When bdb smtracing, a number{Acallrline events happenBEFORE debugger) reaches "'s( @exacquence of#>ts dependspython version).mtake special measures to 4# avoid stopping before we reach the main script (see user_line andLcall for details)."self._wait_for_Xpyfile = True) ;canonic(3Zname)1_requested_quit = Fals[with io.open_codeNu as fp:U$statemenI"exec(compile(%r, ''))" % \<@(fp.read(),  Erun(v) # Collect Ycommand help into docstring, if not run -OO if __doc__ is BNone# unfortunately can't guess this order from class definition__*1= ['', 'where @down upPbreak t Pcleardisable',N"enb 'ignoQAcond4s 1sted@nextXuntilN1jum!Qretur`retval-!ruqcontinu1lisHBlong 1argtPpQwhatiQsourcCpdisplaya%un GqinteracgAalia?%un Pdebug>!] @q_G in  += getattr(Pdb, 'do_' + A#).*.Zp() + '\n\n'l += Pdb._68del,^ Simplifiederface def, globals=T, loc )iPdb().550)Zeval(expression*_fAk?ctx(`# B/W Satibilitycm (*, **kwds )set_trace(*, header HApdb (#if%Mbpdb.message(M7jsys._getframe().f_backPost-Mortemapost_m((tp# handlqdefaultH@if t>r # exc_info() .s (type, value, Zan excep1 is_M be{ed, otherwise itZ3M 1[2] raNVError("A&id must be passU  "  "exception is being handled") +p = Pdb()e.resetpinteracB(None, t) def pm():4Lost_mortem(sys.last_traceback) # Main program for testing TESTCMD = 'import x; x.main()'l-nCrun(4)Zprint help +iPRpydoc .pager(__doc__) _usage = """\ $: pdb.py [-c command] ... [-m module | pyfile] [arg Debug the Pythogiven by5. Alternatively, an executablecpor packAto d\can be specified usIs-m switch. Initials are read from .pdbrc s in your home directory andZvcurrent@, ify exist. C'ps supplqwith -czed after . To let^ script run until 'occurs, use "ntinue".Drp to a dline X^1gedT T'xrX'"."""mebgetoptSopts, args = . argv[1:], 'mhc:', ['C', 'l3=']aif notMp(|cexit(2<M![]run_as_mq= Falseopt, optargt if@['-h!--]$ )elWcW'Zs.append(Mm@ BTrue! =k0[0]d # Get,2nam0 T1os.path.e&s(_2\(`'Error%q, 'doesB'D1 ifQrunpyv6try"@._gey_detail?O$ EV L.C_excIj #:]{' # Hide " " Z0pdbBionsPargum3lis{d4 = @real# Replace 's  inTnt ofpsearch Y.N_0dirW 3# Note on saving/restorJ8: it's a good idea@ when sys.argv was # modified by the script being debugged. It's a bad ideaO'itIVchangHuser fromVcommand line. There iQ"restart" #which allows explicit specification of5X arguments.Epdb = Pdb().rcLines.extend(ts!while True:1!6try if run_as_modul+pdb._run (mainpyfilef#?els==1if gf_requested_quitjUbreak print("The program finished will be 6ed"except R nXfing", v, "with:W\t" + " ".join(][1:])SystemEx# In most cases ( does no rrant a post-mortem sessionE2exited viaX@().  status:", end=' 'Nexc_info()[1]%eSyntaxErroritraceback.C_exc_]Lit(1VJb("Uncaught "` Enter)@ @5zH@Runn3'cont' or 'step' wur5 %3t =p:*2]@db.i ac((None, tP"  . ) +l2 " 2P # WwPinvok[st", 6ser on a if __name__ == '__2__'`import  () """Create " able serialized representHsI@PythS@bjecA@ Seeule copyreg for a me1ismSregiscustom picklers.Dtools source?0sivem Classes: PO "UnHar Fun'adump(o&, nsp) -> stNQload(+<qs(bytes4 Misc variQyP__ver1!__=dformatcompatible_ s " Sypes BType~!dispatch_t#_Von_registry,2 _inverted_registry, _extension_cache from itertools import islicIfuncpartial ,2sysF%sy@cmaxsizAdstruct[pack, unC$re $io dcodecs_compat_pickle __all__ = ["PError", 5ing!Un63Vr", ")eG@dumpOs Dloads"] try:@DbaBuffer%.append(e!"")#HAVE_PICKLE_BUFFER = True except I{_32False # Shortcut for use in isinstance testing bytes_types = (b , `array)KThese are purely informational; no f0s t-". !@_vers = "4.0"s `# FileDmat /we write Rible_Rt["1.0",C# Original protocol 0[ L"1.1>P5 with INST addedE2E1>3>1BINFLOA 2 I2~3535 tj455j55] # Old$s we can readAis i highest `number3know how to;. HIGHEST_PROTOCOL = 5QeA by default. May be lesx8}8Qempty; APPENDSa *e*extend list on_by topmostslice GEFgFpEmemoN; index isH BINOhL0 " U" ; `1-byteAH INSLiL@& instance LONG_6j64-LIlL_ X3D]>C@ OBJ*o*h(PUp6Sstoreptop in J}qGxLGrGsxSETITEM sGadd key+value pair toTTUPLE3 t5@RtupleE)?D s+u+Rmodifp by add o s(DFLOAHGHs`float;`8P enco[W TRU`I01\n' not an opcode; see INT docspickletools.py FALSL?I00K" # Protocol 2 PROTOA\x80Pident5# p8H NEWA\x815aobjecti@pplykcls.__new__2argFEXT1'A\x82MmL8sion registry; ^ EXT2N3Nditto, but 244444454!1-@Atop 996929;twoG3G7G3GOhreeI8NEWI8I@True&9&BFalsa'Blong< 256 bytes^b7really big long _tuplesize2code = [EMPTY_TUPLE, 123] # Protocol 3 (Python 3.x) BINBYTES -= b'B' # push bytes; counted binary string argument SHORT_KECE! "X; # r" < 256n &4 ]UNICODE _U\x8c'Sshort; UTF-8 lengthY3BIND8 JdJvery longN 24e4.:2SETl:f:empty set on the stack ADDITEM:!90:Rmodif6`by add`topmosack items FROZEN!91Gbuild frozen_from GNEWOBJ_EX!92GRlike # but work with keyword only+s STACK_GLOBALR!93Osame as R usYnames's MEMOIZEFK4K@tore6 of] in memo FRAM;e5=indicate9`beginnof a new frame05 ITARRAY-6SParray NEXT_BUFFER&97-next out-of-band buffer READONLY?h8;5makPP read __all__.extend([x for x dir() if re.match("[A-Z] 0-9_]+$", x)]) class _F@r: _R_SIZE_MIN = 4TARGET = 64 * 1024<def __init__(self, file_write):Hd.' =' %current_v = NonelBstar1ingq e @@io.B FIO()H1endbF1if I.tell() > 0Rcommie(force=True)* H,xce=Falsf ?f = Eif f.$ "or `@dataB.get(%" ( if(T?) >>MIN:# Issue a le call todmethodhunderlyingPp objectI!op@ize of the  !# frame. The concatenation is expected to be leslnsive LP# tha<suing an addiPpal callKowrite.@(FRAME + pack("QaboveRovoid aImemory copyQStarti2new0 a io.BytesIO instance s/atile object can have delayed accpreviouswP"0viaunreleased qview ofNH)self.current_6 = :( Bdef T1!, Z:u0if  Ioreturn'.XRQOelse@Xfile_78_large_b(, header, payload)\G" =YR# Termin O and flush it"h c.commi(force=True# Perform dirm r'u binary#0. Breful noeh[_KPprior'' as we doZ1wan_@allo1 a Itemporary "AWe iEtionally]insert a protocol 4QopcodP6makU#qpossibloptimize AreadAs in<&er()#) class _Una"r:__init__w_w, Clinetell=None98& =9 #P' +rCinto7buf.nm g.WQif n == 0#V != 0) Z1 = M p%dbuf[:]_&(n'n n  if n < len(buf): raise UnpicklingError('3"$e exhausted before end of frame")<return nJelse5n ='p buf[:] = self.file_read(nc=Adef &57, n"ifJcurrent_ Ddataq '.T z]1ot 5and n != 0R.Oq = None"/1!if0w^) < nqS4Pline(9U &0(o@[-1]b'\n'[0]{Bload4,__size  eU)!'"beginningRa new ~ = io.BytesIO{3) # Tools used for "`ing. _getattribute(obj, nam/1subpath in.split('.'S'== '1An"Can't get 6 {!r} on".format(f, obj)`:try paa =( [Pobj =Nzexcept ` "(^t+V fromwhichmodul"""Find the #0 anect belong to.""#_j -3'__1_',8#ifY_name is not None: return module_name%# Protect the iteration by using a list copy of sys.Ds against dynamicPthat trigger importsBSother s upon calls to getattr.K$fo',48 in.().items()Bif (? == '__main__'a h)p, # bpo-4240691 iso]rcontinuj6tryCif _Sibute , @)[0]Z:obj6:except AttrUZErrorBApassG def encode_long(xQr"""E0onga two's complement little-endian binary stringQNote 0a special case, |dn empt>,qasave a@byteLONG1 pickl:zQext. )9>>>!0)"b' 4255!\xff\x00)Z32767+/7f+F-256* 00Y*V8,87-12*&'121"""@if x0) 'nps = (x.bit_length() >> 3) + 1Iresult = x.to_4(; , rorder='&', signed=True< 0 and :F > 12if eA[-1]1xff.(2] & 0x80) != %$ =FC:-1]$  &de Gdata D _from vg2b'' 0"<"'?255) #7f)Y7++* $80*V8,(/12&"12@int.aOMT # Pmachinery class _2er:$__init__(self, file, protocol=P0, *#x_,Zpbuffer_Aback<;$"""This takes a%q @writa e D3eamG`The opal *protocol* argum ent tells the pickler to use#  given protocol; supported s are 0, 1, 2, 3, 4 and 5.EThe default7 is 4. It was introduced in Python 3.4,KHi)compatible with previous versions. 1Specifying a negative2r select uhighestC_0. 1r5YPused,Gmore recy%heN$of`needed@read=Dp#*file* argum_ must have a write() methoUat accepts aYsingle byteHcan thus bNi object opened forGabinaryt0ingP io.BVIO instance, or any other customD^that meewterfaceIf *fix_im s*R@True3$ *0les anrwill tryz1mapy4newp3 names+old moduleGa2, so 7t data streamEableE2buffer_callback`None (a_2), (P view]serializd to=8s part of@not Pn it 40be !edVnumbe(jiTaB. I? returns a false valu(such as) is out-of-band;v+wi- &4`, i.e.!id$tan error if *Y 3 i(Asmal8hanR6"""/fy;:  = DEFAULT_PROTOCOL(iE?< 0AoHIGHESAPelif F0 <=<<= 3 \ raVE6#(" beW]%d" %Q) qpW?< 5 LsV>= 5"}lself._4=:tryAe_0 = . 7 ex Attribute6 IT2Typ ("G must have a 'write' attribute") self.framer = _F (a_file_< 01 = '=. W<_large_bytes4 @memo = {}@protAint( ;coldbin = Z >= 1Dfast = 0ix_importf6andOA< 3 9def clear_6!):^@"""Cs the pickler's "-"".C)@The " i+data structure that remembers which object0qc has already seen, soFshared or recursiveJF$ard by reference 0notvalue. This method isCuseful when re-using%s.'5""" K.Q"()bAdump\, aW# a]d representation of3 tpe open .zp# Checkbther P was initialized correctly.# only needednQmimicbehavior_.b.)0if `0has""9RraiseingError("^ __A__()ZQcalleyHF"%s.CA" % .__class__.__name__,)~"if{x2f+(PROTO + pack("~s2d)H transient` s pkept algduringG7ingx0use/length afs just a^`convenPrequi nthWDs be unique|0But/Bppears no advantageQany oqscheme,$th # scheme .allows the Unpickler memo to be implemented as a plain (but # growable) array, indexed byMEkey.0if self.fast:Mereturnassert id(obj) not in<(idx = len(X)Rwriteput(idx)"5[j] = idx, obj I1# R a PUT (BINPUT, LONG_ ) opcode string, with argu?" i@def ,e)proto >= 4 MEMOIZE$el9:bin2 ifcj < 2569n + pack("yt)@if f "f> # Call unbound methodexplicit Go lprivat if any, or  S# copyreg._ '3%',`D))O None:  rv = reduce(obj) y else: # Check for a class with ustom meta; treat as regularN* if issub(t, type)self.save_global&}return n "__P_ex__hod, fall back to #_L< = getattr5, "2Uz", Noneo#ifq is not'^protoSm _>/" raise PicklingError("Can't pe %r object: %r" %G(t.__name__,G&))&rstring ISed by(), mean""instance(rv, strAJ, rv5Assert thatxa tuple_)is$ y`%s musiQ"orf3" % Fi< ed an appropriately sizedKl = len( !if$p(2 <= l6T 4by Vhave -@"twosix elementsSR3the() output and finally memoize (Np=obj, * (def persistent_id(6<# This exists so a ` can override itVr0kkpg7pidv!# a id referencF.binue`(pid, _o[=Fals=5write(BINPERSID2[:tryvzEB + ).encode("ascii") + b'\n'eBexcept Uni-E3mXyL" IDs in Rcol 0be ASCIISings"xreduce(self, func, args, state=None, listitems/ 8dic$@r_setter7A obj %):B# This API is called by some subclasses 1if not isinstance(WtupleYraise PicklingError("/ from save_reduce() must be a K,")sPable(&j(j Q&") = self. Twrite 5i@_nam qgetattrA, "_j__", "cproto >= 2 and I=<ewobj_ex__"[4cls)!kwS=8%1has4[ew__"B02[0]I!{}f has no __nL vJq.format)0 ifa4clsaobj.__*__Athe wrong Q"5 4WJ(cls(NEWOBJ_EX!Nelsej = partial.!, (*O, **uG o(fREDUCE7Belifr S# A _I__ implementation can direct _col 2 or newer to`# use more efficient ^ opcode, while still@allowingn01 to work nlly. For t *,dbreturnshould be"edF!_,its firstu( B, aDl. TheX7for\ 8R@s folthough peF>wayaverify #k7def!,  # D2 [  PTcols Dwilla referenceMv G: (and above) will pickle a reference to # cls, the remaining args tuple, andNEWOBJ code,Bwhich callsN.__new__(Z*Mq) at unaKtimeE(see load=obj below). If __reduce__ returns a@cthree-state fromRthirdR item!bed regardless ofAprotocol,Q__setg+__ Tbuild 9  Note that no standard ` obj__ implementation exists;Fpyou hav provide your own. This is to enforccompatibility with Python 2.2 (3s written using= 0 or 1 inCa3 shou${able byEu)).Qcls =9[0]if not hasattr"@Y__"):,praise P7ingError(%)"2[0]aRpi C0if !isANoneeobj.__class__J)awrong n)")Y*1:Z@saveP 27 "e(CJelse?Ffunc%mVREDUCE) ` e#R`objectpalready@memois means i&a# recursive. In tE@case8row away everyth-we put o+ aRstackkQfetchpBbacke if id(obj)Pself. aPOP + 'Aget( 0[EZ][0])~O:1ize# More new special 1s (BworkFPolderYEs asd# well): when4V5s#H14th`15th!niteratorsdGlist.sC di/tems (as (key, value)0s),.0if SH# Q_batch_appends(7 N self._batch_setitems(dic C) if state is not None:%"H0ter)%)Qsave(M)Awrite(BUILD;elsp/b# If axspecified, call it instead of load_build# to updobj's with its previousm.;First, push%1andCPtupleexpected argumentsOR(obj,I) onto the.ck~Tu >,#obj) # simBINGET opcode as objalready memoizedq jnTUPLE2# Trigger function~boREDUCEbhe purpospmto carry-out an}inplace modifica of q. We dopcare abG@whatMmethod might return, so`outputeventually removed fromP3POP1# M}s below this point @disped through b tableC= {}0ef V`_none(K,!).3NONJ`[type($F)] =J ]Obool]qproto >= 2y}EWTRUE i M NEWFALS1C @= Olong :binPis sm"en1o fKigned 4-byte 2's-comp># format, we can storemefficiently than {generalHJcase!# ` one- 2two2unsJintsJ>= 0~<= 0xff $`BININT1 + pack("= 2::encoded = `_long([ 'n = len(%dwif n < 256\`}write(LONG1 + pacB", n) +y TOelseN4NNR-0x800 <=LB0x7f |INT + repr&.("ascii"Vb'\n'"NOLPdispatch[int] = save 2def`float(h'6bin pBINFLOAB'>d'H>& _bytes :< 3 otA: # G ect is emptyC @.cqreduce(7A, ()=&K Gr#cs:,w4 1(stm, 'latin1') >obj  *ff/SHORT_BINBYTESr S!elUB> 0xIkff and4n_oq_large_j(u8vQ6u=g framer._FRAME_SIZE_TARGETvuIu 5 D +v3qmemoizeP_array56L4/K s,m>4YTEARRAY F obj) dis patch[bytearray] = save_ if _HAVE_PICKLE_BUFFER: 2def8picklebuffer(self, obj)*.0if .proto < 5#praise PNingError("!eB] can only sd with "F"zcol >= 5")5Hobj.raw() as mif not m.contiguous%L&be?hend"pointing to a non-  7in_band = True_A_callback isONoneYAbool.F( yu>[# Write data in- I# XXX The C implementation avoids a copy herBif m.readf'4`s(m.to>>s()1?els8 OS O ,oout-of0xw\S(NEXTSREADONLYW2disj/sta]:bin`encode ('utf-8', 'surrogatepass'n = len(5d  <= 0xff PKb_4SHORT_BINUNICODE + pack("vf|_}R_larg&s(8Q, = framer._FRAME_SIZE_TARGET I K RYKPobj =.replace("\\", "\\u005cV/0//00/n/a/r/d/x1a", "\\u001a") # EOF on DOS self.write(UNICODE + obj.encode('raw-uni -escape') +DOeb'\n')^memoize(obj dispatch[str] = save_str 82def`tuple(C,!):m`if notA: # ( is empty%)@F.bin>EMPTY_TUPLE Oelse: MARK + ;breturnKvn = len 5  <= 3 and proto >= 2for element in/G}u(% # Subtle. Same asEthe big comXibelow.WQif id1 w4get@get(%[5J][0]1POP * n + get*_-Psize2/[nk  "# C0 or 1jb isn't,"'> $=# has more than 3sa; ?( K Qd was0in 6 when we enteredU), sofO # Rprocess o1ingB%'s must haveTdI30 it/&: Frecursiv0Theper actionL0now3to throw away everyth`we putQ`stack, Gsimply GET(it's already constructed). This checkKRcouldbeen done`"" loop instead, butJ:s are a rn"ifq@POP_6 U5-- 1available^ * (n+1)a3No &onM U.}Olist^ 8FLIST 1can't use EMPTY_LIGST  self.write(MARK + LIST) %!memoize(obj)_batch_appends!"@dispist] = save_ \_BATCHSIZE = 1000Kdef T, items):\# Helper to  up APPENDS sequences/~  dpif not F.bin}for x in  f&(x/d( greturn0t =^"r(hile Truew`tmp = d(islice(it,o)un2jen(tmpJ > 1c/ 2>tmp:"SY elOKjtmp[0]1hhp# else . is empty, and we're donekJ}, 6"ifR Y-EMPTY_DICT : # proto 0 -- can't use 3 U2 + V%!1set. )- dif PyStringMap is[7NonC* JK\$%wSETITEM&;K>= 1 onlyg ^ 7 Ok, v: k.(v( CiS2V 48s=<5[0]fj9 return def save_set(self, obj):!0 = . Twrite R5"if1proto < 4PM_reduce(set, (list(~!,)= p9w(EMPTY_SET)-bqmemoizeSt = iterGwhile Truebatch = islice(it,_BATCHSIZE)|Nn21en(> if n > 0g5JMARK20forQm in U?'^(itemB^ADDITEMS <cj@dispP[set]EiWofrozen]jc( :obj(Qif idp 9# If theect is already5, this means i&f# recursive. In-@case8 row away everything we put o+eKstack, and fe0objback from.>o@POP_<" +]gf.1[K][0]@iRNoFROZEN  fglobal, name=NoneAelf.  `^0ameO f = getatt, '__qualP__', 6Obobj.__Aamodule = whichg:try__import__(6I, level=0:"2ys. "s[7]8.obj2, paren_Sibutem except (IError, Key AAttr?oraise Pickling"(%"Can't p&e %r: it's not found as %s.%s" %=Q)34;elst if21o c) pickle %r: it's not the same object as %s.%s" % (obj, module_name, 5)) /if self.proto >= 2:Rcode = _extension_registry.get((]80if C UaassertI > 0u 9 <= 0xffA%write(EXT1 + pack("tryQ?_ascii? C 5C*except Uni!EnNrrorpraise P(@ingE%(Tr"can't Rw globalS! '@' us"D>lcol %i" %.,p)) fromepmemoize@def `_type(%,J) ifC#GNoneLL00, (2!,)WF=objum7obj\tImplementedfturn self.save_reduce(type, (NotImplemented,), obj=obj) @elif@ is 6e(...):&return self.sae?...Z 7qglobal(a dispatch[FunctionType] = f/ )!  # Unpickling machinery class _Ber: Lef __init__(, file, * x_imports=True,2 encoding="ASCII", errors="strict", buffers=NoneKP"""Thfakes a binary} for reaY1 a e data stream. The protocol version of te detected automatically, so"noHP argu"8kneededo!** * must have two methods, a#()U thatntn integervS, and<Jline@ requiresI%no;s. Bothqs should z@byte#RThus Fkcan beobject openedP io.BR%IOF1, or any other customTM meets t[rfacedZT-like9ehe$Em eBl nE RrjCr CIf **0ot D, itFn iterablec20-endl atMconsumed each time referencan out-of-bn view. SuchZ|been giveTe order!tos_Pback*1a P'rU  (Zdefault),Xn@are yn~Afrom#p, assumPthey 8serialized05re.DIK"an_Ps* toijE0wasd with a non-:O O op&alq5*fi'D*, **|**, which: us o control compatibility sup{F Bp generaby Python 2. If *fix_imports* is True, pickle will try to map the old Python 2 names2newGtused in03. The *encoding* and *errors* tell {5howGto decode 8-bit string instances4Dd byk 2;%seDpdefaultq'ASCII'|'Lct', respectively.Vcan bIp'bytes'IBreadg1as / objects.5""" self._buffers = iter(S) if not None else GPfile_pline = .,( $memo = {}4 = ! @protV04fix (def load(0!):@"""Ran representation fromR openYEaReturnreconstituted hierarchy '2ifib # Check whether Un r was initialized correct{wThis isEonly neededwQmimicbehavior of _[.dv.dump()s0if >qhasattrF@, "_1"TTraise@ingE&("a __A__()]QcalleLF"%s.EA" % .__class__.__cU__,))._unframer = _U >", , I# =)U1 q(!inU ,0o\ 0metastack = []dappendb&. @p8 0dispatch!6try{Qwhile@ `key = a&(1x+keR1EOFzassert is R(key,qn_typess[key[0]]2'except _Stop as stop^ r,b.valueK## I`a listitems push3 after last MARK0rucpop_markWP!].pop()  self.append =Sstack# return items def persistent_load(Nq, pid):$=raise UnpicklingError("unsupportedG id encountered")lispatch = {}0ef ta_protozuread(1)[0]if not 0 <= ,<= HIGHEST_PROTOCOL_ValueeLcol: %d" %)w .pxd[zg[0]] = \frame_size, = unpack(' sys.maxB 8 * 8 o1_un!r. (. XFRAME * y:try%pi  line()[:-1].decode("ascii"except Uni D& Z6"+r IDs in col 0 must be ASCII strings>.Nys?hPERSID@5dA2binYD3Bpop(d!>BIN =nonuBNone9NON1C VOfalsW F! XiEWFALS\I ]?tru\ =TruYEWTRUZF Yd 8)t(u=BINxd{_yCstri,@'ue# Used to allow -s from Python 22be Pd either a#sI0UniI. This should be uponly with theN# STRING, BIN  fSHORT_ opc%s.9"ifencodingE"h*s"breturn>Oelse'..aje&s)t D1j # Strip outermost quoteipif len(La) >= 2 ![0; G8 0] in b'"\''0 = )[1U3the  argument mustdi cs.escape<[0]&~ 2bin # Deprecatedvuses signed 32-bitx5gth5?len~/le8Q/e = /lep WZEing def load_binbytes(self): len, = unpack(' maxsizeDK!raise UnpicklingError("BINBYTES exceeds system'sFPimum K% "fLq"of %d 0" %A<aappend3lendispatch[j[0]] =  2defqunicodeP6 k!troline()[:-1], 'raw-B-escape'xUNICODE2 3binnO^Z( , 'utf-8', 'surrogatepassX3BIN[E^8_ Q"8"%8`8a8b``^_1elf  =# ;ytearray<^YTEARRAY=R1b =5Zpbinto(bMd M fnext_buffeb"ifs is None stream refers to out-of-band databut no *s* argument was given") try:'  buf = next(self._buffers)&except StopIteration:Kraise UnpicklingError("not enough out-of-band a"byappend(bufdispatch[NEXT_BUFFER[0]] = load_ 2defreadonly)tstack[-1]Awith memoryviewV as m@'0if $m.l # at = m.to/(READONLY3 short_binstringalen = HV(1)[0Idata2lenB_decode_k>)/SHORT_BINSTRING _bytes_BYTES0uni(!tr=7( , 'utf-8', 'surrogatepass'[UNICODE QtupleyTitemspop_mark A2 ITUPL, aempty_ (]mEMPTY_cO ic1d1 = !.,(q1aXm2LX[ 2:[#o22],$21])E223\33332lisI +[]lHLISTbMf0dic?aryl/{}l?DIClSr/se /SEm;setf`frozenG@=uE6tch[FROZENSET[0]] = load_frozenset deflist(self):items = .pop_mark() qappend(,dispatch[LIS|d w?dicwQd = {pS[i]: 5+1] for i in range(0, lenU, 2)}/d9DIC # INST and OBJ differ onlyuhow they get a class object. It's not#5sensible to do=P restMa common routine,4twosIpreviously divergedCgrewent bugs.3k!isSto instantiate,Bk points th`pmost J, following which are]`argumeDx.__init___{!, +h, args0f (0 orK2 is:3ce(1type) or hasattr$`"__getLG__")c46tryrvalue = (*;8except TypeError as errJVraise(("in constructor%s: %s" %g .__name__, str(err)), sys.exc_info()[2]Jelse PBew__^781)mTPmodul<>readline()[:-1].decode("ascii"k45Qfind_!(m , Tb }@,2` ) @arg12%m cl%"(0)3clsW^8OBJ;obj?newusobj = clsp ^?u2obj^;NEW<_ex/kw  (B, ** 8_EXnewobj_ex def load_global(self): module = .readline()[:-1].decode("utf-8")6?nam4Tklassi`find_c!(m , Tbqappend(:dispatch[GLOBAL[0]] = d_stackq(R.pop(h" if type(J) is not str orCzcraise UnpicklingError("STACK_ requiresY! S9\?* ELext186a(1)[0]}get_extension(2 HEXT1i|2|, = unpack('!if8:keyo!if <= 0: #%e that 0lforbiddet# Corrupthostile c%e.)EXT specifies=SValue"unUered AQ%d" % p}F*key$ [5obj. X%", rtQ# Subes may overridu&is:sys.audit('Ub'^*"ifproto < 3 andfix_imports4  in _compat_{NAME_MAPPING>B<[jBGCelif6oIMPORT  8[y_%__vlevel=0 VB>= 4 return _getattribute(sys.modules[], name)[0] Uelse:sreturn LG 7def load_reduce(self)Rstack = . 6i@args"e.pop()Dfunc6[-1B0 = % (*F9dispatch[REDUCE[0]] = s'if7delDWS_mark8POP>pop9GV [_MARK[I `=dupelf.append \)DU,du1getBbi = in.readline()[:-1]_a:tryrgmemo[i3except KeyError?0msg%'Memo value not found at index {i}'raise UnpicklingZ(msg) from None18GETu;getp?bin)(1 / as excd;BIN Rlong_ 4, = unpack('bin> maxsiz"negative LONG_BINPUT argument") self.memo[i] = stack[-1]&dispatch[LOJ0[0].load_long_binput 11ef W@ize(U!):vk P[len()a:.xMEMOIZE8;izelappendV PvalueV.pop(0Dlist#.kA4>hAPPEND-sPitemsxpop_markD_obj# 6tryextend = <.except AttributeErrorDFpass0:lseQ(yereturn;# Even if the PEP 307 requires Hb) and 7() methods,Ffall back on)Wobject has noTGE!orDward compatibility.&=!@for 1 ins. (S)s*0seta * ?key?dic@[key[ixSETITEM ~range(0, Z2Ws), 2L[![i < +   1addH 0set"if isinstanc`/[, setJq.updatepsqe ad61add,T0temW #1addfe 0ADD  5 ObuilOstat#Ft4set8getattr(,T, "____", None7 ifd:iGt! @((=A 5slojn r, tuple_[ == 2tate, slotstate = state "if:inst_dict = !._+__&@ternSPys.in for k, v ine.items()mqf type(k) is str#'[o(k)] = vw)OelseC k; 1lot ; #setattr(9,)dispatch[BUILD[0]load_build %1ef mark(self..metastack.append%.h*Q = [][82elf:L(HMARK AstopAvalui^Fpop(raise _S<-xHSTOPxe' # Shorthands def _dump(obj, file, protocol=None, *x_imports=True, buffer_callback+_Pickler(N F%fiR,0X Z $).)s,fo.BytesIOl@res = f.getassert is ance(res, b_sreturn reencoding="ASCII", errors="strict"sqI_Unp= 6#s=L_ !). os(s, /G (if} s,[PTypeE?q("Can't  from unicode>Bing"% w ]=  ^# Use the faster _if possible try"-% ( ;ingO0&erA*!s+ s) except Is Unpickler = _Pickler, _Unp dump,rs, loadRs = _Bs, _s # Doctest def _ 1():Timport d gdreturn..mod() if __name__ == "__main__"Largparse` Dr = .ArgumentP$!r(&wdescription='display contents of the  files')<bc.add_a[U'1_1', type=FileType('br'),Nnargs='*', help='zy-t', '--?R', acstore_true'qfrun self3o suitejv`verbosely; only affectsx3runv3 = `b"s(x ifs <]LFelsebif not4!?fr.print_m Op/sfor f ino +Qobj =O"(f\.(obj) '''"Executable(a " z0module. Extensive comxs aboutprotocols and-machine opcodes can be found here. Some funeqs meantexternal u genops(Generate allg<b, as (,R`, posi) triples. diZ, out=None, memo indentlevel=4~P a symbolic disassemblya.u# $cs$io $re sys __all [^ optimize'] bytes_*YT.OOther ideas: # # - A verifier: read check it exhaustively # well-formedness. () does a lotpthis al]&y.~<$nt@exam= Dits rq number1(== highest .% attr value among2!).L) !s binfo a7end HTple, tuple-building  is sometimes more}Qelabothan necessary, cater>Zossibility thjJis recurP. OrsPa PUTgOdF's never ac{!edM by GET. # "A pickle" Bis a program for a virtual pickle machine (PM, but more accurately # called an un64ing8p). It'gsequence of opcodes, interpreted by the # k0ildIan arbitrarily complex Python object. # # ForA most part,PM is very si= : re no looping, test or # conditional instruc s,4arithmetic and1fun  Rs. O0 arPexecuoeach, from first to last, until a STOP'r2"edThe PM has two datafas, "the stack"Rmemo";CManyWjs pushI`s ontoE; e.g., INT.e{! #3ger6 on9, whose valuebgotten a decimal string # literiQmmediZp follow7" iil@e by@reamu0the*ms take&ff0. O`resultis # whatevyis leftB whe fi/ oy;Parrays, or it can be 0menBadict # map@4tlesPIr@servsPM's "long termNqemory",;u9litWTindexSaHko variabl@nameFSomepBop aY4ioMt a given j1, #o!a ++ a2 b againxSAt hea#llK. Subtleti#Arisethese reasons:i1+ Ow identityysaV2sub\P mayshared (0exalist [a, a] refer saZv a # twiceq@vita7at recreatexisomorphicK@grapaithfully reproduc2ingW+ RecursiveBafter "L = []; L.append(L)", L&@L[0] is@rela RRpointNsse;&s\order toG1get%cright 'in all casesdThings7doesn't know ? yt about. E:u>;'s builtin scalar+qcontainP typf1liks and tuples. ThNey generally have opcodes dedicated to # them. For things like module references and instaof user-definedKclasses, pickle's knowledge iXmited. Historic, many enhancementsMbeen made toZ protocol in order do a better (faster,K"and/or more compact) job on those. # # + Backward&tibilitymicro-optimization. As explab belowqt never go away, not even whenEwaysget inven9 Thpertoire ofPM just keeps growing ou0tim example,@0 had twofor buildDPython integers (INTand LONG)LP1 addYBhreenMw-efficient\of shortPb,m2S/woQKGlong0befS,4Tonly u#a CLtook time quadraticsthe numberdigits, Fboth"an!unbing). "O bloat" isn't so much a subtlews@ourcPweary=lA # Pv s:.a@meanIBof a$ changes. Instead new #, s each version's er can handle allL!inHate. So olds continu@ # b`adablev0. 4b8l  restrict itself`subsetBQavaild unzpreviousy o,0tha1s ecreateIo@curr&3 re byEer #_I ow,Adoesb0ain2@embeP # wil0 itBf anf@trieh us>Qa lat^`resultAmostRlH` excep>! dA seeI@n un.pn (in #! )originalI used what' w aDed "2 0"$0 wa!llP"text3e" 3 32.3F0entvM@ byt51eamPup ofArint#7-bit ASCII character"1lusvnewline,aR. # Tgwhy it . Protocol 0 isn small and elegant, but # sometimes painfully inefficient. # # The second major set of additions is now called "protocol 1", v3wasd # "binary mode" before Python 2.3. This added many opcodes with arguments # consisting of arbitrary bytes, includ2NUL unprintable "high bit" ##F. Bp picklen be substantia,Yer than equivalenZAtextA q@fast:oo; e.g., BININT repres a 4-byte # int as 4p follow3the!, which is cheap^2 un thM(perhaps) 11-characdecimal strZattached to INT. PR also # a numberthat operate onPstackmt once (like APPENDSPnd SETITEMS)9"shortcut"s6EMPTY_DICTfTUPLE)@thirMjwcame insH Y # 2":#p- A betE0way1u in.0ces new-style classes (NEWOBJF?Sfor a8Lidentify its pe(PROTO;QTime-uspace- Jpof longMs (LONG{1,4}DSd s @ tup(S{1,2,3}}Z- Dedicated9BboolTRUE, NEWFALS - R"extension registry", a vectoJpopular objectsAt capushed # @ly bdex (EXTRU0kinR5Amemo04GET `t re predefined (there's nothYaX!'s3PUT\A*er indepenr changepabandon)<Pany #5e it might0afeBload es received from untrust7parties -- no su security analysis has been doncguaranteJt nd8re isn't a use cas0war1e expenseqsuch anmX@To tXPend, Btest__safe_for_ing__ or # copyreg.'pconstruQs are remofE d. # Referentese vari/s(8rdescripQbelow`!to!ee"s 'b#jl2. # Meta-rule: Dg`stored Zhp9., # with pla@in constructors. No meta-language is defined from which # descriptors could beM2ed. If you want, e.g., XML, write a little # program to generate*qthe objects. #: # Some pickle opcodes have an argumefollowing (0 in # bytestream. A8=of a specific type,<`bed byhpinstanc Cof AvDb. These are not)nfused withs taken # off stack --Z applies onlyWs embedded iL, immediately #anG Representsnumber of30%um} delimit thnext newline character. UP_TO_NEWLINE = -1 #xU two-{P wherwUfirst`_ giveu second1. TAKEN_FROM_ARGUMENT1 2 # numPis 1-N` unsigu?int@4@3@4@>c-endian LU4LN8N5N8No class(): __slots__ = (`# name\ record, also a module global0;UtringI'H5', # length\(,"s;:t; 7andBr{1,4,8} egative values for variable-~MUcases*'na function @a fiH$ikK`, readthis kind\#1 atcurrent posik, advancS#e I*n, and return9znG'*er`human-/B docA3argpQdoc',b)def __init__(self,+2, n70er,e|assert is(Da, str)Z%J.! =Pm?`!t) (n >= 0 orK5) (  TAKEN_FROM_ARGUMENT1, .C4C0UD/E8U))self.n = n reader =  assert isinstance(doc, strVdoc = doc from"uct import unpack as _ Q defn_uint1(f):Ar""" 4>>>>%io2io.BytesIO(b'\xff'12550J data = f.>"(10if vareturn1[0]9 raise ValueError("not enough)0 inaeam to A")  = ArgumentDescriptor(]taname='.'+n=0er= 0doc="One-byte unsigned integer. w2w-2(wL\x00{4O6553 2@len(m) == 2\a(">> import io8(io.BytesIO(b'\xff\x001'))D1255^L ' * 8)) == 2**64-17ATrue  @= f.N"(8fpif len(C8|return _unpack(" "v of %r" % (qX4;@1A"UbreakFelse:(r)R0 = 2cs._%D)[0].decode()"ascii") return data stringnl = ArgumentDescriptor(04dname='4-', =UP_TO_NEWLINE preader=_F % doc="""A newline-terminated 5,. yThis is a repr-style1 , with embedded escapes, andKbracketing quotes.&""") def 2_no`A(f):8r &1(f,pav=False)F F.n $ a 3%< /st>outu? >or  It should consist solely ofK printable ASCII character,1 V_pair61""">>> import ioECio.BytesIO(b"Queue\nEmpty\njunk") ' 'Ys "%s %s" % (pO(f),>P<.pA? ofsFThese ar s7?s, CThey I & !AThe %#is@ed aKsing #a 3blank separaqthe twop/ng 1 )1(E\x00{pn1u3abcdef72abc:2n =@uint&assert n >= 0  data = f.read(n) pif len(q) == n:areturn7.decode("latin-1"=+raise ValueError("expected %d bytes in a string1, but only remain" %rv6(n,C)) E = ArgumentDescriptor(Dcname="2,",=TAKEN_FROM_ARGUMENT1&'0er=_J #doc="""A coun(+. qThe first a is a 1-% unsigned int giving the numberL&ofZ%sQ, and5isecondithat manyK}+s.""") def B4(f)Ar"""3>>> import io 4@io.BIO(b"\x00Rabc")I/''@3@5defC?abcFG3abcFTraceback (most recent call last"..6%: 503316484"6 S 2n =v0intsif n < 0!y4t2s %d" % j#%d444  #-4little-endian   L;31 3 b1 %b'?@uintassert n >= 0 (@  D1", n=TAKEN_FROM_ARGUMENT1, preader=m_bytes"doc="""A counted ' string. P The first argument is a 1-7 unsigned int giving the numberL"oflQ, and'isecond[that many,.D""") def Q4(f):)Ar""" >>> import io3@io.B!IO(b"\x00aabc"))81b''R@ 3@6defC?abcFG3abcFTraceback (most reccall last"..4ValueError: expec50331648]R in a 4, but only 6 remainQ 2n =s@uintrassert n >= 0 if sys.maxsizefraise ("F!s4) >; %d" % ndata = f.(pif len(g) == np`eturn % #%d1" %K 6(n,C)) 3= A:Descriptor(CSname= ",4U' 4"34little-endian  F8 ,@uct,c /8(  %P %D )b'50bigL38 =.pack(">> import io,uct, sys D@io.BIO(b"\x00 aabc"))LB(b''~_ 3_ ?defb7abcepbigsizesstruct.pack("= 0 if.fraise (;) >? %d" % nUP = f.(&ifW == ntQeturn^iA(%'#%d(D55N+drunicode/nl T < `abc\\u\njunk"))}''MATrue L Rline(<0ot .endswith(b'\n'E`no newH found when trying to A ""! =P[:-1]8a# loseTsre1str_s, 'raw-W-escape')  mentDescript_or( name='unicodestringnl',.=UP_TO_NEWLINE'preader=_[3doc="""A newline-terminated U /. This is raw-v-escape end, so consists ofIprintable ASCII characters, and mayFtain embeddedKsequences.(""") def 6Q1(f):9Ar""" >>> import ios = 'abcd\u'enc = s.('utf-8')  b>xea\xaf\x8dDn = bytes([len(enc)]) # little-endian 1-%q lengthU?t =@io.BT`IO(n + + b'junk')as == tNBTrueX-TS[:-1]OTraceback (most recent call lastj"..ValueError: expec7 c in a k1, but only 6 remain G0intassert n >= 0data = f.-"(n  ifY()n`return$#, , 'surrogatepassfraise %("/%d2%d ~ "v" % (n,J)) . = ArgumentDescript"?"Nn=TAKEN_FROM_ARGUMENT1,^0@coun The first aa- Bsigned in [ giving the number ofOecon!--QPUTF-8 odd"of 1 -- 0cons that manyH . 42, 04.4(- T+ enc[:-1])) Traceback (most recent call last):'1...4ValueError: expected 7 bytes in a unicodestring4, but only 6 remainHA""" n = read_uint4(f)assert n >= 0 if sys.maxsizefraise *(" count >C %d" % nvdata = f.(pif len(g) == nxeturn str , 'utf-8', 'surrogatepass'_B!%dC A%d " "\6(n,K)) = ArgumentDescriptor(V[name=L/",+=TAKEN_FROM_ARGUMENT4U-_0er=_0doc="""ABed UdzBing.J he first a is a 4- little-endian signed intgiving the number ofQ, and'osecondM!--*UTF-8 encodd"of ? --Kcontains that many """) defsd38(fr<>>> import ios = 'abcd\u'enc = s.#e( 91enc,b>xea\xaf\x8dD0s([venc)]) + b'\0' * 7 #8QengthamtX @io.B`IO(n +w^fjunk')s BTruebX.8(TS[:-1]ObK8b$b:8vbCb0/8 b*8b8b8,  doc="""A counted Unicode string. , )The first argument is an 8-byte little-endian signed intMgiving the number of GAs inR, and_econdM!--*UTF-8 encodd"of ? --Kcontains that many..""") def read_decimalnl_short(f):8Ar""" >>> import io< io.BytesIO(b"1234\n56"))6R@LATraceback (most reccall last"..ValueError: invalideral for() with base 10: b'!L' 2s =,nl(f, deq=False,rpquotes)# There's a hzATrue$= !if s == b"00"qreturn .'el*1*a;oint(s)Olong u<  P@`5678909 9L\nI ,o\Q[-1:]6'L' as[:-1]m ^ LC = AwDescriptor(:h kname='B/',.=UP_TO_NEWLINE'f0er= 3inewline-terminat;DegerO}This never haPtrail6'L'+1intS/fi}MQin a p Python" o~Pbox wM<opickle?Nwas written -- but8no guarantee it will W!iso0nl_o n@mnldkXjiated decimal integer literal. This has a trailing 'L', and can representVsMof any size.& """) def read_floatnl(f):5Ar""" >>> import io 4 io.BytesIO(b"-1.25\n6")). R2s =t`stringu, decode=False, rpquotesLqreturn Q(s) nl = ArgumentDescriptor(uscname='2,',=UP_TO_NEWLINE0er=+ # doc="""A newline-terminatedBimal`In gen0 trequires 17 significant digits for roundtripidentityFApickXuthen uninfinities, NaNs/ Kminus zero doesn't work across box>or on some[ evenJ on itself (e.g., Windows!'tA thengs it produce1 or)d8 1uctPraw =uct.pack(">d", '3b'\xbf\xf4\x00'(4}'8(Hr+ b"\n"H@data = f."(8pif len(b) == 8?7_un)1[0]Rraise ValueError("not enough *0 inbeam toR8N 8;n=8\ ~ !|n 8-byte binary8`ation , big-endian0TheYmat is uniqueaPython  shared with1jmodule (forL>d') "in8cory" (1ucteHPimple@s doH =0 -- y should). It'8pstrongll to5 IEEE-754 doubl,nl0cas is!Rfact t0cal0f ] On other=>dynamic range@limiP"at:754 "add a halrd chop"40sed reg J`precis?to 53 bits. However,a 754 box,  0infinities, NaNs, and minus zero may not be handled correctly G(+survive roundtrip pickling intact).:""") # Protocol 2 formats from@e import decode_long def readQ1(f):\Ar""" 4>>>8%io2io.BytesIO(b"\x00"))(0@.X2\xff6?2558$7fn_32767: 00v:O-25698-t8;. 2n =O@uintOdata = f. "(n pif len(b) != nz raise ValueError("Cpenough 1 in stream toq "1"[hreturng! & = ArgumentDescriptor(aname="&"",=TAKEN_FROM_ARGUMENT10er=@doc="""A binary, little-endian, us1-byte size. pThis firstas one %as an unsigned4c, then)AthatCAmany31d5perprets. m H 2's-compled If4lP is 0qat's takenKshortcutu.?2 0LBdg4g,4(g25EDQF]EiO 0 0int3if n < 0 4Xa count0s %d" % P444 4 representation of aL Afour`sY@ (buQquire8be >= 0)   E If the siz#e is 0, that's taken as a shortcut for the int.although LONG1'uld really be usedF'then instead (and in any case where # of bytes < 256).;""") #: # Object descriptors. The stack1 bypickle machine holds o@Ss, # =q_beforeafter attribuof OpcodeInfo # we need names to!bevarious types3@ canppear on2. class S(;!):i__slots__ = (#h* record,info only3'5', #Dq , G@upleN (meaning.#W!of<9itN)r0'ob human-readable docsthis kind-;VtringYQdoc',)def __init__(self,2", ,hbassert isPance(.V, strG.! =Mj?g)Y[ (if % kcontaine- %)7, H# =& ?docPdoc =]<Creprtureturn VP py= pylong =S='intB=intdoc="A PythoSteger9.c_or_boolf % n(o =)v r$:ean9v oh ]_float^ _` @str sp:1 w(D~:@(Uni)'* yrB^_array #fj ^unicode = StackObject( name='str',obtype=strdoc="A Python (Unicode) string obK.") pynone = StackOdb"None"Uej()l4Then bOtuplc d2_, ^Olist \[ Z?dicZ ZZ Z/seY:setX?setWE `frozen#b. obuffert' .X-likeg2any4h?anye ny kind of\ whatsoeverOmarkh "$ 0-0""'/' is a uniqu@ Ops that operate on a variable numbers generally don't embed the count+1 inog, or pull i%fs. InsteaGRMARK 4used to push a special #OA, anJn some oth)s grab allkas fromutop of L down to (but not including)1Cmost Q@. ""Oslico$$An;representDa contiguous socd ThisPconjunction with,_. Mp followw)5top@. For example,OHPOP_`change|!e  @Y[...,"E] to%] No matter how many !ar?0 af' E%, qgets ri)5m ( DT too)#: # Descriptors fKSickle)s. class RInfo("):U__slots__ = S# symbolic*;ln,'name',  # the code used in a bytestream to represent+ op-S; a # one-character string'05', G# IfK has an argumfbembeddUG, anHinstance of A?Descriptor specifying its type. Note thatIarg.reader(s) can bad and deGfromI>sd.doc docsD`format67rawH`;s. 3doesn't have<K!innI,p shouldUNone.1J'arg2whastack looks like beforM2is  runs; a lisa':_/] afM/th\. [Vprotocol numberhwhich Xwas introduced;Q'inE \`human-3@ableXs forW Qdoc',k) def __init__(self, name,/kN", !, ,!):h2assert is0(dEstr)%}.! =?y?d@len(j) == 1]! = ]parg is 8 orOarg, @= Z*,Fx%C@x, SfObjectMLI# =}FW $0H cAint)B0 <=x ickle.HIGHEST_PROTOCOL C 6l ;doch[L=q I = ORInfo Rs = [X`# WaysPspellbegers.I S='INT 5='Iarg=decimalnl_short:=[]Jp=[pyintt_or_bool'$=06doc="""Push66P TheI4a newline-terminate literal?D The inte0nt may have been that this always fit in a short Python int,  but INT can be generated6pickles written oI64-bit boxnGrequire acBlong1$321. The differenc"tw#isJand LONG then isfskips a trailing 'L', 0pproduceKint whenever possible. xAnotheris due tou,= bool was6hcd as aGdistinct type62.3, builtin names TrueFalse we*lso added toL2.2.2, mapp tot1s 1<0. For compatibilityqboth directionsuRgets + "I01\\n">!ase0.@Lead@zeroc3re RPfor a;0uinSteger32.3H(later) unrs special-cases*breturn}instead;IxearlierEQignor?# l1"0"7I!thR"""),  I(='BININT'?ucode='Jarg=int4 stack_before=[]after=[pyinttproto=1* doc="""Push a four-byte signG:pis handfull range ofw()8s?Cbox,/ lypbinary }Ps (1 a opE4!in)I Ifpnon-negativ0fit=r 1 or 2h,X$viK' `2 save$4acer15='KEuint|<2one/un  space optimiza\ery small J5int"inE(2562M2binaryFconversion). Pw 2 added linear-t(in C; stillJ#in, ) 1Z 4 opcodes.*R"""),I(name="($1".t='\x8a'@arg=1stack_before=[]after=[pyintT2*TLM0 usOone-byte lengthA more efficient encod2f*;%says it all. 4 b 4 H_found 64 0# W$to spell strings (8-bit, not Uni%)Gu'STRING,#5='SEN/nl?s_or_strQ8os objectG` argumF!isDpr-style,pbrackete qu9charactersperhaps emberescapesl1extQuntilCnext0new c>se are usual]eWd str instancF!Sgiven# Ubr constructor. ortdefault'ASCII'. If TQwas '' however,(0y wbd1as .?eadO'BINXTXWW r5two s:` first%3a 4ittle-endiaVQsigne@ givwD`secondj|Bmanysq, whichNnly as the string  'content. These are usually decoded into a str instanc$ing the Fp encodgiven to Unpickler constructor. ordefault,C'ASCII'. If Twas 'bytes' however,(y will b1as .q objectCead.oa"""), I(name='SHORT_BINSTRING'5='Uarg=string1#stack_before=[]after=[pyu_or_str$eproto=Jdoc="""Push a Python|].rtwo arguments: first is a 1-yr unsignq giving 0number of6!inR, andPecondXthat manyEds, whichHtaken literP"asB: zIzF?the zB1zH0# B! ( Qcol 3prhigher)BINBYTESB4 3Cf_4little-endian?>  O,$ C"X!w qQ  'x8cE\x8e8v'>?2n 8ENaken literal ly as the string content. a"""), # Bytearray (protocol 5 and higher))I(name='BYTEARRAY8',B code='\x96Targ=bY8)stack_before=[]after=[py8!$=50doc="""Push a Python 6 object. There are two arguments: !first is an 8-E unsigned int givingRnumber ofrAs inH:F,;*`second\that many4Rwhichaken literalU Out-of-bobufferNEXT_BUFFER7DNone >n o}READONLY "py*@Make6 read-only.# Ways to spell YENONE}N EnoneM0M" obools, start`Qwith Y 2. See INT for how this wasGr# done 5\EWTRU?\x8_5ool.=2 True ontoC OFALS9,^OFals i0UniLstlUNICODVuBR$nl6= R0, #may be pure-text, but it's a later additionF!    ca raw--escape encodZof a Qk0so [ain embedded Gsequences.xbextend q untilgnext newline characterSHORT_BINDE', code='\x8c', arg=unicodestring1stack_before=[]after=[py<tproto=4.doc="""Push a Python Up q object. :There are two arguments: the first is a 1-byte little-endian signed int q giving<number of 9As in. The secondathat many44, ae UTF-8 encodc!ofO .>R"""),I(name='BINUNICODE5='X Y)I4?uns8E\x8d 8)H?n 8# Ways to spell floatsC`UFLOATF7/nl5 0C Newline-terminated decimaCeral{}qrepr(a_l)uPn gen6 requires 17dificandigits for roundtrip conversion6be an identity (thisw so7IEEE-754 double preciBvalues, which8w,@ mapKon most boxes)I!,  cannot be usedtransport infinitizNaNs, or`minus zero acrossj (or even on a single2, iplatform CJplibraryq't read$s it produceasuch things -- WindowsLis like JP), buPy do less damagRn BIN onses withHwgreateror dynamic ranE { """), I(name='BINFLOAT', ucode='Garg=float8"stack_before=[]after=[py4tproto=1,doc="""FX stored in binary form, with 8 bytes of data. !This generally requires less than half the spaceA encoding.J$InH$, " cannot be used to transport infinities, NaNs, orLminus zero, raises an exception iexponent ed`e rangKan IEEE-754 double, and retains no morea53 bit&`precism3(ifLthere are3that, "add a,^chop" roun#4 isJcut it back53 significant)XR"""),`# Ways1build listsEMPTY_LIS]DNoneEm APushAmpty.eAPPEND$a$ pyuyobject3'202`AppendKUal0 S r: ... 3 an*(: *%+[+]WalthoughMQis re}aextendo-place IS:JeJBmark!, DUslice;_W E Ja by a S7N of rftq;Rlnf$ Be0out^rtopmost/y!,  0R Allentries followingR?j#toa single PythonJt, which?1 reCSs allI_ fromonward. For example! O1 2 3 'abc'n /[1, 2, 3,(]) Ways to build tuples. I(name='EMPTY_TUPLE', code=')arg=None stack_before=[]after=[pyotproto=1,doc="Push an emptyJ."),tmarkobject, Uslice_ 0""Build a out of the topmostg h!, [ |Q All6 entries followingR? are placed intoa single Pythont, which 1 reESs allKOfromonward. For example0 S W: ... 1 2 3 'abc'n/%!: /(1, 2, 3,())/""1E\x85 2any2Cone-bPitem "heAThism pops one value ofUand pushesyflength 1 whoseCpsis thatPback onto it. In otherDbwords:v b[-1] =N(_[-1:] 26/, :?two0 tw em|.s2stP$ 2:[{S2:])]837=?hreP t ES0eV3B33# Ways to bxOdictEDICT}', arg=Naone, stack_before=[]after=[pydicttproto=1+doc="Push an empty /Q."), eI(name='DICT'6ucode='d_arg=Nmarkobject, Uslice_ 0x""Build a out of the topmoste f!, Y .Q All6 entries followingR? are placed into% a single Pythont, whichX 1 reCSs allIOfromonward. The alternatesLkey, value, .... For example0 SQ Q : '1 2 3 'abc'a/b!: /{1: 2, 3:(})-""QuSETITEMDTsT R, anyS Z( AdXAkey+7 pair to@xistE1q|*,*0whe[ has been modified via [r[key] =^._bSScuc$ m!""en arbitrary number zs{ J9; is taken a(%an<sequenceXkeys andms, addedr immediately under. Everythk!at]1Mwis popped, leav=qmutatedp0 atDH"_1!_1Skey_nn`;%_i_i for i ik 1,X`..., n~ that orderQ# WayCb0BsetslEMPTY_SEO\x8f%l,ses4 s>setr0ADD! code='\qx90', arg=Nonestack_before=[pyset, markobject, !jslice]4Safter3tproto=4*doc="""Add an arbitrary number of items to existing set. AThe .t p follow-wtopmost is taken asJa sequenceKyp, addedGset immediately under aJ . Everythqat and 7 dpopped$@leav=gpmutated4 atCSq: ...  mQtem_1#_n<': <uSwhereOhas been modified viaQ.add(YAi) =_i for i ilP1, 2,A, n, in that order.R"""),P# Waybuild frozensetsI(name='FROZENSETcode='\x91  BaD outJ,,1All entriesalaced into]a single Pythont, which @ repMSs allL'ofAfrom onward. For example" :S1 2 3o))"({\33})- E:manipulation]A5POP(;(2any! _%=[0tDiscard6a<, shrinkTq by one!.#,DU2   OPushQ ontoagain, duplica.itEMARK( }q^ !"". B es a unique7a, used thpidentify adregion containa variable5|mK to work on. See markobj ect.doc for more detail. a"""), I(name='POP_MARK', code='1arg=None stack_before=[markobject, jslice]-uafter=[tproto=1%doc="""Pop all theK Ys at and abovetopmost ~. When an op using a variable number ofdGis d is used to rem4ose,eSthat delimitK@heir rtposition onG# Memo manipula3. There are really only two oper&Rs (geCBput)w# each int-text, "short binary"T"long flavorsnD5GET/v5='g?decimalnl_a J_42any=0E=AReadQ fromMm3={push iteThe index7y=s given by[newline-terminatedN@ strfollowing. BINGET4TLONG_re space-optimizLversions~DqhEuinto`Xw Ewg1-byte unsign(integer mz&6j64h646little-endian D,PUp<! St@ topo^not popped51loc0@writ toCa *PU#reG  PUT', codeq='q', arg=uint1stack_before=[]Waftereproto=<doc="""Store the M top intomemo. Tis not popped. index of8 location to writeXis given by,c1-byteJunsigned+eger following."R"""),yI(name='LONG_BINPUT+ucode='r;4$;4;little-endianIuMEMOIZE5EE\x94HONoneGanyobjectasnumber ofgelements currently present in2.r# AccesV`extensregistry (predefi,ps). AkWv1GETX# familyhEEXT1%82&2Ez"0is A andsimilar EXT2`EXT4 a using a  =@popu6 that are pickled5, typically classes!It is enviye at through a global negoti3and0pro, third parties can set up a mappsbetweenGi:  s-In orderguaranterchangeability%e Kcm y tP#be`, althiO`6Ss mayF0be rved for private usepr has a @argu&# isx usr"o In,~*aeOis pushed Gv m='\x83B ,0See01. 2K1twoM """),  I(name='EXT4',  code='\x8arg=int4#stack_before=[]after=[anyobjecttproto=2.doc="""Extensiony#. See EXT1. 4 has a four-byte integer argument.8R"""),E# Push a class , or module function, on the , via its'Y`# and .;kGLOBAL=c:stringnl_noescape_pairtL$0ELcglobal1 (mi.attr) Two newline-terminated s follow"0 op&. The first is) taken z7,AeRecond!WLI. is pushed More accurately, Hreturned by self.find_W#,*)fI, so unpickling subDes can override thi:rm of lookupGbSTACK_^=d%93PDNone>Ppyuni6%, + R%D Ways to builds8Le doesn't know about directly# (user-defi?). I desVW1doctHpcompreh|bly -- you really have@readJ \3 toGAA all"special casesZeREDUCEF5='R IC T'n`t from,qallable%an`c tuple-d0@mind__reduce__() methodASC Ct: ... cz!pyle" )): )#(**)G"0 artwo items wVby a r Apply[e!to1argssuppose0pro,eoriginat least get itDrted9!If: "!3- lKonent is an argument to be passed the object's __setstate__, and then REDUCE opcode is followed by to create KC's a~TaKcBUILD Qto apply %atG#. =If not isinstance(callable, type), complains unlessE3 has been registered with, copyreg module's= safe_constructors dict, or6\sa magic:1'__= for_unpickling__' attribute~a true value. I'mCsureKwhy it doeis, but I've & sEthist often enough whenLI didn't wa.s.R"""),I(name='#',!5='barg=None stack_before=[any} ]+Wafter*tproto=0. doc="""Finish building anZ, viaX!oru updateVS e: ... +*: +% \'reBmay havek munDd, aL$s::!IfD!Bs methodh.*()\ UalledAElsep,P must-a&,S1V%`dV2.__C.*(/ vEINSTeuiustringnl_noescape_pair. Bmark!, Uslicej_B a class oTi!e col 0 version ofs1's OBJ%]two newline-terminated as, giv0, jcGLOBAL ($se|for more details about that). self.find_i(z , q)Cis u5get:8In addition, all2s ostopmostl are gath inP tupld popped (along$thT N)>STUPLE=0Now3get icfo!se` + Thgis empty ( was at the top of the stack $atUrt). -+ The class object does not have a __getinitargs__ attributeGthen we want to create an old-stylc instance without invoking`its __m__() method (pickle has waffled on this over`years;LxcallingPis current wisdom). IJPcase,#ofK Sdummy3Qd:d 0try rebind itsI!__kF(sdesiredYfsucceeds,J3Fnew tis push" we're don`Else (Margtuple iempty, it' 1oLH ),8S code@firssists th [Vsafe_for_un(Sing__I Unlike as f/__< check in REDUCEin't matter wheth&isa true or fadPvalueOConlyGsHQit exB(XXXZA bugF5, UPErroreraised ]H&\)B Bobtained from INST's argumentssapplied @_`result J bNOTE: Tw/@awayPython 2.3.hIdistinction betweexand new!es"J{make senseusR"""),I(name='OBJ'I5='oarg=None I_before=[markn\y %jslice]8after=[an+tproto=1.doc="""Build aTi!e Acol 1 versF&of10'sH0 op4d iZvery much Ait. major differezmQ akfz@Allownbe retrievCmemoH0repdly if several3s o^$am3are:d caOmore effici(in both time and space) than repeatedly 'embedding the module and class names in INST opcodes. =aUnlike, OBJ takes no arguments from\= stream. InsteadK~sobject isNQn off@ stack, immediately aboveEopmost markG:S> before: ...%1 gSsliceU:qafter: :new_instance_7gcAs forremainder o#issgathered into anOq tuple,@then logic seems identical,K`exceptt__safe_for_unpickling__ checktdone (XXX this a bug). Segory detailPNOTE: Python 2.3,,6are =0how gee o. That was always2/Bent; @mpleTationZhad diverged1acc4al reasons.:R"""), I(='NEWOBJ'\ e='\x81arg=None#N_wR=[any ]+h*tproto=2.doc="""Build"X 2The should b8Poughtas contain alZfollowed bypS (the beDF0top>@Callss Aargs0ey kpoppedFZvalue return`cls.___(cls, *X)@push%3ackGoWH5_EX%92&4 keywordCdictv$ # J#M 6#U, *kw, -/ (# Machine?3rolx1UPROTO)<%80<Tuint11P*col version indicator. 0For protocol 2 and above, a pickle must start with this opcode.FThe argument is theVversion, an i n range(2, 256).ER"""),I(name='STOP', q5='.arg=None stack_before=[anyobject] uafter=[$=0%doc="""Stop!uning machine;TEvery%Nends 1 atRZ!of is popped(rd that'Iresult of .ZA should beKPemptyan[`# FramssupportsUFRAMEdtE\x95wTuint83xYo4<oIep beginnof a new framyT er may us; to safely prefetch data from its)punderlykostream0@WaysRBdealp st;IDsAePERSID/B?stringnl_noescapK@Pushs~identified byU e module doesn't define what> means. _line-terminated str-style (no embedded Ss, nopbracketquote characters)Fing, which *is* "" =Ppasseg#isHVself._load(). Whatever[ returnspushed on reno imple-TationN-f t in Python'srer: it0be lM subclassg3BINQl&1n"CLikeyr, excepgK0 IDw^7 of| (instead befaiR byte3TpLvadUVX RGX$Se for more detail """), ] del% I # Verify uniqueness of .name and .code members. 2i = {}  for i, d in enumerate(op%s): if dZ2in J raise ValueError("repeated+ %r at indices %dQ%d" %\C (o,B22i[a], i))6/2i+%< ,  A = i'0C delP,? #: # Build aop dict, mapping  characters to OInfo records. # Also ensure we've got the ss stuff as pickle.py, although& # introspection here isBey. "opsKAop[dQ] = dKPd de}__consistency(verbose=False): Dpy =b.copy(]~\N.__all__if not re.match("[A-Z]0-9_]+$"B33if Kprint("ski%r: it doesn't look lik1" %MIcontinueC = getattr(+isinstance(=, bytes) or lenj) != 1 vG[% ""(,0)7- 80.de("latin-1"e'if`*A`"check!w/ > )d6py[]!OE 7Q.py usesZ@"butYWre usg,;D- Sp# Forgeis one. Any left over$7end are a problem#a different kind.  del copy[picklecode] u else:raise ValueError("8.py appears to have a 0 opWy with "OS "name %r and 6%r, but we don't" %C (C,|C!))1!ifmsg = ["we cs thatPqdoesn't&:".1fora, d inm.items()u@msg.-@nd("! %r" % (d.,V0\n".join(msg)) assure__consistency()  ? #:C # A;"generator. def _genops(data, yield_end_pos=False>if isinstance.bytes_types& Jp = io.B !IO.$) qhasattr, "tell"?getpos = H.9 %lambda: Nonebwhile Tru<Q5(ifread(16=2op.get(1!.d("latin-1"$ifg!is zde == b""ZC exhausted before seeing STOP"D (ZTosition %s,%r unknown{A#"<0`>" if j,FYHS.arg P 0=d^%K.e{7*if ia, arg, N;:'.'wcassertx7''BRbreak5SB"""Ge all theUs'&.='<'ta file-like object, or stringPntainT9GCEachfe Xed, fromdcurrena:Pstopphqafter a_s delivered. A tripleiA for4e:B HAan ODInfo record, describ7!If has an argum(ent embedded in the pickle, arg is its decoded valus a Python object. IfB op/ doesn't have anQQument[Lis None. >0 habtell() method, pos wasf3 of.+Jbefore reading.@currnimSbytes,Iit's wrapp 0a B$$IO&A and`latter's result isHused. Else (e #<,U{not obvious howLto queryposition)#X1"""8return _genops(O) #:C # A optimizer. defA(p):#'O"$ a40strby remov un?R PUT !s'>put = 'PUT!ge#GEoldids = set() #91allV"id2new1"{}*1tby a GES = []9# (op, idx) or (pos, end_pos):proto = 0header = b'3for? G, yield_cS=Truep"if34R.name!;.add(arg5 s.bnd((pu)'0eli] == 'MEMOIZE'jidx = len(tEl@ &C'FRAME' 2pasY6G4 !>  P# =. xq[arg] =  /geq\PROTOof 9arg!ifYO== 0cp[pos:~]F;elsi  ! =9Bdel Yda# Copy> except a PUTS without a corresponF1GETS= io. (q# Write[z any framinZPout.w2(-K 1._P0r(ol0*=F>= 47 r.per.start_ ing() idx = 0 for op, arg in opcodes: rameless = Falseif op is put04!ifO0notSWnewidR"vcontinuQdata = pickler.put(idx)u$Q[arg] = idxidx += 1%el+ge oGget(^wJelse:@[op:of5@len(-5) > r._FRAME_SIZE_TARGETF*qcommit_q(force= 5if  Ofile_writew: .qQr.endBing( return out.getvalue() #: # A symbolic_ disassembBP def(,=None, memo indentlevel=4, annotate=0)I"""Produce aqjcy of a!. Q'r'$ a t -like object, or string, aining a (at least oneMJc. TheeVed from the current position, through"first STOP encountered Op<!alO'out to which|Ay isqprinted. It defaults6psys.std"1 stPython di7qused aso!'sbsmay be muAd byW), if7vPs PUT1BIN .K@Pass7AsamejranotheraP callbn allowsyOto procecross multiplpat wereDq createIRr witz . Ordinarily you don't nuorry about this|`number`blanksX"o 1a new MARK Q 4tu'`nonzerXastructK!()sdd shortnadescri on each line ed2putU` givend'@mustN0an pger andaAhintOcolumn whN0ionuld startD@is 0a$no4ionaIn adddy, some sanity checks are mad&e: + All embedded opcode arguments "make sense".3Explicit and im pop operations have enough items on the stackLtWhen anzN ly refers to a markobject,1 is actuallyfA memo entry isn't_ enced before it's defined7The~<stored i[0jUs2"""I# Most ofphair he s for sanity checks, but m0it is needed# anyway.detect wY protocol 0 POP takes a MARK of{Ha(which6urngZbindent<blocks correctly)LP = []# crude emulunpickler"ifis None:DcP = {} ? R /<1maxU = -1<6max@numb3een3,rka# byteBposi"of 4"chunk = ' ' * Qlevelaerrormsg =1ann = Atateolumn hint_6&~,P, posrgenops(`)F"if"Qs not}print("%5d:" %,, end=' ', file=out)0line = "%-4s %s%s6b(repr(.3)[1:-1],7';`* len()< nGnameDmax(,l.)={_t do9 mu7kafter 6/# 7Pnumto3=gP# SeeDtherPshoulP poppc!  TQ;hD or 5 == "POP"A.@[-1]Phaassert 1in N if __debug__I)-v\slicewN=%V.pop(cp-  R!"(at unknow1offset)"@7elsA markmsg = "(MARK at %d)" % markpos # Pop everything3and after the topmostB}object.Fwhile stack[-1] is no3:31m.pop()  # Stop lacode from popptoo much?try numtopop = before.index(7except ValueError[assert op.name == "POP"0!Nelsecez A"no exists on%" R# Check for correct memo usage;)ifin ("PUT", "BIN VLONG_MEMOIZE") K* )_idx = len(5(as0emo;P>4argINone9=~Ri = arg!if7!in "L key %r already defined `AelifM[ # empty -- can't store into xa:Vo ]41 in8 j([C2] =hA$GE {j)11 = `[arg]]! #G0betL emulationEPhas n@ beeAored*] ify1 or:msg# make a mild effort to alignFZument+line += ' ' * (10 -) 8V+ repr(argH\ @' knnotat7w* (annocol 1 d:ion3WW!zN> 50A @R + opcode.doc.split('\n', 1)[0] print(line, file=out) if errormsg:;$# Note that we delayed complaining until the offendkopcodeJAwas 9ed.raise ValueE(q# Emulae stack effectsMqif len() < numtopop o "tries to pop %d items fromjiwith " U"only>T" % (,%))G/if2dely$[-C:if markobject in afterhassert(!no,ZbeforM3.append(posz0extk ("highest protocol among s =", max|<"if Rempty STOP: %rg") # For use doctest, simply as an examplr a clasrickle. "_E%def __init__(self, v)." =p _dis_ = r""" >>> import pox = [1, 2, (3, 4), {b'abc': "def"}](cpkl0 =:.dumps(x, 0)@dis("^@0: (AMARKo@1: l@LIST@ (!0 atF@2: p$PU"! 0@@5: I%IN1@8: aaAPPEND9,2-12,+13#14=Tm3A74P20: t6PTUPLE !13.21-24+25R26: dXT DIC H"25e7eP30: cA`GLOBAL 0 '_-Pcs en '.46A+49Q50: VH UNICODBK#55K%6/58>alatin16 A5^/69w !49#706AP73: RZaREDUCE4,771def886P85: sbqSETITEM6Q87: .'OTOP  0 Try again a "binary" Opkl111&P 0: ]`EMPTY_P 1: q4BIN@3: ( MARK 4: KpBININT1 162@8: (+AMARK92S3!/11!4!@3: t:RTUPLE (ga at 8)+B4: q BINPUTQ16: } EMPTY_DICT878T19: c8aGLOBAL'_codecs en 'I/35I/37 Q38: XPBINUNICODE 'abcW'46W($4F alatin1I/59I5/61m!37n'62M6I@4: RaREDUCE!77 1def7>8>P77: snqSETITEM@8: epAPPENDS <3P79: .STOP highest protocol among op4s = 1 Exercise the INST/OBJ/BUILD family. >>> import pickletools Bdis(T.dump !.dis, 0)# 0~:-A dis P17: p@ 0/200Hfrom_ExampleTx = [(42)] * 2 x,P 1: l2LIS% 0 2/ 5$copy_reg _reconstructor,.30J(#33#34[\#56\2PP_builtin__ objectM MTP82: N1NONe82.3#84O#87.88,2+91/P92: db !91.93R;P96: V5 'value/108?`106: I8$IN> 4s31101xb. 112: a%@3: g%GES1M ,7d!$1]}*s jconstructor' 29: q aBINPUT 1Q31: (q MARKD2: c`GLOBAL  'pickletools _Example'6'54h,l2!6W__builtin__ objectU/76U3UP78: NnANONED9: tPTUPLE 0 (p at 31),'80f4B2: R8q REDUC`/83454D5: }4EMPTY_DICTl6D8: X8BINUNICODE 'valug/98x7 100: K@@INT14`102: sqSETITEM6@3: bQBUILD@4: hRBINGE8`106: epAPPENDS ZY`107: .8STOP highest protocol among opcodes = 1 Try "the canonical" recursive- test. >>> L = [] aT = L, L.append(T)[0] is T TrueTLNL[0])?Bdis( .dumps(L, 0)3 0TfP 1: l2LISH08@2: p#A 0@5Q@6: g*.5n.10nP13: aY/140#1#]dh)3.63# 7Jn. 901 Note that, in "0 :1 ofq tuple, disassembler has to emulaWpe stack[PorderbrealizuC3POP]16 gets ridy0M T :' 2 t# 3 67 6/11~e@5: 00POP*161k2XZ5T, Z: ( MARK 1: ]EMPTY_LIST @2: q`BINPUT ! 0A4: (q MARKD5: hXBINGE6@7: tRTUPLE (Fa at 4)L8~1R10: a7 APPENDD1: 1APOP_S% [0[#12W@4: .@STOP highest protocol among opcodes = 1 Try 2. >>> dis(pickle.dumps(L, 2){ 0: \x80 PROTOk0 2# 2 3 k7b!5 [ KEG C2T00POP523 with annotations:=43),*?e=1;43 Pversion indicator.W` Pus empty list-m Store the stack top intomemo. Tis not poppedV Read an object fromQ` and pQit on|P  Build a one-tuple out of=topmost itemQ - \XAppenFto aD11: 2 Discard, shrinking&0 by2(1'S'!unmachine.L2 """ _R _tx0= rRqimport X'e !iof = io.BytesIO()3p =2!.P0r(fx = [1, 2, 3]p#(x= f.seek(0) 0,Q = {}0f, =&jD6: KwaBININT{10: K BININT1 3 12: epAPPENDS (MARK at 5)'@3: .)STOP highest protocol among opcodes = 2 >>> dis(f, memo=J4: \x80 PROTOS1 2c@6: h`BINGET ! 08|""" __test__ = {'disassemblerq': _dis ,eo ,%1 2q} def &1():Mimport docdreturn.mod() if __name= "__main__"LargparseM Dr = .ArgumentP$!r(&description= one or more pickle files' bc.add_a[U'1_1', type=FileType('br')+nargs='*', help='thzy-o', '--output', default=sys.stdoutwp where [ should be writtenm+R', acystore_true'preserve' between;i"-lzindentleve4 {l} <=="&"if+Athan<4 is specified, print this before''y0'--5Vrun self3o suitejv`verbosely; only affectsx$ru6$ =V]X"s(E ifsS>Felse T= 30 >-<G 2notbO&!r._elif len(.Cj) == 1I (B[0],^f, Nonede8pd$, ($ rm}C)h fo r f in args.pickle_file: preamble =-.format(name=f.)=_output.write(On+ '\n'3bdis(f,l:c, memo:indentlevel, annotate) """Conversion pipeline templates. The problem: -- Suppose you have some data thatwant to cg another  , such as from GIF image<9PPM. Maybe the Y involves several steps (e.g.ing it through compress or uuencode). S of^^Mmay requiraNeir input is a disk !, s 4@be ato read standard:; simila0 thS0. ` pthe entbqalso be_ L2 or`san open8andzS its xmodule letsconstruct aR / by sticki0oneYNmoreF@toge. It will take care of creatFand remov Qorary1s i y 5`necess`to holYtermediate . You can@n us_dmany different sources. destinations  syd;each timi-M=objects so"an7sD 6tAthem@ dic@ary,D0 ince. DiresD ToaBSt = TT!()*\add aT <t.append(command, kind) where  v0str#wo characters:` first)3'-'7 Q0s3!'f/$it;W second likewisCg@mustvalid /bin/sh syntaxX0putvq d,^passed as $IN R$OUT;s,uc possi6in k/o  beginning_t.prea`ile us sts = t.copy(inm,Q 0) I' ( #0mpt ,by5or i0is ften, respCvelyreturn value is the exit status of* conversion pipeline. To open a file for reading or writ through aF: fp = t.L(J, mode) where a'r' tob*Qor 'wpe it -- just like the built-in functo)$Bos.pcreate a new templobject initializeda given one!t2clone() """ # ' import re $os c # we )Vquoterather than*Cmodubackward compat # (="usbe an undocumented but ;is) from shlexO __all__ = ["T?v"] # CLstep kinds FILEIN_OUT = 'ff'70# Mi! &eelWs STDFG-G 5aB0STDA/f- @?@-@eNormalQ@ eleru SOURCEO= '.B be first, s stdout SINKE .Pbe laFZE@in ]", POUT, 2IN_\ , ] class )FQ """CrepresenOa1Q.""" ``def ____(self)Ky%""() returnsOreshU8Kp.debugg1= 0o8t()Ct.__)5 s 1(t)Y4 '< instance, s=%r>' % ., "t.Pstore dto itseZv ] yyb|pwith id5calo2ial! a current 5t =T%()Dt 7[:] $%t$l, flag  R on9off {! =WqcappendrAcmd,L w& @ addnew step at the end."""  if not isinstance(cmd, str):%, raise TypeError('Template.append: cmd must be aBUing')Erif kindo`n stepsgOValuh2badJp%r' % (F.,)i== SOURCEb7 can only0pre*edPself.fs and [-1][1] ?INKalready ends with SINK}![0d1'f're.search(r'\$IN\b',j missing $IN inD?OUT0>OUTo(1)) {Cdef (0 ,AT"""t.'D adds a new at the frontH=IOiJa G,F0EHTbeginJLLAMgN insert(0, QCopenNfile, rwM#p returnLpipe or  object -A forn0eadzor writing;yaile is Pother!1 ofZLline rw;'r'0_r( I;w; w;.]kE: rw,P\'r\'a\'w\',!5%r'  P% (rw#T'_r "t.open_r(file) and t.open_w(fiimplement !X, 'r'7w') respectively."""Aif not self.steps:cpreturn O5r')#'if:[-1][1] == SINKI aise ValueError('Templater: pipeline ends widthIpRcmd =sDmake2*1s.p2cmd! 1def0_w(!, aw} 0VOURCEea wPbeginLt#''s #Ccopy inP, out )casystem1. =)~ ( .k 3-;debuggingSprint(cmdn'set -x; ' + cmdU .My# Build a list with for each command*a[inputname or & string, kindg-]nkA= []o 9K in ..append([q:-R, '']*#K# Make sure there is at least one\+Vcn q'cat', '-- sTspcare ofv '.0out?o[1] =x[":3!ifC![01'f'yb insert(0, eT G : K d-T# Invent temporaryxs to connect stages that need"Egarbage kicrange(1, len()Gl\i2r'][1if ;s(1or 1+NA(fd,1) =0.mk"p((os.close(f2 :[o]v4item in list:  [inf, cmd, kind, outf] = item !if[1] == 'f':"cmd = 'OUT=' + quote(Ip) + '; 5cmd4O0O 'INN?infM-' and infP+ ' <Z MN >N+)O1tem5b#cmdlist = a[0][1]1forz2 in61:]z[B[1:3:!if=[X  ifZV:D= '{!}'! O0|\nJelsed1= a 9if garbagA#rmVrm -f1@file 599Ctrape (<q; exit' 1 2 3 13 14 15GR5+ ' Zadreturn!+ """Utilities to support packages.""" from collections im&namedtuple#functool!singledispatch as simplegeneric H=lib^.utilmachinery&os T.path2sysEtypeModuleType(warnings __all__ = [8R'get_er', 'iters"Bload Tfind_CTwalk_T2DmBbdata',1AImpIdSEImpL`read_codeIpextend_<Info', ] 6 = &('K_!er( ispkg')Ba.__doc!'A% with minimalo about a X.' def _.Rspec(j,F)B"""RBthe !--CificJ r# Worksclegacy8!s.L2try\.R_@# =&..except AttributeError@ =(Z3if -gis Nonkxl1lib._Th,]p [1)~=s(streamx# This helper is needep order PEP 302 emula 1 to# correctly handle compiled files import marshal magic = stream.read(4)2if #!=;lib.util.MAGIC_NUMBER:-`return None]U12) # Skip rest of the headerC?b.load(B ) def walk_packages(path=m, prefix='', onerror)"""Yields ModuleInfo for all ms recursively0on a, or, if 1 is,:accessibleE.'9' should be either; w2 li)s to look{%inQ'a0ing6output onKAfronXSeveryQ nameV2on 0U Note that this function must*q`* (NOTP$!)Dgive5in order( __!__Apattribuo find subV'which gets cal@with argument (tho A`was beM0ed)any excep oc6`le try3%to& W. If noUisupplied, IE&s are caught and ignor%Pwhileq oA7propagat/terminathe searchKExamples:#python can p t)>dCctypn 9.%, b__+'.'w2"""eseen(p, m={}jR in mB2Truqm[p] = iin iter_sPKly; 2U!ifj.ispkg:try0"__a0__(I.F%ifYais notR(P9o EEm8NelseeFrais,: =9S(sys.[TD], 'c!',)r&[]b# don't traversetems we'v@en befor> [p pi"t )wOOfrom,W =''): """Yi elds ModuleInfo for all subms on path, or, if is None,1top-level 8@sys.<!. =' ' should be eitherF yr list o`s to look@Z%inQ`refix'a string6`outputthe fronVSeveryQ nameV2on 0.1""" :importers = iter_!()%elif isinstance(,)Eraise ValueError("&P mustX "'"&se{ = map(get,)yielded = {}Ui in CVSq, ispkg&_Q(i, p!if@ not=}a$[mQ] = 1"s.) @simplegeneric def3=''ot hasattr(1, '.return []8.6("` # Iment a file walker cnormal1libQ hook_Y9_finderoFisdiL` inspect6tryf0os. l7except OSIB# ignore unreadable directories like6Q doesM{.sort() # handle packages befnPsame-djs! fnM0mod3RB.getC2(fn ifY=='__init__'F1in &edb:continue$= Ejoin), {g= FalsF 5andR"g ) 4'.'*fn?E= fn 0dir;ent"l @!G)&= 3' '0sub0 if7 \,True  ebreak  else:continue # not a package -if modname and '.'*$in Xyielded[4U] = 1Li! prefix +E, ispkg iter_impor modules.register(K lib.machinery.FileFinder, _Eafile_f_H) def a"()global impcwith warnings.catch_3.simplefil'ignore', DeprecationWN)`<Pimp =r0ort('imp') class ImpI"""PEP 302  that wraps Python's ">3ic"g algorithmW@(dir) produces a cGcsearchesdirectory. _(NoneOJthe current sys.path, plus any-z are frozen or built-in.BNote'Q doesd`ly supl being used by placement!onPmeta_.2"""lR_init__(self, &= b> ("This emul0S is d?!ed}slated for removal "M 3"in` 3.12; Tm' instead",A 00ort(! =6&`, fulle" # R: we A 'I`' argu since it@onlyed via 0subk% =v.split(".")[-1]*4if -!.r2elf0is pareturn N6 * =6&"[oP.realc):try , R, etcm.$`exceptortError]ImpLoader( )&,3=''k W#QisdirD yRved = {}f2pec,`Zs = os.list|RM/OSI#unreadable Nies likeUfilenames = []  !filenames.sort() # handle packages before same-,d modules F for fn in Q:%0mod; = inspect.getGI(fn)0 ife=='__init__' orlzyieldedjncontinuepath = os. .join(self-, spkg = FalsJeif not5andV`isdir(a ) 1'.',n)fn>try20dirBentsElistx Hexcept OSErrorSP# ignunreadable directories like import doese-[]%(0sub23if ;:d0MTrue!]breakOelseY<#aP  .`[!]] = 1% prefix +0, i class ImpLoade"""PEP 302  that wraps Python's "<4ic"algorithm1"""code = sourc 3NonFDdef `, full,@Fetc)warnings. ("This emulation is deprecatedP!sl wpremoval8 " 3.12; use '@lib'atead", :D{BionW_H(}1! =Y !5! !etc = etctxRload_x {fw_reopen 0mod8mp.WH%, kfinallDmTg.close# Note: we don't set __er__ becawe want the#ule to loormal; i.e. tris just a@per astandardmachinery`returnjget_data9#Qwith , "rb") as7 e3.$()mf _reopen(seclf): if self.file andv.closed+2mod_type =)eetc[2]N#4if &==imp.PY_SOURCEK,{u= open(name, 'r')]'el_S in (bCOMPILED, C_EXTENSIONre vAb') xdef _fix_`, fullZ%if is None48e# !_ Mraise ImportError("Loader for}ule %s cannot handle "lpQ"modu9A" % .ereturn1is_packageF=Ze iqYKG_DIRECTORY|get_cod}=h&WN sEourcfs(= compile(5,, 'execZ W o1_re>try4<FreadJofinallN (?U4 _|delegate().ej/  1YS"%@ile.A_modules, prefix=''pdirlistv&%d(A.L_directory_cache[er.archive]D_`# =2er.plen = len(->yielded = {}1n0 int`for fnAcif not fn.startswithq +/scontinuuf0fn[:].split(os.sep) &!iffn)==2 and fn[1]}d8.py~? if4!0]3in -[fn[0]] = 1'" +`L, Tr>!=1r0modYr(a%=='q>b4'.',y G 3ed[0E%A,c, Fals-s$err`.regisLAer, ,-) exceptortErrorppass g(path_item"""Retrieve a  #the given 3mQThe ru$ed11is dW@sys.4_uh if it was newly created by aiVhook.jW (or part o@) can be cleared manually if ah0res$5of Y0s izcessary.+1"""KpOA [2temh7KeyKM, s) importer = path_hook(path_item) Bsys. mporter_cache.setdefault>3, i%HYbreak^except I3iError: EpassJelse#oq = None*ereturn def i/s(fullname="")S"""Yield finders for the given module 4 g4If E contains a '.',7Guwill beObpackag85ingL, otherwiseG$y @ all registered top levelm(i.e. those on both Pmeta_A and _5s).dis in a $at @ed a2sideffect of invokthis functions$nolySspecified, are produced.1"""i.startswith('.'Smsg = "Relative{!r} not supd".format2 raB(msg if <$eP# Get7aA's _!__0Apkg_=%p.rpartiJ(".")[0]/# =Blib.!_m(M_ath = getattr!4, '!',X.0if :qKz yY1rom|+:T= FlOBget_0er())rloader(1_orB0"""2a "&P" objr 2RRs 1 if(@ can/cund or{I/V5ualready1_, its(if any)z d,order to establishQO )J)'sl '"s[D#ifV0Wif isinstance1, MCType9+ =pO 1/__'n%ifHhfTPN;!._ c -{OB_loader(fullname) def find_loader(fullname): """Find a "!" object for - ,!This is a backwards compatibility wrapper around5importlib.util.spec that converts most failures to I8QErrorHand only returns the p ratherRn e:1"""%if.startswith('.' msg = "Relative module 2 {!r} not suped".formatVjIXraiseQ(msg)2try}(? = ' Zexcept (, Attribute.T, Typ BValu v) as exy!# hack fixes an edance mismatch between pkg# a#1q, whereqlatter 1s oesVRcases/J`previousDdE0a while4ing({}: {})mW  , type(ex), ex)) from exd.!if!$None else extend_path(,YA"""E a package's '. In>`ed usegrto plact`followycode inF__init__.py:Mx (_H__ =(@, __!2__)\Ywill add8 all subdirectories ofv `n sys. /@d af_U".  is1fulE0if AwantS3dis) different p  of a singlUBgicaC<multiple t also look*.pkg files beginn"!* YhZargumentafeaturpsimilarJS*.pthY(see site.py),E \it doesn't@ial-zq lines Rith '!'.F&A irusted a@ce vV0: a<PcheckNfduplicates,1entfd0are+e-, regardles5NPthey 6Qexistumystem. (FL.!If2@inpu th0a lO!(aa2KafrozenSPs) it: nchanged a?modified;qoxed copyM. Items[2ndeW!to6aend. It is assumed that sys.path is a sequence. Items of"0 are not (unicode or 8-bit) strings refer to existing=directoriesIignored. UNiza causeCerrors when used as filenames may, this functionraise anFAxcep(in line with o.isdir() behavior).7A""" !ifisinstance(H, list):#-0# Tcould happen e.g.is called from inside aCfrozen packagReturn the v unchanged irat caser0,s-p_pkg = + ".pkg)! =\[:] # Start!`a copy,\sparent_, _, final_ipp.rpartiQ('.'):if <G6try ssearch_modules[C1]._%!__c;e` (KeyEK, Attribute/# We can't do anything:pd_loade'b@s NoI"hee@Q# pasq dottedu$BHFelseqpfor dir'<@dir, continueW finder = get_importer(dir#!if  erD}#7ions = []if hasattr(k0, ' k_spec'1# =r.+>b01if 7!is%1B.subV_X@locas C# Ist5PEP 420 compliant?/elV7_, "er4  o%;) sR# XXXLstill add duplicate ent!to* oF-insensitive0sys / or[i.th,.J#d()Pright0ng 3subs like zopeQ# It looks2a4d "/00pkg% =B@join+%, n%if( is9(A  lff5pen4 P!OSmsg:  sys.stderr.write("Can't open %s: %s\n" % . (pkgfile, msg))1Yelse:Jnwith ffor line in#'#=*.rstrip('\n'~)aif not1 cp.starts_('#')Acontinue!path.append(`) # DoT`check existence! Hpreturn ; def get_data(package, resource"""Get a from a 1.ZThis is a wr r round the PEP 302 loaders API. TheKargument should beDvname ofx,standard module1matH(foo.bar)c `!incBformcrrelativ|l~, using '/' as2H separatori0pardirectory <Q '..'!isallowed, and nor;brooted2(.q1 ax)me function zpbinary ng, whichYO@ents"thspecified`4For`s loca&ilesystemb have already been imported,trough equival("of@pd = os.V@.dir9(8m#s[r@].__&__>Dpen(Cgjoin(d, 'rb')."()x#If@ can%be d,`it usem q2doe0sup0(),l@n Nops1ed.>2"""# =Elib.util.find_0if WTl_}=/.$if!is/hasattr(,4, ', g# XXX needs tes moE.get1 or' _bootstrap._( if dmod, '(v# Modify  tocompatible  er>Isignature - an "*" Q3 ofL4's pG% =.split('/ .insert(0,T6modCG_ID*Q)B (@) _NAME_PATTERN = None def resolve_name(): """R 0 a  to an object. "It is expected that `-` will be a string in one of the followingHformats, where WVshorthand for a valid Python identifier "dot standsO a literal periodthese pseudo-regexes:aW(.W)*> ":(")?!T@irstmrintendebackward compatibility only. It assumes#fsome part0dotD>^a package,41respI7awithinc=possibly nes`inside other!s.IqBecauseSplace{e stops  hierarchy"rtPcan'tinferred by ins+ion, repeaattemptsaimport mus<dQ this~~be seco&!m,caller makqe division point clear through23pro& ofingle colon:% !to5lef*O2be &edNArighr\K` P. Onlie0nee+41 IfNit ends L:n a moduleLreturnedu@unctP! (which mmU), or raise  ` excep]ValueError - if` is`irecognis1matZIK9#anp failedn it shouldOAhave=Attributya8ure occuwhen traversP ~$ed30getP@desi?global _NAME_PATTERNp*ifd# Lazyto speedupbstartup tim5& r _words = r'(?!\d)(\w+)(\.1)*'H 7 e.8ile(f'^(?P{]&})?C f'>Pcln>: .GqIf you problems, please submit bug reJs/patchesJ2theEP(tracker (http://bugs.P.org)a assigm""lB". #QSStill:P* sup MS-DOS (z_DX ?)'QAmigasqother sX#unK%eda`s runnSN@addi:al Linux di bus@Many!nkose who help ddkH-specificvchecks (in:icular order):j! Charles G Waldman, David Arnold, Gordon McMillBen Darnell,n Jeff Bauer, Cliff Crawford, Ivan Van Laham, Josef=Betancourt, Rand@HoppMKarl Putland7phn Farr|T GregDPuk, JqRossum, Thomas HellPMark R. Levinson, Mark # .Hammond, Bill Tutt, Hans Nowak, Uwe Zessin (OpenVMS support),E0Colin Kong, Trent Mick, Guido van Rossum, Anthony Baxter, SteveGrDower #History:61.0.8 - changed Windows to read version from kernel32.dllG7 - added DEV_NULL6linux_distribution()(5 - fixed Javaallow running the module on Jy5F4nQIronPL&3&normaliza6 ofystem name828Fmore,(p1 - ref\@ttedKmake doc.py happy.0.Qa bited into 2CVS;@0.8.;yDsys.aparserBvarious new access= APIs (p(_@C(), compilerCetc.@0.7. architecture()use sizeof(pointer) where availablUI-HCaldera YL91Asome/WinCE; untabifishe sourc'o6iaequires1.5.2-V006 @"ghVC vms_lib.getsyi() configured)F0.6.@code$@prev 'ud@ -p'@plat8s which ar*nknown notD&itjPwin32hopefully workmWin95,98,NT-bWin2k;KpAdid mpcleanup$rfaces -!KDhaveRIF0.5.@anotFqtype in`MacOS ... should IAQused xPcoffeEeday ;- 5.a few typoshY experimental _;better popeSaaroundos_syscmd}P-- stD100% eleganDfthoughb#return '' instaof 'un$ aX3values (sXP comm: tedEcxjust leavfield emptyPinclu"yslackware eQexcep{handlerto cover up situ.^>Qdon'tEA os. (e.g. Mac) or fail on socket.gethostname(); fixed libc # detection RE 0.5.0 - changed the API Js referring to system commands*syscmd*;Mjadded java_ver@madeA2cmd a private;|@(was-3tem-in previous versions) -- use u*()Hinstead; extenSwin32Tto also retur`zocessorHtype informa910.46Vand modifiM@plat>() output for WinXXLS3.4 - a bug in _follow_symlinksU0.3.3/popen() wd"file"a invocSsmB2 - ParchiQure()Ibsuppor itG1W RECWindows NT9oR0aliv(2removed 'wince' again... oh well./-s4ed  2.cache logicX91 st&at0!to1fun{#s 0 of+ule globalFsq some a: take too lobe run onI im1first release #You can always getdlatestdDthis^4at:@ http://www.egenix.com/s/python/54.py?If that URL should fail, try conthe author. __copyright__ = """ C! (c) 1999-2000, Marc-Andre Lemburg; mailto:mal@lHC-2010, eG Software GmbHN!@ O`PermisPuse, ,NAify,] diJQbute js`1itsJdocument@any purposeGPwitho\ee or royalty is hereby granted,PRproviaQabove_ notice appear0all1iespKBboth =nOFis p  XDg 0or reof, includ-hs you make.2EGENIX.COM SOFTWARE GMBH DISCLAIMS ALL WARRANTIES WITH REGARD TO dETHIS?, INCLUDING;xIMPLIEDCOF MERCHANTABILITY ANDpFITNESSE NO EVENT SH!THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRE CT OR CONSEQUENTIAL DAMAGES5ANY WHATSOEVER RESULTING FROM LOSS OF USE, DATA?PROFITS, WHETHER IN AN ACTION.CONTRACT,INEGLIGENCE=O2TORTIOUS5, ARISING OUTBOUQCONNEVIWITH THEKPERFORMAZ2F THIS SOFTWARE ! """ __version__ = '1.0.8' import collections$os $re %sysubprocesfunctoolBiter& ### Globals & Constants # Helper for comparing two number st s. # Based on the descrip1 ofTPHP's@_Ve(): # http://php.net/manual/en/Cion.w-7`.php =_stages = {S# any not found i is dict, will get 0 assigned='dev': 10'alpha': 20, ' )0bet3Tb': 33Tc': 4 `RC': 5$r5#>,10!ply=p A } 9onent_re = re.ile(r'([0-9]+|[._+-])') def 4`arable3p(Q!):result = []v5;ok.split;Aif vm@in '|'W:tryv = int(v, 10)w9100except ValueErrorV71.geb a.extend((t, v)rreturn ! #Platform specific APIs _libc_searchBb'(_iinit)'?b'| q(GLIBC_O.]+)N*0r'((_\w+)?\.so(?:\.(\d:.]*))?)',VSASCIIA4Up(executI=None, lib='', chunksize=16384): """ Tries to determine`CQ thatVfile rE5(which defaultOs`PythonS@erpr`) is linked against.GRs a tuple %," o5thegiven paramss53casookup failsz0Not `ion ha>timate knowledghow different{6s add symbol< and thusprobablyIonly use9spiled us7gccAThe qis readhascannet  of chunksize bytes. """if not executable:#6try ver = os.confstr('CS_GNU_LIBC_VERSION')A4 # parse 'glibc 2.28' as (A', ' 6parts = ver.split(max *=1*qif len(1j) == 2return tuple* except (AttributeError, Valu !OS)Z# _) or  vHcPavailb|Bpassv = sys.%V = _comparK_versionS if hasattr(os.path, 'real '# Python introduced+.4(); it is usedd# here to work around problems with CygwinWbeing==open symlinks for read,w xU(0b')qfbinary = fd(chunksizeI po0`while libblib =  BBelif5^3 !='#\(']% +(V($c) > V(1^Z.soo(dor V(s  < 4($if{v [-):] != threads?: version = + threads4pos = m.end()return lib,< def _norm_O(, build=''): @""" Normalize theFB and. stringspa singleDa, uOf]t major.minor. (or patchlevel).K1"""l .split('.'"ifNPl.appY&6try!= list(map(str, int, l))7except ValueErrorE= '.'.joinU)B[:3]O.+ _output = re.compile(r'(?:([\w ]+) . 'j` Or'.* @\[.*JdJ\])') # Examples of VER comm: # # Windows 2000: Microsoft3 [V5.00.2195]>0XP:>(XP<j1.2600;oVista:yt6.0.6002]0Not!att""gets locd on different ##s.B`syscmd(system='', release 2 Osupported_plats=('win32', 16 Xdos')Tries to figure ou%OSGused%a tuple &).PIt uskhe "ver" shellfor this which is knownto existsQ3, DOS. XXX Other7o ?uPn casis fails,given paramet80are6d apdefaultf.tif sys.h not in (# Try somecon cmdU im subproces:*in ('verj /c3md ) ginfo =cc.checkHU(cmd,0 fstdin=.DEVNULLE?errF-text=True|7e1(OS,.rCalledP0) a"D#print('C%ed: %s' % kC why-5vcontinu Celse break else: return system, release, version )# Parse the outputpinfo = .strip()m = _ver_,p.match(' if m is not Non = m.groupsd0# Sv trailing dots fromD and7$if[-1] == '.'#% =*H:-1]B B $ =[B# NormalizV/`build Qngs (eliminatadditionalr# zerosZKp= _norm() _WIN32_CLIENT_RELEASES = {z(5, 0): "2000",1#XPctly, 5.2 clientXP 64-bit, but platform.py historicallyX# has always ed it 2003 Server'2h@post!"",#(6TVista116, 7\83P78.1f#10f1-/C} #z name lookup will default toQ#s if necessary oSERVER -E2008Z,'R2Q-126+$20 6 #} def win32_is_iot()e() in ('IoTUAP', 'NanoWindowsCoreHeadlessIoTEdgeOS')pUq2try  `import1regGexcept IVErrorC 6_winreg asA= Apassf  Pcvkey'SOFTWARE\Microsoft\ NT\CurrentV'[Cwith.OpenKeyEx(.HKEY_LOCAL_MACHINE, u)'ke4L reg.QueryValueEx(key, 'EfId')[0u/OSI^UCver(5='' 1csdptype=''b MUCsys BgetwNW}q, csd, |winver = d major, min; = map(int, _syscmd_ver()[2].split('.')) except ValueError:major, minbuild = winver.platform_version orA[:3]D= '{0}.{1}.{2}'.7?at(_!) 9release = (_WIN32_CLIENT_RELEASES.get(AQ)) or==ONone<# getwindows() reflect the compatibility mode Python is# running under, and so=service pack v is only go3Sto beGvalid if:s match.#%ifj2] == *6try 4 csF'SP{__@7DAttributH#if csd[:13#'SP'01' +:B13:]# VER_NT_SERVER = 3getattr(, 'product_type', 3rmXmqA @u  ,`import1regI  6_winreg asA= 2pasFelse> cvkey = r'SOFTWARE\Microsoft\WB NT\CurrentV>'Cwith.OpenKeyEx reg.HKEY_LOCAL_MACHINE, u)+kePpBRQueryx(key, 'T'2)[0;/OSLsreturn #, ,!,  def _mac3b_xml()H fn = '/System/Library/Core&s-b.plist3 if not os.path.exists(fn[yA S1libE Nopen(fn, 'rb'fTpl = ar.load(f=12['P'K@infoB'', B`machin+os.uname().3if  in ('ppcCPower Macintosh'0# Canonical QGH1= '?2PC'Q,~(,= =()< ='p""" GetV$OSh j@rmatWit as tuple (relecase,  versioninfo, machine) with  being a tuple (Gdev_stage, non_release_(5). q(Entries which cannot be determined are set to the paramu valuesKCadefaul.s''. AllejOqtrings.<2"""# First try readr rmation from an XML fileashouldO# alwaysqpresentFp = _mac b_xml()!f 0is QNone:areturn! If that also doesn't work -%, def _java_getprop(name, Q"): '.lang import System6try# = .getProperty^"ifJ is geexcept AttributeError G(0=''"Bndor m =(]), os R""" VN interface for JythonRsP1, v}p "m_$vmH0_veS) andB% aD#osB osX_archV given as2s (4allz$''z2# I{needed API] *D' W`;'.PW33', (5v # =*,a m. Ta7 9 ;< >Kw" # =*0os.'555 %8; > jk$S ###o aliasing def system_ali as(system, release, version): """ Returns - aliased to common=Amarketing names u'for some "s.m0It also does$preorderCof the information in&Ucasesv where it would otherwise cau@onfuy1""";#if == 'SunOS':# Sun's OS$if:W < '5-1TThese#1oldQN4rmz# Modify]& (j" =`#E- 3)A4l =.split('.'Fif l:trymajor = int(l[0]Aexcept ValueErrorA6pas4>lse'h5- 34~q = str(% "'.'.join(l& 6 uolaris'e# XXX Whatever3newe is...Lk &elin ('win32', F16')6P# In S one 6f trickrmWindows'"# bpo-35516: Don't replace Darwin with macOS sinc pu&IA and#R arguments can be different than'0curply runn ### Various ernal helpers def _plat@h(*argsH( a$e /Zin a filecompatible <be.g. "`--machine"w1# F pbC= '-x.strip()q x filter(len,n4s))rCleanup+Bposs obstacleq .0(' t_,% =**/*-*/\\+:*;*"*(*)*r# No ne$report 'unknown'Y 9E, ''FWP'--'s~ remove trail'-' while 1:  cleaned = platform.replace('--', '-') ,U if 12: (UbreakV$ =:Uwhilesp[-1] ==lL: a[:-1] AereturnB def _node(default=''):- """ Helper to determine the 3 name of this machine.h1"""6tryimport socketexcept IVError.C# No,2s..W)G f f.gethost(t-OSpStill not workingw9 follow_symlinks(filepathBIn case c is a 3", C it until a!al62rreached^SP= os.y@.absO8$ is#tQAnormRIKTjoin( 1dirhF ),Jreadp). psyscmd_(target,  Interfacesystem's6command.The function usesQ-b op >[bhave iGAomit: in its output. F#bs. It sJ?#xshould failtif sys.>P('dosvSwin32 16 emscripten# XXX Others too ?s=ubprocesB = _0# "("locale dependent: forshe usagUBe C +#5getistic behaviorenv = dictenviron, LC_ALL='C 2# -b: do!prClines (brief modeQE = s$r.check_0(['R-b', "!],Awstderr=`DEVNULLDrenv=env ( ,rCalledP))& "!if=* a# With,< be mostly ASCII-co3ibla# Decode from Latin-1!prevent Uni d'e]#p. 2('lC') ### Inaabout the used architecture # Default values for#; non-empty strings override the # dBs given as parameters __x = { 'win32': ('', 'WindowsPE'), ,16 5dosPMSDOSi} def(executable=sys.p, bits=~linkage=''): ~""" Queries=# (As to"Python interprIqbinary)ayvarious information.7Returns a tuple (#, ) which containsEe about0the t1andOmat used Ad. Both2Qare r^s&V[that cannot be d0min6 CI)byU presets. If7s i|sizeof(po)C(or long) on version < 1.5.2)X %as?indicator  supported l_The func@ relO on system's "file" comm1o dRxactual work. ThiPavailmost if _all Unix?@plat_s. On some$ Q wher GAdoesaaexist 6he 3?set=_from .bT1"""B# Us) number o* ChingC@elses$as. Ot: im&uc`# =P.calcF('P'|H$( * 8) + 'bit'# Get data '',#'if{0out = _syscmd_3, '9'@R\{' {0 ==XT#LA didC4P anyt; we'll try>tprovidel" #psensibl>2n..f? inV6@b, l07 [3P]7Jif bIb+l+y5= l.FFif 'l'G8in 'shared object' not in fileout3: # Format not supportedreturn bits, linkage a# Bits if '32-bit' in fileoutd> =$#3 el5/645!64563# LB?ELFtw$?u/PE2 # E.g. Windows uses this f!Bw%I%,5PE'CFelse 0)?COF%^5oMS-DOS MS&8# XXX the A.OUT also falls underclass...HBpass$> def _get_machine_win32()# Try toPROCESSOR_* environment variablep# avail0 on XP and later; see# http:// .microsoft.com/kb/888731< 1www.geocities-rick_lively/MANUALS/ENV/MSWIN/RI.HTM# WOW64 procesbAmasknative architecturD(_3os.c.get('f OR_ARCHITEW6432', '') or8RCTURE85A) 2 _P"or@Rmetho+3clsfunc = getattr(cls, f'{sys.plat\}', cls.from_sub)HO(2 ''Ow @2+IDENTIFIER',)btOpenVMSd2try  im= vms_libexcept I4ErrE3/ csid, cpu_number =bsyi('SYI$_CPU', 06O:'Alpha' ifIp>= 128 sW 'VAXU 5"""Fall back`uname -p` , /.check_output!['aU-p'],fwstderr=Q~DEVNULL+text=True).strip(E1(OS', ^cCalled unknown_as_blank(val)@ 'val == '0'val ### Port () interfacec_resulFcollections.namedtsuple( "uname_result_base",system node release version machine")/!): 1"""(A \ that's largely compatible with a4psimple dtq except> 'processor' is1resolved late and cached to avoiblling Uwhen needed.N @functools.P_propertyEdef S(selfV return _unknown_as_blank(_P.get()) M__iter__LFhainpsuper().D) T.,@classmethodmake(cls, ~Rable)T# override factoryqffect length checkP2num_fields ="[. = cls.__new__*5, *S!ifI4W) != e6+ 1msg = f'Expected {.} arguments, got {len(Y%}'rHraise TypeError(msg:^,__getitem_W, keyO3h)[key]A3len=8<%A ^oreduceA", K [:\ R] _1 = None 2():""" Fairly portE interface. R02s aymof strings (s,,,,,identifythe underlplatform.BNotenPunlik Qe os. this also AApossr0 ine at9as an addi"alg entryEntries which cannot be determined are sety#'';`global)if@ is Z/ )># Get someps from Uvbuiltin*RAPI..V6try\# =b=S(Attribut `t = sys.T0= _P/=R$ =SF = '(!if?Aany(#bPavailJv# Try win32_v2 on W ifA== '5'Ocsd, ptype = win32_veWr() machine = or _get__win32() 7!# Try the 'ver' system command available on some9platformsif not (release Bversion):&g#, *#, ' = _syscmd_ver(' # Normalizeto what 91) n%ly return8# (g) tends to.vendor name as well$if== 'Microsoft Windows'xD = '$ /elS'K- n@dt# Undera Vista@4 Server 2008,&# qchangedoutput of@$F. ThC# is no longer printed. This causesR-Eto be misidentified.:8eif '6.0'KzN[:3]M-}1= 'L'rOelse<'u@In c"we still don't know anything useful, we'll to|# help ourselveCQin ('0', ;16'MuL&&C_32bit&<-16<2@[:4]['java|g, vminfo, os0 = 5:\|JV , '.join(X '/>2 = r(2# Sspecific extenL wOpenVMS## Q seemEhaveX{mixed up85 or70g&'He3= '## `0 ~mcvals =n, node,H3# Replace 'unn' values with more port4' _uP_cachresult(*map(_P_as_blank,Y"s)Hr Fcache ### D@irect interfaces to some of the uname() return values def system(): """ R&s:@/OS C, e.g. 'Linux', 'Windows' or 'Java'. H An empty string isBed i cannot be determinedH1"""P.Onodecomputer's network (which may {Qfullylqualified)Roreleas'K)R2.2.0?NT'Rversion  1#3 on degasSomachinv T typeOi386S~processorku(true) )Oamdk+$ Note that many platforms doa`provid#%isA in$PationAcsimply$~2ame as for 5(),F NetBSD do?his@  ### Various APIgqextract@from2.=S_sys__parser = re.yAile(r'([\w.+]+)\s*' # "5s'\(#?([^,]+)'(#buildno"p(?:,\s*Q3 ]*&!, &Odate(:]*))?)?\2\time)`[([^\]@]?',aASCII)[r]" _ironpython QIronP2 0d\.?: \(([\S\))?'(d(.NET F # cQ cove}2.6 and 2.7/26&\(jg[\d.]+=)  ]+A.]+(p\d+-bit)\)' ) _pypycompile(  r'([\w.+]+)\s*' r'\(#?([^,]+),\s*# :/ 1![PyPy [^\]]+\]?') _sys_version_cache = {} def ()=None): """ Returns a parsed R of Python's sys.as tupleBd(name,8, branch, revi, buildno date, compiler)Hreferring to the implementation nF vs number{ |/time as stn1andoKidentificy/.;Note that unlik 2,^rh`6alu=1forkE will always includ^patchlevel (itdefaults:W'.0')The func=ss empty!s  entries^cannot be determineda^@ may(PgivenT an alternative`Y, e.g. ifn was read from a differentEpinterpr1"""Q# GetU e ifG@ is !:=+Q# Try\Bfirsresult =H.get,t 3if :0is v #P if 'Iron@' in&# &\) =A *.startswith(p)b?mQironpO_ !r.' BOelseT/26Vuupraise VeError(8v'failedNp&}: %s' %?Irepr)[,401 = .groups(*fhM"el.platformWjava'1# J;S%k4"if6$A F>, _ if builddate is None: bE= '' compiler = sys.platform !elif "PyPy" in!_version\ # /ncname =5match = _pypy_sysH_parser.!()<1if  raise ValueError("failed to \.e %s" %` IreprG!, R#no z !ti.groups(@r$""hs# CPythonJ?!:?o'K N'NA.', )\[}'"ifH #3 r+ ' ' +p5if hasattW, '_git')R_, branch, revie* FmercurialL0Ry "''# Add the pclevel  aissinga4l =.split('.' if len(l) == 2 l.append('0*m`= '.'.joi:B and cachearesult @ = (!,q  o[B] = ozDturna def p_implementation():`""" Re5s a string identify w C.A,Currently, `follow= 2Ts are]6ied% C; (CiB of !),sr 'Iron' (.NET8J' (Java4s2' (o41"""rY h()[0] i}'4 as'major.minor.5%0Notat unlik eKS@ed vD will always include the patchlevel (it defaults to 0). """return _sys_version()[1] def python_tuple():C! R?qs the P- FA as 0 (major, min3pat)of stringsNote that unlik eCsys.i,}ed valueYwill always includG#().split('.'))5obranch.a identifyingCimplementationR"SFor C4bthis iBSCM - from whichaK5binary was built\ If not available, an empty$s v8Uc V2VBrevipQ#$TG% /'_&3&dF! (#1no,ddate) s< Vw/ number and 2 /:4:6compiler\ 6 used for 5ing ### The Opus Magnum of platforms :-) __cache = {}0(aliased=0, terse=0a single_ aunderls@with@much `ful inpossiblet no more :`outputintendedbe human readp rather]^machine parse& . It may look different on sRCIf "S"Btrue@func Buse (siuvariousat report system namesEAtheik2mon-, e.g. SunOS#beUUed as;Solaris.do_5() is}BASett]` causeeV#toqY onlyabsolute minimum information needed to identify the plat%. """result = _!_cache.get((aliased, terse), None)93if <ais not:`creturn#s# Get uname0andun apply specific cosmetics^#At...%system, node, release, version, machine, processor =($6 ==&9!''u3if ' 2 = _3( )&#if/'Darwin'f#QOS (dr kernelxcmacos_ =._ver()[0]% if(_ = 'macOS ZByWindows%MST, csd, ptype = win32"if  pDOelse@[3csd&elin ('Linux',)`# check for libc vs. g  ,!! =,my o'with'% + == 'Javap, v, vmb, (os_ osos_arch) = java1 orC%5 7(-s b?'onu '/,  rneric handler0! l@bits@nkagitecture.executablE5 P),  [5] =3 ### frjsktop.org os-standard # https://www.2/software/sfd/man/G.html # NAME=value  optional quotes 8(' or "). The regular expression is less # strict than shell lexer, but6t's ok. _os_release_line = re.compile( "^(?P[a-zA-Z0-9_]+)=quote>[\"\']?)value>.* =4)$" ) # unescape five special characters mentioned in the standard G r"\\([\\\$@`])"s/etc takes precedence over /usr/libcandidates = ("?C/os-#D", "7)D chINone def _parse(m1s):b#selds are mqtory fi with well-known defaultsA@in pFice all Linux di buUs ride NAME, ID, and PRETTY_.Ninfo = { A": "V&", IDlmS 7!} >@for s nm}+a.match6)A*Pif mo@not nEnfo[mo.group('h')] = ]MB.sub;vr"\1", E'))preturn >freedesktops(B"""R3Popera system id 2ficWfrom MV.org 1"""iglobalRcache.ifA =@errnU_5:tryUopen(7 , encoding="utf-8") as f=A zmbf9Ubreakexcept OSErrortet!e. A;els.TraiseNO??f"Unable to read files {', '.join(")}D  4che.copy() ### Cometerface #_,__ == '__main__'2# Dz7pto prinhwiased verbose platform!ng6!(' 'Hsys.argv>'--"al_0= (C'non F!/--#P((L!, )$exit(0) r"""plistlib.py -- a tool0geneQ MacOSX .40.  pr0ty N" (")# 1 at\a simple XML pickle supporting basic object types, like dictionari sts, numbers and strings. Usually the top levelSFis aLy. To write out a plist file, useFdump(value,Q) fun1. 'A' is+ q0, 'L @ a (jQable)HVparseQrom a&Pload(O$) , with a (read[" a only argument. It return p (againyK3)Qwork |2data in bytess, you canK@s() S s(LVXs%$be, integers, floabooleans, tupl a (but  keys), Data,array, or datetime. . Generate Pexample: pl =R(!aS = "Doodah",L` = ["A", "B", 12, 32.1, [1, ']]1Fg = 0.1nInt = 7280Dicfnother3qUnicodeM\xe4ssig, Ma\xdf15Tru. PEFals  !) @some = b"= 1 << 64u OP1UID be9_2**64T?< 0Mrror("UIDs must be positive") self.data =  def __index__($!):6preturn :3Orepr2"%s(%s)" % T.__class__.__name__, B*))^Oduce`T,eG,G#eqCw, otherif not isinstance("W, UID'NotImplemented%2 ==m 3Chashbe # # XML support # \'header' PLISTHEADER = b"""\ """+Regex to find any control chars, except for \t \n and \r _(CharPat = rvQpile()r"[\x00\x01\x02\x03\x04\x05\x06\x07\x08\x0b\x0c\x0e\x0f"=6\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f]") Ff e_base64(s, maxlinelength=76# copied from /.=bytes(), with addedFP argumaxbinsize = (oa//4)*3&pieces = []di in range(0, len(s)Pchunk = s[i : i +'Q&eend(binascii.b2aH)b''.join(>)IVdecodI(ifXs, stSz4a2bzs^("utf-8"kMelseA){Contents should@form#a subset of ISO 8601 # (in particular, YYYY '-' MMDD 'T' HH '::' SS 'Z'. Smaller units # mayromitted## a losszprecision) _dateParser3r"(?P\dP)(?:-Qmonth5dayT$2hou:#:eminute&bsecond$)? Z".ASCII) @ate_ _string(s1ord ('A', ' 0day x'eWgd = .match(s).groupdict(* lsY0key!"val = gd[key0if gis NonPQbreaku4lst!zint(valTtime. Z(*lst*$to(d(return '%04d-%02d-%02dT:Z' % ( d.year, d.month Gday, 2hou Pinute!asecond#) def _escape(text): m = _controlCharPat.search&%if m is not None;raise ValueError("strings can't ZAains rol characters; "]G "use bytes instead").0 = .replace("\r\n", "\n")K#rvert DOS line endG E& G?MacG&FW&zO '&'<9<84 # 9<9>9g9>9areturn9 class _PlistParser%_init__(self, dict_type1`.stack = []current_key =/ Oroot_k& =w >p|fileobj#Br = rCreate(:%.StartElementHandle9h_begin_e# D?EndB ?end@ rODataOdata|tityDecl9 en __decl@#TFile(M', \name, is_parameter_0, v% , base, system_id, public notation_G# Reject p rs with ] !ar< s to avoid XML vulnerabiliLu expat.[Ygular\'doa thoseded, and Apple's plutil tool doe(aaccept them either@pInvalid Ex-Pion("1aresupported in-") w, attrsnw $0get4H"]C" + +,v4if =EV!(YsIwlC; = =4) H.append(  def add_object(self, value): 0if  .current_key is not None)0!ifisinstanceU.stack[-1], type({})b9praise VError("unexpected element at line %d" %?parser.CLineNumber)@+[2] =5&! =$#elO^ 2`# thisRthe root obC> ?els#/[].append( def get_data]I = ''.join.HQ = []Q_preturn f#phandlers~begin_di2Xattrs" =3%_ Badd_+(d$&d)x1endQo cXrmissingP for O'%s'`,_nKpop(1key[ ? orl$h d a' '`Barra,, aaJRaiLajRhoR2tru 2KTruejOfals8F% 9|integer4rawiG`if rawzrtswith('0x')6 'X'=int(raw, 16)]{8)Lreal ;Bfloa. IostringK [ESef end_data(self):  .add_object(_decode_base64(get_data())) :pdef ende$R ate_from_string1.U class _DumbXMLWriterl__init__;, file, indent_level=0\="\t"1! =8stack = []_]) =l *)# begin_element .append($ gwln("<%s>" % ' F+= 16qassert  L5> 0&pop() ==+J- /IosimpleP, value=None\"if is not Tz7 = _escape()t d%s>%s<,(AJelsev S/1L, li [# plist has fixed encoding of utf-8`# XXX:"this test needed?$if isinstance(yW, strn&! =.}1e('y'Y..t*c> v"1.\b'\n') gP%e(t~u [ b!, Header=1,Eort_keys=True, skip@Fals.(ifH PLISTHEADER .CB*4._s5 = $# iJ )f/?!version=\"1.0\">"0_  P/QA=. g=.""U(el NStrue"uE.Ffalse")  elif isinstance(value, int): !if -1 << 63 <= (2 < 4,4self.simple_element("integer", "%d" %G)iNelseOraise OverflowError%) >Lfloareal", rep\]?dic\`write_(bytes, karray)X$sYdatetime. X ,@", __to_strings(tuple, listU BType"unsupported type: %sP PHdef 5Fg, dataf.begin#"#_indent_level -= 1}maxlinelength = max(916,76 - len(ZY .replace(b"\t", b" " * 8) * ' )^@for  in _encode_base64(, p).splitg'n"J!ifIK0ln(L +;=end^0-7, dJif d$ 7ict*_sort_keysG$ptems = #`ed(d.i&()&+5 = 55Bkey,1Xf not77strR#ifOskip+continuek YL must be sU<V 4key", key;0<_: T %&4 F"\l1!, ["if , e: ! H'MG8 _is_fmt_xml(header): # prefixes = (b'32-!ifC7bom'ddcontin@v x = bom + .0.de('ascii').k!e(Iing)b[:len(QS)] == q False # # Binary Ph # class InvalidFileException (ValueError def __init__(self, message="C"0E.;<) _BINARY_FORMAT = {1: 'B', 2: 'H', 4: 'L', 8: 'Q'} _undefined = object()_bParser-1"""dRead or write a b, followingr descri!of4Oformat. RaiseMin case of eR, otherw11theORroot .see also: http://opensource.ayR.com//CF/CF-744.18/CF aList.c`dict_type%._5 = Hpf'fp>2try| # The basickoffset.[TRAILMyfp = fpg.seek(-32, os.SEEK_ENDtrailer = 6zread(32(0if /z) != 32r@(Pc_size,3refBnum_Q#op  Fbtable_ ) truct.unpack('>6xBBQQQ', 3fp.seek(offset_table_offset) self._object!Bs = read_ints(num%2s, H__sizeMF[_undefined] * E hreturntC(topv%) 2except (OSError, Index struct.eOverflowBQValue)):raise InvalidFileEtCion(def _get(., tokenLKC""" @the 0@ of Rnext E."""~#ifGz == 0xFm0fp.(1)[0] & 0x3D~i1 << m f = '>' + _BINARY_FORMAT[s](Nunpack(f,} s)~6(G)!n, *Mdata06* nd!if9; in ' l'>{n}{ize]}', iJelseTbif notqor len(32 !=:* n2I !tuple(int.from_byteshq[i: i +k], 'big'FPfor i'rrange(0q )Crefsn!._) 1ref PR7refTS0 by reference.C Macursivel rad sub-7s (content`an array/dict/ {EsultvJF[ref Qif re'!is (-* dg kcfp.seek(9TH$H" =J#F0&0Fqp,00f= None5+el787OFals8 987Tru7V# The!d source code also mentions URL (0x0c, 0x0d) and!a# UUID e), but neither can be generated usingCocoa libraries f?b''=Hu10: # int4 y=)<(6L),@   'big', signed=tokenL >= 3) *Qelif  == 0x22: # real#+ result = struct.unpack('>faelf._fp.read(4))[0]b3bdb8b 33: # datef^'# timestamp 0 of binary plists corresponds to 1/1/2001|p# (year=Mac OS X 10.0), instead;Y1970.<}(. (i, 1, 1) +6 6delta(sec?=f) H $40Ia[sIget_size(C)L)'s,!s&rif len(-y) != s:G raise InvalidFileException( 5Pascii9ing[Edata +"  =a.decode('' 60uni2I * 2outf-16be 89UID# used by Key-Archiveri files/vUID(int.from_bytes(21 +4AL), fG AYarrayrvobj_ref.h(L*[]iobjects[ref] = - (s.extendm;(x) for x in #>B0 is documented as 'ordset', butnot actualls# imple7in the Apple reference .g |C|y se an~"be'%in #$s_(DEdict8 1keybg h* r esult = self._dict_type() objects[ref] = r< (Itry:Dfor k, o in zip(key_refs, obj )59a[}Rread_0(k)oexcept TypeErrorfraise InvalidFileE37ionJelse;7 5dreturnK def _count_to_size(!1if  < 1 << 8I!1 ,el+-16,2,-32,4, t8 _scalars = (str, int, float, datetime. , bytes) class _BinaryPlistWriter (7_init__(W, fp, sort_keys, skip 1>(._fp = fp:F $S# wrvalue):d# Flattened@ect U0objX = []=Mappings fromA"->%id# First a has (()]ect) as the key,<bsecond=is used whenpp is notXhable anzo$idc.ct@N= {}'id# Create6s of allsEp;2mfv(S@SizeI referenceOserialized containers[# depends onIfnumberND3num1len/.p_offset2G[0]*D/1ref , =14)6Pforma_BINARY_FORMATgX  file header2fp.1b'b700'|"# AA0obj-Rd@0ect|cdrefnum. N es3topE2get:<uA_A5wfp.tell*.Kk'>' + %_G] * )struct.pack(>format, *self._object_offsets)) # Write trailersort_version = 0)E = (L1", j_size, self._refBnum_)s,D3topBStable,) [@fp.w (struct.pack('>5xBBBQQQ', *def _flatten(E, value):[# First check if the h is in, not used foK# containers to ensure that two sub!AwithZAsame:Gentswill be serialized as distinct%s.1if isinstance(, _scalarssif (typ')$.&7freturnX elydq)B/idD @P# Add.rreference maprefnum = lLlist"0objd.appenH$ [0B] = bJelse5H$[i?@ # And finally recurse into#].Kdictkeys = []:$@item .(h:#if ^ $F#1ed(G#for k, v6 Fflkk, strN?kip'Iinueraise TypeError("LQ mustztrings"8'|kRs!vo rtools.chain(V uboV (#, tuple)Jmg2geti'f1objJ| FZptoken, %cize < 15AB', Q" |R gU_ << 8YBB', token | 0xF, 0x10, size)) Aelif < 1 << 16:$self._fp.write(struct.pack('>BBH', token |g1g/32gLg2g/seXQX3XQdef __object(, value)n`ref = ._getrefnum(&RH_offsets[ref];fp.tell()4"ifl is Non |b'\x00'A?Fal# B8B?Tru9AisinstanceW, int@m6< 0Z>tryV!q'3Z<sexcept _erroriraise OverflowE)a) fromZ_}`8Z B0 a b O0x11b bO0x12b/63&?0x1&/64b R14' +.to_bytes(16, 'big')Pgned=)Xeh'A .Lfloa0 d:2ddatetime. 4 - $-p(2001, )).total_seconds]33, f( , karray)m(0x40, len /M\ O;strw3t =Nencode('ascii'<# 50UniWEncodeError:  t = value.encode('utf-16be') + self._write_size(0x60, len(t) // 2) 511fp.4'(telif isinstance(y, UID):D#ifdata < 0praise VError("UIDs must be positive"w.[n1 << 8` struct.pack('>BB', 0x80,)f/16gHg1g/32gLg3g/64gQg7g.seROverflowW(list, tuple)arefs = [getrefnum(o) for o in]4? I'_A0, s& U3' +nref_format * s, *pKdictqkeyRefss Z], []#if{sort_keyspootItem'"ed .i(D= @k, vr3hif notRkk, str/?kip'continueBType"Lz{stringsy8.append(3|kB30val3'v)0k~ D7st,elR R ) def _is_fmt_binary(headerreturn [:8] == b'bp300' # # Generic bits # _FORMATS={FMT_XML: x(tdetect=Exml,parser=_PiP Wrr)poBINARYs binary, parser=_BinaryPlistP3, Kwrit#W#) } def load(fp, *, fmt=None, dict_type= !):X"""Read a .pt file. 'fp' should be a readable and b+ object.M Return the unpacked root% (which usually is a io)E1"""M if% header = fp.A(32)1fp.seek(0 or info in _FORMATS.values(:!if*['detect'](m '+3P =,%']ebreak Felse! raise InvalidFileException()8 4tu[fmt]['}g`p = P( r!p.6G(fp)0!s(4& from a bytes:fBd"IO  #_[heavily stealing nntplib.py] # Updated: Pi0Laub [Jul '9760StrPmethod conversion#test jig improvemby ESR, February 2001.Added.C_SSL+! M_s loosely b:@IMAP). Hector Urtubia Augm3LExample (seet@func|1 atend of this); ImWAs i d errno $re esocketrys try:ssl HAVE_SSLH = True except ImportError: HAVE_SSL = False __all__ = ["POP3","error_proto"] # ENion raised when an * or invalid response is received: class._X$(ES): pass # Standard Port POP3_PORT = 110!@POP  4SSL$0995$ Line terminators (we always output CRLF, but ac'cany ofLFCR, LF) CR = b'\r' LF 0n' > = CR+LFqmaximal lyblength calling read(). Thisto prevent #!)arbitrary G6s. RFC 1939 limits  o to # 512 characters, includX2. We have selected 2048 just to be on # the safe side. _MAXLINE =/ !: S1"""0supsas bothN1min and optional commQsets.GArguments canrstrings^Ategehere appropriate)=(e.g.: retr(1) Z B'1')work equally well.MC2Set*.USER name Puser(RPASS "_( 2ASTAT# Zstat(+LIST [msg],list(msg = Non#PRETR !:msgcODELE.@delec .CNOOPO Knoop?RSE 1: print('*put*', repr(; #j#1 .sendallQ + CRLF) # Internal: ' w@comm{!to (through _x+()?cmd?cmd = bytes| 8#, stripp>$~`# This<where all1CPUP of t"`module)consumedARe_proto('-ERR EOF') 6he mC0losA&geWQ.(_MAXLINE + 1*aif lenND) > %[ S too long' /ge!if[":  t%noctets =#B canany combinationwCR & LF5Ahowe':2)' +sAs enw*in;so only possibilities are ...LF,IA, CRwine[-2:] == r[:-2], C#:1B@ return line[1:-1], octets Sretur" ! ## Internal: get a response from the server.0Raise 'error_proto' if);doesn't start with '+'.sdef _get.q(self):[`, o = .'%()"#ifdebugging > 1: print('*B*', repr( )<1not.sW(b'+'KV` Iplus followNtext][@long\$list = [];A = 0YI\ QwhileM != b'.'B!if <,..=+5o-1}! =GI[1:] $ =9+ o .append(HZ  , M-send a comma !ndu!5shortcmd\'neQ!pu" ")S hT1H(These can be useful:zgetwelcome#VAset_Qlevel<!, C:' ="G# Here a!ll4POPsCuserc b@"""S P name\T (should indicate password required)G-5""" _N'USER %s' %WrrZ_Opswd#}  includes message count, mailbox size)5NB:is locked by.h~to 'quit()'CPASSAstat 5Get#'us Result is tuple of 2 ints ( 5valVSTAT'rets = retval.splR'tsnumMessages = int(rets[1]) sizeMessages = int$2$return (num+(, 91) Q def list(self, which=None): t"""Request+Sing, arresult.L,R without a m number argument is in formh['response', ['mesg_num octets', ...],]u?henr Pgiven{autsingle z: the "scan"T that.>5""" "if?`@not FErk._shortcmd('LIST %s' %A 1Elong0'Hretr trieve whole''N 0lin JRETR@Odele_DeletS ODELEAnoop gDoes nothingNOne supposes\j indicat`server<_aliveJNOOP"se Unmark all s !ed|_tion.!IRSETs?quisSignoff: commit chan2on , unlock mailbox, close connec\sp = C0QUIH(Mp%0 +C ssuming any0 ab)it;:tryDfile ;! =; 1if ic [B".kfinallsqF l . ;.shutdown(et.SHUT_RDWR,except OSError as exc+S# TheT might already haveVdfC# On Windows, thi&y#0ultWSAEINVAL (eW10022AJ# An invalid opera was attempted if (exc.errno != .ENOTCONN and getattr(exc, 'winerror', 0)I10022):Bm raisefinally7sock.close() ;#__del__ = quit  optional commands:def rpop(self, user"""Not sure what this does."""qpreturn C._shortcmd('RPOP %s' %Xtimestamp = re.compile(br'\+OK.[^<]*(<.*>)'a, passwordAuthorisa- only possible if server has supplied a in initial greeting.QNArgs?o - mailbox;*% )e5NB:His locked byfrom here to '5()'lsecret = bytes(l,encoding)<2m =a.match'.welcome/if not m@or_proto('-ERR A0x8ort'UPmportEhlibPdigesm.group(1)+#0has<R.md5(8R).hex (k#%s(", =#))t@which, howmuch Retrieve message header ofnumber 'G]sfirst 'Zx' lines<Gbody<Result is in form ['response', ['A', ...], octets].C= AlongTAuidl8!, &]=NoneAc (unique id) list$If%2, rcontains 6 tY`in the %m gnum uid', otherwisea%is@= T7mesB [<Z"if D[CUIDL{T0NAutf8 0TryLenter UTF-8 mode (see RFC 6856). RsY@IUTF8Ocapalk%bilities (2449) as a dic1aryn >>> c=poplib.POP3('localhostm>>> c.capa()  {'IMPLEMENTATION': ['Cyrus', 'POP3`server v2.2.12'], Ap 'TOP8], 'LOGIN-DELAY0'0'AUTH-RESP-CODE @QEXPIRa'NEVER4BUSER*d 'STLS PIPELININGBUIDL% 'n9}'E>>> Really, according to RFC 2449, the c  folks should avoidD1hav9he implementation split into multiple argu"Es...C5""" def _parsecap(line):t`lst = .decode('ascii').q)()/return lst[0],61:]caps = {":tryr resp = self._longcmd('CAPA'l#awO39[1]pfor capR in r- k`capnm,+0arg? v4!s[94] =;~except error_protovXraisep('-ERR  not supported by c YPstls(4, context=No"""Start a TLS sess7!ony`active<1necPas specifiedBB595.ur - a ssl.SSLCu!ifHAVE_SSL missing#if1tls_established\already EhvGcapa?1,r if@ is  _=_create_stdlib_6a_shortjTP.sock`.wrap_!ett _hostname=cDfilenP.makeL('rb_u = True7f if $`class (  0""" client -over SSL6Instantiate with:\ , =995, keyf, certL@)r! -!ofQpop3 3sslr u! -| number" - PEM formatted file that contains your private key  certfile - PEM formatted @ific8`chain ' ?ontext - a ssl.SSLC + Se+e methods of the parent class POP3 for more documentation.I6"""Vdef __init__(self, host, port=P_SSL_PORT,a=None,_ timeout=socket._GLOBAL_DEFAULT_TIMEOUT,i1extZ)):L$if is not D and <raise ValueError("nC1arg,s are mutually "O "exclusive").;)DC' ' + ' Z/'-')Pa.quiF"""Common operations on Posix pathnames. Instead of importing this module directly,  os and refer to -`as os.`. The " " q i<p alias <" misystems;cother  (e.g. Windows), ] provides the samein a mannI pecific to that platform,Rto an~ nt`). Soi f  can actually be usefulBnon-xPtoo,  qmanipulc1componentURLs. """ # Strings represenqvarious-related bitw`d piec#se are primarily ex; intern,Ty+hardcoded.Phouldset beforeB`resolvNcyclic dependency. curdir = '.' pa .' extsep /%#th`:' def#&/bin:/usr C' al?None devnull(@dev/ 5'  5sys 4tat pgenerickg from $ * __all__ = ["normcase","isabs","join","splitdriv Uext",n "basec","dir cprefix","getsizMgetmtimeEBgeta,c islink","existl Qisdirs@SpliTghead (everyth@up t!e |'/') and tail (the # rest). IfL@QB'/',-"be.!re1o #TiC!,  80ail'/'es are stripped from8"iHCroots(D8"""#. s tuple "( )";@re "2" i5Qafter final slash. Ei@ mayZ/(pi = p.rfindA + 1"[:i], p[i:]"if*0 !=A*lenj=/!.rbiGH#Ns.extensionEThe :>!at@u!do! #LP;/q isR0bef}I always true that root + ext == p. def splitext(p): p = os.fspath(p)if isinstance(p, bytes26 se8Ab'/'04ext.Belsee 2'1return generic&._, sep, None, n$) .__doc__ =? P # S0 a a name into a drive specification and the rest of ! #: . Useful on DOS/Windows/NT;PUnix,0Xis always emptyy?"""'. On Posfbf1""" rpp[:0], p Rtail (base&Q) par:0, s<"asT(C)[1]7\sfinal componenXl I_get_sep rfind(sep) + 1P*len(! =/q.rstrip@G<#;#Is7 a symbolic link? # This will>Pfalsesystems whereulstat doesn't exist> isVTC@"""Ttwhether <2try:}trWexcept (OSError, Value Attribut3FG.S_ISLNK(st.st_mode)XBeing true for dangl G s Qlso u[ls)4. kTqjbroken+s,?os.' ?mount point=@(DoeC1ork$all UNIXes? Is it even guaranteed to w/"by "?)!is`2q -/s1?;# I -- so not a}B. :-Vg Q0# A) can never be a mount point  if stat.S_ISLNK(s1.st_mode): #return False  if isinstance(path, bytes:parent = join$Q'..')CFelseg-,@realn(J6tryIs2 = os.l 'except (OSError, Value rdev1 = 1dev0devi s231if - !=2UATrueR # /.. on a diffe-device as!j6ino4ino"f -=is the same i-nod| # Expands beginning with '~' or '~user'. #means $HOME; Qthat -s home directory=!If) doesn'trn,oi'Gi is unknown, #G2is ed unchanged (leavep reportto whatever # function]bcalled@eeargument) See also module 'glob' for 9sVof *, ? _[...] inhPnamesG&(AbshouldVbe defined to do full *sh-style environ # variab{r.) defdI3"""~ construas. Ifdo nothing.""" fs v_tilde = b'~'5 Q ifRp.starts(' 'Usep = _get_sep! =&.find(sep, 1F < 0bi = le$G== 1%0f '&' in% imA pwd [=0.getpwuid(os )).pw_dirM,1Key  Y# bpo-10496: 1curu identifierPexist9thenQpassword database, ? S 3os.^[w]T 4kB[1:i6\'(O0tr( , 'ASCII" "pwI0pwdQpwnam=M4 # bpo-10496: if the user name from path doesn't exist in'  # password database, retur, Funchanged;&"home = pwent.pw_dir r# if no%i on VxWorks<!if76 is None and sys.platform == "vxw5!":7 if isinstance(, bytes)4os.fsencode()]oot = b'/'FelseGr?% =.rstrip(*Vl! +[i:]) or * # Exp$s containing shell variable substitutions. # This e=s <5s $2V$${`} only9ANon-H5ent`s are left &. _varprog =bC defAvars3""" As of}. Unknown1"""71 =  tglobal , b@if b'$' nouatn 2import re0Xre.compile(br'\$(\w+|\{[^}]*\})'ob.ASCIIj@search =v.fBstar{71end}viron = getattr(os, 'en1b', z &?if ,-+7 = *)&('''&3os.kQi = 0 while TruIBm = 2, iI7mQbreakP$, j = m.span(0=3vgroup(1WAame.aswith( )y8B.end3endm ! =e[1:-1]:try3if  O@valuTA[!dez&)]? pU~[:except KeyErrorj_@tailfath[j:Uw a:i] + N$`1len >+= tail re turn path # Normalize a, e.g. A//B, A/./B and A/foo/.Bll become A/B. # It should be understood that this may change the meaning of the # if it contains symbolic links! def norm/(): """, eliminating double slashes, etc.""";. = os.fs Wsinstances, bytesvzsep = b'/'3Qempty1dot.BelseH[Z'FC = 'A72dotX#'.!ifA == c!re 1dotinitial_)! =8.startswith(sep)+ # POSIX allows one or two Enbut treats thre)CmoreHtas sing.(see http://pubs.opengroup.org/online/9699919799/basedefs/V1_chap04.html#tag_04_13Cif (1andzC 1*2)?not7*3) \1= 2\UcompsVFplitQDnew_ ![]/@for 1 ins!if(W, dotH2inuiQ !=/'@or ( A) orI(@[-1]l75.append(Uelif $R.pop(4>S = sep.joinds1 e7*+]5- orI 'abBVB"""Rdan absolutQisabs 52cwdsgetcwdb8 o -,"= N1wd,R Z canonical7a (i.e.locationa file on#! #system).j@real()name, *, strict=False*f ofa specifiediN>Jany  encountered\zY60, ok = _V W[:0],B, {}Aw uAJoinb!s,0alizing and eli[u!1 is17Non!# use cached val 0# T!ymcrd, so we must have aA+Yloop.0# R4(errno.ELOOP0os.ycturn ap]1t +1 ofqunchangedM!reK0+), 0 = ! #s[*~o, ok =W0os.2c gKZot okvn+ #*dT$, True supports_unicode_file[s = (sys.platform'darwin') S0relM`start=?B"""Ra relative versionaH2""" R  raise ValueError("no path specified") p= os.fs"()if isinstance, bytes): ?curdir = b'.'1sep/&pa)*OelseJI'HB'..'if start is NonT"=  u!6try_list = [x for x in ab9!).split(sep) if x]v+Y@ ?# Work out how much of the file>shared by1and.i = len(commonprefix([,0 #]) 1relP] * (K=f)-i) +B6[i:tif not I\_Hturndjoin(*9except (Typ, AttributBWarning, DeprecationpgenericG._check_arg_types('rel',\aise # Relongest hP sub-Dsequences given as input. # TheKQs are<normalizPefore_`paring pm (this the # responsibilitylcaller). Any trail@separator?stripped from[MeQ@ defF1ath"B"""G names, r+s\ ,E.""";)8rx5 Va'm'`() argan empty''s = tuple(map("s) Ns[0]{32  `_[ t"s]A Hisabs, = set(p[:1] = ppD2us "Can't mix(`olute srelativ"")gJ![ccs\cJ4c !]!@ <s1 = min( s2/axY+1l1i, enumerate(s1W'1if Zs2[i]0Z6[:iVbreak ep  sep[:0] r0eturn prefix + sep.join(common) except (TypeError, Attribut!):(,genericpath._check_arg_types('V@', *sc;raise # Author: Fred L. Drake, Jr.# fd@acm.org #!This is a simple little module I wrote to makfe easier. I didn'tIsee anything quit-ke it in thbrary, though I may have overlookedK1omeHc@when`as tryi to read some heavily nestJtuples with fair on-descriptive content. modeled very much after Lisp/Scheme - styletty-printof listsf you find i&`useful#ank small children who sleep at night. """Support5premg", , & dictionaries recursively. Vd, but especially`debugg data structures. Classes -1 PP2er(OHand@pera`s ontootream usmaqfigured#set of formatWparameter1FunR-- p.F; a Python objec~Hed representA. pK QOs[defaultQsys.stdout]. safeeRGate a 'standard'()-like valuepct against*q""" im3Rcolle+W as _#Ac##$re 1sys%4sys from io StringIO" __all__ = ["m3","P","isCable 4","K!","", "pp"] def a(,eam=None, indent=1, width=80, depth *gcompact=False, sort_v@s=Trunderscore_numbers+#""M(Yer = (= 0&.) w :Python objec(t into a pretty-printed representation.""" return P-P,r(indent=, width=, depth=,BF compact=, sort_dicts= Aunderscore_numbers= ).pformat(object) def ppy, *args~False, **kw!):2"""0 a Python Y.pN^c@safe>yPVersikf() which can handle recursive data structures 0)._v_w, {}, None, 0)[0]isreadableDetermine if ONT) is : by eval()-1  requires a212] class [5keyBHelper funcd for keyas when ing unorderug1s. The wrapped-will fallback Py2.x style hPrisonvE_ptypes (zTfirst4png the # name andAn byI obj ids). Does not workh lyg .items() must haveH1 applied@bothn)zc value {?_slots__ = ['obj'].__init__(self,O`.=5l3Gther5#trBr*M0< o3Y$except TypeErrorB`((str(pAg)), idE < \V<<~=qstuple(t">Qng 2-/sHkey(t[0]),d(t[1])BEV$=1X$80Urstream= *#3ct=ZnTrue, (+JB"""HZ& Aoper"2s oH0 usa set ofconfigured param-j/N of spaces' each level#snesting ? QAttempted maximum number of columns in the output. UdepthqThe maxH to print> nested structuresMmstreamNpdesired?0put;eam. If omitO(or false),standardL@ available at conion will be usedycompactSIf true, several itemsBcombined?one lineRsort_dictsU keys are . 5"""8indent = int( )Swidth 2if .U < 0:2raise ValueError('*@must Y>= 0'Kis not NBand /<=a*` _V % H!bself._k=_per_level;` (g!= $ifc  g# =/AOelse0 _sys.stdouS = bool(&Jx}&underscore_Ns =  Qdef p(>, object)._format(7 1, 0]{}, 0.write("\n")xUbyio = _StringIO([>!io;0, return sio.getv(isrecursiveB wl6[2]T adSRs, re# e lC gg,,F, allowance,Uatext, E PobjidUd  if:i20con@C, _$onIJ-%ve = True#C@ = FG #$4rep_S_repr{ 1Amax_#7-5& -65if len(rep) >QC dispatchS(type1)._1__, if p is not None:  context[objid] = 1 ! p(self, object, stream, indent, allowance, N, level + 1)O4del(v #ireturnelif (_dataclasses.is(Y) and8not isinst-o, type3Q&._d_params__.reprj# Check has generated ;method.shasattr0.__0__, "__wrapped__""__create_fn__" inI.G.__qualname__):._pprint)*`.write(rep) Ndef  *@cls_?& =hA__._!__/ += len(;)%$tems = [(f.YW, get", )) for fxes.fieldsa) if f]c #f + '('._formatpspace_i(W:3')'_dispatch = {}?ict%# =7('{2if R_per_:> 1/>-._/- 1) * ' ]Plengt l( if$:gthfsort_dicts!gSorted .(), key=_safe_tuplet<OelseRK:9(0+,JNZz-'}L[>icteqorderedW+0if u Y )  cl#__lA U4cls_ + '(')  self._format(list(object.items()), stream, / indent + len(cls.__name__) + 1, allowanceDcontext, level)%y.write(')') )_dispatch[_collections.OrderedDict.__repr__] = _pprint_o R_dictI5def ",  +, : '['i_]i4m ]:&otuple(=(endchar = ',)' ifQ") == 1 else ')'S#o)^J53c/?setb0hif not= %)'ereturnjStyp =.__class__0if "ois setp''{g=}F5typf_ + '(V /q1 +="Jy = sorted%, key=_safe_key3FS/se1setofrozen0 1 /tr0nkk =(chunks = []c@linea.splitV(True1vel Z1W&= max_width1 = # -|Qpfor i, in enumerate(*s) re if i == len(lines) - 1: max_width1 -= allowance(!ifGrep) <= 3Ochunks.append(2 JNelse5# A list of alternating (non-space, ) stringsUparts = re.findall(r'\S*\s*', )4qassert ;#no!M[-1]%; .pop() # drop empty las9 4>'2 K 'current = ''afor j, in enumerate()b#candidate = ^+D `/Dif jAWA_ and YDa(i%r(F)) >t2>$( #r(8)%1"/ =2=A x$ifE,) ^writeereturnG?velA6'('/ji, rep if i > 0%'\n' + ' '*indenth% \A)') _dispatch[str.__repr__] = _pprint_str+5defbytes(self, object,Ream, ,>, context, level# =<."n(`l4$/r%  Pparenl bU += 1+ Zdelim"a_wrap_R , _.. -WGxk  !00if 1  } if:ens=n'ace_arrayi&: write = stream.write ('bytearray(')self._pprint_""s(object),S, indent + 10,?ballowance+, context, level}A)') R_dispatch[.__repr__] = 75defmappingproxy(", %, !):P)('] Erformat(oo.copy(?3{N 95 <_types.M P OTypeJMsimplenamespaceP00if %S) is SlNlk# The # B"" instead of the classK., so we do'same here. For sub9qes; use# <.P@cls_@ = '*'#Jelse1+!__]A__._K%__?ud= len(;)7$ctems =.__dict__.i(9KN + '_LI   + t"._Q_per_Hipdelimnl?@,\n'C ' *o'AlastE"x U) - 1$for i, (key, ent) in enumerate(2 W = i == cR0rep(r_2F(rep|7': :!L(ent! +PO + 2/J1 if / 13 aif notI 6l <!,  qe delimnl = ',\n' + ' ' * indent Plast_x = len(items) - 1$for i, (key, ent) in enumerate2:/ZW = i == c #PwriteT):'='dif id(}zcontexttx# Special-case representation of recurs to match standardM.ve dataclassT.,Z"..."Nelseself._format, stream,! +key) + 1,pallowance ifo v7Fz, levelaif notM!deb!) Cdef _D(!, %, +, og# =.l`nt += h.aqnt_per_)f"F > 1mTb(Q0) *G+f '%'width = max_ -  itU3teruN:trypnext_en0 6(itexcept StopIt:ion>ereturn^ = False_while%y3d *0 = &6Trug&-=} '|#iLocompac0rep~ w}0rep2!2if :< wP D&1if D"" ='-nlF/>= M-= w>bfh.&, 0B-an+in4[ v5extXJ, object6 repr, rea)dable, recursive = self.format(object, context.copy(), T_depth, level)Dif not rea:d9 = False#&if96Tru9return repr NCdef t+, Q, maxsqA"""F16J a specific?hw0ingQtring}and flags indicat&whether theesentation is ''F5<6s a2ustruct.A5""" r%p._safe_0 S_pprint_default_dict(Qapstream,ent, allowancewq43len)MTw.write()w'$df.}factoryAScls =.__class__indent += cls.__name__) + 1( '%s(%s,\n%s' % (7, rdf, ' ' *@g.y", as7VB')')_dispatch[_collecs6!._Pe__] = Icounter, +v + '({'"ifr_Q_per_hO > 1.6`- 1) *d7temmost_common(%/ _i7(4@/ +O + 2Jz a/'} COkhain_mapl<_.maps2__name__ + 'S(') indent += len(cls.__name__) + 1(for i, m in enumerate(object.maps):,[bif i =V&J - 1*. self._format(m, stream, , allowance, context, levelK?.write(')Oelse1w,\n' + ' ' *!) $&_dispatch[_collections.ChainMap.__repr__] = _pprint_cB_mapC5def`deque(C", kA  aif notG  V)areturnnScls =.__class__ U;! Q''[$ifmaxlen is Non Hc_itemsUU + 2, ]+brml = o.? J  R,\n%s8=%s)' % (o, rml)  user_dict0_.data ! UserDict?lis?LisostringSAsafe DKDvels1# R triple (_string, isreadable, isrecursive). typ = type(object) if in _builtin_scalars:$Freturn reprD, True, False .r = getattr(typ, "__7__", None),if issubclass.int) and r is int.? if self._underscore_numbe2f"{Z:_d}"'Jelsen8dicCnot W/"{ objid = id Hif maxlevelsl 6 >=P"{...|, id@|contexti3in Y_$on[ XL[]Y] = 1"re! =  # =Vcomponents = []:PappenV%. 'L+Psort_ b@itemz$e.(), key=_safe_tuple<< =4ectK for k, v/k4, kY cuyformat(W$k,,_!, ' .vjvjv" =j vj("%s: %s" % ()5 = L  ifB72or k4delQ i 0%s}", ".join(%),  (8lish) or \ ?!A @p)&*?if - #/[])[ = "[%s]" elif le^ == 1C\(%s,)DV)()e  format = "(%s)" objid = id(object)if maxlevels and 6 >=:1Wsreturn w% "...", False, rin context?-if `_recursiondITrueXl[}Y] = 1readable = ;fv :components = []Pappen]%. 'S+for o in>ectorepr, o cur = self.(l$o,,, .(qfif notD" =  l@ 4del _ , ".join(4), m H`rep = sn`rep, (()rep.startswith('<')) _builtin_scalar@frozenset({str, bytesarray, floatemplex,b bool, type(None)}) def :t(D("@1% (`=.__name__,R3)) xperfcheckD=}import tim@ is ('mq("string", (1, 2), [3, 4], {5: 6, 7: 8})] * 103PrettyPrinter(At1 =.G_coup._safe_Q, {},A, 0,<I2I p333 &(":", t2 - t1?p"Z32Qwrap_R width, allowance)h`curren61b''50las%lep // 4 * 4 iprange(0O+3, 4Y0parKv[i: i+4<candidatr + 4hAif i == 6 -=5dQ)) > 5 H3if | dRyield $* =JelseM)}uD if r"__main__": -_perfcheck() #! /usr/bin/env python3 # # Class for profiling  code. rev 1.0 6/2/945Written by James Roskind # Based on priUe module10Sjoerd Mullender... # which was hacked somewhat by: Guido vanksum """P@""" opyright Disney Enterprises, Inc. All R$s ReservedPLicento PSF u a Contributor Agreement2+the Apache , Version 2.0 (!"+"); # you may not use this file except in compliance with FEYCobtain a copy of(" ahttp://www.ab.org/ls/LICENSE-2.0Unless requiredapplicable law or a@d towriting, software # dis@#edT9 is!4on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND0either expr@or iEped. Sehspecific languagagovern(Permiss and limitations. import sys Dtime marshal __all__ = ["run", 0ctx P0e"]pSample Fr1 #i_count = 0 #def integer_-1():v global 1$ =E + 1dreturn0 #iWs-g # replaCdDJAs c_Utils: a"""Sup9utility funcq@rare sha?Ae.pyc@m!s.(PNot sh be~d directly&SR__init__(self,A2er)&.5r =# sD3run?AstatH,@name4'rtPK9 = W!()Mo6try|0.c]-NSystemExit;5assYkfinall]`_show(h >ctxzs, localsBa!w,q b2=3%if FNonedump_stats(filencame) Uelse: prof.print_stats(sort) #*6 # The following are the ric member functions for iler class # Not:$at an instance of Profile() is *not* needed to callP/m.: def run(pement, name=None, MB=-1)ta"""Run/u under opally sav)results inZ EThis1 takes a single argu that can be pass1theDf"exec"P, andYt `. In Gcases thisDroutine attemptsoXits first`Egath1ingGBistics from uv. If noApresrFthenD automati!y "CmplesbBportPed by|Qndard@ str/(d/line/k-!)l3is Qed inHPeach 2.1"""return _Utils(/).P$) t8ctxwglobals, loc!, supplyyour own b#e, . @ have same seman aMn=Q \A{pelf.curPalwayStuple. EQsuch  correspondai!ck fris currently active (sh[-2]). >J`defini&stNs. We us[is external "parallelA" toJavoid contaminat`progra@at w]?c. (oldO!erIugwrite intoS s1 diary!!) DerivedeYPchang&e some entries, aVVrey leavP[-2:]Qact (previousb0In #in*@errodetected,R-3 el ised/67[ 0] = Tim!atbe charg0 pa .'<P Iths] call will not have to access the timing data for parent frame.-[ 1] = Total time sp#rin this+'s function, exclud[/!inHx4sub*1s (B latter is tallied in cur[2])2P {aexecut  1 -3qName of3 that correspondszn-bActual<8'we;:P(used @syncT ep_ handling-4Our6-tuple (f_back). TEeachstored as a 5YAe di1aryKRself.Ss[]. The indexHQalway n<X1in 82-3]$9`follow1areg`definiszmembers: [0= nu&0imev was called, no!un$adirect orp recurs![vNi appears o*e stack, minu[]@ternqof}Cumulatip-@presH. ICnon-%ve"s,|hHSNu@fromr80to  shS`invocaacI, in-\Hall % [4Ae!ngyv+e j!it2b by usm2"""dbias = 0 #D2ibrconstant&`def __0__(,9r=None, E %):}&>Z = {}`cur = ? {md = ""__!if~Mk" = 6" =?.# Materializa local`lookup-#edn7!ifurf@get_! =@@.proU;dispatche+dtrace_%_i4Oelse}tr-at() # test outr 7*rygLlength = len(t)1except TypeErro">  self.dis patcher = self.trace_disG_i Yelse:if length == 2 $\Vn ZpP-_lR%# This get_time() implementation needs to be definedE@here%Pcaptu he passed-in Z r rameterG#list (for performance). Note that we can't assumeE2ther() result contains two values/almcases.Y5def',!r(=, sum=sum)`return%6=())b+ =n/'t0(P! simulate_call('profiler') I# Heavily optimized  routine .process"()^H #(0, f, event, argTa'im [0] + t[1] - Bbias "ifu}!"c".c_func_name =!._ )__K,[]tI *GrGrt # put back unrecordBelta3# D Bbest program (= scalar, fast(!if# an integer but flo0ork+o -- andW <relies on").G)_igI#(t 1j 2  +_ - t &macintosh  s tticks o1/60th secondH?mac6T/60.0G if self.dispatch[event](self, frame, t): .t = timer()/60.0"Oelse0 - t # put back unrecorded delta R# SLOW generic routine for returning lists of numbersJdef trace_E*_lW, arg@get_1 =  B() -'t 3bia-1if f == "c_call"-c_func_name =!._ "__K.cIn thehandlers,first 3 elemencur are unpacked # into vrbls w/ 3-letter  s. The last two charactersJmeant to beMmnemonicu#IR _pt cur[0] "pare9aime" aFa0ged%%^O(_iN1] "internalH"0 spadirectly i/HtionOeOo2] "exOdin subEwPexceph prpt, rieQfn, r0, r1curBif ($r is notAQ) and5u+y Md)$= +6P2 1 ?"if 1.f_K[-2]L !!ifEisinstanceProfile.fake_;cassert0, ("Bad "%n,5DD6`N%,AL)Ls; 06.is None or \d|0J-2])GDLT&3]@fcodcafn = (#@.co_', rstlineno_name)  self.cur = (t, 0fn, frame, 3) timings =if fn in :@cc, ns, tt, cPallerM/I[fn]22 = @M + 1D6Jelsev D%{}7return 1  def trace_dispatch_c_call (3 &t)k fnF!""D&.c_func_nameAs+q`pkr is notvcur[-2]wbassert.*.f_back, ("Bad u"F[-3]N> 7OYB, 0)M5# Prefix "r" means part of the R~ing or exit . CpCPreviousB`Parent Rolder.prpt, rier5cur~Prit =4E + te_total6retjpjpjpjpjp62, pkrQx4 = ;1 + Rpet +r-, OyJ F$ =([r!ifc*nsY`# ThisSonly occurrenceqtion onVstackcElse tMa (directPDr in) recursive U, and<Jits cumulat' time will get updated wheqtopmostN= toLsc c <!cc if+erNP[pfn]> + 1 # hack: gather moreu# stats such asn@amou fe added to ct courtesyDis specificjQcontribuIc@W!is@@ ?" -YIk = { "call": trace_dispatch_3, "exception*/_retur,)ciU )h.W # the C func &ed"c_F+1} # The next few\s play with self.cmd. By carefully preloadingIour parallel stack, we can force profiled result to includeFan arbitrary string as<qname of  .?eWe use;#atJQ, and@Bstats lookCvery nice :-).'def set_cmd(q, cmd):2Gi'sur[-1]: palready@0DT =I simulate>(hclass fake_code}__init__d/, line, $o_+4 = (I! =P c! =j PfirstEbno = 0aCrepr  !(&.c, o_["))e9Ofram: [{, prior1f|obback =A + y" =#('1C', 03^u pMc%2]77els 02Non E(", d)V.b ['!']!, 83, 0# collec|from penL9@gettQfinalo# timingsX12cmdfHmd_completeget_time-iDt = B() -pt Dwhilpi*1]# We *can* caQassererrors here ifRv$# K_Rchecka m!> <6, ty0M+ t<aprint_D[, sort=-1dimport p&\ .S; ).p_dirs().HYuort). \<_ def dump_stats(self, file): with open(, 'wb') as f$+=.create_stO)D marshal.dumpj.&Q, f) )Idef @R`.simulccmd_complete(j%unapshot`s. bQ = {}6 for func, (cc, ns, tt, callers) in N.timings.items(]Ic.3 = W.copy%enc = 0}20cnti ers.valuee1Bnc +e9cntKz[]c # The following two methods can bed by clients to useyp# a pro=r 0 a ement, givenURring.}1run0W, cmdQimport __main__medict =0.__!Sreturrunctx(cmd, '!7, globals, locals%.set_cmdS ys.dispatcher(:tryV@execKwkfinall8sqFNonefg#is 0ore;fulQingleAtion.,%, /, *args, **kw.Prepr() ^5O(|#3 *.|hLAcalcs the overhead  usn< . Gpproblemthat it takes a fair amount of timrrarFqto stop wa (from<it receiv^n event)# Similarly,1 rea delay G pre-star4!he0bef2user's code re0 ge1ocontinue#3Atriepmeasure difference onGaa per-c basis0Not<xat thisBis only significafh@re a0 loJcs, and relatively littlwr2perp. For exa,GQsmallps will typiy benefit0havYthe # profil8er calibrated for the current platform. This *could* be # done on 5fly during init() time, but it is not wortheBeffort. Also"e that if too large a value specified,BnCxecutionqsome func s will actually appear as aAnegative number. I*normal* T(with veryE0lowKl counts) to have such cstats, evenhK`figure3"correct."g One alternto profile-uMadjustments (i.e.,E2addM magic little deltaAeach t)to trackFmore carefu^ G2 of6s (and cumul!lyoH.E6sub)are seen0f t4werCZarithmetic`ld be #R afteCfact3 atqdisplayNR). C"weP onlyfl/return.CRTheseQs can{educed by examin}/callees % #rsGqvectors . Hence we *can* almost 0E!in(l [at printC(notxw4on'` excepVv@cessP. UnPunate5&th$is]ly no similar i3!maZ-T sub-O0uld7b@hardw"get all![!" "rEST y,Owto extendOp tuplesaCkeepF2in  raHthenGAdefs0SimingG\`include significa#wos. I'm a bit fearfulG;N al#tOsvheavily optimizedC t/b r4d"r $@run Pper, fur "dadded"".)j** E0defe(self, m,bose=0):'0if .__class__P9*.raise TypeError("Sub8es must override .be().")Csaved_bias ={ E = 0;try_._kv_inner(Tw0fin F?msaved_bias  def _calibrate_inner(self, m, verbose): get_time = &. "# Set up a test case to be run with and out profiling. IncludeLlots of calls, because we're trying] quantify stopwatch overhead.NDo not raise any exceptions, thoughdP want_GknowGexactly how mGe events are geneSad (one7, +Kdreturnper Python-level;&).aGf1(nfor i in range#[x = 1I(m, f1=f1O mOvf1(100)Q@f(m)`# warm th6che%# elapsed_no81<- UA_takes6Tt0 = y%()> /t1%}= t1 - t0<$ifsprint("C N =",&  The differenc"&is(, only some>`which Ser subtracts # @on is&wn9Qp = Peop.runctx('', globals(), loc   /'a reported<- "CPU seconds"Ipcharged'f&f1:Ptotal`vls = 0.d c (filename, line, func), (cc, @t, cpallers)\p.timings.items(%if\@("f", "f1"(K]+= ccm V+= ttY 'f'4er SZ G! #8s427if  != m + 1*ValueError("internal e:Dlb %d" %p"#. -&% = egwasn'tK1ablV measure. Divide by twice@`number@ (since there  4# are two profiler events per call in this test) to get the hidden H # overhead<G$. mean = (reported_time - elapsed_no) / 2.0 / total_sGif verbose:cqprint("fstopwatch`P =", .)GareturnO #*8 def main() im" ofrom optparse pOptionP!r usage = ".py [-o output__path] [-s sort m module | script(] [arg] ..."\{Hr = w(r=('.allow_intersperargs = FalseRa.add_o('-o', '--ou', dest="!",9help="Save statsw<' >"8fault=NoneombmP", acV="store_truevP  a libraryA.xys lSort order when 0ingstdout, based on p !.SWclassP"de2-1).if not sys.argv[1:]|`o_(3cexit(2K(0s, D) = @_?;nA:] =.S# The that we'reumay chdir, so captuhe absolute "# 0 at+Brtupu ifSSions.91 is5 %P= os.k@.abs"pif len(V) > 0Rzx_Qrunpy1codBrun_9(modname,  @='__IB__'):@glob{T'=Q ':J6py.u,'v!':9[0]S}.el og ;S.insert(0,m0dir92(prB)with open!, 'rb') as fpb1Mcompile(fp.read(),t, 'exec'iG_c6_':D t0'___&e__package+%ocached$:tryprunctx(!, , None, options .outfile, options.sort) except BrokenPipeError as exc:'.# Prevent "E6ion ignored" during interpreter shutdown.Gsys.stdout = Noneexit(exc.errnoFelseparser.print_usage('rreturn  # When invokedmain program,@ the(r on a script if __name__ == '__@2__' () """Class for preportsP0pro\d python code."""ritten by James Roskind # Based@iZFp module1Sjoerd Mullender... # which was hacsomewhat by: Guido vank0sumCopyright Disney Eises, Inc. All R$s ReservedoPLicento PSF u a Contributor Agreement # # 2+~dApache`, Vers_P2.0 (!"5 "); # you may not use this ciempliance withEYC0obta copy of(" ahttp://www.ab.org/ls/LICENSE-2.0Unless requiredapplicable law bd to in writing, software # dis@#edT9 is!n "AS IS" BASIS,ITHOUT WARRANTIES OR CONDITIONS OF ANY KIND0either expr@or iEped. Sehspecific languag`govern`permiss and limita`. im7D sys o Dtimetmarshalre from enumort Enumfunctoolscmp_to_key!Pdatace#"0typDict __all ["Stats", "SortKey FwBionP'1] u 4Q(str,)bCALLS = 'calls', 'n 5CUMULATIVE#umulative(0cum/')qFILENAM''%mK$1LIN Bline2.H0NFLj2nfl"Pp4STD;6std>"TIa, 'tot  \!demew__(cls, *values 1 = As[0]9obj = str.__nC)&!.__FBo!*Rs[1:]C3clsG2member_map_[>u] = obj]Aobj.+S}s!45 @z(unsafe_hash=True)0 Y: int tott ime: float percall_tott!o#old -1, 0, 1n2are respectivelyPerpreba@'stdA@', 's 'p'cumulaA'9t"s # ay)0quoipstringsSortKey enum0selDSorder5For example !='')ZeR.TIMEQNAME)I2s o1majy,'internal j o7min6C V'. Look atCPtwo ts)&Aget_arg_defs(self)Dmore%s return 1P, so Bcan P toge commands likeeP('foo`goo').;p_dirs().*1).\?  print_stats(5).print_caller """ def __init__(self, *args, stream=None):,9#.# =$ or sys.stdout+if not len(REI`arg = ^1Felsej%>5[0](As = &1:t)3Aadd()+,LB.all:em # calc only Zeededi1fil1cn_listlptotal_t0O Aprimmax_name_len = :top_level;et(.sAZ = {}sort_arg_dic Qload_= :tryEget_7except E:ionA ("Invalid timing data %s" %1.@[-1] ` ''), =HVraiseD3 J if[1 is 0.- jfUeturnelif isinstance]6rwith opu, 'rb') as fy+ }marshal.*(f >#@ = o at ;*`time.c(;P.st_mP) + "-0" +/:|in case thisSbIunix04Ipassz)F[arg[phasattr, 'create'cHarg. :zi,  O6ot A w TypeError("Canconstruct a %r object from %r""% __class__rE6-for func, (cc, Ptt, cG) inw.items(CV.Q+= nc# _ += c#F tt4F+= tif ("jpro's", 0, "!r":ers;.k?%!if0_st&Pring(B)) > h#' =Ttd_string(func)) def add(self, *arg_list):"tif not preturn >1for item in reversed(?Y@qif typeB) !=> )-U= Stats($t.files +=%total_call+1Kprim0/L%tt +(@func(.top_leveld .;"!if.max_name_len < `# B2io!cn0z = None"e, stat s./s( f /c/@old_,_$" = s[]o1OelseKE(0, M{},)Lm =I)s(G:\Adumps , ("""Write the pro# data to a2 we know howload back."""m with open(Cf, 'wb') as f'marshal..g3, f # 7tuple indices and directions sorting,# along 0somintable descrip:,9_Jdict_default = {"" : (((1,-1),1), ( count")6 "nFE'pcumtimeE3umulative 0c""J,1" J?4, ( 1lin D5D( numberFRmodulH&D6J0nflJH((4p//p80Bi10stds7standardtime" : (((2,-1), ), "internal time"), "Q "totO :H(!} Y def get_sort_arg_defs(self):!~ """Expand all abbreviations that are unique."""8pif not N.a6ict[_ = dict = {}N+bad_lisfor word, tup invault.items([pfragmen_L { dwhile & % )]breakc%ifd l-[r_] = 0X/vg E?tupGi% =Y[:-1]-1del[oA_returPBstat, *field zq4fcnK .}rif len(c` == 1 isinstance[0], intt# Be compatible with old profilerh.e = [ {-1: "stdname" ,0: "calls$1$8G2#cumulative"}[V[0]] *el J>= 2^0argA:1:]"if type(arg) != 0+0]@0raise TypeError("Can't have mixed argu\"")/;/" = 2tuple = ()=Od7 = connector 7if I), SortKey  ! =e.value!+ p&[0=2elf6+= A /g= ", "p[wfunc, (cc, Ptt, cpallers)6uD _.append(O@) + h) +/ (&_std_string!),=)rZ(key=cmp_to_key(TvPComp(_tuple).compare)C) self.fcn_list = %[]&for tuple in stats0:!N;.append(1U[-1])'preturn udef reverse_order()Y!if.s-.I(p strip_dirsm1old" =u md = new %{}#max_name_len = 0Afunc, (cc, Ptt, cpallers)[w.items(0newDBunc_Ppath(,aif lenA_std-3ng(CX)) > WA/ =M 9Bnewc7 = 22, $ s6R[%p_S2)] =PV5 if4h[P@add_:_(\ L,; )OelseT told_toptop_level!2tqpV 0new9D.add) z = NoneAall_i,es Dcalc1 'T R ; &A) 70ot o `222('/#*.H The followingf tions support actual print"osA.*@# Opzal "amount" is either a line c, or a percen2tage of lines. def eval_print_amount(self, sel, list, msg): 1@new_! =Iif isinstanceEf, str)9%:tryrex = re.compil=)X"`except#^errorC msg += " \n" % aetreturn  %Y = []for func inif rex.search(,_std_string)+vr.append,~Jelsenc0en( Jfloat) and 0.0 <=j < 1.0Z^Bint( */J+ .5j.Qist[:3 </el$in<5sel| Dif l'1 != 4 b0Lisduced from %r to0due re ctt ^8< 0@ 2(+2# _hs*0ileBsL(*e },E nd5= ' ' * 85unctop_leveliG,T%K~oG`total_;Ds, "Q ", end=' 'VdJ# !Bprim]P"(%d #Ritivet@)" % f.<p"in %.3UcondsN/tt C,27(q!if. x5ftitle(P ="A(func)   print(file=self.stream) $ preturn @ 9Adef 5_callees(, *amount):&_width, list =BR.get_=(32!if.CG_U.calcq)!V_heading("jed..."for func inwZ%if!e4all -&Dlinek,H[]JOelsed%*{}PLrS Bwas ? by!cc, nc, tt, c$rsRstats{rs, "<-K- , name_size, column_title"Function ".ljust(:9) +</, h#1P sub- er only if we have new-style%rsc3sub4u= Falsei..values($ifmi2 = next(iter(L)dQisinstance(L~, tuple5Ubreak if& 5 "*@ + "xns tottime cum "k _ Psourc# diarrow="->"L_std_str~>)8F, end=' 'aif not_xBcxQortedYg.keys(Pinden%""=q1I ! =2 2 & =V?if C vcc, tt, ct = vkalue if nc != cc:,substats = '%d/%d' % (nc, cc)2OelseHEB p1s %1 %s2 .rjust(7+2*len(indent)),f8(tt), f8(cNnameleft_width = #_size + 1n>Ts(%r)J0, vQself.j[func][3])3Sprint*$+ s, file=vJreammSq = " " \Adef Xp_title(;) (' ncalls tottime perY cum', end=' ' Z5:lineno(&_tion)= 4 , 8): # hack: shouldqentagesB<@cc, Ptt, cPaller3 = str(n#jc = c + '/' +7Zc/9)3dF== 0~_' '*8yB?/nc?cc JOct/cunc_std_stringm w class TupleComp"""This provides a generic for compag any two tO!s.Each instance recordKrlist of,-indices (from most significantIjto lea), and sort direc(ascending or de )Keyex. Thees can then be used as"Nargument toasystem%()+ wH)a `s need9bAed iw7s order.""__init__[_select_d+ 8omp3l-Care \w, rightW'x,|4in op_select_lisGt: l = left[index]r = righif l < rOZreturn -directionU8>87Qo0 #*6" # func_name is a triple (file:string, line:int, )b) def@)up_path(P)I6FB" =70os.DP.base )>x@get_qbzU 7[2]6@std_!ng/9): # match what old proQducedi[:2] == ('~', 0x # special case for built-insP.L!ifu.startswith('<') and3end'>'<'{%s}' %0V[1:-1Belse15 ""%s:%d(%s)" %F= Th<qllowingg9 combine statistics cVpairs'@. # Bbulk of the@cessOinvolves corly handl "call" lists, # such as 1ers~ ?es.:T1add_s(target, source"""Add together all30twoentries."""cc, nc, tt, c0all=e% t_'!t_)_+ t_-!t_Rrs = /B(cc+:n =1t+t@c 1ct,0mS(],m)j &CR` in a !le 7new!{}M8?s.items(A[43] =KK\nV if isinstance(d, tupl# mat used by cP&qV`(i + jHP i, j5zipz 8)))\ ?j l ;) _) +_$c6= caller return new_callers def count#s(): """Sum the  statistics to get total number of)s received."""Kanc = 0 3for&!in ers.values(y}Qnc += s7_c #*6 # The following functions support printPof res:Cf8(x"%8.3f" % x=Sbrowser added by ESR, April 2001; if __name__ == '__main__'p im^A cmd2tryreadline!except I7VError0Qpass &class ProfileB(cmd.Cmdsa __init__(self, p4W=None*.@.2)pD.prompt = "% P@s = b=stream = sys.stdout%$ifq is notHgk0do_=()sgeneric@fn, f 0argz.split(processed = []term in G V.append(int(L)~0 cou#/Vk .: 0fraCfloa @1if *b> 1 or >< 01vQ("Fra5ument must beI[0, 1]", =3[ jLHe)  P3if >ats>qgetattr.]u, fn)(*[ NelseF|(No`objecti@loadx `iQ_help d|1Args may be:9 * An integer maximum number of entries to print.", file=self.stream) '-("* A decimal fractional number between 0 and 1, controllingbe what]selected+ regular expression; onlyVwith funo namestmatch it areY/ed[\def do_add(|, line): 0if j.stats>try5.`Z Y%except OSError as eN`Failed:Pload istics for %s: %s" % (oO, e)Z ?elsrn(Nobobject is |\return 0pEhelpr lxpAdd pro info from given)~currentcalleesgeneric('_<'/!]P (Hthe  {m_i9() "dor(/rs ]/rs[1EOF i/("t1Wk__`Leave browser _do_quit8B?rea:  h4@ = Sq B8.rri+err.args[1] 5U{E1ion} t(err.__class__.__name__ + ':', err, file=self.stream) mreturn8prompt = line + "% "*elif len(/i) > 2:'wC'= )][:-2](!do_read(5 Nelse]*print("No statistics object is current -- cannot reload."& % 0def help)Read in pro data from a specifiedSWithout argument,E themR aQverse, "ifSs.1.reK_order(0e, OR>Qsort 1 ofing reportTHsQ|9Uabbrevs @get__arg_defsand all((xKa) for .split()r|.n})(*6  `Valid I keys (unique prefixes are accepted):(key, value)RStats0ict$ault.items(M %sug%s" % \O[1]){'f |tSex`accord'to~:V@(TypB`~;' wps lists;!id/.)v Icomplete, text, *args1 [ata P if a0rts(Y5)] d2do_u .generic(':'6 W!Y >0("PB tream)  self.generic_help()  def do_strip(*, line):"*0if j.stats.Iy_dirs()CNelse:print("No [istics object is loaded.", file=hFream] eS leading path information fromgnames in the reportF@how $ for a given comman dqpostcmdbo, stop>topnareturn9XBNoneif len(sys.argv) > 1Opinitpro4 = %1[1]U  ,br6tryPbrowser = PVB(=;~&in62:]SdW.do_add(4IWelcome to'I9str`cmdloogkuGoodbyeN1I except KeyboardInterrupt,pass # That's all, folks. """Pseudo terminal utilities."""7`Bugs: r ig! handling. Doesn't set slaveGos and window size. # Only tested on Linux, FreeBSD,8PmacOS2See: W. Richard Stevens. 1992. AdvancedPgrammqUNIX Environment. Chapter 19fpAuthor:]en Lumholt -- with addis by Guido. 1selvmRect i$os %sy 0ttyP/)ed directlyP mockpurposeso3os ]close, waitpid4ttysetraw, tcgetattr s  __all__ = ["openpty", "fork spawn"] STDIN_FILENO = 06OUT16ERR2 CHILD/ a($""s() -> (master_fd,?2_fdoOpen a pty $/_pair, us5os.` if possibleo 56@(AttributeError, OS OH @ = __J0_fd#%(8 Z1fd JaN Rc Tmreturn the fd, and the filename of&slave end. Deprecated, use openpty() instead.""" +Atry: 8master_fd, R_fd = os.A+ except (AttributeError, OS )QBpass36lse]_0tty (1fd)4os.close}return J"__terminal() def """Open ptyZtJ(m@tty_k)L for x in 'pqrstuvwxyzPQRST']%y%0123456789abcdef%)p` = '/dev/pty' + x + y * (L,fO_RDWRc.continuex/taTraiseP('out^devices'(Z?"""5 ->^2qacquire'rolling ", 1ingG!edbdescriptorWfresult=  from fcntl import ioctl, I_PUSHI q( ~. _M(T, "ptem"E& ld3( 1 rSfork(2"""S(pid,o_AFork3makhild a session leader with a o!('if pid == CHILDZ os.setsid( c# already set us%5<L IQ# Establis4new\ )11# Sbecomes stdin/stdout0erroc9 gEdup2S, STDIN_FILENO>os.(?OUT)=ERR)%if >v% )slave_fd)  *# Explicitly open the tty to make it become a controlling$". E tmp_fd = os.F (os.ttyname(STDOUT_FILENO),#uO_RDWR)?os.close(H^else:#slave_fd)  # Parent and child processreturn pid, master_fd def _writen(fd, data)n@"""WA alla descriptor."""Qwhile?>n _^/P=4C[n:]vread(fdDefault  functionx0os. fS1024)NUcopy(, =_q, stdin zRDR loopJeCopies3ptyU -> standard output q6, in+7-> L:)kwfds = [SSTDINZ]6fdsrfds, _wxFqselect(c[], []P#if0in BP"0# SOSes signal EOF by !Pan embyte string,B0# sFthrow OSError:tryzA ]i"dexcept\Jb7aif not: # Reached ) # Assume6  has exitediH=P# unrrable, so we clean u- $2os.| {7+8if A lu 7 n fd1movBspawn(argvPCreatBe9qqif type\B) ==#''*w1 = #,sys.audit('pty.]0', *d  = fork(> ifmVCHILDos.execlplg[0], *T )mode = tcgetattrosetraw`restorGATrueNPtty.e:# This is sa)ps termi(=,TRFalse _u -gfinall"3if d9ytcsetattr(STDIN_FI!LENO, tty.TCSAFLUSH, mode) close(master_fd),return waitpid(pid, 0)[1] """Routine to "compile" a .py filcp. Thissule has intimate knowledge of the format2.py@ s.t import enum lib._bootstrap_external%machinery5uti1$os tos.path%sytraceback __all__ = [, "main", "PyC#RError cInvalidationMode"] class 0`(Excep'!):5""" raised when an eb occurs whattempting toAnBile."ToN tevR, use",q exc_type, `value,c[,msg]eGwherH*3E: l U bev4d iqmessage5 name can be accesses as Svariabl@'_E': ]G#0 bedAg4msg@ str~}PwrittsaIf no  is given, a defaultF will b?consistent with 'standard' py_, output.m4(or)V%3msg?2"""Udef __init__(self,; ,5, msg=''! =2!._%__%if_aSyntaxDNtbtext = ''.join(._e_only(b>)Aerrmsg = m.replace('F"""', a%s"' %KJelseY"Sorry: %sT" % (D. or1msg:c HM.t<9+,' #! = = ^str__(self): < return self.msg class PycInvalidationMode(enum.Enum): TIMESTAMP = 1CHECKED_HASH = 2+UN3 def _get_default_in _mofif os.environ.get('SOURCE_DATE_EPOCH',.Belse: Tcompile(file, c=None, d oraise=False, optimize=-1,u Lsquiet=0"""Byte-| one Python source {4 tobytecode. na:param%Y: The6Xname.'(ptarget O }dG 6 When not given, thisLsthe PEP 3147/ q488 locd G: Purportepp, i.e. K that shows up in~error messages. Dp;K : Flag inding whether oran excep+euld bed54n aC is found. If Ioccurs andRfPs setU^ya strin%nature of3will be printed,pae func"W!toGrcaller.K]  True, a PyCIEH{2be B NI level forcPr. Vf valueare -1, 0, 1R2. A&7q-1 mean21useTowicurrent Urpreter, as#` by -O mAline9ons 2: Rfull output with "0,lbs only)no;23`: PathlQ`resultj80Not(at it isn't nec ryG9`modulerRQexecuefficiency -- itJBs a FkFT load ifcan, writes0"thcorrespondA.pycPHowev!ifrinstallis sharetween users,Ais agood ideazC all8on ]b, sinco\A maypbe ableU in the source dir#ectories, and thus they won't be able to write .pyc file,4!enA80uld8$byte-compiling every module each time it is loaded.F#This can slow down program start-up considerably. 7BSee neall.py for a script/mythat use$is!toCe all installed0s (R#llin selected?4dirQ)QDo no6at FileExistsErrorraised if cP ends up point6Aat a]non-regular or symlink. BecausRationa0renamingthe resulf|#wog1notsame type ofU!asit was previousQ2"""f invalidP_modeQNone:".#= _get_default_!!()=>;is Sf optimize >= 0mq& =*i61 else ''m9= importlib.util.cache_from_source(\t7= L Is.path.isR(E)Ymsg = ('{}az@willPchangdnto a F ?B ';XHs a rw2it'0 I(msg.format1'eley o # 0oneMT(r machinery.SL{rr('',G_2s =!r.1ata)6try;c.D0to_(S0, d|+_eeexcept Efas errpy_exc = PyCe(err.__class__,4 `if quiet < 2Y!do   J/psys.stdy(:.X+ '\nCetur@dirn$= dirname(cfile)  if dirname: os.makedirs(!)!except FileExistsError=Apass) if invalidation_mode == PycIMode.TIMESTAMPH source_stats = loader.pathR(fileQbytecb importlib._bootstrap_external._&_to_timestamp_pyc(I#(, 0['m0,']bsize']7elsF?ghash =Wutil.( sI < j p/,(CHECKED_HASH)E1alc write_atomic(c$, ' , wqreturn " def main()^f argparse pdescrip# = 'A simple command-line interface for py_compile|Qule.'KV5r =b.ArgumentPp'r(l= >c.add_a7'-q', '--quiet'z ac='store_truehelp='Suppress ed outpuC{p(sZnargs='+m@s to@"!h53 = "s( if:%s.q6R['-']$ [ .rstrip('\n') in sys.stdin.readAs()] 5w-#X s6try (D, doraise=Tru]2PyCY\# a T'  sWr.exit(1Y  1,&F.msg</OShAstr()) if __Q __%0"__2__" a() """z a PythonR and be its classes1funUBs. ?enough ofIrecognizeCOM Mp defini s,=@find the super9"esk X. Th@cons$tsingle g module_ex(module, path=None) where module is the name of a Python, and path)an optional list1directories YOm] o be searched. If present, Yprepended tocsystem7@sys.0 . The return value is a dic#ry#@keysA ared classes1funJs defined in2(including 7@thatY 21via3from XXX import YYY construct)s@instance^CF. One special key/E pair is c for packages:pkey '__K`__' ha<bas itsS which contain$H1. :s have a common super: _Object. Every  `follow^attributes: E --1;#+ #ot#Cfile# "in)4alinenoz @='8ir startsF@end_? no I3endGaparent of this , if anyuchildrenscnested'sA . b':%' jP mappxsXs. I describe fAwith}g!s 8+R, pluis_asyncU _Aan '+'~;fixCc& ]"of3(sspossible)pmethodsh2of r`beginnRnumbers. I not recognized,corresponA ent0is Ha but a str0giv(. Since'statements L#ed:P scanpas wellis shouldn't happen often. """ HD ast 4sys  lib.util __all__ = ["readv7", 0_ex R"] _1 s = {} # Initialize cach$@we'v6 9"InformadTabout%or ." def __init__(self, module, name, fi lineno, end_ parent): ?.># =G S! =Z f! =m m2 = ' = %2 = children = {}#if- is not NoneM.@[@] = 6 # Odd Function and Class signatures are for back-compatibility. cl-@t(_Objecl"Informa[bout a Python fs, including methods."_def _3=, is_async=False, *#$ uuper().~,je.{% =!if isinstance(,.#n" 6ps_jThZe or []=DuThese 2used in ttests # Lib/ _pyclbr,idlelib/_#browser.py Tnest_A(ob,w_,6 "Return aPfter _Ewithin obr0#ob 0ob.9= =') n C / a+(wc,(  Bread)(i, path"! o.s^the top-level esM!. @This. original interface, befores were added.A2"""JMkey, valuev_X).items(  Hpres[key&2res1~_ex(module, $path=None): """Return a dictionary with all fun s and classes in module. FSearch for"PATH + sys.v.*If possible, include imported supere0 Do this by reading source,3out>(executing) itE1"""}r_J( , or []) def &{packageIe hard worklS[_ex]1SIf inF is given, it must be the dotqname of4nwhich we are s Ta subQthen dFUA ; otherwisj`top-levelEkNis combined # ComputDfullDq(prepen3bf set)iM@not V = "%s.%s" % (Q,t)Oelse=Fp# CheckUcachesBin _8sV[0]^InitializS8'dbntentsztree = {}Ef\is a built-;>don't do muFthesmB#in_O -"s[K@] = o] = r3i =.rfind('.'V >= 0s3A[:i]l-RV[i+1:!parent =S@X&H WJ0'__l0__'Zqraise IbError('No PJd {}'.format()j,[])$e1f = 4! =9 %0cspec =Blib.util._J_Q_fromf(,i(0if /~M,NotFoundCf"nocQ!r}",=kI MD# IsXage? if spec.submodule_search_locations is not None: tree['__path__'] = sH ;6tryDdsource:loader.get_R(full)=except (AttributeError, Import )^R# If ?rPython _, we cando anything.kpreturn 7els#ifH]  =>Ofnam@file _create_$ , z!, W,,, inpackage) class _MBrowser(ast.NodeVisitor7def __init__(self,An>ileet4.! =! = 0 =  = & = #stack = [] v _C3DefCnodeRbases8@for @ in .. s$0 = ]unparse(&!1if (5in  G&# We know this super (ds.append.j[f]|elif len(As :=.split(".")) > 1SP form.4@look/(7&*_jO"_ si2n _[ + +[3]i(l,)+SE)Y `parentAelf.{P[-1] * FL1 = ,jh,}"s,4*ulineno,N=b, end_2=2if /[B&!g"generic_(Q !CCpop(j@Func , *, is_async=Fals=G]fl4 = wIion self.stack.append(function) $generic_visit(node!Eapop() ;Adef .s_AsyncFX@Def(R!, E:,j.1,&`, is_aF]=TrueaoImportW!ifi.col_offset != 0x|breturnfor module in@Znames6:try;a_readmU(.T!, Cpath inpackagb@rexcept ^Error(l&[])Q(R, Syntax_)`# If we can't find or parse the i#edA,p# too bad -- doFdie here.-continueTOFrom/  = "." *Ylevelb.12 +=A B> =   1ame(Ptree[R0.as!>3] =#])elnn== "*"km_D,zQ_valu.items($if7D rtswith("_"48 0 _create_4R(full", f, source, &&, "mbrowserBMbBQ IHQ(ast.()<? -KDmainkc"Print output (default this file) Pquick0ual check."31 os mod = sys.argv[1F & __l!__F`if os.ap.existsD = [%0dir&eY$Ebase%f$ if.lower().end]<.py_rmod[:-3gFelsew6 = V0_ex:lineno_key = lambda a: getattr(a,$ 'lineno', 0) objs = sorted(tree.values(), key=1_key, reverse=True?indent_level = 2TQwhileZ:h! =R.pop(> if isinstance(obj, list);&0# V is a __path__.b'continueif not hasattr_''cBobj.X = 0 C l_ObjecJnew_OSchildrenWZu4for ob in { 5(&ob"+  .extend(X [ClassMprint("{}c2 {}"j .format(' ' *", Bname Rsuper )/elGFunction3defx` if ____ == "__main__"() #!/usr/bin/env python3 """Generate P documentaHTML or text interactive use. At thB prompt, calling help(thing) on avo }sPZ, andA) starts up an q a session. Or, ashell commPB outside of: Run "pydoc " to showqon some#. - may be >[3a f, module, packagQr a dotted referencer"a %or?0 win# aGQaUP. IfAA arg 0ain@ seg delimiter (e.g. slashUnix, backWindows) it@treaaW&tosource fil"V-k " to write out@HTML documentation for a module to a file B2d "J.html". M'Bs9Ccore<s are assumedzDbe in https://docs.python.org/X.Y/library/ This can be overridden by setting PYTHONDOCS environt variabdifferent URL ora local directoryZ4ainZL1 Re<ce Manual pages. """ __all__ = ['help']QuthorP"Ka-PQYee =Bdate( 26 February 2001" __credits"""Guido van RoX,tan excellprogramms language. Tommy Burnette,original creator of manpy. Paul Prescodd0ll work on online. Richard Chamberlain5first implecof textdocE # Known bugs that 't fixed here: # - synopsis()&!no'prevented from clobberexisting> loaded.A- If ____ attribu*n is a relative pathxC @1cureShanged with os.chdir(), an incorET@willqdisplay!imbuiltins lib._bootstrap _external%machinery6uti1enspect%o o8pkg2platform)$re %sy4sysconfig5tim(utokeniz0urlEpars0war"s Pollecs}RdequetreprlibBReprtraceback0at_`pN_only # -% common routines defMqdirs():""""Convert sys.!in@list`absolur, uniqu s.nX]ZJnormedir inl= =@.abs(/qor '.')U*Y.@case/(0if C$insNk is'3dircz.appendXYs!}`returnu_findclass(funciQcls = mQs.get!2.__"__R0if .vis None5jbAcjp.__qual__.split(LV[:-1]G\= getattr(cls, name) if not inspect.isclass(cls):!%return Nonecls def _finddoc(obj7'ifTgmethodU = obj.__func__.__!__f%Eself% Lif (#U) andBFgetattr(& , k,D), 'Y') isI!# # g`cls = ]FelseH?%1.__J)el4Otion6 >[Y;0if |!isD or 2cls:obj obuilti&/Fr.__qual  + '.' +$ =_!T# Should be teste fore isdatadescriptor().Rsinstance, property9Afget<0 = G='<I($~ !~' 1obj/if)kmember0@slot Z1'__3__'o4*a, dict1in  n>[]] x%for base in.__mro__^6try gdoc = _getownG=Pexcept AttributeErrorQrcontinuPb0if e!is 11doc(A"""Get the]`umentaU string  an0ect  it"noX`inherifrom itsA.""" (qI_,u"__'__doc__',o(3objZ type4 w!).v__  if isinstance(typedoc, str) and  == doc: return None1docexcept AttributeErrorJ.B def _getdoc(object)*"""Get theumentationing for an 4!. yAll tabs are expanded to spaces. To clean upWstrings that5Fbindent9@line,with blocks of code, any white_Ern can buniformly removed fromqsecond ^onwards is(A."""Qdoc =7own" if7J56try FLfindD(R, Typ,hif notUQ 5inspect.Qdoc)  `or com!sHcresultKg6T) or 4getFgC"re.sub('^ *\n', '',  .rQ1p()Z"''Aspli@"""S! a6ng into a synopsis0(ifi hekt"B!s .FAp().pa('\n')qif len(+)1r0[0]4*el6A>= 2.%1]P s\n'.joiB[2:]z=$classnameP, mod!!a ) qualify it a82ule"ecessaryF<=L __!__ &ifmodule__ !=T& D-q+ '.' +S1!cisdataPCheckAof apt probably means it's NnDot ("iss!isP-Gdroutin&frHtracebackw isoPreplaext, *pairs;DHAeriesglobal 4* onk,awhile L0tex;2[1]i20])%" =J;Pcram(, maxlenOmit partnae@makePfit ipmaximum5gthif len(text) > maxlen: Ppre =R(0, (v-3)//2)$6ost%$F-pre$ return text[:pre] + '...' +@len()-post:]^6) _re_stripid = re.compile(r' at 0x[0-9a-f]{6,16}(>+)$',)IGNORECASE) def Fp6"""Remove the hexadecimal id from a Python object representation.""" 4# The behaviour of %p is implem0-dependent i0rms+Xcase..sub(r'\1',3!) _is_bound_method(fn)KR|s True if fn!a 6 6(qgardlesqwhether@Wfn wa edr Cif inspect.isa&c 1zbuiltin2self = getattr(fn, '____', NonnWnot (`odule(4Q) or =bFalse a2allCs(cl[Q = {}for key, valfngetmember?,isroutineRV[key] = 1Z@basegPcl.__ 2s__7.update(+)) # all y0 arlong to ush0keygo.keys(0cl, ACB_split_list(s, predicat@"""S! sequence s via(c, and pair ([true], [fA]). |(s a 2-tuplea!s,,;@([x xsF(x)]) )] -_ryes = [&no p&if'(xs`yes.ap/"(xeFelseA+no' ryes, novisiblename(,=, """Decide .show docu on a variable.# Certain @ial os}redundantinternalCc# XXX __initializing__?Z!ifK{'__author3'__=secached{tK0'__@+4doc Dfile ?Uloademo, apackagSGDpath+Hqual;2sloTversion__'} 0Z# Private2} hidden, but special names are displayed. if name.startswith('__') and7end: return 1?# Namedtuples have public fieldsGmethods ^ a single leading underscoreRhasattr(obj, '_c1'):95TruMall is not None,.# only document that which the programmer exported in __all__rD1all7elsk) m') def classify_ _s3ect"""Wrap inspect.) 2,ffixup for data descriptors."""results = [].(, kind, cls, value)w %if is(T0s@ = '+'!UsinstanceG,Rperty\P.fset ClAread1proCn.append()4Asortqibutes(V, obj@'Sory!e  list in-place by Fthen alphabetically## This allows to be ordered accor#ao1ttrrpresent/s` = getB, []6try9_~@ = { : i-len(!s)1(i,wrenumerate#}except TypeErrorf/keyfunc = lambdam": TA.get[0], 0),$#[0 s.S(key=Qo) # -! module manipulation6ispackage(pathGuess whether a r refers7 directory`if os.1h.isdirZ  exx ('.py', cX( HTfile(WAjoinV_init__' + ext)A.RFalsesource_synopsis(nIpline = .(p0whiWine[:1] == '#' or(s.strip(JN0ot &q: breakN in8S!if+2[:4~ar"""':/2[1:l+3+*Exa#[3262-1:7+\\`2:-1a/ not line.strip(): line = file.read)()#pif not u: breakresult =.split('"""')[0].stq.eelse: 0ANonecreturn def synopsis(name, cache={}"""Get the one- summary out of a module1"""n@mtimuos.statbQ).st_'lastupdate," =6.ge60, ( , )56if >1 is8 or!< k# Look for binsuffixes first, falling back to source.!if.'.endswith(tuple(importlib.machinery.BYTECODE_SUFFIXES)ZLloader_cls = BSlessFileL//elEXTENSION'Extension&sen # Now handlebKchoik ^# Must be a:try6 = tokenize.open+except OSErrorK#Acan'Med, so skip itQU c# textRPs candirectly examinedP_Iv5 TZ+m, which has #be*edv('__temp__',F# XXX We probably doU@needoqpass in0b7herEIspecNPutil.`_from__location, T= W _bootstrap._H( K Xdel sys.n&s[]1).__doc__.s s(s3 if" DP0# COX#i[Q] = (&=@ clqDuringIs!(E3ion]1"""%s that occurredl ry#tos somethdocument it.-__init__(self, exc_info): self.filename = # s!Qexc, Svalue tb = exc_info 2def __str__(0!):LRexc =E`exc.__r%__ return 'problem in %s - %s: %s' % R,{0) `importS(pathA"""I a Python source or compiledgiven its EA."""@magielib.util.MAGIC_NUMBER(with open, 'rb') as]is_bytecod|].read(len(!))X8a = os.1basj&"t'splitext(C+7if loader = _bootstrap_external.SDlessFileL5(dOelseZ$V# XXX We 1ably don't need to passECthe Qhere.H?spe`_from_%_location,K=R6try7 ._6(f9gexcept<aise ErrorDuringd, sys.n#()Bsafel&Pforceh=0, cache={}module; handle eu3s; None if =*0 is^bfound.I Q*is* p but an epA occurs, it's wrapped!an ;pand rerd. Unlike __0__,aGqpackage@ is ihified,!atRend o01ed,N"no)V8beginning. oEal '}' argumentLis 1, we rWo disk (unI%a dynamic lension) q#f 1 5has been previously d #always haveM . Checking1''sJSmtime5good enough (e.g.3could contain a clasIthat inher another B"changed)6if nM?s2$i(builtin_0 59`# Remo/$he;s2re-Y5try5F#'QavoidQlems RvpartialX@# Also rsany sub. because they won't appear # in the newly loaded module's namespace if'y're alreadyLBsys.?-s."subs = [m for m|0d m.startswith(path + '.')]LB0keyD[)@] + `:* # Prevent garbage collection2cache[key] = d?del) = __import__)KfexceptP# Didq error occur before or after Xwas found?P(exc, value, tb) = info@exc_(10if IR$H# Anred while executingK cpraise EqDuringI(v.__file__,elif exc is SyntaxN EHw3uldeP\.(issubclassR) and.@1 == sNo such eturn NoneLelsePSome otherdkproces,`@part&p.split(F[1:]Dtry:= getattr( , CQ7 AttributeX;: r D_ # - 0matxQbase ! a Doc: vPYTHONDOCS = os.environ.get("!",."https://docs.python.org/%d.%d/library"H%qversionR[:2]) def document(self, object,=N, *args)"""Generate>aK%3 anD6.""CH = (_@) + p# 'try']0use0to umpt to handlpossibility thaYWspectLidentifies somethsin a wa5pydoc itP has "esiGing;O@k 'super'`how ita descriptor (which %sO7ionOpby lack@a __ __an instance#I? if&.ismodule(object): return self.docmodule(*args)  if inspect.isclass(object):ED routineF Hexcept AttributeError:Epass datadescriptor{'  )Tother$mdef fail(L", , name=None, """Raise an ion for unimplemented types."""hmessage = "don't know how to docu:Q%s ofD %s" % (GK and ' ' + repr(!),4$0.__&__r2Typ(!) `M =  H property! =RQef getdoclocebasedir=sysconfig.get_path('stdlib'))ythe locatz2of Ps or x.6tryG0fil`getabs9; 0H'(built-in)'e = os.environ("PYTHONDOCS",@A.normcase(if (isinstanc 0s)),]! in ('errno', '@ions gcYimp',EI 'marshal3Pposix Bsign?sysFp_thread=zipimport') or(.startswith l not /1os.[Djoin<, 'site-packages'))B+A^Exml.etreetest.pydoc_mod: if8loc("http://", s  ;c"{}/{}.html".format(.rstrip("/").lower()IVJelseO3YB + "c_E! =_ # -P HTML\U*generator $R;j@"""C(safely making2nResentWof a Python^__init__ePt..maxlist =$.maxtuple = C20 self.maxdict = 1string = +Qother,!0 Hdef escape($, text):greturn replace(P, '&'@amp; <1< > Vgt;')bCrepr`_objecb^Repr.( D1Ex, levelif hasattr(type(x), '__name__')`method@ = 'v_' + '_'.joinB.@.split())Fs<W p.J1get 2(e3+.Pcram(@pid(Z(x)),)z_0/ng<0tesA\xM7's = r(if '\\' in B and0notC stF0, r0<, '# Backslashes are only literalLBthe g#Unever:q'# needed to make any special characters, so show a rawX.K 'r&R[0] +z1) +"GCre.sub(r'((\\[\\abfnrtv\'"]|\\[0-9]..|\\xu....)+)',H r'\1:U9 5 :ing_instanc8<6try {t'ngxoexceptWT'<%s >' % x.__class__(|unicode3 HTMLDoc(Doc"""Formatter %1for) documentation.""":?# -JfcutilitiesM_! =0D(: = '`J!c4pagtitle, contents 1 an 7'''\ <6><>Python: %s''j(*OPi(fZ,a, extras="""Format a page heading.""" return '''
(y h>r2d7 border="hXColorg
(a g. 2d_add"> Added ChangedABsub">DeletB h/(f)irst c >  o>(n)ex7 Ot)opf /  HtmlDiff(object):^"""For producing HTML side bycomparison wi  highlights. KBThis can be used to create an^`(or a ]AfileLpcontainAthe 2`) showaQ, linRJ@of t}ainter-'and intra4 TzMbe generate> either full or pextual [erence mode#be follmethods arevided for iBion:`Qmake_ 5 --s.7Ingle<Ac @1 O PSee tools/scripts/1.pyan exampl@age #.B_`_templ**= -_styles =  ; & default_prefix = 0kdef __init__(self,tabsize=8,wrapcolumn=None,NBjunkXAchar IS_CHARACTER_JUNK*4"""` insta9rializer*Argumentstab stop spa#, s8v47 number whereUs are broken and wrapped, defaults to None where lines are not:.:junk,char  -- keyword arguments passed into ndiff() (u%byLRHtmlD to generate the side byPHTML Ierences). SeeLi1docation for P valund descrip,s5"""\self._tabsize = ecolumn =8 &@! =jB "Y$=  #def make_file(`, fromSSs, to 0='' Dscontext=False, nuLa=5, *,~set='utf-8'):B"""Returns 2 ofcomparison withOnge highlightsA8c`@list`""9s (,to&: 'G header string[3R1Qe0setZATrue8ual# (~which shows ful<)y`number/s0. When 0is !@rolsI displayed before and afterfchange r,cgzto plac)Q"nextk anchorse(so click ofPDAjumpwHjustJ_- --ar !ofpj= r* .`_templu% dict(,4pstyles="._ clegend! !Rtable 0(b   57)>=c)).encode(`, 'xml QrefreX').de%)7 @_new_0g,#s,'1/to! es expandedfs removed.pInsteadq1tab!AacteCing dVspace0neeoto fill in@20extu stop, thi  nc w,1Xthe space with t&ab characters. This is done so that the difference algorithms can identifyQnges in a file when tabs are replaced byL spaces and vice versa. A~aend ofHTML generation,5tabKw will brwith a nonbreakable {.?5""" def expand_u(line):P# hidb"alJs20 = .(' ','\0')*#j(OintoP Qself.'l2kAdef $_r@per(=v,diffs)6 """Returns iterator that e0s (>@s) m9Hs"""pull from/to Qflags@c1for 31,to6@ in rs# check 70con%1orstpass them througoA2if __s Non_yieldHIinue(, Q),(to!to, =` B#)'Q> at,Qcolum;KformHv?$,st = [],[X5 r5 &ne  9el3ne,  3&# ~qin pair+0ert\Rblank& a# necessary when one chas more82ped@ Qwhileu o gG?rom!)y.pop(0)r+PE~('',' '>CS%A!bcollecsC&s.j into separate lists Before storing the mdiff from/to data into a<, it is convertedK%Psinglh ne of text with HTML markup.56"""t1,to@flag a = [],9j# pull@and 4sstyle iterator@1for&1,to<@ in %s:++:try#8ehs8TsQ@ .append(self._format_line(0, ,**-))E,C1C Aexcept TypeError$ions occur ;ps where AsepaeMs goONone $FFareturn% HjIdef ewR,side*@num,)A"""R_s"" / "to"Df] -- 0 or 1 indicatq<&or=:6/Qes iference on h0 0num3 number (usedfcolumn;: Qto beUed upg y= '%d' %5num>6id = ' id="%s%s"(pprefix[1#],M# handle blankzJ0'>'/''# replace thosings that would getf^wfsymbolK=.Q("&","&")>)gt<l<# make spnon-breakable sosy don'tPmpres!or0 wrm! =' ',' ').rstrip()g'%s No Differences Found) R4 = [ +5 = ?/['Empty File## v on firste k3:[0](r/[0 D0">ffR# red[(@j5top0v/y top">t' % (toprefix) return fromlist,toAflag next_href, "id;def make_table(self,D1nesEdesc='',to context=False,numlines=5): A"""Rqs HTML z of side bycomparison with change highlightsfArgumentsdz@ -- `"!" (9nes(,to&:'G file column header string[3R1Qeset to True for  ual differences (defaults-~which shows ful<%).+y`number/s0t. When@ is 6Vrols Iq displayed before and after the r,c8 gto placeI)"k anchors (so click ofHDAjumpwHjustJ_6"""#o` uniqu es so that multiples may existA# on9same page(0out VflictM!._k(:#1tab0spa\it gets m|Sicultwe inseremarkup;N2 = ptab_new1_re(. Qreates iterator 0genEHQ/to data if%3((0s = 9Oelse3 6Non|/H _m ,q,lRjunk=  aGchar/ 2&up,rto wraplexceed desired width#if6 _+Aper( collect ups as intops (also1mat,)Y0st,Aao_8tprocess@3s, Iing midd1of &>o/linkspzanvert_y(Jglist,context,numlines) es = []sfmt = '
%s
&return '
a W\r>5q''' % (0, fu, titleextras or '1') <def section(self9Ucontents,!6,>prelude='', marginalia=None, gap=z:<"""Format a with a'ifZ@ is ]Nz = '' +" * td@d= @@u3big  xf*args)#?big'\n'A09f'
%s' % ydef grey(self, text): efont color="#90"SM2KnamelinkO, *dicts+"""Make a , an identifier, given ?-to-URL mappings."""n@for ]1 ins!ifC @a href="%sa(\[!],J)z:Pclassobject, mod)  ? 6?bule = P0.____, sys.modules.get(!&__if hasattr( and get#isr 9&'<5k.html#=,jx, )t" +f } 7 ~u #s )7pkgmodpkginfo or package to display?Index, path, is9, shadowed =%if!(.2_!ifj 4url = '%s.%s$( ?Oelse<]92 9vq%s' % (url, url) @elif'q ://www.rfc-editor.org/rfc`%d.txtdzint(rfca?pep sapythondev/pepsd-%04d/?pepK# Create a link for methods like ';.^(...)# and use GattributeJC0if k[end:end+1] == '('1' +.( , G;els af  kjS, funcs, classes_O %nd~ L".:>return ''.join(;?# - type-specific routines0defpmZ!ee, tree, modK, parent=None)S"""Produce HTMLF" a^A as given by inQt.get1bk().""" F = 'Q@entrAU'Aype(#A) is7(()(c, bases5tryxe3 = + '
C>t = result + self.classlink(c, modname) if bases and != (parent,):1@os = []!1forM1 insHL.append(Bresult = + '(' + ', '.join s)-)'8A\n
3elif type(entry) is/[]0]
\n%s< color="#f ">9>' %Jts[:i+1]), J[i])eS = '.0# +1F-1:]2@head,Rastrong !(Q)s">M Referencew locals|Oelse^ = '' result = self.heading( Q, '#f' 7799ee',("'index
' + filelink + docloc) >modules = inspect.getmembers(object,"is/@classes, cdice[], {}`for key, value inMh W%):G0# if __all__ exists, believe it. Otherwise use old heuristic. Cif (all is not None orn+()(R) or )D Aif visiblename( Dall,=26es.append(7y)1|r[key] =[/ '#5key:q '1basN0.__:s__)0mod0 = (0.__4__,mC%__: 2ys. s(R3if @ != h@ and1ule phasattrC@ule, Pzmif get-5!if>0key-1# b+ '.htmlpuncs, f? = g3{routinei_hisbuiltinh0A/isGy#fdw<'#-i%if ish4tio:Y+Adataw* sA %E 0docmarkup(getdocM"),preformatAH'%s' %rH Q+ '\n./4if , '__path__'"`modpkg%[]A}importer,wp, ispkgpkgutil.iter_ms(object.__pathk__):  modpkgs.append((modname, ispkg, 0)):6Zsort( contents = self.multicolumn]m,{JlinkBresult = +/bigsection('Package C~a', '#f aa55cc', selif modules , B, lambda t:[(t[1]IMf if class0lisn[value for (key, D) in<]Pt[formattree(inspect.get ~B, 1)r)d rdocument(!, Lfdict, c0CJ!es`ee77aa '.join(tif func~[ ?p1FunOaa77Jdata>? = >7!1Dat 55o
\n 0has@P(obje'__author__'markup(str>.<)2pre %Ao7799eev?if credits#=@C creturn qdef doc($, `=None, D={}, J*ignored"""Produce HTML documentation for a class object.""" realname = __%__#1 = 4or 2 Xbases@5__ "pcontent%%[]tpush = v.append6# Cute littleto pump out a horizontal rule between sec%s.lH0URule: def __init__(self) $p.needon10A_maybe>8if A_c('
\n')aAE = 1!Zhr = (()L List the mro, if non-trivial(mro = deque(insp/rgetmro(=)if len(mro) > 22hr. 0dl>
Method resolu order:%stry>P= getT,\2except E?ion\ # Some descriptors may mee+afailurtheir __get__n# (bug #1785.docdata([, mod#5;els Wu Xbfuncs,Bes, mdict,'breturn^}"< =)attrs, prediwcate) iif ok:hr.maybe(.push(msgfor name, kind, homecls, value inkTbase = self.docother(getattr(object,[)^, modKdoc = getdoc(y(if not docH'
%s
\n' % YOelseS`markup,preformat,funcs, classes, mdictAr'
?docw  (,T)x>:\n'preturn %s {X = [(UQ D -~Aify_ _`^Lif visibleBobj=&)]jU = {}?key ~ (G[key] = anchor = '#' +P + '- 5keyi:tryJ l@ except E>ionL# Some descriptors may meet a failurtheir __get__.# (bug #1785Ipass3S# TheS be hashable (e.g., a dataTY withYn##ict or listS)O OATypeErrorA4Qwhiles+jif mroAthis =!.popleftz< us[0][2]`, inherited = _split_(lambda t: t[2] is \) PV%uiltins.=F and=%b!& = ucontinueJelifja0tagndefined here'K7;pfrom %sIUlink(. .__module__I+= ':%s(E[$, eOelsesU`? = !x ~if bases3par; p1for01 in 8<.append(self./Plink(m*.__module__)Dup+ '(%s)W3', g@decl'{:trysignaturinspect.(except (ValueError, Typ )ZENone5if b 30arg5tr(% 4if (v z!= '()'Q1 + }sescape(;) + '\n\n'+doc = getdoc0if U k2@ + (Gor '=`markup%,preformat, funcs, pes, mdiBF@' %s4(f,POi getattr_static(clIP, [])g %s' %6e))if skipdocs '
\nKJelseA doXumarkup(- getdoc(object),preformat,Ys, classes, methods)Ih0andBd>tj= :i=e|s'.join( !docproperty =ra_other*ignored@HTML`*  lh_/ 'Jame or '' d D=DreprMSindexdir, shadowe aGenerap =irectory ofIules`modpkgaq#:U = {} im"erR , ispkg in pkgutil.iter_mod~g([dir]  if any((0xD800 <= ord(ch) q0xDFFF) chX~ BF"# # aq if its contains a surrog4characterI/:inu`. ((C, '')JU[9R] = 1\Vsort(7!en?.multicolumn(modpkgs, self.slink) breturn bigsection(dir, '#f' ee77aa', contents) # - text documentah generator class TextRepr(!):A"""Cfor safely making aUerepresVof a Python object."""Ldef __init__(ds.4+.maxlist =0maxtuple = 20*0dic*10strFother = 100 H1, x, levelif hasattr(type(x), '__name__')`method@ = 'Z_' + '_'.joinB.@.split()(Fs&, W p.Z1get 2(3Pcram(%@pid(D(x))!ax.))_//ng/!te[xL7'r0 = (if '\\' in B and0notqreplace6?0, r0<, '# Backslashes are only literalLBthe g#Unever-1# needed toe any special charactero show a rawX.K 'rR[0] +:60%E 2ing_instance"rym&ngoexceptJT'<%s >' % x.__%__ sDoc(Doc"""Formatter 7 53fc3utilitiesM_j& =>: = '.@Cboldo# a20 by overk3'[ chi \bW!ch  chIngindent, prefix='VAA"""I.  by*@pend#pa given0fixeach line0if %: p0Rs = [! +B)e'\n')]=!if."s:f[-1] = .9"p(n#\n6dbFWtitle"""Format a section with a given heading.""" clean_contents = self.indent().rstrip()8breturn.bold(title) + '\n' + YA\n' B?# - type-specific routinesMdef formattree( , , modname, parent=Non refix=''):  """Render in text a classJB as ed by inQt.get%n)()Yresult = ''efor entrAX!if(#B) is'()(pc, base/d 1+ p0ass%(c#=#ifb3and B!= (J,5( f cdvE#= + '(%s)' % ', '.joinsB5>xY/elk/[]Qc.s }i`F, c,'!'\docmodulobject, V1mod """Producedocumenta] W b$ = __ __ # ignore the passed-insynop, descOplitdoc(gel)(U0secr('NAME'A + (U @' - `Hall = get(g, '__all__', wQdoclo3loc9(3if +ais notG  MODULE REFERENCS +  The followingois automatically generated fromPython source files. It may be incomplete, prrect oclude features that are considered i;@adetail_0vardctween 2@Whenadoubt,^Freference atB loc0lisabove. """)!C?escDESCRIPTION'RW%[]4key, valuPsmembers:b!isLS# if # exists, believe it. Otherwise use old heuristic.K@if (  or (inspect.getmodule(value) or object) is : 8 if visiblename(key, all,2>classes.append(7y)cfuncs = []1or c,H in rembers(,isroutine)0# if __all__ exists, believe it. Otherwise use old heuristic. pif (all*not None or'misbuiltinm ~?Y| Odata{)sA p+E[kmodpkg'_Fset(Xif hasattr+'__path__'for importer, modSp, ispkgpkgutil.iter_m.T S  S.add(['"ifn I%F + ' (package)'UOelseQ%) qv8sorYresult = + self.section(G0'PACKAGE CONTENTS', '\n'.join)# Detect subq as sometimes created by C extensionsz8\1 G!.___.startswith(Cp.') and 6 ina5s6key'if >:1SUBMODULEf3if  0lis.[o %&es5pcontent[_@form.eebYMQtree( |`, 1), )d document,h=(1k'CLASSh f * = [] for key, value in funcs: contents.append(self.document(>,Jiname))Aresult = !+ ?section('FUNCTIONS', '\n'.join(s5)) Nzif data)U = []+>(B ]other, maxlen=70ODATAhasattr(object, '__version__')E = s2.0 3if 1[:11] == '$' + 'Revibu: ' and'4-1:' y9L% =/11:-1].strip(|VERSION',M??if Ndateg jDATE',.JqoauthorslAUTHORuNwcreditsx`CREDITW Pz:tryfile = inspect.getabsexcept TypeErrorH'(built-in)' 0FILvocreturnLdef docclass$, ;=None, mod *ignoredK"""Produce textOa Ia given f`G.""" alo$ = __%__#1 = Ror re2 Xbases@"__r@makeCb(c, m=.__module__206 T  1tit 'C .Tbold(3OelseA6q)v# =PVL1if  O0part = map( ,++ '(%s)' % gN P@push  AsignaturFE (VG,R F0 = 0 40arg = str(signatuWre) if argspec and != '()':,7push(name +-+ '\n') -doc = getdoc(objectvjif docZV6 K# List the mro, if non-trivial.smro = deque(int.getmro len(mro) > 2 "Method resolution order:"Ffor base in J!' ' + make<(4)K*Fbuilt-in subclasses 6anyt = sorted( (str(cls.__@__) 0clsvtype.__F$__; F(t I.startswith("_")L!module__ == "iins"),Tkey=str.lower!Wno_of0 = +MAX_SUBCLASSES_TO_DISPLAY = 4['ifKC&."BrPEOes[:]qu(FV( /> ji 1...5' +c. y-m)Iw' otherr's'Cute little  to pump out a horizontal rule between secs>H0JRuledef __init__(self) .needone = 04A_maybe>p4elfA_cz-' * 70" 1Zhr = (ef spill(msg, attrs, predicate#ok# = _split_list(7^if ok2hr.>msg, kind, homecls, valukk'tr> , k:except E>ion& # Some descriptors may meeafailurtheir __get__D# (bug #1785.Cdocdata(R, modd  `else:  push(self.document(value,2 Fname, mod, object))<return attrs  def spilldescriptors(msg,), predicate)#ok# = _split_list(`7kZif okIhr.maybe(>msgBfor kind, homecls, 9? inkTmCdatalO?mod<C5doc = getdoc0]>try2objE'(,wMexcept AttributeError_  .__dict__[&]^ PotherMmaxlen=70, doc=doc) +MQZ '\n'y`s = [(",  D[ -classify_ _` if visibleBobj=&)]#Rwhile zjif mroAthis =!.popleft<Z[0][2, inheritedlambda t: t[2] is \)2%not builtins. F and=% !& = continueJelifjatag = "defined here"Ko7;from %s" % )~H.__module__rAsorts57 ,# Pump out th, segrega!by=.("Methods %s:\n%ta 8 D1] == 'mJ  nClass methods %s:\n" % tag, attrs, lambda t: t[1] == 'class method')<O = spill("Static+Os %s{-sQ| descriptors("Readonly propertie rayWData $ d^ Qata("and otherOibut0#):') 4Qssertls`*[] = inherited>contents = '\n'.join(tif not :_return title +H  + self.indentm.rstrip(), ' | ')LMdef formatvalue(C, object)A"""F& an argument default ; as text."""[4'='Srepr(`0docroutin, name=None, mod !cl qProduceA docPationq a func#or alu$ = __%__! =b or re2 0ote'pskipdoc0if _is_bound_yE"imQ__.__0Jf clCJ"isx&*n` from g(C6Oelsev2.__ ~0J of %s instance' % O9 v,8!un 7modIif (inspect.isco= or7asyncgen6'qualifier " 4'Q0ame ={Tbold((ti inspect.getattr_static(cl, realname, []) is object: skipdocs = 1title = self.bold(P) + ' = ' +d7argspec = None Pif int.isroutine():trysignaturHHm2except (ValueError, Typ s0N5if Estr())K%if1 == ''T/ :- 'd9b# XXX #'s won't usually have func_anno/ons['return']Qsince the syntax doesWsupport but itgpossible.K So removing parentheses iPtruly saf@m [1:-1] #UeSsif not 2 nV(...)S decl = asyncqualifier + +O +] S kd XV+ '\nlJelse- doFdgetdocV or '5T@ + (=2and`indent).rstrip(B\n')def docdata(,, , =S, mod !cl F"""Produ$0extMBumen^p for a ^ descriptor."""`result[spush = r.append+am64 "|./= k i! J/.bV# m''.join(ocproperty =F5Qother [, maxlen 1doc ! $pr%Drepr#if ?0linT l\SKTcchop =Sp - len(L z1if )P< 0: DJ@pr[:]h6...LB6 = o [U!+=) +^@doc)TH return li ne class _PlainTextDoc(): """Sub(3of  which overrides string styling"""=def bold(self, textW[areturn_ # -% user interfaces xgpager(s*"""The first time this is called, determine what kind of J0 toh.bglobal&Q= get &() aSDeciducmethodn@ forc[qthrough/ if not hasattr(sys.stdin, "i.y"ppC?outD.}Q() or5out Ause_ = os.environ.get('MANPAGER'a Ir0if *platform == 'win32': # pipes completely broken in Windows[alambda: tempfile(,E BMelif`TERM')u('dumb', 'emacs'>|&sePQ % Y u'more <'t%if2os, 'system') a"s.('(less) 2>/dev/null'),01 }-'G1') eimport!P(fd, /uname) =0.mkpLos.close(fd6try x"%s"' %v'= d NW4/elO6ttygfinallos.unlink(.;"""RemoveY%@matt%Afrom"re.sub('.\I'e#ip3cmdd`"""Pag*} by feedp itanother program|subproces8 6 =  .Popen(cmd, shell=True, =(AIPE,2k errors='backslashreplacetry: with proc.stdin as pipe: :try'.write(text)2 except KeyboardInterruptG# We've hereby abandoned whatever ^ hasn't been uIten,r# but the pager is still in control of!terminal.EApassvOSError! # Ignore broken5s caused by quittingmrprogramrwhile Truk gZwait(^Qbreakl ctl-c likeitself does. Otherwis"q# left runn1andNW{in raw mode unusableEN def tempfile.Tb, cmd)z`"""PagRroughby invokaQ on aN`orary TA."""1aimport~0.Te#aryDirectory()!'di@name = os.path.join(), 'pydoc.out'mTopen(@, 'w', efs='backslashreplace' encoding=os.device_a(0) if`sys.platform == 'win32' else None4Mos.system(cmd + ' "' ++b+ '"')_escape_stdout1# EQ non-8 characters to avoid ?a later8= getattr(n4, ' !',) or 'utf-8'@areturnh.,!e(^ing, v).decod%6ttyxlines = plain(8).split('\nl M!tySfd = 0in.'noh ol!dtty.tc@&fdAsetc(0get = lambda:gbread(1F (Ipte, Attributeio.UnsupedOperationIQtty = P()[:-1][:1] 9 1 fh = int(os.environ.get('LINES', 0),BValu =K0s-if h <= 1%%25&rc = h - 13outs[:inc]) while lines[r:]: sys.stdout.write('-- more --')+jflush(c = getchar() :if c in ('q', 'Q') \r+\rYbreaki&elk \rl/\nm"` + lin1P] + 'F ir = r + 1continuebBO\x1b[a- inc  J}if r < 0: ,0 K#n'c.join(:r+inc]) X2incvfinallyWif tttty.tcsetattr(fd,#.TCSAFLUSH, old) def plainpager(text """Simply print unformatted '. This is the ultimate fallback.""" p(_escape_z)describe(thingProduce a short (ption ofagiven 8if inspect.ismodulZ0Dm.__name__(builtin_8s{;return '*B-in + T3aif has", '__path__^packageV Oelse )in{ Afuncz Vdgetset/or_)aor %s.U' % (B;.__objclass__._#_, ,H~ omember)|qV K!NomethodLJ4typplocate(S, forceload=0LL" an object by a or do>importing as necessary]parts = [ k 0in ?.split('.') if part] module, n = None, 0 while n < len(parts):Bnext: = safeimport('.'.joi1[:n+1]), forceload)B6if E:5+ 15else: break#if9object ='7 "builtins@for 1 inVs[n:]W6try Fgetattr(W,=except AttributeErrorJareturn}P_ # - interactive bpreter face texTextDoc() pla7 _P html = HTML- def resolve(thing#=0 """Given an or a path to, get the'and its name."""if isinstancv3strn Ulocat%v!isr aaise I('''\ No Python documentation found %r. Use help()^ utility0F !onstr class.''' % oX %,/ J =hEP, '__A__', W(% !, j? nder_docstitle=';Library DCY: %s'E, reQser=NoneA"""R  ?, gwZd =k;,/ = Opdesc = Cribe ;inspect.geO '$@ame 0'.']A += 1' + [:%`.rfind!)]%el.Qcis notZ+a .A [Dot ("is'1 or(*)eroutinHT @dataTripto)2@_get)dA# Ifcpassed&a piece of g$n #,available methods30eadIevalue.'aif hasorigin__'## =4.__*Q: object = type(ob7) desc += ' 'return title % % '\n\n' + renderer.document[, name) def doc(thing,H='Python Library D= ation: %s', forceload=0,output=None):"""Display textlK, given an or a path toA."""N2tryWm2if p@ is sbpager(_)gJelseEao.writeLp, plainWexcept (ImportError, bDuring) as valuaprint(nWZ HTMLlQ file in the current directorygn1 = resolve1Fy = html. (5rib,Hwith open(P + '.T ', 'w', encoding='utf-8'D _`s'wrote'd'As(dir, pkg='', done4?outf&ll modulesaU treei%ne#mQ = {}QKi0er,Qkp, ispkgX pkgutil.walk_packages([dir]|t0modJG class Helper: # These dic\aries map a topic`eitherbalias,*StupleI (label, seealso-items). b! ""2 oforresponNM!se0B.rst<uPP/ andindex intoNyKin pydoc_data/Rs.py. CAUTION: if you change one $, be surePadapt}M@list@qneeded /Doc/tools/extensions/pyspecific.py Oregeneratem%by runningCBmake=- %&inaqcopyingqcpFLib/.Wkeywords^x'False': '''9 =Tru(0and'xBOOLEANB as sert': ('as W, '')zasync': ('async', ''), 'await': ( Qbreak  , 'while forIQclass) , 'CLASSES SPECIALMETHODS6rontinue9 e1def*function1del!, 'BASICx0eliJG'if' 2els Pexcep5H'try@finally': !or61, 'L# c R @fromGhimportdRgloba , 'nonlocal NAMESPACEg( 'TRUTHVALUEsk  , 'MODULMni~SEQUENCEei'COMPARISONalambdaI , 'FUNCTION- 2, '!noiBOOLEA|'p 3rai , 'EXCEPRretur& BsQ!( C?if Awith; ONTEXTMANAGERS i yieldz }F# Either add symbols to this dibary ore%I&directly: Whichever is easier. They are merged later.<_strprefixes = [p + q p in ('b*fr1u')q"'", '"')]M_inverse = {4'STRINGS' : (93"''@Eh""', *nOPERATOR? '+-*/ /% << >>&C '|!^~6 =>=!)<>'AQUNARY'~_AUGMENTEDASSIGN ,+-*/%&/|=!'^,!<<>*S)/=rBITWISE b K#2LEX6jV1J')  1% FORMATTING0'**&XPOWER,TUPLES LISTS #.'ATTRIBUTES FLOAT  OBJECTS',  '...': 'ELLIPSIS', P ': SLICINGS DICTIONARYLITERAL,@,def classF \\0STRF_PRIVATENAMEP_ SPECIALMETHOD-`JBACKQUOTH(TUPLES FUNZS CAL)'['LISTS SUBSCRIP #]* e} for topic, symbols_ in _ inverse.items():59%0 &s_ $Y4s =[R.get(+,v)P0"if@ notV@ T(" =.s + ' ' + Rm"s[]3 &H{['TYPES': ('types', '> UNICODE NUMBERS SEQUENCES MAPPa% 'IM'@LASS01ODUIinspect')tastring5str- 'FORMATTING oBuq-method|f&S I >gformatOPERATORS6TslPencod unicodem"uanumberuINTEGER FLOAT COMPLEX-(?Sinteg@int rangeN,floatingT Y math-u/imaginary0complex c350seq4 ) J ~>qIofunctionE`4X 8C@xbOBJECT`bltin-q-object|%7ilekJJ7JsVFRAME?.TRACEBACKANONECnullw N/ellipsis3! ;pATTRIBUDebialatt 3{N 4DMCRmodulCimport'), 'PACKAGES': 'import', 'EXPRESSION!(('operator-summary', 'lambda or and not in is BOOLEAN 'OV'COMPARISON BITWISE SHIFTING BINARY FORMAT_POWERO U2ATTRIBUTES SUBSCRIPTS SLICINGS CALLS TUPLESM LISTS DICTIONARIES')OPERATOR '$PRECEDENCE^L%`OBJECTG('objectsV;TYPrSPECIALMETHOD0specialname5SBASIC! @ 'DABLE.@SEQUtMAPPINGM dNUMBER,[CLASS': ('customizationhash repr str  Oattribute-acces)SO Ncallable-typk&G @GwsequencG&$S 5a ? ' z% Hvnumeric#S AUGMENTEDASSIGN ^ PEXECUwsexecmodelNAMESPACES DYNAMICFEATURES EXCEP6 2N`namingKglobal nonlocal @DELEJ d  ^ dy`c-featur* 50SCOF FR 6Pexcep2Btry  finally raisefCONVERconversionD ,IDENTIFIE('identifier,keywordsO/id-class(qPRIVATE$Z[atom- rLITERAL.qliteral1STR3'% Y R~'SJ9sexprlis!>Y!('~pseq-mut7qm 'LISTS LITERALS'), 'DICTIONARIES': ('typesmapping', !_YLITE@FIdict>OIES AATTRIBUTattribute-referencesI0getA hass?jMETHODSUBSCRIPTsubscriptionUSEQUENCE<cLICING:olicing5BCALL2Acall/EXPRESSIONQPOWERrPpower+QUNARY+_unary+ %BI,/bi- SHIFTING[SshiftqBITWISE0bitwise COMPARISON2comparis}eo BASICbBOOLEA@bboolea=TRUTHVALUEPASSER': 'assert'ASSIGNMENTassignmen0AUG'ED&6 2augIoNUMBERDDELE8delbRETURNx'returnSIMPORZ'impoPCONDIZ AL(if<BLOOPY ('@ound for while break continueNePtruth=#if<and or notdDEBUGGbdebugg9pdboCONTEXTMANAGERSontext-manager^Dwith9!} def __init__(self, input=None, out !):1 (!._(" =0 8# =Al@property-zCw^ eor sys.stdinLsM #yN2outOc__reprif inspect.stack()[1][3] == '?'!()%''`<%s.%s^tance>' % .__class__.__module__V8@qualname__)_GoInteractiveSbject  , request=9 #$1 is i)c.help(:5Oelse-Sintrogi.write(''' You are now leaving  returning to thLe Python interpreter. If you want to ask for help on a particular object directly from the R,Ocan type "I!(o9)". Executing 'string')" has the same effl yp/ 51 at1d> prompt. ''') defact(self):.output.write('\n') while True48:tryrequest = Wgetline('V-sif not 8u: break|"except (KeyboardIrupt, EOFError2Hc$ =m.<#p(#5# Make sure signific@rail1quomarks of literals don't# get deleted JPcleanIJinpu/if (len() > 2 andU[0] =[-1] in ("'", '"^ @n%inR_1:-1]@.[* $ifG.lower()'q', 'quit')7'J@fintro(;els/f=$,"""Read one E, us() when appropriate.""""if is sys.stdinPreturrBput(  4[flush+uMP.read6$,!ifV7(''& 2` keywords':GDlist +el<isymbol;: Ytopic98 imodule9:1[:8'+ $o.split()[1].K "in=KBshowNC ['PFalse jNone']~# special casez4se Q sincSy are,Us too6Edoc(evalC, 'Hq;%s:wSu elif request in self.topics: Ashow('7) Selif T: doc' , 'Help on %s:', output=b_ K"seC?str?isinstance2er)(p$ellp.write('\n') def intro('!):3.6 '' Welcome to Python {0}'s h>utility! If this is your first time using=, should definitely check the tutorial internet at https://docs.p.org/{0}/8P/. E4 >name of any module, keyword, or ?2get0on 7Cing programs andRs. To quit5p returngpreter, ju+Pype "Ap". To aa listvailableqs, symbolss, type "Ss", " 1"2"s". Eacha` also  s with a one-line summarywhat it does;{p whose 5 or;contain a given str&such as "spam"  . '''.format('%d.%d' % sys.version_info[:2]) , items, columns=4, width=80%! =(sorted()bcolw =>4 //RRrows = (len<$ +%_ - 1)5pfor row`range(F$6col$ '+0i =s *U0s +!vif i < "6[i],!if{<kZ.^`' ' + 1* (mV- 1 -zF   5p'' HereK>sgAmoreZ . -p.7s ,s(+$punctuation5c which assigns spec@meanBto. R6 self.0output.write(''' Here is a list of available topics. Enter any@ nam get more help. ''') Pself.U( Mkeys()) 'def show',b,W_xrefs=''):/Y6try import pydoc_data.Ns2except I(ZErrorA SSorry and keyword documentation:7not4because the module "" could ;be found.>ereturn0tarq!= Q.get( ,s)!ifsI+no for %s\n' % reprfif type(z)7 87A3qlabel, ,2 = ,5 0^doc =/6[N]?=?Key:48doc.strip() + '\n''if&  ( Qor ''@G ' +6L+ G\textwrap.w = 'Related!s:f', '.join.split()M^Cped_U.(F, 723 +=q7O6pager(doc=~A_get?~A"""R unbuffered tuple: ").pIf an e| occurs here,& cMacaughtqdisplayed byzthe url handlerdThis funcduplicatesdK method but _Fs it- result directly so it can @rmat0 inPhtml b.5""" ?Sb ,UIraise Value&('ABfindy} if isinstance(target, stWr): return self._gettopic(target, more_xrefs)6qlabel, 2 = +doc = pydoc_data.Qs[=].'ifc `( or '') + ' ' +6L3doc def showsymbol(",  " = "s[3, _a.partition(' '+m.}9(<)listmodulesgkey=''jif key!] output.write(''' Here is a W oa[ whose name or summary contains '{}'. If thCare any, enter a @ato get help. '''.format(key)lqaproposOelsePlease waitment while I gaall available2s.. es = {}3callback(path d:a, desc=C@4@ and@[-9:] == '.__init__'<"mo==;A:-9](package)'6v.find('.') < 0d[lY] = 1S onerror(%+ANone ,  rMScanner().run(>#, j= ;k.keys(i& E nyL#ul  Or, type "ms spam" to search forEsQ G string "F.$0) 1p = Help class p"""An iPruptis=S that#es synopses."""`f&, lb, completer=~ =A.lowxc.quit = FalseKBseenfH) in sys.builtin_{_s^ != '__mainBrL0key* h /(#'( = __import__@).__'_'=o! =v.split('\n')[0'W 3.- ' + desc  if name.lower().find(key) >= 0: /callback(None, modG, desc) 7for importer&ispkg in pkgutil.walk_packages(onerror=)if self.quitVbreakif key is 35'')HNelse>>try/espec =P_get_( g<except SyntaxE d# raised by tests r bad coding cookies or BOMhcontinueloader = . %if hasattr("1, 'kource'p5s;2 = Q.O(h185E<?ion3*3if \$(%w )DF_synopsis(io.StringIO( ))-''eFi@file|k<JpathP6 RVU : module =5lib._bootstrap._( Iq6bm .__doc__.splitlines()[0] ifI4ule" G 1get~\@,'__@__',), =i + ' - ' +  !Pif completer() def apropos+"""Print all the-Kule summarPthat ain a substwA."""b s6[-9:] == '.__init__'(,)l`[:-9] q()pHf and ' yApasswith warnings.catch_warnings(): 1wart.filter('ignore') #  problems during importJModuleScanner().run(callback, key, onerror=o) # -: enhanced web browser interface def _start_server(urlhandler, hostname, @"""S1 an HTTP 9 thread on a specific 8!. 5zML/text:, so HTML or documents can beGd dynami+Ry andactively with a. Example use:3>>>B time Vpydoc2Define a URL -. To determ what the client is asking`for, check(Lcontent_type:.Then getgenerate some+"or;Acodereturn itDsmy_url_(, ww0...e0= 'swas: (%s, %s)' % KJR I>5 0.D`If youY1 0,;8will pick a random&fnumberF1YouQtS3use.t!tolCK9= 0L1 = :.b \ C@Q@qreally ed. If iZd, openN2first page. Uburl asH,*if'6ingyrGPThe ntwo lines are com`ed outa doesn't%if`doctes@ runsathis mL#3web.*("erU.url)ZV#True"Le1` do it, ing. We just need to monitor#fstatustw^`.sleep\Eloop1hog7CPU|>! =.monotonic()$E1= 1 #secondsT7a short^Af!st {urposesKwhil;&WF(.01 ]" -! >[=outGstop1}*VbreakPrint any error s that may have occurred. >>> print(serverthread.error)&@None 0""" import http.8email.messag70hselect+o2ingclass DocHandler(b.BaseHTTPRequest#"):;def do_GET(self):k"""Process a rE from an HTML browser8The URL received is in bi.path.f5GetPBpageb-Burlh and send it?by'ifiendswith('.css'/content_type = 'text/, Jelse<Yhtml'=_response(200,K$header('C-Type', '%s; charset=UTF-8' % QBend_P/s(wfile.write.p(,v.encode('utf-8'))^Clog_d{, *args# Don't log .sBpassZS  __init__`host, , callback(0 =  @addr!= V.&Umf% =qR[base.k,fquit = False/vp_until_& while notg'rd, wr, ex =(Bect.!([psocket.]no()], [1^if rdeM_~r_close(~cactiva fx- \NcT3(. ,j *6 = )0 =    ,k]5ing!A1 = :2runJ """Start the _S_url_Q , content_type="text/html""""The pydoc T= for use with#2er.!IfcQ is 'fQcss', _;.css styl+Psheet.ed if it exitsijnoresult of@get_"P_page)u"edbc_HTMLDoc(H"):0dIu, titledsT)"""Format an M ;.n#css_path = "*f_data/6 /link = (D!'<Qrel="lg'" css" href="%s">' %Fch\ '''\ <6>Pb: %s %s<2body bgcolor="#f0f0f8">%s
%)P %s
%s <'XOrighY*text-align:center Module I>   osearchqS !""%KC(terse=Trues&()8"""` page.8p<1blt& k(?!'?% %sj8,:4:0hea({$b'qstrong>B of 3s' +RQbigse 8Built-in&f wee77aa']0see%{}4dirFpathF3.append(?.pPdir, S) 0j '

pydoc')freturn 'Index of Modules', ''.join(contents) 6def html_search(key):A"""S results page."""## scan for mmS_;R = []tZxcallback(path,?name, desc/$if[-9:] == '.__init__',0modL% =7:-9] + ' (package)b .append((H and '- ' +Dqwith warnings.catch_(t.filter('ignore') # problems dureimportbzJtonerror p&Ipass7Scanner().run(s, key, V=#1matWbltinlink( %s' % 8!, >/DsE@head=.($b'iR!)I ,4', x_topics5""" texts availablFJ  9<U?key=%sA>,_INDEX#/sorted(Helper.s.keys()^dtml.multicolumn5s, +6+ T #Rd9# keyword Jkeywords.keys()C) def bltinlink(name):$return '%s' % =!, C` contents = html.multicolumn1&s,)y6eading +@bigsection(.'Keywords', '#f ee77aa', Tf;%_Qpage( #@"""TR or k` help .E."""buf = io.StringIO(e6= Helper(buf, buf$d, xrefQ6Q._gett1if 1 in?.stitle = 'KEYWORD'EOelse,VTOPIC*h RastrongD ! p('%s %s()h''.join((C)woHwobj(urlobj = locate, forceload=10if *is None and url != '' raise ValueError('could not findL7ect = describe(obj~document%,*IO eurl, exc Kg/.escape(line) 9 in< { +mat_excepW_only(type(>h9 obb0000 m"Q - %s" %s@get__page(url):  """Generate an HTML page for url.""" complete_url = if.endswith('.html'):"D8U[:-5]:try(N in ("", "index"MQtitle, content = v_/%()`*#elU== "topics"u&P/Q keywordS1U0'='>url`op, _,l.partition('='`if op search?key+7N(url]T_$^a# try &s first, then objects. c=except ValueErrorh'dogetobja?get $.Oelse 3q4 >3i=Wraise('bad pydocq ^HEion as excx# Catch any es and displayAm+"an JL(,}areturnO.L H!) c.start/"1:$ifP_type'text/css'path_here = os..dirname(@real(__file__)@css_?Pjoin(XC0d open(:)&fpq1''.Nfp.readlines(~ M@get__gh!# s outside handler are caught b r server2Typ('unknown content type %r for url %s' % (content_type,)) def browse(port=0, *, open_r=True, hostname='local#'): """Start the enhanced pydoc web server andY! a_!. D@Use '0' to sQ>on an arbitrary-.;1SetX?PFalse suppress"Sing ar=1"""E!im~3web|thread = __(_url_handler ,)?#ifBb.error48bprint(N"="oreturnL76ingNer_help_msg = 'Sycommands: [b]r, [q]uit'\k!if#EX. 6url:try;Ijy at', Dr7 g#ZwhileG0 ( cmpinput('&Zer> 'P(cmd.lower("1if MZ= 'q'AUbreakY'el;b;iSOelseC except (KeyboardInterrupt, EOFEgQkfinall m#erOstopmr=%@ped'?# - p-line iBfaceispath(xzp isinst(x, str)x.find(os.sep) >= 0F_get_revised_QQgiven s, argv0a"""Ensures current directory is on KAath,yB )2notCEBion:i'Jleft alof it's also 's'wRus a new  entry list, or NLno adjustmis neededZ# Scripts may ge'n@"irrby default ifAy'reT# run with -m switchCqly from iC# Thactive promp)so allows sM Accordingly,"alent, don't makany changesUEoif '' in  or os.curdir in given_path or os.getcwd() i3: return None # Otherwise, add the current directory top p, and removeMXscrip9(as long as' latter isn't also pydoc'sm.Lstdlib_dir =u.dirname(__file__)+u+Rargv0(rrevised0==b.copy(%2if P G5not@same(2&, )x{.65z.insert(0,m(/ # Note:etests only cover _get_1 , _adjust_cliitself def 1sys ("""Ensures+izP sys.(__main__0 is.Exception: +%0lef)one if it's7 1""". =( &2[0]a9if ?56Y[:] =0! A7cli0Command-linterface (looks at1kdecide what4o).import getoptclass BadUsage(Kr): passa6tryopts, args =fU1opt2[1:], 'bk:n:p:w'5awriting = Falsestart_ser open_browse :5= 0K@host = 'local'fppt, valif opt == '-b' 6Tru  $dkdapropos(val=YPpPJ?val[w[ n;5 -($, B= (, = mitu: raiseV$`0arg[( is](arg).aexists <pprint('Nq %r doe  50' %) break Itry:if ispath(arg) and os.q.isfile8<arg = import+bwritingF ?dir\Qedocs( ~#Oelse|A@<Phelp.9except ErrorDuringI% as valuaprint(!) E(getopt.eM, BadUsage)Ucmd =splitext( basename(sys.argv[0]))[0]f|""""pydoc - the Python documentation tool {cmd} ...IPShow y 3on something. 6amay beiGQ of aGwkeyword, topic, func, module, or packag a dottedEreference to a class1F0 wi# aNX3 in]T. Ifcontains a '{sep}', it is used:=ypsource 'W.^Cis 'Qs', '1s',EBor 'Pa lisQ7@thesI@ingsdisplayed.C-k NSearch for a synopsis linesaall available1s]pn /an.asterisk called a “starred”7/atp leastDmanyh*o, minu  *!. y0firX:Uz, n P befo3he ZWgRfinalko0QafterkgCA. A36`remain]/isOthenhz) (@ can4oempty)M'6/of $i?are3 ,`A@ment $an-tois recursively@defidaofollow .>n identifier (name):O9 does not occura "global" or "nonloc'  'statement\n' ' in the current code block:name is bound to~object QMkd`local Zospace.0 * Otherwise globallB orFuter determined by "non/",drespectively1Theqz"re|if it was already. This may cause?thereference count fpreviousll:go reachlQzero,2ingYfto be dealHted and itscdestructor (lhas one)be calledA* If`targetan attribute 6 : primaryexpression in|Pj evaluated. It should yiel {?witgassignable@s; i isb1notcase, "TypeError"/isAraisDThat isXan aske, /edd/tok"Ggive`it canwperformh,/an except`(usual0ut gnecessaril$"A M)o Note: uis a class instaNPoccur both sides oe< operator,Uf`ight-hClep, "a.x"0 acG0 ei aBztn%#Duexists)F52Se lefklways set Pcreat_it if?py"usAtwo !do'  'necessarily\n' ' refer to the same attribute: ifright-hand side Hexpressionfsgva classf,c8lefbcreates al?newewinstanc1 as^target oassignment:I4?Cls7#Px = 3 #variableb = Cls()% .e..x + 1 # wri3as 4 leavingQ/.xKOas 3h This description does not f` apply*/orOhps, suchproperties d with "_y()".O2* IiP5sub: The primary ? in-/thCeyis evaluated. It should yield either a mute@sequK object (/a list) oU0app%0dicOary)Ob Next2 " s iCmustan integerf it is negativeNO’sm`lengthLPadded0it.1e result!e /be$oni@ les!an9 , QG_askedl2to )d $edto its itemthat index. Ej6!ourange, "IN`Error"raised (if4ed 2@ canqadd newa_M,.kH0havJtype compatible with the mapping’s key ' 'type,\nv and tE0 isn asked to create a[/datum pairfPwhichskgsubscript[assigned object. This can eitheireplace aniexistingRvalue@withP same , or insert a?newhAkey/B_a(if noX j$Oed).M For user-defi%!s,"__setitem__()" methodpcalled kapproprirgumentsA* If`targeta slicing: The primary expression in3reference@is eSated. It should yield a mutable sequG\(such as akQlist)+e ub j/ofmzkr. NextQlowerupper bound@_s aregpinsofar|yCent; defaultYAzero~vclength=s4integers.C@/ iZnegative9 "ddif<Presul;RclippPlie between 6 Cclusive. Finally&isl/thMe N2s o{8<imay be difat fromzUCm9thus chang ZF" ii*[allows it,`*CPyth@mplei atdetail:** I}currenti 'implementation, the\n' 'syntax for targets is taken to be9 same as'expressions, Q?andhinvalid pis rejected duringhcode generao phasefcausingjless detailed error messages.1Althoughadefiniof assignment implies that overlapsbetweenithe left-hand side Irighre ‘simultaneous’oO(forl example "a, b = b, a" swtwo variables),*within*hSjcollec/Ged-tab occur1to-sometimes`result;in confu. For instancep follow+program_printi"[0, 2]":p x = 7/1]!_i = 0, x[i] = 1, 20# iqupdatedn)iv(d?(x)See also **PEP 3132** - Extended Iterh UnpackThe specificRhe "*" feature0Aug(edPstate= fzhe combinp, in a /le , jKTry op^oand an$ a<__stmt ::= /op(R_list | yield_ S].{ identifier | attributeref |subscripo| slicWaugopo y"+=" | "-*@2!"/#"/%O**="k e">>0"<<&=" | "^=" | "|="Z\n' '(See section Primaries for the syntax defini$As of^last d_threeisymbols.)An augmented assign evaluatestarget (which, unlikeonormalh[Pstatees, cannot be an unpacking) andyexpressionglist, performbinary opera\ specific tod@typepll"on?"wo]Ands,7~dresultkoriginal;c.iBThe  is onlyod once6JU "x += 1"rewritten asj"x = x +E to achieve a similar, but Pexact/queffect. Iol0ver_, "x", Also, whenpossible,i0actO$isp ed *in-place*, meaning thaPratheaPcreat?a new object_Z,3oldCis modified insteadSU B Ys_left-hside *before*K e right-(o. Forexample, "a[i]l+= f(x)" first looks-up1"eDn itBes "0~kT!dd?0ly,`dI@backNe"AWithQexcep#ofQo tuplesttmultiplsVOin ausingle >i done byQ@"le.same way as .S/lyw$ the possible *in-place* behavior, the ' 'binary\noperation performed by augmented assign 1 is_bsame a Qonormalk r/s.&For targets which are attribute referencesocaveat _aboutgclass and instancds appliesfor regular`2kAnnotass3= 3*{Oion*0com6, in a singlyO, ofka variable oraPan opq'alQr:3 n6ed__stmt ::= ~ ":" expressionM | ["=" (starred_M/ |KHyiel%/)]tsThe difb from % A -sat onlyjis allowedsimple nam[@, iffor modum_cope,$heAions?Revalu_nd storeupecial rmk3"__Xt__" thatiQa dicry mappingjl60(ma~d(private) to Jo. Thisi[Awritutomatically creKt#tart ofC#body execu$I1foutusG tbs but notw'If a name i's annotated in a function scope, then this name is ' 'local\nfor thatM2. Alions are never evaluand storPl/s. If right hy!idpresent, anassignmentperformsithe actual Ddbefore4ingko(whereNapplicable). Cnot  /an ex#Osionjetargete interpretsE+q exceptpOlastk"__setitem__()" or BattrOcallSee also:m **PEP 526** - Syntax@VarioC The proposalvadded sPoOtypeS/ofevs (includLfclass instance)/),h?tead of * ngm through comvi1484iType hint;gT>"typing" module tovaOdard can be usostaticjanalysi@tool|_d IDE@RChang|0ver 3.8: Now'edhs allow samOiearegularPreviously, someNu (like un-parenthesized tupl)!caarPerror8, 'async': 'Coroutine%'* ]'0New.5d 1 @o`definiz ,= , 1 _def ::= [decorators] "async" "def" funcname "(" ' '[parameter_list] ")"\n#- ["->" expression] ":" suite? *Execution of Python coroutines can be suspended and resum tKmany_points (see *X*). "awaitAs, "'Q for"j  aQwith"@onlyused in the bodya}.J @Func's defined ksyntax are alwaysf MM, even ify do not contain#orh keywords It is a "S0ErrP`to useyield fromp inside E ?of S An example:h 2 !1def(/11, ,2)@#do_stuff()Q#e some_ , ;RChangj0vertU 3.7:)""Dnow ;Lpreviously~qy were Ptreatkhs suchH M"v/ @3The~statement(= ( _for_stmt ::=q"r 5 AAn * hronous iterable* provides an "__a__" method thadirectly return:^tor*, whichoKcall @code1itsFnext ` allowinvenient_ over &@ ~ foi@ing X fp TARGETLITER:o SUITEFOelse2 23 Is semantiy equival&,toX <! J@ = (*? = type( %).` R running = True\n' ' while running: <?tryTARGET = await type(iter).__anext__] except StopAsyncIterations| = Fals elseD^SUITE6223 See also "__a__()" and)" for details.D It is a "SyntaxError" to use an "a7Q " statement outside the Kbodybof a coroutine func E4TheGwith )= ) 1 ___stmt ::=t%"  7 AAn *G hronous context manager*m*1tha M>   #:\n' u '\n' (' **PEP 492** - Coroutines with async and await syntaxE The proposal that made cQa er standalonincept /inarPython,dded supporting.8 -[ Footnotes ]- 1[1] exaion isagated to the invocat stack unless[there`is a "finally" clause which happenshraise anoH Z _TEnew & cbs@old to be lostD [2] In pattern matching, a sequence$defined as_ ofn Kfollowing: ,` * a!s at inherits from "collecss.abc.S"M \_chas been registerB 1|builtin"(C)"Py_TPFLAGS_SEQUENCE0 b+et .n Bany \ abovRrd libraryees areKsq"array. K 0d,:Olist-memoryview3_range.Otupl.ONoteQSubject valuesype "str", "bytes" w: do,nohY5Lsz 3z@mapp?is y  tM"a 3s, '\n' P ' * a builtin class that has its (CPython) ' 2="Py_TPFLAGS_MAPPING"\n#.{bit set .Pinherfrom any of the aboveC RThe standard libraryes "dict" andtypes.MappingProxyTypeRare m(+s.  [4] A string literal appeaaxpe firsttement in Yfunctiona body is transformed intoE8 ’s "__doc__" attribute?andathereforeRB*doc*  5 ( namespace0iteWv= , 'atom-identifiers': 'I0 (N).'*-6An d occur\0an  a Z. Se1'sec xB keywords for lexical definifU0Namu'O@bind$?forx@docu&ab of5A c'X2Whew)3 bound to an object, evaluztom yieldstu\!. Anot ,pattemptr;e iv'raises a "Error" excepO9"**Privatengling:** textually;s i"'apbegins with two or mpundersc {charactersPdoes  enfgPs, itoonsidered a *pAv*"at(. w s  '  'longer form\n'  'before code is generated7 them. The transKoation Opinserts:t#class name, with leading underscores removed and apgsingle9ved, in front of. For example,dentifier "__spam"w`occurrVin a d "Ham" will bb_ed toS"_Hamv.wLThisis indepensyntacticalupcontext:_whichxPthe i_ is used. IlH!edxuhextremely t( er than 255 characters), iBmentdefinedRtrunc+?mayuthappen. consists onlyf,x/nol5pis done, 'atom-literals': 'L Q#'*Python suppo!stdbytes various'numericiH: $ R ::= L1 | Bp | inteB| floatnumber2mag JREvaluEof ayields an objecgiven typeH(,o,bpoint @, co!x)'qe0 @ mayapproximY!in]@casejpo{imaginary (#) s. See secO forPpdetailsX.'5Alls corresponimmutable data!s, Ohenc?thejC’scty is less important than its value. ' 'Multiple\ne=ations of literals with the sameb (eitherM,hoccurrence inB program text or a different .)may obtainp^objeca  e.\n', 'attribute-access': 'Customizing  _ '*6The follow methods can be defined to ce@meanH/ofr  (use of, assignm0to,@deledct"x.name") forwclass instancesD`.__get__(self, )8 Called whe}defaultD faia aT "AeError""__()" raisesHPl@beca*-* is not jw /0tre0r " ";JE Rof a  property5 j). This brshould 1r Rretur2(computed)5h w PexcepA"` NotDQat ifLs found througHnormal mechanism, k~c|A. (/is( Pintenal asymmetryv between ~0andsFB)".) iqdone both  efficiency reasons and because otherwise ' '"__getattr__()" would have\n4 no way to accessj H ibutes of the instance. Note that atu least forV variables, you can fake totalrcontrol by not inserting any values inrdictionary (bus@tead{@themu!an object). Se; method belowSaactually get` dGover!/.;.self, name)= Called uncondito implemen!trr esOo %class. I3 also definess,w latter willT be cljo0 ei`u ^s it explicitly or raises an "AtYError".RThis s !shRretur(computed)v/anm ` excepC. In order'Ovoideinfinite recursion ix t V, itsa} aalways}Qbase y ~Q withAsamez (/ityoneeds,/0exa?, ""["0 :Wp may stbbe bypassed when lookL/upsspecialsx !asresult of implicit i nvocation via language ' 'syntax or\n#8built-in func_s. See Special method lookup.M' For certain sensitive attribute accesses, raises anauditing eventw "object.__getn__" with arguments $_" andqo"name""sp(self, S, value) Called when/MPssign0 iseempted. @This,cSv instead of the norm%chanism (i.e. store!y in%qqance dipary). *A*,o*7w * to be aQ ed/it " If "__ P)" wa#tob`0an c?, i pshould i base classDCsamexfor example,= TxS#NQ4an Q m- QN1, "b#W0del '__WP%MLike@but f^@dele'e"Q U1. @onlyvih ed if "delt@obj.O" isv meaningfulM7/  ' "object.__delattr__" with arguments$" and ' = '"name".\n!ir__(self). Called when "dir()" is cson the p/ Asequence must bet returned.rconvertsn UOto a{@listis so^/ito"ZCustomizing module ibute access===Special _s "__get@"__d7" can be also^used tooc= to ks. Thefunction atvmqlevel shouldtept one` which5v.o of anuF2nd  computed value or raise anXQ"AttrM_Error IXis not found (p through{onormallookup, i.e.K`__()", ~i searched is ctabeforeZo\6H@, it#(!@FPresulIZ7/ed"F* %no s, / aof stringat repress~ossibles#onO. Ifx]_5is overridee standardG],sr '\n' &'For a more fine grained customization of the module Lbehavior (settingwattributes, properti etc.), one can setyr"__class__" Sv!ofobject to a subG"types.MoType".=example:v import sys' Qfrom 292 rVerboseN()Fdef __repr__(self4"4return f'| {=.__name__}'\n" \0set,, valueprint(f'S {Po}...')super().__C '!.m$s[0%].3 = TL?Not%Defining(D"__gP" and!OonlyP afflookups made usth access syntax– directv Nf globals (whether by code withinuCO, or via a reference=E’s0dicary) is{"un@?ed.xChanged in vers+X3.5: now writable":New7 `"__dir5?s"See alsoL\ **PEP 562** -  TS H ' Describes the "__getattr__" and!difunctions ' : 'on modules.\n%!Implementing _ptorsL=2The followmethods only apply when an instance ofNOclaspcontainmq (a so-called *d!* O)appears ic*ownerN (ze must beEoeither KB’su!diS`ary or]w afor onW/itparents). Inx0exaSs below, “zibute” refers toK hwhose name ih4key$property;72’_ct__"S"qobject.__(self,!, mo=None),B Ckto get)e" (et paccess)2.ofx$atmp2 .  op4al 0@argu" iCr, while **YL thak/wa/ed through,x @or "" N$" This should retur computedPvalue0raise an Q"AttrError" exce%**PEP 252** specifiq atget__()"_Oablef2ith _r two s. Python’s own built-in descriptors support ' 'this\n" specification; however, it is likely that someh rd-party toolu Ihavea require both arguments. uPython’s own "__getattribute__()" implee always passes inx x whether they are d or not.>object.__set__(self, instance, value)? Called to set 5e on ani$ *s**!ofC_ownerw PclassvRa new1, **%" Note, adding "/ )"|t"__dele changesthe kind of w“data”. See InvokD/foA 0morS_tails0"U XQ/YT lT p T "7Thea"__objN0__"interpreted b0"inct" module a*0ifyqsp where   was definedR(settI appropriatcan assistruntime intro#? oftrdynamicys). For callableswpmay ind atu?theugiven type (or a sub`)Pexpec&ora _firstq@posi1%al (for exax2, Cis 'attribute for\n' 'unbound methods that are implemented in C).E!Invoking DescriptorsH=.In general, a d{ is an object attribute with <“bindingqbehavior”, one whosebaccess has beenmoverridden byxhin theprotocol: "__get__()", s ?andl"__deleteR. If any of t\WpdefinedO, itwis said to be"T/dfault  istOget,s2or `Ffrom’s dictionary. For instance{Q"a.x"Paxlookup chain startP"a.__w__[\'x\']",LnN"type(a)9and continubpthroughP<base classes ofwp" exclua<"However, i e )ed-up value(7e)o Python may e8"deu iQ? hostead. Wher&is occursrprecedencewdepends on which mw?ed 0how6!y 3ocalled" *QpointS ca'5!, _. How7"0rgusgmbled BE"a":E '\n' 'Direct Call%) The simplest and least common call is when user code udu/lyr invokes a descriptor method:"x.__get__(a)".LInstance Binding*r If b' to an obj;iEp, "a.x"transformed into thet X : "type(a).__dict__[\'x\']#, # $_Class! c:C, "A /"ANone, A$_Super!"a4an ` of "sD ",n 2?(B, obj).m()" searches "obj.__m__.__mro__" foryqBbaseO "A"v immediately following "B"t/th@withw ?mOobj,A  $6Fors precede"(ofp"cation dependson whichXs are defined. A#{ cat3? anZbcombinD)", "__sQ)l"__delete__()"./itdoes nothu[`accessr] attribute will returnwK<tself unless rea value innPE?’%bionary$Asp ?/or ", it is a data descriptor; if it defines ' 'neither,,Ois\n(za non-de. Normally, s_ bothp"__get__()" and "__s, whileuhave just thewmethod. D`s with6 xp(and/orUadelete)d always override a!re`ition in anvinstance dic0ary. In contrast,e_can b^tden by ~/s.rPython  s (including those decorated"@staticHlts"@class,) are implemenj&as0qs. Accor?ly,x* beSe o. Thiallows individualvto acquire behaviors that differ from oI/of Qsame i"The "property?1fun< isa6not&th=? oft__slots__#=#*a!* f us to explicitlyl4+omemberO(likL&Aies) @denyXP creae0"__!__*__weakref__*(unlessdjor availablew parent.)wThe space saved over using "__dict__" can be '  'significant. Attribute\n0lookup speed\Dly improved as well.Mobject.__slots__* This class variable as string,$@iter;, or sequenc#S ofUfs with} names used by instances. }** reserves space for the declared_s andnprevents<o automatic creationxf*__weakref__*tOeachp +N"ZNotes on8m-h* When inheritcfrom a?Gout ,N x Sa:rll alwayswbe accessible"`* Witha,.?not ?new ^ s Qlisted inbsp defini`Attemp=ot  to an unu #o raisen"Error". Ifs dynamic {@ment7newis desiredan?addl 4"\'~0\'"N7xpshkp x. ,meK1/ng 1 dosupport "` refermsH*it 'instances. If\n' ' weak reference support is needed, then add EP"\'__Href__\'" to6w Asequqof strings in6 *__slots__* declaration.O*Nare implemented atqclass level bycreatingn$ descriptors for each variable name. As a result,nattributesv cannot be used~set default valuevs>Oinedw (by^; otherwise4 W_ woulEoverwritev cp assign$`The ac^X of a{pot limi8  0whetX0defh/. } edparentsPavaildw in childHowever,1subes will get ax"__dict__"u 0and* unlesscy alsok&b(which shLw only containxsny *addiAal* q)>$I31Roa baseJD5 vd2thedL^Hinaccessi(except byv retrieving it  directly from|o). Thi arender)P meanz!of`program un?I>vfuture, a check mayL2addM`preven,/is+$yNonempt1` does Awork/e]Orive-i ' &variable-length” built-in types such as "int", ' '"bytes" and "tuple".\n.* Any non-string *iter* may be assigned to*__slots__*$If a "dictionary" is usw f_, theG_ keys` willk!asW names. The values ofeuocan bew o to provide per-attribute doc%at{precogni./byw "inspect.getdoc()Bdisplayed he outputs"help()v%"__class__"a ment works only if both 'oes hav ?sams >$ Multiple inheritance with m;pted par>)0, b4one\is allow# Z`s crea( 0s (Wother bases must`empty ' layouts) -Pviola raise "TypeError\%KnEtor*J8forD?n a*descripDX Vb@each:=Mstor’sG. However:y $2an |E, '+-references': 'Aws/'*2  5An  a primary fo/byaperioda:~  & uref ::="." identifierH '\n'  %'The primary must evaluate to an object of a type ' K 'that supports\n+ attribute references, which mostys do. Thisz is then{ @skedpproduce3 whose name Oy identifier| stion can be customized by overridingB `"__get__()" method. @If tL7is not available,yQexcep AError" i raised. OtherwisoZ@and }en3the P/edzdeterming^. Multiple@ions As#Ix  may yield dif , 'augassign': 'Augmented  ` state p/'* 'wpcombina, in a single,'BhIqry operQ /an:@D a5_5_stmt ::=`target .op(expression_list |_)y[ &y-& |r^ref |rsubscri| slicingw,oprw"+=" | "-*@ 1'"/#"/%O**="|gR| ">>/"<<&^|DW(See secc! Pqies forsyntax defini$NlastK_threegsymbols./ An1w 3} (~, unlik7'normalfP s,/ beunpacking)0 expression\n') !'list, performs the binary operation specific to!type of 'Massignment\n"on="wo[nds, and 6|dresultioriginaljtarget.gBThe  is only evaluated once5H`An auge expresslike "x += 1" can berewritten ash"x = x +Cto achieve a similar, but not exactqual effect.pIhj0ver_, "x"& Also, whendpossible,gC0actC$isd ed *in-place*, meaning thath`rathernjPcreat=a new objectSX5,>oldoBjis modified insteadG!Un&cnormalH_s E_left-hIside *before*Ie right-(n. Forexample, "a[i]j+= f(x)" first looks-up0"]Dn itBes "0 yiH0ddi)plastly,^Se3@back8"AWithiPexcepj9o tuplesVtmultipl`s>Oin asingle state&  done byrPIs1ledsame way as t.Sf/lyw behavior W&/ed a ii~s&)Ss which are attribute referencesOcaveOabouBclasga7ancbps applis for regulad, 'await': 'Await expression\n' +'*  %Suspend the execution of *coroutine* on an *awaitablbject. Caonly be used inside aNP funce+*. 1 q_a ::= "" primary0 New in ver$@ 3.5p, 'binary': 'B  arithmetic operasO Wf , BThe vlQ have`conven alKorit 'levels. Not7pat someWthese also apply to certain 1l 'non-numeric typekApart fromSpowerh0or,qre are yaooleanoB L kO$ or_test ::= and|E"or"Band_test ::= not_test | and d"and" X\n' 5'  ::= comparison | "not= OIn the context of Boolean operations, also when express >areeqused byfrol flow statements,following values are_interpretedgas false: "F", "None", numeric zeroall type^emptyQqstrings"ainers (includ"`, tuplNnlists,K0dicL0ari&2setV`frozen). All other)true. User-defined objects can customizevir truthq obQprovia "__bool__()" method.3The`#oryields "True" if i#0rgu## i,dIOwise1 "xy" first eates *x*;?*x*>itsDe5returned;A, *yQjd`resultn mQh4is b$?or i, ie0Notaat neiyr "or" re ct,$1and; ?the/4 to, but raz)}he last_a'p. Thiscsometimes useful, e.g.,0"s"" a -ngiNthatdshould be replaca default^R gf"s or \'foo\'" rdesiredh. Because>0hasc kcreate ai2newK/@s a qregardless55 j (for example, "not \'foo\'" produces "False" rather ' 'than "\'\'".)\n', 'break': 'The "" statement\nD/'* $ 1 U_stmt ::=e ( *may only occur syntactically nested in a "for" or "while"Ploop, but not9function<class definiwithin tha Q.e It terminates the nearest enclosing Gp, skipp% op{)al0'"e bclause if^L has one f36&isDd by,Ycontrol targekeeps its current valu DWhenj passes gQout o7try + a0fin  Dat "%  is execuDbefore reGP leav ;the;iHable-typesQ`EmulatG objectsG_s2i0.__{__(self[, args...] 'P Called winstanceG0“ied” as a V;Gi 'this methodwied, "x(arg12, ...)" roughly translkoQ"6(x)xQ1Q  e <0'A   (e.g., a *+/*)possiblynempty series)P*argu;s*:+ !  primary "(" [R_list [","] |ycomprehension] ") uGnm!osf4al_ksg dstarred_and_keywords]Y  4e>| y`&9p$ ::= positional_item ("," positiou)*\n' <' #::= assignment_expression | "*" Qstarred_and_keywords Q(:3 | )J N _ `s_argu2s   M," "**" R CTidentifier "= ]RAn op trailing comma may be ent after the)K andQ Jbut does noFAfectGsemantics.C Tsrimary must evaluate to a callable obj[(user-define@funcs, built-in methods ofVs, class:( instances,$C allPs haveaL0"__b__()" PE areu). AllY{s) O%d beforesa is attempted. Please refAo se# OF: YKBs fo`syntax7formal *parameter* list $If},y first converted toL0, allows. FD1, aunfilled slotsi@creazb If!reN2 &placed inCN. Next,zKeachO }V Qis us6 d1min Hcorrespond1 (i M@same`   a-R name<m<Pso onU  already "TypeError!ce @raisOtherwis qe)> ,u7it (even if;the`U"None", itLs\AWhenOQQ 'been processed, the slots that are still unfilled with ' i'the\ncorresponding default value fromrfunction 0ini *. Z"(D; _Iscalculatonce, when`"isced; thus, aQmutable object such as a list or di`ary usS Kwillbbe shared by all callp don’t specify an argumen4*ors is should usually be avoided.) If+!reL ;any ]s for which no` via"TypeError"aPexcep is raised. Otherwise#f "is s`YH.. **CPython impleadetail:** A0mayh>> def f(a, b)1a ...nRprint&G,..}\f(b=1, *(2,))8>2 1?f(a8 Traceback (mostH!nt_ last File "", line 1,;" TypeError: f() got multipleF=forx 'a'\n":1 2'Ilunusual zMboth    ato be usedAsame[@, sopractice PconfuZ does;not_\arise- $   I  *mapping*,'xKof which  ents. If a keyword is already\n'  'present (as an explicit 9 argument, or from another Gunpacking),aa "TypeError" exception{raised.1 !Formal parameters using the syntax "*identifier"("* Qcannot be used as posi4al ` slotsL-as  Q_names Changed in vers3.5: Func{ calls ac any number of "*"m;andU"**" /s,s may follow iterableYB `("*"), and  W!di7ary d()/Originally propoby **PEP 448**2 AB always returns some value sibly "None", unless it s+anb. How this\computed depends on@type;thePoobject If[is—H ar-defined fa:' The code block for2@execQ, pasw it%M9Rlist.]@firs/mpwill dodJbind{,  to z"s;is describp !se9rs. WheRs a "i"PRstate9)@specs7>!ofx & a built-inomethod`result3up Ipinterpret; see BW s % s l"d ; a class 'A new instancm#at6i ihIq9rrespond>uses^ed, with` <>EA thaone longea; *Bm: the\n' ! ' instance becomes the first argument.\n' 0'ua classJ: c The%must define a "__call__()" method;effect i)n >thebsame as if thatMP was b edA, 'Q': 'CkitionsU* AQ$s !0obj(see secu Kdard_type hierarchy)d ." 0def::= [decorators] ""%n;q[inheri Z] ":"tOsuitv5 eT"(" [7_list] ")"y 9identifier, fis an executable statey k `usually give#s of bas1es AMetaFes for mor!0advZ d uses), so each item inashould evaluate to aj Owhich allows sub+aing. es without( ,@, byault, from" ""; hence, L Fool pas Eis equivalent to s( C{0’r5ite edSa new`ion fri= Naming and binding), usDly created local 9Qspace4original glob0B. (U, contains mostly2funs.) Wheq finishes,,it7%is discarded but itsis saved. [5]bA Tj  7`1"ndX Nattribute!dih0aryqr0boukbo this3 'namespace.\n' 'The order in which attributes are defined the class body isMvpreserv-2new1’s "__dict__". Note that this is reliablebonly right after is created and *2for"esl d!==><?!="O| "is" ["not"] | ?"inG\ yield boolean values: "True""False". Custom%K*ricY[hods* may return non-z0. I/ishCcasev wi\a"V()" on such&contexts_6`can beined arbitrarily, e.g., "x < y <= z"izpequival$toEK, except0"y"Meated onlyonce (but0th aAs "zUFnot F!atBwhentk0fouo4fP)x`FormalZif *a*, *bc*, …, *y0z* e{8 '*op1*,\n' 2'*op2*, …, *opN* are comparison operators, then "a op1 b op2 c S_... ymopN z" is equivalent toT5andZ K 7hz", exceptmthat each expression{valuated at most once.DQNote ^ " doesn’t imply any kind of fbetweenp@*a* q*c*, so{, e.g., "x < y >Wperfectly legalu(thoughjperhaps not pretty)SHValuPs&=&6The "<", "> ==><DC"!="e@the eof two objects. ~1 do9@need0hav'_e saml/ypwChapter Oo,types states  a? (iuPaddit20to ^g`identiCSof anqanoratherabstract>rin Python: For example reano canonic_accesmethod forB’sMz. Alsokr0rem ?the!should b`nstrucin a particular way,jLArisel all its data attributes. Cgan!no'@of wqA`. Oneqthink ofnthem as defining eAndir, by meansm?heiIa Because =sU(S or iR) sub"#"k"Uqinheritqdefaultarison behavior from "object". Types ' o'can\nustomize their comparison behaveby implementing *riche=lmethods* like "__lt__()", described in Basic coation.PThe defaultfor equality("==" and "!=")is basedm on70 idQty ofs. Hence,|/offinstances withbFsamewpresults=,d!j;of xdifferentyFies {Q$inp. A motiv Nthis!isPdesir/atnCall | should be reflexive (i.e. "x is y"_"x ==?y")zAIordeK("<", ">2<=" ">sois not~provided;n attempt raises "PError m ]n@lacka similar invariant asH~^tO_, tha2 lare always uP, may=in contrasr_to whtwill needhave a sensibl0ini Pvalue-l. Such o\ejfin fact, a numberbuilt-inr Odonen~E`followElistVPm?mosd`import 1* N&sFsnumeric/#(Ns — int, '  'float,\n' ' complex) and of the standard library types @"fractions.F "Jm"decimal.D" can beared withinCp across/ir|H;q restriQ thatk lex numbers do not supporti_order?arison. WCdlimitsQ involved,yjNel mathematically (algorithm) correctEPout l@/ofjprecision.mP The-2-a-> values "c(\'NaN\')v 2qare special. Any !edyea_ to az5notl is false. A counter-intuitive implica*Qn s Pequalselves. For exa, if "x = , "3 < x",52< 3AA= x"x?all+, while "xp!Gis true.is behaviorBlian IEEE 754ps* "None@NotI bmentedpsinglet **PEP 8**`adviseN/atRfs for ] should alwayQ doneg_ "is"q orknot", never  ity operators'0Binsequences (in of "bytes" qarray")|b! #eyLlexicograph uptnumeric]0ele/mString&0str0omp+al Unicodde points ()`resultbuilt-inR1funl"ord()") of their characters. [3]\n' ', Strings and binary sequences cannot be directly compared.P5* SRa(insta]of "tuple", "list", or "range")}zn only within each of their types, restriction that mOs don!support order#ison. Equalit9 acrossm_theseiults in ine],~7ingk+aises "TypeError"  lexicographically us/ofcorrespond2elements. The built-in containerse_assumiPident< objects are l0 to9bmselve~qat letsobypassUtests for ~to improve performAlt1maiir internal invariaN: Luxbetween1llegworks a%follows: * For two co|t, Qy mus(Y/sa. jpe, haveO ,r length@pair $ SA (9example, "[1,2] ==(1,2)" im false becausz@ is 1the) 8* Ck4m!edP2c0 7ir first u&@-_,x] @<=", ">=") rais"TypeError"~]* Setset" or "frozen) can be/ed1`within3across their types They defineperators to mean subsetsuperset`tests.tose rela^s do notRtotall#Ptwo sq"{1,2}"P"{2,3 !rew%S, norsoof onetanotherECone ). Accordingly,/noEappropriate arguments $1funs which depe Sk?ingp "min()A1max W"sorted()" producK"unddjresults given a listGas inputs%1 CfnYgqits eleL?@* Mo built-in9(noOomethod_i7oed, so& inherit3HaultebehaviorSUser-p classeQat customizen/irh-_shoulfollow somnsistency rules,possible:*aGae. In | words, 'identicakl\n' ' objects should compare equal:4Y "x is y" implies "x == y"31* CDisonbe symmetric. In other words, the followingg expressionAhaveOsame result p and "yxG!6D?!= D!<>B#>transitive. The (non-exhaus2)amples illustrata!1> yvYy > z(for total ordering]\ >a\<\2last twoapply to"ly/ed`collecs (e.g.to sequences, but  ts or mappings). See alsofO"T_T()" decoratorI*P"hashCEconsistent with?ityOOthatn% d!eib p value,bwmarked ask unGOablePython does`enforcecy rules$fact, '  'the\n' -'not-a-number values are an example for not following these Norules.i Meship test operationsD=/3Thegors "in" and " m. "x in/s"fe` ates to "True" if *x* is a ] of *s*,oFalse"eotherwisep!"xin s" returnsA negNhs". All built-equence.set types support ths well as dicAary,V_whichun0wheT0 haF given key. For containerosuch ak list, tuple, set, frozen |!, e1lle0s.d),xpression@ y"equivalentQany(x__x == qOe ink?y)".-pthe str!by,'SConlymC subm y*(n is "y.find(x) !=0/-1SEmptyPlwayspsideredpJbe a?anyiu, so """"abc"" willuser-defined classes ;lC "___s__()3`methodFin y,9"y.]&x)&_a truem"R< oobut dolFAiter[A(BsomeD_ "z",@le 5s zz*p,produced l 'iterating\n' #'over "y". If an exception is raised during the itMon, it Pis as ifmD"in"UFthatn.0qLastly,old-styl protocoltried: if a classdefinesm "__getitem__()", "x in y"^a"True"^pnd only PthereamOnon-jnegative integer index *i* such 0~s y[i] or x ==d ", and nom1lowbjsW "I|gError"_ (IfqPany omS>+ XE)+`The opor "not 2is d to haveinverse truthvalue o)Identity comparison=Ras "is"+"is not" test forobject’:i:+@true)1*x*yb*y* arRsame u/. /AnOdetermined us"id()" funchj?notoy" yield/ :'. [4]\n', 'ound': 'Comp statement6.'* '\ contain (groups of);ymn'affec1'orV0rol8` execuH of thosea2some wayn.'I'general,  1 span multiple l, althoughm @~'simple2pincarnas a wholer` may bM edd=one30"ifPSwhilefp %` tradi-alv:rol 'flow con(structs. "try" specifies exception handlers and/or ' 'cleanup\n ode for a group of statements, while the "with" d`allows,gQexecuof initializavand fincaround a blockm.ofe8u. FuncYclass defu ons are also syntacticallya@compg.$A K<consistsoone or more ‘clauses.’ AgRa header aURsuiteSBThe d&aRparticularG@l at same indent i_level1JEach begins p a uniquely i]ifying keywordLNendsN`colon.Y? is controlled by DKxcan be Asemir-separated simpleW6 onTaline aW@, fok j?’,o?it  csubsequentAOnly`latterem"a z~epain nes g9e-;dis illegal, mostly becS it wouldn’t;b7@r totch "if"aU"elsed_^long: if test1: 2: print(x)1A0not binds tigh2thao= in?thiKntext, so that:0exa`, eith llzn"fg"0)" M/edMx < y < zG;Q$y) z[Summarizi_stmt ::= if   | while_stmt\n' '  _| for1?try1Owith2Omatc3funcdef_class1oasync_8f7Usuite@::= _list NEWLINE | |INDENT statement+ DE"A&okcompoundIH3impv (";" s)* [";"]Note that s always end in a "" possibly followedNby ag"%". Also nwoptional continuau clause ~^beginfe a keywordQcannoFrt a, thus there are noQ(ambiguities (the ‘dangling "else"’ problem is solve7oPython g`requirTnested "if"s to be indented).C0The@mattZ of grammar rules&0secsnplacesfCeach o,separate linOritya $=$Z@used8 di al execu :GQ if `assign1_expression ":" E@("elH /)*J[|(It selects exactly one Vs by eval!ngo s@bXPuntil"ftrue (see ~ BooleaiAoperMfor the defin!ition of true and false); then that suite is ' 'executed\n(Jno other partdhe "if" statementVF> orbvaluated).eIf all expressions are,zelse" clause,k.ifbYHent,9TWwhile'='`used for repeK qas long a.andjY2:%1 _stmt ::= "" assign _\2":"KR ["5]6EThisly tests3and, if i6Le<gCfirs@;J7theEn (which may be: WNtimef es(>8if  cloop terminatesA "break@ed ih"e _ swithoutY1ing< B’s\. A "continue"h#Askip E resA>goelNbackg!torP"7for%%\|to iterate over!elsa|oequencP(sucha string, tuple<Plist) utb_bject7for/ptarget_`W "in":@5) & HDis e.` once;should yield ank 'iterable\n' 'object. An &tor is created for the result ofG"expression_list". The suitePthen execuVAonce[\each Nitemcprovided byA, inorder return']rator. Eachh~S0urnPassigQ!togptarget a usingstandard^rulesfXZments (see Ak` state ps), andeS do@. Ws are exhaus`(whichimmediatelywCPsequeis empty or aPraises a "StopI]tion"dPexcep.),g"else" clause, if @ent,? nOloopgerminates.A "break"Sfirst t_swithoutYt B’sc "continuee[48he Qskips4res r J@next m,3 AtherG-no2D@for- @ mak#s @variAs wThis overwritb llhvious oFose q cincluding th;Dmade0q:: 0 iJrange(10):Nprint(i)I$Pi = 5 0# twill not affectNE P# bec 1 i S%berAten ] LS@X p# index>LName>.@deleh -isfinished#3but/ sequence is empty, they will not have been assigned ' 'to at\n`all byO loop. Hint:built-in function "range()" returnsg.anditerator of integers suitable to emulateu`effect+Pascal’fn"for ij@:= aQb do"; e.g., "list('3)@the  "[0, 1,N2]".eThe "try" statemen|=\$ specifies excepPhandlkand/or cleanupNcodexbpa group.s:, try_stmt ::=1| 2 8*8E1":"1 "("" [express["as" ident(@r]] U ?e)+^q["else"F6]5finally82try$>"i@clause(s)_y one or morei.[~When nohcoccurs inyN, nof? isOecuted. r'an8a, a search]0 isr|0 ThS in!ts8 gurn untilvis found that matche\ion. And-84les2 P, if 6ent, must be last; iy>anyNEFor \R withb/atfis evaluated, aeb resultinge0objis “compatible”O6An 3 h@i ifiiclass or a base class of the ' 'exception\nobject, or a tuple containing an item that is]0claj0 MNbasec1 z.0bIf no ; clause matcheAion,search fn qhandlerinues inRpurroundcode and o`invoca^ k_stack>[1]I3Bvalua ofexpression`header$an( 8fbraisesX'Goriginal P $-iscanceledhaHastarts3newsq fRQcall |2 (i@reat3s iUntire "try",mtementdgv)3bWhen aH?i2und{gassigned toftarget specifiAfter"as" keyword=#at~ 1N, ifg@ent,Y’s suite5executed. AllnSos must have <able block. He-> isgreached,[dnormally a2e)=try!2sta7(This mean>f two nesFus exist ?sam, e occurY*Tinner,/th ou@ will no/^ion.)`has be" us&B"as 2",  ocleare"at(e|1. @is a$ DE5/N:#}/fo.wQransl5E as N:\n'  ' try:\n' ?foo ofinallA ^del NC.This means the exception must be assigned to a different name .bee1abl,Prefer5`it aft t clause. Els are a~clearedf0becBQ withtraceback attachPthem, y form ab?encVcycleb st^frame, keeping all locals in that " hOalivdPuntil next garbage collec~occurs.Before ang’s suite is executed, details aboutR#bstorede "sys" modultQd canE}ccessed>viabF.exc_info()".X returns a 3-tuplPnsist 2/of Qclass'rinstanc&a Nmobject?(ses@The Pdard type hierarchy) identifyPpointU /thcprogram where+`red.  a>via#re toir previoushnvaluesewhen leav handler:F >>> print(sys=).v(None, 'U0... raise TypeErrorp,k0 M2WV .(2 Ia" (<% 'p6'>,}](), <Kat "~0x10efad080> j6kleback objectx at " '0x10efad040>)\n' " (, (), >> print(sys.exc_info().v(None, ' -'The optional "else" clause is executed if the control flow p'leaves(g"try" suite, no excev was raised, and"return",c"inue", orgbreak" statement_D. Ex@s in >arefnot handled byFpreceding "F.s.@If "finally"xpresent, it specifies a ‘cleanup’@r.  skq, inclu6any =s. ^If angion occuro]oIcs7is R,PP is temporarily saved.C  .IfgAtheraY it2re-Cend lhB. I+}e o fis set a4ext6newa.."6or 'discarded:Odef f()3a ... ?try! &?1/0fEI? 42O/f(/ KE4!`nforma available to program~nduringblWhen a Rzn 'the\n'  '"try" suite of a …"finalltatement, the clause ' O \'is\nalso executed ‘onMway out.’5The return valu function is determined bycMlast"F"cs. SinceN dalways--s,kad~ m" i hSwill m ^bh4one.d:$ >>> def foo()5` ...N try!"!&n 'try'\n"1-uR1V 'T 0P'Addi|al informa on excep s can be found!seNE41, a, SRusinggraise"A-tozgenerateh?may ked.IaChange@vers 3.8: Prior to Python 3.8,ocontinue"ewas illegw#" 0dueoa problem with+OAimplE1"d&=&^@used@wrapw]block[d`methodDfA a ext manager (see  WS SBb@ContMMMs). This allows common" nOusagpatternsbe encapsula0forvenient reuse! EP_stmtC::= V( "("$_=nts ","?_")" |.C) ":Da_item (",)*\n'  ' with_item ::= expression ["as" target]\n' ) 'The execut?of the "i" statementy one “” proceeds e.asgfollows:01. xcontext(given in .O") i evaluated to obtain a zmanager.2;’s "__enter__()" is loaded for later usee3e ?xitd/4d `methodinvokeds5. If a was inclu~,mreturnme~ from|bassign/it Notef  guarantees that ik  d" sout an error0nwill always b0 called0us,R occurs duringH-to/thd list, iZll be trehe same as _Msuite would be. See step 6 below6"e L#is17= UP +nQexcep@caus9 toQ`exitedds type, +,M?andbtraceback are pasf0rgus4. OtherwisefOthre"None" aWoosupplib )U@ due1Q, andA (Sh v0fal#i#oreraisreturn value was true, the exception is suppressed, ' l'and\n execuAcontinues with^statement following"""P3.Q IfSQsuiteexited for any reason other than anhreturn value from "__lP__()"?Pignor<7and 5proceedsf!atnormal loca\kind of xt_taken07The^code:" EXPRESSION as TARGETA9^SUITEM{emantically equival8/to`B manager = ()+1ent)Stype(8A).__/__4mxit = 3?xit2*!= Vg]Bhit_ = False'o try " =@*a ?Trua if not , *sys.exc_info())iF?rai` fin7?~+j]fNone, S[W@moren one item^ )4extas are {Z 3.ifcmultiple M 9s were nestedK0A()~Ba, B b?"? 6]20 'PYou c6`lso wrfm{-1in ]lineslP surrounded by parentheses. For examplth (\n'  ' A() as a,\n' "B"b"/):9^SUITE&Changed in version 3.1: Support for multiple context `expres=.s.cu0vusing group parentheses.todbreak the statementOlineSee alsonw **PEP 343** - The “with”:! /specification, backnd, and examplesmPython"t"hE"match" =N0New0 is used0pattern $ing. Syntax9_stmt ::= \'L\' subject_ ":" NEWLINE INDENTcase_block+ DE#* Wrstar_namedkyM ","b*/s?gy,| d83\' ls [guard]IONoteThis sec0 s ;le quotes to denote soft keywordP1 takes ainput (follow"!") ,a9i valueH[2").Q (which may?aind? s)Zed against)tooutcomt/ar2* A5 success or failure (XP termT* =)* Possible bind"of"ed!a prerequisiO?fort are further discussed below.X\n' 'The "match" and "case" keywords are soft.DSee also: * **PEP 634** – Structural Pattern Ming: SpecificationPb6bTutorialKOverview,-Here’s an oR of the logical flow!a  statementy01. subject expression "_" is evaluated&,a Zresulting3 O Ee obtained. In0con%.s kocomma,hpa tupleAconsEed using9standard rules2. Each pQin a 'a_block mp#toMwith'?the! for success or failureQdescribed belowS%A can bind someY=allvhQlone names !inm2|upreciseG A? vary perCBtype/o **Namoms made dur a`5fuld3poutlivePexecu^Pbe us3@fter=/**ONote/2 D+*ed2es,3sub ys/edfo not rely onMpings beUaa"edPConversely, d\variables remainaunchangedav  exact behaviorHdependent lJq imply1may.Z isLan intenagd"gNPto al`differtions to addH ' 'optimizations.\n  3. If the pattern succeeds,corresponding guard (if present).ise evaluated. In this case all name bicQs arehanteed tocOhaveehappenedD *s as true or is missing}"block"_insid0 "_:is execu OtherwiseMnextVPmpteddescribed_above#!re`no fur+match statementx comple^Note:& Users should generally never rely on a be 4Va DepeKiinterpreter may cache -es#_or usEot @ whiqkip repe^h@A sa b >>> flag = Fal%`(100, 200)a` .../ ,3,q # MisD:?} != 300"DHprint('Cjk1')\n"1/s1 if:{SRssful'N, buENfail2!y)Mhaes and60s y&2f3, y: {y}_yPaprn not lB4, IB anything!~ ZA' '5o3, ""aid. Read mobout that ie|g0secvX>GY7!'-0 '\n'  ' guard ::= "if" named_expression\n' 1N '1A "F'" (which is part of the "case") must succeed for code `ninsidefJ block to execute. It takesqRform:followedgOby a.The logical flowaewith a#.s:L`1. Che1hatpattern inZiZ edf/thU4 Srfailed,Xis not evaluated and!Mnextb# @is c/ed]B2. IB,VD *X8 conditionWs as true s selectOfals(.raises an excep;dduringB1ion;7bubbles upGss are ato have 8r effect1hey) stb2pro1romtPfirstQlast % l,one at a time, skipp?E5ts whose(s) don’tR. (I.e.,QhappeAorder.) O 9stop once aNiIrrefutable Case BV-RGAn igea match-allB. AOstatement may}at most k,>i8bVA!coE2redutable if it has no guard and ' l'its\n pattern is irrefutable. A considered&= ifeowe canh.rove from its syntax alone that it will always succeed. Onlyg>thedfollowingXs are:5b* AS Ps whose left-hV .CF* ORUpcontainat least K* Captureb$p* Wildc/%* parenthesiz3hH-4ONote This section uses grammar notas beyond stand+OEBNF_U* theK "SEP.RULE+"AQshortSPfor "] (SEP>)*", t!>pa negative lookaheadPp asser The top-level@s::= open_sequence_U$ |+$ F G'as<$or ?dclosed#?| literal9q2| c9w:Evalu,_groupn qmappingsEclasppdescrip2lowinclude a " “in simpleterms” oflwaPdoes qillustrg` purpoP(cred"-toggRaymon 'Hett#inger for a document that inspired most of the ' 'descriptions). Note\n%Ohthese 0 are purelyillustraMposes andv^**mayhnot** reflece underlying imple`. Furthermore,ygndo nothcover all valid>ms.(OR Patterns/~rAn OR pO is two or  s separated by vertical bars?"|"~Syntax:d or_@::= Sdclosed+7@Only final subUmay be irrefutable,4Meach8/usAbindhqsame se names to avoid ambiguity matches gof itss in turnmoosubjecvalue, until one succeeds. Thehen considered>ssful. O'wise, if n^OqK x.ORdOfail>AIn s terms, "P1 | P2 | ..." will try?j""-ity/itH42",UO`mediatmif any`ENeds,d{Fo[KH/AS>:$AS' ?<!on1lefM"as"okeyworYagainst a?. P$as9 P_tcapture$3I;s  .ASc_sCEc ^Erigh_a]$ndKs. " " cannot be a a "_".\n8' <'\n2In simple terms "P as NAME" will match with "P", and on success 'b.itdHPset "X = "..Literal Patterns4~"3A lXpX corresponds to most$s in Python. ~Syntax:d$ S_w::= signed_number6 |8 "+" NUMBERC'-C!_tring | "None"O"Tru1OFals2 :IO | "The rule "s"Ethe token "" are defined^" standardg grammar. Triple-quoted |dsupported. Raw,nhObyteN@Form<psx/noM!fo c \'+\'a"!=-\'{ifor expressing co)"x s; they require a real h on.gAleftan imaginaryE5 right. E.g. "3 + 4j9 , "LITERALeuly if "> ===P. For cletons", "q,+ ?"isoperator is used $Capture >cX!bi3he P valu a name. C" a A!'_';\n"nA single underscore "_" is not a capture pattern (thiswhat ' '"!\'_\'"\nexpresses). ItAinstead treated as a "wildcard_q.".LIn a given,name can only be bound once. E.g.Ncasefx, x: ... invalid while "3h [x] |%allowedCks always succeed. The binding fo[`s scop q^rulesestablished by the assignment ion operator in **PEP&`572**;Cgu`becomelocal variableSyclosest containPfunct `unlessre’s an applici"global" or "nonp" state In simple terms "NAME" willr and it2set+ 9=0AW8" P~FAZ s (matchnything)s.nod-. Syntax: 5" ) ::= '_'\n" ?'a soft keyword wiD anyR, but8 sIan identifier,usual, eV"B#" s, "guard"s,gy" blockM ,M_Value@1A vTm0 reL0ent[=d!in Python.M2' ? JNattr0 uA_or_@"." < *4|2D0dot/LIis looked up usQstandard) name\n'  0'resolution rules. The pattern succeeds if the value found ' F'compares\nequal toCssubjectKa(usingQ"==" +ity operator).PIn simple terms "NAME1.t2" willP only#"<>.==bKQ^Note:2 I\4samaoccurs multiqimes in((]matchstatement,hinterpreter may cacheWDfirsand reuse itkorathergan repeatYalookup^#isvis strictly tied"ai_givenhBexecQof a ( =]rGroup P~@1A gTYallows users0dd >ntheses ard/s.todemphasizBndedyping. OPwise,mhas no[@addi.alcsyntax. S_ ::= "("d>")"i P(P)" e0effZoas "P"$Sequence>~~~4A sZ contains severab"beel ag9tge!el !s. r`imilart8`unpackE olist o_tuplec% 1 [" [maybe_&O] "]<|U_[openKe g/ 4tarM ","/ soN",".s+t?L _s|jn\n'  ' star_pattern::= "*" (capture#B| ' #'wildcard#<)\n#+There is no difference if parentheses or square brackets `used forhAsequZs (i.e. "(...)" vs "[...]" ).?^Note: A single |` enclo)inwithout a trailinge_commae@(e.g3 | 4)")Tta groupx. While a Gh-in{[{]{Pstilljx d lAt most oneC sub@ may be inmm. TheD TQoccurWny position. IfB.isPpresent, the fixed-length#*;cotherwise itRvariableUE4`follow!islogical flowc` match!ac`againssubject valuQ1V<!noSt;[2]\ fails20an aof "str", "bytes" " aarray"| >!3.2subEt steps depend on wheGi 0+ > V$p "\"of0 gxt equal to% _numbeR'ofsndu 2. Ss#edicorresponditems in the subject sequence from left to ' 'right.\n%Matching stops as soon a subpattern fails. If allM1s succeed in mdtheir correspondx]item,?theejsDOtherwise, if theISis variable-length:KP 1.$U8# oc is less than number ofh non-star!s,KI 2. The leagB are edtM/ hfor fixedb3lprevious step{  #ssalist formed`remains, exclu7>6 !/to following #E4. R< 2 as\* a  ONote x is obtained via "len()"O(i.em8"__len__@protocol).may be cachedf byinterpreter~a similar mannercvalue p InHple terms "[P1, P2, P3," … ", P]"d@onlye=all! happens* check "< >"aS**B) == ")V* "P1[0]" (notebt this can alsNbindc names)\n'  X'\n'  '* "P2" matches "[1]" (note that this' can also MNbindc names)'* … and so on for the corresponding pattern/element.H@MappNPNs4~"3A mX contains one or more key-value}s. TheTnsyntaxhis similar to$nstruction of a di aary. SH:I$ _5::= "{" [items_] "}"D 'A1 Dq,".key_Go+ ","?H ,H(literalC9 | S]) ":"Pj | double_starm@(**" captureASqAt most9\ 3 may be in a-. >ThecW0ustXylast sub7lP(Duplicats[Ws are disallowed. 3 | keys will raise a " Error". Twos`otherw)>hav?samJ| iVh at runtime  foie logical flow!  ag0t a?#Q1. Ifv0<` is noS@[3],4 fails-2Pevery` givenQ{ tpresent" 3,_WAeache ^ d:_,uN|ssucceed- h'\n' +'3. If duplicate keys are detected in the mapping pattern, Ng is considerVvalid. A "SyntaxError"'raised for acliteral values; or a "V^TRnamed!ofMsamekE.h^Note:a Key-YR pairjmatched us`ltwo-argumentMm of?thebsubject’s "get()" method. Msk oOmustealready be pres ', and not creaGon-the-fly?viae`"__mis __or "__getitemIn simple terms "{KEY1: P1, KEY2: P2, ... }" s only if ally`followhappens* check "<>an0* "F'V* "P1[P.]"2Q* …Pso onRcorrespondCKEY/mrClass Ps ~ 1A cT#re3s aits positional *~keywordc0s (Pbny). #" _@::= _or_attr "(" [$_u ","?] ")$ @ jms [","&]|E>=C",".+9 9 A@NAME "="?~AThe wzb shoul3bbe rep7"in\s<^ng is the logical flow for matching a class pattern ' 'against\n subject value:"1. If "name_or_attr" is not an i ance of the builtin "type" ,^raiseg "TypeError".!2u  ~(testedf via "isQ()"), _fails3%noarguments are presentdsucceeda Otherwise5subsequent steps depend on whe, keyword orpositional   For a number,(@-in ( s (specified below), a singl,4sub$is accepted which will9 _entirbT;{Sthese9us also work as. foqfCuIf only 4yFocessed as}follows, one by I. Theis looked up0an (Pibutet` * IT1is 4so exAion U than "Attrm>u/th7Tbubbles up) ,=has@/edz'El associa1ith  |i# xGWPG’sV%.  /s,j(23; i  1pro)goDnextv!II4all:  +'\n'  !' If any positional patterns are present, theyconverted ' F\'to\n keywordXPusingQ "__match_args__" attribute on" P_classg"name_or_D" before _Ning:4 . The equivalent of "getV](cls,, ())" i~called.mI*this raises an excep bubbles upbe returned value is not a tuplekMsion@faild "TypeError   1ere{mOthan0len.n?)",0Otherwise,D1 "iF4Mto aJ" : 6q[i]" as/J ] =must be a string; if  h(duplicate=wL,See also Customizyarguments in  `I. OnclQs have been U  dN/s,! J proceeds` if@re wDonly bt0For\p followmbuilt-in typePhandl'ofP4subdifferent* "bool"]0 /ytearray4s0Odict/Hfloa0 '\n'  ' * "frozenset"\n' !. '4/in.?lis/?str_tuple0,These classes accept a single positional argument, and the IpatternP there is matched againstIwhole object ra, than aneattribute.hFor example "int(0|1)"vsnvalue "0", but no 'se"0.0" or "False"8QIn siterms "CLS(P1, 7=P2qonly if followingbhappens:P* "isance(, CLS)< * convert "P1" to a keyword  uG1.___args__b5achY# "6"`* "has&7"G&P2@"*.[1…5so on forcorresponding/D OpairqSee also"& **PEP 634** – Structural P Ming: SpecificaPb6bTutorialK@Funca defin=^>A f`kFa user-z&ed+ N(seeu"se The standard type hierarchy)1def ::= [decorators] "def"1name "("[parameter_/] Q h ["->" expression] ":" suit6 I +9 ' decorator ::= "@" assignment_expression ' 0'NEWLINE\n parameter_list8d5def!] (","\"0)* #P"/" [ [<]_no_posonly]] |GEu "starargsN,! F"*" g]F"**"Z] /| I   identifier [":" ,yHNO ["=MfuncnameAM A Ntadefini is an executable statec. Its6 ^bindsh6thej0in current local space to a2 fnobjectg(a wrapper arounddcode for). Thi" q contains a referenmglobal|!as9)be used whe0is called.QTdoes notedbody; this?get0j0ed 8 ? [4+cmay bed by one or more **QEs. D are evaluat{ ':dCed, @scop^&atE6E1-. n>Theresult must a, which is invok:ith fBarguThe returned value is bound to the ' 'function name\ninstead of>.object. Multiple decorators are appliedp.ine nested fashion. For example,wollowing codS @f1(arg)2@def (): pass% is roughly equivalent to*? s! 3 = @(f2()dexcept thae originalUis not temporarily5 E,".".Changed in versc3.9: Fus may bVed with anyR^validc"assignment_expresg". Previously]grammar was much mordrestrictive; see **PEP 614** for detailspWhen ono *parameters* have'rm^* "="**1saiU“default qQ~ues.”la<UCvalucorrespond FP*argu*hqbe omitrom a call,1which cas$E’s p/ isubstituted. If Uhas aUEt, all fs up until“"*"” must also aM —Othisa syntactic "on Qed by=**D2 e a0lef right w /th^ddefiniAexec@** TRmeans \PRonce,HiCpined, a65>sam=~“pre-@comp! usaBll. is especialliNtanthto understwhen a default parameter value is a mutable ' 'object, such\na;list or a dictionary: if the fun modifiesV m^(e.g.f by appending an item to a {!),Sdefault p .inddeffectd. Thisgenerally not what was intende*A>waycaround tXto use "None" a, and explicitly testf>forfQit injbody o , c:7a defs_on_the_telly(penguin=)LA3if *G-,3-O= []%.("propert_zoo")>dreturn'F call semantics are describedr!mo@tail"se |_CallsA*jalways assignss&lls0men!>, either from posi?pal arguM"s, ~keywordd9oWC. Iorm “"*idfier"”.ishpresent, itialized' tuple receiv9~y exces5gP s,dN!todRemptyk.H ?is new orderel@mapp3@ >newkQsame type. P#0 afX OX-only Amay bpassed bsS 0bef/ AsJ^QChang version 3.8: The "/"' syntax used\n' 6 'to indicate positional-only parameters. See **PEP 570** for ' 'details.\n'P\ may have an *annota* of thek}m “":rexpression"”ffollowingI name. An ,feven those"*identifier" or "*-. @Funcsh%“return” z-:-> m aftert>thej*list. Thesps can by valid Python`@The 1enc<s does not changesemanticsafAvalues are available as?of O!diary keyed byAs’M0s ie7"__>__"attribut` objecI "K" importrNfrome"__future__" is used,!@rvedstrings adoruntim9which en_sQtponed e. Otherwise,Ny q1.ed!who$e a definexecuted. IisMe$be eda different order thabey appear& _sourc/Ocode It@alsoU si`to creanonymous4s (E Oboun\Ato a ),xp immedid0useseKs lambdC0, describN!se]! L:N0Not at b#merely a shordpa simpld% cH;a8(a0defp statem @passNro p/org@ssig3 no+ just like b 2 'expressi.on. The “"def"” form is actually more powerful since ' \'it\n'allows the execution of multiple statements and annota&.s.N**Programmer’s note:** FuncG are first-class objects. Aled inside a fop definiz es a localQ5'that can be returned or passed around. Free variablesNusedf!infnestedoaaccess\!of gcontaining9def. See se@ Nam@bind =forodetail_^also: **PEP 3107** -#& Au7 original specific+U1484Type HintsD_@of a?ndard mea|S0: tS Ohintc1526aSyntaxV@Ability tomq declarOs, inclu aPinsta7!63`PostpoQEvalu0qSupport'@forwreferences within= by preserving) @OC strWm at runtime@tead_eagerOe{FC`=F!A Q \7 (sq C0e(hierarchy)S0def ::= [decorators] ""%name [inheri]":" suite7 ; k"(" [argu?_list] ")"< ::= identifierX\n' '2A class definition is an executable statement. The inheritance 'bNlistfusually gives a & of basees (see Metaes for moreP0adv~ d uses), so each item in thedshould evaluate to apeobject which allows sub.ping. C;es without72@, byault, from"" ""; hence," __ Foo: Npassis equivalent to"()/0’0ite4the ed Sa new]framezNaming and binding), usW ly created local namespace4 |/thoriginal globCB. (U5, sucontains mostlyAfunc`s.) W 5Mshesion, it  Tis discarded but6 is saved.o^[5] A 7vD; Of"ndm TattributH!di}Nary.e(0bouqco this qd.Porder*Ps are"inJNobody ivpreserv0|40"__!__". No2hati@relionly right afterhV*@es tr M/wedBec$osyntaxf%* can be customized heavily[m_0es Xalso be decorated: just like when decorating ' 'functions,\n @f1(arg)2class Foo: pass$ is roughly equivalent to*? r 3 = (f2(Foo)aThe evalua< rules for thenor express_A areMsamea>hT@s. ~result isUn bound to ^name.cChanged in verp 3.9: Ces may bed with any validQ"assignment_". Previously,grammar was much moreP restrictive; see **PEP 614**detailsQ**Proyer’s note:** VariabRdefin[i ja6attributes;yshared by instanceI -D0can0setsa metho`"self. =ue". Both2/an 0acc blN$ %6“O"”eand ans hides ag4#is way. x#s a}used asdefault<, but us0mutqs?!reqMleadk unexpected !IDescriptorto createav`differPimplerSee also:o 3115** - MetaL esPython 3000= .proposal that c(PdeclaPon of0^.tothP1cursyntax, `semanticB how!esm8pconstru  ' **PEP 3129** - Class Decorators\n' ' The proposal that added c?d?. Function and MomethodeG were introduced inN8**.ACoroutine=J0New@vers?3.5-$ f7`definiB- / async_odef ::= [y1] " q" "def"name "("[parameter_list] ")"sC ["->" expresC] ":" suiteBPExecu# of Python c can be suspenresumed atNmanyepoints (see *^*). "await#s,9_ for"YgQwith"@only"usthe bodyat!s Y0ed qsyntax are alwaysl9}s, even if they do not contain##ork?keywordsIt is a "S0Errh`to useyield from} insideZ?of k&An example:q(h11, /2)F]do_stuff()W&e some_/ARChang%7:e"LDnow ;OpreviouslyAPtreatds such]P4YIstatement++_for_stmtz"{8AAn *hronous iterable* provides an "__aiter__" method that\n' 'directly returns an *asynchronous Gator*, which can callM 8code in its Fnext.>QThe "U for" statement allows conveniion overLG Obles for@ing :`1 up TARGETOITER@_SUITELOelse8 29Is semantiy equivalD/toaB! @ = ()" Ptype(%).6@runnen= True# 3le ;[?try$= await Bexcept StopADIterationy  = Fals\?  %?OSee also__()" and'!)"odetailfIt is a "SyntaxErr`to use outside the body1of a coroutine func NGwith,-,O_h_stmt ::= %" :Acontext manager**E o?ablto suspend execuh@*enti9c*exit*.x)/ EXPRESSION as\^ib1ekaK = type(manager).__aenter__\n' ' aexit = type(manag5?xit4value = await _<fhit_excepk^False' try:TARGET = '_SUITEa ?Tru if not4xit, *sys.exc_info())pM?rai finallj  fNone, )9See also "nr()" andLfor details.H0It is a "SyntaxError" to use an "async with" statement outside /th body of a coroutine functiono **PEP 492** - Cts :sH The proposal that made; ernndalon1con/ingqPython,added supporting )-[ Footnotes ]-n1[1]0ion`agated the invocack unless ryheP" cladwhich happensn another`eTEnew ) ch s @old to be lostG$2] In pattern matching, a sequence6defined ase oftNfollowing4 *B0lasat inherits from "colleTss.abc.S"` bihas been registerE 7|builtin"(C)#"Py_TPFLAGS_SEQUENCE bit set * a class that inherits from any of the above\n' '&The following standard library classes are sequences:K] * "array."(:collections.d~@Olist3memoryview9_range4Otupl4ONote{Subject valuesype "str", "bytes", and L do :?notUmatch patterns.0d[3] In4 King, a mappis defined as one-he!B * aQ"}Rabc.Ma Pythonhhas been register / 5mbuiltiD"(C)Z"Py_TPFLAGS_MAPPINGobit se0 )a"dict" d"typesProxyTyp4] A strliteral appea!asPfirstPtemen 1funZ body is transformed intoK;’s "__doc__" attribut`?andgthereforeXB*doc*58 namespace0itee|@ , 'context-managers': 'With StaC## M#\n'  /'* D\n' , '#A *context manager* is an object that defines the druntime O/tov$be established when executing a "with" statement. TzrwShandlentry into, andexit from,desiredx1forQQon ofPblock code. Cds are normallyxinvoked usW Y (described in sections), but can also be used by directl~0voktheir methods.vpTypical|si s include sav `restor&variouswAkindpbglobal , @f$unresources,y1clooopenedx0filG?etc."For more inf^ %on_, seeMQ_ Type#.__enter__(self)@ EDw related to thisu Jq   will big#is’s return valuebtarget(s specifias" clauseO, ifu?anyF"3xit, exc_type , tracebackd E1parameter4 3LQexcep(*cgNtUtQed. I  *' context was exited without an exception, all three ' = 'arguments will\n( be "None".'Y If is supplied, and the methoshes to;@ress6w  (i.e., prevent it from being propagated),uit shouldr return a true value. Otherwise,y]{processet normally upoCthisU%Note that "__pS__()"Us not rerais-r pa?-inC !; i caller’s responsibility"See also: **PEP 343** - The “” stateZB ! 7specificabackgrounexamples for<*Python ""x :@, 'Uinue': '""/'* ~'u_stmt ::= w1. may only occur syntacti2Py nes&i"for" or~'"while9'loop, butL@funcOclass defini-ingJdQ. It!thncycle ofarest enclos  GWhenw s@rol Vof a "try s. a@"finb" clau< Pexecu]befor40'reIcPstart2? "versionsArithmetic [? +Qa descriFan aoperator below ush 'phrase\n'+ 4'“the numeric arguments are converted to a common type”, this 'Tmeans\n'Pthat poperator impleration for built-iis works asjfollows:m* If either2 is@plex 0ber1e o(k 1S;*swise, ifloating pointpm  Z% both must be integers and noTsXnecessary.Some addiEal rules applyScertain ws (e.g., aV0str^Oas anFleft=!tou‘%’c). Extensodefinestheir ownqI behavior, 'customiz?': 'Basic TN '** object.__new__(cls[, ...])1r Callgcreate a new instance of class *cls*. DD '" )" ' static method (special-cased so you nee`t decl/itwas such2 Aakes,of which anwas requesw 'as it`Ffirs. The remain Othos` 'pasPstrucaexpres(@callC ?tur Avalu`shouldqe<Cp(usually aqC"of)~ ? '&{Typical/s =/bylPinvokDsuperclass’s "__new__()" method using\n' ' "super().:cls[, ...])" with appropriate arguments Qand thenpmodifying( newly-created instance as necessary beforeporeturn ?it.Y IfJis invoked durobject construction 2it sr&anof *cls*,#n( ?’~x"__initruwill be@likeBEself_, whe*+@* isp5new,the remaiY0areJA sam TOwerelpassed toI /or.tdoes no ?new  /ptended  ly@allow subclTOs ofimmutablqtypes (iint, str, or tuple)ocustomiz E2ion. ItF s also commonly overriddeo n)a/inorder tolML 3.]3 Called afthVhas beenoed (by$_), buo it rchr. ThGOthosM sor express$f a basF>a derived GO, ifany, mustlicitly G0 it-ensure proper '   'initialization of the\n' * ' base class part0 instance; for example:G"super().____([args...])".8 Because "__new__()" and_)" work together in constructingqobjects (rto create it,/torustomizvit), no non-"None" value may be returned byd"h)"; doing soRwill Ta "TypeError" topaised at runtime?.__del__(self) Called when is aboutdestroyed. This"5l coPa fin0er or (improperly) a luctor. If amFPhas a$)" method,rderived?’"c?r if any, must explicitly ! iOrensure OdeleK1SP Itpossible (though not recommended!)?the32to postponeF"bywnew referenc Tto it!is2ed Q *resurrec*iAment@-dep# ntU& nosecondn)ZEn a ; cnt *CPython* 3 ons?oncp_guaranteed thatTs arey?for;s^ stAexisterprete5its@ '\n' ' Note:H'"del x" doesn’t directly call "x.__del__()" — the oformerm decrementsFreference count for "x" by one, and(nlatter isq #onped when_\’s {reaches zero.R **CPython implation detail:** It is possibleaGpcycle to prevent&8Nof an object fromogoing ton In this case,rwill be ladetectedmdeletedp!by^*_ic garbag$ llector*. A common cause ofpnf es!an excepqhas beefght in a localovariableB The frameL nb, whichqits own tracebackR=p7lst?ghtSi*eqBSee also: Docu2P""gc" modul]Warning.!!Duwprecarious circumstances under "Q methods are invoked,5at occur dur(their execur j@gnorj2a w,@printo "sys.stderr"instead{In particular!'* K@ can+arbitrary code$_being  A`includpUFany g0thr? Iq needs to take a lock or invoke any other blocking ' 'resource, it\n#5may deadO as the > already be taken byt:Ocodep that gets interrupted to execute "__del__()".K*A@ can\Pd dur4{opretershutdown. As aq consequenp global variables it needsoaccessw(includingr modules)have been dele\oor setqto "NonekT Python guarantee(s whose nam{?ginwith a singl' underscore are@from2ir @ bef%'sR es; if nohPreferSsuch QRexist, thir \help in assPimporm_stillsPavaili t: time whenn method is calledobject.__repr__(self)A C{eJ"L()" built-in functionK@comp3*“official”u!stmaesentabcof an  If at all possible, should look lid validdqexpress,c//bel!us>precreat; 4svalue (givenIappropriatenvironment).0 P7not5#a p!ofrOform "<...some useful descripc...>" gbturned.BT#o$@mustN class define" not "__str__()", then "__repr_ is also used wman ' '“informal”\n% string cesentation of instances that classLrequired.la ThiWtypicallyfor debugging, so it~important?thep }*-rich and unambiguousobject.__st_self) Called by "str(T!)"the built-in funcs""t(;pQ"prin'to compute J or nicely 1OableyZq bof an . e return value must be an#Ymethod differs from "R !n !Pthere/nooSexpecK"F$)"aid Pythoexpression: aomore convenient|concise0can~yEe default implemjRdefin ?typXy"Esbytes__(-H ` a -+ sF'Tfshould7"m$s"eFZ"__P#, Ospec) ,/byPexten,@ eH4tedliteralsh.</()2,`produc2“;dted”z ntation '  'of an\n' , ' object. The *format_spec* argument is a string that Lcontains amdescription of the st\os desiredlinterpretaKpdQup toOtypePimple ?ingk2"____()", however most classes will eitherldelegatehe0dto oneIbuilt-in s, or use aisimilarh syntax.3 See FY Specific Mini-Languag  a"nstandardY%return value must bU> Changed in versA3.4:Ip method "" itselfo0raia "TypeError" if pd any non-empty37: .(x, \'\')"\?nowpequivalto "str(x)" raYbthan "((,t.__lt__(x0, oy)1e1/eq1nbggb  !rewso-called “rich comparison”s Tcorrespondence between operator symbols andRo namessmfollows: "xy" calls\n" "x.__gtIand "x>=9 e .H% A rich comparison method may return the singletonNotImplemented"qif it does not i5f operation for a given pairw/ofi@argus. By conven[, "False" L0Tru /reb"ednsuccessfulL. However,#se\Ts can]any value,r@o ifXq Aor is used in a Booleacontext (e.g.pi PcondiH of an "if" stat), Python willX"bool())op to determine`resultotrue o$fBy default, "object"s "__eq__()" by u Cis",?ing"D{Acasem :r&xyr[else vP. FornTb delegates too3{qinverts`unlessg/is oThere are no otherqied relgships amonglxs8nl;D0exaotruth  P"(x1(ifrF@vqchanges8Qbe in_Qwrong bucket)gRUser-doxes havexq Os bydefault;z`them,  s compare unequal (excepk '- themselves) and "x.__hash__()" returns an appropriate ' 'value such\n!o at "x == y" implies both th is0(x).Q Oy)".q A classuoverrides "__eqdoes not defin"0qwill have ithjcitly set to "None". h@Whenm method of a#isb, instances d2the7o\raise("TypeError" wa programattempts tooretrieve0ir I |,also be correc[identified asr uneBablechecking "isB_(obj,Ccollections.abc.HashQ!I5@needH?ainp?the`ementa! Xfrom a parent#,jinterpreterr@musttold this explibtws/ =M!, ox7Qwishexqsuppreslj 'ort, it should includel#Q__ = '! iw$i.Swhichs6ownwj*Is a  be2%a0 by /_ callh_Note:Y ByBaultT z1str_bytesobjects ar  '0 “salted” with an unpredictable random value. Although ' C'they\n(remain constants inu individual Python process,j are notr between repeated invocations ofi.This isk intended to@vide0tecb against ah denial-of-service causedr "by carefully-chosen inputs that exploit the worst{Ocaseg performance' a ` inser, O(n^2) complexity. j/Sei http://www.ocert.org/advisories/-2011-003.htmlh?for details.Changing hashqs affecBae iter gPorder_sets.r Fh never made guarantees abou1is VHo(and i typically va8 p32-bit B!64 builds).SeeOalso "PYTHONHASHSEED"D version 3.3: H~"izPis enOd bydefaultobject.__bool__(self)r Calli ment trut[P test}Ot-in#op|q"()"; should return "False" or "True". When tWmethod isQ defined, "__len__()"5oPif it)rxX ,@iderYArue bqs resuljnonzero. If a classRyneithernE)", all itstn/ar , 'debugger': '"pdb" — TheD! /'*\n' '\n'  '**Source code:** Lib/pdb.py-=2XThe module "pdb" defines an interactive s debugger >forb0Python programs. It supports setting (conditional) breakpointse>andesingle steppOUat thline level, inspeci of stackcframes,g0lis, and evaluaVarbitrary = ini>theepcontext3any<FalsoApost-mortem_>ingecan be called under Nrol.:Dker is extensible – itactuallyaAd as D^classd"Pdb". ThisNcurrentlyocumented but easierstood byOread60. oface usem:@s "b;T _"cmd"F@’s!mp<`"(Pdb)ypical usage to run a*\ La:- >>> imO pdb# "my( ("KTrun('*.test()')\n"Z3 (0)?()XA' 3?inuf H1H%NameError: 'spam' n pChangedUversion 3.3: Tab-comple1viaf"" iu`availafor commandd A arg}qs, e.g.m nglobal8 lonx are offere&c4"p"ZP.py" >be invokap scriptQ O oth&s. For\n'  'example:\n' ' python3 -m pdb myscript.py/When invoked as a ?,M will automatically enter post-mortemd debugging if the program beed exits abnorml_. Afnh PZQ(or aBSb) o) bxrestart! |preservesI’s state:^(suchj,as breakpoints) and in most cases is more useful than quitt~ >thed)ter upon.10Newversion 3.2: "pdb.py" now accep "-c" opt(Mthat executesfcommandsaif giv a ".pdbrc" file, see DnCer C6#7mmodules similar toJVway "" does. As withr pause [zjust bef:first lineFpThe typ+` usage3 inv isoinsert`importS;.set_trace()aAlocayou want,{t' 0rung. You ca&n step through8 code followMthis5^ment,gcontinue runnF3"ouk us"1"Pg 07: built-in "P`()", wBC-eddefaults,CbPstead"" inspect a crashed? isF>>>  >>> import mymodule\n' ' >>> mymodule.test()(Traceback (most recent call last):7 File "", line 1, in : %./$py@4@< 2\3\2]print(spam.NameError: %Hzopdb.pm)> ?(3) ?-> O(PdbBThe  defines the following functions; each enter% ddebuggerfin a slightly differT?wayM@=run(statement, globals=None, loc  Execute*Y* (given as tror a code object) ?und4  control. t prompt appears before anyd.isB ed; you can set breakpoints and type "inue", or0 ?canfstep through870 us)"""W"next" (5Othescommands are explained below)* opCal ** **@argu7s specifypenvironBwhicj f/byhqdefault^!di8aary ofh"__main__" is used. k1(Seg* na\built-in ""()@eval .o>expressiont1Tvaluau[v vWhen "run)" returns, i /the|. Otherwis%is?~similareoN()".pdb.runcall(function, *args, **kwds)\n' ' Call the *IT* (a or method object, not a ]ostringvq withdgiven arguments. When "runcall()" returns, itdwhateverhVSed. The debugger prompfappearsfas soon ashis entered.8 pdb.set_trace(*, header=NoneCA@ Ep!ating stack frame]is isUuseful tof hard-code a breakpoint a@in aQpgram, e-ifl?thefa!is[otherwise bed (e.g. w1a0serQfails). If 2, *d*printed to1onsole jus_beforobeginsthanged in version 3.7:keyword-only*b^post_mortem(fOback` H-H9!of8Z% *`*$-. OIf nb?$isbit usefCone rPexcepN thaicurrentlyShandled (an Rmbw$ iupdefaultaPto be/d)/m( P founl"sys.las&"J%*",vs and ")" are alia=forinstantiating"Pdb" clasar same nmIf youpOwantgo access fur features,F@have-d0 isnrself:K " Pdb(completekey='tab', stdin 3out "Askip, nosigint=False, readrc=True)\n' ' "Pdb" is the debugger class.1 The *completekey*, *stdin* and out* arguments are passed tohunderlying "cmd.Cmd"P; see8 description/reFskip, if given, must be an iterable ofglob-stylemodule namrtterns.A{ will not step into framesmOthatgoriginate in a mv/ matches onHthes >[1]b By default, Pdb se handler for SIGINT signal (whichois sen1whe user presses "Ctrl-C"  console) /1you ia"continue" command. This allows Oto break< ;cagain byQ. IfcAwantK /ou,/thki,P *nos0t* P/ru^ sN=@rols{Mtheru?Pdbload .pdbrc files from;_ystem0ExaP call!en@tracsawith *: "Mimport pdb;P.Pdb(D=['django.*']).set_ioe()\n"0Raian auditevent "pdbg!" &noJ 0New @versB3.1:O&2Oa. Previously, a n5' =was never byzChanged6 Urun(state , als=None, loc  runeval(ex?ionC!call(function, *args, **kwds)\n' ' set_trace( 2 See the documentation for@funcs explained above.PDebugger Commands5=#SThe cS recognized bydware listelow. MostQMcan be abbrevia:pto one #wo letters as indic#,; ?e.g3"h(elp)" means that either "h"bs"help" used to enterd/ (but not "he_", nor "HHq_ELP")1Arg,s*@must+Psepar~whitespace (s.ortabs). Op~Eal asPenclo `in squ~bracket_("[]") inf6 syntax;/ S7be typedlternative H\ a vertical/ba?("|E!ing a blank line repeathde last3PMed. AExceN: ifhs Jpwas a "d"_, qnext 11s  $5\x?3doesn’tnRassum?-be_Pytho#PstateQs andIPexecu!in@cont!ofprogram beinglt c@alsoGprefixed with anaexclamgpoint ("!"G`This ipowerful wayyinspect  @; it]even possible\change a variaor call aiZ@Whenea occurffsuch aCk*>namiv@prin!OB’s_r supports aliases. A Phave :!meP' 'which\n' 2'allows one a certain level of adaptability to the context under\Qexamination.opMultiplX&mmands may be entered on a single line, separated by O";;"y$(AD";" is not used as it[or for m e"coiA thaW0pasg>Python parser.) No intelligence.isepapplied3ing;Ainpusplit at ^firsteI pair, even if(!inGamiddle&@ quoostring~^ If a file ".pdbrc" exists _ user’s home directory or" >thedvcurrent=,@readFand execuhad been^typedgWdebugger prompt. ThisYparticularlyt1ful_ aliases. IfgAboth2s*,2 )1is  /an` defin`here canoverriddenw-QlocalaChangeyversion 3.2:i1nowbfKRinue zing, such""1"next". Previously,OthesE no effecth(elp) [] Without argument, prinAlistsgvailab7.9 ad**- iphelp ab,A. " Opdb"fdisplaysfull doc  (F2doc8"Pmodule). Si,.0P mustan identifier"Gqto get oD"!" J w(R) a stack trace, withPmost rec\frame 'bottom. An\n' &' arrow indicates the current frame, which determin$ Kcontext ofgmost commands.#d(own) [count] ~ Move! *E* (default one) levels down in ?thedstack trace (to a newer.)?u(pQ up _n oldb(reak) [([filename:]lineno | functiop, condi]With a *P* argument, set a b|$re 4 e*g atjm first;executablB te within thatp. The number may begprefixed[0 a  and a colon, to specify8Ppoint7 +anotherd] (probablyV hasn’t been loaded yet)8 i/isd searched on "sys.path". Notrat eachs+assigned aeh#to1all[o referC_pIf a seO is prese itPan exCsion &Omustd`evaluao true befor"eis honored5outp, list #rs, including for +,aof timh(at2hasRAhit, fb ig ,tassociated if any!tCTemporaryis removutomatically when it ' 'is\n' *' first hit. The arguments are the same as for "break".Jcl(ear) [filename:lineno | bpnumber ...]: With a *N*, clear all0poi /atdPthis .o space separated list of ] ua new *<*?#, an expression which?mus@ befje` is ho d`absentpy existwbremoved; i.e.B  'breakpoinht\n'  ' is made unconditional.+commands [bpnumber]% Specify a list of Lfor breakpoint X$ *bL*. ?ThefT"themselves appear on the following lines. Type acdPntainCjust "end" to terminatei. An example:QV(Pdb)$1(com) p some_variablA (-?endNv To remove allgfrom a0, tb""ka it immediately withu; that is, give no@ WM'non argument, arefersohe lasZ?setYou can use8vstart your program upIOgainvQimplyc"continue"g, or "step" any otherfresumes execu^>%[i PQ (currently,e"next", "return 0jum"quit" andiabbrevia/s)f sDeb(as if=wasd ed by end). This@becaNF@time:GefUdR(event0a sE e 9.-!),\ macounter an:Q# —which could have its own0`, lead/toSambiguitiRbout Xj#toe!If@+‘silent’iNj, _usualmessage aPstopp)at>not printed gb 0' desirable for breakpoints that are to print a specific ' 'message and\n then continue. If none of other commandsonything,n?youfsee no sign7the was reached.Ans(tep) Executecurrent line, stop atfirst possiu +occasionb1(ei(in a functiois called or Re nex= inC?thed_))_n(ext)C! e2Quntil   *? isit returns. (The difference between "z" ,o"step"fi(#s inside as, whilekPe;s@(nearly) fulled, onlyrping atgYjt.unt(il) [>no]p Withouaugument,]} with aonumberfpgreater )$e |i " a5v('or equal In both cases, alsoO wheO Erame&L Changed@0ver 3.2: Allow givn explici Ig!r(i  0c(oOnue)'( a-isencounteraj(ump)#no '\Hn' 2' Set the next line that will be executed. Only available in 'OOthe\d bottom-most frame. This lets you jump back andu] codeeoagain,h"orIforward to skipHldon’t want#Nrun.O It shouldRnoted.qnot all~Ps areowed – forinstance itj0is UPpossin!to]Q intomiddle of a "for" loop k1out'h"finally" clause l(ist) [first[, last]]` List sourcecurrent fil!@Witharguments,ElK/11g0oun$e _'pcontinue previousc?ing0 ` "." aj#, M-. kNDone _aa.?twoOKsL|given range; ifbesecondz/ i?essdAthanE#@, it?interpre83o count\T+ThicZg@dicaeby "->"m_If angexceptionKbeing debugged,ABwher;0 ^/waBorigvp raisedapropagXis in@>>",-it5odifferhAfrom"n0New@vers P3.2: ">>" markerKll | longq#P' 1unc#orULIt0ested~""> :na(rgs)` PrihWof 'p expression\n' ' Evaluate the *?A* in current context and print `?itscb.e. Note:"!()" can also be used, but is not a debugger comm=—?thi executesvPython }function6pp gb Lik4"p", exceptd1 of _ pretty-hOed usingL!"p" modulowhatisPWDtypeaosourceTry to get Ccode for given objecdisplay it ewW0verO 3.2:i[]C DU$f it chang8each timeQ ion stops\&Ofram% Without, list all s ~N#$un!oBN any moreiW_clearXinteractp Star 8 iv80terGer () Owhosglobal namespaceAains^(#gblocal). efound i! s_ scopV ' New in version 3.2.\n' 'alias [name [command]]( Create an Gcalled *N* that executes *]*. The hmust *not* be enclosedquotes. Replaceable parameters canj/bee$indicated by "%1", "%2", and so on, while "%*" is rt1 ?allf(th. If no Upgiven, (scurrent] b?forb~is showncarguments are f2all^e dolistedI@ AL`es may ne=?contain anything blegallytyped at$pdb prompt. NoteWinternal ^s @*canSgoverriddenjhSuch abthen h+]untili/thtVremoved.Eacursively applied to _firstqword of6 p line; `other $sPw% d?lefc_alone&s1example, herentwo usefup(especi  we d!in".pdbrc" file):+2# Print instance vari_ s (usage "pi classInst")Ipi for ke%1.__dict__.keys():2p}("%1.",k,"=",6?[k]oin self Os pi(:"unq Dele!e fFBp! state_B EP(one-5) *H*4ext. nepstack fy.exclamat poJ@omitfaunless i statement resembles a debugger command. To set ' L'a\n" global variable, you can prefix the assignmentf_ withb"cq" stateF!onXsame line, e.g.: "T(Pdb)list_options;  = ['-l']\n"H e'run [args ...] oestart$ 6C R9hpd Pythoogram. If an argu@-is|supplied,fit is split"shlex" andQresul%qused as?newO"sys.argv". History, breakpoints, ac`rO aregpreserved. "r(" lias for "run".@nq(uit) Quit from ^Qhe pr being executed babortedeO codEnter a recursivethat stepQrough] Wd`(whichvrbitrary exwsion orVto be /ine@currbaenviron)7nretvalX Print return valueISlast of a fun-[ Footnotes ]-[1] Wheth fris considered to originate in a certainmodule isgdetermined by"__name__"Ys, 'del': 'The "deli.'* del_stmt ::=Yptarget_ . @Dele]aly defvery similar>8way'.'EA. Rathan spell`it out-full details, hereI som 'hI ]'nletes each target, from left\n' 'to right. Deletion of a name removes the bindingBthat!mglocal q)or]aglobal5space, depeRn whetherizoccurs in a "="Qstatement$scode block. IfPis unbound, aI"NameError" excepwill be raised6pttribut9ferences, subscriXs and slicings is3ipassed!toprimary objecvolved; dXWin generalPpequival7to assignEqn emptyee6 type (butIeven^1thidetermined by#ed)OpChanged@vers3.2: Previously it was illegal toe [0 ifHfas a free variableka nest\\n', 'dict': 'Dic5displays> '* !  A Z7ionRa possiblyPerieskey/datum pairbenclosVcurly braces:w ! _I::= "{" [key_qr_list |-comprehen]-I '"}[ ' EdaV (","&)* [","]1CH`expres0 ":| "**" or_$ P_ P ,*_f* 'XPyield1newC ) PIcomma-separated sequxB`given,Zy areQevaluF7D^8 `define=D entz| _@eachu~ckey inCwAstorv correspoD@. T@meanat you can specif*:keyPmultiple timezX,Wfinal8’ 'L ` fo!ataMlast one  PA douasterisk "**" denotes *dictionary unpacking*. Its operand\n' 'must be a *mapp.c Each  item is added to the newIy. Later values replacealready set by earlierMkey/datum pairs and) i*s.@ New in version 3.5: UX intoUdisplays, originallyPproposed**PEP 448** Ac comprehen,contrastYAlist +*s,needs two expresOs separated with a colon followZusualP“for”P“if clauses. When Arun,Vresultingf1key` elements are inserih1new2dlsojjqThe strTMpassed to~built-in func"eval()<v"exec()"AA3CNuted in an *ion frame*. A containsgsome administrativDPforma0 (ufor debugging) dtOminegQwhere8Fhow inues afl?’x>/halcompleted.1Namnd binding8=%Be of namB-Y *NOp* referobjects. 0 artroduced byC0ope8?onsp~`followdconstructsk/s: @l pa@ters,Gclass definis:l="aassignexpression|targets thatpdentifiif occur4o` * "for" loop header<A"as" "p" state, "except" clause or* `?as-ppattern:K0uramatching/ capture ^* "import7>atement of the form "from ... import *" binds ' 'all names\ndefined in theLed module, except those beginning with anQunderscore. Thismay only be used aTeg level.NA target occurrin a "del" statement is also consideredPboundht@purpq(though$ actual semantics are to un# g)Each assign#ors^blockOby aclass or function 1i /or (' Atop-fAode AIf a2, i local variable of that|,unless decla qas "nonX""global". iN]u. (TheseOhckR and k#.)4"is_ OfP but not3 ed&reF*fre*Arenc program text refers|*Oing*- established byp follow]"aresolu &_rulesR[!of-LA *scope*svisibilityec  awjUHWa!s include"at.. Iej^sa,q@extento anyj1wQconta!ing one, Eai,Ofintroduca differname.\n'  V'\n'  'When a name is used icode block, itresolved using the OnearestiQenclo9 scope. The set of all such s visible to a jhis called&’s *environment*.9 not found at , a "NameError" exception. raised. IfjMrcurrentCaa funcQB, anbrefers$ n_localiQvaria[hat has yet been bwPvalue^pointPwhereijSA "Un_L3"L;is a subclassE$If@bindQoperaroccurs anyFwith pi,1useJM9 aGreated as Aence m?thef@R` `n lead'e?s w cah`s befores1rulLPsubtlPython lacksPRdeclavpdE2ows eN!e * t&N canjbdetermined by scannT@enti!ex^2for sr"global" state  I%s    KrspecifiE)kaQthosesi/in_top-level:0packsNB 0 A? byodsearchDu`, i.e. j_modul;econtai/rbuiltins,v enamespace\n'  0'of the module "builtins". The global namespace is searched ' K 'first. If\ngH are not found0re, ~ p J.f"" statement must precede all uses Olistex1hassame scope as a bindingHoperationi&inQQblockpnearest enclosZrfor a freekvariablejpcontainQPRArtreated EPnonlocal!cacorrespoB to refer/topreviously b#s eQ@funcck"SyntaxError"&@rais%t compile time iRgiven Ndoesi?notPexist7anyLDR>m!is automatically cahTimportedvDmain`script>_alway/edf0"__P?__"1Class definigs and arguQsm"exec()"P"eval /ar^pspecial<m0ext{p resolu\. A c e/ ut that mayev s.s+\_ences5bfollowormal rules  with an excep4/ha"un Rlooked upSp.g/Th! bbecomeattribut2!di-_ary o\t "of eda @limi{the class blo!ck; it does not extend to the code blocks of ' 'methods –\n"this includes comprehensions and generator expres^sincelthey areiimplemented using a function scope. Tmeans that followingfwill fail: class A1Ioa = 42>#b = list(a + i for i in range(10))<cBuiltiprestricBPexecu;G- 4**CPython ar@ deta** Users should_touchLC"__b1__"2is Oly ad.. ctc@wantVto override valueI namespace c"import"hs"K" module*modify its attributes appropriately.QDThe cPassocIad with a  h is actually found by lookI!upa-  hoglobaliEr!; q3qbe a diary or aR1(in elatter casgmH’s] is used). By default, when9 l"__main__ g,4-in4;t moin any>SotherHoan aliaszS/th:k?elfaInteradynamic features4 -4Name resol&0freriables occur runtime,.ats/il48.print 42k ' i = 10Y\n' ' def f():/print(i)"oi = 42/f(5,The "eval()" and "exec functions do not have access to the Ofullfenvironment for resolving names. Ns may be_ed ingOlocahbglobalYpaces ofF caller. Free variables are /ednearest encloswT, but b.o. [1]i oppal arguiQoverrideXS6. If only one/isfspecified, it is used_both.2AExceu=Maa mean/Pbreak4out?normal flow ocontroof a code blockPorderF handle errors or other ePcondi:&An.j*raised* atpoint wher | detected;*Qd* byasurround0.or,oby any8that direct}Er inqinvokedw3 goccurredPython interpreter k8s a@when/<>s arun-time(such as divisionlzero). A program can alsoO`xpliciJ 1ithL"p" state=.{grL% w`try" …_ kl/Th"finally" clause) "bep2to yccleanupYwhich does, s 2Iutede 'whether an\n' "'exception occurred or not in the preceding code.CPython usesE“terminak” model of error handling: an k:!er can find out what happened and continue execu? atm_outerilevel, but ito%arepairPcause6y^retry?thed0faiQ oper+" ( by re-enterdQoffenApiec{ :h1romOtop)@When12!is)dP1ll,Xiopreter /es!ofKprogram,returns to its factive mai:loop. I1ith90se, prints a stack traceback, wz g!"SystemExit"nEs are identified @classtances. The ""q!clipselected depOof"inm:*NmustfreferencePra base 3eofwnbD"iv)ran carry addial informo  abPpPional`Q_Note:%%  messageDpartuv2API>i|?ent  may change f"one vers3of ` to next with! 8warningashould@`be rel!onode which will run undJmultipl s.rSee alscdescri,P"try"/Qtemen30secW ?try3sta@o"raiseV F '\n'  '-[ Footnotes ]-\n' !/ '[1] This limitation occurs because the cod at is executed by d_theseiAopercsGnot available ati0timie module( ccompiled.\n', 'exprlists': 'Express*#0 i\_\7::=W (",")* [","]OustarredL0 OBitemQ.)*tdd8| (`O ","d% assignment_xa"*" or!Except when part of a or set display, an#Pcontainingleast onmma yields a tuple. The lengthy (+j!is`number> As inf/arO`evaluafrom left to rightAn asterisk "de;Q*iterunpacking*. Its ~nd must_be anQGEaMpanded into a sequence%H.s,i_whichiare incluPV2new,", *,1sitlce0New1verm3.5: I`#originallybpropos**PEP 448**Ptrail  cois required only``createRingleZ(a.k.a. a!*s;ton*); iR opy alall other cases. A 3h4ipwithout doesn’t , but ra} /thGGthatzU. (Togrn empty6 , ]/an%Npair'of parentheses: "()".)\n', 'floating': 'F  point literals\n' /'*)d are described by the following lexicalPdefinitions:1 number ::= | exponentAA[digitpart] frac5 | O "."K m(5|)H5r (["_"]/)*;:2"."2434("e" | "E") ["+ -zHZNote thatinteger and Ks.palways &rpreted ^usinggradix 10. For example, "077e010" is legal,|qdenotesMsamegLhas "77e10". The aed range ofRq/ itiPmenta]-dependent. A /, underscores>are`supporJ2for grouping./DSomeQs@3.14dq .001@e100 1e-1 !0e #n_15_93 Chd in version 3.6: UK5now, v6bqpurpose\ or,"for" stateH Mused to qte over!elqa7'sequenc7'(such as a string, tuple or list) RotherjbYbject'qor_stmt\ ptarget_VP "in"0resz:" suit'["else" ".]| <3expf<`evalua' once; it should yield an Oo!0torP1creNI`result?*th%"e1". ZKthen execu for each itecm\n' 'provided by the iterator, inorder return'7. MIEach^AitemIurn is assigG!to]target list usingstandard rulesQ3forEments (see AV` state ps), andPzsuite iOexecuted. Whe)s are exhausted (whichimmediately w39thepsequencvp empty nd raises a "StopI{Hion"Texception),] "else" clause, if present,dJloop]erminates. A "break"v ghe first tU uswithoutD  B’sN. A "continue  Qskipsqrest of :g =4@next m, Ather 0no 4 wmTM0or-6@ mak7#s Pvariablesa ]This overwritM ll0DviouGZFose \including th1DmadeWdf:5 0 i@range(10)0print(i)?Pi = 5 0# twill not affectI@ P# becj1 i N%beOEten - N p# index ?Nam@deleQFis finished[3but ,,y[have been ed2)at4all`z. Hint:K built-in func! "3()"vIs anOrintegerqemulate`eof PascalC"]i`@:= aGb do"; e.g., "('3)P"[0, 1, 2]"l, 'formatstrings': 'F! Sx Syntax| /'*+4"str.format()" method and the "Formatter" class share ' '1osame\nsyntax for mat strings (although inwcase ofg,k!ubes can defineZjir own o). Th#? isqrelated to thatf:d literals, but it is?leshsophisticn@and,3 particular, does not supportcarbitraryexpressions.#1!s contain “replacement fields” surrounded bycurly brace"{}". Anythingi ed*Ezconsideredtext, whichMcopied unchange output. If you needto includ>a characterrW !itbe escapVdoubling:A"{{"O"}}"Hagramma= a 7as follows|T_Q ::= "{" [_name] ["!"u`conver&#:"_spec] "}" d 1argx ("." attribute|a"[" el_index "]")*~ h}~[identifier | digit+]H  G= w1 | _H )F +k ik"r" | "sa %C0In l terms,]start withvah '2*field_name* that specifies the object whose value is to be ' 'formatted\n and inserte "togPutputqtead ofreplacementm_. Then is optionally followed by a *conversion*m, which isrcprecedWn exclamav point "\'!\'", ak*F_*s` colonf`:\'". #senon-defaulU@ for.)rSee alsFrSzc.Mini-Language secDfJThe  tself begins with an *arg/iseither anumber or a keyword. If it’s a ", it referJ@posi/alo@arguJig} hd3k numerical <`s in a7mF_tringlare 0, 1, 2,q0…Osequence,y can all|0omie (not just some)Ux?ber }"wih@autoc4-oorder.oBecaus8*Qquote-delimited0is possibley)?ifyNarbitrary diG keys (e.g.^! ss:P10\'"l"\':-]\'")A/inv k*be/nyL9_indexrzttribute expres@s. AGeo@"\'.-oselect5H*5d az us@"get1()" lekzA"\'[P doesX lookup __getitem__()"; } '\n' -'Changed in version 3.1: The positional argument specifiers Pocan bemomitted for "str.format()", so "\'{} {}\'a, b)" impequival/totU]0} {1W.2*4*QF&Oter"Some simpletmat string exa/s:$ "First, thou shalt count to {0}" # References f.+_wB`me a {f # Implicitlyqr3theqFrom {} Sa2s ",0-,O{1}"My quest\{nameq ikeyword"'HO'\n" `Weighttons {0.w|B# \'\' attributew?'ofe Units destroyed: {players[0]!# A ele/of{"I/'. C*con * field causes a type coerc<_beforOtingN0lly^`e job Bt7 a valuedone by ]2"__qO__()g`methodfH]tself. However, sJ caitdesirable @forc7Dto baQ, overridq?ownQdefin Db. By AOto aM' q@call xnlvPlogicbypassed(@Thren flags are currently supported: "\'!s\'" ' 'which calls\n""str()" on the value,VrVAQ "rep,?andoa7r "ascii()".'Some examples:% "Harold\'s a clever {0!s}"=0# C/ ;argument firsttBring outcholy {name!rws`t3More {!abtu/The *format_spec* field containification of how*vm should be presented, includsuch details asowidth,Palign,r0pad[, decimaly0cis&so on. Each\ type canqdefine itrown “Rtmini-language” or interpretTP Most built-ins_gommon  !, rnis described rhe next sec=Asan also9bsted replacewithin it. ThesVAD may/ ak DaconverPflag  p, but deeperl1nesh_is noallowed. +r?aresubstitu0befR &is}?ThisDof aoj`dynamiyo/edSee the Format ex amples section for some exm.\n' 'Format SpecificalMini-LanguageP=93“ss” are used within replacement fields containedtOa]string to define how individual valuesppresentpS(see SlSyntax andCted literals).They canalso be pas<directlythe built-in "f?()"g1fun. EachnEtable type mayGs$ / itminterpretedFMost0s ijM@llow ops9 s, although2of mtn^OonlylPuppor;!byXqnumerics#PA genyp conventhat an empty3&producessame result as if you had called "str!onaA non-r@typimy modifiesjB5TheDm of a *standard<er* is:# F_h?::=[[fill]align][s#][0][width][grouping_][.precision][$]1ill=9="<" | ">=/^"C;C+7- =:0 =odigit+q -4!"_k,kRok ' type ::= "b" | "cdeEf'' 5 0'"F!"gGnosxXO%"\nJIf a valid *align*ue is specified, it can be preceded fby a *fill*qcharacter thaVFany and defaults to a spaces/ifjomitted. Itnot possibleUuse a literal curly brg(”"{"” orrP“"}#) as the in a forma stringor whent usAlR"str.[()" method. However&isto insert aq*with a nested replacement fiel}OThismitation doesn’tsaaffectQ"@func?.6The mean7!ofUvarious  opZs8afollows:g/ &+-  +y1| O]|M#O|0=|  y| "\'<\'"r| Forcebe left-!inB`availaZ/ { t| (t#i"_ mostobjects).Iymh j't O"\'>mOrighn"|/ m!mnumberhXy ' ' 6'+-  ?+\na | "\'=\'"| Forces the padding to be placed after4sign (if any)S|{ !| but before} digits. This is used fo|Pprint`fieldsy!inqform ‘+0r120’.alignment`option@onlyBvalinumeric typeI3comqdefaultw/ ynumbers when immediately preced~ kq width.~} ' ^centered withinavailableqRspace=PP~0Notat unless a minimum VRdefined,1nwill alwayssame size a@dataf,oit, so atl+has no meannis case.DPThe *a#* \1is r F2berE, and cabe one ofo'following:%kOMm)w|===========|=(m|\n' ' | "\'+\'"| indicates that a sign should be used for Qboth positive as { t`| well2Anega>anumbers.5 yZ&+-  +m -mAonly/ | #| G (this ie defaultehavior){ya c'm Qspaceleading %&onk, and a minusU5on v; rk~0The[#option causYe “alternateum” tobw?theqconversion. ~ adefined differentEn%p@typeTC1is Bvali'integer, floP/nd`complexl CFor Qs, when binary, octal, or hexadecimalkoutput ism!, 2add#arespec`prefixo0b\'",lQ"\'0o x v!orLX0sto the pvalue. E0(pHform0res!ofSMalways contain#a u-qpoint characteven if no digits follow it. Normally, a '  'decimal-\n' 'point character appears in the result ofse conversions Ponly if apdigit follows it. In addition, for "\'g\'" and G l,otrailing zeros are not removed from.F0The, op signalsT0use9qa commaa5thousands separatorFor a locale aw4 , s@"\'nintegervpresentaOtypeinstead6pChangedI2 3.1: Added 8"\';(see also**PEP 378**)_n underscoreEPfloatj usk Npd\'". *> ("\'b\'",Go x@"\'xA"\'X ? s will be inserted every 4ss_other, specifydSthis iZo?errb6c?515*width*   Rdefin e minimum total afield RE`includT0anyffixes,!s, aformatls!If@ied,/cdetermined by@content6 When no explicit alignment`given,)!ce7/by7 ("\'0\'")enables sign-aware zero-padding ' 'for numeric\n",types. This is equivalent to a *fill* character of "\'0\'"swith ano*alignment* {O_=\'".3Changed in version 3.10: Precethe *width* field by/nonlonger affects Zdefault  nstringsTPpreci*a decimalber indicathow mandigits shouldbe displayed afsQpointRa flovF_valuekformatted @"\'f=0andIF\'", or before mu  g/orG0 FM?on-s0num!sesmaximumosize -xin othernuwords, s will be used fromQcontent. Th* no0lowbo te bFinally,*@* determines3atapresented available  M at\os are:/ &+-  +yb| Type|@MeanR%|0=|  y|hs1| Sd1? { s_| may0omi$., |\n' O' &+-  +yb| None| The same as"\'s\'".1~ available integer presentation types are:Dk5TypfMeaning #P&|=  y| "\'b\'"| Binary format. Outputs the number inlbase 2{$ ' F"\'cCharacter. Conver!tocorrespond*|g| unicode c beforeaprintingcNya F m dmDecimal IIc)10o_OctalT ?8x?Hex in base '  '16, using lower- P|\n' W' || case letters for the digits above H'9.F yI&+-  + q"\'X\'"P| Hexmat. Outputsnumber in bm?uppm?_9. Ins@"\'#!is o specified,prefix "\'0xPowill bAd to5N}/asOwellIyY ['e nL1| NM. This iapsame asB_d\'",except that it use> current locale settto inser[appropriate 2[ | separator`characjhDNoneDThe 0"\'m a  In addition70presentaypes, integb/ca#be?tedrAwithAfloanpoint q listed below(f0"\'sPand ""). When doKQso, "0()"1use@convb$ pQto a Xfnumber before formatting.\n' ',The available presentation types for "float" and "Decimal" gvalues are:r/ Q&+-  +yb| Type4|rMeaning$(|0=|  y| "\'e\'"| Scientific no. For a given*`precisA@"p",@@matsS{ !| the number in sQ with'-letter ‘e’Vq|"| separaKaacoeffiQ fromvexponent. UNjhas one digit beforepy*@s afA yda point a total of "p + 1v@sign!2ant?s. yW now3X@, usDq#6"xk& ,oxshows alltkaU. If noZ1Allowk ,=  iszremoved unlesa"#" opU/isQused.L k4 6'@ O"\'E9 uSame asdexcept itn upper ' |  | case ‘E’ as the separator ' & 'character.?|\n9/ Q&+-  +y| "\'f\'"| Fixed-point notation. For a given precision "p", formats |s|a`numberoa decimal Owith{pexactlyyQ digiwyfollowingw0. Ww/nozo, uses&a Adof "6"Qafter0 lD #| "float", andlarge enougrto show allQcoefficientbfor "Do". If ny 2,=  is alsremoved unlesy7`"#" opIgOused6cOY7 9'C FC @Sameo,Sbut converts "nan" tooQ"NAN"A"inf<_"INF"qogopGeneralYmat. bpp >= 1"i9Rround!tosignificantCthenm +^]result in either f>0 or5{|\n'  U' | scientific notation, depending on its ' 5 'magnitude. A_ |\n- yprecision of "0" is treated as equivalent}Vto a Dyo1". TheBe rules are|follows:zsuppose thatthe result format@with2sen~utype "\'e\'" andy)"p-1" would have expongC"exp,n, if "m <=exp < p", where "m -4q floats5!-6'm"Decimals", y`numbere |y6pre|y4\'f w-LrOtherwise AVnW. In both cases insign\a@railiBzerozoremoved froms!d,Zd"` pointzyTalso ~ if|>Are n0ainz igVh&9it, unlesst#p opoused. HWo nor~{given, u~S66" {drk"*t". For acoeffiKq{/isS^moobvalue;_Zsmaller than "1e-6" |\n' W' || in absolute value and s where the MDplac6!of(yleast significant digit is larger than 1,|fixed-point ynotationj used otherwise. PositivAnega"Gkfinity, pfQQzero,yans, areyformatted as "inf", "-0 /0"yT"nan"u`respec.ly, regardless .precision.l yK&+-  +O b"\'G\'"| General ua. Samex0\'g&oexceptswitches to "\'E0/ifnumber getHoN?. Trepresen"inU1NaNuppercased>too y kn1| NiZ isM}sthat it us/he current locale setting7ainsert)appropriate * | separatorcharacters Q  ' %@Percge. MultipliBoby 100displaysn ("\'f\'")S, followed by av  'percent sign. U|\n'  '3&+-  +yb| None| For "float" this is the same as "\'g\'", except that whenV| | fixed-point notationused to forma]e}result, itSy always includes at least pdigit pdecimal /. yThe precis isfAlargooneededto represiy given value faithfully. D  yas eitherI p\'G\'" depending on#he"of }"context.capitals"T@currG? yoverall effectto match}output ofp"str()"aaltered byizHmodifiersuyO 'FBexamples&=&T41sec1Tains r.osyntax?andkcomparison witKrld "%"-\_ting.>PIn mof2Ccaseis similar/ol ,qAaddi6o{"{}" andB":" !`nsteadJs@"%".o,`%03.2fzcan be translatpQ"\'{:#O}\'"H  'The new format syntax also supports and different ' = 'options, shown\n% in the following examples.1`AccessAarguments by posi:7" >>> '{0}, {1B2}'.('a', 'boc')\n"C'a, b, c'#f`c # 3.1+ onlyMp2m0 cafr*'abc')+# unpackE' sequence'i0}{1}{!br1cad$# x?s' indices can be repeatedpabracad9'>'Oname$ Coordinates: {latitude},b"{long"4='37.24N'<;='-115.81W1 [%, :GcT = {'6': '/':}j 'A"!**= e D’ attribu} c = 3-5j&(U cox number {0} isgqed fromOrealpart {0."/} Ds`... 'Yimaginary AD}.')c  ()g5_"3.0 _-5.0.'mlass Point1 def __init__(self, x, y); ' D... self.x, y = x, y\n' !D' ;def __str__(;/):4"4Jreturn 'Point({;o.x}, "p"y})'.formatk=5?)\n3>>> str(o4, 2)).''r>'Accessing arguments’ items,'K0 coord = (3, 5,'X: {0[0]}; Y 51]}GKCBX: 3:5`Replac"%s" and "%r"# "repr() shows quotes: {!r};) doesn\'t: T{!s}"=\'test1\', ?2\'H+}:>1\'^/2"PAlign.the text2pspecifya width@V{:<30p'left at edD= ) :w>wOrighx h: ;x^xocenter s0*t # use '*' as a fill_'char"&'**O+f", "%-" f Osign&+f}; {:+fp3.14, -)&? itoalways+HR0000;S N  a spacefor positive number  "-- Ponly H"minus -- same as '{:f}; m'\n" " '3.140000; - /O'\n'F'Replacing "%x" and "%o pconvertthe value to Idifferent bases:p >>> # format also supports binary numbersC "int: {0:d}; hex x "oco Obin:r{0:b}".O(42)qm$42jQ2a; g5d 10with 0x, 0o, or 0boprefixM=###%&0x&0o 0b/10X4'UsrPcommaa thousands separatorWcd'{:,}'1234567890)g1,234,567,89aExpresa percentage'points = 19)total = 22(Correct answers: {:.2%!r/P# Ho86.36%#ype-specific4# imE datetime85d =*.3(2010, 7, 4, 12, 15, 58i%Y-%m-%d %H:%M:%SXdM p-07-04 12:15:58I0Nes2p argume4more complex exa 9for align, text in zip('<^>', ['left', '_er', 'right']):~1...'{0:{fill}{y6}16O , =p'" ?...&<,^ ^," '>>>>>>>>>>>right'\n" ' >>>\n' octets = [192, 168, 0, 1]7"T '{:02X}'.format(*Z)H'C0A80001 ` int(_)3232235521$ width = 5D for num in range(5,12): 61...:@base;'dXob':5: prQ'{0:{ }{G%}}n_num, ")=!, ;=), end=' 'U~~?...F5 /10,6 ?110b 71/11b 8110 100b 91!111b V@ A7 121 VA B131b, 'function': 'F p definis/'*&$A l` es a user-z&ed+{object i^'(seec!se The standard type hierarchy):7! 0def3 ::= [decorators] "def"1name "("[parameter_list] ")"wl ["->" expression] ":" suit6 F +y0 ="@" assignment_ NEWLINEd ed5def!N (",F"0)* #P"/" [ b_no_posonly]r> %| G. "starargs N ' paramet er_list_starargs ::= "*" [parameter] ("," ' E'def#@)* [$e["**" \]]]\n=J /| IGm H identifier [":" expression PNl?["=MfuncnameIM A Ntion defini is an executable statement. Its6 ^bindsh6thej0in current local space to a2 fnobjectg(a wrapper arounddcode for). Thi" q contains a referenmglobal!as9)be used whe0is called.QTdoes notedbody; this?get0jed only ? [4+cmay be d by one or more *decorator*QDs. D)s are evaluat{ ':dCed, @scop^&atE6E1-. n>Theresult must a, which is invok:ith fBarguPreturned +enbsoj ahinstead of>.. Multiple }applied4.ine0nesfashion. For example,wollowing *A @f1(arg)21def(): pasM7is roughly equival;.to* s ! !3 = @(f2() d 'except t*hat the original function is not temporarily bound to ' 'Blname\n"P.".Changed in versc3.9: F s may be decorated with any^validc"assignment_expresg". Previously,grammar was much morrestrictive; see **PEP 614** for detailspWhen ono *parameters* haveGform^* "="**1saiU“default qQ~ues.”lWFor a< URvaluecorrespondingdP*argu*hpbe omitfrom a call,1which cas$E’s > isjsubstituted. IfUhas aUE, all followingQs up until“"*"” must also aM —0Othisa syntactic @on t Qed by=**D2 ps are e @left6pright w /th^ddefiniAexec@** TRmeans \PRonce,HiCpined, aG"Msame~“pre-@comp!ecAused*!eaBll. is especialliNtanthto understoN a mutablobject, suchhQlist donary: ifSBpmodifie"e V 8O(e.g}rby appe2pan itemM a {)Xk .inseffect Xis gener waintendA>wayc"ar< isuse "None" aeexplicitly testf>forf it jbody o , c:\n' '\n' ' def whats_on_the_telly(penguin=None)::G3if *@ is -,0-O= []U%.append("property of the zoo")>dreturn'Function call semantics are described in mo@tail"se7 VnCalls.h9A fj always assigns values to parameters `0menf"= list, either from posi?pal arguM"s, i~keywordd9oWsdefaultB. Iform “"*idfier"”.ishpresent, it`initialized' tuple receiving any exces5gl,N!tooRemptyk.H ?is new orderel@mapp3K h>newkhsame type. P#b after.orP  Oe-only s and may -bepassed bykS 0bef/ UJ^QChangP vers{3.8: The "/"'q syntax$/us:to indicate|. See **PEP 570** for de,have an *annota|*:r ex7fafollow&he@ nam'Ana8 ,feven those h or "*-. eshA“r  z:->  'the\n'  'parameter list. These annotations can by valid Python ' G 'expression.\n@The yence ofadoes not change the semantics-P@funcOues are available as|O!diNary keyed bys’ names in 7"__6>__"fattribut` objec!If]"K" importqNfrome"__future__" is used,!@rvedstrings ad~runtimegwhich en_s postponed evalu:. Otherwise,y 81/eddel(`definiexecuted. I)i-se)Me0maya different order thabey appear& _sourc/Ocode It@alsoU sito creatonymous 6s ( E Oboun\Ato a), for immedid0useseKs lambda0, describedJ!se]! L:N0Not at b#merely a shorda simplified% cH;a8(a “"def"” statem @passNro p/org@ssig3 no+ just like b 2e@formI actually more powerful si j/itQllows0ionmultiple-Xs and**Programmer’,ce:** Ffirst-classPkA>sid!s a localQBtLPretur9or 9. Free variZ fHnestaccess the local variables of the ' 'function\ncontaining9def. See se2@ Namand bind =forbdetails.b_^also: **PEP 3107** - Fp Annotas7 The original specific2 & aJ1484Type Hint`Definia standard mea|0: tS Ohintc1526aSyntax"Va-@Ability to$ v@adeclarOs, inclu OclasM s a in%ced7"1563Postponed Evaluw0qSupport'@forwreferences within.= by preserving) @OC strWm at runtime 0ead_eagerOe, 'global': '""uktementI/'* & 2 Z_stmt ::= kidentifier ("," ,)*H g is a s which holds ',re`current code block. Itas that glistedPs are  -'bainterpre?#as%sewould be impossiblS`assign]aP 75outz, although freIQ may < toON bem#ed^W'FdNames 85n a{ must not usano;sam' d textually precev2sta?d[ed aslformalparameters, or6targets in "Ss#"except"_aclauseFd 'in a "for" target list, "class" definition, func V\n' '"import" statement, or variable annotaF.; **CPython implL9 detail:** The current%Joes same timen H@. InEticular,% contained in a<,ngb1or object sudbuilt-in "exec()"d0affXLhsblock *Aing*^call, and 7rsuch a "unnded by Ts -thNiR !. { ]"eval()""compileSsq, 'id-es': 'Reserved identifierr/'* 30CerPy (besides keywords) hav]specialdsV%sema+patterns nh@lead?andlPtrail underscore characters:3<"_*~Q No3ortfrom modul`ort *"9>jiIs"case" Q withi"match#"_5 o, pluss& cMn, Mc, Nd, PcosC  whose NFKCnormalizYDin " '"\])5id_#  'normalization is in "id_continue*">\n' 'The Unicode category Ps menbed above stand for:J * *Lu* - uppercase letters/DlD?lowD)tD_title'mDmodifier#oC?oth@$N E_ numbL Mnnonspacing mark McC@ocombinJ# NdJdecimal"Pconnector punctuO_ID_Star,explicit list of charactcPropList.txt to support backwards compatibility65* *C - likewise5`All id s are converted into the {m NFKC while parsing;nPrisonVxis based ona.@aA non-tive HTML fall valid?form34.1 can be found at0https://www.uo.org/Public/13.0.0/ucd/DerivedCoreN`ertiesPXKeyword=O8`followZ;uas reserved {O, orp#*kO* of|language, `cannotxlordinary?s. pThey musbe spelled exactly as written here FalseRawait e1 im>pas ' None  Qbreak q except !inraise\n' ' TrueRclass pfinally i returnJ0and0acontinY0for`lambda O tryGp1def.s from nonlocal whilRasser  de.@Aglob<B noI?ith1ync<D eli & o yieldISoft Keywords7="New in version 3.10.)#Some identifiers are only reserved under specific oexts. {PTheseDmknown as *skj*. Th"match", "case"lo"_" casyntactic0actzt3 related to thel_patte%ing statement, but this distinctPone agrser level,Cwhen tokenizing9As z,ir use with  is possiblrstill pFcompatibilityn!exg code thats$'aso names$bR NWes ofd hCertain | (besides _) hav/alfmeanings%seo"@d by5*  @lead/an9Ptrail!^score characters:O"_*" Not imporAby "pcmodule? *"/"_lDIn aFSiP""Bis a 'soft\n' ' keyword that denotes a wildcard.8 Separately, the interactiv preter makes"result of!j last evaluation availablh8Q vari"_". (It isgstored in6n"builtins" module, alongside -in funcos likem"print".)i Elsewhere, "_"a regular identifier. often usedto namek “special” items, but i@Cnot  to Python itself*_Note:1Thesin conj_ withHn8Aaliz p; referdocumentO forLhH "gettext2E0morBformZow@conv1on.also commonly!un s"__*__"sSystem-definedQs, inlly known as “dunderOy/s.JOThesL7T are q by^R0and]Uimple(including\ standard library). Current sp/ar`discusp" Smc methoJ1 seG eO. MolAwillFly b<iture versions of/. P*Any*W? of>1 @ any ]@oes Bofollowkexplicitlyi ed, psubjectbreakageout warningClass-privats. NamesBis category, wh0con>0a czid,pre-writ to" aW  'mangled form\n' 4' to help avoid name clashes between “private” attributes of Ubase andrqderivedg6ses. See section Identifiers (Names).\n', 'if': 'The "if" statement\-'*' Hb is us/` condial execu :A if_stmt ::=assignment_express":" suite?@("elB /)*D["else" p]- It selects exactly one2thes by evaluating %s 9'onbLQuntilVis foundwbe true (sBoolean operats1for}QdefinFand false);#bn thate '(4no other partN a@4 or !edV`'If al.Rs are,!of clause, ifCHent,{maginaryI literal0U %]described `followvlexicalKsF}TmagnumberWc(floatp| digit) ("j" | "J")JLAn i: yields a complex kwith a real&`of 0.0CK#re@ed ap@pair{G^pointEAhaveZsarestriU0s oeir range. To create ag7 vnonzero, add a 6.tok?it,ge.g., "(3+4j)". Somes* V3.14j 10.1 10P .001 A1e10)"e- t_15_93jPmport\ 6ioso" module ["as" identifier] ("," ' 'module ["a,J)*\n*5 | "from" relative_mOx"import~ x qoF,"(&u 3 [","] ")"Px/"*HW::= (W".")*2 CS"."* \l| "."+9 The basic ) statement (noV clause) is executed in twoPlsteps: 1. find a, loading anZpitializit if necessaryJ 2. define a name orshe localpace for the scope\whereb! 0Y1|occurs.1 AWhenC:contains multiple rs (separated by commas)-thAtwo  are carried out P!lyCeachm, just as_Lough4had been]kinto individualb 9details ofCQfirst,R2CO s rdescribgreater _,section o"kystem,&Mwhic%Talso isvarious typepackagesthat caneb0ed,@well1alll@hookvLbe used to customizKb! sq. Note sfailureZ!isA mayrs ""  1. checkC> h8n attribute P 2.Z@not,D@emptfc a subDBwithZu ?theagain forZ A 3U6tPnot fxA, "Ij`Error"oraisedqR 4.o wiC at valueUdstored} W,LPH present,b"ak 8 0Exa$foo  # foo imported and bound locally\n' 3' -8.bar.baz NV,,W Neras fbb e:as g?fbb@fromKc ?bazc_Cattr-cyAfoo."  e 0If the list of identifiers is replaced by a star ("\'*\'"), all9lpublicdnames defined inrmodule are 3pace fore P fu_stmt ::= "from" "___" "import"i[["as"identifier]g$ <(",OA/)*C| &"(a om [","] ")"Md{ - Atement must appear n4top_mIk. TheLonlyb0lin4canYaLare:D * docstring (if any),0 P* coms+ablank \, andM }* others.QCt6Prequi us:,is"annotations" (see **PEP 563**)All historicals enabled by are stillrecogniz<Python 3G0liscludes "absolute_ "division", "generatorsP_stopunicode_literals"Oprint_func15nested_scopes" "with_sta)" y apdundantEa2the<UalwayZd kept forfbackwardP_ility G is  and treated specially at=Lpileztime: Csemantics?cuconstructs:\oftenKAimpl.`differ. It may even b />casY'a *s syntax (such as actheb. They "usRgroupUs'enhanced]readabilitUOne ufoccur betweenc<after basefspecifier6like "0x"Z0Notpat leadLsP non-mal number PaV/edy@Thislisambigua_ with C-style octal}, whichnPythonpbefore ion 3.0<Some exampleseger literalxs:\n' 'A 7#214748364 A0o170b100110111Q3879228162514264337593543950336"30o3QxdeadbeefP-f 100_0 0b_1110_010[)Changed in version 3.6: Underscores are now allowed for Vgroupingbpurposesc literals.\n', 'lambda': 'L s?"'*  2 K_expr ::= "" [parameter_list] ":" ' es K 1s (sometimes called}1ms)0zused to(|'createc anonymous functions. Theu +s:\"ayields a` object. gsunnamed behaves like af cQ defined with| z0' 0" <&>()<greturn aSee seU# F^v1inii the syntax ofc >Q'Note that]"s 6Knnot_|containstatements or a9aDAistsCist displayIHN 0'A I i8possibly empty series,Penclo'@'squQ|bracket Cist_[" [starred | comprehenK] "] X "2new,Ybeing'specified'by either aQf . When a;ma-Q se tnoOis supplied, its el6m }evaluatfrom leftright and plac!!to Porder'OxOis construc+th)'`result*3fion.\n', 'naming': 'N  and binding\n' -'* " BY of names0=  *NF* refer to objects.  are introduced byxoperations.j  The following constructs[e,s:4 * formal parametersAfunc,1 * class defini4`7assignment express)targets thatpdentifiif occurrGfin an iB * "for" loop header6after "as" v "with" state, "except"d`use or*Jthe  3\L-`n leades  daZs before3mqsubtle. Python lacvks\n' 'declarations and allows name binding ope#to occur anywhereQwithin a code block. The local variables of&m can bPdetermined by scannthe entire textMpB for  . 0If f"global" statement%s ,N2 us: e specified innerefer toHQthoses6 f-thUtop-level4pace. Names are resolv0 [>< by,dsearch2oa, i.e.Eo_]modulecontai_,^rbuiltins,b $ "N" B is :ed cfirst. Ifdhnot found"rex-j ax imust precedeblistedo Q a0has s8scope as aUH x cKHJ_nearest enclos]lka freeo dNgL>rtreated B;1non =!ca$correspou&4to  previously bDi .@func &E "SyntaxError"@raist compile time iRgivenKdoesc–c is includes comprehensionsEgenerator expresPsincey 'Aimplsing a funh6. This meana  'F8n ap, unlikose listed in '  f'a\n' 2 '"global" statement, must refer to pre-existing bindings in anO`enclos*scope (the in which a newJ should be ~createde`cannot3 determined unambiguously).6Names listed "nonlocqcollide with'c9fSee also:d **PEP 3104** - Accessin Outer SsB@ Tpecification for (, 'numbers': 'Numeric literalh+'* ' There are three types of nl: integers, floa cm'pointc, and imaginarya.no complex ("X@ canformed by adTs a realh}b'40Not/ at\ @ do  include a sign; a phrase lik]'"-1"5is actually an express4@osed<uNoperator ‘"-"’R'~=thejiG "1"s- yBEmul L  .-`followtmethods1defAto ee pobjects  $'M^qorrespoVions that(`supporo byparticular kin i3ed (e.g., bitwis3' '?foroAnon-r 's)&sleft unR"]X.__add__(self, other)2 ?sub2?mul2/at5xtruedivker)\n'  'object.__floordiv__(self, other)\n' 1 7?mod2?div5:powg[, modulo]jlshift?5r5!/an ?xor1% These methods are called to implement the binary arithmeticjoperations ("+", "-*@/?%",i"1O()",j@"pow"1 "*^ <>&^|"). Forjinstance, tokevaluate"expression "x + y", where *x* is anl _ of amclass that haNP"__adg#)"T, "x.0y)"w.nrThe "__q5__(c should baquival'o_usingj"q`)" and{d)"; itu0notyQrelatl Btrueq)". No ats[$)"o/beQdefink acceptrPan opal third arguW!if81ter[1ver=obuilt-inpP funcw to5supportedU`If one7tho1Pdoes \<@with(nM6lie*'s,return "NotI?ed"rBOrsubOrmul3/at6  'object.__rfloordiv__(self, other)\n' '8?mod3?div6 :powi[, modulo]jlshift@6r6"/an?xor2% These methods are called to implement the binary arithmeticjoperations ("+", "-*@/?%",i"7O()",j@"pow"1 "*^ <>&^|") with reflecteds(swapped*1 Dnds.PBfuncRDonlyW!ifMOleftoL_ doesnot supporcorresponding [3] andto/ofradiffer ypes. [4] For instance,3evaluateqexpression "x -qy", where *y* is anl of a class that ha "__rsub__()"o@, "y 00x)"yif "x.__?y)"oreturnT*NotI[Oed*.Q Nobaat ter` will "trsN)" (theoPcoercrules would become too complicated)#:}IJRrightnd’s typeRa sub$o,v@t [Pa_provides a 'vS z  A for]c, this{b  '+ before the left operand’s non-reflected method. This ' > 'behavior\n- allows subclasses to overridir ancestors’jotions.m object.__iadd__(self, other)3?sub3?mul3/at6 truedivm_floor8 /mo>:pow[, modulo]{jlshift@6r6"/an?xor2 Theses are calledRimplement0aug /edNarithmeticm`assignFs ("+=", "-*@/%   "*5m0"<<<1">>&^\|=")._shoulttempt top!do'V in-place (modifying *,*) and returnNKoresultq(which cbe, but doet`t havev. If arospecif " i`defined,_ fall0ack?thednormal. For inst, if *x*%an? of!a +nwith an "#)"|, "x += y"nqequivalomO"x =jx:py)" . O:@wisei2.__V'Ry.__r)0x)"qconsider1as a`evalua7o y". Icertain\n'  ' situations, augmented assign  can result in ' B 'unexpec9errors\n(+ (see Why does a_tuple[i] += [‘item’] raise an excep|when thesAaddi@works?), but this behavior isfact part ofnthe datanomodel. object.__neg__(self)+ ?pos+/ab+oinvertY  Called to imple@3unary arithmetic opervh("-", "+",m"abs()" and "~")u% cox /in  +Ofloa- Mbuilt-in func3s "O()",QC"int-r" ()". Should return a valueappropriateoOtype%Oinde 6"o1or.\&6<OeverPython needto losslessly coA` numeran integr9o (suchaslicing,  A"binC"hex0"ocmd). Presencis method indicates thaZm is*Ke MustHd If "__.1"__$__)3"__Orot definedtcorresponding] %, /ank fall back to "__index__()".\n' 'object.__round__(self[, ndigits])8 Strunc8-_floor-Oceil,  Called to implement the built-in function "()" and <o"math"mL1s "a()", "X" Unlessi*wO* isoBpass" ll se methods should returns_valuep ofW + "at an "Integral" (typically aoo"int")O T0intbfalls back!__ __1/ifneither "__int0#no2dexis definedB, ' as': 'OV1s, ZsZMtype/'* #'*f* are Python’s abstrafor data. All [ in a '? uprogram is represen#bys or by relaNs betwee]. (Infa sense,(in conformanceVon Neumanmodel of a “storedTcomputer”, codeOalso.zDEver0 ha identity, a a}n2 *>* never changes o!itebW0cre|; you may think]of itf'asP addrin memory.j‘"is"’ operator Idetermine0ionap '  'supports\n' 6'(e.g., “does it have a length?”) and also defines the possible 'R^valueifor objects of that type. The " ()" function returns anbG>’fF (which i<- itself). Like identity,c*d*^unchangeable. [1]c *'* EsomeBcan QC. O0awhose 2M canQ1 are said to be *mut%*;^I,isX d@onceygrcreated alled *imq0. (?of - containes a refere R**CPytho[detail:** !`curren us -Pcountscheme with (opal) delayed :XcyclicallLlinked\n'  'garbage, which collects most obj as soon as they become\n' 'unreachable, but is not guaranteed toc z containingQ circular references. See documentation of"gc" module =forbcinformBnqrollingN`dcyclic.`OOthebEmples act diftly and CPython may change. Do< mdependon immediate finalizf@when  =(soeyou should always closples explicitly).; 0Not atD usei/’s tracor debugg+facilitiesFEkeepCalivnwn ll  1AlsMPcatchan excepwith a ‘"try"…"L"’oAstat "  9ESome]A“external” resources such vMopenh fior windowIunderstood th'see.ar>reeO5-"ediTsince d,-isrhappen, provide  m^way t<`releas8$e {`, usua1a "T()" methodf~ProgramWstrongly rBmendt^. ThSl% 1the. rconvenient Fto do this3o4 s;a0se  Ocallv*4ers*. ExasOtuples, lists  0dic1ari Thm@part[a{Qainer|value. ^I0cas1we talk abou_Mfontainer, we imply ' k'the\nvalues, not the identities of contained objects; however,anwhen wetalk aboudmutabilityd$a bqr, onlyv immediatelyQA areied. So, if an iml (like a tuple)]s a reference to a K 7_, its changesEthatI:3 is"-d.A Types affect almosPl asprWbehavior. Evenw Npimporta#of$yied in some sense: forlt, operations compute new  may actually return a ny existing@with` same B andei Q isMQallownE.g., after "a = 1; b ==1",1"a"1"b"!or`x 5B bone, depend +QementT, butc = []; d".="c"e\1"d"guaranteedawo difPt, unique,-lyP created empty lists. (Note9"a assigSe 7 dto both "cd".)\n', 'or-summary': 'Oor preced T.'*-`The foibtable 0izeeT yin Python, fromxwhighest! (i!biG) $ yxo(leastoV4. fsppbox havk. Unles-`Pyntaxexplicitly given1orsbinary. _ugroup leftRright (exceptb ' exponentiation, which\n'  'groups from right to left).5 Note that comparisons, membership tests, and id?ty ,ll havewthe same precedenceb6! aB-to-chainingwfeature asrdescribed in C@ sec}B"/+-2+| Operator%|>Dp9|=|1u "(expressions...)", "[]", "{key: @Bind`or parenthesized L?, value...}p8#}"Do| listdisplay, diEary ?set h tF D2 "x[index :0Sub9, slicing, call,H| "x(argument"x.attribute4a refer7 ]=await" "x AI 7 '**  O| ' 'Exponentiation [5](?|\nA/+-2+u| "+x", "-?~x"Positive, nega bitwise NOTE*@/% Multiplic, matrix|% mdivision, flooraT}remainder [6#D2 - FAAddiand subtrac<  <</>>`Shifts &B3AND,^=?XORe'  f'| "|" O| ' ''Bitwise OR ?|\nA/+-2+u| "in", "not is`is not <=O>", Comparisons, including membershipA| ">h!/==tests and identity ]2 v? "xBoolean NOT,?and0AND)/orf" – "else Conditional expression olambdaLI@& =:'Assignment expression \|\n' ?'+-2+u-[ Footnotes ]-)[1] While "abs(x%y) < y)" is true mathematically, for floats ituMmay not becRnumer` due to roundoff. Foruexample, andt assuming a platform on which a Python/antIEEE 754 double{Qprecilnumber, in order that "-1e-100 % 1e100"xhave the same sign as "S,7computed result}+vB)v 8is exactly equalo. Theqfunctionl ".fmod()" returns aawhose matchespR0 of'w first argument instead5 soX"1this case.t Wppproach`more apriate dependsrpapplica^t[2] If xpvery clgato an  integer multiple ofzy, it’srBossible b`"x//y"Nbe one larp/th@"(x-;as ~ing. In such$s,(qn_lattent  o !er 0divx,y)[0] * y + x % y+6be w oto "x"#!3] Unicode standard distinguisybetween *%points* (e.gpU+0041) *abstract cha$erE “LATIN '   'CAPITAL LETTER A”).\n' ! 'While most abstract cha ers in Unicode are only Orepresentedt using one Y point, there is a number ofut that canaddition be  a sequenceof more thanw . For examplew“LATINs C WITH CEDILL /asu a /leu *precomposed@ * u=2possU+00C7, orrw "o *baseuA43 (>x9r [ C), followed by a *combinu U+0327 (COMBINING S Th~mparison operators on strings  at8level ofq Gs. This maycounter-intuitivto humansPx mP""\\u}R" == 43P327""z"False",even though both{ HdGOsame}  %ToQ(?is,v in a way _), us""udata.normalize()""[4] Due to automatic garbage-collecK, free lists, andthe dynamic @natusf descrip, you may notice seemingly ' 'unusual behaviour\n+@!in certain uses of the "is" operator, like thosexinvolvingp comparisons between instance methods, or coOts. tPChecki documentation for more info.[5] The power( "**" binds less tightly than anarithmetic o bitwise unaryzon its rq,p_t is,q"2**-1" is "0.5"#6&"%+R@alsoMdi`string matting;yOsamexpprecede0papplies, 'pass': '" p" state T/'* " 0 P_stmt ::= _ % "S null`— wh executed, noth-happens.*:'Ita iseful as a placeholder]arequiredTsyntactically,`but no code needs to beHexample:<  def f(arg):J# a functhat doesZ(yet)I  class CT0 W@withW R,-  f , ! ~ Qs  "s  Pleft; itFYF  = _Jx is+ '(4 (await_expr | primary) [u]@ qThus, iunparenthesized sequ#ofb;and ;'th7's are evaluated from^e (this~"! 'KrainU ory|nds): "-1**2" results<"-1r n Eor has the same semantics as the built-in "pow()"\n' 0'function, when called with two arguments: it yields its left 'J+ araised topower ofDUrightc. The numericsfeafirst convertja common type, and}result isAthat .P For int operands,Khes{mv. kunlessaesecondnegative; in 0cas%ll(Ls ar Qfloat"a delivered. example, "10**2" returns "100", but 8**-_0.01"P Raising "0.0"$a  sa@"ZeroDivisionErrorn_Vbnumberk1fra/alm cox2O. (In earlier ver a "Value)X  Thc can be customized u5,pecial "__pow__()"&`methodA, '@': ']"p" state * $ " _stmt ::= ep[expres ["from" +]]I WIf no0 QEent,e1re-;lasPexcepT _R@was  vem]current scope. E1 F-in_L, a "Runtim Vd indicatingQ&pis an e 4pOtherwi6evaluate/; Q`object`t must eif a subclass orinstance ofFd"BaseE ".ei!a Bc Klwill b`obtainneeded by7!tiO^nG 9**8e7G’s * e*?oitself A traceback object is normally created automaticwhen an ' 'exception\npis raisEnd attached to it as the "__traceback__"&zribute,d^which`writable. You can and set your own s eione step usingFwithF()" imethod ( \{returnsGsameDinstance, jG its@s^argument),alike so: " $ E("foo occurred").BKobj)N Tfrom" clause is u7forchaining: if given,r Tksecondb *expression* must be anothealass or c@. Ifc Od U'anA,Awillq ;theb9c" O4is *).+IfaXc ^   ti `Rd`result7%ceU5 e  _M d ;notbhandled, both:sprinted9|>>> try)a ...%Kl(1 / 0+&~?excT7 RuntimeError("Sobad happen } }T (most recent o last) File "", line 2, in kZeroDivi3: d by zero5 0 `HabovEw8Pdirecwop follow' >> try)a ...print(1 / 0)@&CO RuntimeError("Something bad happened"cxTraceback (most recent call last) File "", line 2, in kZeroDivision3: d by zero5 ` Dur" !ofVabove, another occurredq 84  /:  ECPchain!Pcan bplicitly suppresby specify+ Ak"None"`!innU"from $   >...@AddiGal informa' ob#s Pfound0sec& PsR)Peabout @ions*inp_0The4 statement{ `Change@ verGb 3.3: xnow permitt0"Y"":XQ/Y"w 0NewD s4"__L5; toz @autoc display T , 'return': '"H a? '* & 2 Z_stmt ::= "Q" [exE ion_list]\n' f'\n' -'"return" may only occur syntactically nested in a function I`defini,dnot with?Kfclass 5.5 If an expresslist is aent, i evaluated, else "None" isQsubstituted}&leaves the current+ .<(orR) as  eUWhen passes control out of a "try" statem+ a@"fin"clause, that & @execJ before reH /;ingg=" 0. AlsoA;s doesn’t define a "__boolOwhos!"mts zero is considermbe false in a BooleanOext.m **CPythonpdetail:** In $,b requi at most "sys.maxsize". ImQq ar?thaL \ some features (such as _) maynOraisc "OverflowErrorpTo prev==" P0<nreturn value may also` "NotImplemented", which iskptreatedpsame as if)B "___hint__" method didn’t exist atv0all/istSis purely<optimization andnever requiredq?forkcorrectness.' New in vers?3.4F_Note:c Slicingdone exclusiv/Awith`follow'_three"o_s. Apcall like#*a[1:2] = b' btranslo*slice(1, 2, None)$|so forth. Missa_ items are always filled$"":object.__gety__(self, key)Q CaDto iH eiu@of "`[key]". ForQ*sequence*natypes,Paccepkeys should0saF 0otetrqspecialUrpretnegativ,indexes (class wishes to emu6 a  ) up$/thu ). If *key*^ ofCinappropriat,"TypeError"~be raised;"h`outsidsksset of Rt2forV (after any Lo 0 ' values), "IndexError" should be raised. For *mapping* ' 'types, if\n! *key* is missing (not in the container3KeyMn" Note:  "fBloops expect that and@willbO form illegal ies to allow proper detection ofc?end!n sequence.&Q*When subscript4a *class*,special omethodQ "__B_getitem__()" maycalled insteadN)"_?*+MSee u versus I_ moredetailsmobject.__sself, key,)<B C,to implement assign @to "g[key]". Sampnote asq ud This1onl edPLs >s support changZjkeys, ors`if newus0canQaddedMDfor " el#s +`replacO TheqsPexcepAO#imjs 7  '3delt5@dele  .5n'  -' the objects support removal of keys, or for sequences ' E 'if elements\n# can beeqed from^. The same exceptionsshould beq@raisi or improper *key* values as "__getitem__()" method.th.__missing__(self,f)5 Called by "dict". to"a[key]"Issubclasses when is not inAoionary 'Citer!CThisc'@an *^Pator*requiredacontainer. vreturn a new wjP that#tIe over allw?sO Fortmappings, itq x-% qI.__reversed((if present)"_`built-o2imp83 Rion. It /$ps _orderQ Ift"Wprovided,-`will fback to uJbA protocolq("__lentKand QS). O-2a r9@only=A)" i|y$x5 anl  ' implementation that is more efficiente one ' 'provided by\n# "reversed()".(%The membership test operators ("in" and "not in") arnormalled as an itj%rough a container. How,*$objects can supply the following special method witj s, which also does Gqrequire/ bT"?bleY3.__&s__(self,u/m) Called to;. Shouldreturn truesif *item*@@in **, false otherwise. For mapps, thistsconsiderqkeys of f ravvalues orr@key-o pairs t don’t define "  )" v first triesYr@ viap3__(lsequenc 0protocolk0get?n se^/is}1secilanguage refer, 'shifting': 'S 9>ion`.'* y'l` have lower priorita arithmeticQ:1 _expr ::= a |("<<" | ">>""L0ThepPaccephategers&0rguLs. Theyw r'eaBkleft or right b8@e nubits given d,th 'second argument.\n' '$This operation can be customized using the special U"__lshift__()" andgG"__r$methodsA right ? by *n* bits is defined as floor divis.bypow(2,n)"y_A leffmultiplic0Owithh , 'slicings': 'S %*#A T& selects a range of items in a sequence object (e.g.,ab string, tuple or list). @ may-"us`expres}s/ '.asdPtargen assign="del" statePs. Tyntax for a:g% @!::= primary "[" e_O "]"@# @ e_|D (",D)* [","]H' HHP | pr_\?![lower_bound] ":" [upp[ [Ode] T r0~0rPThereambiguityformal s9'r: anyth-atGlooks likeh7an Valso 4sAlice.@, son dsubscriptfinterpret_aing. Rather than fur 3comh0, tM"is@as"by^)"in*@caseQa` takesi or!oviJ9$ ( if ycontains noT/) >|emantics1areTollowL-isoindexe$(kame "__getY5lnF) ' 'with a\n' .'key that is constructed from the slice list, as follows. If Q0hAa tains at least one comma,Mis a tupln0Ling g>theeconversion o items; otherwisem. e?lonfT5$key. Tha>f e.anaexpres"is:kcproperr eUgobject (see sect?standard type hierarchy) whose"start",g"stop" and "ste ttributes aredvaluessiOgive4as lower bound, up {stride, resp]vely,]substitutingNone" for miss.\n', '`ialattrs': 'Special A Z-'*(implementa0addMCfew read-only  .to severalo6bs, wheyrelevant. Some!sennot reportedpbe "dir()" built-in fun} M.__dict__%P A 7ionary orXP mapp\` used E|tore anj,O’sm(writable) ince.__classZ:which a \ belongsC.__base#'0of CDa`defini@.__name0"9,, method, descriptor,Hgenerator! '\n<'  'definition.__qualname__\n- The *>`ified D* of the class, funcg, method, bdescriptor, orpgenerator instance., New in version 3.3Bo.__mro- is attribute ` tuple2Yes that are considered1Owhenlooking for bas`es durp resolu _mro()/#is can be overridden by aa  to customize?thej a order5its?`s. ItOcalll"atn0tiaL`, and eQresul]0stoCin "<"s Q__subOes__~BEach keeps a list~weak referencoimmediat|."hreturnxall thoszstill alivemei . Example:Q<>>> int."4![< 'bool'>]\n"v-[ Footnotes ]-%q[1] Addal inform0 onse specialphods may0fouoS Python RE Manual (Basic)P[2] A60equ,t"[1, 2]"5e8o "[1.0,>R2.0]"similarly<s 3](y must have since`parser q’t teQe typ  operands.\n'  U'\n'  ''[4] Cased characters are those with general category Iproperty beingmvone of “Lu” (Letter, uppercase),ls5low2!or5Ot”|lQtitlel..*[5] To format only a tuple you should therefore provide a2singletonm-\woelement isg|Sto be0ted, 'specialnames': 'S method {**A class can impcertain (Pation!atninvoked b]nsyntax (such aithmetickor subscripting andlicing) byoPdefinBHs$V`. ThisPython’smapproach tom*-or overloading*, allowiaes to eir ownrbehavioro retSlanguageIors. For instance, ifsoad "__getitem__()",0"x"IJt?ttv,othen "x[i]Sroughly equivalWto "type(x)./x,M0i)"mWExcept w  ioned, attemptexecute ag@rais'ek0ionnQn no Vdpriatea#isd (typicall "AttributeError" or "Typ)2Setn T4ialjNone" indiZ?the0cor onm, is not available0exa+O setq"__iterp,P{;zP, so n"_()" o/it)om3ll  (out falling back |to\n' '"__getitem__()"). [2]+,When implementing a class that emulates any built-in type, _it isjimportantZ3the^ion only be`ed to %gbdegreeI/itpmakes sense forLobject bemodelled. For exaOsomeg%sequences may work well with retrieval of individual;e_s, bucextracQsliceu@not t. (OnezOthisti"NodeList" interface he W3C’s Docu8" OYMS/.)*Basic customization?=).__new__(cls[, ...]P CaKcreate a new instanceW*cls*. ")" is a static method (special-cased so you need declare ituas such" ftNof which anPwas rOstedm/it! first argV. The remain s those pas&AE constructPpress(0all )?turq valu`shouldc29(usually aoA1of t/).  Typical/s 2/byjPinvokBQsuper3c._usingM"A/()"approprim!0and9gdmodifybnewly-!das necessarOfore reB ' it.\n'  '- If "__new__()" is invoked during object construction and fit returnsp an instance of *cls*, thenE new O’sgr"__initomethodpuwill be@likeAself[, ...])", wheret*** ?then&the remainLarguments areosame a?werjpassed toG /or,tdoes no  ?new(  ptended  ly:allow subclNsimmutablqtypes (]int, str, or tuple)mcustomizl@cread_. It@ s also commonly overridde_ lT meta/inorder tojKJ 2.Lv2 Called afthNhas beenoed (by_), bugbefore itrtcr. The OthosA ksor expressionf a bas=/anGt derived FO, ifoany, mustlicitly A\to ensure properQializ S part/Z1; fToample:"super()R[args-aBecaus|nH work together cting\n'  #' objects ("__new__()" to create it, and "__init)' J 'customize\n it), no non-"None" value may be returned byr/; Qdoing soowill cause a "TypeErrornaised at runtime.J9.__del__(self)* Called when the instance is aboutbe destroyed. This4l cma finalizer or (improperly) ajuctor. If akbase class0hast)" method,rderivedD@’sH/)"s>p if any, must explicitly ! iIrensure deletionn ofmb part /GP Itpossible (though not recommended!) for"kto postpon[!uc  f_a newyreferencTto it!is#edz *resurre*wimplementa@-dep ntFItherJmosecondlXEn a r/th"cnt *CPython* 3 ons?onceTguaranteed that1gTs arez?for5s\ stAexisterpreter exits1_Note: "del x" doesn’t diwZ5 "xo)" —l_formea decr%e #a count0"x"a2oneak0lat(ik M1"x"Vyence count reaches zero.\n' ', **CPython implementation detail:** It is possible for a ereferencencycle to prevent the 7 count of an object frommgoing tol In this case,pwill be laterected andodeletedn!by\*]ic garbage collector*. A common causeF(s@when-Qexcepqhas beedght in a localvariable7 The frame’sJsn, whichosIits own tracebackP<-lsm?ghtp eo @See also: Docu@'"gc" modue[Warning:!!Dueprecarious circumstances under"__del__()"jmethods are invoked, )at occur durOheirPexecuph@gnorh2a w&@printo "sys.stderr"ninsteadGIn particular'* D@ cano% rbitrary code_being" :`includh9Uany ae0thrO Ifo PneedsBtake_Ck or uother blockresource, imay deadM aT4=  aly_On byi that gets LCrrupRe=`Zd#y0pre:shutdown. As a\n<' '&consequence, the global variables it needs to access P(including\n p$other modules) may already have been deleted or setoto "None".o Python guarantees thats whose namygins withqa singleo underscore are@from]i@ bef%/sn c; if no QPreferEsuchlPexistip help in assuringPPimporm_stillL@vail^ t4 time when "__del__()" method is called eobject.__repr__(self)+A Cw2 byJbuilt-in function;qcompute*“official”s!stvkaesenta`cof an  If at all possible,/th should look like a valid TqexpressTc//bejused torecreatesvalue (given%Cappropriatenvironment).*D7not/#a j/ofOform "<...some useful descripc...>" abe returned. Th@"m`must b class define" o)" buto+P"__st9 )";9en ?pis alsod/anP“inJ$instances #atiorequir,p This&@typinyfor debugging, so/*/an0/th Q$>-rich and unambiguous '\n'   'object.__str__(self)\n' 'O ' Called by "str(R)" and the built-in functions `"format(:nQ"prin&to computegQ“inDl” or nicely 1Oablewostringorepresentar of an . The return value must be al!W is method differs from "P __ __Zin thatthere is nomSexpec I":$)" a id Pythonk exVsion: ammore convenientconcise 0canv_used.O?e default implemRdefin ?typLr"m_calls_bytes.F N a - k This should+"k$s"SEX!__t#, Ospec' ,/by0ten,@ e0TCted uliteralsfwo.;/()u,`produc2“:0ted/x X/of/an*b_`* argu\baDcontainstdescrip&qating os desired.jinterpreff upb `r ")", however most classes will eidelegate - ' formatting to one of the built-in types, or use a ' < 'similar\n foption syntax.2 See F SpecificaOMini-Language a descriolstandardN##The return value must bM0str{oobjectChanged in versWP3.4: p"____ method"h"oitselfraises a "TypeError" if passed any non-empty 237: .(x, \'\')" is?nowequivalent"str(x)" rather than ">(,c.__lt__(p0, ov)0e0/eq0n`gg` }!reso-called “rich comparison” s.7Scorrespondence between operator symbols andQ_ nameo_is askfollows: "xp1.__G.;"x>g?y)"-[ A 4maySsingleton"NotImplemented"if it does not i4uefor a given pairuoK@argus. By conven, "False"t@"Tru #re/edi successful comparison. However, these methods can return ' 'any value,\n  so ifV comparison operator is used in a Booleajcontext (e.g.n#inkPnditijf an "if" statement), Python will call"bool()"on to determine`resulttrue orhofalse.f By default, "object" impl s "__eq__()" by using "is",?ingpT"NotI_0ed"the case of a @: "T@if xyp[else tP. For!ne,? itdelegates tom- anQvertsK`unlesse/ish  There are no otheried relaships amongCOgsz(j; for exatruth oflP"(x.1T.vdoes no]\Qwishe]QsuppresL &ort, it should includej#__ = None" p`defini2. Aq which es its ownu=khraises a "TypeError" w be0<m by an)_ call_Note: ByyBaultB"vs1str_bytesobjects areo“salted” with.unpredictBbrandom<. AlthoughuOtheyn0remj!cotq ins individual Python process,hpbetween repeateM1vocRw .Tmi intended to@videt@ aga/ a denial-of-service caused by carefully-chosen inpun1oitworst cas pperform_ a ` inser, O(n^2) co oxity. /Seg http://www.ocert.org/advisories/-2011-003.html '  'for\n' '$details.Changing hash values affects the iteration Lorder of sets.p`Pythonf never made guarantetbout this Ur(and itktypically varies between 32-bit A!64 builds).SeeOalsoj"PYTHONHASHSEED"B}ed in verse`3.3: Hrandomiz}is enabled bydefaultobject.__bool__(self)` Calto implement trutNP testwQt?t-iPpno"()"; should return "False" or "True". WhenSJmethod is noPdefined, "__len__()"4bPif it)tq? isconsideredF!e `qs resulhnonzero. If a class?inejyneithern?)", all its instancel?areU@CustWttribute acces=dThe follow|Bs can be S to ceD @meanD/ofja (use of, assignh o,Adele/of "x.name") G`.__getI , uO$wU Y f with anDT "AHError" (V@raisP@beca**  nod1/or (ie0tre0r ""; or "__get__()" of ' 'a *name*\n* property raises "AttributeError"). This method shouldloeitherjreturn the (computed) ao value or? ane oexception.# Note that ifis found throughonormalmechanism,n`"__getc__()" is not called. (} isPintenoasymmetrynbetween v0ands".)/isdone both foefficiency reasond because o1@wise} wzOhaveno way to accessbes(instance.p/atmPleast N variables, you can fake total contro+ bylinserting any+2s iN~FA dic(/ry?(buO0eads@themm!anp object Se+hJQbelow?a_tuall2getH%`Fover .`self, R)A C uncondito implemente{q class. I also definbKlatter will3 be@ unlNG/)"A s it explicitly/X .Q   In order0voi{ofinite&recursion in\n'  .' this method, its implementation should always call the ' I 'base class\n # iQ withG`same n to access any attributes itmneeds, form0exa, "object.__get[__(self,?)".H Note:%To may still be bypassed when looking upsspecialOoA ashresult oficit invocvia languagsyntax l built-in func;s. See S/upmFor certain sensitive&;es, raiseE9PauditY_event 12__"@argusUp" and "@s , value)t Call@(anPssign0 isempted. i/ednpinsteadSAnormchanism (i.e. store? in?thei qance diWpary). *t*~,d*3o&0 toa9 ed/itfIf "__)" wantsNZ n K$,s=+9o L? ,\"60del MLikenbut for attribute deletion instead ' _'of\n assignment. This should only be imple ed if "deldbj.name" isn meaningful for the object.3 For certain sensitive attribute des, raises anauditing eventp"P__delg__" with argu s $q" and " `ir__(self) Called when "dir()" c(ono A sequencemust belreturned.jconvertsfeOto aj@list5k soVi#NCustomizXmodul3_acces-rSpecial 's "__getU@0__dP" canalso use/togc"e [ to mks. The,Afuncia&^TlevelI|ept one, which i-no of an.0ozcomputed value or$"A3oError"I_is not foun*$ aX through_ormallookup, i.e.T#`__()",^n`search"} ctabeforeB3CD0@, itE<?PresulEB/ed5x%no s,/ aixof stringat represenDsfible o 'module. If\n' 0'present, this function overrides the standard "dir()" search 'QOon akFor a more fine grained customizaf` behavior(settingoattributes, properti etc.), one can setq"__class__"mOn!of object to a subW of "types.MpType". example:n import sys#Qfrom .52 rVerboseF()def __repr__(self0"0return f't {9.__name__}'\n"T0set , , valueprint(f'S {?o}...')ysuper().__?~ .=$s[%].3 = <H?NotDefining T "__gjP" and! OonlyP affxlookups made us~T access syntax –odirectnF^globals (whether by code withinj?O, orvia a reference^9T’s |!diary) is"un,?ed.pChanged in vers\@3.5: <@nois nowwritable:New7 Wg"__dirvsSee also< **PEP 562** -  D ' Describes the "__getattr__" and!difunctions on ' = 'modules.\nImplementing _ptorsD-.The follows`method ly apply when an instance of2Oclaspcontainepi (a so-called *d!* K)oappears ic*ownerF (r] must beAaeither3O’sum!di`ary orUo0 afor on?/itdparents). Inp0exa's below, “ribute” refers toG whose name i`4keyproperty;2’;_ct__"qobject.__(self,w!, eo=None)B C`kto get]" (Ilpaccess) .of8$atePh* .  op4al @arguG" ij, while**QL thaS/waed through,p@or ""~~z J This should retur computedWPvalueraise anQ"AttrError" exce**PEP 252** specifi atget__()"Ctable with_r twogs. Python@own built-in xs supporto/th}$ ca; however, itblikelyOsome`'third-party tools\n' 0' have descriptors that require both arguments. Python’s 'Q?ownj "__getattribute__()" imple]ation always passes inpwhether they ared or not.:object.__set__(self, instance, value); Called to set  na$ *kO* ofzthe owneroPclassnRa new1, **  Note, adding " )"\t"__dele`changeYekind ofw“data”. See Invok3D/fo)0mor_tails% (!'Q$ of?f< $7Thea"__objFP__" iterpreted by "inspect"module a:0ifyk where this  was defined (sett15 appropriately can assistruntime introof dynamicls). For callables, it may indicatGat a given type (or a sub) exe&?d a_first@posi%alD (for exa2, CPbiVunbound methodL%&rea ed/C)fR*-*In general, $an with '  '“binding\n'  2'behavior”, one whose attribute access has been overridden by 'Smethodspin the descriptor protocol: "__get__()", s ?andP"__delete6. If any of t0 arufined for anobject, itois said to be a.1Tdfault  x isl`get, s/ormp@from’s dictionary. For instance,kQ"a.x"aplookup chain starting with "a.__o__[\'x\']",nJ"type(a)5and continu^pthroughL_ baseclasses ofo p" exclu5S meta8However, i e ed-up value is` defin/of?theKS Python maye "dey  qTinvokIz:ead. Wher&is occurs irprecedenceKdepends on which}t wvc/ed0howyCocalledQpoint; cak g_. Howrgumentsgmbled *O"a":ADirect Call!1 pimplestQ least common ;when user coddm/lyj29kesi:4"x.3?a)"I/ B R2an :&ransformed@intoe</: #,  '\n<' 'Class Binding\n#r If b#p to a c6, "A.x" is transformed into the L_call:g"A.__dict__[\'x\'].__get__(None, A)".>_Super!"aan instance of "s@ ",n.?(B, obj).m()" searches "obj.__Q__.__mro__" forq/asJO "A"nimmediately following "B" and]Pvokes descriptor@with(om@obj,6Fors precede invocation dependson whichmethods are defined. A#?canB/O anyobcombin})", "__s)"__delete__()". q_If itldoes not`hmthen access2attributwill returnoCobject itself unles reMa value iskA?’Mqionary. s_poand/or B, itGdata0; iqssneitherDoka non-]. Normally, ssrObothh"0,/le_s hav%OjustAodJ. DC!s +(I),d always override a?!reBiLOin an contrast,MK/beaden by,ances.\n'  Z'\n' $ 'Python methods (including those decorated with C"@staticD_" andls"@class() are implemenb as non-data descriptors. wPAccor?ly,pinstances can redefine override. This allowspindividualn to acquire behaviors that differ from otherjoof thepQsame Q.! The "property()" function is!a ~ 6not&th%_ of al__slots__-*U*B us to explicitlyHlQomembergO(likAies)@deny Q creaof "__dict__N*__weakref__*(unlessXd in or availablearent.)ospace saved50 usbe significant.Attribut]lookup speed0 T ly roas welluobject.) Q varil ased a string, iter#, or sequenc  Msunames used by(reserves 1for0dec1dsprevent<, autom.  OeachNNotes onM~~~~~~~~~~~~~~~\\n' ')* When inheriting from a class without *__slots__*, the b"__dict__" andp Kweakref__* attribute ofYinstance|ll always braccessible.o3* W'a variable, ocannotssigned newk$ V s Ilisted inW definition. _Attempts tola to an unm name raisesb$"AError". Ifkdynamic s@ment7newis desired5On ad4"\'?0\'"gqsequenctstrings<Paeclarah$47*___for each?,fZe/ngp)t1 do>support "` refers0/it Q ixis needD/ d&Fare impleQed at} level by@creadescriptors o. As a result,W sn@used#0set8ault valuee by; otherwiseo wouldroverwritewKS`The acaK pot limi/to$0wheZtP;ed.parents @vailoin childzes. However, child subclasses will get a ' '"__dict__"\n  and *__weakref__* unless they also define&Pslots$L(which shouldoonly contain names of any *additional* i/).Fq* If a 1s aJd in a base,,9the instancep variablen@d by6\~is inaccessi/=except bynretrieving its descriptor directly from/).OThisiAnderP meanr!ofXprogram unad. Infuture, akcheck may be added to prevent thisNonemptydoes not work foreE_rived#M4“!-length” built-in types such as "int", "bytes"l"tuple"Any non-strP*iter*VRssignY1*__Y?__*g["Kry" is usWacs,CO key"beca3. The valu?m_can b provide per-attribute doc_"att/beprecogni"inspect.getdoc()"displaye`output!"help()21"__$B__" mm!s uif both&Ohave?samWp'pMultiplAherit with mpted par/es0, bi4oneTis allowj0rea1s (Ather.qs must b' layouts) - '  'violations\n'  ' raise "TypeError".*#* If an *iterator* is used for *__slots__* then a *descrip@ks creatZpeach ofV |’s values. However,"uqattribute will beUemptyt.hCustomizing class?ion0=0@When!# auinherits from another,"__init_sub__()" ijcalled on thatX. This way, it:possible to writezoes whichachangebehavior/"|is closely rel_-"tomAdecos, but where1  only affectispecific>othey’re applied to, P" sol'sUtofuturel1?&th0finomethod 8 object.OOcls)" QXvwRcontaxq *cls^Dnew :.defined as a normalinstanc2 #is implicitly conver#%toK Keyword argument are givena a Y0pas" toaparentO. For compatibility]Qwith odel, one should take outnOedednkL@and `s overUQ?bas, as\n'  ' in:\n'  ' class PhilosopherD.def __init_sub@ __(cls, /, default_name, **kwargs)jnsuper().rH CHcls.) =CO 8AustralianB( ="Bruce"Opassd The implementation "objectY"does nothing,p"but raises an error if it is called with any argu/s.P Note=4 Ametau hint ""onsumed by the rest  of ltype machinery, anda`never _ed to\""i !s.uactual (rather thanyexplicitn5) can be accessed as "/)"ew in vers?3.6BcWhen aerreated,.__new__()" scansvariablehBmakePbacksSthoseb "__sexOhookHself, owner, \) Automatiy!atAtime cowningM*n*,i!B cp has beRssign**?thahA:x = C() # Ys: x.A"'x')\n"yIAu"a!1afte%is '  'created,\n'  !' "__set_name__()" will not be called automatioy. If MOneedj7canedirectly:class A:$ passG9c = C()# rA.x = c0# The hook isUC/edM":)c.A, 'x') # Manually invoke t]?\n"ePSee C1ingD@ object for more details.H New in version 3.6BXAMetae-BBy default, ` are constructed us("type()".@ body iPexecuTin a new xspace and4_boundo loL@y to7result of V, bases,{/)"]process ustomized bywB?the$"m" keyword argumentKqpdefinits_line,_or byjpinheritfrom an exisb0thatcluded such%O. Inn`followqexample, both "MyC"a"MySub"qinstanc'""  ;()@Ka(=snGQ(jjthepmay notm 'Uthird-partyn UK as mypy. Usingo2anygn0s odnqis discouragedvOp versusjd&|0Usu subscrip%an object usquare bracketRPwill :pI+"_n#ceKned on the object’s ' 'class.\nHowever, if the oK being subscribed is itself a P,kCnmethod "__% _getitem__()" may be callqonsteadB should return a GenericAlias/if_it isproperly define=Presented withc*expression* "obj[x]",oPythonnterpreterjfollows sofAlikeWprocess to decidel_whethh*"_/or: from inspect impor94 (obj, x)>B"""RGresult o$" `O`"""~e_of_obj = type)5K2# ITT's ,G .=<D"if hasattr(H7, 'J'"EE''W # Else'$is@ and/?ineL PMobj.:/(xqelif isy)[-"'ildraise an exception7 Oelse UTypeError(S 1Qf"\'{O.__name__}\' _s notoptableh2In R, allQes arpmselvestances of other '  'classes. The\n'  "a of a - is known as that’s *meta&*, and QOmostkes have the "type"aoEeir e.!gdoes nokdefine "__getitem__()", meaningexpressions suchk"list[int]","dict[str, float]"b"tuplePbytesll result inN!__e 0 becalled:9 >>> # C hasq~fas itsvp, like /esm(p)Q" \n"NcP) == 1\hOstr)>' Tru.'#  s._int)"k(_&"H returns a GenericAlias"oobjectG (s.{However, ia customsM subscrib^6may*differenbehaviour. An examplehthis can be found in_enum"lomodulePfrom Y import Enum2 PMenu(,)v` ...C """A breakfast menu""7SPAM = 'spam'.PBACON/_bacon0Q?... #Ii"{.HOMeta)  { >>> # so __class_getitem__ is not called,\n'  ' >>> # and the result<a GenericAlias object:K"KMenu['SPAM']\n"t)<&.%: 'spam'>,Ptype(4Z)/pp"appendlS"counZPindex+S "ext7s "inser#}PremovMp"revers" #soXCliked` "list".Finally,3U type8implement addi (meaningPconcatena,)multiplic@@ repion) byi?thepf"__add`riR__mul=gD"__r#E"__idescribed below;y{q3noto other numerical operator ObothDn."__contains>)_allowo`effici2/usE"in";;,J"B`searchUr5qt`M, it_Brougg/. p&j1furspces '  'implement the\n'  '"__iter__()" method to allow effici@$ation through Mf container; for mappings, rshould lej#object’s keyspsequences, it g?thevalues.?.__len__(self)* Calle  built-in func"len()". SToreturnnlength of- , an integer ">=" 0. Also9_ thatodoesn’t define a Ibooland whos"_ps zero is considerabe false in a BooleanM?ext  **CPython Ldetail:** In $,a/is6qui at most "sys.maxsize". Ic/is0lar?tha6 X some features (such as ) may rais "OverflowErrorpTo prev;a er deteco end of '  'the\n'  'sequence.$ Note:nWhen subscripting a *class*, the special  methodP1"__*_getitem__()" may be called instead of )"_=MSee q versus G for moreqdetailsiobject.__sself, key, value):B Cto implement assign @to "c[key]". Same not asm e This should onl edN>mappings ifnI2s support changes toh3Cs, or i!1new$o0canoQaddedIX" e`#s +replaced.sexceptionCsbe rais9improper *key*H J #3del\1@delepremoval2key ^Nr a61rom olb b9missing__(-by "dict". UG1sub@es w@`key is1 in4dictionary.\n'  \'\n'  'object.__iter__(self)+ This method is called when an *ZPator*required for agcontainer.rshould return a new sb that canpEe over all the =As in/ Fmappings, itm tp{keys ofmG.__reversed$C(if present) by"[()" built- oimplemen Nion. It #"# d/esoorder.mB I"')"Rnot provided,r}m`will fback to using^sequenceu_tocol("__len__()"pand "__getitem,Q). Owszsupport{1pron#@only1~A)" ipy%n @atio  atmore efficiena_e oneB? byZ The membership test opers ("in" ^in") arnormallPed asrough a )0How,(s7l`followtspecial=0wit~o, which also does ;/ bH?bleS3.__sN)em '\n<' ,' Called to implement membership test operators. Should Nreturn true\n!) if *item* is in *self*, false otherwise. For mappingnobjects, thispsconsider the keys of b ra{Q thanvalues orn^- pairs., t don’t define "__contains__()"e  rfirst tries itpion vialhosequenc^protocolg0get3j1seeP sectilanguage referX`Emulatnumeric type}=ZThe followtmethods can bee$e 0UM\orrespondr#toBionsare not supporte  byEparticular kind nuped (e.g., bitfnon-integral#) be left un]dQ.__add__(,)1 ?sub1?mul1/at4?divi_floor6/mo2?div4:pow[, modulo] jlshift>4 /4/an?xor_or__(self, other)\n' '% These methods are called to implement the binary ^arithmetichoperations ("+", "-*@/?%",g"divmod()",h@"pow!1 "*\ <>&^|"). For instancer/toievaluateexpression "x + y", where *x* is anjOof akclass that haL"__add__()"T, "x.0y)"u.lrThe "__ja should baquivalo_usingh"__floordivf0andy"moD; its0notwQrelatj DtrueiQ. No atq2powdefinedto acceptpPan opal third arguG!if.1terK1ver3obuilt-innP funcu to/supportedSqIf one oPdoes Z.@with'lK6lie$'s,return "NotI?ed"object.__r2oself, , 2osub__(2?mul2/at5q72>52[, modulo]olshiftzr5! an?xor1\n'  (' These methods are called to implement the binary ' ; 'arithmetic\n  operations ("+", "-*@/?%",g"divmod()",h@"pow!1 "*\ <>&^|") with reflectedq(swapped)oDnds.JBfuncLDonlyQ!ifGOleftmK_ doespnot supporcorrespondinge [3] andrm/ofpadifferypes. [4] For instance,)evaluateoexpression "x -oy", where *y* is anj of a class that ha "__rsub__()"mU, "y./0x)"wif "x.__K?y)"oreturnT*NotIKOed*.Q NoZaat ter` will "trg1pow_ (themPcoercrules would become too complicated)!:zfI8Rrightnd’s typeRa subo,d ?rY>ao]provides a n8r  A forKNc, this/beRbefor'dRFnon-0. T{behaviorneallows es/qoverrid0ir Gstors’sr object.__iadd__(self, other22?muld?mat5truedivkfloordiv__(self, other)\n' 'object.__imod__(self, 2:pow2[, modulo]njlshift?5r5!/an?xor1! These methods are called to implement the aug ?ed arithmetick`assignDs ("+=", "-*@/% o "*4k0"<<:1">>&^\|=")._shoulttempt ton!do!operation in-place (modifying **) and returnHjoresulto(which cbe, but does not havet. If apospecif" i^defined,o fallsk@back?thednormal. For instance, if *x*af/ o_classlwith an "__iad#)"z, "x += y"lqequival o=hxapy)" . O@wiseg6.__]b"y.__r(0x)"oconsider1as VRevalu of+ y". Icertainf2sitM's,Bcan  in unexpect>_error(see Whya_tuple[i][‘item’] raiseQexcepO@whenAaddi>rworks?)dthis behavisfact partl{Odatalomodel.:3neg/ ?pos*/ab*TinverI l'\n' 0' Called to implement the unary arithmetic operations ("-", 'QO"+",k"abs()" and "~").*object.__cox__(self). ?int*Ofloa, lEbuilt-in func<"/()C3int&p"()". Should return a value ofappropriateOtype#Oinde t"`1or.Z)wheneverPython needsnto losslessly converPnumer\an integpo (suchpas in slicing, orSA"binC"hex0"oc kW). Presencis method indicates tha  k7is $?e MustBX If "__1"__$__#"Iore not;definedthen corresponding W" "%, rm/ani fall backlE/)"-.__round[, ndigits] Strunc7, _floor,Oceil+  4! "o"math"kJ1s " V"_ Un8*o?* i}Bpass_" ll#se9s s  truncated t o an "Integral" (typically<' '"int").\n The built-in function L ()" falls back to "__trunc__g/ifipneitherE2intC#no2dexis definedvWith Statement Context Managers5= 5CA *ctmt@* isobject thats the runtime \K/tonbe established when executing a "with" s.j obhandleentry into, andexit from,desiredp1forIQon ofPblock ecode. ssare normQpinvoked us? A (described in se<RVk), but can also be used by directlf3vok/irmethodsBT_psM-Finclude sav~`restor"ovarioufAkindhbglobal , <^$unresources,1clooopenedc0fil??etcFor more inf.3on  U, seezu_ Type,.__enter__(self)@ E</ m relatedSthis oi will bi2is ’s return valuextarget(s specifias" clause, if any __}, exc_type p, trace,4E+the runtime context related to this object. The ' 'parameters\n  describe the exception that causnahe conOto blexited. IfKpIBwas 3 without an, all threnarguments willnbe "None".#  is supplied, and method wishesd7@ress2oy(i.e., prevent it from being propag ),p_houldjreturn a true value. Otherwise,]processelnormally upo=0Not`at "__@S__()"1s s0 no,@rais-B pa?-in+;ni caller’s responsibilitySee also: **PEP 343** -0“A” state>! 3specifica, backgrounexamples forgPython "|"pQCustomiz 0osi6al  in class pattern matchingP=&PpWhen usa`name i?, pyiekNA areallowed by default, ` "case MyC.?(x,>_y)" i:@typi y invali]!al/0ort"i_". Tokbe able touat kind ofsAneeddefine aL1*___args__* attribute| Mr#isAvari0canrassigned a tuple of strings. ' 'When this\n class is used in apattern with positionalgarguments, eachmG3 will be convertto a keywordq ,kusing thYrrespondPvalue*__match_args__* as/(.nThe absencer attribute^equivalent to sett/itto "()"oFor example, if "MyC.""("left",~"center"\"right")" that mean9at "case xa(x, y)o]:OB=x, =y)". Note`numberfps?then@mustpsmallere n b@qualq1ele? inl ; itqlarger,U?emp7Jkraise a "TypeError]0New7version 3.10See also: **PEP 634** - Structural PM?ingA0 specifica0 foe Python "a" statzSqal method lookup+=+bcustomes, implicL2nvos sare onlynguaranteedwork correctlydefined on an object’s typep?not$gEPinstad0dic@ary.aphaviour@7reason wh8`followQcode ;sPexcepvB >>>/ C;a ...?pas...\n'  ' >>> c = C()\n' $.__len__ = lambda: 52 _len(cUTraceback (most recent call last):^ File "", line 1, in >" TypeError: object of type 'C' has no O)\n"Y 'The rationale behind this aviour lies with a number{uspecialkmethods such as "__hash__()" andBreprthat are himplemented byo)sarcluding2. If the Picit lookuptnOhesen0use@e convenYWprocess,ty wouldkfail whenlinvoked onI itselfNM61 .0 ==R?h(1  u R?intS?intU ^odescriptor ''Dint'}needs an l@argurIncorrectly attempt"o lunbound naAPclassVoway is sometimes referror‘metaJconfusion’,s avoidedsby bypasswqnstance%3up Hs!6(1)/1)2XZ\ r43pIn addiF7 to>Tany i>attribute4`nteres7mn up general?lso/esmve"__geteven of the objectls ' 'metaclass:\n q >>> 9 Meta(type)Da ...{ def __getattribute__(*args=Bpprint("t~L invoked")Lpreturn .H C(object, h=*len__(self3/10a?#C> H#*?_ = C(2.__j)D # Explicit lookup viaKinstancez*35(c)cFj7 Hlen(sI# Imre1Bypassing the " )" machinery in this fashionprovidesosignificant scope for speed optimisations withpeginterpreter, atncost of some flexibilitpe handl$opecialqmethods (ths>* *must* be set o;e0 itVeorder to bpconsistentl1 by).\n', 'string-as': 'SDI '*&ds implement allmmon sequence oper, 'alongqX@addiG ald described below.\n'  ]'\n'  'Strings also support two styles of s# formatting, one Pproviding aslarge degree`flexibility and customization (selR"str.O()",pF q SyntaxiCi')/thxother basedton C "printf"LA that handca narrowerTArang*_typess;is slightly harder to use correctly, but i?tenr`fasterO thercases it can" (-?[.MThe Text Process[Services sec% of standardlibrary covers`number@modue various torelatex utia(inclu6regular expr%on!inO"re")dHcapitalize() Return a copy;?:with its first charac`C_% `rest l>dP ChaPd in vP3.8: { is now putOinto(Ptitle1 raGthan upper. This means&$D_s lik digraphs will on veK#ir0lety,stead of vhe fullosefold,aF/ed6. Cjs may bi Aused20les3otching0imi%tomore '  'aggressive because\n'  "' it is intended to remove all case distinction)? a Mstring. Forp example, the German lowerlletter "\'ß\'"mequivalent""ss"".wSSincevalreadyw1, "()" would doqnothingu;w"@fold[converts?to V1TheYalgorithm0described in se_ 3.13 ofnUnicode StandardgD0Newversion 3.3Fstr.center(width[, fillchar]){ Return S."a  of length *lp*. Paddlois donh us>specified ** (defaulan ASCIIspace). Thp originalAis rf1less than orsequal toO"len(s)<ount(sub[, start[, end])k`numbernon-overlappoccurrences3sub_*sub*FnE range [**, *end*]. Op?al argumentsj;O andoXA arerpreted aslice notasg" en(ing='utf-8', errors='ct')\n"Xw1an _4ed as a byte*object. D9si isZb\'". ** may be givenOset differentr (` handlxascheme 6fori#"\lO\'",q ' meaning that encoding errors raise a "UnicodeEn". ' 'Other possible\n& values are "\'ignore\'",breplacA"\'xmlcharref/q"\'backslash2 and any oname registered?viai &4cs.G_I()", see section H HandlersPFor a listr%ofrsnStandard E/s.Q By default, the *s* argument is not checked forD/be performances, but only used at}Gfirs). Enable7Python DevelopMode, ory a debug build tog!Changed in vers.3.1: SupportVukeywordzs_added6H9: Tw dTAmode#inkstr.endswith(suffix[, start[, end]]) Return "True" ifNA str,@nds popecifi@*/*,nw{rxFalse". ? can also b_tuple2of t/estpto look`. With opAal *@*, test beginn/atsMl@posi[i@end*op compaalMq+xpandtabs(_ize=8 (a copy o where all tab _acter3re d by onemore spa.Qdepen!on@currgcolumn 'and the\n' $' given tab size. Tab positions occur every *tab%/* Ncharactersp(default is 8,1inguat columns 0,&/16sso on).t`To exp,the string,t currenoset to zerotT bNexamined 6 by Q. IfR La ("\\t"), one or more spaceqs are inserted!inoresultuQuntil+GPequalIrAnextO. (T I`itself noepied.)R)vis a newlin  V0n")Qpreturn rhi coy ^ u/ i" 're. Any otherxunchang incremen#!byPregardless of how< `is repfwhen pri " >>> '01\\t012324'._()\n" E2'01$1012 @0123 /4':4|px''str.find(sub[, start[, end]])5B Rlowest index '0wheo#ub_*sub* found withalice "s[:`". Op/al@argu1s *8*$S*end*`terpre ass@notas."-1" ifp _Note:f '\n'  ''The "find()" method should be used only if you need ' ; 'to know the\n#2 position of *sub*. To checkg is a substringspor not,s tin" operator:/" >>> 'Py' inthon'\n"4?Trup'str.format(*args, **kw )3` PerMRO0attZ0ion3he q/ontwhich thisqIis called can contain literal text orhreplacement fieldp delimited by braces "{}". Each Mus eitherSnumeric index$a pal argu,/?amexOof amukeywordS. Return%@copy}cOwherkOeachk*$is?Pd wit&Pvalue}  correspond/."0sumP1 + 2CD{0}"H?1+2<'@3QSee F" SoSyntax for a descrip>ovariou Qas thatnbe specified,8s|!ONoteO{@Whenma number ("int", "floa complex",w "decimal.DP" andEclasses)"n" typ%?(ex"\'{:n}\'^p234)"),P func temporarilyz et!nLC_CTYPE" locale toi"LC_NUMERICP 'decode\n' '"decimal_point" and "thousands_sep" fields of I"localeconv()" ifr they are non-ASCII or longer than 1 byte,?thevLC_NUMERIC"q  is differenth\"LC_CTYPE" (. Thisutemporaryr change affects othoreads.:A CP d in version 3.7: When formatting a number withhe "n" type,tPfunctnTsets @ily  ;? toukIsome case4Bstr._map(mapping) Similar"V4(**T", excepTt"."Ousedrdirectlynot copieda "dict"is useful ifor exampl a e subclass:q >>> = Default(S)Ka ... def __missing__(self, key>C`return3/.."'{name} was born"I"{country}'uF='Guido'))\nD2 $ pY'6'0New02F index(sub[, start[, end]]M!Like "find()", but raise "ValueError" wan`substrois not_found#salnum(!RP"True all characters alphanumeric ae\at least one character, "False" otherwise. A ' '7/\n!' "c" is alphanumeric if one of the following returnsn"True":l 1.isj()", "c.isdecimalAigit/orj9O()".s6str%A R .Eall mAs in90str6?are betic andqeqt leastrAtpZ s XthosetdefinedoUnicodMqdatabase as “Letter”, i.e., with general category\propertyu bevmr t u l !oro”. Notethat this isdifferent from86“D”  xtStandard9%oscii()a9`'is empty or PfnY_ASCII'mPhave pUpointrange U+0000-/7Fp` Newgversion 3.7Fi  qFj-srp%sD3scan be used to form`numberq10, e.g."660, ARABIC-INDIC DIGIT ZERO. '  'Formally a decimal\n' ) ' character is an the Unicode General ICategory “Nd”.sstr.isdigit()% Return "True" if all2s istring arePs and/res1t least onen, "False" otherwise. Dswoincludn fthat need specihandling, such as compatibility superscript y. This cover*o whicho cannot be used to form numb\in base 10, likeMKharosthinW4. /,0 \?hasrpropertyqvalue Numeric_Type=; orB$identifierG35v valid f`accordk to8 language definition, sec % Ikeywords@ C"B3.is 0()"mtest whe ?"s" reserved)ra "def"b"class"!Example:|>>> from  import ?"W'hello'.is6(),[("O)\n"@ (!, Iw?defu syr'!'s?lowy5 ca s [4] in the stringN ' o'are\n lowercase and there is at least one d character,i"False"mo`_wise.%str.isnumeric()' Return "True" if all@s in string arej)/s,U O 5B N clude digitthat have5Unicode  value property, e.g.OU+2155, VULGARrFRACTION ONE FIFTH. Formally,{those withq&thfp_Type=DX  *ecimal oro 2 '$printable)j0 or&u`is emp1KV NonS q,tdefined"Qdatab=sn@“O0” “Separator”, exceptwtASCII spac(0x20) which iz considered <p. (Not&at""o @text} c should not be escaped whenk"repr()" invoked on a@. Is no beaoPhandlf=#ofDQ written to "sys.stdout"_err".s ' Ret'urn "True" if there are only whitespace characters ' 0'in> string\n%` and)re is at least onc, "False"ko_wise.hF A**gUnicoddatabaseqr(see "uQ0`"), ei its general category>O"Zs"i “Separator, ”), orjbidirectionp@lassm|qof "WS",u1"B"`?"S"str.istitle()dm Ret!a [Tcased~sfor example uppersg21maygofollow unRdS>lowlEOonesVm'3 al&C[4] |/ar   I{,iS&" >>> 'BANANA'.is_"0 PobananaPQNQ; /''join(iterable(ajPwhichpthe con na|0 of?Os inD * *. A "TypeError" will be rai)  'any non-\n' ' string values in *iterable*, includ "bytes" Hobjects. Them eparator between elements is theQproviyOthisvmethod.p str.ljust(width[, fillchar])4 ReturnPleft aPifiedTaof length**a Padis done us<2pecs** (defaultqis an ASCIIpspace). originalAis r#f ,0les_an orsequal to "len(s)"E_ower((a copy ofwith all_cased^Uacters [4] convertedlW  Aalgorithm u6`escribn sectionC3.13Unicode Standar$0p([3s)1lea:cremoved*Jps* argusy etJqHOto bC pIf omit5or "None", vOs toqQwhite  gis not aNprefix; rather,t\pcombinas:4its"ar)_pped:G"A>>> pacious '.lO)\n"/;'4+ fwww.example.comg'cmowz.'o <o' ' ' See "str.removeprefix()" for a method that will 'N ' 'a single\n 2 a string rather_n all of a set characters. pFor example:t">>> 'Arthur: three!'.l%p(_')\n"E'6# hLnq'p'staticz.maketrans(x[, y[, z]])9 This Y+returns a blation table us?forjR_e()".-` If pe is only one argument, it must be a dic?ary}mappingoUnicode ordinals (integers) or  (r0ngslength 1) tos,iZ(\PrbitrOq_"NonefD CR keys@then@converted to*uare two s,yBbequal ,C`and in]p resultf, each,x#20be +/edt!top1 atsame posij'y.i|?hirq Ev, whose/be P3theZApartO(sep!CSpli_mfirst occurrencep*sep*, nr/ a3-tuple containOP befohe separatorj%pbitselfiafter the separator. If the ' 'separator is not\n( found, return a 3-tuple containingh0str itself,wfollowed byrtwo empty U/s.-str.removeprefix(O, /)3 J starts with*\**P"JC[len):]". OtherwiseD a copy o originalqp:""8>>> 'TestHook'W_')\n"fA'9$ e@BaseiOCasei" Aq'' New in version 3.9z(0sufzz28endxZx and that{*//is2not{ :-E)<2tH)@MiscIsF(s?'?TmpDirMixini#ApRplace(old, new[, count],!R'3all occurrences#?3sub8_*old*A!reVf *new*optional argument **xgiven, onl vhe firsQDare C#find(sub[,q[, end]n'  ' Return the highest index istring where sub%' F '*sub* is\n  found, such that 4 contained within D"s[start:end]".kOptional arguments *;* and *end* are interpreted asxin sliceq@notas.W"-1" on failureUQstr.rq(sub[, 0[, /])7 Like "rfind()" but raises "ValueError" s2not#just(width[, fillchar"`right bPified#a of length**p Padd>is done uslBspecs** (defaultqis an ASCIInspace). The origiAis r#f / i@lessOn orsequal to "len(s)EPparti@O(sep!QSplita last occurrence of *sep*,(/ a 3-tupler beforeeparator,os%pbitselfDiQafterYCQ. Ifl ?nots wo empty8/s,followed byr`ELs H=None, maxO=- 1[!;@a liL_Pwords4,` aTH `delimi .*a given, at mos13 splits\n'  (' are done, the *rightmost* ones. If *sep* is not ' H 'specified or\n$ "None", any whitespace stringba separator. Excepsfor splittingtAfromA, "r6()" behaves like "_which/isk described in detail below.5Pstr.rp([chars])+ Return a copy ofVng with trail{doactersremoved. Thes*Js* argument&yqn0set.HOto bt If omittnl vdefaults toq g6aWsuffix; rather,tall combinations:its values_pped:G"@>>> ious 'O)\n";7'+ f@miss5ppic_'ipz'h 9d' SeXzIa method that will ea singl a_ n 0of /. pFor example)Monty Pythony} Mw cl'im4@sep=jQ, maxO=- 1B*1lisLPwords uPng, u+\ asdelimiter5~given, at .*3*\n'  )' splits are done (thus, the list will have at most ' C Q'"maxL_+1"\n$ elements). If *6 * is not specified or "-1",q@then_re isrno limit o/ number of(all possible&omade).q 1sepgiven, consecutive de"er grouped togethers2and1eem2f empty strings (for example,P"\'1,,2\'. (\',\')" returns "[\'1\', \'p\'2\']"QThe *@argu}1may1of multiple charact9g<>2<>3/<>2 3SIting anyw with aseparatorSDix!F:">>> '1,2,3 ',')\n"4['1', '2?3']- a$, -/=1m,j?,3,#?, ''Nis "None", a differennalgorithmnapplied: runswhitespace regardedr s0ing[ , cSresulecontain nos; at` startFcend if has lead/orotrailing&@. Cquently,H9 annaq!isWPof juO4 L'  'returns "[]".\n' ' For example:'"c>>> '1 2 3'.split()\n"1['1', '2?3']- ^1maxg/=1h e 1 2 3 :2str5lines(keepends=False)yNA R a list of the ]1 in string, breaking at 77 boundaries. LineSs are not includedzf`resultpunless *%* is given and true!This method Y2s o*bfollow/Inparticular,@2a superse*universal0new/s*!/+-2+| Representation6|zDescrip-1|l/|=2l c| "\\n|EFeed* m KO"\\rCarriage/ {%| +Y+\n'  ' | "\\v" or Fx0b"!| Line '  'Tabulation ?|\n2/ K/+-2+lfcOFormBFeed z(x1_| FilSeparator.|do Group|eoRecord{/85BNextC(C1 ControlPCode)W$>]u2028  z9Paragraphr6Changed in vers@3.2:`v" and f" added to listof linenboundaries.& For example:'>>> 'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()\n" "['ab c', 'Pde fg Okl']9 A>>> <\\n\\nde gfg\\rkl\\r\\n'keepends=TrueB3, '2\\raO'\n'' Unlike "6()" when a delimiter string *sep* is Kgiven, thisnmethod returns an empty list for thew_, andsa terminalr  break does not result inPxtra ':GF ("")1 /[] Q1One?\\n\9 For comparison,\wP\')" s)'(R'S1Two+s_:Gl1 str.startswith(prefix[, [, end]] R  "D" ifY s n**s/*,"otherwisers"False". T can also be a tuple of s_es tov@look.oWith optional *t*, test`beginn{at thato@posiHo@end*$op$ngwm,,rip([chars)`a copy/)Alead69trailing0 acters removed. The *s* argumenta;pspecify?thet0setb{t}If omitted or "None"  'the *chars*\n'   ' argument defaults to removing whitespace. TP OL/isr(not a prefix or suffix; rather, all combinations of itstvalues aresstripped:$"0@>>> , ious '.T_()\n"[:'3'( bwww.example.comc'cmowz.'k ;j'outermost leadand trail J0` from Mng. Character"ed(q>end until reach"a u #t that is ncontained ins0set^s3F. A similar ac_ takeplace or end. For (0com_,R= '#.2 Se3.2.1 Issue B#32 5.0 sh_'.#! ?#32ustr.swapcase Return a copyDwith upper_converted tos3lowRvice versa. Note necessarily tru6t'"s'  == s".:wOtitlt,C\d>> 'Hello world'.title()\n"O73W3+z&' The algorithm uses a simple language-independent definition of aqword as groups.consecutive letters.Vwworks inpmany contexts but it means that apostropheI@0rac_s andppossessives formd boundaries, which may not be thexodesireo result:t "they\'re bill\'s friend!om6UK"P!"TLARe BL3S FLAFroml?Uk"@ AF0karFV 0canFGtructed usingTregularn@expr?onsY(import rej0 Adef case(s)vg1... return re.sub(r"[A-Za-z]+(\' O)?", OTlambda mo:H1mo.(0).capitalize()n"/s)! GC/."i rs.str.translate(table}R`a copy0/0str#inNeach chaoer hasbeen mappV qthroughdgiven  A musan objectw@ment0dexvia "__getitem__()", typically0a *Oing*tor *sequence*. When  xed by a Unicode ordinal (anrinteger), thne\n' (' table object can do any of the following: return a LUnicode ordinalsor a string, to maplcharacter onK more otherw5/s;sa"None"ukdeletexAfrom0O; orr aise a "LookupError" exceptionqto itself.qa Youuse "str.maketrans()"jPcreat lam$oE-to-  pings in different formats!See also"zcs" modulc<Pflexi[approach _ustomupper()iD R5cop with all_cased_s [4]nconvertedWQ. No:/atb1"s./S().is " might b "False" if "s" contains unz'd or& eategorHresultingg(s) is not “Lu”(Letter,p ), but e.g.WtWAa title']t The ialgorithm uis described?secC3.13 j Standardzfill(width=Pleft _"ed%_ASCII"\'0\'" digits toI(length **. A leadsign prefixQ("\'+\'"/"\'-\'"}handled by inser1pad\*after* the sign\n' *' character rather than before. The original string is Nreturned ifqp*width*GBlesspor equal to "len(s)".E@ FIxample:' >>> "42".zfill(5)/"/'00042'\n"a1 T-U-UB, 'wbs': 'Sand Bytes literals/'* * e[ are described by the follow{lexical'definitions't# ^v ::= [prefix](shortr | long ;P"r" | "uRUf/F"= B| "fIFfKFrM rFT *2'"RRksG\'" pitem* "|| \'"\'{ -&Cnt0"\'"`s|q@\'""O2z # |escapeseqI tH }{ qJ&JOCb_ P 7eX "b!"BbDBbDB =r8r9R/RB|vJI,H (lm.p7 1E \wyteschar | bytesescapeseq\n' ' longb&item ::=qchar | E Qshort'3E Zo HMA One syntactic restriction not indicated byse produ"Ls isMthatdwhitespace2XPallowV`etween[ "{ngprefixk c" e1andG1 of literal. The source0set|defined-bycencoding declara+1; iJUTF-8 if no ( c-iscrgiven ifile; see sey/ E-s.M  In plain English: Both types40s can bePlosed matchingdSsingl s ("\'")8HdoubP""). yn@alsos g1enc g4in a group0thr';or uthese areO0gen* ly referred to as *triple-"d #s* backslasha()~@is u[2to  s G otherwise havqacspecial meaning, such%, itself, Q[B Aare always ed with "\'b\'"\'B\'";yJga`stance" instead2strm a.maonly cont+ "s;[a numeric valu<128-or[@grea]@must`expres& $`may op@allyj F0letF"\'rRPlsF called *raw t es as literal characters. As a result, in string ' 'literals,\n"\'\\U\'" and upescapesS3rawWs are not treatedhspecially.i Given that Python 2.x’s `unicode  behave differentlylMthanf[3[0the ursyntax issupported V0New version 3.3: T[ rb[prefix ofVbytesbeepadded apsynonymQ@"\'b$SP for iTegacy ("u\'value\'") was reintroduced to simplifyWmaintenance eMdualc12.x{@3.x bases. See **PEP 414**LmoreJinformation"AP with"f or F sin its i *x=ted*; see F4 L-ma-beccombined#Q, but,?refH=rawe6possiblen$ * 3?notIn triple-quo0HRs, und newlines;( r_allow(@retaH), exceptWthreeob inmo*terminatea]. (A “>0”{#ch2 usLLopen.th , i.e. eithe " M"".) PUnles97<0\'Rpresent, s sequenceu je*@rpre`accordto rulesX@ilarc NthosDby Standard C. recognizedMare: .+- &$+T1| E[# SQ | Mean | Notes '  g'|\n' N '|= &$T "\\newline"n| Backslash and ignored' d.+- &$+ %\\z( b("\\") r'Single quote ("\'q"GDoub"aASCII Bell (BEL+pqbpace (BSqfFormfeed (FF qnBLineLrCarriage Return (CRwpqtHorizontal Tab (TABzvdVertic%VT/  |\n'  >'+- &$U+\n' Q '| "\\ooo"| Character with octal value *ooo* | J(1,3) |d $?xhh 4hex1hh*2Y )Escape sequences only recognized in string literals are:I ?O$wSP Meanap| Notesr  .|= &$uN{name}20d **r1the.4|1 | Unicode databasV %8 Q $"\\uxxxx v16-bit P$ /(5*u  qU6/326 ul P1. AsbStandard C, up to threekQdigit accepted.t 2. Unlikeaexactly two_orequir_3. In a by,Qadecimal andes denote Q 0G  with the given value. In a string literal, these escapes ' 'denote a\n Unicode character withPc givenv ; 24. Changed in version 3.3: Support for name aliases [1] has been\madded.k 5. Exactly four hex digits are requirJo6. Anycan be en.d this way. z\eight{=hex/ $Unlike Standard C, all unrecognized sequence@left =theY2unc , i.e., *the backslash is Uresult*. ](ThisebehaviorG useful when debugging: if an0 mistyped,e*`outputAmore easily 9roken.) I* kMalsof imqant to gAthat@*ons,in/~ e0s fAintoacategory ofsq Nbyteal/ O6: U |produce"DeprecationWarning". future Pythoithey will cdSyntax^ and eventually a "!oError"E.i6rawtquotes @deaQ,!buE premains;example, "r"\\"""ac]valida consistCVf two*7s: A d^doublf;Pnot am+id (0 a W mcannot!enan odd number,Des). Specific2, *i b! cz jg singl)* (sincexl would0 c 'the foll owing quote character). Nalso that a single ' 'backslash\n"followed by a newline is interpreted as those twos OMpartdof the literal, *not*=!a n continuation.\n', 'subscriphs': 'S c('*$_0 ofJequence (string, tuple or list) mappingi@(dicary) object usually selects an item from;h0col/Oion:l8 _ ::= primary "[" expression_O "]"J5TheQmust evaluate tosupportsLm(sZies for example)User-definedwsCcan r8Wa "__get__()" method `For built-in,Rre arPtypesL/atDbmHI;Sis a I3  !! wR0oneb1key ?and?theiUunzcorrespondsrpkey. (9~5W{except if it haexactly on/.)s#B0gerPa slias discussed i!seo)formal syntax makes no special provi&l|negativ{`indiceV_Ks; however, built-in s equences all provide a ' '"__getitem__()"\n&method that interprets negative indiqby adding theqlength of#os0 to&_Pex (sat "x[-1]" selects#Olastqo_"x").qThe resultvalue must b97nonteger lesy/anuonumberr0of As in@, anie subscriptionMo whoseqqindex i"t Q(counfrom zero). Since_upporX/fo-@slic]Uoccurobject’sH,3classes overri3is will need[I0exp!tlM sT;A strings are characters. A?notseparate datarptype buD{@exac'on|Sof certain *`* or *s* creatgeneric aliasI,is case, user-defined sS can B/by46Qa "__^ )qV, 'truth': 'T ! VG0Tesb h.'* " BAny -be tested for y, us an "if" '"while" condiaor as oper Boolean'ps belowM'By defaultponsiderarue unG2itsO7KinesPqeither Aboolreturns "False.1len- Q;, when called withx. [1] Her;'artP'mostebuilt-instf: *1Stants2be > "None" and "False"e.\n' '* zero of any numeric type: "0", "0.j Decimal(0)",J "Fraction(0, 1)"!  * empty sequences and colleEs: "\'\'w () []Y{}", @"set" a "range  POperabuilt-in fun that have a Boolean resultkalways_`returnO or "False" for f 1"1"3Trutrue, unlesQotherwise stated. (Important excepU: theo =,orb"and"  0one)atheir P nds.)\n', 'try': 'The "try"Hment.'* M specifies handlerP/or cyup codeQupa group?)s:'  try_stmt ::=1| 2 3%3":" suit "(" " [expression ["as" ident@r]] P'[,)+W1["e<1]0 finally"o32try "_ clause(s)!y or moreg. When9'no^Yloccurs inCoN, no\) ia'execus'an3\V, a search/anh0 isnrr0 ThI in/!ts QuntilSis foundhmatcheRyion. A[-  ~P, if ent, must be last; it o9anyI{EFor dWR with]C, Qis evaluQ,?z 9ingP`object“compatible”:K@30 TieOclass or a base class of the ' 'exception\nobject, or a tuple containing an item that isSRclass0IbaseN|q e.+ bIf no 1 clause matchetAion,search fnqhandlerinues inHpurroundcode and o`invoca0aZstack9[1] I BvaluM ofVexpression`header*an  QbraisesCoriginal  is canceled9and^a>astartsbG3news> Q=Qcall 92 (iGreated as i!ntire "try",htement ]) bWhen aR5ii2undHs assigned toQztarget specifiAfterX"as" keyword#at@u,)if]Aent,j:’s suiteexecuted. Alld NNs must hav 7able block. $n"is s]reached,Q6>enormally ae8tryU2sta (This meanf two nes=us exist?sam,e occur;*TinnerQ, Q ou will nor|Yion.): Q`has be usB"as 2", Xjcleare%"at}e%O1. gi  $ :E,N:i*fo) $wQransl T +m?try@ f#l7Ydel N +J^(be1 a differnJto b0`to ref;o.Eions are  'because with the traceback attached to m,y form a reference\n' f'cycleM stIframe, keeping all locals in that "Z alivOPuntilw next garbage collection occurs. -Before an except clause’s suite is executed, details aboutz MCxare storede "sys" modulod can be accessed viaM1.exc_info()".C returns a 3-tuplPnsistH7of z*th;Qclassrinstancaobject (sePsq Thandard type hierarchy) identifyMSpoint! program whereg`red. m  ^sU#reir previous valuesPwhen leavJGhandler:/  >>> print(sys))v(None,  "K:trypa ...raise TypeErrora'3BHp  VS) #-!a" (<.% 'C6'>,PV(), <",Fat "0x10efad080> `ab4b @'8z' opal "else"1 if+control flow(es R"try"G, noj2was`d, and"s@", "ghinue",^ U"break" statement UPA. Ev3ione*arhBnot VAd by`preced|"( If "finally"Epresent, it specifies a ‘cle anup’ handler. The ' '"try"\n'clause is executed, including any "except" and "else" 6hs. If`)an]:ion occurs inSdof theFYcis not d, Kis temporarily saved."finally(. )If]AtheraO itFre-raised atS end M ^-,& [Ps ano} Qs set astcontext6newL.~ s a "return", "break" or "ninue" statementbdiscarded:$ >>> def f())a ...?try!<1/0W;6? ? 42E 89 isRDalsoqd ‘onway out.’0 hCvaluDfuncmdetermined byYElast N. Since9 UalwayiIs, aOgPX[ SSwill Xb 5oneT  t/oov"vl'try'\n"(H,LfX'E&P'AddiGal i&onPs can be foun!seE IE;0ion'Pon use"KIzgenerat]2tions may be found in section The raise statement.\n' ' aChangeA@versA3.8: Prior to Python 3.8, a "continue"^ Pwas illegal the "finally" clause dueZa problem with theJAimpla, 'types': 'standard  hierarchyGO '* * Below is a list ofms that are built in,6. n 'ExtenZ _modules (written0C, Java, or other languages, depending on P 1) can define addiF"al. Future Ks ofO0may?8 p (e.g., r*alnumbers,_ efficiently stored arrayN eg5 etc.), although such`sapwill ofY bekvided via<<library insteadi,) .x 'Some  descrip^1s b2$ain a paragraphA;ing ‘special attributes.’ !seau0prop access o H: '0 ankAe no enfor general use.*irkNI %cJ"f_M 9Non@ ' y!iso0 ha|single valu"rebobjectF i$ ISThis ;Naed thrj-in name "*".+It  usKo signifysaabsenc?a.many situ>*s,_Zbtereturned from fundon’t explicih0Nanything. Its truths false$tI.edal5z8"No". Numeric methods?rich comparisonOrshould y ts! iLBy do>)2opeL 1forb '  the operands provided. (The interpreter will.Pn try U\n' ' reflectedRtion, or some other fallback, depending onOtor.) It should not be evalualin a boolean context.  See Implement arithmetics for more details] Changed in version 3.9: EoE"Not0ed",)a R0 isF0rec. While it currently&s as true, itQemit a "DepSionWarning".%Praise&TypeError aaefuture of PythonK EllipsisQThis type has a single `e. There object withf/th`Ig;is accessed through literal "...">thebuilt-in name " "."th "numbers.N"s0The`re cre# by numerics and returned&zresults%.by_ -"orN@func:s. ZN_v0s ammutable; oncStheir6qnever cz # q6Wof course strongly rel*to mathematical~, but su^#toAmita0 ofss*alrh2sen*bi@mput   [ Ysclasses, co^/d 0"__HQ__()"$a"__stra, have`followv pr[ties: @ *yTvalid#which, when p"d ]*irFb structor,duce an X& oorigin   Mein base 10ossibleS1Lea<zeros, p;qy excep#@ befb 'decimal\n' ' point, are not shown.)  * Trailing zeros, possibly excepta single# after a /de>A sign is only when the numbernegativePython disuishes between integers, floa! Sj*s,>andNtcomplex3:" B "0s.I~Nral"$ These represent elements frommathematical set of`P(posiDT and Q)R!rewtwo types}p1 ers ("int")l > in an unlimited range, subject toQ available (virtual) memoryoa. Forappurpose _shift_ nd mask operations, a binaryassumedkr(!edq varian_2’sZ which givesillusiona-finite str" /ofabits extend;!toaOleftppBoolean,Obool-6truth values FalseQTrue.g? tw-oNs$heP"Q"R"S" ?the l. ]' _,Wbehave like0H1, respecJ1ly,}lmost all contexts,^^*on__being"Bthat`converCto aY3s "O" orQ"`return~The rules forJ(qnded to] most meaningful interpretation of shift and mask operes\n' ' involving negativeS[gers.1  "numb*Real" ("float")* These represent machine-level double precisK _point_ You are at the mercy punderlyWLarchitecture (KC or Java implemenqQ) forhacceptedQQrangePhandlof overflow. Python does not support single-a8+ ; sas in processord/anmemory usage thatcqusually\areasonu se'dwarfed b> @head?aobject@, soU*rei3no to complicatpe languwith two kinds} r `,C ex//ex1. as a pairNb  same caveatsp_applyb!as6 X Th!alimaginary parcOof ab  "z" can bYtrieved through+Od-onttributes "z.r0"z." Sequence finite ordered se2dexDnon-.B built-in func"len()" returns3 Oitemo# sa. WhenF`lengthFa is *n*,!Zindex/seicontais 0, 1, …,Q-1. Item *i*sJ *a*cbselectN_"a[i] 5 U alsotslicing: HR:j]" ]as all C 8p*k* suc!atP"<=" "<" *j*. dAusednL ex( @, a e{a sequence of the same type. This ' 'implies\nq that@ index set is renumbered so$it starts at 0.J  Some sequences also support “extend`licing” with a third“step”i parameter: "a[i:j:k]" selecll items of *a*e:*x*g^whereb"x = i + n*k", *n* ">=" "0" and *i* "<=" Q"<" *j*! re distinguished according teir mutability: Q Im.l% An objectMan i8R cannot change once it;i\ created. (Ifhqpcontaink2fer$to otherZ1/s,Sthese6)r may be1!le*d;ahowevera@ colM0ion(gdirectly rezd by an^TM a+.)+ The follow' ype/res1_tring+! s!abvalues%represent Unicode  points. All(,1 inr"U+0000 -\U+10FFFF"a0can edXa . Python doesn’t have ago*char*d; instead, W&y qK a4as 6length "1"e built-ifunction_"ord()" convefrom its3P formaPtintegerj; "chrsN'`corresponC d)$1". "str.enF@usedn) $a_@str"7"bytes" ushe given text m@ing,K"bytes.decode()" can be used to achieve the opposite.\n' 'oTuples The items of a t- are arbitrary Python objects. Q z/ofatwo or mori^formed by comma-separated listPexpressions. ARof ona (a ‘singleton’)MTaffixing az&n u9 (a /bybitself does not createq , since parentheses must beQusable for group'of s)sn empty&S `D@pair&?Byt0A b^ is an immutharray.> _8-bit']@, re5 enaby integers inPrange 0 <= x < 256K1  literals (like "b\'abc\'") andTbuilt-in("?()"constructor4B0Jlso,f#b^Rdecodcstrings via" rlmethod#pMsequenc & chpd aftery:d. /Thsubscription@slic.@notaspj asjz targetbassignment_"del" (delete) states0|Pe cur 0ly B inDsic U{ types:~ L[z oa P $/ar 1plad cps`/in0squ`bracke@(Not/ atVno special cag oneededb!to length 0;1.)8 ? A  A bytearray object is a mutable . They are created ' Y'by\nthe built-in "bk()" constructor. Aside from beingQ(and hence unhash0), cs otherwiseprovidebsame interface lfunctionality as im/s"QW+s. 3The extension module "#" s an addi{ examplOof abAsequ?Ptype,Pdoes a"colle#s" @Set Ist"These represent unordered, finite sets of unique,ZML As such,y cannot bdexed by any subscript.However,bt1canM1tero,  "len()breturnW`numberitems in a. Common uses forsn UNfast meVship testing, removing duplicatX[p,NPcompuE mathematical op 2ionv.s&,/onN`differhq symmetric [ B F elements irules appl>for!di ary keys. Note that numeP obey^ normal ] aFKarison: if twoaRbers e equal (e.g., "1""1.0"), only oneBcontainedR  re currentlyintrinsic:> o Setf W?setUbq dmw{ "setLDmodified afterwards `s/al_methods,k"add()"ProzenEn6. s%1 "fyc abzenset is '  'immutable\n' ' and *hash"*, it can be used again as an element of Ianother_qset, orB dictionary key.1 Mappings These represfinite sets objects indexed by arbitrx "`I.f subscript nota "a[k]" selethe itemn d>"k"bPfrom ;m "a"; this}Pin ex@siondH _/thQtarge`assigns"del" statsbuilt-in1fun"len()" returns`number}3 a  0re urrently a single intrinsicOk type: D Dm/ieDuGnnearlyk' bqvalues.Q onlyLa accep vakeys are Ccontaining lisr^!ieAthat\bcompar2h0 ra0 thyg identity,PreasoRm`effici2impYa /ofaIrequires aVP’s +p to remconstantsNumeric0forRas obeynormal rules  nC\ison: if two 3"s e equal (e.g., "1" ao"1.0")`@thenyAterchangeabo*O sam<& Ioy entr @o 0erv1ser8order, meaJwillZbproduced i Wy were added sequally overa5 . Replac@xist key doesY} _,@howePremovQQre-in. ng0add *tobend instead of keeping its old place.\n' '!Dictionaries are mutable; they can be created by "{...}"Q@notaR (see se_ gy displays)The extension modules "dbm.ndbm" andgnu" provide@addial exampIaof map<types, as does ?R"collsChanged in verF3.7:(did not preserve PinserWorder_s of Pythofore 3.6. In CO3.6,Lj V5wasd, but it considered anLx3men%detail at thime rathern a languagguarante @Call QThese2the% to which 2funcall operOw$s)Eapplied:0  User-defined zs(o A u- object isaMLr" F!s). It should b,ed with an argu list containtsame number ?tema$’s formal parametero`Speciatributes* /+- 6 "+C| AtQ| MeaT Y||o 1=| "o| "__doc__" |  1docT Q| Wri? (| string, or "None" if  K? | unavai;cinheri{ o '| |\n' '|| subclasses." Q Ko 1/+- 6 "+"__name__"| The function’s * | WritableKw@qual *+Pified?  F|@*. New in version 3.3V o8Ow^modul1Oh of the )  -M  was defined in, oroMo "None" if unavailV o 1  $ "defaults A tuple containingS, M argument values for thos:xMos that have/s,o?6or .4no sz V"NT o 1 \p $ ">codT" V object representV  | the compiled function body.$!' !'|9|\n /+- 6 "+o| "__globals__"| A reference to!diiary | Read-onl hMat holdskOC’s$ qq! variables —{ jq!namespace ofimodule inUVn front ofargument list. F eOwhena0"C"which contains a defini`for a  `o"f()",b""xfuof "C", (q"x.f(1)(pequival f/tobCC.f(x, 1)" 4pderivedw$ xF2“a” stored infKwillkctuallye!be ]juso that\ueither c*orb"9?1)"b7is %toVP"f(C,where "f "A0Not!attransforma~: tohhappens each timz)e r~*edea. In some cases,]ruitful optimizNaassign to a local variable|'1. Also noticr sTonly ( ?foraQuser-UW0uncAs; o0s (>all non-Q 3T) areed without -}ti-aimportantPn E/arsy are not converted to bound\n' ' &methods; this *only* happens when the function is an Hattribute`!ofAkclass."  Generatorrs%E A B or which usess"yield" statement (se"seAThe 65)called a *g  *eeSuch a,YV, always return`2*it*cobject`can beqexecuteSbody :_1ingCd’s ".__next__()"~:illOcausp S4to until it provides a valu M. WfU"m"N1ralls ofend, a "StopIion" excep  gi@raisN)ndc wBhave reachdhe end:setb/of3sLW,ed:Coroutin}is defined us`"async/" o= *cO*. = iC,& W`"* C . It may contain "awaitexpressions, as wellwith" and Jfor"Z (qee alsoO#s Auhronous ;aZ2is Y(W, -/an`* *m-in _ p CallhRous iterator’s "aiterator.__anext__" ' 'method\nwill return an *awaitable* which when 1ed .zexecutec_untilb%it provides a value using the "yield" expression. Wt?thePfunction srempty " " statement or falls off`end, a "StopAsyncI_0ion1cep}is raised anda@hronous Fhave reache@p end ofKJ set/of_Ms to be I;ed.*  Built-in Js$l A b) object iwrapper around a CQ kpExample[s are "len()"T"math.si(""standardZmodule). The numb+yp^@arguHdetermined by Special_read-only attributes: "__doc!is]1docaQpstring,"None" if unavail;bGnamec pb=FCselfF3to r(but see?m);O2"__KqcKJ wasa0defa/in  @'>%@This@realp differzdisguisea,?thibtime contain5$an0pas!to" a implicit extra @. AP  p"alist. nd()", assum** a &_. In Qcase,sOB - Rdenot Clq1calp . {6bs norm' ct factorie`for new instances of themselves, but variations are possible ' i'for\n-class types that override "__new__()". The arguments of theQ2allassed toJ and, in?vical case, toPq"__initM aializeDnew instance.A A CI0s!5 arbitrary )es can be made callak*byndefiningaa;cmethod"iri oModulea basic organiz#pal unitPython code,4created byoimport system as invoked either'"("PPstateE1, o/ ing funcosuch aVBlib.`!_m1()"built-in`!A7 object has a namespace implAa di3Z(thisei8the=referencX "__globals__" attribute of2oeD U). AAk%Matranslto lookup , e.g., "m.x" equivalentbo5 __L__["x"]". A Idoes not conta)Q2uf P (sint isn’t needed?oncV?_done)  {`assigna updatjeG’sk~ionary,zA = 1~q9"m.`'4PreBP(writ)}+s: I/_ame__"C ?docY1docastringn"None" ifaunavai?fil @pathCkI3 from whichN was loaded,i '  it was loaded from a file. The "__ __" attribute may ' Y'be\n missing for certain types of modules, such as C _Othataare statically linked into the erpreter. ForZextension_ Sdynamk,shared library, it’sg/th!pathname O lp"__anno oons__"& A dictionary con*variable H* collectedP0dur?) body execucsbest practicnworkinga@with__", please see AO Bes-P.m  Special read-only:E!ishOspacHas aoobject**CPython implemen detail:** BecausTCway 4cclearsyiy will beG&Gwhen# falls outscope even if&X sti X>haslive references. To avoid this, copy]zor keeparound while u8itsdirectly Custom classe ,3typycreated byEp definiq x?(sey!se C= ).! hl*ed4.byoF Qransl .to`lookups M(hi, e.g., "C.x" WJP"C.__t__["x"]" (although2!rea numberPhooks*ch ^allowother meanPlocat5 Ts). W)  ei1Qnot fg e,q searchinues in the basee\n' ' classes. This search of the base!Q usesC3 methodM!resolution order which behaves correctly even inPpresence .of_‘diamond’ inherita;structures whereYre are multiplApaths leading back to a common estor. Addi.aldetails o`C3 MRO9 d by Python can be foundJocumentak accompany2.3 rele.at?https://www.pw.org/download/<s/2.3/mro/.D p When/ attribute referB(for- "C", say) would~yield ab[ object, it is transforme3>sC whose "__self__" is.#it sc[rappe.by4e. See secPImple+Descriptorsu>foraPanoth ays retrieved from:may]_diffe`6tactually contain@ itsdict__"C}`assignqs updatP’s Zzionary,?nevs4aA|called (see above)\fa2 n"inDobelow)vSpecial+s:R "__name__"S Th ) _modulW Qx1%pwas defH~ #.TvR_spacexDsy|A tupler70es,T*ofOthei~occurrence in the base class list.\n' '"__doc__"S ThT"’s documentation string, or "None" if undefinedBannoQsPA dicv ary containing *variable H* collected du/body execub . For best practices on Oworking`with "____", pleVsee A_ BestKPR CinstancesOA# is created by callSa'object ( labove)= ahas a namespace impleA1ed  c^which0is 0firlS!n - attribute refere are search When an<is not foundlRre, a  8 i /hau ^qby that,_ainues 9ats. If  ataSuser-`1funh 1, iDtransformed into6z methodf?`Pwhosezself__"|W@. Sc`/an'"usWalso ; r1“EPes”e>I# Descriptors for another way.inf 6s oretrieved via itsu functionl), N?not`=(becauseVy represzcalculatedbaarun-time). Unlike(s,$ immutabl"1andL0ainW references (directly or inJ) to_ +s.> Special read-only attributes: "co_name" gives_  &;bDargcount" iEtotal number of posi %al7sN(including4p s `~js with=a!);0pos  `9)X/kw dkeywor!qnlocals 4:P vari"s used by^20varta tupled-Athe !n `(startLQZcellvary , 0than%e IO0nesesFfreeP= AU aQ0str8 @@sequ@byteGq instrus_constP yliteral_z%F   b@filefe from which  a/wacompiledfirstlinenod@rst v' !' function; "co_lnotab" is a string encod the mapp from\n' DP#bytecode offsets to line numbers (for details see WosourceQM'interpreter)stacksizeKrequired (`=LQflagsH0an k6geraA of * a?for_L.% J The followklag bits are defined F ":! o"0x04"`iyAt ifUQ uses"*arguments" syntaxjacceptf/anbarbitrary5@posij5al _;8y+se`/if`V*keyword_F%20 ?4NgeneratorFuture feapdeclara9@s ("xA __f%__ impor4division")@also{As inGindicate whether a  Ooobject_was compiled with a particularrenabled"0x2000"\/isa$ |u"  Z};`k"0x10" and @were9d5earlier verl?s ooPythonOo creservQ0nal[$If@ repRnV J,first item ix@consi31doc1:oa/, $@"NonCf unbFrame ) "` execuQ fD0s. ry may occurtracebackw (qbelow),-a`passedQ 9registered|bs Special read-only attributes: "f_to the previoeus ' 'stack\n frame (towards the caller), or "None" if this i"obottomPj V; "f_cod@8 object being executed inoa[tlocals" dictionary used to look up *NvariablesDglobSDBfor  *I"f_builtin?-in (intrinsic) nams "f_lasti"`BgiveEprecise instru (/ an index intoMAbytes0g o!e +).9 =`Accessraises an auditZevent"f.__getattr__with arguments 8t" and "r"Special writ upibutes:ptrace",3not,R2funz- d )"Aous Ps durU+io`"is by debugger). Normallycj0trieQeach new source line -can be disd by setK1"f_/_D s"io"FalsePImpleas *may* allow per-op36s]be reques( 3/by_SPTrue"Hrte thatmay lead/toaqundefinterpreter behaviourFRexcepV?thePO T`escape2,dRUineno$@currt numberXA —$ k xPfrom Qin a Ajumpn| ^O(onlY:sR-most^U). A iZ a Jumpl@commA(aka Set Next Stat)&Ato f/noqFMs support one method: U.clear()" 1 This method clears all references to local variables held ' Y'by\nthe frame. Also, if  belongedga generator,_?the`3 is finalized. Thips break \ocycles_involving objects (for example when catch)/anMexception and stor0its traceback Xlater use).K f"RuntimeError" jraisedmis currentlyexecutingqNew in vers?3.4:TF & represent a st%/u of an U*. A_;j,pimplicircreated^ \occurs,bmay also be ex^by callingBu"types. _Type"` For "s,asearchq[` handlanwinds4"on, at each*unwoundwlevel a@nserin frontQ@. W is entered,TP"made availprogram. (See secoThe trstatement.) ItZaccessible aXthird itemOtuplreturned by "sys.exc_info()",fU5"__?__"attributexgcaughtb 7 x contains no suitB 7`is written (nicely formatted)standard e stream;c/if`i0pre1is active, i @userFlastV4s$up*oro '  the traceback to determine how"tb_next" attributes ' >'should\nbe linked\form a full stq{.: ISpecial read-only : frame" pointso executionb@1 ofcurrent level;`lineno" gives% onumber_Qwhere7Pexcep1 ochdaasti" indicae precise`pinstrucXA. Thx"e and last &0 inMmay differ from2Zsof its =Zbject/ifb>he pa "try""0temwith no matchingQM clause or 6a finallylAccessing" raises an audit_event!"o `.__get73__"0rgu s $""" writable  i ^ /thL (towardL   *),o"None" inPre ispChangedversion 3.7: TVs can now beexplicitly.antiatedPython code," goAexisIh"ce`be updtcSlice  "r are us`represasFZs for"item__()"`methods. uyaalso cre1 by4built-in "mN2fun l `start"[lower bound;OstopC6upp<U"stepW value; eacho kromitted>s have any type: support one d:\n' '\n' ' slice.indices(self, length)0 ?! This method takes a single integer argument *[_* andPcomputes information about the H tha oobject_ would describe if applied toequence of _oitems._It returnAtuplJEthres; respectively9se d?areaa*startF *stop* YQep* or stridOY]P. Mis>out-of-bound(  handled in a manner consistwith regular LdStatices'? * provide a waydefeating,IVtransqof func0 cabove. A s i>Qwrapp>} any other , usually a user-defined;P. Whe|P retrieved from a class# instance,/th}B act7:s "d (p, which/no!su,0fur. .# also callableJare created b built-inw"~1()";|tructortAC=8'A +P, lik% 4,za#arSalter ay)  ~#nds. The behaviour/ofaO s upon suc al?ve,Qunder “Uos”. k \dpc-in "classmethod()" constructor.\n', 'typesfunctions': 'F ^\n' $'*!Z objects are created by q defini. The OonlymPoperaCV on a\| is to call it:`"(argument-list)":QTherereally two flavors ofs: built-insrand user-I%edc s. Both support the samaE(.sIR), bu\Pimple=is different, hencz?thekBH ESee )r for more inform^/pmapping-M TG — "dict":B,3A *~*maps *hashable* valuearbitraryH' s'0mut\rE`is cur0ly ? on'standard,*Fionary*. (For othertainers semCo@in "", "set", 1"tuple" classesKb"colle!"Kmodule.)o&A ’s keyn*almost* B. VP'thatfo7not%edat is,/0conW@ing /s,oies ork4$ (r compar1 ra?tha3'byyoidentity) may be2d aU. NumericasG?obeY'nql rules.n_ison: if@numbk/e equalP(such2"1"P1.0")$ndy can e 'inte rchangeably to index\n' ('the same dictionary entry. (Note however, that since Jcomputers storeofloating-point numb2as approximas it is usuallyp`unwise/usnxthem asokeys.)Dies can be created by placing a comma-separ%list of "key:p+value" pairs within braces, for example: "{\'jack\': 4098,'"'sjoerd':\n"4127}" or "{E$: U , BP\'}",)0by 6"F"constructor."Bclas(**kwargs*mapping, 3iterable4 Return a newtinitialized from an op/alR'posilargument and a possiempty sefkeyword -sy?  sal means_* Use7 # z"/\A f"p'QlZ}JSprehension"{x: x ** 2Ox inGrO(10)$Wtype !: C()", [(\'foo\'100), ('bar',3V200)]Vfoo=100, bar=HPIf noJX`given,0m4'isAR Ifo#a object, a$ with the sa me key-value pairs as ' 'the mapping\n! object. Otherwise, 8positional argument must be ano*iterable*nEach item inp<eoitselfl/Owithoexactly twos. The firstU of e(becomes aznqnew dic=qry, anddsecondtdkcorrespond R. If occurs more than oncQlast 10for2t  Y.* ukeywordss are given!/nd_theirl^added to created from'k?bbeing zis already presentoo & replacesEh To illustrat`follow`exampljll return a_equalpto "{"one": 1, "two": 2 0hreO3}":?hq>>> a =p(one=1,h =2oree=3)?"?b = {'one'Q'two' 't': 3}\n"DcQzip([M!, JG`], [1,O3]))Q dQ#[(GS2), (Z1 _, 3)]PeP{!, O }JfJ4*G'v`a == bcdef:OTrue  Provi[ s_ only 'works for\Ln' -' keys that are valid Python identifiers. Otherwise, any O>R\ocan be used.% Thesethe operation0dicaries support (andoefore,ocustom mapping typYUhould`_too):B list(d) Return aB of all qR1 in ?*d*|?len)`number_items od[key]6 L*d* with *key*. Raises aE"KeyError" ifn Nt is not?map If a subclassa definmethod "__missing__()" present,^"u"S call^m 2key} as argument. ynathen r-so Bor rwhatever94ed @d byK pQkey)"`. No ol,sY%Ovoken0)". )"m/d,n "is'-d.W@must"a ; it canz_be anl `nstancoriable]B>>> "Counter(')M4a ... Hdef APself,BGI/ 0 1 4 = "R0['red']\n"* 0\n'  "  >>> c['red'] += 1\n"  0+'4K'K?'\n6The example above shows part of the imentation ofQ p"collec*s.Counter". A different "__missing__" method is usedp 9by sdefaultdict".9 d[key] = value'MRSet "Ea" to *H*#elm0Remfrom *d*. Raises a "KeyError" ifP*key*~?notn !in!?mapkey in t Return "True`*d* haU, else "FalseG?not$pEquival@to "IQiter(d)%0an Cator overDkeys'ionary. @This an shortcut for "r0(d.g?())oclear("0all1ms  copy# shallowIuyClassdpbable[,]< Create a new /` with fM*l_* and1Os se9 'E "!)" c athat r&cJ XsQ"None$llrefer '  'to just a\n'  ' 'single instance, so it generally doesn’t make sense Pfor *value*q &to be a mutable object such as an empty list. To getqdistinctn Ps, ustdict comprehensionOead.E (key[, default]),|Return the  Ckey* if * 2s i#tionary, elsen *e*. If  is not given,(Os tox`"None"*o that this method never raises a "KeyError"|oitems(p'a new view of~GQ’s a0 (",/)" pairs). Seedocumentatw#ofs?keyJ`$.  d90poptV+ ;, removeRand r\2its, vFT/. c wpn Ne0popZ#UR#a ?+ Q from6PYC arew ed" LIFO (last-in, first-out)_orderf "$"h`useful(destructivelyA`rate o ,Poftenset algorithmsU- = 'dictiona|ry\n' '#is empty, calling "popitem()" raises a "KeyError".Nd'Changed in version 3.7: LIFO order is now guaranteed. In priorn c)s, would return an arbitraryhkey/value pair re_ed(d)-R F iterator over the keys of &dictionary. Thiso ishortcut for "y@d(d.j?())!:New8Gsetdefault(key[, ]V If *key*i!in:&,Aits _. Ifnot, insertW mbwith aS*E* an/. r p Ys to "Noneupdate([otherc!UA [ Sos from/*, @writAexis 3. A#C " )" accepts ei1 an : object or/an 0ble qs (as tuples\wDl length two)keyword arguments are specified,rp isA"n Ld!os ::2"d.;o(red=1  oblue=2/s(N ca new view3’Ls. See?theF 1docadltsO P '( An equality comparison between one "dict.values()" ' ;'view and\n*&another will always return "False". This also appliesnOwhenj -ngto itself:@" >>> d = {'a': 1}\n"  /:U == dj1 $q d | c"Create a new  ionary with the merged keys# of *d*n Qand **, which must both be0ieseo k g take priorA#Osharj.fUNew in version 3.9EOd |=%0Upd2*d*Ofromg,  ay!ei a *mapping* or an *iterable*$)Akey/m Cpair,sNmo /? /ADict e1 if@only they havesame "(keyS1)" f (regardlesfordering). O 3(‘<’p!="V ‘> ’) raise "TypeError" >preserve inserV `. Not7/atuKPing a-does not affectaK9dded after deleueSab?end '  >>> d = {"one": 1, "two": 2 0hre3, "four": 4}\n' 'O!"!a{'one'hQ'two'h 'thp': 3, 'h'h"h list(d)n [n!, khe?]\nb.values()k0[1,3_3, 4]("[no] = 42-! O 42P+adel d[&ONone! k}a+Changed in version 3.7: Dictionary order is guaranteed to bPinserSP. This behavior was an implementa,edetail ofPython from 3.6.*& ie6d dviews are re2?ble`YOed(d[ Qwo', {cllm 4,,O2, 1'b@itema(S4), (2, 32 O, 1)8ore now%See also: "types.MappingProxyType" can be us!create a read-only4Q_ of ap~"dKuibjects- '====\\n' 'The objects returned by "dict.keys()",PvalueO andP8Bitem(re *viewe *. They provide a dynamic ;_n thepionary’s entries, which means that wheG 2rchanges,oAthe Arefl5cthese 6.6BDictSs can be iterated over to yield/irrespective dataand support membership tests:@len(E)#A Rc0 nu4 of, iO7-#an~#or~0he ", 0 or"/ms(represen/as`tuplesS"(key]?)"),p Keys,arQin inser| order.This allowrhe creaLAf "(',4)" pairs using "zip()":l"*=2=!d.]cs(), d)". Another way/edSsame list i [(v, k) for (k, v#d./]"A I@s`le addor delet B9may raisi"RuntimeError"@fail3<2ate?allCQdversion 3.7:  is guaranteedb- xO#"True" if *x*punderlyamr or items (in the latter case, *x* should be a "(key, ' 'value)"\n tuple). reversed(dictview)( Return a J iterator overakeys, @s or"/ms of1lionary. The P will:xUed inorder ofm?thejinsertionM ChangYion 3.8: DicO1arys are nowKOible.mapping"types.MFProxyType" that wrapsoriginalf to whichM refers` Newp/10CGKeysset-like sinceir entrieunique and_hashadIf all1B, sod3r)" pair{q_2theBitem is also P. (Vhpnot treated asUK Igenerally 8.6Forc,\G0 opions defined folabstractbase class "colles.abc.Set"Pavail (jexample_"==",l@"<",)?"^"3An tk usage:s" >>> dishes = {'eggs': 2, 'saQ': 1, 'bacon ""'spam': 500}\n"'l-# =s.(1%.5|# ra( _n = 0" 1valalues:\n'  q' ...n += val\n' )>>> print(n)%?5040 W# keys andues are iterated over in the same order (insertion%xPlist({'" ['eggs', 'sausage Pbacon spam']\n"3dovaluesf\Q[2, 1O500],Bview object?qdynamicVreflect dict changesPdel dishes/(2a{ hg# set opJ?ion E & {oalad'}"{'+"`8^ {K_juiceZ " v' get back a read-only proxy formoriginalkLoionaryi .mapping+B (7: 2:"h u!"': 500}) [9 500\n', 'typesmethods': 'M "'*P@funcas thatcalled usingattribute@notaB.mQThereXtwo flavors: built-in  (such as "append()"o0on class instancebL. Budescribedo@with:psupport,m DIf you access aD (a  defined"a namespacethrough an,|a special: a *boun* (also\n'  'called *instance method*) object. When ', it will add ' G 'the "self"\n argument to ,list. Bounds have twokspecial read-nonly attributes: "m.__a__" is on whichiperates, andfGfuncftion imple?ingl .m@Call="m(arg-1, b2, ... !n) colOtelyArequivalkk0.__6__(CmgPLike _"Gs, b s support gettarbitraryo. However, si5 are actualHstored onnpunderly 0 ("Y__"), s-/odj>sdisallowed. AttempBt`Oet ajia results in an "AyError" beAraisIpPorder4sp, you need$explicitlyJ it?theI:1 >>> class C; A3def()27Opass/..o = C()@"$.u.whoami = 'my nameV' # can'ttOon "0q' Traceback (most rec_ last File "", line 1,y 2: ''yv has no""'#?'\nfPSY K* Kx'my name is method'\n" O'\n'-See The standard type hierarchy for more information.\n', '+smodules': 'M i*only special operb on a { is attribute access: "m.name",owhere *m*R^Pand *7*\Pes a  defined ino*m*’smsymbol table. :s can be assigdto. (Notelthat them"import"`tementnot, strictdaking, aniH}pobject; x foo" does not require/Td*foo* tonexist, rather ias(external) *i*ammk"d Asome3/.)-Aof everytis "__dict__". This>ionary containing#e 0ify'jikwill actually changeu ,but directD!to_/E3ppossible (youpmOwrit?$m.[\'a\'] = 1", whichs "m.a" to"Jocan’Pw = {}"). *, lyq/noirecommended s built ininterpreter are pten liki". If loaded from a file, y|a"@ \'osZI\'/usr/local/lib/pythonX.Y/os.pyc\'>"R'0seq#Sequence Types — "list", "tuple r6"z'B*************X\n' '0There are three basic sequence types: lists, tuples, and range\bobjects. AdditionalN tailored for processing of nbinaryAdatatext strings described in dedicated sec.s.LCommon SQOperaQ>=,UThe o^the follow%Btabl`suppor}by most>f, both muTSnd im . T"collJDabc.^" ABCg isvided to make it easier correctly implement thesegon customjRThis Hw" smin ascend !priorityz!InZjQ, *s*1*t*s2sam~m, *n*,N*i*, #*jWkWintegersl@x* i arbitrary N tha?@meet/@Tvalue rebposed by lA"in"SP"not |0hav!e fmies as/thcomparison^"+" (con)n)-*"\a(repet) y2spoEnumericP ^. [3]!/+- 8 #+`%| Y | Result 1r| Notes,|pMO===|  #`0 "xe"s" | "True" if an itemi4(1)Epp| equal*x*, else "FalsepH |\n'  ?'+- 8 #R+\n' Y'| "x not in s"| "False" if an item of *s* is&P1(1)O |p | equal to *x*, else "TruepHp  ' #@Us + t | the concatenation?and *t* R(6)(7Ce* n" or "n *pivalentaadding"to2 |7| itself *n* timet-p@d?[i] | *i*thH, origin 0"(3 P  ' #O[i:jt| slice@from1*j*"(4fO:j:k&5 with step *k16@`  ' #olen(s)| length /mismallest9-+-----------+h+\n' '| "max(s)" | largest item of *s*P|p   !)--#s.index(x[, i[, j]]!| the first occurrence0(8)|| *x* in7(at or after> pMp i* and beforeg5*j*p p ' #scount(x| total numbers@? @}b@Sequ!same type also support comparisons. Inparticular,fatuplesllists areSed lexicographically by>ingNcorresponding elements. This means that toFe equal, everyQCD mus3Utwo s,)b DfUnd have 8( length. (For full details seehC? infhe language refe..)*qForwardr,0sedrators over mutable maccessnvaluese us"ano@. Tkwill continuesmarch f>(orP@back)An if[punderlyk autatedv\1itee terminates only when an "I=aError"q "StopIIoion" i!enered (orNdrops below zero).nNotes: '1. While the "in" and "not operations are used only for ' 'simple\n containment testing inu general case, some specialin Msequencesh(such as "str", "bytes array") alsomO4subp:)>>> "gg"o"eggs"*?Tru8.2. Values of *n* less than "0"qtreated0" (which yields.and empty of& same type\*s*). Not;at items /th& _1*s*tpcopied;pyPreferd multipleotimes.0Thi,ten haunts new Python programmers;_siderlists = [[]] * 30 ,!R[[], ]$E[0].append(3).!0[[3tv9What has hAed i0t ""a one-ele ?ingf#an= all three Xty }?/@to t"gsingler. Modify0anyp"{"@s" m= ie3is _. You can c0 a ? ofP1dift&O?way' irange(3)so%[15%[2.7.%3 5/7]9Further explanvailable&FAQ entry How do Ihdimensional?>3. If *i* or *j*negative,'` index1rel ]e endg ' sequence *s*: "len(s) + i" orj" is substituted. ' l'But\n note that "-0Htill "0".14. The slice of from *i* to *j*defined as t/ .ofc items with index *k* suchi <= k < j". If~!or~ c/iscpgreaterQn\e", use[is omitted b"None",gP0K;w ior equal,is empty5Astep7is  ?the!.of "x = i + n*k"0neadPb for other types, investigaahe relevant classdocumentd7. Some sequex (such as "range") only support item|Csf that follow specific patterns, hudon’tl gf ior repeti.18. "index" raises "VbError"*x* is nound in *s*. Not>allf@ is@passc1addaal arg^s *i*enbPj*. TheseAw`searchtof subsec/\/of7. PWextrazis roughlypequival/togu"s[i:j].0(x)Sout copyany dataX B-hpreturne`dex beOqrelativptart ofF; h rafBthan= JOliceU$ImSTC*=*2The Aoperei~ A genuf,cDalso.nted by muta ble sequence types is ' 'support for\nthe "hash()" built-in.(TThis \allows immutas, such as "tuple"instances, tohqbe usedBdict" keys and stored in "set"q"frozen jAttempting to $? an that contain un;values will resultTypeError"XMSRs(=(The operationsJ fo2 are defined on  g . nq"collecpS.abc.P" ABCprovided jNmakefit easier3 correctly implement theson custom ~ Inr J0*s*{)U of aMq], *t*i/yhAiteraobject@$*xoarbitrary AmeetO fCh2tri\o0by (for exar, "bytearray.?onl`acceptbtegersJ "0 <= x $_255")y/+- !/--#+G4| Or |RU# || Notes/ |-|  #o "s[i] = x"| item *i*Fis replaced `by |8(m;" ---------+---- +h+\n' '| "s[i:j] = t" | slice of *s* from *i* to *j* PSis |; | %  | replaced by the contents ~  * Using a pair  qubracketsRdenot9Qempty:#N"[]"ewsm`, sepa#ngwith commas: "[a]",y/a,go b, cav`prehen}xmxl!7typQor: " )" a)a6#coor builds @whosAsame -inS4 orgDas *C*’g'.  meitherfa@0, atr that supportk'$on J?torb?X. Ifis already7 py1mad.\n'  (' returned, similar to "iterable[:]". For example, ' ;'"list(\'abc\')"\n!es "[\'a\', \'bc\']" and H (1, 2, 3) )"lH&l3'If no argument is given, the constructor creates a newp_emptyf~, "[]".  Many other operations also produce Us, including O"sorted(kbuilt-inpLists i+aall ofzacommon0mut sequence*y2 gAvidec`follow@addial method:F0  (*, key=None, reverse=False)5CThis}Vs in place, us~only "<comparisonsgbetween items. Excep s are not suppressed - if : ihR failaentireQ will% ( l?thee?likely be left2 a partially modified state)%b`()" ac)Fs twqat can Qbe pa9b )word (key -:,/s)y *key* specF@funcD6one1thau aoextract a  from each6A eleM(fore"<str.lower"). Thefcorresponor hhis calculated oHoQthen n hprocessEe default value"c" mean6z fY/eddirectly withoua separatF\~"Jools.cmp_to_keyputilityQavail-toconvert af '  2.x style *cmp* function to a *keyh.\n' '*reverse* is a boolean value. If setd"True", then bOlistf elements are sorted as if each comparison were dThis method modifiessequence in place for economy of_spacewing a large c. To remind user]at iteoperateshby side effect,Cdoes not retur%ed g?(us"=0()"explicitly r2st a new _instance)!e {yis guaranteedbe stablA|<:]&itX<to changerelative orderc/ofCthate equal — tis helpfulso6 8/infmultiple passes (rxample,by depart_-byosalaryhOgrad1ForePs andAErieftutorial, seeSortingoHOW TO[**CPython i#a#detail:** While0ist be ?ed,$th@`attempmutate, dven insp5 hUiundefinedYLhe C3of 3makT ioappeary1dur6,0rai{ "VcError"Z=can_detec-chas been 3Pd dura>OTuplV=0B im&bls, typicallyNstorQcolle/s I heterogeneous data (such$2-tuples produced by the ' '"enumerate()"\nbuilt-in). Tuples are also used for cases when immutabllsequenceg-of homogeneous data is needed (such as allowing storage in a~set" org"dict" instance).#pclass t`([iter.]))$ 6may be constructednumber of ways:Cp * UsQa pai>parentheto denoteRempty:+t PtrailQcomma a Tletonk0"a,s/a,jupSeparatoitems with zs: "a, b, cj#"(_H"4)" &: .or1u'Th!oroBds a9r whose lsame and in;4Porder:*R*’s_6.  ^eithead0, atainer that supportkon, or anSt object. Ifi Tready8@, it3returnedunchanged. For example,\'abc\')" Fs "(\'a\',0\'b!\'0mA [1, 2, 3] ]0)".no argumentp/isd`given,[@reatW new o, "()"B ND#at\ractuallI which maknN, no/th7  . loptional, except8 %1whe6y_cto avoid syntacticambiguity?+ Qf`a funcR callNthre%/s,while "f(a/)"bwith a 3-tuple as the ' |'sole\n argument. Tuples imple8q all ofu common sequence operations^ For heterogeneous collecBd data where access by name is~clearerGthan@index, "l.T dt()" may be a morEappropriate choice c! s& Io objecgnRanges=`The "rG" type represents an immutablef number!d`ily used for looping a specificU0timK}n "for"b<:aclass n(stop) #Part, *[?ep]2D%he3As toy constructor must4PintegB z_(eith built-in "int" or any@[t~1"_____()"al method). Ie*step*Yomitted, itpdefault hG"1".[?art\L] "0".m/Ifdis zero, "ValueErrTiOised0 a positive ],Acont0Bof an~ "r" arpd_mined!byR formula "r[i] = start + #i""i >= 0" an;AP willempty if0]" does not mee vo ".  do support kuindicessOay interpreted as indexing from the end of sequence ' 'determined by\n! ?positive indices.* Ranges containabsolute values larger than "sys.maxsize"?aredp ttut some features (such as "len()") may raisL"OverflowError" examples:>>> list(r)_(10))+[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]6 aO, 11daO, 10e0, 30, 5hS, 15, 20, 25_1c_ 3@0, -V- %, -2, -3, -4, -5, -6, -7, -8, -r ?1, 2 G(iment all9ucommon @operationsoexceptbconcaten: and repetiI (due toi@fact !t  dobjectsepan only\0ressTfollow a strict patternf?andb will usually violatew Uw)_OstarXS Th^*Ap* param (or "0" i)/wal not suppliedNstop'op9o stev,ev>1>W H>9 advantage"range" type over a regular "list" or ' '"tuple" is\n0that a "range" object will always take the same (small) amount O.ofcmemory, no matterNaize of } it represents (as a>nlycastoresL"start", "stop" and ep" values, calculating,individualfQitemsQ1subs as needed).1Rgfs implementcollections.abc.Sequence" ABC,yQprovide featu@suchrcontain^sests, em]index~lookup,c@slic+Jsupport for negative 4ces (see Types —j?isth!, Y.):r>>> r =3P(0, 2))k8 ~11 in r>^False/104?Tru3!r.?(105gNr[5].10?r[:/1= ?[-1k8k1TesljCequality with "==!=" compa othem as0Ps. Tris, two yare considered = if?thekxdp. (Not8'at omight have differ8 en"step"attribut xa T(0) =[2, 1, 3)_G32G0, 4, 2)". Ch.dKversion 3.2: IhqcABC. S e  . @ "inQsmembership dUNtante0tim'Pstead&Biterthrough all `G 'Changed in version 3.3: Define ‘==’ and ! to compare range ' 'objects\nbased on the sequence of values2y d|(instead H?ingc identity).,=New The "start", 1op"@"ste ttributesbSee also:}@ * linspace recipe shows how to implement a lazy-ofh suitable for floating poiYpplication, 'typesseq-mu8R': 'M $ ST% p-/'*0&Boperc`follow _ Ww.r"collec$Cabc.  " ABC isvprovidedOmakevit easier+correctly gthese /onwocustomI0*s*0an a,a utC, *tGyxAiter #*x8 arbitrary Othatvmeets any xr restrio0by (e0exa,t"bytearray" onlaccepts integerJ0at T_ "0 <= x{<= 255"6/+- !/--#+w4| O |jResult. y| Notes C|= | ?===#w "s[i] = x"  | item *i* of *s* is '  'replaced by |?|\nA3<|5*x*& \/+- !/--#+w| "s[i:j] = t"t| slice2froQto *jD?thecontents(Diterabl/*tE<:!$%Bdel ($game asM )[]B/:k, | gDelemws:k]" are?(1)} 0*| *!osP Zmoves of5 3QL4Glist; 0s.append(x)"  | appends *x* to the '  q'end of#I | ?|\nA3=| sequence (sam%as4 \+"s[len(s):?] =S[x]")!/+- !/--#+ "s.clear()"| removes all itemsfrom *s*E| (5T+as "del7s[:w  Q!(?opy | creat shallow@copyAa" t!'extend(t)" or "s += t8"| sAwith-contents 3| *t* (forOmost$Apart&w! QW<\S *= n Q| upd$/it6$6O9  | repeated *n* '  h'timesK |?|\nG/+- !/--#+w| "s.insert(i, x)""| s *x* into *sbat the< 3QZindex given by *is(same a\3"s[i:i] =!U[x]")2 \:!$'pop()" or1 i+*qtrievesitem at0and O| (2 9O| also remoit from!s*7\t!'(*afirst $/(3?`where 0]" is equalhxPverse.S *)Os of!inCO| (4?Cplac~ QB 'Notes:\n' '1. *t* must have the same length aslice it is freplacing.p'2. The optional argument *i* defaults to "-1", so that$by5w last itemremoved and returned"B3. "M()" raises "ValueError" when *x*wnot foundoin *s*"4["reversemethod modifiePequen n efor economyZ of spaceing a large sr. To remi@useraw perates by side effect,Pdoes n&edw5. "clearxWQ"copy re included Tconsistency@withq interfaces of mutable containGdon’t supporL0slir otions (suc9a"dict"K`"set") H@part?thew p"collec4rs.abc.MSZ" ABC, but mosconcrete,u P clas@provh/it" New in ion 3.3:6sj"6 v1 *n{!an/ger, or an objec,Pimple?ing( "__index__()". Zeronegative & ItemsO3A arepcopied;Dy0ferd multipl `times,2@expli"s * n" under Common OQ , 'unary': 'Unary arithmetic and bitwise operations\n' /'* 6 All unary arithme have the same priority:_  u_expr ::= power | "-"H| "+ ~ I 3TheLs(minus):or yields1negM of its numericPargument;4 can be overridden with%"__neg__()"{specialb{method. o+" (pl unchanged;`2pos c~" (invert$@sion r,ituinteger0. AK"x" is defined aL"-(x+1)". It only applies to j0ral>pbers orjcustom]objecDthatFS1"__teXIn all three cases, ifdoes not prj type,a'"TypeError" excep?Qraise, 'while': 'v"p" stateK T $ Wused for repeated execuas long as anQ!es^is trueQ_stmt`assignV":" suitey ["else" 2]3 EThisrly test1and  it&,*es,thRfirst;M[is false (which mayQ: expression.\n', 'with': 'The " /" /'* n'R is used to wrap0iona block Pmethods defined by a pext manager (see sectOoWith S{P'Cont9M9s). This allows common "try"…"except yfinallyj'usagepatternsbe encapsula0forvenient reuse4 M! U_stmtWD ::=V( "("$_nts ","? ")" |-N*R) ":"} }/}_item (",/)*B  ["as" target]@ Z:   one “x” proceeds asS!fo: 1#e:(Tgiven%)")i evalu"to obtain) 2"__enter__()"ploaded r] 3] ?xit\'4\ invoked s5. If aW was incluu,ireturn  from \Passig_to it  Note| 5 guarantee,Bat i( u'@ _s9out an errornwill always b called0us,N occurs dur,,/thP list, it bbe tre0he same askgTwould be. SDtep 6 belown' '6. The suite is executed.\n' '75context manager’s "__exit__()" methodWinvoked. If anO exception caused t`to be U ed, its type, value, andNtraceback are pasRas argumenCo. Otherwise, ]three`g"None"Ogosuppli:   wasited due to an  ireturn Afrom2n0falu)is[mrerais V tr U re nontinues withPstate following"""L/ \ for any reason o[ than   is ignor3andrYproceeds!atnormal loca7qkind of0tOaken gZcode:{ " EXPRESSION as TARGET9DZSUITEE is semantically equivalent toT :$ F = ()'qenter =B(A).__.__0?xit/ .!= N_ 'Bhit_{@ = F # k tryTp" =  8&woU >TruXaif notg, *sys.exc_info())a?` 0fin7r'^&,   W~@more=n one item,u Q!e *ifOmultiple  s were nested Ck0A()bBa, B b7?  Qis semantically equivalent to:\n' ' with A() as a-6#B#b#*ZSUITE` "You can also write multi-item context managers inple lines ifQ@the <s are surrounded by parentheses. For example Q(&,!)tL? 0pChanged  version 3.1: Support for"?`expres-*s. ]0^using group T: toP`break `statem~  1See . g **PEP 343** - The “E” | 6! +specification, backtnd, and$s[xPython B"l"`|, 'yield': '""? '* f Q ' U_stmt ::=@ -A is semanticaL" ab& 'olbe used to omit6 \hat wouldotherwise be rr u ',H0s  Ofrom# 2'tob\()o3  % 4Y sG1Bonlywhen definOaM*generator* func F!in qbody of % 'G `TA. UEin ap{ `uffici*toF[causebtBto create a lpinsteada normalQ   'For full details of "yield" semantics, refer to the YE ' 'expressions\nsection.\n'} '''A multi-producer,consumer queue.''' import threadingypes from collb#s /RdequeTheapq apush, "op$Dtime#monotonic as Q try:n_.pSimpleQ except IRError7$ = None __all__ = ['Empty', 'FullO PriorityELifo XO'] daclass $!(EBion)' raised by .get(block=0)/get_nowait().bpass e d`'pu`-pu`\]'''Create aO object with a given maximum size.  If is <= 0,infinite.4)`def ____(self,M'=0PA.maxN=#KFF(%) # mutex must be held whenev#he is)ating. All methodsg# that acquire.Wrelease ibfore returnLFpis sharaetween0pe condiSs, solwing andCq]55 al6 es5 +e"ex5& =/i.Lock(?Notify not_ez=pan itemTadded7; a0ad Po get9n^i<;hensC#1.Ofullremoved Da/puv!tasks_done`numberluL sh5-Pdrops_zero;jjoin()y@o reHH U>_B = 0'''Indicm formerly en d > coLTUlMrs. For each@() u0pto fetc[,N`a subsnt call to task_done() tells the queue thatprocessing !ontask is complete. "If a join()"!urrently blocking, it will resume when all itemsIhave been ed (meaning a _done() cCwas receivedJfor everyb<3had] ut1nto)Raises a ValueError ifned more timeAaqre werelplaced i#i.5''' with self.all_s:"unfinished =.5I - 136if $Z <= 0SW $#'r ('ed too many)')F.notify_all(1-=2def~1)@'''Bvs untilpQu@gott&ndThe count oX s goes upz1 an1addow&. VBGdownD@ con2r threadsPto indicat trieved and`work oWdrops to zero,A) uns)_whileN 7v.wait()`qsize(* RReturapproxim=. (not reliable!).Zmutexrb{".__empty@Truex1is 4, False otherwise!This methodlikely to be remot some point. Use U == 0dadirect substitute, butP0awaM ei Xach risk=EraceOconditioBre a& can grow befnh1sul{U() orI9xbe usedPo cre0codqat need- /Ld_b d, preferr`echniq4 usce{ <{@Ofull?e is full, False otherwise (not reliable!). 6This method is likely to be removed at some point. Use qsize() >= n L as a direct substitute, butPaware that ei approach risk=Eracecondition where a queue can shrink befoTsult of full() orJ:be used.5''' with self.mutex:return 0 <# ax2 <=_g^def put(N, item, block=True, timeout=None)i'''Put an3 into thePIf opal args ']'true and 'ei (Ldefault),< if necessary until a free slotZPavailEI. If_Ka non-negative numbersOGmost> seseraisesNFull exceoww "infOs,f+ ),uo@sois immediat20, e| ( Ktgnored Vcase)@not_="ifm:> 0!%".X6:DelifOIRwhile.wait() <%ValueError("B mus"r/se0end! =A() + =out*remaining = x-o%n if8_<= 0.U)8# =*_MGunfinished_taJI+= 1;Cempty.notify()$geRAfromWy until an item is available. If 'timeout' is a non-negative number, it blocks at most>seconds and raiseN the Empty exception if no i'wa within that .Otherwise (' false), return anU`if oneimmediatelyKb, else (  ignoredHVcase)5'''# self.not_e:o Y A_qsize()&*uh `AelifJ0outNNoneBwhile notk .wait()u>< 0qValueError("jmust be "js0end=! =A() + 9out8remaining = d-[ Z6if 4_<= 0. )+ x^ Z=,geJ@full;ifyQI def put_noC'emf'''Put1ntoWQqueueBing.YrOnly en(x&a free sloG$LJFFullzP.put(~,!=Fb)ge bRemove Ofrom 'geG  O. # Override se methods to implement o organiza  # (e.g. stack or priority2B`# Thes.@ll obe calledB appropr Bheld# InitializZ represent&`_init(P, max_.= deque()f<%4I1lenW?6!# C neweV ]Qq.append]G2mqueue def _get(self): preturn .queue.popleft() %p__class<item__ = method(types.GenericAlias) " PriorityQY({'''Variant of  that retrieves open encs in pM order (lowest first).E/are typically tuplQf the form: (Pnumber, data).2'''Qdef _ini8, maxsizeD:W = []7q*p1lentkm$puloiheappush8!, $t?'op>ALifo0moscently added.J.append(G<0pop%_PySimpleIa2''', unboun RFIFO kThis pure Python Gpmentati@s nog 6ant# Note: while tL@versEprovides fairness# (by using a threading.SemaphoreWch is it?@, be2SbasedH7 on@PCondi!),2qE1parAPI contrac!# aallows$C to use a different+H!__F!._ = deque()Mwcount ='(0  , block=True, timeout=Non.a'''Putt6e`The opAAal 'Xs' and 'X`' argu$ s ignored, a52is Rnevers. They8d compatibility with{6T Q!Wp.releasuBaRemove!an Q from`&IfPEargsUbis truM]0is  (default),N if necessary until is available. IfizGa non-negative #itA at brsecondsFaiseNEmpty exce= if no item was available within that time. $Otherwise ('block' is false), return an item if one!immediatelyKo, else raWthe Empty exception ('1outmuignoredHVcase)6'''#f0outPnot N5andE< 0:0ValueError("must be a non-negative number")H0if mself._count.acquire(=,)|L\Lqueue.popleft() &def put_nowait(*,^f'''Put@nto sQ%Bing.Y@This= exactly equivalent to `put(0)` Vis only providfor compatibilitytQo classp!, !=F)ge aRemoveTAfromO'geKT%. ;Tc2getC e= @Truev1is 4!, E& o@reli8!).S91lenl!._Mf) == 0Qqsize!approximate .7 of(~!__J@_getB__ =\method(types.GenericAlias) if Simple!is)W= _Py #! /usr/bin/env python3 """Conversions to/dquoted-print^& transport encoding as per RFC 1521.""" # (Dec 1991 V). __all!["Ae", "decod fstring ] ESCAPE = b'=' MAXLINESIZa76 HEX0123456789ABCDEF' EMPTYSTRING"b' try2binascii ima2b_qp, b2a_qp ! Ii<'! =21 PneedsLping(c, etabs, headerw"""Decide whe a particular byte ordinal T0 toPdQThe 'b' flag indicatesZembedded &espaces should beId. Notekqline-en =are always!3ed,!N%*aPasserinstance$s if c in b' c\t': return quotetabs# if header, we have to escape _ becaus wis usedQspaceGif c == b'_r_(, ESCAPE or not (b' ' <= cb'~') def2(c)@"""Q a single character."""eassert isinstance(c, bytes) and len(c)==1.c = ord(c)+8((HEX[c//16], %16])) encode(input, outk,cf=FalseaRead '6', applyd-printable \Aing,Awrit'f1'. F$ are binary file objects. The 'a' flagG indicates whether embedd1abs_s should be@. No1hatKline-ending p<balwaysed, as per RFC 1521.EA !we( Gas _UOA1522(if b2a_qp isBNoneh4qdata = b.read(#o@(,=[A$.(N%sY= , bEnd=b'\n'V#E requires that the5  inHtab must!M;@railp+3if "[-1:] in b' 's[:-1] +=!(s:1) +6End!el`f.f S}/(sEs ;sy@prevh0 =  whM1*!*.!if_5}QbreakT0out#U = []# Strip off any &Pinduc0new:s8@ped '!if\i+\nOG" ='< W&\nY# Calculae un-length-limited2YTPfor c,v V((c,) T@eeds0ing v3S( ).append( ,eld7o# First, >zJious.0if , write(prevline) # Now see if we need any soft , breaks because of RFC-imposedIlength limitations. Then do the thisRB->pru dance.E" = EMPTYSTRING.join(out=while len(7) > MAXLINESIZE:X # Don't forget to include `=' sign in Jacalcul!"Uwrite'[:A-1],XEnd=b'=\n'% =1[@%:]l0# Wj@ outr curren%mQ =2las:`, withTa trailing new:5if Uis not Nonep$stripped) def encodeng(s, quotetabs=False, header)_if b2a_qp zcreturn# T^X_from io rt BytesIOTnfp ="(s19out`(infp, y+H.getvalue()  dea(inputK """Read '+', applyMd-printable Qing, and 'output'E# are binary ftrobjects2BIf ''Rtrue,l e underscore as space (perB 1522).""" f_f a2bqdata = b.read(F3o@(,.(9Hnew = b''l1G  !if:BH;i, n = 0,"7A > 0-1:n] =6\n'KppartialN;U5n-1h!0# SsQwhite (n{in b" \t\r"~au7els"oZi < nS1c =f[i:i+1IBif c!_' v A)+ b' '; i+&!elQ!= ESCAP."B=O + cE0i+1n [ = 1;qN"< Mqi+1:i+2$2 elif i+2 < n and ishex(line[i+1:i+2])2:i+3]): `new = + bytes((unR3]),)); i = i+3Delse: # Bad escape sequence -- leave it in7u{c^1'if not partialoutput.write(H+ b'\n')>a1b''P&ewH D) def decodestring(s, header=False@if a2b_qp isFNoneYcreturn#CJfrom io import Bz"IOTnfp ="(s19outq(infp, #n!.getvalue() # Other helper functions \cB"""Rtrue if the5 ordinal 'c'a hexadecimal dig ASCII."""assert isinstance(c,Nb'0' <= cb'9' or b'afA"F's1Getinteger J of enumberbits = 0for c in s2c =R((c,)=if 6" =B7('0e 9Ra')-1Q< <p qexp, pi Qpi, e qe, ceil MAsqrt a, acos $, @cos,>sinH0tauTWOPI, floor_ , isfinit Fo)8 #q_collecD_abc "SecSet, SX? @"op8Qindex( %itertoolaccumulate a s _accumulate, repeat as _  from bisect import% !os:$osD_random try: # hashlib is pretty heavy to load, try lean internal module firstFt_sha512 except ITErrorfallbackuofficialHlementationhH ] __all__ = [7!"R"",jSystembetavariate'[choicsKexpo0LgammDEgaus40get8bit'stt{lognormZ+al\paret`5ytea4int(omErangVsampl4eed+9setVshuff+triangular1euniforkvonmisesgweibul-] NV_MAGICCONST = 4 * _exp(-0.5) / _sqrt(2.0) LOG4 = _log(4*SG=T1.0 + 5) BPF = 53# Number of  in a float RECIP_2 2 ** -BPF _ONE = 1 class I(\.)#""|" nggenerator base Bused by bound ^0unc1s. U%to instant 0cesyCEget is that don'tIashare [C can also be subed if you wantcuse a different!ic_yyour own devising:a case, override the followingImethods: (), seedg Dand 1().< Op;Vally,H7 a 2() b2 so#g!()E c arbitrarily large$ge2"""VERSION = a$# /1 def __init__(self, x=None@"""Initialize #ce$P argu4 x controls5@ing,$3for.L0D "x _next = R:1, a, version=2iV KaThe only supeed types ,,Ptr, b , , Warray`>f or noBs1cur@time'@n opm\ specific(domness sourceIavailabl If *a* is an int, all bits are used.  For version 2 (the default)90of  @ if *a* dU str,Obytes, or array. e1 (provided for reproducing randomMsequences from oldes of Python),algorithmWustr andLs generates a narrowerv geOWseeds6""")%if(@== 1] isinstance(a, ( Es)):zia = a.decode('latin-1')H D) else aCx = ord(a[0]) << 7>a+0+Wc in map(ord, aQ@((103 * x) ^ c) & 0xF _x ^= len(a) -2rx == -1xD*elF2F ,ME Q+if}?strAa.enx@int.[_w(a + _sha512(a).digest(), 'big');not(type(None),zafloat,#s_warn('Seed based on hashis deprecated\n'| 'sinceA 3.9` wie removedRa sub_/t J. The only supported ? i : ,^1and(&.'XDionWarning, 2super().self.gauss_next =def getstate()K"""ReturLaernal (; can be pasDto sC) later.ArE^.VERSION, }1), "_"Ubbject eg)" =5[0]k 38( XU 6intD B7E# In2Tp was sa; 1ignEts, which causes# inconsistencies between 32/64-bit systemseliHreally uns{!32= in so we convert negative ints from # version 2 to positive longs for )3.;Itry:Winternalstate = tuple(x % (2 ** 32)TYx in -)Lexcept ValueError as epraise Typ&) eKsuper().set(w;elsa]!("AU with%s passed>"z v"RandomG) ofJ?" %A (, self.VERSION)) 8O## -#? Methods below this point do not ne be overridden or extendedNwhen subclassingthe purposeu a different core generator.  pickle support " Issue 17489: Since __reduce__ was definfix #759889Ris no"er called; we leave it here becausaN"ensvr rPrewritten back!2001 and why risk breakEsomethingsdef __g0__( Q): #o hbreturnD4"()"J-J!, Qn,Or`!__"c__, ()5;!odevenly distributed/AgersTinit___(cls, /, **kwargs)s"""Control how$es#e an.jrThe algorithm a>P can %depends on J ()1/orH0getbits() implementatavailable it< determinesDpwhether~e - arbitrarily larg\branges6"""8ccls.__mro__K/Qif '_f',|.__dict+/# just inherit it c1d: = _d#&itR//om~2?outrandbelow_wit h_getrandbits(self, n): "Return a %om int in thege [0,n). )s 0 if n==0." GFot nY`r\0'0 = .' k = n.bit_length() # don't use (n-1) here becan can be 1FGr = ^!(kF0 <= r < 2**k,while r >= F5rPdef _Ebelow_without, maxsize=1<g(), orw?().i c bytessE1]2""G3e n^.[D (n * 8).to_an, 'little') uinteger 3start, stop=None zep=_ONEC=2temOI[E]~TQfixesproblem ;.) which includ*A1end;APythis is usually not what you want. 6""" ## This code is a bit messy to make it fast for theH)# common case while still doing adequate error checking.AEtry: istart = _index()#except TypeES= 0_eturn self._bbelow( Jjaempty <@H()")& supplied(op&op;8Oo?theRapppwidth =@op -5art=e=e=;=8i='=/ep=arn('non-int'eger arguments to randrange() have been deprecated ' ''since Python 3.10 and will be removed in a subsequentKversion',hDionWarning, 2))# Fast path.if istep == 1:if width > 0`return=art + self._ abelow(;}3aise ValueError("emptyU`ge for _R(%d, )" % (istart,s2op,5)) # Non-unit  supplied Bn = +jep - 1) //n%el;< E+E*se[r$Bzero ""^|if n <=MqO "*n~1def@int(v, a, b)B"""R0!aom int] in9@ge [2 ], including both end points6"""v.\MB+1) (O## - ice methods 'Ccchoice:seqChoose apdom ele6 from a non-}v.!# qs Index0 ifA is 9z!q[u@len(&)]dshuffl#x,Z=NoneS*p list xaplace,v6.]Optional&^Ea 0-@func+ Ha an3Pfloatw[0.0, 1.0); itOthe defaultee, theCstandard %omd us.{ isZV, =C(i re2ed(01, 7x))n1# pick an0in x[:i+1] with which{@exchzY x[i]zI1j =0(i p %:, x[j] = M,el_warn('The * om* parameter^s/\n9`).!6floor = _ 0 for i in reversed(range(1, len(x))): # pick an elementA x[:i+1] with which to exchQ] x[i]Ij = floorvdom() * (i + 1)).C, x[j] = 1i] )def sample(self, population, k, *, counts=None """Chooses k unique randoms from aS sequence or set.(Returns a new list containingS8theUQwhileI@leav3%original."un[d. The result2u%isJin selec ! order so that all sub-slices will also be valid Ldst is@ows raffle winners (*)be parti%edL`into gm prize and second placQ"ub)o@Membs0of u need notqhashablA. I3;s repeats,\n each occurrw possibk in8RV&ed0canspecified one A timW opF%alaameter. For ex:U(['red', 'blue'][4, 2], k=5)9is equival/toT [ iq bATo c# a/t of integers, usge() ford @arguaally fastppiefficientJZ.RHlarg 2(10W), 60M6"""Z0# Sc0outs e8ls track%either potenti#Ppool)aor previous, ins R# Whe nu^ps is sm9compared&th#; Hw0, rcEring`# onlyn"se an@asio%reR?!a /r  &_wmethod ;#50fer siatakes less sD1tha6it doesn't sufferfTs)#0cal0o _5pbelow()@kept0por near  theoretical minimum. This is important because running time # is dominated by _randbelow() and@it extracts thCleast entropy from! underlytTom number generators. Memory requirements are kept toTsmaller of a k-lengthDset or an nY listhQThereZother samplalgorithmat do notfauxiliary mP, but0y w\QrejecP|they mad6too many calls{P, makthem slowed"to eat more thecessary!ifisinstance(population, _Sequence):n/?if 2t-1_warn('S` a `deprect9\n'f9'since Python 3.9 will be removed in a subst version.',WD{`ionWarM, 2)-x = tupl% /Jelse+raise TypeError("PdP must l. For di_ or%0s, sorted(d)."wwn = len`if cou>!is;NonCcum_$=!p(_accum"e()R!ifq:o) != nCValuD'Theo2doePmatch= s'|total = }Z.pop(%7O, in "'C4integers1if W_ <= 0`greater KzeroiPselecs = self.e(range(j), k=kbisect = _ return [j[&([p, s)] f]]K#$0)k +'"(de largwegative Presul[U] * ksetsize = 21!# BOlf minusqn emptyNif k > 5d+= 4 ** _ceil(_log(k * 3, 4)) # tablec^0bigzs_n)Q f;# A- a k-length gset. # Invariant: non-selected at pool[0 : n-i]8 = list(population)$for i in range(k):0j =dbelow(n - iD%result[i] =j$%[j"J - 1] # moveitem into vacancyJelsej= set(P_add !=E.addS  hDpwhile jRw % VJ?.(j r[xrreturn ) def choices(self, , weights=None, *, cum_7k=1#B"""Rea k sizedo7 ofY elements{sen with replac.If the re$ve0 or ar4t specified,IFCPions *Bmade|equal probability5"""Ebrandom4"f.n\/en[ if<@ is T %if floor = _ {n += 0.0 # convert to float pa small#ed improvu Mr[[v(() * n)]V3_repeat(J, k):tryQ>`_accum#e(l)except TypeErrorWif not isinstancJ,A]raise4k = 2(![f'The numbero must be a keyword argu}: {k=}'Na) from:*el7  @'Can*(dy both@ andi\'wif len(o) != ntBValu(Q doesQmatchrvptotal =Hc[-1] +%2if ><jogreater than zeros_isfinite(r k le finite')  bisect = _   hi = n - 1return [population[5(cum_weights, random() * total, 0, hi)]Id for i in _repeat(None, k)] -O## - real-valued distribu/s 0L def uniform(self, a, b):ic"Get ap number0theAge [22 or ] depending on rou %."S2a + (b - a}.%triangularalow=0.<@gh=1 Pmode=%5""T; .]Continuous" bed by given lower and upper limits,0hava3  in-between| http://en.wikipedia.org//_&""OJu = >6tryc = 0.5 if 0is 8q else (-) / (high  except ZeroDivisionErrorg5low9if u > c)u1.0 - u*c0low5Pgh = ,"wZ  * _sqrt(u * c)Gnormalvariateamu, sigmaNN+ (`mu is Qmean,+Estandard devi&># Uses KindermanK Monahan method. Reference:)h# A.J.9, J.F., "Computer gener0 of5domI!# pbles us/.0es", ACM TransDMath Software, 3, (1977), pp257-260 Mwhile True@31 =%().BRu2 = CZ z = NV_MAGICCONST * (u1 - )u2Pz1z * z / 4.0if zz <= -_log(u2;Ubreak6Pmu + V,_gauss G#?ian9 This i sl`ly fas7Athan :`) funclNot thread-safe withouMalock ag calls6 aWhen xy are twofrom [0, 1),%lyf#0ed,n # cos(2*p i*x)*sqrt(-2*log(1-y)) #sin(2*p+ 5)are two *independent* variables with normal distributionC(mu = 0, sigma = 1).Lambert Meertens(corrected version; bugk covered by Mike Miller, fixGLM) h Multithreading note: Whens call this func%simultaneously, it is possible that they will receivesame return value. The windowPrvery sm@ough"oCQavoid, you hafo use a lock around Dgs. (ICdidn't want to slowQ down in serial casef us8aFkWhere.jrandom = self.4zgauss_next0f = Non;@if z:5rx2pi = k() * TWOP$g2rad = _"a.0 * _'E.0 -=27P_cos(dZH ~_g 12mu + z *pdef logM`0te(\C, mu<)P"""Lo z.N!If 1tak naturalfarithm ofU'll get   mean mu and standard devia?bmu can2any,= must be greaterVgn zero<"""RA_exp0.C=gDexpo!dZlambd`Exponent61.0 divid{the desi. It should b1non0 (`paramew*Aed "j`a", budaza reserved wordPython.) RlAnsge from 0 tXPpositinfinity if w>@nega19Ito 0>+;#hb: rate '/;^A# (' a'"a A# we%1-pinsteadto preclud%p il ) ak0logD1-V\R()) /vonmisesZkappaCircular datatribution.  4mu is the mean angle, expressed in radians between 0 and 2*pi, and H kappaN(concentration parameter, which must be greater than or Lequal to zero. If_ , this distribunureducesMto a uniform random1 ov|e@ge 0r%. =5""" @# Ba0upo+ algorithm publish10: F r, N.I.,>#"Statistical Analysis of Circular Data", Cambridge=University Pg, 1993# Thanks Magnus Kessler for a correc# to^implemen ongstep 4`:r= self.Bi<= 1e-6:return TWOPI *nVdom()fs = 0.5 /= r = s + _sqrt(1.0 + s * s<while TrueuFu1 =kz = _cos(_pi * u1N$d = z / (r + z)/u2Vif u2 < - d * d or!= - d) * _exp(d)\Vbreak1q =M&/ af = (qlX+ q */u303 >g zPthetaW mujaRf)) %;elsb:=- _:;0def gammavariate(U, alpha,ka @"""G, `. NotIA fun!bQPCondiAs on+Rs arepb "BThe probabil{ irF is:3yax ** (@ - 1Pmath.B-x /( pdf(x) = -;te`}y"** 2> 0,"is:*H!, 0nce56**2Z# Warning: a few older sources define yFterm#ju > -1.0"if = 0.0 or r _/z)$return x * betaCelif=- @# expovariate(1/= Z-?)ns#} isween 0 and 1 (exclusiver0# Uses ALGORITHM GS of Statistical Computing - Kennedy & Gentleg  R(_e +/_pI * uuOoif p I : if <=^1* (dS15_breakM\/-x? 0defWaRself,K,_"""Beta distribution.)PCondis on the parameters areV# >) .Red values geq5"""<V## Se_## http://mail.python.org/piper/-bugs-list/2001-January/003752.htmlefor Ivan Frohne's insightful analysism1whyoriginal implemen&on(##`?  ##+# Discrete Event Simula in C, pp 87-88q {I@y = .w .;1.01hz/(y+zRwas dead wrong, how it probably got that way# This version du e to Janne Sinkkonen, and matches all the std # texts (e.g., Knuth Vol 2 Ed 3 pg 134 "8beta distribution").Iy = self.gammavariate(alpha, 1.0)*Uif y:return y / (y +H{GH6A0.0 Ndef pareto~!, )rA"""P' ". )2 is%@hapePameter."""f# Jain, pg. 4950u =" -}random(u ** (-1.0 /v)Dweibull ,  W. M7calR G9; bug fix courtesy Bill ArmsA_log(u))*)) ## -.F Operating System R Source v class10("""Alternate  number genqPor usvshs provide!byos(such as /dev/uZon Unix orCryptGen on Windows).Not available!%cs (see os.^() for detailCm(ya"""GetKnext!inrange [0.0 r(int.from_bytes(_ 7), 'big') >> 3) * RECIP_BPF0getAbits:, k!k) -> x. GBn int with kO if k < 0sraise ValueError('0of C must be non-negative'<. = (k + 7) // 8[#T!rounded up10x =OlV6xg(' * 8 - k)X# trim excessnu% nh- i#@n) fhn#s an empty T #ng6F== 02 vnCseed*args, **kwdsStub method. {Ausedk"a u[#.~None def _notimplemented(self, *args, **kwds): 4"Method should not be called for a system random number generator."Lraise NotIError('SDentropy source doesshave state.')P1getF = s )_no # -2 # Create one instance, seed rom current time, and export its mHs # as module-level functions. TheS shar across all useH(both in ther's codezPython libraries), but that's fine #most programsBs easier dQcasuarBn making3m # ti%their own R#()`ce. _@% = F1 = .  N uniform+ triangularL5intMint choice.Frang00 sa2v shuffl0`s/as normalvar+ @ log %  ` # vonmises$ l gamma%V gausM bet5| paretoW } weibul   $ V.4b}d4getFbyteO #9%:6 te_p def _+_?1(n, , fnistics imgstdev, fmeanf1ean-0*perf_counter #Xt0 = (hdata = [(%)iy_repeat(None, n)]K1K!xb(Xb@sigmc , *low = min@high#ax^print(f'{t1 - t0:.3f} sec, {n}0s {.__name__}M;'avg %g, stddev 2minax %g\n' % (!, p, low, 7)) s(N=2000 #N,/B, ()#(, (0.0, 1.02 3) _test_%generator(N, vonmisesvariate, (0.0, 1.0)) _test_4Ygamma1121!25911'21/203?uss7bet33 triangular_U2 / :o ## -": fork support [ if hasattr(_os, "62"):os.register_at_0(afin_child=_inst.seed) O__name__ == '__main__'Q2() # # Secret Labs' Re Expression Engine+re-compatible interface the sre matching e8 Copyright (c) 1998-2001 by~ AB. All ,s reserved.}This ver!ofqXSRE library can be redistributed under CNRI's # Python 1.6 license. For any other use, please contact # # AB (info@pNware.com)Portions #is have been developed in coopjawith #. Hewlett-Packard provided funda1for0gravr and # ility workc r"""SCres (RE). sdmodule#0s similar to thos%!unPerl. Its both 8-bit Unicode Angs;  bqpattern&"0 beprocessed in null bytes7 characters outsideKUS ASCII range. sWpspecialYa ordinbo. Most , like "A", "a", or "0", arsimplest ;yc2ply~mselves. You concatenaterso lastD esFv ''$e =2areM0"."0 Mf%y ) except a newline.+"^5the start of the string. "$" Matches !aend of , or just beforenewline atIF!  Am*m0YmR(greedy) repetitionspreceding REImG6P meanat it will m as manyVas possibleN+"+1$+"?I%1 U*?,+?,?? Non- [ vers@viouree special charactersP{m,n}!from m to nB?? Dabov>"\\Either escapesVsignals a ssequencN [] Indicate+ ety *p A "^"Vfirst' iIcomplementN2set3""| A|B, crexn RE thaReAB?P(...)rRE insid-parenthese/The contents can be retrievedeed later ina?aiLmsux) M0let A set+corresponBflags defined belowF:0oup#~regular (?P@2subiygroup is acce@ by > P=O EtextOpearlier<lW8dL#` A com; ignoredm=!cif ...fs next, but doesn't2sumJ!J8P0<{z,"(mq@ fixeength)@q@Onot D@(id/5)yes|no)p`yes paG2n icSwith 6'*d,0(opeal) noTo)qwise. 0 si!is"`Wand aaRlist 2 Iordinary00is o>5,a resul(RE=`fsecondJz\number6Y3 Rsame 6CA%Cbonly aAstar/\Z6v\b Matches the empty string, but only atstart or end of a word. \B MatcO?notNdNany decimal digit; equivalent toet [0-9] inE bytes patternsAwithEASCII flagD#In 5"ou8, it will m VZwholePrangeGrUnicodesv#\DxOAnon- characterS[^\d]CsCwhitespaceD \t\n\r\f\vKZSZ4_s_wHalphanumericaa-zA-Z0-9_]/inn Ps (le]cs plus Kunderscore)E0 WoLOCALEAs"_]bs definedn4as 1for@curr.blocale#\Whpcomplem,Sof \w+\+a literal backslash. This module export[following functions:%\ a regular?tressions`beginnMBfullSO0allaE`searchS  Mqpresenca= ub: Substitute oc2ceso found in cEnFSame as subalso return`numberVsp^C madQsplitNS k1 byB@find&p Find 1=&2 R0an ator yielda7q objecteBeachAile Comp w into a PF7@purg5b Clea `r expression cache. escape BBackslash all non-alphanumerics in a string. Each function other than purge and [pcan tak0 op/al 'flags' argument consisting of one or morethe follow pmodule 2 tants, joined by "|". A, L, U are mutually exclusivA ASCIIc For patterns, m\w, \W, \b, \B, \d, \D@<`match correspondhcharacter categoriesF6(raQMwhole Unicode=, which istKdefault)WbytesPthis U only availabledbehaviourtneedn't be specified~I IGNORECASE Perform case-insensitive EgL LOCALE ? Mdependent on P currSlocalM MULTILINL2"^"je=p beginnof lines (afPa new)as well aG" *"$r0endZ`s (befmRZuB xS DOTALL&".xFany  atq, incluKX VERBO` IgnwhitespacPd coms for nicer lookMBRE'sJU UNICOD~ocompatibilityj.bdKO (it forbiddenJ @. TmK@also> an(e 'error'. """ import enum @sre_8ileEpars(ools try:J_ except I`Et'  = None # public symbR__all__ = [Y">", "full `search3subnbplit",<pfindall @iter   template E3PF M AILMSXUD01    Gp", ] __version. "2.2.1" class RegexFlag(@.Int )w = A = .SRE_FLAG_!# assume ascii ""[O = IH&2# ikCO = L?"8-bit locale  UNICODE = U = sre_compile.SRE_FLAG_## assume unicode "locale" MULTILINKMK%# make anchors look for newlineSDOTALL = SP"Mdot matchF`VERBOSXG## ignore whitespacd comments#& extensions (experi" al, don't rely on these)9pTEMPLATT$# disable backtrackingH_DEBUGA# dump pattern afterpilation Idef __repr__(self):0if ._name_ is not None$(return f're.{2%}'KPvalueQelf.__members = []pnegativ5/E < 04if +1= ~ 0VCm in_class__<1if 6D & m "#5= ~%g .append(mH"}' )s g ?Ahex(v)9 re/'|'.join(2 !Vif le1J > 1}^f'~({res});els432"re:__str__ = object. globals().update(RegexFlag.__T__) |1cepPerror[+-0 # public interface 8h(a, string, flags=0I"""Try to apply tstart of F81a M5A, or owas found.""D ").)Bfull(/lla fsearch0ScaSrough1ingal!to$jK6subFreplcount=0Return the string obtained by replacthe leftmost non-overlapp!occurrences of 0pattern in str% by@[Qementg!.  can be either a:o callable;B%if, backslash escapesv it are processed. If it isB$a R, it's pa' Match object and musCturn= toul1"""( re3 _compile(, flags).sub(J,, count) def subn3(#=0JA=0):qB"""Rta 2-tuple conR(new_, number).91 is'C"asource}k" )ac"of=ubstitutionat were made.MX C /; X B[ W?(aW#nX FplitYh`, maxsVS),ha list@`result s1s>Pcaptu parenthesesnYAthen@text1allDQgroupp0DRalso @ed a r;)E-nonzero, at $P!s  NXpmainderOfinal eldk(fj~findall^}=allm@u!. If one or more  esi,GG2of 8; this willsKC2hasAthanKdEmpty includedpL.dyOiterz n 1Pator  w . For each match, the iterator returns a Match object. Empty mes are included in the result."""1rN! _compile(pattern, flags).finditer(string) def .A=0):U""CN a regular expression c|ring a Pxepurge(zClear zbcaches\_ .c0!()a_repl. _ |templat&+ |T) # SPECIAL_CHARS # closA')', '}' and ']' # '-' (a rang character set)!&4~', (exten% % operations0#' (comment)iWHITESPACE (ignored)hverbose mode _special_\s_map = {i: '\\' + chr(i) for i=b'()[]{}?*+-|^$\\.&~# \t\n\r\v\f'}UescapE {sb"a . if isinstancW,+\`a.transTBelse?8 =Wl'latin1'3)h.encode(F N= type(sre.'', 0)) E).TA('')-0P # inmRals } # ordered! _MAXCACHE = 512CjX: :, RegexFlag" = a.valueA2tryj[p$),wO]>except KeyErrorJApass" N,$"ifD`aise Vb(U"cannot processEP argut with a<d"`0if Sl"isirBTypef"firstpmust be(/orNt6( & DEBUGrif len(U) >= } ba# Dropgoldest itemc $Bdel ^a[next(Z"))+&(StopIteration, RuntimeError, Key K): Epass_cache[type(pattern), , flags] = p2 return p @functools.lruF(_MAXCACHE) def _compile_repl(Z@# insCal: - (tacement|sre_parse._template` dexpand, match, 5M".8Q implation hook@? = $;C7k8)Fsubx%P.sub/subnQelperF+ = eif not>[0] and len(2[1]) == 1x# literal@1[0]Cqfilter( =.HX6g! # register myself for pickling import copyreg3e(pU, (p.P!p.R3) D.>2, _,)-0 # experi[al stuff (see python-dev discussionspdetailslass Scanner__init__(0, lexicon;#=0mAfrom0constantsQBRANCH, SUBPATTERN5aif isi01ce(>, RegexFlag^-" =e.valueI.$ =#bine phrases0o aYpoundmRp = [s  St)_s`qA, acf$ine]0gidc.opengroup(_ p.append(3SubYU(s, [v/(q, (gid, 0Cf(M))),K*])rs.closeZVp[-1]%?g ((None, p));s$ren.F"(pi)Xstrin5jresultF2 = Vv@elf.\4ner(a.%3Ui = 0while True2m = vm. break  j = m.end() if i == j:Ybreakaction = self.lexicon[m.lastindex-1][1]4if callable(@)kPPmatch @82 = (/, m.group()' is not Nones0app+ BE = jreturn result, string[i:] """Redo the builti'pr() (representa3*) but with limits on most sizes.""" __all__ = ["Repr", "Gcursive_] importxs from itertools bislicet_threadget_ident def reb(fillvalue='...''Decorator to make a B fun/@A for%_!' _xdRDing_DU(user{j_running2t()JN wrr"9key = id%, +oA i.add(keye?tryTe9 =  `ofinallB$pr.discar}Bp# Can't~K.Ts() here because of bootstrap issues1per.__modulezgetattr6, '%'!B?doc? "<?nam| #>Bqual =-'FBannos *V', {}@ class E:-__init__O}N.maxlevel = 6_tupleOlist@arrap5M0dic34 se~ofrozenOdequ] = 30l!loB4Rother56:67, xV&#B1(x,ND1E!, mL@typen0 = `(x).__!__Uif ' ' in# parts = typename.splgit()  typename = '_'.join(parts' if hasattr(self, 'repr_' + >)):Ureturn get6 (x, levelmOelseM{.yinstance>~Rdef _"sterablefm ft, right, maxiter, trail=''n = len(x"if <= 0 and nsDA...'d1new_uvel - 1/3E1 = Ppiecei[)t(elem, V`) for  in isli&))]kdif n >2: ].append('y4', ' "TA== 1!Y": q" =i" +.0'%sp' % (les!) ,M_tupPB   '(2)',j1maxV\, ','pKlistKo[o]oU i_arrayj]Jot xw"='%s')" % x.Acode=header = ,?, [.XG SH, ']K /seE ';)Wx = _possibly_sorted '{}[5)',E.max? Ldequ:]E r/icn == 0: 6'{}  #7...&5h&F = [Ow7keyvkGdictS0keyt0 = W1(key 0val$+ox[key].pieces.append( '%s: %s' % (keyrepr, val C)) if n > self.maxdict: pieces.append('...'2s = ', '.join(+return '{%s}|As,) n@def }P_str(p, x, level):"^builtins./@(x[:.vstring]nif len(s)%RVi = max(0, {Mf-3)//2R.j. zJ-3-i+pi] + x[Wx)-j:_41s[:&\A + s.s. Ls@1int@) # XXX Hope this isn't too slow...sQOlongO&M+K+ostance:try m # Bugs in x.__ __() can cause arbitraryB# exceptions -- then make up something3-$ E4 0'<% at %#x>bclass__.__name__, id(x *Zotherm)',0 0_possibly_sorte# Since not all sequences of items2be 9 and comparison{b# funcxmay rai#, Ran unRCy$that caseP oA<"(xg/@list- aRepr = 0() 1 = &r """Wor le for GNU readline. TheUleter s keywords, A-ins2`globalx a$ectable espace (which defaults to __main__); wwng NAME..., it evaluates (!)( expression-!to`last ds its attributes. It's very cooldo "import sys" type "sys.", hit_ on  (twice), 5 se5 e ]qined byAsys module! Tip:{ qthe tabW!as, mb, callparse_and_bind("tab:") Notes: -5s raised by the -completer function are *ignored* (and generally cause the <4$to fail). This is a feature -- since readline setsCLtty device in raw (or cbreak) mode, printing a traceback wouldn't work well without somicated hoopla to save, reset trestore state. - The evalua!of$QNAME... form ma arbitrary appl{1ionfined codebe execuif an object a __getattr__kPfound. SL itresponsibility R*Puser)PenablDis P, I cIPder tan accept.risk. M-ed expressionMV(e.g.Mcalls or indexAoperQ"s)kDnot*h!edzAWhenmoriginal stdin0not#ty6V, GNUZis never used,bmodule msilently inactiv """ import atexitbuiltinseinspec__main__ __all__ = ["Cr"] class @: f __init__(self, namespace = None)*."""Create a newom{!. c9v%([_W]) ->Cpinstanc3AIf u0ifiaLwdefaultAwherz^0per2%ed4is ' (techni3%y,.__dict__). N@s sh b given as /ionaries F.=emechanism of;1viaCset_5Per() :j0.(5my_$).J)qG ifh$is(J, +Braise TypeError('/p must bHB6y')# Don't bindF: quite yet, but flag whethJe]r wants a # .Gifico0.[will allow uq0 #R;4 atPime, 70nowSD Y!isih$B.useens = 1Oelse/0/PG= v4defe Rtext,"""Retur6next possiOfor 'text'. 6 This is called successively with state == 0, 1, 2, ... until it returns None.W e completion should beginW'text'. ?U """ if self.use_main_ns:1namespace = _(_.__dict__Ypif not p.strip()Mn lif _readline_available(,(.insert_ui('\t')+/redisplay()^= ''G?els4*\t62 ; if "." inY matches =Sattr_( IoglobalK:tryI[]Nexcept IndexErrorBPdef _3 _postfix(b, val, wordg!ifa.G(val,-f += "( inspect.signatureX.parameter1:k)k_Value;BpassUP P"""Compute B wheG@a si8  Ra a list of all keys, built-in functQs andEs currentlypdefined.mLBthat} Tmport{R6= [Xseen = {"__uins__"}5;len 1forA0.kwG!if'@[:n]i !%P.add() qDk{'finally', 'try'}N3I! ={Z + ':_"$elWzin {'FalseYEeTrue', 7`'break3`contin7 '?W l.appenEn7Jin [J5ins]Q?M4Ll.itemsVE0in  g:.add(word)  #matches.append(self._callable_postfix(val, word)) Bsreturn A def attr_P, text):">"""Compute>Q when' contains a dot.X6Assuming the+Qis ofform NAME.@...[ ], and is{PevaluA in namespace, it will be (2tedA!tsVibuteM(as revealed by dir()) are us;s possible completions. (For clasMinstances, membersO@alsosidered.)WARNING: this can stinvoke arbitrary C codf an objectwith a __get_ hook is 5""";import reqm = re. (r"(\w+(\.\w+)*)\.(\w*)"4if not m&d%[](Qexpr, = m.group(1, 3:tryF! =(F Aexcept E:ionNQ# get4entv#, R__builtins__=Ws = set(Bm%.discard("I" `if has(GQ, '__m7__'aXHadd($#update(getKh.fen = len(wi<j == ''tnoprefix = '_'(el4_5 6/se_6Nonwhile Tru01forEB O6@if (@[:n]L%(;!+1=)@e = "%s.%s" % Ga/Tif istW(type) , /),Mproperty)# bpo-44752%.pa method decora/by{D# `@u`. What follows applieJ? ifI2 , but know we6tha?#!isF (becauseji/.PAlso,b2his2) L # property method, which is not desirable. matches.append().continue!if (value := getattr(thisobject, word, None)):Oself._call_postfixu!, -)OelsegI "if_Qes or\noprefixV\break>/~ == '_'6!Y '__'@2F2es.sort(dreturnP def_class_members(k)ret = dirbaif has,,'__bases__'8@for A in (.']%e+Cret tryE import readline except IRError(_"Q_avai> = False ]%.set_completer(C $).# Release references early at shutdown (th" module'sN # Sents are quasi-immortal, and =wr function holds aF to globals)atexit.regisulambda:5 KE6 True """runpy.py - locating@runn Python code us namespace Provides sup;R wscriptsUk \ instead ofFnative filesystem. This allows G to play nicely with non-=d PEP 302 ers whenas well )8 s.] # Written by Nick Coghlan #N@to iBment38 (ExecuM}s~SG3) D sys lib.machinery #[ortlib first so we can test #15386 via -mJEutilo Etypewos __all__ = [i_1", path", ] b _Temp(m0"""orarily replace aBsys.^san empty1"""2__init__(,H_pR% =#C!aule = .Type(mod;c1_saved_module = [] def __enter__(self): mod_name = .!6try.5' _saved_module.append(sys@Tules[H%])Jexcept KeyErrorVEpass*I5ule,areturn 3xitw, *args!if0. m)] =1[0]}!JelseMOdel Q9h W = [] class _ModifiedArgv0(object'inSvalue^1 = yentinel = p)()fU `Sdis notyX (raise Runtime%("Already preserving |"_>r=uHargv/ > i3@#_sR;ys.e@ # TODO: Replace these helpers with importlib._bootstrap_external functions. drun_code( , globals, e=None,$ Bspec ,1pkg2v scriptrA"""H0 to in nominated wspace"""d)if 2(.update(%ifF Bloader = yfhcached2 RH9.A] eorigin a!!4if x=q.parentD6_2__ 2 Ya__file,)+ ,1doc)'M* ,bpackag/Yy@NexecIqR 3W#2# None): "@""Helper to run code in new namespace with sys modified""" fname = script_n if'_spec is None elseq.originAZ_TempModule(modG) as temp_mC, _M}aArgv0({!):F9globals =:.A.__dict__2P_run_(,Bt, init_3io!7Q, pkg', )=# Copy the U1 ofPoraryAule,3hey8may be cleared when8 goes awa9`returnT.copy() # 1getNAfull , B and Pfor aGule def _get_details, error=ImportE 2p.startsC("."!VRraiseC("Relativ71ules not sup_2ed"\w`_, _ =.rpartitionjR%if=q# Try i1ing`parentavoid catch`ializaZs\6tryX"__X4__(wexcept 1eB2# I, or higher ancestor packageqmissing, lp#Rnd by find() belowtjzaught. But doN al3 ots5: 3Pif e.Cor (%!= 9rHKC + TU4R# Warn iXmc has alreads#ened under it2rma+MPexist=%pUs.get0iPt#rhasattr(U, "__path__,from warnings&msg = "{mZ!r} found4sys@ aft9" \IM"i{!r}, but prioHQexecu?of Ep; this `resultPunpreOableDbehaviour".formal==<(Runtimeing(msg)) =flib.util.;ub(, AttributeT, Typ BValu &ex0# T!hack fix edP mism betweenB A#, where the latter raises other errors for caswhere # pkgutil previouslyAd ImportEA0qmsg = " while finding module specificationx{!r} ({}: {})"K if3_name.endswith(".py"):%t+= (f". Try usoQ'{mod>[:-3]}' instead of fA&f"5}' as the%")zF?(msg.format(u, type(ex).___, ex)) from exI!if is None^8"Nopd %s" %YJQ.submi_search_lokse;notif == "__main__" orc!  0Cankuse packageN;X7uleM6try2pkgw =2T + ".H return _get_details(N,7lbexcept"rin sys.cs0 6 # loaded; beais irrelevantAE(("%s; %r<Rand cg9" +=A  "be directly executed") %(e,])1r =.`2if Gspac&be^   Qccode =.  e0if Y "No&object availab)/orZC,E class _q!(E3ion#""that _run!as_() should re eout a traceback""" # XXX ncoghlan: S6Pthis [ocumented made public? # (Current thoughts: don'tu eae mistake lto its # cre-Vwhen () no longer meHneeds of # .c, but cybe changed becacit was_) def1alter_argv=Trues2Run:pdesigna1 inS " Ac Not| ule will have full access toVB ]ce. If this is not desirable, the run_module()  function should be used to/73 code in a fresh namespace. M!At1very leastxpse varisA__main__ willqoverwritten:K __d*__LfilelcachedlloaderdpackagC1"""_6try|if alter_argv or modT != "": # i.e. -m switchK5,?Rspec,Ec= _get_details(/e_Error` else:Rudirectory0zip` execurexcept v as exc.msg = "%s: %s" % (sys.,/bit(msgglobals = !&s[m].__dict <U[0] =xq.originreturn _ ((, q, None,/s`) def1Sinit_=Xzsys=False)A"""E0e aRule'sOwithout importing itRsQresul!top level ]aionary i1 isWQ%z7sys._f,OrIdq# Leave3sysVe alone%/O{}, tbe!=I # Helper that gives a nicer 4 message when attemp#+6or 1by invok,".p# Also mow6standard * m!of8bway so"th7# preexis$__ entry doesn't cause issuesNmQsaved7 4]C9del?   "ifB5sstr(excnRraise@("caafind %b!ul`Q%r" %3(,path[0])) from eCxc Qraisefinally: sys.modules[main_name] = saved_ def _get_code_from_file(ru10, f8)X# Check for a compiled 2a first~F pkgutil import readd" deod_path = os. @.absb(os.fs$()7with io.openM(%Ib) as fc& =z"(fF1if vis None1# That didn't work, so try it]normal sourceEm2=E0(f.##()q, 'exec'areturnr 2, init_globals= , '"""Execut located at the specifibsystem$Dion Rs2resulting top level uspace dictionary=2The: may refer directly to a Python script (i.e.~Pone tpcould bf;<us) or el2 xo0zip*)ory containa_LS__.py1""")%if tP = "< >91pkgp.rpartiK(".")[0]ds~!er% 8 = (simP# TryCvoid0imp as0not0sume depreca@ war0 is_NullI ter = Faif type(B).____ == 'imp'/f-g6p2Tru<if isinstanc,C): B# Not a valid ySa entryC1run$X!ly$# p() does@helptpwe wantpTallow1vsE[/ = b_R( TO,}B= ,"~=FQ`Finder0Pdefin0or Q0add!to={#astart of .insert(0,NF'trB# Here's wherings are a littlufferent >FMpcase. TL, we only had@repl+A0 in while the   # code was running and do !so somewhat optional. Here, we F# have no choiceJ"weto remove it even while we read thM@. If#don't do this, a __loader__ attribute inGPexist__main__ module may pr`t loca0 ofCC new'.mod_name,b_spec,Ab= _getbm`_details()Bwith _TempM'A(runS) as temp_@9, \9d_ModifiedArgv0(path=:,globals =Y.`.__dict__:return _(Qt, init_ B N ;2pkgW.copy*zfinally+trb@sys..^ except ValueError[Jpass if _t__ == "7"2A# Rug@ule he next commIline argumentpif len(argv) < 2[rint("No_for execu", file=GbstderrgFelseN@del "i[0] # Makerequestedi3ys.(m1_as[0]) """A generq useful`t scheir class. Each instancek"is manages its own queue. pulti-th''is implied; you are supposed to hack that yourself, or a singl*per appli is parametrized two funcPs, onShat is Hthe current ti<1 e) a delay. You canPreal-Ibby substitu sleep from built-in$F7can`simula%q by wriYTP. Than also bemintegrateDbSTDWIN+!s; X is allowmy(a Timebe expres1as v0ersAfloapoint numberC@s loslconsistentRvents[2pecby tuples (, priority, a ,, kwargs). As`UNIX, r7 mean highe;67 wa`tainedwaTE*he event means calling the action fun `, pass"it rgument sequence in "a" (remember thatPython, multiple\ 6s are be packed5$a ` ) and keyword parameters&"kwargs". T@ mayUan instamethod so it has another way to refer*private data (besides global variables). """ import time heapq from colleO#s *namedtuple#itertool!TcountLthreading-gImonotonic as _ __all__ = ["scheduler"] Event = ~!('@', '<, priority,,$, ", x"')R.;a.__docv('''Numeric type compatible withIreturn value of Hz#~ edconstructor.'' $s @d foae sameP will$executed inc order%iru uA continually increa@05 nup sePtes eBs if"Xequal E3Tr means G9&(*"**)X aF is @ hol@@posiH'al}{ ge!di?9arygd @ _seel = object() clas1r: def __init__(self,=_q, delay.sleep):>"""Initialize a newO?RA[=s[Rp._queue].ulock = ).RLock()'q^*0ime !& = #__generator = VDenterabsD]S4=()V= UERPat an absolut.Rn5 ID Gwhich can "usoremove it,if necessary[#ifF= {} 2!= (KAnextf.)|  action, argument, kwargs) `heapq.push(self._queue, event/breturn # The ID Ndef enterA, delay, priority, action, arg4=()=_sentinel):M""""A variant that specifies the time as a relativ.BpThis iszQually7more commonly used iGface<5"""j!=  func() +'' @abs(0 )FccancelG Remove aAfrommust be pree!ed+ ID;Sed by%).!If*Fanot ini0, t`raises ValueErrorEBwithCV_lock4t!.r(xz&1ify =Bempt KCheck whether3.5 1run0, bing=TruerExecuteJs untilOrFalse eFscheduledUedue toB expire soonest (if any) an#n \deadline oDVnext iDcall1Whe1 reaa posiRfirstWeq)q=Ft$ed4:lef;EoAwise\3j*d A[ZdD1(itINion , passing iee). IfF\6layDvsmaturely,Fis simply=restartedb"Itgal for bothH 9 5ionSto modif$q or to m@xcepYeQs arecaught bu's state remainswell-defined so ?P) mayGgain`A quesable hack0addo allow  threads&unwjQafterD2, a0Uavoid monopoliz0CPUln%6als@runn# localize QaccesPminimvoverhea#to improve thread safety lock = self._ qUqueuedelayfunc #Htime"!pop = heapq.5popwhile True:Pwith if not qYbreakK(, priority, sequence, action,3 argument, kwargs) = q[0]*`now = b-()!!ifo > nowW! =  @;els7FFalsZpop(q1if 8[by>ing!Vbreturn- ^  % &(*z#**|d0) # Let other thas run 8s@proper Adef ()"""An ordered list of upcoming events.S E are named tuples fields fora5,nsoh1"""?R# UseL to sort the3 raPan us'"!ed!._7)'.OWicq, two scheduled aaBsamewill show inIbactualCy would be retrieved}( (nv&[:}rQ(map(_2, [@b]*len( 8))) """Generate cryptographically strong pseudo-random numbers suitable` manag``secret ch as account authentica^ tokens, and similar. See PEP 506W more inform8. https://www.python.org/dev/pepsp-0506/ __all__ = ['choice', 'Ubelow 0its qSystemR''Q_byte*0hex7 0url` 8compare_digestp] impebase64inascii from hmac ) P $om"` _sys 8 = @() tbits = &D.get 1 4'E(exclusive_upper_boundIB"""R a 2Pnt inge [0, n).?if RV <= 0raise ValueError("U~ ~ must be positive. ") return _sysrand._:below(exclusive_upper_bound) DEFAULT_ENTROPY = 32 # number of bytes to ^by default def token_b&!(nq=None):B"""R a !omQ string contain *=* 1s. ?5If Pis ``[`` or not supplied, a reasonable: is usedP9>>>16) #doctest:+SKIP> b'\\xebr\\x17D*t\\xae\\xd4p3S\\xb6 2bP1\\x8b'1"""E2if += 8i8Y`)y3hexw Ctextw, in hexadecimal3The!F hasyqs, each`verted1twohex digits. G'f9bf78b9a18ce6d46a0cd2b0b86df9dapbinascii.hexlify()).decode('+'urlsafe@URL-. Base64 encodingq4 0uDrmhze6EPcv0fN_81Bj-nAkYtok =  b.rA_b64 e0).r;np(b'=' """Selectors module. Thi6 allows high-level and efficient I/O multiplexing, built upon the `sea`_ primitives.  from abc import ABCMeta, abstractmethod(0colODions0namedtuple#.WMapping fDmath ys # generic events, that must be mapp#implementation-specific ones EVENT_READ = (1 << 0)UWRITE21) _fileobj_to_fd(  descriptor H cobject ParametersR"hobj ---%S<corresponm?0Caise/ValueError if 8qinvalidm if isinstancet%Afd ={1obj>Belse6try 0int(fileobj.fileno())  except (AttributeError, Typ BValu %):8?fraise ("Invalid h object: "59 "{!r}".format(:obj)) from None?if fd < 0 descriptor: {adreturn fd SelectorKey = namedtuple('S', ['`', 'fd`events ydata'])N.__doc__ = """Mb, fd, E , C!) O> used to associate a^its backing: 1, s"edg mask, and attachedx. """ if sys.version_info >= (3, 5.l7objS'File registered.' <d7Underlying;0?E that must be waited for on this[WU('''Optional opaque* YFor example,|Pcould@storper-client sesx ID.''') class _9Mapping(3"""8 ofs!or keys.def __init__(self*#orW%._C=N"orE3lenD:a1len^E._fd_to_keyFsgetitemJ, 6try 1fd f^ileobj_lookupj9 A[fd]&-%1Key (w is not iCiterKL .DBase1Q(metaE=ABCMetaX abstract base ..A supportsQlpbe monizspecific2I/Os_B/$ist or any#with a `7` method.`An arbitrar20canuato the]U, which *N9G context ion, a callU, etc7[use various iPmenta_ s ect(), polle 2...`dependt`e plat6. The default `` uses the most efficient implementation on the currplatform.6A""" @abstractmethod def register(self, fileobj, events, data=None):4C"""R7! a3 object.l$Parameters8]8 --52 ordescriptorj 2 to monitor (bitwise mask of EVENT_READ| eWRITE)N-- attachedgReturnSelectorKey instance/Gaise.ValueError ifC is invaliu5Key&is alreadye2/OS1`closedAQother is unacceptable to{/ underlying system call (if ais made)FNote0maynot be r~T NotI!edf/un U&DQ/,?"ed5 x!If60objb0 but has since been (this doesR*not* (j'pwrapped >QlomodifyjChange as$edp*orPAnythWthat C)9"().; r9 (S& MIsq$timeout0Per`actual| ec, until some5Us areu7 q expires; .!--/a > 0, kspecifiesmaximum waitiE, inseconds  *if timeout <= 0, the select() call won't block, and will C areportB currently ready file objects;is None,p until a monitoredMm becomes .Returns: list of (key, events) for:`(` is a bitwise maskKEVENT_READ| UWRITEr5""" ra9NotImplementedErrordef close(self)@"""Ct2or.5This must beed to make sure that any underlying resourceefreed.Bpassjqget_key,.:objtkey associata registered?.@SQorKeyt@mapp=` f.Umap()-4if $pTR!me$('3&d'Q;tryB}f[Eobj]except Key_ =+`("{!r}w7notC".format(]q)) fromZ@abstractmethoHj}C(ofsZh keys./7 __1r__F=r1c__exit-w, *args4-.() class _Basel(>0""" tector iQation%inA&!# Bmaps%descriptor) E-`_fd_toEU = {}#T-only3 ned by Otmap = _M[F!q_lookup aZ wr_lpto_fd()1do an exhaustiv|arch in case\ invalid but we still have it;0our,0. ERis us6$unpP() soFFcan q%Dwas previous 1 ifs`d. ItEalsoD i@ O]xGValueError:   # Do an exhaustive search. for key in self._fd_to_key.values():19 if4.fileobj is +/breturn3dM# Raise VkError after allr( =def register(,, events, data=Nonesif (not$b) or (0 & ~(EVENT_READ | gWRITE)C("InvalidY: {!r}".formatb"))Ao= SelectorKey(>,Xt_lookup)Qd FA Keyl (" (FD {})ualready_1ed"s7(fdU["0] =\"'/un:try[ tA.pop(#._ Z)eexcept" ^>0is U%edm)) from hamodify[V]U#if*! !. lM. -/Aelif}* {# Use a shortcut to update the= _replace(V=[~cQclose Ov.clear(s Rmap =>]bget_maQ8_1_fdG, fd:B"""R$associatedAqa given descriptor.bParameters\fd --43r0correspondingb,z1 ifFfoun&"" M ?[fd3~ classd(_BaseCImplR2"""`-based-. __init__(self): super().__init__() self._readers = setHwrit=def register(F, fileobj, events, data=None):4t0keygB<#ifU & EVENT_READVZ.add(key.fdF _WRITEGGreturn key %un 1Bndiscar&& if sys.platform == 'win32's_selectr, w, _, timeout$x;.Bw<6M% + x, []UFelse \li 0 = 4 if2 isuS max(+6, 0%6try2, _#f.E , #._nexcept InterruptedErroro=Aeady6~6t(rMwwfor fd in r | wXE = 0VZ$if3 /3'|== l=8key_from_fd(( if.append( &1.)!98 class _PollLikeSuor(_BasCImpl0""" 8shared between poll, e and dev qors.""">BPor_clA4 G1"()bk902er_ , >|T4N\ aO 0P 3)5or.B,,  unregister(fileoWbj) Uraisereturn key def unregister(self, fileobj):#Lkey = super().1+*6try7;S._selector<fkey.fdexcept OSErrorF # This can happen if the FD was closed since it#"9ed.Epassjmodify, events, data=None. ?elf._fd_to_key[B_lookup(%)]?Key C(f"{A!r} is not ") from  changed = Fal,#if0 !=2. _E = 0]E& EVENT_READD( H2|= 5X _WRITEY6 Z f,;N@ 6Tru!if z 8T3if  0_replace(=i CAfd] Kwq q|timeoutcis shared between poll() and e # has a different signature9handling of parameterOjT ;;=p'el9O<= 06IJelse&#resolution 1 millisecond, round away| # zero to wait *at least*Fs7math.ceil(V* 1e3 @read=[ b"fd:P_listi*1or._YX Interrupted cfor fdI in iB & ~ A/E#|=u' P*Q_READ   key = self._key_from_fd(fd) "yif key: ready.append((key, events &1. )Mqreturn 8 if hasattr(select, 'poll'): mclass PollS @or(_DLike)0"""`-basedector."""N_ibor_cls@ect.v$EVENT_READ"lPOLLIN$ZWRITE%?OUTef E - y E&Ldef filenofbz.0)(FF, timeout=NoneT$if@ is !L?U = -1'el?O<= 0< 0;.se.!# ]p_wait() a resolution of 1 millisecond, round away_ #  zero to T *at least*J-s.@math.ceil(p* 1e3) &-3zw expects `max`be greater than;# we want/make sure.3t ` )` can be called when noI FDregisteredmax_ev = max(len5p._fd_toG), 1^sY = []j/tr1fd_R_list%f.9,W,6_evmexcept InterruptedError>  cfor fdOI in I "ifB & ~..ING0K2|=  &V?OUTW W,R5Qclosef  ( super().0dev  D Solaris /dev/O" _selector_cls = s.devpoll _EVENT_READ%lPOLLIN$ZWRITE%EOUT 'def fileno(self):l`return2f._3or.0)F_closeEX>()hsuper(). if hasattrSect, 'kqueue'):yqclass KS)or(_BaseGImpl2""".`-basedmB."""S__init__| $ 'el,z(5K#{qregiste+!f,obj, events, data=Noned0key}F @ :try*#ifr6 & (,0kev{!.k(key.fd,.KQ_FILTER,1C?jEV_ADD6sontrol([kev], 0, 08_0Hmnexcept,un##Yraise:keydN 5 0if FPs D jDELETE@  OSErrorX# This can happen if the FD was zd since it@#*?ed.&IpassD6See comment abovOe. Ipassreturn key def select(self, timeout=None):(`0 = 4 if-2 iselse max(+I, 0)C@# If!0_ev5 0, kqueue will ignore theZ. For consistentMbehavior with8Sother: lasses, we prevent that hereM`(using). See https://bugs.python.org/issue29255B0max=BA(lenQ._fd_to_key), 1ready = []I:tryy}kev_list =2f._or.control(,}5_ev qexcept InterruptedErrorn+ Pfor kH>@fd =&<.idCflag!ifilterb"]s = 02if @ect.KQ_FILTER_READQ|= EVENT*[_WRITE\+b kee._from_fd(fd, ifo.append((key, /&5. )U Qclose f( Vsuper().D@) R_can_use(methodW"""Check7we can usd0 de@upon`operatsystem. """# Implementation based >github.com/sethmlarson/us2/blob/master1.pyd) = getattr.Rect, ,iN or#ect module does not iRxBFals4# cE&OS and Kernel actually supporeR. Call may fail0fB# OS [Errno 38] FuncP !ed3 B_objbector(#if == 'poll'! Jworkp.-(b \ e+m,50dev" f a2TruPC( # Choo7bes, roughly: #?||!> >Et. # select(\) also can't accept a FD > FD_SETSIZE (usually around 1024) if _can_use('kqueue'): DefaultSelector = Kq S9 el>_epoll=E<0dev>D!@= GPoll:/se%or """Manage shelves of pickled objects. A " f" is a persistent, dictionary-like5. The difference with dbm databasesLthat the values (nokeys!) in af be essentibitrary Python}s -- anything c"" moduleQq handleis includes most classtances, recursive@ typ%an* containw1lotMshared sub-P are ordi@p stringpTo summarizeinterface (key:a/,Cn ar l@): aimportM%ve3d =.open(filename) # !, 0(g)anFffixcd[key] = # stor/@ at (overwritl"ld+%if@# usPan exist Ekey)1Ps|uretrieve a COPYc)Fraisq # KeyError if ch)DNOTEW%is9#ss return9d*copy*eentry!@Cdel BGs# delet?JdFsE:#*`flag =fd # true/-p@listi.(!!a iof alls (slow!).close()!#  it Dependent onmplementa],+|{p may or Bbe necessto flush changes to disk. NormJ,y:%pneeds cwhen mutable %@ies ted: for exa,[F<,0.ap  (anitem) does NOT modifyiyitself, asldP mapp=@-- ib"lyO+p, whichHthen immediately discarded, so"e 0 ha effect whatsoever0o%0an { waat will aCpersistent mapping, use: data = d[key].append(anitem)+4-ata To avoid the problem with mutable entries, you may pass/keyword argument writeback=True in' call to shelve.open. WhenS ( =((filename,\0) t@d keeps a cache of m_access, andDm(1 toppersistmapping wcd.close(). This ensureOat such usage as ` worksintended. HoweversS Sconsume vast amount of memory for!itUmake very slow, if+ +P manyJ d'p after "itis way: d has no to check whichI[E areedand/or33nesatually'pte, so 2ustw A at , of  |@thatX . You can `sync()S%heF2chePemptyjC (d.JPalso hronizes kdictionary on disk'feasible). """ from pickle import DEFAULT_PROTOCOL, P Rr, Un+r8$io4BytesIO DQcolles.abc __all__ = ["Shelf", "BsdDb$Db`"] cl _C'kdDict(a".MTMa)q'Markera d A. A@ attes raise a ValueError.' 3def<(self, *argsc.;9('invalid opera?d"f'7a__iterS__len 0get[s5delckeys =__repr__eturn '' e|_"""Base f le"s.is initializeda-like object.~1Seemodule's __doc__ str2wan overview RrfaceF" __ ,~,tocol=NonaFalse,Akeyencoding="utf-8"l*.k5ict@%ifk@ is nY1pro- =E^_* "l= #self.cache =S {} self.keyencoding =  (def __iter__(1!):Cfor k in P.dictN's(#'yield k.decodeE(v)i>lenhreturn len=j 6contains;,@Akey.u 1getsR, default=None` ifq\>@U[key][q__getitem:trybrvalue =Zcacheiexcept KeyError=f = BytesIO@%])~Unpickler(f).load(("ifwritebackK$.1 = ]o2s0,; `|(Tp = P,_protocol'a.dump(so = f.get>(?del)2deldM ]E-Y Hpass/ena  .5xitCtypea, trac@>h.close +@ is   Q[.sync )P-lAAttribute+K kfinall# Catch es that may happen when called from __del__b# because CPython5@in ipreter shutdown.: P = _C[dDict>  A! =% not hasattr5, ''+`#nm didn't succeed, so doabotherA9ing# see http://bugs.p3.org/issue1339007 JydetailsB ooback and self.cache: self.writeback = False#for key, entry in 5M.items()U`$r[key] =9 T w:Truv"dU = {}>if hasattr(#dict, 'sync' .() class BsdDbShelf(81""" implementation using the "BSD" db interface. This adds methods first(), nexprevious laA and>qset_locn() that have no coul@part{[g]dbm databasese actual must be openedbone ofabsddb"modules "-" routines (i.e. )P.hash, bt1 orB$ rn) passed tonconstructor1See|'s __doc__ strqxan overview{h2"""def __init__", protocol=None, =,Jkeyencoding="utf-8""##.j e,;N) )g(svalue) =s.:Ekey)f = BytesIO(9preturn Uq.decode#.), Unpickler(f).load()#.V[ .1V>.V~-NDbfilenamewdbm" generic 8=0is 7ialized with{ Bz.@O, flag='c',  import dbm  DThe  parameter is the basJunderlyingC@data)". As a side-effect, an extension may be added tocBmore than on}8created. !oplaG"hasame interpreta1 !ofC*).e3specifiek>vPon ofu pickler See module's __doc__ strftverviewMQface.k2"""return DbE KF) """A lexical analyzer class7 simple shell-like syntaxes.1# MXsdocumenfby Eric S. Raymond, 21 Dec 1998 # Input stackerror message cleanup/QSR, March 2000 # push_source()6popmade explicit B@Janu2001. # Posix compliance, split(),1argsd # iterator\^Gustavo Niemeyer, April3iPchang/o tokeniz1re [lsNVinay Sajip, July 2016. import os $re sys from colle#s 0bdeque $ioSu IO __all__ = ["shlex", "  Pquote join"] &)K&Kdef Minstream in p,@ apunctub_chars*2'Pif isa( j&*4 = -0){P)pis not G$.l4 = F%# !OelseT sys.stdin4UO1 = "ifrQeof =.*%''(q0com-ers = '#Aword = ('abcdfeghijklmnopqrstuvwxyz7 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_' lf.wordchars< += ('ßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿ'  0'ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ')_ self.whitespace = ' \t\r\n'$_split = False&`quotesF;\'"BQescapb/\\d> <Astat; :pushback = deque()lineno = 1debug = 0Ptoken gofilesthAsour?6Non if not punctuation_chars:v  NelifC is TrueK{();<>|&_w  |4# _ a  queue used by lookahead logici N+# these X@ add^ecause allowed in  names, args, wildcardszBwordP+= '~-./*?=?wremove anyUfrom F a9.maketrans(dict.=]keys() G: = .Tlate(t) @property/deX(E)breturn[3WI1sh_?BW, tokGp"Push apen onto T@poppy2getI method""ifF>= 1 print("shlex:y3ings" + repr(H..appendleft' newstream, new_=n input >zlexer's.isinstance(t7strk = StringIO2 l0.in,j{)N2$ = (  "V   Tq`_x $ '  i%s' % @;els]V to stream %s' % (self.instream,)) def pop_source%!):"Pop the input % stack."& Z.close()T.infile, ,lineno) =)cwpopleftM"if$Vdebugprint('shlex:ping to %s, ce %d' \4 d46no)state = ' 'Bget_tokenAaGet a X fromNB (or if it's nonempty)hpushback4tokB!.AHEZ >= 1J$N"Nken " + repr(tok7`returnhU# No ' .%4rawCreadM{p# Handlclusions<i<jt Noneawhile jj2 &Dspec$Ahook.6>pecS@(newR, new5pec(p:7BK'# Maybe we got EOF Eead?):eofbif notg #5eofb;els+Neither in+@ nor!if'!' !=;rawEFEOF"B6rawn/oquoted = Falsexescaped;Tru#punctuation_chars and_@next4K 1& H&(1-Cxn= '\n'7.U += 1*B 3A  inte %r I see acter: %r",nr fstate is None:+ self.token = ''# past end of file:YbreakQelif Qstate == ' ':$aif not nextchar!%H None # 5n2 inwhitespacedebug >= 2(bprint("shlex: I see `s-")IuAor (posix and quoted) -mit current Qs?els~continuUcommentersinstream.readline( - }no += 1&! _escapd-a'dc%a *7@word % = [ 'punctuation_@c20=0 Zyo_split+ye0eEod = Trz.:$,%0EOF!s # XXX what error should be raised here?!p ValueE<("No closingyRzD:  if not self.posix:  $token += nextchar/ state = ' ')_breakOelse aaaaelif (E and2 inaescape+R 4dquotes)XdO" =l \{ \@ ( :# end of file"ifdebug >= 2\L print("shlex: I see EOF@ /")j# XXX what error should be raised here?<!p ValueE<R("No t d _acteryR# In Pshells, only the 0 itf1 orT #e@ may*d withinM-s.:+-q.~s 4p( !3$!=_rq/ {)'B *('a', 'c'  LzNone whitespac2-`sOword7 -orInduX"Lmit current QS~continuttcommenters~instream.readline(i- no12uLo~)P1N F emit current token _else:5continue%elif self.state == 'c'Mif nextchar in6punctuation_s;f5 +=J + 5notwhitespac  _pushback.append()>-O ' ')]breakqposix and _quoteK g#_escap-da\Aword5? or  1(|`_splitQ4:1 9 /))rm rpt"XEleftdebug >= 2print("shlex: I see  e"p!/ =o2or bQd # emit currenx ] presult =6h U;= 'F NonQ* 1#ifR  2raw=" + repr(q)$L7EOFcreturn ,def sourcehook, newfile"Hook called on a !name to beD1d."VRH1[0]"Qg )U1:-1]B2# This implements cpp-like semantics for relative-path inclusion.Jif isinstance(self.infile, str) and not os.path.isabs(new$G): % =.Tjoin(;dirname(self.e3), 5)Jtreturn df, opena"r")) .def error_leaderZ", [=None, lineno "Emit a C-compiler-like, Emacs-friendly^-message f!."}#ifm@ is p 7 = <<<<#r"\"%s\" %d: " % (w'no,__iter__(OYn__next-TtokenAget_(1if # =:eofraise StopIterationB split(s, comments=False, posix=True@"""S-@ theing *s* us Qshell syntax.""Nif simport warnings. Q("Pas_ for 's' to shlex.)^deprecated.",NGD$BionWxacklevel=2f0lexa .whitespace_0 = *x!ifPers = ''1!list(lex) ^_66andR"a wtescapedifrom *;*nA' '.bquote(arg)`yarg in =_find_unsafe = re.(r'[^\w@%+=:,./-]',ASCII).searchjsversion ofkcs\5"''u!(s%F 4s`# use m1le !s,:put into doub*#0$'bBthenNd as '$'"'"'b "'" + s.replace("'", "'\") + "'"S_prins.#erPvwhile 1tt = lexer.Iz&tt2*Qbreakn0("T : prepr(tt%Pif __t __'__main__'Rif len(sys.argv)$ "()bBelseDfF5[1]Bwith0fn)^ bf, fn)) """Utility func%s@copy ivs directory trees. XXX TheHhere don't O the resource fork or other metadata on Mac. """ import os &sy 4tattfnmatchcollection.errno try: ZAzlibEdel _ZLIB_SUPPORTED = True except IRErrorL/^Falsen5bz2m O_BZ2k .jElzmak __LZMAm /n _WINDOWS = os.name == 'nt' posix = nt = None if%!'9d elif Z nt COPY_BUFSIZE = 1024 *7t else 6 _USE_CP_SENDFIL:4hasattr(os, "sendfile") and sys.platform.startswith("linux") _HAS_FN<X, "_fcopy] # macOS # CMD defaults in Windows 10 :_DEFAULT_PATHEXT = ".COM;.EXE;.BAT;.CMD;.VBS;.JS;.WS;.MSC" __all__ = ["c~eobj",  Dmode Dstat 12",@," @1tre41mov$rm ;SpecialFile FCExec "make_archiO4get_;atsregister'y/un efunpackd% "<  ~c '# " tignore_patternsPchown Pwhich terminal_size~FSameW]a# disk_usage is added later, if available^Dthe  class 1(OS)|Dpass |(&"""Raised when sourcepdestinaP are xs*.} 3 b trying to do a kind of operl`(e.g. |Qing) `1 is0pnot supT ed 2a s  < a wd pipe) `a commO`could ube executedQAReadMQ #n XC canO:reaK"ryOE3ion D"a 'ry8l1ing3w8ies fails_GiveupOnFastCopy("Raised as a: signal to fallback on using raw read()/write() file copy when fast-cfunctions faiTado so.6""" def _1? _fN(fsrc, fdst, flags):5CZa regular}ntent or metadata byhigh-performanceIk3) syscall (macOS)2try| pinfd = .#no2out:dstexcept Eion as errXraise _GiveupOnFast(err) # not  gposix.F!, G6}OSError2err4ame2nam9!2" " if.errno in { .EINVAL,no.ENOTSUP}]  %Oelse7err from None_@send^ W9@5onecmmap-like fduanotherb f n2aYThis should wor`Linux >= 2.6.33 only.'q# Note:hobj() is left alin order2introduce any# unexpected breakage. Possible risksR zero sC+in#ar1# -@ canpbe open"a"(ppend) modL/rsrc and8Hmay 5ot"(ext3*a BufferedRea(which hides un ain a b-#),p GzipF8decompresses8), HTTPResponse ($de chunks;pS!y ,s (e.g. encryp}fs/parti ?Hglobal _USE_CP_SENDFILE w2srcl# Hopefully the whole@will`copied  a L22all#-m-ploop 'tG0EOFreached (0 return>B# sosize smaller@bigg1hanbactual,a#1mak41 di]nce, alsAcaseH1 co{Dchanges whT be6 Pblock = max(os.fstat(P).st_, 2 ** 23 min 8MiBp Y=7E%12: # On 32-bit architectures truncate to 1GiBavoid OverflowError, # see bpo-38319. if sys.maxsize < 2 ** 32:7Qblocke= min(,,10) -offset = 0while TrueL6try ]0sen2os.sendfile(outfd, inT%, u)\;except OSz as err^# ...in oderhave a more`ormative K2ion^@err.name = fsrc.  %2&2dst& ' if.errno == no.ENOTSOCKW) on this platform (probably LinuxV.6.33D# does not support copies between regular ys (onlyFsockets)" _USE_CP_SENDFILE = FalseE raise _GiveupOnFastCopy(errBO-@SPC:ystem is fullnerr from Nonea # 0 up_first call and if no data was2d2if 06os.lseek0, os.SEEK_CUR))*5err7els^T>= 0lPbreakA5EOFE70+=  def _copyjobj_readinto( , fdst, length=COPY_BUFSIZE)u5"""2)/memoryview() based variant of^g(`*fV* musPq methodtCboth.bxopen in binary mode1"""p# Localble access)Pminimsoverhea WQ_writ1  Wwith bytearray(H ))"mvBCn|:(mv6t nL8 el.# <3Pv[:n]sA.,(s62/wvm0b*-like object?dst *1-ot18 = l:.62dst 2Cbuf = fsrc_read(length) if not buf:Ubreakfdst_write(buf) def _samefile(src, dst)D# Macintosh, Unix.Iif isinstanc4os.DirEntry) and hasattr(os.path, 'eSstat']2tryj sreturn 6.4.=0(), except OSErrorVdFalse 4;`# All other platforms: check for  LBname.e.normcase0abs2U)) ==e6a$ctat(fnz#fn !fnEelse$fnUoislinkWais_sym)].SIcopy, *, followccs=True """Copy data from src to in the most efficient way possible.a,Ifd1 is1set"Vis a symbolic q, a new will be created {pead of 1ing it points to3"""Os.audit("shutil.>6 ",,i<raise SameFilesa("{!r} !ref. atl),_size = 0Pi, fnqenumerate([] Dast = _#j$ # likely doeQexistFEpass n# XXX What aboutspecial s? (sockets, devices...g0if .S_ISFIFO(st.st_mod&qfn = fnn1%fnD@`%s` a |d pipe" % _D6qWINDOWSji == 0(  O_7src3os.)@readHe)f with open', 'rb') as fsrc ^?tdst, 'w?:dst?.q# macOS6HAS_FCOPYFILEC try:  _fastcopy_ffile(fsrc, fdst, posix._COPYFILE_DATA) O return dst' except _GiveupOnFastCopy:2qOpass!# Linuxelif _USE_CP_SENDh/tr 0Ksend/Windows, see# https://github.com/python/cpull/7160#discussion_r195405230yWINDOWS and -_size > 0_obj_readintoEmin(M , _BUFSIZE)wn)) -# Issue 43219, raise a less confusing 9ion< IsADirectoryError as  if not os.path.exists(dst)<FileNotFound^5(f'oQ doesVN: {dst}') from e?elsmX@def HQmode(FE*, follow_symlinks=True0""" 5R bits`src toH.i,IfF" iTset, [s aren't,Qed ifAonlyif both `src`P`dst`8E. If `lchmod` isRavailabl)R(e.g.z) this methodeChing1"""{sys.audit("shutil..4", 0s 90_isFb)% %if hasattr(os, ''~stat_func,  =l, 4  ! CS __\[;Pst = 2#X#.S_IMODE(st.st_EM)) @istxkd,l/,  rextendepsystem cSibutee1to dEOverwrite 7<( g false wo%be. "S"" Etry: names = os.listxattr(src, follow_symlinks=)Gexcept OSError as edif e.errno not in (.ENOTSUP, EDATAjINVAL)LUraiseUeturn@for ksD CRvalue (geALDos.sHAdst,!, gOapeEPERMTr:J63elsdef _copyW*args, **kw `pass /.Bstat9*/CTrue?"""Copy file metadatathe permission bits, last access timemodificat*1andflags from `src` to `dst`. On Linux, `) also@ies "extendeNf ibutes" where possible. The`contenowner, and group arunaffected.$$ path-like objects ors given asstrings.=!If op 0al + `A` isTset, +{1n'tU1Qed if@only ObothE.?1"""sys.audit("shutil.l1", Bdst)GS_nop(p~ns=NoneFF #(aka don't ==:t@(_isK)  s..K#ifEQ# use re0uncLit existplookup(r.@ get4(os61|# *and* it supports^ Ofn = C4nzt_tO2 f=Tif isinstance,2DirEntry`@st =. Dc8"<"")gC 0mod/ .S_IMODE(st.st_mode) lookup("utime")(dst, ns=(st.st_aR_ns, mC), follow_symlinks=) 4# We must copy extended attributes before the file is (potentially)Hchmod()'ed read-only, otherwise setxV () will error with -EACCES.J_*Qsrc, Atry::"lo..omode, D except NotImplementedE[# if we got a+P, it'0Ucause]# *~VFalse%lchown()dunavailable, andP eiZ 1* fD-atF? or/ doesn't i AT_SYMLINK_NOFOLLOWk (it returned ENOSUP._ #;rE we're out of options--we suy cannot 7. give up, suppress*P`(whichKwhat shutil always did in this circumstanceApassaif has|'st_flags') , D!OSg as wh#0for'EOPNOTSUPP', 'E '0`errno,B)d`.q == get%MQQbreak+Nelse,raise defn(* CTruea@"""CAdata bits ("cp src'Q"). R's destinak!. 8The may be a directory),IfNf @s wo5#be,red. Thi;resembles GNU's %-Phasource# ay2sam~, a SameFileMboadV1"""if os.path.isdirBYUdst ="@join!,basename)^ 88\=2E>0etaK.M.bcopied stha. Plea'P funcymJoinform y be a directory. If follow_symlinks is false, won't be,ed. ThisBresembles GNU's "cp -P src dst".%1"""if os.path.isdir(dst):Udst ="@join!,basename(src))7qcopyfil,r,=8@statK8`returni def ignore_patterns(* """Function that canJused as ctree()K parameterP[ a sequence of glob-style vhAare eto exclude )s_ , ds&!d_Q = []h4for}4 in s% @.extend(fnmatch.filter(\,A=rIset(H _^entries,,y,#_f, %_dangling_, dirs_exist_ok=F<<i not None # =c`(os.fs`), [x. kxe]?elsT7)pos.makeWVVrrorspuse_src{:y =+jO2 orD0in M'ie, ify#in|<continue1src* D1srcYD?dst3?dst3srcobj =0 ifk Z:try$isEL.(M20andb == 'nt'^3# Special checkBPdirec# js, which appear aA# but we want to recurse/l^(.$91if @.st_reparse_tagG .IO_REPARSE_TAG_MOUNT_POINTP9!=  s [B"to@read} lf-K!@# We't just leave iO`H` because legacyK# code with a custom Hmay rely on copytree  # doing the right thing.-os.symlink(to, dstname)0copystat(srcobj., follow_Nds=not L_else:b# ignore danglF1 ifflag is on@0if {os.path.existsS) and`_`bcontinupotherwise len e 'q occur. 2 will ra%an errorsrcentry.is_dir()  5#s,,n_function, dirs_?I_ok=E ^ Q_elif S N,y   7# W SpecialFileE for unsupported file types 1q# catchd1romrecursiv* so that we caA$# a with rexcept d as s.extend(err.args[0]D%OSF?whyF0appFistr(why))W'trA43$w `# Copykaccess times may fail on Windowif getata, 'win', None)  +, ifd6ors?A=a2ors`returnQ def?]ts=False=,0l=F215O 8dD"""R!lyk a^pectory pdestina*!. $ j dictates whe7 togion in case"q or anyL@missfparentk already sz2If Jbion(s)C, an"is{dEa list of reasonG op%al Atrue`bolic s in the source tree result in symbolic linksthe destination1; if it is false, *contents offiles pointed to bydBhare copied. I:9!byN0sym0 doesn'tAexist, an excepwill be added@listerrors raisF@an EE!att0end6py process. 8You can se.oal ignore_dangling_`s flag true if youJ@wantPsilen6hisa. Notiis has no effect onFplatforms that don't support os.KThe argumena callablegiven, iy!isqed with,`src` parameter, which#?directorybeing visi byy ()d `names`DBnr, as returnedg0os..bdir():a(src, dC) ->!d_/ Si3cop?ed recursively) |-oGfor each Gt1s a@} relative&P Oashould>0notX Q_func5B use\!toD. It !solpath and,Xss. By default,n02(), but anLe same signature (likkAy())!be1"""sys.audit("shutil.-1", :Adst)+[0canm@src)Aitr:!ventries = B(itr=$ _^()=m=q =d$s= ,gk=B=qA SHQdirs_I_ok=P) ifPattr(FBtat_`, 'st_]_ibutes')U# Special handc bjs/@makevm behave 6#Us@ rm1, sin generalDPy do \appear asIrregular;.Rdef _M0_isy2try Qst = &.stat(follow@ =Fm=/E(0.S_ISDIR(st.st_mode)tnot 0 (st.st_file_attributes & stat.FILE_ATTRIBUTE_REPARSE_POINT Band Oreparse_tag ==L%IO@TAG_MOUNTJ%))Lexcept OSError:jreturn False  def _rmtree_islink(path)86try Est = os.l.Ke(.S_ISLNK$mode) or04 DBelse Idir(entryI )(@.is_5follow_sym!s=G0os.. # version vulnerable to race conditions aunsafeP, one I@withE@scanS) as 2_itX&ies = list('C(os.3 , l, sys.exc_info(@2ntri![]@for ~Ay in 6iesfullname =yI8i^I! #ifP$is(8'# This can only happen if someone replaces7# a directory #a  after the call toC` / above.8Traise("CannotjA on `bolic " $,  Bcontinue4Np#QPos.un(LC9H Pos.rm$yqR3PC # V?using fd-based APIsHprotect againstX NL_fd(topfdi  8W7err: err.filename = path onerror(os.scandir,!, sys.exc_info())2areturnfor entry in Aies:^Cfulls0os.v`.join( ,/ y. [6try?Cis_dir =.(follow_symlinks=FalseFexcept OSEQ4Kelse)"f n  uorig_stOstat 8q0 = 9.S_ISDIR(Vw.st_mod7 $l^$, <continue2i dirfd = os.open(3,O_RDONLY, dir_fd=topfd cm ifP.sameIf.))9C_rmtree_safe_fd(1 :!os.rmdirl_7k $>o@<# This can only happen if someone replacesX 0# a{ectory with a ^ after the call toK I9 or above.@ Traise("Cannotz52 onbolic "N "."U$ is]kfinallos.close0$Pos.un X @ _us_functions = ({(' NO} <=Waupport_fd and,candir in os.supports_fd and os.stat in u3*ollow_symlinks) def rmtree(path, ignore_errors=False, onq=None):s"""Recursively delete a directory U!. -*IfX is set, WSs are!d; otherwix$if{G6 itAcalled to handle theQ with arguments (func,Cexc_info) where SplatformY` impleAation dependent;I3ujAthatP5caused it Pfail;`FJ a tuple returned by sys.$\(). JF@is fW1R, an excepis raised1"""Ciaudit("shutil.0", 3)%i G%c(*args&ApassC&elGHif _use_fd_sHS# Whicunsafe works fine on bytes,9Pfd badoes not.hsinstanc': @th =qrfsdecod-<I# Note: To guard agaX @ racRwe usu6dar0# l()/open()/ff trick6try}rorig_stD!%$ E, ?A(os.=,RH "fd,=O_RDONLYLI1 s.Q.sameb@t;fd)_9_vd_fd(fd!/ os.rmdir80OSE ?uKZ \NelseN#s"ie forbidden, see bug #1669 ("Cannot @on ap`bolic "K isM lfinall[s.close(fd A 9&vsZ to directories are forbidden, see bug #1669 'raise OSError("Cannot call rmtree on a symbolic link")Gdexcept@:f1oneUos.path.is= , , sys.exc_info()R: # can't continue even if S hook returnst" __unsafe(L) # Allow introspection of whether or the hardening against # attacks is supported?8current platform .avoids_symE_C= _use_fd_funs def _basenam)rU"""A ) variant which fir`trips Ptrail`slash,Ypresent.:Thus we always get70las@mpon!ofMfor directories. N!: Union[PathLike, str] 2e.gwD>>> ,'/bar/foo'#' X/ /0'-;U&V1"""1 = fs 52sep.4+ (0altCor '!> rsb(sep))move(src, dst, copy=2Recursively 8p a filey to ano@locaP. Thipsimilar)Unix "mv" command. Rj `'bdestin^I a"yZ~,masource!isd inside(e j]Q mustqalreadyISexist+ 'Ps but it may boverwritten depend^D2s.r) semantic} is/Dour /oasystem%n Oris used;O0wisY rc`copiedV0and>K4Bd. S}:$`recreaPunder/P new x.ofails because5Bcros`The op@al `p` argumaAis a0ablat will be!to".Vi*Qdeleg"tok`7By defauli02()<X,Dany T thatI2samsignature (like0())sA lot mor%0ulddone here... "ok at a mv.c show 9"of he issues this implement ation glosses over. """sys.audit("shutil.move", src, dst)'real_dst =if os.path.isdir(-:aif _samefile(M $# We might be on a case insensitive @usystem,\< perform the rename anyway.)2os. breturnYUsing _basVinstead os important, as we mustcq# ignor` trail]slash to avoidS&%''Gv@joinu,&))texists(H)raise Error("Destin; '%s' already IE" % L6tryT u *except OSp5aislink @to =|'"aos.sym;to,%Pos.un# D)el;src4d+0src@0 e ]pCannot f a directorydinto itself?"0.z/if (_is_immutab #+@or (os.accessTos.W_OK) andpDlist  oH,UAplat== 'darwin')B0Permission(("'non-empty3# ]"`: LackVuwrite pr".P"%  Qscopytre , P_func= 3 js=Truee$rmcJelsey e7o3 def _2src-@.abssi7.E0if |src.endswith(-7sep3h+aH.sepA?dstA AARstart FkV_statn`es = [".UF_IMMUTABLE, S]hasattr(st, 'st_flags'4st.L in p def _get_gid(name): """Returns a gid, given Proup +A."""-!if is NoneBFrC *6try from grp import getgrnam*except IVError9W result =P()V=KeyS5+3if Jais not #1[2]4 def _get_uid>[8n u\AuserK[27pwd[/pw[;P[Wmake_tarball(base_!, dir, compress="gzip", verbose=0, dry_run=0,`owner= 0, g Clogg(Create a (possiblyyed) tar file qall theqs under'"'.*'' must be (@ default), "bzip2", "xz", orFq' and 'P' canNused to define an ,+a@ forarchive thatbeing built. If#provided,6 currentXNDwillThe output4'"d % ' + ".tar", wAplus^"appropriLion extens @(".g3@".bzAor ".xz")N.gb8RDtar_vA= ''>elif _ZLIB_SUPPORTED~.P == ''N (gzP?BZ2O -P 8bz2QOLZMAR /xzO xsaise Valuep("bad vvAaformatpf @"supVed : {0}".8(K"))i}0tarP # l3Pbreakcircular dependencyDT0_exy '. %ifT elseY" =d@ + 'La=5dir = os.path.di@$e(G$f 4os.path.exists(archive_dir): if logger is not None& .info("creating %s", TSIzdry_runLos.makedir >%# _the tarball $'C4tar"')cuid = _get_uid(owner)bggid(group5bdef _s3_0tar HAE2.%Q= gidt_qname = }"0if \%=+:\u\"`returnk$!if  O=+file.openU\, 'w|%s' %$_compressiona*rytar.add(bas, filter=p@ofinallDcclose(! }@_zipt&, verbose=0,  `=1"""hpe a zipe from all ds under 'a"'.dThe output>will be d3 ' + ".zip". Rsb!0 of Q.!1"""Qimporn # late for breakcircular dependency@zip_>u=6 jxdir = os.path.dir+v$ifA and~7Zexist-B rQ '10add{qto it",ML{@withh.ZipFile(J/"wq}=C.ZIP_DEFLATED) as zf:@norm 0if ! !7jcurdirPTzf.write(,,2"! # "\)2dir{se@s inFwalkG0/tsorted(MarJ)@joinD(,D))  zf.write(path, &)  if logger is not None:+5,.info("adding '%s'"dfor name in file s`` = os. P.norm (join(dir,U)4 isu)v.-236preturn zip_* _ARCHIVE_FORMATS = {.'tar': (_make_tarball, [('compress',t)], "unaed tar "), } if _ZLIB_SUPPORTED, }@['gzw?] =w 'gzip')],"*-"|Rz0zip/0, [3ZIP?BZ2b_bzip2+ aOLZMAx/xz;xz' def get_archive_formats(!A"""Rs a list of supported . Beand un!. Each elemenFQthe r\ed sequenceya tuple (, description 1"""Q}3= [+registry[2])B1 in9~ Y.items()])bb.sort(}]' @`+erE@func, extra_args=Y 8=''scers anXesM,E 0of $. u$callable that will be uso createns. If providedRa!ofFbvalue)sl@ pasjpas arguAs to.Ku can be1b , rTM!byb%xW'if9B = [(!if.(~7raise TypeError('The %s objectgpB5' %xcisinstance(1, (2, list)):  &raise TypeError('extra_args needs to be a sequence') 9for element in 7:#if not isinstance(1, (tuple, list)) or lenV) !=2GK U s are : (arg_name, value)') _ARCHIVE_FORMATS[%] = (function,, descrip) def unregister_archive_format(K)Odel kEDmake?S(baseJ, root_dir=None, "verbose=0,dry_run=0, owneBSgroupNClogg"""Create an file (eg. zipRtar).G'' is the 1 of ;Ato cU, minus any -specificextension; ' UbP: oned"zip", "tar!gz M""b !"x Q. Or~dother #edva directory that will* ; ie. we typically chdir into '@' before*0ing?H2. l1dir~PwheregSstartGQfrom;ICcommon prefixX1alld>k0ies~8andboth defaultH toP curr-Wy. ReturnEh!' n'used whenHSa tarTe. By42userZYX.1"""sys.audit("shutil.",S2dir4save_cwd = os.getcwd(%ifV8S2if # .debug("changwF%s'"u5path.abs/kK1os.(y%if bcurdiri!kwC= {'o3': 2, '#':}56tryR~_info =]except KeyDzVJ("unknow- 'b# % )  d# ="[0{J1argi#&1]@[arg2valY#ifU != 'zip'3''] = owner  kwargs['group'] = try: filename = func(base_!, rdir, **Q)7gfinallDif root_dir is not Noneeiif logge#'$.debug("changing back to '%s'", save_cwd8os.chdir(treturn def get_unpack_formats()A"""R3s a list of supported . ABing.\Each elemen6Qthe rLed sequence%qa tuple(pextensions, description1""",}3= [7info[0], 13])S1 in:" _UNPACK_FORMATS.items()](bb.sort(}X'?d_checkBo(s(P, extra_bC?`s whats registered as an\4er. # first make sure no other,[Ifor this\existing_Q = {}4 > /-S3bext in&0] p@[extj;EKN&if$ -{Pmsg =7xalreadykvQ"%s"'2qraise RryError(J&% ,262]))!if9callable(>2\BType!'T^73 must be a O#')Kr, = 3=''PO9` `3 u 6. `(correspond:7to Fl`*I( tbwill b@usedz archives. }72ureceive$7.If it's un`handleX, it needsaa ReadGAexceo;If provided,&lav!of?bvalue)s@ pas0rgu(@ cans'bea, and .%be!by(w gs is None:  extra_args = []  _check_unpack_options(extens `, func&, @)<UNPACK_FORMATS[name] =(> , descrim def unregisterpformat(T!):o"""Removes the  &Q fromFary."""5_del _x_ensure_directory(pathqEQ that`uparent /P of `3` existsx ir` = os.!".daeif not!cisdir('os.makedirszipfile(v ctJA"""Ud zip `+a` to `/``import31 # late for breaking circular dependency LC.is_ raise ReadError("%s is(a 1" %)e=! g.ZipFi2tryJipinfo in7. Wlist((d0 = .\sp# don'tract absolutths or ones with ..pAthem?#ame.starts*P('/')<@'..'4x5continue`targetv@join0, *Ta.splito&W6ot L~TDc6endk# 5+Aopen-, 'r') as source, \6:5R, 'wb<6@copy Dobj(d0gfinallkzip.close()0tarI tar/tar.gz1bz2/xzw Dtarobj =%.Q QexcepGA.Tar[   compressed'un1tar! .8all  NA = {'tar': (['. 4], r, [], ""),G5zipG G8G2ZIP), } if _ZLIB_SUPPORTED: _U8NPACK_FORMATS['gztar'] = (['.tar.gz', '.tgz'], _unpack_tarfile, [],  "gzip'ed tar-7") if _BZ2_SUPPORTED:H+_Ub2bz2 &_bzip2OLZMAxx(x((,xzdef _findypformat(FRname)6@for , info in Hs.items(/3extension2:2[0]Q"4if k.endswith(7O-areturn`None Auarchive, extract_dir=/",  jA"""UC an C!. i`` is the1 of ,l/target directory, whereKu2is ed. If not provided,.current workingSEusedP: one"zip", "tar &!",Aor " ". Or any other registeredX-. C_rwill ush>and see if=!erJ;waswV that=In case nis found, a ValueError21rai4k1"""csys.audit("shutil.%", fa)A ifm4 = os.getcwd(? Bfspa-T)@E&MwU 6try *_, =[]~.except KeyX Kbv("Unknown: '{0}'".\()) from Uocfunc =8&[1, **dict]:22])GFelsep# we nedo look aters supportedsGx / OAReadlN\o O0ile)J) !@]Skwargs = > [format][2])  Vfunc(filename, extract_dir, **kwargs) if hasattr(os, 'statvfs'): __all__.append('disk_usage') j_ntuple_disk = collections.d#!(' ', 'total used freK.(.__doc__ = 'T9space in bytes' ._<Uo;;\Free ;w@def _q(path):"""Return $ $ cistics about the given ?%. ?<ed value is a P Q` with cibutesXaU' andL'', which arewamount of k,"an,j.N5""" st = os.2vfsw = st.f_bavail *efrsize)*_locks*B = (T*-Tbo)8r ({,) elif _WINDOWS \ZXs[ = nt._getKJ j4! -I {Qchownbr=None, group """Change ownerAry*Z8use'Rcan buid/gid or)/v!s,]in that case,Atheyconverted toBpir resp3ve ^sys.audit('shutil.!',)"if0is praise VpError("23/or&@mustCset"b_&=g_`=3# -1 means don't c!it3 ]!-1(#f `eitheran int (@uid)a stringasystem<8isinstance(,70A_uid%?y7^PcLookupQno such user: {!r}".format(user)) if group is None:_A= -1elif not isinstance(#o, int)9_get_gid')FZ3if ] u raise LookupError("no such:os.chown(path, _,np) def terminal_size(fallback=(80, 24)"""Get the (1 of = window.IFor each&wo dimensions,:environment variable, COLUMNSand LINES respectively,checked. IAdefined andGPvalue`a posiJpeger, iS usedDWhen3 or!is_p, whichTacommon case,v connected to sys.__stdout__Abquerieby invoking os.b0can be!cessfully _, either becausesystem doesn't support7Pying,4 we are not? $a ugiven in Z parameterC"is{# Fz defaults- n"@ by many emulators5BThe Pretur%is a namAuple0ype|.m1"""p# columQlines1worgs,6try7 =C(os.#['"']except (Key0, V  P0{ nlVjLhC# on\y9 neq1ary$if!P <= 0B@ =} (8.fileno()/=3Attribute-9A, OSB:"# , closed, detach or oB#)V#unW0 n SEGQ.?if =. H" (\,Rl@ # C that a  can be acqed with correct mode. # AdditionaN`G`B@a di7ory, as on Wx5s #ies passhos.access check. de2f _access_check(fn, mode): return (os.path.exists(fn) and os.>87;$0not(?Pisdir>) def which(cmdv=os.F_OK |3`X_OK, 9D=Non"""Given a comman<,a PATH string,1theHpconforms to gTqmode onIP, or }0 ifre is no suchHafile. `>` defaultZo0. ` &aresultH ofenviron.get("!")can be overridden withustom searj1"""\# If we're aD directory part, look it up ly ratherNthan ref ngM-ories. This includes hing relative53theQucurrentBy, e.g. ./scrip"i"pdirnameDyic%)1cmduse_bytes = isinstancr!, )("ifL!is3BR/ =,,)~EI6tryV^str("CS_"W) except (AttributeError, Valu 5#Y)] t availabl30def # bpo-35755: Don't usej*o m@varim7 isN0setFan empty#E='' doeskmatch, whereas!:' o0if D1 if4'5fsencode(! =D`.splitw,Bsep)3Oelse^/de^sR+if sys.plat == "win32"h^# The takes precedencFWindows.;bcurdir 4 5> % if]!inF#.insert(0,/ )1EXTe0aryX Text_sourcebgetenvAEXT"5_WIN_DEFAULT5EXTF = [ext for `2(Bext]H4W= [os.fsencod e(ext) for ext in pathext] # See if the given file matches any oexpectedEQensions.MThis will allow us to short circuit whenk"python.exe"GIf it does, only test that one, otherwise we havel7try# if(cmd.lower().endswith,4%):X<&s = [cmdOOelse( +7 =B# On platforms you don'things like PATHEXT0ell+0# w6p suffixre executable, so just pass on cmd as-i?A_seen = set()n4dirn@normP= os..case(dir=Zpif not /0in dH$S.add(&>0thes@&Vname @join, 3 T2if _access_check(Ck, mode.preturn (None imp_signal from  *Denum@IntECas _ _global D() ._convert_(!'Sv`s', __5__,alambda 7)`.isupp;0QAand b.startSp'SIG') (_enum_to_int?9), ?())3:B("2, Hx>s) 2getyZN,pif 'pthmask' in _globalsz e 2 `(how, Usigs_set7 Iset(cAx, Ss) for xcosigpending-({\c()} Owait* *:set7sigb8sig* W rXSvalids 0 N+ KQ5del,& This directory exists so that 3rd party packages can;installed here. Read the sourceqqsite.py more details. """Ap! m search paths0kthird-}pto sys.&O. *,1 * is automatically imported during initializ?. */bwill a4-specificte+. On Unix (inclu Mac OSX), it starts with<refix and Kbexec_p(if different)#s lib/python/. On other platforms (such as Windowstries each of3 e0ly,5 we q ed. The resulting directoriles, if they exist, are appended to sys.path, and also inspected for path configuration files. If a file named "pyvenv.cfg"ps one directory abovetexecutable, Prefix#_p`re setHthatOnd it is Schecksite-packages (cEbaseT!ndwwill always be; "real" Aes oR Python installi). If (a bootstrap G)tains the key "include-system-"  anything other than "false" (case-insensitive),QVlevel"stso be searchJ;p1wisy won't. All`resultMEifici   A)BwhosA hascform <3>.pth; itsBents;dditional (per line) tF; addq. Non-iwor non-)r^neverLE; noyo@ moran once. Blanksj@ginnwith '#'yskipped. Lines star% 'import*@ uted. For example, suppg}>v3s /usr/local*e$a/lib/pA2.5/n!s three subW, foo, bardAspamA two: s540bar . AssumeR,Q following: #% )fQ  letch and YKKbar Then Bns 0, i4is orderkm/t/ -foo Not1t b@omitwbecause it doesn'tN;Qcedes4+P comephabetically bef 0fooL;O is tis not men ed ei O.qP readSb modulQdautoma^ en0 co3pu"atGrt it. This canoverridden in customize, userpcustomize or PYTHONSTARTUP. Starting Python in isolated mode (-I) disables automatic readline configuration. After these opers, an attempt is made to import amule named site, which can perform arbitrary additional 6-specific @. If thissfails with an IError excepT1, isilently ignored. """ 4sys o ubuiltin_ io # Prefixes for-packages;$ p+like /usr/local here PREFIXES = [sys.. , Rexec_] # EnableOK usew directory # setqto Fals the featur[1TruXforce ENABLE_USER_SITE = Nonedistutils.commands.install # ThI@valure initialized byh0getbase() and uM() # funcs, throughAemain()T whens"=s. 6BAS def _trace(message): ifflags.verboseTprint2p, file=stderr) Ymakepath(*sZdir = os.T.join y6tryh ,0abs4Q(dir),1 OS7Apass!return dir,rPnormcyG@abs_[#s("""Set all0 __!____cachedttributes4bsolute Qw16@m in(*modules.(#()x,rloader_"z  .Cm.__3_._F!__04A ;# dTh2__.m9q' 2if U@ not>{'_frozen_nlib', _external'}Ycontinue # don't V PEP 302-supplied? (,a, Type9 "5<removedupA! R duplicate entri81rom_3 along with making them absolute"""# This ensures that- initial path provided byterpreter containsNEonlye>names, even if we're running fromSbuild directory.OaL = [] `known_s = set()0for6 in sys.!:P# Filout duplicate s (on case-insensitive fileItems alsoL if!y `differwD); turn relaHes into J@dir,Jp = make"B(dir%%if#0noty+L.appendA31.ad!uf@q[:] = L!re8 def _!binfo()B"""R2aall exist g! il .d.+x6try Bif o.y s(=!!_, .)d90:except TypeError&AinueOUdKaddpackage(site5', w"""Process a .pth`within C-Ps3QFor each lineJ"tha, eith!mb t XR@dir <Lcnd add5o , gxecute itit startsV'import '(ifG is None = reset = Trt7elsFBFals@fullu% =5Jjoin_trace(f4: {KB!r}"2 # locale encod=1is deal especialli Windows. But we have used#_a long time.}puptools.ew2too|f = io.TextIOWrAr(io.open_code(%),"="+OSQf%n,enumerate(f!if%.CGK("#"%) j>rip() == ""#< &Q#("3", O\t")APexec("!3" = 1rstZCdircase = makepath(sitedir, line)  if not dircase in known_<s and os. .exists(dir):GV#sy*aappend*)b1.ad)} except E>iontprint("Error processing {:d} of {}:\n".format(n+1, fullname),p file=jstderrimport tracebackHfor recordR(_Pion(*gexc_info()ZOMW`.split/s(5#P' '+,,2"\nRemainderF ignored"FBbreaif resetq = None?Yretur~ def addD=B"""Add '0' argument to jb if mi+handle .pthAs inG1"""_ (feidirectory: {sB!r}"0)ifJ!isQ_initu p=b = Tru(FelseFBFals #, ZZ = ma+ j?.4) # {acomponent=6tryk0s =ztlistdir-?1 OS8CuC[  @ 0in s .endswith("1")]>0psorted(.sgaddpackage,[,/check_enableuser?@"""C is safeinclusion The function tests&the comm6q flag (=dqenvironY3varH uid/gid equalyeffective.P: Disd{security reasons)1by ( opr-0: S9dM!ifPs.no_R_X O  if hasattr(os, "getuid")( eO!#  I == _ if0getFA() !p(_ if hasa ttr(os, "getgid") and hasae3: # check process gid == effective-if os.getFS() !=Vgid()U\return None A True # NOTE: sysconfig it's dependencies are relaTly large but site module # needs very limited part of them. # To speedup startup time, we have copy1 # See https://bugs.python.org/issue29585"Co<._getuserbase() def /@env_# Kpenvironc("PYTHONUSERBASE",L)L4if 9Grv# VxWorks  no home directoriesPsys.platform@"vxw8"a@joing(*argsros.path.expand*;7)aAname'nt~&APPDATA") or "~"ev@A, "P"q qdarwin"`_frame  ]"~", "Library",.8,"%d.%d" %2version_info[:2]J m`.local3 toFOC_y('purelib',\0+'_'*& =V.F'nt' ver_nodot>winver.replace('.', ''4f'{2}\\{L0}\\-packages'''tR/lib//k3U[0]}. =1]}L !;A"""R7s `  ` y .?The%can be used tore data. Iq globalvariable ``o_p'`` is not initialized yet, this function will also setO1it."""j [&ifjV,+ =7=&( R$ ZY-specificLVj 5 1OSITE1 5 1 [, ENABLE_Nuserbase = get"userbase() # this will also set USER_BASE ifSITE is None:P!qENABLE_UC= False # disable A site and returngf7elstWP_get_path(J)K, def add(qpackages(knownD"s)"""Add a per-2 to sys.vlBEach(has its own python directory withJs in theFhome-.1"""P# get*Gcallmake sureo@ arem_trace("Processing5!"),M_ =*#s(=if oFa.isdirM0addQ (, 0get?prefixes=gA"""Rxs a list containIkglobalBies.PFor e y present$``|a`` (orZ``PREFIXES``),functionAfind]`V` subs`dependo\system environment,<of full SswJQ = []`seen =>$= ?0for00fix/' dif not# -)-2inuZ#R.add(Y li>s2lat#"if != "lib"v8@s.ap("jif os.sep == '/'=A s# =I S.join", 5A, "%d.%d" %version_info[:2]J{ 8C*4Q;77 "u'HEq, JvR;s") for sitedir in getpackages(prefixes): if os.path.isdir(17dir#*3add!, known_;1s) Qhreturn def setquit(U """Define new builtins '$' and 'exit'.VThese are objects which make the interpreter 9 when called.The repr of eachJ` conta|a hint at how it works1"""F,sep == '\\'Geof = 'Ctrl-Z plus R ':Oelse-D (i.e. EOF)'.@ = _zQuitter(.a, eof)d"7'7copyrighUSet 'credits'^q.5 1_Pr%("$f", sys4!ifplatform[:4]uGjavawsq#"*",Jython is maiQed byedevelopers (www.j3r.org)." Q """\"Thanks to CWI, CNRI, BeOpen.com, Zope Corporation?`a castthousandsNfor supporting P ment. See p 70morih3.""files, dirs = [], []n# Not all modulesrequiredhave a __D__ attributeFvPEP 420rdetails`if has:d(os, 'M'mehere =dirname(os.., s.extend(["LICENSE.txt", &"]10LPjoin(w,vrS%,  cuF#`licens 7"+"https://S/psf/2/3%) dhelper`H->enablerlcomplFA"""E default readlsconfiguactive prompts, byregistera#!__R0chook__!Ifi can be im1ed,%9P willbTab kev3as b1keyfB ~/.._history as dDThis~overriddenJcustomize or usero a PYTHONSTARTUP file.  """ def register_readline():!import atexit6try#'B)lcompleterexcept IeZErrorWureturn 06# Reading the initialization (config) file may not be enough to set aN>key, so we&one first andn n `.F6_doc = getattr(@, '___', '')8izq 1 isNzt'libedit' i|e #D.parse_and_bind('s ^I rl_e~OelseIWtab: C . __(/OSS# An  here could havny causes, butmost likely onev#Q1tha*0re'^ .inputrc` (or .c!inW{case ofOMac OS X + )expected loc@. IL0at M<, w@wantaignorew6ion\Fpass6.get_current_history_length() == 0# If no + was loaded,1ault.pythonR # The guard`necessaryavoid doublgfsize a<# each interpr `F whe alL"y Kured1thr a PYTHONSTARTUP hook, se# http://bugs .org/issue5845#msg198636j= os.path.join( expanduser('~'),<'k. _ cf m0UW  ^Twrite! C5 $# bpo-19891, 41193: Home direc@ doetPsuFA# or0ot Pable,`system#Z-onlyF=(.S(`I)asys.__`activeN__ = venv(known_ysglobal PREFIXES, ENABLE_USER_SITEoenv = os.environ 4 if sys.platform == 'darwin' and '__PYVENV_LAUNCHER__' in env: executable =Pi_base_os.environ[U]NQelse: Y A$ exe_dir, _ = os.path.split(0abs(:!))<site_prefix=pdirname/Z+pys._homANone@Aconf0 = 'pyvenv.cfg'!andidate_+Qs = [file for Ein (#'Djoin,0z/),2 6 5q%ifG is($!] =Jif cqvirtual, =("[0qpsystem_ = "true"_# Issue 25185: Use UTF-8, as that's what the } module use'enKqwriting,.with open(, encoding='utf-8')wf@line Qif '=0% ; key, _, valub*.partition('='|0 key = key.strip().lower(.^2T ifU include---packages'B/r 'elth\ Zw..4B# Dois here ensuresPtakes precedence over_r @0add_p(known_y@s, [(]){ 6 will process P` again0itsjPREFIXES@# buGok; Xevent anyth beadded twicI .insert(0, _9M$ ENABLE_USER_SITE = False?hreturnp def 9customize()r"""Run \ specific code,^Pavail2.""2try@ aimportNY&izEexcept I$PError?6excQD"c.E9= 'Ipass*`WBraisEion as err:  if sys.flags.verbose: excepthook(*_info()),/el:stderr.write(,\-"Error in sitecustomize; set PYTHONVERBOSE for traceback:\n"M%s: %s\n" %(__class__.__name__, err)) def ex%er"() r"""Run  user specific code, if available.""2try@ aimportNY5izer! I$&fas excQD c.P == 'M',0EpassdBraisE@ion &rrZAu AeGmain4Add standard-6directories to the module search path. This functis called automatiy when t+mI2is c1ed,Haunlesslpython interpreter wasrted with(0-S .@global ENABLE_USER_SITEPorig_! =Z 1[:]AQknowns = removedup#"s(J6if B!Cq#9 might makes absolute# fix __file__ and __cached__ of already6oG2abs"() Wvenv( /w is Nonn "= check_enW'*dd = add packages 3O/ssetquitpsetcopyrlchelperaif not6s.isolatedprlcomplx;{-ifhM # Prevent extendingi(  -S! #B =r. 0no_Mt_script)q = """\ `%s [--e-base]N]Z Without arguments print some8@ful r!onX4 1_value of USER_BASE and/or USER_SITE separated by '%s'. Exit codes with --user-base orQsite:0` 0 - $  directory is enablg? 1)1dis*L[22Qsuper8or for security reasons">Znknown error1"""args = sys.argv[1:]pif not  x_ P= get!()3_"packages*pprint("ypath = ["Hadir in"i? %r," % (dir,)C"]Vdef exists(R)S0if @NoneQ@ os.o.isdir9return "_\5elsC2rdoesn't9!f"qBASE: {^rb!r} ({l(7)}) A AAAqENABLE_H 7!r}zrexit(0)j`buffer]'n' j2.append({4if ??2if `-sep.join(&T!-VPS the !q number}Aaclass B+-cSUUse `('`concrete SMTP proxy class. Uses `PureProxy' by default. --size limits 3Restrict the total 3!ofincoming messag#! "O" number ofZMbytes via< RFC 1870 SIZE extension. Ds to 33554432 =qmtputf8\!-ucaEnable`SMTPUTF8[ and behave as an 6531 smtp p/cQdebugY!-d`Turn on geprints6Ahelp.!-h5P#U this(0exi0Verr: %(__v __)s If localhost is not given5n `'Qused,i84por8 8D80251. If remoteg i9h,g """ # Overview: # # Tfile implements; minimal Ptocoldefined i@5321Pt # h hierarchy ofes whichdc backend functionality for! #Vd. AP0areRvided Server -CR base2V t`. RaiDNotIedError # if you try@use +30bug{ns>"y U eachhit receivesqstdout.}% #0 - +ties all=@a reCmtpdHdoes finaldelivery. One knownblem withwthat it Gn't handleKecs fromHs] at". =Pshoula fixedF(contribu s welcome!)pMailmany - An experipal hackzBworkCGNU 5evsrA*j!d,I2maiwill automatically0ognppaccept 1Q dest )to$ os"st`createEVO a F@gets`warded&,R9bgain, Nd correctly ye # Author: Barry Warsaw *nn! = , = / , = /_[(,ifC9 Gaise'("+; ucannot"r 0" b4t to True at~same time"(if _emptystr2= 't#qlinesepr#3dot".B0newE3 = :Oelsetystring = bG'' self._linesep = b'\r\n$2dot#ord(b'.')I0newLIGgPset_rfstate(Aseen_greeting =  extended_smtUFalse# command_size_limits.clearlfqdn = socket.get%Etry:[/_peer = conn48namexcept OSError as errJ# a raceGdition may occur if the other end is closing# before we can get9 -F if.errno != no.ENOTCONN07raisUeturnnprint('Peer:', repr(~), file=DEBUGSTREAMpush('220 %s %s' % ?, __version__)) uPdef _Spost_data_]v)"""Reset  variables to80ir AR-DATA#A."""bM.w]:8zCOMMAND'mailfrom = Nonrcpttos = []7require_SMTPUTF8 = num_byteB0Aterminator( '"2all&! received G2[] # properties for backwards-compatibility@,%b_servewarn("Acces _( attribute on pChanneldeprecated, &*b"use '+p' instead", D7ionWarning, 2!rL mBq.setter }, value1SetUE%A$ " = &% r$ E!@_W+%ed_lines' instead", DeprecationWarning, 2)  self.received_lines = value %@propertydef __state(;!):Mwarn("Access to' attribute on SMTPChannel is dUed, "JN"use 'smtpnO' inpreturn .A^@q.setter , Setting-?set$ @gree*+Deen_J%D%@_Tn/%=mailfrom l*%oEm?/%E8qrcpttos )%D>.%D7Adata &%SJ DP(self, value):# 0warn("Setting __data attribute on SMTPChannel is deprecated, " F"set 'receivedJ' instead", D9ionWarning, 2)Yself.= = value $@propertydef __fqdn(9!):Access to&%Puse 'gpreturn .;@q.setter , M%AOpeer&%A;w0@__ +%A4?con&%A; +%A4?add&%A; +%A4 # Overrides base class for convenience.Cpush7msg~asynchat. _ -abytes(Gw msg + '\r\n', 'utf-8' if require_PpUTF8 el]ascii'))# Implementation ofabstract method~collect_incoming} limit = None if self.smtp_state ==COMMAND:,3climit "max_command_size_0/el^ODATA[OdataT1if eB andnum_bytes > VjreturnB 'Kp+= len()<_decode_F received_lines.append(strO, 'utf-8')YOelseIv!) # Implementation of base class abstract method3def found_terminator()_emptystring.join-.print('Data:', repr(O), file=DEBUGSTREAM5 RQ = []uy H  too long = getatt0, 'S_' + , VCPQ "%s"recognized' %o i J(arg/ v ^ z!}o451 Internal confusionm4+ =W ktc * S&,$52CToo much mail E6 # Remove extraneous carriage returns and de-transparency according # to RFC 5321, Section 4.5.2.*data = []for text in line.split(self._Ysep):3~"if6?r[0] == 7ndotsep59.append(9M1:])_Oelse@ <received_l 0new`.join( :rargs = Rpeer,mailfromtrcpttosj P#kwR){}bif not\q_decodeB AE'0_op2s':R,7 77 Pstatu+lsmtp_server.process_message(*B, ** >_set_post_[*e((0v%Gpush('250 OK'?I6sAus) ,a# SMTP}E commandsAdef AHELO(W, arg:argo'501 Syntax: H hostname x# See issue #21783 a discussof this behavior"ifseen_greetin 3 Duplicate_/EHLO rW  ==!R%s' %Cfqdn1Hextended_ = True-oe_size_limit250-SIZE R < -as['MAIL'] += 266s-8BITMIMEpenable_"OUTF8 0MTP%G#mcommand_size_limits['MAIL'] += 10 self.push('250 HELP') def smtp_NOOP()q, arg):@ if(Q501 Syntax: D%'):Oelse8-OKOQUIT#s is ignoredgw221 Byeclose_when_done(_strip_command_keyword keylen = len($0"[:&].upper() == , `return[31:].(T$&''_getaddr 0notTle'', ''A#.lv.startswith('<' tess, rest = get_angle_(Y$ >ddr_spec=1if oddress Nv-._ BcparamsD 2# R as dictionary.TNone 1ll -Ueters# appear to be s0 ctically valid according$RFC 1869.BPresulp%{}2form2 in 'P, eq,eBue ='`.parti7('=-;.isalnum() or eq andKvalu<z[T3] = ifS$U True2Fjwextended = ' [SP ]1lc_arg =9!4if $= 'EHLO's%sn. hostnam3*elZ/HEZ.Z  ms* FROM: /1if l_`+d4+= * Y H86msg ORCPTzb)= *? TOODATA . if lc_arg == 'RSET': self.push('250 Syntax: .).elif lc_arg == 'NOOPQ.Q ?QUI.Q OVRFY.

'[/se= 501 Supported commands: EHLO HELO MAIL RCPT 'X Q'DATA 3  ,el l2def smtp_(~f, arg)# if\, params = :P._get(B_-E I;2 Cannot* user, but will accept message~ and attempt deliveryzy~502 Could P%s' %VG C1c #WVseen_greetingL H503 Error: send[firstareturnprint('===>' , file=DEBUGSTREAMsgqerr = ';:?g FROM:i"if2extended_ IZ+= ' [SP ]brg is Non s_strip__keyword('K?ess!ifV4 L S 1sb.^OfromN'{0nesCH bp_optionY.upper().split(sI.L4$if.2}_decode_data#cbody =y.pop('BODY', '7BIT1if 1in ['7BIT', '8BITMIME']: &self.push('501 Error: BODY can only be one of 7BIT, 8P)Oereturn1if aenable_SMTPUTF8smtputf8 = params.pop('-', FalsemZ8zis TrueV|frequir}! =.)+elP2notvU 2 takes no arguments'p 'LsizeIZE', Non+iz0if D.isdigit() syntaxerr&Pdata_g_limit and int(2) > % D'552qmessage L exceeds fixed maximum #Ssif len(Q`keys()0"55 MAIL FROM@etert recognized orpPimple+ed <mailfrom = address prE'sender:',H1, file=DEBUGSTREAM250 OK') W@def V`_RCPT(',5seen_greeting$03 HELO first');v. P===> ' Bneedocomman 1 = S:c TO: <%>'50ext d_h Gerr += ' [SP <-T)>]Raarg is Kk lI=As_strip_ _keyword('TOd6argH,$s B0get(-?ess+L.Q\/b,[rcpt_optionX.upper().spl2H.LB$if<2 # XXX currently there areX&we.rams.keys())w > 0: $self.push('555 RCPT TO parameters not recognized orimplemented')Rereturnarcpttos.append(address8print('recips:', 6, file=DEBUGSTREAM9(250 OK') {def smtp_RSET('f, arg) if(01 Syntax: D`_set_rostate(ODATAseen_greeting 3 Error: send HELO first'); !ifkeBneed9ocomman xxs" =:9terminator(b'\r\n.a*N 354 End data with . k2# Cs that haveIWbeen )OEXPN@502 (OJ{ class SMTPServer(asyncore.dispatcher#'Channel 9to use for managing client connectionsc9_9=Mn__init__Plocal, remote O{a_size_limit= _SIZE_DEFAULT, map=None,>penable_UTF8=False, decode_\v__5 = `$' = &d! =3 / ; =  /_[(,ifC a+ raise Value&(("d; cannot"rF " be set to True at the same time".?6map4:trygai_resultsocket.getheinfo(*9 btype=sQ\SOCK_v,#rcreate_,([0][0], &1]EP# try20re-1a s port if possible|{`reuse_lX"bind(localaddr)  self.listen(5) uexcept:+fclose()Uraise+Jelse9print('%s started at %s\n\tLocal addr:bRemoteu%s' % ([m __class__.__name__, time.c(.M()),Blxw1, rq ), file=DEBUGSTREAM) ;def handle_ac0ed(q, conn,)Incoming%ection from _repr(xchannel = q.+ +3^data_size_limit;O_map0enable_SMTPUTF8;_decode_# API for "do`someth useful with the message"Bprocess_ peer, mail, rcpttos, v, **kwargs, """Override this abstract Sod to{sErclient. E` tuplez@tain1(ip port) ofB that ma`socketEnto our smtpH{1raw8essjRclaim;1)]=[F) a `eP@wisho deliver[u'toa^0str-4con8entire full textM0headers (if supplied) and all. It has been `de-transparencied'`accordto RFC 821, SP4.5.2Nn other words, na `.' followed by90had'A leaw5dot"7ved02!di0ary)6@addial informaEt is[empty if =True was given as init parametawvtit willEFkeysb'0_op5s':Vesy aiWmmand. AllI elements are uppercase Xs. Exampl# F['BODY=8BITMIME', '9'].'Qsame, command. 4This function should return None for a normal `250 Ok' response; otherwise, itIthe desire\: string in RFC 821 I sUmat. 5""" 'raise NotImplementedError class DebuggingServer(SMTP "):Tdef _print_message_content(self, peer, data):zinheaders = @line-a.split%()8BsS$# WUfirst76if vand not D C+I = 'X-Peer: ' +9[0]Y2!ifOisinstance(,*# decoded_*=false; makeq match  binary outpuP Vrepr(0.enk('utf-8')P>2"<9= 0# Avoid spurious 'str on bytes @' warning.l1 = (;tprocess mailfrom, rcpttos, **kwargs]%'- MESSAGE FOLLOWS &-'2if K k`.get('0_op='s'u}' 's: %s' %^[C]? nn'n(\npEp.c=e-- END^%')PureProxy__init__*if 'enable_PUTF8'b - [']RQValueI%("Q does&support l&." esuper(5 , K%).  e1 {G('\n`# LookP Clastft(i  6x CJUbreakX=i +*.insert(i,d'[0d = NEWLINE.join$szrefused =s`._delip 9 # TBD: what to do with refused addresses? print('we got some.bals:', ed, file=DEBUGSTREAM) Cdef _deliver(self, mailfrom, rcpttos, data):1wimport smtplibE= {}6try9=4s =:u.SMTP(),.connect._remoteP[0], *1]@ pU`s.send( kfinallSgs.quitUexcepRecipientsR:s e 3'5e.rq(OSError,|Eoion) a', e.__class__ f# All C wered. If the ion had an associated0# e code, use it. Otherwise,fak*a non-triggeringKO.0errd = getattr(e, '_Z', -1loerrmsg1', 'ignore'8for r ina s[r] = (, 6msgMdreturn1  MailmanProxy(Pure q_init__d, *args, **kw )hwarn('P is deprec and will be Yved 'W 'in future', D;ionWarning, 2if 'enable_PUTF8')n [']Fraise Value)("`does n2!upo&."VsuperA~4)._> 8Sprocess_messagehOpeer`C io h St%IOW %_Utils" M$ uailList%#Dto ad.ing list,n we'll invokeMscript directly,`out goMpthrough=Q reald#nforward i8`plocal p qdispositionI@name%[]0{:tos^]=.lower().split('@')[0LG# We allow fo Pvarias on the theme  # listname ( o-admin_ownerrequest!/jo^ Jleav parts = local.split('-')bqif len(,i) > 2:zcontinu]1 = <9[0]9 X/==YUmmandC1COelse5,''rnot Utils._exists( r) or co?+Iin (CQ'', '   v/')5s.append((rcpt,[,)# Remove all) recipients from D@tos Kforward what we're noT# going to take care of ourselves. Linear rval should be fin# since we don't expect a large number\.m1for1 insX.e<(If there' `y non- destined9Uleft,sprint('=! s:0 '.otos), file=DEBUGSTREAM!if,toPefuseself._deliver(mail,7f, dataQb# TBD:to do with rTaddresses?6bwe got-!al9 c# Now directly7!hesummp%{}StringIO(msg = Message.&(s# These headers Pired Athe proper executionqMailman. All`# MTAs^e@seem0add;Ase iD original mx doesn'I@have5m ifmp msg.geP@send2to'= ~  ) GTList. ,:k=0V< s[Yw,Ol% # dispatch on the type of cowmmand Qif coy == '':)m# postmsg.Enqueue(mlist, to9=1)-+eld_adminiR-S_ownerS-SrequestU/W in ('join', 'leave')pTBD: this is a hack!S UWM* msg['Subject'] = 'subscribe'WOelseG/unI& class Optionstsetuid = True%@namePureProxysize_limit = Non2enable_SMTPUTF8 = False def parseargs({global DEBUGSTREAMx2tryB`opts, 6 = getopt.(-$ sys.argv[1:], 'nVhc:s:du','!['="no aversio@help([debugH 'smtputf8']tdexcepterror as usage(1, e) o$ =(Kqfor opt0 in  if@('-h!--V$o0S3opt;V; >print(__&__HLo_exit(`M%--f a.+] c J1argcKdK 0 = ostderrLuL  OesU-iz ;@int_0 = :arg$(9*'Invalid IP: ' +v, file=011# the rest of argumentspif len(V) < 1localspec host:8025nremote&$fa2a1[0]Xn(args) < 3:# localspec = args[0]hremote1Uelse:'usage(1, 'InvalidIuments: %s' % COMMASPACE.join(j1)) C # split into host/port pairs!Ei = .find(':')f i < 02Bad8 JAoptions.~m2[:i6tryb 3=(Ckb[i+1:]`except ValueErrorH8O9   %  ( 9!? QRsreturn if __name__ == '__main__'s) = parse(J# Become nobodyYPclassM$ =c."if "." in iZlastdot =!.r2"."v'mod = __im5__(K#[:C], globals(), 3[""cI8r[C u 'q as mod)O_ = getattr(mod,Tproxyp3_((aK,:!),`;|<=w size_limit, enable_SMTPUTF8=$ %iffsetuid 4"pw(I  print('Cannot Amodule "pwd"; try running with -.', file=sys.stderrZfexit(1wd.getpwnam('B')[2? 2os.(/VPermissionI" "J; asyncore.loopKeyboardInterruptpass #! /usr/bin/env python3 '''? /Er client. This should follow RFC 821 (0!),a1869 (BB2554# AuthenticaQ) and52487 (Secure M over TLS). N : Please remember, when doCq, that the s of the SMTP service extensions are NOT the same thing asoption keywords for(RCPT and MAIL commands! Example: >>> import smtplib#s=.SMTP("localhost")"print(s.help()This is Sendmail ver 8.8.4 Topics: @HELO "EH0 CDATA+@RSET@NOOP1QUI1HELCVRFY+@EXPN#@VERB1ETR DSN For more info use "D ".1 reqbugs inOi4Qmentaoasend e#to{-8@@.orgW{F|/rmH Postmaster at your site?qEnd of s.putcmd("vrfy","someone@heres.getreply( (250, "Somebody OverHere <>?0.my>Gquit() ''' # Author: The Dragon De Monsyne # Bet=pRFC 821pliance (_a`,k@CRLFSdata)fby Carey Evans ,f`picky @ ser@. # |2554 (authentic) by Gerhard Haer". # # Uwas modified fromPython 1.5 library HTTP 4. Tocket$io $re j.utilskmessag(generator,dbase64Dhmac Dcopy udatetimMAsys ~EDmime2_en"s _( __all__ = ["MAExce"rMTPNotS`tedErrorSDisconnectedResponseLhxerRefus9cipientsCData} JC ^IHeloaB Kquoteadd @"] _PORT = 254SSLA465 = "\r\n" bb_MAXLINE = 8192 #Bpthan 8 ps largex!an821, 4.5.3 ?CHALLENGD5 # Maximum numberAUTH challenges sent OLDSTYLE_@= reppile(r"`p=(.*)", I) classesF6FQule.  11(OSb)r"""BaseGTall eias rais ZG""" ^ (tl"""The comma2nd or option is not supported by the SMTP server. This excep9raised when an attemptSmade to run a commanvaK@with:oPwhich?""" classSDisconnected(E!):wu"""Not %1anyC a unexprEly d!s,q/or 6usekinstance before?aing itResponseRBase =vfor alls that includeI error code 8ese7are generaEin some s9PBpreturnskfoewstored in6C``smtp_'~ribute of!= , yx,c-GQis sea)# message.!osdef __init__(self,S, msge'.! =%J k=> args = (] nderRefus P"""Se- address r6 Ini!to72attHQby on$ h@s, t&qsets `sz'X0str`Pg", X8o.R# =[Y Recipients"""All r-~e#Th s Heach6re accessiblEZrough'jEs', `Pa dic0ary/bexactlsame sort asD."smail() |S& =o%x-8,) sPDataE u0"""M>q didn'tB!pt6Qdata..CLb%1 duon establishmentaAHelo9. our HELO replyZAuthenticaError(SMTPResponseException): """Authentica error. Most probably the server didn't acNusername/passwordAbcombinYprovided.""" def quoteaddr(fstringQ a subset ofm`email 0 esses defined by RFC 821Should be able to handle anything K.utils.parsC can*/pdisplay,/ =BMif (>) == ('', ''f'# l it, use it as is and hope forBbestK!ifW.p().startswith('" %#9 _X_only Sa)soV@=!ng  # Legacy method keptbackward compatibility.Pdata(2"""C0Dou@leadA'.',change Unix newline '\\n', or Macqr' intointernet CRLF end-of-7re.sub(r'(?m)^\vQ'..',K(!`:\r\n|r(?!\n))',f , #))_periods(bin\wbxby 0Mfix_eolsJE FE R tryimport ssl e0! IE#_have_ssl = False elseTrue class SMTP#"""This manages a connecQto an3E<~rObjectsUo `follow6attribute48helo_resp!isHmessage givenn0in @1onsh=theKmOrecent HELOCmandn/eh\'EH usually multi does_esmt4 a  value _after you dwA_, i cr0sup!s  2_featuresC This is a$ dictionary, which, if the server supports ESMTP, will _after you do an EHLO command_, containXqnames oe Ndzice extensions thisP, andS-irHparameters (if any). &Note, allk are mapped to lower case JGg'See each method's docstrings for details. In general,ure is agA5Q samerperformi?wc. TheJ>lsoOcalled 'sendmail' that Aenti il transa..1""" debuglevel = 0jsock = None$Hfilehelo_respehlo_msg = " _ +does_esmtABFalsgdefault_0 = R_PORT def __init__(self, host='', 2=0, local_ = timeout= et._GLOBAL_DEFAULT_TIMEOUT9source_address_!):"[ """Initialize a new instance\If specified, ``4,aremote.5 toopconnect R `de!F>O3By  , Elib.BusedmaK=<if it returnsthing othernsuccess codeCPError\5raiY`k" aDFQDNs+n` HELO/POAwise|=i)und using?tgetfqdn().* `Z%`  takes a 2-tuple (1)@^ biboBits ` b beforuaing. I^!''g0$OS- behavio0be epp.! =jCelf.$ = 9_features = {}!`_encod\= 'ascii'(# =& -_auth_chznge_count3!if(`, msg)bo)l3"ifg!= 220O self.close() raise SMTPConnectError(code, msg2if local_hostname is not None:Y[self.-=>1;els?# RFC 2821 says we should use the fqdn in EHLO/HELO verb, and\# if that can't be calculated, ba domain literalO nstead (essentially an en6d IP address like [A.B.C.D]).J= socket.get `if '.' fj, kd=0# W @find: A, sos J = '127.0.0.1'#>try< byb()>eexceptI0aienMpassF'[%s]' % 5def __enter__(7)gpreturn  .3xit-w, *args4 C, message =N.docmd("QUIT"0if 2v != 221ResponseE-4ionkWNServerDisc*edb M0fin  " .|Cset_debuglevelH&,  a"""Set output 9.g A non-false value results;:Tcs for 0ion0&al,1 to%received froms 1"""{' =NCprin  $#if2; > F(datetime. `now().#()~, file=sys.stderr X8Bget_, port, 7out# This makes it simplery@_SSLwzf#just alterS16bit}himeoutI IV["'Non-blocking|# (<4=0)[0sup6ed'h0q?_,#(': to', (c"),"psource_Ress) ret&urn socket.create_connection((host, port), timeout, self.source_address) >Cdef h(& , jp='local 'vJ=0, Aq=None):FB"""CQ to aH on a given.u/aIf the&'name ends with a colon (`:') followed by a number, andythere is noe specified, that suffix will be stripped offIMa interpreted as"[gto useNote: This methodautomatically invok__init__, if*%is during instantia v6"""Q+ifp + =2 M2notAand p.find('!==%.r o-i " f i >= 0vuDB[:i][i + 1:]K4>tryI2 =( ):except ValueErrorHraise OS#("nonnumeric$"X4if : Jrdefault_sys.audit("smtplib.0", q.9]P_get_!et1C.; ?pfile = (code, msg)Zgetreply(?vbuglevel >_print_debug(':', repr(fU0retCsendst"""Send `s'[pserver.% $t&s)Pn Rif isPce(s,v # \-"us'data' command, w_encodingI# should besd, but QPneedsqconvert_ng toPbinary itp anywayX'rt a problem.As9.e.Ks/.;Kall(6 WcloseQSMTPS^3DisBed(' 'Jelsepraise SMTPServerDisconnected('please run  () first') def putcmd(self, cmd, args=""):$( """Send a command to the sewE.""",!ifAf == ""CG0s =b+Nelse"f'{cmd} {%}'.if '\r' in s or '\n Cs.replace(%, '\\n')!r'5r')_raise ValueError("$f'argumentsatain prohibited newline characters: {sP.send(f'{s}{CRLF}0gety aGet a X fromlReturns a tuplesisting of:(3 - respons,de (e.g. '250',`such, ll goes wellusNote: r{ -1/it can't readd. 0str2cord*toDp (multi} 3`ses ar@nverto a single, ; l)Rqs SMTPSpend-of-file isUched.(U = []1if ?mM2("Cion unexp1ly N6d: qL+:(e)pif not F"kdebuglevel > 0q_print_,!('0:', r(2len4 > ]\ REion(500, "Ltoo long.@.appP[4:].^p(b' \t\r acode =6[:3$# Check thate 3is syntactical0+&ctB Dopattemptpntinuaty itjbrokenIO1err`= int( ;gC%-1 Qbreak # Ch eck if multiline response. 0if [3:4] != b"-":"-ebreak perrmsg .\n".join(_)"if self.debuglevel > 0Y!q_print_(('reply: retcode (%s); Msg: %a' % (err", )r`return!def docmd(t, cmd, args="")"""Send a comman% ndZ5itsD dE."""Y@.pute_ &1get"()# std smtpxsWChelo{name=''PMTP '&'=@Host6P to sfor this+ defaults"the FQDN of QlocalFhostZ"1", v"orI_A(E, msg) =+u3W_b =0JS;/eh; ! S<'<ke_features = {}W O_msgd:# According  RFC1869 some (badly written# MTA's will disconnect on an a. Tossxception if# that happens -ddm!ifb == -1 and len(*=Hfclose(;QraiseuServerDBed("S not 6ed"Anx[!= 25TQdoes_u = Truea#parse}@n assert isinstance .2#, bytes), repr<0.de("latin-1").split('\n'<1del5[0]\qeach inW# To be ablecaunicate with as many! sspossible,iOawe havL2tak5old-style auS dvertisement into accountM|because1) Else our Pr getKfnfused2) There areJdonly amethods wP support usqhe old ~ auth_match = OLDSTYLE_AUTH.(each) rif auth6:&(# This doesn't remove duplicates, but that's no problemHself.esmtp_features["y_"] = R.get("}, "") \Tw+ " " +.groups(0)[0]8continue 2# RFC 1869 requires a space between ehlo keyword and parameters. 0# Iactually stricter, in.0 on^s are allowedk hq were not going to check for_here. NoteKC theipresent if`cm = reUcr'(?P<>[A-Za-z0-9] \-]*) ?', myOB = m#("0").+*r({'s4rng[m.end;0:].p=3if bB == {g[; # b Oelse" Preturn (code, msg)def has_extn(f, opt)sp"""Does- server support a given SMTPice extension?"""4optp +3elpzargs=''v'help' commandR s  text from8er.putcmd("/0", ps)getreply()[1]Arset@ -- `ts ses(`_encod= 'ascii'P!dog"_Internal '!which igno!nySDisconnected error.cUsed iV lyulibrary, since@dNshould appearJ"appion wheWe *next* is issued, ifO!werd;%an "safety"86tryn5Soexcept+ ?Bpass6u2noo3%--do anything :c>"""  return self.docmd("noop") #def mail(!, sender, options=()):(N"""SMTP '1' command -- beginsI xfer session.e=This method may raise the following excey:9 tNotSupportedError The parameter includes '7UUTF8'1but2` exten is not s|? byOuserver.,\list = '%ifW.does_esmtpif any(x.lower()=='%utf8' for x inO<"ifhas_extn(?.2`_encod= 'utf-eJelseFm (1)  l)')< e ' + ' '.join(s11put ", "FROM:%s%s" % (quoteaddr(#)$)Kogetreply(lCrcptlTrecipGk0 kindicates 1 BAienttbOail.n=1MM/TOKJ%CdataJ7msgIDATA<`ssage A3 to@Automatically rs linesnwith a periodv rfc821RsBData ifk reZan unexpected +5thei;: avalue from Z!is%UfinalEresponse code5eived when.2all  ist. If msgB is a string, lone '\\r' '\\n' characters arj0nve5 toF4 -kbytes, it transmitVas isY "(,Y2) =_ debuglevel > 0gq_print_( ('mH:', f|"ifnj!= 354ME0Cif isinstance(msg,):  msg = _fix_eols(msg).encode('ascii') q/quote_period4 $if q[-2:] != bCRLF: OH2q + ?"."!self.send(q(,A) = 'getreply(*"ifdebuglevel > 0Dq_print_,('data:', m \hreturn  def verify(W, address)w"""SMTP '(' command -- checks for9 validity."""cY\.putcmd("vrfy", _k`_only( u8 /# a.k.a.]L# =Oexpn& expands a mailing listA$# some useful methodshlo_or_helo_if_needed BCall<ehlo() and/or>b() if @.aIf there has been no previous EHLO or HELOthis session, N tries E4CWfirstvTC-may raisep followxexceptions: THeloErrorsThe server didn't a properly to4@the . greetingd)i+_resp is Nonewt ONot (200 <3P()[0]72993sL H+ bX1 ao.Aauth, mechanism, object, *, initialonse_ok=True"""Authenticac- requires @cu'' specifzQwhich\* b~1d -`ues ar1oseQed in%'' element of 'esmtp_features'5!' must be a callable @ taka single argu^0 ! ==(challenge))pIt willnl@ed toM65's >u;! 0 itNepassedga bytes. It should Kan ASCII strthat will be base64 encoded and sent to the server. Keyword arguments:" - initial_response_ok: AllowYAdingYRFC 49540-0 O AUTH command, ifDauthentication methods supports it.N5""" %# ~a s J@to provide an . Not allP {z By def$ony return so5WotherM than None when challenge is,ny do. Sesue #15014mechanism = .upper()s@ = (object()p $_ok elseKf11not) -S# =_(m.('ascii'), eol=''x|(,) = self.docmd("?&", + " " +- J;__~_count = 18 r0rC# Ifds with a(,i $&se`while *z == 334+p2 = 0.deZ`bytes( m W{~f)- SQkeeps>z's,is wrongSi?lf.5> _MAXCHALLENGEs?raise SMTPExcep()!"S !inhe loop. Last&: C8pr( )"if6in (235, 503)RAYError231def_cram_md5(,=!@""" Z672useCRAM-MD5Q0. RequireWlf.usqlf.pass@to b*t.K^Pdoes  2L K_ hmac.HMAC4)=ii'), challe4nge, 'md5').hexdigest() def auth_plain(self, challenge=None): *""" Authobject to use with PLAINKentication. Requires Y.user andzPpasswordObe set."""$return "\0%sA" % O,ZD ?log*?LOGC&iff@ is i2 or__count < 2>E[3Oelse+,&I$, $ , *, initial_response_ok=TruLog in on an SMTP server that r "The arguments ar-k r:*/P name;Y.1-D@0 foe1Key _-$ : Allow sending the RFC 49540-T  /AUTH command, ifD ion methods supports it.I4 re has been no previous EHLOvDHELOh@ thiassion,l tries ECHfirsvTC-Swill normally waccessfulPmay raise  fod_Pexcepv&s:HeloErrorPdidn'ply properly to4helo greetingu-{ ac/~bcombint8BNotS#ed [4notCPed byKC E%No suitablhO wasrVfoundq+6 ehlo_or__if_needed()&1if elf.has_extn("W*")hH(O@ "( XPexten@iW1"=#T'sE`claimsadvertised7list = self.esmtp_ features["auth"].split() 0# Authentication methods we can handle in our preferred order: F_is = ['CRAM-MD5', 'PLAIN xLOGIN']We try the supported GsG, ifCTerverJsW%m.$W@list A forla5%if/advertised0W]4aif not,*Eraise SMTPExcepx("No suitable7 found."aSome s%s A y don't really#2S, so afails,ontinue until we'v7iedM3alls}self.user, password = IQ _name = '%A_' +.lower().replace('-5_')m:try(code, resp) =c(;*t, getattr(,/),<initial_konse_ok= u# 235 == 'successful'rQ# 5035Error: already7.ed80if P(235,G)7xreturn B e  ^ as eYRlast_:;= eOQcouldflogin bly. Rresult of Q attemptmidef starttlskeyfile=None, certaontext)a"""Putp connec 0 to into TLS mode._ If+re has been novious EHLO or HELO command this session, tries EC]firstvsQ will encrypt;iXs. If you provide5S Q parametersBV id tyfAQlientbe checked. ThiIPhowevdepends on whether`socket3uleBL ifR'es8mR may afollowing &s: BHeloT5A dideply properloy to the helo greeting.55""" self.ehlo_or_0_if_needed()&qif not -has_extn("starttls"):* raise SMTPNotSupportedError()-"STARTTLS extensionl8 by server."(resp, reply) =edocmd(R/0if 1z == 220_have_sslrRuntime"No SSL s included in this PythonIif context isNone and keyfileDValuOCarguments are mutually "exclusiveOcert-DC\E or vt im warnings. $("ladeprecated, use av"custom3nstead", DLBionW6, 2 kg== ssl._create_stdlib_(= ,p= Zdsock =`.wrap_5et( }8_hostname=G = + # RFC 3207B&# The client MUST discard any knowledge obtained fromZ, such as qlist ofE6ice!s# which waT qO_negotiata!it  * "," smtp_features = {}i`does_e* = False$Lelsej501 Syntax e` (no parameters alloweda# 454 ot available due to teary reason ResponseExcepV 5zreturn def sendmail,"_addr, to s, msg, mail_options=(), rcpt_optio"%):# """This command performs an entire mail transacB%. >The arguments areY- from_addr!: 0ddress sending td.W-A- to:s : A list of Pesses toGD to. A bareOE0str~will be treated as aidwith 1m 6msgNtmessage 24ailC : LcESMTP ` (such8bitmime) for th @ yy4DSNIs}G 0all e8"(0mayc#a tpcontaincharacters inIASCII range, or a bytC is encodedz-@s us]tPscii 0c, 6lonN1\\rG\\n are converjto \\r# If re has been no previous EHLODHELO session,emethod tries Cfirst. n server do&$, 6siz@each7specifiedrBpassCihxqfails, 3d@@supp'ed'fAPretur-rmally iHnis accepat leastone recipien1t rP!diQary, .QentryMIE that was refused. E:9_TtupleQMQerrormqaccompany `ent by>/@Qraise+afollowOx#: QHeloE{6@idn'1ply properly to5 helo greetingkwR"sRD wPrejec6ALLsv2(no[sent)weSendersPB HOData6@repl9Ran unexp` (otheBan ak_al ofD- TPNotSupport*edError The mail_options parameter includes 'SMTPUTF8'  but the 2 extension is not supported byOKserver. -QNote:f`connec will be open even afqan excegraisedNExample:`p >>> im smtplib|#s=.("localhost"))tolist=["one@one.org","two@two`hree@tPfour@]Tmsg = '''\\... From: Me@my8 Subject: testin'...! P This-a/m `s.send74("mq"",G,msg1{ " : ( 550 ,"User unknown" ) }ifquit()!Inrabove e,message was aced for delivery to d!of:k addresses, and onJ re8ed, with/e:EcodeI550. If allJE arebmethodreturn anLempty di7ary5"""' self.ehlo_or_helo_if_needed(eVs = [K if isinstance(msg, str):_k_fix_eols'@).en('ascii'j1if Qdoes_w M has_extn('size'sw=.append("+=%d" % lenz4on ,`:R(, resp) =Pfrom_*&, F80if :z != 250zj== 421=WcloseOelse/@_rse'SenderRefused%, 0err'{ '!tos,g oeach in  )sPrcpt(7 , 1if <u)1b[]2] =B &Recipients!if1 ==0 #" rUour rp self._rsetG() raise SMTPRecipientsRefused(senderrs2 (code, resp) = self.data(msg&0if ( != 250:pj== 421S[closeOelse/[_rset/DataError#if we got here then somebodyour mail3treturn  1def_message( , msg, from_addr=None, tos? r_options=(), rcpt) """Converts ~ to a bytestring and passes itd.|The argum are as for,, except thate is ane%.".M  object. If : 5 or5 isK,sQtakenI headers ofuaKdescribed in RFC 2822 (a Value11d iH re!mopone setn'Resent-'). Regardlesve , any Bcc field (or a0, wDthe Kr)$ won't be transmitted. NI2 isSrialized usMgenerator.BhG gO`called}`!4 er%ofr Qecontain non-ASCII\server adi5thePUTF8 capabilitytq policyloned with utf8qto TrueP"se)adYcBODY=8BITMIMEaserted on5nd.I does not support\j BNotS@ed eS. OtherwQout modify95"""$# PDate'U`a mand*ye$ (P0SecP 3.6.6). In such a case,!us{"*'is. However,R  p' block0re'ww way toFunambiguously determine whichNA most recent1allsPso ra\@n guC1we  +!atD,#TODO imple heuristics to guess the correct Resent-* block with an # option allowing=user to enable heuristics. (It should beLQpossi2"o ly almosth1 ofSutime.) @self.ehlo_or_helo_if_needed()&r = msg.get_all('VDate',3if /is None:Gheader_prefix = ''elif len(@o) == 1> Esrraise ValueError("message has mormtan one "' "from_addr `# Prefhe sender field per RFC 2822:3.6.2.Yr= (msg[,A+ 'SO)']7;Oif (9@) in@ @else$~fFrom'] uemail.utils%#uesses([&v])[0][1Qif toNsOF_@s = [f for f#_To'], e?BccC-,Cc(r ifQs not$!q= [a[1]ac')M# Make a local copy so we can deletSe bccsAmsg_3=:. u0del+&!['9{  #pinterna al = Fals:tryw''.joinO4, *,]).encode('asciiexcept Uni E&  _!ifhas_extn('smtputf8').ZSMTPNotSupported[()r"One oruQsourcdelivery 3 require"G :Qized " sQ, butoserverG2doe`advert(} d UTF8 capability  f = Truio.BytesIO() as b :msgOi j2g =.generatorYGtp, policy= p.clone(=)r_"(*ptions, 'SMT PUTF8', 'BODY=8BITMIME') Yelse: g = email.generator.BytesG (b:msgOg.flatten(msg_copy, linesep='\r\n. msoP.getvalue(Zreturn self.send(from_addr, to 3s, P , #_options,Drcpt+!) ,def close(t)!@"""C the connecc1 toSMTP server."""Lh6tryDbfile = *t.y = None0if  O6.:kfinall}Dsock} `}}}}PCOquitBTerminate4Yssion54respdocmd("P"# A new EHLO is required after retng withZehlo_respo&he /smtp_featu!{}!`does_e&v = Fals res if _have_ssl:`class [P_SSL( P ThisRa sub/derived &<T thats over an SSLencrypted et (to us2is X`you ned%Pmodul$eat wasNcompiled{SSL support). If hostnot specified, '' (\UlocalL-).Aused?IPomitt95standard--x,KG(465K i_apname anAurceS@ess s!umeaningP aspy do in }.`. keyXBcert re also Eal -Pthey cantain a PEM formY`d priv<5keyV@ific ch2dP2for SLS. Jtext,zE`SSLCon0,t is<alternative;iL_ both!qmust be.^SHdefault_! =v V_PORT3__init__,zP='', :;=0,=3# timeout=R ._GLOBAL_DEFAULT_TIMEOUTo(sogrif context is not None and keyfile is ;:  raise ValueError("contextC arguments are mutually "O ^ "exclusive").4if jvOcert-DC\E or vtimport warningsA. $("ladeprecated, use av"customznstead", DLBionW:, 2Tself.=_ #= % #= ssl._create_stdlib_(i= ,hK=r$ =: iSMTP.__init__(, host, , local_name, timeout source_address) pdef _get_socketn^)U0if .debuglevel > 0$-%q_print_,('connect:', ()'3new = super().:B lvS.wrap](h? eserver= vreturn m__all__.append("_SSL") # # LMTP extension # _PORT = 2003 class)(>0"""+@ - L, Mail Transfer Protocol1The@# pp, whichvery similar to Ed,heavily basedNon the standard + client. It's comm&o^RUnix vQs forE, so our)() method must  that as wella regulaI:(+. 7 R have1ame0meaT`they do iass. To specify a T2youUn absolute path[starting wiR '/'.Authentication0sup4~mechanism. When us+ generally don't sup:port or require any authentication, but your mileage might vary.""" 5ehlo_msg = "lhlo" def __init__(self, host='', =LMTP_PORT, local_name=None,`source_address& timeout=socket._GLOBAL_DEFAULT_TIMEOUT):O """Initialize a new instancepsuper(). U ,)KyconnectJvS:0, R% CI to the P daemon either a Unix$ca TCP _5"""I!if[0] != '/'dtreturn FE K0if A. is not 'A and ! aise ValueError('Non-blocking# (]4=0)`0sup7ed'# Handle s-domainD%s.:tryE# =..2et(.AF_UNIXSOCK_STREAM)W G GC.set]f v/afile =x .Aexcept OS debuglevel > 0$q_print_,#('mr fail:'_u5]Sz.close(<rT(code, msg)elf.getreplyUuau`| # Testsendmail method, which tests most of)os. # Note: This always Es+k0. i__ == '__#__rprompt(sys.stdout.write"v + ": "(WflushF"in.readline().strip(@from+2 = c("Fromf tosTo").split(','o("Enter message, end with ^D:O!'' wh(1q 1+9Ubreak'i + ,Mp lengthP%d" %(msg)) ser$ver = SMTP('localhost') server.set_debuglevel(1ndmail(fromaddr, tois, msg,8quit() """Routines to help recognizing sound files. Function whathdr()-es various types of= headers. It un tands almost all#, that SOX can decode. The return tuple contains the followitems, in this order: -A (as_it) - samplE rate (0 if unknown or hard%1`numberchannels6bframese?(-1wQbits/ e,'U' for U-LAWAAB If0ile doesn't have aAable*C, ittys None.? ca= be opened, OSError is raisedo computextotal time, dividH by/ !a asr each )() calls@. (!se also use some heuristicsOraw data, butY= work very well.) Finally,$ f2`test()Pa simmain program@ wha+}@ menzQed onZ@argu list. For directory sW!()W(&at:. DefaultDP"." ( ?e currenF). The op` -r te~ itA`recurs%wnz ielninside explicitly give*.0 #e8structurePtop-dPexcepa e sand its # subre last. __all__ = ['1', phdr'] fa colles import namedb SndH' =&('!', 'On1s nsxwidth')q.=a.__doc@("""JBvalu6^pindicat!he "Pwill  nenstrings 'aifcAaiffu','hcom', 'sndr@sndt!vo,0wav@8svx sbuor 'ul'.""")9."_  beither'bctual 'WAVE' 'fmt :) or h[8:12] != bDS12:16T f."(06try+1w =.open(f, 'r''except (EOFError,( |('wav', w.getframe|#()nchannels(),7n8#1 8*sampwidth())9wavI8svx^FORM'lV8SVX'*U# Should dPit to$ # -- assume always 1K'A', 00% Ksndt XSOUNDn93les[~$& '9f/ r H\0\0#:4saif 400m/<= 25000&Hsndr[)/#-# # Subroutines extract numbers from bytes # \b(b[0] << 24) | (b[1#1628Bb[3]7Q>le(Q33QBQ`Q0QMbR414 h:Amall  programh#7(Iimport sys  recursive = 0 if sys.argv[1:] and] == '-r':-17del!5:2]]16try9 jVtestall(,A, 1)R,Oelse>_['.']7 except KeyboardInterruptGystderr.write('\n[(fed]\n'.exit(1) def Ilisttoplevel)k`importA!osfor filename in M7if os.path.isdir(+[$Uprint + '/:', end=' ,&ifdD or v&V'ng down:O)Aglob@s = .(Pjoin(u.escapev), '*'){LrT s0-/C *** directory (use -r) ***B>dc+stdout.flush( #_6wha OSErrornot found` if __7!____main__Y() # Wrapper module ,_socket, providing some additional facilities # implementedPython. """\ This]P2es a` operaRse@relaIAfunc. On Unix, it sup\as IP (net Protocol)H-0 dojsEPotherAtemsNHonlyS4. Fw specific#a are available as methods of thep object. P#: C() -- create a new5'Kpair+h 3s [*] fromfd4 #0 anyn descriptorDsend_fdsFMSend''tof. recv2|Recieve5sz!.Rsharek@dataReivedJ&.Ag stSareturncurrent ho! -&by/Umap a"a to itgfnumber33add3n$]cADNS info<Nservo@ice auPto a  cKpLmap a protocol name (e.g. 'tcp') to a number ntohs(), l() -- convert 16, 32 bit int from networkDhost byte order htonK K@%toSKinet_aton IP addr string (123.45.67.89032-packed format MJntoaM,0 IP` socket.getdefaulttimeoutWget the  d value<s<s< create_connectis!aness, with an op,%al_and ,dsourceM. [*] not available on all platbs! Special objects: S-@TypeRt K/` error(AexceR raisQ I/O "s has_ipv6,rbooleana indicatif IPv6 is supported IntEnumAstanAF_INET, AF_UNIXWdomains (first argumentm"() call) SOCK_STREAM, 5DGR 7RAWVs (secondU)IegerMany otha may bfPined;s$seu3!in 0set opXand gmethods. """ im/ _11et   *&os, sys, io, selectors5ek2z, IntFlag try:"berrno ! IE% = None EBADF =Qattr(1, '', 9) EAGAIN$', 11) EWOULDBLOCK+0 __all__ = ["fd", "getfqdn server","dualstack2AddressFamilyKdKind"].extend(os._get_exs_list(_)) # Set up(vT.AF_* *w` as me@s of5su # nice~representahs. # Note thatB only knows abou#1ints. The publicherface # in this module under!dsc s translatebm backjs # where needed!.fd propertya!)..%_('' __w&__lambda C: C.iAer()C.starts`('AF_'6vs lam6bda C: C.isupper() and C.startswith('SOCK_')) IntFlag._convert_( @'Msg%',__name__?lamr?MSGqAddressInfou2"AIt_LOCALHOST= '127.0.0.1'  _V6 = '::1' def _intenumer(value, qklass):B"""CB a numeric family 4 to an IntEnum member. =If it's not a known!, return theWPqitself.A1"""2try:)*except V]Error8f # WSA e$ codes if sys.platform.lowhbS"win";Tab = {}}M$Tab[6] = "Specified event object handle is invalid.P![8>Insuffici;memory available374 One or more parameters arel2995: verlapped operation aborte"99O4:I/Oin signaled stat#99I}will complete laterQ100047The wa\oterrup797A bad file;NpassQ100136pPermiss"Odeni+A fault occurr]etwork??" jEFAULTFQ10022r$An _attem2Too many:nsH3H`socket/would blockB1003 A 7ing9is already in prog~z7*Sbon nonncDestin requir!40Message too long`!41* Protocol wrong type for 40Bad,< opeeqQ10044,3O1 (7&^not supported b:y protocol family." errorTab[10048] = "The network address is in use.797Cannot assign requestedCp!509Nlis down)1)unreachabl)520dropped connection o?setm3=Software caus=Oabor:4:@khas beeq57No buffer space avail63Socket is already/ed751OshutToo many references65Qoperatimed ouf6 C0ref] translate nam86"Ytoo long]4P.1hos6* 6Directory Oempt6oprocessnUser quota exceed6ODisk-7Stale file handleC7@Itemm_remot9(*csubsys5/un* 9Winsock.dll versut of rangt 0SucNful WSAStartupyet perform?"10PGrace?3!J@progY"10`No mor?sults fromLookupServiceNex#"10UCall ocancelP9!du@ll t}oinvaliS"10c_vider5  5failed to initializ"10Sc:/ur-lGOfounClass type.1)1 Owas 1Database query 51001] = "Host no*t found." errorTab[11002] = "Nonauthoritative host no939 This is a nonrecoverableeq48Valid name, no data ?rd requested typeC5C0QoS3oeivers'6'Osend%7%0No O(8(%/now 9* confirme%10/admission=%11-policy failur&1bad styl''oobjectN1(ptrafficOtrolgeneric+Qrvice0flowspe\1Invt4provider buffer5ofilterI22IncorrectfOcoun2f length2 gOlow eUagnizedjc33 descripto25-iG  @Bshape discard mode 3%?ing rat9 ,Reserved _qelement1__all__.append("") class _GiveupOnSendfile(Exception): pass+socket(_.1): M"""A subV:of '@ addthe makej) method."""F__slots__ = ["__weakref__", "_io_refs closed"]8def __init__(self, family=-1, Qproto no=None):# For user csaddressL2 an values are IntEnum members, butP@for uy ly they're just integG TheGconstructor \convertsjgiven arguo an # integer automatically. if fileno is None:"amily == -1!f AF_INET>Otype< SOCK_STREAM>_proto?% 06_socket.__init__(self, , w!, >,)C+._io_refs =]closed = False 8def __enterm))preturn > .xW*args4aif not4"._rQvN.(()V?rep"""Wrap __ ) to reveal the r class name and Draddress(es)=5"""!sgetattru'"',2j = "<%s.%s%s fd=%i2=%s e=%i" \n!% d1.____.__module__,*# L*@qual,2" [b]" if else ""ZD/()%0 :tryl" =0get(S'1if .Ers += ",#=%s" % str(3 Mexcept errorMIpassrOpeer.k#&5'>'roOtateaise TypeE%`(f"canpickle {__!r} object"1dup<0"""C) ->8DuplicateRet. RZa new: connected81Esamesystem resource. TheEis non-inheritableBf>R!.:RC:=fdM.settimeoutGg)+2ockD ac7 }(#et , ess infoWait for an incomingt_ion. Pesent6the connection, and the address ofclient. For IP sockets,$3info is a pair (hostv, port)E5"""Q1fd,t = self._accept()"ls(%rfamily,2Ctype proto, fileno=fdE# Issue #7995: if no default timeout5set listening# had a (non-zero)Cq, force4new/in blockLmode to override platform-specific@flags inheritanceLcif get ()ANone35get:`D.setV(True:areturn >def makel , ="r", buffering=A, *,4nVencod#cerrors0qnewline)5"""s...) -> an I/O stream connectedX"et{Trguments are as io.open() aftername, exEonly0sup!edb valueWS'r' (a), 'w'6'b'# XXX refactor shUcode?p`t set(na) <= {s"w", "b"}/praise VEb("invali@%r ( r, w, b allowed)" % c&,) writing = "w" in0rear or not ;-tassert 4-or"`binaryNbN?0rawK$ifP -Y+= "r//w/qraw = S#IO#l_io_refs += 1&if z7O = -9?< 05io.DEFAULT_BUFFER_SIZE,==J]y eK"un#eds must be E"BK8rawe =BZedRWPair(raw, %6ings/el- RCeadeR M*se@ `OWrit` e~Qd<bTtext_(  * TextIOWrapper(buffer, enco ding, errors, newline) text.mode = preturn   if hasattr(os, 'sendfile'):!RTdef _E_use p(self, 2 , offset=0, count=None):gF/u._checkD_params(EC=ockno = F/:no(#:tryq8*! =. 8except (AttributeE[, io.UnsupportedOperation) as~lraise _GiveupOnSO(err) # not a regular 0sizos.fstat*pno).st_ B!OSE!ifff0^empty# Truncate to 1GiBavoid Overflow, see bpo-38319.Pblock1in(xA or , 2 ** 30$dimeoutHBgett 3if _ == 0BValu/a("non-ing sockets are-G"# poll/select have the advantage om`requirZ9anyq# extraf descriptorEntrarily^ehkkqueue@`(also,x"y he a single syscall)|:a'PollS orE,xectors.5 Nelse{Fw+orH2.register( no`yEVENT_WRITE)Ptotal70=Plocalvariable accesstPminimoverhead<_ . . osd = os. &CPwhilesL2and(  =TM ('6jd out'4"if-"P&-  36if :<'_breakMP70senWh, BQingIOA  if not timeout: # Block until the socket is ready to send someK data; avoids hogging CPU resources.B selector_ /().continuexcept OSError as errif total_sent == 0,J # We can get here for differBreasons,NOmainN`one be+`'file'{a regular mmap(2)-likI # B, in which case we'll fall back on using Qplain/() raise _GiveupOnSendO(err5err from NonOelse ifbreak # EOFoffset +=V'0+greturnZ M~finally > 0 and hasattr(V, 'seek')=#.!( E@def E_use c(self,FA=0, count= v @"os.G!()availablethis platform") Au._checks_paramsM-Xclf.getH/()QValuemp("non-bSLQs aresupported"j )^size = min(p, 8192) J85= 0p# localPAvari`accessPminimoverhead8_#! =0. r K!lf+trwhile Tru"if ' -y%, $v;&if"/ < EAemoryview\(|}? 4  Ttry: sent = sock_send(data)/except BlockingIOError[continueM?lse;PtotalPt += E!if b < lenX10 = [Z/:]\e MYbreak@vreturn kfinall'if+ > 0 and hasattr(file, 'seek').(offset +M!) zdef _che3_params(self, ", Aw, countkif 'b' not in get`mode',!2raise Value% ("f should be openedSpbinary K"x!ifs.type & SOCK_STREAM mHonly0 Cets are supportedt1 is};Nonisinstance(19, i43Typ"CP musta positiveUeger (got {!r})".formatw)/Q"ifZ <= 0"?RpIb#=0d=_75"""7<[[1a]]) ->aSend a until EOF reached by using high-perB&nc5os.y)~"heO number of bytes which weQEent.**rregularoobjectD:If  available (e.g. Windows) o_%is)a }p() willw!usVstead** tells from whto start read_1the=If specified, **+ Xto transmitpas oppou)enoCFileQ on|updated on por also@casee5 in .e() can<to figure out 5G= 51The%et9-ofSNon-b9s are not supported. 5""" Etry: return self._sendfile_use (, offset, count)Dexcept _GiveupOnSCfbcdef _decref_socketios()b#ifio_refs > 01$._A-= 1^=oclosed81() 3Rreal_Zc, _ss=.4# This function should not reference any globals. See issue #808164F_ss.z{:.d = True Fd/<=;ldetach3"""P) ->  descriptor}CR the | object without 1ing"punderly Pd4TheC0canbe used after tcall, butW Lcan be re?for other purposes. n ?Q is r : super().C0@propertyofamily|Read-only access to@addr9 }Gx_intenum_converter(N2, A^F#Otype 6%<1, SCKindif os.name == 'nt'~^get_inheritabl0os.-mhandle4.#Fno(){_s_', ql0os.3e C+Oelse,;^i0.__doc__ = "Ge flag ofKRK(GSG fromfd(fd, osproto=0O""" +e[, proto]) -> socket object Create a from a duplic!of the given file>descriptor. The remaining arguments are<same as forn1().G1"""Pnfd =uA(fd)dreturn/family, type, proto, n, if hasattr(_., "sendmsg"):Timport array@def %P_fds(7, buffers, fdlags=0, address=NoneOF?"""A @[, fB[A]]) -> integerIASend-qlist ofk gs over an AF_UNIXLFP B.Emsg([-SOL_SOCKET,%;MSCM_RIGHTS,:.@A("i"$2))]__all__.append(}X?")  Orecv%Msize, max 6 x(data, a, msg_)Receive up to-[bmessagXzb and aCcont\/0# AEEints\fds =wmsg, anc! =h.NE}Y>/CMSG_LEN( *P.item4)o cLqlevel,  4 injAif (&=D == C%V $0W@fds.Rbytese[*6len([) - (%]0 T{Y(fds)~f \\ TshareW(info  9= =o Qed byAX.3pidbet(0, L  @pairE(mr= s_STREAM~*=0<?[@[<[1]R,ZbbTsksf the platform  socketpair() function.  The arguments are the same as for A() except default family isPAF_UNIX if defined on4platform; otherwise,Mis AF_INET5"""[&ifpe None::try=Z 2NameError? ?a, b = _.er, type, proto)7$ =P(, a.detach()4h`(4b4preturn else: :# Origin: https://gist.github.com/4325783, by Geert Jansen. Public domaiB3def==SOCK_STREAM6=0)k=g@hostlLOCALHOST/el>6? 7_V6BLraise Valu`("Only@D and 6 addressFies V "gsupported"!if7G != 6 0O is jk0a/col zeroWP # We create a connected TCPR. Notftrick with@ setblocking(False) that prevus from having topfthread>l8s | ?=p.bind((7, 0"vlisten(J # On IPv6, ignore flow_infoCscope_id5H , 2 = ]0getname()[:2]1ca E.w j)>B&(( 0,t#(B!IO{, Interrupted#86pasmJTrue,s05, __ ac  >f[close24kfinall A(f__all__.append("F") .__doc__ = """socketpa"ir([family[, type[, proto]]]) -> (socket object, ) Create a pair of s from thes returned byplatform YG() function. The arguments are6same as forZ() except default  is AF_UNIX if defi!on,; otherwise,E>0INET. """ _blocking_errnos = { EAGAIN, EWOULDBLOCK } class SoEIO(io.RawIOBase): """Raw I/O impleaStream"s.3RThis [supportsmakefile() method on;@ ItQvideszr{nterface30topa<.5# One might wonder why not let FileIO dojob instead. TherQe twoV# main reasonsIA!isSadapted:.0- ivPuldn' Ark uWindows (wd`you ca$@used`sd() andH` writ15on shandle)$lDwithtimeouts (would ignoG# *` consi4T non-\)p# XXX MJBdocsdef __init__(selfP, modW!if@in ("r", "wrb wRrwb")_< raise ValueError("invalidWq: %r" % +4.$ ._! =F">Tf "b" 0 +=%4N= reading = "r" in$$w$_occurred = Falsej#tobO ead up to len(b) bytes int$able buffer *b*+41QnumbeqDzQ. IfmZ etRL"novNSPavailz`, None9t#edq!Ifn-empty, a 0 v(p indica2thaQconnevwas shutdown 'B endhslcheckClosed(Q@Read2if =  \#OS0canZtimed ou "while TrueS:try[`.recv_&(bT+bK! =mJ except error as e:  if e.errno in _blocking_s0?return NoneParaise def write(self, b)O@"""W the given bytes or array object *b* to+asocket_Cand Inumber ofDs~ ten. This can be less thanG len(b) if not all data could2H'If5 isCDnon-= #no F83 is5ed.E5""" 4._checkClosed()FGable6tryi&"RBv.send(bQe) # XXX what about EINTR?eI E AAread A@TrueS IOXopen for <?ing`0if S!.c] 1p ValueE<("I/O operation on 7 NFet."K\_ %kOseek%<fpuper().)afileno pRo$ descriptorunderlying# ?^.l3no(0@pr!tyZc2namb  `;els)"-1&=mod5d_!=bardoesn't~)s6Cet, !ifreferencesLit have disappear' Fxio.RawIOBaseW! ._decref_ Wetios'! =-0 6getfqdn(3=''"""Get fully qualified domain name from 2. An empty argument is interpreted as meaning the local hostAQFirstdreturned by getbyaddr()^checked,5npossibly existk aliases. In case no FQDN@available and `s`Gwas given, iunchanged. If3 /aor '0.!',KY0Y.-1""" " =^qstrip()aif not2 or&==s:&B p6try&#, '@, ip`;s =qQexcept errorKApassaFelseX.insert(0,Mf$inA!if '.' in  Qbreak} o% =z*yQ. _GLOBAL_DEFAULT_TIMEOUT = object() def create_connection(.ess, timeout=K ssource_Gb=None)B"""ChS to *"*HcsocketKConvenience fun?. O(a 2-tuple ``(port)``)p ` Passi op!alb** parameter will se 0 on instanceDbefore att`g#o ~ . 6no iis suppliDglobal default!Kd:-S:`get.Pis usx**Pit must be a W2of X T2ato bin$"a Z  1mak$he2ion7A` of ''g 0 tells[ OSC1use<s$ =|`err =  re"Ginfo, 0, SOCK_STREAM1af,type, proto, canon, sa = reI1} %?et(d+%if!isP3cC.set( `H(* In:(sa0# B explicitly a referBcyclC _: err = _ if sock is not None:!,".close() !ifN6:tryCPraise0;Qkfinall'# Break explicitly a reference cycleBF7elsu4or("getaddrinfo returns an empty list") def has_dualstack_ipv6():_A"""R;& True if the platform supports creating a SOCK_STREAMf!etJwhich can handle both AF_INET and 6 (IPv4 / IPv6) connections.J1"""!if! \$$or`attr(_et, 'IPPROTO_IPV6')6V6_V6ONLY'fXR Fals Cwith((6,!A) as! <@.setHopt( , I, 0)`except&ord&e_server(8ess, *, family=, backlog=, reuse_=O,w [(D"""Conveni1fun .V+esUAtype5Zbound to ** (a 2-tuple (host, !))haFrobject.** should be either% o 6**V\queue size passeq.~Cen();E* dictates wherato usexSO_REUSEPORT0 opI j!*:`it, it will )6j@ableg!acT!or?p When fc2disS3his1 onFs that en) it by default (e.g. Linux)A>>> t('', 8000"s 1...Qwhile  , \# ==.(}E-#7new:has""1dValueErr*ped on taS":if -_X #() 0J#ifg4 !=c6#mrequires AF_INET6 family") sock =et(family, SOCK_STREAM'Atry:04(# Note about Windows. We don't set SO_REUSEADDR becauseA+1) It's unnecessary: bind() will succeed even in case of aprevious closed on the same address and stY'inBTIME_WAIT state.P2) If, another`is free torB|, effectively enting this one from accepB cotions. Also, it may0pro?"ag whereEit'll no longer respondany signals or graceful kills ,See: msdn2.microsoft.com/en-us/library/ms740621(VS.85).aspxpif os.n0not('nt', 'cygwin')\1khasattr(_Xet, '^&')X. :@.setopt(SOL_ ET2, 15 exj errorh# Fail laterw, for platforms which=not# supportp|gEpass<if reuse_8  IPORTif has_ipv6 == AF_INET6eif dualstack6  IPPROTO_IPV6, _V6ONLY, 0sl "3"*y ."{".2 hGF0 asO 2msg = '%s (while attemV`Y %r)' % +(err.str,Praise!or/errno, msg)6Non@if backlog is  vlisten(h(elv(Q/areturn`0oCj def get"info(host, ", =0, typePproto sflags=0"""Resolve @ C` into Th entries. PTransD/@pargumento a sequenc5-tuples that conta1allH# Hsc@crea2QAocke>QnectePaservic host is a @domain name, a string representation of an IPv4/v6 address or None. port isCqserviceZ such as 'http'irnumeric8jnumberQpBy pass@None>the valuehost andB, you can4 NULL to5punderlyLqC API. The family, typeOroto argumentsUPbe op ally specified in orderlpnarrow s@list-es returned. P@zeroafor each ofWtheseqselects`full rang results.71"""# We override this func since we want to translat)$e Nmbsocket.s=enum constanA= []B0res6_H@.get(Pinfo(,x0, p, flags):L af, H%Rcanonsa = res10ddr.append((_int_converter(UAF%),@u @S+OKindC  !))s1oq """Gen6f0et der classes. Tmodule triebcapturvarious a tsPdefinaPa: For[et-basedQs: -- AF_INET{,6}: IP (Internet PCcol)Ws (defaultW@UNIX: Unix - others, e.g.tDECNET areceivable (see -|SOCK_STREAM (reli?cstreamf8TCP20DGR1datagramBUDP)BkrequesC (includrc)\eclientcrverificbefore furP lookE!atm:N( 1ctupa hook 0anyV"ceathat need0YG _ Panyth~Celse$logging) - ho handle multiple s}synchron(%3 is@dha time1for(36by a new=Qthrea?,)^elRmmQfavor Xis simplesip write:(cTCP/IPf4. 2badr design, but saves someing. (There's also@issuat a deepJhierarchy slowzs down method lookups.) There are five classes in an inheritance diagram, four of which represent synchronous servers of four types: '+-"+  | BaseSe=% |.6'v7+) L4TCP->| UnixStreamd(/(--/UD@Data&h Note that  Tderives from Q, not @-- the only difference betweezIP and ap! s} V1 is>address family, is simply repeatedboth unixD. Forkingo`threadqversionPeach can be crc0 us5O@MixI4d TTdmix-inh. For inseF, a 9UDPq as followVq(,q): pass' M must comprst, siit overrides aPdefined in[d! Sett@varipmember 0ablDlso changes AbehaviormpunderlyI| me0ism. To qement a/ice, you" areRequestHandler"rea its h#()p. You then run ,iyA0bin4one "erpes with2r r|"/he%beEst for dB or ; tices. Thisbe hidden by  A subY2es  ;4or  . Of coursstill have to useQhead! it makes no sens3aQer ifice contains statebmemorybe modified2s (Bthe 1cat!inbchild procxwould neve$hoRitial}P kept0par?| ed d`P). Ip@se, 0 per, butH w]probably have to use lo*cks to avoid two requests that come in nearly simultaneou7pply conflicting changethe server state. On  other hand, if you are buildEe.g. an HTTPC, where all data is stored externally (:iffile system), a synchronous class will essenti@arenderice "deaf" whN4one!` is be`led --& ch may be for a very long tiLf a clientPlow tv ad{Tt hasnaed. Ha threa( orePking erSapproprir@In scases, it'process part o  7ply, but0sfinish 7Ain aed child depen n S . This can-implemented by usS aand don explicityg!r  () method. An 0ach&]`multipBskan environ0supports nei3s nC (orPthese@ tooensive or in@ice)to maintaw%n Ptable$edL s C@to u selector to decide`work o$xtole a new incom?=)i[AiculJ im(!anq streamRices e,'5potbe connec1jeD(if ycor subep0notsused). Future : - Standard7!esSun RPC (which:#s 0UDPHTCP)>emix-inE5to P variB@authcation `encryp schemes XXX OpenpPblemsWto do with out-of-bb? BaseS1split generic "`" funcpPalityGf into =. Copyright (C) 2000 Luke Kenneth Casson Le% on exa : ` entrigrom a SQL `base (ires overriMp get_Pest()PreturS0y fQ O)p2a RHandlerC . """ # AuthorWPopatch: __version__ = "0.4" u socketso %sy i\ort BufferedIO wo monotonic as time  __all__ = ["BaseServer", "TCP %UD & "Threading! D 7jRequestHandlrlStream 9nDatagr%tMixIn"] if hasattr(os, "fork"):O.extend(["Fork c)dsocket, "AF_UNIXkBUnix_"j Z3 F1 dT]) # poll/select have the advantage of not requiring any extra file descriptor, # contrarily to ep\kqueue (also,^yNe a single syscall).Sors, 'PollS',2 = Hors.0S else3Hor class 6!: d!""* Qfor s52es.'Methods !S#erD- __init__(=_address, C)x-h_forever(_interval=0.5'hutdown(hd_est() # if you do;use^<fileno() -> int <k that may be overriddenEbindactivate7get!->5est, client2utimeoutFeverifyI DFclosprocessD~ 0d]@ice_5onszerror()ttderivedqlfinishnEl variables K by o1 orAinstances#- s_family9S_typeallow_reuseI`i63"- `32""" r = None8def2lf,rY"""Constructor. M f4ed,n e.:Pself.eq-/ =@ 7__is_shut_do wn = threading.Event() self.__shutdown_request = False )def server_activate(9!):K """Called by constructor to 4C theH.Y:May be overridden5"""bBpass6_forever, poll_interval=0.5Handle one at a time until Polls for syn seconds. Ignores(.cout. If you needdo periodic tasks, do'Em inCsanother.gA__is_g.clear6try{# XXX: Consider using ofile descrip or@nect&tO`socketwake this up instead of6 XHreduces ourM@resp`venessUand wastes cpu 1ll 0 Os=qwith _S@Seles() as s 04u.regist}s.EVENT_READ)7 whV0notczr;0y =5.o(3# bpo-35017:@B() c0durP), exit immediately3Vi;8Ybreak1if <h_noblock(hV41ice7onskfinall4X, t se^X PStopsW loopBsA  has finished. Th@mustIiec() is runn%in', or it willA@dead~?u = TrueE1:wai28erv4 9C.by=,()? ^a subclass / Mixin^implement and%at be= : # The distinction between ing, get], procesda#is fairly arbitrary. Remember: ` #  - handle_request() is the top-level call. It s selector. 3(),MV getJ, verify and process>->different for stream or datagram socketsB \Fplace that mayOtk a newWcreate aO thread to finish.)- instantiateO2or class; thi constru\S will-r all by itself 3def*!):A"""HS one , possibly blocking.Q3qRespectf.timeout.R # Support people who usedC.setA ()Igescape@ p beforehz was availableX" =.'.gqg4if .vis None!K?Belife[?notJ Cmin(/,=)X Qdeadline =A() + 6out# Wait until a arrives  expires -^Sloop  @# ne0aryaccommodearly wakeups du*f EINTRwith _ServerS.A() aN< {Ior.register(2.s.EVENT_READ)while TruyG-1if 4 breturn_1_noD(T?elsP(5 = -v4d?< 0,s(ujs?outrsI assum r() has "ed%Gc functionH`ed, sojhould be no risk ofjing in5"""/:trygoclient_addressf>except OSErrorQq m w_address):  Vtry:  self.process_request(, client_address)>except E?ion\handle_errorYshutdown~CrUraiseJelseS :Cdef timeout(7)J"""Called if no new n arrives within :.G!. ` Overridden by ForkingMixIn.$5""" Bpass>everifyQd,  V:D the0. May be oReturn Truewe should n!edU thisQrI!Et finish ` and Threadsh.b5iserver_close_to clean-up6  @ @FqD oneinstantiating RH3xrClass.o.%],E)6 _R4to 6x an individual-e ? up  k o; gracefully The default is to print a tCBbackRwontinue5 ('-'*40, file=sys.stderr ' occurred dur]2 $ofq from',]x sfimportF.]_exc(F__enter__ra__exit-lf, *args):  self.server_close() class TCPSR(Base @): ;0""" * for various socket-based Z&2es.<Defaults to synchron:IP stream (i.e.,)4Methods jthe caller- __init__(q _address, RequestHandlerC, bind_activate=True)- _forever(poll_interval=0.5'hutdown(hd"_rr() # if you don't use];fileno() -> int ;selector8that may be overridden a7get3-> , clientIutimeoutFeverifyIDprocess/sh 0OPerrorGatderivedDlfinishV )Voables K by o1 orYinstancesb#- s_familyhS_typex_queue_size (only5Z6s=allow_reuseNILc.-hr*2""" # =6.AF_INET%:"SOCK_STREAM&2= 5 = False!8def<2lf,rB:e"""ConstruB. Mextended, do not e.:[p.GAV( ,=9Eo.ifZP:tryQi_# #oexcept^ +88raiz)Vzdc0 `0if p.Q&g0set @opt(pet.SOL_'4ET,XSO_REUSEADDR, 1)  self.socket.bind(erver_address) - # =D0getNqname() 9Sdef sQqctivatef!):\"""Called by constructor to a4C theH.Y:May be overridden5"""balisten.request_queue_sizeOclosto clean-up7tafileno 9pReturn v0et 'w number Interface "iri@selef)3rY"^(no@get_T?est1Get" and client \Q from$hacceptshutdown,:estR4to 6ose an individual@.86try#explicitlyR#. . merely releasesBwaits for GC$bperforH0actW.F.(svSHUT_WR ex? OSErrorpass #some platw s may raise ENOTCONN here~~ 3x? uppoP clAUDPS3(TC "):`c"""UDPt /allow_reuse( = False>]P_type$.SOCK_DGRAM%`max_pa~|r = 81928_Sdata,Nf@recv].i>(Ov)] # No needScall o)6UDPLY c anything_ Vv sSpif hasattr(os, "fork"aD ForkingMixIn]"""Mix-inj?handle eachj in a new process)timeout = 300Ce_children = NSone max_children = 40# If true, server_close() waits until all @ processes complete.Lblock_onC = True def collect(self, *, =ing=False):7"""Internal routine toB forthat have exited."""J0if su.active is Nonew{freturn5we're above the max number of,and reap*mU # we go back below threshold. Notd at&1useTtpid(-1).6o b1abl'u in size() syscalls instead#of;`ren>): downsideJthis might1 QPwhichdidn't spawn, `is whyonly resort]Qwhen  Twhile len B) >=%B>try_pid, _ = os.FI, 0)+.discard(pid6except CP_Error\ do]5any,@( d.oclear(/OS\breakO2Now%i  1pidTEMPLATE*2raise error("internal: unsupported template operator %r" % (op,))_simple(av[2])qOBMAX_%2!;_ON!9V3MIN`? [PVav[0]Oav[1!, I~SUCCESSO^ }TyKUNTIIS :s SUBPATTERNgroup, add_4del ,avE3 F>ARK(8Z-1)*2"$# S_info!p,Bbine( PK01if *&+1#n P(2/op7oASSERT6? if0] >= 00) # look aheadlo, hi =\1].getwidth(if lo != hi~! -behind requires fixed-a@ pat/"i[%loF _co mpile(code, av[1], flags) emit(SUCCESS:[skip] = _lenL@) - Eelif op is CALL:e^*opY? S!; (0':_coN/AT"ifG & SRE_FLAG_MULTILINE@vav = AT#p.get(av Y_LOCALV SoUNICODV!W4&avhjBRANCH tail = []1append = . %for av in mub+$# hQ_infom1/*FJUMP)A(Z)0+vFAILURE) # Kof branchGIHw MCATEGORYL 2CH_:[av63CH_OGROUPREFnif notIGNORECASn s_q qTixes: # asciiKOK/se ?UNIV&-18wjEXISTSe @Xav[0]S?yesd!' ifl*2]m/noHl2=yesoM + 1e, av[2], flkags) code[skipno] = _len(B) -  3Yelse:P1E?yesFuyes + 19GDraise error("internal: unsupported operand type %r" % (op,)) def _compile_charset(, flags, )## - % subprogramaemit =3q.appendfor op, av in<S66(opfif op is NEGATE*.ApassV %el,zLITERAL-[&av[1aRANGE l_UNI_IGNORvI6[0]Lmit(av[1dzCHARSETR.extend(?BIG;%CATEGORYt"if & SRE_FLAG_LOCAL#CH 7[av uNoUNICODO!Pro"2set:tortFAILUREoptimiziscased=None, fixup !es *Qacter set ou/![] stail = bmap = bytearray(256"ha = False@f while Tru:try+V "U@Blo =* ![lN$ q0es  loN_fixes6k,e0 4k Enot 'h 6=|/avr = range 0]R[1]+1lp /upL"iAmap(M3, r?Fi 71if f(;for k in fixeso[i]: charmap[k] = 17OelseU for i in map(fixup, r)4 i if not hascasedX &p = any(i8) rz  elif op is NEGATENout.append((op, av)Otail@ except IndexErrosif len() == 256 # ' acter set contains non-UCS1 _codesDmap += b'\0' * 0xff00.}ontinueo# Char= 2-j = Non E I0, pq[)p, & n 9q.0if b# use literal/_G@p, qB6"Pq - p91pLITERAL%;b1, (C- 1)>0outLd# if the1 waKnged or new rebentationAmorez5actH%if:*eout) <;setreturn out,=Q # originalQis good enough5Rcharset, hascased # use bitmapif len(charmap) == 256:1data = _mk_6+#out.append((CHARSET, 8())$ += tailreturn out, hascasTo represent a big set, firsq of allacters in theh# set is constructed. Then, this "sliced into chunks[3256Ia, duplicate* are eliminated, and each 3 isEgiven a number. I compiled ex1sio_"arAed by a 32-bit word sequence,`isting2one!3forH3the!`differl5, aM 256 bytes (64Ks#4N~2dextheir originaunk posit%aP1256XBs (8rQ$).4Com,normally good:qa typicyF, large range|Unicode will be eitherletely excluded (e.g. if only cyrillicH1let  toJmatched), oP,inPH5subq Kanji I)s E=0oneSs.AzeroOM00can`also d:efficiently:Y more significant3 ofz[S5an indexd':5Nlessf!istJH(just likeB4ingAQmap =s # shouldrhashablLas = {}[@mapp0Aarray(256block = 0+ i(%Pfor i(0, 65536,)=map[i: i +%]^$ifjns?Q[i //9" ='[]HOelse;pI+= 1+1unk _ [0:0] = [RQ] + _@_to_#s(33BIG 9out_CODEBITS@sre.SIZE * 8 MAX = (1 << .p) - 1 _9P_TRAN?b'0' + b'1' * 255 defQVbits,D=N, _int=int~..translate(lb)[::-1return [_int(s[i - _CODEBITS: i], 2)  for i in range(len(s), 0, -9 )] def _bytes_to_codes(b):L# Convert block indices to word array* a = memoryview(b).cast('I'0assGa.itemsize == _sre.BSIZEG'Za) * 0bPreturn a.tolist()simple(p0che f this subpattern is a "0" operator0if krp) != 1 ZuQFalse)op, av = p[0]Pif op\SUBPATTERN@Pav[0]$None and _y(av[-1]Nqn _UNITS0gene_overlap_tabSrefix1"""G,C an / / %the following pA.8A/4:oRqe same 0as J@a whichEinforms about#otential self-@eachf exPD - _0[i]C#0,[i:] can'tb[0:...Ak with 0 < k <= iQ-k+1:i+1]Rs, w20:k\m = *HS(1,"kRidx =b[i - 1eTwhile i]Bidx]*(1if J:= 0H# 0YbreakI*dxJelseb^:1+ 1NDt_iscased(flagsqif not  & SRE_FLAG_IGNORECASErWRgNelif:0UNIo 70uniGe.Uascii,Fget_literal_(n,a# look}/t:B = [`appendkN.1_skip = S@ = _b93in V.data"rvLITERAL(`d#av$R2(av"//s H#@grou~1dd_!T, del !av,%1 rcombine,?, aHAP1eWLOCALJ 11, got_allget_literal_prefix(p, flags1) Aif p!_skip is None:$/qif grou"?not&*Ob= len( x**el~1]$( +1s.extendy~got_allUbreakU;els# creturn,ka, TrueS% False def _get_charset_(pattern)Qwhile_l0if 0V.data!op, av = 75[0]!Eif oSUBPATTERNZTFa, add_T, del hU = ave' = _combine-(Ik"if & SRE_FLAG_IGNORECASE and jLOCALEpiscasedvLITERALQ3if 0 3(av'u"[()JfBRANCHm1B = [,FPappen.'for p in av[1]TQ  JNC +( ( )D(  UdI#  Q3in ; # "&$( KRANG""if > 0xffffm#Kdny(map, range(av[0]p[1]+1))ATBcompile_info(code, B@# inXCal: 4@ an 7 block. the current version,z# this contains min/maxmq width,an optional literalCQ or a+acter map `lo, hiNA.getW() if hi > MAXCODE: qhi = MAif lo == 0%code.extend([INFO, 4, 0, lo, hi]):Rareturn # look for a literal prefix  W = []_skip = 0qcharset% # not used!if(flags & SRE_FLAG_IGNORECASE and vLOCALE),, got_all = _get_;_,(pattern,"!# KC%@{.t/2 ##4~b#: print("*** PREFIX")43if oGCHARSET",)# add an info block0emijRappen(r>@len(*1); !0#gWEmaskN-ifG <f_;2 is NoneW O|VqLITERALW(el<e2!= 9E9@mit(!bq length$<'"lo;Kelse $# =2#[:"Otmin(hi,m)= >U {H)) #C$> = B(#(jM!O(= # generate overlap table=_,_,_,VR, hascased[optimize_(Iaassert 9}_compil> , K [1] =D@) -  def isstring(obj@ isinstance, (str, bytes))=_P#(pz1): sgr.state.|6"71## BZ%, n <Cthe @e=8T.data=.(SUCCESS)!2hex * '[%s]' % ', '.join('%#0*x`(_sre.SIZE*2+2, x)DCx in1dis^import sysPlabelYset() level = 0 offset_width = len(str(code) - 1)) ,def dis_(start, end):Jprint_(*args, to=None$(if to is not Clabels.add(to)b^ += ('(to %d)' % (to,),-('%*d%s %#, b':' ifB in  else '.'), =' '*(level-%{ >$2% 6Pend='[Q + 2*l) jnonlocal 3<12i =while i < 2E = i-Pop = /9[i]ik,OPCODES[op0@f op(SUCCESS, FAILURE, ANYO_ALL]MAX_UNTIL, MIN kNEGATEk/oJ_(opR5eliLITERAL, NOT_ I!P_IGNO5<4UNI,u_D?LOCD?argC, '%#02x (%rarg, chr(arg)cJs ATcV"5"AT_Jarg]]ssert arg[:3] == 'AT_'U,+3:LCATEGORY>/CH99n (IN, INDL?IN_J ?skiY*) i+ p_i+1, "= n (RANGE, GPlo, hZ: i+2r2o -a2lo) /hioCHARSE$oP_hex_(P[i: i/P56//_@BITS]))  i += 256//_CODEBITS elif op is BIGCHARSET:#+arg = code[i]e1`mappin9list(b''.join(x.to_bytes(_sre.SIZE, sys.morder)Qfor x inS: i +`.])Sprint_(op, arg, )IT Plevelujrange(arg)jp2(_hex_u(([i5D+:-= n (MARK, GROUPREF w_IGNORE4UNI iHC_LOC-m"4 ns JUMPuOskip\*p, to=i+ hxPs BRANCHJ`while gdis_(i+1, &Estart = iN _f!s'branch',/y 6OelseTFAILUREn (REPEAT, _ONE, MIN_CP, min[xd_: i+3If max == MAXX&% '&' E 3bnEXISTSh 24 2 n (ASSERT, O_NOT @\2\(NINFOQflags, min, max = code[i: i+4] if max == MAXREPEAT:%4&% '&'&print_(op, skip, bin(flags), min,jp, to=i+!)Bpstart = 1if L & SRE_INFO_PREFIXprefix_len, u# = +46H2(' <'J:M + 6"0!: +/',cg '[%s]' % ', '.join('%#02xx for x in)M @(%r)9'Ktmap(chr/)) #+=ftoverlap',$p'MoCHARSElevel += 1 ?in'Qdis_(/, i-ii Nelseraise ValueError(op) 8ep0, len(.)) def compile(p,}2=0)l# internal: convert pat list to"h2matif isstring(pM=1= p = sre_parse.f DBNonep@ = _=d FLAG_DEBUG(m2dis"^P# mapBeither direction`groupindex = p.state.Adict#@ = [:] *,s)@k, im0:w.items(H!r[i] = kreturn _sre.X8% |q 6s-1w, tuple( C) # # Secret Labs' Regular Expression Engine+various symbols used by the r:e:e:. # run this scripaupdate;  include files!oCopyright (c) 1998-2001r AB. All ,s reserved.E"Seep!py_ informa# on usage and redi buES """Ie support moduleKsre""" # @whenstants are adde,d or removed MAGIC = 20171005 from _sre import MAXREPEAT, NGROUPS # SRE standard exception (access as sre.error) # should this really be here? class e,$(EK): """ raised for invalid regular expressions. :Attributes:Omsg: The unformattedz message<+p"rn/g 0"os,index in the& w compila+failed (may UNone)MblinenoP  corresponding to pos<4col;ocolumn=2"""*__module__ = 're'def __init__(self, msg,=, K,`.msg =1G$ =G  os%os$if* is not x@ and{B`'%s at*ir%d' % (&os3pif isin3ce(W, str)1newe= '\n'Jelse1b2O nos.count(81, 0mY) + 1o=<Dos -2m.rfindB >3if bO(S %d, o6%d)U"Ano, i&3' =4! =super().cmsg) P_NamedIntCoSt(intnew__(cls, value, name#h PP, cls~ HA.U! =\areturn\Crepr\-M= = (' A') makecodes(sh s.strip().split(@item[qi: =enumeratek]globals().upd{[ : G0temD"s}  op^`ors # Oure=0 su&=1 (just because it looks better that way :-) OPCODESP!FAILURE SUCCESSANY ANY_ALLrASSERT B_NOTaBRANCHC1CATEGORYHARSET BIGC qDREF q_EXISTS#IN!FO AJUMP bLITERAMARK MAX_UNTIL MIN_UNOT_LITERAaNEGATE)CRANG REPEAT 2_ONSUBPATTERN\R"GROUPREF_IGNOR7(IN M4LOC;IN_U Y ];UNI] ] ] M_r0R MAX_; """) del OPCODES[-2:] # remove*H and9 # positions AT= = _makecodes("""yAT_BEGINNING Z_LINEeSTRING7pOUNDARY$SNON_B 0END5ENDK E&{:/ N)2) )- # categories CHCATEGORY_DIGIT zZSPACE& &JWORD% $YZBREAK) /0OC_E.$T -.. . [,^ placement opera for "ignore case" mode OPA = {{#:  ,': % } ScLOCALEZ^ )b0UNIcZc)} AT_MULTIa:eaAT_ENDA Q N.K&\]]& ] CH 5ALE\!:$%( ,,( $<( ,O'a &> * .Y_LINEBREAK: CATEGORY_LINEBREAK, 6NOT: } CH_UNICODE = {EWDIGIT=AUNI_m , 0[SPACE, (@ , 0KWORD+ &> * .a / 0G 4 } # flags SRE_FLAG_TEMPLAT1 # template mode (disable backtracking)=IGNORECAS?2 # case insensitive+PLOCAL'4 # honour system local+PMULTI@ = 8reat target as multiline stringeDOTALL = 168~a singl73use unic""dQVERBO6ignore whitespace and commenthPDEBUG2idebuggASCII = 25eascii   for INFO primgp_PREFIXhgas prefix!`LITERA$entire pattern is literal (given byBCCHARSET = < starts with character from Kset if __name__ == "__main__": def dump(f, d,{nitems = sorted(d)6@ in s5.write("#def;%s_%s %d\n" % (',;)\ open("sre_constants.h", "w")fmfi#""\ /* * Secret Labs' Regular Expression Engine -r e matching e)NOTE: This filegenerated py. If you need to ng!ytbin here, edit C rua.Copyright (c) 1997-2001 AB. All ,s reservedGSee the _sre.cpnformat'aon usa`d redi buG/ """) UMAGIC3{ OP@S, "42OP" I#'AT# *CH  } g, HJLOCALE %d\n" % SRE_FLAG_LOCALE) f.write("#define*MULTILINE %d\n"EHnDOTALLEBoUNICODDoVERBOSDD_DEBUG@^ASCII@/)  INFO_PREFIXB *jLITERAD~CHARSET)print("done") # # Secret Labs' Regular Expression Engine+convert re-style r/e/to sre pattern7 Copyright (c) 1998-2001 by} AB. All ,s reserved.EpSee the].py file for informaton usage and redistribuE` """Inal support moduKsre""" # XXX: show Bng offsetXoffending characterall errors from_constants imo* SPECIAL_ = ".\\[{()*+?^$|" REPEAT*+?{" DIGITS = frozenset("0123456789") OCT% o") HEX" 89abcdefABCDEF") kLETTERz)ghijklmnopqrstuvwxyz=GHIJKLMNOPQRSTUVWXYZWHITESPACE \t\n\r\v\f'_a yC{MINS, MAX }) _UNIT1ANY, RANGE, IN, me, NOT_ CATEGORY}) ESCAPEx{r"\a": (-@ord(4)),!b!'b"!f!f!n!n!r!r!t!t!v!v!\!\")) } "IA2AT, AT_BEGINNING_STRING), # start ofJ 08vOUNDARYNBV]NON_B"d"#[(4Y, _&)]QD/  3s3 bS/ bSPACE)]), r"\w": (IN, [(CATEGORY, _WORD)]), r"\W. =NOT2Z2!AT, AT_END_STRING), # end of string } FLAGS = {o# standard flags"i": SRE_,_IGNORECASE("LTLOCALmMULTILINscDOTALLQxTVERBOl# extensiona,SASCIIEttTEMPLAT{uUNICODE, 2TYPW& |Eq GLOBAL) CXDEBUG1 class Verbose(Exception):|Dpass$RState# keeps trackate for pars>def __init__(selfV.A = 0mgroupdict}widths = [None] # 4 Ilookbehind21R@property$ return len.&);Aopen$p, name=kagid = +C X.append(Ad&(if= > MAXGROUPS$raise error("too many "s"'!if is not l HoP.get(,2OS5S% Predef!0ionHR%r ase %d; " F '"w-C" % `gid, )[u] = gidh#Qclose`pX@[gidYp:(OKheckOL) <7andVsi{ g gsourceyk 4s-N"otc7gidWv.@'canrefer to an U'3@ if# >N 5q ed in the same 'IH' subpattern')>2ubP7# a(,qintermediLmx E,%te, dataesl if data is None: data = []Sself. qwidth =J def dump(9, level=0)gnl = True/| seqtypes = (tuple, list)!for op, av in YTFaprint(p*" " + str(op), end=''Q0Pif op*INI# member sublanguag!r V.av^%==+1)aX%elnBRANCHVR 7j@i, aenumerate(av[1]*Nif i`h iN"OR"y1!a. .*+1$GROUPREF_EXISTS}condgroup, item_yes uno = av-vE'', < %L'fv.no l_"ELSEv/nouisinstanc$, 'TNFalsi, SubPatternjif not nl#x  5;els?' '/Na) c 9*"av0__repr__preturn I7?len6?len51delow, indexv6del[b?get? ?w, slicedPstateA8Z!Ts[d Ab = codHainsert%C.-HIcappendI.&  def getwidth(self): %# determine the width (min, max) for this subpattern=0if O.5is not None`ggreturn+Alo = hi = 0qop, av i5JdataSif op is BRANCHtTMAXREPEAT - 1`jv~z^av[1]Y%l, h = av.get-()`)min(i, l"max(j, h" mlo + i`7ihi + j%elNCALL0i, v z,SUBPATTERNO[-1]B *2n __CODES 2 * av[0]o$1$n _UNITc [s GROUPREFstate.groupJs[avy"o_EXIST~  ifs 2]][ ,-;elsVZN,oSUCCESFUbreak0 = vIlo, !),'hiu class TokenizerZdef __init__O, stringWistext = isinstance(*2z.# =M!ifW$RY8_'latin1'ddecoded_45ingleIndexn 0 __6iW. G:try@char Jelf.[:except I]CErroself.next = None' ereturnif char == "\\":3index += 1:try(,F+= self.decoded_string[H]Dexcept Ib^ErrorRpraise e("bad escape (end of pattern)",Zg, len() - 1) from NoneI$2 = +anext =?8def matchb,)j? __X!()SF TruBFals1get~xSthis [YoW6*VQwhile[2, n7setgPresul!''8for _ in range(n/c,@ not<Y:set+%UbreaklI+= c 50Suntilterminator, name97 = ' !is N!#AaFmissing " +,4d%s, un!edAD" % /or c)'==N!if@a:, 1z7L;@property@1pos; )sL-b or ''D2telE)Aseek,L @, msg, offset=0V+%0.{ v@0) ^r_class_(source,a# handle `q insideiaacter H = ESCAPES._fn6odeD7@CATEGORICA and[0] is INU 9F[1:2x# hexadecimal(exactly two digits escape += source.getwhile(2, HEXDIGITS) if len(escape) != 4:!,TraiseUerror("incomplete =c %s" % ,V rreturn LITERAL, int[2:], 160elif c == "u" andjistext# unicod(exactly four digits\2426Y2qU2(_eight383/104L?c =Z chr(c) # `ValueE for invalid R  cN}dimportEdataHt# named X e.g. \N{EM DASH}4dif not$match('{')lmissing {"%@char Xuntil('}', '!Qacter'>>tryCord(.lookup(Mn)Gexcept KeySundefined V0 %rk,E}&11) +{r'\N{}' bin OCT t# octal(up to three&2,d J|t1t8#uz> 0o377j'vI %s outside of 'd'range 0-z'N! ?in j J== 2in ASCIILETTERS"%4bad/%s"42[1]except ValueErcror: Apass raise source.error("bad escape %s" % b, len()) def _(A,*bstate)p# handle code in expression= CATEGORIES.geto"!if<Vareturn!C_ESCAP@!6try]3c =Q[1:2]auv == "x"-# hexadecimal;6!,4 +=pgetwhile(2, HEXDIGITS)4(ifvZ != 4vYincompletxEULITERAL, in[2:], 16%eldu" andjistextQ# uni (exactly four digits\)2426Y2qU2(_eight383/104L^Z chr(c) # `ValueE for invalid3 cQN}dimportEdataHft# named  e.g. \N{EM DASH}4dif not$match('{'(VVmissing {"%@char Xuntil('}', '!Qacter'> Cord(.lookup(Mn)Gexcept Key>undefined V0 %rwk,E 11) +6{r'\N{}' 0?oct ?OCT  1e8^2in I [(# d *or* group reference (sigh)  if source.next in DIGITS:&1escape +=1Jget(M'Bif (+0[1]P2OCTSS and 2 qN L)/# got three octal digits; this is anuquc = int^:], 8+if c > 0o377&Traisebrerror('value %s outside of 'O'range 0-3' %,E3len)return LITERAL, c^\# notF, so group reference@ { #ifC< state.5s{!if%Qcheck*(i@"can1 to2pen"_[ lookbehindD GROUPREF, Vrinvalid.b %d" %', F - 1})ifJ== 2in ASCIILETTER{$baM0 %s  3ord2[1]+except VdE}Apass.' def _uniq(items\list(dict.fromkeys&") 9parse_sub(,, verbose, nestedW!# 1alternation: a|b|c V = []`append.vematch FtartCtellwhile TrueO{]!(_ O + 1D |ieC("|"0#Sbreak GV == 12[0]1`subpatmr = SubP ()$!# d if all A share a common prefixW=f = Non1forNuV: if not item: Ybreakif prefix is None5 =T9[0]@Delif3 !=ME z;elsi# all subs start with a common ")". # move it out of the branch(1for1 ins1del subpattern.append()a continue # check next one&$i can be replaced byharacter set=rset = [pif len(R)1"~op, av Pif opzLITERALE4set(C)=IN and av[0][0]PnNEGATES0exth(avM 4 PA# weLstore this asK instead4aX #< (Hcompiler may optimizQeven more((IN, _uniq(set)`return[ CBRANCH, (,sJFdef _parse(source,Mte, verbose, nested, first=False)!# : a simple r = SubPr(state)#6ute constants into local variablesZ' =Y)g$.gPmatch?.:`_len = ord = ordwhile True:3#= i< is8Q # enW><on "|)"< n{Cget(nT O# skip whitespaceK2ent}?WHITESPAC'<[== "# _  j #g2 orw/\nx5 aT\Tcode = _escap[ab(A>n SPECIAL_CHARS L(, _ord(this)))  elif this == "[":  here = source.tell() - 1%# character setset = []`append[2et. 6 ##z#ifumatch(":"):!+pass # handleyclassestQP.next:'['Simport warningC . (b'Possible nested at position %d' %T,JrFutureW, stacklevel=Z=+ 69)VnegatN*^"&eck remaiM while True;EJget(dkois NonD%SraiseG.error("unterminaP n";I  Q]" an]YbreakoR0[0]h;"\\V&code1 = __escape(,?els8!etin '-&~|'V" $''/%sO='difference' Mp== '-'  9 'iI0sec C&Csymmetric ~Kounion')4 9"$tLITERAL, _ord(G02o-E # potential range0thaEYY?at ] )aE\? - e*i!f |N_is IN+W,# =4J1][0| setappend(code1) s)(LITERAL, _ord("-"))8_breakVif that[0] == "\\":( 2 = _class_escape(source,GOelseV?'-'(import warnings,%. (+ /'Possible set difference at position %d' % MQ.tell() - 2),rFutureW, stacklevel=nested + 6E  840if 313!= 71 or2msg = "bad character range %s-%s"POthisA craise Uerror(msg, len(@s) + 1 +/atAlo =O1[1]K#hi"2"if hi < lo:RANGE, (lo, hi7_is IN>Km/[0p2)) = _uniq(set# XXX: should movoptimizato compiler!_@if _B[P1 and0[0]$is(# d Wif negatsubpatternS(NOT_g,/1] U se 6? et.insert(0, (NEGATE, None#9map# can't be added here because?# global flags still are not known3 1(INJ)U!elqis in REPEAT_CHARS`# reperevious items= !iY?X min, max =w 0, 1 elif this == "*":)min, max =>MAXREPEAT ) G+G 61, Gc F{Fif source.next}'Qsubpatternappend((LITERAL, _ord(9)))8continuelo = hi = ""cYwhilein DIGITSVSlo +=1Nget(match(",")K|/hi Oelseq-locif not})1seek(here=_if lomin = int(loW0if %&>=K)raise OverflowError("the repetition number is too large"{_if hii.hi9?ax ]{<5&(e'f'at greater than-",M^tell() - :PAsserunsupported quantifier %r" % (char, # figure out which item to)at9:&= FY[-1:]B9INone.!or`[0][0].ATUvnothingE c + len 2n _OCODEnrmultipl/atPs SUBPATTERNLgroup, add_flags, del p0tem1]  if group is None and not add_flags2del?: item = pif sourcematch("?")>subpattern[-1] = (MIN_REPEAT, (min, max, c)))aOelseR/AXRSelif this == "."[append((ANY,8?)) E(Ectart =.tell() - 1@]i= Trueaname =t 9= 0 # optionsUEcharJget(#1if &^ O!Traise error("unexpected end of #"ePn`# python extens( <) # dB: skip forward to$ <?D.getuntil(">", "#>!if&.isidentifier(j0msg = "badacter ina %r" % Nmsg, len(^) + 1;p "=qbackreferencU|\)\0gidQtate.N@dictg$id`Iounknow@\sQcheckO(gid @"can^can ope/",26lookbehind,D@CGROUPREF, : continue _else:-char = sourceget()+1if .ois NonTXSraiseW.error("unexpected end of pattern"uHknown extension ?P" +, @len(^) + 2$elo== ":"F# non-capturing group! => ! m#m}comment@while Tru$if_next &@miss), untermina".tell() - start+ )5/_break9Bin "=!'ATraise*error(msg, lenO + 1? ?try3~V= intr +?< 0d h`ValueE_vexcept *\ 1badacter iOQ from#aif notb !1"; number",mdE: >= MAXGROUPS sinvalid'$%d   checklookbehindv ,iLitem_yes = _parse(,R, verbose, nested#ifi.match("|"x/now/Q.next|/y"  with more than two branches lEM)M missing ), untermina^[tell() -rt)  (subpatternappend((GROUPREF_EXISTS, (condgroup, item_yes cno))) K continue elif char in FLAGS or}== "-":3Z# flags = _parse_(source, state,a"if[ is None: # globaltif not firstM4import warnin(%. (+ 'F&`at theQrt of expression %r%s' % TXN.string[:20],'truncate long regexeE4' (=d)' if leng) > 20 else '',)#DeprecationW~!cklevel=nested + 6m HAif (q.p & SRE__VERBOSE) andverbose+ rraise V+n2addR, del / =! = t*error("unknown extenxA?" +! 1j) + 1)R!#  :ent#if!isx ?tryZ=Hqte.open^(name qexcept 0 as W-err.msg,_^ fromCsub_CT = (( Eor ( l(* p{3subXy%, a1CJ<match(")")<8"missing ), untermina"mtell() --rt-(MQclose.(:, pM}SUBPATTERN, 5K) UPthis D^Dhernappend((AT, AT_BEGINNING)) elif this == "$":!subpatternappend((AL:ENDF*se:,raise AssertionError("unsupported special character %r" % (,^# unpack non-capturing groupsfor i in range(len())[::-1]op, av = %1[i]Jif op is SUBPATTERN<!z, add_flags, del ep = avM0"ifTNone and notBI rF: i+1] = pgreturn def _parse(source, state,t)f0get&A.getA = 0!ifMg != "->while Tru4 = FLAGS[{2if r.istextqn== 'L' (msg = "bad inline w`s: can{0use= with a str "IeImsg),,elBu))u'_bytes/!|=` @if (> & TYPE_)(: !Hbs 'a', 'u'^'L' are incompatiblegJget(0is dP"miss-, : or )"Ugn ")-:\breakk"in$Dqunknown#" .isalpha()  rPmsg, I)b')R.&|=h[&if% & GLOBALWon global>, 1 H"fKmsg, len(charC)) while True:flag = FLAGS[char]1if "q& TYPE_' AE msD"bad inline5s: cannot turn ofLs 'a', 'u' and 'L'"sQraise source.error(msg$@del_As |=p F# =CJget(=1if "kis Non^"missing :"Mn== ":"Ybreak"in~8Wqunknown#" ;.isalpha() else jmsg, len('bassertJ6if k& GLOBAL /bglobal2, 1Vcif add&| mzQed onlEoff"h!rel,k def fixQ(src,"s)q# CheckU2fixp accord"to the type of pattern (str or bytesisinstancei3strgbs & SRr_LOCALE$aValueE1"}Buse 1 with a 0if < rZASCIIq$&|=qUNICODE6/el& Mra1s are incompatibleSx(6y7|rv-C KG$Pparseu=0, state=e!# 'T 're' into list (opcode, argument) tuples  = Tokenizers)"ifr j@ = S. sc$.=[6tryAQp = _R_sub(BVERBOSE, 0except Verbos#. was switchYainside(P. to be#Psafe /s, we'll{@wholF?again...A ,Y 0 | SRE_FLAG_VERBOSE state.str = strource.seek(0)p = _parse_sub(s&!, F, True, 0) 0!p..flags = fix_ i(str, 32if S.next is not None:Siassert(e== ")""Traise!error("unbalanced parenthesis"x & SRE_FLAG_DEBUGwsp.dump(1return p defRse_template)C#% 're' replacementuing into list of literals and# group referencesVTokenizerw@sgetA.get+@0![]c*=  append =.@1addW(index, pos1if " >.,s!.|invalidb %d" %OgAi. Y(''.join()'B4del"[:!C5(le@2s),I[s0gH frQwhile@0thi(H1if +isbreak # /ofhm*G@[0] >6\\"y r01c =|&[1#Aif cFgEname = "!ifs.match("<">! %@miss3&<"+nsuntil(">", "o 5ame.isidentifier(:try)zn [s .)except KeyEVId*Sknown'c0 %r" 7els@|Oint(YG?< 0.QValue `!&TPs@bad character i",vz  + 1) fromt?>= MAXGROUPSw    addgroup(index, len(name) + 1) elif c == "0":&if s.next in OCTDIGITS(,this += sget(fO0S lappend(chr(int(/[1:], 8) & 0xff)?in isoctal = False E#Yif (cZQ and -2] D)._ ' >Tru#Lc = |l> 0o377Wraise s.error(' escape value %s outside of 'tN 'range 0-1' %r' 4=rc(sif not <). -.seM>try0 = ESCAPES[J][1]-except KeyElRin ASCIILETTERS Cbad /%sog,el(if literal#s./''.join(instance(source, strO6# The tokenizer implicitly decodes bytes objects as latin-1, we must &# therefore re-enA final representation.s = [None ZA is )<N#('~') for sX@]Rqreturn 4$s,As def expand_template( s, match2g =.FWUemptystring[:0t'm4 = Z=% ="[:; S sjP[-a] = g((Q) or xI: "invalid5 reference %d" % e]b xs) """Coopts/funcsinterpreting resultsos.stat()+Aos.l). Suggested usage: from stat import * """ # Indices for!struct members in the tuple returned by os.Q() ST_MODE = 0 @INO 1 1DEV 2 NLINK = 3 1UID4 G 5 1SIZN6 ATIME = 7 M 8 C 9Extract bitsmode def S_I(): """Raion ofpfile's / that can be set by@os.chmod().SX';& 0o7777?FMT'describest_ type `170000(Constants used as)various Xs # (not all areBlemented onpsystems `_IFDIR@0o04u # directory S_IFCH!2!0chaer device(3BLKI6(Xblock$2REG$1#0mqregularH2IFO$0%$fifo (named pipe))#LNq1symbolic link%0SOC50o1bsocketq# FallbackU uncommon platform-specific cXBDOORBu_IFPORT "WH  # Functions to testAeach~ kOSDIRlrTrue ifi0a.1 ==36DIRj/CHj#al~'CH~?BLKFz$6BLK?REGz6REGmOFIFOn1 s6IFOs/LNZ /n'LNN[yh[liLdoorgFFals]STn event x[ /WH4m a whiteout@.""" return False # Names for permission bits S_ISUID = 0o4000 # set UID" G 2 bit S_ENFMT = J # file locking enforcemen-QISVTXm1MTtickyl2REA1040Unix V7 synonympS_IRUSRQWRITEP0200 # 0W0BEXEC/1` X0BRWXU070AmaskHownePs/read by ."" # write#|#[execu%BRWXG%!07)Wgroup3GRP/4/."2"#X#1#%CRWXOje07 # others (not in 2)4OTH?4?>#2#$X$1$& flags UF_NODUMPKR= 0x0H0do Adump.IMMUTABL.W1may4be changed5kAPPENDc5only be appended to:kOPAQUE:8directory is opaque when view@hrough a unPstackSNOUNLINK {be renamed or deletCOMPRESSEA2QOS X:*hfs-compress:hHIDDEN8:dshouldEdisplayed SF_ARCHIVEDXBRrchiv2  2g 4tgSK [o[SF_SNAPSHOT@is a snapshoth@ _mode_table = (((S_IFLNK,qQ"l"), 6SOCP"s"),AMustar before IFREG and IFDIR as IF>3 ==|^7REG{-{&BLz: "b7DIR:d(CHc7IFO:ap")), Cr"),w|QUID, /[LX<S:x7GRP  "w"),),  ((S_IXGRP|S_ISGID, "s"),  Y "S:, "x")), <YGROTHCr"),[WwAXOTHyVTX, "tzS{)"T:x ) def filemode(!):"""Convert a!0's  to a string of the form '-rwxQ'."""Fperm = []for table in _v_v&bit, char* $"if& bit ==B"~.append(M)UbreakJelseFB2"-"Areturn "".join($) # Windows FILE_ATTRIBUTE constants) interpretAs.stat()'s # "st_attributes" member U_ARCHIVE = 32COMPRESSED = 2048!PDEVIC<-64IRECTORY = 16qENCRYPTYM1638?`HIDDENw ;INTEGRITY_STREAM-76`NORMAL~2T_CONTENT_INDEX=819NO_SCRUB_DATAMM3107&`OFFLIN =409qREADONL  REPARSE_POINT`-02 S#] = 51PSYSTE  ;qTEMPORA-25QVIRTU%Q65536}If avail` , use C implementation try`from _z# ort * except ImportError,Ppass `Basic 5Qisticule. Thi provides funcvqcalculaCof data, including averages, variance, andyndard deviG. CW9/ -= =- # FBpDescripg5@mean[Arithmetic ()G1. f5 Fast, flo~zpoint aL. geometric_CGp. harmon+# H +LmediM(middle value3F_lowBLow U_high)H  )rgrouped,, or 50th percenti le, of grouped data. mode M(most common value)>6Kulti;@List".s ?s?). quantileszaDivideP intoervals with equal probability. =-  Calculate the arithmetic mean ("uverage"a: >>>#([-1.0, 2.5, 3.25, 5.75]) 2.625 bstandard medianbiscret[([2, 3, 4, R.3.PG, or 50th perceau[Vclassa .ared on1sqd. E.g. if yourpoints are rounded to .nearest whole number_3 ]) #doctest: +ELLIPSIS 2.83... This should bepD0d ipis way: have two&!e A intnQ 1.5-Bthre 1p0val -3 anBX'3.5-4.5. TheKthesf"s ing varispread -  */ Function Descripb0p(nc0Popx!of%. bSample)K-gpstdev*7 ^Pdevia$: h7 y7 sb!([Q5, 11!11e4.38961843444IApreviously c3d2),jQcan p^At aso"al second argument to fQ"3" fisavoid reo#it = [1, 24&)B, 6]2u =.)i(@, muWStatistics for rel s betweenCoinputsv0M=== ======== covariance wSample for two ,bles. correlation9Pearson's coefficient Ilinear_regressOIntercept and slope;!si3 3.. .  Calculat/, , inputs: >>> x = [1, 2, 3, 4, 5, 6, 7, 8, 9]$y$- $(x, y) 0.75>| #doctest: +ELLIPSIS 0.31622776601...<Z B! LR(t=0.1, i=1.5) Exeions - A single e is defined: StatisticsErrora subclass of Value. """ __all__9 'NormalDist', V/vTfmean geometric_kharmon PD:Fmedi^_grouped0$[_high5low5ode Wultimdpstdevpquantiles" /.] import math tnumbersrandom from frac(#s 9FtdecimalDitertool;by, repeat&dbisectAs_left, Crigh-+hypot, sqrt, fabs, exp, erf, tau, log, fsumj`operatitemgetter Zcolle0Cou, namedtuple # "  (!):Tpass D@PrivutilitiesKdef _sum(data86""" -> (type, sum, c!) aReturn a oa-preci0sum~the given numeric eU as attogether with 8rP to b_pnverted eZ"s.!ExsGS[3, 2.25, 4.5, -0a0.25])7"(<^'float'>, (19, 2), <Some sourcenround-off e@willavoided:# Built-inQ! rDqs zero.1e50, 1, - ] * 1000 007A), 3/Vions and Dec%imals are also supported: >>> from fractions im"# FU as F,_sum([F(2, 3), F(7, 5 A1, 4 q5, 6)])3(,d(63, 20)C 0decDAas Dbdata = [D("0.1375"), E2108 E3061 u0419")]DI .y 9H1000Mixed typexcurrently treatedR an error, except that int isallowed. 1"""count = 0PpartiI= {}0_ge'!A.get 0T =d 0for, values in groupby(,1e):,*<_coerce(T) # or raise TypeE2b@n, d[map(_exact_ratiowaeE+= 1Fd[d] = (d, 0) + n1pif Noner&# The sum will be a NANINF. We can igno/l the finite^#, and just look ais special one7Wtotal[~assert not _iss(4HelsebSum als using builtin( ) Hd, n8.items()qreturn !, w) defx6try>Sx.is_=Likely a ^AttributV MUmath.,xPCs to float first.S2"""41s TSAa common,% .@}ion rulOmplementn detail. See_?BeTesRtest 40in  _s:RsticsAs+#Phttp://bugs.python.org/issue240685mAT isrpbool, " yA# Ifsame, no ne"o b anything. Pu@#B, soDusual case (nBOSed) happens52soo#spossible"ifCS: oTu\t& otherte @if S2"or  Zs6intSu IfGa (strict) suboNKVu%8l(S, T)m7if #T, S): return T # Ints coerce to the other type.%if issubclass(T, int): return S%S%oMixed fraction & floats3(ory)FLX) and"S,B!):T.Gc J3Any7qcombinais disallowedmsg = "don't know how!%s1%s"raise TypeError(?% (T.__name__, S )) def _exact_r#(xB"""RReal number x|/ (numerator, denomor) pair. :>>>^Q0.25)b(1, 4)'x is expectedbPbe an8$, M, Decimal """"=tryox.as_integer}except Attribut.?Apass((OverflowVb, Valu4--#?@ NAN2INFassert not _isfinite(x i(x, None # x may Ivral ABCfF.(x.5`= f"cau@conv0 '{5(x)E }'p/m|` (vT3, TRC"""CzfPgivenAericq4 T.!ifH)QTP# ThiAverscases where T.h#oryi 7# a, (t+Cu$V != 12T =[H FIXME: what do we o!s?;T(7{ QU~D) / 9Felsenfind_lteq(a, q'Locateleftmost D ly equal2!x'i = bisect_2N0f ioRlen(aa[i] == xi3 rlOrigh3b, lo=l=(5+ 1O - 1 ail_neg(values, errmsg='negative value'): """Iterate overs, failing if any are less than zero."""Bfor x in;W[if x < 0raise StatisticsError(errmsg)Q&(yield x # === Measures of central tendency (averages), def mean(data Return the sample arithmetic0]3!. 1>>>([1, 2, 3, 4, 4]62.8'from fractions import F[ as FSF(3, 7), F(^1 A5, 3 1 iF(13, 21)vtdecimaltDKas DsD("0.5"), 7 &62 3{M('0.5625'|PIf ``)`` is empty, will be !d.4rif iterDN(r = list#=neif n < 1:m ('` requiDat least one lbpoint'T, total, count = _sumdassert1= nr^_convert(D / n, T) fJB"""C0to floats and compute This runs fasterjQ) funPit always 2s ao!IfjQinput0set"it6 1[3.5, 4.0, 5.25OA4.25,2tryexcept Type&,# HandleFAator t do not define __len__()e0)(Cable.nonlocal"n,Aenum@D, start=1M: &0= fc)Felse ,& E}"HZeroDivisionP78 CNonegeometric_DcR>u containD@, or=i ,|No special efforre made to achieve exact resultsz(However, tmay change7sfuture.`Heround(H[54, 24, 36]), 9&236. W return e!xp(fmean(map(log, data))) except ValueError:raise Statistics('geometric V requires a non-emptybUset 'MQ)'containing positive numbers') from None def harmonic_z(, weights=')"""Return the5!of!. T !is5reciprocal ofarithmetF-s. . It can be used for averagratios orEQates,#example speedsSuppose a car travels 40 km/hr85 km andn>a-up tob6,another 4s. What ~?(5>>>L[40, 60]J$B48.02,@whenffic clears, 3rem<3|rjourneyG&_X[5, 3$56PIf `` ``D , ny elemen]0les]ran zero)```` will {+``}1``.1"""qif iter )|r = list#5errmsg = '{does not sjqrt negavsnQ'enPif n < 1x (o=8t least oner point'V!el`B== 1+u1x =>1[0] sinstance(x, (\.Real, Decimal)83if x < 0]R&rxJelseQM2TypyC('un{sed type$if = repeat(1, nFsum_#n #C&F Pktif len(Z != nB N< QmatchD siz_7_, , _ = _sum(w w in _fail_neg#, 6try,419x`T, tot<Vcountv@/ x  _" 0,Vn zipX |ZeroDivisiondF0"if|8 <=Wr('Weighted Xsum must be positive') return _convert(sum_weights / total, T) # FIXME: investigate ways to calculmedians without sorting? Quickselect? def *q(data):B"""R3the (middle value) of numeric :!. :PWhen 5`number& points is odd,)V&.IQeven,l]interpolated byJataking)paverage{Ctwo "s:3>>>([1, 3, 5]3R 3, 7#24.0F1""".="edfwn = lenif n == 0 aise StatisticsError("no for empty"I0% 2M1M[n // 2]Felse&Bi = 9[i - 1] +q[i]) / 2 KA_low,O4lowD*E'edD it-RsmallB .G $3 Ohigh6 Olarg& _%5n]Sgroup!, ?_val=150th percentile (y I continuous,B)TA2, 2`84, o,.7?A52, 4}352.uUThis s" a , and should bex`used wAyour42. I above example, the valuHes 1, 2, 3, etc. actually represent the midpoint of classes 0.5-1.5, 1.5-2.5, 2.5-3OT< dle value falls somewhere inHT` 3.5-4<and interpolation is used to estimate it. > Op$al argum!``?Vval``sl Q, andFdefaultsd1. Changing4a natur'`will c+e)I[ed 50th percenti:>>> median_grouped([13, 5, 7],aval=1)]A3.25 =2=5zThis func9 does not check whethera data s are at least faapart.1"""== sorted(wn = lenif n == 0:9[ raise StatisticsError("no3 for empty"[$elK1KQeturn'1[0]ba# Finda. Remembis correspond 3theG re( \2x ={bn // 2obj in (x)if isinstance(obj, (str, bytes)*.BType('expected nubut got %r' % obj06trysuL = x -t / 2 # lower limi.uexcept ^P# Mixype. For now we just co$|CfloaIb(x) - c@val)# Uses bise`searchR txr with log(n) time complexity"Aposi)of leftmost occurrencX<l1 = _find_lteq2, xs{YOrighZ e[l1...8Hp# Assumalways l1 <= l22r%l1 cf1- 02 -C"+ r;5L +P * (nxP - cff def modeB"""R@/6RcommoW from discrete Qminal4 ``[@`` a&es0 s a singj!. iQdard treat.!of d aly taught2sschoolsD3"4]+3also works"no(non-numeric)l"red", "bluePgreen'red' If therBe are multiple modes with same frequency, return the first one encountered: 1>>>N(['red', PgreenEblue0]) 6)IIf *data* is empty, `` ``, raises StatisticsError.;1"""Rpairs = Co`(iter(T)).most_common(1Atry:8Ca[0][0]except Indexs2 A('no B for ') from NJR defYB"""R}@a lizftly occurring values DWillmore than result iOr Sor anikLC'aab2cc'`B['b'F,ccddddeeffffgg41, 'Ef>*[1max2,P_item=next(groupby(!ps, key=!0getQ1)), (0, [])M<0@(mapxm-(0)b)) # Notes on methods,`computquantiles # - # # There?!noperfect way to b%e `@. H2we offer # twothat serve;mon needs. Mother packagsurveyedMed at lea+ne or both o sekP, makthem # "standard" i@sens "widely-adopt\nd reproducible".yalso easexplain, manually, and have # straight-forward interpre{0onsSten't surprising.The defajknown as "R6", "PERCENTILE.EXC","expected #(rank order s~ ". alternativekL+R7m$INma0For)! w\baa posi~probability # beyondArangSP,R6 exclusa # reasonable choice. Consia randomrof nine:sjEpopulationa uniform distribu00.0%P1.0. b* #%` third4kedPpointdescribed bytavariate(alpha=3, beta=7) which has=0.250, median!86Q # me 30AOnly< la" (HcorrespondR6) gives the # des:ired cut point with 30% of the population falling below that # value, mak!it comparable to a result from an inv_cdf() funcX2. # The R6 exclusive method is also idempotent. # For describingdata where2ends are known to # be included in-<, "R7 p reason # choice. Instead3mean, it usesPDmodebeta # distribuA for(interior. Per Hyndman & FY"One nice # property)FverticesrQ7(p) divid@rangto n - 1 # vvals, and exactly 100p$1 lileft of # g>100(1 - p)< @righ=; ."If needed, otherps couldadded. However,:1now1osiRiyat fewer opse3ceasiers? # external packages can{Aused<Panythmore advanced. def quantiles(Ns*, n=4,%=''): """D*2*o *n* continuous er0equrobability. LReturns a lis]()@s setD1Set~Ato 4Aquar (0default). +!10,0dec.  Rperce  which giv$ 99s_!%e XB100 sized groupsN.rany iteY0ainbsample60linearly`polate`tween yBIf **0set*iL%*,Qs treOae:Y!. minimum gT6F0th VeF?max; *10=1""">if n < 1raise StatisticsError('n must"at least 1')D = sortedld = lenif ld < 2pnUhave p8two~#ifvU == ''bmdA= []i%<S(1, nj, delta =kmod(i * m)F(mG!= a[j] * D1) +`[j + 19/ nM.append([fqr>thod == 'exclusive': m = ld + 1result = []for i in range(1, n)ELj = i * m // n# rescale i to m/nj6L1 if j < 1 else ld-> j # clampHA1 .. NPdelta*m - j* # exact integer mathNrpolated = (data[j - 1] * (n - qB) + */ k.append([)u`return11ultraise ValueError(f'Unknown method: { !r}') # === Measures of spreadSee http://world.wolfram.com/Variance.html #1 oSample7en.wikipedia.org//Algorithms_for_calculating_v # # Under no circumsts use the so-called "computational formula4 # S ", as that is only suitable*e hand ons with a smal`amountXlow-precision`. It h`@erriSnumeric properties. a `arisonPQthreems here: #www.johndcookblog/2008/09/26/[1ng-W-I@-of-uh-Ldard-devi8/ def _ss, c=NoneB"""R0sumusquare ?prequence If ``c``uQ,@meanp edxone pass, `MFfrom@ Aa secondF. Otherwise,1areM;Xas given. UhSBcaseAcareMRit calito garbage!s.j1"""@if c@not ]T, total, ce= _sum((x-c)**2x#n 7(? M;~A_n, }" /~P).as_Pger_r(Ypartials = C#er:1n, `map(_e`<,HTdiff_n = nJPean_dP P)ddG[N! Q] += ^ 5!ifsD<0# TQ um will be a NAN or INF. We ignore allRfinitL$# Yjust look at this special one7{==[passert 32_iss(4": total\ = sum(Fraction(n, d) for d, n in partials.items()) return (T, total) def variance(data, xbar=None): 7B"""R:the sample4@ of 7!. c  should be an iterable)Real-valued numbers, with at least twoI&s. The opal argument , if given,rqmean ofH . If it is missing or None, $4 is automatically calculatedUse this fun} when your`a$from a popDbion. TX|v 1gentire:, see ``p,#``!Ex"s:2>>>= [2.75, 1b25, 0. A3.5](8\(131.3720238095g If have alread-Ro(,3 ca ss!as|fsecond ```` to avoid re?'it@m = x ?, m Tdoes not check that 11ctu,|z ``Gp``. Givarbitrary K0maydinvalid or pimpossiEsresultsDecimals and s are supported_d4 U3rt CQ as Dm 0[D("27.5"), D("3@ 4#4o2")]c^('31.01875')@ffsFF(1, 6), 2 D5, 3s@(67, 108q1"""Mi"er!r = list#5n'enif n < 2:raise StatisticsError('T requiresrpoints'3T, ss = _ssp _convert(ss / (n - 1), T)%A/mu  sequenceE1oneU/mut&to .To estimat329%~$``W&``[iusually a better choice. Examples:>>> data = [0.0, 0.251 1.5, 1.75, 2Q3.25]M>pvariance(H)9`If you have already calculated the mean of C,2can pass it asV-optional second argument to avoid re`ging itAmu =oL, muDecimals and Fracs are supportedibfrom d40 im  CQ as D z[D("27.5"), D("3 4#42")]_('24.815')efFF(1, 4), F(5 D1, 2rAs(13, 72q1"""Mrif iterj1 isf:r = list#n'enif n < 1:raise StatisticsError(' requires at least oner point'1T, ss = _sspreturn _convert(ss / n, T) def stdev5xbar=None)B"""R@0squ$Droots 6dSee ``e`` forwother details7[2c, 4.75'1.0810874155219827(# Fixme: Despiteexact sumqd devia, some inaccuracy# remain becausJ!re3two roundsteps. The firGCs inHI ) 1.1(),o? math.sqrt().LUvar ={2try3varCBexcept Attribute~ 5y4var6pl50pop25ion9:;0.986893273527251:/;9:MW# ===2rel{ between S`inputs0 # See https://en.wikipedia.org//Covariance # ohttps:/Pearson_correlati efficientDSimple_linear_regression def c(x, y, /): 7"""Return the saV> of two inputs *x* and *y*. HZis a measure7he joint abilityP!. >>> x = [1, 2, 3, 4, 5, 6, 7, 8, 9](y(1 ( )AA0.75 rzJ9`7l5x31JzJ6-7.JlGz, x"m1"""n = len(!!ifry) != nHraise StatisticsError('e requires that both1have numbero`data p"s'if n < 2t"at least\xbar = fsum(x) / nyy sx-`(xi - ?`) * (y6) for xi, yi in zip)rI/ (n - 1) _2 7's 6 co2-%. 2Kh *r* takes values between -1ld+1. ItZePstrength%PdirecI `ship, where +1Mtns veryKong, positive >!-12A str.Gnega.J p+O0 noP% p11.0L-#$5Yu| sxQ* 2.0Gx&sy&*/y7try Psqrt(}C* sy.except ZeroDiviDrC raise StatHisticsError('at least one of the inputs is constant') LinearRegression = namedtuple(' ', ('slope', 'intercept')LQdef lP%_rQ(x, y, /): """S?U and @ for simpleB B!. :aReturn B/ofA?parameters estimated using ordinary5squares. SE( describes relationship between an independent variableF1*x*.a ! *y* in termsQP funce: KBy = W* x +Nr+ noise+qwhere **x*xQ* areS*@that#7,c representsGPilityyQdata I1wasInot explained by:0(itequal to&?differencen`predicW0act3QvalueDD3le)]GThe rped as a  t3>>> x = [1, 2, 3, 4, 5]_ = NormalDist().sas(5, seed=42)1[3 * x[i] + 2 !irange(5)i: s) #doctest: +ELLIPSISm (=3.09078914170...,R=1.75684970486...)\1"""R7Rlen(x0if ry) != nraise Stati requireTtat bothhave same numberfbupoints'_n < 2{)ENtwo cxbar = fsum(x) / n yy sx-`(xi - ?`) * (y6)Qxi, y1zip<) sxmBS* 2.0; 6try.Pxy / J@ # d0valqto: co2ncex" / ex ZeroDivisionskxy0 = & -1barO S###| }@ribuA/ #!0 !_n _dist_inv_cdf(p, mu, sigma1# Tvis no closed-form sol inverse CDFe # k , so we use a rational apprNoximation instead: # Wichura, M.J. (1988). "Algorithm AS241: The Percentage Points of theKNormal Distribun!". Applied Statistics. Blackwell Publishing. 37J(3): 477–484. doi:10.2307/2347330. JSTOR :q = p - 0.5if fabs(q) <= 0.425 r 180625 - q * q6# Hash sum: 55.88319_28806_14901_4439.rnum = (2.50908_09287_30122_6727e+3 * r +7i 3.34305_75583_58812_8105e+4)8 6.72657_70927_00870_08538 4.59219_53931_54987_14578 1.37316_93765_50946_1121.97159_09503_0655E 1.33141_66789_17843_7745e+28 3.38713_28727_96366_6080e+086den 5.22649_52788_52854_5610 2.87290_85735_72194_2674M 3.93078_958002A71_0o 2.12137_94301_586595.39419_60214_24751_107`6.8718_749_20579_0830 4.23133_30701_60091_1252e+1p E1.0)'@x = bU/ denreturn mu + (x * sigma6bp if q0 else 1.0 - pC#sqrt(-log(r)9@if r3:5.0)qr - 1.6;  49.33206_50330_16102_8903/! 7.74545_01427_83414_07640e-4 2.27238_44989_26918_45833e-  2.41780_72517_745o1770e- 27045_82524_52368_38258E0 3.64784_83247_63204_605049 5.76949_7260691_4055r4.63033_78461_56aO29599P1.423T1107_496~1773 % 1.05075_00716_44416_84324e-9 5.47593_80849_95344_9460 51986_66563_61645_71966 1.48103_9 7642_74800_74590e-1) * r +  6.89767_33498_51000_04559 1.67638_48301_83803_84940e+0r 2.05319_16266_37758_821879 A1.0)Qelse: r = r - 5.0# Hash sum: 47.52583_31754_92896_71629/rnum = ( 2.01033_43992_92288_13265e-7J 2.71155_55687_43487_57815e-5 @1.24 09473_88078_43860e-39 2.65321_89526_57612_30930e-29 96560_57182_85048_9129. 1.78482_65399_17291_3358P5.4639111_64114_36999 6.65790_46435_01103_777299dena4426_389939_78564e-15 1.42151_17/16445_88870e-7P `1.8463175_10054_68180 7.86869_1356132_59100e-4r 48753_6129061_48525 p1.36929g92_27358_5.99832_2068879_376b@x = jQ/ denif q < 0.0&!-x4return mu + (x * sigma) # If available, use C implementation try:Hpfrom _sPstics)ort _normal_dist_inv_cdf except ImportErrorpass class N9BDist" J@ribu of a random vari" # https://en.wikipedia.org//NN8Vfnce#Properties 9__slots__ = {:'_mu': 'Arithmetic mean '',;>Standard devizA } def __init__(self, mu=0.0,=:`du` wherebis the2and9 s.O#if- uraise S1!(' must be non-negative'<._mu = float(muH )@_amethodl$0_sas(cls, data)"Make a normal distribution instance from sample data." if not is-(!, (list, tuple)):07"0 = ".)xbar = fmeanreturn cls(&q, stdev% , 1)) H3defs(self, n, *, seed=None"Generate *n*6 for a given P and dard devia gauss = random.!ift@ is wT else"R)()/mu, sigma = !._Qelf._*[o(&8)@i innfge(n)]3pdfx Probability densAfunc P(x <= X < x+dx) / dxAvari*u ** 2.0,- raise StatisticsError(')cdefined when!is zero'Aexp((x -A)**2.0 / (-2.0*)sqrt(tau.c.Cumulative2 2X2&x)&"0.5 * (1.0 + erf 1 * X2.0))J@inv_,8, p3""Inverse ccx : P(B = pdFinds the value of L ble such thatp%ofcF0ria2being les^an or equal toIp#eMd.TThis also calledercent point*or quantilebG.)""0pD00.0p >= 1.05p must be`range KP< p >> N1 = NDist(2.4, 1.6)e*2*3.2, 2.0*$1.*N20.8035050657330205h"# See: "TaCmM of Z)# srpoint estima(N['woO`ies" -- Henry F. InmanYEdwin L. Bradley JrFhttp://dx.doi.org/10.1080/036109289088301276if not isinstance(, raise TypeError('Expected an<; V'wX, Y = q(Y._sigma, Y._mu) < (XX: # sort) asK commutativityRqEY, XX_var, Y = X.variw .%51 or2;*iSSstics !()8defined when is zero$Cdv =!- wdm = fabs*Rmu - !+dv& - erf(dm / (2.0 *CP* sqr60))a#U_mu *;C}b*M X@dm**r+ dv * log(H" /txH(a + b) / dvdx8M(a -3- (% 1x1)) 4) +C22lczscorex  Standard S0. (x - meanVstdevDescribes *x*Qtermshe numberUAdeviIslPaboveQbelowHn7jQ; # 6s://www.showto.com/V-and-$1/z-/| aise Statistics#Error('zscore() not defined when sigma is zero') return (x - self._mu) / 6 -@propertydef mean(4!):R"Arithmetic  of the normal distribution."6Lq/disRg me"ut=ode(""t?oderPThe m-!ispvalue xre whichprobability densitD@func= (pdf) takes its maximum U.Z/""]stdevStandard deviaO ~variancnUSquarcsInr ** 2.0__add__(x1, x2""Add a conet or another NaDist i2ce.TAIf *(*bB, translate mu by`,sleavingunchangedb, add bot=Qs andkTsMathematically, this works only i9twoUs areindependen&4y# jointly&lyF.Tif isVG(x2,n7)0(x12P + x2 q, hypot, )H , U38?sub8Subtract=F :? mu=5s?"an=TA-(/muA-HA?mulAMultiply!mu5QUsed for rescaling, perhaps to change measurement units. Sigma is scaled with the absolute value ofconstantA5"""Mreturn NormalDist(x1._mu * x2, sp* fabs(x2)) > def __truediv__(x1, x2):"""Divide both mu and NVby a 4Used for re//1posRq$pyi?ce. =neglpNegates{while keeping4?samv -.muw__radd__ = __ Arsub Subtract auW from or another&`-(x1 -w|c__rmul /eq7Twoe objects are equal iI irH %if not is(Jb'QtImpl%eda == x2O hash__(selfv"*#A(j , t!._ 2NreprFqf'{typeH).__name__}(mu={Rbmu!r},f!r})' """A collectiona0strns. Public modul/ riables: whitespace -- a =@tainHall ASCII , ascii_lowercas<+slettersC?uppC+ C) digits0decimal 0B hex :Khexa>?oct>6octvqpunctua-0chaxkPprint6uidered A qb __alw#[" 4", ", "ascii_uppercase", "capwords", p"digits!6hex 6oct printablHpunctuationKwhitespac(Formatter\Template"] import _string # Some s for ctype-style character classific} o = ' \t\n\r\v\f' ascii_lowe abcdefghijklmnopqrstuvwxyz/6upp/ ABCDEFGHIJKLMNOPQRSTUVWXYZ/ leLs = n+Q K0123456789' q3 = "2+ 'R' + '%' B''  = r"""!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~""" v(+ [&+ jF@ionsch aren't avail%3 as methods.7Capitalize the S in a-, e.g. " aBc dEf " -> "Abc Def". def (s, sep=None):%""(s [,sep])CZ %QSplitargument intopusing s$,kAeach? &c, and joinYdW@%Q. If* opFal second sep is abs0or pruns of|m"s replaced by]aingle @lead Ptrail Gmoved, otherwise?rused to, $eqreturn (>or ' '). 6(x./!()x!s.1o)) #0z re_re from collec#s ChainMap( 0 _inel_dict = {}  A0supl$-substitux.(_`delimiQ= '$'# r'[a-z]' matchesznon-ASCII Qwhen with IGNORECASE, butK"ou?flag. We cabdd re.0to s because ofIbackward compatibility. So we?a localG)! p#n.NSee https://bugs.python.org/issue31672-#id<p'(?a:[_b0-9]*)8Xbrace.FCf= _re.'"f__init_subc__(clsgsuper().()`$Cif ''Qcls._9"__&&&0 = $HJelse0$ `escape.;)  id = cls.idpattern b Ubrace%? or6J = fr"""R{delim}(?: (?P%) | # E sequence of two K_itersL0namJCid})L5 and a Python identifierL {{@d>{bP#}} L&LJinvalid># Other ill-formedK exp)d_re.compile(,flags | !VERBOSE) U def __init__(self, template).% =#D# Search for $$, $_F, ${"},ny bare $'sC,'moi = mo.start(')'lines = [:i].split(keepends=True<qif not $colno = 1+) Oelse;i - len(''.join(=vs[:-1]) V.& raise ValueError('IW placeholdMn string: %d, col %d' %p!no,7no)substituteapping=_s>nel_dict, /, **kws2f m.J is 1 *'F= kw@elif,_ChainMap(kws,l3# Helper functionV.sub(%vconvert(o# Check the most common path first.Uqgroup(' ')>3mo.5l,;NonP&Qretur(5[c]' if+od/')[Eelf. VV _-b RUnrecognized  ! iw)',D s: ,8Oafe_ Helper function for .sub() def convert(mo): named = mo.group('W') orvbraced'U<1if - is not None^&>tryreturn str(mapping[O]f+except KeyErrorP  G'ifPescap elf.delimiter? Vinvalid')Vraise Value('Unrecognizedq in pattern',3 s,;-!, 7 template) # Initialize T.; __init_subclass__( automatically ed # only01es,H&thb N1 it yoO #40 # AForme # see PEP 3101 details and purpose of this5 # The hard parts are reused fromkC implementa . 6py're exV d as "_" # prefixed methodsq@str.kpoveralln0ser\ ed:_string.f_parser.BfieloD6__split Fy(,G3mat, /, *args, **kw r8vF@2#, : s.t 4D_g = setXresult, _Dlf._`%, Q6, 2.check_un#( ,  X _K recursion_depthV_index=0;if @F < 0J 0Max6ing>  ed:nU = [])lal_text, Cpec,\C[(.("):U$# output| | R3if  G.append(,)piJrere's a,it  if field_name is not None: `# this$some markup, find the object and do>%formatting #handle arg indexing when emptys are given.H ^== ''if auto_arg_pOFals0raise ValueError('can5switch from manual- 'H'specification to_maticM numbering')j= str( 5 $] += 1])el.isdigit()'2~p# disabu`cremen,}it getsa # used later on,_n an excep@will be 6dF != me1it reference!# .@arguP it c|9 @obj,_= self.get_(args, kw@`s.add()do any convershe resul >Qw0exp;% ^neede'_' +"_v%(CA@,/2Da, recu_depth-12 =gP@appefo .,(N-4)return ''.join(K!), /0def _viQ, keyif isinstance(*;int U[key]e+-check_un, args, kwargSs): apass def format_field(self, value,Gspec?creturn(+\oconver]Gsion\# do any  on the resulting object(if.vis None#r8*el:o== 's'92str)> r>?rep?a?\asciipraise VError("Unknown ifier {0!s}".(]#))"# $s an iterable thatQtains tuples ofL-A# (l3l_text, KJ_namD,K1verI(# 9 can be zero length&Q$, in which casere's no7*3 to and outpu?G# if i=tA@, itlooked up4ted_CwithZ_l_]sthen us5pSparseiEat_string Ater_=*r(8wgiven a!nd7references.b1: /0 bere.g. "0.">d@or "3Uup[3]%P_argsb` a setL have be10# @, kwP: as  edBto v ^*genBJm`first,a?t =tCv_split()G`obj = @.l([ y3# loop throughv1resgq, doingl# getattr or @itemCneedk(pfor is_)0, i2` $if# kv(obj, i";elsl8fobj[i]G # This filelgenerated by mkprep.py. DO NOT EDIT. """Libraryexposes various tbs foun*Ahe SfPrep RFC 3454. There are two kindA:sja member tis provided, ]|mapping3 function8 from unicodedata import ucd_3_2_0 ` asse!4@.uni<_en == '3.2.0' def in_table_a1(code): if unidata.category# != 'Cn': return False8rc = ord(if 0xFDD0 <= c </F0<M@(c &%FFF) not in (0xFFFE, b1_set = set([173, 847, 615056`7, 820#1204 588, 65279] + list(range(65024,65040)))(b(3_exceptions = { 0xb5:'\u03bc'adf:'ss `130:'i"07!49,2bcn', 0x17.Qf0:'j-I$34Y9!`37a:' !!b9=1390N03b9!081-b!c5 "c28"c3,d,"b2X"d1 #b8 053 #cd4b@#c6 6 0#bap"c1@fpfPb1587P 561582Fp1e96:'hX3Hp1e97:'t0q1e98:'w|z1e99:'ya:'a\u02be@1e9bq21e6]31f52^141f51313W41f5&$f5#4!f8n@1f00Qa 0x1f87J1f01D1f02i!f811f0ED1f04.\s11f0.D1f06.\D1f07E87 a. | c. d e f X:1f2p9p2p9p29p2p9p29p2Z\u1f2 p p p p p p p p2a6pap6pap6pap6pap6papC3a6pa6p p p p p p, 0x1fae:'\u 1f66\u03b9', 0x1faf:'\u1f67 "b2*703J03b14$ac\"b6.B42',\74cec4?c ce..c 4dY.!080d91ddQen'c5Qnen ne c#13e4h f:1f7f!fy fy.yfyKfc 0x20a8:'rst2102:'c Axb0cr2210]425b!9:'\xb0fDb:'h c q 0x210d nc110:'i$'11 C2:'liT15:'n$T6:'no D9:'p Da:'q1Db:'rc d c20:'sm1s21:'tel3d22:'tm D4:'z 8 D2c:'&2d&S30:'e0S31:'fcD33:'T381213?203c}q2145:'d:3371:'hpaT3373:'au S5:'ov @80:'' 0x3381:'n48cE03bc S4:'kanR85:'ku3386:'m E7:'g Ba:'pr338b:'n3338W$bcR90:'hDp3391:'kP92:'m V93:'gE4:'taPaa:'k7Vab:'mEc:'gcb4:'pvbI/WcE7:'m E8:'k99wub wrEd:'mEe:'k fPc0:'kct33c1:'m#bqwc6:'c\u2215kgc7:'co.zTc8:'ddc9:'gy(733cd:'kk4 33:p033d~pr5Tdc:'s6Rdd:'wvrfb00:'f0fb0 i4 fbWfo@fb03'@fb04T5:'st66 ` 0xfb1@u05715762fb1 $655bR17 57NE.dE1d400:'a', 0x1d401:'b', 0 r2:'c', E3:'d E4:'e E5:'f4E6:'gE7:'h E8:'i E9:'j4Ea:'kEb:'l Ec:'m Ed:'n4Ee:'oDf:'p U10:'q D1:'r4U12:'sE3:'t E4:'u E5:'v4E6:'wE7:'x E8:'y D9:'z4T34:'a!35RE'36R!37Rl'38R!39R4aR!3bR4cR!3dR4eR!3fR4'40R!41R4'42R!43R44R!45R46R!47R48R!49R4aR!4bR4cR!4dR4'68R!69R4'6aR!6bR4cR!6dR4eR!6fR4'70R!71R4'72R!73R44R!75R46R!77R48R!79R4aR!7bR4cR!7dR4eR!7fR4'80R!81R4'9cR'9eE'9fE!a2+4!a5['a6!a9a4b'ac'ae!af4'b0!b1['b2!b344!b54'd0dddddddddddddddeeeeeeeeee'50'50"50y"50'50'50'50"504N '515o|"514'51'51'51'51'51'51'5155b5d35f'5i4j')5)"5484x'54Q5o54c:'u', 0x1d54d:'v', 0x1d54e:'w Df:'x 50:'y', 'T6c:'aU6d:'b Ee:'c Df:'d4T70:'eU71:'f E2:'g E3:'h4E4:'iE5:'j E6:'k E7:'l4E8:'mE9:'n Ea:'o Eb:'p4Ec:'qEd:'r Ee:'s Df:'t4T80:'u681:E'82E!83E8!84ElT85:'zA'a0R!a1R4'a2R!a3RA'a4R!a5R46R!a7R48R!a9R4aR!abR4cR!adR4eR!afR4'b0R!b1R4'b2R!b3R44R!b5R46R!b7R48R!b9R4'd4R!d5R4'd6R!d7R48R!d9R4aR!dbR4cR!ddR4eR!dfR4'e0R!e1R4'e2R!e3R44R!e5R46R!e7R48R!e9R4aR!ebR4cR!edR46608R1609R4660aR160bR4cR160dR4eR160fR4&10R1611R4&12R1613R44R1615R46R1617R48R1619R4aR161bR4cR161dR4;'61;"62;A!21R43H'63H'63H163fR44H'64H'64H'64H'64H'64H'64H'64H'64H'64H'64H'64H'64H'64H6YH'64H6YH'65H'65H'65H'65H'65H6f6fb'67H'67H'67H'67H'67H'67H'67H'67H'67H'67H'67H'67H'67H'67H6f6frfRftL6fRfv4Hd687:'x', 0x1d688:'y', 0x q9:'z', a8:'\u03b1#a92a3b4Hc5$d6e7f8H#b09$#b1a2b3cH4d$5e6f7%c0H c b 86 c b c b c b c b c b c c c d~e e$$b2e e 4e e %b6H be e be %baH be %bc be $beHf bf@f f hf Vf H f `f f H #70~H$71 #71$H$71 $71 $72 #72 H2 ,72 #72 #72 H #72 2 b#72 H #72@H $72 #72 VZ H3 #73 63 #73 H 4~5 5$H5 5 $75 5 H 5 5 5 H6 6  6 6 H 6@H 6 #76 V6 H 6  6 H 8~H9 9$H9 9 9 9 H 9 8', 0x1d798:'\u03b9', 0x1d799:aabbBc', 6cd$deeff$c0H#a01$"a1%b82%c334H45$566778H8 b~)} def map_table_b3(code): r = b3_exceptions.get(ord%)% if r is not None: return r V.lower() v32(asJal =agpb = uniH data.normalize("NFKC", al*C"".join([h) for ch in b]1c[b[if b != c $cMelse#al#inf2c11B,#~ == " "121category'GZs" and 3X?_c1[# 2,a < 128 Cc" c22_specials = set([1757, 1807, 6158, 82045!323, 65279] + list(range(8288,8292))|98,830465529,65533p119155,Q63)))FW2S_'Bif c-TFalse"82Tru7E>l:1_c:uQ or \5 u  W3q o47Xe0xFDD0# [x F C & 0xFFFF)( Eh 5Vscc6_set}4_6h P] c7Y12272,1228Y7YPY8Y![8{ 33!067|34,8239K%82 G8de) in c8_set c9_set = set([917505] + list(range(#36,917632))) def in_table_c9(code): return ordB in c* 8"d1" 80uniMdata.bidirectional,N("R","AL")R2&R== "L" __all__ = [Q# Fun|s'calcsize', 'packP_into $un r_from',>Riter_1', # Classe`fStructPExcep aerror':0] \1 _s4 import *_clearcache _doc__ # subprocess - S es with acible I/O streams # # For more informa about this module, see PEP 324.9Copyright (c) 2003-2005 by Peter Astrand F%Licensed to PSF under a Contributor Agreement. r"""& T allows youlcspawn 4es, connecttheir input/out@ pip+qobtain +9@s. Sa complete descri8 ofVUthe Python docu@. McSAPI = run(...): Runs fmand, waits for i,n1s a3 C#dP;instance. Popej0A c\flexibly executingTa newWA CoRDts - DEVNULL: Special value that indicatesos.devnull should be used PIPE:E a<created STDOUT: dstderrD go!Pstdou Olo= call*W. check_]Same as ) but raises CalleE|!()U#if T is not 0\^wd%e4tents of` G0eadaqI gete @_shellk6the6Ycbstatusi5pa (exit>", b) tuple """ builtinsTerrno i o!Dtime esignaly%hreading import warnings import contextlib from time monotonic as _6types try: 1fcntl except IaRError% = None __all__ = ["Popen", "PIPE`STDOUT AcallTheck_getstatusoutput",t "get1 "c9!rujCalledProcessf{DEVNULLPKSubp)TimeoutExpired;uCompletT("]# NOTE: We intentionally exclude list2cmdlinepZit isBconsidered anG@rnal}plementaU detail. issue10838.amsvcrt`q_winapi_mswindows = TrueModuleNotFound7 2QFalseI\eposixsGYselecors else`(CREATE_NEW_CONSOLE, PROCESS_GROUP")STD_INPUT_HANDE7OUT0 ,VERROR>oW_HIDEr ARTF_USESTDuUS, STHOWWINDOWEABOVE_NORMAL_PRIORITY_CLASS, BELOWMHIGHKLIDLECREALTIMI#O_  DETACHED_=DEFAULT_6MOD!BREAKAWAY_FROM_JOB) .extend(["Lf|h ;+"'eD g= -=f3Mc7eD oUPINFO#nRJBDHC < EY"]) # EC ion classes used by this m!.  (=): pass class CalledProcessError(Subp): """Raised when run() is cA with check=True and the JCreturns a non-zero exit status. %Attributesxr cmd, <code, stdouterr, output>1"""def __init__(selfBS7B=NonT1err :.{' =h%Pcmd = d( =4stderr =2err3strOout)ACk@if _mswindowCSTARTUPINFO: def __init__(self, *, dwFlags=0, hStdInput=None5Out/ 6SError6wShowWindowUlpAttributeLis[)):K.$ =#j& ='( )( '7 = + < = or {"handle_list": []} Kdef copy (Aattr51 = 4 ].9)LGif 'oU' in H /[6]Oist( )Greturn STARTUPINFO(= ,9 79:; :9;= =i") [qclass H:G(intclosed = False/ILCM!, B=_winapi.R>bif notib/} = Truea*bDetach `42inte raise Value("already "c__repr? 0i"%s(%d)" % q1.____.__name__, `__del__ =R else`# When$ect or poll has indicated that the file is writablez# we can"e up to _PIPE_BUF bytes without risk of blocking.4# POSIX defines =as >= 512(VP= get dect, '5 ',1#@/selAhaveadvantagerequiring any extradescriptor, contrarilye1/kqueue (also,b"y Re a singl# syscall) ifl0orsAollS7or' d_Popenectors.P3r:Oor if _mswgs'2On ysjust need to closeB `Popen._handle` when we no longer need # it, so that the kernel can free it.Qgets closFmplicitlynJ` instance is finalized (see `H.__del__`,Pwhich0calling `Cn.` as requested in [1])!erhsnothingOfor `_cleanup` to do.B. https://docs.microsoft.com/en-us/windows/desktop/ProcThread/Gcreating-processes_active = None Ddef 1():pass else# This lists holds V s 1vpunderly5 had notcP# exi7time its  method got }ed: those Nces areLwait()edsynchronously fromSa newobject i#!# <0ed,avoid zombiyM/[]K 4if -!is{TgareturnHR8<[:]31s =|._internal_poll(_deadstate=sys.maxsize)^b`if res?not$:trys.remove( ^%except ValueErrorLVhappen if tws qm# It's harmlessPit was alU"y doignoreL PIPE = -1 STDOUT 2 DEVNULL 3 # XXX#function_only used by multi1andtest suite, # but i5erein be impor9NBPythkcompiled without # tAs. optim_args_8preter_flagsA"""R! a of command-line argument`producbcurrenp1iza 0setsqA."""Q = []v66 = (K2if "6> 0WC.Dd('-' + 'O' *+h#s 6S,@warn@ons #_x$2_opt_map = {+'debug': 'd'# 'inspecti2ter  'dont_write_bytecode$BBq'no_sitSverbose': 'v'3, 'bytes_warning': 'b'Pquietq(# -O is handled in _optim_args_from_interpreter_flags()t}(/ =6@for FP, optp t_map.items():[v = getattr(sys..!s,B%if v > 07.append('-' +rQ* v) _5if R.isolatedC ?"I'oFelse$ Cgnore_environment)EQ Gno_user_sitj' #s'@# -WAionsaopts =1[:]" *'Z.,x onND, '_R', {}dev_mode = ('dev'(9if fF > 1*s.remove("error::BW"m,elKGdefaultI4if B'B< W|I# -XC0extq('-X', Q)!('r(tracemallocimporttimeQ'showrefcount.Wutf8' ifA@valuB[optf%kis Tru"Parg =gr l,'%s=%s' % (opt, %BCarg)preturn % def call(*popen , 2out=None, **kw"""Run command withMus. Wait " to-plete oras, then 3the cIbibute.6Theh@ are= same asqAP constructor. Example:H1ret`=["ls", "-l"]G1"""P wp6try risp.wait(=k'except: # Including KeyboardI ruFQthat.Ccp.kill# We don't q) again.__exit__ does YM*us`Traise1]heck_7))Q. If code was zero th(en return, otherwise raise CalledProcessError. The object will have thEa code intattribute. s^arguments arH same as forA call function. Example:D`check_$(["ls", "-l"])a1"""1ret!= )*popenargs, **kw 1 if,:9bcmd = &`.get("0"1!0if $vis None9%= p5[0]X{^(,VfW0 def xoutput(timeout=r"""Run command with  ndurn its ^!IfBexitwas non-zero itG?s aFCcJFJJ +#mP construct q:>>>w, "/dev/nulbb'crw-r 1 root1, 3 Oct 18 2007 <2\n'estdout i{t allowed* itused internally.)To capture standard e.result, us"derr=STDOUT7q/bin/shk1c",h0...`"ls -l&_existent_file ; H?0"];'st^b'ls:L: No such Zpor direyC re pan addiFSal op , "input",[ing you to0pas0str!toBsubp1p's stdi!If8Q0thiGR`may no!soxMthe yA's "S"A, asFbit too beD  $1sedes/foo/bar/t=b"when;course of fooman ev#\n/b'.8bar.qBy defaPunicain bytes,efore anyshould be/WUvalue<SQ. Ifext mode[ W"a Z' ded accordClocale enco, or by "" if set. TMis triggered1@settSof text,Ving, errors or universal_newlines. """if 'stdout' in kwargs:'raise ValueError(-! argument not allowed, it will be overridden.') Ql9inpkC andv"['] is None# Explicitly passing .=) was previously equival%to0!an# empty string. Thatvmaintained here for bacds compatibilityGM#ifn.get('rY') or$ftext')GE= ''7els%b&&gs>!= Ktreturn run(*popen", =PIPE, timeout=, check=True,~R **o").C class CompletedProcess(objectb"""A p tnhas finishedn@ThisPed by"2(). Attribute: The listn0strsTed toC\Bcode8Pexit t of the, negativ csignalD GBstandard output (!if"captured)7kstderr:ec9 def __init__(self,&,  1err/ ;.>! =AM' =Z %# =  2err2errCrepr [' ={!r}'.format)& '5%)]1if !is- t.appendcF/))__/_ "{}({})"$Atype)).__name__, ', '.join()!___getitem__ = pmethod(Ks.GenericAlias) #_7u:A"""R<ECallD" ibstn-zero.ga b.6, HV '0err Pe#, _f=Falsemij\C unvm%@withws8( a}ocess instan*ce. The returned instance will have attributes args,-code, stdout andLstderr. By default#.err are not captured,@X thosnQbe None. PassEout=PIPE80/or2errin order toaS themIf check is TrueC ` exit  was non-zero, it raisCalledProcessError.Cw objectKtkjP!inqoutput &#if6qstreamsQDwered@timeis given]p takes too long, a T4bExpireexception"bei Th~qis an o( al7ument "input", allowing you top byhor a str"!to 3sub'qin. IfA`use thu!rgiP[1mayjRalso 'e Popen constructor's "stdin"2, aNi be@!ternally[all communica%ais in qPreforyyb shoula+be/0and AX.FQext m1anyp_5 beW Z}@s decaccordlocale enco, or by "" if set. T" iStriggered1@settSany of text,Veas]universal_newlines@otheXe same as forF .(!""1if v:)Pif kwa.get('2/'),07a Value(3rga$s @bothuused.')|y[u@] = $if_, :out\^:err$Q A'L ['with  I) v\0(*pB, **6)+f6try g6#= 3.!e(#, v=H b:exco^Vkill(Aif _mswindows62# W accumulates the out put in a single blocking # read() call run on child ths, with the timeoutEbeing donew`join()LTthoseL. communicate()J%_after_ kill() is required to collect that and add i!toexception.lexc.stdout, err = process.]else:Q# POSIX _90 alFy populat`he out/soEcfar inTs1ExpKwaitZUraisejD: # IncludKeyboardInterrupt,a handl*atJweg@# We"'t^+ as .__exit__ doesjfor use wretcode po-}if check". Q CalledPcError(.,Uargs,Z=T`stderr2errreturn Complet{(m J ) def list2cmdline(seq)1"""PTransjequence of arguments]aCH:string, u5>same rules@MS C' !: 7E1) A\are delimiby white space, cheither aA" or a tab.YR2) A surrounded by double quota marks isPi prd, regardlessCcontainedain. Ar$edcan be embedrn@k3` prece@by a backslas(L literal rD4) BLr3terCaly, unEtheyrmmediately/ ao V5) IfOes iDbevery pair NSas a / . _numbeLAodd,5las@Aa escapoe next% ardescribed3" 3B# Se# http://msdn.microsoftq /en-us/library/17w5ykft.aspxFor searchFcrosoft.com for # "Parsing C++ Command-Line Arguments"+result = []needquote = Falsefor arg in map(os.fsdecode, seq):&{bbs_bufP# Add a space to separate thisZ from the others@Aif rhl.append(' ') 3@(" "arg) or ("\t0not=5if @s "s%ch 6if c == '\\'# Don't know if we~(double yet.3j)c)!%elt"sZbackslashesb `\\' * len({:)*2u P?!Oelse Normal cha42if 9't0ext$**ch`remainpQ,6anyY[#qXreturn ''.join(') # Various tools `executcJs and look atir outputstatus. # def get#C(cmd4B"""RR(exitS&W) of |!md]r shell.EHPe strW'cmd'* with 'check_Z'a 2-tuple (,). The locale encoddqis usedC2to 7` process newlina0pA trailG1 isGppedN= ( can be interpretQaccor!toBrule> function 'wait'. Example:\>>> import sub.'ls /bin/ls'lZ(0, 'D 2catEDjunkG1, 'cat:: No such filedirectory5i  ey27, 'shf#_foundVskill $$3s(-15, '"""6tryxdata = ,,=True, text stderr=STDOUT)  exitcode = 0 except CalledProcessError as ex:%)data = ex.outputSex.returnc!0if 9[-1:] == '\n'T"A:-1]3B W,A def get}R(cmd)HA"""Rt " (stdout or stderr) of executing cmd in a shell. u@Like_bstatusJC(), 1the  is ignored and MPvalue$Qa strt`ontain ,command's. Example:>>> import subp\.'ls /bin/ls')+'1""" QB[1] i_use_posix_spawn(mCheck if  can be used f{b requires aEi mentation that properly reseAs to{Qparen*, & sets errno He followfailuresk#*  attribute ac s +1ed.s_* Fil^%()01Prefer an&leQwhich1use vfork()some casesC2besfperformanceif _mswindowspnot hasg(os, ''W# os. s >available,1RFalseif sys.plat('darwin', 'sunos5o laC@callboth macOSOSolaris,# "or3Tru"# libc nameGruntime qversionj2trySMPver =& confstr('CS_GNU_LIBC_VERSIONi0# parse 'gXP2.28'C(', (2, 28)3parts = ver.split(max &=1&qif len(-f) != 2F# reject unknown;"ma9 praise V=Bts[0 = tuple(map(int,*#1]b'.')))8 alinux'{o=%k">="4S%# R4 a new LV? f us^PNTw?i# Note: Don't in earlier@becait doesn'#E` (event P6 add~P pipe errors , # to the parent process). except (AttributeError, Valu !OS!):26# os.confstr() or CS_GNU_LIBC_VERSION vD not availableBQpass # By default, assume that posix_spawn() doesMproperly report esreturn False _USE_POSIX_SPAWN = _use_Z class Popen""" Execute a child9gram in a newJ.0For+omplete description ofarguments see Python doca.OA- args: A string,ua sequencec1progJ bufsize: supplied asPbuffeO^- p() funcQ when creatingFstdin/stdouterr pipe file objectqV preplaceOBto e{b", c@ and err: These specify<s' standardPinputRs output[Yhandles, reletively0preva_fn: (o only) AnWbe calledBWFjust befor&($isdyclose_fds: Controls or inheri"of5orsFshell: If true,F@commhuwill be{ through%9Gcwd: Set[1curodirectoryenv: DefineHqenviron"@vari:Qs forg text`decode1 ind us.given encodingq(if set)dsystem otherwise universal_newlp: Alias,Qvidedbackwards compatibilitastartupinfoonflags (Windowsu tore_signals$XP_sess&_group@aextra_ aOuser:_umasks: Text m Po useo##s 3^err, pid+}q1"""__Bed =0 #< here si__del__ checks itdef __init__(self,$s,=-1, executable=None, Rstdinv stdout 2err 7preexec_f<close_fds=Truihell=False, cwdZC env universal_newlines}startupinfo# creationflags=0restore_signal Jp_sessiontApass(), *, usec groupaextra_encoding3Crror-D texumask=-1, pipesize=-1):@"""C e new Popen instance.""")_cleanup()# Held while anything is call waitpid before reture has beenL updated to prevent clobberK<0if Y() or poll() areKed from multiple threads at o After acquidthe lock # code must re-check self.to see if anotherkW justfinished aQpid()+.%[_@pid_# =Ning.Lock() /input =  communic_Qed = A,`if bufG = -1 # Rv defaulif not isA(:W, intuUraise TypeE#(",mbQ6Weger"%if ;-_mswindowsW=~-DValu.;:`supporBBon Wq G"platforms"Jelseu# POSIX5LA and ?/warnings. $(" p overri.", RuntimeW7Lk0 = 0 %_ ;_only a:*ifs^ != 07* 7Dargs = args  self.stdin = None ?out?err?pidreturncodeeding = `errors ppipesiz[  "+# Validate the combinations of text and universal_newlinesCAif ((ais not-4 #@Tc^bool(hQ) != e9)):9raise SubprocessEP('Candisambiguwhen both'H' are supplied but Mdifferent. Pass one orxother.')BInpu}0out objects. The general principle\6likf# this/#@# Pag Child)-))p2cwrite ---9---> p2creaT0c2pU<+out--- c2pDW:err,1err,;err,6On POSIX,]c >file descriptors. On@qWindows?!se3 ;`handle7pMaG'0k# oplatformF1-1  us CPIPE '-19redirecting.i(,S,=, $, 2) =7S_get_$( , stdout9errWe wrap OS 5 *before* launch!, .wa# quickly term2ng could make our fds unsHpabl1(see #8458)"rif _mswP%if6*-1#= msvcrt.open_osf[.Detach(), 0)C ifeSd c cc c5"_m p/oroK# PEP 597: WAressE)@Warn4Ein sY modu for now (at Python 3.10), because we focus on files for now. # This will be changed to encoding = io.text_( )Hin the futurearif selfAmode and]is None:I1d& =.= "locale" 1# How longresume waiton a child aftervirst ^Cere is no right valu@4is. The purpos) to1gpoliteyet remain goodrinteractive users trygxit a tool_sigint__secs = 0.25 # 1/xkcd221.getRandomNumber()Fqclosed__pipe_fdKVFalse-  if bufsize == 1line_bufferV= Tru"Q# UsepdefaultVAfer ZDaunderl"binary streamshLa# sincRy don't support ^6ing\79 -1X;els/O @Qgid =Mif groupWt 9if not hasattr(os, 'setregid'),praise VpError("'f' parame  edY"N"current platform"R2elif isinstance(},>tryF!im=grpexcept I"C  0canc@be a"on system Qthoutgrp module60grpRgrnam").gr_gidL?intLZ*ou4ATypeC1("G@must `or an Ager,/{}".cat(typ+)))nid < 0"f"6ID @nega5, got {gid}s!gi@Vif extra_s{7|nJ# "extra_groups, {str): )raise ValueError("Groups must be a list, not a string") Igids = []for extra_gS8 insif isinstance(;,x>tryJimport grpexcept I&K)\Items@ can+Obe "tx "Xs on sysYwithout thKgrp modulew.append(grp.getgrnams).gr_gid)/el?intu`/se4TypV"or integer/{}.format(typ+))'# make sure tha are all positive here so weQ do less# checking&iC code%Agid_+(o^6if &>< 0"<,f-0 ID@negau, got {X}uid = Nonif user isl !ifhasattr(os, 'setreuid'v `"The 'e' parametp0sup, ed"rcurrent plat2 ,|9pwd`  :/ "6pwd0pwd pwz).pw_uiHmXK //elWSU BTor an ?id 7` 3b2 9uid, if p2cwrite != -1(eself.stdin = io.ope n(p2cwrite, 'wb', bufsize) if self.text_mode:#2$ stdin = io.TextIOWrapper(!, w_through=True,RVline_buffering=; Pencod5 , errors= if c2pread != -12outSopen(5O, 'rJ9eK?outtry!f.p(@ OSE> # Ignore EBADF or other). bif not_|dA_pipk"to*Y = []NHn= PIPE@&D.8 ndO$PQxQQbhasatt, '_devnull';5a}d~6TV  if _mswindows and isinstance(fd, Handle): 3 fd.Close()'OelseE Aos.cE/fdGexcept OSErrorMYpass Rraisedef __repr__(self1objI = (@@f"<{,.__class__.__name__}: ",returncode: 7d} args F!r}>Btif len(j) > 804 = [:76] + "...W& getitem__ = method(types.GenericAlias)9@propertyRuniversal_newlines\.# $ as retained @an ag of text_mode for APIl| # compatibility. bpo-31756#Iq.setter>,= m = bool(nDi_translate7, data, eE`ing, esn!! =(0.del(.24.replace("\r\n", "\n")/__ente0X .3xit]`, exc_I, value, traceback0if Ez.stdout  $+er 8try: # Flushing a BufferedWriter may 62 an~NR*in|-in{zfinally4%if( == KeyboardIw;rupb# https://bugs.python.org/issue259425In the caseeak we assume*oSIGINTJ!was also already sent to our child processes. Wu?n'tJblock indefinitely  that is not user friendly.C IfAhave0@waitZ brief amounttime inJDan iv@ed .C() or .communicate() call, do so hereLconsistencF_sigint_m_secs >  kwF(Bout=sigint_wait_secs?) except TimeoutExpired:+>Mpass,self._sigint_wait_secs = 0 # Note that this has been done.L`return8Presum:e KeyboardInterrupt 8# Wait for the process to terminate,avoid zombies{"()\def __del__(, _maxsize=sys. , _warn=Pings. )?pif not A._child_creatc# We didn't get0sucbfully 51 a D :"ifwcode is None reading sub?exit status3s a>e whichtPis only destroyed e parent pythonCh BS'(" %sstill running" %Ipid,? ResourceWar/", = # In casg]0hased on, check if it'sU0._inal_poll(_dead?$e=:x and _activ?CM , keep us alAuntil we can j on it9nq.appendget_devnull@qhasattr4, '.' &K = os.open(os.,fO_RDWR,[stdin_writeWinput|:tryR.RL `2BrokenPipeErrorL+ communicate() must ignore bCp pipe eE j!OSb~ as exci if.errno ==Kno.EINVAL.# bpo-19612, 30418: On Windows, n) failLRwith o JJFr UJ#9is  but closed/ip?Dy ];els+RraiseQ (  'b  :  Qpass Yelse:araise def communicate(self, input=None, timeo)L+"""Interact with process: Send data to stdin and close it.x3Rea)@from+1out, stderr, until end-of-file ireached. Wait foryterminate.qThe optional "" argument should be@be seto theTchildlR, or *Rif no=LA 9x ) returns a tuple (stdout,Gerr)By default, allion is in bytes,Ntherefore any 3 P will( Ifptext mode (indMPd by Q._)y||be a string(d%s decodedBaccordinglocale encoDby "" if set. TIis triggere ttWpany of ,Zerrors orAuniversal_newlines26"""Flf._ion_started{p ValueE|("Cannotdq after I `&")# Optimiza: If we are QPworrib s,#uhaven't#m(ed0we 0@ one3zero pip usselect()Oor threads@unnec6aryLCif ($4|XiQ[-,Belf.].count(fg) >= 2F4! = `A| S_q_write('%'elF?outGN( =.[qJ Aout. $ n?errn7errn?errn #n8wai$if0end/@ = _D() +9 b>^C>tryoMq xcept Keyboard{rupt:  # https://bugs.python.org/issue25942 . # See the detailed comment in .wait().7if timeout is not None:(ftsigint_0= min(self._fo_secs,AE Aremaining_@(endg-))H?elsZ R'p = 0 #Phing x should K?try8#5(Cout=rxcept TExpired^MpassPraiseRresumKeyboardInterrupt 7ofinall M unication_started = TrueIasts = 6  return (stdout, stderr) fdef polly)#"""Check if child process has terminated. Set and hEcodeattribute.""") _iEAnal__ $,  onvenience for _e`e when0put+s$ifY&2 -  c\1out|R, oritout_seq sRskip__Aand_k=False -3Eif ae/* ?if  D() >{ Mz (XIKargsA-output=b''.jowY),N I0err:II l AWait &to;s f=$ +J p|_h=e > # The first keyboard interrupt waits briefly for the child to # exit unde&ommon assumption that it also receivedR+^CL generated SIGINT and willfrapidly.6if timeout is not None:$tsigint_,= min(self._m_secs,=A =remaining[@(endc)))D?elsR J#p = 0 #Phing pq should 3?try  (Cout= rxcept T{~ExpiredVIpassPraisearesumeKeyboardI 3def _close_pipe_fdsp2cread, p2cwrite+2c2p+?c2p+ 2err+1err+)"# tdevnullalways defined~'_fd = getattr3 '_!',)vwith contextlib.ExitStack() as s 2if _mswindows+n != -1"&X`.callbl2 .C .4if KU3VvV3V if4gzF %/_f ?1os.DC5&EAb!-1 &j=6if SVhA]# Prevent a double 0 ofse handles/fds from __init__ on errorA!d_!r = True#2# Wv method5$Cget_9stdin, stdout7err_"""Constructreturn tuple with IO objects: p2cread, p2cwrite, c2p3c2p2err1err D9"""if stdin is None and, 0a=3 = N.SClose1_+%el#== PIPE# @'), DEVNULL = msvcrt.get_osfh`self._devnull()gisinstance(&o, int)mb _.seH# Assuming file-like  d/t.F,no;make_inheritable(! C?OUTD Np_*wFdG jH*I\@IIJ>jK ?outLoZtdout/elN-vP=Q"Rerr is None:  errwrite = _winapi.GetStdHandle(STD_ERROR_HANDLE) IE if Mis None:%5&_,)vCreatePipe(;>, 0c>d#= 0SClose2_+elif stderr == PIPEerrread&@/), oSTDOUT1c2p  GDEVNULLH msvcrt.get_osfh`self._devnull()Wisinstance(bo, int)o  bsd # Assuming file-like object  Nv.H-no< make_inheritable( zreturn (p2cT1p2c,'2c2p''G5) P]def _",  B"""Ra duplicate of., which is 5"""rhWDE )-GetCurrentProcess()5 O0, 13DUPLICATE_SAME_ACCESSahQrfilter_Ah_list(SXF6 out consoleUs that can't be used'in lpAttributeList["}p"] and  sure the Es_ empty. This also removesZ,s.C# An with it's lowest two bits set migha special #Nif passed k, willLcause it to fail. "({D fori :i  & 0x3 !=0(or`FileType(O) !=;% ;FILE_TYPE_CHAR}execute_childargs, executab le, preexec_fn, close_fds, Apass% cwd, env/ startupinfo, creationflags, shell> p23d, p2cwrite. c2pread, c2p.2err.?err.unused_restore_signal* 3Vgid, s ?uid 4_umask)k_new_session):"""Execute program (MS Windows ver5I""" 8assert not " supported onQ.Gif isinstance(ar+try[ /el=_bytes?"ifZ Yraise TypeError('G 1 isYallow)')H1= list2cmdline([],os.PathLike/path-likemwhen ' 'Otrue*.se 3)p0if `utablez?NonR(= os.fsdecode( ]# Process /up details!CD = STARTUPINFO(# bpo-34044: CopyB since it~modified abov # so the caller can reus@multiple times. k.copy(Ause_std_handles = -16Ein ( ^ ;if I/0dwF4 |= _winapi.nF_USESTDHANDLES .hStdInput =P02Out12V% = attribute_9$ =BD.lpAIListkChavet;[bool(Q9and7 "handle_list" in attributo and  7U["hanW9]) D# If we were given an 2 or need to create oneDif have_6(use_stds close_fds):D,if~is None+/  = startupinfo.lpA=List = {}q=| 7M = \@(Y.get(v[, [])z=;if %+= [int(p2@d), c2pwrite2err]uM0[:]8elf._filter(*!fif not&warnings. /("'['wO'] "T "overriding", RuntimeWG# When us>9the#we always request-inherit#?`s but OEonlythat will be HZed arx#B es5N! = False&if shelldwFlags |= _winapi.STARTF_USESHOWWINDOWDwShowWindow GmW_HIDE:comspec = os.environmCOMSPEC", "cmd.exe")? args = '{} /c "{}"'.format ([ , % if cwd is!fsdecode(cwdHsys.audit("subprocess.Popen", executable,u[, envG0# SE >tryhp, ht, pid, tidnCP( \oP# no ial security?Y,,5 b)=APtionf8?env.?cwd. startupinfo) finally: ## Child is launched. Close the parent's copy of thOpipeKhandles that onlyDca should have open. You needJto make sureat no _oXwrite endpoutput  are maintained in this process or elBwill not c 0wheD"e Iexits andKReadFile O]hang.&aself._g_{_fds(p2cread, p2c,8 2c2p8?c2p82err81err8)) q@# ReMGD, bu'G thJ E#_ted = Tru']A = Hi:(hp& piB*piW_winapi.?tdef _internal_poll(O, _deadstate=Noneu_WaitForSingleObject=pBAIT_OBJECT_0<6GetExitCodeP;)"""Check ifhas terminat urns returncodattribute.T^Qmetho^ called by __del__, so it can,refer to oCs(0in Wlocal scopo:"""1 f . /?if "._v, 0) == _WLP y>= _ ^   `AwaitE, timeoutI implementation2?) on Windows.CY;!_millis = INFINITEb3 DCint(z * 1000 iP# API%e:immediatelyk>= 0gresult1  A4if mnapi.WAIT_TIMEOUT: raise TimeoutExpired(self.args, t)=$returncode = _winapi.GetExitCodeProcessQz_handleKB N% pdef _readerthM, fh, buffer).append(fh.5)wfh.close()kcommunicatejinput, end p, orig_ ;out|# Start s2er s feeding into a list hangoff of this # object, unless they've al^y been so9ed.;"ifPstdout and norSsattr""__0"%Y = []i'KM = \'+#Ring.Trtarget=n,DH =., @t1_.daemon = True1(]?err ?err% &m7errc#1 *inin_write()u&# Wait foe out. If we, # aremainO the fds left open in caseG[ userLgcalls o again !isONone BjoinS_"in( x4outTis_alive(ei p pi<,J; # Collect output fromX both pipes, now that we know  # both have been read successfully. ,stdout = None?errif self.<:6 T&_'^_buff+H.close()$k?errkk?errk 5errk l$# All data exchanged. Translate lists into stringsL@[0] bOelseefstderr33 return (f", ;%) % dend_signal(j, sig)A"""Send anal to the pro.E."""Tt# Don't.a) that we know has alwjy died$code is not t( CSig ==.SIGTERM=.terminat[-elICTRL_C_EVENTNbos.kilOA.pidSHnal.7 d_BREAKh#; l.seraise ValueError("UnsupportedA: {}".format(' LBQETbs?O Be>try*_winapi.P?._handle, 1vpxcept PQssionf^ # ERROR_ACCESS_DENIED (wine0 5)received whenM #ud(Trc = GetExitCode >0if ABSTILL_ACTIVE3i 1.F= rcO5 = d#T# POSIX methods C_gets!!in1out>errConstruct and  tuple with IO objects0p2c, p2cwrite, c2p3c2p2err1errD k T = -1, -17 c2pread, c2pwrite = -1, -1 errread, err' (if stdin is None:QIpass%el5== PIPE5"2c4p2cos.pipe()NcP1elfsize > 0 and hasattr(fcntl, "F_SETr^_SZ")wM,.(~!, .@8, st ~DEVNULLpp" =L_get_devnullQisinstance(u_, intW 0?els # Assuming file-like object>! ^.1Yno() *_tdout 62c2p`~&a#?outY  / `" ?err" 6"e"`:"&nSTDOUT=5if k!#% =/ $ # child'sis not set, use parent GK0qsys.__sd&__'3stdw+?errY / ` jpreturn s| '8 ,' te) 4 def _posix_spawn(self, args, executable, env, restore_signals, p2cread, p2cwrite,2c2p,?c2p, 2err,1err,8): A"""Ee program using os.Y).""": if is NoneVbPenv =Genviron > kw3Y = {},if5Z# See _Py_R`S_ () in Python/pylifecycle.ccsigset = []Afor  meP('SIGPIPE', 5XFZ ;SZ'P]Aum = getattr(4al,Z,6)}<!if& um]1not++q.appendh.umYq['setsigdef'] =h:setfile_actions"!fd oif fd != -1w (os.POSIX_SPAWN_CLOSE, fd)2 W(`.0)Z(I/ 1<;, 2E@DUP22JNR B.pid"**f Gp_child_ teROTrueo_close_pipe_fdsX  y4$, )e0pre)R_fn, >fds\@passR, cwdH startupinfo, N`ionflaj_shellm Q H B ` gid,@s, u _umask^ &_new_session(SA ver0  if isinstance(args, (str, bytes)): args = []elif isinstance(", os.PathLikeNif shellhw raise TypeError('path-like ] is not allowed when 'F'vAmtrue')5`.se0Alist)) S # On Android the defaultat '/system/bin/sh'.]Runix_<= (0= if26hasattr(sys, 'getaapilevel') else '/, "-c"] + ~if executablOSW[0] =* VE+?NonM$=:[0]Isys.audit("subprocess.Popen",,?, cwd, env(_USE_POSIX_SPAWN nd.dirname(_40pre'4_fn_close_fds& Opass% ?cwdo(p2cread == -1 or ?> 2(c2pwrite89 ;err99 start_new_session /giOgids uIumask < 0)self._posApawnf env, restore_signals,P,T50c2p$, 52err5jreturnPorig_/ # For transferring possible failure from child to parentV # Data format: "exception :hex errno:descri"n# Picklewused; it complex and involves memory cak errpipe_C! =PJipe(S#(Amust5Qbe inqdard io 0, 1, or 2 fd range. low_fds_to_close = []" while errpipe_write < 3:%R K.append(;)7  = os.dup6 Bfor m3 in 1os.(5 >try2 # We must avoid complex work that could involveDmalloc or freethe child process tocCpotential deadlocks, thus we do all this her# and pass itpfork_exec() wif env is not None;Zenv_listQ@k, venv.items()W9k&fsencode(k#pif b'='ckY 6 raise ValueError("illegalironment variable name"  2k ++/v)G?elsg # Use Ustead of -!ut ifpath.dir (3l%#8,l 0# Tmatches Obehavior1os.Zvpe()otuple( 51os.join(os.>Qdir),y]G 0diraos.get_[?(enkeep = set(n0?.adself.pid = _posixsub.2# Hargs ,3 ", sorted(map(int, ?)))M 0wd,xp2cread, p2cR, c2p2c2p 2err/?err/Y49restore_signals, start_new_session,  gid, gids, u }umask, (preexec_fn)( self._child_created = True/finally:o# be sure the FD is closed no matter what>1os.-(errpipe_write) -Y_)`fds(p2ad, p2c9 c2pread, c2p82err81err8# Wait for  to fail or succeed; possibly raising an# exception (limi~in size?data = bytearray(+Qwhilepart = os. ~, 50000TV 0+= H )aif not 5lene2) >gBYbreak\'  8if /tr7p2stsjwaitpid(eif pid == +t""_handle_exitstatus(sts?lseO returncode = sys.max } C`ProcessError`Npass=]ion_name, hex_errno,_msg = (.split(b':', 2)p# The ehere should!ch{ # 4ten in by1Bsubp implementasClike _posix<,3err  0.dePo Value'wg%'S8'30%w = 'Bada from : {!r}'.format  sc\_0typgetattrgbuiltins,m'ascii')CcessError)  -if issubclass(child_exception_type, OSError) and hex_errno: J_num = int(/_, 16)3uec_never_called = (err_msg == "noexec"D?if G]? ""%p# The e must be from chdir(cwd).=bfilename = cwd+Oelse EPorig_ outableQ if!noO!= 0^ bq os.strx>nUraiseq-:, QM B5) def _handle_exitstatus(self, sts,*$wa51_toCcode=os.Q_WIFSTOPPEDF:81SIG8 )q"""All rs to this func MUST hold  ._pid_lock."is method isWd (indirectly) by __del__, so it cannotYp# referanything outside of its local scope"7if 4K(sts`returnc = -_W#3 BD2PQcinternal_poll_P_dead?e=None, n[>pidr_WNOHAN , _ECHILD=/. """Check  process has terminated. R(&s 0Lattribute.HTJ Tence  f8theP (norF9~sYKlls) "if *bif not0 acquire(Falsej:@# SoRhAbusy'. Don't allow two K# at once. We know,:yet1 U>try5# H:  return self. code # Another thread waited. < pid, sts = _(Apid(R_WNOHANG)<if pid ==Opid:(mT_handle_exitstatus(sts]except OSError as eZif _deadMe is not Non//=Belif e.errno_ECHILDb # This happens if SIGCLDset to be ignored orvIing for child processe`!s wise beenIdisabledJ4ourH". ]0is NO, weLpcan't g0he {/us]http://bugs.python.org/issue15756l5 0,finallyA_lock.release(ve L% odef _tryM",Xz_flags)"""All callerstfunction MUST holdqT2pid5"""vA/tr(=` = os.)  O\CNPMf y9ingoI J ~=pidh m z r~timeoutInternal implementa!of>() on POSIX."ifQ( 43if L 0end(%D() +9 <0# E a busy loopwe have a9&?wasNPcribbrom Lib/ing.py in T() at r71065delay = 0.0005 # 500 us -> initial #nof 1 mwhile Tru` acquire(False if self.returncode is not None:  break # Another thread waited.@ (pid, sts) = P_try_;(os.WNOHANG)D assert pid =E $or0? $if(?pid*_handle_exitstatus(m K0&finally &pid_lock.release(,remainingg_time(end>5if /_ <= 0raise TimeoutExpired(`args, e?outhdelay = min( F* 2,|_, .05;Xb.sleep: &?elsRwhilev Bwith2~"if/ a])Y U 0# Check theand loop asUhas been known to"# 0 even :Cout  in odd situations)# http://bugs.python.org/issue14396=0 ;% def _communicate, input, qa, orig I=`stdin 9rYion_starte# Flush Co buffer. This might b?A, ifuser has@writG@to .Tnan uncontrolled fashion/trP .fexcept BrokenPipeError1@pass9~) must ignoreG!ife?cloW 0std= None  stderr = None "# Only create this mapping if we haven't already.>if not self._communication_started:0y-fileobj2output = {}*"ifZnstdoutJN[c6o] = [][ ?err[ 3err[ \ " =_ WW /save_input()%#,4_view = memory (] R with _PopenSelector() ase qin and Y)G.registerestdin,es.EVENT_WRITE)pEs_.clos?s>outOREAD  ?err$?err Uwhile6.get_map()|Qtimeoremaining_@(end40if ?!isZ?< 0x@rQcheckn4outqR, ori ?,G,<Bkip_and_raise=True$@ RunError( # Impossible :=A'q@o..., s/ ' 'failed to TExpired.'/(?err# XXX Rewri0eseuse non-blockI/O on the # objects;(@y arE longer usHC:io!Bfor key, events in & if1.Qobj i#!f.6 chunk = input_view[self._ioffset : D+ _PIPE_BUF]O ?trypa = os.write(key.fd, chunk)o except BrokenPipeErrorector.unregisterwoileobju N-.close(4 Oelse?if w>= len()K?sel+EWelif 1B in rstdout,ostderr Qdata Breadd, 32768l pif not A($. f<2output[E].append()) <wait(timeout=_remaining_@(end)>Q# All exchanged. Translate lists into strings.1 isc?Non = b''.join( M?errM$ M> #newlines, if requested# This also turns byte ]text_mod?out V" =$_t_4,:e.encodingL2`s + ?err-?err6L  re>  &) def _save!,  `methodCcalled from the _communicate_with_*() metghods # so that if we time out while communicating,!can continueJending inpuPiretry.)if self.stdin and_7ys None:34%_offset = 0' " = $"ifq is notqtext_mod ( =.encode(: JJrrors) J deHnd_signalwj, sig)<"""Send aPnal te process."""T# bpo-38630: Pollreduces the risk o} Y MTwrongmeC|_qpleted,ZPopen.returK KattributeQstill,Wid has been reas+edG(recycled) a new different. This racndition canMhappens in two cases#2`Case 1`read A calls `poll()B B+&se). In th5A, waitpid() succeed#Y 9exit status|0 ki because o 1didUr yet. CaO EB prevent `thanks ___lock|%2. vpid, 0)5ed directly, without us@ metV': 6is tM L.w @to a default value,Usinceq) fails" PpLookupEK i} U 3 h<CSkipi9aQeqwe knowq aljy diedKs0# T md 6 # describRbove ;: tw=try!1os.1q~ oexceptN# Supres e; bpo-40550.  dpass def terminate(self):%D"""T the process with SIGTERM2 U.send_signal(.<)OkillOKillIKILLs9"""<") """Stuff to parse Sun and NeXT audio files. An consists of a header followed bydata. The structure of3Sis as9f}*+-+| magic word*|4 osize 4 24encoding4sample rat#ychannelsBinfo|R (4 characters '.snd'. Apart from field, all?s are 4 bytes inEyall 32-bit unUed integr big-endianL order. really gives0 st.4 " i(physical03 F other parame%`numberf0s ce calculatedsM0waySwhich?82?Possible value@listBelowa currentlypn ASCIIa human-readafdescription> mis paddedP1NULs<. Usage. Rea[Zsf = sunau.open(, 'r') where ei@namea`or an > poWr*  must have methods (), seekIclose(). Whenvsetpos()hrewind()Dnot used,0N e0 ne1aryi}Pturnssinstanc4cla[dpubliczJDgetnZ() -- re]'u (1 forM pmono, 2' stereo)/0get[widthr1le 9B;9- returns sampling frequency getnframes() -- returns number of audio ':comptype;:ression  ('NONE' or 'ULAW')G=namGhuman-readable verR%of= |Dnot ed' matches Sparam  a dtuple consistQ ll$?the above in the Uorder4getmarker~}None (foratibility withPD aifc modulel1(idaises an error since] * does notk _exist  [ (nat most n|harewind1 tocbeginn|estreamGsetpos(pos GDseekEspecified position:Ftell:@~~current7Bclosq6Pinsta(make it unusU) TheNced by 1andD` given@) ar mpI0le 2@haveh)Uto do]v actualua file. () method is called automati@y whhe class  is destroyed. WriZ f%s:nf = sunau.open(, 'w') where/aeither 8 or>rpointer a must s write(),q , )Cand s. ThisVp follow|cpublicKsetnchannels'b-- set!/setsampwidth61le 0Krate0 .;8s4(,X8 Uv B C)wAall eters at oncs aoutputvxM#raw(data  0 qout pat up  file header writeframes(data)"1-- -r audio 4 and patch up the etclose()J? --4Q0N outputp You should set:0 paters beforeRfirstqraw or . The total number ofdoes not need to bes, but when it iscorrect value, M0havr2 beed up. IK@bestL7all, perhaps possiblyd compression type,[t [using0. W.n Abeen*ten, either c&X+P(b'')Z () (sizes in . y1`methodL\ed automatiyl_0lasI8stance is destroyed. """ from collections import namedtuple _sunau_p77s =)('/', 'nchannels sampwidth<brate n  a') # AUDIO_FILE_MAGIC = 0x2e736e64ENCODING_MULAW_8 = 1 aLINEAR!2! o16 = 3" _24 = eo32 = 5DFLOAT = 6DOUBLE = 7ADPCM_G721 = 2$2$03_3J&5&Aw/27 UNKNOWN_SIZ30xF:# ((unsigned)(~0))imple_encoding['E 283/164/244/324A] c3Error(Excep!):pass def _read_u32(xq)Pfor isrange(4!abyte =.E&(1W!if?#q1raise EOFcqx*256 + ord(9Nreturn x}file, x):  data = [] for i in range(4):d, m = divmod(x, 256)ata.insert(0, int(m)x:-file.write(bytes()) class Au_read: -def __init__(self, fif type(f) == ''' import builtinsW5f =.open(f, 'rb''y ._ ed = TrueGFelse$.FFals/KXfp(f)3del1if 2_6giclose(H^enterJareturnNv'ex[W*args~{ c , 2! =(/._soundpos = 0qmagic =4Q_u32(Z2if (!= AUDIO_FILE_MAGICraise Error('bad8gnumberhdr_size 1O< 24zqheader \too small_> 100Rridiculously large[X W{-`UNKNOWN_SIZE` encodingi10not_simple_s $ <(yet) sup 'ed)0Gin (_ENCODING_MULAW_8,:/A.+sampwidth = 2O Qframe65= 1 .el= LINEAR_8]o)/16p |=3O(/324p & unknown ?rat/nchannelh )) i f not self._nchannels: raise Error('bad # of ,%')-Fframesize =X*j<#ifAhdr_>J> 24`info = file.read(8F- 24!8e, _, _.partition(b'\0Oelse5b''?try*data_posVtell(except (AttributedA, OS )S QNone def getfp 8creturnZ2 07 & <sampwidth< & <Orate< & <ns:?s@== AUDIO_UNKNOWN_SIZES'V;Xencoding in _simple_ 0u$//!f0r# XXX--must do some arithmetic her}comptypXFILE_ENCODING_MULAW_8&'/elVAUU si'NONE' ?namDCCITT G.711 u-law2bAbjressed]paramAw_sunau_$E.get2(),5get5(),Nn<: 9)))omarker /H, id 0no ('s'kJ[#, D $ifI sUe16%; }framesize)  self._soundpos += len(data) // framesize 8S ifencoding == AUDIO_FILE_ENCODING_MULAW_8:>Jimport audioop$ =.ulaw2li,|sampwidth)?preturn B@None} # XXX--not implemented yet <def rewind()h_@0is `#fraise OSError('canlVseek'[p._file.k$._Y (6= 0Atell9_73asetpos5W, pos: ifq < 0 or >uBgetn(/position in range>W! +*_?izeV6pos%Qclose$$ =S&il0if  ! =$\5 jopened;!9.) class Au_write:__init__7, fif type(f) ''' fbuiltinsDf = .w(f, 'wbC ed = TruJelse .FFals/Xfp(f)3delD,g>_r __rdN'exuH*argHh}c,/ ! =6Prate 6nchannels- UNKNOWN_SIZE+writtenL olength;@info+''u@comp@ = 'l' # default is U-law5set%(O YPge paters after start'0to  0(1, 2, 4 sRonly (Por 4 |0sup\%ed self._nchannels = ncha def getq(self): pif not %._& $raise Error('number of iA5t')VlreturnVsetsampwidth%,  frameswritten0canPge pa7ters after starting to Me&ifin (1, 2, 3, 4 1bad<1le V! =)&gm Oratelspecified 2 5setl nKji5 = K  HKJ m9*)3set#,  IgO < 0##s Pbe negativ2 {5y ?setcomptype@ , g, nameL!if 'NONE', 'ULAW'%S! =7?elsW unknown ?qression@&')g D ::Telf._63 == u'CCITT G.711 u-law'NA.NAN 2.)6ed'1sets,sn,,F,E :# =PV$(n %( %( %(!(  O-%M_sunau_params(self.getnchannels(), sampwidth(), 'framerate<nO:ycomptyp9name()) ;def tell!):breturn_ovwritten9e1rawCg, dataIif not isinstance(!, (bytes, garray)5' = memoryview9).cast('B')+_ensure_header_Ften(&#if == 'ULAW'yimport audioopf.lin2ula_{@b = len3 //@5izejPfile.2NT!Sten =N #+  ] ;+WV-!U or \{b_Tulength 9N 3Rpatch(Qclose~ M:tryb *^$D  9; g.flushH#ofinall 2 Zf = NonY!nopenedp%\.#k# private methods( . ) $raise Error('# of ,specified7 _Z_ (1le ]^i^ ( )\ x, })._LNONEN== 1encoding = AUDIO_FILE_ENCODING_LINEAR_8,wsize = 1$%elth == 2:  encoding = AUDIO_FILE_ENCODING_LINEAR_16 5 self._framesize = 2$Relif %sampwidth == 3:'K-249_3$4%3 Nelseoraise Error('internal e%')comptypeCj'ULAW'UD M3%_8Z1  *nchannelst_write_u32(5Hile,VMAGICtheader_s5 + len=Oinfo+(:+ 7) & ~7 5YnIUNKNOWN_SIZE@leng )6pP5izeC:tryx9Rform_Mc_pos =file.tell(except (AttributeA, OS )`6NonzBdata =5gthI K)b7Orate00I? %ib'\0'*-> - 24)) def _patch) 0is  ('cannot seekr+._` i 6ten2a.hp0, 2) open(f, mode=!if if hasattr7'8'4kP = f. q = 'rb'&tqn ('r',\return Au_read(fKi8w8(wb8e9`!("Omust be 'r', 'rb',! 'w', or 'wb'") """Interface to the compiler's inal symbol tables""" import _symV from (USE, DEF_GLOBAL dNONLOC PARAM, 5bIMPORT5RBOUND ANNOT, SCOPE_OFF MASK, FREED[|_IMPLICIT, $EXUCELL)weakref __all__ = ["Q", "STPClass Function $p"] defB((code, filename,oq_type):""" Returntoplevel *SwQ* forPsourcAde. @*^A* is$k1 of Q with5Sand *=()* mode argument.9Vtop =.0 CrG_newF(top*@) cg "rFactory6f__init__(selfN.__memo = .WeakValueDiRary()CM1newH,qY"if.( =TYPE_FUNCTION26.(`)_ _CLASS\YL, 1__cRkey =Ggobj = .get(key, None))0if ,!is  ET[key]XM[obj k/ =W t:! nl, raw_} & =, =# "hs = {}Nrepr$ifq= kind = ""tOelse$k%s " %^0.__"__T.(Z"top"ZW"<{0}module {1}>".format(,8E` {1} in {2` G0N1get"""Return the type of the symbol table. The values retuned are 'class', 'module' and5'function'.5""" if self._ntype == _symTYPE_MODULE:6Brn "vRFUNCTIONTV_CLASSS&Pnassertin (1, 2, 3), \ "unexpected ,: {0}".format(J)def get_id") """Return an identifier for s*idpOnamerj`0's * jis corresponds to'P$, or 'top' ic1 is+a 75 or:pglobal uectively olineno dnumber`first 80 inQblock5P&nois_optimized*True*DclocalsQ0-Abool is_nest4Ris a 9%or<.Ehas_childrenX I4has8ospaces 9ys`a listv~   =g.keys(alookup, !L@ a **^ !*S*ostanceSsym =Y@get(f)x ymFNoneUflagsDA.J[F]F.3f_check#{5@_sco %.Z"top"72 = !, v,  module_scope= $) 'return sym def get_symbols(self):3B"""R2a list of *S,* instances for3names in the table.5""" [r.lookup(ident)O G ifiers()]__check_children , oB_newTQ(st, cQ_file5efor st_p /`if st.K1 ==:nF`nested2bolTsU ?] class Function(G"):# Default valu(P varius3__params = None[localKfreeMglob(:non?T!__>s_matching{, test_func*Rtuplek- &ifcs.=p[2]))?! et#/1 tox&Eelf.!isz#=& Ilambda x:x & DEF_PARAMrq  +60loc[(LOCAL, CELL#5 =  ((x >> SCOPE_OFF) & PMASK)U LLl~ < :;,<7= = (GLOBAL_IMPLICIT, "EXRQiQ&PR = SDU.W9Y&3nts_matching(lambda x:x & DEF_NONLOCAL)  return self.__nonlocals !def get_frees($!):=B"""R=a tuple of * variables in the function.= $if>s is Nonejn!is5 = ((x >> SCOPE_OFF) & MASK) == FREEhG!._K4s =xidents_matching(m& class C(SymbolT"):>__methodiTV, declaredXU =Wid = {}#`for stc-t.childrenSd[st.name] = 1KA(/(dY[UO9__init__6 , vr, flags pspaces=n, *, module_scope=FalseE! =LZ" =b UB = (& # like PyST_GetS(m >or -) =gc__repr.1"".format\ Fame)MM "a Zfis_referencedk*True* if_m8!usits block AboollMr & _sym7USEis_parameter4 %a =ZPARAMRglobas,9in (GLOBAL_IMPLICIT, "EX 4andIjBOUND)x:E."""D,24is__?A A\$cwith a statement $==EXPLICIT) def is_local(self): """Return *True* if the symbol is 7.1 r:2booX .__scope in (LOCAL, CELL)2v1or .__module=@and .__flags & DEF_BOUND)) LannotatedI;ZANNOTOfreea referencedgnot assigned toyz== FREE_impor%"0cre^U from2an R s|OmentD[IMPOREI825""" -namespacs+. binding introduces new J.I^\qused asrtarget of a function or classs, this will be truehNote that a single@ can.@boun^ multiple objects. Ifm0is_ ()gzOmay alsoTUotherDYp, like < nt@listJPat do2&otA aBDh2s6getsc a G 3wh5s }||F|Raises ValueErrorZsQaif len'._3f) != 1=r~ ("^x " ;[0] if __ == "__main__"bos, sy%pwith opys.argv[0])ef4src = f.read(Pmod = table(src, os.path.split(sP[1], "execfx0denP mod.iwifiers(ainfo =&qlookup()`print(' , .)g()) """Access to Python's configuration inform .""" import os sys from os.path "pardir, real __all__ = [ 'get_config_h_filename',?vars@makeEJ-_o C 0lat ;ython_versionjschemeWUparse', ] # Keys for var() that are never converted to Pz integers. _ALWAYS_STR = {9MACOSX_DEPLOYMENT_TARGET', } _INSTALL_SCHEMES8posix_prefix':Nstdlib': '{installed_base}/{platlibdir}/p4{pys_short}$L0PJ%4ureC?lib/site-packageHUinclude':h@({abiflagsE:b,fqscriptsa$biFdata}SOhomeQP'6+ SP < X ^:v//ntn  8 'data': '{userbase}', }} _SCHEME_KEYS = ('stdlib', 'plat7ure {include_j'scriptsJdata') _PY_VERSION = sys.version.split()[0]%_SHORT = f'{._info[0]}.N1]}'Co_NO_DOJIREFIX = os.path.norm (prefix) _BASE_P, _1OEXEC1 Fexec1b6g ;CONFIG_VARNone _USER1 = F # Regexes needed for parsing Makefile (and similar syntaxes, # like old-style Setup 3s). _variable_rx = r"([a-zA-Z]0-9_]+)\s*=\s*(.*)" _findvar15\$\(([A-Za-z]97*)\020{/}" def _safe_real!):*2try zreturn ('except OSError2QA if ut(_PROJECTcdirname(qCr)) elseJ#` can be empty if argv[0] has been changed Python is@# un to retrieve the program /_ os.getcwd()) (os.name == 'nt'I.lower().endswith(('\\pcbuild\\win32Yamd64'))_i.join(,,4dirQ# setacross s"_PYTHONC@" in1renviron ", ={3os./[T#])Ais_p_source_dir(d fn!("2", s.local"( if isd, "Modules", fnZ;rATrueFalse _sys_ho getattr31, '!',w 0Cfix_|2if 4case(d).start61 0Q, "PC"PA*`d  )0,_,a(checkP=w): if check_home and _sys3: return _is_python_source_dir(0)0, PROJECT_BASE) _PYTHON_BUILD = abuild(True) if *for scheme in ('posix_prefix', "')2 # On POSIX-y platforms, PX will-0- B from .h filesp'headers' (which is only added to thev Qwhen Ring Cx<*- Installpto 'include'T= _INSTALL_SCHEMES[]*[3] =[W.q.'{srcdir}/I ['L 3projectbase}/.' def _subst_vars(s, local6tryN s.Wat(**0except KeyError as varB OaSos.environ WPCaise Attributey(f'{var}'),CNoneextend_dict(target q, other wkeys = ,.(key, valuHs.items(O`if keyOJ vcontinu*@[keylaexpand(l#rsw re!{} ifsz3 = '_% , (bconfigj1)) RYos.na4-(nt%9 = os.path.Quser(*4res'-@norm6(7*>4res[berred_] ifv== 'nt'OK{#'KAix':-,:( "<_ @sys. qdarwin'K_framework %6osx} 51'7 '(U6}C(key<O = _)1s()j#if@ not qV0 f"#{key!r} returned {scheme!r}, which is not a valid G " f"on this platform )*a> def get_default_W8():.!preferred#'Cix')F_parse_makefile(name, vars=None, keep_unresolved=Truel@"""PBC a MDp-style J!. A dictionary containing i/value pairs.ed. If anA!op>lH/assed in as the second argument, it isCu*stead of a newP.&"""{import re!ifg%Q = {}>Fdone6not with opengencoding=sys.get7dsystem1(),>p errors="surrogateescape")flines = f.read"()@for =s6!ifp.startsc('#') 2.strip() == ''7Einue m = re.match(_variable_rx,d:Jif mLn, v = m.group(1, 2/3vr`# `$$'a literal ` n  ,2tmpIreplace('$$', '"L`if "$"/2 $y[n] = vcNelse1>tryJ@if nh_ALWAYS_STR)-praise VDEZint(vB#gexceptBl# insertP L.S/$' I@# doC interpolaB herucSlist(s.keys()3# V s  a 'PY_' ~O-. These need to# be made availKout thatKthrough sysconfigi# Special care]_r ensureF expansion works, eveA# if#2useba red2('CFLAGS%LD 2CPP ?while len(fs) > 0;__JGuple*&=&;Aame]b1m1 E@searFfindvar1F? W/m2020{1 and m2~1cm1.start() < m2.start() else m2 :m = m1 if# 7 is not NoneCnC.group(1)bfound = Trueif n in dZ0ite@str(%>[n]c$elH0not&K # get it on a subsequent r 3NFalsxos.environ{ doz like make: fall back to =OmentgM[n] *renamed_variables@if ().startswith('PY_') and`3@[3:] j)k8.""" + 3 _.])Kuo[n] = 1if after = value[m.end():]$,":mR()] +!+ O=`if "$"$]~[vSH?trye!0ame_ALWAYS_STR4 8praise V1_Error)1nt( H'gexceptY 5ame%.strip(b/lsJ|Uq.remove[o5 \d@and :/p<% =Ch,s -0 e# Adds unresolved M1thei dict.Px`# This0disgd when called from distutils.sysconfigHif keep_q +# bogus variable reference (e.g. "prefix=$/opt/python"); # just drop it siCwe can't deal3ts.remove(name) (# strip spurious spaces for k, v in done.items():if isinstance(v,M#9[k] = v.k(z`ave th Psultshglobal dictionarypvars.update(U)`returnWs def get_makefile_B"""R2iqpath ofM3A."""Zif _PYTHON_BUILDt0os.A.join(_sys_home or _PROJECT_BASE, "\" if hasattr(sys, 'abiflags'<config_dir_name = f' -{_PY_VERSION_SHORT}{sys.G!}'Felse<PO- .implementa, '_multiarch +- B.@ES('stdlib'), 4, 'N#')_82sys+Adata3 =x B, ''environ.get(a'$SYSCONFIGDATA_NAME',& f' #_platform}_{}Enerate_posix_R"""GePDp moduleHtaining build-time8smport pprintdQ = {}a# loadaTlled o~pJ2try0He_parse,(D,sexcept OSError as 0msg$"invalid A: un|to open {f} e, "stren"'o{msg} ({e*&})MTraiseB(msgD"py ".h#_hFF wiDpen(/, encoding="utf-8")9fd}4/(fvKhv^pOn AIX,re are wrong t@s to linker script@# --,#se;KrelativeHPython source,0 but when installed # the scripts are in another directory.,if _PYTHON_BUILD:Fvars['BLDSHARED'] =  ..# There's a chicken-and-egg situation on OS X with regards toF _sysconfigdata module after& changes introduced by #15298b# get_D_q() is c-platform() as part ofa`make pybuilddir.txt` target -- whichWa precursor 4.pybeing constructed. Unfortunately, eventuallys _init_posix(),attemptsGto import \/we won't have t yet. In orderI:forqwork, if we'reDarwin, just mock upZ 2manand populate it*d}.@Thismore than sufficient Pensurm@psubsequ 3 toGgsucceedsfname = _% _!()DQif 'd'fDsys.QKBtypem!= !.MPType(_^(.Q_time&yR s[@Q = f'N`/lib.{ ()}-{_PY_VERSION_SHORT}'gif hasattr(sys, "gettotalrefcount")p+= '-pydebugJ0os.dVdirs(), exist_ok=Truepdestfilos.path.join7 + '.py')eTopen(A, 'w', encoding='utf8'ff.write('# systemRfigurgenerated !us'B2\n''j &rpprint.(, stream=fP# Cre2'/` fixupBsee fPs/get!.c.''6=i) def3!"""Initialize!approprior POSIXKtems."""# t d / , _2D? _X_!__, globals3loc [aR'], 0\ 4.update(8time_vars) Bdef _init_non_posix(vars): """Initialize the module as appropriate for NT""" 6# set basic install directoriesZimport _impu['LIBDEST'] = get_path('stdlib'))?BIN,Oplat0INCLUDEPY[yinclude\EXT_SUFFIX- .extension_suffixes()[0]1EXE/g'.exe'qVERSIONC_PY__SHORT_NO_DOT/aBINDIR.0os..dirname(_safe_real@(syslcutable)aTZPATHE '' # # public APIs # parse_config_h(fp, V=NoneP&2 a (.h-style file. A dictionary'taining /value pairs is returned. If anA!op>'His passed inp~second argument, it iQu*stead of a new.i!ifQ = {}/!re define_rx = re.compile("#p ([A-Z]a-z0-9_]+) (.*)\n"^undefAa/[*] #EA[*]/Ewhile Trueline = fp.read(spif not 2QbreakTBm = _rx.match(4 ImBn, v = m.group(1, 2/U:try2_ALWAYS_STR%)praise VCUError}Zint(vvgexcept9_] O [n{v7elseq%$%;if (a*)j0jp0_h_jK(RF "py17.h._PYTHON_BUILD`if os.U == "nt"inc_dir ='b.join(_sys_home or _PROJECT_BASE, "PCA9SF ;7 (' B2:6, ''')ascheme_nam3"""\xa tuple5ssj2 (sorted(_INSTALL_SCHEMES)|z3xcW_KEYS2(=?default_scheme(),* vars=None, expand=True): """Return a mapping contain an install scheme. 7"```` is the' name. If not provided, it willDrx=sdefaultdA forTcurrent platform.81"""#ifS__(,)9Nelse4INSTALL_SCHEMES[8] def get_path(,=_0"()jqQ correspondq!toMm es )[bconfig8V*args&With no arguments, ea dictionary of -I0uravariables relevant2 On Unix, this means everyL defined in Python'sed Makefile;OWindows it'such smaller seto@listPvalue`at resfrom look!upqEeach/ B global _CONFIG_VARS\)if2Q = {}7$# Normalized versionsprefix and exec_re handy to havOKpin factrese aregtandar`used mos ce*Distutils`"[''] = _PREFIX> ).OEXEC3 3py_ 2PY_VERSIONd1l_short7o_SHORT=Onodo=o_NO_DODred_baseOBASE ,B ]{5aN6lat50Wrojec3PROJECT_pDlatlibdir@sys.46trySabiflagsCAexcept AttributeErrorS # }:A may%be!on %'' nodot_plat'] = sys.winver.replace('.', '') except AttributeError:&_CONFIG_VARS['py_version_nodot_plat'] = '' 8if os.name == 'nt'Tinit_non_posix(d F+IE# For backward compatibility, see issue19555XSO = .get('EXT_SUFFIXCif SO is not None ?!SO,%SOkif _HAS_USER_BASE?# Setting 'userbase'mdone below the call to Z # j function#enable usUget_config_var' in@^D-D.!%[D_get&()# Always cot srcdiran absolute pathk#', _PROJECTFFPYTHON_BUILDH$Ifis a relativ` (typiy '.' or '..$C# n it should be interpretedV directory F#>@tainMakefile'0 =O.dirname(m5_:)5<]BPjoin(V, 4;elsF#,&0meaful sincep instalV_on isspread about3system. We choosN>L:>we know itEnexistsh (j AH$_safe_real( GPOS X forms require special customizaehandle# multi-architecture,3os-&er0if ]{kdarwinimport _osx_sup .es>vif argsvals = []Y@for ; in,0y.append`7 preturn 3^ p def cY(VB"""RU~value of agle vari%!diBary rBed b'irs()'. "Equivalent to get_config_vars().get(name) """0if  == 'SO':!import warnings. ('SO is deprecated, use EXT_SUFFIX', DBionWN2, 2oreturn Q def"platform()B"""R@a string that identifies the curr?!. @Thisused mainly8distinguish 2 -specific build directorb1andO, t P ributions. Typically includ"OSOversion andarchitecture (as supplied by 'os.u()'), although9exact in=a|dpends on.@ OS; aLinux,skernel Oisn't particular-3ant]Examples of ed values@ leQ-i586Valpha (?" solaris-2.6-sun4uWindows willeu one ofcwin-amd64 (64bit 4`on AMDaka x86_64, Intel EM64T, etcwin32 (all others - d, sys.Y)2For: non-POSIXa$s,sly just8s 'V'^0os.(nt1f 'A' ind.lowerD% '2' if '(arm)J Nrm32J/64L#&64Lh4if != "posix" or not hasattr(os, '3'Mp# XXX wDQaboutz@? NT)TA*# Set for crossGs explicitlyC if "_PYTHON_HOST_PLATFORM"os.environ&[A]M# Trvarious flavourAUnix os_, host, release, L, machine =Q(# ConverF1to cGremove '/' characters,ranslate# spaces (E "P Macintosh".replace('/', ''- ' '_(O#-'xx@[:5]""P# At Atd/J3, ''^processor --Ai386. # XXX wha t about Alpha, SPARC, etc? return f"{osname}-{machine}"&Relif [:5] == "sunos": Iif release[0] >= "5":# SunOS 5>Solaris 2?&b ] ~_ =Cint([0]) - 3}.{32:]9!# We can't use "platform.architecture()[0]" beca%a# bootstrap problem.U* dict to get an error? if some suspicious happens.*'bitness = {2147483647:"32bit", 9223372036854775807:"64}H +1#.{W[sys.maxsize%# fall throughstandard-]-Xrepresentation{ )3)7aix'from _aix_support imL!() j6jgcygwinmQ;Yu%rerel_re = re.compile(r'[\d.]+'t9m"+d.match"Fif m49 = m.group:dar5_os3,y$, (= 0T.get_\(B >config_vars(),?!) G}0 P def^_python_version()lG_PY_VERSION_SHORT 9expand_makefile0s, BA"""E&# M&`-style$iables -- "${foo}" or "$(foo)"i'string' accordingJ'gA' (a'ionary mapp 1var_ {As tovalues). V cs not sC in Vare silently edv"thbempty V. Th gNashouldkcontain furtheiTs; ifis the output of 'parsex2()'=you're fine. R5s al-`Cded M"s'*""""reK# This algorithm does multiple@, so['foo'] s}#bar}", it will>"d _ ${"P, andn"A1... so forthQis is as long`comes &IB which takes crof suchsions eagerly+, # according to make's variable expansion semantics. 9while True:Mm = re.search(_findvar1_rx, s) or2EFif mSW(beg, end) = m.span()0"s = s[0:beg] + s.get(m.group(1)) + s[end:]:7elsHQbreak return s def _print_dict(title, data)for index, (key, value) in enumerate(sorted(7.items())@{"ifCR == 0W|A(f'{zF}: '\t{key} = "{~D}"')Smain(l"""Display all informatysconfig detains."""if '--gen-posix-vars'sys.argv_+_+_+]Z@Plat: "{get_p!()Python ver1_7Current installTchemeDdefault_s Dv 'Paths', "()& 2V[6r"if __name__ 0'__2__'_() #! /usr/bin/env p3 """The Tab Nanny despises ambiguousj!nt . She knows no mercy. tabn?-- Detec#/ofF For the time bePhis module iu`tendedhbe called as a script. However it1Ppossito importnto an IDE and usey1fun check() cribed below. Warning: !API proviJby t`likely`changefuture releases; such s may not be backward compat.R # R>1public do, by Tim Peters, 15 April 1998.@XXX Note:iwD@tandtslibraryz@. # 3Pneedsuundergoh|;Mc-1cod3tooH-@. T5@willaddressed later. _c "6" $os %sy tokenize ifJhasattr(c, 'NL'praise VjtError("'.NL doesn't exist --  too old")1all!["=A", "<0Nag process_Ds"] verbose = 0 fileAonly32errS*args0sepV70argZ#Qstderr.wri< epctr(argb)O P 70"\n](): import getopt global verbose, filename_only"Atry: /opts, args =H.O(sys.argv[1:], "qv")7dexcept-error as msgWerrprint(msg6mareturnEfor o, a in ;if o == '-q'? * =A + 1Z*DvD$ ="8aif not w"Usage:", 0A[-v]_or_directory .... 0arguj check(arg) class NannyNag(EqBion)/1"""-Raised by process_tokens() if detecting an ambiguous indent.ACaptured and handled)%n def __init__(self, lineno, ".! Qmsg, . =?h@get_%!nojWKG)no5?msg2 9msg/d0 6""")(Iff is a li symbolic k, then recursivepdescendDPtree !, all .pysQalongJ_way. n ordinary Python sourceEb, it iKf0ed whitespace related blems. The diagnostic mesHQs arewritten to standard output usAthe K 5temCs.path.isdir()hoBlinkH$if s("%r: lisGA" % H&,)D0os.1R+%asq@full4 = BjoinhlODif ()Bw, 1-or0\normcase(`[-3:])S".py" _(rg Af = rize.ope9j?OSEe AI/O (F: %sF > 1!%r! % generate`f.readV)G2TT"%r: Token Error: %s" % (file, msg)) qreturn  except IndentationError as5:$7errprint("%r:/ 0pNannyNagh6naghbadline = nag.get_6no( if verboseUP*** Le %d: trouble in tab city! ***>BQoffending A: %r: ,2Gmsg(!,el`if ' ' :  = '"' + + !ifname_only: <B*p#, p, repr(4vfinally`f.close()T=Clean bill of health.55 class Whitespac # the characters used for %@ and@S, T-B \t'# membersq# raw- _@origu string n * nuO1leaw)ini/ntJ@tabsuraw[:n]*Enorm PormalmHa pair (count, trailing), wherD>! % Ra tuple such that contains9&[i8instancesS * i + Tc <yO'5It's A Theorem1m.i_level(t) ==nn!@all t >= 1 iff m.pQ == n .Cis_simpleAtrue9! iform (T*)(S*def __init__(self, ws)N.raw = wsi7.S,#.k*B = [b1Ut = 0T chqu7Pif chSnOE + 1Nmb%elNTNn-ntPj@if b2lenG + [0] * (b - ;b $?3S[b] = b])Y:b(Ereakwn."= b  t /Q=, b self.is_simple = len(count) <= 1 # returngth of longest contiguous runspaces (whether or notHpreceding a tab)%deP_run_of_Eq(self):%p, trailD = !U.norm$Fmax(&-16)uindent_levell,Gsizeu## w?il q# for i in rangew FR ifL6[i]#`il + (i//tabd + 1)* *@"ilK# quickerg`<R+ sumjse!s*W[i] =`3Mts *85d+o [( <)%|) D@num_\]0andze that x is 0 when i < tssf+0l 8@ize,fA@"!-(@8t Dtrue iffX pt) == o.pall t >:eDequa^?6ormcY&`a listc@tuplcts, i1, i2) such5 i1MZ Os) !s3i2.C Intended to be used afte#`known, SwhichIcase it willK`at leane witness@tab AAnot_h_'v@n =  P!),F./h13Va = [+ tsg1, n+1ciL @a.append( (ts# 2  3") W~2# R T+ <*# The algorithmM0due{Vincent Broman.@Easy@prov]'s correct"qXXXpostTrivial to prove n is s harp (consider T vs ST). # Unknown whether e's a faster general way. I suspected so atGfirst, but no longerc!FoW 8Pial (&common!) case~re M and N are both ofc orm (T*)(S*), M.less(N) iffn() < N.le 3and9M.num_tabs!7= N. Proof is easyQkindat-windedXXXwrite that up$NoMI( fM.norm[0]) <= 1CAdef pself, o!):0if R.n >=&.n"return False7is_simple_].Hnt/nkn = max($st_run_of_spaces(),2G/U) + 13# test already did itdF ts==fls in range(2, n+1LPnt_level(ts)_  &DrQTrue ## aa listuples (ts, i1, i2) suchU5Ri1 == 3"i2Q`# Inte to be used af2not[r),;Swhichuit willPt leane witnessing tab size no_3ss_&6TNaa = [] &1&Ea.append( O H6.35) )g| $atCes(ws = (str(tup$!upSprefix = "at"nin(w) > 1-2 B+ "s1 " + ', '.join()process_tokens(INDENT = },DExNEWLINE;HJUNKCOMMENT,i!NL)@a[WhiteB("")pcheck_equal = 0]S(typeO, start, end, line)ysP0if 5# a program statement, or ENDMARKER, will eventually follow, # after some (possibly empty) run of tokens {he formDQ (NL | COMMENT)* (INDENT | DE ;+)?6cIf an 'appears, setting check_equal is wrong, and K be undone when we see the_.0[E= 1 elif type ==:: :0thisguy = Whitespace(;)( if not indents[-1].less(@)rvwitness =5@not_9_A n@rmsg = "r}@greae.g. " +$atK3es(U Mraise NannyNag(start[0], msg, line4v s.&nd u, #@re'shwe need to' here! what's important isgJ"at$ups ends,mhBatio+heHprogram statement (}) that trigger!heN $toPleft ;dhe topuFp&ckOuch! This asserz s qhe lastQ\sourc#ised *and* lacks a new0 -- n0s p+ut4zhin airz#I # else no earlier NEWLINE%an, mI 3delh8t;X^ JUNK s first "real"_aLso ibmust bH&]next `  #;"a" argubexpose@leadw L@for dA; inX@case]j- M@stri!soperly matchUd ) with whi M s"`ck was9ded)/=   d):SB A9  Z raise NannyNag(start[0], msg, line) if __name__ == '__main__': main() #!/usr/bin/env python3 #--. # tarfile.pyR5Copyright (C) 2002 Lars Gustaebel # All 8Vs reserved. # # Permission is hereby granted, free of charge, to any person # obtaining a copy/ this software2 d associated documentatiD(s (the "S72"),p deal in "! without #@tricR,,ucluding#R limirGpuse, # , modify, mepublish, distribute, scense, and/or sellD1ies5 ,opx2t Es@whom26 # furnished(do so, Bjectfollowing0ndi!s:The above noticeshall be # inV ed0copubstantial porx thTHE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO wPPIES #Tf MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS COPYRIGHT # HOLDERS BE LIABLE|CLAIM, DAMAGE<aOTHER +b # WHEIN AN ACTIONCONTRACT, TORT ~BWISE, ARISING # FROM, w OF&IN CONNEK!OR`USE ORPDEALINGS IN/"""Read fromswrite to+ format archives. """ ver = "0.9.0" __author__`\u00e4 ( )7pcredits! "7vo Niemeyer, lOJ@, Rid Townsend." P # Imsbuiltins i! open as bltn_  4sys o $ioeshutil4tat Dtime Ustrucre try:spwd exceptRError#pwd = None7?grp74grp7 s.symlink on Windows prior26.0s NotImple!ed ;_exception = (At tributeError, NotImplemented) try: # OS` (wine3"=1314) will be raised if the caller does not holdMSeCreateSymbolicLinkPrivilege p .symlink_exception += (2,) B Nam%pass # from tarfile import * __all__ = ["TarFile", @Info 3is_61Tar 2Rea!", "Compression,eStreamuExtractTHeadeZ MENCODINGqUSTAR_FORMAT7GNU5PAX CuDEFAULT "open"] #-% #L constantsK)NUL = b"\0"C #0 null cha8er BLOCKSIZE = 5122length of procng blocks RECORD?KA* 20J&# >records nQMAGICwustar # magic gnustring POSIX_9R\x0007Xposix9 LENGTH_NAM"10:Wximum a Dname?LINK = ?b?`PREFIXA!55v~prefix field REGTYP"b"@# regular( A0\-~ /5LNK^1= # (inside]U) SYM828sAE CHR030 special device BL4; 7&DIr57directory FIFO6-l# fifobECONT676contiguous2S_LONG6b"L;P# GNUfQ longF5GNU3?b"K3fRSPARS:S1fcsparse0XHDjx0<!# .1-2001 extended h{E XGL?g?dglobal=SOLARIS_XE# Solarisw < =  a1988 (x) format,1%T = 2  !# POSIX.1-2001 (pax) format DEFAULT_FORMAT = PAX O #-% # tarfile constantsO+FLtypes that_supports: SUPPORTED_TYPES = (REG 5, A 1LNK  1SYMB DIR AFIFO /ACONT3 CH0/BL^0GNU._LONGNAME, _LINK,f%SPARSE) # will be treated as a regular . REGULAR }are part of theiV. GNU~P 1 elds from a pax header override a TarInfo attribute. AIELD'"path", "link @sizelmtime"@"uidg0una%1 "g  /Paffecby hdrcharset"$_F{ v}v/intnumbers, all othe"30 # DsstringsWUMBER/!"ar: float%/"cF (CD: in8L %- # initialization)`if os. == "nt": ENCODING = "utf-8" elsepsys.getsystemencoding(5)Some useful funcu* def stn(s, length, , errors)"""Convert a 8 to a null-terminbytes object.91"""as = s.`!e(5ingg#return s[:R] + ( -(s)) * NUL 0nts N  pfind(b"\0")if p != -1iaA[:p]"o.decod/i(cb fieldpython number. 6 """ # There are two possible encodings for a number field, see?itn() below. if s[0] in (0o200, 0o377):uUn = 0`i/range(len(s) - 126U<<= 88+= s[i + 1]"=={z4= -(256 ** oQ - n)EFelse56try B s = nts(s, "ascii", "strict"A&`int(s.p() or "0", 8)except ValueErrornraise InvalidHeader&2("i! h{return n def n, digits=8,mat=DEFAULT_FORMATj"""Convert a python+toG POSIX 1003.1-1988 requiresCcs to bYed as a Qng ofws# octal followed by}ll-byte, this a0s v6ss up toER(8**(-1))-1. GNU tar5ustoringgreater thanE that if necessary. A lea  indicateEparticularPeEsa big-endiPbase-representation. T   A positive2, a@0ega H original_D Tif 0 <= n < 8{ \s("%0*o" % )E, n)uq) + NULCelif0 ==Q and ;sV V >= 0qarray([] ?173771#/+ &#&s.insert(1, n &KDn >>I k("overflow1") xnsncalc_chksums(bufX al`e chec%P a me\#'s@summ upk characters 5 thRP which is tlic it was filled with spaces. Accor0to W8sources,@someQas (Sund`NeXT)  ul`QignedC@willdifferentts| bu$Rhigh bit set. So wechecksums, unsigned and qsigned.1""""un+_chksum = 256 + sum(struct.unpack_from("148B8x356B", buf))GEbEbE{return ), ]+ def copyfileobj(src, dst, length=None, exception=OSErrorAsize!!):s"""Copy;p bytes  _u src to2dstBT If82is v the entire conten3u0buf =B or 16 * 1024i[B== 0$ #~&pshutil.&~TU blocks, remainder = divmod(^F@for b in range(?\\Pbuf =Dm.read(|4) <CVraise ("unexpected end of data"2QwriteX 'if!T Q !<_safe_print(sTencoding = getattr(sys.stdout, ' !',4if q is nots.$!e(ing, 'backslashreplace').decod%a,=' ') class Tar}$(EX"""Ba.Cpass>rExtractBKAvGeneral e5 esWOReadTL unable tar archiveUCompression\Qavail]c= methoddoStream_`suppor'Popera as on sFP-like?FilSHeade} .h1yXEmptyW  e4 [TruncatedM( Yt8] 7EOFKWxY oInvalii6Y SubsequentHeaderError(H '): """Exception for missing and invalid extended h@Qs.""">pass #- # internal streamOface9 class _LowLevelFilePLow-l file object. Supports readwriting. It is usestead of a regularR4ingAbaccessP def __init__(self, name, modelpA = {5"r": os.O_RDONLY,w WR" |,TCREAT VTRUNC8 }[i]H if hasattr(os, "O_BINARY"62 |=a#DA.fd Vopen(, 0o666) . Qclose c6os.7.fd0/X, siz3`return$3.fd'qq:, st93) ^SXCtthat serves as an adapter between Tar%C aF-likO TheT only:needs to havead() or ) methodn$ed@blockwise. Use@gzipAbzip2 compressis possibleO Acould beexample: sys.stdink@out,Aocke tape device etc.B _tX toj#Rnallyg,Qtype,obj, bufsP"""Construct aEV @_extoobj = True $ifq3NonS7 A)L0pUFalseE5 ifr == '*'># Enable transparent2 Udetec&th?cProxy( ~$ =$D.get(ZT ! =Am#=^:Y! =z ! 1  | 4pos06 d 6 :try J"gz"!c 6import zlib  except ImportError:  raise Compression,("zlib module is not available") from NoneUQself.> = !Bcrc .crc32(b"")+ ife == "r"p_init_read_gz(I)4ion~e yOelseoRwritep Aelif comptyp?bz2?trydiI bz2X'0bz2Sdbuf = b""0cmp#z2.BZ2De+}/or!OS b xv J/xz IlzmaX-Uu_.LZMA!=(Do!= "taJqunknown:Q%r" %%)  !ifA_extfileobj%"k.close!zd = Trudef __del__(6)nif hasattr2, "Rf") and8(i p"""Initialize for *ing with gzipJa.L"FT. \.;fbj(9, DEFLATED,L -AMAX_WBITSBADEF_MEM_LEVELE0qtimesta1struct.pack(":& 4OxlenT + 256 *p tMt8twhile TrueM+ =Qif not s or s == NULI*Ubreak@*160n2RR2def tell)0 """Return the stream's fcpointer position. 5""" r?u2pospoAseeko,B*=0v?Sets to4. Negative M5ingv<s forbidde ifF" -pos >= 0 locks, remainder = divmod(1<,FvbufsizeEfor i in range(bT$% L$m;elsS, backwards is`allowe!, 5 2Anext" number of bytes from.4Sasser8ENone5buf s.+= len(buf#6buf^7v@typeLL"tar j"c ).dUt = []s1c <|O# Skip ulying buffer to avoid unaligned double!6ingJ:bufcl$b.#,7~Bobj. *6 ?try `cmp.dei \@bexcept  {ion as ,CReadinvalid compressed data") from e t.append(buf)c += lent = b"".join(t2self.dbuf = t[size:]Oreturn t[:!] def __read(= , !):B"""R8b bytesstream. If internal buffer is empty,G0 d another blockHCthe L/5""" "c . [while c <4fileobj.]O2`if not JUbreak:# class _S) Proxy(object"""Small p>that enables transparent compressiondetection for { face (mode 'r|*').8 sainit__y#, I$ =!@ *BLOCKSIZE) @1 = Lq=!6bufY0get"Atype"ifQbuf.startswith(b"\x1f\x8b\x08"1i6"gz'elKp[0:3] =BZh" andgS[4:10z1AY&SY"^?bz2_b5d\x00P80", fd7zXZ")x/seFtar"IMclosCp"$) uO #- # Extra3B`FileIn AA thin wrr around an existing j ]Kprovides a part of its0 asCindividualE9LM, offset,sinfo=NonedkK# =Ty@size=&izUAposi':= 030nam3getattr(0, "1", 3d = False81&ifz; pmb = [(0)C# Construct a map rnd zeroes5map_index map = []  lastpos = 0 Brealself.offsetBfor , size in blockinfo:'I#if*3 > i !%dmap.append((False,1,C, None))a <FTrue2! +#, D1 +=' `# =K$$if1 <   !8`def flush(!)UUpass #readable&preturn -Owrit-z.Oseek..fileobj.,)@LtellB"""Rthe current F position.5""" u*kk,G, whence=io.SEEK_SETF"""Seek to a4#ifWG == Z = min(max(V, 0),1/ela:CURa&if:< 0!ax .% +Bh=OelseS/inS:ENDm; = :BS )raise ValueError("Invalid argument"o u=ad data from U!isI=-" - !;<7izer Epwbuf = b{Qwhile, >lf Jp, start$op Amap[map_index]A"ifB# <5r>topw6]breakL", 1>(#le 7mapb0 dr'clength-4-!ifem( t + (self.position - start))  b = self.fileobj.read(length.if len(b) != Mgth:Sbraise ReadError("unexpected end of data"cbuf += bWNelsei+SNUL * 6dsize - #po+$return buf 8@def Pinto(0F, b)H&@'(bn1b[:8auf)] =W&joQcloseli{.d = True #class _FileIn"  ExObject(io.BufferedFer):l__init__oP, tar GinfoXobj =q(1E9.offset_,I0tar^.3fsparsesuper().)M #- # Expor}C-/es'6TarInfo(o80"""0rmaP2al ,which holds the details about an archive member given by ak header block.3 qs are r ed;0TarB.getV%()b s() and }4areyusually crea2`intern2"""9__slots__ = dict(B name = 'N!of %.'A mod.pPermissHbits# ui'User ID>nuwho origi stored thisnHgH_GroupI*s[@= 'Si)te2mtiTpof lastAificE`chksum3H @chec%0typ( (' .D is 3onese constants: '}'REGTYPE, A 2LNK2SYM 2DIR BFIFO KBCONT#CH0#BLK0GNU_SPARSE.'S link+(,ptarget L", iis only present0'in>?  uk gAdevmajor"rDevice  nu +*in++CT8The0hs here[offset_data = "The file's data starts here.", 0pax_headers = ('A dictionary containing key-value pairs of an 'HO 'associated pax extended l6.')sparse = 'S member informa&.'/0tarv = None_Hp_struct link_target=!) def __init__(self, name=""):!b"""Cong a TarInfo object.1 is the op!alA ? .5""" .~! =?{"# 6 .0modHP0o644+A # permissions3suid = 0.@# usd*g*{group i+1sizO WKmtim-# modific ! 4ichksum#ZP chec 20typeqREGTYPEH .*z!""-0 # tu)tA Xg4 = U,C -devmajor# device  nu(6/in66 7Aoffs #4tarZB=_gL=lX  { !{}RqhDv@propertyHApath1'InF@s, ""called "71".'Gqreturn -oath.setter+ r^x>E * ? 5/ ,!6 '% =#Y c__reprn:O"<%s %r at %#x>" % n.__class__.__]5__,=1,id%)@get_F R's attributes as a\A = {6: ""# & 0o7777,3uid+O7uid" "gid": self.gid, q"size":" #Cmtim$# $achksumI$ %3typH #alinknaoH 'u$ $g$ $devmajor":'*in'K%} if info[""] == DIRTYPE and not ].endswith("/"):GH(v += "/"hareturnLdef tobuf(:4, format=DEFAULT_FORMAT, encoding=ENCODING, errors="surrogateescapeB"""Rqa tar header as a string of 512 byte blocks.5""" " =p@get_"()f;SUSTAR .create_ustar_(W)8elii?GNUg?gnue$?PAXe?paxe+seaise ValueE("invalidR"g+4M,S:k the object p["magic# POSIX_MAGIC 1len$[" "2Tcode() > LENGTH_LINKVrR is too long!26if .t{ JNAME{["prefix"]`"["R _posix_split_ 4y5ing' _ DJ.9GNU sequence xbuf = bQ(%_+NP, GNUP_LONG|gY: eader(info["name"], GNUTYPE_LONGNAME, encoding, errors) return buf + self._create_header(infoT_FORMATNCdef ;4pax?S", E%):B"""Rthe object as a ustar  block. If it cannot beF represented this way, prepend a pax extendedVysequencHwith supplementrmation.p5""" ["magic"] = POSIX_MAGIC$2s =fg.copy(# Test string fields for values that excee" length or!~I# be in ASCIIfH2, hVEin (Q;0 ("$", "path", LENGTH_u), ("link# 'oLINK),Vu4 !32Og V32)):"if0 insr%P# The#has priority+continuen# Try toJ e "ase K>tryC!].#e("asciiZNIct")'pt UnicodeE eE\h[q W if_ [0) >?gthstbnumber@imitN@likebe storedOVfloat`digits-(("uid", 8l size", 1Cmtim<0if Nw!{ Avoid overflowcE = 0Qval = 7pot 0 <=d < 8 ** (@- 1)qisinstance(val, V m tr5 - 1# Cwecessar if}sgeneric4(u`s, XHDJJelse`6b""#r] UUSTAR_replace"@classmethod'def create_pax_global_header(cls, paxSs):  """Return the object as a0 G G block sequence.D rMcls._create_ysgeneric(Us, XGLTYPE, "utf-8") N def _posix_split_name(self, , encoding, errorS5! a, longer than 100 chars intoQrefixu4and:Opartcomponents =f.U("/")Mfor i in range(1, len(;)}p = "/".joi,F[:i]Z.,+i:,!if{a.<!e(C) <= LENGTH_PREFIX \wNFNAMExCUbreak]Jelse$raise ValueE ("qq is too0R~'M@staticmethodo_(info, format^ 5a . Ca dictionary with filey! *i4iont must be one of*_FORMAT constantshas_device_field.get("type")B(CHRn0BLK Q=if F devmajor = itn0`", 0), 8]&/in??Mastn(""w s 4h? = 4 5J[<\p", ""),[9,> :Amode & 0o7777): 1uid90g02sizE, 12 Omtim3 b"C", # checksum  )2nfo_Q, REG Olinkimagic", POSIX_MAGIC nuk/32 >g> , & stn(info.get("prefix", ""), 155, encoding, errors) %] %buf = struct.pack("%ds" % BLOCKSIZE, b"".join(parts)Ichksum = calc_us(buf[-?k:])[0]q#:-364] + bytes("%06o\0{I, "ascii")$TF357:Jreturn buf@staticmethodpdef _create_payload(!):"B"""RK0the Cing ' filled with zero< up to ;next 512$ border.+5""" blocks, remainder = divmod(leg&),t'if76> 0E+= (& -3u) * NULF8J_classIgnu_long_header(cls, name, typexka GNUTYPE_LONGNAME orLINK sequencea forp[" =!!e( ! +UGY = {} ["L"] = "././@LongLink9 ["' CAsizePnfo["magic"GNU_MAGIC"#  extended u! + H Dcls.1*, USTAR_FORMATE + \M&(+@, pax_generic/s6a POSIX.1-2008or global0"that contains a list of keyword, value pairs. Thes must bsr# Check if onecffields surrogate characters andCErebyw#pces hdr+ set=BINARY, see _proc_pax()*` more vrmationbinary = FalsLI 7in w.items(6tryD.je("utf-8vstrict",except UnicodeE eEW6TruEVbreak.records =G2if F ^P# Putt_ " a`beginn "of)Wt+u'21M6\n"r$ = keyword.encode("utf-8") if binary:".# Try to restore the original byte representation of `value'.NNeedlessSsay, thatUencoding must matchnstringLd1 = .>!e(ing, "surrogateescapeNelseL T3 l = len(keyword) +B 3 # ' ' + '=9\n'Cn = p = 0while Tru2ljjstr(p)if n == pYbreakqnrecords +="s(p, "ascii"sb" " + ` + b"=E\n" W# We use a hardd "././@PaxHeader" name like star doesBpinsteadfnat POSIX fmmends0info = {}F ["hM"] = (Atype( 2siz }6rdshQmagicAh_MAGICCreate pax h! +rd blockreturn cls._c7_3(l, USTAR_FORMAT, "replace\Opayload(.@classmethoddef frombuf(cls, buf, ~verrors)"""Construct a TarIaobjectKa a 512m"s 1"""}!ifo@buf)0jraise EmptyWE0("efM!= BLOCKSIZEUTruncatedYt]buf.count(NULc 9EOF]!enf&")A chksum = nti(buf[148:156]#f &not in calc_s4?jInvalibad checsPobj =(v@obj.eg[0:100])5Amode5078%9uid$H8:11$g$k16:124HI\24:13IImtim\36:14Q = ='[156:157] Klink-157:257/u8b265:298coding, erroSrs) obj.gname = nts(buf[297:329], encoding, erro8devmajor;i;329:337]a)*in)g37:345)aprefixL345:500# Old V7 tar format represents a directory awregular@ file with a trailing slash.&0if )type == AREGTYPE andAP.endsHe("/"):<i=@ DIR; # The old GNU sparse occupies some of the unused@space inQbuffe  up to 4Tstructures`# Save9mt later process @in __&()< 0GNUz_SPARSEpos = 386)[]Pfor i{range(4N<:trycaoffsetG@pos:G+ 12o,pnumbyte%nt6 2;/24;except ValueE Ybreakx.append(($, )C/I= 24Misextended = bool,48rorigsizh483:49g_C = ( &, q$, U)Remove redundantNues fromiLkisdir(a& =larstripj z2conP a us1lon m0nott@GNU_S=u+ "/" +`return@classmetho1def 0tar~P(cls, B"""RKnext TarInfo\1ectEFeobject$ S5""" Ubuf =#{read(BLOCKSIZEobj = cls.0buff.).1vtell() - zM.smember(hy/#-6z`followBare ps that called de&oNCof aK.entry point is\! () which can be overriddenM1subOadd customI4*()8. Aethod MUST  # implement the following operations: 1. Set self.offset_data toA@posi0a whereblocks begin,KP if#are is (Cthat#s.(2sstarfilevq next member's header willP" `3. Return or another valid TarInfo object6def _proc_i(#, ).D"""Choos `right 8essing method depend!on;  type and call i!5"""-!if..in (GNUTYPE_LONGNAME, GLINKNr.gnulong(m)elo%==\fSPARSEYosparseX0XHDR, XGL SOLARIS_?paxj/se vbuiltin= Process a -c unknownQwhicha3!  be treated aFregular .#=.5obj.tell()>" =@;"pisreg()"glnot in SUPPORTED_S\a# SkipbT # +_$aV.size# =: q# Patchy  with saved globa#3ainform_apply_pax_%".ps P.encofrrors){exB4"""e,!s G`hold a Ename Clink.RNbuf EBread D# Fe :try:5 Cfromr except HEa2eNraise Subsequent.(str(e)) fR NoneG.y\j#~j 0 U=FspL Po= nts(buf<le.encoding, tarfile.errors) elif self.type == GNUTYPE_LONGLINK:,3 next.linkname = nts(buf,awncodingsHpreturn K def _proc_sparse(A)"""Process a 0 header plus extra!s.`5""" # We already collected someRstructures in frombuf()P!s, isextended, origsiz._-2delu !"2# Cug blockWwhileEUbuf =@obj.(BLOCKSIZE%2upos = 0Pfor i range(21 :try{aoffsetCiCP[pos:fZ+ 12]}0pnumbyte%nt6 2;/24;except ValueEYbreakt3if Dand B.append((9,6)I= 24yUq = bool"(50b#= {Q__dataVtell($5" =C+_m.Cu% = $1paxO nor globalas described inw POSIX.1-2008 Read theOinformation38.)t# A pax`0sto^supplemental t ]eeither#following $ () or all !s?(2 0XGL Bpax_cz'cOelse<i.copy((Check if3pcontainPhdrch,t field. This 8s ue$ oT@th,  pa ug S@s. NElly,"seus are UTF-8 ced but sinceukD$im_Gaaed to m as raw binarywings ifMatranslA fails. + match = re.search(br"\d+ hdrcharset=([^\n]+)\n", buf) :#ifAis not None:"pax_headers["TB"] =; .group(1).decode("utf-8") H(# For the time being, we don't care about anything othe3an "BINARY".PThe only(value that is currently allowed by~standard isL "ISO-IR 10646 2000 UTF-8" in`Rwords 7 = 'X.get(+ o6= tPencod= tarfile.;els#3 = P   information. A record looks likO# "%d %s=%s\n" % (length, key !, 2). EsizeA# ofcompletexQinclu4Bfield itself andG&newline.# RBboth ed stringsRregex>0ile?(\d+) ([^=]+)="upos = 0while TruAgex.(buf, posN_!ifx#mVbreakv *s(^-c = int !$ifN== 0raise InvalidHError("iN$  =l[.end(2) + 1:pstart(1J- 1]0# N1lly.could just use1 asR5Pand "5ct"#+ handlertabetter!tape risk. I0exaP, GNU <= 1.23known to store pnames iKnnotMtranslate5{4raw0 (utunately with. I\=4)Wdrst trUrict !M,Tiat fails wNfall back onbuser'svet A0 = "._H_S(!, 4spNPAX_NAME_FIELDS,, , 2m = self._deco de_pax_field(value, "utf-8" / tarfile.errors) )Xheaders[keyword] = e )os += lengthD# Fetch the next M.<Etry: &= self.from()-except HEZ as eNraise Subsequent.(str(e)) fX NoneProcess GNU sparse informationif "GNU.$.map" in 8 #Rextended[Y version 0.1b_proc_gnul@_01(-,m+elOsize200\, buf*Z.get(Njor") == "1" and/%in//0"x /1.1"if0typ= (XHDTYPE, SOLARIS_)$Pa4TarInfo object witLAP q._apply(m#, .encodingNskPsoffset 6'ti*A# If replacesL ,Y>0# wVed to recalculate9R wherCAjstartsCdG=.]_dataK"if$isreg() or0notSUPPORTED_ SoeNq._blockN. 19"= areturnMdef O 0(g,' U4"""aEtar ,\5"""@es = []Qfor min re.finditer(br"\d+v.i=(\d+)\n"!c.append(int(].group(1))Unumbyte'A %3ext = list(zip(offsets, 2numbytes)) def _proc_gnusparse_01(self, next, pax_headers): 5"""Process a GNU tar extended J 7, version 0.1.wB 0= [int(x) for x in~b["GNU.+.map"].split(",")]L& = list(zip(8c[::2], [1  /10 ,_file),?1.0fields = NoneF = [Tbuf =.obj.read(BLOCKSIZE)BX", 63bufFb"\n", 1*0 = 7while lenZB) < $F * 21if ^@ not:buf!%+3/er.;.append(@)<offset_dataW[tell(2Zn`apply_aCinfok9s, encoding, errotReplacexwith supplemental W@rmat}from a previous eor globalor keyword, valuew.items($if6H == ^name"ssetattrc"path"qZ/el\?siz\&,a Areal?&ein PAX_FIELDSZ*oNUMBER1>tryJ! =v L[!](# z:except V Ei0D !H" =}.rstrip("/" DE. =h.copy(7adecodefallback_( XDX a singl ax record return value.d ecode(encoding, "strict") except Uni+D1eError:#*return value.d&(fallback_`C1s) Edef _block(self, count)b"""Round up a byte# by BLOCKSIZE and 1it,Zt e.g.b834) => 1024.%5""" s, remainder = divmod(,t(&if0OU += 1c*QQisreg "'RhTrue if the Tarinfo object is a regular file.'we.type in REGULAR_TYPES<H_isdirq idirectory `== DIR?symfsymbolic linkj ! C9provides an interface to tar archives62Ydebug = 0 # May be set from 0 (no msgs)Xb3 (all\reference = FalseU# If true, add content\!edW1the: #0, efMH.ignore_zerosskips emptyrinvalidHdinues processinge)level = 10, fatal *s only appear  # messages (if debug >= 0). If > 0, errors 2# are passed to the caller as exceptions. Kformat = DEFAULT_FORMAT_c# The "to use when creating an archiveOPencod= ENCODINGK4# E for 8-bit character stringp = None>0# E P handNunicode conversiontarinfo = TarI Judefault Pclass;$usfileobjec*rExFileO" E"-#0ext#() def __init__(self, name=, mode="r", 53obj  dereferencQignore_zeros% Nq="surrogateescape", pax_headerGDRlevel copybufsiz%):tp"""OpenC(uncompreT) tarV `!@'. `' is either 'r' toN read fromSBexis@, 'a1 append data4an +La or 'w5qe a new overwricDD onePcVH'r'.@If `p1objgiven, ituPX4or x(itPcan be determined,>ridden byxs~ not closM0Tar<5"""modes = {"r": "rb", "a + w w x Exb"}>!if ~!in sAraise Value ("rP must1'r',Ex'")`.1=] _ s[ ]3y!if 7if Z=A and1os.path.u s(Z0# CbQe non*1entxDs inv7z6 "w :"wb" = bltn_open,8@P6ext;UFalseLMelse U=hasattr(G0, " ")Lqisinstance0.., (str, bytes))Y&! =K1obj5 ]>if i"M KO S&!= True self.name = os.path.abs(P) if else None <fileobj =  # Init attributes.if format is notY:a^%=.!if tarinfoA &=0CdereferenceG *'= Oignore_zerosP +(= RencodingN '$= FGerrors = if pax_headerB and== PAX_FORMATH=VB9){}Odebu $5bugn"if_levelA )$ datastructurecopybufsizM'losed = FalsM@memb@= [] # list of pas TarIzobjectsaV_loadbH`# flag5allIhave been readEoffset =u.tell()*[# current position in the archive,GPinode${}SP# dic>ary cach F,%ofC3 #r>lvy added:try"ifmode == "r"!kRfirst_! = (fnext()T yay# Move toV0end!a,# before1 empty blockwhile True a.seek(8# dHH.fromtariaZE7s.append(F5except EOFHE`?obj7]break}O as o1raise Read(str(e)) $x h Iin ("a", "w", "x"):  self._loaded = True #Q if (pax_headers:%5Rbuf =,tarinfo.create_;cglobalB(R.copy())Y-fileobj.write(buf,offset += len,jexceptbif notC_extk % jclose(!P8Craisb/#-644# Below are the classmethods which act as alternate constructors to8LcTarFilF. The open() S0 is. only ons at0neeL3forJpublic use; i#"super"-@ andBpable toenIPadequJ"sub:for a particular compression usingsmappingPfrom OPEN_METH.P This+r allowsQo sub[ #without loicomfort ofP0. ANregisteredmade availP`by add it,`8 in1@2def cls, name=None, mode="r", bufsize=RECORDSIZE, **kwargs)("""Open a tar archive 0rea , @ppenr. Retur,an approprin. 'r' or 'r:*'  transparent-C'r:'  Fexclusively unp+edB$gzD?Ogzip3bz2@?_bzip2@x Olzma?aFaa!, ~/*necessary wKwK AE)io ?'w:F= F /w:F ?F /w:F @ F xx3e2G", 2 2an !ifXity created  a'x:gz' ( create a gzip compressed tarfile, raise an exception < pif the 8 is alreadydd7c'x:bz2_bzip2Zx on lzmaL 3r|*  open a stream of blocks with transparent 5'r|PQGn un_@for ;ing. ,P DD EEEwLwrit/w|B C CE""" if not namd Eobj:%ValueError("nothing tog)")Vmode in ("r", "r:*")R# Find out which *!()<pppropril`.!de_( Ktypeteturn cls.OPEN_METH[0] == 'tarr'fe_msgs = []Cysorted(d, key=notfunc = getattrC,)!if0objFJNonex(saved_pon.tell(W?tryDrL(D$",, **kwargsSOa (ReadQ3, C1ion_) as .append(f'- method {}: {e!r}'.0&Useek(?\continue_summary = '\n'.join( T|*0(f"R coul!beed successfully:\n{error_msgs_summary}") elif ":" in mode:!@file, comptype ='.split(":", 1)44 = ?y or "r"'Q 'Ftar"# Select the *open() function according toaq# givenression.!!ifin cls.OPEN_METHq = getattr(cls,3[];elsVOraise CompError("unknow U%r" % careturne(name,z obj, **kwargs|%|P%if@ not("r", "w")WSValueQ must be 'r'8'w'stream = _S HRzbufsize>try0t =- UvnexceptN6z.close(~; `t._extobj = False"Btz=bin ("asL, "xx<@1tar>/ undiscerniblek@classmethodDdef qv=#W=NonedQ"""Open un edS archive R for reador writingL&""!if = 6, 'a', 'wx{[=sC!gzB%level=9S AgzipV% Appenw!isRallowed{wvqqr Qfrom import GzipFil`! IS Utmodule vailable") yileobj = GzipF ile(name, mode + "b", compresslevel, fileobj) except OSError as e:$$if5 is not None andhj== 'r'48raise ReadZ (";aa gzipQ") from en6 :tryZt = cls.taropen, **kwargsv.close(9/ifG`  (:ct._ext0v = FalsXreturn tW@classmethodhqdef bz2OVcls, EE="r"X= Q'=9n"""Open bzip2ed tar archiveg for reading or writing. Appen!vallowed%5"""1nAin ("w", "x")]Ec Value:pmust beP, 'w'R'x'")A: bz2 import BZ2Fil! ImC1ion$ ("Sdmodule~availableA(!ors  ' +(hQ, EOF)s9Y7 E <?obj >./xz#etOlzma@LZMA , s `m#ls.taropen(name, mode, fileobj, **kwargs) except (LZMAError, EOF u) as e:+2Jv.close(G!ifoz == 'r'8 raise Read_("not an lzma") from es7 ] >ct._ext0v = Falsnreturn t n# All *open() methods are registered here./OPEN_METH = {p"tar": I", # uncompressed tar/gz": "gz. # gzip 20bz2a5bz23# bzip23xexe" #e}-6# The public]which TarFile provides:Bdef wVself)@"""CD the=. In write- two finishing zero block appendoQcarchiv$5"""00if d(rN)f = Truy:try<X in ("a", "w'x"Y].(NUL * (BLOCKSIZE * 2):offset +=0+#Al upend withQ-Q3(like option -b20 forG doeaI, remainder = divmod(, RECORD'if?:> 0afO8\& -JAnfinallWk}"y),getmemberg, nameA"""R^ aInfo objectY; `6S'. If P can b{ foundf@Q, KeyA is EdJ#a ^occurs morMthan onceQits last :!re$rs assumo beU@most up-to-date versionr@tari =_E " if{+zis None ("B1 %r>02" %[szX@s of  as a li8f s.E list has the same order as the members inarchive. 5""" self._check()rif not ploaded:=# if we want to obtain a list ofA-> ()T# all,Kfirst have to@0 R# scamwhole breturn  Wdef getnames(!):cB"""R8@(of@^1ir M0. IsN &Ped by/(). [tarinfo.rS for E.getK]*,`=None,<Oqfileobj Create a TarInfject fromPresul os.stat or equivalenton an existing uQ. The is eitheZ#`X', orGspecifiedG1 ob` obj' with aZdescriptor. Igiven, `arck \salternative;|0, oQwise,#[Vtaken:'' attributeD'H1rrgument<E should b9texvostringb>b"awx")>@# Wh.creplac%by#n~as real4x$if Lct=(PBuild;,{# Backward slashes are converted8for!,PAbsolBpath;h82rel"t$ifds! ='n5drv =TX.splitdrive(9$ =q.(ep, "/"/ l#!p(&`# Now,l} `,trmationDc/" =@.tar) t needed0Use(|@os.l q, depen0 onsymlinks shbe resolved dereference2res(%?els; H: else:  statres = os.f(fileobj.dno()) -linkname = "" pstmd = =res.st_mode!if.S_ISREG(/%):]@inodV(DAino,9T6dev5 f not self.dereference and8nA > 1\xG"inMs/1arc(!=["]H# Is it a hardyto an already}# archived o?!0typ}LNKTYPEc .OelseAThe is added only if its valid.JFor win32;~lways 0,?REGi/[0Qlsy =7(elg?DIRg9DIR <OFIFO=>?LNK=9SYM<0os.'( /CH /CH /BL *BLh6return None# Fill the TarInfo object with all # information we can get80tar#.dv%md]+ui.ui%g%g%2if .#=  =j0siz@ 90+1mtibS ) C@ $kif pwd*ryuJpwd.getpwuid(eid)[0]^9except KeyErrorZEpass2jif grp%t g0grp7grgg&\Cin (M#,  f hasattr(os, "major")<  in ,H1dev= r =a= = retu0rn tarinfo def list(self, verbose=True, *, members=None): 3!"""Print a table of contents to sys.stdout. If `X' is False, onlyP the namesL {` are pm!edM itFan `ls -l'-likePQoutpu+`produc>`Toptional and must be a subsetQ' returned by getP5().*5""" U._check()q$ifX[Z V0 = AN4for4 inC ;$if Wa_safe_K(stat.filemode(. %))q59"%s/%s" % 6u ].uid,EI{gE?gid$if.ischr()ygisblk(q 10 y("%d,%ddevmajor,_inor)Nelse f Osize Rd-%02 :?" \ % time.local mW)[:6] y+ ("/"  diK "")J F?syme-> " +@link> ^/ln&OcVsdef addTP, arc I, recursivjafilter a"""Add `E'#archive.1mayany typ6 (directory, fifo, symbolic q, etc.)igiven, `'Gspecifies an aRnativ 0he }FDH re5&ed lygdefault. This canAvoidPsetting ``+r2. `c`a func@that expects a TarInfo object argumen sxchangedJ ;,##it> s : 'y will bPexcluAfrom4or"awx") if arcname is None: a = $ # Skip if somebody tries to archive the 5...;4@elf.Qu1noty and os.path.abs(%d) == s3 _dbg(2, "tarfile:ped %r" %)freturnG#1,/0# Create a TarInfo object fromu@tari&3get,3if # Unsupported type# Change or exclud if filter =*( x  E< # Appendtar headerk@data.isreg()with bltn_open"rb") as f-0add+F, f))elu 0:  #self.fileobj.write(NUL * (BLOCKSIZE - remainder)) 6blocks += 1Z`offset'%* X /+members.append(tarinfo)&def extractall(1, path=".", <=None, *, numeric_owner=False):pB"""EMD all> from the archive tocurrent workingG directory and r, modification time!permissions onIies afterwards. `' specifa diffe~J$to*c to. `p' is op!almust be a subfLlist returned by getP(). If `j`eTrue, onlyKX!nu for user/group nam red0not.H5""" B= [])%if0is  0 = H8w4 inD <3if #w.isdir(W\$# ^@withl0afee4.   = copy.3) -.mode = 0o700H!P# Do tset_attrsies, as we will dat further dowT.,!_=mI, e=!+# Reverse sortld&(key=lambda a: a./r](rpSet cor Xt/on rn v0dir` = os. `.join( , :tryHf.chown` 8 i>Ju JB1-Echmo, -dexceptCPErrore#ifm$level > 1(]raisea?elsX0_dbg(1, "tar: %s" % e[8=""P K using its full name. Its file information is extracted as accurately as possible. `member' may be aVname or a TarInfo object. You canPspecify a different directory using `path'. Fattributes (owner,Omtime, mode) are set unless `set_? s'False. If `numeric_P`Pis True, only the nus for user/group sr us@hnd notK=Uames.5""" self._check("r") if isinstance(su, str):$0tar1 = L2get,3)-Oelse;3}`# PrepJlink target@make&() if".islnk( ._9_MP= os.`.join( ,G)`:try__(,] Y DL== 6 Z=xcept OSErr8+s "ife level > 0UraisePif e. ;Nons'Xdbg(1, "tar7: %s" % e.str5zS0 %rV(W,)de1E616'e4defG*(5",  3"""# aQ fromcqarchiveRA q| a regulararLs, an io.BusdReader6returned. Fyll otheJPexist{0s, k =@does9i appeaK(inR, Key1is dY 'Preg()4Q.typein SUPPORTED_TYPES1# Ms with unknown @Ctrearegular fileGs. return self.fileobject(, tarinfo) 3Delif.islnk() oresym():1kif isinstance[k, _Stream26# A small but ugly workaround fu he case that someone triesN to extract a (sym)link as a - from a non-seekableNs! ok blockZvbraise Error("cannot  )")uJelseU_#A!'s@p is its:get I%`_find_-_target(# If there's no data associated with member (directory, chrdev,P# blk etc.), N]0ead 2Sdef __ getpath, set_attrs=TrueFnumeric_owner=FalseC"""Ethe TarInfos to a physical p called-5"""/b# Fetcg h@given nam# and builddestination -wplacingnforward slashes platform specific separator0X]( =rstrip("/,ee-, os.sep# Create Qdupper q'ie`dirs =E@.diro6if 381os.9uexists(!)@are I@part)qarchive9ts# default permission#pos.make  "._dbg(1, "%s -> %s" % (.5BA)=6 VgH ,4getpath)/ ` type not in SUPPORTED_TYPESaunknownd /se@Ofile=if set_attrsF/ch, numeric_owner%!if?.isF(J_chmod$0Outim /#-6& # Below are the different _ methods. They%called via@_extract_member() when b() is 5Fcan be replaced1Lsubclass to implemother functionality. ~@def @dir(? """Make a directory.[5""" 6tryH@# UsJsafe mode f\D\,SBreal! isSFPlater I*Pos.mk3tarv, 0o700except FileExistsErrorJpass>?3:source = .:5objE.seen@.offFdataebufsizHCcopyLwith bltn_opeY)"wb") as '`sparse;Non~!, inWx.@ _4@ '(pa, Read#, Jn*truncate(",el nI ! from a TarInfo object 3an Y rP at]eg +_dbg(1, "tar32: UG %r, " \C "0 edqregular=@." %.I)fo(self, tarinfo, targetpath): """Make a fifo called +.* if hasattr(os, "mk>"X_2os.(P)DFelse0raise ExtractError("X not supported by system") Ndef makedev(self,Ainfo  0chaler or block device  Pnod")S *sspecials Admode =.!%ifkisblk(- |= stat.S_IFBLK= /2CHRm7nod , 3,S',..devmajor[inor)Olink(symbolic) > If it canbe created(platform limitation), we try to a copy of the referenced fileNpinstead)av:try1S# For Us tha' and hardXsY|  9Mr# See e.() if  s_t_ XZ0os.%3:#._q_memberh._findcx)KPxcept_!_e:ion _HsA Key !y`unableqresolve; inside archive") from NoneQchown , numeric_owner*q"""Set p accord2%to Lis True, use .gid/.uid instead of .gname/.u. If numeric_owner +is False, fall back to .gid/.uid when the search based on \Jefails.5""" if hasattr(os, "geteuid") and os.() == 0:9# We havepbe root Vdo sop+g = tarinfo Gu9uidjif not% ^>tryoif grp 0grpegrnam(DI)[2]3except KeyError\Mpass: ?pwdJs!0pwd(pwF8%ifbissym( 7lchown")2os.!_getpath, u, g)%OelseFfE !OSO as Praise Extract)q("couldnqchange ") from e def chmod(self, """Set file permissions 3tar0 according<n 2os.OhFmodeaT_utimemodification =&"''IereturnXL8 ` M\)^@  k/#-6Anext/A"""R._"q member0he p0ive^a TarInfo object,_v Fis opened for rea#. jPNone lhere is no moreJavailable]._check("ra"1if Sfirstc t x q=m =. ! =F $return m   # Advance the file pointer. ! if self.offset !=-obj.tell():/70!Qseek(BI- 1)/jif notWkread(1X\raise ReadError("unexpected end of data") d#/next blocktarinfo = None6 whJTrue:tryD.fromtar  except EOFHeaderK as raignore_zeros*_dbg(2, "0x%X: %s" % J, e)<@+= BLOCKSIZE%vcontinu6Invalidl'O== 0 str(e))  oYGmpty7[& "e\" TruncateCSubsequent 'p#w?ionUimport zlibif isinstc1(e,* .eR f'a 7o: {e}'>?elsC` y(@Vbreakr3if 1 is[ Ohmembers.append(57_loaded = xdreturn|/#-6 # Little helper methods:ndef _getrt, name,= , normalize=False"""Find an archive N1 byK>bottom to topI I~given, it is used as the starting point. 5""" # Ensure that all members have been loaded@"= self.get7() YLimit theS search list up to tarinfo[$if is not None:Vm# =X3s[:s.index(V&)]if normalizNname = os.path.& (3foro in reversed(y)n_ayS.);elsN='6 (creturnCPdef _("""Read throughpentire ive file and look Ereadables whD;Tru Znext(1 MIUbreak.Ped = uQcheckp, mode=S C# if TarFis still open,  heration'sN corresponds'M)'"ifjclosedraise OSError("%s])2" %8__class__._&__M!if6/ !in&{ 6bad?%%rxyfind_link_target ~0FineD3get of a symF or hard x)thj~w.issym(S# Always X0 = "/".join(filter(a4, (0dir)$,FI&))a=KfN2# SQ befo e _, because aG5 isWp# just a referencePan alyd ex dl]=}_(G0=D,=; 3KeyV`1 %rPfoundZeq_iter__U"""ProvidK $ator objec" if self._loaded: yield from%ymembers$ureturn 1# Y6items using TarFile's next() method.5When all d have been read, setHC as Cindex = 0U%Fix for SF #1100429: Under rare circumstances it can?happen that get() is called duriteration,?which will aly exhausted the"ifsCfirszwnot Nonetarinfo =4eI+= 1?while Truh2if Ia< len(9)tW)[B]Pelif RQwK~F$h! = $ ;els) sdef _dbgQ, level, msgU"""Write debugguoutput to sys.stderr5""""ifU# <"E print(msg, file=T)_enter__Qucheck()x D3xitC , type, value, traceback[!if$xWclosew# An excep occurred. We must} L because##would tryywend-of-archilocks and paddingG@_exto:obj)". !d? #- # exporu@funcs+`is_tar{S(nameA"""R1 ame pointsda tar 8wCq@able)handle,  &bFalse.(@ 'yA' shppbe a stmA, or-like objecth6tryTif hasattr0, ""nt = open(@obj=S 1 )tTVErrorV) A.0 Smain( im argparseDbdescri = 'A simple command-line interface for tarfile module.' parser = arg .ArgumentP(description= )>c.add_a7('-v', '--verbose', ac?'store_trudefault=False,O rhelp='VL output'~sgroup =mutually_exclusive_&(required=True?6llist', metavar='<=/>'PShow >ing of aw u'--extracxnargs='+n(2 '') EpP into get dir c'PcreatPname>A<Cf0 from sources I_'--te$gTest i is validv>As() <@rgs.<not None:2src{%cif is_tV(src)48with open, 'r') as" (,tar.getmemberlprint(' , m=sys.stderr59wVP'{!r} archive.'.format)Y7elskUr.exit(1, OK S+\nUM$el:%8|TarFile.#:*f0tf.e(8=D.  Sf qif len()j) == 1&5[0]9=PcurdiX2os. f2f", =&nL2 Ao_#()Eall(path=|h !8>'.'"&Smsg = is extracted.'.format(src) ]else:%msg = ('{!r} file is extracted '59 'into :directory.'), curdirprint(msgparser.exit(1, is not a tar archive.\n!) elif args.creat<7Nontar_name =,f.pop(0 _, = os.path.splitext(@,compressions = {5Y # gz'.gz': 'gz',t<# xDxDxD[# bz2p0bz2 ba7}w<0mod|x'w:' + <[ext] ifz)in /6 'wLs ~with TarFile.open,M_z) as tf-1for'!in.k (eptf.add(/\verbo= %d.)) if ____ == '__main__' () r"""TELNET client class. Based on RFC 854: (ZProtocol Specification, by J. Postel and J. Reynolds Example: >>> from telnetlib import Telnet >>> tn =('www.python.org', 79) # connect to finger Hbtn.write(b'guido\r\n')Htn.read_all()) Login@ N 3TTY ` Idle 1Whe2aWhere fGo van Rossumr pts/2  snag.cnri.reston.. Note that R won' until eof -- it juss some data -- butguarantees2S at least one byte unless EOFhit. It possible=cpass aC objQa sel in order/BwaitB morSavailable. ?his case, eager() may return b'' eventA wasthe socket, becausJ4e panegotiVPhave  n <;@. T`is whyPError`needediUdistinguish between "no"# "ion closed" (sinc also appears y cPing w{iD). To do: - op negotiation - t8imeout should be intrinsic to the connection object instead of an optPn one7r"calls only """ # Imported modules i6 sy Uocketelectors from time 4monotonic as _ __all__ = ["Telnet"]xTunable parameters DEBUGLEVEL = 0%1 protocol defaults TELNET_PORT = 23-`characZ2 (don't change) IAC = bytes([255]) # "Interpret As Command" DONT-y4]) DO Aj3]) WO(2 ILi1]) theNUx0]) SEQ40]) # SubnegotiawEnd NOP"41)qNo Oper'9 DML2#Data Mark BRKC3 Break IP<4@ruptycess AO(B # Abort output AY"46KAre You There E"47$tErase C9 ELm8&yLine GA!9!Go Ahead SB = ]QBeginvoQls codeK# seks all come aarpa/t.h BINARYx# 8-bit dpath ECHO$# echo RCpprepare#reF SGA@# suppress go aFNAMS&# approximate message size STATU/# give status TMM#Ping mnFRCTE q# remottrolled transmiss2and7NAO@$# @e ab,n line width NA$ 6pfNAOCRD1 nCR disposik'HT1 6horizontal tabstops;q ; }(FFB }formfeed<V <bvertic (VTv: 3L3 @)LFgXASCIIPextended ascii set LOGOU1Hforce logout B12 macro DE?2entry terminal SUPDUesupdupP'AOUTPbytes([22]) +# supdup output SNDLOC = bytes([23]) # send location TTYPE$4$terminal type EOR"5"Eor record TUID#6#TACACS user identifivgOUTMRK272 marking 8& number VT3270REGIM96 regime X3PA!30"X.3 PAD NAWS!31window size TSPEE@2#speed LFLOWH~ remote flow control LINEMOD3Linemode opYXDISP3X Display LOLD_ENVIRONOld - Environment variables AUTHENTICATI;@Authcate ENCRYPT`QEncry?NEW?New+# the following ones come from # http://www.iana.org/assigs/telnet-A s # Unfortunately, that docudoes not C er;to all ofm, so we are ma` up TNn4b Xe64cw CHARSET4^G RSP:UT" R\Serial Port COM_PORT_OP4b1Com)" C! O SUPPRESS_LOCAL_ECHOvuvSuppress{l Echo TLB4u/tart TLS KERMIb SEND_URLw]-URL FORWARD_X#R PRAGMA_LOG"13KrTELOPT % %^ SSPI0X0#.;_HEARTBEA1 d)W EXOP"25UExtended-s-List NO 0]) # poll/select have advantage`requir> any extra file descriptor, #arily to e\kqueue (also,2ey Ne a single syscall). if hasattr(ors, 'PollSor'): _5 = 2.0_ else3Hor class e!: s2""" interface '. An instanc:Bthis 0 re`ents a'0nec'1a t|bserver. TheLis initially\0conB1ed;aopen()Amethod must be:deestablish. Alternatively,- the host name and optional port number can be passed to<constructor, too. SDon't try,reopen an already connected instance8This class has many 3_*() methods. Note that some ofmzraise EOFError whenC end(~aion is_, becausAtheyQreturempty string for other<0son Se@individual doc6suntil(exp, [timeout])QRead (,Nbeen seen, or a E5 isFhit (default$no&); may blockKall(all data?EOF< =t least one byteCvery_eagerIavailableO`queuedYousocket,rwithout8ingm!eifzr z OlazyiAraw y (processit first),ay do!8H I/Oaz%s {bcooked~h `y h0sb_> &s 2P betwSB ... SE seque EQset_o_negotia_callback( AEach Selnet  input flow, tU(if set):i!ed}`followzparameters :;/t, command,P will|echr(0) re#no;.l#No ac&d|afterwards by 3lib2"""def __init__(self, a=None,&=0Y|= ._GLOBAL_DEFAULT_TIMEOUT)F"""C<KW1`arguments, creat? unGCaWith aCD, its;OC areo&alq;r1 .debuglevel = DEBUGLEVELS%u= w= =:outz0 =   rawq = b'' self.irawq = 0 self.cooked:b''>eof0Siacse/ # Buffer for IAC sequence.J sbIq # flag-SB and SE3Cdatai Noption_callback = None$if host is not:Popen((, port, timeout) ,Adef #-,Q)%=0+=socket._GLOBAL_DEFAULT_TIMEOUT)v"""Connect to aO.iBThe al second argumen1the number, which?defaults\+standard telnet;G(23)sDon't try5 re an already cPed inO5"""{.(!ifyW = TELNET_PORTI! = 9 $ =ys.audit("Qlib.T.0", )=0 = et.create_Gion(>)?__del__(g Destructor -- close ].e&(_1msg[, msg, *argsgPrint a debug message=!enoPlevel-7> 0!If extras are presen/1heysubstitut-YGs` using L0strpformatt operator!if.;> 0`"('(%s,%s):' % )._.J), end=' ' ifs[p_Qmsg %" 7Oelse4Fset_, 1Set:1 !":higher i+,,BmoreQ output you get (on sys.stdJli=M}, Co:.^0 g6Tru KwC:ock.@get_!et RReturC$@ obj!usternallyr56Hofilenoh $A) ofB/etx return self.sock.fileno() def write(self, buffer):!@"""W  a string to the Met, doublany IAC characters.dGCan block if?connection ised. May raiseOSError9gclosedi5""":!if#in# =.replace(IAC,8U+IAC)Lsys.audit("telnetlib.T .A9", C:elf.msg("send %r"g $R.$Ball(read_untilmatch, timeout=NoneQRead 2 a givenis encountered or'LOWhen no mfound, return whateveravailable instead,possiblySempty@. RO EOFE2is @ andcooked datan = len(process_rawq(1i =.klq.findAif i >= 0_<5i+ns RI[:i]#Do ,*i:,5bufC^@not  deadline = _D() +GIbwith _Selector() as Us$.registers.EVENT_READa`while :eofZ$%ifw.R(7out)~amax(0,Z:)-n4%Lfill!%/ ,v;?, iJSW V msg('IAC %wrecognized' % ord(c).elif len\iacseq) == 2<4cmd-O[1:2%opt = c0if pin (DO, DONT)pos %d',X.]== DO and 'DO' orANT',3?opt5<D"1v~@md, xdO.sendall(+ WONT +^s,3uA^w yy yexcept EOFError: # raiP"byrawq_getchar(] # Reset onS =-isb = 0Epass%ecookedww0--11] [Idef ;Q"""Get next P from2r queue.FnBlock if no  immediately available. RI[Cwhen connecB clg5"""0mt }`.fill_ :eof6r c = self.rawq[ i : S+1]  8.E + 1$"ifRq>= len(9Y%):)Tn = b''F5= 0return c def fill_]gb'"""Fill raw queue from exactly one recv() system call.Y Block if no data is immediately available. Seteof whenFconnection@gclosede5"""+<M2# The buffer size should be fairly small so as to avoid quadratic# behavior in processu) above+4buf.Qsock.s550)!Pmsg("P %r", !Xo= (note +%#y_$@TestEther- on the C8et.with _TelnetSelector():s $.register,8s.EVENT_READDr@bool4..eF(0))interact&f I1fun , emulates a very dumb tj clienys.platform == "win32"Uf.mt_IW4'orys.stdinwhile Truefor key, eventso (2 if9.fileobj'b0?try%Etextead_eager()except EOFError^ print('*** C by remote host ***'w f0if  sout.write(3.decode('ascii') C_flush-/el~/in@line*P.readY().en  6i7R self.write(line) def mt_interact(self): """Multithreaded version of 4U)."""3import _3.start_newr.listener, ())4vwhile 1line = sys.stdin.(9(pif not  AUbreakhp.write(3.encode('ascii')/ ,Helper forU) -- this executes in the other + F>try@data1elf k_eager except EOFErrorFprint('*** Connect closed by remote host ***'lAireturnT0if n3outs';.desWOelseI gflush(Cexpe , , timeout=NoneRead until one from a6a regular express matches.JThe first argument isHF@, ei9compiled (re.Pattern instances) or un%strings).A opal second,! s; EaultGTis no2R a tuplee items:Pindex]z&e\$T thatX;L@re.Mhf objecoqed; and*Ptext  up tillincluding$ If9KJ1wasNp, raise(<iOwise, whenohieBes, ` (-1, s , ).r - received so far (may bebempty U if aT happened) ends with a greedy} (e.g. '. orq0mor!an(C can=same input, results are undeterministic,depend o$0I/O7ingrr`ft=5[:]indices = range(len(+si, sTqhasattr<[i], "search"T3Cre: !0[i]#e.^j if/ @dead@ = _C() +6t wi th _TelnetSelector() as s7: .register(self,.s.EVENT_READ):while not,Zf.eofZeL.process_rawq(D$for i in indicesF&m = list[i].search.cookedqW5Oif mOe = m.end btext =kI[:e] () 8/e:8return (i, m, vif timeout isyONoneRready.(A] = deadline - _"!ifmW?< 0(,_break^?els<continueCLfilll) f._very_lazy,2and raise EOFError@-1, !def __enter__)": .3xit- , type, value, tracebackE>.close() qStest(#"""Test program t?Blib.wUsage: python  py [-d] ... [host [port]]7Default is local 3; d/#23k3"""buglevel = 0qsys.argv[1:] ] == '-d'B'deG !+1R2Fdel TE = ''/'if*&:]f0 G=2=&0str26tryh/p = int( 6strexcept V ;socket.getservbynameLr, 'tcp'SRwith KC&tnQvtn.set_T( ?tn.open(" , ,I=0.5)i0acti!____main__  mporary files. This modulevides generic, low-7Rhigh-ayPfaces creating te\71dirQies. All of the!erE@ provgd by tcan be used \@fearC conditions 0'mkD'. 3 subject to race conditions and should not be used; it is provided for backward compatibility only. The default path names are returned as str. If you supply bytes as input, all 4 values will1in - . Ex: >>> tempfile.mks !()(4, '/tmptpu9nin8' 7d7suffix=b'%b> pbi8f0hy' This module also&s some data items to thRrTMP_MAX - maximum number of 0Ethattried beforegiving up. 0dirW@If t`is setPa str,GPfirst: ofXany routine fromNm,consider D other candidate locationQstore`orary s. """ __all__ = [S"NamedTemp,File", " # high level safe interfacesH_SpoolJ Directory",2Io!mk!",z _# lowy mkX;H# deprecated un;0getUjprefix[ # Ctant)7dir7T Ib$b p] # Iats. i functool% _rwarning  io4_ioo($osashutil& Berrn>  srandom RBas _ <"syg%syhBtype *qweakref _thread e_lock = 1.al _text_openflags)os.O_RDWR | _ UCREATEXCL if hasattr(_os, 'O_NOFOLLOW'): [#|=O)j _bin} geBINARYe Bd& A@R else = 10000l^variable _was_ unlegacy reasons, see issue 10354. # Butof 3.5 we actuallyit at runtime so chang!@it w  # have a possibly desir effect... mQwe do?1wanusupport # ah API. IYundocumenon purpose. DJpdepend 4Phis. lLp= "tmp"+I4nalB_onc~u () def _exists(fn): try _os.lstat(fn)except OSError*return False)=lseTrue def _infer_8_type(*args"""Look at the of all & and divine ir implied Q1A."""eb = Non0forM0 ins if1 is,`continif isinstance(arg, 8PathLike*Qarg =!`fspath1!) MDbyte##ifWis st#raise Type("Can't mix VGBnon-2in 1<" components."0 mYe22 t)o1strRif tempdB8 or#, =1 #Gfile APIs! aby default.#^# we could check a but it'll fail later on anywayTX8 sanitize_params(prefix, suf3dir"""Common +eprocessingBmostin this moduleaoutputTR#if7 = ^(2if R6(if0 ;=pa,Jfsencode(99d 8P= getR3dir -b. ,  class _RandomNameSequenc!d"""An B+ generates an endlessBsM9unpredictable)ings which can safely be incorpoRdGQinto nnames. EachDFeight characters long. MultiplTxthreadsm!us@ samw(Rtime.i it!or= "abcdefghijklmnopqrstuvwxyz0123456789_"f@property def rng(self): cur_pid = _os.getpid()4if "!= getattrDp, '_rng=w', NoneV]i.#\gRandomY "E$ =j}ureturn I def __iter__x2-Onext-q''.joinK.rng.choicescharacters, k=8)) candidate_tempdir_list("""Generate a E of 4 4orary directories which_get_defaulta will try."""!ir\B= []# First,( the environment.[0forname in 'TMPDIR', 'TEMP6MP'!1dir,!penv(env ():.append()ailing thaOS-specific locations!ifmz == 'nti0exti[+path.expanduser(r'~\AppData\Local\Temp'),  Gvars(r'%SYSTEMROOT%DPr'c:\2', !mp r\tmp' ]EIelseu '/-u, '/var "us E@# Asqast resorb heZ@rentny^>trytgetcwd() xcept (AttributeError, OS NdKccurdir'RO`CalculP to use v]CfileIThis routine should be called exactly once.We determ1whether or not a is usable by1tryPo creand write a  B If thisEis successful,Ctest=s deleted. To prevenial ofCrservice=Joa&e I@mustrFizede2rNameSequence$T0dir4 if" !h/Vc1os.0abs`$@# Trly a few Ps per^b.0seqrange(100#@0 = B( rlNAdir,} 0 rAfTopen(Sp, _bin_flags, 0o600P?T  with _io.open(fd, 'wb', closefd=False) as fp: 8 fp.write(b'blat').finallyKA_os.}>(fdC? ;unlink(filenameBreturn direxcept FileExistsErrorOpass9Permission9r# This hion is thrown when aqectory the chosen u~# already e on windows.-@if (J == 'nt' and path.isdir(dir) Ar,`access(,<nW_OK))(0continueMbreak # no point trying more`s in t22dir GH? OSoc(Qraise NotFoundd(_errno.ENOENT,"No usable temporaryfU_%s" %J dirlist) __sequence = None def _get_candidate)#s("""Common setup Afor all user-callinterfaces.""" qglobal X+if_once_lock.acquire(+tr Qh = _RandomNameS&k:dreleas& d n0mksQ_inne3, pre, suf, flags, output_typeBde c3to H4, T$, d sVbytesD1mapfsencode,~)$0seqrange(TMP_MAXI = next( s1os.cBjoin:Qpre +j +74_sys.audit("eD.)0", - ?#fdp5ileV0o600;@q#a againaD :' and _os.path.isdir(dir) and _os.access$ , }W_OK)):,continueNelse+Frais(return (fdapath.abs(file)) U7 FileExistsError(_errno.EEXIST,) "No usable temporary ` name found") # User visi-interfaces. def getAsprefix( """The default G form directories as string."""dfsdecode(h_late)zb{(_bytesz,enzdir = None_?Private 4%org.Hwaglobal 1dir$if1 iso>_once_lock.acquire()56try*J 0 = __^kfinallbdreleasG0/Rs")Q b(!8dirf h0mks{(suffix=, 3dir text=False'_Q-callfunction to cre@3nd wa uniqu/ s)Pvalue6ba pairP) where fd"thzA descriptoroed by os.open,ais the.S.BIf ''[1not,,=will end with that 6otherwise71re /Sbe no'nWnWbeginp8 pawis usedq?dirnBd inyo#7 r1sspecifiedGtrueY0is ew1extmode. Else ()[q90bin7Vany o2, '>'' ary must bsU0typ If y 7s'ed'1be !;Hqis readDa^1rit @only0ingr ID. If theJ operating system uses permission bits to indicate whether a file is executable, the  by no one. Th"CdescriptorInot inherited4 children of this process. >QCalle:responsible for delewhen done with it.C2"""Lprefix, sufdir, output_type = _sanitize_params(4)Nif text:d,@lagsD`_openf Oelse*7bin)*return _mkp_inner( _ ) def mkdtemp(r=None, ? 1dir )"""User-call` funct!`to creCand a unique fQorarydirectory. .Pvaluepathname&e 4WArguments are as , except tha0e 'l3' a51 isf ac+#edIl@readb, writ `searchP only1theW MCuserX{[kget_candidate_!())ifis bytes- = map(_os.fsencode, seq in range(TMP_MAXbI = next(;Q = _"X.join! +m# +:_sys.audit("J.0", -6try> os-0ir()v, 0o7000pFileExistsErrorCcontinueO# try again\DPuD0# T+wis thrown6n a(Kachosenmq@# al1y e on windows%@if (r == 'nt' Aisdi~) fA(h"ssWW_OK)(' E 'Braisr# (_errno.EEXIST,fFa"No us0_ tfound")N(M%""KPlate,?OD@ *similar to mkstemp, except thae 'text' argument is not ac+ ed, and suffix=None, pre bytes file names areDLsupported. %THIS FUNCTION IS UNSAFE AND SHOULD NOT BE USED. The\A mayGrefer to a0didx exist at some point, but by the timeFyou get aroundOcreating it,?one elsez have beaten <!toGTapunch.p""" ##Jfrom warnings im P as _) ("mktemp is a potential security riskyour program",CpP RunWt, stacklevel=2)`if dire:==Cdir(0= _get_candidate_!()? for seq in range(TMP_MAX)^/ = next( s:y;= _os.path.join(dirk! +Y# +:!if_ s(Is\areturn%raise FileE'sError(_errno.EEXIST,>"No usable 'Qorary^ fH") class _Te0aryqbCloser """A separate object allow~proper closKof ao'punderly%I, without adda __del__ metho"th .P = $ # Set here sincePchecks it4e_called = Falsewdef __init__(self,6,, delete=True(.dr=A M# =V@# NT4SvidesA-on-a primitive we don't needa#>@wrapto do anythc special. We still use irC. is"ful (i.e."(fdopen)")i NamedFe!if0Ir!= 'nt'YP# Cache unlinker sospurious e2s a@shutdown whenqmodule-KT "os"A'd out. NotRCthis must be Pencedp`, beca/C W}may alsoh befor2is a= 0n8#2elf!is9@= = !>try>BFdfinall?  if self.delete: qunlink(,ename) +# Need to ensure the file is Xd on __del__84defX)~kcclose(m7els?* =bif not%z_calledc=.#u = True%). class _TemporaryFileWrapperj5"""w?RThis Eprovides a #q around7s opened forts use. In particular, i0eksautomatiy=Wremov@when3is no longer needed.12"""u__init__, , ,=@:! =.SS:! =A ;# =V _;r =~C1 r( Dugetattr# Attribute lookups are2gatunderlying# and cach non-numeric results# (i.e. methodj;!, dNSfrienEnot)@" =__dict__['%']%Ca = E`if hasa(a, '_07__'func = aX @_`tools. s(\$x_!per(*args, **kw h3preturn 6 . q# Avoid-1 as{kalive,F sesue #18879. Pr4isinstancer;intsf6, aUag# The __enter__W 0swrong object!# g.6) so override#to=<7iBQ.# %Ftrap __exe@well _#geF#pused inJith statemen], exc, value, tb\; 5'"}ul4w, possibly&itD.close() # iter() doesn't use __getattr__ to find th-__ method def __q(self):@# DoTbreturnj# .file), but yield from itnavoid closingK4 as longit's beingderator (see issue #23700). WeN ca'' here beca(w") sJobject it, which has ae-1, aFuE would getOqed whenn3gen isalized, due.PEP380 semantics.Kfor line in u%0 NamedTemporaryFile(mode='w+b'ffering=-1, encod UNone,xY0newa=%s suffix 5pre ?3dir.delete=True, *, errorss"""CreatekD a t !Arguments'B', ' pdir' --YL0mksJ@' # aSio.open (default "w+b")<#buGA_ sizeH $-1E~DA )m'A@?qwhethereB is Cd on EJ1Theoc#()aqdo it. RSs an awith aH@-lik0terface;qname of Gis accessible"Pits '+ ' 9ibute. will be automaticallyK(!itlosed unles/'&'Qis se1RFalse[2""",p, dir, output_type = _sanitize_params(4)NPflags3@bin_`# SettO_TEMPORARYt( N OS#X@ is only supported by Windowpif _os. == 'nt'i!|=.if "b" not:^= _io.text_( /P(fd, )4q_inner( j 6try|P\eH?ing newline=newline, encoding= , errors=C) !return _TemporaryFileWrapper(file, name, delete)9except BaseE Aion:V_os.unlink(;3close(fdraise if 92 != 'posix' or _sys.platform == 'cygwin's# On non-POSIX and C  systems, assume that we cannot 0 a # while it is open.  = Namedd elseIs the O_TMPFILE flag available@doesiQwork?fR# The+is set to False if os.P(dir, ]!) BCs anGIsADirectoryE "io"_<_WORKS = hasattr(_os, ' '*Idef (mode='w+b', bufferp6-1,}QNone, newline=$s suffix 5pre >3dir-*J)k"""Creatm4a t/ArgumentsB'B', ' dir' -- as for mkbpH'" # a[!io (default "w+b")@LE_ sizeL (-1IHE Gw'EDtCB1s cd}() would do it.R object with-like interface. }fehas no,will ceaseexist when1is d5"""E|global zpif "b" 0in 9= _io.text_( 0,[", 7utput_type = _sanitize_params(4Rs7@bin_8X :tryDQ2 = ( ! |HP) & ~uO_CREATn< fd I2, 0o600g. # Linux kernel older@n 3.11 ignoreKV1reaO_DIRECTORY. TryingVY a #uO_RDWR|FRY fails wit h IsADirectoryError, a 4# d$ cannot be open to write. Set flagPFalse ?notNtry again._O_TMPFILE_WORKS = M )except OS:# The filesystem of thePdoes support w# For example,v(95, 'OperationMOed')GOn Linux kernel older than 3.11, tryinSna regularL (or a symbolic link8f) withMBails'=Not#vbecauseC is read asNO_DIRECTORY:pas4Nelse>tryreturn _io.$(fd, mode, buffering= ,C newline=p, encodI HeQ"s=){_os.close(fd:YraiseT#+Albac0_mkp_inner(). -$name) = (dir, prefix, sufs, output_type  un{(dw7  { zrj class SpooledTemporaryFil5"""h wrapper, specializedswitch from BytesIO%Por St IO'#alKphen it eds a certain size ow&a2 nobneededu1"""fu_rolledZdef __init__(self, max_]"=0Qh='w+b'W/-1#t=None, kb,w 3dir $*,E)1if 'b' in^!._=i(iio.text_( AhrTextIOW(z.C`= > h  = max_size  self._rolled = False 2 TemporaryFileArgs = {'mode': , 'buffering': ,IQ'suffix': b, 'pre GRencod , 'newlin Mdir': dir, 'errors': !} __class_getitem__ =  method(_types.GenericAlias):def _check(`, file):V #ifx: return max_size =("4if A anda.tell() >rv.rWover(" 0new 9 = g0(**p)._})H3del %j pop?if hasattr('E .q.write(Tdetach().getvalue()JelsefIB9'seek(pos, 0BTrueb# The  caching trick from Named,  # won't work here, because _ may changeHa7BytesIO/StIO instance to a real| So we list;Uall tskdectly. Context management protocolCF_enter__ICz.closedpraise VE("Cannot R# c~Rwith @" 3xitq, exc, G, tb6.]q#fiO#__*1 $@propertyg?d@{( FH*JsH(F ,no8Mb@Y_flushQ 1ipy2k(:Mv F;try8mode except AttributeError: return self._TemporaryFileArgs['mode'] 4@propertydef name(<)V6try j cPfile.7DONone|ewlines}*JAread8w, *args?-' BF1JK,s(LOseek- BAtellB &)rtruncatp, size=E!if@ is  1Q!._*K)0:lse0M>@max_u &lZrollover(T vF6wri# =~ Prv = .<tp_check("u&rvS>8, iterable!HBZ. u class +tDirecto"""Create and 4a tZ$ d0. This has the samebehavior as mkd; but can be useda context manager. ForCexample:AOwith ()K[tmpdi2...>Upon exitingw, peveryth*&Qainedin it are removed.2"""e__init__q, suffix9V, pre 2dirDignore_cleanup_ehs=Fals*$ =b(oj,1_]? = <finalizer = _weakref.(-1,M,, warn_message="Implicitly 9up {!r}".format])E-. @Rmethormtree(cls,,X 5!on(func, path, exc_infoif issub|(%[0], PermissionError):  def resetperms(path): ?try%_os.chflagDO, 0)Fexcept AttributeErrorXOpassHq1mod, 0o700) ,0if != nameu5@.dir5|)738obunlinki %# PermissionM is raised on FreeBSD for directorieTS(IsAD+yS,d#cls._rmtree, ignore_e)s=;FileNotFound elif issubclass(exc_info[0], URsjif not_shutil."FA, on=,@amethod_cleanup(cls,, warn_messageoWFalse} _dPings. (rResourceWarning_repr__(self return "<{} {!r}>".format)1.__P__.__@__, B. _Oente`4Cexit, exc, value, tb;ls /"if_finalizer.detach() or r.exists 5V> % __Agetitem__ = SN$(_types.GenericAlias) """Text wrapping and filling. # Copyright (C) 1999-2001 Gregory P. Ward.+ 2002, 2003 Python Software Pation7Written byUO import re __all ['W`er', '`dedent $in shorten']!Hardcode the recognized whitespace characters to(US-ASCII #(. The main reasonoh@thisthat # some Uniqs (like \u00a0) 5non-breakBFs. _ = '\t\n\x0b\x0c\r ' class TextWrapper: """Object for w $ing/filling text. The public interface consists ofH1theAp() and C() methods; Tother are just reHsubclasses to override in orderPtweak7 default behaviour.DIf you want0completely replAmainpalgorithm,Cyou'll probably haveL_._chunks(). 6 Several instance attributes1trol various aspec@ width (Q: 70)_Sximum("ofAed lines (unless break_long_wordsDis falseVinitial_indenty$""#P str(that will be prependedQfirst xPoutpuRPCountQwards"'s subsequent,1all1s s1he D; also cAeachI expand_tabs?5trud1 E$ $in inputc=spaces befo !ur,processing0 E4tabcome 0 .. '[Rize' N1, don its position!tsR. If!, fis treated as a le character 7ize8<E 'c$' a_white R/sl#byS0aft1ab sion. Note ""ifDn@ue, IyU@0verEto aE!fix_sentence_ending s Ensur6-6 punctua3talways followedo by two$`. Offp becausc%e h& i(unavoidk) imperfect B  Qhan 'R'Sthose,6note broken, sd`s mighq`@on_hyphen| AH/l.2,$Soccurm 0fer<C on aces and rig ht after hyphens part of compound words.drop_whitespace (default: true)& Drop leading and trail =from line_Amax_Y7NonYTruncate wrapped@placeholderB' [...]'@Appeo the lastH0 ofabd textA""" wunicode_trans = {}"= ord(' tfor x in ::0nV[Dqx)] = uW# This funky little regex is just`trick y sp%1ingq# up into-Lable chunks. E.g# "Hell, re -- you goof-ball, uses-b option!"k{sj! L/ /there/ /--/ /you/ /T/UP/ /us thS-b/ /]J(`strippZout empty Bngs) _punct = r'[\w!"\'&.,?]'L0let S^\d\W%s]' % re.escape(\)no4v'[^' + A[1:]s`sep_re e.nrile(r''w( # any@< %(ws)s+| # em-dash betweens" (?<=%(wp)s) -{2,} (?=\wWE, possibly GatedI1%(n~F? (?B#16 C-(?:lt)s{2}-) |0-%(&-)8"= 3 -? $/ofz (?os)s|\Z8; 11(?=40L0)'' a{'wp':w, 'lt': h,dP 'ws0VA, 'nO}8re.VERBOSE|9delnh ? ;?les@= on recognized ~/s.h /VWosimple^P(%s+)D.PXXX tmis not locale- or charset-awau.lowercase#US-ASCII only (fore English-sentence_end`[a-z]'z%# ve}  r'[\.\!\?]'  # sentence-ending punct. " OW"\']?N # optional end-of-quoteNK\Z')l#E of chunk Fdef __init__(self, :width=709ial_indent=""$subsequent' expand_tabs=TrueJreplace_whitespace*Dfix__os=FalsWbreak_long_wordOdrop|Oon_hyphenO_ize=8*max_lines=Nonholder=' [...]'):.1 =   : =  - = =  37 =  '> =  5? =  9< =  1 ; =  /M ` 13 = 5 = #7 =  # -- Private methods -r# (possibly useful forclasses to override)}pHmungyW textM"""_*$ : string) -> ^M] #1 inZ:sX and convert all otherD>characterus. Eg. " foo\\tbar\\n\\nbaz"Drbecomes&UPbar #&""01if @=.%"<. Eize)~N9UtranslateThunicod_"eRretur^\QsplitD,  []SIA theGNwrap into indivi}eCFs ar#not quiteHsame as p; see _T_1s()EfullJ`detail^As an example, the text Look, goof-ball -- use*-b option!0breaks into#following chunks:*1 '[P', ' c g#-- 93useF 'th %-b'71if _on_hyphens is True, or in 1 otherwise.5""" if self. d" =4wordsep_re.split()[Oelse?osimpleF = [c for c inUif c]pTretur  def _fix_sentence_endings(,H)?"""0: [string])bqCorrecti ip buried'D'. Eg. whenGoriginal!" contains "... foo.\\nBar ...", munge_whitespace(xBand `) willKvert that to [..., "TP", " PBar",\Pwhich has one too few ns; this method y changes33y?twoE = 00patsearchiU(0while i < len(f6)-1^,"[i+1] == ,o;7[i]<W=F " Dei += 2)1Ahandle_long_Vreversed_}, cur_line en, width O@ , h2@en : )H" ax2 of(most likely a f, not )!is0X0fita@any d# Figure ouZen indent`largerdp specif_,(Emake0# sLat least`racterS'pped off on ey passD"if; < 2_left = 11N )" -&"en`# If we're a/ ed6 Dssn do so: put as much#the next@currO:{fit. i f self.break_long_words: end = space_leftchunk = reversed_Ys[-1](ikon_hyphens and len(87) >i !# after last H, but only if there areABnon-4s before i("1 = .rfind('-', 0,)a#ifA > 0any(c != '-' for c inX"[:h.])z$I + 1ncur_line.appendAj[:end]u[end:] X0# O<wise, we have to preser 0he ( ( intact. Oy7addI it9the current 's nothing already'--Ethat minimizes how muchpviolate6 width constraint.C@elifi. i D +x.pop()) If we'reUpallowed!s,M4e'sP# tex!@, do\@. N'0timPrough1Gmain loop of _wrap ()'ll wind up Again-Een will be zero, sol nentirelyBRdevot   we can't handle right now.Z+de,#s9"""s : [string]) -> \GWrap a sequence+@return a list!Es oflength '.q' or less. (If 'G' is false,GAsome Ps mayn- er*n this.) CVs correspond t!to@tQwhitep betweeNem: eachL5 isindivisible (modulo)+#ne|5canFcorany twol`shouldPinternalFr; ie. aC> eiC a`or a ""W removed fromabeginn|0nd fCinesDpart76at d5"""B6= [ ?Z <= 0 raise ValueError("invalid%r (must7r> 0)" %Qh1maxsnot None: if self.max_lines > 1: indent =-subsequent_ 0OelseB initial?rif len(Y1) +placeholder.lstrip()) >^widthwraise ValueError("F too large for max G5") .# Arrange in reverse order so items can be efficiently poppedFfrom a stack of chucks."schunks.b(Pwhile0Fnks:# Start the listYnks that will make up%@curr|Kcur_len is jusUPengthW2allB 0:ineHU = []blen = 0Figure out which'@tic "ngprefix this 6IF # MaximumHVi -<r# First1 on whitespace -- drop it, unles+isie very beginningDtext (ie. nocsrted yet);u_2and`s[-1].p() == '' s7del8 # 1l =;Dv ?-# Can at least squeezeP9R onto&I4if b+ l <=-*%qappend(j@s.po .2zen += lr# Nope,IJfull+Zbreak\P# TheY,n<ibig toP# fitQ*any*ET (notTnis oneKXsl/ >a_handle_long_word, 2en,I)t= sum(map(l.Kine)OA# If)lJ0, C 1ine Rw,Cen -H;)  del cur_line[-1] %if:$if (self.max@s is None or.2@len(is) + 1 < ?7(not chunksZJdrop_whitespace and Qo) == 1*{[0].strip())0en <= width)## Convert1Prent  back to a U!ngSstore it in# list of allHs (return value).8rs.append(ind+ ''.join(-))=OelsePwhile$&aaD o15Aen +*placeholder)w G4ine I 9&_breakg!-=O  *"ifA&Aprev" =/r/p(;iC ? <=J9l )5 = " +*Jz g][e#.l23c[def _split_zg, textx" =g_munge(e[!# -- Public interfQ-Owrap1"""# : `) -> [2'ngReformat the single paragraph in 'F@' soC@fitsF1 of@no mgathan 'T' columns, as&peRYa. Tabi~are expanded with.utabs(),1andgother  characters (including newxU) areDca edQ6"""(hunks = self._split_chunks(text) if self.fix_sentence_endings:&-'_((ZUbreturnYT_wrap|)Ydef fill(Z!, s1""" : string) ->  DReformat the single paragraph in 'D' to fitlines of noFmore than '.width' columns, and Ta newcontainingpentire 6ped.q5""" Y"\n".join.=) # -- Conveni interface - y\!, =70, **kwargs)"""Wrap aV!of,`a listV\g.Pso itsA Bysdefault, tabh"are expanded with..!() Gall other whitespcharacters (incluK1 ) ccbrted t:. See Textvper class for available keyword customize{behaviourqm8w =b(F=Kw;; OFill;Q0 (,{ HX B As$.!ed4!D%  I y <) qshorten EDCollapseptruncatkqe givenI2The)first has itsyg`d. IfFDthenK9[*V *,!#iss is. Owise, as many psAas possi< ndn placeholder is appeP":: ,1>>>:.Fp"Hello nCld!"Q6=12X'#qworld!'Oello world!", width=11) 'Hello [...]'1"""w = TextWrapper(<, max_lines=1, **kwargsVFreturn w.fill(' '.join(text.strip().split())) # -- Loosely related functionality -- _whitespace_only_re = re.compile('^[ \t]+$',MULTILINE) _leadingC >(?*)(?:[^ \t\n])K def dedent!):O"""Remove any common v from every aP in `<1`. H This can be used to make [`le-quoAj2ngsDup with the leftIqedge ofdisplay,le still presenting$mAsource codeHPin insed formNote that tabs and s are bo0rea asxP, butqy^-not equal:`s " h"[D"\\trconsider#have noyPEntirSblanklbrmalizOQa newcharacter.>#keongest"nd)!toOR# all`margin = Non8 = .sub('', #s0|8re.findall3forAD3if !is=C# Current more deeply+i0hanvious winner_#hange (pre&3 isron top)>yCelifcp.starts((Opassa stB!no er Ait's3new } ' b FiV!ar]obetween cQ #&se$,, (x, y)/enumerate(zipd,~)Aif x != yX E[:i] RbreakP# sanEcheck (tesp/debugg.1f 0_!inMK"\n"passert 1!or]O), \"7@= %rfp%r" % ()sub(r'(?m)^' + margin, '', text) return def indent(#, prefixdicate=None):<"""Adds '&' to the beginning of selected lines in '[1'. D!If?]' is provided,fix' will only be addedkUIQwhere3L()RnTrue. j6notnE"itlpdefaultf0addall non-emptythat do notJconsist solely whitespace characters.-1""" ifq lk2pre!.strip()e:`fixed_#s(71forb.split';+/ryield (# +;Q else is''.join?) if __name__ == "__main__"#print de"\tfoo\n\tbar"d " \thell@re\n how are you?9Z(ZH4.5@ThisHed.")) s = """Gur Mra bs Clguba, ol Gvz Crgref Ornhgvshy vf orggre guna htyl. Rkcyvpvg"vz0. F r pbzcyrk. P  vpngrq. Syng!1arf]Fcnef_"qrafr. Ernqnovyvgl pbhagf. Fcrpvny pnfrf nera'g frabhtu gb oernx gur ehyrf. NygucenpgvpnVorngf chevgl. Reebef fubhyq arire cnff fvyrag1Hayrff rk "ylp!Vaq@snprnzovthvgl, ershfrgrzcgngvbathrff. Gurerx or bar-- naq cersrenoyl bar --boivbhf jnlFWqb vgAgungznl abg S3ng svefg hlbh'er Qhgpu. Abj7ire]vf bsgraT*evtug* abj. Vs?3zrapvf uneqDnva, vg'f n onq vqrn;1rnf; or n tbbAAnzrfcnp"O ubaxvat terqrn -- yr|aqb zbe`gubfr! d = {} c in (65, 97irange(26d[chr(i+c)] = (i+13) % 26 + c) """[d.get(c, c) [r s])) """Thread module emulata subsetJava's t+amodel.import os as _os "sy%sy_A"functools from time >monotonicV$_weakrefset import WeakSet from itertools import islice as _ q, count try: B_collectionEBdequD except IcWErrorA@& # Note regarding PEP 8 compliant names # This threa(2model was originally inspired by Java, and inherited # the conven of camelCase fun5bmethodthat # language. Those+are not in any imminent danger of # bedeprecated (even for Py3k),so tmodule provide eman # alias58_0 usv,?newh facilitates substitu)q # with?multiprocesRm, which doesn't2 ol{. __all__ = ['get_ident', 'active_PCondi current_!', 'enumerate*Emain' 'TIMEOUT_MAX6#Evy@Lock:R SemaphorPyBoundedT PpBarrierJcBroken&2Tim? setprofil{qsettrac PlocalFstack_size1hooEHookArgs9gNghp] # Re some stuff so "rJX*" is safe _start_newr3 = . oW_lock* al!tep _set_s7nel&  :"!naX+id+_HAVE_THREAD_NATIVE_ID = True"__.append(D$')Attribute]gFalse e^!_C!w 3WNone F b 1SupK, kCs __1 = l_# V def (~) """Set aEz3all!s V$ede!. "Th will be passed to sys.)R0eacm, before itsLrrun() m is calledi1"""%yglobal  ! = (1GetCUr0set by threading.setprofile().""" return _ _hook def settrace(func):."""Set a  tion for all threads started from theing module. P1TheE will be passed to sysi!()bCeachJ, before its run()Pmethod is calledgglobal _U! =g2Get+ as/3 by7ing m # SynchronizaM cls Lock = _allocate_locR(*args, **kw vFactoryCthats a new reentrant W*AP mustPrelea Xacquired it. Once aU has #aa,O5samS4may/ it againOwithout bAing;;e7o5 im+K#it#Qif _C^FBNone(,!Py! [%E$ ! _C\P"""Th implemen  objects~ /M : __init__(self!._+ C-'owner = Zcount = 0sNreprsF{M2tryZactive[e].name5except KeyErrorA**u"<%s %s.%s, WA=%r =%d at %s>" % (?"VPed" i#lf=.() else "un)",>_R__.__/__' @qual )< bhex(id)at_fork_re-*N++._+P&*gq,=True, timeout=-1B"""AN! a7 or non-aWhen invoked|arguments: if this thread alPy owne lock, 8increment the recursion level by one, and return immediately. OtherwiseQPf ano z ba untiltPis un ed. Once #P (not ed3anyl ),San grab rship, setQ ,to. If more thanc5 isKed waitingQ, onlM at a time will b{able to0 ofp. There $novalue in thecase. When invok1ithTAargu0settrue, do&0sam5ingO@as wRCcallQDout Gs3M'BfalsaQ withnb wouldq,.O;H K-@floa?@-poi1ime a positiv1,@ for\2mos`number>seconds specifi5&oupas longw1canxe acquir" R & i7 ha5een4#, x-}0 elapsed!5"""Ime = get_ident()if self._owner == me:count += 1Crc =Rd(Aing,9out/rcu& m "rc__enter__ =Adef release()|B"""R! a+C, de rIf after80 itj@zero?hA$c9by ^i!y fMRs areFG&th;to become), allow exact],mPproce   st2non&fremain!ed"-ylO r methodN85. ARBpmeErrorraised if this method is called when the lock is  unEed. PThere<no return value#5"""/if self._owner != get_ident():'praise RuntimeError("cannot release un-acquired%")Bfcount = 5- 1.0if X' 2e= None5b."()def __exit__((, t, v, tb :# Internals used by conditiofwriablesn _restorev\states_2(9,!= IoB_savleTZ == 0Y+VS_E = 0  //(o!, V!isd 8]6$ p _PyRL1= _ class CSA"""Cthat implements a0A allows one or more threads to wait lBy ar bnotifisanother7l If1P argu3given and}\, it must be a 2or pqobject,5 itE!asbunderlyingm0. Owise, a newJ FareatedTN :'in=!if1" =Uq1# Export5's <<V-! =. $C$$7# Idefines _')S/or _b'),Ithese overridme defaultas (which jFz(uo). Ditto fi%).H:try0  Aexcept Attribut S6pasNq 1t w*  self._is_owned = lock# except AttributeError:&EpassXwaiters = _deque() "def _at_fork_reinit(2)R"._ *)Ds%fi.clearc_enter__]creturnd+S_exit?w, *argsF1+O_rep "" % S, len)release_save''' ()?# No state to Aacquire_restor[?, x^- ^aIgnoreYdh`i{ 2# RqTrue ifB is by current_thread.# This method2called onlyIU doesn't have &()H(if!WFalseD`!*<Felse'", timeout=Non"""Wait until notifira9 occurs.]rpIf the "Bing K@ hasG d$?y when t_Eped, a Rm$graisedwsepunderlypA, an~0n bsFit ilPawake@by aify() or a_all()A foridsame cuvariable in anothe/`,Pl@ op,al[U OnceOv imut, it re-^+WtekpargumenP pres (@not ashould be aPfloat\point number specift*(Popera se2y(or frac Wreof) an RLockiq @d us&itl#()s, since ay actually unQ %it 6wasrmultipla@s re%ively. Instea0n iM2nal 'faoH` class uswhich resBevenQiHbeenSseveruCs. At@restore the recursion level when the lock is reacquired. 5""" if not self._is_owned():!4raise RuntimeError("can9wait on un-j}%")B#er = _allocate_(".AAs.append(>saved_state =release_Pgotit = False@try:# restore Mno matter what (e.g., KeyboardInterruptE0if &0outJNoneL$6Tru?elsPt>> 0p:S |b, 6pPZ Hqreturn 1tzfinally_( YY Iofs.removeU-except Valui+Bpassa@def \P_for(kp, predii=e@"""WIbl a conditevaluates to X should be<allable whichult will ipreted as a"boolean pTe. A@ may:provided givinggqmaximum+5 toMq0end 0 =  25out0res=HQwhile' iRv %4if !is$(%0= _UA() + )= 3% =w-R GK/<=*YbreakD.rw G9 `$cnotify= 0J_KD = CRg(Lock('" =%!, ing=True, jout=NoneB"""Ae& a?a, decri{5nalbeWuinvokedAargu:, Iis larger thaO@zerodWentrya|D andhimmediatelyL itD-3on L,some othef5 toQm(it r7is is done with proper interlocking so that if multiple acquire() calls are b9ed, releaswill wake exactly oneQof them up. The implementation may pick4 at random,Qe ordOTwhichr threadaned should not beaied onre is noP return value in this case. $When invoked wit?et to true, dL`e sameHpng as w=@%edQDout argu ss, and M~Bfalsa. If a&ou%any! w+ O immediately; otherwif&thwl`a time&}n None, it tW for Emost;seconds. c@ doe@t cote successfully in/:val B. R;!5"""J"if8t:1praise VError("can't specifyAnon-^%")O`rc = F(0end! =zp self._< Swhile3J== 0$ !%Ubreakx%if(4if !isj,)0= _D() +i 0?lseNC=-XNR<6%c.wait(?e;M-= 1#6Tru"rc 0__e:D__ =0defggf, n=1)=B"""R. a semaphor1ncr t`pnal cou ! bL} or mor3*is zero on entryQ$an<'6n3ito become largernQbagain, uptwF < 1 a'n mus on' g"._6+= lrange(n):  self._cond.notify() !def __exit__(&, t, v, tb):"&.release: class BoundedSemaphore( <"""Implements a b1$ s2.A& checks to make sure its current value doesn't exceed!rinitial%q. If it,0, V8Error is raised. In most situationsHs are usedguard resources with limited capacityfIf thevKLny times it''psign of1!ug1notbgiven, default$1nLike regulart.s,as manage a counter representingo`number calls minus$acquire()$, plus anO FThe 0method bloif necessary untilcan returPw0out!1ingnegative> :2"""l#=1>.__+)(:"Aial_H" =nY-9, niB"""R.& aa, incrXi5nalby one or more IWhen-is zero on entry and another thread0wai f;Oto become larg2"anQagain, wsup thatP!Dsc%s,e' a_VF < 1?('n must beB'y T O#ifS+ n >*i 6"g  3"By"= ' in range(n@ (REventA"""Cie! objects5k0fla0at btRBtrueGtcset() rwto fals-Uclear/ . WTG`iz!. 6 "lykIs@# Af/Tim Peters' (is_posted()o`\| = CondiP(Lock@'0= F I_at_fork_reinit(self): *# Private method called by Thread._reset_internal_locks()BQ._cond._at_fork_reil!) &def is_se~ """Return true if and only Dthe w flag is)A."""ZrA&uSt7WrDThis/is deprecated, use notify_all() instF>import warnings. @('is) mXi%',EDBionWo, stacklevel=2Q_NSet "to>QAll tX s waiting for it to become4 are awakened.!AthatFq() once)Q@will b at all.Rwith F#\i= Truef6.h5\clear{s9WfalseSubsequently,DDL1() `until 8)Ued toz:Wagain*#F-, timeout=NoneA"""BSU!If) on entry, immediately. Otherwise5=0ano!mosR to yQ, or goptionalw occurs_AWhenN argumentp!nt@not 4,3should be apAfloaWpoint number specify+ay0era` in sej(or frac sWreof)e' pxit, socalways^p exceptis given 6Ws out@igna=c!ifEs) ! CD.6out_0( 7 # A barrier class. Inspired@partpB_0`_* api # CyclicBN class from )Java. See # http://sourceware.org/pthreads-win32/manual_barrier_init.html andLj` sun.com/j2se/1.5.0/docs/api/!/util/concurrent/ # rCyclicBe` # for information. # We maintain two  states, 'filling'q 'drain@enabS the # to be c{B. T are not allowed into it until has fully ceQsince`previousYe. In addi, a 'resett exists which is # similarxcept tha leave with a BrokenFError, # Aa 'b'.3 inpCall 0 geY1e eiscclass S : """Implementsv aUsefulsynchronizing a fixed number ofwat known 1Pgpointsblock on 'wait()simultaneously aw# oyOh/0madat call.2""" Qdef ___(self, partig ac=None, timeout) $Create aq , <qialisedR' @'e0' ibBable, when supplied, willalled by one ofNPafter%y Penter6just prioN`releas@them'@. If `provid itu aszJqdefault-subsequents._cond = Cone(Lock())g'R2 = $ = $ = = 0 # 0 2, 1$ing, -1 R, -2  Jcount = 0p 2WaiJ8W4specifistarted vAthey6allm %n Dwas ,PPexecuEback returning.LRs an individual $exhfrom 07-1'/g$if<#._ =a() # B@whil Gsyindex = D9u self._count += 1 Itry:if index + 1 == self._parties/3 # We release the barrier\-P.-()$Oelsegwait until someonzMs usNr9(timeoutvbreturn Eofinall(|count -Zw# Wake up any threads ting for' to drain.zDeqexit() s# Blockm@ is cy[ us, or raise an exceptionEt3Sbrokezdef _enter(y)Swhile state in (-1, 1&1# IXesetting,Adone7tp._cond.&x#see if\Rin a  O)if6< 0kBBFErroiassertED== 0OLA run0'ac`Y' and  #@\ x A"._L!# v >#> notify_allcm #@ durw handler. BreakG3}b$s,-|+itexdwe are_d. R&b"srZw$, fTif noO9/_for(lambda :lO!= 0H#_Ud out,'/._, _B51B3If Clast#Uz, signalJ#QKPJ2FV C!i+#!~1ingOS % ^I#g A"""Rto the initial state. 4Any threads currently waiting will get the BrokenBarrier exception Jw raised\5"""hwith self._cond:>%ifzunt > 0 $? ==%)C#resbP, wak$up 6`= -1%%el&N= -2Ma#was b3 , bit to > _7hich clears when|0laso exits= Nelse 30W.notify_all()=def abort(')Z"""Place into a '' Useful in case of error. =andaattemp@to '2()';havEh(x._break@# An Rernal (detected. The 6s:%to3# aUC all parties awakenJ!._n H@property/bRRetur`numberrequired0tri~.rFmg n_?ingFaT# We don't need synchronization here sinis is an ephemeral1ultA# anyway. It s"correct valuekbsteady.E} (XL<0VS Trf+in& #@| b$e `aclass  z(Runtime ap1 # Helperugenerate new( names _counter = (1).__next__ @_new,(_SClatelO # %K er p# ActivadministrA. # # bpo-44422: Use a reentrant lockWallowPcalls@funcs like #ping.enute(). _active_lim(bo_lock = RLock() _active = {} # maps thread id to T object _limbo1 _dangling = WeakSet() # Set of:._tstate|snon-daemonos used by _shutdown() #wait until all Pyth7 ]s get deleted: # see8setE(). cs = _alloc!"Rs = sdef _maintainN@(): N1"""Drop any M that don't correspons@runnWs<amore. O1Caluthis from time(Pavoid4 ever-growL Jset when* s are not joined explicitly. See bpo-37788Tmust be called with> acquired.$a# If a was released, the has exitedJqto_remo[aB forQ,in1 if(.Qed()]H ).difference_update(j ) Main classr2s ?A*represents axcontrol^L0cancsafely subPed in< im  fashion. Theretwo waysto specify\@ity:{@passcaCable_nstructor, orQby overrid;run() metho<_initialized = Falseb __(self, group=None, target Bname U}args=(), kw ?2*, ~741"""%co should alDkeyword argum4. A }:\**P0be ; Arved@future extensionaG is imple~X*%*" be invokz%C. DefaultsQ, mea@noth!is4  b. By dT, a unique}Ued ofbform "V0-N"@re N6@a sm decimal numberra tuple|a41catI>*TSPa dic00ary  bEj'{}EoeQ, it make sure to invoke# 6the base class constructor (Thread.__init__()) before doing anything L else to Ut= j5""" assert group is None, "argument must be for nowDif kwargsA:_E= {}zif name)p = str( ).+@_new+"(""F-%d"7}if target1not L'>try=_e# =K!._%__*++= f" ({|/&})2,except AttributeErrorFpassbself._^=h  =   if daemonGu&Cic =1C 2current_2().NC1 id= if _HAVE_THREAD_NATIVE_IDNBnative_id Ftstate_lock!`starte>fEvent(sAis_stopp#UFalse!nitializ"6Tru!# Copy of sys.stderr used by >Rvoke_=Mhook76= _E E = _make_in_# For debuggyd _after_for_dangling.add()def _reset_internalks%, is_alive)# private! Call  xUT our Y Es as#Py mayin an invalid P leadto a deadD or crash.J#._ A._at0_re3%if# bpo-42350: If\k happens when{ al #y _PQ(ex:  3_shutdown() has been cFG), _ Nq. Do no` ivis case ~#ifQtA/Eb4wacquireqiS# Theq isn't c,: it doerhave a kanymor   e_lock = Non e def __repr__(self):passert  ._initialized, "Thread.___() was not called"Estatus = "B#if\started.is_set(B(Bis_alive() # easy way to get ._U topped set when appropriate1  P<daemonic:R+= " ";rident iFONoneDS%s" %<7return "<%s(%s, %s)>,.__class__.__name__,F", j)q<@"""Sa the t 's activity.>1It must be at most once per? object. It arranges fo$'s run() methodbe invoked in a separat of controlDThisD will raise a RuntimeError if0morQ"an onw0sam)""%<S "("irInuUc1s c lyF"gawith _e_limbo_lock[1] =k3;try-kR_new_x._bootstrap, ())@except E:ionM/Hdel `%!._ed.wait(E" )M`esenting97You may overridY!ubP. TheYndardsv.Cable pDaconstructor a:N0tarVargument,"Qany, q@sequal and keyword .us takenMAfromBargs2w _s, respe[(el[T JT"._*"(*3, *kzkfinall# Avoid a refcycleW@runna function7E# an1 that has a memb1at pointsa.G._args, self._kwargs def _bootstrap(self): # Wrapper around the real 3 code that ignores>(exceptions during interpreter cleanup. Those typicallyBh"n when a daemon thread wakes up at an unfortunateAmoment, findsTworld it destroyed, and raises somGurandom *** while tryto reporte)'ink_inner() belowO lRdon't help anybodythey confuse users, so we suppresEthem. Wbm onlyk0it y ar3a8indeed has alhy beenP"so/s  (@normg usiness hours are proper%xed. Also,3forB#icD(s;f a non-gic encouiS@methelse is wrong.F6try?CR.1 42if 7@_sysrJNone0hVreturkset_identmE = g')= if _HAVE_THREAD_NATIVE_IDG`native_iddh#l(pMtstate_lockO5"""C`Set a &p objectch will be released by  YI0und^g (see py 0.h)&s deleted@ = _$sentinel()z ,.acquire?bif not with _shutdown7s '+_maintain/' "2.ad'._T" >.7o $Ow"0tar;setmf!ac_limbod$[Q1] =uQdel _M/]ytrace_hookqsys.set$!(_+a if _profile_hook: _sys.setpr&#(_ /)) 0>tryAself.run(),oexcept/_invoke_%(GBkfinallnwith _active_limbo_loc# We don't call u ._delete() because it also?# grabs.04del,[get_ident()]- 1uBpassdef _stop1/q# AfterRing .&), .is_aliv returns False and .join()  # immediately. ._tstates must be released before~#ZNormal case: C code at the end of thread's life?(v_sentinel in _.module.cs,Lthat's detecty our ._wait_for1(),(:MPn. Any numberqs _may_JFsimultaneously (for example, if Riple ps are b Wed inJj!s)Yy're not serialized. T harmless -Ithey'll j0makdundant rebindingsA._isz;pedk B. ObscurwPF  last so `"asser(lft"  always worksM(yQis execu @onlyr is None)VSpeciS_main.  via thi's _shutdowfunctiony# =1if $!is3Z).'ed#V= Tru |! =^(jdaemon_s '# Removebd other\dfs from=P`Lt (m)"`currenwN@dict ply runn%."" H# There must not be any python code between the previous line # and after* lock is released. Otherwise a tracing functionLcould try to acquireWragain i0samread, (iJurrent_th"A()),wab!. }def join(self, timeout=None):""""Wait untilY terminatesP.QThis es,@call4 ERwhose) method is}?'edk` -- eiW normally o rough an unhandled exceptk'oro$alh occur#Wh argument@pres @not 7r, it shj5e aPfloatpoint number specifyafpe operafsecondq(or fraIireof). AsLPalwaySturnsyou must Xis_alive())decide wheshappened ifOis still \,#~Wd out>q eu#or*Ewill#A Tcan bqed many raises a RmeError ifaattemp)@madeL6c{a2at 1cau7Adead! IN@alsoaem$toTlO`beforePhas bqstartedscdo so RbG5""" 0if E._initializedC^ *1("T!._6A__()IOed")a.is_set(f0can  qMo>]"")x4pf< Z._wait_for_tstate_ (Jelse7#abehavior of a negative ouFqn't docued, butn# histori0y .<(@=x) @x<0 Z!acSs#0N14max`C, 0))S,hV=True'-1# Issue #18808: Pthread state to be gone. # At the end of thread's life, after all knowledge*M4is removed from C data structures, C code releases our _tstate_lockThis method pas/its arguments to<acquire()FI]C is $!d,`is donnd self._stop() iscalled. That sets ._is,0ped3TruG.N{=mo1if $0is ::@# aly determin 9Gr $ureturn :try~.L (b, timeout)- .%()YrjexceptLyP?ed(j# bpo-45274:@)CB, bufunction~ # was interrupted with an ion before reaching_Hq. It can happen if a signal handler raia~, like CTRL+C which9KeyboardI 8"@property>def name(;@"""A   us!or identifica|` purpoRonly.^mIt has no semantics. Multiple Qs may@ivenQ sameQ. TheNqinitialaset by22con'or5"""= ?Jized, "T80.__ap__() no3Ar\)@ q.setterm H,N. ._u =( ) "er#is1 orit been startedh nonzerowpger. Sebe get_$)  7V%er`recyclThen a!exPnd another@creaDvailable et*c NGif _HAVE_THREAD_NATIVE_ID: @propertydef native_id(self)/6A"""N integral thread ID of this, or None if it has not been started. {^T>is a non-negker. See the get_) function.Nrepresent5e Tpas repo1 byWkkernel9"""Vpassert ._initialized, "]!._A__()jcalledEcreturnE is_aliveB"""R;qwhether95Qrmethod ts True jus2forRcrun() *qs until*3aftt 1terminatesAalsoemoduleHenumerate()kg.#if_is_stopped0ed. ;et(.e False9wait_for_tstate_lock())*?nf |odaemon A boolean value indicating w  Mcq set be  ()=0, o``wise R meError isaised. Its herited from2cre;MCmain:a@ and3r$al|!s ZUed inP(Tdefault toV= e entire Python program exitsodn onlyCs are leftL:O#icIq.setter N,'ic!ifR r ( [hb0can/0tusa ac)"o/Eic =&?isDc UOHY@is df0cat"usS attributHstea$ im warninge. %('x0getxe instead',  DeprecationWarning, stacklevel=2) 7return self.daemon def setD(", Aic):#C"""Set whether this thread is a3.T1T"Qmetho"ded, use the  property insteadF5"""import ws. &(')y1sety attributey%',UgA="ickqgetNamei _Ra string&d for identifi purposes only+qNnameDo  mgmuk0eese ,  kojYd YF^==b try dfrom _(_excepthook as PQ _E4HookArgs8 ") H! IfRError# Simple Python Ament4 if.(Hnot availabletracebackLeSprint>0ion_>`collecs@>bdtuple Y"(Jm'$'exc_type]R_valu "')pk MW(args> !(*'EA7, /D/Handle uncaught T`.run() ep!.<0if w.== SystemExit # silently ignore*])0sysNone and _sys.stderr v =.n$elG."._]Ostderr is None:+ # do nothing if sys.stderr is None and"waKwhen the thread +}created.ereturnUelse:Sargs.p Gh;if 31not hname =,.H = get_ident()-print(f"Exception i)%{8E}:",.r file=, flush=TrueU_V$_eT(exc_type,Hvalutracebacksy~r.() # Original e3 ofBing.chook _ W__ =  def _make_invoke-"()1# CI a local 6space to ensurw at variables remain alive]!# fcalled, even &it late duringLPython shutdown. I0mostly needed for daemo1s. @7old  :sys$_;)0if ,9#raise RuntimeError("3 :"Z e^ XR_info = !1 = 3sys6K?9?hglobalz6try1if ! =2 = HookArgs([*3(),N*])>aQQb as exc.__suppress_context\dM!de, y"if<%)! `$=Qy g <"._M =(z i     _C ,ys_excepthoo k = old_sys_excepthook  #(*_info()),finally:D # Break reference cycle (n ion stored in a variableVEargs = Nonereturn invoke0 # The timer class was contributed by Itamar Shtull-Trauring c1T=(Thread)"""Call a functafter a specified number of seconds:Bt = \30.0, f, =E, kw t.start(cancel()[ #G4p tB's aif it's still wait62""" def __init__(self, interval,#Q4.KY.X% =c1!a=z !'! =;3 ifQs not" else []5^# =g9i;*{};finished = Even!5*g"""Stooit hasn't Q@yet.4G.9.sek1runh 0"d{!if  11is_d!(*3s2, * 8\" @ # SAal tIto representCmain#R_MainKs ]1 |, name="Q", daemon=Falsh_tstate_lockt #ed/Ret_id! if _HAVE_THREAD_NATIVE_ID'Anative_id{`with _ve_limbo C [K@] =  # Dummyi ped here.R`se aregarbage collecQ0wheey die, nor ca!bes`ed forL Ify anything)Ping.pat calls current_ 1(),B # leave an entrS*P dictv evTheir purpose is OQ*somem* fromy@y  marked asQ\s so we wo-Am # +we exit (conform previous semantics). 3_newname("Du mmy-%d"), daemon=True) self._started.set()xet_iden if _HAVE_THREAD_NATIVE_ID:=`]et_native_id_with _aclimbo_lockC [K@] = def _stop()>Fpass#is_alive&assert notTA._isNsped and  #preturn UlAjoinh, timeout=NonevFalse, "can8 a dummy thread" # Global API functions current_.(cB"""RCthe $! TR object, corresponding to ,saller's of control./If( A wasOpcreatedJAough71ing'{module, @limiEality is y#ed1"""S6try$c&[g]-except KeyError9D7)()q4pHEThis`deprecZE, us| insteaimport warnings . #('(m!',QDBionWw, stacklevel=2i}n0coum`number>s1ly (5The; WTequal`lengthRFlist2!byenumerate()X_rClen('A) + /gC8G q_/()E'H\ ! iA/ X?_=# Same as Q, butp1out. InternalhQonly.4ist.values()u:!a kjof all 5includesic threads, dummy thread objects created by current_&(), and the main=. It excludes terminE6s4Nthat have not yet been started. -1""" with _active_limbo_lock:return list((.values()) +:3 'ing_atexits = [] _SHUTTING_DOWN = False def _register3(func, *arg, **kwargs)"""CPython internal: @ *:* to be calluefore joining^s5The>$ed@$is=(arguments jus[U1all2non-daemo3s ated in `_shutdown()`Pprovia similarJppurpose`A.()`, but Btioniprior toJ{Q instf=tpreter 4For0ity,?ed in reverse.r:if l aise RuntimeError("can't 8 af"")" =ools.partialH.append(M) from 'p importLck_size # C0, # make it available f(he # (Py_Main) asEing.7@. _f!= /Ti#()I(.PWait `lA"te of all get deleF# Obscure: otherPs may@wait!to . That's# dubioussome code does it. WVFC#to releaseK J's tstate1 - * woLhUNis nearly dead. So w6shere. Note\#Iu_stop()Nwoenough7 al; ?Gon _XPA._isj6pedZ%# At() was _!edrOkglobal* r = True50# C?^/!be>"# Order isK$d,N`_l#d(,e5? #  eident == get_ (): tlock = _main_thread._tstate_lock `# The ' ' isn't finished yet, so its"G Gg can'tMhave been released.assert t9is not None!.&Eed()8.W CstopUelse:?# bpo-1596321: _shutdown() must be called in tA# If-ing module waimported by)[, i[e_ewhich H n is case, ignore , similar behavior than f sRspawnC libraries or usNstart_new&()Qpass T# Join all non-deamovwhile TruFwiths#s = list()s8* .clear()!!ifR eVbreak)5&&s.# mimic TsCjoinf5.acquireA3S# newn@`we wer it9WotherIIs to complete def"""Retur $robject.In normal conditions, Rfrom "thPython interpreterThG1"""rEs # get'`-localEplementa@, ei ~# #,pfallback try#-d@ort wPal asal except I^Error<3ing7;_after_fork()<sCleanupmthat shouldaexist O akO# Reset _active_limbo k,Y1 we9 edlekAheld#!anv (3ed). http://bugs.b.org/issue874900Joglobal  ,1,G] = RLock#() only copieddcurreng!; J referenceZsd!WR = {}2IR=[get_ident()]L7KeyI<~called in a thr ead which was not spawned # by threading.T . For example, a!= .start_new_N5().ecurrent = _Maine1() !S_main53 = , # reset _shutdown() locks: s re-register their _tstate_)b belowhDsTalloc0/(),d = setwith _active_limboL::W# Dangling instances must still haveGset,Gbecause someone may joiFthemass_enumerate()$@.upd#_d" foC 3 insEQ# Any/condition variabl$bel)Ped orQ%anKinvalid , so we reinitializ6#if4 isi &p# There$Ponly =>0. Wk\`the id)toI its new value since it canvchanged7p!.__internal+fs(Truey/a= get_ W " = [)3] = +Oelse>0All others are aly stoppOFalsU_Wg.clearuucassert len(F ) == 1 if hasattr(_os, "P_at_fork")$L_os.(after_in_child=_7) #! /usr/bin/env python3 """Tool r`measur-QexecuR*time of small code snippets. This module avoids a number5common trapsb b`s. Seso Tim Peters' introduco Algorithms chapo0in =P Cookbook, published\ O'Reilly. Library usage: sezper clasCommand line*< it.py [-n N] [-r0s SphA-] [[ment] OpS-n/--2N: how many^Rs to 5e 'A' (defaultY`-r/--repeat L+rI! 5@s/--setup S: $be1d oy&lyDg'pass'm Execution time of this setup statement is NOT$d. -p/--process: use._L() (defaul?.perf_counter())Iv/--verbose: print rawOing results; repeat for more digits precisionKu/--unit: the outputM e p (nsec,Ac, m aor sech/--help usage mesand exitp-iparate opEfs from8jV when rts with - f: R to bUdG'pass') A multi-line50may6given by specifyIQeach /sas a se@argu; indented&s are possibleL`enclosK4an 6 in quotes u @lead(spaces. Meple -s(are treaqsimilarly. If -noAnot , a suita`numberPloops)acalculIPby trq increa3sequence 1, 2, 5, 10, 20, 50, ... untilAb total@is at least 0.25onds. Note:/ rea certain basetoverhead associ`execut. a  . It differs between verVThe code here doesn't to hide it, but you should awof it. Fcan be measuredPinvokCqprogramDout  Classes: Timer Func!it(string, ) -> floa^ $2lis#`p'r(@ """ import gc 4sys  itertools __all__ = ["@", ", it  {"] dummy_src_name = "<8t-src>" 1Q = 10\E = 5A1r = = _globals = ` # Do`changea|6@temp0;!"re() calls #.__init__() depend on\Pup be ;Red 4 lstmt ##8#$. $" inner(_{z1}):E{} b_t0 = %(  _i2_it2{{5_B1Breturn _t1 - _t0?Edef Csrc,N"""Helper(/ a.jsrc.replace("\nQ\n" + " "*V@) cKC1"""_0timC@peedRsmallsnippets.5nstructor takes a statement to be timed, an additional )used for setup,1d a9`r func5v. Both6sEadefaull'pass'; thu< is platform-dependA(seeEmodule doc string). If 'globals'Apspecifibcode will bEexecuted within that namespace (as oppoto insid2it'-1). To measureb1ion1 ofVfirstA, us/B}it() method. The repeaa convenience2calCbultipls and return a listtresults&hePs mayftain newlines, as longthey don't(my-/ literals. 2"""0 def __init__(self, stmt=""",_#r=A_,Pu=None): """Constructor. See classG.J.f! =rMlocal_ns = {}z_ ss() if T else?V = ''f isinstance(l7strr# Check0cancompiled outahE(fdummy_src_0, ")")3prefix =f + '\nYa = reib4MPelif 3abl q1['_P$']s Cb+= ', (= 5tmtoh&();P-raise ValueError("qneither_E norHi0tmtK+o/,  8?tmt2tmt?tmt _gx*?tmt0src em e.0at(= , =HFq # Save?traceback display %= /rc(9,\T_ns, ;self.inner =( local_ns["inner"] def print_exc(self, file=None):$("""Helper to1 a traceback from the timed code.a=Typical use:t = Timer(...) # outsideRry/except(6try t.%itN# or t.repea EXH)The advantage ovhe standardis that source linesz!incompiled template will be displayedDhe optional argument directs wher4iwsent; itPaultssys.stderr.5""" aimportfcache,$ f 9.src is not > WB.[dummy_src_name] = (lenI%),_s5.split("\n"z )R# elsis already stored some,k[., number=def_ m" 'p' execuTAs of@main te[o`precis3his?eve setup; once, andthen return30takEoQEaimes, as a float measuXeconds. The@6eN throughTloop,/5ingEto one millionb ;,B  /`r func be'd are pass oLconstructoNitertoolsgcold = gc.isenabled(@.dis stiming =XB(it,rRkfinall1if +2gc.;4 @Call\Peit()Q!ews convenienceFcallMSedly,?`a list0resPUfirstEspecifies how many=|w, defaulting sto 5; the second argument specifies Utimer, defaultingEo one million. Note: it's temp5 to calculate mean and standard deviationEAfromresult vector6`report se. However, this is notGvery useful. In a typical case5e lowest value gives aBr bound for how fast your machine can runBen codeEsnippet; higherk2s i1 $re)lycaused by variabilityEPython'sped, but&Uotherprocessewterfering with0timaccuracy. SoUmin()G!ofis probably onPumberV should b  interested in. After that,2alook af entirB apply common sense raQn`tistics.5""" er = []iPrange(repeat): >t = self."Ait(n$r.append(treturn r'def autoiP, lback=NonevB"""R=p of loops taken s7Qotal g>= 0.2FCallit method pincreas k%s vsequenc1, 2, 5, 10, 20, 50, ... until is le=50.2W2. #s U,_=)qIf *cal-*Q B, it will b`lled alxeach trial5twoTs: ``e/``SUi = 1cwhile TrueFjjjB D} = i * jQW1%ifam! 'if bWC Vi *= 10 it(stmt="pass", setup"#r=_,P?!, globalsc"""ConveniP func reT aobjectp+<.V3r)@r8Blt_repeat, number=default_nP, globals=None): """Convenience function to create Timer object and call repeat method.""" Nbreturn3(stmt, setup, tF").@(", ) def main(arg, *, _wrap_E Main program, used when run as a script. `The op@al 'd' argument specifies the command linebe parsed,J\0ingsys.argv[1:]kvalue is an exit codTs0to Da(); itepmay be fPindicssuccessjW[!ce happens duriming, a tracebackprinted tomastderr c1. Exbs at othersAq(includrhe templpcompilav) are not caugh''0an Brnal Bfacefor unit testing. If1!is]1, it mustBaable that acTr'! (i !).@ if\sq'x! =59import getop6try7Ropts,S=%.,., "n:u:s:r:tcpvh"q"["|Q=", " =D "FAPclock 0pro@pverbose:qhelp"])eyPerror6errB(err3"use -h/--S  "5" 22Cr =  = "\n".jo) or "pass] = 0 # auto-determineEQ = []wo$L_.! ="s = {"nsec": 1e-9, U6, "m31.0}C`precis1= 32o? in>stif o in ("-n"--"_ =&(al@s@ ?.d?u? >HaFelseUUnrecognized. Please select 0c, q,Osec.Pfile=%u >r", "--repeat")7: repeat = int(a)3if J<= 08C5= 17 if o in ("-p", "--process")@timer = .$_ KvK|verboseK3if  cprecision +4 huLhelpr pr.__doc__, end=' '=return 0setup = "\n".join() or "pass" (6# Include the current directory, so that local imports work (sys.pathJcontainsKC of this script, ratherVn*uE8q1 osq.insert(0, os.curdir0qf _wrapr is not None )()T.q(stmt, :,9f@numbP # determine !@0.2 <= totalKR < 2.callback =lDdef 4(lk_takenJ0msg {num} loop{s} -> {secs:.{@}g} ":plural = mR != 1tmsg.format.=s='s' if Melse '',mN= , =m)6tryA~_.autorange(>;jexcept>!t.V_exc(*Xp15B(^0rawAings(,Dw  %fGe(dt0uniU >scale = & s[] C.![( ,8Q) for !, Ks.items()Tts.sort(reverse=True"TNeTs+if dt >=~ $Vbreak^"%.*g %s" % (,O/N~A"raw #s:OGmap(8,)J3timKS[dt /@i dt p]0bes0min>KW1"%d+A%s, *Pof %dA per+%, 's' if number != 1 else '',  repeat, format_time(best))) * = min(timings)Pworst*ax2if 1>= =A* 4:3ximport warnL. %_explicit("The test results are likely unreliable. "JfJ (%s) was more than four sObslower92the=Z.8% (t) RUserWP," 0return None if __name__ == "__main__"sys.exit(.()) """Token constants.""" # Auto-generated by Tools/scripts/ _t?.py __allxa ['tok', 'ISTERMINAL:NONEOF'] ENDMARKER = 0 NAME = 1 NUMB2 STRING = 3 NEWLIN"4 INDENT = 5 DE P6 LPAJ27 R 8 LSQB = 9 R 10 COLONgp1 COMMA `2 SEMI `3 PLUS R4 MIN A5 STZ16 SLASH B7 VBQ8 AMP`19 LES?20 GREAT21 EQUAL = 22 DOr23 PERC24 LBRACE25 R E6 EQ;U7 NOT8k9pp30 TILDS31 CIRCUMFLEXL2 LEFTSHIFv33 RIGH4 DOUBLE!35Y678"9"40/1I23456(47'08 AE49 Ag50 RARROWl1 ELLIPSI"52K?P53 OP&`4 AWAIJ55 ASYNC6 TYPE_IGNOR"5758 SOFT_KEYWORD59 # Thesebn't us!C izer but#p neededERRORTOKE6"MMu@61 N62 ENCODmQ63 N_0 64 # Special definitionsg@coop2 ion with parser NT_OFFSET256  = {value:  1for!, " in globals().items(,aif isi1ce(5, int) and notOp.startsd('_')}.extend(.Bs'b EXACT_ {d'!=': S'%': &%A&': 1(&@(': %)': RPAR, '*': STAR, '**': DOUBLES=TEQUAL2,+': PLUS$+$$,': COMMA%u-': MIN5-58MIN4->': RARROW6.T.tELLIPSI~/': SLASH%/ qy/E:3LONZ:&ICOLO;3EMI%t<': LES<dFTSHIF <% *+IRIGH>/2T@': A@W(AT [3SQB]^FIRCUMFLEX$^FCN{NSBRACE,e|': VB|;5}t5~': TILDE, } def ISTERMINAL(x):return x < NT_OFFSET-?NON0.>=1>EOFY*== ENDMARKER """Tokenization help for Python programs. t(e(readline) is a generator that breakstream of bytes into WLs. It decodes the*according to PEP-0263 determinsource file enco1. It accept-like method whichcalled repeatedlyp0get` next input (or b""R EOF)es 5-tuples withEse members:  type (see K.py)"(a stringPstart(row, column) indicesaB(a 2FintsH en- F,original&(is designedTAmatc workingizer exactly, ex Sit produ2ENT6s`commen`nd givL^!OPball ops@Addi alh2allLq lists can ENCODING# :tells youJ}r was us.r __author__ = 'Ka-PYee ' __credits+('GvR, ESR, Tim Ps, Thomas Wouters, Fred Drake, 'Xl 'Skip Montanaro, Raymond Het^er, Trent NelsonCMichael Foord') from builtins import open as _n_open from codecs import lookup, BOM_UTF8 collectionsfunctools from ioDTextIOWrapper.Aiter.U as _$re #syQTtokenT*e 4EXACT_TOKEN_TYPES cookie_re = re.compile(r'^[ \t\f]*#.*?coding[:=]]*([-\w.]+)',6ASCII) blankKbL(?:[#\r\n]|$< __all__ = .A+ ["ize", "generate_sdetect_enO", 1"un:OTAInfo"] del} class (.namedtuple('"', 'type string start end line')):def __repr__(selfannotated_I= '%d (%s)' % -.,_[A!])^Fwreturn (6C=%s,0=%r 1art 1end0=%rnMQiBlaceP 1)) 5@propertyQexact1if X == OP andF=in I &G].Oelse@ group(*choices): g'(' + '|'.join( !)':?any8 P0*0_maybe2?' # Note: we use uni` matchw@for s ("\w") but ascii$ # number lfals. Whitespac'[ \f\t]*' Comment.A'#[^q*' IgnoD9 + r'\\\r?\n-B) + RR) Namn\w+' Hex= r'0[xX](?:_?[0-9a-fA-F])+' Bin'$bB'1 9Oct $oO !-7!7Dec!A(?:0g0)*|[1-9.9])*)' InP%, %, x%, bt) Expon@[eE][-+] h' Pointfloakh r' ( \.R0/?'Mr'\.C'|v, FAQ, ExpKk) Imag)]x[jJ]', WA+ r'2) N"= iS 2%, )'Rthe empty, plus all of Svalid prefixes. def _all_string_prefixes(): # The valid string #. Only contain the lower case versions,G and don't2any permutat+ (include 'fr', but notAc'rf').Zrious>will be generated.:__ = ['b', 'j 'u fbAfr']># if we add binary f-L s,Q: ['fI$fb5result = {''}G3for8O in qu.t)itertools.)(2 # create a list with upper| of each># characteruroduct(*[(c, c.j@()) -c-+t]d.add(''.join(u))nrreturn "r @func lru_cache def _compile(exprc<., re.UNICODE) # Note that since _allsSemptya, # SP(@ cans)P (mak,Pit opYal). ;= group(*!()Tail end' . Single = r"[^'\\]*(?:\\. x)*'" # <"<BDoub<H'[^"< K)*"'<,''z3{~|'(?!''))'"MM`"(?!""M""' Trip; P+ "'''",+ '"""') # 7-line ' or I + r"'[^\njl ? '"?oASort0e order putplong opors befor$eiZes. # Otherwised= came-==, == would get recognized as two instances #t=. Special*map(re.escape, sorted(EXACT_TOKEN_TYPES{=True))) FunnyHr'\r?\n', b) PlainToken'Number, =, Name) +0Ign &+ A # First (or only) ,ofuContStrs  1" +"Br'\\)& r' 'hW'"', h) PseudoExtras"|\Z', Comment, Triple) PseudoToken = Whitespace + group(PseudoExtras, Number, Funny, ContStr, Name) # For a given string prefix plus quotes, endpats maps it to a regex # to match the remainder of thatX3. _Zcan be empty, forD a normal single or triple dF (with no M4). = {} forhin _all_s~es(): 8[ + "'"] = S$0'"'$oDouble$8"''J3'8'""M3 # A set:0all4the?and 0es,H`includ;@open D2s. ]_0d =m2() i K/t E %u%(t + '"', 3"'"fj vq.add(u) >"@'B B tabsize = 8 class Error(Exception): pass#AStop'_izing'K0Untgaizer: def __init__(selfAelf.1as = []1prev_row = 1zcol = 0Aencof= NoneUadd_ww, startRrow, X\0if < .!or=&lfvG02colCraise Value|"t ({},{})Pcedes Pvious}"K  .f$t(,Bcol)YFprow_offP=-:w, $.append("\\\n" *S4tx4X83col2! =8col, 1!) Iu'iterable*Pit = (@lindentk0linyBFals/3*itif len(t) == 294compat(t, itS#Ubreaktok_type, t#, t2 if+5ENCODINGa Kvcontinu d~DMARKERe <cINDENT9 indents.append(token) continue elif tok_type == DEDENT:%IidNpop(\self.prev_row, col = endQin (NEWLINE, NL)startline = Tr"Cand I$ ="M[-1]1if O[1] >= len(840 [/E6` 0JFalsyadd_whitespace(2 ' &P9^ += 1#0"return "".join(!) %def compat,en, iterableVs = [Rtoks_V" =!e"L[0] .Mstring = 0for=_tools.chain([[]atoknum vaxftok[:2%0numENCODINGMRencodetokvalJ d AMWUMBERr?Z2' '# Insert a  between two consecutive Nso== STR6if p= ' ' + F.se^ 4 zG_== IN :valL #ZSs@G@) N!un@ize(E"""Transform%ens back into Python source code.2It s a bytes object, }Ped usDthe :token, which is the first token sequence output byize. Each element returned(he iterable must be a?XCwith at leay$woP%s,1number andBvalue. IfDonly twos are passed,resultingsis poorRound-trip invariant for full input:h!Unized source will match-rexactly+erlimited;h4# Ov2tesdz back tot1 = [tok[:2]btok inize(f.readline)]7newcode = uE(t1)!4 = BytesIO(4)P-/t2 O0rt A= t2M1"""Vut = z"r(o7ut.v"if ut.encodis not NonejFo($e( 2ingF= def _get_normal_name(orig_enc)W"""Imita +Dr.c.0# Oc ab12 characters.denc = w[:12].lower(place("_", "-"1if 5= "utf-8" orp.starts(#-"Jin ("latin-1iiso-8859)k\, tD-EF?-")u``detect(~<LThe +) function"0use&\that shouldN6be /]a Python 1fil;quires one arguQ$, ,Qhe same way a() generat"It8EcallM a maximum of twice,[;w}(as a str/`a listD@any Pps (leftb$) it has{3 ino#It@lAfromSBpresxAf a @ bomE an?`cookierqspecifiI pep-0263#0 bocCC$a 6'ltbbut disagre SyntaxErrorIbe raisedY +UQis anL1lidBset,;( aW. Note =i@is f'P-sig'$edTEf no!nYadefaul'utf-8' will be returned. """Atry: filename = readline.__self__.*except AttributeErrorEANone3bom_found = Falsencoding = *default = 'utf-8'@1def_or_stop()p 0!()CStopIterationI"<Ab'' 6yfind_cookie(Q| # Decode as UTF-8. Either the >u is an Rdecla,s# in which case it should be pure ASCII, or@mustv IDper YyiB_str!.d( E0Uni R ms"invalid@miss` 85if ais not! )e '{} for {!r}'.format(msg,F6raise Syntax-) match = A_re.%Q!if" L[= _get_n l_\(C.group(1)b xc = lookup(T2L  # This behaviour mimicsPython interpreterM  \v"unknowU: " + WOelseHT: {}"2 F) 5if  %if% ! $bo(?s)w' problem: J(uJyS |F^+= '-sigC"@firs!O+rst.startswith(BOM_UTF8b = Trup[A[3:]V?37B, []8 = X>>V O>1, [2Vblankfirst): %return default, [first] second = read_or_stop()cif not#:3P encoding = find_cookie(gW& U,~{% def open(filename)d"""Open a 1 in only mode usDthe detected by_ 1().1"""buffer = _builtin_b, 'rb'2tryPP, lines =yiZ.#D;fseek(0text = TextIOWrapper(,,o_ing=TrueD.Q= 'r'scfexceptPc.closeH7aaise tokenize(?IEThe $) generator requires one argument,q, which must be a callable object$ provides same interface aG() method of 2-inKWs. Eacho1 toXfunctionKsshould @PPinputv@byteIAlternativelyG;canf` termi7ng with StopIt=2iond1ead|=+ my.__next__ # Examp;3f aeoAproduces 5-tuplesthese members:` type;string; a 2E (srow, scol)1ts specifyqrow andHcolumn where]Np beginsYourcegegegK/ink gV , <!, \D _qU)+6$Slnum = parenlev =Atinu0cpnumchar'0123456789Vcontstr, need r = '', : a= NoneN@indeC= [0%if is not None:   if encoding == "utf-8-sig": !# BOM will already have been stripped.3XW" yield TokenInfo(ENCODING,, (0, 0)1'')@last_line = b'' while True:# loop over U1s i1eamZ91str0, (1d),ME}e`, need = '', 0weK=6 elB2and-2:] != '\\\n' 3Nr\n'@ ERRORTOKEN3str   T   9;elsh+=  ;)|+Eparenlev0M-d: # new statement?!oty: break`column . <`# meas1lea,whitespacP[pos]/' :)  G/\tH 2= (R//tabsize + 1)*  elif line[pos] == '\f': column = 0Oelse5]break0pos += 10if n== maxNJ 2in '#\r\n': # skip comments or blanksN6 # QP_toke:].rstrip(')cgpyield T<Info(COMMENT,W,<@ (lnum,2'), s + len(H1)),t/+=6  "NLY=/:]8continue3if P> indJ[-1]Tcount!de* B.append(Z+ 1IND [:>0}Twhile< no.#qraise IationError(V,2"un` does cmatch any outerpM level"1("<uize>", ))X}3s =gjs[:-1] "DE%''x?poszN $# ypd state<E<!if*}"EOF in multi-5W"0s;<)bpseudo= _compile(P!).(?ZDS # scan for Rstart, end = [~.span(1qspos, e=JAend)X if_ rt>end%^ >, initial =;[}R:end]Dif (<in numcharyw# ordinary'=ber.Nb.' andl^ != '_..'))D TokenInfo(NUMBER, token, spos, e{line) elif initial in '\r\n':(7if parenlev > 0%)pyield TInfo(NLAOelse_oEWLINEd _== '#assert notT.endswith("\n"P COMMENTtriple_quotedendprog = _compile(Aats[G]endmatch = /Arog.(._, pos8 if0+:# all on one S 92posTf/(0{2! =S[start:pos]^ kSTRINGR(lnum,Z 1str3 = P)`# multfszcontstr/d0Wmbreak # Check up to the first 3 chars of{to see ifG'Ay'reuhe sing set. If so,) Ga string. Weau[F, because w!looking forE "rb'" (for example) atQ E0we  ch7longer prefixesis needs/beBadjustedNote that"==O[:1]2@Also7#1le < cmust come afteu 9~(above)yR(Jy P@[:2]/434)#if4@-1]  # DSinued| /1# Again,  `@. This is or the matching end # regex for the correct type of quote? character. So it's really look?forA endpats["'"] or'"'], by tryG/toF skip str*uprefix s, if any.Brog = _compile(ats.get(initial) bCtoken[1]D/O2]))contstr, need  = line[start:], 1< ,3(_break_else:  # ordinaryM5pyield T<Info(STRING, N, spos, e-) JSelif .isidentifier()?nam ONAME == '\\'0 # inued stmt(#=8 in '([{':)eparenlev +e" Q?)]}Q-Q g/OPe OERRORTOKEN,_pos], (lnum, pos), 2+1)B2pos1W # Add an implicit NEWLINEyinput doesn't"onif last_F and[-1] not.a'\r\n' 2.Ap().swith("#") C, '' - 1, len(W) 0 + "''_ in| ^s[1:]# pop remain-q levelsLr gDEDENT4, 0  :ENDMARKER= def generate_`s(readN1"""ize a sourcedPython code as uni Bngs.This hassame API/q ize(), except that it expect3*readline* + callable to return str objects instead of bytes. """1_tokenize(readline, None) def main():2import argparse # Helper error hanEg routines%Jp!(messageSsys.stderr.write#;"R'\n')[ Z, filename=, locationx%ifkargs = (HE,) ++4 + %,)7`"%s:%dp: %s" %7s1Eelif H B FQ/seH9~cexit(1Q0# P@ theuments and opG0r =# A.Arg,>r(prog='python -m g'4sr.add_a9t(dest='v@', nU='?',ivmetavar7?.py/`help='g8; defaults@stdick'-e', '--exact',  ac*='store_truerdisplay( qs usingYS type@3 = I#s(6try3# TMUinputR if s.w7&?%with _builtin_open'rb') as fZ9}lQlist($f.).,,el!"<>/Q_+c2# Output,C!izA3for"in s6_" =!. Agx ?C*V I*range = "%d,%d-:xW.start +6endZoprint("%-20s%-15Ir" %k*" R_r,Q_8[]en.stringexcept IndentQE3 ascolumn =.[1][1:3](7&0]8, (F  {v.oSyntaxw3$OS8 err:  error(err) except KeyboardInterrupt:"print("iYed\n"=ED`ion as`<n"unexpected or: %s" % Jiraise if __name__ == "__main__"W N() #!/usr/bin/env python3 # portions copyright 2001, Autonomous Zones Industries, Inc., all 3`s... #... reserved and offered to the public underterms of A # P 2.2 licenseZ@AuthZooko O'Whielacronx # http://z.com/ # mailto:@h # # C0, Mojam MediaSkip MontanaroU1999, BioreasonSAndrew DalkeQb5-1997omatrixW 1Y5, Stichting Mathematisch CentrumpPermissqto use,L, modify, di;bute thissoftware$ # its associadocumenta) for any purpose without fee is hereby # granted, provid{0hat_a above notice appears in copies, # t=Bboth '="ndpX in # supk9ng e qneither& #U8 or0 beydpdvertis#orpity pertainUto #  ]specific, written priW. # """program/moduleDraceAfuncPexecu q Sampl= mm9@linetH.py -c -f counts --ignore-dir '$prefix' spam,veggs <t2-=jkcallsW 1+`y im sys # create a T object, tell@it wd2to 1whe!toE!do10or - .1r =-!e.r(Wdirs=[sys.base_2,%],l0e=0Punt=1Q# runabnew couRgivenrb.run(''F0mak' re@a, placPutputu/tmp r.results(A r.$e_Qshow_ang=Truverdir="K ")` __all? ['Trace', 'CoverageResults'] import linecache$os (sy dconfigYtoken %izCtinspect$gc %diRpickle from time monotonic as _threading PRAGMA_NOCOVER = "#pragma NO +" class _Ignore: def __init__(self, modules=None, dir )15(._mods = set() if not<Q elseM)m<VT = []96[os.path.norm &(d>B for d in]wi = { '': 1 } *Snames @file #iftf/xreturn ![<])# haven't seen this one before, so73the D1 isEo;"e e list.: # IdenticalXstICeI = 1)1[checkis a proper sub of something onZ # !mo# Need to takea care sinc7X,# "cmp" mustBmeana7U" but vR"SpamCk also Ef.Eggs" .startswith(W+ '.'1"m -BNow Tthat 0 is!in!ofdirectorie(if4 Q #M be a built-ino"we E! a when it containizPable ][ The '+ os.sep' ishqensure Ida parent:)y,#0com&cases lik@# d/usr/local"I$6= "'<.py*,or; [4^$d +A0Trihe different ways, so we don't ignore this module bself._![name] = 0%return 0 def _mod$q(path):&B"""R%a plausiblel - for the 5Q.""" 8base = os..["@fileW, ext+splitext(4)+2Ofull8A# Ifg '' is part of a package,&n +a isn't# enough to uniquely identify it. Try!doDPrightSng byDlooking in syDilongest match%prefix. We'llBPassuma]0e r3!iss.pcomparenormcase~A= ""k8dir;O2dir$7if ~.startswith('H and A[len1] =Z6seppP$0 > $b = dir 3if W! =!q) + 1:]Oelse1#xdrive letter[UneveraE82#, N#%$.replace(os.sep, "."p if9alt64! =f;'>.lstrip( class CoverageResults=_init__( , counts=None, calledfunc in40r,5out-h.g# =pK8if 0is c) !E= {}=:Her =(.copy() # map (J, lineno)" L'l& z $rs%rs /rs D K~m2 = 9 6 #merge exists.I:tryBQ open.i, 'rb') as f3 counts, calledfuncs, callers = pickle.load(f) self.update( __class__(countL Y)Jexcept (OSError, EOF QValue ) as err:print(("Skipping { file %r: %s"5 "% in=,p1)),J=sys.stderr) Odef is_ignored_22nam 4)"""Return True if the]) does not refer to ampwe wanthave reported."&""rk.startswith('<') and_|C.end'>'z, otherMerge indata from an, CoverageResults!= 74 " 'E#%rs_[" =. $:]).wb."rspfor key" %s[key] =.get(key, 0) +=)c  hDO = 1H /rsD+rs@rwrite_r<, show_missing=, summary=False, cdir=NoneRlWZX.Cage g.i:paramr: Show lines that had no hits*:: Includem per module=dir: If , of each> are placed&it directoryuwise it is iD>+9 J specifi(#if) ` "0Rtions3:d:"'Gf /,. , _ 1s(R3$("IMQ*@4% (FB#))#5 ? 9 "ArelaCLhips@@last0 = c A0((p, pmod, pA), (31, cc5) \ in sorted(self.callers): if pfile != last &5}print()Bb"***",P!, /i" =-T%c] = ""#2if !EA and  " -->",JI" =' "%s.%s -> " % (pmodaunc, c cfunc)) J # turn the counts data ("(name, lineno)#") into somethingMaccessible on a per-Ie basis)Aper_E= {}@for v OH{sSPs_hitS[B]G.get*{}qH[ no;u[;!()]Baccumulate summary info, if neededQsums  #{.items(@1if is_ignoredP: 3%continue%ifw.endswith(".pyc"D`% =6G[:-1Tcoverdir is None%= os.path.dir0abs A`module6p = _mod 1d,?els 15%otexists(dir0os.makedir& QmNfull 5 # If desired, get a list of numbers which representIpexecuta pent (reed as a dict better lookup speed~how_missing`lnotabVfind_|_?nosN/psource =Pcacheb`X z@join', A+ ".-"U openp, 'rb')C.fp encoding, _ = tokenize.detect_(fp.read qnAs, n:?write_results(", ,1o,$, and n_lines:+ percent = int(100 * n_hits / n_lines)6sums[modulename] =,#, R&, B, fi*% Lif summary and %s: pr" cov% V (path)"for m in sorted()W[ ! =9[m]A%5d %3d% %sd%s)" %:)pelf.out 4# t tore countsHP info7o sF :tryVwith open(8, 'wb') as f48pickle.dump(;,calledfuncsIrs),K Jf, 1except OSError>errwCan't sav(Qs because %s2erry=sys.stderrdef write_results_A , X!, w, lnotab, encoding=None]"""Return acerage `]E."""$B# ``e `` is a dict of executable number ""d m" =W, "w"("trace: Could notg@ %r cing: %s "- skipping , )82 ryF0, 0 E = 0ons!"noenumerate(s# do the blank/commematch toto mark mLq# (helpJreader fi,tuff that has Bbeenu&edH!if6n@ s01.e("%5d: 7[ >no]g?`M+= 1 ?/s !*el|ZPRAGMA_NOCOVERK# Highlight never-N"ed, unless[G contains# #pragma: NO ( =>  /se dJ/ d)write(line.expandtabs(8)) return n_hits, n_lines def _find_from_code(, strs):GB"""RFdict where keys are Pb in th  number table."""E'nos = {}afor _,@ noA@dis.+astarts$if/0not3=Bnos[R] = 1o k4 @all & objects reach G`# get 3%of$formation6@V(is scope levelC# and checkzconstants references to othert)cjA.co_Dstif inspect.is%'(c # = anc, so recurse into itv7ys.update(#(c)1strings(filename, encoding=Noneaof possible docFi"s.a2The/AmapsS5Qs. T3is an entry that contains only aing or a part of a triple-quotedBf. mdgC0# IOe first token a,`n it's X moduY# Add thpecial case1tes loop passesAprev_ttype =q.INDENTwith openf) as fz4tokLize.generate_s(f.read`# `, tstrC0artd6toke61if 5$ =jSTRING&*//3s,Al = e(0eco("en" icrange(]<C + 1* 2d[i-ndFQexecuQ&nosvdIG=N6tryO> G 4rprog = (l  except OSErrVs errprint(("Not coverage datar %r: %sp(% `rr)), =sys.stderr return {} code = compile(prog, filename, "exec")+strs = _find_strings(+encoding-creturn-`lines(k , F) class Trace:^def __init__(self, count=1, t' sfuncs=0 `callerGignoremods=(), 3dirn=None, outJtiming=False)f5""",b@param true iff it shouldnumber of times eachCS5@ is Euted&iiPprint] Huthat isDf Rbeinggsl1juskput a liff+Dmodubl`) for OtionQwere d at leawnce; This overrideE`q' and `G']+:P the sCs toXCnCdirectorieG0allu(recursive) content  from whichread store~%beBv added intofresultY0?o&inm_write: Z\pinforma  be display{/".i"= = I3(7UG{} # keys are ~ =pathtobasjq = {} #`memoiz0os.'.& `donoth(:= 0" =9 _9h{":`r_cach4 `start_0 = VZi6ing:V 6>(*"if/rs?dglobal_k>$elXV< TneW"Y%ltQ!;locae_and_r> self.globaltrace = self.globalW_lt  3loc2_74elif count:OHhI{hgJelseu # Ahem -- do nothing? Okay.7#do#Q = 1 def run(f, cmd)aimport __main__0Ledict =0.__!M.runctx(cmd, )w!-z", +s=None,  f'@ is *:E= {}#ifB(R '2not& threading.set /U)w1?sys+:tryiBexec1 _kfinall8 if :W)-Afunc , , /, *args, **kwPresul,ECeB%q(~BDrreturn file_module_ttion_of?Grame00codf0.f_Plenam @.co_]$4if  Z,0mod (,b :nH4 =  0cls! =?Rde in_caller_cach/if#[m] c{_.c@3 i-## use of gc.get_referrers() was suggested by Michael HudsonIA allP#s which N to thisfj objecs = [f for f[ 6s i6spect.isQK(f)]require len('`) == 1avoid ambiguity causKs toK@new.Cj): "In the f&ofK,g;theD`temptaB to guess."  if len(funcs) == 1: dicts = [d for d in gc.get_referrersBM[0])?H if isinstance(d, ]-)]5PaclasseccHR if hasattr(c, "__bases__"2F*q# dittoAnew.7Oobj(:clsname = -es[0].__-__;e# cache the result - assumption is that O* isInot called later to disturb this relaUOshipH_E"r_could be flushedyI? inInew module ge.5Yself.a[code]V`;4if s0is JNone = "%s.%s" % (7$, %) Vreturn file9, 0/def globaltrace_k< s(, frame, why, arg)"""Handlerd7 events.^Adds inform about who !to>r;sg5""" ifF'v's# XXX Shdo a betM job of identifying methodi_(1 = J!_m8A_of( Naparent&>z.f_backEuB7s[(T,_)Q1i Pcount9(E  g )/d') [N9/lt3!If block beoPenters.be ignored, 0s `%',Eelse3loc!=0.f_l= $!s@('__"P__', !ifvname:  &# XXX _modname() doesn't work right for packages, so > # the ignore supporAG C`module& ="fi)07if 3is not None:+_it = self..q$s(g,TsHfi>?_itn*iOtrac'print((" ---: %s, func"C6% (, code.co_D/))>breturnQlocal q?els9| /Fdef B_H_and_count(, frame, why, arg)I if == "line"# recordr P and . number of every ~>54=4.f_$ 0W6no . $0key!,n(.ds[key].get(key, 0) + 1J"ifstart_timE'%.2f' % ('L() -;), end=' ' bos.path.bas /pq"%s(%d)vE,$MPcache oF)tTk5u R*w,/Jtreturn self.localtrace def results(self):return CoverageR&.counts, infile=:. ,@D6out4 5calledfuncsm_>r:Prs) Smain(import argpars" 5r =.ArgumentP%1r()'c.add_a ('--version', action=' !='b 2.0')ogrp = S_group('Main opR*s''One of these (or --re) must be givenm qc', '--store_truetphelp='Cxq numberimes each line is executed and write 'C -Q'the s to .cB forUTN, \'s directory. See also verdir, --,JC--noQ below.'. will be written\ Ce/E/E.m missing', action='store_truePAnnotexecutable lines that wBnot ed with!">/ "ssummaryWrite a brief ? nAeachUsys.stdout.Can only$us!--Zb or --Zo'--timfqPrefix ^Fltime sinc{program startedOh(0raco = parserxp_group(]Kters'be specified multipOimes-ignore-append', default=[],7I?{bgiven I(s) and its subs(if it is a ). Accepts comma separated list ofJfQ name[WlGs ind((pies canjoined by os.pathsep)>('-.ZFalse@TracA#. /yb', nargs='?T"run as main <?ram_ ho`1arg.REMAINDERo8tloMZQ#s(y0if #.Q_dir:8)"_p= sysconfig.get_("stdlib"/p4 Eplat8h2def_6(s)4s =.expanduser(1vvars(s)s = s.replace('$prefix', _ ).replacCexec!3) return os.path.norm A(s) $opts.ignore_module = [mod.strip(JQfor i in E0modi.split(',')]u0dirrcparse_0dirk [ wGsrRsep)]"ifqreport:\bif notFfiler.error('-r/--A requires -f/--:'2results = CoverageR0(in+=8 P, out GNs.write_(Cmissing,ssummaryc{3dirQany([<Utrace,3unt listfuncs(kcalls]) must specify one of --:qe, --co_=5, 'f8'--~rD~'*R and i2 or0canWboth VS)v0Q.$--4can only be used wi?up uprogname is Non (-:nbthe maDionskPt = T$[1e, +,)C2ers+", 3mod K$diIm_dir, ] k, timing 6try<m' imPi runpyo-_= (%`, mod_YdUS._get _details(]sys.argvZcode.co__1, *arguments7@glob{!'___': '__-<__' l( }Vqpackage1.parent^jloader//M -&acached(J $}7elsflYi 8U[0] =dirname(opts.progname) with open(opts&, 'rb') as fp:2= code = compile(fp.read(), Fiexec')A # try to emulate __main__ Pspacex@muchpossibleDglobs = {'__file__':+r+'/',(bpackagVONone%acachedO$}Wt.runctx(F!, )except OSError6errsys.exit("Cannot run  %r because: %s" % (-argv[0], err)cSystemExit_Bpass$`resultg#t. (?0if zno_reporD.s.write_bsmissing*ssummarycoverdir) if __&==/() """Extract, format and print inion about Python stack 7es.""" im collectionsitertoolAline"sys __all__ = ['e_g5',  tb_:iono'W_only8Gliste[4 Co n50exc ep "laon" 'bclear_framesDFSrSzTracebackEFwalkItb'] # # FFting #Bs of_ s. # def _'(!ed,F=)iA"""PN@the 2XPuplesreturned by K_tb() or9(Na8teddBgive!if@ is  = Rstdertfor item in qQ.from ").u([(Gl, end="")G6R2""", a<8or  objectsBing.GB7as  ,1`stringJ1adyDVREach *l correspondsS t"thsame indexFargument58. ieLin a new;} s may contain internal newlines as well, for those items wsource text 5 is not None.(1"""return StackSummary.from_list(extracted).format() # # Printing and E+Tracebacks. # def p+_tb(tb, limit=a, file !):1"""W up to ',0' s e entries B thepq 'tb'. I%If=is omitted orU, allI2arePed. 9'G<toutput goessys.stderr; otherwiseA'L should be an open -like object with a write()EjmethodS `:)be) ,A0rthd'3lK))'.Q: gF* Ra4sreprese 1 of8pre-processed=4@This+auseful`alternate1mat(ofs5l6 rtA> ysa Frame=pcontainattribut$pilenameubneno, ; ="inion thatztusually)" aEe. Thes r@lead |trailing;whitespace stripped; ifavailabl' jR(walk)`Except_cause_message = (0"\nuabove eH1was0dir< x""o`follow7:\n\n") _?exto!DuYH O ,n!anoccurredn class _SF"el __"s__(self'll"" _Fel =L2Jparse_valueQexc, C, tb[Aif (O) != (tb`aise VZError("Botha0nei#Wptb must@givepF"iff lk ifH#TEaexc.__!__0&Oelse8, return va&lue, tb def print_exception(exc, /, value=_sentinel2limit=None, \ Cfile!chain=True):,@"""Px x up to 'X' stack trace entries from 'tb')_1'. OThis differ'tb() in the following ways: (1) if?gbqris not "its a header "T+(most recentFcall last):"; (2) Atype andd` afterG@; (3 1is SyntaxError@5has>appropriat[rmat,line where5! sS eToccurred with a caret oEQnext BpindicatPxaximateF@posiO1 ofg`.1"""aW = _parse_2_tb!)00if 1 isIx= sys.stderr/Ute = EL([)c!, y=, compactO4for` te.fo\(}(',=, end="")xByA &A"""F) aZ"in5ion\e arguments hav8ame mean correspond5@"toM). The return in@list:strings, eachGe\in a newd some contaiinternal%s. WhenEQtheseAs ar8catenatedNed, exactlyst!isG& as does'%<f[(R_onlyb P1para:X a :RFNAlly,>Hrsingle G; however, fo$Ps2Fs3#al/tthat (wJ) display detailed Im aboutt tmessage hWwhich26:l"ase list.  """ if value is _sentinel:Q= excte = TracebackException(type(-"),Q, None, compact=True)Dreturn list(te.format_eL+_only()) # -- not official API but folk probably use thepwo funcs. def _bPfinalhp_line(e)str = _some_str-1 or8F8b = "%s\n" % mDOelse($: , ;str6#ne U2try j j & '' % + .__name__8[p(limit=c, file Rchainy"""Shorthand for 'DS*sys.exc_info(), [V4)'.7===", )(9exc# ULike {!()oa string"".join(g yIlastp@This?a sz y]_,%, t !if#hasattr(sys, "^"z`aise VError("no *~+" ~7ypeu$) # # P@ing  ExtStacks. #@s#(fT 1"""Z 2@ack Ye from its invoca point. QThe owal 'f' argument can be d to specify an alternateB frame at which1jtart. a'''CtQs hav~ sO@mean!as!).>@if f01f =aA_getP().f_q=T?e_#(f:)+M9{/  8t)"%j WExtract the raw traceback from the current stame. The return value has3same format as 0 ex[qt_tb().;Coptional 'f' and 'limit' arguments haveVsmeaningWDaprint_\Each item in9list is a quadruple (filename,Dline number, func q text),entries areaQorderD2oldest to new 1 fr761"""/@if fQNone:f = sys._get5P().f_#N0= SSummary.\S(walkAf), J=)=.reverse(X def clear_}Rs(tb) "C all referenceslocal variables'@V of aV.while tbJnot 2trysRtb.tb.except RuntimeError=r# IgnorC.ion raised if"still executing.8hEpassRtb = next class F"""A single\P- :attr:``cH[3"no1 within = that waactive whenwas capturedom 9or methodiTBll=ncache modu] ora`of codA run;zs` Either2ps were supplied, or a dict@mapp) tot repr()7<d ?__slots__ = (' ',$@neno U_  "')R__init__(self, F,*, lookupKC=TruZ=< !"""Construct a 1&h:paramlQ: If p ``consulted fq sourceM80. OQwise,f w!beqRed upfirst needLAcalsQ' u, which`) UQ object`esentaZs"s1ineq`providM usiRPstead/Q!up)inlGhWp .Qame = filenaCme self.lineno = pname =  _.5if lookup:olocals = {k: repr(v) for k, v in l!.items()} d4else None Sdef __eq__(Z, other)if isinstance(, FrameSummary,qreturn NP.file2 ==Y1and4^67?no 4 h0 #)_tuple',   )|t=NotImplemented0get7pos? |r#no X[pos]hCitere`!([Xe(])aa("".format(QZ9=@ ,R ?len4@property[XF"if1 isq#?/no$(`cache.getR [J.strip() walk_stack(f"""Walk a  yielding the f2anumberBeach.FThis will follow f.f_back fromNSgiven5b If no *,'scurrentis used. Usuallyp with S.extract.C1"""0if  f = sys._get#()<Rwhile?;notC*1 f,!no5_ |]tb(tbze,T~1tb.tb_next (and thush ind opposite order t)l#0 tbj1t", =Ctb = _RECURSIVE_CUTOFF = 3 # Also hardcodedTtraceback.c. class StackSummary(list): """A s of frames.""" @=amethoddef extract(kY,4_gen, *, limit=None, lookup_lines=True,Dwcapture_locals=False"""Create a from a eback orbbject.Df:param : A generator that yields (neno) tuples toinclude in thev."n : D to 42alls?fnumberxnaXQ: If \o o for eachs immediatelyotherwise?is deferred until is rendered p variabWEwillG3be Qad as o representations intoFM"if = getattr(sys, 'b!',)W1not"C andm:< 0im0JF 8"/>=S = itertools.islice:mitJelselQacollecrY.dequRmaxlen=-#)zresult = &(t fnch = set@or f` co = f.f_codeA0ile\ = co.co_f & " Eds.add(?!^cache.lazy *,zglobals7b# MustZosd`we havlled check]~$if6 #f'zs8  2.append(m((v , S )3 Ds.K#!w0 wasired, triggerVs nowwzp " .4rreturn .zc _ea V'ary object f rom a supplied list of FrameSummary objects or old-style2 tuples.:5""" "# While doing a fast-path check for isinstance(a_s, Stack}G) isP4appealing, idlelib.run.cleanup_traceback and other similar code mayNbreak this by makPrbitrfss plain, so we need toL on8RAW basi!result =%()K92in :(if5+(, )04u.?1nd(4r!Nelse7filename, lineno, 1 = H K l(P =c)rreturn N f0def4mat(self"""Format the sA` ready0 printing.GR^5s astrings7r Each " !heJ: corresponds todRingle, fx6`e;@ new;may continternal2s as well, those items with source textsFor long sequences of$am_,first fewrepetitions are shown`llowed~`IPUexactL`number1fur^CyU = []GPlast_f = Non 2@coun0]  LAif (g!isP!O.#u%or_h/ DD?no B_ BB`}2if > _RECURSIVE_CUTOFF./.-=0 /#'f' [Previous aated {s} more 'Ctime{"s" 1  ""}]\n= ~++ nJP)) P6 = =H+= 11 if count > _RECURSIVE_CUTOFF: continuerow = [] .append(' File "{}", line {}, in {}\n'.format(?xframe.filename, @$no)));'if*7row c.strip()]^ocals_@for p, valuessorted(\8.items())A RQ} = {U6=q=" eresult'.join(row(if count >  '.-=(  u f' [Previousrepeated {c} more ';time{"s" 1 else ""}]\n5!rreturn class TracebackExceptiont"""An ep ready rendering. TThe tF% module captures enough attributes from the originalfPto this intermediarym to ensure that no references are held, whilstill being ableBfully print orcmat itPUse `_`7 cr/a insta7 objects,kconstructorVindividual components0- :c:`__cause__` A*of|*1!*.fJoontextL3Nsuppress_JW<>*__*DS"th 3 Pstack `S Summary` re|eg Aexc_type` $ 4<` For syntax errors -v"A whee z occurredV _umberXAend_<o\1endn` Can be `None`Cnot { [xooffsetR Wae text where tAhe error occurred.- :attr:`end_offset` For syntax 4s - the Q intotext whereP 2f Can be `None` if not present?msg}compilerarmessageBA"""  def __init__(self, exc_type Cvalu traceback, *, limit=,J2 lookup_lines=Tr=capture_locals=False, 3act DQ_seen\%):# NB: we need to accept7 toKppermit Rwards`t with existing API, otherwise w2 #stub thunk objects just`glue i geB}*# Handle/ps in __cause__ or on.&__4is_recursive_call = *1 is%&ifI8u= set()4.add(id(I")),8# TODO: ;.stack = SSummary.ex8%t(eGqwalk_tbdW)U[,JW q ^ " =7(ypC@ now$@free resources: only2lication in9# unofficialE _format_final_$0A_str0ome !%if and issubclass.1, SEC{z#`'s spe%ly-filename5. /9lno%nwR = str(lno)=` else  cw*?inekos emw   '+ X39msg,5msg%)if5 R_load@_suph4s_c}E = \^u_/"VLpConvert_Tto `T Exions`s, use ap# queuecavoid +Aon (top-level ?Cgets%== None)   if not is_recursive_call:  queue = [(self, exc_value)](awhile . AI@te, Ei.pop()=$ if (e and e.__cause__ isMNone2607id(3)1in _seen)7_ = TracebackException(g4Itypei,+%D.__t/__3alimit=%ookup_lines=l 3capture_locals=7b=Oelse}  Dif compact>need_context = (0is O@ R eZ60suppress/__ >Tru  `!F#.%&??__)@K '+F! = t+!= %IS__ = s )zLxappend((z,) XZ0#__\1)) @classmethoddef from_e1cls, *args, **kw """Create a R0 anA."""pPreturn cls(3xc)r;exc R_loade @PrivAPI. force all  in the stack to be M)edfor frame in self.stack: frame.line def __eq__(self, other)5if isinstance(, TracebackException2npreturn S.__dict__ ==^/NotImplemented3stri e6str1format_eQ_only?A"""F(U the , part oft.]RThe rvalue is a generator;strings, each ending in a new}ONAlly,qG@emitYrsingle S; however, for@SyntaxErrorbs, it Gs40al |s that (whenB0prit) display detailed inNion about wheresxEeoccurred3message indicat0whi :R@lwayee lastdMuoutput.5""" "ifqexc_typFNoneryield _`_final8_*(/,FU_str)\:se=/u.__qualname__?^smod *Xmodul(+0not("__main__", "builtins"1if 0o,B *. = "A+ '.' + qsubclassj.',  ~ g?elsBfrom_(Q) %++-l (@rnal helper).# Show exactlyBproblem was foundAfile8suffix = ''B1elf no1a' File "{}",r {}\n'.(W3b or "" &no$el7!is"_U ({}) Dtext8 0if #  foo\n1# rB2= "! lz "foo<$ .r+fp('\n' C.#.l'[ \n\f*spaces = len(/1) - D W {}\n'.format(ltext)  if self.offset is not None:(3$=2 %Jend_)no@in {s, 0} else B ]#ifG == E(or^== -14=K:+ 1) # Convert 1-based column5Cto 0index into stripped j ecolno x- 1 - spaces,0  4 ifno >= 0a# non-tb white (likes tabs) must be kept for alignment*RcaretG`= ((c 1.is"()A' ')LQc in ![:/])Vpyield 'a{}{}'.format("".join(v), ('^' * ()U" - ) + "\n")eCmsg  or ""P"{}: 4\n" stype, msg, filename_suffixg0defg, *, chain=True)A"""F the exception."If:*B*, *__cause__* and onAwill#be7tedVThe return value^a generator ofngs, eachh0inga newlinew.some contain)dternal-s. `print_`uwrapper aroundQthis method@ch jDs.as to a message indicat0whie occurredClwayX&asuoutput.6"""U = []!3excwAwhil?" Eexc.?;.2k0ed_#= ()1 n 0celif ($r c;suppress_5Wext__-s8_s} {p ='>' (.Gnd((Z,RN)9excT/fpend((None, {exc)) exc = None for msg, in reversed(output):*M if-q is notJ $Pyield' :exc.stack4'Traceback (most recent call last):\n'Wq@fromc.format(*$_exception_only() !`collecs.abc import Sequence, Iterable/functools)total_ordering ?tfnmatchlinecacheeos.pat pickle # Itypes and q1ionqlemented in C _tMUmallo*_get_object:!, Js def _6Psize(c, sign)O@unit('B', 'KiMGCTiB'3aif absOq) < 100Jj!= 'B'4# 3 digits (xx.x UNIT!if 8lreturn "%+.1f %s" % z , p FOelseCB * 1024 orlP == '  c!# "5x%0.B 1 /= class Statistic1"""p differH on memory ar between two SnapshoTqstance.NV __slots__ = ('|rcount')_init__(self, 5Aze, 1'.&& =2X#q0 =  Q" =YChashp(}%, j \)#eqTw, other[!ifBisinO(",-dNotImpj W2T1 <(,- 3str@textA"%s:3=%s2=%ig6elf,, 1, False)4l?6`paverageV"a" /. text += ", average=%s" % _format_size(, False) return text def __repr__(self):0- (''<@!% V.8 , f.; >'))sort_key;BNi) class BDiff1"""+ difference on memory allocations between an old and a newHnapshot instance.g__slots__ = ('@', ' _  !S_init,,5,OG& =I#! =\U #" =3  S_hash(#^ X,~A 2 3_eqw, other@if ns(",z1~NotImplemented 2 ==}2T1,  16+2. R 3 /st@A"%s:=%s (%s)R(%+i)  * BCD@ u3, True)7*/ J)"if?<1elfa' /. L/+=FdmJ-V#>b   2abso)Q{012+ack) def _ compare_grouped_stats(oldR, new p): !istics = []for traceback,#6 in;s.items(BFppreviouDlW.pop(GQNone)`25if 5pis not !!q = StatGDiffSM,AR.size % -z,GScountH IOelseP&"\s.append(!)   =P 0, -$z @#areturn# @total_ordering class Fram1"""V of a."__slots__ = ("_fD#",def __init__(self, ! #0 isduple: (filen str, lineno: intBelf.p" =E@propertyO|J?[0]EC1CzE__eqWother!ifisinstance(",)NotImplemented!= P l$mL<Chash- ?str9"%s:%s" % ?  , . N?repO<G3=%rO=%r>g|T@(Sequenceh6 s sorted from the oldest!tomost recenbs", '_/n',8s, /=.s{ t bs: see% constructor %he#0mat@a tuple; it is reversed, because _tracemalloc ,# returns frames sorted from most recent to oldest, but theDPython API expects-7F3cself._s= tuple(re(+))/qtotal_n8 =  +@property9def$(u!): .._M?__len__:1len)9sgetitem=w, index~if isinstance(w, slice%#F(a) for 3 in!s[O]@FelseVP <(contains+K ChashLEW#eq9w, other@hif notV"0, TGback-NotImplemented 2 ==ws/ltj<3str1str9[0]?rep5us = f" 0`-_! =,![-Q:d( >:>=95Q.if > q0 " RV.append(' File "%s"ene %s'o "% (.filename,.V'no>70 = cache.get D v.strip(K Ps ! %uC-0 bget_objectC(obj"""!Gex$` where object *obj*" was allocated. Return a Traceback instance. "None if the t,mJ module is noting memorymqions orO5did*eNHration o`bobject1"""8frames = _get_"_Q(obj)(3if +:r(-<Melse+@ class&#KaZblock__slots__ = ("2",)bdef __init__(self,H"e)i#g a tuple: (domain: int, size :+)H2See7 constructor for`format,wK." =@propertyuH?[0]CA1AF((*92:]%eqWother!if$isA(",o)NotImplemented1d!= P ChashhdJ :?str9"%s: %s" % @D2, _&_. , False)c?repd1(": !, _s(Sequencxsc3.)NsYADs: s hs'?len2lenA sgetitem=w, index7if U, sli"i!(M()T"in[O]* |VP<$containsBC U!HB:s =sO Ns len=%s>" % len(self) def _normalize_filename( t):  = os.path.57cas+*%if-.endswith('.pyc'L P[Q[:-1]CereturnG class BaseFilter_init__(self, inclusivel.& =% oGSmatchEHtracA raise NotImplementedError([,_pattern,lineno=None, all_frames=False, domainr:super()._z)bC#/ =0 ' j2 = ' = %# =@property,nN\UG_nQ_implH,Zz! if not fnl.z/, s"if=n@ is B6 9ETrue8Oelse&(J(==Y)1,|kJe@ ^ (+0Cback4u aif anyA. O5forO in 7 ]<8 : & ="[0:b| E,Zc, size, total_nCres }O( ]mAt Sand (S z3rJI%orH! H.gDm#_: sup er().__init__(inclusive) self._domain =  @property3def(4!):Fpreturn JA3a_match3w, trace:nc, sizeback, total_nframe =8 p(>2 =={) ^ (not class Snapshot1"""X2 ofns memory blocks allocated by Python.=E msg_limit#qis a tuple|,s: see _T?s constructor forz# the exact5mat.R4s =I( ~CdumpxfilenamQWrites into a 9F(4with open($], "wb") as fp5xpickle.3p, HIGHEST_PROTOCOL)@staticmethod+EloadruLoad a OfromrPp_filter_#des, exclu.;if 5 R0if G2any([.O6 2for6< inn=UFalseZ,if r 6BTrue[ssXWCreate a new instance 2Rteredas sequence,LFters;Q@listPF5Q or D^ds. IfC Sn empJ#,  @copyvsf$is{, IterablSraise TypeError("Tp must b?},"%sDd% type5fname__i VkU = []k V! kNi+  include_filters.append(trac;) ]else:%/exOAnew_mQs = [ R for in self.#s.*z~B if11(,AG  A%)]yB f.copy(return Snapshot(@,sback_limit) }def _group_by(h, key_type, cumulative)%if" not in ('^', 'filename wlineno'@M raise ValueError("unknown[: %r" % ()'ifE and7y mode canby used "3P"with >p9@stat%{}P? !ifJ .2domain, size,V, total_nframe = @>tryY0aceI; sf4except Key ]w7== r0YS` -,elcC`>[:1dPse: #%c /i(_[0][0], 0), k*@ = T6(2  E0 = S"%.1 += g&Pcount'1$RE = Statisticg,1-#XEscv p  Ptry: traceback = s[frame]6except KeyError[if key_type == 'lineno'1yQs = ( /,)*zelse: #dfilenamefg[0], 0)nD = T4=s6Rf pstat = %s[\#).size += s*Pcount+1(w = Statistic(,6, 1?breturn 1def<us(self,, cumulative=False)]1"""BWGroupH5 byE2. Rva sorted list ofHinstances.ggg edQelf._D_by(/! =}(9ed.values(),.(reverse=True=j ._"F_key?arfcompare_tofold_snapshot[t Compute the differe: with an old _ lU. Get`?as UDiff #, C5 byK?_by2new([* =O_S0ed_%s(e%, $( }Etake(`@Take&5s memory blocks alloca_by PythonLif not is_C4ingmraise Runtimew ("Y+!em\ module must beCing  P "Bations to "jmA_get_FP_limi#(GS5!s,D ) """Terminal utilities.0 # Author: Steen Lumholt. from termios import * __all__ = ["setraw", "cbreak"] # Indexes for termios list. IFLAG = 0 O 31 C 32 L 3 ISPEED = 4 O 5 CC = 6 def }(fd, when=TCSAFLUSH): """Putnal into a raw mode."""(  = tcgetattr(fd)[1] =4& ~(BRKINT | ICRNL@NPCKPSTRIP 7XONJJJWOPOST)))CSIZE | PARENB2 V| CS8[VV@ECHOPCANON AEXTE 8SIGepC][VMIND1XC@TIME05tcsK,?),7L <ZDefine nam%built-in types that aren't directly accessible as a 4@in. Ri1sysbterators in PythonOa matter ofm@ but protocol. A large # and changing numb8z@ s implement *some* flavoaC # iP. Docheck the>! Use has]B to both # "__E1__"q"__nextttributebstead.D_f(): pass FunctionTypeype(_f) Lambdalp: None)#Q# SamqJX Code= _f.__code__) MappingProxy%p.__dict'S9N5pacAsys.Sa_cell_factory(Ba = penonlocal aqreturn losure__[0] Cell g}gryield 1 Gene =g()) async %_cP_c =  CoroutinCc) _c.close() # PrevWResourceWarning_a@ _agf Aag) class _Cdm(self=iMethodC()._m) B(in`Dlen) C[].appendeaR@ Wr-rDescriptorobject.__iniSn4*@_str~+Xstr.join) C#+ type(dict._._dict__['fromkeys']) ModuleType = type(sys) try: raise !Error except&tb = sys.exc_info()[2]ATracebackDe1tb)IFram~ptb.tb_f"ZNone; del tb # For Jython, the following twos are identical GetSetDescriptorFunction.__code__) Member3pglobals6 sys, _f, _g, _C, _c, _ag # Not for export Provide a PEP 3115 compliant mechanism6class crea def new_(name, bases=(), kwds=<, exec_body)@"""CJzB object dynam8Qly usXhe appropriate meta3A."""resolved_3 = (<B, ns = prepare>O+?&if is not 5(ns4 Q9:ns['__origb__'] =SAturno X **{!) !QrB"""R6 MRO entries~as specified by!5560vs = list`updated = Falseshift = 0i2 in enumerateFRif isinstanc,gQ) and GenericAliaspJrcontinu!ifDqhasattr~, "__mro_?__"F  .@Wu.TrX{, tuple !( must re8aC"FelsehoAs[i+: +10( += len("Q) - 1'`oA)Hi; m ]1all$__<_;ahod ofT R40s (1m , Sspace as a 3-7*/* fd*Q-!d sr0+3an PT copy`passedN* argument with anyF''y removed. I <5is Wqis willKbe an empty . if kwds is sNone: kwds = {}>elsPdict(() # Don't alter the provided mappingGif 'metaclass' in ?u! =W.pop(-)A if basesAEQtype(2[0]> B0dif isinstance( , M)gp# when Q is a , we first determine most-derivl # mead of invoking9 initial candidate directly== _calculate_if hasattr'__prepare__'nD.!b(name,m@, **X O=3Rretur$Q, ns,_ def eD"""C D DA.""" winner =1foreYq'! =&1sub(Z5,.continueu ?l", J ?! =`IM ^*# rraise TypeError(" conflict: $P "3Eof afF<must be a (non-strict) ;w "of  esqall its "s"G(" DynamicCGAttribut"""Route  access on a @to __get$A__. tBThisdescriptor, used to def2Vs that act differentlyNu<hrough anUd and tC. ItqremainsOnormal, but toT QP willr"th('s9chod; tdone by agh3Pallow_e(1havpperties!1ive},+qvirtualN!Q withPsame . (Enumbetween PythonPversions 3.4 - 3.9 .)SR from toND # aw#strptreatedPperlyHiinspect module.Mris sincU 3.10B___(self, fget=F, fs 3del1doc ~:.fget = fget  self.fset =   0del5del6# next two lines make DynamicClassAttribute act the same as property f__doc__ = doc or fget.xoverwrite31uis None)# support for abstrumethods'PD__is"!bool(getattr(?, '+', False)) Xdef __get__(`, instance, ownerc =!):2 %if' !N. *.areturncUaise uError()#Aelif5.rC"unreadable 1"Y[( 5s5Zvalue+ `can't S", zmdelete7A`C5del<cgetterpfR=Q  LJelseHPresulAtype_) Cset,1Qdel, l"orN.u=- 8s7set,7 = g6 G?delf_?  _GeneratorWrapperX# TODO: Implemenis in C.6ini7genwVqd = gen:Risgen1.__ __6Typ6Aname1gen!',7Bqual"r; ?Asend_./2valASthrowBtp, *res4.__H60<OCclosQ+) @proper ty def gi_code(self):preturn .__wrapped.-&z@properKOframL.Mrunning0QyieldfromS2U!cr,$ =6  Rawait f__next__)X<Niter<$ifVisgenS !__r__ = __o }coroutine(funcQ"""Convert regular generator (tion to a @Q.""" mif not callablYaise TypeError('types.I() expects_E%')\.__class__ is FuncUA andlqgetattr3A, '___', None)F@CodeB"):lAco_flags =1dode__.+# Check if '$'!A. # (0x180 == CO_COROUTINE |ITERABLE44if 1 & E  2GENERATOR*20 # TODO: Implement this in Cf,coe(#0 - = co.replace(75=co" |]rSLC# The following primarilyusupportas that## Sq-like obj(for instancers=compiled with Cython).RDelayv@oolsq _colles_abc imor speed1up )YO V@'t+.}ssPgped(*args, **kw pn &b%@if ()C5 or/3/G/1and,X'00P0# 'SanativeAFp or an i Oisinstance(coro, _collections_abc.Generator) and not isinstance(coro, _ACoroutine)):?0# '3 ' is either a pure Python g{2 it{, or itGimplements }. (and does 3 K @.*return _qWrapper)+$n 2= ofq7 orGasome o$ object -- pass it through^ Ew1d icAlias = type(list[int]) UnionTypeint | str) Ellipsis h) None$tIr*ed ) __all__ = [n for 0 globals() if n[:1] != '_'] """ Theing module: SupportCtgradual#as defined by PEP 484. At large scale, the0uct!of`following: * Imns$1 ex , all public names should be$licitly added to .Onternal helper fun:$seJPneverP used in code outside thisU_SpecialForm5itsBs (s3!msAny, NoR, ClassVar, "@, Op)al, Concatenate *)es whosec0canpR argu iniKs+ForwardRef, 41VarPParam0 * @coreLi59ics API:_Variadiclatter is currenQonly cby TupleCallable. All subscriptypes like XU3 ,U], etc., ar#$of q@se cw esR0cou@part consists$woF#: Protocol\Pr@get_ _hints, overload, cast, noPcheck Q_decoBe}{ esl B ABCI5fewCal p ipes: New#q, Named5PdDictz}ruio rela.X from abc i abstractmethod,SMeta ?ntextlibDools"ops stdlib_re # Avoidfusion with!Q re weDort.A%sy\stypes import WrapperDescriptorType, MethodWr )8GenericAlias # Please keep __all__ alphabetized within each category. += [ # Super-special typing primitives.''Annotated',y CallableulassVar on5nat#TFinal ForwardRefVLiter0WOptio@ParamSpec0uProtocoa6Tupe) Union', # ABCs (from collecwds.abc)bstractSet',M (C.Set+ByteString}Containe(textManagHHash^ItemsViewHI%toW9Key00Map?R0Mutr)uSequenc-9'"SFYValueAAwaip#\AsyncCoroutinC MPaN p# Structural checks, a.k.a. pYwReversiSupportsAbs |Complex,\Float>Ind*-In(@RounConcreteChainMapoVCountD5DicoxDefault5LisxOrdered$gFrozenSNamedJNot really aHU' tOther c5typBinaryIO TMatch`Patter";Q'Text*apne-off xg#UAnySt&ca!fuget_arg UoriginU_hint(0is_'dd0New&!no#_h_decor fNoRetupoverloaVsA(KwrruntimeX@ YPE_CHECKING1ype@Guar]The pseudo-submodules 're' and 'io' are part oe public # namespace, but excluded )because they might stomp on # legitimate imfose modules. def _type_convert(arg, module=None): """For &@ing @ to >( ), and stringsForwardRef."""Hif arg is@\`greturnM.isinstance3str7i%)Kaarg def _c_check5sg, is_argument=True 1, *"class=FalsCJ that theFait (internal helper). As a special case, accept3dE{ %ead. Also wrapTVinto &/Ts. Consider seversQornerzs, for example plainPforms like Union are not valid, whilP[int,]OK, etc.N{The msg4human-readable error message, e.g::1 "[P...]:M should be "."2We appendrepr() of`actualue (truncated100 chars)n_generic_B= (G, Protocol!if$1is_JiIP+= (CsBVar,B(ifEIrFinal,)= ALif (_`Alias)arg.__origin__ in aise TypeE(f"{arg}2V1 asPc"[n (Any, NoRU!, f@IA "_SForm) or,yrP1  c(,,!s.3p, Param) K@callX- {msg} Got!r:.100}.uW@is_pW_expr^*0...W :(tuple, listQ, _CoInate)3obj2"""an objec@-caszs If8\c, we rZzrter versAthanyqdefaulta0.____, based o({S qualified nameUTch isDiy enoughuniquely identify ? everything else, we fall back on repr(obj). """if isinstance , types.GenericAlias):,8WreturNE7if obj.__module__ == 'builtins'`d1qualname__k 2f'{#T#}.4!}'6v is ...mt('...'))FunctionTypeBu def _collect_d`_vars( "s_v1varTs=NongB"""C6 0 variable containedn in order of first appear (lexicographic)). For example:: Pm(T, List[S, T]))SD[  = ]1Var|tQ = []Pfor t4&s_D |tI) and t no=U<h.Bnd(t X((_*, 4.Un#$Nfextend([t .__parameters__ if]Ratuple(O)Ubheck_gf(cls, Sc, elenL- correct coun25#a O cls (internal helperDThis gives a nice error message@casePhmismatchQraiseET(f"{cls}D-Bass"$alen = len(1if !!=i Too {'many'7>6 else 'few'} arguments;T f" actual {Q}, expected {3}")#rprepareCspec B"""P.Ws thea'Ping PmASpecWI # 4Aial  where Z[[int, str, bool]] Z rPEP 612 ifn M1Cs2_isR_exprSs[0]);hassert;clsnF[0],*<mY,8 _cIv!s,m)G`s`# Convlists to  y other libraries cacheresults.  for p, tvar in zip(params, cls.__eters__): 4if isinstance(C0, P=Spec) and {p, listDLp = tuple(p)a}s.appendcreturn6') def _deduplicatet# Weed out strict )s, preserving the first of each occurrence.3allvd = setivif len($1) <Ls6newG![]>t2 w` AY=t[%A.remove(%z6 = Kassert not D, *I i_dups_flatten<c"""An internal helperUnion creat csubstitu#: T )saamong e,"n 1"""62# F0O[`...], 2ZCs = ps 4Qp, (_VGenericAlias, types.SType)rA.ext`.__arg"-elibap) > 0rp[0] is4H jF[1:]HOelse/ ()t_literac!L:#,s %_` R QC_cleanupr tp_cache(func=None, /, *fsd=FalseD"""Iv wr r =__getitem__g with a fallback toPorigi|non-hashable argumentsMdecoratorQed = Wools.lru<!d=)98!I.5r) .@^ sMpinner(*~x, **kwds:try#wd?)pexcept ^ErrorKpass # All real e(0s ((ungs) are raised belWow.  return func(*args, **kwds)'#ainner !if1 is not None:Y/decorator(\)9  def _eval_type(t, globalns, loc recursive_guard=frozenset())y!"""Evaluate all forward references in the given m" t For use of|D andA see:docstring^A get_hints()L "used to preventinfinite 4!onCDwithBve F2Refa1"""'if isinstanc7)!t.c(_ a(_GenericAlias, Qs.UnionType0ev_Y = tuple(</(a)pa!._L"___5if b5= t""rt= C,="(iorigin__,  !+tools.reduce(opeE?.orf7elszpt.copy_M(t class _Final`"""Mix)ohibit sub*0ing}A __slots__ = ('__weakref__',__A__(self, /, k~if '_root'Z0in  $raise TypeError("Canh specialEes")Immutabl<PindicFthat object shouldbe copied.   Q +Gdeep1o, memo7 # Internal or onstructs. # See __doc__ ; attributef@@fic .#SQRForm(0!, S=True '_name', 'q getitem'&$&,V"S_(#._:$ =" n!._+__&E.0get 70tem${'gP_qualK__'}}#qAt$mro_entriesWbases)Jfubclass {self!r}") def __repr__(self):return 'typing.' + "j._name?OduceA5Ccall3, *args, **kwdsaise TypeError(f"Cannot instantiate {a ox, otherV`Union[=#]A^, Aucecheck8obj 2} cbe used with isS*()subclassk/clK k Sk@_tp_cache":ugetitemparameter{pj#._2m', 01  _LiteralSpecialForm(_ , _root=TrueL1if AMd, tuplU F = (!,) #+*1X) @ >Any 3""" type indicating an unconstrained!.- Any is compatibleBSevery*)PassumBo have all methods.- All values .b`ces ofvNote thatMthe above statements are true from #PpointHqview of|2!ic ers. At runtime,vq should 3'c2or aH1"""hr!isWsubscriptable~1NoR functions5n UExample:: 6 import #]stop() ->Z" PExcep~('no way'BThiszis invalid inPP posi6s, e.g., ``List[1]``Zwill fail;'8C ?VarGuct to mark(@varis1An aq wrappeqeqa givenattributebintendtKas ayA and= cset on|mg. Usag+class Starship:  stats: ClassVar[Dict[str, int]] = {} # c variable ? damage:.V = 10 # instanceCDw' accepts only types and cannot be further subscribed. CNote that@ is 6aqitself,Q`should=be used with is() or issub1()./1"""item = __check(parameters, f'{r}asingle1.')Hreturn _GenericAlias(;0, (d ,)) @_SpecialForm def Final(x!):T3"""0k ing construct to indicate fE` names 3ers[A%re-assigned'overridden in a53For example: MAX_SIZE:q = 9000 += 1 # Error reported b Ts Connection sTIMEOUTo[ <CFast@3or( 3ionX K?RThere runtimeof these properties8kt_Unionk i1e; [X, Y] means eiX'YUTo define a u^,S e.g.Bint, str]. Details- The arguments mus0oeat least oneV@- Noz.I2a seQ case+ isu1lacuk(D-Bs ofs are flattened,: 0[,, float] ==!o#a R vanishs=! #Kor actually s(uRedundant4_skipp| `When compar s,qP ordeo ignoruLp4You ti72 Opaal[X] asPhorth3for!X,k]A&f (^raise Type2("C0tak-<h!noq2s."F ifd, tuple): parameters = (param),) msg = "Union[arg, ...]: each arg must be a type."6G = tuple(__check(p,X) for p in 0v = _remove_dups_flatten2Jif la == 1:Xreturj1[0]:Q2 andj(None) W_!GenericAlias(self,, name="Optional"A) @_SpecialForm def N o)%""q!. 7[X] is equivalent to @[X, !].1""")= 3@ f"{0} rRres a single} hUi]xLiteral@_tp_cache(-qd=True).*=J0ingymdefine loes (a.k.a. valu#s)7BThis=0can@usedIindicate  Uthat the correspondingTvariable or func10 ha?OOprovidedJ(or one of sevC2s): 7validate_simdata: Any) -> Q[c]: # always  s yZ ]eMODE =B'r', 'rbw"b'wopen_helper(file: str, mode: L2str o@'/some/pathj0r')aPasses :Uother;Btypo>PError%a cannoPsubclt d. At runtime, an arbitrary[is allowed aSargumeW, but^2mayGmpose restriIsp# ThereGno '' call because~sA arel#0s, ly__sO6try%9pqP p, _q_deduplmq(list(_"B_andf"))iexcept Typeaunhash{kBpassr>_ ) rxPmarkewUFCQssignRshoulbe recognizHa proper.a1inidby type checkers. For example::Predicate: TypeAlias = Callable[..., bool]4It's invalid when used anywhere except a%0 thtq above.1"""QraisewError(f"{self} is not subscript ") @_SpecialForm def ConPnate(=, parameters):g@"""Uin conjunction with ``P/V`` and ```` to represent aNhigher order fMhich adds, removes or transforms3 ofLcf [[int, P], int See PEP 612 for detailed ina (ifC== (2 @"Canhtake axno types.")&!ifisinstance(w, tuplel8 = *Me[-1], U The lastV should b  "nP variwmsg = "T[arg, ...]: ea$rrg mustf5.k " (__check(p, msg)Fp ins&return _}qGenericP^Guard0N.0ial0ingm1to %1ate%a&r-defined(gpLU. ```` only acXs a single}e argumentAt runtime,Ns marked this waya3ean {@aims%benefit * narrowing* -- a techniqued by static!erLd0minemore prec \@n exus#in1program's code flow. UsuallyF@doneanalyzingPcondi&alHPapplyJ` block{m. TheNpis somes referro 1a ""S.Dit wpconveni toe Ka.cP. Su& 8uses]Qs itsK-M ClertvjPintendU!->dbAells-4 OP that` a givenu 1. value is a boolean. 2. If the return value is ``True``,type of its argumentA -A#`inside=ypeGuard``. *For example:: def is_str(val: Union[str, float]):D # "isinstance" }gp (iY(]], strOV3# Tp``val``narrowed to ``str``b;"..O Lelser# Else,?of k=6 nbStrictL1ingot enforced --B`` need not be a 5!erN@form ``A`` (it can even1`wider *) and this may lea$I-unsafe results. The main reasonto allowQKngs likeF``List[object]``0strathough`latterc"noPa suber, sincOinvariantresponsibility of@writT-  sz@leftmCuser^ also works with0ble63`more imation, se$PEP 647 (User-Definedb"s)1"""item = __check(parameters, f'{self} accepts only"1gle1.')Hr-_GenericAlias(;,4em,)) class ForwardRef(_Final, _root=`"""Internal wrapper;`hold aB reference.__slots__ = ('__fm_arg__', @code8 Q%e@ated*>? isz A1is_ Pmodulk)"__init__d@arg,0K", :=None, *"sc=Falsek!ifA(RQraisePError(f"C musN0str-- got {arg!r}"2w:try = compile"'sA exq Syntax P n expression&.Z = # %uj1 = +|0 = & |( = 3 self.__forward_is_class__ = # self.__f-amodule+  *def _evaluate(4, globalns, loc recursive_guard):=j0if 6jarg__ in 548areturn<L1notPdd__ or@ is - ^%if)None and= 5O% =,E= {}$/el_KFaE!= E~ getattr(XBsys.RQs.get!@__, g), '__dict__'G Y)@type_ ^check }@code{)),a""F references must Y@ to >s.">is_argument=/__:7 4  l1+_~,K | {b  >e= Truez1|Q_eq__z, other\isinstance("#, 7Ref.vNotImple%ed. ` i0A2 == &an &H B ChashLV)COreprC&f'(pq!r})'  _TypeVarLiker"""Mixin for R-like# (ParamSpec)."""S_init, bound, covariant Cntrap"""UsedTsetupsn-'sT!'co_ ouibutes.".&ifG contravariant:  (raise ValueError("Bivariant types are not supported.") Aself.__co4__ = bool(-Ontra15if bound:t|xt_q_check(@, "B8 must be aOelseW QNone zdef __or__(}, right)@return Union[#]@rA?lef@ , F ?$epz!if* 0prefix = '+'(el:~/__>-> >e~'+iname__Seduce_A 4.__8 class TypeVar( _Final, _Immutable, _0Likroot=True]0"""! Bble.rUsage:: U T =f'T') # CanRsnythingQA*A', str, bytes6Mbstr orf s exist primarily for the benefit of static~ers. They serve as8parametersKSgener=s$AwellFa!function defini aBSee ~GJAmoreEpinforma.I on n5. 4]`s workufollowszrrepeat(x: T, n: int) -> List[T]B'''R0a lAcontaining n references to x.''# dR[x]*n q longesqA, y: A~Ax20twoOingsox if len(x) >= 0y) " yThe latter example's signature is essentiallyoverloadAof (1str~Qand ("->p. Also@thatargumentQinstaRrome sub1tr,9`still plain"yAt runtime, is^p(x, T) $isa!(CwGCMsined with +c@used6@decl@ ; E/qPEP 484) details. ByJault<w!in!ntIain all introspected. e.g.:  T.__name__ == 'T' constraints)()rvariantYFalseGntra# "NA.___str, bytes) KNote that only type Sbles defined in global scope can be pickled.J2"""SR__slo4 ('', '__bound__ !',F'5sdict__'def __init__(self, 7, *r!, _=None{#cox=UG, con%):fpuuper().zSd ^@ ifx#B and is not 7raise TypeError("Cc6qbe combBwithT_=..."{ Glen(B)1 pA singlrwallowedtpmsg = "BVar(ry, ...):@must6s."t>elf tuple(_._check(t, msg) for tps:trydef_mod = sys._getframe(1).f_,\s.get@main1 #sC5ingexcept (Attributb, Valu wH if!= 'typing'Qmodul3& class ParamSpecArgs(_Final, _Immutable, _root=True"""The argsaE object.(nGiven a P, P.@is an instance ofLI ds have a refere>back to theirI:# up.__origPBThisis meantruntime introspection ha 1ial3aing tobstaticQ6ersG g$% Crepr:return f"{D}"  Kw k31 BM*{r runtime introspection and has no ial meaning to static type checkers.1""" def __init__(self, origin): Fbelf.__C__ =# "BCreprB:return f"{[DB.__name__}.kwargs" class ParamSpec(_Final, _Immutable, _TypeVarLike, _root=Trueu1"""@BeterAfica.@variD.rUsage:: g P ={B'P')O s exist primarily for the benefit of/  They are used to?AwardCp 7sK1oneH@call3another , a pattern commonund in hig-QorderK1funQsRdecorators.Cvalid whenin ``Concatenate``,QAor sfirst argument3``C ``kE as s[r-definedOpGenericBSee '2more informBon g5:!AnLqexample7@anno!Ung a CT = pQ('T')B,0 add_logging(f: [P, T]) ->jq '''AV-safe=Cadd Y D.'''pinner(*]@: P.B, **o TBg.V@(f'{A wask&ed4yq<%fG @7two(x: float, y  Bdd two numbers toge" (Rx + y with coWn" oQicontraVcan b@decl@I or 7 These keywordXs@P, but{ir actual semanticsRu!yeb^pided. YqPEP 612sdetails-$inVGe.g.be == 'TP.__bound\4= Nj5.__$BFals n$Note that lsz*@globB co@aBbe pickledJjp__slots4 ('E', '  'F* '__dict__') @propertydef args(self):&return ParamSpecA$F/kwHK&J__init__, name, *, bound=None, covariant=FalsIntra0.__KA__ =Tsuper().xid ^):6try%)def_mod = sys._getframe(1).f_globals.get('', '__main_E except (AttributeError, Valu 1z!4if != 'typing'amodule31 is_dunder(attry.startswithq') and 7end class _BaseGenericAlias(_Final, _root=Trueg"""The cel part of internal API.;This represents a gb version8type 'origin'  Qargum7 'p1s'.DThere are two kindF`hese aes: usergAinedspecial.  Q onesTNwrappers ar builtin collectionsJZABCs A.abcZqse mustT`have ' ' always set. If 'inst' is +sthen th can't be (antiated,VtS isd by e.g.0ing.ListTR.Dict41""">< yn%! =S belf.__e ;a_slots ,A # <is not doc #edYEcall*B, **!ifE lraise Typ0(f" " {0} "; VTf"useI1}()GFead"`result ;(C Cw_[6  2pas]\@mro_ 5iesWbasesres = []~0if j1in ; @res.!nd572i =;a.index)Pfor b^j[i+1:]dPif is~ance(b,) or issubR$0*UbreakJelseopend(Generic3) return tuple(res) def __getattr__(self, !):!?!if in {'__name__', '__qual}15qQ.3B or _origin__.M7# We are careful for copy and pickle.a# Also$simplicity we just don't relay all dunder sC if'adict__xnot _is_B( JH%._Suraise AttributeErrorV sZ, val i!{'|Ainst nparams', '_typevarsFEpec_tvars'super().__zJelse9/C>?%ancecheck7obj%subclass2(1  &=X, clsX3Typ "Subscripted generics can@be used with"r!" v )s"$dilist(set(/|0+ [C lin dir~P) if m$])) # Special typing constructs Union, Optional, G, CallableT ## three sS&sinternal bookkeep$ofoes: # * __eters__ is a of unique fk ,aQA # U,example, Dict[T, T].h== (T,);[ reference toype that was sB,{Re.g.,Fo0intqU"==,the non-{ version ofK.>arg)argumentsdH8ingR int). _Alias(_Base, _root=True&it:,`s, *, &6,_=None=?Var) ~T=Fals7U!inirA is"(i,a4 = &I4.__l?@(...a is _TypingEllipsis else  () if a is _TypingEmpty;Pa for;n params)lqself.__eters__ = _collect_type_vars("0s, 1var!s= W ,W  aPpec_tq/ 1if not name:=amoduleorigin.__ 1def __eq__(4, other)Ncisinstance(", _GenericAlias1return NotImplementedpq2.__=~48@and a.__arg6)Chash(,`)O#orM~, rightT`Union[#]rA?lef@?@_tp_cachugetitem'$ifeCin (, Protocol3e# Can't subscript 2[...] or9.raise TypeError(f"CanNalready-@ed {3&}":y{, tuple4 = I8(_convert(p)>p i3if C 1Gany(&@t, PcBSpecdtd g)_prepares,<_check_g 7Q, len @t = dict(zip0r1newU = []-{'rg 7if F2arg.a 59/3Qarg =Vt[arg2_is_expr(arg0Expected a list ofAs, an el5, ".G %f",Concatenate. Got {argPM& /ela(,'"!s.  subparams = arg.__parameters__ aif sub#-s:-subargs = tuple(subst[x] for x inA)AAarg [K]'# Required to flatten out thesjCallableGenericAliasHelf.__origin__ == collections.abc.G and isinstance(arg,)@new_p.extend- Oelse7=app7return scopy_with(cp1)) Fdef $3", Q__class__(-8r, name= ,  {c__reprMrrA  = 'typing.' +_[7 = _typev x = ", ".join([6!a)5ac_6__]A10f'{v0}[{R6}]'tOduce~ = globals()[g9//`if len s)1;notOs[0]f,a,operator.getitem, (, 4mro_entriez, basesB , _SpecialForm6;raise TypeError(f"Can1sub {OC!r}"6 R # gO version of an ABC or built-in RJsuper().__2xC is  :if ProtocolI "(2i =ca.index< "bXn[i+1:]^(if.yb, _Basz)Wbu>elfG() # _nZanumberrccepted, e.g. 0@Hash!Q, # 1AList2 Dict. It may be -1 if vari8 k' #dd are a|(needs custom __a__). &(A, _root=Truec__initp$, ]3, *74NonB if name is None: name = origin.__%__#super().__init__()p, inst= , 3=)7elf._nparams =  &ifrmodule__ == 'builtins'sP@_doc( f'A generic version of {p.__qualU__}.'v;elsX/}.lm@_tp_cachedef __getitem__(v", )if not isWRance(#w, tuple*4 = &~msg = "P~eters to0types must be !." Vs (_ _check(p, msg) for p in<(_ , breturncopy_with!) [>H<H"_GQAlias2.__$__7,W8=g. c__repr'typing.' +Q__subclassbHW, clsM(ifcls, _Special2$iscI(cls unc^ )creduce"I 5o~, right8`Union[ #]@rA?lef@1]  _Callable5(, _root=TruTgassertH0g0argr0.__pif len()@2 and _is_OQ_expr7[0].Q8$(fIf'[[{", ".join([hR"(abab[:-1]])}], D8f'{;`rgs[-1-'>`# =T,(1 2^BlistT: , 9operator.*4, (B5-) __Type(^rue): de f copy_with(self, params):  return _CallableGenericAlias4.__origin__?,>EPname=w ._ c, inst G_typevars=(TypeVar, P_Spec)Jpec_tvars=True) def __getitem__/if not isRance(T, tuple) or lenf) != 2m(`raise tError("z must be used as "48[[arg, ...], result].")=Dargs# =# This relaxes what 2@ canon purpose to allow things likeHvPEP 612. Responsibility for whether ar is usingI[ properly*deferredpstatic  checkers.F(ifg, listUA = (())-CJelse932WWtinner__z@_tp_cachM 2I}fmsg = ).#]:,waL.vL1 = z_e(V, msg "if4is Ellipsis/(_Typing4G Z p ,C" =(`onvert)aarg in9B$+ "8) class _T (_8ialfr, _root7  {[ == (fmpty,) Cw ~)if== 2 and0[1]:...Q9"[t?: t ;[0],;p,  T0, t1Oeach  "(pp,&eUnionGenericAlias(_G)enericAlias, _root=True): def copy_with(self, params!%return Union[%] ?c__eq__<Wother;if not isinstance("A, (_OGatypes.WType)INotImplemented1set.__args__) == zChashtp(frozenG%F)GNreprG %lf8pif len($20if p[0] is D(Non"f'typing.Optional[{_7_gu[1])}]'A$eli1i80isuper()._9__(C(ScheckL^, objsubclass2(1 X &=H, cl0forn@ in  $isOP(cls,5Qn %Cduce7func, (originT s)7/9)c;9:0 _value_andQiter(DeterGB((p,d@p)) p /1 l0 _LJ(al((_ m/"p<o x ), J i.bK)tConcatenatejx wCinit0, *V`, **kw K1 +,R[ c1var0s=(`Var, PR_Spec)> hspec_tvars"""Abstract base gR"s.y(A Jically declared by inheriting fromCthis_8Pized 2 one or morer variables.>pFor exa5, a0map3might beined as:: zM0([KT, VT]__getitem__(self, key: KT) -> VT: 7...q# Etc. This class can then be used as follows::. def lookup_name(mapping: M [KT, VT], k,3ault: Vif len(setQ)) != 4BJelse`4# Sing a regular1sub 8anytt?s__s = _prepare_3pec 9_check_g>,|_YAliasC o 1var/s=,B tvars=True)4%Tinit__%*args, **kw isuper().__9 4yF = [if '__orig_bases__'jdict__]e=% =L in.Dr@g''Z1if K s@"Can inherit from plain GenericC") if '__orig_bases__' in cls.__dict__:-4tvars = _collect_type_(5L, (TypeVar, ParamSpec)~Q# Look for Generic[T1, ..., Tn].~# If found, must be a subset of it6:not:/is)Also checand reject plain,(multiple+K[...g/y = NoneIN <if (isinstance(;3, _GAlias) andd81.tin__ is)m52if 0is Q*.raise TypeError(-@"CanSinherit fromD Zs's.@#= pwyeters__eet = set( ws%%!if2CRet <=J/et@sT = ', '.join(str(t)*t"KQ if tZ$inR}Ps_arg RgRgR> pf"Some  variables ({y}) are"qF!f"`listed"[{/}]Dg = tuple class _TypingEmpty"""Internalceholdero() or []. Used by TU@Meta`P Callto allow ea /specificgs, without3ing themHPsneak7where prohibitedL""" llipsisc... (e/").L _TYPING_INTERNALS = ['__WC87%, Jc:__'&'_is_protocolJis_runtime] _SPECIAL_NAMEabstractmethod,y=UationaO_docp'__initHdmodule4new Aslot[ a'__subDhook3tweakref _getitem__'] # These al attributes willlPed as: members. EXCLUDED_ATTRIBUT- ALS + _SPECIHAL_NAMES + ['_MutableMapping__marker'] def _get_protocol_attrs(cls): """Collect p$ members from aclass objects. @This includes names actually defined in the @dictionary, as wellJa?that appear:`annota3s. Speciali(above) are skipped.L1""" = set()for baseZ cls.__mro__[:-1]: # without4!if70.__ __@3('P3', 'Generic')Y5continueJ` = get(W, '__r__', {}L.}Alist60.__S__.keys()) + J pif not Rp.starts('_abc_') and&in EXCLUDED_ATTRIBUTESQN`s.add( areturnLspis_call_qf_only(# PEP 544hibits using issubO!()"!s ?have non-method4ll((Acls,, None)) uL)no_init_or_replace(self, *args, **kw *cls = type')Y1if %ismraise TypeError1s c bstantiated'V# AlreadyIa custom `___`. No need to calculate correct#/&1l. qcan lea=Recursion. See bpo-45121}1 ism_HS+p# Initis,(of2d0set`h`# The first inNaion ofT@will-/l Tc whichAsearches_xper new80MRO^eJh$e X' oldK?(ie). SubsequenHi 0thue3newULno longer* ~y j$ =Tget('?', 1if J|58A__ =AQbreakFelse# shouldhn&4 Ti._ cls._ _init__(self, *args, **kw &) def _caller(depth=1, default='__main__'): try return sys._getframeD + 1).f_globals.get('__name__'`)T except (AttributeError, Valu ): # For platforms without zNDNoneallow_reckless_claRhecks#=3@"""A- instance and 1! c1 for special stdlib modules. qThe abc:functools$ indiscriminately 4 isq ()9IQissub|() on the whole MRO of a user, which may contain protocols.P1"""[] in ['abc', '!'][60Tru_PROTO_ALLOWLIST = {z'collections.1: [D'CallableTAwait IIter 1tor%FsyncJDHash1PSized.Cqe;CqReversi|F!],'extlib': ['AbstractKextManagPA q], } %3 _PMeta(ABC# This meta-is really unfortu{ exists only because of#@lack$__bhook__T5u__(cls,U# We need t2hoddAitua where a#Qs areBassigned Eif (-0getKT'_is_(', False0Nnot 8runtime@_2$raise Typ?("I4can d.J4" @>""):N(F)ory@ob_members_k)y4q#._|_, cls).4B if*.!qall(hask,y7# All *methods* be blocked by setting<Pm to DZ(q,;?)) YCgetattr(instance, attr) is not None) 1for+ in _get_protocol_As(cls)):;return True super().__instancecheck__() class Pm(Generic, meta$=_CMeta"""Base " Aes. < are defined as::'L1(3colo0defh(self) -> int#..~ISuchzprimarily used with static type "ers that recogniz[structural subtyping (>Rduck-!),~exampleC009rfunc(x:9x.meth()@<C()) # Passes /See PEP 544details.x5colesdecorat\@.runtime_dable act as si)-minded ' Q6P only the presence of givenAibutes, ignorRtheirsignaturPgcan be gOthey1GenI?[T]T1"""__slots__ = (65_is& =9 RFalse. ait_subl __V, *args, **kw C 9 4e# Determine if thisa  concreteL.B!if,cls.__dict__.get('1', <5 %Pany(bbi._bases__# Set (or override)rV hooke_k(other)@NotI7fmented## First, perform various sanitys40getpq WyD_allow_reckless_+s( 3raise TypeError("IB and &&beTR 4" @nRcols"50@call,_members_only(cls):+ if _allow_reckless_clahecks():3Breturn NotImplemented*$raise TypeError("Protocols with non-method members"Dn" don't support issubI()")?Pif no"instance(other, type# Same e message as forg1, int).l ' arg 1 must be a 9') G(# Second, perform the actual structural compatibility c attr in _get_p{__s(cls6@base6,.__mro__0# Cz1 if appearsE dictionary..;0if 70.__4|2 *[@] is None8*ZbreakP# ..."n annota s,i}t a sub-:` = get(W, '__z__', {}eif (is7q, colles.abc.Mapping) anMN4H, Generico E._is|?els"FTrue ifjMrhook__'A_n cls 72 = _Gc# We haveWhing more to dof)s(m6 o2...lw' consistency of d s,p prohib0!ti_= 8w(object)orNqpodule__<_PROTO_ALLOWLIST< ?nam:[^/] 31and/ can only inherit from''@, got %r' %`init__no_init_or_replace_init class _AnnotatedAlias(_Generic%, _root=True): """Runtime representation of an aOq type. 5At its core 'q[t, dec12, ...]' isG for theKA 't'Mwith extramions. The a7behaves like a normalE2ing#,Jinstantiat!islsame as punderly,, bindingL@t tod!es5lsoO."1"""Qdef _ __(self, origin, metadatalpRif is4ce() 04G# =Z4.__E__ +h2\4%__'super().")):elfu=u&Pcopy_gparamsassert len(Q == 1A@new_2 = 5[0]mreturn4 , | ) __U"typing.{}, {}]".fn%t(R2.__92__)%", ".join(1(a)Oa in2 Oduceoperator.getitem, ,, N,) + #eqw, otherCiif not",3zNotImplemented} /s4V>and:< Chash(t SsgetattrV , \!if{'__name__', '__qual}xGz&["""Add context specific a 0Exa%: Ir[int, rK_check.Unsigned] YPcatesJ1the0hypZtical: module that th1ype3n uVB intREveryPsumer:pcan ign ,Qtreat1tfirst argup must bXvalid)Details:Q- It'0err o call `L ` @@ lesean twovs - Nested An notated are flattened:: #An#[ qT, Ann1!2]P3] ==P[#"U- Instantiating an ad type is equivalent to i11thepunderlyD7C|P1](5)DC(5) can be us s a genericXalias^Optimized runtime.!1()]K[d[int-_int, =>IListw?[T]@y}.G2"""9__slots__ = (Mdef __new__(cls, *arg0*kw %):raise TypeError(" 90notCed."j@_tp_cacyclass_getitemgparamsz0if Z"isY2ce(#, tuple) or lenV) < 2F B[...] shouldJ"= "with at least two arguments (a{ nd J ?@ion)(jvmsg = "0t, q: t musdh.aorigin = _Tc_check[0], msg)metadata =C)61:]%return _AP(i$, Dinit_subT !"C  OE {}.".format.__module__@) @able2]"""Mark a protocol aL:.GESuch8) and is1().RJ if applied4ja non-8This allow simple-minded structural  very similar toyone trick ponies in collections.abc spas Iter/{pFor exarQ@$^hI@ClosF#(Paz"close(self):gwassert Sopen('/some/file'), dWarning: t/4wilonly the presence ofr0redQhods,sRtheirsignatures!WHGJcls._is_ 'Ufonly applied to protocol classes,' ' got %r' % cls))cls._is_runtime_Pa= True$`return4 def cast(typ, val):%"""Cast a uea type. RThis JSs the'unchanged. To5 checker this@`signal;!at'LG haAe de(1ted|, but atB we intentionally don'tr anything (we wanlto be as fs possible).`1"""/_get_defaults(func4Internal helpo extracy6 arguments, by name.o2trypcode = d0.__!__except AttributeError8# Some built-inA sThave Q5, _r__, etc!{}wpos_count = q.co_arg!@arg_s!1var !-%[:Y]&^r__ or ($kw)+ reVdict(V) if g else Poffset - len(q1for:uV zip(?LE:], =!rtE not in re# s[=2] =) _allowed_ipes.FuncQType,?0s.B)inRlJx.Method?aModule6WrapperDescriptor) G ))^]_hints(obj, globalns=None, locinclude_hvs=FalseRR R an objectis often1samobj.__annotaNs"it handl forward references encodedc0strliterals, adds OpRPal[t]aT$` equal}@ is  anhcursively replar1allD"'Aed[T, ...]' with 'T' (unless '9 %')eA may+! m,1, m!,g. The /3are, a rry. ForReSions Q alsoH`inheritmembers"yp"`raisedQj`2of  that can containb , han emptyKrWg(no2 argdpresenbBEWARE --^behavior of globalns >and localns is counterintuitive (unless you are familiar with how eval() Mexec() work). ThDsearch orderits first, then globals. u- If no dict argumentspassed, an attemptRmade to usePE U from obj (orp respec module's-Por clf3s),IQthese1alsjAd asO . 0thekect does not appearLtto havepy`ionaryused. F+ MMS@ Tn R1oneeShQiIv for bothC andq/tw Pthey n?ifyP,1ly.l2"""fif getattr(obj, '__no_type_check__', None):9return {}2# C require aal treat_vif isinstancepj[ hi=\n0ase in reversed<.__mro__>/w!Tbase_=Bsys.`s.get('g#__ %=1{})WOelseq :cann = t`'__annotationsu YPann, Ys.GetSetDescriptorTyp{_! =Q(varsR)) ifh  ,A8Q# Thi@Psurpr>dg, butmBefore Python 3.10[#dAonly^PuatedAYns ofB2# azo maintain backwardmpatibility, weL gzqso that() looks intoK*M#s*Prathe2an !a"s*bpaffectsNRefs1p,%k name, valuann.items($if)s'&L=( # '1_, strt/!' =(T, is_9a=Falseclass=True)  value = _eval_type(, base_globalslocals) B hints[name] = @$breturn#- if include_extras else {k: _strip_annotations(t) for k, t iC.items()} b2if ns is None:nsinstance(obj, s.ModuleType).2L= obj.__dict__R 2ansobj /&Jf# Findthe unwrappedaIect.6while hasattr(\S, '__4;__'k'1 = .- [;get`s__', {}1if ^{=t/el9 5E4 = ('_$ifW 2# Rwgempty URsomething that _could_ have themC_allowed-s!{}#3`raise ~Error('{!r}qnot a m, class, Uod, 'RV 'or func9.'.format)+defaultsDget_#Z( :, $if# ! =( e)[, str\#`-levelward refs wer7ndled above, this must be eitherr#lR&U or aP argumentH J` = ForIRef( n$,4is_^=i C+j=False  4ns,50if 1T and  yq Op1al[]cA4B0;O defg@"""Sss from a given!1""" Rt, _AhedAlia$.__origin__W|GenericU:0pedKhtuple(dations(a) for a in t.__args__) if stripped7 ==(:(/return t.copy_with(Mgif isinstance(t, GenericAlias)c ; = tuple(__annotations(a) foL(9origin__,0types.UnionType functools.reduce(operator.or def get_3(tp"""Get the unsubscripted version of a #!. TThis supports g!s, Callable, T!, V, Literal, FinClassVarRRand A3Red. RANone;n"edg. Examples::n[42]) is~m +1int#n B[intM.R '"[TR*?E[T, UQList[v03T]]f== lis( P.bPS1""" Ep, _ d Ac(_BaseD \,8 ParamSpecArgs, !Kw5Ctp._!__VPif tp 3-#p,uy ?AGX~|ype arguments P all AtituI performedPFor us, basic simplific{ used by construct(reP=S*Dict[str0== <T /T$FA(intD D] ])? h[[], T4((Q,) + metadata if isinsta nce(tp, (_GenericAlias, S)): res = tp.__args__Aif (origin__ is collections.abc.Callable6W and not (len(res) == 2_is_param_exprH[0])EQ(list#:-1]), res[ q`returnif isinsta types.UnionType;Rp() deP_Dddict(tpA"""Check if an annota' a kdDict class For example:!e Film(6e title: strHyear: int_'isT) # => Tru &[i,b]2BFals31"""x a_DMeta6!no _c%C(arg"""Decorator to indicate thatGQs areC}r hints.The argument must be aiq or fun;"itfA, itapplies recursivelyall methods5es defined inIB(buto:.its super2 es3sub)is mutates the0(s)2/(Ein place.} Parg, 5rarg_attr`arg.____.copy()N(@for (P, val -gitems(W3*if,bases__ + ,.2P.pop(o 3obj{o.valuey2obj3s.Fiobj.__J__ =" WaS MB(obj6tryJ * waexcept:`Error:built-in%espV3arg cdm(  give another -@Tx effectBwrap9pwith soP2ing9 (!ed m)@*Qools.L Eped_ (*, **kwds<M& = )R( (=# _overload_dummyz7"""Helper @2 raise when called."""  raise NotImplementedError( "You should not call an overloaded function. "7A series of @--decorat5s5outside a stub module~always be followed; byia that ised.") def(!):B"""Deor for%/methods. 4$Infile, place two or more`definisZthe sameD iMrow, each 5FwithN. For exa: U utf8(value: None) -> S: ...)" 9Qbytes: ;2 b34allC (T, 2) *.__doc__ = \ """<$; a[[int] ] is a fun of (int) ->*!. KThe subscrip syntax must always b,exactly twoAvs: the argument li>!ndareturn (FoBbe a;!of/s or ellipsis;M5RsinglQ re$noto indicate o alaukeyword!s,Fsuch>s are rarelyd as callback.;`""" Ab_ctSet'Set, 1, name='3Q') Mu4@ $g# NOTE: Mappvis only$. -!q (;Sequenc"Bk)=RByteS\$ # Tuple accepts variable number of parameters. Tuple = _ `Type(t , -1, inst=False, name=''"')8.__doc__ = \ """!q type; [X, Y] is the cross-product'X and Y. FExample:@aT1, T2B!a 3 two elements correspondingD"to]vAs T1eCT2. Yint, float, strbDaof an &a(Ba-3ingTo specify a ov-lengthhomogeneousS, useT, ...].u""" Listalias(list, )q') Dequ1collections.d>+W') Seb/seaSet') Frozen3f93') MappingViewGabc.%, 1) Keys2 "/OItem0 #, 2) Value2 $dContextManagerlib.Abstract+ ') AsyncZ 0_ 'icdict, 20DicpDefaultV!J\7') OrderedE!ZCountXrhainMapWCTGeneratoVy#3, 3b6i(l=1D0ypeC?ypeBAPal constr)!us to annotate class objectsRFor e>, suppose we havefollowing?Bes::t ` User:D #  base for*!es8PBasic=()C !0ProLTeam @And a fun that takes aP argu'3subfDYrreturnsastanceLCZ@U = Var('U', bound=X)b def new_user(_:8[U]) -> U:.-% =r,(La# (Hercould writ9 P data@ return usQer  joe = new_user(BasicUser)!At this poin e type checker knows that I2has G.g""" @runtime_>able class SupportsInt(Protocol)::An ABC with one abstract method __int__.e__slots__ = (@54[4def<(self) -> intyJOpassOFloa#f:&>Complex|"c<&@_Bytes"b:&>?Ind$i:&>"&Ab|o[T_co] abJ is covariant in its return]$aURoundbr@"__2Cc, ndigits:A = 0make_nmtuple(name,ss, module, defaults]Pfield[n for n, +!s]m = {n: _ a(t, f"@ {n} annotation must be a!")G g} nm_tpl = collecI s.dp!s,2N=  =x6.__%= b_! s2 # attributes prohibited to se``NamedT Isyntax _.= frozenset({'__new__', '__init__' Tslots getnewarg/ '_fieldsC _defaults',7 Amake5breplac aasdictsource'}) _special = frozenset({'__module5nam annotationE class NamedTupleMeta(type): def __new__(cls, U, bases, ns):+bassert[0] is _^'Es = ns.get('__U, {}).<_w6%[]Bfor a1 ins+if$n!% e.append([-Yelif 2 r$raise TypeError(f"Non-5 dts& {l5} "J1f"c3t followM?{'s' if len(a) > 1 else ''{L.joiK&}"8Pnm_tp_1_nmm Zs.items()'s=[ns[n] n]H/H=ns[<]# updategam user space without overriding attributes0key 3if _prohibited`A[e""CWwrite @ " +dTz0notb0and. .0setj((,;&G[keyWrreturn %0 i*s=None, /, **kv0"""dd version of{.PUsagedPython,s >= 3.6:Employee(p$U: strrid: intv@Thisequivalent tolf = collec.[$('#P', ['kTid'])de result|has an extra [P, giv5ad that mapsHIBs toVy. (Theare also inGCthe kPwhich @part(R API.Alternative 9keyword syntaxJvPaccep3' = Jy=str, id=int) In Python versions <= 3.5 use:: Employee = NamedTuple('', [('name', str), ('id', int)])H1"""if fields is None:j= kwargs.items(?Celif1raise TypeError("Either list oior keywordsm " can be provided to, not both"6tryPmodulsys._getframe(1).f_globals.get('__'__', '__main__'Qexcept (Attributb, Valu )qBAreturn _make_nmt@typeq,t1, m=F) _0 = 0.__new__(vMeta, '', (), {}) def dt_mro_entries(basescif lenF > 1  Multiple inheritance with@supportedqassert {0[0]'+(F,) &(._O__ = class _PdDict-(I SRcls, , ns, total=True3"""Create newrd dict pvobject.This methodcalled when!1subB1ed, l/or)instantiated. _5way4 %s all three syntax forms described in its docstring.NS@s an)|0cesjaactual@ionajJh1foryps!ifX)O  15 @'can8Q from(' ay% 'I'fa non-*:1tp_  l(+ ,)n)2!atE= {}Jown_n 8_keys = set( s."():umsg = "(l', {f0: t0, f1: t1, ...}); each t musta pE = {p@n: __check(tp, msg]/&__?XPn, tpY l -XrequiredY op*alt !insq.update!._'$__annotations__',w {})) required_keys.update(base.__dict__.get('__*{__', ()MoptionalM *M`annotaNGown_if total:>  DHJelseD D {!tp7(._W__ = . 0frozenset(k = =if not hasattr(LQ, '__MJ__') #.!" =xsreturn ) a__callOP # sc method&def __subclasscheck__(cls, other# Typed Ns are only forYstructural subtyping.AaiseDqError('ODict doessupport instance and  2s')$__# 0 h(typename, fields=None, /, *,S=True, **kwargs"""A simple D d F space. At runtime it is valent to a plain7. creates a!ryb that expects all of itsNs`have a certg0set+U, where each key i?associated with a value7a consistpype. Th|Fed a0butenforced b0"rsrUsage::"Point2D(&"ax: intylabel: str`3a: ] = {'x': 1, 'y': 2, '3': 'good'}2%OKhb=Xz': 35!ba4r# FailsTssert(x=1, y=2, ='first') ==!R"Th info can be accessed via them ,h *  __&H 5__ 8 s two addi`(al*Xforms H#('', x=int686strh+! =sdh@= H'7}jBy default,ZP mustf@pres+Fin ah. It is possible ( to override this by specifying totality. Usage::  class point2D(TypedDict,8=False):/3ix: intyTmeans that a^ ^ can have any of the keys omitted.A typeP checker is only expected`suppordliteral or True ae value ofPl argument.-i-default, and makes all items defined inPBbody be required.cBThe !esyntaxK Python 3.6+, while two otherd=forms work for 712.7A3.2+.1"""if fieldsvFNone= kwargs/Celif)QraisevError("t eip a dictyukeyword^"s,; " but not both")5 ns = {'__annotations__':c(!)}6try`# Settcorrect modulenecessary7adSes pickleable.qns['__mI#__'] = sys._getframe(1).f_globals.get('__name__', ;qain__')except (AttributeV0, V mBpassreturn _}PMeta(#j, (), ns6) /! =.__new__(I5, 'Y'ME{}) .__mro_entries__ = lambda bases: PR,) 0NewC3""" creates simple uniques with almost zero5qruntimechead. K(0tp)considered a sub]pFMck Wcs. At b,Y{"a dummy call&#y )E its.qUserId =k' ',Vy@def _by_id(user_id: /) -> str^0#..x ) (': ')w# Failseq/424 /3r42)) # OKYCum =p(5) + 1=! #?__init__(self,G, tp#q.__qual CP`if '.' .! =Wp.rpartik('.')[-1]De/ Psuperr"ts0def>@ = _72er(  ifQ!= 'typing'} = def_mod def __repr__(self): return f'{.__module__}.pqualnam!' 9QCcallQ>, xTx-creduce/,}k<o~, other?`Union[E#]@rA^ , H] # Python-version-specific alias ( 2: unicode;2 3: str) Text = P:Constant that's True when type checking, but False here. TYPE_CHECKING =  class IO(Generic[AnyStr]#3"""b base /@for IO and BinaryIO.4This is an abstract, g_  of the r>of open()CaNOTE: I does not distinguish betwehe different possiblecPes (tBQvs. bp, read Qwrite /,=append-only, unbucd). TheC subsBbelow capturefctions which isEpervasive inD interface; however we curQly do+o! aDpway to kDN^Cqsystem.<2"""__slots__ = ()@property+@amethodBmode30 ->:OpassKCKGclosONone'MdOboolNffileno@?int?Flush>~fisatty@->p, n: in0-1)=M7abl!2linB, limit2Ush DList.CseekVRoffse,$ce0PvKm0[M+Atell) -> int:  `pass @abstractmethoddef truncate(self, size: int = None) ->:1ISrwritablSAOboolB?, s: AnyStrJ?intISlines r: List[W]XY__enter__XC4'IOS'K3xitJ, type, value, Qebackb class BinaryIO(IO[bytes])"""Typed version of the returopen() in bE mode."""9__slots__ = ()M6wriJr: Union , Rarrayq_p nBText?str!Otextproperty$fbuffer/ ZRencodingT?strO(Brror(nOptional[>W'r_ 0newY?AnyQ1O"io`"""Wrapper namespace for IO generic (esF1allD['IO', 'm4, ' !']AqIO = IO %2 = /% = io.__e + '.io' sys.modules[+] = io Pattern = _alias(stdlib_re., 1) Match%#|/re- !re o*|/b"3 = "1 = _ re*re+0re )Python unit testing framework, based on Erich Gamma's JU0 and Kent Beck's SmalltalkJ0 (uIwith permis). Thisule containsFcoren that form the% basis of specific test cases and suites (TestCase, Sq etc.),' also a text-based utility class for running thefadreportresults q xtkRunner). Simple usage: im=P unitrIntegerArithmeticM(..!):MQ1defAdd(self): # method names begin with 'z'BF: .assertEqual((1 + 2), 3)) 0 + 1, 1'MultiplyG (0 * 10), 0J5 * 8), 40)?Pif ____ == '__main__'&B() Further information is available inbundled document*B@fromhttp://docs.python.org/library/{html Copyright (c) 1999-2003 Steve Purcell&!q-2010 P` Software Found This modus free s(you may redistribute it0/or<ify it under0samdrms as~ it/, so longt}c0mes disclaimer retainedair originals8m. IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, IND  SPECIAL, INCIDENT OR CONSEQUENTIAL DAMAGES ARISING OUT OFuUSE OF THIS CODE," IHAS BEEN ADVISED=POSSIBILITYRSUCH l7. FICALLY DISCLAIMSWARRANTIES LUDING, BUT NOT LIMITED TO,IMPLIED 7yMERCHANTAAND FITNESS8 A DICULAR PURPOSE. Q PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, [T'" NO OBLIGATION WHATSOEVERT MAINTENANCE, SUPPORT, UPDAT0ENHMENTS, OR MODI+SS. """ __all0 ['!R1', A IsolatedAsyncio)  (',8'TeE*`Loader@Func9L` Gadefaul<@Skip8HDskip$If kUnlessLexpectedFailure,installHarBregister&lremove>AaddMcCleanup'] # Expose obsolete fFbackwards compatibh.extend(['ge%KNmakeSuite', 'fin'dTestCases']) __unittest = True from .result import 5RDcase(addModuleCleanup,0e, FunctionB@Skip, skip, "If! Unless, expectedFailure)Esuit@Base[S ,eloader*L, defaultAmake>A, ge_NamesV fin_Dmains_Program, Frunn1TexoRtsignalsZ installHandler, registerJmove- # IsolatedAsynciot will b_ed lazily. # deprec6% _J/There are no p s , so don't try to run anything discovered  # intros  the symbols (e.g.p). Instead, all our #AcomeX0 wip .`. def 4_ s( \, pattern):)qos.path# top level directory cached on[1nce4this_dir = K.dirname(__file__))TreturD.(`(startA=J= DLazy=/ofv0 .a_-!s io, which is relatively heavy, but mostt9o not need it. g_3__(Nglobals().keys() | {'$'}Jgetattr__(8R0if O == By' Q8' raise AttributeError(f"mh@ {____!r} hasU, {!r}") """M en_point""" sys if sys.argv[0].ends@("__d__.py"F# We changHB help message more useful=use executable0out]h, unquoted,(it's just a hint)2way # (if you have spaces inrd#get what deserve!H@baseV(+"2?( =je+ " -mW"odel os{vJ (d=None)tloggingQcolleoscase import _Bas.eTestCaseContext _LoggingWatcher = collections.namedtuple("*O", "["records", "output"]) class _CapturingHandler(l.!):k1"""#A " h0$ cA all (raw and formatted)2}.HP def __init__(selfqk.(?'6%.wD ,`([], [,o\flushlQpass S#Aemit"", >o.s.append()Hoamsg = 2 "."MUmsg) AssertLogsA\(_BasVb"""A ci manager% aF!() NoY5()  LOGGING_FORMAT = "%(levelU)s:%( message)s"A , test_case,0er_>!, R, no_logs9 UpN7b( =p"ifzp=7Aing.0ToLB.getyOelseNEINFOp"JNone$ =\^enter0if isinstance. {w'ern* 4J ge=gerG%t OFJ8 ;= &A.set%}($ =*'Cold_s4er.>[:]/,&propagate*.LoC = [{x$ $av = Fals"if ereturn 7 E__ex, exc_type value, tbilb123 +0) if exc_type is not None: # let unexpected exceptions pass through5return False if self.no_logshassertNoLogs4qif len(<watcher.records) > 0I2+_raiseFailure(R$&"U found: {!r}".format:>fooutputf))=elsr /== *1no olvel {} or higher triggered on {}"0logging.getLevelNamel"),' er.name)) import asyncio0insv from .case *`TestCa_0 clIsolatedAC ( )' # ps intenally have a long prefix# to reducchance of rhing with user-defined attribute!# `inheri?Ptest aA TheUs doesn'# ll loop.run_until_completNsetUp()) and familyN0buts a different approach1. creatP-runntask that readsma awaitablepqueue aIa future2"2.2B the <aobjectI{!in1set(RresulT#bAinto[ >b3. Outer code putl'~ =Ao a J" 7forv%Qtrick;ecessary because every c) callEAnew yRembedded ContextVa .;To share c#vars between !, nearDown() we needdexecutthem insideAsame.q# Note:Y modifies!nt policy if,"wadinstanti4yet>p_event__D#()3tdefaultm`on demn^sI believ!isot an issue in@!r E s Vpython it cestingWshould rea in!ryI0$uls!byf?set)tsModule(Jdef __init__l, methodP='run'Lsuper().__init__(methodName)  self._asyncioTestLoop = None%CallsQueue'(CQ def `SetUp(^!): pQpass $.TearDown1Y0ddAbCleanu^, func, /, *args, **kw x# A trivial trampoline to addNQ# theX!tion exists because it has a different semantics# and signature#s accepts regularuJ0but5 ):coroutine3We intenally don'P inspect.isDL*() checkI"fo` argumthere is no way4"toG =b reliably1. It can be "15`()" itQa2. Class4Qimple;__call__??C3. Ry"hthat returns awaitable object@.A *()aMs54.D)YM*",  QRMaybeV& MC> t yB{@?"*.u9 n5 Passer!t&1, 'io test lA initialized'8Qret =($}(ret), f'{3!r}ued non-(p fup<*.create_fu(p.put_no`((fut,})74 lrun_until_co teC G'ifJ!8 return self._asyncioTestLoop.run_until_complete(fut) Uelse:return ret RT def ]YRunner(self, RECallsQueue = qS1io.(fut.set_result(Nonewhile Truquery = awaitcG.getW{.task_done if9`ry is v<Bfut,v3abl)ry#?tryK? 7^`if not[.cancelled()N, 8're except (SystemExit, KeyboardInterrupt\YraiseJQBaseEVTion, CError) as ex!zrion(ex)bsetupAyassert 3, ' test loop already initialized' "=new_event_]W!&"`debug(=Bfut .create_futur HKTask6 AS^tearDown(!is' ! =%=p.put_noy  nIcjoin() :"# P all s0#o_ Aall_*(0t7 f1for|O in ;u(x g):gather(*o,Eurn_!s=3 j!ifezcontinuB ()YZ5c7_handler({ 2'message': 'un0d exception during test shutdown', 'exception': task./()7+2&)})t# asyncgens! loop.run_until_complete(_<&()`finally:P*io.set_event_JV(None:.close() Cdef run(self, result=9c._setupAvioLoop([+trreturn super()([4jtearDownmQdebug)>s|__del__u2if ?@Test is not H/0"""Ap case iPmenta""" import sys functooltdifflib dpprint$re uwarning7`colleciWntextMtracebackFtypes from .Dutil(strclass, safe_repr, _count__all_purposeg,hashableBmmon_shortenX) __unit= True _sub_msg_sentinel = objectDIFF_OMITTED = ('\nDiff%s characters long. 'B'Set1max<!to to see it.') P Skip$(ETRaise this R in aT0kipU0Usu you can use adCase.sn) or one of the pIdecoratorpinstead'@rais"directly._ShouldStop2Thes,^ stopIUnexpectedSuccessP0wasq?dnfail, but it didn't!Outcome(c__init @ing_sure = Falsen# =e@_supss = hasattrA, "addSub"s, {zed = []|bedFail $@rror"[]j4@co!. qmanager9BlPartExecutor>,_@, is=-{Fold_ self.success = True Etry: Uyield except KeyboardInterrupt4FraisS4SkipTest as e0eself.s7Fal?!kipped.append((test_case, str(e)))_ShouldStoprKpass- !exc_info = sys.(c1if expecting_failur+(2edF&4 = Y,?elsB& ;g_rrors)o+6# explicitly break a reference cycl2"-> frame ->L7Non Presult_supports_subRs andr  kfinallCaCold_ def _id(obj) return obj _module_cleanupq![]5AaddMC (function, /, *args, **kw [@"""Skcas add9,wCthe h items are called even ifiRsetUp} s (unlike tearDownQ)."""2 ]#, )"doJ&s(Execute all %Ups. Normfor you after w3ionslwhile  x(, - =3G.pop  6I(k! EQ1ion&xc%p2exc#if6# SwallowsXbut first-. If a multi-ShandlR{# gets written we sL use that here instead.nCs[0] skip(reason8pUncondi*0 a YldecoratorOif not isFance&g, type,0@ools.wraps/g$z_&=per/ _g4kip^ &"P.__un1st__M +@why_/reason 2 return test_item if isinstance(reason, types.FunctionType):/3A2 = 1W = ''wdecorator(@)$  def skipIf(condi,k1"""=aSkip aEthe 3 is true.*2&if":v 6_idoUnlessu3 ?not)expectedFailureoq.__unit5Ring_f7__ = True#+;p_is_sub-(Aed, base a'Stuple$Iall(XQ for e in G  ) and issubclass!  _BaseTestCaseContext: __init__(self,xH_cas.*& =%GTraise2 , wdardMsg`msg = "T._formatMessageJ.msgDZl CPExcep`U(msg)pAssertR9s ()u,_regex=Non>b.v!o% =e !$%if7A<'j(.compile]4  obj_name = Rhandl , :, args, kwW!If&empty, a`/Warnsbeing used as av@c& manager, so checkra 'msg'MEspcall a able pass1pos!alRukeywordMarguments:try0if ux,>__Y +Error('%s()Y 1 must be %s' %: (sV_str)N5 self.msg = kwargs.pop('msg', None) if kwargs:*)raise TypeError('%r is an invalid keyword argument for 'MQ'this function' % (next(iter(N)),)return self jcallable_obj, * =s'>tryN.obj_name = L!._)__Gexcept Attribut#YHstr(] AwithI5(C, **)kfinall# bpo-23890: manu# break a reference cycleK! => class _AssertRPsCont CBase)b"""A c,ager used to imple>TestCase.ac* methods."""_base_typnE1ion_str = 'an Aion 8or tuple of"s'edef __enter__(  .3xit-,W value, tbFi|%Y0c1exc! =+.expected*U!trY "ifw. ,!._>Failure("{} not d by {}".format(|,B%z <Oelse WS traceback.clear_frames(tbD!if QissubR,Y)# let un` ep=0s pythroughEFFalsv# storeA , yEout ,later retrieval[hR=K_.J_G( ;o_regexBTrue9 j 4.search(y)l_'"{}" does`match 'x ~pattern, $ !__'_getitem__(;s.GenericAlias) c lass _AssertWarnsContext(RaisesBase): """A c, manager used to implement TestCase.ab* methods.""" N_base_type = ;ing_str = 'a warning /or tuple of"s'Zdef __enter__(self# The __Rregistry__'s ne be in a pristine state fyAestsMto work properly..vH list(sys.modules.values()Mif getattr(v, 'k, None8</v./U = {}.$s_=Bts.catchs(record=True)E? = U.}:z!.s*filter("always",Jexpected7areturn 3xitQ, excH ^G, tb'GA%ifeq is not# let un3eptions psuthroughV5:tryU0nam$]0.__%__;except AttributeErrorM!tr.Qspfirst_ms=gm hw = m.message:!if=isinstance(w K5s=inuJ !is@ (<= w h_regexI and4C8.search(str(w)9t# storemlater retrievalz @file$ Dalineno% # # Now we Py try choose a helpful failure ;if O _rFN('"{}" doe '.format(lK pattern,  &)) !if|A.objq ^Y 1"{}triggered by {}",|Nelse._raiseFailu%re("{} not triggered".format(exc_name)) class _Ord$ChainMap(collections. ): def __iter__(selfseen = set()-for mapping in 3R.mapsO"&k + "Aif kE.en"&f.add(kuyield kTestCase(objectR"""A whose instances are single test cases. Byault, th!`ode it should be placeda method dH@'run'X!IfOfixture mayCPused 8Gmany, create asNi2s aneeded. When@tiatpsuch a H1sub, specifyconstructor arguments" o.OAthat%\ is to execute authors?their own Ds. C1ionreand de8ion's environ3 ('o') can beDPimple!ed by overrid3 'setUp' j'tearDown'@s re:ctivelyPIf itnecessaryWe __init__G[Bbase $ must always+@callIkimportan4at Oe/=RchangQsigna~ ir Gsinc+.>j edPomatiyRTpartsframeworkL@in o"cbe runE6Q, you seese attribute* failureExcep: determines which eP willS0rai2whe]a0ce'g0serQsj;H2thiIo`deemed`have ' ed' rather than 'errored'./p* longMV+gee6 " m!s (incluqrepr ofG!s sPin as)printed onin *addi*Q0to explicit pZdmaxDiff:RQmaximum length'`a diffrm+by u9Rlib. looked up c:1 soUbe configurindividuals if require2""",uA = AV@ionE'r = True = 80*8 # If a st%5strMultiLinH&')`?,Eobj,6 QAdd a% clUstyle</j6.EThiss Case sub`hat neo register5their own`provide nicer sJArgsobj: The datnPall te on when both values are of the same type in assertEqual().;&function: The callable taking two arguments and an op1)alHEmsg=3 that raises self.failureExceF with aK useful error message when re not e5"""[__&@ity_ s[pobj] =  7def addCleanup(B,#, /, *args, **kw !):8 """Add a0Ob, to bt'edVest icompleted. Fs0ed ed on a LIFO basi%re'after tearDown6to or success.h itemsteven if setUp Ds (unlikec.).cPs.append((v,:3s, M)@classmethod3assO(clsSaHB1, e]C Qcls.__h rmRHook # f0ett!upixture before exercis&6it.(Bpassyo+rdeconstrucy vzsrH`* f@runns*"."b Oall countTestCasesreturn 10adefaul2oResult3r.Z(pEshortDescri DA"""Rzs a one-line d1,X@None-%no=/has been provided i af$issafirst %oftspecifiedz<'s docstringARdoc =_M5Doc]H.Ip().split("\n")[0] OPelse  ,idmreturn "%s.%s" % (strclass(self.__ R__), testMethodName) def __eq__7, other):!qif type) is not *.return NotImplementedj2 ==|*._>Chashu&(( ?strP"%s (%s)" ]T /, s d?repeF<%s W@=%s>p\7/ )qaddSkip, result,tP_caseGasonQ2 = getattr(6'', None)3if $ G!( {GJelse5warnings. q("TestR0 hawm`, skipt reported",` RuntimeWg6, 2).fuccess@contextlib. qmanagerv0submsg=_submsg_sentinel, **paramsB"""RU#a _ ` that will the enclosed blockof code in a ~0 id{ fi. y >optional message andDkeyword eters. A failur[C]QmarksUEt1 as6xusumes execu1 at9cend of H, allowing furSto beU5ed.:5""" #ifpoutcome1 or.@_supZssFyiel5}uparent ={1 ifb"!isg _~ s_map = _OrderedChainMap(R"@..new_childGxS,!am:tryCwithVQPartE!or(.]@, is>W=TrueXn/ifs @*#ifB) -3and. Nfasti?raise _ShouldStopa,el.expectedFd V # If th#e test is expecting a failure, we really want to  # stop now and register theS$edP.>raise _ShouldStop"0finx:xself._sub= parent $ def _feedErrorsToResult(41, r 1, e)W1for, exc_info in'&}if isinstance(, _SubTestQ+rC.add$3.8k_case,w):Gelifs not None+subclass(P[0], .ExceptionGF 2?elsL JAaddEy$edw:tryE# = a}e Attribute Zwarnings. ("W0 ha {`method2porQs passes",} RuntimeWs oQqSuccess$3"Un(edbF~ =  y4 a  &# We need to an actual^traceback*$ad # otherw.clegacy can choke5 GFAfrom6r/v_0 +x Dsys.j/() h)callSetUp !.s 0Mk5,(9aarDown7/l#te 6bCleanu`, funcL, /, *args, **kw S'(#"ruj=C$if!is" =pdefault(.startTestRun = getattr(result, 'startTestRun', None) Cstop l = get@?8if cq is noth:hs*(Jelse-  M.LV(selfM:tryLtestMethod4 , &._!;NamDif (._class__, "__unit?_skip__", False) orG0C )B# If the R or m@was Mped.xo_why ='why__', ''Z %or3P QYuaddSkip,6rreturn expecting_failure i @,P `outcom"_O  ' &._B ()Swith .PartExecutor\9bcallSetUp%ifYsuccessJ~ '= =  0f@, is_=True\F.( z1 $arDown()doCleanups@for , reason inokipped[_K,4feedErrorsToR(,zeAR.if9Vo2edF848AaddEp6 N t$UnSuccess(result)/ _else:-result.addSuccess(self)0rreturn / ~finallyc# explicitly break reference cycles5outcome.errors -> frame  & ## ,.expectedFailurGP / YW~.clear(/' O = None W!# JD the, no more needed4#._j Z.stopTest4if Run is not)"()def doCleanupL9"""Execute allnup functions. NormN called for you aftertearDown."""  Ror _OTbwhile *{C, args, kw+ =5G.popX:Dwith.testPart"ort k53all>(*zB, **l6## Athis.0bac&ds compatibility'# even though weflonger use it inter5ec".s+@classmetho3assfs(cls) ?ass/C Dcls.,a_excepgU = [] +__:/tr"($ EH".append(sys.exc_info()> __g!__', d8run'dsOQdebugL I  out collecting Pin a R:Mb = getattI,!FNameHif (0#.__, "__unit;_skip__", False) omeC,? >A# If`B or .P was zEped.2o_why ='test_skip_why__', '') or getattr(testMethod, '__unit_skip_whL Mraise SkipTest(-%) sself._callSetUp(@<|)garDownFcwhile Lleanups:~function, args, kw+ =58.po:VBallCZ(L*EB, **O@def (?, reason)0"""1` this dE.""" R>P^CfailZmsg=None\Fail immediately, with the given messagev.aureExcep7G(msgassertFalseoexpr, Check that+ession is fE 0if #,5msgrformatMP, "%sM2notQ" % safe_repr(O)KPb?Tru.:truq0if %T8_\ , standardMsgkaHonourClong Pibute when generating \%s.8If C1is c%Gmean* Use only an1TlicitU` if itprovidede* Otherw1use?"foy7g S/If$s , plus ' : ' and9expR:S.L`return8 orS!if0is \>5Msg7:try,# don't switch to '{}' fin Python 2.XI#qchangesway unicode inpuWhandl:'%s : %s' % (e" UZ De`ZErrorU Vd`'),|9 :R2s;bected_ Y1"""bunlessI of class expected_exception is raised !by the callable when invoked with specified posiJYal anFkeyword arguments. If a different type of ex, it will not bPught,ptest case&(beDdeemed to have su}d an error, exactly as for an?unexpected(. "!If) 9'an omitted,return aLcontext object used like this::xelf.assertRts(SomeEU():c7do_something()[AAn o ).#('d'> ?.bar').error('second7 E 2cm.1, [Z:foo:,) `'ERRORD:]Z# Lazy importoSavoid` if itnot need ._J" b@, noX}s=False Noc :?  *no?are or its children. This method must be used as a context manager.75""" from ._log import _AssertLogsCB-oreturn" (self, logger, level, noXrs=True)def _getdEqualityFuncCfirst, second):{"""Get a detailed comparison functi or the types of wwo args9R s: A callable accepting (, msg=None) that willraise a failure exFaon if H3 !=p with aful humanI1eaderror message f#os#F # NOTE(gregory.p.smith): Isidered isinstance1(u)N and vice versa. I optedeV ervative approach in caseIsubclasses are not intended tontheir superNK @s usa# eV3. &pans tesJ0subs won't automagiyBt. CallersMThould7"irspecific artSpam#to0i is desifpriate)R# See`iscuss)in http://bugs.python.org/issue2578B#yp6)=90er @lf._+__`s.get(){B#if3 erk4 g)yW, strC*$ = getattr 7!g._base& p#k"""The defaultAimplementaqts.!ifwr =didardMsg = '%s %s' % _common_shorten_repr 4mCrformatM@(msg#anj 8R8UET:I N@Fail)wo object!unAdetermined by@E'=='  operatoZ1ionHassertion_func(f'irst, second, msg=msg) def assertNotEqual(self, f6aNone):7;"""Fail if the two objects are eM as determined by+E'!='G operator.5""" bif not3 !=@msg  lf._formatMessage(msg, '%s == %s' % (safe_repr(%),kKL`9)))N`raise S.failureException _Almos pplaces= t Qdelta0/un(irmdifference rounded to given number of decimal D (default 7) and comparingKzero, or<0hatfGpbetween" is more tha E..H1Not2tp (from )qusuallyHsame\as significant digits (measured O9+)Iw {"thy will automatic6a{2L # shortcut`u returni alta is+ _LTypeError("specify $B/Sboth"_b = abs# -I "biff <=t gstandardM! within %#( P) IM #;"7iffJelse#if 9= 7Z;6(,G)_0E[!rT \Wt R > W def ass(ertNotAlmostEqual(self, first, second, places=None, msg /  Qdelta)%):*"""Fail if the two objects are e as determined by+%irD difference rounded to' given number of decimalD (default 7) and comparingKzero, or~0hatfGpbetween" is less tha!(. M@Note'tp (from ))usually noX sameIas significant digits (measured O+)OtutomaticUfail.5""" ialta isGsW*[ raise TypeError("specify ;Beboth")uq = abs(# -# !ifB$==Cb> 7UeturnstandardMsg = '%s == %s within 7(%si)' % (IMafe_repr/),"# z" Fiff)=Jelse#iff 9= 7g (mn) != 0^rsrdsSK|H%5))m@._formatMessage(msg, gK4ureException6^def assertSequ`@seq1'q2 seq_type"An3ityWion for ordesgs (like lis nd tuples1For[purposesthis func, a valid_ &on'which can be indexed, has a length,operator$JArgs,R: TheK&P]Qe-Bseq2122y6expected dataodcNone if no  datatype should be enforced. ,-msg: Optional message to use on failure instead of a list ofIUdifferencesj5"""-qif seq_is not None:!J"u_name =2!._)__.!ifG isance(seq1,6)]araise self.AExcep('First>u a %s: %s'|M % , safe_reprI1)))L2'oSecondO2?els A"seqZ%" 7Qing =:trylen1 = lenD*e (TypeError, NotImplemented xP%s had@gth.DNon-e?' % (x )6if j!is SFlen22."V3= '$)T'11 =2[freturnL 3%ss^ != %s\n8.capitalize(),) +_common_shorten'2)for i in range(min(,S+2)1@item=[i]QIndexeS+= ('\nUnabl iQ" eH! %f$i Q !(i)w -Zbreak #Oseq2ys{ I if item1 != O2: differing += ('\nFirst element %d:\n%s?' %N a((i,) + _common_shorten_repr(,?)))NYbreakNelseif (len1 == len2 and seq_type is None L%`(seq1)+>2))i3P# The^uences are tame, but haveAR/s.{yreturn  if01 >  %s contains %d additional '_ 's.\n' % 9!_nY-?try' Vcextra qRNr2, safeC[]A except (TypeError, Index bNotImp!ed Unable to iOj wQ'of fcLq,Rw j$el<s \nSecond I!2 1\121szstandardMsg =o'P + e.join($(Plib.n (pprint.pformat 1).splitlines(),=A=2=&)) self._truncateMessage($,6Msg+m:8Wmsg, =4.`fail(mKNdef {belf, m} @max_01 = RqmaxDiffO5if # or(7E) <=! y! +X  (DIFF_OMITTED % len(diff)) def assertListEqual(self, list12, msg=None):7;A"""A&-specific e@3itySBion.g0FArgs>c: The firstN to compare.l.2.osecond/ msg: Optional message] use on failure instead of aR)ofx|differences5""".9.N@Sequ+RL, seq_type=)&RTuple<U0, t1(&>1d6 1K R )Se# se"?set?set&`?setZ,- K 5 uses ducktypingsupport \ t ssets, andOis optimized for # }ally (parameters must aaFkce method)g9:try901 =|&1.()eexcept TypeError as eO.('invalid when attempt&h: %s' % elAttributqargument does no.t221A)!ifP(E1 or7ce2Ibreturnlines = []s'if@1M/.append('Items in tZbut not the second:')  for item in difference1:%0lines.append(repr(7)N'ifA2A =`'Itemsq`the se set but not _first l  standardMsg = '\n'.join(self.fail( _formatMessage(msg, J1)) adef assertIn9, member, contain msg=None),"""Just lik2lf.G`True(a31b),(with a nicer default mA.""" #if|[&inw(!%s0Pfoundx%s' % (safe_%),iEEHDmw(/Noz<?in ~(zunexpectedly Be/ O#Ispexpr1, ?2,  s}"p21 i 2 , =1a?2<_IsNot`7!d ` identical: n-DictEqua, d1, dk|@IsIn1ce(1pict, 'F argumentba dictionaryiN!2,/B, 'SO kko1 != do %s != %s' % _co mmon_shorten_repr(d1, d2) diff = ('\n' + `.join(Plib.n (4? pprint.pformat(d1).splitlines(),<2<*))standardMsg = self._truncateMessage($ , C5Rfail(?=Wmsg, B1)) def assertDictContainsSubsetI1, s sctionary, msg=None):F."""Checks whether di1 is a superset ofUE."""Awarnings. /('LPdepre/d'D#BionWY*stacklevel=D`missin%[]mismatched = for key, value ingitems(&* if-@ not*&L&.append(keyCelift'!=p_[key]OR'%s, expected: `actual 5' %R(safe&, ( T5*!if6(F or  fbreturnfX = ''UP 2 1MB ','P0m) Em in]z'if (if pf+= ';  MsiUuvCountEqua, first, secondiAs that two iterables have the same elements,number of times, without regard to order.-]er(list() 3  Example- [0, 1, 1] and [1, ] compare eH.5'5 2#un45D_seq 7 = , F:tryK = colle$s.[T4lections.Counter(second_seq) except TypeError:!# Handle case with unhashable elements3differences = _count__all_purpose(first/, :lse1if 43 ==2 oreturnG0if  vstandardMsg = 'E s were not equal:\n'U1lin$0['F has %d, S: %r' %B for !in]X\n'.join(l self._truncateMessage($,q:MsgFm>dformat<Wmsg, A 82`fail(mSdef assertMultiLineE:(-,0, msg=None)A"""A@ that two mJ- strings areA."""y~@IsInc3r, @argu1 isaY'.LMN!# don't uselib if thetoo longXrif (lenA) > Threshold or48450[Bbase I6 P a.split(keepends=True9' 9;0if nA)xR1 and.Mp('\r\n',CA = [z + '\n', [.x%s != %s(_common_shorten_reprd &.0\n'k0Plib.n ?D )J Q C?R !) 8CLess.Oa, b%Just likeA(a < b), buta nicer default m ;#if :< b "'%2@lessnR(safeFa), bb)) def assertLessEqual(self, a, b, msg=None): """Just like ,.A#True(a <= b), but with a nicer default message."""Srif not =jqstandardMsg = '%s*less than or e to %s' % (safe_repr(a), 5b))r[relf.fai._formatMg(msg, ~1)) >Bdef Greater0,>/(?> b.g1%cZ1>Z)=,]h Isw\?obj}Same aspobj is E/),:>5 i+ ~_obj),s;tkIncluded for symmetry Lnd unexpectedlyf'X\(@IsIn}(ce?cls4isiIFKcls)O( %sM4an o of %r/ J1?NotM< !$] assertRaisesRegex(self, expected_exceptionr)?, *args, **kw %):,"""Asserts that the message in a raised w matchesw%. LFArgsZ4: Ee classc to bep.U G!:  (re.Pattern object or string)W IMkPfoundTerror {/`: Functcalled antra posi 0al 1 Ct+ "amsg: O$al ux in case of failure. Can only/%awhen aRN2 isXacontext manager5"""U%2= _*OC<(+, )Qsreturn X.handle('!',M", 3)i3defBWarn $warning"!(triggered w "pXsBasic fN0ingpsimilar\q() with1add_Ctes whosbs alsoB@regudexpressionL0are1sidsuccessful?/es : -E+s P (N *Z %  msg=NoneAFailtest unles e E!.if isinstance, (str, bytes)_2" must notaempty.r exp ected_regex = re.compile(exp3) zif not .search(text):,3standardMsg = "Rjdidn't match: %rSfound in %r" % (GK tpattern, v .# _formatMessage ensures the longoption is res ImZself.Rg(msg, "araise 8failureExcem:!) fdef assertNot(3J, un, msg=Nonedq"""Failstest if xapregularression."""pif isin>ce({(str, bytes); - I )- = N1_ 'EX!edZ4 ese['[C[+.start() :G.end()], . *]< _deprecate(original_func'&d(*args, **kw .warnings. 'Please use {0} bead.'. .__name__)DBionWt:, 2yreturn . # see #94240UnlessEqual =Gs = \=!If91Not<?|RAlmos8IL O'IfK7NotN #QJ_LTrue2R^j0/IfTCFalsUw7=p1 \7 pMe!25 $) class FuncTestCase( WQ"""A c7that wraps aA. This is us eful for slipping pre-exist test functions into the unit ramework. Op)ally, set-up and tidy JRcan bH supplied. As with TestCase,l=('tearDown')Q willalways be called if?x('setUp;ran successfully.HA""" def __init__(self, AFunc`Up=Nonadescri !):O3`super(B'^%).m)1Qelf._6 =V+Up # &%st" "7 = 0if pis not ! &()\_!b ,e0runx d1,id,creturn3.__name__E__eq;Zother4!isinstance("Z_class__2>{NotImplementedr+1== ]\=% g <R?] w%7 o:Chash["b((typeT, K9)___str"%s (%s)" % (str%._as ?rep<%s tec=%s>(1fshortD 3K 21doc;.__doc__%F,doc.split("\n")[0].strip() or1 Q _Sub6(): $!_cmessage, params ;3 = e! = #t# =}lf.failureException = test_case.failureEx def runTest(self):raise NotImplementedError("subYs cannot beE directly")]_subDescri eparts = []x0if ._message is eJv_msg_sentinelN.append("[{}]".formaS-))nmparamsOams_desc = ', '.join(=t"{}={!r}nFk, vd#Qfor (2 inww.items(/ E({})`75return " "A) or '(<6>)',idCF{} {|KRid(),)XshortGaA"""Rs a one-line n- of the ,None if no2has been provided.'5""" . __str__0!+"""Loading unit s. import os $re %sytracebackEtypefunctoolwarnings from fnmatch l,*.$, suite, util __ = True # what about .pyc (etc)e would need to avoid l1ames multiple times # '.py', *and* %c' VALID_MODULE_NAME = re.compile(r'[_a-z]\w*\.py$', IGNORECASE) class _Failed. CCase_pMethodN = Rc__init(1, m*_name, e{L_& =&gsuper(Q%).mg Ugetat , }G#!= 3nhdZ[Gure(h =w@0 R`_make_2ed_(}CoN0= '8o module: %s\n%s' % ToU I?CI+)sN0s): messFage = 'Failed to call load_tests:\n%s' % (traceback.format_exc(),) return _make_fM@ ( name, exception, suiteClass, message) defFomethodC:rB = __Test(D  ((A5,))bskippe!W)`@case.;U(str( )tS\S(self:>Apassattrs = {': 9}&[ = type("Module^A", ((qase,), Z*4),) jython_aware_splitext(path0if  .lower().endswith('$py.cZ'+3Q[:-9]0os..ga[0] I Loader(objectZ1"""IRThis +is responsible for1ingVs accordo various criteriaNBand &phem wra"Q in aS.M`Prefix'&@sort"0sUs[= static(util.three_way_cmpFNamePattern.BNoneX.g_top_level_dir = ;<__init__`super(Kx!, .0Q.erro[# Tracks packages which we haveed into viaeQs, toG@avoi(fe re-entrancy.&_Eing_r= set() ("PsFrom ACase,!PcQ"""Rea@ of W ys contain I!Jif issubpc;raise TypeEl ("} should not be derived from !AE-. Maybe you meant<JI&?"!ge  =!if D0has 8`, 'runv A5= [)1ed_@ 31lf.  L(mapn Vnr(Q|# XXX After P] 3.5, remove ward compatibility h@1forQ# use' deprecation via *ar4gs and **kws. See issue 16662. def loadTestsFromModule(self, m , *args, pattern=None,X!):GK+"""Return a suite of all test cases contained in the givenh5"""M# This method used to take an undocumentedunofficialB@use__Qs arg3. For backward compatibility, we stilIaacceptE (which can also be first position) but weignore ita depreca4 warning if it's presentipif len() > 0 or ''`6kws9Z s. (35 isV5d',F DW).|try_P = '.'.join(gL/7 = __import__(K5YbreakOexcept IGEnext_attributJ_.pop(tb# Last so we can0 ituser if needed _make_failed(N , .CC/ot `0# Etop level  @: reC tha!Ss.append(_: 1Sobj =F1for1 ins+pparent,V =P, getIQ(obj,H AlZ as eo1# WR't traverse somy^\Iif ('__path__'!)1notv7andZ/-`# This)`a packD(no z p lib docs), gwI# encountered aj[oCing.*Otell#difference betwee`.Wrong +L .w5_ Fjust -5is more inform: self.errors.append(_message) rreturn *Mcase&]else:K# Otherwise, we signal that an AttributeE has occurred.P, = _make_failed_test(Cpart, e, ssuiteClass,2!'FX to access a:\n%s' % pt traceback.format_exc(),)u+if isinstance(obj, types.ModuleType)loadTestsFrom2D/ela) and issubcc7 , G.Q?Casx0C z(Function bparent ++ >pname = jYs[-1]O@ent(+# static methods follow a diffeZ pathUXf not0get(o!, g)s.  ([J]0SY Z5objif callabl 1v = obj(y q'/, | 6/ ! 6N$|G ([>(+%`raise  (" ring %s ]aed %s, a X9" %] #,.` ~don't know howUI from: %s" %!) Idef `Names(sAs, mcH=NonB"""R[ar of alln]`und usthe given sequenc`of str%specifiers. See '6()'\1"""@Ps = [.9AQ) forS1 ins ](a84get6L 1Uorted ;,0 fo9within testCaseCclass 5""" def shouldIncludeMethod(attrname):+>tif not .startswith(self.testBkPrefix?Creturn False\<Func = getc(PCaseC,w)8callable5H|fullName = f'%s.Y' % (k .__module__, @qualD O HPatterns is None or \Dany(fnmatchcase(2, p@T) for O in e Fns = list(filter(,Q, dirv&))L"ifnUsortTjsUsing]v.. (key=functools.cmp_to_keyl# QxOU 9`discovQelf, E_dir1 ='8*.py', top_level#=["""Find and s1all  s from the specifiedsdirectory, recur into subies to fnKthemsMs found  in|rm. Only0filMAhat 6!EwillMbe loaded. ( shell style3ERing.)dAmust be importAtop c2 ofuroject.Iq0]D2yKKi%eparately.BIf a?package & (In '__init__=)`mQ{#qchecked0a '_!' uion. Ifthis existsU5it LBalle  (J"ersg) unle"Ohas already had sB\yinvocation,|`which  hmH0 obPscannc%orO 2 - Ansur_at when aRTuses ;VurtheJQchild@`at infeqon doesjhappenXeay>S*not*Sej,Nis responsibleDing gsUH The patte.rn is deliberately not stored as a loader attribute so that *packages can continue discovery themselves. top_level_dir{j%soOp_tests doesneed to pass this argument in54er.uE(). Q@Path1rted before being impoto ensure reproducible executionP oreven on filesystems with non-alphabetical 0k0likPUt3/4.N5""" set_implicit_top = False!.ifBNone and self.7 b$:Fk# makeN opal if called fromSin a  Q =0/el 6Tru x@tart^ #os.path.abs( )8!if} p"syA `# all  modules must bedaOP!thz  directory # should we *uncondiply* putX sBFfirsK4in .minimise lihood offlicts between inst wd!opversions?0{.insert(0,x).=-As_no11ort] /s_namespaceLes = []4if disdir(*o]*))% =C5i"ifO+ ! ^/ isUjoin(, '__init__.py')rJelsemP# supG for0dotB ] :tryN_Vort__"except I^ErrorFi _Cthe_=  %s[!0fpart =.split('.')[03Lg ?-0dirg&((0.__7__)7 KAN # l ook for namespace packages Otry:,spec = the_module.__/__3except AttributeError^_None P0if nA and .loader is 5Z9B.sub_search_locationsD?notH 6is_K_= Tru-}zpath in:/__=@if (set_implicit_top(5=m .startswith(top_level_dir))QcontinuevPself.dO = \8e(Yplit(jwj8 .replace(".", os.Yep))[0])tests.extend(Qfind_,D patternG-=)Jelif7 __sys.builtin## 0 Q raise Typ`('Can ;useD?s 'G 7 'as dottedq') fromLOelse C 'don\'t know how to discoverO{!r} h.forma)  !ife)  30get?pectory_cainingEeOpart{yaremove2 3 QR0if oSkortabl aImport0('S@B dir5i$Bq %r' % i)X~ = listpS#, 7qreturn suiteClass(test$s) def _get_directory_containing_module(self, q_name):=Ar = sys. "s[+]*full_path = os. @.abs(1.__file__`%if-@base~(J).lower().startswith('__init__.py'NereturnR1dirQa)FelseM # here we have been given a- rather thapackage - soXJ0allI can do is search the *same* 2*+inLshould an exception be raised instead4 -5Q_from o0if @ == @._top_levell J5'.'< _jython_aware_splitext(@norm*()7@_rell+,assert not+disabs(WP), "P@must]z!inproject"N@ ?..'PQ5 = Mureplacesep, '.'a9 H __import__(Y!]f\match)%, ],(Gternp# override this method to use al/aative ^ing strategy!fn#0pat<*find_testsL , space=Fals@"""UXpby discy. Yields W suites it loads.""p# Handl$e  J3is 1kAelf.(#('.' when & @ (anf:bUP# def_U a%)."ifu != TP#in{ ds1V whilAcallt\jTQFromM 2s, B_recurser*:Y9+!ifs_G;Non^&yF) ma+ot A?A# Ei rror occurred, or load_tests was used by the # package.ereturn# HandleG contents6paths = sorted(os.listdir(start_dir))M@for 21 in%s:Qfull_ P= os. V.joinL,7Q6, should_recurseelf._finY(p>t[tern, namespacei1if l is not NoneQRyield) m+if;# we found a that didn'tx@get_R_from ;s.CCing_`s.add(E1>tryJu U%s(nKofinallh] ddiscarLdef >/, v=False)C"""UUfqovery. cRLoads a single file,a directories' __init__.py whev0pasi5the1jRs a tuple (2_ort )35"""@base w%if isg%-!if) VALID_MODULE_NAME.match(ec6# valid Python identifiers only,!,  #!._} f # #!he l1es,9 ittzVmodulNmk except case.SkipTest as _make_skippeYWB, e,suiteClass)r '`error_", `messag\6.failed_importV D!ks.append(_yn&k?els>@mod_+c0abskgetattr(A, '_?6__'h))  realpath = _jython_aware_splitext( * 0os.6.?(mod_file))01fulco_noexti-N_|j4if .lower() != 32:module_dir = dirname(];_';i@baseC(1expected?sg = ("%r  incorrectly imported from %r. En/ "O@ "+tIs thisX`globalUnstalled?">qraise I|_Errorylamsg % s-,m (, # return self.loadTestsFromMUule, pattern=), FalseEelif Wisdir [if (not space andI" isK(Fjoin^, '__init__.py')))oMDNone q _t0 = & " ==A_get_' >tryypackageOQl( Lexcept case.Skip^ as eb_make_skippedWB, e,suiteClassLr_e_", Bmess\PFrfailed_f D!ks.append(_y *r& %?els> #getattr(6, '!',B}b# Mark9being in C (possibly ;_/Cing_KQs.addzqRQ?] O(if0is O./#2wQ) has!2ed for us.P- return tests, TrKue finally:(self._loading_packages.discard(name)9JelseGreturn None, False defaultTestLoader = "()#b _make!(prefix, sortUsing, suiteClass=_testNamePattern)h.YqMethodsd& =p,i(P2 = %0 = 8/'if :\V1 geV@Casei s(s(,G=util.three_way_cmp,`Iu w /). )S ='X' -T8 .e<W ).FPsFrom s(x.Dfind*s(module"= =M%(\) """Unit main program""" import sys argparseos from . -Rer, runnertsignals$installHandler __u= True MAIN_EXAMPLES = """\ Examplesm %(!)s_J- !s +5 B=sC B +GC.k" Gspecified! mApath/to/<rfile.pyA# MODULE3Uiq set ofs Myz E@' '''?X' So 4ing)8 D mAall d!*'o 16in bdef _convert_?D # on Linux / Mac OS X 'foo.PY' is not ab2abut on# Windows it is. Sir to do a case$ insensitive match # a better check would be tothat the name is a:valid Python modul$. if os.path.isfile(@Q) andJ .lower().endswith('.py'):> B2absA $@rel_d% =n0rel.,getcwd())Z: ^KT) or b.startGrdirJareturn f% =O# on Windows both '\''/' are used as 7separators. Bto replaceJ@thanrydeth.sepFc[:-3].?('\\', '.')/>: def _convert_s,[#Q) for," i4;s] P`selectptern(pan[if not '*'A = '*%s*' %FH& class TestProgram(objectn"""A command-line p'  runs a set of tests; this,primarilyz! amaking+8!s Hniently executableL1"""@# defaultsHl1ingmQ=Noneverbosity = 1failfast = cbreak = buffer =N= warnings =Pe_discovery_parsFq _init__(self,='__main__',~b, argv G_bRunner%Loader=l.&T,Jexit=True, /D=1, *`.LF!?*, tb_locals=FalseZif isinstance(L, stfA. = __imporZ `@part p.split(F[1:]- `qgetattrv , RhJelseG Cx-!if# :p = sys.  6S0 =  % = !  %& = #- .#%ifkzoptions# even if Depreca$W#ignored byFv# print them anyway unless other warnings sett Ware # specified by the5aarg or-W python flagBUself.i= 'default'&Uelse:}z# here ;i1 ei!toyvalue passedC"{Aargs{o None./!IfQuser didn'tW2 a d KwillA"beX This means thatWbehavior is unchangand depends on7{sed to -W =!swTest =  'testRunner = %ELoad% %progName = os.path.basename(argv[0])2arseArgs 0runAs() 6def usageExit(`, msg=)K if[print(msgc"ifj_discovery_pS Bo._initArgP)]gf_help(iPsys.e2_+<0, *`, **kw #p.moduleLOc._mains.format3MAIN_EXAMPLES % {'"': }; 9.Rlg'"_ODULE1b , \%m{bif lenP > 1 g[1].lower() =i'Z%&doTP7[2:2)areturn@_JJA1:], aif not.s0# tallows "p-m unit4@ -v"still work for#] o " [aH Q s = _convert_s s^_#!____#BdupportVd/..0= elif sel f.defaultTest is None: # create"s will load tests from self.module;(qNames =^"elif isinstance(.j, str)$R6)as ?MlistCB01() ^8defB,  _discovery=False, Loader=Y"if6PatternsE../ =F+if `(erFi3 ifS else(!d%! =4er.r.start,p6topLM3$ .QFromMnW V,sIa_initArgParsersqBparent_pQ_getP9h__main7FMain5 ^6ByGDLa s1arg.Argumenser(add_helpn. r. a3 ('-v', '--verbose', dest='Oity' action='store_const', /=2; "'Vy output'Yq@quiei70Qwu-localsS4tb_ SOtrue IQShow a variables in tracebacks]mofailfaf; 5top on first t or error09.!!= ~catchbreak is NoWne: parser.add_argument('-c', '--catch', dest='ybreak',DO action='store_true5phelp='Cv Ctrl-C and display results so far')Vself. = False$1if #buffer is No b 9a  (Bastdout stderr during tests8NamePatternsk F append', type=_convert_select_pe0Only run which mEthe given subst5/ e = [] rreturn +def _getMainArgPF(a,(Fent)h9a = arg #.Ak8parents=[ ]/r.prog = $@int_*4_pr. s', nargs='* e='a list of any numberM modules, '~ 'classes9ethods.')DiscoveryW0'%sw?' % AepilQ('For=Ry all/ must be6 'importable from top level directoryhK yprojectm!-'--start-d 6%"D1to 7('.' default)" "-p/z "4 to2S0 ('O*.pytAtop-'?top%/'T# (#sa  'start directory)') for arg in ('start', 'pattern etop'):07parser.add_argument(arg, nargs='?',04 default=argO.SUPPRESS;Nhelp8%) tqreturn Xrdef _do_discovery(self,v, Loader=None".e = '.'`#test*.py"`top = U:!ifrq is not [# handle command line4 s j W]1if _m i3#T9ingMNinitArgP&s(9#q.xs!v,ZcreateTests(fromU=True>2run6GcatchbreakinstallH`r9]oRunner3p.%1= r.P.Text=IQif isv1ncep>X, typnP:try2ests! =c_(verbosity=_[ failfastJI bbufferG E warningsGI tb_localJ  except TypeError&# didn't ac/Ethe U)3 U {w hD or svRJelse@# it5assumed to be a   uq )result = 3F.runWexit: sy8s.exit(not self.result.wasSuccessful()) main = TestProgram # mock.py # tools for+ing and patching. # Maintained by Michael Foord # BackportCother versions of Python available fro'https://pypi.org/project/mock __all__ = ( 'Mock', HagicsentineltDEFAULT4ANY 5cal&create_autospec#IAsynkFILTER_DIR#aNonCal T_openDPropertyA0seaa) imba$iocontextlib intUpprin4sysbuiltins  a ppiscorouNfunction(Ttypes&CodeType, Modul Pethod3unittest.util;safe_repr$ewraps, partial class InvalidSpecError(Excep!):""""Indicates that an i6 value was used as a 2.""" _ = {name tin dir(!P) if .startswith('_')} 0rue # WorkaroundXissue #12370ithout this, the __B__ p)ies wouldn't be set correctly _Xsuper =  def _is__obj(obj0iinstance_ $is%, Breturn Falseif hasattr50'__7__'6obj = get(HYXS) or .isawaitj (%if|, '__code__', None(<)Belse3Mj3@# caFuse s@ on 0 ob#`s beca#they overrid&# The base =j1all@s is6k1sub7(K1Ve+L &f, Base1 or*),!isL8&=,@sig( , /, *args, **kw sig.bind(#NQ_copy_detailscm(0).__41 = 1sigQ* /"_ Lv3opy#~explicitly don't <'dict__ into thispas it w# expose original a+gs that!ed76for)h(U'__name__', '__doc 8tex'&_' '__modul7tefaults<7kwdm t Y0setFopy,7, g)>5%C(obj 2Aobj,d2(staticmethod, class M)UV".__"iftr(obj, '__call__', None) is not 3: return True False def _is_list(obj):# checks for  or tuplesF# XXXX badly named!^AtypeNP in (@,>)snstance_callabl/}"""Given an object, Ys if theD.For classes8iws would be =1"""@!ifG$is- , [# already*@rgetattrA!'_ ;@# *c*broken by a overriding __mro____dict__ viaFaa metaAbasepobj,) +@.Gx0if ).UV.get(e:t iset_signature(mock, original, F=4l # creates a function with I (*args, **kw ) that deleg;4to u. It still doesJ`!by a lambdavz2samM#;"as.skipfirst = R&W10sul((_g'_((%, ^)BQif reE/is+K,# =4=sigV&sig.bind#E`_copy_b_details( ,T2ig)8% =0.__!__E.isidentifier(s@ = '^Aopy'9`contexH4{'_5_':~0, '0': }5src = """-%sO !FW !Q""" %++exec (src, $ =[]4a_setupYQAopy,@Gn9 3.! =XN!rt0ed_ FI.9 e`! 4 [$no + 8 cOed_onced9 eert_called_once_with(*args, **kw C):  return mock.assert_called_o>=Cdef 11has5sh7 a1anya`6_`reset_(funcopy.methodys = _CallList()AA+?ock) d.oCdret = Ie_value#if _is_instaM(ret) and not E!is:retwUnr = FalspP_coun06_Go = Non8@_lis< 7a^ 'Z 7! =. -side_effecM. +_childrenZ  2Z}$ =(4x 9>N70/ .6 = $ P*$nof.2L3 4__signature__ = sigdelegate|0 _setup_async+(6 .coroutin@+5io.s#:[awaitV7T R\# Mock is configured yet so the attributes are set;Ato aAtionQAthen4correspondingUu helper0D2is $ w<)is accessed similar to e.Dzwrapper(_, /, 0get-..,)(1for c in ('Aed',9  (--21ny_ * 'assert_has_awaits', '+2not+eed'): .# setattr(mock, ibute, wrapper) causes late binding@Vhence8 will always be the last value in7oopDUse partial(w) to ensurO is boundKcorrectly.s ) def _is_magic(name):Ureturn '__%s__' % [2:-2] == class _SentinelObject(oJ"A unique,5Cd, s. (!."r_init__(self0F. 8Crepr82r0.%sI%BOduceD!  ""AccessAsa , usable as a)?.""$_hs = {}g ]!ifp'__base g# Without this help(unittest.]P) raiIan exception? Q AttrUError! .setdefault,p())/reD' 3& =Y() DEFAULT = _missingMISSING _deletedDELETED _allowed_'_BP', '_O_side_effect) >fparentNDnew_vf &$ }!gating_property~ B.adddA_the$ =1' +l }7get=%, := qI"si~2lf.eV"0if %zis NoneY |gD (#ig9"s P&_dict__[2] =;els.s,3C_get, _set3CallList(listp_containslmot isinstance(", list):  return list.__contains__(self, value) .Alen_q = len( 8  if3?> !:]eeFalse for i in range(0,>! - Z + 1)O@sub_0 = lU[i:i+]`z6if .= M&ETrue>def __reprI.pprint.pformat(sQ)) @check_and_set_parent(, name, new_ f = _extract_mockif not _is_instance%Bif (K.2x2 or01 orp: 61 is_None),0[ q/2 = :dwhile |# setting a 6 ) as a childqiPof it^e# shouldmodify theR%(ifKFe|==sbVe 1 %e (\% =ga?ame]Y 0ameU"amJZ # Internal class to identKif we wrapped an iterator objectRnot. ;_MockIter(9dS_init,?a.obj =a>:4nex:5A#) @BaseG3ect3D5= DEFAULTg!side_eff = / /, *args, **kw jdpass NonCallable"(-"""A non-c! version of `.B`"""z_(cls, R# every s@ has;B own+ so can create magic methods onR0without stompAther|s0bases = w6ot issubQ ` AsyncWMixin40# C @0pec@an a3Qor function;`bound_ = _MOCK_SIG.bindBtial).argumentL@specK6 = Wa.get('set', bound_args.get('spec')) 0if _arg is not None and _is_async_obj(')):ALbases = (A.MockMixin, clso new = type(cls.__name__, ?, {'__doc__':9.}Binstance = _safe_super(NonCallable|w`ew__(newBtreturn I! def __init__(Qself,"=s, wraps  2set CSparen" _)Btate+Q _new B='',2 K>4as_=False, _eat_U un**kwargsL(ift 2 = 9#__dict__ = n!['_mock_A&']LG *a( PA*/1basealed`q?0set<? @upec_setgu = TrueZ(z1addC|,YS)K children%{} (5% (delegate+{*alM |@callsU'+Qcount,0TB_lis-_VList(m `<3kmethod_0 c B2if  elf.configure(1Qpc/).B3pec7 , xx,#)battachy , X, attribute5"""DA8! a/f as an4 of this one, replacing itsJ . s to theKRached_will be recorded in&C``^ ``Ns.Qinnerqextract(mock) inner_mock._parent = None i'?new+ame = ''N n'w*setattr(self, pibute, 1) )1def_add_spec/ , _set=False):3"""Add a"Q to aF0. `3` can either be an object or aElist of strings. Onlys on theTbe fetched asIas from5."IfG` is True)?n ovbe set."""qS86pec2`)_/!, }_as_instancet,tP_eat_(J\classsignaturZ3WPasync;&[]@fttr in dir(tB if iscoroutinefunction(g , )?C.append(2)"iftais notJA and @_is_U\!X, typA Felse 1 5Ze); reXU_get__.b o/%,  t*o0 = 3Wres[1a& =y__dict__ = w."['sAC'] =.1set,)/k6 _methods4c)_(\._return_value3 re%}-y3elfGdelegate e V3._`3is DEFAULTOQchild(C_=!, vF='()- ~/ tcG ret__c!, ojD_>" =cself._mock_return_value = '  _check_and_set_parent(self,., None, '()') <7__rW_doc = "The2 to be r$ ed when the mock is called."M'property(__geti1, _2,D ") @h@def __class__!):N0if b._spec%%)R typeDC G = _delegating_"('!')M o_count0 #4Oargs3 " 2O_lisj 7'<_o#Qside_effecCed =JI4if d EwHFsf =J.#`if (sfe1not)P and rable(sf%isinstanc', _MockIter)G_is_exceptionLN8! @f'f OWtry_iter(sQelf._n Jelseld5 = {P6 re6/ visited=,3,*,=False, M`"Restore>`objectbits initial stateP$if{~ X = []!idD) inA 9,3H.append(?' >_E! =@0ijCallList(} `*omethodRy)if p( = DEFAULTGF$Cfor childzchildren.values(G): if isinstance(child, _SpecState) or  is _deletedCNcontinue\8.reset_mock(visited, return_value= , side_effect= %) [ret = self.W_A&tif _is_*(ret) and1notI ?ret") def configureW, /, **kwargse """Set attributes on the  through keyword arguments.m\A;@plusAurn =s( 4s can be setjts using dard dot notationO`unpack$Pa dicQary iLethod call:1>>>qs = {'m$.': 3, 'other.': KeyError}dN.q **PUs)""",0for?,rsorted(.items(),/ZP# we ;=number of(s so thatG"arabeforea P, key=lambda entry:[0].count('.') =@R.spli$ iRfinal#ys.pop()3obj e j{:0get2R(obj, `s #__E2__(Gname0if !{'_Cs', unsafe'}eraise (LAelifLZfJNoneT/in;%or_all_magicsFB"Mock object has noa %r" %^ 4h mi U R I&ame.startswith(('assertSassre e =srt &0f"{4!r}a72id ion. Use a spec f> f"%H if Vmeant to&an|).";sulrren.getQif re2(name) elif result is None: qwraps = if self._mock_'ais not, FQ+# XXXX should we get the attribute without triggering codexKexecution?=_Z(, name) 9=get_child(+pparent=[O=T!, |=p, _new_ E J !)ij@ren[ZC] =isinstance(, _SpecState):try6 = create_autospec ..!, E_set,?q.4 / except Invalid^Error0tarS _dict__['Q'] or  y]raisejPf'Can: {!r} from - 'j2f'{ 4as it has already been ed out.K[K ={LA!r},#={wZ!r}]'\-ycreturn def _extractc_list = [uC]!_!J(!laMLR doa&'.p8if }= ['()']=7'Idwhile (?w.append('pj + dotR C0== 3I$ =Pa0 = (reversed()A_firX0amet' 8lenGJ > 1R=1[1]@in (,'.'i8+= 0[0]Si''.joi|_repr__*1_st9= '.!, 6 +G=%r' % name  spec_string = ''  if self._"class is not None:)1$F 6=%rN% R:setD#8HM_setL )%.__name__return "<%s id='%s'>" % (&Ptype()F,!Z  "idQG1) def __dir__" 0"""Filter the output of `dir(mock)` to only useful members.""" !ifFILTER_DIRbyobject.%extras =g}_methods or []*Pfrom_A0 = )$dict = list {Kct__(`child_r[EmmR for , m_value inEren.items(cF&if6_deleted]![esehe.startswith('_') DD9 or_is_magic(eiPsortey#t(&+  x 'l)dsetatt , !, k)P!am_alloweds## property setters go through here 9Selif Yhet and#D@ Q;?and/ _a'__&W raise AttributeError("Mock 0 ha v# q_unsupp z0msgpAttempt to 9 P q %r.' % ?msg?all T  ^_2 0ot linstance%({(2C_get(D7@original =g !}Bambda *args, **kw: =, *args, **kGw) Yelse:# only set _new_name and not so that mock_calls is trackedP1but=qmethod 2 '_check_and_set_parent(self, value, None, setattr(type6)*=1Blf._hildren[2] =pAelifv == '__class__';b._spec! GgreturnZ ?if )d 7if .esealed1hasR"mc` = f'{(@._extYP()}.{ %}'x raise AttributeError(f'Canh~{aE}') =D object._.!__7def __del)@in _all_magics6in ].__dict__c  j#inP)a# for  Bsare still MSProxy2F#[on the instance it 1kDASobj =c:P.get(, _missing _safe_super(NonCallableMock,s)tmc0is Jetedo E if> G1del:@M"% = WSforma4_signatur, args, kw @or 'q# _i d5 dfailure_messag, action='f'4 = 'expected %sfound.\nE: %s\nActual :u_stringC5=_C#aj*D{2% ( +, 93ualp);getQ_fromm2""" * If call% objects are asserted against a method/function like4.31 then there could be no name forP call; ect to lookup. Hence justNQreturP spec_signature ofK}]being.Q2* I9is not emptyO n remove () and split by '.'&ge@listIsiterate throughP children until a potentialmatch is found. A5P mock@creaonly durttribute accessMso if we ger_SpecSt ena;s1theY wM%edO0cansafely exitedP5""".!ifN:jself._ )sig = NoneJ1s ==.replace('()', '').U('.')2p"= nF_m^1 in^s1" =ren.get(0j"if"` or is0Qance(F&, )fCUbreakNelse(#pan autoB4cedBis attached us@ach_ _c#w%a Bwith|! a_oOfromOfwhich !habe deriv1 = _extract3 e-G..$Lcq2ig Pdef __0er(D,rGiven a(or simply an (args, kw) tuple), waGcomparison key suitabl.oXks@Thisa best effort relies oI&'s,if avail,falls back=argumentsYgmselveN Y,]Alen(Z) > 2Q._get'__A6[0]4@M<I: ifH 7if ,==DU = '' e %7Q/, =:try<bN8 =r.bind(*M"**)   return call(name, bound_Y.args kw!) ;except TypeError as e:#*ie.with_traceback(NoneQ;els<8 Vdef assert_noted(self)w2"""$ that the mock was never1ed.S5""" 0if P._count != 0_1msg = ("Expected '%s' to not have bee[ed. Called %s times.%spO!% .__P or '%',- ' 0s_repr())zKqraise A\1ion](msg)yu2 at least once| =| x5" %ge,_^AonlyW _ == 1 m_c`, /, *C, **0%l*Pmade NAspecified arguments.UR=Ks anA1 if> and keyworE0s pvd in ardifferentO!toN.7l0is ]e=r_formatn_signature(F#, 6 Eactual = '7Ied.'#e _message('{0%fk4.\nBq: %s\nA] R4% (K",  OO_("{ /tfailure05msg$ _matcher(_.(R, two=TrueEW) if actual != expected: fcause  if isinstance(5, Exception) else NoneJraise Asser'Error(_e_message()) from v! @Qdef a6_called_once_with(self, /, *args, **kw )2"""> that the mock was P exactly XD and*!at"+wEspecified arguments.""")pif not .h_count == 1Rmsg = ("E '%s' to be!ed1. C %s times.%snI!%  .__name or '%',- ' s_repr()))R6msg&breturnP"ed 1has2s,#s, any_order=Falsehas been=?ed %s.PThe `C|` list is checked for89EIf ``2 (default):ns must b?sequential. Thern Sextra5QbeforAafte@True!cao inh hU, butaBtheyall appear in4 9A = [~Y_matcher(c)RcD]k = next((e(e(S !),1allzPs = _bAList[.N %ifeO *"if4M"&problem = 'sYufound.'3)G !(' processing>.\nZ^Ds: {}').format(1 ?[e Z=  ],3f'{m}$f'6: {N7/)}61f'{OnW prefix="Actual").rstrip("."G 5mG= list(all_calls) not_found = []for kall in expected:<:tryPall_cb.remove(D)8except ValueErrorF{.appendF5if " =raise Assertion_(~'%r doesF contain Pof %r@its list, 'C3.stead' % (self._mock_name or '-',Aetuple( ),Q E) from cause Qdef aA_any5, /, *args, **kw )72"""6P the has beenqed withspecified arguments.}3The pSAs if7Uh*ever*\, unlike `:!rt0ed_{k` and Concethat onlyw5 ifM#isst recen1Ue.""",2 = 9_matcher(_Call((<#, D, two=True)% =4isinstance(f1, Eion) else Non`actual0c) c_"if!yin _AnyComparer(o2u_stringbformatzsignatureZMwAnot bW X_get_child7*kw"""Create1sbattributesreturn v.By default @bwill bXs 0typiv&ntDPSubcls of Mock may want to overridMo customizUe wayare madeFor non-2abl@variyused (rather thanm3any# s)TB_new = kw.get(""55if __dict__['_x_asyncs']YA9(#if\_seal = f".{kw['@']}"" ""kw6"()8\'%cextrac&U() + kC>mS_D =  B$is()p, Magic) and _new_name in _async_method_magics: a# Any 'hronous ' becomes an AEIMock:klass =elif issubc$v(_type,)jMixin)if (_new_na0ll_y9 orself._mock)d L$ ~M r 7' o MN J"Jelse4lN?notRCallableQ5Non4  \?ockW K~7.__mro__[1]qreturn ((**kw) def _calls_repr(, prefix="'s""""Renders *.E? as a string.\Example: "\H@s: [0Q(1), V2)]."1-IfZis empty,Z hB is qed. Thewoutput will be truncated if very lo+5""";0if ; u 6Rf"\n{>}: {safeX. )} _MOCK_SIG = inspect.signature(.__init__' _AnyComparer(listP"""A  which checksit contain#may have an argument of ANY, flipping the components item andQ fromCtheir traditional loca s so that[guaranteed toolTleft._#__2for assert len(91 ==  )Fif all([ ex ed<mactual#'", %1zipx, q]h]6TruFalse try_iter(objG`if objcFNone?1objif _is_excepB.;I* =trytzs TypeError/# XXXX backwardsuatibility=# but this`low upQfirstf -rmaybe we should fail early?  return obj class CallableMixin(Base): .def __init__(self, spec=None, side_effect]_value=DEFAULT,JNSwraps3Cname [4_seMSparen D_.4tat?Q_new_OA'', C **kwargs):N.__dict__['_mock_X'] = ;_safe_super(A , V%).83!,  , R", 16,k)rGelf.( = )check_sig@/, *6e@# stub method that can be replaced with one a@ific signatureHpassU_cally can't use in-case a function /pwe are 0ing4s5# in the.(* !I.increment8Oall(3r:0 V6/, * `execute q#.ed = Tru_count += 1# handle =_needs tolset here so asserAs on:P argu~ s aW befou"# "9of awaitedFs|@ = _ ((#, Z`, two=)0+9_list.append(jPitialvcff for*s2do_f is not 5J 9y @RAis_a! = 9e= '()'+X]s5p)Ifollow upchain ofsd 2ew_GXwhilevaOpw#;if  .J ll((method_call_name, args, kw[))) do_method_calls = _new_parent._mock is not NoneG;if J:$zlp + '.' + 2 X# handle  yBthisoeCall((0 ( d7s.append(a)/ifO` qif is_a"dot = ''Oelse3 .4l ~ == '()? CD + +4 -# follow the al chainv@adef _execute (self, /, *C, **'n # separate from _incrementH so that awaited functions ar*## dT"lyV`their  , also AsyncMock overrides h @ffecq.side_e 2if Eis_excep(1)&*SraisePbAelifOableE@esulDnext' NR r7.# K)# =(a]3if 1DEFAULT Seturn.E1if 4r%d_valueR); 5YTwrapsR CO12  class (Q`Mixin, 3ock1"""0CreNpa new `@` object.takes several o aluzsHrqspecify1behaviour of\[:30* `2 `: This can be either a list=strings or an existingK1 (a" or instance)Pcts a e oPificaXA for9OC. IfPPyou pU inx0n isNamed by:ing dir on H the object (excluding unsupported magic attributes and methods). Accessing any- not in this list will raise an `AWError`. FIf `spec` iqrather than aRof strings)nB `mock.__class__` returns$ 1 of ha0. Tpallows BsO to pass `isinstance` tests*_set`: Acter variantn. If used,)@emptsto *set*p`or get$z oIett isn'tDed at|ide_effec`functi~o be called whenev`e MockS. Seea'`sRK. Useful forPexcepnCs orD`dynami\py chang)p values%e %is2ith$amarguments a,unless it/`DEFAULT`,Gv|t6~^3-  iterablelan each0 toCdBnextdQ from/Nr2anye members'NGare Bthey;!be0ed 0eadA#ed2* `_c`: The;y7By defaultYB newfP(creaon first a)vW< we* `wraps`: ItemIM0to $@.2NonnCdhrough[3ped|H(&Kreal resultm/q># aN1hatcorresponf soH| ti@does-ex )CG!haexplicit_@ set`na s x#edi= f '#isp* `name0# i!be`e repr/$th>nYuPdebug"e_is propagtto chilNYn alsith arbitrary kLeyword arguments. These will be used to set attributes on the mock after it is created.<!""" def _dot_lookup(thing, comp, import_path):52try ~return get|;)-except AVError?#__`#_( i;_ 8er(target on42 = .split('.'9! =1b.pop(0$ ? = 1for?1 inGi+= ".%s" %+@i6z9 # _check_spec_arg_typos takes kwargs fromxmands like patch and ?s that #=y don't contamon misspellings ofb relat@autoRcing.b` (2_toD= ("HAt", A 2set 7s f  o$raise Runtime(j0f"{L!r} might be a_; unsafe=True if thisvintended"Q) class ch(objec'R_name = Nonr_active6es = [] 4z_init__Pself,Fter,*p, new, ", ,Jd_set, 3_callable,]D, *,BFalsF ifo<1not ) zDEFAULT#POValu&@"Canguse 'new' ' together?a %if 2b&7#ot a3if _is_instance_mock(yInvalidSpec0'|Dv% {Fare) 'ygf'has already beened out. [V ={C!r}]9Pg t. [spec_set={spec_set!r}]') self.getter = attribute = #new = new_callabl=5new )0 =  Acreay has_local = FalseNY !@auto% !kwargs = additional_patcher*2[] \def copy(a%):<,2 = 7(-!, r3new ,>*$(* )l.@_nam 58(!p.;) for p in ;7] sreturn _~!__g, funcif isinstance(g, type#^decorate_class4%Pnt.iscoroutineX6-[QasyncF7 r, 60, kruLdir( aif not .startswith(r.TEST_PREFIXW7continueqP_valuE0getz,fV.1has(=4, ""|ybps,_(~)%<@sextlib. qmanagerl/ion_helper0d, Q, key`extra_F = [  nyExitStack() as exit_s u0ing 1ed.Jings/$Warg =Qs.enter_|6ing#5"ifK should b( # A#ma list%Pthis_#*F.- N( u(6.no@Bc:M4 =-;@agic@ .a.pop('/ $new.return_value _new_parent=new, Fm='()',{NU elif autoignored, `*must*4default,jtreate# as a boolean. SwAheck@<AthatZ #,O?!if~DEFAULTraise TypeError(D%"!cs:o for you. Can'_ify "H 0and.( if original"Tuse 'r' with j=True"ma! =( & 0HWt% = /ifsotargetwInvalidSpecPf'CanC! {b 0!r}patch '"f' hlready beened out.<[==| P!r}, $={]!r}]'j0!\_` = getb(A, '_B__',target)   raise InvalidSpecError( f'Cannot autospec attr {self. ibute!r} from target 'L{ A_nam4as it has already been mocked out.K[K= A!r},$={y!r}]') new = create_)( , T_set= ,? =, **kwargs)BRelif :G# can't set keyword ; when we are qing the* FXXXX If is a Mock@could call.configure_o(+BType$!"CCpassQ to ad "z@new_1 =3temp_original = &ais_loc! _exit_stackontextlib.ExitS(:try0set(iO!, ,H%+if) @ is 9JNonek4aextra_E= {}T~DEFAULTH,L[@] = cfor patchM#indditional_?ersuRarg =4y.enter_c}(C:ing0%if.4.update(ar_vreturn .pF5newjexcept!ifU__(*sys.exc_info())3^`qEdef :H4, *<:q"""Undo4E.""" 2andz 7q,.T;els0del2 ?O e (&?hasM5 orPB in ('__doc__', '__moduleDP Dpefaults;Ia$N6kwdP=# needed  roxy objects like django&]tings arget, self.attribute, self.temp_original) ?del!is_localetargetexit_stack =Z_&wvreturn 7"._'_(*exc_info) def start(%):b"""Activate a patch, Z ing any created mock."""<eresult_enter__()"m0._aa!e_]es.append*s S "op+ Stop an [ 6try1bremove`except ValueErrorI# If theu hasn't beenbed this will fai BNone#&,  R_get_O( %, 2 = .rsplit('.', 1B(Typ,_Uaise &("Need a valid`2 to. You supplied: %r" %gO",) getter = lambda: _importer)'P." ,u_object(| /, new=DEFAULT, spec={3P=Fals-rpec_set%_ auto4new_callable**, unsafeJ**kwargsijel0namember (`P`) on 2 (``) with a\".v`[.` can be uss a decorator, class or a contex manager. Arguments `new`, `= 9!`,`:Q` and82a` havesame meanbs for r`. LikeMf  takes arbitrary keyword aPconfiguringN %3 it sDGWhen3 (shonours.TEST_PREFIX`o@hooswhich methodsPQwrap.(tif type g is str=p2f"{(p!r} musidactual toMed, not af~]s3 z,i#6,j+", E]d87_multiple(targe t, spec=None, create=FalseB_set/ Gauto@new_callable6 **kwargs):A"""Perform multiple patches in a single F . It takes the object to beL8d (either as an' orMPtring3XfetchGby importing)O and keyword arguments for7mAs:: - Bwith.@(setR s, FIRST_PATCH='one', SECONDCtwo'N2..._Use `DEFAULT`value if you want `~`Bmockyou. In this case+"d ( arssed into a decoratedNfunction by( , 5Aa diary is returned when!isOui context manager vcan be 8or, class1or Xn\G The`1`,  !`,9```R` havKsame meanpau `.tsX@willpappliedR*all*Qpes donekFW\   6 honours TEaREFIX`@choo which methodsQwrap.(1"""if type(target)2strgetter = lambda: _o$er3GOelse5^rif not O4praise VaError(X'Must supply at least [  'L#B# neAlist&python 3,re itemsaa viewK = 5(."()battribute, new =F1[0]?V_ o*, @ oA, {}ql5er.] _n=n-C#Q"F[1:]%< #  0 0ddi$als.append(Sirr def7=Ip%*, unsafe=False, **kwargs ):1"""`patch` acts as a function decorator, class or a contextG manager. Inside the body of Uor with statement, `target`M1is "ed,a `new` object. When6V/SR exitL is undone. e#IfVis omittedZ5ereplacn=`AsyncMock ie#ed9@an a&Q6?AMagi?` otherwise. H`@BusedE andJ created mEsDi an extra arguy0 toEGb%ed DzL~returned by$/8 should be a string iform `'package.module.CName'`. The|Nis impor5vspecifi #hJl1, s% Y@must^able fromqenviron]byou ar@calll1 gPgis execudnot at4timPThe ``8 _set` keyword s1 pa/& `xfione for youqIn addiA1canY`=True`?, which cause  0 be~j$/V_` allows_3ify a different,6Q, that will " edJrBy default :NF /sjCrestA more powerful#mt_b` `auto`6sett{YVd a K P.NAll attributes[also hav1W-correspondingLHGxr Method:s.H~d{'irPcheckTn|pll rais`TypeError` ifMAthey9!wrong signature. For"s #aeK2ir 2 value (J'instance')R same!as}Instead of `autospec=True` you can pass `asome_object` to use an arbitrary as the U instead ofone being replaced. E By default `patch` will failp/ attributedat don't exist. IfLin `createQ, andGU doesC!, |{K> 31for'Awhen5ed function is calledrJdelete it again afterwards. This4puseful `@writ'Rtests3!stIyour produ|Rcode s at runtime. Itdaoff byJq@beca!itbe dangerous. Withswitched on$eKo C APIactually!Py@used@a `TestCase` cldecoratorVworksPeach 5 method iDjQreducAe boilerplat>XJs share a commo"tchings set.Qfinds=P look1namat start wh.TEST_PREFIX`.Kt-`_`, which mFRe way `unit" sMY ify an alternative prefix bycontext manager,statement. HereDNH)Papplio indented block; N IfL@"as"(^ buj`IE`; very%ifa m3you(0rai<2 `RError` ifs0ed kdmisspellgoG@arguA$s _P3*@safeX th`value f`disablat checkw` takeskeyword c5ese^Qed ton`AsyncMock @is a$hronous,R`Magi6F`otherwF!or @new_pY5ifi^.dict(...)`,.multipleE-rPavailg6eS-caseb1"""vgetter, = _get_target(),return _(^ Ca, new,^,,.,/, kwargs, unsafe=unsafe ) class _patch_dict(object):#1"""P 0 a "ionary, orb like <, and restore the(N to its original state after/atest. +1`in` can bea mappingcontainer. If it is aJ'@thenmust at least support getting, s @delea itemsN@plus!raover keysBalso0strpspecify qname ofbQwhicho@willfetched by imHi2ovalues1"f 0 to0 inW2. `"`yv8Qerablb`(key,Pt)` pairIf `clear`1Tru k 1be +$ef21new@ are^.+called with arbitraryword argumentsa "::)Pt('sys.modules', my =Mock(), other_PN/..be used as a ext manager, decorator0. WB & `` honourTEST_PREFIX` for choosaq methodBQwrap.& def __init__(self, ( s= =False, **kwargs":.9$ =Cb=#5anyHyP(...)DstructorBa[=,)#.update( #" = _r= None R%%fif isinstance(f, type qreturn !e_&(f@s{pinner(*t~ ]VR|2try fW&fl;o!un"())7Y_A Eh, klasH@attrLdir( a _ =) , @if (p.starts(.9)5 i@ has;@rR, "__ +")3Ior = 1lf.s  decorate d = decorator(attr_value) 0set(klass, ,;&ed0qreturn '! Gdef __enter__(self):c"""Patch the dict."""-0._p!_(i"!inp4#r@s = .qif isinstance.]W, strGB = _importer9*9|Tclear @j6try4original = WW.copy!except AttributeErrorE#r like object with no Mu methodx# must sup iteration over keys/){}!fo/4 in m>V[key]ML_+4 = >1if P b_:(D)4 r#.update(9o+Uq(s '2 = '/unB}cR n/M+aO@) S_exitw, *argsB"""U?"ifN is not None >WFalseQstartU Activate a ", Aing any created mockXeresultu0._acees.appendu U "op+"""Stop an [ { RremovV!If1 hasn't been fed this will failjH#,A) u ..|v = list,keys:  del in_dict[key] def _patch_stopall(): ."""Stop all active ( es. LIFO to unroll nested1"""B2for in reversed(n"._T#esuyf.R() object =multiple!fXTEST_PREFIX = 'test' magic_methods = ("lt le gt ge eq ne "getitem s1dellen contains iter8hash str sizeof en$Cexit# we added divmod and r here instead of numerics# because t(bs no i;"" Oneg pos abs inver "complex int float index"round trunctor ceil0booHxNdfspatha4) yadd sub mul mat2dive lshift r @xor  owediv" ) inplac1' '.join('i%s' % n n.split()) righ6r6P # no(cluding __prepare__, __ancechecksubclass` # (asy are meta ) # __del__ it suppor"atx s problems if it exists _non_default{'__get__', '__s ddeletepmissingGWreduc1 ex#[Dwnitargs4newHfgetsta{sgetformaFDreprh%di }e;4get$ }h+7(name, func"Turns a callable  (like a mock)]o a real>BtionH]self, /, *c, **kwgaareturn?(+(I0.__P__ = >"A _ %# %7/1 inD&[=L,#, !, Z$])kN0# M`as usedfasync `with` qments _gA"__aOQ__", 5xit 0nex ,} q th:rre onlyt gQs butqhronoussmselves _"LE__"}.*| Jgics _all_sync_magics = | _non_defaults _all!= s9G| _a _unsupported8{ '__getattr__',s"Dinit4new pprepare*stancecheckRuubclass.del__' } _calculate_return_value = hash__': lambda self: object.__($),as3 2_izeofhs! 8_fspatrf"{type..__name__}/{._extract_mockr()}/{id01}",l: NotImplementedg l< "in[1lcontains:UFalse1len0!exP*: ) cox-%1j.Cfloao.D0boo=V: TrulCindeA@ao} def 2_eql:4_eq__(other)*0ret! =z!._&.H14if 4is not DEFAULTT'<+>#A is 52I n\/ne$if U;"3 Niter?__( # KLE([]);'# =was already an -ator, then calling ow shouldMg1the'> unchange(&`( __'__>HDaE $F3 _A@Iter(Un(- _side_effeYethodi$':2[mn teO02r5async_iter } (def _set_return_value(mock, method, name): fixed = /`s.get(&, DEFAULT).#if1dis notKOb.|" =4A$  _calculatore=FNone' 3 = e!orU6E+side_effec_TWn7if %?or <.** =8 class MagicMixin(Bas _init__(self, /, *args, **kw ._5KmQs() # make  work for kwF@ in __safe_super( , ^4)._<$3fixbroken by upper level [Qorig_s} | _async!Sthese7 = DyEif getattro"R@s", )Ae.intersection^,\)IWremovBset( "8 - ZPentry E`5if +Atypendict__15"# V unneeded,7delvt # don't overwrite existing 6ibutes if called a second timep) ="0 - a_9 [ Th "s\J,[,aProxy(n%) NonCallable9ock!3ock+"""A version of `=` that isV5[A."""add_spec , cE=Falod}pec to a F0. `9` can either be an object or axE@liststrings. Only onTbe fetchsIAfrom5"IfG`@True)?n ov be1286pec2self._mock_set _magics() class AsyncMfMixin( ): def __init__(self, /, *args, **kw(,._mock_setm # make ~ work for kwF@ in _nF_safe_super( , c%).A$3fixbroken by upper level 7ockc, Mock1"""t) is a sub\!of.P withHault implementationsAof most of th'methods. You can use kUout having toJconfigureIQ your + IfVu`spec` or `` argusOn *only*AD that existON will be created.yAttributes andZ return value5a ``G@alsoL1s`.|@add_ , c=Falseo`"""Addpec to a F.`{`eitheran object*aElof strings. Only a!on\Tbe fetched aI3Afrom5<#"If`s1Tru n vtbe set.2N86pec2), NProxy(BafD, name, parent.! =# z/# =8]`Rqentry =8ZSNumf._get_childa=Ww, _new_@Z4o=at(#, gm"_/_/,m/,'& m)_obj, _type=Non:] 82ock7await_count = _delegating_property('$'5 # 4_9(('){kK}+# iscoroutinefunc() checks _is_ {say if anKo[6`. WithBthisY it looksJ eeJit is a ' # function/method, which in this case it is not (sincCan # AsyncMock).I:set through __dict__ because when spec_'is True,~Iattributelikely undefinedrTself.c['_is_coroutine'] = a5io.)s.%s Jmock_await_countN0/Aargs.ONone1B_lisd_CallList()=Pcode_` = Non"@able(K=CodeType7.co_flags = in2t.CO_COROUTINEi _z_  /Z def _execut`_call(H`, /, *`, **kw !):<F0# Tqiearly just  super(), except for2ial handlingH6of a1 = Q ((#, `, two=z..U += 1gJX .append()effect = URside_N2if L<0if #Bion(1b&SraisePbAelifRE:tryAPresulDnext@ g& StopIteraP"# E impossible to propogate aE jn#of PEP 479<. -  W# K%isK&E(j e/seI;C D3if zot DEFAULTXCturn."if0_re%Q_valuR); 5Y_wraps8 nA} #0=; e5r2 wbassert!eds2"""L Assert that the mock was awaited at least once. 5""" if self.3_count == 0:"5msg = f"ExpecZ{5_r_name or ''} to have been.rP raise AssertionError(msg) wQdef a_0ed_(u)L? th exactly  ?not1u(( Zs f" Af} times.")(2 OAwithO, /, *args, **kw clZuSpspecifirguments|z is Noneoev=r_format~call_signature(F#, %%f'4: {nd}\nNot's _e_message(3"!.ufailure7@, ac !=''eturn msg#f  matcher(_Call(, two=True)_oactualE_5 if84!= fcause  if isinstance(5p, Excepa) else q) from v$G_-8ed `P and f arX 1("ny&)has ever  A.on) else Non3e actual = [self._call_matcher(c) for c in await_args_list]G if cause or expected not:_AnyComparer(p%)::2_string =n_format_mocksignature(@, kw)Mraise AssertionError("sA'%s found' % 7b) from Qdef aiQ_has_P s(* , Is, any_order=False1"""EP the has beenqed withspecifieda.CThe :attr:` `  is checkedl)"s.EIf ``3 (.default)ns must bTsequential. There can be extraa befor0PafterP@True> q in U, butcBtheyall appearCh?0-= next((eeSif isinstance(e, Excep)), None* = _CallListT!if %if+'i#ll +X!is"&problem = 'Ais[%.'*OelseH !(' process\a1>.\n[_Es: {}').R1 ?[e   A #](.3f'{o}3f'E6: {V)6AS0: { .g}n Xfreturn ()'Anot_5s@k%in @:tryc.remove(E {ea ValueqG.l+ndFn =1'%r-E' % (tuple(not_found),) ) from cause def assert_not_awaited(self):"?5""" A. that the mock was never B.0<0if Z.%_count != 0jnmsg = (f"Expected {6_k_name or ''} to not have beenUBf" AU} times."5braise ionError(msg)BQreset:, /, *args, **kw NSee :func:`.Mock.K/)`Exsuper()* l88O = 0 = None_list = _CallList() class Async( cMixin,Cagic& Enhance :M :`# ` with features allowing@an az ARtion.&ThM` object will be1!so!isWrecognized as eQ, and7result of a call i/aRable:2>>>&=Bock(discoroutine("2Tru+ ns1.isd+'()-u ``RD()`` 8b whichboutcom}of ``side_effect````return_value``>- i/,? ~Q& r",jpn excepl"th 3] @iter}\Qnext (0`E0how<,8Pseque$ofhausted, ``StopId immediately+ <PdefinR}8L by 0, h,default-iGus a new  IfX O MP obtaQ whens&-"edSbe th C it (7o R )test author c.@lso ify a wrapped ob,ject with ``wraps``. In this case, the :class:`Mock` ob;behavior is%rsame asS!anC9.::/s4pedNmay have methodpdefinedVasync function 1s. i0BasLn Martin Richard's 9test pro.1a""" b _ANY("):A helperthat compares equal to everything."def __eq__(self, otherWVreturn True2/ne2 IFals3Crepr5`'' ANY =Q) format_call_signature(name, args, kwXmessage = '%s(%%s)' % /.N@ted_4&'p_string, '.join([(arg) forq0 in1s])9}; H`'%s=%r(key, valueQXMr.items(`g!ifuh[ #if  ; if4matVZb+= ', -g0A%qCall(tupleh!A :P holdresults of a a mock, eiR+$ `1o` or `K`Iv( are emptyn{T willyxyaout thoses. This makes>isons less verbose::Q_, ('', (), {})) == ;-/1,/] (1,)4Y'a': 'b'a{",)QThe `o provides a useful shortcutP(1, 2r3], a=3@'foo<H.foo@ If q has no20n i{ll match anyg_new__(cls=CP='', `nt=Non1wo=&,Dfrom_kall=y3 = E= {}G_len = len(h2if := 3 N" =='el?2?first, second:if isinstance(0tm' = first  if isinstance(second, tuple): &rargs = + "Oelse8/kw:60%, 8lfirst,yelif _len == 1{value, =  _, strOnameD{>F=H4W jif twobreturn.__new__(cls, (vE&))G3,, 9def __init__(self,\P=(), 8=None, parent two=False,DM from_kall=Trus]p._mock_X! =_Al# =u#f& =r %eqHothe:trynAlen_%q = len( )xexcept TypeError=xNotImplemented%''T!ifj)2U_ <EfnW/lfCDif (getattr'0', d) and ( /, )Y9WA != F  ZjQ7= = R:= 0R7S T%{}?= 3K,g WV 8C?P#LK n z~<gDF = (2 b  n# could be (,D) orZi   " 0+ J if isinstance(second, tuple): other_args, kw4 = ?-{}:OelseP3(),T PL ]firstKGreturn False sif self_name and! L# this order is important for ANY to work!I(a) == ( ") __ne__ = object.def __call__Hb, /, *M#**Jb._mockkis Non_Call(('', SQ , Bb='()')mJ(lfa + ( [-hY, parent=2ugetattr "s=I, from_kall=])$ = '%s.%s' % 6ttr1 V>= oa _ibute2 in .__dict__raise AttrNUErrorL3.__b) w2getarguments 2len2dI<45$N@property+\$?r. O)[0]P*R1RT__rep G1notn#I)@or '4')!if.startswith(x&E=D M;?if  -P", SU!ot 5!'el9,']n'freturn _format_call_signature(name, args, kw) def -list(self):"""For a" object that represents multiple%Es, `O`Ireturns a g of all the intermediatB as well5theDQfinaleE."""vals = []thing = bwhile is not None"if"._mock_from_kall&*v.append(U)j) =Neparent'p _CallL|reversed(\)I" =#(`=False reate_autospec( , B_set,, instance_=,_3 *, unsaf?#**EA"""C0 a 9* ustanothera. Attributes onBpwill use correspondP65 `N``QtheirL.Functions or methods beRr1ed t1havu ir/!umqcheckedS1to rthey arD th5ct "If` is Truqn attempt`to set!vdon't exisH6raise an `cfError`pa class@usedmaI1the Pvalue+$ (WS)IQ sameZ. You can as0[ fqnaby pasQ`w=<c`. The!edN bonly buable if[s&'!`c]`^ `Runtime[Z`ed somAmmonmisspellingt3arg]A and(0. Ps*K`i p to dis also takes arbitrary keywordy!toconstructorK2.pif _is_b#!'tglRas itb #LDpretr0str|ib= type#0is_T = is ,+ *%"InvalidSpec#`(f'CanzS Mock5. '2f'[ ={S!r}]'s_async_func = _is_async_func(spec) _kwargs = {'0': }!if Q_set:2 6#el8 is None<# we mock with a normalQout azuand instanck0['_D_as_$'] = True^if not unsaf?Scheck<rg_typos(-!) :bz.update@KlasUMagicMock2 ifpect.isdatadescriptor*s don't have# becauseU' know what type they return O $ _Fraise RuntimeError("IA canY!bel when create_auto% "P1"isqing an  Rtion"7pAp_callableg8CNonC# C is(e j \Xe#P_namea`.pop('1', s1new, >if _parentr for a top level object no _Nshould be setTU B= ''!= 8(u=}#ew =P,cg!same, **[sf`, FuncfTypes)## only happen 'he 4# recurse 7is _signature(,tA#up?D>?elsm9,#, ,W2L. .__children[l/Z\O`'kq_value'2in pP.*, =.=CX@='()P/entry in dia@is_m()rs%# 6 already does} useful > methods_uXEcontinueh# XXXX do need a better way of gettttributesUout # 4triggering code execution (?) Probably not - we need the actual # object to mock it so2would rather o a property than3La!descriptor. LikewiseY&anoout dynamicallyLprovided attributes.XXXX what abE&@t raoPexcep2s o7hanFA\Error on beTfetched?+Awe cbe resilient against it, or catch and(PagatevGP whenC is zQ from@Etry: original = get(spec, entry),w Kcontinue 5kwargs = {'U4': o}$0if J_setO =! AB isITance(f`, FuncjTypes)anew = _SpecStat7, $, aCa .__children[>u] = newJelse0par=g(U7if  4 N. skipfirstPmust_, is_type['_eat_self'=Ocoroutinef 5P_klas+AsyncMockV;:NMagi:d('=q, name=w, _new_ r /HO2 "**L `B_check_signaturUnew, = )#s created with cXu becomeg%s,# *plus*jir underly exists in 0 of2 <N6P. AddC,to7may be unnecessaryrare alsoN@settI_as an oH; s+3newiSretur def _o 1"""R@1whetQwe sh;9x` argumA!onEA's ``G""" if no t isinstance(spec, type): if entry in getattr)'__dict__', {}3:$# W 3ibute - shouldn't skipe2return False0 = .__class__ Pfor k!Vmro__result =(.Q.get(, DEFAULT)S3if 7$isR"vcontinu(ifF>, (staticmethod,  ),/elWFunctionTypesI# Normal h1 =>g if looked up on<# ($P, sel alreadyS6ped3B0is_@]Jelse>)(3# f is a dynamically providedE3En! ^ _SpecState(object):,def __init__(,SQ_set=, parent=None,jBnameD ids ?Ch.PPids =G 04 !# = Z !0 = 9 LA = (-# python(create_auto)$y1ANY.__eq__), ) file_<0 = f1 to_stream(eS_dataK !adY, byt0o.B'IOK /jString0mock_open( 3=''1"""bA helper;B to 50 a Dreplace the use of `e`. It worksN ed directly or:0d a1ext manager.PThe `s` argument`u "configure. If `R` (thdefault)n a `MagicMock` will be d you, with1 API limited#toss availablePdard / handles``1a s| 1`, line` and s`qa q. This_tn emptyf3by ._O = _/_Ve = [1, ] L s_side_effect(*args, **kw {#if$.:.`_value1noth: return handle.readlines._value  _state[0]0(*args, **kw !) 5Pdef _U_side_effect,:,d(if is not None15 9]( yield from _iter7)while Tru? ~ g LJ Plk X@for 6 in2N%vJnext;5&,(global file_spec&ifW import _io-? = list(set(dir(_io.TextIOWrapper)).union"BytesIO)))~if mock| = MagicMock(name='open', = G 0#'P.__en_W=,@writ^lT! =%( LK $0( u R.. =0 $1]" (" \</1],s-Esh:_j_9  4_4 reset_data 0 to_stream(;=w4 ==0&1]_9q# Only P the 7 V1 if user hasn't overridden it.G,0ErDEFAULTK ";'z class Property)41"""4A/ intended to be used as a# property, or other descriptor, on a class. `P0PMock`>vides `__get__` ands methods so you can specifyOa return value when it is fetched. (F\ing ainstance from an object calls the mock, withKno args. SettSi-,; be'2set1"""IAdef `child_g(self, /, **kwg!):,;PMagic>($PQ_H@obj,_type=NoneOr!()eAyA7val700 1Pseal($"""Disable automatic generation of [sPGiven`input , ^sto ensure no furiws will bea!ed `access~an attribut at was not already defin1@The recursively passed in, meanlAthat% it7R, anyF by 0one6its!s,Mall assignedIout a name AAy7.p_q = Trueg1for{x in dirD6trypm = get],,>Q except A}ZErrorCccontin4!if$is(m, NonCallZo/D@wren.get(), _SpecStatTmInew_parenmR Ya(m)  _AsyncItQWraps|3`hronou;Dd_init_iE!}.4 = !de, =h(O_set=CodeType#co7.co_flags]n2t.CO_ITERABLE_COROUTINEr__dict__['__La_'] = Sat __anex ,.BStop:ion`raise .ion """Test resulto0ect import io 4sys traceback y#. .Butilfunctoolsw( __unitttfailfast(3@5Qinner0, *hr5%if4, 'a', False):  self.stop() return method(", *args, **kw)%inner STDOUT_LINE = '\nStdout:\n%s':ERR3err class TestResult(object):"""Holder for test r' information. ,Ds are auto"cally managed by therCase and QSuiteI1es, do not need to be explicitTbipulatXwriters ofsEach instance holdstotal number4B runz`collecRfailuresPerrorJat occurred among thoseOws. The PMcontain tuplec (acase, excep|hp), wher i}3traceback1he 7 th.1"""_previousCR= NonZ_pRunEntec= FalsmoduleSetUpFailed def __init__pstream=^, descrisverbosity .Ifastf A= [].s sRun = 03Qskipp Mpxpectedp3une%Successe}shouldStopobuffertb_localX!_s_Cr #?err# original, ouxBsys.\ N+ er+;err+ mi:AOutpS$2`printE"s5@"Cale!by2 RuT afte2un"JPstartH,NAwhen0giv Pis absrX]9A+= 1_>b_setup&() *0if .Q!is ,0I -= io.StringIO046out54E=q=5]We9-#1Run#$"""o@befo!nyexecuted}ESee Wa \JeIA<Eq/opp """Called when the giv est has been run""" self._restoreStdout()mirrorOutput = False $Kdef =Q!):c0if v.buffer_a #'oyQsys.s.getvalue+e3 = .?err. 2if `xMcif not#.endswith('\n'*R@ += ) #_original_write(STDOUT_LINE %|F1if  ".`4ERRL)'oG ,/0err1:err/"J_pz.seek(0=y (|truncatP+?errS(S,stopTestRun(\D"""Called once after all tests are executed.VDSee U for a method cMHAeachI. @failfast@addEE,8,lm an !orgoccurred. 'err' is a tuple of As asoreturned byexc_info(),9._s.append((%,j_@_to_string(err&)) H |c = TruFailureo ?ureJ0Sub 2sub?err(!at0end#a 1-qNone if/& ended successfully, otherwise it's aQl d# By default, we don't do anything Rs, buL# more sophistiddR results might want to recordmI  if getattr(s elf, 'failfast', False): self.stop() if issubclass(err[0], test.VureExceptionVerrors = _1saNelse 9 7Z.append((sub,i_exc_info_to_string*))0_miQOutput = True qdef addSuccess(.H"Called when a has completed s?afully"XJpassf7kipci, reasZ/""mis skipped.""`.+(Y)ExpectedFailure7err 3n e< / occurr1ms"(:@$Unn ]6was!toR, butupev3was1fulq fPTellsY ther or not this result a)ssP# Theattr check is for_Ar's OldRMq. That?R# waysmethod works on objects that lack the ogibute.D(where woulhinstance.e from? o%tored pickles?return ((len2es) == e0) and(M0hasJ?, ']') or=i3'0)\ IndicateE@As sh+be abortf#MStop,}^, err""Converts a sys.A()-style tuple of values into,] wexctype,*`, tb =vAa# Skip runner tracebAVlevel"0whi}bis_relevant_tb_17(tbWvtb.tb_next3if l?1assert*().dlengthn_countsFENone(ftb_e =$.T7( exctype, value, tb, limit=length, capture_locals=self.tb, compact=True)GmsgLines = list(tb_e.format()) (1if Qubuffer:output = sys.stdout.get(k+Verror*?err*2if X lEcif not.endswith('\n').2J@ += % .append(STDOUT_LINE %h 1if o*4ERR<return ''.join(") def _is_relevant_Pevel(_?L__unittest' in tbTframe.f_globals_^countbscE = 0while tb and.'tbPE+= 1QCtb =Enext7q_repr__c/("<%s run=%is pfailure E>" %e (util.strclas1.__ B__),]fsRun, len.*s)T"y))) """Running L""" import Dtime 0war0s from . /cresultvsignalsrgisterR$ $0 = `1 _WritelnDecorator(objectW"""Used to d"e file-like + s  a handy 'wR' methodS_inits,streamj#Ldgetatt , ?!if"('G', '__getstate__raise AttributeE(W V|],)*#, arg=None*rg:F(arg+) # text-mode s translateP\r\n UeededTextTest (7.A"""A " that can print yt3ext+s~a.65by ~aunner.,Asepat1 = '=' * 7j2-=i_Gy , descriptions, verbosityaUuper(&).UxO self.stream = #  self.showAll = verbosity > 1%Idots"-==#escription+d Mdef getD(, test):$doc_first_line = r<)10if I.sZ and Jbfreturn '\n'.join((str(,9)kOelseH=startTestsuper(Tex$qResult,&).;  a.writex.sQ 9" ... "'vflush()addSuccessv  <$oln("ok%el:?otsM ?'.'WErrorW, err ?9(_ERRORGEbFailur) A2OFAILGFISkip4oreason7A;9(skipped {0!r}".format(Xei/"sRaddExpectedX" IGo2e" fi8x[ self.str'eam.flush() def addUnexpectedSuccess(self, test):*.super(TextTestResult, +/).F@?!if,.showAllX\pelf.strwriteln("u" s%")O 6$elqOdotsn ?("u[|4printError+%u? orw.List('ERROR'!.eR2DFAIL1failures aC, flavour, b\1for53 in"!E eparator11"%s: %s" % (EgetDescription()P<s21"}?err, class ;unner(objecaA"""A<! r 3that displays rtsZtextual form.1It s out the names ofY@s asPy aref%or0occand a summaryB%hea^4endgS.D1"""=M__init__u=None, ds=True, verbosity=1,f#fast=False, bufferawarningsP*, tb_localsF"""Construct a1Sub"es should accept **kwargs to ensure compatibilityinterface changespdt K@ is I = sys.stderrb!"_WADeco(0) = Y& = #4 = !# = & = #4 = !#if>?notBM( =8Bmake)<breturnJ'^H1run=  "Run the given test case or suite." result = self._makeR'()$cgister3C.failfasLG(dbufferr $tb_locals'*with warnings.catch_5():("if ",# $ is set, use it to filter all the} kMgr.simple7(a>1W/'default''always', special-=the#Q fromdeprecated unitpmethods@show(mMno more than once per module, beca#they can be fairlyK isy. The -Wd and -Wa flags>@usedbypass thisKonly when8]None.35n [c$, a]."(' -',q6zcgory=DBionW9 message=r'Plelassert\w+ instead.'QstartTime = time.perf_counter,estRun = getattr(8, ' 0', ] mYpDais not)KN >try0 vofinall2SstopT'S0s @Take3"- -&im.printErrorsqkif haseparator2'stream.writelni%.s5trEsRunMq"Ran %dx%s in %.3fs" %7= `(run, oA!= 1#0"s"1"",*)}%) eexpectedFaiQ$unSuccessegkipped = 0: /map(len, 4TfOures M.<s  except AttributeError: EpassJelseexpectedFails, unSuccesses, skipped = results Qinfos = []Sf not+C.wasJZful()} self.stream.write("FAILED")Ofailed, eBlen(.wures), +sG0if -*edb.append("&Sc=%d" %5 LcM'sK &edL'OK$if ww4if K )A [Fa /$ svFe1if \ @ln(" (%s)(", ".join(<6),)'\nmfflush(Ncreturn  import signal weakref from functools -*wraps __unittest = True class _InterruptHandler(objecthdef __init__(, default_h0) Q.callaUFalseoriginal<, =N0sinstance(tD, iny,ifL3 ==-.SIG_DFL6# Pretend it's/o%in Eead.?- uF =/el?IGNNot quite the sam ping as IGN, but@closw# can make it: doxOhing `(unused_ umWframei K0raise Typ$(")3INT syto be "^H "!al$DFL, or aHRable - ]L]L E~Y;,bal.get (6INTFKI?is not self:  # if we aren't the installed handler,n delegate immediately G@# to+ default@ %Sself.!_a(signum, frame) 11if 0c:oI (,Eu = TrueKpfor resBin _ s.keys()r.stop() , = weakref.WeakKeyDictionary() def registerRi(I^G[c] = 1 6Omove4return bool(@C.popZp, None)interruptl! =aHglobal _;4/if1 isV0 0 = bal.get al.SIGINT)]xT = _I a@^. e,() m^qmethod=G2if ;notr@wraps(#inner(*args, **kw initial'6 re!v2try 8 /ofinallDY`r_$s FP.orig ) """TestSuite""" import sys from . Kcaseutil __unittestZP_o_if_exists(pbst, attrfunc = get ", lambda:gO/x class Bases(objectY"""A simple s that doesprovide M or module shared fixtures._cleanup __0__(j,uCs=()& ._as = []Xd!0 0add!s(A"yCrepryoxC"<%s%s>" % (A.str1.__ __), list?f#eqdd, othe!0if !isOAnce(",\ @NotIemented2 ==\ ?ite._tests) d ef countTestCases(self): c0 = ._removed_tests$@for 1 in(>E!if [!+=.)^qreturn . pdef add,B# sanity checkif not callable(7raise TypeError("{} is7".format(reprD)if isinstancb, type) and issubclass9,x( . , oSuite) *4s8s must be tiated " "before passing them to&)";ls.append)}sSgs, str#? span iter" o!s,aM7ingG  3rungresultVRindex0enumerate4,2if D.shouldStop&Ybreak(:+!if._cleanuM#0AtI(Md9Q", ?0"""P hold@a referenceG1the2 at?6.""6tryN !s[u]fexcept @# support sR implementations that have overridde.|is None: return if result._moduleSetUpFailed:&-9:try!@r = sys. s[previousM]]>except KeyErrorJ k_call_if_exists(, '_setupStdout')] tearDown = getattr(m:, '"v', NoneR:if &q is not+ /  E(e!E#ion as ea+if isinstanceq_DebugR)9=Uraise5self._createClassOr;ULevelq/e,GO ~N* s _rcase.doCleanups&X7kfinall5urestoreTdef _AP\(,s, test,+J"ATest& bcurren! =j@.__c!__:if )$= [W; or/isBR%if NS ', FalseCRL p"__unit_skip__" G4 `( !do H * JS#[ and = z try:  tearDownClass() #except Eion as e:'7if isinstance(result, _DebugR)9=_raiseWcName = util.str(previousWself._create'OrModuleLevel/e,K'O'M+ Qif doCleanups is not Non -for exc_info in X._ Oions/?[1] R?[1]+C+=azfinally_call_if_exists-'_restoreStdout')  _ErrorHolder(object1"""aPlaceh! a TestCase inside a C. As farz&MGis concerned, this looks exactly likKunit test. Used tAsertFarbitrary es into a1 suite run.,# Inspired by the from TwistedM# http://tmatrix.com/trac/browser/trunk%/trial/runner.py # attribute u!by>._to_string7ufailure! =2Tdef __init__(6, description.( =)M!idG:|return A3fshortDvA5c__reprn("<=%r>" % e(,)]/st\7id(11runQ,# could MA.add(...) - but->@# shGQn't bu anyway"Fpass__call__(self, result): return self.run(! !def countTestCases()?00 ,_isnotsuite(tesh "A crude way to tell apart &cYQ and :s with duck-typing"6tryBitercexcept TypeError)ATrue*False class _DebugRe(objecUsed by the Shold previous Hwhen running in dW._,FCwR= Non_moduleSetUpFailed = shouldStopa"""Var}utility functions.""" from colle import namedtuple, C"er,tos.path(commonprefix __unit1 = O _MAX_LENGTH = 80 _PLACEHOLDER = 12 _MIN_BEGIN5:END[COMMO%CDIFF&o1- \(h-+ !+ $h+F5) assertJ4>= shorten(s,fixlen, suf =0skil)6) -+& -,1if -> s = '%s[%d chars]%s' % (s[:Qlen],HE, s[v1:])ms__repr(*args 1 = M(map(safe' , )V maa = max'! ifwlen <= 42 = ( tS = )=4_p X3 (KoiCIn>8XW  {D/ +8) <\<4 = (,,k>9R + s[ len:] for sz v {w    !, =  F1 = 22objE6ion1~!._E __n<bif noty1 or6 Uturn result : return result[:_MAX_LENGTH] + ' [truncated]...' def strclass(cls): H"%s.%s" % .__module__, cls.__qualname__)Lorted_list_difference(expected, actualg%"""Finds elements in only one or the other of two, sap input g1s. R0s a(-Q` tuple=+ The firs? contains thoseK=""r but notP, andJksecondd A ^G .PDupli O!ei. are ignored.M!""i = j = 0missing = []$unwhile True:$6try De = ;"[iM3a =*[jif e < aL4.append(e){mi += 1G == ;C!el>aj 40[j]A?els@ 0`kfinall0. Iexcept IndexError2.1ext.yJ[i:], *Qbreak^_d&, D unorderableSame behavior as B1forss items (like dicts)As it doe linear search per8 (remove) itfhas O(n*n)$formance."? oV.pop( .(=-_Value*<p# anyth1lefh8 isp )three_way_cmp(x, y -1 if x < y, 0 A== y4> yGn(x > y) - (;) _Mismatch = dd$('', 'actual expecteld value') def _count_diff_all_purpose(actual, expected): 'Returns list of (cnt_act, cnt_exp, elem) triples where the cj s k1er'O#- ents need not be hashable$ps, t = q"),(@m, n(@en(s"Qen(t)NULL = object(PresulX![]$afor i, in enumerate(s#if! s Trcontinupnt_s = j0imjgrange(i, mf"if s[j] ==r j!Ues += 1V9r, other_elem~t+ tt !if 3s !  = _Mismatch[sYt.append(?!)  nF @ !01 wgX?musC7#er4),  7 = #ss.items(Gbt.get(00fQ}Nin t&Oin s? q. ;"#"""Exception classes raised by urllib. The base e. is URLError, which inherits from OS. It doesn't define any behaviork5own, butZtv DEall sIdthis package. HTTPzI-an1thad`also a30id 5=ponse instance1es h waRcause5protocol e Rs areTA resOs, with a status code, headers, and a bodyppn some sexts, an applica may want to handle an excep"tion like a regular response. """ import urllib. __all__ = ['URLError', 'HTTP ContentTooShort] class 81(OS): # is a sub-type of *, but it doesn't share any ofEthe implementa. need to override __init__ and __str__.BIt sets self.args for compatibility with other=1sub"es@Phave ptypicalY2matNerrno inIQlot 0@streiP in s1. This may be better than nothing5def(, reason, filename=None&=,A %ifT@not [>^{% =2 Greturn '' %g(q,.addinfourlk"""Raised when DjToccurlso actsFBnon-Bq__superk/ =}., code, msg, hd#fpn[#! =*RPmsg =< H! =O  fpp4f# The L  depend on fp being a validAobject. In some casC-)XHJEX J0f t$happens,ysst workaround'toGb}RializDbaseZYp?24(fp2url)  `%s: %s.,9msgSarepr__',0 ' *?.!.swE#, Gqq3D"""Excep' rdownloaded so match content-length.""" def __init__(self, message, content):*.URLError.3))J.@$ =J """Parse (absolute and relative) URLs. urlp(%module is based upon the following RFC specificationA^3986 (STD66): "Uniform Resource Identifiers" by T. Berners-Lee, R. Fielding and L. Masinter, January 2005. q2732 : "Format for Literal IPv6 Addresses in 'swR.Hinden, B.CarpenterqMoDecember 1999.p_396:  (URI)": Generic Syntaxy?T. ,'L.`August868: "The mailto scheme",bP.Hoffman , LLJ. Zawinski, JulyW0180WR LocatorsdR, UC IrvineWdne 1990173WN)/L)  M. McCahill, 4v isqsideredcurrent standardaany future changes to`shouldQwith it. z* kply not rely compliant BAthis<`due to acto scenarios2ingPbackwO atibility purposes, some 7 quirks from olderrs are retained. btestca _.py provides a good inddor of lbehavior.f import re 4sys Etype acollec9 warnings __all__ = ["0", unzCjoindefrag", ! 1Ssplit$(unQencodJS;_qs>l?Aquot- @_plu "k\_byteC!un!A :/to:DQResulS 9B /C] # A class^As. #7empty str . ess#no$ed, # be2Idefault valuPurneda“url1”0”Dses_&'', 'ftp"ht`gopher"nnYimap'!^p 'wais)@fileCs ?mms:prospero$1rtsus 'svn',@+ssh "wss'] uses_netloc = ['0ftp"ht`gopher"nntelnet', bA'ima;1waie@file9!mmR s @2sneprospero=1rtsUuOsync> s!nfw0git@2git  }&wsmparams dlI  Z 'E!siOsipsC0telN# These are not actually used anymore, but should stay for backwards # compatibility. (They UundocumentedHhave a public-looking name.) non_hierarchical:Bh9Qmailt /T'g$ 'P`(4Qqueryx_y C b 'I |@frag-uDV'l;  w] # Characters valid in scheme"s P_char('abcdefghijklmnopqrstuvwxyz'v 'ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789P+-.')8Unsafe bytes to be removed per WHATWG spec _UNSAFE_URL_BYTES_TO_REMOVE \\"\n;XXX: Consider replacwith functools.lru_cache MAX_CACHE_SIZX20 _parse! = {} def clear1():.@"""CQ the 6 WA and1quoA."""7a.W"()_58@Help=2handling # For 3.2, we deliberately require applications that # h@e improperly xQd URL doir own # decodL"en C. If{use casess # presdPwe malax this bMxlatin-1`ainternp3.3 _im4it_y = 'ascii'1rro'strict'_noop(objreturn obj Ue_result)!, Ning={ $e3 w.^!e(Ring, :)ke_args(args, encoding=_implicit_encoding, herrors2!):1return tuple(x.decode(U >) if x else '' for x in args) def _coerce_ (*b# Invokes ]Knecessary to create strPb# and bs the _d inputs along with0 appropriNbresult6ion function. - noopzW: otherwise&Astr_5 = isinstance(@[0],))-4arg/B[1:]{# We special-casePemptyB0ing"psupportS:"scheme=''" defaargument65omes9 ifg` 0 !=zsraise TypeEC("Cannot mix3S@non-P"s" if# V`s + (_,1_5W]))"e_r,) # RPobjec!re more helpful than s8es class _:MixinStr(B"""Standard`0ach]Pparsep`s from$bytes"""{__slots__ = () 8Ie(self, ing='ascii',='strict'9.ed_counterpart(*(x.Q@O)) B?str I.FgNetloc"NBasehared methodsU  Xs contain.1a n`@ ele @Eerty;rusernam.%rinfo[0]uHpasswordH1HOhost0 = n ._0if LD z2Non}1# Scoped IPv6 address may have zone e, which mustcbe lowerodMO&like http://[fe80::822a:a8ff:fe49:470c%tESt]:1234/keyXseparator = '%'`eJEb'%'!pH2nt,#= e.partition(separator) return hostname.lower() + percent + zone 2@propertydef port(self):W0 =  ._Zuinfo[1]!i8 is not None>B:tryW@int( F, 10!except ValueErrorDmessage = f'Port couldbe cast to integer vJP as {qE!r}'pWraises(ba) from 4!ifma( 0 <=>W65535BZ ^"out of range 0->" __class_getitem__ = method(types.GenericAlias) " _NetlocResultMixinStr(zBase, _(q__slotsx"()KP_user+ PnRU5p, have_@, 2 = /.rpartition('@',&if8 /YYpassword, 0 = $h.^:^; j&* =4;elst( =D*{{O_, _l-open_br, bracketed =K[K= B& =]R]Rw2-t  i  T%_Bytes*bK(b'ostinfo = netloc.rpartition(b'@') _, have_open_br, bracketed = hostinfo.>[>)if>:W^>name, _, port =^ S]S:_3: .:.Oelsev Gaif not N}u = Noneareturn% from colleci@s im % dtuple _DefragResultBase = (('', 'url 1ment') _Split>'#Bscheme ne path queryW_ParseW #Wnparams^.__doc__ = """ U(url,q) A 2-= that contains the uwithout3 identifier and(B `s a septe argud . :urlThe URL ? no.L QP Frag!d ^BURL,allows indirect4 ca| of a secondary resource b ference to a prim#51add-$alYPying D!rmb)n (,,,. 51difmponents. Similar to , but doessC /ms @SpecWsl "A forbsrequest} O Network loXwhereNp is mad Xhierarchicalibsuch a860fil_ downloadh3i3 coInon-Cdata%Ralong?1 inM!in%PscopeTURI's[and nZu u u* u` OParseResult(scheme, netloc, pathDrams, query, fragment) A 6-tuple that contains components of a parsed URL. """ _PResultBase.scheme.__doc__ = _Split" BB "B@  >&@""" Parameters for lastU@ eleD uto dereferencLe URI in order to provide accesserform some operation on the resource.p o !C $ # For backward)atibility, alias _NMixinStr # / is no longer^th@docuYed API, but it is # rePed sigdeprecating#n't worthBwhassle u= # Structuredzult object0stredata class De\((_2, _): __slots !()def geturl(self)-0if .iCr4n"url + '#' +3b.Oelse@  (S,?`urluns(P]((Dps obytes B %:!b=*!c#*- %Qet upmencode/deC`pairs a_fix_r._transcoding(1E = (([,w, (SplitResult, SplitR Bytes), b(Parse', ))/for _decoded, _en a in _r\q_pairs:-_-.,_counterpart =C1T.: 1~d _fixvtranscoding() del  def urlp(url, scheme='', allow_fragments=True)1""" a URL into 6 compon,&:///;?# BThe F is a named 6-tuple with fields corresponq to theCabove. ItBeither a8 orr objectBdepeW onW type of Aurl Veter.@user, password, hostand port sub-1U#can also be accessed as attributes1t$cturned}P argu providesdefault valu2 when noKPfound3urlp,If.)`False,=aattemp@made se= tesGP from previouc, which *2be HaY!Noiat % escapes are not expanded.>1""" , _coerceaHargs8s_=`( ]9}", ,;!, %, != O`%ifpn uses_[0ms m3';'$1= _PFelse2Q = ''s~( =@(@ : e re `(]) }if '/' !i r.find(';'E".r2/')xif i < 0P"  aQ7A[:i]uh[i+1:]c, start=0Pdelim = len) # position0end`domainwtais endc`'/?#':p# look maiters;]Porder`NOT im1antI:w0Wc"0 # `Q firsQthis 7F3if IA>= 0;Q# if ]6Hq = min( ,J# earliestv; return url[start:delim], url[ :] # return (domain, rest) def _checknetloc(): if not 3 or .isascii('+`6*# looking for characters like \u2100 that expand to 'a/c'>IDNA uses NFKC equivalence, so normalize_Qthis >import unicodedata4n =replace('@', '')hignorealready includedG.B:Ba # but1the surroundOtextA#A?82 =. ('(Q', n)J$ =2 in '/?#@:'%@if c>Baise ValueError("'S '" +b + "' contains invalid " +G"*Rundercation"urlsplit(url, scheme='', allow_fragments=True """Parse a URL into 5 compon,://<>/?#<_!> 0TheOult is a named 5-tuple with fields correspoQo theCabove. IBeither a S0ResZ(orBytes object,BBdepeW onW type of url parameter.@user, password, hostNFsub-(Uycan also be accessed as attribur#edtP argu provides@defavv}^ when nof3urlp,If%)`False,=aattemp@made se= tes>P from previouZ, which *2be HXWY!Noiat % escapes areX01ed.>2""", _coerce_r8=Hargs0)= b# _UNSAFE_URL_BYTES_TO_REMOVEJ=]Rb, ""y!= '  = bool(T0key ,) @cached = _p_.get(key, None),AR(Bd5Hlen(\) >= MAX_CACHE_SIZE: # avoid runaway growth 5Rclear(Ya1 = 5 = s2= ')i = url.find(':') if i > 0:for c in url[:i]if c not!scheme_chars&*UbreakVJelse$>,g =m.lower()q[i+1:] D"if#2] == '//'Nanetloc3 = _splitr(url, 2if (('['# and ']'A) orx5('2in #9[9)8raise ValueError("Invalid IPv6 URL"if allow_fragmentsa#6urlX'<.u('#', 1Q/'?=Zquery:?:b_check(SPv = S^tResult($!, \$, :_parse_cache[key] = vareturn _coerce_rZav) de!un<p(componc"""Put a dL back together again. This may ^a}slightly different, but equivalentV,&0the that wasvG,originally had redundant delimiters, e.g. a ? with an empty/F(cdraft stateslthese areQ)."""5mparams,fA = (Egargs(* if'amurl = "%s;%s" % 5Rurlunl)79B"""Combine q2elenof a tuple as Ped byyLr) into <Y2let as a string. The data argu] can be any five-item Qable. $Q unnecessary (example,O;9?RFC- +,C or OcCSuses_%B2] !rx*?%1% ':. 00' + =33 + W7'')*2if 9X + ':Z"ifB /n + +!if fragment:# `url = + '#' + fragment#return _coerce_result(url) def9join(base,, allow_Fs=True):N"""Join a 0 URL and a possibly relativeto form an absoluteGinterpretation of the latter."""%Qf noti}8url$=url# %  % =Fargs)8scheme, bnetloc, bpathrams, bquery, b-A = \<urlparse\-''_lkji"pahgfdurl, bM )2if !4 !=,4 ortin uses_ ] HO\CA!, " lH P"))=$ =4t =$rO 1ot D2 1"O,,GH`_parts.split('/'A!if%@[-1]c&''#st item isa directoMqso willbe taken into accou*# in resolving[);del# rfc3986, ignore.Dq should] first character be root.h!if0[:1] == '/!se87Felse$-r+^ qP# filpout eles that w cause redundant slashes o=-1ingOV0ed_0[1:=zz(None, n IR = []{fr eg8G!egG'..H6try) fR.pop(except IndexErrorC#Uny ..Jotherwise T'anS&q# when popped fromW3 if Jpass elif seg == '.': continueJelse# resolved_path.append(seg) 5if segments[-1] in ('.', '..')K# do some post-processing here. if the lastQ was a relative dir,t#/n we need to ` trail\5'/'2#'',return _coerce_result(urlunparse((scheme, netloc, '/'.join(b@) or$, params, query, fra0))) def urldep4"""Removes any exist'n from URL.R0rtuple oPX1 ed.A and#HQ. If@URL ained no!s,6second eleS0 is>empty string.1"""Kurl,X% =Aargs,`if '#'E6url=s, n, p, a, qB =7Aurl)? A2'')1 F = '4Mb'DR44p_hexdigY 0123456789ABCDEFabcdef' #tobyte = Nonenquote_to_"s(_"u!p'abc%20U`) -> b .s# Note: s are encoded as UTF-8. Thisonly an issue$it!s# unescap0n-ASCII characters, which URIs shoulXt#cif not# Is it a-like object?v e.splitbif isinstance?,VDH = ('utf-8'(Fbits"sC(b'%pif len(%)g1 reJ[-A[0]]S= rescp# Delaye initializationPtableHwaste memory@WAfunc7is never called&vglobal 'if . = {(a + b).<1): .3hexXs Pfor aT*b}9@item>61:]6try `T(T[[=R[:2]]%)'2:except KeyError_KOh#b'/res) _asciir re.compile('([\x00-\x7f]+)!gCing=0, es='replacez """Replace %xx escapes by their single-character equivalent. The optional encoding and errors parameters specify how to decode percent-encoded sequences into Unicode s, as acceptedr bytes.W!()Iqmethod. By default,uqBare Cd with UTF-8,qinvalidNs2breplac!a uholder !. 8 unquote('abc%20def') -> '1"""/if isinstance(string,!):"ysreturn \A_to_ 0),$if '%' not in c[l.splitp4if ^ is NoneD= 'utf-8'4%23= 'Z2bits = _asciireT re![)A[0]]append = res. Pfor irange(1, len(;G), 2_4(_+?[i]`aC2R + 1])''.join(res) def parse_qs(qs, keep_blank_values=False,0ct_-3ingv~=|=\, max_num_fields=@, sestor='&'@"""P a query given@rgum!A&s:=qs:SW#"bed7  : flag indicating whether 0 09 inpvies should be trea]#asIsbA trueeres that7Sretained as` Y f`C toPignorq(nd ifiy wereGccludedfr at"do4g 2#If0(thk) sia3ly At2raise a VE90 ex7ione'/s: ,i& P :. If set,n throws A@moreBn n A rea)Wl(). separator: str. The symbol to use for s& ing the query arguments. Defaults@5&. Returns a dictionary:1"""&parsed_result = {}airs =  _qsl(qs, keep_blank_values,@ict_(Aing,= encoding= , errors=8max_num_fields=,#3or=-1or)@aname, in pairs:0if !"&[1].append(Yn*Oelse<A = [8]rdb defxl=False~\s='utf-8'{'replace', Y@=Non]ror='&')@"""P2# apgiven ac0strA:qs: percent-#edSHRto be d7 : flag indicatwhether Is inzies shouldyptreatedI ybA trueeres thatSgretainT ` d f`sJ0are be ignorq7nd ifSy were not includedg atgqdo withI. If() silentlyA] ^ raise a VEK` excepY3andr: specify how]ecodesequence[into Uni3characters,' acPed by_ bytes.d_() methoa uQ: int@set,Apn throw[ T!reA mobhan n 0A reaN)4XAlist-0G-d!enui0_corargs(qsxi, _ = $)<&ot2Q or (sinstance(4r, (str,#))x4("S&P must:qof type ngibytes.") # If max_num_fields is defined then check that number of 0` #6@less(nR. This prevents a memory exhaustion DOSIattack via post bodies with manyw./inot None:# = 1 + qs.count(separator)-T<UYraise ValueError('Max. # exceeded') gar = [] for name_vE0 inHspliu0if 21andstrict_parsing2continuerGnv =w.qi'=', 1 len(nv) != 2T?if s f "bad quer: %r" % (&,)D# Handle casev a @rol-5no equal sign?if keep_blankds&nv.append(''7elsH, P2if *[1]) oru = nv[0].replace('+', ' +qunquote*, encoding= 0, e"s= C_coerce_resultJ (1 ,5; =  r", #$return r def `_plus('ngu'utf-8'/'}"')t"""LikeF(), but also + Zj s by spaces, as required foring HTMLm"s. !e'%7e/abc+def') -> '~'P1"""! =/ngBd )) _ALWAYS_SAFE = frozenset(b'ABCDEFGHIJKLMNOPQRSTUVWXYZ  b'abcdefghijklmnopqrstuvwxyz7 0123456789' i_.-~')_BYTES = bytes() _safe_Ars = {} class QUr(collecs.defaultdict`A mappBfrome (in range(0,256)) to0Str5ps are p1nt-!edKC, unEe key < 128, and!in"" set (eitherspecified ,)5""" # Kee" % .__class__.__name__, I)0miso9, beHandle-. Store quoted str#inBand is = chr(b) if b in > else '%{:02X}'.format(b)+[b] = resf a( ='/', encoding=None, errors 2"""<@'abcx`') -> r%20def'Each partq a URL, e.g. the path info,query, etc., hdifferent seG reserved characters that mbgQ. TheB function oP cautious (not minimal) way to! aB"S1mos@thesBrts.RFC 3986 Uni Resource Identifier (URI): Generic Syntax list`follow#O(un)q%un = ALPHA / DIGIT / "-"._~8:gen-delims / sub f!":J/?#[]@hKA= "!$&'()6,A/ "*+,;"="zf!ofF is5Gome componW2of @but necessarily{bm~#ThjZ%-escapes6 are neitherRts ("always^a") nor@addi!al[s0via>G arg[#q is '/'$NH@ , !inZtypical usagepTPis beCred on aAwher3IPexist(Vslashz s tto be p3.7 updaZRfrom v@2396 3URLos\Now, "~"includedP;of  K0mayistr or%s.M 6K kpbe spec!deibytes object. j The optional encoding and errors parameters specify how to deal with non-ASCII characters, as accepted by the str.ie method.@By default,='utf-8' (cTB are!0ed ~ UTF-8),J='strict' (unsupported raise a UnicodeE eE)1"""Qif isinstance(Wng, str): if not6ingcreturn1ozis None7#=  </s :$= 9# =.d!e(i<)17els"ifvS2TypH("quote() doesn't $ 's' for bytes"w3m!isXk*Jia_from_afe) def $Iplus7='',7= r"""LikeE (), but also replace ' '@'+',4required}1ing@HTML m values. Plus signs in aPorigi1scaped unlessKAtheyMincluded@ssafe. IPhave :'/'(p# Check ia, wher>may either bDstr Q. If#!reno spaces, regularQ will produceight answer_if ((7A) or;+)=b >=f =:5 n %20def%3f'7](,carray)x %p) expecId&bs)" ';# Normalize 'safe' by converting to bytes and removnon-ASCII chars psafe =  .encode('ascii', 'ignore').Qelse: ;1" =j([c for c inJ if c < 128]=if not bs.rstrip(_ALWAYS_SAFE_BYTES +<)d`return5!deL6try$quoter = __ s[ ]except KeyError:12 = AA = QY(I).__getitem__U''.join([6([) 0harbs]) def url`query, doseq=False,Q='', $ing=None, es z|tR_via= Cplus=A"""E& a dict or sequence of two-element tuples into a URL  Ang. vIf any valu,C the(uarg are`xp is tru1achI$is eda separate Vmeter w0is / ,Qorder!he[#utput will match9 1GSinputThe componentsma"may each be either tro GtypeP},s~passed downF(functionspecified-0Tvia (o[@onlyaa!).O2"""if hasattr(70, "'#s"[Aery.( SP# It'"bo!t times that}2ing^-like objectr# 7 # q shouldwork with len8<Uempty<fail thib/!ifD )lisinstance=B[0],>?raise Type# Zero-length0ll Vsget heresucceed,L1butsminor nit. Si@\original impHak# allowed 'behavior probablybG# preserved^onsistency!Bty, va, tbys.exc_info f ("ai"n-{d% "g "or mapp0").S_traceback(tb)LRl = [/Fdk, v in query:   if isinstance(k, bytes): $ k = quote_via)Ysafe)'Oelse9 str(k), >, encoding, errors) Q vvv_ 9v l.append(k + '=' + vr for k, v in query" 74*el/tr '?afeQVtU # Is this a sufficient test sequence-ness?Cx = len(Aexcept TypeE# >"P# notlf 3c<& # loop over the <0elt8vW /?elt%/Y9'& Uc?eltQFiI( return '&'.join(l) def to_C(url2warnings. ("urllib.parse./ ) is deprecated as of 3.8",qD)BionW^, stacklevel=2A_e 6"""+"URL") --> 'URL'."""## Most URL schemes require ASCII. If that changes,gconversionFcan be relaxed.XXX get rid i0url !url = url.1e("").decode(Y[0Unihraise (& " + repr! +Q  " cont.ains non-ASCII characters") return url def unwrap(url):"-"""Transform a string like '' into '1'. V4TheK#ised unchanged if it'@t a ped URL.@1"""Purl =J."p( if[:1] == '<' and2-1:">' Jurl[1:-1]K47:*4:8 ^splittype}warnings. ("urllib.parse.0 ) is deprecated as of 3.8, @"useK1urlT() instead",C5 DcBionW, stacklevel=2\_1@ _prog = NoneT '6""">'7p:opaqueng') --> I', '.uglobal v&if6t, = re.compile('([^/:]+):(.*)',rDOTALL)vmatch =[.wk, data = s.groupsL-.lower()5X ,=suBiK 0KK KK'q[:port]L S L&w}LL L //N_#?]*)N BN*_ , eQ"if!*[0] != '/y ! +2s rPuser(5;1uw'[:passwd]@>t !$&, delim, "! =.rpartition('@'(5 if delim els%e None), host def splitpasswd(user): warnings. ("urllib.parse.3 ) is deprecated as of 3.8, "IMY"use M1urlV() instead",9DcBionW, stacklevel=2)4return _8"""3'4:a') -> C', '2.""*, delim, 0 = -tition(':'3, (/"if@C els@ort(1B #tag('/path#tagtuv _portprog =S 'l:=XWuglobal gR&ifAd, = re.compile('(.*):([0-9]*)',DOTALL) Vvmatch =[Q.full&1if p , " =.groups(`!if!5@a xngf?=-1>!de)T!@"""S9JA andting numeric.nRgiven default if no ':' found;ys to -1?X%al;pa validrrber areG` afterW Arobut not CQort =\.rpart}C! =-el6try0zp = int(wexcept ValueError9nN [ wquery(url1~urn _splitquery(url) def _splitqu: """q'/path?%r') --> B', 'A.""":*, delim,  = url.rpartition('?')-"if*uyrreturn F?)url, None1tagEwarnings. ("urllib.parse./ ) is deprecated as of 3.8, @"useJ1urlS() instead",5 DcBionW, stacklevel=2 +M#tag?tag#1tagOattr0 5 ; 1=value1 2 P2;...>L,2X', ['6c9u', ...]Swords3(';"R[0], 31:]]0(c)9iB 2.AO_qslE?HKyD!'v0 = j=2, (.Q else) """An extensible library for ope URLs using a varietyprotocols The simplest way to this moduleto call thaP func, which accepts a strtacontaia or a Requmobject (described below). ItsoURL and Presulks file-like Q;5-2ed  has some2ra method| |.OpenerDirector manageQcolleFsHandlercdat do (`actualIk. Each 3q0men dcular ` or op]0.  ismposite that invoke#e os neededr ed . For example, the HTTPHandler performs HTTP GET and POST requestsdeals with non-error returns. TheBRedirect_automatically Eo301, 3023gS307 rD e!s,taDigestAuthc U! dp authenu"tion. urlopen(url, data=None) -- Basic usage is gsame as original?lib. pas#1url opbata to post!anA URL get a file-like object back. One differencat you can alsoB a Ra insta-nstead ofn. Raises aE`(subclQof OSb); forkr:'v, whichbe treated& a valid response. build_r erd@Func(q that c<new OpenerD5%orb. Will!lldefault hvAccepts one or more s as arguments, eithe`+ eat it will ^tiate. IfefX2'a [ ,3]4 be!ed ?". 'llJI$ll=ca#e 9 2. bsinterest: r-- Sets upUser AgentPython-urllib clind manages %vK4lQaling8 P/Ds. T-- An,encapsulatpe stateaO} +bQsimpl 0URLtinclude extra p header,0.g.=Aser- t. Base --ternals:=parent __chain convons Exau: import a.vp # set ` info  + =8.$%()1P.add_word(realm='PDQ ApplicaO', uri='https://mahler:8092/site-upd?.pyAser='klem#d='geheim$parole') proxy_sup. P0({"A" : ://ahad-haam:3128"})a0 a 6KaddsF@cach5FTP 9 ](,\i ~ .CacheFTP2tI._opener(opener) f = urllib.request.urlopen('https://www.python.org/') """ # XXX issues: # If an authentication error handler that tries to perform # authentication for some reason but fails, how should the_be # signalled? The client neednPknow 4CHTTP9code. But if #h0she problem was, e.g.,it didn't 1Dat hash algo%[Qed ine chnge, it wobe good to # pas} in%palong tV, too. # ftpPs are6d cleanly # check digest against correct (i.e. non-apache) implementaPossible extensions co*x%x not sure wpexactly@ meant by this`bstrac`ctory er import base64TisectTemail {5libBttp. $io $os posixpath$re UsockelestringyB5tim3utempfilwcontextwarnings frome/@URLE ,  CKntTooShort CPparse6P( ], Qsplit join, unwrap, quote 9_-btype, Dhost  Duser 7wd,B5attTquery+Evalu\tag, _to_bytes@!un!un)frespon0add;url, addclosehookfSSL try:xssl except I}e#_have_ssl = False elseTrue __all__ = [a# Classes"'Rr', 'OpenerDi orRBaseHbDefaulK1Red@ 'CookieProcess\UProxy'BPasswordMg>CWithbRealm'e 'PriorAuthAPBasicz! 'QDRS 8Fil5FTP!0 'C# EData"U UnnP,`# FunciBJdbuild_A'name2url$Durl2getproxies', # Legacy interface 'urlretrieve',pcleanupURLopener WFancy2 ] # used in User-Agent header sent __version__ = '%d.%d' % sys.info[:2] _n = None def url(url, data=, timeout=socket._GLOBAL_DEFAULT_TIMEOUT,*, cafileDecapath default=False, context!):I'''Open the URL, which can be either a string o Request object. L*`* must9#an specify>additional0 to+Y1 toFpserver,l if no such6is needed. See 1forDsdetailsurllib.r`modules HTTP/1.1 ancludes a "Connecq:close"XRin it= Vl`The op8Cal ** parametD ifmseconds Pblock1PoperaPas likec attempt (#tk@ied,*@globo gP setta@will). This only work&x0S-0FTPP%CIf *fH* is&it ssl.SSLC instance describing various SSLZ!s.;j more  .**.yet of trusted CAcertificateS should pointa single J`ontaina bundlep8CA dbereas YMdirectoryChhashedGv@s. M!rmT1fouL P.loadqify_loc83s()\^3*caiKignored. [1funW always returns .~Q as aX` manag`nd has0 pr(tWW!s,qstatus.E.psponse.lnfourlD! o'sea1Forb@sw5is  http.client.0"ReH slightly modifi0In Hthree new methods above{0msg`ributei)Xsame Agreason61---qcphraseQed by|A ---0ead8 itim/documentc(x For FTP, file, and data URLsrequests explicitly handled by legacy 3aopener8FancyURLclasses, this function returns aBurllib.response.addinfourl object. (Note that None may beLed if nor@s th# (thoughMdefault instalglobal ODirector uses UnknownHr to ensureNpis neveycppens)0In ,proxy settings are detected (for exampwhen a *_3genvironment variable like http)0 is_@), Pk3is J`makes 00thr=!1'''R;_if cafile or capath :&Eimport warn. "("N,L#caMKprecated,E a "Lh"custom contexead.", DeEBionWE, 2)H5Bs nodraise ValueError(>"You can't pass bothTany oA"  _have_ssl 'SSL sup9Pavailp'T<= ssl.create__(Purpose.SERVER_AUTH,=<z=# send ALPN extenspto indiD HTTP/1.1 protocol.set_alpn{"@s(['7&']m"s_L1r =[S(N=6L = build[(L-&el )uDv}/= &se4*=pr-F.#Q(url,, timeout) def?(-2er)a( _url_tempas = []Yurlretrieve~ Pname=@, re*ChookO ~"""RF m into a rorary loca- on diskfRequires7@argut. If a N itqused asIiary file locZation. The reporthook argument should be a callable that accepts a block number, a read size, and theAtotal file0 of URL targetOdataQvalid2encoded .!. `AIf a_name is passed7 points to a local resource,Dt @sultAa copy from.ato newk{`Return tuple containing@patht^newly createdtM as well+ reEHTTPMessage object.;1"""url_type, k= _splitR(url)!Awithextlib.closing"@open,Q ))1fp:]headers = fp.info(T# Just r[a# "CQ" for5://`#s. No sense in performunless requested4if P == ""1notn40os.P.norm (3), ;0`# HandemporaryYi setup~patfp = j!u, 'wb')Jelse5@temp4t.NamedTFile(delete=FalseJ2p = tfp. j _3[s.append(69t?0ile]4b6i1024*8~size = -1<9= 0aLnum @if "lent-length": JtCint($`["Cont@L@]3'ifR8(Q, bs, K wh;Trug=L p.:(bs$0if +"Ybreak;Qr += len[ _write!u:+= b% #)!if7Q >= 0<craise TooShortError("retrieval incomp(: got only %i out%i bytesM0% (,*3ult=A decleanup()@"""C@ up 5sU3urle^$s.%3_ `6try os.unlink(@except OSError7: Qpass del _url_tempfiles[:]global _opener$ifO 8 = None # copied from cookielib.py _cut_port_re = re.compile(r":\d+$", ASCII) def request_host( )|"""Return%-% , as defined by RFC 2965.VariationaRFC: rFed value is lowercased, for convenientcarisonV1"""1urlP.fullZ = urlparse(url)[1i2if B= "".get_header("Host", "")# remove ], if presI~.sub("",yA, 1) .() class R:p__init__(self,p, data=", Qs={},\origin_req3unverifiable=False;amethod2 VqhvZ = {}unredirected_hdrs$_pX Wq_tunnel :TDkey,rn.w.items(i4add;$;if UQ( %U2  )2if  o# ="p@propertyC~]H1if Gfragment'{}#{}'.formatC$._R,A=_.=S.sett- %# unwrap('') --> '' oQ^% = _splittag gr@OdeleE7 selector = ''w y != @F!if2 !=  ^! =-# issue 16464f we change:tneed tocontent-length2 H (cause it's most probably calculated for previous value) if self.has_header("Content-length"):2=3oremove6 6@data.deleter@def (E\.r = None@.o_parse0type, rest = _split,._full_url%1 isi praise V*Error("unknown url 8r: %r" %8cRhost,"selector( N = unquot .+)$get_methodX """Return a string indicat the HTTP requGEA."""ddefaul` = "POST" Mais notQ else "GETDrqgetattr2, 'm:', c d6T#$set_proxy7 , 1,C == 'https' and\_tunnel_B" =+@8Qtype=*ns5"f! =/`av4addm`, key,CS# usefulg soUlike authentii!onWjs[key.capitalize()] =bunredirecteAwillbe added to a D f/drj4" W_name%x(3 in( " o!/ *4\a=Z.=es.get(I 7 A4) =I', 48popH,pH,6yQitems=hdrs = {**]#, E!s}V7Plist(F.`class OpenerD"or"__init__client_versionython-urllib/%s" % __version__ self.addheaders = [('User-agent', client_ve;%)];!# =Phandl;is retained only for backward compatibilityD B8= [_manage the individual pD_open = {}_errorprocess_response# Rquest"edef add_(,!):$mif not hasattr(/0, "=wparent"/3raise TypeE("expected BaseHy instance, got %r" %uF Dtype5)) ,added = Falsemeth in di 4if %["redirect_re-a", "do Rproxy] # oops, coincidental match+continue1i =.find("_")9protocol&6[:is?conditioGk[i+1:]c%f '.startswith("a V7j =3 + i + 100kinj>try=!;@int( !except ValuXHMpasslookup =_T.get(]N, {}y.4[0B] = [ r7elijP == ""4 = P F] L *pt. dy<-xP w.se`W"M.setdefauliJ, []$ifsfbisect.insorts9t.appendE (Tr) if*ed rB_VRclosem0# O!iexists(s).V_call_chain\!, , ,_name, *args): . # Handlers raise an exception if no one else should try to h9#  # the request, or return N@ ify can't but anotherGrHcf@. O Rwise,<Pgusponse.7 rs = chain.get(kind, ())'%for4 in}%s:!func = getattr([, meth_nameP/result = 8j(*args!3if $ais not sH0+ def open(self, fullurl, data=Y, timeout=socket._GLOBAL_DEFAULT_TIMEOUT)o@# ac` a URL2a Rq object{if isinstance(~7strP)Treq =F) D7Xv!if 1 q.c! =-3>Creq.$ ="`protocol =V.type;# pre-process ;4 = G3+"_"(gD ori./FK, []Um>/or7V(req)sys.audit('urllib. ',._Y:Srheaders @get_\(odQ"re1 = _2reqg# post[94\^ \(]0^@Y! = c&8!NQcall_.J, 'default',E-<  ]AH,L/ +0/._e unknowne'+ Qerror", ,t"if 2('http', 's'$h`# XXX #2[s]6cols are special-cased2dict = self.handle_error['http'] # s is not different than'  proto = args[2] # YUCK!%meth_name = htq_%s' % C 0#I = 1Porig_krUelse:dict = self.hand %@ + 'z9or')0(k,%, S1) +/Uresul_call_chain(*J))2if , creturn . 0U3 = 'default',^\IwI` # XXXbably also want an abstract factoryE0t knows when it makes # sense to skip a superclass in favor of b6andFaight #NKinclude both def build_opener(*2rs):"""Create$P objerom a list9.CThe 0will use several b 3", 0ingAportpfor HTTP, FTP applicableSr`If any5the\ passed as{Pument Be su4#es3sM   be!d.=1"""1= OU@Dire(M_es = [ProxyHPr, Unn ` $DE0"1RedE4FTP#U File ^WProcessor,DCData8]$if hasattr(.client, "USConnection"r #.append(2]Lt]3k" G`&PcheckH#if isinstance(-g, type(,P,-1R.add(%(!elO {* /K0!7 t.remove > 0I_AE2())Ghs< hXSh = hph!! WD Basx_order = 500add_parent(self, parent): Rself.# = def close($3# Only exists for backwards compatibilityGhFpassUa__lt__Vw, other]if not hasattr(, "handler_order"0_# Try to preserve the old behavior of ng custom classesHinserted after default ones (works oIKuserF\ which are aw )).=return True." V =+origin_req_host= <unverifiable=Trued0# IAmente: To avoidserver sen!us into an# infinite loop,3? object needstrack what URLs weDhave already seen. Do {Qby ad{Aa ha@-specific?attribut"~}Kdef Pself,nO, fpr# Some s (incorhCly) multiple LocP# (so probably Q goes0URIdUse firstA>Sif "l["_ s# =?&s[4] elM?uriH/C*sez fix a possible malformedurlparts =Sparse8@# Fo0curc`reasonC` don'tw%own0yth$qa# than,sn7ftp{i p.schemeu ('Gs 0ftp'0*TTPError(  newurl, code, * "%s - Redirection to url '%s' is not allowed" % (msg, T)Oheaders, fp) m!ifGurlparts.path andiunetloc:2/ = list()&[2] = "/" =fwunparseD'# http.client.'_P() de8s as ISO-8859-1. Recover theJoriginal bytespercent-enI non-ASCII#,$any specialMcharacters suchthe space.(equote(B!, |ing="iso", safe=string.punctua`@Bjoin(req.full_R# XXX Probably wantOforget about1 state of ucurrent# request, although that might inteP pooreith otherBPhandl99also use -l4ficj attributesEnew = self.r_T 3I ewKJNonefreturn)# loop detE&# dict has a key1 ifwas previously visited, if8'T*')? = =; zCif (@R.get(+c, 0) >Vmax_repeats o>4lenB 4s8raise HTTPError8inf_msg +-;els5U = {}:=[. D8+ 15Don't closeSfp until we are sur atw-iuwH74fp.read(f-Gose(/ paP.open, timeout=> ;z _ea_301 =372R= "Th@ serTed a  qTwould " \P"leadan infinite?.\n.vlast 30x_message was:\n" def _`aproxy(A"""R  (scheme,'r, password, host/port) given a URL or an authority. < If a URL is supplied, it must have an authority (host:port) component. KAccording to RFC 3986,D Fc: means theu Lytwo slashes after(bschemes1"""/B, r_  = _splittype(proxy))eif not(.startswith("/"):%#\ENone!= jHelseN1URL\ .raise ValueError("f06 nor: %r" %D@# We , so for-Pliant^s (by ss 3mIand 3.3.), path8empty or N 8'/'e'@' inyVT_separator ='.find('@'0=end%Z"/", I5 C 261if jJ= -1 q[2:end]userinfoA(G0if 2coPssworppasswd(<M 1 = *;Zrreturn ,d class PYHandler(Base H#!2iesM beQfrontmh9P_ordeA100 def __init__(self,@ies=^$if%! *S= get (PasserQsattr(ies, 'keys'), kA be a mappingxE.\Waroxies`P, url+w.items(.*0 = g.lower 1setu, '%s_open' %3,v,lambda rFay=url,/=gp, meth=QyR GJ.(LH&))C3reqy-[Porig_0eq. IBaparse_.yd!is#8 %=  pif req.X 0 by=( E IxE:ord_X =0:%s(unquote)2L) creds = ba se64.b64encode(user_pass.Q)).de"ascii") 'req.add_header('Proxy-authorization', 'Basic ' + credsDhostport = unquote(%ePset_p] !, V_type,qif orig7 ==$: or'https':# let other handlers take care of it1return NoneLelseWneed to start over, because thesJdon'ia# grok,'s URL typy# e.g. if we have a constructor argies like so {'': 'ftp://p.example.com'},^may end up 5inga request for Ux://acmeM/a into one' C)/a(self.parent.open(req, timeout=H ) class HTTPPasswordMgr: Wdef __init__(U)#.#vwd = {}2 1ord6, realm, uri, \!, !dP# could bsingle URI0a sC&ncif isinstance(\7strS}uri = [uri]"if not in )[]default_in True, Fareduced_etuple(Nr*)H(u, a) u6uri;W[Is{Pfind_ odomains =<Q.get('F, {}&"tb  Jr`uris, -@info2{.items((B7,>"ifis_suburiz d_q ,9)B,H]!I=w"""AcceptPorityFMand extract onlyK&path."""#+e&n@s doX< componen@part(urlsplit.1if !:[1]n#scheme =10!1!=2] or '/' welse: # host orY:port scheme = Noneauthority = uripath = '/'g , ` = _split (G)+if default_#B and9!isais not d;= {"http": 80,b! !s": 443#b}.get(sFj& = "%s:%d" % (Vureturn 3 , N def is_suburi(self, base, test)"""Check if is below/ in a URI tree[Both args must be$s.reduced form.05""" "if[!==q)6TruD1R[0] !4?[0]7FFals8common = posix.prefix((2[1]F[1])\rif len(0A) ==1? class HTTPPasswordMgrWithDkRealm( "):qfind_user_pAr:,7uri-o, =~.S E0if ^1%? ! PriorAuth~ __init__* `, **kw y. enticated = {}super().Q K?addAuri,^9 d, v= yupdate_*(N*ist# Add ax pD requests1if  d6j,e )G7 :#_` couldqa singl0a s&nciinstance`7str^uri = [uri]4fori0in !,  -u:uriK_h.(u, default_port)  self.authenticated[reduced_uri] = is_ C=def(M , .Quri):)-for default_port in True, False)-G0 = W.(,T)nEr0urii>3 p/"ifeis_suburi(uri, td 5breturnA h[B class AbstractBasicAuthHandler:Q# XXX this allows multipleU-schemes, but will stupidly pick# the last one with a realm specified.tkj double- and single-quoted<cvaluesc(" "s are a violation of2RFC`appearBwildrx = re.compile('(?:^|,)' # startLstring or ','p'[ \t]*<P # opal whitespac/'([^ \t,]+)'ucq like ""n+nmandatoryo#OO=xxxX O'xxx"O"xxx=(["\']?)([^ *)\\2',vTre.I) could pre-emptively send info already accep((RFC 2617d # 0oZc2 2,]e1.2 immediat_after "cred2alsq# produ5)~__init__vpassword_mgr=None8if @ is "  "s= HTTPPTBMgr(6Q.9d =Y\#Aadd_' or)(d.waparse_gheader!# %P WWW-E+ *: 9challenges per'efound_$" = @r mo.rx.finditer(0S,-U= mo.groups[/"if*1 no)['"', "'"],warnings. ( ! Rawas un"d"7RUserWQ3, 3+ryield ( #LG!if ' #if ?{# =!.split()[0]'eQ scheme = G'' yield (scheme, None) "def http_error_auth_reqed(self, req, host, eaders):Bg# may be an7ority (without userinfo) or a URL 7 anGo8hm3 = .get_all(,Ereq)+dif not(#noe found6breturnunsupported =//4forH#in sl#krealm in O._parse_(Fz2if ?.lower() != 'basic'j. =!continue1if 1 isF$m # Use the first matching B challenge.# Ignore follow82s even if^y2 XMkzaretry_I(8if Vraise ValueEC("AbstractAuthHandler doe\"v"}'O: %r@ %) b, pw =Ipasswd.find__Aord(:L /pwT raY"%s:%s" % (SoBA = "S " + base64.b64encode(raw. Q)).dez"ascii"MqG.d_"1 == Z$ req.add_unredirectedTer X.parent.open(wtimeout=e >JelseLqrequestAif (Eaasattr$.ad, 'is8enticated']! :' 1.full_url)x@6req4hasL'Worization'HD!P credals = '{0}:{1}'.formatm) Bd_str =standard_g]'Authorization',/ 'Basic {}'.format(auth_str.strip()))Mreturn req def http_response(self,!!):,if hasattr).passwd, 'is_wenticated'59t200 <= j.code < 300`+]z.update_(req.full_url, TrueAOelseW.GFalsX=B>s_request =N7!5" class HTTPAuthHandler(Abstractc, Base&"):_header = 'Horization'#error_401pq, fp, r, msg, Ks@url |q1 = _freqed('www-)%',BF 6req= V\Proxy>W*R]7]#< 4uires that there is no userinfo component in # iority. Assume?n't one, since urllib.0doeagt (andQshould not, RFC 3986 s. 3.2.1) support ests for URLs containingN.fEhostbpd"C2# RWn random bytes. _r = os.u`Digest"# 0ionspecified inR2617.# XXX The cli in8F nT -II#Ya successfulf3It be possible to tthis implementc again# a mock serverjust generates a s:c set of challengbPqop="T-int"s,Bhaky__init__W=None2if A=PvordMgr(( DAadd_ord = self.passwd.add_password self.retried = 0nonce_countQlast_" = None =def reset_Wy>(h!):!z w;http_error_auth_reqed?!, header, host, req, s`*Treq =P.get(_-,)w9if 6> 5!# Don't fail endlessly - if we0ed 0, we'll probablydGAa second time. Hm. UnSc the P Manager isEprompting for4 information. Crap. This is[greatDbut it's betteF!anKcurrent 'repeat until recursionGdepth exceeded' approach .raise HTTPE (req.full_url, 401, "digestV)",EGsJelse E+= 1W!ifp;req2tcheme =.split()[0]<>+.lower() == ''S/freturnq!y_06req=.eln!= 'basicmtRValueu"AbstractDj`AuthHar does not support"~ "3`follows: '%s'" % )/trtoken, challengf' ', 1#' = parse_keqv_list(filter(,t4[&))I" =1getAorizc81E F_val = 'pa %s' %R ^i7#q..B]:valn] `ladd_unredirected _ i`\$sp pa%R.open@out=i >Fresp[cF!, b# The # -v is an opaque# quoted str+provided by0cliband usRboth M"@servo avoid chosen plaintext attacks, tojx mutualJuthentic: , Z0some message XPgrityO1tecLa fabulous effort, { Good Enough.  s = "%s:" % (self.nonce_count, , time.cC()) A b = s.encode("ascii") + _randombytes(80dig = hashlib.sha1(b).hexdigest(*return dig[:16] sdef get_authorization, req, chal):,6try qrealm =(!['%']/"" "3qop .get('qop'Dalgorithj({', 'MD55b# mod_ doesn't send an opaque, even though it i% # supposed to be op$)al&O v', Noneexcept KeyErrorN2PH, KDJu_impls(fqif H is|cuser, pwfpasswd.find__Aord(.full_urlv.y# XXX not emented yet^ ifP.dataX+ 2ent n$centityA(reqB]OelseJe(A1 0alm;%A2,)}method(),selector: what about proxies and y_ urlsIsG# NOTE: As per RFC 2617, when server"0s ",-int", the client could use either `(`#o@`<Bresponse back. weG@$)[0if ."spKD(H(A1),zw, H(A2)q`elif '@' in^.split(','"ifA == iQlast_X E-!U += 1"} 8 7%~" = _ncvalue = '%08x' % 0c(F5bit(%sk", I,g ~ f|33phandle o.[aise URLq ("AD'%s'OPrted.Fqop)_!shpartial digests be encoded too?  base = 'username="%s", realm Dnonc3uri5' \EL'respons-P' % (WN!, Iq.selector,DKVEdig)+if opaque:0S+= ',.-if entdig@edigest@.@ialgorith,l/oif qoplqop=auth, nc=%s, c(}(ncvaluepreturn def get__impls(self, )# lambdas assume  modules are imported at the top level] == 'MD5'e3H =k x: hashlib.md5(x.encode("ascii")).hex(Feliff?SHAfOsha1g# XXX MD5-sess;elsnpraise VError("Unsup+ entication "P "EV%r" %&KDIs, d: H("%s:%s1()."ZH, KD#2ty_!data, chal"0notPlemen 5yeteNone class HTTPDEAuthHandler(Base , Abstract'}\"""AnB protocol defined by RFC 2069O 8improves o0,ic!because iPdoes transmit passwords inaclear.2"""}p_headerUAoriz'+h 2_or$490 # before BasP`http_ecC_401req, fp, :r, msg, xs?^host = urlparse(req.full_url)[1])retry = ).qreqed('www-:_cate']~vareset_g_countbcRProxyhXdT-O;7!7E pe',  host, req, headers) 6self.reset_retry_count(!qreturn  class AbstractHTTPHandler(Base 1): `def __init__(i, debuglevel=0):&&._' =*MGhttp*XSQ #L_get_content_lengthLwrequestN{.client.Connection.NUo.data,method())3do_<D =.cpif not paise URLError('no%s given')%ifZ1 isRNone: # POSTo1& if isinstance(W, strFpmsg = "b ( should be bytes, an iterable of9" \rL"or a fi/bject. It can%bD@type-."Dr4BType56msg*anR.has_s2('Cl-_'4add_unredirectedA p V Y 'applica/x-www-form-urlencoded'(2 9n1and#ATransfer-|_ing')  2 = "$ (d :if + NL.l()JelseM+h, 'chunk@sel_! =kproxy(pscheme, = _split.selectors9U_path>1RLHostJ5 '5zmi`for navalue inPf.par2adds3! =:.capitalizeA? V1 r(name, valuSe) return requestdef do_open(self, http_class,+B, **onn_args):RB"""RUan HTTPResponse object for theItw, usingd.fy must implementB^Connection API fromK.client. `host =. pif not raise URLError('no%w given'P# will parse#U:porta1h =M(i, timeout=req. bD.set_debuglevel.headers = dict(bunredirected_hdrs)Z..update({k: vak, v i'.Sv.items(='Aif kN3in 4}# TODO(jhylton): Should this bdesigned to handle# persist c&s?:p# We wa*so make @/1.1|"buKaddinfourle isn't prepardeal with avB# It0tryread all remainBdatawsocket,RwhichEblock whileserver waitsBDnextS 2sur>: gets closed afteV(only#V&["a"] = "L"( = {name.title(): val,0d} if._tunnel_A p}proxy_authP-AuthorizaK3;if 6 }. [:   I/# " s'@be sto originC!Y4del hm?z,C=!_:try# #h.cget_method()p.selector0{)I encode_chunked`3has('Transfer-(Ving')Jexcept OS as err: #-orv -:errWrS.getrFs 3!h.M&fH# IfAdoessend us a 'Connection: close' header, 2# HTTPConnection assumes the socket should be left open. ManuallyJHmark8 to4yd when this response object goes away.LPif h.~:.R/() = None  r.url = req.get_full_url>0# Tline replac.msg attribute of/Rg# with .^s, because urllib clients exp\'toGAhavegreason in t. It wgood to q'isBis deprecated and get]n<info() or@rD.-return r classKHandler(Abstract0"):def http_J`(self,)Z2.do(2.I.U>\&_request = Q!0_ j as5(;a0, 'cSd'S __init__debuglevel=0, context=, check_hostnameQa 'R_q$ ={_$ + n/;s>'pCB=f. 4 )%z__all__.append( (')CookieProcessor(Base)3 c5__a)!# y\R= Non\(if.=!is> :try?<= tuple(#`socket^  byoQ_ex('')[2] +>byname_ex(so cket.gethostname())[2]) except so-aierror:$/FileHandler.LTs = (6c byp('localt6'),m}return H k# not entirely sure what the rules are here0def open_m_file(self, req)import email.utils?mimetype =I. 1eselector % = url2path0(  6try@statS0os. (L4'`ize = #)B_sizmodified =.formatdate(<mtime, usegmt=Truelm5 = !p.guess_5[0]`headertmessage_from_string(15'Content-\d: %s\nlength: %d\nLast-'=' %N(or 'text/plain', -$, @)0if  !, F= _split ( C^ or \= and _safe_<<P) in _87s()origurl = '~a://' +0 + X NelsePIaddinfourl(, 'rb'), /#, R0OSEz as expraise URL#F(exp? d1on ] @') Kq W& XFNone class FTPbD(BasnAftp_Haftplib!if&F Q2tp ,1 noMv given'E;"if^0is  v."= .FTP_PORT1@int( )_#r/password h5ingQRuser, !ifL (!, [+j d('! =@LknquoteS0sern"''7 passwd = passwd or '' Etry: host = socket.getpbyname( ).except OSError as msgMraise URL#F(msg?path, attrs = _split(req.selector/!di(6.,M('/'list(map(unquote, 8)(, file =R[:-1]'E[-1]!if and not :[0]]H&1:= V fwTelf.connect_ftp(user,  , ^b, port , vtimeout0typ1'I'%D''fbttr ini #r`, valuQ( v0!ifJ.lower() == '')\0# ]in ('a', 'AiId>D')@\" =D@.uppu e fp(trlen = fw.retr( , A QheadeM)""Km,p = mime s.guess_ full_url)[01if =m+= "Content-P: %s\n" %9 0if !is}ANoneaO>= 0mlength: %doB q = email.message_from_string($ Kreturn addinfourl(+%q.4r8ftplib.all_eAsB:expVexc =BQ'ftp /: %r' % expt exc.with_traceback(sys.exc_b()[2])Hdef oself,   aftpwraD,L `persis7=False) class CacheFTPHandler( J# XXX would be nice to have pluggable cG strategies; this stuff is definitelythread safe3E __"0__(B.iA= {}0H Qsoone03delay = 6@max_P&16BsetTF<, tRt5MaxConns6m6pm:L! ke@'/'.join(z3), > 0if ;0in z.cache:  self.timeout[key] = Q() + "bdelay 3u else:%TcacheEftpwrapper(user, passwd, host, port,CGQdirs,Iout)8{5acheck_(Tbreturn tHdef 6G) r# first# for old ones>t`"ifr so/ft <= tY:Ok, v in list(}out.items()4lif v (authoriza1ed)I `__temps = None@p= "Pythrllib/%s" % __!"__0nstructorZ__init__(self,(Pxies=g, **x509`msg = "%()s stylePinvokrequests is depreQ. " \u\"Use newer@funcs/method!{'n0': 1.__P__.__'5__}Ywarnings. s(msg, DBionW, stacklevel=3)=$if = getpro)(?assert hasattr(!, 'keys'), " mbe a mapping3(=s@key_0 = P.get(e'-Acert . /3addQ = [('User-Agent',V), ('Accepz'*/*')] [unlink =+ @# SewWeanup\gn# Undocument eature: if you assign {}E,? it@used#dbs retrieved with3T(). not enabled by default '# since it does not work for changing documents (and I?"haven't got the logic to check expiration headers<Uyet).self.ftpcache = !D# Uned feature: you can use a differenBftp Wby assign!touwmember;rqin casedBwant ally independent URL openXXX This iYthreadsafe. Bah. jdef __del__(!):.close()-+Zeanup- /# code sometimes runs whenrest of temodule# has aly been deleted, soP cany globalor import anything 0if .__tempfiles? in* .:try?epunlink(Q) except OSErrorH6pas5=del5[:]] Xh.clear2addO1w, *args """Add au be!Ad byHTTP interface onlyve.g. u.e0'Ac', 'sound/basic')"""53@s.ap(# Externaly?>fullurl, data=None0Useq2Per().  insteadx, 'r').b = unwrap(_to_bytes() = quote" ,  ="%/:=&?~#+!$,;'@()*[]|"?  CU Sname,2s =W0[J[Afp =BF'rb'&return addinfourl(fpj#, Z4urltype, url = _split+!ifK2 @ = '' ifZQ\proxiy  Cies[V  , &Zyhost%,eUector/(/ 3(6` # SigrspecialI!to6_*(DJelse#i0 = 5D_' +-!?= name = name.replace('-', '_') if not hasattr(self,4A) or  == 'open_local_file':AHif proxypreturn W.Dunknown_0(, fullurl, dataAOelseW(J+tr!ifl is Nonb!',h, rinvalid for %s' %# ExternallretrieveB, reporthook K, 4s (N, headers)!a Zq objector (temp6cremote7 7= unwrap(_to_bytes4"ifdcache andli Q#U[url]h1%4if (B+'g# Bfp =\1,hdrs = fp.fp.close(<5P2path+(Bhostq`[1]), f Z  bvEpass1 X A c~}tq@7'wb:garbage, B0AB^or ""|#, =gquery(path or "K")  path, garbage = _splitattr(_ or "7suffix = os.(.71ext6M)[1]j(fd, filename) = temp@.mks (Upself.__$0s.append( M l2tfpafdopen{J'wb'\Mtry:;result =, headers+1if cache is not NoneZz 0[url] = t `bs = 1024*80siz--1read = 0blocknumif "content-length" inCint(#3["CDLD]rif reporthookY (`, bs, Rwhile 1LA p.>(bsA/J&]breakZ]r += lengtfp.write% >+= nE'Iofinallfclose(-4fp.(" # raise exception if actualB doe4jmatch Nqt>= 0 and u knows how to` that 2URLHQdef _9generic_http(k,Q0necz_factory, url, data)5"""Make an HTTP8g usingr_class.}A@Thisan internalshould be called from)n7s()dArguments- ltQ hostZ.%an| 3Con$ instance.#-/1the 6to 1Aor afplative-X pairEoFpayload f:POST request966"""euser_passw)Sproxy=}if isinstance(url, str): host, selector = _splitY(url)-0if  BMuser_passwd,#I(5 J5 = unquote%Creal%Jelse 5url/l(# check whether the proxy contains authorization inform I5q# now wpceed with0urlwant to ob nurltype, restT( XS=. Hy = None3if j.lower() != 'http'iL J2 ( 24if g!X+"(^"@a` = "%s://%s%s" % tg/ byr V aif notX: raise OSError(' e a', 'no& given')C*wd 1 = base64.b64encode(i.Q)).dev'ascii'Q3A_c tB` 1"Xhp_conn =q0nece0_fauyheaders = {} 00["P(-A "]bBasic F\VP( "Q;KwOAHost(# Add Con :close as& don't support persistentPes yet.# This helps in N1ing{socket and avoidResourceWarninga"R&e")Bfor -p, valuewself.adds8Sif data isVB@"ConR-Typeapplication/x-www-form-urlencoded" #http_conn.request("POST", selector, data, headers)?Uelse:TM*GELF=%) A:tryNresponse = Y4get(Qxcept'.client.BadStatusLin# something went wro ith the HTTP s=U lineraise URLError(" protocol eX: badA"# Accord}to RFC 2616, "2xx"  indicates that%'s##  was successfully received, untood, and ac(5ed.Gif 200 <= W.\< 300turn addinfourl(5,?Qmsg, :" + url,nAEz b!rePself.z_q(av.fp ugreasondef open_(,)f=None)8b"""UseT'6.""_Wrgeneric_dConnecti 00fp,^ aHandleV=Fors.0Derd class can override this, orvspecific hRrQnamedb_DDD where ie 3-digit# B# First check if1|re's a zA forL8F = '>`_%d' %'5)if hasattr:\od = get*I)!if3@ is 65result = S( <?U! [ if_Sult: W_defaultKl?Wu SB"""D|$or`: clos e \.!OS r1fp.6-/0err>sOif _have_sslstKhosttohttp.client.HTTPSConnection(host, key_file=self.CGcertD%) def open_https(l, url, data=None):. """Use HTTPS protocol."""&preturn P!._aqgenericih. 5s_c%z 6$`local & or FTP depending on form of URLif not isinstance(7strcPraise?qError('je :xy supportk currentlylmplemented')4 ifv[:2] == '//' and`2:3] !12].lower()e*/'RValue":// scheme isped only1O"Kelse\7sI  m_email.utils=mimetype,= _split`name =pP2path((:trystats = os. (H4except OSzL as A WQe.strV@, e.P0sizou_modified = %.uatdate(8mtime, usegmt=TruedmC5 = Np.guess_95[0]t`headersmessage_from_string(-m'Content-Type: %s\nLength: %d\nLast-'9' %J(or 'text/plain', $, <) 0urlk! =* e!if3[:1 ]?:+7 Kaddinfourl(26, 'rb'), T!,  \&@if (Psocket.ge by_?R in (g(),) + this)h 58%elM. may start with /%:. Unknown'0of q0" %Wh'rb'), headers, urlfile) raise URLError('local $ e: not on qhost') ?def open_ftp(self_!):_"""Use FTP protocol.""" !if]isinstance(url, strEI 4ftpproxy support for o currentlyjmplemented'!im<mimetypes, path = _split>/: 0no $g given~!, e (fRuser,A& &0if :Esswd pa("Ybelse: y = None = unquotelGGor 'VB ' = socket.gee\bynamt1 f!eftplib, =lib.FTP_PORT#1@int(<*u, attrsS( ' !di=.P7('/1,} = b[:-1], 5-1]!ifA and,20]:</1:1[0] = '/'`0keyu,$`.join(q# XXX thread unsafe!Laif len! .ftpcache) > MAXFTPCACHE# Prune the ., rather arbitrarily_k in listj \.if k != key!v5elf&[kJ!@del )v.close(3+tr}enV u ey\ftpwrapperM ;k  : "D"$=Isu, valueR(,l!if.lower() == ''O('a', 'AiId+D'ol\" =!.uC (fp, retrlen)5@ey].E(,- Dmfp.guess_("ftp:" +:)[0QheadePT1if V:  headers += "Content-Type: %s\n" % mtype  if retrlen is not None andY>= 0:5@mLength: %doZ <8 = email.message_from_string($)9return addinfourl(fp,, "ftp:" + url9 except ftperrors() as expraise URLE&a('ftp 1` %r' %1 ).with_traceback(sys.exc_q()[2]) def open_data(self, , =^)}"""Use ""A."""Gd!ifisinstance(url, strC) O: proxy support fortocol currentlylmplemented'G# ignore POSTedB# syntax of#s#url :=:" [ media ] [ ";base64" ] ","5c-Q:= [ 7q"/" sub ] *( ";" parameter 4*urlchar_6:= attribute "=" valu>6tryQ[0] =.split(',', 1VOq H!OS!('b', 'ba~[* M = 'text/plain;set=US-ASCII'asemi =S.rfind(';e""2'='5n4[*:]encodingX$E+1:]u; [:FOelseR' msc[9msg.appe1Dat'%time.strf ('%a, %d %b %Y %H:%M:%S GMT', N0.gm(.F()))d .6if :=' P# XXXEthis03/des9ok?K"= _.'pebytes(.qe('ascii'))"('latin-1 BanquoteQ-2len45{Lt 0\n'.join(msgS w 1f = io.S*ION#f.fileno =0# neededd class FancyURLH5er( """Derived class wit h handlers for errors we can# (perhaps).""" def __init__(self, *args, **kw !):)-URLopener.3 2R.auth_cache = {}tries = 04max&10Qhttp__defaulturl, fp,Acode msg, headersB"""D=."oring -- don't raise an exception3return addinfourl({j0, "Q:" + 0err)?302, data=NoneE@ 302relocated (temporarily`E+= 1{6try)1if ,2and>">= >BshasattrG500"0Smeth ^O2+NelseyE; I6(M500,*]"Internal Server : Redirect Recursion"I @)ndresult rT#_itf F{b Ukfinall.+-a*,d Aif 'tion' in)"newurl =[4]% elM?uriH/C yBdfp.close(x# In case the s3sent a relative URL, join with origq0url(].type + "|(purlparts =se(%p# For sity reasons,O dallow ion to anythGUother@# thPttp,  s FBftp.We are usBnewer HTTPMElderu 'odpaThis o. will get deprefin 3.3 if.scheme note ('1', s 0ftp'8Z errmsg + "Xion to url '%s' is not allowed." % newurl, headers, fp) *return self.open(K"def http_error_301(* , n fp, errcode Umsg, gdata=None):n@"""EJ 301 -- also relocated (permanently)."""9 /2(363essentially id cal to 302U767a, but @POST into)or0if 1HOelse^default;54" retry=Fals 4 2uth4tion required.This func supports Basic a>LonlyW'www-(!e'\$in P0URL%7er.N  C)Ctstuff =[],match = re. ('[ \t]*([^!+)+realm="([^"]*)"', et!if Dsqcheme, 1 = .groups(s*.r() != 'b'rY&g xkname = '}B_' +type + '_'_'Qrgetattrhe)\@ , data) def http_error_407(self, url, fp, errcode msg, headers, data=None, retry=False):@"""Ec 407 -- proxy authentication required.7This func supports Basic>only."""=Aif 'h-he' not inURLopener.{defaulth8 D)Ctstuff =[].match = re. ('[ \t]*([^!+)+realm="([^"]*)"', gv!if Dsqcheme, 1 = .groups(s*.lower() != 'b'rY & {mname = '}_P_' + .type + '_-_'W!if@ is  return getattr k!)(+Oelse@T!) Hdef }=xPhost,ector = _split`newurl9i0://4';?}V =X f. Pies['9'urltype,K(8y&11selu &96i =c.find('@') + 1],7[i:ser, passwdget_user_F7, iM(13 orK )::S"%s:%s@%s" % (quoteE, safe='')a8: I y" +B-iO(^  3shost, selector = _splithost(url) newurl = 'https://' + ( + selector.pproxy = f. Bies[:%']&urltype, "yL(&1v &96i =c.find('@') + 17,7[i:ser, passwdget_user_realm, ipf not (13 orK): return None"%s:%s@%s" % (quoteE, safe=''),88:>sel 2+Dif data is:kRopen(bOelse3,f!) _0defP0ry__basic_auth(js, url, =v)h [ U-P! =!F<A%E? = <.7`# ose8 e ,clear_cache=01 keRT + '@v.lower(#0if ,"inO}7if k  ?y server URL mappings.Scan the ` for variables named _R;this seems to beIstandard conven. If you need a=different way,! a8ies to`<[Fancy]URLopenerlstructor1"""+IA= {}# in orderprefer lowercase,Icess#inE@two es: first matches any, second"eAonlyHj`q, value#s.Y.item/+! =.N6#ifDame[-6:] == ''[T[:-6]] =B# CVE-2016-1000110 -we are running as CGI script,:get HTTP_PROXYL(non-all-i);i6y:set fromD webaby a ":P# hea/cclientj@If "Vy" is, it will stbe used thanknext blockNif 'REQUEST_METHOD'Rsies.pop('http', None!if 0nam X#Oelse=|<re  @y_by2 Ahostj=2s"""Test ifb shoulYa particular P@Chec!heByLdpRof nos, whichfbe a listTcomma separated DNS suffixes, or '*'^1allc!isk # don't bypass, if no_proxy isn't specified try: Ano_p* = ies['no']!except KeyError6return False*# '*' isk al case for always bypass,6if v=9 Y2TruXphost = .lower()D# strip port off"+Ronly,= _split)(@check if the> ends with any oDNS suffixeuname in.cV(',')% = .v6ame-* 1l2 '.') # ignore leading dot7 ;'i!" =c2 or 5mQ'.' +xk.RQ(3)r y# otherwise, doO # This code tests an OSXfic data?ucture but, able on all # platforms def '_y_macosx_sysconfY,Ay_settings 1""" R3N0 if]"isashoulde accessed usaU Cfunction uses0Mac framework SystemConfigura.@to fetch6@y in#.e come from _scS._getget mocked i { 'exclude_simple': bool,  eps': ['foo.bar', '* @.com 127.0.0.1 C0/16}Sm@fnma im  &Pip2num(ipAddrparts = ".'a"list(map(int, 8)&rif len(Z != 42 = "s + [0, R])[:4q *[0] << 24) |=![1'1628j2[3]#1# C#s0if 0notT"ifK[ ]-1!PIP = NoneAvalu~_P.get(cQG, ()p# Items@ are P likese: *.local, 169.254/161ot : continu qm = re.{(r"(\d+(?:\.\d+)*)(/2?",A mL U IP#x  hostIP = socket.getpbyname( conly) / <aip2num..IP,except OSError:Lcontinue sbase = `m.group(1)dtmask = 21if !~is Nonet= 8 * (D1).count('.') + 1T?elsI@int(TZ[1:])b< 0 orN> 32!# System libraries ignore invalid prefix lengths7Qq = 32 -~ 1 >> a) == (return Trelif fnmatchU, value)@ <False if sys.platform'darwin'I from _scproxy import _get__settings,2iesBdef &bypass_macosx_sysconf+Q& =Ryg()b,Y40getu-ieB"""R a dictionary of scheme ->b server URL mapp. 2This funB uses the MacOSX frameworkConfigurap~to fetch:@y in'.(5""" (ries() H_A P, if  should be 8'edeChecks! gathered SenvironmentZspecified,&or/*'= Wi2iesGJy-_Bk6iesI(H ) bC0os.#nt<registry~+VWin32k` to stq?ies%{}5:tryewinreg'8I<# Std module, soaround - but you never know!  return proxies U try: internetSettings = winreg.OpenKey(HKEY_CURRENT_USER,HLr'Software\Microsoft\Windows\CurrentVersion\Ix y)')PvyEnableQueryValueEx(S'ProxdY')[0]!if= 5U1# Rced as Unicode but7blems if not converted to ASCIIiMServer = strv;kp |#if '=' iCy,+# Per-protocol sJ ,[for pV.split(';')a9_, addresp:^=', 18P# See;has a type:// prefix> re.match('(?:[^/:]+)://'G|= '%s://%s' % (%Dies[34] =  OelseM# Use one 0all. [:5] == 'http:'k;)'P 2>P Q ^ DsEF2ftpD?ftp v.Close(except (OSError,  AType m# Either registry key}found etc, or the v@)an# unexpec{format.!ies alreadyB0 upbe empty sow@hing)doB6pas] )sdef geth(2"""p a dictionary of scheme ->xGURL mapp!. ^Es ga9qed from!environment,6specifiedbKn`5"""l_[ ()M"()  @y_by9_!Ghosttry:  import winreg except IeError: )# Std modules, so should be around - but you never know!Ereturn 0:tryginternetSettings =.OpenKey(.HKEY_CURRENT_USER,Ur'Software\Microsoft\Windows\CurrentVersion\Ix y)')PproxyEnableQueryValueEx(&'Pd^')[0]pOverrid4str ;p # ^^^^ Red as Unicodeproblems if not converted to ASCIIz/OSv 1O!orb U FP# trymake a host list from name and IP address.rawHost, F= _split (G&C = [1 d = socket.get; by(>W!ifC != $D.append(aBq Epass Ifqdn- ## pcheck vthe regis en replace the# '' string by" L ?VcorrespondinF# canonical08 9 = .E7(';wb# now if we match one offor test ini ("if&&== "Jaif '.'e/inq+r% 1Y=j.}(".", r"\.")# fsk dot<*<%.*<change glob sequencG?GF8 # GIcharS0valR'1re.(,~, re.I). .!0 z2def0_by`K2"""` True,k8sed. 8 Checks proxy settings gathered from the environment, if specified, !or*registry. U """ jies = get _^%()+!ifEies:Sareturny_bypassBQhost,6iesOOelseI(F6) 6# By default us variables(! = """Response classesd by urllib. The ba"P, add,)ines a minimal file-like interface, including read() and line(). btypical robject is an addinfourl instance, which n #() method that s headerL0d a#?url+m@url. import temp __all__ = [' 0', closehook url'] iF(Y@._TekaryFileWrapper)YE"""B@ for?_L5add{0. Igood idea-garbage collection.;+# XXX Ad9o expose timeout onpunderlyrsocket?def __init__(self, fp]csuper(10, #%).2bfp, ''elete=Falset# Keep reference around as this was part oforiginal API.elf.fp = fpCreprK '<%s at %r wh%Aq%r>' % 1.____.__name__x!idI!),'.y)e^@.d>o raise ValueError("I/O opera7"n xptype, v], traceback?>(()s64@"""C0 to1 a * +nn,;:0, *Cargshc!z +& =_ [j! = @k6try &H" = k'"_& %&if fC INone@&^6 = % closehook(*sargs) finally:super(addc;, self).() class addinfo,Rbase)H2""" to"A an &) method n open file.""" def __init__(s, fp, headers_ Y:&fpF.A$ =KoAk^areturn; 0url>9 () and gP$l(s%, url, code=Nonp &').Hl6elf.url =Z f! =m.@property(ostatus> E>00get1i\url """ robotparser.pysCopyright (C) 2000 Bastian Kleineidam,,You can choose between two licenses when using this package1) GNU GPLv2!d2) PSF> for Python 2.2u2The(s.txt Exclusion Protocol is implemented as specified inhhttp://www.stxt.org/no@-rfc`( import collectionsqurllib.E request __all__ = ["RsQFilePwR"] R(ARate;d.namedtuple("&C", "]s seconds"` cjTeprovides a set offfaread, aanswer8` about?Iingl curl=''.entries,]rsitemapdefault_=@y =  =disallow = False" @set_V;url'last_checked = 0\mtime@"""Rpns the # wsP was [ fetched.Xis useful%long-runnhpweb spi that nee@88newMs periodicwN!odr?Set&thqcurrent>`b" =C&() def set_url(self, url): #"""Sets the URL referring to a robots.txt file.""";O`.url =T ahost, "Bpath#lib.parse6 (a[1:3] @def read BReadand feeds it]r6tryfprequestAopen~ )-`excepterror.HTTPE z as err_ if.code in (401, 403Y'disallow_alRETrue~%(elRp>= 400 2errfZ< 5009^[Jelse4raw = f.K\p(raw.de("utf-8").splitlines())_add_entryY!, `if "*"&.useragents#rdefaultF is considered last6"if55;Nonbcfirst 3hIwinsZ/[([=0+`5ies.append(y3d*!, Q.@"""PE Rinput#_ from1We  that a h-i:Cnot preceded byone or more blank2%s.!w# state`# 0: rttg1: saw^\#2##an4or 3 -{E = 0?^A = Ega.modified(1forT 0if ' Tr^ == 1#  " ?= 2cysL oT" # remove optional commentQstripG51i =.find('#'if i >= p=I[:i]V.yv kcontinp R}(':', 1@len(-)4[0]$0]k.lower2120urlp.unquotem%[1G @if line[0] == "user-agent": if state == 2#6self._add_entry()R/A = E-($Q.users.append(line[1]5- 1{Qelif < 0]"disallow O!= 0@rule\RuleLine, False)2Y?Tru4crawl-delays+ # before trying to convert int we needMmakeRp@# suHhat robots.txt has valid syntax otherwisJ it will crashr1].strip().isdigit()ei?d = int[S2request-rate+numbers =mplit('/'# check if all}ues are sanvif (len(t)c2 and /[0hg= @req_JB = RYPRate(!),/1]3sitemap# Accord8http://www.8s.org/protocol.html0 # "This directive is indeent of the a,M so it doesn't matter where you place" inr file."NT8#we do not changekparser.J#Amdef can_fetch(*,.W, urllQ"""us1he d`decide?pB\ \K&"",if self.disallow_all: return Falseif self.allo46Tru3'# Until the robots.txt file has been read or found notr# to exist, we must assume that no url is Wable.=This prevents f positives when a user erroneously@ calls can_fetch() before 1ing&()s if&last_checked]# search for givenagent matchesRCfirsf count!pparsed_=$Alib.A.url G(url`nquote%))g?"unAq('','', ke.path,>P Hrams/wquery, $fragment lz+ur5"/"*`entry in:ies0if y.applies_to(+),24"2ancP{ # wrdefaultc +%f#_R pl 'yf==> access granted^def crawl_delay(x,V !w.mtime(&6Non$Qc* K-`-request_rate.1req1. N4site_maps17T%$d6 |__str__kkYies =6T7}@not ~ N 1+ [ ]`'\n\n'.join(map(str,)ies)) class RuleLineu"""A rule linea single "AB:" (%nce==True) or "Disallow:" (ance==False) fo#ed by a path.""1def __init__(self, %, F$):Z1 if == '' and not*)# an empty value means.V-nu = True = urllib.parse.urlun (5%))D. I`quote( -  Q1applies_to3filename,wreturn |= "*" or ..startswithH)gS__strZ0("A"f else "Di") + ": " + class Entryp"""An e has onemore user-agentsEzerorulelinesVONA= []ZO delay = Non%6teq_rateTG `Afor # i!ret.append(f"U1: {@&}"O"ift!is2RaCrawl-21: { Xr[G. Request-J0: {".r2s}/xsecondsD0extmap(str,'\n'.join(ret ^F"""checkCthis< to the specifiedq# split'a tokenmake it lower casjK1ser.J("/")[0].7(X"ifa**'#qwe havecatch-all6 .hTP" =6 "!in2az, !PrZfitionsoD- ou -Y is URL decodeds'*2#! /usr/bin/env python3 # Copyright 1994LG Ellinghouse&athedral City$, California Republic, United States of America. # DAll Rights Reserved # Permission to use, copy, modify, and distribute this softwareits # documentatKfor any purpose()without fee is hereby granted, # provided that the abover notice appear in all1iesc9r # bothE ;n_Fis p V # supportingg@name}Lance Ellinghouse #0 beRdpdvertisS2or 0ity@tain&tojPion #\pD`specif written priW FLANCE ELLINGHOUSE DISCLAIMS ALL WARRANTIES WITH REGARD TO # THIS SOFTWARE, INCLUDING 9xIMPLIEDAOF MERCHANTABILITY AND # FITNESSC NO EVENT SHGCENTRUM BE LIABLEAOR ANY SPECIALIDIRECT OR CONSEQUENTIAL DAMAGES2 # WHATSOEVER RESULTFROM LOSS OF USE, DATA=PROFITS, WHETHER IN AN # ACTION0CONTRACT, NEGLIGEkAOR O0TORTIOUS1`, ARIStPOUT #@OURCONNET0THEaERFORM*OFp. # # M%ied by Jack Jansen, CWI, July 1995: # - Use binascii0ule!doactual line-by-p converTbetween BOPry. Tqresults 1000-fold speedup%1e CIUstill 5 times faster, ' ghQ- ArgWPs mor mpliant  python standard """Imple!ofrUUencodAUUde @funcBs. (in_file, out 0 [,e], *, backtick=False) N;& [=6, quiet])@ im\$os sys __all__ = ["Error", " t"] class #`(Excep0): pass def :R=None RR"""UuM )1"""j#C If C`a pathb open itchange defa5;&!edys]2try~ibf== '-' = sys.stdin.bufferK# elD0sin9&ce3str9'1if 0is # k!P= os.P.baseT)u- if{N   mode = os.stat(in_file).st_ &except AttributeError:'1Ipass]o4penly, 'rb')*aopeneds.append/)#3# Open out3 if it is a pathname, &if2j== '-'O@= sy dout.bufferE elmsinstance(5o, str)Q,/'w\Set defaults for Y and 6"if#zis None=!ifJX0d = 0o666 3m # Remove newline chars from3.replace('\n','\\n1!! =F(r(?r')Write the data~m .w*(('begin %o %s\n' % ((& 0o777),)).encode("ascii")j3 = .read(45 while len(*Z) > 0 1bindq.b2a_uu6, backtick= \ %ifC~ y'`\nend;elsI *' 6vfinallykPf in $f.close() def derY,=, quiet=FalseA"""D?2 uu d 1"""b0Qinput#,iwneeded.,Q = []'] m h(ing c/ b^  Z'trtad until a 0is 4 untered or we've exhaustedbO[H ;Tru2;hdr1((G_ot hd}araise ('No validK` foundcP _rtswith(b';)vcontinuhhdrfields =.split(b' ', 22)&30[0] p int(hdrfields[1], 8?) ]breakexcept ValueError:#LEpassif out_file is None6# If the #0nam'n't ASCII, what's up with that?!?_p`#= hdrfields[2].rstrip(b' \t\r\n\f').decode("ascii"s.path.exists([)varaise ('Cannot overwrite @1ingu: %s' % v`if modf= int(V1], 8A# a# OpenJaoutput{ j== '-' = sys.stdout.bufferEelif isinstance)[, str.fp = open&F'wb'Pos.chmod% %5 fp?Qpenedhvs.appenJD/QMain 6looQ' s W.readline(P wh`s and + p != b'ende:tryvdata = bin.a2b_uu(sp&&^ as vR # Workaround for broken uuenrs by /Fredrik LundhWqPnbyte (((s[0]-32) & 63) * 4 + 5) // 39"[:S]l0if I^quiet"Aerr.k("Warningfz\n" % vX0 !/ins Truncated in{gfinallAf in \`f.closi def test(U4"""1/uu0e mprogram""" import optparse r.OptionP"r(usage='0: %R [-d] [-t] [[_#]]Ta.add_oM('-d', '--', dest='qhelp='D (Eread of !)?3fault=False, ac='store_truet0tex } {,v!mat unix-compatible %f(s, args) = $_Dpif len(V) > 2+0r.eg('incorrect number,arguments rexit(1)Q# Use0 ryeams underlying stdin/stdout input = sys.q.buffer9out8outif len(args) > 0:5V1[0] .1.g/41] 0options.decode14if Ftext|f isinstance(\j, str)(,u = open,Q'wb')$7els`print(: argv[0], ': cannot do -t tos;outQ?9fexit(1m(",  L O, 'r6@from/in en  if __name__ == '__main__'btest() r"""UUID objects (universally unique identifiers) according to RFC 4122. This module provides immutable UeQclass) and the func uuid1(), 3 4 5() for generation 1, 3, 4,U 5 s as specHd inIf all you want is a1ID,should probably c2a1() or4(). Note thatmay compromisivacy since it createt containing : uter's network address. c74()CarandomU. Typical usage:>>> impor# make a9 based onqhost IDMcurrent timeM. # docZq: +SKIP)('a8098c1a-f86e-11da-bd1a-00112444be1e') usan MD5 hash of a RspaceFu 3( .NAMESPACE_DNS, 'python.orgj6fa459ea-ee8a-3ca4-894e-db77e160355} 16fd2706-8baf-433b-82eb-8c7fada847da o SHA-1#5886313e1-3b8a-5372-9b90-0c9aee199e5daWof hex digiw@brac nd hyphens ignored1x =.{00010203-0405-0607-0809-0a0b0c0d0e0f}tconvert?to  in standard form >>> str(x)'00010203-0405-0607-0809-0a0b0c0d0e0f' , # get the raw 16 bytes ofAUUID'b!x.+b'\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\xzpmake a e from a 16-e1ingk{Puuid.((#s=) """ import os Qsys Senum 'Enum __author__ = 'Ka-Ping Yee ' # TKecognized plat s - known behaviors if sys.# in ('win32', 'darwin'):_AIX = _LINU False else L4_system =.(B]I== _4r= 'AIX'R ) Linux' _MAC_DELIM = b':'OMITS_LEADING_ZEROES = 0if  A.WETrue RESERVED_NCS, RFC_4122, MICROSOFTFUTURE = ['reserveda NCS compatibilityspecified@RFC f/',?MicrosoftE g future definition'] intt0int" ^built-in Qtype * (* class Safe8csafe = 0#un#-1t= None HD"""Instanc? q0rep!nt_s as E.nW objects are immutable, hash `and us O0dic8ary keysIpConvertiCto a_P with () yields someth/!in'12345678- q9abc'. constructor acceptsJfive possibled0ms:`imilarof hexadecimal digits, La tupleL`of six beger f(q32-bit,T81andJ4 values reptively)^an argument named 'm'4str&ofI1allN8intin big-endian orderm q plfirst thre'olittles o3_lersingle 12.?as !Rint'.g`s have se read-only attributes:,| 15 as a 16-byte string (contain the six integer fields in big-endian byte order) >@s_leMZUUID as a 16-2 stwith time_low, Emid,KC2and"hi_versionolittle Ia tuple of Ksix  which are also availablePdividual attributeswo derived/:O$ first 32 bits sB8mid> Bnext 16A{=Aclock_seq_FiariantA8 @0low9@ 1nod7@olast 4A D7 Ba60-bitYstamp95 9!149sequence number0hex+0j a 32-character hexadecimal_CiiC1128~31urn/ v0URNspecifiedRFC 4122@vh5(onconstants RESERVED_NCSy@RFC_g,,MICROSOFT, orgFUTURE1 s (1 through 5, meaful onlyFAwhen4is }bis_saf}An enum indicat~qwhetherI(has been generatea way that is efor multiprocessbAapplnons, viaMTuuid_s_1RA(3).02"""__slots__ = ('int', ' __weakref__'def __init__(self,a=None,Fs 3_le w 2int! /3*, P=Safer.unknown):5r"""Create a $ from eiado 32}fdigits+d@ytesAV's' argument, .:in z M:_lePf six  integers (32-bit time_low, 16:midhi_version, 80clock_seq_$ariant, b4node) asIthe 'fields' argumeDor a single 12<A as 6Eint'H;p. When>tring of hex digits is given, curly braces*hyphens, and a URN prefix are all optional. For example,%se`expres4s6y$ same UUID: .('{12345678- - ;}')7 1urn:uuid:2p > bytes='\x12\x34\x56\x78'*4)0_le,"78(085' +_ g w uID=(0x", @ 12 34,)NBint=>&.)Exactly onex'hex', '  0_le p', or 'U must "be@. T#$B; if/ resultingOb will have v^ set accord;to RFC 4122"boverri h .2pis_safean enum exposedan attribute on@instance. I/indicates whether,has been generated i way that|,Pfor m@@procpng appla io@via B_S_KFE(3).J7"""f [hex, _; ,].count(None) != 4:Nraise TypeError('k] +H 0'ors iPpis not m=s.replace('q'') ?strip('{}7-3if len(hex2*327DValu8badly formedadecimal |'ngEPint =&_l$0"if!_l"_l/16v\aOcharb = (bytes_le[4- 1::-1] + bytes_le[6-1:4-1/ ,@8-1:0 CE8:]):"if\ is not None:_qif len(Vz) != 16!%raise ValueError('0Va 16-char string'>assert isinstancen,_), repr :int = int_.from_v)>order='bitif fields'0Wa 6-tuple(time_low, 3mid hi_version, clock_seq_#wariant,Msnode) = A!ifB0 <=tlow < 1<<32 1 out of range (need a 32-bit v) y2midyHy2y/16y9\3+8}4?n 8}5}+4u6u/ 4E = ( 5 << 8) |< ,U(3 964y< 80) |92 &oA< 64@T4 ifA/12U0/isT/12U3if 1]-O<= 5uillegaleknumberE# Set the v to RFC 4122.&= ~(0xc000h #e|= 0x8! n0ifH&64 %|=U<< 76jobject.__setattr__(self, 'int', int)# object.__setattr__(self, 'is_safe', !) 6def __getstate0!):Ud = {'int': KU.int}#if^ != SafeUUID.unknownKO#U is a- instance. Return just its value, so that{N%t can be un-pickled in older Python versions withoutw.N%d[&9] =..rdCsC!, QJ3nt'0[k%])k1rwas addq3.7; itFlso omitted when""L%',,_ (- 2&if}=V else #eqw, otherJTif is2( , t${2 ==K%NotImplemente# Q. What's the of being able to sort!s?V# A. Use4m as keys a B-Tree or similar mapping.K/lt><?>!l 7< ?>"Chash$ T$in6&4repC1'%s(%r)' % n__class__.__name__r) .,_haise TypeError(' s are immut'_Nhex = '%032x*>G'%s-+($hex[:8], C8:12 T12:16 C6:20 C20:]@propertyQTRbytes")B.to_( 16, 'big') @propert y def bytes_le(self):0 = . return ([4-1::-1] +LP[6-1:@8-1:IhIQ8:]) @propertlfieldstime_low,8midhi_version,h|Dclock_seq_+cariantAdOnode?lowpint >> 96E?midE.F80) & 0xffffP @ QW/64W\8\$56\ZKj/48S T3(.#'W0fff) << b|@90mid(W32) |?low-G(i3>8) k: Fdh?hexK'%032x' %?intD?urnDurn:uuid:' + str(Iv,%eif not & (0x8000'48(RESERVED_NCS/elL4L FC_4122H 2H MICROSOFTR&seoFUTURE; ;c# The P bits are only meaningful for RFC u UUIDs."ifz0 ==+3intD>> 7@@) _get_command_stdout(s, *argsimport io, os, shutil, subprocess6trypath_dirs = os.environ.get('PATH'L@.def)).split(os.Esep)I.extend(['/sbin', '/usr ]1executablef.whichT=m`.join(i)) if executable is None: areturn$# LC_ALL=C to ensure English output, stderr=DEVNULL)sprevent"N#on.! (Note: we don't have an example where the words)gsearchNfor are actually localized, but inAory some system could do so.)Nenv = dict(os.environ"[' '] = 'C';proc = sub ess.Popen((exr,) + args,6z xstdout=N?IPE88;venv=envpif not $! =7.communicate(Ydio.BytesIO(>"except (OSError,SS^)T% # For MAC (a.k.a. IEEE 802, or EUI-48) addresses,# second least significant # bit of&first octe% esAther"x[equniversP(0) #Ply (1ministered. Network cafrom hardwPmanufrers will # always be k&adVguarantee global-tqueness0MACO> any particular machine mayointerfac 0ich" #8ly F. AT`latter-ubridge UQ to #ZTouch Bar on MacBook Pros. # # This@sybBA42ndcounting [@1 be y( #01<<41. We'll prefer?w es?ver  ones sincRforme lyf1queA # wFpfound iat's all=#ha/See https://en.wikipedia.org/S/MAC_$#UQ_vs._ def _is_yC(macD & (1 << 41)) ;find_mac_near_key(7Band,- ps, get_"c_indexhA"""SSes a <'Aput  l$ aW!. `Each l#ofn:GHis case-insensitively  edgH1Tgivengs. Upon a matchqinvokedHto pick a", [ Z . EH, lambda i: 0 would get the first word online, while lambda i: i - 1@:precedingA0key.>1"""stdout = _get_command_(q, args)02if  is None:areturn _local_mac =,@for 3 inPH1s = .lower().rstrip().split(JiGrange(len(A&))R(!ifN@s[i]. s%)>tryW# =F._index(i)](1int.replace(_MAC_DELIM, b''), 16Aexcept (ValueError, Io 5 # Virtual interfaces, such as those provided by"# VPNs, do not have a colon-delimited MAC addressFas expected, but a 16-byte HWAddr separaNdashes. These sh'be ignoredfavor of aOreal/pa7elseif _is_universal(mac/?mac, 4or =L" def _parsey|A# AcVJ'HH:'" (ex: '52:54:00:9d:0e:67'),#reject IPv6 9fe80::5054:ff:fe9' or '123:2:3:4:5:6:7:8')#VHN?by  q@part8 0if *f) != 6|COMITS_LEADING_ZEROES1# (Only)B1AIX0mac vT` givenaprefixr 0, e.g# en0 1500 0k#2 fa.bc.de.f7.62.4 110854824 0 1601337330 #bg0h ifi all(1 <=f) 2 uNs/|hexstr =`.join(5.rjust(2?0')US if not all(len(part) == 2 for 1 inWs): ereturnhexstr = b''.joiL!s)!6try=9R int(5B, 16(except ValueError6 def _find_mac_under_heading(command, args, """Looksa MAC address F$ a1#a M's output. The first line of words43the, is searchedpBgive11. W;0at AsameM index as-asubsequentPs are(n examined to see ify look like1es.D1"""stdout = _get__ X2if LNone 32key$=4P.read().rstrip().split(^ 1rcolumn_$= N.(8A`_localK" =t B 7! =(s[]#I continueT0macPparse(e 0if "!isM if _is_universal(mac95mac"if GolFGV "Q # kollowing functions call external programsp'get' a vJ to # be usedVCbasibn uuidUifconfigSnode(R"""GePhardwq^:on Unix by runnG.[ isks on Linux ('' or '-a'), Tru64 ('-avbut not ` = (b'hw', b'ether Aess: ll'A('',|#v'4=cSnear_y$(''es, lambda i: i+1sP #6/ip-p with iproute2 p7link', [b' /|] /ar-&arimport os, socke8 ip_add r = socket.gethostbyname()) except OSError:return None $# Try getting the MAC addr from arp based on our IPess (Solaris).K,mac = _find_mac_near_keyword('arp', '-an', [os.fsencode(ip_p)], lambda i: -1mif mac5machis worksOpenBSD?/i+$Linux, FreeBSD and Net-'(%s)' % >R2i+2S6# R instead of 0sZ Cdef _lanscan_getn)a"""GetThardware;on Unix by runn|FA."""0# TQmightRHP-UXpOtityb'lan0'gA0) netstat,F 1AIX Tru64 UNIunder_heading('fiPb'Address'ipconfig[DEPRECATED]  wWindowsbpo-40501: UuidCreateSequential() is nowonly supported approachfwindllFbiosRP # Im" optional C extension at toplevel, to help disablit when tesB tryiTQ_uuid?_generate_time_safe =Qattr((>, "%!",_= 51has`.$ ':! = |^eload_system_func&s( kPlatform-specific 3 I#t iOunix{ Unix using th)e _uuid extension module.""" if _generate_time_safe: >_, _ =,%()-return UUID(bytes=?).node def _windll_get"()o"""Get the hardware address on Windows using&UuidCreat" 2_le8 orandom"a  5 IDx"# RFC 4122, $4.1.6 says "For systems with no IEEE $, TQly or|# pseudo-m4ly d value may be used; see Sect4.5. TheImulticast bit mu e set in such0es,order thacy willKnever conflictes obtained from network cards.#HYThe "" of a MACq is defQ to"HSleastGsignifican!ofEfirst octet" 0is bs out LK 41 iNPcount@1 be )t n, or 1<<40. See https://en.wikipedia.org/S/MAC_61#UnU_vs._Jcimportm@.get #bits(48) | (1 << 40) # _OS_GETTERS, when known, `targetor a specI0 OSplatform. #H is by 'common practice'%D8ed ?Note: 'posix' and '+Hows'prefixedga dll/dlload() method # whichsuccessful, means noneIpthese "#Srnal"@sg`called ka(also)OAtest0.py3SkipUnless(), e.g., #N` @unit/&.s$;0_if,$igK_P...) RLINUX8t = [_ipB-, U`] elifb.z == 'darwin'R X, _arftnetstatxeSwin32d# bpo-40201:F@ alw`ed, so!senot needed ?_AI$s# K BU _l, _lanscan/if os.nameEunix6( +os.name == 'nt': _GETTERS = [_windll_getnode] + _OS"l else:5! _7 = None def K"()9+"""Get the hardware address as a 48-bit positive integer. x8The first time this runs, it may launch a separate program, which couldLbe quite slow. If all attempts to obtainfail, weLchoose a randomnumber with its eighth s0o 1recommendedNin RFC 4122.1"""qglobal f"if q is notxibreturn"@0forfter inB+ [_F6try W# =I!()jexcept-rcontinu'%Bif (B) and (0 <= < (1 << 48);= assert False, '2() 2 ed invalid value: {}'.format) _last_^Ystamp`uuid1(=, clock_seq!ne}a UUID from a host ID, sequence !,bcurren@If 'r'`given,} ()Ousedb'TP%itI!as ;Jxotherwi!14 /Npchosen.=R# WheO`system@videversion-13!geCpor, use(but don'tMpUuidCrehere becan{s2@ con%[)aCmeP_safeQm= B , C4ly_XEd = #e; e!is#p = Safe(U y VVError!L.unknownJ##{w(bytes=@=)L 1RRimpornanoseconds =.b3_ns# 0x01b21dd213814000a$ of 100-nsrvals betweRh# epoch 1582-10-15 00:TDUnix'970-01-01' /// +Q  M[ -&,= 1+ 1m ^ &ifNone:  import random clock_seq =@.get%bits(14) # instead of stable storageGtime_low = stamp & 0xf&vmid = ('e>> 32).*hi_version1"481A0fff1X %[`ariant[-3>> Z3Xif node is None:H8P= get !()return UUID(fields=,C_mid ,=V _.&, Alow,3), , =1) def uuid3(namespace, )"""Generate a from the MD5 hasha5@&Band A."""914libb1md5PdigesdAmd5(T.bytes + , "utf-8")usedforsecurity=Falsx").bS=V[:16]"3"/4(!om^Bos.u*7(164a5_SHA-1.Asha1t0 = | XS V5) # The following+QndardI@s arr use withA) or 5(). NAMESPACE_DNS =<('6ba7b810-9dad-11d1-80b4-00c04fd430c8')=4> """Python part|warnings subsystem sys __all__ = ["11", _explicit@showFing"Z "format "filters=Rimple >Drese=,ecatch_>] (message, category, file, lineno=s Hook to wrioaM; replace if you like<rmsg = W]M_@msg_&C(msg Y_ PFunct2to R5 a had>wayningMessage(message, category, filename, lineno, Non!) return _formatwarnmsg_impl(msg) def _show:Acp = msg. !ifz1 isp)n" = sys.stderr/3#2U when run with pythonw.exeo<ings get lostu ktext = *6try[p.write(7Mexcept OSError-R# the(probably )invalid - this s.Cpassv0.__!__Qs = f"{!}:/D}: {; )fQ}\n" F!if2a 4aimportQcacheCD=@.get^,o"now;{E6ion0# W.a[iYgged during P@ shutdown1Q# and machinery don't work anymor h! =-7els "!if' <v.strip(s += " %s\n" %: `source1notYtracemalloch@LoggPkpshould Yraise a new  #5ch ,6aonly I8XRecursion!WCsuggest to enable if it's}Pavail"H.Z= Tru(tb- ? E@.is_7ing/yh0?get_objectGQeback9>' "3  .O9%>;Y_if tb2!'O ated at (most recent call last):\n']Bfor frame in tbI!c(' File "%s"6!noi N11% (WBno))-  if linecache is not None: pline = cache.get (frame.filename, ?no)O?elsi >except E?ion|! = B!if9 @.strip(`s += ')q%s\n' %TlAelifRztracingm=(f'{category}: Enable 0 emalloc to get the object 'az!f'.Ration?rback\n' return s # Keep a referencebcheck ifgAfuncHwas replaced _showwarning_orig = e def %msg(msg)p"""Hookjwrite a J a 5;kyou like."""2tryK+sw|NameError/ApassE pcif sw ?]#'s.9() #*@call3(sw !raise Typ#(" fmust be s Bo a C"or method") 3 sw.message, msg.9no,D! 7)3%tg|6fmsg_impl))cformat7  F2to 'he standard wayf<!f Q + / f  c_ *cfilter-1s(ar#, T="", "=Wv, moduleoMno=0append=Falsew"""Insert an entry intoulist ofrters (ayrfront).?'' -- one9 "er", "ignore `always pdefault "or "once'dcgex th5, Qmatch'8>_class>T a subclass of 'module' -- a regex that the  name must match8blineno8n integer  number, 00es all warnings?aappend?if true, 1 to}list of filter71"""?assert actio} ("error", "ignore `always pdefault !",H p"once")Hcnvalide: %r" % (t!,)@isinstance(message, strF?@be a9ing@category, typeBC[classB1sub(02, WrE 9 P!?str0no,!Q) and"no >= 0, \F",[t*!" )4if P#or:Cimport re-#>= re.compilBre.IOelse6ANonep & [T1 = STR_add_f&, ,I6==) def simpleLC=C%=0EbFalse)R"""IngP` entry # (@rfront).AF s!!s.'p)0one/2or ce!a G2 D? /;v FT*item# Remove possible dupli!, so new will be placedN# in correctC. IfQ=TrueXexists, do nothing if9 6try O1s.r(q except ValueError:  Ppass filters.insert(0, item) Qelse: *!if not in 9 $.append(K__mutated() def resetwarnings()N"""Clear the list of %x, so that no are active."""x[:] = []class _OptionError(Exce used by o" processing helpRoA # H4 to-3 -W? s %ed via sys.Zs'_`S(argspfor argB6try B_setA@e z as msg@print("Invalid ignored:",5, e=stderr) ) {pparts =.split(':'qif len("R) > 52Yraise("too many fields (max 5): %r" % ",)ZXwhile]<]q'uon, message, category, module, linenos.strip(n?s|r = _get (a"( &$if3 orRimport re@," = re.escape(a 4 3) + r'\Z'o=: !0 =  w[/6< 0I3QValuey(, Overflow*,I H#"i2r,)) from Non^ v&A = 01x n =%!ifieturn "defaultl!if~on == "all": r)always" # Aliaa#('HB', '* X E @oncee'}}0.st1DwithaL ! GYbKWaif '.'{%inN3builtins9Pk=7ry else:# module, _, klass = category.rpartition('.')4Etry: Hm = __import__(TbNone, [^]Eexcept I5ZErrorTraise _Op ("invalid a name: %r" % uq)) fromv cat = getattr(mAttributetunknown warning:K,if not issubcyr(cat, WJ)x x`return def _is_internal_frame(y"""Signal whether the "t is an = CPython implementa detail."""@file" =F.f_code.co_('Llib' in # and '_bootstrapnext_ex AFind, that doesn't involve+s4AbackGwhil+v Kd&X  # Code typically replaced by _s (message,=, stacklevel=1, source tIssue a, or maybe ignore it!2an I5ion-# Check if Flready aq objectGif isinstance c$ =\1.__R!__J})@argu%if|3c= User}8(.,!e) yc=2Typw$("Mp must b 2", \@ "'{:s}'".format(typef@).__2__)# Get contex51ion F'if7P <= 1sys._get7(1)C# If~is too small to careU!ifaoriginated iH#Y,7An dof0tryUhide anyt!s.=: = &*Felse$<13%# Look for on"less since above linebrts us off@or xfrange(+-1bx_next_external_frame(;) 1if  is None:"1raise ValueError%gexcept<globals = sys.__dict__6Ofilename = "sys"lineno = 17elsU3.f_, X#code.co_s,k* `if '__s__' in iPmodul[0]C m/"registry =c.setdefault("__warning(r__", {}_explicit(message, category, ", ", $, P,;, source) def m[=hC)r = int(  #ifm% =# or ") # Quick test for common casehn7keyareturn)# Search the\V@itemM0filaction, msg@, ln1temBif ((msg"msg.matche)) and15AssubW(rf*I(mod[#od[](0= 0S7ln) Qbreak 3 = )# Early exit s#ifkw"ignore+q# Prime0cac ormatting,&6";" actually%Pa zipsomething.4aimporties6 s(?4ule!) 2 el0s# Other  action == "once": registry[key] = 1)key = (text, category)#0if &DP.get(Fkey)cjereturn9%6[ ~elif action == "alwaysApassL *_modul?alt9, 05 1[-U wdefault; &seN# Unrecognized's are errortaise RuntimeE(5"K (%r) in warnings.filters:\n %s" %E(r, item)<# Print message and conH>rmsg = WbM%(-i , filename, lineno, sourcefP_showmsg(msg) classZobject): }_WARNING_DETAILS"}D", "   !",MI "*("")xdef __init__(self,  n_=Nonerj h.$ =q% = !% = !Cno = >: 64 8# = __!._U__ if` else >3str+D ("{0F: %r z noEs, ""ar}" % !,  P 9H )`catch_0Zings(D"""A manager that copiesrestores the rter upoqexiting%.}PThe 'rd' argument specifdvwhether[should be captured by afcustom impleHa0%of>.Qing()be appended to a listN` 0. OwRMO is 3OB . js{d} s whose attribute miP*9to cc is to specify an alternative module to th named 'warnings' and imported under that). This argument is only usefulPwhen testinglZitself. .2""" def __init__(!, *, record=False,Aq=None):?"""Specify whetho: }fKshould be2d oMhan sys.mC&s[,] For compatibility with Python 3.0, please consiW5allKs%bekeyword-_f0n&"._## =A/ =3 ifWZI els!kentered = Creprargs = []2if f/.append("!~=True")@ois not_@c=%r" %lq = type@).__%__return "%s(%s)K(", ", ".join(()),G- *edraise RuntimeError("Can0 %r twicec!._&S fi+ . - \_-&[: M!_mutated(CshowUl msg_impl:_!@pj o:log Yc = logf8# Reset 2Ping()pdefaults leUPationmake surM() calls d< 5ing_orig&lo4 A%R xexc_info3"ifS Z 0xit zAout @_firstd  =Ue]"   # Private utility fun*ction called by _PyErr_WarnUnawaitedCoroutine def _warn_u$_c( ): msg_lines = [ f"#K0 '{ .__qualname__}' was never |1\n"?]1if 6cr_origin is not Nonezhpimport cache, tracebackG$ ex#t(for file,Fno, funcP in r1sed. HL! =E@.get(a)7myield )9u.append(" created at (most recent last)\n"K6 +==.format_list(B)<msg = "".join().rstrip("f # Passing source= here means that if the user hs to haveamalloc8`# enab1andk[wTF7yc,a-3illMrcontain$<. This doesye*both*F8 JQ*and*ey'll get twoKpartially-redundant?s. If we wanto be clTcouldIrobably detect tPcase 9avoid it, but 0nowC`don't 1er.K6, category=Runtime<ing, stackDl=2,P) #cSters ms a sequence of 5-tuples # The components$! are: # - an a": error, ignore, always, default, module, or once?diLRregexmust match4emessag9lass representU+ )gPis beGO#edELq numberp,@or 0>`A any #9deitheroasW^,anything. trysBfromSings ~3, _p0, _lregistry,N , p_explic@_filY@_mutz d+ =uew"!True except IYEV "rb = {} x@vers2= 1 uglobal #AVP 1 _warni*ngs_defaults = False # Module initialization _processops(sys.warn) if not _i]: # Several ! categories are ignored by  in regular buildsJiphasattr, 'gettotalrefcount')w{cfilterw3s("_$",y=DeprecWarning,l? m="__main__", append=1)4bsimpley"("p F PendingM dImportA ResourceCO del """Stuff to parse WAVE files. Usage. Reaf = wave.open(8, 'r') whereI is either the name of a`or an >pointer. The must have methods read(), seekand close(). Whenvsetpos() rewind()D<Sused,0N e0 neary. Thi}Pturnssinstancclass withOfollowing publiczGgetnchannelb -- re[anumber2Tudio 'u (1 for & mono, 2%t stereogetsampwidth() n1le Bbyte getframerate7frequency5 k '8qcomptypkression ('NONE'rlinear s6{N`human-Eable verY#of W K Oed' Sparam adtuple consistP) ll?the@abov2m Dordegetmarkerz_None (foratibilitytBifc hhA(id)8h0aisan error si$ *P doesg_exist . aP (nPat most n !\aZ0$Pbegin:>s streamEo0pos~E to the specified position atell() -- return the current5Wclose61-- 4instance (make it unusable) TheLhced by 1andD given to setpos() are compatible 2have nothing,qdo withJfactualuia file. () method is called automati@y whTlass  is destroyed. WritPWAVE e#s:if = wave.open(, 'w') where,}aeithername of a`or an >rpointer a must s write(),m`, seekCand s. Thissrc_`followcpublicGsetnchannels(n) --PumberV!*setsampwidth41le .framerate. ,n !2mPtype( , )26ression 9?the: human-read,A9arams(tupS Pall p/eters at onct6  in output{P.raw(data.r audio 5out patc up_ 6s header%VO =} z a"--20 JYou should`beforeNb firstwraw or 0. `utotal n^/P does%P need& besR, but it0setorrect value,}MaRto beed up. IK1besLY , perhapsPsiblyd ;,Yt E us~`raw. W.n AbeenCSten, je+P(b'')Z ()  $@size,1pL\J$ """ from chunk import C Pollecsd 0audioop impor t builtins import structys __all__ = ["open", "Error Wave_read write"] class *@(Exception): pass WAVE_FORMAT_PCM = 0x0001 _array_fmts = None, 'b', 'h', `i' _wPparam*namedtuple('!',w{ 'nchannels sampwidth framerate n s comptype d$') """Variables used in this !: uThese v)are avail8p to the>r though appropriateAmethods of]_file --D Twith 7(), close and seek()_Hqset thr__init__()M0_Gy`numberdaudio g/[e5getQ ige/ c  ebytes per +l.b qpq)ling frequencyK cbaAIFF-Cression ('NONE' if # `w/`human-~cusoundposu@posi{e_treamkEtell+,  Cesetpos/ternally onlyDa_chunkZ@1 ifae FMT  has been P`_data_v_needed;ed correctly=01forYRsa-- instantia_Cof a C4BDATAi_S!izsbof oney602"""F@def ~fp(self,Q._convert7B;= 0p@ = Cx( , bigendian 2if k&.ame() != b'RIFF'wSraise '4 does nopAart 9O id'h#(4f:f \ a &%Uself._fmt_chunk_read = 0 self._data_chunk = None while 1:85seek_needeX1':try8<fCn(Jfile, bigendian)Jexcept EOFErrorVYbreak3hqname = @.get(["if == b'fmt 'cAB_fmt.(Z Q,'w .el||if not Waraise - ('U before '4@ ^dtnframes&.Wtsize //"&izV?Cl I'W.skip*7 orFu B :( and/or 6Kmissing') def __init__F, f)[i_opened_the_ oif isinstance(f, strF f = builtins.O';'rbqfK # else, assume it is an V object aly9 nFfp(fTu#if  (,wf.closev3delu,?^enter/areturn['ex_*argsc #i# User visible methods.Qgetfp+S."lrewind1 Cm#psoundpo0U!"~ =&-._!if? V 5 c@gV1Ltell 0channels; n& <: $ 8sampwidth: & <OOrate< & <vcomptyp; return self._comptype def getPname($!):Xretur:% :oparams8g_wave_#.getnchannels(),getsampwidth(),~AframerateAnT? >9())omarker:NonG/ H, idGaise Error('no ('s'kRsetpogW, pos< ifq < 0 or >6_,rkposition not in range')"R_soundpos =_ data_seek_needed = 1#CreadyL#, ,._J $`chunk.tV(0, 0.*5ize3B oEs=posu* 0i$ifZ == 0nG5b''0w# = _R(F  #if<: != 1 and sys.byteorderZ'big's = audioop/Pswap(_[wqconvertp4^8+[J R+ len4A // W4._n=o#w# Internal methods.% _B_fmtu!, )6try JwFormatTag;, dwAvgBytesPerSec, wBlockAlign truct.unpack_from(' :unknown f>: %r' % (, _^bad # of channecls') self._framesize = nchannels *sampwidth<pcomptyp;o'NONE' 1nam @not 0 ressed' class Wave_write:= """Variables used in this 0!: &uThese v)0are-`r sett< through appropriate methodsB)ofV_file -- the open Dwith; (), close @tellVseek(]Q V__init__()R_H}eAIFF-C/Aion (f#n 4setZA() ooparamshuman-readLl9set~pnumber of audio qK rbytes per|+/lez(#z nr8ling frequencylEl n(sVaten tooheader]Bternally only_datalengthes_iAactu)C2"""Edef [B, f)0 i_jbed_theV= Nonrif isinstance(f, strFJf = builtins.O'7'wb'/._qf$#tr 5Ffp(fqfexcept+#if/ c (,#f.AzVraise=w,.1Iconvert N'K = 09:8v6V; ;=8FalB__del__(self):  self.close() def __enter__( !):preturn  .3xit-w, *args4- c#P# User visible methods.setnchannels%, e!if._datawrittenaise Error('cannot Yge parameters after starting to M1e')H&ifO < 1fbad # ofhG_& =VZg Hhnumber At.setsampwidth QF or ?> 4,1le & =U g  ^Elf._H$ ,@setfCrate Q_ <= 0-  = int(round()g >$ * n Tglj= $6ten?setcomptyp} , GnameTZin ('NONE',r unsupportedression H a=,$.y" " <g< |E\]:O :name def setparams(self, C): nchannels, sampwidth, framerate, n s, comptype cname =PN0if h._datawrittenlsraise Error('cannot "geL eters after starting to M5e')jg@setn=( %( %( %(!&( /!) hdef ge0if _7 or q\8allk7setWreturn _wave_-:.,, hVelf._ U&qsetmark, id, pos, & R3)0upported'VgV~ K0no ~s<"erP;9FNoneAtell)G6ten9e01rawC , TI+isinstance(!, (bytes, garray)5' = memoryview9).cast('Bensure_header_rten(len85 = A // %._0# *BCAvconvert"rAo!= 1 and sys.order == 'big'cqaudioop/Pswap(5[Pfile.! DWten +%FG*=.+6t 3`A\?length !> Xb_patch&(pQclose:tryxyD b0+N:m $v.flush(kfinall01 = &NH gi_opened_the_ 30if #=ned_the_file = None file.close() # Internal methods.%def _ensure_header_written(self, datasize):7vpif not .54$ (nchannels$(raise Error('# )epecified')4 sampwidth\ (1le +^framerate^@ing ,_ :4u(g !4, initlengthbassertr;elf7B!._(Zw(b'RIFFY Un D' =A // 3%._# *%yvJ# =,]<N:try^Rform__E_poscVtell(except (AttributeA, OS o` %qstruct.pack('C?ten = TrueRpatch$,VGd8 ereturnE?cur   Aseek+._z6, 02+e(;', '=tenA vvEqb?ZBR Dopen(f, mode=!if1 isif hasattr7'8'4 = f.mode else: mode = 'rb'1if in ('r',)4return Wave_read(f)8)el:w:?wb':Vwrite;raise Error("must be 0, '`&or 'wb'") """Weak reference support for Python. This$ule is an implementation of PEP 205: https://www.pCorg/dev/peps`-0205/ # Naming convenP : Variables named "wr" are wobjects; # they#called tpinstead"ref" to avoidX collisions withFp-globalp() funcorted from _iref. '! (C get)lcount,s3ref Sproxy @Call PCType R$_remove_dead)4setSet, _IterGuard im_3e s_abc # IUafterjcirculard.K4sys itertools Us = (-, ) __all__ = [1, "9K", "t #s"DQKeyDi0ary/ P > -sYXValuec4Set-`Methodfinalize"] .Set.register(fNSet)'0MutC.p class >wC(ref1"""A custom `.ref` sub=which simulates a!toHa bound m`, work!arthe lifetime problem5!s.J q__slots "__@, "_fP_typeIR_aliv  A__" Ddef __new__(cls, , Lback=None6tryQobj =5.__self__X!!except Attribute ``("argup should [bnot {}.format($(.2)))gcb(argQ`# The -` trick)@needtQcreatVrcMRcycle\! =cB_wr(7!if. 4 = = Falser$%ifot None:  callback(self)  = ref.__new__(cls, obj, _cb*._func_ref4((meth_type = ( M@aliv!ITrue3_wra7preturn  1`def __"__:obj = super().&N"6elf( if is None or 2im) ._4Hobj)#eq, other)`if isinstance(, WeakMethod*aif not$"._b!or:^4-!+ C andu&$=^QnNotImplemented/ne{T 3!"__hash__. class ValueDictionary(_colles_abc.MutableMapping63""" K@thaterences vWs weakly.Entries in the dup will bscarded when no strong2ref^1 toAd exists anymor1"""2# We inherit2constructor without worrying abSinputB; since it uses our .update() od, we genDrighGchecks (ifOis a,Pobjecre unwrapped oJway out,Mwe always &#F)3in)Jinit4=(), /, **kw/remove(wr,rref=refC, _atomirmoval=_/`_dead_ 7refQUMIF!iffXH&%._iterating$Mj._pending@als.Ind(wr.key6OelseP1# A !alecessary+Athis^TP# caned asynchronously by//GC= p|.data, ; U# A list of keys to be removed self._pending_als = []$iterating = set() data = {}update(other, **kw) "def _commitw(, _atomic= e_dead_weakref):F1popE.pop)d'+# We shouldn't encounter any KeyError, because this method6J`alwayshcalled *before* mut=the dict.7while True:trykey = popexcept Index;ereturnw6 jx(d, key_getitem__ \0if B#h$ BoW[key]if o is Non"Uraise(" % *__class__.__name__, id)Bs w, valuekH4GE =aedRef(q,f/BcopyR4new = WeakVDictionaryrwith _IEconGuarO0forr, wr in.'s(U.M'wrk9 i"4newOoR2newA __?P__ = P_deepag, memoAfrom5 import 1m:$s__()  with _IterationGuard(self): for key, wr in ".data.items(.9o = wr()Gif o is not Nonei"new[deepcopy(zmemo)] = oSreturn new qdef get,default=j"if_pending_removalsu_commit#:try1Bwr =ZQ[key]except KeyError94+ls!XT Xy # This should only happeng&e1o9o?vvyield k, vAkeys!if__iter__ =qsvalueref B"""R0an *ator that N s the weak references toV"s.k8The'1are^guaranteed:be 'live' atGEtimePthey 9rused, sjresult of calling9VneedsEo be checked before be8W". 0can(UavoidDPcreat2fwill causegarbage collec>Akeep&+ around longeg5GededE5"""4V from<."()R\o ?obj\ 6obj 0popg`" self._commit_removals() while True: key, wr = self.data.popitem>*ko = wrif o is not Non]7qreturn h!o |def pop(r,f*args)"if_pending#]Bo._comm:try15W(key)except KeyError> +0if 35[0]J?elsAEaise62_jsetdefaultq=x1 _[key]-C $($ ==cedRef(,](e*BF/ocupdatekQotherd, /, **kwq4d!ifhasattr(0, "'s"!r = dict. 92forQo in ..M(Mdo ]K^Z*valuerefsB"""Ra list of weak references to the D"s.-8The'1aremguaranteed:be 'live' atGAtimeCPthey 9rused, sjQresulqcalling9VneedsEo be checked before be8W. This can(UavoidDPcreat2fthat will causegarbage collector toEAkeep&+ around longer than 'edE5"""@-4r2())q__ior__%, b"NMif isinstanceZ3, _Fions_abc.Mapping%c = self.copy(7) c.update(otherreturn c1NotImplemented def __ror__(self, Q:qif isinstanco , _collections_abc.Mapping)8<@c = V.__class__( B 7 v KeyedRef(ref:"""Specialized reference that includes a key corresponding to the value. (This is used in PWeakV$!Di(0ary;avoid havKacreateFQa fun, object for eachFstor_mq. A sharedDcallbackB0can'key' attribute of a "eaFpof gettafrom an enclos)Sscope2"""___slots__ = "key",wnew__(type, ob, ,G =?.__5"/.=HF5Finit uper().__33) m6Key(-jutable4C"""  ss weaklyhtEntriessdjwill be discarded whe re!nolonger a strongc!. J beM2d t>associate addi al data withowned by] parts ofan applicaA:1outR&ngs=SthosesD"es ly1fulN0overrideZBaccesses.: , e[=None.A= {}Cr>remove(k, qref=refk)A._0#!if@ t k%p._itera$(jA._pe_`als.ap*(kz1OelseK?try71del5[k]`except_ErrorNEpassBef# A listAdead6refs (keyK2be >dU5ingF = [$at dirty_len = Fals!ifBAdict) d ef _commit_removals(self): 4# NOTE: We don't need to call this method before mutating the dict,Lbecause a dead weakref never compares equaldda live',Ipeven ifey happenPrefer<Eobjects.;0Howo , it means keys may alreadQve been &ed@`pop = %._pending<E.popid'Edatawhile Truecj:trykey = pop()Aexcept IndexError;yreturn 7ddel d[key],c?KeyaBpass_dFUscrub  E E = [k for k injdOdirty_len = False_delitem__,A*#[ref(key)]`?get`D3len"if7_3and  #&still contains which weret# explicitly, we havepm (see issue #21173)@LF_13(1len.,E) -  y)NreprBU"<%s at %#x>" % lf.__class__.__name__, id~)\sw, value%,MB)] =4Bcopyonew = WeakKeyDictionary with _IteraCGuarFpM#eyV.'s(10o =oif o is not Non"Vnew[o2new __P__ = SP_deepg, memoAfrom5 import 1C@(h P;1getM, default=): ret+urn self.data.get(ref(key),default) def __contains__(6 , *:!%6try Twr = R'except TypeError40retUFalse3Gwr iQitems)Nwith _IterationGuard$for wr, valuea.XT0key = wr() if is not None Pyield+z?key, ?obj2obj__iter__ =s5U,! !ifmkeyrefB"""Ra list of weakerences to the.Q8The%1areguaranteed8be 'live' atE6timPthey 9rused, shQresulqcalling94refUneedsto be checked before be8W. This can(UavoidDPcreat2fthat will causegarbage collector toEAkeep& around longer than 'edC5""">r0pop._dirty_len = TrubQwhile -4key}=)e o Oif o oj;<1poph, *argsWONm3sett={ \>c,0_removePcupdatenAdictf, /, **kw'd 0if :a!ifohasattr(-0, "#'s" = type({})0 .!in/d[2] =rMlen(1!U__iorWother;other) r eturn self def __or__(, other):!if isinstance( , _collections_abc.Mapping8<1c =ku.copy()Tc.updatS rc1NotImplementedrM__class__cZ# v finalize@"""CD fora of weakrefable objects)D(obj, func, *args, **kw ") is a callE8rS which will be,ped whent is garbage )qed. TheCfirst time the er7ved it evaluates(I5andJresult. After thisadead, andBo0ingpEjustNRNone.7W^ program exits any remain@$st at3 attributeEtrue?run in reverse order1cre. BySault R2rue2"""3# F.r don't havePstatebtheir own. By ar!#  used as keys to lookup _Info]!ingregistryK!is# ensure at'y cannot7@parta ref-cyclu__slots__ = q_`Q = {}^_shutdown = Fals_index_i = tools.countMZdirty7`ered_with_e[r "@", "d[e \ "")Finit/0if Vj.+ -p# We ma1eqO0moran once becaufC#thread race, bu atrharmles1TimporY. ._@M Dub = Tru\i . ='PvB.! =%0 =  3 = 0or a %.$s = next 0ry[] = info f'inalize._dirty = True def __call__(self, _=None): $*"""If alive then mark as dead and return func(*args, **kw %);Hotherwise0h5"""!pinfo = ._registry.pop0).!f 13not7shutdownr0. ( or {})) adetach!Q(obj,", qi/2getVobj =weakref(:)0is 8Vx QgW,{.TSBpeekW gd_ZU@yn   @propertyx,0WheP# fBr isSD3 in$[sCtexi[>"""tshould be D`ed at =Abool)>!.a v.setter(#)h, valuEiT=1 = `c__reprC%;x ='<%s objectA%#x;>' % (type").__name__, id Oelse^cfor %rmg\:y !, ;obj@classmethod_vselect_for_uG(cls}2# R(s0ed 7, oldest first^L = [(f,i)* gin clsitems() :%]C.sort(key=lambda /:[1].indexw*[fp"L]h^ At shutdown invoke finalizers for which atexit is true. `# This%called once all other non-daemonic threads have beenGfjoinedYreenable_gc = False.Etry: if cls._regis"mport gc8rf gc.iso:d()[# 6Tru`gc.dis-()kpending = Non@`while [4if B!isC5 ork._dirt<=,select_for_5b $dif not,]break!4f =?O.pop?@# gcd, so (assum4no C) the follow=he only line i90# tfunctionKmight trigger creaof a newr-f/except E?ionBsys..chook(*~_info()rassert "in`Gl# prevent any morrom execut|0durzshutdowx^Tize._! =L7if 2gc.() #! /usr/bin/env python3 """ An implement1 of*standard library webbrowser module to openpages. Si6@we'r<%`y runna(B, it's really s1...Q defY(url: str,6 : int = 0, autoraise: bool!A) ->Nft js2qwindow F .d, "_blank") ~@_new \ereturn<, 1:O_tab> 2)wsgiref -- a WSGI (PEP 3333) Refere^L` CurrqContents: * utilBMiscellaneous useful fs and wrappers7@head)-- Manage response &Candl'pbase cl3`server/gatewaywVe_)a BaseHTTPSD that sups ~validate: rapper that sits| between an app and a server to detect errors in either To-Do: * cgi_gateway -- Run WSGI apps under CGI (pending a deployment standard)Jwrapper J)CGI@WSGI*Brout%-a simple middleware component that handles URL traversal """Base classes for/]`ations6 from .util import FileW , guess_scheme, is_hop_by;PheadeP>H# Nsys, os, time __all__ = [ 'Har', 'S 7CGID8IIS 'read_environ' ] # Weekdaymonth nam'HTTP date/: matting; always English! _wH="Mon", "Tue0Wed0Thu0Fri1Sataun"] _}?None, # Dummy so we can use 1-based 1 numbers91"Ja0Febc0Mar!Ap0May]Jun",8 ul0Aug0Sep!Oc0NovDec"] def_#_#(qstamp):ZRyear,, day, hh, mm, ss, wd, y, z =0.gm@ED return "%s, %02d %3s %4d : GMT" % (5C[wd]j[C2], C) _is_request = {'SCRIPT_NAMEPATH_INFO QUERY_STRINGREQUEST_METHODAUTH_TYPE'|'CONTENT `LENGTH3S REMOTE_USERIDENT', }.__contains___needs_transcode(kU(k) or k.startswith('{/_'0SSL\mJor (<REDIRECT(ub[9:]))("""Read P, fixb variableenc = sys.getfilesystemencoding() es&`'surroqescape'2tryO1''.;e('utf-8', escExcept LookupE<8acreplacYH!} k# Take the basic native-uniC os.F. Attempt toLafix upNBcomePk9!toI`ensateM)tbytes->}"deD@ stegat will aly have taken .Kn@k, vWTitemsj>if "):)!# On win32,QB is -ly Unicode. Different servers # decode the request bytes using diffe?encodings.B if sys.platform == 'win32':(u*software = os.environ.get('SERVER_SOFTWARE', '').lower() J# On IIS,EHTTPswill bed as UTF-8 OlongL!asGinput is a valid8snce. Otherwise i(JNd=Uqsystem e page (mbcs), with no way toLtect this happened. Becauseimore likelyM`, and 1inhly unreliable (an"Ostri1pthat ha@s too20not!asT)always recreatoriginal |TWp.startsYp('microq~-iis/')>av = v.e('utf-8').('iso-8859-1'Apache mod_cgi wri9?q-as-uni(as if ISON) direct !toU;$0 Nogification needed/ela OpasshPython 3's http.F@.CGIvRstHandlert cg#urllib.unquotfault of, amongst on#[issuee(1y "`simple./'7+!'pt/3' in I f`B2For`, guesaqey havey3ten,MMQstdio3 -oriented interfaces, en= up#S /se|enc, 'replace# Recoverts from s,Purrog\jescape0# wb availJ.1+)/el H?escI 0[k]gsreturn  class BasedL`"""ManOCinvoof a WSGI application"2"" # Configuration parameters; can override per-subclass or instanceJwsgi_versGv= (1,0)multithread = Tru5}processrun_once = Falseorigin_server4We are transmitting direct to clientEhttp = "1.0"Vthat should be used for respons`_softwy`= NoneY0Str}name of ) ), if any# os_environ islto supply cfrom the OS 4Qment: # by default it's a copyC'os.1@' asimport time, but youLthis in e.g.$r __init__ method.2 = $()Collaborator N!es;@file_wrappSFileW!sedto disablheaders_UB = H8`# musta R-likeError handl_(also traceback_limit Print enti'self.get_stderr(Je`_statu"500 Internal S";/ = [('Content-Type','text/plain')]4body = b"AL occurred. Please taEhe administ.JState varis (don't m@with"se0res,@_senDX,Tbytes*0def run([, applic)"K"""Invoke$"""S%d# Note#: "ov6close()! AsynchronousHs9"n'nPScall 8 fI$h_S`(), sob'PwhereNrdouble-pbranch +,'ll break a'byMprematureoslosing.<breturn'h0)' )ouCt might stiqe outpu@iter8kE6tryg.setupT!N !, (Ustartv I +except (Connec5qAborted, BrokenPipe)QResetw# We exphz-cp abruptlyN!toOreturn except: :tryself.handle_error()5I8# If we get an ; H5ing, just give up already!bN[close(raise # ...and let the actual server figure it out. edef setup_environ(k)`"""SetR%ment for one request"""S`env = K.3$osjW.copy.add_cgi_vars()Q['wsgi.input']ffget_stdinQ3env4~s5 4(er5tversion65_B5run_once656url_schem86multithread'] `n`procesn9}i$1lf.# file_wrapper is not None3 0)']nsorigin_"_softwarw.setdefault('SERVER_SOFTWARE',C) finish_responsend any iterable data,q!n  3'Subclasses intendedMuse in asynchronouses willwant to redefine this method, such that@setscallbacksE in0 ev@loopR@te o1 o E@'K@()' Q;N5ed.6&  p!ifNYresult_is_&V() orBsend vVKJ)-!`write(4 !0_cotFb# Call gY-returned by/WSGI application*~#qcase of4p6ionQ'if hasattr.<1, ''.'.% S;elsh# We onlywhen no 0ionLqd, becatYk# status, , headers,LH`fieldsv # See bpo-29183Vmore details.  self.close() def get_scheme("!):"""Return the URL ( being used"""/r,XguessR.environuset_content_length}Compute C)!-L) or switch to chunked encodif possible6tryblocks = len|.result) except (TypeError,AttributNotImplemented#>eFpassP:lse2if :==1=.headers[''] = strbytes_senB# XXX Try for>origin server and client is 1.1:cleanup_"""Make any necessary - changesdefaults Subclasses can extend thisadd other :.=4,( must be a"Past 4vractersEf[:3].isdigit()t m$geT=Aw/3-(_ codeP3]==" "Jhave a space afterMSif __debug__name, val\ &&b!#,  eBf=gE6valD_valueEmis_hop_by(u5),\rf"Hop-by-hop, '{name}: {val}', not allowed" return self.write def _convert_string_type(), value, title):MB"""C4b/check( 9E."""(!if(G) is strG"8raise AssertionError(7"{0} must be og] (got {1})".format(c, repr)K)send_preambl Transmit version/status/date/server, viac_d+()V.origin_4 "if?client_is_modern(Lh('HTTP/%s %s\r\n' % c.http_,3)).encode('iso-8859-1')cif 'Date'YiCzheaders/gk(V:_Q`_time(./()^s_software and 'S$(?kn JelseMFE1('Smf]Rg, dataNB"""')' callable as specified by PEP 3333VaVbytes, \&*"b argument!a 1 instance!ifr. !%j before start_response()"(elcZ_senti2# BMthe first output, 5 sstored E \r = len(1 # make sure we know content-lengthNw_l(E|+} b# XXX C{L{"truncate soo manyEten? flush() }/fis@Plat- c )" tsHOverride this method @ubcls to support p[ cP. ItAonly#!ed he applica%'sCAiterN!('qresult'%an5 of:)Pwsgi__wrapper'.Tshould return a true value if it was able to actually 0transmit the wrapped file-like object using a platform-specificHapproach. It should return a falsnormal iterationF8 be used instead. An excep. can be rai%to indicateHSthat Rssionttempted, but failed. 6NOTE: this methodcall 'self.send_headers()' if?!_sent' is0andPis goLu directG !of."5""" cFan # No by default def finish_content(%):f"""Ensure  - have both been pif not S.?_# Only zero Cp-LengthAAt by@appl5(soIHEAD requests3satisfied properly, see #3839)GC.set3*('o', "0"; )[Jelsepass # XXX checkZ"-l0too6rt?_closeC)c(aeeded)`reset e0anc"rs\GSubclasses may wantAlso drop_client connec:tryif hasattr.result,''y&.%(s0fin b1) =|dstatusenviron = NonI|QbytesY = 0;RT D"""T{_UR, viag_write()UO.cleanupgX6Truorigin_server orv_is_modern(preamble!?'))*l(n,ud/^!an&#ofPwsgi_J_(r'; -E\0!is C$is;/ K+ ac q;self.environB['SERVER_PROTOCOL'].upper() != 'HTTP/0.9' def log_exception(self,exc_info):&*"""Log the '' tuple in`serverP]7Subclasses may override to retarget< output or change its format. Etry: j from traceback import print 2stderr = self.get_)()' C(zU[0], 1 =2],7v_limit, - !g.flushkfinallr = Nonehandle_errorcurrent $, and send `to cli'if possible""" b4ys.&()bif notheaders_sentQdresult_.environ,Mstart_responseqOefinish"V# XXX else: attempt advanced recy techniqueP HTMLVtext?t &, """WSGI mini-app9icreatef Byault, this just u_status', 'p'Pbody'pributesPgener$an page. It can$be0den*3a sHpdynamic Tdiagnosticschoose an appropripmessage+Huser's preferred language, etc.(Note, however+qat it'smmended Xa security perspectiv@spit  pany old`r; ide, you should haJ6 doMomething k0ialJgenable`o put, which is why we don'tM`includ:uy here!  G,,* ._[:],sreturn [6G]x# Pure abs t ods; *must* 64"esa_writeZ,dataOk)inrpbuffer 16^II rokay ifJP actum0nsmZQq; BaseH]rg@sepa1!s P0 opJ2ion>gr efficiencyI2whejqunderly!ystem actuall y has such a distinction. 5""" raise NotImplementedError #def _flush(self):H4"""Override in subclass to force sending of recent '_write()' callscMIt's okay if this method is a no-op (i.e.,!Hactuallyvs the data&get_stdinPretur itable 'wsgi.input's?err.esadd_cgi_varsinsert CGI varis'=.environ Q SiHandler(Base 3"""@ thaIjust initialized with streams, b, etc.Twhgi`tended synchronous HTTP/1.0 origqervers,Band Ns entire response output, given`correcCputsrUsage::3\Jr = !}!inp,out,err,env, multithread=Falseprocess=TrueB) m.run(app) _l!__(,6x3std{s `4C^1 = "2out=out er- base_env = _( =H,S-7crHBelf.c4 5'er Vq.update.)3,^Qresul}Bout.*i,is None or >a= len(1i6Efrom warnings import")("L) should not do par/ &s"pDeprecaFWv`while  ! =[%:]U"if|:ata:Ybreak/Dbta) def _flush(self): .stdout.!)7= = * class BaseCGIHandler(Simple1): P"""CGI-like systems using input/outerror streams and environ mappingNcUsage:[h|, =inp,out,err,env2.run(app)YSThis  i eful for gateway protocols ReadyExec FastCGI, that have usable $anAmentL. It's also the base, which just usesG0syssin, os.Y,t so on.e constructoroakes keyword argus 'multithread'Kjprocess' (defa(ng to 'True- 'False' respectively)$qcontrolNconfiguration sent&aapplic! sets 'origin_server' toKoq (to en)rassumesP'wsgi(_once' iNK.V2"""; u1 = $((3 %bd invo@ via5/0errs z) e difference between t  # iit alwayi .#of, 1%'yNB'B(6 does not take any initializ Hparameters, bu% ' F', ' friendsIf you needuroverridx of8se n;use{instead4^A_run^0 = /A# DoWallowEleakrequests in Google App EngineLaother Z-run CGI cases. iZeasily test)# See http://bugs.python.org/issue7250r3os_bR = {}`def __,__ c.'N, 0.bu  C2(),=|=)7IISV ` with workaroundXIIS path bushould bEeD pre toq when deploying on MJicrosoft IIS without having set the config allowPathInfo option (IIS>=7) or metabase .ForScriptMappings8P<7). 81"""wsgi_run_once = Trueos_environ = {} # By default,gives a PATH_INFO that duplicatesSCRIPT_NAME atKfront, causproblems for WSGI apI0ionKat wish to implemenOrouting. This handler strips any suchtd path.Tcan b|@uredg0pasyVrrect@, bu!is#esanother bug where3TRANSLATED is wroLuckily tvariable iKrarely used and9not guaranteed by(@. On@<7, Q gh#V @only made on a vhost level, affec-Ball sHmO0, mUof which break`n expo!to2bugR# ForSreaso0almnever deployed-Sfix. (Eve37.ps it beWe1rT still no UIaDit.)T is1way CGI code@tell0was_c, so aseparate clEis provideddef __init__(self):B|d= read( 3 = 'a.get('iV', '', . 0@if (`+'/').starts(I[1] =bC[len95):]BaseCGIH.!W, sys.stdin.buffer@,;:\\"/\[\]\?=]') ;aformat(,^a=None,3e=1U"""Conveni@func6H?PreturAkey=S pair'ZwEZr if needed or  Pis tr """ i f value is not None and len() > 0:  if quote or tspecials.search1-4E" =g.replace('\\', '\\\\')"', r'\"')qD return '%s="%s"' % (param,W.Jelse</%s: 62a class Headers\"""Manage a collection of HTTP response h5A""" def __init__(self,#=y)^:$ =!6 if 1 []_9if type(A)Flist_*raise TypeError("p must b5Rname/vtuples"r#._o__debug__for k, v in !_convert_string_k)-'v)N;NB"""C{b/checkob.uv$t6strG#V"PAsserB  vsws";T"  str (got {0})".format(repr)C_lentB"""Rithe total numberg, including duplicates BV ssetitem, @Set 7a+ r@del k[3 ~.append(A/._K!),W!Jval)V8delB """Delete all occurrences,present.Does *not* 3an excep63$missing./ =!.lower()d M[:] = [kv  !Tkv[0]I1 !=] gy GSfirsty'2'R'L insteadvLNvNKthatMJared multiple times,exactly whichb gets * edundefined. Use!all() to 5Hqs matchQfieldlreturn self.get(name) def __contains__(self, ":"&"""Return true if the message >header.""">r;Z3.ge is not None get_all a list of allxvalues ford field.^These will be sorted in2Aorde<y appearriginal r were added to this instance, and may& duplicates. AnyN`s dele8qre-inseadQlwaysnne.ORIf no@s ex/AwithQgiven", s an emptyGU1 = 4vert_string_typeY.lower())bq [kv[1] kvvHTsUTkv[0]@ ==o],default=A)1GetTfirst }'?S', or# 'L'0.k,Jif k $7vHAkeys ,ss$Kl%%2Any$(M,w![k->k, ]R<W}y5tvtOitemsjTLu%$  """  return self._headers[:] def __repr__(#!):9"%s(%r)" % ".__class__.__name__,^)\/st["""str()s the formatted , complete with end line,qsuitabl< direct HTTP transmission."""2'\r\n'.join(["%s: %s kv[ kv i3]+['','']_bytes;U.encode('iso-8859-1'Hsetdefaultb,Vg,valueB"""Rfirst matching. 0'@q', or '' Iflre is no<1$d 8add a new~$#N3andxi lbsult =@get(D)>Qif re#vis None|:.append(!._convert_string_type]CG1&))/!;els'_L3addd!, "1, _P, **_paramseExtend setting.YH*  field to add. keyword arguments can be use'5setadditional Qeters> a,} un9ccores M%edOto dashes. N0llyi]P will ad as!="" unlessO,which case on\:keyV00Exa;:B'h.'content-dispos ', 'attach>p', file='bud.gifNote that ik e correspond'email.message' method, this doe*not* handle '(charset, language,f)' tuples: alls must be=s?.parts = []#ify?not# Tm !qfor k, rw.items($rkx ks ifRWK k.replace('_+-'Dv v1 u_|(7, vsIb ype(_name), ^"; ".join(parts))) """BaseHTTPServer that implements the Python WSGI protocol (PEP 3333) This is both an exaBr of how9fcan be[ed, and a basis for running s$ web applications on a local machine, such as mightbdone when testOor debugging anT. It has no>en reviewed security issues, howeverwe strongly recommendCyou use a "real"sdfor produc'e. For8@usag!ee'if __name__=="__main__"' block at'| of  module. See also %B doc~other API informu.$ from http.eimportSRequestHandlR *4sys urllib.parseZwsgiref.h@s'_S V+@plat#p_) __version__ = "0.2" __allb['WSGI1',  demo_app Rmake_R'] ecRW/" + G sys*a() + ":Csys..split()[0] softwareJ + ' ' + o class J(X): Nh4 = s(def close(self):=A6try  ".r_S.log_(;.2cstatusP' ',1!, bytes_sent=)kfinall . "()'2"""7r = NoneO{LbindU"""Override' to stor"@ #.qK_<c1Wsetup_environ(),# Set up#e >]0envIelf.basebX = {}%['SERVER_NAME']4 .GATEWAY_INTERFAC4'CGI/1.1'-[BPORT[!trAenv['REMOTE_HOST']='QCONTENT_LENGTH!fSCRIPT&''R0getVLbreturn,8s8,"D. = application class WSGIRequestHandler(BaseHTTP ): server_version = "CSd/" + _"__2def get_environ(self):MQ`env = .\T.base.x.copy().['SERVER_PROTOCOL']Ar6SOFTWARE6w5REQUEST_METHOD4ucommandbif '?' inFpathd,query.split('?',1?lse>2,''caenv['PATH_INFOurllib.parse.unquote(w, 'iso-8859-1'yDQUERY_STRINGGiDhostaddress_string1if (!sclient_0:[0]REMOTE_HOSTxAa"AADDR"6 ["ifheaders.get('content-type') is NonpnCONTENT_TYP.L_K_KeP[]dlengthr#2if gaLENGTHH,sfor k, vvgitems(zk=k.replace('-','_').upper(); v=v.p!6@if k`:envY@inue p# skip #3ent , U,etc.39?_'+n&] += ','+v@1 # -separate multiple  oE `5= v5return env~-lstderr,.Bsys.!5h 12""" a single  )2"""BMCraw_Dlinevrfile.readf(655377n|.A@) > .6lRU = ''"&/ndsend_error(414ePbif not46 (): # An I code has beent, just exit bBr = 3)r(5s,w K#()^)),Kthread=False,  !)  handler.request_r = self& # backpointer for loggingF0un(8.server.get_app()) def demo environ,start_response):Tfrom io import StringIOstdout =( print("Hello world!", file=3' hcorted(`.itemsk,v in htk,'=',repr(v)s *("200 OK", [('Content-Type','text/plain; charset=utf-8')]return [bvalue().encode("03")]rRmake_(A`host, Yr, app, _class=WSGIS,R'H6 """Create a new DV listening on `|p` and ``N`app`"""| ((9)7#.sq2app/ if __name__ == '__main__'Xwith 2'', 8000,) as httpd3Bsa =p.socket j(0"`HTTP on", sa[0], "1B...">webbrowser1p.open('://local;:/xyz?abc'S("d._R() #S one  , then exit """Miscellaneous-related Utilities posixpath __all! [ 'FileWrapper', 'guess_schemeapplication_uriE`shift_bP_info& setup_testing_defaults',  {3""" to convertG-like objectssiterabl__init__ 9, blksize=8192940&! =k !=$ =Gif hasattr(F,'close'fIg. O0get7keyH0wars7\. h"dU's __a method ignores 'key' parameter. EQ"Use utor protocol instead.",.RDepre6W stacklevel=290dat Q.read.00if 3Ercraise IndexError{xtF-4nexg-l>3lf.e.read(self.blksize) if data:areturnraise StopIteration def guess_scheme(environ)PB"""RKa' for whether 'wsgi.url=' should be 'http' or !s'1"""3if i.get("HTTPS") in ('yes','on','1'ZPBelse !'aapplicO_uriGthe , 's base URI (no PATH_INFOQUERY_STRING)Turl =[b]+'://from urllib.parse import quote !'!X_HOSTt+u%]E  .SERVER_NAME']vE4 ==w 6YPORT'] != '443'04V':' +: >,  4r/80q$r3r'SCRIPT5) '/', encoding='latin1'2urlxrequest, include_query=True|Sfull A@, opCallyD@ing +Jz string tpath_info = &',''), safe='/;=,$dif note8?[1:'#if%iJ andue)'? . eshift_+S! a name ~AG to k", ]"it Ifre are no remain"s segmentsSWHa None.sNote: '' is modified in-place; use a copy if you needAkeepIzoriginal0.uGwhen*is just a TCthisAs ''appends a trailing{0'/'h, even though empty 6"rm@qgnored,NK doesn't no. en@. Tii2tenHbehavior,ensure that ank can tell difference between '/x' and '/x/' when traversing to objects. """path_info = environ.get('PATH_INFO',''),uif not 3:Nreturn None $vparts =1.split('/Q&[1:-1] = [p for p in8Eif p and p != '.']mDnameg/9delE]sscript_7 SCRIPT_NAME 0PposixP.norm (!P+'/'+Z3.endswith?#7 = [|Z)Zb+= '/'(['Tx)A] K`.join(_w)\ # Special case: '/.' on B doesn't get stripped,o# because we do%! the last element ofQ; if're's only one left. Instead@1fix3hisB`above,|fix it here so thatp s alized toAqn empty ngF{ame=='.'=CS def setup_testing_defaults([)J"""Update ' ' qP triv8fM purposesThis adds various@ameters required@WSGI, includJHTTP_HOSTaSERVERM#, PORT, REQUEST_METHOD, ,gF0allKawsgi.*Pablestsupplies v valuesGxreplace any exiSa[sWthesefroutine is intendP make3aeasierEPunit es.'0serapcationsset up dummyshould *not*Lbe used by actual g c8or bp, since'P dataQfake!L ;C.setK#('127.0.0.12PROTOCOL',' S/1.0'*6$D#',[|]Y Vd','GETk9if  A$inc ]x5-!',q(ion', (1,0)'wsgi.run_on!ce', 0) environ.setdefault('wsgi.multithread.rprocess/^from io import StringIO, BytesIO%einput'-/() Perrorh2url_scheme',guess(1)) $if)[9]=='http':+USERVER_PORT', '80'l]s^443') _hoppish = {'connectionkeep-aliv'proxy-authenticate',6Toriza?! 'trailez nsfer-encodingBupgrade' }.__contains__ def is0_by(header_name)U"""Return true if '%' is an HTTP/1.1 "Hop-by-Hop" )1"""rGhl`.lower4 # (c) 2005 Ian Bicking and ributors; written for Paste ( ://pythonp.org) # Licensed under the MIT l#: :www.opensource=/#cs/mit- .php # AlsoCcZdApachetU, 2.0b^a432.0\cto PSFca Cont Agreement bMiddleware to checkobediencWSGI specifhion. Some ofthings thisHs: * Signatur(CapplBstart_response (inclu that keyword argu s not used).fE}H - t1 diKary (and Ha subclassN7That allrequired}!intv: REQUEST_METHODCcNAME, P!, sversion= E+#run_once!- b_CONTENT_TYPEt eLENGTHU{s (theses should appear as dN!ndC{]PWarnsQUERY_STRINGmissing,Ptcgi module actsQPunpreQably at case.CGI-style variablesat don'tain a .) have\(non-unicode) sw values\ha tuplu"q%qA or ps' (@@:11too revctive?) - Warnxs if the REQUEST_METHOD is not known (@@: probably too restrictive). - That SCRIPT_NAME and PATH_INFO are empty or start with / >at least one of N:or M8setzCONTENT_LENGTHa positive integer0\'/' (it should be '',  8/')Uwsgi.input has\methods read,Fline sbQ__iter__ QmerrorsRflush, write[s * Thee2tus ng, contains a space,&2rts$an*1, t>Jin range (> 100m!atcheaders`list (Ia subclass,Y another kind of sequencLPPitems ]IQtuple"s. reno 'status' <" (s used in CGI, butin WSGITdon'tBA newn or colons, enV_u-, or 0pcharactcodes below 037Content-TypSgivenent (CGI oftena defaul#BtypeA doe?no r@whent!noT i@is  (?) exc_info argum?"too_respons!a 4FNoneall calls to r w;AB no VqA o7accessedeaiproperly:. ()S"ed,qexactly1T4rt returkWtringS>  = ;b.close]!N+providedTU!(). swsa eTsterator_ it| !a { of@ingl  ; ( will work&perform horribly) .__next__()C ed over until haNa been#edcan signal ei5Pa serJor applicatio!  .d (doesn't r*aise exception, only prints to sys.stderr, because we*know it isn't called when the objectE0is garbage collected). """ __all__ = ['validator'] import re 4syswarnings header_re = re.compile(r'^[a-zA-Z]0-9\-_]*$') bad_9_value? [\000-\037]') class WSGIW{(!):/RSd in response to8-spec-relat&Fs= def assert_(cond, *args`pif not qmrm! A5ionError(6 Pcheck_string_type(v, title[ ) is strfaeturn :w"{0} must be of \str (got {1})".format(c, repr}")) (applica1): flWj ed between am server and)IR, thi{middleware will 2B forGOPlianc a numberqlevels.WThis JAdoesamodifyrequest orain anyCway, butb+an0 if1thing seems off@(a failur{0clo7he P iteriq, whichC"be ed0 --0re'@ wayz1ionFat that point) lint_appc, **kw?Alen( == 2, "Two argumeOaired")Y:(kw, "No keyword9Yallow8Penvirestart_=6ss`_.() P# We ]"1~rRs withou#b#D  _ ed=]fs_wrappe t|x E3, (r81"In: %s" % 6,)):v<rstatus 9[0]1:if bZexc_info`2BOelse5 FNoneRBtus( !(#rcontentJ/, 0%_info)  start_response_ed.append(None) *return WriteWr'!r(5D(*args)) 8 environ['wsgi.input'] = I E%| aerrorsEE E&iterator = application(^*, "_wassert_(Hpis not )U and != False,AH"Thezc must U%an? , if only an empty list"dcheck_p"WI%3 #edB>lint_app class:def __init__(self, _%):' ="ECreadAE<yAlen(`V == 1Fv = `.JDCtype(v) is bytesEvOline< N8s$s5:">=@for 1 ins ~(Cs_\Pzwhile 1h<(!if <QyieldBclosA0, ".'))be calledRR rTw%s;s6str*[.DQflushVS3!2Dt7seq<?:seqYA(BVa L rs'\$ __/,  `4(s){Partial wsgi_iteratcor): self.iterator = wsgi_ 'Qdef _0__(0?# We want to make sure/ is calledJtreturn IsqWrapperX, None) class,:3nit,, check_start_response.original/0 = (/),closed = False/ = 3terSu-4nex-assert_(not 2.," read after )"@v = e  if type(v)qVbytes}k%&, zyielded non-8tring (%r)" % (v,)kX0is }T|; "The application }s and we n!ed atover its body, but%2 hayet been3jz! =/& v  P6Tru if3att %1, 'T'P .c&()^__del!if sys.stderr.write(}? garbage collected withoucdd~ \  <environ(9u(.Fdict""E>@mentof the righthT: %r `*%)"$9% (g$, qfor key in ['REQUEST_METHOD', 'SERVER_NAMEVPORT''.version/Uinputoerrors=pmultith3oproces9run_once']?i f@miss(requiredQ|0key~[ 6HTTP_CONTENT_TYP* oLENGTH$inPshoulat have key: %s "(use %s instead)+" % (key, key[5:])) if 'QUERY_STRING' not in environ:&*warnings. ( B4 isDthe WSGIM`ment; Zcgi 'Dmodule will use sys.argv when this variablecmissing,Gso application errors are more likely',|W0for* v.keys(): .'"6key# Extension, we don't cabout its typevcontinuassert_(*(`[key]):str""Ef&al- %s/a string: %r (value ))"*w,,'wsgi.ver'Vtuple"# should be a )Q (%r) T1,)) 'url_scheme']('http', = 0"Invalid - A !ifp'; wOne of E or :(required ( ""at least0'/'MZis empty)"M|1') != '/"@ can be$D; it5ainstea='', and " "PATH_INFO should be '/'") def check_input(wsgi ): for attr in ['read', Hline s __iter__']?Cassert_(hasJd,[!),j+". (%r) doesn't have the5ibute %s"<.% ^ berrors% PflushAwrit sX!&?` rstatus( # =string_type(A, "S8!")L# Implicitly5 that we can turn it into anBegerm_code = .split(None, 1)[0]g3len7f) == 3 S`s mustthree characters: %r" %rIf`_int = k"*e>= 100| is invalidm2int96if ) < 4 or[3] != ' ')warnings. (C"The: .!a B-dig "followed by a single space and explanationBRr, WSGIW sheaders(uUgCGlistH>0of 8 ,l$% h,#"))@itemvo &)Vtuple}Individual F< @0% (_ +2 name, valuC"2, "N QKN89P.H1r()+'6I6/!noPused;6conflicts with CGIqscript,DHTTP0is MPgivenCoughisD( ).cA'\n'U!in5t)': cQs may?contain ;or '\\n'}{=zW_re.search('c, "BadF 9P.endsPQ('-')ame.endswith('_'), "Names may not end in '-' or '_': %r" % name):if bad_header_value_re.search(%):.oassert_(0, "Bad ; +d (bad char))"="% T,v.group(0))) def check_content_type(status,s# =2jstring1!"S:" code = intR.split(None, 1)[0])# @@: need one more person to verify thisLerpretation of RFC 2616#J http://www.w3.org/Protocols/rfc.-sec10.htmlA NO_MESSAGE_BODY = (204, 3041for, s 'A, "HG*!if.lower() == '-'a/`;in ,0areturns2("CS-TypeB foua %s response, }K"which must/v `.") % M!if * O"No P (%s) exc_info( h@ is 0Vtuple-"6@(%r)!!a 'B*, Q)0# MK(s?iterator( # Technically a byterlegal, is why it's a re21bad# idea, because it 5thebYe=acter-by- Z_isinstancer, (str,)"You should+r3 a as your applic"sFead Aingle-item listiainingB2.") """Implements (a subset of) Sun XDR -- eXternal Data Represen. See: P1014 U importuct from io B"IOfunctoolswraps __all__ = ["Error", "Packe 5Unp Conversion)] # excepRs class $(Ec5""" )module. Use: U xdrlib.Rv as var#P has Z$ \eXPublic ivaru0msgj2ainPrmessage7""" __init__(self, msg):  self.msg = msg def __repr__( !):preturn ;)6/st57str4 class ConversionError(r`pass Zuraise_c,!_e-function0""" Wrap any 3d struct.0ls in asa. """ u@wraps(WQesults, values6try"&G 7S%iexcept[ as eK (e.args[0]) from NoneYzr dbPackerY0""" various data`esentaN'to a buffer. n__init).reset()M.0.__buf = BytesIO50get"fe0:AA.get( # backwards compatibilityY3 = 2fer@. a6pack_uinxcwrite(s4('>L', x)hg"lg{_enum = 2intCboolmif x: Ab'\0"1'i?lse, #0'uCuhypK Cvx>>32 & 0xfIQ(Type>,U)V/b'ZhsOfloa fuiodoubley.FdjPsfstringOGn, sif n < 0f V-#('E size must be nonnegative-q= s[:n]{Rn = ((n+3)//4)*4.+ (n - len(P)) * U'. (tfopaque! len(s)  self.pack_uint(n) fstring(n, s) !2opaque = %[bytes2def2Plist(g , ,aitem):*@for 1 in&>1=( 60cfarrayn pif len(j) != n raise ValueError('wrong `f size' !QL6n =A& a  class Un"er2""")s various data representations from the given buffer."""i__init__G!S!t(8 ,| 5q__buf = @__po0M0getiNbreturnL;7s7Q, posFA.:1 E|z 6buf5Ldone/'if! < |7bufunextracted0 remains'<uIVP7i =zmuj = i+47buf[i:j]{&R) < 4w!OF5btruct.S('>L'"6[0]B_lsenum = =intLbool658)\hyperEh~p$lo hi)<<32 | lo}x\&~if x >= 0x80 WIzx - 0x1',00dxBfloajaise EOFErro3r return struct.unpack('>f', data)[0] -Bdef _double(self):M@i = e.__pos = j = i+8c7buf[i:j]pif len(&V) < 8mqraise EOFErrod qfstring8, nf n < 0{QValue}#('B size must be nonnegative')) + (n+3)//4*42Qf j > O(bu{00posRbelf.__y3i+nfopaque = >;nOVuint("`2(n)c o"@byte!"Clist)Gitem!F = [zwhile 1x if x == 0: break,!=WConversion^0 or 1 expected, got %r' % (x,)UDv!.append(?!>cfarray@$n,A ; Cfor i in range(] ( ? U  """Core XML support Python. This Aage contains four sub-s: dom -- The W3C Document Object Model. Qks DOM Level 1 +QNamespaces. parsers[0 wrrr#(currently onlys Expat). saxISimple API`XML, dpoped byZr-Dev, lTDavidMegginson and 7ced to by Lars Marius GarshoDthe SAX 2. etree0EleGTtlibraryJ@is apset of KDfulld >release.  __all__"dom", "N 0saxB"] #!isgqmappingE interface NodeFilter from #P2-Tra@al-R9F. ItUconstantWclassK1"""This is the DOM2 NodeFilter interface. It contains onlystants. """FILTER_ACCEPT = 1PREJEC2SKIP = 3 SHOW_ALLW S= 0xF-ELEMENT-0ZTTRIBUTE/Z,0-=TEXW#0x-4CDATA_SECTION^Z8-ENTITY_REFERENC-,10-S -2-PROCESSING_INSTRU-4-?COM; 8-ODOCU.Z/10-D_TYP;2-FFRAGcZ4-JNOTAc-2800Jdef accept(self, node):\7raise NotImplementedError """W3C Docu Object Model i.ation for Python. The mapping of theL3s dePed in+ N Library Reference A seczo/ xml.dom package$is`followmodules: mini@a-- A s  Level 1 DOM with namespaceT support added (based B2 specificC) and otherHdminor 21funality. pulltbuilder}`on-dem[Qtree-"selectedp0sub)s .  class%DA"""C0givYan@Typew% __slots__ = ()#Ltis may use this as a E their own# `s. IfPy don't,  defined her# should still bedcanonical9ithey match.values givenRrecommend. ClienaTde casafely r0 to3se Uin all tests.4Typ+.e$G_NOD{ A&"= I  -"= 2 '1= 5G$A = 6$N1= 7$= 8 DOCUMENTj_NODE @= 9 DOCUMENT_TYPE)J= 10%AFRAG.RA= 11%NOTATIONEe = 12 #ExceptionCode INDEX_SIZE_ERR)= 1 DOMSTRING'= 2 HIERARCHY_REQUESTM= 3 WRONG_ m= 4 INVALID_CHARACTERF5 NO_DATA_ALLOWED!P = 6#rMODIFIC  += 7 NOT_FOUN@1= 8#~SUPPORTgi9 INUSE_ATTRIBUT@>STA"G11 SYNTAX $2 D= 13 NAMESPACK6= 1cmACCESStQ= 15 <bD= 16 class DOMP( !):"""Abstract base 40for8$ e!s./? s with specific codes arePalizas of thisYQ.""" Jdef __init__(self, *args, **kw0if 1.__J__ i+raise RuntimeError(p" should not be instantiated directly")D.@get_breturn IndexSiz(=-: = omstringA3EHierarchyRequestErrXKWrongDocumenH }EInvalidCha/er  KNoDataAllowedH F0ModN V_tFoun;Support)T_4CInuseAttribut| VG?StaE_wCoSyntax 6%C (D_MODIFICATI0ON_ERR class NamespaceErr(DOMException): code = NAMESPACE_<InvalidAccess@ INVALID_ACCESSVCarB @:ATIUserDataHandlerA"""Cgiving the operf constants for A!.hIq().""" # Based on DOM Level 3 (WD 9 April 2002).NODE_CLONED = 1DIMPORTED = 2@DELEF = 3 RErDBp4 XML_ = "http://www.w3.org/XML/1998/n"7/NS9 2000/xmlns/" XHTk1999/xhtml" EMPTYcCNone`PREFIX> from .domreg import getDOMImplement, registerQ """Rfacilitie'DOM. This module should not be used directly. Instead,!@funcs_ and g#be1ed 0xmlM#is a list of well-known:Vs. W' #ipublished by posto xml-sig@python,@ are@ ubsequently recorded in t5sfile. Psys _)_iQs = {'minidom':',!u4DOM':  ')A} #e kofficial $ed #mselves with5ir  edo} defi(q, factory 4"""h 1  erL i le$?return an object which7sf Cinterfaceg can either g4Csamem or a new one (e.g. if that@ supas somecustomiz _R0ed[4] = _good_enough(dom, features"R -> R81e dom offer1N"0f,vT !ifIdom.hasFC(f,v$C0R 1;=83=()U?"""5[7` = ())Ftion. RBeturn a suitable DOM implementation. The name is either well-known, the modul*Oof aL, or None. IfE itV1not,|AortsQcorresponding_Qand rsAIDOMI object ifEimport succeeds. 6%If|given, consider9Qavail As toDfind one with3required feature set0 noUA canEbe found, raise an IRError|Ns list must beqequenceICof (), version) pairs which are passed to hasFB.""",oZcreator =eQmod =__P.get(+)/ if: 2?_6ort__(mod, {}]['get"']L@Ti +(*2eliy9registered[]1 ot sys.flags.ignore_environ  y"PYTHON_DOM" in os.# l' =7[R"])# User did specify a[, tryNsarbitraryo# order,,A1the@thatif isinstanceWvs, str)os = _parse_u_string9Dfor T6in .values([Tdom =.if _good_enough(dom,ns@,2domW 9key6try[ 3except Eion: # typically$AttributeErcontinu)urO("no ") def ![] pa= s.splitQi = 0 length = len(-Awhile i <6gthd1 = /"[ii0[0]""0123456789"B+VqF("ba,v: %r" %d)>Qi + 1;WvOif v): = v features.append((feature, version)) return tuple$s) """Facility to use the Expat parser0load a minidom instance from a string or file. This avoids allT overhead of SAX and pullQto gain perform\. # Warning! # # Ymodule is tightly boundimplementation detailswUthe #1DOMcan't bed with other ! M1s. #~Pdue, @art,~`a lackjappropriate methods*V(` # no wa~0cre00Ent #Nonodes viaKCpLevel 2nterface),9forIe latter caof some fairly # cryptic code.qPq hacks:! - .character_data_handler() has an extra casewhich continuing # <e=0istWPText 0; tX0cana@speedup since pye&reak up mnto multiplPcallb even though we setvbuffer_tattribute o+E3& also gives usDadvantagg at^ do~Vneed @epar n 2lizBpassPDeterng that a&p existsR0donEban ideZcomparisonCN. raPn a truth test|`searchXm4andIE5any"object if itb. (A xGTnice KPchiev/as well!) @xml.Jimport xmlbuilder,S, Nod .EMPTY_NAMESPACE, PREFIX, XMLNSq#s uey@dom.__child, _set_K_ ?1Fil TEXT_NODE =. CDATA_SECTION$ DOCUMENL  FILTER_ACCEPT =aR.DOMBl.,:_REJEC:,:OSKIPr*6INTERRU/ theDOMIF=GM.get ()6typename -> TypeInfo _info_map = {" ":*.3(@, "c2"),1BENUM0 minidom.TypeI(nfo(None, "enumeration"), "ENTITY": minidom.TypeI7Jtity2_IES":2 5ies4!IDbrf'id.2REF1.:ref1VidrefpNMTOKENecfnmtoke*3g3 g} class ElementVobject):__slots__ = '_attr_info', '_model tagName' 3def __init__(self, !!, 3=`r$.#$ =-L{[ = []W" =_getstateuqreturn |],Q WsW!, e^W" ==_getAttributeDWanamec@for - i<!if(q[1] == G !%2t =&&-2]aif t[0?>"("=$PP_type_map["ENUM"QOelseGPF[-2]In1_noyE#NSGFspaceURI, localY\#is/qContentZA(ifF Belf.A&[0I)0notq(expat..XML_CTYPE_ANY%7;eMIXED)FVFalseVisEmptyIJ_EMPTY !Id,';QE"ID" 7%Idpeuri, e1, a  # sure this is meaningfullZhisId((N1) intern(builder, sh"._(_setdefault(s-Fparse_ns_MPassert ' 'parts = .split(' ') intern& = builder._intern_setdefault if len(parts) == 3: uri, localname, prefix = .'b(/)(qF = "%s:%s" % +e.U=!, %83 = )1-el2EMPTY_PREFIX}&se*raise ValueError("Unsupported syntax: spaces in URIs not %@: %rVgdreturnGuri)Z class ExpatB;"""DocumentT that use02 to a ParsedXML.DOM d:1instance.""" def __init__(self, options=None)$if@ is  7d = xmlOL('d&._-  9if #p.filtertsx.&1= F/VisibilityController{X(el Z{ # This *really* doesn't do anything/t%case, soAoverride it with some:fast & minimal.9nish_start_ele!E= id,(p1r = vreset() acreateC1A"""C` a newser objectSe.M:k2get hR?:thef!, Z0oneIineeded"ifRelf._  ^ # =c. .AE+buffer_text = True ,ordered_attributes3specifi5!ll/3D  Free all data structuresPd dur2con9ionT. = theDOMImpa.!(C2NAMESPACE,ftcurNodeuN%e\_info(._info  self._cdata = False def install(%, parser):#B"""I" the callbacks needed to buildDOM into KE."""M# This creates circular references!,? StartDoctypeDeclHandler =s"_d r_decl_h"I{ElementErfirst_e@?End>?end< ProcessingL{ruction-piz"if0_op1s.entities*Ey$6y @Notac>n@ 0combC 31_se?b/CS' l0 I x TdMKCharacterDatac_OelseZT;rxternalC;Refe _K4ref K?XmlE?xml@|: Attlist>a |}CFileJfilePp a docu from a * object, returning+fKInodew1getf5r()3AbuffETrue:tryzwhile 1y@.read(16*1024j(rif not 3K#Ubreak.(?,ce 2and4. j._setup_subsetyr o @"", mIqexcept ]Escap%ss4doc re^_f = NonVz*cStrings se a documen#t from a string, returning the document node.""" parser = self.getP%()"Etry: 63.)(pFTrue4'Q_setup_subset-'qexcept JlEscapej%ss{4docl red^_u = None1 Kdef elf, buffer)q"""LoadVinternal 0 ifre might be onn"ifhl.doctyextractoIdSBEl2.S(&&= 32get^ U@ .3Gcstart__decl_handler(R,u Name, systemId, publicId,Dhas_^}Pimpleation.createDYType(|Gj)d.ownerP ~[_append_child\4 <$ =FV[_filter andl0.acmSNode() == FILTER_REJECTt{ J)2delljlUs[-1]- q.EntityDeclH?21Not4?if ; $if]q is not; $F .eies._seq = [+n, 0ComProcessingInstruc=BEndD = " op2s.cs^v 9[b; ,-piD!if._elem_info orRN_finish_9tF= id+p`, target, dataS CingInstruction(target, data) _append_child(self.curNode, node*1if _filter andp.accept;(: == FILTER_REJECT:v}Ml.removeC= ,def character__handler_c^2s =g_QE"( Bp_continue?'`P[-1].@Type CDATA_SECTION_NODE)mF @PData(,ireturntdocument.createSectionQ W = Tr0eli2ild` ATEXT  qvalue =.! + %G!= 1  Oelseminidom.Text(ca `cownerDg w/e+3p &+ 8? =  >entity_decl{Name, is_parame,,base, systemId, public @nota`)/ifl # we don't care about  ies for the DOM cif not op$s.E { : ".__B"y( 9? 5D"if1 is;Non # internaly<h# *should* be readonly, but we'll cheat9a nC(w=""s.(*udoctype._seq.append(noSde) if self._filter and.acceptNode(node) == FILTER_REJECT:LS2del@document.doctype.entities._seq[-1] 9 def notation_decl_handler(,Name, base, systemId, publicId)+ =_create_j( WG[" @r.append" \)_ACCEP\ ]0com WOdata5 4C@(2_a_child@.cur'bIl.removeC)Upstart_cA_sec`[S+u = True_continue = Falsel2end?jF+kxternal_P[y_ref?ext-return 1first_ele5nattributesC qis NoneP2notWV_infopfinish_LZ = idgetParser().SEH5G  J#(1-, 7[uq[|w0 = jU6if for i in range(0, len(.G), 23a = minidom.Attr2[i], EMPTY_NAMESPACE,p=#8fPREFIX11vals][i+1]]$a.* cownerD  0U_set_u_]3, afiPde is  _ \gd%@lY  # To be $general, we'd have to call isSameNode(), but this  # is sufficient for minidom:)qif node/elf.document 0Ele 6jireturnMfilt = sI_ er.startContainer(m)50if + == FILTER_REJECTr# ignore & descendentRejecter( z.el|OSKIPzx make it's children become#"of the par ._Skipp.se@.cur'! =..s r.removeC.unlink() I0# Iis ever changes, Namespaces.end_eK_handler() needs toF#be<dbmatch.Odef Hv, name) H3 = . *_finish_(4&i,`Einfo,_D.getY@.tagB0if %T_white_text_sL,9 J. R$if3*if`accept)t ./e,-21if D._options.m5_inucontent@aor not3.isSWent()-AB# We'4AtypeM0rma and should *6abl&# 0; i.1ify0s$0ch ain onlyAeL = []%i 1 inS.sL9fc.T== TEXT_NODE4?.data.strip(.KL.append(-1# RtQ fromFtree L }rZS_decl{w, model_elem_info.get(name) if info is None: self._elem_%[;] = ElementInfoOv, modelV;elsKaassertl!._.s rg =V ! def attlist_decl_handler( , , , type, default, required)f0 = ;P.get(I F  >C"C=% a._attrh.append( $[ 0&])<?xml8version, encoding, standalone2+@docu.63 =  (U% =`*`# This#still a little ugly, thanks to the pyexpat API. ;-'ifV >= 06  u = True,BFalse # Don'clude FILTER_INTERRUPT, since"t's checked separately # where allowed. _ALLOWED_LRETURNS = (@ACCE[tREJECT,|SKIP) class FilterVisibilityControl]cobjectP"""Wrr around a DOMBuilderF which imp#ssN`to make whatToShow fribute work."""__slots__ = ',"',__init__ !# =l>Pstart5ainQ8nodEmask2e_[.QType]tz?w. & 8 4val_1 aa6=Q [,raise ParseEscap0if J no \UValueErrors") returned illegalue: " + repr(val)3)b%acceptNode(T_Np =. if val == FILTER_SKIP: # move all child nodes to the parent, and re*Athis% K-! =.MNode)3form"in-{,Ns[:]P.appendC(6)_#T is handled bymcaller0return F'iREJECT%if val not in _ALLOWED_1^TURNSraise ValueError(Up"accept2() ed illegal{ue: " + repr(val)3)bJelse%qACCEPT 0_type_mask = {.ELEMENT_NODE:"Filter.SHOW_-,CATTRIBUTEE C- E?TEX< E- @CDATA_SECTION @ - IENTITY_REFERENC I -L\ L BPROCESSING_INSTRU - R?COM- CODOCUD -D:TYPdD_-ILFRAG_- MONOTAA M-D} class 6Crutch(object)__slots__ = '_builder', '_level old_startBend'def __init__(self, Ea.QE = 00$ =: fparser"._!A =Fs ElementH56end3?End1u..ST1 = N"_ep_ q@ a>=end< Re8er(Z/()L.cfor name in ("ProcessingInstructionHandler", "Comment'haracterData- StartCdataSe?End/xternalEntityRef )): setattr(parser, name, None) )Pdef s@_ele"_hF(self, *argsU._level = 6+ 1S?endQ)ifFJ== 0# restore the old sbuilder._ +"sinstall#)*=.E iAold_A9?End75end5Jelsej-j class Skipper(FilterCrutch__slots__ = ($Enode1ucurNode(3 @ is not ddG We're popping back out ofv! w#sring, so w # shouldn't need to do anythW ut!etU.+DN, H ! =8Q34end1 # framework docu used by3Afrag  # Takes a strd1for+doctype, subsetQ, and`space s. _FRAGMENT_BUILDER_INTERNAL_SYSTEM_ID = \ "http://xml.python.org/eDies/-2/in"iTEMPLATE_'''\ %%s ]> &A3;'''O/% %B) FBc(Expat 3""" which cosfragments given XML source text and a conanode. 9The is expected to provide information about th`namespace declar$s which ar; scope a5 start ofBfragment.2"""def __init__(self,@, ops=None):8$if#.Type == DOCUMENT_NODE.2X.originalDocu$ =GZ,D#Oelse]d.ownerukExpatBuilder.$)EQresetB+ C"0 = kTparseFileXX, fil@"""P"D a dULafrom a3 object, returningr3.0 pString(w.read()"31, s/5s"._# =|irqelf.get:5r()"Adoct . 0ident = ""fF @ubse,D.internalS"ortW_getDi_.publicIdh%('PUBLIC "%s"'( 4% (Z,.systemId),='el$r'SYSTEM- %^& ktnsattrs:!NS() # get ns-!s 's ancestorsp;q= _FRAGBUILDER_TEMPLATE % (1, s#, :tryt.j`f, True6jexcept9/)tBrais=? H ##4_u# $ LM& F Re-create` 2Dthe :'@This only needed if we don't alxQy havf9nSCas a$Ar .  s = ""  if doctype: for i in range($.notations.length)6<#$ =Z6yitem(i)k5Nif sKs = s + "\n "9 "%s' \ psystemId;elsVaSYSTEM,>'lYentitie"y3GgENTITYty $k) m#, }Lelif& f<  OfirstChild.dataBcO"%s Dl>return s pdef _getNSattrs(self-&"".external__ref_handler>, context, base, $, Oa == _FRAGMENT_BUILDER_INTERNAL_:_ID+`# this ref is the one that we made to putqsubtreeL # in; all of our given in5is parsedYhere.<old_documenttDelf. )@cur_V)jcurNodmr"_#.EwEe yPrCreate(p #@realSRback,Q intoAfrag2to  originalD2V)= B!.c9F}(3 tR l:try6(._source, TruflFrNode = old_cur_node self.document = old_-_source = NonQreturn -1:Uelse:|$ExpatBuilder.external_entity_ref_handler(=A(, context, base, systemId, publicId) class Namespaces"""Mix-in Rfor bs; adds support n?Q.""" def _init\()b# list of (prefix, uri) ns declarations. attrs arV#structed from this anded to the ele"'sE.._ns_ordered_ves = []createParserA"""Cu a new -Qing p9"v@ = e.[H(B@_sep uor=" ")=.(6Tru"P0qinstall,"""Insert=fcers onYY i2if "opk_79V.StaraRDeclH? =  .s3_dJ)' 2r"""Pushg on our storage8 .append(* ,gibutesif ' ' induri, localA_0, qA = _8luri = EMPTY_NAMESPACE w_U X[ePREFIX? = minidom.E (ku", A>v.ownerD _a_child.curNode, GU@! =~  \#inN:h= Ua4Attr(_in, 'xmlns:' +>%),r?VXMLNS}"RCI D,, f  "xmlns", EMPTY_PREFIX) a.value = uriownerDocument = self.d 0_set_attribute_node(:, a{2delK _ns_ordered_prefixes[:] [5if Q%s:Z._ensurev*s(kBs = /MsG!*NS#)NS%for i in range(0, len(Mjs), 2)@anam])9[i]Y&&.+1(`if ' 'XoMuri, local|", V0, q = _parsex(!, P 8La = minidom.Attr(I,0hDc[:]] = aj&JNS[()3Oelse  NAMESPACE,  =H2[0&;/a.^ P3Elewif __debug__a# This only adds some asserts to the originalor# end_ef_handler(), so weNdefine t_when -O is notG used. If changing one, be Rcheck@thergsee ifGqit need"beLed as well.* ?def9D `curNod#.P@d K# (.&spaceURI =Dand 8RN=_ 3;m O), \9", stack messed up! ())"? Ia - badHJ s8amek  Y self.curNode = p.parent'  self._finish_end_element(8) class ExpatBuilderNS(Namespaces,!):`p"""DocuK" b5 that supports nAQ.""" 6def reset(K}."6!0f._init(@Frag x4"""1L_getNSattrs""""Return string ofc 3ibutes from this E andHancestorsxp# XXX T5needs to be re-writtenwalk the D5the]# context/1 up3  information=adeclar$s, s, tound inm.COtherwise we havee a bunch more data on7DOMBr(thoughp*might* 7reliable -- not clear)es = ""R!= eL = []Twhilej`if hasb(E, '_ns_prefix_uri'/Bfor "X, uri8 =.items(CK# add every new NS U to LsG#ifL$6inucL.append()j exmlns:" +TOelseO !ifsIN@%s\n3%s='%s'" % (, H ^W={r]bParseEscape(Excepp5"""p raisedOshort-circuit pars in InternalSubsetExtractorDpass,(uXML processor which can rip out3i~$ datype s8v = None2getgeGt as a strinsg.""" return self.subset def parseFile(, file):>6try ExpatBuilder.=<except PbjEscapeKKpasscStrings A$sinstallr .StartDoctypeDeclHandler =o"_d r_decl_h"IElementEe@Asd name, publicId, systemId,Chas_internal_>?if ! &rs1get9r()Y = []$mDefaul.append7?End?end ;elsXraise&()P:s = ''.join).replace('\r\n', '\n' ;s 6 U", 1WattrsO (;<spaces=TruL1"""p a docu", ing the resultD"b node.['^' may be either a or an openqobject.  !if,sb8 = #NS -Qif is:3nce(st8Awith'rb') as fpr3 = rn"fp< 1  r ,& :u from a } Ri M )@Fragcontextf99 ofQgivenL8which it was originally extracted. 5`should3`parentkthe node(s)) which are in the fragment. 'file' may be either a  name or an openqobject.=1"""!if,qspaces:\builder = FuBNS(context)-Oelse756if isinstance(f, str)JAwith'rb') as fp%result = .parseFile(fp1 2ile3rreturn ,r def YString(s#, ,MS=True@"""PA of a docup from aing, giveZ7%it was originally extracted. p should1theC`parent}Rnode(s)k d-f}  ~)Cmake(optionsCreate a' based on#O. !H.Ps$SExpatx%NSzn 1/#.ython version compatibility support for minidom. This moduleains internal imple_a details and 0not im\ed; use xml._g Pead. 8 # uH1onlI using "a *". #:e followUdefined:% NodeList -- lightest possible# AUEmptyFA that is guaranteed to #| remain e^ (immutab3" aTypes Ptuplel t#defproperty5Afuncui$njGetattrMagic;these togeqis need .Vom workFas efficiently~in both PO2.2+DAnd oLs. For exa jclass MyC(/):o9 p_get_my,_(self4 <something (2, "q/", M"q value") # #  "For Python 2.2 and newer, this will construct a #B property object on the class, which avoids@needing to override __getattr__(). ItOonlyFwork for read-( @ibutes. #6older versions of, inheritOfromCGRMagic1usetraditional; hackerybachievFsame effect,Gbut less&iciently4def() should be used@Deach? ofsrelevant $_() func. __all__ = ["NodeList", "EmptyStringTypes "] import xml.dom . = (str,) u W(list): q__slots1() def item(self3dex/3if 0 <= index < len*#'preturn D[+]^llength;7U5Gset_5w, valuewTraise .NoModificatAllowedErr("attempt`m0y+" 'y#'"$% =(6, _,osdoc="The numberarnodes i).s # backward compatibilityd_zqstate__[!, &"if is None  A= []TB:] =P T(tuplVU__addWotherFNL =)NL.extend(2,'NL%/_rcM7oneg00-9 "(k,name, doc:cget = %!("@" + 0)?R8setK, name=name):  raise xml.dom.NoModificationAllowedErr( ,"attempt to m0y read-only attribute " + repr(name))Cassert not has,(klass, "_set_4/1, \1t"expected;to find 3/pprop = erty(get, srdoc=doc8set|r,5) """Simple Ament ! of the Level 1 DOM. Namespaces and other minor)2 featur!re also supported. parse("foo.xml")String("  7NTITY_REFERENCEP) cK [ h!):\URI = None non-null @ 8/`parentjJbTownernextSiblz0previousYfix => # *NSJdef __bool__(selfdreturn True -Qtoxml*, encoding=/, standaloneJ`.toprettyG@"", ID)t3D , indent="\t", newl="\n"%if?R= io.2IO(5#Oelse1TextIOWrapper(io.BytesA Z&= 9 rrors="xmlcharrefreplace"B  newline='\n') if self.nodeType == Node.DOCUMENT_NODE:08# Can pass encoding only to document, put it into XML headerL}writexml( r, "", indH,i, standaloneJelseXB%ifc{ is NonQrreturn .getvalue(B 3detach()< def hasChild{ s()HAbool%.c+%) CV_get_*E[@ ?Qfirst ?(a _;[0]b/laa;'-1binsertBeforeQ, newQ, ref %if OFRAG for c in tuple(man'^ c'### The DOM does not clearly specify whatnhis caseM i"inV_#k_typesaise xml.dom.HierarchyRequestErr(k "%ne1be T of %s" % (reprL)!pr&))o`parent<V.-q.removep%if4WSoappendD:try?2x =o!s.(4except V^ErrorWrNotFoundHKL 1in  bs_with>renj__id_cach} d- ( 4nextSiblj= %.previous0G 0!ifbx[o20.r4*od<B None  newChild.parentNode = self ereturn* def append?(2, node):!=!if.bType =[.DOCUMENT_FRAG FNODE9=for c in tuple(D .csf-.%c) ### The DOM does not clearly specify what to his caseM  a!inN!.__1j_typesraise xml.dom.HierarchyRequestErr(g "%ne1be _ of %s" % (repr51), &))-el1in bs_with:ren_7_id_cacheZXSinJNoneJ|r.removeTV_rp0.nextSibling = q creplacr$,B, oln4q,1ref% =_  '.insertBefore(vPMk\5 isB U#4k?# ?6-  L:tryCSindexI.(except ValueErrorO NotFound![k5] =# #+#5if `C:%or=?  4previousE8 <!Y }$ E (  Mif newChild.nextSibling: newChild.".previous24 = '<return old? def removee(self,$)z6try * .cbNodes.F(_)_)except ValueErrorH raise xml.dom.NotFoundErr(C%if is not NoneU.$' ?y $} 2/ =y4 [! =?nodeType in _ qs_with_:ren>_clear_id_cache)0`parent lnormalizUxeL = []Afor k5"if). = de.TEXT_NODE159b^.data#'# empty text `; discard'Oif LI"[L[-1]X )h +$ E|*gunlink elS and n+==# collapsef" =f!2ode +7 9y))Hhk=srL.append(BQ/el62 6.ELEMENr<. 0[:]sPclonefg, deepo_'(!, ^ownerDocument orcisSupported=feature, versionqY`.implecation.hasFG(O_get_localName(self)3: 2# Overridden in Element and Attr where localName can be Non-Null Hp return!e ^!# Node interfaces from Level 3 (WD 9 April 2002)6def isSame>(self, other)l2 is?DgetIuAwfeatureC0if ?.isSupported(&,,sFelse&5NonThe "user data" functions use a diary thatnly presentm # 0ome4I has been set, socareful not to assume iEyexists.*UserData)7key?try:__[key][0]except (AibuteError, Key c/ 6>set,Ey, handlQold = " - ?%{}2 NE = d `if keyTdHd6!ifA 5# ignores passed for  0if !is&i$Bdel !@ = (36oldrV_call:_~Popera, src, dst+ ifCattr/"I"(Lkey,AlistB.@.items()GKwo[5,.()# minidom-specific API: aunlink{`parent*" =ownerDocu Felf.child6se6'a*.) <0deLy)%previousSibling*%neM$Knext !3# Ad s its own context manager,bensure_4an   occurs.Q@Thispsimilar>how a file object work20__eo,__c__exit- , lev, tbp defprL0ty(, "firstC", doc="F s node, 1.")Broperty(Node , "lastChild", doc="Last c node, or None.") defproperty(N"localNameA aspace- name of thisSJ L _append_oa(self,"): # f)path with less checks; usable by DOM builders if carefulD[@s = b.!0$x|" = A[-1]1.previousSibling = 5$ V.next 7 .() p.parenty1in_document3# return True iffG is part~a8Q treejUwhile*1notRiG.Type == .DOCUMENT_NODE04d@! =i/SFalsewrite_data( 0r,  "Wschars to (!."S!if>! =.replace("&", "&")< lt! \OB!\"-1quo/>gA()pget_eles_by_tag@_helper(,DC, rc1forN0 in7ent5ELEK and(`== "*"..rc_ [1/rc$ -ns'asURI, xG3DbUif ((s 7  )vB (n BnP0URI%)CE Csclass D@FragM3 2EFRAG|X+T = "##-fU$`Value nattributeO3,c_HA_typ3. ,B0 QB.TEX) CDATA_SECTION&2 ENTITY_REFERENCE5PROCESSING_INSTRUp Node.COMMENT_NODE, Node.NOTATION-!) .def __init__(self):I`.child?@s = List() class Attr(9 __slots__=('_name', '_valu spaceURI''_prefix4ys_localNPownerDocument1Ele)nodeType.ATTRIBUTE#attribute!nespecified = FalsV_is_i*__jA_typG C.TEX4.ENTITY_REFERENC0, q(, -=EMPTY_NAMESPACE, ]=NoneL" L0!!" =) = )# = <9}$deYi# Add the single 2 n that represents&d1 of p.append(Text()r]VR and Rare set elsewhere:6get @6tryM`qreturn X7aexceptR_ErrorB(.split(":", 1)[-1] % =8 )41set4,C ~!" ="if pis not  _clear_id_cacheo.;&operty(_4, _6]8 6" [0].data(+> S% UV WX # Y8,Vrnsuri =Gj#if6 == "xmlns"X2if G != XMLNS} 3Yraise xml.dom.|EErr(}("illegal use''1forVwrongc" self._prefix = prefix #if is None:"newName = self.local%?els3"%s:%s" % (v,F)G"ifownerElement_clear_id_cache(/Mn joperty(_get_E, _s )1def unlinkp)# This imp ation does not call the base&]# since most of thatAneeded, andHrexpense'eCbmethodqi} warranted. We duplicateIremoval ofEchildren, but0's 2we Q fromAeclass.BDelem$!1if $i1del"._attrs[0oden]H7 +1NS[.spaceURIj Cof_is_id_~v = Falss p._magicnodes -= 1*N@Docu8Zcount8Afor 2 inNb ."u 86[:]AisId9 return Tru 9doc% "!0if E}1 or$BPnfo =F.s`_info( 0if [Y X.P!NSR < PNschemaTypS x{E_no_typehA8^YgetAttribute29 \ Sdefprr0, ". ",  ="Y i0is an ID.") HMPdoc="1- name of thi&s attribute.") defproperty(Attr, "schemaType", doc="S type for thiG class NamedNodeMap(object): """The}` list H transient interface to the underlyingEdictionaries. Mutas here will change= element'sG1y. Orderingimposed artificially and does not reflectdo:1 ofGZs as found in an inputMu..2"""~__slots__ = ('_FCs', !NS cownerE)9def __init__(self,`sHNS, 7-.j" =5 $NS+NS Y) =hget_lengthreturn lenAitemw, index<2tryUM[X8S.keys())[F%]]except I]_ErrorTFNones^VL = [X"@nodewvalues(9L.append((4.E , .4%))L/NSDamespaceURIPlocal)__contains7keyif isinstance(key, str!0;key`$Oelse4&NSI'qm'9#NSr3 N;'s(v1get, name, K= 82R__C_cmpnHothe7if ?0get(*2, "e;", 01(idb) > id]V)) - <5_eqo!!X == 0C/geC>Ce >l< def __lt__(self, other): preturn b._cmp(!Q < 0 %def __getitem__Gattname_or_tupleRif isinstance(),, 0 attrsNS[;]/FelseA?@# same as setso, valuH, stU:trycnode =n(except KeyErrorIDAttrc)>n.ownerDocument|0Ele # FsetNamedItem(X n. " =1Ghif not%: , Iraise Type !("/ must be a}aing orB object" bg. ,  3 >FNone#NSUspaceURI, localONS[(I)`remove6;n01 is5 _clear_id_cache(._J9del n.(&.(&n.s =`if hasX(n, ''hn0 = nW'xml.dom.NotFoundErr()G J!NSJ Q+od]ance(node, Awttr): raise xml.dom.HierarchyRequestErr(/:"%s cannot be child of %s" % (repr(node), uself)))G`old = ._attrs.get2V.name)jif oldold.unlink()L[zH@] = x&6NS[qspaceURI,/p.localN BO.ownerElementq_clear_id_cacher*`return ?pdef setdItemNS(8.0l)L__delitem__I0attn_or_tupleU[']QB__getstate&,3$NSPs[!, ib4[ defproperty(NodeMap, "length",$doc="Number& s in the @.") AttributeLis^! class TypeInfo(object__slots__ = '"', 'Cinits%, + N"O1ameV#ffUi!lfL "<%s %r (from %r)>\o!__P__.__#__  |N5Oelse 1get~A38 % _no_type =&`None, )B(?1=('T@DocuB`parent.0tag  }prefix'0URI5_c@[s /NSQextSibling*previous*0 = ^.ELEMENT_NODE!@Valu-cschema8N`_magic:Ss = 0_}[ t PROCESSING_INSTRUCTION; 5COM, Node.TEXT_NODE, Node.CDATA_SECTION2ENTITY_REFERENCE5!) h6def __init__(self, tagName, namespaceURI=EMPTY_NAMESPACE, prefix=NonePlocalG=!!):mdp.parent0 = ! 1 = .@nodeK$ = /# = ) = )PchildsdeList()%nextSiblingprevious8# Attribute dictionaries are lazily created4a4(double-indexedN#S/&->kKu URI, (in the future: considery generaZ5of objects this is too tricky2for now because of headaches with,%s._u/ne!NS'neaensure;s"ifn#kj %{}} '{}Eget_ {:tryhcreturn7nfexcept_ErrorB .split(":", 1)[-1]( #9lunlink3L1not P in loa.values()g4.{ WON5get,A"""R!e Nspecified8.>7element's7G5 asa string. An emptyQed ifZ does notFhave such anv. Note that ^may also bo!as0xplicitly giveY' , &thA5hasr method to distinguishse two case5"""  6 wPs[att]q?Key"""vgetAttributeNS(self, namespaceURI, localName): 0if +._attrsNS is None")return ""8?try# M/[(u].valueOexcept KeyError[1"" 0 detAttribute0attn!, Z" =&ge8SNode(6)Z1if 1 = {:>!" = # also sets nodeV5ownerDocument 4hsrCelif!!= ^ iZ.isId9_clear_id_cach)Nqualifiedcprefix = _nssplit(<B /NSY@ ] nY", a:H* w   4s$#9,"0D43 !=>|#'& S%w_9 =  'TrN 1$/Hm@.getFb9. !NS/L)V,r :1Elenot in (,2raise xml.dom.Inuse|PErr("T^ already f&d"t._ensure4&s("Dold1e"s`.,01if 3it sVremovu7HJold2x{{ if old2 is not None and old2wold1:  self.removeAttributeNode(7)+d_set_a! _n"; , %) ) ifq1q q# It might have already been part of thde, in which caseg# it doesn't represent a change,ashouldbe returned.I9529setB\NS = +Kdef t(NVname)10if .{0sNSW"  raise xml.dom.NotFoundErr(:try5#lf_[}]except KeyError>s [{3 'NS spaceURI, localNh@NS[("6p D;8[[.8_clear_id_cachergunlink# Restore<@sinc e /still usefulwotherwiU"# W%ed>.ownerDocum`*lf0715hasK , c"""Checks whe the eleahas anQ with"specifiedQ.sDRs True iO!JO\,svs Falsex5"""5 F9n0ame( L[?- &NSBgetE`sByTagall descendant elements with the given tag name. qReturns%list of all descendantN(not direct childrenIVonly)qspecifiedusE """7rd _get_ _by_tagName_helper(self,, NodeList())def getE2ByT='NS8spaceURI, local]/):$ns3___repr__c"" % 4.A, idwritexml!, r, indent="", addwnewl=""@"""WEt an XML to a file-like object 4l10 that must providePa method (e.g.r or StringIOI%).9O# = currentFatio#( ="0addhigher levelsm # 2! =Qine s .(hp+"<" + ,8rattrs =wibutes((`for a_@ in $ws.keys(Pzrp" %s=\";<),_-a_data( "r,Z[.z].value5)a6\"""ifsbp ;>:qif (len.C) == 1 and2S*[0].nodeType%(15.TEXT_NODE.CDATA_SECTION)\;tt Tr, ''<Jelse6Q^ 5# P1-R ,z @ % !"%sq;  I/F#%(6 ! ._ensure_$Hpd2Map/"s, "NSshasAttrWo~> x6Tru&RFalse[ # L! 3|, based on e22 Oct 2002 draft def setIdAttribute(self, name):$(i!0 = E.get0QNode(.-$ V&E)z'NS|spaceURI, localN!NSC.#, $f is None or not4gisSame.ownerElementko raise xml.dom.NotFoundErr() if _get_containing_entrefF)}]ModificationAllowejJz._is_idS u = Truet3._magic_id_nodes += 1&@Docu4^count4`_clearUBcach) defproperty(dD, "a9s",zPdoc="edvMap of . on the e?.")a`-'dhHthis[e _set_3(,4 $) ._ensurePsJ!j s[.1] =e& %ENS[((H)AB0# Tcreates a circular reference, but s.unlink# breakscycle sinceAAs to{0dic0ari{re tossed.- $ = class Childlessp"""Mixiat makes c#-ness easy2imp2 and avoidsvM coBxity e |p methodat deal withb2ren1"""H__slots__ = (Z1s =*aPEmpty CListeQfirst7+laM7}5v"breturn 4S3aappend0 , =i ,HierarchyRequest4+CA + "PPs canEhavel"R1has6sVFalseinsertBeforQ, newF, F3!dov def removeChild(self, oldC):  raise xml.dom.NotFoundErr(#*@.nodeName + " s do not have cjaren") <def normalizexR# For3BlessO,0@) hathing to do.WFpasseireplac1newHierarchyRequest. class ProcessingInstruction(c, NodeMaType = .PROCESSING_INSTRUCTION_NODE__slots__ = ('target', 'data'__init__~", ) , 'zN# =%g1! =8w#Value is an alias for&;P_get_,zqreturn dv7s70, vo>7" =?m = property(9, _`2 `- 8w88 7writexml!, r, indent="", addwnewl=""k3.("%s%s" % (=,, , QC)) CharacterData@=('_ownerDocument','parentIpreviousSiblingDnext  e" =j!ne 4 {67U = ''O.salengthK1len.3)VQ__len+? T.8RN3P2 41' =9 ! Crepr'l 0if f) > 102dot = "..."9Oelse,)pp''SqE___.__name__;[0:10], 7dotsubstring+G, offset, countif offset < 0:  )raise xml.dom.IndexSizeErr("offset cannot be negative") A3if '>= len(self.data):%-ibeyond end of N scount < 0d3 ureturn [:+B!] def appendDataW, argG& =S +&DginsertDl LfM:arg.0"%sQ" % (n@)[]-,d&])hodeletehj+>1if Y- +T:UoreplacBt3 ) defproperty(Character, "length", doc="Lthe string.") class TextH__slots__ = ( nodeType = Node.TEXT_NODEN0Namq"#text"attributes7&ne>Qsplit, 63 or"/ >&tillegalIHvaluw0new[!__&6__(# = self.data[offsset:]  newText.ownerDocument = self3x"nextSibling "if>parentNode and1 in.`.child&%s:C0if ^ is None!IpappendCO()R?elsGinsertBeforeH,N{Ddata* [:offset]sreturn  def writexml(H,r, indent="", addnewl="")_C_w( `r, "%sR" % (=,m&Bwl))# DOM Level 3 (WD 9 April 2002%_get_whole&PL = [.cnprevious#pwhile n?not.nodeType6(".TEXT_NODE, CDATA_SECTION$"L.Q(0, n /n."=Qbreak$Fl( ''.join(L6replaceW8, content # XXX This needs to be ser6 ly changed if minidom everr # supports EntityReference >%s.*)!Z? =  s.remove5ext; $ot]Ocn"FK/if*$ =! \i'&+isWhitespaceInElementContent(self): 0if .data.strip(%return False7elem = _get_containing_e-0if  is None}_binfo =ownerDocu.rN_$( )ii?elsHJ.isE=) defproperty(Text, "isWhitespaceIn3%",doc="True iff this text node Is only wT"CGP" and!in[1ent>oent.")Pwhole"heof all logically-adjac^saE@c = .parentNodDpwhile c;notPif c.6Type == 7.ELEMENT_NODECc'vcs`ntref(y@NTITY_REFERENCE3 class Com(CharacterDataHG5COMG1!Name = "#cJ!" def __init__9 , (Z r.,a_:! =A^writexml^r, indent="", addwnewl=""if "--" in/g aise ValueError("'--'{pallowed@#a ".("%s%s" % (, , D)) DATASection7__slots__ = () <_SECTION8'"-sa`-a.find("]]>") >= 0iP]]>'  gC h1)h*sfor n i 2\$<%(nD, n.  hHRs.append(:n._call_user_data_hV(z_, n, Fe U#Py = E7y(ee$e., HHg|.actualEncoding = eq=e7 1 qversiong /f*iey?e, D(!, Jelse'*writexmlr, indent="", addwnewl=""3.(""%s PUBLIC '%s'" @ % (,wd', )$el aSYSTEM"uC`if self.inte rnalSubset is not None: qwriter.o(" [")self.inteY.'"]L`g>"+newl) class Entity(Identified, Node)attributes =nodeTypede.ENTITY_NODE BValu!1ne actualEncoding<!neetversion'(def __init__( , name, publicId, system notationx3.0Nam=Y5!D %Pchild%vdeList(g%_iRa_mixin()Jget_'qreturn c * GTA $ ;{: #9pappendC8Q, newaise xml.dom.HierarchyRequestErr(i@"can:\ wren to an 0ty "DinsertBefore_, ref4g_belowaremove}"ol/ /\Ofrom Iplac/, 9g/ofNh -Iless|NOTATION~ `<hs"amsDOMImplemenn(#LSq_featur[("core", "1.0"),. "2" C?xmld !c!bpls-loadf3%I]BhasF*_8#, P&$ifb == ""0yy(X.lower()` in self._feat:ures def createDocument(self, namespaceURI, qualifiedName, doctype):DH$ifD and .parentNode is not None:7;raise xml.dom.WrongIErr(,0""d~ object owned by another DOM tree")<`doc = "._$_d) [add_root_ele ! =( \9 8:!is3!if [m g# The specunclear what to here; SyntaxErr# would be the kobvious candidate. Since XercesWsHInvalidCharacterErr,6s;3klistedE;for0, tPseemsbetter choice.FXXX: need1`check Yillegal c s +inDPE2.M#Level III u s this up when talking about\return valuem"of=function. IfDocType arHANulllmxped witha  Oqw)or~ 6n we go back]above problems-J#("1 no"@* prefix, local = _nssplit(wa2if ; == "xml" \! S[ != "http://www.w3.org/XML/1998/,"p V5"use of 'xml'FDpt?URIv _ #cmsq =.e)NS  Kdoc.appendChild() A % Q: c;.r;t>3^2impqa"9Tdef createDocume#ntType(self, qualifiedName, publicId, systemId): doctype = DocumeI C)..S% =^ $m% =x$sreturn } # DOM Level 3 (WD 9 April 2002)%def getInterfacwfeature0if R.hasF(%X, Non+ 3Felse)&@0# i1nal6_create_dODn() class EleInfo(object6A"""O$ that represents content-model information for an eT.This imp)is not expected to be used in practice;builders should provideW s which do the right thingEYusingavailable#it2"""__slots__ = 'tag"',uq_init__mX, nam.6! =;getAttributeDaD@_no_0@'NSspaceURI, localOT#is CR9VFalse|isEmpty-A"""Ros true iffs is declar@have<QEMPTYk k. !Id,, Ke4d aa DTD-style IDwQidentC,p__getst:__s9!, G@9ef! clear_id_cache(nod0if . == Node.DOCUMENT_NODE(.J.Y(search_stack S!ne<elif _in3d.ownero -}|UT(,#LSY0('_0_HC', '!','v0Pchildhs"~'.__BAs = E.ELEy de.PROCESSING_INSTRUCTION  Node.COMMENT_NODE, ADOCUATYPE0) 1implementation = DOMI!())nodeType =Rf"0Nam"`"#docuW"@ValuANoneattributesT`parent reviousSibling = nextU3# D| bfrom Level 3 (WD 9 April 2002 actualEncoddV&estandalonBversI=strictErrorCheck\BFalsexHandlerC4URI8_magic_id_count = 0def __init__(self):1T.doctoPchildwcdeList%`# mappof (namespaceURI, localb) -> EQEInfo#Cpand tag-,_elem_info = {}I0achzsearch_stack;"6get^( , n7ent1$if.R_key =(S.OelseH  0rreturn .get(key L *D",@ #9?URI= ' Am> $ ;K? ( CA & ? H / QQE #9pappendC8 , !if.Tnot ic __/sraise xml.dom.HiermpyReques(#p"%s cane1be _ of %s" % (repr(n1), "))w?0is Nd @# Theeds to be dbefore the: test sinc)isay *be*0,*which case it shouldEend up re-orderedIend.,.r.remove Type == Node.ELEMENT_NODE \  and self._get_documentEle8():, raise xml.dom.HierarchyRequestErr(/fT"two W" eXs disallowed")4 return Node.appendChild(, node) -def remove!"ol0:tryK .cVf"s.F(;_except ValueErrorH NotFoundU.nextSibling = previousENone(Parent9 = #"if`5 isf  .Uys#Sr1for2 inm !if(.`Type =Gde.E 36aunlink(taais notB X@.doc&.Lv" 6(Pclone j, deep  L" =U2impJation.createD(8,Eb.encod'`standaw +tversion(%*{A = _ _"(n:!, vassert <d.owner b.isSam>w(O n(ifj EDOCUh Spk41/elqATYPEvnr ' =  (.p?*] _call_user_data_handler(FUserDataH._CLONED,Jg CH5 )AFragBDd = A$ dcdzdv wtagNamevDe = $UetetateTextNode(self, data): if not isinstance(!W, str&-raise TypeError("node contents must be a;Uing")dt = Text(.g! =).ownerDocumen7return t def createCDATASection(2bIc = ccc om!b\ nProcessingInstruemtargetmOp = 7 1YppAttribute WqName@a = $(oao a.value = ""4za0Ele#NSnamespaceURI, qualifiedprefix, local = _nssplit(5n #*, u]e e:^P1 .,, /# A couple of impaS-specific helpers toz Qtypes#M supported by the W3C DOM I&s:k_w_entityD, publicId, system 1not3B <{ Sn = N(nnL3get CById'idif id in #._id_cache  #E[id]42b._elem_info orYQmagic_Gount`3Nonssstack =@id_search_y@ is @ # we neve>efore, or the cache has been cleared  stack = [self.documentEle]+"_id_search_;*elif not :t# Previous D was completed andis still valid;Fno matching node. return None result =_whileV" =e.pop()J8# add child e,Bs to0 for continued9ingB.extend([J8T"inYNodes="if.Type in _ qs_with_JLren]check thiss h@info@get__(_ K0if  0# W ve" process all ID attributeIfore>in orderI1getE8theFoset toFbe IDs usIt.setIdA:*()JU. .values():!if.namespaceURI*.?.isIdNS(f :,MlocalNameuK[O>] =22o == id9rc' &$*p._magicsi_breakaYGE-)'%!A O_is_ ,de 1. ^NI/l`  result = node C if is not None:#/Ubreakcreturn9 def getElementsByTagName(self, name)WAc_get_e3R_by_t5w_helper<, NodeList())r 'NS8spaceURI, local$ns _isSupportedfeature, versionhB.imp!ation.hasF9(A imk3mg, deepg!if.qType ==g.DOCUMENT_NODEraise xml.dom.NotErr("canEP docug5s")F/el|OTYPE6t`clone_(( , lwritexmlRr, indent="", addAnewlencoding=[,N`standa"adeclarbs = []64if X 4.append(f',4="{ 6}"'6if  ]:="{"yes"W else "no"tC.(f'{`#}'1fori1 in`.childs#v , ca# DOM Level 3 (WD 9 April 2002% rev)n+  t.ownerD/ ~TWrong5Zs from other^s;\n">expected %s,\nfoun D" % )QnY0n (E.ELE]..ATTRIBUT sk() only applies to n and attribute4ame != EMPTY_NAMESPAC`if ':'y gprefixame.split(':', 1=3bif ( =n"xmlns, and namespaceURI != xml.dom.XMLNS_NAMESPACE): Uraise4NamespaceErr(0C"illegal use of 'xmlns' prefix")9Nelse{if ( name == "A"8i1and*/UR B .nodeTyprNode.ATTRIBUTE_NOD!I5the%attribute(A} = NonePlocal! =!cIE fOif n# pelementr.ownerE4if (ais not I(As_idK _i E!F.removeAF&(ns 9 V%n.% r8n._& !&?odekqELEMENT _n.tagI%# ` C n.e*am_LO.setj1if  J/IdLR# It'7$clear from a semantic perspective whether we shouldp# call user data handlers for0_RE2@D evFsinc*# we're re-using6Pexist o. The draft has beeninterpreted as mean@"no, don't unless aF1new is created.B return n defproperty(DocuC, "d %",[doc="Top-levelof this =A.") b _clone_(, deep, newOz"""C6" ag!itZXpCalled by .z  Aip.import5r|Y-PsSame-(Ffation fUserDataHN.EaCLONEDx BcIMPORTDY ELEMENT_NODE:  clone = newOwnerDocument.createEleNS(node.namespaceURI, ADodeName)@for attr in # ibutes.values():.q.setAttr*0NS(6 V.Sq,R}OBa = SgSWPlocalX L.specified =r zif deepUchild ZNodes*Qc = __(,,W, ?.appendCu2(c)BelifXType == .DOCUMENT_FRAG FNODEN]@FragW(_TEXT_@TextLQBdatavCDATA_SECTIONn;SectionrPROCESSING_INSTRU{ ProcessingInstruotargetA .@/OM1ComgATTRIBUTEme,   ETrue !for f, v in"if not Docu).iR.hasF(H AQ !0;sax .handler START_ELEMENT = "X" ENDT" COM6 "PDDOCUQRqS " PROCESSING_INSTRUCTION(" IGNORABLE_WHITESPACE0" CHARACTERS$" class PullDOM(9.ContentH1_locator =def __init__(self, (xFactoryrXML_NAMX*O.Nb` /firstEvent = [L,]'&la&g8 )ePStackR Hqpush = C+u.appendL6try?pop=5pop:except AttributeErrorLa# use  ' T &ea~qEpassUP_ns_c0xts{:'xml'}] # %ains uri -> prefix dictStcurrentXk<[-1Eending_e!] !opXPresulw \>del "bPs4setuL#, -"LQtartP1AMappM&E,TPEshasattrw'_xmlns_s'): self._xmlns_attrs = [] s.append((prefix or '>', uri));ns_contexts;Ttcurrentm.copy(? &[uri] = }QNone tdef endPMapping(l,/!):(+._]2 = Vpop()astartElementNS_name, tagName , Hn# Retrieve xml /space declaration5uibutes.Y_uri = 'http://www.w3.org/2000/$+/'4` = get '0', = ifais not$9=Pfor a, value in9 -1"s._![(,F)I5-A uri, local! =VA if # When using.s, the reader may5notO# provide us with8rorigina@. If4, create@0*a*1%id+AfromG +z%if1/is$P]7 4#if (nv+ ":" +v ROelseM  >"if|@docu\FDnode&.hUcbuildD(JFVD1tag9ed, it just ;iars as#R1(o+*pY w.items(.a_" = 1if *3 ==[>uri'J=+}q6= a~ v$>O:' +I AAttr1NS(!, ] tF.set20ode6:ttr.!el '_current_context[a_uri] if prefix:*sqname =$ + ":" + a_local 7OelseM > attr = self.document.createAttributeNS(!, )node.set2!od6:ttr.( T8(X ,P.value lastEvent[1] = [(START_ELEMENT, iv), None :OK eQpush(J~def endEle0NS(Q , , tagName).^6END#_pop()!Sstart Hs*ifC e]'.CcbuildD(,)NrPfor aT,A in w.items(.] (O8 N c) v_kA0com\2CS ?COM0eTisfpending_6@s.ap(processingInstructionAtarget, data&Pl fPROCESSING_INSTRUCTIONVGt&x }ignorableWhitespace(self, chars): pnode =  .document.createTextNode(43,lastEvent[1] = [(IGNORABLE_WHITESPACE, _), None]A~R ,1defoactersMCHARACTERS0cstartDPt*ifpFactory is)import xml.dom.minidom M=3.`.impleVationlTbuild&, uri, tagname# Can't do that in , since we need theF# XXX: obtain xEType#?  7(q)G !! = }START_DOCUMENT'Ppush(# Put everything2have seen so far inth$e Qfor e~elf.pending_esHf e[0][0] == PROCESSING_INSTRUCTION2_,target,data =C}!nProcessingInstruco(Q RHO = (:, n39eli0COM0Com (x:[1]^Z.seoraise AsserError("Unknown Qnt ",}0}2  "g! =^#areturn .firstChild*en ^ W[(END1$Vpop()qQclearwk" ): Explicitly release par^ ]Uures" q class rHandlerkqwarningp, excepfprint(m;es998Qfatalv =1DOMfStream__init__(self, st ream, parser, bufsize): pself.st'2 = <# =E Q$ =[if not hasattr(hK, 'feed'"getEvente_slurpU$reset() Bdef S.pulldom = PullDOM()6p# This contqhandler relies on namespace support;\T.setFeature(xml.sax.K".f_IFs, 1 FCH1__getitem__#W, pos im warnings. ( A"DOMuS7's e method ignores 'pos' ameter. "LUse iterator protocol instead.",.DeprecationW stacklevel=29A$rc'7Vif rcreturn rcLraise IndexErrorTc__nexte`t5QStopI(8ionw=w3-expandNode 8nodeJ#parents = [:]awhile ? Btoken, cur_2" =%9f&if 0is ( E% 8_ != END_ELEMENT<[-1].appendChild(!j2if W== STARTYUP(elR 0del*d ]%1# ucrementalP interface, so we get the desiredY # f effecm6R.firs:[1] (#la'a7domA~[ Ck4bufXQ.read. `:bufu2g.close2 U None<F(bufzV[1][0_I$4[1]C1C&rc+(self): $""" Fallback replacement for getEvent() using the standard SAX2 interface, which means we slurp>PSAX e`s;o memory (no performance gain, but{ we are compatible to all parsers).35""" Rself.#(zstream)'1 = %F_emigreturn1() @Adef +[!):9pPthat ls;?4the3"_Z() read previously$rcpulldom.firse[1][0]m&C 1C&rc_clear): Explicitly release|~objectsD2del"f = Non` classV2DOM(PullDOM):qstartEl7!NS, name, tagName , attrsH.=<tcurNodeezwStack[-oparent+2+.appendChild(j 1r`procesInstructiontarget, data;n$la}?0][+ fignorableWhitespace?cha2 koacters )c default_bufsiz(2 ** 14) - 20 ""e(_or_string, r=C4if Y!isw= default_bufsize if isinstance(stream_or_string, str):*.  = open.Q'rb').Oelse8Aa,if not parser5 = xml.sax.make_(freturn DOMEventS,Q, bufsize) defS*US=Nonefrom io import 01IO QB = l2ingUbuf =.`=?buf """Implementation of the$ Level 3 'LS-Load' feature.""" Dcopy {Qdom .NodeFilter  __all__ = ["DOMBuilder", EntityResolv InputSource"] class OpsB"""Fs object that has variables set for each|Tnuses an 92is @to psettings to \YExpatN.V8b# Note1^0in Save constrains which1eseT# values can be]usingQnamespaces = 1Tq_declar92TruvQvalidc = Falexternalameter_ei]>'general% pdtd_sub%= De_if_schema datatype_normalizbcreatey_ref_nodBwhitFR_in_ep_content cA_sec  om g cht_overrides_xm.0codXBinfo"0supqed_medies_onlyerrorHandler = f@XACTION_REPLACEAPPEND_AS_CHILDREN = 2"INSERT_AFTER = 3PBEFOR[4_legal_a(L#, ~,_ 1F)~__init__(selflV2._o$ =(;3get? FM def _set_entityResolver(self, entitC): .+ =/ .def _get_errorHandl_Orreturn V(BsB(, UP IXYOfilt "6* 2 = setFeature@name, stateE"ifsupports4.';" =C and 1 or 0!6trysettings=Telf._0[(_ip_xform( )]Wexcept KeyEecraise xml.dom.NotSiedErr(L3"unBed f,: %r" % ,)) from NoneCNelse@for , value ip-bsetatt ._options,D)ws AFoun"unknown" + repr'))''=?has _OcanSokey = p;l[# This dic\ary maps(,) to a list ofw2# ("pairs that should be set on the O object.E\If a mp is not+ts, it isD$!byoDOMBuilderk-]A = {k ("space_declaras", 0): [)-%],,U1U)1)UQvalid ! =external_general_D/ie0 [[ +parameter2- 2 _e_if_schema ("va lidate_if_schema", 0)], P("cre"entity_ref_nodes)5: [*1. W/1)W1i" K   9whitespace_in_element_contentR4cc dcdata_section % E% E omB9x9 harset_overrides_xml_encodingc5 0 5 eeinfosevj3namvdeclara D/vaa 'd ,^,0) 1#type_normalizM", 1N 9 supported_mediaos_onlyg0 ; !=! ^A!} ,def getFeature(self, o!): }x@ = _p_xform( )"6try/3`returnZAattrWA._op!, Q>except AttributeErrorP!ifT == "+ "va0 = q$(0. 7;Rand o. Bcomments  and options.charset_overrides_xml_encoding ?CTnot (Hnamespace_declara_@D%orvalidate_if_schema?0cre=entity_ref_nodesD=i5cdata_sec)))rraise xml.dom.NotFoundErr("feature %s Kknown" % repr(P1)) LPdef pURI(self, uri):F0if .yResolver $onput =)".r2E;R(NonebaOelseO2DOM7v/()Obreturn (i s = copy.*#._t.filter%errorHandl+1Qfp = .byteStreamif fp is H )asystemIdmport urllib.requestN"p .urlopen9.Zc_d_sD(fp,w uWithContextV,0, cO1, a }ir_legal_s`ValueEt ("!a 3a"CNotImplementeAor("Haven't written this yet..."/",  ixexpatbuilder% ='b.makeB3&C.RFile(@) _b_xforma.loweruplace('-', '_'Cnclass cobject__slots__ = '_UFer',z 9publicId, zeassert <source =IS("".j4 = Eb #%`elf._g1pen=(# determine the 1 ifQtransprovided i5}_guess_mediaj(-|base URIPewe canposixpath, urllib.pcarse parts = urllib.pA.url (systemId)0scheme, netloc, path rams, query, fragment = `> # XXX should we check the X here as well?7!ifh and not .endswith("/"):,|@osix .dirname( {) + "/"1 Bsource.baseURIQ"unS%) =rreturn @def _get_opener(self:tryCCelf.4_except AttributeError?_82 = ccreateN(_pq :Ndimportnqrequest<Yf.build.jguess_media_encoding-,Oy0nfoyteStream.infoif "Content-Type" in $ 40for$am.getplist(u`ram.sto chl,t=1f!pa9plit("=", 1)[1].lower() class DOMInputSs(object__slots__ = ('b@', 'RacterstringData',m'j+publicId , 'q_init__U!.f = Non $/ &>Fset_>&, ? ' N FVJ + H+, Y , =1 `O& >g, dataD%! =! 3C=$ :$, D% =# I?$ :, publicId):  self.publicId = def _get_systemId(0!):!preturn .$:s:$, %D =% =# baseURI # 8\, uri{! = class DOMBuilderFilter"""Element f which can be used to tailor construction ofaZ instance.2"""# There's really no need for this ;Zcrete impaesO# should just" the end() and start@methods as appropriate. Usingmakes it easyConly@p one of{"m.FILTER_ACCEPT = 14PREJEC2SKIP = 3qINTERRUC4ZwhatToShow = Node.SHOW_ALL&/&?`acceptb:2, eCFzContainerJ!7del0ocu%LSPMixincreate d#`s thatO@form!%load/save spec.async_ = False# 00g, flag6!ifgraise xml.dom.NotSupportedErr('"`uhronous is not sD&")\abort0# W*"do1meaP"clear" ac@? D%5the#j disappear?%DNotIop"haven'gured out eans yet tgrwritten^X3XML[gsource^,^8nod]@if s is None.=b$el5s.ownerDC:elfGuTWrong5v)[3.toxml()%OMMODE_SYNCHRONOUSA2mode, schemaTyp.chemaType is not None: raise xml.dom.NotSupportedErr(+6"schemaType QTyet s2%")0if mode == self.MODE_SYNCHRONOUSeturn DOMBuilder(J AKasynchronous b~Bs ar2ValueError("unknown vA for1") def createDOMWriter()SNotImplemenoa"the wB interface hasn't beenten yet!InputSource%r) # # ETree # $Id:Include.py 3375 2008-02-13 08:05:08Z fredrik $Mlimited xi<A:eja trees/history: #]3-08-15 fl WdR11-14fixed default loaderNCopyright (c)Q2004 by FLundh. All +s reserved.D@pythonware.com # http://www.O # -0d # The} toolkit i/ P1999- By obtaining, us and/or copying this soft its # associa@docuation, you agree thathave read, understood,Fnd will comply with afollow@erms|` condid!s:Permission to use,,Aify,5distribut o # itsany purposePqout feew hereby gra, providedQaboveS=ice appears in Bpies;!bo/at=naEis p* #Z4 in_H aA!atn name of # Secret Labs AB or `author_0 bejd]padverti:)publicity #[!ofSVQspecific,G@riorMSECRET LABS$AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARDK O THIS SOFTWARE, INCLUDING9xIMPLIEDAOF MERCHANT- # ABILITY FITNESS. IN NO EVENT SH 'OR # BE LIABLE FOR ANY SPECIALDIRECT OR CONSEQUENTIAL DAMAGESUANY #WHATSOEVER RESULTING F)ROM LOSS OF USE, DATA OR PROFITS, # WHETHER IN AN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS #3, ARISING OUT@OSRCONNETWITH THEIPERFORMANCE #2THIS SOFTWARE. # -0" # Licensed to PSF under a Contributor AgreementySee https://www.python.org/psf/lPR for ing details. ##umited XInclude support6athe ElpTree package.;1 im(copy from . 3urllib.parse%urljoin XINCLUDE = "{!w3T2001/&}"0_8CB+ "i"X_FALLBACK = )fallback"|For security reasons, Psion depth is li4pto this0d-only value by default. DEFAULT_MAXSION_DEPTH = 6 aFatal lde error. class Eq(Syntax ): pass 1LRIsive< N BD loader. TDs and resource `disk. \@param href R$referencF "Pmode. Either "xml" or "text"4PencodOptional " g(UTF-8G)Hreturn The expandeQ. If@is #yi ` instaC"D` UnicoVtringvf, it can BNoneor raise!OSQ excetthrows ^xd. def_ 0er(!, ,s=N"if2 ==2with openF'rb') as file'+hdata =D(+).getroot()7els?eif not X%1= '''Bs'9 S.readEpudirectives:pelem RoV If omitted8k{@link}{Qgiven8should be a callabluP thats9same interface3|?. # @param b)ase_url The base URL of the original file, to resolve # relative include( references. # @param max_depthimaximum numberoerecursLAsion?grLimitedAduce@risk:malicious content exploBAPass a negPvalueObdisablPlfPation7@throws |RIrError I'f{@link} was exceededN_FatalC@func{` failsSua givenrsource, or iAtreeains malformed Xi elementP)IOSload }wqreturns0nod' its replack!it&an.T def1( , ler=None, E=DEFAULT_MAX_INCLUSION_DEPTH):4&if@ is ]NJQ = -11)el36< 0/praise V77p("expecEnon-Y!orne for 'j', got %r" %!) }if hasattr'getroot'-! =.$()?D= default_w_fu,, set()) 9_parent_hrefsa# look"xA = 0 while i < lenD1[i]-if e.tag == X"DE%&DE*# process PdirecO)jw (""y%if c0 = urljoin(f ,  HVparsej~", "xmlrxUrm * +("@f %sJ H(==Iqa (8"B]reached whene2ing _.add(# =$!,  1if . |uacannotc %r asR p node = copy.(.) # FIXME: this makes little sense with recursive includes _Y, loader, href, max_depth - 1, _parent_.s)K.remove(,+if e.tail:F1 =  or "") +< ;elem[i] = A elif parse == "text"|# =,5, e.get("encoding")A~is None_raise FatalIiError()q"cannot %r as %r" % ?| /+=dOif it2 = ?-1]%~ 9?elsNm.4) ) O3delcontinue5"unknownO@ typC xi: tag (%r) AgXINCLUDE_FALLBACK"xi:fallbackmust be child of reobase_urlsoi += 1 # # ElementTree # $Id:Path.py 3375 2008-02-13 08:05:08Z fredrik $J limited xpath support for*ent trees,history: #Z3-05-23 fl created8YaddedYe// etc+B8-27+Qfixed)0ingwperiods in0namr7-09-10<new selection engin2200'2'c0"or(iterfind; changed all to return a listCC11-3CTpaces+ +nvalue filter~Copyright (c)3-2009 by FLundh. All +s reserved.D@pythonware.com # http://www.O # -0d # The toolkit i_Copyright (c)! 1999-2009 by Fredrik Lundh # # By obtaining, usand/or copying this software its # associated documentation, you agree thathave read, understood,Fnd will comply with the follow@erms|` condid!s:Permission to use,, modify,5distribut o # its for any purposout fee i  hereby granted, providedQaboveright notice appears in Bpies;!bo/at=naEis p* #Z in supportH aA!atn name of # Secret Labs AB or `author_0 bejd]padverti:)publicity #[!ofSVQspecific, writtePpriorM.SECRET LABSBAND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING9xIMPLIEDAOF MERCHANT- # ABILITY FITNESS. IN NO EVENT SH 'OR,E LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGESUANY #WHATSOEVER RESULTING FROM LOSS OF USE, DATA=pPROFITSpWHETHERAN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS3`, ARISv0OUT@OSQCONNE!!USIPERFORMANCE #2 _. # -0 # LicensRo PSFb a Con$@or AySee https://www.python.org/psf/lP( ietails. #hPImpleQ ultr XPath@. TK's usually no4 so Pto immodule directly;SBEkTree does2Pfor #, if needed. X re xpath_tokenizer_re = re.ile( r"(" '[^']*'|\"[^\"]*\"|%:: 5//? F\.\. 5(\) %!= [/.*:\[\]\(\)@=]%((?:\{[^}]+\})?[^/'f!=\s]++2\s+{) def (pattern, spaces=None):default_' =*.get('')L2ame@` else EC0par2_at^MQFalse]jK _re.findallttype, tag = CQ if tag and tag[0] != "{": if ":" in tag&prefix, uri =#.split(":", 1)K0>tryEif not namespaces'+raise KeyErrorc# yield ttype, "{%s}%s" % (`[]eexceptfaSyntax"("V1 %rPfound=0map) from Noneelif default_A andTparsing_attribute V, ?elsSIoken v = FalsPL == '@' def get_parent_map(context)3 = .6if 1 is?=6( =1A= {}H-Pfor p6root.iter(&*e*pk0[e]n`greturn{_is_wildcard_tag(tagm31:3]8p{*}' orB[-2:$}*N@_pre I_isinstance, _str = "stz ifYi&*'# Same as '*', but no comments`proces lructions.# It can be a surpr@thatU includes thosedPthere'noHjustificab '{*}*' doing the same{idselectat, resuliL@elem! 7if P(/B.tagY(%+2tagj}i1Any!is'Fin aOD el70 =  1C''{AG[xQ# ThePny (o)bsuffix[P # '}w'no_ns = slice(-len(7!),<AzE[3:]@M:1t %l _tag, _str) and el_tag[no_ns] == suffix: yield elemPelif >1-2:<F'}*':P# Any in the given namespace.Eg@ns =)W[:-1] _only = slice(None, len(ns))' def select(context, result)f1for! $! =)E.taggif _isinstance(1, _str) anRs.nsjL P&se)raise RuntimeError(f"internal parser e, got {tag}"creturn0 $prepare_child(n(Stoken'0tag[_wildcardC(tag1yD = _c1tag(=+ )rv(dAfrom ' \(el!:27'{}cV0ag[$ # '{}tag'k' $T@if e?tag%-Be 2 XOstarW0lem   ?elf%k descendants6tryn0 = |(Mxcept StopIteration1h0i6"*"'d1"*"*Anot o<[0]) tbSyntaxs"invalid 1") iyv(o.iter(l3@ is ^1Z J8rd def select(context, result): for elem in! +$!).iter(tagI)if e is notYO&qyield ecreturn def prepare_Ant(nStokenz% # FIXME: raise error if ..applied at toplevel?y_map = getU)-]U = {}<`/p42 = h[]i#if$2W1[]r] = Non")| redicateeplace with realser!!! refs# http://effbot.org/zone/simple-ator-parser.htm8javascript.crockford.com/tdop4l5signature = [bprwhile 1#6try 0 = (+except StopIteration9TH1if [0] == "]"/]break.+s('', ''1L# ignore whitespac26inu5and@[:1]K"'\"v = "'",0B1:-1Qh.append(5for "-"3 *"1]#Iqu".join(#e# use  to determinekB typ'if-u'@-# [@attribute]@0key6[; $?.get(key)z %.<o}%m='" or?!='='value']80!/D LCMK1== J_negated*(@if (m_1 :=Xe and attr_value != v ?: yield elem return select_negated if '!=' in signature else)?'if"== "-" and not re.match(r"\-?\d+$", predicate[0])q# [tag]TYtag =-3def(context, resultPD1for!p !if#.find(tag) isNNone/3A  {.='" or.#.!(6_(qT% <)8z+a# [.='2 ']  !!"= &-1jif tagn0(1all },if "".join(e.iterr_()) =g ?.UbreakJ 5 #  q  "p 8?lem@ < ?-()V-()-"# [indexhlast() -) gMuQ3Fy = int(J - 1*"f -6< 0D!raise SyntaxError("XPath position >= 1 expected")if"s wror("unsupported function") if signature == "-()-":$/>tryindex = int(predicate[2]) - 1Gexcept ValueErrorUraise Syntax'("unsuppo~express"f O> -2_XPath offset from last() must be negative@Nelsee6= - def select(context, result)@parent_map = get_: for elem inR Q]2 = w[M]G# FIXME: what if theor is "*" ?;Us = list(m.findall(Z.tag)r!if!s[W]h2-Qyield4  (I[Q, Key JEpassHcreturninvalid `") op{40"":r_child,*Cstar.4elfL#nt'//2descenda[: } _cache = {} class _S2orCzr2q = None__init__(sH roo.! =_ # -0 ## # Generate all matching objects. @iter}z, path, namespaces=# compilqpattern!if>Q[-1:]@/=X[Ath +# implicit(Okeep this?) W_key = (G,'if/+= tuple(s+(.items())c Ror = [S 8+{rif len(6v) > 100r.clear(:.:19 Xcannot use absolute~1 on7ent@nextPter(xD_tokenizerSKP)).__1!__ !?0 = (`StopIt{:ion5Ym[^^ whe1: *@.append(ops[P[0]](, token))  except StopIteration: raise SyntaxError("invalid path") from None<>tryMtoken = next()0q1if "[0] == "/"C(%GUbreakq_cache[_key] = selector%# executeAternresult = [elem]`contex#_SKC(%3forR3 in &orY(U", Ecreturn ## # Find first matching object. def find,h, namespaces=)\Oiter7!),)@n op}/alDQafterJe#agfAnd a ?cchild .s stored in a Py*thon sequence. To create an element instance, use the Econstructor, or4Sub fay functioncYou can alsoQTree class to wrapkure and convert it-from XML. """ #-1 # Licensedi PSF under a Contributor Agre0. # See https://www.pyk.org/psf/lPR for ing details. # #c# # Copyright (c) 1999-2008 by Fredrik Lundh. All +s reservedRf)@ware.com # A4T5 toolkit is-By obtainingand/or copyKthis soft.its # associated docuap, you aQ thathave read,`stood,Fnd will comply withafollow@erms| did!s:PermissionQAuse,, modify,52dis\s o # itsXany purposthout feew hereby granted, providQaboveQ notice appears in Bpies;!bo/at=1nd p* #Z in supportH eqname ofrcret Labs AB`author_0 bend] ad9 is^or publicity # per[!ofVQspecific, writte0priYSECRET LABSBAND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING9xIMPLIEDAOF MERCHANT- # ABILITY FITNESS. IN NO EVENT SH 'OR0 # BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGESUANY #WHATSOEVER RESULTING FROM LOSS OF USE, DATA=pPROFITSpWHETHERAN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS3`, ARISv0OUT@OSQCONNE!!USIPERFORMANCE #2 >2 __all__ = [ # symbols@"Com"",Ddump ", "ElementTree",  "fromstring",qlist", $`indent diselem terparse( 0 "PTError PI?ProcessingInstruction#EQNamKDSubEj&to TreeBuildeutVERSIONa0XMLWXMLIDrDPullxregister_namespaccanonicalize?C14NWriterTarge?3]  = "1.3.0" import sys $re uwarning$ioQcolle6F.abc*ntextlib 3 . sXPath class q(Syntax "):`""An e` when ing an XML docu!. /pIn addi to its excepvalue, ar contains>two extra attributes`'code' - the specificc#K'A'pos'1line and column ofH1"""?pass # -0u def ?(GbReturn True if *!* appearsKb .r:0has2Z, 'tag')7L"hRThis !isreference?a9W interfaceJ2/'s length is`numberz3subs. That means1you@wantPcheck3an 5Q truly empty, you should /ABOTHF1ANDe5The^Ftag,! ,<i s can be eitherqbytes or s`Q*tag*iZB. *WAan o2Qal di4ary+1inge9+1. *>U* are%al+ given axkeyword argExample form<WCH...tailO3a= None7"""m!'s` 1D #'sE CText before first !. #is# as.M`Note tiL re0no ~0, tS{ute may*\p, dependj!ony#erK?ailRafterelement's end ta>g, but before the next sibling element's start tag. This is either a str2!orFvalue None. Not\Pat if!reOwas no text, tPattribute may be ^H or an emptym,Gadepend|n^ parser. 2""" def __init__(self,", t={}, **extra)::if not isinstance(/g, dict)-raise TypeError(",@ musb3,Pu%s" % (g>1.__class__.__name__,))-`.tag = Ab = {** }*_children = []#Crepr#return "<%s %r at %#x> qtag, ids&))iCmake_ y"""Create a newQ withsame typeIP*tag*a+ contain'z _.4:oionary>cGutes|!DoBcallmethod, usbe SubEX factory function h7eadOXq(b`AcopyY LR of currentVxczsphallow 9.B`s willesharedUoriginal tre0war s. "i.w ()deprecated. Use))B"7D7BionWm_ dgopy__(X __m!~" = ,u7.< 5ail9ail3[:]<o^__len,1len,. Nbool<?ingThe behaviorh 1change in future versions. """specific ' )'' 'o' testFl,cklevel=2t vw8) != 0 # emul4oldur, for nowsgetitemJw, index h[& sH,Q(ifI, slice):  for elt in element: self._assert_is_)U(elt)-Jelse;7h;)children[index] = ddef __delitem__(5!, ,)x@del +._OEcappend@3subE"""Add ** to the end of this.[/tThe new` will p ara@docub order afterVlast existingN (or directly8text, if it'sJffirst :%),Obut before*@tag 5""">Uk ,.qk26extss from a sequence*DG* is# with zero or m*># sk - Y) ini, I, at position *@(*.(U (q7, e`# NeedU0ref^actual Python impaP, notg# shadowing C..&!if9isinstance(e, _EZ7_Pyraise TypeError('expected an 6%s' % type(e).__name__cremove(CA"""R%` match(RUnlikfind methods, compares based on dentity, NOT ON Pvaluecontents. To yEs byJother meane easiest wayzto use a list`rehens%toGselect what5skeep, andnKslice assignEcUpdateNnMDVd;a|a could6be foundHJ#Pert i(D.W(1/`path, Sspaces=NonA@"""F >~1 by@N. *path* is a string haveither an element tag oXPath, *namespacesKn optional mappOUfrom ( prefix to full%. QReturn the first matchG,None if nowas foundM5"""YrYE.find(self, p)@def &Itext*default=,8%):v"""Find AO for1 byd&*`(H`Pvalue!ifwh Q2notUPext contpow %ifnn  Note that-i,!noI,Dmptyx2is /eiC> v9all2g alw13subs`Rca 3Rs lis0ain  qin docuWorder@l@iterable yieldBcqQclear ~TReset% Th0unc removes [7!, Wattributes, and sets1PVtail /c(~...o%()W_children = []t!= (w = k$gekey, default=None):   """Get element attribute. ! Equival#to".get, but some impA ations may handle this aMbit more efficiently. *key* is wha to look for, andH*default5to return if theute was not foundR0s a string contain Bvalue, orZ|5 if9m5""".Rself.:Qc(key, ])def set(+!, !%):MO"""S [key] = Or s6 ~qset it toKD ?Akeys@ 4wlist of+WnameskNC are]ed in an arbitrary order, just likeordinary3Python dict.S|r ./&Oitem 1s ahequencT:s )Qt4 a |(s,i) tupl aAiter, tag=NoneCreate tree -Gator|bps oveGnd all subs@docuFU52with a match7tagIstructure"modified duion, newfremove,r!orbe included. To get @ablev@, usep() func1 on65`result=A*tag@tags# ( B,Vn5_khAag == "*"it V.!is*= BQyieldB@for ._children8pfrom e.qC(tagBrtex+ext iteratorC.  The iterator loops over the element and all subs in docu Lorder, returning50innO7extv5"""6tag = self.tag if not isinstance(tag, str)7!is$UNone:9ta5extJif t7fyield "Pfor e+pfrom e.Aetext()]wie.tailx-| def SubE~(parent, attrib={}, **extra)E"""S factory which creates anU,Lappends i!to+@xist0ute namesQvalues can be either byor UnicodeCingsh*vA* ise, *tag2, *)"nan optional direacontai8 utaR* areE3ddiD' given as keyword arg4S = {*}`"= S.makeCf$('- S0Com(=3:1?This funcM special6m9dard serializs0an XML cm*# a ]07d4 = ?.e0 = z1ProcessingInstru`(targe;extG1 2 V\X p ', ,0str >ents, if anyDCR'ex  + " " +_PI =  class QNams"""Qualified0 wrr6qused to(" aL 2uO)"geaproperespace handon outpuct_or_uritring containing the QName value either in form {uri}local, or iftag argument is given,URI part of ab!. KP*tag*.an optionalFPwhich`Lwill makeVQfirstFw (text_or_uri) be interpreted as a URI, and thisjQ(tag)L5S name1"""-def __init__(self, , tag=None):/=.&ag4 = "{%s}%s" % N4n.9( =th3strureturn >0?rep1'<%s %r>'>__class__.__6__,WOhash:7#le50, oif isinstance(,W%% 2 <=Mn' "lqj(&gA>'A> &/eq8@='_ # -01 e@ EleXBTree;"""An XML e hierarchyT>also provides support for serializa{1 to2froa@dardhV*o ErootQnode,]*file-p handleBD!QwhoseHcontents pbe used}tree with , p v# asser0is #is@(O=!#  *!ifx?`parse()*0getV0B"""Rro0is .aelf._root  def _setroot(self, element): """Replace (" of this tree. /Twill discard the current contents>e=c and rc%itJAwith=Tgivenxq. Use Vcare!{5"""=# assert is()$!._=_NSparsesource, jr=None"Load external XML docuJT into^-*Y* is a file name or object, *y(pn optioiinstance thataults toPr}PErrorraised ieQ fail@iIqReturnsNj@cclose_,v= Falsef not hasattr(&, "read"w = open+&b"( q6Trup6try-$if0is  #0# I(was specified, create aEs6r =#(%%if0A, '_ {_whole'4^# The, when i mes from an accelerator,P0canP0ine1#in  API for efficiency.N0It Q@be u"toPc out feedingO#it1_hunksu C(r.Dr D wh[0cdata =.n(65536hiX t 1GYbreaky!(< Y" =d!r. mnfinall)FkvCiteru?tagjCB4xT 8`rl,loops over allFs in,X ordeDB*tagr stringh2tag#toek@(def~3to b)%!isbS&.iter(tag)  def find(self, path, namespaces=None): +"""Find first matching element by tag@1 orN%. =Same as getroot().zt), which is EM)?*)*"Pa strx0haveither ano XP*Kn optional mappOAfrom prefix to fullReturn the, Ge if nowas foundM5"""# assert  ._2@not N(!ifh[:1] == "/"6 = "." +*:warnings. ("This sear broken in 1.3 and earlier, will be E`"fixed9a future version. If you rely oL@currRJ beour, change itQ%r" %,FsW, stacklevel=2,)rR%KItextOqdefaultL8]K?), b"fw,@;s9allrd al3subs") )dhfix to full name. Return list containing all match elements in docu g orderI5"""U# assert self._root is not None(if path[:1] == "/": = "." +* 0war s. (="This search~`broken1.3 and earlier, will be E`"fixed9a future version. If you rely on the currentJbehaviour, change it to %r" %,FsW, stacklevel=2,)r.findall(U , rspaces) def iter'(7,*=)z"""Find-5sub0aby tagB1 orP2Same as get"5().b), whiR!*-*Pa streng either an @oVXPathm*Kn optiona ppVAfrom8p prefixAfullX!anUable yieldI] ^Swrite[file_or_{` enco,s xml_declara$default_]&bmethod, *hshort_empty_Bjs=TrueWc0ree a 7XML1ArgAsH0 *,B* --A=Pobject opened for W2ing>*?GeoutputW# ( : US-ASCIIR; *cHbool indicat if[GXML  should b Padded*.Oe Z J2is S&ifIS NOT either of:   US-ASCII, UTF-8, or Unicode ;*default_namespace* -- sets the U XML # (for "xmlns")OamethodDReithe'3" (I), "html, "text"i"c14n"Hshort_empty_elementsVrcontrolformatting of ( Pthat Maain no ent. If TrueOey are emitted as a single self-closedMPag, o>@wise\OpairNof start/end tagsi5"""Crif not :8! =2Celif0;in _serializeB raValueError("unknown@S%r" % )}encodingT}2== C !;Vutf-8+lsp5vs-ascii8enc_lower = _.( with _get_writer(file_or_I,<H)-' xml" and (xml_declaration o (pis NoneEb Rin ("4D, "u HJ")))J4ed_' w&if u[X\# RetrievjBxml " wLimport locale"B /.getpreferred~`@("\n(&,)ig )X@_"(,j._rootTeq&s, Fs = < s(O, b/G [q]"., ,Ata=Adef 3_ , # lxml.etree compatibility. use outpudv insteabreturnk5,="c14n") # -----, # serialization support @contextlib. manager def _get_writer(file_or_name, encoding): # returns R 7 method and release all resources after usingF2tryOSD = t|.0except AttributeErrorB#<Q is a El%if == "unicode"L& = openE"w")QOelse=T=],Pes="xmlcharrefreplaceAwith QyieldJ 9 -like object#?determines if itsor binary r?0# uBbur as isH"$# wrap a 3TextIOWrappeH+6ExitStack()s m6sinstance9io.BufferedIOBaseT< 0/elr?RawmW |# Keep the originals=Q when\ Mdestroyed$x`.callb!~.detach BP# ThiO to handle passeds that aren't i"# [ hierarchy, but just have a"E7 = U(/able = lambda: True`1. /P )# ,%#issKK#*BOM (for UTF-16, etc) should be addCCseek%.2o.tell s: P HzNapper(file,  encoding= /, : errors="xmlcharrefreplace"Dnewline="\n")z# Keep the original file open whenTextIOWrapper isHdestroyedstack.callback(_~.detachQyield.write def _namespaces(elem, defaultq=None):}# identify 9p used iis tree -amaps q*Q to *ed* prefix:localJ2+0= {t : }MPuri:sLBe0bQ = {}L.if$2[b] = ""w$Aadd_( F# calculate serialized representation46try"if1[:1] == "{"!%uri, tag =-1:].rsplit("}", 1#" =a.get(uri-#if1 isxT O_mapX5\+`"ns%d" % len(6a0!= B(L@[urit%U qI[F`"%s:%s(QOelseR# 9entL # FIXME: cabe handlXML 1.0?u=raise ValueEN(&.p"cannot( non-qualified with "? 0 opT3wssexcept Typ ___B,R# pop ^3 an|a tables1for5g.iter(Y=#A.tag4Iif isinstance(tag, QNam# if+`.text x"in5s+1tag2;/elp7strCni dtag is not None and tag is not Comment WPI: _raise_serialization_error(tag),for key, value in elem.items()Tif isinstance(6[QName'Pkey =YU.textn ifin qnamesh&Aadd_h ", xe4l" =   /zTretur!, paces def e_xml(write,,L4,9short_empty_ents, **kwargsr!agG $if("" % D⪙ProcessingInstrucIM?%s?F&se)7as[tag]l7Non26extG_escape_cdata(#C:F]=(elIP"<" ++ = list( '"f *'or/if r9@v, kvvsorted(~J key=lambda x: x[1]): # Z on prefix3"`k = ":<kFb xmlns%s=\"%s\"(4dk attrib(vA)k@k, vk k-sk PvP3v =![vWoE2 A[k], vLHext or len') :s.>"]:   write(_escape_cdata(text)) !for e in elem:)_serialize_xml(], e, qnames, None,;?short_empty_p_ents=v(""(Nelse:$ //!ifV.tail/' 4')) HTML_EMPTY = ("area", "baseAfont r0colAfram"" % R&elJProcessingInstructionXO?%s?U 2Q[tag]{j'ex#  #"<:+~items = list((v#1if F or  ( #@v, kuvsorted(3.f,())9 key=lambda x: x[1]): # Z on prefix DNif k&`k = ":<kFb xmlns%s=\"%s\"(4dk ;attrib(vA k@k, vkYsinstance(k, Q6H  k. PvP3v =M![vWz{E 2_7 # FIXME: handle boolean mOutes 4[k], v1}lmtag.lower(qU2if ;= "script" or ltag == "style": write(text) Oelse6 _escape_cdataD Efor e in elemJ_serialize_html(, e, qnames, NoneSif ltag notYHTML_EMPTY_O(""O!ifV.tail:2 ')) def 7Blem)K1par?Aiter,!l'E6) A = {h"xml":Bxml,Y  #, # this optional method is imported at the end of module # "c14nYB, } Dregister_pace(prefix, uri&C"""R(5 a * *!. BThe N ryglobal, and any existing mapp`eitherDSgivenW! ooURI will bjSmoved|**x  a, *uriuri. Tagsattributes|L|-dd withif possibleValueErrorpraised 'bpeservedTnvali1"""if re.match(r"ns\d+$",wa u2("Piformat rmzPinterS3use@k, vVlist(_map.items()rpif k ==+v Jdel M1[k] curi] =* g# "well-known""|!es[ "http://www.w3.org/XML/1998/1": 3`1999/x+, 02/22-rdf-syntax-ns#;Jrdf":schemas.xmlsoapPwsdl// 0b# xml .@2001STA#xs? .-instance7i8# dublin corexApurl0dc/ents/1.10dc"_0# F1est^ troubleshoo +y. _|a _edy%B Typ(@"can %r (type %s)" % G ,  1)._"__Fw"#  character data try: # it's worth avoiding do-noth calls for strings that areDpshortern 500 characters, ;o. assume$t's, by far,Fthe most common case inapplications.5`if "&"%Ftext0 = .replace("&", "&")FE>EgEareturn except (TypeError, Attribut)_raise_serializ+ _e5() def _escape_aGD"#  ute valu 5v/\"!\"9quo# Although sec 2.11 of XML specifc stateSQCR or# CR LN should be d with just LN, it es only to EOLNsJwhich take partporganiz0filgto lines. Wis we?Rtheseentity numb sopy do no6unt# http://www.w3.org/TR/REC-xml/#sec-H-endThe current solug, contained `follow2sixH, waFrdiscuss0issue 17582 and 39011 r r <#13#/\nHnH0HtHtH(09Hrn\__htmlsm..1K# ------------------ def tostring(element, encoding=None, method H*, xml_declaration&default_namespace ;short_empty_|s=True):)"""Generate representm of XML =!. 7sAll subs are included. If is "unicode", afFis return5Otherwise a byte$|*v*[Ban ES instance, *]# op8al output}$ Hing to US-ASCII, *D which canN`be one-s"xml" (V), "html", "text" or "c14n", *%*Msets the0 (fDsxmlns")RHds an (2ly)#edv contain!heXCdataE2"""tream = io.SgIO() iC== '`' else,B+FDTree).write(sa   @ i=D=.y)-eam.getvalue() class _ListDataS;(io.BufferedIOBasAn auxiliaryQ accumulatinto a list reDDnce.__init__(self, lst/`.lst =5Aable50u-Oseek-ZW7, bZ.append(b)aOtell1len)Y  7 j6t![]:C- =""Blst Adump ): """Write element tree or>structure to sys.stdout. This function should be used for debugging only6*m* is either an EPTree,a single.me exact output`formatL2impDadependent. In t version, it's written as anMordinary XML file1""" %# Pif no}instance(,!):*-( =/)!.&e(f, encoding="unicode"/atail =.getroot().NM[-1] != "\n"l}) def i@(, space=" ", level=0A"""I*:AdocuMby insertpnewlinemd[ZEafte{s}*.%th[7cmodify(() "en*itself willbe changed, but ^) text of allAs in its0subJbe adaptedQwhiteIeachUR, twofpracters by defaul}*2j~initialTQ. Setto a higherivalue than 0 cans*t are more deeplyIPnesteAsideA .!GUif is3L3! =L"ifF < 0praise VError(f"IP must>= 0, got {R}dE1lenbreturnp# ReducBe memory consump`by reu rstringsfPs = [# +*{]o_0_childrenG# Start a new}afirst M_)=1+ 1| 6tryw1( =t"s[!R]Gpexcept @xUO" +$W@s.ap()V0r(.'p(b7" =D^ ~J4 n aeTK,q-'-il.strip():  child.tail = _indentation /@# De after the last3 by overwritingprevious O.OSif no>~.strip():#z ( =Is[level]_.ren(tree, 0) # -0 # parsing defe(source,cr=None"""Parse XML document into ele .*I* is a filename or object containaVAata,.*"er?@n op#al instance defaulorReturn an EETree=%1"""s( =*%(). re?JJiter0aeventsN[AIncrEBally iThis class also reports what's go\Qon touser based !he*@* it initialized with. The sup\2ed /A areU1ngsK"start", "end-ns" and (o"Muato getM de0ed <@spacAformv). If s omitted, onlyC!#ed@'yka list ofot back, sQator provid(7,{s) pairs8B# Usinternal, unAed _Rr argfor now; When(e(0of ?0Premovvtan be killfApull.0r =BPull!s=$s,=.apN:try[while Trueyield from b.read_|,S# loaq buffer rdata = P(16 * 1024&$5%]breakePfeed(@ ]hroot =_close_and__$ 0it.F0 = 0fin 2if  .%"()7AIter  `collecs.abc.Iterator):  __next__ = iterator(). %it = IterParse &@.roo"ANone5delL,9 %close_source = Fals>if not hasattr(", "read"):=w = open'5b")$ eBTrue~ return it class XMLPull"r:& def __init__(self, events=p, *, _prT# The argument is for internal use only and mustbe relied# upon in2r code. It will /Pmoved!qa futurCWease.ESee https://bugs.python.org/issue17741more details.uRelf._P_queucollections.deque(6.%% =0or q<(target=TreeBuilder()B# wire up the o reporting#ifo47s = ("end",jR._set+ )(Afeed*g, data """Feed end3 toH."""raise ValueError("| ) called after end of stream!if :try).c$except Syntax as excOS;.append(excI_Qand_r_`[U#b needs thisWset its 6 Cibute properly :(#)= ~P@j AT`inish I1ingrcfUnlikea, does0eleW3. U<( ()bconsume .as from`%.q3 R$am_ over currentvailable (,h) pair|E{S are dSC a ey30rie-<Q0 USwhilev ># =.popleft`if isinstanceE[7ionP-\JelseQyieldt def XML( text, parser=None): """P XML document from string constant. 1This function can be used to embed "LLiterals" in Pyth.3odeG*g* is ai@taintArdata, **n op{#al! ice, defaultBpto the @dardrReturns an EleH"1"""ocif notm59& =Z(target=TreeBuilder())D-`.feed(rZ.close() defV!ID,+ for its IDs{x(|, dict) tuple,2Pwhich@t maps e1d:srOltree =ids = {}w3.(u.! =.get("id"Ff idkcds[id]4c?^, ids # = q AliaspXML(). list(sequenlK74 of@fragw*[ o/dother    \/?# -0 class """Genericstructure bZ8Avert Rart, and end methodAcalla well-formed{s1YouPuse t"to us#a custom/{wc, or a!Rsome XML-like$ma*c_factoryn   0is eto create news, as necessary@*comE yg to create c6omments to be used instead of the standard factory. If *insert_cE* is false (6default),Hc& will notqBu!tokatree. 2C*pi_q[acreate processingxructionKe 1pispuS1"""def __init__(self, ele=None, *C<P *3;h4 s =F,>rert_pis%):;._data = [] # Pcolle )) 0entA+ck(plast = 1 # / )7roo))FtailRtrue if we're after an end tagd;if K8 %2= CJ((  0 $ =6s/6if  5= PCInstN 1 &6pis)pi %2= E oE=6Qclose3""""Flush builder buffers and return toplevel docuj. asA lend ._) == 0, "miqJs8\!isO:X6entBB _f2if - \ '0texcd"".joiR)'VnJ#?}.,, "internal error ()D E = Oelse!isz?extE;,?a"""Add0urr4 ^.append(W)fSstartgtag, attrsmOpen new element and return it. *tag* is the ele-name, *attrsa dict containing+H,gibutes]5"""!self._flush()alast =T3 = *actory(tag, ^s6#if%:M=[-1].append(?%elA@rootONoneI gc_ tail = 07~@def 0f, tag)"""Close@currEh$ ._G.popcassertp.tag ==%,\p "end mismatch (expected %s, got %s)" % (<Cg&(i1i;o0com(k, texttreate a )0 us"_fZ*H'( 1 ofP4. phandle_n*le #._K, ins$piRarget =`proces instruction$pi _ G Y EOdata: v, or ''A[' V piQ9)Y_#, ,;0ertB7rgsjO$ =(0(*a#if9 9=Kv S)(e\ # also see 2Tre Builder class XMLParser3"""4 qRure b2@ for0 source based oncqexpat pP!*tPan op2al  object which defaults to anStance|Pstandard  , *encodinCm1ingJsif given, override}K specified isXML fil http://www.iana.org/assigns/character-sets ( """ def __init__(self, *, target=None, encoding!):7;6try from xml.parsers import expat7except IZErrorF W[J!pyL; asU$Y $Xraise|("No module namedn; use SimpleXMLTreeBuilder instead"N)" =P!.P(tCreate(gV, "}"3#if@ is  .7 = (># underscoreds are provided for compatibility only1 = _ ,:, , _e "~s = {} # memo cache+# main callbacks.DefaultHandlerExpandd4if hasattr(, 'start'(]SdElemenb\8Z ?endX?EndV?endT v?_nsYNamespaceDecl &_nH?endd?Endb = OdataCharacterData.9Z# miscellaneous$0com y6|Z/piUProcessingInstructionc%pi^# Configu: buffering, new-style pibute hEing.F8_text = 1ordered_J&doctype =C0ent[ *version = "Qt %d.3" %6#U_infoNAAttrYPpass Wknownsetevents P_queu`_to_re# Internal APILrXMLPull## TF: a list ofB to b0 du ing (same ar# the *T*C wS's coF"or # events2_queue: a list of actual parsing events that will be populated # by the underly:BBer. "5 #  = self._append ={.%2for _name ins_to_report:,"if!/== "start"&*.ordered_attributes = 1T.def handler(tag, 0B_in,q=Aw", =,MQ=! ),L!((g!, + =)))kSElementH$ = 5.elC?endA %3end?end0end?End&b?-ns # TreeBuilder does not impb! .=N_ns(iIs?(starget,O_ns"pprefix, uri,\2Oelse%(a or '': 6NamespaceDecl<"E%0endTC2A* s: 01 ONoneM?End+@'com' Otext] append((event, self.target.comment(text))) parser.C'Handler = h 0Qelif d_name == 'pi':%`4defAB(pi_r, data,A=G, append=,NR=)v$D ,piProcessingInstruction .se raise ValueError("unknownb %r" % U!) B_<e60, vG erP]!Berr.code =; @posi"clinenoku.offset2G err0fix (7key# expand q# , convert  string to ascii, if possiblev:tryX;=5es[key]1except Key=5key0+if "}" in 3 tQ"{" +# >.* =$Rretur[;start_ns<prefix, uriD;bI.82a or ''8 Dv ?is not Nonef!# PcontentsM >" n=i C%Vretur ! =z.strip(!if' =P q.append Wn = len(/ #zN > 2w <=[1]2if += "PUBLICn4XQname,7, pubid, system n>5\"T" =\O[1:-?gSYSTEM3^ ;elsif hasattrtarget, "//")-.+(1 (w2yrwarnings. ZD"The() method of P is ignored. "DF!"DMn the TreeBuilder "NRuntimeW-) wR &def feedg, dataQ"""FedA to Fr."":tryt)(]v, Falsebexcept_;_ as vL_##(vQclose Qinish;ing element structure.""" try7: self.parser.P (b"", True) # end of data7qexcept :_error as vXa_raise#5(v)A:try-close_handler =[qtarget.;|AttributeE MFpass0:lseqreturn Ws(kfinall# get ri circular referenceoY2delV, _ **o # -0 # C14N 2.0 def canonicalize(xml_=None, *, out from_file**options)S"""Convert XML to itsm serialised form. If *out* is provided, it must be a s1 or -like object that receivu8thehoutput (text, not bytes) through``.write()``method. To `, open0in V mode with encoding "utf-8".Mthis funcR  s "asccstring>Either *Q* (an')8*G path or`X)|SinputwThe configura A are@same61for ``uWZ!rT"``1"""4if U and m1OR Valu#("'J''C'"`sio = }>outz'a= io.SBIO() =F"r(=B(outq&, PG 1hU.feedJelifRU(4", H= sio.getvP() if/WR elseP _looks__prefix_n( = re.compile(r'^\w+:\w+$',UNICODE).match clasXPNC"r 2XMLSsp events9.*Y*Cis u0)`resultdq streami(9s&QwC `` method.  Configuration op@s: - *with_comments*: set to trueinclude "7strip_text4 whitespace before and after 8 contentRrewrite_prefixe@replO3namY, by "n{number}"Sq*_aware_tagSa1of  P tag +@s in4ch ZK+should be d?lOattr_ibute  !ex_o DthatX0notserialised4- *N bVG"""def __init__(self, A, *,p  =False, ~ ZPb=None,+@ Gs% P%):9!._" = data = [] < ,' = &)9et(E) if&Pelse $L K J I J < = 2iYk8o  )XI  3HXfind_*).intersec]?# Stack X globallynewly declareds as (uri,,) pairs.To:Q_ns_sdE= [[%("http://www.w3.org/XML/1998/q", "xml") ] Ouserej0if  A.append(list(__map.items())p8 <,[]"ET = {}S self._preserve_space = [False]  self._pending_start = None#root_seen = D 0done ignored_depth = 0 Adef _iter_name s(@, nsck, _reversed= !):>Ffor <6 in/(C/3'if2: # almost no element declares new.wHyield from&'resolve_prefix!ed,O2 = '.split(':', 1)f`uri, p?.U/._4p =m]]return f'{{{uri}}}{t%}'raise ValueError(f'P" {} of QName "}" is noudgcope')'qs= `, uri=? ifR $atag = Ac[1:].rT}T3 if0:1]'{' else ('',y c^?$esAFset(E,#._duturi andV^#in }:{tag}' Qtag, 5uriB&aR.add(#8# Nyet => addkeation.Z2if drewritN*esn.{J_map(- =+F[uri +A = f'n{len.Vmap)}6Ip[-1].ap!((r)9>G!''u  defaultd#noXv needed.3^+#f'm ot # As soon as ac isUined,M# anything that ha=(and thus, no prefix) goes there. return tag,Euri "0raise ValueError(f'Namespace "{uri}" is not declared in scope')Idef data(self, %):c!if>._ignored_depth$!H.append( )cc_flushe_join_text=''. s96 = $5 ._)Fdel u5[:]#ifQstripfG andpreserve_*J[-1]j! = .E(x^ing_startfJNoneLSargs, 3= , C[Rqname" i_looks_like_prN_0^ elseR8"(*e}6if +qroot_seen"write(_escape_cR_c14nI1_ns", W, uriD # we may have to resolves8 contentW. ns: ck~3D(uri) _attrsexclude_tags+( $0 orjSs?I+= 1h g/ E1newVs = [_UQ ;ROawar56tag  . `# Need;aparse /Pfirst0seeit requires aZation 8(,,  |NAC {-rtz u,$=(jH  O = {k: v for k, v.items()UkYelf._k}B{A*H}dnz<3# RreBQibutea,?one:  qname = resolved_!s[_text] = self._#q_prefix)(( ) ORs.add##ifOQfind_(_aware_attrs is not None and :]I(%xAif q P1fork? in)-@valu5L[7])if _looks_like>H)77 # QY"Nelse:! =, ()# Assign ? eselexicographical order of used URIs.ARparse1 "Ts = {n: 6@(n) nzusorted(<Ns, key=lambda n: n.split('}', 1))} 5# Write 4pace declaration&..aif new7s:sqTlist = [p('xmlns:' +O4 if  !n', uriDuri,3+in r .C(]x # almost always empty[M]Y... followed byBibut8@URI+uYS!if( LGk, vxs.items()) kFV= 2v =[6j[v]][0l8,3 Qk>D# NoNGdefault ('')6_.append(]z@uri 8v))Honour xml:+pp_behavi.=&s.get('{http://www.w3.org/XML/1998/ =}'preserve_8|4= '7' ! =kI[-1]1vthe tagwHja1('<B0tag4 E'.join([f' {k}="{_escape_attrib_c14n(v)}"' for k, v in _list])) write('>') 0# W the resolved qname text content.1"if_is not None:#olRcdataqparsed_c$s[s_r!s[Z@]][0Uself._root_seen = Truens_stack.append([]@def Ff, tag)0if ._ignored_depth !U -= 1%ereturnXOfflush(e:Rf'' if h else 8?}0 "#  character2try%# it's worth avoiding do-noth Qcallsstrings that ar`# shordthan 500w, or so. assuhat's, by far,"0mosmmon casekapplications,0'&'%Q! =.replace('&', '&_if 'EgE/\r!\rG8#xDaexcept (TypeError, AuteError):  +_raise_serialization_error(text) def _escape_attrib_c14n : F"#  ute value2try&*if '&' in _! =.replace('&', '&')O*F `follow s: handlerBase classedstants which definey 'client-side'EsaxutilswIT=convenienccommonly uWxR work2SAX. xmlreas?-- 2O  }Driver that as=.InputSource#!ContentHandler, ErrorHandler from ._exceptions import SAXE,NotRecognized?\ SAXParse-SAXNotSupdG ReaderNotAvailable def p`(source, h7, e=A()):9r = make_'().setContent,(_ & `z )c)String(s!io)if is None) = Mnpsrc = InputSif isinstance3stri?haracterStream(io.R#IO<)7els AFByte<s;!r.(:) # thish2ther list used by _P funcd if no # alternatives are given asOameters toI=;Cault_s= ["xml.sax.expa Qder"]ell modulefinder thating sax poSially's J _false = 0 if ]# pos, sys:0not %.flags.ignore_environment and "PY_SAX_PARSER" in os.&v?def&].split(",") del os _key = "python. r" sys.platform[:4] == "java"registry.containsKey(Z :getPropert: ="""CreatKnd returns aPQser. }'Sfirst0 it_vtiate ofAonesC!inAiter5cPchain\2>t. The Kss must RfPnamesPIs(pIbothv2 a 5B."""3for_jsZ(O) + 6try ) _}Sg+! I~S KJF/irYB # The parser module was found, but importing it ## failed unexpectedly, pass this exception throughCUraise0 SAXReaderNotAvailable:&.# 1det that it won'rk properly,Fso try the next onh 4C("NoG='", None) # --- Internal utility methods used by make_ if sys.platform[ : 4] == "java" def _creat9(@b_name)%from org.python.core(Rdrv_m=.HNameZ, 0, globals())?vreturn F.c) elsOR = __)__{},{},['p/']0delt """Different kinds of$ ERs""" 3 :0.laKUR ~@ # =qEXCEPTION@ clX5SAX( """Encapsulate an XML error or warning. TPcan contain]basic30 inaaeither9d{1 orEOaapplic2`: you j2subwPit tovide addi[!al?Bfunc@ity, to$ localizUb. Note@alth_h2wilGreceive aO ape argum!tohandlers iE:H iQface,g are not actually required- ion; insteadC1imp=!adi0it.sO9_init__(self, msg,j =NxA"""C%se message is y"Ais o!alp._msg =0t& =$-._!) 'BgetM}""Rya fo!."I/9msgcevmbeddedx0 ifrGOnonezS__str` a strrepresentrdef __getitem__(self, ix): 0"""Avoids weird error messages if someone does exception[ix] byHmistake, since E( has __getitem__ defined."""=raise AttributeE'("6") # = SAXPARSEEXCEPTIONq classEarseE(SAX """Encapsulate an XML p8or warning. 7Thi will include informa for locating theP!inForiginalt document. Note that although?PappliO!onuGreceive a2 as8!rgY1 tohandlers inGjH interface,  x is not actually requiredE2to !; instead, it can simp< ada<9 in*@and J a differeny3ionSbtis a sub ofinheritsxpability wrap another/def __initFFmsg,+,#or`^r"Create0. T parameter `llowedbe None.&. )!._Dor =!r# We net@cachis stuff at construcUtime.]^# If  dE`objectrwhich we mustItraverse2getVmay be deleted byC Fit gets caughtsystemId = S.getS(;ocolnum3ColumnNumber7Oline8ELine6^9getQL ""7ct! nu o~Te end text wheregloccurrSeturn!  rW9numPublicIdG41e p! identifier/ty or')> {;T&IdS__str "Create a string representation of the excepC."  sysid = self.getSystemId()#2if &is None:D= "]wlinenum_LineNumbera*cF= "?]:col\oColumn^+] \return "%s: %s" % (#, ", >,?_msg) # = SAXNOTRECOGNIZEDEXCEPTION q class'otRecognizedEE(SAX )w5""" @for an unrC identifier.  An XMLReader will raise this when it is confronted with anI gfeature or property.q applic~s and extensions mayJsimilar purposes."""QSUPPORTP SupportO(sB M a serviceWacannotpperformj`requesi(specifically sett!atfavalue)dFh / ud? h gONotAvailable>Not} P missOdrivmodule (") should is first imb, e.g.#a " m_5 be/.FpIt also=Ad duo0parYif execunArnalHaprogranot permittedBSAX  pyexpat C@. T'Qworks *`.__vern__ == '2.22'. `  = "0.20" from xml.sax._&s* *"thandlera_valid&$, namespacesC/_prefix7\aF_ges|pG<_interning R_xml_:,DP_dict_'Bers.Pdoes L! IError in Jython  P.plat9[:4] == "java":  raise SAXReaderNotAvailable("expat not a, in Java", None) del sys try: from xml.parsers import N except IRError60supM%edBelseC!ifhasattr(pA, "PCreate")+r&4saxAxmlrB, saxutils, handler AttributesImpl =/.*/NS,f # If we're using a sufficiently recent version of Python, we can use # weak references to avoid cycles between the  and content #, otherwT we'll just have to pretend.,_?refdef _mkproxy(oeturn o [ S;$ =.K-%, class _ClosedD<@passzP--- E"Locator 3(.&3""" for use with bAr !. @This*1s a]:`objecta1ingFa circular@T.E1"""_init__(self, }v._ref =&FgetColumnNumberME05 = N`#ift#._&!is#r*;7?. OLineL1 PublicIdA! 9%source.get)oSystemf)) e Incremental,"""SAX driverA!py C module.=_>namespaceH<ing=0, bufsize=2**16-20o` .[F) self._source = xmlreader.InputSC()  se/parser = Nonenamespaces = Handling-Plex_her_propSoing = Falsqentity_stack = []dexternal_g0 in_ a# XMLR  methods @def e( ", :!):% "P0 anB document from a URL or`%.">O = saxutils.prepare_i(')v V6try/WresetT_contS.setDLocator(Expat {)"FF0cre!al/r.=jexcept# bpo-30264: Close thex on error to not leak resJsxml.sax) doesn't give accessI`punderlyr#'Zcalle0._c RraiseNV#if.getSystemId() is .SetBase7 CE# Redefined setContente^allow changPs durj' E92. F o!?ing (getFeatur!ifR == f(_" orreturn %/elM stI_S$^Din (validation,Epes,@O@_prefixes/`s+ge@5'9 SAXNotRecognizedE5Sion("Q '%s'r&1" %sw, stateZ ySupport0Can4setvqs whileFCing"Cw .'3-~ _ges:   self._external_ges = state  elif name == feature_string_in9Eing:/7"ifD s: is None,0-I= {}k?els;7c9validation raise SAXNotSupportedExcepF(o"expat does not s8 ~%")9?pesYTread } parameter entities Cspace_prefix] LRecogniz ""F!Q '%s'r71" %!) def getProperty(,!{handler.p1_lexical_5lpreturn U.*&_?& a__dictXQ 3xml2 M[jparserif hasattr"._), "GetInputContext")=A =.;(p2U5"This version of getting"R=" the XML 'd@ canAbe rXqed whenVGn6"&s&,4'ue-&&" =b   M]resetyl{Yt R| 2raise SAXNotSupportedException("Property '%s' cannot be set" % dname) /Uelse:Recognizr'  # IncrementalParser methods !def feed(self, data, isFinal=False)0if +._parsingfreset(4q = True:_cont_handler.startDocu"(),:trywT# The parameter is internal to the expat reader.p# If it51set0Crue,2will check validity ofSJntir3# da. Whending chunks,8Qy areQnormally fw+ -e wHinvoked from closeG1er.(V.error as Pexc =BK;6E6String(e.code), e, i# FIXME:2to  x9()??U._err QfatalnC(exc _q_source! =.%j E@file-L.getCharacterStream1if 2!is;Non<".>l* ~OBytey4/`'1if :._entity_stack or8M1 orOisinstan`er, _Cd9'r)p6l!wepcompletSan ex@, do`h+hegereturn .6b""} ) ~7end|-!= '& # break cycle created byLas poinVto ouDnPer = lJ1-if[ Xq# Keep ~ColumnNumber andDLinefwg:ingL4 %).u!  parser.ErrorLineNumber = self._ :-# =U &"close_source() " def _reset_cont_handler(2!):#kProcessingInstructionH9E = \6:Rt/.pXM1CharacterData{$ Uc*s4lex\_prop5lex ,(0if Fvis NoneP+.Comment*A)StartCdataSes3?End1dDoctypeDecl?End0?elsRlex.c:s#ODATA=;OendC9qv"_d6__decl~)}6DTD #ifnamespacesQ5 = expat.PcaCreateR..getEncoding(), " ",{ rintern=x Iing)F_prefixes = 10y:Ele!Sue?_nsE?EndCOend_AqY% P GPV & .#; 5#!Un zdEntityW)u!!_e" C"}P.NotanEn>)N>DU  ?EndI [ G self._d ecl_handler_prop = None if self._lex):#*$]reset*@() #$)parser.DefaultH/ =(oExpand.NotStandalone\# ExternalEntityRef0(e !_e!E_ref?tryZrSkippedY VsUYexcept AttributeErrork# This pyexpat does not support ~YEpass SetParamParsing(,=n.XML_PARAM_ENTITY SING_UNLESS_STANDALONE) ?king = Falsgestack = []?# Locator methodsdef getColumnNumber(H)+1 is!areturnO"._=.n OLine/1i PublicId source.get/MoSystemF/F# event i[start_element, name, attrssDconto.=E<6bsImpl(Ep?endng 8endeNP?_ns apair =.split()pif len(#j) == 1A# no9Fspac3@ = (;V,elX3X=Q[0], %1]Jelse22# d Rtuple1newU = {}dqs`for (a, value) inw.items([@partD4 ^"length =h6rts( *#  1 = aY%  Db"%s:%s" % (![2jrts[1]U7{,,   # default namespace q = parts[1]!apair = tuple(')) &newattrs[+] = valukg"Gself._cont_handler.startElementNS(y, None,} AttributesNSImpl(!, #s)def end_eq@_ns(,:%):s! =.split()aif lenf) == 17;(B;,el=3=DQ[0], Oelse2#ir o?endm5# this is not used (call directly to ContentHXprocessing_instruction`target, datahGIF @Q*character_  7!s(-_fS_declWprefix, uri^ DP.Mapping(<mkf ?enddxdoctypet, sysid, pubhas_internal_subset4lexR_propBDTD(RKYunparsed_entityLbase@notay 4dtd._E^D, Qi@ I#exh3refdT_ext, | if vM:gesTreturn 1Jtource =;rresolveE(;s?axutils.prepare_input_ (]=.getSystemId() or+#""p+) _stack.append(w!._)r,)@%=#.E9PrCreate( H = source  Qtry: xmlreader.IncrementalParser.p(self, source)<jexceptLreturn 0 # FIXME: save error info here? F]!._i0r, k#._k# =entity_stack[-1]>?del# 1sdef skipped_Vqhandler, name, is_pe)"if=# The SAX spec requires to reportk PEs with a '%'Eq =+  Scont_.E(.) # --- ccreateL(*args, **kw RExpat )TPif __g__ == "__main__"!impxml.saxQutilsJp = 9p.setContentHy A.XMLGenerator()9EG 7 .Q@("http://www.ibiblio.org/xml/examples/shakespeare/hamlet.xml") """ This module pains th re classes of version 2.0for Python. Hfile provid5nly defaultJ& bsolutely minimum functionality, from which dri| and applica)s can be subd. ManyFthesare emptyE re included only as docu\1 ofinterfaces. $Id$ 3 = '2.0beta' #=8 # # HANDLER INTERFACESf8= Pd ERRORq! V """Basic  5cIf you/ an object that iyv&isT,nmregister=Hyour XMLR2 r will call5F`methodbrI-warnings) s.!reDIthree level& available: E, (possiblyprecover&3!s,i.und. All atake a1SAXEa<eparameter.;3ion3$"v= a !."w&eraise @sQfatal*dOnon-h"Zeeption):  "Handle a warning." print(exception) # = CONTENTHANDLER class ContentY!r:O"""Interface for receiving logical document c@ events. A This is the main callback iXin SAX, and(one mostAimportant to applicas. The order ofvQ in ts^Ebmirror2ainformQ;eB."""def __init__(self)l._locator = None6CsetDL#@#, 1I"""Called by`parserAgive$ aDX`origin 1BSAX j!s are strongly encouraged (though not absolutelytrequired)fsupply: if it does so, Rmust )Eoby invokis method beforeF$0anyGSother0sA#gRallowHto determin5endT@posi-related,.5 isF} re @an eP. Typ=ly,#vwill usUcits owZs (such acharacter3tha0mat1n'?business rules)freturnuprobablypsuffici| use with a search engine0Not!at,`(} correct 'on0durn_e:ashouldaattemp`it at 1Atime {~5tary pRe}#ifWPbeginXa^> Ekb=c once, 80 orM3DTD  f))f4end?end8!it+Gb/ce last7ed kparse. The parser shall -not invoke this method until it has either abandoned parsingE*(because of an unrecoverable error) or reached the end ofBinput.""" def startPrefixMapping(self, pq, uri):/"""Begin^Bscop.-URI Namespace mQ.n?The information fromevent is +necessary for n/L`0pro(Aing:pSAX XMLder will automUcally@repl!esh@elemand attribute nA wheB http://xml.org/sax/features/3#s true (theDdefault)!re are cases, however,aapplic<@s neFo usSin character data'in@valub@where0cansafely be expandedO;vJI/endN  su es2  toE3 tox^1es yose contexts iti>X0Not"atszrguarantb be properly nested relativePach-o(: soccur befo correspondFEV!,  ll`  af gC ]0butPir orP%isE # R  P K"EnI?2See %details. T`^Valwaym of0 tsVwise K ($9,s)bSignal>8pin non-@{7odexT0ameB2ainT1raw:11.0_htype as a stringL0s^holds an2qinstanc/1Aaqs class0ainU Qs M3endKDFNZB(e name of the element type, just as with the startE,event.""" ,9def NS(self, name, qqattrs):2a"""Signalsae of an!inCspace mode.q?1The parameter containPuOU as a(uri, local1) tuple,_Jraw XML 1.0D9 used in9source docu[Q, andRBPholdsinstanceAttributes class0ingQAY( ofC 10urit` is None for=s which havek!now 3end!0endL?NS charactersk:entReceive notification>[ data%Parser will call this method to report each chunk of Z@ SAXsers may return Woiguous>a singlej@, orMyL`split 5ntoDrseveral1`s; how,tsd#nyfEr must come fromy same external entity so that!BLocator providesful inform ignorableWhitewJ.Kuy/pValidats?use?of z0(seFTe W3C recommenv5on,E1sec2.10): non-vpJ@alsoUGity are capW@uYm'ls  a  F F , =`procesKaInstruqtarget,d ation of a p rocessing instruction. #The Parser will invoke this method once for each pRDZ found: notE'at0s may occurGbefore or after the main document elerA SAX pshould never report an XML declara (E1.0,z!seQ 2.8)_ text5 -e4.3.1)Due8B."""hdef skippedEntity(self, name):B"""Receive?BificDof a@! eABv. Non-validat/"or'}`ies ifyE"haP seen<s (because,Gpxample,(BC was;Ped in external DTD subset). All[5orsGV6Yies, dependovalues oC http://xml.org/sax/features/-general-^I andFparameterHpropertiesH@ # =rHandlerw classR2"""(s events7Tinterface specifonly those5 requiredQbasicuM0(un &ed attributes)q 1notGDecl , publicId, systemIda@( .pql, ndatas$n Ny{ENTITYRESOLVERResolverBW or%cf. If you createaobjectiV 3Pltn regis[:P withT /V@call!in4 E!to e -+3% NrDefault%r   d6 behaviourY~bZT qv0 ido@fier"anyreturn eithe1=to read from asatring,bn InputSource=J4yf`Id #============= # # CORE FEATURES;% feature_namespaces = "http://xml.org/sax/)&s/*" # true: Perform NF$ processing (default). # false: Optionally do not pC3 # (implies -prefixes_ acv`: (par}) read-only; (ho/write_VReport the original Xd and attributes used forIpdeclara7sID>rkK  C,{]- oR v,string_intern2 0-0rAll elementa,q&s,h0URI!%ndRlocal)R are m@ed uWbuilt-inP funcb@{ neSarily4ed, althoughTy may be4_,Qvalid9 *SFall  errors  exal-general-entitaU&parameter(  v`,/_g, $Include %/  (text)  i> :35p 1", hDTD subsetDany 9 d@even?&_ `F$Dall_C = [ 5#,  $_prefixes,   feature_string_interning, ($ *validation$ exGoal_ges&pes] #=8 # # CORE PROPERTIESc8#= property_lexical_handler = "http://xml.org/sax//Cies/1-1" # data type: 5sax.sax2lib.L_H^,`escripa: An o 0al {cnsion ZS for n events like comm. # access: read/writeadeclar5ODecl&DTD-relatedzother #than nots and unpars8ntitiesom_node@dom-* org.w3c.dom.NodePWhen  the current DOM Q being visiif this isa3iterator; w[:not_7roo\-fo8A8ion()8-only; (] Q3xmlqBBxml- DS :QThe l"l 7 of characters that wa e source" 7t5&%Pencodwww.python1@name= to assuma inputHQ: setK<, e.g. established by a higher-level protocol. MayY`nge du>S! (Y>aftAl+a META tag)i^: return (possiblywthroughKauto-detec0initial value: UTF-8 # W_dict 7-7 !Di?ary1ionary u2to N#on2s i@docu`Requesae parser uses a specific dictionary, to # allow interning across different documents<read: return the cur.Iyor None # all_properties = [y_lexical_handler, 5 ,dom_node% `eclaraUxml_stringW _encod%  _ ] class LH:P"""Opal SAX2 S for 0 ev!. 2EThis&is used to obtain4ainform about an XMLD, that is, 01how-Q was !edF(as oppowKPt cons, which is report1the>sContent), such as comu and CDATA marked se?boundariesQo set i3 ofpReader,3(BsetPyTmethod with s identifier('http://xml.org/sax/,Cies/-R'."""4defa(self,-Bent)A"""R/4s a- anywhere it`(incluE1DTD?poutside@ elea)90iuQholds?#sO startDTD name, public_id, system_idgBddf&0haspassociak7DTD!A YbEntityQ will bewbefore r*sgAfrom ex60al 0sub{&arL,tRcan bkainfer Q(FQs deriveVV oH typt( if none w|supplied)E_W0V0"(oK j ^4end\ @bSignal0endu G J \ N`QbeginFT(f  {Rbthrougcharacters 1end[(self): N """Reports the end of a CDATA marked section.""" """\ A library of useful helper classes to Q4SAXP, forf conveniencen`pplicac and driver writers.s@ im os, urllib.parsetrequest($io codecs from . G{handlerxmlreader def __dict_replace(s, d): 6 substrings using a Baionary>=key, value in d.items(^%ds = s.{/)return s escape(data, entities={}OA"""E"a &, <,c>wa0of =!. ]You can Wc other*+} by pas1 asD op%al parameter. The keys s must all beFLps; each.1 wi d with its correspondyQ.E #`do amperskQfirst=^("&", "&"y&>&/gt% <%l%%ifT_ y"un U$ b, <O>eqGm"< 2%>%,#la"")quoteattr  0@ an 4Ribute*5 ,"n L!it4use ^\" charactd as well, if`necessEd = {**, '\n': ' 'r3t':' '}.# = ) if '"' in data: if "'" in* = '"%s"' %".replace('"', """)PFelse^Fc"'%s'"F/ +m'Rretur def _gettextwriter(out, encoding)}if out is Nonimport sys\`sys.stdout if isinstancedio.TextIOBaseiB# use a  ] as id] (codecs.StreamW), bReader)-! sB# wrap a binary5Rwith Wrapper?RawKeep the original file open when c1# destroyedzgpclass _2per!__@__ =.>&=>attr__(self, nam)0get.+Sbuffer =(.close = lambda:@ P# Thi2 to handle passed objects that aren't1theH"#  hierarchy, but just havf methoRq = io.B"edKA8abl6TruL.'$2out :try#bE#iss determiniif BOM (for UTF-16, etc) should be add>7Cseek+CtellS #except AttributeErro0I>R(=,7eks='xmlcharref'8 newline='\n* _through=1) ` XMLGenerator(r.ContentH2r):AmEinitj@out="iso-8859-1",rt_empty_elements=Falow7.__l=3 o!._ Sflush  @ns_cxts = [{}] # ains uri -> prefix dict'tcurrentE2 = XK[-1]vundeclared_ns_map}& self._encoding = en # self._short_empty_elements =  :0pen[@_staB< = False -def _qname(n , !):"""Builds a qualified% from a (ns_url, local? pair"""F!if36[0]Z^# Per http://www.w3.org/XML/1998/O space, The 'xml' prefix is`Lbound by definition to_[. ItOdoes not needIbe declared and will!usually be f+inL\._current_context.%Oif ' O' ==Nareturn)B:' +))1]j#L[ is in a non-b1r 3s/= [L:[0]g#if p# If ita thZVfault,>  Io + ":"2# RJ*unTL'1]M0sh_:ingN6BendE^=\A#if4? ]write('>')F 0# C`ntHandler methods@DocuLh\n' %N)?end gflush(2PqMapping(fix, uri$nsn@s.ap>5fcopy()s p[uri] =5fix,$unu_ns_mapr(?end  '[-3del{ "S}, attrs  ;B Pfor (g, value)rw.items(yH_P %s=%s' %CPquote(M|,{  q = True5Oelse=:">"_): if self._pending_start_element: s)write('/>')G = False0Oelse\' % name) 7Adef E0NS(,$0, q+, attrs)[#._finish(-R<' + \(a)for prefix, uri in/undeclared_ns_maps9#if8 p xmlns:%s="%s"(p):RPM6uriC)R = []P , value)tw.items({0WQ%s=%sXp, quoteK(Z#ifZ0shoDmpty \Y?Tru3">"y?endw ORrwcharactersXzcontenteif not isinstance(XW, strr- = -@enco3^UescapeignorableWhitespace>processingInstructiontarget, dataP-}'8'Estare^U 0)I4endG.EPrefixMappjp_, uri B< ']", -d :end;5]0Ele, name, attrs^ <6_>end]V 3T tO)NSq+2NS(8 ?o fcharacters?entY 60ignorableWhitespace\/ha =nsprocessingInstrucctarget, data F @skippedEntitykc 60S_# DTD@notaGDecll, publicId, systemId5dtd H~BQdunpars~?, nhUO"# noResolvr')# preturn 7._eJEntity(publicId, systemId) # XMLReader methods def parse(self, source):6: ._parent.setContentHandler6)-_Error+ntityResolvX?DTDVsetLocall .(IgetFeaturJ8nam;yreturn B4.NsNh, statU N4N.UgetProperty , (5/PsPo, valu P/WOFilt{ O6,7ent>E# = # --- Utility functions U0prer_input_((, base=""cu"""ThisB takes an I=S@ and ope!alD@ URLRs a fully rdFobject ready for ring."""if isinstanceos.PathLik= os.fspath1K3str1C0xml7er. Oelif hasattr0, "5JQ3f =w? = d) f.\0(0))+TharacterStream(fPFelse 7NByte2@f, "P ") f. S(-#if[.getC) is Nonep7get#UsysidtX{ 0hea(0os.)@.dir(@norm(,);`@file. k'Q.join,X&id6 if) is>(H  /K.bJopenS&b" fqurllib.{E.urlPz3prequest5H :sStream(f) * return source """An XML Reader is the SAX 2 name for a$qparser.0P +s should be based on this code. """ from . import handler_exceptions"SAXNotSup04edE!,NotRecogniz` # =bREADERq classP: Interfactreadingdocument uscallbacks. ?:XML1iMDthatF1 's2 driver mustEPimplee0. T3D`allowsFpapplica ` to se\qd queryEpfeature-d properties i"e ,<register evsF5or `procesP, and<initiate a'0All s are assumeBbe synchronous:fqmethodsD notQuntilW5"te"erWT wait- before reh1ingBnext& ."1`def ____(self)It._cont_o=.ContentH!()f6?dtd5?DTD1efEntityResolverf?errfVErrorh,)"75a system identifier ?aInputSu!."iraise NotI !ed!(" be 1Red!");getfR@curr 3- D rsr, {ws a new objectVceiveRBs a7get84  4DTDnrjsj -basic DTD-relateds  3m >+r~ v  external .'._4 = b1get16 turns the current ErrorHandler." return self._err_h# "xdef set<(+#, '!):(M"Register an object to receive e-message eventsV $ =d cLocalel p""Allowapplicationset the 4B fors and warnings.m SAX parsers are not requiredQcprovidQ"iziW_@; ifPy canQbsuppor]Sested,Chowever,;must raise a Pexcep6. AUs mayC]# a] change inU middle of a7.""%mrSAXNotS4edEv"(" implemented")UMgetFeaturHnameLooks upsCstatbSAX2 fGCRecognizzS '%s'&A" % s!, ?SetdgetPropertyNHvaluNpHO|P2!, QHclass Incr1alP(XMLReader"""This interface addree extra methooB8athat a2XMLu rsYGi<Sing. tAis o al, sinc1allCunderlying urM@funcMSality2Whe(1er pstantia itPreadybegin ac!ng{data fromCfeed*` immedH`ly. AfBghas beenBfinished with a callnQcloseV re '!be'E2mak,c5er P new , either!orB usKC)0Not_a#sesf_not_ 0durKG0ing!atcUis, a $e Sbefore iBy default, the class also implements the parse method ofXMLReader interface using"feed, close and resetFsG=AIncrn0alPjrOas a convenience to SAX 2.0 drivwriters.""" Tdef __init__(self, bufsize=2**16):'#._$ =( .Q)i fgsource_`from .Sort saxutils^0% =.prepare_input_ (t+6$@fileY.getCharacterStream()1if .vis NoneHMByteCbuffer =IQ.readZm wh0 j8(4bHz(3Yg, datas"""ThisR giveqraw XML01 in<ameter toF,rmakes it-%se<s, emitt'=correspond ev~`. It ilowed forconstrucEo beE split across several calls9.P may raiseWExceptionI$DNotIedError(6pmust be=Ged!"  !isQed byAkcaUallow &$0 itMO?ingBp overriddenkj2whe_aentire@docu has been`passedahrough(,'QnotifCD!rs6 at3re are no more!. \j do=@ finjrhecks oAempt5nalQTyr will no^Yy another lFunti[xJWpX# afl MQ0r s at;is =new documents. TChe %results of calling parse or feed after close without*Eet are undefined.""" aise NotImplementedError("This method must be i&!") # = LOCATOR class Locator:m """Interface for associata SAX eventp a docu=lJqion. A or objec/ll return valid 8nly duringEEcs to D[sHandlers; at any other time, tUJpredictableN` def getColumnNumber(self)""RQthe c(! n)` wherenP currWends.@8-1 sOLineqOlineo2PublicId p$ identifierINoneoSystemn s$n&INPUTSOURCEInputSource"""Encapsulationbinformneeded bypXMLReadYoPread Rties.s=may include V abl c,X , byte stream (possiblyi`characHTencod,r) and/or/ORof anyaApplics will createt\  usb,.1andF8Afrom2EntityResolver.r 'n q belongMa q is notgpallowedEimodifySbs pass%0it  f al`gh it 0mak@piess bKthosf__init__", `_id = ?q8.__" %PG ! g fOfile < A69setT%, P"SetsK1of S[ayg{~# ysetSystemId(self, system_id): "Sets the identifier of this InputSource.":T5.__U# =CA_id &def getSw0Id(2{oReturn~#r< SysetEncodingy3, e"character)b>6The+must be a string acceptable for an XML0 Edeclaration (see sec R4.3.3e;recommend-/).attribute< is ignored ie&also contains a stream.""]& =] 1GeteK 5usetByteSbytefileeam (a Python 0-like object which doesnot perform FF-to-conversion) UiUAs^R]SAX parser will reVP specd, but itO usin preferencqto open@ URIn!itIWq applicR know ,should se!th methodU! = g E  gxnj5forbw, or None unOn[ __: DsetC + S  (#F2.0 Unicode-wrappedZ5thaAV84 to>bings.)-u   WA any/i 2andpattempt aB4con"toU ! =Hstream for this input source."  return self.__charfile # = ATTRIBUTESIMPL class AttributesImpl: Udef __init__(W, attrs):w"""Non-NS-aware implementation.H)9 should be of the form {name : value}.""v"._==~TgetLength 1lenA):AType , >y"CDATA"5V6 [X]@oByQNam} G ?F !ifd not iFraise KeyError()F  By ~JwsxAlistz.keys()B'S__lens__getitem<w x__contains  5 a, alternative=None1getd 8Acopy_G_V@_-@.AbNd NSf(u)v 0, q ~z+(ns_uri, l\)u, ...}. y  :%: |:3s = nr pfor (ns#)[. "ifq1 ==. ?[i$C:/tems():  if qname == #: return ns raise KeyError()def getQNameBya(self,`)aY!._ s[G]GsB<AlistA.values()Acopy%@|_class__%._attrs, @) c_test(HXMLReader()IncrementalPars`Locato&` if __ __q"__main__"_: # This directory is a Python package. # # XML-RPC CLIENT LIBRARY # $Id$ "%an%client interface forVNthe marshalling and response p code can also be used to # implrrservers^Notes: # t0ionadesignF work with 2.1 or newerH0HisJ 1999-01-14 fl Created # 5hanged dateTime to localtime363Added Binary/base64 e, defaultGPRPC2 )icF9FFixed array}aC (from Skip Montanaro)'21@pconstrue, etc.2A2-022@hand!, e empty sequencesD!10Drproblem: s 26-2JPSpeed1rovs, pluggablSs/transports (0.9.8 2000-11-28Cpboolean{`check atruth  of its argu # 2001-02-2&"encoding/Unid/SafeT patches>compare supswrappers9/1.0b1D1-030Mak8&re[Ptuple a singletonz23-2LDon't requirkparamsVNicholas Riley$6- olin _xmlrpclib acceler(2B8UBase <. on built-in ExceptPaul PrescodPA9-03fAllow 1subYoverrideU9@Lazyg0orturllib, cgi,D(20x#s%upB10-0qRemove c inmemo cache when doneDthemGUse faster escape method (80% dumps CMore%microtuningfK!imPexpat(0,Guido van Rossum#) # 2001-10-10 sm Allow long ints to be passed asif they don't overflowM7MTest for6B andX00 (ams use on 64-bit systems1-12 fl Use repr()marshal doubles (from Paul FelixAq2-03-17AAvoid buffered read when possibleEJames RuckerG34-0Gdded pythondoc commentsr2-04-16q*__str__ methodTdatetime/binary wrapperCG5-15Cerror constaAndrew Kuchling26-2Merged with P CVS versionB10-2cA basic authentication (baon code nhillip Eby}@3-01MLdd supporthe bool type|@3-02gvr Remove apply call3Q!24RcStringIO if availablP4-25 ak A5nilu6_.gn%.struct_ 27gp Correct y of Faul3Qa31 mvl0mulG$llVq4-08-20'Bump minimum&$ed12.1>14-12-02 ch/dokoworkaroundx8gzip bomb vulnerability # # Copyright (c) 1999-2002 by Secret Labs AB. - Fredrik Lundh.[Rinfo@ ware.com # http://www.O # -0 # The XML-RPC client}erface is& YBy obtaining, usAand/pying this softi:associated docuT{, you agree that0havad, understood, #SP willJ{ fooAerms)Pcondi!s:`Permisluse, copy, modify,5distribut  # its any purposePbout fe hereby granted, provit ab+Qnotic<0ear Bpies=BbothE="ndp9 # Z4 inH ename of #N0 or=^ or_au[in adverti:)apublicC per[!ofSVQspecific, written # prior permis\sion. # # SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING 9xIMPLIEDAOF MERCHANT- # ABILITY FITNESS. IN NO EVENT SHJ 'OR # BE LIABLE FOR ANY SPECIALDIRECT OR CONSEQUENTIAL DAMAGESUANY #WHATSOEVER RESULTFROM LOSS OF USE, DATA=PROFITS, # WHETHERAN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS3`, ARISv0OUT@OSQCONNE! !USIPERFORMANCE #2T_. # -0 """ An XML-RPC client interface for Pythg8 The marshalling and response parser code can also be used to implementmservers. Exported exceptions: Error Base classe%s Protocol6Indicates an HTTP p! 3C R2x brokenckage Fault gHf$"pa4eSPProxyN Represents a logical connec0 toa<$MultiCallE Executor of boxcared xmlrpc request,DateTime5$ dqwrapper`an ISO 8601 str@or t6tuple or @Qlocal$Eger valuegenerate a "q@.isoa"J@ Binar+nbSdata e8Gtparams chunk from aaPuctur8UnmQLPincom,`XML evOBmess<PTransg Handltag SafeF B/S Cronstantg(none)1fun3get0CreiB centhe fastest availabl& attachuh;object dumpsqpConvert}AarguN# aZGyE (orP, if emethodo1 is). loadr  et"edd0plugname (NoneCnot ). """ import base64 import sys time from date %decimalDFhttp.clienturllib.parsa2xml$rsGEexpa2Rerrnon$io"BytesIO try: gzip except IRError$ = None #python can be built without zlib/.0sup_ # -0 # Internal stuff def escape(s) s = s.replace("&", "&") < $lthreturnB>"`gt;",) used in User-Agent header s__version__ = '%d.%d' % .info[:2]Oxmlrpc integer limits MAXINT = 2**31-1 MIN-;T0A- #  constants (Dan Libby's specification at # 2://-epi.sourceforge.net/5s/rfc.fault_codes.phpFRanges of eds PARSE_ERROR = -32700 SERVER600 APPLICATION 56SYSTEMS400 TRANSPORT300 # SNOT_WELLFORMED32PUNSUPMuNCODING1 INVALID_ET_CHAR2aXMLRPCpMETHOD_RFOUND!|&60]'bPARAMS] 60]dTERNAL >3C55ions ## # Base class for all kindS-sidec2. ,$(EN;"""PC>1"""Q__strwsobject.0Ind es an HTTP-level protocolO. This is raiaby the2 # trans layer, ifrserver @c  other than 200 # (OK). *@param url The target URL. # 1errG![ &1msgF%wmessage(s)@ dic5aryP P J__init__(self,, Cmsg,Hy.=K.9=P3=f ,:msg) _repr__(selfC): return ("<%s for %s: %s %s>" %# (self.__class__.__name__, 3url verrcodeImsg)K`) ## # Indicates a broken XML-RPC response package. This exception is # raised by the unmarshalling layer, if Y@malformed. # RyaError(=?""" 1"""Npass_faultPcontains # a unstringScan also be uXa, to # generateKW@mess b@parammCode The"H. # +S-F: dCdef __init__, , **extra*.? =X@#d %'Creprr Qx/ -0 # Special valueBackwards compatibility boolean = B UqWrapperDateTimebpconvertt0theB2mat$byQ

# !be given AdateTrobject,0 in{$ #b"yyyymmddThh:mm:ss"1q9-item Jtuple (as e! #`.local'()), or an integer 972w<Buses!XC to 2^Ato a,. \k,# n ISO 8601 *:, #j  a0. Fssue #13305: differentujs across plats _day0 = @(1, !) stry(fmtz=tryAAP.strf- == '0001'w V7 DFalse if _pb'%Y'): # Mac OS XK0iso4_1at(s5.strftime("%Y%m%:dT%H:%M:%S") elif _try('%4Y'): # Linux def _iso8601_format(value): qreturn .strftime("%4Y%m%n"se8X) W.zfill(17) del _day0 atry l)if isinstance(`, date$  )oif notO(tuple, S@uct_ )`"if>R == 0w" =?8!()p Qlocal!3)"%04d%02T :2" %~[:6] class DateTim4""" wrapper for an ISO  string or 1 or integerq to generate 'xs.o' XML-RPCC. 2"""_init__(self,X*=0\7str#L?.e" =Fl$el -_[make_comparableHothe~ , 6 = }Ao = =$Fsa Mlng W hasattr(0, "d"#"2)"ENotImplementedsFs, o 6__l+e.4,]if o is | 3 #B;s <eEtUd=gA}>A}>Aef __eq__(self, other):  s, o = self.make_comparable(,+if o is NotImplementedKRkreturn#Bqs == o def timetuple(0 P.strp $ .value, "%Y%m%dT%H:%M:%S")V!##]# Get date/; 6.# @dD% , as an ISO 8601 string._q__str__2?rep3"<%s %r at %#x>" % ].__class__.__name__,A, id()RdecodO,atr(data)`7ip(D'enD7outCout.write("< >")b/|="BdnnF out.write(encoded.de('ascii')) %out.write("\n") def _binary(data):="# T xml element contents into a B7 structure:]# =(g,qreturn  WRAPPERS = (DateTime,Ho) # -0 # XML parsers class ExpatP`fast e- for Python 2.0 and later.I_init__(self, targetR"._|$ =X=g.Create(None, B?V# =_}Wr.StartEuHandler, .s 2?End02try378 = Dexcept AttributeErrorA&ss0:lse3del[,x# get rid of circular referenceZ4b"", True) # enA+*;-RPC marshall(un|B ##[ 1u@param vDefault\P8-bitNings. The d) #)1 isO (interpreted as UTF-8). # @see dumpMe"""Generate ans chunk from a[.g6 a ` instance0each set]aeters,="us2Qthe "" method tomvert your }(represenra tuple J!o 2 a xresponse, paF ead. You may pIuse Bodulfunctionthis purpose'2""";A# byDpway, if don't underEd what's go{on in here,2# tperfectly okD_~=V, allow_none=: memo = {}l _% = :q' =~dispatchr9,es): out = [] pwrite =u.appenddump = self.__if isinstance(values, Fault):&c0# f - }1("<#Y>\n")s1({'rCode': k.,1q" 1kString3}6 A("n0 if\re are no +s.D'however, changing this may break older code (includingEold versions ofrpclib.py), soU`is bet{left asG is for now. See @XMLRPC3more inform$I. /FAs \Cv in8 ! A@#1v, + "&C Presul"".join(outcrreturn % Bdef (,6try fdispatch[typ)except KeyErrorDr# checkkis object can be marshalled as a structureif not hasattr;, '__dict__'?3raise TypeP("canDq$ %Ws" % JG qclass i2ub-of a basicI ) # because we don't know howQthese? R(e.g.wsw _ &).__mro__1ype1.o.keys(T6X6XXX(twouters): us"_arbitrary_"0keya quick-fix!#p3yk merge,Mshould probablyuafixed (jneatlyfW{ __nil 'K_non0~ None unlessDwenabled-d><1kean>")" and "1" or "0$4"\n&dispatch[" Olong "if > MAXINTo < MININT raise OverflowError("int exceeds XML-RPC limits: >intstr(int(,))90"fmytearray%&l"  ci = id>if i in _.memoCTypecannot marshal recursive sequenceU [i1yJ" =x __ j>6ing write("%s\n"!struct><5Time.iso8601>mfX3K/E <^ instanc # check for special wrappers"if .__class__ in WRAPPERS;." =Gb.encodB:Jelseg# store  attributes as a  (really?g( __$$__y@Datey| 'oBinary%# XXX(twouters): using "_arbitrary_U"0keya quick-fixl# the p3yk merge, this should probably be fixed m.qneatly.E~ ## # XML-RPC unmarshaller. @see loads &' U$5"""5 anN response, based on incomXML event#messages (start, data, end). Call close() to get 'resultingD3 Bure.8Note tha1&is reader is fairly tolerant, and gladly accepts bogu/ dwithout complain(but not4)2"""#b again, if you don't underd what's goT/a here,#'s perfectly okdef __init__Duse_E@=Fal0bui5b_types)Dq = None{stack = [_marks411 = f`methodxj$= "utf-8"ABnd =8_. )_&0 =  !1 or$? by<\k# return (a tuple(0tart#ifZ!._sraise RfError(5 P== "fault":  raise Fault(**self._stack[0]) &eturn tuple(%!) #def getmethodnam$!):Dr@:'>#'# event handlersZ1xmlt, encoding, standalonef_%% =0a# FIXME: assertG == 1 ???xSstartztag, attrsp# prepare to this elementwif ':' in tagPtag =.split(':')[-1]<$= "array" or0"struct"Smarks.append(len)-data = [wvalue andu0notdispatch~QResponseError("unknow` %r" %M j4= ("dg, text_ !%,z # call the appropriate e6try<@f = X.F[tagGexcept Key  <T _9(# B?#  c2 ! fd"".joiv)accelerator support_RRIF$# %   6 f decodZ = {}Cnil ON_A = 0q["nil"]Zd_nilobbooleaZ,!if0VFalse(el9199Tru8&se&P4TypCbad  "w 6  $in|%data))  self._value = 0 dispatch["i1"] = end_int2 4 8 /ntbiginteger%!efpdouble(, data): .append(float(!)![{<5W #$bigdecimalD)a ostring#if encodingHL! =bb.decodt$._/ Vw7 pKname" # struct keys are alwaysJings_arraycmark = fs.pop(a# map Bs to Python lists*vp_stack[E:V[]2o *CdictionarieU = {}Uitems4#for i in range(0, len(9G), 2>c[0[i]: ,+10m@ = [: $TU Vobase64VWgBinary! .e("ascii")Lpuse_bytesqK1 = .LRLaVb rdateTim RnD = D&z aOtime_R_type =v.iso860 # if we stumble upon a element with no Ernal##s, treat it as a1" 7def end_params(self, data): ._type = "params"dispatch[] = end_% %!ef_faultb) a` _methodNamed2if encoding! =b.decodG$._/)+Gp0nam> 0(s" # no J@& ## Multicall support # class _QCallM# some lesser magic to store I`s madea^Bq objectp# for b executiondef __init__oRp_list,  @_!! =-N U_;! =Biugetattrl&amreturn&._y, "%s.%s" % KrW*argsp$.append(T5)Iterator2""" es over the results of a mp. ExcepQs are raised in5Aponsqxmlrpc &Vs."""+ k  =WAugetitemi>" =jE1[i]0if ('B) =='{}B'! F1+!['Code'], String']</ele,[]e6M0BelseNValueError("unexpected2"V`"""serS-> anp uto boxcar (s|5should be a SHSProxyG.,Qs can* ddo] using normalu syntax e.g.:U=/( _p(.add(2,3get_address("Guido-j#ToheJ, Badd_u#, a& =A( ). R = []/H4repVr{"<%s at %#x>A__._a__, id\())\1ist, name) def __call__(self): marshalled_list = []for name, args in >.L0IM.append({'methodName' :Sp'params^5}) x return MultiCallIterator.__server.system.m'()) # -0 # convenience functions FastMD@r = TParse %UnNone ## # Create a p0object, andonect it to an uGing instance. # This picks the fastest available XMLl . h2A (,fer) tuple. A2get%(use_datetime=False, builtin_typesi6"""?C) -> pn? of1attach itF4_B. R_Rboth !s.61"""(if.ifk.5 = :'n$mkbytes = base64.decode)#elqTl-w_binarya/seT1 OPtargeW Bs(True, @5, m-Eult)i c(_$(el8 =  G h " / ? 6RExpatA (", Irt a Python or a FaultLXML-RPC packet @Pdumpsams, **opQ) # @Vams Ad bB@key.D If given, cP requPfor # t"2Yresponse]R"]Id with a,fp must bsingleton (that is,"it' contain exactly one element)Pencod3The| *PA str([ Ecd data .name=None, me thodresponse=None, encoding% allow_none=False):"""data [,options] -> marshalled  +!Convert an argument tuple or a Fault instance to)qXML-RPC@request (or , if the me is used).pIn addi`8 object,I fo3ingDs can be givenas keyword"s:b/Qname:R ! fCall packet=Q: tru create aR@.}I#isr with aozumust be?a singleton (i.e. itcontain only one ele[|<QR (defs UTF-8)All byte strings in7structure a`ssumed0use& j. UnicodS=utomatically c1ed,Cwhere necessaryP2"""0ass$is(params, (G,U)), "[t "x?if V*aY0A = 1=Celif?andRR3len) == 1, "J3 eif not = "utf-81TFastMr3Jm = (F)*se/G+&, ]E= m.dumps%if% !fxmlheader='%s'?>\n" %V H!# :7 # Sdard ` wrapp9)o#: + (""<@Call 4sName>",R, " unmarshalle/pConvert > toA@ pludGA !F&p, u = getparser(@ G Y)UQ.feedbclose(#u.r, u.get#P() #Encode a]4 usEAgzipYPent e'@suchspecified by] # Content-SPing: CP # in" HTTP header,Cdescribed!RFC 1952!un2 w_" "TVe6 ?as Zo7 NotImplementedErrorf = BytesIOAwithK.GzipFile(mode="wb", fileobj=f, comslevel=1)e6gzfzgzf.writep+f @valuC/De:Theb# @keyWRmax_dMaximum bWD(20 MiB de) negativ#s for unlimit2X;ingVXl !istcorrectly ld{ *s 51maxpped pay length WBededl&, =20971520/ E> (% E r >)6try if max_decode < 0: # no limit decoded = gzf.read()%Yelse:B7Bmax_F + 1Eexcept OSErrorKraise Value("invalid data"E7if \>= 0 and len(pGd) >#c_max gzipped payloaI@gth Cededvsreturn b ## # Ra file-like object for thee encoding # as described in RFC 1952. X@param response A stream supporting a  method # @aAthatPt can beHfrom class GzipD R((.sFile if$ls)j?"""o%qed withd],(w1""".def __init__(self,<.#Ptdoesn'tOq tell()GU@quired bycAaif not 'kNotImplemented;.io = BytesIO(wMz.mode="rb",Cobj=[!) mQclose:try h4Hkfinall7o.1) # -0 # request dispatcher!_M# some magic to bind an XML-RPC#0an qserver.#s "nested"1s (e.g. exas.getStateName] psend, n#9$ __0 = |1! =8Zugetattr&r .f, "%s.%s" % =Ecalla^*argsb N/Standard trans Oover HTTP. #

# Youcreate customEs by subLCthis,0 # V ri] selected"$s.3T"""Handles+scaction-1q # client identifier (mayP2denfpuser_ag.= "Python-xmlrpc/__version__#if true, we'llG> acO__O!b= TrueK# if positive, encode request using gzip if it exceeds thi4reshold # note that many servers will get confused, so only useVif you knowKFthey can dedsuch a*3_th = None #s= don't 2def __init__(self,_datetime=Falsebuiltin_typesD*, headers=()):!\U._use\) =k* r/  4connection = (,)( = list( &cextra_R = []3!##O# Send a complet', and parsssponse.7TRetryIa cachedshas dis#ed=C@param host TarN % dandler"RPRC h )_body XML-RPC 0verbose DebuggEflag%return PDd reqpp,,x#, koO)#rF@onceKIgcfor i in (0, 1X6try4le_]M8pt http.client.RemoteDuQQraise`cOSError as e;Q or e.errno.ECONNRESET, ABORTED,os<KPIPEj2Q  `t,'l issuej} _v0 = x_.send(! =W@.get(!if,.status == 200$ =!_w )**ZFaulto$(PExcepd ,#All unexpected1ors leave)in# a strange ewe clear itV[close=[#We got anZtO#l@ard onse data and raise exception if resp.getheader("content-length", ""):182eread() raaProtocolError(5host + handler,Qrstatus,jreason&Qdict(+6s()f1) Z"## Create parser. @return A 2-tuple aining a3 and an unmarshallGBrdef get[W(self(#DA?Fuse_datetime=S(._ B'builtin_types? )"Get authoriza info from parameter0# Hmay be a string, or a (1p, x509-!) YF; if+Git is checked f@"user:pw@H"Bmat,s "Basic>Authentic"" RQaddedqppropriatedescriptor (URL)I<3<q(actualas, extras#&]c. The$sfields kRNone.z_&_~,q"):$cFA= {}5if isinstance(Z=WU,k = urllib.p._splitZiO:uthGI Cunquote_to_bytes(%  = base64.encode,0.de("utf-8"<q"".join].B()) rid of whitespace<_mYs = [" ("M@A " +h 3]EJelse% q]> )* onnect to serv~*@aTarget rn HTTPCMion objectmemake_c r#an existt4possibleis allows+#/1.1 keep-aliv_2if >T,= ==:[0]x E&[12# c]a>`DaG dc, 7get5D  , http.client.HTTPConnection(chost) return self._c'A[1] $"## Clear any cached - object.*Used in the event of socket errors*0def close(!):,f=,'if)CGV = (None,  ,.)Send HTTP reques# @param  Host descriptor (URL , x509 info) tuple)Candler Target RPC h(a path relative tor_body The XML-H  debug Enable rging if is true<!And.6Ssend_r,,,I,i Gmake(mtheaders-_+<Textra6 :|Q.set_vlevel(1q"ifZaccept_gzip_encod:@and X4putg"POST"Sskip_WRV=True}.append(("A#-E@", "&")8Oelse A uContent-Typertext/xmlv 5User-Agent",F`user_aIB(#, /c /oo4X;rThis fun_ provides a useful hook for subclassingzZ6}X httpOA lisZkey,value pairsk) de$nduJ_@ valR!CB.put#(6AIFe M_ 0#opqQally ey?1if .$_thresholdo1notE and262c< len(b_body) and  vgzip):  connection.putheader("Content-Encoding", "=)")=request_body = " _e3(e(%) 6o Length", str(lenF)}G2ends.t!##{# Parse response. @param file Stream @return R8 tuple and target method.nPdef pi_ie(self,x}e# read data from http@,lT1 it# Check for new3K object, otherwise it is aMif hasattr(w3'ge'/'.%3S") ==: wIsk = GzipDecodedi3OelseI(0u,-pp, u = u'r( wh"1=8Z(1024aif not >Ubreak"if_verbopprint("x :"_0pr(#Hbp.feed^{!is  *v.close(p%u## # Standard transport classXML-RPC over HTTPS. TSafeT3( """Handles an:aa0 to_server."""__init__use_datetime=False, builtin_typesH3*, @=(),Otext=None'super().{au ,cA' >cDxt =/ # FIXME: mostly untestedMVmake_TGhostrGelf.)'":[0]b ("1]dF.client, "bC"< ra&NotImplementedError("your version ofxe doesn't sups1# create a6 !a descriptor#Pmay bGstring, or a (6, x509-dict) tuple  chost, self._extra_headers, x509 =@get_+`_info( ") B !_connection = !, http.client.HTTPSC$(yDLNone, context= Q, **(for {})|mreturn4[1] ## # Standard server proxy. This class establishes a virtual  # to an XML-RPCK. #

#Lis available as SvPuC and . New code should # use/,u@voidfusion. H@def*@(uri" op~s) # @param uri TheApoint on theB@key4transport A pfactoryPmpati@withG #si5_'^encodingdefault used for 8-bit strings`(.is UTF-8)Z verbose Use a true valueG!en`debugg~`outputA (printed*"dTsee T! :0"""p#[,] -> a logicaPh N DA isU , given as8scheme://y/target.Simplementa+ always supx""" RQ. IfbSSL socket/ (Python 2.0), it also+Z#s"!IfQ part!lash prece,Nre both omitted,q"/RPC2"cssumed]afollowu can be: keyword argu"s:3:N~':grequesb:All@ pas!toI0 arK;1use*.2"""e'__init__(O,,=r?Ib=FalsehaWS_none#_datetimbuiltin_types-L 3*, s0=()a)Z&#C a "V".31getO5urlx p = urllib.parse.urlsplitGYRif p. not in (1", 's"oraise OSError("unW%ed9protocol"h!._\ = p.netlocoandler"un ["", *p[2:]]b!ifself.__handler:'  self.__handler = "/RPC2" &if transport is None:Kif p.scheme == "https"$(eTSafeTU L( extra_kwargs = {"context": }4;elsFnj X#= N(use_datetime= , .builtin_types@ Eheaders=1(**O) &encoding = or 'utf-8'Tverbose = !allow_non$ wdef __close()I5.__.&)9qrequest;, methodname, paramsO# call a& on the remote server[Y = dumps(O c=4!).@1.__ ing, 'xmlcharrefreplace'Pspons]2(1&Jhost J  mif len(re)>14 = 8[0]EturnCarepr__ !re1 "<%s for %s%s>" %C.ass__.__QD__, 9 -jdgetatt , Nt# magicdispatcher!_MP # note: to object with a non-standard?Q, usep#\Cult (@, "sVge-python-0")( d , """A workaroundget special.dibutesSQProxy\! out interferN#__%__:5""" !ifo"W t"<(el>.B &Fraise AttruError("0 %r f*P" % (M),)menhreturn self  def __exit__(self, *args): .__close() # compatibility Server = PProxy'-0 # test code iname__ == "__main__": # simple4program (from the XML-RPC specification)<qlocal s, available ?Lib/xmlrpc/"1.pyt ("http://Shost:8000"k6try_bprint(F.currentTime.getC1())oexcept Error as vJ"ERROR", vnmulti = MCCallmPlXData(xpow(2,9radd(1,2 for response in W(FJ'FDr"""ms. This module can be used to create;mBs by!Sing a and either install@func-s, a classnce, or by extend-kSbXMLRPC7Q. ItHalsoVhandlprequesth a CGI environment usi2CGIbR-HCrqe Doc* !esr a that  pydoc-style docuw0dHTTP GET !.  5 s dynamically generated ba!ongmethods registered with*A list of possiusage patterns follows: 1. I j#: L 5(("0", #))1._MO(powlambda x,y: x+y, 'add'1x_foreverj2%anp": J MyFuncs%in|# make all'6systhrough sys._mx`importN=MW fP! t(1 soHGtem.Bnp# knowsvadvertise4 .-areturn_public_#E + \- ['3' +O 7Ma.sys)]N;, x, y): *R* +_x + y0Pintro_functions() server.register_instance(MyFuncs()) s$_forever() 3. I/dll an :* with custom dispatch method: class Math: def _listM"rs(self) c# this@ must be present for system.DY=eo workreturn ['add', 'pow']AHelp,x!K_#ifbA == 2"add(2,3) => 5"Q*elAApow(x, y[, z]GhnumberL*se<# By convention, Uempty# string if no help is available-F"{w' u, params}*={ , 9S[0] +"[1#,el'raise ValueError('bad3') ? = SimpleXMLRPCST(("localhost", 8000pptrospecA_fun %s(*?ath b4. Sub &:tryt# We arecBthe 'export_'cfix onP`s that1Q# calj through XML-RPC toE@ potal securiproblems\p = getattr+)5except Attribut 3E)Rion('-P "%s"9pnot sup^ed' %dl(QG` , AWx + y 5. CGI script:Q2CGIRequestHandlNDE(powh/"_r=() """ # Written by Brian Quinlan (b@sweetapp.com). # BasedWfcode w?Fredrik Lundh. from xmlrpc.clit im Fault, dumps, loads, gzip_enV de HRhttp. FJHTTP/Dools-rpartial!insignature ZFhtml y import socketserver import sys o $reTpydoc traceback try: Ffcntl except IZRError% = None def resolve_dotted_attribute(obj, t, allow"names=True)T?"""Ea, 'b.c.d') => a.  RzBs a }n} e to an object. Raises;Dan Aw if anyBin the chain starts with a '_'.!If%optional argument is false,s are not0suped and th+0uncU operates similar0getYc!).H2""" tn=1s =.split('.')DNelse*[3]]for i in?s,Rif i.*)C('_'tr z(v'attemptaccess privater"%s"' % i?M hobj = ?i/Qretur,list_public_methodsnA"""R1|+7 ofstrings, found*Jspecified, which repres&wcallabls[member  ain dir^ ifh * q 2:(-E))] class SimpleXMLRPCDispatche,"""Mix-in ,dthat d%s XML-RPC requestsTT2pis used register6 handler> en1i7m. Vdoesn't ne[!beinstancedKectly when)by Seyb but ivcan be E <MultiPath.CzP__init__(self;bnone=F>encoding=,Ause_builtin_types9'ZP.func%{}C1>b B5 = or 'utf-8', =q w_&0_Ns!=6Prespooi  vOnly on  llt a time7.et0 haK_t86method will be called with the name of XML-RPC method and  its parameters as a tuple"e.g. instance._dispatch('add',(2,3)) .Irregistered; does not have a KDAthenv will be searched to find a m %):qC"""Ri2*arespon) Ks3The!alb0canruto set a Uniqr0for.?}# decorator factor0is =`returnAtial!.8$"ifX,& =_%__.X s[,]-'Q Aospesx @PtxesystemWspacesee http://xmlrpc.usefulinc.com/doc/resed.htmlN .update({'~S.listTA' : *_,K8FSignatureJ ,   'system.methodHelp' : self._@}) :def register_multicall_functions(?!):,0C"""R/s the XML-RPC < e1 in z@namespace.T$see http://www.xmlrpc.com/discuss/msgReader$1208"""=0lf.s.update({ _marshaled_dispatch, data, E = None, path (DFees an (c from rled (XML)j 4Us are"edDHsQusing1andresult is returned asA_ . For backwards compatibility, aAN can be provideargument ( 1com %in@ SimpleXMLRPCRequestHandler.do_POST) but overrid?Pexistthrough subclasipreferred meanof changF behavior.q 6try?tparams,= loads([, use_builtin_types=.P# generate response %ifais not 0E, =8(E)gOelseM L e# wrapP a leton tupl( ,Fumps(!9=1, allow_none`, encoexcept Fat@as f 7$&, g] 7 # report 1ion to server#1exc,/b_value tb = sys."Vinfo(wT !  l"C(1, "%s:%s" % (f:}/)) f kfinall# Break dence cyc(& =K LNone return response.encode(self &ing, 'xmlcharrefreplace') def system_listMethods@!):"&2"""%.%) => ['add', 'subtract multiple']fDR@s a D of the mq supported byserver."""C-Q= set.funcs.keys())1if instance is not None4# I$can implement 4 tohkE if hasattr7, ']'s'hMO' |?.=92# iX. a _dispatchqcIn we# don't have enough informationsprovide >#of^sAelif~ <_public_& ^sX(.Signatur<,W_name  6double, intdescribing$ s @. In V0abo xa,C add takes twoegers as argu3andIFult.tRThis  does NOT:.  # See http://xmlrpc.usefulinc.com/doc/sysFsig.html'2'+JAHelp1K"AddHtogether0strpcontain 1doct?1forspecifie /! =i[2 in @![;]S%,& [:Phelp au O _ . tU f{":try method = resolve_dotted_attribute(  self.instance,/method_nam-\Tallow8se)"except AmError:'Upass # Note that we aren't checkingBthe actually@be a callable object of some kind,$ifGzis Nonereturn ""1?els$pydoc.getdoc()def system_multi(h,f_list)x2"""...2[{'S!Name': 'add', 'params': [2, 2]}, ...]) => \ [[4]jA s ?er to package pple XML-RPCs into a single request.\!See http://www.xmlrpc.com/discuss/msgReader$1208K6"""Fresults = []"1for1 in43 ! =%[4L-8(&']%:tryc# XXX A marshalle0anyponse will failnVentir>K#u2. Ione carey should fix this.@2.append([[._dispatch", *)]Fault as f  i !{'=rCode' :J.4kString6}lexc_type, Cvalu @tb =.Zinfo(Q ( 1+ "%s:%s" % ( )I0fin#/# Break reference cyc$& =N OC>+] ,C"""D }Js4 forwardeda registered functionKm.gF+edn uno suchIDQexist]Tll ised to the registered instance, if available. If the re; has a _dispatch method/en thatDwill be called with-r name ohtXML-RPCL5andFits parameters }Utuple"Ee.g..('add',(2,3))does not haver0theev searched to find a m&3ingEand, if fou B'M`s beginnICan '_' are considprivate anj%lln.6"""Etry: #function4 = self. "s[]&except KeyErrorsFpass*:lse0Runc i;Non!preturn ~!(*<%s)T!aaise ERion('T "%s"[supported' %F"ifQ6 if2Qattr(25, '*')|`)`* o > r,Ys<z$'sydirectlyr 9G = resolve_dotted_ iibute(B1 ?TallowpfQD AAttr9 e)(r&class SimpleXMLRPCRequestHandler(BaseHTTP2"""; r>" h? `S`s all Sc POST 2sattempts`decodeQ2m a fs1# C8P list accessible path components;I#,3!is@result in a 404 e@rpc_Rs = ('/', '/RPC2',1#if*A, enresponses larger!is"po3_threshold = 1400 #armon MTU#Override form Stream@: fufPufferof output #and no Nagle. wbufsize = -1disable_n%_algorithm = True $# a re to match a gzip Accept-Encoding+ aepattern = re.compile(r""" \s* ([^\s;]+) &#content-i (;=qC= ([0-9\.]+))? #q @""",VERBOSE | IGNORECASE)Qdef a#_es(self):^er = {}aq#.headers.get("Ae", "")5for e in ae.split(","d!= \|.&(eL,"if2v =.group(39#float(v) if v else 1.0'!r[Lu1)] = v&return rLis_rpc_path_validM"if&sRE3 0} =e# If .* is empty, just assume all [s are legalT2$|do_POST"""Handles the HTTP ( request.W0Attszinterpret 6s as XML-RPC calls,0whire forwardedR~server's _disp`method+ h2ing<X# Check that#B !bif not eport_404(!F:>#q  ac_|ings().get("gzip", 05;Oif qY?try!0 = h~e 5hEy0inglX hA P NotIP0edEF Ipass{  uCwfile.writ'`def des_"_c)A#sup'# ?Vz,s!d-%uidentity").lowerT!ifkding == "identity": return dataif encoding == "gzip7:tryHSL/_decode(X)Y% except NotImplementedErrorQ self.send_response(501, "%r not supported" %x_Valueo0400o  content"fJelse5Hheader("C~-length", "007/As() `def re*`_404 (()1# R!0 a #e<0 6404 = b'No such page'C@typetext/plain  7str(len(&)) wfile.write@4log_request4 , ='-', size H """Selectively log an ac3ed JB."""c1if server.logRqsBaseHTTPRHandl0) class SirqXMLRPCShs(socketu2TCP, DDispatcherd XML-RPC Z<  that allows functions and a single instanceCto blled to hYs. The default gaZCattempts<dAcall7the*or0in + Override__method inhegdIfromSPchangIis behavior.9<9_reuse_address = Truet# Warning: this is for debugg purposes only! Never set/!toL1 inwq# produ, as willSout sensiq inform}" ($ioOstack tractails) when .s are raiseC2sid #= qdo_POST__dRback_Fs = Fals+__init__R,Xl=G s8=,a_none=},_=NoneD`bind_aS3ateJbuiltin_>sQself.logRequests = logRequests @SimpleXMLRPCDispatcher.__init__(self, allow_none, encoding, use_builtin_types) V socketserver.TCPS Wbddr, rHandler, bind_a ctivate) class MultiPathV(!):1"""2path XML-RPC " This specialization of PPs ther to createHmFple B instances and assign@m<different?DHTTP As. makes it possible=run two or mor'virtual{Ps' atv same port.sMake sure th" r acceptA in >2ionE1"""MOdef =XH=X=TrueW=Fals =ND JJ Q/):2 , [ n Uelf.d%{}r." = %% =fr'utf-8'Fadd_o$%&,  s[,7] =.hreturnw?getwk?r_marshaleFdata_method = c u2tryqresponse = .?,j ex @# re low level '@backG" tw# (each} should have hdPkir own=ds1exc ,Q_valu0ys.info()[:2]O TJXidumps(3"Fault(1, "%s:%s" % (j0typ5"xc/))=S  .Jeg E'xmlcharrefreplace'Okfinallad# Break reLrce cycl exc_type = exc_valu cNone &return response class CGIXMLRPCRequestHandler(SimpleDispatcher):P2""" " h/ for XML-RPC data passed throughgQ.""" ?def __init__(self, allow_none=False, encoding=, use_builtins( .ic^)s_xmlrpcr-W_text2"""@ a single20 = ._marshaled_ds(8j;print('Content-Type: a/xml')g(Length: %d' % len()4sys.stdout.flush(buffer.writeVE*L#i1getfX HTTP GET !.Default mentation indicates an error becaus$uses the POST method.T 0codk5400 `messagxplain = Base e.} s[G] = http.server.DEFAULT_ERROR_MESSAGE % \|{ '\@' : , "e" C} .e('utf-8`Status0 %s(  4!CONTENT_TYPE ;,* E aU postPIf nois given n it is read from stdin. TheeugJ;$o<out along withc correct :Jheaders)ifg@K and&os.environ.r'REQUEST_METHOD', 8) == 'GET'_^Jelse,#Fis normally available%Bh:tryMl = int(os.environ.get('CONTENT_LENGTH', None)) except (ValueError, Typ )):,7length = -1if request_text isnA &= sys.stdin.read(_)) \self.handle_xmlrpc(F) # -9 # Self documenting XML-RPC Server. classHTMLDoc(pydoc.?A"""C+used to generate . .j for a se2""" def markup(  , d, escape=, funcs={}, e `method """Mark up some plainTgiven a cone of symbols@look.EEach- dictionary maps object name?banchor.# =@ or .mresults = []here = 0+N'# XXX Note that this regular expression does not allowE theY# hyperlinkof arbitrstrings be2as nAc. Onlybs with81sis_of word charactersGand '.'s are&edpattern = re.compile(r'\b((http|s|ftp)://\S+[\w/]|'d7r'RFC[- ]?(\d+)2?PEP2\.)?((?:\w|\.)+))\b'zwhile 1Q@matc.search( , @!if6y: breakstart, end = &j.span(F.append(t[s:F+])all, scheme, rfc, pep,Adot,vkgroupsx#if@ 5url< (all).replace('"', '"N5 '%s' % (url, url>l/fc'w ://www.rfc-editor.org/rfc`%d.txtdzint(rfcl?pep sapythondev/pepsd-%04d/?pepK[end:end+1] == '('results.append(self.namelink( , methods, funcs, classes)) Pelif ?Idot:%results.append(').%s)"""Produce HTMLumentation for a#orB."""anchor = (cl and cl.__V__ or '') + '-' +0notT&''LAtitl!@(N;.!),a)w1if callable(r$!argspec = str(signatur-t,elp;g'(...)if isinstancL, tuple0[0]T\ docstring =![1-%""(6pydoc.getdocrdecl = #+ A + (Jgrey '\n,,Ulcserver ), package_docn XML-RPC c fdict = {}key, value ins.items(B[key] = '#5keyO8$P&3P_@headpR ! t hH=#   #@ strc&centire.F D i_html_% . P) => F QynzR { 50 us rintrosp #Lpinstall!un+s]0ncegPat doh` impleD_dispatch. Alternatively, Mcan choose toOKR_get_B_arg(M)hCyprovide1argh in$ bG5thewOHelpq help text)Fk vfs = {}&2 insystem_list(]f 9-*d 1lf.%[?]-Belif1 is ONone]_info = [% , @] # Apec,mentation  %if hasattr(self.instance, '_get_method_argstring'): A (info[0] = N.L(5]name)V 9OHelp1B )_ = tuple24!= (None, > 7 = : elif notdispatch?try{ = resolve_dotted_mibute(7  ,3z_0texcept Attr_Error~ ~OelseC6;assert 0, "CouldCfind2 in:functions an&= "\" illed" 0"s[l+ documenter = ServerHTMLDoc(v%a4 = qer.docs6-)-,2t;s;)hreturnpage(html.escape.utitle),0) class DocXMLRPCRequestHandler(Simple&"""XML-RPC " rM" hN l.bs all HTTP POST2R attempts to decode them a$xfsY+GEXi<0preZPx}:for'.#""def do_GETb 4"""2the*I)Es as ? h# Check that8 path is legalJpis_rpc_)w_valid(T&report_404pdsponsej.generate__tion().encode('utf-8') self.send_response(200 header("Content-type", "text/html"6length", str(len(w+))?t+s(wfile.write@ class DocXMLRPCServer( Simple,&DocGenerator):-"""XML-RPC and HTML documentation sp!. /Adds the ability to!r<!to-2cap01iesG/of.2"""kdef __init__(, addr, requestHandler=R 3log$s=True, allow_none=False, encoding=NoneD`bind_asctivateJuse_builtin_CsQf.', Z -, M T )2CGI/O( UdT for Adata Ss passed through9CGIhxA_get2"""t#HTTP GETCInterpret )Ds as5s? 7 0 = =".g e__B1().Hktprint('eType: r )L: %d' %  ]Rsys.stdout.flush!mbuffer(E*Lx W f} *0 iname__ == '__main__'import datetime0Exa2ice/v|getDatareturn '42'NRcurrentTimO @sqcmethod&mC:(0"t. Rnow()Owith(("localhost", 8000)).register_function(poCw)  server.register_function(lambda x,y: x+y, 'add'9#instance(ExampleService(), allow_dotted_names=TrueLmulticall&s(.qprint('ang XML-RPC on localhost port 80008It is advisable to run this e  within a secure, closed network.]Etry:U\C._forever except KeyboardInterruptE4"\n($ i) received, exiting."$0ys.a(0) imcontextlib$os GpathdshutilEstat y4zipfile ___ = ['ZipAppError', 'create_archiveAget_preter'] # The __main__.py uj`if the rs specifies "-m module:fn". # Note thatwill always be written as UTF-8 (>t and #  @ can5non-ASCII in Python 3)m We add a coding cookie eveHCoughg!isxdefaultH # becausPe res3ng (@ may(@nded!beTunder2. MAIN_TEMPLATE = """\ # -*-p: utf-8{$} .{fn}() """Windows launcher sHwhen parsshebang lines ^ile has no BOM. So#3on hZOn Unix,!_system eno . if sys.platform.startsr('win')F_9A = ' o' else%\6get{A() class a(Valueypass @o. manager def _maybe_open(,eFUif isW"(str, os.PathLike)0 Rf'qyield fq" C e__prefix(f,"""Write5.X\5 = b'#!' +\.#e(%) + b'\n'_!f.*kDcopym4new D=Non"""Copy an applica0ifyP'rb')6src a# Skip:PR fromeource.# Read 2 bytes o5s& check if they are #!. first_2 = src.read(2)5if != b'#!':B# Discard the initial 2 bytes anqrest of$shebang lineLjI b''f45() with _maybe_open(new_archive, 'wb') as dst_write_file_prefix(dst, interpreter1# Ire was no 3, "" contains L `ource Q, so =m before copying DHA JAdst.N(_pshutil.^<obj(src,(](if isinstancefFstr)^os.chmod$xos.stat).st_mode | .S_IEXEC) def create!(s,, target=NoneBmain + j2ter  compressed=FalseA"""C{ an application W from SOURCE.3Theq can be@namea directory, or aeQ-likeobject referroPexistzv!en_ is packed?in TARGET,yTwhich . oNZOqomittedGwill default to+QA.pyzKappendedd`dhave akp specifOWthat it should run xINTERPRETER (the'beR!ifJ20is !),@a __b__.py bruns MAIN (if !isH3not0iedA  GPused)tan errorJ#toIyafw@nythBo0 th a!noGvd/ikdi Qh( I1"""0# A` ?*1_is1 = if hasattr&'/ndI' _2TruFelse( = pathlib.Pathw2#ifO.(koe}_ return # We ar8e creating a new archive from a directory. if not source.exists(): raise ZipAppError("S,Q does<5!")Ohas_main = (TQ / '___.py').is_file(21if 1Dand > gA"Canpecify entry point3the[ ( or&) #"AR hau1") P_py = NoneY# Check thatPright formatmod, sep, f_c.partition(':'P+_ok = all($.isidentifier()\  in mod.split('.')E/fnD/fnC_sep == ':' 0mod[ ensxInvalidkQ: " +8wMAIN_TEMPLATE.K(module=ISfn=fnif target is=G.with_suffix('.pyzv#elhasattr(9, 'write' = pathlib.Path0f _maybe_openNb') as fd_cT@_prefd, interpreter"compressioD@(zip.ZIP_DEF-D9'bed els ?fSTOREDj!0ipFT'w', aGion= zpfor childT.rglob('*X,arcname =6.relative_to0if filter3 or(P2!z.~(,m}.as_posix(Q3:_pyKIstr(2,_py.encode('utf-8Zbc.chmodc.stat().st_mode | .S_IEXEC) def get_s#c#D, 'r{.read(2)%Vb'#!'return f'Alinerip().deshebang_"4ing`(args=p"""Run k`zipappm]9Rface.The ARGS2 amP lets you syLargument list hlgAOmitIb(or seQit tovq) worksor argparse, usingsys.argv[1:](wument list. """ import argparse  5r =.ArgumentP%7r()'c.add_a ('--output', '-o', default=None,8xhelp="The name of the ? archive. 0 "Required if SOURCE is an6" apythonp P? interpreter to use(: no shebang line). 2maim1 functionOqapplicaKan existing __Q___.py compressSQc', a='store_true'C8 files withdeflate methodF3Aare eDd unTed byyf 8inf_FalseqDisplayAfrom _sourc S directory (or]Yrargs = . s()# Handle ` -m zipapp=`pyz --!`.X if  s.:if not os.path.isk.),0raise SystemExit("Can only get ]G for;Bc=5_ zprint("I: {}".format(@ or "")?tPsys.e0A/if50is f(3k.'U) andCLsamex,RIn-place edio~sW0sup((ed'0gs.&Gachange6when copying"iscreate_ X/=. , w <F)) if __t__ == '$'T0() ]@Read write ZIPs. XXX references< tf-8 need further investig.Sbinascii lib.utilo tertools import os import posixpatheshutil6tat 6rucyDthreading*Dtime contextlibn try: zlib # We may need its compression method5crc32 = 6. except IRError`#y = None;binascii? ?bz2yAx ]Olzma^+B_ __all__ = ["BadZipFile", fe!",| "ZIP_STORED0fDEFLATTBZIP2KLZMABdis_zipdqZipInfo0'PyULarge Path"] class !(EBion)Tpass (Q *1"""cRaised when writing a T, the  requires ZIP64 extensIand those are disabled.'x r# =$ # Pre-3.2atibility name_LIMIT = (1 << 31) - 1 FILECOUNT$&16$MAX_COMMEND  # constants for Zip sr1A = 02A = 83Q = 1254 # OtherY s not suped DEFAULT_VERSION = 2r'64145 p 6 t63 # we recognize (butpnecessarily|) all featuup to that ver  PhEXTRAC63 # Below@someRPmats 8associated data A/headers usW# st module. TheV3of @/1rdsused # inTPKWARE descriptc!of2ZIPformat: #Lhttp://www.pkware.com/documents/casestudies/APPNOTE.TXT # (URL valid as of January 2008) #@"endcentral directory" , magic number, size,pindicesn1sec4V.I ") R EndArchive = b"<4s4H2LH";ingPK\005\006" yEndCentDir =P.calc(a) _ECD_SIGNATURE?DISK_NUMBER'(@STAR2ENTRIES_THIS_!K = 3OTAL = 4SIZE = 5 _ECD_OFFSRET = 6 _ECD_COMMENT_SIZE = 7 # These last two indices are not part of the structure as defined in # spec, butyA0use!ternally by this moduleFa convenienceB = 8LOCATION = 9  "central directory" , magic number, size, an` # of BBies ? (section V.Fformat document) s CE alDir = "<4s4B4HL2L5H2L"$9ing$b"PK\001\002" VP.calc(#)indexes  _CD_SIGNATUR0CREATE_VERSc1SYSTEM = 2wEXTRACT.3/4FLAG_BITS = 5COMPRESS_TYP60TIM 7 0DAT 8 1CRC<E1/UNFILENAME_LENGTH = 1g_FIELD%4DISK_NUMBER_STARX1INTERNAL_q_ATTRIBUTE1/EX"L_HEADER_OFFS 18The "local file headerA QFileHd2$2H "R3\004  #l) _FH>FH_p1*p2GENERAL_PURPOSE_3")ION_METHOD = 4LAST_MOD_567 89$ 0 1Zip64 end /to WuctEndArchive64Locato%LQ%rx06\x070End8DirMT " recordG tQ2H2L4Q "6# =y FLCD64DIRECTORY_REC=64_&640ERSION = 3 _CD64_DISK_NUMBER = 4 __START = 5-_ENTRIES_THISFO = 6#OTAL = 7DIRECTORY_SIZE = 8bOFFSETrp_CENTDI9 _DD_SIGNATUR20x08074b50 _EXTRA_FIELD_STRUCstruct.S (' C1: :raise BadZipFile("zipfiles that span multiple disks are not supported") Pp# Assum 'zip64 extensib=Aata'yfpin.seek(offset - sizeEndCentDir64LocatorA, 2)Fqdata = M\read(D'pif len(.M) !=j eturn endrecc sig, sz, create_version, pQ_num,!q_dir, \Adircount 2  =4struct.unpack(EndArchive64, daif sigXtring(9# Update the originala usingfQ from$ZIP64 recordB+[_ECD_SIGNATURE] eg!DISK_NUMBER#5(USTART'=dir'ENTRIES_THIS_\.b.HOTAL*2+1SIZ0dir SOFFSEr$r? def _EndRecData()B"""R.a"End of ral Directory"v, or None.r2Theis a list?nine items in a@centaCdir" followed by a tenthE,B  l#isB."""# Determ51izeh0"jdtell()JCheck toy if this is ZIP : with no a comment (thtB# "eXX\ure should bAlast?#rkacase).!2try-except OSError:KW&(=wF2 anC`[0:4] ( )*1-2:*`b"\000"M#`signat;`is corJ@re's",  oLD4 7=(C2P# Appua blank3andP star. !.a>B(b""iTez  0Try.2 "Z I!64K-, V# Either1s not a ZIP file, or it is a ZIP  with an archive # comment. Se the end of ;1for "central directory"Nrecord signature. Thed^last item inWand may bup to 64K long. Issumed thatBc magicnumber does not appear -BmaxCStart = max(size - (1 << 16) - EndCentDir, 0)Dfpin.seek(N"qdata = )Rread(9ss.rfind(stringEndA)2if ,Q>= 0:u@foun e ; attemptVpunpack tinterpretBBrecD[e:+]3sif len(:K) !=2Zipis corrupted.P%return Nonendrec = listBuct.&$, 0@S=rec[_ECD_COMMENT_SIZE] #as claii!bygzL6 = ' !6+9B.3nd(#  S" + %) P# TryZ`"Zip64` strucER_EndR064(, #! -',Gy # Unable a valid + class ZipInfo (object)A"""C ttributes describing each rive."""f__slots__ = (`'orig_+Vname''zdate_ti)compress_typB_Xlevel\/Xextra0crenosystemxversionD?ct_reserved/flag_bitsJvoluqnal_attr+_exterheader_offset28CRC _| H_raw}def __init__(self, ="NoName",=(1980,1,1,0)i>.0ileMOriginalc iV# Terminate.at the first null byte. N s in file # names are used as tricks by viruse6archives.;b_b! =TI.find(chr(0))*6if -U>= 0:=H5[0:2]-# This isto ensure pathgenerated ZIPqs alway3Iforward slash s the directory separator,required(th?hormat specification(if os.sep != "/" and.replace(N,L%) _self.Kb0# NQlized ?date_time = > # year, month, day, houvin, sec&if>[0] < 198raise ValueError('Jdoes not support stamps beforeK'p# StandvNsIcompress_typZIP_STORED # T4of %qion for L _'level = NoneA # L=**orCcomment = b"";3# CEAeach @_extra>1 #!Edata9 if sys.platform == 'win32'+/ resystem = 02# Sqwhich c*jsJelse]# Assume everything &Unix-y=n3K@vers= DEFAULT_VERSION?VSj?ct_T$# Spneeded E}Cm@_siz !of) B7# SF/unHw# OtherY0set9class ZipFil#U@_off*qSByte !to.P# CRC0 * CRC-32 of the uncompressed file def __repr__(self):result = ['<%s5name=%r' % ..__class__.__@__, G.c%)]P"if_type != ZIP_STORED}.append(' 9e=%s' %]0 .!orRs.get,C Q C%))DBhi =external_attr >> 16&/lo&& 0xFFFF)_if hi i4modAstat}7(hi_if loM @=%#x&loTisdirwis_dir(bf not %"or __size{ '`g d.((fjU) andE z9 or1 - h.f2 Fy @&>'return ''.join(*)FileHeader, zip64=NoneB"""RI@per-b! h9 as a bytes object."""d date_time os = (dt[0] - 1980) << 9 | dt[1] 5 20dosK =%3%"11&43Vv5] // 2Pflag_bits @*08hP# Set se to zero because we writepm after U dataVCRC =! =,E = 00;els>@5CRC)Y ]  /rPSTextraK min_version"if5@ is 8 HP >64_LIMIT or e ] fm]u'0), )Esreturn L+[/ +v"raOdef .)6try _'..('ascii')^except UniE _Errord^utf-8d | 0x800!def(P# Try$Iw field.0tra)" unWwhileZ >= 4tp, ln = ;r('U P&raise BadZip#("CorruptWp %04x (|=%d)" % (INPif tpn0x0001o0dat0[4:]B#! (Ss and/orf archivesF `E in (0xFFFF_', G@ = "C ("0[ |,@Q', ";[:8="" =).8:?$ 8:C? self.compress_size, = unpack(' 2107j, 12, 31, 23, 59oX# CreBstor information $if =;0os.P.norm (Qsplit(.7)[1Twhilex0in =1sepgaltsepJ% =91+diY4e+= '/'zd = clsEb(.external_attSode &o) << 16 # Unix +eibutesuc\-E = 02 | 10mgMS-DOSEflagAJelseOo|@qreturn -pis_dir( B"""R/True if this archive member is a directory.""" Breturn self.filename[-1] == '/' # ZIP encryption uses the CRC32 one-byte primitw%for scrambling some # internal keys. We noticed that implementaois faster'n # relyW on binascii.crc32(). _crctable = None def _gena(crc):j in range(8if crc & 1+ = D >> 1) ^ 0xEDB88320U&Nelse8Q>>= 1$r4crc\psupportpassword-based form of~. Even though know0pla^xt attacks have been found against it, itPstillful # to be 9to get data outpsuch a ". # # Usage: # zd = _ZipDe&er(mypwd) _bytes = zd(cypher")  ?=Ekey0 = 305419896Dkey1 = 5917510492 = 878082192 pglobal &if )o, = list(map(C,1a256)))Nr;}|0ch,Uf"""ComputeMD onZ 58[^ ch) & 0xFF]pupdate_}(bnonloc 0,12"0( + 0~)FQ3* 134775813 +V2F3kQ>> 24"2)p6pwdp*d ! as objectasult ="farray(Pappen re&.czN =F2 | c ^= ((k * (k^1))8a[+c(h"s(%( class LZMArressor:}S__init__(ORd._comp32 0@prop*lzma._encode_filter_erties({'id': &pFILTER_&1} z)L(FORMAT_RAW,aters=[4'?_de , s] Xstruct.pack('[eY1ZClz77!90wav?4ppmd', } 2a_checkDion(W3ionF7if  == ZIP_STOREDKApass/el1hDEFLAT3if not zlibH>aise RuntimeError([S"Comp requires the (missing)Z module"mVBZIP2'bzyr4?bz2 9Z s NotImplementedError("That c"ompression method is not supported") def _get_c14or( t_type, level=None): if+ == ZIP_DEFLATED& *FM&*return zlib.y5obj?, ha, -15)C TZAULT_COMPRESSIONP/elVBZIP2'bz2.BZ2Cw@ 0##8xignored forALZMA#pMelse*M%de O;e_checku5ionKlUaHSTOR_3 5bj(UO DJl Fudescr =or_names.getU!1if 7r raise NotImplementedError("O %d (%s)" % e,Z)W 2id)class _SharedFil_init__(self, file, pos, close, lock, writing0 ._0! =78Ppos =J W_ l! =s $ = seekable. &Dtell"  0offset, whence=0Rwith #if(9SValue.Can't reposit3`in theU while "C `"theretan open! handle on it.B Cv;before trying to read."v(@,8(* %6posGn=-1fg():  "raise ValueError("Can't read from the ZIP file whthere " E "is an open writing handle on it.< QClosev ;before tryP!to9.")`self._b.seek(:pos'rdata = .*(n&:pos+Ztell(*preturn W Pdef c!):('ifv is not None#'9objyD!'! =@$obj) # Provid_ method for un2able stream class _Tell__init__G, fpufp = fpoffset = 0$eG>In2fp.'!TE+= nnfe_&0\flush1*2fp.).g_B.fp.3) N ZipExtFile(io.BufferedIOBase?0""" -like objectan archive member.2Is ed by ZipI."()&2"""# Max size support5decompressoYMAX_N = 1 << 31 - 1CR'5!ed*s in 4k blocks{MIN_READ_SIZE = 4096IRChunk@ durASEEKD"24B ileobj, mode, zipinfo, pwd=q,VL>uobj=Fal#aG Ppwd =e  \" =NeNt_type =. a@_leff4 4 ++_' ( = _get_,)._"aeof = V _b k = b'' 9Spnewline F! = Q8namU?if hasattr(Fs, 'CRC'expected_crc5CRCw-srunning,crc32(b''O;els f_+ ftry: if fileobj.seekable():  self._orig_compress_start =@otell();ize = zipinfo.S?izeA *_s=9 r_crc = prunning9f = Truexcept AttributeError3Upass Wqdecrypter = NonPjif pwdA%ifflag_bits & 0x8( # @are against the type from extended local headersHcheck_byt(_raw_time >> 8))ff=OelseCRC otherwis4_>> 24~hUinit_k if h != craise Run`("Bad word for]U%r" %bname) [def _b. = _ZipD-( 6pwdZ1# Tprst 12 As incypher stream is an enz3ion# used to2RngtheHalgorithm.m1m&ar!# letely random, while12th contaMSB of HCRC,!or"S  depending oD0andVcorrectness.AU'vread(12z left -= 12JcreturnoaW)[11]%q_repr__Presule['<%s.%s' % %.__class__.__module__LJ9@qualE__)]bif not[close0.ap0(' A=%r mode=%r,H)>"ifR!= ZIP_STORED}==!f20or_Ss.getS_MM Z/ & L[q&]', #>c''.join(*)WAline, limit=-1): """Read and return a line from the stream. If limit is specified, at mostbytes will be read.A6"""NiNE< 0:#k # Shortcut common case - newound in buffera>i = self._}"find(b'\n',offset) + 1}lif i >Y{\[mPI: i]O9!M = i!ra Aio.BedIOBase.+(X,w)8def peekFn=1)[s84ed thout advancingposition.if n > lende9) -\z9Tchunk9(n) 1en((?) >KO}1 = :# +9c 0Jelse~1 -=$2# Rup to 512nto reduce allocad` overhfor tight loops +v]Aable"if8jclosed raise ValueError("I/O oper"n 7v file."JTrue], n=- :n8 !IfqargumenPomittNone, or negative, dataed until EOF;che"jHF0is  4buf.   i = b''#*= while not J_eof  +1f.MAX_N+2bufuend = n0if "z# Checka're ataend of 6filnof andd3 != raise BadZipFile("Badz-32 for tb %r" %LVname)1"""Read uppn bytes withmost one ?() system call."""_j1 or!0O[:,e = b''x#>I = 0while notJ_eofB &f.MAX_N+!ifH br&IS= n +Q0if "#Kt?endwv =m|Tn(! -c @ H +> %n ), %>_$ c8 287, n)# ]oressedh,=# decryptF$deNsml#of= &''AfromMR if self._compress_type == ZIP_DEFLATED:  ## Handle unconsumed data.' = self._deca6or.7Y_tail6if n > len(A){$ +Yread2(n -3)QJelseA= <%) 1#if LSTOR 5eof;left <= 0_/ela pn = max(n,MIN_READ_SIZE t X:, n:( 30or.%orm 3O and62not! C:eof fflush(M < ?Et"{#or"~=K"[:UD]@6 -= 7{ !@e= True9update_crcareturnRdef _{;Nj%8W2b''V'%in_lT._fileobj.( CaU aise EOFError decrypter is D?Non 0Qclose0:try/  $,-6kfinall[super().-Y%}seekabl1drLQValueN("I/O operation on 7 &."Q{&, offset, whence=08f, io.UnsupportedO("underlying streamANcurr_posGtell#if0: # Seek from start of file new_pos = offsetelif whence == 1: # Seek from current position7[T'_+_ 2_?EOFRself._orig_o_size ^9se:Braise ValueError(" must be os.SEEK_SET (0), "@ "1CUR (1), orEEND (2)") E4if />  ,=,W?< 0D01Rread_% =-Fbuff)7+228if 5>= 0 andb< len(T1:er)0# Jmove the index if5newa is in_VsxW '>E = 0 n3# P Rbefor,q. Reset|ZipExtFobj.seek3compress_s)running_crc B25WJleft7o;2.Ger = b''#$deoBX_get_,%__type&eof = Fals #ifdecrypter{not Nonz1ini2(hwhile x>len = miBAMAX_XREAD,@A(J_len s"-=H8len5BturnDtellAdef  jclosedBB on .&.":"ot}_ ;abldTio.UnsupportedOpera("underlying streamNn k-- !!reFb class _ZipWrite(io.BufferedIOBaseWk!__C_, zf, zinfo3p64*kself._zinfo = ziSnfo self._zip64 = @filefcompressor = _get_t(zinfo.e_type,@~ @Relevel)A@_siz0z qrc = 0 7@propertyPdef _\@obj(j!):preturn 8'2.fpG9writable9JTrue-*g, datai"ifefclosedaise ValueError('I/O ation on 7 '8nbytes = len(r1S2+= . "c9Qcrc32B,F_crch*or|$ =;I1[P + @obj.eO5  @:trysuper().<(# Flush any from the or, and update header Xrvl%?bufof /l:buf0=s)p  Jelse`{R N86CRC)rcv(J.s# Writedflag_bits & 0x08Y qs afterAb fmt = ' ZIP64_LIMIT6:rcRuntim s( 'F unexpectedly exceededvg limit? if self._compress_size > ZIP64_LIMIT: raise RuntimeError(,C#'Cf1ed hunexpectedly exceeded| limit')Q0# Seek backwards and write file header (which will now include # correct CRCLF?s) ~ Preserve current position in 4self._zipZ.start_dir = obj.tell( %Rseek(bzinfo._offset> ( ?QFileH3Op64)I 7# Successfullyten: Add0 to our caches>a(list.append:nfo 7NameToInfo[8NUname]PzfinallyA_O ing = False class ZipY=Q""" Cwith methodspen, read,e, close, A zip""s.4z =Z(, mode="r", ion=ZIP_STORED, allowZip64=True,9level=Noneb: Either the path a, or a-like object.cIf it is a>,H<be openedyDd byJQ: The can be e<C 'r'@P 'w',J@lusireate 'x'CB 'a'e@ion:@H (no[!), DEFLATED (requires zlib)e`WBZIP2,@bz2)<GLZMARlzma)P: if >cO!s [ extensions whenng0, ow"itR anB!epB this wouldMPbe ne2aryKQ : R (default foLXgivenZQ typeaJ]tegerm specifyvepw!toa"orpWhen usC* keyword has no effQ!in s 0 through 9 are accepted=K1K.2""",Bfp =| Ct here since _0_del__ checks it _windows_illegal_name_trans_table = None .try&fp = io.openc.except OSV!ifNA-U . co;u, !Ubreak;els-_{61/A!1%3ileQsgetattrR'!',VOpARefCp`lock =eading.RLock(DCseekcE in  ==  self._RealGetContents()  elif mode in ('w', 'x'):%0# set the.ified flag so central directory gets writtenJeven if no files are added tod}archive<self._didModify = Tru'>try@start_dir = {fp.tell0 except (AttributeError, OS (6U = _Tellable( ~-0'P_seekS~ = FalsOelsea# Someu -like objects can provide  but not og1fp.@ l#k n== 'a' P# See is a zipERw V ek7 ofFand overI?Wd`BadZipFil$, just appendo0, 2) (K3/# O'@DS+>raise ValuJ0("M|mZPbe 'r@, or"/ &fp o:Non@_fpclose(fpbdef __enter__areturnC .3xit-, type, v, tracebackE/t?repssult = ['<%s.%s' % .__class__.__module__, }9qualname__)]<!if0.fpQ $_=jPassed!y re.C!('C0=%r 0ile `end(' filena me=%r' % self.filename) result.append(' mod62_else:@ [closed]'5 c>turn ''.join(*!) bdef _RealGetContents() """Read in the table of c0A for@ZIP A."""^Cfp =p6try`&endrec = _EndRecData(fpexcept OSError=raise BadZipFile(" is not a zip"O!ifwN14.debug > 1Rbprint(lsize_cd = [_ECD_SIZE]p# bytescentral directoryQnoffsetOfOFFSETQ"# *N_commentbCOMMENS# archive ,U# "concat"zero, unless0was@catenated to anotherE LOCATION] - G-5_cd=+if\GNATURE] == stringEndA*64# If Zip64 extension5 uctures are present, account m @-= (EndCentDir64 +sLocator@"ifA_2pinferreJj+ I"given, 8,." 8_cdU#start_dir: Posit 1of `(@# =+Aqfp.seek.46, 0data = fp.readd6_cd @io.BH0IO(0total = 0sbwhile <:_cdt;dirvfralDir_xsif len(5A) !=V/ ]30TruP0ed H < struct.unpack(v,JdB![_66DBad magic numb!or{   r(FILENAME_LENGTH]=alags =edir[5]wif flags & 0x8[00:  # UTF-8 file names extension-%$! =0 .decode('utf-8')4OelsesHistorical ZIPL encodingEy [cp437y# Create ZipInfo instance to |eu informat4x =;(| px.extra p.read(centdir[_CD_EXTRA_FIELD_LENGTH]?commentACOMMENT=header_offseC|LOCAL_HEADER_OFFSET]QA(x.c@_ver%, `system(ct$reserved,O x.flag_bits9compress_type, t, 19CRC+@sizel_ D) = J1:123if b > MAXzCT_VERSION~raise NotImpleedError("zip %.1f" %(\/ 10)Qvoluminternal_attrJ5:18# Convert date/time (year, month, day, hou|in, secQ_raw_C9= t x._( (d>>9)+1980, 5)&0xF, d&0x1F ,t>>11, (t>>7 3F 9) * 2 ) }_cEp( *x.z+ concaPself.llist.append(x[$`NameToB![x1Z] = x@# up$ total bytes Q fromral directory42= ( + CentralDir +@[FILENAME Kl 47  51if $debug > 2lqprint(""",") ;1defp(I)@"""Return a 2 ofs in the archive."""r7U[data@ for"a:kY] Tclass!\shW ;1dir,Z=None&Pa a table&rcontentthe zip file."""# print("%-46s %192s" % ("File Name", "Modified8uSize"),Ip file=)for zinfo in self. Ulist:$=date = "%d-%02 :K.-_time[:6]G d8(9|`name, C,]_size4kdef testzip()"""Read all thes and checkqCRC."""K_Qchunk~ = 2 ** 20>6tryV!# 1by ds, to avoid an OverflowError or av=# Memory# with very large embedded.>0!].open"r") as f| whqf.read($ ):A # CQmCRC-32{$y passexcept BadZip}greturn0 F0get ,  ?instance of ZipIpgiven '8'U" ="u To0P.get(-Q1if ,zis Noneraise Ke( 'There is no item@d %rarchive' %)<}0seteCword:pwdSet default, uencryptBPif pwd not isM(pwd, bytesgAType("pwd: expecd3q, got %@typeN@).__c)__e> @=;els)-@property9;qcomment7s"""The  text associaV1ZIPz F_C.setter,v,ifI.(#>4Tvalidq length if(K > ZIP_MAX_COMMENT-import warning). 2('Ayis too long; truncatinga"%d' %, stacklevel=27$ =~+[: 2 self._d%idModify = True def read(self, name, pwd=None):$( """Return file bytes for2E."""*Pwith Nb.open(R1"r"Wv) as fpX\rY!p.)BLTmode=M@, *,ce_zip64=Fals-like object7 '"'.t is a string&2the0in 1ZIP, or a ZipInfo i^ should be 'r' to! aI0 al/y a 'w/^Pwrite@;newly addedwarchive0pwdqpasswor-qdecrypts (only usedGing)GPWhen qing, if@sizebnot knownadvance but may exceedp2 GiB, q1use\PZIP64 mat, which can handle largePRs. I @, it@bestlAinst , p zinfo.l_bEset.1if Ain {K"w"} aise ValueError(') requiresF0"r"nU"w"')o ifQ and fsR(pwd,ro3Typn"pwd: expected3, got %s" % typeN@).__/__(o== "w"rso`suppor{ht"j.J`q"AttempZ$ that wassclosed"?# Make sure we have a#foUrFif i0, # Uv! =zn$eldj== 'w'Y3RU.compress_" =5iono3_\level46Jelse`# Get G? k\0get1] b4_T@_to_!e( B4for"if8:ingLzb"Can'tDfroml6re ;" n goon it.8Cnwriting handle before trying to read.") # Open forEing:self._fileRefCnt += 11zef = _SharedFile(5 fp, zinfo.header_offset,=~ =_fpclose, lock, lambda:writing)Q6tryW# Skip the  $f4 = .!P(sizeHeXsif len(;Z) != / c3raise BadZipW("Truncated"ib = struct.unpack(H#, * ?$if[_FH_SIGNATURE]VtringDBad magic number4[V]fname[FILENAME_LENGTH] EXTRA_FIELD0 l?#ifflag_bits & 0x20g# Zip 2.7: compressed patched dataZNotImplementedError("C (| bit 5)]4strong encryption =6v GENERAL_PURPOSE_FLAG_BITS]\/80QUTF-8C Yq_str = .decode("utf-8GNelse8D_cp437o2#!=)Aorigd ' B in directory %r anddiffer.'F2% (p , )q# checklag & handle passwordn6is_0/ 8if 4$if not pwdA0pwd*pw? sRuntimeopT%r is5ed,) "ep"requir:or extrac]1" % FNoneo`returnf0Ext(c, mode^,9f, Truenexcept:  zef_file.close() araise $def _open_to_write(self, zinfo, force_zip64=False):8H(if and not @._allowZ815| ValueError(O"t is True, but TQ was ` when ^ing "Nthe ZIP  #if?ing p"Can't -Xe to d` while re s "anotherMahandle on it. ACps first CRbeforJg2.")Da# SizePCRC a/0verten with correct data after processVYw7.compress_s`;= 0 n flag_bits = 0x06"ifYptype ==Z_LZMA3# C"edincludes an end-of-stream (EOS) marker|2$'ifseekableC8D(external_attrI !$o600 << 16 # permissions: ?rw-n scan be larger than un0ed %# =*\'<(#or.* 1.05 >64_LIMIT[f0fp..start_dirXheader_offsetfp.tell(rSacheck(?N didModify =_ 0fp.@e=a.FileH(?)pKN:return _ZipWIPsextract%member, path=None, pwd B"""E72 a 3Q fromOearchivcurrent work diHory,ufull name. Its UPrmati#s ed as accuratelyPas possible. `P' mayaVd or a ZipInfo object. You canP@specqa diffe `5%'.7&""!ifSV 8 = os.getcwdx;els- fs (V_*_(, pwd) def extractall(self, path=None, members1pwd C): B"""E@D all0 from the archive tocurrent workingG directory. `' specifies a diffe;(TH to.L`' is optional and must be a subset oflist returnedKpby name &()e5"""&%if0is 9 '0 = `.O C@= os.getcwd()8Jelsem- fs ()jfor zipinfo in D_\_(5S, pwdV@classmetho:def _sanitize_windows_P(cls, J:sepOReplace bad cha1ers@remoLrailing dotskhparts.table = cls.qillegalq_trans_(Pqif not  ; = ':<>|"?*'63qtr.make^(6, '_' * len)?" =y0arcJ$ =T.wQlate(e/# >J(x.rstrip('.') 0x*la.splitV aRjoin,ibempty j@sep.6-(xjV if x`j , targetj@ZipIobject ''ea physical file on>`k'\isinstance(d#, |)S0elf4{'q# buildpdestinaRo#mward slashesplatformxc separators# =;.h".rP('/',.$%ifjaltsep\ T1os.O6 _Z# interpret absolute as relativeJ drletter orQ# UNC;+wdundantQ, "."".." component(9r(E)[1]tinvalid__4W = ('Lfcurdir pa"V +G~^cname.split(os.path.sep) if x not in invalid_Af_partsC7if [ == '\\':c# filter illegal characters on Windows3 arcname = self._sanitize_w-_(&,%) I`target% =#Vjoin(#, E7@normJ;j# Create all upper directories if necessary.(Gdirsg1dir"if[31and}uexists(T)pos.make;$+if member.is_dir(@%otE is$ n_rk&!vreturn EBwithRopen(, pwd=pwd) as source, \T 0Sa, "wb"1 shutil.copyfileobj(X/def _writecheck(w, zinfoC@"""C for errors before <Ping a%e to thehive.""""ifX.&p.NameToInfoimport warningb. ('DuplicZ{: %r' %p, stacklevel=3Amodein ('w', 'x'a' aise ValueE  ("e() requires LDyor 'a'"tx*fpr_C}"Attempto{D ZIPu@ tha5s already closed~__compression(.__type_allowZip64 _zy = Noneaif lendlist) >=_FILECOUNT_LIMIT\\`"Files countg+)elmp_size >g/64_?ize\header_offset`0Zip  d%ifJ%L#0Zip (!+|t" wouldo#` exten#s"C(j,j=,s O" 6^a"""PutCbytes from fil ename into the archive under # 0arcE."""if not self.fp:3raise ValueError(""Attempt to write 5ZIP that was already closed")K"if}_@?ing_Can't~while an open#ing handle exists %) zinfo = ZipInfo.from_file(H, 5Dstrict_timestamps=s_1if .is_dir()compress_size = 0$9CRCJelseL5if Iqtype is;Non*V 1=A pF[6ion4_level_N2 G LM CwithJlock__seekabl'$0fp.&( Pstart.b)header_offset =fp.tell() # SCB of +e bytesJ^_8== ZIP_LZMA3# Ced data includes end-of-stream (EOS) marker}flag_bits |= 0x020)_qecheck(: (didModify = TruePlist.appendT `NameToF[{.=92] = 0fp.e]a.FileH(False) g'"rb") as src,)"Q, 'w'Ndestshutil.copyAobj(G., 1024*81defAestr,C_or_,/, ~=,:A"""W a =. The contentsa'', whichmay be either a 'str' o 3' instance; if itL(pencodedmUTF-8 first.m'trcname' is either a ZipInfo instance or the name of qfile in archive."""0Tif isI(data, str):"Y0 = .encode("utf-8")(hif notNzinfo_or_arc, ^($ =(0=Am date_time=`.local (.v())[:6]Ce.compress_type = self9ionz3_4\level4 62if 9[-1] == '/'oexternal_attr = 0o40775 << 16 # drwx)-xmCp|= 0x10# MS-DOS directory flagNOelse5600B?rw-UQ" =# 4a*fpraise ValueError(6 "Attempt to write CZIP  that was already closed}_@?ing_Can't~ whqan open#ing handle exists.)!is;Nonf-)= =W W X>X@_sizn1len|)D# UnB0ed +BwithZ_lockM(o, mode='w') as dest5v.edef __del__(q"""Call^"0()" methodvAcaseuser forgotP.9n lP=P, andU 'w', 'x'1'a'E~Vendinyrecords"ifO fp9breturn+0 "z ez j ""on it. > CAbabefore:Wzip."e:try21modc(@, 'ag"ndT_didModify: # ._lock:  if self._seekable: "(0fp.*( start_dir)5$_write_end_record(-zfinallysBfp =)fpWONNone_fpclose(fp) Ndef H)tfor zinfo inxilelist:!#  central directoryg'Bdt =K.date_tim0dos = (dt[0] - 1980) << 9 | dt[1] 5 *2]` osS =)3)"11*47Zv5] // 2iextra = [U#if file_size > ZIP64_LIMIT \4 0.compress6_{.append(p.r . n2Mc = 0xf  F+?els d i0 header_offsetW @)  =  @_dat{. 0min_version 1if 11# AN" a field to the5)'sLgMq_strip_(n, (1,);"truct.pack(fj' ZIP_FILECOUNT_LIMIT:/y Q"Files c"+&el\]/64UCentral directory 6b2`,j^:if # Need to @ the;$64 sCbif notp_allowZ b)raise LargeZiph() +Y4t" would@xtenR&s">*endrec = struct.pack(mBEndA064,19ing 8b44, 45Y0, 0,  >+d fT)?loc"~LocatorN;str+?, 1 'Q= min1d, 0xFFFF55 437_ 9 ;@ /- G  0, 0, centDirCount '9ESize8 Offset, len(self._comment))Mfp.write(endrec,DC1if mode == "a":fp.truncate(aflush() 8def _fpcloseV, fp)Tbassertu_fileRefCnt > 0@tE-= 1_if noB;andPmd|\2fp.) class PyZipFile(A"""C!to create ZIP archives with Python library s packages."""t_init__Pile, }="r", compression=ZIP_STORED, allowZip64=True, optimize=-1(/._w| xyV _% = #py pathname, base @="",Pterfunc=None"""Add all%es from "Hy" to th.}4If *c is a  directory, seE|84sub%ies recursively for@*.py@e enterFmodules inznive. Elain>uy, listdir h{`. Else,Gmust be aEP will*5putGPAddedare alwaysU.pyc.7This method`1ile|<Ec ifBnecessaryU If>()given, it Pcallexth every argukLCWhen/!FaB&or4Ovskipped<s@s.fsi=fil Zdebug~label = 'w' if os. f.isdirp else ''Bprint('%s %r ! bQ' % (mjEYretur , Vsplit i SEjoinR4, "F.py" e(O):  # This is a package directory, add it *if basename:) = "%s/%s" % ( , :):?elsP; :if self.debugprint("Addingin", pathWu, "as",f'0arc " =v_get_codP(inito[0:-3]N 3", zjwrite(+pdirlistorted(os.Ddir( )7.remove("__n__.py". # Add all *.py files andz4subi=ies1for5J0 inath = os.U.join,Groot, exAsplitext(;%ifs$is>)k 0[z *, XNR#:8!py4,5 filterfunc= ) # Recursive callRBelif0= "NB `O0not~4 v8' %r skipped bw1' %E'Ncontinue%  ^/ZHL ($\ v ?NOT swt top leve T@from*EQ sv2s.path.splitext(filename) if ext == ".py":%8if filterfunc and noto(path)@Dself.debug+ /pprint(' %r skipped bywA' % zJcontinue%f"P, arc 1 = _get_cod@[0:-3],Hm 1basQ>"if($"Adding"\jwrite(3Jelse!ife[-3:] !0raise RuntimeError(.'Files added with py() must en'"  xl `xeeYJdef Q2,Y,}"""Return 2hivD for theG!. j!G! a module #2, rP4acorrecAC0arcg<, compiling if necessary. For example, gwB/python/lib/string(b.pyc, (%).E5""" De, optimize=-1~import py_2G!C!", 6tryUp.x!doW=True [Xexcep2.PyU as err5zerr.msgTJFalsF{a_py ==F+*M$c$cpycache_opt0 = lib.util.from_sourc5_py'wation='R1R'1"Q2Q'2Qbf*-1# legacye: use whateverq is presentrpif (os.0.isf_pyc) and  os.stat(file_pyc).st_mtime >= 8): F # Use .pyc M.!arcname = fu +elif (os.path.isM(pycache_opt0) and3 ,,Pthe _~5_/*, but write it to ,legacy pyc# !in.~archive+! QPH!1H1#Hs1H=2H2H2H/se6 Compile py into PEP 3147E3Rif _c7 if sys.flags.optimize == 00})_1__1)' #/eljf E<# new mode: use given }ation levelC@elf. + B 2>S msg = "i!nvalid value for 'optimize': {!r}".format(self._?) praise VMError(msg*if not (os.path.isfile(fname) andXsos.stat'.st_mtime >= uile_py)-):K}Q_compv4$, =C` = arc0 = 5_pyqsarchivecsplit(6E)[1]0aif bas0 s I"%s/%s" % (/,lkrreturn 1 $ def _parents(,1"""G0 a  with elem. separated bPposix).sep, gene S all c of thatP!. c>>> list(b'b/d')B['b'(V/b/d/*/+*f,c/, ] bY "5s itertools.islice(_ancestryj, 1, None)  U5  ?/d'50 34!/fi=<'&U" =yrstrip(Qwhile% 9!= *Qyield%g`, tailm' _dedupe = dict.fromkeys """Dlicate an Yable in original orderLdifference(minuend, subtrahendR%PitemsV2'in8, retainingrO(1) lookup. filterfalse(set(`.__conbSs__,  class CompleteDirs(ZipFile#A 6srensuresimplied directoriesare alway`cluded@the 2@ricmethoTa _d;s=$Qchain_E(map,sF!as^z = (p +pl7ope(_differen ce(as_dirs, names)) deflist(self):) = super(CompleteDE+.":)5areturnTAs + -._implied(: _=_seQtpresolve\5"""aIf the represents a directory, vAthat)=a)a (withOtrailing slash).2{sSFelf.?0dir$! =ve + '/'Jdir_matchTnot im0and?;_ if+M2els@classmethod@$make(cls, source[sGiven a%a (file`or zip)]!an_kappropriate iA subOif isinstance(,Ah*1if KLhZipFil0G3clsu# Only allow for FastLookup whenO  is read-onlybif 'r'nPV.moden clO31.__B__ = clsb&1 & H to ensure 1cithrp exist Care d rapidlyY2lcontextlib.sups(AttributeErrorrt , !)tV.f1lLl2.__n C BPathmkA pathlib-compatible interface@zip "s.Consider a this structure::/f ├── a.txRb0c04$e8U>>> data = io.BytesIO(<Szf = ()X, 'w' .writestr('A', 'nt of a-!b/ /c/!d/ 1e') >>> (zf.filename = 'mem/abcde.zip' Path accepts the zip4 object itself or a L:>>> root =EB(zf)@FromKre, several pg operations are available.8Directory it) (includingR")::aa, b =.@Qdir() (, 'a.txt'-b- 3b/' 0 pr'ty b.D#'bgjoin with divide 6Gator8c = b / 'cAc "b/.c%Read texts`.read_-'content of cexistence:s7ATrue(qmissing))..RFalseCoercion to stringeimport os[str(c).replace(os.sep, posixpath  /(v!AtO@, `` `` and ``parent``presolve,`. NoteRse attribute1not:`valid Swill rai, ``ValueError`` ifF9ahas no,g".&N>: ' Ng#2"""]__repr = "{<.__class__.__B__}( R!r}, cat!r})Odef __init__(Q,, at=""):Construct a fa ZipFileR6a: Whensource is an C!,iAUype (!) be mutated9a2specializbype. Icaller wishes4Qretai=original type,7should either create v@epar Gpass.m[. = FastLookup.make(O*a!"atCopenmode='r', *args, pwd=None, **kw!Opis entry asbinary followsemanticJ!of`thlib.].p)`` by <pargumenehroughto io.TextIOWrapper()21if 1is_ 5IsA#L@zip_/0 = 5[0]bif notcexists() and zip_mode == 'r': raise FileNotFoundError(self)*stream = .root.open&c.at, zd, pwd=pwd<if 'b' in ~if args or kw RValue"encoding;invalid for binary operation"Kbeturn Jelsew[i"] = io.text_~(&V.get(*)rrnio.TextIOWrapper(0, *B, **I!) 0@pr!tydef namei)\pathlib.Path#P.at).1R@filec%Dg6`).join@iPread_9v-Bwith>'r't0 asm|  m.(Qbytes# p?b')`_is_child_ , Me@osix@.dir( at.rstrip("/")) S_nexti.atg=__class__)G, atSis_di)J2not%atpat.ends20is_Mkexists() and ^(J at! ._JH_setOiter.if|FPCan't listdir a subs = map.,=g>(\@filtREelf.C , SS__strpUx| ___repT]$b.formao=qu, *other? = t0){qeFXqresolveW)__truediv__ = Rparen+atQ.G9_at7'/'5if > yparent_at +=c '/' $return self._next(parent_at) def main(args=None):<import argparse 4description = 'A simple command-line interface for zipfile module.'HS5r =_.ArgumentPm'r(i= )>group = F .add_mutually_exclusive_&(required=True?6au ('-l', '--list', metavar='<1>',{Uhelp='Show >ing of a'ueu`extracxn2l( '')>Eno target dir cPcreat/'+Pname>A<Cffrom sources G_'--te$gTest i is validv}_B)(@@rgs.@@not \[>2src%] with ZipFile(src, 'r') as zf>B0badIQ = zfiBzip(m3if " 7print("Th@llowenclosed R is corrupted: {!r}".format(S)hPPDone Cing"$el% 1zf.Mdir(y[|s, curdi#s.0#=Ball(V :@zip_$,f.pop(0os#saddToZip(zf, path,C )`if os.0.isW( %)zf.write N, ZIP_DEFLATED2]\$if F| n(jnm in sorted(os.P{8. Cjoin Enm),D0zipG, nm#L# else: ignorN O, 'wbs7 zippath = os. .basename(;) if not zi8: /Uf6direfEpin ('',acurdir pa ) -''addToZip(zf, ,) if ____ == "__main__"j () """zipimport provides supBfor ing Python modules from Zip archives. This!0 exDs three objects: -Uer: a class; its constructor takes aX to al0. -I Error: exception raised byk. It's a sub}G of K , so it can be caught as$0too_zip_direpy_cachedict, mapp;#sEzip 6 info 4 s,ju(inQ._fileIt is usually`neededXvuse the9plicitlykA is d!by/sbuiltin mechanism "syQP itembat are0 toa""" #4libY_bootstrap_external+1 #_verbose_message _ _frozen_5lib\Ks7J _unpack_uint16,/32 v4imp$check_hash_ed_pycsh$io(DopentmarshalEload34sys6Etimek_warning:@For () __allMg ['Zip1E', 'Fper'] _sep = _ alt_,arators[1:a (Rpass # _read1()   = {} _4_type = (sys) END_CENTRAL_DIR_SIZE = 22 STRING_!`ARCHIV b'PK\x05\x06' MAX_COMMENT_LEN = (1 << 16) - 1 Q(B_LoaderBasics3er(v_F) ->#er UCreate a new%instance. 'L`' mustGa< , specific,` insidh0zip( . `example,sN'/tmp/my@.zip;*r .zip/mydirectory', if mydirec is a valid nside the archive. )'ZipImportErrorB`raised[', path' doesn't point to ag1ZipL.ZDThe A' attribute of zipiter objects contains1nam)1theZzipfile targeted.2"""q# Split;E"suba" from4Zip , lookup a matchingU# entry in sys.+__cache, fetchVonr#Efound, or else read it+def __init__(self,!):if not isinstance(W, str&*c5 os<. = os.fsdecodA)%a(v: 0(>@empt@= Z@alt_J_sep^! =G.replace(. 8)prefix = [] wh*JTruea:tryA st = _bootstrap_external.1tat`6except (OS5q, Value .# On Windows a,/Ud for too longs@# Back up one% element,0dirD`, base  >z ifGCF( a *' >.append( +ls:#pZexist if (st.st_mode & 0o170000) != 0: # stat.S_ISREGLh'&)/Vbreak {sEzip_[f-1Key HI)_j! =y$._['F B# a following1ZIPmV; bjoin(*)f[::-1]]7if G '" +# # Check whether we can satisfy_pmodule rAd by# 'fullname', or wbhether it could be a portion of a namespace # package. Return self if we can load it, a string containing theFfull path if it'swfssibles`, None+wccan't n.Vdef find_er(self, j,o=I!):08"""3-1 ->,1 or%. CSearch for a module specified by 'V''. P mustpt*by qual>(dotted)Xa. It r}sR` zipim%erinstance it;4theGwas found, :H!poy.(,: orwise. The opl@al ' ' argument is ignored --$KBercompatibility with protocolDeprecated si#Python 3.10. UseE0() I2eadb5"""@_war s. '(".W)dxaand sl7Qa"removal in O2; u"nF BionW)mi = _get_m[_info>.Pif mi1not Mi@# ThO35t+\&[]RV# NotMor regularUA. Setldirectory, andh#refore -# We're only interes: inYR last on%oftearlier (s are recordedv.prefixo0mod  d_is_diD8Zsr@sent1its # ouPtrail+separatorlrga, [f'{$pPive}{c_sep}{'}'G ="] a# Check wwqsatisfy>{ #  X  3&-n ule specified by 'fullname'. must be the * y qualified (dotted) module F. It returns= zipimporterIinstance itself if+mGwas found, or None!it wasn't.GThe optional 'path' argument is ignored -- it're for compatibilityPAwith protocol. %Deprecated siPython 3.10. Use find_spec() 6ead5"""K_warnings. '("+.EG6s dxaand slQ"removal in O2; u%",CBionW)+ ploader(. , B)[0]E7def#7&, ,ptarget=%):d"""Create a M&ASpec@the m2RQG/%a cannon,_info = _get_(#if:0is k\=_bootstrap.m_from_Hmis_package={Jelsees# Not aUregular IA. See th7s a directory, and#$refore possibly a ion of a Uspacec@# We're only interestedAlast7 on%of' bearlie,s are recordU;v.prefix0mod 7if _is_dir'H'3# TV- <{ string r@sent 1its1 #  ouPtrail/separatorta = f'{5archive}{c_sep}{-}'K( =FTrue2C.sub  seP_loca-s.append(=r2T Xo.&Ccode5"""%@ -> 7} object! Raise ZipI|BErro if the module couldn't be imported. 5""" code, ispackage, modpath = _get_mQ_'(self, fullname)Dpreturn $! @def >Cdata7U7:"5"""% -> string with file H.[9Rq"th associated4'N'. Raise OSError if~>]0was+Ofoun%pif alt_VF_sep4 = .replace(6,@)7key8!if-Wp.starts J.archive +#P TO[len9]:tryHtoc_entr ._/es[key]except Keya Br|(0, '', key;k %, )Y## a%Pmatch._p__ for >d1ulem)%specifieB or AZipIBX_if itp# Decid requires workout where&p0# w: come from if& was actually loadedIJ4osource'  #B Nz,\#, )DNoneYGdoesKWntainz, but has no Z/it+miLinfo;pif mi is Q(f"ca3%in{q`!r}", `=#  V4Gbootstrap_external.Pjoin(&, '__init__.py'{OelseY0f'{=}3# (# we hav@ return f_get_data(self.archive, toc_entry).decode() # Return a bool signifying whether the module is a package or not. Gsdef is_~, fullname):k(7"""'!1 ->.*True if specified byd Faise ZipImportErrorOcouldn't be found>5"""Qmi = ` \_info.Pif miFNonerP(f"caRfind a$ {`!r}", J=)jr%miLoad and ;D7'I'Rload_| 8"""(G)<  A mus5thefby qual(dotted)*C. Its.i%edFQ, or s1it EDeprecated since Python 3.10. Use execI) insteaVsg = ("zipk. 8er.j)Nd|!slFfor d "removal inO2; u"U_warnings. d(msg, BionW0SC, is,Kpath3' [r = sys.`s.get(l[ od\`not ishance(mod, H_typ0modf!f)[0] =0.__@er__6elf6try<Ti(' # add __<Q__ to *before*KU gets@#'utW&Uj4<bootstrap_external.EQ_joinJw4JEmod.!= [*]7'!ifrhasattr'__builtins__'X1\$3 -_cfix_up>u.__dict__ ( 8%jexcept8del ] V mod = sys.modules[fullname] except KeyError: raise Import(f'Loaded R$ {R!r} not found in syw%')V_bootstrap._verbose_message('iir {} # lgfrom Zip {}', m,FpathY`return! n def get_resource_reader(selfJ)B"""RESthe R7R6 for a packagea zip file.p0DIf 'G' is3pwithin [9#, 1theC'yp' objecXr=. OtherwGUNone.I5""" 6tryf!if C.is_U(.dW<7Zip# i7Blib."s tgD2Zip invalidate_caches,\M data ofarchive \.B ;_AAs = ]_directoryv.MHF_zip)[M/A] = ]m\I.pop , ( pW = {}R__repr__DIbf'' # se.order defines how we xK`Zip # :@ive:-Zfirst3 __init__,nPt # non-! .pyc, and .py entries. Thecre swapped by XP() if0run*roptimiz4e. Also, # '/#breplacH(Mre. 1= ((*4+ 'r', True/),- {', Fals-'G!H5)pGiven a@ule d potential3` (%out extension). _m_ {c% +3.rpartition('.')[2]Does thisesent a ? is{P# SeeG"< ". If so, it's eligible to bg!rt#a7@spacj. We testfbseeingjc23 anEnpath separator , exists. dirpath = +A_sepE# If#is present in self._files, we have a-bectory_`return_ 8R # R!some information about a module. def _get__,(, fullname):i=- -,for suffix, isbytecode `packag _zip_searchorderg=z\>M\!!if$ E('#iswAPNone +implement"_read_dirs(ive) ->  dict (new reference) # # Given a to a Zip Aq, buildct, mappingT ks # (local<6the: us*SEP as a separator)*oc entries.`A toc_0y i0atuple:!(__0__,#p# valueJ@use $availabl1all@s, #; @# endL/Rystem0ing90comsqkind; 0$un ed;data_size< # F of ) & o" sk66+de80boffseth"# hM header from startB5tim&#u *Dp(in dos@mat)7?dat7f| 72crck # crc checksumrGA # ) D ies can be recognized by 2Ptrail{mSZA and_*Sare 0cR2try fp = _io.open_Mexcept OSErro5PraisenaImport(f"can't L3: {Q!r}",=!) evwith fp .seek(-END_CENTRAL_DIR_SIZE, 2)H*-Q_posi= fp.tell((qbuffer 3(^3 s \Lrif len(_) != 24@@[:4]pSTRING_zARCHIVE# Bad: EndCal Dir signature0# C20 if0re'<0comz  fp.seek(0, 2) file_size =*Ztell(&except OSError:Braise ZipImport&(f"can't read h: {archive!r}",J Spath=7 max_comment_start = max(k- MAX_COMMENT_LEN -uEND_CENTRAL_DIR_SIZE, 0>try m <Bdatau%u`pos = .rfind(STRING_3zARCHIVE0if 4>< 0.;o'not a6'6.cbuffer[pos:pos+ ],rif len(?_) != 4"corrupt/header_positionh-0) + 7_unpack_uint32v[12:16]4Poffse6G6:2063if 9< I)bad central directory ?k?', F (A (-= Barc_W !?-3"57if 8 [B or c  e5%{}1# SCof CD%@counQ0 so @ Nwhile True63!p.&46  [:< 4A$2EOF`B'EOF]`where 3expected') # Start of file header if buffer[:4] != b'PK\x01\x02':,4Pbreak  # Bad: Central Dir FHBlen().46vraise EOFError('EOF read where not expected')flags = _unpack_uint16pj[8:10]1compres4[10:125Otimee[12:141?dat1K4:161;crca$32L16:2data_sizf6L20:2&6 K4:28Oname6hL28:3Oextr7L30:3kcommentp O32:3ooffsetJL42:4z5p'+ (+ i}_{>ZipImportf'bad local@ P: {archive!r}', path= 5s += arc >try` = fp.v( bexcept OSF b"can't1Zip " 0if @> S*# On Windows, calling fseek to skip over the fields we doiuse is~a# slow0!anP=P beca6aflushes stdio'Iinternal s. Sessue #8745.}a%- n)}AU 7f~& 0x800q# UTF-84s<iensionKT! ='.decode(g?lsedHistorical ZIP filename encoding Mtry:$7 = .decode('ascii')0except Uni(D._Error[latin1').translate(cp437_table) t replace('/', path_sep = _bootstrap_external.__join(archive, APt = (*, compress, data_size,g offset, time)je, crcU s[Y] = tcount += 1._verbose_message('zipimport: found {}s in {!r}'Sunt, areturns # During % , we may need to load thMs # package from a ZIPRQ. But- is implemented #`Python ^\. # # Break out of this dependency by usABAion >o for #!. dn# ASCII part, 8 rows x 16 chars$-'\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f'A.10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1G !"#$%&\'()*+,-./_0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~\x7h# non-?$16@8?c7\xfc\xe9\xe2\xe4\xe0\xe5\xe7i\xea\xeb\xe8\xef\xee\xec\xc4\xc5'cF6\xc6\xf4\xf2\xfb\xf9'ff\xd6\xdc\xa2\xa3\xa5\u20a7\u0192+e1\xed\xf3\xfa\xf1\xd1\xaa\xba'`bf\u23ac\xbd\xb\)Tb\xbb)`u2591\230 24 66'5675!5615% 571!5dcb'1071V32%1 00+3 5e 5' a7 69 !66756=6Qu2568%75=5566n1%0V8 8I89t8003bpf\u0393 c0a P3\xb5%c4@03a6 98 a9bd021e c75222/u2261\xbu 26 265 32`321\xf4248j xb2b1a07f\xba0\xa0' ) _ing_zlib = FalseRx` functobject, or NULL if zlib couldn't # ,if37# Someone has as .py[co] in their Zip fileN6let's avoid a stack overflow.(_bootstrap._verbose_message('zip:v UNAVAILABLE')CPraiseI]Error("can't b data;Hnot available") K b = Tru6tryBfromGdHexcept E6ion:rgfinallSFalseWhreturn$ # Given a path to a@0 an.toc_entry, Atthe (un1ed)ata(archive, Bo$, C,Aa_size,| offset, time)e, crc =Y&ifFF < 0'negative6 |'with _io.open_codev) as fp[p# Check:make surea localq headerYaorrect fp.seek(_]!OSW9fzEread3: {Q!r}",=lbuffer = fp.?6(30rif len($g) != 3n1EOF`('EOF GT0re expectedu72if U@[:4]Xb'PK\x03\x04'# Bad: LhaFile Hh]QN'bad 'WAname = _unpack_uint16v[26:28]/_extra3 G8:30334V30 + x&+ R23 +=tA # Start of9@raw_^-' 3 raise OSErr(or("zipimport: can't read data") if compress == 0:#(u is not%%ed!return raw_RPE# DeQwith zlib46try^d&v= _get_q_func()5except E6ionBraise ZipI0ErrL;available"`1(, -15) # LenientLae/timeparison tion. The precision of the m0Q # inparchiveWlower tha)p stored.a .pyc: we # must allow a differencee at most one second. def _eq_T(t1, t2);P# dosR onlypcs even>s, so be l'abs(t1 -OQ <= 1 Gi>contents[co] file, unmarshal2c# and \@de object. R's 1 it=magic word doesn't#atch, orMrecorded@metax5m4Scsource: _code(self, pathname, full Xbexc_details = {@Q'*!':? ,N }R@flagI_bootstrap_external._classify_pyc(hash_based = Y& 0b1 != 06if %2bcheck_% ;0<)if (_imp.2Ls,p'never'r6(6h?or K== 'always')zG@Q_byte:_3pyc;9if >FNone-*" =(8RAW_MAGIC_NUMBER/\"1lvalidate_Ms+Zr7els 6~N[_size = \(A_and$?_of;< p# We doOuse  Pstamp `C# tosfor a mor 8 .;5_unpack_uint32u[8:12]) I) orKAp12:16])Ursize):  _bootstrap._verbose_message( ' f'bytecode is stale for {fullname!r}');return None B = marshal.loads(data[16:]Aif not isinstance(60, _q_type):Mraise TypeError(f'compiled module {path\ a Ls object& l0 = sC(_un!.___) # Replace any occurrences of '\r\n?' in the input string with '\n'. # This converts DOS and Mac line endings to Unix line endings. def _normalize_line_2d(sourc5 2 = ".r!(bs', b'\n#, *=1tGiven abuffer containcPython#, Q it #W ,_s(,R#? =  PnZ7&, [ 'exec', dont_inherit=True)!Codate/time values foundZip archive to a% # that'mpatible "8Mstamp storeM.pyc filesparse_dos/S(d, t 0.mk((d >> 9) + 1980,Y# bits 9..15: year$/5) & 0xF. /5..8: month/d(1)A /0..4: day-t"11U,-"11Uhours1(23e8..10: minute2r1F) * 2j20..7: seconds / 2gB-1, )$, |@he #ification $Pmatch1.pysize, # or (0, 0) #availablePget_m]P_and_@4_of+Bself6tryQ#Pp 'c'q'o' from *.py[co]aassertP[-1:] ('#'o@!='6:-1@toc_entry`Qelf._[1&q# fetchU|$mp4+earison#@an embedded 2I*%= &[5&[6 unwRressei )3)_Aate,=), Lexcept (Keys, Index sk0, 0 # Given a path to a .pyc file in the archive, retur # contents of&matching@?%, or None if no source # is available. def _get_pyc_$a(self,): # strip 'c'V'o' from *.py[co]%aassert7P[-1:]('c', 'o')#=#Q:-1] 2trygktoc_entry = ._  s[;hexcept KeyError; XMelseAdata.]x) # GetW code object associated wihe module specified by # 'fullname'am+_R|$, &f" =- -import_e! =for suffix, isbytep apackagVp_zip_seGordeCt # +M\_bootstrap._verbose_message('try {}"',fXB_sep", CRity=2"d *Epass 0mod5 = &[0[#8 D.'if P_unmarshalTe' , hP5IST~ as exc3 {5excUYtcompilej1if 5!is# bad magic numberEnon- Ymtime#a , mMnext)d:inuB' z,-bh '  msg = f" load failed: {!}"[raise Zip`(msg, =)IG Uf"can't findTule {`L!r}"s __all__ = [m"ZoneInfo",reset_tz1_TzonesdTZPATHMNotFound InvalidTZPathWarning", ] ".  }t_commonb% K_Linfo6 except ImportErr{h} _@}", .q( ! *ke_size)E w=idxreB[)FOelse(&l(4# Rcttinfo , (utoff, isdst, abbrindNAz?utc0j = zip?**(\Y">lbb6)) for i in range(b3cnt 7 =  6!Aevia@.ry are null-terminated-Pings,_CexedLRRby poarray but bunsplij#of . I suppose this makes mor0nsegC#us# 2str it's inconvenient here..._vals = {}def get_@V(idx).# Gets aping at @runnQuntilnext \x00# p We can|pre-populateK1by dtV!onJa becauS)erWome zone 0at (@subsof longeras, like so@ LMT1AHS!HD" W!toiP mappshould b {0: "LMT", 4: "p", 5: "HS9 2DT"K!ifz@!inl6%span_end ="s.find(b" ",F1LY[idx];:U].decode<Wretur1]_W = tuple(h= dx&Z>remainder ofa consistsCleap1s (currently unused)S # the strandard/wall and ut/local indicators, which are metadata we don't need. # In version 2 files, we need to skip the unnecessary Nto get at TZ string: Xif header.v]B>= 2 # Each leap second record has size (time_ A+ 4)W;skip_bytes =eisutcnt +9stdkE* 12Lfobj.seek(VU, 1) "Ac = &pread(1)3Should be \n)assert c == b"\n", cG%tz5b""5while (c :f3) !F3G++=^dstr = aFelse?2tz_$BNonereturn trans_idx, list_utc, utcoff, isdst, abbr,estr class _TZifHn__slots__ = [" &", 9cnt;ypeFchar] def __init__(self, *args)for attr, vVA zip+. , 4,wct=TrueAE0setD8,O\@=amethodfrom_file(cls\7eamWS# The starts with a 4- "magic"!ueX ifAeam.4_"* raise ValueError("Invalid - !: d not found"@_) =r16if %;x00E1 l&Dint(Uj5str'15C = (A,0# S8defined inorder thos(rarrange`+uct.unpack(">6l"724)Bcls(iZoneInfoNotFx1Key '"""Exception d when a @v key is.""" import os sysconfig reset_tzpath(to=Huglobal TZPATHf(!to4if |A~if isinstance(+@, (sm)ncC Typg#f"GP must a  or tuple, 5@+ f"E{typS)}: {M:!r}6!ifVall(map(os..`.isabs9stb_get_ix_3_message(tzpatchs)) base_tzpath = sQelse: +env_var = os.environ.get("PYTHONTZPATH", None_4if :ais not W[ _parse_python(DX F0sysconfig_ #("q/!) B.Wuple() def !ifdreturn (l3raw$ =J.split(os.2sep'ne+tdfilter*.isabs, T)f# If anything has been ?ed out, we will warn about itvif len(A) !=kaimportHBingsUmsg = _get_invalid__message(O6H. (M""IG G specified in Zment variable. "Mi+ msg,_TZPathWarnin"]%)4 @ = (A for0 U.prefix = "\n!indented_st%"+ i.join( t"s should be absolute but found the followlrelative&s:r(+ ^find_tzfile(key&"""Retrieved%to a TZife from a key.""l_h atRrWtfasearchmD6m 27,s2 ifE* is?(%;h _TEST_|FP.norm "_", "_"))[:-1]>0, _=c 2abscraise ValueError!f"ZoneInfoQs may /s, got: { }@}# We only carj]kinds ofS alizations that wQchang,#0gth:G ey - e.g. a/../b -> a/b, or/. On Windows#u1Salso n0/b 1\b, stcpreserveqlength.K_r&path) != len(psath): raise ValueError(!*f"ZoneInfo keys must be normalized relative paths, got: { %}"L!) resolved = os.$.J (join(_base, new_!))?tif not F.startswith1+refer to subdirectories of TZPATH del _TEST_) def available_timezones("""Returns a set containing all; ; <.D.. caution::This may attemptopen a large number files, since the best way togPdetermine if a given :1 on5q search5 isy%itMand check for>"magic string" atPbegin.;"""Afrom importlib Rurcesavalid_) =S(t0# S' 'P loaddStzdata packagit exists: tUQhas a# pre-assembled listQuthat only requir: peA one<6try.r_text("A", "`v") as f:O< in=>.k"p(H!if XUP.add(QCexcept (I:, FileNotFoundO3pasYQkey(f 9"+_, "rb -rU f.read(4) == b"TZifK$EG agma: nocover-URFalsemxptz_root{O(1]scontinuY]Z, dirnamzskos.walkM0if :n[# right/ posix/ are specialu#shouldn' MincludedQQoutpuas<Aif ""<h.remove(9!UU!98Rs, QY7key00rel=os.sep != "/": key = k ey.replace(os.sep, "/") if not key orin valid_zones:2AcontinueP>key(fpath)C&d.add(keyif "posixrules" &# & is a special symlink-only time h where it exists, it# shouldbe included~the outpu/xremove(YreturO class InCTZPathWarning(Run93"""P raisbf an iB d fi n PYTHONTZPATH.""" = () reset_tz<() import bisectcalendarollectionsfunctool$reweakref from date i,delta, tzinfo 2.+_common, EPOCH =U(1970, 1, 1)ORDINAL$.toordinal() # It>relatively expensive to construct new` objecD!an$most # cases we're looking at BQsame `s, likdteger numbers of hours, etc. # To@rove0ed mmemory use,ill keep a diary with references #6ve alreadId so far. # # LoadHever?!in2020a versionXedatabase # requires 447;ps, whicapproximatO`amount]@spacLthat ZoneInfo("America/New_York")236 transi takes up,we will # secache siz0512'k~ w4ways get ;P # hi0butcifically crafted1 don't leak arbitr2of 5. @_Q.lru_q@(max=512) def _load_\(seconds= ='\@r_strong}_zA = 86 F = c .OrderedDict().G0 = ref.WeakValue*dionary0_module__ = "Z"q_init_subQT__(cl?ls.62new,G@Tinstance$_@.getb, None)2%f 5!is E5= cScache.setdef ault(key, cls._new_instanceG)) ._from_cache = True )# Update the "strong" ,$mFr[key] =@.pop$, })k}if len(N>) >Je_size: 9nitem(last=Falseoereturn@classmethod]bdef nof, key)y4obj oA;objes!2obj ?clssuper()._0_Pkey = ile_path = (find_tzfil?$if"3is not Non>_&Sopen(Z8f, "rb"?els@_common.loa@dataMUwith rFas f}?%'(f;);qfobj, /= 2Z 6obj?_repr = (# Disable pickling forects created Ls|_reduce__'#le"OXclear\*, only_keysQt o or6 inJ +Bweak})J,O+/\<k(d$ `&{@propertykey(selfpq.@-utcoffset3O, dt7rans(dt).9I/dsCfdstoffCotzname6F?utcG"""Convert@timexUTC to `local !2"""aiDt isE(dt,9?-raise TypeError(") requires a= argumentif dt.tzinfo hDValuidt.tzinfo is not self") timestamp =._get_local_E(dt)2num_trans = len(R.G_utc\6if ->= 1 and V# 5-1]>)not isinstancez_after, _ttinfo)#, $2.c8_fromutc+, dt.year I LG*seDidx = bisect.d_right,_  >[utc[1F kprev, Pnfos[- 2 : idx9'U  6oA(s[)) i,elX7_d,'&0]$# Detect pshift =;r.utcoff - 18.total_seconds() >- -JOAdt +{ i!if }`returnreplace((=1 M4def _findM@if dL Nonffixed_offsetmt  D8_NO_TTINFOSt^Q-al,8.@[dt./!'lt ms < ltqe2oq0s >N-/if[ WTZStr i Y0(ts9 =G ]p4#k is the ition that occurs ,0 th&tj, so w# subtract 1 to get[pcurrent5nfoklt, ts) - 1  assert idx >= 0  return self._ttinfos[idx] ' def _get_local_timestamp(1a, dt):(SK((dt.toordinal() - EPOCHORDINAL) * 8640+ dt.hour * 36minute * 6:esecond)a_str__#ifkey is not None0f"{u._key}"f?els0Breprq5_class__.__name__}(key=O!r})Q.from_file(W _[+~_reduce> &._bunpickle, Ckey,uhcache){h4bmport SpCaise .PpingError@"Can@ a ZoneInfo t created " avstream._@Rmethoa(cls, M_8, /fh0cls)~bcls.noK34pfind_tzN_tzpath./3keyJBload$!g, fobjI# Retrieve all the data as it exists in@zonedtrans_idx, utc, utcoff, isdst, abbr, tz = _common.p `kq# InferDST offsets (needor .dst()))_Mdstoff =B_to_( @Conv15aition  (UTC) into "s since 1970-01-01 1J ts.+l struct `@` objects for eachp,9_list = [ bdelta(G{set), _u tz' dDYM%, <W;3zipq!{JBQ%._H" =E_utc$& (- _list[idx] for idx in trans_idx]  # Find the first non-DST-Uition,Pfor iIrange(len(isdst)):$Wqif not :[i]!self._tti_before = nfo_list[i]P3UbreakJelseW5if VJnfosBu2*[0vdFHNoneQ1SetP"fallback" time z(Dif tz_str is.F aj!= b""pz_after6bparse_J(.decode())/ Q ti~ raise ValueError("No K0rma9 found.")A ?[-1ED # Determine 0hisa "fixed offset", meaning thagoutputN!of2utc:Q, dst_tzname func"Rs doedepend on;Lspecific dateHvpassed.$  We make three simplifybassumpu7her?#@`1. If Qca, it hass Hmigh actually occur (i possible to construct TZ stringO2 Qy STDF bu Beverl, such asHAAA0BBB,0/0,J365/25)H# 2ptains mthan one object, srepresent differ sz$3.S wno unused s (in which case a#_`otherw-n with extrs defined may.`appear*not* be a TTA@AViolsA0thePwouldSfairly exotic, M:As sh4almost cer!ly>1be %*./G(theLponly thaffected b s0if A) > 1 or~isinstance(v, "&L_f= Fals#elGv F2TruE else:  self._fixed_offset = _ttinfo_list[0] == (tz_after A@staticmethoddef _utcoff_to_dstoff(trans_idx, sets, isdsts)::P# Now we must 6form our ttis and abbrs into `` objects,Kbut there 9 issue: .dst()breturn a timedelta with7Idifference between!()the "standard" HW, butH%Cbase ";F"DSTre not encoded ing file;Jwe can infer whay are from4]Q flag0 it(nosufficient tojxRlook Td last , becauseoccasionally countries will shift both  .R`typecnAlen(%s)lS@s = $* . # Proviassign all(0.B_`?sum`_found = 0Pfor irange(1, )bif dstg= T%VbreakgRidx =[:[i] dsK[idx# We're only goingdaylight sav&im~f>dstcontinue# Skip any!0s thave already b7e+m+3_ != 0{ Ke& =s\ @compa mK - 1Rir7]-8 ];4< (;- 1]N +-A# IfafollowPitionAalso^fouldn',Fa# findLby this point, w{%toH0# s8!it BhopeFUTgets 60 laz;#ifI#[c1}0 7CM+= 17 5off&JelseSPwe dipa valid0ue `a give1dexll end up\ # with0 dstoff = 0 for something where `isdst=1`. This is obviously &# wrong - one hour will be a much better guess than 0Bidx in range(typecnt):'scif nots[idx] and 59" = 3600 ^dreturnVp@static!od* def _ts_to_local(trans_idx, list_utc, utcoffsets""""Generate number of seconds since 1970 *in the gr time*. necessary to easily find;Qition@s]O1"""OS1_ E [[], []]# Start withwimestampsmodify in-placetmwall = [zR G0), wif len(nJ > 1G_0 =5[0]%1%jidx[0]05if 3> 0yX,$% = 1JelseFg 05_X[0][0] +si *1*1@!1,tAGidx)[/k[i - 1O4ue=]x FiF.91][.JH ` class _ttinfo__slots__"JB", " stzname"_init__(self,", 1'.[ n# =D P# =Y2%eqWotheru(LEm!= 4 (,,,,,)Crepr): # pragma: nocover61f"{!__P__.__6__}qR+ f"(,2}, &})?) _NO_TTINFO =7v(None, ) _TZStr: __slots_s_ = ( f"std",8dstIstar)en/get_trans_info: _fromutc"dst_diff!) def __init__self, std_abbr offset, H =None, end a!):V.5! =J@! -m 02td_ = _load_timedelta()1pelf.std/ tt#vutcoff=; ^0), tzname.f:Q1 = & en2endm3 ,a1N/2,z\!6# These are assertions because the constructor should only be called # by funcEathat w1fail before passingO0 orOVris not uA"No i^"specified"B@ >?_ my_3 ;6 s(h, year\:O."_to_epoch(& = JO.end+ breturnQ "tsg, folda"""Get51rmaBabouxcurrentv- tti""{a# WithQ = 0,|period (denominated in local a0) w67theI sm"r B2s aO!of^pgap and M8;j = 1, it runs O \ toL`beginn2&N.! 0 Soorder to determinDST boundaries we need(know bothKwhether Cis positiveAnega q(rare),0(itJRurns Ois boils down XOR is_\#if!= bG>= 0-<Felse/~+12"if  << isdst = start <= ts < end Uelse:isdst = not (end7E%) -return self.32if <T2std0 def _get_trans_info_fromutc(A, ts, year)q," =P>qitions(-,# -( std.utcoff.total_seconds()1/?dst/0$ifF3g<0# For positive DST, the ambiguous period is one dst_diff after +@# ofE; for negaWebefore#Z.4:> 0:_>=Y<X" +,qX `. Z+ -\/bfold =oY , WA) post_epoch_days_d_a"""Getq`number1 between 1970-01-01 and YEAR1"""1y =gA - 1y * 365 + y // 4 - 510000 - EPOCHORDINAL class _DayOffset __slots__ = ["d", "julian @hour`minute ""]Gq_init__HR, d, @ , >B=2, >B=0, >'=0:"if9)2365`min_da/raise ValueError(f"d must be in [{C },D ],}g: {d}"/.J}# =z! = # = 5WQ2_tok\;OO = _b,and d >= 59calendar.isleapQfd += 1e*M = (+ d) * 86400/+SM0* 6Cs'KCmw} r i_DAYS_BEFORE_MONTH5-1, 0 3"59 90, 120, 7151 8 62127243 7 6304#33 !) b)def __init__(self, m, w, d, hour=2, minute=0, second=0):=if not 0 < m <= 12 raise ValueError("m must be in (0, 12]"2RwR5Q wQ5P0= dQ6Q dQY[0, 6Q'e.m = mZw = wZd = dV! =] gWp z# =@classmethoeymd2ord(cls, year, month, dayreturn (i} _post_epoch_days_before_H()/ + cls._DAYS_BEFORE_MONTH[r],( > 2 and calendar.isleap_ `5dayF%# TODO: These areactually dates as they%expressedxlocal time^92_to 3"""Calcul]1thegF0 ofj occurrence fromE1"""id# We know , we need to convertP intof+L Week 1 i first win whichC`d` (where 0 = Sun appears.P@5 re82entXHlast$ofWH, soO/Prange quQs_in_"& =*E.Clf.m] This equation seems magicalI'll break it downE# 1.nQ says% Mo%v, POSIX<( @ + 1get 1 = OU -> 7#is still iv/8pcause t@mathWmod 7c2. Getday - desired/a: -1 %6we don'tM do anything0adjnegative numbe@3. Add 1 besba 1-ba6dex ( 1 = i.d - (P!))2+ 1 5`# Now 8a 0[P vers`of `w`cGw-th2%d`+w - 1) * 7)w@only>if w was 5, and `w` means $# "last occurrence of `d`", so now we just check ifover-shot theM0end@the month and3so knock off 1 week.7"if-_day > days_in_A:&'U-= 7 ordinal = self._ymd2ord(year,&m,e)9epoch = A{* 86400 +Xhour * 3600 +Winute * 6esecondCqreturn j def _parse_tz_str()# The tz string hascs format$\# std[offset[dst ],start[/time],end "]]7=Pdst m be 3 or more characters long*&not containI`a leadcolon, embedded digits, commas, nor a plushinus signs;Kspaces between "std""" are only display""ar # actually present inJY~#ybm is ``[+|-]hh[:mm[:ss]]``{%1, *w@_end2 = .split(",", 1)7`# fmt:  r_re = re.compile(r"(?P[^<0-9:.+-]+|<[a-zA-Z0-9+\-]+>)" +56off>[+-]?\d{1,2}(:\d{I)?)?9r=odst>[^r93r"(=z()??g # dstQ)?$" 1offMn\Em = Qv.match(qBNoneSzaise ValueError(f"{}-T valid TZ"Rstd_abbr = m.group(=dstFdst"0 = S .Tp("<>x if']o :Wy:Coff"6try^:=fdelta(1gexcept]G as |$r"Inp0STD/!se") from 7elsQB = 0R-o!;dst sB5 ($?DST$from e else: dst_offset = std u+ 3600 ,if not start_end_strJ!raise ValueError(f"Missing transition rules: {tzB6}")c \sm[0].split(",", 1):tryI, end = (_parse_(x) for x insXgexceptK as ?Invalid TZ stringv from ereturn _TZStr(Wabbr, ,  "1artJelifT present without DSTn ?# This is axtic ttinfo, don't Ay,(_load_timedelta<),  0) d_F) def rdststr)pdate, *m =d4strb"/"T0if '[0] == "M";n_is_julian = Falsem = re.match(r"M(\d{1,2})\.(\d)1$",\iR@if mN?Nonf#ds/2: {]X = tuple(map(int, m.groups())w = _CalendarO''(*L/  4J4 86Tru7]uate[1:]S d* I/doy = int(Q53DayWdoy, N0if _componentFlistG (:"On:0en(0lF < 3 :.extend(x* (3 - o r.hour, P.minu Aseco9 e, k2tz_ hr"(?P[+-])?$h>- (:m22})se)?)?",JsJp# Anythpassed to tAfuncshould already have hit an equivte# regular ex*sto find the seS1to p.7x2rt !isC$, W`h, m, Spv) if v~;! 0_ vi, ("h", "m", "s"))q )  total = h * 3600 + m * 6 s#if not -86400 < 3!< :FQraise ValueError(-f"Offset must be strictly between -24h and +24h: {tz_delta}"I# Yes, +5 maps to an o_aof -5h2if match.group("sign") != "-"R*= -1return total