4"""Record of phased-in incompatible language changes. Each line is:the form: FeatureName = "_(" OptionalRelease "," MandatoryGKCompilerFlag ")" where, normally,j"@" + *(&,{2 Y)) % =s((2, 1, 0, "beta", 1)i020@alph100 k6) K R3final", 6CO_4) P 2(2 3CO_DIVISION) abs!olute_import = _Feature((2, 5, 0, "alpha", 1), !(3/202 CO_FUTURE_ABSOLUTE_IMPORT) with_statemen+6 WITH_STATEMENprint_function1 f2 0PRINT_FUNCTION) unicode_literals*/ & UNICODE_LITERALS) barry_as_FLUFLJ3, 16 4.fBARRY_AS_BDFL) generator_stop?bet07bGENERATOR_STOP) annota^ 33, c/10#`ANNOTAU S) # This file exists as a helper for the test._frozen module. """Shared AIX supd<ss.""" z7sys config try:s&ubprocess except I Error: # pragma: no cover>t# _aix_'is used in distutils by setup.py to build C extensions# before s dependencies like _posix#are availabEX_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 Tuple[str, int] Ne.g., ['7.1.4.34', 1806] The fileset bos.mp64 is the AIX kernel. It's VRMF and builddate Dqreflect4current ABI levels ofruntime environment.1"""# We expK1all!systems to have lslpp installed in this locationIout = subprocess.check_output(["/usr/bin/N", "-Lqc7"])Jout.decode("utf-8"strip().split(":") # type: ignor)# Use str() GQint()elp mypy see8sreturn (3out[2]), 6 -1])) def aix_platform():=P() ->vn!s are identified by four decimal values: V.R.M.FV (versionR (release) can be retreived using ``uname``Since 2007, start#Awith5.3 TL7,<M has beeincluded 4erepresentTechnologyLP (TL)PAIX. sF (Fix)walso incr`s, but$1notDvant for comparAasesbbinarytibilityHOFor Bso-cszReeded@RAgain'$Qof anH6associat3H!IX7#described as guaranteed at: https://www.ibm.com/\support/knowledgecenter/en/ssw_372/Bary_}a Qhtml M%pep425 purpoW tag becomes "aix-{:1x}{:1d}{:02d}-{:040}"./at(v, r, tl, bitsizeDP6107-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[intN@gnu_ysconfig.get_ j_var("nLtif not A]`aise VMErro@:sdefinedO=^ 6446Ri{w_w Python wruilt ond#_ @DATE|-1ure #F-Lcq| awk -F: '{ print $NF }' build_date = sysconfig.get_ _var("AIX_BUILDDATE") try: cbuild_HFint(.except (ValueError, Typ )Ifraise &*(f} is not defined or invalid: " 6f"{3!r}return _aix_tag( vbgt(), 0D) """A minimal subset of the locale module used at interpreter startup (imported by;3_io8), in order to reduce 9 time. Don't iE directly from third-party code;d``i instead!# M4sys _0@ if.platform.swith("win"def getpreferredencoding(do_setNS=True1\flags.utf8_mode$u'UTF-8'._getdefaulk()[1] elsO 6qCODESETUAttributif hasattr(sys, 'getandroidapilevel'b# On A$ langinfo.h and z are missing,1 isF# alwaysd"mbstowcs()5wcstombs().8"qb yS%f*e# This path for legacytems needs more complex0FK function,wJfull ~NY lm? Ba}&bassertD  +result = t4nl_ (6!ifA55sys == 'darwin'8'# gS can an empty string9Awhen&psetting4 an^ v2# DHat case becauseq-Q char]Pn OSX:@nothwill crash3 result = 'UTF-8' return r$D """ Basic subprocess implementation for POSIX which only uses os functions. Only i<! features required by setup.py to build C extensjmodules when s unavailable.F`is notd on Windows.import os # distutils.spawn3'bycommand._ext # calls.Popen().wait() class :fdef __init__(self, cmd, env=None)'p._cmd =$?Penv =7 pcode = Q wUd pi^os.fork(),d1if 6= 0@# Ch 1: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![]first, last in (("a", "z"), ("A Z 0 39")A ch8range(ord(Q0), VW) + 148.append(chr(ch)e\"./-"%v'.join(2gif isinstanceI, (tuple, listp!st1cmd/elB7str 8B[cmdU trRFalse40arg5B!if ar {D Z>6argR#%O RRif ch&n  w YskATrue_aix_sup"usm.;Poutpu9 **kwargs2if raise NotIedError(repr(/)TMRValueDCf"un3ed : {cmd!r}"Wtmp_filename = $"check_output.tmp" if not isinstance(cmd, str):!%cmd = " ".join") f"{cmd} >{tmp_filename}" $6tryI # system() spawns a shell+kstatus = os.,2cmdo exitcode"Bwait2D_to_(54if N raise ValueError(f"Command !r} returned non-zero 9? f"l { R!r}")7 with open(F, "rb") as fp5stdout = 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 r!d }8to _ # speed up interpreterrtup. Some of the s`s such( # required early butY0lot^SothersSee issue #19218 __[""Private 1Rthat we want-Pregistpvariouss !o 4they willTs like: #i~iter(somebytearray)!craAit, 0ble(`Note: GAimpl"atDthesxmbe distinct #  may have their own imple@mentation specific types that # are not included on this list. bytes_iterator ==(p(b'')) !`array_%1yte())) #callable-??? dict_keyDq{}.keysB)_value+-Oitem,+$Q[])) oreversy d(/i) rangP (0Alongz(1 << 1002?set,1set ?str!"")) tup|>?zip>1zip!## views ##s2()) ~p## miscemappingproxy+1.__ j_) gen(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 NotImple!edUbreak;elsNFTrue class HashQ(meta=ABCMeta): e__slots__ = ()@abstract(_hash__(self~y0>h ;1subhook__(cls, CE`if clsB Fe,_c#"_!") k_Await9aQ@(2!__@_get (GicAlias) JC(Y!send(self, vaslue): """Send a value into the coroutine.,Return next yielded6or raise StopIteration:5"""F) @abstractmethoddef throw(self, typ,t=None, tb Ran excep? inK if@ is ^e_if tb1typPval =%()I?noth3val.with_Jeback(tbDn2vals_Qclose_G0GenorExit insid:try. P) (,O#EpassJelsetRuntimeError(" ignored p"")k@classQ__subhook__(cls, C`if clsC< @r_check_`s(C, '__await__', 'send1 '-rHNotImplemented w.register(A) a Asyncble(meta=ABCMeta):__slots__ = (__aiter__Gs5torMwfV,bl"j""Pe!___getitemicAliasc _a aze3"""$  0whe hausted.9 4 .J./orNP__", !( (AfromDhronous g|IW,v{ return await self.asend(None) @abstractmethodasync def /:, value):":"""Send a into the ?hronous generator.9Return next yieldedCor raise StopA It>6ion?5"""K.bthrow(1typ=A, tb Ran exception in] if,@ is _if tb-5typ?val = typ()I?noth3val.with_?eback(tbDn2valTQclosex`G1Exit inside coroutine:try  W) (,6Epass/JelseRuntimeError("  ignored "WclassQ__subhook__(cls, C`if cls E[ r_check_es(C, '__aiter__'  '38ay 'vrzNotImplemented .register(;_KA)  ble(meta=ABCMeta):x__slots__ = (VY while Fa!m@J,V2"__"\!___getitem{icAliasdDtor([#D [' 8" Q fromY=@ Wheyhausted,('sEV,__-3?tor'4 __/__6&or0bytes_iterator) Iterator.register(bytearray_i>) #'callable&%dict_keyJ$_value&Oitem% Olist !oreversn Orang Olong&/se ?str ?tupb 7zipB class RQible(q ble): __slots__ = ()@abstractmethod(cdef __,d__(self):Hwhile Falseyield None] Z1subhook__(cls, C`if cls i ireturn _check_ahs(C, ""6E__")=NotImplemented @2Gen??tor? +Nnext'B"""R@the $ ` from gk. When exhausted, raise StopFtion-5"""9`.send( (2!, """Send a_ into#ed6/orEQthrowQ, typ=A, tb Raa_0cepJ? inK if  _if tbK5typPval =(I1not| h3val.with_eback(tbDn2valsQclose_G&Exit inside :try{. P ex) (,#Epass4eRuntimeError(" ignored p"Gmb'/__V !'___', '__a |'6^ close') return NotImplemented Generator.register(g) class Sized(meta=ABCMeta): __slots__ = ()@abstractmethod(def __len__(self):C0=g :1subhook__(cls, CEif cls i^br_check_\cs(C, ",") .~ Container5cQs7, x_False4"'n!__,_getitemy(xvicAliashCollection(s, Iterable,vv ds9?Jqiter__" 4iP_Call  -""" Represent `7[argtypes, result 2]`.9This sets ``__args__`` to a tuple ing the flattened``Y!``Xfollowed by ``l`l0Exai6: `[int, str], float]``c4``(0/)^^2"""z4new#origin, Y2tryLRjcls.__create_ga(?-except TypeError as excRimport warnings=A. (f'{str(exc)} ')-1f'(will raise ain Python 3.10.)',LDA capWr  ]@uB 9'if not isinstance(,) or lenf) != 2:(" must be used[4d, ...]5'].t)B, t_! =Ij(if.T(listu!gaS" =(4T) + (e,!# relaxes what 2@ canon purpose things like 6 # PEP 612 ParamSpec. Responsibility for whether a user is using E # Callable[...] properly*deferred to static type checkers. BUelse:ga_args = return super().__new__(cls, origin, ;!) 6def __repr__(self)iaif len!._p__) == 2 and .0[0]EllipsisE p)"(f'collections.abc.@',0f'[[{", ".join([_>1(a)Ka in:-1]])}], Q{D -16'6Nduce8* =yif not (Z)Q H" = list( [:,E[-1]fr_>GenericAlias, (: sgetitem ,  ed during TypeVar substitu", s the custom!UclassA# ra<Athan*qdefault(s.v object gaad$U = gaPt_resnC >t]d7R(#$, G {y 3objnB"""RF2() of an, special-casFs (internal helper).Copied from :mod:`typing` since yshouldn't depend oat module1"""-if isinstance(obj,  ?7 if2.__~ __'builtins'tobj.__qualname__k2f'{#T#}.4}+E'...- 1Fun3;%! ARQ(meta=ABCMeta):p__slots!# (@abstractmethod|U_call*, **kwdsRFalsee@{ N1subDhook{CI`if clsF___ss(C, "_"lNotImplemented!___1 = S(ricAlias) F### SETS ### class Set(Collection): """A set is a finite, iterable container. /RThis Pprovides$ crete generic implementajs of all@methods except for __ceps__, __|__ and __len__|o override the comparisons (presumablyUspeed, as*zsemantics are fixed), redefinekvQge__,6@thenC other operwill automaticalyllow suit.>2"""f__slots__ = ()3defvb(self,c!)::Pif noinstance(,'+return NotI|(edI1lenf@) > JEUFalse<elem in x1if n "& YITrue1t__H{7) <y.~"__u gaeHO!if8- D o X 4 Yc !X/eqOX!==!)l@T|Afrom@(cls'''Construct an )r"FP any ZJc inputVIHMust\2is 1 iflor signatur*Adoes!actGxs1''' <icls(itn?andIz-f(m ._6|QvalueZ i!91__rQ = __ isdisjoint"'Ra0twos have a null inters.' for value in other: Dif vJself)return False;QTrue def __or__(G,l)Oif not isinstance(, Iterable,wNotImplementedkchain = (e for s y%s)6._from_i}(Q)0__r# =?sub;Set"R? =  W !inQFjNqV@rA~B! Ax d# -/2 | ! -t1__r AhashFc"""Compute the #of a set.B!No'at we don't define __:1__:0all:Bs arS.But if you?ay&8 type, itsXg shoulcthis functionTmust 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+ 152lenh = 1927868237 * (n + 1Ph &= W3uxAhx =P&(xB ^= (hx ^<< 16) ^ 89869747) * 3644798167 h &= MASK h = h * 69069 + 907133923" 4if h > MAX:&e2h -^E + 1.\== -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 for __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 self, value]rdd an e.araise NotIedErroro tshRemovev Do not sion if absentrg(!Ifa member,A Key "ifQ40in j1>=(0..1pop RbpoppedA. Rk6Zempty1t =Zl:try = next(it)*PStopI ; from NoneCe Rclearl1"""`@is s$(creates N newators!) but effective while Truej v 4Fpassq__ior__4j in itFv"{+ e?andfD - iP sxAif i-V;elsxiisinstance(it, ij ._v -p !in self:  self.discard(value) $]else:&>-ad:preturn  9def __isub__(V, it)Uif it is3dfclear(Afor j in itDH : MutableSet.register(set) ### MAPPINGS ### class Mapping(Collection):__slots__ = ()D"""A3a generic container associating key/Qbpairs.NRThis providesHUcreteYimplementas of allLmethods excepty__getitem__,0ter and __len__|2"""@abstractNYJ7keyraise KeyErrorL86get0, default=None>0'D.)k[,d]) -> D[k] if k0D, )d d. dCPs to G!.':try1U[key]*$6#__s  #yVFalse FTrueAkeysjW1"D.Sa set-like object fa view on D's%s"nKeysViewdx^yz5 {OItem|H}~n . wVGxE__eqWotheruPif noinstance(",)+_DNotI,ed}2dicG."q()) == ]__reversed&3  mPproxy|'_Sized#'_="',se__init".:3 = "Bd$1lenC|Crepr|s;a'{0.____.__name__}(!r})'.formatg^7" =""(GVAliasF/O@, Se.P@X%from_iterable(self,s it): return set(it)  def __contains__(self, key9Pkey i@lf._mappingFCiterB=yield from \: KeysView.register(dict_keys) class Item&"(Ms2@, Se__slots__ = (@=amethod%_Cable#%Gitemkey, value = vz6try:v = U[key]0except KeyError<VFalse2?lse'Cv isror v ==0for  g(  "V9Collection): ?if Z -6TruB6 ^ "0Mutiq{ Z"""A 7ta generic [0er associat:Akey/r pairs.QThis  providesHUcreteYimplementas of allM#s JyP__getux__, __s 3del>_"(and __len__2"""@abstractl9[`UraiseS SL __marker = object6popI, default=4[P'''D./k[,d]) -> v, remove specified),the correspondingu.%A If5is not found, d:Ded if given, otherw1)CdU5'''as`w+$n$ifr\ZXCe1del C@' popitem() ->$ (k, v), remove and return some (key, value) pair  as a 2-tuple; but raise KeyError if D is empty.;5''' Etry: [key = next(iter(self))#except StopIterationA from NoneC0 = ZU[key]?del  1def clea2'D.A) ->{C. R`ll items /D. while True\"@.popL( 8Fpassaupdate_, other=(), /, **kwds)=c''' D.1[E, ]**FUL" Dmapping/aable EWFIf E present hO.keys() method, does:0 for k in E: D[k] = E[k% Uolacks U  ZvSPIn ei# case, thisfollowed by:0, vI F.5s()Qif isinstance(2, M@ ey^(" = elif hasattrk"n"j >q sQCo( Fsetdefault=/7'D.0Qk[,d]D.get(k,d), also set =dPk notD]/3 = 9RP MutW`.regisZdict) ### SEQUENCES ### class SequeReversible, Collecx"):O"""All the ops on a read-only sL.4Concrete submes must override __new__ or __init__,P__get`1__,:r__len__`2"""b__slots__ = ()@abstractm_OSWindexVIP<!__92Qi = 0b  viIfyield Oei += 1p? return  def __contains__(self, value): #for v in  ifs3 ("== )-return True\aFalse reversed i#(range(len'))-wQyield6[i]dQindex2, start=0 hop=NonR'''S.5!1, [0op]]) -> integer -- afirst 92 of. Raises VvError if the+ is not present.;Supporting and stop arguments@optional, but{recommended5'''$#ifYezart < 0f = max" +EJ, 0)Z opY/opXeop += 2i =_[Rwhile1is ZU! < :tryZvS0elf09iexcept IYbreak5i1r87?Xcount2'S.`numberoccurrences5isum(1 'v2 ) SequV.register(tuple)?strmemoryviewiclass ByteString(z"):1"""This unifies bytes SarrayuXXX Should add allir methodsC2"""Y__slots__ = () c/s)~tMutable rjB"""A` opera s on a read-write s`Concre!ubA`es musovide __new____init__,__getitem__, __s 6del0len#insert()gA@abstract``W^"eWWP&5,S ??bbeforeF #cappend): 'S.append(value) -- ap  to the end of sequence' self.insert(len("),A!) 'def clear:?2'S.) -> Noneremove all items from Ss6tryDHwhile Truee.pop()wexcept IndexError6Fpassreverse8 *IN PLACE*En = for i in range(n//2)Q[i], n-i-1] =&i]0ext3sW3'S.!riterabl 3 by ing element<"ifAs is Os2istns v ' ;.'(vQ0, i8=-11''S[]`M`nd returng2 atJ (default last). Raise9 if list`empty 0out8G&''7vk1delFv- "\`first occurr%V +*not present9.)__iadd__<=?#` MutS.register()bytearray) # Multiply inheritingl e ByteString # This module @used41map-old Python 2 names>3new4Din #* 3 %cpickle`". nDneedf3ke $ streams # generated withU`2 load43. is a copylib2to3.fixes _imports.MAPPING. We can3 # 7 and use@mappCPdefinhere, beca#3Cuses.Pus, t]bcould .mmbto be {ecursively. IMPORT_A = {?'__builtin__' : '2s', _reg': ' PQueueq SocketServerss$ConfigPars$cp$1rep@4libtkFileDialotkinter.filedAotkSimp,s .ColorChooser': 'tkinter.colorchooser', CommonDialog'.d.& XTkdndE<htkFontfMessageBox$m4boxScrolledTexNstVTkconstantsU(iu%tin8ttk:4Vmarkupbase_;a_winren QthreaA_ TdummyI: '_%Pbhashttdbm.bsdtdumbdbmn#Kg 0: 'I4gnu.xmlrpclibK t.client"SimpleXMLRPCServer+sdChttpK Ihtmlentitydefs' : '.4iesqpHTMLPar$phQCookig@c %ja$BaseHTTPI Ptest.r_supporqcommandsubproces1urlrurllib.?Qrobotr$*>2 u.reques6anyPq_abcoll\ xections.abc', } # This contains rename rules that are easy to handle. We ignore the more # complex stuff (e.g. mapping the names in 4 and types modu!).$esshould bPn befv imRfixed. NAME_MAPPING = { ('__builtin__', 'xrange'):63 ('sw :Wreduc:functool;<nv!sy66funichr68$od _str')8Dlongn 6int8EiterFizip6 8p 8/ma88Ufilte ; Afals)('<A@zip_'~;): A AUserDictbIterableD%, ('UserList', 'User ): ('collectionsq, (/dString ?Apwhichdb> ;9dbm0a_sockeqfromfd'/1multiprocessBConn> #&.c 8, '.V 2`PkZ1tex(TCfork_PopenRp_,}$')SQurlli]ContentTooShortErrorQ$!.e*RgetproxiesHRrequeL"@pathname2urlB $Dquote_pluPparse > { 9H(unT$@; "v x84rl2 =ru$DcleanupB"@iencode?$rl<5 :zretrievx ># B2 OHTTP=?URL< , } PYTHON2_EXCEPTIONS = (/"ArithmeticP"l`"Assere ttributeBaseExcep0AjBuffer(ytesWarning'pDepreca: 9EOF>Environmen*B zFloatingPoi+kFuturehGeneratorExitU)IO|4Imp" LaIndent @Indexbmultipi .context # Same, but o03.xO2.x REVERSE_IMPORTa = dict((v, k)4`(k, v) +.items()) assert len(VA) == B) ) ) Non-mutualmpings. .update({,cPickle': 'p *_elementtrePxml.e ".ET-FileDialogItkinter.filed(OSimp*s ,DocXMLRPCServerYxmlrpc.s TFHTTP)Khttp'?CGI$ # For compatibility with broken !ps savedBold Python 3 vervsX@Dict`collecs^?Lis QStrinP@pwhichdb^4dbmV3IO': 'ioc5})  @_bz2ep_q0: 'functools, g,1: 'N1 ,  C('____', 'bases&S): ('sRstr')k&('eStandard :@5, ' 9 , ('socke t', '_socketobject'): ('S+Type'), }) REVERSE_NAME_MAPPING.update({ ('_functoolsDbreduceZ__builtin__,9tkinter.filedialog&RFileD7, ')H HLoad.<, '"P GSave@ " PHsimpS 9, 'xmlrpc.server3S rHTMLDoc{DocXMLRPC& N8DocGenerator'):[3`@RequestHandlee8j b0Z 2CGI;pHhttp)OHTTPl -&A :k?CGI.#ebsk< zPYTHON3_OSERROR_EXCEPTIONS = ('BrokenPipeError''ChildProcessonnectionAborted_Refus5YReset:.ZExistzNotFounI objectBdoes" | class DecompressReaderYave! and arguments.PA# If5Ucontains multiple ws, eachA will need a separatw. A new'orN%AalsoQed when implea backwards&()=r3t .+ +(Bor =_k=(**TQExceputo catch frombasignifuinvalid#P dataa\ignor % =7+Cc -V= Nonfrsuper()(WeZ80elf.(<&Ainto, b): with memoryview(b) as ,.cast("B"Pbyte_7: data = self.read(len(,)))- [:'<P)] = )ureturn ! Adef `j, size=-1)!ifF < 0P8Rall()Ubif not<"orO_eofE1b""9 = None # Default if EOF is encountered5(pending on the input, our call todecompressor mayL1any@0. IS is case, try again after@yanother block.Pwhile TrueZ_.#1rawUA = (q 4qunused_:%ory: >!fp(BUFFER_SIZES8} !]breaks# Continuesnext stream=_factory(f?(**AZ_args%?try3go.(^cexcepttrailing_errorv3# T&` isn't a valid #ed4; ignore it?;elsn(raneeds_/?BPraiseE63("C@ed f>ended bef0?"end-of- marker was_ched">e O.!if Xo + Qeof =r 9pos#6gpos +=>2# Rewindiu`beginn)!of4!_r>fp.seek(0UFalse;= 0%or oZHc, offset, whence=io.SEEK_SET): ## Recalculate offset as an absolute file position.;if whence == i^]dEpass3/el5:CUR5= self._pos +L :ENDL# Seeking relative to EOF - we needrknow thv's size#ifJ < 0h# wh+ read(io.DEFAULT_BUFFER_SIZE5 * w*se raise ValueError("Invalid vC for: {}".format(5)) b# Make it so that1 is*number of bytesF@skipaFward>$if:P}?min,)aif not Ubreakp-= len(freturnU def tell(VnB"""R1{current5""" ^`"""Sha7psupport` scannaPdocumStype declara5s in HTMLX . This moduleSAused{a found9`html.parser3. It has no zublic APImashouldr1be ddirectly. 1 imPre _name_match = re.compile(r'[a-zA-Z][-_. 0-9]*\s*').2BstringlitG(\'[^\']*\'|"[^"]*")D0comH\close--\s*>') _markedsecc,@]\s*/ # An analysisXMS-Word extensionsavailable at # http://www.planetpd sh/xmlarena/xap/Thursday/UtoXML.pdf _ms@del  class P$Ba 2"""b base %which provides some G4on qmethods!by PSGML/1 k!s.!T__init__X_ __DERm" up.I must be subj3ed" e, message): r aise NotImplementedError( "subclasses of ParserBase must override e;A)") ?def reset(self):W.lineno = 1offset = 0FlgetposG"""Return current T number and LE."""dr2!, ,t# Internal -- update] This should bej# called for each piece> data exactly once, in orderm CtherGwords the concatenationI1allinput strings to this?Afunc0{Tqentire B.3qg, i, jif i >= jYjG!aw=`rnCs = .count("\n"s+2if . rFG+0B(ponhrindexoB # Snot fail?`% = j-(pos+1)$Oelse2@U+ j-i::p_decl_o@char/''p ."ar(nvuse by )3a3S7, i#ome sortnh;r"HTML ai_# deployed,"qonly be@docugB typ*;#cl ("".ISO 8879:1986, however, has mor,xP3r syntaxs "qSmpty }E $;' +G_`in ("-"AR# Stad edFbuffer boundaryr<@or j+a )s%-`# A si, practical verscKlook like: ((O|lit) S*) + '>'n = len( 2] == '--': #comment # Locate --.*-- as the body of 7return self.parse_&5(i)`elif rawdata[j] == '[': #marked section0[statusWord [...arbitrary SGML...]][ gWhere Y`is oneTEMP, CDATA, IGNORE, INCLUDE, R %Note that this is extended by Microsoft Office "SaveWeb" funto include [if and [endif]._X se: #all other declara@ eles^!type, j =_scan_name(j, if j < 0:Bj!ifwV @"doc "7T__chars = ''IQwhilesn<7c =q0YAif cv>pP# endwisyntaxE,gmi+2:j]&Pahandle(eI#Jelse# According toHTML5 specsjs "8.2.4.44 BoguH## *!e"95 Markup*:opeG#C5, aUtoken should be emitted=`# Callqunknown provides more flexibility thoughMfHgI + 1Din "\"'FAm = stringlit_match(>, jif not m@-1 #yomplete'jm.end(a c %abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ~zjvG_== "[#cPGdPa sep#e l rAO_]_subset( !d{"attlist", "link ."}.Q# must toler[]'d groups_a content model in an element declaration `# also5data attribute specific;@s of?lisSlink type subsetsq! s 1 WsSself.error("unsupported '[' char(%sH1" %)]else:q j\expeci"[WSs5"unh%%rg` % raw:[j]tif j < 0return ju-1 # incomplete # Internal -- parse a marked sec*# Override this to handle MS-word extension syntax content~2deft_r_r(<p, i, re6=1) = %.Oeassert7i:i+3] == ' o%ng+smatch= ionclose.search(U,-el if_ndif"MS Office s ;'unknownptus key! %@kGion'sHi+3:wqif not ? }%-1h#if )@@.start(0^_ [ sM0endK~0comhOlength or -1 terminatedG=@IA4] !:--' e &)'>C = _43: \3&_comment(rawdata[i+4: j]) return match.end(0) # Internal -- scan past the isubset in a nBIP:j+4]_"=*A/g=> <`object blockquotepre> ' +c + '' +0` + ''HNelseE' def lookup(name, frclocals"""Find the value for a given 81 inenvironment."""%if)\1',  s[X]<.f_globalsE'* O'__builtins__'Y(" =S FDype(;`) is t#{}S'.!"3', %) if hasattr, ,g?get;.None, __UNDEF__Rscanvars(reader{"""Scan one logical line of Python and2 upysvariables usedbq , lasttoken, parent, prefix,Br = [], ('' t#, Lstart, end,gize.generate_-PO2 ==Q6NEWLINE: breakT,1AMEb@ notkeyword.kwlist8&if w:'.'!l%U,0$= =%>)6.append((F )ASVwhere! q 3P elG=oB+ '.x)" =)# ='O LNhtml(einfo, conF#=5B"""RHa nice HTML docu describingtracebackne1, e, etb = pif isinstance(-360.__!__?pyver = ' sys.version.split()[0]$: `executG@date'ime.ctime(.(@headiA%s' + date)T''

A problem occurred in a Python script. Here is the sequence of function calls leading up to -`error,UPorderEyp .

''' indent = '%s' % 9doc.html.escape)ROelseg%?'args, var kw, local>argvalues(&oU!if7z != '?'.0in strong(py7unc&W""^'b4+= fformat ,JB=lambda @: '=Qrepr("))Ehighligh%{}ddef reader(m =[*])<[0]] = 1D_try: returnPcache6[0]9finally:X[0] +[0var@scan (,&%0row0 ['%s ' % where) + strong())CBelif+ == 'local'j O /se>  .split('.')[-1] dump.append('%s = %s , pydoc.html.repr(value))M/el_%P + ' NundefinedU5') >Erowsqsmall(grey(', '.join(m)VframeM'' >0>''3'\nx)exception = ['

%s:NOescape(str(etypU, @]AAfor qin dir(e@!if A[:1]_': continueBl5- =Pgetat!,J\n
%sb#\ncbindentC!, PLreturn head8n}'o' m )>._:", 'P, etbI def text(einfo,"Sext=52B"""Rqa plain. documenttbing a givenA.""" |1 = qif isinstance.C60.__!__?pyver = ''"ys.version"@)[0]e$: QexecuG0dat `time.c(.(P= "%sG" % MPver, OAwblem occurreda. Hersequence of funcsscalls lXQup to,U;yp.F_I records = inspect.getinner*E(etb-, file, lnuSunc, lines0dex`3! =: and os.path.abs( ) or '?'@args>r Akw, r targvalues(fsrame) call = ''if func != '?':1.ain ' +( <""CG+= inspect.formatargvalues(args, var kw, locals,qNB?=lambda @: '=pydoc.text.repr(5)) Mhighlight = {}def reader(lnum=[*])<[0]] = 1D try: return linecache.get p(file, [6[0]9finally:( +[vars = scan (0, f20row0[' %s %s' % }%)]if index is not None1i =" -*;!or" is<#0numx@%5d i@!.append(num+*.rstrip()%/iGdone, dump6, [for name, wherek0lueF !if+S: continuej~[S"ifK__UNDEF__hF"if == 'global':yj >%el@/?! +N.split('.')[-1F6{ '%2,x/, M ;els2 ZM + ' undefined'\n'.join(s'@%s\nO'2Gexception = ['%s:str(etype),  /Bir(e- =Pgetat[!,| pR" "*48L@headD)d' The abovea descriof an errora Python program. Her8 the orig traceback: %s ''_r", OP, etbclass Hooka """A hook to replace sys.I`hat shpsHTML.""" __init__(self, display=1.Pgdir=,pext=5,  s xw="html"].\$ =ff# send:sber if traM lou H[# logLsJone self.context =  # number of source code lines per frame 0Pqfile = or sys.stdout # place to send the outputC@ormaf  def __call__(j, etype, evaluAtb):,#.handle((*)W&2, info=NoneL! = @exc_%()r0if C. == "html".write(reset()"@ater = R"==P`) and [plain = Fals:try0doc^@ter(,pexcept:# just in case something goes wrongA|''.join(traceback_oPion(*)=BTrueykdispla ifv*in7`pydoc.N.escape(docv-3ile'

' + GP+ ':6'
A problem occurreda Python script.Y0logdir is not 
suffix = ['.txt', ')2'][A]`0(fd, path) = temp0mks(Z=a, dir=RK
with os.fdopennq'w') as{
1wmsg = '%sAains"deG0ionthis error.' %	^QTriedEave %s, but failed^	_'g''qS0%s
\n?msg!1+ 'TV
|Wflush'r pass

|cHook()
senable(B=1,  ,rext=5,  
"""Install an vrCthat9ssBRHTML.`Tptional argument '' can be set0suppress
"th	browser,'Sa`ectory]3cauNs0be 0tenare."""@excepthook = Hook(display=, logdir=?,
 context=, format=)
"""Simple class to read IFF chunks.

An (used in Cs such as AIFF, TRMFF (RealMedia File
F{)) has the following structure:

+-+
| ID (4 bytes)   |&Gsize(&Gdata1w|
| ..._@
Thepis a 4-which identifiertype ofG!.
?field (a 32-bit value, encoded usSbig-endian order)
giv_K!ofI0who, includDd8header.

Usually a- fi>ponsistsone or more@s.  proposed
usagdCyAdefined here iQinstantiatew`ce at
>PstartvBeachoB andAfrom6until it AchesDend, after ea new 5cGead.  At[Cend
I
p, creatAFwill fail withEOFError
exceptioncpage:
whWQTrue:2try	j\1 = ;(w)%H X1Qbreak#;=..getname(Cxo/ (ns2"pif not )uApassx
# do someth 3interfacS-like;fpmented @Pods a, close, seek, tell, isatty.
Extra4 skip() (called by@1kipuZ0endX55),
+ (return?Z (ID)0__init__"required arguE, a  object
(aAce),Lo=*alL2lagR
spec[pwhetherJP alig{Bon 2boundarie
defaultt1, i.e.6."

Ddef a(self,,8=R, bigrr=False)LB`import95uctXY.Ad = 4
" =vHD  # #toto word (&) O&ifS@strfrU= '>'03els$(<(! ="Af.)(41lenb.chunkname) < G4:
 raise EOFError:try(2self.chunksize = struct.unpack_from(strflag+'L', file.read(4))[0][dexcept@ew
k
 [U NoneBif inclheader<
- 8 # subtract CY>_E = 0`offsetgetell()8(AttributehA, OS	)pseekableFFalsOelse0QTrue
|def getname(i"""Return the " (ID) ofcurrent A."""P3r6O<	o<o"j 7jMclosrif not !d,
.Gskipkfinall1Jd = plisatty/ifBValu("I/O operation on l\"W :, pos, whence=0Seek to specified-ipBinto.YwDefault)s 0 (start,)0IK3 is, this will resVain an 
CyDB1:t
3R("canb'ek#ifhZ == 1APpos =6" +])elA2AjFA!ifaa< 0 or>l+
SbRuntimvK.J.+Z6, 0-#|B
k. , 7=-1
ad at most"b bytesv F"If&is omittedvnegative, p \lH5end^`
[Q self.size_r	ead >= self.chunksize:
 return b''0if (J < 0,O" -`]_readH>!
2f*Sdata Pfile.().`+ len(J48&=fUand \f"  malign (=J& 1)Tdummy1GuL9
def skip"""Skip the rest of.;If you are not inte.Red in0yontents@,@this method should be called so thatH@ poiK'to@ee star[next 2"""jclosedyraise ValueError("I/O operation on 7 "WU{seekabl\:tryhn
0# maybe fix ^Mment&" s^]n + 1Vo.K(n, ?%anYrz	except OS<Epass1\while<\
Dmin(8192,*
	cn!!if
(
v?b1EOF 
"""A generic class to build line-oriented commKbpreters.

Iq construc0Qwith ^WBobeyIollowing/0vens:

1. Endinput is processed asD'EOF'.
2. APs par-!ouAeach by collectZ0preqcompose3of characFPident-xmber.
3uP`foo'dispatchedIa['do_foo()';3do_G asa single argu]%1sisremainder,.
4. Typan emptybrepeat8Dlast).  (Actually, it'`Ia', which#overridden$Qa sub.)
5. There is a pred:efined `help' method.  Given an argument `topic', it
   calls the commandC_&.  With noAs: lists all )sKw*d_ functions, broken into up to three@Q; doc edLcs, miscellaneous W3, and un9ws.
6. T'?' is a synonym for:'. *!*-Pshell7qf a do_i0 exp.
7. If0pleuenabled, ngls will be done automati y,z1comNAng o\:@args_:!byi[/e_foo() Js text, line, begidx, endidx. V0strMwe are matchingIqgainst,Preturx"qes mustVnzQ it. lUtQurren{Rinput (lqTpped)= nn!en+pindexes$0 be%d, which couldm@usedpprovidePdiffe@pion depsng uponFAposimVis in.

u`default@ maywoverridden}interceptrhthere
isy3do_g`ehs
d that haveo]u
data member `self.ruler' set@haracter `draw separatorAs
innmessages. 7`empty,[07Gn##t sA"=".

IfOPvalueQintro1nonX0 whxcmdloopTap`ed,
it prqd out oPerpreqstartup32is u
@
vias op(%al;6c#()csddoc_header',Band
	=s`|0's
1ingCN"

2 respectively.
"""

import +ng, sys

__all__ = ["Cmd"]

PROMPT = '(Cmd) '
IDENTCHARS =?.ascii_letters +Pdigit'_'

class Cmd: """A siN framework
P writ1-oriented1s.
KBThesPoften_1fulL0tesMrnesses, administraP tool prototypeD"at lam`be wra in a more sophis#ted interface.

    A Cmd instance or subclassis a line-oriente1terpreterGframework.  There is no good reason toSRtiatextself; rather,Kit's useful azRsuperof an in} you define yourULrn order|Pheritx's methods and encapsuldaction!.
G1"""prompt = PROMPTidentchars = IDENTCHARSruler = '='plastcmdintro = None"pdoc_lea#= vhRDocumcommands (type help ):Vmisc_=Miscellaneous10s/*unmUo,!noq= "*** NoORon %s|use_rawinpu41Ldef __init__(, completekey='tab', stdin=1out
!):&A"""IN ?`The opaal arg' ''0thed` name /2pkey; itPaultss>Tab key. If5 isF1not42rearQmodulLavailable/N5ionJis done automatically.seuestdoutGspecify altern-0outfile objects; if 82iedhAsys.hpout aredc,g#ifH "<[=,Oelse-	i8no%p1q/r3cmdqueue = []$ =#GscmdloopFL&Repeatedly issue a , accept r, parse`itial prefixBoff AceivAput,dispatch
CXPssing<mMI@mainoZf=!1pre)4Ielf.y0C
:try^eimportdSDold_WF.get(:)s)UQ6_and_bind.7ekey+":1"Gexcept ImportError:
 Epass:try"if intro is not None"ORself.(=0R6if ">stdout.write(str(2y)+"\n")Sastop =	Qwhile"lcmdqueubline =*j.pop(0,?elsFluse_rawinputD
{Gnprompt6except EOF)_Y'EOF'S

7oflush(3pin.read5!if@len(*)#? = %	"G.rstrip('\r\n'$kbprecmd
)/on)@postS= , l
L%GloopFnfinall0C and(ompleteke7timport 
=c.set_cg!6old
;If
~Cdef 67"""Hook method executed just before the commu& icinterpreted, but after3 3q`genera]Irissued.1"""areturn!Welf, adispatchfinished.j!re^NHonce when1cmd=)p{is cally	6s6about top@arsePP"'A&o vAnameg a Kng containingrarguments.  Rs a tuple containing (command, args, line).
 'p' and '$' may be None if the7 couldn'tfparsedI5"""Ud! =4.strip()aif not:areturnu,H$Aelif7[0] == '?'A. = 'help ' +-?1:]C!C
if hasattr(self, 'do_shell')mq!r'Nelse=
i, n = 0, len(kDwhile i < np[i] in .identchars: i = i+1"cmB[:i]M[i:]5*
Mdef onecmd,&"""InterpretCargument as though it had been typedresponsefA!to@rprompt.~DThisoverridden, but shknormally need to be;\3see])P@post) methods for useful execution hooksRThe rvalue is a flag indicatwhether iaL%ofAs by*$erGstop	|
" =J
OQempty=`if cmd&
<{defaultw!lafZEOF' ];(''9:tryyrfunc = get$o6cmd .except AttributeErrorUM&R(arg)
Called whe* +e
t
lIo>vit repeat e A nons {"ifD:cmd3	..-|+oBinpu.dprefixrecogniz prints an e messagetIs.stdout.write('*** Unknown syntax: %s$\n'%line)

    def completedefault(self, *ignored):)-"""Method called to= an input ^q when nmand-specificLub_*() mVis available.w By, it returnsqempty list/5"""f,2 []NSnamesOtext do = 'do_'+

\a[3:] for a in >R.get_a) if a.startswith(T)	Zstate}R the next possible1ion''@If a% has not been entered,Un#
 against4cOtherwise try0all,=P_ geEst oiUions.G1if V == 0xtPimpor ada?@origR = re _buffer()24 = 9{.lstrip%ped = len(-1) -D
Vlbegidx(7R	?end662if Y>)cmd, args, foo =Pparse(
6`if cmd|*''}DfuncR:	0OelseJ?try7Wgsgetattr'q@_' +@except AttributeErroroe	2	B	@ion_matches =?D(,F,", 
?_[V]!_IndexMFNone8ed# This"us@pullbase class s# at a time dir() didn't do6yet)'1.__W/__S_help5*	t"se.X(2nDopic0?a[5	'F[0])ns(1| t(do7argU'ListMe commands with "help" or detailed % w cmd".'
 uif arg:# XXX checky syntax#:try48func = getattr(self, '@_' +K)Eexcept AttributeErrorWlpKdoc=m%dok.__doc__s7nif docl.stdout.write("%s\n"%str(doc)3mreturnvFMpass@
 nok % (arg,)(Jelsenames = cAget_3@cmdsnY = []@undoI= {}2@for d1 inso!ift[:5] ==c(,e[Py[5:]]=1lks.sort # There can be duplicates if routines overridde@prevZF = 'j3r)zcontinue?! =X$@cmd=:[3:A if\s,.append(cmdI1delO[cmdwKelifs)0<Nkleaderprint_topicsW.0h00,  xZ15,80QDUmisc_EPlist(.keys()),JK#, DRMdef $, 7,len, maxcol)_
YYP"ifOrulelQ
9t * len(bocolumnizes/-1+
U\n")
0G} , , displaywidth=80):
    """Display a list of strings as a compact secolumns.

?REach  is only:@widenecessary.2CD* are separated by two spaces (one was not legible enough)J5"""V"if,Eist:self.stdout.write("\n")+freturn4non
	= [i for i in range(len(5)Fuisinstance1@[i],g%)])n
raise TypeError("t1[i]aH6ing&%s% ", ".join(map(str, )usize = := 1n'%s\n'%str'0]bv# Try every row count from 1 upwardsVnrows&1,)ncols = (+8q-1) // Vcolwidth0[1totY = -256colrC^I = 0BFiF-1i ='+M*colQ(pf i >= 
_break@x	Zist[i
:Dmax(x5"s.append3Nq +=k}*+ |T5if ,2> d/B/<=C
?Jelseg8)	ZI = 1V = [0lOtext<MiI+ 1	#xawhile "A andJ[-1]K2del-	i
!J)ws[col] =Q
e.ljusts"
""$" a"""Utilities needed to emulate Python'	teractive interpreter.

#
# Inspired by simila%r code by Jeff Epler and Fredrik Lundh.


import systraceback
fromI3op (CommandCompiler, c
"_c


__all__ = ["Interactivepreter", pConsolei0F",
 "d"]

class U
`:="""Base *8for.t!.
+CThis(deals with parsing7 state (the user'sDnamespace); it doesn't POinput bufferWor prompt
E$file namg` is always passed in explicitly)2"""def __init__(self, locals=None)(h0"""structorGThe optional '=' argument specifies 1dic*Qry inCQwhichF will be executed*efaults to a newly createdDZpkey "__p__" set>B"__cL5keyD`"__doc/6#if)r(+F = {:,p : B}.C	
; = o&()runsource
$, -1="", symbol=" that justurTdoesn't /Rstack5 because t*7oneEIf a$given, it
rstuffedeuinstead%@of w3wasmbefore (Python's parserEusesF"" wCreading from a )The outpuwritten byhe(), below7	=`ype, v, tb = sys.exc_info(5last_type = I" =QAb &if9\
# Work har5 y correctOt@
:msg, (dummy_, lineno, offset)F.argE6 B
#Q# Notformat wpect; leaveFalon*7;paso+ls0'0# S ri)		.u(3
$G$ifepepthook4"__8*__3s7:.73ion_only(<     self.write(''.join(lines))
 Uelse:2# If someone has set sys.excepthook, we let that take precedence
E# over self.writ
V(type, value, tb)
def showtraceback(N)"""Display the 2ionjust occurred.SWe remove5first stack item because it is our own codeDThe outpu%gten by(), below71"""Rlast_b = ei =f_info(6$3 = ;j6try4{5 = 5.format_B(ei[0], ei[1],R.tb_nextN$if%8_P9*__9':Q	""#lfinallzBNoneGej, dataWE a stringU bamplementatOAs topstderr;Aubclass may$`replacis with a different iZ|f2


nInteractiveConsole(cpreter"""Closely emulate behavior ofiW Python LRThis builds on s2 and adds prompting%QusingrfamiliarW1ps12Aps2,
 in bu?,K__init__plocals=, filename=""onstructor	 op2al RP argu will be passed&thW8gishould specif(&)*pstream;sf up insJE.`{% =s!Rreset((
R5).5.XV = []3actcbannerqexitmsg
s	(te the inter
active Python console.

 The optional banner argument specifies theto printCabefore#first interyon; by default it:3s aMDsimilar toH2one+ edA~Drealaupreter,Cffollow1@currclass name in paheses (so as no to$0fusqis withx -- since it's soclose!)dexitmsge messageSped when "`ing. Pempty stringBsuppress@a?aA. IfPi
 given or None^a4 is5"""vEtry:
ousys.ps1except AttributeError3 = ">>> ]2]2]7...]cprt = 'Type "help", "copyright
predits"*"license" for m
pinformaX%.'#if=`elf.write("%s on %s\n(%s)\n" %RW(cversion, 
@plat , 5s|!__-P__.__1E__))k%el0" %(NB5= 0Szwhile 1O
7!ifX
*PprompsOelse;7qline = 8raw_input(5*?EOF!L>\n"F%UbreakBu\Ppush(
[KeyboardINrupt3F
14resetbuffer(}i*
A'now%s...\n';MZ!= '''U/)@Adef S+!, YD"""Push aC7?p should have a trail0new#;G1may Wnewlines.  The line is appended to a buffer and the
 interpreter's runsource() methodIcalled with<	concatenated contents of%p"s R@.  I'is| diAas that6@commwas execu[or invalid,%Gs reset; otherwise(Mis incomplete,Gleft as it QafterrlST.  The returnCAvalu{1 if more inputErequired, 0Ethe VUdealtFhin some way (th'`e same5).
=5"""Rself.-.
(s)! = "\n".join(4(!= x,filename5aif not:rvG(4P4def raw_G, prompt="")X"""Write aaread ah#!edQ doesqincludetrailing new7.AWhen#`user eB	EOF key sequence, EOFErrs raised`base imentation usePbuilt-in func	); a subclass may replac"is@a di&enb
p>jtP)



6act(banner=None, oSlocalqexitmsg"""Closely emulat1teractive Python nTa backwards SatiblDfoIUbConsol81.  pspecifiit attemptsM`importY9!p module"0ena1GNU ifX@vail @Argus (all op@al, pdefaultUe"):x -- pass.:c8U7/s DEBzA__init__;`c/ =(!ifui-I.% =2rFelse/6try
N3except I
81-#, #hPif __R__ == "__main__"Targparse

    parser = argparse.ArgumentPr()
    sr.add_a ('-q', action='store_true',37"help="don't print version and copyright messages"}dargs =s ifs.q or sys.flags.quiet:banner = ''OelseANone interact(9	)
""" codecs -- Python C Registry, APIers.


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

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


import builtinssys

###& statelessA funbs

try&cfrom _f*
except IvError as wh5raise System('Failed to load the}
s: %s' % why)

__all__ = ["rger", "lookup
@open EnPdFile3BOMI_BE"s"BOM_LE!32! &32&64!64/S_UTF8G)16
4XPD'3288	8w@Info8
	PIncre"al
* De#rStreamRead[	x+!$ "]AgeteDgetdf "geti'	r
$
=r}getwritT:
'	ystrict_es8 gnureplace#	?xmlcharref'
backslash&l "name	c]Constant
# Byte Orderk (BOM = ZERO WIDTH NO-BREAK SPACE = U+FEFF)
#4its possible bN*ng values
# for `/UTF1632 outputB	little/big endian machin=0

#<0-8
F = b'\xef\xbb\xbf'$B16, LH4L=116_Aiff\xfe=:B::Fe\xfw/32w1UTFn@\x00v<v9m1u!ifjoB== '1':
3cnativeAness 1 = TF16_LE

    # UTF-32, native endianness
    BOM_UTF32 =_LE

else:
%E/16E?(168_BED>$# Old broken names (don't use in new code)
BOM32_LE#LEBB)640?0864_0!32
### Codec base classefining the API)

-Info(tuple):R2"""Fdetails when lookD!upGc registry"""JaPrivath to allow Python 3.4blacklistJknown non-UniW#6 csDstandard library. A more general mechanism toBreliably distinguish test encodings from otherqwill hopefullyK@be dFfed for5  See http://bugs.p.org/issue19619,_is_text_ = True # Assume@are ) byBaulttdef __new__(cls,+Pe, deO, streamreader=NoneDwritvincremental! ZMXE=*, #diqself = {.(y
%))tP.! =
S# =
# =3
E8r =
5]5
5# =))).if is not =
. =Dapreturn :prepr__(-"<%s.%s objectL?Z%s at %#x>" % \hS1.____.__module__,	@qual=__,I.A, idW)\Q""" DsinterfacestatelessS3rs/"s.QThe .Re()/."() methods may,different errorPhandl@sche`by provi0`s arguu. TheseA0str?Pvalue&Se pre  ')ct' - raise a V4E (or a sub{ 'ignore=
character and continue with the next
 'replace' -  with a suitablement character;DL#   Python will use the official U+FFFD REPLACEMENTDCHARACTER forBbuiltin Unicode _cs on@decoding and '?' on en.2'surrogateescapbprivatn points U+DCnnF0xml3ref?JRUJappropriP6XML<Rf reference (only)backslash9 - "2ed P sequ]sJFnameEJ\\N{...}G
5The set of allowed values can be extendia register_error.
G1"""2defe(self, input, ,s='strict'):7P""" E'!esubobject9Kreturns a tuplGutpuL2   5, length consumed)hc defino` handlto apply. It(aults toC7gQmethod may not store st!inCodec instance. UsefStreamWriterwhich have to keepX\orderBmakee?entper must"tode zeroc	 an emptyZoQtype )isEsituationaraise NotImple0edEUDOC9bncprovidPbf_geIdbuf#buffer slot.\Sngs, sy memoryCmapped files araPs<7Bthispf@s+S0Rea&S*eS The decoder  must be able to handle zero length input and
 return an empty object of the out5type in thisEsituation.
5"""raise NotImplementedError

class IncralEncoder(t!):EM/An+! e3sin multiple steps. Th1canTbe passed piece by	!toV() methodCLQmbers:TstateCG
ing process between calls"Ae().Kdef __init__(self, e3s='strict'5aCreate instance*may use different[schemes by|`provid> keyword arguQ. See)module doc%ngHfor a lisPpossibvalues(o#.r= buR = ""c}!,#, final=Falseds1T H0res~#ngNQresetR!urQ|9Aial 
f_1getb S1cur4	*erb& 0oss,1Set%w
Bhave bee edh @B.ed	(?GThis sub/of0canupaBbase3i
2r ikeep somhAin anA.)"B# und4that is kepA.
___Overwrit#isbes: ItY[#z(,oconsumed) tuple8p
    # encode input (taking the buffer into account)
 data = self.)+D#(result, consumed)1_2_encode(L,Kerrors, finaln# keep un2dja untilnext call~ = c[%:]&rreturn 
0def0et(C!):IncrementalETr.res('6F= ""VgetstateY9For 09s9!, E9=1 or{gclass  Desr(objectE1"""/An+! d3Cs anwin multiple steps. The1canLbe passed piece by	!toV() methodCLwQmbers:1 of
Gprocess between
Cs to1().K__init__", |='strict'5`Create
 instance.0*may use die2ent` handlschemes byK`provid keyword arguQ. Seemodule doc%ngHfor a listFpossible values'ocr=sI,o=FalseJ0R and raise NotImpl0edECR1r5a2ialQ
K
adS@curr)er4is must be a (/1ed_, additional_J_info) tuple
6Pbbytes X@tainjAthat5werL % have not yeuonvertednon-negativCUteger0rep ntA
qWITHOUTGhavi!edcontentsA
Q.  In$	Safter5), ) (b"", 0oD%D1SetM3Nbned by getstate().  The effect of
 Psetst#(b"", 0)) must be equivalent to reset().:"""

class BufferedIncrementalDecoder(!):C?This subJ>of 2@ canused as the base3afor anTi" d1 if0@ablehandle incompleteIbyte sequencesdef __init__(self, errors='strict'.<)w2B# und input that is keptween calls,(A!.b@ = bX_4*,ew, final# Overwrite tPmethobes: It8[Uand return an (output, length consumed) tuplraise NotIY0edEl
[p0i=False, (taking into accountPpdata = -W+D(result,1_[rL,K4nm# keepQuntilAnext~ = c[Q%:]&~@C+(S6jgW$Z# additional yP infoalways 0_ge,O	loignoresg=_
[0]

#
# 4pStreamWi"d rReader provide generic wor] 
#Terfaces whichDto i new encodsubmodules
# very easily. See's/utf_8.py @ exaQr on howiDtdone.
#(Codec):Ys#E""" Creates a"^ instance.`0U5be a file-like obj1pen};ingA
may use di"nt 5ingchemes by vY keyword arguy.sD
parameters are predefinedK$2 - qa Value  (M;iB' - 
charactecontinue with next
        'replace'- 
 with a suitablement character
>@'xml3refFR' - R[Qthe appropriate XMLDL
Vq reference.8'backslash{|"ed escapeC
s@sequpsqFnamel/\\N{...}n K	z(The set of allowed parameter values can be extended viaDregister_error5"""(self.stream = 	
=Bs = 	
def write(A, object):P""" W" s !'s contents enco0to DPdata,;PsumedB([,F)[L)Slines?lis	concatenated ,strings toGrusing .)"''.join(a)QresetlRlXc buffers used for keepinternal state.@Call%this method should ensure thatI0 onoCoutput is nto a cleanr,CsjendingDf new fresh i|qout hav0o rZ wholrrecover|BpassAseekd, offset, whE=0):g.2
,#if? == 0 andWQ<U__getattr__i,:*='pInheritUc other`s from underlyfi4sreturn h , 	etDDc__exit-r, type,G, tb>7s.close()

###

class SReader(Codec< ^P(tr'in, ='4ct'LyCreates axa instaF2UP musta file-likeLQ open0rea A!@ may0 diP hand

chemes by providing the erro
rs keyword argument. These
 parameters are predefined:
( 'strict' - raise a ValueError (or a subclass);`ignore;
 the character and continue with KnextHreplace'- 
.yditableaFbackslashERZP!ed escape sequences; Tht of allowed R  v s can be extended viaregister_eK.5"""self.stream = 	
=Bs = 	
bytebuffer = bXp_empty_%qVtype(
I
6linBNoneLdef decode(X, input,=y%):NNotImple!edQCreadOsize=-1,s
Pfirstw=False)Q""" Ds data fromv preturns#aresulting object.\s indicate?p numberMde points or Ks toi!. ) will never R more`than rYsted,Gbut it might:less, ifre is not enough availvpapproximate maximum
y0or !toB for21ing)erCxmodify this set1as dpriate@Rfault	F(-1 as muchpossible.  	Gi tohvent hav"#to huge file0 $-Kstepn5If Qtrue,SPa Uni?! happens afJ  terminator in@ onlP1rst,	M#beB1ed,<1res%ebe kept until)	Kc call +()method should ubgreedy-strategy, meann*haZ$it?D asV	4PitionPencodm+Qgiven, e.g.  ifD op@5al ; enB"st;$rk~E  on the stream, these should be read too.
 5"""# If we have lines cached, first mergeUm back into charactersIif self.Dubuffer:x8" =/v_empty_a.join(.K)K = None
$!ifZs < 0# For compatibility with other+() methods that take a\# single arguments'iz#]` untilp0getU required number o] (if availablewhile True5canW0estsatisfied fromb ??,>=@Sif leICB) >=v
2Ybreakg#need more datfQ>izeO0new1gupstream.(');els%?7sizj-# decode bytes (thosWvmainingWlast call includedL:3 + 	aif notRN>try'0new#s,dv5(,jerrorsexcept UniD
E(~ as excv"if;R\+[:exc.start]?za.split(keepends=Q
?0O)<=1.]raise0 # 2 undw:rthe nexg	g!V=;[E9s:]2P# put|2s i@7"	9k"k +=F#mre was no	R^
Return everythwe've godresult@	5## Rmst>4![:7
self.charbuffer = self.charbuffer[Ss:]
 return result
def readline(@
, size=None, keepends=True):3M""" Read one < from the input stream and v1ther?decoded data.Z	, if given, is passed as argument tou	Y() methodZ5"""(# If we havs cachedan earlier,?them unconditionally"if: $&[0&,>ize or 72,iv_empty_J&^E$isqwe callP() only oncE`while i
 s(]a, firsW!if
Lwe're at a "\r"`extra acter (which 	`K!beB0n") geQaproper ending.n/isKtemporarily exhausted@YwrongZ
Iif (isinstance(>,).Pwith( ))\H/  H_bytesJbKn'u# +(1=1,hFs=1)0e!+=	s	>)3"Nines1en(T?) >10# MAthan!0B;{is a full	K#( _s@(!L#sremainib0|5-1]0N5:(e0X        else:
  (# only one remaining line, put it back into charbuffer
Mv  self.(! =Lls[0] +Eif not keepends:%~_`.split$s(9=False)[0]B]breakC0withend\(:out+!if t!0\P: # Wally have a4M end# Put th5stogether and\Quntil)next callQv_empty_`.join(Ds[1:]) + \Q
QJ6!ifE%Oelse\FI# we didn't get anythVor this was oury9tryXdata or size is?NonC:qif readn< 8000R!E*= 2areturn
"deL s(,Phint=,r=True):8F""" Read allSs available on inastreamq9qthem as_6st.a(QLine s are implemented usqcodec's de

&amethodAncluded ilist entries|a	, if given,ignored since* efficientway to find@trueH@-of-{y5""">=%()<"P)F1set@sets 7"c ds used forinternal state0Notbat no  repositioshould take place.ATis primarily enato be Yto recovBfromXerrorVR.byteG = bt 
u1ONone

    def seek(self, offset, whence=0):
 """ Set the input stream's current position.
6=aResets9codec buffers used for keeping state.=5""".r.
))rs"()def __next__"):aReturn&0 ded line from.'!= @read(!ifIJwrs+raise StopIteraJFiterEI}-dgetatt0u, name,j9*=
Inherit all other methodsrunderlyh	/en4exi, type, value, tb%s`.close"###

class SReaderWrp)% instancessow wrapus whichvwork in both )` and wig modes8The design is such that one can;factory func1snoQed by*c.lookup()1 to construct)A@# Opj0al bibutes setiBfileQbelowTPencod%= 'unknown''in", ", , errors='strict'@Creaak must be ;-like object2
:
A or ZevQproviMY,  iface respE@ hanqg'disame way as defink1the~p/+?# =LCer =([--}-# =8sL, size=-1rgp*0er.(+pIONoneK7?izeOsP_hint=Ts6Y7tream."""
   return next(self.reader)

def __iter__!)::5-Qwrite*, data):1.(r()(qSlinesIOlistI4.NBreseC.")rCseekoffset, whence=0Cqstream.2
,lsl,#if[ == 0 and G,q__getattq, name,=*=4#""" Inherit all other methods from the underlying i5"""?hS.0#Tse are needed to make "with SfRW~r(...)" work propO__enc__exit, type, value, tbclose()

###

classScoderQ instances translateG^one encod\Qto an.They use5 complete set of APIs wPed by%cs.lookup() functionniH@ment2wir taskuData writte/s first dehAd in~i@mediformat (depenBhe "? " E!c)EthenG
0 us;%aniprovidedKK  InAdire%  i_"adVe"a !ed!to~ccallerT@# Op0al aibutes file wrappers below~_W= 'unknown'6G__in$S#e,,", Z~errors='strict'{@CreaaL<ewhich s a two-way conversion:fe\6pfrontend (theD4 visible"K(P)) whs	JpDbacko#inD)tYou canse objects"do?hparento transcodings from e.g. latin-1 to utf-8 and back.

 stream must be a file-like object0aencodeN!de;`adherenthe Codec interface; Reader6	}eWriter}factory functions or classes providing theFSc ]ks respError handl[is done inf	 same way as defined forq/si5"""/Sself.u"= 	
b"= 	
t"= 	
rf=o(^0, e*s)-w|"= -B# =KC@def s(, size=-1):dpdata =  .*!er(+&r, bytesd4(!F<preturn "wHlineHNone!if@ is :T|Oelse8TsPhint=+`"0`.split4s(keepends=True)__next__R""" RQ& d SSinputI.j0 = ;_{/er>K-,m.dr4{K2Llist = b''.join( 'QQreset#"jAseekN, offset, whence=0)u# Seekspropagated@both0ers qsi#0they might ne=>"irnal buffers.>
writer.seek(!offset, whence)

    def __getattr__(self, name, $*="):G#*""" Inherit all other methods from the underlying stream.i5"""sreturn h.0	Dente,):DEexittype, value, tb>7s
.close()

### Shortcuts

Qopen(file6" mode='r', encoding=None, errors='strict', buffer!$-1IErOpen an@0ed \0 us2AQgivengR and )a wrapped version provi transparent]bing/de.#Note: TheL winly acceptobject formatdefined by%codecs, i.e. Uni :s; most builtinE&cs. Output is also p dependusually beClwas wellUks are always ed in binaryx$rdefaultAmeanoHsin readM1specifies3Pwhich^to be us or%D`u0 ma ; to0ine9 handling. ItsU4to  causes V8E 0raiin case aw occurs2 haTsame Ea'&Uf() API#-1GVau` size B`m%edoi!esPxtra UFibut.Hallows quer(V. ThiRovailable ifzvT was I6d aDparameterw%if^@not f\@'b' imq# Force!of_!
?K" =Q+ 'b'2= s.`<)46tryinfo = lookup(wW
qsrw = SReaderWriter , ?&)erw+UV# Addssimplify intro6tio?6srw==1srwexcept:
        file.close()
 raise

def EncodedFile(file, data_ePing, 
=None, errors='strict'):
[""" Return a wrapped version ofK which provides transparentD}rlation.c0Dat_itten to thena is de according]1Zgiven@ andM!n $ed]xunderlyFhQusing!. The intermediatedU typewill usually be Uni but depends on specified "'csBytes read from/5arepassed backecaller	G	IAnot d0, i`faults_FU1 ma</Qefine" handling. IY4to kcauses ValueEW1be d in case anErXoccur{r*ed{gobjectwo extra attributesg..I-@reflVBparameters` same namev@ canmu5forDPintrohg by PythonDgram1"""3i:
=&info = lookup(xH
&
&sr = StreamRr?.1,g)sYe#er@writ'sW# Addmsimplifyl~+sr0+sr=vJ sr

### Help2for<j2get!r(8ingL1 upx{ Ib#5{J2its per funcY/R~Bs a fbHbe foundDvE^a{	incrementalencoder(encoding):

    """ Lookup up the codec for
given encoding and return>Bits IncrementalE+er class or factory function.y;Raises aError in case~xcannot be found}s doesn't provide an i#er1"""Gdaer = l(#.=!er2$ifK is None:rO$=@

def getj der8EDi&n3if &@_readeEqStreamRcK[
sOwritLWcx(Rator,`ing, es='strict', **kwargs)'y*UE!es`input Jngs from0terw0 usA/anN are passed through toWFpconstru.;
(He4in %L0out=\2er.X(3)B'2if *:Syield,% O"", TrueRN	J*P(@| and kwargs .are passed through to the IncrementalDecoder
    constructor.1"""d%v = geti=
(encoding)(errors, **kwargs)@for input in iterator:x0out#= P.(3B'2if *:SyieldS% Ob"", TrueSO	K
### Helpers charmap-baS7cs

def make_identity_dict(rng):
?""""@ -> /)Return aionary where elAs ofrng sequence arelC@mappmselves.brfA{i:iiGrng}Q_map(0ing
Creates an 0 map from90ingIf a targetp"!ini occurs multipl`times,05$atL is7None (undefined,)@caus{xceptionmuntered byi  C0durBptranslaAOne exampleWre this hns is cp875.p3ichs^}Pacters\\u001aiam = {};0k,vO.items()?qif not *mm[v] = kQOelse#h&U!m
:
 handlers

try?qstrict_ s = lookup"(""Rgnore+i+oreplac,-0xml3refc
)Abackslash@(?Oname:#A")
e! L+EdL# In --disable-unib build!1se j*@ misq_
3
/>#
# Tell moduldBhat cs probably needss
# package
_false = 0
if XeimportsaTests
,___ == '__main__'# Make stdout e Latin-1 into UTF-83ys.:0= EXedFile(s0, 'kn-1', 'utf-8')# Have stdin translate Latin-1 input into UTF-8
    sys.stdin = EncodedFile(, 'utf-8', 'lP')
r"""Utilities to compile possibly inlete Python source d.

This modu5ProvidI wo	erfaces, broadly similarithe builtin
function~4(), which take program text, a filename and a 'mode'
and:

- Return object if o@comm3!isiVvalid:ONone3	+aise SyntaxError, Value or Overflow a
?  e@* (2RQcan b
)duced by
  malformed literals).

Approach:

First, checknsists entirely of blank lines\
1Pents;=so, replace it with 'pass', becausef
-in
parser doesn't always do&right thing forcse.

Cthree times: as is,s0\n,
\n appended.  If its86it'&BilesJL,
we exp>Emore6(either way, wAmpar	
we get whe> \n*'\nxh>#s
M` same,& isTpken.  B5 5different
!NoFuitive; not even guaranteedhold in future
releases; bups matchhiler's behavior from61.4
through 2.2, at Qtaveat:

It is|0e (jlikely) tha{#e \Qstops
Ua
successful outcome before reacra nd;this
casm@railX`symboly`ignoreAsteaE*"an.
For examplebackslash follow two newq!ma^ 
arbitrary garbagp@willfixed oncrS API Mer is
betteres3int*$:
1_Band(,i", 1):
ms a singl[n@mannescribed abov(A$r(RInstanceslass have __call__ methods idacal inPsigna;sH@it contain2 ____ statemdFKJ'remembers's all subsequents
    with theR statement in force.

The module also provides another class:

Compile():

    Instances of this * act like the built-in function coG ,
Dbut with 'memory'8sense described above.
"""

import __future__warnings

_feas = [getattr(1, fname)2for-D.allP_7`s]

____"_command", ",r"]

PyCF_DONT_IMPLY_DEDENT = 0x200# Matches pythonrun.h

def _maybespr, source, file, symbol):# Check + consisting of only blank lind7sC;&C.split("\n"g$=Fv.strip(p!ifA and	[0] != '#'@Pbreak	# Leave it aloneFelse;#ifUf"eval"K = "pass" # ReplacZ0a ''9err = err1T2 = Npcode =  6try."r(;except SyntaxErrorJ0# C7! s' a afterPfirst=Z# to emit/(gWU, Depreca) at most onLG9s .c_(.simplefilter("e"")P	.2Y	30 + ::>G as 7%u?\n"1`e	!ifZPreturZd
Pif no1de1gPrepr(T) == 27QraisegfinallA
./, $)m\
G=""="singleCr"""  a
H(determine wheit is inv0let5+AArgu:1 --cpng; mayitain \n characterS= opb%al from which was read; default"
    symbol2 -- optional grammar start symbol; "single" (default), "exec"
   or "eval"
Return value / exceis raised:'#- )a code object if the command is`plete Qvalidg@ONone7Qincom9/~ SyntaxError, V or OverflowaI1  sC  eD* (6Vcan be produced byDmalformed literals)."""_rFp_maybe_Dile(	, source, filename,)

class Compile:VInstances ocY(behave much likebuilt-in}1ileE@func2A, buys used to,	 text containing a futurE
statement, it "remembers"s all subsequentA[sAwithQ in force.Ddef __init__(self).flags = PyCF_DONT_IMPLY_DEDENTECcallE|_Dob =(&, q, True)pfor fea<_sg&!ifAbob.co_&7.Qr
8<|? |=5fmrb?"""nl"__O methods identical inpBsignXl;difference$1tha"thfisB
"__ __J''<lg,$ =/()="")=hCr""" determine whether6is f.V@ArguswVstring; may \n character?Afrom which was read;]B &	fy5 orGm
+" 	DNone if the command is incomplete
 - Raise SyntaxError, Value or Overflowif the comVaM1  sG  eH* (:Zcan be produced byHmalformed literals).5"""return _maybe_ile(self.
2r, source, filename, symbol)
"""Conversion functions between RGB other color systems.

This modulesvides twoJfor each= ABC:

  rgb_to_abc(r, g, b) --> a, b, c
  abc"Crgb("/

All inputs "utpre tripof floatrange [0.0...1.0]
(withPexcepQ of ITaQ, whi+ a slightly larger QB).
IqoutsidePRvalid! may cause fsc"in&o.

Supported8s:
RGB: Red, Green, Bluponents
YIQ: LuminanCChro
A (usjpposite `o signe
HLS: Hue,C`SaturaC
HSV 1M

# References:
# http://en.wikipedia.org/O/YIQ#
AHLS_xo_space/)SV/
__all__ = ["nyiq","yiqY$",hls","hlsi5   & sv&$sv&]BSomeging point consta
ONE_THIRD = 1.0/3.0SSIXTHu6.0
TWO(2(1
# p (lineaAmbins@RGB)D: perceived grey level (0.0 == black,Pwhite7SI, Q:Th#
# There aQat many %Go-  in0se Rulae.KC oneis library3sIP from?D FCCiNTSC.

defU5yiqU:y = 0.30*r + 0.59*g	A11*b!i!74*(r-y) - 0.27*(b-y) q #48 E'41 (y, i, q)j# r = y +A27*qp41*i) /q74*0.41 2786# b:A74*q/48:g:-`'301| 0.9468822170900693*i6235565819861433*q+fB478764629897834*i63569107918738019- 1.1085450346420322q#1.284064666*qif r < 0.0:
        r = 0.0
    if g < 0.0:0g =Lif b b Xr > 1@0r =@g `%1.b ` %return (r, g, b)


# HLS: Hue, Luminance, Saturation"`: posi in the spectrum
# L: color lightness
# SsI
def rgb_to_hls,maxc = max1min*in# XXX Can optimize (D+1R) and-KPl = (+)6)/27! =c0x0.0, l,0l <5,s]2axcq" /Oelse0
@2.0-B4r4-r)T g g b b Nif rh = bc-gc!el
&2.0+rc-b* 4.0+gc-r (h/6.0) %fhd!s
'0hls'Crgb();@if s	dBlBl>if m2 = l * (1.0+s)*
#c+s-(l*!m1 = 2.0*l - m25r(_v(m1, m2, h+ONE_THIRD), -()-#ue`hue = +!if < CRSIXTHm1 + (m2-m1)*hue*6M`2TWO`((U-hue)lV1b#SVbW, Value^I ("purity")
# Vj%brCj%sv9cjv-?if ,1v)Bs, v7hsv	0v, 9i = int(hp") 
aassume) truncates!1f.1- i`p = v*	3 - q"*f!t3-f))
    i = i%6
    if i == 0:
return v, t, p&1& q,)
&2&p&tL3&O	&4&9, v&5&qv, p, q&4# Cannot get here
"""Module/script to byte-compile all .py files to
c.

When called as a Fwith arguments, this Ss the directories
given@2 recursively;0-l option prevV it from
,xng intoZhithout&ifms on sys.path, ?6try6Rnamesgqlistdir*hexcept OSError4p"Can't P"-{![]nb.sort(@for 1 insl0ame0'__pycache__'"acontinue_AfullRWUP.join,cy+bo0.is@,dyield neelif (A > 0!0cur$paLg V	Tlink()7rom-=K- 1,	=)#TfS=None, ddirforce=Falsel#rx&^=0, legacy0mize=-1, workers=qinvalidS_modeW*, strip
gprepenlimit_sl_destG@hard|b_dupes~G"""B all modules# in the given directory tree.

    Arguments (only% is required):'@dir:/!  QKo byte-compileTmaxlevels: maximum recursion  (default `sys.get!limit()`)Kdyx	hat will be prepended toCpathGfile as itd into each0de +.@Rforceif True,  Aation, egif timestamps are up-to-datRquietMfull outputh False or 0, errors qwith 1,)no>2 alegacyaproduce P pyc $s instead of PEP 3147Kpoptimiz0int@list-s -11 ofEinterpreter. Multipl1` leadsma,edKsNone pworkers`numberparallel &iqinvalid_mode: how\@nessBRScheckRstrip1par;yQleft-  from sourcvB9DbeginningoriginalCs, appliaafter }1dirjy_sl_dest: ignore symlinks 1heyQpointuoutsidehqdefinedg@hardR_dupes:  duplicat-!ycs21"""
ProcessPoolExecutor = NonW0if .1notd and (	$or68dir!):mraise ValueE(("Destin+(sP) cantbe used C0"in5bF	"");=$=8F < 0Y
''@mustw@greaGor equal%0'/F!= 1W6try
0# Oyimport when needed,clow replatforms mayE1faiH)it aconcurrent.futures .[?except I
1= 14 ifsY2? = F= _walk_dir(dir, <=,g=V)
    success 0= True
    if workers != 1 and ProcessPoolExecutor is not None:9=6# I?== 0, let@Rchooss:t=~!or]\OwithJS(max_?=c) as e:Ciresults = .map(partial(compile_file,9=Pddir=, force=Crx=rx, quiet=?rlegacy=:optimize=	>invalidation_mode=PPstripN	>`prepen=Blimit_sl_dest=Hhardlink_dupes=)K)s)0sucs = min(, default=17els@for N1 ins!if(/ , J%,  S  =	&, 	

J#3Falsreturn j

def orullnames=Yx=F~/=0v1|?=-1,
^4*, ot	 _% 6)-"""Byte-A one!.
[Arguments (only furequired):,R:  thFW to b_T:agiven,2directory ~d) to"?:[dm._!ifMP`, even	timestamps are up-to-datM output F0 or[qerrors #)no>2%:    if True, produce legacy pyc paths instead of PEP 3147
    optimize:  int or list-ation levels@-1 f&1 ofEI0theIerpreter. MultiplCleads to mcompiledKfiles each with one.7qinvalid_mode: how up-to-dateness will be checkstripdir:  par	GQleft-  from source QqprependB9DbeginningoriginalCs, appliSaafter }1dirjlimit_sl_dest: ignore symlinks ify are pointuoutsideeqdefined[@hardS_dupes:  duplicat.!ycsA"""
	0if 
 is not NTand (	3or *8dir!):N
raise ValueError(("Destin 9(sP) cantbe used "CG
"in combFn	2"))@succOa= True]if quiet < 2  is|ance(fullname, os.PathLike   =! fs;5)_?P.base&'d=mQ/1os.WAjoinB , ^%if|G_5Ds = t.split(_2sepc55	1`s0, ou in zip~1,E="==F.remove(vf*8+/ift!isDUOelseE4 e,ID = []# Use set()!A\s&Rorted)acreate@ a duministic orderAvB = sFs%ifElen(*0
#"H/ofd bytecode makes senseAonlynmHthanation level"
)

    if rx is not None:	mo = rx.search(fullname)!Vif mo04return successclimit_sl_destn and os.path.islinki[if Path(H).resolve()"in% .parentsRopt_cfiles = {}@for >level in
GimizRuif legacy>|[ID] = e + 'c'3;els` if}_A^ >= 0l'Wopt =*7 1 _* 's: = (importlib.util.cache_from_source(;	,1ation=opt)k2}s'
l0? = !head, tail = Hb[:-3],E-3:]*#if'z= '.py'!ifOforc/trX=Pmtiment(os.statA.st_!Pexpec+struct.pack('<4sll',?MAGIC_NUMBER,
?0, \X.values()#iwith open(@, 'rb') as chandlD?Pactua..read(12):3if 02!= ?1_break)8kexcept OSErrorIpassz]^quiet3print('Compiling {!r}...'.formQ
Qindexin enumerate(opte	ok = py_c#e.!, H0, do, True$  e@qinvalidm_mode=
[1if MA > 0T@hardNT_dupe             previous_cfile = opts[optimize[index - 1]]
70if Bcmp.cmp(O*, _, shallow=False):N`os.unlinkM)-
+q
;except py_compile.PyC
Error as errsuccess = 
if quiet >= 2?sreturn J
B$elD?print('*** ing {!r}...'.format(fullname)Oelse`', end=''@# escape non-able characters in msgPmsg =\.msg.encode(sys.stdoutMing,:
es='backslashreplacezv/devJ(msgAq(SyntaxP, UniY!OS	)LlJae.__class__.__p__ + ':{if ok == 0k6oR
def Ne_path(skip_curdir=1, maxlevels=0, force,/=0dlegacy(O?=-1,invalidation_mode=Non#"""Byte- all module on B!.
8Arguments ((wbonal):: if true,  current directory (default True	0:   recursion !401-:
5fordVdir(),R0D0
\b-
]3
"-1
9!r_z1"""p70diraif (nox0 or2os.Q) and:3/ -C tracebacks(ain run' ';in cases wherebsource9/isunavailableUs`YSTRIPaQstripeW}part of huQleft-eR from,o source file - f
or example buildroot. '
 
'`-d` and `-s` options cannot beAspecified together.'))w4parser.add_argument('-p', metavar='PREPENDDIR',  dest='prependdir',Hdefault=None,&
help=('path to add as prefix$to source file - fm/H?mak+it absolute when some part is removedr(bypSxREGEXP',rAskip{s matching the regulapression;>90expusearched!inW_full qof each considerNpcompilaQi-EFILE+_flist"llAilesdirectories H_ed in (7nif "-", namrad from stdin
C e_%|4nargs='*&zero or mor&y
; if no ps givensm!toequivalent of -l sys.
-j', '--workers6y/=1type=int, =S'Run 0allcurrently'qinvalid_modes = [	..lower().replace('_> nB3py_W.PycInQMode]J--Pchoices=sorted(;)5+('set .pyc = x#; s;D"checked-hash"GnSOURCE_DATE_EPOCH@'environment
 variable is set, and '
 
'"timestamp" otherwise.'))98parser.add_argument('-o', action='append', type=int, dest='opt_levels',Lhelp=('OptimizaS 5 to run compil_with.pDefault-1 which uses of? ofOPython interpreter itself (specified by -O)7e', metavar='DIR'+limit_sl_:.
'Ignore symlinks pointing outsite of the b	P-hardCg-dupesstore_true$='D_D#'Hs	 duplicated pyc files')
?sargs = |~"s(e-(/.F1if 1rx:Vimport re#T = reE(I	f == ""Z3"[ None`ecursiPQs not#F3max=0Oelse->
tD!e= [-1]@2len
#)1\=
Zr.error(("fbytecode makeQnse "
"only for mthan one;.")@ddirw(i\strip("or0preA)p"-d cans be1d i6bin -s or -p"# if flisprovidedn load itw+6try
A9 (sys.stdin^8`=='-' \4 opz)) as fLP@line#"s.&(4.d(a+except OSE-
nquiet < 2?qprint("=P readdQ A{}".format@?return FalsqinvalidG_mod1ivl 
+	.replace('-', '_').uppery
4#y_=W.PycITMode[w]
    else:
        invalidation_mode = None

success = TrueAtry:	 if compile_dests@for ? in'	+if os.path.isfile(9)P)eif notS/, args.ddirSforce5rx,F	HSquiet=olegacyA
W=Mstripdir=@`prepenBDoptimizeBopt_levelsBlimit_sl*G	Jhardlink_dupesK
9BFalsOelsew1dirS, max
lGHs worker
`
(AC.		
J
$sreturn 1)o(3!, 22f)	except KeyboardInterrupt'if1F < 2print("\n[i<Bed]"^!

if __name__ == '__main__'g ex@tatu(k#"()d@sys.&(!_s+)
"""Configur~  parser.

A cconsists of secs, lead by a "[]" header,
and followed by "name: vallue" entries, with continuations and such in
the style of RFC 822.

Intrinsic defaults can be specified by passing them into

ConfigParser{structor as a dicary.

class:
3-- responsible for paria list of
 cy!ur@ filbmanagiLed database.
L`methodY__init__(a=None,s_type=__, allow_no_value=False,YOdelimiters=('=', ':'), comment_prefixe#;;')A}inline_1strict=Truy`empty_<Bs_ins) !se='DEFAULT'|aterpol[=Anver%):`Createtr. When `us' is given, it
vialized P>!  }ionary orr. The keys must1gs,s$approprilP%()s N nge*1ict@will~used to c	.qobjects %s, op:sDin a#,PHf 	!as; seuB subFthat divid{Ofromtz z6EQs in  2. C^sHindentedeBHnon-`l0ct`er won'tw 4any+duplicates while read a ]le source (;,&orGQ). De
JwH \ : w), eachvBmark0endAan o. Otherwise,7nalCs*pa multi?0 ar pt1par;3

#),_5outXswaccepted;Q presPthese^4Non_&' is given, the name of special section is
 ',d accordingly. By default it is called ``"DEFAULT"`` but thnNbe customized to point	any other valid. Its currentL
value can be retrieved using``parser_instance._%``Mattribute and mayUmodified at runtime.
3When `interpola9``given,`shouldJHan I) subclash It will7 us}shandler for opn*%uepre-procesw
getters. RawConfigP objects don't doL@sort!	, whereas Iuses an 5 ofLYBasic
. The library also providE ``zc.buildbotinspired ExtendedT implement
`conver1 di each keyrepresent$ua type eF=Ais a'6abl@sfrom stro1des@dataof. Ever>ter gets i4orrespon*() method onV$&CxiesS5s())Return allRcc!ur	s, sans 'R4has(^
\1wheaXTexistKJ,-R9 Q" i	m)sc
[1lis:
	6<Zread(fileps, encoX=Noneh ad u@iter]=d4figU2s, b5,P.  A 50le (allowed.  Non-(are ignor)0suc`fully e_N1(f,~!onkalQ.vbs} f.;is only {in errorBmessages (if f has no `>%' D,p`'PT)_#(
=a0I(oionaryKguration from a dictionary. Keys are se names,
 Rvalue"7ies with k=3nd &that should be presentLUin thjA. IfGusedC typ<rves order,sN0and?"ir@willuadded in86. VautomaticallyHconverted to strings.
Cget(@, op5, raw=False, vars=None, fallback=_UNSET)@DReturn a[+@ fornd[.  All % interpolaq|NSexpanLr^@, baLohdefaults pas@intouMconstructor N DEFAULTo0ddial substitus may beNPproviPusingi  `!' argument, which mustFwhosMcontents override anyQ`-existaH``' is a5 in,*T from0is -insPLike @s), but fQto an6gerzOfloa|R jy|booleanA l (currently cainsensitively defined as 0fxqno, offFv1, trueqyes, on(True).  !s 8@ or 
Titems$If,|sgiven, a list of tupl6(c=@lue)Ceach
. Otherwi^	L_nHa_proxyv n, includYCSECTsremove_,ZR `E fil[Pall iE`XWj_1%usY7SetV?write(fp, space_around_delimiters=8KW0Mconfigur` state@.ini0mat``d  (6), Dpbetweenso: surrounded by s'paces.
"""

from collections.abc import MutableMapping+'ChainMap as _

Dfunctools%io
9tero%$re%%sy
warnings

__all__ = ["NoSError", "DuplicateOp
1&
 ;"No5InterpolaK	SDepthf	M	&Missing_	oSyntaxJ0Par=# "McHeader	`Config>eLSafe:Raw	B	^\Basic "Extended	LkLegacy"# "PProxybConvertery)",FDEFAULTSECT.MAX_INTERPOLATION_DEPTH"]

_default_dict = 
?C = "?"

I = 10



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


~(
S"""Raised when no s matches a requested oY
?_%'Nj: %r' % (;1,))<$ =
fargs =?% )e	ac is repeain an input source.tPossible+ ti~s that rUV thisD are: multiple creu: the API or in strrparsers	found moreuan onceN R#leQfile,R ng_fqionary.2	,=None, lineno
0msg), " already exists"]u#ifWr@not ^HQ["Whioaading  ","r()[<#if_'c.append(" [ {0:2d}]".format('no<:D")eK(msg sg = message
 celse:


msg.insert(0, "Section ")&Error.__init__(self, "".join(msg)+#.sC#= 
Jource = s	
lineno = 	
args = (W,B,-)


class DuplicateOp()"""Raised by strict parsers when an o< is repeated iSinput|!.
Current implementax  rds this exceROonlyfQfoundNpmore th1ncev single file,ng or diAary.;2"""Kdef 7?T=NoneD
%msg = [repr(7@), "N0 ", r!),<" already exists"]"#ifGf@not =p messag/["While Ling from~L)[@#if_'c.append(" [} {0:2d}]".format('no<:7@(0extd6 hH# ==h"NoA requesIP was QU.	1,l
#No7 %ru: %r" %!=g4hQDcInterpolBRBase < fo1A-relsQ , V#;\:0Misbe6D"""Asubstituequired a settUwhichavailableA`rawvalhsference`("Bad value ion: option {!r} in section contains "
 "an interpola12key5which is not a valid op%_name.N0Raw)1ue:D".format(7,, reference, rawval))IError.__init__(self,O6msg@$.a& =mc#args = )


class aSyntax(!):o"""Raised when the source text "inbsU!.
=Current implementrQs this exce`AintoKsubstitus are made doe0con1 torequired >?"""QDepthnested too deeply.pyOdef 

N|50msgp"RecursQlimit8@eded-hvalue :dbP|}0can]b|{} steps. R"d	MAX_INTERPOLATION_DEPTH,CJ/  Dh]rParsingBDa6Rfigur7filfollow legalC	p=None, K~ # Exactly one of `74'/`3`' arguPs hasCbe given.s'# 0kept for compatibility-%ifC and8  V22("CUspecify bothuITE"Use&."dAelif
RY4fV6pl
]q% =,m<"'S~ypv  ejs: %r' %l2k	i@Z = []52, )@property.}"""Deprecated, u""
        warnings.warn(
 2"The 'filename' attribute will be removed in future versions.  "
L
 "Use 'source' instead.",rDeprecationWarning, stacklevel=2-)
return self.^
@q.setterDdef (3, value):4"""ed, user `YF'.""092" =:%cappend#lineno, *Aserrors.0(#++message += '\n\t[- %2d]: %s' % ?


class MissingSecpHeaderEx@(Par
"""Raised when a key- pair is found before any sZ! h[
__init__>@.6HX
'File contains no@s.\nsB: %rs: %d\n%r' %\(''% =E.Ano =.no
args = `


# U`in parSgs to indicate the default behaviourspecific
# op3not itKr an exce&. Createdenable `NonPs
# aid fallbackue.
_UNSET = object()Interpol4hummy i that passesthrough withzchangesvC_getx7,,,8snvZsZP4rea/Q_writeR?YBasic(@9""" as implemen@!inic Config2er._/uTs can format str6 which referRother}As in`Gsame#$al*pFor exa:something: %(dir)s/whatever

    would resolve the "%(dir)s" to
value of dir.  All referenceD%expansions are done late, on demand. If a user needs]puse a b4A% inL4a configuration file, she can escape it by writing %%. Other % usag isJtsidered{error and raises `InterpolnpSyntaxE%R'."""#_KEYCRE = re.compile(r"%\(([^)]+)\)s"),def before_get(self, parser, secB, opZ, defaults):eL = []H5._ite_some(YP3L, Sk\E, 1)Oreturn ''.join(LsAtmp_~" =.replace('%%', '') #d percent signsD|.sub('', !Lqvalid sCif '%' in,W[  VB("inJ`zXIu%r at "cF
P"posi %d" % (.find('%')),B
I`accum,t^Omap,Wdepthrawval =.raw=True, fallback=rest1if Y > MAX_INTERPOLATION_DEPTH	~DoQwhile
Wp"stm6"%"3if p < 05K.append(r6	ZP>PJ[:p]T#st6[p:# p is no longer>dc;:1:2<if c == "%"
${\2%el](]@m = .7o.matchS@if mNNone (()	@Z"bad avariabG0 %r6var%xxform(m.group(1wKI m.\)O*?tryv = map[var6except Key5B InterpolationMissingOptionError(
 o%P, sec.	, rawval, var) from None@if "%" in v:lself._interpolate_some(parser, xaccum, v,EImap, depth + 1)DOelsex.append(v:6uraise IionSyntaxb
"'%%' must be followed by or '(', "=found: %r" % (rest,))


class Extended()!"""Advancediant of ion, supports the s1 us`zc.buildout'. EnablesF betweentas."""
?_KEYCRE = re.compile(r"\$\{([^}]+)\}"),def before_get(p$, _qhPvalue,cfaultsaL = []HL"Sk"de\,return ''.join(LsAtmp_1 = .replace('$$', '') # escaped dollar signsCK{.sub('', !KSvalidC`if '$',KG2Vz$2"inJ	VXI_%r atRP"posi1 %d.find('$')),A
H/!, _ , 	[# =.xj`raw=Trfallback=v#if
> MAX_INTERPOLATION_DEPTH	D2woQwhile
Wp"stm6"$"3if p < 05Kz
r5	ZP>PJ[:p]T#st6[p:# p is no longer	c;:1:2<if c == "$"
${\2%el]{]@m = ._KEYCRE.match({rest)
 if m is None:-raise InterpolationSyntaxError(opQ, sec	DHh"bad iG variable reference %r" % path = m.group(1).split(':'C! =J[m.end():]$ =
bopt = 
?try2pif len(o) == 1'arparser.hQxform=>[0]6v
nap[opt!,el2/[0PT1@get(p,Y, raw=True?els
4n1
"More than one ':' found:(o.,)except (Key0R, NoS+OC)wMissing<(tval, ":".joia) from
Kif "$" in vfself._re_some(accum, vu,ejCdictMc.itemsC>)Oepth + 1r@.appNv:<%
"'$' must be followed by or '{', ";

class Legacy("""Deprecate!us	 old versions of ConfigPUse Basicc or Extendedinstead."""
Aq_KEYCRE
.compile(r"%\(([^)]*)\)s|.").def before_Dlf, 1ion`value,srawval = dR
= MAX_INTERPOLATION_DEPTH(awhile .:8# Loop through this until it's doneL<JY -= 1if value and "%(" in value:
 !replace = functools.partial(self._interpolation_0,IX	rparser=);2 = pKEYCRE.sub(m9>tryzRm% varswexcept KeyError as !Oxraise I	MissingOp@(a;o%P, sec., rawval, e.args[0]) from NoneF?elsUbreak("if and "%(" RDepthtSreturG
}def before_set.", Y)P@staticmethodbd(matchoWAs = .group(1qif s isf87/"%%(%s)s" %.xform(s)


class RawConfigP	(MutableMapping8"""% that does no	 B."""
# Regular expressions for4ingx headers)_SECT_TMPL = rY \[
1# [%B(?P[^]]+)
# very permB5ve!>*\]+5# ]/?_OPO>.*?/  	 s*Avi>{delim})\s*
# any number of space/tab# followed byRZof th	
y
3# aC_iters,qF]>.*)$0# e thwup to eolB	/NVsf,:	 :Hally@F
             # space/tab
*(?P.*))?$# everything up to eolB1"""
# Interpolation algorithm1be used if thr does not specify anotherN	_DEFAULT_INTERPOLATION =e!()-# Compiled regular expressfor matc0secs8SECTCRE = re.cC (_`_TMPL,VERBOSEi!oph with typical separator/OP1OPT~.format(delim="=|:")71al !# lpited us
;_NV:/NVC@leadQwhite in a lineNONSPACETr"\S"Possible booleanLconfigur.XBOOLEAN_STATES = {'1': True, 'yes
Ftrue$onHR'0': FalsI'no
f4off!}
Ndef __init__(self, defaults=None, dict_type=__,?allow_no_=*Rlimiters=('=', ':')Acomment_prefixe.#.p;'), in_$rstrict=_`empty_@Bs_ins:=Bi=_UNSET, conver"):p*g.E& =_~Bs = uE&D = CqMappingXoproxie}%[1R] = SQProxyaW_r3ruRtuple7-%if]*&= Q:Bdoptcre(p:if R elsej&M
[d = "|".join(re.escape(d) #d
x
Z#RdSR9re.        else;:
 self._optcre = re.compile(
OPT_TMPL.format(delim=d),JYre.VERBOSE)6^
comment_prefixes = tuple(\or ()?}inline_-F Mstrict = 	allow_no_valu*
.`empty_Bs_in4
<default_section=
-_interpola,9 = ,2if p	 is _UNSET+=ADEFAULT_INTERPOLATIONhONonefI(if converters?not,`.updatQ>	U^sTread_!(	!)
Ddef +)Ccreturn2%7s7B"""R:a list o names, excluding [A]"""p#tb will never have6e in it9v.`s.keysz,4add,#, o"""Create a new"v0theQfigur.Raise DuplicateSError if aH0by Hspecified G aly exists. WVLQHG.=P8=yri('Invalidwt: %r' %Q@pi@]j*(2#s[	]Gdictl/iproxie.[Proxy4has$,a"""Ind whether,is present8
CThe V$acknowledgedks opf
4Bs fo@give[.w6try,0opt>
W.copyexcept Key:
          	  raise NoSectionError(s
) from None
 opts.update(self._defaults)$return list(0keys())
"def read?, filenames, encoding=r!):.w"""Read and parse a7 or an iterable of"s.qCFiles that cannot be opened are stly ignored; this isPdesig/"soH0youL specifypotentialBconfiguraiA locs (e.g. current directory, user'Hhomesystemwid!),+all existings in theD@will .  A singl may also-WgivenrRsuccessfully%s.5"""if isinstance(os, (str, byt/os.PathLike).3E = [
]a0_ok1for8\:tryAwithP~) as fp>BM6(fpV%except OSIvcontinu5N(, @K  =)efspath
_ok.append%(_i, source9a() butPargum01mus-like objectThe `f' 6=", ing one line at a time Opal seconAic2e `'PaY of0 be#P. If OP, it UBaken f.F'ehas noN`' attribute, `'FFusedp'}
1"= rAC'D>s_string9
+2='<'>'F!a o 6.sa= io.Sr IO6ing3Cdict@iona0='<.CBKeys s, values are dictionaries with keys and values
 that should be present in the section. Ifqused diary typeK<rves order,>xRtheir@willmPaddedk0%.
J1All[Qs hel"xare converted to strings duIreading, inclu names, op )O  al8ond argum"s`source' specifying_! o6 be).5"""0elef"s_$u= set()0for,T'in.items():1  =.(T#:try4self.add_3;except (DuplicateS<Error, Vwb1if e_!ctm

CFrais
6LBkey,pCX0keyC=xform(str(key)Q1$if[s not None]1tr(M
+)
m2 	P", 
ea	:z)@def 0fp(., fp, fileR=<A"""Deprepad, use<_0 instead.X@warn).	("This method Rremovfuture versions.  "Use 'parser.6()',qBionW, stacklevel=2-{\="F3getCn, *, raw=False!rsZ, fallback=_UNSETk Ge3 >ta given>If `vars' is provided, it mustD The_is looked up
$inP5(ifQC), `!',=(DEFAULTSECT ji0fouDnd ` isk6d aHa;0. `P' canX as a\G
3interpola:qenabled
&alA`rawFalse,
       * all interpolations are expanded in the return values.

 Arguments `raw', `vars', and `fallback'Tkeyword onlyCpThe sec| DEFAULT is special.k5"""Etry:
d = self._unify_(X , )2except NoSxZErrorQ4if j_UNSET#xUraiseXOelse(@S2!opbxform(
R = d[+]U?Key,A NoOH,if raw orTd;Non:v:a'	.before_get(", 5Elue,^"d)Odef aFconvg**kwargs)(.
9o_8@, *,d`=False0rs=d=/, 
Y.csraw=rawv}(,\M&# getint,Qfloatgetboolean provi4directly for wards compat4O	;'==;5- p%
/8, self._convert_to_boolean,
 
raw=raw, vars=, fallback=	, **kwargs)

Odef items(self, section=_UNSET, VSFalseXaNone):;?	"""Return a list of (nam/lue) tuples for each op`  i2m.PAll % interpola+s are expanded9Rthe rvvalues, based on thedefaults pas@into! constructor, unlessal argumentK`raw' is true.  Addial substitus may be proviPusing]K'c, which must:Aa diary whosetents overridesMany pre-existjT4The DEFAULTspecial.L5"""%if32is 
super().D)A@d = R%._Vcopy(":tryRd.update#._#s[	];except KeyErrorG!S
0aise NoSV(xworig_keys =0(d.&()#1# UP withq entry m0ficGiabl ifs/0keyu0lue6f
,!d[mxform(key)] = #p_getterSambda:	p.before3
$,BB, d[F], d ifI
Hq"[(a3ter!))i"6]d0popemove aAfromparser andzGit a /_c_proxyu. If no^ is@senth&isSnevered because it cannoS redj-C's(bU[key]1del=8ru]7strX-pstr.lowHBhas_PM"""Check>_P@encesa given*-Z!If/Ced `#==  oG empty string,
        ass6umed. If the specified `section' does not exist, returns False."""
  !if(:D or == self.default_":
9 opq +bxform(). 2 ina_bs,Eelif+sXE*se'x[	]r/or!)
2 de t(e,,6, value=None)"""Set an'.5/_interpola.before_seFqa,eEdict-:try
IOionsexcept KeyErrorPraise NoSt&(Tp) from B[.	*2] =Swrite!fp, space_around_delimiters=Tru&W:(P.ini-at represent" o@configurbstate.7OIf `wP' is {  (6), between keys ands are surRed by%s.:
d = " {} ".D.36[0],elBA
3 lfR;7(P,UoRcs.items(kf0N@A	B	_i<", oU_name_E
t single7< to9fp'1fp.("[{}]\n)O3key)
qe}9f-             svalue)
1if  is not None orself._allow_no_(:>C = delimiter + str().replace('\n', '\n\t'OelseW)""rfp.write("{}{}\n".format(key,)_.Q\n")
Jdef remove_option(P, sec", )A"""R13 an'."#if/A>L@ == ].default_[ASdict -_.s"":tryE'
ISions[	]R/except KeyErrorPraise NoS&(Ka) from/U9x(existed =O1 inO3if (
5del-[Zdreturn9

Q filei9ion-`3(oproxie__getitem__7keyif key !wvC anddlf.hasjFJ)I!_Fkey]>__s# To conR with the mapping protocol, over$sEs in#>.[$IsB# XXX this0Tatomic ix0ad_ fails at any point. Then again,Nno update method,igparserfbnxmplementa
us.clear(l*.s=G
L$#reb({key:} __bV@"Can*;__contains]section or self.has_section(key)

    def __len__(self):return len.>s) + 1 # the@Sault ZUNiterV-# XXX does it break when underlying container state changed?btools.chain(0def@,), x.keys()Aread>@, fpGname"""Parse a ed`figuraTb file.>DEach,_ in a/	s a header, indicated by a Gsquare brackets (`[]'), plus key/value opsO`Nq' and `0' delimited withpecific substr(`=' or `:'p)Vs can span multiple lines, as longPthey PindenedeeperAthankQfirstB1 of. Dependo*pr's mode, blankP may be trelas partsZ& `swignored;ConsU	include comments, prefix# sVcharacter#;`[C). CLarappear eir ownNhn otherwise empty3r>0be f0redNQs hol>P~%s.5"""1ele_added = set()0curEp = None#,jAa di&arCG^?opteno = 0*^i_leveleTan excea_1forg1no,]enumerate(Swstart=1T^&_=ys.maxsize\( # @p in]	$_os = {p: -1 ;({0}MEwhil6= s?LD=Inext
g#$ ex=Y{.items(>>1x =zb.find(P&+1/ ifnex == -1(:inu	[x2] =Z	S2w0(1> 0T[-1].isspace()VFmin(comment_start, index)
 inline_prefixes = next	0# strip full 7 comments'Bfor P in self._)X:2!ifS.c().startswith(M)48Z0M = 0Z&Ybreak$if_;= sys.maxsizemiINoneRqvalue =)[:/]	1qif not 8p#if<`empty_pQs_in_/s0a# add 1r to thec, but only ifre was noH# 0 on.Q*Iif (@ is O and2`pcursect,0optnameT[,]]@7.append('') # new}\ed at join?els6_#marks end of
J4nt_level 
/zcontinuQation?:first_nonspacNONSPACECRE.search(
8Kcur_
N ()h
 &?
 
>6s
S
@# a =header or
P'	#-it}
l* mo]@SECTomatch(/^if moZ= mo.group(''.cG?ion7 ctd}ain eleNo_addedHraise DuplicateSec`Error(TA, fp
gB/no@Q_z[	{]{
E.addp(elw"==tdefaultz5            
  cursect = self._defaults
 _else:-
K_ict()/p}Pions[	tname] =;jproxie:SectionProxy(b$, Yelements_added.add(5A# SoX
 can't start with a continua_ line0opt_ = No#5# nf header in the file?TDelif<1 isVraise Missing4HbError(fp,"no@u# an op1%mosoptcre.match(valuek`_if moNP, vi,val = mo.group('a', 'vij'kP`if notJx,ehandle_eG?e, JDNcxform(.rstrip()
 ._+mct and,n8)i
)RDuplicateOML^,

M
@# This checkIfine because`OPTCRE?not!#  if it would seS!to? if}*!is&0opt0=9.pd[aOval]	V!# @lessAion ?ingV84# a non-fatal par  occurred. upca# exce but keep going.8owill bJ'Bd at:Qnd of D@_ain a@list>atAogus}._handle_error(e, fpname, lineno3)
 self._join_multi&_values(&%# if any parsing errors occurred, raise an exceptioncUif e:x-!e
Odef );defaults = .@_secq,_s^o4all$<itertools.chain((15,),48U.items()1Efor oXs in i20val+6\
.2if isinstance(val'st1&Vp= '\n'.0).rstrip.}[]p_interpolao.before_read(=e
2
Ag, val)d 5"""Read thep passedinitializer.PNote:tues can be non-ceng."""+1key ueV^.[xform(key)qhandle_?exca`if notZrexc = PE(]exc.append(JpArepr
Qretur,Tunify|JvarsCreate a sequence of lookups with '5P' takpriority over'wp' which19es 0
DEFAULTSECT.Idict = {}g*ryK
*.N[]?TA Keyv
K$ifj/ !
02NoS:V(w) from NoneP# UpdoY5entry specific variableu>var if*s
El8s
R& tr&ueT
+ _C:CMap(@
Vconvert_to_boolean
R&#a *]` trans"ng	other types if necessary3.
 5"""if value.lower() not in self.BOOLEAN_STATES:5Hpraise V<Error('Not a boolean: %s' %]):_retur^[!]
3def _validate	ue_types(, *, section="", opNF="")@"""Rs a Type for non-string"s.The only legal+ if we allow=Aless>s is None, so/need to checkC2the>*a?&if-@!dovUs, orC0)Y but {For compatibility reasons this method;@used>classic set(kRawConfigParsers. It>Rinvok=every case@mappprotocolaccess ansV.xisinstance(BW, str/-#(", names must be9Vings"!iff
e+O keyc	!._2_no$2 orN7&/
5@propertyconverterc_'1


A (:G8"""& implement3interpola._DEFAULT_INTERPOLATION = BasicI5"()
Untq,m=9@"""Set an.  Extends 0 byGN	 syntax on*.
P
:=0sup
	2Cadd_
Create a new,c"ur(0s8!if& ia-H="*_read_default$, 
@ReadTe C pasP$initializer,sicitly 85ing/s to strings like the rest ofsAPI.

 ,Does not perform interpolation for backwards compatibility.D5"""Etry:
dZhold_Uz= self.	5 H = I.()2read_dict({Bdefault_sec#: &s}=kfinall>
> = 


class SafeConfigParser(
)8"""o aliasb	 purposes.bdef __init__(, *args, **#gsm{super().1+S*warnings.	(M"The has been renamed to Kin Python 3.2. This`will b
moved in future versions.LJ Usemdirectly instead.",aDeprecW, stacklevel=2-)9Proxy(MutableMappingh`"""A p  ,a single s from a p
# , J]5""Creates a view on a`specified `@`A`R`vK4"._# =B! =@convY>.berters_key = 'get' + &Fgetter = functools.partial.get, _impl=getattr(qf, key)Ms" ", `)0Crepr0Zreturn ''."at_	KsgetitemNsS!ifLep.has_opT9raise KeyError(9	Y(geRsw, value	R_validate	ue_types(C=key?=E
s>	O?delO8P	E andS	 re`:_Vcontains3lenUP3len9s()Riter__(self):
  return self._options().__iter__()

)Edef -!):#if?sname !=parser.default_sec]7;	~1f ._T)kOelseBss@propertyHk(cb# The  object of troxy is read-only.M5xvm+ on a pzBx1geti", P, fallback=None, *, raw=False, varsR_impl **kwargs1"""Get aner value.@Unless `|`Cprovided, `` will be rBed iuis not foundd5"""#a# If `kit shouldia getter methodiM@thatsdesired type conversion!if
 %5getw (3raw,=uv=	,


class CterMapping(MutableP"""En0usecget*()Ds between DDand 3ies Ifp juements directly,U]A forQgiven5keyC`S"`.aresenc-r here eJ to find Da
;UGETTERCRE = re.compile(r"^0?P<h>.+)$"mq_init__,#._h= pdata = {}=ain dir_H_Emr.match(B-Am or@call0-:atti,)rIcontinue[m.group('7`')] = F   # See docstringp__getitemV7keyylBkey]@s@7lueG:tryk = 'get' + keexcept TypeError6praise VQ@('In<`atibleI`: {} (
))'2a	''.format(key, type(key)))
 if k == 'get':-raise ValueError('Incompatible key: cannot use "" as a name'aself._data[key] = vRjpfunc = tools.partial(9parser._get_conv, =De>.]erterdysetattrSA, k,vFor proxy in o:s()!2getn
G.get, _impl=#j_+P!)
def __delitem__,u:try#k 0 +  or Nonezexcept Typ
@2Key,3delfor inst9Biter
achain("._3,),E.Zm
1delj6, kAttribut'# don't since the entry was presen, silentlyI# clean upcontinuepreturn +`	?len89len7"""Utilities with-statemexts.  See PEP 343."""
import abc4sys_collections_#Wfrom  ?adeque
RwrapsTtypes`Method, GenericAlias

__all__ = ["asyncmanager", "`losingCnull!(","AbstractContextMQAp
D"ExitStackp/Decorato!	>redirect_stdout?!er>0sups"]


class m(abc.ABC):us"""An ab base @ Is!__&s|" =8m(	^enterB"""R`U`` uponqQering~pruntimea ;@2Cexit`, exc_i
l , Weback0any6 ep triggered F/in3Non@L
1subhook__(cls, if cls i_._check_methods(C, "__enter__"
xit__")
 return NotImplem.!d


class AbstractAsyncContextManager(abc.ABC):
Ms"""An a1b base EPfor aAhronous cI" mJRs."""E!__3_getitem__ =Emethod(GenericAlias)3Z def __ar__(self):B"""R`q` upon -ing the runtime;$;t@l
k, exc_type
pvalue, [[ebackaise any6eption triggered withinCNoneZ31subhook__(cls, if cls i
j3/p_collec s_1r_check_1s(C!",B@"hDecorator(object("Aaor mixnat enable to work as dW#s.grecreate_cmn$a 'd instance of x.1Allows an otherw-one-shot[U likeY_?support u{s3a via implicit7ion1Thi+a private i}face just .uSee issue #116477vdetails&5s*)vS_callg, funcxq@wraps(z7inner(*args, **kwds7n_&*eRs#vx$BBasem`"""Sha]eQality+@a`a and @
@__in/", ga.gen =U',-LQ>d81# I19330: ensur%s have good docstringdoc = getattrz1doc# ifClI$A).__E  =I# Unfortunately, t,still doesn't providhelp output whenJ@inspY[dt manager instances, since pydoc
 # currently bypasses the in8 docstring and show!L1for=QclassCGead.!See http://bugs.python.org/issue19404 Gmore details.


S
_GeneratorContextManager(UBase,AbstractT7/ADeco!):i"""Helper"@cm$ d.Q."""
1def _recreate_cm(selfMa# _GCMO are one-shot ` ao[?CM must be gd each time aed function isAecalledpreturn 1.__!__.@,0argelf.kwds)c_enter4	do not keep Au? alive unnecessarily#yply need$orion, which iscpossible anymM?del,2tryiBnextEgen)/except StopIt;ion@aise RunError("g
 didn't yield") from None[3xitZ, type, value, Webackr!if$I

&#UFalseJelserWstop"h
J"ifh# Need toc1tiaso we can reliab}=# tell if*0getb same V~	9! =(xgen.throw(	g
y0 asr# Suppress1*unless* it'Ithatxa# was [_).  This prevents anHd	1ide_"with" statement bese0excr	t43 Do1re- ing epH1. (Z27122 if+%@# Likewise, avoid suppressing if a StopIteration excep
+
 .# was passed to throw() and later wrapped into a RuntimeErrorN(see PEP 479).!if type ispexc.__cause__#mvalue:Ereturn False!;raiK# only re-4<it's *not* the;P that.
o#@A, be __exit__() must not lGax unless@itself failed.  ButM0haslo signal propag%0, s/isLQfixesEimpedance mismatch between?protocolLY.0#AThis canJRuse 'd BaseE0 asq' (as iKasync implement)6maintain compatibility withGPython 2, where old-style clasQs areocaughtL/by'if sys.exc_info()[1]7;=P("genWor didn't stop af,R")


 _AcG4ContextManager(_,Abstractg
^)"""Helper for @cmQ."""
n def __aenter__(uL~2tryY
`await -.gen.__anex[*Q vyield") from Nonez,x!, R , 3Weback@N

'+J/?els%")NJ"if~/  =<(Jo# See .t0com^s on subtletieg#+ist     await self.gen.athrow(typ, value, traceback)
 !raise RuntimeError("generator didn't stop after ^*)"Kexcept StopAsyncItBion as exc:yPeturnr is not	(VP$ifLqruYFalsej	# Avoid suppressing if a?ionAwas passed to ) and la>wrapped into awN(see PEP 479 for Z Ks; a_ alsoJhave this behavior). But dpis only0theG0eptQ0by +	is actully2(	)9Kissue29692).if isinstance(0, (gX,nm/))%.__cause__{U/3
>	a BaseEHh


def contextmanager(funcJ"""@Q deco!.
Typical usage:8,qUsome_v(x)u=>tryqyield bequivalent'ise
b/ =k##1"""@shelper(*args, **kwds$_GCEME", =;Y6\
~r
eJ#=  equivalent to this:

 uEtry:
$ = .open()) as fa>ais equivalentf_'T f.M2e()__init__(self,#ng\p.?=:Senter;4;3xm*exc_info=6_RedirectStreamp!_s&r = None	new_target_6 = 
^# We use a listUBold Ns#maQ CM re-entrantBC_oldhs = []c
9.append(getattr(sys, &)s$25	exctype, excinst	)tbeu.pop())r
_stdout(fm for temporarily I Lanother file!9P# How sD!()Utderr3YQsys.s(QG3dirhQwriteyia
i'F.txt', 'w'f~KB(pow,qP")"?err60err_	6errsuppress"4to < specifiedreptionsRAfterK"xc5 is: ed0ecu3 proceeds 2nexstatement following the with statement.

 uppress(FileNotFoundError):+3os.remove(somefile)!# Execution still resumes here if5 was already QdH2"""
def __init__(self, *excep^s&._6 = 
LSenterM@Ipass'xsexctype,SAinst	'tb?# Unlike is!
ance and issubclass, CPythonE handlingX
# currently only looks at3concrete  hierarchy (ignorH	` checkh\	). While Guido considersthat a bug rather than a feature, it'sairly hard one to fixJ!duvarious inal impla details. s provide1e s9rf based semantics,0try'to@exacoreproducekQlimitAs ofp&r.H
 See http://bugs.pP.org/e12029 for moreAQretur&is not NQ
R(A)


u _BaseExitStackA"""A( $#UAsync.@<ricmethocreate_e3wrapper(cm, cm'MASType($-)e5cb_c	allback, /, *args, **kwd	@exc_Z), cW(Sl4it_as = deque(@qpop_all?"""Preservpcontextck by transfer0 it|da new Pnew_s! =Mo(!T}	gAApush*itRegisternGPstand}_"_ Q sign6Can`+same way I6canpAlso acs any object-an=#(r a 7!toy4eadzX it])Mp# We usv unbound method rather than a bound method to follow
 # the standard lookup behaviour for specialE%s.=_cb_type = u(exit)
Etry:
p _$= >1.___,except AttributeErrorK# Not a context manager, so assume it's"vallableself._push}callback#Jelsey9!cm<3!, )areturnP  # A|` use adecorator.5def enter_(nV, cm)@"""E$s|upplied	RIf successful, also tes its ~K andxresult of"___El5"""@A# Web1 up7Y1 onLQmatchGwithGstatementh9_cm&cm q$q
#e8__(J6Acm, apUTr, /, *args, **kwdsRegisters rbitrary NP argusCannot suppress U7ion_wrapper = `create(yqqchangedsignaturepusing @PPs is appropriate, but0ett1_d__ may still help ` introRGtionmHper.E=Dn(F
'	v@sf
0Helto correctly rs./s."(-
c, True
2K,, is_sync=;'._m s.Cnd((4G))


# Inspired by discussXhttp://bugs.python.org/issue13585
class ExitSt	U_Base, AbstractCrMq3""":sdynamic2ap ck
For exampl| ()s:
            files = [stack.enter_context(open(fname)) for  in fileGs]
 `# All 7!ed$s will automatically be closed at the end ofJwith statement, even if attempts tonl[laterG!inc	list raise an exception..A"""
	bdef ___(self):preturn 	.Bxit_-, *exc_details;ceived_exc =%[0] is not NoneYn# We manipu	 so it behaves as though# we were actu|nesting multiple cs<Sframe@sys.info()[110fix)R=0newA, olCfA mayporrect,BfindUchainGvwhile 13 = $._)__G2!if5$is]/$# is already set cly (see issue 20317)tIX
!< or]break^	&# ChangeyyPpoint	Dwe expectto reference($ =Callbacks are invokedLIFO orderQmatchHioura # 3ed hFagersuppressFFalspending_Q*= (0._e
is_sync, cb =X0Z.pop(6sassert <	F:trya^oif cb(!
6Tru&"@ = (,
C2+		zV# sim6! o1s b

J_
A[1],:[1]5^
09if N
30# b1"exc_details[1]" replaces our carefully
 # set-up context!fixed_ctx = exc_details[1].__5-__7[raise1	%except BaseEIion:"r5 = 
7~return received_exc and suppress
0def close(self)
"""Immediately unwind the: stack."""IC.__exit__(None, L)


# Inspired by discussions on https://bugs.python.org/issue29302
class AsyncExitStack(_BU, AbstractA'CsManager1"""m for dynamic ment of acallbacks.MFor exampleIa\ withB) asV.Gqconnect= [await(q.enter_S@(get31())Ii in range(5)]## All openedJs will automatiy be released atK0end$)PstateK, even if attempts to|+ aJ` laterWQlist 0 ans ep,.?	@sicmethods_createB_wrapper(cm, cm&?rLMGSType($-)k&cbi6, /, *args, **kwdsx<	!Ptype,G, tb4-(_&xk@"""Esc li0Kr'If successful, also pushes its __a"_ *$a Qresul)E_F#'@_cm_S0 = 6(cmB"4 = $$._t"= {	*~	RC ._Po~=%'it

"""Registers a coroutine fun\(standardvsignature1CanRsame wayRF canA acs any object.an>#(ring a call
    
    to the method instead ofobject itself).
15"""_cb_type = e(exit)Etry:
;_n$= =A.__a_-except AttributeErrorL4# Not an async context manager, so assume it's a coroutine functionoq._push_callbackv, FalseJelse@1_cmI@TFpreturn   # Allow use adecorator
Adef _y$, , /, *args, **kwds)"""Registers;rbitrary and arguments.)Cannot suppress Oions$_wrapper = ._create_b (
# We changedsignaturepusing @pPs is appropriate, butP`# sett1_d__ may still help with introspec9;(r.E=n(F
l&.*U 0paclose(y
PImmedly unwinKFhstack.Sawaitv(None, )zJ
@, cm
0Hel" torectly r:c	k3Hper(%8lnter__=
53xit4, *exc_detailreceived_exc =%4[0]` We*qipulateF0 stso it behavesathoughDwe were actually nesLmultiple:OE<Sframe@sys.info()[1]&G0fix) epx_@(newA, olICy beBU%f%enUchain}Gvwhile 1@3 = $.__.!if5$is]/$# is alreadyly (see issue 20317VA_         if exc_context is None or frame_exc:
 ]break0new3( =N	&# Change the end ofchain to point	!xceptionDwe expect i,reference($.___ = old
+# Callbacks are invoked in LIFO orderQmatchbehaviour ofHtnested ]managers"suppressev = Falspending_raisewhile self._exit_c
is_sync, cb =0e.pop():tryF3if M 4cb_p = cb(*Dzdetails`/OelseI^awaitO	P7if Zr6TruqF}&@ = (@,F
e_.0ys.[Kinfov# simulat;Pstack=aions by setting
8@_fixZ(A[1],:[1]5^E; = g9if N
30# b"0g[1]" replaces carefullyp#44-up
!fixed_ctx8[1]Y
7	%a BaseE%:ion
r5 = 	Y7~return receivJand 


class null=(AbstractC1M)3"""  that does no addial processing.zUsed as a stand-in for a normalY, when a particular2blo@codeonly sometimes ugOwithZ: cmm`al_cm _"on 	Y"cmx# Perform opera0, u/ o\5is 82"""def __init__(, enter_result=vx".!0

    def __enter__(self):
 preturn .#qresult
"def __exit:, *excinfoDpass
from _contextvars import C,	Var, Token, copy4


__all__ = ('74', 0Var;	=')
"""Generic (shallow and deep)jing operations.

Iface summary:e1x =J.0(y))# make a y Q of yG#;?;]8
For module specific errors8 .E
 is raised.

The difference betweenf
is only relevant for
compound objects (	Pthat ain other$, like lists Dlass instances).

- AI@strubka new ythen (to the
  extent possible)certs *the same* into it ?original|1tai{?con, recursively,
 fcopies of! f\"in
wo problems often exist withRdon't+
+
&a)(xsX, directly or in @T a renmselves) may caus+ loop

 b) be|9 *everything*Iopy too much, e.g.Yadministve data 2ure should bered evenF

Python'sn` avoidS6eseb3pa) keepSpa table7palreadypied dur)tcurrentyM"@lettuser-defined cZes overrideGP*P  setSnents/is version does nolBypesm,z`, func@, method,
nor stack trace,
pframe, 0filocket, windowQarray
any similar tC.

C@can K5iAs to ropDy5
!pickling:7"n Y
s called __getinitargs__(),
PstateU__setR.  SedocumentjV!
"!e"G"rm$o$se.#


rweakrefr4regmdispatch_

class Error(Exception):
    pass
error = E  # backward compatibility

try8from org.python.core import PyStringMap
ep! I`@$ = None

__all__ = ["+", "copyAdeepp]

def #(x"""Shallow` opera on arbitrary P objects.
See the module's __doc__ sa for mAnfo.32"""<cls = type(x)@opieM__dispatch.get(cls)Ai2ier
`return5ierNif issubclass@,n8	# treat it as a regular 2
_immutablrgetattrk""_01_",q is not
jcareductf_
*^Dv = #^Helsekax, "__7Ze_ex_C%ifV%r}4
l6
~}Rraiseb("un(s$)
1 ofVq %s" % isinstance(rv,|x-
_reconstruct(x8, *rv)


O = d = {}Y x
at in (r5), int, float, bool,1lex, tuple,  bytes, frozensetS, range, slice, prE(ty:ws.BuiltinFunccBTypeC(Ellipsis)NotImplemented)K
Dweakref.refe{d[t] = T
t = Vp, "CodeNif tRa
d[lism."a
d[dic!se4setQParray
8
ifACdel d, t'	]Pmemo=, _nil=[]9p"""DeepOyV0if t$id1y =7	d@if yMdQys	deepcopy_dispatch.get(cls)
    if copier is not None:3y = (x, memo77els&if issubclass\v, type)HL_deepcopy_atomicV&
Z= getattr4&"_J1_",2#reductor = dispTj_tableZ+4if 6
!Erv =#*(x%Y !_e_ex_"=%
4-D
eBS%
("raise Error("@"un() object ofu %s" % DPinstance(rv, strN0x0_reconstructNq, *rv)
J0# I its owny, don'tAize.)Dif y4xPq[d] = y'_keep_alives) # Make sure x s at least as longdGreturn y

 = {}

def !hJ@x
d[()8!Ellipsis%
NotImplemented+?intjOfloaObool7 coux_bytes?strs.CodeType%s.BuiltinFunctionK/s.)weakref.ref{property7lis=	s3![]Aid(x`append.*for a in h#(aS@y
d[
EtuplM$,  y = [deepco2py(a, memo) for a in x]
    # We're not going to put the tuple in
@, but it's still important wePQcheckh0it,jAcaseBOcontains recursive mutable structures.MAtry:	areturnb[id(x)except KeyError0Apass=@k, jzip(x, y)(qif k isjs2y =1(y)KQbreakFelse51xAy
d[] = _deepcopy_W

def@dicti,=	c!{}d)A = yey, valux.items(@$y[U (k,I)>4X-
if PyStringMapR3Non 'd[@dmethod): # Copy instance !type(x)(x.__func__, @self)aypes.MlJTypec0l df _keep_alive""""Keeps a refere!toobject xY!.
7Because we remember /@s by>`ir id,!2havfto assurXat possibly te5aryCare keptlV2hemoW9oreaPid of, which should\normallyH
be used unless someone triesa:0 it"..2"""9)].appen*# aha, thisq`first &:-W_C=[x]Rrecon , cq, args,[`state=, listiter/;! =`A!ifA and@ = (>}C(arg0arg'	b&(*_V*x8y1if 3
D,0=&if hasattr(y, '__set)7__'+(y.(&
Tif isU/,)M2lenf) == 2=bR, slo" =%x4M"P__.update
           
 if slotstate is not None:
 for key, value in9.items()5Dsetattr(y,@!)
aif listiter~zif deepZs?
"x"=?Pcopy(q, memo)|$y.append%;els
{O/ic!
udEGkey 7,r[key] =;vOyU>return y

del types, weakref, PyStringMap
"""Helper to provide extensibility pickle.

This_only useful:Badd $ support 7I"on defined in
C,!&instances ofT$r-(classes.

__all__ = ["m", "constructor",S   "add_+jremoveVclear_cache"]

dispatch_table = {}Of@(ob_Y,_function, @_ob=!if@callU(;&Jraise TypeError("redu` is must be P"o
[wp9[# Theea vestigeAsafe!unNAing.vGrq reason)t^3alldass it anymore<,if@Y(B_ob)s(objectSy	pKi
# Example:8	 co%x numbers.

trys
except NamRpass
a$de|_9#(c, (c.real, c.imag&%e(&Qg)

# S(ing new-style Dsz7_re2(cls, base, !ifU>Sobj =T.__new__G(,_*k-'n.__init__ !a1RA	SU	obj

_HEAPTYPE = 1<<9
_new_type = (int.__new__)

# Python code for objec#reduce_ex__	protocols 0 and 1

def _(q(self, ():
    assertA < 2`cls = -.__class__base in cls.__mro__KOif hasattr((, '__flags__')@not . & _HEAPTYPEJNQbreakyTnew =<if isinstance(new, APwPew.__Q__ isGmFelse# =v0 # really reachable!ifV^D@stat2Non,
c:6cls7raise TypeError(f"canpickle {name__!r}!")B}0argQ(cls,!, *6try1getexcept Attribut@aif get, "__slots__", $5: "GAf"a  that defines  withoutG:fing __
 2be dHp|Qcol {}") from	Fdict#2& =e
(0if `returnbconstructor, [,+
[4aHelper_&__'2Robj__*vHdJ$@@B@, kwJ"""Used by04, sqead of  to allowl!esW
keyword-only&`uments15correctly.4"""
C, **`sR`a list( )t`a giveQass.
This needPfind 6sA2the"itbrs, so wcan't simp;:7"@.  We must walk down0Method Resolution Orderyconcateno,\0of Ffound there.  (rassumesPes do`modify+!irAWmisrepresent.)PafterY is
    defined.)
    """
	# Get the value from a cache inclass if possible:names = cls.__dict__.get("__slot 2__"q1if  is not None:Hbreturn"2Notd -- calculate>UA= []got hasattr(cls, ssr# This  ha sH2pas
7els# Slots founagather=Erll baseceKXPfor c\:Vmro__"(if+c
*.$"['Bs__'(#a single0, ivn be given as a stringJif isinstance(,,)3!3 = *-H# special descriptor_M!am"zweakref4rcontinu@# ma9d
$#el.startswith('__') and
G.endPCpped<A__.lN('_'T6 ifi=_)Ts.append('_%s%s' % (dAped,)j
/S	c
MI8
):CRoutcoif at all6tryZQs__ =gfexcept.* # But don't dieewe can't
# A registry of extension codes. is an ad-hoc compres&*
# mechanism.  Whenever a global reference to , <>pabout
#be pickl((0p) tuple7looked up her]Asee
T it!aKered jit.  E0 arDuniversal, so thapmeaning&a@ doe@t de` on
#  ex`!(Tare also sY reservedlocal usWa0hav is.triction.)  C<@itiv\ts; 0 is
#/]E.

__L= {}
# key ->
_inverted5  de78keyl	i          # dcode -> object
# Don't ever rebind those names:  pickling grabs a reference to them when
# it's initialized, and wo`1see;aing.

def add_extension(module,z , ):
    """Register an 2$A."""&1p = int()if not 1 <=.B0x7f_craise ValueError("D out of range"Rikey = Fif (!_rry.get(key) =1andx_inverted0}19eturn # Redundant gations are benignb0if ?in W
6%s is alreadyhered withMQ%s" %j
,{e[key])7 

	6
in use for
B., [: C  =fremoveN	B"Un  For testEonly#!1 or1) !.BAq-?delP!
G!"ifoIf_cachemFDVclear?(
..()

# Standard assignments'Reservedy
First  Last Count  Purpose
# 1   127C
Python s~qlibrary:012849@Y 64  :2Zopa192   239m+48'3rd partiesU0240. 55.+16.qprivateq(will n#be	2ed)G56   Inf	Tfutur3<;EO^ed by the PSoftw2 FoMB.
"""Wrapper POSIX crypt 9` call associated funcDBalit	
import sys as _sys

tryi_Z
except M1Not.f@.platformNr'win32'!jIv<("The crypt module is not supported on Windows")
    else:
raise Im.Error("The required _crypt module wa_built as part of CPython")

iLd errno
`string1_
from random 2rSystemRHas _1collections6namedtuple_


_saltchars = z.ascii_letters +Pdigit'./'
_sr4()


class _Method(_o#('@', 'p ident _total_size')):
A"""CSrepresent)7! mf per the MAar CFormat oLlegacy 2-ocacter HB."""u`def __r__(self)eturn '<;.METHOD_{}>'.fr1.K mk(=None, *, rounds`"""Generate af specified."If,	strongest available7 will be usedD$if%0is # =!As[0]R#ifX7A andisinstance(S, intr]BType[2f'{)1.__IA__._D__} object canAbe 'If'interprePas an{Reger'i9.:  # tradiA%al^'m(ml	$Hf'${Q2}$'Zi!)[0] == '2'Blowfish variantsf	plBlog_AU = 127
*int.bit_length"-1).{!= 1 << n
.CValu'@mustpa power28G4 <=d/31j!ouzrange 2**4 to'31ts += f'{002d,el`in ('516')FSHA-n*m@1000s<= 999_)Y(toOz=w	
#f"} doesn'cLargument''.join(_sr.choice( ) 0 in#geH.T9)r@s


v(word, salt=None):
    """Return a string represent
the one-way hash of a password, with;1altPprepended.
If ``salt`` is not specified or``None``, mstrongesOavailable method will be selected and generated.  Otherwise,0may?0oneq``crypt.METHOD_*`` values,!asIr-ded by : mkC()``1"""-0if Pisinstance(A, _M3 = V)N{" _($V

#  1Aing/)o@"s
Hs = []

def _add_(name, *args, rounds=&$ =0globals()['Q@' + W]<YszRresult = ;2try.A('',t<except OSError as e:# Not all libcraries suppor!enX4ionB.{if e.errno == 	v.EINVALe(UFalse=3rai3if Blen()V.total_siz@s.apr(v2Truu	
'SHA512', '6', 16, 106)$ 25#'5$063)sjChooseCped vers>of BlowfishIing.
# Early%s have flaws.  V;'a' fixesQ of
#pinitial implementation, 'b1@ 'a'o0'y'@same	'b', for compatibility
#Popenw$#_b .
2P_v inn@, 'y?a'iZ'BLOWFISH#2_v, 22, 59 + 5_v)C1<<4ujbreak
 MD'1', 8, 34qCRYPT',7`, 2, 1@del y 

csv.py - read/write/investigate CSV files.1
im#re
from _csv7lC, __A__, P!r,]egister_dia5, \Lunre'6get45lissCQfield8o_limit%QUOTE_MINIMAL, %ALNONNUMERICONONEK~__doc__Dq_
&$io9SIO

__all__"3", 6ALL
	"E"N  "Error", "Dialect", "__doc__Uexcel	_tab",
 "field_size_limi@`reader6@writ
	3register_dias8get5lissI]SniffJ/unL__versionUDictRWEunix]

class D:"""Describe a CSV !.
 This must be subCed (see csv.N	).  Valid attributes ared!deGer, quotechar, escapadouble, skipinitialspacelineterminatoJ3ing1"""_name = vq= False"# placeholdersb = Non(
x4ing@f ____(self)Y0if 1.__Z__ !=&'2TruRate()Qdef _0?x6tryD_X pt TypeError as # We do tl
for compatibility with py2.3U6araise T(str(e))t#l(
the usual properties of E-generateddfiles.`+1','R = '"
l
R'\r\nPdQUOTE_MINIMAL
,!("1", 
(!DTAB-/d ?\t'-t OUnixy/AL0", $)
Q, f,  s=, restkey2valH=C*args, **kwdsG.
&._m' =zP   # QPkeys rEdictvD$ =^# key to catch long row#A3valA
         # defau
lt value for short rows
 self.reader = 	(f, dialect, *args, **kwds)8%$ =/
line_num = 0
def __iter__({!):preturn -@property#;fieldnames=!if9&._# is Nonebf:tryt	;a= nexte1except StopIterationW;pasitp.`q.setter8!,ev%=#ZC __bZ == 0# Used onlyoits side effect.Orow 	8HN# unlike the basic, we prefer not to uwblanks,Cpbecause2will typically wind up with a dict full of|EPwhileH*[]I
drbct(zipI,U)lf = len(""6rowif lf < lr!d[restkey]5uow[lf:]"el=>=Rkey i.K[lr:&#d[eu5valid


class DictWr`CinitV, f, v , val="", extrasac="raise" =",l"#z*m' =z `# list,Akeys3FDl`estval>#7swritingAj)if.lower()Din ( "ignore"/d  VExError("( (%s) must be '-b' or 'N%'"M
%	i=*V)		9+he
wq!dBrow(R)g@_to_u
	#= kXwrong_fields = rowdic
t.keys() - self.fieldnames
 if wrong_ )s:(raise ValueError("dict contains 8r not inf=: "LP	+ ", ".join([repr(x) for xM5]))Oreturn (row.get(key,rrestvalH0keyJ!)
L depiterow(##, S)m0.wr-4 .__to_list)csdseQs(map:
jsl# Guard Sniffer's type checking agt builds that exclude complex()
try
except Nam	 = float

class|$1'''d"`s" themat of a CSV file (i.e. delim^, quotecharRs a Dialect object.`h__init__.^#@casere is moran one possible\preferred = [',', '\t; F:']
Vs@, sa_,\gs=None&""+dA(or 1 correspond to_L
J, double`, skip6ialspace = \@q_guess_FU_and_(?!if-"x*nSRs:SCouldgterminD"T"(x_8A = ">&edBlinecator = '\r\ne = QUOTE_MINIMAL'q# escapaF'?.,( =:I*(&# _csv.reader won't acRa-Vor '"<	elf, data>xPLooks text enclosed between two identical	()Pproba") which are preceded and followed
        by the same character (the probable delimiter).
 For example:,'some text','The quote with lmost wins, |{ If3re is noJ can't bterminedthis wayUE"""
matches = []for restr in (r'(?P<>[^\w\n"\'])space> ?
!>[q.*?(?P==?)', # ,".*?"$D
nP:^|\n7 1rs"ax, key=lambda x: x[1]hP# adjd - subtrac0sum=all@Uother(A.remove(!8 = 0A[0],?[1]tm@[1] Qs	Oelset@:[0]# build a listApossible delimiterL,=	total = float(min(chunkLength *qration,[data)p# (rowsconsistent * / (number&) = 100%7*1.# minimum (thresholdJi = 0.9Rwhile1s0Y5>= F@k, va&(@if v"> dv(/> 2 (('/I) >=*an4(	|None or k)F*0s[kCvA&*-d*01gFciN
sz)iskipinitialspace`3[0]Dn
H
<r"%c " %G2rreturn ^,, )# analyze anchunkLength linGes
 start = endend += chunkLength
 if not delims:Vreturn ('', 0)3,# if there's more than one, fall back to a 'preferred' list`rif len(wZ) > 1|for d in self.F
%"if(J~.keys()'+skipinitialspace = (data[0].count(d) ==4	
<"%c " % d))BNlikelihood be+$a Lrrdr = ruSU3IO(x,Tsniff
M = next(rdr) # 
)e1TE= {}ibrange((3s):2[i] = Noneohecked = 0L1rowN*dr# arbitrZ`numberQ@to cN,@keep6san0_"if&zed > 20^!UbreakVe1srow) !=(continue #at have irregular B
pf0colg]*):2~6thisType in [int, float, complex]:
 ?try,thisType(row[col])D+_break
except (ValueError, Overflow)MpassUOelse3# fallback to length of stringI  =0
.5if -!= columns-if) is None: # add new$] typexq% =4'N#minconsistent, removeOfrom]C9deration(3delP.
.# finallyare results against first row and "vote"@	on whether it's a header#AhasHE = 00forwl0 in{.items(!co4A) ==I0(0)zj-!ifd5") JAM+= 1S9-95~attemptMcast^(
>	+vreturn X> 0
import re
4sysDcopytinspecttkeywordubuiltin.functool_thread
Sr#s GenericAlias


__all__ = ['dataclass',   'fieldFrozenInstanc}6{InitVarMISSING',   # Helper ^ions.kasdict`{astuple_make_lreplac3/is1]

# Condi s adding methods.  The boxes indicate what ac5u the
#  decorator takeApFor allethese tables,n I talk
# about init=cpr=, eq=, orde
unsafe_hash! f=, I'm
# referthe arguments@dataclass decora0tor.  When
# checking if a dunder method already exists, I mean3` for aBentry in the class's __dict__.  I never7ato seen	n attribute
# is definedLSa basO.

# Key:
# +=
+8 Value   | Mean |8Up
|  | No action: no\is added.p-+	|NK| Generatedl+p+BraisPTypeErrorjp+0NonoD | A6ppset to Kqp"
# __init__
#
#    = parametere2  vqc	 1yesB<---10 ha3` __??
# | False |e898 Tr7@!<-pdefaultHCxe__repr'(( 
*o)a)Q0set- $elI;ofrozen=J8 orx2.  @}5---@-
px1# R}because notStheses would break"_-ness"
# off@__eq/eqJpz2Z
# | True  | ardd   | |  <- the default
# +=


# __lt__	e	gg 
#\+--- order= parameter|v' B  no1yes'
O? = f/()K`to detUif a parametersupplied or not.  Use
# Kt= it a bet7MISSING_TYPE"Since most per-fieldacn,read-only proxy0canshared among all ^s.
_EMPTY_METADATA = types.MappingPJqType({}HqMarkersvarious kindsY and pseudoFIELD_BASdef __initg, name.! =78!
_uw	~"('#')/?VAR(1OINIT0'81The#77 onwhere we stor0e F#
#s.  Alsoacheck ais a Data C.pS = '__K(_0__'bs3	l.
_PARAMv3svLa, if`pexists,@callt~end of
#=u@OST_xR_NAMECpost_String regexis`annota@0Var@Init	must match.
# Allows "idVfier. ["9 ["4https://bugs.python.org/issue33453\`detailMODULE_IDENTIFIER_Rre.compile(r'^(?:\s*(\w+)\s*\.)? __slots__ = ('W', )
[	!082#si.@,o(type_name = self.type.__name__
 Uelse:# typing objects, e.g. List[int]-US = repr(selk)(return f'dataclasses.InitVar[{BA}]'
4adef __)_getitem__(cls,&e)ZL(K>)


# Instances of Field are only ever created from within this module,
# and1$Pthe fI() function, althoughdiware
# exposed externally as (conceptuq) read-q`.
#
# filled in after act, not__init__.
# They'reknown at2BtimebB is  ti, but it's
# convenient if>Savailable laterWhen cls._FIELDSXbv a list,Yuls will have been popuu2d.
__slots__ = ('?!',P'^default	_factory$Ohashcompare@metaI_7_  # Private:pto be u by~r code.&)!__#, &	 , ', , #, 9u = None$ =
8'
/! =

! =
$ =
_EMPTY_METADATA)	5if 8!is' 28Ps.MapProxyType(F)g@n\	!('!('1f!={bO!r},'''*-
5=2'''+''9*-./            	    f'_field_type={self.0}'
&Q')')
4# This is used to support the PEP 487 __set_name__ protocol in the
Y# case where we're using a  that contains a descriptor as adefault value.  For details onD, se|https://www.python.org/dev/peps-0487/#implementation-\.R Notein _process_class, t.Fnp object;overwrittenDAwithB	A, sopend resi)E9hadp called
Bit aright time9def5(, owner, !):`func = getattr(@0.H), '', None)A0if DRVT?a metho^,VE"iti	
__getitem__ = {(GenericAlias)


a _DatabParamsq__slotsD('init',o 'repr/eqOorde1unsafe_hash:ofrozen!__+ , 
 , a, eq, ~', k", X4.:! =AM! =T
zeq = eqq" =y
( =
'# =return ('(f6O!r},'k''#eq%/eq#&) /5.0
/!r
!is
instead of expo1cre> directly,
#Pat a E checker can be told (via +bloads)cP)&
#RwhoseIadependPits ppeters.
]C(*, =MISSING_factoryR=Trueq   ~=, compare#QadatanB"""Rm$anto identify 0X%s.!isr$.  is a
    0-arg)ument function called to initialize a field's value.  If 
    is True, the)p will b9parameterS!class's __aA__()E\OreprX	included invBobject's ="()IOhashIEI=IcompareL	AusedE2in /Eison[s.  metadata, if specified, must0@mapping whicstored but not otherwise examin y X]!.
F Itqan erroqy both default and_factory.@2"""I$if!QMISSING<#:K& raV@EP('canM')return F(,,, , ,%e,
)


def _tuple_str(obj_name,"s)2# RPa struPesent
Beach1D of Da as a \# member.  SofsC['x', 'y']eCis "self"##  "(1.x,3y)"0# Sfal case f	Qhe 0-!ifV}ZC'()'@Noteo` trailcomma, neepf this Ps out1pYf'({",".join([f"{P}.{f.u!}"kNs])},)'


# Tj6's logic;copied from "recursive_"@ in
=prlib module@avoipendency.
Gd(user_|pDecoratcPo makvuB"...%a Zd;P_runnir= set()@{ools.wrapsJ1perkey = id, _thread.get_idenh(0if /!inK%$B'...*$pr/.add(key<-@args,'.join()@body#\nf'  {b}' for b#!)
.# Compute the text ofentire functxt = f' def {name}({|=}){P}:\n{l"}'mB_var s.keys()h"g__create_fn__({.E })actxt}\n"pnhexec(txt, globals, nsmY ns['lQ'](**oQs)


field_assign(frozen, , value, self_)# If we're a 2p class,g"n L to our `s__init__via object.__setattr__.  Otherwise, just usicsimple<cBment#`what ""xdEthiss: don'tAhard-code9`, sincLat might b'#if
#% f. ({]!},~Q!r},{y"})'f',.,#}=*'g3(f, mR	+Bline* e C  tXCwill4oPializ'ZR.qdefaulth_dflt_{f.Q}=.*pfactory~-sjn1# T|` has a| R . a parameter i?P# givq"it0Anot,$K4[f	6x = (f'{:B}() \	Tf'if ;!_HAS_DEFAULT_FACTORY=Eelse?'*`MiF$'svZPRs, buES#y`pt needs,b: # Wd here by8ingP,_`# becaNe  o@ wayq`3 itzP# ForO*fd with\=	# class dict just has the default value
 # (cls.fieldname=+*).  But that won'rk for aG8 factory,x
  mbe called in __init__Fband we0bassign}vto self@.  WP;n'tCfall back toclass dict's, both because it'sEnot set, (	 might be different per-cC
(which, after all, is whydhave a- function!).
Gglobals[^_d] = f.c	6&$'{'9A}()'(Qelse:

E# No"O.Pif f.15]zMISSING%)# There's nf,bdo an Fmentu9.,elI	]a|
<)1is C@ doeAt neitializa.  Signify	r##r by returning None1# Only tesi@w, s+ create variables"th#.  However,hp we're vQgoingactually de` state{InitVars_GP_typeW_FIELD_INITVAR^UNow, {PgenerTpDr(frozen, fr,0}})


def param(f)1# Rv $e0str>$th2c.  For=rexample=pequivaldof 'x:int=3' (except instead Sint',E!reca#in= 3'5G;"3)7*

1j#_+Aoutpw7"4= 'ai\eup's used_Alook?# it upf'=_dflt_{h}Dfactory function.  Set a marker.
 default = '=_HAS_DEFAULT_FACTORY'*	return f'{f.name}:_type_{G}'


def _init_fn(fields, frozen, has_post!p, self_R, globals):r"# : contains both realand InitVar pseudo-4#.
CMake sure we don't haveAwithout s following"G(%.  This actually would be caught when exec-I3theFfunction source code, but catch-
it here gives a better errorFmessage, future-proofs us in casbuild up the |E usn2astSseen_r = FalsPfor fUX9`# OnlySsider/*n_r__ callc5Pif f.Htnot (f.is MISSING_factory !.H2Tru Xelif %
'raise TypeE{t(f'non-argument B!r} '<']sI G"')locals = {f'^P': f.p }9.update({'E$':O,/: 6}body_line![]RQ(A = _@&(f)N!# ;is None means that t}PP doesfrequir # faializar@(it'P&).  Just skip i|!if}.append(P# Doeis classg a -?*if	lparams_str,'.join(vKp{>is _FIELD_INITVARp5f'{}.{_POST8_NAME}({$})# If no OEs, use 'pass'i"t#H7B = [5]p_createZ'g'[Q] + [_<(f)M /]P"=%='
=)[@reprs9 fnqcreate_fn('__repr__',
 ('self',)['return &.__class__.__qualname__ + f"(' +a ', '.join([f"{f.5A}={{R_!r}}"@for f in fields])tO)"'] globals=)v$_recursive_repr(fn)


def _frozen_get_del_attr(cls,,X!):Qlocals = {'cls': ,!'FTInstanceError': }:#ifmcI	_str = '3 ',op+) ;) + ',)'XFelseS# Special case9the zero-length tuple.<VS(_create_fn('__set;$    '*>ovalue'  (f'if type(T@) isn@ or B0{(/}:
' raise(f"cannot assign to  {f_!r}")Zcf'supe2.(B!, ) U= 
)
?delvodelete-|MM0cmp1op,__Wt, other
1# CM
 a comparison function.  If object are#d 'x' and 'y',6yD;cstring7'`0.x,2.y)?6"2.x,Qy)'.
R"
H' [ %3f' a}{op}{W 7NotImplemented
v@hash*e2 = 	*', fields)
    return _create_fn('__hash__',
 ('self',)!3[f'XJ ({/_tuple})']6globals=)


def _is_classvar(a_type, typing):# This test uses a  internal A, but it's the b0cway toGB@if tOiHCyAVar." t.'&4@or (/)0_GenericAlias5=Band .__origin__>n)#Hinit"Adata'es'e module we're checking againsteh%# currently in (^O.py)'qInitVarO ore"3Qnnotation, cls, a_m
"A, is*_predicateRGiven#5e aJ
 string, does it refer to1 in#m?  For example, whenRHthat_PdenotF,nUU&, " i&#/5ingq#.
OIpossiblevlook upYg
 involve^5rin sys.U1s ("!)	seems like a waste since[caller already knows- oY- "he ewas found-}@ we want1Umatchk.Tp;

{F`a func d with (objT) determinPf objIoe desired+QS
not do a local namespace sup (andxead only a+()1)re are someq ng4Ggets wrongWs, cv0 will btected a{t  CV = 8l5  @26 C0; iD: CV0B
nsB cv13z1z1QIn C1\R codeo&is8(
)F"CV"N@ fit, so it will not c0onsider cv1 as a
    # ClassVar.  This is a fairly obscure corn:ase, and the bestDway to fix it would beaeval()0string "CV" with@correct globalblocal namespaces.  However thaesinvolveG#a openalty for 3y single field ofPdatacAZ's defined.  It was judged noxrth it.
4match = _MODULE_IDENTIFIER_RE.(annotation)41if :ns = Nonpmodule_" =/.group(1E%!if,S R# No J, assumez $'s 5did<e"from #es import InitVar".1Bsys.qs.get(cls.____).__dict__:LelsesLook up/in
f? = |kuC)
Loa_types!is/_predicate(nI1c2)), a)return TruLFalse


def _get_	JfP2# RJ2a F4 bjRt'AV;%. Mse#/s are also ed, but markedsuch (seB# f.)rA# If
default value isn't derived ,,n it's only`normalF`onvert3to "()ks= getattrBrMISSINGif isinstance(:,Ne54f =4
Ens.MemberDescriptorTypeZ^#in __slots__, sodhas noQD3 = =,)!1# Ov0t t7point do we knowF0he P.  Se2"em f.A = a~ f.+	oA#a  until proven otherwise.  We're nex gotPcide Ba4 or	,N th4#-Zjust @TFIELDIn additionEPcheck]~aactual'Ps herU%~og annotationVs.  get_type_hints() won't always work for us
    # (see https://github.com/python/typing/issues/508 >example),Eplus it's expensive and would requirQ evalevery stringEannotation.  So, make a best effort to if this is a ClassVarGor InitVaing regex'sPcheckthat theH$ferencedFZctually one correct ^#.
(1ForG cote discussion,[abugs.pUB.orgRT33453K If[has not been imported,hnfassibleM3anyD+b?Uonly loo3 ifB 	 by any module (necessarily cls'Tm$!).SQb= sys.rs.get('!')'yl:if (_is_cQvar(a,'8)or (isinstance(f.,b
(,Y#*4clsZ.;L6))).f._field = _FIELD_CLASSVAR0yper, or ifpa match"9 #$$an:if #isT# Theewe're 20aga^8 %# currently in (datae [__name__]UHinitD
3_', 
.
GINITQValidsindividuBQTdelayed until now0ead in  F<() constructor, since here do wea# know: , which allowbetter error re5ing(Special rec8c[;n (>,_<|default_fayvMISSINGraise TypeE2(f'0{f.1} co0 ha! '9'z z+A# ShI]bother qsettings? Er#[ms the most serious to check for.  Maybe add others.  For
 # example, how about init=False (or really,4!)?  It makes no senseEClassVar and Initto specify.
<# fields, disallow mutable sq known types.Baif f._=_ is _FIELDisinstance(f.Jp, (listkct, set)):MGpraise VError(f'  {iP!)}% 'IM	f'{f.name}Anot eed: us_factory')#return f


def _set_new_attribute(cls, X!, # Never overwrites an existing @A.  Rds True if the#& alreadyA}x in cls.__dict__MYXQ0setx


# Decid/we're goreate a hash function.  Key is
# (unsafe_!, eq, frozen, does--2). Qthe aL
 to
# take.  The common case*qo do noP, so mead of provid5a
#P that<a no-op,@None@sign-%.#onjs, globals>L;2addo6flds = [f)(f.compar0 f.d  eR()]p@_fn(\Pexcep	1# R0DType0CanQ__!f'Rass {0__}9#
#_   +- |?F|WM
? eq=D
AH Z-explicit/L|m
V {@qvcB  v
A= {(x/, 0): 5[/  4G4-", v): None,
        (False, pTrue,   ): None,
,4&$, ;B): _hash_set_n>Lr-yr?add9m_
m9mexception*x+,x
F
91
9x}
# See https://bugs.python.org/issue32929#msg312829 for an if-statement
# version of this table.


def _process_class(cls, init, repr, eq, order, unsafe, frozen):x# Now that dicts retain inserHC	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 happe someone sD{# a custom strZ+ton#ca<such dataswon't be fuintrospecws(w.r.t. typing.get_type_hints)pwill st@funcJAcorrectly{Dsetattr(_PARAMS, _DParams(im\)# Find our es
rbse MRO, and excludourselves4d12 soYmore e#ride earlieriVjAs long aFwe're iterat$Um, see if any areBany_-_a=[Ehas_9s = False
    for b in cls.__mro__[-1:0:-1]:
 # Only process classes that have beened by our?decorator.  T6is, they?a _FIELDS attribute.>base_fields = get$4(b,4u, None)08if 3ais not$has_data_3`ETrueK'#f#".values()R/[f.name] = fN)ifPARAMS).frozenNBany_1 = S# Annotationare defined3thi  (!in>es).  If __aN__ isn't present5n tPC0add^W new ?.  We use2to compute 9"ariR# add5a#hFU found from, which is guaranteed to bhordered.  Default YS6assrs, if aPhas afA<!thwR!a #()=#itAcontainsi`al infyond (and possibly including)0Cdactualt.  Pseudo-eCPVars QBInit
w[ed, despitbe fact1're?Breals#'sdealt with later8cls  =.__dict__.get('ts', {})
W`Now fi inT|ahile doing so,idate somqthings, seDs (a"Vzes) whe&fwe can^r= [_get`(cls, W, typH"#.items()]/w&t	e5j#% (d}Fdr) existCQis of! '', replace i"th}6j7 is"soabnormal introspec0seeqK1ue,gvif isinstance(/0,Sif f.vMISSING{cg1re'4L#leKA0# TSphappensl0we 2ifyn(repr=False),@# example (WZF4ied object, but
        # no default value).  Also if we're using a'
<%# factory.  The class attribute should not be set atE
all in the post-processedQ.30dele(cls, f.name)%Yelse:(P$is41 or7'|'P)I- orng methods,1mus($thZ$eq,1if E&eqeJVBs'?_@true?0is 6nitK|nMt-init func'h>|7_ =r_POST_INIT_NAME)
#
 %# Include InitVars and regular fields (so, not Class&%).Cf"= [f for f in7.values()+uq if f._]P_type4(_FIELD, _INITVAR)]>_set_new_attribute(cls, '__init__',,j%0fn(*
5ofrozen,has_postg3# The name to use Bthe "self"	p# paramC_.  UsEif possiblee	'__datac_0__'''s`Relse BCglobals-	1))
`# Get ^ as a list,i	only real  This i#dball ofRollowing methodsDi_c !
8s]if repr:.Una1>)>! _
# ]AVif eq# Create _eq__.-ere's no needea __ne&# since python will cY_V0negg"itUvcompare_tuple = 	S_str(o RRother&/+',0cmp_fn('o', '==3!, b%=GordemsF$
kJ\Xh@, op[kl3_ '<')/*e?'<=+gU>*U>U]r\?if k!-	         _cm	p_fn(name, op, self_tuplCther
/
 globals==)):=raise TypeError(f'Cannot overwrite attribute {=} 'Ff'in class {cls.__:__}. Consider usingL
'functools.total_ordering')
if frozenfor fn in __get_del_(cls, field_list, !Bif _set_new8=nO, fnY.fP`*	# Decide if/how we're gospto creaa hash aAion.O_action = _[bool(unsafe!),2,2/eq)-has_explicit]!if# No need ?all	 here, since by the timeY#D(!Sis uncondi7"alJ7E8_ =I6get'__doc__'q4# Cr`doc-st"<0 = {% +str(inspect.signature<)).replace(' -> None', '')Preturs


def data?=0, /, *, init=True, repr#eq	l=Falsem!#A"""RsCsameas was passed in, with dunqmethodsadded ba(!onH>qs defin>.Examines PEP 526 __Za#0s__Pdeter&s;!IfQ is tPan __*R__() 'to}1 IfM#A0 __@Q. If h0ArichGcomparisonQ are @FaC_zq*Cc1mayG
Pbe asafter insta2"""@wrap{_process_$R, eq,', ,k@# Sel$ becalled as @7 or().
    if cls is None:
 # We're called with parens.$return wrap
5as @dataclassC9outFB(cls)


def fields(8_or_instance)B"""R{a tuple describing the@ of this .Accepts at or an i;aone. T_`elemen2Qre of`type F2"""^	# Might it be worth cachis, per ?J"ry{ = getattr, _FIELDS)> ex AttributeErrorPraise TypQ('mus	%or$')Exclude pseudo-.  Note thatxis sorted byHaertion# order, sonQis asb@ werRfinedl70(f for f in.values() if f._G_#is=jE_is_hL(objl`s TrueS0obj0/D.1has["}
alacls = Df isr , a) elseb=cls`asdict3P, *, 
_factory=
M)ofQa newNionary mapping names to @Exambusage: G " Cs  x: int yc = C(1, 2"  assert c) == {'x': 1, 'y': 2}If given, ''`' will2@used6@teadbuilt-inT0uncW applies recursively1arefX@s. T)also look%o containers*~s, lists, and if not he"O) should'on3"s"_?b_innerr'/ifesult = []m: = pobj, f.)]Br|.append((2,)+dict_factory%(result)
    elif isinstance(obj, tuple) and hasattr'_fields'):=A# obj is a named<.  Recurse into it, but the returnedB1ectEgnotherK1 of7same type.  This isBsimilar to how Elist- or-derived classes areBtreated (see below)we just need`c)m?differently because's __init__JsKbxcalled Ipo-34363).
qI'm not using0irasdict(tmethod,- it doesPr   converm6~2s (
_factory).8- I don't actually wantA$0 a =B herge mainC   hAcase%Bjson.dumps,thandles9ingC6s.  Admittedqe're lok8som  informationwhen we produc Y i0eada.  Note that ifD
2cts`D	B,;could no longer a 0 on_*atstructure wv	@ wasp0d aG key1R)(*[_q_inner(v, for v inE](=	~aAssume3an aQT>!isq by pas8in generator (whichJ^Atrue	]QWabove
t
f(gko,0

:
2%k,.items()2Felselcopy.deep	)


def as>3, *-=A"""RH#ofk2new{s valuesExample usage::kQ@dataP<& C@  x: yc = C(1, 2|%rtcc) ==  1If given, '' will b!edIbuilt-incThe funcapplies recursVively to field values that are
    dataclass instances. This will also look into built-in containers:G
tuples, lists, and dicts.A"""
	if not _is_y_ya(obj):(raise TypeError("asf() should be called on!")Mreturn _@`_innerm!, Q_factory)


def)/ifesult = []for f ins", =cgetatt}f.name)@r~.append(V!	(2%xelif isn)6has!'_h's'# obj is a dk.  RecurseWit, but the r%ed+B1ectEgnotherK1 of7same type. 'isBpsimilarBhow EB- or-derived %es"(# treated (see below)we just need`c)mdifferently because's __init__JsKbIpo-34363)l.DZ;(*[v vOobj](7>)Assume w#n  an!is by passingsa*generator (which4AtrueGs, handl-_above	
	
t(ik5s,
~4k, .items()3Belse9copy.deep	FmakeP(cls_e,, *, bases=(),|space=None, e=True,uBrepr3 eq		order=False, unsafe_hashGbfrozen!uA"""R,Iew dynami'y}d.6TheDbe 'S'.  '}an iterablQof ei(&1), ,)P0, F{)Qs. If) omitted, 0str'typing.AnyFE!by0;equivalent of calling 'field(name, type [, F-info])'.

 C = make_dataclass('C', ['x', ('y', int)z", _init=False))], bases=(Base,))`is equivalent to:5  @o{! C?#):x: 'typing.Any' y:z. =wrFor theP and "space parameters, see(auiltinB() function<(Th6 , repr, eq, order, unsafe_hash,sfrozen ar>qssed to1().2"""'ifvis None#A= {}:7els!g# CopyCsince we're go1to mutate it}{Zc.copy(d# WhilLAlookNahroughD+|p, validf@thaty#identifinot keywords<duplicatesseen = set()NUanns for item ins:if isinstance(&Y, str ! =E`Otp =elif lenSf) == 2u;M\, tp,X:3:Lspec?\[f]5pec
1raise TypeError(f'In00: {C!r}'5(ot?n?@ or 6.is(Zzrs must be5 F@s: {[$if,3.is6t$beOoV
	 dO2.ad"tp'__annota@s__'4X# We use `
as.new_q@()` ead of simply&to allow dynamic crebVof generic s clq@cls_0, {}, lambda ns: ns.up$)freturni@(cls6it=|===J	=", =p)


deflace(obj, /, **changeseB"""Ra new object7d\as with+@valu:PThis <0@ally@ful  es.  Example usagQe:

 @dataclass(frozen=True)3 C:2gx: intyc = C(1, 2D1 = replace(c, x=3assert c1.x == 3 andy2R2"""-# We're going to mutate 'changes', but that's okay because iaQ# new dict, even if called with 'obj, **my_`2)'.if not _is_>_instance(obj)1raise TypeError("_) should be5on P P2s")v1# I0n eJ
have init=False fields in.BIf a 1 is&, read its value from the provided objPfor fepgetattr, _FIELDS).A's(# Only consider normals or InitVarsfaif f._P_typeb_CLASSVARd1continue, f.!
-!# BthiscspecifiedVPf.namx "
]&VKj1(f'" {=}medeclarx=', it can6be L'xI7qINITVARf.defaultMISSING@"$B_!r} "@mustc"K[I] = 0Cre(U@objeWQwhich@s __@__()# __post(if defined), usaall ofBss we'veG adand/or leftA.  I@bre arers supplG9*3n'tn!, will correctly NT(areturn.!__?S__(**d)
"""Concrete`e/time related s.

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

__all__ = ("date", =TdeltaYqzinfo",KA "MINYEAR 1MAX)


import TP as _	Amath	sys

def _cmp(x, yUe0:0y e1#> C-1

 = 1
MAXYEAR = 9999
_MAXORDINAL = 3652059  # date.max.toordinal()

# Utility functions, adapted from Python's Demo/classes/Dates.py, which
# also assumes the current Gregorian calendar indefinitely extended in
# both directions.  Difference:  DaxLls January 1 of year 0 day
# number 1.  Tode here919
7is is
# to match0iontthe "proleptic"h Dershowitz
# and Reingold's "Crical Calcula"\Ait's{1basX
# for all comput6b.  See/3ook$Athmsconverting between
#  (smany othersystems.H-1 is a placeholdernxlpurposes.
_DAYS_IN_MONTH = [-1, 31, 28+30 	#]
GhBEFOREK]dbm = 0
Ozdim in [1:]:
   s.append(dbm)#N+= dim
del dbm,

def _is_leap(year)T" -> 1 if , else 0."Wareturn % 4 == 0K % 100 !%or&!00(")
}days_before_u;9 of"s /i st>2y =p9- 1*365 + y//4 -(00in_month!, #rin that3srt 1 <=%S<= 12R#ifA== 2R!298*]A(p precedGPfirsto'& must be'n1..12'[6Q] + (
/ >\xymd2ord,`, consider01-Jan-0001 asC/ 1*1= _k>0day1pdim, ('
<P%d' %
(c
1) +aB	&Z'.@day)dI400Y dar(401)    # number of days in 400 years
_DI100Y = __before_(101)    #"	" 100   "@O4Y  @5>@1  4@p
# A 4-p	 cycle has an extra leap% over what we'd get from pasting
# together 4 single.
assert _DI4Y == 4 * 365 + 1

# Similarly, a&$
#7100Rsy@OTOH
>one fewerJthan)25i	c= 25 **-def _ord2ymd(n):
ordinal -> (, month,), considering 01-Jan-0001 as!Q 1."
H
# n is a 1-based index, starB at ?1.  The pattern}sLrepeats exactly everyBbasic strategyto find theJpclosest<boundary2or $0 n,4n work withs offsetJtCto n.  Life~much clearer if we subtract 1Kn first --gnp valuesn4kmties areIthose divisible by200Y#(pD  M   n7n-11B-- --"-	=31 Dec -,0  -'	u 1 Jan -399' 9(+1 (y7...!30! 0=-P
(-2// '* :   ^
>	! 2	L2U. 3/3'C=&40) GRn -= n400, n =dmod(n,B) 0 = (  *A...,2, 1, 401, 6R# Nowthe (non-negative),G2,Nu"1wC, toNEdesired date. acompute how manyTp	s precede nQNote Oit's posPfor nto equal 4!  In that :case 4 full
    # 100-year cycles precede the desired day, which implies Iday is December 31 atGend of a 4l.9n100, n = divmod(n, _DI100Y)
"	# Now compute how many 4#itW4U4SvAnd nowOpsingle 
s.  Again n1 can be 4, and asmeaning#th/
=13365@ += .  * + n4 * 4	1 ifr== 4 or+
:`assertm5= 0areturn-1, 12, 31{is correctnoffset from January 1.  We findk#month via an estimatmat's either exactone too large%AleapQ == 3(n4 != 2!3)y:`= _is_(K&= (n + 50) >> 5@
ing = _DAYS_BEFORE_MONTH[9Q] + (
A > 2`_#ifZH@> n:|&istO2-= -/IN/==Fn -=m!0 <= n < _days_in_$!, O are"1thexp# startDD:  we're done!(, n+1

# MO@nameFor localized versions, seke calendar module.
CNAMES = [None, "Jan", "Feb0Mar!Ap0MayQJun",	@"Jul#0Aug0Sep0Oct0Nov`Dec"]
U|!Mo|0Tue(0Wed0Thu0Fri!SaK-Sun"]


def _build_struct_time(y, m, d, hh, mm, ss, dstflag)w<= (_ymd2ord4) + 6) % 7@dnumdbefore"0, m-.X
~ , ])Sforma@us, spec='auto'Qs = {'hours': '{:02d}'w'minute:$nsecond$+_milli0\.{:03?cro7A6d}'}%if
# Skip trailing microseconds when us==0.
 timespec = 'micr-' if us else 'B'7Velif 894lli$:%_us //= 10006try`fmt = {$s[M]'except KeyError3raise Value('Unknownv"')H7lse=eturn fmt.format(hh, mm, ss, us)

def __offset(off)Ds"if off is not Nong.days < 0<
sign = "-"Me= -offw<+< = divmod,delta(hours=1)i1|0jminute2s += "%s%02d:P" % (", ^if ss or ss.KRL3ss.9
MG$'.%06d' %wOr(s

# Correctly substitute for %z and %Z escapes in strf"Rmats.Twrap_(object,$}Stuple5# Don't call utcV)&tzname() unless actually neededfreplace =hp  # theing to us<z0z Z0Zc# Scan>", U)as2new`B = [upush = q.append0i, 0r0, len(:pwhile i < n_cI&"[i^'ir1Q f )V= '%'<R18matZbijfj5if !is
%*tgetattr4B', 0b:(/!3O= 'z*6= "hif has% "t"52 = .9(4?set#BQ+R#bU(	   offset = -offset
 sign = '-'/h, rest = divmod(g, timedelta(hours=1))MmM[KominuteM1s =.seconds~Bu = o.micro8_if u:^wzreplace\d%c%02d.%06d' % (|, h, m, s, u6oelif s-}z/sex)tqassert '%' not in Gtnewformat.append(.^9ch == 'Z'Dif Zois Non*O= ""
if hasattr(object, "tzname")63.1((1 is82`# strf8going to have at this: escape %N#s.F('%', '%%'
E//el@pushi4*chM+'($O e.join(rreturn _f.o%tuple)

# Helpers for pars heult of iso()
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 Q[4] !"raise ValueError('Invalid  separator: %sjI!)
vYmonthwC5:7]x7x''L9daygD8:10hr[!, x, day]
hh_mm_ss_ff(`Parsesb0ngs0the)m HH[:MM[:SS[.fff[fff]]]]
    len_str =
q(tstr)
time_comps = [0, 7 po0*@for ) in range(0, 3):dDif (h- pos) < 2 $raise ValueError('InUPlete cconent'7[.q] = int[pos:pos+2]1E+= 2next_cha7"1]	gvif not ,,>=Zbreak:bo!= ':'Rvalidseparator: %c' %1w ifd  <p4if  ] .microsecondFelseijremaindes*!if-in (3, 6^,BI	oJ3G)]),
J== 3
Sr*= 1000areturn

def _parse_isoformat_C1# F supported is HH[:MM[:SS[.fff[fH[+HHw	] too shor`# Thisequivalent to re.search('[+-]',), but faster0tz_B!= .find('-') + 1 or6+2=""[:H@-1] U@> 0 #7$ =hh_mm_ss_ff( zi = None	Z'tz:U#zone strings arL!# alen: 5~%0:SS%8%&1fff(%"15()v5, 8, 15)0Male	zn
:eif all(x == 0 pxmtDt|E.utc[tzsign = -1!Bstr[P - 1]r2'-'.Atd =delta(hours=[0], minute51],~`02Ez3G
B* td) time_comps.happend(tzi)

    return time_comps


# Just raise TypeError if the arg isn't None or a string.
def _check_tzname(name):k0if c is no>1and
isinstanc2S, str7
("tzinfo.te1) m1, "~G"'%s'" % typ} ))offset-producing method, "utc"	"dst".
# swhat ith ed&If!Hbdelta,|s}7 ,Vs#FElse\  ced for bein range- Ifis, its integer valueQed.  WV
sdButc_(=,cassert7n (;!, 9)i:L7ot 7z,Ex9??%s(;0&or`,>E%))g-S(1) <&  0.5, ==9q#od# The expression r / b > 0.5 is equivalent to 2 * r > b ifs
    # positive,"<"@nega.)ar *= 2greater_than_half =Z> 0 else r < b2>if 5or r == b and q % 2!1:3qq += 1
return q


class timedelta0"""Represhe difference between two date; objects._Supported operators:- add, subtractx- unary plus, min"ab]- compareu8multiply, divide by intu Invfition,ssoion off5Ving a,p1add_< orOarE?B givRKCa: (days, second3cro).  Why?  Because Ilfelt like itx1"""__slots__ = '_[S', '_P&miahashcode'Udef __new__(clsYEys=0D1=0,{Smilliu0AnuteFAhour	weeks=0):@# Do4 thfficientlyccuratel  Cg.2o bUicult#7error-prone, dudubiquitous overflowsibilities8thaNC double doesn't have enough bitsd`precisqDto rj:~
 10K years faithfully.  The 0 he@ries GmakeOexplicit w'go-fast assumpaPs can!@relin, in order toK gu_0the]mplement; it's way morPnvoluw speed-KPignorTauto-d-to-long idiomatic Python could be#XXX Check  all inputs + inqer floa9Final valu8Rteger+%s`us fit32-bit signedbas; d ivbounded?d = s = u07WNormalize everythtPW0ays%*7QI;tes*60 + KU*3600+	_8+= I*100pGet rid^f3ionn,# Take a deep bh %if isinstance60day{i = _math.modf5)-4;]whole?& * (24.*3600.))
      assert daysecondswhole == int()  # can't overflow
G/s 7	%rg)%dJZelse:(frac = 0.0!! =isinstanceDv, floatu1;abs*g) <= 1p*[,GLs?24 * 360#0 isfreferenced again before redefinition
7if |
8
 = _math.modf(
+#" +xJ#B .	bs}lp.(VD#, TivmodP, 24*Qkd]ksF)d"? * pa`usdouboe * 1e60) < 2.1e6	exact value not criticalC#_tSmicro	
y" = round(%+ W	.2= dA, 10B:5,:


O(, #dD"j-q3qv'Mseconds) < 3s.1e6

 0# Just a little bit of carrying possible for microseconds and s.O, us = divmod(7A, 10)44 +=Jgdays, Es, 24*3600:d:*	assert isinstance(d, int5"s"0 <= s  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-|s7, 6ghh, mmXm Fr"%d:%026e09
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^c%hS__adde, other):
   if isinstance(other, timedelta):
&# for CPython compatibility, we cannot use7our __class__ here, but need a realu	<freturn(self._days + ,77gsecond:=Smicro1|)NotImplemented
__radd__ = __
def __sub__,- :{Br6-C43neg /# #(&)
>posRH/ab,0if (J < 0KwOelse'Jr3mul7intl 7#<!*q 49CLfloa6cusec =8to_W(Pba, b =.as_integer_ratio,
	0, 0, _divide_and_round( * \)o?1__r-
H'W(#(24*3600) +a) * 10 +
                self._microseconds)

    def __floordiv__(*, other):#'if not isinstance(", (int, timedelta)48return NotImplementedVcusec =)to%()'/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 withL/eq4;R._cmpre) == 0Oelser1/leK<-tL?+g?L>?,g?lf, other):
 if isinstance(other, timedelta):
(return self._cmp0U) > 0(Oelse6NotImplemented
1Adef IS!, toassert
GN._getstate()Z)_hash__(~#ifcode == -14.A" -J
n
7Nbool7Ydays != 0 or^[osecond&
Xmicro+# Pickle support.Wi/,@aup_reduce
_class__OE))

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

C datW"""ConcreteS typeConstructors:__new__()@from$SstampStoday ordinal(YOperaQ@reprq__str__YB__eq#letgg!52add&r
sub__ (add/ only withC argdMethodStuple&toFweek5iso, isocalendar2isoformatKc\CstrfProperties (readyear, month, day01"""__slots__ = '_+Q', '_.
1day4`'/Pcls, ;fQ=Nonek
9 2@ArguFRMquired, 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 inPive e. message.araise Value\(&            "Failed to encode latin1 string when unpickl?"
 "a 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):+$"CG "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 in0uresult. -""ord2ymd(n&isoformat *`output=.Q().if not isinstance"e_l,<q^raise TypeError(': argument must beC'
@6tryRassert len{u) == 10m**_parse_	Aexcept E:ionCValuf'Invalid ^`ing: {M4!r}N isRendart]"3ISO*q number7day@This8pinverse2cal`) func&`# YearDPboundUTway because 9999-12-3\(v, 52, 5x\MINYEAR <0MAX
"orange: {E}")

        if not 0 < week < 53:
 out_of_range = True
!"if;-==<G# ISO years have 530s in them onstarting with afKThursday and leap:on a Wedne'
B`first_E= _ymd2ord(, 1, 1) % 79Kif (=o= 4 or3
B@_is_:)))5NFals%Graise ValueError(f"Invalid0: {6}")Cif n!3:< 8WSday: {day} (Cis [1, 7])g# 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,`out us:Cstrf.-- that's better tooH."%c", ...) is e specific.
vsRzSstylet.V7@B.too{(sLx %s %2d 00:Q %04df_DAYNAMES[g]b_MONTH"self._month],
  self._day, pyear)

"def strftime(q, fmt):!"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 ._d_month
3day<_OU__ = B# Read-only fiel-aessors@propertyny90""" (1-9999)yYZ[/12Y%Z?dayX0dayV/31V2dayT# Standard conversions, __eq__#letgg=# __hash__ (and helpers[.``local ' ( compatible with.&%(]PbuildAuct_&mF,020, (-1oz/alproleptic Gregorian 5 ^!,  <7dayJanuary 1 of +  1P1.  OFb valuecontribute to{uresult._ymd2ordJdreplac-S=None1day

Ra new9specified(s.i.0is z
' =#if89:86x
p )(&&, 0# C`risons
 objectsSother9q!, h     if isinstance(other, date):
 return self._cmp+e) == 0)%NotImplemented
def __le__(D!, keif isin&<tGgG>gG>Z oassert$dy, m, d =Syear,Tmonth
6day52, m2, d2 ="._9#._:;(}U), (yS())Chash{u"Hash."#if/@codeh*-1(&._" ^._getstate())U
7# Computations3adda"Add a. to a timedelta)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& +"(-x61	%t	&(7@1 - 2(rweekday%""R0day@the *, where Mont ... Su6{\. + 6) % 7# Day-of-the-f 	w1accgX2ISO>0iso/)1nday == 7."
 
# 1-Jan-0001 is a Monday
  return self.toordinal() % 7 or 7
*def isocalendar(/!):IB"""RH$a named tuple containing ISO year, week number, andBday.kPThe first71aof theC(Mon-Sun)Bu&u#'sOThursday; everythelse derivesFfrom thatSis 1;P1 ... Su`7;> algorithm taken lyhttp://www.phys.uu.nl/~vgent/C/E.htm>(used with permission)5"""" =_
!1m(w = _iso(+RPtoday&qymd2ord.P,\Tmonth
6day=# InternallyRhave origin 0 ,  = divmod(-6, 7d!ifF < 0eU -= 1^
0$elZ>= 522if >z:+1)1+' =BS_IsoCADate!+12+1)# Pickle suppor`_getst?yhi, ylo !6256tbytes([9/<2]),(_s, string!O
4 = 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` c1ime.(raise NotImplementedError("# s')"
, positive ^ ea6f UTC, negawest of UTC"#
 8raise NotImplementedError("tzinfo subclass must override utcoffset()")
Pdef dst(self, dt):j"""datetime -> DST >@ as delta, positive for eaquf UTC.
KReturn 0 ifHnot in effect. include the1I.5"""&	fromutc inQlocal&."1if sinstance(dt, 8txCType) requires a=P argu%")
cif dt.!is|hDValui5"*3pdtoff =^L
x"is Nonep
@non-=	
x"resultB# Se@long com% block atZend of this fil%an# explanation*algorithmRdtdstMB2\ ~|!- 	
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().__=(>)F@propertyx-^elf[0]

    @
property
    def week(self):preturn A[1]
@:?day=	2=i__reduce__2,# This code is intended to pickle the object without making&# class public. See https://bugs.python.org/msg352381>(tuple, 2,)).pr@0f'{91.____.__name__}'mf'(year=3Q[0]},13day
2]})')


_IsoCalendarDate = M
delr_tzinfo2 = !

R timeq"""Timeob zone.Constructors:__new__()YOpera re5, __str__
`__eq__#letggbhash__kdMethody@strf!()Sisoformatutcoffse tz ds8Pies (readonlyhour, 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$._F = - ]'QP&= _check_time_fields(
 hour, minute, second4cro
Ufold)5_check_tzinfo_arg("
self = object.__new__(cls# ._|0 = _="._# =# =%miA(2 = 	hashcode = -10 = preturn 
# Read-only y accessors @property1def(A!):0""" (0-23)"""qJwWLY[/59[&]]]
&]bg9		E*	ktimezone 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,Amytz3lf.C!otd
AmyofUtBNone51if Z0is FR   base_compare = True
 Uelse:	myoff = self.utcoffset()%"ot%_other&base_compyZ!= >
Q8if *
return _cmp((b_hour,t_minuteusecond,Z	ARmicro,)-(o
pED (rJ2if is None or 
if allow_mixed+2 # arbitrary non-zero val0	raise TypeError("cannot naive and awftimes"dmyhhmmA>y * 60 +" - //Abdelta(]6s=1N#otNIO6" -;P$O=$
 Dhmm,
def __hash__)"""Hash.""",#if3code == -15%?foltreplace('&=0aC	;+"tzt0if /)Q:  # ~!or	LP (t._getstate()[0]0h, vvdivmod(U2!s=h", 0
A) -  W*1)%aassert7m %3l, "whole@_m //=;
Bif 0 <= h < 24KyFf@ime(7.
E2"=
kg
L1# Conversion to string`_tzstr^RIformatted^zv (+xx:xx)an empty_	_i_?Goff)__reprtBl`, for 7)()%R != 0        s = P", %d" % (self._second, Rmicro3)
 Celif e != 0: 'As = _[L,&Oelse4"!s= "%s.%s(0%s)M_class__.__module__,;;qualnam=Fhourvnute, stzinfo is not Nonassert s[-1:] == ")Bs[:-1] +KQ0=%r<JfoldatC'=1]return s
kdef isoformat, timespec='auto')B"""R?1the( :ted according to ISO.b	The full.S'HH:MM:SS.m+zz:zz'. By default, ffractionalO@partD@omitz00"opH argument Qifiessnumber of addi5}Pterms+include. Valid jbs are E0, 'w&s'0'mi|Rs', 'YTmillig and '5s'.&""ok__ ._t
%MX
|-Ctz =Iftzstr(Vif tz<]us += tzu
__str__ =C@)amethod<Ffrom2clsD:ingConstruct a =`outputL().Z!ifisinstance(`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  Python's` imple(ab# can a bogus k6ion|tuple = (1900, 1HLm             0, 1, -1)
return _wrap_strftime(self, fmt, qtuple)
5def __format__*!):Tif 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)."""$1if _tzinfo 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", "UTCe-500",K@"-5:B "ED'S/Eastern.America/New York" are all valid replies.P1"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$acTPhour=a, minute
csecond
Xmicro=True, *, fol=bQa new|Q withvalues fspecified fieldsji
bF#if8 :<<<<Acond is None7:
 microsecond = self.+if tzinfo is TrueFA<@fold:;Non:8_
7return type()(hour, minute, , , J=!)
Q# Pickle support.def _getstatf, protocol=3)us2, us3 = divmod'._,a, 256)n`0us1222D	$hs_;"ifE andF > 3gh += 128=Abase = bytes([h- lf;A:O&3](,A;els	.c*_sdstring	@not Q
isinstance(d2, _	g_classIraise TypeError("badp 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-[]j"[,]fGThe Oh0dayuments are required. may be q, or an5T of a,1sub . mremainingcNQints.H1"""__slots__Fate. + new__(cls,=3day
4$=05
^1=0,~)IH*04Gif (c(q, str))k@len(p) == 10{    1 <= ord(year[2:3])&0x7F <= 12):
 # Pickle supportif isinstanceO[, strCN:tryX = bytesB'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'.__setstat_month)@hashY = -1preturn w!, M, day = _check_	d_field&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%0framath.modf(tus = round(+ * 1e6)
        if us >= 107:
 it += 1Eus -.@elifI<< 0B.(\!usVo%0
converter = _time.gm Zstc elsePlocal=y, m, d, hh, mm, ss, weekday, jedst = g5(t)?ss = min(7059)	# clamp out leap secondsthe platform has themNQresull?ls(fus, tzif tz 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  <
Gand sys..startswith("win")brreturn |
/- -Y)[:6]w,19|;# =" -s@1 - Mdelta(0,	{(m.days h+: //{.1)R2:"if42 =). 
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)'.
QTrue,	3nowz=None):
        "Construct a datetime from 
.() and optional zone info."
 Pt = _27return cls.[#stamp(t, tz)
)@classmethoddef utcnow(cls):k	?UTC;utc	pcombine,,_=True
kqa givenEl*if not isinstance(H0, __@q+raise TypeError("* argument must be W%")ls,s1ss tzB@ is E=m.jR.yearc.monthEday,4UR.hours.minute
csecond
SmicroJq, fold=W
O	zisoformatUw_string)""ahe output ofQ.YF).""OtW, stry%Q':Cstr'@# Split this ae separatorIadstr =e[0:10]!t!B11:]Jh:try7componentseparse_F({except ValuB
U(f'Invalid WEaing: {8!r}0if 
]
Oime_(O:#,CKelse
E[0, GNone*+)^/tuple(self""R4loc( Katible with].&L'()~ dsYV.dst(^0if 0is 
E= -1"el/'&CI0H%`_build%1uct}day,
            self.hour, cminute
second,
;Qdst)
(def _mktime(R!):-	"""Return integer POSIX ,stamp.""".epoch = date"(1970, 1, 1)%max_fold_s = 24 * 3600%At = 1 - VA) //v`delta(VSwlocal(uy, m, d, hh, mm, sp_.2
u(u)[: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"if-p_tzinfo;Non<2s +LRmicroe / 1e6< - _EPOCH).total
(0utcNtupl1UTC & compatible with0.gmG6()." =2utc(#if

3 -=Q5yeaConth5day2	V9F@_buiAQtruct(7, 0Q~? W part*o;'._'_mG_daymtm m,None."
        return time(self.hour, cminute
csecond
TmicroQfold=1
)

    defU!tzW!):#"Rs!he"
 part, with same tzinfo."2/K_n , breplac, year=None, month3day
@
uP >
Pm=True,I*Z"\a new date\values for the specified fields.""v!if@ is h@" ='"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):
f/% = self.replace(tzinfo=None)._local_timezone()
 myoffset = mytz.utcu(self)
1if tz is':Opreturn 10# Convert
 to UTC, and attach the new   object.]autc = 4 - v).repla'tzx@fromu|Qtz's 
oc0tz./sutc(utcO`# Ways?produce a string.Pdef c)""Rt) style<"weekday =$.toordinal() % 7 or 7,@"%s 2d %02d: %04d" % (3_DAYNAMES[m*], RMONTH"{._month&:day=Rhour,t_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#=@not ^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)04offDEtz =F(off!4Srs += tz@s
__repr__
S"tolT, 78().RL = [u # These'never zeroIy__]Hif L[-1]
2del-        s = "%s.%s(%s)" % (self.__class__.__module__,
 
6qualnam8
", ".join(map(str, L)))k2if [tzinfo is not None:%assert s[-1:] == ")"!s = s[:-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&<(	%7dst        retu-rn offset

    # Comparisons of datetime objects with other.3def __eq__(self,!):PTif isinstance(;,X(,preturn IT._cmp/allow_mixed=True) == 0celif notieNotImplementedL&seXFalse/leH?) <WkYerror	tKVgK>ygK>wMW(, S&_asserN)/cmytz =etzinfo!ot+._myoff = ot3Non^t1if Z0is F
abase_c@e = t,eliB.utc(p&# Assume thatBb meanswe are called from q(if@
 !]replace(fold=)JNX2#if!
hi)=q2offf*
(s._year,zTmonth
Mday,bself._hour, self._minute, ssecond,
 'Rmicro,)-(other._year, 
Umonth?day@37hou@OD)if myoff is None or ot:+if allow_mixed return 2 # arbitrary non-zero valuePOelseFaise TypeError("cannot compare naive and awdatetimes"# XXX What fos could be dmore efficiently...adiff =" - # 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 + -4!#n1	!#2 "EsecsC_+]}d * 60 ^! *-gEgFGHbase = timedelta(days1 - O2,
 1sec((lf._microsecond - other)iPif se3tzinfo is/:*return basermyoff =Gutcoffset(c"ot!"3if F!= .v3is None or;C$aise TypeError("cannot mix naive and timezone-aware"# +m-
def __hash__(V)hcode == -1!_%Jfoldtereplace('&=0%Oelse;'"tz/t."2if %eY. (t._getstate()[0] = _ymd2ord@b.year,ZSmonth:daySs%hour * 3600 +Cinute * 65	L	cimedelas	7lf.t2) -9=
07# Pickle support.NG9, protocol=3[yhi, ylo = divmo<_=6256us2, us3++, 21222D	$mt_N_aJ > 3Mm += 128=dB = bytes([3, mtO_day5 _2mC
"us3)x1(,%.c)$_sastring, *]
isinstance(:2, _	g_classgrG3bads 7arg3( )q=f > 127.5= 1/i = m -	K0K	3 = yhi * 256 + ylo
   self._microsecond = (((us1 << 8) | us2)
!3
92   <tzinfo = 	
def __reduce_ex__(-, protocol):'Jqreturn !.__class__,^getstate(:)b_Uu.2)


datetime.min = @(1, )!(ax!9999, 12, 31, 23, 59'99:resolutiobmgdelta(k1s=1,isoweek1monday(year# 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
(D, st
(
)kstring0ot C_min#<=3 <="ax
pVF) "	"ctly between -(hours=24) andJ8.@_creG`J@amethod0cc5.__L#.? rj=!l_getinitargsX"""pickle support""#ifVn!is	.US#eqh, othe)if,!tF=S4NotImplemented> __hash__(seclf):
 return hash(self._offset)
#def __repr__ ;
"""Convert to formal string, 72().Jp>>> tz = timezone.utch35tz)P'date/.4' 
S((delta(hours=-5), 'EST'V6
k"k(U-1, 68400V"&""0if P1 isvz
H`._nameNONoneJ"%s.%s(%r)" % .__class__.__module__,	=@qual?Jc/, },l	/st, tz(92utcG, dt@if isinstance(dt, o) or dt
vraise TypeError(") argument must be aq ""3zS_froml0
8:7B1dst43sBy?utc
if dt.tzinfo1not
&DValu:BCD"is f"OAdt +J\(`>B_max@424, microseconds=-1E_min6-Dfset

    @staticmethod
    def _name_from_offset(delta):"&qif not return 'UTC'/+q < time'(0P:sign = '-8-A = -	SJelsez@+@hours, rest = divmod,&E=1))]mminute:H9'	;seconds =v.Z3cro$&mi)8if 
e (fg{!}{s:02d}:{o\If'.{nV06d}'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	-C=23,gs=59))B/ax1A`_EPOCH>0ateo(1970, 1ptzinfo=utc)

# Some  algebra.  For a dL x, let
#M0 x.x stripped of itsHG!--Bnaiv^.:Po = x), and assuming that doesn't rai@n excion orK CNone1x.dcOdst(]@1x's standary, 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 #2d.=0tz+ preservese5e%b.n + kA	jhow arithmetic!edL Now we can explain tz.fromutc(x).  Let's assume in interesting case
# (meanbthat the various tzinfo methods exist, and don't blow up or return
# None when called).
#
# The function wants to6 a datetime y with !zone tz, equivalent to x.
# x is already in UTC.hBy #3, we e    y.n - y.o = x.n1[1]8The algorithm starts by attach1znH`y.  SoA.n =^J . An it0add@urat&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, leaving
#3k6
@0; rearranging,-=m;E$#40s =s6'y._!On4RHS:d
e computed directly, but Fbcan bewapproximateYry ignore d  at first.  Notekw
# very large, sinc3l offset-ZCof magnitud@lessgn 24 hours.  Fortbson, if yQfirml1std5must
# be 0[it has no consequeBthenCaIn anye new value i  z! +c	"[4Iqhelpfultep backi1loo@[4]  a higher level: simply
# mapp[,0UTCQ@tz'sBndarAis point?Rzz5we have an#imf ar@most(e insecurity herLQ] of daylight.  Picture US Easternconcretenes awall
#8b jumpsE@1:59C3:002allZq~form 2:MM't make good
# sens#en0docUk%an-QclassZider such atbe EDT (bec"after 2") redundant spellof 1:MM EST
# on th e day DST starts.  We want to return the 1:MM E(	pelling because that's
#'donly s# makes sense oM6local wall clock.
#
# In fact, if [5] holds at this point, we do havepstandard-timey`,
# bu9>a bit of proofPfirstve a stronger result#h
# difference betweeLHS 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 +-Bcanc1'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 effeBAz is0z'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 madTrMres _As before, le `comput1e!N@8] (+Pskipp0somnjustifica0for` kindssubstitu severalalready):|7()  replac#Avia 	E@- z'xEw E
EB+OQ<|+ z.n - z.o + z'.o =    cancel x.n
#q- z.n +o7'AzA5?#1 twice|@z.s udusd=
z and z' have same tzinfoLBz'.dLp
#
# So4is UTC-equivalent to x iff 0'= 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 couldd 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.
#3ther=p = -60 S[8]
# (correctly) conclude atd!is6 Bsaid z wa `(else w"he !pe"n)i!!= U(8]<U nd8OeOonly 2 possible valuesW ca]], it follows( that z'.d must be 0 (which it is in the example,
# butreasoning doesn't depend o30 --Ks%re being
# two possible dst() outcomes, one zero anduother non-).  Therefore
# z'in standard time,C!isFPspellrwe wantis case.
#
# Note aga$
not UTC-equivalent as far(hybrid tzinfo class is
# concerned (becausePtakes"as	1 ra1thaW
# daylightp we intx	!),Qreturrit givereal-life "locallock repeats an hour" behavior when mapp/1"un?Pable"
2oz?W7/AinpuI6:MM, z=1:MMRz.d=0we stop at ',y@withT1he 6
wySo how c.is break?  One ofassumptions/violatedQwilities:1) [2] effectively sayZPat y.p invariS	across all y belong to abn
#   @zonewhnHtrue if, for poBcal q@s orNtinental drift   a region decidpo changnPs basfset from7"2)I0 maQ vers!qof "doux"wpQPtail #ofhe analysiss up a step too early.  I have<@thou1abo`"atK en:2sayaIn any, it's cleartbdefaulPutc()0strPPhandl6p"almostqs:  so aQ!ofCmatter if`transi|t pointsy o n, or
#Bis skipped,1ome/ s;P
RlargeL smd@get din its bounds;%it!ev0som50per$e1 us a nega"Sg{
# pretty bizarraD2subGoverridefis.

try:
XMP_date import *
except IRError0pass
elsep# Cleanunused names[del (_DAYNAMES, S_BEFORE_MONTH&INPI100Y I4	JP _DI4@EPOC:MAXORDINAL, ?hbuild_struct_,FQcheck_fields, _2inttime_fields,$
 _check_tzinfo_arg, Enameutc_offset"mpgerror,Odate_class, _days_before_monthDyear#in#Mformat_ti`is_leaisoweek1monday, _mathord2ymd, LSwrap_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.!@from9 te*__doc__

try:(decimal'*Bd
<__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', '	'@   'er','IS_CHARACTER_JUNK<uIS_LINE',
           'unified_diff', '`_bytesSHtmlDMatch']

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 contiguousAD 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 vulnerLLto synchon blockLp lines"aough (Rblank1 inJordinary text filor maybe "
"1R HTML$ at(" b`becaus#isT onlyF3t 1cept* of" Example,`two stspconside DQ|>>> s =2(lambda x: x == " ",0...
"private Thread current;=     "privat
e volatile Thread current;")
    >>>
	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 u,EQ.get_ing_blocks() is handyAfor  Vs8:T .."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!is#ar dMethod__init__(isjunk=None, a='', b=''   Construct aZset_seqs(a, b9"Se5twos!beJaredB>1(a?1 to
@/2(Yfind_longest_match(alo=0, ahi=None, bb3)
 Find longest matching/ck in a[alo:ahi] and b[blo:bhi].
CDget_6_blocks(]Return list of triples describi< subsequences\oopcodeTL5-tuUqhow to |a into bT^ratioa measure5he ' similarity (floatc[0,1])Uoquick_[n upper bound on .* relatively C#lyQQreal_VU7verO2"""
def __init__(self, isjunk%qa='', bAautoaTrue):MConstruct a SM:#er)Optional argg@ is  (the default), or a one-argumentn@funcG that takes a@ ele/rls true iff theH)0is ". is equivalent3@pass"lambda x: 0", i.e.L$noxs are consideredB$bebFor example, YBaxPe" \\t""qif you'^@mpar0linsscharacters,Fdon'@"wasynch up`blanksuhard tabq	a3fir'woYued.  By empty stf.  TheCof a must be hashable.  Sealso .set_seqs()$1(
b@seco}?f tAb2p should"!sePFalsep0dis1	"8Qmatic heuristic"Hreats populara(see module doc@n for more infork6on)#r# MembersE5# ae#$"  bwb++; differ:mputed as "w9,doERwe ne doH0'a'change ivto 'b'?\# b2jJ b,0[x]uah&rdices (!at which x appears;t
cdo not*   # fullbcoSunt
 ##for x in b, fullbcount[x] == the number of times xBqappearsD; only materialized if really needed (usedF8	computing quick_ratio())1matching_blocks`a list(i, j, k) triples, where a[i:i+kb[j:j+k];HPscend& non-overlappin i andj; terminated byH dummy (len(a), b), 0) sentinel4oopcode	tag, i1, i2, j1, j2) tu]tag iDgone ofl0'replace'  1:i2] should be  b[j1:j2]GQdeletFG
`insertb7;Qequal:u%==Ggisjunk@ a user-supplied function taka sequence elementF`return0true iff@2@is "}" -- this hasubtle but helpful effects he algorithmxich I'l>get around to wriPup someday <0.9 wink>.DON'T USE!  O__chain_b&s.  Use "in self.bK[OBitem,  wh is TrueH|popularK0nont O1tre1as !byheuristic (ifEd).
O"= 	
3a ={ = None1utoo3= a
!set_seqs(a, b)zEdef !, :;a"""Set5twos0be %Gared>>> s = SM%6er(9".x"abcd", "bcde"'wE0.75
2"""nV61(aI/2( 1(#O, a)UfirstThe second-Znot chang6/, #(	m/1(e51.0d6>>>d@utes caches detailqPnform7n about the
    #    second sequence, so if you want to compare one( S against
FEmany s, use .set_seq2(S) once and callE1(x)Drepeatedly for each of the other`%.
5See also m1s()gE2().,6"""9if a is self.a:%ereturn#J = amatching_blocks =M`opcodeBNoner4def 2(PF, b)ua"""Set$bedThe first,not change;@>>> SM0er(, "abcd", "bcde"6v.ratio(E0.75#|J,B81.0A1Autescaches detailed informan abouNXV1	bw&.bucWb = b:?lf.Qifullbcount = Y
R__chain_b()4# Felement x in b,9p b2j[x]da listindices i# b where x appears;W(in increasing order; note tha#5anumberkFimesTTBlen(B) ..k#n`isjunk*defined, s don't show up in this+
# map at all, which stopscentral find_longest_s methodDfrom start%
a	2b2j]@does" contain ~1ies"popular" , meaning`2 ac1morvn 1 + 1%lhe totalP$an0whe%0is onably large (>= 200B)Uis ca(e viewed aQ adaptive0ionPsemi-,rQyield,tenormouqspeedupq, e.g., argprogram files with hundreds of"M anBof "w NULL;"&VAonlyS!ed2 b  s;ccross-product
    # kin%ds of matches, it's best to call set_seq2 once, then1
    # repeatedly
def __chain_b(self):/0Because isjunk is a user-defined (not C) function, and we test
Ea# for CSa LOTimportanminimizep number)s.2for&tricks described here, was by farV)mo
time-consuming routine in-whole module!  If anyone seesJim Roskindsank him again profile.py -- I never wouldGhave guessed thatpThe firto build b2j ignorthe possibility`!of.  I.e.,Rdon't:0at Hyet.  ThrowingE!utPlatermuch cheapeh"anw"right"GAfromHGstar@b = %.b-A2j =B= {}W^`i, eltenumerate(b(rindicesD.setdefault(elt, [])o..append(i)qq# PurgeJ element=#&t(_g2lf.|#ifgb2j.keys('> $A.add#xe%: # sepaN loop avoids0ist	JN0del^[elt]=upopular@P are LQR1&= 
(seXn = len(bkfK@autoTn >= 200bn = n // 100 + /`, idxskOitem,A) > ^
qT(ditto; as fast`p1% dele~9^find_longest_P, alo=0, ahi=None, bbX"""Find G@lock%a[alo:ahi]|b[blo:bhi].3By  it will 	ZQentirety|aXOICN:rReturn (i,j,k) so a[i:i+k];PequalWb[j:j+k], w\	`alo <= i +k9ahi#b#jj#b#+\t(i',j',k') meetJthose conditions7,
 yk >= k'ji <= iand if i =0, j$5j'
9In other words, of all maximatching blocks, return one thatHstarts earliest in a, R_thoseXLKy5the} u&b.>>> s = SequenceMatcher(None, " abcd", "
)<.find_longest_m?(0, 5, 0, 9-Y(a=0, b=4, size=5)
If isjunk is defined, first c co5 is`determ8 as above, but withDadditional restricZ5 noIelement appearsr.  Then9extended a0farpossible byx(only) ns on both sides.  SfresultRneverSe=NPxceptyidenticalghns to be adjacto an "inte Bing"\2aHere'sOsame examplemSbefort0conr3ankmHat preventsqR fromz@" aEtailK0end'second s directly.  Instead vU" canJ]eleftmost"m:Wlambda x: x==" ZVc91c0c4c#no^P(alo,G, 0)  ab&c"121-	0 6"""T# CAUTION:   pp`commonBfix or suf
PwouldPincor.f# E.g..#6'ab Y   acL7y"h:if #it's "a" (tied"b").  UNIX(tm) diff does sE, so ends up claiml0 abpchanged7 byQinserC5"cacmiddlea's minunintuitive:I"obvious"
@someeted "ac"Xfront1WinXAplacV"aby paiS#up  # the uniq
ue 'b's and then matching first two 'a's.

 
a, b, b2j, isbjunk = self.a,b$'.__contains__Oif ahi is None:n= len(a)Oif b11b1pbesti, jsize = alo, b0^# find longest R-free'0dur+an iteration of;loop, j2len[j] 0gthXHb@ endXwith a[i-1]Eb[j]6[U = {}1not6= [(for i in range(Jahi)f# look at all instances@a[i]@b; note that because{#q has no5e keys,skipped Xs*	HRget =@I.get!1new$
j 2j7(,1#`]9es b `if j <%
4:inu
9 >=:Ybreak7L<get(j-1, 0) + 17aif k >ri-k+1, j
4 = b# Exte<z by non- elements on each.  In particular,`# "pop"Ccaren't, which greatly speedsJthe innerp above, buso means "&"w so farG@doesvqain anyc *or* .C`while d0i >l@estj!lo\0 W0(b[>_j-1]),a #6== .
DU	j	@+b+(! <8j7' H+= 12Nowwe have a wholly inter#ng(albeit possibly# empty!), wy as well suck upG	D@side]it too.  Caika good reason1to,ip# savest-process8(@ connrable) expense of
    2    # figuring out what to do with it.  In the case of an empty
 ADinterestGmatch, this is clearlyBPright"nge,Dbecause no other kindpQKpossible iregions.Epwhile b > alo andSj > b\0isbjunk(b[:Qj-1])8(a i-1] == .:PD"i,uasize =2i-1j	%+1B+Ja < ahijb3'E+ 1
return M().def get_ing_blocks(self)vB"""RT@listtriples describ	subsequences.hREach 8T!ofform (i, j, n),mmeans thatsa[i:i+nj:j+n].  TheSs are monotonically increas%inKin j.  NewPython 2.5, it's also guaranteed5 ifE(i', j', n')adjacent9?I`second noTe las<%;then i+n != i' orIj j'8MOW, Tnevere UequalHd	s a dummy, (len(a), Sb), 0iee onlyZGn==0d>>> s = S8er(None, "abxcd"	Ecd")R7?(s.)*[Rp(a=0, b6C=2),&0a=3=2, 5450)]~6"""0if 5.JP5bla, lb =_*l
bO3# Tmost naturexpressed arecursive algorithm, bujp# at leone user bumped into extremat exceeded#oon limit oAir box.  So, now we maintain a H('queue`)y1qstill no look at] append parti# results``iaH!p; eXIsortfhe end = [(0, b1   matching_blocks = []
 while queue:alo, ahi, b
Rbhi =(i.pop()-i, j, k = x = self.find_longest_match(S
F# a[alo:i] vs b[blo:j] unknownq+i:i+k] same a0Vj:j+k(T+k:ahUPj+k:bWif k:   # 
 is 0, there was no 0ing)ckp_l.append(x*if alo < i andOJ < j(LG/j)[Pi+k <]j?bhi_3i+kj
7bhicusort()
# It's possible that we have adjacent equal inbBd list now.  Start~with 2.5bis codWaddedLto collaps5em.`i1 = jk0Enon_	,for i2, j2, k2 in
_# Is thisto i1, j1, k1?yif i1 + B= i2*j2d4# Yes, s2 --~just increasee length of}Mthe first by3qsecond,1Mrened remain mpare agtk1 += k2e;els+U# Noto.  Remember(k1==0 means it's^LPdummys0ed )1mak\ 6?theL4new 1nU. Yme>+ (la, lb, 0) =`(map(M, ._W(, XbreturniKdef get_op s(u)KB"""RC]of 5-tuples describeqhow to ka into b.`RQEach 6)"of^orm (tag,/e2).  T[7>0has==u)/sF=lpi2 fromK* preceding it, and likewise for j1 == the previous j2.

 The tags are strings, with5pse mean:4'replace':  a[i1:i2] should be d by b[j1:j2]pa'delet;<%d.0Note that j1==j2 in this case3p'insertSed at&1]=ip_i1==ipQequaloQ 2]u>>> a = "qabxcd"bjabycdfs = SequenceMatcher(None, a, b)Etag, i1, i2, j1, *s.get_opcodes():80...print(("%7s a[%d:%d] (%s) b<" %:>I   (y,&))  a[0:1] (qng0:0] (% b a[1:3] (ab&2y a[3:4] (x'23yN4:6] (cd'23:5N )A a[6(&5
fM6"""if self.d is not n-ireturn-wi = j = 0	T= answer = [Vai, bj, size7m4ing_block'# invariant:  we've pumped out correct diffs to changeCa[:i] into b[:j], andBd next  = is?`ai:ai+<Rbj:bj.  So we needBa!&:aR!],B$
move (i,j) beyo*	Btag = ''if i < aijj < bj@;
B%elD9E8q
8 ifkw.append( , wjz&) !i,"	##{list of&s@terminateNa=sentinel=7f'b'Ij@def `ugrouped[yW, n=3d""" IsolateA clusters'1eliPing r_snosR>a generator=groups with up
 to n lines of context.
 0Each group is in the same format as returned by get_opcodes().
H>>> from pprint import	&a = list(map(str, range(1,40))),b = a[:][8:8] = ['i']# Make an insertion320] += 'x'1$  3 replacement423:2if4Odelee3eyeonotherk4(SequenceMatcher(None,a,b).{&ed1[[('equal', 5, 8R), (''89/8, 11, 9, 12)], SP16, 1"g7, 20)%3 ('E'# 20#K, 21'p!2!K, 23%]Pe', 2"n3&K@7, 3p%631, 34, 2.q#"35Q3!28, T&)]E"""
<$q = self7#qif not *:!("r", 0, 1)r
# Fixup leading and trail
-@s ify show no chpsides[0][0] == H
tag, i1, i2, j1, j2 =&[0L 6Bmax(:2-n)AE%j2/-1&/-1 -17@min(0i1+j6+n)nn = n + W]i2for]YR j2V
O0# Ehe current	start a new one whenever$e# rera largeJ_ with6'ag4i2-i1 > nn2.append((>FRyield	f
POPj1 = 4
!i24c&-n82MG ,j2"ifQ(len(BA)==1
),def ratio(.A"""RT a measure{s' similarity (floatIX[0,1]ypWhere T@total number of elements in both sequences, and
 	M is the number of match(@this2.0*M / T.7Note that %A1 ifIi are identicalwU 0 ifEthey have nothingcommon.
&.ratio()expensive to computex1youIn't alreadyQ.get_ing_blocks() or opcodes(),which case ]5may@wanttry .quick_LZreal_Afirs3eget anJupper bound>>> s = SMr(None, "abcd", "bcde")L6,E0.75
#	).51.06"""_esum(triple[-1] for ^Aselfu0return _calculatef3Alen(IUa) + 2b))Hdef ,():Rc7an D on relativelyJ'lyTtdefined beyond it\is fasterZo	d`# view/a b as multisets, setMcardinalit#their intersection;0cou>=
# without regardoorder, soclearly @0if a.fullbr5%'= 2E= {}R.k5elthbM#qh[elt] Qp(elt, 0X1\	t%# avail[x]
?times x appearq'b' lesDs4we've seen WPn 'a'cfar ... kinda@ Ehas,=.__contains__, FaF"if@0has-X` ffJelseR4j	@W! =6 - L"if>> 0iE% =+?{2
?3(?"""?verznd that it is an upper bound on .ratio(), and
 is faster to compute than either7 or .quick_I.EE"""

la, lb = len(self.a),
%b)*
# can't have more matchesthe number of elements in theE@shorvsequencreturn _calculateBmin(ra + lb)__class_getitem__ = method(GenericAlias)


def get_close_(word, possibilities, n=3, cutoff=0.6):"""Use SM@listbest "good enough"2.yd is a 
 for which 1
 are desired (typically asstring)V	_gs againstl"toi Sd ?hsiOptional arg n (default 3)vwmaximum
!tom<.  n must be > 0	fkmpa floatn[0, 1].  Phpthat do scat leastt similatsignoredAThe 2(no|"n)?es among
PLeAin aY0, sDd byAity V, mosSfirst?>>>"appel", ["ape", l	Ppeachrpuppy"]['apple', 'ape'](\import key3s _#JA"whe,0.kw=lHwhileBA%",n
B;oaccept<0'ex if not n >  0mraise ValueError(": %r" % (n,)Hc0.0 <=:
/1.V
`in [0.5.0]e%j0resg2= [Qand \0J   s+%O.Vnd((s#x)
P# MovB rs*@headO = _nlargest(n, r# StripsnL![x%v!, aP]y_keep_original_ws(s, tag_s
):
    """Replace whitespith the originalcharacters in `s`"""Lreturn ''.join(dc if tag_c == " " and c.isnr() else"5bfor c,hRzip(s!s)&)



class Differrb is a 'T
omparing sequences of lin	Ptext,d`produc.human-readable dr?r deltas. Q usesASeMatcher boZ1o ce}% t#G	within similar (near-mlBing)!.
CAEacha begins N a two-letter code:@@'- '.p unique! 1j"/'+*2* *`commonT)YLX?.not present#0eitcUinputYLn'LpattemptsQguide!eyPintra_were .  Thesecan be confus#hcontain tab 0Not$atmakes no ime a *minimal*ofcrary, %$s are often counter-intuitive, becauhey synchLup anywhpossible, sometimes accidental es 100 pagQpart.HRestrict^p pointseiguousDArvesk notion ofLlocality, at occasio@cost
*na longerkExample: C'@two (s#pFirst wAt uph ,eindividual 0le-] "ng0endb0new ws (suchK=@alsoB ob&ped fromz`=()` method!fiuke objects)1>>>1 = '''  1. BeautifulDbthan ugly...   2. Explicit+"im/@3. Se-8lex,!4.x?lex-ficated1'''.splitkeepends=True6@len(143q[0][-1]A'\n'	2 !3%
$m5. Fla{;nes'.splitlines*(keepends=True)

    Next we instantiate a Differ object:*s>>> d =(@ote that whenG!Thkeyword parameters =bG0- `E`: A$should accepargumentOreturn true iff Q30is k . module-levely+  `IS_LINE_JUNK` \be used toer out lines without visible
 4characters, except for at most one splat ('#').  It is recommended
L2 to leave linejunk None; the underlying SequenceMatcher class hasan adaptive notion of "noise"`s that's bettern any staticLadefiniD`authorp ever been ableucraft.
>0- `#`: A funcJat should ac9Pa strof length 1. Thpmodule-levelM`IS_CHARACTER_JUNK` may be used0fil5out  whitespace  (a blank or tab; **note**: bad ideaRhinclud0new in this!0Usez
.6"""?Pself.Tj=.!! =Cdef compare(*, a, b):?rnC*c two sdss; generate`resultWdeltaEEach@ must contain individual singi"Ps endQnTWs. SuXPs can obZqed fromQ`read()` methoeQof fixke objects. e `d alsoAsist-terminated0s, }ypbe prinas-is viaPwrite%()Jla[rxample:2>>>g(''.join(Differ().
'one\ntwo\nthree\n'.splits(True),0...X	0'orQK?emuP)Rfend=""- zE?  ^
F+ or[	-)!- 6?  V+ treGU+ emu*
AcrunM=_9B8tag, alo, ahi, b
0bhiW.get_opcodes(gif tag == 'replace'!@g = ._fancy_*)(az}e>'ele_deletddump('-'Soinsert
S_+', b_equalR .seL
raise ValueError('unknown%r' % (tag,))

     yield from g

def _dump(self, tag, x, lo, hi):%)+"""Generate comparison results for a same-tagged range."""C$Bi in(cg'%s %s' % (G[i])plain_replace@a, aSahi, b, b
b`assert' < ahi and(e < bhi #  the shorter%ck first -- reduces#burden on-W-termKmemory if-locks are of very different sizes; if  -|-00 = .:'+'T2ksecond2G-', A)2Oelser@r
s'g'", 
'
_fancyr0Whe[ping one cklines with anotherGarch	*similar* <;(est-matchbpair (if any) is used as aJsynch point,PintraR?pce markQ@is d onnE p`. Lots
work, but often worth it.oExample:@>>> CD(/Z= d._
['abcDefghiJkl\n'], 0, 1,0...sAxdefGhijA
print(''.join(), end="",(- ?~0^  +,z,O"#2't up unles<`s have=rity sco"'atH
least cutoff; best_ratio traV?seen so farE5,I = 0.74,5(cruncher = SequenceM!ern.charjunkLeqi, eqj = None,   # 1st indi1of equalZA# sePa that 1!esaout bedenticalD# (im0mus0 c, & weuwant toK"on5$--"we&toj(Xb"Eb[j]`p.set_seq2(bjZ"^=&ai = a[i]
          if ai == bj:

if eqi is None$2eqi, eqj = i, jLcontinuecruncher.set_seq1(ai)&# computing similarityexpensive, so use the quickF$upper bounds first -- have seen this speed up messyFares by a factor of 3.-0notat ratio()Uonly 3 to*eKtime it's called on a sequence pair;ZOpartJ!of( utn`cached
;4if a.real_j_b> bestm and \B2 E@-z,i:(),"if3n < cutoffh# no non-identical "pretty close"	b
SOp eithertreat it astraight replacjyield from self._plain_/(a, alo, ah0, b
/bhireturn, but an -- synch]onaEjt=gU, 1.0~;els#0re'so forget (*nyz=
pB# a[d] veryb0j];R91 ifnvy're no#`pump out diffsRbeforAFpoinJ
fancy_helper4, bf)|do intraline markqe
@aeltFlt =%, 	*	%# a '-', '?+p?' quad0ed s_Uatags = b)""i&s(
for tag, ai1`2, bj1F2 inget_opcodes()`la, lbBi2 -M bj9bj1. ift''S)+= '^' * laK&&b
           elif tag == 'delete':
atags += '-' * la&	LoinsertLbL+LbL_equalK Kq&q/se
raise ValueError('unknown8%r' % (tag,))yield from self._qformat(aelt, b!, ?,el# the synch pair is identicalwp'  ' + k
# pump out diffsXafter_Eoint4
fancy_helper(ast_i+1, ahi, bjBbhi)Ydef _;, a, alo<
7eg = [] if2  Tdump('-'E"+'F
AogWXOqine, bl	`Er"""F@ "?"put and deal with tabs.pExample:>>> d = Differ(results = d'\tabcDefghiJkl\n', rdefGhij0...{`'  ^ ^G

@for C in : print(repr(5...='- C? \t6\n'+55 = _keep_original_ws(a!, !).rstrip|S9!9g@"- "Bf}Jw1Qf"? {F}\n"!"+O|OOO0# Wrespect to junk, an earlier version of n simply refused to
# *start* a matchaM element.  The  was cases like this:
#q beforeAvate Thread current;,g : m,volatil5If you consider whitespace!be,plongest,rtiguousq
# not ing with junk is "e Thread current
".  So ndiff reported
# that4volatil" was inse  between the 't' and%e' in "private".
# While an accurate view, to peoplel's absurd.  The version
# looks for matching blocks@	 are entirely junk-free,n extend*eJ
ngest one of those as farpossible bu$vly withv]7Jow "P2 is+)ed} edpsuck up
# preced@ank;>	KcJmfollowJI;yfinallys-e cfore "Vonly quibbl]`remainipat perhaps itE!re{;2cas4 " u1"
#'lWafterS  I can live.

im. re

def IS_LINE_JUNK(line, pat=re.compile(r"\s*(?:#\s*)?$").a):
    r"""	Return True`ignora(V : A``oblank or contains a single '#'.
SExamples::>>>Q'\n')*v	$o  #   *Uhello)QFalseT	r1pat*)vnot NonNCHARACTERSch, ws=" \t"3character8!ch6pa space8?tab&
/' *(/\t)|)}SxR)R chows


#4I  Unified Diff]29_format_range_ui(start, stop'Convert )@"ed"'Amat'\P# Per k
spec at http://www.unix.org/(s x_(ification/JQbeginb!= @ + 10 # s`number&plength <Bop --Y4if 2= 12R'{}'.(0if (>9&3 -= Rempty0!s % just beiHU,,)unified_diff(a, b, fromfile='', to1dat,
 -  n=3, lineterm='\n'):5Ar"""		Compare two sequences of6s; generate the delta as a unified diff.
KU s U0a c_`ct wayUqshowing] changes and a fewFcontext.  The numberDDs is set by 'n' whichGdefaults to three3By ,@iff S3rolS
(those with ---, +++, or @@)`rcreated&pa trail0newihelpful sat inputsE P.read@s() resul0e`s that suitable forH;Twrite<since bothtj0outU haveFs*3Forzjdo not8 4,$nSargument%""( will bePTormlyS& f0unilmat normally h`headerH3namYmodificationtimes.  Any0allUthese mayBspec uspstrings^C'tB', 'r
~!',m.< expressed inISO 86013matExample:~0>>>8_5B('on four'.split(),9...La'zero 7 rej2 'OriginalCurrent'I2005-01-26 23:30:5062010-04-02 10:20:52BR$='`print( )
# doctest: +NORMALIZE_WHITESPACED--- 5,C+++ ',@@ -1,4 +!@@+R
W	C-two	Q+tree

	_check_types(a, ,)>v*)M@starb= Falstfor groupCSMatcher(None,a,b).get_'ed_opcodes(n[!if,bsb = TruvB = '\t{}'.f t(qE) if" else ''G!toIGEpyield '& {}
nPh^D>B}date, lineterSm)

 first, last = group[0],
7-1]*le1_range = _format_unified(N2[1]QI[2])?2/?3?4?	yield '@@ -{} +{} @@{}'.5(fi , 
k, lineter
or tag, i1, i2, j1, j2 in:% if- == 'equal'#1forhBa[i1:i2]&*A ' +2	j!continue	in {'replace', 'delete'}k-xoinsertx
ob[j1:j	+x?

#4I  Context Diff]2j

def ext(start, stop)'Convert 5to the "ed" 'Q# Perdiff spec at http://www.unix.org/singleo x_(ification/Jbeginning = @ + 1V! #ns`number(rwith onoalength<Bop --Yrif not !Wp#-=i   # empty!s % just befored`V <= 1ereturn 'S_",%,0v- 1)

# Seej_(a, b, fromzt='', to-)Gdate-6n=3S='\n'PAr"""OPCompaAwo sequences of; generatbdelta as a  #.
K' s U'mpact wayU@show, chs and a fewFbr.  The hD is set by 'n' whichGdefaults +3ree3By ,53rolSq(those *** or ---)[rcreated!pa trail0new ishelpful sat inputsEfP.read@s() resul0``s that suitableHd.write<since bothte0outU haveFs%3Forz!do8ailing newli nes, set the lineterm
    argument to "" so tha(
output will be uniformly newDq free.
GThe context diff +	at normally has a header filenames andDmodification times.  Any or all of`se mayspecified usingDqstringsbP'fromgd', 'to
`date',~.HF areexpressed in ISO 8601~2matJuIf not ,+adefaul~cblanksPExample:^>>> print(''.join(l_l('one\ntwo\nthree\nfour\n'.splits(True),0...   'zero\n@: 'OriginalOCurrent')Sqend="")iD*** 6C--- ;*P 1,4 Q  one
T! two
   `<A---- + 	G"reR<2"""n_check_types(a, b, 4", H4o_prefix = dict(insert='+ ', delete='-
replace='!equal='  'Fstarted = Falsfor groupSequenceMatcher(None,a,b).get_'ed_opcodes(n):B  ifb"w>3 = '\t{}'.(k)^ else ''K to,
IjGEpyield 'r {}
P,^DEB}@first, last =C[0],
5-1]*g5' +J1_range = _d_(z2[1]}6[2]k1 {}R\if any(tagb#{' '}u tag, _-qe"or+bi1, i20-
y0 if/R != '7'$(tKa[i1:i2]*.S[tag]w
s2cs3s4sE s\ss   for tag, 	_, _, j1, j2 in group:
 if tag != 'delete'$3for lineKb[j1:j2]*.yield prefix[tag] +>

def _check_types(a, b, *args)Q0# C Aing # is weird, but the alternativegarbled output when8# someone passes mixed bytes and str to {unified,context}_diff(). E.g.
q# witho1is ,WpfilenamVs_presults0Clike  --- b'old;U.txt'+++ b'newbecause of how.format() incorporarobjectsAif anot isinstance(a[0],K}raise TypeError('s)compare must be8 , R%s (%r)' %F(p@).__.@__, !))5Oif bb\p0arg!ifY,rgX)
\all argumentsY: %r' % (arg,))@_(dfunc, E@from4=b'', to_~)Hdate-An=3,term=b'\n'!Ar"""PC1`a``b`, two sequences;represented a"QatherL@thanM`. Thisa wrapper t``, which typically eiGC or . Inputs losslessly&0ver!tostrings so that  only haworry ab0,	qencodedI@back9 on returnnecessary&_sqEpunknownnsistent iing. All o" i(except `n`)ULr{w de(86try3 s.-'ascii', 'surrogateescape'=4Attributa:err^msg = (' {vsspPmsg) #2 era = list(map(3, aGbbG2 = 8(*"(4date = decode(tofiledate)
    lineterm = decode(%)
!sfunc(a, b, fromGB, toY%n,dr1for1 in!s:hQyield1.en'ascii', 'surrogateescape')

def ndiffjunk=None, charIS_CHARACTER_JUNK)sAr"""|8Compare `a` and `b` (lists of strings); return a `Differ`-style delta.
LOptional keyword paramd4s `g ` ~afilterIpKs, or can be :-)D: A .
 that should accept a single argumentk true iff th.0is e.  The default is,D5 isGcommended;D!underlying SequenceMatcher class has an adaptiveH no}q"noise"sc-1s a$racter (Oclengthf"1))s ?
E*module-level
w, which Ss outEwhitespaces (a blanktab; note: it'bad idea toFinclude newiacthis!)8Tools/scripts/:0.py a Aand-9front-end to CJsExample@>>> # =
'one\ntwo\nthree\n'.split^s(keepends=True),0...0'orD>?emuC
Yprint(''.join(), end=""%B- onfA?  ^{K+ orB- twV!- )A?  -	R+ tre3Q+ emuMN "NFjunk2).co _m(G$D	scontextPy4
xRs generator tmarked up/to side by erAG  - stpKWo9t9 be<k!>`numberye|display on each!ofN$if%ll@willM1ed.s`passedu"toS (see1doca={EThiss an iterator which returns a tuple:
    (from lineI, toboolean flag)
43/'Q -- (ECnum,@Aext)0h*"integer or None (to indicate a context separationG-- originalp with following markers insertedP'\0+''s start of added f/-/_delet1^1_chang1105end/e/<SOsNe, TruersFeither ""B"to"]!ai=0, o-wise False.This func/iterator wasly developPo gen&e side byfile difference for makHTML pages (see HtmlDiff class*qexampleJcusage)xNote, t utilizes the ntY/Kpup.  Op#alMarguments may be passL7@ andPy in Z will5.71"""import re# regular expressionfng intrae_re = re.compile(r'(\++|\-+|\^+)'P# cret
$o4_%s_4=;2,tojunk,char	def _makeK s,mat_key,[Q, num"s=[0,0])C"""R'eXruser's \!up+formattinggSs1lis\b ork`produc	,1 ofMD.  When 4]8R
H	-0s uare removed ^#i/M3'+'Wb first-0in 55U"add"-^roundZaentireKx/'-x2{??{3add:  (ces obtainasecond	NLrt line in list with no markup
 %side -- indice into the num_lines list (0=from,1=to)=%0--  /to current >Gber.  This is NOTeended to be aPpassed parametE ItC@presaas a keyword argum/toOmaintain memory ofs between callsO?is function.
(pNote, turposefully not defined atmodule scope sthat data it needsk@ itsg(in whose context it$iswa) doesUGof m.95"""[>e] += 1# Handle case wherewCuser|
dded, just return6'ofO D'pne form9po allowd usageN if)pmat_keyUNone:y(,Ps.pop(0)[2:]
 of ra0v changeC
j== '?',)Qers =w,	n# findzs (storeq type a)s in tuplessub_info = []idef record_%(match_object,=	)_.append([B.group(1)[0],gspan()zL	-F	_re.sub(,+er# process each. inserting our special!s won't be~#niced by an xml/html escapern0for,(begin,end)reversed(`E0 = 1[0:@]+'\0'+key+@:end"1'Jend:,J2
add/delete entire;elshZ'W2A# ifHs.Pa new<,p a spac:NFre iwL`someth[Qhighlight:see ifO<' '$N`X\0' ++f + '\1|3# RIine of text, first allow user's line formatter to do its
 # thing (such as add2the=number) then replace
 specialJmarks with what&pchange "5up.4return (num_s[side],text)
'Adef _iterator():"""Yields from/toPs of D#a indication.]CThis funct is an kP.  It0elf pullRn% adifferenc;=, processesrm and ythem.  WUeit canL$it%both a "">aa "to", otherwise it will8E oneM or{+n"to09oJA,boolean flag( edUYAe ifp;v(s) hav*Pes in-mPNote,

purposefully not defined emodule scope sot@data"3nee'v parent(in whose con%itM$iswa) doesU besm5"""EU = []blanks_pen}', 1to_iu = 0, 07while True# Load up next 4ps so weh look ahead, create strings whichbNPare aQcaten=2p`charac^tof each{Pdo some very readablzmparisonsCAlen(EZ) < 4&0.apK((rAsBy, 'X'))s = ''.join([F0[0]:@*s]5if s.starts?(W#bno morWs, pump out an@mainu&th<# correspo/c/delet\ get a matcSJ#2qa pairs>saIj level@9ingn-el;W-?+?'\# simple intra	Q*a _make),'?',0),11),E
M:inu~?-++3in `block,  coming:do NOT wantI&ger# caught6on s yet, just process the delete line
 num_blanks_pending -= 1(yield _make_I(s,'-',0), None, Trubkcontinelif s.startswith(('--?+', '--] ')):D# inblock and see an intra change or und# coming: 1^Rthen &
Afrom1,to/ ='
B1to_,.= I-1,0PX_'-+?'H
-	I'_?',1)+':"'?
/^uOFROMyzdO'+--qin add g,u5we do NOT want to getJ# caught up oKs yet, just prw
J6+/'+/@('+ /+-will be leavWaMmTb c
6	c+c+?1sidFUfv/' SStext,:iPboth sA[:],<0),1),Fals[    # Catch up on the blank lines so when we yield!next from/to
 p# pair,%Qy areEYd up.'while(num_kRs_to_^Y< 0):,^*M+= 1)ENone,('','\n'),True*>-z
if s.startswith('X'ireturnNelse_2,tox@Adef __iterator(v@"""Ys`s of t a change indication.
bThis funct is an k.  It itself pulls`.K	7s difference@ thaMjtKbalways1s ay2/to81s (D)f necessary it will collect singl^YHPuntil3 hamatching2 to_@NoteYepurposefully not defined atXmodule scope s3@dataBneedv parentin whose con%it$iswa) doesU bepm
5"""E,# =%())*-As,toe=[],[]  
-2# Ct9we have agX\U(len()==0 or ^::tryL$, p found_0 = r("Aexcept StopI?iono\A!ifWOEs.append(=,)$ifePca0# O(, removem
rion andr 8aDiff =Zpop(0.<?zo$orJ)n# Handle casevre user|Ewant?ing, just
    # them up without doing anyth	Pelse  them.
    line_pair_iterator = _!()/if context is None:Kyield fromV&# Handle cahere user wantsZdifferencing.  We musS someJstorage ofns until we know for sure that0y aQo be "edA+= 1js_to_write = 0while Tru	3t# Storepufind a ae, not	a[Gcircular queue becau=e only need to keep around whatF"we*edindex,PLines0, [3]*(62fp_r = Fals(%"is&)q(>tryQC, to	Sp= next(

J`except!pI?iontireturnDAAi = )$ %*
$(B[i] = (c	~1# Ybswe have collected so far, but first	#yq's sepaf>*G,	k>#	)
7
;	9'	~
Cya
|	&
( -^ R# NowP?RafterJhange[=-b`#@ N# If another c"ind, extend
[O6if #++M
$!?	# Catch .ion from next() and return normally
  H


_file_template = """


<&Aead>`%(2s)s&/Q>
q!
_EsA=.diff {font-family:Courier; border:medium;}=4_	er {background-color:#e00*td26-align:right*(OnextX c0.?add-laaffaa-?chg-lffff77-?sub-Raaaa}ZE%< class="fB" id
lib_chg_%(prefix)s_topb cellspacing="0"Dpaddprules="yBps" x1col5>
r2d7E="" hCgP Added @ChangedABsub">DeletB !(f)irst?nge @>(n)cC7Ot)op/ /{Z HtmlDiff(object):u"""For produC Pside by comparison wi ` highl1s. KThis class can be used to create an HTML table (or a completefile containing the2`) showa side byQ, linRaarisonJof text with inter-'0and"rachange highlights. Tz2 caMbe generate> either full or extual difference mode. RBfoll methods are provided for iBion:=Rmake_<%--s.7Angle<~Ac @1 -O PSee tools/scripts/1.py`an exap usage his class.B2"""_`_templ**= -_styles =  ; &`legend< default_prefix = 0def __init__(self,tabsize=8,wrapcolumn=None,NBjunkXAchar IS_CHARACTER_JUNK):."""HtmlDiff insta9rializerTArguments=tab stop spacing, s8vG7 number whereUpbroken 27Eped,Lc ACnot :8,!keyword a@ pasF`into n`A() (Y)by@ ()>e?./Irs). Sewi1docmRationXq values"de3ionLK.L =  +=8 &@! =c "Y$= H P fromSSs, to 0='' gext=False,ICa=5, *,~set='utf-8'dReturn!il)  `@list""9s (,to&: 'G  header string[3R1Qe0setATrue f8s (~QwhichBs +"nuy$of0u. When0is True, 6 controls number of lines displayed before and after the change. AWhenQext is False,c8 gto place G a`"next"k anchorsHd (so click ofHDjumps to justJE)charset -- !ofHTML documentjE""" return (self._file_template % dict(,rstyles=/ ,!clegend! !Rtable Qmake_Q(fromC, to @desc i Cext=,(O2=nua)>=c)).encode(`, 'xml QrefreX').de%)Z@def @_new~_0g,#s,%):wA"""R s '0/toS e lists with tabs expandedfs removed.pInstead(1tab!AacteCing Ad by3espaces0neeoto fill in\stop, this function w,1H3[@. T@is done so thatdifferen|algorithms can identifyQ@ngesa0e w98aresOvice versa. A~"enD1he V`generaeK$ebra nonbreak  {IO s(7.#P# hidb"alJ2! =E.(' ','\0')*#U</toP W.',2kAdef $@per(=v,diffs)6A"""Rms iteratL"at90s (@s) m9rsF# pull from/to Qflags@c:731,to6@ in rsq# check s and pass them through if flag is None:(yield fromdata,to4 +continue(;Pline, text),(to!to, =` B# for each'@/to > split it at the wrap column to5mHlist of vD)s."$,st = [],[]$aself._|_!st c)9 el3ne,  3&# ~ in pairs inserting blank; asCnecessary when one side has mor82ped@ =QwhileuB or &G0rom'G[:)j.pop(0%+?elsE~('',' '>/ifC# =%A 2^def _collectC s(Uv,diffs)?B"""C&0s m output into separate K!s Z0Bef@stor==ECa<,Cis convertedKhpa singlh%ne=with HTML markupH6"""t,8,7Z]a# pulln1andsstyle iterator%pu@ in >sZ(:try # 8eht!tom j@q.appendr._forma!(0 ,**),C1C Aexcept TypeError$ions occur+# re deors goi@ $Fareturnk HjQeO*@num, `R_s"" / "to".o]P -- 01 indica<&or=:6/Qes iference on03 number (used; -- line text to be marked up 5""" Etry: linenum = '%d' %  % id id="%s%s"((self._prefix[side],<)=except TypeError|# handle blankzqs where is '>' or ''V# replace thosings that would get confused with HTML symbols]Ptext=.Q("&","&")>)gt<l P# make sp non-breakable so they don'tPmpres!or wrappedP0 = ' ',' ').rstrip()return '! nos"=""5' \ % (id,tPdef _,) """Create unique anchor M esmp# Gener.a0Hmultiple tZ# can exist onoR sameApage "ouelicts.z0fropfix = " %d_" % HtmlDiff._default:"to8/to6WU += 1\u# store-y format method has acces @ = [,]5convert_flags,2qlist,to 0con@,nums`Makes ) of "next"k4all names willgqd using<C"to" $8 = #[1P# pro  change 3s, kf0mid`columnfs/link]_['']*len(Q%@href'um_chg, in_= 0, Falselast = 0`for i,v@ in 7!if 6not}"&6TruiA# at`beginnrCof a, drop anq` a few7evG`# (the)P) bef.!orvpreviouMi = max([0,i-]Uid[i]Bz0libb_%s_%dOCP 3ing of a change, drop a link to the next # changenum_chg += 1!ext_href[last] = 'n' % (Otoprefix,~)+Yelse:52in_v = Falseck for cases wherere is no content,avoid exceptionsjif not flaglistA = []8}0_id/''0TI = 0M"ifxi@fromM`%s' + \F;'64\n'7for i in r[P(len(*))B!ifp[i] is D $!# Fb yield% on sepaKAskip.bogus oneG# ed`/Qfirstc+if i > 0s.append(k \n<6\n'XZ 0% (b_id[i]LV . JPEfst[i])romdesc or to header_rown i"%s"
;.>'5olspan="2"A2er" h>w%J <<[J'Utable6`_templ j% dictTdata_rows=''.join(s), header_row= #prefix=self._ U[1]) H)return table.replace('\0+',''). \A' A-A?subA^A?chgA1@/t',' ') del re f restore(delta, which):Ar""" Generate one of the two sequences that g'Ad a O.Given a `` produced by `Differ.compare()` or `n()`, extractlines originating from file 182 (parameter ``), stripp0@off FO3#esExamples:@>>> 2 = 'one\ntwo\nthree\n'.splitQs(keepends=True9...C@ 'orD>?emuC )Plist(print(''.Diff, 1)), end=""11oneS2two eK 2KrK"re 1emuJ32tryE tag = {1: "- ", 2: "+ "}[!)]>except KeyErrorBraise Value('unknowni choice (must ba): %r'Z%IN"` = (" 2tagE1forB# i|i\@[:2]E!QyieldBB[2:]c_test(vimport doc,1lib.!1modlib) if __name__ == "__main__"i """DisassemblerPython byte code into mnemonics. 4sys Etype collectionAio "opV*__all__ as _/s$ @= ["F_info", "dis#tb 9co"5Q"findAtart>AabelPshow_e 8get_instru`IAByte::] +q AhavehdF.MethodType, 1FunnACodeSmCDaticM ) FORMAT_VALUE = opmap[')']%_CONVERTERSq(%C, ''(str, 'str0repascii, ''), ) MAKE_FUNCTION = opmap['MAKE_FUNC9']  _FLAGS = ('defaults', 'kwannotation0closure') def _try_compile(source, name): """Attempts to * the given 4 first as an expression andH 4n! statement if =pproach fails. 9Utility funcaccept strings ins that otherwiseFexpect code objects1"""2tryCc = , 'eval')3!exSyntaxErrorB3xecBreturn cdis(x=None, *, fileQdepth Disassemble cl s, methods,,ddWith no argu7, d\last traceback7C7N currently include generatorrv, asyncIcoroutin, all of which store7(irIin a special attribute.if x is hadistb(s B@# Ext^T fromvh`if has}p(x, '__3__'Tdx = x. \xdsh/..bb # ...aA, or`w/+el0gi_a'): #K S5R+agRynchronous $`C`+cr` B/+H# PerformKy5 e__dictdCp or moduld items = sorted(8.&()X1fori@, x1!if isinstance(x1, _haveN+vprint("y5c%s:" %k=: 1<", IAType:msg]Sorry:", msgj]0 !co$6# C{__recursive[h, (bytes, array)): # RawKu1sqe=file) elif isinstance(x, str): # Source code _disassemble_str3Pfile=, depth=)4Qelse: >raise TypeError("don't know how to ` %s objects" %EItype(x).__name__) defItb(tb=None, *, )F"""D a traceback (default: lastQ)."""if tb is _P6try b = sys.I_bD except Attribut C6bRuntim K("no <q") fromlwhile tb.tb_next:=*(,frame.f_ ,/iTY) # The inspect modul terrogates this dictionary build its # list of CO_* co`ts. Itialso used by pretty_flags to # turn th0fie[nto a human readablek . COMPILER_FLAG_NAMES = { 1: "OPTIMIZED",2: "NEWLOCALS4: "VARARG8tKEYWORD!16?%STQ3QGENERATORQ6QbNOFREE 12PCOROUTIN 25NITERABLE_ 51ZhASYNC_`}@(F!ReL# representa 4zas = []'for i in range(32]9q = 1<") # By now, if we don't have a code object, cadisassemble x.Fif hasattr(x, 'co_;1'):hreturn xraise TypeError("vknow how to e#%sAs" %ARtype(x).__name__) defs_info(x"""Formatted details of methods, functions, orAA."""u!_fA]B_get,3(x),#colines = []].append("Name:0 %a co.co 7@File;7f;Argument countA;1arg;@Posi3al-only aK)s:0posJ /KwB /kwA `Number{locals:8Stack sizxs<@Flagk<pretty_f ( )Fifconsts- CSants:hfor i_c in enumeratecNg, S%4d: %r" %E BnI;i_n1varBPVaria& U'freevar"cFree v+U'Ocell OCellU,"\n".join(Ashow0(co, *, S=Noneh"""Print0*D1*. M2If  is not provided, the outputpfed on stdout(3co)n) _Instru2 = colle s.dtuple("'!",@ "op#0 op`50val0repfset starts_A is_jump_target".S.__doc__ = "Human readable name for operation" _Instruc .opcode.__doc__ = "Numeric _ for ;?arg8argument to; (if any), otherwise NonehargvalWResolved arg valueLYknownNpsame as(UHreprVHuman readable descrip7 of RhoffsetQStart indexBwithin byteR|sequencs@Ys_linQLine ed by this Sis_jump_targrTrue if*sHhere False" _OPNAME_WIDTH = 205ARG5 class g(t): """Detailsfa#q ) Defined fields@D@ opn:- h K ??- n-v*" Fval - r G D" -VD0 - NL ? - L2""".def _disassemble(self, no_width=3, mark_as_current=", '4j"""Forma>' dinclusion in y outputK*1* sets the = $2ber (0 omits it)L * inserts a '-->'er arrowp!ofreKi;,FU = [] # Column: Sourcew*)if .ais notV -b`no_fmt%%%dd" %bz0.append(B,% }9Nelse OY' ' *D%Ceicator!if~ fields.append('-->') Uelse:8fie/7 / # Column: Jump target markerFif self.is_jump_&f >Instruction offset from start of code sequence Qrepr(C).rjust(v_width)@!Op_?nam[Vp"!.lU_OPNAME_WIDTHV argumentdarg is not Non 4argm_OPARG   details.i ! gR'(' +'0arg2W + ')return ' '.join(@).rstrip() def get_is(x, *, first_line=)"""Iterator for the os in methods, funGAs or6 0Gen=es a seriesVwd tuples givinge21 ofIpeach opM1ion|supplieds.tFIf **, it indicatesh` numbeat shouldube reportedZ source =!inIdisassemblOtherwise,& 9Qforma~(if any)taken directly f object."1"""`co = _b_#"(xPcell_ws = co.co_cvars +@freeN1dict(find3(co'ifGf7_( =.-{&!no~ p?0"rs_bytes(Code,c1var LL`nsts, 7J, %,I)@cons4fo( 0dexFlist@Helpo0 opH$alkq about F` refers#A R5%de!Jnstant and itsAr ifOaVrdefined5  h>)exa"()<aargvalQindexXi{c <)[{_G]H ,,(argval) def _get_name_info( Qdex, #list): """Helper to get optional details about8d references > Returns the de!d2 as both value anCQpr if0H is defined.Otherwise rj:a indexUits repr()81"""@argval =_0"ifunot None :([tD]E'x2 = 1:elsJ#(());,#S depinstrucs_bytes(code, var s= constantj Ccell" linestar3_offset=0*Iterate ov08he ` in a string.(1Gen:s a sequCV of Idtuples giving$qof each opcp. Addi0al 0rma('s runtime environmentIP(e.g.LQiable5s, A) can be specified us%E@arguRs}labels = find p_{! =}MBfor yA, opY_unpack_oparg!ifSE' szT.get(uP32if (:?is _,)!+=H#is_jump_tarp=%*+@0arg&U = ''+ if>`# Set$#to[oU whene~# avail0,|UResento2valJ#_disassembleR needSO1 0'1not+"F==5- 1Pfor x = ifattr(x, 'Zode')&g@prin'le!>y of %r:" % (x,)/:hx5,=/#de)&r, names )constant'3,D b_#=0]# Omit theU number column entirely if we have no*cAshowAno =#l4is 4)7if ,0max?@max( C.values()) +ZO36if >g>= 100"Mno_widthuen(str(6+;elsg =3x 'lineno_width = 0 maxoffset = len(code) - 2'if!>= 10000:=:c_width@Estr(T!))+Oelse54#for insta _get_uctions_bytes, varnames, @constants, cells, linestarts,G5_= )new_source_! = (show ono andn .3 is not None=B > 0;if  print(file=9s_curren" =.f== lastiJ_disassemble( "no0;, iX", Q )X def Z_wr, **kwargs"""Compile the & string,'n   object.""" orecursive(_try_c`(\, '') disco =mx # XXX For bac0ds aatibility unpack_opextended_arg =a in range(0,3, 2:Aop =1[i]if op >= HAVE_ARGUMENT@n;[i+1] | KO;b<< 8) i== EXTENDEDm A? PA= hyield (i, op, arg)8findlabelP"""Detect alls/ a | which are jump targets. taReturn?tlist ofG!I}B = [`y_ if Hin hasjrelB# =` + 2 +T!)elI?absI;arg<Ncontinue+2if "in ks.append(3r}s q"""Findy(EGenerate pairs (T]no) as describedpPython/Sile.cG p_increments.co_lnotab[0::2;+ 1+Vcode_len = len(code.co_ ) lastlineno = None*24fir(!addr = 0 for byte_incr, O in zip(gements"!):G&ifJYWno != %)pyield (j5no)`! X $>6 += 1if !>!%N_len # The rest of the lnotabX offsets are past!iend ofo#JnA, sos were optimized away.Bereturn'ifz>= 0x80#! is an array8-bit signed integersa -b"101 nod%; class Byte 0"""5 operationspa piece 3 Instantiate this with a func:, method, other compiled object, stringYp, or a &R (as Ted byFC()).tI2vers0as !ru! i2ces 1"""^ def __init__(self, x, *, _=, current_;.pobj = c>A_get[_ &(xx'ifbHe SV{,0Oelse` m7Y+_ - co;cell_namesdvars +>0reez;Pstart;dict(findF(co)V4originalwJ = xV  s3term` s s_"s(*5,1var PP nsG_[n,G9V93n=ERI?repI/"{}({!r})".format1.__A__._/__ @classmethod  def from_traceback(cls, tb):  """ Construct a Bytecode: the given DE """>while tb.tb_nextX_Gtb =6return cls(;frame.f_y, current_offset=#qlasti) Dinfo(selfR[formatted ( ion abouti object._@_Bj.67obj1dis"a Gqview of}bcoperationsPco = qQ#if " is not NoneBN 6U?els7%-1& with io.StringIO() as outpu_disassemble_qs(co.coN, varnames=,j5 0, c4antLsJacells=a_ _O linestart<s+y>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"49q) if _~__ == "__main__"~ # Module doc. # Releasedpublic doB 16-Jan-2001, by Tim Peters (tim@python.org)MMajor enhances and refactoa by: #Jim FultonEdward L& # Provided as-is; use at your own risk; no warranty promises; enjoy! r"""0 --u.@work` running exa@s in(ss. In s st, end each mVMD0be [0ed :[ .: moU Thenas a script will ca@"sthe docget executed anVd verified: python M.py This won't display anything unless an example fails, in which case the fail3e)(s) and the cause!of+!urare printed to stdout (why notqerr? beD is a lame hack <0.2 wink>),ufinal line of output9Q"Tested.". Run it with-v switch instea1P -v a detailed reporth4all+ps triedt , along uPassorsummaries atend. You can forcebose mode by passx@"ver`=True"Mtestmod, or prohibit it5False". In either thjcases, sys.argv@not @inedPk.N@ere 0a v tyJoS@waysprun doc6sL@cludrgration>@unit* framework1supvfor runnARnon-Ptext files contai!vU. Thlso many override parts of 's default behaviors. Se Library Reference Manual /s. """ __docformat__ = 'reStructuredText en''1all![ # 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. E` & DocKeE'@# 3./bParser6'-4-KFind--5-KRunn--!'OtCheckertFailureUnexpectedExceTYDebugYP# 6.  1'4mod:0runpstring_PCplesd# 7. US 7ESuityDocFileDset_>!_rb18. g< cscript_fromUsourc}dC_src'', ] im@__fu$__tdifflib0insqTcache$os %pd5r%sy traceback import unit test from io import StringIOcollections! namedtuple TestResults = '('^', 'failed attempted') # There are 4 basic classes: # - Example: a pair, plus an intra-docst line number.J0DocJR of ecs, parsed 4a dM,fF info about w6the*R came@( b, file :no)Finder: extracts sEa given object'sj3andts contained*&s'*sr@Runnr5runn cases, and accumulates statisticD` # So picture i plist of!+-++?--- R+ # |C| --1ID-> |C rC| # ol | n| ... )) Je Op&!stants. OPTIONFLAGS_BY_NAME = {} def register_o9Aflag0): # Create a new  unless `` is already known.8return {.setdefaulti, 1 << len(. )) DONT_ACCEPT_TRUE_FOR_1 ='.)')GBLANKLIN  F-') NORMALIZE_WHITESPACD,') ELLIPSIS ') SKIP'') IGNORE_EXION_DETAIL6/COMPARISON_,O = (M! | -4,+) REPORT_UDIFF+$$')3C3$3N3$3ONLY_FIRST_FAILURe1') FAIL_FAST = reg#ister_optionflag('FAIL_FAST') REPORTING_FLAGS = (_UDIFF | "C"N"ONLY_FIRST_?UREs) # Special string markers for use in `want`! s: BLANKLINE_MARKER = '<>' ELLIPSIS ...' #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 particularE- If%"a 2,#n / 5H5D and@1theL!!at[Wx0all}L=0 T ssumed to be5 ofVstack frame at){X&0cal82ackxPif in}Bt.is} el9sinstanc>str8"__\#__[,als(), loc R["*"]`p P Bsys.# s[ _getframe(depth).f_globals['__name__']] else: Braise TypeError("Expected a module, string, or None") def _newline_convert(data)[# We have two cases to cover and we needmake sure!do# them in right orderCfor }#('\r\n', '\r')pdata = .replace(7,1n')Nareturn'load_testfile(C, package,_relative, encoding~,if#E = _normalize_k(2, 31'xV_path5*<if getattr&0'__aer__',) is not }hif hasA.?p, 'get_`w8ttents =>A.?dB F .decode(7#() opens B s as 'rb', so one must dopequivalentPc@sionDuniversals would do.=j 9*!),rAAwith%o=fjxf.read(Sindent(s, #=41"""v1Add given number of space characterthe beginning ofAevery non-blank *A`s`,=bresult0# This regexp matchDhe start ]sWre.sub('(?m)^(?!$)'0*'  exception_traceback(exc_infoR*aq contai%a > message DX tuple (a~ed by sys.{<())OGet h'excout = S2IO(LP`type, 2val Atb =u.print_C={o value() # Override some methods. class _SpoofOut(t2getQCselfB{*)# If anythat all was written, rthere'stWilingGIC. T'eno wayeI`outputindicateG th=aFrmissing3if B.endswith("\n")7: result += "\n"rreturn  def truncate(self, size=None)U`.seek();pStringIO.D ) # Worst-case linear-time ellipsis matching. __(want, got""" Essentially the only subtle lL>>> R'aa...aa', 'aaa'QFalseb if ELLIPSIS_MARKER not in `M0 ==R# Find "qreal" s%!s.gAws =J{.split(lassert len(ws) >= 2]Deal with exactGes possibly needed at one or bo-#ndstartpos, endpo!0,knAs[0]if w: # ;s~& if.'#(wuUdel wxFelsesww,-1?end%!-=wt $"ifC>1# E5endrequired more characters than we have, as inc#, OBQ# For\Prest,eeXP to f leftmost non-overlappingF for each piece. If\re's no 72allt way alone,I?the/bperiodWhwsRw may be ''Cs, i aUonsecutivaes, or~#P# due&an ate@of ``. That's OKHaSearchLCmpty succeeds, and doesn't changef#poLH@got.5(w,){6< 0$N c+-RTrue comment_(""Rp#a " ed1m oa given;! = .r5"p(!ifP'# '+6 #'Q_exception_details(msg# Support IGNORE_EXCEPTION_DETAIL# Get rid`everyt _ ion name;particular, drop#.Adottdule path (if any)z[on message (:if # any). We assume that a colon is never part of a dotted name, ornMexception .E.g., give( "foo.bar.MyError: la di da"7return "!Or for "abc.def" T:\n" 8!. M start, end = 0, len(msg)j# The  must appear on the first linei = msg.find("\n"Oif i >= 0:^fxi#ain up toYq1(if, b@':',?endij br/'.cKa = i+1BnAmsg[:f] class _OutputRedirectingPdb(pdb.Pdb)""""A specialized versI!of$python debuggerrWs stdoutBto am stream when interaQ withVuser. S>Q*not*G\"ed@traced code)executed def __init__(self, out .__out =k@_useUFalse% # do not play signal games i5pdb.f.+=out, nosigint=TrueV# still use input()0getrhquse_raw.B = 1xAset_=frame=None h1if <?>= sys._get().f_backE)continue# Calling F& uncondi ally would break unit tes# coverage repor, as Bdb.XQcalls2setJ){L1if )__A !^_dispatchy, *argsw`uRsave_u   2elf! oq Pdb's  c metho :tryrE?p0fin H  # [XX] Norm^ retos.path.pardir? _module_relative_"(,)v!if!inT2.is)0%raise TypeTp('Expeca module: %r' % module) if test_path.startswith('/'):"&raise ValueError('MD-relative files may not have absolute \As') O# Normalize th . On Windows, replace "/" Q "\".<` = os.X.join(*(a.split)sAFindnbase directory forJcif hasattr('P, '__(__Q# A n (/packageF4k7dir/.UA)[0]4CelifL.__name__ ==vmain__'# An interacrsession'~if len(sys.argv)>0 and [0] != 'T670Felse Bccurdir*f fR&in$0 20ull{&F,6%if\exists(fP-treturn &$m(T w/o  (this includes builtins o"Can't resolv4%s |!tok"p `"%r (i6s n)3%oTbCombinWj) :9dir/ #2 ## 2. Example & DocTest_8-""eb " is a parwhere ") fragment of a code,"C.Nexpected outputDWu." Theclass alsol0inftion abou 2 e.pwas ext`ed from. ##p- A "doca collecU3of s, typicallyKG a string (such as an object's doc"). GH K  Q'N"""A single, consist C. `d` defines`followIvtibutes:E-%: Python state:, always endF3a newlinez The constructor adds a newline if needed. 2- want: The expected output from running the source code (either F" -stdout, z traceback in case of exception). `|c` endsg withunless it's empty,NRwhichT"anFstring. oconstrtexc_msg message genera'!byexample, if.6 isZ%to@ ;3h`None`G it>?notBkis compared againstreturn valu8`.format__only()`/DyLD"no q number!inDocTest p contaiYbthis Ea where9abegins8is fizero-based,}@ resF1 toMEvFindeL2's a+;.QI.e.,n`of spaharacters that preced>p's firs$Gomptos: A dicary mapp%#` flags TrKrFalse, pis used(override default I`s for  c. Any'p"ed,'isDare left a%irw@(as bified =Runner's$ByMC, no s s2set1"""Odef __init__(self,Z,,%=,z@no=0*1=0,Gz93%): 0# Nlize inputs4X#ot{.|W('\n'B*0+= ]!ifP and H ! FCUX $ [# Store propertiex.==  Cno = # =%if0is :E= {})|$ =$ =+def __eq__(self, other): if type(self) is not *1return NotImplemented ML.source ==sUand \1T1 1Fwant/-flineno/1Hinde`1voptionsc3vexc_msg3!def __hash__o9(/,  ,OVU)) class DocTest{1"""<A collec 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 i40ifyI (typically,55 ofY,object whoseQ2strGi was extracted from)@fileZ \OW, or `None` 0he D^wunknown|gz number within=where thxobeginszPis unavailabl;EThisC *zero-based,P respe!tornf 2doc Pe w l QG hCinit,m,!s,y,a , 6no,CXCreate a newq contai8Ugivens . ?A!'sals are rializedt`a copy`j5s`.BaassertNisinstance(~, str), " no longer accepts2T; usepParser \2ead=!& =[ #! = s.*()"@= q !# =Creprbif lenF)j0 = 'no examples'  elif len(self.examples) == 1: #c = '1 '#Oelse1$%d2Os' %qHreturn ('<%s %s from %s:%s (%s)>' %, __class__.__name__,* , Gfileulineno,1)) Ddef __eq__l, other)qif type) is not *@NotIpbmentedjisKa and \55docstring67Gglobi/8a-i153)Chash`(. d# This lets us sort tests by E#lt isinstance(, DocTest !A, id,))-- <.U.V"W)-#2d ## 3.Parser Z21#  \1""""A #used to p Js containV0doc'.?G4regular expression\\find HQ in aL#w. It defines three groups: `source`WBthe S codeDp(includ1leaindentatyprompts); `OC00of hfirst (PS1)  ;BT`wantVected output )Z _EXAMPLE_RE = re.compile(r''1# S siof a PS1followedzero or more PS2"sncB(?P<>@(?:^> [ ]*) >>>0.*)#s ; \n ;@ \.@ .*)=;<5\n? j# Wantny non-blank that do start with PS1. (?P (?:(?![ ]*$) # Not a blank line  5F>>>)5/ starting with PS1Ac.+$\n?X# But any otherx5)*)M''', re.MULTILINE |VERBOSE) )# A regular expression for handl` ` strings that containDexpected exceptions. It divides Cinto three pieces:A - the traceback headr (`hdr`# - st3!(`) message (`msg`), as genera&by .format_Gd_only(K may have multipleWe assume/requireC"th:#6ige first non-indenBca wordcharacter followY.5_EXCEPTION_RE =%compile(r"""$uo# Grab. Different verEs of PythonHesaid d1!thY!on\ ^dhdr> T+E\ \(]$ (?: most\ recent\ call\ last)| inner. R) \) X P\s* $ `# toss7i8whitespace Q> .*?_,don't blink: absorb stuff until..B ^ Dmsg> \w+ .*E#! a! *o"s*nalphanumB1"""'% 4gDOTALL3Pable returne a true value iff its argum.is3D# orIsingle com3_IS_BLANK_OR_COMMENT '^(#.*)?$').matchdef parse(self,, name='<6>')DSgiven? examples andAerveUtext,f$Hmo stqalterna EPscLine numbers3re 0-based. The o&al`!`  iY0ifyCthis, s GAusedTerror@# =R.expandtabs;# If allrs beginRsame aW,FFp it!Bmin_(pVelf._(6if A > 0 str'ing = '\n'.join([l[min_indent:] for l in string.split(0c)]) output = []charno, lineno = 0, 0 # Find all doctest exampleso3thes:3m self._EXAMPLE_RE.finditer()4`# Add RCpre-f text to `%`.h4s.appendW[:m.start(,# Update(s before this)l'Sno +=R.coune", t%, u <# Extract info fromregexp match(source, options, want, exc_msg) = \ wcparse_F(m, name 0CreBan E0, aAdd i~Jlistcif notqIS_BLANK_OR_COMMENT  v0 ,G=3>=I+len(m.group('?'))N=,) ev_insidv&ny)u Q = m.;gany remain}Opost ]rreturn .def get_f(,jt, globsIfileH5"""rDgive7@pcollectto a `DocTest` object.`@`, ``X" `` are attributesth>newh@ Se'e`umenta=-Gn!rm+%v.9sT{)i$, nc4elf$i2='<<'>'=$ them as a S of `s. Line numbers?0-based, because it's most common`s that1EhingCinterestears on the same line a s opening triple-quote,  and so the first interest3line is called \"01\"05n. F The optional argument `name`A a identify\Ethis@string, is only used for error messages.55""" return [x2x in self.parse(_)4 if isinstance(x, Example)]Qdef _I"_e(\A, m, , Eno):[*Given a regular expression match from `_EXAMPLE_RE` (`m`)a pair `(source, want)`, where `q^%ed2's ) code (with promptsna :epped);G`ziYexpected output]iQFYF0"Cng'sdwiyu numberY A starts; both areZP# Get P7's f level = len(m.group('2'))Rz# DivideAintoIs; check thay@y'reUperly#1ed;Bthen#ir&@_CEs = ').split('\n'3!.__3c_blankN,{  EIefix?[1:], ' '*6o + '.'M 0 = .join([sl[;A+4:]!sl,]@it'sF|#{'. Spaces before+ last newf shoul0# beserved,pplain rp() isn't good enough! =F!if-Q) > 1n1re._r(r' *$'RG[-1] 1delf!0 #`get fi52& s&after it]71+9 pAno +)] XwXVwV(= T3If 'contains a traceback,@n exFt it2m =_EXCEPTION_RExvFif m~ exc_msg = m.group('msg') Uelse:exc_msg = None # Extract options from the source.+!= self._find_(-, name, lineno)gcreturnS,l, want, /# This regular expression looks for@ directives in#g code of an example. O;are commentsAtarting with "doctest:". Warning: tmay give false>Bposi string-literals that conta !<("#mqEliminaCthesh bwould requiractually pars; but we Yt3m by ignoC anyDis *followed*Ea quote mark6_OPTION_DIRECTIVE_RE = re.compile(r'#\s*\s*([^\n\'"]*)$', re.MULTILINEuKdef Celf, +5"""tRPa dic8ary overrides eI!edCG( 8.`J0` i1e#'s`Pand `%no#u number|Pwhere ss; both  usor error messageses = {}e# (note:-lpcurrentBexp,+ will match at most once:.m`=.tIp)_Q 1).replace(',', ' ').split(BF P l.Bif ($p[0] not5f'+-' o)-%1:.FLAGS_BY_NAME<raise ValueE!(' %rvF!E%s 'B@'has"sinvalid[: %r' %C(Dno+1W)[~0fla[4][1:]]v s[?8] =uW== '+#ifdIS_BLANK_OR_COMMENTAd<r 'Q on a%4$nox (lineno, name, source)) return options # This regular expression finds the indenta6 of every non-blankG0lin* a string._INDENT_RE = re.compile(r'^([ ]*)(?=\S)',MULTILINE)def _min_(self, s):[""R|minimum'an E`s`"F_s = [len(S) forM@ in }..vall(s)]I&f Afs) > 0$mifsOelse.0check_prompt_#s,", (no0"QGiven'sa4 (including sUs and1lea1 1),  to make sure that7H5 isFfollowed by=pace character. If  is not 3G:a s;,n raise ValueError" ,enumerate(wr9iC) >=u +4C[+3] != ' 'D ('O0 %r2docIE%s '@q'lacks  after %s: %r' %>cno+i+1A4:I)z_prefixrPCN4iglist starts with q7; iY1doe[ 5a7?%1and.(,/ha0inconsistent QwhiteM;(/ #2 ## 4. DocTest Flr\5d class]\$"A #@used0ext^,at are relevant*a~object, from its  $containexC0s. tests can currently be e8xtracted from the following object types: modules, functions, classmethods, staticGc% and properties."A""" "def __init__(self, verbose=False, parser=DocTestP1(),> recurse=True, exclude_empty%):48 Create a new doctest finder.*`The opal argument `` specifies a#5 orn? that should be used to c7s (GsFQimplesame interface as Iu). Thesignaturr this factoryQmatch$5G!ofe construH3I%6!` `then `wf` willknly examineuSgiven!,]pnot anyctaineds )1 in[ *Ts forpa with rJcstringEw"._@# =h $ = H3 = * =v|obj, name=None, Sglobs eK\Return a list 6qare def&by&'sRq, or bynof its'@5doc parameter `Xr0con^sD!3. 70is d2is Z KNx@ attK"Pautomg`ally dD@corr}#'sqv:0- Aqdefaultspace, if ` ?- To prevFIp4TctingMD 'UimporSother\AGtDfile%hAhelpGlydnumberN: in n|C:c whoseB doe)rwignoredM)If%(no/module will be mcade. &This is obscure, of use mostly in tests: if `module`1@Fals/rK0is None but cannot be found automatically, then all objects areHconsidered to belong the (non-existent) mA, soNcontainedL`will (recursively)searched for doc%. >The globals#each DocTestformed by combining `1%s`Dand `extra (bindings] override "E$inX). A new copy[dictionaryWcreat T. IfY1specified%itdefaults~`'s `__z@__`,'CUor {}Aotherwisez?is  wGWto {}5"""#name waRuct it from1if D:_6= getattr(obj, '__A__',)2O Sraise ValueError("fFinder.find:1musXfgiven G "wdDobj. doesn't e@y: %r" %@ P(typeF),)) # >mc that s@ (ifh5 ist5# aJ=pNote: tmay fail,6WwhichF!ca !be \ =7ZCelif87 inRt.getK1.ARead 's source cod!usR#qo@er._ p_linenoXq numberaC 'sfstring!:trywfile = "except Typ H6-s `*se.*0ot e mp# Check0seejPit's tpof our ial internal "Js&0# (CP__patcache_getK&s)}M  (@[0]+)[-2:] == '<]>': ;/s!T ,elX if module is not None: # Supply the module globals in case?wasGoriginally loaded via a PEP 302_r andA5fila valid system path:source_lines = cache.get s(F,.__dict__)M?els%No access to a , so assume it's a normal[y#8!if "! = # Initializ,` mergePextra"%s.7!if4sok#if|PU = {}T-mf.copy(=9 /6if 8<vupdate(1wif '__name__'"in I[+0] =9@main9 # provide a defaultG] Recursively explore `obj`,cting DocTesttU = []vself._find(p, obj, rBr,F, {}a# Sort8F by alpha order ofRs, for consistency in# verbose-mode output. This wanpfeatureP0dockfPython# <= 2.3 that got lostpccident62.4. It[repaired#462.5xgs.sort~qreturn def _from_(lUvobject)%5""" RNarue ifYPgiven0ectQdefin@r\ ETrueOelif inspectg_(=L/'Dkisfunctionl/0 `i0.__w_als__bmethoddescriptorjif hasatt ,objclass__'0obj# =6.__1 ._7ule5kkDi obj_mod = object.__module__ Yelse:!return True # [XX] no easy way to tell otherwiseA=o.__name__ ==.elif inspisclass()T >^shasattrV6, ')'d5isinstancegpropertyc XSnot be sure.  raise ValueError("/A musA!a F or function") Rdef _find(self, tests, , ",  , source_lines, globs, seen1"""V/BFindO for the given\ect and any contained s,G0add<m``` p0if |._verbo$pprint('3ingin %s' % # If we've already processe#is,n ignore itdA) in&G"[i1R] = 1! aJFPdd it!eqlist of0s;# =#@get_ )iX@ is ;Non)Vs.append( WBLookga`.'s Om)*\recury2val0valrobj.__dict__.items(s6r = '%s.&(H 02# Ri2s &~e.Vif ((uroutineunwrap(val)n@?.*#@fromuBule(O!, f 4b&s- #R) B$ _0__ oionary&C4get# __', {})6!ifH_, strgpDocTest0er.x%: Vkeys gB"strings: %r" %  (type(valname),)) 6 if not (inspect.isroutin6V) or PclassN JZ0WmodulIsinstanc, str)):H!raise ValueError("DocTestFinder.find: __test__ v)?s "L"must be ings, functions, methods,M0es,+s: %r" %t = '%s..%s' % (, `self._,()s+0", , source_lines, globs, seen) )# Look for ga in a 's contained objects.9-if]obj) and zrecurse%ipobj.__dict__.items([# Special handlingbstatic/ < =s:val = getattr(objba0.__&__2# R_6 topropertibnestedeBOif (>6i]!y)9x+Rfrom_(fbAYPsm?indT4UXdef _get(u,@ , 69#&""PReturIthe given\Pect, Pt def  a docstring;}otherwise, rUFNone,v# Extract k&'sV . If it doesn't have one#;nkA (noj#is)Lso I =B,els:try; if6woc__ is (,k%''jr9obj.__doc__  if not isinstance(docstring, str): 5) =*9)3 except (TypeError, Attributc[5'' P# Find the #'s location inUfile.5`linenoelf._find_(obj, source(s)lDon't bother if[w is emptyiAif scexclude_ A andd; Sreturn None}R a DocTest for this objectw`moduleG ` bname =dj else*@# __.__ can be1yAspace packagesQ7$ = getattr(m4, 'U!',PR) or 0.__5%__L4if O[-4:] == ".pyc",)& =4E:-1]Q^parser.get_doctest, globs, ,@e ", SAIdef j, p5"""vU number oPgivenJVect'sg. Not-method assumes thatEg has aDA]"$pif insp"is} Gi0fXclass#'Pcould`fooled!a 3(defined multiple@# ti*in a single[ Q Xs>Upat = re.compile(r'^\s*p\s*%s\b' %37 'mz', '-')iFenumerate(if pat.match( i_break@funcBs & g0 =0.__Ct _7Ocode7traceback8vtb_frama o 4 f_l) 21 d` co_firstlineno', None)-1  # Find the line number where docstring starts. AssumeCthat it's2RfirstN begins with a quote mark.BNote: this could be fooled by a multifunction=signature,a continua*C !if4no is not7:/;if source_s)JNone%)creturnP)+1Epat = re.compile(r'(^|.*:)\s*\w*("|\')')53forN in range(no, len(.))if pat.match-[F]4 A"We_n't fM )? #2 ## 5. DocTest Runner\5d class]\Q1""""A #used to run/ tcases, and accumulateKrtisticsThe `run` methodOSprocess a single`[Q. It\'tuple `(f, t)`0`t`V'ofDRtried/`f/  vfailed. 1>>>T4s =_Per(). (_CV5r6l(verbose=False2^s.sort(key = lambda:K.nam5<9:s0...p print(@p, '->',qner.run)@ -> Results(=0, attempted=29.__init__B'?get='osquare@"1)summarize=y of allS &ahave been` n aggregated:O.5izeI14 items pas7estA 2Js0wk!*"ge O1p.M7%FD7nd 0 failed.  Test passed. Results(failed=0, attempted=7) ,The aggregated number of tried examples and H!isC also available via the `B!s`:`;0urettributes:>>> runner.6X7 #M0J comparison between expecboutputtactual qis doneRby an `O.Checker`. This ` may be customized with aEIoption flags; seedocumentaor `testmod` forDmore inform'Q. If>T! a&sufficient,#nF  !by?ing a subclass of? 0 toZ constructor.~'s displaye0 ca:trolled in two ways`First,Q func"d(`out)D2 to?prun`; t<Awillavstrings thatE`should' edp`t defaG`sys.stdout.writeI)PcaptuU is not  #X%by6Doc.d=poverrid"methods `report_start`,uccess`,=&3une/Q_exce`d9`1"""A# divider ` is used<separateGure messages^%# (!seSrsummarywDIVIDER = "*" * 7def __init__(self, c=None, verboseIA=0):x 0Crega new #O(al keyword arg `y` K|C1/Ls/1doc '' prints lotIpstuff i"ue*Donlysfalse; by/, it's true iff '-v'%inLOargv1arg' ``"nK@ how"ZP,es 5howG$itsO. S- af#._3$ =I or () if verbose is None: v= '-v' in sys.argv'fself._) optionflags =  'riginal_" 01# Keep track of the examples we've run.0@trie0ofailur_name2ft = {} 6$# Create a fake output target for capturing doctest$ _? ou`_SpoofOut()i/#/-# Reportrmethods^-/Qdef rbp_start(j, , ,)\1"""kQ that40ner abto process$UgivenB. (Only displays a message if e=True)<0if $ifZ.want! out('Trying:\n' + _indent(source) +8`'Expec?w)8;els7 nothing\n' uc_, gotab ran s^Tfully8C8n"ok\n"$@Z&ed&ure_header(&Z R2checker._difference,r)1uneqed_exce exc_info$ised an v v'9$'E0 rau x_geeback('_0= [%.DIVIDER]!if6P.file} h`lineno 1notD and@. G lineno = test.lineno + example71 Yelse:>Y= '?'out.append('File "%s", 0 %s, in %s' %5R(filename92no,%));~ILines* (/+1WEdFailed$&:'}source =.F_indent("return '\n'.join(out) C/#/-G DocTest Running\-/def __run(selfN, compileflags, @1"""tRun theAs``. Writeoutcome of each/Gqwith on!O` er.report_*` methods, using\Dnr function `out`@` is6@ setrF that should be used to executB. Rua tupleG `(K)`, where `tz`number}s tried, and `f`E1fH. Tvare runEw@spac;uglobs`.'# Keep trackwAuressF=Rs = 0g-S# Savpn(since odirectives can#`modify&m)~original_J] = .SUCCESS, FAILURE, BOOM = range(3) #Gv` state=ccheck __1er.v_output,# Process4forDnum, NenumerateV4&):^\If REPORT_ONLY_FIRST_@set,2n suppressTAfWPafter,s first 1quiet = 8`/ &9andwJdSs > 0@ # Merge#'s22 ? =  $ifssT(G`, val):.items()BF if8 #|=flag  gelse:  self.optionflags &= ~ 9# If 'SKIP' is set, then skip this example.8>if h HcontinuezRecord that we starteutries += 1not quiet~qreport_c0(ouDest,)Use a special filename for compile(), so`can re)ve#J source code during interactive debugg<(se@__patched_linecache_get *s) = '' % (.=num1Run" i`given ext (globs), and r any exce gets raised. (But don't+ Dkeyboard!yrupts.)$>try1# DWblink! Tis wherebuser's*unMPTexec(.,, "single",A I, True), L >per.set_~G() # ==== E Finished JZ= Nond# KlIkX ]<*ion = sys.exc_info( ' 0gotl_fakeout.getvalue() actual output@:truncate(0outcome = FAILURE Zguilty until provenocent or insan!IfX muqwithout) Ise# verify its 'if!isif check(.want, got,)?|SUCCESSP4ThelVed an": if it wavjpectedamsg = traceback.format_u_only(*[:2])[-1] ?if O"o7+= ]x(a [8m`g`xywe weren't expecting  # an exception.  if example.exc_msg is None:,<outcome = BOOM $# We expected| : see whether it matcheselif check(,, self.ooflags) SUCCESS1Ano`chancethey didn't care about the detail & IGNORE_EXCEPTION_DETAILu_strip__ws-),H@ gpkr# ReporE, F3if E(if not quietrn_success(out, testDi, got)?z~FAILUREffailure1os += 1 -$unp  k< sassert False, ("unknown6$", )5if k=and<0 & ^_FASTMVbreakQQstore  (in casy were modified76= original_ q0corOd return{number o8triUo@__reC_( !, 5fTestResults(,Mdef ]slGf, t41"""8R0facae given Doc0 (``) generaX5`f`F 1`t`da~f2, t2 = _name2ft.get.v, (0,0).,[(q] = (f+S;+t20E+= fKwt__LINECACHE_FILENAME_RE = re.compile(r'.+)' '@r'\[;examplenum>\d+)\]>$')G def __patched_linecache_get s(self, file, module_globals=None):K@m = 2 .__LINECACHE_FILENAME_RE.mj(O9if m and m.group('oC') =QPtest.m8w&es[int(Punum'))]Esreturn ".source.splikeepends=TrueJelseJOsaveR L!) 3runy, compileflagsQ, out}q, clear1"""TtRun the`s in `_!`,yqdisplay$results usingFwriter function `out`.fTbpare runjzRspacex.Dus`. If``` is true (?default),6is SEwillF"bePed af@s, to help with garbage=Qcolle you would like<)0inejFr@letewhen use h=FalseD`3q` giveslqset of  that sh beWId bydPython>0r wCrunn 5not?specifiedn0it b uture-imporDPapply5` 2QoutpuDeachrchecked`DocTestRunner.%_Erformatte$ K re_*` methods.uMQ = $ifp0is $& = _extract_fH_:(X$:U`stdout2ys.  if;wPencod'= H.Di4if M5 orq.lower(z'utf-8'D.? hD:# Use backslashrepl8error handl>on Q?DWout(ss<Btr(s$e(<, 'u5'),JL&(s)stelf._fakeout4 # Patch )pdb.set_trace to restore sys.stdout during interactive # debugg (so it's not still redirected[self._fakeout).ENote that thei output wN goFW*our*<Rsave_, even ifLRGrealg; thisDallows usa0wriest cases for(behaviorE=j1get%()h$E)= }''Wqer = _ORLringPdb(Mb;g.reset o1 = i # Patch linecache.get s, so we can see example's sourc%when we'r2sid1{qfs_s/ =:00__p5ed_$TsMake sudisplayhook just printsAvalu,v9 +7ys.Wys.__&__Etry:<{Pretur{R _run(test, compileflags,=kfinallH!= m 8r5 PPP 26c'; if clear_globsFS8..(0import builtin8._ = None/#/-# SummarizationZ-/GSdef s] e(}, verbose=)/1"""3P # a;y of allN6have been run byD DocTestRunner, and  a tuple `(f, t)`, where `f` total numberdfailedsW `t8087tri7.`The op|Cal `  ` argument controls how det&thdy is. Ieh it2pecified,n )*'s=Fused#if*Ae is verbose = self._ver# notests = []jpassedLfailtotalt = Uf = 0Dfor x inxname2ft.items():(, (f, t) = xrt f <= tv?t +ff0if t == 0~.append()<oelif f>0= ? D.se{Y=x33if  53if  print(len(#A), "t had no &:"g71n.sort(Pthing,Iq" ", 3 N2if 1?;"O all$p, count22%3ds1q%s" % (A#' RvDIVIDER3j Lures/edT2in / } " !of3in 1, "j` in", _Z52ft.D# -Y2, "@ andUxBf, "D W"***Test F<***MiO"O8preturn Results(Q1t) _/#/-G Backward compatibility cruft to maintain doc.master.?-/Gdef merge(w, otherR.6>+9 0amedV# Don't  here by default, since doing7# so breaks some of the buildbots6j(gA Docaunner.p: '" + P + "'~both" \K"yers; summ}outcomesm+f2, t2 = d[name]  f = f + f2  t = t + tpd[name]8 , t class OutputChecker:L1""""A #used to c% the whether actual oH from a doctestGexample matches5expected7I. `p` defin.!woFmethods: `_p`, which compares a given pair ofa!s,Eand returns true ify ; `Z_differenceeC?a string describ 7s between two.Ebdef _toAscii(self, s)' tConvertvto hex-escaped ASCIIc4@#(s.encode('7 ', 'backslashreplace'), "1") zwant, got, optionflagR{" Tz{ ?$n 4q(`got`)D0 (``). Theseings areAalways considerV are identical; bu`dependson what K  runner is using}Aseveral non-exactz@ typre also possible. SeeXdocumentam for `TestRr` moRnform&7abo ,eR# If O+Ytainsp character such as "\u1234"#nGi3uof six Es(e.g. [\,u,1,2,3,4])@# OnL! ouahand,  could be an@sequ7 ofj[T], soq0 shYBrbe fold0z% go.6got: = "z8q# Handl mon case first,efficiencyB#$'r-#,  if@ == S1#wr valuesPcFalse W1d 1d02.rh?pbooleanparisons in Python 2.3Rnot ( & DONT_ACCEPT_TRUE_FOR_1_@if () ("\n", "1\n"04LM0MN # can be used as a special sequence to signify a -# blank line, unless the DONT_ACCEPT_BLANKLINE flag is used.Eif not (option$?s &B%):6# Replace in want with as=$ = re.sub(r'(?m)^%s\s*?$' %uescape(\_MARKER),M1'',)$a# If a( got contains only spaces,=n remove E& L [^\S\n]+$', :got1if 8= Vreturn True b# Thiscauses doctestignore any differ7s7theDents of white strings. Not@at toacan be4F inA@junc5yELLIPSIS):if _NORMALIZE_WHITESPACE  ' '.join(got.split()KH)*u&)e P sayss le$eP"..."s``0Qmatch2subl(Ogot`'x if _ellipsis_Z(p,T MWe didn't findL#; ~VfalseF# Should we do a fanc?def _do_a__R(self,#y asked forj i(REPORT_UDIFF |-C-N-Z,expected outputY$s , a meaningfulP5 is# too hard ... or maybe. In two real-life failures Tim saw>1# a,! wtmajor help rway, sois commenu# [todo]p) knowsdqch piecp and down And cQbPe baskick-ass"in(ca-##iBx I9^ ##n@ doeW0trawm marking77Geven&1-?rences.  if optionflags & REPORT_NDIFF: #return True 0# The other diff types need at least a few lines to be helpful.H] want.count('\n') > 2 and godef output_erence(self, example,>,)5"""Ra string describ 1the`s between the?expected for a given3 (`!`)XeactualG (`got`). `@` isud set o EusedGto compare `W`pU.%%$ =.(# If s X bev,n replace blankCHwithE! i@ 6|if not ( & DONT_ACCEPT_got = re.sub('(?m)^[ ]*(?=\n)', 8q_MARKER()W@p# Check$we should us  o._do_a_fancy(BT|e`Split - &R into=e+#_F=0 .s;(keepends=)v85got7H63# U0lib@findi  OUO! =Ylib.unified>D :n=2HPlist(Tq)[2:] #pcy header>k3= ',-+'=/elCbcontex./, Hfollowed by9dgengineDiffer(charjunk=IS_CHARACTER_JUNK X.E)Cnw &se6assert 0, 'BadJ 0's (%s):\n' % p+ _indeb'.join If we're uspsimply # output follo wed by the actual output. if want and got: return 'Expected:\n%sGot' % (_indent(D4), Ugot))K#elf^ nothing\ncSb SJRQ/se M ' class DocTestFailure(Exception)WD"""A$ example has failed in debugging mode. TThe eL instanc:variables:+q- test: object beW4run*-E-Cthat/kX G1"""def __init__(self,,,` ]#.! =)E$ =? Pgot =Q|3str{g1strr)3Uneencountered an uLsexc_infoS!fo]Kg*P:%DJsRunner( r"""Run doc|s but raiseas soon asqre is a$urP If7 occurs, nPwdIt containt,~ Ldoriginalq Ga >>> r8 = verbose=False15Parser().get_doc!('Y,KeyError\n42',F{1... {}, 'foo'|.py', 0"ryBMZP.run(4" qrPrure = f{n9oOTrue1.1k'42\n'3o:,[1] # AlreadyMthe traceback  Traceback (most recent call last): *V ... KeyError We wrap the original exception to give^ing applica F`access.Htest and example inform2.z!IfVoutput doesn't match,n a DocTestFailure is raised:Fa >>> r=/Parser().get_docD(''' =_x = 12''', {}, 'foo'.py', 0)*ryrunner.run()cNas fJf,5= fy Gobjects provide  `U.ETruelAs well aTV.wantTU'2\n'UMZractual 4Q(goH1HSIf a P or e q occursu globals are left intactl1delu.0s['__builtins__']`-({'x': 1}47 s1... &.UnexpectedE3: < foo from .py:0 (2d;s)>L320But #cleared i"noX 4 )3estResults(ed=0, attempted=1=est*2"""@def Qself,1, compileflags=None, P_U=Wr<R.ZUv, FalseN7if b=! .$(7sreturn 6ueport_u_Bion(4out,X_  , example, exc_i-nfo) def report_failure(self, out, test, example, got):7;raise DocTestF=2? #2p ## 6. n Functions\6 These should be backwards compatible. # Forility, a global instance of a% Runner # class, updated byjmod. master = None T`mod(m=c, name ns cverbos=True, op9pflags=07traG 9_on_error=False3clude_empty?"""zy  w =-ex6s in docstringfPB andes reachable_from module m (or the currentif m is not supplied), startingIwith m.__doc__.AAlsoo {Adict7__ if it exists!is_{)(. .Amaps:Us to ,;H$\51areped evenrprivateJW 4pdirectl3s<gy weredReturn (#@s, ##s)!See help(doc) for an overview(Oal keyword arg "q" givesm;qdefault1use[+^Z_!a  to`bused at&"alwhen execu1$, P__. A copyactually5dh , zJhat '5 a clean slate$ex_ ionary twt]merged into+B9#to$e"Q. ByC0, n&$trs@p. This0new?2.4' ^" prints lotsoQstuff^Tonly "f? it's true iff "-v"in sys.argv `a summW!at;Aend Otrue, else prints nothing at the end. In verbose mode,summary is detailed, else0y brief (in fact, empty if all tests passed). EOptional keyword arg "oflags" or's togetherule constants,Gand default, 0. This is new in 2.3. Possible values (seeFdocs for2s):DONT_ACCEPT_TRUE_FOR_17 BLANKLINENORMALIZE_WHITESPACELLIPSIS.ESKIP IGNORE_EXzION_DETAIL REPORT_UDIFFCNONLY_FIRST_FAILUREraise_on_error" s an exce5 onWfirst unexpected&r failure.dallows!bepost-mortem debuggedEAdvanced tomfoolery: omod runs methods of a local iBQce ofaclass docq.Testern mergesA reseinto (or creates)Drglobal =bU maUF. M F can be called directly too,Lyou want to do sounusual.E@Passreport=0.is especially useful n,&QdelayDpdisplayG#a Evoke+ Cize(;when you'r2ne fiddling1"""k:L}t# If nowas giveTuse __main__L@if mQNone:V# DWA - m will st0be &Ot(wasn't in`d from commandMPline,Qwhich casA0 fo+PTypeE`about 1ood#Pas we shoul#m = sys.modules.get('$')'Check thatKwere actu2# aE( noBt.is`6(m)6 #("<:J required; %r" % (m,)_name it0's &3!is#p = m.__ $__Find, parse, 7runli6jfinder = DocHer(exclude_="ifBrunnTR =', = ,IQSHfinder.find(m, name, globs=q, extra = C): runner.run(test) if report)summarize(+master is None3"= eZ=els"r.merge(&Wreturn TestResults .failures,W.tries) def Pfile(module_relative=True,+=, package K'cverbos'Moptionflags=0,Cva raise_on_error=Falserser=Doc Pa,()LqncodingJ1"""q7 examples in the given B. RS&(#B#02s).Oal keyword arg "@" specifies how]isshould be interpreted:_o - IfQ0is  (default),0n "`"a - path. By IH!is" iE2 toj callingQ's directory; but if'@"7"&PumentdwAen i l&atFE. To ensure os-independence, `6useD "/" characters to separate0segds, andB'nobe an absolu6`(i.e.,may not begin with "/"5 8theA%an3os-=ch5or S5(toD@@curr@workc0s ! oU5; bSp1use)p's baseDK%8is a Python0 orUaN $Vwhosebe used aC)Dfor 2Al . %no.ee- s41an ! 'y @Lv! ""`a dict7 B"al3w`executUh, {}. A copy0thiJcmpctually-d each docstring, s:at 'y start with a clean s)late. Optional keyword arg "extraglobs" gives a dic+ry that should beHmerged into the =2als+are used to execute examples. ByCdefault, n&5traE@ verbose" prints lots of stuff if true,qonly failures"false; by Ait's: iff "-v" is in sys.argv ereporta summary at&end whenb,Celse nothing.c. In a mode,IX!isEdetailed, O very brief (in fact, emptyall tests passed) o1flags" orpogetherule constants4andOs 0. Possible values (seedocs for 2s):DONT_ACCEPT_TRUE_FOR_1 BLANKLINENORMALIZE_WHITESPACELLIPSIS.ESKIP IGNORE_EXzION_DETAIL REPORT_UDIFFCNONLY_FIRST_FAILUREraise_on_error" s an exce0 onSfirst unexpected&r. This allowspost-mortem debugged, parser" specifiGDocTestPA (orsubclass)1\7Stract@from0 fiC* encoding$n pbbconveridunicod>aAdvancmfoolery: mod runs methoda local i Qce ofs@ doc.!er!n WFe result| to8 creates)Dp =bUmaster. M F can be called directly too,*you want Pdo sounusual.E@Pass =0.Ais e@ally0ful n,&Cdela `isplayG5Evoke+Cize(YPyou'r2ne fiddling1""":LJif package 3not_relative:;wz VE3("P;Amay c%bedrmodule-E "i paths.")2# R"iz1Qtext,name = _load_y(filename, pa ckage, module_relative, encoding or "utf-8") :# If no name was given, then use q file's$.6!if is None:G= os.path.base(B vrAssembl`uglobals\s]A= {}p7elszq.copy()'if extraU;not.update(-@0'__@__' =1in 2['] = '__main__'jif raise_on_error?runner = DebugR(verbose=, optionflags=  QoocTestS:e# Read, convert it to a test, and run it = parser.get_docb(text,<,A,[\2, 0P.run(41=\eport5.summarize(+`master =1ner 9"r.merge(Wqreturn Ncesults .failures,W.tries) defstring_examples(fb=False="NoName" rcompile ""0)+1""" 1 in object's doc (`f`), us5``G"1 Oal argument ``z@usedg message!If ADCtruegenerate outputaeven iJ`re arep"s.v`'`s{qset of ? that should be@d by(isPython K0r w5theX". Ot specifiedGit will defaulD=uture-imapply toDpkeyword" `V`s@Us forcZR. Se1docax7`0Amod`Amoreainform'ur# Find, *1all<s!BBfindH.errrecurse?BN;%0est.=j7%er3AO) ############## ## 7. Unittest Support /C _uZ0_reYflags = 0 def set"((): """Sets the O option (!. (qThe old is returned so that a runner could restoreX1oldDvalue if it wished to:` >>> im@ doc15{=..@.REPORT_NDIFF |:0...2ONLY_FIRST_FAILURE) ==EHTrue;(Z; ROnly '1ings can be) ?ELLIPSIS)gaceback (most recent call lastlS ...3V Error: ('allowed', 8)S1old[O1"""global 2if |2 & ING_FLAGS) !=Yfraise )/("' "",@0\  class DocTestCase(,.)Cz__init__(self, ,UT0=0,upUp=None!barDownqcheckerh .z )R._dt_( =u+u3 = #! =rsetUp ="te@ &A<>; gP!lf~3i?@not cU+((Ha|'B+.Rs.clear(0runuLsys.stdoutnew = StringIO(3 *3ags  if not (optionflags & REPORTING_FLAGS): b# The 2 3 don't include any reporting",Bso add the default2 1ml|= _unittest_g 2runner = DocTestR=Q  checker=self._dt_, verbose=False):try3.DIVIDER = "-"*70kfailures, tries = 6Irun(*. , out=new.write, clear_globs,kfinallsys.stdout = old4if Qaise !AExce>(cormat_(getvalue())%Zdef f)=W, errn" =ny 0if .lineno is None= 'unknown  number'K?els9X%s' %j6lname = '.'.join(.split('.')[-1:])4return ('Failed doc6`V %s\n' File "%s",a%s, in0N\n%s4&% ,aP.fileCAno, wqQdebugqr"""Runcase withQresults andPcatche4ss! X frameworkYAs a method on*ysusuites to sup post-mortemMRging.|3HcodeL islsuch a way thatqors areEacaughtK!is&aHcaller can 81errCnd initiate )Cu}provide!r UnexpectedV@herePEan u*:R >>>|Parser().get_ ('(P KeyE[\n42'0...{}, 'foo'v.py', 0`,^%*  xD.q(8" LJas fTI = f<SKcontains., example,_Q@orig 9ion >>> failure.test is ( ZTrue  >>> failure.example.want&o'42\n';exc_info =F Bhdraise 3[1] # Already has the traceback?T (most recent call last):0:...KeyError!Iftoutput doesn't match,n a DocTestF$X)d:J r$ =3Parser().get_docJ('''2...A_x = 1 2''', {}, 'foo'.py', 0)3~FcasePCase().ryrD{.debug(bdexcept!TOas fN^  objects provide access to]0As well ]4` #W V1andractual ] ,go16"""=self.setUp`runnerR(optionflags=6G_dt_,Avchecker;, verbose=False%U.run(o, clear_globs5*tearDown(adef idFqreturn 2\C.nam5a__eq__9w, other@qif type)2not *n@NotITfmented 2 ==u. \h5 <C   =7 r :=   <"Chash:(.,Y)Pn__reprA& =sV.split('.'"%s (%s)" % (A[-1], '.'.joinD:-1]__str__ = ..ef shortDescription(self): return "Doctest: " + $P._dt_.name class SkipDocTestCase( Udef __init__m, module x`# =S.IaNone) *gQsetUpd \@skip( Suite will not work with -O2 and above"]_H aGpasshortDesc` 9Pping Xs from %s" %m 0.__m"__`__str__ = sf _.P(unit`."):K/p_removeqAtIndex0, i C 4 _=s, globs Xextra _fXr#1**osy1"""%Convert d0Cor a*d to a ! s.bThis cG`s eachM`umenta@ str'inS1hatcontains3_sscase. If any of theC7!s ^4docnPfail,$nW C s. An exceHis raisedw@the !nP file ~E(sometimes approximate) line number72e `Q` arg1 provides !beed. The0tcan be eithexUIf noA is given,P callzsis used:AM@ may|d as keywordcs? A set-up func% ised before runn k.`Q}0be ^Sed a \aobjectweU QRacceso0alss attribute41x;tearDown} A U-down _afterUfT>?1!di8aryV1ialal variables for_sYSflagsW\$ %p expresas an integ*G!ifgT=ZFinder()  module = _normalize_m() tests =_finder.%, globs=q, extra = !) Jaif notIs and sys.flags.optimize >=2:-{# Skip docwhen running with -O2.AsuitDocTestS(N @.add(Z)CCase)/qreturn 6S.sortVAIr1for1 inspif len(P.examples) == 0$continuePB.filename3# =0.__%__EI@P[-4:]}j".pyc"O,)4 = Y[:-1]Q*%,~1z;@, **Cons). class DocFile7C"):def id(self)I'_'.joinP._dt_y..split('.'}J__repr__1PfGfUt_failureE^, errJ('Failed/ @`%s\n  "%s", line 0\n\n%s'\!% g/,  D0) j+bpath, _relative=True, package=None,M  parser=P.()4encodingS"ifq@ is YmQ = {}Nelse%c.copy(h$if Fraise ValueError("P may only be specifiedM!-" "T j3s."2# Rm1the.H0doc| th~Aload(D p  or "utf-8Dif "M""in!_['1] =p# Find prread it` = os.A.basConvert it to a.,L@wrapHin a,]S.get_Y(N , ?0A}L 5*s%#kw"""A unit?Z#0oneoEmore!"s.8TIeach% given as a string;e* interpretation of that st-ring depends on the keyword argument "module_relative". A number of options may be provided asT"s:? VSN Ifp is True,given file paths areBinterpretRos-inBent v->S. By?qdefaultls^ 3 toP callCR$'s@irectory; but if-"package"[specifiednnB@they r3at E. To ensure 3ce,E"name" should use "/" characters to separat<0segas, and0notan absolu0 (i.e., it&Bbegin withs)1OFals&Fc5The&or](0urr"@workd~CA Python1 orta ewhose VG be0(ba+C for.F6"Y] <"us9n`s. ItG`an err"o &y #if9 ]<5SsetUp-A set-up funcq 0his4ed before runn$thtests in each:P. TheRUQP will1pasr DocTes  objectw ;cQccesslq globalss attribKo$1xttearDow A _-down_afterUfT>?1!diary contaisinitialr variables=_sYDflag[0doc* $b exprePs an d3gerNeparser2P (or subclass) that`to extCas fromI\encoding*4An [ to!DvertHes to unicode. """suite = _DocTestS1() # We do this here s at _normalize_module is called at the rightGlevel. If it wJ-in DocFile~,:npfunctionCwould be"jr and we mja guesspackage incorrectlyif kw.get('m_relative', True):n!Ckw['I ']! (K&)6for path insUn@.add((1d, **kwGqreturn 3? #2 ## 8. Debugging Support_5 def script_from_examples(s[r"""Extract) ) text with 3. Converts% to a PythonPB. Ev input iscI ed7regular code40out5[all other wordFIare Jcomments:2>>>T= '''0...Z@ HH` of si+R mathX .. >has super accurat0teg5ddi@K ^2 + 2j5 And very friendly error message?1/0_To Infinity!?AndIBeyo'You can use logic if you want Hif 0*Oblah!: _oHo humjoprint($))-##4A # Expected^5## 5#u 8uk} ##i*# g\]5 I8 7 4i  """ ! output = [] for piece in DocTestParser().p A(s):+/if isinstance(9, Example'+# Add the e 's source code (strip trailing NL)g@r.appendk.@Z[:-1]-mcpectedT0wan. r0if  37 R'# Exe*:'- += ['## '+lela_.split('\n');Jelse~Cnon-Ei text.q_comment_line(lf a # Trim junk on both endsSwhilef4 anq[-1] == '#'R.pop(=0< 0=# Combine^\,return i">a courtesy new to prevent exec from chok(see bug #1172785v\b.join(y@) +  def test(module, nam"""Extract-sQa doc0doc ng as a script. bProvidf (or dotp1 ofb) contain1theEfto be debuggedCCy(withinHWaobjectG%#Cdoc  ia91"""; = _normalize_<x4s =AFindMfind)tptp<Qif t.!==raif notraise ValueError(80, "*UfoundW"! =F"[0YvCrc =___ s(.F]2srcL_src(src, pm=False, globs=NonXD)^ingleG,@argut `src`'v2src)&"/". 1 isZ, btring.Bimport pdb"if+" =S.copy k'%{}I&pmF6try C5:jexcept4print(sys.exc_info()[0p =.Pdb(nosigint=True\sp.reset`p.inte_@ion( , sys.exc_info()[2]) else: #pdb.Pdb(nosigint=True).run("exec(%r)" % src, globs) def debug(module, name, pm=False)g@"""D& a single docteststring. Provide the S (or dotted]7 of) containingEZRto bepged and Cq(withinf)WaobjectG%#2doc Zests `.21"""T = _normalize_(asrc = Source!I'a_script(*3pm,".__dict__) #2 ## 9. Example Usage[5class _TestC ":A pointless *, for sanity-check&of:=BrMethodsWrsquare(LRget()o7>>>Q(13).( +3-121;Fhex(?nHua'0xa9'6" :__init__(self, val0"""val - passociaPvalue@F@tjB(123 xprint(t1123  .=mC )  <'s RjZ 5169 E** 2.preturn y 4 x?-42x&-4 @ __v__ = {"4'":,]"@": r[ of, searchVBs-isBg1; y =y +'+ y, x * y+G(3, ; B""","bool-int equivalence 7In 2.2, H ean expressions displayedF 0 or 1. By default, we still accepq- them. This canisabled by pas^  DONT_ACCEPT_TRUE_FOR_1 to the new - optionflags argument.:>>> 4 == 4/1&UOTrueX>0T@OFalsY""", "blank lines": r""" B# can be marked with :<@zprint('foo\n\nbar\n').?foog ?bar8 ellipsi !If'  is used,tn '...'&. telide substrings in> desired outputM list(range(1000))) #doctest: +ELLIPSIS[0, 1, 2, ..., 999](whitespace normaliza5,7< 8difference"Kare ignoredRs&3$NORMALIZE_WHITESPACE03, 4, 5, 6, 7, 8, 9, 1O1, 12, 13, 14,G 15, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26E27, 28, 2} def _"()O`importRparse  5r =#.AP%r(descri#="d runner"CT.add_('-v', '--verbose', ac4='store_trudefault= help='IP veryW/ for all s]oappend'choices=OPTIONFLAGS_BY_NAME.keys(), /[]H('specify a Tto apply'L4 'P; may`ied moreH ^ ' than once to apply multiple options')) parser.add_argument('-f', '--fail-fast', action='store_true', B`help=(,p running tests after first failure (this'M' is a shor d for -o FAIL_FAST, and I`n addi!qny otheO)  file', nargs='+'  '0r contai #he to 'O$ ="s(AJ@s = +. 6# Verbose used be handled by the "inspect; v" magic in DocTestRunner# but siAPwe arX1arg @passit manually now.veA = 0: s |= OPTIONFLAGS_BY_NAME[]/ if s.__F84O@namel<4if ".endswith(".py")%B# Itmodule -- insert its dir into sys.pathatry toDa# impo6a. If iVpart of a package,t possiblyCwon't work because=;ast0dir,B = ot.split(4.0(0,K (bm = __%__MZ[:-3]*5del&"[0jures, _ =Nsmod(m, i=,bflags=(sgJelseY1, m_relative=False: s$sreturn 1 0 if __r__ == "__main__"?`exit(_B()) e from types! MappingProxyType, DynamicClassAttribute __allt! ['EnumMetap', 'Int @Flag2Int B@autoXuniqup ] def _is_descriptor(obj1"""GR)s True if obj6!, BwiseB^(Oahasattq, '__get__') or' s'`deleteQ N)`under(): """ R+eturns True if a __dunder__ name, False otherwise. """r@! ( @len(<) > 4 andq[:2] ==bA[-2: O'__'.2] != '$-3 i) def _is_s:%R -320 !-1 1+ 2:D#private(cls_w,{) # do not use `re` asimports `enum`]pattern  %s'% W)%/if1= 5$1and.startswith(eM%)[`"*[1 org%[-N_ fBelse'_make_class_unpicklabljVkMake the given 3E un-4 [break_on_call_reduce(self, protoc raise TypeError('%r can1be e`ed' % ?Scls._V_ex__ = _s .amodule+'' _auto_null = object() D Instances are replaced  an appropriate valcn Enum6jsuites0(&= # _;Dict(dict4`Track  member ordert ensure9Ureused. aMeta willH1found iny"._esi1theCyerationq q_init__ super()._ ;elf{A= []y Qlast_H/s oignoreBed =2ssetitemb, key,PChangqnything!edot a descriptor< IfBNG0 isd twice,#':d; duplicatL checked fqqSingle c sc"(C)q2`reserv0Xi&._7key)= warnings.  "private v+ariables, such as %r, will be normal attributes in 3.10" % (key, ),#DeprecationWarning(stacklevel=2")`if _is_sunder~%):if key not( '_order_', '_create_pseudo_memb9Pgener0next_valueGrmissing PignorF praise VO!Error('_names_ are reserved for future Enum use'I_== '_ .3# check if s already defined*Zauto(l=if self._ ~_calledc*BType"P must{dbefore"0set(1',  =(el-if isinstance(I_, str!" =r.replace(',',' ').splitINelse|QBlist $"._| |D= seJ! & @zd$if 'P_ cantspecifyd _: %r'L 3% (., rJdJ K1._'nnSa#in#_ H# descriptor overwriting an enum?ViJ'Attempted to reuse8 % 5 Epasss. 9R #  1 %%r"#$as,nf[key])L#if"= Nnull^). bANy 1 '1len .names),  self._last_values[:], ,)Hauto_called = True-f1 = . $Imember_names.append(key|+*V,super().__setitem__M,) # Dummy for Enum asMeta explicitly checks' it, but of course # until9finishes running the first timenclass doesn't exist. # This is also why1dre are&innlike `if7not None` e= " mq(type):1"""&@amethod def __prepare__(metacls, bases, **kwdsjP# that previous e~ j8^!._Q_for_!Cing_9(y r# creatw_pace dict\~_@ = _#VDict(D Q._cls =B# inheriflags and _generate_nexw_ functionD_,0_y5 = get_mixins_(if9!isH HW/[''] = getattr(:/, D,y[[areturn o[?newWba  &final oncej@ion s have been defined; iP# canbe mixed with other s (int, float, etc.) if it ha9%Qed __ unless a new$is@ (or resultingNwill fail).  remove any keys listed in _ignore_-QV.setdefault(''d', [])sP0assI[']g_0key2 2popg)0P, savw, use_argspAfind/, ) z`into sM@mapp< so@y do$qget bak%toQ#$ new class  enum_members = {k: classdict[k] for k in./_names} *-:-46delV[;%] !# adjust the sunders_order_ =@c.pop('', None)OQcheckqillegal ws (any others?)grinvalidx = set(0) & {'mro', '' 9if ; raise ValueError('Ih: {0}'.format(<','.join(m*))'reate a default docstring if one has not been providedmif '__doc__''  82q] = 'Aneration.'M7^ uper().__new__(metacls, Abase , **kwdsM ' []1#as`defini WQ0mapO'{}K Q0->vO mapG @typeH_# save DynamicCpAttribu s from s5es so we know~#we can takePhortcut of stosKd&_a5= {" ec[BFmro(,4@k, v-@c.__p__.items/Ysinstance(v,%g}^Reverse  ->shashabl%s._920_cIf a custom  is mixed intoEnum, and ie) hto pickle itself,.dumps will succeed butBload# fail. Rap than hle show up laterpossibly farK~8source, sabotagaprotocol\Bthis7 soJ5thaAalso#20How,3newYimplements. own __reduce_ex__, doM-- it's on`m to m10sur| works correctly. We useL l 0eade_fXf appreferryKBFover_2handles allm5' not in classdgict:  if member_type is not obje*5methods = ('__getnewargs_ex__', 9_',lB'__reduce;=_')7!ifany(m in.__dict__ for ){ _make_class_unpicklable(enum%) # instantiate them, checkingqduplicates as we go=)we@Qfirstoead ofK)W casePa custom __new__ do so funky with values -- such asO`uto-nu:;yL0nam 2k#._3sen1 = M'"s[_/]~C "ise1ce(@, tuplem~'NJelse32 }v: # specialA_c(0, ) # wrap it one more tim%@use_;F$ = GSrhasattr+/_'YDn"._+" =@ 9h>0, * w)j ,NqR([ $ hL.=4_ =L-A_obj_32oinit__# If another^swas already defined, uT# newFPbecom9n alias to1` existIone.?, canonicalmap_.items(-ifH) = - =S /Ybreakj0# Aes don't appear ps (only_Bs__)< enum_class._member_names_.append(7)  # performance boost for any 5 that would not shadowEa DynamicCAttribute&#ifRLBin d8$_a4)s:60set(,K!,  now add to Imap_d? ?$[R8] =f ?>try # This may fail if value ishashable. We can't"he( b#the map, and by-Sqlookupstvjwill bJ}linear.d D2  except TypeErrorUpass w# double checki0rep~d friends are1ixin's or variousL things break (such as pickle# however,UPethoddefined in Enum itself, dofreplacSE# it8w@@('____', '__str ntreduce_ex__')14if OJdict"vcontinu"_m?= gA[5>obj3Qtype,W, NonQ:8 n`first_:7if wa %)}other __new__ with our own (as longN,#Gway) -- again,  isssupport6ssupport and `value` beSEbothJ@propkhes fors (which liveb y)_Lsvmselves@if _is_dunder(-i1(q;try [7 except Key C@) from Nonegetitem2G0ite!7cls0pssdefinition i Q)s_2len^9lena >@ey7P`a mapp#of a!->.4EThis-lists all, includOaliases. Note that thisOis a read-only view internaln| MProxyType  g>rep h!"Mreversed^8 Y>Yd9s_)s!, $PBlockAempt>reassign s$A simple '@ment7[aspace changes  of  several possible ways to get an Enum member from theclass, resulting in9inconsistent1eration.25""" b _map = cls.__dict__.get('_ u_', {}):pif namev%:raise AttributeError('Cannot reassign6s.'\super().__setattr__(m, value) gdef _create_(cls, _*s, *, module=None, qual4typstart=1))Convenience method~a a newm.`ms` can be:p* A strpcontain KZs, separated either with spaces ore commas. V!@s ar`cremen@Bby 1H``* An itera#ofR3(i pairsP mapp 2 -> 3umetacls _#@base)P) if @ is p else (Gs_, first_e%get_mixinsz_5~I =.P.__pr e_43ass;# special processneeded for?/if isinstance&9'tr#" => .replace(',', ' ').split(W(tuple, list)) andP @[0], original#s,AE, []Qlast_ RcountF*e(h [V' =Q._gen>C_nexxz7#, p6[:]7Y .append(p*$"Ob# Heresa ?T or aSh5@item.|j )*,4 =Om[D l vP a[]n32_3"*.__new__(:  cTODO: D fr @hackYa blessed'Aknow(calling # module is ever developed rif modu$UNone:":trym1= sys._getframe(2).f_globals['__name__']Q except (AttributeError, Valu 1Key){EpassP _make_class_unpicklable(enum)K;els&2.__C__ =.9pif qualfNnot F L/N  Qvreturn 3def _convert_(cls, t,, filter, source=@5"""bCreate a new Enum sub' that replaces a collection of  constant^# @ all ,S fromC (or)sU() to#ccalledand export the0 its members backN;`Dlso,K __reduce_ex__ method so Ding works inHprevious Python version%{! = vars(C"s[]#if2 B50a _v28P_map_populated insame orderOgy timeG1for5pnsistenK`e mapp8Pof nu1 toA whe\rHare multiple' s [D.zUs = [ ('%W!.~.items(2$if8) +0# s1by } ." (key=lambda t: (t[1], t[0])82Typ& # unless someos aren't compar,which case- clu3clsf=qJcls._'= n!by5_?p.update&__^ /[f] = cl^fr@staticiheck_for_existing_()w, basesfPchaini  (Jro__'Tif is(5,).sC raise TypeError( "%s: cannot extend enumeration %r"? % (class_name, base._ ?__): !) @staticmethoddef _get_mixins_a1s):)&""Returns the type for creating members, and(first inheriteX .!s:8tuple ofsat was given to __new__0if oO"br object, Enumfind_data_(DEis = []arhain inL<candidate = NoneA!EyDcM.__mro__L/i&3 is'+~continuselif issub$ -}"._6_hENq.appendx P ]breakE\'+'OW.__dictO9  7_ ! !or1 /sefc=b +vif len(^) > 1M9rai'%r: too many ?{s: %r' *s)w#*[0q/el^# ensure final parent!an derivative,* d vconcret9#check thatGdhas no_Fs[-11 A"newbs should befed as  "`aName([, ...] [!,]b6)`"O = _L3 or6if s CZs1rst(j(classdict, me mber_type, first_enum): 5""" Returns the __new__ to be used for creating$K0 mec5s. Gclassdict:& ionary givenYd9K;Pdata V whosEwillby defaultI : aeratiotQcheckan overrid # now finddorrect#!, TEto see of one wasEinedA# byEuser; also? earlier 4es in case amUMsaved asA_"" =Rc.get('', None)# shouldR_gfu later?m'6% ==ais notdc(if #all possibles before fall~uback toL4`methodbX5', *9=?8e7target = getattr(L", 13if @WIin {+ \,".#* oobject,OEnum*}# =]break f/oBNelse, # if a non-#2 isF then whatever value/tupl0# assigned)md name 0pas%toVaogP2new\'4Vinit_ 3 use_args = Falseh8+6Tru*rm$, >,']1  OQ(meta=CMetaqGenericDerive from this Ytdefine 7!s.Y%deR(cls,~ # instances are actually7`ed dur construcqLwithout c; R$$edT#s' # __call__ (i.e. Color(3) ), and by pickle if type(value) is cls:&# For lookups likeX^Y.RED)0qreturn RQ# by- search for a matching enum member5see if it's in the reverse mapp9(Ihashablevs:tryrQcls._2ua_map_[]except KeyErrorJ# Not found, no need to do long O(n)QPEpassbOTypec0not recw\D"--fvbehavio:h;.:s()9#if"B_ ==Y,0S]# still % -- try _missing_ hook0 exc = Nonn`sult =.LNXEion as e`] w sinstance(re,N%;els2ve_V@("%rKaid %s" % {.__qualname__)T2if Jk!isf 3braise _elif C!%= (GK 'ej&%s": G0ed nstead of JSvalid'c 1% (_,,3exc.__context__ =&C5exckfinall# ensure all varis that could hold anr1eptre destroyed_u Xdef _generate_n _( , start,nt, last9s1"""LzGK Oque whenugiven. 1g:.0ame O&rinitial]!or TRcount/ nuUWPexist4\3Yassignede Nk4&d(0( VfE + 1"O:  Qpass else:return start @classmethod def _missing_(cls, value)JFBNoneE4_repr__(self-"<%s.%s: %r>" % (m81.____.__name__,  (_)~/st}|wMf X/diX5"""RTs all members andrpublic _?added_behavior = [Zmfor cls in_mro()0m.cls.__dict__&if m[0] != '_'Pm not98N_map>p] + [m k2l \]|L5(['', '__doc__ module__'c 0 cformat,Gspec|9 ur actual type unless __d has been overridden._# mixed-in Enums should use thef'aotherwiseZ# we can get strange results withTi ,mwing up instead ofNHFma# pure branch, or dexplicitly^)! =H.BY(d, Flag#if1_ is object s+=4Aval OXXelf._3g%p;r;4.__J(vale_hash_e.= reduce_ex?w, proto#, R#, U# DynamicCAAttributepused to`vide acc@!to``^'1# `Z`/perties of enumPwhile keepsome meas#?tection from modifica", BPstillo!ank!er)`to have&d . This work ca PQs areQset direc@n6 u -- __getat" i:#9Ylook them up. @DynamicClassAttribute def name(self):a"""The of the Enum member."""+preturn A ._L!_ @v Ovaluwx2P_ c@ IntQ(int,0"""c wheres are also (and must be) ints &_reduce_ex_by4s, proto`  PFlag(z(WgSupport for flags: xgenerate_next_(], start, cou3las sgcMGKO On not given.1g:.4ame%&rinitial]bor Nono// nuNWexisting]3Yassigned b!ifuVD3 if!is0u else 15 in reversed({f6tryVhigh_bit = _ D)s-Ybreakexcept E>ione raise TypeError('Invalid C: %r' % j) from)d2 ** (2+1)'@ramethodmissing_(cls,mR?s (possibly crea0it)one can be found5.x(original=+"ifJ < 0=TA = ~ 1"e_ = cls._e_pseudo!_(;;if v_~  Ce a composit44 if?contains onlys $@*2T_map_.get@, F C!is" # verify all bitce7*0_, extra_"dee 4(if4 T|V}C"%r [axid %s" % LP_qualt6__)Q# construct a [pleton e-D pseudo_member = object.__new__(cls) rpseudo_0._name_ = None( Avalu) *# use setdefault in case another thread aly created a compositz# with this n = cls._'2f_map_.(), 9jreturn def __contains__(self, !):#X5""" RMs True if 2 has at least the same flags62 asT.GSif not isinstance(,\.__class__raise TypeError(["unsupporoperand type(s) for 'in': '%s'  N" % JN9).__qualX_ )B3_ &C_ =='_Crepr Scls =E( !isg '<%s.%s: %r>'x?s, uncovered = _dee; '|'.join([str(mDor mum=]),I2)/stM 2sif len()14[0]R!isPIrG <OelseNsN "6M NboolQH ;o5o$ NotImplemented2* * |} 3and[elf.__class__(self._value_ & other) def __xor_/,&!):"if not isinstance(H", ^_class__26return NotImplementedT B ^cinvertymembers, uncovered = _decomposea )^< 0%for m in7Bif m=#n A and$(m# &E DH5| mO+A)  IntFlag(int, <1"""LSupport integer-based-s$, @TRmethoKmissing_(cls, e=R"s (possibly creating it) if one can be foundZ.MY-W, int7praise V!Error("%r isaid %s" % (Dcls.__qualname__)Bnew_1 = (e_pseudo_J7>_RlCSBe a 4itew0iffue contains onlysb !2_map_.getf, None:if C!is" need_to_A = [c]# get unaccoud2bit#_, extra_flags> [timer = 10XwhileP p"# <I-= 1<0bithigh_bit($) = 2 ** bitSGif (*n5 AkE 9 ZL >w.append(if[V == -jeA: =  ?lse:6^= i Greversed(#Tpstruct Sleton-)  =0.__ T 8_member._name_ = None pseudo_member._valu- .# use setdefault in case another thread aly created a composit# with this v c = cls2f_map_.(H), 9)jreturn def __or__(self, !)::if not isinstance("!, 0.__class__, int)9=xNotImplemented[0resR = zJY<_ |)_U?andct & +xe^0__r# =o1__r  cinvertq O~P0 ghigh_bitP]1"""s index of .est bit, or -1 if is zerornegativ  M-.bit_length() - 1 unique(enumerationC{ decorator for .s ensuring K =u!s.duplicates = []PTname,9(in`#._Fs__.items(9came !=>.KY$u.append((%p2)6if .Falias_detail', '.join(e["%s -> %s" % (: , p): 'inp]Jpraise V6uError('X` found)%r: %s' %!, mo_Zre(flag,uxExtract all}s from the1 &# Wonly called65not_covered =[A < 0e3 HM#if_value and member_value & V== me7: s.append()#not_covered &= ~$e)if not negativeaPtmp =@/~while tmp-BflagY = 2 ** _high_bit(tmp7if 0!in.?2Jmap_cgF8[O]zD -'5 3C and6[3sort(key=lambda m: m<_, reverse=Truecif lenas) > 1PA[0].g2 ==m# we have the breakdown, don'.!ed@Qu itselfBrs.pop(0creturn)s,^"""Utilities for comparing filesdirectories. Classesdircmp Functioncmp(f1, f2, shallow#q -> int1cmpd`(a, b,z@mon)"R([], clear_cache() """ import os stat from itertools %filterfalse"Etype GenericAlias __all__ = ['xp', 'cmp  DEFAULT_IGNORES'] = {} BUFSIZE = 8*1024 1q@'RCSQ!CV@tagsA.git!hg0bzrQ_darc!A__py# __}Gdef "()@"""CNJAcmp 7.W.=oJV:Re two<!. Arguments:f1 -- First(S name2lSecondG!Just check  signature (doB rea+1s).defaults to R*`5 if.Bs arpsame, FT otherwiseIcThis f0 usIee pa0Bisonf0res,Cwith50ent~ invalidated"irpinforma=changes. TheFbmay beed by call#()Ks1 = _sig(os.qB(f1)-s22if s1[0] !=.S_IFREG or s2I[LFM= s22121[1}K2[1]+n False  outcome = _cache.get((f1, f2, s1, s2)) if.is None:Gcdo_cmpC:"rif len(f) > 100: # limit the maximum size ofk4RclearK(c[4] =Cereturn def _sig(st)" (stat.S_IFMT(st.st_mode),Grmtime) e l0buf< = BUFSIZE]with openF'rb') as fp1,72, 2Mwhile Tru@b1 =Ac.read(w;#2#2#if b1 != bs<8QFalseif not b14 # Directory comparison class. # r dircmpKB"""A that manages6B@of 28\Qies. J(a, b, ignore=R, hid "A and B areI IGNORE is a list0namoZdefaults to DEFAULT_A!S._ HIDNL[os.curdir, os.pa ]High level usag0x =Pdir1, 2x.report() -> print1 onhdifferences betweenE12Cdir23 or W_partial_closuregeaNm,w=scommon immediate subdg @;fulRlike R F@but ?y recursive~Attributes` left_*b, righ : The files iEjfiltered byi?:zin both4Donly ":  "6jk_dirs:Y0n8:0Dunnya where0typ394!or3S-ableSsame_identical* *9^`s whic1f2.RcouldDe#ed=sdictionary objects, key5names in common_dirs. A""" def __init__(self, a, b, ignore=None, hid ): # InitializeCP:.left = a@righb!ifQ@ is _:Jp = [os.curdir, os.pa ] # Names never to be shownIOelseW^+#if  = DEFAULT_IGNORESEp8 raphase0pRCompare ything except common subdirectoriesxw@_lise_filter(os.1dire%),8iQ + )8q %r Ts Zro.sort(i1i4uteWnH-a = dict(zip(mapFpath.normcase,)bM)NO&  = a.__getitem__, b.__contains;a))J_only M ofalse(R S8 Sb2DistinguishGes, m, funn0N]^N2/es0unn&"[]?for x inf o a_9" =qth.join6, xRb0Y12iok = 1:try(Pa_sta0os. ( m~OSErrorE# print('Can\'t I2', K, ':', why.args[1]]0b Q$K ^if oka_type =.S_IFMT(t.st_modeb553if m2!= B^on_funny.append(x)  elif stat.S_ISDIR(a_type):+:self.common_dirs.appZ?REGZOfile[ /se_funny/elB >def phase3(,): # Find out differences between + BExx = cmpIp.left, TT.righ ?_)'Bsame8 a = xx 4zsubdirectoriesK# A new dircmp object is created for each H'y,Gthese are stored in a dictionary indexed byOWname.@The hide and ignore propertiesYainherirom the parentGZes = {}x#  a_os.path.joinf b- .y>ss[x] =up(a_x, b$)_closureRecursively callr4() on u m&4()s <s.values(W2sd.AfreportPrint a  vab# Output!ma`purposUlousy+pe ('V'C ;"Z_only  .s=>n0Onl q(':_=z+{|4&, }b~~~Identical%s >wwwDwPxyTrouble witIyl()  print('Common subdirectories :', self.c_dirs) )ifefunny:%<f.sort(C% 'O cas!) c def report_partial_closure(v`): # P& s qelf and sM6.Rfor sd in s.values() &sdUl?fulRw recursivelyLQ_~methodmap = dict(=phase4,same_files({3, diff O1 = z32, g|2?$1, left_onlyJrigh:Blist:20, :M__getattr__ , `!ifE not raise AttributeError(O?[]xsreturn p__classitem__ = W(GenericAlias) 1cmpT(a, b, shallow=True"""Compare 9Gtwo .R5 --by name}1 ofM!Q founEboth?i;<if true, doparison based solelytat() informationRPs a tuple`three sCthatdse equal>Werent Baren't regulars/1"""4res = ([], xm; ax = os.path.joinx5b 7b, res[_cmp(ax, bx)].append(-res # B. # S0: #zP 0 01)2ln0(ca.stat, etc.) #sh, abs=abs, cmp=cmp'trAabs(A)-except OSa:2 a copy with lsPoccurskip removed.filter(f_ , # return listf(filterfalse(skip.__contains__, flist)) # Demonstration and testing. # def demo(): import sys import getopt opGs, args = .(sys.argv[1:], 'r')5pif len(3b) != 2mqTraiseF GehError('need exactly tworr', NoneWdd = dircmp\2[0]2[1]"if ('-r', '') in Pdd.re_full_closure(?Oelse+() if __name__ == '__main__'0TJ """Helper class to quickly write a loop over all standard input files. Typical use is: V$.for line. wprocess(+) This iterates1theIAs ofN s Ye$p defaulWstdin if Jst is empty. If a RC '-' it is also replaced byiM#he aluments mode openhook are ignored. To specify an a>Pnativ st@s, pQit as1argfJ. A single allowed. Func1&%1(),Xno() returned cumulne numberM ne that has just been read;ia s  Jiubcurrenh; isfirst(s true ifDrm71itsQ M M11wasV from4. <P next0() e 2 so/Bwillbq 1a (if any);Rs not;, Scount toward  ";;6=hanged until after(1rstN $1() sequence. Befor yXfs have5,hAboth7s[Xzero;no effect Qs ; s)f:%values per0ing"$la3]Q All/BtextG3by , you can0ridxis by set"he6aparameo() or FileI.__init__(). pn I/O e occurs durr a file, the OSError exception is raised. If sys.stdi8used more than once, the second and further use will return no lines, el perhaps for interactive9 , f it has been explicitly reset (e.g. using.seek(0)). Empty files are openeimmediately closed;only timPeir pkance in qlist ofUPnames/noticeable at all1whe3Q last0@is e`t+Ppossi>Bthatg4.la>doesn't endPa new#@ cha;Per; ozPwise e5@clud.trailing G. Class FileInpu*implementa ; its methods@(), sQno(), visfirstM@next!()8() correspO!to@func{smodule. In addi,ba reador which sS|! i+,a __getitem__()>APsequebehavior. The must be acces7in stric&tial ord2ce 0QcannoP1mixOal in-placevtering: ifkeyword argu+=1 is pa to@ut()usconstructormoved to a backupestandard outIdirected a|L. This makN&t o write 0teruAt resGA in ="."also given,Mspecifie,M? p remainound; by defaultISis ".bak">izP dele0HL[#is 0dis!d @0ead. XXX current  t yAworkMS-DOS 8+3systems. JPts: - ofgetopt0pro- isatty() - 2(),size), evens() """ import, os from typK GenericAlias __all__ = [" A", "z `  s no & "#2!is U hook_combYsed",Oencoded"] _state = None defx s=,cFalse,="", *, mode="r", openhook=None)<: """Return an instance of the FileInput class, which can be iterated. JThe parameters arqssed toNconstructora.Ir%ed, in additionRQbeingt1or,=keeps global state for@func>s~is module,w1"""B<_=2if C and b._fileDHraise RuntimeError("i;() already active")UR=e(Rsplace, backup,e=mode, openhook= M/ def close()@"""Csequence.$ =QANone"ifac$7.z@next=current & s+!at; ePwill IQfirstJline from5K(if any); "Rs not?,'WH count towardsP`cumulaG " . ?aname i]Echanged cl afte|B\has beenaBefore: )t, this  no effect; itCbe uGskipY5. ABlastnI*f c!ifE16#no) @1 .?"()h  hemz2ly M] s 7F/no Unumbew?Q thatOjust"0A:E ACa\LwLZjJ! !inNLY/. @AC ?GCC  within the file. """ if not _state:raise RuntimeError("no active input()")0creturnC.filelineno() def ^yR61the! number of qcurrent. When noC is !lyopened, Qs -1.jBpisfirst/()as true% just read@ aof its,`otherw_falseL _stdin iBlast2wasfrom sys.Ekclass FileI ([0s[,lace[, backup]]], *, mode=None, Ahook!) Cbimplementationqmodule;qmethodsEqname(),V{,#3 C, is&0J@nextN () and close() correspond to@funcsPsame H!in&pIn addi5 it has a e whichU"pu7,a __getitem__()BBs@sequence behavior. The mwbe accessed in strictH*tial order; random20can:be mixedt__init__(selfsP =FU0=""U@f<"r"e'if isinstance( s,#3 = "/elBos.PathLikeJos.fspathT8), VsThis 7-argv[1:](?V('-',Z,elHs = tupl:7$._#0inp$ =# /# =8 savestdout =  0out:Astarno = 0 self._filelineno = 0 `self._{ = Noneisstdin = Fals`backup>LnameB# restrict mode argument to readingst!if not in ('r', 'rUUrb'):/raise ValueError("FileInput opene must be one of "FJ "{ and 'rb'")8`if 'U' import ward. ("DA is deprecated",h4 D'BionWb6, 2T=PKgwrite_ .replacepCw') ,else 'w'N!ifbKhookAf inR  0canqause an\`fSU!if3callable(7 ,+ 7,QoC*=l def __del__(+.close()-+:try: P.nextl(ofinall-Hs = m~__enterpreturn gc__exit-, type, vjp, trace>?__iss[while True! = ._T 0if  9( qno += 1# tEalStopIterationC< {=peat with % &sgetitem.7, i1tBings} A"Supfor index~Njbjects.IP"Use ator protocol instead. stacklevel=2cif i !7no(GdRuntim!`access40s o+wf order   __'__lyexcept  I[0endireached"e L`avestd%_s*self._savestdout = None if savest:Bsys.' =% %AoutpRbself._ v:tryl2if ? .close()_kfinallG@file /J  Bdel 7readline # restore FileInput._ qexcept AttributeErrorIpass81if sand not~isstdinU0 9=`backup86namK  6" %c,;if )  os.unlink(+g"OS| lL = FalseDdef () whpFTruey(== 0if ' 9=d ._ }no += 1areturnC 'ifEa;y@next7jpeat with %# $ sif 'b' in/;modN9b''?els-,T Es[0]T(sGLs[1:&Sstart;PO = 0m ,7   YZ= '-'yG#1 'cM = getattr(Ain, 'buffer',   W:B,!Voinplac>t _(Uvos.fspathOC) + J or ".bak")J_I   Qpass # The next few lines may raise OSError7os.rename(self._fil", dbackup)@& s = openH 8NNmodeDMtry:Y@permWss.fstat[m.no()).st_W Adexcepta`outputi`4ameQwriteiOelse`Xs.O_CREAT | o dWRONLY]TRUNC if hasattr(os, 'O_BINARY')q4u"|=i/ ]"fdF , f ;As.fdI/fd4Cos.chmod [@savestdoBsys. ?# =*F *i$if[penhook1 =,16b X@readG. # hide FileInput._Kcreturn "()@def S 9%7/no5 Rstart(# +IKO ' ;3 7 "G#QValue [#J%-19$%aisfirs,V == 1bisstdi@$5__class_getitem__ = method(GenericAlias) F_compressed(^:!, D?path.splitext,A)[1]1if +r= '.gz'=Cimport gzip)3.C {)(elTbz2': import bz2 `return .BZ2File(filename, mode)+Qelse: 85Mopen. def hook_encoded(ing, errors=None)O-H1 L"q $, ^= gnk c_test(import getoptinplace = Falseibackupopts, args =?.F(sys.argv[1:], "ib:"for o, a in @if o == '-i': 2Tru%Eb': a\@line\`input(,L=T,8=?^@Q[-1:]P\n': ! =Q[:-1]l/r/ print("%d: %s[%d]%s %s" % (cdno(),  vzpisfirst4() and "*" or "",) )) if __'!__#__main__'Z@ """U) matching with shell patterns. fn!(FILENAME, PATTERN):es accordC to the local convention.FOcaseJalways takes %%Wunt. The funcLs operate by translat|$he into a regular express They cachecompiled- - s [speedy%e(swJ correspon'7. (It does not P it.) $os posixpath$re #ools __all ["filter", " lI e"] # Build a thread-saf@cremng counter to help cre`uniqueKexp group # g&0roslls. from itert Wa _next=Rnum =mA()._P__ de^2unt0(h,5"""Test whether  P are Unix bstyle:$*es everyt?C?any single character)u[seq] )"2seq)!*q).0in ()An initial periodFi_special.2FBoth-normalized8!if9zsystem requires)If you don't want this, use fnmatchcase(FIL ENAME, PATTERN). """ name = os.path.normcase()"?pat!2pat return fnmatch=!, ": @functools.lru_cache(maxsize=256, typed=True) def _compile_pattern(pat):if isinstances, bytespat_str = str#'ISO-8859-1')3res)translatR %" =d(1., PQelse:Z9 = VR+3re.T!).9 afilter~sBW)"""Construct a list from those elements of the iterable qS that f.Presul![] B=B$ifJ is posixW$# b2 on!*NOP. OptimizT awaybe loopD@for 1 ins_"ifEr.append% e9wK"""Test whether FIL es, including !. @Thisqa version2() which doesn't8-Qalize@its argunN)ynot None 7 a shell to a regular expres2ereg T to quote meta-characters@STARdbject(Cs = ,add = resI6i, n = 0, len|9while i < n0c =""[i|qi = i+1Kf c == '*'8 # @ consecutive `*` into N(@if (gpres) orB[-1] t a9@add(4eli?-''.^,[,jY@if jA and!j]!:,>j%@]@ O!= 'C(>=7\\[ pTstuff&:jif '--' 1in 0 stuff = stuff.replace('\\', r;) ]else:%chunks = []  k = i+2 if pat[i] == '!' SO i+16while TruvzZpat.find('-', k, j,if k < 0"_break.append(?:k]tO = kP?k+3pljl*# Escape backslashes and hyphens for set difference (--).z3# H7that create ranges shouldn't be evdG` = '-'.join(sm_r'\-'Q5B in +6operations (&&, ~~"/||re.sub(r'([&~|])"Q\1', $t_i = j"if2$[0W6C^' +3.1:](elRin ('^', '[')Y %\\Z add(f'[{'}] Y,2re.2(c) assert i!n a# Deal with STARs0inp = res%'reF2addk"i, n = 0, len(inpq# Fixed piect the start?8MQi < n0inpais not ]lRi += y# Now d! f "..# For an interior `&` pairing, we want to do a minimal # .*? match followed by `v"`,Vno possibility of trackingPWe caaspell directly, but trick itPo worCs3ing in a lookahead ion, saveDa$0`group,nG`consum01at a via a#re@. If6 overall$Sails,J 0 wotry alternatives. SoRatransl,2 is#  (?=(?P.*?`))(?P=30# G Ss areA needed: g0, g1, g2, /The number9obtained from _nextPnum()/Pensur*ey're uniqueacross call across threads. sC.append( 0` = "".(2i.*?{w}))(?P=)iJ7res2resm)return fr'(?s:{res})\Z' """Generic output formatting. F er objec$ an abstract flow= events into specifdvon writ^%. q nage several stack structuPto alxvarious propertiesa\Spe changnd restored;*ps need npbe able5BhandDativBs nor any sort of ``\ back'' ation. Swhich may be controlled are horizontal alignvq, font,7left margin indentps. A me0ismprovided qsupportG viding arbitrary, non-exclus@styl' nas well. Addial interfaces fac4ater sible, such as paragraph se aI. WF encapsukp device4. As_f4!s,n2 as physical]`s. TheP` impley work with4~=# makes avails21 seu}r;Q1 maEPo@dataoF.  tort sys warnings . E('thper modups deprecated', D BionWH,level=2) AS_IS = None class Nulle@"""A#er0doet$!. j!IfzParame!is omitted, aaE instance is0 created. No methods of the writer are called by NullFormatinstances. E$Implementations should inherit from this class if i2Sing atL interface but don't need toQ6anyBt2"""def __init__(self,dq=None):k#if@ is  =W%()=Y.# end_paragraphpblankliU pass-@add_a_break..):#hor_rule!, *args, **kw.label_data0fP, couf%, rxflowingFQo8aq+flush_softspac Op#PalignV *1op_) "LCfontGx!5op_ >cmargin@ (2op_' @set_1ing #,  )6sty s(1op_O@# S` handlpolicy: 2Qes at2pboundar twe!# LKMfRouterontext. "LB " not checked # : de<Rine c<D, soBin lGF|QLkin allWA <5`# OutpQevicev8! =t# Current %<_stack = []<A7*ck:9p # Font5t71# M7# Verticalb.writer.send_D)%()J*)ha"iff:<H and@ ) -e= &" =m$no!\[ )adS+.}"or~o3oF%<)0 1+hor_rule, *args, **kw7z  l% !B S_dataformat, counter\ = No^(or\k\ H '?&((v1) or 0if isinstance(7str 0.;_.J)rOelse ZW>g vD^)", #3Q = ''BBfor c in 6 if c == '1':M+ ('%d' %-!elLain 'aAM  if counter > 0: label = + self.format_letter(c,G)C ela in 'iI'_)_roman~.setcbreturn Jdef f, cased\!''?MTwhilee~, x = divmod(j-1, 26Q# This makes a strong assumption that lower s# and upp$ two contiguous blocks, withE[iorder! s = chr(ord(Z) + x-3s +t  0one['i', 'xc5m']3fiv%vld `, indeU'', 0=will die of I)Error whenis too big>'J, 10F if;6= 9C0 = [7] + +1&8ox == 4UMdTN>= 5hZ !=x-5/elr2W/-*xW0 = * "f# =65+ 10aseV' .(add_flowing_data( )Mpif not ": Iprespace = q[:1].is~Apost'?-1:(c = " ".join(.split()"if>"noT "orG2sof< U/. >%"b' ='parskip =#! ;B = ' ' +8hard_breakJpara_end = \;  self.parskip =have_label = 0 '+softspace = pos # writer.send_flowing_data(!) -def add_l+"al a!, &:&vaif not: return4.7;E" ")J+hard_break =q[-1:] == '\n',$no;para_endCE = \::| 93Yeflush_(h)"if!..  4Nc TQ e4a1@  c7' 'bpalignment!,  B and# ! Anew_#^ R" =[_stack.append(JOelse& 9'op# .5M k2del."E[-1]N B`%3 S;h u = NoneY +8=%fo8 :size, i, b, tt = jd>#> cci, cb, c2 Uize is AS_IS: F1 = N$i(i%i"b"b"b"'tt#5ctt%@ = (a 7 %(30op_j,hfe! U@ 7U d C' font = None self.writer.new_font(!) $def push_margin(0", !):#J._stack.append())f = [m for m in >e if m]5cif notvR and Gk# =6[-1Bb,b, len(S)(op.if >del# p 8 nOelse.  T# set_spacing-|3 =  (Sstylel* sl@softA lhard_breakpara_end>E = 0dA!no[N = 1send_flowing_data(' '1or si" PH'sSs(tup%.D K7n=1G#>O[-n:Q)yassert_linei, flag.j 6# tparskiphave_label class NullW"""Minimal ] interface to usetesting & inheritance.8A9which only provides th@Qdefinition; no ac Bs artaken on any methods. This should beSRbase [$als$!doL@need]implemental1"""F __!__<b): pasc_flushPalignd"!,  C)$ #?vel. zW PkBgrapp, blank.v$chor_ru, *args, **kw/Eh *end_flowing_data(self, ): pass def send_literal_!, class AbstractWr0R(Null !):Pa"""A w0 which can be used in debugging formatters, but not much else. OEach method simply announces it by printTits name andA arguments on standard outputdA""" , new_align54n*("+%r)" % (-:,))SCfontN M(H GcmarginI , levelR#r(%r, %d6 sspacinga[ dstylesR QP OparagraphSblanklineV 0Z2]Ha_break^S&')"Bphor_ruleA, *args, **kwN1LOlabex,~flowingW .Y BY . YnBDumb_jSeousthe file object5as !ameter or, if7is omitted,O JQ TheK[4 isword-wrapped toi@numbaf columns specified byHumaxcol .g2is cpuitableL3 re a sequencfC6s__init__(r=None, 7=72u.$" =or sys.stdout'@# =I8.})"?greset(c ):= 0@!at /T X.Of('\n'*)QD v l def send_hor_rule(self, *args, **kw): .file.write('\n')1-'*2omaxcol)Gzcol = 0\qatbreakdef send_literal_data E@i = k.rfindif i >= 0 4 IPe[i+1:]g.expandtabs(T_`+ len(; (flowingaif not: returnX!or/[0].isspace K1 = JDV for word inzw.split(n3if BK).2 OOelseR  )5Q5+ 1 , =  "' =R5;/0f8[-1 fPtest(s = Nonew = DumbWrf = AbstractFormatter(w1if G!isL8fp = openk1elif sys.argv[1:]/ ]6X$Bstdi7tryIpor linej&fp"if0==  ! f.paragraph(1if.add_;gfinall5#p 3 tfp.clos 0) if __name__ __main__'K) # Orig) contributed by Sjoerd Mullender. # Significantly modifi.Jeffrey Yasskin . """F0ion, infinite-precisreal numbers.""" from decimal import D Dmath <operator$re sys __all&4 [''] # Constants relato the hashlementation; 0(x)based # on0Preduc&P of x9"ulJprime _PyHASH_MODULUS. ;0ys.w_info.modulus # Value to be used Lr als that reduce to infinity modulo # _PyHASH_MODULUS. 6INF = sys.hash_info.inf _RATIONAL_FORMAT = re.compile(r""" \A\s* # optional whitespace at the start, nH(?P[-+]?)NF# anK% 8=\d|\.\d4@ # lookahead for digit or . w|num>\d*@ # numerator (possibly empty)<:g# followed by-p (?:/@denor@+))?=  inw9|#A# or$]"\.^Qcimal:)? ]CfracGpart=E<2exp!\d=d{rexponen7_\s*\Z'an=to finish """,WVERBOSE | IGNORECASE) class F(numbers.Ra!):"""This .implements r(9 0 In{ two-argu,$Am ofconstructor,}8, 6) willEPprodu f equivalent to 4/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 integers__slots__ = ('_#W', '_# We're immutable, use __new__ not __init__c4defR(cls,pG=0, d =None, *, _normalize=TruesD"""C5s a#@Takec like '3/2.5', an51, aI /` pair,!a zEsB-V >>>b10, -8zqf(-5, 4 5%1, 7), 5(3@ 5_2, 3)MO3, 1_'314'4V14, 1 _'-35/7*-3>>> Fraction('3.1415') # conversion from numeric string Fraction(6283, 2000)E>>> !q'-47e-2]E may include a decimal exponentGCo-47, 1b1.47) # directAstrufloat (exak6620291452234629, 45035996273704965 F2.25PA 2D ('&')&=15""" self = super(5, cls).__new__(  2if denominator is None: if type(')(:int'+%._)" =.5 S,~== 1&preturn Y?elif isinstanc,tpbers.Ra?al). *._.. :!(#, );# E z,Kas_integer_r?(v!?stroHandle-s. m = _RATIONAL_FORMAT.match 6@if mraise ValueError('Invalid literal for}: %r' %hJ }L = int(m.group('num') or '0'7k5 = /)6p;els?1C$ 1!$scale = 10**len(5-k "* I+E"*=<8exp?exp?expI?exp if/_ >= 0L *=exp  delse: denominator *= 10**-exp4 if m.group('sign') == '-'_QnumerU5= -  Wraise TypeError("argument should be a string "Q "or a Rational instance")elif type() is int') pass # *very* normal casea4(is}h, numbers.Y) and8: ', 8I = (_5+. ( *6.B,? AM? >) Tboth s  "_s(if0ZeroDivisionP'Frac[(%s, 0)' %Bif _+izg = math.gcdTH +< $U%-gXZ //= 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{e"( Decimals, not %r (%s)" % (cls.__name__, dec, type(dec)%))9return cls(*dec.as_integer_ratio()) -Mdef aself): B"""RPCthe H H as a tuple.Q1.t of two9s, whoseAis equal to theuFraction and with a positive denominator.25""" (p._numer-", @glimit_?X, max1=10 "Closest !tomU at mostW@5>>>H('3.141592653589793').&10f(22, 7X#Y311, 99[4321, 8765/00T6K# Algorithm notes: For any real number x!fine a *bUupper# approxim  n*zxb2nNp/q such that#O` (1) ) >=~:andR2) if!P r/s 'n s > q, f al&l!De\lower similarly. Then it can b\# proved" ai:A or k C=Qx if,Aonly 1it Jconvergent oHsemif (unique shortest) continued fpssociat?o x6To find a  fW<= M,l"weGIY  s? [9take whichever,@hese:cSr]1 In(!evQf1ie,4bou.xsmaller+7 iscn. If both*Ss are(CghappenDwe $Q == 1qmidway betweD)Lr---i.e.Afloo"T,GnC,if`F < 1raise ValueError("pshould t least 1"!if.< <=z vKFraction(self) # p0, q0, p1, q1 = 0, 10$n, d = self._numerator,pdenomin2while True:qa = n//dq2 = q0+a*q1if q2 > max_f SWYbreak; 0, ph 21d, n-a*d [k = (g-q0)//Pbound>Fraction(p0+k*h 5q1)Q,,|"sif abs()-hF) <= 1-) rreturn 7o;els(1@property7Edef '(ag;aAC"Ex__repr__(0"""1"""'%s(%s, %s)' % (.__class__.__name__,8<w)/st1str)!if._ == 1C#g'%s/%s _fallbacks(monomorphic_$,  `"""Gen es forward and reverse Gs given a purely-ra7%al*?Qa funY from thK module.Use 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(, (int, )?'." *.+`A JIator,   self.denominator * other,) C(# float and complex don't have those operations, but weHknow about6types, so special casS=em.@elif isinstance(,-):/breturn#(2) + /^` %b @# Lee take over@NotIuymented def __radd__~,\ # ' handles mores than add becauIre'sjN# nothing left to fall back tonumbers.R./all@FracV@.numf- +I 6 J,H 6Lf/Re  dCp &ik AThere are 5 differents for a mixed- @addi5 onA. I'll referyx`of theP`ve cod8at doesn'tC4L3E, oras "boilerplate". 'r'C wiTe an ~F of Qwhich is a sub%of?U (r :6D <: !),^vb : B <. The firs@ree involve 'r + b':Q1. IfJn_, intC, we3Dthat"lyxzis well2ss^Pivw23to [a value from __`'d mis ipossibilityt B defineintellig? -sodshould  C. In particularB @?`, even10ughc ge exact answer, in case the other type wants to do something special.=#3. If B <: Fraction, Python tries B.__radd__ befor}81.__' . This is ok, because it was| implemented with knowledge of soA= 0:*return Fraction(a._P2 **@,;?a._denomin=_normalize=False)sYelif  - </se*(-c)dA? /elS# A f]"alO will generally produce an`# irraal number.%qfloat(a bF6!b \def __rpow__(b, a)@"""awAb"""-Jif b== 1 andq # If a is an int, keep it that way jssibleisinstance(a,B3s.RS0R G, a.Ce/:7$^"fkpos__(+a: Coerces a subclass 5 tol., >neg/-an  \o/aboabs(a)s "')^trunc { <~}-0 //gf=  A >^floorQmath. aa_Oceil^ ]# The negs cleverly convince 0divreturn the ceiling. return -(-a.numerator // a.denomin!) 1def __round__(self, ndigits=None):'[1"""( &H!RFs half toward even5"""N$ifh@ is kjM floor, remainder = divmod , @'ifD]* 2 <1 y9C-elP>PI + 1T# Deal with the@Jcase{ % 2 == 0! P / shift = 10**abs()# See _op__fallbacks.forto check thatresults ofGbthese Hions will always be Fraction andFPrefor%'veF)k_>)%Z(=G1 * #),c,el@F/>OlChashk ])(z# To make sureN/W of a#@greeBJ'shH-ically equal integer, float or Decimstance, wm`follow rules for X es outlined in)documenta@. (Ilibrary docs, 'Built-in Types').A:trydinv = pow='._, -1, _PyHASH_MODULUSexcept ValueErrorZ#` means reno modular inverse|5_ =|5INFL# The generagorithm now specifie}Iabsolute vP{#5 isu (|N| * 7[) % P"pwhere N!._2P Q. That'moptimized T 0wo : first,;a non-negative; i,P0(i)iB, buV3intEmpleZ doesn't needM toLAide,is faster]pn doingd explicitly. So we doL! ~V "pinsteadCbecond,^0unb0ed, so its product K mayMbe arbitrarily expensive to compute. The final answer is the # same if we use! bounded |N| % P instead, which can againJ!be done with an int hash() call. If 0 <= i < P,i) == i,Mso this nested+H wastes a bit of time making aGredundant copy when1but@savearbitrarily larg+Qamounseation for.Y.2_ = (abs(self._numerator)) * dinv)<cresult9_ 4 >= 0 else -X_;pturn -26HB= -1. /def __eq__(a, b):@"""aEb"""if type(b)I6int04!reyaC and a._denomin1X iscance(b, numbers.R`'ali(j.St`4'b.?if Complex)cp b.imag0 b = b.real R[floatif math.isnanj$orHinf(#warisons| finity or nan should beh K# 1way0any@pite a, reat a as zeroE00.0b %2nqa.from_&(b: # Since a doesn't know how#arb, let's g  `# a chw7 itmJ @NotIgmentedMqrichcmp, other, op"""HelperbG2 op!s,PinterRonly.g4| between a 7` `, ei1 an5Qor a ! `$`A  noxC", ;> Cf. `op` Ghe six standard?9" Rnvert$where reasonable  o *v  8=r) if isinstance(other, float): if math.isnan)D) or3inf 7Breturn op(0.0, e)]Oelse8 `self, a.from_pJFzNotImplemented {def __lt__(a, b"""a < b"""* a._richcmp(b, operator.lt)UgU>UgU/le=V*leV>VgV@bool UH!= 0V# bpo-39274: Use 9() because (a._numf >c) can %an# object which is not aQ.&8f[# support for pickling, copy, and deepPreducGm(.__class__, (str3),)yY"__ rif type == Fraction#m # I'm immutable; efore I am my own clone Ez_denomin $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 Exap: >>>  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{4 Nov 17 1993 lib drwxr- 6 1094 Pwheel 1024 Sep 13 19:07 pu;`3 root- ;Jan 3 1994 usr -rw-r-F 1;DIp312 Aug";$welcome.msg '226 Transfer complete.' >>> ftp.quit()(1 Goodby A nice test that reveals some of the network dialogue would be: python ftplib.py -d localhost -l -p -l """ # # Changes and improvements suggested by Steve Majewski. # ModifieJack to !onKmac.'pSiebren*support docstringsLPASV6Phil Schwartz<add storbinary8lines callbacksGGiampaolo Rodola'KCTLS q. # im5sys ocket from s *(_GLOBAL_DEFAULT_TIMEOUT __all__ = ["FTP", "error_replyFtempGpermqroto", p"VI@s"] _agic number <.h> MSG_OOB = 0x1A# Process data outhPband dThe standard FTP serv`ntrol / FTP_PORT = 21 # 5 izehint parameter passed{@read!()s MAXLINE = 8192zException rai8when an  or invalid response is received class Ex(K!):I()(# unexpec [123]xx  CBb # 4xxs55556#  does not begin with [1-5]ZTAll e^s (hopefully)udmay bewAhereharen't # (always) programming on our side 2 = A, OSpQ, EOF )0Linrminators (we hput CRLF, but ac @ anyCR, LF)  = '\r\n' B_b#citselfAFTP:tQ'''Anqclient -!. To create a connec,-0 usthese argu[_cq, user,0wd,t, timeout, source_address, encodinghe first fsg a3ll b,have default value ''.'he#´p´ mustqnumericIDspNone ifpJb, meanTat noP willP0set*any ftp socket(s). If a timeout is passed, then this0now default0for all ftpMsocket operations "FrnstancevThe last parametergthe encoding of filenames, whichs to utf-8. xT use self.connect() with op al host and port argumentCo download az , Rftp.retrlines('RETR ' +"!), or*dbinary~slightly differenzs Oo upx3stox#) aazphave an{n5 asP (see irC0inisQbelowsdetails/Afunc:P firs/sue appropriate TYPEWg@PORTPASV command2'''`debugg1= 0:A= ''`= FTP_O0max = MAXLINr|q = None&=xwelcomeiveserver = Tru<.# Disables https://bugs.python.org/issue43285 security if setJbtrust_c _pasv_ipv4_address = False @f __0__(,1=''r !wd @acct =_GLOBAL_DEFAULT_TIMEOUT, source=62, *RF !='q5'):n@"""IKAaliz method (called by class i!ti&a]?e:Plocal,0to 9@dardbZAOM(| 5Quser,@wd, I 0wlogin()5""".% = ! \+ =m -$ =U!ifp')0 ifr48)Senterareturna.# Context manageL protocol: try0quiif activ_ deCexithw, *argsoK1lf.ais not :tryx except (OSError, EOF w@e =ofinallnTgclose(u4=0,_=-999B'''C~!C. As are: - host:name to connect (string, default previous14) q- port:9DintegerE4 Etimeout: the Oset againstftp socket(sA source_address: a 2-tuple (,Q) forHDbFbind ras its S St before%Eing.75''' !if#u != '':0Pself.! =$!ifO > 02-! ="2&!= -9999"=R?"is not None and ! ]raise ValueError('Non-blocking# (]C=0) `0sup6ed'#ifi- x-=>sys.audit("ftplib.0", I $.' cr.create_HQion((&D , =a  af[u.familyt@Ifile%@make('r', encodingm gewelcomGgetresp(&areturn\.- sdef get3)R'''Ge" message fromVerverpP(this(Areadsquirreled away by;())debuggingprint('*#*'sanitize)Aset_pQlevelC!, S,%`The rerrgument%f meansf0: no Joutput (11: commandsPonses butbody text etcs2: alsoDraw lines <U pp$XCR/LF " =@1bugG\_CpasvY:valWUse passive or act Amodedata transfersWith a false amQ, usenormal PORT L9?tru8DPASVl.sb = val# Internal: "@" a T!ng3ing6$f ((self, s):  if s[:5] in {'pass ', 'PASS '}:  i = len(s.rstrip('\r\n'))&3s =S+ '*'*(i-5) + s[i:]*return repr(s) (# Internal: send one line to the server, appending CRLF<pdef put.a(self,9)pif '\r'%u or '\n)raise ValueError('an illegal newBcharacter should not be contained'sys.audit("ftplib.gcmd", a=& +elf.debugg:> 1print('*put*'a.sanitize([~Q.sock1all!q.encodeK Oing) zcommand (throughz1cmdc$: ?cmdbdIfromfpaf.1# R1EOF@connection is closed1&ge,file.read@.max F + 1H!if1) >;)  ("got more than %d bytes" %A f ~ c/gec!ifL0,[-2:] == 9vine[:-2W el"1-1:= 1=]/get a response .which may possibly#sist of multiplRs. Ra single sng with noAUtrailA If0conasb,Bphese arB`parates; G5A[3:4:'-'c3\while1nexO;x&}_A + ($+ @,]1[:3\& P=!= 2UbreakHn( various es indicates an error def getresp(self): 0 = .getmultiline()#"ifdebugging>Eprint('*J2*',,sanitize()Lh1las0 = E[:3]mc1if c in {'1', '2:3'}areturnRN9k== '4'-aise error_temp858Kperm8rWSproto Ydef void """Expect aonse beginning withA."""LyH p[:1] !==SreplyZOs\abort@'''A a file transfer. Uses out-of-band data.OdThis does not follow the procedure fromRFC to send TelnetG0IP \Synch; thatUn't seem7BworkF_servers I'veFtried. Instead, jusA!ndABOR commkbas OOB5'''D:P = b'.' + B_CRLF KJ > 1Oput urgentUg UPsock.@all(!, MSG_OOB~2&v0426s22256|M1cmdOW, cmd@'''Sas3nd G%.^0putVPx9  !) 4 ?"""e[. (&pv, host, .EPORT36-qcurrent=+QgivenRv number\hbytes =E.split('.']p!`[repr(Q//256), %2\"+ Dqcmd = 'N','.join(9{DJF#epF On EPG?6aaf = 0f = et.AF_INET"/ 196:2: if af ==W 0:  raise error_proto('unsupported address family')< fields = ['', repr(af), hostCe), '']6 cmd = 'EPRT ' + '|'.join(O_ return self.voidcmd(cmd) Kdef makeb($)'''Create a new socket and send a PORT commfor it.'''Z2# =9!.cM_server(("", 0),=}.af, backlog=1H@.getWname()[1] # Get proper *B74 <0</<"if3Eaf =vAF_INET#Erespf0end(L,Oelse; Oeprt;timeout is not _GLOBAL_DEFAULT_TIMEOU3set<. ';ock1asv4""""Internal: Does the PASV or EPSV handshake -> (?"""h untrusted_] = parse227.'&')FH_pasv_ipv4_ 8p: = "8Pgetpe70@</9i2'),aTntransfer6P, cmdx|st=None2iti9Q overdata connection.f !If!3is activeK6KO5thec8l,aacceptYu# mh5 isGIpasst4asvt,b to itbAstaraC . Either way6m0et *Pexpec#jsize o+G. T  ,pmay be  if it couldbe determined Opal `rest' argument canMa string thaisa5to a RES is es;ially a Bmarker usedrAtell'Bskip\Aany \ upObgiven M.]aU=$  t ,makepasv()  conn = socket.create_ection((host, port), self.timeout, Bsource_address=I )PItry:gif rest is not None%)_endcmd("REST %s" %? i/@resps6>cmd) # Some servers apparently 7 a 200 reply to# a LIST or STOR command, before the 15B?(and way02226r). This seemsbe in viola1 ofs protocol (which only allows01xxerror messages for%o we just discardFtx]onse.!p[0] == '2'A0get(M_!= '1MQaise _(P Onexcept2o.closerY;elsBwith[@makekQ() askkee abov,V8`ock.ac"ifv_GLOBAL_DEFAULT_TIMEOUTsC.setD( ZBp[:3;150!# 1is condi al@caseoreceived a 125msize = parse150`returnW0n, + =def transferEa, cmd,D=|)"""Like n4b) but asVl1"""j$o CqF)[0]QloginM, user = '', passwd Aacct @'''L;, default anonymous.'''!ifa[U7 4 68 / - +x6= 'y Z@in {J'-'}N1# Ire is no anonymou s ftp password specified # then we'll just use anonymous@-We don't send any other thing because:5- We want to remainb, stop SPAM%W1letPsiteshdiscriminate by+r,L host or country.!?2d =HVd + ''+resp = self.cmd('USER ' +x),0if /[0] == '3'0 KAPASSKM+AACCTMOacctK\!= '2aise 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 parameter@ablel!beed on eachr2 of9ream : The maximum number6#by:P fromj socket at one tim&[default: l]:rest: PassedtransferF). :]QR T`onse ci5""" P.voidd'TYPE I'MBwithN=) as conn while 17=2e.recv(ns(aif notI!Ubreak-(l V# shutdown ssl layer@if _SSLS!isk and isinstance(,,&#.unwrap(v"()_lines0 = m?8p, LIST,ONLST n optional "ha!;all:4 the trailCRLF strippe=-`print_J/()52!ifh; callback = print_line resp = self.sendcmd('TYPE A')&Bwith$transfer(cmd) as conn, \.[  .makefile('r', encoding=rG9fp:Czwhile 1\ = fp.read(N0max F + 11pif len(!2) >1b1raise Error("got more than %d bytes" %Ivdebugging > 2pprint('*retr*', reprW@not MYbreakNine[-2:] == CRLF@Z! =a][:-2]K%elM1MO'\n'M1Mcallback l# shutdown ssl layer!if _SSLSocket is None and isinstance(,)#.unwrap(ubreturn@void31() def storbinary , cmd, fp, blocksize=8192, =!st P"""Sti a 5B in \ mode. A new porcreated for you.HArgscmd: A STOR command.-@ fps-like object  a hQ(num_y) metho@: The maximum data 1 toF from fpq; ova theCection at onc[default: XPbp: An op8al single parameter1ablHalled onR each2 of afHi=vsent. rest: Passed E):R{ ^0ons&de5""":vIB/ 6buf( DL!if:bufZ all(bufXU?bsaF le in line mode. A new port is created for you. UArgs: cmd: A STOR command. fpfile-like object with a readline() metho;callback: An optional single parameter 'able thaalled on each t0 af?i4sent. [default: None]iReturnThe response cEp5""" self.voidcmd('TYPE A') $transfer(cmd) as connm while 1buf = fp.TV1max6+ 1u0if len(buf) > 0`0raise Error("got morxn %d bytes" %Iunot bufeUbreak w if2[-2:] != B_CRLFA+T1] in*> =][:-1]`dC+7 '.sendall8 "!if f?# shutdown ssl layerCif _SSLSockeI and isinstance(,,)*#.unwrap(r"()def acct(), password\q'''SendJaccount name.'''cmd = 'ACCT ' +H! 4nlsZ*args a list of ~s a given directory ( the current)FNLST1argT  =Q + ('6argd6= [RP.retrbs(cmd,v.append=D3dirLapin longm4By 98to stdout5Olast argumenP funcU; allnon-empty5Ps befPiISancaten to>ELISTn (This *should* only be usaa path)NQunc =p ifas[-1:]lPtype({P[-1])'''#," =C~, R KQ+jWunc) def mlsd(self, path="", facts=[]): +'''List a directory in a standardized format by using MLSDCcommand (RFC-3659). Ifv is omitted the currentlEis assumed. ""=0a lof strings representTEtypeGRof inion desired (e.g. [",", "sizeperm"]). APReturgenerator object yieldua tuple of two elementsCfor every file foundT.&TFirst=1Qname,/second one!ctionaryGSincluvariable numberKQdepen'#on[ErverGuwhether@argu has been provided5'''D"ifa]d.sendcmd("OPTS>T " + ";".join())Q4 Ppcmd = "a %s" %i4Oelse1"'lines = []Aretra(cmd, 0.ap=sq_P, _, ! =L .rp(CRLF).partiF(' '_6entry = {}z_zsg[:-1].split(";"51keyqvalue =:"="4[key.lower()] = A  (!, 4)O`def re@from@, toA'''R+! a6.Yqresp = J'RNFR ' + Vixsp[0] != '3'raise error_reply(a?ro1voiQ'RNTOoddelete!il D#ADELEl)q0:3]{'250', '200'}? 3$cwG1dirg'''Change toB  if:{ == '..6tryRxLCDUP(Sxcept~ as msgR if.args[0][A;500+el 6 ' # does nothing, but could ^A'CWDM4 7cmdh, filename):# '''Retrieve the size of a file.'''+# The SIZE command is defined in RFC-36592resp = self.sendcmd('A1' +aUname)00if 3[:3] == '213':2s =#3:].strip(?!return int(s) <def mkd(Q, diruX'''Make aectory, Hts full path8 2voi@MKD i0# fix around non-compliant implementations such as IIS shipped C # with Windows server 2003jaif not)p.starts3v('257')Nparse257(J/rmJ YRemovL 2.2+RM2"pwmcurrent working rrFPWD'8Aquit -`Quit, Bclos`conneck+GQUIT,Jy3*s%0 Cout assumQanyth b)it:try B.y = None!if4 [B=.7kfinallDsock l!is" import ssl except IRError_SSLSocket}OelseEssl.,class FTP_TLS(FTPAB sub(0whidds TLS sup!to'a3Wscrib=R4217.svC usual to K!212icitly secur+FTP control{ before authenticatingsSL@dataM, requires userCexpl5askpfor it by callprot_p() methodqUsage exa>>> from ftplibj' tp('ftp.python.org>>> ftps.login() # login anonymously previ securing control channel '230 GuestIok, access restrictions apply.'9>>> ftps.prot_pswitch to y`e data|!neG>'200 Prot level set<Pfretrlines('LIST'ist directoryhCtent|%lynutotal 9`drwxr- 8 rootQwheel  1024 Jan 3 1994 .A.B2?binC6etcC2-wx @ 2 Sep 5 13:43 incomingHE1r-xHQaNov 17Q_3 libCa6 109413 19:07 puC3T5usr`-rw-r-C312 Aug 14 welcome.ms'226 Transfer completeBequit()'221 Goodby/#'#ssl_version = ssl.PROTOCOL_TLS_CLIENT ;def __init__(self, host='', user apasswd 1accAkeyfile=None, certbontext@ timeout=_GLOBAL_DEFAULT_TIMEOUT, source_addressK? *,Nencoding='utf-8'):("if#xt is not S and  <raise ValueError("V9extC arguments are mutually "O "exclusive"&s)DC\5 or- import warningsE. $("le deprecated/ av"custom3nstead", DLBionW:, 2Y.=_ #= % None:  context = ssl._create_stdlib_(self.ssl_version, ?certfile= H$1keyG)3 = #_prot_p = False!uper().__init__(host, user, passwd, acct timeout, source_address, encoding= %) def loginwv4=''y | secure=True):C2if  and not isinstanceZa.sock,SSLSocketDHPZauth(hreturn s+" IS j'''Set up0rol nection by using TLS/SSL.'''# raise ValueError("Alreadq"^ " >DPROTOCOL_TLSO0rest.voidcmd('AUTH'eOelseB;SSLBgWext.wrap_)et `erver_Qname=@ WJP.make(mode='r'2 I 1ccc+witch back to a clear- 9(',L (%?CCC Q unxY /2 ]GdataZ ! #  defines whether orHBthe Bhannel is0be iected.# Though RFC-2228Zfour possibl?jlevels_#@ 4217 only recommends two, C|Private!(C) means that nox6ityused on th#"-c#, n YPY,. xshould ;6'}raise error o(s IC__all__.append('FTP_TLSQ`s = (E[C, OS 3EOF qssl.SSL) _150_r7aNone rarse150@'''P Q'150'onse for a RETR requestzR s3expected '@ or x;!isIguarante.obe present inP150 messagem1!= zRreplyesglobal $ifKimport rF: = re.compile(H{ r".* \((\d+) bytes\)"(.IGNORECASE |CRASCII4m =g.match!if6mint(m.group(1)?2272227bU =227KPASVs if it doe ain '(h1,h2,h3,h4,p1,p2)B0 ('i.addr.as.numbers', #) tuple ;+ile(r'(\d+),o(\d+),', re.ASCII) m = _227_re.search(respif not m:+/raise error_proto.numbers = m.groups(Ghost = '.'.join()B[:4]!0por!E(int4]) << 8) + 54preturn \ , A def parse229r, peer)@'''P the '229' onse for an EPSV request.Rs if it doescontain '(|||2|)'; ('.addr.as.'#) tuple.''5!ifr[:3] != QreplyE0lefE.find('('1if _< 0:  KrighD2)',=5+ 1N(O  # should '1+ 1[gO- 1]h@part=O:Fq].split/[#+1H!n(<)s5m! =`2[0]O#[3d !57,57 MKD or PWDThis is aBOto a0: a directory names! 1 inA257 x?57'A8.13:58' ": '' # Not compliant to RFC 959, but UNIX ftpdAthis`1dir$= [A = 5wn = lenwhile i < n1c =K"[iqi = i+1Gf c == '`i >= ni )-UbreakT h 1+ c2]rint_line(\Default retrs callbackYp70 a G^ftpcp(source, l, targetp', type &I'`Copy fyfrom one FTP-instanceuanotherg_' =$~TYPE ' +.voidcmd()O2 ]3227A.senTy'PASV')W7, N,#:}user must "listen" [...] BEFORE sending the # transfer request.So: STOR before RETR, because hereE target is a "user"Atreply =!.sendcmd('T3' +Qname)s2if 5 [:3] not in {'125', '150'}:)raise error_protoqRFC 959%sfsource  53wvoidresp(.. def test()'''Test programOUsage: ftp [-d] [-r[file]] host [-l[dir]d 2p] &Q ... b-d dir bl list p password2'''0if len(sys.argv) < 2`print(.__doc__3sexit(0)Kmport netrcdebugging = 0x rcb = Non`while M[1] == '-d'G !+1Q8delA(if3[:2XrX # " of alternate ~/. A[2:]p=/`= FTP(!Uftp.set_alevel( A"Bid = acct = ''V6tryRobj =(Pexcept OSEi;2if 'stderr.write("Couldopen accountD"7p" -- us(anonymous login."6lse R,t&t,.authenticatorss=;Key@# noW!or  D&"NG (d1forZD<62:]%!if!lg@dir(Y-el=# cm~B'CWDz9 %1+ 'l $@ =?cmdp7Ppasv(2iveserverKH-retrbinary('?9, \1ybstdoutb, 1024nXquit() if __h!____main__`() """functools.py - T  @work Qwith &ions and callable objects """ # Python module wrapper for _functools C  # to allow utilities written inNto be added3Fthe OmmS. # W;by Nick Coghlan , # Raymond Hettinger Copyright (C) 2006-2013Software Foundation8See C source code8credits/c_ __all__ = ['update_u@', ' s WRAPPER_ASSIGNMENTSUPDATES', 'total_ordering0Qcache mp_to_keyElru_kreduceKppartial- `methodsingledispatch* od_property'] from abc import getb_token `collecrs(namedtuple # types, weakref # Deferred_"()\treprlibDrecursive_#t_thread#RRLockrGenericAlias #<Q .0() 1() decorator+~:? #{ 'qto helpNIions that can handle naive introsp/ r = ('__9 __t __ Hqual0doc) '__annotUs__')v[r@dictI\) def fdassigned = 32!):A"""UN& awlook like Aion D% ;i0ionB#bed-#d -originalV Qis a q namingattributes *directlyk+r| (defaults toF.w)&k!ofMrDHAwith)correspond E1~  81"""cW+ try:   value = getattr(wrapped, $) (except AttributeError:'EpassJelsesara!, h1forv in updatedC ?").((R, {})[# Issue #17482: set ____ last so we don't inadvertently copy it# from the @ function wheing __dict__7,(r.v=B"# Return[rthis can be used as a decorator via partial(rHsQ defjsq assigned = WRAPPER_ASSIGNMENTS,*l)UPDATES)E"""Dfactory to applyt1r()5perC p  0tha^vokesPAwith<$edL!as! argument ands&0s()o4theL`remain-. DefaultQPs are97.KTiconvenience simplifyCu4 toHa1"""! 9 -, d=4#= ,~"d=Ood) #<Q total_orderVclass#v:r # Thew wAs all in1root magic method directly # rather than us5correspond1ope1. avoids possible # infinite recursgcould occurx]O dispatch logic # detectmNotImpleaed res`n call'reflected.H@_gt__lt(self, o*, W="' a > b. CompucKby @e (not a < b)(a != b).'3op_ = .__lt__( 6if &+isr4,`mi/le1/<=or (a =other) if op_result is NotImplemented: freturn,  or self == other def _ge_from_lt(,,m=|)}"'Rza >= b. Computed by @total_ordering f (not a < b).'=.__lt__()#i0xk eY@= b) (a eLp#lt*<1a <and (a ! @ !&2> [y  g!* 0a >$g-M:+: or%=% A62 J*$A $1+= b. Computed by @total_ordering from (not a >= b) or (a = .' op_result = self.__ge__(other)#'if&is NotImplemented:$Kfreturn,k!orlh def _gt_@_ge(!, ,q=)"'R~a > b. Computed b0and!_2 !=l2<h _conver{E'__lt__': [('_(6_',0Alt),((1le_("leX(P(]QyEy y)ey , l(g(6le)yyQg ( (gtyy yg( Re)] } C(cls"""Class decorator that fills in missmethods"""# Find user-defined comparisons$those inheri9 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[^]E-0in s opF0.__(p__ = op o!sc  cls #<Q cmp_to_key() k  er$w:vmycmp): """Conver t a cmp= function into a key """ class K(object):__slots__ = ['obj']def __init__(self, obj=A`.obj = <l:Kther<return mycmpaI0, o+ [) < 0SgS->S&eq{-==T/leT,Ta__hashANonegbK try%afrom _eools import{_to_key except IRError:pass #<Q reduce() sequence single item'z:! pial_misjpect() --Eion, , FLial=DlB[C]) -> value vApply a of two arguments cumulatively)"th$fs of aO@left*right, so asx Az.HFor example,lambda x, y: x+y, [1, 2, 3, 4, 5]) calc!esF((((1+2)+3)+4)+5). IfO is present, itlaced beforeM%he1 in!sand servesa default whe.is empty @it =$r(*)i 8V Y = next(it)g~StopItera H"raise Type#("e)uwith no`w1") 'Felsed$bnitialf leg.it0'(A2, e/*b0par%()qq applic:#### # Pure2ly functional, no descriptor behaviour class partial: """New >T with" applicaW of the given argumentsDand keywords.A""" __slots__ = "e", "args4 __dict__ weakref__Gdef __new__(cls,`, /, *MD, **M)if not callable(#raise TypeError("Ufirst must beH"")@if hasattr^, f! =. +^=F` = {**.}W1'Y self = super(w, cls).I1.DPh=% =:preturn (0__(_0{**3 t(5-@recursive_repr()qualname = typeZ!__C{@ = [I())]!.extend(%x) for x i=4Q0f"{k}={v!r}"5e(k, v):@.items()F*if`moduleftools"N{^f!$.{}({', '.join(E)})":0 1zNduce|Kx&, X),)}@,Z M or None,1(tsetstat!, xisinstance("w, tuple) \f to __maH"2lenfk) != 4 f"expected 4 1v, got {O}h,, kwds, @spac fNif (~Q+5 orA@ (e1 is k @$ , >,))@E )J uinvalid+@ # jKin case it's a sub!if] #} elif, type(kwds) is not dict: # XXX does it need to be *exactly*)7? H! =Tif namespaceiUNone:CU= {} pself.__F__ =G "pfunc =  pargs =  pkeywordR try`from _Ktools import partial except IRError7pass # Descriptor version classAmethod(object)<A"""M& d>Dwith5 application of the givenaumentsDand .F0Sups wrapping exist m s :`handle&n-Y`callabas instance !s.#2"""rdef __init__(,`, /, *D, **&4ot k()qhasattr, "__get__"@Draise Type`("{!r}sCZW or ak"?q.format~"))-#` could Wa like ) which isn',}# so we ca inherit }@ (itVRifiesz%is1)JTif is,J 6# flattenis mandatory in order pl@cls/ before allx[other# it's also m?efficient siSonly one@will[)edl.' "t" +2K` = {**Y.}c;elsH:q+e o% =mUCreprUR", ".join(map(+!, )d3@"{}=,"Fk, v4@for +*m^w.items(xC@_strg= "{module}.{cls}({7@}, {K&})yreturn LO=!__yR__.__&__k>clsC@qualEF y=/= *make_unbound_): def _method(cls_or_self, /, *args, **keywords): ` = {**7.6}5qreturn .JfuncvFxI.__isabstractB__ =]Arpartial=;&n def __get__(, obj, cls=None#get = getattr,.3, "@1", 3XXPresul5 ifEq is not2 @new_Ym()A[5if (J O.# Assume `ing so, new indicates theqGcreation of an appropriate callabl6(),  r ~>trya!._1b except AttributeError_Epass@2if o 4@# If; underlyXdescriptor didn't do anything, tSF thie`# likeeinstance %od&#make_unbound3().J@AertyhI?", False)tp__classAitem (GenericAlias) # Helper '1s tunwrap_iwhile isM(#, *%R! =ZM? #<Q LRU Cachez decorator!t:1 _lInfo = namedtuple("", ["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!): retur%n self.hashvalue def _make_key(args, kwds, typed, kwd_mark = (object(),)%@fast=s = {int, str}%atuple=k=3, len=len):y"""Make a cache key from optionallyR posi@ and)word arguments PTDis constructed in a way that is flat asVsible rather nIas a nes>G0uret would tmore memory.0If Ieeonly a singleits data,known to$ ,Xn9returned withoutrapper. ThisLsaves space@mprolookup speed1"""4# All of code below relies onD preserving order input bmse user.OFormerly, we sorted()9@ befOqloopingQe newis *much*Ler; however, it means" f(x=1, y=2) will now be treaJdistinct call}f(y=2, x=1) whichD"bed separately=n!if_ +=^zfor item. #s(">:!if7d`n(h@(v) ]vZ):N cA2s()J@elif(key) == 1X|pkey[0]){s1[0]_HashedSeqUAlru_(maxsize=128Qsd=False-"""Least-recently-used decoratorCIf *P*E0set|ANoneh LRU features are disabledh can growDbounMjdhPTrue,(]differentsj For example, f(3.0)3f(3  ^!thsresultsAOt`d func~P mustI8AViewP statWcs named Y (hits, misse`, curr[1 f.J_info(). Cleazg 5c,"()PAccesPe und91__w63d__See: http://en.wikipedia.org/ /C_replace_policies#__b_(LRU)'d# Users shV3 through its public API: # cache_info, ca )clear, and f.__wrapped__ # The internals of the lru_> are encapsulated for thread safetyZLto allowD,implementation to change (including a possible C version). Oif isinstance(maxsize,!):!Negative "q is treEas 0+%if#6< 0CG<=0elif callabl|)typed, boolSuser_func was passed in directly via+@argu2 F,= U, 128.Ur = _/r(K#, _C-\Info)P.  _parameters = lambda : {'&':'U"':]}Qreturn update), bnot Noneraise TypeError(ma'ExpecTirst aPbe anO0ege A, ore"')def decorating SR r*A# Cots shared byQ s3sentinel = object()# unique_dcsignalQamissesmake_key K)build a "AfromZKPREV, NEXT, KEY, RESULT = 0, 1, 2, 3~SnamesTe link fieldszzB = {D0hit}M0fulQFalse6b_get =. pbound metho clookup3or cK5lenKp__len__Vl  withoutHBlen(lock = RLock # becauscedlists{3n'tml0roo$[]!# circular doubly[0ed aGp[:] = [7,=,`# initialize0poirgH2elf[ ==\c(*args, **kwds/(A# No9P-- ju s=SsticsY5nonlocal misses  misses += 1 result = user_function(*args, **kwds)2Rturn 9 elif maxsize is None:gdef wrapperY:?$# Simple caching without order1or dYlimit<nonlocal hits, "key = make_key(|, typede_get(key, sentinel.#if5not' (reY6s[key] = % ?els%1ze %edthat tracks acceby recencyrYroot,i, full.[^ lockalink = 1if )0is  # Move th Qnk to front of circular queueOma_prev,xp_next, ,! => P[NEXTPE0U[PREV00 asE2&, R&*as Y{H 7z0if "in}`# Getthere means Whis sameFwas addedr#jS whil@ock <released. Sinc?inkIQupdat already done, we need onl/th# computedCand ZB2cou6.Mpass5V"Us@old 7Bstor1newVw|1old==D #@[KEYY*ke#'QRESULxTq# EmptyMoldest link and make it the new root. # Keep a reference to8old key and result toHaprevent irO counts from going[zero dur/heMupdate. That will _ potentially arbitrary objectM clean-up code (i.e. __del__)@runnwhile we'r st`adjust2b_links_y =@ o[NEXT]0oldm=O[KEY'*_RESULTsK -o = NonBNow cache dictionaryAdel *[a# SaveWreentrantCkey] assignmenfor last, afterV hnbeen put inz# a consisY0 sty* )]else:zc# Put Ain a! a7Qnt of_queuenOPREVnZ0= [.,X,,52ast a( = = \"Us. _len bound method insteadlen() fun`SPwhichO8ld 9be wrappeW an lru_x itself?full = (*() >= 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 cache -- simplified access to the infinity cache #arejectqcurrent, it appears laterK7elsL! Y( s raise RunError("Inconsistierarchy")W.5nd(!# removeVhosenG{!eqQ8 beq[0] ==A $0delro(cls, abcs9"""Compu8method resolu9c orderAexte'C3 lineariza&SI *e* are given, works exactly likbuilt-in C3 a0 us=or |n!is a list of abstract base classes that should baserted#in0ing`. Unread ABCsPignornd don't end up1theOFV. The0 inrsKAwher %ir al-imtroduced,Pi.e. issub") Ds% itself but&LQFalse+0all%@ dir-. ImplicitaP (either registered or infer Dfrom the presence of a special method like __len__) are inserted directly afterOlast ABC explicitly l@d in"O0MROpsaid class. If two im7D s end up next to each otheMresulting MRO,ir orderdepends o~|Ptypes*abcs*. 1"""f,P, bas enumerate(reversed(cls.__!as__)):7+if hasattr(, '__abstractWGs__'15boundary = len]E - i_.reak # Bases# to {Daconsidafirst.NFelse0@ist( P) if  91 []&l 0 $[:\!])44L6 [H:Idif issub]F) and not any(P3b1da ; #*cls* is that introduces behaviour described byZA# an*#*,{ 9f`to its c0.ap ,DRw.remove:c3_mros = [_ &,$==() g9s>{AM9M?J6Gqreturn Ferge'[[cls]] +v%+ c>[?E + [??<) def _compose"""Calculate} resolution ra given Includes relevantes (with ircqpective$0s) os** iterable. Ua modified C3 linearizaalgorithm` = set ._ "__1# R entries whichsalready ?*@unre<dYq3is_C(typhr3]"inn 1typ 0mro=Pcls, xD}nfn_related(n)]& # Remove entries which are strict bases of other((they will end upOin the MRO anyway.rdef is_T_Ta(typ):3forbBFypes if typ !=&1and"in.__mro__6:return TruenBFalstr` = [n $n | if not1n)]M# Subclas%@ABCs@*U*Salso implemented byF*cls* can be used to stabilize ABC orderingQ\_set = setM1es)M0mro8Vfound)*-0subutyp.__s7__(-0if ,n&$is6P(cls,% :>~.append([su54sub{]@G4mroXbgcontinp# FavorAwithbiggest numberbusefulX.sort(key=len, reverse=t_5 !cl:subs"v>mro&*0_c3-abcs=mro) `_find_registryA"""RPs$!matchingation from *A* !. CPWhereLre is no 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 *%*:Aicit6but"anunrelated,|# equallyu!L&1fusb tempt6to guessIAif ( ltTn cls6 ; 7;#yJC, t)lraise RuntimeError("Ambiguous disp8: {} or {}".format(j Ubreak%% match = t return registry.get(match) def singledisp(func): """S- generic &tion decorator. 4Transforms a&minto a> , which can have differentL.behaviours depending upon the type of its first argument. The!edLqacts asCdefault imple:a, and addi!al@ #s#beV`ered uIWker() attribut1theL E.1"""#re are many programbat useXools withoutb, so wm# trade-off makC marginally slower forbenefit ofAptart-upsuch applic>s slightly fasteraimports, weakref3/qry = {}io_cache =0.WeakKeyDicAry()1(_token = None[MC(cls_.'P -> <g >[D0Run> algorithm to rz bevailableRPxgiven *cls*bHon **t;> nonlocal d(ifq is not3A0curU2gety* V9!= @ [1oTk.clearT' T:try`: = cU[cls]4except KeyError@ QU O!S !B`_find_ ,"ry)! =8_J"er\=2);WR> er1new21Oon a3 if isinstance-lambda f:w) ~ anH0getX'__annotz__', {}6!ifL:annaise Typeq(f"InvalidM`)`: {cls!r}. 4Af"Use either `@register(some_class)` or plain !_` " `f"on anotated function.1)C)y = cls  # only import typing if ancion parss necessaryDEfrom;Iget_type_hints.argname, = next(i 4().items())if not isinstance(cls,9e):nFraise TypeError(!%f"InvalidSfor {O!r}.{cls!r} is!a  ry[cls] =if cache_tokenWNone and hasattr'__abstractmethods__'I = f(Ydispatch_g.clearbreturndef wrapper(*args, **kw~  0f'{} requires at least 'pp'1 posial argument')(R[0]._9__)9 4sP, '__`__', '$leZ'Wiobject;.$Ter =  \$= 5Ary =Ps.MapPProxy("X_ \hsupdate_7(,R_ # Descriptor version  0m"""Single- generic '% dU.0SupsPexist ,s6@ndle&n-`callab4as Qt!s.#2"""r__init__(selfUJ0"__'_"4D "a_>a".L` }u/@#erk=3"""_!_A) ->=R{Rps a new leaL the given *cls* * *m*R=C1obj *<Hargs): method = self.dispatcher (args[0].__class__) 9creturnH.__get__(obj, cls)(*@`, **kw %) >_|.__isabstract$__ Aregister5)update_wrapper(y,Ffunc#@propertyQOdef (B!):$Jqgetattr.l?, '?', False) #<Q cached_() - computed once per instance,0@ as PibuteH: _NOT_FOUND = object(l] niiu , X{l! =name = NoneQ__docT. $lock = RLock@set_[!__, owner, "if{!isO EAelifW# !M Eraise TypeError(Ab"Cannot assign the s / to two different}=s "QIf"({!r} and {Z!r}).5B?@,G= F AM{6 9C msg) from[4Rval =A.get.<&,  0if 6'is  # check if another thread filled while we awaiNI7if val is _NOT_FOUND:  val = self.func(instance).?tryGZacache[Kattrname] = valLexcept TypeErrorYmsg = (Fyf"The '__dict__' ibute on {type0.__d__!r} / "a does not support item assignment for Ying {hproperty.huVraise,(msg) from Noneareturns__class_getQ__ = method(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 whether ~Qs. R05s F~zbroken | 0os.o1(OSb, ValuEs7ATrue({follows, so both isq() and () can be tJ#MovoC0symNsFF is a regular '_st = ,=y.S_ISREG(st.st_mode)@I# a5orylY!( #[Y'Sdir(s 2"""~0 ifp refersx"anhOory.lsN+i;DIRir'(0he IQ of a%@, re Ued by)2ZJ! 1get{n the last m2odification time of a file, reported by os.stat().""" return 3name).st_mK def geta(":@B"""RCthe last access8ycmetadata change8}X # ongest prefix}ll list elements.Fbcommon'3(m)CrGiven a1pof paths!s ]fE leading componentif not m:!''# Some people pass iu parts to operate'n OS-agnosticPfashion; don't try6ctransl8that case aat's an abus3theMpAPI andy are already dowIthey needh(be<#soM)most likely wPbe usNaPathLike objectg0sub!s.MOisinstance(m[0], ($, tuple)P2m =(map(os.fsQ, m))Qs1 = min(m2$axfor i, cAenum7(s1dif c != s2[i]D{as1[:i]pAre two  buffers (obtained from1, f#@or l ) # describ@'1ameb?@same*s(s1, s2@"""T~whether|reference ET 0(s1Pino = 1and'6dev'Adev)s really pointo4o(f1, f  aactual or directory This is determ!bydevice numberXi-nodBQraise]Qexcep  ifm) call on eiS faily:'f12`  tAopenu"x&he? # (Not neFBaril eptor!)|cpp , ;(fpqSplit aArootextension. # The peveryth.Astarat the last dot in the last # pathname component; ro+s everything before that. # It is always tru 9>+ ext == p. # Generic implementation of splitext, to be parametrized with # setors def _8(p, sep, alt ex): """Sa`extensxefrom a!. -E i.2 B"toQnd, ignoringC@lead*dots. Returns "(,0)";@ mayempty."""?# NOTE: This code must work for ) and bytes styssepIndex urfind(sep)Y#if 0 25&U0maxQ2o )?1dot">-# skip all F<@file7% =BE + 1%jwhile +<6mQYif p[+:`+1] !=:sep;?rD p[:T], p[ %:]. ZR += 15F;B:0] check_arg_types(funcs, *argshasstr = hasq= Falsez0s2if isinstance(s,EPX2TruL-el;u=; = ?&seQraise TypeError(f'{}() argu* be,a, or 'If'os.PathLike object, not {s.__class__.__W__!r}') 2Non ifYbrd "Can't mixGings!inne(s"p"""Parser@commtpline op+module helps scripts;p? >F  sys.argv. `suppor>Bhe sAnveno1 asMUnix getopt() q (incluspecial mean%ofs%form `-' `--'). Long similarcthose e GNU software ?@usedwell via anNal third". WmA provides two qan excex4: A --  X gnu_+yP, but#owBnon-"s intermixed. G&! (!) d/ 'opt' attribute, which is the option involved with the exce. """ # Long 02support added by Lars Wirzenius . # # Gerrit Holl mo|string-baseds # to classePeter Åstrand gnu_getopt()@TODO for :b- GNU /_long_only mechanism # - allow?`callerspecify orde)RETURN_IN_ORDERWg`extens'-' as first charac#of8 1?al arguments, idouble colonSJ- anH`a W fo8Asemi5 should # treat "-+ o""--foo" __all__ = ["GfError","eM6","na"] im[os try: from|Stext 1getRas _ ! I;h9`# 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@(argu0hor\0s, /@opts ]s9"""/"s[._P]) -> s,s`Parsesm@line$Pions Qparam plist. 0 is @be pU!d,0out,P lead7reference,1theE@runnprogram. Typiy, this means "sys.argv[1:]". @G lrascript wants to=recognizethat requireaCP(i.e.`e samemxpat Unix2) uses). If?\Bis a[#ofsXUPnamesIPwhich#suld be j ed`%he2'--_s6pe inclu!inxS A. Ost/ 9n equal signBb('=').4The-@valukRnsistawo ele:3R!, D) pairs;2csecondhGpleft af/ZUn list was sXtripped (this is a trailing slice of the first argument). Each option-and-value pair returned has EBo+s as itsP0eleO, prefixed with a hyphen (e.g.,'-x'), andNWusecond Xor an emptyF0striEehas noc. Thes occur inwDClist same orde"Pwhich( y were found, thus allowingCmultiple]rences. LongUshortmay be m!!. A2""" opts = []ype(long`) == tA""):#9 AOelse(WJPwhile6sargs[0].startsX('-')v != '-'a!if@0[0]('-T" =$"1:QbreakJ '-'),R` = do_&s([0][2:], E1:])n 'W X1X YZr7s def gnu_getopt(', B]9"""/"s[_Y]) ->lT function works like R), except that GNU style scann0odeQused by default. _Rmeans@#Bnon- j#s Rinter BstopopprocessSs @soon&a l " i;Pencouk#edkI,character` Xs `+', or hCpenviron variable POSIXLY_CORRECT/0set- en1ion   1Pprog_VAqif isinstancJ,a)y  ; = Cm0# A@s af\!s?0&if +!& =/[A4all _S= Truslif os.k.get("OM R+RFalseS$+* @ if args[0][:2] == '--': opts, args = do_longs([0][2:], E1:])IAelifD.#:1kT' and !~} \short~1~*sell_options_first"Qprog_!+=Ybreak,ell(J.append(V'[0#& nQ[1:] ]rreturn 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. GetPassWarn- This Useris issued whenP) canqpreventV IT!of6%contents while reading. 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?"""A: Written onM1askthe input. Default: W :: A writable fR`objectRqdisplayN{SI#yptty. I~ is avail_d;J.stderr.GRuThe seKr3t%$1EOF:p2our*wor stdin was closedg 0: Wwe were unt0:0offiW PAlway(0sto(@term4 settings befor|*1"""@@d = ! with contextlib.ExitStack() as s 3: 6try # Always try reading and writ directly on the tty first.UH fd = os.open('/dev/tty',O_RDWR|os.O_NOCTTY)<S= io.FileIO(fd, 'w+'&.enter_context(tty%ainput MTextIOWrapper*O> Qf not stream;qyexcept OSError7# If that fails, see if stdin can be jrolledgjclose( fAsys.]{.fileno9(Attributeb, Valu )YENonePpasswwfallback_get(prompt,L z5 = Xi>Eerr @if fd is 7 oltermios.tcgetattr(fd) # a copy to sav0newUld[:]; new[3] &= ~cECHO # 3 == 'lflags'92tcs_!4 = @TCSAFLUSH4aif has-0, '/_SOFT' i|j; iIMG c, <<QQ_raw_) K!, =EkfinallZ.>oldY@.flush()issue7208#foeN3if '&#  succeeded. The  jnReraisRinstead of leavnal in an unknown[*teGe@# We$'tR"or. Give upuse normal IOk-# e!) |sappropriate warningDz$F %P# clep unused R objects before blocking?= =] stream.write('\n')  return passwd def win_get(prompt='P!ord: ', stream=None):KA"""P*B forNord with echo off, using Windows getch()."""Dif sys.stdin is not!__"__kfallback!) XRc in Fmsvcrt.putwch(cSpw = vwhile 12Cc = 6!ge65if c == '\r' or &n'?'Qbreak5;003*raise KeyboardInterrupt<b:upw[:-1]/Jelse'A + c& @#pw8=warnings. Q("Canscontrol@n the terminal.", GetW>,Tstacklevel=2!if[! =pastderrOsprint("c : pwinput may be edRfile=Mp#Q_raw_4Qs !4=""$h!, ? t# This doesn't save$0strgi2GNU readline history. /:9!in[j#tr-if6tryO@i.write=except UnicodeEnJrrorD# Use replace e! handler to{ as muchpossible "ed o !.eu(cing, 'o^? de ?0\bflush(8# NOTE: The Python C API calls flock() (and unA) du+ *=p.i#q@EOFEh0if $B[-1]" =!rOgetuser(a"""Getname fromenvironment|database. First try various 9`ables,T?JN {works onpas longTUSERNAME3setKin ('LOG,@', '8L  c = os.P.get(P$0if ': 4return user # If this fails, the exception will "explain" why 6import pwdEVpwd.getpwuid(os ))[0] # Bind`Pname *aass toappropriate funcQ try:bqqtermios# it's possibleEre is an incompat5P from&>McMillan Installer, make sure we have a UNIX-OF.tcgetattr, s N1 (I5Error, Attribute)damsvcrtnIH7.N= fallback_;?lse-5win(e$:u = unix!"""InternaAaliz and loc0sup @. TZmodule provides iEn(I18N)Ls(L10N) S for your PythonUgrams by bvidingtterfacea0GNUttext message catalog library. e referBoperby which alxpmade aware of multiple languages. VRadaptW"of0proT{, once &4ed,l `3cultural habits. """trepresentsgof work, conions, feedM,f # suggessPp followxpeople: # # Martin von Loewis, who wrot initial implemenunderlying # C-basedRintlmQ(later reP d ), along witskeletal #;.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 ' 's8standardsFrancois PinardBMarc-Andre Lemburg hed valuablcthis #WJ. David IbanezQed pls. Bruno Hafixed some bugs. # # 6TODO: # - Lazy loading of .mo files. Currently the entire catalog is7Fed into # memory, but that's probably bad for large translated programs. Instead, Mslexical sort`origintrings in GNU should be exploited to do binary searches and linitialization Or you might want to useNhe undocumendouble-hash algorithmPa with "atables(Oyou'll needfBstudsgettext codedo this. #@SuppuSolaris }0mat Unfortunately, we've been un Afind\< 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 parsaplural` selec,CThe Q librfs a small subseC syntax. :only # incompatible difference isNheger literals start[pzero arrdecimalhttps://www.gnu.org/software/t/manualq.html#P-forms # 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? :##!rybitwise op*  # not allowed %(?P\w+|.)# invalid tokenE""", re.VERBOSE|re.DOTALL) def _+ize(plural):7for mo in<finditer(-_pattern, 3kind = mo.lastgroupO2if = 'WHITESPACES'q"continue7RvalueTP(E)V) Rpraise VGyError('& form: %s' % wgRyield{#''EeY4"if.ireturnunexpecteOelseScend of') _binary_ops = (('||',), '&& ==', '!='<><>+-,*/%)`{op: i@ i, in enumerate(A, 1)( op&ops} _c2p{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 comparisons$Oin (3, 4) and je: # ' ?, 'L4%# Replace some C opors by their Python equivalent op!7.ge,Oight<w, i + 1/1%s  Pop, rR2iuif j == == 4: # '<', 'p>', '<=S>=' result = '(%s)' %  "if nexttok == '?' and priority <= 0:)Nif_true,3 _parse(tokens, 0)-'f!= ':'HLraise _error(=__falsk+%s if %s else %s((B, if[B&if=@ creturnS 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' hc$ =_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, ns5@ns['!']8)PRecur%#  ^@ can!Q) or !)& !~_expand_lang(loc/IRlocal[bloc = p.normal3 COMPONENT_CODESET = 1 <= 0:modifier2e[pos:]3locF:poso/|=;Oelseb!'' . scodeset%qCODESET `_ territory,TERRITORYdlanguagev4r$[for i in range(6+1)if not (i & ~): # if all] I@thisbo exist ...s@0val 0if d : 75+= 9 4: 97 d:7 8ret.append(val0reverse(urn ret class NullTranslationse def __init__(self, fp=None._info = {}Bchar7 output_$ pfallbac Bif fp is~p}Q(fp) z Fpass(Dadd_|40if J.+G.T  \4 = 5sgettexthmessag 0ret  i.UO>/l2I#, )mport warningQ. %('H)deprecated, use e) instead',MD:BionWs6, 2jiC+ Ewithp.catch_(t.filter('ignore', r'.*\bO\b.*U&.q(output_charset:  return message.encode(self._output_charset) 74locale.getpreferredNqing()) >def ngettexte, msgid1a2, n):+m2if fallback #.`ZYon == 1Q9-Oelse(2l{mport warningsm. &('S) is deprecated, useL) instead',K#D;BionWu6, 2iC Ewithp.catch_(t.filter('ignore', r'.*\bO\b.*V&5r(6ctmsg =-6(2(c nqB1p0con,#_ Y`n<`BD>jd?if -(NAinfo$r+ ._!2 $5 t < E   c;set#, ;R4 $ =3allnames=Nonevbuiltin=.__dict__['_'] = self.gettext  if names is not None:  allowed = {'gettext', 'l n ;A'#E 'np0% ' }<1forD in a& set()dbuiltins.__dict__[*] = getattr(self,V) class GNUTranslations(Nulli # Magic number of .mo filesLE_MAGIC = 0x950412deBde120495 # The encodingUa msgctxt and !idp" ir#++ "\x04" +Cid (_ version >= 0.15)vCONTEXT = "%s94%s"Acceptablep@qVERSIONS = (0, 1)5def _get_-g@"""Returns a tupleTmajorV, min1""">r;# (Xt >> 16,9 & 0xffffSparse*fpOverride this method to support alternativ formats.# Delay struct im:Aspee up~5Awhen]=Q# areUused.Kfromafunpack"0ilePfp, ''eP3 th ile header, which consistsp5 littludian 32u# bit words`._catalog = {%plural = lambda n: int(n != 1) # germanic *by defaultbuf = fp.read(`buflen\fen(buf# Are we big en*or?`m"= o('>sFraise OSError?C'Bad7T!',O[ o ~gD5jor8"in "[0' +()# Now puXl messages  `buffer oC # fionaryysi'Prange_Gd mlen, moff = unpack(ii, buf[masteridx: g+8]) mend = moff + mlenptlen, t _Ptrans^ ]t]? + L ]1if <len and 4:0Pmsg =0[:@]%t&|:T &Nelse]raise OSError(0, 'File is corrupt', filenameG+# See if we're looking at GNU .mo conventions for metadata N== 0# Catalog descripN @"lastk = Nonezb_item in (.split(b'\n')tR/"= 8.decode().strip(/pif not :T%~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( m# Note: we uncondi)Ballyrt both msgidsmsgstrs toyP# Uni0 us@the <acter encodspecified$;setL`parame:0of '@ContType header. The gettext docua Ostronglyduragesto be us-asct some applicNsOrequire alternativeZs (e.g. Zope's ZCML7ZPT). ForM4trav|,sion willJcause no problems sinccii should always be a subset of # the charencoding. We may want to fall back 8-bit msgidsN!ifQ Unicode conversion fails./w= self._or 'ascii'/if b'\x00' in:# Plural form 1,<Pid2 = s.split(Z)Sptmsg = + _r = str( ,\Yfor i, xenumerate(h)catalog[[3i)]mxhNelseMI<O # advance next entryJseek table~masteridx += 8RUtransdef lgettext(, messageimport warningo. %('H) is deprecated, use e) instead',p D:BionWs6, 2elocaleC`missin@vobject(1dS.get(#, =3]$is #ifI kreturn'.$|s4ndoutput tpC.^e*._5q1TpreferredKqing()) 2n3?, n= S>?A:tryOH 5!.pQ(n))]except KeyErrorT62j{if n == 1y915020 V oZ1A  ? = ?sing:  if self._fallback: kreturn'.gettext(message)73Qtmsg Tdef nJ, msgid1V2, n)6try J# =catalog[(CQ.plural(n))]s7except KeyErrorT&z~if n == 1x915Oelse0 20gpg0con#, fctxt_msg_id\CONTEXT % (9wmissing = object(_B(l#, A71if :$is & I#T&, Zk C],#  N Pk[ # Locate a .mo file uCthe + strategy find(domain, localedir=None, languagesall=FalseX4# Get some reasonable defaults for arguments that were not supplied/&if{@ is ~C = _]_AA6= [%envar in ('LANGUAGE', 'LC_ALL MESSAGESCANG'0vals.environY(fif valf =!.split(':'?+Qbreakaif 'C'O&in b^.append('CY# now normalize and exp/9p ne%s B>=({4!_X_)( C(a;sPg) # sel ect a language if all: result = []Oelse2Non@1forQ` in ne[s/"iff== 'C'iQbreakcmofile = os.path.join(localedir,H, 'LC_MESSAGES', '%s.mo' % domain)P%ifJrexists(b) t.append;]" rreturn l0Q # a mapping between absolute .mo  and Translation object _ts = {} _unspecified''] def 6(/%, a=fsbclass_ fallback=False, codeset=p2if ;@ is kW= GNUs|INfind,R=Truecif not HNull(O" from errno import ENOENT! raise FileNotFoundError(',(,8'No fH h)',# Avoid opening, read ?@parsj'th]after it's bdq# once.! = Yrkey = (,0absENe .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 gettextEwhenigJ1are3FusedbUaO.&(t2  Y0war. ('paramed^deprecated'Z D'BionWk6, 2n ings.catch_(( t.filter('ignore', r'.*\bset__O\b.* g  t.se t_output_charset(codeset) if result is None:"5= t?els%.add_fallback(ccreturnc def install(domain, localedir=#, =_unspecified, names")t = translationO$, 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__:iimport warnings . /('V)deprecated',=DBionWc2, 2 C$ifc4I GsK7d(2tryb,)except OSErrorSut()l C , a)1/ea3 = -1* rEwithp.catch_(t.filter ('ignore', r'.*\bparameteO\b.*V &""30.enK_3 orQ?preferred%Cing(XET lFxt\b.*',   DeprecationWarning) 0return t.lgettext(message) def dndomain, msgid1a2, n):N2try [t = translw(=_localedirs.getRNone)except OSErrorSif n == 1jOelse(2(:%t.Elimport whsi . '('Nc) is dwed, uses) instead',I2, 2Dm;`codese< Ewithp.catch_Sings(t.filter ('ignore', r'.*\bparameter O\b.*Z"x,=Tctmsg =t((`msg.en(2or 2preferred%Cing(7 l .U(kqpq0con$,  " u%t.  2%dn#+AXDZd_current_>/_  }b{y#>  DeprecationWarning) # return ldgettext(_current_domain, message) def n(msgid1, a2, n):UQd)Q :[l3T\import wsp . &('Ec) is dved, use) instead',G22, 25Ewithp.catch_{Sings(Et.filter('ignore', r'.*\bl*O\b.*O"}T~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: # #0Ucat =Cj(PACKAGE, localedir=LOCALEDIR)9_ = cat.Nprint _('Hello World')The resulting9sobject ly don't supm ac1 through ab icLary API, whics5ed (but appaLly unusedv2% ## = transl """Filename globbutility.""" M$os $re 0fnmsys __all_5 ["QT", "i escape"]P(path~, *, recursive=FalseB"""RBa list of 7!s aH atern. s0pat@ may[atain s shell-style wildcards a la>. However, unlike 3, f=as star@ dot are special cases thaed by '*'11'?'~s&If Utrue, theP '**'lA anysWSzero or more dired!ie!G sub.1Sr( ) +pn iteraPyield7ho, filenames starting with a dot are special cases tha not matched by '*' and '?'>patterns.  If recursive is true, the ) '**' willV any filesWDzero or more directori!G sub.11"""sys.audit("glob. ",zfhname,)0pit = _i'L(pat%s, False,5_is>!):YWs = next(it) # skip empty string*passert isreturn it def sdironlyx2dir@base ` = os.f.spliti!ifvhas_magicm;4if i0wlexistsZ*Uyield^JelseW3# PnF end slash shouldW=Wr%ifcisdir(9G#UECi2 9 so`from _2,k,+ H1H4# `:2)` e argument itself as avPif itb@# draor UNCp. PrevAan infinitePon ifP 7q# contains  characters (i.e. r'\\?\C:')!%if!!=0dir" FS, Tru  :[4]6if n1"%p_in_dir2n /1/ '0'5forK in sY7in B{ =xFjoin<Y) # These 2 helper functions non-!ly inside a literalQ"y.Ly#Fst o2s. 1 acceptRwhilep0 # takg@ (so  to check .Aits !cence).<r5`list(_-) if not _ishidden(pattern): names = (x for x in vif not =1x))7return fnmatch.filter(5$, b def _glob0(dirb, base sdironlyl# `os.path.split()` s an emptyV,s ending with a# directory separator. 'q*x/' should  /Eies.F4if Tisdiri$ []AFelseKlexists([DjoinZ9)e{] # Followfunctions arepublic but can be used by third-party code. w %, False)I1$I%I# This helper recursively yields relativehs inside a literal 2, Qasser*zj{}2[:0 from _rlistLc$IfrP is fG,all fileJ. # AEtrue@^.if isinstance=Sbytes2'<1 = curdir, 'ASCII's, :>2os.8o6trywos.scanv) as it(QPentry ! Z P1or H@.is_u 6.}except OSError$Apass9-RLR""X/(_JxzAV!=x% = HAx) iM S >Q q x, y) magic_check = re.compile('([*?[])')$_ *b+Ahas_X(N qs, bytes):  match = magic_check_bytes.search(s) else: 6 0creturn_is not None def _ishidden(path)Y3[0] in ('.', b'.'[0]);recursive>CternAif isinstanc!, #h< == b'**' *)QescapfShname`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) , ` = os.a.splitz z{FTqub(br'[\1]'G_.sub(@% +0 __all__ = ["TopologicalSorter", "CycleError"] _NODE_OUT = -1 @DONE2 class _NodeInfoq__slotsgP"nodeYnpredecessors4suc U)_init__(self, =jQ# Theb this ~is augmenting-B.A! =3e# Numberm, generally >= 0. Whenkvalue falls to 0,N_2is t edget_ready(),A`is set<FU9wcePis marked(0a ce!toY Q H = 0@List&!s.dl can contain duplicated elemGs aslong as they're`reflec4iG%e l9's  attribute)3s]t (V,b"""Sub6of R rais P.prepk@if c ex `bgraph.NIf multiple8 4p, only undefined choice am.them will0repdSincludedexception2det[ Abe aT`ed viab seconUPf*args*y 8h [@consists? a "of7,h that each@ is,0W3, an immediate ~TCnext@nn2. I )]be firsj3las?\e the sa me, to make it clear thatis cyclic. """ pass class TopologicalSorter:$ """Provides functionalityot4ly sort a graph of hashable nodesvdef __init__(self,3b=None)v ._<2info = {}Qready#@s = @ !nedout = 0finished"ifq is notW}1for, predecessors in9w.items(5@add(8, *?)1get#2Rif (result := X2+A.getc )) 0[]C] = R= _NodeInfoGcreturn(T, |"""Add a new+ and itsIcto theMf>ABoth**<all element z* must be.N If called multiple times wig2samP arguc,0setdependencies!@willqPunion*. 8 intPpossi4Bto a+2ode9no F(p%d)as well ah& aKy twice. Ifo9"haTbeen Uu before[ivcluded among*pautomatb ly!edEZ*no!of)(ow5Raises ValueError iafter "prepare"H#if=KI8ron ("(Ps can*#be{aa3()"{# CreateT8 ->G edgZ"  %,(.nb += len($Q &_ 1C.sucZ0.apk"'Vzq"""MarkW5as q`check e.Qf any<edetected, "Cyclr$" d, but "T"#st!"us`obtainmlis Runtils block m progre8ss. After a call to this function, the graph cannot be modified and therefore no m0des74added using "add".:5""" if self._ready_noC0is zUNone:*uraise ValueError("prepare()than once") Ah5= [_ i. for i inp2info.vy s() if i.npredecessors == 0M] +# seS8qwe lookpcycles on purpos#ouser wantsQcatchC<at's fine,AtheycontinueWinstanceUgrab as many?spossible bRblock{progress>## =MQfind_%()#1if 3(f" rea5"",rdef getP()W"""Return a tuple of h|that are.?Initially it rFs<@with ;a thoseTemarked`as proB@ed b!ll0done", furfcs willyx2ew |UAhave htheir 1 alv0. O+'adGRempty8s'ed&Rsk0ed #1out"viously&"e us|ed first!Q# GetRW0ady "moresult =q 5n2iaTHuT@n2i[ ]x _NODE_OUTp# CleanP list= s + eupdate#6@coun('ofdA we _i g.clear"pnpassedr+= len(K] is_actived``True``t```Fals+obGwisePTPs do B`resolu@] eiTGrWS stSQn't y#en"@" orUfnumberAed "> is less than the number that have been returned by "get_ready". Raises ValueError if called without ing "prepare" previously.J5""" if self.p_nodes is None:&r(e() must beed first")?infinished <`passedor bool() `def __#!__%)fis_active(9Adone51, *="""Marks a set of "  as proceThis method unblocS`ny suc- or[Aeach`3 in0* fein the futureaj? to, v:exec:`3`4=any}ahas altmarked asYt,gewas not added5theTPgraphP uso"add" 2U w yein aDJfTn2i =ode2info!inL&s: p# Checkmwe know abF:@(it ~2ly qFadd(T@if (: := n2i.get/))8  f"G {1!r}"FA# If:b% ( ) , !rmEFuser`astat =Q(r.nprede*-!= _NODE_OUTo"&N>= 0" 5! a(stillSJ $el=ODONE1_t;elsJrt False, b@: un n @us {,}"/ f  Z Go1all_s and reduce0num ofJ, collecting all thew ones # that are ready to b turned in the next get_%() call.Jfor successor8nodeinfo.)s:2_+u = n2i[]0 r.npredetms -= 12&ife 5N== 0Belf._s.append()ns0nfinished +"def _find_cycle(*)u`n2i = .i2 9tack = [>itsAseenG&t(2-c5{} W&2it4if W !continuePwhile True2SA# If we have z1 alsode and is5the=# current Pfound a  ;:0 re(h[2 r] :] + else go onz2getkb 71/P.add(8Piter(q2]@).__/__H0q = len(p3y@);# Backtr!todtopmosentry with# at least anotheM?try3 = NG[-1]r!]break"except StopIterationu1delxf.pop()W' L 3Nonstatic_orderA"""RPs an gbable oVa topological F.The particular2is ed may de@he specificY-QwhichSitems were insertWgraphUsing this method does not require  "prepare" or "done".5anyydetected, :exc:`CError` willVaised5"""I+q{is_active():  node_group = self.get_ready() yield from5 "?fdone(*W) """Functions that _ and write gzipped files. The user of the doesn't have to worry about%^compression, but random access is not allowed.""" # based on Andrew Kuchling's minigzip.py distributed with zlib 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, errors qnewline!):4"""Open a-k in binary or text1e. < argument can be an actual0 (a Jbytes object), orPan existing5!1{#or5'to. "rC "w wN "x x a"c"ab" fQ@ "rt0w#xt1t1 bdefaul$1 is4"h94Forrcthis f?*pequivalk!to B con"or X Sa). In iQcase,UHCEnas must]be provided7D, a is created,a Qin antio.TextIOWrr instancespecified P handJbehaviorj 0 en,3(s)`if "t"Mbraise ValueEv("Invalid4: %r" % (Q",)[Ielse]!fAz'>'0sup ed"|M#if!p$sn==p0gz_j! =~.replace("t", "") i%f isinstance(filename, (str, bytes, os.PathLike)): pbinary_5 = GzipFilEgz_mode, compresslevel)Aelif hasattrx"read") orowrite"oNone,  , &seraise TypeError("- must be a str object,aZ1") if "t" in beturn io.TextIOWrapper(N, encoding, es, newlineRAa def .32u(output, value># The L format,s the bit pattern correctly whether signed#"un.j.zCuct.pack("obj = Noneudef __init__(self,mI=&, G level=_COMPRESS_LEVEL_BESTO2objCa mtime  L"""Constructor for5 /0`At lea$ ne"anP must*Sgiven=non-trivial valueY3new!instanceL ba!onobj, which canea regular$, an io.BytesIO , or any otherO.PIt defaults#in8AcaseibprovidYw5Whe1not(,\argument#zuincluded 0he t header=Cmay ,eoriginalIv $unro;. 7 Kif discernible;zwise, idKempty string,MiAin tM{+,0is F{wh ]W&f 'r', 'rba w w x'V'xb' dependo'enP will@readwritten. kQ!is!ofJLiF+AV0'r'pequivalX_4Cdailarlyu'w' and'a0 'a#'x;xb'nGw!isnteger from 0n9 controllO&thNA4of R`ion; 1pfastest produceF1 Y9=Oslow=<0. 00(noxat all..9 oQal numeric Pstamp3be 3m!to%lmodification time field in the stream when compressing. If omitted or None,9current time is used. 76""" if mode and ('t'}Uor 'U%):?} raise ValueError("InvalidM: {!r}".format(O%))@rt'b' notu e8x += 'b'=pfileobj 4= self.mybuiltins.open(Qname,@I'rb'#jA = getattrT`obj, 'G', 'Q7"ifsinstance3-, (str, bytes)n;6= 'NelseQ = os.fspathfAorig`=`!isP \B L.startswith('r'e= READ>raw = _GzipReadec'D_buffer = io.B #ed6?raw2'Z#el0('wa,x'5if S<import warnings . (#" File was ed for writing, but this will "F`changew future Python releases. :qSpecifyh` argumnhing it?.",F|W?, 2cy= WRITEDPinit_JE= = zlib.Dobj( _levelxMDEFLATED<-=MAX_WBITS>=DEF_MEM_LEVELA0'I!_m7!= tj!Oz#= #if Cbgzip_h# )S@property1defr(GA"useC ibute", DeprecationITE and self.name[-3:] != ".gz": return self," +&% ! @propertydef mtime(H)b"""Last modification ) read from stream, or None"""T|_buffer.raw._last_r__repr__@s = .fileobj)d''vinit_writ , bv^=crc = zlib.crc32(b""#size = 09zbuf = []?buf4`offsetL # Current for seek(), tell7etcx_4q_header , compresslevelAobj.=(b'\037\213')# magic Y C+10?H#remethodI6try.(RFC 1952 requires the FNAME field to be Latin-1. Do notSFqincludeKFat cannot?esented that way.Ef8 = os.path.base_Du if isinstance(Bw, bytes-1 = .encode('l']'dswith(b'.gz'W F[:-3except UnilErZErrorje = b''@flag"if <(>7 1Achr(U)Z" =nBi1 is @.(\232ua, int(7)+%ifO == _COMPRESS_LEVEL_BEST}1xflFF\002J/elN/FAN4N/sev0(6xfl gb'\377:A + XF00')tqW,dataG_check_not_closed"if@modeCZWRITEimport errno|%raise OS( .EBADF, "A) on -only GzipFile object"L1xqValueError("write() on closed GzipFile object")  if isinstance(data, bytes):$+length = len')Jelse-# accept any T that supports the buffer protocolNm3= memoryviewr$-!.n !:> 0self.fileobj.,compress. uv*asize + 9gth crc = zlib.crc32I$, RgoffsetTU`returnvkdef read(Q , 7=-1._check_not_(x"ifmode != READ% ima errnouraise OSError( .EBADF, "xW_-only|G.C1"""Implements BVedIOBaseO#1(LtReads up to a's worth ofis negative."""`c1a < = io.DEFAULT_BUFFER_SIZE?+1(Cpeeknp+Cn9@propertyR 0a is None;-:.=o3if P y/" =G:try<$ == WRITE#81vflush()`1C32u(>,#Z may exceed 2 GiB, or even 48hLS& 0xf ,el^O_KkfinallT#my  5if rw !bj.close()  def flush(self,zlib_mode= .Z_SYNC_FLUSH): 1+._check_not_closed()!1if $J == WRITE@D# Ensure the compressor's buffer is%edW8Xfileobj.write.C.) ?+!) a QilenoQ"""Invokunderlying object'sno() method.WuThis will raise AttributeError ifYEdoesn't supporto."5""" breturn.lrewindB'''R?$un[ed stream| position indicator to`beginn*o5'''! (z!= READ'1!OS*@("CaA in  g"#_Gw.seek(0rreadabl72Q.m:;;JTrue- , offset, whence=io.SEEK_SET Fn#ifCG != F mg*=*>CUR*." =i+*OelseHBValu('Seek from end no6ed'V#ifp( <ieL'Negative  M btcount =g-g chunk = b'\0' * 1024!flbrange(Y!//)w!e([ qR%Q/,el% #O & cp 2%2lin, size=-1 V ize) class _GzipReader(_dion.De!__init__#fpsuper().$_PaddedFile(fp), %.d^Iobj,Fqwbits=-4MAX_WBITS# Set flagpXstart of a new memberd>Bnew_ = True  self._last_mtime = None def _init_read(,!):._crc = zlib.crc32(b"")$stream_siz`0 # Decompressed of unconcatenat7a_exact7, n'''Read ly *n* bytes from `2fp`QThis method is required becausefp may be unbuffered,i.e. return short %s.!6'''redata =Y.,&(n0while len(*V) < nqb>& -1J-if not bCraise EOFError("Cf1endfore the "?"end-of- marker waWWached?U += bYE1"_gzip_header@magiS2 3if $Z= b'' tCFals3!3\037\213;CBadGzipFile('Not a Aped Ir(%r)' %)c(wf, flagN)truct.unpack("mon interfaceZmany hash fun!s. new(, data=b'', **kw) - returns a new?object implying the RgivenC; initializF K$us/Uabinary. Named construc>ps are also available,!se@er than d ): md5(), sha14224 #56 $380512vblake2b s(), sha3_224PS3_256 $381512ke_128, and} ke.. More algorithm@s may be available on your platform but the above are guaranteed to exist. See(lgorithms_)f and ap attributes to find out what1 names can passed to new(). NOTE: IfC wandler32 or crc32 hash functionsy0in zlib module. Choose\rCp wiselyome have known collision weaknesses. sha384 sha512 will@slow{e32 bit}Ps. Hrobjectscthese methods: - update(data): U=Q withbytes in 0. Repeated calls equivaleZo a single2Xconcatena_~ of allO`arguments.digest():zaReturnJ5)nso far as a Ay2hexc|TLike b excepHQ is r"edPnstringt`of douMlength, containing only hexadecimalri Acopy  a  (clone) E Thiuefficiently computeesYPat sh|NmmonNinitial sub. For example, obed 7 'Nobody inspthe spammish repetiP1': >>> import5lib4m =f.md5().)+b"o"% .fb'\\xbbd\\x9c\\x83\\xd1e\\xa5\\xc9 a1-(f0\\xff\\xe9' More8gdensedlib.sha224(.4'a4337bc45a8fc544c03f52dc550cd6e1e87021bc896588bd79e901e2' """ # {Qtuple__get_builtin_constructor() mustmodified if a # always,wadded. __'@_suped = ('md5', 'sha14224 #56 $38Q512',g 'blake2b5 s,_l63_2n_p/3_r shake_128t HE)  Kn= set( )0 /upported) _2_all__ = __always_supported + ('new', 'algorithms_guaranteed',  9availableQjpbkdf2_hmac') __builtin_constructor_cache = {} # Prefer our blake2 implementation # OpenSSL 1.1.0 comes with a limited4B of Mb/s. The D+ #+s neither #c keyed?" (G$ MAC) nor advanced # features like salt, personaliz, or tree hashing.-only # variants are RR as 'b512' ands256', though.ilock_openssloi KVs', } def __getq(name):B(1 = 6B.getK"7if  is not Nonejhreturn(;6try$0if in {'SHA1fsha1'}%M im _G[<] ['('2.7)elw0MD5v?md5u5md5=t9cAX_md5.3 p2SHA  24osha224/56B,%240256?224?!56-?D?~ ,  TSHA38 ?5128 0512/38 ??~ lb sb`_ .b/s/s/ Psha3_:#3_Z03`D\G53ro/</< ^ ^ /shake_128 F z!ke 12  except ImportError: - pass # no extension module, this hash is unsupported. <constructor = cache.get(name)"8if %is not None: Fhreturn(^raise ValueError('type ' + r def __get_openssl_y!if4 in __block2,# Prefer our builtin blake2 implementation.4/8trylMD5, SHA1, and P2 areEall  OpenSSL versMSHA3/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=S=Fals1UsegCdirectly (very fast2fexcept (Attribut,):O apy_new, data=b'', **kwargsY?"""& B - RQa newwing object us "thd algorithm; opinitialized with (which musta bytes-likeg)1"""6 ( [&)_  w q Jlib.z; 2# I|(`) does%,`#S, try s7TaQs ford24/256t384/512 even though6 library priorCU0.9.8aprovidjmPaA)  import _hashlib new = __A_newQ__get openssl_constructor+algorithms_available = q.union(7{eDlib.`md_meth_names) except ImportError:@/py ybuiltinB tryD# OpenSSL's PKCS5_PBKDF2_HMAC requires% 1.0+ with qand SHATfrom ! i pbkdf2_hmac"_trans_5C = bytes((x ^ 0x5C) for x in range(256))o6,366/36678def(ame, password, salt, iterations, dklen=None)8C"""P4 based key deriv8P funcA@ 2 (] #5 v2.0) DThis Python4alement>sTpon the C module about as fastKaJUshort s AmuchIe,Flong+.g5""" if not isinstanceP7str-Wraise Type-S(,&karray)a+memoryview(@lh'd)# Fast inline37impJ`nner =?out blocksizvgetattr(iR1, '_R', 64>Tfif len1 > ,+*; 4).digest(_5 + b'\x00' * (m* -Du.update.0l+4(5Crf(msg, v=!, O= m(# +Auses as. We can re-use#Esamea"# ?r objectRjust P copi`o skip initializ*Lbicpy =W.copy o  @?6msg=)('preturn k'if\J < 1n&CValu'"if@ is  C" =_size if dklen < 1: raise ValueError((%) %dkey = b''loop = 1from_bytes = int.$while len(R2) < prev = prf(salt + l2.to^(4, 'big'))X# endianness doesn't matter here as long to / use the sameLr (| /for i in range(iterations - 1)I !##  ^ & r%=(B( +BJ`inner.digest_sizeRpreturn @![:-b] try # OpenSSL's scrypt requiresQ 1.1+O_hashlib import6 except Iappass w__func_name__always_supJ"ed2P# try m all, some may not work due# version*ViFhat algorithm.-]globals()[] = __get(Pqloggingp.:ion('code Vq %s wasfound.', x # Cleanup loc^ del M : 0`py_new{ %openssl_constructor """Heap queueL (a.k.a. pri^y!@). /0s aQrrays which a[k] <= a[2*k+1] and 2]0 all k, countelementsI 0. For, sake of comparison, non-exis;`ideredIbfinite. ThAtere9 property^0a hAis tTr[0] is  its smallest . Usage: ;@= [] `# creaan emptyc-Ppush(6, item) # es a new1 on' &! =A1pop;5 ope)E <#3m without popp!itbify(x)?ansforms listr"o K, in-place linear time!re# ;|,V5dds#M;K M@unch*d Our API differtextbookusfollows: - We0-based indexingpis makes the relationship between the index for a node and!esFits children slightly less obvious, but is more suitable since Python uses 0-based zing. - Our heappop() method returnssmallest item, notlargest. These two make it possiqto view1e as a regular list without surprises:0[0]Kthe .S.sort() maintai invariant! """ # Original cqby Kevin O'Connor, augmented by Tim Peters,Raymond Hettinger __about__ = """Heap queues [explanationNFrançois Pinard] 0s are arraywhich a[k] <= a[2*k+1]  2]# all k, coun@ eles from 0. Forsof comparison, non-exis;considered to be infinite. ThAtere9 property of aCat a0alwDp strangY` aboveJSmeantan efficient memory representnU`tourna @numbQbeloww2`k'ZO: 0&18273/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'topping `' 2'. In a usual b&y ` we sex sports^iwinner ovex~syQtops,qwe can trace8F dow1 topCopponents s/he had. However, in many;uter applicos of such s,!do/"neDchistor/1. Tf, when a ,fpromotedi trGl itq soPelse  lower level(Zrule becomes th)SI! d1 com0 th `differ$0s, 9"opy"wins" (!ed s. If this>0tecpll timeA0"clearly td+Asimpalgorithmic wa6A remgt3 fig"next"r1to )X loser (let's say0 30*diagram above ) into the 0 position, and n percolate this new 0 down 3tree, exchanging values, untilB invariant is re-established. TT is clearly logarithmic on@total number of items ipree. By0ratover allms, you get an O(n ln n) sort. A nice feature^Athat@can efficiently insert  @whil"eZ<!gon, provideP!at?"ed are not "better" thalast 0'th elemenextracted. A especially useful"`simula contexts, wher` holds0` incom@even*` "win"Bda meanssmallest scheduled time. WhensLq other s for execu,Qy M fu1, s!y asily go'heap. So, a a good strucFx2impRqArs (@is waI used1my MIDI sequencer :-). Various_`have been extensively studiedws &1, au$ reasonably speedy, PlmostRstantZ0wor0ase'wmuch different }average casqHowever!rerepresentj:ich are more8 rall, ye s might be terrible. Heap also verbig diskss. You Aproball knowR@t a 3`mplies0duc"runs" (which@pre--4ed ? 1siz@1usut re##d J`amountPCPU memory), followed by a mer3Rpasse6`these i%is often  clly organised[1]. Ie#Pimporinitial eSP longzs TournayAway atuPf, usDvi availabohE a tR replacepkU`happenY"fi60cur'D'll produc;  tw oferandom input, "P fuzzmPorderP MoreA, if$RoutpuZQP may ) (becausa!s"R)"P), it' _], so the sized of the heap decreases. The freed memory could be cleverly reused immediately for progressively building a second k , which grows at exactlysame ratep first 5 is melting. When!pcompletvanishes, you switchF s and start a new run. C quite effective! In a word,Dre useful structures to know. I% m in a few applications,pI think itAgoodCpeep a `' module around. :-) -A [1]disk balancilgorithms{are current, nowadayre more annoy:Cthan@thisa consequenceI seeking capabilities\On devicecmt<, like big tape driv`the stAwas b diffeaone ha<be very N ensure (far in advance) th~Aach omovement willUmost  possible (=4is,.st participEat "0ng"  merge). Someus were even aXto read backward nd% s @alsoY@avoiqe rewinltime. Believe me,P"l ZVCsortwKspectacular.watch! From all Q0s, 7has always be Great Art!""" __all__ = ['rpush', $op 4ify preplace'F', 'nlargest cnsmall ^pop'] defq(, item):Nq"""PushQ onto,, maintainn9 invariant..append(VU_siftdownpR0, le G)-1)!op#!opflastelt =7`.pop()# raises|PropriIndexError i0Qempty5F`returna1[0]*c[0] = uE, 0)P WF= !opI< VRvalue"ad1x!. zT`effici Ofollowed byfe)Yacan beME5appow us^a fixed-sizeDQ. No!at H ayrn)!!at`trains1sonJu!ofJroutine unless w ritten as part of a conditional replacement: if item > heap[0]:"=@((,5)+1"""greturn10[0]C# raises appropriate IndexError if_ is emptyMe@=is_siftup0}u |B deQdpushpo0)"""Fast version*q2 followed by aDpop.1and<\k,=2[0]4& BVify(xTransform list intoQ, in- O(len(x)) timeBn = &# Qbottom-up. The largeddex there's any point to looking atN is);@with`hild irange, so must have 2*i + 1 < n,L < (n-1)/2. If n) ve2*j, thisA(2*j( = j-1/2 soH0j-1"tp, whichn//2 - 1_odd = 2*j+1`Kf%+1h^ @that/Pgain f1-1.FfPin re1ed(($)#Rx, i)_aop_max /`"""Maxlastelt . )k" a1[0]c/#=  #, 7TJLM&5ush:P="Q y1ify"m %0# ''kPp at allices >= startpos, except possibly zPpos.  #FJSleaf g7 out-of-order value. Restore! # invariant.RdAdown\,3posE0new2pos1# F;_P pathroot, mov(parents e until find!a  $# gBfits7Pwhile$ >s: parentpos = (- 1) >> 1 p# = heap[Epos]!if newitem < :E9Sos] = w9poscontinueQbreakV # The child indices of0ex nare already s, and we want to make # a7 at=too. We do this by bubbling the smallerAof #u@up (fso on with that'"'sren, etc) until hittXa leaf, #b@n us_siftdown0ove oddball originallyinto place. # #*could* ]@ out4loop as soonwe find aVwhere= # both itbut turnsY's not a good idea`despitat # many books wrrgorithm=way. DurApop,  last array # element is 7e w` tendsHbe large, sAompaaiagainst values star0froe root usu{doesn't pay (=P # ge-"ofuearly). See Knuth, Volume 3, zt~ isxplainedquantifi an exercis"CuT#c@sonsimportant, sinc esutines have no # way3extract "R0pri1y" "anWintelligenckis likelR`be hidin custom methods, or ia1sto(, record) tuples. Cthus potentiVSensiv8On randomYlength 1000,5change che number `s madeAify() a little5ose&exhaustiv132pop31ot, c]0eorHypical results3 # runs (3 jusdemonstrate howPvariaAis):?Hes neededg -X0pop-Br # 1837kao 16638T14996 A86803$55F1659. G14963!7834f0)T15024SA8703ABuil!apush()@p times \ ead required # 2198, 2148C2219Aes: L=is more efficiewhen # you ca:e it. # # The !total compares needed by list.sort() on the sames were 8627, # and 8632 (this should be]Bd toGum of heapify():! #Tpop()1As): ois (unsurprisingly!) more efficient # for ing. def _siftup(r , pos): endpos = len)Rstart1posnewitem =Q[pos]# Bubble upmaller child until hitting a leaf.8 c 2*0+ 1# leftmostCposition6Rwhile4<?#Se:!to indexns2Crigh1+ 1o 5if #pB not 72] <0]J(% =Rfo# MoveBpzRd=!_)5 = nQ# The0 at is empty now. Put athere,bSit upIlts final resplace (by @its jnts down)pX($, $O_max(@'Maxh variant`'o{aaFollowDpathroot, mov@find!a e#RBfits>Caren(%w- 1) >>|1#ifx$ <ae_Nw=Ccontinue1QbreakV^'up"up?Olarg,rd  B%#/ u up # to its final resting place (by sif$parents down). heap[pos] = newitem_8(P_max(&2, startpos, pos) def merge(*iterables, key=None, reverse=False):X@'''M3 multiple sorted inputs into a singoutput. BSimilar to;(}tools.chain )) but returns a generator,Ldoes not pull the datamemory all at once, and assumes that each ofM? streams is already (smallestlargest)>>> list(T[1,3,5,7], [0,2,4,8 5,10,15,20Q25]))[0, 1, 2, 3, 4, 5p7, 8, 15, 20, 25]LIf *key*`applie/key functionaelemendetermineco order'dog', 'horse'@'cat@fishkangarooM4len= 2L6, ';2''' ah = []h_append = h. $$if:)_dify =  4pop >pop "reD (BdirefA= -1_Oelse%:popp3eap#z1 0is 2for, it in enumOQe(map )6tryKnext = it.__ %__ ([!2(),5 * , ]4except StopIEpasss&(hKwhile len(h) > 1C37TruSvalue@ = s"[0*ayield 82s[0@xt()# raises when exhaustedR ,S(h, sW#c1ore:` condiZ E{c0popYgmove empty fJif h# fast caseFonlyJBv remainsY hAfromw.__self\D' k next = it.__next__ value = )()h_append([key()), order * direction, ,C]Cexcept StopItera,:aApass_heapify(h?while len(h) > 176try +JTrueCkey_ = s = h[0]1Ryield Q1?vs[0] = 2 A0s[2"H  replace(h, sZP=4popGFif h Afrom(.__self__ # Algorithm notes for nlargest() and nsmallO # = # # Make a single > over the data qkeepingk most extremes # in a v. Memory consump is limited to Qk@>Rlist.easured performancerandom inputs:, number of comparisonC nKA*k- (average<5 trials) % more than min() # -* >---1*1- #b 1,000 1s 3,317 c231.7%G/10Gd14,046@C40.5G/10Gt105,749?5 %U7,751? 00.8G %O9,40G!1%;Theoretical %t$k g/n Step C_A) 1.66 * kd 1ifyfirst k-72*?n -># ,e remainelements0topfP3P k * (1 + lg2(k)) * ln(n/k41topF1 onL4LGp - (k/2D final sort #b3simplifyRa rough estimate giveZ5 = n + k * (log(k, 2) * log(n/k) +  *) # # Computing the number of comparisons for step 3: # - # * For`i-th new value fromterable,probability be in # k most extremeLs is k/i. m_exampPQ101stMXseen iO 100g100/101. Ifa cof inserrpit into@@heapC1fHThe Ptimes9 WPgives @(k/i(O)@SummURacrosH`remainn-k elements ZOsum(^,i in range(k+1, n+1)xThis reducoH(n) - H(k)Ok * aWhere -inXharmonicestimated byjgamma = 0.5772156649?^=9@n, eE5+ 1 / (2 * n http://en.wikipedia.org/#/H_series_(mathematics)#Rate_of_divergenceVbstit{formula/= 3E (1/n - 12/ 2 Worst-case A # I w9 9input datareversed sors0at y+k # must be" edG:) = 1.66 * k;kAlternative Algorithms # Other a, wyPnot upbecausea1) Took much more auxiliary memory, # Made multiple passes ove%;23) )J in1monvs (small k, large n, semi-random )R!SedetailedLnapproach atjpcode.ac< state.com/recipes/577573-&e-0P-for-qest def nU(n, ikey=None): p"""Find_4 n 3Ain ahQset. 3Equivalent to: u(ckey)[:n]22""";# Short-cut@n==1 toa min()2if n == 1Ait =j+sentinel = objectGPresul<^it, default=5 , {4turn [] if Ais sentinel 0else [result] # When n>=size, it's faster to use sorted() 0Atry:9 3 = len(iterable& except (TypeError, Attribut)EApassRif n >= dvdreturny, key=key)[:nkey is none,impler decoration ifD+FNoneuPit = h # put the range(n) first so that zip() doesn'tg7consume one too many elements fromVwEator:P = [(., i) for i,>1 ins%)]>V2ot EW1_heapify_max(3Stop =MV[0][0iorder = Z-Jreplace = ]r*it"ifZ< top c#, ')0atop, _$"E+= 1. )H[ 8 General case, slowest methodlH 1keyg$), c 1> -68in 0k =h j1k, & 1, _rvE  9 { def nlargest(nG*q"""Find#n 2 0in a dataset.Equivalent to: 0, reverse=True>2"""I# Short-cutj@n==1%WKV == 1asentinel = objectE0 = ^it, default=5!zC] if2 ` n] # When key is none, use simpler decoration if+QNone:t = iter(Uable)Presul [(elem, i) for i,  in zip(range(0, -n, -1), it)]Frif not My}creturn1heapify(2Stop =-V[0][0dorder = -\_Greplace = i*it0if p<  ^#, &)0atop, _$"E-= 1 .sort(reverse=TruK[ D!] U# General case, slowest method#i H = [(keyg! @   ,58in 0k =2ke1k,  1, _rvE <  # If availC!C DBmentA2tryQfrom q$ ort * except ImportError-_pass ; IO_maxJ,?ifyF0?popF if __name__ == "__main__":aiP doctX# pragma: no covercprint(%.*mod()) 0"""HMAC (Keyed-HashingMessage Authentic) module. Ias the Halgorithm as described by RFC 2104. """ warnings/_ &_hashlib& openssl1%0 = _@_md_s`operatm_compare_digu:as C els_frozenset(.s _9 = 9 H!lib trans_5C = bytes((x ^ 0x5CRxange(256)) transT_36 = bytes((x ^ 0x36) for x in range(256)) # The size of the digests returned by HMAC depends on (underlying # hashing module used. UsO_bAfromdqinstanct\Read. ~/= None class *: """RFC 2104 !. Also complies with )a4231. ;This supports1APICryptographic Hash Functions (PEP 247).F1"""Qblock= 64 # 512-bit; can be chtd~1sub#es__slots__ = (U_ cons", "_inner 2out ~,1) def __init__(self, key, msg=a", :rmod='')b""Create a news object&Bkey:n or bufferbU*Qkeyed#>9?msg=Initial inputGdcB2: Adname suitable>:lib.new(). *OR*iD@@lib utructor MKm j?B;xRequired as3.8, despite its posia after op/almsg argument. Pass it`aEword#? isF recommended, though not rTplegacy Fvreasons'Y!if= is((,Cgarray)raise TypeError("raexpect0tesHA, but got %r" % typel@).__#__^G |"MiJ`parame'D:'."b@call(# .& =Welif @N_, strSlambda d=b'': _L'd)r&se WJpd <2 = ._r(x*E/=. if*Aattr.\6, 'Q3`4/1if 2J< 16E#_warnings. (|%d seems too small; uYour 'm  'default of %d.' % (blocksize, self.0), 4RuntimeWarning, 2)2N+ =_+Uelse:o"_wR s. Q('No H_ attribute on given digest object; 'NR'Assuming  #  is the D.)'isFeffective was well aTpublic API7.D_=JI %if len(key) >! 4key_Q_cons6.&()T/key.ljustVb'\0'H_outer.updateTp.transl L_5C)4?inn4 '364`if msg{not Non3msg@property.def name(-)!return "hmac-" +_1M9JT.rKmE"?? "?+[,Z"""Feed data from into this hashA."""^O.9bwLcopyB"""Ra separate )rp2An g 8qwon't aoriginalb# Call __new__ directly[QavoidJ`expens__init__MUotherg_class__.Q$._7 %Dad/ . -(.*('* */_current N:A forQ7r state.PTo be used onlyernally withS() and hex&()h hR$h$78]valueobject.  &This returns the hmac value as bytes. The object is 9 not altered in any way by tW function; you can continueBupdating{aafter call4is J.95""" h = self._current() h.digessdef hex=!):"""Like e), but%Pa stroCadecimal.its instead(0) new(key, msg=None,mestmod=''"""Create a new hash3andQ it. Bkey: or buffer,Astarqkey forR?msg9Initial input6,`?Yamod: A name suitable;m@lib.q). *OR*<0libXstructorGPmodul2pposPEP 247(pPRequias of 3.8, despite @posi R op,almsg argument. Pass itya keyword#y recommended, though rlegacy API reasonsYpnow feej`bitrar te!tou!s egmethod, b1askNt!@time"5O'or") ^s9EHMAC") 9X<"1Fast inline implea_,*!Rkeyed3.&rmessage)ebest performance'1?A m$Pif (_openssl is"  is.(,\)(W_K@_md_sw r._P )!if`mzT;s_cons =_elif > ?lambda d=b'': )2, dOelseF9dEnnerOuN_cons() blocksize = getattr(inner, '_ ', 64) if len(key) > #":!key = digest_cons,.(E$+ b'\x00' * (N% -e1p.updatePp.transl B_36)*_outer* #5C* T?msg@#!rreturn h% """IMAP4 client. Based on RFC 2060. Public class:-;variable!TDebugfunction@Internale2tuple^oInt2APParseFlags#XTime2r # Author: Piers Lauder December 1997. #<`entica, code contributed by Donn Cave JuneT8. # String methodLpversionKESR, February 20012GET/SETACL/{Anthony Baxta @ixlink.comUAprilR=_SSQTino Lange < . @isg.de> MarchF2^QUOTAdreas Zeidlz@kreativkombinatR1200QPROXYAUTHNRick Holbert 2683 sugps limitqp # comm]q1000 octetsvthat ser should beppared #5!ac> M up8P P we u{ to 10K hereNIn the modern worldd (eg: gmail) the response to, for example, a # search command can be quite large, so we now use 1M. _MAXLINE = 100R # CK4s R = {  # namevalid states''APPEND':" ('AUTH', 'SELECTED'),.UTHENTICATE': ('NON1&CAPABILITYX& _, 'LOGOUTiQCHECK>(,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$MCSTORoZsUBSCRIB+ XTHREA&UI$6UNS~ ('AUTH', 'SELECTED'), 2'UN!':"('GED','A} # N Patterns 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: local"!);5! -aw number5d\,)).? - socketE)5|E If1t given or is None?, the global default socket timeout is used A$All IMAP4rev1 commands are supported by methods of bAsame@name (in lower-case).[arguments to^Qconve^to strings, except for^AUTHENTICATE, and}Tlast ZYAPPEND whichpassed asE"an literal. If necessary ( contains any= non-printing characters orote-spaceisn't enclo~AwithCeither parenthese>double quotes) each!d.@However,'Yword'TLOGINeERalwayPyou want:avoid hav&anTdB(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,("")D server $P<Xabort<ba sub-sAof 'H'. Mailbox status2ngeREAD-WRITEOONLYreadonlyP '""ions imply a program("<.pconnectxshould be!et0 re-trie0"f6c@cPNote:Juis module, ;Pmust c*RFCs per6D toGprotocol, as semanticL$:D\1lefPinvok!nod70resb. AlsobAmoste6 4set^ts availaa"""!(E`ion): # Logicals - debug requireUF(LBFqServiceFrs - close and retry class readonly(abort): p # Mailbox status changed to READ-ONLY K,def __init__(self, host='', port=IMAP4_PORT, timeout=None):@o7.debug = D e = 'LOGOUT'literal = WPD# A argumenta commandJstagged_cs = {}L1# T9s awaiting responseL#unNO# {typ: [data, ...]}Bcontinuation_F' # Last "4is_ = False& # desired tagnum = 0_tls_established_ &mode_ascii()2# Open sockevserver."Popen(OLAJ6tryI[9_connect()except E:ion6 GKshutdownKOzOSErrorM L|Rraise4 utf8_enabl[Pencod1= 'b Lre.compile(_, re.ASCII#$.Uvu> F  ;Trus__utf-8)') D# Create unique tag for this session,P# and6~,G^matchPtagprInt2AP(random.int(4096, 65535)1tag9br'(?PG + .y" + br'\d+) Rype>[A-Z]Y>.*)'9b# Get  welcome message0qrequest8store CAPABILITY*i>*___cmd_log_len = 1 #Hidx  "`e@' incsL"ifgZ >= 1Smesg('imaplib verV %s' % __&__;?new IMAP4 connection, tag=%s' % self.tagpre) welcome =%_get_response(),if 'PREAUTH' in-untagged1%s:1da@stat_'< elS/OKN%= 3 _mesg('CAPABILITIES: %r{',)for versionyAllowedV qhif not/\continuePROTOCOL_VERSION =[ ,freturnX xq'serverIMAP4 compliant') 9Pdef _aattr__ , )#1  UPPERCASE varMUs of amand methods.!ifUK0Com$ D@ get}.y6r()AttributeEe"Unknown: '%s'" %~Dente"EexitW*args4t= "LOGOUT"CB[V:try!uw.logoutexcept OS 2CpassOverridable"create_socketgwtimeout# Default value.host is '', but H.wddrinfo# (which1tused by1$co8()) expects Non# as a d anF   >IV\('Non-blocking# (<4=0)[supported'! = $el sys.audit("imaplib.open",s uraddress = (V$3if  I.h,J:xv=H=@U_PORTh="""Setup 6 to remotq@on "Z:V"jp(Dq: local&standard75)UHThisnwill be  the routineGs: `read, line, send, shutdown.,5""" self.host =  0por qsock = >_create_et(timeout)1Dfile1)P.make('rb') /1def(Yv, size)"""Read '' bytes from remote.breturnh.(: m-qkcc(_MAXLINE + 1 pif len("D) > %Rraiseerror("got more than %d5" %BccS j, dataASend? toIsys.audit("imaplib.P"`#lfR.%Aall(r Close I/O established in "open"ivc6(:tryS+|ocket.SHUT_RDWR>except OSE~z as excP@# Thrver might al_qy have d the connectio'# On Windows, this may resultWSAEINVAL (g 10022/FAn invalid operaj was attempted2if (exc.errno != .ENOTCONN, and getattr7a, 'winP', 0)A>Pofinall2(/et$R instance usedq IMAP4 se.`ZD = <=>'etDJ= #N Utility methods?cenmx re% 'RECENT'ponses if any exist,Kelse prompt for an updat 1ing~'NOOP' commandp(typ, [*])  ''' is Noneno new messageslist of (, Flastp0nam+ da_untagged_res3('OK', [0], I ifJ[-1]3^onoop() # Prod{;Sk1;], codturn data for response 'code' if received, or None. Old value fo=s cleared3(Y, [data]) = .~$)f5""" return self._untagged_90, [0], k.upper()) #IMAP4 commandsdef append(c, mailbox, flags, date_time, message):A"""A= to namedH ?typ|All args except `' can be,8 \ = 'APPEND'dif notD7YINBOX64 0Aif (B[0], -1]) != ('(',')'Qb)dr(%s)' %Jelseg1 '&if / = Time2Internal(r%! =cvliteral = MapCRLF.sub( C-"ifutf8_enabledOb'UTF8 (' + V+ b').=&n Mssimple_( O1uthenticate7echanism, authobject*6 - requiresprocessing>$'mb' specifies whichrEion *e is tobe used - it mustXar incapabilitaein theCform AUTH='cbe a call :! =$()-pIt willR edo. server continuat D)s;8Pument`is pas da bytes. It should B6thabase64 enpd and sh toYLapthe cli<Vabort&4'*'"be^YEead.M& =(-c# XXX:Tn't thisSqAremo4ented out?B0cap! %sv Y'in:ap # Levdecide!I)@rais"lf.error("S@doesallow %sV n." % mech)  #self.literal = _Authenticator(authobject).process 9 typ, dat = E_simple_command('AUTHENTICATE', mech)> ifA != 'OK':^RraiseUerror(dat[-1].decode('utf-8', 'replace')Ystate = ']`returny! def capability(A)A"""([data]) = .8VFetchS ies list from server."""~1namCAPABILITY|g<{._untagged_responseRdat, 7OheckCpoint mailbox on?Z#B(3 @xCHECK')Olose currently;Tected.ADeleessages are removedwritable=This is th3`ended and before 'LOGOUT'v 6try  v'CLOSE'mkfinallF#"op=0_seJ3ew_ 7rCopy 'mi,#' s onto end of 'nB5MZ', Dk1OPYBreat,# "  8(L#REk;d<? ol7Z'BDELE"\:aclZ, whoubACLs ( any rights) set for=70ACLpKL enb S>an RFC5161 5 string tom (typ, [data]) = .enable(capability) 5""" if 'ENABLE' not in self.8Eies:.Araise IMAP4.error("Server doesEsupport Y"ztyp, data =g_simple_command(%, if typ == 'OK' and 'UTF8=ACCEPT'8.upper()_mode_utf8(`returnb def expunge(<O"""Permanently remove deleted items from ecmailbox.[NGenerates 'EXPUNGE' response for eachTwmessage@(S[T )n'(' is list ov#d ] numbersMorder received.Bfname =%?dat9 ~c._untagged_ Rdat, 7Qfetch,F_set ZpartsF4! (D of)9sZ\, ..._x5r/'&q' should be a string2sel&&G`enclosQn parentheses, eg: "(UID BODY[TEXT])"are tuplesfKt envelopeK eFETCH'J{dgetacl^ Get the ACLsQ.a _Fb4  'GETACL',{G'A") Unnotation, entry, attribute VPRetrieve ANNOTATIONs."=%v 7Z >Squota9Jroot$8& 'spource u6Xlimit81ParZu& QUOTA extension definwrfc2087 () """  #typ, dat = self._simple_command('GETQUOTA', root) 9s return6untagged_response(Y2, '@1) <def getquotaR(x, mailbox):%e"""Get the list of 5Qs forTnamed?.d?![[~TROOT rs...], ]]) = . F' AS@SD O[P,y] directory='""', pattern='*'LH Us in ? matchingBLdataE'@E' isQ8LIS5""" @ = ','#96, l/._ K>Slogin}@user\jsswordpIdentify client us]laintext pa6hv p\TNB: 'R' will be95ed.7YC 'LOGIN', u)$e(i)Oif typ != 'OK'GRraiseerror(dat[-1]>]PstateFAUTH_cram_md5` ForceCRAM-MD5 authocation|$q) . =H>.4e('"',X_P_MD5_= %challenge Authobject to` with ]* Pimport hmacapwd = u..encode('utf-8') if is ,V, str'M$elmrAQ + " " +.HMAC(pwd, , 'md5').hexdigest(]alogout JShutdown connection to server. # (typ, [data]) = .logout() -Returns server 'BYE' response.'5""" self.state = 'LOGOUT'}adat = )_simple_command(1)2'shutdown(r Q def lsub(7, directory='""', pattern='*'):c"""List 'subscribed' mailbox names inL matchingO.|a^], ...c K'' are tuples of message part envelope and .?SUB6A< j._untagged_ Adat,CUmyrightsi Show my ACLs for a(i.e. the G that I have on()  f MYRIGHTS',<''F-Qspace. % AIMAPf*s ala rfc2342Pj GNAMESPACELUr)OnoopSend NOOP FNif __debug__'"ifZ >= 3 $qdump_ur.sy  '1ialW,F_num #, start, length8Fetch truncatedM ofd_A6m"is-PARTIAL6C ZFETCHroxyauthJuserpAssume $entication as ","Allows an-orised administrator to proxy into any user's mailbox. (typ, [data]) = .proxyauth(F)36"""@name = 'PROXYAUTH'( return self._simple_command(0,") T`def reV(9S, oldS, new %):gA"""R1+  B0 to3uon  RENAME'csearchcharset, *criteriaS-for matching messageswqpon, ...)9' ' is space separated list of numbers.,pIf UTF8Eenabled, z MUST be None2g~= 'SEARCc$ifE0"ifwSutf8_p "&raise IMAP4.error("Non-W not valid inVmode"IDRdat =w , 'CHARSET'*Jelse_0K untagged_responseAdat,.cselectS ='INBOX', readonly=False:$ aFlush all  ]( Bcoun$I ('EXISTS')AMand are ('FLAGS', >, 'RECEN'UIDVALIDITY'), soUotherjs shouldobtained viays_) etc*5.``s = {}"# 6oldK?4is_% =i  vEXAMINE +fSELECT*if typ != 'OK'Astat  # Might have been_&ED*F Y< ifAD-ONLY'p2\Tp1and{ if __debug__ if self.debug >= 1: s%_dump_ur(untagged_responses);araise +readonly('%s is not writable' % mailbox@return typ,Bm .get('EXISTS', [None]) def setacl,bP, who6at)"""Set a&R acl.I ([data]) = .dY^>5"""  _simple_command('SETACL' nnotationZ*args B[, entry, attribute]+ ANNOTATIONs. Rdat ==2', @  fdat, ''Squotaroot, limitAthe . ('s resource2E(Em qQUOTA',N!H 3ortsort_criteria, charset, *search J IMAP4rev1 extension SORT 0 V, ...|Lname = ''n1#ifT"incapabilities: # Let server decide!I( 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 ? bV j<bed by f# Generate a default _ 6ne was passed.yif ssl_context is None: ssl_context = ssl._create_stdlib%()7qtyp, da0 elf._simple_command(name.if typ == 'OK'}?Bsock{l`.wrap_Det(s$, server_host=K@@filenP.make_('rb'1_tls_established = TrueZ_get_capabilitiesK;elsaraise 9error("Couldn't m TLS session"breturn<_untagged_response( , 1) def statusj, mailbox&&s)"""RequestAd7 conditions for@._`z[data]) = .z t:5""" = 'STATUS'2#ifPROTOCOL_VERSIONsIMAP4': # Let th] decide!Ir a'%s unmented in Vd (obtaRrev1 q, 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( _, ...H 8/,  p, dat, name) def uid(self, command, *args):#'"""Execute "% arg ..." with messages identified by UID,FJrather than8 number.% (typ, [data]) = .,1 2,)BReturns response appropriate to 'D%'.5""" $ =.upper()"dif notR in CAs:`raise c.error("Unknown IMAP4%Et: %s" % lA stwo[]x ( %s illegalTF%s, "only allowed:s 7({,s*', '.join(X&))name = 'UID'>Rdat =q_simple_(5 >$if('SEARCH@SORTwTHREAD'$V1OJelse)f'FETCHruntagged_Pdat, @ nsubscribewmailboxF"""U' from old *|B(9? }'UNSUBSCRIBE', Qelect 0FreMQrver'ources assocd th'EeBand "s )P@authacated $EThissperformE`action CLOSE, except{tthat no s are permanently removedAcurrDs8:tryDaEfELECT'kfinallJn= 'AUTmQxatomA b extensions4&no!seKAPABILITY0UfAssume5is >'p `L = name.upper()  #if not name in self.capabilities:( Let the server decide! 0 # @rais"lf.error('unknown extension command: %s' %y)F C,%s:!f[Q] = (fstate,LSretur_simple_}(:, *args) _ Private methodsdef _append_untaggedx, typ, dat) if is Nonedat = b''vBur =zZ_responses%if __debug__Q"if=Z >= 5 c"P_mesge[%s] %s += ["%r"]' %y?(len(ur.getB'')) ifV*urur[typ].P(<o;els1. = [dat]check_bye?byeTY'BYE'+byyabort(bye[-1].decodt._encoding, 'replace')U46u,{:z*:in  DN.literal =hDQ"pillegalqY%s, "@D "only allowed:_s %s".Cpp,k ', '.join()ZSd fora@('OK4 NOGBAD' 0h ]32delX- 'READ-ONLY'G8% \1andpis_reada !('mailbox Jus changed to )4tag _new_tag( Hytes+pdata = P+ b' ' +0argZ 1if  continue>tif isinstance(arg, str)K1= b'r-6arg$H3if 09#e(I)J4typF1 to% l1*6 r data =#+ bytes(' {%s}' % len(literal), self._encoding) if __debug__:"if6Z >= 4 $Wmesg('> %ry)JOelse<-lo;<:try7oPsend(ev + CRLFlexcept OSError as valBRraiseabort('socket e3@: %s:val#I{ is Nonreturn tagWzwhile 1}# Wait for continuation response?\CT_get_&*()V,tagged_commands[tag]: # BAD/NO?\6s# Send #if>tor3& =%(lwJ (%_Swritecl size% }U}x# '!8cif notVbreakDdef >Qpletep, name,logout = ( == 'LOGOUT'P# BYE:expected after )wR RS_check_bye(\ Btyp,=;BRtag, Q=Wx'LxG3 =>d,)b{b %/('b Paif typJBAD'3%s @ v |capabilities|qP ,y if[] no CAPABILITY from server da0strN[-1]]+dat.upperZies = tupleU.split())response(self)C:  # Read response and store.#  Returns None for continuationF's,3otherwise first% line received. = self._get_)&()!`# Commicomple|?(#ifEamatch(Qatagre,%): 4tagvmo.group('tag')'pif not ."in`tagged_csW[ raabort('unexpectedJ&ger: %r' %G?typ;ype(rtr(typ,_encoding>datSKdataS [tag] = fV[dat]]Jelse adat2 =: # '*' (un`)s{_U5_54=9 >ostatus<@8 +'2'+xBmo i+ $q# Only  possibility2X'+' (Y'..)HpC hF{r # NB: indicates# / ""~0if @ P= b''t# Null  Q\:?R+ b' ' +23P# Is Re a literal to come/Swhile.L5,]) \direct from0necosize = intj%&')fif __debug__""%_ >= 4(,)_mesg('r0 %sU :(' b0# SU withas tuple8tappend_ 6A(dat+a)E9trailer -) lytaining anER= self._get_liwne() self._append_untagged(typ, dat-# Bracketed response information?Xif typ in ('OK', 'NOBAD') and vsmatch(RMR_codev:L=3mo.group('type')("trdencoding+hgdata')if __debug__"ifQ >= 1 , 'BYE')@~_mesg('%si: %r' % areturn, def _get__(_ , tag, expect_bye=False):<zwhile 1sresult Zcommands[tag] if2is not NoneRk2del6Q.6ult'ifh=w ;4bye3Rs.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 ignoringm here causes loop9`Insteaend me details ofB  # I'll upda e `d]:)'.>try09 p ab|nas valK F(print_log(\raisebAlineW@R@readQ!if b#('error: EOF'# Protocol ates all Ys terminauby CRLFgP.endss|(b'\r\n 'unhy ! =F[:-2, 4.0<%k else:   self._log('< %r' % line) %areturn! def _match(>, cre, s):9# Run compiled regular expression @ method on 's'.^?Save result, rsuccess.gP.mo =.S&(sif __debug__:]a4if <is not None and5Z >= 58<9_mesg("\tu ed %r => %r" % (cre.pattern,Qmo.groups())7mo kqnew_tagmeRtag =_tagpre + bytes(str..tagnum)_encoding&Lunum + 13&ged_commands[tag] =9)8tagQquoteX, arg ar arg.replace('\\', '\\\\'("'6"')P'"' +kh + '"'dsimplename, *argN2bplete(5 I)wPuntag?tresponstyp, dat, O)nif typ == 'NO'<~!ifJ2 in ysL[]ODdataGA.poppX'oA[%s]bsy9aOa 0, s&0cs=q/ cs B!secs = time.($tmAstrf!'%M:%S',4QlocalJ>sys.stderr.write(' %s.%02d %s\nPtm, (=*100)%100 Igflush(:bdump_u<k, dict t# Dump ps (in `2&')1l =Jk.items#l::t = '\n\t\t'Smap(lambda x:'%s: "%s" x[0], x[1][0]'" "'.join() or ''), l!B:%s%Bt, tTlJQWN 2 # Keep log of last `_cmd_len' interactions for 9Jging]c.;[@_idx(, time.time()7) self._cmd_log_idx += 1#>if &+>=Ilen:7e8E= 0 'def print}(-)D._mesg('last %d IMAP4 interactions:' % lenB)\i, n Nidx,owhile :try.* _:[i].oexceptJIpass1iOf i /  0n - if HAVE_SSL:Rclass}()D1""" client 1over SSL conneP3Instantiate with:`[host[, porkeyfile[, cert ssl_contex#timeout=None])koV0 - 's name (default: local-);w! -w number94dar0G - PEM formatted P that)tains yourv7keyp] ^@ificJRchainpQa@ - aCp object m L?and >`Note:  is provided, then parameters u-orM|should not be set otherwise ValueErrorh}raised.K - socket  g5 If!isrbgiven _,]/the global  pvis usedfor more documenta8@ see+string of6parF""" Z__init__,[2=''=>1d_PORT,$ X 1S g wz'(" G1argOs are mutually ""exclusive" "ssl_context and certfile arguments are mutually "  "exclusive").aif key^is not None orv:<uimport warnings . $("l e deprecated, use a"custom ssl_context instead", DPBionW:, 2Tself.= #= %*ifsC+=3._create_stdlib(q= ,pw=  uIMAP4.__init__(, host, , timeout) 7Edef Socket7+ #ssock = i8bpreturn .`.wrap_Tw?ockDpserver_Qname=c Copen2=''=_SSL_PORT#=b)"""Setup connection to remote P on "b:r)". (default: local+standardXA SSL)>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'-j.5! =0# Fompatibility 1FF x self.process = sub .Popen(self.command,  bufsize=DEFAULT_BUFFER_SIZE)hstdin=ZIPE, stdout dshell=True, close_fds)(writefile} ,Oread+Aout -@def ( , !):"""Read '' bytes from remote."""-qreturn S{. (>*) qAlineuog6(gAsendcj, dataiASend? ton. (G #Zflushbhutdow] C I/O established in ""YhIR(.%Await class _Authenticator:"""Private &to provide en/decoding)for base64-6d aYion conversation.:: __init__mechinst30 = y# Callable object/ml4retZg%.eyi:t is NoneC @b'*' # Abort-encode(ret)!W, inp#F# Invoke binascii.b2a_64 iteratively with7 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 no partial 6*boutputPoup = b''HPif isyance(inp A in7Cinp.v'utf-8'8 wh:inp3 if~Wj) > 48[inp[:48]xJ[48:;els1NI.pX&(t'?if kKv+ e[:-16oupoQif no G binascii.a2Fb_base64(inp) Months = ' Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec'.split(' ')G2num = {s.encode():n+1 for n, s in enumerate(wB[1:])} def Internaldate2tuple(resp): """Parse an IMAP4 INTERNALDATE string. ,Return corA onding local time. The r&value is a<!pstruct_   or None if the o has wrongAmat.CA""" Emo =Date.match"if not monFpn = Mon`[mo.group('mon')]G@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"""Convert@eger4A-Prepresentation.@val Q'; AP ABCDEFGHIJKLMNOP'1abszwhile num.0numd = divmod/B, 162vAP[mod:mod+1] + vallRFlagsW.f#  sebpythonP(i3l|2')./)XTime2(v   in form: '"DD-Mmm-YYYY HH:MM:SS +HHMM"' puargument canNaber (intufloat) 1ingCseconds since epoch (asRed by)), a 9-C@Q, PinstaW"ofD3(asAi:nn aware  Vrdouble-quo>NQ. In 0lasase, itJBssumgqalready be?!ct6Tif is,i", g0dpP.fromVstamp>,  timezone.utc).as0() 4elif isinstance(date_$, tuple):'+6try gmtoff = 5B.tm_6except AttributeErrorH0if r.daylightj8dstg5[8]`1if &N= -1A"jPlocalt(0.mk/))bB = -64Z,T0altZ)[dstNelseOI.@qdelta =] (seconds=:D%(*[:6], tzinfo=`(L)>F4c.W{ is Nonraise Valu ("NW must be aware" 'str) and E[0],g[-1]) == ('"','"'freturn~ # Assume in correct format not of a known typ fm '"%d-{}-%Y %H:%M:%S %z"'.n(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"MtD the;tream classimport getopt,p optlist, args =*Bopt.9(sys.argv[1:], 'd:s:'[( .e6val \b(), ()sP_comm=.@for 0valWEV if6-d'Debug = int(val2opt7s7 1val;0if $:*(6,+$''! =D2[0] BUSER{|CusernjPASSWD' ("7 @wordw %s on %s: " % (X!, rAor "#")@_mes3'From: %(|5)s@.%(lf)sSubject:rrdata... `' % {'H"':'lf':'\n'}Wxseq1 = (('login',3)),`create '/tmp/xxx 1',! rer ! /yyy')), ('CREATE', ('/tmp/yyz 2',)), ('append!c None,test_mesg7Elist5', 'yy*'Vselec!w`searchBi'SUBJECTKoL2fet* '1 (FLAGS INTERNALDATE RFC822)5Pstore_54', r'(\Deleted.namespac2kexpungQrecen)Iclos'!) __seq2 = (&('@`responC('UIDVALIDITY"ui`SEARCH 7ALLC ('EXISTS?p Ylogoudef run(cmd, args):a!M.9('%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':useq1 = [1:] # Login 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 would like to see d6ging output, try:`-d5 ''>sys.argv[0]]2 """Recognize image file formats based on their first few bytes."$"" from os import PathLike __all__ = ["what"] #-# # Recognize image headers #8 P def a (file, h=None): f =  2tryqif h isisinstanceUU(str,)^.jCopen1Q'rb')v!h = f.read(32Jelse1location8ile.tell(9'X ["d.seek(SFfor tf in testsres = tf(h, f4T[if re/`returnjfinall{f: f.close4( @0Subroutines per6_ type8 H !] LR_jpeg"""JPEG data*JFIF or Exif format"""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?pix6/36ppKrast?@Sun 0er Q h.startswit h(b'\x59\xA6\x6A\x95'):  return 'rast' tests.append( _q) def xbm(h, fD """X bitmap (X10 or X11)"""dif h.startswit#define ?xbm8xbm8bmpd/BM^?bmp^8bmp^?web_ RIFF') and h[8:12] == b'WEBP'\Qyz?exr \x76\x2f\x31\x01?exrmexr) #-# # Small program #.(import sysrecursive = 0 if.argv[1:];3sys?7'-r<8del2!2]G]16tryu j<Fall({E:], RA, 1)R,Oelse>O['.'7 except KeyboardInterruptGystderr.write('\n[(fed]\n'.gexit(1&Ilisttoplevelofor filename in Mif 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%'syality over t . # (Probably)@stay` from  d (lock_held, acquire_Cleas  get_frozen_object, is_frozen_package, Cinit'2qbuiltin >6_fix_co_filename) try:_from _imp import create_dynamic except IRError8# Platform doesn't supB; loading.h W = None zlib._bootstra_ERR_MSG, _exec, _W3, _  m_L_externalSourcelessFileLoader,machinery` Rutil 4lib$os %sy tokenizeEtypewarnings . P("the` module is deprecated in favour of&ortlib; "|FP"see JmF's documentation for al-tive uses"RDxBionW, stacklevel=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_(L)V"""**1** PC# a6.3Thenot enterrto sys.fs1"""qreturn !.MBTypeget_magic( RL/q numberP.pyc s .MAGIC_NUMBER{7tagy e"""**DEPRECATED**Wextensions = [(s, 'rb', C_EXTENSION) s in machinery._SUFFIXES]iL', PY_SOURCEI FbytecodeHPY_COMPILEDKBYTECODEM;#+ $+ k class NullImporter: >*! i+ object.]z__init__(self,niR== ''W q('emptyCRname'NA='')n5elif os.b.isdir[ming directory_K)find_module@full"""Always.|_HackedGetData~Compatibility sup'`' arguos of various load_*(@funcs0 Z,&=super().; 5o.! =IDCdataAb"""Gross hackqcontort erqdeal w/'s bad API~6if 1and;2 ==wv0`# The o@ractL) requires us@s. Reopen[M#;binary m!if9ed.-"ot7z.closedV F!aif 'b'M!in.yJ-Bk+>!`0 = RAWAwithXGreadJelse1-a_LoadS5 J(p,.@File<?er)H~g!()name, pathname, -file=None): loader = _LoadSourceCompatibility(name, path B)<spec = util. `_from_ _location>p=G0if Z in sys.modulesPexec(j,*[>]LOelse:p:'# To allow reing to potentially work, use a non-hacked1Qwhichp# won'tIAy on.w-closed  object..0.__ver__ = machinery.@File+er?C 2__.JH:\rrreturn 6 class@iled!_HGetData, Fless1): ]9"""= support for implemQ!ng8P_compq().""" def o"""**DEPRECATED**I'j]UL2-A9wpackaged)`if os.p.isdir( 5Iextensions = (OURCE_SUFFIXES[:] +5 5yBYTECOD7r2&o )Pinit_% =AjoinQ, '__"U_' + DhCqexists(3U*5 = # Ubreak xAraise ValueError('{!r} is not a '.format),w Asubm#u_search3s=[@ M_83,9sdetails /# a, given in\ion returned by find_module(). The  name must include the full package#, if anyA1"""Ipsuffix,Me, type_ = details"!if and (not.startswith(('r', 'U')) or '+' in&!):Braise ValueError('invalid file ope3 {!r}'.format(mode))EBelif,qis None in {PY_SOURCE, PY_COMPILED}rmsg = 'o bject required for import (S code {})_2msg.0 ==return load_source(, NPcompiledRC_EXTENSIONPdynamic is mo (g'rb') as0ed_ 6: %A9JelseOKD KG_DIRECTORYWSU MC_BUILTINIinit_builtinI?PY_FROZE?Zfroze>  "Don't know how to+{}"vhI%Amsg,[=1`) dep, path=E"""**DEPRECATED**aSearcha>3ule!IfDpomittedhR8, s6RR-in, 'qspecialD2continueApin sys..^acannotC8ain '.';M 3subcDof a ssB%vWP's __#__!ifisinstan73strY3Typg "'f'!be a str,J%{}no,4(}), list)~# Backwards-atibilityeRuntimZ\a_", =" P2)))Xi>ZZif isk6,s@, ('5', "J2is_|OQ) elsGe: path = sys.  for entry in 4package_directory = o<a.join(8q, name)MmQ`suffixR['.py', machinery.BYTECODE_SUFFIXES[0]]uCyPfile_^ = '__init__' + `s4, M$, 4`K%if is$(_]).return NoneZmP('', PKG_DIRECTORYr0, mode, type_=Bget_;es({! =FUbreak;elsxcontinue#1P # B:p out ofer loop when &0ing 3inn .J iraise ImportError(_ERR_MSG.format(-)= Pencodg=[if 'b' notwith open, 'rb') as Q,L`tokenize.detect_J.readline)[0]L l$, <= ;,2, (H c) def reload(moduleg"""**DEPRECATED**-R+@ theule and u2it.&Tmust have been successfully ied before=1"""U%Jlib.rbuiltin~HLoad!a <4-in!byOA, or0 ish qdoesn'tBexis 2try_cqin_fromCHcept @Z if create_dynamic)\"th=@ extensiop" #Oer =%$.Ef@File{'er)KF# Issue #24748: Skipmps check_u_e_shim;# always #F new$OspecMkUSpec(/MR,Y0er=` erDQigin=:3%(o6)  """Get useful inS live Python objects. Thi s module encapsulates the interface provided bynal special attribu:(co_*, im tbetc.) in a friendlier fashion. It alsof2s some help for examining source code and class layout. Here are@!ofuseful functionsfi: isma(), isa bmethod MgeneratorLP.tracebackRframe  builtin(),Hroutine() - check object types)getmembers&Cget e of an2 hat satisfy a given condi# agetfil2getz gFfind]'0docgetcomment@docua|6 onK= - determine tcame from@2tre<rarrange=e as to represent\ir hierarchyargvaluesfallarginfo aboutqA arg"fu61pec@same, with supportPython 3 featurgformat -.0mat8l ouhQinnerz,?qcurrent,Tq stack 13^H02 or5sAsignH4a S#Jcble """ # Th0 is`&public domain. No w ties. __author__ = ('Ka-PzYee ' 'Yury Selivanov ') im5abc $st 4dis Rcolle.-Denum#Klib.machineryutertoolOlinecache"or%syutokeniz<wD: { s 2 op2 ??bgetter #namedtuple, OrderedDictPCreatpnstantsp compilk1lagInclude/l.h # We trym;1 diavoid duplic mod_dict = globals() @k, vfdis.COMPILER_FLAG_NAMES.items():'F["CO_" + v] = kDSee P.h TPJS_IS_ABSTRACT = 1 << 206-------------2- type-checking def ismodule(object): """Return true if the o#b is a 6!. /MC s provide4se attributes\`__cached__ pathname to byte compiled filed)T__doc4 documentation str) __<.d(missing for built-inQs)"""prisinstanc",E"s.cType) J_classI5HCAG #of in which this was defined omethod $n l @I!G X with.q'unAfunc[ containzVimple1LFself/tois boun1s.Mm descriptorApBut notC"ise() or isd -a() arewBT`is newPython 2.2, and,0exaR,of int.__add__.X#An:2 paptest hav__get__# bPa __sJ,!beyond thatv set ofFs varies. __VQ__ isJusually sensible often is %s >ved via usAalso@ oneAtheru#s false fromT0() 10, sxy becausX#mise more -- you can, e.g., count on hav"thG __ y(etc) when a es4().iQndr l # mutual exclusion0.F.Atp = G'0has$c(tp, "V ")  Y"<Gdata=>. Data descriptors have a __set__ or Bdelete__ attribute. Examples are properties (defined in Python) and getsets jmember,1C).KTypically, data will alsoQ__namnd __docsO(#, (, both of theses), but thiOis not guaranteed."""iif isclass(object)Cismethodfunction:BI# mutual exclusionreturn Falsutp = typeG+'0hasc(tp, "" u") if ypes, 'MD(bType')2# CPequivalent deAB"""Ratrue i Cb is a D !. b> specializedYextenaumodules`Nisinstancl,y"s. b) else# Other i0PmentaL"BjGetSet#BB+D B B\B"B",Tuser-EFv]sMvideU Edocuu string*0  with whichE S was B0codB containing compiledM@byte-Jdefaults__MPtupleany default values for arguments __globals__ namespace in which this function was definedL`annota!Pdict of parameter 6kwdefault5 6keyword onlyC`s with{11"""Ireturn isinstance(object, types.FType) def _has_code_flag(f, !):PB"""RStrue if ``f`` is a(S method orools.partialLwrapper 7ingB) whose  has the givenwQlag``J0set1its$s.while is#(ff = f.__!__G0_un_1(f)%if not is9 VpQFalse/Pbool(oQ__.co^1s &{isgenerator^3obj|Suser-~ KQion. Gdcs providehsame attributes a!s.ISee help( )OA lis@ gobj, CO_GENERATORcoroutine">CWPs areBO`"async" syntax` COROUTINEO?gen!!n >hronousA&  and have "yield" expressionsotheir body_ASYNC3gen o/l_isffc__iter~ to support !U over containerD clE @raisU new Exit excepC insH>[to terminat6=!giN>$f % or possibly None oncm&haE been exhausted gi_running #set to 1 when generator is executing, 0 otherwise 7t next return theitem fromcontainer@@send8qresumes.Pand "+s" a value that becomesOGSQlt ofU current yield-expressionCTthrow@p used raise an exception inside41"""K  isinstance(object, types.GeType) def iscoron.!):MC"""RYRrue iQ%a 9.Ck awaitabl}can be pas'Qan ``F6`` _ ( & o,7 PA and:4Cbool.gi_code.co_flags & CO_ITERABLE_COROUTINE)`collects.abc.AD)traceback9!. TI cs provttributes:tb_frame  @ at this levelc#tb_lasti PindexC attempted1tru in byteW HPinenoE4 ~line number8Python source B d einner   (called by)[ -5Fu f_/7ihouter ^! (1's %r)f_builtinsJ-in namespace see2H>:0 be> Acglobal~ }l % f_m Vf_loc =82fun57for9, or NoneV true if the object is a code . C s provide these attributes:+/co_argcountnumber of arguments (not including *, **sJ; or keyword only1P)71co_:0streof raw compiled byte, <uellvars?PtuplePnames cell variabley6nst;% =`constapused inC@filek 0of 9which this was createdfirstlinenoR WPython sourceZ G8lag" bitmap: 1=optimized | 2=newlocals | 4=*arg | 8=* Q | 16=nestI32=generator | 64=nofree | 128=coroutineS 256=iter_5 | 512=async_gK0co_k #0posspositional}*kw? @ MJ glnotabr encd mapp lEs toj indicO _with Zdefin8 Y31of Pkn@6stacksizevirtual machine ! space requir2varA atained by calloB; ifT@failr# !7UAdoes@liveAwher' mro (including Ameta%0es)n@ is looked upRj('sMZa (foun@walk74mro'If` items]Bv`stored< it will nowx!be0ove/ `have N0be  ed|KXPaed. Anywhose home@ cana wre skipped.2"""AwO1mros Atype@) # U/s  IWC?!clQhi$@in (n, object)) class_bases = (cls,) + mro all&cl+d+ meta&1nam?0dirB);# :dd any DynamicC@ Attributes to the list of E;;0this may result in duplicate entries if, for example, a virtualFamQ withnAsamek_ as a exists.FaAmro:@k, v!.__dict__.items()+/if isinstance(v, types. ;?.append(kbA= []processed = set() ?sQ# Getobject associated34 , and where it was defined&# Normal Ls will be looked upTboth getWdirectly inMAits s ' X (in case;fails [bug #1785]@also\vOa docstring)?For As onsecond pass we onlyT7thehsd"Getting an*Q fromd@p sometiSreveals more tha  usEH. StaticQhods are dram,j`homecl6Nonget_obj = i1 noll:try;D== '''+raise Exception("0 is special, don'nbproxy"3EE, -epw;>excgNelse'ry@, "_]S__", + Z$ifs5+A# ifi8>Q doesGAlive Mmro, dropRsearcfmro manually? ^^_last_x# first4/eswAsrchXPe1 ,.,#A1if 1D isq8</cl#pn check a  rch_cls in metamro: ?try4srch_obj = cls.__getattr__(cls, name)dexcept AttributeErrorv continueT"if`is getU last_cls`5if +is not None]BhomeX8Xfor base in all_ sJ!if@".__dict__&=T*[]t+4if Oin m ,] NUbreak\/is# unable to locate the 5 anywhere, most likely du2f# buggy custom  r__; discard and move on8 C9*4 if5 d else hP# Classify object or its descriptor.1if isinstance(P, (staticmethod, types.BuiltinMjType))kind = "=Ehod"m&i/elc D D3propertyroutine(objVT{Fdata(result.append(( , ,{ , processed.add1rreturn Z_ # -' helpers de0mro ""Rrtuple ofS:es (including cls)-olution order._mro__)Q funcd punwrap(, *, stop=X""Get0ped by *70*. qFollows*Pchain:C:`__56__`"s J &inLc**]Pan opal callback acNQE!r d!asisole argumen atSping to be termi(nated early if the callback returns a true value. If&[never,K/,,last object inchain is9 ed as usual. For example,J&:func:`signature` uses this to stop unwrapping if anypGs haE``__P __`` attribute defined. 5p:exc:`VaError`Qaisedi` cycleencounter;@ """C(is None:0 jQ _is_Ver(f) @ hasc(f, '_-Qd__')I?elsS8 and notV"(fc@f =  # rememberoriginalf% reporting# Memoise by idtolerate non-hashableQs, bur3 toK`ensure~y aren't destroyed, which would allow)Qir ID+pbe reus`memo = {id{1 f}d recursion_limit = sys.get(Zwhile7unc9@.k3id_#<4f (0in ) or (len(5>= {_r #('n loop when={!r}'.format(f)Ho[]r&_ # - source code extraction def indentsize(lineB"""Rv$ %,_spaces, at start of a C Ttext.1exp=.expandtabss+G) - .lstrip()) _findclass(3clsJamoduleR!2.__"__o0if . /Dzp@namejp.__qual__.split('.')[:-1]Z\Q= getUPcls, 3|"is3cls 7clssdoc(obj74if LL1bas0objFro__%2if $sC #'>tryQdoc =C.__doc__9except ANcontinueD0if jiA05docC4p-ismethodG =%!._3P__.__0selR if (isclass(self)g and getattr(self, name, None), '__func__') is obj.)):M# classmethog`cls = ]1Jelse?%1.__J!__/pelif istion(objz# = 6SQ_findQ;T0if !!isD or 2cls0not_ areturn:Qobuilti bif (is)r.__qual + '.' +$ =!;E# Should be teste fore isdatadescriptor().Binstance, property1Afget<0 = 0.__J'= ')< Af ^1obj/if)Ejkmember(@slot 21'__3__'?a4\*a, dict1in  n>q[$]] H%for base in.__mro__^6try gUdoc =F< g.__docmexcept AttributeErrorMcontinue^0if a0is U 11doc3(A de0doc3ect"""Get the\`umenta( 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,.%is<@doc,9 5cleandoc(doc) def cleandoc(doc): """C up indentation from docstrings. .Any whitespace that can be uniformly removedCthe second lineFonwards is,A."""2try10s = .expandtabs().split('\n')6except UnicodeErrorFreturn No~Felse# Find minimumof any non-blanks after first.margin = sys.maxsiz1for/1 inVs[1:]#content = len( .l2p()%3if , AD4) -.)Bmin( ,r1# R "if @s[0]0ine 2if t( <3 J8i5range(1,Bs)):|&[ii2i][U%:]itrailing 0ead Rwhilear and noKs[-1V.pop(7?0>0?B.joi1s) getfile(objectWork outch source`compil2an : was defined inif ismodud5if getattrP, '__A__',i.t.,raise Typ`('{!r}a built-in '.d#atyTclassClif hasN;__'Ds.gep2.__"&__!62#nmethod# =}Qunc__P@func <v<traceback=rtb_fram(y9 f_v6c1.conp y!, W", >$, %, !, ,]''`hexpected, got {}?5typ0.__6__)S(pathB"""Rthe module name( for a given file, or None.""" fname = os.path.base()#q# CheckMs that look like an actual modulek;suffixes = [(-len(3), ' in importlib.machinery.all_"Qes()]F.sort() # try longestpes first,Ycase they overlapG}dneglen,]:$"if=.endswith#'breturn+1[:nY def getsource(object)NB"""RI"th`can be used to locatB2's V.Gv if no way DidentifiJ0get ?8!il( =fbytecode/ = DEBUG_BYTECODE_SUFFIXES[:'K+LOPTIMIZEDPpif any(D)su>D = (;splitext[a)[0] +4WSOURC"0]/elgdEXTENSIONg%iffexists%5s# only aa non-B1enty~m4has a PEP 302 loaderMiattr(get.,Mb), '__6A__',) is not @r it1!inlinecache.#\0abs@_=Rbsolute s,compiled2an !. The ideaCeach"Ohave a unique origio this routinnormalizee result as muchvpossiblU5if $<)8getrp0abs-(aB)) 10sbyOa = {} `sbymod0,2 was defined UtUfoundRif isCu]Xaif has@__'): return sys.modules.get(object.____) # Try the filename to $Qcache+Eif _%is not None andn?0sby/:=l?retm.[c] again withrabsolut o6tryx = getabs  ,lexcept TypeErrorC`!if0/ i+aUpdate nd check yeth# CopyPorderIBcope9changes while iteratingE0for~, u" Ocopy().items()%aif ismt()shasattrA, '_7__'=!3f =s.#v2 ==`sbymod , X< # Have already mapped thiss, so skip itv>rcontinu [Y] = fB~ ## Always1 knows itself by@#Ef  .os.path.real 6(f)60.__~!__7x*8Cmn=@['__A__']#!if~YYY8T", >< ?>ain5W7if 7#is_&%)9"# builtins  s }# ;3if %= , class CaFoundEeEion( sEpass1_2 inder(ast.NodeVisitor): def __init__(`, qualS.stack = [A0% =;\vo_FunctionDefeOnodea.V0nd(!.n%''~&generic_L !GFpop(self.stack.pop() visit_AsyncFunctionDef =03defClassDef(self, node):TX.stack.append(!e.name)%1if (@qual == '.'.joinWBW[ # Return the decorator forc if presentn<!if.7V_list$line_number =3@[0].%)no`OelseN< =#rement by one since -s starts with indexing(:zer/I-= 1earaise FoundExcep(7generic_- !pW $findsource(object7"""rentire ) file and 2an N.The argu3may be a module, , method, f, traceback, frame,"tor codeb ^Ais rzed as a <q of all{sLieD1ne /!atQ. An OSErrorM!s dJ`cannotretrieved.""" R= get3[fv# Invalidate cacheuqneeded.3a.check (]  Lq# Allows@formZ@"" to pass through # `doctest` monkeypatches `vFeenableq# inspe, so let:@.getG s`<b(llV!t 0rtsQ('<')C.end3>')"('Pavail'V X,H#if ! =R,1.__dict__I D 3, `could 4getkYif is8Bs, 021g$__%__}3= 'tree = ast.parse(1!_> _CF$r(p.6try!`?.ss2e  er = e.args[G0] return lines,u_number&Uelse:;"raise OSError('could not find class definition') >if ismethod(object)W2 = .__func__:O<Hcode<traceback=tb_framey9 f_v76!if)shasattr , 'co_first7no'q t8FlnumX hA - 1)pat = re.compile(r'^(\s*def\s)| async\s+.*(? 0x:try! = s[8 except IndexB Qno is out of boundswif pat.match(3 $UbreakjR \1num7 ?3ode:def getcomments2b"""Get&& immediately preceding anYs source .R s None when$an't be f3.1""" 1E= f2(?a, TypeR:=ToduleN# 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(bf $ofssame indenta_ el (# =1Csize]=!ifG>= 0lN#\x<)= [lines[end ].expandtabs().lstrip()] if end > 0:#==- 1comment = lines[endr ;cwhile A [:1] == '#' and indentsize(Y)"Ms[:0] = [ ) "< 0: break&e sJSs[0].>'#',9* [] /-1^1-1:J _return ''.join() class EndOfBlock(Exception): pass#Fr"""Provide a tokeneater() method to detect theof a code blA."""def __init__(self)c.w00slambda = Falsestartedqcorator!#dehasargs&0laskbody_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*[0@v:8ns alwaysay q=Traisexock * # hitting a NEWLINE when in a decorator without args 9# ends the. !if self.inNrand not0has_:?h @u= False)$elfpasslineE -type == tokenize.INDENT7Ubody_col0 is None zstarted89= erowcol[1](Bnt =>+ 1*k = Tru .DEc q-q#end of match(;/dedent pairs a block# (note that this only works for "def"/"class"A+s,C*Be.g.2if: else:" Atry: finally:C)C^ <= 0raise EndOfB\ ZOCOMM04# >}$# Include comments if ed at least as muchil/3= s0 1= 0Ein (0,B:NL)# any other&1 onSCsameation levelF|previouhwell, excepVe pseudo-#s 9NL.   def get](Zs"""Extracd! @code{0top given listIA."""~<fAr = _F()generate_S(iter.__next__I@W*3 . eaR*6J^(@, InSError)uPreturXnes[:j{$] pasource's(objectNB"""RDaN- .vq number2an N!. 0Theu= may be a module, w, method, func , eback, frame1or b ^2is &s !correspond!toU.indicatesr:2@orig 0filnqe first2was found. An OS0Error is raised if the source code cannot be retrieved.""" 6object = unwrap()Rlines, lnum = findV%&if istraceback: b[.tb_frame "# for module or  that corresponds to$,turn allNqif (ismN1 or1(isaCand f_-.co_name == ""))0retu1, 0\Melse"getblock(+[G3:])P+ 1 def getVHB"""Rintext o<$anRThe argument maya> class, method, function, ,,"orC$ ^#is ed as a single string. AnI$OS$E==6jr''.join}o) # - / tree ex#-@walk(#(children, parent4cursive helperw1getDN)results = []% es.sort(key=attrgetter('__q__', '_B__')(Bc in"esdf.append((c, c.__bases__?)2if BC G.V[c], !cY> ]unique=FalseYqArrangegiven lis*9 into a hierarchyFanested+"s.5Where a  `ars, idntainsA derived fromqwhose entry immediately precedes/t. Each+>q2-tupleH!cotRing ax !a #@its bes. I%'0'Iis true, exactly on$q edRucturHe-z. Otherwise, ud multiinheritancetheir descendants will;e times"PQ = {}Groot2 6 '#if a`+/[_] P2:   children[parent].append(c) "if unique and 0 in classes: break7elif c not%eroots:U p8forZ8$ifX}Zreturn walktree($, , None) # - argument list extraction As = namedtuple('', 'args, var kw') def getB(co) P"""GeVPformae about thes accepted by a code object. .Three things are rPed: (q ), where=A' isu%of}s. Keyword-onlymElSed. ''\1kw'7As ofl*#"**B]!orA.""""if{s<yaise TypeError('{!r}T *"'.c@)6= co.co_varsn6 argcount)kw kw # K(T![:Q]2H%$*"+nf2step = 0srgs += %v! =<flags & CO_VARARGS~B8 []I(}! 1_varkwtzKEYWORDx:v ]6 + ?  ASpec " ks defaultspec(func>;a value a 4 'ssameters!A 6Dfour/is,!).aZ, including S{  O sbUan n-I?glast nU=EThis^deprecated, as it does0support annot\As or3parawill rXVY if eitheruSprese!onmlied callableFor a more structured introspeW API, use in`.signa* ()CteadOAlternatively, use gLetfullargspec() for an API with a similar namedtuple based interface, but full support K notations and keyword-onlyGparameters. Deprecated since Python 3.5, use `in;t.g!`.A1"""warnings. '("6Ois dp20, J"Nsignature() or  !",E BionW, stacklevel=2)4U, var kw, defaults, kwL qann = \Hr Bfunce'ifHEann:7raise ValueError("FuncI has GKB "=Thich can ZRthem"return ArgS.s) Full-' ='('''N |') def f"""Get the, vy s of a callable object'sqA!A 0seven things is -"edu(4)x.'g`a list-''varkw' are!of *#'**[CNoneL)s}En n-Hglast nUMDO7 <p1 di+ary mapping4X fromw%to%an>M `G to 81Not7differencesu1 -g"self"is alwayOported, hbound methodsA- wrapper chainsfined by __d__ *not* un automati-4try # Re: `skip__arg=False`6 # b There_N in behaviour betweenLS:1fformer$0s 'G'G.N80, w!asP_SBshowaactual7ingICs6. #  4# To simulate this behaviour, we "unbind" bound methods, to trick Jinspect.signature%always return their first parameter ("self",Lusually) Re: `follow_wrapper_chains=False`, getfullarg() historic` ignored _Rd__ attributes so1ensphat rem} case in 3.3+usig = _`_from_zable(funccHDQskip_B_arg6=tigcls=S)eexcept Eion as ex:# Most of'utimes ' ' will raise ValueError.?But, it can also-A1, and, maybe so7ingFelse. So0be y backwards compatiblecatch allB@poss! ions here{2 re\a Typ('unsupported 0') 2 ex@Q = []3varDNoneUkw = sposonly(9.kwqannotatA= {}Odefaults = ('kw"{}rif sig._Jq is notVempty%2s['9A'] =+Hf2for Tp-0s.v'6s()abkind =1. ~Ename _0if +_POSITIONAL_ONLYZ)W.u0nd(J$!#if3W.1,bs += (*,^/elR_KEYWORDo7VARW I <[  M yV.+sb!if# compatibility with 'func.__kwdefaults__'  = None tif not 2:3# compatibilc/a _return FullArgSpec(posonlyargs + U, var 5kw,,$kwD&, , annotations) ArgInfo = namedtuple('@', 'v~ keywords locals') def getargvalues(frame)'"""Get informu` aboutuments passed into a particular H.!A  of four things is ?Ped: ()!).('8`a listQ5thes,s' and 'varkw' are 2.s?*#%**HAs orCKy=@ dic4aryISgiven1"""# =to.f_code)1 ^"f_"( , base_module=i9ttr.#'_,A__', ) == 'typing'8repA).replace(2.'if isinstancev4typ{\'if. in ('builtins'? p.__qual!__p',__+'.'+A d \ relativeto(objectn/, _^NX-",  ^ 0rgs Y#kw 50=()6){}?={}2org=str!q=lambda-q: '*' + 9 ,kw784lue8`@: '=p-)wsAtext: ' -> C<=9A"""F5 an Q from'0 by@full3pecThe first se3arg q, kwonlydefaultsN, annotations). The other five arguments are the corresponding optional formatting functTQ that9called toKturn names and values into strings0las@ i/rJfkB to sequence of!. 3Deprecated si$Python 3.5: us`signature`%`SNobjects. 2"""dfrom warnq import2("`argspec`dh. Use ;"x " directly",,BionWstacklevel=2)3def_fargand8e(arg):Zresult =.! i8 in{?C+= ': ' +K(~us[arg])_!re[C[as = []if defaultsvSfirst` = lenAs) - sg`for i,Venumerate2Tx5cXi >= V/ZB(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'N0sV]75 L) Nsy, kw, localsSO=str# q=lambda@: '*; ,kw9:4lue:@: '=tQrepr()sP"""Fox0 an - 4`Lned by getar&gvalues. The first four arguments are (args, var kw, locals).>F?nexAthe corresponding optional formatt@funcsLAthat~ called to turn names and into stringsa ninthF i4wlW sequence ofA."""Mdef convert(= ,%NZEarg= , %):?!re4m8) +;(t[!]);specs = []for i in range(len)i2.append(B[i])U$if 7( \/kwZ kwX/kwV$kwT<'(' + ', '.join(@P')' _missing_#@s(f_N, Qs, po)7eCreprjm0arg As if@ notsz0 = /m7= 1! =N2s[0CWelif ,2,1"{}#B{}".'(*hFelse1tail = ", 6C[-2:e3delm|B", "ro0 + _$raise TypeError("%s()%i required %x%s: %s" %Cg .P"posi\0al"@pos  "keyword-only"?5dS == 1>ss", s))Rtoo_manyK@, kw]@defcount, givenbsatleastCD) - 4R_>(@[arg p##in.Pplura A!= 1oD0sig$2at s%d" % (,,aZLTrueRafrom % T^UD& 7str|_#ifT!ms @a@%s (8%d E )]? u(VQ% ("sXV"4X3 FbMraise TypeError("%s() takes %s positional argument%s but %d%"given" % (f_name, sig, "s" if plural else "", :, kwonly_* DB "wa9) == 1 and not5Rwere")) def getcallargs(func, /, *@, **1d):u"""Get the mapping ofs to values. 0A dict is returned, with keysGv:E ps (includb1theM!of8*%**8 s,=Qany),,respective boundN ffrom ''='lad'."""-@ =/"fu/1pec2) AU, var kw, defaults`ann = bK0 = !._!!__Aarg2b = {} cif ismethod=`self__BNone# implicit '(' (or 'cls' for clasY%s)g?31 = z0.__Hg__,) +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(got an unex{ edEwordI< %rO #2kw) " qQkw][k )rcontinuE inQ multiple( z8>h_too_manyhC ~5>,0#! p><%ePreq =Z4s[:x! -)oEg1arg&eqEiY{)_missing_sreq, True,9~ienumerate[aults:]):  if arg not in 2value: " 2arg[arg] = defaults[i]-missing = 0`for kw]in kwonlyargsZ#if } '>qC and:Z^[35?elsA+= 1/3if x__arguments(f_name,, False,)QWretur ClosureVars = Hdtuple('', 'nonlocals glob builtins unbound') def getcVvars(func)1"""Get the mappof free variables to!ir current 61s. @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 d0co_a @pby lookpthem up5#__J __@posial index<!if., isc_A= {}<  %$wvar : cell.P_cont %Avar,(@zip().,B }i1# Ge* Zs-W__ or __cs _nO2.__!0"_ns.get("N3", +@s.__"__codule(#3_ns(o$ =EdGw{ : +Bset(A K"("None", "Truk"# BecauseCpse used$bes instead;keywords,/yF# may still show!asYm. We ignorrmS@EinueY2tryJ["ns=except KeyJI try:  builtin_vars[name] = n 5except KeyError:)unbound_N`s.add( !) ) return ClosureVars(nonlocald, glob 3T ), qo) # - stack frame extraction Traceb = dtuple('', 'file lineno fun? code_context index') def getmQinfo( #, )2=1)VP"""Ge8Pforma about a0or robject.h!A  of five things is ed: the , number of~%qcurrent), a listmBs U fromIasourceQ, andu3 k0 wi@ tha|1st.I`The opal second argumspecifies[J#to, which are centereTHA.""">Uif is Bno =B.tb_<! Belse)8*fIif not is= raise Type`('{!r}5F"'.sQ- =&0 or$ifF > 0qstart =no - 1 -*1//2<6try5ps, lnum2ind9!OSD" =v = None9 smax(0, min(a, len()%))K=!s[8:+%]/ 0's( (3no, f_1.co,"s,4cL9, allowing for1mizO0# F}.w a descriptgrovels co_lnotab E! Y0InfQ', ('6V',) +5._fieldsQouter+s qrecordsuall higher (calling)sREach ?Mains\ , name, a list of lines context, and index within the .""" frameDA= []Rwhile:(info = (5,) + get c)<d.append(FueInfo(*>)0" =q.f_backMbreturnPP defQinnerKTs(tb,2=1)"""Get a 6%records for a tracef"'s]<all lower1s. REach @hbains a$ object, filename, number, functionI ="tb atb.tb_/? <Rtb = gAnextbcurrenE(R caller or None if this is not possibletTsys._0(1)8hasattr(sys, "q") else__cstack(8RU:b above|d 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 '_( _getmro(klasSs): 6try class_dict = _attr.__get__(entry)["_#E__"]Kexcept KeyErrorWFpass*:lseif not (type(P) is  s.GetSetDescriptorType andUB.__name__ == :2objJ_ qrreturn *2_sentinel def getO_static(obj, , default=1"""Retrieve*!ibutes without triggering dynamic lookup via theE d: protocol, V__ orfD__. ?Note: this function maybe able to r'llFDthat can fetch (likeally createdC)D1andz8fin  \$'tX,raise AttrQ). It1als<eobjectIinstead of ance members in some cases. See`ocumenon for details.1"""V`_resul! 9@_is_(R9k! =C4 = _shadowed(5oV if (.5is 5 orPT+M <dcheck_,eDb = obj5MLi4!isx V "3_r=A), '|1__') lMsM i2F58if ]: E.0obj:2#)NQs we cUQ metaA too7Vt2mroj_)",ifqo P2.>[{B(J !R$if=2lreturn default raise AttributeError(attr) # - generator introspection GEN_CREATED = ''tRUNNINGvSUSPEND: FCLOS' def getestate(!):"""Get current %V of a2-it!. 3Possible-Rs areL' : Waiting to*rt execu.H/2: CPly be7.ed by theRerpreter@ Bsuspended at a yield expression@04: E has completed+1"""iS.gi_running return8frame is Non= >=.f_lasti == -1pD1 $olocals%F*@mappo < variablesUtheir\cvaluesE`A dicted, withAkeys T names and L$5bou.Pif nod 3TypP"{!r}=a Python".formatL)=vD!a, "gi_!",)mq/E>elsC/{}#coroutinoHCORO!' w "(*s object?0AC `n awaiJ B3?.crZq9if 9?>D?E4 7@s,ine): ""&" Get the mapping of coroutine local variables to,ir current values. K A dict is returned, with4Q keys T names andL$N5bou2.""frame = getattr(a, "cr_", None)F1if 1not:"1.f_sMelse(o{} #;P Function Signature Object (PEP 362)(z9 _WrapperDescriptor = type(.__call__) _Method/%8all$_Class)`int.__ __['from_bytes']) _NonUsfinedCalll>= (, , 1 s.BuiltinType) def _s_get_user_de!_mAb(cls, _)c"""Private helper. Checks if ``cls`` ha' Qibute EGd ``T!``Ns it onlyJia9pdpython f~.k2tryj`w :except AttrVErrorD* ^0if isinstance(o/, 6# Once '__' will be added'C'-level: # s, this c{` won't@necessary7partial(wdd#, , extra_args=() acalculGow 'N%' plook like after apply1a 'Sools.3' oe@or a64Von it Yold_params = Lbameter86new(OrderedDict(A.items())6 $ =#.R or (&pkeyword.0or 'ifc3l$ +y +ba1bin*Z5, *"6f as exsmsg = 'MA{!r}`incorrarguments'.format(4hpraise Vl(msg) from ex # transform_to_kwonly = False for param_name, in old_s.items():156try  arg_value = ba.arguments[B[]>except KeyErrorJFpass*:lse"if .kind is _POSITIONAL_ONLY/# If positional-@eterDbound by[Utial,@# it effectively disappears from the signaturY74newLApop(})jcontinue  R_KEYWORD9n0par_keywords3# This means that t6, and all3 amAA# afft should be |(JFvar- JAremoved). Here's why. ConsiderfollowingM@funcwfoo(a, b, *args, c!#  O #" (foo, a='spam')" will have|V: "(*Ic)". Because attempt@to c with "(10, 20)" 0raiqQ Type, sayingS&"aH receivedKmultiple f/s.'>Tru@# See new defaulta_" =.replace(I=eQ# wasFwed as au .d.ihZ\C?'/if cassert&=not*b4 =H"=RO <\3.move_to_end(param_name) elif param.kind in (_KEYWORD_ONLY, _VAR)):>IAnew_As.move_to_end(qsaPOSITIONALc 2pop[. return wrapped_sig.replace,geters=values()) def 3nature_bound_method(sig"""Private helper to transform sig@s for unGfunctions2 ^!s. A""" 2s = tuple|..vbif notCs or 7[0]$, Jpraise VError('invalid"'))=r1if F%_OA8, _7NLY# Drop firs# '(p1, p2[, ...])' -><O A[1:]FelseSsP(R# Unless we add a newP typeQneverl6# get here{argumentT'# It's a var-posiZ&alTt Dohing. '(*args8 MEM8is_builtin(obj6est if `obj` icallable that might)support AClinic's __text_ protocolW8(is* o"isdescriptor'instance, _NonUserDefinedC,s)9# Can't tD'isiG4!)', as it would# also be Truebregular python classes61objc, 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 Q!s,g ndRFalse =^A, '_w__', None) co!de = getattr(obj, '__code__', None) defaults.2 _void) # Important to use A ...P$kw7R T... and notQ hereOannotationQ9return (isinstance(, types.CodeType)x1 1name, str&("is7or ;, tuple)B  D!o, dictEr / def _signature_get_bound_param(spec):""" Private helperget first 1Peter q from a:g__textf_ of a builtin method, which should9be in the following format: '($r 1,[")'^bAssumpare thatAargument won't havF value or an 2]A""" passert .startswith('($')" po!find(','O1if B= -1XTP/)Ic:J!O>c=Z=?%~[2:pos]3 strip_non_python_syntax(U@= D@func. Takes a 9AClinic'sDextended,.RM^o@threDingsy* q@re-rY0red}adard P , >2dexae "self" (generally 0),3 ifD Q does- aP,last "posiRwal only  haAD-Ds !ifA[$ <\U-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.OPERRORTOKENKEN # token stream always starts with ENCODING t), skip it t = next(_E)assert t.type ==?Dize.Q (for t in C:b@ype,Sing =O, t.stringD)4if j&OP@.:','"@kip_n_comma$(% = False$OelseBnot delayedp CG "n = Trul)current_parameter += 1Tcontinue6=%if`O= '/  c+ last_positional_only is Non TT.= -Dif (2ERRORTOKEN) and (0:$')Gselfq # @*if& 0if j(.OP;)')add(', 'E\ JFEclean_signature = ''.join(textU{return +*, K/, v def b_fromstr(cls, obj, s_bound_arg=U """Private helper to parse ent of '__g!_':5a Sbased on it.(1""" # Lazy import ast because it's relatively heavy8 u[C0othhan this func|rcP(f= cls.B_cls$"A = \1"$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(`\ = None module_dict = {} mname = getattr(obj, '___', None)3(if6:Kr = sys.:bs.get( _dH4LG2!._!__q4sys&vqcopy() *def parsef(node)nassert isinstance!, ast.arg0if ;.annotation is notQ,raise ValueError("A6Qs are8currently supported"pcreturnt&rg`wrap_v\'(s:try# = eval(s,.fexcept Nam C T X \-` ",SRunti(if{, (str, int, float, bytes, bool, type() NT!Co!t(Tclass RewriteSymbolics(MNodeTransformerv}visit_Attribute(self,)aa = []1n =* Xwhilenc XIa.append(n.j. m !n4iAa*id~ = ".".join(reversed(a)* <kzurode.ctxOLoad =^ p(_, defaultg=empty~1) =1ame5is invalid<".)ifJ and_ P&. =7!).((1o =literal_3n R@if o969 =@EIT elseKrparametersPe, kind=e&, ~# non-keyword-only%ameters args = reversed(f.args) default%)piter = tools.zip_longest(U,L, fillvalue=NoneAf last_positional_only is not ):kind = Parameter.POSITIONAL_ONLY)Oelse3R_KEYWORD9for i, (name) in enumerate(3Plist(6)))np=Xif i ==?* Z0# *d 3if fvarargV RFVAR_:>zpA, empty) !# keyword-arguments bW\ XW%zis kwW,5kw_l b`# **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)us (3QTZand (=:or f.pop(0] ^, # builtins,  D!F6p =5s[0].replace(=FBRreturn cls(", p_annota}T=cls. def _signature_from_(cls, func,IS=TrueN"""Private helper2i0 to ^Da callables2"""!if%is|raise TypeError("{!r}[a Python r"8 "X".format()%, "__text(_"sV)no:g  str(cls, func, s, %skip_bound_arg) def _signature_from_function(cls, *, :=True): """Private helper: constructs S[ for the given python]kQ.""" Ouis_duck = Falsef not is8( i%isGLlike-1on Belse# If it'sa pure PS, and B typBB# of; fraise TypeError('{!r} iu p'.format)Js = getattr, "__text_", None)Fif slreturn9str }Parameter = cls._pB_cls&# &"inAion.q_code =&!._!__pos_count0.co&arg_name P&1var&posonlyP6argW@posiUal = d%[:]Xkeyword_] kw \5 ^]g8 + /|`annota7.__Gwdefault$!$kwi6.__"__4if '?s = len(ss `40d@"[]Cnon_PdD0 - @_lef@5X#-]- 5w/o0or Q0 int-[:]  kind = _POSITIONAL_ONLY ifCt" &R_KEYWORDN4P.get(, _emptyu3.append(2U= ,tE=)q  ED-= 1o... w/ouoffset,wenumerate([':]-,  default=s[offset])) 3if 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= ,txPkind=_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_arg2rigcls):p"""Privfhelperuto get  arbitrary objects2"""]!if& )raise TypeError('{!r}^ $a 6\'.formatEif isinstancitypes.Method[p# In this case we =f first1 ofunderlying#  (usually `self` or `cls`).0sigC V obj.__func__, follow_wrapper_chains= 9skip_bound_arg= +qigcls=s%) :if 7:return _signatureomethod(sig)0Oelse>2sigq# Was this Rtion d by a decorator?V?if fobj = unF(obj, stop=(lambda f: hasattr(f, "_F_"))if isinstanceIqtypes.MVType)v# If the}ped object is a *"*, we might want toB#~ its first parameter (self)./See test9ped for detailsCfrom_callable(pV R q / 6tryPsig =~.except AttributeError;Bpass(  ig{not Non0if 3dsig, S& ,raise Typh%'unexpectN{!r} in ! '3''.format- KrpartialU yV&2 V,Yools. JA# Un)O(seeC0# Tmeans, thatneed to calculate B0as 1 t'tregularect, but taking inPaccouG0osial argument|(usually ` `, or `cls`) will0be +ed<automatiQy (as'Ps-[bt4 . \Cm Cget_(,+0, (,ENdGam = tuple(wrapped_sig.parameters.values())[0] if first_wrap95.kind is PC.VAR_POSITIONAL:EP0# FH argument of the X callableV`*args`, as inK`partialmethod(lambda 6=)`.1return sigNelseAsig_s = tuple(- Nassert (notnH-or*.] AM[0])B4new`?= (HG,) + A.replace(=_!) ;if isfunction(obj) or Inature_is_Alike#_ # If it's a pure Python 3,Nan object that duck type2#:a?: (CPs, for instance),nnEfrom@cls,,| skip_bound_arg=Huis_builtiS-?sig $is5,@ools1v)( = M(A@obj. Wcfollowgr_chains= 9 +5=<R 0get\(sig = Non 8+#Kqa classQ metae]*@, le/@see ^`t has "verloaded __c__ definedh# in its`[2 Suser_F_WD), 'j'7!if j#"0 =/!)# Now we checkS'obj'8I _'&hon?new1objKE0if H?is $sig = _signature_from_callable( Onew,follow_wrapper_chains=Askip_bound_arg=3qigcls=s)Yelse:(# Finally, we should have at least __init__ implementedH# = _signature_get_user_defined_method(obj, 'U'1if Nis not Non):sigs8^?E 7f0if /is# At this pointknow, that `obj` is a class, with no -b~## new__', orE`-level&I__' H for base in obj.__mro__[:-1]PSinceNGtextB _'vY as akscriptorextracts Q: O theC docstring, if 'objrderived@a builtinF, its ownmay be '/'.EThereforego through MRO (excepoe lastD in4I@hichNect') to find"O firG2{n-emptyU>try! =4.__-__AttributeError^Npass@!ifP%4# IRh $ aM return a(nd on i7)Bstr(,f,)O# NoPwas f_ 3the 0# L @optis>Pcheck(* i#Dect.GEtype k1ype A[C# We (3Ametae), but &#or __new__ fokr it  if (obj.__init__ is object=and8G8;new7/):4 # Return a signature of 'u' builtin.>r<sigcls.from_callableMect)8Oelseraise ValueError(<7'nofound for type {!r}'.format1)) Qelif not isinstanc, _NonUserDefinedCs;C# Anq with _!__Z # We also check that theR'{4an |7 of=`_Wrappscriptor or _Method to avoiP# inf1e recursion (and even potential segfaulE = __get_user_d!_m}(UH4, ''1if L!is];Non>try:sig~ E[g,follow_wD_chains=A`skip_bPZ_arg=3=gexceptn as ex ms  :Pmsg) K2 ex if2 # For classes 7Ps we first parameter&Utheir#A, __v,Is1 q r^GF(sigoV>5sig 2s.BFunctionTypeRa nicer e messageu Q# fp  'yPsupported by   _T"""A private marker - used in P4& S6d.""" KCemptB"""MBV57*uW. QKind(enum.IntEnumPOSITIONAL_ONLY = 0IR_KEYWORD = 1FVAR_"A = 2'J3,B = 4def __str__(selfelf._name_ @property def description(self): return _PARAM_NAME_MAPPING[*] _POSITIONAL_ONLY6= _ParameterKind.) :R_KEYWORD : )W _VAR~u @ ) k y)php)! <A = {cdp: 'posial-only',) / or keyword5 : 'variadic f,J O'L+' } class J"""Represents a p in a func signature. Has the following public attributes:** name : str;2The!ofGwaqstring./* ault : objectF1def@valurPif specified. IpBxehas nolOf, this is set toA`Pt.empty``annota<,? fo,L)KkindDvbes how argument s are bound tomPossible4': ( m`G6%U(`,HLG;>2"""__slots__ = ('_P', '_* t "')?w //5 _+= {. c,ZRZ __init__, , >D, *,c!=_6&, B2try.x}(b).except VZErrorIWraise1(f' {G0!r}Pnot a&id9.!'iiiD"t p3elfIin (AL, _VAR_KEYWORD): !msg = '{} parameters cannot have default values'Amsg.format(self._kind.description)9praise VWError(msg&F}=F a`6 =  'if name is _empty '. a required attribute for P'*')got isinstance(H[, strtp must be a( , sTa {}'J2typI@).__2&__!GTypeB [0] == '.' and[1:].isdigit(0# These are implicit arguments generated by comprehensions. In # order to providfriendlier interface"users, we recastNq# theirT as "!N"Ptreat$m@posial-only.K Sesue 196112if [ != _POSITIONAL_OR_KEYJ G(l'I@passe.s \< or keywordI8.{}> ,L>[5 49NLYsZ.isidentifier NP'{!r}WVvalidJi^)u! =*def __reduce__=return (B)),&4.,h*3{'_#':*V6 '_/}tsetstat7ate.~1 = .[]*i-"']>@property?a}FZ!=@ $CF 'I,C !=qreplace2A, *,c=_void, + )7"G"""Creates a customized copy of the Parameter.""" if name is _void:!= self._ 9Okind99 9annotation?!E KdefaultHEBreturn type( )( , #, /=&, = )Odef __str__KKN dformatted eW# AddvD ande valueK#ifnot _emptyz'{}: {}'.(Eted,^32z&._)%DW ,K/ _T_'{} =S repr)))Jelse5_=8]^!ifa == _VAR_POSITIONALp U*' + L,elNKEYWORDK LMf02'<{} "{}">FO.__class__._1__,ZOhashZ(XFJ.#eqb, other)dX*TrlXisinstance(9,e_ENotImplemented'Sv.2_ .&an\*.14`7A)  BoundArgusF`"""Resof `Signature.bind` call. HoldspmappingaI!to @func7D's p"s."HaD`followFpublic attributes:*%* ]q : dictd'An ordered mutable t'6Fs toL'%s.NPDoes *xcontain,y44* s"5 : .P6The object that created this ins tance. * args : tupleT of positional)uments valuesA#kwCEdictB@DictAkeyword>A""" 3__slots__ = ('argk', '_signature_weakref__')<def __init__(self, 3,y!):j%.e& =% #{& =Tv@property3uoqreturn vSGN BQ = []mfor param_name, - if.%eters.items(I"if<P.kindA(_VAR_KEYWORD, [_ONLY<@Rbreak6tryl0argE6elfz[-except KeyErrorN # We're done here. OtherP# will be mappet'BoundAo.'f8 Nelse M1== LPOSITIONAL2P0# * v.extend(arg)%;u# plain ;%``&{so6 U = {}T_started = Falsw9Jnot o} ?in A df = Tru" S}*continue!ifv Ks=PEpassALH{IB# ** `p.update}! jsapply_defaultsq"""Set lt values for missing arguments. For variable-positional, (*args) the default is anDempty tupleZykeywordW?*kwZUdict.n5"""  = self.#Enew_U = []for name, param inE_signature.eters.items():?B:try s.append((j[9]))Oexcept KeyError["if.Qnot _0Zval =7 u$%elZ@kind_VAR_POSITIONAL\ (Q KEYWORDN /{}/se3# This BoundA was likely produced byW5# Sbind_partial()s(continueM 7val 0 = (@)def __eq__(5w, other!if %return Tr0if 1isinstance(9,CdJNotImpleF%ed.=2 ==&an6X6+ setstateO0&[''.j-(']g~w{g:.y6, 'Y}iCrepre0arg, valueUH'{}={!r}'.format(O'<{} ({})>/B__class__.____, ', '.joinRas)) %qF"""A object  eszoverall ^of a funcIt stores a PQBeach  acoeR, as well"inion specific to51 it 2has1Pollowpublic attributnd methods:I*s : OrderedDictABAn o mapping of parameters' names to the corresponding !Parameter objects (keyword-only arguments are inKsame orderHas listed$`code.co_var1`).** return_annotation :z!GThe 1foru: type ofAfuncDif specifiedjII&lhas no\3its\e, thisattribute is setN`Signature.empty`s* bind(*args, **kw ) -> BoundAK] Creates a mapping from posisal and %toCps_partial#=6to (simulat'Sools.c' behavior.)AA""" __slots__ = ('_7@', '3s')7{u_cls = Vb_% +A = _ ^def __init__(self,=None, *,N=E,Y__validate__=True):0"""Constru/Qgiven mP'Mg. Allb"opYF 'if#O,redDict(Jelse1i` (>] #top_kindPOSITIONAL_ONLY_((_defaultRFalse~ As1T" =+. v&&& v'0if C4 < u,0msg<o b'wrongG: {}`before'M  (msg.format(q.descriBD (;zraise ValueError(msg.$el>N ! = [in (_, _POSITIONAL_OR_KEYWORD):  if param.default is _empty4Kif kind_7s. 2S# No / for this}eter, but theE# previou>0 of<Q sameO hadJa,msg = 'non-argument followsLO ' \P4 'D'1raise ValueError(msg)6Oelse p# There.c  = True 2@if n"in2kduplicate1%C: {!r}'.format(V6 s[P2] =u )T7 = OrderedDict((.L,J)\ &s)0aself._$ = types.MappingProxyType_s:return_annotation = o@classmetho(def from_func<`(cls, ?"""Constructs Signaturethe given python<J.s0PDepred since P+3.5, use `T.callable()`6"""Swarnings. ("inspect.H ()d"" W/",CBionW, stacklevel=24 _sW_builtin(BzY3sobj, *,i_wrapped=n onstructs Signature for the given callable object.""" return _si<d_from_3(obj, sigcls=cls,9@follow_wrapper_chains=1d) O@propertydef parameters(self):l&._'I/_annotationP .Wqreplace?G, *,=_void, >"""Creates a customized copy ofS.fPass '' and/or 's' arguments?to overrideb@m inA newzi7iA is 1 = .values(/.if%Z a_`B typ&)( 8&= _hash_basios = tuple~y%.kind != _KEYWORD_ONLY>2kwo{vb.name:1g =}6s, ,6 o;no_zLL G5) = frozenset(4c P( !L)2eq_w, other!if  kXU Trueif not isinstance(9%, E_ENotImple(%edOvB) ==.Abind,Dargs*tial=False"""Private method. Don't use directlyG = {` 0q = iter.v_ex = (parg_valDMFQwhile q# Let'sqthroughm@posi al! correspondingg# 7tryy arg_val = next(arg_vals) except StopIteration:"-# No more posi$al arguments/>tryDHTparam Keter)*]P. That's it. Just need to check thatMwe have no `kwargs` after this while loop@]breakOelse1if  .kind == _VAR_POSITIONAL6POK, jpempty *P. LePstartcMsingH"# !;%elsname inL1__ONLY;rmsg = '{arg!r} am8 isonly, ' \M'but was passed as a keyword'@ msg.formae= kmraise TypeError(msg) from Nonex_s_ex = (,l @ KEYWORD or .defaultQnot _)#fine too - $a Nvalue fo#. So, lets ,  with the currenSw5@{" , nDe,#?%in*Otial5N@'mis a requir#: @s3# Wawlproces try:  param = next( zeters) ' except StopIteration:&6raise TypeError('too many posi8 al arguments') from NoneOOelsee1if .kind in (_VAR_KEYWORD, o_ONLY)D# Looks like we have no]  for this J## )P;H &1== %POSITIONAL W an '*args'-%, let's fill it withW# allB(suleft and move on toO1the^ phas9tvalues = [arg_val]T+.extend(/ W"s[name] = tuple(NG:obreak R kwkF!= _vmultiple  {arg!r}'.format(Barg=)<j Y5`# Now,Aie through remainings to process{# keywordz_* =0in tools.chainJG_ex, # Memoriz atRa '**') %continuem?GName[ don't refer [-s.0# Wly arrive here ifYo endedHbefore reach-Flast #_" =K. >try$2 = B.popAN D1Key]N("no for this para meter. It's fine though, # if it has a default value, oris an '*args'-likeFAparav, left alone by the processing of positionalHarguments.if (not partial and am.kind != _VAR_POSITIONAL" F . is _empty):Nraise TypeError('mia required : {arg!r}'. \N format(arg=_name)) from None GNelse(if*7== &^_ONLY3# This should never happen in caseaperly builtG # Signature object (but le0havis check hereG`to ensG@corrHbehaviour just) 67 is only, 'M'was passSkeyword&. vS&s[0] =kF_val1Pif kw _@^S )m2# P h2'**R= '1l 6  3@'gotunexpected ~WXIMqnext(iter(F))))Xreturn self._bound_P_cls(,{s;def bind1/, Z$, Ug"""Get a B_AB, that mapsgw``'`A` to*@funcD's s@. R5s `F!if9@can 71be 5""" +, $!61%ly+30 +@2P *1,kW=True8__reduce__(selfC): return (type(self),#b (tupl._parameters.values()),52{'_\_annotation': c.1}) wdef __setstate__!, F" =*[|]bCrepr^W '<{} {}>'.format.__class__.__name__, tWsult = []Xrender_pos_only_seYtor = False*.kw)6Tru(@for DAm in. 1ted9!r(1 0kin. G0if  == _POSITIONAL_ONLYl- -_elif 2]# It's not a posir0al-_ , 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; hIqKEYWORDFLW 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(?)r#j_emptyI2 = ; V J 7rendered += ' -> {}'.format(anno) .return rendered def signature(obj, *, follow_wrapped=True):F"""Get a5 object for the passed callable.""":|Smd.from_'{ x )f_main(a Logicinspecting angiven at command line import argparse2libA 5r =,.ArgumentP:1r()='c.add_a ('-%', help="Theto be analysed. ?>p"It supsr 'module:qualname' syntax"-d', '--details', action='store_true'Display info about` rathe an its source code'sargs = ,.#s( btargetl"s.53@mod_, has_attrs, 2 = 6`.parti3(":2tryCcobj = %= . _(kFexcept Eion as excVmsg = "Failed toX {} ({}: {})"[type(exc)._ /__H#CUx print(msg, file=sys.stderr$cexit(2&if .split(".H@:0 in&tsQ40getV..Gsbuiltin0Zp"Can't r8'?s."1.Up!'T)m+iOrigin+2getSNule):iCached:$c'__6 if3 isiLoaderTCreprA.__l!Y@*, '__path__'(p2Sub/ search 2 .LJelse j1__,no = find\c  \OILine3no)D*2\n' PHgetsource(obj)) if __name__ == "__main__": !() """The io module provides the Python interfaco stream handling. The builtin open functi9s defined in thisgQ. Atcatop of I/O hierarchy iabstract base class IOBase. It _+VbasicS to a. Note, however, tha reino separa between reading and writ ts; implement7s are allowed|raise an OSError iy do not support a give;. Exten}3Raw which deals say withE of raw bytFileIO subZ6es f$to ' aOS 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,@Eext Hc4 (` `). Finally, StringIO is=2for` ArguF FDpartAifici,Aonlya?s!() ndo be used as keyword 7. data: DEFAULT_BUFFER_SIZE -A containsdefaultC sizebmP#'s! edKj., ()eS0!lkM`(as obsed by os.stat) ifKpossible.p # New _plibraryAformo PEP 3116. __author ("Guido van Rossum , "r8"Mike Verdone s are inhe!d Hthe C # version however. class b(_io._ a, meta=abc.ABCMeta):Q__doc 3. U2RawLX,oL' OeT Y , ^gV (Rregister(^0) 3ktEin (m2 RB>pX0.~ cL HAdel SR trys0_ioort _WindowsConsog ! I:pass elseJ L<) # Copyright 2007 Google Inc. # Licensed to PSF under a Contributor Agree. """A fast, lU we IPv4/IPv6 manipul libraryPython. Td3s u~ie/poke/EeZ^addresses networksC __V'1.0'D functools IPV4LENGTH = 3264128AnQValue(  "A rel00to YT.""" WqNetmask65WnCWsdef ip_l(address):  """Take an IP string/int and returnobject of the corrtype. Args: address: AS or integer,C3IP %. Either IPv4 orF 6(es may be supplied;Ss less than 2**32 willHbnsidered toFnby defaultRA2v4AEIPv6<Gaise;ValueError: i:** passed isn't e!a W a v64i1"""6tryp(5)-except (, Netmask)Wvnn<rI ('%r does not appear6-1' %  def ip_network,sct=True %h%($jNJ$$! D. Ori has host bits seG  OLvKW(OWTrfaceCLoL(qkAInte@OQ*isn't either a v4 or56 address. aNotes: "The IPv?Interface classes describe an AC on a particularF$Network, so they're basically a combination of both(XHCand L1"""&6try`return4()/except (ValueError,hFmask)YBpass/p6pEfraise ('%r does not appear to "IPdIPv6 i1' %  def v4_int_to_packed; """Represent>b as 4 2 bytes in n (big-endian) order7ArgwLA: AnTger rm(aC IP 1MRPH+RZA: Ifiis negativewtoo large  A.to_(4, 'big'Overflow G"1forG3") 6%$16zL6./16/16O6_split_opf`al_netQHelpeE2- <0 if needede = stre.S3('/aif len\) > 2 f ("Only one '/' permittedGT%r" % `_find_ess_rangee"""Find a sequence0sorideduplica CIPv#{es: a listI5t object}WYield]A tuple containing@firssgd lastl4thee. """ it = iter(addresses) @firs!lasnext(itor ip in it:.2if ip._ip != 7 6+ 1#'ayield _,'ApK? def _count_righthand_zero_bits(number, )@"""C0R the @ of 4'1 onO Pq side. BArgsH?: an integer.&s: maximumiA to VgReturnYTT1"""$if}F== 0rt(@min(B, (~3 & H-1)).bit_length()) summarize_Kq_range(~S- a network /R give}9A and'C IP Y#esvExample>>> list(RIPv4A('192.0.2.0'),0...Cb130'));F #doctest: +NORMALIZE_WHITESPACE[qN$/25'), h128/31(30/32')]: C<0 or6iA 1|@  Aoderatord]U(4|6)Ndobject*GRais(TypeError;'IfyJ are not8@same version1OValuF1 isgreater Rn<RO46^=((isinstancS_Base)u1xlast, _0)+r #('ymust be|,>"s'}"if\. s0"%s oZ" % ( ! > 0('ll b"') F== 4c@ip =4? elif first.version == 6: ip = IPv6NetworkFelse#raise ValueError('unknown IP V1') :ip_bits = first._max_prefixlen#F_int%!ipClast #._RwhileQ0<= nx min(_count_righthand_zero(~#, !),}(c' -{+ 1).bit_length() - 1)A ne?ip(h1 - )/yield netA += 1 <<4 'if0- 1ip._ALL_ONESbreak def _collapse_addressesAeernal()A"""Loops through the %#, Ling concurrentrblocks. Example:2ip1o4o('192.0.2.0/26'?ip2*,64+3+<128,4,"92,m3 @[ip1D23e4]) ->>o [IPvF4')]This shouldn't be called directly; it is7viaeC([])BArgs~: A list ofP's or "'sgReturnJ?p depend(on what we werecpassed1"""0# F?R merg+1to_ ! =1Qsubnex!{}46V.pop(uRsuper"Dnet."Pexist#= sT.get(*K5if ,gis NonR?[;0] =A (elC!"0# MsecutiveF(4deln " ap # Then iterate over resul n8s, skippsubsumedvlO! = 0for in sorted( .vj3s()!if1notE PSinceSy areT,7.! W  ^rcontinu 0y#es+C"""C a list of IP objects. Example: !collapse_addresses([IPv4Network('192.0.2.0/25'),9= 91128;_]) ->? xB4')]FArgs: An iterator of 0 or68 obgReturnT IDthe #dH_(4|6)LGaiseK TypeError: If passed a listmixed version1"""*as = []'ip 3net# split IP 6b and ns&for ip in%P if isinstance(ip, _BaseA))-!psbips[-1]._U!= ip 8<r*$ T 2("%IQre no!|Dsame$Q" % (D)))/ips.append(ip!el._prefixlen =6max 3m :tryC .except Attribut U' EqRisz9fGG| HIa# sortQdeduped(set(ips))# find consecutivep rangesorted sequencecsummarize themlGf ipfirst, lastN_r_f ?Ps.ext)i 7ZrL$ _02es_internal(\! +) def get_ _type_key(objo2""" a key suitable Ying betweenVPk? # avQ^by default;bAy'ree fundamentally different so'@ expE2ion|NP') <=Qj#4'%doesn't maky sense. Theresome times however, where you may* wish to have ipaddress sort these for you anyway. If@need9do this,Mqcan use function asO key= argument?iaed(). =QArgs: obj: either a Network or Aqobject./eReturn<appropriatet^1"""- if isinstance(obj, _Based)1 rWr._get_nqs_key()M/elOOoNqNotImple'ed class _IPU:4"""The mo*).__slots__ = ()1@Aerty"def exploded(self2"""Ylonghand vers!of3IP a string^_#._n`_shortQB_ip_5@comp U("tr / ree_pointe-5Sname #2S DNS 6YFthe ?f, e.g.I:6>>>C.ip_k("127.0.0.1").`>"'1'`27.in-?i.arpa'%g2001:db8::iP8.b.dS2.ip6 E 92ion\msg = '%200s has no2specified' % (type>,Zaise Error(msghZ_check_int,2m$ifF < 0o"%d (< 0) it permittedytn IPv%dF>r>UValuePess, #._5)>%ALL_ONES>= 2**%dOmax_prefixlen,> <opacked,9ected_lenNs = len(P&)!=LSr (len %d != W" raise AddressValueError(msg % (address, _len, expected9 self._version)) J@classmethoddef _ip_int_from_prefix(cls, Qlen):-"""Turn the  length into a bitwise netmaskx:FArgsH`@: An@^eger,[.EkReturnH=*5"""r6 cls._ALL_ONES ^ #>>s00<J", -Y+j -.^+i in expandedbformatr?| Kaise<A: IfQinputrmingles zeroes & onestrailing_+= _count_righthandb_bits( 3max Rlen =- (; - @lead# = ? >>1Call_-V(1 <<{U) - 1Y9if \4!= ; L_bytesE// 8TudetailsA.to_C({y 'big')7B= 'N pattern %r mix';r> 0gd2lenreport_invalid_  G_str%r is not a <4' % : !) ONone 5 bstring0lenw2"""" Ca numeric K? aS: The5 to be convertedEy m. @ 51#b Tows a% +/- as wellpsurroun whitespace: # so we ensure that isn'tEcase}!if0(H.isascii() and.isdigit() cls._report_invalid_netmask(prefixlen_str) Etry: (o = int8except ValueErrorF?clsif not (0 <= 1<= MEmax_)n.freturnh @classmethodCdef w_from_ip@ing(cls, @"""TY#a yA/hosp stringU3o azr length~JArgsc^: TheTto be convertedHR K An~eger, the.=Kaise<NH1 IfFinput is!a w N5""" q# ParseF /like an IP address.9 sip_int ,v(FAZdzQR1# Try match (this would /1*0*/ as a bitwise regexp)P# Not!attwo ambiguous cases (all-ones and zeroes) areptreatedrfK r:uqIUI=intIBFpassY1# IQbits,t8u/0+1+/ 9vinstead# ^ALL_ONES ;O`split_ZK:essLHelper function to p3. of Network/Interface:ArgN8: ArgumentB I(G,@v) tuple `a packl4 orPif isAance]ess, (bytef7nt)+ $vZb [# Assume a)lPany object representat# whichs`format#IPI"I@B = _9 opd%aladdress)  # Constructing from a tuple (addr, [mask]) /aif leness) > 1:!preturn >5ess  [0], cls._max_prefixlen /def __reduce__(self)dI.__class__, (str+c,) __fmt_re = None @functools.total_ordering J _BaseAddress(_IP "):"""A generic IP object.@ThisN#contains the version independent methods which areused by singleO1es.!2"""o__slots__ = ()??int< (ip0#eq/w, otherr6tryor._ip ==5 &Band 3cexcept AttributeErrorNotImplementedlif not isinstance(,u p+if! aise TypP('%s "!re!of45sam9_' % (^cP6ip +ipC/ <RFalsen# Shorthfor Integer itpsubtrac!. " is# meant to ever supportB/>0 of ?add?int"zA(int 2) +2 ?subo-Creprq'%s(%r)r p.__namerq tW2@._stt_qD_ip_Dy)OOhashE(hex@A5get 2key#._,F0elfVforma(fmA"""R b as a ;Bted ;o\S1ed presentai` typesS's': returns the IP address as a string (default) 'b': converts to binary and return?zero-paddedKAX' or 'xH`upper-lower-case hexZ1n':@same'b' for IPv4G%'x%6 8Fortpresentation types,ZalternateXm specifierL1'#'jTPgroupF!opH'_' are supported.76"""2# S";leatting1if not fmt2fmt[-1] == 's':&D(str(self),<)uFrom here on down,=u 'bnXx'[global _6u_fmt_re,if is None im  : V = re.compile('(#?)(_?)([xbnX])'K= 'n0if `._versJ== 4:B # B$istEipv4|9;elsOx' # HexLN bpadlen =max_prefixlen7 V // 4%if !D3+= 8I - 1<=2 0by&0x;:0E(inti%'{T2}0{|!}{ Ting}{f} @functools.total_orde class _BaseNetwork(_IPA)"""A genericn- object.@ThisUcontainsc independent methods whichused by bsdef __repr__[/'%s(%r)' % "1.____.__name__,)MX/stW 6/%dVY,~yXRhostsn@"""GPIterator over usable 6T in a gkis like __iter__ except it doesn't@eCroadcast'esdt)=4 = .) broadcast = int(self.br_address)  for x in range(network + 1, 7%):07ayield ZQ_class(x) *def __iter__BcM*sgetitem7, nH/if n >= 06n > (raise IndexError('r out of'x5_eturnF + n4Jelse{an += 1Q&if?3 < M ;,=M%ltWothergot isinstance(", _BaseN0:NotImplementedo#ifTversion != T#._ CTypep%s and Qre nothe same DU' % (tx ,{)  [.)" / >5s) >4 0 R0 b Type4iare different)5"""P# doeis need to ba Valu^?0#._O# !: LA('%sy`re not@the } type' % (q+ g# QbelowA_A .9,& -!OON   Hmask return -1# if self.netmask > other:)0return 1!0 def _get_networks_key(_)HB"""N-only key function.HkRks an object that identifies this address' sA andD0. T+e 7 suitable "key" argument for sorted()Iand list.'()5"""& ._version,__u)?qsubnetsD , prefixlen_diff=1, new_Z=NoneXCThe A which join to make the curr'"In as)!at contains eone IP.len == 32BPIPv4 J[ "5128BmIPv6), yielditerator with just ourEFArgsS+: An integer,aamount +u lengthE should be increased byB0not!kset if@glso set.&$ : pdesiredwmIbe aF larger number (smallerC)0existing  0T  ~of IPv(4|6)s[RaiseValueError!Atoo e   E OR I are bothX E 2thanbl Cumeans a` PF_max Z' zj ifEd N '<' -Xr S('new[ vlonger'r:#if'O!= 1b0canB  q ,=- : ::< 02  7> 0c + +% = > self._max_prefixlen: raise ValueError()': length diff %d is invalid for netblock %s' % GK6new, self)) rstart = int(.network_address)*8end(broadcast*E + 1.step = (Xhostmask)'R) >> @len_:wW in range(p, end, \)S`curren__class__(( , t)&cyield Fdef superne,(=1TW=Nonee"""TheB containing theko.tJArgs)@: AnQeger,Laamount +8%ofVZ # should be decreased by. For example, given aH4/24k and a of 3, aOwithG1Greturned R fAn IPvhobject6a 5oA: If..\len -< 0. I.e., you havea negative<v.(I OR#If1C are both set & larger number thank* (']meansPsmallL'5"""i>WZ == 0g'if@not 8 < '>E.n - QD'new@mustshorter'iO!= 1c0canH  q ,=' -$;6L  ;<- Lsis %d, U%d' %i XF. Rb9' &#ne~#<<~)),O . 7@property'is_multicast(self):  ("""Test if the address is reserved for multicast use. ;Returns:A boolean, True\aQs.CSee RFC 2373 2.7wdetails5"""7r (self.network_]6is_5and66Pbroad8)@staticmethoHdef _is_subnet_of(a, b)6try n# Always fals!0oneuav4 andQother6if a._version != b fjraise TypeError(f"{a}d{b} are not oSsame Y)")$^b[] <= ac-b.d >A except Attribut Unable to t containment : f"between 0"R;!, 2"""3is "a D~>.].]p3per")F , y$@propertyG4is_T -YwEIETFfpwithin xr IPv6 NNo range%S9.3W link_localYA-AY/Y1perG4291W D 698 qprivate(is al&t@$= iana-ipv4-special-registry or 6 y return (self.network_address.is_private and 4broadcast6!) 4@propertydef is_globalx!):^"""Test if this  llocated for public "s.jCvReturnsTA boolean, True`e_not reserved per?iana-ipv4-special-registry or 65"""Sr sDh1!un|Ofied6 5# is{Gthe J7as defined in1RFC 2373 2.5.2{| s: loopback P$a 4WT  Y3}YV7) class _BaseV4:0""" IPv4 objectThe following methods are used by4s in both single IP[  es &__slots__ = ()version = 4# Equivalent to 255.32 bits of 1's.7_ALL_ONES[2**IPV4LENGTH) - 1_max_prefixles&Eq# Thereonly a handfullvalid v4 masks, so we cache them allJwhen construc(see _make_netA3())_JB= {}_explode_short_ip_string2strF@W cls, arghMake a (", <_len) tuple from` givenCDumen\n1Argv can be- an integer (_r length BB- a @ rep nt 3 (e.g. "24">?s0J if&tin cls..isinstance(arg,m%len = arg  if not (0 <= prefixlen cls._max_9): < )report_invalid_netmask(< ;NelseM>trye# Check for a \3 inp lengthmg<1 = S_from_string(arg)Dexcept NValueErroraor hosdotted-quad.u# This may raise8/ip[= IPv4Address(3hip_int3 30K_cache[arg] =,5lenbreturn< (@classmethodXdef _Rcls, @"""Tdthe given IP 2 into an@eger comparison.JArgsh3: AL , a#IP<R ?0TheF7 as; :3 ifv isn't a  0V1"""H  |?o#('@ canFbe empty')0octets =.split('.'4 if(*o) != 4"Expected 4 >[S%r" %o ^rAint. bytes(mapaparse_W,^w), 'big?exc&%sE(exc ) R NoneK `Converrdecimal [ number to EL+r7b:bEtctly a A[0..255]^Jz0("E<Ppermi"# Whitelist characters, sincev() allows a lot of bizarre stuff.isasciiC"ndwdigit()msg = "Only decimal digits permitted in %r" raise ValueError(msg % octet_str).# We do the length check second, sinceinvalid character e\Kis likely to be more informative forKEuser8 ifz(U > 3:= "At most 3 8PHandlading zeros as strict glibc's inet_pton(I0See6urity bug bpo-36384&if != '0' andQ[0] =)Leore not 7pConvertinteger (we knoww ar"6galint = intF, 10'*Z> 255  "OQ %d (/)"6intgcreturnRAint }@classmethod@def ing_from_ip_Rcls, )"""Turns a 32-bit qinto do1decnotation.|FArgsOdD: AnL , IP address?R BFThe .a ng&""56'.'.join(map(str .to_bytes(4, 'big')))Ireverse_po8jr(self?-S DNS 1F namOIPv4This implementsL describ RFC1035 3.5C 0s =7.split('.')[::-1]- "_D) + '.in-b.arpa'@propertyI-max_prefixlenvf@)._*O/ioI $1  aAe(_BaseV4, "):o"""Representmanipulate gl3v4 70es.g__slots__ = ('_ip', '__weakref__'@q_init__,~WLu`ess: A$orV$ rbL@Addiually, a@ canPpasse o5I'192.0.2.1')3221225985).C2or,(Pgener ! IPv4Address(int(IPv4Address('192.0.2.1'))) == . *uRaises:A`ValueError: If ipax isn't a valid d .Y5"""U# Efficient constructor from integer..if isinstance(Z,()self._check_int_+3)R-Dip = freturn4# C2inga packedA_bytesN ?, 4@int.5_[z, 'big'6Assume input argumto be str or any object representation/p# whichPvertso a formatteQ`_str =if '/' in]* r ("UnexpecwAQ%r" %G6essb 6P|) @property3def(A"""The binary7 of this.1 v42to_`O._ip0is_Arved- Pest ixew is otherwise IETF A! R  A boolean, True[within the+qd&Network rangewb!._5Uants."_nM@functools.lru_cache( is_private< =`allocagCfor @ sCB*9perD iana-ipv4-special-registryuB1anyF0net UTsxVaglobalvuO notTublicA and+4.multicast~r@8 us$OSee RFC 3171hdetail? turn self in# self._constants._multicast_network @propertydef is_unspecified(I!):0 """Test if the address is 5.\0vReturnsAA boolean, TrueMiFUJaas defined inMRFC 5735 3w5"""%r1 == o_loopback$a 4  mT@per G3330Y.inlink_localreserved for A-A$L 7927Y1ink class IPv4Interface(A"):*8__init__,;\t, mask Qsplitu_prefix(%Bess)Xo.d).! =N(W|), strict=False?NV k4len/@functools.cached_v@hostc>5.,]|3str{='%s/%d' % ^ ._ng_from_ip_intEip),} b#eqw, otherc_equalA=.__9$ifF; is NotImplemented or not' lA b?try.4>except AttributeErrorPd# An i; with an associaf OTU`}# same as7'un9. That's why>[ hashCQtakesextra infoo account.13 dll | 8n:  N Mtry:   return (self.network < other0or ,  4+==5and address_less)Dexcept AttributeError:g# We *do* allowI0es W interfaces to be sorted. TheGunassociate is considered P thanl \.K)aFalse def __hash__@).(a._ip, 2_prefixlen,n{s_:2)))m__reduce__ = _IPAZVBase.,@property!ipfCIPv4K"rFFwith0R'%s/%s' %T_string_from_ip_int:j, , qnetmaskZMl ?hosWm) class N (_%AV4, "):,P"""Th7representhmanipulates 32-bitY & +"..Ps: [examples for:}('192.0.2.0/27')] :77'N. , 0.(31+broadcast` 4(326 ,E255.(241B: 271"""1# Cjto use when creatingN objects1_=[Cinit,I , }wct=True"""Instanta a newXFArgs1: AfPng orUeger Ithe IP [&_][& A/24'ct0(0 $1arefunctionally qsame in. Similarly1Z/*,329so equivalent atto say, failfo8provide a sub will create an object with a mask of /32. bIf the#(portion afterA/ in argument) is given inLdotted quad form, it/@treaas a net ifcstarts O non-zero field (e.g. /255.0 == /8) and Z7hos[ M i W 0.XZ, ] VQstric:BTrue8A;notf`suppli5"""$,`= self._split__prefix( Fess)W*n!+Qess =,^51,i^Dlen {Smake_=(+Apacked = *N+3if .&.Q3 != 2if d 4rD ('%s has ^ bits set' %<NelseR ?N#~1= (C_maxJ- 1)& __iter__/elb^ lambda: [# T]@property{@functools.lru_cache(def is_globalx"""Test i(isKQallocfor publicssklReturnd boolean, `e_not reserved pe iana-ipv4-special-registryyr (V.network_address in IPv4Network('100.64.0.0/10') and self.broadcast_addrOPAnot Pis_private) class _Constants:_linklocal_n+ =S69.25C6') 8oopback7 27E.0/84Qmultil!22hE.0/45opublicg e5Qs = [0,"1#G G'P72.16_/12')& 92#_.0/29%o170/31' 2L4% 0168u?/16'38.1&5& 051. ?0/2u203.0.113 $24KF55.2)/3\]7reserved8  j4unspecifiedBA#(' }4._c+ =rBaseV6:n0"""6 object.The following methods are used by4both single IP{ es sb2"""k__slots__ = ()9_version = 6ALL_ONES$2**IPV6LENGTH) - 1$HEXTET_COUNT = 8`_DIGIT<frozenset('0123456789ABCDEFabcdef'max_prefixleqq# There only a bunch of valid v6 masks, so we cache them allq# when ructed (see _make8AA()).._JB= {}@*;defDcls, arg)"""Make a (netj", _len) tuple from` givenCDumen)H1Argv can bea- an integer (the_r lengthlBp- a strl0rep8 nt 3 (e.g. "24">?'.0J if zin cls..1isi pce(arg,m%aV1arg if not (0 <= prefixlen cls._max_O): )report_invalid_netmask(< ;NelseM-1 = US_from_string(arg)Rq = IPv6Address(Fhip_intF F0K_cache[arg] = ,$breturn'< (@classmethodXdef _pcls, ipo@"""Td!an! into anReger.lJArgsaTB: A jX, theN>R AAh7aeu\Raise6%ValueError: ifqsn't a 41"""2cif not? r} ?o#('@ can<be empty')sparts =X.split(':#3# A| needs at least 2 colons (3 P%).Q_min_E = 3qif len(F) < ' msg = "Ak"%db expected in %r" % (DGpB'7msgA# If 0hasiIPv4-style suffix, convert it to hexadecimal`if '.'J[-1]:try@ipv44..pop())._ipnexcept~ as exce0"%sU5excN ) Y None{.append('%x'(>> 16) & 0xFFFF)x=<5s caMhave more than 894# The extra&b comesQusing@"::"vation for a l#d1or trail Azerou PnmHEXTET_COUNT + 1 &> ; rmost %ds permit%-1sv DisregarJ endpoints, find '::' with<hin betweenikpdicatesprun of C0es ~been skipped@_index =irange(1,l- 1):  if not parts[i]: if skip_index is/NNone+:# Can't have more than one '::'_4msg = "At most, permitted in %r" % ip_strF raise AddressValueError(msg)1E= i # 0_hithe number of to copy from above/bef M/loMbelow/after z 0# If we found at,Npn check`it als@vers endpoints.  ="lo = len(17) -/I - 13 r0rEv+-=;i?_hiNLeading ':' onlyN!asd^ jU) # ^: requires ^: /-1?lo *loY_TrailX&:$9::$Ag ped = cls._HEXTET_COUNT - /+Js_loI>< 1PExpec.aI%d other]Q with (3-1,);els0# Owise, allocate entire a[7hi. TheR# could still be empty, but _parse_hextet() w# M fof*at(if!actly %dpey?out|:z  k],/- 00ddressValueError(msg % ip_str) # :$ requires ::$ parts_hi = len()"olo = 0qskippedEtry: n# Now, parse the hextets into a 128-bitYeger.=aip_intbLfor i in rangeJ_hi)z.Ai<<= 16[|= cls.__U:[i] P *3ts_  ` -`o_lo, 0P`return 5intexcept ValueE2z as exc8raise Address,0("% %r" % (exc,`k) from None m@classmethodJdef `Ccls, """Convert an IPv6(p string+o2int3cFArgsIb3: AA,number to2se.4R= IT5 an ~R9 7@A: ifyinput isn't`ctly a N [0..FFFF]5"""&# Whitelistecharacters, since() allows a lot of bizarre stuff}bif notHEX_DIGITS.issuperset(Y ?a("Onlydigits permittedONAe dolength check secondTinvalid eKis likely`be morformative KEuser8!ifJ > 4bu= "At most 4Y )J%)0tet{8# Lmeans we can } vsnR, 16)@comp's(s+e_#ofsCR 's, replaclongest continuousPseque`of "0"Kwith "" and addNQemptyoVngs a5`beginn'Bor aA0end  such that sub5tly@callC":".join"s) will producUed version ofIsa<  hextets: A list of strings, the hextets to compress. Returns: J15""", best_doublecolon_start = -1$ulen = 0!@  ;for index, in enumerate()$if-j== '0' s6+= !8if (Q01# Sof a sequenceezeros.,a . )-> ?lenqThis is2~longest so farn) =%=len ;N = ?Nelse5lm$X^/if=J > 1q }end = (f+b =Ilen):a# For :1 aty!of 2adda4o== len,AF += [''][:_end] Hbeginning$|Z == 0# + sr @classmethodRdef _f_from_ip_int(cls, W=None{@"""Tj a 128-bit intege toqadecimal notationw;ArggD: AnI5IP +85hex re("en WKaiseValueError: The]0big@thanP bits]all onesg#ifTDW   =V._ip)>> cls._ALL_ONESFr h('IPv6too large'^0hex  = '%032x' %%%%! ntq9[x:x+4], 16) xrange(0, 32, 4)]Mcls._compress_hextets(he3) return ':'.join!"def _explode_shorthand_ip_string(self):,Q"""Expand a /ened IPv6 address. -FArgs;?XB: A __, the?R B :e5"""if isinstance,zwNetwork =-".n(_b/el[Interface](ipP/se7)e`ip_int@elf.int_fromu`0hex = '%032x' % F,parts = [,[x:x+4] for x in range(0, 32, 4)]: c(_Basehu P%s/%d(0), ._prefixlen<1+reverse_poi2"""t-S DNS 1Q nameThis implementsLmethod describedCRFC3596 2.54P_chard[::-1].replace&N, '' . M) + '.ip6.arpa'#r@static5split_scope_id(N """Helper function to pars a with O7 idSee RFC 4007dodetailQM(,_id) tuple,&ep1 ==@str.oi7('%if not sep4b_id = NoneqO2sp or '%'44 Jrraise AValueError('Invali`: "%r"Zy?}property-6max IJ_*O?ionI $ classbAV6, k"):opresent manipulate singl70es.__slots__ = ('_ip', '  _weakref__' __init__, mI tiQa new,w objectPaddress: A s tring or integer representthe IP Additionally, an<can be passed, so9 IPv6Address('2001:db8::') ==+( -42540766411282592856903984951653826560)Dor, more gener !cHint( ) /1yRaises:xValueError: If a isn't a valid.W5"""S # Efficient constructor from..if isinstance(u,()self._check_int_+3 l-Dip =q:scope_id = None"freturn4# Ca packedc_bytesN O, 16@int._\ , 'big'6Assume input argum toUsany objectaRp# whichPvertso a formatteX Q`_str =if '/' in* 1r ("UnexpecwAQ%r" %G6essb-, 1Tplit_T)8(  7Pdef _G0__(42 iptuper().( *|+ '%' +,ifCelse5Nhashd(L._ip%)I#eqGw, otherfess_equal5/Ki1is NotImple+ed #N4notR@FFals". == getattr(5, '!',d@property"DTP"""Idfier of urticular zoneG1's LSee RFC 4007s details#R& xiy kw S`pecifijOUd$ Acope_id  @property def packed(self):!"""The binary representation of this address."""9return v6_int_to_`a._ip) +is_multicastPest iyex@ is rved for @R use.iRsA boolean, True\aQ?See RFC 2373 2.7wdetailsn@ in ._constants._network/.otherwise IETF=+$within onee(r IPv6 No range( 1any,x_x 7b6sg link_local\ hA-A:/A perMG4291W==Osite*A Note that the #space has been dYcated byU3879.>Use is_privaZ5o t "ins`of unique OPes as&inyG4193x $ 035175.6]E @functools.lru_cache()C R alw\+0S iana-ipv6-special-registryC -1net/hT0 Oglob, : oublic 9 t5not7= registry.  B"""  return not self.is_private $@propertydef is_unspecified(6!):T """Test if the address is 5.\0RsAA boolean, TrueMiFUJaas defined inMRFC 2373 2.5.2{._ip == 0loopback$a 4 RT 3} 1pv4_mappRIPv4 )I>DIPv63C-a J,9thev None otherwise 1if >> 32) != 0xFFFFEWAN&FJ)`ateredo5 `uple of embedded +G IPs ZT<H(server, client)A@ or toRdoesn't ar to be a('start withF2001::/32Z #969O0000(QI64) ,<~  5*sixtofouru !F6to4E0he  >->{present .contain a`  $11:O2002:@+80 class 6Interface6A"):f__init__T,_, mask =p_split__prefix( 3ess)o.d)tE`networbN(W|), strict=False?N@.netkf._prefixlen+ = self.network._prefixlen @functools.cached_propertydef hostmask(I!):;jreturn_,]>__str__='%s/%d' % (super().1%),jn )p#eqow, otheraddress_equal = IPv6A=.__9:if ; is NotImplemented or not',0 Ib?try.2 ==>except AttributeErrorP# An interface with an associafeOT the`# same as7'un9. That's why>[ hashCQtakesextra infoo account.13XFalse/ltMless 8n:  N_3K* <5 orAn E andr)DWe *do* allowIed+s to be sorted   is considered 0 thq'll\I(\B_ip,,n_#))?__reduce__ = _IPVBase.@'!ipfe"C._iprF0R6s6cing_from_ip_int:jG/ne ;l' m&Mmis_unspecified0_ip0 Djs_loopbacn self._ip == 1 and self.network.is_loopback class IPv6N (_BaseV6, ): """This 7representsgmanipulates 128-bitZ {"s.E Attributes: [examples for.('2001:db8::1000/124')]_address:6A =&')8hostmask18::f&broadcast` :/ne__ffff:0prefixlen: 12442""" 1# Cto use when creating  objects_=/Sdef __init__(,,I, strict=True):P"""Instantiate a newX 03FArgsA1: Afng or integer [2the^I)5theNA IP>/.%]_/128'_0000:; :Vare all functionally qsame in. That is to say,Afailo providy3subR will Ce an[ withI a @ of HDAddi,Jcan be passed, soXFh[') ==+s42540766411282592856903984951653826560or, more generT eHint( ) /6  ct boolean. If true, ensure twe have beenD A6.Neg, knot anH 1 on+, IZ[RaiseWValueError: isn't a valid wN FJH;fora"] VP was &B;nothsuppliedw,;=SR_spli)_w(%Fess)$Q  51,i^Dlen {Smake_?(+A packed = int(self.network_address) if packed & .mask) !=:18if strictraise ValueError('%s has host bits set' % <NelseR( = IPv6A( R %) G>_prefixlen == RG_maxJ- 1)1s =.__iter__`/elb; a\lambda: [")]1defs"""Generate Itor over usable6c in a B.SYThis is like  except it doesn't return the Subnet-Router anycast 7essg5"""6) =QbroadT. Pfor xdrange(kU+ 1, 7- +Syield_class(xK@propertyis_site_localpTest if2hreserved A-A-Note that;#FQspace been deprecated by RFC 3879.Use is_priv%Eto t%isV `of unique O es as definyG4193R4sA boolean, True# 2per513 2.5.6]T h.E and W 9A)  _Constants:MQ_link)_vN('fe80::/10'S`_multi3 f03820[n::1/128'),  ffff:0:0/96E1/64!2001::/23" _2::/4Fdb8::/32J 10!fc7F:_/02, IPv6Network('400::/6'), IPv6Network('8 Y5'), !10494!3:6s:A: C! EF!F!!FE 9 !] _sitelocal_nL* =0fecp10') ]Address._constants = _Cv """Keywords (from "Grammar/python.gram") This file 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_g2or @3 -m pegen.kQgen \igTokensCLib/L .py Alternatively, you can 'make r-3 '. __all__ = ["is", "issoft`kwlist2] Ar'False'E'Non 5Tru __&parser__.5and s Fsert5ync 5waiTbreakEclasBfcontin}4def(4del 5elieUexcepf0fin55for 4rom UglobaZXFimpo$in0idlambda1nonyp6rai}Ureturd4tryGEwhilDwithyield' ]  = frozenset(0)._tains__ = /X 3"""Cache linesa1m P| #s.i`tendedHread:modules qed -- hence if aUname is not found, it will look downL search path forF by that OTu` funct 4sys o t:ize0getn clyTheckcBlazy ] # The R. Map=s$Peithethunk whichtprovideicode, # tuple (size, mtime,i`, full^0) oZloaded. = {} def 1():%`0entirely."""$.<(`Jne(filename, lineno, module_globals=None): """Get a+ for a Python source file from the cache.;fUpdate if it doesn't contain an entry]BthisRalready.""" Oqs = get (yLname)/qif 1 <=!no 1en(:areturn% s[qno - 1]C'' defz9Xs<e!ifU.2 in=[W qif len('f) != 1< (?2[2]6try0,u2 except MemoryErrorMRclearE#[]Rcheck% rDiscardies that are out of  (Tqis not _ed upon each call!) | s \Qlist(r.keys())elB C~Felsel{9 s/ =g# lazyUy, leaveMAinue0siz tiCa, full=y-@if m*, ibK\ # no-ops loaded via a __5r__[ Nstat = os. (!+OS7pop>&9ont 0if }uA.st_#or4!=  Pv 5aR and gP its ; If something's wrong, prinemessage, d?3,f=Amptyk,2 X2#.8V!ifG5or rtswith('<')*C.end>>')a[% =  basename = filename %# Realise a lazy loader based lookup if there is one=ow?dtry to2right now.-!ifadcache(, module_globals):0:tryqdata = I[Ii][0]()=except (ImportError, OS hWJpass@>lse~1if ois Non!L# No luck,9t PEP302[cannot findVsourcU@# for this(O#return [] %M = ($(@len(/),[line + '\n'!in%`.splitOs()]AAfull  8[2] Troking throughfh search path, whichly useful# when handlMa relativeG`if os.Ve.isabs i[0dirb in syH z ;% =}Sjoin(N,X KAType , Attribut { t sufficiently string-likedo anyth+JV with#GzcontinuBstat ( SUbreak L e- tokenize.openj as fpn{Pp.reaK#es ~8ines and 9R[-1].ends(~"1 +=size, mti SB.st_. f2 = *"!, c$, 3_ deb"""See{MK+.3The`will be askedGBthe fR only"ge" iqcalled,cimmediatelygIPan en!in[ alPy, itSsalteredC: `: TrueTr2Qregis1Y7omFalse. To 5P suchSoad a loader withC a get_source method must be found, the filenamea cachableI$_, and6!noVqalready@1ed.?1"""&ifj"in#:pif len(y$e[nv]) == 1&*return TruOelse&BFals'0if [T or ( .startswith('<')3endF>'))gc# Try for a __loader__, if availRif module_globalsq'4K' in#x=.get('__E__')Y 0[n].1= getattr(C6, '', None) :`E ( lines = functools.partial( , < 1 = 1O,+""""Locale supportIc. The  provides low-level access to`C lib' L2APIadds high 6`numbermatting +s well as a lPalias"`enginejcomplement these *Pinclumany commonly usedi]P mapsmmvalues suitA pas 2set"()ion. It also default encodingsT4all| 0. .1 im4sys B . e*$re#_collections_abc from builtins e tr_D_strA" 38_3. # # If this fails, fback on a basic 'C'Pemula.cYuck: LC_MESSAGES is non-standard: can't t=whether it exists before # try. So __all__Wfiddled at` end o$. 0T= ["g0", preferreduError",*E "A!)reR@conv0str LxfrmK trCatofifformat 0ingcurrencyIn2@lize$LC_CTYPE TOLLAT4TIM MONETARYLLC_NUMERICA0ALL CHAR_MAX"] def C(a,b[C""" (string,) -> intWCompares two strings according to the locale. """return (a > b) - < b) def _strxfrm(s):/E""" tring) ->2ingZ^RV3s a that behaves for cmp_-awars try: {bfrom _ import * except ISError01# L emulationHCHAR_MAX = 127[LC_ALL = 6COLLATE = 30TYP0MESSAGES = 5ONETARY = 4pNUMERICp0TIMK2 = Value Sconv(_Fdict&numeric and monetary|specific parametersE$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,s,}:Activates/queries>yprocess1k"if not in (, faraise 6$(' only sup.Ss "C"%')'C' # These may orAexisa, so be sure]0setasm. if ' 'tglobals% =^6Ocoll66 3 # = With this , you can override some items of=3's .is is useful@test[purposes. _Z {} @functools.wraps(#)i'd?if h d.update(_override_localeconv) return d ### Number formatting APIs # Author: Martin von Loewis # improved by Georg Brandl # Iterate over grouping intervals def _$_i(!):Elastq = None5forND in 87E# 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 ']/I"D?eif not_' 0if s[-1] == ' '+stripped = s.r8p_spaces"Q[len(%Rped):)K7els H!''$]O[^ c_!5ingss|+in "0123456789"3# only non-digit characters remain (sign, Z: sUbreak%s.append(s[-&:]fF5s[:  I=sreverse$)+ R.joinfBs) +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%]') vd3at(0, v ,H, monetary=Fal se, *additional): if formatted = percent % ((value,) +6)IOelse@ >.# floats and decimal ints need special ac!3$if[-1] in 'eEfFgG'wseps = 01@part.split('.'%if groupingK>S[0], Y_((monetary= V_point = localeconv()[/Y'mon_/'Jor 'A]B$ =jR.join!if C_strip_p65ng($I/el?diu  b3 = O2ureturn rS def e, val,K@=FaltwA"""Fc@s a R ngthe same way that %jting would use,but takes*@currlQo account. 0G is appliedgthird parameter"Qtrue.8Conversion|$s thousands8aarator*As ifIWforthfI1is o1""")wclist(__re.finditer(f)rPnew_f%sub('%s', f)if isinstance, _collegs_abc.Map {\yval = [Vts5.  ()G=='%]a.append('% [ 6_(t ,6 Ymif not"Wtuple|B (i?for6lAstar+'modifiers'). ;('*u- bval[i]* F?ing0Wry,   *val[i+1:i+1+starcount])) 7i += (1 + '%val = tuple(new_val) ?preturn  f % val def format(percent, ue, grouping=False, monetary*additional):a"""Deprecated, use\_string instead."""1import warnings . (-"This method will be removed in a future version of Python. mFUse 'locale.6()',wBionW,qcklevel=2)`match = _JA_re.[qif not  or len( .rQ())!=G]raise ValueError(("p() must given exactly one %%charK F specifier, %svalid") % reprrQ_ A;(, 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'#."'%%.%if' %P, abs)2-R# '<'>' are markers ifEsigninserted between@v#V+ s + '>'#if/3?smb #_20ede~Qval<0d'n_cs_ HpFPsepar* Gsep_by_spaceH ]4if s6+ (n T ')AL0JelseB>if psmb[-1]:' '1Gs = &6:-1! = "mb0_pohn&p_s[qegative0<6osiYE2ign6= 00'(':v!)'@+el212 s = sign + s elif sign_pos == 2:qs = s + -3-.replace('<',8)949>9&se+# the default if nothing specified;o,is should be;most fitt5ign position8A+ s return 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." rconv =  "()#First, get rid ofGgroupingt[5['thousands_sep']Rif ts4lAts, k%s#next, vs decimal point with a dotdRdd = (_(/ddrdd, '.'Catofq, func= "t[(Catoiz_nnv/eg?int~c_test(y2set3(LC_ALL, "">I#do %Rs1 = _("%d", 123456789,1; prs1, "is", "1)#standardMaB3.14,J0f(sJb ### Lname alias(engine # Author: Marc-Andre Lemburg, mal@l .com # Various tweaks by Fredrik Lundh jstore awaylow-level versionvk (it's # overridden below) _%=_LP_encot(code,  if@ in 3Alang)g@de[:p.index(3(el 4## }<a C lib compatibleA% =$ s.a(`#')8: %r' % 90  k.4es.Iget(..lower(),\ Ipdorm_encoding) encoding = norm_  "r.lower(G*if? in localeRq_alias:Y z*[~]8FelseB ! replace('_', ''y7-7 nQ/ =#print('foundU%r' %return langname + '.' +& def _append_modifier(code, )T%if == 'euro'!if\0notB ISO8859-15'$U_, _,0 = ..partition('.&if*Win ('R, 'UTF-8']uHG<_:. }@yTylbalize(1): Q""" R1s a?*d( for the giveS>N.MQThe rQeE isH`matted use withJ2set'()QIaq fails,original 5 iszTunchangedR0is VRknown^Afuncrdefaults toYB!)=just like GCdoes1"""`# NormeMaaxtract< +>':'C!# s sometimesFd asdelimiter.mt.0(':K@q3split('@', 1 uB = '`.`do.')[:2;t}P# Firookup: fullt (possiblyDnH[8-6} 9 2 7 !+=x+#{l_= lookup_name 2+= '@' + modifier code = locale_alias.get(lookup_name, None) /"if2ais not:Hareturn!#print('first R failed') #%ifH# Second try: full without1 (possibly encodingxang_enc0 ! qsucceed0!if|3i!$>_append_(,8 .split('@', 1)[1].lower() ==:raRs lUc# ThirAlang(#1*, szJ28&W3e !4 1preplaced?3! = %P0{e ! +CG# FourthE and %bI(O = _i W5!<u, defmod 2#if/H3 C=8 def _parse_( "):;P""" P'Ss theC forSi+cresult as tuple (AuageF,W.rTk[rmalizedipassed throughwk engine. A ValueErrori0rai@-7ase@ qE0canT1be +danguage code corresponds to RFC 1766. code and encoding can be None in case the values cannot"determined or areCpunknownsthis implementation. )1"""= normalize(localename)!aif '@'Aode:# Deal with 4 modifiers%^,! =.split('@', 1eQ'if)= 'euro'%@'.'  7# Assume Latin-9 for @=As. Ts bogus,?since some systems may use others[FtheslCs. Also, we ignorA.{areturn, 'iso-8859-15'z.z8`tuple(bQr.')[:2]SAelif\v == 'C'@c,i 0WUTF-84# On macOS "LC_CTYPE=%`" is a#idrX sett#:g 7 handlingFtext '/'praise V tError('s: %s' % def _build_&D"):pP""" B(+AAfromagiven 5 (language$U)i"No alias%ormtakes place16trym,# =l4if -G!X&if[!is 8?97elsK *0 + +`;except (Type,){&1('LA mus, a string, n iterable of < C'two9Fs --9VkA.') l Qgetdefault)(envvars=('LC_ALL', ) 4ANGhUAGE')wATrie$pcWsekthem as{PAccor}*PPOSIXHprogram which has{acalledE$se, "") runs uAport3'C'1CalJqlets itK a1def!by2LANG variy1. Swe don't wantwinterfe4jscurrentsthus emulatbehaviorin the way described above. -To maintain compatibility with other platforms, not only theELANG variable is tested, but a list of"s given asB(envvars parameter. The first found to be defined will bdused. Gdefaults5the search path * in GNU gettext;it must always coD`name ''IPExcepr code 'C',languagecorrespond5RFCb1766. 'and encoding can@NoneAcaseZ`values5notG)@term,2"""Etry:* # check if it's supported b _locale modulp im'O,=!S._getQ!()5e7!(IPError, Attribute)2pas4Felse# make sur/;#are validxtif sys. == "win32" |F A[:2]!60x"yF}p windows identifier=?f=@n.get(int(B, 0)-0# ...add-specific process5here, ifq@# neeary...Pretur&de-@# fajack on POSIX behaviourB olookup = os.environ*5forP$2 = J(x,6if .B#ikZUAGE''+Cq~.split(':')[0].Qbreak  J1'C'#Yc_parse`(.p) def(category=LC_CTYPE):Q""" Rscurrent sett_^N Nnutuple (f1)1>0may!of~@LC_*Q3ue LC_ALL. I_5Mr = _set&ifo2== C0';'6Graise Typ%('t@!isv'm\ def setlocale(category, locale=None): """ Set theA fordgiven >F. T$acan beBF a string, an iterable of twos (language code and encoding),K0or .]IP@s ar<nverted t[QusingP aliaWengine. LSpassed directlyYWC lib  may be Ras onhe LC_* values:1"""$if`not isinstance(, _builtin_str):8A# coj; = normalize(F"d_4nam`!))6return _set# ") def re#{=LC_ALL?s|@,!todefault settingU  is determined by calling53get4%). s-o5e)) if sys.platform.startswith("win"# On Win32, this will {^BANSI 2pagJtgetpreferred6(do` = Tru B"""RXQcharsa@userRqlikely +. @flags.utf8_mode~$u'UTF-8'import _booL2.False) elss:Unix, if CODESETPavailY, use that.o6try1except NameError&if hasattr(sys, 'getandroidapilevel'A$ ainfo.hu0misz !d 01 isF# alwaysd in mbstowcs()Nwcstombs()4 $; z%# Fall backD0par environment variYs :-(, <pby look/at 4 (Nnres = C9[1]/,ikp# LANG 8Dset,servativto ASCII  res = 'ascii'  return resQelse: def getpreferredencoding(do_setlocale = True)7;B"""R[the charset thae user is likely using,xAPaccorm@ to D system configuration."""6if sys.flags.utf8_modZj'UTF-8import _boo b [oldloc = "(LC_CTYPE)J->tryB=N, ""Aexcept ErrorJ2pasWresult =.ZFalset?if  I* ### Database # # The following data was extracted from.alias file which # comes with X11 and10n h 0ediGPremovceexplicit  # definiosB!adsome more y2es.is usually # available as /usr/lib/X11/E. #  __h! tKmaps lowercase names #;!C F# (8-sensitive). Note normalize() # first looks upAo)ins`es dic20ary4hen applies this mappxBo fi correct C lib@ ford% #v$ A= { d2# M^s@non-standardG_Ted in'D`'437':22'C'/'c' & )/en* 'ISO8859-1Z?jis2 W'JIS7, ,?aje d'eucJPYOkoi8.e'KOI8- microsoftcp12511'CP; .5.5 .6.6.K n12U12b 1b122Python codecto C lib encoding names 'ascii': 'ISO8859-1',1latin_1310isoB310e10c223d 3d42 4252 5262 6221 211 1 1 1 7 781 8191 912022_jp2E'JISshift_jis+d 'SJISXOtact)FTACT.?eucd'eucJP[-/kr[TeucKR-Outf_>ZEUTF->_koi8_ZUKOI8-[.t.T.u. U.Oz1041'RK _cp125C!CP .@.\.f&# 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 lowercS to C30# (&-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 uses this tables # )removes '_' and '-' characters from the encoding part of # locale name before do'4lookup. This sag@a lo? # space inJ! table. # # MAL 2004-12-10: # Updated alias mappbo most recent.$bfile #X.org distribution usABmake52.pyThese aredifferences compared to5old(Python 2.4 #Kqolder):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_YUsr_CS.ISO8859 -2' # updated 'sh' -> _YU.ISO8859-2' to 'sr_CS <p_hr.iso42H'HR3H9hr_H%sp?!/yu?({p55>%p_{?!rr{ r@cyrillicE)_zLr_SP r"_yu.cp1251 CP A  H5W*$yu5jhmicrosoft36Outf8XUTF-8yx@ # AP 2010-04-12: # Ualias mappingAmost recent locale.$file # from X.org distribution usABmake65.py. # # These are the differences compared|5old (Python 2.6.5 # and older):V]rFru_R]X?ru_;%serbocroatian 1RS.~m@latin >!>;4sr_ A?lat;+Qr_cs.\ KqXG+r_yu' -> 'sr#_CS.ISO8859-5' to 'sr_RS.UTF-8@latin' # updated!yu.utf8@cyrillic' ->C: KE@ ' # # SS 2013-12-20: # Ualias mappingmost recent locale.$file # from X.org distribution usABmake65A.py.These are the differences compared|5old (Python 3.3.3 # and older):Va"a3Pa3_AZ.KOI8-CQ'az _a3_az9&S.koi8xcs_cs.isoE2(csY2Zn2bhebrew@Uiw_IL+8@*he @8I'"sd<sd_IN@devanagari sr7nD Md*-d-csC|r] D sr?lat1H4-10-01with glibc 2.19 supporh|su8-05-05N/27N-?6.5 ca_es@valenciaFca_En'15x {Ckk_kkk_KZ.RK104 |ptcp154crussiaUru_RU_nBR' _P = { P'a3':  ',<?<c <Oa_dj7 e'aa_DJ$1'Oa_er?#ER;t;T;f8 'af_ZAOf_zaB 'af_ZA.ISO8859-1', 'agr_pe': (PE.UTF-8<Ok_gh;{ 'ak_GH;m8Lm_ET;?_et>/'a;oerican> o'en_US,On_es< 7n_E?50Onp_i} [np_INry|6r_A6{Or_aaB/'a?% ?E9~b)Or_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'astU/yc ' ayc_PE.UTF-8', 'az':  'az_AZ.ISO8859-9E@_C@ @.isoX/9e@ /ir6@*IRbn8#be_BY.CP1251be@latinz '<r1xbe_bg.utf8C l'bg_BG?_by6 | 3_by<Om_zm~|'bem_ZM?r_dp~'ber_DZ</maxKr_MA<g82l 1?g_b?<_hb_in{'bhb_IN?ho__o 'bho</np<+NPxOi_vu;{ 'bi_VU;On_bd;Mn_BD;N 'bn?o_c { 'en_AG4?n_a;?en_X?en_(?w/BW/ca?/CA?d/en_en_dlX?Lv/gb/GBhH 'en_ie'/:  'en_IE.ISO8859-1', 2?il'?xL.UTF-8;n;Nz/ng?-NGz/nz;Zz/ph?/PH?sc.utf8D [-SCs/SGz/uku  z/GB?s?/US?Q@euroI~?50/za6@/ZA/zm?Mw/zw;Wzw,ZSzOg_gb{Oglis?Ec?@.iso1??_t ?_united-state?~ ?J.437-'CeZpoY. e'eo_XX%3~o"k 'eo"?o_ezw/EOw?_usz?UOo_xx;g 9_'es_ENOs_ar~Es_AR?s_b76s_B7?cOs_CL~c~C~Ccu':  'es_CU.UTF-8', "@do':  (DO.ISO8859-1?/ec?/EC?s?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_e?f?u_FfqZfa_IRhOfa_iz;.isiri3342@';aISIRI-)Off_s/ Kf_SN;7i_FOfi_fC/'f@Ol_ph|'fil_PHOnnis= |f?o_F?fo_B/'f?,~r-1', 'fro_be':  'fr_BE.ISO8859-1', 2/ca?/CA?h?H?/fr?/FR?/lu?/LU?an\xe7aisE $~/e_?/nc<? @.iso1?Czench_franc??_ur_ituZ'fur_IT.UTF-8s?y_ds9 'fy_DE;/nlv;*NL;gvOga_I(Oga_i?Olegon'gl_ESgalicianA ?d9 to'gd_GB~Od_gbB?/er0'de Ogerm/ ? (?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.UTF-8', o'he': 'he_IL.ISO8859-8', 5/ilB(?Obrew@?i;i_IN.ISCII-DEVOi_inB/'h?.isciidevH?Of_fj7'hif_FJ.UTFwn@'hne <<rEr_HR.2q?r_hB/'h?_vatsk ?Osb_d8'hsb_DEOt_htk'ht_HTu8 'hu_HUz?u_hB?ongaria ?Oy_amk'hy_AM;@.arm%8D;0ARM_^/ia3g:'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~ @-1', 'iso8859-15': 'en_US.ISO. , .P'iso_/_1@'? tw f'it_ITOt_chB?/CH?i?~_alian ?u:  'iu_CA.NUNACOM-8Ou_caB? .nunacom8H?w3e'he_ILzOw_ilB? O.utf0'iw~6UTF7j4 'ja_JP.eucJPr_ja_jp;N? v.mscode>;ISJISO.pck7 :p%_panes %;O-euc ;c ;p&kLka_GE.GEORGIAN-ACADEMYOka_g/ F.georgianacademyF'F.psA FPtrA Ob_dz}'kab_DZ.Okk_k; 'kk_KZ.ptcp1546l_G1?/_gB/'k??m_kkm_KH.UTF-8', 'kn':  'kn_IN.UTF-8',;/_i>;ovo_KR.eucKRvOo_kr>/'k;N? ;kN'kok(Oorea)w;;s >'kss ;@devanagari.utf8;.?u_tu_TR.ISO8859-9?wre'kw_GB?1??_gbB?y<zKy_KGROy_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_TWymag_in':  'mag_IN.UTF-8', %`'mai':  (<?_in?</np<+NP_fe_mu<[fe_MU<Og_mg; 'mg_MG.ISO8859-150Ohr_r|Lhr_R|kv 'mi_NZ|{Oi_nz??q_n{'miq_NI6/jw.jw&k 'mk_MKq?k_mB?l~ll? 'm;?n_ml 'mn_M/niwN'mnirr;v? 'm;svEs_MY1Os_myB/'m?t<_Et_MT~3~?t_mB/'m?Oy_mmj'my_MMTonan_tw<'(+TW<b8e'nb_NOs_nb_noB?_ds_de@{'nds_DEOds_n<+NL</e_3\ 'ne_3onhn_mx[hn_MXwOiu_n[niu_N'(+NZx'l_NL.ISO8859-1', 'nl_aw':  (AW.UTF-8', +/be;BE.ISO8859-1?/nl?/NL?n<On_NO??_noB/'n?<~o~o@nynorsk ?'ny?~p_no.iso1@bokma/'n??orwegia ?r3 o'nr_ZAOr_zaB?sI'nso5/soAyz;y;?~7/oc^oc_FROoc_f'?Om_etj'om_ETOom_kOom_Ko7[or_INz?r_i+ ;Os_ruJs_RUvp$-pa/pa;p | 'pa_PK/p_S ;p_Ac?pap'( cA<CA/pdNd_USOpd_dDpd_D9-1', 'pd_us':  'pd_US.ISO8859-1', 2?'ph< 'ph_PH?_B?l~El_PL~2?l_pB/'p?Oolis?rtuguese e'pt_PTzo?o_brazi?/BR??sixy 5 '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_IN.UTF-8@devanagari', 'sd_pk':  ("PKF;Oe_no;Le_NO;rbocroatianCb'sr_RS;e@latin|_gs_lt:r'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>\'si_L?i_l$;?d_eLid_E_inhalOk_SKc?k_sB/'s?lkOl_SI~Ol_csBO'sl__?l_s?~?ova_ovene ~ /en ;?m_w;3m_WXOo_dj 1Eo_DJ1?N 'so?o_k1z/KEzsOo_SO? +rn5/p_?OanisV'es_EKvp?Y_spaiH  'es_ES.ISO8859-1', 'sq':  e'sq_AL?2??_alB?/mk?MK.UTF-8zr8Lr_RS;@cyrillicD /'s;Olatn7 J;Cvf@latin?_cs? $r_A ;@.iso2W|Or_cs6?l. /me,MEr/_r/_r; /spC!7/yu?yu.cp1251xx CP(%yu<?5?5~5 ~ ?microsoft?Outf8<v ;; 6 : vEs_ZAHOs_za z?t<~t~t~?v~Ov_SEOv_fiBo'sv_FI?s~?w_k?=/lk6 =ILK.U/cy_in.utf8A @'tcy0 <e3 ue;i;gvg_TJ.KOI8-COg_tj?/'t<h9h_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_ZA5?n_z{/'t@Oo_tok'to_TO9Opi_p{'tpi_PG<_Er_TR9Or_cyOr_CY?t/'t~  W9'tss?_;t_RU.TATAR-CYR~Ot_ru;?tt_ru.tatarc_yr': 'tt_RU.TATAR-CYR', )ru@iqtelif> (RU.UTF-8.Courkish=i 'tr_TR.ISO8859-9_ug_cn= 'ug_CN;k8 ;k_UA.KOI8-U<?_ua?/'u<?niv; 'en_US.utfuniversal> 9No8@ucs4C9tOm_us.@'unm <Q7'ur_PK.CP1256x?r_i;@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_NGlyue_hk':  'yue_HK.UTF-8', #'yuw_pg': (*PG</zh8S'zh_CN.eucCNw_zh_cn>;igb2312<_.big5A <"TW(v9  :/hk7 !HKuWhkscs#hkFz?s[SG.GB/_sg.gb {<K/tw! uh/twh TW()TWu{ ;uu_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= {7 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(TKuwai3801: "ar_AE", # Arabic - United Emirates 0x3c01: "ar_BH",5sBahrain($40(*QA(SQatar&042b: "hy_AM&TmeniaF@044dnBs_IN ssamese - IndiaHc(Bz_AZ(zeri - Lat?082%CyrillicM6uQba_RUMgBashkiTeu_ES quHRuss3: "be_BY'ielarus5"ncBegali@201a2s_BA0Bos; - /14* 047eQBr_FRreton - Francex@0402'Bg_BG'Pulgar#0045Bmy_M3BurNot supportedQ $ca0VCatal004: "zh_CHS",# ChinSimplifiK,!TW,FTaiwT8T7(4PRCc%+HKM`Hong KcS.A.R.21SWSingaporF$14]+MO]iMacao Y7:CHTTraditional1048PoCorsicaBhr_HPCroat1b$hrb 2 - mr0Bcs_C^VCzech6: "da_DGVDanis8t`gbz_AF!Da@Afgh(t 46eadiv_MV*@iveheMaldiv0041Qnl_NL[Dutch - The Netherland$08/)BE/vBelgium9: "en_U`EnglisX'St3080/!GBV /eKingdo_c0AT0uAustral9$10+C+TCanad$14(N(`New Zee1I-0Ire0$1cVZ~South Afric2J.GJama)C0uCaribbe 2BTBelizc2+TTtTrinida3Z7tZimbabwT3P*pPhilipp+4W-4TM 'VMalay34 Q `0042.Cet_E0sto0438: "fo_FdFaroes0464: "fil_PH",# Filipino 0x040b: "fi_FI", # FinnishcBr_FRrench - France'#80'*BE'tBelgium(c(*CA(cCanada'%10'H'Switzerland,4,*LU,Luxembourg+*MC+VMonac 62Cy_NL'isian - Neth~sT0456: "gl_ES-Galician 37: "ka_GXGeorg 0 Dde_D !rml Ge yH8(C> - $0c,"ATK - Austrig|;T;4SL'+iechtenstei08: "el_G6TGreek046f2l_G_nUic - /4Rgu_INuujarati 6lQha_NG Hausa - Latd: "he_IteHebrewC 39icFHind` 0e2u_H`iHungarBis_I2Ice_21: "id_ID`IndoneS"53iu_Inuktitutuyllabicr8- 83Bga_I[@Iris!Ir} 102t_I.BItal '' 41Qja_JPuJapanes0 44v$knr0Kane - Ind0043[Qkk_KZGVKazak 53I2h_KKhmer - CamboF8qut_GT",# K'icheltuatemal0048lRrw_RWpinyarwandRR 75,1kok# Konkan7 122o_KGKore4tBky_KfKyrgyz[4: "lo_L&1LaoUo PDR%2Qlv_LVHLatv2Blt_LwLithuan" 821dsb{# Lower Sorb 46/3lb_-$/2Qmk_MKFYROM Macedo| 43MQms_MY(Malay - s8(B  - Brunei Darussalaa 44!ml" #Q![a: "mt_M HMalt8Bmi_NzFMaor7<`arn_CLQMapudungu4rGrathA!oh# Mohawk5&Cmn_MCongoCyrillic,8,C,PRC 0x0461: "ne_NP", # Nepali 0x0414Bb_NOorwegian - Bokmal*8*n*tNynorsk+482: "oc_FRUQOccitSeFrance( 48(Br_IN(riya - India%63: "ps_AF%Pashto - Afghanistan,29: "fa_IyWPersi 15KBl_PLKUolish= 163t_B=ortuguese Grazi +#PTI+P89!44-afPunjab6b: "quz_BO",# Quechua (Bolivia)8))EC)uEcuador)c))PE)EPeru& 41}Bro_RRRoman y417: "rm_CH8uRru_RU'usu0243`smn_FISami Finlandb#10$j]!# $dNorway#G1j_S#VSwedeFeE Fithern O$08,N , Xc, , 2sTSkolt{!ma?Sou1{)ma, u44f: "shtSanskrix@0c1a 2r_S BSerbCyrillic*!BA*{Bosnia 1/08[DLati1'X.10459Bi_LKPinhal Sri Lank$c2s_Z2NorNSSotho0043$tn&qSetswanRSVAfricX13k_SFlova2<Rsl_SI@loveCq0rRes_ES!puh - Spa$08'+MX'UMexicc(O (Modern$100GSGuatemal$14+C+vCosta R1Pm,UPanamTDa(Dominican Repubz2+VE uVenezue2 _eColombB2 U2AArgentin3YT3qDChil3U{UUrugu3+PYGPara*400a: "es_BO", # Spanish - Bolivia 0x440a: "es_SV",)El Salvador-8-+HN-Honduras*c*+NI*Nicaragu$50++PR+Puerto RicoX5+US-United States #r0430: "+utu - Not supportedW0441: "sw_KE,ewahili 1d4v_S"edNdSweden(8(Fw(fFinlanp5vsyr_SY",# SyriacG428: "tg_TJTajik - Cyrilli(085f(Pmz_DZFTamazight - Lati0449)2a_IUTamiln 44Ct_RUn$ta0044%te:Uelugu; 1e;Bh_TH;%ha4 85SRbo_BT`ibetanFhuta(C(6PRCi2r_T$uTurkish 42Bk_TMlPurkmel 3 483ug_nUighur - ArabZ 42QQuk_UAQwUkraini2`wen_DE{Upper SorbiuGermany2wBr_PKP%rdE80Urd5Ind0443: "uz_UZ@0zbe 8% 2Bvi_VrVietnamese5Qcy_GBo7Welm8Bwo_S?Wolof - SenegaW3WBxh_ZCPXhosa'outh Afric@0485`!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' undefined)')# print(' Encoding: ', enc or '(undefined)')5!) B 'Locale settings after calling resetl#3():W:R-'*72L 'jfor name,category in ies.items():-U3S '...lBlang5= gMy(C Language ?!6V%6try0LC_ALL, ""fexcept*DNOTEZH does not support the default 9bPgiven- OS environment variablesqLelse5 A\357;,K ? :C9) ### HLC_MESSAGES 6 NameErrorVpass __all__.append("A") if __$__=='__main__'KVPaliasZG_ _g( 'Number formaU,_test() """Interface to+liblzma compression library. This module provides a classu@ rea and wriKed files, 0e2Pincrewal (de)y,Gconvenience function; one-shot82ese'nd;Aboth!XZilegacy LZMA containKs, as well8rawdata streams.V# A = [f"CHECK_NONE", YCRC32&64SHA256",@fID_MAX$tUNKNOWN%pFILTER_1%hWDELTA 7X86 IAv17ARM!ARMTHUMBwPOWERPCUSPARCORMAT_AUTO#'XZ #ALF4RAW>`MF_HC3, #QMF_BT 5BT46ODE_FAST9 NZLPRESET_DEFAUL!EXTREME", "L ZMACompressor", "LZMADecDFile 0Err- "open3 dA is_check_supported", ] im builtins$io os from _lzma /* _encode_filter_properties, _e_ ion _MODE_CLOSED = 00REA 1 # Value 2 no longer used,PWRITE= 3 class ZF(r.BaseStream): R""A file object providing transparentOW (de).B!Anm can act as a wrapper for an existXnA, or refer directly to a namedcn diskrNote thayew*binary*:interface - data readsis returned0byt2and(to be written mustUgiven/.I2""" def __init__(self,=None, mode="!*,<cformat+P=-1, 0eus%%):DP"""Op-A2in Hybe eitheaactual% (Va str;or PathLikM), in which caseL%is ed4 it6 BGe torO1"r"<(default), "w`(over)H6ing""xAcreaexclusively""a!n>p. These{equivalen5be P0"rbw@xb" "ab" respecti* ifies the containr0mat'1use ,!If A is Sthis s;FORMAT_AUTO. OPwise,k0E/'XZ bgrity  to/is argump5cane@only|` when -aae. For CHECK_CRC64./QALONE{@RAW do notU 4s -gqSmats,<D omT2be GNONE:W" **7)ismeaningful,`shouldLw3e *UI*1als7, except$isI8( case  it is required). When opening a file for writing, the set s used byBcompressor can be specified either as a %4et /5ionClevel (with[" *, * argument), or in detailQecustomEfilter chainLsM. For FORMAT_XZ andFRALONEadefaulA toPRESET_DEFAULTF g2RAWOcaller must always0y5terG;p5raw;or does not support# ^s^ (if provided) shouldan integerrange 0-9,optionally OR-ed constant #wEXTREME sequence of dicts. Each have an entry"id" indica0 IDHze, plusHBaddiD1iesFAs to;.65""" self._fp = NoneQcloseLFalsmode = _MODE_CLOSED1if "r", "rb"):aif check != -1 raise ValueError("Can;y<CrityKB/"w:reading")wi)!  Qforma =OIAUTO(_cEREAD#)elw wba x x!isyP %XZzYWRITE$or = LZMAC(e=,C=0n#=,Rters=|sRupos = 0JelseqInvalid[: {!r}".()))1isi0ce(name, (str, bytes, os.PathLike)1"b""inqtj += "b9builtins.;closefp = True' self._mode = U_code#elif hasattr(filename, "read") orwrite"):FpiTfp = H *seQraise TypeError("W must be a str, bytes,vPathLike object") 2if = _MODE_READ|w = _compression.DerReader(Jfp, LZMA5or,qtrailing_e=1, format=ters=fil)Jrbuffer = io.B #ed3rawdef close"""Flush and"A the=.)0Mayacalled more than once without 0. OD5 isd, any other operatioI it will ba Valu.C5""" \CLOSEUeturn::tryKv.( %f = Nond hJ |ZWRITE0+1fp.l.@or.f/()o( kfinall !%.fp&& m6+ SRJFalsQ&P0@prq!ty dN True if this 2 is(d.rYEzlolRD2descriptor underlying qcheck_not_%dy 3fp.seekabl1whesupports <9ingr9\)b.<'0* 0wasJ1ned1B M/._%BS"B92peek(self, size=-1C): ."""Return buffered data without advancing the file position. FAlways rJs at least one byte ofWq, unles"EEOF.AThe exact number19Ted is unspecified;5"""Gself._check_can_read()# Relies onundocumented f~cthat B Reader.peek() aLp(except6EOF2 p^Rsize)OAdef & , <=-1ad up to uncompressedpas from"If3is negative or omitted,{ until EOFuXreachq0s b"" ife, aly"$U(  $/1(%*@, wh1tryuo avoid0makmultipleZaunderl;stream. 2saH's worthcif t^"t6< 0 ^ = io.DEFAULT_BUFFER_SIZEr 1Oline a '.terminat1newF@(if @ent)retained. Dnon-, no more than"qwill be@ (in3%chE0cas4e0may,iPlete)^Ps b''."H Dwritu HW# a3`objectUr1ten\Uch is,AQ len(P. Not>`at duey*Fing,Wuon diskGenot refl!he\ zaclose(Hcall2 Ee3Y=4or. R._fp.N&&ed #fpos +=Bri,s>, offsetjence=io.SEEK_SETChange the file position. The new p is specified by offset, relative to theAp9bndicat6 whence. Possible values for V are:0: start of stream (default): must not bgF1: currentE 'f2: endk;a:&vepReturns8Efile=XNote that seekingY@emul", so depend!onOparameters,this opera@ mayextremely slow..5""" self._check_can_%()r &qbuffer.#)def tell(0%):F2"""w not_closed#ifmode == _MODE_READv`pos Popen(`name, i="rb", *xmat=None, F=-1, prese0fil%P encos errors qnewlineH"""Open an LZMA-comf@sed  in binary or textk"A canPitherLbactualC"@(givg0s ac, bytekor PathLike object),ywhich cas e H@ned,!itan existS:read from60wri%o` argumPP"r", @, "ww "x 2xb"1"a"@"ab"?\ rt1wxbor "at.c0cformat  1 anByKpion setBs, aC1or,$De3odF)CFile:For-Afunc,is equivalK\CPconstructor: , ...). I!is ,,providedr,6u"re7npwrapped!anio.TextIOWr instance with APhandl`behavij%cing(s)`if "t"(b`aise V E("Invalid: %r" % (Q",)Ielse]P!fr("Argument 'encoding' not supported in binary mode") if errors is4UNone:&raise ValueE+("Argument '<nnewlineo#=p0lz_! =.replace("t", "_file = LZMAFile(cname, E, format=, check=,n*rpreset=, filters=!) <`if "t"~ return io.TextIOWrapper($, ,#, &7elsRA def comes(dataFORMAT_XZ@-1, (0et=))C"""CN a block of Y.Refer toq,or's docstringp a descriptionD1the1oCal a2s *A*, * s* and *s*For incre%alion, use an instead.1"""9;(63.A.2res1) +.flush())de& AUTO, memlimi DJ.= results = [] wh7TruaTU 2try  reoT.&aexceptaT D3if :break # LeftoverYOqa validY/XZ stream; ignore itI 1 #  on the first itera; bail ouS.bnd(resU!if_J.eoftu(C"edended bef["end-of- marker was reached<3 = punused_:ata'b"".join{) """Read/write Maildir, mbox, MH, Babyl,MMDF mailboxes.p # Notes>authors of new mailbox subclasses: # # Remember to fsync() changes disk before closing a modified file # or returnfrom a flush() method. See functions _l_%Sand #ge(). import os Dtime calendardsocketTerrno Dcopy !waSTemail u.messagigeneratopi_ntextlib ctypes G8icAlias try: fcntl except IRError% = None __all__ = ['Mailbox', 0dir mHPBabyl aMMDF',w{R 'MgaildirG%MH D` 'gacNoSuch INotEmpty 'ExternalClashbFormat] linesep = os. .encode('ascii')  }V"""A group of  s in a particular place.""" def __init__(self, path, factory=, create=True)os"""Initialize as instang)] ._] @.abs@(os..expanduser(!))?$ =3add 4AddC and assigned keylraise NotImplemented1('M must be!5 byIbcremove:keyR@ thee"; "KeD if it doesn't existG__delitem ddiscar 3f2s, Q* i`Q }t3yFpass\__set,% 8k6getU, default ,7_  5__gN BN_, Return the k'eyed message; raise KeyError if it doesn't exist.""" if not self._factory:%breturn"Cget_jU(key))Jelse7 with contextlib.closing(jHAfileEP) as  A |(+!) {@def L] , LB"""R2a M& representation or7a9 %TNotImplemented_('Method must be i! by subclass'4str  '3Uses email..to create a 7bit clean fPA Tf the` W m_from_bytesR).as_q(% &> %_-likejriterkey) n %ator overFsZ4 list ofu |.N)QCvalu4all !fo# i^sJ;t<! =AU[key]jeexceptw P!CIinue6ayield Z  __!__r2Z-7s"89oSs. Memory intensive+s6 x Oitem4,) tuplel   ?) tuples. Memory intensive.""" return list(self.iteritems()) 'def __contains__(q, key):!KB"""RKTrue if the$ed message exists, False otherwisaise NotImplementedError('Method must be i! by subclass'3lena count ofAs inzmailbox-9QclearL Delete all 0forXWkeys(Cdiscard(1popu, default=NoneE3"""Cand 7dit, orE 6tryresult = U[key]=except Key 84F.ep an arbitrary 6,y) pair E]) # This is only run once.Kelse;D('Noaupdate_, argbChange s that correspond to cersif hasattr(arg, '~'s'{source =|MmIE 7x'bad_key =|  1elf$ =Y  ![<3if  rP with8(s)Qflush@"""W  any pending csIdisk|4OlockBLockM/unU it3/edGBclos F" the mailbox.S""" raise NotImplementedError('Method must be i! by subclass') Mdef _string_to_bytes(self, message):)yd# If a is not 7bit clean, we refuse to handle it sinc Jlikely came from reading invalidf s in text mode, and that wayOes mojibake.6trydreturn].encode('ascii')8except Uni Z HQValue1("SEe input~ASCII-only; ")sr or a Mr instead"# Whether eachd0end!a newline_append_ = FalseSdump_ , target, mangle_!_=A This assumes the80 fi`s openabinaryu"""Dumpcontents7H.Pif isSance(, email..Cibuffer = io.B6IO("Sgen =Lgenerator,G(G =, 0J.flatten !Fk.seek(<sdata = " !.replace(b'\n', :seplLp.write(6 0if .1e2.endswith(b ># Make sure  ; < 4 c"/ela(str, =,;IO)?5io.2warnings. ("Use of 1is deprecated,s3, D9BionWl:, 3>H=)P.getvu ;str V v )if46 F0', > `? C X 5pthasattr5, 'read'):  if hasattr(message, 'buffer'): $warnings. ("Use of text mode files is deprecated, "GR"use a binary> instead", DDBionWxM, 3)M3 = . )lastline = Nonewhile True4Z@read(# Universal new& support.o0if !.endswith(b'\r\ns/,! =3[:-2] + b'\n'X/elZX1Xaif not$]breakif mangle_from_ andDd.start_From 2b'>'! +BM[5:]o'.replaceY1n',4>septarget.write(A#<! wif self._append_t ?PU# Make sure the 2 3$ ag  c&;els raise TypeError('Invalidutype: %s' % ,1)) W__class_getitem__ = method(GenericAlias)  Maildir(3boxo"""A qmail-style' rbox."""vcolon = ':'def __init__(, dirname, factory=, create=w8"""Initializ1dirAance{)q lW._paths = {AQ'tmp': os. Q.join0!, *),4?new4 4?cur4 4}vgexistsS#ifpPos.mkv, 0o7000C@for 3 ints.values(u2b-\8cNoSuch0toc(a_mtime'Z`: 0, '<: 00o_i@ = 0# Records  PA we (ucur/newxBskewI.1 # Adjust )if os/fs clocks are skewing def add(self, message): d"""Add and return assigned key."""3tmp_file = V._create_tmp()&&ryfj,Sdump_($, S?except BaseE :ionP4g.closezmos.remove('Fname`%Uraiseb_sync_M50if isinstanceMaildirMX`subdir =^R.get_ dsuffixQycolon +7Kinfo54if 89 &^%''Jelse*v = 'new)Auniq = os.path.baseb pa.split~.E)[0]GdestDBjoin+_T", !, l++{os.utim,(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 programt zos.link , ) (AttributeError, Permission6Se AL !OSK as B gif e.errno == z.EEXIST`,r ExternalClash|('Name cexistingJ: %sP%&fq@J,A"""RhEkeyeL!; [A Key Ct doesn't Xnwelf._lookup(keynddiscar^"""If2s, 9 it# This overrides an inapplicable implemenocPsuper!s. FN*(8, FileNotFoundError):  `pass def __setitem__(self, key, message):)-"""Replace the&$ed'; raise KeyError if it doesn't exist."""Mold_subpath = x._lookup(key)(temp_key%Dadd( %NASsinstanceM, MaildirM # H's subdir and suffix were specified by.BdominantS,Felset:| defaults from !){zP= os..dirname( Kcolon in + 25+4a.split.$U)[-1]!W%''&{discardR0mp_ Bjoinp,1new : ED# +#B{!os.utime(t,(Igeta1).get_date())# No file modification should be done after+is moved to its# final posiG`in ord;o prevent rEAcond#s with changeJother programQos.re )0 sturn a  represenGoa y Eopen tG), 'rb') as f?#if)zfactory 4msg)_%&(f#?9 :qhamsg.seBdir(=6V BPinfo(T1 m u!re:msgF_bytesD&B9elf"(f.read().replace(linesep, b'\n') def get_file(self, key):!"""Return a %-like representation or raise a KeyError."""Ef = open(os.path.joino ._ , {._lookup(), 'rb')Drp_ProxyFfiterkeysU n %ator oversrefresh(z!fo-3 in6toc!%:tryOeexcept/?continue6Pyield __*aains__True if theDed message exists, False otherwise9key"3len count ofsKmailbox$le[7toc#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  ()+Z nameresult = []WAentr0os.E1dir\0if G4Q) > 1[0] == '.'\e84  isb L)wC0.ap('F[1:] (@", "binstance #qQd<+A,),factory=%.qcreate=3add3C<Ca )it $ =l(G#, 2dir$ zG')/ ifn os.path.exists(maildirfolder_path): os.close(os.open2, os.O_CREAT | yWRONLY,KVu0o666))return result def remove_r(self, """Delete the named% , which must be empty."""a = Q.joing.s, '.' +Nfor entry in<plistdirG , 'new')) + \uy?os.? Wcur')8qif len(d) < 1 `[0] != 6raise NotEError('F contains message(s): %s' %C and9 Atmp' .0os.c?.isjk +"subdirectory '%s'?" %W(,)root, dirs, files5Pwalk(, topdown=FalseEC7@2os.* z= UTmkS,)BcleaP6oldY"tmp"now = time.(.X  5 0if -FQ.geta) > 129600: # 60 *)36G; <_count = 1@This is used to generate uniqueC&s.{_create_tmp C" a<!in:Itmp /it@host = socket%`if '/' 4 = .replace('/', r'\057'R:R%:R'72Ri = "%s.M%sP%sQ%s.%s" % (int(now), % 1 * 1e6)getpid() M.,c5:tryWos.stat(path)   except FileNotFoundError: !Maildir._count += 1 :try16return _create_carefully(path)@oExistsSUpass :0# Fall through to here if stat succeeded or open raised EEXIST.H ExternalClash('Name c prevented file ion: %s' %L(def _refresh(self)="""Update table of contents mapping."""Hh&# If it has been less than two seconds since the last~w) call,Opwe haveN un=itionally re-readGmailbox just in caseMmodified, because os..mtime()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}.3!if;.@P() -  .__tS> 2 +QLfactS =sS(for subdir^Btoc_,% =1get ._"s[Q]>1if .# >k5s9:Tru M" =pP-sif not Sp32# RE tocrU = {}O,# =  9OSPentryos.listdir.pAjoin(!, Bos.path.isdir(_p): continueuniq = entry.split(self.colon)[0]2P_toc[< ] = os.path.join(subdir,R)>6last_read = time.1() 'def _lookupW, key """Use TOC to return sub| for given5 , or raise a KeyError."""h:try)%ifzexists(_j", Wkey])Z5)|eexcept Epass*jrefresh(M q('%('No message withOp: %s' % ) from None# This method is backward compatibility only.2nexlAB"""R@the "in a one-3 iterationif not hasattrEP'_one5g_keys'nc"" =c2xwhile True Z[.)^TStopI iX>9 class _singlefileMailbox(%R"""A %-&" m'u__init__", %factory=, create=:["""Initializj,.q l-f1pen.V'rb+'5M!OS;K as if e.errno == ~.ENOENTy#ifw(;elscNoSuch)1'elCin (dACCES,GROFS9'rbC'?$_;= fRtoc =o,0RK = 04pending = False4 # No changes require rewrit-p4hM@_synRM@need@ Plocke9 ps_lengthxB# UsYdrecorduC sizu?1add, message):  """Add message and return assigned key.""" 0 self._lookup()Btoc[!next_key] =3sappend_l( B8U += 1^:# _? Us the"toailbox file. WeF$don't need a full rewrite + rename, sync is enough.>Aing_&V= Tru`;)A- 1 Edef remove(#,[!):]A"""REkeye ; raise KeyError if it does_exist6keyf3del#._ __setitem__,| _placeJfiterkeys  n %ator overs|yyield from.l)__containsfz - s, False otherwisefkey in3lena count ofsKm1lenW._toc'Alock ALocktjcif notA&ed|__5[. #t(-ed! un< U ite3)ed/if fkQflush< WDany changes to diskO1 P3 #T2# M~ s have only been added, so1ingC=#L y_3," =E p$P7# In order)0be QPanyth out at all,toc mustY# alreadygenerated (presumabl$s#modifiedH by9wpr delet an item).  assert self._toc is not None # Check length of1file; if it's changed, some other processJhas modified the mailbox since we scanned it.8p.seek(0, 2)cur_len =f.tell($4if '!(9Egth:Mraise ExternalClashError('Size) 'EI'(expected %i, foun O)' %A(,&))Anew_= _create_temporaryCFpath$:tryBI= {}Cpre_ `_hook(0rSfor key in sorted}toc.keys())w5start, stoptoc[key]-z= 'oessage 1L0 = b Y(while True ebufferKread(min(4096,7 -)H!if'_breakbwrite(Il'1 = G,F<Z_ost_m.L jexcept>g.close/os.remove'Jname+-b_sync_M\0#jabout to get replac@` no ne! o R f^Make sureY@new 'qeqpqsame as#3old#mode = os.stat'.5ode+os.chmod,% UWI 8ld FileExists QBsE:7penv, 'rb+'u-$5tocpending = Fals> 8 #iijlocked_P, dot=m Qdef _ailbox_hook(self, f): #"""Called before writing the mailbox to file f.""";qreturn  def _pre_message_hook(seloSeach =p?ostqUafterp Qclose @Flush and ": 06tryx .f>!()Fkfinall* ;*1if Bz_locked\!" un#ei3_. () # Sync has been done byw above.alookup3, key=None=RE (start, stop) or raise KeyErrorHptoc is U generate_toc if9?not=lPU[key]6eexcept ! E('No@withp: %s' % a) fromQdappendY6 XA*b%to viffsetslJ seek(0, 23='Jtelln1len.9a) == 0.`:ing4`# ThisTfirst,@tt #rn't yetc4. I<{g[True,@\bs haveCremoved, so[ mustD;~ already.( CP9Zw < .<o uinstallW 5ds e QBaseE:ionN.truncate(N v5(6tu_lengtheRecord current -$of R$- class _mboxMMDF(_singleaM`"""An (,^]c0_ma=_@_ = ~%ge?^3""":2a M representationz> a KeyError."""# start, stop = self._lookup(key)(file.seek(8from_lineE+@read().replace(sep, b''@nstring=(-Tftell();&ms8message_factory(W|:\n'DP.set_([5:].decode('ascii4return msg &def get_t(Kq, key, Q=False):,}B"""RC"a 4 representation or raise a KeyError."""Beemail.ebytes()o.T)).as@unix=*_):IL]/bif notx _O/'Bx V_.2_-like1Xlr_PartialFile.,_install_?#,  ]Format a and blindly write tot[lENoneQif isCnce(yr~cB_to_G Z.)3.swith(b'From '}3new4pfind(b'$-Z!= -1(" N#[:a]L."$ =w[+Z + 1:0Oelsepf5b''/elD_mboxMMDFM  .fauthor'Y().enl#)4 = 2 + O* .c[() # May be .x"if is not None:+ from_line = .encode('ascii')6&if% is None:[D = b'From MAILER-DAEMON ' + time.asc(0.gm4()){t start = self._file.tell("fwrite( + sep C Hse:  last_was_empty = False  self._toc = dict(enumerate(zip(starts, stops)))8pnext_keWElen(M (file_length = ' .tell() class MMDF(_mbox !):oQ"""An mailbox.""" def __init__, path, factory=None, create=TrueU"""Initialize ad&message_\! =M,. )Dpre_dChookf Called before writing each =@ to ^! f) f.-e(b'\001' + linesep?ost_after!z? + 1gen& #G key-to-) table of contents&  = [], [] ^v.seek(0 upos = 00`while y_-84 +@read6(r)> -X!!if.Owith  G;.append(z ( $( - 5 -? ==}  > - T":Ybreakelif notph .Q^6, 2~|L2H(M/HHFNH instanceZ0os.q.exists ._+ if create:   os.mkdir(self._path, 0o700) * os.close(os.open1Y.joinA'.mh_sequences'),L \]O_CREAT | DEXCL `WRONLYJ600)]else:araise NoSuchMailboxErroGlocked = False Sqdef add, message)od"""Add and return assigned key."""Oqkeys = t (pif len(f) == 0i:new_key = 1N&3maxL+2  =h @str((7keynf = _create_carefully(F&I:try"if_z 2v_file(f_ Llc_dump_(+, Y/except BaseE >ion*@# Un so it can be deleted on Windows? )!_uo$Qsync_ 6#OTrueos.removeFg Bif isinstancek=MHMAE=> nkfinallXPSOVrif not <_wU^,# TR|@ theea!; qA Key jt doesn't existm  ZLv, 'rb+',"OS;as if e.errno ~.ENOENTD E('NoZ@with p: %s' %  R2$f L)__setitem__?keyReplacep f = open(path, 'rb+') except OSError as e:$if e.errno == z.ENOENT(,raise KeyM ('No message with key: %s' % <;elszR:tryuif self._locked@z_file(fp L/os.close(os.open(4os.O_WRONLY | jTRUNC)SBSdump_(+, /if isinstance*2MHM8)7fsequences>:keykfinall<H@%0_un_ FVb_sync_E1f) udef get,"""Return a  representation or % acA."""c Af = 0os.`.join( ._`, str(O)9rVfsemsg =  %qor name_list inir).items( if41key@ %|msg.add_M(qr :msgCQbytesyA&?return f.read ().replace(linesep, b'\n') finally: if self._locked!%0_un_file(f) Frdef getDf, key)B"""Return a :-like representation or raise a KeyError."""b{+trf = open(os.path.join( ._`, str(g), 'rb except OSgV as emif e.errno == z.ENOENT(,('No message with p: %s' % ;elszRr;|_ProxyFyiterkeyst n %ator overs[b&(sorted(int(entry) for in os.listdirqj VT.isdigit())C__contains__]GTrue if the%edrexists, False otherwise73F 3lenu count ofs?mailbox@len(_. ' xALock_oif not6U'.mh_sequences'\+]E. 'sPed = OgUbit is L X  _sync_close3del\@ W" =QflushW  Write any pending changes toIdiskZ ZFrQ and "M2 _folder  (+\ namesult = []M if or)( re0.apr $y ", ^n MH instancei!d84 MH.join(self._path, folder), factory=self._, create=False) 8def add_M(1Z:"]A"""C<# aw and return an MH instance representing it."""Ir2`MH(os.Q.joinw ._}oremoveDelete the named, which must be empty? = rentries3listdir(E)#5if &= ['.mh_sequences']2os. ?R+, ;)d+elf WEpassJelsevraise NotEError('F~B not(: %s' % Bmky6get)zB"""R.a-to-key-G dictionary to define each < `result!{}~Mwith openMS, 'r', encoding='ASCII') as f^pall_keyt1set.((Pfor l,inC:tryX, contenE.split(':'}-0 = !uspec in\UO0if 5.isdigit(+3.add(int(9 $start, stop = T0x) x`?'-'jPupdate(range(^?+ 1@`[] = [keyin sorted(_5) \s 3if BO]=yif len(o) == 0=uIdel 1 Zexcept ValueMaFormat'('InvalidPifica+ phrstrip<JsT,sf"""Set0 us_givent \fF+G os.close(os.op en(f.name, os.O_WRONLY |TRUNC)) Bfor 1 keys in sequences.items():1<pif len(2n) == 0#'continue@f.write(yj + ':'=prev = Non@completing = Fals#1keyorted(setq0if 10- 1,Fnot +/(_ = Tr&/'-%Oelif| x(Pu%s %s' % (, 3/OelseQO>keyGg =h (g1str)P/\n:D'8zfinally_sync_close(f) def pack(self]a"""Re- messages to eliminate numbergaps. InvalidatesQs."""b'0 = iU.get_(\P0:@chan|E= [] 0elfr 0!= \ a.append(f,+O + 1=+trVEos.link(os.path.joinV ._ , I%),8 @ 4Aexcept (AttributeError, Permission:Pos.re.  _os.un` p5= 1v`_next_5V"$'ereturn1=sQ_list 5old, new/o`if old#1key^$[ .index(old)] =hsW_dump7#, P"""Inspect amB MHM=p and up appropriately.S""" pending_sequences = message.get%()46all = self-for name, key_list in C.items():b!if8. *.]0.ap.F(key!@elifP-G0del%['a.indexS]5Tv I ]5if ..no . #[=@] = ~s ;) class Babyl(_singlefileMailboxy"""An Rmail-style1 @box.7_special_label2frozenset({'unseen', 'deleted n `answerK'forward.S 'ediMresent'}) Ddef __init__(, path, factory=None, create=Truey"""Initialize a&8.v q.4&{}3add| 4Add and return assignedokey = hB4if isinstance(,M2 ;86keycremove A"""R@ thee; raise KeyError t doesn't exist  z B"in) P__setDkey,I_placeC EdPY sB repation ora start, stopq_lookupa.seek(8  readline() # Skip b'1,'  bfying .doriginal_header(io.BytesIO`while  c`^_e"if== b'*** EOOH ***' +sep or not line;: Ybreakoriginal_headers.write(line.replac sep, b'\n'))Atvisible< = io.BytesIO('while Trueline = self._filr ad=0if 1 ==sep or not U0 # Read up to the stop,5endnXtop -Gtellassert n >= 0;@body> &(nI"Nmsg = BabylMessage(getvalue() + Vkmsg.set_9(.;4if key injlabelsX( V[key]Nreturn msg def get_b`9,o)`B"""R5a string representationraise a KeyError."""`9astart,lookup(keyQseek(8$re # Skip b'1,' specify. ^Qb'*** EOOH ***' +p q0l = = (EdatagM."0 + 6 ;d:%_-like=r|'CL,`*)) list of user-defined 7zmailbox^9t2forT_o .='s(ELP.updaJ? n.difference_-1_2al_I7a(_generate_toc(self)3: '"""Generate key-to-(start, stop) table of contents."""?+s,s = [], []elf._file.seek(0)pnext_po50label_listIwhile TrueClineFQM F = s@read6()> -Ktell)0if ? == b'\037\014' +:sep[20en(Oas) < l ^arts)-1*.append(m-9Jsep)6S7(d_ .strip() for  AZ/inY[1:].split(b','QfI2!se elu6ine ' k1not; #Ubreaktoc = dict(enumB(zip)U8[; 4yQkey =I6toc?, 2_lengthdef _pre_mailbox_hook(_7, f\"""Called before writing the <@ to ) f`babyl BABYL OPTIONS:,+-Version: 5)?R.get_jA = ( x.encode2 in-LJsR.joinL&s)' f.-!e([!) xoessagexbeach m=yx'` Cost_HUaftert# +'tinstall UWriteP and return O)i {Qif isCnce(0, BMessage):  special_labels = [] Afor  in message.getI9():GN&if2jself._}26 $.append({)cOelseG1s?file.write(b'1'b uPR, ' +.encode()b5, ~}\ + b'` vlinesepf 4Qb'1,, =if isinstance(:, email.".MQ E orig_buffer = io.BytesIO(2'generato*\7G!(0W, False, 0S .flatten,Ok.seek(Lwhile Truk7 = P.read v(p.replacP\n',  ?ine == b'\n' or not2R2Ybreaku b'*** EOOH ***J_Babyl6?vis*# =_ Y U mvisibl= 6 =  1 {BC6( $KRx !(4096) # Bsize is arbitrary.!ifS & self._file.write(buffer.replace(b'\n', linesep)) %elif isinstance(message, (bytes, str, io.StringIO)):=D?2 15warnings. ("Use of c input is deprecated, "wF`"use B0IO sead", D9BionWl6, 3:3 = .getvalue(-;str Vs;A_to_Td bbody_startAfind\n') + 27if 6- 2 != -1o&[:@], Ob'*** EOOH ***' +i <<O:Oelse;!tthasattr9p, 'read'>if -  +itext mode 3sa binary>1 Koriginal_pos0Ktellfirst_pas(ITrueH`while `\s `G# Universal new9support.o-!if.endswithr/M=3[:-2] +  X*. ZX1X dYd2 ==q or not6if #Y$z = Fals#  @Yh.seek(3NIYbreakine()  if not line:  ]break# Universal new? support.-!if`.endswith(b'\r\n')rM=3q[:-2] + =sepZ/el\Z1ZZ self._file.write();elsraise TypeError('Invalid message type: %s' % ()Vwstop = |Vtell(!return (start, 0) class Mis(email.^.3"""  +box-format-specific properties.""" def __init__(,S=Noneb"""Initialize a instanceT)Tif is/, 7._become_(copy.deep Pe9t-]._explain_to[bytesS a_from_<m?strk$ostringlio.TextIOWrappey%dwthasattr, "read"$abinaryRT@ is   Y."9 J"""Assume the nonstate of _Z= get)'_#_ibutes', []for name inj__dict___)!in$ *.I[b=] =b ;\Copy 1$toeofar as possiblf # There's nothing format-specific to explain. Uelse:raise TypeError('Cannot convertFRed type') class MaildirMessage()a3"""T with-properties.""" _b_qc_attributes = ['_subdir', '_info bdate']?def __init__(self, mS=None"""Initialize ainstance0Q. = 'new'  = time.%()9s.)3get} bReturn or 'cur'r"\s\", j d3Setk$if(='(S &;# =?$CValu"_{must be s: %s" %X U_flagsTas a strdAthe / that are sethAelf.p.startsW('2,'Q <O[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 , in seconds since Yepoch E u~,b s.?try9_y = float( Lvexcept  @ Y"can'U-\` from >} 1GetOw@'s "*'" Ff+g#g%fom """Set the message's "info" string.""" if isinstance(','%):")`self._0 = Jelse,raise TypeError('0 must be a^ing: %s' % typw1)) Udef _explain_to({,"""Copy Maildir-specific state to4 insofar as possible5,YMEz&.set_flags%.g!)),0fsubdir12Fdate0.*ell, _mboxMMDFf = set](^if 'S' in  !sA.addJ('R'0if " == 'cur'QOQ/'TDCFCFCRCAC<K rom('MAILER-DAEMON', time.gmf/MH4?notPsequeQ{'unseenP6LrepliedMMgMA_BabylD^olabel(AIYdeletJoanswerKP KyforwardLEpassl0Canpconvert);!edS& m classq(3"""` with P- or properties_r_c_attributes = ['_from'] def __ini t__(self, message=None):  """Initialize an mboxMMDFM0 instance."""6S.set_from('MAILER-DAEMON', True)-Tif isG(, email..o@unixc$ =T.get_(e.4if  is not E and.startswith('From 'tJ UF[5:]rm.__inih!) @def m"""Return contents of "Z" lintr,xb , m_, time_9Setf, formatting,`appendC if specified"ifen[I" "c=I0.gm  += ' ' +)1asc*_." =%Olagsas a str@he f/ that are setget('Status', '') + (X-e,q #the given!unset all others=( #_G, xsA = '1forsp in ('RO0%if#U d!+=/cg<q.remove DFA  A''.join(sorted&s):tryreplace_header9+Eexcept KeyErrorQ?addM %P (   @(s) out changum!etmU{es()) |7'))95 UL[4if HvU or 'Aags(''.join( set(self.get_flags()) -  ))) def _explain_to5, message):$("""Copy mbox- or MMDF-specific state to: insofar as possible."""Pif isinstance(p, MaildirM1s = Z*if 'O' in 4q.set_subdir('cur')GFG1addf?('FCACRCRCSCDCTC4del ['Ius']. "/x-$pmaybe_d-= ' '.joinurom().split()[-5:]?try [(calendar.timegm(P.strp (,'%a %b %d %H:%M:%S %Y'T@ except (ValueError, Overflow_8Epass/el&_(a dy 0])/MHoR' notpPseque={'unseenyLrepliedM MgM (& "J_Babyl^olabel(zI]delet7JmanswerK `;} *seraise Typ'P('Can pconvertXjed type: %s' %  type(message)) class mboxM!(_ 3MDF): """Q with3 -specific properties."""X#MH4(M/MHK}__n_attributes = ['_sequences'] def __init__(self, S=NoneZ"""Initialize an instance,M.q]s.{)6getD Return a list of  that include the r@ '[:s,f 1Setj$ ! =(5add 5Add1 toR (#1ing %Tif isW, strmfif notq;in $, !u.appendg)5Jelse?raise TypeError('+ must beq: %s' %[QoremoveTR,Afrom=]:try xcept Valu HFpassI_explain_to0"""Copy ePstate9/ofar as possibl -6, Maildiru1set.)2if 'unseen' e *.ubdir('cur'P\<*{flag('Sb?gedMFM_repliM!RM/el+$'RO 9 8es:  message.add_flag('F')  if 'replied' in sequences:',MAMelif isinstance(.R, MHM)S5fornzulf.get_(2 )( _BabylFs = set(seb=ounseen<slabel('9R SansweredEpassJelse)raise TypeError('Cannot convert to specified type: %s' %S6 (/)) class (3"""R with+-zc properties.""" }_f_#_attribute1['_As', '_visible']9def __init__#, W=None"""Initialize ab|Q = []3 = G(..)S Return a list of *t on the r3/'[:-3setp,S x1Setawp! =(~{ z2Add dW, str]iB O3lf. K.r.appendp must bxcstringzU)bremove,R&/Ofrom:try except Value B-%5""", representation=r header0=`.KG$#,  O9Y) def update_visible(self): """Update and/or sen)qy gener set of C headers."""H3for@ in e.sg.keys(t{+if/ Ereplace_}(,j[ %])?NelseU1del4=< ('Date', 'FromReply-To  CC Subject' i=not/ ! = def _explain_to, message """Copy Babyl-specific st$to2 insofar as poseif isinstance(h, MaildirMxalabelstR.get_*()if 'unseen'(%!y.set_subdir('cur'M<*add_flag('Sbforwarded or 'resentbPbiansweraKRK_deletJTJ/el_mboxMMDF;2  B'RO 9 80#DJ$AK{/MHt;?in pPseque "T?ied* { 8(1Apassraise TypeError('Can&convert to specified type: %s' % ( (message)) class MMDFMg(_mbox!):R3""""Q with31-spc properties."""X_ProxyFileEA read-only wrapper of a file=def __init__(self, f, pos=None)"""Initialize a sM#C ._dA = f ifT@ is W30pos2u.tell()93els+/Apos +OsizeRead byt>Nrreturn YFCize,.)k1lI1mOlinep a ) 8tsuOhintUmultipleZresult = []1for*" iw 2.2nd(60if R?notV-&o-= lenK&OJ<= 0"UbreakVc__iterJ =terate ove &while Tru" =0if 0Qyieldv R0the_ition] Cseek<offset, whence=0c_Chang_#if5Z == 1i.lV._pos< # (4Bclos  $+gif hasattr ''A':try <1, ' B1( +ofinallm2deld_tN,Vw_method1"""]$bh using/ :ucE= -1( =s(@3 result def __enter__(self): """Context management protocol support."""3preturn I da3xit`g, *excf,.close()4readableau._file.*>Owrit>*>Oseek>*>_flush'8@property4dGif not hasattr1, ''S)ATrueU?E2, 'qFFFalsG[|d__class_getitem__ = method(GenericAlias)  _PartialFile(_Proxy P"""A -only wrapper of part!a x'inxf, start=None !op d!`"""IniYize a ?.__f)U({" = !op"opDAtell Rb the position with respect tod _! -!._, offset, whence=0VChang,0sib or stop#if]V == 0A0pos$4elfE = 1\)elU2U%op=XTA_DQsize,_  EPRead $ bytes using/p, honorN andH`remain%=%op5pos6if .U q*=Vi[7 _L# do *not*  +punderly(@ obj,1forB1ial@%s,# since it's global[MsmailboxE2/if3del1 )AlockLp(f, dot=q"""Lock# f%f@dot 5ingWF_done = try: if fcntl: :try(.lockf(f,7.LOCK_EX |9NB)Oexcept OSError as e_if e.errno in ( .EAGAIN, ECCES^ROFS)Iraise ExternalClash|!(' :  unavailable: %s' %I jf.name1?else`if dot @pre_+ = _create_temporary(A + ''?z.close(!)eturn # Without write access, just skipEing.+=[,G.os.link()/, Z=_done = True(Attribute, PermissionPos.reH^os.unEFileExists ,Jmove M)-?dot/w"UNHU def _uns_file(fA"""U  f usingPf andAB1"""if os.path.eh carefully(ZC" aif it doesn't open for readJ@fd =-f,O_CREAT | DEXCL RDWR, 0o666 'rNC'rb+egfinall0#osd3fd)!based on *!kC'%s.s' % (path, int(time.o()), socket.gethostname(D os@ pid())) def _sync_flush(f):'"""Ensure changes to file f are physically on disk.""";"f.K)if hasattr(os, 'fm"')f1os.0(f.`:no(XcloseC0, euing all "f.h ) class Error(Exception"""Raised for module-specific e4s FNoSuchMailboxS%OCThe ABed m* does not exist and won't be createdgotEmptybi`7`@dele was requesfExternalClashkAnother process cau,Qan ac\F8ailoFormatOaappearhave an invali1matO0"""h2cap6handling. See RFC 1524, import os warnings __all__ = ["getcaps","findmatch"] 7lineno_sort_key(entry0# S_in ascendorder, with un8ies at the endBif 'cP' in &y6return 0Dtry[+]<Melse,1, 0 # Part 1: top-level interface.(pAa diary contai6}pdatabasL5maps a MIME type (%ll lowercase, e.g. 'text/plain'K`to a l&of;correspoi!toG6`ies. < collects5u trIGthatAfrom(available^K`FEachs key-value pairs8 cQwhereI@view1@commis stored<Pkey "(1". }Q = {}@A = 0!inK'trmfp = open(3C, 'r e)1 OS})Ainue*fp&@more%, S_readp4(fpMRkey, f4in Jh.items0!ifYC0in r $r[key] =W _4 + value return caps def listmailcapfiles(): """R,a$ of all , - found on the system."""B# This is mostly a Unix thing, but we use= OS path separator anywayK if 'MAILCAPS' in os.environ?Wstr =[7]J)1s =sstr.split(os.E1ep)-Felse`OHOME\Khome4~ U4# Don't bother with getpwuid('_'.' # Last resort![-S+ '/.', '/etc/8<Z'/usr$ YlocalRSs # Part 2:qparser.mCread)@8(fpnIad a`S and `a dictionary keyed by MIME typevwarnings. +('rdeprecated,~0get instead',3 D4BionWa2, 2<{, _ = _m(fp, None)0 |1olineno6 FEach-mapped to an entry consistingA}Aies;9P will8tain moran one suchFif a given ar&? ceU/p.Es-value pairs for thatlq, whereG]@view@commlis stored#Pkey "("~Q = {}Mvwhile 1-` = fp.pif not q: breakEP# IgnHAentsQblank0s*ine[0] == '#' or#.strip()'_rcontinu@next! =<^a# Join@inuay!@B[-2:K\\\nv%,$: u = '\n'-u[:-2] +/(^0key, field0rse (c(1! P nod I ['oCno']{%noZU += 1# Normalizhe3key2'/' for j in range(len(types)): d[j] = .strip()(key = '/'.joiHg.lower&# Update the databaseD0if Gzin caps[key].append(fieldsOelse3B = [/]lRreture, lineno def parse(@"""P one entry in a mailcap file and Wa dictionary. qThe viewing comm.is stored asvalue with "5!",D46qrest of$ produce=-FPpairs2.D1"""82= [i, n = 0, ( whVi < n[=R, i =01 , Is@i+1 # Skip semicolony!ifAV) < 2g`None, 2Akey,d!, ""= =D[0], 1 "2:%P = {'l!':D}S2for:IU;.find('=' f 20.Kf^f#= ?M[:i]7K^[i+1:)1if M"in h# Ignore itEpass[Z'0sl<5"""Separ*v7key.start = i|1c ="[i:if c == ';'QbreakL%el)+\\*7i+2, "1"k[, i # PP3: us82.C|`match(`, MIME, = lename="/dev/null", plist=[]AFind@tch  dR=a tuple contain,+pused; () if no  is found. This mau1vok:Be'test'Oof severalCopies befPdecidQwhichE"y to useJ== lookupdR# XXX code should somehow checkQ needsterminal flagqex3if ;in  = subst(e[(if test and os.system(test) != 0: continue#command = subst(e[key], MIMEtype, filename, plist);sreturn B", U`None,  def lookup(caps]@key=%)entries = []h%if@ in ?*. +"[DW .split('/'% =ps[0] + '/*'6if key is not[e for e:2n e= sorted(,b=lineno_B_key)Xfield 3=[]# XXX Actually, thisUnix-specific0r'=, n = 0, len(owhile i < n Ac = $[i]; i = i+1U@if c6'%'3k== '\\UO:i+1Y&"+ JelselNJ Qa = g%el9s39 @t@ @{@Pstart 5y R}K5 qt":i> %ndparam(T KZTo do # %n == number of parts if Pmulti)/*@# %F;39alternating<#[EsDvD'%' A2res/fi 0 = .lower()=pDif p[:n]E-+am,Bp[n:'' # PR04:  program.(zimport sy% ` = get (!ifYsys.argv[1:]Ashow,uirrange(1JC), 280argNb[i:i+2!if&V) < 2print("usage: mailcap qf] ..."8 = args[0]  file = args[1]  command, findmatch(caps, MIMEtype, 'view', F)=dif notD:]print("No ;er found for", UGOelse=Executing:",f7fsts = os.system(% waitstatus_to_exitcode(sts1jif stsnRExit H? def show;)<0qMailcap=2s:"lfor fn in listm#_Ss(): :\t" + fn3 {Paps: ` = get ("."}eentrie*@ckeyGbsorted% Dc! =[iLeI&K; eT;k;& 8" %-15s" % k, e[k]F' ) if __name__ == '__main__'[test() """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!([]! a,)Wault 3(on Windows,% &values are taken from$ registry) read_mime` s(1one, return a Mpor None import os %sy posixpathqurllib.B try>Cwinreg as _ except Ic0Err? " =` __all! [")@", "g ed MimeTypes",)DLs=5add;d+ Y+l`%A !onZIs" ]*=P/etc/.<hYhttpd5 # Mac OS X /etc/httpd/conf/mime.types", # Apache q"/etc/a5 ,9- 1;2< ;2;usr/local|httpd/c ,lib/netscaper *V /1.A=3z] inited = False _db = None class MimeT:4"""MIME- datastore. FThis can handle information from -style filesF and supports basic determinA0of  Na?qname orEPURL, J guess a reasonable extensvgiven aS.A2"""`def __*__(self,ms=(), strict=True)&pif not 8&edQnit()fT.encodings_map = __default.copy;dsuffix85 <l ({}, {}) # dict for (non- Bt_inv = FGAext,f) in _5gitems(91add0(5,!, eb acommon9se [&in Pread()1A*d >"""Add a mapping betwe an<xWhen thPis aly known, 1new5Uwill replace"old one. T(5 W4YObe added5!to'rlist ofs#If[ is true,G _5 tob[standards, else (As p[][ext] =iFzexts = 2,6C.set&[]v ifD ss_.append(ext)4urlhG1N` which|either a URL o path-like objectReturn value=a tuple ) where type is None if !the type can't be guessed (no or unknown suffix)a stringE0of HAformM@/subU , usable for a MIME Content- A header; and encoding is N=&no!ornjname oprogram ut4e (e.g. compressgzip). Themappings are tdriven. Ee%6cas?sensitive;1*first tried 6 .,n%in%. 6TheU.tgz, .taz5Q.tz (<:!!)5allBed to '.tar.gz'. (Thisn-@ toot%dictionaryf_map.)!Op 0l `%ct' argument when False adds a bunch ofmonly found,but non-standard[%s. 5""" url = os.fspath(url)scheme, %urllib.parse._split 32if 6 == 'data':P?# syntax\ URLs#u` := ":" [ mediat ] [ ";base64" ] "," ' k1A:= [S "/" k ] *( ";" parameter V *urlcharg>:= attribute "=" valuI# defaultsa"text/plain4pcomma =.find(','iZa < 0N@Q# bad!o areturn9, "Isemi|a;', 0,a./>= [:']gNelse4 5if '=' inUt'/' notR'l' y "p# neverSed, s2~P, ext = posixd.;:ext:Qwhile,in self.7, V , +CV[ext])ifk@sn" =S+V&~^* =rV[True" >Q,*elif ext.lower() in types_map: Wretur[ext.low7], encoding4elif strictIONone7~ = self.u[False]aoif extS /se def guess_all_extensions(,,Rf=True)Z@"""G:@ the: for a file based on its MIMEQ!. {Rvalue is a list ongs givingdpossible\EnameGp, inclu41lea dot ('.'). Tv5notK,guaranteed to have been associated with any particular data(Eeam,Lbut would be mappU0  `mC' by'()$Optional `' argument when f@ add?Pbunch@commonly foundnon-standard%s.5""" ! ="qs 5P_inv[-`].get(FU, [])<`if not/ =bU VQc'in*..fnd(ext&83&2,$ng)zg0str% ?T(IK@ canm&!edZa , G2is /edkrFsO PD  36[0]CreadNvURead a single mimeq-format, specified by pathname.  If strict is true, information will be added to8`list o= andard types, else to the $bnon-st(A0.5""" with open(file , encoding='utf-8') as fp:5self.readfp(fp,)Cdef (&, "f=True)LRead a single mime.-% Pfhile 1,line = fp1)()Mpif not  :>Ybreak/qwords =0k.splitPfor i in range(len(4)y[1if [i][0] == '#'+4del,):]cVcontinueM, suffixe=C[0],~1~/7lP.add_`(q, '.' +k_windows_registry(G- ALoadBMIME database from W[ [#Eonly*:regxbreturn Aenum s(+dbUi = 0^6wU9 ^>tryc3 = .EnumKeyt:, i3except OSErrorW:?lse0qif '\0'1in *HRyield% fi += 1L@OpenHKEY_CLASSES_ROOT, ';hkc?@bkeyE/ wEdR su # Only check extensions\p.startsO("."7# raises% q 'Content Type' va_lue mimetype, data = _winreg.QueryValueEx(CZsubkey, 'Content Type')4&ifp!qREG_SZ:7kocontinself.add_(name, strictexcept OSError def guessk4urlZb=True)@@"""G%P the  of a file based on its URL. Return v{ is a tuple (?, encoding) wherUis None ifiG. can't be ed (no or unknown suffix)a ng"th5Aform@/subQ, usable for a MIME - header; and9%nozz program useEt0e (e.g. compress=gzip). The mappings adriven. E;e)case sensitive; "Efirst tried 2,sn%inIfes .tgz, .taz!j .tz (M!!)1all".tar.gz". (ThisRt-@ too0ing dictionaryS_map)!Op 2l `p' argumwhen false addPbunchcommonly found, but`non-standardC!s.1"""`if _dbRinit(rO_db.Y7) wpall_ext3ons0'@list ln4givuQpossi 0ilevp, inclu1lea dot ('.'21"noc'guaranteed to have been associated with any particularlastream` would4Q `2' b>0If }gL&!ed[@,~2is #edZ2\Obut Ac)*+} |Dq extension, including the lea)dot ('.'). The extension is not guaranteed to have beenE.associated with any particular data stream, but would be mappQMIME type `' by guess_(WIf no0canL&aed for@`, Nonereturned. 6Optional `strict' argument when false adds a bunch of commonly found,Jnon-standard!s.1"""`if _db:ainit()'._(,Bict) def4ext!b=True)c"""Add aibetween av and anLWtalready known,BA new will replaceold one. P(19is O0Kb!ed1!to#@lists#If&jtrue, informa W1 toZS 0, e w=*?add") #`files=<global suffix_map,s @encohs>[0ed,t0 = C0# sxat MimeTypes.__' __() doesn't call us again_1if 0 orgcFdb =^ 3fwinreg-0db._windows_registry()z$ ~ B= 9- 0 + 4(: 72_db1for 1 ins`if os.path.isOT i = db.%"-[]#6 &F'R# MakSDB a \variable now that it`fully CSializBmime82try f = open!$, ='utf-8'xcept OSError=qf Qfp(f,+hTgra_p0D"oquicktimeq : 'video/quicktime', '.webm' : 'video/"0avi!"Ax-ms, Igmovie'Ibx-sgi-P!} }-# These are non-standard types, commonly found in the wild. ;y lK)match if strict=0 flag is given toCAPI methods.Please sort$ase too\_H = __default = {-T`'.rtf',application/'.midi': 'audio/ C1jpg`image/=@pict\ 'ct=/ic 1xulPtext/ [D} R_mime6() def _main():+0impmbgetoptUSAGE = """\ Usage: G|p.py [opM!s]$2 OQ--help / -h -- prin`is mesS and exit--lenient8l8p-- addihally search of someY, butN@  --extensionpefguess pinsteadr; More than one` argumbmay beR. """Jnu(code, msg=''z(q) if):5F(msg@sys.5P)e2tryz<Popts,Bs = .(<argv[1:], 'hl< ['C', ' ("']dexceptserror as 1#A = 1&WA = 0qfor opt} if@('-hdz0)el;l;- @e@ gYIargs0v!= _%(I,p3bif not2S "I don't know anything about1", S KDelseCt!p, encod]`'x2:', 4, ' !if __name__ == '_.2__' () Find modules used by a scri usintrospection.""" import dis imp lib._bootstrap_external%machineryVmarsh*oYo#sys LOAD_CONST =.opmap[''] IMPORT_NAME&'] STORE&%jGLOBALM')bOPS = , ' EXTENDED_ARGN$ # Old imp constants: _SEARCH_ERROR = 0 _PY_SOURC1COMPILED = 2 _C_Y SION = 3 _PKG_DIRECTORY = 5$`BUILTI"6DPFROZE7bModulefinder does a good job at simulating Python's, but it can not # handle __path__ modifications packages makeUruntime. Therefore t @ # imechanism waby youpregister extra ps in thi`p for a #uP, andwill be honored. # Noty#isv0appis lists ofa2. pPathMap = {}A A Public interface def AddP1(=Qname,Qd): U.setdefault2[]).append() replacedTR M`allowsto work around # situin which ic injects itself u8@the #30anoqo sys.mls by calling # s("real_=_`", "fakeda) # beF@runnF!.  ^0oldSP, new  [[)4] =+ Q_6_(CS=NoneNP"""Anortlib reimplementc/Gimp.J (our purposes).""" 2 # It's necessary to clear?q caches@p first,$case anyKs are be6added/deleted/m'ed. In particular,JCtest `er.py file tree0ten=2n a`-break|Bway:iD.$.invalidate_"()8fspec =n.?_+A0if  qraise IError("NoG0d {!r}".format^=!),# a# Somem@ial k@.loawxrBuiltin'er`eturn , ("7c", _C_  lmportlib.mac hinery.FrozenImporter: return None,P("", _PY_FROZEN) 1file_path = spec.origin"ifloader.is_package(name)s0os.Q@.dir'(c7), KG_DIRECTORYif isinstance({1, islib.macSourceFileLpkind = bSOURCE/elcExtensionf C_EXTENSIONh$Olessi PY_COMPILEDi se: # Should never happen. SEARCH_ERROR = io.open_codeWsuffix = splitext)B[-1]X , s2, (G, "rb", ) class Module:Bdef __init__(self, ]N=v  +0.__,A__ =5 U: # The set of globalxs that are assigned to in the mFis include<3oseH?hrough starGs ofcPython]s^gs = {}8\CthisMB didc{Wot beCresolved, ie. a from a non- z^ Crepr B = "9q(%r" % -!,)C`elf.____ is not2*zs + ", T9T.T"9T~%)"Ps+@Find '& 1[ , debug=0, ex_breplacs]0if C) %B= sy=d ~?bad" = Rjnt = 0% =7 if  else []A : = ,ifP processed 0[] @Usedging only def msg(self, level, str, *args): "if@ <= .f.debug 'for i in rangeUw.indentI)print(" ", end=' ')o" o0argq Arepr(arg)g !) |def msgin#0 = q1[0]4k7 E5+ 1JN*Bmsg( ?outZ-run_scrippathnameF2, "15", - with io.open_code($j as fpstuff = (""\b", _PY_SOURCEY load_module('__main__', fp 7uff62fil*Pdir, ` = os.f.split'\, ext,@ext(%?extz  import_hook6caller=None, fromlist>7=-1.G3, "T"D", PKPparenAKdetermine_(@|<tq, tailfind_head_packags]7#m B(J$eif not return q pif m.__-*__,tensure_P&(msV{3 PW|in(4, "A"=r3 or2O== 00msgc@ -> "\pv# ='0.__(__Y >= 1: # relative m)M&ifH$N+-=67w!s[E)sassert 4#is (.G Z J return pagrent  if pname.count(".") < level:)4raise ImportError("relative ipath too deep")Bh = ".".join(R.spliy1[:-y]8a = self.modules[=]a sgout(4, "determine_pCR->", ccreturnTif caller.__*__JcassertM< isi\@b'.' in 2i =.rfind('.'^%:[:ii00.__jC__ =~jAQW None @def !_head_package(ZH , )_a.msgin >:h3if RQ! =h.O" DtailFi+1:JelsegHD%""7T Aq%s.%s" % ( , emD(pqfg_($!, 2[Jif q!N  "@(q, )L  ,G! =} !R+B Y R: No #d"P 4+("4B " +)Pload_1tUm = qQwhile 5,s|if i < 0: )@len(-I}! =b[.mEm< @1 mname, m)  if not m: 'self.msgout(4, "raise ImportError: No module named", m )L <+("<L " +> load_tail ->lhreturn m zdef ensure_fromlist(LT, m, , recursive=0)) FuBfor sub inj\\!if j== "*""&aall = find_all_subm6s(m.oif allR$P 0(m,5:, 1T#el:phasattr(7subIR0sub = "%s.%s" % (m.__0__, \64modiv_A(sub6A/, )Yp9kfpath__es = {} # 'suffixes' used to be a  hardcod[".py", Gc"].EBut we must also collect Python extensions - althoughG`we canseparate normal dlls RsU = []W2+= lib.machinery.EXTENSION_SUFFIXES[:>oSOURCE;"BYTECOD=0dir:try0os.zdir(direxcept OSb*@j2, "can'tdirector U9continueRs:Non:S>>A*n = len(& 0ame[-n:] == *L.F[:-nYbreak ifA and!= "__init__2p[mod] =6Uules.keys(.elf, partB, fqgparent<yin(3, "F"B m = self.modules[fqname] except KeyError: EpassJelseself.msgout(3, "import_module ->", m)@Qreturn m2if A in PAbadmAsmo None"orparent and .__path__ isH{C:tryY@fp, y, stuff =CfindJQ(part#L| 4 I lQ m5loa/, (dkfinallZXpmfp.close(?#if .psetattr|1ent+ mHdef L,  file_info)suffix, mode, type = )iWwin(2, "r"n @"fp" thn #`= _PKG_DIRECTORY] package(W4C AY_SOURCEco = compile(fp.read(), 'exec'CelifSY_COMPILEDY @datah&lib._bootstrap_external._classify_pyc(M&{}Jz as exc+ hhraise  " + str(exc rK; amarshal.bs(memoryviewf)[16:]LLD$dO+adHAm.__5_ =JZif co "if_qreplace i|4 )_in_code(co0_%coG5sca; S A_2(M ,  , caller): if na me not in self.badmodules:  [name] = {}'if caller:[*0.__I __K1JOelseE2"-"9:def _safe_import_hook( , f,, fromlist, level=-1)o# wrapper forP) that won't raise IoQError7!iftXU_add_z()RVereturn6try .KXhexcept as msg[msg(2, ":", str(msg)UaSyntaxH-2 s%if(  ubM%)0ull" =+ "." + sub(v3 4 mfI 6continue f6xr_[sub]y?X/z6>0Xscan_opcodesS)co5Scan the $ , and yield 'interesting' D combinationse: = co.co_ BsVconstPoparg[(op, arg)3_, dis._unpack_2(1if op != EXTENDED_ARG]p1i, mJ)`enumerate(s:Tin STORE_OPSMM"store", %!s[O.], if == IMPORT_NAMEei >= 2gs[i-1][0]A2LOAD_CONSTItPV2][1]>+T212"if0: # absolute  yiel d "absolute_import", (fromlist, names[oparg]) else: # relative C (7tyield "+nlevel, ucontinue g def scan_code(self, co, m): { = co.co(:`ner = :.0_op0s$for what, args inpgner(coei!if* == "store" R1, =Mdm.global% s[Y] = 1((elg q Xzhave_sta 0p%if is not Nonem-0"*"){(,w D` = [f f[ != "*"]D_saf`_hook(Y8, mt.=05if  # We've encountered an "  *". If it:a Python module,`# the  has already been pars`d we can suck out5OU.$Amm =if m.__path__Ais pointdon't know whether '~' mJ2sub# of 'm' or a . Let's just tryNPAfullo first} :h`s.get(__ + "." +M1C1m&'jfW  [J.update(m`d= s==!._i/__ q(u'm.J B -I!ifFVzkdparentdetermine_(m, level=level)  2self._safe_import_hook(parent.__name__, None, fromlist, level=0) Shelse:  # We don't expect anything 1U the generator.D raise RuntimeError(what) *for c in co.co_consts if isinstance(c, type(co))(scan_cod-mmdef load_package(+@, fq+`, path T!.msgin(2, "="90newJ = replacePrMap.get(s3if 3 ($ =aAm = add_moduleUm.__file__ =B0.__[ ] # As per comment at top of V, simulate r Qadditionseo #+ JPathC, []fp, buf, stuff5fin"__init__", cf:try_B C*, lB5mmsgout0 ->| 1return m{kfinallZif fpnfp.close( MW$. W![s]0 = MxVmKP , lr= q is not # assert'B0ullojP+'.'+0 df> *b"in{excludeeD0G3, " R -> E5dPQ ?AI@%ifD Z1ameys.builtin3$ R(OAP("", _C_BUILTIN)7 Q_(#thG* re `"""PriP or` stdou0istcfound P with%irs, as well-that are missing, or seem to b6"""W(p" %-25s %s" % ("NameFoFile")/ "----", "---c-")) # Print modules foundkeys = sorted(self.).(Ifor key in%s:DimE>Y[key]"if m.__path__=Ap("P", end=' ' Oelse6m6V%-25s" %,file__ or "") -dissing5 mt, maybeCany__(5 (""M0}*:"&@namev [Kr +D@[len= >Rbreak"Pdebug.LprocessedT !J 2$msgout(2, "U %r changQ%r" \8 =% (,&,)I remains un* |od_paths.appe nd(original_filename) consts = list(co.co_)$for i in range(len(#%):%Pif isinstance$[i], typ)04J[i] = self.replace_paths_in_cod=7[i]return co4(T=tupl6U), coE=new ) def test(# Parse command lineimport getopt6tryopts, argO%. (sys.argv[1:], "dmp:qx:"cTexcepW.error as msg\print(msg39# Process optionsdebug = 1@omod00addbQ = []vexclude@o, aif o == '-d's+{4m4 -p- + a.split(os.6sep&wqJ"=  vx,.append(awvide defaultRumentQif nos'script = "hello.py"?lse&P4[0]Set the based on `edirectoryb"=-"[: [0A@.dir'(FM&6 = vW2if L6> 1"&dU@itemUC5 ", repr(,)oaCreatemodule finder its crankXamf = M*F)(t,#, 0argt61:] ifrcontinu;(Warg[-2:]`+.*}%2mf.~`_hook(1:-2], None, ["*"].eOH62qmf.load.t,rmf.run_ $e$(*p mf # `"-i{ging if __j!____main__ ^6KeyboardInterrupt]MD\n[i ed]") """An object-oriented %face to .netrc 1s.""" #Hk1docam by Eric S. Raymond, 21 Dec 1998  os, shlex, stat __all1 ["qP", "NzE "] class !(E93ion2"""ion raised o4n syntax errors in the .netrc file.""" def __init__(self, msg, %name=None, lineno !):9=0.*! =Z5 !<# =E Pmsg =sException.!) '3strreturn "%s (%s %s)" % .m !, ) class .q & default_:@ is D5!if(aV = os.path.join( expanduser("~"), "%")\hosts = {}[macrowith open(zz) as fpTa_parse%P, fp,8)5E/alexer = shlex.6(fp #.wordchars += r"""!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~SCcommenter .replace('#', ''vwhile 1R# Look for a machi#@, or3top-level keyGbsaved_v . (2topEE= tt)get_token(Vif not ttYbreak[elif tt[0] == '#'52if /( and len(tt) +wCinstream.readP *continuea'qPentry%PP '' Pdef':# Just skip to end of"sN6.g.[:m] = []Zwhitespace = ' \t')n_5<!or{O\012x3N\r\n1-.append( J4.se)praise NcP-E|(^VU"bad 0 %r$tt6#no`;# We're looking at start of an entry for a named machine or default. login = '' account = password = None&self.hosts[entrysi] = {}'while 1:talexer.get_token()' if (tt.startswith('#') or*Uin {'', '  macdef'})A%if!%(Q#, A,KGCpush/tt-_breakOelseraise NetrcParseError(Ip"malforF1%s  %s terminated by %s"E % (toplevel,D%, repr(tt)),? bfile, "nlinenoPelif K1= '~'_user',# =^ bTVfW`if os.: == 'posix' and _n`prop =Efstat(fp.[Nno()Q1 rop.st_uid !@getuid(<7import pwd ?tryH`fowner wd( pwO)[0]g except Keys'g%s' % qm  os)?qo : Q("~/. j (%s) does not match@ K " current Eb") % (,J IN (umode & (;.S_IRWXG | /O) F#Daccess too p`ssive:gess"  " permissions must restrict access to only" A" the owner", file, lexer.lineno)Apassword =-get_token(1_else:Graise NetrcParseError("bad follower V %r" % tt,H ?def authenticators(self, host)"""Return a (user,^dount, ) tuple for givenE6.""z!if@ in g.fsfrg[%] elif 'default'J7O QNone v$__repr__ ADump:class dataLformat of a .nW grep = $?Eg.keys(z wattrs =L -%a+= f"machine {^}\n\tlogin {Gf[0]}\n;2if *1]XP\tacc J1J-/.2.UmacrosW0mac{, T S[.3o"(/rep if __name__ == '__main__'>aprint(()) """An NNTP client Bbased on: - RFC 977: work News Transfer Protocol*2980: CommoYQExten#3NP (ver5 2) Example: >>> from nntplib import('news')aresp, !Vprst, la* .group('comp.lang.pythonA7 'G%0', 6u, 'has'W'articles, range'jB'to'p!) B f has 51 CP 5770<G58210sub s.xhdr('subject', '{0}-{1}'.5(fi) Qquit( Here '&A' isJ`server`ponse !. `s are ed into except. To post ana:f = open(Warb') #% containingD, includaheaderIs#(fFor descrill method1eadcomments8code below. Note that@ all arguments and return values representing article numbers are strings, not >, since they are rarely used for calculations. """ # RFC 977 by Brian Kantor$Phil Lapsley. # xover, xgtitle, xpath, date methodsHKevan Heydonc Incompatible changes from 2.x nntplib: # -commandsencoded as UTF-8qPa (us!the "surrogateescape" # error handler), except raw messageMPOST, IHAVE)response/deOARTICLE, HEAD, BODYe`file`9 to various~is keyword-only #PNNTP.#()i0s aetime object*newgroups()?`newnewHtake?1(orL)I,~rather than a pair of ( , w)Z$- ezElist0 a LGInfo named tuplesqdescrip@ict mapp@pBsQ5K DUdictsMSfieldM(header orPadata f(p; each I wGview*2(),:mEbodyD a (2, AP:9\g"internal"have been marked priv(mnow start withan underscore)OK/3.1utomatic queryof capabilitiet conne8get/(;- N&Yhelper func6 _\$er(L!poi!cc$ilVs, bytes-likV&rbitrary iterables yDRlines An extensive test suite :-[BTODO<Gstructured6a (,etc.) everywheresupport HDR Im1s i4 re dsocketQcolle*+#sys try: PCssl jE#_J_ssl = False elseaTrue Ebemail.c 9_&_?9_GLOBAL_DEFAULT_TIMEOUT __all__ = ["!",1 "", WReplyTPTemporaryError", "NNTPPermanentE! yrotocolCData Gdecode_headec] # maximal line length when calling read (). This is to prevent #!)arbitraryG6s. RFC 3977 limits o to # 512 characters, includXCRLF. We have selected 2048 justbe on # the safe side. _MAXLINE =/ Exceptions raised@an ee or invalid responsereceived claso(P!):y"""Base (for all nntplib e~1"""0 def __init__(self, *argsOc.)G(2try O. = X5[0]1a Index? 6'Nowgiven' QReplyG( """Unexp[123]xx r1HpassNPTempoOHR24xxsD @D5DnCR& does not begin with [1-5]W6 inrJdataK # Standard port u"bydservers _PORT = 1194SSL0563numbers that are followed by addi>al text (e.g. article) _LONGRESP = {h'100', # HELP1CAPABILITIES$21LISTGROUP (also^`multi-]c")<5X<2tARTICLEgHEAD, XHDR2EDBODY4pOVER, XtB3sdNEWNEW3s1NEW8rXGTITLE }Default `d valu r  VIEW.FMT if0sup ed _DEFAULT_'_'1= ["subject", "from@datemessage-idreferencesC:byt !s"EAlternative names2/in _ALTERNATIVES?qB': '{'&'~ ,3Lterminators (we always output P, but ac s any ofCR, LF) _' = b'\r\GroupInfo = colE.dtuple('$ ['group', 'last', 'fir lag']) ArticleInfo = collections.namedtuple('&O', ['numberwmessage_idQlines} # Helper funw(s) def decode_header(a_str):~"""Takes a uni+ string represent a munged Aa valueA3andd`s it aJ(possibly non-ASCII) readable<A."""@parts = []for v, enc in _email_ Eif isinstance(v, bytes!l.append(v.W(lor 'ascii'))/Belse& A*return ''.join(#!) |_parse_overview_fmt(@"""P" a list of}the response to LIST OVERVIEW.FMTrO/metadata !s.0 Raises NNTPDataError if nis not compliant:(cf. RFC 3977, sU 8.4):fmtsV0if [0] == ':'q8# M (e.g. ":"(, _, suffix =Z@1:].iN(':'6 z! +PeG(Subject:" or "Xref:full! =gv.lower(__FMT_ALTERNATIVES.get(&,A:# Should we do somethAwith:?4fmt/QKadefaul_DEFAULT>en(fmt) < len(7br -("so short]if fmt[:_T] != mNl0defWCs fieldsra?fmt, , q_process_S=None oQto anMX|m`accord tog[ format `fmt`$n_ ?en(J Q = {}a_, *tokenE.split('\t 3z = int(`1i, Venumerate( 1 >={ MP# XXXP"@an e ? Some servers might nKot (# support LIST OVERVIEW.FMT and still return additionalHheaders.continuefield_name = fmt[i] is_metadata!..startswith(':')5f i >= n_defaultsGnot P:4c# Non-4  s are included in fullthe responsP(unless ' is totally empty6h} + ": "if token [:len(h)].lower() != hdraise NNTPDataError(" /X doesn'tO"9'of/T.s"" =[5:] el*onfT"s[9]?-overview.append((article_number, @)r5 def _parse_datetime( `_str,  b=None)h@"""P0 a pair of 2.) strings,p a TNr object;qIf only;!:given, i assumed to beDVIconcatenat%gether (e.g.!toaDATE command)"""u0imem= F[-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. AB tha#~!re_!noDs before 1970 on Usene!ifKV < 70^ += 2000&el)/10*#19*. (T!, %q, day, #, #, )(,un*t, legacy=Fals#rFormat 1 or? asA  in>" fNrequired b4qNEWNEWSNEWGROUPSAIf aHzis passed,\+islmidnight (00h00). HT "ed representa*0 des R flag*1is 1 (+a ,2 haTYYYYMMDD:cHHMMSS * if legacy is True: date has the YYMMDD format and timecHHMMSS.=RFC 3977 compliant servers should understICboth> s;Rqrefore,J$leonly needed when talking to olda1"""?if not isinmpce(dt, . ) _str = "0J5els &{0.hour:02d}{0.minuteasecond"".>A(dt)y = dt.year2if #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-(: SocketAwrap}<-m:F '0use ed!unectionCRsGNew,;{ p# Generaa defaultne was passedI if27Non]O = ssl._create_stdlib_(/./__= ) # The cl)mselves R NNTPp# UTF-8Ocharacter setx1all/3Qmandseresponses:y# are automaticallywo(sending)C2decl`receivKrby thisd # However, some multi-linea blocks canain arbitrary bytes (fo # example, latin-1 or utf-16N in body of a message). Com !ta(POST, IHAVE)N  (HEAD, BODY, ARTICLE) rawUJdata will{ ren _Raccepsproducetobjects!FurthermQ sinc Are c~be non-2outsP# we y'surrogateescape' werror handler(,toleranceeasy round-tripping. TausefulHpapplicasJR(e.g.bways).@encoX@ = '!8'4s 7_init__(selfp, port=#`_PORT,  r=,Bwordg@read"de"<netrc=Fals<.  out=_GLOBAL_DEFAULT_TIMEOUST): """Initialize an instance. Arguments/q- host:name to connect toVq- port: # (default the kdard NNTP.)D`user: kauthenticate with.password: z"us)G2 readermode: if true, send ' ' command after@AEing."-unetrc: allow loadingrWfrom ~/.3U fileKf if not specified explicitly0- timeout: (in seconds)d for socketUions E pis someUs necessary6uyou areB ngw%anFserver onlocal machinuPd intxN5all<-c s, such as `group'. If 5get?unexpecteaPermanentErrors,0might needs>}5"""^Pself.! = ! = r1 = >_create_0et(_6out% f = Non6try* SP.make?f("rwb"X2_base_init( ( if.@r or {M`login(,,5VjexceptE"if _v.close(LRraiseGdef (, 0Par Qation5protocol!EThisD method is extrav up  L0tes&deH i`debugg2:= 0RuwelcomeUgetresp()## Inquire about capabilities (RFC 3977)l._caps{8getC k'MODE READER';to enable 'z ' # However,4order in which dG'AUTHINFO'& # arrive differs between| s.G _sA() failsNz,Coriz0ail], it will se is^WTrue;H5`) rout51rpr; at`a requ(to try agaie# perform' its normal function. 0 # Enable only if we're not already in READER mode anyway. Pself.* er _afterauth = False*6if (b and 'Y ' p1in Le_caps:6f6set@)()"!ifD)% PT# Capabilities might have changed S MODE rDof = Non"Ggetcl5() J# RFC 4642 2.2.2: Both the client(server MUST knowthere isO a TLS session active. AO@NOT attempt to start :JD"ifU%is`6etls_onP# LogOpencryptsetup order is lefubclassesm]enticatedgdef __enter__()Rreture.3xit-w, *args4is_connecklambda: hasattrb, "file"8if 8(P6try[.quitexcept (OSError, EOF UD6pas ofinalln <d_close4create_socketwtimeout3if #  raise Value('Non-blocking r# (<4=0)[supported'sys.audit("nntplib.!",lS.host DA2.CAion( ?,3getwelcome4&a"""Get" message fromIP(thisPsquirrelway by __in&))@!IfPresponse cis 200, posteelowed;s1Yt 201'!al+B."""V9!if`.debugging: print('*r*', repC.){^_N QS: .A, as & %CAPABILITIES comm"ishnP, an Hhy dict=!ed5!is6 .A_ver5= 1E"implementaJ m resp, c aps = self.capabilities()  except (NNTPPermanentError, Temporary)):=H # Server doesn't support u 6"_c){} Nelseh 29 4if 'VERSION' insH*r# The scan advertisTveraled versions,qKchoose the highest.*Snntp_R = max(map(int,[*])mIMPLEMENTATt implementation = ' '.join(L+['W]}breturnI def set_debuglevel(n!, )a"""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""".=21bug6;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\ 2ing .esE!(get_crlf=TruIfromH"* Rae1EOFO1 if7aconnecis closed4sZ1lf.((_MAXLINE +1bif lenG4 > $ -rAData ('T too long'Rh_('*ge!ife": +K< if line[-2:] == _CRLF: pline = Y[:-2]!Belif-1:] inF1FareturnD [def _getresp(self)"""Internal: get a 'onse from the server.MRaise various errors if,>indicates an$As a unicode string."""fJ0 = .0%()"ifdebugging: print('*:*', repr( )7! =0.de|.encoding,V7c4'[:jif c == '4'R!r!NNTPTemporaryE&@5@Permanent@0not&O'123FrotocolE/ /@long , file=None>plus following textR@LRSe,s) tuple where `7` iH` and `rs(list of byvobjects@If `". b-like *, it must be openbinary modeI*PedFil0|:trysc# If aH was passednsa with that nameRif isinstance(r, (str,)/ 2! =n>R"wb")X.#!ifS[:3] _LONGRESP.nIReplj F = [,?"if!islgdR# XXXP0 = $ (Iead?dQterminat= (b'.' +, b'.\n'Y1 wh1z3n(FalseI0Ce\0]breakJp.starts;/.' /*1:l )p.write(/ Nelse =F'C xu+=  if line.startswith(b'..'): 0! =7O[1:]($s.append( )'zfinally`# If this method created the file, n it must close itVif openedFile`.?5() ?return resp,sdef _shortcmd(self """Internal: send a comma `nd get\Uonse.ubSame rzvalue as _gete().""",{A._pu QB">Jlong,T_=None( plus following text+BcmdstringV0() p, excepae@ed `%s`are unicode s rather than bytes objectsw5Ust = ;Y6r0, [0.dec.encoding,IferrorsB1fora in list]getoverviewfmt]V0 format. Queriess`server&no+already done, else5qcached  +trr>7&fmpAttributeE  Epassh5nes"LIST OVERVIEW.FMT"NNTPPermanent# Not supporz2by @? fm2_DEFAULT_tW_FMT[ W 9dparse_(_Q0P8 = V}PgroupV<sC0# Ps into "4 last fir6lagyh [G[`Info(*.split())yP7nescapabilities """Process a CAPABILITIES>.. 3allRn-lysuccessful  - caps: a dictionary mappingability names to lists of tokens E(for example {'VERSION': ['2'], 'OVERp], LISTACTIVE', 'HEADERS'] })S5""" U = {}!resp, lines = self._longcmdstring("CAPABILITIES"X82 in@:U2, *! =#v.split(D)[.<] =rreturn ) ddef newgroups(, date, *, file=None)"""Process a NEWGROUPS command. Arguments4-Saate ortime objectR:: serveronse if suc5ful>- :Anews.(if not isinstance(.)raise TypeError(jA"the parameter must be&, oE"'{:40}'".format.__class__.__6__)`_str, = _unparse_I,nntp_version < 2Lvcmd = '{0} {1}'cm=% 2cmdz5!._(9)s)(?NEWX!: ^5'*'emessage id 66 {2f ?-,d_patternju indicatRwhichQquery-4`: File Mstore the result in  Returns:  - resp: server onse if successful.`list:  of (group, last, firlag) (strings)=5""" 1if ;_pattern is not None command = 'LIST ACTIVE ' +B[?elsC '+, lines = self._longcmd(~&lerG.,8(P!) fdef _getdescriptions(i,", SV_all)K# = re.compile('^(?P[^ \t]+)[f(.*)$'# Try the more std (acc. to RFC2980) WNEWSGROUPS$A !ifU.startswith('215'yQ# Nowdeprecated XGTITLE. This eithaises an errorG"or@eds nT same output structure as A.? '%{}^for raw_2 inqmatch =#.search(7.6p()i61if 9 L`name, " =$.Z(1, 2E/PR'W_ s[y:] =$'if [S}D[Fthing found*J&''"""Get a+ a singleR. Ifvthan one|dQes (''#a )YR/noG0@mptyBing.2QlidesVBcode from ,ce it cantonly be  or '285' (xgtitle) anyway|iFqeeded, use{'s' methodRNOTE:nccheckswildcard3Vnor does}5A whe> actually exists.-.?w, FalseOW2Prangemegroup_pattern, True) def group(self, name):"""Process a GROUP command. Argument/-LR: the QOxReturns1resp: server onse if sucx5ful? - count: number of articles$qfirst:  2& la%$ 5"""O0 = C._shortcmd('11' +)/aif not.startswith('211'}raise NNTPReplyError(oNswords =OVplit(1# =!= 5= 0n = len(F8F > 1N-5[1]F323"= 727!;3;>3>$B4B" 4].lower*rFa, int()  )*D4helC*, file=NonK7HELJICa: Filestring or\ object to storepresult ino.!li%0istl"s *Qed byy!in= to I!Irlongcmdw ('='\_statparse"""Internal: (@linea STAT, NEXT, LAST,ARTICLE, HEADEBODY 2=art_num =&1]message_idy,K&, 4` , / ^*K.M.7c|~.&Ospec L:(lL S id (wVified? rucurrentF isVected. number  - message_id: theS id 5""" $if"e_spec:,return self._statcmd('STAT {0}'.format(sA%))BOelseP1') 8def next(t)>"""Process a NEXT command. No arguments. Rpas for .S?las ?LAS=S1_arq , line, file=NoneInternal: p&HEAD, BODY or ARTICLE7 "spa3s =@longw re0art_num,@%id>,`parse(,:Q, ArticleInfo(MAheadts?, *:3 A7h@Z2: ap numberIP-:name string. object to storeaers inns): server onse if suc 5ful?-Q : S_30 idZbst of \s  is not  cm'b@'' 2cmdObody+(Thl4](@*n96jReturns:  - resp: server onse if successful *- ArticleInfo: (a number, message id, list of $elines)K5""" $if:_spec is not None:% cmd = 'ARTICLE {0}'.format({Af?elsC '_return self._artcmd(cmd, file) (def slave(')`"""Pro. a SLAVE command. RZs.t) 2sho'r'Axhdr, hdr, str, *=Wdn XHDR (optionalextension). Argumenthdr: the header type (e.g. 'subject'-E: an&Tnr, aHor a range nr1-nr2-: FilenameNaing or! op to storeresult inF,-:(cvalue)skpat = re.compile('^([0-9]+) ?(.*)\n?+USnes =longcmdstring('f{0} {1)|rremove_(bm = pat.match! m.group(1, 2)< m z R0,[{A for31 in1s] >Dxovestart, end?OVEp!: -:?|dicts contain0_field$ jH{0}-:%),8< < fm1zP._getviewfmt(% et_parse_*gs, fmt,,DZ!Ife isn't supporteM&alN@backXE.{B7p- eithe%/tindicat~to fetch  information about 2- or a (start, end) tuple, indicating a range of article numbers;N@ ifDq is NonE~up to the newest message will beKretrieved\U{current must be usJ- file: Filename str!orp objectQstoreresult inReturns:- resp: server @onsesuccessful.`list: [dicts containQDufields >QNOTE:"H@id" o isn't supported by XOVER=5""" pcmd = ' ' n self._caps else 'E':if isinstance(_spec, (F&))#ym$ =7Z&+= ' {0}-{1}'.'at5'')7IelifQ1not ^ = y+ ' ' +8R, lines =rlongcmd3Q(cmd,55fmt-getoverviewfmt(%r=$, _parse_*(qb, fmt)def date(O`"""ProZ DATE command..z:Ctime_M0shortcmd(""0if -. 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 excep$0if h!isWallow=3 Cf, (bytes, \array=Rf = f&Sp# We douse _put#() becauseT# - w- wa70ddipal CRLF (giterableRualready #gQrightaim spurious flush() after eachohfwrittep3for6n f'line.endswith(_CRLF): pline = .rstrip(b"\r\n") + _6 4"if,startswith(b'.'Z! +5 Iself.file.write()" 2b"."fflush(<qreturn C_getresp() :def post(g, data"""Process a POST command. ArgumentsD-@ : bytes object, iterable or  containing the articleR W: server onse if suceful"""B ''Sihavemessage_id'n IHAVE  N#: o-id of9GNote that?VXfuses an exception is raised.k  {0}'.format(C_id)\R_closy6try! <N2delc kfinallkMTsock.M0*2qui*T QUITQ and CUR_et. / " =_shortcmd('' +BXSlogin.user=None, passwordusenetrc=True(authenticated` ValueError("Already logged in."pif not l ~Y "At least one`W`X U` must be specified0# I4in/F was/Q but Lrequested,# try to get8m from ~/.7(fPresum!A hasntry, NNRP sequired.P T ifZu^rZ@SimporP@credRals =(7 = 3.?acators}V.host9!if = auth[0]  password = auth[2] "except OSError: 7# Perform NNTPHentication if needed.1kot useWereturn(resp = self._shortcmd('AinfoAA ' + )70if :.startswith('381') QraiseQReply(Zk'Oelse= w UYr 2/Permanent# Capabilities might have changed after logicaps = NonerGgetcV(# Attempt to send mode reader!it was request7# Only do so6we're not inMY al[y:"ifE er$_J and 'READER'N_ 6setJ[RMODE vG@bz eiBZdef _M?trywelcomei)Y' e \!# z 5xx, probably 'mplemented' hTemporarK as rPif e.)Ionse-<480j@# Nehruthorizbefore '6T.IV= Tru-Y Z@if _yF_ssl@@tls(q, context=xe"""Process a STARTTLS command. Argums`6-ST: SSL use for the encryp`connecC9"""  RFC 4642,MUST NOT betc.o Q a @sessPv existsjtls_on QValue ("Z5is Unabled."8X/ed_0canv]M [:lim - 4] + "..."( return s;|0tr(2) -74nb_B + 1Aviewn .x(Lk0forhBnum,!in9author = decode_header(T ['from']).split('<', 1)[0]`subjec?"']@lined:$"{:7} {:2042} ({})".format(V b, 20),P, 42)6nes@s.quit() # Module 'ntpath' -- common operaos on WinNT/Win95 *xbs """C. manipul:,8 dowsNT/95 version. Instead& iming this mdirectly, os and referQ- -`as os.. # strings representaqvarious-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:\\binPvnullenul' g 5sys 4tat pgenericS 9  * __all__ = ["normcase","isabs","join","r@driv Iext"P"basevc","dir prefix","getsizMgetmtime", "getatime", c  "islink","exists","l isdir","isfile", "ismount", "expanduse- 0varLnormpath","abs F2curd#pa `sep","+ 0def B!lt A"ex"devnull","real3supports_unicode_@name#re' Q@same& Hopen1staacommonh] def _get_bothseps(!):[if isinstances, bytes Vreturn b'\\/'6Belse@  # Normalize the case of a w and map slashes to back. # Other I0ations (such as optimizing '../' away) are not done # (this is 1 byO")._(6"""2!. Makes all characters lower1; in1"""Hs = os.fz1(s) ss.replace(b'/',1').(K877'\\6R # R1wheDabsoluteTrivial in Posix, harder on Windows'4For8 itE t starts with a 6 or  (current # volume),!iMAfterj$-letter-and-colon3UNC-resourcz !Xisabs_Test  # Paths beginnA\\?\talways i@, bu# necessarily contain a drive.#W?6if  ;('\'ATrueo c \_Z?'\\YQsplita(s)[1]rlen(s) > 0K@s[0] 0s) Join two (or more)!s.Cjoin*  Y e`sep = I0>zF,:+ UI2HnG'F6try ifE7p[:0] + j #23780: Ensure co"ible data type evenp|Oqresult_#, d7 = path) for p in map(os.fspath, Ws): p_drive, p_ = split9(p),$if&3and 0[0]jJsepsYd`# Seco,ath is absoluteW*[u or not resultZ4"3 = [' %zcontinu'el/!= 8.lower() 4# Different ss => ignore the first entirely$+( ),b# Samed:cas[/ Arelative to $ifiA[-1]_?in - ; +2 l, i`## addBarator between UNC Dnon-jHif (j.1M; g<xP[-1:][colondreturnO0$ +n0* except (TypeError, AttributBytesWarningpgenerict ._check_arg_types('join'0, *%sraise # S! acaspecification (letter fold by a # /ln Ba. # Itlways truaQpec +8 == p def8"""neBinto/Bsharepoint'Aers.Rs a 2-tuple (r_or_uncD); either part may be empty. GIf you assignoH;`2[1]_&Ifmjained ,c will , everythingO upFincluding`x. e.g."c:/dir") s ("c:", "yy,dp =Phost  3butfourth direct>ory separator character. e.g. splitdrive("//host/computer/dir") returns ( B", "$ P Paths cannot contain both a b letter and a UNC path.>1"""Fp = os.fs1(p)if len(p) >= 2:if isinstance(p, bytes)!% seTUb'\\'94alt/colon = b':OelseYX'WV@normp.replace(,Aif (+[0:2] ==1*2)La2:3] ! G# isr ?# v %or C# \\machine\mountpoint\directory\etc\..p#** ^ gindex = .find(sep, 2!P*J= -1 r p[:0], pc2d|:+ 1l#P 't have two slashes in a rowiP# (afthe initial6 _2!f :D\ ,&1[ %:]*"if#[1: J2E2@P # S! a?head (everything up to ;last '/'tail (the # rest). AgPtrail?0'/' stripped,Jinvariant # join(v , S)p holds. # The_0ultN( won't end`unless itjroot. defn#(p8"""Cname Rituple Qwhere_URfinaly Either part may be empty.t seps = _get_0d, =p# set i- beyond p's @8i =yqwhile ipp[i-1] H insSai -= 1B =i`i:] # now'Uhas n9$ moes from XS's alQ!esA"! =)!.rNQs) or%r1d + "extensionm Astar!at\dot in the last # ,pathname component; the root is everything before that. # I always tru9+ ext == p. def splitext(p): p = os.fs1(p)if isinstance(p, bytes26return generic;&._[p, b'\\'/".'XBelsewED'C'Ba.__doc__ = b # RKtail (basei) part of a !!2"""DsVfinal@T1"""@l(p)[1]head (dir7directory 0]#Is a symbolic link? # This will Xfalse on systems whereAlstat doesn't exists isV(dBp"""Test=Dtheri .N for Windows prior to 6.0<6tryy"stiexcept (OSError, Value AttributFG,.S_ISLNK(st.st_mode)} BePdangl salso usefulPl]sQ)#. 0s TqPbrokes,5mount pointAny drive letter(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 (queryreparse tag) fails `most #%mon case:alternatwPwhich{as GetVFPathName #e!if i*SresulauSUBST. from nt import _get& I!+q = None!is'm-s3 (ar, 0, o92ed ):[P2athaseps =_bothseps(path) path = abspath() root, rest = splitdrive"!if%A and [0] in seps:CGeturn (notMa) or (W,oMl AQTrue Vif _getvolumeMname0.rstrip(O) ==8 )e>elsTFalse # Expes beginning with '~''~user'. #means $HOME;  Qthat -s home directory=pIf the k doesn'trn,oi'Gi is unknown, #GAis red unchanged (leaverror reportto whatever # function]bcallede"edas argument) See also module 'glob' for 9sVqof *, ?UA[...SsG&(AbshouldVbe defined to do full *sh-style environ # variab{r.) defdI[3"""~ constructs.!Ifnothing."""h| = os.fif isinstancw, bytes)^tilde = b'~'P 0if up.starts('VUi, n = 1, lenwhile i < nX1[i]d!innP_both7bi += 15if 'USERPROFILE'F3os.4!1[;]#el'pOPATHT A&ryqdbDRIVE'~(except KeyENE'0Qjoin(h, g%])7!Xdtencode(J != 1: #F irA,'D[1:iRc" +">i:];acontai<VshellsubstitukThe followrules apply: #r - noOingle quotes,@'$$'translated into '$'&/%%&0f '1are@seen`%var1%'2%KA${va>}w ac" ed3- $! S%!@s can be made out of letters, digits and the characters '_-' #  (though is not verified in the ${varname} and % % cases) # XXX With COMMAND.COM you can use anyin a variable [,Fexcept '^|<>='. def expandvars(path): A"""Ee shellPAs offorms $var,1%. DwUnknown<are left unchanged."""-| = os.fs if isinstances, bytesqif b'$'c0in BP9b'%2Rretur.jimport string0var2s ={( .ascii_let+7.digits + 1, ''%')OPquoteLE'\''qpercent%Bbrac-{r}adollarA$environ = getattr(os, 'b', NoneFelse%?if VU?O/ED'C'B'A'@3os.6 remA[:0]index = 0 lez1lenfbwhile ,<6lenw1c =[":"+1aqf c == : # nosion within single&s= dV + 1:a$6tryZ. "(c8b+= c + ValueErrorq K o5- 1$3eliIz:J;8or DNfV4 2]Hc5 @=0  +&*= uSG *} v$[Q M#3if s( value = os.fsencode(os.environ[!devar)]) _else:5value = ]Ovar]1except KeyErrorVRpercent + var + ]qres += ;!elif c == dollar: #Liable or '$$'.if path[index + 1: '2]H 48c?9= 1j Obracz4' =>+2:o&len = len(?tryd. !(rDV1 + N9athKv-?$.[!A$if is Non(y/ =r K"+  !P0+.ecEwhile c and c in_chars>+= vmife.d  JU9var#o@-)\6_ return res # Normalize a`, e.g. A//B, A/./BSqA/foo/.*ll become A\B. # Previously, this function also truncatedanames to 8+3 f~t, # but as?`modulecalled "nt"_sat's obq wrong! def normpa th(path): """Normalize , eliminating double slashes, etc.""";. = os.fs Wif isinstances, bytesvzsep = b'\\'44alt/acurdir-.&paspecial_prefixes = (eq\\.\\',qq\\?\\')wBelse ~''{''.4'\\ !if.startswith(AD# in the case o< s 74se  # { -> device names  ?\qliteral do not do any n>ation, but retur[unchanged apart from call toMOK ! =.replace(9R, sep9,& = splitdriv!) # collapse initial back#'epi0 +=|3qlstrip(!@comp%.9Qi = 0&while i < len(4w!ifu[i] or 2== 3[5del$bEelif =WW : > 0 and-_-1] !/Xmu-1:i+1]sii -= 1il]C.end  {El f +ix%!A# If is now empty, substitute .*R.append( +QD.joi def _abnP_fall_F"""R}Pabsolpversion!aTas a BP funcNJ`nt._getfull'`t availaor raises OSError. See bpo-31047 forPRmore.xBXC<Xisabs_(2cwd^getcwdb(h -,"wdUK&C # 5an !R. try nt import k except I [1: #@runn on Windows - mock up somethsensible abspath =* _abspath_fallback else: # use native Windows method on def H(M!):"""Return the%olute version of a 3E."""56tryBFrC@norm-(_getfull Bnamev)Aexcept (OSError, Value Z R% from nt import 5ina, readlink as _nt_ I:#3A is a no-op\systems withoum@ sup."re =aR_deep# These e+ codes indicate that we should stopPding Qs andiK;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 = set(L`while y3cash not in 1GZ.add(1O%S Aold_1= X *# Links may be rel, so resolvem against/irGown location"ifBsabs # If it's so=PotherZpn a symH,*don't knowpP0# wNactually goS"todJbjust rW1oldyr( K-*(_breakBI (join(dirX!),)ap'ex if ex.winerror in allowed_?: ]breakYraiseexcept ValueEcO# Stop on reparse points that are not symlinks^ return path +def _getfinalname_nonstrict()# These codes indicatewe should sresolving thexc# and v we currently have.2 1: ERROR_INVALID_FUNCTION$2$FILE_NOT_FOUND"3"DIRECTORY'5'ACCESS_DENIEH2fREADY (implies drive with no media)SHARING_VIOLA (probably an NTFS pagDHfileE$50ySUPPORT$67"BAD_NET_NAMEremote server unavailabg8EwPARAMETER%12X'l"%92SCANT_Y 'Y'RESOLVE_(S@unfo!  = 1, 2, 3, 5, 21, 32, 50, 67, 87, 123, 19201%|BNon- algorithm is to find as much oftarget directory!as!anAjoin2Fresttail = ''9BwhilD:try. =T+" , A) if 0 ely7.!OS.exVif exEI3|Q OS ck!is fully, so}attemptNab ourselves. IfBsucceed, =(;QkDnew_@readsQ_deep05if 7!!=)6 j#f4to (), let's keep traversingf>pas , s = spli B # TODO (bpo-38186): RequestPreal RMAfromtory  0# entry using FindFirstFileW. For now, we will return the path G# as best2have it !if= and not name:&.ok} + tail' = join(I,'A) if Q elseb:U9 def realg()p = norm 6if isinstancew, bytesB(prefix = b'\\\\?\\'D Nunc_$RYA*):=s# EnsurBnon-,!ed resolves to2?sam  .ifG(F 51 = + +?0# I}e path does not exist and originally did no, then p# strip prefix anyway.+ if ex.winerror == initial_:4npath = s!qreturn  # Win9x familyearlier have no Unicode filename support. 2s_u#_#s = (hasattr(sys, "getwindowsversion")nMsys.:()[3] >= 2) def rel(, start=None)B"""Ra+cative Q of a 1"""Eq = os.f9V)if isinstances, bytesisep = b'\\'4acurdir.&paBelse7KJ'2(IQ'..' v"if@ is U2 = .)raise ValueEwA("no) specified")@r 456tryU0_ab!"ab`@norm{()6/th,1+;c_driveQ_rest1lit`Q c,6j 50if CcaseTBF) !=7X+on mount %r Q" % (F< t'l= [x for x in".split(sep) if x]h`<c;# Work out how muchn"thKBshared byUi = 0`e1, e23zip *e1+e2-1Ubreakubi += 1@rel_jB = [] * (lena)-i) +-6[i:]t (qdjoin(*except (Typ,, AttributBWarning, Deprecationpgeneric._check_arg_types('~'}H j@longcommon sub-^ sequences given as input. # TH0uncH-insensi'separatorp', i.e.the # onAfferwbetween twsause of '\' versu0s '/' as separator, # they are deemed to be equal. # # However,* returned path will havestandard '\'d (even if$P # gi?Ps had alternative[) andgdcase oORfirstZ!inSsequence. Additionally, any trailingis # stripped fromF . def common(s): """G$a |#s names,=sZslongestNP sub-+Q.""" PRif nosbfraise ValueError(') arg is an empty"')Ucs = tuple(map(os.fs,E4s))~@isin"ce[0], bytesep = b'\\'84alt/acurdir-.Felse3I'H2'.'6tryGdrivesplit[ (p.replace(,).lower()) for p in]C_#R!p.B(sep4"d,7f"s]  isabs, = set(p[:1] = pM;gexcept "Can't mix absoluteP2rell"")FNone# Check that all letters or UNC+ match. The c5is made onlyH# now otherw`type es1mixPtringdna would 'beNucaught.pif len(WdQLo) != 18 Paths do>2ame"Nu<y4v! =K[!![ccAif ccb|As<bsb< 1 = min( s2/ax_1i, enumerate(s1?L!= s2[i]=86[:i Ubreak@ f D7'1):prefix = ++2 Sf) 80b.join(m%B(Typ, Attribut pgeneric!._VP_arg_5s@', *%sc try: # The gXenericpath.isdir implementation uses os.stat and checks the mode # attribute to tell whether or not0f is a directory. @@Thisoverkill on Windows - just paswGto GetFileAt{sLu@from"rev ntRort _adir except ImportError:a]Use g99,sed abovf """Convert a NT 1nam.a file URL`vice versa. module only exists to provide OS-specific c for urllib.requests, thus do3use0ly. # Testingdone through test_NP def[2R(url):"""sBga relativ of 'r' schemJ3to asystem*;recommended  alC."""2e.g # ///C|/foo/bar/spam.foo*3and ):)byUC:\foo\bar\Ri string,(Dpars<`itselfs ":" even insPurl =C.replace(':', '|')!if0'|'82urlLPNo drj2er,Bcbslashe/3i[:4] == '////'Q"#`someth+@likeb`/host//on/remote>$# ~tPto \\9\9B\on\9 9@(not@halvy3of 1 atHcstart UQ&xNE[2:]]componentsksplit('/d:# make sureq%toequoted&:-t`return1.un1('\\'.join(); "le2) != 2 or /q[0][-1]#in|.ascii_lettersep = 'BadlP: ' +@raisR(0P=tr.upper( L K[1].P# =Q+ ':'x2G!ifvL + TpS# Issue #11474 - handPsuch as |c/|!if.endswith)7url#/'!+=F > c2url(p;<'  Rn V<r general use.""" # e.g.  C:\foo\bar\spam.foosbecomes ///C:/foo/bar/-import urllib.parse7-First, clean up some special forms. We are going to sacrificDthe additional in8aq anywaylif p[:4] == '\\\\?\\':p = p[4:]1.upper()99UNC7;k'\\' +B!elD1:2] != ':p9 raise OSError('Bad path: K)`if not<V in p# No driv0fier, just convert slashes and quote +2nam:#1 is thlike \\host\\on\remoteX#@this@////7/7B/on/77(notice doublr&oftstart of N*wF[componentsp.split(>ireturn.8('/'.join(F)8Qq:', max_"=2$Rif le<) E2 or[0]) > 1e< =  8/!) =4[0] =[1]c0///Sd+t@for ;P!if0ath71+ 'YxP # Copyright 2007 Google, Inc. All Rs Reserved. # Licensed4PSF under a Contributor Agreement. """Abstract Base Classes (ABCs) numbers, accord to PEP 3141. TODO: Fill out more detailed docum!onoperators from abc CABCMeta, amethod __all__ = ["N", "Complex ARealo Integral"] c ;Q(meta=q)$ll inherit 5.bIf you@wantzcheck if an arg xdaV, without]0carV what kind, use isinstance(x,)q__slots(8`ncreteleric types m6aprovid$ir own hashyl8 __[None #tes on Decimal-] amsqfied by, but it shouldKbe registered as a 2@beca+dAs doIRinteree with ## bibnary floats (i.e. Decimal('3.14') + 2.71828 is undefined). But, ## abstract reals are expected to interoperate eR1 + R2 should beGe4work if R1 and+are both Re). class Complex(Number): """ bs the 0ion1at f!onbuiltin cPq type. N Inrt, those: a conversiAo8, .real, .imag, +, -,F *, /, abs(), .conjugate, ==,$!=p@f itngiven heterogeneous arguments5doesn't have specialoknowledge about m,Xtfall back to E as describeAlow.2""" __slots__ = ()@amethod1cdef __as__(selfReturn a instance. Called forsH.gOboold@True[~Y != 0T7Qr4 prS!tySP"""Retrieve}$onent of this n8T2sub#raise NotI%7edError $iM[j3addU, oth1"""+5prq 0 + yq23neg G-b6?posb+b3subN-}1+ -GWrX 1. -xX. XD__muV* Tq *q @abstractmethod def __truediv__(self, other):"&0"""" /: Should promote to float when necessary."""D raise NotImplementedError #@abstracr0 / u25powexponent$**?; sPor coxCJbase? **73abs i!Returns the Real distance from 0. Called for absj)"1conjugateS (x+y*i).$3) r1(x-02#eq="==>pC5.register(F) classg('c"""To ,"B addoperatioork on rnumbers. In rt, those are: a conversion, trunc(), divmod,%, <, <=, >, and >=[@also>PvidesQaultsAderived .V; __slots__ = ()B)2Any%ccan be0teda nativecobject@b1/nco@): T|Aatesn Integrala i such that4 * i>0 iffS1>0;q`i) <=  !%ny j satisfyingfirst twon!di5e [Bi) >e j) [i.e. i has "maximal"'A amoWBose]$E/"*awards 0"#K+&_floor3Finv0gret!<=[)3Oceil least Integral >= self."""  raise NotImplementedError #@abstractmethoddef __round__(R, ndigits=None):'a@"""R(sy4 to) decimal places, defaulting&"0.D%If5is omitted or l, returns an Integral, otherwise's Real. half toward even.1%Vdivmo "2 The pair 2 //,2%) Sometimes this can be compufaster than t\%ofoperationsP r p2""""(/):%)@floo  W_Y7Q() ofg/4\?div p /3% i rq  q2/ltm <PA< ons ines a total ordering, except perhaps f/aN3/le=%# Concrete i`} Co$x d e_3lex P9A) ==lex(floatI, 0);* pr#!tyBrealM eal numbers aren0ir .Zonent|+@mOimagm have no ,_inaryp n 0 def conjugate(self): D"""C is a no-op for Reals.""".return +E .register(float) class Rational(&q """.numerator and .denomin should be in lowest term__slots__ = () @propertyabstractmethodEdef x  raise NotImplementedError^`# Concrete i;1 of 'sversion to i.!__,__y1"""0 = /@It'sortant thai`use thteger's "true.Adivi`ratherFn casting one side before 6Ading so:0t rs5hugwt without overflowing.`Integr6nal@ add?7con1int(qbit-strp?ion ___int2int  R?dexTCalled wheneve` index0needed, such asyslicing8@3pow , exponent, modulus=None 0"""5 **,$ %-, but maybe faPAccepe/P argu if you wo suppor,%3-.of pow(). Rtaa TypeORE < 0G yzTsn't X0. O=wise, just~F2described Co^x87= Tlshif0, o"<< !xtru1 <<u3/>>9ru/>>ise NotImplementedError @abstractmethod def __and__(self, other):60"""" &5"""raise NotImpleprq 0 & yq2?xor^9q ^7|9p |7cinvert ~%# Concrete iations of R al and Re 5 6!s.8OfloaRR) == 2int)]eturn#propertyvnumeratorK Integers 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",6! 8Dloca"dcompar;1fre $opP[opmapCHAVE_ARGUMENTjEXTENDED(hasnargs"] # It's a chicken-and-egg I'm afraid: # We'r1ortNbfore _y's made.(ith excep unheeded # (stack_effect is not n) # Both our2eggpallayedc*--Larry Hastings, 2013/11/23 tryDfromHort z.append('!2') q Import\bpass  = ('<', '<==!>d>=') +]  5abs   # unused %b = {} :!'<%r>' % (op,) for op in range(256)] def def_op(name, op): opp[op] = @map["opBC YB0has/.append(op)DOjrelD/D?absD9absD# Instruction opcodes for compiled  # Blank lines correspond to available@'POP_TOP', 1)zROT_TWO', 2HREE', 3$DUA4E5ZFOUR', 6eqN9(UNARY_POSITIVr,10DNEGA:0NOT2dQINVER5!BIpMATRIX_MULTIPLYB6wINPLACE_&7L@POWE1g`.20:QMODUL}~;0ADDpSUBTRAC2 SC2FLOOR_DIVIDi2"GTRUE!7 D8# E9`RERAIS}49WITH_EXCEPT_STA4MqGET_AITe50NEX 5BEFORE_ASYNC_]H', 5!3END FO,5H5F5CT5. 5 ST2SUB6vDELETE_PLSHIF6HRK ANd6X6646YIELD_FROM_"(PRINT_EXP7 LOAD_BUILD_CLASS', 7W tAWAITABL7 TASSERTION_ERR7i7j7 k77l7!LIST_TO_TUP8RETURN_VALU8RIMPOR\G', 8SETUP_ANNOTAQ8QTOPBLOCKR9) HAVE_ARGUMENT = 90 2# Opcodes from here have an argument: name_op('STORE_NAME', 90) N# Index in +V list5VDELET616# "" defYUNPACK_SEQUENC^2( # Number of tuple items jrel9FOR_ITER,3)P EX&4)1ATT25d666Z`GLOBALv7& % &8&% LOAD_CONST', 100"7 Rconstg1has.append(1L$10{KJBUILD_TUPL!10 8#LI38 7"SE46 ?set61MAP$ 6dict entries$10 COMPARE_OoComparison operator e7dIMPORTG"10_5AFROM9)+JUMP_FORWARD71N\bytes to skip jabsp:IF_FALSE_OR_P11) # Target <@ offBbeginningZQ9TRUP_ {qABSOLUT1L *IPOP_D*)7* !#11#j#IS&17uCONTAIN>8) NOT_EXC_MATCH621)SETUP_FINALLY0 # Distancetaddress "FA2Local variable nel&24N<M5MNd? # M&6)RAISE_VARARGS%3Uraises (1, 2, or 7CALL_FUNCTIONI3u# #argsYJMAKE(g # Fla(K1SLI$13HaCLOSUR035)6freM 0QDEREF6.ppend(136) def_op('STORE_DEREF', 137) hasfree.append(d/XDELET080D8) 1CALL_FUNCTION_KWe41) # #args + #kw 3!EX323Flags jrelETUP_WITH%3yLIST_APPEND%5)abSET_AD65MAP7JOAD_CLASS'4cEXTENDED_ARG84) m = 144UASYNC'54FORMAT_VALUER5BUILD_CONST_KEY_MAP##QSTRIN5AnameHLQMETHO&601dp&627dQUPDAT&63DICT_MERG455k"l L#, #, Z, jabs_op """ Operator Interface This module exports a set of functions corresponding to the intrinsic oZs6Python. For example, o# .add(x, y) is equivalent Uexpression x+y. The ,s are those used for special methods; variants without leadand trail A'__'Oalso provided Rconvenience.(!isRpure iPmenta)3theQ.v __all__ = ['abs', 'add1nd_ttrgettercconcat Atain3countOf', 'delitem- eqfloordiv "get#gVi~KiandOi|iJbilshif>`matmulZ1imoi Qindex$ A 'inRinverKoAipow+re Js#Ris_no61sub/6tem5Sitrue"ixY+lelength_hinJlFBcall 1 'nc0neg1not!or!po%sePtruthX] from builtinsyort abs as _abs # Comparison i*## lt(a, b):P"Sametqa < b."qreturn 5e5=62= b7/eq7=77nn!77g7me as a >= b." return a >= b def gt(a, b):!"Same as#- b65# Logical Operations *&#lnot_(aZnot a4Vtruth5RTrue if a is true, False otherwiseQ0e&,`?is_.is8/noW0is \ # Mathematf@/Bitn&a6abs+ _*?add++T?and:&7&7floordivr.//<_index1.__J__()aEvC~~a invert = inv:_lshif.<<;/mod%7%-?mul(*6*6/at9@9@9>neg-"-a/or|c|c/po+c+c?powr .>>?subs-7-:/:?xorp^6^6# Sequence.&:_conca+ b, for a and b ssm!ifahasatt'__getitem__' msg = "'%s' object can't be enated" % type(a).__name__Eraise TypeError(msg)containse0b i((note reversed o;ndsJ-&ycountOfU the number of times b occurso3CA = 0]iif i == b9+= 1 return count def delitem(a, b): "Same asq a[b]."1del9?get95greturn8yindexOfqR%the first % of b in afor i, jenumerate(aif j == biFelse raise ValueError('sequence.(x): x no "')s3, cAC = c< length_hint(obj, default=0G"xan estimate-`numbersAobj.This is useful <presizing containers when buildfrom an iterable. M0If pobject supports len(),result will be exact. Otherwise, it mayNover- or under- by{arbitrary amount. The `!anJinteger >= 0"5"ifsinstance(_S, intbmsg = ("'%s' 0can be,erpreteds1" %C5typf).__name__)'k3TypjBmsg)_7try \2obj?uexcept <.OpassEV1 = F7.__p!__VAttribut[r8e`val = k O50if Dis NotImplemented5i?val'P must9,%?val6< 0a () should 'I,- val # Generalized Lookup O?s *# class attrgetterUP call1that fetchesQgivenHZA(s) [its operandAfter f =-u (';'ZlS f(r)*@s r. @@y, 'dateHgH(I@, r.))Rh.1', Y.last]h]a8g8lY__slots__ '_sh_m__init__(self,41, *0@ if not isinstance(attr, str): raise TypeError('-ibute name must be a@Ying')C`self._4Bs = j "F$.split('.Fdef func(obj2for!insobj = getkK,. )return objacall =Jelset0 + {s8m`gettertuple(map'', J) VN ) /0 in [ur __0__($,%t.(r =Crepr=8'%s.%s(%s)' % b.__class__.__module__,Q>9@quali;', '.join )Oduce I! R itemA1"""R a n@ablej ect that fetches the givenH(s) from its operand.NAfter f =(pA(2),Abb f(r) hs r[2]9g9h, 5, 3?g?(@`, r[5]"3]]__slots__ '_sw1'`Cinit^,1, *0<aif not 0k ,7Yz[=]L<^=D( B,) + ^aobj[i]iWsnf-#)m/re I`method/er2H o%;@er('' . (). After g = methodcaller('name', 'datfoo=1), the # g(r) returns r.3(1.1"""__slots__ = ('_0cQ_args !kw !) /def __init__(self, 3`, /, *)B, **3!):2).\! =0if not isinstanceU,W, strFJraise TypeError('"U must be a9Uing')h0 =  2 = [7objl getattr(obj, j2)(* pb PCreprc^7@ = [%)]".extend(map(*)+'%s=%r' % (k, v) for 3 inw.items(G'%s.%s(%s)F_class__.__module__, 987`.join()LNduceNjr!', zC,) + xJelseLfrom functools import partial8vm~ A # In-place Operations *%0# iadd(a, b"Same as a += b.E Fa?n?&? ?oconcat,a and b sequences1hasa, '__get3__'msg = "'%s' object can'Oenated" % type(a)._!__E 2msg floordiv(//&n f_lshif'(< >?pow?*Poa **=b@r (>>Dsub(a, b): "Same as a -= b."  return a def itruediv(a, b):"%"SC/C ! C?xor?^? ?B trytfrom _operator import * except IRError0pass 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 ddnnd_ __floordiv" __index %2inv"eruPinverRlshif R __moo mo}1mulT0mul%at g"neg __or or"po po1powvpow __r{ a __sub"csub __ C __xbxor __conca Btain{1con __delitemP e __get s Ca!ia#ia bi u iis  {6m iim d4 qirQ'tiu  """A powerful, extensible, and easy-to-use op72 parser. By Greg Ward Originally distributedOptik. For supc , dhkrrs@lists.sourceforge[ mailing  (http:// +Winfo/\). Simple usage exa : [1opt1onP&Hr =  ()A.eu on("-f", "--file", dest=" `name",6# help="write re*FILE", metavar="xqx_quieth ac="store_falsSverbofault=True don't print status meshsstdout")F(!s, args) =dD_ () __versionp"1.5.3""al"['''_g SUPPRESS_HELP[USAGEkValuesOptionContainfer', 'OptionGroupMPars5HelpFormattIndented$ OTitl" 1OptzOErroConflict"_Value2Badcheck_choice'] __copyright__ = """ C (c) 2001-2006 Gregory P. Ward. All <s reserved.?2?Python Software FoundaJ Redistribu' and use in sourcebinary forms, with orout modifich , xpermitted provided that the following condivs5 met: * Ds ofcode must retainReabove enotice, this listEqndisclaimer.7in produceB1thedocumentf/or other materialsnn1Nei7@name author nor{1its2con(ors may be+d to endorseppromoteducts derived fromIsout specG@ pri]rA!n KDssion. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"2ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,u7 OF MERCHANTABILITYp@FITNl FOR A PARTICULAR PURPOSE DISCLAIMED. IN NO EVENT SHALLqAUTHOR OR BE LIABLE `NY DIRECT CIDENTAL, SPECIAL, EXEMPLARY,CONSEQUENTIAL DAMAGES (  TO, PROCUREMOF SUBSTITUTE GOOD_SERVICES; LOqF USE, DATAyCPFITS;ABUSI+ INTERRUPTION) HOWEVER CAUSEDT0ON THEORY OF s, WHETHERG*A PSTRIC|W TORT NEGLIGENCEOFWISE) ARISINGSwpWAY OUT2USE 4IS , IF ADVI!OFSPOSSI3#CHo . % import sys, os textwrap def _repr(self):^ return "<%s at 0x%x: %s>" % (.__class__.____, id(self), self)J # 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_ try: gettext import3, n except I Ef>4def.(message)\sreturn  p2W(singular, plural, n?if n == 1RV<VJT _ = class OptP1 (E$iou__init__(self, msg`.msg =S__str4/63ion =1"""Raised if anion instance is crewith invalid or<inconsistent arguments.` ,] id = str():if @"O %s: %s" % .B_id,FOelseNq7msgionConflict1Xc33ing.s are added torryionValuew,ya vD encountered on the commandMlineABadOGv/ (o>Kseenx tCs0optA% =a!Rq_("no such:1ion:2) %*XAmbiguous Dan a@m 1, possibilities .)/I L* =\UL(_("Xv (%s?)"sw, ", ".join 5)))HelpFormatter:zAbstract base JRfor f0 : 6X@s should use one of the HelpFormatter subclasses for ing help; by default IndentedEis used. @Instance attributes: parser : OptionP controll~%# iV.i_increment : intKnumber of columns to 8 per nestgSlevel:@max_P_posiXmaximum starA_8! o8D texS calculatedV; initially=qsame as *\width^otal &for output (pass None<constructor[mqis valu&be taken from$COLUMNS environvariable)G @curra(4 _ =D (in~%Pavail & (]=_tag : stgk#Zreplace with eachX%'sz`C, "%N" `. SetQVfalse1dis<expansion.L_strings : {# }(d maps`bpsnippetzX  explainingE,Pyntax+Cthat, e.g. "-h, --D#" 6p"-fFILEPfile= _short_opt_fmofkAhow :suUs are0pri6 in . Must be either "%s%s" ()")4%s  ), because thoser;Qtwo s#eaQ }k supports__longsimilar but+=; m-eo=#)2""" NO_DEFAULT_VALUE = "none`def ____(self,c# $t_first) .= # =\11if }" iMf:try0TSt(os.:#['K$']]- except (KeyError, VError):  width = 80 E-= 2Rself.!=  help_position = 0Lmax_\8jMmin(*a, max(i - 20, indent_increment * 2))NqBcurr%,6 =  ^levell`= None# computed laterpshort_first 'default_tag = "%"& op<_strings = {}!_o`opt_fmqk"%s %sGi_long_%=%Ldef set_parser(", !):".# = @udelimitML1if  not in ("", " "#sraise ValueError(o"invalid metavarWzQ for  Ds: %r" %# $F2" +,M + "-Qr9=C) a  X+25mF+= 1< ded-d basserti >= 0, "I2 decreased below 0.2-format_usage!, qNotImpl"ed`"subcls must i"&") csheadingeg8_hCtexte b&""F aagraph of free-H ;p`inclusein theM output at a u.6d_O-F, 11i1 "*;_tareturnwrap.fill(},#} #) sinitialx=4 vsubsequ79adescri5scription:  return self._format_text(description) + "\n" 6Uelse:G1"" Cdef Mpepilog(a", )<#ifO_\n" +Hexpand_defaulto"ifxparser is None or notBF_tag8TR.help5rvalue =Je.cs.get(>Qdest)>3if %_AO_DEFAULT+on #NFf_VALUE.replace<i, str(`"))JJ=", `# The gCS each% consists of two parts{# * the0ings and metavarsH+ eg. ("-x",:"-fFILENAME, --file=";fuser-suppliedostringghon expert mode", "read data from qO If possible, we write bothqhese onxsame li -xH/ h q But ifR3optVP listtoo long1put(Ba second, indented to8column it wouldH`art in`it fitTQfirstU.0/  (/ ,result = []Dopts_"s[ +d_width0)P_posif" - current_E - 2l`if len@s) >P`"%*s%sB!% l.Z0, "6pts?x_T 3@# st:0 as=-*s " ? 0r.appendE if1ion PAhelp A E4PPwrap.(, C EpO[0])Iextend(["%*s%s\n" % (self.help_position, "", line) 1for%A in @2fs[1:]]8elif opts[-1] != "\n":Wresult.append( ?return "".join(+!) @def store_op_strings, parser)lvindent(bmax_len = 0V0optF.bFlistQ+t1 = _lformat6optq6tTBP[opt]G/Cmax(c, len(>2) +current_v^groups/:03? = #++de 95z$inR + 2, * PwidthC!ax.-C#iG, 11W,x7ionB"""RRa comma-separated ! oDion & metavariables."""ion.takes_value(p?# =.P4 ordest.upper<AshorNPs = [%._A_fmtDopt,]@ s^N%s]6@longyxlxw,dwLvJelseo:+e0"ifRFkeyword qto the qructor.'ATTRS = ['!','     1'] _2of %s allowed by o1 parsers. E!ly#edGmhere s@ canidate itscumentsPCTION("store"" _T?tru;OfalsoappendTs_count7gpversion involve $Ping aVus0mew};Calso just forAion. (IfAJ p is one`these,f@re mWPbe a +0ina.5STORE_A $ #$ %)=opwhich ikes sense toypype, ie. 70ume1arg0P from command lineE_TYPEDu   *require* Saalways and line.  ALWAYS_TYPED_ACTIONS = ("store", "append") '%# The set of actions which take a 'const' attribute.9^CONST~_.}%known types for op parsers. Again, listed here(!# }ructor argument validaG80ring", "int"loAfloapcomplexfchoice8!Di.1ary;nchecking fun!#s,Pconvert andes accordGUto th"#DSignature}C is:*! (S1: O\,~P : st ,/%ue) -> anyDwq  9aion isO instance call"hez(er:7dactualLqseen onQcommand-line: (eg. "-aP--fil3# W ] ccreturnMshould be iappropriate Pyth$yp.@ -- an integer if!"== TIf no8,pdefined! a",s will b!un edms remainsg_CHECKER = {F:u_builtinN"+? /R/x^$} _METHODSbaVHunbound method objects;By are by},+order, after allBsDoinitialized. @creaand filledV9latVG$]cually 7. (I just put it;because IGslike to6>2docHXclass4sam|place.) Sub/ePat adqother _D_*()dfV0ir  ""thT^2eirNG<ose from this  Te= None@-- CM/Hf?s -g`def __?__(self, *opts, **R"s)z# Set _short_%_g_opts attrs from 'opts' tuple. -# Have to be set now, in case no option strings are suppliedFself._short_gU = []dOlong/$Pcheck%_p()J!sef $% # Set all other attrs (ac, type, etc.) fr!e' dictEj(%) 0# Cg1theeibutes we justN. There7wlots ofC$complicated interdependencies, but luckily they cangfarmedH0out_C*() methods lisa CHECK_METHODS -- whichIPcouldchandy for subclasses! one thing!seWshareHpis that"y raise OHError if`discov problemS| er :p+((Cdef 5opt.",&s)C# Filter KNbecause early versionk had exactly#a81andA, ei/of T1opt inPsM6optnaif not#AType("at leasto m"Rretur|h*f `if lenZ) < 2H(y"invalidJo %r: "1two characters 0" %Q , ? u(el/==[0] == "-" qpt[1] !Z/ ;oim -x, (x any non-dash)SO)*0.ap V.se H#:2JK2K@N"J start with --, followed bKE*,sDset_attrs(self, attrs): 1for in self.ATTRS '%if#? "0set(Bd s[%])o-1delT! Nelsec== 'default'&\NO_DEFAULTpJ6oneDss = sorted(v.keys();araise OptionError( #"invalid keyword arguments: %s" % ", ".joini-),D1) # -- Constructor ^a methods - Jdef _check_ac@\"ifS{ is Non.!= "store"+elD6not[CTIONRAf@: %r6y,)Otype XLWAYS_TYPED_A=pchoicesb8-s# The "0"Uibute implies " .[= % =/ )'A# No^ given? Pring"the most sensible !stGr# Allowobjects or builtinconversion funsT$# (int, str, etc.) as an alternative to their namesif isinstanc4.P,mr 0.__["__(Q! =%*r"q'G9 IW HRLo QOC{ } aQ"mustXsupply a M ' list of _t" '+'"~ elif not isinstance(self.choices, (tuple, list)): raise OptionError(#2"Q must be aR of strings ('%s' supplied)"H%/J(typ)).split("'")[1], )CAelif is not None"?$y @for b %r" %qdef _check_destpYP# No 0inaU given, and we need one l`his ac'a. Theap#} l3callbacks that takevalue.>!s_1 = .g2 inZSTORE_ACTIONS or<~.3r"): ]# Glean a&from the first long o2King,E;or 4Zshort5h if noNs&_qZ_optsN$ # eg. "--foo-bar" -> "foo_ /2=k\ [0][2:].replace('-', '_'PA;elsWX"1]g>conUCONSTuG, #q'D'>G%be* x )Qnargs TTYPED 2O.$5= 1*'D3HJ6 D== "+".4abl3*'o^:7#if%_7 FB!, KE* Pn/,Yg:/%rGelf.callback_args, self) @if (.callback_kw, is not None and5@isinstanceD, dict)):=raise OptionError(#d" , if supplied, must be ah:?%r"K% Jelseq5elf9 * (%r) for non-! o" ;Szb/ ? CHECK_METHODS = [_check_ac,$b $Otype" _choic$ OdestF /on# nF "] # -- Miscellaneous methods -Jdef __str__return "/".join._short_opts +Q_long)T__repr__ = jtakes_valunA!ge|1ingDK d$5[0]+\ 45Processing2---J"",_!, 'Ber =QTYPE_aER.get.GI4if 6!is3jKi gonvert )~"if+Z == 1 $y4opt@0Fqtuple([*MBv in]p  s, parser):* # First , convert the value(s) to right type. Howl if any #3are bogus.O = self.h_R(opt,<%) 0P# Andyn take whatever action is expected of k`# This"a separate methodmOlife easier forwsubclasses-sadd newvbreturn_(J,+fdest, s, parser1defVI,/, E:1== "store"atattr(s])G/elIo_constO/stT ?truOTrueM OfalsNF*Okappend$s.ensureB[]).3WY J_YOcounso0) + 1callback#Eargs#_For (O!kw#.Uor {}0'( YQ0, *WB, **Ju KhelpDp.print_  Gexit Yversion\ #E_*sepraise VError("unknown3b %r" %heQ1 # 0 Opc SUPPRESS_HELP = "0"+"""[USAGE#2" V"s:__init__defaults=None)4if fDEE) in)w.items(F1"se0>3strA'1str.__dict__J__repr__ = P#eqOw, otherVif isinstance(,s&@|2 ==R"[Y return self.__dict__ == other Uelse:return NotImplemented # def _update_careful(self, _)H1"""1PU0 the option values from an arbitraryFionary, but onlyHsuse key8q that already have a corresponding attributeG0in b. AnyQ!inz withoutEare silently ignored.c1for er/)!'if"&ctFadval =[]j1if %is not Non%0setB,w,:)Sloose)n#!us"ll+r  regardless of whe?the |0 or!(.(g, mode!ifi"#"iaFi(elGE !?`aise V|Error("invalid q: %r" % bd_modulrmodname= __import__(-)mod = sys.U#s[#'P(varsF)p %fi  MU = {}exec(open(? ).@(), . qensure_)rI+lu*0has +)gO) is}S class OContainer:Abstract base 2."C>fsstandard__list : [h4of 0#s will be accepted by all in05cesof this parser (intended toGoverriddenI1sub3es)IW   objects cT!l0_sh- op(P{ str: +@mapp&;;:gs, eg. "-f" or "-X", to the Option instances that implement$m. If an-Chas multiple short oOstrings, it will appear in thisB0dic6aryItimes. [1]'_long_opt : { [# :# }&( Mpapping : eg. "--file" or@"--exclude", BAgain, a give/ can occurdefaults?any pdestinaf@ nam#o Svalues for each 5)[1] These m^s are common0(shared by) allponents ofIGcontrollParser, where,y]initially created. E2""" `def __'__(self,_class, conflict_handlcadescri!):N2# Il!izG list and relP datauctures.B This method must be providA sub1es,S!it'B0ialqat leasp follow/ attributes_1, _:%, E,9"._c/1ionC"()f!$_# =$k)Lset_{()4(   For use by+dstructor --YsU main#"us S 7all<TGroupS]t ownuP = {}i# single letter ->ups J) # I sH #s'1 G 3Q 1, p @ Ydas fromOeL.Nq,e# =. *(YT49h#, 3$if@ notP ("error", "resolve"):   raise ValueError("invalid conflict_resolution v( %r" % handler) LUself.6$ =) )def set_descripV(9', !):,Y.( =)TgTG|return N Aqdestroy9"""see O`Parser+U)."""2del`_short_optOlongdefaultsC# --w-adding methods -t_check_1, o es = []0for00 inFion.s if#*p( '+ q.append((opt,Lf[opt])n\ ' ;&if0;opt F$if1` == "e"C NR"tH string(s): %s/% ", ".join([co[0] x coS-?]),ylZ+elb/vencgMion){e.startswith("--"%a$._s.remove 88OelseRB9if not (nF or s6container.T_listAT)3add*args, **kw t7""". opt_str, ..., KA=val4if isinstance({@[0]," =|_class(1lenX)Q1 and *V3 = I/,( 3'TypeError("not an Option instance: %r" % o3) Uelse:raise TypeError("invalid arguments") 2self._check_conflict(e &_list.append)x#.container = aH0for0 inion._short_opts8s[opt] =7Q OlongP OP#ifb.dest is not None:# #p has a %, we needUfaultO4SVO_DEFAULT5!de0s,n. m(elo!st!in1 io1Treturpdef adduPions(,)/)$#TiD# -- query/removal methods -!ge6ionG_str 1.ge,.1 or $._t /;3has;a:S0opt@\> .}:e > M LDValusno such[68J !2del@]LK! J@.E.  Help-formatting( DS_help(te!if^ !""zresult = [BR wr.gSUPPRESS_HELPu. [^b.join(F?adescri0M44ter}>on(self.get_description()) def format_help(self,Qter):&*result = []0if 1.Z15q.append].n3(o)[o__list[3[return "\n".join() class OtrGroup ( qContain9__init__, parser, title, W=NoneL5/# =8V4 q.f"&Cs.conflict_handliI." =_create_`  !]U_sharEmappingsI.Aset_ M p!qdestroy:3c"""seeP+U)."""Y { Q&2del4# -- Help-xing methods -J_D/4tercqheading-vindent(3 +=2X)Z-deZya noCattributesstandardB : [D of 0 s that will be accepted by all in05cessof this z (intended toGoverriddenI1sub'Bes).IW usage : stringw"a  your program. Before it is displayedAto the u "%8"Dexpa&uname of=k WA or os.path.base7(sys.argv[0])).C. ktcurrentS (to KeI qMA`agraphtext givqa briefw@view  @ ry0matK[ito fitterminalwidth and printsAwhen6 requests r (after ,FPbut be8list of options)1. epilog : string paragraph of help text to print after option  ;_groups : [O$G]$` listZ. .pin this}Zser (5are@irrelevant for1ing the command-line, but very usefulA6pgenerat9)allow_interspersed_argbool = truf`, posial arguments may be MS with;sp Assum -a and -b each take a singleZ, -ablah foo bar -bb z#EwillapretedPusame as(KC%--T&baN"Ifflag were false$at l wouldzqk|q-- ie. we stop proces!V as soon&!eeUfirstCnon-bP. (T!is1Atrad0 foUed byAPython's getopt module, Perl's Ga::Std,Uother-H1parlibraries@it i\lly annoy! to5rs._default_value5 54areRed similarly11Afrom.zP: tha1ey V0assio.Ftype-check@funcEt0's ( (as long&th 7a)0reaFonly matu if youhave defined custypes; see SF bug #955889.) Set iIto restorxbehaviourqk 1.4.1earlier.~rl[4Acurrentlc=I`ed. Oset when!()$Rctiveqcontinu#trimmed dowB@w]0nsu$`. Maioe`benefi?callbackl )gleftov? atskipped whilEs. If &isiis always empty1: Vq#of] accumulatD@e. Also m~asLpBecauseu'rargs', 'larVgs', and 'values' attributes, OptionParser is not thread-safe. If, for some perverse reason, youHneed to pJ$ command-line arguments simultaneously in differentEyfs, use nstances. 42""" adard_o_list = []def __init__(selfusage=NoneW# bclass=ZIversionE conflict_handler="error"JadescriNformatter!add_help7O=TruOprogCCepil!):RContainer.}"& \9,, ', )?;Q.set_( 0 =  73 = allow_interspd_args =  ,process_default_j + ifEhe,  = IndentedHelpF(1 (r K2 = 2# Populate the [ ; Lial sources ar%/# ,Y'Z'B<(if applicable):_ ()F$() methods.&N#_pJE(' n= N)XnB_ing_state() %rdestroy-qBDeclx atdone with this?@. Tcleans up!rece cycles so`!(Lall objects 6Ed byL it) can be garbage-collectedmptly. After calling)M pis unus.v DTfor groupslh.I:Hdel <b Es# -- Privs/ --- # (us0ed by our or OptionContainer's constructor) def _create_op0_list(self):#'. _ = []ogroups fmappings(add_help$("-h", "--4%", ac/="' =_("show this  message and exit")version-1*program's 9 number_popul", c  , thGTrue1if standard6='GXs.8)(ifP Xz By C_(@ <9dTinit_parsing_state=# These are set in 0@e_ar for thevenience of callbacks.m]r7z = NonelPvalue5# -- Simple modifier methods -JPset_u?!, "if1 isg3p = _("%" [6s]"(elJSUPPRESS_USAGETC`# For \@ward.mpatibility withSRk 1.3Qfarlier.lower()0rts=!("7: "x" =6[7:^Oelse9qenable_interspersedQfya"""Setring to not stop onxfirst non-p, allowing_fDBches+@comm3arguments. TT is^Cdefault behavior. See also dis)&thclass doclaq descri9Lattribut9/E.""";.)0 = G ~ R. Use%ifyou have a command processor which runs another command that has options of its own ( you want to make sure these3Gdon't get confused.5""" self.allow_interspersed_args = False .def set__default_values(I,!):3.4$ =0 bZSadest, f W) s[$2] =&M@**kwK.update(&L_get_all_F1 = _list[:]for group in)s7;Ds.extend(#.Y)Wereturn%bif not P# Olde-Optik 1.5 behaviourdV!."s)Y&:f.copy(;< [5 = UBget(F.5_0if isinstance(4[, strY-opt_str =w.m7ing.Q's[Rcheck],0 VT") RP# -- 1onGhmethods -J@3add_~0, *B/, L# XXX lof overlap withContainer.\+ g?[0]# =V elif len(Wa) == 1W c/&[0L7..,4raise TypeError("|(an6 r: %r" %/ o.parser is tuyinvalidvr(wrong Q&)"pJelseUQParguments"Us.appi$U9ionhcE1 = p._shortPE) or]_long1#if5o$.cself:   return option.container 3 aNone a# -- O0-parsing methods -Jdef _get_args(self, !):i!if@ is sys.argv[1:]9Oelse.a0[:]@ # don't modify caller's liste=, values 5"""> : [string] = ,3`A : Vi! =)+B-> ($Mh)VParse the command-lines found in '' (defaultR). Any errors result>aJQ to '()', which3by \q printsusage mesto stderr andSs@exit() with an=. On succesvs a pai:1) where 'O'|awinstance (n%llCyourA)CiR! o0umeEleftEover after 0\%s.$Ur@Felf.L#if E_(8b# Stor:`halvesH1arg4 as attributeOr# convenieK!ofVbacks#}6lDrestx (@"r" dy ? "remaining" or "right-hand"1|l| ie. what43eftremovingPtheir="s l$ "tM  K.4 = [8 # =776tryDstop:@_prof"\!, ~bexcept (BadKE<,X)J;errvRstr(err)+4BTcheck $* 6Z JCP that^ suppliedf%over arguments aCre )valid. Returns the option values and leftover argumentsA(possibly adjusted, completely new -- whateJ5youDlike). Default i6gaW' rpassed-inBp; subcl`s may ride as desired.45""" ^" (H,1s)  def _process_args(self, l 2, r9!):3\:"""60 : [string],+/ T+xA : VNP command-linepopulate 'G', consumingq from ' '. If 'allow_interspersed/6' i.false, stop atnfirst non-jWtrue, accum5anymCas in 'z'Rwhile?Rarg =5[0]r# We handle bare "--" explicitly,]C" is-@d by Mstandard*pr since-a shortcase ensure@ Malen of9Bopt lgreater than 1 !if`!==  ?del ; "elRo[0:2] W## W agle longZBwithI(s))k.mCQ_opt(,8s6#:1"len(arg) > 1 clrl*s #`(s) foe last one onlyms%q.append NelseQ #now, leav!is"ingy7@# Sa4 ispriginal1V listq# [arg0a1, ... S(i-1) +!FN-1)#~^@# (wVe about tofrg(i))j#63The7(i)`%a *subset* ofK=0;c] (anyItheir arguments will have  # been removed from largs).$ The while loopQusually consume 1 or more argumezper passVd If it6s 1 (eg.4 is an option that takes noS'), then after _process_arg()Kdone the situaT6is:> " = subset of [arg0, ...,~I(i)]2r/! =(W(i+1),8N-1.8If allow_interspersedscfalse,always b*empty* -- sta W, butnot a very cestingF!! * def _match_long_opt(self,)H<"""'opt : string) -> XDeterminU0ch aW7q 'opt' pes, ie.Vch on  it6an unambiguous abbrevifor. Raises BadO]Error ifnxdoesn'tN"lyO any5"""Ndreturn>`(opt, A.P)j lf, valuesvaarg = c.pop(0L0# V/ explicitly attached tK? Pretend it's&8nex#if "=" inrB0) =#.split("=", 1)0insert(0, : &Dhad__f = TruJelse{~JFm:w=F[opt!#if.(rnBR. qif len(.A) < " He(ngettext(H% "%Sion)s requires %(number)dl"k>FsGb) % {" ":2, """:}{Belif^ == 1)6:57Rtuples1[0:].2del}$I E_("% 8"'7optNone o ption.process(opt, values, self) def _,_short_opts(#t, rargs8!):26Rarg =u.pop(0)stop = FalseUi = 1for ch in arg[1:]Y]opt = "-" + ch6Qion =.@.get.`i += 1 # we have consumed a character6if not oY #raise BadO!_ErrorfAq.takes_(TKV# Anycs left-? Pretend they're #C@next^a, and 8ing\ of&.Bif i < len(argg.insert(0,JJ[i:])j= True^nh$ ="vA) < &P!.engettext(P) "%Sion)s requires %(number)dument",J5sKb) % {"x ":2, """:}n elR?= 1"Oelse? atuple(1[0:2del1( lu#doesn't C" a ;NonkJ!ifA bbreak # -- Feedback methods -J0getag_name0elfPg is return os.path.baseIys.argv[0y E?EFprogkexpand7, s=.replace("%D"v?)adescriG X.=WAexitL, status=0, msg=7 if Hsys.stderr.write(msgp^Xtz@kf2"""msg : string:pPrint a usage mesincorporat'msg' to exit. 4 If you override this in a subclass, it should not return -- it  either exit or raise an exception. 0U """ self.print_usage(sys.stderr)%Z (2, "%s: error: %s\n" % (Gget_prog_name(), msg)) G@def eQelf):1if Aformatter. G0-gexpandb)Oelseq&"" elf, file=None8""")#! :* = stdout PsQ the @ mesA forcurrent P3ramb,E) to'h' (defaulti. Any ocHQce ofXstring "%YE" inJ  is replaced with:FVDT(base)Jargv[0]). Doesh pUemptyH or* defined C 6,=qversion2b dl7m"<o +q1 s+isl'ns*{I), afo |!byz n%'sHk[Q]/unS; .$#()Wo{Q_help;, @&if_ T0terQs.store_s0res3E= []A.append(O _heading(_("O7s")O&vindent(mMJlist z^vContain>Pa OF"\n"ePgroupoXs " formatter.dedent()  # Drop the last "\n", orheader if no options groups:L return "".join(result[:-1]) %def format_epilog(self,Mter)M/ 9.E]Lhelp[W=None`it s ~q = .#U = []"if.ZusageR/q.appendQ.get_*A() +~JadescriP_3(^ b.__JA:v5!Rprinttql, file7"""("! :) = stdoutRPR an extended @ mes, listing alluand any2text proviE@with"pm, to '' (default.B5""" x_ile isb= sys.7cb.write8,)) # class O'Parser r _match_abbrev(s, wordmap ;"""" : string+B : {# :cS}) ->(RK,key in 'q' which 's'an unambiguous ianT. If,Pfoundp5be 3doesn't 1 ofKys', raise BadRError@# Is"re.#acP?J7elsSQolate^:!s 9s as a prefixpossibilitiesT337ord~W.keys= !ifp.startst6(s)u# No exC, so`had be+ be just one yvif len(ies) == 1# (&[0!elatf'ieWD&(sZ z2# More thanle comple^:G C H.sor9!WA]g ? ) Some day,oPmightjCmanyYes. As ofQk 1.36! #9erred wayinstantils is indirectly, &via make_option(), # which will become a factory func* when there are many OE # classes. \$ = Jr"""OS routines for NT or Posix depending on what system we're on. This exports: - alls from pOor nt, e.g. unlink, sta1tc.<os.path is ei;? *Gname*'f'D'nt'&`curdir(Pa strrepresent the current dire_(always '.')J/paJ/paIJ0sep{(or a most common) separator ('/&\\7extIextension 7(al6alternatevANoneP/vw`compon=wused in $PATH etcBlgin text files ('\rn6r\n0defHdefault searchexecutablestdevnull:o0 ofI `devicey@dev/ ',.) Programs t im and use 'os' nd a better chance of being 1 ween diffe:platforms. Of course,`y must an onlyndefined byQ (z,{ o1r),Rleave41athmanipulaj3to  KQsplit<join). """ #' $bc 5sys tat as st a_collecs_abc ?"_check_methods GenericAlias = type(list[int]) _sys.builtin_module # Note: more 05 added to __all__ later. B= [":B", "T  0sep  & ",4 SEEK_SET YCUR",I#0END#fsencode $de @get__c fd Jp" "R"] def _exists(!):|areturn8globals()1o s_!(m}=2tryFJ&.lp except AttributeError?![nn4dirp if n[0] != '_']sAny new`encies2os "/o0gesW: # requires updaC0libwell. if 2in ~N = 'posix' linesep = '\n' from posix import *Atry: %U_exit __all__.append('!') except I]VErrorXApass%{path as   have_functionQvYw0extp_get_exqs_list()2del: elif 'nt' in _names o"nto5linr/nt "`~- nts {"nj'nt/nt"Belse`Xraise]('no os specific module found') sys.m`s['os.B'] =p(curdir, pa0sep !th 0defDQ, ext!aldevnull) .` if jsts("_"")_globals = (wf _add(str, fn0 aif (fn4`) and + k:>P_set.Y{R[fn])c = set "HAVE_FACCESSAT", "access"&RCHMOD% "chmod%6OWN%?own%CSTAT$o "stat$TUTIME^utime%DLINKHn "link$TMKDIR%o"mkdir%CFIFO&"mkfifo&N_ "mkn4OPEo "opeEREAD_"readdRENAME re5SYMM_ "symM&UN&O "un&/rm/N2supmdir_fd = y*Seffective_idVZPCHDIR F%%Dr"sq 'Oscan'EXECVE", "execv e") _set.add(stat) # f always works($ "HAVE_FTRUNCATE", "truncatP(pUTIMENS'o "utim%$%PATHCONFK"pathconfif _exists("vfs") and: # mac os x10.3`STATVFQ)supports_fd =; Es = set(VNACCESSATcaccess# 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 ELCHMOD st6wbe defined on suchH!@. TTis Very Helpful.However, someusbwithout 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$nonYQminimEs pTherefoe simply ignCPdecid%>wheq1os.#s follow_symlinks. Just checkG$ iGsufficient. After all--if you,rCW@almopPertai4J too_! " %6OWN%?own%7$ 9$pLCHFLAG[ nFp1 '3modL1lchLCHOWN",u5;s4INK "r$LF$n+l"NS&>MS_WINDOW mD(s_nks = _set del _set have_functionsgglobaladd # Python uses fixed valu or the SEEK_ constants; y are mapped # to native' if necessary in posixmodule.c # OtherBsiblfz\directly imported from0FSET = 0 rCUR = 1 pEND = 2bSuper Uory utilities. # (Inspired by Eric Raymond doc strings os&his) def makedirs(name, mode=0o777, exist_ok=False):9"""3( [5,][71]) 8-mkdir; create a leafand all intermedi&ones. Works likePJmcept that an:path segment (not jus-e rightmost)Nswill bedit does 7 @. If@x targetalreadyJ+s, raise an OSErrorSq_ok is T.Jw+Pno exRion iEd. This6recursive.V1"""vhead, tail = a.split!ot#v77  _ e s("V6tryc1)X?2_okk*` FileE~s< N# Defeats rac di1 when ano th .j2pash cdir = curdir'aif isi?0ce(w, bytes>(D, 'ASCII'!if@ == o::# xxx/newdir/.|s5:areturn w_WP# Canrely on checking for EEXIST, since`operat asystem# could gPpriorityce  EACCES `EROFSC!a.isdir )Vremov)<"""B!rm#Jemptd  P, 0sucobfully %d,bies correspondw&to$s pruned away until eiqe whole=o(@umedt1an 0 ocs1. @s duN t@latt  har@igno --,y generally mean that a directory was not empty. """rmdir(name)head, tail = path.split"!ifM#:3O7Y`while A andb?6try P.>except OSError0_breakp def res(old, new)P="""1bSuper-; created@ies eecessarydelete any left Works like#, Zaion of;intermediateCtneeded to make the good is attz!edBfirst. After5,correspondingcrightmos segments}Aold y will be pruned until eithqQwholeconsumed or a nonyy$SfoundNote: this funct3Pcan fAwith7newCstructure madN if you lack permissions ZaunlinkNGleafO!orCfileVF"ew*if 1W.exists(F3dir{7}?old}c[emovev*pass __all__.extend(["U", "rX5Qs"])  walk(top, topdown=True, one=None, followss=False,E"""Dtree generatorFor each!in]!y 9rooted ats (incluplitself, but1'.''..'), yields a 3-tupleQF0diry , N &"a string,8w . ?2qlist of*!ofC4sub:M in=X4(ex .I dS `Dnon-ay&s eL0 thb1ame$s are justX1s, "no8`componNTo get a full#(which begins>@top);aq!inw, do os.e.join()PPIf opal arg ''!@truedspecifieche triple fw$ised befor3s4 nyyAits rectories  (directories are generated top down). If is false, the triple for a Py)MWafter2s/ll of itsB4sub?bottom up). ;HWhen3trucaller can modifydirnames list in-plac!(e.g., via del or slice assignment), and walk winly recurse intod bwhose zremain in4a; thisQbe usf pruneQ`earch,`to impQa specific orderUvisiting. M5ingjQ when9top has no effect onz behavioY0os.(), sinc have already beenebEtimeiitselfE. No matJPvalue!ofE ~is retrieved beforb tupley ,By default errors fromAos.scandir() mqignoredaoptional arg 'onG'ed, it shoulp a func6A; itE!beged with oneTu@ OSE instancet{Careport to continueQ)BraisKAexceGTto abI.`. Not+a^@fileavailablk{C!attribut5he k} object#, @ doet follow symbolic links *osystems that supm.nlPto geality, sW" ''0Cau: if you pass a relative path9wtop, don't changavcurrent work twQresumsLa neverV $e S'PduQ,0cliz|"n'ceitherExample:Brt o 80os.rt join,k2sizProot,;0s, ,sQ('python/Lib/nAl'):bprint(@P"cons", end="")(psum(get|(9!)) })HP"bytet", len(.U"non-Sif 'CVS'aFdirs.remove('C) #@ CVS%ectories """ sys.audit("os.walk", top down, onerror, followlinks)=return _7(fspath(top)=C def7l:mdirs = []:non_%# We may not have read permission forin which case we can'tFget a list of the files directory contains. K?always suppressed9`except then, rather than blow upaFPminor soen (say) a thousandddable ies are stillHleft to visit. That logic is copied here.12try.`# NotePt sca5global in this modu!ueB9to earlier import-*aLT_it =YJA*@ OSEA as $ifFNone c(;r hDwith~6_it@while TruT Nentry = next(%StopItera%"Qbreak<,)4,<D is1 = .( T# If :P raisn,2sidJtjy is -5# a/y, same behaviou0os..isdir()@ = FalseMi.append(Kname+lsuU= if $# Bottom-up: recurse into sub-Qy, but exclude sym9 tox#W(if?,* (,= {e5;3is_ 0 $N K#CHa`bolic   # os.path.islink().  `is_sym& = False+walk_into = not 7 05if /:dirs.append(entry)P# Yield before recursion if going top downa ifqyAPtop, kP, non a1# RX!e sub-directoriesY'E, join = Y, .0forp0namW sO@new_D! =R(2)G*# Issue #23605: is used instead of cachingH`() result durNhe loop ong0sca,() becau # the caller can replaceB!y ua""Zaboveif followCs ort(@)W1`p from _d,,, onerror,bwFelseT2 ingJ/B_afterbottom up``st__all__"-") if {open, stat} <= supports_dir_fd and { '2fd:bPdef fYE="."U=True=None, *!s=1_fd'C"""Dy tree generator.6 This behaves exactly like(), except that it 4s a 4-tupleKO0dirss, file Vdirfd1`.0`, %`@`5` are identical to output,xG0fd`ay descripto2fero8`e advantage:d) over$is's safe agan 5races (whenZ) IfQ!isqit shou $a=y" \Crelative;P will0n bTP(is always0ed 6.#vCautionSSince )`s, thoseonly valid untih0nexion step, so you should dup() them if you want to keep# for a longer period. Example:import os$Broot, dirs, files, fd in os.fwalk('python/Lib/email'):G`print(:, "consumes", end=""),sum(os.stat(name@_fd=Efd).st_size !)),O i"bytes in", len(D "non-directory if 'CVS'{# y.remove(+) # don't visit CVS_f&ie}5"""sys.audit("sa", topdown, onerror, follow_symlinks8dif not isinstance(Jqint) orrhasattr'__index__top = fspath,d# Note: To guard agao @ racL`we use Edard1# l)/open()/fu trick.( orig_st =gt )V=Falsgfdir_fdtopfd = 1O_RDONLYb=3*ryKif (r(st.S_ISDIR(mode) anRQ.same%G,[fd)))Kyield from _Y,$+`L?top Zkfinall+Aclos>defv 0hiss O(depth ofQtree) descriptors: if# necessary, it can be adaptedonly require O(1) FDs, see issueKg#13734@scan^i ~kU = []I no5s`entrie@NoneG HelseRlAyU!= (. Qif is 6-Qaencode("tS#ifmis_dir('!.appendZ"M#!is (,4iesYy&?lseD@? except OSError: >try$"# Add dangling symlinks, ignore disappeared files[Fif entry.is_C/()q/nondirs.Znd(name)X?exc IUpass :if topdown{Pyield`path, {#, ,&fdE@for 1 in* ies is None else zip(K;iessif not follow+sorig_st = statJ_fd=topfd,l_=FalsoRaassert 'I,21y =W+O!y. (dirfd = openO_RDONLY f bo as er<`if oneX()J(errlcontinue' @ or Q.same1,)u0dir<" =Cjoin(top,78from _fwalkSP, isbytes,;,P  ofinallRclose)\e t__all__"") def execl(d, *arg>"""Execute the?autableK with argument lists, replac"th.@curr%process. """uxve vJ B andanviron;env Anv =B[-1]KDxecvT[:-1]p `(which`searchor along $PATH^p , env) ExeDcute the executable file (which is searched for along $PATH) with argument lists and environmenv, replacingsqcurrentGprocess. """Qenv =KB[-1]pxecvpe(,P:-1],ha) def'vp"!):;0"""  EB args may be a Aor tuple of string_  ! N !> __all__.extend([2l",e p vSvpe"]piS=Noney ifG@not ;r_func =eargrest = ( WpOelseCB>\Zif path.dirnam!21xecY*Tareturn}saved_ex^_Q= get:_B(envG0if | != 'nt' = fsencodVEZDmap(',`fdir ine1ull=.join(dir,Bo6try5#(fC., except (FileNotFoundError, NotADirectoryW) as g0las6U&V!OS76O6if +is"#"= v 8Vraise]  7A"""RSs*qsequencd, iepat will= "thd^(similar to a shell) when launcha*env* musth anAvari7qdict orLb. If 8_,K3os.zQused.A# Us ocal import insteadfa globto limit,number ofS# modules loaded at startup: theN os module is always loaded at startup by # Python. It may also avoid a bootstrap issue. 3import warnings H`if envrQNone:-=Biron+# {b'PATH': ...}.get(r) and { 0) emit a^# BytesW when using pf -b or b: ignore theJDwiths.catch_&().simplefilter("V)",)6tryDpath_list $except TypeErrorBpm`if sup0s_b @_env| A tb[w]&A(Key,,*Jpass?'ls#5if ~E@not *raise Valu(b""0canPcontain ^j} keys")F=bmf`isinstance(L!, ,wfsdecod8R p &f` = deffreturna.splitsep) # Change to automatically  putenv(Bunse from _collections_abc +MutableMapping, class _E((" def __init__(self, data, en!Rkey, , v NE.(1keyJ,#VM#FaHJL '_!2atafugetitem7key Z1 = T[ @key(A t"# n .Coriginal> tC 7s &*pJ(s,w N qY$rT!_Xbkey] =?delwda2 del self._data[encodedkey] except KeyError: u# raise with the original key value9 7(key) from None +def __iter__(self)|s# list(4dict object is an atomic operationQbkeys =>T) 1for insr=ayield 7 de*1key>lenreturn lenvw?rep8'environ({{{}}})'.format(', '.join(K('{!r}: ,,()O,2 in74.items())))Acopy/setdefault,{mA ifD not [" ={!zD__ioww, otherr1.update(SNM"ifsinstancS, MappingxtNotImplementedgnew = L3?new 8newr` Kq{%dcreate 1Xame == 'nt'# Where Env Var Names Must Be UPPERCASETccheck_strN]k~.H, st7+AType:("str expected,%s" % typeq.__name__K@o5 =  ="f 4 p#v.upper(&U = {}U dAg]Felse30CanMixed Cas[0ingys.getfilesystBhcodingezvs.!e(ing, 'surrog gscape'2ef value.decode(en coding, 'surrogateescape') encodekey = AdataQvironreturn _En(#,O@pkey, deW ) # uni$" eL p = _crek() del def getenv(sfault=None):"""Get anement variable, 2 if it doesn't exist.E The optional second arguLcan specifygalternate deC and the result are str."""orcI.get) supports_bytes_* = (name != 'nt') __all__.extend((".O", "C")) if Sdef _checkT(valupif not isinstance"!, )raise TypeError("% expected,K%s" % typK@).__&__6 H#q+bd*._4|b2I0G 2Tb' 1*"dn fs(#c(<fing = syscfilesystem(eUs)e &()!fsC e(TeuA"""E.  (an os.PathLike)0 orA) to0MgNwith handlerr unchanged^O On Windows, use 'strict'H{=2tem%is'mbcs' (which is1)~\9 = fspathK # Does-EyDof `6`UE!,Yov#.\!e(Ms1OelseC 9A"""DAfromN27str On Wi4ndows, use 'strict' error handler if the file system encoding is 'mbcs' (which is5udefault12). .U """ \name = fspath() # Does type-checkyDof `$`Uif isinstanceE, bytes):qareturn|.decode(,%s)5OelseC  +XsJRe, fs[= f` = _fsyuc() del8 # Supply spawn*() (probably only for Unix) if _exists("fork") and notFv.execv"):P_WAIT = 0CP_NO RO = 1-__all__.extend([">D", ". BO"])9# XXX Should we support P_DETACH? Iqse it c)Q()**2#Qclosejstd I/O streams. Also, P_OVERLAYDsameB!s B*()?Rdef _)`ef(modile, args, env, funcL# Internal helper;"pb6ption ton!ifk@(tupyWlist)o4raise TypeE('argv must be a ;` or a ?'nc 1not;[0]bIValucfirst element canAbe emptyg0pidMork(|:pidlu# Child:try% ifY;Non g~ ; @nexceptNVt(127/g# Parent0if fD == 4_RUQ# Cals responsible waiting!a wh1Uwpid, sts = :Apid(0if WIFSTOPPED(stK$continueMistatus_to6R4 ~?"""% -> integer Execut@withu`s froms in a subprocess. I o331Y'o deV it exits normally; otherw?-SIG, where SIG0sigpthat killed it.TA, args, None", execv) def spawnve(mode, file, args, env):(,?"""+  -> integer ExecutePP withTuments froms in a subprocess)the specified@iron:P. If  == P_NOWAIT return the pid of R 3 1&'s exit code if its normally; otherwisep-SIG, where SIG isx signal that killed it. """Ir_Nfzes# Note:p[e] isn't currently supported on Windowspm&`(whichlooked for along $PATH)7arg b  CNonepp,Qy{lp__all__.extend([<3", e p e"]) if _exists(0"# These arez!byTbasic # but can be easily impleXn Python1l0*& ON q r'xe file with .arguments from args in a subprocess with the supplied environ9 . If mode == P_NOWAIT return5r pid of Q 3 1&'s exit c\Qif its normally; otherwisep-SIG, where SIG isx signal that killed it. """ Qenv =E[-1]rspawnve(r, file,,P:-1],1) 5__all__.extend([";Cl", 0e"],if _exists(Qvp"):CA# At moa, Windows doesn't imple ]cvp[e],; so) wo(Bhave#l#0 ei0.*4def *"""/lp' -> integer Executep (whichlooked for along $PATH)U ~ |~ ~ g j)\ (79p[:p;p<0# Sy os.popen()  Acmd,="r", buffering=-1if not isinstance(43str! raXTypeError("invalid cmd type (%s, expected steA)" %S!))ki t1n ($"wmLValunr0 %rW RwF0 orvBNoneN_+)S ]bort unZSeams"t mp I, iof== "r"v?' =I!.Pm9shell=True(vstdout=_.PIPE8 bufsize=buffering) #return _wrap_close(io.TextIOWrapper(proc.stdout), @Uelse:J` = sub ess.Popen(cmd,%v shell=True,Xtdin=h?IPE7Obufs0%in # Helper for p`) -- a%!xya file whose aa waits0the+cess class[ def __init__(self, stream&Q"._&z! =t^[)M."j5@codehPelf._Y.('8if *6= 0`GQ Noneif name == 'nt'1U7 I%<< 8 # Shift left to match old behaviorUs__enterx\S-xW*args3, Hadgetattc,6i&,i  @) # Supply os.fd  Afd, g, **kwot isinstance(,8int*aise TypeError("invalid fd type (%s, expected integer)" %B(fd)Kimport io1io.x  For testing purposes, make sure {function is availab!enC # implementa)qexists.&_fspath(B"""RQ_u represA ofath-like object. If or bytesApass0, iped unchanged. Otherwn"thJos.PathLcYPrfacePuNato get@. If G9not,rdIrovided R3is C,,Q1"""(ifWc, (strR) $j# Work from!'szmethod resolu@of ona magic"# '!s.e_=N6try(1ath4#._U'__8except AttributPJ`if hasG4I, '__fspath__'):  draise Uelse: ) TypeError("expected str, bytes or os.PathLike object, "JN "not " + path_type.__name__)9if isinstance(&vrepr, ({&))breturnO)E q{}.__fsfs_() to P0str {}".format , 7A)) # If there is no C implementation, make# pure Python version+ #3 as transparentlypossible. if _exists('('|3 = @B = "" class 0(abc.ABC): ;"""Abstract base /6for0ing file system protocol."""O@_aQamethodgGdef CselfB"""RP>theg$esr! o{DrDNotI!edJ 1subhook__(cls, `if clsL}r_check_f$s(I6, ''t6 !___getitem__ =\(GenericAlias) 9ame == 'nt'C _AddedDllDirectorypinit__(,, cookie, remove_dll_d?D7.! ==_NW"h/ =>Qclose_W..6Nonks__enter) o9elf_][*args;#qp1if 8-"<u({!r})><E{A #)>:addLcAdd aDLL search.xHThisrused when resolvdependencies BorteqJQextenmodules ({ 0 it^Ted through)Eand also by c2sR"$"ory by calling close() on the returned object or using it in a with statement.&5""" import ntcookie = nt._add_dll_directory(path)- _AddedDllD(#5,f qjremovet9#) ufnmatchunctools$io nt|o"Xposix$re% sys from _collections_abc ~Sequence&TerrnoEINVAL, ENOENTTDIR, EBADF, ELOOP8operator;attrgetter AS_ISG PLNK, 2REG 3SOC#BL 2CHRBFIFOQurllib.parseY`quote__bytes as url` sup*s_symlinks = True if os.name == 'nt':-Zif sys.getwindowsversion()[:2] >= (6, 0)<44 nt_getfinalneFelse3QFalse,U F = None I$nt __all__ = [C"PurePath", GW40,(] # # Internals # #8 - guard against macOS `#p` throwd _IGNORED_ERROS = ( &) 20WIN5R6q21, # _NOT_READY - drive exists but is not accessibltE123,@ ID_NAME - fix for bpo-35306r)19tCANT_RESOLVE_FILE=croken ` point to itself ) def _ignore_error(excepq@(get 1, '!',()Z bcC1winxFv$) s_wildcard_panx# Whether this ! needs actual 0, or cani# be looked up  lyba file10"*" pap9 "?[ class _Flavour(b"""A fls a particular (platform-specific) set ofhsemantics._init__(t.join = 1sep ;_s>,sE"d ]6YpSUaltsedrv = rooh%''ireversed(parts)  for part in it: aif not  continue2naltsep0e=M.replace(,i, sep)H drv, root, rel = self.split(M 2 ifF>rel~xversed(relQ(~)3if x and x != '.''+ paW.append(sys.intern(x)NelseG!ifln j;rellif drv orMv>drv0# I drive is present, try to find one[0the YviousJ#s. This makes 5result of sing e.g.C("C:", "/ a") reasonably intuitive=:  %2if _'5?[0]A6 ]breakB H^ + "!re(`return+ def join_0ts( ,3!ts2F 2,^7ts21"""TAJointwo paths reQed by`respecc9(ed) tuples. Roa new +Joot2Adrv2 EF2, [C2] +6[1:*"elrn ==cp.casefold(3) =mec# SameS=> secondsb@rela`^UfirstmA y r:# Svnon-anchored (common w  class _WindowsFlavour(_ 3# Reference .(ps can bRund a  # http://msdn.microsoft.com/en-us/library/aa365247%28v=vs.85%29.aspx sep = '\\'3alt/has_drv = True$pathmod = nt Iis_supporte(os.name == 'nt')&try;#>except FileNotF_Errort sU0s, ,` = os..split(sf+0\.append(0 ifE=}X >join(s, *reverseJ # Means fallback on absolut_0Pendedh0s, = #bspace_U = ''4.startswith(C(9E[:4]@|:[4: Z{'UNC\\'W@[z+= s[:3F `'\\' + s[3g.@7, s3 0# T  anE\rinto a ! DOS-lik|Z.7)[1is_reserveW q# NOTE:0Qrules5  seem somewhat flicateO# (e.g. r"..\NUL"1F1butQr"foo%).# We err@sidePcauti3nd Ds which ar#g0conE re9 by Windowsz4parts:  return False  if parts[0].st with('\\\\'):(0# UNC paths are never reserved+lp@-1]. ition('.')upper() in self.]q_names ddef make_uri(&,## Under Windows, file URIs use the UTF-8 encoding.Yqdrive =R. qif len() == 2 and 0[1]<':'3aIt's aP on a local6P => ':///c:/a/b'oDrest as_posix()[2:].lstrip('/')3W%s/%s' % ('^, urlquote_from_bytes(y.e('utf-8'))iOelse~networkhost/share?' +. (gethomedir*@userL.if 'USERPROFILE'}os.environ?Q6 = #[?]h el[HOMEPATHX :tryivhLfDRIVE'f*except KeyErrorK'^Ydrv +kjraise Runtime{("Can't determine /directory") if # Try to guesrG. By default allJs{_$# v"ie{0tedsame place{amed byIcorrespon-kDs. If current l pointto nonstandardc, thisis likely wro)ifNAME'] != P7drv, root.Rrts =b`parse_4s((,=*!-1k y<() "E"for %r" %4[$ a0if !or("! =,++" +LRjoin(k>1:]AW.JF?+ class _PFlavour(_ ): sep = '/' altsep = 'has_drv = False$pathmod = posix is_supporte(os.name != 'nt')&def splitroot(self, part, sep=sep):N!ifA and `[0] ==)$(stripped_IQart.l(RQ-# According to POSIX resolution_# http://pubs.opengroup.org/online/009695399/basedefs/xbd_chap04.html#tag_04_11!"A/that begins with two successive slashes may b# interprein an implementa-defined manner,hough morMAthan~1lea/{shall be treakas a singl)".pif len(1) - )2vreturn ''i * 2, 9 fOelseD @<|casefolds8s-s3P7;ompile_pattern<uBre.c2(fnmatch.translate(Dq)).fulli&veah*1ct=l"E.sepa!orDth._"seen = {} _{,tm!ifp.startsBb@Afor [#inIDbif not08n== '.'p]# current dirwzcontinu^k!_`/pa_ d, _, _zrEiRO.endk 0new+w! +5 nZ< @ZF,o0in JqAlready$Q this[ N[])Qth is?NoniR# use cached val'# The symlink{-d, so we must have+JloopO raise RuntimeError("Symlink loop from %r" % newpath)  # Resolve the symbolic link,Mtry:Ptarget = accessor.readD(yexcept OSError as e]if e.errno != EINVAL and strict5_raisep# Not a, or non-R mode. We just leavBPuntouched.!:$ = #?elsSseen[D] = None # not rd Vy_-(",  2 r2. #n opreturn ,p# NOTE:ording to POSIX, getcwd() canbcontaiA componentsLwhich arsjbase = '' if.is_absolute() _D os.vWI,X( ))Asep 1`def is,erved(self, parts)SVFalse8make_uri5'th4#lrepresentJ1 us6 he local filesystem encoT,# for portabilityoother application6dr= bytesM'r://' + urlquote_V_5bC)gethomedirusername!if:bos.environ['HOME'];P1KeyQ X! imI pwd8b0pwd$bpwuid(0 )).pw_dir8Q a] nDnam( k Runtime("Can't determine  directory "b"SA _windows_flavour = _WF() _posix#P! class _A5RP"""An5Ip implem ! amicular ( -specificnot) way ofDAs on\>U.""" dNormal("):0sta0os. l =^ Bopen `listdi,3os. Escan RchmodI if hasattr(os, "lchmod"): lchmod = os. else: 3def)(self, pathobj, mode))- raise NotImplementedError("a() not available on this system") yRmkdir bunlink if hasattr(os, "&"2_to9 d @staticmethod cink_togtarget]'[?ink%rm brename Eplac Vif ntif supports_symsd  */&r(a, b, _is_directory%8)O!H # Under POSIX,Mtakes two args;hreturnu:4uti # Helper for resolve()Y@readrpKp("[@_owner=:try im6 pw`epwd.getpwuidQ.&(p.st_uid).pw_<except IZ sRPath.s) is un/ed)Qgroup-5grp0grp?grgg/gr; _normal_accesso!!_NA() # # Globbing hjPs # ,_make_seltern_parts, flavourAPpat =#1[0]8Rchild6 #"1:$ if< == '**' cls = _RecursiveWildcardSaAelif80 inG??QValue]("Invalid':8can only be an entire$h component"umw@_patK  &5*yPrecisek0cls^', K' functoolru_cache 5 = .$.l,3()('elector) c lass _Selector: """A s+ matches a specific glob pattern part against the childrenLof a give)qth.""" def __init__(self,9_Ps, flavour)%.]$( =2U'(if?Csuccessor = _make_(^ZBdironly = True Oelsep Terminatingu%()BbVFalse3S_from6parent_path-"""Iterate over allwhs of `:`d by thisqor. This can contai{1 it]_cls = type(pPis_di..PexistD!!DscanC3._a. 0rif not g return iter([];,_", #, R) cu : Zl,j`Xyield5{uPrecise) Oname*0 = ub.96try( =.0relj^.>Bif (;0 if&$f. )(D;for p in:.<Qqexcept PpssionErr4Wildcard?patI$ =.compileI2k0xDwith /4 as:_itec`entrieSlist(6_it'+y >iesM m!K 0# "^y.is_dir()" ca n raise PermissionError # in some cases (see bpo-38894), which is notFamong the eps ignored by _ _/()F ife entry.is_dir():/continue%except OS_ as eN} e l| cname = Cif self.match(#path = parent_._make_child_relB fQfor ppsuccessor._select_from(D", , exists, scandir]uyield py  return class _RecursiveWildcardSDor(_ 1): cdef __init__(@r, pat, 0parhflavouH.=8kpiterateectoriesw80 ::tryDwithr()Z:_it5JOies = list(+ +y  ?iesM"y_ ~ = Fals| W>*-"if:andsymlink% _djW GgoZHX\ ed = set -:5lf. ;Zstarting_point.g@cI(y0Aif p3in ;  yield p  $ed.add(p)+finally:A4fclear(5except PermissionError@(return # # Public API # class _PathParents(Sequence)E """This object provides s'-like access to the logical ancestorsof a path. Don't try3 construct it yourself."""7__slots__ = ('_Acls', '_drvAroot parts') 9def __init__(S,~Ua# We de@instavoid referb cycle@U. = type(#Qdrv =~.A !3len6if {#or ]~A len#rts) - 1Oelse6sgetitemZ, idxidx < 0 or5 >=(aise Index(K|cls._from_parsed#tsGdrv, ,Gih`rts[:-I- 1]rCreprb"<{}.pk>".format_name__) @Pure(W"""Base for manipulatingos without I/O.M es a filesystem9 and offers operations which57imply any actualGr Depend!on f{m"ti%a Swill 4seither @osix 9a5rWindows. You can also k#e R ofBdirectly, regardl(of.wI#1strAhash p cached_cY hnew__(cls, *argsZE"""CU8@ath @ one<several strings`r exis?pL^Wys. The7!s are combined so a01to  a on%Aizedr,] is incorporated inV6new( `if clsQ =K>`if os. == 'nt' (P} retu$rn cls._from_parts(args) def __reduce__(self):# Using the ; tuple helps share interned path&@when picklHSrelat+%s.'qreturn ~.__class__,m)@#amethodF`parse_`(cls, This is useful you don't want to create an instance, justicanonicalize some constructorxWumentU = []Ff*0 in/ssaTif is}(a, PurePath(ZR+= a.aJelse\a = os.fs9(a)3! ?str|+# Force-cast str sub esM(issue #21127mF.append(str(a))?raise TypeError(%A"arg should be apobject nooLike "M4str, not %r7i% typeBrlavour.( , init=True# We needPcall 891 on}a, so a0get# right fDaQ.__new__drv, root,10 = 6drv = drvm ._K! =R :" =g:nitc3(1{0sedN ts, ]1 #/._Pormat  ifq v+* +BjoinF[1:]#K>T?i# Overridde`crete OBpassImake_child 2}ts( self._drv, Droot qparts,  ) :creturn:from_parsed>ts(9:def __str__(!):QB"""RTthe string representation of path, suitable forF@pass9to system calls."""$6tryw{ &stNexcept AttributeError<.$ = Pormat& T>y or '.'F w fs9z4"tr 4as_posixP withvward (/FjslashefJVlavou .replace(f.sep, '/')~__bytes %i. This is onlyrecommended to use under Unixpos.fsencodeP:"{}({!r})".f]@.__class__.__name__)aas_uri:v  as a 'file' URIbif notis_absolute(Raise Valu3("relative ccan't be ex2sedvut""fV.makeH@propertc( # Cached casefol),P hashBand comparison= cZ_y4G ? .[!ts. /~G3 S*3_eqpw, otherisinstance(", PurePath,qNotImplemented 2 ==u.+ np#._ 46! =R(tupl)z:#ltq! $emented  return self._cparts < other )def __le__(-,$!):!if not isinstance(F, PurePath) oriflavour is4)#._SWNotImplementedu2 <=/gt>> class_getitem__(cls, typeH3clsrive = property(attrgetter('_drv'),2doc="""The dEprefix (l>PUNC p, if any.""")yOrootxyx'q of thehg@gaanchorgconcatenation[@and q, ''TT# =Sdrv + 3(~/OnameQfinal componentikqif len(p) == (1s.) else 0-%''XXO[-1]asuffixoT5"""JT's last =dThis includesleading period. For exav: '.txt~ @i = .rfind('.')f 0 < i <]'_) - 1oE[i:]>b*"''& /esH dA listRDO4esePOsP['.tar', '.gz'YfXendswith[[ZEalstrip7T@['.'u f% "inuQsplit;O[1:]?temlpath component, minus its last suffix.""" name = self. @i = .rfind('.')f 0 < i < len('e) - 1:"^areturnEE[:i]Oelse* 'def with_[(,H)8B"""Raa new path4 the file2 changedfif notVaise ValueError("%r has an emptyYB" % )drv, root, partsZ_flavour.parse_(8,>@if (1 org[-1] in [.HBsep,faltsepg`or drvLg) != 1Q0rqInvalid1 %r0rom0sed!ts$!._#,s 3 [: 0+ [+])*Asteml , * -%Rtem +{O e WA If7#no, add given.6& iJstring, removejAfromz.1?f&if f.sepPRor f.F and i Q JhT0.st == '.') k uDold_ u( {</0[:-PY.)]BH_SYrelative_too*other=1TQto an1identified byEssed3argumentsoperationpossible (becausx#isJ@ sub}" o<),  """ 6 # For the purpose of this method, drive and root are considered  # separate parts, i.e.: h Path('c:/').relative_to') gives%?/');/: raise ValueError<if not other32Typ2("need at least one argument" = self._l5drv5drv73 !ifT 2absY = [drv,$2] +YE[1:]AOelse> 1to_N0to_E, tohse_args(1 if.7 n9to_ df J6n = len((%cfzflavour.casefoldH@if ( or drv) "` == 0 ME cf([:n]) != x formattedz#se("{!r} is!inpsubpath"BA" OR+4is s[absolute.JR" .P(str(30), Vted))creturn)Jfrom"''1?'', Qn:]) 7tdef is_^1, *)B"""R@True ,Qto an< or False.o&""66tryb} >%+gexcept X3@propertyC="""An object providing sequence-like access tonPcomponents filesystem. # We cacheE` tupleRavoid builyQa neweach time .x#ed. XXX neEary?/ ,*_p\gAttribut .8" =V.m@joinF?0, *k `Combin3!isT0 wi neuseveral!s,tahSh representeither a subpath (if all arguments are relative paths) or a totally different  (if one of theQ%isGanchored).5""" return self._make_child(args) 'def __truediv__(,q, key): 6try Xu(key,))9except TypeErrorFNotImple.(edr)from_parts([key] +0@propertyH paC>"""The logical %.Sdrv =1drv\s5ootErootqif len() == 1 and (f0or Hh3F X3sed_Adrv,K,sts[:-1]_%s&A sequenc!is +'s<s1a_PathP\Jis_absolutewbTrue ieD is / (has both a?,.applicable,(a drive)cif notqFFals8flavour.has_Abool.ois_reserved B"""R containssspecial names U!bybsystem)nyT$._ .GQmatchRth_pattern 9 H!esPgivenPI.%cfFcasefoldl!h = cf(V t ^Rparse(HD@#paF ?aise Valubt("empty"0if :!7drv[ %if DE c^ G) != -K =(E[1:].eln>mreturn False  for part, pat in zip(reversed(Gs), "t_2): Bif not fnmatch.AcaseE_ 39return FalsePTrue # Can't subclass os.PathLike from Pure and keep the constructor # optimizations5.se_args(). ^.register(-B) @osixy 1""" 6athinon-Windows systems. On a POSIX, instantiatingsshould &this object.K0How, you can alsoNe it directly on anyuA1"""I_flavour = _p_slots__ = (4  |w b# Filep-accessK&esU?athLAthatCmake3T call8{ represents a fh but unlE,*aoffersmethods to doh8pzs. Depend on{r0,J <Dwill`eitherjoIp?. Y8a PB@ 0canHe a 3  or vice "a1"'_2or'y)def __new__(cls, *`, **kw .if cls is e[= if$name == 'nt' else`self =\ ._K 0ts(~g1it=)18..is_supported raise NotImplementedError("z %rVyr+ % A0.__F__,)Vinit(:%s# Private XP argu.2template=NoneO +2 E.D4 = 3>r = _normal_#accessor def _make_child_relpath(self, part):)-## This is an optimization used for dir walking. `A` must beHa singleb relative to tb./E@s = "._0+ [ ]%creturn$@from)0sed!tsc._drv,#Broot's) _enter__1_ .3xit-, t, v, tb7# https://bugs.python.org/issue39682 # In previous versions of Blib,method marked!7 asK closed; subsequent attemptsgperform I/O would raisevIOError@funcality was never docum7d, and hae effect of ma Path objects mutable, contraryPEP 428.P6x 3.9 thF_aributecremoveO1de a no-op$_R)/__eA) sh(be deprecated{0 inv futurekGpass>aopenerj , name, flags, mode=0o666LaA stubhBthe @A arg7pbuilt-iEen()$._.AyOraw_&g=0o7775"""o3Opei0oin,(by3nd 0a f'descriptor,IRas osf) doesMpI!# Public APIb@classzcwd(clsRlQa new p0ing@currs1wordirectoryYL3(asPed by0geto/)) ucls(os.-Ohome!puser's ?' (`qp.expand<O('~')._flavourrdir(None)@same$`other_u0whe! 'H or not asX g.9)($stGstatz6tryA0 a 6except AttH \) retur)n os.path.samestat(st, other_st) def iterdir(self):2"""Iterate over the files in this directory. Does not yield any Eresult foDspecial s '.' and '..'.| 8@namew._accessor.listu4if 5Q{'.',a}$0# Y`ing a e objecse makes little senseBzcontinu D_child_relh(Aglob,Otern is subtree?lall exist9(ofkind, includ&ies) matchgiven relativesys.audit("Plib.P{0", >$otZ raise ValueError("UnUptabl: {!r}".format(pat9)cdrv, root_parts =._flavour.parse(H&,)Iif drv orNNotImplementedLNon-Cs are unsupported"g1selSA = _4d(tuple)ZG4p1P.HQ_fromf]@pr*:3"""Recursively~ vB~,@wherF>("**",) + H\absoluteK Bturn an % version ofbM@. TnPfunctUworksei0h doesn't point to3t.@No n3AlizaTone, i.e. H will be kept alonghUse resolve()p1get-scanonicaA;5"""# XXX untested yet!"if4is_+(Lreturn self < # FIXME this must defer to the specific flavour (and, under Windows,  # use nt._getfullpathname())%obj = self._from_parts([os.getcwd()] +!, init=FalseH ._(template=U!return obj }def resolve(*t, stricY:%5""" AMake  absolute,Iing all symlinks on-way and alsoKnormaliz5it (for example slashes into backrKz%).s`.0if s is None D# Noution => consistency, raise an error ifJVLdoesn't exist +sNibidden5f.stat(M!tr.kw we have n`, it's safeFe it_-edX@@mod. &(s(,Oed,)8&)R {result of9) system c0is e, like#os ku._accessor7)Bowne`login JQfile C10Rgroup?,?gidFr1pen, mode='r', buffering=-1, encod , o!s= newline^2OpeJpointed by !a 'object, as}Ubuilt-in oa) func!(1io.4,, N!er "._ read_bytesj1in 2@ad irnd closBwith(b') as frn f.(Atext  file in text mode, read it, and close the file. 5""" with self.open(F='r', encoding= , errors=u) as f:I\return f.1() def write_bytes(mv, data)>EOpenA in 8J? to# type-check for^buffer interface before truncating';view = memory ( N?wb'- (N 2Gtext1ENone MSL)if not isinstanceW, str-raise TypeE9 (', must be0,JU%s' %B9 8.__class__.__name__)5w-}AlinkRy@pathQwhichPsymbolic F points<=_accessor[;Dobj ,from_parts((E,), init=False7Pobj._(template=!6objQtouch},G=0o666, exist_ok=TruePCreat!is (bgiven W, if it doesn't_("if6_okQD# First try@bump\0ifiuon timeB2Implementationqe: GNU Q usesUTIME_NOW op*+ofJubnsat() / fp() func7:try.E xexcept OStM# Avoid (chainingGxIpassNelseR%)flags = os.O_CREAT | eWRONLY)I8 YF|GEEXCL8%fdAraw_/1os.7(fdSmkdir?0o777, parents$4 a new directory at this     FileNotFoundError: if not parents or self.1 == 3>YraiseI7r.mkdir(Ds=True, exist_ok);4Tmode,X=Fals;D?except OSP# Canrely on checking for EEXIST, since the operat isystem# could give priority to other eZs like EACCESKYEROFSGo%=0is_7)nIdef chmod(4 , 121"""'RChangpermissions ofRpath,2os.S%).=Ij._accessor, 6lHRL(,)i@ poito a symlink, !'stQare cQd, rathan its target's unX ngPRemovpis fileFIis a directory, use rm instead9Y6tryr EFileNotFoun*H imf. The must be emptydyQlstat%.F us information is returne8arename,R*` this &.X@ mayqabsolutrelative. R EFs ar*interpreted 1z0curA worp, *not*\Path objectRss;Q new &Baf!to"hD n _class__(c)Z%_eplac5, overwriif that path exists. The target path may be absolute or relative. R +Us areHinterpreted1 to the current working directory, *not*%I0 of PgobjectqReturns"2new&instance pointk.j5""" self._accessor.replace(, )-r| .__class__(d)[def symlink_toHPE_is_=False):dMake thisx$ aZ0Not>0derVarguments (2) iPpreverse+3os.8, ,#_ ' $  pa hard G 16 is function does not mfWBto *%*,Sdespi[qimplicaQaDand r names. vUorderN%of%%s @_to, butK`matche#atH]* # Conveniecs for queryqhe stat results; ex{ wWhether4{6try/|(except OSError as e5!if_ignore_e'(ZFrais}qQValuet o# Non-encodable<UqFTrueP?PFis aX~qS_ISDIRq.g.st_modepS#An't dbroken S# (see https://bitbucket.org/pitrou/lib/issue/12/:'bis_fil{(regular ?p (also 2 for symlinks pointing to regular files).5""" Etry: ;return S_ISREG(self.stat().st_mode)0except OSError as eMif not _ignore_e':(e)%vEaiseX# Path doesn't exist or is a broken symlink8$(see https://bitbucket.org/pitrou/pathlib/issue/12/{7FalQValue # Non-encodable c Udef is_mounthCheck if thisYaPOSIX ? pV># Need toCand be a dir1j0s()mwis_dir(h Sparent_dev = OX5devjV grZS0if $2!= zY6Tru4inoW5inoM(//!Q |Whethersymbolic 1LNKu&.lkR=TPblock&1ice^?s?ice#BLu xOchar'>_acter&1CHRZ-of not _ignore_error(e): Yraise# Path doesn't exist or is a broken symlink8%(see https://bitbucket.org/pitrou/pathlib/issue/12/)Creturn Falexcept ValueE # Non-encodable cUdef is_fifo(self1"""#&Whether thisWUFIFO.%1:try@S_IS6m.stat().st_mode!OSZ as eNif not _ignor sosi9ASOCKoIexpanduserj " R5Ra newRwith 5ed ~ and ~? constructsB(as ed by os.C.@6@if (P._drv%Op._root)wfPPparts [0][:1] == '~'8homedir =2flavour.get[K61:]C@Arom_,#([A3] +[A> class Posix)(e, Pure0"""B sub5 for non-Windows systems. kOn a POSIX, instantiatingcshouldbobject__slots__ = (){ ' ;Qmount NotImplementedError("Path.>is_mount() is unsupported on this system") #! /usr/bin/env python3 """ The P Debugger Pdb = To use the d1 in its simplest form: `>>> imI pdb pdb.run('') a's prompt'(Pdb) '. Twill stop ie first function call b. Alternatively, if terminaQwith an unhandled excep]p, you c sePost-mm facility to inspect:contents of traceback6 9< 9>n 3pm(^commands recognized bypare lis^qnext se\q. Mostbe abbrevi5as indic ; e.g., h(elp) means that 'help'@typed as 'h' or(but notea', norHHN:HELP'). Opal argu] s enclosed in squbrackets. .q syntaxEPsepar by a vertical bar (|)d blank line repeatsNp)Dous WpliteralE '|', where itB1 11[Ts. CY vdoesn'tpassumed#be Qs and(Wexecu#xtgram being 3d. Rsalso be prefixed ^pexclamaV point ('!is a powerful waS?pro;5is even possiblechange variablesp*8ps. WhenLQoccurHsuch1,*name is prin="'s*d. s aliases 1ichKsave typing% hmeters (seJ y entry) whS allows one a certain leveluadaptab under exa2ion. MultiplePs mayRenterpa singlbEne, O pair ';;NAtelligenc[b appli;1ingU s;Q inpu:split at&^,#if,amiddle@ quo0strm0 I-file ".pdbrc" existyour home directory^Wcurrent ,w0reaxtGhad been typed aRt the debugger prompt. This is particularly useful for aliases. If both files exist, the one in` home directoryXread first andO defined5re can be overridden by local filebehavior4 disabled2qpassing:"yrc=False" argument toPdb constru. Aside from3cis not lyCPgramm; but it M@mpleled as a classZwhich you`derivedr own k 2*, .@makeQPfancy Glike. Dcommands = """ # NOTE:sactual 3A doc$Pationcollecteddocstrings ofA$ #<sis appendo __doc__ after0 phas bee. import os $io $re %sy4cmd4bdb &di!%od85glo#dpprint1dsignaleinspecutokenizGtraceback0linecache  Restart(ExcepF): """CauseBbe r3do%!d pythonh.M __all__ = ["run", "pm0Pdbsruneval 4ctx !alAset_!",Zpost_morteNphelp"]  find_func( Qname, cre = re.compile(r'def\s+%s\s*[(]' %eescapeH!))2try4Tfp = `.open( m.ei OSError9return None(bnsumer`nfo exs1;vwith fp\&@no, ` in en\ate(fp, #=1if cre.match(9 $\k!no&getsourceWSs(obj\<3 = .2-V%ifqisframe`obj.f_I!al/s`# mustpa modulQqame: do=0try]cut a block out!it)elm]~ 81getv s[+Tno:])#"+1blasti2q(code, Ws = list(disU3s7.reverse(Li}I*"if}V >= i + 0 class _rstr(s#tr): """String that doesn't quote its repr.""".`def __s__(selfFJpreturn B # Interaction prompt line will separate file and call info from code # text usvalue ofF_prefix s. A new`Marrow may # be to your liking. You ca t it once pdb is imported vthe # commXP"pdb.f= '\n% '". #`= ': '# Use thisget the old situa ]back X!->B+# Probably a better default class Pdb(bdb.Bdb, cmd.Cmd):  vious_sigint_handler = None%Cinit,pletekey='tab', stdin=6 4out 2kip s"nox=False, readrc=True>9.__sY)Y *4com!in6out;sys.audit(FPdb" if2out.use_rawinput = 0= '(Pdb) 'aliases = {}pdisplayamainpy ;= 'T_wait_for_'c d0tb_Y*noP# TryAload&0 ifeexistsH:try$6)4# remove someE2monname 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, tellsa,:`# must/@. af@exec8M@cmd O silent = {} # for each bp num, tells if the stack trace # must be disp. after execingPcmd listMself.commands_defin,= False # True while inDprocess of 0O C# a m bnum = Nonhe breakpoint%pber forch we ar" adef sigint_handler(,qframe):-0if !.allow_kbdint"raise KeyboardInterrupvmessage("\nProgram i*ed. (Use 'cont' to resume).")set_step(9( 7Qresetbdb.Bdb.1hforget()HI.lineno  HJ= []curindex = 0O2tb_mh.clearQsetup|, f, tb 9t,gmBack(Q"*tb# when settVup post-mortem debuggbwith aback, save alla# or0al s"layed aloaurrent/ Onumbers (which can=0ffe3, e.g. due_finally clauses6blasti2q(tb.tb_p.f_code' Ca[<1] =)noRtb = ';nex^1curx" =w[d6][0# The f_locals dictionary is updated fromqactual b## =Aever+.T ac8 orRcalled, so w# cache it herv@ensu hat modificas not overwritten. 6Pretur0lf.7tRcLinesU2# C"uQearliAan 'q'qdesiredYs1M!if".rp EKjf copy becrecursion*N  .r'se@#4@ute y| only on q  = rcLines.pop().strip() if line and [0] != '#':(3if self.onecmd(8)&*R# if ' returns True, the commpwants to exitnHAfrom5interaction, save leftover rcsCaecute before next Q9rcLines += reversed( H W# Override Bdb methodsdef user_call(q, frame, argument_listfs"""ThisH@ is <ped when) regremote possibilitythat we P need`stop iEais funlE."""7_wait_for_mainpyfile  9ca_here(.message('--Call--'i%J{, None)WWpH5J0we or break at tyT$1if .6lrcanonic.f_code.co_[Jname."or,0.f_wno <= 0% s = False3bp_s iRG3M0"""y+as set for current "veFpoinL0(if*!."R3hnormal  must bep,"0 otherwise#1 bpf`in bdbmABdb.aag was hif getattrJ5, "\"",)\- nsU# ='k)bpW.,0lastcmd_backI (GRsetup[40[]7*x3 =  (cif not 0_silent~print_stack_entry.[curindex]m_dopromptq_cmdloo self.forget() ereturn1 1 def user_(self, frame, _value):0X"""This function is called when a9P trapset here."""F0if m._wait_for_mainpyfilelp9.f_locals['_c__'] =|4jmessage('--R6--'+#aintera(h{, None)-Pexcep 0exc_info,eif an K occurs,but only if we are to stop at or just below t_leveld3Ptype,L traceback =2 X[p# An 'Inal StopIi'ntR 9debug event# issued by the bpreterhandling a subgenerator run withJ'yield from'x&a /acontroby a for loop. No7hasQactuallybred incase. The 0gers7 toP{'0gee(;V such%s.Dprefix ='x@(not_32and6!yp ) else ''K{%s%s' % (nFmat_b,(a)[-1].strip())C1# G"lI"J@_cmdwhile Tru:try# keyboarterrupts al_pasy wayacancel>#current command, soJthem durv)&puGN_kbdint = w)lH ]FalseIYbreak# K(BP---3]2# Cabefore!, es display expression?pre3W=.1cur-"$ifn:ingQ, old0displaying.items[(): newvalue = self._getval_except(expr)5+# check for identity first; this prevents custom __eq__ toKbe called at every loop, and alsoNinstances whoseMfields are changed to be displayed55if is not old%!=HWd@ing[85] =Z v0qmessage('> %s: %r [old O]' %?C,p,1)) >def interaction(}, frame, traceback"# Restore theious signal handlerPdb prompt.nif Pdb._ ;_sigint_; D:tryBl.(.SIGINT,\  VError: #[ only works in main threa5EpassNelse f = Non"ifosetup(oH# nob desirDtime (happens if .pdbrc contain# a comm`like "'Zinue"J5.forget(ereturn) prstack_entryu.["curindex]M@_cmde{i6Ahook^W, objB"""C*@execdefault(), whichhq as$qment of_ variableBNbuiltins5"""B# reproducRbehaviorPDdard,H=ing0Cobj K 1^{()g, line8!if[:1] == '!':! =E[1:]dlocalsB1cur_&Oglob'3.f_* 0codcompile( + '\n', ' vsingle'Msave_stdout2ys. o%&in$i#Eg= sys. R D~fo 8'(?out).   exec(code, globals, locals) finally:sys.stdout = save_)'in(/in'displayhook-3jexceptexc_info84ys.e()[:2]: elf.error(traceback.format_Zion_only(*G)[-1].strip()) Pdef precmd(self, line)!"""Handle alias expansion and ';;' separator."""Uaif notOsV!areturn!5aargs =v.split(0whirgs[0] in .*es[C$![[:[0]Feii = 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/0nexL[\c+2:].l 0h1cmdi.append(E [T"[:\<].rYn/on Interpret the[ument as though it had been typedresponsef!to@rprompt.Checks whether this3 isNaznc"l AG or 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?endy = []  return 1 # end of cmd list 0cmd = self.commands[e_bnum]4uif arg:KH.append(cmd+' '+arg)(Oelse6 . # Determine if we must stopR:tryQfunc = getattr(, 'do_' +_except AttributeErrorMEv.defaul8P# oneRthe resuming ?0if .__name__ ini_< {tN_doprompt = Falses?mdqueue = [r4 # interface abstraction s'def messagegFmsg)print(msg, file=vstdout)Bev@'***', G # Generic~0ple. Individual"e_foo methods can b@# assigned below to'seX@_comx`e_locatext, line, begidx,7idx(3# C?! a*/module/8M V for break/taclear.!ifm .strip().endswith((':', ',')y2`# HereAes a> number or a condiPwhichPcan't2}OGn# First, tryMfind match/s (i.e. expressions)Z 4ret|<(x,E6ion 6e# Then s as wellPglobs@lob. (q.escapev) + '*' fn%+sif os.path.isdir(fn fn`/`!)elIJ and fn.lower=0.py?M.pywBR:rets:s?ret2"bpo2& Spoint. (This woul more helpfulJc # display adal info along D `, suchA/P!of0.q[str(i)Pi, bpenumerate(bdb.BR.bpby*I{!if>s not None and st,r(i).startswith(text)] def _complete_expression(self, + , line, begidx, endidx):@D3# CA an arbitrary N.,pif not ^.curframeJNreturn []4`llect globals and locals. It is usually^!re sensible to alsoQ builtins,T they clutter the namespace quite heavily, so weQPleave3Vm outns = {**3.f_+, _}[if '.' in +a# Walkuttribute chain uplast part, similarEwhatcvD# rlPr doeZ This will bail if any ofTPs ares L siQ% aaccess, whichw we wan.dotted =.split('.')c:try :obj = ns[C6[0]D 1forQ'^1:-1]N.R0getQ(obj,= except (KeyError, A*Tprefix =c.join(0) + G9@+ n n ir)nTF-1]);elsu@te a:"plyns.keys(zMx_mdefinitiocalled by cmdloop(l# The argumenremaining str!on1com[12# RV1truexit from06oop doIs7arg3"""is [bpnumberS(com) ..11end?R(Pdb)rSpecify a listiabreakpoint m vd'5themselveentered &`follow7(sD ypS contdjust 'end'Bterminat sE%he&Pexecu2whevis hit. To remove allI&a :0, t^ it immediately P; thaKP, givguWith noj,.q refers0he q8 seYou can useT1to  your program upZagain. SkyHinue command, or step, or any other command that resumes execution. )SpecifyingF834 (currently continue,G next, return, jump, quit eir abbrevia%s)@terminates the list (as if5was<immediately followed by end). This is becausetime youDe" (even with a simple o ),@E mayDencounte breakpoint -- which could have its ownA`, leadto ambiguities aboutL)5 toAe!IfX'silent'a-inp,UusualYsmessage}PstoppHat ais not printed|Eay be desirable for>QRre toD{&icF%en. If none o.e0Rthingwill see no sig!at ureached.5""" iet arg:bnum = len(bdb.B.bpbynumber) - 16JelseD:tryYvint(argWnexcept4self.error("U:+ [0]\n@6... Jend"c#^ s_O0 = "0# Sold defini1casa keyboard VVrruptv!ifUI in r Cold__defs = (/ 5_doprompt>#<OENoneH O_ = []! o = TruM_ = False;r_back = z = '(com) 's inV wmdloop(:# K.I- # Restore yT if 5 H%jsz &[06 : C1C self.commands_silent[bnum] = old__defs[2] Yelse:gdel seWP(_dopromp1 /serror(' definition aborted, s restored')Lzfinally]6ining = False< +2 = a_back 'completef@s = bpnumber,def do_break(X, arg, temporary = 0)P"""b(-p) [ ([fame:]lineno | func) [, cond&] pWithoutiument, list all "s.,0 a ^ 7Rset a4 at this*Vin th4current 3. T} name, Mqe firstSexecutableeuof that. If a se5 isCApresPit is, trpspecify Pan ex(sSwhich muvaluate to true before Apoin_0honyN#ThKmay be prefixed with a( and a colon,3to }rn anotherA (probably onaK hasn't been loaded yet). searched for onsys.path;.py suffix omitted.15""" Qif no|"if_@: #@re's[PleastH44.message("Num TypeDisp Enb Where" ! bp in bdb.B]QR.bpby 9_if bp# bp.bpformat()Vretur^u# parse"s; has lowest1fcedencd#-0can^PoccurJ7f = Non?,noI *# =.find(',[#if:> 0stuff after+0: "h(Bj[v+1:].lstrip(D arQarg[:*<].r' -/: H ;".r:k Dllon >=?lon 2f =!lookupmodule(B if not f: self.error('%r &ound from sys.path' % filename)DireturnNelsemCI = f/ arg = arg[colon+1:].lstrip(o>tryWlineno = int(arg3except ValueEABBad Q@: %s RC Q# no ; can beW or functio4CVp = eval5,! &curframe.f_globals9z_localsk=argif hasattr(?P, '__ O__')fj).0 t)@code`unc.__/__)#use co_< to identify the bkpt  $sFPcouldFaliased, butXis invariant[_0 = .m*Rfirst1] 0 # last thing,=try@E(ok,, ln) = @info !if/okJ The specified object %r isGa/ 'b'or wa<fiUalongj.rE zok # ok contains =I&ln@4 :defaultFile# Check for reasonable breakpointLc4(f,G " @w seMf g14errjAset_ j, temporary,N!d,DLjif errM:err472$bpgsU)[-1]25kmessage("Breakpoint %d at %s:%d" %  (bp.number, bp.file qline)) =# To be overridden in derived debuggers,def defaultFile(self):"""Produce a reasonable3E.""",pname = F.curframe.f_code.co_#44if  == '' andG`mainpy&o(^ereturnbpdo_b = Breakcomplete_bE = _locationVC$%T1o_tLRZ, argWT [ ([ :]no | funcu) [, condi1] ]aSjarguments as o, but se temporarypoint: itEis automatically dePd whe8rst hit.1Gs(arg, 1'PU,Cinfo+identifier2failed = (None, )H# Input is DP, mayin single quote7"idu' =7.split("'"`tif len(0)1P# notnkoit@[0]. &p(g/eli3id[1[*seH#_MPif idO'': #Qparts+6'.'q# ProteO for~!f L1[0]rW'5del$<@09$# Best fipguess ale to look a(fi/ nitem =,el# More than one31# Fpis modu se&method/clas6f"up:(6[0],Kf1answer = find_( !, Kt32or $Pcheck)%4 , 'no+@"""C.ther specPd,` seemsbe execut.lR7`Z ` V0, 0 (e.g. a doc ngmu, blank"E or EOF). Warning: testing is not comprehensive. 5""" 8# this method should be callable before starting debugging, so default Z # to "no globals" if there is no current frame.s = self.cur0.f_0alsEhasattr(#4, '%') else NonOpline = cache.get (filename,1no,%s)aif not:w.message('End of O'=(return 0=xv.strip(1# Don't allow setbbreakpoint at a blankUDif (P or (f[0] == '#') or,!":3"1"""$U[o"'''")error('Bor comment  1no def do_enZ7argu2""" bpnumber [ A...]HEEs] 2s given as a space separated list ofC7 ls$0argarg.splitfor i in $ <:try$bpget_bpbyz&(i(except ValueE>errR;errF>lse22bp.dtNd %s' % bp)WCleteE = _*0disIDG=" YaL means it cannoQcauseypprogramstop execution, but unlike clear^{,aPremailnWPs and& bR(re-)d,eIPcondi! SeEnew  ?7the, an expression which7must evaluatev5truIeakpoint is honored. If condition is absent, any existing "removed; i.e.,Fthe breakpointKumade un=5al..5""" args = arg.split(' ', 1)!Etry: S2Es[1]except IndexError6ENone3 [ bp = self.get_bpbynumber([0].strip()v Le6('B V expected'PQValuek as erW7err>:lse3bp.0Haif not 4bymessage %d;nowr' % bp.Le b1Newxset forS;%d.ccomplete_=5= _"bp -def do_ig(,y)2""" :v [counth@Set (Xgiven su$omitted,P0is to 0. AR@becomes active whenHzero. W @non-  is decremented each timeU r%ed?and&]disabled #Vassociat>evaluates to true3o R= int1_90 \.!= "ifJ > 0- 1"Rstr = '%d crossings n2:0L1K'B.SWill next %s of^ g Gs(},(Qstop lhik.g |e_ignore = _ complete_bpnumber def do_clear(self, arg):! """cl(ear) filename:lineno\n[T U...]]EWith a space separated list of breakpoint 1s, AWthose(@s. U0outSument4B all*es (butDfirst ask confirmation)J, aYCaat that 2 in (.45""" Qif noae:tryreply = input('C|E? ')Y0except EOFErrorQI'no':j.strip().lower(d1if %('y', 'yes'0!bp=p for bp5Ubdb.BR.bpbyf if bp3D.xQ_all_+s(cz&Nmessage('Ded %s' % bpereturn)`if ':':arg^# Make sure it works" C:\foo\bar.py:120i =k.rfind(':Nv&:[:i$3argJi+1:W!noX t(E_ValueGerr = "Invalidp(%s)" % V:lse3l#4get,]*no;8c:(9 _if erGe4J(errmemNPBarg.spliti* aQbp = n}+(iK? as<5) % = # 'c' is already an abbrevi'continue'E = _1loc8/cl%&S_whereS w(u Pra stack trace, w6the most recent frame xe bottoml An arrow indicates the "current frame", which determines the %context of most commands. 'bt' is an alias for this%.F5""" self.print_stack_trace()!pdo_w = 2herXdo_bt*ef _select_(Y, number):%assert 0 <=a < len0.|-D.curindex 1Lq1 = C[ :O][0]5t_locals<1curL#.f 6'Wentry r lineno = None V0defY!upEW, arg'"""u(p) [count@MoveF cur7 & (default one) levels up in3vV @ (to2Rolder)("if_TV == 0XKerror('Oldes' 'ereturn:tryG= int(arg or 1Bexcept ValueEl =rInvalid#a%s)' %n#if1<1new$E = 0BJelse'kmax(0,?-` CD%Bdo_ux)upC2dow?E_d(ownG1eIO newH0+ 1L  M?NewZ O - 1l?in(= ~+~!d~  _untilnt(il) [pWithoutpument, inue execution [ ?u with a ]p greatea0onereached. t! aL E~0|tFor equal to thatxIn both cases, also stop when   the current frame returns. !U """ uif arg:$:trylineno = int(arg)3except ValueErrorA`self.e!('#0 in|ument: %r' % Y{ p3if 1<= Z1cur2.f_ q"until"F number is smaller thanG'{'nB'Jelse?XENoneiAset_(,&nom!! 1? do52 = 2il  efAstepO,l"""s(tepVExecute R, stop atfirst possible occasiont'P(eith]n a function`tpco@d or i?2)( s& OnextVn(extSContinue eH is reachet a. n3 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"r1qimport nD0 = F[0:1_"%.)a(`[:0] =%v0k`# thisdcaughtUmain Eloop3craise &#o_@3run;gB(g0 ]&r cJ`c(ont() b, only0wheencounteredN2notnosigint!Pdb._previous_sigint_handler = \ rsignal.(.SIGINT, self4intI)Fexcept ValueError:p# happens when do_continue() is invoked fromHa non-main thread in which case we just U withoutK set. Would pri g a message here (once) makeHmsense?EpassE'etreturn 1$ = ! " efPjump(Wf, arg)t"""j(ump) lineno5Set 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""" "ifecurindex + 1 != leng.stack .eo('You can o}#"e 'z6tryGdParg =(c( `"The '`' commrequires avnumber"Jelse 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)sys.settrace(Non!Ktglobals6?loc)_&qp = Pdb\.completekey tdIastdout p.prompt = "(%s) " % self.prompt.strip() message("ENTERING RECURSIVE DEBUGGER"4Etry:AHsys.call_tracing(p.run, (arg, globals, locals)Iexcept E:ionVexc_info = aj()[:2]`error(eback.format_dion_only(*GT)[-1] OLEAV1setz(@ _dispatch]lastcmd = 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)1setreturn 1To_q ==0do_?EOF1EOF*qHandles receipt of EOF as a comman %+''8OargsVa(rgsQPrintargument lis@currfunctionccDcurframe.f_cod0dicS$_bn = co.co_argcount + kw|2#if flags & inspect.CO_VARARGS: W?n+15KEYWORD9for i in range(n/!Ename0var:s[ii0if FqB"*%s = %r' % (8 , 6[ ]9OelseO*** undefined ***^SBdo_a-IWZoretval\j\`value H\ _of a e bif '__00__'C- O "OArepr.4[YYUQ*'Not yet3ed!Rdo_rvAt/_gA  er }5.f_ X info()[:2]  4self.error(traceback.format_exception_only(*exc_info)[-1].strip()) M raise def _getvalJ(m, arg, frame=None):/36try "if)@ is , "return eval(YdA.cura.f_globals, z_localsOelseb Z T@ RDt = sys.e()[:2] oerr = # I#_rstr('**d %s **' % err)Fdo_p"""p expressiondPrint the value of *.+5""" message(repr.D&))]Jpassoetty-pApV".p](complete_QE = _tgp&'Nqdo_list  l(ist) [first [,last] | .]List source code for1current file. Without/quments,C 11 lines aroundC or continuepreviousG3ingl@ . aMgn/, e GnE one Cstarting a.!atE two@sAZgiven range; iaesecond"ar,less than@, ita count.DThe |9i7;indicated by "->"bIf an 0ion. bedebugged,_Awher8was originallyor propag}8is FP">>",it differs fromzpcmd = '']! = ifA andj!= '.' if ',' in7 0varg.split(',')1q = int(  last = int( .strip()) "if0< first:%8# assume it's a count.y" =T! +c ,Oelsep?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_#4qbreakli1get&_$s(2N;trypines = cache.get >,vglobalsWa_printK!s(G[10-1:]<!, ,EWreno = minR, len| ! <2 qmessage('[EOF]'xKeyboardInterrupApasspdo_l = Bist !ef0ong(q,)C"""l Q | ll9Lthe whole source #P for current functionF5""" %zb,y2gets."OS>[as erhPd6err? F+ V  expressioTry to get given object and display it. 4obj_getval(arg'f ; T: =L(obj`# (R, Typ3/) K)complete_E = _Ndef _print_lines(self, lines, start, breaks=(), frame=None): """Print a range ofBE."""&"if>8?current_rBno =$#.f>,3exc = self.tbQ.get(U, -1)7Oelseq V%-1;1for"no in enumerate(" 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@item1ing7self.curframe, {}).items():  self.message('%s: %r' % 1).Jelse<aval = >_getval_except(arg9n%displaying.setdefault(curframe,[arg] = val~EN 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 ofcommand line; Sall other words in the line are left alone. 1As 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= , lineno = frame_lineno if frame is self.cur:#*prefix = '> 'Oelse( (Ymessage(K+F`+format_stack_entry(, 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 debuggerlsassign to a global variimust always s2a '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(0R and th.exists(filename): return fif = os.path.join(syE[0],/)05if 0 exists(f) and self.canonic"==`mainpyy[root, extsplitext(@/"if,J= ''Z,% = + '.py'>Visabsa L8`or dirD in 6 =Uwhile/sislink(6 Iread0+Afull| C7%ifI"QNone def _runmodule( ", _\._wait_for_q = TrueP)user_requested_quiFFals*import runpy?1mod{_spec, code =)c._get_details(J UD.co_t*_%__Q.__dict__.clear(:"update({E#!"_d__": "4,",$$ )qpackage,@6}.parent,jloader+ +G ) "builtins&&__*}@run({)cscriptb# 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). So we take 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 passed if noO " "exception is being handled") 8p = 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'D1Q#:]] # Hide " " 0pdbBionsPargum3lis4 = @realT# ReplaceR 'sA U inTnt ofpsearch Y.N0dir 3# Note on saving/restorJ8`: it'sood idea when C wasL2modq(byV>2. IP(baO'itI@chaniH@usermV p. There0a "art" command # @which allows explicit specification of command line arguments. pdb = Pdb() .rcLines.extend(?s!while True: 16try if run_as_modul+pdb._run (mainpyfilef#?els=oscript=1if guser_requested_quitjUbreak print("The program finished Owill be restarted"except R nXfing", v, "with:W \t" + " ".join(sys.argv[1:])SystemEx# In most cases ( does not warrant a post-mortem sessionE2exited via @().  status:", end=' 'N6c_info()[1]%eSyntaxErroritraceback.V_exc(>c]Fit(1VJb("Uncaught F" Entering@ @`debuggzH@Runn3'cont' or 'step' wur& t %3t =p:*2]@db.i ac((None, tP" %er  . ) +l2 " 2 # When invok[st,6er on a  if __name__ == '__2__'`import  () """Create " able serialized representHsI@PythS@bjecAR See  copyreg for a mechanismSregiscustom picklers.Dtools source?Asive Classes: PO "UnHar Fun'adump(o&, nsp) -> stNQload(+<qs(bytes4 Misc variQyP__ver1!__=dformatcompatible_ s  from types BType~!dispatch_t#_V2on_ry, _inve)CcachqBitersSislicfwpartial 2sys%sycmaxsizAdstructpack, un import re import io im dcodecs_compat_pickle __all__ = ["PError", 5ing!Un63Vr", ")eG@dumpOs Dloads"] try:@Sfrom  baBuffer%.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-". !_version = "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}8QemptyL APPENDS  = b'e' # extend list on stack by topmostslice GET>FgFpush item from memoN ; index is string arg BINOLhL0 "b U" ; a1-byteL8INSLiLbuild & class instance LONG_6j6.4-LIlL_ Xes EMPTY_D]>Qempty@ OBJ*o*h(PUp6Sstoreatop inJ}qGxLGrGsxSETITEM sGadd key+value pair to dict TUPLE3t5@RtupleE)?D Sm+u+amodifyi0addo s(DFLOAHGHs`float;`8P enco[W TRU`I01\n' not an opcode; see INT doc, pickletools.py FALSL?I00K" # Protocol 2 PROTO.A\x80Pident5# p8H NEWA\x815aobjecti@pplykcls.__new__2argFEXT1'A\x82MmL8sion registry; ^ EXT2N3Nditto, but 244444454!1-2top 96929;two3G7G3GOhreeI8NEWI8I@True&9&BFalsa'Blong< 256 bytes^b7really big B1 _\Psize2AB = [!, 1283] 3 (Python 3.x) HBYTE<B; counted binary\ument SHORTBYTES = b'C' P# " ;  L" < 256 bytes # Protocol 4 SHORT_BINUNICODE = b'\x8c' # push short string; UTF-8 length YD8 JdJvery longN BINBYTES24e4:EMPTY_SETl:f:empty set on the stack ADDITEMS9!90:Rmodif6by adding topmostA items FROZEN!91Gbuild frozenOfromGNEWOBJ_EX!92GRlike ## but work with keyword only arguments STACK_GLOBALRO3Osame as R usYnames's MEMOIZEFK4K@tore6 of] in memo FRAM;!95=indicate9`beginnof a new frame05 )TARRAY-6S"array NEXT_BUFFER7-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.BFIO()H1endbF1if I.tell() > 0Rcommie(force=True)* H,xce=Falsf ?f = Eif f.$ "or `@dataB.get(%" ( if(T?) >>MIN:# Issue a le call todmethodhunderlyingPp objectIbopcode@3izeWL. The connation is expectedbbe les_nsiveP0tha< su!an`P%al.@write(FRAME + p ack("BabovRovoid aImemory copy.QStart2new0 a  io.BytesIO instance so thatj#Gfile object can have delayed accesspreviouswP"via an unreleased qview ofyNH)self.current_6 = :( 2def(1!, &:u0if  IJoreturn'.*Oelse@n_7_large_bheader, payload)\G" =YR# TerminO and flush ith ?Commi(force=True# Perform dirm r'u binary#0. Breful noeh[_KPpriorQing '' as we doZ1wan_@allo1 a Itemporary "AWe iEtionally]insert a protocol 4QopcodP6mak#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'nD1An"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#ifY6!isc9@^`# Protiteration by usXa list copydBsys.Ds against dynamicPthat trigger importsBSothers upon calls to getattr. for module_name, in sys.s.copy().items():;?Bif ($? == '__main__'&* h)p, # bpo-424069 is NoneYcontinue56try"Cif _Sibute , @)[0]Z:obj6:creturnfexcept AttrUZErrorBApass0G def encode_long(xQr"""E0 a a two's complement little-endian binary stringNote that 0a special case, ing an empt>,qasave a@bytethe LONG1 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) != ;.C:-1]T &de Gdata D _from vg2b'' 0"<"'?255) #7f)Y7++* $80*V8,(/12&"12@int.aOMT # Pmachinery class _2er:$__init__(self, file, protocol=0, *x_imports,Zbuffer_callback<;$"""This takes a%q@writa e D3eamGThe optional *a* argu`tells  erB us~UgivenP; sup%eds are 0, 1, 2, 3, 4o5@defa4. It was introducedPython 3.4, and  is incompatible with previous versions. . Specifying a negative protocol2 selects the highestC-upported. T1r<,Pused,Gmore recent{ of Python needed to read%epickleDproduced*file* argum_ must have a write() methoUat accepts aYsingle bytesH. It can thus bNi object opened forGabinaryting, an io.BVIO instance, or any other customD^that meewterfaceIf *fix_ims* is True and *0leskan 3, Vwill tryz1mapy4newp3 namesold module4 in7a2, so 7t data stream'ab2buffer_callback`None (adefault), (P view?serialized into=8s part of@not 2n i40be !edVnumbe(jiTaB. I? returns a false valu(such as)d givenVis out-of-band;v@wise59is &4`, i.e.!id6B$tan error if *Y 3 i(`smalle^Uan 5.#5""" &if;:   = DEFAULT_PROTOCOL(E?< 0AoHIGHESAPelif F0 <=<<= 3 \ raVE6#(" beW]%d" %Q) qpW?< 5 LsV>= 5"}lself._4=:tryAe_0 = . 7 ex Attribute6 IT2Typ ("G H'T4' aF framer = _F ( P =K"f.= A(r_large_p4 _bytes  self.memo = {} @protAint( Jcol)#dbin = Z >= 1!fast = 0ix_imports = f6andOA< 3 9def clear_(!):@"""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""" <.Q"()bAdump\, asWrite a]d representation of3 te open file.zp# Checkbther P was initialized correctly.# only needednQmimicbehavior_.b.)0if `shasattr "_ _w"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,)thb allow toimplemented@a plAG(butgrowable) array, indexO6key i ereturnYassert id(obj) not in self.memo idx = len()Rwriteput(idx)"Q[id(obj)] = idx, obj I# Return a PUT (BINPUT, LONG_ ) opcode string, with argument i.I@def ,e!):"ifproto >= 4 ruMEMOIZE7$el9:bin2 ifcj < 256P + pack("yt)@if f "f # Call unbound methodexplicit Go,lprivat if any, or  S# copyreg._ '3%',`D))O a!a Qa customfa; treat as regularh#B if issubclass(t, type): self.save_global(obj)*}return !# Check for a __reduce_ex__ method, fall back to#_L< = getattr9, "U~", None3if @ais not'Crv =-(^protoSOelseB_/" raise PicklingError("Can't pe %r object: %r" %G(t.__name__,G&))&rstring ITed byp), mean"B as "if isinstance(rv, strAJ, rv5Assert thatxa tuple_ $ 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# This exists so a subclass can override itVr0kkpg7pidv!# a id referenc6binue`(pid, _o[=Fals=5write(BINPERSID2[:tryvzEB + ).encode("ascii") + b'\n'eBexcept Uni-E3mXyL" IDs in Rcol 0be ASCIISings"x=&, func, args@ate=, listitems8dic$ state_setter7> |PAPI in"ll;Esome"esdif not isinstance(args, tuple): raise PicklingError("/ from save_reduce() must be aK%")Kif not callable(funcj(j Q5") l = self. Twrite 5i@_nam qgetattrA, "_j__", "cproto >= 2 and I=<ewobj_ex__"[Pcls, K@, kw! =91has4[ew__"B02[0]I!{}f has no __nL vJq.format)0if obj iZat None4clsobj.__class__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 this*,dreturned byshould be"edF!_,its firstu( B, aDll. TheX7for\ 8R@s folthough peF>wayaverify #k7def!,  # D2 [  PTcols Dwilla referenceMv G:(above) R F`remainp< BQwhichUsa at unatime #% (see load_newobj below). If __reduce__ returns a # three-tuple, the state fromathird item will beGpickled regardless ofAprotocol, calling __setg+__GQat unL)GtimeTbuild 9  Note that nosndard _# __ implementation exists;Fyou have to provide your own. This islenforccompatibility with Python 2.2 (es written using= 0 or 1 inCa3 shou5{able byEu)).cls = args[0]if not hasattr(cls, "@Y__"):,Opraise PingError(%)"naRQobj__pi C0if !isNone and obj.__class__J)awrong n)")Y*1:Z@saveP 27 e(NEWOBJJelse?Ffunc%mVREDUCE) ` e#R`objectpalready@memoEis means i&a# recursive. In tE1cas}row away everythwe put o+ aastack,QfetchpBbacke if id(obj)Pself. aPOP + 'Aget( 0[EZ][0])~O:1ize# More new special 1s (BworkFPolderYEs asd# well): when4V5's,D314thZ15th!niteratorsdGlistE.sC di/tems (as (key, value)0s),.0if SH# Q_batch_appends(7 N1set.(8 O+ if{ te0ter)%M A~UBUILD else:  2# If a state_setter is specified, call it instead of load_build O # to update obj's with its previousm.;First, push%1andCPtupleexpected argumentsOR(obj,I) onto the.ck~Xsave()R#obj) # simBINGET opcode asAalready memoizedq jwrite(TUPLE2# Trigger function~boREDUCEbhe purpospto carry-out an+# inplace modifica of . We do notF@e abG@whatMmethod might return, so`outputeventually removed fromPQPOP) 91# M}s below this point are dispatched throughb tableJ+S = {}0ef V_none(self,!!):{[.3NONJ[type(None)] =J ]Obool]1if `proto >= 2y }EWTRUE i else NEWFALS1C @= Olong :binm"en1o fKigned 4-byte 2's-comp# format, we can storemefficiently than {generalHJcase!# ` one- 2two2unsJintsJ>= 0~<= 0xff $`BININT1 + pack("d'H>& _bytes proto < 3`if not A: # G ect is emptyC )cqreduce(7A, ()= 5K G#cs:,B0 1(stm, 'latin1') >obj qn = lenr*ff/SHORT_BINBYTESr !elUB> 0xIbff anduO>= 4n_oq_large_j(u8vQu=g framer._FRAME_SIZE_TARGETvuIu 5 D +v3vmemoize_array56L4/K s,m>4YTEARRAY F   if _HAVE_PICKLE_BUFFERpicklebuffer,w+< 0#praise PNingError("!eB] can only pickled with " "protocol >= 5")5Hobj.raw() as m:!aif not m.contiguous%)raise PicklingError("eBuffer canL@be p'ed whend"pointing to a non-! bg 7in_band = Truebself._A_callback isONoneY_bool(FZ(obj)y#f >[# Write data in- I# XXX The C implementation avoids a copy herBif m.readonly'save_bytes(m.to 1?els8 O_arrayS O ,oout-of0xw\(NEXT_BUFFERSREADONLYWdispatch[A] = S 42def1strZ , J1if 6bin`encode ('utf-8', 'surrogatepass'n = len(5d  <= 0xff Pb_4!SHORT_BINUNICODE + pack("vf|_}T_larg8Q, =p framer._FRAME_SIZE_TARGET I K_ RYKPobj =a.replace("\\", "\\u005cV/0//00/n/a/r/d/5x1a11a") # EOF on DOSaF:praw-uniU-escape') +DHGb'\nV^qmemoize 8 5str;strtuple(self, obj):  if not obj: # tuple is empty !if self.bin:!write(EMPTY_TUPLE)(Oelse: MARK + ;ureturn On = len(objdbsave = .Dmemo  <= 3 and9proto >= 2for element in/Gu(%# Subtle. Same asEthe big comXibelow.WQif id1 ]4get@get(%[5J][0]1POP * n + get*_-size2code[nk1ize "# C0 or 1jb isn't,"'> $_# has more than 3sa; ?( K Qd was0in 6 when we entered dxe(), sof # Rprocess of.1ingB%'sp must h3TdI30 it/&: Frecursiv0Theper actionL0now3to throw away everythwe put onc`stack, Gsimply GET((it's already constructed). This checkKRcouldbeen done`?"" loop instead, butJ:s are a rnq @POP_6 U5-- 1available^ * (n+1)a3No &onM U.dispatch[]2ave!depe_list(G,)8-.FLIST 1 catFuse 3'UV%! 7 _b_appends$<    _BATCHSIZE = 1000  Th, items): # Helper to batch up APPENDS sequences save = self. Ewrit  bif not5Ebin:Ufor x in items f9(x)4d( greturn0t =^!r(c-while Truewtmp = list(islice(it,_BATCHSIZE)Hn2jen(tmpJ > 1c3JMARK2>tmp:"SY elOKjtmp[0]1hhp# else . is empty, and we're done}, = 1 onlygE7;Ok, v: k.(v, CiS2V 48s=<5[0]'fjZ/se!.6< 4$L_reduce(set, (x!,)*= areturn write(EMPTY_SET) self.memoize(obj) it = iter1 while True:+ batch = list(islice(it, b_BATCHSIZE)|6n21en(> if n > 0g5JMARK20forQm in U?'0sav.emB^ADDITEMS <careturn @disp[set] = zB_seti2deffrozenset(1 , X5< Z X"ifproto < 4Ph.M_reduce(1, (!,)= v?}(;objEQif idp 9# If the$ect is already54, this means i&f# recursive. In-@case8 row away everything we put o+eKstack, and fe0objback from.>8@POP_<" +g [K][0]@oFROZEN Qfglobal, name=None) p `^0ameONf = getatt, '__qualP__', 6Obobj.__Aamodule ="chg:try__import__(6I, level=0:"2ys. "s[7]-obj2, paren_Sibutem except (IError, Key AAttr?raise Pickling"(%"Can't p&e %r: it's not found as %s.%s" %=Q)34;elst if21o c)s Kc J>= 2E code = _extension_registry.#3)if code:  assert code > 0  "if<= 0xff:!'write(EXT1 + pack("= 3.Hif self. 4Rsave(_ #STACK_GLOBAL<?not__reduce(getattr, (=,<];3 + bytes, "utf-8")e'\n' +781 ky`fix_ims_ro_mapping = _compat_pickle.REVERSE_NAME_MAPPINGr`GoIMPORTI:if !Z) in @,+ =8[^+DMC| 4[T v>tryQ?_ascii? C 5C*except Uni!EnNrrorpraise P(@ingE%(Tr"can't Rw globalS '%s.%s' us"D>lcol %i" %.,ip)) from%e Rmemoize(obj)@def `_type(% ,  ifC#VNone)LL00, (2!,)W=[m7obj\tImplementedf<p?...e?...Z h ispatch[FunctionType] = save_global dispatch[type] = s!  # Unpickling machinery class _Ber: L ef __init__(self, file, * x_imports=True,2"encoding="ASCII", errors="strict", buffers=None):C"""This takes a binary} for reaY1 a e data stream. The protocol version of te is detected automatically, so"noH argument8kneededo!** * must have two methods, a#()U thatnn integervS, and<Jline@ requiresI%no;s. Bothqs should return byte#RThus Fkcan beobject openedP io.BR%IOF1, or any other custom  meets t[rfacedZT-like9em[eEm eBl nE RrjCr CIf **0ot D, itFn iterablec20-endlaDconsumed each time referencan out-of-bn view. SuchZ|been givee order!tos_Pback*1a P'rU  (Zdefault),Xn1areyn~Afrom#p, assumPthey 8serialized05re.DIK"an_Ps* toijE0wasduced with a non-:O Ooptionalq5*fi'D*, **|**, which: us o control compatibility sup{F Bp generaby Python 2.  Hwill tryB0mapuE oldL` names2new$in0@3.   T tell5howGto decode 8-brtring instances pickled by Python 2; these 0default to 'ASCII' and 'strict', respectively. *encoding* can bIp'bytes'IBreadgs 8-bit Nng instances as 0 objects.5""" self._buffers = iter(S) if  is not None else GPfile_pline = .,( $memo = {} 4 = !1rroe @protV0fix_import (def load(0!):@"""R$a n representation fromR openYEaReturnreconstituted hierarchy (rified i0b # Check whether Un r was initialized correct|wThis isEonly neededxQmimicbehavior of _[.dv.dump()s!if>qhasattrF@, "_1"TTraise@ingE&("a __A__()3calLF"%s.EA" % .__class__.__name__,))._unframer = _U >", , I# =)U1 q(!inU ,0o\ 0metastack = []dappendb&. @p8 0dispatch!6try{while True`key = a&(1x+keR1EOFzassert ispR(key,qn_typess[key[0]]2'except _Stop@stop^ r,b.valueK## I`a listitems push3 after last MARK80rucpop_markWP!]V.pop(*2+8 Ftersistent_W, pidI4EPunsupEed pG1 idOuntered")l#{}ef load_proto(self): proto = .read(1)[0] if not 0 <= ,<= HIGHEST_PROTOCOLOVraise ValueError("unsupported pickleLcol: %d" %)wpxdispatch[z[0]] = load_, %"ef\frame_size, = unpack(' sys.maxB 8 * 8 o1_un!r. (. XFRAME * lpersid:try8pid line()[:-1].decode("ascii"except Uni D& Z!Un1ing#(6"stent IDs in col 0 must be ASCII strings>Rappen.N_KC(pid?hPERSID@5dA2bin D3stack.pop(!>BIN =nonuBNone9NON1C VOfalsW F! XiEWFALS\I ]?tru\ =TruYEWTRUZF Yd 8)t(u=BINxd{_yastring|w, value# Used to allow -s from Python 22be Pd either a#sI0UniI. This should be uponly with theN# STRING, BIN and SHORT_ opc%s.9"ifencoding == "h*s"breturn>Oelse'.@.aje&s)tD1j U# Strip outermost quoteibif lenGQ >= 2 [0[0] 9-1]in b'"\'',0 =  [13the  argument mustdi cs.escape-[0&~ 2bin # Deprecatedvuses signed 32-bitx5gth#?len~/le8Q/e = /lep ZE]l \ #I #> maxsiz| BINBYTES exceeds system'sFPimum K% "h " of %d bytes" % maxsize) self.append( read(len)$dispatch[BINBYTES[0]] = load_binZ O2defqunicodeP!):n_k!tr.oline()[:-1], 'raw-B-escape'xUNICODE2 3binnlen, = unpack('< raise UnpicklingError("BIN exceeds system'sHPimum % "N"Z( , 'utf-8', 'surrogatepassX[E^8_ Q_8_78`8a8ba``^_ =# ;ytearray<^YTEARRAY=R1b =Qbinto(bMb M fnext_buffeb"ifQs is None@Oe stream refers to out-of-band data@but no *s* argument was given":try`buf = .3pt StopIterationD(not enough  "uf{ NEXT_BUFFER[0]] = load_next_buffer def load_readonlyq(self):$(`buf = .stack[-1] with memoryview(buf) as m@Dif not m.l # at = m.to/!()rdispatch[READONLY_BUFFER[0]] = short_binstring4len{V(1)[0Idata2lenaappendW._decode_k>)/SHORT_BINSTRING Qbytesp j_BYTES0uni(!tr=7( , 'utf-8', 'surrogatepass'[UNICODE QtupleyTTitemspop_mark A2 ITUPL, aempty_ (]mEMPTY_cO ic1d1 = !,(q1aXm2LXm 2:[#o;2],})E223\3333Olist+[]lHLISTbMfdictionaryl /{}l?DIClSr/se /SEm;setf`frozenG@uE6 kFROZEN4 V,  d w Kwpop_mark()  d = {items[i]: B+1] for i in range(0, len(.e), 2)}/self.append(d)dispatch[DICT[0]] = load_dict # # INST and OBJ differ onlyuhow they get a class object. It's notI5sensible to do=P restMa common routine,4twosIpreviously divergedCgrewent bugs.3k!isSto instantiate,Bk points thpmost markJ, following which are]`argumeDx.__init__Wdef _{(!, +, args):m@if (0 orK2 is:3ce(1type) or37thasattr$`"__getLG__")c06trytrvalue = (*;8except TypeError as errJVraise(("in constructor +%s: %s" %g .__name__, str(err)), sys.exc_info()[2]Jelse PBew__^781)-TPmodul<>readline()[:-1].decode("ascii"k? = 45Qfind_!(m , Tb[ }@,t@pop_"()2   ) @arg12%mPcls =6rs.pop(0)3clsW?8OBJ;obj?newsobj = clsp ^?2obj^;NEW<_ex/kw  (B, ** 8_EX;_exlglobalQ_utf-8 4Piappend(klass)  dispatch[GLOBAL[0]] = load_global '"efSstackq(self):!%pname = .(e.pop() _modul" if type(J) is not str ormCraise UnpicklingError("STACK_ requiresY"aappend.find_class(w!, 39\?* EAext1d=5codread(1)[0]<get_extension(2 HEXT1i|2|, = unpack('!if8:keyo!if <= 0: #%e that 0lforbiddet# Corrupthostile c%e.)EXT specifies=SValue"unUered AQ%d" % pF*key$ [5obj.Gdef X%), tQ# SubAes may overridu&is:sys.audit('Ub'^*"ifproto < 3 andfix_imports4  in _compat_{NAME_MAPPING>B<[jBGCelif6oIMPORT  8[y_%__vlevel=0 VJ>= 4 _getattribute(msu+OelseMLGlreduce=p ,@argstack.pop()  func = stack[-1] ! =%q(*args) dispatch[REDUCE[0]] = load_reduce '"efpop(self):_0if .g7del Jelse-Epop_mark(8POP>pop9G.V[_MARK[I `-du[aappend )DU,du1getBbi = in.readline()[:-1]_a?tryEgmemo[i3except KeyError?0msg%'Memo value not found at index {i}'raise UnpicklingZ(msg) from None1o8GETu;getp?binwV(1)[0 / as excd;BIN Rlong_ 4, = unpack('bin> maxsizVG/J  Bing"% w ]=  ^# Use the faster _if possible try"-% ( ;ingO0&erA*!s+ s) except Is k4 = &, Ho , !s,f,mAs, _srDoctest x# d q..mod() if __name__ == "__main__"import argparse parser = arg .ArgumentP(&*$description='display contents of the pickle files')<Vsr.add_a[U'1_1', type=FileType('br'),Nnargs='*', help='zy-t', '--tes "acstore_true'qfrun self3o suitejOv', `verbosely; only affectsx3runv# =.gb"s(x if s.:<_"Felsebif not4!{fr.print_K Oimport p/for f ino +obj = load(f\. (obj) '''"Executable doca " 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_*sq. # Other ideas: # # - A verifier: read check it exhaustively # well-formedness. () does a lotpthis al]&y.~<$nt@exam= return its rq number1(== highest .% attr value among2!).L) !s binfo a7endr HTple, tuple-building  is sometimes more}Qelabothan necessary, cater>Zossibility thjJis recurP. OrsPa PUTgOdF's never ac{!edM by` GET. Q"?"Fa@gram a virtualb(PM, butduly # called an un8p). It'RsequenceWs, interpreted bNktaXbitrarilmplex Python object. # # For the most part,PM is very simple: re are no looping, test or # conditional instruc s,4arithmetic and1fun  calls. Opcodesf* # executed once each, from first to last, until a STOP oCr2@ed. The PM has two datafPas, "astack"Rmemo";CManyW s push Python objects onto E; e.g., INT.2 # integer<6 on9, whose valuebgotten a decimal string # literimmediately followingWipickle by@reamu0the*cs takeQs offR0. Oresult of unXwis # whatevyis leftB whe fi/ oy an array, or it can be 0menBas a dict # map@4tlesPIr@servsPM's "loa0ermNqemory",;J9litWPindexSD@akinrvariable # nameFSomepBop aYoMt a given j1, #o!a ++ a2 b againxSAt heat's allK. Subtleti#brise fRse reasons:1+ O. identityysarbitrarily covxV2sub\P mayshared (q0exa0list [a, a] refer~ saZv a # twice). I7@vita(atrecreatexisomorphicK@grapaithfully reproduc2ingW+ RecursiveBafter "L = []; L.append(L)", L&@L[0] is@rela RRpointNssequence s in order toG1get%cright '!in=TcasesdThingsZdoesn't know ? yt about. E:u>;'s builtin scalar+qcontain types, liks#AtuplThey genzPly hasss dedicd0theaVPmodul 2fer_0amuser-definedKPclass!'sAledg+limited. HistoriR@y, m0enhYments # have been made to the pickle protocol in order Qa lat^result is most likelH` excep>! dA seeIn unknown (in| olD) original used what's now called "2 0"$C was" # "text mode" 3 32.3F0entvM@ byt51eamPup ofArint# 7-bit ASCII characters, plus`vnewline,aR. # Tgwhy it D. P0 smfelegant, bu@somes painfu%in\second major @addisca1a \obinary^ #ismany opcodes w&ith arguments # consisting of arbitrary bytes, includ2NUL and unprintable "high bit" ##`. BinG2mode pickles can be substantially smaller than equivalent # text A,{sometimes fast:oo; e.g., BININT represP a 4- # int as 4p follow the opcode, which is cheap^ the # (perhaps) 11-characdecimal strZ#attached to INT. Protocol 1 also added # a numberso t operate on many stack ele at once (like APPENDSPnd SETITEMS)9"shortcut"s6EMPTY_DICTaTUPLE). # # The third major setadditionme in Python 2.3sHCd "p # 2". This:dp- A betE0way170 in.0cess new-style classes (NEWOBJF?Sfor ayLidentify its u (PROTO;QTime-space- efficientJpof longMs (LONG{1,4}DSd s @ tup(S{1,2,3}}Z- Dedicated9BboolTRUE, NEWFALS-"extension registry", a vectoJpopular objectRApush{ l index (EXT0kinR5Amemo0pGET, bu `t re predefined (there's nothYaX'S PUT\A*!er0pen change w|pabandon)<Pany #5at it might0afeBload es received from untrust7parties -- no su,security analysis has been doncguaranteJt  nd8re isn't a use cas0war1e expenseqsuch anmX Tos end, all test__safe_for_unding__ or apyreg.' 0truQs are remofE C. # Referentese vari/s(8rdescripAQbelow`!to!ee"s 'b#jl2 before. # Meta-rule: Dg`stored Zhp9.2, #ZPplains p. No mgplanguag ,J# #Yps couldWed. If you want,XML, write a littl,pprogram2gen2XMLUF. ###############& # Some pickle opcodes have an argument, following th(0 in # bytestream. A8 is of a specific type, described byhinstance #/AvD&ptor. These are not to be confused withqs takenLf stack -- Z applies onlyWs embedded iL, immediately #anG. # Represents`number35sum} delimit thnext newline character. UP_TO_NEWLINE = -1xU two-{P wherwUfirst`_ giveu second1. TAKEN_FROM_ARGUMENT1 2 # numC0 1-q unsign~t@4@3@4@>little-endian inLU4LN8N5N8No class (object): __slots__ = (`# name\_9 record, also a module global0;UtringI'H5', # length\(,"s;:t; 7andB{1,4,8}  egative values for variable-~MUcases*'na function @a fiHBike J`, readthis kind\a# from91 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) (4 1C/4C0UD   TAKEN_FROM_ARGUMENT8U)) 1self.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 v!areturn1[0]9 raise ValueError("not enough)0 inaeam to A")  = ArgumentDescriptor(]taname='.*',*=10er= doc="One-byte unsigned integer. w2w-2(wL\x00{4O6553 2@len(m) == 2\a(">> import io2io.BytesIO(b'\xff\x001'))D1255^L ' * 8)) == 2**64-17ATrue  data = f.N"(8fpif len(C8eturn _unpack(" "v of %r" % (qX4;@1A"UbreakFelse:(r)R0 = 2cs._%DC[0].c"ascii rM@! IOgnl 2 4  =UP_TO_NEWLINE4eadF %4""A-terminated string. This is a repr-style 1 , with embedded escapes, andKbracketing quotes.&""") def read_kRnl_no`A(f):8jreturn&1(f,pa=False) F = ArgumentDescriptor(X name='F/',2=UP_TO_NEWLINE)0er=7 doc="""A newline-terminated/st>out>or  It should consist solely ofK printable ASCII character,1 V_pair61""">>> import ioCio.BytesIO(b"Queue\nEmpty\njunk"))G' 's "%s %s" % (pJ(f),>P<.pA? ofsFThese ar s7?s, CThey I & !AThe %2is t@ed aKsing #a 3blank separasthe twon 1 )1(E\x00{pnP1u3abcdef72abc:2n =@uint&assert n >= 0data = f.p"(npif len(b) == n .decode("lP2-1"=raise ValueError("expec@%d bS in ax 1, but only %d remain" %r 3(n,ta))) strin g1 = ArgumentDescriptor( name="string1",=TAKEN_FROM_ARGUMENT1&preader=_J #doc="""A counted (+. qThe first a is a 1-byte unsigned int giving the numberL0of 5As in%sR, andYecondithat manyKH.""") def Q4(f):*Ar""" >>> import io 4io.BytesIO(b"\x00aabc"))9!''R@ 3@5defC?abcFG3abcFTraceback (most recent call last"..6ValueError: expec50331648a4, but only 6 remainS 2n =v0intsif n < 0fraise ~(4t2 %d" % ngdata = f.e(pif len(g) == ng`eturn .decode("latin-1"R!%d#%d1" % 6(n,B)) 444'  #-4little-endian    L 31 3 b1 %b'?@uintassert n >= 0 $@ D1 I  'A of bytes, and the second argument is that many ,9. """) def read_%Q4(f):)Ar""" >>> import io3@io.BIO(b"\x00aabc"))81b''R@ 3@6defC?abcFG3abcFTraceback (most rec4call last"..4ValueError: expected 50331648]R in a 4, but only 6 remainQ 2n =s@uintrassert n >= 0 if sys.maxsizefraise "(" count >; %d" % ndata = f.(pif len(g) == np`eturn !%ds#%d1" %K 6(n,C)) 3= ADescriptor(CSname= ,",=TAKEN_FROM_ARGUMENT4U'0er= "doc="""Aiestring. wThe first@a 4- little-endian unsigned int givingOnumber ofk>8 , struct,c /8(  %P %D )b'50bigL38 =.pack(">> import io,uct, sys D@io.BIO(b"\x00 aabc"))LB(b''~_ 3_ ?defb7abcebigsize8 =.pack("= 0 if.fraise %("8 count >? %d" % nUdata = f.(pif len(g) == ntQeturn^%(%'#%d(1" %O 6(n,G)) 3= ADescriptor(GWname=#,",!=TAKEN_FROM_ARGUMENT8U'*0er= &doc="""A3drunicode/nl cT < `abc\\u\njunk")}''MATrue LRline(<0ot .endswith(b'\n'_`no newH found when trying to A ""! =P[:-1]8a# loseTsre1str_s, 'raw-W-escape')  w'B'*n=UP_TO_NEWLINE' [3(-terminated Unicode string. This is raw-unicode-escape end, so consists ofIprintable ASCII characters, and mayFtain embeddedKsequences.(""") def read_string1(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: expected 7 j in a , but only 6 remain G0intassert n >= 0data = f.-"(n  ifY()nreturn str#, , 'surrogatepassfraise %("/%d2%d ~ "v" % (n,J)) . = ArgumentDescriptor( R name="?/",+=TAKEN_FROM_ARGUMENT1,^0er= u0doc="""A coun UjyThe first aa- Bsigned in giving the number of6Oecon!--QPUTF-8 odd"of ? --v0cons that manyH  42, 04.4(-TW4G if sys.maxsize: `raise ValueError("unicodestring4 byte count > sys.maxsize: %d" % n) data = f.read(n) if len(data) == n:,return str , 'utf-8', 'surrogatepass'Jexpected %dzs in a , but only'"~p"remain6(n,J)) O = ArgumentDescriptor(V[name=L/",+=TAKEN_FROM_ARGUMENT4U-_0er=_0doc="""ABed Uz_ing. The first a is a 4- little-endian signed intLgiving the number ofkQ, and'osecondM!--*UTF-8 encodd"of ? --Kcontains that many..""") def |Q8(f):72r""f>>> import ios = 'abcd\u'enc = s.#e( 91enc,b>xea\xaf\x8dD2n = ([len(enc)]) + b'\0' * 7 # 8Qengtham?t =io.BytesIO(n +w^fjunk')s BTruebX9TS[:-1]OTraceback (most recent call lastv"..%: 78"6  S0intassert n >= 0 if d 8bC2%d  b8b+8b8b8bP$n cHhe second  argument-- the UTF-8 encoding ofnicode str=-- H contains that many bytes..""") def read_decimalnl_short(f):8Ar""" >>> import io<@io.BzIO(b"1234\n56"))6 R@LATraceback (most recent call last"..'ValueError: invalid literal for int() with base 10: b'!L' 2s =,nl(f, deq=False,rpquotes)# There's a hzTrue and = !if s == b"00"breturn.'el*1*a;/s)Olong u<  P@`5678909 9L\nI ,o\Q[-1:]6'L' as[:-1]m ^ LC = ADescriptor(:h kname='B/',.=UP_TO_NEWLINE'f0er= 3 doc="""A newline-terminated,;DegerO. This never haPtrailA'L',1intS?fitQQin a p Python1 on.Pbox wMopickleLwas written -- but8no guarantee it will W!iso.o n@mnldkXji<hbcan repres2ls0of GOsizeKPfloat r""" >+>> import io >>> read_floatnl(io.BytesIO(b"-1.25\n6")). 1"""2s =@ stringnl(f, decode=False, rpquotesLqreturn xQ(s) nl = ArgumentDescriptor(mcname='2,',=UP_TO_NEWLINE0er= # doc="""A newline-terminatedBimaling literal. `In gen# this requires 17 significant digits for roundtripKidentity, and picklzuthen uninfinities, NaNs/ Kminus zero doesn't work across box>or on some[ evenJ on itself (e.g., Windows caV`A thengs it producesJ1 or+).'""") defsQ8(f):(r1uct#Praw =uct.pack(">d", '3b'\xbf\xf4\x00'(4I8Hr+ b"\n"H@data = f.7"(8pif len(b) == 8?7_un)1[0]Rraise ValueError("not enough *0 inaeam toS8f88;n=8\ ~ !|n 8-byte binary representation of a, big-endian0TheYmat is uniqueaPython  shared with1jmodule (forLng '>d') "in8cory" (6ucteHPimple@s do/H =0 -- y should). It'8pstrongll to5 IEEE-754 doubl,nl0cas is!Rfact t0cal0f ] On other=>dynamic range@limiP"at:754 "add a half]Rchop"40sed reg J`precis?to 53 bits. However,a;boxa S@may gbe handled correctly(+rsurvivelintact# Protocol 2rs from@edecode_long def read_long1(f): r""" >>> import io2io.BytesIO(b"\x00"))(0@.X2\xff6?2558$7fn_32767: 00v:O-25698-t8;. 2n =O@uintOdata = f. "(n pif len(b) != nz~ aise ValueError("not enough 1 in stream toq "[return decodeg! & = ArgumentDescriptor(aname="&"",=TAKEN_FROM_ARGUMENT10er=fdoc="""A binary, little-endian, using 1-byte size. pThis firstas one %as an unsigned4c, then)AthatCAmany31d interprets. m H 2's-comple.K If4lP is 0qat's takenKshortcut for.?2 0LBZ""") g4g,4(g25EDQF]EiO 0 0intif n < 0 4Xa count0s %d" % P444 4 representation of aL Afour`sY@ (buQquire8be >= 0)   E/  L 0int;AalthLONG1 shouldlly be usedFinstead (an case where #_s < 256)o/ ##############6 # Object descriptors. The stack used by the pickle machine holds ob@s, # and in+=q_beforeafter attributes of OpcodeInfo # we need names to!bebvarious typH that canwppear o. class S(;): __slots__ = (#* record, for info only3'5', #Dq, or tuple s (meaning1# b52anyUxN)r0'obW human-readable docsthis kind; a stringYQdoc',)def __init__(self,2", ,hbassert isinstance(.,hG.! =Mj?g)Y[l_(if % kcontaine- %)7,~H# =& ?docPdoc =]<Creprtqreturn yV pyint = pylong =)S='intB=intdoc="A Python integer93.")c_or_boolf % n(o =)v r$:ean9v oh ]@floaCQ: _` @ytes1str1 w (bD~:@(Uni)'* yr^_array #fj ^ul:strf?str`3 Ononedb"None"U](f  = StackObject( name="tuple",qobtype=doc="A Python  object.") pylist = StackO] \[ Z?dicZ ZZ Z/seY:setX?setWE `frozen#b. obuffert' ' .X-likeg2any4h?anye ny kind of\ whatsoever@Omarkh "$ 0mp""'The /' is a uniqu Opcodes that operate on a variable numbers generally don't embed the count+1 inog, or pull i%fs'. InsteaGRMARK 4used to push a specialcOA, anJn some oth)s grab allkas fromutop of L down to (but not including)1Cmost Q@. ""_slice6"$$An; representing a contiguous socd ThisPconjunction with,_. Mp followw)5top@. For example,OHPOP_Qchang|!e  wY[...,"E] to%] No matter how many !ar?0 af' %, qgets ri)5m ( DT too)#: # Descriptors fKSickle)s. class RInfo("):U__slots__ = # symbolic*;lQtringn,'!"',O#  D Va bytestreamFx5; aT# one-characss] sIK has an argumen0dedr Ux# instance o'f ArgumentDescriptor specifying its type. Note that # arg.reader(s) can be used to  and decod<e1nW fromIthe bytestream s,9_qdoc doc6 s (format of7rawHaMB. I&!opdoesn't have anembeddedK!in`,/p shouldUNone.1u'arg', a# whatCstack looks like befor3is runs; a lisa':_/]after th\. [d protocol number in whichXwas introduced;Q'inE \`human-@ableIs foestringLa'doc',)b def __init__(self, name, /N", !, ,!):h2assert isinstance(dEstr)%}.! =? ?d@len(j) == 1]! = ]parg is 8 orOarg, @= Z*,Fx%C@x, SfObjectMLI# =}FW $0H cAint)B0 <=x ickle.HIGHEST_PROTOCOL C 6l 0doc L=q I = ORInfo Rs = [X`# WaysPspellbegers.I S='INT 5='Iarg=decimalnl_short:=[]Jp=[pyintt_or_bool'$=06doc="""Push66G This a newline-terminate literal  Dbnt mayG0bee*W lw90fita0rt PythonFtbut INT5QgenerAin p  s written on a 64-bit boxrequire acBlong1$321.difference between athis !and LONG then is that INT skips a trailing 'L', 0pproduceSshortKint whenever possible. Another differencenadue tou,= bool was inthcd as aGdistinct type in 2.3, builtin names True False were also added toL2.2.2, mapp tot1s 1<0. For compatibilityqboth directions,Mugets pickleH+ "I01\\n">!ase0.H@Lead@zeroc3re Rfor a genuinteger. TheH(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 signedGMis handle e full range of Python ()>s on a 32-biCbox,/ lypbinary }Ps (1 / opE4!in)I IfpBnon-negativ0fit=r 1 or 2h,X$viK' `2 save$4acer15='KEuint|<2one/un ipace optimiza\ery small J5int"inE(2562M2binaryconversion). Proto 2 added linear-(in C; stillJin Python)Q1 and 4 opcodes.*R"""),I(name=" 31",!.t='\x8a'arg=long1stack_before=[]after=[pyintp$=2*doc="""Long integer usone-byte lengthA more efficient encod23f a ;| 1%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_strQ0JQFPushos object The argumFis a repr-style, with brackete qu9charactersxhperhaps embeescapes.lextends untilCnext0new c>spe usual]eWd40o a instanceHF5thed givenUer constructor. ortdefault'ASCII'. If uTQwas '' however,(0y wbd1as .?eadO'BINXTXWWr5twoa s:` first%3a 4ittle-endiaVQsignew,$thj`secondjBmanys, which areqn literV!asRHcontent 2Gowever, they will be decoded as bytes object instead.'a"""), I(name='SHORT_BINSTRING', P5='Uarg=string1#stack_before=[]after=[pyu_or_str$eproto=Jdoc="""Push a Python n. There are two arguments: the first is a 1-y unsigned int giving0number of6!inGzR, andPecondXthat manyEds, whichaken literallyiR content.sI1usu0`into aance usingPencod given toFkUnpicklernstructor. or:default, 'ASCII'. IfB ZQwas '' however,.y zH1# B( Qcol 3prhigher)BINBYTESB4 3Cf,4little-endian?>  Ot,$ C"X!w qQ  'x8cE\x8e8v'>?2n 8EN7farray 5YTEARRAY-96Yybytearray],! proto=5,doc="""Push a Python bytearray object. .There are two arguments: the first is an 8-E unsigned int givingK1number ofrAs inH:Q, and`second\that many4Rwhichaken literally asBU content.R"""),# Out-of-bxbuffer (2Qcol 5rhigher)2I(name='NEXT_BUFFER'code='\x97arg=None#stack_before=[]after=[py >n oREADONLY8 @Make6 read-only.# Ways to spell YENONEN#Knone0M" obools, starting with  2. See INT for how this wasr# done A5 LWTRU?\x8_5ool.=2 True ontoC oEWFALS9,^OFals i0UniL stringstlUNICODVuBA$nl6= R0, #may be pure-text, but it's a later additionF!    ca raw--escape encodZof a Qk0so ain embedded Gsequences. Thyr extend q untilgnext newline characterSHORT_BINO\x8c1)4E# the first is a 1-byte little-endian signed int giving the number of 9As instring. The second is that manyI44, ae UTF-8 encodc!ofOUnicode W>a"""), I(name='BINUNICODE', 95='XRarg=uPO4*stack_before=[]after=[py<tproto=1.doc="""Push a Python object.$re are two arguments: Pfirst=?a 4/un8E\x8d 8_)H?n 8# Ways to spell floats`UFLOATF7/nl5 R0C Newline-terminated decimaCeralWM@qrepr(a_l)uPn gen6 requires 17Uificadigits 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 -- WindowsLqis likeJP), buPy do less damagRn BIN onses withHwgreateror dynamic ranE .?{oG  oFQ stor@ binr,# 8sof data0 This gener,ally requires less than half the space of FLOAT encoding. In general, BIN%!cannot be used to transport infinities, NaNs, orLminus zero, raises an exception iexponent ed`e rangKan IEEE-754 double, and retains no morep53 bits`precism3(ifLthere are3that, "add a,^chop" roun#4 isJcut it back53 significant)Xa"""), 8`# Ways1build lists.I(name='EMPTY_LIST',5 code=']arg=None stack_before=[]after=[pymtproto=1+doc="PushAmpty.eAPPENDa uyobject 0""AppendKUaP0 S r: ... 3 ana*(: *%+[+]WalthoughMQis re}extended in-place IS:JeJBmark!, D_sliceW 1""E Ja by a SRa of rftq;Rlnf$ Be0out^rtopmost/y!,  0R Allentries followingR?#toa single PythonJt, whichA1 reCSs allI_ fromonward. For example! O1 2 3 'abc'n /[1, 2, 3,(])TtupleUTUPLE&) o0', code='t', arg=None stack_before=[markobject, jslice]-after=[pytupltproto=0,doc="""Build a , out of the topmostg h!, [ #. 1All6 entries followingR? are placed intoMa single Pythont, which 1 reESs allKOfromonward. For example,S~ ~W: ... 1 2 3 'abc'n/%!: /(1, 2, 3,())C""")eI(name='TUPLE1code='\x85 2any2Cone-bPitem "hePThis  pops one value ofUand pushesyflength 1 whoseCpsis thatPback onto it. In otherDdwords:Wxb[-1] =N(/:] 26/, :?two0 tw em|.s2stP$ 2:[{S2:])]837=?hreP t ES0eV3B33# Ways to bxSdicts EMPTY_DICT} m1Push an empty /.d, stackslice],! stack_after=[pydict],tproto=0doc="""Build a + out of the topmost R slice, Y markobject. \1All6.entries followingR? are placed intoMa single Pythont, which1 reCSs allIOfromonward. The alternatesLkey, value, .... For example,S before: '1 2 3 'abc'a/b!: /{1: 2, 3:(})C""")eI(name='SETITEM'ucode='sarg=None _(R, any >32Z AdXAkey+7 pair to an existEq|*": -*|0whe[ has been modified via 1r[key] =^._bSScuc,oYIe1en arbitrary number zs{ 9is 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_SET"E\x8f% ,se4APushVmpty set.!0ADD! O\x90gpyset, /""Aitems1y The slice of the stack followingtopmost markobject is taken as a sequence of items, added toGset immediately underaJg. Everythat and aft7 spopped,M@leav=mutated $atz#. 8Sbefore: ... py9!_1)_n<': <\SwhereOhas been modified viaQ.add(YBi) =ni for i ilP1, 2,A, n, in that order.R"""),P# Waybuild frozensetsI(name='FROZENSET'Kcode='\x91arg=None#D_6&=[+,Xjslice]-'E=[py!tproto=40doc="""BaD outJ j,,1All entriesalaced into]a single Pythont, which F0repMSs allL'ofAfrom onward. For example* :S1 2 3o)"({\33})- E:manipulation]A5POP(;08 2any! _%=[ 0 tDiscard6x<, shrinkTq by one!.#,DU23 OPush4 on]again, duplicat.itEMARK( }?^ !"". B a unique7a, usedpther opsidentify adregion containa variable numbMffmKto work on. SeeA.docmore detailzWOPOP_WA 1,""Pop all the stack objects at and above the topmost mark%A. When an opcode using a variable number of sdis done,GPOP_MARK is used to rem4ose,eMthat delimitK@heir rtposition on.;R"""),# Memo manipula3. There are really only two oper&Rs (geCBput)# each in all-text, "short binary"T"long flavorsnI(name='GET'V v5='garg=decimalnl_a+_before=[]after=[anytproto=0.doc="""Read3Q fromMm3={push itefThe indexa7y=s given by[newline-terminatedN@ strfollowing. BINGET4TLONG_re space-optimizLversions~DqhTuint12w)Ewg1-byte unsign(integer mA1z&6j64646little-endian D,PUp<! BStor o` cknot popped51loc0@writ toCa *PU#reG  q } }Jation to write into is given by the 1-byte unsigned+eger following."a"""), I(name='LONG_BINPUT', code='rarg=uint4!stack_before=[]Waftertproto=1%doc="""StoreM@ topomemo. The is not popped. index of8 location to wri;4;little-endianIuMEMOIZE5EE\x94HDNone GanyobjectPYYaswnumber of@elements currently present in2.r# AccesV`extensregistry (predefi,ps). AkW;1GETX# family-EEXT1%82 2Ez!istA andsimilar EXT2`EXT4 a using a  @popu6 that are pickled5, typically classes! Itc@enviye at through a global negotif3and0pro, third parties can set up a mappsbetweenGi:  s-In orderguaranterchangeability%e KcA tP#be`, althiO`6Ss mayF0be rved for private usepc has a@argu& isx usr"o $th,*aeis pushed Kv m='\x83P0See01. 2K1twoM" 4four-byte integer argument. a"""), 4# Push a class object, or module function, on the stack, via its mo'Land name.] I( ='GLOBAL',& code='c arg=stringnl_noescape_pair2t_before=[]after=[anytproto=0.sdoc="""cglobal" (i.attr) Two newline-terminated s follow"0 op. The first istaken as ah* , AeRecond! LIE. is pushed More accurately, Hreturned by self.find_W#,*)fI, so unpickling subDes can override thi:rm of lookupGbSTACK_^=de='\x93PDNone>Ppyuni6%, 3+R 4YR% Ways to builds8Le doesn't know about directly# (user-defi?). I desVW1doctHcomprehensibly -- you really have@readJ \3 toGAA all"special casesZeREDUCEF5='R C 'n`t from,qallableRan ar`T tupl-d0@mind__reduce__() method0 Sk t: ... cz!pyle)): )#(**)G 0 artwo items wVby a r Apply[e!to1argssuppose0pro,eoriginat least get itDrted9!If: s!3- lK@onen3 ano be pas3z's __setstate__ ,N ,ftcreate K%'sVTaKSBUILDa=ap to that argumqent. 0If not isinstance(callable, type), REDUCE complains unless the D 3 has been registered with, copyreg module's safe_constructors dict, or6\sa magic:1'__= for_unpickling__' attribute~a true value. I'm4surwhy it doeis, but I've & sEthist often enough when I didn't want to .R"""),I(name='BUILD',!ucode='barg=None stack_before=[anyobje2 ]+Wafter*tproto=0. doc="""Finish building an bvia __setstate__u updateVS e: ... argument+*: +% \'reBmay havek mud, as follows::!IfDB cmethod.*()\ UalledAElsep, must be a3theLSEs__, and+#is`Td viaC.(/ vEINSTeuiustringnl_noescape_pair. Bmarkg!, Uslicej_B a class oTi!e col 0 version of1's OBJ op$ i6ed by two newline-terminated as, giv0, jcGLOBALP (andRDfor more details about that). self.find_(z , q)J)0sedt5get:8In addition, all$As onOdtopmos are gathinto a tupld popped (along:T N)>STUPLE=0Now3get icfo!se` + Thgis empty (` was aPe topOoZ"estart)b]mgetinitargs__Guthen weIPcreatV old-stylew`7invokingits __init__(+) method (pickle has waffled on this over the years; not calling __init__() is current wisdom). IJcase, an instance ofK an old-style dummy classQ`reated:dn we try to rebind itsI!__8__ attribute(sdesiredY`objectfsucceeds,J37new2Dpush"re stackwe're done. G`Else (MargtupleBnot empty, it'sU o does have a __getHargs ),8S codePfirstists that"tvVsafe_for_un(Sing__If. Unlike as f/__< check in REDUCE!itn't matter wheth'isa true or fadPvalueOConlyGsHQit exB(XXXZA bugpF5, UPErrororaised&\)B Bobtained from INST's argument9sapplied @_`resultJ?is bNOTE: Tw/@awayPython 2.3.hIdistinction betwee8sand newF-!esRJ mmake senseusR"""),I(name='OBJ'I5='oarg=None I_before=[markS%y %jslice]8after=[an+tproto=1.doc="""Build aTi!e Acol 1 versF&of10'sH0 op4d iZvery much i<The major differemQ akfz@Allowntbe retrievCmemoH1reply if several[3s o^3ameRare cM0. K caOmore effici(in both time b`space)4&n J`embeddBodul6 Ksqgs@, OBJ take\p streamcnstead"soNn off the stac k, immediately above the topmost markobject: Stack before: ...%b class1 s)DslicU:qafter: :new_instance_7gAs for INST, remainder of`#isgathered into an argument tuple, andMn logic seems identical,K0except that no __safe_for_unpickling__ check is done (XXX this a bug). Seethe gory details.NOTE: In Python 2.3,8vOBJ are =0howy gee o@. Twas always2/Bent; @mple4TationZhad diverged1acc4al reasons.xR"""),I(name='NEWOBJ'\code='\x81arg=None#_wR=[any ]+h*tproto=2.doc="""Build"X 2The should b8Poughtas containing alZfollowed byp R (the0 beDF0top>@CallssAargs!eypopped of0<Zvalue return`cls.___(cls, *X)@push%3ackoWH5_EX%92&4 | keywordCdictv$ # J#M 6#U, *kw, -/ (# Machine?3rolx1UPROTO)<%80<Tuint11P*col version indicatora For ='2:LA, a `e must:rrt with op1\iV} in range(2, 256)EgESTOP"code='.', arg=None,  stack_before=[anyobject] uafter=[tproto=0%doc="""Stop the unpickling machine. paEvery e ends with this opcode. The 1 atRZ!of Nis popped, and that's&result ofZA should beKPempty;#n.R"""),`# FramssupportI(name='FRAME'e='\x95wTuint8$xYo4<oIndicatep beginnof a new framyTer may us;x to safely prefetch data from itspunderlykostream0@WaysRBdealpersistent IDsAePERSID/BP?stringnl_noescapKtPush an~identified by a  module doesn't define what> means. _Pargum%"isline-terminated str-style (no embedded Ss, nopbracketquote characters)Fing, which *is* " " =Ppasseg#isHVself.?_load(). Whatever returns ushed on reno impleTationNft in Python'ser: it must be lM subclass 3BINQl&1n"CLikeyr, excepg0 IDw^7 of| (instead befaiR byte3TpLvadUVXRGX$Se for more detail ] del I # Verify uniqueness].|. m@rs. 2i = {}   o@i, denumerate("1s):Bif dZ2in Jraise ValueError("repe+0 %r5ies %d and %d" %  (d.name, 22i[p], i)) 5if d.code in 12i: raise ValueError("repeated+ %r at indices %d and %d" %CG (o,Bv7 A = i'0C delP, i, d #: # Build aop dict, mapping op characters to O )d6py[]!OE 7UQ.py usesZ@"butYWre usg,;D- Sp# Forgeis one. Any left over$|7end are a problem# of a different kind.#FuJelseVRappea1havhOwithx"[NR %r, a don'ta  (name, picklecode)) #if copy:  msg = ["we appear to have<0 op?cs that.py doesn't+5:"]P@for 1a, d inm.items()uy.r@nd(" %r withB %r" % (d.,0raise ValueError("\n".join(msg)) assure__consistency() del ? #:C # A;O# generator. def _genops(data, yield_end_pos=False>if isinstance.bytes_types& Jp = io.B !IO.!) if hasattr, "tell"?getpos = H.9Felse%lambda: Nonebwhile Tru/Q5(/ifread(1~! =2op.get(1!.d("latin-1"$ifg!ispde == b"" ZC exhausted before seeing STOP"D (ZTosition %s,%r unknown{A#"<0`>" if j ,FYHS.arg P 0=d^p%K.e{7*if Da, arg, N;:'.'wcassertx7''BRbreak5SB"""Ge all theUs'a.='<'ta file-like object, or stringPntainT9GCEachfe Xed, fromdcurrena:Pstopphqafter a_s delivered. A tripleiA for4e:B HAan OInfo record, describ7!If0 anC umqembeddeCCw itdvr, as a Python:. i#r[LS  y() method0 wae value of pick%le.tell() before reading the current opcode. If pickle is a bytes object,Iit's wrapped in a B$$IO&A andHlatter's result isHused. Else (wdoesn't have a<,U{not obvious howLto query itsposition) posQNone.01"""return _genops(O) #:R # A \ optimizer. defA(p):#'O"$ a40strby remov un?C PUT!s'>put = 'PUT!ge#GEoldids = set()#q of allV"id2new1"{}*1tby a GEZp#[]9 # (op, idx) or (pos, end_posproto = 0Hheader = b'3for`, arg,G, yield_cS=Truep"if34R.name!;.add(arg5 s.qnd((put)'0elij] == 'MEMOIZE'jidx = len(tEl@ &C'FRAME' 2pasY6G4 1 >  P# =. x[arg] =   /geq\PROTOof>9arg ifq0cp[pos:~]F;elsi  ! =9Bdel Y a# Copy> except a PUTS without a corresponF1GETCS= io. tq# Write[z any framinZPout.w2(-? 1._P0r(ol0*=F>= 47 r.per.start_ 3ingxr6argsO:@elesQFalseo6put0O2in  "&vcontinuQcdata =`r.put(u$newids[arg] = id7x idx += 1elif op is get:4data = pickler.get(newids[arg]),Oelse:@[op:,+Wframeless = len(g5) >h r._FRAME_SIZE_TARGETF*qcommit_q(force= d5if  Ofile_writew: .qQr.endBing(return outWvalue() #: # A symbolic_ disassembP def(,=None, memo indentlevel=4, annotate=0)I"""Produce aqjcy of a!. Q'r'z a t$-like object, or string, containing a (at least oneMJc. TheeVed from the current position, through"first STOP opcode encountered Op<al arg 'out to which|Ay isqprinted. It defaults6psys.std"1 stPython di7qused aso!'sbsmay be muAd byW), if7vPs PUT1BIN !s.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 shortnadescrion each line ed2putU` givend'@mustN0an pger andahint for column whN0ionuld startD@is 0a$no4ionaIn adddy, some sanity checks are made:v+ All embedduments "make sense"+ Explicit m pop opera;Ps havZ{ items onUstackLtWhen aniNly refer,da mark:a markobject i1s actually on the stack. $+ A memo entry isn't referenced before it's defined:The markobject<stored ik[0jU2"""# Most ofphair he s for sanity checks, but m0iq needed# anyway to detwhen a protocol 0 POP takes a MARK of{,Ha(whichcurn isgZbindent<blocks correctly)LP = []# crude emulationunpickler"ifis None:DcP = {} ? R /<1maxU = -1<6max@numb3een3,rk# bytecode posisFp"chunk = ' ' * Qlevelaerrormsg =1ann = Atateolumn hint2ionn&o~`, arg,rgenops(`)F"if"Qs not}print("%5d:" %,, end=' ', file=out)0line = "%-4s %s%s6b(repr(.)[1:-1],7';`* len(w)< nGnameDmax(#, /)={_t do9 mu7kafter 6/# 7numtopop =g# See whetherPshoulP poppc!  TQn4or 5 == "POP" anQ= .@[-1]PNlaassert 1in Nq+if __debug__e^)-v#\slicewYNQpos =%V.pop(cp-  R!"(lat unknownYset)"@7elsAV0%d)"po^/# Pop everything at1topB.Cwhili3T} J stack.pop() # Stop later code from popping too much.9Mtry:]numtopop = before.index(markobjectexcept ValueError[assert op.name == "POP" 0!Nelsecez`msg =  "no MARK exists on sP%" R# Check foCrrect memo usage;)ifin ("PUT", "BIN VLONG_MEMOIZE") K* )_idx = len((as %d)" %;P>arg is not None9=~Ri = arg%ifp1 in "L key %r already defined `Aelif[ # empty -- can't store into xa:@[-1]>Vo ]4?thej[a2] =hA$GE {j`after)11 = `[arg]]! #G0betL emulationEhas never beeAored*] if4 or # make a mild effort to alignFeuments[line += ' ' * (10 -) V+ repr(argH\?msg@ 'knnotat7 sannocol 1 d:ion3WWzN> 50A @R+doc.split('\n', 1)[0]7`print(9, file=out)4if  # Note that we delayed complaint`until `offend~a# was &ederaise ValueError(errormsg)  # Emulate the stack effects.%qif len() < numtopop:"Nraise ValueEi ("tries to pop %d items fromjiwith "FJ U"only>T" % (,%))G/if2dely$[-C(:]7markobject in afterwassert (!no,ebeforeL%3.append(posz0extkprint("highest protocol among opcodes =", max, file=out"if Rempty STOP: %rg") # For use&doctest, simply as an example of a clasrickle. "_E%def __init__(self, v>)D." =p _dis_ = r""" >>> import pox = [1, 2, (3, 4), {b'abc': "def"}](cpkl0 =:.dumps(x, 0)@dis("Y@0: (AMARK@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@ @P 4: K*pBININT1 / 6# 8Y/y92S/11!aB8) 14: q BINPUT 1 16: } EMPTY_DICTD7: q82D9: caGLOBAL'_codecs en ',/35I3A7: (;q MARKD8: XBINUNICODE 'abcW'46W%4F4F alatin1I/59I5IP61: tbRTUPLE (q at 37),2M66B4: R8 REDUCE!77 1def7>8>T77: srqSETITEMD8: epAPPENDSP79: .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 TP 1: l2LIS% 0 2/ 5$copy_reg _reconstructor,.30J(#33#34[\#56\2PP_builtin__ objectM MTP82: N1NONe'833M#84O#87.88,2+91/P92: db !91~.93R;P96: V5 'value/108?`106: I8$IN> 4s3110`111: b. 112: a%@3: g%GES1M ,7d!$1]}*s   2#c 2 $4>6l E(!W_, 76: q  aBINPUT3 78: NANONEC9: tQTUPLE (MARK at 31),R80: q' b4D2: RQREDUC`/83454D5: }4EMPTY_DICT686D8: X8BINUNICODE 'value'#/98@7 100: K@@INT1!42@2: sqSETITEM@3: bQBUILD@4: hRBINGEw`106: epAPPENDS ZY`107: .\STOP highest protocol among opcodes = 1 Try "the canonical" recursive-object test. >>> L = [] >>> T = L, .append(T)L[0] is T TrueTL&)?dis(pickle.dumps(L, 0)` 0: (fP 1: l2LISH 08@2: p#A 0@5Q@6: g*.5n.10n1nP13: aY40#1#]dh)3.63# 7Jn. 901 Note that, in "0 :1 ofq tuple, disassembler has to emulaWpe stack[PorderbrealizuC3POP]16 gets ridy/0.T I2 t# 3 6]7 6/11~#14e@5: 00POP*161k2XZ7T, Z611: k o2E45667{!4 10: a APPEND 11: 1 POP_MARK (Qat 0)'@2: h&`BINGET ! 1@4: .STOP highest protocol among opcodes = 1 Try 2. >>> dis(pickle.dumps(L, 2){ 0: \x80 PROTOk0 2{P 2: ]EMPTY_LIST@3: qRBINPU057bq5 TUPLE. 8EP10: a^7APPC2T00POPZ1423 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 a2 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, =&(f06: q BININT{3W&eT2 S=5/13$2"G /16'18| highest pro'tocol among opcodes = 2 """ __test__ = {'disassemblerq': _dis 7,  ,Amemo%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 3 between i"-lzindentleve4 {l} <=="&"if+Athan<4 is specified, print this before'R'y0'--5Vrun self3o suitejv`verbosely; only affectsx$ru63 = VX"s(E ifs.S>Felse T= 30 >-! 08Hbif notbO%!r._elif len(.Cj) == 1I=dis(B[0],^f, Nonede`pd$, ($ r:E= {} )h ?for f in T+'h$s..format(.0=f.9.B$e(?T + '\+:f(tlevel, anno(tate) """Conversion pipeline templates. The problem: - Suppose you have some data thatwant to cg another format, such as from GIF image<9PPM. Maybe the Y involves several steps (e.g.ing it through compress or uuencode). S of^^Mmay requiraN eir input is a disk file, s 4pbe ableread standard:; simila0 thSoutput. `=pthe entbalso 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 ` namesyd;each timi-M=objects so"an7sD 6tqthem inc@ary,D0 ince. DiresD ToaB: t = TT!()*\add aT <t.append(command, kind) where  v0str#wo characters:` first)3'-'7 Q0s3!'f/$it;W second likewisCg@mustvalid /bin/sh syntaxf vq d,^passed as $IN R$OUT;s,uc possi6in k/o  beginning_t.prea`ile us sts = t.copy(inm,Q 0) I' ( #0mpt ,biis written, respCvelyreturn valueGv@exitb0tus~YIMp1forq!orw  Fg!fpL(0, m 0'r'e*or 'w' to write it -!- just like for the built-in function open() or $Bos.p . To create a new templ*object initialized to a given one: t2 = t.clone() """ # ' import re $os file # we )VquotePrathe!anamodulebackward compat # (="usbe an undocumented but ;in pipes) from shlexO __all__ = ["T?"] # Conversstep kinds FILEIN_OUT = 'ff'70# Mread & write real Ws STDFG-G @aB0STDA/f- @?@-@aNormalJline eleru SOURCEO= '.B be first, s stdout SINKE .Pbe laFZE@in ]", POUT, 2IN_\ , ] class )FQ """Crepresenting a1Q.""" ``def ____(self)Ky%""() returns a freshU8Kp.debugg1= 0o8t()Ct.__)5 s 1(t)Y4 '< instance, s=%r>' % ., "t.Pstore X4itsi stateZv ] yyb|pwith id5calo2ial1 aspcurrent 5t =T%()Dt 7[:] $%t$l, flag  RYr off {! =WqcappendrAcmd,L w& @ addx21 atF9end~if type(cmd) is not'''daise TypeError('.}p: cmd m` string'!ifc!invgNValuhppend: bad kind %r' % (kind,)) 0if  == SOURCE:"raise ValueError('Template.append:7 can only be pre9ed'iself.steps and q[-1][1]?INKalready ends with SINK}![0d1'f'not re.search(r'\$IN\b', cmd)missing $IN inD?OUT0>OUToa((cmd,1)) 4def(0 #S"""t.D adds a new  at the front."""cVpif type<P) is /''x=Typ:iP mustya stringzd!in si1bad-Ka HcG0FITbeginKLRMBNgO insert(0, /RCopenOfile, rwN#p returnMpipe or  object -E forP{or writing;z0ile`Pother"1 ofZLline rw;'r'"0_r( ;w; w;~kE: rwP\'r\'a\'w\',5%r'  P% (rw#T'_r*!t.4 implementSn!g, 'r')7w') respectivelyyu#~Or:N] == SINK:  0raise ValueError('Template.open_r: pipeline ends width SINK') Icmd = self.make2(file, '*return os.p`(cmd, 'r') M@def 0_w(N , B!):lbif notjVsteps^4pen|w}'if:[0][1] == SOURCEJ wPbeginLt#'' #Ccopy inP, out $Hasystem1  =~  .* 3-;.debuggingSPprintbn'set -x; ' + cmdU .6y# Build a list with for each command*a[inputname or & string, kindg-]kA= []o 9A in <u..append([q:-a]*#K# Make sure there is at least one\+Vcq'cat', '--'sTspcare ofv '0and?o[1] =x":3!ifC![0@'f' Kb insert(0, eT G \-1][15 d-T(# Invent temporaryxs to connect stages that need"Egarbage kicrange(1, len()Gl\i2r'][1if ;](1or 1+NA(fd,1) =0.mk"p((os.close(fd$2 ![o]v4@item&(P[inf,xf/BV= 'f'A@OUT=`quote(F^) + 'OO'INN9infMd if kind[0] == '-' and inf: `cmd = + ' <' + quote(inf)*"ifM1M?outN >N+O@tem[Lye#cmdlist = a[0][1]for item in61:]Q[cmd,1] =(B[1:3:"if ':0'f'Z0  P= '{ q+ '; }'! O3|\n5-Jelsed1J + '9if garbagA rm= 'rm -f1@file 599Ctrape (<; exit') 1 2 3 13 14 15GR Z4`return.(+ """Utilities to support packages.""" from collections im&namedtuple#functool!singledispatch as simplegeneric H=lib^.utilmachinery&os T.path$re 2sysEtypeModuleTyp(warnings __all__ = [BR'get_er', 'iters"Bload Tfind_CTwalk_^2DmBbdata',1AImpInSEImpL`read_codeIpextend_<Info', ] 6 = &('K_!er( ispkg')Ba.__doc!'A%  with minimal'o about a X.' def _.Rspec(j,F)B"""RBthe !--CificJ r# Worksclegacy8!s.L2try\.R_@# =&..except AttributeError@ =(Z3if -gis Nonuxl1lib._Th,]p [1)~=s(streamx# This helper is needep order PEP 302 emula1 to # correctly handle compiled s& marshal magic = ."(42if #!=~MAGIC_NUMBERW]U12) # Skip rest of he.return marsha2l.load(stream) def walk_packages(path=None, prefix='', onerror=): """Yields ModuleInfo for all ms recursively50on a, or, if @ is X,:accessibleE!. ;'9' should be either; wr list oUs to look@%inQ'a string6output on the fronVSeveryQ nameV2on 0UNote that this function must import*q`* (NOTP$!)Dgive5in order( __!__Apattribuo find subV'which gets called with argument (thm$ A`was beM0ed)any excep oc6`le try3%to& W. If noU!isHsupplied, IaE&s are caught and ignor%Pwhileq oAC7propagat/terminathe searchKExamples:#python can p t)>dRctype 9.%, q__+'.')q2"""eseen(p, m={}R in mreturn Trubm[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   top-leve-0on _1les in. 6 'prefix' is a string to output on the front of every module name &0.1"""pif path[QNone: importers = iter_!()%elif isinstance(G,)Eraise ValueError("& must be rq or lisslook for !"mTs in"sumap(get,!) yielded = {}xFi inSq, ispkg&_B(i, !if@ not=}a$[mQ] = 1"! M@Infos.) @simplegeneric def3=''ot hasattr(1, '.return []8.6("` # Iment a file walkercnormal1libQ hook_Y9_finder{0os.V.isdiL` inspect6tryf0os. l7except OSIB# ignore unreadable directories like6Q doesM{.sort() # handle packages befnPsame-djs! fnM0mod3RB.getC2(fn ifY=='__init__'F1in &edb:continue4 = Ejoin), {g= FalsF 5andR"g ) 4'.'*fn?E= fn 0dir;ent"l @!G)&= 3' '0sub03if 7 \,ITrueYbreak(el7$vE #aX  [!8ix + modname, ispkg iter_impor modules.register(  lib.machinery.FileFinder, _Eafile_f_H) def a1():T`global[with warnings.catch_3.simplefil'ignore', DeprecationWN)`<Pimp =r0ort('imp') class ImpI"""PEP 302  that wraps Python's ">3ic"g algorithm W(dirname) produces a cGcsearchesFdirectory. O(NonOJthe current sys.path, plus any z are frozen or built-in.BNote' does notd`ly supl being used by placement!onPmeta_.2"""lR_init__(self, &= b> ("This emul0S is d?0ed, .' instead",Or 0ort(j! =&`, full& # xR: we  ' `' arguO since it@onlyed via ^0subk% =v.split(".")[-1]*4if -!.P and 0is /areturn N?elf6* =6Jelse\&"[oP.real$^):try> , R, etc..$`exceptortError]ImpLoader( )&n, prefix=''^k W#QisdirD yRyielded = {}'2pec,`Zs = os.list|RM/OSI#unreadable ies like|~UW[ .sort() # handle packages before same-Cdfor fn inEsO0mod;V ns-B.get6(fnQ ifeC=='_'J3in  j>continue path = os.path.join(selfw, fn) ispkg = False f not modname and oV`isdir(a)1'.',iin fn:FlCM= fn>try26dircontents ={Elistx Hexcept OSErrorS!# ignore unreadable directories like import doese-[]%for fn in\1sub]= inspect.getmodule(3if ;=='__init__'d0MTrue!]breakOelseY@inue<#a packagJF.`yielded[!]] = 1% prefix +!,  class ImpLoade"""PEP 302  that wraps Python's "<4ic"algorithm1"""code = sourc 3NonDdef `, fullb, fileFetc)warnings. ("This emulation is deprecated, use '@lib'Hatead", D<BionWh_H(>! =Y !! !etc = etc9Rload_ <'w_reopen PPmod =.WH%, kfinallbDwTg.close# Note: we don't set __er__ becawe want theule to loormal; i.e. t3is just a@per standardmachinery`returnjget_data#Qwith , "rb") as7 e3.&()m:bgv .BZdbpmod_typ)Zetc[2 if&==imp.PY_SOURCEKDmr V, 'r'31'el_ (bCOMPILED,.C_EXTENSIONAev&b': _fix_name(self, fullname): %if is None$4 = self.B(elD!' M(raise ImportError("Loader for module %s cannot handle "l$"m9Y" % ()Gereturn def is_packageF=P_fix_V( i etc[2]==imp.PKG_DIRECTORY|get_cod}=h"ifWmod_typeNk if&Y_SOURCE,UsourcM3X= compile(5,@fileb, 'exec'aCCOMPILEDo_reopen(KO>try4Fread.JofinallN 8k.close4 _|delegate().j/  1YS)@ile.A_modulesorter, prefix=''dirlist = s&%d(A.L_directory_cache[er.archive]D_`# =2er.plen = len(->yielded = {}1n inspect`for fnAcif not fn.startswithq +/continueJf0fn[:].split(os.sep)*!iffn)==2 and fn[1]}'__init__.py~i if4!0]3in -[fn[0]] = 1'" +`L, Tr>!=1r0modBYr(a%=='q>b4'.',y G 3ed[0E%A,c, Fals-s$err.registerL~,^-) except IRErrorppass g(path_item"""Retrieve a finder #the given 3 mQThe r%$ed11is dW@sys.4_uhij was newly created by aiVhook.jW (or part o@) can be cleared manually if ah0res$5of Y0s izcessary.+1"""KpP er[Atem]?7KeyKM, s) H! =#_8(9.setdefault>rqLYbreak^ n.z Jelse1 = *O/as(full&""YsR name If !fullname contains a '.', the finders will be forpackage 8Ding L, otherwise/y@ all registered top levelIm(i.e. those on both sys.meta_path and _hooks). D Ifq d module is in a $atmported a2sideffect of invokthis functions$nolySspecified, Rare produced.1"""%ifH.startswith('.'):!umsg = "Relative{!r} not sup".format()I raIError(msg if <7Q# Getk7aA's _%__gApkg_=`rpartiJ(".")[0]/A = iBlib. !_m(M  = getattr!4, 'v', None.1if 1!isKareturnFelseyield from|+:T= 1@itemF OBget_0er()p) def_loader(1_orB0"""2a "&P" objr 2R" i'(@ can/cund or{V5ualready1X, its(if any)" d,order to establish\<O )J)'sl '"s[D#ifVIX0Iif isinstance1, MCTypeC+ =pO 1/__'ni}HhfTPN;!._ c -{Oj'16"""Find 2I,Ti backward mpatibility wrapper aroundQutil.6P thatverts most failures|HRonly s 0 raXRn e:B msg = "R$elative module name {!r} not supported".format(full$3) raise Im)Error(msgEtry:(spec = i)lib.util.find_ Zexcept (X, AttributehT, Typ BValu v) as exy# This hack fixes an edance mismatch between pkgE and#1 ortlib, where the latter s other es for cases/J`previouslyAdE0qmsg = "p while 4ing loaderj({}: {})"=W  , type(ex), ex)) from exFpreturn .p!if1 is$None else  def extend_path(,Y)A"""E a package's '!. u In>`ed usegrto plact`followycode inF__init__.py:Mxu(_H__ =(@, __2__)\Ywill add to8 all subdirectories ofv `n sys. /@d af_jU".  is1fulE0if Pwants3dis) different partw a single logicaC`<multiple t also look*.pkg files beginn"!* Y!es9argumentafeaturpsimilarS*.pthY(see site.py),E that it doesn't@ial-z lines startRith '!'.F&A irusted at fpvV0: a<PcheckN1forCduplicates,1entRfoundd0are+e-C, regardles1wheNPthey 6QexistImystem. (FSis a L.!If2@inpu th0a lO0(asa2afrozenS s)c2is nchanged a?modified;qped copyuM. Itemsonly appende~U6a6end@ssumS B sequencee&ofd=`A(uniUor 8-bit) I ng@ferr1to 1ing=&QignorUNi za causeC3@whend3Rs may, tfunction%a1(in woS.isdir() behavior).  """ if not isinstance(path, list):#'# This could happen e.g. when talled from inside aCfrozen package. Retur? e v unchanged iat case.Cr0,sname_pkg = + ".pkg)! =\[:] # Start with a copy of the existing,\sparent_, _, final_ip.rpartition('.'):if <G6try Xssearch_sys.modules[C1]._%!__c; except (KeyError, Attribute/# We can't do anything:d_loader() bas NoneoDpassed a dottedu$BHFelseqpfor dir'<dir, strcontinueW finder = get_importer(dir#!if Qer is}#7ions = []if hasattr(k0, ' k_spec'K# =r.+>b01if 7%1B.subV_X@locaLs orB# Iser PEP 420 compliant?/elV7_, i4  o%;) sR# XXXmay still add duplicate entries to9 onkF -insensitive filesystems/ or[Ci.th[.J#d()Pright0ng 3subs like zopeQ# It looks2a4d "/00pkga = os.@join+%, n%if( is9(A  lff5pen4 P!OS~ as msgK4stderr.write("Co%s: %s\n" %\~ ,i)) If@line#'# = .rstrip('\nJ! 1 .ss?('#p contoinue  path.append(line) # Don't check for existence! Hpreturn ; def get_data(package, resource):3"""Get a from a 1.ZThis is a wr r round the PEP 302 loaders API. TheKpargument should beDvname ofx, in standard module1matH(foo.bar)c `!incBformcrrelativ|@file~, using '/' as2H separatori0pardirectory <Q '..'is not allowed, and nor;brooted2`(startq`with ax)me function zbinary string, whichYcontents"thspecified`4For`s loca&ilesystemb have already been imported,trough equival("of@pd = os.V@.dir9a(sys.m#s[r@].__1__)`;0ata>Dpen(Cgjoin(d, 'rb')."()x#If@ can%be"or0d, Pt usem q2doe0sup0(),l`n None1ed.>2"""# =Elib.util.find_0if OW]l_}=/."ifDhasattr(,4, ','g# XXX needs tes moE.get1 orP' _bootstrap._()W!is dmod, '(v# Modify  tocompatible  er>Isignature - an ""Q3 ofL4's uparts =.split('/' .insert(0,T6modC3_ID*Q)B (@) _DOTTED_WORDS'(?!\d)(\w+)(\.)*' _NAME_PATTERN/ e.wile(f'^(?P{V })Pcln>: =obj!P?)?$'.U) del A@lve_(PResolSbject/ ItPexpec)`that `J`` willDaow fo1ingats, where W is shorthand for a valid Python identifier "dot stands 1literal period in these pseudo-regexes: 3gW(.W)* ":(")?!The first^m is intendebackward compatibility only. It assumes thatfsome part of dotted name^a package,the restvn objecIwhere with&at=possibly nes`inside otherG!s.qBecausebplace W{e stops hierarchy"rtcan't be inferred by inspection, repeaattempts to import mus<AdoneQ this~.IR seco&!m,caller makqe division point clear through2c3pro&of a single colon:% !to5lef*O&edNArighr\K` P. Onlie=`is nee+41 IfNqit ends.:n a modulereturnedu!unb will !$ a (which m%beU), or raise following excep"ValueError - if `"@` is`irecognismaIs9$an"`failed@n itj0uldO2havpAttributy a 8ure occuwhen traver0Ou $ed30get @desi?X)O1""" m = _NAME_PATTERN.match(#*if not m:0VR(f'in]format: {@B!r}'Dgd = m.groupdict(if gd.get('cln')c# r_@ - aT-stepais all' movBlib. !_m(gd['pkg']L5s =3obj&.split('.')R else [] "no 0 - #] te @findboundaryL~X} 0mod! =vs.pop(0#z **Z/p= n`BwhilsHp"[0i3f'{Je}.{p}'!:tryK s)  parts.pop(0) modname = sexcept ImportError: BQbreak# if we reach this point, mod is the ule, already i\sed, andG1list of nFobject hierarchy to be traversN#orMan empty Iqif justE`modulehqwanted.2result =for p in)getattr(2, parreturn  #!/usr/bin/env python3 """ T+mPtries re ve as much platform-identifying data apossible. It makHZ in7 ation available via funcaAPIs. If called from)command line, it print<jconcatenatedsingle strto stdout. The outputD1use!as{`a file.; #@&is maintained by Marc-Andre Lemburg .GIf you find problems, please submit bug res/patchesJ2theEP(tracker (http://bugs.P.org)a assigm""lB". #QStill needed:P* sup MS-DOS (z_DX ?)'QAmigasqother sX#unK%eda`s runnSN@addi:al Linux di busMany thankall those who help ddkH-specificvchecks (in noicular 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,kFPHammoiB=Tutt, Hans Nowak, Uwe Zessin (OpenVMST) Colin Kong, Trent Mick, Guido An`y BaxtCStevt DoweruHistoryF1.0.8 - changed WindowsI^  keb32.dll(G7 - added DEV_NULL6l_(eD5 - fixed JavaUallowOQ on J*n4nBIron{L&3&normaliz&ofystem name #  1.0.2 - added more Windows support # (1 - reformatted to make doc.py happy.0.a bit and checked into Python CVS;@0.8.;sys.version parserBvarious new access=qAPIs (p[_@C(), compilerRetc.)>10.7 fixed architecture()use sizeof(pointer) where availableI-H for Caldera OpenLinux1Psome s.WinCE; untabifishe sourc'o6;a1VMSsquires  1.5.2-V006 or highV? vms_lib.getsyi() configured)F0.6.@code$prevent 'uname -p' 0lat8s which ar*jknown notDi|jpd win32hopefully workmWin95,98,NT-bWin2k;lAdid mcleanup of theerfaces -!Khave changQ5.5 -`d anotF0typDK`MacOS ... should I $usxPcoffeEeday ;-65.4i few typos inhYU0.5.3experimental _;better popen(u#Saaroundos_syscmd}-- still100% elegan@fthoughn#return '' instead1'unB allDT3values (qsystem XP commn te2to 1 Ecxjust leavingcfield empty!ePinclu:yslackware diste`except{handlerto cover up situa,.^p>Qdon'tEA os. P(e.g.)@fail`socket@host3();JlibcD de"RE@API Js1err,#o }s*6*BjavaP`; madeAca privat.|@(was-2tem@~`s) --  l@; ex&` a4als<@ prom"or70.4V6mod() outputKTWinXXL30bug_follow_symlinks10.3h(!() "file" commanJd invocation bugs # 0.3.2 - added architecture() API and support for it in platform() G 1 - fixed syscmd_ver() RE toCWindows NT0system alias3(2.3 - removed 'wince' again... oh well./-%ed 2.cache logicchanged the9p string#6mat0Sto use func s instead of module globalsq some a: take too longgbe run onI im 1.first release #You can always getlatest vers9tof this^4at:@http://www.egenix.com/files/python/p>4.py?IY at URL should fail, try conthe author. __copyright__ = """ C! (c) 1999-2000, Marc-Andre Lemburg; mailto:mal@lHC-2010, eG Software GmbHNVinfo@ OaPermisH , ,NAify,] diJBbutejs`1itsJdocumentfor any purposeGwithout fee or royalty is hereby granted,PPprovi2thaQabove_ notice appear i(l1iesp9KPboth =n4Fis p  XDP 0or @ionsreof, includ-bmodifisyou make.2EGENIX.COM SOFTWARE GMBH DISCLAIMS ALL WARRANTIES WITH REGARD TO dETHIS?, INCLUDING;xIMPLIEDCOF MERCHANTABILITY ANDpFITNESSE NO EVENT SHTHE AUTHOR BE LIABLE FOR ANY SPECIALINDIRECT OR CONSEQUENTIAL DAMAGES6WHATSOEVER RESULTINGROM LOSS OF USE, DATA?PROFITS, WHETHER IN AN ACTION.CONTRACTNEGLIGENCE=O2TORTIOUS5`, ARIS70OUTBOUQCONNEV !USKPERFORMAZ)F @ !  _m'1.0.8' a colleEso $re%sysubproces5oolQitertb ### G & Constants # Helper*a compa85twoecnumberRsPBasedspdescrip;2TPHP's@_Ve(): # http://p|hp.net/manual/en/function.version-compare.php _ver_stages = { # any string not found in this dict, will get 0 assigned 'dev': 10, L'alpha': 20, ' )0bet3cb': 303Tc': 4 `RC': 5$r5# number,,10!ply=p P } _onent_re = re.ile(r'([0-9]+|[._+-])') def 4`arable3I(Q!):result = []Pfor 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='', O chunksize=16384):  """ Tries to determine theFcCQ thatVfile rE5(which defaultOE`PythonS@erpr`) is linked against.GRs a tuple of 7 s %,)) o5thegiven paramss53casookup failsz0Not 0 ha>timate knowledghow different{6s add symbol< and thusprobablyIonly use 9#s ^d using gccAThe qis readhqscanned  [T byte1"""'if^ @ ver = os.confstr('CS_GNU_,VERSION'#Qse 'g92.28' as (A', ' 6@part^Bver.1max *=1*qif len(1f) == 2^q*(Attribut,A, OS6# _) or  v6Pavail|FFpassv = sys.%?V =YS ifattr(os.path, 'real '# Python 2.2 introduced os.path.real (); it is used %# here to work around problems with Cygwin not being=1abl=open symlinks for read,aexecut0=)^xU(, 'rb') as f:&binary = fd(chunksizeI#upos = 03`while b< len(C)T5if b'libc' in # or b'GLIBC 8<Pm = _<_search.i,{1OelseGENone+!ifmm.end() ==4# &1if -=[max(pos,~ - 1000):] +L G~zcontinuIreakmpinit, g version, so, ths I = [Fzs.decode('latin1') if sO - s; sDm.groups()]%0if A and>libblib =  BBelif5^Q != ''#\# ]% +(V($c) > V(1 gZ" = ^Z.sol'Yoz(dor V(s U?%= <}{7 [-T$!=o<4 = +5 {E`return,< def _norm_O, build=''): @""" Normalize theF. stringspva singli, uOf]t major.minor.V(or patchlevel).l .split('.'NPl.appXY&6try!= list(map(str, int, l))7except ValueErrorE= '.'.joinU)B[:3]O.+ _output = re.compile(r'(?:([\w ]+) . ?' Or'.* @\[.*JdJ8\])') # Examples of VER command output: # # Windows 2000: Microsoft [Version 5.00.2195]>0XP:M>(XP<j1.2600;oVista:yt6.0.6002]Note that the "" string gets localized on different #vs. def _syscmd_ver(system='', release 2  supported_platforms=('win32', 16 rdos')):@""" Tries to figure3OS p` used ureturns|a tuple ,;").i ItIs]"ver" shellfor this which is knownmto existsQ3, DOS. XXX Other7o ?uPn casis fails,given paramet80are6d apdefault1"""tif sys.h not in :0<:8>tem(# Try somecon cmdU im subproces:*in ('verj /c3md )6try ginfo =cr.check_U(cmd,0 vstderr=.DEVNULLFtext=True6`7)except (OSError,rCalledPZ0) a ##print('C%[ed: %s' % &V why)y(continue:lseQbreak eA1Par1putJ."p(@m = pp.match(' @if m7Non = m.groupsd# Strip trail!dots from^7$if[-1] == '.'.% =*H:-1]BB $ =[Ba# Norm8/Ebuil (eliminatadditionalr# zerosZKp= _norm () _WIN32_CLIENT_RELEASES = {z(5, 0): "2000", H (5, 1): "XP", # Strictly, 5.2 client is XP 64-bit, but platform.py historically Fhas always ed it 2003 Serverm2@None@post!2", 6@6, 0TVista167\83778.1fe#10f$10./C} # release name lookup will default toQ#s if necessary _WIN32_SERVER_RELEASES = {15, -E2008($R26Q-126+$20 6 #} def win32_is_iot():creturnedition() in ('IoTUAP', 'NanoWindowsCoreHeadlessIoTEdgeOS')pUq2try  `import1regexcept IVErrorC 6_winreg asA= ApassfFelseT cvkey = r'SOFTWARE\Microsoft\ NT\CurrentVersion'[Cwith.OpenKeyEx(.HKEY_LOCAL_MACHINE, u)'ke4L reg.QueryValueEx(key, 'EuId')[0]/OSI*^UCver(Qb='', v 1csdptype=''b Mfrom sys BgetwNJ}q, csd, |winver = d!()f major, min build = map(int, _syscmd_)[2].split('.')M [#.pZ40 or%bver[:3 = '{0}.{1}.{2}'.format(_)$C = (eCLIENTY.get(AB)) oc=(<# reflect the compatibility mode Python i# running under, and so=service pack v $ponly go3Qto be# idwds match.#i2j2] == */ s=F'SP{__) except AttributeError: if csd[:13] == 'Service Pack ',7@csd 'AP' +:Q13:] S# VER_NT_SERVER = 3if getattr(winver, 'product_type', None)3rrelease = (_WIN32X_RELEASES.get((major, minor)) ortA@)6try simport winregexcept I" _78 asA= ApassfOelse(cvkey = r'SOFTWARE\Microsoft\Windows NT\CurrentVersion'[Cwith.OpenKeyEx reg.HKEY_LOCAL_MACHINE, u)'ke4Lp$ =SQueryValueEx(key, 'T'E)[0]/OSL*sreturn 2, v,!,  def _mac_ver_xml()H fn/System/Library/Core&s-b.plist3 if not os.path.exists(fn[yXGS1libE Nopen(fn, 'rb'fTpl = a.load(f)i12['P'K@infoB'', B`machinos.uname().c3if  in ('ppcCPower Macintosh'0# Canonical QGH1= '?2PC'Q,~(,= =()< ='p""" GetV$OSh jrmation and itdtuple r,Gwj!)  being a GGdev_stage, non_").#qEntries which canbe determined are set to the param vKCadefaul.s''. AllejOqtrings.2"""# First try readrJfrom an XML fileashouldO# always be presentF+ =f1 is)4nfo If that also doesn't work%Kjava_getprop(#, Q"): 'c.lang 3System try3: value = System.getProperty(name))2if ,vis NoneCJreturn default59except AttributeErrorK0G def java_ver(release='', vendor pminfo=(]), os1): """ Version interface for Jython.'Rs a tuple 1, v}pc) witha beingsLD0vm_Z<_ S) andB% aD#osB osg_arch)Vs which cannot be determined are set to thsqgiven as param82s (P4all?$''z1"""@# ImportZneeded API]6tryi(3.la4*D'>F W@ = _`_getprop('.PW3;3', (5 # =,a m. *a7 9 ;< $vm>Mw"s_k # =*0os.'555 %8v; > jk$S ###o ` alias+s_( kT-b edacommonNmarketingas used Rsome sSIt also does $preorderC!of1Brmata&Bcasev where it would otherwise cau@onfuyR#if == 'SunOS'F# Sun's OS$ifW < '5-t# These#1oldQN4rz# Modify]& (j!u#2- 3ti4l =.split('.'Fif l1 Rpmajor =(l[0])  except ValueError: IpassNelse'major = 9- 34Pl[0] = str(%)"release = '.'.join(l&4if !Z< '6'`system;Solaris'_"# XXX Whatever the new SunOS marketing name is...Lk Telif = 'IRIX64 #  reports 64 on platforms with 64-bit sup); yet itd# is really a version and not a differentX, since 32YIapps are alsoq'edU$ifz = + ' (64bit)?9'-!' Uin ('win32', F16')`# In cAaone of0othFricksWindowsm# bpo-35516: Don'tlace DarwinSmacOSS@inpu&1and#arguments can beAthan0curply runnz .creturn[,,d ### Various internal helpers def _c(*args):ZQ""" H(@ to !at/in a filecompatible<be.g. "`--machine"G1"""Ao# Formp!C= '-x.strip()qP x inter(len, )# Cleanup some poss obstacleq @.rep0(' t"_'% =d*/*-*/\\+:*;*"*(*)*# No need_ 'unknown' inr4iondY 9E, ''Fold '--'sremove trail"'-uvwhile 1.c/ed$--5if 1N$Qbreak:a[-1] =LR[:-1] %node(default='n determine the node name of this machine. """Atry: import socketexcept IVError.C# No,2s..WFreturn defaulG f f.gethost(()t-OSpStill not workingw def _follow_symlinks(filepath): l""" In case c is a 3", C it until a9!al62rreached^SP= os.y@.absOUwhile$ is#tQAnormRIoTjoin( 1dirhF ),sJreadp)." Tpsyscmd_(target,:=''Zterface to the system's6command.The function uses6Q-b op >[bhave ikGAomit: in its output. F#bs. It sJ?#xshould fail if.platform>('dos', 'win32 16 emscripten<# XXX Others too ?s=ubproces. =0# "("locale dependent: forshe usagUBe C +# get deterministic behaviorenv = dictenviron, LC_ALL='C' 2# -b: do!prClines (brief modeMQE = s$r.check_0(['R-b', "!],Awstderr=`DEVNULLDrenv=env}( ,rCalledP))& "!if=* a# With,< be mostly ASCII-co3iblaP# Decfrom Latin-1!prevent Uni d'e]#p. 2('lC') ### In\aBabouused architecture p values # ; non-empty strings override$ #ls given as param3s _&_xA = {;@: ('\WindowsPE') ;16' 7PMSDOS}p(executable=sys0.executable, bits='', linkage=''): """ Queries the given e= (defaults to"Python interpreterIMbinary) for various architecture information.7Returns a tuple () which containsEe about:bitt1andmat used A5. Both value1e red as stringsV)that cannot be d0min6)reCi)byPparam4 presets. If3 is0as 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. ThisPavailmost if _all Unix?@plat_s. On some non-$ a where GAdoesaaexist (heois set Bcfrom __1areT1"""B# Us)I number o* ChingC@elseKs$as. Ot: im&uc`# =P.calcF('P'|H$( * 8) + 'bit'# Get data '',#'if{0out = _syscmd_(3, '9'@R\{' {0 ==XT#1didCr4P anyt; we'll try>tprovidel" #psensibl>zRhen..f? inV6@b, l07 T[sys.P]7Jif bIb+l+y5= l.FFif ''G8in 'shared object#1# FnDR# Bit032-gd` = '32#\ el5ON32'2#Irix only2Q-'nJ/6464bit' # Linkage if 'ELF' in fileout:0lin)" =$ el3/PE2# E.g. Windows uses this formatBZD%I%,5PE'CFelse 0)?COF%^5oMS-DOS MS&8# XXX the A.OUT also falls underclass...HQpass return bits, y def _get_machine_win32()# Try toPROCESSOR_* environment variableslp# avail0 on XP and later; se7# http://support.microsoft.com/kb/888731<Z1www.geocities-rick_lively/MANUALS/ENV/MSWIN/RI.HTM# WOW64 procesbAmasknative architecturD(_3os.c.get('f OR_ARCHITEW6432', '') or8RCTURE85A) 2 _P"or@amethod+3clsfunc = getattr(cls, f'{sys.plat\}', cls.from_sub)ZHO(2 ''Ow @2+IDENTIFIER',)btOpenVMSd2try  imO vms_libexcept I4ErrE3/ csid, cpu_number =bsyi('SYI$_CPU', 06O:p'Alpha'2Ip>= 128 sW 'VAXU 5"""Fall back`uname -p` , /.check_output!['aU-p'],fwstderr=Q~DEVNULL+text=True).strip(E1(OS', ^cCalledunknown_as_blank(val)@ 'val == '0'val ### Port () interfacec_resulFcollections.fdtupleb"3f_base""system node release version "1(A \ that's largely compatible with avsimple except that '#processor' is resolved late and cached to avoilling "uname"6except when needed.A""" @functools.P_propertyEdef q(self): turn _unknown_as_blank(_Pr.get())lM__iter__LUhain(lpsuper().D)), T.%,)@classmethodmake(cls, ~Vable)# override factoryqffect length checkPnum_fields ="[.result = cls.__new__*5, *S!ifI4W) != e6+ 1msg = f'Expected {.} arguments, got {len(Y%}'rHraise TypeError(msg:getitem_W, keyO!re7Qtupleh)[key]A3len=8<%A ^oreduceA_", K [:\ R] _1 = None 72():""" Fairly portE " interface. R2s aym%of strings (system, node, release, version, machine,identifythe underlplatform.Note that unlik Re os.ion this also Apossible0 ine at9as an addi"alg entryEntries which cannot be determined are sety#'';`globalAame_)if@ is Z/ )># Get someps from Uvbuiltin*RAPI..V6try\# =b=S(Attribut `t = sys.T@@ = _P/Q$ =R$ =SF = '(;!if?Aany(#bPavailJv# Try win32_v2 on W iftem == '5'Ocsd, ptype =Yh7;or _get__m3T'ver'@comm-p#(N system, release, version = _syscmd_ver(sy'7) # Normalize to what win3291) n%ly returnsD(gp) tendsH. the vendor name as well$if== 'Microsoft Windows':t4= '$ #/elST' and- n@dt# Undera Vista@4 Server 2008,&# qchangedoutput of@command. TheG is no longer printed. This causesRA-to be misidentified.:8eif '6.0'KzN[:3]M-1= 'L'rOelse<%' 8,# In case we still don't know anything useful, we'll try toDhelp ourselveCQin ('0', J16')dif not~ MuL&*G = '32bit&<-16<2@[:4]j'java'g, vminfo, os0 = 5:\|JV , '.join(X 'd Hr(1# S specific exten% wOpenVMS## Q seemEhaveFX{mixed up85 or70g&'=IHe3= '## `0 ~mcvals =n, node, machin# Replace 'unn' values with more portable _u_cache = result(*map(_P_as_blank,Y"s)Hr F ### Direct R@rfacIdo somej#()Ttues de2():nQ""" Rh1/OS, e.g. 'LinuxLf'.HAn empty str#ised if the value cannot be determined. """return uname().system def node():0! R, s the computer's network C (which may {Qfullylxqualified)XAn empty string is Qed ifo?val"oreleas'{), e.g. '2.2.0' or 'NT'Rversion  1#3 on degasSomachinv T typeOi386S~processorku(true) )Oamdk+$ Note that many platforms doa`provid#%isA in$PationcsimplyTORsame Tsas for 5(),F NetBSD doe/is@  ### Various APIgqextractfrom sys.=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 cove2.6 and 2.7/26&\(jg[\d.]+=)  ]+A.]+(p\d+-bit)\)' ) _pypya*M3%+) :1b[PyPy @\]?'cache = {}()_=Nonea parsed version of Python's sys.version as tuple s(name, , branch, revi2, buildno date, compiler)Hreferring to the implementatnF vs number{ |P/time!stn1andoKidentificy/%. Note that unlik 2,^returned valu=1forkE will always includ^patchlevel (itdefaults:W'.0')The func=s empty !s  entries^cannot be determinedaCsys_@ may(Pgivenparse an alternative`, e.g. ifQ was read from a differentEpinterpr1"""Q# GetU e ifis None:=+Q# Try\0caci2irsresult = _C_&W.get(,t 3if :0is v #Peif 'Iron@' in&# &\) =A *.startswith(p)b?mQironpO  !r.' B7els- T/26VH cpraise VeError(8v'failedNp&}: %s' %?Irepr)[,401 = .groups(*f'q"el.platformWjava'1# J;%k_"if 5$A F?, _"if~H6= 'I q"o"PyPy" 5Dpypy?sion_parser.match(sys_version) 1if  is None:!raise ValueError("failed to parse PyPy sys.Zy: %s" %FJ IreprG, buildno Cdate btime =.groups(@compiler = "" 7els# CPython7= _!_!r. 7:8s'K N'NA.', )\[!nay''6"ifH6= '9$el; {3 r+ ' ' +p5if hasattW, '_git')R_, branch, revi! =j* FmercurialL0Ry "''# Add the pclevel  taissinga4l =.split('.' if len(l) == 2 l.append('0*`= '.'.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' (Java42' (o41"""rY Fh()[0] i}'4 as'major.minor.5%0Notat unlik T@ed vDwill always includGq (it defaults/0)1o_tuple0! ( !, ,)Eof strings.  Note that unlik e Python sys.version, the returned value C will always includGpatchlevel (it defaults to 0). @1"""[ tuple(_sys_z ()[1].split('.')) def p_branch():N! Rs a string identify implementationRSFor C4qthis is BSCM - from whichK5binary was built\ If not available, an emptysv82c3 -)2]!@revi#9T% /'_&3&d#! (#1no,ddate) s< ng4w/ number and 23 ass</:4:6compiler6 used for 5ing### The Opus Magnum of platformt :-) __cache = {}0(aliased=0, terse=0Single_ aunderls@with@much `ful inpossiblet no more :`outputintendedbe human readp rather]^machine parse& . It may look different on sRCIf "S"Btrue@funcBuse (siuvariousat reporttem namesEAtheik2mon-, e.g. SunOS#beUUed as;Solaris.dqsystem_5() is}BASett]` causeeV#toqP onlyTabsolute minimum@3nee p<B{sult = T.get( ), None)Qif re<!is<:r#@# Geame informatio,n and then apply platform specific cosmetics # to it...-system, node, release, version, machine, processor = uname()A$if$6 ==&:q9!''if aliased' 2 = _3( $) ["'Darwin'f#QOS (dr kernelcmacos_ =._ver()[0]`%(_r 'macOS ZByWindows%MST, csd, ptype = win32if terse;4= _ pD/el@![3csdCelif in ('Linux',)# check for libc vs. g  ,!! = ,my o'with'% + == 'Java, v, vminfo, (os_ osos_arch) = java or not C%5 7(-s b?'onu ',  # Generic handler0! l@bits@nkagitecture.executableG9;), _cache[(2ed,UE)] =mfreturn ### Commline interface if _!____main__ # Default isPprintSEboseoq stringQ = (' 'osys.argv>'--m=#C'non F!/--#P( D$exit(0) r"""plistlib.py -- a t.ool to generate and parse MacOSX .plist files. The property (")#> format is a simple XML pickle supporting basic object types, like dictionarists, numbersstrings. Usually the top levelSLyo write out a Q, useFdump(value,Q) fun1. ''q0, '$ @ a (jCable_Qrom anPload(O$) , with a (read[1 as only argument. It return &`(againyK&a 3)Qwork |2data in bytesns, you canK@s() MS s(LVXs%3be , integers, floabooleans, tupl ies (but P keys), Data,array, or datetime. D. GP0exa: pl =(!aS = "Doodah",L8 = ["A", "B", 12, 32.1, [1, ']]1Fg = 0.1nInt = 7280Dicfnother3qUnicodeM\xe4ssig, Ma\xdf15Tru. PEFals  !) @some = b"= 1 << 64:  raise ValueError("UIDs cannot be >= 2**64") 3 if data < 0:M1musKpositiveKQself.M=T Pdef __index__($)ipreturn :3Orepr2"%s(%s)" % T.__class__.__name__, B*))^Oduce`T,eG,G#eqCw, other0if wisinstance("W, UID'lNotImplemented>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(>)IVdecodI7if Xs, stSz4a2bzs^("utf-8"kMelseA){Contents should@form#a subset of ISO 8601 # (in particular, YYYY '-' MMDD 'T' HH '::' SS 'Z'. Smaller units # may&romitted## 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 dis NonP break# lst.append(int(val))return datetime. (*lst) def __to_string(d):='%04d-%02T :aZ' % (0d.year, d.month Gday, 2hou Pinute!asecond#)escape(text m = _controlCharPat.search&?if m is not Noneraise ValueError("s can't ZAains rol characters; "]G "use bytes instead"z0 = .replace("\r\n", "\n")K#rvert DOS line endingsu@G E& G?MacG&FW&zO '&'<9<84 # 9<9>9g9>9 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; = = ndler is not None: handler() Bdef _data(self, )8..append( Aadd_object@WvalueA1if Dcurrent_key is not!ifisinstanceU.stack[-1], type({})bpraise VError("unexpected element at line %d" %?parser.CLineNumber)@+[A] = 5&! =$#elO^`# thisRthe root C&> ;els&q /[]w6getI = ''.join{HU = []careturn;[#pa"rssbegin_di2Xattrs" =3%_ vd$d1endQo cXrmissingP for O'%s'`.,_n8pop1key[ ? orl$h d a'*"`Barra,, aa]RaiajmhoR2tru 2KTruejOfals8F% 9|integer?rawG.`if rawzrtswith('0x')6 'X'=int(raw, 16)]{8)Lreal;add_object(float(self.get_data())) def end_string&!):5add_objecE DZ3B_decode_base64pAdate$R ate_from U class _DumbXMLWriter__init__l, file, indent_level=0\="\t"1! =8 <stack = []_]) =l *)#rbegin_elemen#,  .append($ gwln("<%s>" %K ' F+= 1G]Hpassert %.L5> 0k&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(elTrue:  self.simple_element("true") " elif value is False:%Ff( Gisinstance(Rj, int)Oif -1 << 63 <=z"< 4,integer", "%d" %G)eOraise OverflowError Lfloareal", rep\]?dic\`write_(bytes, karray)X$sYdatetime. X o,@", __to_strings(tuple, listU BType"unsupported type: %sP PHdef 5Fg, dataf.beginq#"#_indent_level -= 1maxlinelength = 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,1gf not 77strR#ifOskip+continuek YL must be sU<V 4key", key;0<_b T %&4 F\l1!, ["if , e: ! H se lf.end_element("array") Uelse:self.simple8 def _is_fmt_xml(header)Dprefixes = (b'32-!ifC7bom'ddcontin@v# = bom + .0.de('ascii').k!e(Iing)b[:len(QS)] == q False # # Binary Ph # class InvalidFileException (ValueErro_init__(, message="C"CE/._;<) _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 ct,  offset_table_  ) = struct.unpack('>6xBBQQQ', trailer)3self._fp.seek(T a/cobjectsuFread_ints(num_%3s, UOsizeMF[_undefined] * E rreturn tkC(topv%) 2except (OSError, Index -eOverflowB[ Value)):raise InvalidFileEtCion(def _get_(, tokenLKC""" @the +@ of Rnext E."""~#ifGz == 0xFm0fp.)(1)[0] & 0x3D~i1 << m f = '>' + _BINARY_FORMAT[s](N{#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/set) {EsultvJF[ref Qif re'!is (-* dg kc TH$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 fb'' elif tokenH == 0x10: # int result =.from_bytes(self._fp.read(1 <= 3) @BelifV22: # real#Tstruct.unpack('>fa o4))[0]b3bdb8b !33gIdateLf = ^'# timestamp 0 of binary plists corresponds to 1/1/2001|p# (year=Mac OS X 10.0), instead;Y1970.<}(. (i, 1, 1) +6$ -.;delta(sec?=f) 4Idata[sIget_size(^)' s&rif len(-y) != s:G raise InvalidFileException( 5Pascii9ing[+"  =a.decode('' 60uni2I * 2outf-16be 89UID# used by Key-Archiveri files/vUID(int +4AL), fG AYarrayrvobj_ref.(*[]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_(D:dics = self._get_size(tokenL) key_refs = self._read*(s*1obj*eresult(dict_type(Qpobjects[ref] = < Itry:for k, o in zip($, )59a[}0(k)oexcept TypeErrorfraise InvalidFileE37ionJelse;7 5dreturnK def _count_to_s !1if  < 1 << 8I!1 ,el+-16,2,-32,4, t8 _scalar (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 onIfnumberNDBnum_p1len/.+p_offset2G[0]*D/1ref , =14)6Pforma_BINARY_FORMATgX  file header2fp.1b'b700'|"# AA0obj-Rd@0ect|cdrefnum. N es3topEJ2get:<uA_A5wfp.tell*.Koffset_forma&t = '>' + _BINARY_FORMAT[offset_size] * num_objects  self._fp.write(struct.pack(>format, *+A_Es)) K0# WD trailersort_version = 0)E = (1", j", 3ref,D3topBStable,) [ '>5xBBBQQQ', *def _flatten(E, value):[# First check if the Ih is in, not used foK# containers to ensure that two sub!AwithZAsame:'en# will be serialized as distinct%s.if 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| Fdptoken, %cize < 15p.write(struct. pack('>B', token | size)) Aelif < 1 << 8:#self._fp.write(struct.YB[0xF, 0x10,Qf /16gHg1g/32gLg2g/seXQX3XQdef _d_object(z, value)n`ref = ._getrefnum(&H_offsets[ref];fp.tell()4"ifl is Non |b'\x00'HA?Fal# B8B?Tru9AisinstanceW, int@6< 0Z>tryV !q'3Z<sexcept C_erroriraise OverflowE)a) fromZ}% H)&' bO0x11!b bO0x12b.63& ?0x1/64b R14' +.to_bytes(16, 'big')Pgned=  h'A .Lfloa0 d2ddatetime. 4 - $-p(2001, )).total_seconds]33, f( , karray)me(0x40, len /M\ O;strw  t = value.encode('ascii') self._write_size(0x50, len(value)3except UniWE]mError:ZAt = Cutf-16be6t) // 2) b1fp.'(telif isinstancej, UID)#ifdata < 0*praise V  ("UIDs must be positive"&[n1 << 8` struct.pack('>BB', 0x80, f/16gHg1g/32gLg3g/64gQg7g.seROverflowW(list, tuple)arefs = [getrefnum(o) for o in]! =? YI_A0, s& UB' + Gref_format * s, *pKdictqkeyRefss Z], []#if{sort_keyspootItem9'"ed .i(D= @k, vr3hif notRkk, str/?kip'continueBType"Lz{stringsy8.append(|kB30val3'v)0"k~ D7st,elR R ) def _is_fmt_binary(headerreturn [:8] == b'bp300' # # Generic bits # _FORMATS={FMT_XML: x(tdetect=Bxml, parser=_PlistParser, writer=_PW )FMT_BINARY: dict(:detect=_is_fmt_binary5\pi1=_B_|#  } def load(fp, *, fmt=None,`_type=!):"""Read a .p file. 'fp' should be a readable and + 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*"['2'](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 (seetfunction at the end of this file) # Imports i d errno $re esocketys try: :1sslHAVE_SSL = True exceptiRError7( False __all__ = ["POP3","e0_proto"]ENion raised when anor or invalid response is received: class.X(Sp): passgStandard Port _PORT = 110!@POP  4SSL$0995$ Line terminators (we always output CRLF, but ac'0anyLFCR, LF) CR = b'\r' LF 0n' & = CR+LFqmaximal lyblength calling readP(). Tis to prevent #!)arbitrary G6s. RFC 1939 limits  o to # 512 characters, includX . We have selected 2048 justbe on # the safe side. _MAXLINE =/ !: {1"""1supQ bothN1min and optional commQsets.G Arguments can be strings^Ategehere appropriate)=(e.g.: retr(1) Z B'1')work equally well.MC2Set*eUSER name Puser(CPASS"_( 2ASTAT# Zstat(+LIST [msg],list(msg = Non#PRETR !:msgcODELE.@delec .CNOOPO Knoop?RSE 1: print('*put*', repr(F) #j#1 .sendallQ + CRLF) # Internal: ' w@comm{!to (through _x+()?cmd?cmd = bytes| 8#, stripp>$~`# This<where all1CPUit"`module)dARe_('-ERR EOF')  he1ionCSlosed&geWQ.(_MAXLINE + 1*aif lenND) > %[ S too long' /ge!if[":  t%octets =#B canany combinatXof CR & LF5Ahowe':2)' +sAs enw*in;so only possibilities are ...LF,CRLF, CR...LF  if line[-2:] == CRLF: breturn&:-2], octets%C#:1B@N1:-1A b! d# Internal: get a response from the server.0Raise 'error_proto' if);doesn't start with '+'.sdef _get.f(self)`, o = .'B!()}5#ifdebugging > 1: print('*B*', repr( )<1not.sW(b'+'frKV` Iplus followNtext][@long\$list = [];GA = 0YI\ Qwhile != b'.'B <,..=+5o-1}! =dI[1:] $ =9+ o .append(HZ  , Mnsend a comma !ndu!5shortcmd\'neQ!pu" ")S hT1H(These can be useful:zgetwelcome#VAset_Qlevel<!, C:' ="G# Here a!ll4POPsCuserc b@"""S P name\ (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 ( 5vald('STAT')  rets = retval.split()  if self._debugging: print('*stat*', repr(G)8numMessage]0!6[1]#Osize$2$return (O(, 91) def list(, which=None): """Request+0ingarresult.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 connecCsp =\0QUIbHp%0 +C ssuming any0 ab)it;:tryDfile ;! =; 1if ic [B".CkfinallsqF l . ;.shutdown(et.SHUT_RDWR,except OSError as exc+S# TheT might already haveVdfC# On Windows, this may result in WSAEINVAL (error 10022): # An invalid operation was attempted.:if (exc.errno != .ENOTCONN4 and getattr?a, 'winP', 0)I ]raise`finallysock.close() ;#__del__ = quit 0 opal commands:def rpop(self, userS"""Not sure what this does."""q`eturn C._shortcmd('RPOP %s' %Xtimestamp = re.compile(br'\+OK.[^<]*(<.*>)'a, passwordAuthoris- only possible if server has supplied a iAitial 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 (kr#%s(", =#))t@which, howmuch Retrieve message header ofnumber 'G]sfirst 'Zx' lines<Gbody<Result is in form ['response', ['A', ...], octets]= AlongTAuidl8!, &]=NoneAc (unique id) list$If%2, rcontains 6 tY!`in the %m gnum uid', otherwisea%is@= T7mesB [<Z"if DCUIDL{T0NAutf8 0TryLenter UTF-8 mode (see RFC 6856). RsY@IUTF8Icapa """Return" server capabilities (RFC 2449) as a dictionary >>> c=poplib.POP3('localhost')'.]({'IMPLEMENTATION': ['Cyrus', 'M v2.2.12'],XP 'TOP8], 'LOGIN-DELAY0'0'AUTH-RESP-CODE @QEXPIRa'NEVER4BUSER*d 'STLS PIPELININGBUIDL% 'n9}'E>>> Really, according to rp, the c  folks should avoidD1hav9he implementa split into multiple argu"Es...C5""" def _parsecap(line):`lst = .decode('ascii').q/return lst[0],61:]caps = {":tryr resp = self._longcmd('CAPA_l#awO39[1]!foR in r- kFacapnm, rg0cap?0w[94] =;~except error_protovXraisep('-ERR  not supported byc YPstls(4, context=No """Start a TLS session ony`active<!nespecifiedBB595.ur - a ssl.SSLCu!ifHAVE_SSL missing#if1tls_established\already Ehv ?1,r if@ is  _=_create_stdlib_6a_shortjTP.sock`.wrap_!ett _2Qname=cjDfilenP.makeL('rb_u = True7f if $`class (  0""" client -o@0SSL6Instantiate with:\ , =995, keyf, certL@)re - the hostname of the pop3 over ssl server qport - Nnumb" keyfile - PEM formatted that contains your private keymAcert7 L@ific8Qchain^ ?PontexaR.SSLC +1Seeumethods arent class POP3 for more documentation.I6"""V def __init__(self, host,8=P_SSL_PORT,p=None, _ timeout=socket._GLOBAL_DEFAULT_TIMEOUT,i1extZ)):L$if is not D and <raise ValueError("nC1arg,s are mutually "O "exclusive").;)DCt%or !imwwarningsA. $("lpe depre<d, use av"custom3nstead", DLBionW:, 2.=_ #= % =_create_stdlib_(i= ,hK=r$ =: i.'#, )X^+  ! =. 7 60`.wrap_0et(2K_p=[ 3preturn ` Cstlsl -e r"""The  uncondis an excepQ sinc STLS commV doesn't make any sense onJalready establishedJ0SL/MIsessJ|N ej_proto('-ERR A q'< __all__.append("POP3_SSL") if __name__ == "__main__": import sysa = POP3(sys.argv[1])print(a.getwelcome()fa.user222va.pass_3Rlist(> (numMsgs, totalSize) = a.sta$for i in range(1, 5R + 1)(header, msg, octetsMbretr(ir*"Message %d:" % !s@linev6msgd>' ' + ' Z/'-')Pa.qui"""Common operations on Posix paths. Instead of ing this module directly,  os and refer to -`as os.`. The " " q i<p alias <" misystems;PotherG (e.g. Windows), ] provides the samein a mannI pecific to that platform,Rto an~ nt`). Soif.can actually be usefulBnon-x` too,  qmanipulc1componentURLs. """ # Strings representqvarious-related bitwd pieces. #se are primarily ex; intern,Ty+hardcodedB`Shouldset before"`resolvcyclic dependency. curdir = '.' pa .' extsep /%#th`:' def#&/bin:/usr C' al?None devnull(@dev/ 3' $os  pgenerickg from  * __all ["normcase","isabs","join","splitdriv Qext", "basec","dir cprefix","getsizMgetmtimeEBgeta,c islink","existl Qisdirother # normalizations (such as optimizing '../' away) are not allowed # (anoLP funcE should be defined to do that). defwcase(s): """N e  of pathname. Has no effect under Posix"""Areturn os.fs8(s) # R1wheaU is absolute. # Trivial inUP, harcon the Mac or MS-DOSXisabs_Test h:s =sep = _get_seps.startswith(sepAJoin"saIgnoreprevious p9@ if ,rtInsert a '/' unless@Qfirst=2Pemptyalready ends-3'/'join(a, *p0two:m components, iigs needed.fIf any0%ang, all &th1sGAwill0iscrd. An $la'`result3!thF a separator.a!a)3 A = a#2tryi6t p0`[:0] +x #23780: Ensureatible data type evenp3BnullQOPfor bEmap(1$, $Lif b{ &A = b$el0ath&.A@J+K/se,a+} except (TypeError, AttributBytesWarningqgeneric_check_arg_I0s('2', Qraise>s@SpliTghead (everyth upY|'/') and tail (the # rest). IfL@QB'/',-"be.!re1o #iC!,  80ailQ'/'esstripped 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 :>ing at the last dot in the last # pathname component; ro+s everything before that. # It is always tru 9+ ext == p. def splitext(p): p = os.fs1(p)if isinstance(p, bytes26 se8Ab'/'04ext.Belsee 2'1return generic&._, sep, None,Tsep) .__doc__ =? P # S& asinto a drive specification and`est of  . Useful on DOS/Windows/NT;PUnix,0XXemptyy?"""'p On Posfbf1""" pp[:0], p Rtail (baseQ) par:0, s"asT(C)[1]7\sVfinal\Xl I_get_sep `rfind(A + 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)X Befor dangl GsAso u[ls)4. kTqjbroken+s,?os.' ?mount point=@(DoeC@ork all UNIXes? Is itn guaranteed to w/"by "?)!is`2A-/s1?doesn't exist -- so not a mount point. :-) return FalseQelse: " # A symlink can never beS/ if stat.S_ISLNK(s1.st_mode)TX w? if isinstance(path, bytes:parent = join$B'..' -,@realn(J6trys2 = os.l 'except (OSError, Value rdev1 = 1dev0devi s231if - !=2U@TrueP0 # /.. on a diffe-device as!j6ino4ino"f -=is the same i-nod|p # Expands beginning with '~' or '~user'. #means $HOME; Qthat -s home directory=!If) doesn'trn,oi'Gi is unknown, #G2is ed unchanged (leavep reportpto whatE # function]bcalled@eeargument) See also module 'glob' for 9sVof *, ? _[...] inhPnamesG&(AbshouldVbe defined to do full *sh-style environ # variab{r.) defdI3"""~ construas. Ifdhing.""" fs v_tilde = b'~'5 Q!if]ip.starts(' yUsep = _get_sep! =&.find(sep, 1F < 0bi = le$G== 1%0f '&' in% imA pwd [=0.getpwuid(os )).pw_dirM,1Key  Y# bpo-10496: 1curu identifierPexist"thIssword database, C  3os.^[w]T 4kB[1:i6\'(Otr(name, 'ASCISI') Etry:  pwent = pwd.getpwnam(name4except KeyError@ # bpo-10496: if the user DQ frompath doesn't exist in # password database, retur, Funchanged;&"Ahomeent.pw_dir if isinstance(7, bytes)@os.fsencode("0rooDAb'/']FelseG?! =).rstrip(*Vl! +[i:]) or * # Expand$s containing shell variable substitutions. # This e=s forms $2V$${`} only9ANon-8s are left . _varprog = NonebC defAvars3""" As of }. Unknowns1"""1 =  tglobal , b@if b'$' noa}U!if0xb2import re04- = re.compile(br'\$(\w+|\{[^}]*\})'Qb.ASCIIj@search =.fBstar{7end = b'}viron = getattr(os, 'en1b', z &?if ,-+ *)&(''&3os.kQi = 0 while TruIBm = 2, iI7mQbreakP$, j = m.span(0=vgroup(1WAame.aswith( )y8B.end3endm ! = e[1:-1] 3if 1 is% O@valuA[!dez&)]? pU~[: j_@tail|fath[j:Uwa:i] + N$`1len >0+= b3J # Normalize a path, 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 x # if it contains symbolic links! def norm/(): """NormalizL, eliminating double slashes, etc.""";F = os.fs Wsinstances, bytesvzsep = b'/'3Qempty1dot.BelseH[Z'FC = 'A72dotX#'.0if A == creturn dotinitial_)! =8.startswith(sep)+ # POSIX allows one or two Enbut treats thre)CmoreHtas sing.Cif (I1and 1*2)?not7*3) \1= 2\UcompsFplitDnew_ ![]/@for 1 ins[!if(v,g2inu Q !=/@or ( A) orI(@[-1]+75.append(Uelif $R.pop(4>S = sep.joinds1w e7*+]- orI <'abVB"""Ran absolutD#Qisabs"? 52cwdsgetcwdb8  -,"= N1wd,R :T # canonical7a (i.e.locationa file on#! #system).j@real()Cnameo vo specifiedX= Jany  encounteredr\~i%0, ok = _E W[:0],"{}9^ \\AJoinZ!s,;any/ #asecond. j, rest, seenu sep = cb'/' curdir = b'.&paUelse:7osep = IHQ'..' >if isabs(rest)R0 = A[1:],path = sep@Qwhile'<name, _,E.partition(sep)Ppif not 32 or2== S{#rent dirAcontinueVrame == < J/paI0if .b,p split(%z #=q = joinI, Y @D 3new.rthot islink(1XDs # Resolve the symbolic ^9tzin seenz# AlreadyQ thisA>[!1 isk7Non:!# use cached valM V2# Tcrd, so we must have a +Yloop.2cturn aG2t +O!ofQunchangedI!reGv), Fals( 50 = ! #'}0symz, ok = _c@real0os.3F, l*okR+ #odbT$, True supports_unicode_files = (sys.platformA'darwin') def re`start=7+B"""Ra+ative version of a2"""!ot praise VError("no# specified")@ = os.fs iinstances, bytesg oN e)JpIH F=I  !;tryL_list = [x for x in ab9:.V if xJ^@ )? # Work out how much of the filepath is shared by start and 3. i = len(commonprefix([.a_list,0 E])) 81rel = [pardir] * (K=f)-i) +BE[i:]Btif not I:return cuZdjoin(*9) except (TypeError, Attribut BytesWarning, Deprecation)qgeneric+_check_arg_types('rel',\aise # Rthe longest hP sub-D@ of sequences given as input. # TheKQs are<normalizPefore_`paringVpm (this the # responsibilityl|caller). Any trail@separator?stripped from[MeQ@ defFAath(SB"""G names, s\,B.""";crxR Valu"('m'`() argan empty''s = tuple(map(os.fs"s)if isinstance`[0], b`sep = b'/'.Felse322'.'7try1Pplit_[ .s(sep) for31 in"s]D Hisabs, = set(p[:1] = pGD2us "Can't mix absolutesrelativ"")gFNone![ccas if cJCc !=6]!@ <s1 = min( s2/axY+1l1i, enumerate(s1!= s2[i]0Z6[:iVbreak ep Uv sep[:0Bb 2+ .JsG% V@', *sc # Author:0 FL. Drake, Jr fd@acm.org #DTa simple little module I wrote to makfe easier. I didn'tI se0yth@quit-Pke itf+library, though I may have overlookedK1omeHc@when`as tryi to read some heavily nestJs with fairon-descrip6content. ThiNs is modeled very much # after Lisp/Scheme - style pretty-printing of lists. If you find itG0useful, thank small children who sleep at night. """Support tom g, tuples, & dictionaries recursively. Vsimple, but $especially in debugging data structures. Classes -1 PPer() Hand@peraqs onto [`eam usma configuredG0setIaformatWparameter1FunR-- p.F; a Python object i~ed representA. pK Q[defaultFsys.stdout]. safeeR0Gene a 'standard'()-like valu@protvagainst*q""" im3Rcolle+W as _#$re 1sys%4sysBtype from io _StringIO7 __all__ = ["J3","","isreadable 4","(!",RB "j", "pp"] def a(,eam=None, indent=1, width=80, depth *gcompact=False, sort_Ss=True):#""(eYer = (i!0str .P)d[eX Y)TkreturnQ9} J.?py, *args>n@**kwg ^%, clyPVersi3f which can h] (_f_=B{}, 10, Z2[0] Dmine if UT)qT by eval(). None, 0, Tr&ue)[1] def isrecursive(object): """Determine if  requires a 9 representation."""Creturn _safe_$b, {}, None, 0, Tr2] class05keyHelper funca for key s when sorting unorderable1s. The wrapped-will fallback to a Py2.x style comparisonvE_ttypes (zTfirst4png the # name andAn byI obj ids). Does not work^ly, so dict.items() must haveHapapplied@bothn)zc value ?_slots__ = ['obj']. __init__(self,O $.=5l3Gther5#trB'M0< o3Y$except TypeErrorB`((str(pAg)), idE < \V<<~=)5qetuple(0>Qng 2-/skey(t[0]),d(t[1])PrettyPrinte indent=1, width=80, depth=kcstream .*,ct=Falseu0rt_w!s=t"""Handle p p{AoperAs onMv0 usa set of|configured paramr/Number of spaces' each level#0nes? QAttempted maximum nccolumns inLgoutputN` NcH P out ed structure+ N@desi!};eam. If omit0(orAse),standardL @a avail#anAion wbe used S`If tru,qeveral Bcombined?tone lin~6aU|Qs are Gb= int( )U  2if .F < 0Spraise V2s#('*}be >= 0'Kiu/<=a*` _ %be != 0') self._depth = #  seindent_per_level =  (1widDif stream is not None:jg&=/"?els0 _sys.stdout5Scompact = bool()&sort_dicts =  'def pprint(T, object)._format(", 1, 0]{}, 0}.write("\n")xUMyio = _StringIO([>!io;0, return sio.getvalue(isrecursiveB0 wl6[2]T_adablSRs, re# e TCA and~g,,, allowance, context,  Pobjidd  if:Tid in@C, _$onIJ-%ve = True#Cz = Fals#$64rep_S_repr{ 1Amax_7-5& -65if len(rep) > C dispatchS(type1)._1__,R Oif pp[U] = 1pJ + 1O4delv r 6elif isinst} , z+"._T l z54_R = {} 7V F('{' 3:> 1>b-._/- 1) * ' ]Aleng`? z f! items = sorted(object.(), key=_safe_tuple) Yelse:<: = K 'self._format_dict_5(, stream, indent, allowance + 1,Jqcontext, levelwrite('}') H_dispatch[.__repr__] = _pprin-5defqordered(,+, =if not len).''areturn cl__class__ Ucls.__name__ + '('[S(list~()\! +i) ;i .')_collections.OODict + [ia :]:&" 0 endchar = ',)' ifQ"p) == 1 F ')' laS o)s ^J5u3c/w?setb0nC6typn0if "ois set''{C=}F:typV /q=_J[y =5?keyF?har) _dispatch[set.__repr__] = _pprint_set _d*ofrozen0 16defE-tr(self, object, stream, indent, allowance, context, level):Nswrite =<.if not len(d9=( )< ereturnchunks = []@line`a.splitV(TrueO"ifV == 1fU += 1W max_width1 = Belf.# -EQpfor i, in enumerate(sarep = @if iVLs) -(F1 -=$n7) < "+}q.append2 JJelseW5# A list of alternating (non-spa[)AIingsUC@partre.findall(r'\S*\s*'P 4qassert ; Q!6[-1O> .pop() # drop empty lasZ Yq2 'current = '''!j, ' 'qcandida^+D `/Dif jAWAO andYDa(i%r(F)) >B2?:3if $( #r(8)%1"/ =2=A x E,) ~ GG?velA6'('/ i,  :> 0%'\n' + ' '*vh%6repA)') p?str8"tr+_bytes Pl4$write(repr(object)) ereturnparens = level == 12if :Iindent ++allowancewrite('('delim = '']for rep in _wrap_bytes_repr(ob, self._width - %, {)xkz:repqif not 1 J5\n' + ' '*2nQ')') +_dispatch[!.___] = _pprint/9def`array( %, ntream,, context,"A = s<. ('p{.((s#),Se + 10,[_ + MQUmappingproxX1P)('] Ecformat9o.copy(?3N s <_types.M P OTypeJMsimplenamespace00if %S) is SlNl k# The #arB"" instead of the class; # ., so we do'same here. For sub9qes; use#<.P@cls_RM* Jelse11.__]A__._K%__bDlen(;)7$ nl,# *@'@itemuqdict__.(Plast_xxK!n(!R) - 1"F Ii, (key, ent)enumerateX  X6key v$'=@ = i #?entizdJ0if n / 13OI stream.write(delimnl) EstreQ')') '_dispatch[_types.SimpleNamespace.__repr__] = _pprint_s$n$Jdef _format_dict_items(self, ", , indent, allowance, context, ulevel):## =Wd@ += "._Q_per_H)+ = ',\n' + ' ' *'AlastEx = len(U) - 1$for i, (key, ent) in enumerate2W = i == cR#0repAelf._1 2O(repJ': '!( ! +PO + 21 if else 13 aif notI 6OoLAUe/ifF > 1mo0) * '%'width = max_ -' + it3terN:trypnext_en0 6(itexcept StopIt :ion>ereturn^ = False_while%y3d *0 = &6Trug&-= '|#Lzcompact6A 2j 6w 2if >< wuC P D&1if D"" ='-nlF/>= M-= w>b'6', 0B-an+in4[ vt,   allowance if last else 1, )context, level) * def _repr(self, object, -:-L,, readable cursive = C.format(I.copy()]Te_depth'eif not!9 = FalseSif re9f = Tru9preturn CtD1maxtsqA"""F1z for a specificw0ingUtringand flags indicat&whether theesentation is ''F5<6s a2ustruct.A5""" r%R_safe_OY ,?_sort_dictspprint_defaul pstream,Uent, "t)~A3lenDTp.write(')'4rdf .}factoryAScls =.__class__indent += cls.__name__) + 1('%s(%s,\n%s' % (7, rdf, ' ' *@)$._&icas7#)'_dispatch[_collecs6!._Pe__] = lcounte ,M +v + '({'#if@Q_per_F > 1 UF-._6`- 1) *d7temmost_common(%/ _i7(", }/ +O + 2O $} COkhain_mapl  rxt, level):   if not len(object.maps): stream.write(repr,)))'ereturnccls = V__class__ Ucls.__name__ + '('[indent +=*U) + 1Qfor i, m in enumeratebif i =VJ - 1self._format(m, ", , allowance, context, levelK?S'')Oelse1w@,\n'nC ' *!) P_dispatch[_collections.ChainMap.____] = _pprint_cB_mapC5def`deque(C,A    [#if.maxlen is Non Hc_itemsUQ + 2,` ]+brml = o ? J  R,\n%sw=%s)' % ('o, rml)  user_dict0Odata ! UserDict?lis?Lisostring} _dispatch[_"collections.UserString.__repr__] = _pprint_user_s  # Return triple (0, isreadable cursive). def _safeb(object, context, maxlevels,  , sort_dicts): typ =e?) if in _builtin_scalars7;r<, True, False Jr = getattr(typ, "u", Noneqissubclass)) and r is Lrif not J"{}"objid = id&if>A6 >=m0...p, idHa$inQ1_re$on_P`[Uk1@! =ZCve =components = []2Pappen2!.#(6+= 'ifx @itemde.(), key=Ctupl+OelseJ Cfor k, v_ >k4, k+ cu /(k\wv<6, v\vv\"}("%s: %s" % (v)]5 = ` if or:curCaR B4delGP"{%s}", ".join(e%), eaLif (;Glist;;d) or \ ;i w=?if w"/[]%format = "[%s]" elif leZ == 1;X(%s,)< AI/()7(%sni;u% "..."jT--if +p[objid] = 1  readable = True  recursivFFalscomponents = []2append = !.#level += 1for o in object:orepr, o cur = _safe_ (o, context, maxe1s, , sort_dicts)\(c fif notv : =  if;?cur8U n4delf[objidW return format % ", ".join(h4), e brep = )cW`rep, ($1andrep.startswith('<')), _builtin_scalarfrozenset({str, bytesarray, int, floatamplex,. bool, type(None)}) def _2on(0)eB(""u1% (`H.__name__, id]3)) xperfcheck=}import tim%j@ is ('m8("string", (1, 2), [3, 4], {5: 6, 7: 8})] * 10PrettyPrinter(At1 =.G_cou,Q, {},A, 0,G2G2p.p333 &(":", t2 - t1?p"Z32Qwrap_Uwidth, allowance current = b''30las%le4 // 4 * 4 iprange(0:+3, 4Y0parKv[i: i+4candidat3 + 4hAif i == 6 -=5dQ)) > 5 H3if | dRyield $* =JelseM)}uD if p"__main__"h_o) #! /usr/bin/env python3 # # Class profiling  code. rev 1.0 6/2/945Written by James Roskind # Based:SpriorUe module10Sjoerd Mullender... # which was hacked somewhat by: Guido vanksum """P@""" opyright Disney E@prisgInc. All R$s Reserved0Licd to PSF under a Cont ributor Agreement # # Licensed under the Apache, Version 2.0 (!"5*"); # you may not use this file except in compliance withgES. # YCobtain a copy of(" ahttp://www.ab.org/ls/LICENSE-2.0Unless required by applicable law or a@d to writing, software # dist@ )9 is!4on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND0either expr@or iEped. Seh2 fospecific languaggoverning permiss and limitations. import sys Dtime marshal __all__ = ["run", 0ctx 0Pro "] # Sample Fr1 #i_count = 0 #def integer_-b(): # sglobal 1$ =E + 1dreturn0 #iWs-g # replasC codedDJs class _Utils: a"""Sup9utility funcqwhich are sha?p01.pyc@modules.(PNot shPto be~d directly&A""" /R__init__(self, j"r).% =#D3run?AstatH,@name4'rtPK9 = W!()o6try|0.c]-NSystemExit;5assYkfinall]`_show(h >ctxzs, localsBa!w+, q b2=3%if FNonePdump_B s(=/ls4Sprint5sort) #*6 # The followic member Qiler ` # Not atAinst3of  ()*not* neea`o call/m.7** def run( statement, filename=None, sort=-1): """Run / under pro7r optionally saving results inZ KThis func2 takes a single argu that can be passed to theDf"exec", and ant . In all cases thisDroutine attempts`Xits first`Egath1ingGistics from uv. If no is presrFthenautomaticORprint"CmplesbBportPed by|Qndard@ str/(d/line/k-!)lQed inHPeach 2.1"""return _Utils(P`).run( P) def rx'globals, loc!, supplyyour own b#e.FP havev same seman an=/ctQs class !r pelf.curPalwayStuple. EQsuch  correspondai!ck fris currently active (sh[-2]). The follow!ar/J`defini&Ps of tmembers. We us,is external "parallelA" toJavoid contaminatj!th+0gra@at w]filing. (oldO!erIugwrite inr s1 diary!!) DerivedkeYPchang&e some entries, aV ngthey leavP[-2:]Qact ({previousb!In#in*@errodetected,Q-3 el ae~7[ 0] = Timbat neebe charg0 pa .'<EU ItvsFat ay will not]qo accesJ0timdata forw1[ 1`otal tPspent  , exclud[/ u4sub<1s (Bl@la talli=[?[ 2P {F ngJb 31])-3] = Name of the, function that corresponds to this frame. [-2] = Actual8'we;:P(used sync excepfhandling)Q1QOur parent 6-tuple (f_back). Timing data for eachis stored as a 5YiAe di1aryKaself.tPs[]. The index is always the nameX1in 8rcur[-3]9`follow1are7`definiAs ofmembers: [0 = nu&0imevwas called, no0untjadirect@ or recursion,![vNi appears ack, minueHTotal tip`internC53Cumulative:p- @presSQ. InKCnon-%ve"s,iB1e tPexecuufrom star80to  shSainvoca7Eof ac, includ tall subgs% [4Ae/ngv+e j!it2S by um2"""dbias = 0 #D2ibrconstant&`def __0__(,-r=None, E %):}&>Z = {}`cur = ? {md = ""_-_!if~M" = 6" =?.# Materializa locallookup speedn7!ifurf@get_! =@.processU;dispatche+dtrace_%_i4Oelse}tr-at() # test outr 7*rygLlength = len(t)1 TypeErro">  &4 if>= 2$n 6pP-_lR0# To() implement2nee1be P/edE hespo captu he passed-imer in the parameter %# list (for performance). Note that we can't assumeEthe timer() result contains two values in all@mcases.def get_[ r( !r=, sum=sum)::`return%6=())(Tself.c+ =n/'At = 0(P simulate_call('profiler') I# Heavily optimized dispatch routine .process"()^Hdtrace_>(, frame, event, argTr ([0] + t[1] -t BbiasB"ifua == "c".c_func_name =!._ )__K,[]t~I!Jelse  GrGrt # put back unrecordBelta?# DBbest program (= scalar, fast(!if# an integer but floorks too -- andW <relies on").G)_igI#(1s 2 7 +_ - t &macintosh  s tticks o1/60th secondH?mac6_/60.0(0SLOW genericr1ingUs number+lo&()- self.bias # if event == "c_call":% self.c_func_name = arg._ 5__ -1if ,dispatch[Y ](, frame, t)^t = get_time()QOelse. - t # put back unrecorded delta# In thehandlers,first 3 elements ocur are unpacked # into vrbls w/ 3-letter  s. The last two charactersJmeant to beMmnemonic#rR _pt Lcur[0] "par!@" Fa0ged%j^O(_iN1] "internalH"0 spadirectly i/HtionOeOo2] "exOdin subEsdef trace_*`_exceph-prpt, rieQfn, r0, r=2Bif ($r is notQ) and5u+breturnG Md.+6P? 1 ly 1.f_K[-2]L !!ifEisinstanceProfile.fake_ ?cassert0, ("Bad "%n,5DD{`N%,ALs; 06Kis None or \|0J-2])GDT&3]@fcodcafn = (#@.co_', rstlineno%cyLAt, 0t,6cur2timings Qif fn( Pcc, n@t, c al =WE[fn]L.`2 = @p + 1, t@D6 D%{}7*w< >"", 0, self.c_func_name) self.cur = (t, 0fn, frame, 2timings =Qif fn in :rcc, ns, tt, cPallerM/I[fn]22 = @-+1B4Jelset B%{}7return 1 def trace_dispatch_!(&t)j3r is notvcur[-2]&basserta.S*.f_back, ("Bad u"F[-3]N>YB, 0)5# Prefix "r" means part of the R ing or exit . CpCPreviousB`Parent Rolder.prpt, rier5cur~Prit =4E + te_total6retjpjpjpjpjp62, pkrQx4 = ;1 + Rpet +r-, Oy5 $ =F([r!ifc*nsY`# ThisSonly occurrenceqtion onVstackcElse tMa (directPDr in) recursive call, 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@@/ 11 - Y}UA = {^"y,":x,%Pexcep*/y,) c_i) )h.W%C ne#"cSF"} Je next few\s play withv md. By carefully preload:ing # our parallel stack, we can force the profiled result to includeFan arbitrary string as<qname of @callfunction.?We use self.cmd;#atJQ, and@Bstats lookCvery nice :-). def set_cmd(\q, cmd):isur[-1]: returnpalready@0D=I simulate_(hclass fake_code}__init__d/, line, $o_+4 = (I! =P c! =j PfirstEbno = 0aCrepr K!(&.c, o_["))e9Ofram: [{, prior1f|0 = (f_back =A J Q" =#('1C', 03vu RpMc%2]77els 0ENone( E(", d)..dispatch['!']!, 83, 0# collec|from pend9i@gettQfinalo# timingsX1fHmd_completeget_time-iDt = B() -pt Dwhilpi*1]# We *can* caPasser errors here ifRv$# Ks_trace_RcheckaW mq!> <6, ty0M+ &t aprint_D[, sort=-1dimport p&\ .S; ).p_dirs().HYuort). \<_pDdump=Aelf,with open(p, 'wb')-f0cre(/marshal.p.&7, f @R.j%dnapshom`s. bfU = {}D@for >, (cc, ns, tt, ccrs) inp.items(): callers = .copy() inc = 01for2acnt in ers.values():-KBnc +e9cntself.stats[func]c, nc, tt, c! 9# The following two methods can bed by clients to use@a profiler 0 a ement, given asRring.}def run(W, cmdimport __main__medict =0.__!preturn T.runctx(cmd, ')~!-, globals, locals%.set_cmdS0sys.dispatcher(:try@execKwkfinall8 qFNonef#is 0ore;ful`ingle ;2tio.,%, /, *args, **kw.Prepr(V) ^5O(|#3 *.|hL calculates the overhead  usn< . Gpproblemthat it take@fair amount of timrrarFqto stop wa (from<it receiv^n event)# Similarly,1 rea delay G pre-star4!he0bef2user's code re0 ge1ocontinue#30tri`Pasure difference onGaa per-c basis0Not<xat thisBis only significafh@re a0 loJcs, and relatively littlwr2perp. For example,Gwith smallps will typiy benefit0havY$thbibrate{current platformbis *could* bE0donJp fly duq init()A, buis not worth0effort. Also"mif too large a  specifiedx-uq` on so3ionAactuEaappearv1neg number. It*normal* T(CveryE0lowKl counts) to have 8such negative stats, even if the # calibration figure is "correct."' One alternVto profile-timeMadjustments (i.e.,Eadding in magic little delta dur!Aeach t)to trackF0morpqrefullyKnumber of6s (and cumul7ly,(H.wsub funcs) that are seen. I=dis werCAdoneZarithmetic could be #a afterCfact3 atdisplay J). Current"weP onlyfl/return.CThese values can{educed by examin\ th=allees %callersGvectors for  . Hence we *can* almost c0E!in(l[at printR(notebDwe c.'` excepv@cess`counts1Unfortunate5&th'is_no similar i3m'or-T sub-1t w0notbhard to "get all this[!" "rESpecifical#weS@haveL`extendOp tuplesCkeepFmQrame,Wthen GAdefs0SimingG\`includae sign#wos. I'm a bit fearfulG% al#tOwill slowheavily optimizedC t/b dr$1runPer, fur a veryHh"t added"".)"** E0def9e(self, m,bose=0):'b0if .__class__9P9*.raise TypeError("Sub8es must override .be().")Csaved_bias ={ E = 0;try_._kv_inner(Tw0fin F?mD Z1KIAget_N# Set up a te!asL0be 3Awith ou0ingQ# lot0s, becaus 'ry|to quantify stopwatchBhead0Do  ans;Houghd0 wa|go knowexactly how mGs are generated (one call event, +  # dreturnper Python-level;5). 5def f1(n):Ofor i in range#[x = 1I(m, f1=f1O mOvf1(100)Q@f(m)# warm up th6che% # elapsed_noprofile <- time Atakes without #Eing.t0 = get_4%()> /t1%}= t1 - t0<if verbosecsprint("C N =",& The differenceF# is( overhead, only some of whichsr subtractsKpon its ownqRp = Pop.runctx('', globals(), loc   /'a reportedb"CPU seconds"Icharged to f and f1:`total_fs = 0.d c (name, line, func), (cc, ns, tt, cpallers)\p.timings.items(%if\@("f", "f1"(K]+= ccm V+= ttY 'f'4er SZ G! #8s427if  != m + 1 raise ValueError("internal e:Dlb %d" %p"#. -&% = egwasn'tK@ables measure. Divide by twice@`numberB(sinrCvare twor s 9this test)w1getaghidden<G mean = () / 2.0 /JeE fstopwatchPk.O #*$************* def main(): import osfrom optparsepOptionP!r 'usage = "profile.py [-o output__path] [-s sort m module | script(] [arg] ..."\{Hr = w(r=)'.allow_interspersed_args = False+Add_o('-o', '--ou', dest="!",9 help="Save stats to <' >"8fault=NoneombmP", acV="store_truevP^ a libraryA.xys lSrder when printingstdout, based on p !.SWclassP"de2-1).if not sys.argv[1:]|`.o_(3cexit(2K(0s, D) = @?;nA:] =.S# The that we're may chdir, so capture the absolute "# 0 at+Qrtup.% ifSSions.91 is5 %P= os.k@.abs"rif len(6> 0Rzx_Qrunpy1codBrun_9(modname,  @='__IB__'):@glob{T'=Q ':J6py.u,'v!':9[0]S}Jelse@prog ;S.insert(0,m0dir9(B)with open!, 'rb') as fp1Mcompile(fp.read(),t, 'exec'iG_c6_':D t0'___&e__package+%ocached$:tryprunctx(!, !, e , except BrokenPipeErroro:excl# Prevent "E6ion ignored" dur.preter shutdown7! = ]exc.errno H creturnP # WppinvokedVRram,  eraD if F == : main()P """Class for printing reports on profiled python code.""" # Written by James Roskind # Based @iZFp module1dSjoerd Mullender... # which was hacked somewhat by: Guido van Rossum # Copyright Disney Enterprises, Inc. All R$s ReservedoPLicento PSF u a Contributor Agreement # # 2+the Apache, Version 2.0 (!"5 "); # you may not use this c except iempliance with FEYCobtain a copy of(" ahttp://www.ab.org/ls/LICENSE-2.0Unless requiredapplicable law or a@d to0wri4, software # dis@#edT9 is!on an "AS IS" BASIS,]ITHOUT WARRANTIES OR CONDITIONS OF ANY KIND0either expr@or iEped. Sehspecific languag`govern`permiss and limitations`. im7D sys o Dtimetmarshalre from enumort Enumfunctoolscmp_to_key!Pdatace#"0typDict __all__ = ["Stats", "SortKey FwBionP'1] u 4Q(str, ): CALLS = 'calls', 'n UMULATIVE#umulative(0cum/')qFILENAM''1nam%mK$1LIN Bline2.H0NFLj2nfl"Pp4STD;6std>"TIa, 'tot  \ def __new__(cls, *values 1 = As[0]9obj = str.C))&!._ o!!Rs[1:]i3clsG2member_map_[>u] = obj]Aobj.+S!areturn45 @z(unsafe_hash=True)0 YQ: intY`b: floa0per_1.F_:vo90_nu6'''N1keevPtrackpan iteminventory.''total_tt_0s: [f C@"""TZ isldcreating rep>orts from data generated by the Profile class. It is a "friend" of that !, and imp[VaeitherLby direct access to members ofk@, orreading in a dictionaryPtxwas emit(via marshal):theY!. <The big change,previous5r (in termrraw funQlity)N"isan "add()" method has been providedcombine StaFseveral distinct4}0run|@Both constructorqwGz now take arbitrarily many Tnames as arguments1AlleSprint&s Nn2indicates howaQlines1to H:fW2argBPfloat poi nu P betw/0@1.0,6nMi|n decimal percentageHvailable u"be!edM(e.g., .1 means@ 10%CZall aC)an integer,M an #of"ofkyou wish2havp.#ed`sort_s*#()0proEes some addi@l op s (i.e., i>!o#old -1, 0, 1n2are respectively@rpreba@'stdA', 'calls Rtime'p'cumulaA'9t"s # ay)0quoipstringsSortKey enum0selDSorder5For example !='')ZeR.TIMEQNAME)I2s omajor key,' Ernal j o7min6C V'. Look atCPtwo ts)&Aget_arg_defs(self) for more%s return 1P, so Bcan P toge commands like:tP('foo`goo').;p_dirs().*5).\?C 25).eRers(5p2"""def __init__, *args,eam=None)Seam =$ ys.stdoutif not len(RE = ^17els%>5[0](0s =JFs[1:t/)+,LQ.all_:em # calc only if needed self.files = []cn_list = Noneptotal_t0@callU _prim_max_name_len = :top_level = set()v@statp+{}ort_arg_dic Qload_=F(argUEtry:J.+Eget_74except E:ionAprint("Invalid timing data %s" %nr1 (u@[-1] else ''), "=fstreamHaraise _Gdef 3 ,  if1 isJ0.-7 = Jareturnfelif isinstance]j, str)Rwith open!'rb') as f'R }marshal.*(f >#Q = ost ;*Parg =e.ctime(;P.st_mP) + "-0" +/: # in case thisSnot unix04IpasszF[arg[phasattr, 'create'cHarg. :zi,  O6ot A w TypeError("Can or construct a %r object from %r"%__class__E-for func, (cc, Ptt, cpallers)6?s.items(C Q+= nc# _ += c#F tt4Y+= ttFif ("jpro's", 0, "!r":ersMP.add(?%aif len0_st&AringB)) >h#/ =T0, *fy w.reversed:YAtype{Q) != > )-ptem = S}($t_0+= %s +1>[/ self.total_tt += item.tota' for func in&p_level:(3sself.to P.add(;)) *1if )max_name_len <]`#  mjfcn_list = None"e, stat s.>s()%ifc/'@old__$" = s[]1OelseKE(0, M{},)LmW = ad)s(Gareturn6def dump s(_`, file("""Write the pro# data to a2 we know howload back."""with open(Cf, 'wb') as f'marshal..g3, f!# tuple indices and directions sorting,# along 0somintable descrip:,9_arg_dict_defaul{{q"calls" : (((1,-1),1), ( count")6 "nFE'pcumtimeE3umulative 0c""J,1" J?4, ( 1lin D5D( numberFRmodulH&D6J0nflJH((4p//p80Qprimi10stds7standardW2internal4totKH$}Fget_"ef 0ExpJall abbrevias that are uniqueaif notd.a:ictk 0 = cY = {}\4bad for word, tup in self.sort_arg_dict_default.items(): fragment = word dwhile &@Ooif not% )]breakc%if?@ in l-bad_list[_] = 0X/vg E?tupGi% =Y[:-1]-1forD1del[oAoreturn dAdef `stats(, *field z1A.fcn8 .}n6rif len(c == 1 and isinstance[0], int># Be compatible with old profilerh.e = [ {-1: "stdname",&*0: "calls$1$/tiG 2#cumulative"}[V[0]] *el J>= 2^0argA:1:]"if type(arg) != 0+0]@0raise TypeError("Can't have mixed argu\"")/;/ Refs =[Iget_(2tuple = ()}=6dU = ""connector (ifI), SortKey  e.value~+1p&[0=36+= A /g= ", "p[wfunc, (cc, Ptt, cpallers)6uD _.append(O@) + h) +/ (&_std_string!),=)rg(key=cmp_to_key(TvPComp(_!).)reHt 'D { H;1F[-1] Kreverse_orderNw"if,] s.I-pYRp_dirm1old md = new #{}# max_name_len = 0 for func, (cc, Ptt, c allers) in oldstats.items():AH0newD! =K_strip_path(),aif lenA_std-3ng(C)) > max_name_lenim/ =M zBnewcY = {}22, $ R[S2)] =P o3if h1new][.PCadd_nIats(X L,; )OelseT  old_top = self.top_level!  =W2&t(pV 0new9D.add )v  *fcn_list = NoneAall_i,es areturnR0defOc1(!if-.T R ; &A) .+!ot(o `222('/#*.H The followingf tions support actual print"Pof resA.*@# Opzal "amount" is either a line c0, opercentage of"s.KQeval__N, , [W, msg !1istvif isinstanceEW, str9%>tryrex = re.compil=_7`except#^errorC msg += " \n" %a7 %#[] for func in list: if rex.search(func_std_string.))6E@new_Tr.append,`Jelse8count = len(8),Nif isinstance(sel, float) and 0.0 <= sel < 1.0Z@^Bint( */J+ .5j.Qist[:3]/el$in<9selX&if'" !4 msg += " List reduced from %r to0due rection <%r>\n" % (,{,T%) 0treturn R, msgdef get_stats_profilf"""This method NTs an P of SCPB , which contains a mapping0of PnamesPsQ1FunT{. Each P; holds informa_prelateda5thew3's such as howQXlong 0P tookE@run,+ many tiit was called, etc...L5"""  *Qf.fcn`[:] if m!f.v.keys()0aif notJ  g(0, {}"ptotal_t2(f8qn:es = {}G* =tK,B1forf cc, nc, tt, cqr3sel [< &_g, line_number! =z[`tr(nc)nc == cc#(s+ '/' + 'cc-H0tot%c,\+tt$0pern_,&-1p0oLtt/nf ^8< 0@ 2(+2# _hs*0ileBsL(*e },Endent = ' ' * 85unctop_leveliG,T%KoGtotal_calls, "Q ", end=' 'VdJ# !Bprim]P"(%d #Ritivet@)" % f.<p"in %.3UcondsN/tt C,27(q!if. x5ftitle(P ="ABlinet"^$m{/ee})9AcalcqS(!nt"P_head"_d..."c!iffall_callees:  self.print_call_line(width, func, " @ees[<]) M]else:&Bd *{}P-a(file==ostream$areturn Adef Y@ers(\, *amount)alist =BR.get_=(3X0if C_\theading_Q"was Ud by..."1for? in]a@cc, Ptt, cdallersCstat7 {rs, "<- K_- , name_size, column_title"Function ".ljust(:9) +</, `#)P sub- er only if we have new-style%rsc3sub4u= Falsei..values($ifm i2 = next(iter(L)_5isinstance(L~, tuple5Ubreak if& 5 "*@ + "xns tottime cum "k  Psourc# diarrow="->"L_std_str>)8F, end=' 'aif not_xBcXQortedYg.keys(Pinden%""=qCI ! =e 2 & =h?if C v- 1 = b P'N~c != ccD!1sub1 = '%d/%d' % (^ . HEB p1s %1 %s2!.rz7+2*len(=)),f8(tt), f8(cQleft_&B + 1n else:+  substats = '%s(%r) %s' % (name, value, f8(self.,[func][3]))Pleft_width = C_size + 3+print(indent*4$+ s, file=vJreamm<q = " " \Adef Xa_title!): (' ncalls tottime perY cum', end=' ' Z:lineno(&_tion)=4 , 8): # hack: shouldqentagesBcc, nc, tt, cPaller>2ats3 = str(ncVif nc != cc6` = c + '/' +7c7c.rjust(9)3_f8(tt1J== 0~_' '*8yOelseB?/ncvOf8(c?cc JOct/cunc_std_string) 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 need9!beLAed iw7s order.""__init__[_select_d+ 8omp3l-Care \w, rightW'x,|?in oYs@l = U[@]2r =kif l < rO7ueturn - U8>87rQo0 #*6! #_N i triple (d: , 4Q:int,i0) VEp_path(func_na me): filename, line, = func_ %return os.path.bas4(=)>R defA@get_JAtionN(zU7[2]6std_string/9): # match what old proQducedi{[:2] == ('~', 0x # special case for built-insP.L!if3.startswith('<') and3end'>'<'{%s}' %0e[1:-1]{Belse15& ""%s:%d(%s)" %FO #*6P # Th<qllowingg9 combine statistics cVpairs'.Bbulk of the@cessO involves correctly handl "call" lists, # such as 1ers~ ?es.:1add_s(target, sourcX"""Add together all30twoentries."""cc, nc, tt, c0all=e% t_'!t_)_+ t_-!t_Rrs = /B(cc+:n =1t+t@c 1ct,0mS(],m")) &CR` in a !le 7new!{}M8?w.items(iA[43] =KK\nV if isinstance(d, tuplT# mat used by cP$qV`(i + jHP i, j5zipz 8)))\ ?l- l ;- _) +_$c6 5&bBcounssa"""Sumas{to get total numbero)s receivedqQc = 0g&#in4zs.valuebc3coUsupport printPof res*************  def f8(x): return "%8.3f" % x #Y 3 # Statistics browser added by ESR, April 2001z: if __name__ == '__main__'import cmd 2tryreadline!except I7VError0Qpass &class ProfileB(cmd.Cmdsa__init__(self, p4W=None*.@.2)pD.prompt = "% "stats = bream = sys.stdout%$ifq is notH0do_=()sgeneric@fn, f 0argz.split(processed = []for term in G V.append(int(L)~0rcontinu#/[Value.: frac = floa @1if *b> 1 or >< 01 pr"Fractio5ument must beI[0, 1]", = st3[ jLHe)  P3if >ats>qgetattr.]u, fn)(*[ NelseF|0No C*`objectiloaded.x0iQ_help d|1Args may be:n9* An integer maximum number of entries to 1'("* A decimal$alZbetween 0 and 1, rollinge what]selected+ regular expression; onlyVwith funjsthat match it are printed.", file=self.stream) def do_add(!, line): '0if j.stats>try5.`Z Y%except OSError as eN("Failed to load istics for %s: %s" % (oO, e)y?elsrn(Nobobject is|\Yreturn 0pEhelpr lxpAdd pro info from given~currentcalleesgeneric('_<'/!]P (Hthe  {i_i(ur(/rs ]/rs[1EOF i/("0_1_`Leave browser _do_quit8B?rea:  hD4@ = Sq)>8.rri+err.args[1] 5U{E1ion}__class__.__name__ + ':', err,prompt =y + "% "elif lenG./^) > 28" =)Y[:-2]O#y1do_5 ]"-- cannot re( returnC 0 def help_read(self):$print("Read in profile data from a specified 1.",=M.stream)SWithout argument, reload the currentJRSdo_reversek, line3if :ats.Kz_order(Nelse=& No statistics object is /ed|oreturn |R>Qsort 1 ofing report THQ ?notU - abbrevs =P.get__arg_defs!if and all((xKa) for B.split()r|/n9s(*6 9 `Valid I keys (unique prefixes are accepted):c(key, value)`Stats.h0ict$ault.items(M%s -- %s" % \O[1]) f |tSx`accord'to~:V@(TypB`~;' wps lists;!id/.)v complete, text, *args![ata if a.starts(Y5)] d2do_u .generic(':'6 W!Y >0("P)B_/()3riphy strip_dir- )_{ WSA leapath informationwPnamesDr.stream)  def help_(self): print("Show) for a given command.", file=@.stream) Gdqpostcmdb, stop, linen!if areturnXBNoneqif len(sys.argv) > 1Opinitpro4 = %1[1]UOelse,br6try$browser = PVB(i)\;;~&in62:]S)W.do_add(4IWelcome to the ' statistics Imcmdloop(kuGoodbye1I except KeyboardInterrupt,pass # That's all, folks. """Pseudo terminal utilities."""7Bugs: No sig! handling. Doesn't set slaveGos and window size. # Only tested on LinuxSee: W. Richard Stevens. 1992. Advancedgramming in]UNIX Environment. Chapter 19fpAuthor:]*en Lumholt -- with additions by Guido. from select impor $os %sy ,tty __all__ = ["openpty","fork","spawn"] STDIN_FILENO = 06OUT16ERR2 CHILD/ _($""q() -> (master_fd,2_fdnOpen a pty $/pair, usf5os.` if possible" 66(AttributeError, OS O name = __90_fdd%(8 Z1fd JaN Rc Ty4" 0ile;0 ofQ end.5Deprecated e pty() insteadj1 ]= os.tty wfos.close Ja" 1"""@tty_k)L4x^'pqrstuvwxyzPQRST']%y%0123456789abcdef% pty_name = '/dev/pty' + x + y Itry:fd = os.open(pty_name,yO_RDWR)2except OSErrorNcontinue5return (fd, taTraiseX('out of pty devices') def slave_t)?"""3 ->5!fdOpen the^2 and acquirerolling terminal, 1ingGed filedescriptor.Deprecated, use +pty() instead.""" +gresult  from fcntl import ioctl, I_PUSH[I  ~. _M(T, "ptem";& ld3( 1Apassx Vfork((pid, master_fdAFork3makhild a session leader with a  o!(Attributea,&Belseif pid == CHILD os.setsid( c# already set us%5,f6pen-# Establis4new\ os.close()10# S7 becomes stdin/stdout0erroc9 gQdup2($_STDIN_FILENO>os.(?OUT)=ERR)5if vg > STD& +1 Explicitlyqtty to 0#it &ty Dtmp_p(os.tty*G(STD ~(H9 #l# Parent process)q_writenvCdata@"""WA all'a `while #vn!s._^:-! =4C[n:]t6(fd@Defa functionx0os. fC1024S_copy_fd, master_`read=_q, stdin  ): """Parent copy loop.aCopies (pty master -> standard output (e):, in+7-> L:A)"""<sfds = [Tfd, STDIN_FILENO]$while Trueqrfds, wxEqselect(f[], []#ifp_fd in ?MQddata =&N&fdH*pif not 1: # Reached EOFU%fds.removeO7els8os.write(STDOUT,v)if/ }TcM{| B_n def spawn(argv, Create aBed process._qif type\B) ==#''w1 = #,sys.audit('pty.0', *!5pidfd = fork(`if pidlVCHILDfos.execlpkf[0], *S6try+mode = tty.tcgetattr$osetraw!`restorO1aexcept\`error: # This is the same as termi(=,Q0 _aQ,0OSEb3if f{?tcs,TCSAFLUSH, C!) }os.clospreturn kqaitpid(0)[1] """Routine to "compile" a .py f"toc1. Dmodule has intimknowledge ofb`format2.py@ s.t import enum lib._bootstrap_external%machinery5uti1$os tos.path%sytraceback __all__, "main", "PyC# cInvalidationMode"] class 0!(E3ion5""" raised when an  occurs attempting tonBile. "ToN tion, use"hq @exc_M, `value,c[,msg]kGwherH*3dlU bevqmessageG ncan be accesses as class variable 'exc_type_name' %value: exception  to be used in error message0can1accesses  ]0fil~@ of  being compiledAgAmsg:` str~}pwrittenSIf noKis given, a defaultoeowill b]?consistent with 'standard' py_, output.m4(or/) KC'msg?2"""Udef __init__(self,| ,, msg=''):_% =<!._%__*%if is SyntaxENtbtext = ''.join(traceback.format_e_only(b>)))&errmsg = m.replace('File ""', a%s"' %KJelseY"Sorry: %sT" % (,[)E. or1msg:sH,M.f,+I' #b! = = ^3str]:qreturn |bmsg PycInvalidaMode(enum.Enum@TIMESTAMP = 1CHECKED_HASH = 2+UNA3 Cget_'_in _mofif os.environ.get('SOURCE_DATE_EPOCH . ;:3(0, c=None, d oraise=False, optimize=-1,n Lsquiet=0 """Byte-| one Python sourcetbytecode.a:param%Y: The6C'(ptarget OX 6 When notEthissthe PEP 3147/ q488 locd G: Purportedpp, i.e. K that shows up in~qges. DefaulVts to the source file name. :param doraise: Flag indicating whether or not an exception should beJNEd5n a compnerror is found. If Ioccurs and thisOfPs setFalse, a strnature ofeNwill be printed,pae func"`returnpUrcaller.K]  1Tru2PyC E H{2be B optimize: The alevel forpr. Valid valueOare -1, 0, 1R2. A&7q-1 mean21useTowicurrent Urpreter, as given by -O m2lin9ons0inva_mode:mquiet: Rfull output with 10, lbs only!1,J)no;12. :d: PathQresul@bytedC80Not(at it isn't necessaryG9- Python moduler|Qexecuefficiency --/xitself J3s aFkFT load ifcan, writesL@code1the@correspond[H.pycPHowevEif aanstallPsharetween users,Ais aegood ideaz3alls upon i]b, sinco\P may abe abl1 indirectories  @thus%@y wo D-n0the8<)y each timeThis can slow down progstart-up considerablyt%Seaall.pya script/_P that$is!to {ne`s (or .sOselected?Q) Do FileExistsP if cT@ endQ poinc#at$non-regularsymlink. BecaW~0use[renaming!#wogM1same typN4aGit was previousZ1"""s 3Non.  = _get_default_!$()_>;is Sfe >= 0:  optimization = Fe if >= 1 else '' 5cfile = importlib.util.cache_from_source((,;C= )P:RIs.path.islink(E)Ymsg = ('{} is a sym( and will be changed into a regular S ?B ';` writeUbyte-compiled8bto it'raise FileExistsError(msg.format1'ele0 Unot oInon-!ondMiloadermachinery.SIL'c('',G_Bs = W.get_data)6try;0cod.D0to_(S0, d|" o++_eeexcept Efas errpy_exc = PyCkDerr.__class__,4 `if quiet < 2Y!do   /psys.std!(:.X+ '\nQeturnU `dirnam2m3if  os.makedirs(!g@=Apass^if invalid!_m~'cIMode.TIMESTAMPH)Gstat|_~Qa _bootstrap_external._to_timestamp_pyc(II(, 0['m0,']csize']=lseIhash-\ IM | s(CHECKED_HASH)E1alcR3r_atomic$, ' , wr  def main(args=None): """Compile several source files. &#Th named in 'args' (or on the command line, if#!isDnot specified) ar2z d 7C resulting bytecode is cachedEiknormal manner. This function does oearch a directoryEstructure to locate; it onlys Cexplicitly. If '-'9parameter+*,#qlist ofC`5aken from standara3put}1"""10if J3= sys.argv[1:]1arv = 0 <== ['-']= whFTrueU Ystdin.read!()V(!ifo3 I!Ybreak3,! =\j.rstrip('\n'`>tryTc(J, doraise= Aexcept PyError as e \:1bstderr.write("%s\n" %HO.msgx/OSqCm7els5forR} N^# return valuuAindiw`at leane failurew-~rv if __m__ == "__main__"#Pexit( ()) """Parse a Python moduledescribe its classes??enough ofIrecognize importCOM Mp defini s,=find out^Qsuper9"esk 0. interfacwSnsist$esingle> mB_ex( p, path=|t) where !isXx ,<Pan op3al Bies YIv4@to b"edrpresent, Yprepended@system s' 3e1 is)C ar61key(Q$di  n 42p(includ7@thatY aed viaX3XXX! YYY con)\s@ inHc^Class and FuTnction. One special key/value pair is present for packages: the key '__path__' has a list as its vIwhich contains:H search path. Classes and Fus have a common superc): _Object. Every instance hagfollowing attributes: module -- name ofm;# #ot# fiD# 1in L) is defined4alineno4 1 in.@Qwhere='<ir startsF0par 2is :, if any.children/cnested'#s "edAt. The ':'BAa di>ary mappd1Ds to\C. Isa describe fAwithU from LCI?es G [, pluXl"ofk [(sdsapossible)gpmethodsf2of g`beginn1numbers. IF.atnot recognized,.corresponding ent0is Ha2 but a str0giv #. Since importtements are%#edv s $scanned as wellis shouldn't happen often. """ H4 io 4sys lib.util@toke/ LNAME, DEDENT, OP __all__ = ["read 7", 0_ex  R"] _1 s = {} # Initialize cachf$we've se! U"Informaabout Python%or?!."def __init__(self,q,} , d , vBno, 8)n3.# =;Y=N Z! =a m# =v # = zN 1add,r %@ren["0] =$ j(C=tavp, incluqs)S=Noneh.tion about aH Python class." def __init__(self, module, name, super, file, lineno, parent=None):HL_Object.P I)C.s = [] if@ is nR else 4methods = {} 2addlw) s[$3] =1 Jnest_function(ob, _-,+Q"Return a F/p after Cing within ob0newL% =1D(ob.g:ob.?"ob;ob._addchild(1Z%if isinstanceC G H1Xr[XY <I=r(%V1 = /#o=,]+91new-Bread(i, path"! os for the top-levelSes inr.@This. original interface, before+s were added.2"""J#rekey, valuev_ or []).items(C AH,%)pres[keyE&R(executing) itE89 ?%, inpackagee hard workS[_ex]&IfFgiven, it must be0dot1 ofz1 inwhich we are sRa subz,Qthen dFUAs; otherwise,`kEkcombinedO # ComputCfull  (prependy2et)7v1not:V = "%s.%s" % (Q=F# Check in the ca che. if fullmodule in _m !s:#Vretur[0!] %# Initialize the dict for this Q's contentsztree = {}EPCheckit is a built-inB; we don't do muchd&esmAsys.B#in_names and inpackagejFNone-"s[K@] = "# a dotted r3i =.rfind('.')@if i >= 03A[:i],2subRV[i+1:!parent = _read,(Sv, path,XJnot &H = "%s.%s" % (O_X WJ0'__z0__'Zraise ImportError('No pJd {}'.format)j,[]]# Search`&1f = 4sS! =}97elst%0 + 0spec = ilib.util._J_Q_fromf(', Y(0if /~MNotFoundCf"no6d {cQ!r}",=kI M4# I$ a?._locationsW ! =Ho6tryPsourc(.loader.get__except (Attribute6,)^D# IfM0is rPython _,0cando anythingD& I9!isz =>fW&@file dpcreate_$R^W,& s def _E*C"""R!hePrticularo.h )+8`, beco7"o. passed to recursive calls of6RgRtokenized. D}s causeb.tobkFv{} or {: }. inpackage, None or string, is passed to recursive calls of _readmodule. MThe effect of 3ais mutglobal _Bs1"""Jf = io.SIO(source)  stack = [] # Initialize  of (class, indent) pairsg = tokenize.generate_@s(f.Qline)jAtry: +2for:Rtype, ,urt, _end, _;V in g7;"if/: == DEDENT$(?no, this" =b' # Close previous nested es and defX2Dwhil-&7[-1][1] >=}D0del ck4 $el^'def'C., func_name  = next(g)[0:3];!> != NAME$*continue # Skip with syntax error70@cur_! =vbur_objw.[0mi_}v](9objW>Oelse@# Itajust aj^Ks@Func)R(full^ fNPtree[OD] = ` OL.append(8) %'M(G'k) # Parse what follows theC &l onheritN7(s1lispQsupere level = 1  super = [] # Tokens making up current &oclass.Fwhile True: vt]atype, , start = next(g)[0:3]?"if7 in (')', ',') and?= 1~n = "".join()n/@if nn?tre*# We know this2 34f/[n,?elscS.split('.' Wif len(c) >C /1# S9 form is module. D`# lookf<K6@m = c[-28 *Oc[-1.@if m_shDd = 6/[mn8@if crdk7??d[ch names.append(n !o== '(' +)elR)R-R V?= 0 /_break /,'}Opass[# Only use NAMEYOP (== dot)sB -1VO, OP148# Expressionsthe base list are noJoportedainheri 1 if6/ckcur_obj =%/[0+Qnest_(rQ5Bobj,_, lineno, "Pw@ = C^R(fullo e],  fname, lineno) tree[class_name] = cur_ 1stack.append(((, thisindent)gelif token == 'import' and start[1]-0:lmodules = _getjlist(g`for mod, _mod2 in<U/?try# Recursively read the #edZ.<if inpackage is Nonen2_e(Npath+?elsQ  Cv,>except I_Error 4 r/[]e]Q # If we can't find or parse,# too bad -- doNdie hereIpassR Ofrom,`if notzLB!= "")continueIUF")dz   2 ^# Add any Aes that were definedS P our p space L2heyPgmentioR An, nLs2gd<, n2n)Md[n])/*'P1# Dv1add.~ with _` ([0] != '_,  StopIterawf.close(preturn Pe def2(g)CB"""R* of (dotted-A, as uMP) tup source g. !An4ame is the name that follows 'as' in an as clause. """names = []while True:+#, token = _get5(g)"pif not 7;Xbreak'F= ,>2h 7elsa5u = Nonehs.append((,&2)!= "," and "\n""in 0= next(g)[16"if1 N 8areturnxs defR6""R%(dotted-1 or,|-) tuple for|source g.Gpart5Ftypef20:2'ANAME=2'*'(Vd{<x aqB am.cS~WJ X".".join()))bmain()a"Print module output (default this file)quick visual checkimport os2try]mod = sys.argvlexcept& __l!__Fif os.path.exists(modY3%0dir&F&$Ebase%f$ if.lower().endswith(".py"r,Prmod[:-3g tree = readmc0_ex , (lineno_key = lambda a: getattr(a, '#B', 030objRpsorted(e.values(), key=1T, reverse=?indent_level = 2 Z`obj = R.pop(>if isinstance(obj, list-0# V is a __ __Ivcontinu;1has_''cBobj.Q = 0 Tl_Objec@new_OSchildrenWZ^u4( ob{p$&ob"+  @.extmX [ClassMp P("{}c2 {} .format(' ' * obj.indent, obj.name, obj.super lineno)) elif isinstance(obj, Function):(/print("{}def {} {}".format(' ' *mbindentnx` if ____ == "__main__"l() #!/usr/bin/env python3 """Generate P documenta in HTML or text for interactive use. At thB prompt, calling help(thing) on avtobject }sPZ, andA) starts up an a session. Or, ashell commPB outside of: Run "pydoc " to showqon some#. - may be >[3a f, module, packagQr a dotted referencerpa classz?0 win# aGQaUP. IfAA arg contains %`th seg delimiter (e.g. slashUnix, backWindows) it is treaaApathJ source fil"V-k directoryZL% R_Manual pages.` __allC0 ['C ']QuthorP"Ka-PQYee " __date(26 Febru2001" __credits"""Guido van RoX,tan excellent programms language. Tommy Burnette,original c orrmanpy. Paul Prescodd0ll @work| onX. Richard Chaxlain, for the| first implementation of textdoc. """ # Known bugs that can't be fixed here: # - synopsis() cannot be prevented from clobbering existing> loaded modules.- If the __file__ attribute on a. is a relative path andC @current directory3changed with os.chdir(), an incor,ET@will displayed. import builtinslib._bootstrap _external%machinery6uti1enspect%o o8pkg2platform)$re %sy4sysconfig5tim(utokeniz0urlEparswarnings Pollecms};RdequetreprlibBReprtracebackat_excepN`_only -% common routines defM dirs(): """Convert sys.into a listCabsolute, exr, uniqu s.[LXQ = []ZJnorm0for5 inl= =@.abs(dir or '.')U*Y.@case/(0if C0notvsNk is'3dircz.appendXJ!}`returnu_findclass(funciQcls = m%1get!2.__"__R0if .vis None5jb@namejp.__qual__.split(LV[:-1]G\P= get`(cls, 3|?2.is3cls (clsdoc(obj7Bif i.ismethodUPbj.__P__.__!__%Eself% Fif (d#)BF&,sD), ' ')noI!# k gi]7els?%1.__J)el4,6 -[ fx6obj@ Q& nspect.isclass(self) and .__qualname__ + '.' + y == obj!)):A# classmetho[`cls = a1Jelse?%1.__J!__/# Should be teste fore isdatadescriptor().2elif isinstance(obj, propertyRfunc Afget< 0.__Q_find(')<0if "is None or getattr(cls,L) is notQ areturn:Qnspect.i[@obj)ci# !c1obj/if)8kmember0@slot7 ?1'__A__','y4d*a, dict}A in  n>~[,]%for baseXcls.__mro__^6try g dou_getowndoc(G"except AttributeErrorQcontinueb0if ef 11doc3(g def A"""Get the]umentation string  an@ect te`inherifrom its/A."""! (_C"__'__doc__',o(3objZ type4 w#).vDHn,@doc,xD:docd@ .\cobject!. All tabs are expanded to spaces. To clean up`s that5FPindenpto line,with blocks of code, any white_Ern can buniformly removed Nbsecond^ponwards(gR~"9J FfD(R, Typ,!if UQ 5 doc) def getd*oc(object): """Get the doc string or comments for an 6A."""8result = _getdV;inspect.getFu<Sturn Cand re.sub('^ *\n', '', .r@p())Z'' def spliv6docS( ainto a synopsis line (if any) {Erest#0s =F.|.pa('\n')qif len(+b) == 1NR!re0[0]4*el6A>= 21notEs[1]P s\n'.joiB[2:]z=$)7classnameP, modD !a ) qualify it with a82ule"if necessaryF<=6 __!__ &ifmodule__ !=T& D-q+ '.' +S1cisdataaCheck  is of a type that probably means it's NnDot ("issP-+droutin&frHtracebackw J5coddreplace(text, *pairs;DHAerie1sglobal 4* onkB,awhile Lb" =i/B[0])%412:];CcramfmaxlenOmit part ng needed to makePfit ipmaximum5gthwB) > jPpre =R(0, (g-3)//2 os>0max%$F-pre$p[:pre] .|[ o)-post@_re_Ppid =gcompile(r' at 0x[0-9a-f]{6,16}(>+)$|.IGNORECASE)satripid]UPRemov8e hexadecimal id from a Pytho>/resentationP# The behaviour %pPimple]0-dependenAtermXcase.Wqr'\1', *'_is_bound_method(f)KR`s True% fn!a 6 6qgardlesqwhether@ufn was edRr CR'ifac 1zbuiltin2self = getattr(fn, '__self__', None) return not (inspect.ismodule(4Q) or 2 is=>: False def allmethods(cl):eQ = {}for key, value in xgetmember?,isroutineRV[key] = 1Z1basTPcl.__ 2s__7.update(+@)) #` your  are belong to ush0keyo.keys(getattr(cl, ACB_split_list(s, predicat@"""S! sequence s via(c, and pair ([true], [fA]). 4The(s a 2-tuple of !s,,;@([x xFs ifuF(x)]) )]-2"""yes = []l&no p yyes.append(xeJelse(+no'rryes, novisiblename(,=?Q, obj """Decide whether.show documentation on a variable.# Certain @ial os}redundantinternal.*# XXX Remove __initializing__?#!ifK{'__author'__builtinsecached{tK0'__@+4doc Dfile ?Uloadeo,@ '__ apackagSGDpath+Hqual;2sloTversion__'} 0Z# Private2}hidden, butdisplayedl.startswith('__')G.end:q# Nameds have public fieldsG, ^ a single leading underscore1hasrobj, '_c'5TruM0allHe# only that which the programmer exportedq__all__r*1all ) m"')classify_ _s(objectu"""Wrapc) 2,fQfixupdata descriptorsgresult3kind, cls)w %if is(,s = 'data descriwptor' if isinstance(value, property) and .fset is None:CNkind = 'readonlyCnresults.append((name, 9b, cls,h!))\sreturn 4 def sort_attributes( s, object)'Sort the  list in-place by _fieldsthen alphabetically# # This allows data descriH s to be ordered according#ao if present.)P= get(3, 'R', []2trys9_~@ = { : i-len(s) for (i, ) in enumerate#}except TypeErrorf/keyfunc = lambdam": TA.get[0], 0),$#[0 s.S(key=Qo) # -! module manipulation6ispackage(path'"""Guess whether a a refer7 directory.""".`if os.1h.isdirZPor exx ('.py', #c'~$ HTfile(WAjoinV_init__' +V)EI.ATrueRFalsesource_synopsis(nIpline = .(p`while [:1] == '#' or nots.strip(J-N%if<q: break6S!ifg2[:4~ar"""':}zine[1:]+3+*xZ232a2-1:7+\\`2:-1a/$kPr&.split('I)[0]Selse:"! =I , cache={}e9Aone-summary out of ad @mtim?qos.statYbQ).st_lastupdate,)S60, (`, >T1 < ka# Look0bin suffixes first, falling back"!if&.endswith(tuple(importlib.machinery.BYTECODE_SUFFIXESloader_cls = BSlessFileL/</elEXTENSION_SUFFIXES)):   loader_cls = importlib.machinery.ExtensionFileL. @Uelse: OENone # Now handle the choice.!7if >0is ? ^# Must be a source filD:try6' = tokenize.open(Uname)+except OSErrorK# module can'Med, so skip itQUareturn c# textRsSdirectly examined4Awithresult =_synopsisZcbinary, which has to%&ed' =('__temp__',l# XXX We probably doU@needoqpass in0b;herIspecPutil.`_from__location,`=cAm=m_bootstrap._H( KXdel sys.n&s[]1) .__doc__.splitlines()[0] if" D b# CachX#c[] = (mtime, *&@ clqDuringI!(EBion)1"""%s that occurredlPryingNs somethdocument it."""def __init__(self, exc_info|#.% =M!Qexc, +Svalue Etb =T 23str~j exE`exc.__N!__7iA'O0lem;%s - %s: %s' % 0) *S(path2""" a Pythonh or compiledgiven its E_@magienMAGIC_NUMBER\, 'rb') as]is_bytecode = ].read(len()f8a = os.@basej&N'1extO!+7if )er_external.SFlessc(^,8doZ$Voader(name, 4path) # XXX We probably don't need to pass in the loader here. =spec = importlib.util. _from_file_location(name, {,K=RAtry:ZgreturnZ_bootstrap._6(f9gexcept<aise ErrorDuringI(z sys.exc_info()) def safe&Pforceh=0, cache={})d2"""R a module; handle eu3s; qNone if=*0 is^qfound. I Q*is*  but an ion occurs, it's wrapped!anI ;pand rerd. Unlike __0__,aGqpackage@ is ihified,!atRend o_01ed,N"no)V8beginning.  op&Eal '}' argumentLis 1, we rWo disk (unle% a dynamic extension)."""O q#f 1 5dhas been previously d T#always haveM . Checking1''sJSmtime5good enough (e.g.3could contain a clasIthat inherits another "changed)6if  n Ms."if@i(builtin_0_ 59`# Remo/$he^k2re-Y5try5F#'Qavoidlems with partials@# Also rsany sub. because1y w6/arBH# Anpred whiaTxecut/#ed) cgImport(sys.modules[path].__file__, info)  elif exc is SyntaxError:!(8# A occurred before we could execute the .Iaraise bDuringImport(value.Onameissubclass(exc, :Kb) and D@@ == sNo such1 in* eturn NoneLelsePSome other e5d_iing processl, sys.exc_"()for part&.split('.')[1:]Dtry:= getattr(,CQexcept AttributeX;: r D_ # -  formatter base ! a Doc: vPYTHONDOCS = os.environ.get("!",."https://docs.python.org/%d.%d/library"H%qversionR[:2]) def document(self, object, =N, *args)"""Generate>Pation%3 anD6.""CH = (_@) + p# 'try']0use0to umpt to handlpossibility thaYWspectLidentifies somethsin a wa5pydoc itP has "esiGing;O@k 'super'`how ita descriptor (which 7sO7ionOpby lack@a __o __an instance#I? if&2.ish)C.docFED routineF H-  Epass Fdata{'(x')#$m-Ofail)R+ an%ep%punimplexed types/message = "don't know q%tothQ%s ofD %s" % (Z' ' + repr(!),4$.`B TypZ(<M =  H property = fail def 2getdocloc(self, object, basedir=sysconfig.get_path('stdlib')): #"""Return the location of module docs or None""" 8V tryGfile = inspectw0abs();except TypeErrorH'(built-in)'v = os.environj("PYTHONDOCS", .)@A.normcase(if (isinstance, type(os)) and# .__name__ 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"%s/%s" % (.rstrip("/")r.lower()@MJelseO*Y + ".html"c_E! =r_ # -P HTMLSRument!generator class$PRepr(aA"""Cfor safely making an2u represWof a Pyth.u4ef __init__et. maxlist =amaxtup-20*0dic*1'ngFother = 100ddef escapeg, textreplace(@, '&P& <1< > Cgt;'b6`2b(1Ex, levelGif hasattr(Tx), '')`method@ = 'Z_' + '_'.B,\split,s&, W ptJ1get 2(3+.Pcram(@pid(C(x))A1max)z_0/ng<1 = \xM7's! =(pif '\\'D and '\\' not in replace(testrepr, r'\\', ''): !# Backslashes are only literal in the string and#[neverG%needed to make any special characters, so show a rawX.Kreturn 'r' + [0] + self.escap)"GCre.sub(r'((\\[\\abfnrtv\'"]|\\[0-9]..|\\xu....)+)',H( r'\1: 1)) h `_str =r 2ing2definstance(J, x, level:try13Pcram(@pid(xR(x)),V0maxAng))oexceptWT'<%s >' % x.__class__.__name__|unicode3 HTMLDoc(Doc"""Formatter %1for) documentation.""":?# -JfcutilitiesM_,_! =0RRepr(,: = '.K!c4pagtitle, contents 1 an 7'''\ <6><>Python: %s''j(*OP3ing3(fZ,a, extras=a[ Hc
(`
%s No Differences Found) R#toP[ +5 = ?/['Empty File## va on first 3:[0]r/[0 D0">ffR# red[lt5top0v/y dtop">t{(|%) Ntreturn i,g,,n "id;def make_table(self,D1nesEdesc='',to $1xt=,$numlines=5)rA"""Rqs HTML z of side bycomparison withhighlightsiArgumentsdzA -- @of ""((9nes(,to&:'G file column header string *3R1Q2!se|BTrue`xtual D(defaults~which shows ful<%).+y`numberHt. Whenh& 6Vrols IA displayed before and aftery r,cR gvto placI)"k anchors (so click of%HDAjumpwHjustJv_6"""#o` uniqu @es s@at multiples may exis#same page(out conflict. self._make_prefix() # change tabs to spaces before it gets m difficult after we insertNemarkupfromlines,to# =ptab_new_replace(. `reate s iterator which genes side byQ/to dataif context:_bs = nu%Oelse3 ENone/@= _m ,q,wRjunk=,PGchar/ 2fset up,to wrap \ s that exceed desired widthr#if6jcolumn+_+Aper( acollecand flags into lists (also format the)C*Y0st,Aaotprocess@$s,Iing middle  of next anchors/links,4R_href 'idanvert_y(J2,`%[]Gpfmt = 'N
%s
 
%s" facePlvetica, arial"4%s ''' % (}0, f, title) $if prelude:result = +Nq
a WP>#,  R or ''30sec -,6prelude='', marginalia=None, gap=z with a'ifZ@ is ]Nz = '{" *` + '{"100%%" cellspacing=0 cellpadd2 border=0 summary="section">
\n+=9'&&Q!'< kQ">%s' % (59x0.__y"__p, class(nP, mod)t+ n0def=ulelink(self,)"""Make a &c for a7A."""Ju  )0pkgtmodpkginfo or package to display in an indexD, path, is9, shadowed =%if!2T`.grey(_!ifj 4url = '%s.$ ?Oelse<]92 9@textvq%s' % (url, escape(all))) Jelif pep:"url = 'http://www.python.org/dev/peps`-%04d/mzint(pepbL9~selfdot# Create a link for methods like ';.m(...)'# and use GattributeJC if text[end:end+1] == '('A' + @name( , GOelsea)f   , funcs, classes_Ohere = end L!.':]return ''.join(;!) M?# - type-specific routinesM0defpmZ0ee(A, tree, mod, parent=None)"""Produce HTMLF" a^A as given by inQt.get1ba()."""PQ@entrAU3Aype(#A) is7(()(c, bases5tryx + '
C>#= WXcZ =#ifB!= (,5-[]!FM2 in_ F#L.EF '(]3', d_) + 'A@\n\n 4forVu6, c4%s' %JC.joi[:i+1]), J[i]) edgb = '.'7# +1F-1:]2@head,Rastrong !()s">Module Referencew locals|Oelse^dresult:ings3, 'V#7799ee',.">indexj+%) >m.smembersG,"is/@ clps, cdice[], {}`ykey, valuehW xS# if B# exists, believe it. Otherwise use old heuristic.0@if (9 or#'()(C) or)R A`isible( Dall,=26$esU7y)|r[key] =[/ '#5keyq '1basvalue.__baseks__: key, modname = base.__4__,module__>r = sys. cs.get(R)2%ifn0!= h@ and1ule phasattrCule, key)mif get-1 is590notZ in cdict-1#r[key] =0[* + '.html#' +Zfuncs, ff = [], {} or.p, valuepinspectGmembers(object, isroutine0# if __all__ exists, believe it. Otherwise use old heuristic. pif (allL+uNone or'isbuiltin(E) orAgetmA2is Uif visible(Oall,26d.append(5/<'#-$%if ish4tio:[l Y*AdatafsA )%E 0docelf.markup(getdoc~@), spreformat,iH'%s' % docrresult = Q+ '\n./4if ?, '__path__'"zmodpkgsy}importerp, ispkg~pkgutil.iter_.m lWpc,_F, 0)'6Zsort(pcontentwmulticolumn{JlinkBU^IabigsecZ'Package C~a', '#f aa55cc', s"elJulesM,^ s, lambda t:w[(t[1]I!Msf if class0lis  h\<]Pt[oTtree(1getM ~B, 1)r)d for key, value in classes: contents.append(self.document(@, key, name, fdict, c)))Oresult = !+ Mbigsection(/"'Ca', '#f `ee77aa '.join(t{if func)Y = []q2for?Cd1Fun/s @aa77 Jdata>7 1Dat`55aa55o
\n hasattr(obje'__author__')markup(s>.<"),preformat/A7799ee', i?if credits#=@CcreturnD qdef doc$, =None, mod D={}, J*ignored"""Produce HTMLv a AaTE."""Y@real$ = __%__#! =KD or 2 Xbases@"__ epush =06# Cute littleto pump out a horizontal rule between %s.% H0JRuleU__init__bnneedone = 0_A_maybe>"ifA BA(' 22hr.   dl>
Method resolution order:
\n') for base in mro:(push('
%smsgl name, kind, homecls, valukT>try>P= get(P , k2except E?ion\# Some descriptors may meet a failurtheir __get__.Cr# (bug #1785*Cbdocdata([, mod#5Oelse W]umentXqfuncs, es, mdict, }'breturn}"< =}" =docother(BAdoc J2docif not doco '
! %rY  `markup,preformat/ j"' %[6SE@?1attrs = [(name, kind, cls, value) ofor na- in classify_ _attrs(objectLif visibleR(c, obj=2%] mdict = {}4keyFhome~:0G[key] = anchor = '#' +P + '- 9key9:tryJN$` = getl,J except E>ionL# Some descriptors may meet a failuretheir __get__.# (bug #1785Ipass3R# Thenot be hashable (e.g., a data Y withYn##ror listS)O OATypeErrorA4Qwhiles+jif mroAthis =!.popleft(DOelse< us[0][2]`, inherited = _split_(lambda t: t[2] is ) P if*0ect%uiltins.=F and=%b!& = ucontinueJelifja0tagndefined here'K_7;from %s' % self.Ulink(.,X.__module__+= ':
\n'AsortdibutesT # Pump out th, segrega%!by 2spill('MethodsBtag, h1] == 'mG' kC *q.Mw cStatic+x.sNy ("Readonly propertieO" % r}r^y 'D lambda t: t[1] == 'data descriptor') attrs = spill+0('D1and other "ibutes %s' % tag,)s,KV l RssertR)[]Winherited pcontent''.join()&pif name[@real :Ctitle = 'class %s(EI[$, eiOelsesU`? = !x ~if bases3par; p1for01 in 8<.append(self./Plink(m, object.__module__)Dup+ '(%s)W3', g@decl'{:trysignatur@insp(except (ValueError, Typ )ZENone5if b 30arg`5tr(% 4if (v z!= '()'Q01 + }sescape(;) + '\n\n'doc = getdoc0if U k2@ + (Gor '=`markup%,preformat, funcs, es, mdictF@' %s4(anchor,Pif cl andBgetattr_static(clIP, [])gR O9
\n2YRdoc =nmarkup8dgetdoc,-preformat,Y1s, 3es,s) `doc =  and '
%s
' %!' `return0Bl>\n4`(decl,;!) =0defdata(self, object, name=None, mod !cl !):=}"""Produce htmlMumentation for a ^ descriptor."""@results = []spush = r.appendt!if4B('q:`bigsec(T1'#f', '#ee77aa','po) # -[ textKgor class TextRA"""CLsafely making aU%%essof a Python__init__@das.!maxlist *xtuple = 20*0dic*10strF"001, x, levelif hasattr(type(x), '__87__')`method{Zs_' + '_\B.@{.split(s&, W ptZ1get 2(; return cram(stripid(repr(x)), self.maxother) def "_/0ng($, x, level):%)test = cram(xL7)'P! =W(7if '\\' in B and0notqreplace6F0, r0G, ''# Backslashes are only literalLBthe g#UneverG%needed to make any special characters, so show a rawX.Kreturn 'r' +3[0]:6 E 2inginstance&rym&ngoexceptJT'<%s >' % x.__class__.__name__  TextDoc(Doc"""Formatter % for text documentation."""?# -Jfcing utilitiesM_j! =R1: = '.@Cboldo# a20 by overkAking3''.join(ch + '\bW0ch  chIngindent, prefix='VAA"""I.  by*@pend#pa given0fixeach line0if %: 0Rs = [! +B.split('\n')]=!if."s:f[-1] = .9"p(#\n6ds0secHitle, contents4d with 0hea' dclean_N" =j)t. (t)n YBn\n' --- type-fic routin ($reTtree, mod, parent=None\ XdRender# aJ3 as( ed inQt.get$)()YPresulw%''Qentrye:ree!if(#B) is'()2pc, base/d ++%(c#=#ifblB!= (J,5( fEcRv result = + '(%s)' % ', '.join(parents) >9\n''elif type(entry) isI[]):*\Qself.formattree(37[ , modname, c, prefix + '!'creturn Odef docmodule(r, object, QQ=None_ """Produce textFumentation for a given3uleWA."""zb$ = __ __ # ignore the passed-in; synop, desc = splitdoc(ge)@.secr('NAME'A + (U and ' - ' + Hall = get(g, '__all__', 0wQdoclo3loc9(i+ais notG $ MODULE REFERENC~ + t The followingis automatically generated fromPython source files. It may be incomplete, rrect or lude features that are considered i;@adetail_0vardctween 2When in doubt,^Fm reference atB loc0lisabove. """)!?escDESCRIPTION'R cles = []4key, valuP inspect.getmembers:b!isLS# if # exists, believe it. Otherwise use old heuristic.K@if ( $Hor (m()( LDif visible( 4all 2es.append(7y^Ofuncl3{routinenK= orqmisbuiltinm5 #isj H~#Y| Odata)sA E.append((key, value)) modpkgs = []P_nameUset()if hasattr(object, '__path__'):(bfor importer, modS, ispkg in pkgutil.iter_modulesV.T SWS.add(['"ifn Ie.appenF + ' (package)'UOelseQqv8sorYresult = + self.section(]0'PACKAGE CONTENTS', '\n'.join# Detect subq as someticreated by C extensionsz8 5`key, vdinspect.getmember$, "is "ifF!.___.startswith(C.') and key notr5s6key'if >:1SUBMODULEfif classe0lis.[u%&es5pcontent[_@form.eeb1getMQtree( |`, 1), )d Ydocument(,h=(1k'CLASSh fLfuncd* ?mBFUNCTIONHs Jdata~) >(B ]other, maxlen=70)IDATAy 0verE = s3.__*__J[:11] == '$'@Revib1: 'AD[-1:' w9%3 = [11:-1].stripo- VERSION',Mif hasattr(object, '__date__'): result = + self.section('DATE', str(object.J%))Iif hasat%qoauthorslAUTHORuNwcreditsx|CREDITSyPz:tryGfile = insp$`getabs6,except TypeErrorH'(built-in)'f0FILvocreturn Ldef docclass(", , name=None, mod *ignored:"""Produce textO`umenta5 for a given f`A."""@realo$ = __%__#! =D or 2 Xbases@"__e@makeJb(c, m=.__module__206)R"if= 1tit 'C3 ' RTbold(OelseA.6s) + ' =PVL1if  O`parent'Dmap( ,++ '(%s)' % ', '.join(NCconta%[]@pushv.appendG AsignaturFER(ValuG,R F0 = 5if  40arg! =% .4if (5and z!= '()'Q^(% +-g+ '\n'Ndoc = getdoci ZV6 K# List the mro, on-trivial.mro = deque(4mroif len(mro) > 2p"Methodq1oluvorder:"F$0 in J!' (4 *FHA sub!es 'aneorted( c(Dcls.)0clsvtype.__F$__; F(t I.startswith("_") L!Q == "iins"),Tkey=str.lower) no_of_subclasses = len(3) MAX_SUBCLASSES_TO_DISPLAY = 4&6if =:Dpush("Built-in'"f)5forYname ./[:]qLu' 9' +V tjif no_ /> ji ... and ' +Mstr(m-m)If' othe-:es'5') # Cute little ! to pump out a horizontal rule between sections.L>H0JRuledef __init__(self) .needone = 0_A_maybe>p4elfA_Fz-' * 70" 1Zhr = (L spill(msg, attrs, predicate#ok# = _split_list(7^if ok2hr.>msgXP, kind, homecls, valufk>try>P= get(object, k2except E?ion\ # Some descriptors may meeafailurtheir __get__n# (bug #1785.Cdocdata(o, mod)=;elsO WSumentX .S", f breturnG m< ok:  doc = getdoc(value)  Otry:"2objEattr(object, namMexcept AttributeError_ homecls.__dict__[`]push(self.docothe , mod, maxlen=70, doc=doc) +MZ '\n'preturn %s 9P = [(, kind, cls, ]1for+- in classify_ _`b if visibleBobj=&)]Rwhile zjif mro]Athis =!.popleft(Oelse< Z[0][2 , inherited = _split_list(lambda t: t[2] is )2if %not builtins.6and=% !& =qcontinueJelifjatag = "defined here"K_7;from %s" %A),S.__module__rAsorts7 ,# Pump out th, segrega!by=.spill("Methods %s:\nBtag, D1] == 'mJ  nC *t1MPz oStatic{8sQ| descriptors("Readonly propertieirayWData  d^ Qata("`}!)'Raassertls[_ attrs = inherited contents = '\n'.join()'tif not :Greturn 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 funcor method alu$ = __%__! =b or re2 0ote'pskipdoc0if _is_bound_yE`imclas=80.__Q__.__0Jf clCJ"isx&*n` from g(C6Oelsev  ~0J of %s instance' % O9 v,8!un Bmod)>if (inspect.isco= or7asyncgen6l'qualifier " 4'5 == ={Tbold(ti@ andgetattr_static(cl,qP, [])5 ^1D% +d70arg0 =   :trypignaturHsH2except (VError, Type 0N5if Estr()G''T3 :1b# XXX #'s won't usually haveP_anno/Rons[')']EQ0sinhe syntax doesWsupport but itgpossible.KSo removing parentheses isn't truly safe. argspec = [1:-1] # remove parenthesesAdif not2:`G = '(...)'@declhsyncqualifier + title +O +]%e 8if skipdocskqreturn XV+ '\nlJelse- dogetdoc(object) or '5T@ + (=and self.indent).rstrip() )def docdata(3", q, name=None, mod !cl )"""Produce textMumentation for a ^ descriptor."""3results = []spush = r.append+am64`.bold(%))R7"|./= k i!J/bV# m''.join(ocproperty =F5Qother , maxlen 1doc ! Bpr =kDreprv#if ?qline =  SKTcchop =Sp - len(L z1if )P< 0: DJ@pr[:]h6...LB E1o [U!+=" +V1strTHS; class _PlainTextDoc(b"""Sub(3of  which overrides *ng styling ,W_ # -% user interfaces x`pager(]s"""The first time thiJ called, determjwhat kind of J0 tohbglobal\& (c 2getqDecide ucmethodn paging throughEJhasattr(sys.stdin, "i#y"fppC?outD.}(M5out Ause_ = os.environ.get('MANPAGER') or os.environ.get(' if use_pager:.sys.platform == 'win32': # pipes completely broken in WindowsIM return lambda text: tempfilexp(plain(&),)FMelif`TERM')u('dumb', 'emacs')|/seP %; ?if  u'more <'t if hasattr(os, 'system') and('(less) 2>/dev/null'),01 }-'G1') eimport!P(fd, /uname) =0.mk"p(os.close(fd6try x"%s"' %v'= d NW4/elO6ttygfinallos.unlink(a def ;"""Remove boldface atting fromA."""\re.sub('.\I!',&)e#ip3cmdd"""Page through5 by feedpit to another program|subproces8 6 = .Popen(cmd, shell=True, stdin=(?IPEwith io.TextIOWrapper(g.C , errors='backslashreplaces] Xb.write_ except KeyboardInterruptX*# We've hereby abandoned whatever n't been uIten,rLbut the \ is still6control of!@termv.E#pa0OSE/!` # IgnE s caused2quir`while Y gCwaitQbreakGl ctl-c lik*tself does. O9wis"q# left runn*W{in raw modeJunusablesNw /, {h text by invoking a program on a temporary file.""" it ename =0.mkA!()!with open(+, 'w', errors='backslashreplace') asy:Az;.write(textZ6try"os.system(cmd + ' "' +GR+ '"'8jfinall<eunlink) def _escape_stdout{s1# E non-encodable characters to avoid ea later= getattr(sys.n4, ' ', None) or 'utf-8'@preturn .,!e(_ing, Xf.decod%ttypager"""Page throughdx rmFlines = plain(8).split('\n \!tyCd = 0in.#noV ol!dtty.tc@"fd setcbreak(0get = lambda:gbread(1Fexcept (IE, Attribute io.UnsupportedOperation))! = P()[:-1][:1] 9 1 fh = int(os.environ.get('LINES', 0),BValuK0sif h <= 1%%25&rc = h - 13out`.join(s[:inc])vbwhile #:r:]|U-- more --^D+WflushA"()gif c in ('q', 'Q' ^0'\r+\r&elk \rl  (m$ +1]PA7r +continuebBO\x1b [a- inc  Jcif r < 0: ,cn 0Or:r+3FX2inc Wif tt6+3tcs0fd,#.TCSAFLUSH, old.0 Simply print unformatted< . This is the ultimate fallI pRdescribe(thingroduce a short (ption of the given thing.""" if inspect.ismodule("!): $ .__name__ in sys.builtin_8s7;return '*B-in +C ' +Tnrhasattr, '__path__'^packageV Oelse "in function Vgetsetdescripto_) *A %s.U' % (Bobjclass__._%_,| ,H) fmember)|K!NomethodLJ4typ def locate(S, forceload=0rA"""L" an object by  or dotted >importing as necessary]parts = [ k !in?.split('.') if]`, n = None, 0while n < len(KsBnext:r = safe`C.joi1w[:n+1])B6if E:1+ 15Ya break#if9nE='7 E"bs1foroF[n:]W6try F1get@W,Eexcept AttributeErrorJD}P_ # - interactive bpreter face text = TextDoc() pla7 _P html = HTML-cresolvGAor a6 to, get theqand itssinstancv7str+$ =n$ifl!is aaise Ii ('''\ No Python documentaqQfoundk%r. Use help() to get the interactive help utility. Us(str) for !on8 str class.''' % thing) return object,Qelse: *name = getattr(EP, '____', NoneW(% if isinstance(!, j? def render_docgtitle='Python Library Documentation: %s',ceload=0,Q1er=A"""Rhx text dL, given a or a path toA."""eiQer isf:~! =k1n = resolve2forOpdesc = Rribe(=Pmodulinspect.getm '1if kand '.' in]A += 1' + [:5.rfind('.')]Relif e Q cis notIZ+a .A [Dot ("is'1 or(X*)eroutinHT @dataoriptor]@_get)A# Ifcpassed&a piece of gd$n # its available methods30eadI!evalue.'aif hasorigin__'Q## =4.__*Q 55typW0"D_a'{! % + '\n\n"9.,)-veH&'koutput$qDisplayq%6try72if p 0bpager( )3o.writeLP, plae#xtWexcept (ImportError, bDuringQ) as uaprint(#=0@"""WZ HTMLlv@ filNcurrent directory gn1hFy = html. (v,with open.T ', 'w', encoding='utf-8'DC file.write(page) print('wrote', name + '.html''except (ImportError, bDuring) as value:]) def wdocs(dir, pkgpath='', done=None)A@"""W.0 out HTML documentation for all modules in a directory tree."""!if_@ is b:A= {}Ki0er,Qp, ispkgX pkgutil.walk_packages([dir]W@(modJGreturn class Helper: # These dicaries map a topicto either an alias, c tupleI (label, seealso-items). b! ""Athe @ of correspondingM!se# .rst file under Doc/ andindex intoNyKin pydoc_data/Rs.py. CAUTION: if you change one $, be sure to adapt}M@list@bneeded/tools/extensions/pyspecific.py Oregeneratem%vby runnOBmake=- h&inaqcopyingqSoutpupFLib/.Wkeywords = {^|'False': '', =Tru(__peg_parser__20andxBOOLEAN` asJwithsert': ('as W, '')Sasync! 3waiA Qbreak@ P, 'wh9fori) , 'CLASSES SPECIALMETHODS6Qontin'4('c e1defc1funY'1del!, 'BASICx0eliJ8'ifOe!(' 8try@finally!or61, 'L  R @fromGUdRgloba , 'nonlocal NAMESPACEg( 'TRUTHVALUEskL , 'MODULMn in~SEQUENCEeiCOMPARISOalambdaI p, 'FUNC - 2, ' no'L0pas!(' \ 'raise': ('raise', 'EXCEPTIONS'), r'return+ ~, 'FUNC+1try(QBwhil{ , 'break continue if TRUTHVALUEAwithc , 'CONTEXTMANAGERS i yield> 4, ' }# Either add symbols to this dictionary ore%I&directly: Whichever is easier. They are merged later.<_strprefixes = [p + q for p in ('bfr1u')q"'", '"')]M_inverse = {'STRINGS' : (93"''@Eh""', *OPERATOR? '+-*/ /% << >>&&'f '|!^~6 =>=!$<>G'COMPARISON'ARUNARY<~_AUGMENTEDASSIGN ,+-*/%&/|=!'^,!<<>*S)/=rBITWISE b K#2LEX6jV1J')  1U%': ' FORMATTING0'**&XPOWER,TUPLES LISTS F  '.'ATTRIBUTES FLOAT MODU9xOBJECTSX!..3yELLIPSI:L@SLIC1 DIARYLITERAL,@,def classa \\,_PRIVATENAMEP_ SPECIALMETHOD-`JBACKQUOTH(71J CAL)'['~SUBSCRIPTS #]* *dtopic,__B{.items():;9%0 &s_ $YR.get( !, ,"if@ notV#sT(" =.s + ' ' +*m"s[]3 &HW`TYPES'hPtypes\> UNICODE NUMBSEQUENCES MAPP'Xzq` CLASS0 FIyinspecttstrings', 'str UNICODE SEQUENCES STRINGMETHODS ' 'FORMATTING TYPES'),)'B': ('string-methods', $&S I C@bformatF?OPERATORywUNICODEs-encodings unicode:qNUMBERSuanumberuINTEGER FLOAT COMPLEX-(?Sinteg@int rangeN,floatingM Y math-u/imaginary0complex c35typesseq4 Z LISTpMAPPING'DICTIONARIES'*1FUN%!('ofunctionE?def3X`class 8CLASSES@$bOBJECTx`bltin-q-object|%Eile JJJs>VFRAME?'N TRACEBACK2NONCnullw pELLIPSIH"('/ellipsis3ASLIC PECIALATTRIBUTEDspecialatt n{SN PRIVATENAMDSMODULl@amoduleiimportraPACKAG0'gEXPRESSIONoperator-summlambda or and not in is BOOLEAN 'hARISON BITWISE SHIFhBINARY0_POWERO U2p SUBSCRIPTS  CALLS TUPLE H8: ''>`PRECED'%'('Er #L2namTBASIC"@ 'DABLE.M ,customizahash repr str K O`ibute-acces)SO Ncallable-types', 'CALLS SPECIALMETHODS'), 'SEQUENCE: ('sequence-types', &+S 0% 'KR '{MAPPINGz %S hNUMBERHvnumeric#S AUGMENTEDASSIGN   EXECUTION'5execmodel0NAMESPACES DYNAMICFEATURES EXCEP6 2N`namingKglobal nonlocal @DELEJ d  ^ dy`c-featur 50SCOG': '7 FR qceptionN`try ex finally raiseCONVERSIONStconversD ,IDENTIFIER,identifierpkeywordsD/ 'id-class(qPRIVATE$[atom- rLITERAL.qliteralSTRINGS TTUPLE3U'LIST%0DIC4ARY R~'9exprlist%S !>Y!('7seq-mutable7qm3l'IEsCmapp6!{@dict/IEATTRIBUTattribute-refer=00getA hass?ISUBSCRIPTvsubscri?  @SLICBqslicing5 3CAL2calbEXPRES~QPOWER]Ppower-+QUNARY+_unary+ %BI,/bi- SHIFTING[SshiftqBITWISE0@bitwj?, '/COMPARIScomparis6o BASICbBOOLEAbboolea=TRUTHVALUEPASSER\u(rtassignmenIGNMENT'),  'AUGMENTEDASSIGN ': ('augassign', 'NUMBERMETHODS'), = 'DELETION': 'del'RETURNINGhreturncIMPORThimportPCONDIZ AL@(ifBLOOP:('compound for while break continueTRUTHVALUEPtruth=#if<and or not BASICDBUGGdebuggerG9pdboCONTEXTMANAGERStext-managers8Dwith9!} bdef __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 Ccall , request=9 #$1 is i)c.help(:5Oelse-Sintrogi.write(''' You are now leaving  to the Python b preter. If you want to ask Eon a particular oZ directly fromY R,Ocan type "I(9)". Execut'string')" hasN same effect  yp/ 51 at1d> prompt. '''1actl P6\n';Tru:try" =getline('V-!ifX8:~R"except (Keyboardrupt, EOFError2 Hc$ =.<#p(#5# Make sure Aific@rail1quomarks of liuls don'tt# get deleted$PcleanI& /uif (len;C > 2![0[-1] in ("'", '"^@$ino[1:-1]@d.st[1:-1]  if request.lower() in ('q', 'quit'): break 37 == 'help':"&self.intro()Oelse/K(!) 6def getline(S, prompt)C"""Read one (, using input() when appropriate."""\0if W.- is sys.stdina(creturnTEToutput.write(4U&[flush+u'P.read(6$,uif typeV'''&x$ =Fk.strip keywords':GDlist :+el<isymbol;: Ytopic98 imodule9:A[:8]+ $o.split()[1] "in=KBshowNC `['TrueAFals jNone']# special case these Q sincy are objects tooEdoc(eval, 'Help on %s:' .wS u E80sA :  ", =_ "seC?str?isinstanc , =2er)b'G'\n'D'.6 '' Welcome to Python {0}'s  utility! If thispyour first time=, you should definitely check the tutor on Internet at https://docs.p.org/{0}/8P/. E4>name of any ,Q, or P2get0on Bing grams andRps. To F5 !toipreter, ju+Pype "A`". To0 a fvailableq2s, 8ss, type "modules", "keyword `symbol Jor "topics". Each module also comes with a one-line summary of what it does; to list theGs whose name or;contain a given string such as "spam", type "m!s (. '''.format('%d.%d' % sys.version_info[:2])) def (self, items, columns=4, width=80):04%# =8aorted(%))$bcolw =>4 //R rows = (len<$ +%_ - 1)5for row in range(F$6col$ '+0i =s *U0s +!vif i < ?.output.write6[i],!if{<kZ.^`' ' + 1* (mV- 1 -zF;\n'  5'' Here is a the Python K>nter anyget more help. -p.L\keys()punctuation Od which`assignjecial meaning to. E;6s%available H :Ashow,u,_xrefs=''V:tryimport pydoc_data.Nsexcept I(ZErrorA8 ''' SorryE anddocumentvis not 4pbecause k- "q" could;be foundereturn0tar!= Q.get( ,!ifsI:no  0@%s\n)Breprf!if~(z)(873qlabel, ,2 = ,5 0^doc =/6[N]?except KeyError7: 4self.output.write('no documentation found for %s\n' % repr(topic)) Nu returnbPdoc =N.strip() + '\n'!if more_xrefsB = ( Qor ''@G ' +6L+ Gimport textwrap. = 'Related help !s:f', '.join.split()M^Cped_U.(J, 72. +=Yq7O6pager(doc) def _get(,,"F='')A"""R unbuffered tuple of !, J").fIf an error occurs here, the excep, is caught and displayed byJ1url handlerdThis funcKduplicatesdAshow method butpUs its` result directly so it can be0mat0 inPhtml b.L5""" 6tryF[pydoc_data.! IE; A.(''' Sorry;pkeyword= is not available because" module "q" could;und. ''' ,Uarget = ID.gets)!ifetI aise Value &('Bfind'Lisinstance(SW, strF 0_ZSlabel2 = +-= E[=].93doccsymbol  "s[3, _a`.partix7(' }9 Qlistm~s:keyw[if keA] }'' Here is a W[ whose name or summary contains '{}'. If @re any, enter a G@0to  . .format(keyeqaproposJelsePlease wait[ while I gath7all2s..U = {}3callback(path, modname, desc, modules=K):  if%name and [-9:] == '.__init__'<K1mod==;:-9] + ' (package)'v.find('.') < 0d[lY] = 1Sdef onerror(%callback(None , )PM7Scanner().run(>,j=r ;self.list.keys()& output.write(''' Enter anyL@ule  to get more help. Or, type "mps spam"+search forEcs whosLor summary contain the string "F. ''') lp = Help class p"""An iruptible s=b that #es synopses.""" zf?&, l@key=, completer~pif key: =A.lowc.quit = Falseren = {}Hin sys.builtin_{_s1T!= '__mainBOseenLakey is h /  OelseF = __import__).__doc__ or '_o! =.split('\n')[0]^'W 3.Q- ' +2"if]7key) >=8n)'erispkg in pkgutil.walk_$s({5if lsVbreak1  >trywespec =P_get_( <except SyntaxEd# raised by tests Zpbad cod|pcookiesc?BOM6inuloader = . Bif hasattr("1, 'kource'W5s;2 = Q.O; 85E<?ion3*i$(or(modname)  continue desc = source_synopsis(io.StringIO()) or ''Fif hasattr(loader, 'get_filename'):8rpath = 8.6@(mod>)<OelseV>Non:?trySmodule = importlib._bootstrap.__(specqxcept I<_Errorjoif one$ ;%( )m .__doc__.splitlines()[0] if " G1get:1,'_@__',) =i + ' - ' +  0if '.lower().find(key) >= 0_callback(,j,a%) cif complete() def aproposyt"""Print all the-Koule summaries that ain a substwA."""b s[-9:] == '.__init__'(,Zl`[:-9] q(package)pf,f and ' yApasswith warnings.catch_(+t.filter('ignore') # problems du@nMQScann+Drun(W`, key,r=o) # - enhanced Web browser interface(_start_server(urlhandl+@host , X@"""S1 an HTTP 9 thread o/qpecific8.5zML/text:, so HTMLdocuments can b0d dynami+yactively a`. Exa: u3>>>B timeRpydocDefine a URL -p. To dmw@cclient is askingxfor, checkLtent_type:tThen getgenerate some +"or;Acodereturn itD smy_url_,ww0...e0= 'swas: (%s, %s)' % Knt_type)  0... return text  Start server thread on port 0.'If you useT, the8will pick a random&fnumberFpYou can;nLxw.t`to get" C2>>>9= 0L = pydoc._s_(my_url_handler,H) Check tha5 is really L ed. If it is, open browser1andfirst page. Us0aurl asZ2ing,#ifg7Eing:n!imA4web"The next two lines are commented out so a doesn't%ifJ`doctes@ run*this module.#.*(#erEurl)ZV#TrueAL1` do it, ing. We just need to monitor#fstatustwtime.sleepEloop1hog7CPU|>0 = .monotonic()E4= 1Z#secondsT7pis a shlA@for b {urposesKwhilK&F(.01 ] " -! >[=outGstop1}*VbreakPrint any errorat may have occurredp6 ]?@Nonel0""" .Rhttp.email.messag70hselect+2ingclass DocHe(b.BaseHTTPRequest#"):;def do_GET(self)^"""Proces8rE from an HTML8URL received0in bV.path.. GePb-3url="zsend it?bKc"lfiendswith('.css'/content_type = '/,u"Jelse<Yhtml'=_response(200,K$header('C-Type', '%s; charset=UTF-8' % QBend_Pspwfile.write.p(2,v.encode('utf-8')) def log_message(self, *args):&-p# Don't. .)s."BpassZclass DocServer(http.s R.HTTP"):.^__init__host, port, callback.(0 =  address = V-U)-f% =q%[base.k!, handlerfquit = False"p_until_& while notg' Nrd, wr, ex =(ect.select([socket.fileno()], [1N^if rdeM_request(A"r_close(~ractivat Dx-  if$f.NcThread(tBing. 2url !r,j *6 = )p = int( z  ,k]5ing!error = Non2runJ """Start the _ier.""":try5s;.B I 8 =H/".MC= email.@ staticmethod. yPdocsvX4N yEJf0 = -vrk Rexcept Eion as eu AeadytITrue]Q$$R0er_+purl = '://%s:%d/' %x? 1top 'op and this | nicelyi? = KjoinZ# explicitly break a reference cycle:Server.callbaGck # has indirectly a reference to ServerThread.:self.docs"~ = None"ing = Fals!4url=>tl) ={ (urlhandler, hostname, port)6r.start(# Wait until V.ais Trumake sure we ar # really up before returningwhile not[error andp:wtime.sleep(.01ZH def _url_ , content_type="text/html")]"""The pydoc T= for use with t#Aer. !IfcQ is 'fQcss', _^.css styl+Psheet.#ed if it exitsijnoresult of@get_"P_page)ue1""",class _HTMLDoc(H"):dIu, titledsT)"""Format an M ;.n#css_path = "*f_data/6+/link = (!'<Qrel="lg'" css" href="%s">' %Fch\ '''\ <6>Pb: %s Ofbody bgcolor="#f0f0f8">%s ''' % ( , <,_navbar()% O& =n)b:version =[.escape("%s [%s, %s]"platform.python_7=(),V Jbuild()[0]K.compiler())fb !'float:left'>PDYbr>%s <XOrighY*-align:centerC Module I> 0  osearchqS Z%s'8,::heading =.($b'rstrong>2of 3s' +5Qbigse 8B4-in&f ee77aa', d&)]seen = {}4dirFpathFG.append(pPdir, S0j'

<Upydoc, by Ka-P;Yee;<ping@lfw.org>7nt>7 `t'.join(M_G(keyN2"""F resultsa# scanS_;xcallback(P, modg, descf$if[-9:] == '.__init__'0L% =7:-9] + ' (package)b 3(H and '- Dqwith warnings.catch_,'efilter''ignore') # problems duriimportVJtonerror =t6pasScanner().run(s, key, V=#1mat3D): return '%s' % (name, C) results = []heading = E.( <b'strong>Search RS#'.join()x ,4', 1def_topics()"""Index of  texts available."""FJ L!<U?key=%sA>,_INDEX#/sorted(Helper.s.keys()dmulticolumn'5s, +6+ T #Rd9#_keyword  ,$ZNK ; Qpage( #1"""FC or f` help . buf = io.StringIO(n6"= U(buf, buf$`, xref6Q._geti!ind title = 'KEYWORD'EOelse,VTOPIC*$61 % &A%s' % A!, G h = html.multicolumn,z 7section('Related help Ys: ',> 1'#f7', Wexq('%s %sbtitle,k)h''.join((heading,)wo_getobj(urlpobj = locate, forceload=10if *is None and url != ''raise ValueError('could not findLFect'` = describe(objdocument%,*IOeurl, exc Kg(b'qstrong>#.escape(line) 9 in { +mat_excep_only(type(>" +?4big 9 kbb0000 m"Q - %s" %s@get_A_pag"""Generat` HTML 'PE.""";complete_= if.endswith('.r'j8U[:-5]=:tryN in ("", "index"MQ _/(.*#elU2== "*s"u&PQ keywordS1U0'='>urlQop, _ `.parti7('=# p `search+7 P2To_$^R# trys first, then%s.Z 9vh' d html_getobj{(url) elif op == "get?key":&5# try objects first, then topics.6if url in ("", "index")cgtitle, content = html_7(2OelseP/ry?qogetobj46except ValueErrori!=OpagelWraise}('bad pydocs'-HEion as exc# Catch any es and display-m "an 7L(complete_url,}areturn+.U(H!) .startswith('/'=<D[1:]2P_type&'text/css'path_here = os..dirname(@real(__file__)@css_?Pjoin(X,0d open(:)&fp1''.Nfp.readlines(~xM@get__gS!# s outside handler are caught b r server2TypH('unknown~a%r forWx%s' % ($ ) def browse(port=0, *,0_r=True, hostp='local@"""S(tenhance^3Web0 a _.p@Use '0' to yQ Gn arbitrary-9Set?PFalse suppress"Sing aN2"""m~3web| th A = __(\_ ,#ifB.xbprint(N"= L76ingNer_help_msg = 'S7 commands: [b]r, [q]uit'\k$enX. *tCIjy at', DH7 #ZwhileG0 (cmd = input('&Jer>  cmd = cmd.lower() if cmd == 'q':.]break'el;b;webbrowser.open(serverthread.urlOelseSprintB_help_msgAexcept (KeyboardInterrupt, EOFError)YQBzfinally%9if :ing%&Ostopmr!'S %ped') # - command-line iface def ispath(x"return isinstance(x, str) and x.find(os.sep) >= 0F_get_revised_QQgiven s, argv0a"""Ensures current directory is on 0ed I,yB )Anot mEBion:i'Jleft alof it's also pydoc's'w.HRqs a new| entry list, or NLno adjustmis needed.1"""# Scripts may get then"irrby default ifCy'rePrun with -m switchCqly from ]C# Thactive promp)so allows importsM Accordingly,{y present, don't makany changes toEoif '' in os.curdirgetcwd()n# Otherwise, add O `remove41# sn (as long as' latter is:`tdlib_P= os..dirname(__file__u+M(' =XS.copyP 5not@same(@{.65.insert(0,m(S,QNote:e@test]ly cover  , _A_cliq itself+1sys ("sy(__main__I#ot+i% =ised_path(sys.path, sys.argv[0]) if revised_" is not None:!%6Y[:] =0 def cli()0"""Command-line interface (looks at to decide whatao)."""{import getoptclass BadUsage(Exception): pass %_adjust_cli_sys"()2tryopts, args =f.m((1:], 'bk:n:p:w'5=writing = Falsezstart_serveropen_brows5= 0Khostname = 'local'for opt, val in s if == '-b' 6Tru  $dkdapropos(val=YereturnPpPJ?val[w[ n;8if ? -($, B= (, = mitu: raiseV$`0arg[( is(arg) and8oiq.exists <print('file %r doeu50' % 6Ybreak # ~#7elsAh @<Phelp.9ei ErrorDuringI as~uSvalue|E(c .eM,w?dcmd = splitext(@baseHu0]))[0]|"""pydoc - the Python documenta8 tool {cmd} ...IPShow y 3on something. 6amay beiGQ of aGwkeyword, topic, func, module, or packag a dottedEreference#"a %orF0 wi# aNMmodule in a N package. If contains a '{sep}', it is used as the path to a Python source filedocument.^]E'keywords', 'topics', Eor 'modulea listing ofrse thingsEdisplayed. {cmd} -k NSearch for a 0 inK synopsis linesaall available ]pn B = 0U@def %):z'''Indicate that a formerly enXd>complete.YUsed by Qrs. For each@() u0to fetch a[,a subsequent callZv) tells?`procesM!on)?VIf a  currently blocking, it will! skhave been ed (mean{W)was receivejf/Bvery3had] utKn)@Rais ValueError ifned more timeAaqre werelplaced i# (5'''Bwith~ _#" =.5- 1U3itJ<= 0S$#'r,('roo many)')Fc .Ijy_all(1- =G@~1 Bvs untilpmuagotten}T?unt goes upe  VBGdownD sPFto i @trie51and`work o2Whe/coto zero, join() unblocks. 5''' with self.all_tasks_done:"5Rwhile'unfinished. )-N.wait() Udef qsize(*)A '''Return the approximate .1 ofqueue (not reliable!).Vmutexarb{".__emptyhTrue i1is 4, False otherwis(This method is likely to be removed at some point. Use5a) == 0JM as a direct substitute, butPaware that eiXach risk=EraceOcondition where a pcan grow befoR@sultU() orI[ 9be used.Po cre3codPneeds- for all!d bmpleted,preferred techniqQ uscPe joi{ <{@Ofull?3>YE>= n>Xoshrink@?20 <1maxK"<=1put, item, <=, timeout=NoneaPut an3Q into9PIf op[al args ']'tYSand 'ei ( default),< necessary until a free slotZPavail%I. If_Ka non-negative numbersGmost> se) s eraisesNFull exceoww i!atcOM,fiG), puo@e-ois immediatp0, e ( K0gnolVcase)@not_ "if:> 0!0if x"self._qsize() >= self.maxsize: raise Full#elif timeout is NonIRwhileq _qpR() >=not_full.wait() ?< 0ValueError("'' must be a non-negative number"rs0endV! =A() + =outu*remaining = x-o%n6if 8_<= 0.0-8d =*_put(itemunfinished_tasks += 1;Cempty.notify() %def get(%, block=True,@out=)" '''Remove and return an  from the queue.cIf optional args 'k' 2truM_  (Ldefault),N< if necessary untilis available. If [GB, its at most>rsecondssNEbQ exceo'wa within thati.G`OtherwG($|false),p`if oneEimmediatelyKr, else (  ignoredHVcase)5'''#i3oY .&*h}_>2notk L uHD/<($x u_ J eIput_nowait(self, istem): !'''Put an item into the queue without blocking. 9rOnly en(2@f a free slot is immediately available.Gtherwise raJFull exception,5'''8return self.put(~,r=False)def get_nowait(0 Remove and T Ofrom 'geG_f one$ O_EmptyAget( # Override se methods to implement oorganizavs # (e.g. stack or priority2)`# Thes.@ll obe calledB appropr Jbs held# InitializZ represent3_in, maxsize.= deque( _q/ 1len?6!# D newL{,%q.append]G2 m\\V.popleft__class_getQ__ = (types.GenericAlias) "# PQ({'''Varia5!f P that7rieves open entries in.order (lowest first)LE/are typi8`y tuplQfpform: (~number, data7'"[]^"6heappushZ$t?'op>ALifo0mos@centEdded.JJG<0pop%A_PyS I2''', unboun BFIFOThis pure PythonQ nog 2ant(Yw# Note: whil L`versio>ovides fairnesby using a threadSemaphoreW ch it fair, being bas>ed # on threading.Condition), fairness is not part of the API contract. JThis allows$pC versi` o use a different implementan!. def __init__(self):`._queue = deque()wcount =Semaphore(0)d1put_, item, block=True, timeout=Nonea'''Put46!e `The opAal 'Xs' and 'X`' argus are ignored, a5is methoQRnevers. They8provided for compatibility withQ-RclassQ;'''6pappend(Wp.releasu@$geHBaRemovereturn anQ from&IfPEargsUbis truM]0is  (default),N if necessary untilvailable. If%isGa non-negative numberM at most>rsecondsFaiseNEmpty exce=oTwas ai!atOtherwise (yis false), p`if oneimmediatelyo, else r ({iHVcase)!if0outg32F < 0ValueError("`must bl"2ot V8.acquire(% |\Lpopleft(ud_nowai4kbAintosQ%#xis exactly equivalf@to `k`}is only AI)p, !=F5`?'''" O6getT%. ; c ey  v4!, E& o*@reli8!).S1lenl5) == 0 def qsize(self):  '''Return the approximate .1 of queue (not reliable!).'''HrE1lenb!._3!) !__class_getitem__ = method(types.GenericAlias) if SimpleQ~ris NoneW= _Py. #! /usr/bin/env python3 """Conversions to/from quoted-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 except IRError<'! =1 def needsLbing(c,Wtabs, headerw"""Decide whether a particular byte ordinalTb to beP"d.SPThe 'meb' flag indicatesZembedded & and spaces should beId. Note that line-en =are always!3ed,!N%*massert isinstance$!s)(if c in b' \t'y8Z-C# ifV, we have'escape _ becaus Pis us#o Gt=i_r(Sc == 0or (b' ' <= cRb'~')&(cQf a single characterK!\Qc)==10c =&"(c>+Fs((HEX[c//16], P%16])^(input, outkf=FalseaRead '6 ',5#lyE\Aing,0wriZ2o 'f'F$ `ry file objects. !.K#EA!we(Cas _NUOA1522(#if1 isHqdata = b.read(#ob(=A$.(N%sY=,[End=b'\n'V#_ requires  inH0 orQ must!Mthat trailing character encoded.  if s and s[-1:] in b' \t':#* output.write(s[:-1] + quo:) + lineEnd);!el`o== b'.S JE/se yz@prevq = Nonevwhile 1H! in@read(aif not5 QbreakT0out9U = []# Strip off any _ induced trailing new?:s8@ped 2'!ifN+\nOG" ='< W&\nY# Calculate the un-length-limited2YTPfor c,v cytes((c,)PT@eedsbing(c,Ctabs, header)O7S3=e(cP5!c  B.append(b'_'J,eld7~# First, A out?zJious.0if ,1 isW I((# Now see if we needU2sof  s because of RFC-imposed"#  ations. Then do@this$->f dance/" = EMPTYSTRING.join(etDlen(7) > MAXLINESIZE # Don't forget to includ `=' sign"thcEion! "n'[:A-1],End=b'=\n,64 = [@: W3!bcurrenmQ*# =2las:`, withuaKry)c) defGng(sd=Falseif b2a_qpcreturn# T =Rfrom io @rt Bd!IO)dinfp ="(s19out(3,'fp+H.getvalue()  deL(BK4putA """Read '+', applyd-printable QAing,'}'E# are binary fobjects. If N'header' is true, decode underscore as space (per RFC 1522).""" if a2b_qp is not None:  data = input.read()oa@(", =, utBawrite(9breturnnew = b''fwhile 1: Iline!ifu: break;i, n = 0, len("7 > 0 and -1:n] =6\n'ppartialN;U5n-1h!# Strip trailing white (n{in b" \t\r"~au7els"oZi < nS2c =ii:i+1]Bif c!_'  Ar+ b' '; i+&!elQ!= ESCAPEH cE0i+1nCnot R[ = 1;N"< Mqi+1:i+2$2D0i+2zQishex[h)~2:i+3])e = + bytes((unRd3]),))3se: # Bad escape sequence -- leave it in7-u{JoH(6\n'aP&ew Dc) defstring(sSFalse@  Cfrom io import Bz!IO#dinfp ="(s19out(3!, #n! .getvalue() # Other helfunctions \cA"""R`#q if the5 ordinal 'cCa hexadecimal diga ASCII0assert isinstance(c,Nb'0' <= cb'9' or b'afA"F's1Getinteger J of enumber@bitsfor c in sPB2c,)=if 6" =B7('0 9aa')-10Q<  < = ord(b'A')S-10 Uelse:assert False, "non-hex digit "+repr(c)3pbits = *16 + (ord(c) - i&areturn" def main()ximport sysTagetopt2try*opts, argu%.(sys.argv[1:], 'td'rexcept &.error as msgW<stdout =q.stderrwprint(msgS"usage: quopri [-t | -d] [file] ..."4!-t1te tabs d: decode; default en,bexit(2`1" =\ for o, a in Hif o == '-t':q = TrueI""d'""if51andZY@"-t < -d are mutually exclusiveaif not: = ['-']sB1if '&fpin.buffe@ AEPopen(hW, "rb"?OSE#Perr.write("%s: can't ` (%s)\n" % k"@1$gcontin +if7dde(fp,B3out0 5@@,`F0fin! i! afp.close(Hfif stsC[Q@sts)if __name__ __#__[ () """Random variable generators. bBbyte- uniform # (values between 0B255)IwintegerL?---Owithin range;xsequenc @pick3belemenVsampl1 weightedF'e"permutationdistribus on the real lintriangula normal (Gaussian$2log Hnegative exponential Xgamma9bethpareto"Weibull circle (angles 0 to 2pj--------------& circular uniform4von Mises General notes on the underlying Mersenne Twister core ge6tor: * The period is 2**19937-1. * Itaone of\ most extensively tested Sps in exn0nceD`random() methiimplemen>in C, execuin a single Python step, an,`refore readsafe. """ # Transla\8by Guido van Rossum from C source provided by # Adrian Baddeley. Adapt Raymond Hettinger for use with #uEos.u As. warnings import P as _ #Dmath1log0log>p qexp, pi Qpi, e qe, ceil MAsqrt a, acos $, @cos,>sinH0tauTWOPI, floor_ /o! #_collections_abc"SeSet, Sequenc @itertoolj`accumumr, repeaW Cdbisecty  '$os_a try:# hashlibM%pretty heavy to load, try lean internal module firstF"t_sha512 except IA0ErrW# fallbackuofficialHakhH ]: __all__ = [7!"R" "Systembetavariate'[choicsKexpo0LgammDEgaus40get8bit'stt{lognormZ+al\paret`5ytea4int(omErang saFseed teshuffl9tg1@vonm gweibul] NV_MAGICCONST = 4 * _exp(-0.5) / _(2.0) LOG4 = _log(4*SG=T1.0 + 5) BPF = 53x# NumberE#aat RECIP_22 ** -BPF class @(S.)V#""s" n^b base B"usUboundU"un[!. U%to instant cWf:8getthat don'ashare [C can also be subclassed i$f you want to use a different basic generator o3%r own devising: in that case, override the followingI methods: random(), seedgetstate Uand s.<Optionally, implemPa getMrbits() b2 soqrange()EPcan c arbitrarily largeQges. )2""" VERSION = 3  #(@d byy/1 def __init__(self, x=None):ZF """Initialize an instance~$Q argux controls5ing, as for RO.L0D "x gauss_next = R:1, a, version=2internal q from aThe only supporteed types are, int, float,@str, bytes, , Warray`f or noBs1cur@time'@n op#ystem specific( domness source if availablIf *a* ispt, all Gused4For[@ 2 (=default)9!ofR @{d # s, ( e1 (providedDreproducingMsequence<EoldesPython),algorithmW0strLsS narrowerv geO %if(@== 1] BP(a, (  )a = a.decode('latin-1')H D@) elCx = ord(a[0]) << 7>a+0+cmap(ord, aQ@((103 * x) ^ c) & 0xF _x ^= len(aQ -2rx == -1x"*elF2F mE Q+if}?strAa.enx += _sha512(a).digest@@int._k'big');not(T()P2(_warn('Seedbased on hashis deprecated\n' 'since &A 3.9o wie removed(Ra subn/t J~%. @sWe: None, '   'int, float, str, bytes, and array.', : DeprecationWarning, 2) *super().seed(a)elf.gauss_next = None8def getstate(self):8"""Return internal (; can be passed to sC) later."""HrE^.VERSION, }1), "_"8 can use depends on thJ() and/or0getebits() implementation available to it< determinesDpwhether"~ from arbitrarily largeGuranges.6"""c in cls.__mro__KQif '_Qelow',|.__dict+/# just inherit itxYbreakc1d" =g_with_Q mA/om~2?out{b` (t8, nRage [0,n). )s 0 if n==0.Jot n0,H% =&it k = n.bit_length() # don't8(n-1) here becaKnUEbe 1mGr = q!(kF0 <= r < 2**:while r >= Fa;r| , maxsize=1</om = _warn("Underlyingl$()F5or ely \n"^"enough cchooseb populR this.NTo remove~rge limiZy, add aC)s9.")r_floor(f() * n(#J== 0;$Trem ="E % njC = (f -5) /.'Bint(**)G |LB % =3 t _randbe low = _randbelow_with_getits ## -$@ Methods m this point generate custom distributionsCbased on the mP defined above. They do not=directly touchCunderlyingPor anc)ly=paccess 0omn bthrougH#: !9(),>Ug(), orw?().i e bytes1def1(self, n):D"""Gln*"om^E."""'preturn @.n * 8).to_an, 'little') uintegerR Srangestart, stop=None Jep=1Choose aitem fromLF[B]{TQfixesproblem Adint() which includ*71end; in Pythis is usually what you want.M!# @code@a bit mess make it fast for;common casele still doPadequoerror checking.Aip0 =  )#f 1!= _raise ValueE_d("non-Qarg 1I))"^ [i{:> 0z(c+ Pempty/ge# argument supplied<%op;&opy1op 9*op8 7Pwidthu(-if step == 10 F2" +K7 W `b (%d, S)" % ,Bop, w))# Non-unit eee/ep'[=ep bQn = ( +ep - 1) //%elE<E+E+seaise ValueError("zero step for randrange()") if n <= 0:raise ValueErNPemptyF/geP return istart + ep * self._sbelow(n0defUPdint($v, a, b)B"""RT=om integer in9@ge [2], including both end points.6"""v.\MB+1) (O## - sequence methods 'Ccchoice:seqChoose adom element from a non-~v.!# qs Index0 ifA is 9!q[@len(&)]dshuffl#x,Z=NoneS*p list xplace, and v6.]Optional argues a 0-@func+Ha an3Pfloatw[0.0, 1.0); itthe default U, theCstandard om will be used{;iZ, =C(ireversed(01, 7x))n1# pick an0in x[:i+1] with which to exchY x[i]zI1j =}(i + 1)%:, x[j] = MJelse_warn('The * om* parameter^ ) has been deprecated\n'P 'siuPython 3.9`premovedIRa sub//t Jioion.',hDionWarning, 2floor = _ DoEdom() *  Esamp`popula, k, *, countss k uniquecsSUgor setu2newe`contaiSUFwhil@leavA%Porigi."un*@d. `result2!is9 ineorder so that allr-slicesI@alsoNDvalijLdst is@`ows ra} winners (*)? beO tied into grand prize @secolace winners (the subslices). @Memb"0of $population need not be hashable or unique. I3J;contains repeats,\n each occurrence is a possibleHQselec in8w sampleRVed elements canspecified one at a timAwithN op\%alp0couCparameter. For exw:+2(['red', 'blue'], E=[4, 2], k=5)9is equivalent toT [ iq bTo choose a/ from a range of integers, use`() for @argu^p. Thiseaally fastppiefficientJZ.4ingflarge d 2(10W), 60M6"""Z0# Sc0outs els track%either potenti%# w.pool) in a listprevious,!7setR# Whe nu^_is small compared to##; Hw0, rcEring`# onlyn"se anasional reR?!a /r  &_method isE`prefer sifQtakes less sD1tha6=it doesn't sufferRfTs7The0cal0o _5pbelow()@kept0or near ktheoretical minimumimportan,!ca`0unnq6tim#kdominated by"be@Pit ex+ts lezrentropySpunderlyt$omgeneratorcMemory6FAare  era k-lengthsor an n+ 0re Zo{algorithmam(ir4auxiliary mP, buty were rejecP<they madEtoo many A, ma them slowed]"to eat morednecessaryif isinstance(, _Set):e`u_warn('j`deprec:\n'  2'since Python 3.9 and will be removed in a subsequent version.', IDeprecationWarning, 2) !q popul" = tuple(+if not isinstanc&A, _SIce):]raise TypeError("Pn@must"a ce. For dicts or sets, use sorted(d)."n = lencounts isJNoneCcum_$= list(_accum"e()n4!ifq:j) != nX)CValu'The number of ^B doematch the'|total = }Z.pop(%7[, int"'C4integers1if W_ <= 0`greater than zeroiPselecs = self.samarange(j), k=kbisect = _ veturn [[&([p, s)] fq]Krandbelow_$0)k + '!"ST largwegative Presul[U] * kFize = 210# s ofL@malllf minusqn emptyNif k > 5d+= 4 ** _ceil(_log(k * 3, 4)) # tablec^0bigzs_n)Q f# An n-lengths-4a k Eset.XInvariant: non-ed at pool[0 : n-i8k# ri+kmEj = #j(n - iDlR[i] =j$%[j"JP - 1]a% @itemo vacancy;elsot]B_addected.addS pwhile jRw i VJ?.(j r [xr1) def choices(,, weights=A, *,  k=1): 6 """Return a k sized list of population elements chosen with replacC. If the re;ve weights or cumQare not specified,IFPselec s *Bmade|equal probability5"""Erandom = self.n = len() if_is None: %if $floor = _ ?n += 0.0 # convert to float for a small#ed improvu Mr[[v(() * n)]Vi in _repeat(Y, k)]S:try5cum=+C(_ac#e(0)I5except TypeErrorW!ifisinstancJn, int)1WYraise4k = 2(!Af'The numberchoices must be*eyword argu}: {k=}'Na) from:*el7 @'Can*(dy both@ and \'!ifo) != ntBValu(Q doesQmatchrvptotal =3c[-1] +%2if ><jogreater than zero`bisect }hi = n - 1Z5(T', h{, 0, hiXd?or KO## -p real-vd distribu!0Ldef uniform(g, a, bUc"Get a!inqrange [2 ] depending on rou .ya + (b - a}}&()triangularalow=0.<@gh=1 Pmode=(5""T; Continuous" bed by given lowerLupper limitsf0hava3  in-between| http://en.wikipedia.org//_$u(  c 4Q5 if  else (mode - low) / (high - low)  except ZeroDivisionError:")`return:if u > c)u = 1.0 - u*AccQlow, =,dw) + * _sqrt(u * c) Tdef normalvariate(self, mu, sigma)A"""N+ distribution.Imu is the mean, andEstandard devia>1"""J# Uses KindermanK Monahan method. Reference:),CHA.J.9, J.F., "Computer gener of randomAbles using/.suniformes", ACM TransDMath Software, 3, (1977), pp257-260B0 = .Mwhile True-Cu1 =(2CL z = NV_MAGICCONST * (u1 - 0.5) / u2~Pz1z * z / 4.0if zz <= -_log(u2;=Ubreak6Pmu + VqO_gauss G#?ian9 This islightly fas7Athan  :k) funcNot thread-safe without a lock around calls aWhen xy are two from [0, 1), %lyf#0ed,n cos(2*pi*x)*+0-2*F1-y)Z#+?sin+`*pendent*'io0 (m,0').b(Lambert Meertens(corrected verP; bugk covered by Mike Miller, fix#LM/r# Multianote: s tKsimultaneously, it$possible tha7ey will receiveDRame rf`value.c@ndowPvery small v gh"oCQavoid, you haf[o useDG (ICdidn't want to slowQr down i)serial casefOaF Where.j&'U_nextP &on;;NonKx2pi = random() * TWOPI g2rad = _sqrt(-2.0 * _log(1.0 - random()))7z3cos(x2pi) * H #self.gauss_next1;sin12return mu + z * sigma def lognormvariate(\R, mu,(!):)p"""Log -al distribution.N%If you take the naturalfarithm of thisA,5'll get ark with meaand standard devia.Gmu can have any value, =  must be greater than zero5"""QRA_exp0.C=)gDexpo!dZlambd`Exponentia6@ is Edivided bymqdesired. It should be1non (The paramew* called "jpa", butEt isGa reserved word in Python.) Rr"edjsge from 0 toEpositive infinity if w>@nega1B9Ito 0>+#hb: rate P = 1/Z^A# (' a'a # we use 1- insteadto preclud%ppossibil )Qaking0logD1-V\.j2) /vonmisesZkappaCircular dataW mu= angle, expresseradians between 0}A2*piNconcentr, which%orLequal toU If _ ,v reduceto a uniform2dom1 ov1e!ge !;@# Baupon an algoqpublish10: F r, N.I.,# "Statistical Analysis0DatCambridg# Univers]Pg, 1993# Thanks7 Magnus Kessler for a correce toimplemen ongstep 4`7 = Biv<= 1e-6z\g *n=!s = 0.5 /Wro# +6w+ s * swhile TrueuFu1 =kfz = _cos(_pi *w u1) d = z / (r + z)u2 = random(if u2 < 1.0 - d * d or3= () * _exp(d):XVbreak1q =M5/ r+af = (qVX+ q */u3z3 > 0.5zPthetaWmu + _acos(f)) % TWOPI{Oelse:-:;qreturn jdef gammavariate(self, alpha, beta @"""G, distribution. NotTIP func!bQPCondi1s o parameters arepA andw .BThe probabilityrF is:3yax ** (@ - 1Pmath.A-x /sGpdf(x) = -cre`}yU5"""E#, mean is*H!, :nce6**2Z# Warning: a few older sources define in terms"ofu > -1.0i`<= 0.0u  raise ValueError('&3te:a pmust be7.0''0 = .> # Uses R.C.H. Cheng, "h`generaA of S#u bles with non-integral shape+",=Applied Statistics, (1977), 26, No. 1, p71-74zainv = _sqrt(2.0 *)-u bbb =ILOG45ccc + Y kzwhile 1/u1if not 1e-7 < u1 < 0.9L2continueY-$dlog(u1-H2) /%xv6,0z =*21r =_ + F}* v - x&0if SG_MAGICCONST - 4.5'% >%r _zm1x *%elu= dc# expoU0(1/ Z- mn z isaween 01 (exclusiverxALGORITHM GS of Statistical Computing - Kennedy & Gentle while True:#u = random()b = (_e + alpha) / _[Cp = b * u@if p <= 1.0z;x = p ** (1.0 /g H?elsA-_log((b - p E/u1 >Pif u1xd -0)]break%elM_exp(-xC?return x * beta \1defvariate(self,K,_"""Beta distribution.GPCondis on the parameters areV > 0 and] .ARed values[ ge(Cween61q5"""<V## Se_## http://mail.python.org/piper/-bugs-list/2001-January/003752.htmlefor Ivan Frohne's insightful analysis of whyoriginal implementa$(##`?  ##9# Discrete Event Simull in C, pp 87-88q {I@y = T.expowz.@1.0/c1hz/(y+z!was dead wrong,0 how it probably got that way# This version due to Janne SinkkonenRmatches all6std texts (e.g., Knuth Vol 2 Ed 3 pg 134 " &")dOYgammaP,sFif y,y / (y + H{GK620.0PUparet P' #. "is%7hap. Jain, pg. 495)- 4#1/ u% x$tweibullGW. ] 7cals^ G9; bug fix courtesy Bill ArmsA2* (7u)))) ## --------------K ## * Operating System Random Source 0--- class10(): """Alternate rQnumber genqPor usvshs provided@by the os(such as /dev/uZon Unix or=CryptGen on Windows). ! Not available!Ball cs (see os.^() for detailC2"""L3defS(self1GetCnext& !inrange [0.0, 1.0).Y> return (int.from_bytes(_ 7), 'big') >> 3) * RECIP_BPF0get(Abits:, k!k) -> x. Ges an int with kO if k < 0raise ValueError('0of C must be non-negative')! . = (k + 7) // 8[#T!and rounded upP0x =OlV6xg(' * 8 - k)# trim excessenu% nh- i#@n) fhn!# eTaempty T@ strun == 0.8v&n)Cseed*args, **kwdsStub method. {Ausedau[#,."FNone_notimplementM should noyOcall FNotIGentropy Q doesshave state.1getF = s =  ` # Creone instance,  rom current time,9export its0s # module-level functions. TheS shar across u0useHc(both user's codezPython libraries), bu`at's fine #V@mostO@gramd is easier Zpcasual k than makcthem # ti%their own#()`ce. _@% = F1 = .  %omv unifor triangular2L= _inst.randint choice = _inst. randrangf samplh shuff`sas normalvariatM @ log % \ expo# vonmises$ l gamma%V gausM bet5m paret } weibul  h getst-, s47bit$etFbyte ## -": test programYp def _+_generator(n, func, args): from istics import stdev, fmean as 0Dtime*perf_counter #Xt0 = !()data = [!(* for i in 'A(n)]+.t1Caxbar =(PZ@sigm[ , *0low3!in@high#ax^print(f'{t1 - t0:.3f} sec, {n} 0s {.__name__}'Q;'avg %g,@1dev 2minax %g\n' % (!, p, low, 7)) s(N=2000  N,4rdom, ()# , (0.0, 1.02 3 411 21!2 b5911 21 c032uss @, (33 triangular_d2 / :Q=-Qk supS if hasattr(_os, "fork"): _os.register_at_fork(afin_child=_inst.seed) if __name__ == '__main__': _test() # # Secret Labs' Regular Expression Engine # # re-compatible interface for the sre matching e8 Copyright (c) 1998-2001 by~ AB. All ,s reserved.This ver0of qbSRE library can be redistributed under CNRI's # Python 1.6 license. For any other use, please contact Secret LabEAB (info@pNware.com)Portions #is have been developed in coopera3q with #. Hewlett-Packard provided funding vgCband # cility work r"""SupportC"re$exs (RE). sdmodule 0 `s simiJpto thos%!unPerl. It s s both 8-bit and Unicode Angs;  qpattern&"0 beprocessed in null bytes7 characters outsideKUS ASCII range. dWpspecialYa ordinbo. Most , like "A", "a", or "0", arsimplest ;yc2ply~mselves. You concatenaterso lastD esFv ''$e =2areM0"."Tq Matchf%y ) except a newline.+"^52art9.$.:end,Djust befoGu1 atw! Am*m0YmR(greedy) repeti!1ece"REImG6P meancat it willxP as mVas possibl2+1$+"?I%1 *?,+?,?? Non- @viou/re9P{m,n}!5from m to n^B?? Dabov>"\\0Eitescapesor signals a ssequencN []p Indib+es*@ A awe first&iIlementing set. "|"# A|B, creates an RE that will match either A or B?P(...)AM"`es the;ainsideparentheses4/The contents can be retrievedewed later inPbstringK(?aiLmsux) Mletters set+corresponding flags defined belowF:Non-group/version of regular (?P@2sub4iyX is accessible by > P=O PEtextOpearlier<lW8dL# A comment; ignoredm=!hcif ...fs next, but doesn't2sumJ!J8P0<{zbpreced,P(must0fixeength)@q@Onot D@(id/5)yes|no)p`yes paGGn ifSwith 6'!d,C (optional) noToCqwise. 0pecial sequencesi0istx"\\" and a characAfromRlist 2 Iordinary00is o>5,?p result(REfsecondJ\number 2+o Rsame 6CA.bonly aAstarXi/\Z60end1 4b4!bempty [#r SSa wor6/\BOo NdNany decimal digit; equivalent to[0-9] in bys@|!s QASCIIC In 5"ou89, iVZwholePrangerUnicode #\DxAnon-  R[^\d]/\sCwhitespaceD \t\n\r\f\vKZSnon-whitespace character; equivalent to [^\s]. \w Matches any alphanumeric Fa-zA-Z0-9_]LJ in bytes patterns or stringwith the ASCII flagG/In5;out8, it will m range of UnicodePs (les plus digitsKunderscore)WoLOCALEa set [2b]s definedn4as 0forP currblocale#\W5Xpcomplem,Sof \w+\+a literal backslash. This module exports~`followfunctions:z\ a regular?tression`beginnMCof aBfullSO0all E`searchS  Mqpresenca0sub: Substitute oc2ceso` foundcEnF Same as sub, but also returnZ`numberVsp^C madQsplitNS k1 byB@find&p Find 1=&2 R0an ator yieldaFq objecteBeachile Comp w into a P5F7@purg5b Clea `Ccach-Qescap3BHnon-s EP othen2an Cand [can take an op @al 'ps' argu{ consist`of one 1morsRmo2tants, jo"|". A, L, U are mutually exclusiv#A U-. F~0, m\w, \W, \b, \B, \d, \D;correspon categorie7I6(raQMUwhole=, which iv|defaulth 0, tU only availabledbehaviourtneedn't be specifiedI IGNORECASE Perform case-insensitive#in2L )Madepend&(t  M MULTILINE "^" matches the beginning of lines (after a new>) as well aGstring.*"$" matchr7endlgbeforemRZKmBxS DOTALL&".xany charact all, includKX VERBOSEM0Ignwhitespace and comments for nicer lookQBRE'sJU UNICODJ0For8patibility only. bdK patterns (iti{default),forbiddenJUbytesI. This module also defan exception 'error'. """ import enum sre_compileEparsfunctools try:J_locale r! I`Et'  = None # public symbR__all__ = [Y"b", "full `search3subnbplit",<pfindall @iter  Ppurge qtemplat descapeE3#P M AILMSXUDAASCI&IGNORECASE QLOCAL MULTILIN !Gp", ] __version. "2.2.1" class RegexFlag(@.Int )w = A = .SRE_FLAG_!# assume ascii ""[O = IH&2# ikAcaseCO = L?"current 8-bit KO = UL#MzunicodeO = MK%P# mak3Qchors$rO = SP"M2dotVF O = XG#jP#` extenCs (experial, don't relP"se.TEMPLATE = T$# disable backtracD_DEBUGAd# dump a Idef __repr__(self0if ._name_ is not{ $return f're.{2!}'c#PvalueQelf.__pmembers]pnegativ5/E < 04if +1= ~ 0Cm in_$__< if value & m._value_: U &= ~% $members.append(f're.{m._name_}')11if P g ?Ahex(&)9res = '|'.join(2 if negative\Vif le1J > 1!^f'~({res})';elsU432return resE__str__ = object. globals().update(RegexFlag.__ __) # sre exception error =_compile.+-0) # public interface def match(pattern, string, flags=0)Y"""Try to apply the 31 atstart of F91ing80a Mm6, or None o was found."""6D ").)Bfull!/lla OsearScan through looking for al!to$jK &ubFreplcount=0RM obtained by F ac!leftmostPnon-overlapp!occurrences4 in?b@[Qementg!.  ube eithed callable;BCif aY, backslash escapesv it are processed. If it i$a R, it's pa'd and musa"acpto be uly@sub(  Osubn&a 2-tuple con@(newz nu!).1 isBRasource}k" [2. "of=pubstituat were made.MX C e; if a stri"ng, backslash escapes in it are processed. Ifis a callable, it's pa& the Match object and must?return a replacement string to be uk8"""/_compile(pattern, flags).subn(K,E, count) def split5hQ, max#=0IA=0):p@"""S4csourceY1 byoccurrences ofBa list contain`result2sub s.W>Qcaptu parenthesesmznP text1allDQgroupp0DRalso @ed ar;)E- is nonzero, at mostP!s ,BXpmainderOfinal elEb(f~findallQR}0all-overlappm/u!. If one or more ] esi,GG2of 8; this will/@tupl C2hasAthanKdEmpty includedp.dyOiterzperator t w. For each,-R|I{C.gular expression ,2a P {.E+dpurge(QClear1-rezbcaches\_ .c0!()_. _ |templat+ o |T) # SPECIAL_CHARS # closA')', '}'']' # '-' (a rangecharacter set)!&4~', (exten8 %0 opAions0p#' (com)iWHITESPACE (ignored)kverbose mode _special_\s_map = {i: '\\' + chr(i) for i=b'()[]{}?*+-|^$\\.&~# \t\n\r\v\f'} def escape(pattern): """E special characters in a string.+3if isinstancW,+\`sreturn u.translate(_k_kas_map)^Belse?8 =W, 'latin1'3)h.encode(F" P = type(sre_compile.('', 0)) Match) .m(('')) # -0P # in#als _cache = {} # ordered! _MAXCACHE = 512 def CSflagsX#:  :, RegexFlagE1 = a.valueA6try[p$),w,C]>except KeyErrorJApass" N#, "ifYDpraise Vb(U"cannot processE argument with a<d"`0if Sl"isiBTypef"firstpmust be(oing orpM6( & DEBUGrif len(U) >= } b# Drop the oldest itemc $Bdel ^[next(itero)+&(StopIteration, Runtim5,D@Mt A = pp @functools.lruF()`_repl((1aceo|Faparse.Q_temph8` dexpandf!, $, 5.8Q impldQ hook@b $qCk8)Fsubx% .sub/subn\elper8_ &q[0] and1]) == 10# l0al @"[00fil  =. return sre_parse.expand_template( B, match) return filter # register myself for pickling import copyreg def _Xe(p):S_compile, (p.pattern, p.flags) D.>P"_$, A)-0" # experimental stuff (see python-dev discussionsadetaillass Scannerd_init__(0, lexicon, #=0mfrom sre_constants QBRANCH, SUBPATTERNK5aif isi01ce(U, RegexFlag^-" =|e.valueI.$ = # combine phrases into acpound 2ep = []1s =p~ Sttes6`q, action ine?0gidc.opengroup(_ p.append(c#ubYU(s, [v/(q, (gid, 0CI(M))),K*])rs.closeZVp[-1]%?gS((None, p));sSn.v"(pi)Xstrin5jresultF2 = V>v@elf.\4ner(a.%3Ui = 0while True2m = if not m.UbreakXjD.F_ == jE!= h3[m.lastindex-1][1acallable(@ %P 8# = "m.D `#if'1 is ) sj ", [i:] """Redo the builtin repr() ( esP) but with limits on most sizes.""" __all__t"Repr", "Gcursive_]rx!s Ditertool@bislicet_thread[get_ident (rebQ(fill'c='...''Decorator to make aB fun/@,%_ !' _dRDing_DU(user{_runningi2t()JN wrr"9 key = id(self), get_ident() if key in repr_running:$/return fillvalue!;.add(keyg?tryTsult = user_function `ofinallB.discar} reo Zp# Can't~ }ools.wraps() here because of bootstrap issuesG1per.__module__ =oYattr(6, '%'!B?doc? "<?nam| #>Bqual 'F`annotas *V', {}decorating0 class Repr:-def __init__O}.maxlevel = 6_tuple0lis3array = 5M0dic34 seKofrozenOdequstring = 30l!lo4Rother56:6F, x)9&#Q1(x, N)~!Q, x, mL@typen0 = `(x).__!__r`if ' '# SpartsA\.spli; = '_'.join(9naif has'A_' +[z ?get6 !JelseM{.yinstance>?_"tterable` ft, right, maxiter, trail=''n = len(x <= 0 and nlQ'...'2newE_`5- 1/321 =8 Ppiecei[t(elem, V`) for Bisli&))]Ldif n >2: ].append(y4', ' "TA== 1!Y": qi" +0'%sp' % (les 7_ P1 x, level, '(', ')', self.maxtuple, ',') def repr_list(', x, level):#'breturnG_0iterable(., '[', ']oU i_arrayjif not x|"='%s')" % x.typecodeheader = ,?, [.SK /seE ';%)'x = _possibly_sorted(x)  '{}[5)',? _deque]E r/icxn = lents == 0: 6'{} "if* <#7...&1new_uvel - 1A21 = pieces = []for key in islice(kGdictB0keyg! =st1(key, +9val+ox[key]..append('%s: %s' % cH#, Q)ga>0max+: JF...'2Qb.join(+1%s}|,s,?stru^builtins.D(x[:vstring]nVn(s) % :i = max(0, {(f-3)//2Rwj. zJ-3-i+ri] + x[7-j:_41s[:&'\A + s. s).lLs/inD] @) # XXX Hope this isn't too slow...sQOlongO&M+K+Vstanc level):  Ptry: s = builtins.repr(x)!# Bugs in x.__" __() can cause arbitrary7exceptions -- then make up something3-$ E4 return '<%stance at %#x>' % (class__.__name__, id(x) if len(s) > self.maxothermi = max(0, ('f-3)//2PCj- ,*-i*is[:i] + '...' + s[E-j:] s def _possibly_sorte@# Si not all sequences of items2be 9 and comparisonpb# funcxmay rai #, Ran unRCy$that case. oA<gb/@list- aRepr = 0() 1 = r """Wor le for GNU readline. TheUleter s keywords,A-ins2`globalx a7ectable 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), 51see$]qined bysys module! Tip:{ qthe tabW!as, mq, call 1parse_and_bind("tab:") Notes: -<sg%er are *ignored* (generally, to fail). This is a features0 set`deviceraw (or cbreak).%e, printing a traceback wouldn't work well without> icated hooplap@save1setbrestortty stat - zh!of ..= m  P appl{iF1def@codebe execuif an object a __get __kPPfound3 it9responsibility}RPuser) ent this P, I cI1der ac.risk. M-7'edMV(e.g.Ms or indexPoperaz"s)kSnot* h0ed.Woriginal stdin 6,"ever used,K2ule[ module) are silently inactive. """ import atexitbuiltins__main__ __all__ = ["Completer"] class : def __init__(self, namespace = None)*."""Create a new c` for themand lin5v%([_P]) ->1 instanc7If unspecified,bwdefaultAwherzIions are performed4is ' (technically,.__dict__). Ns should beKgiven as /ionaries. FP used=1 mechanism ofJ@readMA viaEset_x0() :z0.(E(my_$).J)qt/'ifhdnot is(J, +>raise TypeError('/p must bHB6y')# Don't bind to quite yet, but flag whetheuser wants a## FcJo. This will allow usM%toR;4 ation time, 7Enow.D Y!isih=B.useens = 1?Oelse/0/P= v  text, stataReturnnext possibl'B'V!ised successively withm == 0, 1, 2, ... until itr7B. TzI2ginW  ' NHPAOattr( aiG dotAssuming the<!ofform NAME.@...[ !],-%isuPevalu)}, it will be (2tedA0ts VibuteM(as revealed by dir()) are us;s possible co. (For clasMinstances, membersOalso considered.)oWARNING: this can stinvoke arbitrary C code, if an objectwith a __getp__ hookc %reMqm = re. (r"(\w+(\.\w+)*)\.(\w*)",N!ifmd`Qexpr, = m.group(1, 3K:tryF! =(F Aexcept E:ionNQ# get!env#, R=s = set(Bct))  words.discard("__builtins__") if hasattr(thisobject, '__class__'):-4XHadd($#update(getKwmembersh.f%))Bmatches = []n = len(+0if j == ''noprefix = '_'H(el4_5 6/se_ENone`while Tru01for1 insOY@if (]@[:n]5and\%Unot (1andVQ[:n+1=)@e = "%s.%s" % (expr,Ga/>tryval = getQ except E?ion^pass # Include even `ibute ?set,,el  self._callable_postfix(val, $es.append( *"if@Qes orYbreak4if /'!2 es.sort(dreturnP def k1pret = dir(l,'__basef,,(.' 2e+CUret import readline IRErrorm_"Q_avai = False ]% .sompleter(C 3).c # Release references early at shutdown (th" module'sN # contents are quasi-immort=wr function holds aF to globals).atexit.regisulambda:5 K6 """runpy.py - locating @runn Python code us namespace Provides sup;R wscriptsUk \ instead of |native filesystem. This allows G to play nicely with non-= d PEP 302 ers whenas well )8s. """ # Wri tten by Nick Coghlan # to implement PEP 338 (Executing Modules as Scripts) import sys import lib.machinery #[ortlib first so we can test #15386 via -mJEutilo Ttypes os from pkg.q read_code, get_er __all__ = [ a"run_m1", path", ] class _Temp(object):< ""orarily replace a P0 in!. s with an empty namespace"""Ndef __init__(self,H_(pR% =#C!aule = ,.Type(mod;)1c_saved !] !SenterL9 = :2try* ' l.append(sysk[X]except KeyErrorVEpasstI5ule,areturn xW*args!if0. mu] =5[0]JelseM8delF[Q9 WModifiedArgv0 yWvalue^1 = yentinel = 7)()fU `Sdis notyX (raise Runtime%@("Aly preserv"_>r=uHargv/ > i3@#_sR;ys.e # TODO: Rqthese helperg_bootstrap_external functions. -( , globals, e=None, Bspec ,1pkg~! sQrA"""H@run Nnominated>)if 2(.update(%ifF Bloader = fhcached2 R%9.A] eorigin cached = mod_spec.cached if pkg_name is None:$a= mod_Daparent'run_globals.update(_N2__ 2[,,O a__file,f) + U1doc)'aloader* ,bpackag/(Y5)exec(code, :hreturnp def _*pmodule_;@Dinit{=Z# #q script) """Helper to in new qspace with sysyified"""v( =_0 if'dU elseq.originAZa_TempM() as temp_5a, _Mod}aArgv0({9( =:.A.__dict__x2B(, "-!,,t,# Copy the !ofPoraryIAule,1hey# may be cleared when8 goes awa9q.copy() # 1getNAfull , B and Sfor a3get_details, error=ImportE 2p.startsC("."!RraiseC("Relativ71ules not sup_2ed"\H _, .rpartitionjR,zq# Try i1ing avoid catch`ializaZs\K6tryX"__X4__(wexcept 1 2# I,or higher ancestor qmissing, lp#Rnd by fin() belowtjzaught. But doN al3 ots5: 3Pif e.S or (%!=D 9rHKC + TU4R`# Warnm| has alreads#ened under it2rma+MPexist=%pUs.get0iPthasattr(U, "__path__"):  from warnings import $! msg = "{mod_name!r} found in sys.modules afterGiof " \IU"package {pkgO , but prior to execution E; this may resultunpredictablebehaviour".format(= $, = )<(RuntimeWHq(msg)) 'Atry: cspec =lib.util.find_~bexcept (IError, Attribute4Typ BValu v) as exy0# T!hack fixnedance mismatch betweenE and#1ortlib, where the latraises other es for ca/J1pkg`0preAsly A'd 0~p while 4Bing x >Qifica3x{({}: {})"K if3u.endswith(".py").t+= (f". Try uso'v[:-3]}' insteadfA&f"5 }'6L"."1?E , type(ex).___, ex)) !ex!if is None^0"No @ule pd %s" %YJQ.subm_search_lokse;notif == "__main__" orc!  0CankDuse B4as ;X7uleM {^ =2T + ".H,3return _get_details(N,79 " G, 6 # loaded; beais irrelevantAE(("%s; %r<Rand cg9" +=A "be directlyed") %(e,])1r =.`2if Gspac&be^   Qccode =.  e0if Y "No&object avail  mod_name) 2 return mod_name, spec, code class _Error(Exception): """ED that _run_module_as_main() should report without a traceback""" # XXX ncoghlan: S6 this be documented and made public? # (Current \ghts: don'tu eae mistakelead to its # creaf when () no longer meHneeds of # .c, but cy be changed because it was_) def1alter_argv=TruesRuns the designa1 in_}0__ aspace c NotBWexecu@will have full access*4theB]Q. If ais notarable,SFAfuncu abe use"ruva fresh.Avery leastxpse varisAbe overwrittenA _$__l__filelcachedlloaderdpackagCX6try|6if 5 orT != "": # i.e. -m switch5, t = _getdetails(r)MPelse:udirectory0zip I5ion=4[ %ai2ep~v as exc.msg = "%s: %s" % (sys.,/bit(msg_globals = !t&s[m].__dict <U[0] =xb.origif%(,Ey, None,CG!) H`hd, initY=X7,zsys=FalspE% aQule's imeing itRU`result!top level ]aionary <i7%!if1 isW%z7sys. f,tId@# Lec3sysVU alone /*{}tberror=ImportError): # Helper that gives a nicer e( message when attempting toAexecute a zipfile or directory by invok4__main__.py=pAlso mowthe standard * out of bway so3theBqpreexis__loader__ entry doesn't cause issues8name = "m"Qsaved = sys.modules[4](?del 2trycgreturn _get_O_details(V)Vexcept ImportEfas excM5if 5 in str(excoRraise@("cafind %r ;Q%r" %x3,path[0])) fromAtgfinallIbob def%Pcode_`_RP(run_0, f# Check for a compiled 2a first deM d_` = os. @.absb(os.fs$(]with io.open_B(%If) as f!r = read-fF1if vis None10# Tr0didQwork,Pry it]normal sourceE2=#0(f.#()O0, ''3 2init_globals= , 'C"""E&W located atsspecifibsystem$Dion RDs2Qresultop level uspace dictionary=2The may refe ly to a Python script (i.e.~2onezpcould bf0ly <u)2els xo0pcontain/Ta top3.py"""%if t< >91pkgmp.rpartiKr(".")[0iPer = (NDHP# TryRvoid *0imp asxnot consumce deprecax@ war ris_Null$Faaif type(dTer)._j_ == 'imp'/A_-g6K2Trupif isinc,) B# Not a validl1runEclJ#|%()help as we want to allow compiled files code, fname = _get_`_from_+P(run_a, path )?return _%amodule?(D, init_globals, $I> 1pkgh= , scriptUelse:P# Finder is defin!or, so add it to3the start of sys. .insert(06try# Here's where things are a little different l "FMpcase. TL, we only had to replacd"e =0 inQ whil Npode wasning and do !sosomewhat optional.| Lhave no choiceJ1we @movesCevenPwe re+heM6@. Ifdon't do< s, a __loader__ attributetGPexist__main__`may pr`t loca|3new'.1modv,p_spec, .bmdetails(with _TempM'R) as temp_@9, \{= _ModifiedArgv0()q,n( =Y.`.__dict__frQ  B ;g).copy*kfinallG Xc re^ except ValueError1pass if _Tt__ == "7"2Q# RunG phe nextamIline argumentpif len(argv) < 2[print("No&7ule_for execu!",=Gbstderrg 0del.i[0] # Mak requestedi$ys(!as@[0]) """A gener useful T@scher class. Each instancek"is manages its own queue. pulti-th'is implied; youHqsupposehack that yourself, or a singl*per appli is parametrized two funcPs, onShat is HP1curItime1 1 e) a delay. You canPreal-I bby substitu sleep from built-in module time, or you can implement simulated% by writing,r own functions. ThisBalso be us;o integrate schedulCwith STDWIN events; the delay X is allowJamodify(Pqueuev0imevq`expresv1as v0ersAfloapoint numbers, as long itlconsistent. E are specifiedtuples (;priority, a `, arguA, kwargs). As in UNIX, $r 7 mean highe;6wthis wamaintainedaTPExecu0 of6 jklv`, pass it8 sequence"p" (remeUP thatPython, multiple\ 6sZbe packed5$a `) and keyword parametBin "Wc". Thev_@ may an instamethod so it has anothVqo refer@privdata (besides global variable@""" +1ort heapq from collePs imp*Qnamed?0threading4S-monotonic_ __all__ = ["Mer"] class (f!('@', '@,"')): __slotsm] def __eq__(s, o): return (s.`$s.s) == (ooJ/ltJ/< JeJg>g>Aa.__doc ('''Numeric type compatible TTvalueW*X4tructor.''') Xsaed for*2samUP willeQed in"Sorderiu sHbE9$(*dR, **k a @ hol@posiP'al}{ ge!di!9arygd  _sentinel = object() #: rf __init__(self, timefunc=_ q, delay.sleep): """Initialize a new instance, passing theYB andRA[tions"""self._queue = [] lock = threading.RLock()'^* !" =. $def enterabs(, priority, ac, argument=(), kwargs=_sentinel*ER%event inat an absolut1.mpReturns#aID for:Gwhich can be used to remove it,Dif necessary[{#ifE is GU = {}[0= E(|- *Pwith j ._ q`heapq.Apush!, yHr' # The IDFA  A variant that specifies as a relativ@Thisiactually7more commonlyi:Ofacej=@ B() +g0 HFclGB"""R{#anAfrom@must0pre8;Red by1().!IfUF*noR0, t`raises ValueError 4.Z(xz1ify )2mpt Check whethe.e3.5 1run0, bling=True@Execqs untilo OrFalse eFscheduleds due toBexpire soonest (if any)6Sthen Odeadline oDVnext iDcallfWWqeaa posiRfirstWeq)qFt$ed4:lef;EoAwise\3j*d A[ZdDC(its ient). If  &the delay function returns prematurely, it is simply 9restarted. I)legal for both f1andau?to modify& queue or to raise an excep;?s are not caught butJscheduler's state 5insDwell-defined so run() may be called again`A quesable hack0Paddedallow other threadsErun:xjust after1venKexecuted, a@of 0^%toFavoid monopolizingCPU when%6als?@runn5"""^# localize vari*a accesPminimoverhead8o improvef safetQlock = self._ Aq 5 #Htime"!pop = heapq.5popwhile True@with k!ifxqUbreak_, priority,  , argument, kwargs = q[0]@`now = F-()!!ifo > now:! = @;els7]False8"Zpop(q"if>b>ing!Rr- x  % y&(*y"**{ >d0) # Let`2runs@proper0def10ue() """An ordered list of upcomesE amlauples `fieldsam sn3 2Use/Asortc3 raPan us'"!ed!._&5)'.0# WLyrq, two  2d aaBsamewill show inIgbactualCpy wouldpretriev(o (&[:}Q(map(B2, [@b]*len( ))) """Gener{cryptographiZy strong pseudo-random numbers suitsfor manag``secretPch asount authentica, tokens, and simitlar. See PEP 506 for more information. https://www.python.org/dev/peps/pep-0506/ """ __all__ = ['choice', 'randbelow', 'randbits SystemRandom', 'token_bytes*6hex {urlsafe8compare_digest] import base64inascii from hmac ) P $om"` _sys 8 = @() 4 = &D.get! c1a def 'E (exclusive_upper_bound):?"""Return a2nt in thege [0, n).q?if RR <= 0V'raise ValueError("U~ ~ must be positive.")r_  DEFAULT_ENTROPY = 32 # number of C to ^by default+-&!(n_=None#$ string contain *=*q!. 5If Pis ``[`` or not supplied,easonable: is usedPH>>> 16) #doctest:+SKIP> b'\\xebr\\x17D*t\\xae\\xd4p3S\\xb6 2bP1\\x8b'+= }i`)y3hexw Ctextw,hexadecimal3The!F hasy"oma, each `verted1twohex digits. G'f9bf78b9a18ce6d46a0cd2b0b86df9dapb.hexlify())).decode(''$@URL-R B- encodingq4 0uDrmhze6EPcv0fN_81Bj-nAkYtok =Y.rA_b64 e0).r;np(b'=' """Selectors module. Thi- allows high-level and efficient I/O multiplexing, built upo1 `sa`_Q prim0s.  abc import +ABCMeta, abstractmethod from collections import namedtuple#D.abc'Mapping 6Dmath seTys # generic events, that must be mapped to_plementa-specific ones EVENT_READ = (1 << 0)UWRITE 1) def _fileobj_to_fd(): """Return a  descriptor object. 5ParametersE9bobj --D- C7ileS?q<corresponding?0Caise/ValueError if the mis invalid1"""if isinstanceS, intAfd ={1obj6Belse6try 04intP.Qno())>#except (AttributT, Typ <r 2("I": 1"{!r}".forma"))ANoneif fd < 0 7: {adrOafd SworKey =X'('P', ['Bobj', 'fd% ydata'])N.__doc__ =MU, fd,jC)MO2 usmassociateOpts backb", "edg mask, and attached x .  if sys.version_info >= (3, 5Q7obj 'FKregistered.' <d7Underly];u?E waited for on thisW`('''Opal opaque*  YFor exampleBis couldC@storper-client sesxp ID.'''tclass _9(3"""8 ofsor keys.dt_init__(self*#orWN%._C=N"orE3lenD:a1len^E@._fd3keyFsgetitemJ,7objS .Hdlookupj ;A[fd]&-%1Key( is not None def __iter__(self): preturn ._selector._fd_to_key) class BaseS!Q(meta=ABCMetaX4"""$ abstract base .!. ~$A j0 supports registering file objects to be monitored for specificNI/O events_AR is aRdescriptor or anyd with a `7no()` method.`An arbitrar20canattached2theg, which *AusedNpexample6s context information, a callback, etc<[use various iUAmentA s ect(), polle A...)`dependt0on @plat. The default ``Q uses0AmostJefficient Y@curra62"""@.z5def!f,aCobj,, data=NoneC"""RNC$Parametersaobj --h"or?Fw 2 $to (bitwise mask of EVENT_READ| RWRITEN5-- Y"RKey instance/Gaise.ValueError ifC binvalig5Key&Gelready2/OS1`closedmQother is unacceptabNIpunderlyasystem x (if a is made)FNote0may0notr~T NotIS!edf$un  U&DQ/,?"ed5 x!If6Pied but has since been (this doesb*not* (j'pwrapped->QljmodifyjChange a> ts @ents -- events to monitor (bitwise mask of EVENT_READ| WRITE) @data -- attached  "Returns:SelectorKey instance/Gaise.Anything that unregister() or r9f5""" Wself.;vfileobjr (S&, events,)@abstractmethodj0defB@ect(I, timeout=None)"""Perform the actual:ion, until some0ed objects areszPready aq expires.%ParameterZe -- if<> 0, this specifiesmaximum wait-E, indsecondsg"<=he() call won't block, and willLareportcurrently +;0is ,paMm becomes} @list]D(key_1) fTH`` is a ) NotImplementedErrorQclose CtsdT5qmust be!ed[ake sureany underlyresourceofreed.Fpassqget_key, btkey associata8 Y@.#@mapp=` f.Fmap(y4if $PR!me$('3&d'Q;tryBf[Eobj]except Key_ =T`("{!r}w7notC ".3at(]q)) fromZ/0 j% a!of toTIo keys. __1r__F} c__exit-w, *args4.() class _Basel(>0"""iQation%inA&#Bmaps%descriptor E-self._fd_to_key = {} # read-only mapping returned by get_map()2Pself. = _SelectorM;(!) ,def _fileobj_lookup#, !):(A"""Ru! a descriptor fromrobject.a9This wrapslto_fd() to do an exhaustive search in caseBthe \ is invalid but we still have it;0our,0. ERis us6unregister() soFFcan qEthatDwas previously Fed even ifs closed. ItEalsoD ."5""" 6tryS O8except ValueErrorF?# D|mpfor keyV;._fd_to_key.vZ's(&1 if4. +T%fdw# Raise after allr(w ,ts, data=Nonesif (not$`) or (ts & ~(EVENT_READ | gWRITE)C3("IM: {!r}".formatb)Ao$= CKey(>#,  )Qd 1Key1 (" (FD {}) al ,dU[0] =, "  ;[ t2.po.)\U">0is U%ed^B jmodify  [V]U#if! !.8fM %LV 1lif}* # Use a shortcutpupdate 1 _replace(%=z self ._fd_to_key[key.fd] = key areturndef close(self):,O.clear() map = None O|get_mapQzX6map1_from_fd6G, fdB"""R0the associated to a given file descriptor.bParameters\fd --43r0correspondingA, or if not foundt5""" 6tryy 5fd]4except KeyError@y class Selector(_BaseCImplR2"""-based s70or.~__init__:super(). readers = set00wripregisterp,obj, events, data=0keyIB <#ifU & EVENT_READ_R.add(NF _WRITEGG %un 1B$._ndiscar&& if sys.platform == 'win32'Lcr, w, _, timeoutf$x.Bw<6%%r + x, [NFelse_L \ "isuS max(6, 0#(#f.,3f._JInterruptedRr~6t(rwwfor fd in r | wkCE = 0V$if3 /3'|== l=8Ielf.{&fd( if$.append( &1.)M98# _PollLik   shared between poll, epoll and devpoll selectors.""" __cls = NoneEVENT_READTWRITE0def __init__(self):esuper(). )Eelf. =1() /bregisterb , fileobj, events, data=~0keyXB<02er_YA = 0#ifo6 & %$ >|/N\O0P:try<b.key.fd, kexceptKD%unFF8BraisFeturn keyB1 s < OSError # This can happen if the FD was closed since it#"&9ed.Epassromodify _fd_to_key[m#._B_lookup(%)]?Key C(f"{A!r} is not r") fromYachanged = Fal,\ !=2.  }E( H 0X{ )Y 6 1 L.,(;D 6Tru!ifw  z 8T3if  0_replace(=i 2CAfd] Kwqfq|timeoutHis shared betweenB() and eN&()# has a different signature9handling of parameterOj ;;= None  elif timeout <= 0: 5= 0Jelse&,# poll() has a resolution of 1 millisecond, round away fromVu # zero to wait *at least*F)s.7math.ceil(e* 1e3)/ready = []:tryfd_event_list = self._selector._Yexcept InterruptedErrorZqreturn for fd, tI in A$(s 8#if>2& ~EVENT_READA.E2|= &UWRITE"P*Qw Q keu@key_f_fd(fdBy+ke2.append((key/s & key.)M j@ ifRattr(0, '2'):class PollS (_DLike)0"""`-based!5"""10_clx>$0hect.POLLIN${ %OOUT eE - y E&def filenofbk3or.0)(FF,Y[=NoneT0is !LU = -1X #<\`!# ]_j Mn#@r y&-3z7 expects `max`be greater than;# we want/make sure.3t ` )` can be called when noIFD is registeredZmax_ev = max(len5._fd_to_key), 1^ b f j,6_evAv) ready  for fd, event in fd_ _list: ]s = 0#ifF& ~select.EPOLLINGVK|= EVENT_WRITEV?OUTW]READ W key = self._key_from_fd(fd),oif keynready.append((keyK0s &5.)Uqreturn <def close()p"._W2or.( Vusuper() if hasattrSect, 'devpoll'):zrclass DSor(_PollLike"""Solaris /dev/OJector."""A0_cl4.';: $$ %2OUTTD`filenofx L0)Fb+ E2kkqueueKvU(_BasGImpl2""".j-based9__init__6$ U"&orz(5K#{qregiste0f, U4objY, data=NonedF@ /tr 7kev .[=.KQ_FILTER_,? ?jEV_ADD:sontrol([kev], 0, 08_0Hm_excep,un##YraiseD:key0N 5 zE# &)@ILTER_READ,  select.KQ_EV_DELETE) 8Mtry:%bself._Dor.control([kev], 0, 0Mexcept OSErrorX # This can happen if the FD was closed since it#*registered.&Ipass if key.events & EVENT_WRITEbkev = !.k4(>4fd,KQ_FILTERD,mDR~See comment aboveU`returnY 3def$(G, timeout=None)l0 =  -2 iselse max(+ {@# If!0_ev50, kqueue will ignorecA. For cons@nd# behavior with8Sother:lasses, we pr that here# (using0). dhttps://bugs.python.org/issue29255B0max=BA(lenQ._fd_to_key), 1ready = []Ikev_list,}5_ev qInterrupted+ @for piH %L@fd =&K.ide3lag!ifilterb"]s = 0Aif f@NREADQ#|=J*[{\+b# kee._from_fd(fd,. d(#, /&4)U  V(Vsuper().D@) R_can_use(methodW"""Check7!weU"usdp depend@upon`operatsystem. """p# Imple ation ba>github.com/sethmlarson/us2/blob/ma1.pyd) = getattr.Rect, ,iNctor is None3: # select module does not implement method2return False# check if the OS and Kernel actually support#R. Call may fail withQ OSError: [Errno 38] Functione6tryor_obj =Aor()^#if == 'poll'?!Pthat UworksJ-p.-&(0kMelse\`lose e+, kqueue,50dev" f] ac=2Trutexcept C(p # Cho7besag, roughly: #||>>d$. O() also can't aca FD > FD_SETSIZE (us around 1024) if _can_use('r"')DDefaultSaor = K?9 el>=En<>D@\=GPoll:%%or """Manage shelves of pickled objects. A " f" is a persistent, diHary-like5. The difference  dbm databasesL4values (-keys!) in af be essentiarbitrary Python}s -- anything c"2" mcan handleis includes most classtances, recursive@ typ* containw1lotMshared sub-&n e are ordin`stringpTo summarizeinterface (key:"a /,%n  l5): !im2vd.open(filename) # ,I@ (g)anFffixcd[key] = # stor/0 at (overwritl"ld+%if@# usPan exist 6keyPs|uretrieve a COPYS)3raiqm Q# Key5 ch)DNOTEWiA#2ss ,9d*copy*eentry!Cdel B? # delet?JdFsE:#*`flag =fd # true/-fp@listi.keys() # a list of all existing keys (slow!) d.close()!#  it Dependent on the implementation,+[a persist,0dicary may or not be necess.to flush changes to disk. Normally, d[key] returns a COPY ofentry. This needs care when mutable %@ies ted: for exaD, ifgibVlist,0.ap  (anitem) does NOT modifyJtself, as stored iB(P mapp=@-- ib"lyOmcopy, which isdn immediately discarded, so that$ 0 ha effect whatsoever0o%0an {@a waat will aC f, use:/Sata =  Co+4ata To avoidproblem with Q, youZ1pas keyword argu writeback=Truecto shelve.open. WhenS ( =((filename,\0) t@`d keepFPcachem acR, andDm teQkPensurHhat such usageG ` works0intpd. How&S Smay consume vast amount of memorykv2che!itUmake ` very Byou +P manyJ6d'sPfter "it is1: d no to checkJ<i"edand/or30nesxP actu!texAust w 1 at$ llDthe . You can `sync()S llFY@empteC (d.JPalso hronizesk!on feasible). """ from picklQort PRr, Unr& io6"BytesIO impQcolle+s.abc __all__ = ["Shelf", "BsdDb$Db`"] cl _CkdDict(a".MMx)q'Markera d A. A@ attSs raise a ValueError.'J3def<(S*argsc;9('invalid operOe|ds1f')Aa__iterS__len 0gets_ = __delitem__ = keys = closed def __repr__(self):return '' class Shelf(colles.abc.MutableMappingT"""Base 9Pfor s= implementa_"s.PThis nitialized with a d-like object.See the module's __doc__ string wan overview of/interfaceF2""" Cinit ,~, protocol=None, writeback=False,Ekeyencoding="utf-8"#{.! =a@%ifkn:E = 36O_ "& = #cache = {}Z 8/teXQk in .(yield k.decode(h)i3lenE2len=j 6contains;,!@Akey.u 1getsR,eAault+` ifq\ @U[key]0defq__getitem:tryb@valuc. iexcept KeyError=f = BytesIO@%])~Unpickler(f).load(("ifD K 1 = ]o2s0,; `= |(Tp = P,'a.dump(so = f.get>(?del)2deldM ]E-Y Hpasse  .xCtypea, tracE>.+ + Q[.sync )P-lAAttributeError;: Epasszfinally&2# Catch errors that may happen when close is called from __del__ r# because CPython5 in interpreter shutdown.B+trself.dict = _CydDict();jexcept >QNone 64def(`)9if not hasattr, 'writeback'+`# __init__ didn't succeed, so doabotherA1ing;# see http://bugs.p3 .org/issue1339007 for detailBereturnU.&()Async1if -B andVcacheg +u= Falsew#key, entry inMw.items(2Yr[key] =9 T.Z= Truv"U = {}>)ifB0, '  Cb.8 class BsdDbShelf(1""" implementation using the "BSD" dbRface.This adds methods first(), nexprevious laqset_locn"()have no cou`0art{[g]dbm databasese actual must be openedbone ofabsddb"modules "-" routines (i.e. )P.hash, bt1 orB$ rn) Qed tonconstructor1See| 'soc__ strqxan overviewo{h2""" , , protocol=(%, v=,Jkeyencoding="utf-8""##.je', N)g(svalue) =s.-6key0f = BytesIO(9N Uq.decode., Unpickler(f).load()#V[ .1V>.) f = BytesIO(value) ,return (key.decode(self.keyencoding), Unpickler(f).load()) Ddef last6!):[Q", m1 = TQdict.-Of = @ class DbfilenameShelf(1"""' implementation using the "dbm" generic dbm interface.PThis nitialized with?{A forBdatabase.*1Seemodule's __doc__ str:an overview of/l2"""__init__$, , flag='c', protocol=None, writeback=FalseY`import3.edbm.open(n)kf@) 1"""Open a persistent aaionaryt0reaA and5inge parameterunderlying  As a side-effect, an extensQmay be added toB-0mor n 8created. The op!alG0has]R same3pre!ofC*).e*3specifiek>v$on*er< S"""A lexical analyzer 1s shell-like syntaxes.j1# MFdocu<@by E,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 tokenize [lsN Vinay Sajip, July 2016. $os $re sys from collec!sReque $ioS_ IO __all__ = ["shlex", "  Pquote sjoin"] W)K'<  Minstream in p,@apunctu_chars=False):  if isinstance( ream, str): " = StringIO0)*P0nstE is not NoneKWself.P Ft%file = in !?elsT sys.stdin4Upposix = "ifQeof =.*%''(qcommenters = '#qwordcha ('abcdfeghijklmnopqrstuvwxyz7 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_'6+= ('ßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿ .'ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞwhitespacU' \t\r\n $_split = FalseQquote;\'"BQescapb/\\d> <Astat; :pushback = deque(lineno = 1debug = 0Ptokenu gh/sthAsour? ?!ifpunctuation_ A  elk CI;TruK{();<>|&_,  4# _ a  queue used by lookahead logici N+# these X@ add^ecause allowed in  names, args, wildcardsz '~-./*?=?wremove any 5Ufrom F a9.maketrans(dict.=Wkeys(XQ) G: = .Tlate(t) @property8defd(Ebreturn[3WI1sh_?BW, tokGp"Push apen onto T@poppy2getI method""ifJ>= 1print("shlex:y3ings" + repr(Hself.pushback.ap#pendleft(tok) def push_source(self, newstream file=None):48"Push an input > onto the lexer'sustack."Dif isinstance(t7strko = StringIO2)S.l%ap0.in!, ({{lineno)M2 =< kC 4 "VE = 1"ifVdebugS$ifh is not x $(print('shlex:ping to y %s' % @OelseV X(,)J(opIA"Pop 0Tv.close( C,m2) = c1popM ]3opp]@%s, ce %d' \Qu4Zstate = ' 'get_tokenAaGet a X fromNB (or _ t'Fvnempty)hJback 4tokB!.AHZ >= 1J$N"Nken " + repr7`returnhA# No7. .%4rawCreadM\@# Ha inclusions<awhile jj2Dspec$Ahook.>pecSk5pec(XPBK'# Maybe we got EOF Eead?):eof"otg #5eofb+p4vNeither+@ norOelf.!if'!' !=?rawfEEOF") return raw def read_token(self):quoted = Falseescapedstate = ' 'while TrueFJ0if \.punctuation_chars and_pushback @D@next4/ =1e.pop()2;els Hinstream. *(1C6if 0n= '\n'lineno += 1debug >= 3Aprint("shlex: in \%r I see acter: %r" % .&,n)h is NonQ$A'# past end of filB#Ybreak$el0u=`2%ot!cH? # 5'elf.whitespac62, `s"Eu#or-Qposixo6 -mit current Q 5i~continuUcommenters- { |- %&! a`c% = M @word [ '  ^ c2yo_split+ nextchar  if self.token or (posix and quoted): :break # emit current Q5OelseOcontinue;$elstate insMkd = TrJif not nextchar:nd of fil~ $ debug >= 2z,print("shlex: I see EOF!s )")># XXX what error should be raised here?<!p ValueE<("No closing_ationy2 ==a/"ot'/'S5 +=x/zo = ' '){d aaap 0Baescape&R 4dVXdO \{ \@ (1a]a[t d Q_acteraQ# In + shells, only the@e itfT #e@ may*d withinM-s.:Cif (+  4( !3_p+L { )'(= *('a', 'c'  LzBNoneG /whitespac2 print("shlex: I see whitespace in word state") Qself.!o = ' '%1if (token or (posix and quoted):>vbreak # emit current Q5OelseOcontinue;elif nextcharcommentersS%instream.readline(2 }no += 12#u'y~ )P1"F5 " _= 'c'punctuation_f%+= 5notDX_pushback.append(Y> yuK<:g#_escapdi/'ax\5/  1`_splitQ4:f9 )(% rt" XEleftdebug >= 2Lprinontinue result = self.token U = ''"if.posix and not quotedU6:7SU NoneQdebug > 15#if Pprint("shlex: raw =" + repr(q%))l6OelseLFEOF"@creturn Wdef sourcehook(7, newfile)h"Hook called on a !name to beD1d."V$ifH[0] == '"'Q"g% =)U1:-1]B2# This implements cpp-like semantics for relative-path inclusion.Jif isinstance0.ina, str)0os.Cs.isabs( .Tjoin( 0dire)Rdf, openV"r"))error_leaderZ", =, lineno "Emit a C-compiler=, Emacs-friendly ^-message f m1 is #if<<#r"\"%s\" %d: " % (i'no,__iter__(OYn__next-Aget_(K"ifSJ.eofraise StopIteratioU0 dplit(s, com=False, D=Tru@"""S-@ theing *s* us Qshell syntax.""import warnings}. Q("Pas_os0's' .s ()^deprecated.",N8D$BionWxacklevel=2f0lex .whitespace_0 = *x%otPClex.f6erslist(lex) ^_63andUB"""RQ"a wtescapedifrom *;*nA' '.bQ(arg)`yarg in =_find_unsafe = re(r'[^\w@%+=:,./-]',ASCII).searchjs0verF; ofkcs\5"''u!(s%F 4s`# use m"le!s,put single quotes into double quotes # the string $'b isn$d as '$'"'"'b'1return "'" + s.replace("'", "'\@") +" def _print_tokens(lexer):Mrwhile 1 Qtt = "3.ge3!(),if not tt2Ubreak%n0("To : repr(tt)) if __name__ == '__main__'Rif len(sys.argv)$ rshlex()BelseDTfn = F5[1]with open(fn)^f59bf, fn)) """Utility functions for copyand archiv`files  directory trees. XXX TheHhere don'tO resourcee k or other metadata on Mac. import os &sy 4tattfnmatchRcolleerrno tryZAzlibIEdel _ZLIB_SUPPORTED = True except IRErrorL/^Falsen5bz2m O_BZ2k .jElzmak __LZMAm / nfrom pwd Ogetpwnam+!h = Non#K7grpK/grK !K_WINDOWS = os.k'nt' posix = n y)if%! 0 elZ nt COPY_BUFSIZE = 1024 *7 $ 6 _USE_CP_SENDFIL:hasattr(os, "sendj!")kplatform.starts("linux") _HAS_FN<XP, "_f] # macOS # CMD default Windows 10 X2_DEFAULT_PATHEXT = ".COM;.EXE;.BAT;.CMD;.VBS;.JS;.WS;.MSC" __all4 ["~0obj Dmode Dstat 12",1 O 1mov<$rmSpecialFile FCExecr "make_O4_;atsregister6'y/un ecunpack=s><  ~c '# " 9ignore_patternqPchownzPwhich terminal_size",  "SameFileError"] 2# disk_usage is added later, if available on the platform class T1(OS!):\Dpass |(&"""Raised when source and destination arexsame file."""]epecial b trying to do a kind of operl(e.g. cop() which isnot supported 2a s~ <a named pipe)AExec `a comm`could ube executedQOReadQAchive canO:reaKbgistryOPExcepz DBa re/8Awith arl1ing3`unpackw8ies fails_GiveupOnFastCopy(as a signalfallback!ush0aw ()/write();nPfast-P funcTado so.6Pdef _10 _fN(fsrc, fdst, flags3 ,Bular"content or metadata by high-per[Aance~k3) syscall (macOS)2try{ pinfd = .#no2out:dste {v as errXr qerr) #  gposix.F!, G6Z 2err|<!2 " if.errno in { .EINVAL,no.ENOTSUP}]  ?lse7err from None _@send^ W9@0onecmmap-like fduanotherb f n2aYqThis sh1wor`Linux >= 2.6.33 only.'q# Note:hPobj()Wpleft alin orderqintroduy # unexpected breakage. PossiUrisksR zero ##ar1# -@open2"a"(ppend) mod/1srcp may be5ot"(ext3*a BufferedBer ([hides un ain a b-#), ` Gzip8decompresses8 ), HTTPResponse (which decodes # chunks).!- possibly others (e.g. encrypted fs/partition?)7global _USE_CP_SENDFILEAtry: qinfd = fsrc.fileno(B2out:dstexcept Eion as errX raise _GiveupOnFastCopy(err)not a regular z # Hopefully the whole  will be copied in a single call0@sendPQ() is-ploop 'tG0EOFreached (0 return# so a bufsize smaller or bigger thanbactual,pshould make any difference, alsoAcaseH contentDchanges while being Pblock = max(os.fstat(P).st_, 2 ** 23min 8MiBpgOSErroY=7%12:# On 32-bit architectures truncate to 1GiBavoid Overflowm,# see bpo-38319if sys.max" <&32hEmin(230)Yoffset = 0oVFTrueL R0sen25os.U , W", T%, u?; P ## ...in odRo have a more`ormative K2ion;2err4ameAname!%2&& ' if.errno == no.ENOTSOCK"Sfo is platform (probaPLinuxV.6.33Da# does(rsupports between"ys (onlyFdsocket4 z = Fals&- B&-@SPC:`systemd nerr from Nonee # ; up on first and if no data was2d#if06os.lseek(0, os.SEEK_CUR))_  *5err7els^;T>= 0lPbreakA5EOFE7h@ += > def _copyjobj_readinto( , fdst, length=COPY_BUFSIZE)u5"""2)/memoryview() based variant of^g(*ft* must Pq methodtAboths.bxopen in binary mode. """# Localize variable access to minimoverhead=fsrc_readinto = .Wfdst_writeAdst. with memoryview(bytearray(length)) as mv:.while Truen]E(mv)6"if not n8Ybreak, el.2 < 3Pv[:n]sS,(s;els62/ def copyfileobj(a , &,2=0)0"""* data from 5-like object?dst *1#otA = COPY_BUFSIZEl:62 3bufDP<L6buf SyQbuf) zP_same-(src, dstlP# Macsh, Unixif isinstance4os.DirEntry) and hasattr(os.path, 'eSstat']:trysreturn 6.4e.=0(), except OSErrorVaFalse 2/if4;`# All other platforms: check for  L3nam.e.normcase0abs2U)) ==e6a$ctat(fnz#fn !fn$fnUoislinkWais_sym)].S- , *, followc s=lw"""Copya0srcOdst in the most efficient way possible.a,Ifd1 is1set"Vis a symbolic q, a new will be created {Read o51ing it pointsys.audit("shutil.5", ?if <raise SameFilesa("{!r} !re ". at+)m _sw1= 0Pi, fnqenumerate([] D st = _stat(Sfn) except OSError:# File most likely does not exist.EpassLelseM)XXX What about other special files? (sockets, devices... if stat.S_ISFIFO(st.st_mode)r.fn = fn.path if isinstance(fn, os.DirEntry) 5 fn@rraise S+ ("`%s` is a named pipe" % _@if _WINDOWS and i == 0ile_size =  !ifvfollow_symlinksO0_is G(src3os.&(os.read%R, dstUwith openL, 'rb') as fsrc,tdst, 'w6dst?q# macOSHAS_FCOPYFILE3#>try_fastcopy_f&(ftposix._ZR_DATA>`return #_GiveupOnFastCop ?y# LinuxW elUSE_CP_SEND&Ksend_Windows, se https://github.com/python/cpull/7160#discussion_r1954052309/>6_@obj_Iinto$Emin(E , ,_BUFSIZE)K( g^)5@def -I;*, D=Tru0"""r 5 bits from src to.i,IfFSset, s aren't, ed{Aonlyif both `src`GP`dst`8E. If `lchmodRavailableGR(e.g.) this method(Ching1"""4sys.audit("shutil.. ",,!os.Tif hasattr(os, ''1Yq_func,  ='l1;4 C ! CS __\v!st!at2I#X< HMODE 8) s, 'listxatt*r'): def _copyxattr(src, dst, *, follow_symlinks=True7; """Copy extended filesystem M ibutes from `src` to `dst`. |EOverwrite existing<(KIf `` is false, won't be'edD6"""y2trynames = os.list x=)except OSError as edif e.errno not in (.ENOTSUP, EDATAWINVAL{UraiseUeturn@for ks CRvalue (geALDos.sH[HgOapeEPERMTr:J63els g*args, **kw `pass /Ostat metadatathe permission bits, last access timemodificat*1andOflag On Linux, `) also@ies "0N)" where possible. TheTp contenowner, and group arunaffected.m$n$ path-like objects ors given assstrings;!If op 0al 7setaaren'tU(Qed if@only Oboth.?Zsys.audit("shutil.l4", )GS_nop(p~ns=Noneu n#Haa(aka df ==Bt5@(_isS)  s..Bdst)K#ifEQ# use re0uncL"itGplookup(wr.@ getA(os, , 61|# *and* it supports^ Ofn = C4nzt_follow_symlinkKs: return fnQ_nop if isinstance(src, os.DirEntry)Xst = src.stat(follow_symlinks=)SKelse8lookup("<"")g3C@modeotat.S_IMODE(st.st_gTutime")(dst, ns=)aS_ns, 9!),. 4# We must copy extended attributes before the file is (potentially)h# chmod()'ed read-only, otherwise setxV () will error with -EACCES.J_* 6try..M/, D except NotImplementedE[# if we got a+P, it'0Qcause]# *~VFalse%lchown()dunavailable, andP eiZ m1* fD-atF? or/ doesn't i AT_SYMLINK_NOFOLLOWkb (it red ENOSUP. #;rE we're out of options--we suy cannot 7. give up, suppress*P`(whichKwhat shutil always did in this circumApassaif has|'st_flags'7 , D!OSg as wh#0for'EOPNOTSUPP', 'E '0`errno,B)d`.q == get%MQQbreak+ raise defn * CTruea@"""CAdata bits ("cp dst"). R's destinak. 8The may be a directory),IfNf @s wo5#be,red. Thi;resembles GNU's %-Phasource# ay2sam~, a SameFileMboadV1""" ifpath.isdirBYd1os."@join!qbasenam5) ]88 return ds`t def copy2(src, dst, *, follow_symlinks=True): """Copy data and metadata. Return the file's destination. ?M.0 isyied with ystat(). Please see LP funcKIfor more informad8Thez may be a directory),Iftfalse, ` won'tAed. This resembles GNU's "cp -P srcL!".%1"""if os.path.isdir(dstVZUdst ="@join!,basename!))Rk 8S8r#ds;ignore_patterns(* C"""F that canJaused aytree() K parameterP[ a sequence of glob-style vhAare eto excluds_t , ds&!d_Q = []h}5 in*! @.extend(fnmatch.filter(\,A=rIset(H _^entries,',y,_c, %_dangling_,Ts_exist_ok=F<<#if7not None # =,`(os.fs`), [x. kxe]?elsT7!) os.makedirsWVVrrorspuse_src{:y =+jO2 orD0in M7iesfy#in|+continue1src* DyY3?dst33srcobj =0 ifk Z:try$isEL.(M20andb == 'nt'^3# Special checkB# js, which appear aA# but we want to recurse/l^(.$91if @.st_reparse_tagG .IO_REPARSE_TAG_MOUNT_POINTP9= False  if is_symlink: to = os.read(srcname).3if JsKU+# We can't just leave it to `copy_function` because legacylOcode with a customHmay rely on cOtreeNdoing the right thing.-3os.(to, dstz@stat=5obj., followUs=notFcOelse\ignore dangl1 ifflag is on0if {os.path.existsb) and `_`_ntinupqotherwineq occur. 2 will ra%an errorsrcentry.is_dir() py 5#s,,nq, dirs_?I_ok=E ^ Q elS   7# W SpecialFileE for unsupported file types1q# catchd1romrecursiv* so that wtB# corexcept d as s.extend(err.args[0]D%OSF?whyF0appFistr(why))W'trA43$w `# Copykaccess times w@failwfWindowif getata, 'win', None)  +, ifd'orA=a2ors`returnQ def?]ts=False=,0l=F215O 8dD"""R!lyk a^pectory pdestinaB*!. dirs_exist_ok Xdictates whether to raise an exception in case dst or any missing parent directory already exists. .&IfR(s) occur,iError is{d with a liof reasonsGQthe oal symlinks flagEPtrue,bbolic ain thesource tree result>sym0 destina1A; ifE itk`false,Z contents offiles pointedW%byBare copied. I:9!byN doesn'tA]@will be added+Hege!inF2an E!att4endcopy procesYou can se.oignore_dangling_0to q if you@want!Psilen6his*a. Notiis has no effect oplatforms that don't support os.ETB` argumis a callablegiven, iy!isecP`src`ameter, which#being visi byy] ()d `names`DBnr, as returned by.qdir(): 2a(src, dR) -> !d_/ Si?ed recursively) |p-oGfor each Gt1s a@} relative&P Oashould>0notX Q_funcB use\!toD. It l pa ndXXss. By default,n02()U, bute same signature (likkAy())!be1"""sys.audit("shutil.-1", :Adst)+[0canm@src)Aitr:!ventries =B(itr=$ _^()=m=qA=dst6=%s,gk=B=qA SHQdirs_I_ok=P) ifPattr(FBtat_`, 'st_]_ibutes')U# Special handc bjs/@makevm behave like # sym@links for shutil.rmtree, since in general they do not appear as # regular lN.Rdef _M_isdir(entry):v try Qst = &.stat(follow_symu=False)@3return (0 .S_ISDIR(st.st_mode) and 59%file_attributes & J FILE_ATTRIBUTE_REPARSE_POINTKdtreparse_tag ==L%IO@TAG_MOUNTJ)except OSError ~ \_(path\@os.l.K eI3LNK$I)or04 DBelsec I)0is_5 =0os.6.is # version vulble to race conditions aunsafeP, oneM with os.scanS) as 2_itX&ies = list('(k , l, sys.exc_info(@2ntri![]~y 6iesfullnamep^8i % #if$is(I# This can only hTn if someone replaces ?a directory #a *` after call toC`6 ordir abovew TraiseP("CanjA on Qbolic"?$,  >continueNp#MQos.un~LC5H Uos.rmqRrmdir, path, snys.exc_info()) # Version using fd-based APIs to protect against races def _rmtree_safe_fd(topfd, path, onerror): try: with os.scandir(8S) as 6_it.4entries = list(')^except OSEsI6errBerr.filename =7Zo(,!;, s*.areturnA@for Ay in 6ieswCfullsos.path.join( ,/ y. [t&is_dir =.(follow_symlinks=FalseF  Q4Kelse)"f n - uorig_stOstat 8q0 = 9.S_ISDIR(Vw.st_mod7 $l^$, <continue2i pdirfd =Qopen(3,O_RDONLY, dir_fd=k cm ifP.sameIf)7  81 B)Pos.rm\l_7k $>o@<# This can only happen if someone replaP0# a{qectory #a ^ after the call to S#!9 or above.@ Traise("CannotzrmA on bolic "N "."U$ is]~finally_os.close(0$Pos.unkname, dir_fd=topfd) except OSError:'0one@(os.unlink, fullname, sys.exc_info()) _use_fd_functions = ({os.open, os.stat, Nos.rmdir} <=~6upports_dir_fd and,candir in:6 =tat3ollow_sym s) def rmtree(path, ignore_$s=False, 4b=None)S"""Recursively delete a directory U!. *IfX is set, gC are!d; otherwix$if{G6 itAcalled to handle theQ with arguments (,C) where Splatform` impleAa dependent;I3ujAthatP5caused it Pfail;`FJa tuple returned by<. JF@is fW1RR, an 0ioncraised1"""Caudit("shutil.0", 3ci G%c(*args&Apassh&elGH=if HS# Whicunsafe works fine on bytes,9Pfd badoes not.hsinstanc': @th =rfsdecod-<I# Note: To guard agaX @ racRwe usu6dar0# lr()/open()/ff trick6try}rorig_stD!%! E@;ion?7=2JH "fdHO_RDONLY8I1 s.Q.sameb@t;fd)_9_vd_fd(fd!/ K8C~,Jelse#s1ies forbidden, see bug #1669\("Cannot on a symbolic link") except OSError: /0one(os.path.isM , , sys.exc_info()bzfinallySos.close(fd*Felse#+tr0if _rmtree_v(u)2P# syms to directories are forbidden, see bug #1669Traise("Cannot call P on al\bolicVN F#can't continue even if S hook returnsRaunsafeR,L) # Allow introspection of whether or the hardening against # attacks is supported?8current platform ^.avoids__C= _use_fd_funs def _basenamU"""A ) variant which fir`trips Ptrail`slash,Ypresent.:Thus we always get70las@mpon!of,8for!. N!: Union[PathLike, str] 2e.gwD>>> r'/bar/foo'?' X/ /0'-;U&V1"""1 = fs 52sep.%+ +0altCor ' > rsb(sep))move(src, dst, copy=2Recursively 8p a filey1ano@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) semantics} is/Dour /oasystem%n Oris used;O0wisY rc`copiedV0and>K4Dd. SI"ar`recreaPunder/P new x.ofails because5Bcros`The op@al `p` argumaAis a0ablat will be!to"source or it w!ill be delegated to `copytree`. By default, %2() is used, but any function that supports the sameIsignature (likeMp()) canQ!. *A lot mor%0ulddone here... "ok at a mv.c shows a9!ofF}Pissueis implementaglosses overx1""":sys.audit("shutil.move", src, dst)'real_dst =if os.path.isdir(-:L@if _Ufile(M $# We mighton a case insensitive @usystem,\<qperformz`rename2way%2os. Ibreturn0# Using _basVinstead omortant, as we mustcP# ign<Ptrail]PslashQavoidS&%''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 ]ACannve a directorydinto itself?"0.z/if (_is_immutab #+@or (os.accessTos.W_OK) andpDlist  oH,UAplat== 'darwin')B0Permission(("'non-empty3# ]"`: LackVuwrite pr".P"%  Q5P M_9=& 3 js=Truee$rmcJelsey e 7o3 def _2src-@.abssi7.E0if |src.endswith(-7sep3h+aH.sepAhasattr(st, 'st_flags') and st.L in pget_gid(name)A"""Rs a gid, given Proup +A."""if getgrnam is None or$V@%=8try0sul)P)except KeyError5TQif reJais not1#)[2NDu8n u2use /pw;Pimake_tarball(base_ !, dir, compress="gzip", verbose=0, dry_run=0,`owner=0, gh CloggCreate a (possiblyy ed) tar file from all theqs under'2'. ' must be (@ default), "bzip2", "xz",F''P' canNused to define an ,+a@ forarchive thatNbeing built. Ifprovided,6 currentXNDwillThe output4'"d % ' + ".tar", wAplus^"appropriLion extens @(".g3@".bzAor ".xz")yN.gxbDtar_vA= ''>elif _ZLIB_SUPPORTED~.P == ''N (gzP?BZ2O -P 8bz2QOLZMAR /xzO x&seraise ValueFp("bad vv''Aaformatp "supported : {0}".8(K"))i im'sP # l3Pbreakcircular dependencyDT0_ex5 '. %ifT elseY = base_name + '(.tar' + compress_ext archive_dir = os.path.dirname( !) 1)if4uand not:eexists9Qdir):8mif logger is6FNone# .info("creating %s",w)Szdry_runLos.makedir%# _the tarballY $'C4tar',uid = _get_uid(ownerggid(group5bdef _s3_0tar HAE2.%Q= gid_1 = }"0if \%=+:\u\"`returnk!if  O=+file.openU\, 'w|%s' %$_2iona*rytar.add(bas, filter=p@ofinallDcclose(+! }@_ziptverbose=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!=  "+ jx5G'10add{qto it",M6,@withh.ZipFile(J/"wq}=C.ZIP_DEFLATED) as zf@norm|`` if ! !jcurdirP.zf.write(,,2"! #"\)2dir{se @s inzFwalk for name in sorted(dir_s): path = os. P.norm (@joinD,\/))Izf.write(*)if logger is not None,.info("adding '%s'", d&foAfile`A2%ifB isus.-236return zip_* _ARCHIVE_FORMATS = {.'tar': (_make_tarball, [('compress',t)], "unped tar d "), } if _ZLIB_SUPPORTED }@['gzw?] =w 'gzip')],"*-4|Rz0zip/0, [3ZIP?BZ2b_bzip2+ aOLZMAx/xz;xz' def get_archive_formats(!A"""Rs a list of supp . Beand un!. Each elemenFQthe r\ed sequenceya tuple (, description1"""Q}3= [+registry[2])B1 in9~ Y.items()])b.(}]' @`+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.(~): rai0se TypeError('The %s object is not callable' % function) if!isinstance(extra_args, (tuple, list)):26:raiv5 needs to be a sequence'ofor element in 7\1 or len(PV) !=2G 6 s are : (arg_name, value)') _ARCHIVE_FORMATS[%T] = (I,, descripb def unregister_archive_format(KVOdel k EDmake?S(baseJ, root_dir=None, "verbose=0,dry_run=0, owneBSgroupNClogg"""Create an file (eg. zipRtar).G''@the @ of ;Ato cU, minus any -specificextension; ' UbP: oned"zip", "tar!gz M""b !"x Q. Or~dother #edva directory that will* ; ie. we typiy chdir into '@' before*0ing?H2. l1dir~PwheregSstartGQfrom;ICcommon prefixX1alld>k0ies~8andboth defaultH toP curr-Wy. Returns Eh!' n'used whenHSa tarTe. By42userZYX.1"""sys.audit("shutil.",S2dir4save_cwd = os.getcwd(%ifV2if  .debug("changwF%s'"u5path.abs/kK1os.(y%if bcurdiri kwS = {'o3': 2, '#':}56tryR~_info =]except Key~D!VJ("unknow- 'b )  d# =#[0] for arg, val in format_info[1]: kwargs[arg] = val #if2 != 'zip'3p'owner'7 8VSa'group  Y6tryJfilename = func(base_!, rdir, **Q)agfinallDif root_dir is not Noneeif logge#'$.debug("changing back to '%s'", save_cwd8os.chdir(treturn  def get_unpack_2s()A"""R3s a list of supporteds ABing.\Each elemen6Qthe rLed sequence%qa tuple(pextensions, description1""",C = [7PA0], 13])S1 in:" _UNPACK_FORMATS.items()](bb.sort(}XBmats?d_checkBo(s(P, extra_bC?`s whats registered as an\4er. # first make sure no other,[Ifor this\existing_Q = {}4 > /-S30extr'[0 p@[extj;EKj&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 to describe the format, and will be returned by (get_unpack_3s() function.*1"""if extra_args is None:QA= []d_checka opUs(extensions,k,\)<UNPACK_FORMATS[name] =(> , descrim def unregister(T)"""RemovesEQ fromF4ry._del _x_ensure_directory(pathqEQ that`uparent /P of `3` existsx ir` = os.!".da@eif not!cisdir('os.makedirszipfile(v ctJA"""UFd zip `+a` to `/``import31 # late for breaking circular dependency LC.is_ raise ReadError("%(a 1" %)e=! g.ZipFi2tryJipinfo in7. Wlist((d0 = .\sp# don'tract absolute s or ones with ..pAthem?#ame.starts*P('/')<@'..'4x5continuegtarget|@join0, *Pa.splitk"S2ot HvL@[6endg# )Qdata i.read( m/fBpen(n, 'wb'' 8f.write(w7gfinallX7f.close(7U H5zip>#0tar= tar/tar.gz1bz2/xzw \tarobj =^ .o +QexcepA.Tar# 'Dk 4compressedN'un1tarb OB.$8allJ _UNPACK_FORMATS = { 'tar': (['. ], _unpack_tarfile, [], "uncompressed tar 2"),G5zipG G0zip+G5ZIP:} if _ZLIB_SUPPORTED:Q_UNPACK_FORMATS['gz$ =.gz', '.tgz'nJ "g-"")?BZ2b2bz2 &obzip2'OLZMAxx(x((,xzdef _find.pformat(FRname)@for , info in s.items(/3extension2:2[0]Q"!ifG\.endswith(7O-areturn`None uarchive, extract_dir=/",  jA"""U6C an C!. i`` is the1 of ,l/target directory, whereKu2is ed. If not provided,.current workingSEusedP: one"zip", "tar &"&Aor " ". Or any other registeredX-. _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 neo look aters supportedsGx / None: # raise ReadError("Unknown archive format '{0}'".(filename)) func = _UNPACK_FORMATS[2E][1]*kwargs = dict(152])2\u, extract_dir, **P) if hasattr(os, 'statvfs'): __all__.append('disk_usage'm_ntuple_ = collections.d#!(' ', 'total used freK.(.__doc__ = 'T9space in bytes' ._<Uo;;\Free ;w@def q(path):"""Return $  cistics about the given ?.y?<ed value is a P Q` with cibutesXaU' and'', 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! -IJ {Qchownbr=None, group """Change ownerAry*Z8use'Rcan buid/gid or)/v!s,]in that case,Atheyconverted toBpir resp3ve ^sys.audit('shutil.!',"if0is 0V123/or&@mustCset"b_&=g_`=3%# -1 means don't c!it3 ]!-1(#f `eitheran int (the uid) or a# string (the system username) elif isinstance(,7!): $_ = _get_uid%?2if "vis None9 raise LookupError("no such: {!r}".formatZ!) {if group X_A= -1*8not#X, intAgid( u 6 )os.chown(path,3", p) def `terminal_size(fallback=(80, 24)q"""Get aize of = window.IFor each&wo dimensions,:environment variable, COLUMNSeand LINES respectively,)checked. IAdefined andGPvalue`a posiJpeger, idDWhen3 or0is _p, whichTacommon case,vconnected to.__stdout__Abquerieby invokE=os.b@ can becessfully _, either becausedoesn't support7Pying,4p we are ? $a ugiven in Z parameterC"is{# Fz defaults- n"@used by many emulators5BThe Pretur%Pis a bd tupltype os..m1"""p# columQlines1worgs,6try7 =C(os.#['"']except (Key0, V  P0{ nlVjLhC# on\py if neq1ary$if!P <= 0B@ =} G(sys8.fileno()/=3Attribute-9A, OSB:"# Q, closed, detach or oB#)V#unW0 n SEGQ.?if != 8 H" (\,R)) # Check thaBt a given file can be accessed with the correct mode. # Additionally check that `Gp` is no\ di7ory, as on Windows # ies passh2os.} Ur. def __A(fn,): return (os.path.exists(fn) and Q87;$?Pisdir>1) }which(cmdv=os.F_OK |[`X_OK, xS=NoneA"""GTa comman<,a PATH string,eH pconforms to@modeI1IP, or }0 if'"re~Q suchH!. `>` defaultZo0. ` &naresultH ofenviron.get("!")FoverriddenHa custom searj1"""\# If we'reaaD7y part, look it upRly ratherNthan ref ngM-ories. This includes{ing relative53theQucurrentBy, e.g. ./scrip"i"pdirnameD!yic%)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!:' o!if{D1 if4'5fsencode(! =D`.splitw,DBsep)3Oelse^/de^sR+if sys.plat == "win32"h0# T @ takkrecedencF.;bcurdir 4 5> % if]p!inF#.insert(0,/ )1EXTe0aryX T ext_source = os.getenv("PA THEXT") or _WIN_DEFAULT_PA# pathext = [@for 3in _source.split(os.psep) if+%] Lif use_bytes:i4W= [os.fsencode(ext) s]<P# Seeithe given file matches any of expectedensions.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)q&s6cmdOOelse( +7 =B# On platforms you don'things like x0ell+ w6p suffixre executable, so just pass on cmd as-i?A_seen = set()nCdir @norm#= .case(dir=pif not /0in dH$S.add(&>0the /&Vname @join,3 T2if _access_check(Ck, mode.preturn (None imp_signal from  *functoolswraps as _ &Denum!@IntE# _global S() _ ._convert_(!'S`s', __5__,alambda )`.isuppa0QAand 6b.startyp'SIG') : @_wraps(_signal.b) def (num, handlerO: = >(_enum_to_?9), ?)3:B("2, Hx/s)2getc,Mif 'pthreadmask' in _globalsx e 2r `(how, Usigs_setw76Iset(cAx, Ss) for xc ^.__doc__"0 sigpending-}({6()}Owait* h:set7sig 8sig*  r-AY[AvaliOnals 0 t+ Kw5del ", ` """Ap module search paths third-party packages to sys.&O. *,t * This#is automatically imported during initialization. */ bwill asite-specific!to1m+. On Unix (incluw Mac OSX), it starts with<refix and Kbexec_p(if different)#s lib/python/. On other platforms (such as Windowstries each of es directly,5 we qed. The resultEof1, iby exist, are9N, also in~!k configur files. If a  named "pyvenv.cfg" exists one directory above sys.executable, prefix and_re set to thatOnd it is also checked for site-packages (cEbaseT!ndw will always be the "real" Qes of,Python installation). If "pyvenv.cfg" (a bootstrap configur-` file)`tains kkey "include-system-" anything othern "false" (case-insensitive),QVlevel"stso be searchJ;p1wisy won't. All`resultspecificaies, iEy', are appendedQpath, inJt<P Ps m) whose name hascform <3>.pth; itsePtentsP addi(al (per line) tF, q. Non-iwor non-)r^neverLE; noyd<0moran once. BlanksX@ginnwith '#'yskipped. Lines star% 'import*@ uted. For example, suppg /usr/locale$a/lib/pA2.5/n!s three subW, foo, bardBspamf1two: s540bar . AssumeR,Q following: #% )  pletch j0&KKbar Then Bn>areS0, i4is orderkm/t/ -foo Not1t b@omitbecause it doesn't';!Qcedes4+( mephabetically bef 0foo;O is tis not men ed eiO.qP readSb moduldautoma^ en0 co3p"atGrt it. This canoverridden in customize, user or PYTHONSTARTUP. SCPisolamode (-I) dis%s . After thesZe operations, an attempt is made to import a module named sitecustomize, which can perform arbitrary addib0al 6-specific c@. If thissfails with an IError excepT1, isilently ignored. """ 4sys o ubuiltin_ io # Prefixes for-packages; addiDal p+like /usr/local here PREFIXES = [sys.. , Rexec_] # Enable per usew directory # setqto Fals1dis>the feature or Trugforce  ENABLE_USER_SITE = None-distutils.commands.install # These values are initialized byh0getbase() and uM() # funcLs, throughAemain() when Python starts. 6BAS def makepath(*s): dir = os.T.join 2try(,0abs4Q(dir),1 OS7Apass!`returns,rPnormc G @abs_[#s("""Set all __file__U__cachedttributesbsolute Q@m inE("s.#()x,if (getattrm, '__loader__',6)Jq not inO('_frozen_@lib'A _external'Fcontinue # don't mes: PEP 302-supplied3 R%m.W1$(Av,a, TypeQ9 5yremovedup-~! R duplicate entri1rom3b along`makingmraBis ensur0hat-Gv providQinterpreter aDt# only e>s, even if we're runnf dZ.L] Rknown! =1tD=F6athP# Fil7out5$`s (on -insensitive Htems also}i!"ey`differD1); TArelaHcEinto J # paths.#  dir, dircase = makepath(dir)%4if #not in known_*%s:'SL.appendA31.ad!uf@sys.Nq[:] = LSYreturk def _init}binfo()B"""R2 a set containing all exist file system items fromA."""0d =H(1for.x6try Bif o.y s(k!!_,W .)d90except TypeError AinueOUdKaddpackage(siteXname,"""Process a .pth Kwithin the C-Ps3GectoFor each lineJ5E, either comb t XRdir to a ! and add that^ , gxecute it ifbstartsV'import '.O(if is NoneMd- =K reC= Trt7elsFBFals@fullu% =5Jjoin if = io.TextIOWryr(io.open_code(Z)>(+OS&vf%n,enumerate(f!if%.hGK("#"%)  S#("3", O\t")gAPexec(l!3" =crstrip,:Fy0if D9 L 9~s%B} EL>iontqprint("=" p R {:d} of {}:\n".format(n+1, ,c =Wstdery'tracebackHarecordW(_Pion(*gBexc_;9O2in W`.splitsq#P' '+,,# 2"\nRemainderF ignored"FBbrea1if bths = None  return known_paths def addsitedir(,&=None): """Add '(' argument to sys.X if missing and handle .pth files inNG1"""(ify@ is |{ = _initainfo()C'reset = TrueFelseFBFals #, case = makebiif not+iWju.appendH # Nc component5.ad=6tryknames = os.list-except OSError8uC[ Q for !ins.endswith("1")]>0psorted(.s:addpackage ,[ o1if ! =w7check_enableuser(@"""C directoryyAsafeinclusion pThe function tests&0themline flag (=d qenviron,Qvar),Nprocess uid/gid equalLeffective.@ Disd{security reasonsY:)1by F(com opr-0: S9dMPs.no_R_X if hasattr(os, "getuid") eO!#  (I == _ if0getFA() !p(O@g "giIz8gidU, # NOTE:yRconfiopit's deqencies are relaPly large bu module # needs very lim! part of them. # To speedup startup time, we hav'py1 # See https://bugs.python.org/issue29585"Co<2sys ._serbase() /@env_#j.get("PYTHONUSERBASE",94if 9Gr%@joinX(*argrWoq.expand*;7)QF"nt"APPDATA") or "~0ev@, "Python") if sys.platform == "darwin" and_framework: return joinuser("~", "Library",8,8?"%d.%d" %2version_info[:2]) 9m.local") # Same toFconfig.get_path('purelib', os.name+'_') def _*Rbase) =V.$ifQ7B'nt'84f'{U}\\Python{JE[0]} 1]}\\site-packages'e ''a/lib/p/k3E0]}. =1]}LV4get(PA"""R7ps the `  p` directory .T%can be usedtore data. If]aglobal>enablerlcompleFA"""E default readline configurWA on active prompts, byregistering a sy0hook__. ,PIf thqi can be imported,%9P willbTab kev3as 0ionT and 3 ~/._history as dDThis~overriddepcustomize or useror in a PYTHONSTARTUPi1"""_pq atexit36try;'B)except IiZErrorWbreturnK`# Readinitializ(') may not`enoughNUset a~#q, so weone firstAthen_doc = getjpdoc__', ''!ifR;!isNz<'libedit'N* #.parse_and_bind('s ^I rl_e~OelseIDtab:*C@ . _(/OSS# An b couldmany causI1butmost likely one# is tha*0re'^ .inputrc#P(or .c!inW{case ofOMac OS X + )expected loc@. IL0at M<, w@want0ign7F 9 zFpass6.get_currentW_length() == 0u# If nowwas loads;to 0 # T*he guard is necessary to avoid doubling history size at # each interpreter exit when readline was aly configuredIthrough a PYTHONSTARTUP hook, see:1http://bugs.python.org/issue5845#msg1986369= os.path.join( expanduser('~'),< '_\)')6:try<. 9c_file(F Eexcept OSErrorPYpass wdef write^.()7 C5 $# bpo-19891, 41193: Home direcndoes notPsuFA# or!otPable,@the J`system#ei-only.#F= at.register()iasys.__`activeT__ = 7_x venv(known_ysglobal PREFIXES, ENABLE_USER_SITEoAenv qenviron0if &platform == 'darwin' and '__PYVENV_LAUNCHER__' in env`execut@! =Pi_base_3os.y[U]7els A.xe_dir, 5Usplit0abs,(:)sbprefix'.dirname/Z+home = None|0` = 'pyR.cfg'!andidate_+Qs = [1bA for Ein (#'be=z b 2,f6 gq%if is(m $]OJif cqvirtual, =("[0qc_ = "true"0# I 25185: Use UTF-8, as that's what } module useeh#,with open(, encoding='utf-8')wfX Qif '=0% ; key, _, valub*.partition('=4 key = key.strip().lower(&^2j& ifU include--site-packages'?:  system_site = value.lower()4elif key == 'home'\ ._$Z Ssys.prefix = Vexec_3ite4+# Doing this here ensures venv takes precedence over user-{0addpackages(known_paths, [(]){ 6 will process P again if its in PREFIXES,# but that's ok; Xevent anyth beadded twiceM if?= "true".insert(0,6Oelse9) =V ENABLE_USER_SITE = False?hreturnp def 9customize()|r"""Run \ specific code,^available."""2try@ aimportNY&izEexcept I$Error as excQDac.name Apass=`BraisE1ion&rr.flags.verboGchook(*_info() *stderr.write("*inG; set PYTHONVERBOSE for traceback:\nE"%s: %s\n" %j(__class__.__t__, err))AA#A7NqrA MA AeGmain4Add standard-wdirectories to the module search ?.TPfunctis called automatiby whenmI2is "ed+0unl\lpython interpreter wasrted with0-S .""" global ENABLE_USER_SITE orig_path = sys. 1[:]Qknowns = removedup#1s()#'ifB!C:a#9 might makes absolute.9,fix __file__ and __cached__ of already imported modules tooG2abs"() Wvenv( / is None "= check_enableusersite*dd = add packages 3O/ssetquitpsetcopyrlchelperaif notflags.isolatedrlcomplet;@execcustomiz-ifhM0xec5 # Prevent extending when python was stapwith -S0 #  =r. 0no_,@maindef _script())q = """\`%s [--e-base]N]Z Without arguments print some useful informationX4 1the value @BASEA/or ` separKby '%s'.Exit codes +C or P 0 -rMdirectoryWdg? 1)0disAd byL222Xsuper8Aor for security reasonsZ>Zn*a error1"""0argMcargv[1 x_` = get-?"A=* ("y/V = ["adir in}"? %r," % (dir,)Ca]V0: %r (%s)@,["exists" u.isdir(1) else "doesn'Nist"yy'y1y  ?cexit(0`bufferCif '$5' /2.append(vd??<2if `osep.join(&USER_SITE:  sys.exit(0) elif ENABLE_USER_SITE is False:(0@1@?Non?2?e3&eimport textwrapdprint(.dedent(help % (argv[0], os.pathsep))c 0) if __name__ == '__main__':_script() #! /usr/bin/env python3 """An RFC 5321 smtp proxy with optional"1870 and 6531 extensions. Usage: %(program)s [@s] [localhost: q[remote `]] Opx1s: 9--nosetuidn@Thisp generally tries to 6 `nobody', unless t8uflag isMset. The7call will fail if8}not run as root (iwhich case, use<t$).0ver>!-VP%S the !q number}Aaclass B+-cSUUse `('`concrete SMTPI"xy=. Uses `PurePA' by`Oudefaultsize limit#'-s 0Restrictatotal 3oSe incoming mesF"O"!ofZMbytes viaNFSIZEB. D 33554432 =qmtputf8\!-ucPEnablFUTF8[`behaveHa@@cQdebugY-`Turn on gG --5h%is(VL#__8__)s If thPgiven@5n `'Qused,i8Gnot 8@80251b. If g i9h h,g # Overview: # # file implemente minimalPtocoldefined it # has a hierarchy of2es d backend funcality for! #RVd. AP0aretRvided Server -CR base2Vt`. RaiDNotIedError # pyou tryR1it.30bug{ns"y U eachhit receivesUstdouJ#0 - +|:@a reCmtpdHdoes final # jdelivery. One known problem with this class is that it doesn't handle # SMTP errors from the backend server at all. TVshould be fixed F(contributions are welcome!). #$MailmanProxy - An experimental hack to workCGNU 5A. Usingss your real incom"asmtpd,I"mailhost will automatically recognize and accept 1 destineds when those created. E message notOQfor a5gets forwardmab"as&APureT. Again,Nnhd correctly yet # Author: Barry Warsaw 3@__q.setterEdef (5, value): warn("Setting. $?set!" = @propertyAdata Access to __&%qeceivedJ%D@+%=Afqdn &%AJ; +%A4Apeer &%A; +%A4?con&%A; +%A4?add& on SMTPChannel is deprecated, " "use 'addr' instead", D0ionWarning, 2)9return self.;0@__ q.setterBdef (,, value):warn("Setting+ attribute on SMTPChan?set" = # Overrides base class for convenience.,Cpush7msgasynchat. _ -abytes(G msg + '\r\n', 'utf-8' ifmrequire_qUTF8 eltscii'))Implementation ofabstract method~collect_incoming_data limit = None@smtp_state ==vCOMMAND0Emax_command_size_\/el^ODATA[T1if eB andAnum_" > V B 'Kp+= len(Aq_decodekF received_lines.append(strO)YI/# 4"found_terminator/ )3ne _emptystring.join-.print('Data:', repr(), file=DEBUGSTREAM5| RQ = []uy HE  too longmethod = getattr(self, 'smtp_' + command, None) if not method:&J.push('500 Error:PQ "%s"?recognized' % iNireturneyJ(arg/ +Jelse1if state !=JDATA-}.451 Internal confusion'4num_bytes = 0# data_size_limit andR> * 4552Too much mail E6# Remove extraneous carriage rs0de-!sparency according*# to RFC 5321, Section 4.5.2.*Y = []for text in line.split ._Nsep)7"if6z?S[0] =&~_dotsep5.append(9>1:]< @ <received_, 0new`.join( :0argRpeer,ACfromtrcpttosj P#kwR){}pq_decode.B A'0_op6s':,7#77 u+%erver.process_message(*B, ** >_set_post_[*e((0^tatus%G|k250 OKI6sAus) ,a# SMTP}E sAdef AHELO( , ^6argo'501 Syntax: H hostname xB# See issue #21783 a discuse of this behavior7seen_greetin 3 Duplic_/EHLO rW  ==! %sCfqdn1H # See# issue #21783 for a discussion of this behavior. if self.seen_greeting:& push('503 Duplicate HELO/EHLO')1ereturn@`_set_rfstate(2 j = arg@extended_smtp = True"250-%s' %Ffqdnkdata_size_limitMWSIZE R <]+wcommandas['MAIL'] += 26bif not_decode_` 8BITMIMEuenable_SMTPUTF8G %G%10zAP') @def `_NOOP(),) ifQ501 Syntax: DOelse8m250 OKOQUIT#s is ignored w221 Bye.close_when_don=t_strip_skeyword keylen = len($b0"[:&].upper() == , [31:].~$&''_getaddr:arg+ar%HA, ''A#.lv.startswith('<'W-tess, rest = get_angle_(Y$ >ddr_spec=w245ddrNv9._ BcparamsD 1# R%  as dictionary.TNone "ll-Ueters# appear to be s0 ctically valid according$RFC 1869Presulp%{}VA2 invs'P, eq,eBue ='`.parti7('=-;.isalnum() or eq and Kvalu<z[T3] = ifS$ (F?HEL = ' [SP ]blc_arg 4if $1= 'U rFs250 Syntax: EHLO hostname') elif lc_arg == 'HELO':#.self.push('250 Syntax: .ZOMAILZimsg = V* FROM:

'1if extended_smtpd4+= * KH?msg  ORCPT*? TOODATA . /SEQR.Q ONOOP.Q ?QUI.Q OVRFY. [.se= 501 Supported commands: EHLO2q('  3  ,ell'@def _(~f, arg)# if(, params =@_get(B_-E\ Iu2 Cannot* user, but will accept message U'and attempt deliveryz$~502 Could P%s' %VG C1c #WVseen_greetingL X'503 Error: send[firstareturnprint('===> ' , file=DEBUGSTREAMs0errW;:?WOZ+= ' [SP ]brg is NonU cstrip__keyword('1K address, params = self._getaddr(arg) pif not Eess:7push(syntaxerr9!ereturn4L7extended_smtp andb.^mailfromN'503 Error: nested MAIL command' bp_optionBK.upper().split(Fj(L4#if is None}_decode_dataVcbody =y.pop('BODY', '7BIT1if 1"Bin [$, '8BITMIME']_6D'501f can only be one of v%, PKdaenable_SMTPUTF8tKutf8-', Falsem5if 8kis Tru|frequir}! =.)+elPDv ,U 2 takes no argumentsD 'LsizeQIZE',j+izize.isdig _a_limit'@int(2) > % D'552qmessage L exceeds fixed maximum #Srif len(p.keys()0"55wBFROMt@etert recognized orPimplee$ = prE 'sBr:',H4, file=DEBUGSTREAM250 OK') W"deQ_RCPT,)5seen_greeting#b HELO first');v1 P===> ' /ne:'1 = S:c TO: '5 2 Gerr += ' [SP <-T!>]R if arg is None: self.push(syntaxerr)!ereturnaarg = 6_strip_command_keyword('TO:', argIaddress, paramsB0get(-pif not ?ess+Lextended_smtp andb+[rcpt_option.upper().split((L4#if 2# XXX currently there are no we recognize.rif len(.keys()) > 0H'555 RCPT TOQeters`Ad orimplemented'r-tos.append(48print('recips6, file=DEBUGSTREAM9('250 OK') @def AQ_RSET ifOQ501 Sl : D`_set_rWstateKXODATAgBseen_greeting 3 Error: send HELO first'); +/to5'50eBneed9d+ xM Amtp_s9$et_terminator(b'\r\n.a*N 354 End data with . k2# C\s that havwt been )OEXPN@502 (s class SMTPServer(asyncore.dispatcher)&#'Channel 9to use for managing client connec'c9_9=Mn__init__Plocal, remote O{a_size_limit=_SIZE_DEFAULT, map=,>penable_UTF8=False, decode_\v__5 = `$' = &d! =3 /  = enable_SMTPUTF8  self._decode_data =  ' if enable_SMTPUTF8 and+:,4raise ValueError("V; Oycannot"FJ " be set to True at the same time")Aasyncore.dispatcher.__init__(, map=map4:trygai_results = socket.getaddrinfo(*local,z  Stype=QSOCK_STREAM9.create_,([0][0], *1]EP# try2re-use a server portpossible{set_reuse_(X"Ubind(!listen(5jexcepthL[closeeIJelse9print('%s startedp%s\n\tL ": bRemoteu%s' % ([o__class__.__name__,_ .ce(.>())1, rq), file=DEBUG}def handle_ac#edQconn,)Incoming %ection from _repr(xpchannel+ 3+_size_limit;O_map0 ;B!) 5# API for "do`someth useful withrmessageprocess_P peer il, rcpttos, $, **kwargs, """Override this abstract od{ ksETrclient. E` tuplez@tain1(ipSA) ofB that madEnto our smtpH{"ma1raw8essjRclaim1)=[F) a `eP@wish`o deliE&thu'toa^0str-4con8entire full textMheaders (if supplied)L#all. It has been `de-transparencied' acco+rding to RFC 821, Section 4.5.2. In other words, a line pcontainFa `.' followed by9text has had the leaw5dotHremoved. kwargs is a diHary q0ddial informaEt isI'empty if decode_data=True was given as init parameter,6wistit willUkeys:u'mail_ops': list ofesz) command. AllIMelements are uppercase strings. ExampleB ['BODY=8BITMIME', 'SMTPUTF8'].W'rcptsame, forThis fun should return None@0a nl `250 Ok' response;K, itI>`desire\: 4 inK&f5"""raise NotI=bedError class DebuggingServer(0 "):def _print_message_ent(self, pe])inheaders = 1i-a.split%()" $# WFfirsm6if vqand not'I = 'X-Peer: ' +5[0].!ifOisinstance(,*#dfalse; makeb match@ bin ZoutpuP Vrepr(0.en ('utf-8')P>2"<9= 0# Avoid spurious 'str on byte@P' warf 1 = (tprocess `from, Rtos, "**]%'- MESSAGE FOLLOWS &-'2if K kZ.get(=u} ds: %s' %^[C]? nn'n(\npEp.c=e-- END^%')PureProxy ____(self, *args, **kwargs):  if 'enable_SMTPUTF8' in )C and [']FMraise ValueError("PureProxy does not support l5.")esuper(5, self).__init__(* :def process_message(9, peer, mailfrom, rcpttos, dataqlines =.split('\n' # Look for the last headerUi = 0*VIs*!if  JUbreakJei += 17 s.insert(i, 'X-Peer: %s' %6[0] = NEWLINE.join(D#refused =s._deliver(<# TBD: what to do with Paddresses?2print('we g2ome.bals:', ed, file=DEBUGSTREAM)[!imtusmtplibE= {}6try9~:.(7.connectu._remote2[0] 1@ p`s.send:kfinallgs.quitxexcept RecipientsRJas e 3'5e.rq1(OSE,E_ion) ', e.__class__ f# All C werqed. Ifion had an associated0# e code, use it. Otherwise,fak*a non-triggeringKO.0errd = getattr(e, '_Z', -1oerrmsg1', 'ignorerB "s[r] = (, 6msgdreturn1  Mailman+ hwarn('P is deprecwill be Yved 'W 'in future', D;ionWarning, 2>I A%lf).__init__(*args, **kw 2) def process_message(self, peer, mailfrom, rcpttos, data): > io import StringIO^ tMailman%_Utils" M$ uailList%# If the is to a ing list,*n we'll invokeM6 script directly, without goMpthrough= real smtpd.IOtherwisenforward itPlocalxy for dispositionInames = []`04 in]=.lower().split('@')[0L/# We allow fo PvariaAs onUtheme= ^o-admin_ownerWreque x?-jo^ Jleav@partU)9-')qif len(,Z) > 2ezcontinu]1 = < o X/==YUmmandC1Oelse5,''Anot ._exists( r) or co?+Iin (CQ'', '   v/')5s.append((,[,)q# Remov) recipients D@tos K@whatXre noKo take care of ourselves. Linear rvhould be fin`# sinc don't expect a large number\sX.e<(&0re' `y non-I destined9Uleft,sprint('= s:0 '.otos), file=DEBUGSTREAM!if,toPefuse._deliver( q# TBD: Qto do# rTaddresses?6bwe got-!al9 c# Now #4istmmp%{};(bcmsg = .&(sL# These headers ired for the proper execution of Mailman. All # MTAs in existence seem to add these if original message doesn'tN@have,%m.if not msg.get('from'): `msg['F] = mail&# COdateCDC`time.c(.5())R for rcpt, listname, command sprint('sendingCto',Nfile=DEBUGSTREAMrXs  ) GTList. (0N, lock=0V<$s[),m %# dispatch onP typeF$ .%if;^== ''V# pos'cEnqueue(@, to*=1+eld_adminiR-S_ownerS-SrequestU/W in ('join', 'leavY# TBD: this is a hack!' UW*Subject'4'subscribe'WOelseG/unI& class Opsetuid = True% = 'PureProxysize_limit = Non2enable_SMTPUTF8 = False def parseargs(wglobal x6try`opts, 6 = getoptAopt(-f sys.argv[1:], 'nVhc:s:du','!['="no aversio@help([debugH 'smtputf8']tdexcepterror as uq(1, e) o$ =(Keod0argV`if opt@('-h!--Vo;V; >#__"__Yo_exit(`M%--f a.+] c J1argcKdK): DEBUGSTREAM = sys.stderr elif opt in ('-u', '--smtputf8'):*1options.enable_SMTPUTF8 = True+ UsUprint('Cannot I" "J "; try running with -n op" asyncore.loop(KeyboardInterruptpass #! /usr/bin/env python3 '''SMTP/E client class. This should follow RFC 821 (0!),a1869 (BB2554# AuthenticaQ) and52487 (Secure M over TLS). Notes: Please remember, when do[q, that the names of Rservice extens are NOT$psame thL!as keywords forPRCPT MAIL commands! Example: >>> import smtplib#s=.("localhost"7Qs.help(){is Sendmail ver 8.8.4 Topics@HELO"EH0 CDATA@RSET@NOOP1QUI1HELCVRFY+@EXPN#@VERB1ETR DSN For more info use "D ".1 reqbugs inOi4Amentq send e#to{-8@@.orgW{F|/rmH Postmaster at your site?0End( .putcmd("vrfy","someone@hereslQreply(250, "SomeOverHere <>?0.my>G`quit()@ # ( or: The Dragon De Monsyne # Bet=compliance (_`,k@CRLFSdata)fby Carey Evans ,f`picky  bers. #)LaG by Gerhard Haer". # # Uwas modified fromP 1.5 library HTTP 4. Tocket$io $re j.utilskmessag(generator,dbase64Dhmac Dcopy udatetimMAsys ~EDmime2_en"s _( __all__ = ["E@ion"rMTPNotS`!edServerDisconnectedResponseL"SMTPSenderR efused", "SMTPRecipientsRDataError", 5sConnectIIHeloAuthentication Kquoteaddr @data @"] _PORT = 254SSL465 CRLF = "\r\n" bb_MAXLINE = 8192 # more than 8 times largerRFC 821, 4.5.3 ?CHALLENGD'5 # Maximum number of AUTH challenges sent OLDSTYLE_ = re.compile(r"auth=(.*)",I) # Excep. classes  by this module.  11(OSb!):br"""BaseG for all e_s raisedZG""" ^NotSupported^(tlThe command or ois not sCne server. T% iwhen an attemptmade to run avaK@with:Pwhich? SBDisc/edENot %?any3the unexpectedly ds?or  uskinstance before'aing itw. Responseo u that includeE edU code 8eseare generated in some s9P returnskf Bstor\"th!``smtp_'~`ributei= , ,-i a)# messagejxdef __init__(self,S, msgj'.! =%k k=> args = (]cSender  2"""- Ress rA Ini0to 2attHQby on h"s,qsets `s'Y0str`P g ,3der/o.# =[Y  """All r~!reErefused. :The errors for each recipient are accessible through the attribute 'r4s', which is a dictionary of exactlyAsame sort as D SMTP.sendmail() returns.A""" def __init__(self,1s):$N.7s =' %0arg(-,) class PDataE$(ResponseExcepu0"""M# server didn'tB!ptQdata._Connectb% during c9ion establishmentaAHelo9refused our HELO replyZAuthentica d 3|.Most probab$Husername/passwordacombinHWvided?;quoteaddr( stIQ a subsete 0 esses defined by RFC 821Should be a/o handle anythK.utils.parsC can*pdisplay,? = B Mif (>) == ('', ''f'#  it, use iqnd hope-BbestK!ifW.p().startswith('" %#9  _X_only Sa)soV@=!ng  # Legacy method keptbackward compatibility.|(2"""C\0Dou@lead'.', and change Unix newline '\\n', or Macqr' intoInternet CRLF end-of-7 re.sub(r'(?m)^\vQ'..',K(!`:\r\n|r(?!\n))',f , #))_periods(bin\wbxby 0Mfix_eolsJE FE R try0impQssl eT! IO#_have_ssl = False elseITrue#2is tmanages a connection to an SMTP or E server. Objects:o have the following attribute48helo_respJqThis isHmessage given by@ in @@onse=theK most recent HELO command. +/eh\'EH usually multilinedoes_esmt4 a True value _after you dwP_, ifO _supports  _featuresCAa di]ary, whichw g,KOwillpcontain names oice extensionl,isP, andS-irparameters (if any)"JNote, allkare mappedlower caseGg'See each method's docstrings for details. In general, reaaA5Q samerperformi?DS TheJMlso Ocalled 'sendmail' that Aenti il transa.pB1"""debuglevel = 0sock = NonHfilebpmsg = " _ +otdefault_! =R_PORT def __init__(self, host='', 2=0, local_= timeout= et._GLOBAL_DEFAULT_TIMEOUT9source_address_) """Initialize a new instanclIf specified, ``0(aremote*1 to.0con\ R `d~e!F >O3By  , @lib.BusedmaK\9<@if i7Pturns thPothernsuccess code?CPError\5raiY`k" aDFQDNs+n/POAwise|=name is found using 8socket.getfqdn(). The `source_address` parameter takes a 2-tuple (host,Pport) for the ^ to bindras its ` `u beforeEconnecting. IfJhost is '' and g!0,OS default behaviorMwill be used. 5""" aself._c =  timeout = esmtp_features = {}! command_encoding = 'ascii'(u# =& -_auth_challenge_coun0!if:9(code, msg)bo[)30if 5z != 220OS?jclose(9raise SMTPCWErrorkif local@namenot Nonevr -=>X;els? # RFC 2821 says we should%Q 1 in EHLO/HELO verb,\0# ipat can' calculated+atba domain literalOnstead (essentially an @Ued IP9like [A.B.C.D]).JF  $`if '.'. fj, Gd=C# Wef0an :A, sos J)7127.0.0.1;>try< by()cexceptP.gaienIpassF'[%s]' %def __enter__(7)gpreturn  .3xit-w, *args4 , messagedocmd("QUIT" 1ResponseE-4ionkWNServerDis*edb M0fin  " .|xCset_debuglevelH&,  a"""Set output 9/ A non-false value results;:Ts0ion0&al,nd received froms  {' = print_debug(self, *args): if self.debuglevel > 1 'print(datetime. `now().#()Z, file=sys.stderr)jOelseX89def _get_socket(, host, port, 7out # This makes it simpler for SMTP_SSL to use the connect codez# and just alter/1ion bit.4$if is not NoneI  raise ValueError('Non-blocking r(<4=0)[0sup6ed'h0qG!.__#(': to', (c"),"source_addresspcreturn.create_NJion(K,0h  |>hp='local'$J=0, A=2C"""CAto a` on a givenj!. u!If c#name ends with a colon (`:') followed by a number, JRtheree specified, that suffix will be stripped offIMa interpreted as"[SNote:3Pethodautomatically invok__init__, if*%is@ durinstantiationv6"""Q ^ + = Mi#p.find('!==%.r -i " {f i >= TuDB[:i][i + 1:]K4:try=( rgexcept8H^"OS["nonnumeric"X!ifm Jr)`fault_audit("smtplib.">q$ck]LCivp! =e(d, msg)Zgetreply(~vB )', repr(fUCsend"""Send `s'pserver.%$send:', repr(Ss)) if self.sock:if isinstance(s, str)#'# send is used by the 'data' command, where_encodingpMhould not beST, butQneeds to convertmstring toPbinary it anyway, so that's ia problem.Aas = s. e(C.Ksys.audit("smtplib.!",f:, s/>tryRg;Kall(6except OSErrorAjclose(oraise SMTPServerDisconnected(''EJelsepO please rune() first') mdef putcmd_, cmd, args=""o@"""ShaEjsA."""P!ifAj == ""str = '%s%s' % (nOCRLF 5 8*, >@end(/getreply aGet a R fromAReturns a tuplLPnsist6of:(B -  respons, de (e.g. '250', or such, ,ll goes wellusNote: r{ -1/it can't readd. 2cormultiline%1s aJ ed@a single, ;Ging)Rsend-of-filevreachedcU = []I?;Non+=tP.makeG('rbj wh1/*I.(_MAXLINE + 1 BK as rG"""CRion unexp^1ly N6d: i+'(e3!if 'F"Jdebuglevel > 0q_print_,!('0:', r(2len4 > ]\SMTPResponseException(500, "Line too long.") resp.append(line[4:].strip(b' \t\r\n')4qcode = /9:3]P# Check that the error 3 is syntactically correct.BDon't attempt to read a continua~ if it is brokenIItry:Z1err`= int( e=p ValueEC --1`Ybreakif multi7 wJonse!if[3:4] != b"-"cdperrmsg .\n".join(_if self.debuglevel > 0Y!q_print_(('reply: ret' (%s); Msg: %a' % (L,7msg&`return;! def docmd(t, cmd, args="")b"""Sen@mman% ndZ5itsD]A."""_Y@.pute_&1get"()# std smtp coxsWChelo{name=''PMTP '&'=@Host6sfor this+ defaults":qFQDN ofFQlocal7hos5"1", v"orI_A  , " =+u3W_b =0WJS;/eh; ! S<'<ke_features = {}W O_msgd:# According  RFC1869 some (badly written# MTA's will disconnect on an a. Tosseion if#h es -ddm!ifb == -1 and len(*=Hfclose(;QraiseuServerDBed("@ not'ednx[!= 25TQdoes_6 = a#parsez=k Passerinstance.2 , bytes), repr<0.de;("latin-1").split('1del[0] for each in resp: &# To be able to communicate with as many SMTP serverspossible,Oawe havLtake the old-style auS dvertisement into accountM|because1) Else ourfeature parser gets confused.2) There are somethat only amethods weP support using3Aold ~J_match = OLDSTYLE_AUTH.()a!if56  # This doesn't remove duplps, but 's no problemcHself.esmtp_fM0s["_"] = R.get("}, "") \TXw+ " " +.groups(0)[0]8continue %# RFC 1869 requires a space between ehlo keyword andzameters # It's actually stricter,&.^s*tallowedk 3parhqwaanot goo check _l. NotP6}! iApres-f_x cm = reUcr'(?P<>[A-Za-z0-9] \-]*) ?',+ myOB = m#("0").+*r(G 's4rng[m.end;0:].p=3if bB == {g[; # b ,el Preturn (code, msg)def has_extn(Sf, opt)p"""Does-ra given9ice extension?"""4optp +3elpzargs=''Ga'help'l'anR s  text from.putcmd("/0", ps)getreply()[1]Arset0 --<W0ses(:and_encod= 'ascii'P!dog"_Internal '!0whi1gnoServerDisconnected error. Used internally in the library, sinceserver disconNLshould appear to7application whe_ *next* command is issued, ifOwe are doing an "safety" reset.15""" Etry: self.rset()except SMTPSD ?Bpass6def noop(R)&0"""I ''-- doesn't do anyth(:>preturn R.docmd("F&")sAmails, sender, opVOs=()1 pbegins  xfer sessionThis method may rais`follow5Rions:^DNotSupportedEhT The parameter includes '2UUTF8'N1butP2` exten?Tnot s|? byO@\list = '%ifes_esmtp if(x.lower()=='%utf8' for xojs<"ifhas_extn(?.2V`_encod= 'utf-eJelseFm (]  l'|ee ' + ' '.join(s11put ", "FROM:%s%s" % (quoteaddr(#)$c)Kogetreply(lCrcptlTrecipGk0 k0indQes 1 BAienttbHail.n' DMM/TOKJ%CdataJ7msg.IDATA<`ssage AK@Automatics lines nwith a periodv rfc821RsBData ifk reZan unexp?+5the;: avalue from Z!is%UfinalEresponse code5Veived32all  ist. If msgBis a string, lone '\\r' and '\\n' characters are converted to Z'\\r\-. If msg is bytes, it transmitDeas is.H5""" self.putcmd("data")(code, repl) = +0get&y('"ifdebuglevel > 0:G<q_print_( ('mH:', f U~z != 354Mraise SMTPDataErrorEyJelse:if isinstance(msg, str)%R= _fix_eols+@).en('ascii'1q = _quote_period4$if q[-2:]^bCRLFyHAq +  >?"."!djsend(q?msg F(% m dreturn  def verify(W, address0"""" '(' command -- checks for9 validity.vrfy", _k`_only( u.r# a.k.aRL# =Oexpn& expands a mailing listA$~# some useful methodshlo_or_helo_if_needed BCallehlo() and/or>b() if @.aJIf there has been no previous EHLO or HELOthis session, N tries E4CWfirstvTC-Bmay Rthe followxexceptions:vAHelovsThe server didn't8y properly4. greetingd)is+P_resp@Nonewt  lot (200 <3P()[0]7299KsL' b;X1ao.Aauth, mechanism, object, *, initialonse_ok=True"""Authenticac- requires @cuq'' specifzQwhich\*to be used - the validues are those listed in%'auth' element of 'esmtp_features'. &5 object' must be a callable  taking a single argu^:Jw data = =(challenge).pIt willnled to processserver's > response;!  it is pasBg a bytes. It should returnKan ASCII str6thabase64 encoded and s` to ZuKeyword+%s:h+- initial__ok: AllowYde RFC 49540-0 O @+AUTH command, ifentication methods supports it.N5""" #~as@tvide an. Not allP {z By def$ony0 so5WotherMthan None when*!is,y do. See issue #15014mechanism = .upper()s@ = (\)p $_ok elseKf11not) -# =_(m.('ascii'), eol=''x|(,) = self.docmd("?&", + " " +-} J;___count = 18 r0rC# Ifpds with,i%$&se`while *z == 334+p2 = 0.deZ( m W{~f)- SQkeeps>z's,is wrongSi?lf.5> _MAXCHALLENGEs?raise SMTPExcep()!"SA !inhe loop. Last&: C8pr( )"if6in (235, 503)x R raise SM@TPAuthenticationError(code, resp) def auth_cram_md5(self, challenge=None):-1@""" Z object to use with CRAM-MD5Qz. Requires \U.userO2andpasswordRbe set."""(#^ does not support initial-Uonse.65if @ is :areturn + " " + hmac.HMAC(,D)0.ene('ascii')K, 'md5').hexdigest(_plain(_PLAINE and P"\0%sA" % , ?log*?LOGC 2 or_h _count < 2BE Oelse+0&I$, $D, *,__ok=TrueLog in on an SMTP server that rThe arguments ar- r:*/P name;Y1-D@0 foe1Key# _-$ : Allow sending the RFC 49540: /AUTH command, ifDion methodsVs it.I4 re has been no previous EHLOvDHELOh@ thi0assion,l tries ECHfirsvTC-Swill normally waccessfulPmay raise  fod_Pexcepp&s:AHelo\Pdidn'ply properly to2helo greetingu{ ac/~acombinn BNotS#ed [Ped byC. SMTPException No suitable authentica&method was 1 efound.)E""" self.ehlo_or_helo_if_needed()&qif not -has_extn("5"):& raise SMTPNotSupportedError()-"( AUTH extensi9 by server.")?# ASs the0 claims tEadvertised_blist =esmtp_features[].split(we can handle in our preferred order2s = ['CRAM-MD5', 'PLAIN xLOGIN']bWe try/'sE, if#Ce" sJIm3W'[ A fora Y%if/~]4idp*I\//("% ?4Som)%s ? f y don't really#2S, so Bpfails, ontinue until we'v7iedM4allu}vRuser,password = IQ _name = '%A_' +.lower().replace('-&_':try(code, resp)`c.t, getattr(,%),4initial_konse_ok= =# 235 == 'Psuccessful'rQ# 5035: already7.ed80if P(235,G >xreturn B e/g ^ as eRlast_:h;= eOQcouldflogin bly. Rresult of Q attemptmidef starttlskeyfile=None, certaontext)a"""Putq connec!toS3 into TLS mode._ If+re has been novious EHLO or HELO command this ses, tries EC]firstvsupports TLS, this will encrypt the rest of cSMTP session. If you provide)keyfile and cert parameters,Ebidentityfr serverA lient can be checked. ThiI however, depends on whethersocket modulBallyLs ificates. m method may raisfollowing exceptions:9 4HeloError;4Thedidn't replyHperly to1Ahelo greeting.55""" self.ehlo_or_0_if_needed()&qif not -has_extn("starttls"):*NotSupported()-"STARTTLS exten:l83 by&."b(resp,2) =edocmd(R/ ifp == 220_have_sslrRuntime"No SSL s included in0gPythonIif context is2NonDValuOQCarguments are mutu"exclusive(DC6 ort im warnings. $("le re?d, use a  v"custom3nstead", DepLBionW6, 2 kg== ssl._create_stdlib_(= h= Z$ =`.wrap_5et( }-_hostname=G = + # RFC 3207B # cMUST discard any knowledge obtained fromZ, such av2 li]E6ice!# which waT q _pnegotia1 it  resp = None  self.ehlo_resp = None 2 "smtp_features = {}%`does_e*E = 0 Uelse:[# RFC 3207501 Syntax error (no parameters allowed)O454 TLS not available due to temporary reason< raise SMTPResponseException(v, replyqzreturn Sdef sendmail(6, from_addr, to s, msg, %!_ohQs=(),BGrcpt")+"""This command performs an entire_ transac%. aThe arguments ar-!: 0addressPing t.W-- : A list of Pesses&D to. A barzE0str~will be treated as aidwith 1m 6msgNamessag' 24ailC : LE0 ` (such8bitmime) for th @ yy4DSNIs}  0all e8"(0mayc#a tpcontainacharac!inIASCII range, or a bytC is encoded-@s us]tPscii 0c, l1\\rG\\n are converjto \\r# Ifre has been grevious EHLODHELO session,emethod tries Cfirst. n server &&$, 6siz/@each7specifiedrBpassCihxqfails, 3d@@supp'ed'fAnormally iHnPis ac;!edat leastone recipien1t rM!diQary, .QentryMIE that was refused. E:9_TtupleQMgmqaccompany `ent by>/@\R foO^&s:QHeloE {6@idn'1ply properly to5 helo greeting.  !SMTPRecipientsRefused The server rejected ALL r+ @(no mail was sent).4weSendersJw didn't accept the from_addrHDataErrorBHreplied with an unexp5 eUcode (other than a r'_al ofD-^ NotSupported4_options parameter includes '<_UTF8'}"bu:2 extension is not s? byO%. -QNote:`connec will be open even afPan exgraisedNExample:`p >>> im' smtplib|#s=.("localhost"))tolist=["one@one.org","two@two`hree@tPfour@]Tmsg = '''\\... From: Me@my8 0SubT: testin'.. P Thisa/mN`s.send74("mq"",G,msg1{ " : ( 550 ,"User unknown" ) }ifquit()!Inrabove e,qmessageed for delivery to d!of:k esses, and onJ,I550. If allJC areO!edPmetho ll return 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" % lenz4o1 inA ,`:R(, resp) =&, F80if :z != 250zj== 421=WcloseOelse/@_rse'  ,0err'{ '!to s,g ] for each in to_addrs: (code, resp) = self.rcpt(each, _options)91if < != 250) and*1)itsenderrs[]2] =0~ ^ == 421Jlf.close(g raise SMTPRecipientsRefused(6fif lent0 # the server rVp all oup V[_rsetp.data(msg; ;1if WJelseKiDataError#if we got here[n somebodyVEmail3treturn  1def_message(, msg, frome=None,? r:=()7=()"""Converts ~ to a bytestringpasses itd.|The argum are as for,, except thate is ane%.".M  object. If : 5 or5 isK,sQtakenI headers ofuaKdescribedRFC 2822 (a Value 1d iH re!mo onytn'Resent-'). Regardlesve, any Bcc field (or ai, whenKr)!  won't be transmitted. *I2 islrialized usMgenerator.BhG gO`called}`!4 er%ofrP Kecontain non-ASCII\% adi5thePUTF8 capabilitytq policyloned with utf8 se?ATrueP"se)adcBODY=8BITMIMEaserted o.Idoes not support\j BNotS@ed eS. OtherwQout modify95"""## -Date' is a %mandatory field if the Message is resent (RFC 2822 # Section 3.6.6). In such a case, we useQ!'RG2-*'is. However,Rry0mor<tan one Ap' blockUre's no way toFunambiguously determine whichN isA most recain allsso rather than guessraise a ValueError in$tD. TODO implemtheuristics to[correct 5wwith anP!opallowing uspo enablB&e h. (It should beLQpossi2Qly al+!o"utime.) @self.ehlo_or_helo_if_needed()&M= msg.get_all(VDate',$if|is None:Gheader_prefix = ''elif len(oo) == 1> kEsr3("m'Ohas "from_addrg`# Prefhe sender<T per :}2nYr= (msg[,A+ 'SO%']37 Oif (9)?msg@ @else~fFrom'] yemail.utils%#uesses([&v])[0][1:oNsOF_s = [f for f#FTo']e?BccC-,Cc( ift$)tq= [a[1]ac')MP# Maklocal copy socan deletjBbcc 5sAmsg_3=:. u0del+&!['9[  #pinterna al = Fals:tryw''.joinO4, *,]).encode('asciiexcept Uni E& _qif not has_extn('smtputf8').ZSMTPNotSupported[()r"One oruQsourcdelivery 3 require"G " #internationalized email support, but the server" " does not advertise5required SMTPUTF8 capability")L u = True!with io.BytesIO() as b Emsg:'9if K "2g =.generatorYG(R4p, policy=msg. .clone(utf8=)>V0_opihs = (*4, '"', 'BODY=8BITMIME'LOelse" Og.flatten(msg_copy, linesep='\r\n. msCP.getvalue(Zreturn self.send(from_addr, to 3s, P , # ,FDrcpt+!) ,def close(t)!@"""C`connec1 tov6.""6tryDubfile = vt.f = Non0if  O9s:kfinall}Dsock} }}}}PCOquitBTerminat4Yssion5 re pdocmd("P# A new EHLO is after re1ng Z^ehlo_resp&he /smtp_featu!{}! _e&v = Fals Z res if _have_ssl:QclassP_SSL(0 P ThisRa sub/derived &<c that s over an SSLencrypted et (to u|2is Xyou need a%Pmoduleat wasNcompiled{4SSL). If hostspecified, '' ( UlocalL-).Aused?NPomitt95rstandar --x,KG(465K i_apname anAurceS@ess s!umeaningP aspy do in n.`. keyXBcert re also Eal -Pthey cantain a PEM formY`d priv<5keyV@ific ch2dP2for SLS. Jtext,zE`SSLCon0,t is<!altive to keyf ile and certfile; If it is specified both key) 6 must be None. ;6""" default_port = SMTP_SSL_PORT& __init__(self, host='', :=0, local_Pname=u,t#2timeout=socket._GLOBAL_DEFAULT_TIMEOUTosource_addressg context)):v$ifq is notA[ <raise ValueError("m C arguments are mutually "O "exclusive").J)DC\5 or im warning'=. $("ledeprecated, use av"custom3nstead", DLBionW:, 2K.= #{= % {= ssl._create_stdlib_(i= TX=r$ =: .ro m#, ! )Bget_^n^(debuglevel > 0y%q_print_,('connect:', (2i)'3new = super()._:B Celf.vS.wrap](h? fserver vreturn m__all__.append(" ") # # LMTP extension #  = 2003 class)(>0"""+@ - L Mail Transfer Protocol1The@# pp, whichtvery similar to Ed,heavily basedon the standardN client. It's comm&o^RUnix vs for LMT%P, so our connect() method must support that as wella regular host:(server. local_name and source_address have the sameGpmeaning`they do in#SMTP class. To specify a Unix socket,E2you usw absolute path[p, startq wia '/'. EAuthentication is `ed, us4 mechanism. WhenH+ Lgenerall&n'ior requiryEap, but ymileage might vary."""ehlo_msg = "lhlodef __init__(self, P='', =k_PORT,R=Nonec & timeout= ._GLOBAL_DEFAULT_TIMEOUT):K """Initialize a new instance%super().c Q ,)bK5JvS0d% C~1 to daemon, on eithero 3TCP !if`[0] !=d`returnFE =K0if .%@not ' ! aise ValueError('Non-block^9# (]4=0)`7ed'# Handles-domain%s.e:tryk# =..2et(.AF_UNIXb.SOCK_STREAM)W G GC.setf v/afile =x .Aexcept OS debuglevel > 0$q_print_,#('mr fail:'_u5]Sz.close(<rT(code, msg)elf.getreplyUuau`| # TesDe sendmaile, which tests most ofos. # Note: This alwaysEs+k0. ik__ == '__2__'bprompt(prompt):  sys.stdout.write(prompt + ": ") $(fflush(dreturnJin.readline().strip() Hfromaddr = fc("Fromf tosTo").split(','qprint("Enter message, end with ^D:Omsg = ''zwhile 1: / =$pif not +9=Ubreak'i+,M length is %d" %S(msg)PserveSMTP('localhost.set_debuglevel(1tndmail(e#, Q , j,8quit() """Routines to help recognizing sound files. Function whathdr()-es various types of= headers. It un tands almost all# that SOX can decode. The re 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 If0 doesn't have aAable*C, ittys None.? ca=be opened, OSError`raisedo computextotal time, dividH by/ !a asr each )() calls@. (!se also use some heuristicsOraw data, butY= work very well.) Finally,$ f2`test()Pa sim@mainBgram@ wha+}@ menzQed onZ@argu list. For directory sW!()W(&at:. DefaultDP"." ( ?e currenF). The op` -r te~ itArecurse dY ielninside explicitly giveni`""" #e8structureAtop-]Pexcepa e sand its # subre last. __all__ = ['1', phdr'] fa colles import namedb SndH' =&('!',U 'On1s nsxwidth')q.=a.__doc("""The value for type indicates the data  and will be one of!strings 'aifc',fu','hcom', 'sndr@sndt!vo,0wav@8svx sbu.or 'ul'.""") SndHeaders.framerate.__doc__ = ("""The sampling_ aeither actual value or 0 if unknowndifficult to decodenchannels`number%Vfit cannot be determined iI?is GBfor #4 of$]or -1P[widthER#`le siz9 bits or 'A' PA-LAW"'Uui def what(filename): """Gues{Qa sound ,@*Qres =D6hdrGturn res k 'n`Recogndhl1"""Kwith openc, 'rb') as fGh = f.read(512)< tf in tests1vtf(h, f4 if /!reV(*res< None #-# # Subroutines perp / #L R = []{_ pimport *0if h.startsu(b'FORM'if h[8:12] == b'AIFC'aQfmt =!c'f/el2F2f2&seQ\ar.seek(0~6try+1a =.;4''except (EOFError,( |(fmt, a.get#()1(),0n1s.28 *DB()) .append()Du+f H.sndfunc = get_long_be0:4](b'\0ds.', b'dns.B lB 1ile>uAhdr_ = r(h[4:8] Xencodingunc(h[12:16<C6:20S20:24}$lew1 # default#6if x6= 1\8pB= 'US2228`elif encoding ==S 3: sample_bits = 16size = 2Oelse;1'?'$cframe_7^* nchannels)6if ,Vnr = dataH/); 2!-1return filetype, rate,~", 2#, tests.append( _au) def hcom(h, f)if h[65:69] != b'FSSD' or h[128:132RHCOM'5wANonedivisor = get_long_be(h[144:148])&3if )J!atd2050 / / $A = 0''1, -1, 8 ) ;voc not h.startswith(b'Creative Voice File\032'? csbseek pshort_l S20:22 if 0 <= 9< 500 and h[j] == 121cod6E56 -)1+4]!if4(:|aint(10.x-_?voc^9voc]9wav]mport wav. # 'RIFF' 'WAVE' 'fmt ?if :)48:1D3:16T f."(06try+1w =.open(f, 'r''except (EOFError,( |('wav', w.get*|#()nb1(),7s5!8*width())9wavI8svxl^FORM'lO8SVX # Should deS` it to$ # -- assume always 'q', 0, 1% Ksndt XSOUNDn9 le:[~ &'9f/ r H\0\0#:4saif 400m/<= 25000&r[@sndr/#-# # Subroutines extract numbers from bytes # #----------------!# def get_long_be(b): return (b[0] << 24) |1#1628Kb[3]QlQ33QBQ`Q0Q_short 414 h/ #* # # Small test program #.Q+(Iimport sysXcursive = 0 if.argv[1:] and] == '-r'7del!1:2]G&re]16try9 j<uall(sys%, RA, 1)R,Oelse>_['.']7 except KeyboardInterruptGystderr.write('\n[(fed]\n'.rexit(1)tIlisttoplevelofor filename in Mif os.path.isdir(+[Uprint + '/:', end=' ,&ifdD or v&V'ng down:O)Eglob@s = .(Pjoin(u.escapev), '*'){HrT s0-/? *** directory (use -r) ***B>dc+stdout.flush( #_6wha OSErrornot found` if __7!____main__Y() # Wrapper module _socket, viding some additional facilities # implementedPython. """\ This]provides a` operaRse@relaIAfunc. On Unix, it supas 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'!tosocket. recv%_fds() -- Recieve file descriptors from the socket. Rshare9create a r object7data receivedFA[*] gethostnamSareturnucurrent !-&by/Umap a" to its IP number3Baddr3n$9 orADNS info<Nservo@ice and a protocol to7ort"L9(e.g. 'tcp')aAntohs(), lconvert 16, 32 bit in~pnetworkD? byte order htonK K@4to SKinet_aton0IP o string (123.45.67.89032-@packaormat MJntoaM,/to` fgetdefaulttimeoutW1get] d value<s<s<  _connectis!aness, with an op,%al_and ,dsourceM!. [*] not available on all platforms! SpecialQs: S@Type t*orps error(AexceR raisQ I/O "s has_ipv6,rbooleana indicatif IPv6 is supported IntEnum constantAF_INET, AF_UNIXW domains (first argum4() call) SOCK_STREAM, 5DGR 7RAWVps (secoU)IegerMany oth` may bM`fined;s$seu3!in c et opUgm(ds. """ im/ _1!et  *&os, sys, io, selec5ek2z, IntFlag try:"berrno ! IE% = None EBADF = getattr(1, '', 9) EAGAIN$', 11) EWOULDBLOCK+0 __all__ = ["fd", "getfqdn Aer","dualstack2AddressFamilyKdKind"].extend(os._get_exs_list(_)) # Set up(vT.AF_* *w` as me@s of5s for # nicer representations. # Note t,hat _socket only knows about the integer values. The publicrface # in this module understandsFenums and translatem back fromO!gers # where needed (e.g. .family property of a bject). IntEnum._convert_( 'AddressFI%',__name__lambda C: C.isupper()C.startswith('AF_'))v S]OKinds2ESOCKuOFlag0Msgr2?MSGq\OInfou2"AIt_LOCALHOST= '127.0.0.1' _V6 = '::1' def _4num1er( , _klass):B"""C- a numeric n4s to an [ member. =If it's not a=n!p, retureWPqitself.A1"""2try:)*except V]Error8f # WSA e$ codes if sys.platform.lowS"win";Tab = {}}M Tab[6] = "Specified event o handle is invalid.P![8>Insuffici;memory available374 One or more parameters arl2995:verlapped CPation=rte"99O4:I/Oin signaled stat#99I}will complete rQ10004y;a\oterrup797A bad filewas passQ100136pPermiss"Odeni+A fault occurr]etwork??" jEFAULTFQ10022r$An,_attem2Too many:nsH3H72perwould blockB1003 A 0ingh9is already@progc~s7*Exbon nonnbDestina required."  errorTab[10040] = "Message too long." *1*Protocol wrong type for socket828TBad p<ooption-3-enot supported040S}353POpera 161ofamily777Address 66 by!8IThe network aUis in use7970Canassign requestedC95Nlois dow5)unreachabl5 0dropped connecosG5Software caus=Oabor5$@khas beeq(No buffer space avail*is already5(51OshutToo many references65o*timed ouf6 C0ref] translate nam86"? is 6@host.6X* 6Director_emptyoprocessnUser quota exceed6ODisk-7Stale file handle7@Item?_remot9(csubsys5/un* 90Win8.dll version_ of rangt 0SucNful WSAStartupyet perform?"10PGrace?3!J@prog"10`No mor?sults fromLookupServiceNex#"10UCall ocancelP9!du@ll t}oinvali"10 provider is inv4alid." errorTab[10106] = "Service provider failed to initialize?7?ystem call:?ure-8-lnot foun9+Class type . !10.No more results from WSALookupONext!11CCwas cancele!12+Database query 5_refus42100_OHost2100\Nonauthoritative h93 This is a nonrecoverable A10048V name, no data ?rd request .ypA1005C0QoS3oeiversjj'Osend%P?No ( K%/now J* confirmK/admission=5-opolicy#106,bad stylM1'^objec2101(ptrafficOtrolgeneric+:1flowspe\1Invt4vobuffera5ofilterI22IncorrectfOcoun2f length2 gOlow eUagnizedjc33 descripto25-iG  @Bshape discard mode 3%?ing rat9 ,Reserved _qelement__all__.append("GTab") c_GiveupOnSendfile(Exception): pass+socket(_.1): """A subV of _socket.Dsocket adding the makefile() method.""" __slots__ = ["__weakref__", "_io_refs" closed"]8def __init__(self, family=-1, type Qproto no=None):{# For user codeCressLA andL values are IntEnum members, butP1forpunderly_.y're just integers. TheGconstructor of CconvertsL given argument to anJb automatically.!2if @ is !Xj == -1!v = AF_INETY"if?< = SOCK_STREAM>{% 06 '.!!, >,)CL#._y' =] = FalseSentercpreturn > .xW*args4aif not4"._r zN.(()V?rep"""Wrap __ )&arevealCr class name0addF(es)=d = getattr'"',2j = "<%s.%s%s fd=%i"%s= e=%i" \r!% d1.____.__module__,*# L*@qual,2" [b]" if else ""ZD/()C0 :tryl" =0get(S'1if .Ers += ",#=%s" % str(3 Mexcept errorMIpassrOpeer.k#&5'>'oOtateaise TypeE%`(f"canpickle {__!r} object"1dup<0"""P) -> #et8Duplicate%2. RZa new: connected86samsystem resource. The new socket is non-inheritable. 5""" fd = dup(self.fileno()) O1 = __class__-bamily,Ctype rproto, L:=fdM.settimeoutGgxareturn def accep7!):3"""`) -> ( et object, address info)L6Wait for an incoming connection. RaWtrepresent67the:`, and z!offclientaFor IPAets,$3a pair (hostv, port)E $f# Issue #7995: if no default 5set listening# had a (Tzero)C,!cezn blockLmode to override platform-specifico@flag 'nccif get ()ANoneU`V(True@make2 , ="r", buffering=E, *,CrVencod#cerrors0qnewline 5s1...:an I/O stream edX"etwrarguments are as io.open() aftername, exEonly0sup!edb valueWS'r' (a), 'w'?'b'# XXX refactor shUcode?p`t set(na) <= {s"w", "b"}praise VEb("invali@%r ( r, w, b allowed)" % c,1wri<= "w" in0reaU = "r or not ;-tassert 4-or"`binaryNbN?0raw$ifP -+D$ift/w^qraw = S#IO.l_io_refs += 1p z?= -9?< 05io.DEFAULT_BUFFER_SIZE,==J]y e;K"un#eds must be E"Beturn raw if reading and writing: buffer = io.B edRWPair(raw, %Eing)<&el^RCeadeRM*seEdassertv@ OWrit`if binaryerreturn QdBtext^TextIOWrapper('`, encoT, errors, newlineC.mode = \r   if hasattr(os, 'sendfile'):!Tdef _E_use p(self, 2, offset=0, count=None)/u._checkD_params(ECsockno = F/:no(#tc8*! =. 8except (AttributeE[, UnsupportedOperation) as~ lraise _GiveupOnSO(err) # not a regular;0sizos.fstat*pno).st_ B!OSE!iff0^empty# Truncate to 1GiBavoid Overflow, see bpo-38319.Pblock1in(xA or , 2 ** 30$PimeoucHBgett 3if _ == 0BValu/a("non-qets are-G"# poll/select have the advantage om`requirZ9anyq# extraf descriptorEntrarily^ehkkqueue@`(also,x"y he a single syscall)|:a'PollS orE,xectors.5 ,elNFw+orH2`.regis no`yEVENT_WRITE)pPtotal70=Plocalvariable accesstPminimoverhead<_ . . osd = os. &CPwhiles #or(  =raise _socket.timeout(' d out') if count:1blocksize =+ - total_sent76if :O<= 0bfOreakM?try;P = osdfile(sockno, voffset, except BingIOErrorzpif not `/ou?#W until the et is ready to send someG# data; avoids hogging CPU resources.B selector_ (lcontinu0!OS(o as er/ 5/ =# We can get here for different7Qsons,NOmain # one be+''{a regular mmap(2)-lik#[, in which case we'll fall back on using Qplain/() raise _GiveupOnSen?err5err from NonOelse ib # EOF0 +=B0+oreturnofinall>'if3 > 0 and hasattr( , 'seek')#.!( EEdef E_use R(self", A2=0,]= v a@"os.G!()availablethis platform") Au._checks_paramsM-J1if <3getH/()QValuema("non-^LQs aresupported"j )^Amin(%, 8192) 5 J85= 0p# localFAvari`accessPminimoverhead8_#! =v. r = self.send  Ptry: while True if countblocksize = min(+ - total_sent, $)u?&if"_ <= 0j+]breakE@dataemoryview(file_read(|}pif not ?so} # EOFv4 ep = sock% d(/except BiingIOError0continue?els@ += E+!if b < len1! =m[Z/:]\ M @greturnwkfinall'if+ > 0 and hasattr?, 'seek')^.(offset +M!) zdef _che3_params(self, ", A,bkaif 'b'hin get`mode',!2raise Value% ("f should be opened in binary K"x.type & SOCK_STREAM mHonly0 Cets are supportedt5!is;Nonisinstancef[, int3Typ"t@musta positiveUeger (got {!r})".formatw)/Q &?Rp@sendb#=0d=_55"""7<[[1a]]) ->aSend a` until" is reached by using high-perB&nc5os.y)~"heO number of bytes which weQEent.*&* rregularoobjectD:If  available (e.g. Windows) o_%isV)a }p() willw!usVstead** tells from whto starthd_1the=If specified, *count* is the total number of bytes to transmit as opposedsending the file until EOF is reached.=F#position"updated on return or also in caseerror inGRwhichu.tell() can be ufigure outGMwere sentThe socket must[of SOCK_STREAM type0Non-block9s are not support 5"""Etry: j`self._fE_use (, offset, count)Dexcept _GiveupOnSend1fbcdef _decref_@ios()b0if ._io_refs > 0 A-= 1^=oclosed81() 3Rreal_Zc, _ss=.# This funcashouldreference any globals. See issue #808164F_ss.z{:.d = True F/<=;ldetach3"""B) ->descriptor}C|| object with,=punderly PdC0canVpafter tscall, b L+!re-for other pur@s. n ? : Ter().C0@propertyofamily|Read-only accesphe addr9 }Gx_intenum_converter(supN2, A^F# Hr1, SCKindif os.name == 'nt'~^get_inheritable0os.-mhandle4.#Fno(){_s_', ql0os.3e C+Oelse%os.get_inheritable(self.fileno()) def set_inher+', %):07?os.3^ <;gc.__doc__ = "Get thep flag ofqsocket"G wGSG fromfd(fd, family, type, proto=0O""" +[,b]) -> object Create aO a duplic!`given >descriptor. The remaining arguments are"ame as forn1().G"""8Pnfd =u2(fddreturn/0, n, if hasattr(_., "sendmsg"/import arrayl%P_fds(7, buffers, fdlags=0, address=NoneOkA![,+%s[A]rintegerIASend-@list[k gs over an AF_UNIXLFP B.Emsg([-SOL_SOCKET,;MSCM_RIGHTS,:.@A("i"$2))]__all__.append(}X?")  Orecv%Msize, max 6 x(data, `, msg_s)Receive up to6 -Yvmessagenata and aCcont\/0# AEEintsX\fds =msg, anc! =h.NE}Y>/CMSG_LEN( *P.item4 cLqlevel,  4 in Aif (&=D == C%V $0@fds.TRbytese[*6len([) - (%]0 T{S(fds)5`f \\ TshareW(info 9= =o Qed by socket.share(pid). 5""" return socket(0, Qinfo)%__all__.append("fromshare") if hasattr(_C2, " pair"): E3defc(family=None, type=SOCK_STREAM, proto=0):<'""V"([@[<[1]]]) -> ( object,x)TCreate a $ o) s C theA"s +Qed byplatformyO() functionwThe arguments areFsame as forj() except default 5 isoAF_UNIX if defined on4; otherwish he(Mis AF_INET&ifp ;:try=ZNameError? ?sa, b = `.err4a =P(, a.detach()4h` \?, b4 c else# Origin: https://gist.github.com/4325783,P Geert Jansen. Public domaiBCF =g @hostlLOCALHOST/el>6? 7_V6Braise Valu`("Only@D and 6 addressFies V "gsupported"!ifyG != | 0O is jk0a/col zeroWPd# We cconnected TCPR. Notftrick with@ setblocking(False) that prevuhaving topfthread>l8s | ?=p.bind((7, 0"vlisten(J# On IPv6, ignore flow_Cscope_id5H , 2 = ]0getname()[:2]1ca E.w j)>B&(( 0 except (B lockingIOError, InterruptedO): Mpasscsock.setbVm(True)(s(p, _ = l .accept(* exf[close2UraiserzfinallyEt Areturn (f__all__.append("etpair") p.__doc_'""&([family[, type[, proto]]]) -> (B object, ) Create a q: of s from the"s Qed byplatform() function. The arguments are6same as forZ2()  default is AF_UNIX if defined on,; otherwise,E>INET. """ _B2_errnos = { EAGAIN, EWOULDBLOCK } class SocketIO(io.RawIOBase): """Raw I/O impleaStream1s. 3RThis [supportsmakefile() metho`s. ItBvider{[Aface opaw.|# One might wonder why not let FileIO dojob instead. TherQe twoV# main reasonsIA!isS0ada-P# - ivPuldn' Ark uWindows (wd`you ca$@used`sd() andv` writ15on ShandllDwithtimeouts (would ignok*` consi4T non-\)p# XXX MJBdocsdef __init__(selfP, modW!if@in ("r", "wrb wKrwb"Pa Valueo("invalidWq: %r" % t.$ ._! =F">Tf "b"0 +=%4N= reading = "r" in$$w$_occurred = Falsej#tobO ead up to len(b) bytes int$able buffer *b*+41`numberDzfmZ etRL"novNSPavailz`, None9t#edq|!Ifn-empty, a 0 v(p indicaAthatQconnevwas shutdown ' end. S""" self._checkClosed()Readable2if =timeout_occurred:Adraise OSError("cannot read from >d out object"while TrueS:tryhSeturnsock.recv_into(bT+aexceptz>outK! = N `eK as 5if e.args[0] in _blocking_errnos6rINoneqh def write(F, b)O@"""W the given bytes or Sarrayq *b* to+R!et_nCand Inumber ofDs~ ten. This can be less thanGlen(b) if all data could2H'If5 isCDnon-= #no F 83 is5ed.E F  " ._BX.send+ # XXX what ab$eEINTR?K JC CSocketIOZopen for?ingb:cqc Value2I/O operation on 7 P7et.0 ._:ing%kOseek%<fpuper().)afileno pRo$ descriptotunderlyingS ?^.l3no(0@pr!tyZ"2namd  `;els-"-1&=mod5d_! def close(self): """Close the SocketIO object. This doesn't c)underlyingIs<#, except if all references to it have disappeared.A5""" 0if .rdfreturn+o.RawIOBase0!I_._decref etios()' = None def getfqdn(name='';"""Get fully qualified domain ,Q from !. eAn empty argument is interpreted as meaninglocal hostAQFirstd Ped bybyaddr()^checked,52possibly existk aliases. In case no FQDN@available,s0getpn " = Sstriptaif not2 ora== '0.'B p6try&#, @, ip ;s =QVerrorKApassaFelseX.insert(0Mf$inA!sif '.' %  Qbreak} * =yC _GLOBAL_DEFAULT_TIMEOUT ="()create_connection(.ess, timeout=K,ssource_G=E/Ch*"c* and #etpConveniDA fun?. O(a 2-tuple ``(port)``)p ` Pass op!al** parameter will se 0 onl instanceDbefore attg#o ~@. I iis suppliDglobal defaultK:-S:`get.`Iris usedx**it must be a W2of X TL2ato bin"a Z  1mak$he2ion7A` of ''g 0 tells[ OSCu<s$ =|4err re"Ginfo, 0, SOCK_STREAM<1af,type, proto, canon, sa = reI1} %?et(dk/%if!isPEOUT:  sock.settimeout(%) " if source_address:+HZbind(* I&connect(sa# Break explicitly a reference cyclexerr = Nonpreturn l 0except error as _K_/ck is noth 5%f.close()n iff6:tryCPraise0zkfinall'-Felseyupor("getRinfo :s an empty list") def has_dualstack_ipv6()UB"""Ru@True/the platform supports creating a SOCK_STREAM!etwhich can handle both AF_INET and 6 (IPv4 / IPv6) UQions.J1"""!if! \$or`attr(_et, 'IPPROTO_IPV6')6V6_V6ONLY'fXR Fals Cwith((6,!)nRHopt( , :, 0jd&e_server(8ess, *, family=, backlog=, reuse_=O,w [(D"""Conveni function .V+esUCtypeVmbound to ** (a 2-tuple (host, !))harobject.** should be either% o 6** \queue size passeq.~Cen();E* dictates wherpto use SSO_REUSEPORT0 op1I j!*:`Bit, it willN )6j@ableg!acq!or?p When fc2disS3his1 onFs that en) it by default (e.g. Linux)A>>> t('', 8000"s 1...`while 7  , \# ==.(}E-#7new:has""1dValueError("SO_REUSEPO+RT not supported on this platform") if dualstack_ipv6:CJhas_#&()%)raise ValueError("0Jif family != AF_INET#mrequires@Spsock = 2et(n, SOCK_STREAM6try(# Note about Windows. We don't set SO_REUSEADDR becauseA+1) It's unnecessary: bind() will succeed even in case of a# previous closede same address and stY'inBTIME_WAIT state.P2) If, another`is free toMrB|, effectivelybentingone from accepB cotions. Also, it may the pro?"ag whereEit'll no longer respondany signals or graceful kills ,See: msdn2.microsoft.com/en-us/library/ms740621(VS.85).aspxpif os.nHin ('nt', 'cygwin')\1hasattr(_8, '^'~ ?:@.setopt(SOL_ ET2, 15 ex e# Fail laterwU, forYqs which=not#p|gEpass<if reuse_  IPORT0if / =u& IPPROTO_IPV6, _V6ONLY, 0sl "3"*y ."{".2 hGF0 asO msg = '%s (while attemV`Y %r)' % +(err.str,2"/errno, msg)6Non@if backlog is  vlisten(h(elv(Q/areturn`0oCj def get"info(host, port, family=0, typePproto nected toPservice.Qis a domain name,? trHrepresentationan IPv4/v6!orLSNone.RsCpZ such as 'http'irnumeric8ynumber QpBy passb>KAvalu., you can4 NULL to5punderlyLcC API.he family`UPbe op ally specified in orderlanarrow $es returned. P@zero"a teach of'se`select e full rang rresults1"""?# We overridpis func0 siuqwe want$ Nm_Btypes=@enumDstanA= []B re/" _H@.get(A(,,!, !, d1af,%Rcanonsa = res}10ddr.append((_int_converter(UAF%),@D @SOKindC  !))s1oq """Gen6f0et der classe{This module `capturprious a tsPdefinrver: For[et-basedjQs: -1- AF_INET{,6}: IP (Internet PVCcol)Ws (default@UNIX: Unix- others, e.g.tDECNET areceivable (see -|SOCK_STREAM (reli?cstreamf8TCP20DGR1datagramBUDP)BrsC (includrc)\0clicrverificPbeforrP lookE!atqm:N( 1ctuaa hook10anyVNCqAneedYG _ Panyth;Celse$logging) - ho handle multiple s}synchron5(on%3 is@dha time1for(3[6by a new process)  - threading (each request is handled by a new,() The classes in this module favor the server type thaSPsimpl_to write: a synchronous TCP/IP<@. T[bis badr design, but saves someging. (There's alsoCissuca deepJhierarchy slows down method lookups.re are fivan inheritance diagram, four of whiRpresent s'/'@s: '+-+r| BaseS[|.I& 'v7+) L4TCP->| UnixStreamd(/(--/UD1Dat&hC Notd  T@deriUfrom `, not  4 @-e only differecbetween an IP and a|! s}8address family,@is sy repeatedboth unixDp. Fork!o/qversion: can be crc0 usCO@MixI4d Tbmix-ines. For inse3, aO$UD+/qp as folVq(,r): passMp must c|first, siit overrides aPdefined in[`! Sett@varipmember 0ablDchanges *qbehaviocpunderlyI| me0ism. To Pementmervice, you# aCeR Hrm"re4 it#()a. Youthen run ,0iceZ`combin0one? "erpes withr"/hebEst for dB or ; qu`hidden$A subY2es  ;4or  . Of coursstill have to useQhead! it makes no sens3aQer if service conta2ins state in memory that can be modified by requests (since the m pcationsDthe child process would never reach9 initial}T kept>eparent?and passed to @`). In this case, you use a threading server, but $@will_bably haveZuse locks avoid two!om*nearly simultaneou7pply conflict|achange@. Oe other hand, ifare buile.g. an HTTPwhere all data iored externally (:iffile system), a synchronous claPessenlAnderice "deaf" whN4one!` is be`led --&`ch mayKfor a very long tiLpf a cliPlow tv ad{Tt hasnaed. Hor forking erappropriate. In s2Ts, it'`part o 7"lyUto finishVAin a#edQdepen0on S B. Tximplement{ usS  !don explicityQg!r  () method. An ol]`multipB[an environFsupports nei3s nR (or 0the`re tooensive or in@ice)to maintaw%n Ptablei$edL s C2to 8selector to decidework on next2new incom?=1is 1culJ im(!anq streamRices !,5potbe connec1jeD(if ycor sube;@nnotused). Future : - Standard7!esSun RPC (which:#s 0UDPHTCP)>emix-inE5to P variB@authO! `encryp` schemes XXX OpenpPblemsWto do with out-of-bb? BaseS1split generic "`" funcpPalityGf into =. Copyright (C) 2000 Luke Kenneth Casson Le% on exa:pd entrigrom a SQL `base (ires overriMp get_Pest()PreturS0y fQthe database). entry is processed by a RequestHandlerClass. """ # Author of the BaseServer patch: Luke Kenneth Casson Leighton __version__ = "0.4" import socketelectorso %sy threading from io iMBufferedIOBaseDtime monotonic as q __all ["5Sv", "TCP %UD & $"T! D 7j rrlStream 9nDatagr%tMixIn"] if hasattr(os, "fork"):O.extend(["Forking c)d, "AF_UNIXkBUnix_"j Z3 F1 d ])apoll/syQ haveadvantage+not requiring any extra file descriptor, # contrarily to e\kqueue (also,^yNe a single syscall).Sors, 'PollS',2 = Hors.0S else3H`or c!: d!""* Qfor s5e8Methods !@the #erD- __init__(=_address,)x-h_forever(]_interval=0.5'hutdown(h_est() # if you do ;use^<no() -> int <kthat may be overriddenEbindactivate7get!->5est, client25outFeverifyI DFclos*D~ 0d]@ice_5onszerror()ttderivedqlfinishnECvariables 0 o1 orAinstances#- s_family9S_typeallow_reuseI` i 63- socket """ timeout = None)def __init__(self, server_address, RequestHandlerClass):QU&"""Constructor. May be extended, do not override.""">r.q+ = -/ = 7__is_shut_down = threading.Event()0-,"_rw = Fals8qctivate? alled by c$S to a4C the.TC27den>Bpass6_forever, poll_interval=0.5T one Aat a*t until Polls for syn seconds. Ignoresa. If you needdo periodic tasksAuthem inCsanother.\ g.clear6try{p# XXX: ider using ofile descriptor or@nect& toO`socketwake this up instead of6 XHreduces ourMresponsivenessUand wastes cpu 1ll 0 Os=qwith _S@Seles() as s 04u.regist}s.EVENT_READ)7 whV#szr;y-.o(3# bpo-35017:@B() c0durP), exit immediately3V if$1f._h;8Ybreak1if <.h+_noblock(hV4)@ice_7onskfinall4X,l0.se^0hut PStopsDW loopBsA  has finished. Th@mustiec() is runn%in',uit willA@dead~ u = TrueE1:wai28erv4 9C%by=e_forever() loop. 4May be overridden by a subclass / Mixin to implement any code that J` needs)be run during the u)5"""Bpass# The distinction between handling, gett pprocess`and finishZ# request is fairly arbitrary. Remember:." -j#e_= ()?top-level call. It s selector. 3(),M J, verify >->`differfor stream or datagram socketsB \FBplac may fork a new 3Wcreate aO `threadr.)- instantiates2o!r kT; thi constru\S will- @0allbitselfF3def*)@"""HQTe one(, possibly blocking%qRespectf.timeout.R # Support people who used .sA ()Igescape@p beforehz was available" =..4qg4if .vis None!K?Belife[?notJ Cmin(/,=)X Q0dea1e =A() + 2out# Wait until a arrives  expires -^ L nem0aryaccommod eaZwakeups due!VEINTRwith _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 !edable before th(is function was called, so there should be no risk of  blocking in get_request().#5""" Etry: C0 , client_address = self.S9except OSErrorQEturn+"ifIeverifyw)L processP:E:ionm"\handle_e( Y;shutdown)/~CrUraiseYJelseSO:Cdef timeout(7A"""C0 ifCnew  arrives withinG!. `Overridden by For_MixInBpass> 9,  VsE0`. MayJo ReP Truew{n!edU thisQfrI!Et finishZ` and Threadings.b5aserver_close_to clean-up6  @ @FqD oneinstantiatvRoH3xrClass.o.%],E)6 _R 'ded to 6x an individual-e ? up  k o; gracefully The default isIprint a tCBbackRwontinue5 ('-'*40, file=sys.stderr  print('Exception occurred during process of request from', client_address, file=sys.stderr)-import traceback.print_exc(7('-'*40^Fdef __enter__(self):preturn  .3xit-w, *args4- .server_close() class TCPSR(Base "):[0""" * for various socket-based Z&2es.<Defaults to synchron:IP stream (i.e.,)4Methods jthe callerc- __inRHandlerC, bind_activate=True-_forever(poll_iquval=0.5'shutdown1- hd_B() # if you don't use]LKno() -> int ;selector8that may be overridden t_a7get$->*, OutimeoutFeverifyI Dq/sh 0OPerror'GatderivedDlfinishVVoables K by o1 orAinstancesb#- s_familyhS_typex_queue_size (only5Z6s=allow_reuselIL|hrV2""" # =6.AF_INET%:"SOCK_STREAM&2= 5 = False!"<2lf,r/, B"""ConstruB. Mextended, do not e.[p.GAV<. AUo.ifZL:tryQi# #e ^ self.server_close() araise adef se.bind(self):5 """Called by constructor to 0 the socket.Q6May be overridden5"""^i|lf.allow_reuse_addressQ.g0set @opt(et.SOL_SOCKET,SO_REUSEADDR, 1J.| .8 = Dg0namiSactivatefW4[|?[alisten.request_queue_size)7Bto clean-up7tafileno cReturn 'w number&Interface "ir@sele)rY4elfl^7no(@get_T?est1Get" and client ?Afrom$~hacceptshutdown,:estR4to 6ose an individual@.8:try#explicitlyR#. . merely releases;#Wwaits for GC{bperforH0actW.F.0fHUT_WR ex? OSErrorpass #some platwas may E ENOTCONN here~<K 3x? upp0 clAUDPSU3(TC "):c"""UDP /d = FalJP_type$b_DGRAMc`max_pa/|r = 8192_Sdata,N&f@recv].i>(Ov)]# No needScall o)6UDPLY c anything_self.close_request(r) def close_s(self, !):&*# No need to3 anything.% pass if hasattr(os, "fork"Kclass ForkingMixInc"""Mix-in &to handle each in a new process."""timeout = 300active_children = None8max49# If true, server_/() waits until all \es completeblock_onCv = Trueeollect1*, =ing=FalseN"""Internal routineB forthat have exited<B0if .1!is21freturn5we're above the max number of,H and reap*mURwe go back below threshold. Notdat we useTtpid(-1).6o bS1abl'cubsize() syscalls instead2of ;`ren>): downside is this might1 QPwhichdidn't spawn, `is whyonly resort]Qwhen  Twhile len B) >=%B>try_pid, _ = os.I, 0)+.discard(pid6except CP%_Error#@ do]5any,@( d.oclear(/OS\breakO2Now%i  1pid(op*av/el XC2OP_ J[op]U+n:3(av3f HSlo = f[Q: #  '+/OP (/lo e!lo1in C3OP_%s)c INc_(@skip1len=1); 0/Ts NOT]JoNEGATEO=kr(lo,) +5O[lo]U NV{k oFAILUR[]0 - ?WJs IN chUt, ha_optimize_(av, iscased, tolower, fixes) if flags & SRE_FLAG_IGNORECASE and yLOCALE:HSemit(IN_LOCD lelif not hascasedC8: # ascii E/sepO_UNIskip = _len(code); 0]_compile_charset(,=!, < [_]`0 - +4op is ANYjDOTALL(zANY_ALL/el6ANY,n REPEATING_CODESnTEMPLAT42raise error("internal: unsupported template operator %r" % (op,))*if _simple(av[2])#OBMAX_%)!F_ONE 9 3MIN`? [P_av[0]lOav[1!, I~SUCCESSQO^ }?if TyKUNTIIS :s SUBPATTERNgroup, add_T, del ,avE3 FlNMARK.(8Z-1)*2"$# S_info!p,Bbine( PK01if *&+1#n P(2/op7oASSERT6?  if av[0] >= 0: emit(0) # look ahead%Nelse7lo, hi =\1].getwidth()<lif lo != hiG!raise error("-behind requires fixed-a pattern"i%loF _compile(code,z, flagsPLzSUCCESS:[skip] = _lenL@) - nelif op is CALL^*opY? S!; (0' N/AT"ifG & SRE_FLAG_MULTILINE@vav = AT#B0(av Y_LOCALV SoUNICODV!WJ&avhjBRANCH tail = []J/append = . %for av in mFb+$# hQ_infom1/*FJUMP)A(Z)0+vpFAILURE"Kof branchGIHw MCATEGORYL 2CH_:[av63CH_OGROUPREFnif notIGNORECASn s_q qTixes: # asciiKOK# 8?UNIV&-18wjEXISTSa @emit(av[0]-1)  skipyes = _len(code); emit(0) ' _compile$, av[1], flags) if92]:?KWJJUMP1/no-[2Iyes]43 - M + 12 f/noe)no`NelseG2raise error("internal: unsupported operand type %r" % (op,)) def_charset( , )##  % subprogram! =3q.append`for op4 in<SM66(opif op is NEGATE*.ApassV %el,zLITERAL-[&av[1aRANGE l_UNI_IGNORvI6[0]LdzCHARSETR.extend(?BIG;%CATEGORYt"if & SRE_FLAG_LOCAL#CH <[avuNoUNICODO!PrW '2set:tortFAILUREoptimizeiscased=None, fixup !es *Qacter setout = [] Ftailbmap = bytearray(256"ha = False@f while Tru:try+V "U@l* ![lN,q0es  loN_fixes:k,e0 4k Enot 'h 6=|/avr = range(av[0], av[1]+1) if fixup:1"/es"&for i in map(RO, r)4 8charmap[i] = 1+"iff?fix /k4?[i]7k OelseU Hif not hascased &p = any(i8& rz Oelif op is NEGATENout.append((op)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, qyB6"Pq - p91pLITERAL%out.append((RANGE, (p, q - 1))) out += tail0# if the case was changed or new representation is more compactH`if hasE:len(out) < charset):0return out,=!# else originalracter setgood enough5RoV"# use bitmap%ifmap) == 256data = _mk_6(Z+?out.append((CHARSET, 8x  VF# Tova a bigset, firstg of al@s inJ+constructed. Then, this Msliced into chunks[3256I~s, duplicate* are eliminated, and each 3 isEgiven a number. IKpiled exk1sio_6Aed by a 32-bit word sequence, `isting2one!3for!differentEs, aM 256 bytes (64KsT#.~2dexXtheirunk posiH%aP1256XBs (8rQ3). 24Com,normally :sa typic9;plarge rJUnicode will be eitherletely excluded (e.g.0only cyrillicHletters  toJmatched),K0P,inPH5subq Kanji I)s E=0oneSs.AzeroOM00can`also d:efficiently:Ysignificant3 ofz[S5an indexd':3theG]less f"isJH(just likeGB4ingAQmap =s # shouldrhashablas = {}[@mapp0Aarray(256block = 0+ i(%Pfor i(0, 65536,(=map[i: i +%]^"ifNQ[i //9! =!s[]Hq;pI+= 1+1unk _ [0:0] = [RQ] + _@_to_#s() out.append((BIGCHARSET, data)) out += tail`return, hascased _CODEBITS = _sre.SIZE * 8 MAX = (1 << .p) - 1 _9P_TRAN?b'0' + b'1' * 255 def _mk_bitmap(bits,D=N, _int=int):@s = ..translate(lq)[::-1]*[Af(s[i -ar: i], 2 for i in range(len(s), 0, -2)] bytes_to_codes(b# Convert block indices to word array a = memoryview(b).cast('I'0assGa.itemsize =G'Za) * 0bPa.tolist()simple(p0che f this subpattern is a "0" operator0if krp) != 1SuQFalse)op, av = p[0Pif 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 ab#otential self-@eachf ex-D - _0[i]C#0,[i:] can'tb[0:...Ak with 0 < k <= iQ-k+1:i+1]Rs, w20:k\m = *H(1,"k@idx 1bleTwhile i]Bidx]*(1if J:= 0H# 0YbreakI8[ '- Jelseb^.1+ 1ND2t_ic(flagsqif not  & SRE_FLAG_IGNORECASErWRgNelif:0UNI 70uniGe.Uascii,Fget_literal_(n,a# look}/t:B = [Y`appendkN.1_skip = Sb93in .["rvLITERAL(`d#av$R2(av"/op is SUBPATTEWRN: group, add_flags, del ip = av0%1 = _combine,(H)A1if , 1 & SRE_FLAG_IGNORECASE and!jLOCALEYbreak`prefix1, _skip1, got_allget_literal_%3(p,t !F is None1if H"?not&Ob= len( x*Ielif]() +J0s.extend10if C ;els# creturn a, True% False def _ucharsetcattern)Qwhile_lp0V.data!o7Hv = 75[0]!Tif opSUBPATTETFF,h L   piscased$[vLITERALo3if 0  3(av'u"[()JfBRANCHm1B = [,FPappen.'for p in av[1]TQ  JNC +( ( )D(  UdIb#  Q3in ; # "&$( ORANG&"if > 0xffffm#Kdny(map, range(av[0],iO+1))A return cha0rset return None def _compile_info(code, pattern, flags): :@# inCal: 4@ an 7 block. in the current version,z# this contains min/maxm width, andWoptional literalC prefix or a character map lo, hi =TA.getW!() if> MAXCODE5*vlo == 0%.extend([INFO, 4, 0, w]dOeI# look f   W = []_skip = 01set% # not used!if( & SRE_FLAG_IGNORECASES cLOCALE",, got_all = _get_;_,(JK!# KC%@0.t/K2 ##4~b#: print("*** PREFIX")4!if?setGCHARSET",)%A# ad>0emijRappen(r>1len1); !0#3WEmaskN-ifG <f_;21 is?W O|VqLITERALW(el<e2!= 9E9@mit(!bq length$~if lo <'"lo;Felse $Qx#[:"4tmin(hi,m)= pU {H)) #C$> = B(#(jM!y(= # generate overlap table=_,_,_,V, hascased[Smize_(Iaassert 96> , K [1] =D@) - 2isstring(obj@ isinstance, (str, bytes))=_P#(pz1): = p.state.|s"71# Binfo(code, p, flags) # compile the pattern_(code, p.data, =.append(SUCCESSWpreturn ! def _hex_O!):c& '[%s]' % ', '.join('%#0*x(_sre.CODESIZE*2+2, x) for x ic)d8dis^import syslabels = set()level = 0offset_width = len(str(c) - 1)dis_(start, endVprint_(*args, to=None$(if to is not r.add(to^ += ('(to %d)4Zto,),-('%*d%s %#, b':' if_ else '.'),*zend=' '*(P-%" { >$2% 6\8'*(Q + 2*l) jnonlocal 3<1i wh0i < 2E = i-Aop =9[i]ik,!OP;[op0@f op[, FAILURE, ANYO_ALL]MAX_UNTIL, MIN kNEGATEk/oJ_(opR5eliLITERAL, NOT_ I!P_IGNO5<4UNI,u_D?LOCD?argC , b2x (%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, "= elif op in (RANGE, RANGE_UNI_IGNORE): lo, hi = code[i: i+2]&mi += 2print_(op, '%#02x (%r-%r)' % (a, chr(lo) Yhi)))Oelif op is CHARSEToP_hex_( + 256//_CODEBITS]c '?BIG5arg3.1X|`mappin9list(b''.join(x.to_bytes(_sre.SIZE, sys.Zorder0Qfor x in` cSarg, |IT Plevel>jrange(arg/2(%D` :-= n (MARK, GROUPREF av,iHC_LOCBm"4Y ns JUMPiOskip\*p, to=i+ (Ps BRANCHJ`while gdis_(i+1, &?E Istart = iN A/if!s'branch',/y 6OelseTFAILUREn (REPEAT, _ONE, MIN_CP, min[xdw3If max == MAXX&% '&' E 3bnEXISTSh 4 i += 2 elif op in (ASSERT, i_NOT):-8 skip, arg = code[i: i+2])print_(op, 4p, to=i+)1dis_(i+2, "= <os INFOflags, min, max4"if&= MAXREPEATZL'&'" Abin() start = i+4^1if Lp & SRE__PREFIXprefix_len, S +46H2(' <'J:M + 6"0!: +/',cg '[%s]' % ', '.join('%#02xpx for xx)M @(%r)9'Ktmap(chr/)) $+=J?len?toverlap',{$p'MoCHARSEPlevelW1 ?in'i>-= i.seraise ValueError(op) ep0, len()) def compile(p,}#=0+# internal: convert pat list to"h2matif isstring(pM=1= p = sre_parse.f(elDBNonep@ = _=d FLAG_DEBUGP(m2dis"^A# maUeither directiogroupindep.state.Bdict@ = [I] * ,s)@k, i0Xw.items(H!r[i] = kreturn _sre.X8% |q &-1w, tuple( C) # # Secret Labs' Regular Expression Engine+various symbols used by the r: expression bengine. # run this script to update the _sre include files! # # Copyright (c) 1998-2001 by Secret Labs AB. All r,s reserved.E"Seeasre.py_ for information on usage and redistribuE """Internal support moduleKsre""" #,when constants are added or removed MAGIC = 20171005 from mdMAXREPEAT, MAXGROUPSg@SRE \dard excep (access as error) # shouldreally be here? class ,$(EK): """q raised`invali+gular expressions. :"AtB2es:Omsg: The u|2tedz@ mes<+0patp/,reg 0"os,index inY& wr compilfailed (ma UNone)MblinenoP corresponding?pos<4col;Pcolum=B1__m[__ = 're'Adef __init__(self, msg, =Q, pos P,`.msg =1!=G @os =T$if* is not x8B`'%s atQir%d' % (&os3aif isiD3ce(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().Tmsg) P_NamedIntCC(intnew__(cls, value, name#h PP, cls~ HA.U! =\areturn\Crepr\-M= = (' A') makecodes(sh  s.}p().split(@item[qi: =enumeratek]globals(). ({[ : G0temD"s}  op^`ors # Oure=0 success=1 (jXust because it looks better that way :-) OPCODES = _makecodes(""" FAILURE SUCCESS ANY ANY_ALL qSSERT AA_NOT;AaBRANCHC1CATEGORYHARSET BIGC GROUPREF q_EXISTS#IN!FO AJUMP bLITERAAMARKMAX_UNTI'INHNOT_5aNEGATE7CRANG 3EPER 2_ONSUBPATTERGMIN_"GRIGNOR77IN_ M4LOC;IN_U Y ];UNI] ] ] M_r0 ; """) del [-2:] # remove 58and9 # positions ATAT_BEGINNING Z_LINEaSTRING*pOUNDARY$SNON_B 0END5ENDK E&{:/ N)2) )- # categories CH|u_DIGIT zZSPACE& &JWORD% $YZBREAK)\yE. -.. ..s-,1 placement opera for "ignore case" mode OPA = {{#:  ,': % } ScLOCALEZ^ )b0UNIcc)} AT_MULTIa:eaAT_ENDA Q N.K&\]]& ]} CH_LOCALE = { CATEGORY_DIGIT:,$=NOT( ,WSPACEP $<( ,GWORD'@LOC_ &> * .LINEBREAK/ ,C0  } CH_UNICODEe2UNIQm ,m 0 E, (@, 0 K+ &>U .EY 0^c} # 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__":Jdef dump(f, d,{items = 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 dump(f, OPCODES, "SRE_OP") dump(f, AT# *CH Af.write("#define cFLAG_TEMPLATE %d\n" %FIGNORECASHJ_LOCALFBMULTILINEHnDOTALLB0UNICD_VERBOWD^DEBUG@^ASCII@/) e 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 r}) _UNIB Z{ANY, RANGE, IN, me, NOT_ CATEGORY}) ESCAPEx{r"\a": (-@ord(4)),!b!'b"!f!f!n!n!r!r!t!t!v!v!\!\")) } "IA2 AT_BEGINNING_STRING), # start of string r"\b": (AT, AT_BOUNDARY),B?NON"d"IN, [(CATEGORY, _DIGIT)]QD/ >NOT3s3 XSPACEbS/ b 3w3 HWORDaW. a 2Z2dEND_STRING), # end of } FLAGS = {# standard flags"i": SRE_,_IGNORECASE("LTLOCALmMULTILINgUcDOTALLQx7TVERBOl# extensiona,SASCIIEttTEMPLAT{uUNICODE, } TYPW& |Eq GLOBAL) CXDEBUG1 class Verbose(Exception):|Dpass$RState# keeps trackate for parspdef __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 : 6 raise source.error('cannot refer to group defined in the same ' E 'lookbehind subpattern') class SubP:O7# a(,qintermediate form)def __init__(self, state, data=None)S!. " =(E!if2@ is 54LU = []/J qwidth =J Cdumpwlevel=0nl = True/u seqtypes = (tuple, list)!for op, av  aprint(p*" " + str(op), end=''QvPif op*INI# membervlanguag!r V.av^%==+1)aX%elnBRANCHVR 7j@i, aenumerate(av[1]*Nif i`h iN"OR"y1!a. .*+1$GROUPREF_EXISTS}Acond, item_yes uno = av-vE'', < %L'fv.no l_"ELSEv/nouisinstanc$, 'TNFalsi,j0if 7/nl#x  5Oelse?' '/ha) c 9*"av0c__repr+preturn .7?len6?len51delWindexvEdel [b?get? ?h, slicern(self.state, self.data[index]) mreturn! def __setitem__(F!, B, code):(Kb! =" HoinsertC.-jIcappendI.& ;getwidth=# determine the % (min, max) for this subpatternU"if=5is not None'h+Alo = hi = 0qop, av i Sif op is BRANCHtTMAXREPEAT - 1`jv~z^av[1]Y%l, h = av.WV!min(i, l"max(j, h" mlo + i7ihi + 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 TokenizerZe__initgstringWistext = isinstance(*V, strz. =5ing!ifW$RY8_ng, 'latin1'3) self.decoded_string = %index = 0next = None __(kCdef r%):,W. 6try(@char[:];except IZErrorIm fereturnK2if xj= "\\"IwU += 10C F1+= } s / #praise e("bad escape (end of pattern)",;g, len() - 1) from"= +CbQmatchb,X j? oHYF TruBFals1get~xDthisWYoW6*VQwhile[2, n7setgPresul,!''8bfor _ in range(n/c@ not<`:set+%UbreaklI+= c 50Suntilterminator, name97 = ' !is N!#AaF@miss2" +,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 insideiacter class  code = ESCAPES.get(escape) !if": areturn@CATEGORICA and7[0] is INU6tryBc = Q[1:2]vv == "x"-# hexadecimal; (exactly two digits2c += source while(2, HEXDIGITS4dif len1Z != 4YTraiseUerror("incompleteS%s" % ,V rLITERAL, in[2:], 160%el#!u"jistextQ# uni 1Ofour24262uU2(_eight383/104LsZ chr(c) # `ValueE for invali7 cN}dimportEdataHft# named X e.g. \N{EM DASH}4dif notmatch('{')lmissing {"@char Xuntil('}', '!Qacter'> OCord(.lookup(Mn)Gexcept Keyundefined V0 %rk,E&11) +{r'\N{}' bin OCT W# octup to three&2,d J|1t8#uz> 0o377.'vI %s outside of 'd'range 0-z'N  return LITERAL, c elif c in DIGITS:!raise ValueErrorif len(escape) == 2:VASCIILETTER\`source.ebb('bad Xc %s' % ,q)F 3ord2[1]+gexceptApassO ""b def _(A,bstate)p# handleP code|expression= CATEGORIES.get_2odeV:C_ESCAP@!6try]3c =Q[1:2]au6"x"-# hexadecimal;6!,B += /while(2, HEX0 tJ!= 4v%incompletx/%sE 7$in[2:], 16I== "u" andjistextP# uni (exactly four digits\2426Y2qU2(_eight383/104L^Z chr(c) #  for invalidO g  N}dimportIdataft# named e.g. \N{EM DASH}4dif not$match('{'('$"missing {"%@char Xuntil('}', '!Qacter'> Q.lookup(Mn)Gl1Key4>undefined V0 %rk,E charname) + len(r'\N{}')) return LITERAL, celif c == "0":<# octal escape += source.getwhile(2, OCTDIGITS Bint(Hv[1:], 8/2in I  *or* decimal group reference (sighY$if_next e* (M'5if ]PC and?.[2 SJQL)+# got threedigits; this is anuqOc = #Z> 0o377*Traisexerror('y value %s outside of 'O'range 0-3' %,E3len \qd"\# notF, so   { #ifC< state.5s{!if%Qcheck*(i@"cano1 to2pen"_[ lookbehindD sGROUPREF, Vrinvalid.KR%d" %', F - 1})ifJ== 2in ASCIILETTERS"4"baM0 %s F 3ord2[1]+except VdE}Apass.& def _uniq(items\list(dict.fromkeys&") 9parse_sub(,, verbose, nestedW!# 1alternation: a|b|c V = []`append.vematch FtartCtell V TrueO{]!(_ O + 1D |nested and not items))  if not sourcematch("|"):!(abreak rif len(GV == 1+breturnc2[0]1subpattern = SubP r(state)$# check if allA share a common prefixwhile True|q = None&1forN# i1  #if1 ish5T<Aelifc[0] !=ME z7elsH#&0subes start with."%". 9 move it out of the branch(7 K"de .append(r>continue Xnext $i can be replaced byharacter set=set = [] ) op, av =]Pif opzLITERAL4set(C=IN and av[0]+!isnNEGATES0exth&avd4 A# weLstore this asK instead4a#< (Hcompiler may optimizQeven more((IN, _uniq(set)rX36VBRANCH, (,sJFdef _parse(,Mte, verbose, nested, first=False!# : a simple  0pre6ute constants into local variablesTZ6 = g)g$.g?.:0_le2lenord = ordry!3=B. is Q # enW>W<on "|)"< {Cget(dT O# skip whitespacey2ent}?WHITESPAC'<[== "# _  j #g or this == "\n": ]breakcontinue if this[0] == "\\Tcode = _escape(source,4, state)Lsubpatternappend(A)p#elr not in SPECIAL_CHARS L(LITERAL, _ord(/))]er.tell() - 1# character setset = [] =1. 0 ##2if umatch(":"):!'pass # handleyclassestQP.next:'['<Simport warningC . (b'Possible nested at position %d' %T,JrFutureW;cklevel=Z=+ 69 \VnegatN*^"&eck remaiM while True;[Jget(dois NonD%Traiseerror("unterminaP n";I Pq0 - Q]" an]1!<1*0?els8!etin '-&~|'" $''/%sO='difference' Mp== '-'  9 'iI0sec C&Csymmetric ~Kounion')4 9"$tO vo-E # potential rangeK20thaEY';at ]  "raise source.error("unterminated character set", 6Vtell() - here)Aif that == "]":$tif code1[0] is IN+/,# =4_1][0][setappend(6U)(LITERAL, _ord("-"))8_break/\\2 = _class_escape(j,EOelse-?'-'(import warnings(%. (+ /'Possiblel difference at position %d' % MQ./2)rFutureW, stacklevel=nes?+ 6  843!= 71 or21msg = "barange %s-%s"POthisA -msg, len(@s) + 1 +/at'loK#hi"?2[1if hi < lo:RANGE, (lo, hi7 q1K/1[2)) 0setruniq(set# XXX: should movoptimizato compiler!_@if _B[P1 and [0(# d Wif negatsubpatternS(NOT_m,/1] Ujset[0]6? et.insert(0, (NEGATE, None#7map#on can't be added here because # global flags still are not known3 subpatternappend((IN, set)) - elif this in REPEAT_CHARS:## repeat previous item#= source.tell()!ij== "?"`dmin, max = 0, 1<>*>2MAXc G+G 61, G> F{F$ifPnext }'QLITERAL, _ord(*))J8continue L(lo = hi = ""qYwhilein DIGIT-Dlo +;get"match(",") )|5/hi Oelseq-lo!ifc})b`.seek(L_if lomin = int(loW0if %&>=Kg raise OverflowError("the$ tition number is too large"{_if hii .hi9?ax ]{<5&(e'fKgreater than-",M^o! -E /PAsserunsupported quantifier %r" % (char,# figure out which1 to)at9T6 = FY[-1:]B9:Non:!or`[0][0].ATUvnothingE a + len))  if item[0][0] in _REPEATCODES: raise source.error("multiple repeat",6 EC tell() - here + len(this))E s SUBPATTERNgroup, add_flags, del 5p =)1]e1if ? is None and notNUJytem = pc#if<match("?")>subpattern[-1] = (MIN, (min, max, )OelseR/AXRPelif z == "."[append((ANY,8?)) E(Ectart =.1@Ni= Trueaname =t I = 0 # optionsUEcharJget(#1if &^ O!dunexpected end of #"ePn`# python extens( <) # dB: skip forward to$ <?D.getuntil(">", "#>!if&.isidentifier(j0msg = "badPacterua %r" %NAmsg,^) + 1;p"=qbackreferencU|\)\0gidQtate.@dictg(8$id(Irunknown 5@PsQcheck(gid):  %raise source.error("cannot refer to an open group", Blen(name) + 1)>state.checklookbehindsS(gid,@ubpatternappend((GROUPREF, gid):continue _else:cchar =Oget(g1if .ois NonTXunexpected end of "uHknown extension ?P" +2$elo== ":"F# non-capturingfp ! => ! m#m}comment@uwhile Tru#ifo.next &@miss), unterminagtell() - start )5/_break9Bin "=!t'Amsg, lenO + 1? ?try\~O= in'6 +?< 0d 2`ValueEvexcept *\ 1badacter iOQ from#b !onumberwE+ >= MAXGROUPS sinvalid'$%d - state.checklookbehindvH ,Litem_yes = _parse(,R, verbose, nes#ifi.| x/now/F{Anext|/y"  with more than two branches"?) _else:-item_no = None' if not source.match(")")UTraise1error("missing ), unterminated subpattern",tell() - startcappend((GROUPREF_EXISTS, (condgroup, 3yes Ono))Xcontinue elif char in FLAGS oro== "-"<}# flagsO = _parse_(,1te,a"if[1 is: # globaltxPfirstM4import warnin(%. (+ 'F&`at theQrt of expression %r%s' % TXN.string[:20],'truncate long regexeE4' (=d)' if lengp) > 20 ? '')#DeprecationW~!cklevel=nesx?+ 6i Hif (state.p & SRE__VERBOSE) and_verbo Q/V+nD2addR, del / =*unknown extenxA?" +! 1j) + 1)R!#  :ent#if!isx>tryZ=Hqte.open^(name qexcept 0 as W-err.msg,_Q from Csub_CT = (( Eor ( K(* p{3subXy%, a1CJ<H 8@ subpattern"?, source.tell() - start):if group is not None:"gstate.close.(:, pMsubpatternappend((SUBPATTERN, 5add_flags, del Up))) yelif this == "^"hAT, AT_BEGINNINGL$L:ENDFs,raise AssertionError("unsupported special character %r" % (,^# unpack non-capturingsfor i in range(len())[::-1]#op, av = %1[i]JAif o<!U = avM0D@A andMB rF: i+1] = pgreturn def _parseB(,1te,t)f0get1get1= 0 !ifMg != "->while Tru = FLAGS[{2if r.istextqn== 'L' (msg = "bad inline w`s: can0use= with a str "Ie:msg,elBu))u'_bytes/!|=` @if (> & TYPE_)(: !Hbs 'a', 'u'^'L' are incompatiblegJget(/isdP"miss-, : or )"Ugn ")-:\breakk"in$Dqunknown#" .isalpha()  rPmsg, I)bs)5|= h&if% & GLOBALWon global fl ag", 1) if char == "-": sourceget(/3vis None4Sraise7.error("missing flag"Hnot in FLAGSMmsg = "unknown@.isalpha() else fmsg, len()while Tru" =[4]b!if & TYPE_bad inline5`s: canrturn ofLs 'a', 'u' and 'L'"sQm6msg$@del_As |=p F# = = !:,Mk:kYbreak2"8W&:N 'fassert6J6if k& GLOBAL /aglobal 3add&|Bm zQed onl6offh re l,k def fixQ(src,"s)q# CheckU2fixp accordto the type of pattern (str or bytesif isinstancei3strgbs & SRr_LOCALE$bValueE}Buse 1 with a 0if < rZASCIIq$&|=uUNICODE/el& Mra1s are incompatible+Sx(6y7|rv-C KG$Pparseu=0, state=e!# 'T 're' into list (opcode, argument) tuples K = Tokenizers)"ifr U@ = S. sc$.=[try: p = _:parse_sub(source, state, flags & SRE_FLAG_VERBOSE, 0) except Verbose:c# the .G was switched on inside(pattern. to beF!on!Psafe /, we'll @wholFing again...A@ = S(.==s | G.str = str.c.seek(^Qp = _TATrue@G+p.1ix_i(str, !) 32if .next is not Noniassert(a== ")"BTraise!error("unbalancedaenthesis"xeDEBUG:Usp.dump(1return p defRse_templatej)C#% 're' replacementu into list of literals and# group referencess = Tokenizerw @sgetA.get+@0![]c*=  append =.@1addW(index, pos1if " >s.,s!.|invalidb %d" %OgAi. Y(''.join()'B4del"[:!C5(le@2s),I[s0gH f2ate `while @0thi1if +isbreak # /ofhm*G@[0] >6\\"y r01c =|&[1#Aif cFgEname = "!ifs.match("<">! %@miss3"<"^'nsuntil(">", " 5Pame.intifier(:try)v" = [s .-`@KeyEVId*Rknownh0 %r"n7els@Oint(YC?< 0*QValue `!&TPs@bad character in group name %r" % ?, @len(;) + 1) from None?if index >= MAXGROUPS:+} raise s.error("invalid greference %dY# 1adde(U /elif c == "0"if s.next in OCTDIGITthis += sget()fO0S lappend(chr(int(/[1:], 8) & 0xff)?in isoctal = Fals E#Yif (cZQ and -2]SH)*_ ' >Tru#Lc = |l> 0o377W <' escape value %s outside of 'tN 'range 0-1' %r,' 4=rc(sif not <)L - 1.seM>try0 = ESCAPES[J][1]X-except KeyERin 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.Ps = [ 1 is )xN#('~') for sX@]Rbreturn$s,As def expand_template( s, match2g =.zWUemptystring[:0t'm4 = Z=% ="[:;try: for index, group in Gs: literals[-a] = g(1) or empty0except ISVErrorGpraise e("invalidl reference %d" %)Qbreturnbd.join(@) # Wrapper module for _ssl, providing some additional facilities # implementedPython. Written by Bill Janssen. """Thisrh"esgRmore Eic supportSSL. Object types: SSLSocket -- subQ of s. which does1 over the&1 Eu5ionU{TAion d2I/Ops Func;cert_time_to_secondsGconvert @ strY2useO5qificate7 `notBef!and notAfter f to integerFApastpEpoch (ovaluesBQ1rom.90())fetch_server_ (HOST, PORT))&d!by6cP runnM0on aA at 4h_. NoJBa3is performed. I[ constantSSL_ERROR_ZERO_RETURN WANT_READ\WRITEX509_LOOKUPxSYSCALLSdCONNECT &7EOFsINVALIDCODE Th@llowA define prequires that one side is a@/'Jfhe other*: CERT_NONE - nob/s 2R are Ted (or willbe looked#if2ed)lOPTIONAL -mY5not]g, but @j. b0@ed, 3if afails,QconneK Palso 0REQUIREDr4 bew `  identify variouAprotocol PROTOCOL_SSLv2 326TLSTLS_CLIENTiSERVER+v1_2 almessage descrip1s a  http://www.iana.org/assignments/tls-parameterZ.xml#"-6 ALERT_DESCRIPTION_CLOSE_NOTIFYUNEXPECTED_MESSAGE%BAD_RECORD_MAC!OVERFLOW"DECOMPRESSoFAILURkHANDSHAKE_$CERTIFICATFUNSUPPOR* _REVOKED&_EXPIR&UNKNOWNLILLEGAL_PARAMETER$>?_CAACCESS_DENIkDE_ERRO\DECRYPT PROTOCOL_VERINSUFFICIENT_SECURIT]INTERNALlUSER_CANCELLNO_RENEGOTIA_EXTENUNOBTAINABL?GNIZED_NAM$ _STATUS_RESPONS2HASH_VALU-PSK_IDENTb""" import sys os from collections &namedtuple#DenumE @as _ P, Int   DFlag X_ssl # if we can'tf it, let the error propagate HeOPENSS|_NUMBER, MINFOO_SSLContext, MemoryBIO, SSLSession4 ( @SSLE,ZeroReturnWantReadRWriteGrSyscallz6EOF CertVerifica;)qtxt2obj U, nid :RAND_status, 3add Dbyteqpseudo_Q try:^Begd except I2# LibreSSL does notBvide=h_pass HAS_SNI, BECDH 2NPN $AL RSSLv2 3 aTLSv1,B'_1_4/3 u_DEFAULT_CIPHERS, _5API&3 _6._convert_'Method', __"__lambda name: name.startswith('PROTOCOL_') and name != SSLv23', source=_ssl) _IntFlag._convert_(&'Options', __R"__?alambdae:.ROP_'))hMEnumhAlertDescrirqALERT_DESCRIPTIONSSLErrorNumber~SSL_ERRORv^`VerifyboVERIFYpfpOModeC_x_ = _SSLMethod.UTLS _+NAMES = {value^A forg!, 8 ing@__mes__.items()} v2_IF_EXISTTgetattr(,! ', None) class TLSVersion('Y!):MINIMUM_SUPPORTED2ssl_5'3)ZTLSv1_'_1!2@'_2! ~a!_3!?MAX %_TLSContentType*3""" types (record layer) }See RFC 8446, sec{2 B.1"""&CHANGE_CIPHER_SPEC = 203HANDSHAKEqAPPLICA#@DATA# pseudo cWHEADER = 0x10jINNER_CONTENT_TYPd1f B.messages"6""LOSE_NOTIFYUNEXPECTED_MESSAG1BAD_RECORD_MAORDECRYOAFAIL2[/OVERFLOWGDECOMPRESS7 URk3k_40NO_g IF34k k%UNy :36a_REVOK-44REXPIR5UNKNOWN = 46ILLEGAL_PARAMET!47, _CY!48ACCESS_DENIc9)"DE8B = 5s EXa_RESTRICTION = 60 PROTOCOL_VERSION = 70INSUFFICIENT_SECURITY1TERNAL_ERROR = 87APPROPRIATE_FALLBACK 68USER_CANCELED = 97NO_RENEGOTIAT"10MISSING_EXTEN2109NNSUPPORTED 1<CERTIFICUNOBTAINABLE = 11UNRECOGNIZED_NAM2_HBAD_CSTATUS_RESPONS*3*HASH_VALU%4%UNKNOWN_PSK_IDENTR1115jaREQUIR""11:pNO_APPLDION_20 class _TLSMessageType(_IntEnum):d3""" types (handshake protocol) + See RFC 8446, section B.1"""&@HELLQUEST = xL7+tSERVER_c~@IFY_Ge`NEWSES`_TICKEaKEND_OF_EARLY_DATA = FQHRETRPCiENCRYP-SKEY_EXCHANG21:1DON22PVERIFR4 kaFINISH2cbRL = 2d.LEMENTAL72xPUPDAT2BNEXTiQ = 67'MESSAGE_Y5+_CIPHER_SPEC x0101 if sys.platform == "win32"from _ssl import enum_certificates,Qrls /dsocket1 , SOCK_STREAM, create_conn:@SOL_6 ET>c_TYPE UR as _ `base64A # for DER-to-PEM transla12Terrno warnings X_error = OSE  # keep that public name in modulepspace }NEL_BIND+['tls-unique'] HAS_NECHECK_COMMONhasattr(, 'HOSTFLAG2SUBJECT') @TRICP{_DEFAULTFS CP= SSL2Ver1ion def _dns_match(dn, hosting accord !toF6125R6.4.33- HG s are compared lower case.- For IDNA, both dn and must be encoded*IDN A-label (ACE)K$Partial wildcards like 'www*.example.org', multiple,a, sole 5 or svs other then left-most label are not! supported and a CertificateError is raised.2- A wildcard must match at least one character41"""<if not dn:return False ]s = dn.count('*') # speed up common case w/os)lN sdn.lower() == hostname&ifVG > 1E -({"too manyEFin cbP DNS w: {!r}.".format(dn))dn_leftmost, sep, dn_remainder$partition('.'8if '*' in0c# Only&/n segment KPcan ocbe present_Ethe crlabel: c" 8sepno right sideEsole without addM1al Qs are,0 != &alO?ing Gsl h /ed .#P2 orb Mi )Ln]1O def _inet_paton(ip)"""Try to convert an IP;@resspacked binary Spds IPv41es on all plat-s@IPv6;6f!# ) also accepts strings like '1', '127. Bsome-Ttraild# data127.0.0.1 whatever'{2tryv0add_socket.C ex1 OSe= # "N2[2pasFelse59if nPntoa(w.I# injective ,d(FP &# refuse` short4a[f`XJBValu U"", quad-dotVO) ) try: return _socket.inet_pton(AF_INET6, ipname);except OSErrorOaise Value ("{!r} is neither an IPv4 no 16 "S "address.".format( Attributt$# not availablepBpassr: def _ip#_match(certP, hos)"""Exact -ing of IP D2es.RFC 6125 explicitly doesn't defineWalgorithm for this(section 1.7.2 - "OutiScope").&"""# OpenSSL may a trail@newlmto a subjectAltName's,S# commonly woth6Res. Strip offa"\nbip = _a H0.rs<"()5=b Y_v,#Verify that *l* (in decodedPrmat as kQed byBSSLS:pgetpeer=2())es the *@*. 2818 and Lrules are followedrThe funenQes ra\than dNSEs ifaeevalid  I0ng.4supported on all plats7IPv3/4 wiT$ ( Cton)Certificafailure. On success,m)YsBhing if ~b empty or no,,\ needs a XjQrcontext## "CERT_OPTIONALEREQUIRED" }_ Q(4# N " (C casSi2Nond0dnseas = []jQsan =Hk.get('F$, `key, vMv in sanif key == 'DNS'0is n_Y @?Cs.append(Ev#'elBIP A 3_ipk pend(value)  if not dnsnames: # The subject is only checked when thereno dNSName entryE$inD0Alt"0for in cert.get('pf', ())0key, value7:sub#' # XXX according to RFC 2818, most specific Common G# must be used.if key == 'cGF',_eq_match(`, host{ 4mreturnSs.appendU)+tif len("V) > 1raise CertateError("Q %r "Hg"doesn't 0 eij of %s)4% (F, ', '.join(map(repr,m2)))-el/==:/%r#5[0]/se,no appropriate - o= fields wAfound") DefaultVerifyPaths = dtuple("!!","cafile capath openssl_K_env1"""<def get_d!_v_#s(A"""R w/ C andJ"""q@part@_sslg # environment vars shadoww$pS= os..X(iR[0], "1]~402023]) ({ if| 0.is) else NoneX JBdir(I*^class _ASN1O([", "nid shorP long-T oid""""ASN.1 oNP idenNer lookup__slots__ = (IY__new__(cls,_Phsuper().**_txt2obj(oid,%s=False)\@amethodmrfromnidm7nidm`"""Cre  1 OpenSSL numeric IDQ  1nidv3ame?ame, O" return super().__new__(cls, *_txt2obj(name, 2=True)) class Purpose(_ASN1Object, _Enum): """SSLContext pu/ flags with X509v3 Extended Key Usage oOsGSERVER_AUTH = '1.3.6.1.5.5.7.3.1'&oCLIENT&%2'&(_ 6An  holds various -related configuration opQs and data, such as certificate# possibly a private key.""">_windows_9 _stores = ("CA", "ROOT") +sslsocket_= None #S is assigned $r.;q;;<Idef ; protocol=PROTOCOL_TLS, *argY0*kw g'wself =  Q)p2"re2elfencode_host(X$, q%if'\`telif isinstance(XW, str]@#.('idna').de('ascii'OelseI :Rwrap_ , server_side=False,3do_handshake_on_connect2suppress_ragged_eofs/ =[QssionC4lesG Ying before it call8x# ctx._p(.>._create(/T= e %c =n 7 v? -c= "sey3bio}incoming, outgo } $'rNeed toehere because ) can only"# b` ASCIIC &)&   h!._  &)D , )  def set_npn_protocols(self, C): (s = bytearray()Afor !jcol inEDKbC$s(1, 'ascii'P)if len(b) == 0 orZ> 255U0raise SSLError('NPNs must be 1 to@klengthws.append( "0ext"5b) B.._Z2)}servername_callback_i< " is None5snid! =&;els3pif not _able( |BType"EaG object"2him_cb(sslobj, q, sslctx5%1 = _encode_host= ?creturnk I Ew ]s)_et_alj /(k F lV/ALmi Xsh _load_windows_store_cert', purpose):tryq1!, ping, tr{qin enumxificates(ypXP# CA Ls are never PKCS#7]%ed0"if0ing5"x509_asn"+$if`s Trued@.oid#>B.  iexcept Permission Kwarnings. @("unp+rerate W 8 7"k!ifs] verify_locations(cadata=sGBqdefault6*"=P3.SERVER_AUTHMisinstance(8, _ASN1O1W K3ys.platform[win32.name in self._windows_cert_stores: self._load0+6!s( name, purpose)C; set_default_verify_paths() )if hasattr(_SSLContext, 'minimum5fsion')@propertyBKdef 1(5'return TLSVerV(super().=4@.setter{{, value"if7 ==f.SSLv3x.options &= ~O `.OP_NO0%v31H 0.___*Lf(ax< f = f f #{ <&, :).mH e|V.@ T Sassl, 'HOSTFLAG_NEVER_CHECK_SUBJECTg@host_checks_common_ Fancs = _;_flags & _ssl. aN/!=<=@u/: ?= ~OelseY| P  3BTrueA VR_msg_callbackKD"""TLS message 'La=The provides a debugging hook to analyzef aconnecO . Si1 isued for any8aTtocol{I(header, handshake, alert, and more), but notS`pplica|e data.L0Duetechnical limit+Vs, th can't be used68filtraffic orabort a . Any exception raised in the  callback is delayed until& handshake, read, or write operationJhas been performed. def msg_cb(conn, direc@ , version, content_type,/ edata):LFpass^S :class:`SSLSocket`Object` instanc P ```F!``%``"lBTLSV` enum memberint for unknowny. For aNframe header, it's93IR_TLSCnOTypesupportedHa .sEither a |!nua Gmessage,I^AlertG0n aGM^IoFs,  s! IRaw, decrypted7_REytes45""" inner = super()._&"f )is not NoneKbreturn&.user_funE?els5N@q.setterA t(self, %if^ 1SSLFxt, .__set__nL)!if!hasattr(P, '__ 7__'2R 5Error(f"{)O}pvable.")k 3:try'6 = ( except ValueM o_t; = 0.q r~.HEADER+ 3 #/eld_ALERTc a Y\  =< = msg_enum(msg_type) except ValueError:*Ypass return callback(conn, direction, vers 6LqcontentB, msv, data)qinner.user_funa% =|(super(SSLCXFxt, 0)._`.__set__(self, br@propertydef protocol-)_SSLMethod($).2Sverify_flagsWV#F"().7\u.setterg0, v) 5A 4I~49Amodeyr92 = z+"6tryhlMVG @587$@6 Ycreate_default_xt(purpose=P.SERVER_AUTH, *, cafile=None,2% bcapath(0 caV A"""C' a) object with  WRings.;NOTE: TheE and& may change anytimeOout priopdepreca5.R0s rsent a fair balance between maximumcompatibilityqcurity.&1"""if not isinstTq, _ASN1O%raise Typ /#=sets OP_NO7v2, 3 COMPRESSION#&sCIPHER_PREFERENCE6SINGLE_DH_USE3OP_"ECD# byV' =(PROTOCOL_TLS3if yO == |#ify certshost name in cliE = CERT_REQUIRED,`check_[Zb= True#ifB or  vSload_"lop"s(IQ)>T elcI !FNONEi# no explicitQY but the@%is#OPTIONAL9 ". Let's try to f syste# root CA certificate#s for the given purpose. This may fail silently.  context.load_default_certs(D), # OpenSSL 1.1.1 keylog file if hasattr(S2, '%_%qname'):,{ = os.environ.get('SSLKEYLOGFILE'5#ifx8 and not sys.flags.ignore_LFmentq@.}' =Wsreturn 0 def _create_unverified_ (protocol=PROTOCOL_TLS, *, J_reqs=CERT_NONE,bcheck_host1t=False,#=PSERVER_AUTHN 0ert+`=None, a(s capathCacadata A"""Cr a SSLCPq objectPython stdlib modules OAll  shall use tfunction to mKqs in order*keep commbetting!qne plac e`figurabMis less restrict thany&@()'sm inse backwardJcompatibilitw1"""!ifisinstancer, _ASN1OCg,raise TypeError/)L# sets OP_NO_SSLv2, 3 COMPRESSIONG#&sCIPHER_dPREFERENCE6SINGLE_DH_USE 3OP_"ECS# by Pn-' =: C. 1 = (x&ift1 isbEy_mode =5F ? BTrueC"HCValu"$ must be speci"H4 orSNp_chain( 5n # * CA rootsg pO1locG1s(cB,@> el@.:5!= )i# no explicit Y0 bu"e Qj2e i?#[OPTIONAL9lREQUIRED. Let ryd1temK2!CA5ificate] keylog file if hasattr(context, 'keylog_filename'):,0 = os.environ.get('SSLKEYLOGFILE')57if 8 and not sys.flags.ignore_LFmentqu.E' =Wmsreturn 0 # Used by http.client$no% is explicitly passed. _create_default_@#s_Y; =  s Backwards compatibility alias, even though it's a public p~gstdlibwunverified class SSLObjecD"""This Pimpleas an interface on top of a low-levelK! oL1 asa@VOpenSSL. c+captures the stateXnOconnectionPrbut doeprovide any network IO itself. needs to be performedI1thrRPseparsS"BIO"s which are 'sPaabstra layer. N2Uhave constructor. Instancesb!Mb``SSLC].wrap_bio``5fis typically uQframebauthorthat want asynchronou1forqmemory buffers0Whe.`mparedPSocket``, t:Blackfollowing fea:7p * Any , includ4methods sus ``recv`` ``send``.: * The ``do_handshake_onF5uppress_ragged_eofs`` machineryO1"""Wdef __init__(\, *args, **'gsraise TypeError(B0f"{@1.__P__.__6__} 9=/f"I C6().M)@cA(clsoming, outgo server_side=False,<$@host=None, sessionC#3 ls@ew__`sslobj"%_& n?inc    -`owner=_ (  Mproperty#44e Purren in+.q..b @context.setter def context(self, ctx): ._sslobj.) =% $@propertyNqsessionNI"""The SSLS! for client socket."""Gyyreturn [z9.se#, R$ =)\q_reused]T"""Was the0 during handshakeorver_sidehether this is a se0-0s3c hostnamcurrently set 4 ( SNI), or ``None`` if no5 isL6l2rea, len=1024, buffer=  Read up to 'len' bytes fromSSL object and Rthem.sBIf 'b'provided, R into$ I number of=.\#ifn@not v%lfND(len )ZOelse=5 vxBwrit'j, datahW ''mU\d7ten{VPargumxmust supportxinterfaceV Jq e()getpeercer^binary_form=FalseR"atted verQ1 ofc1 in Yificate L!by$o4endAMwchannelz w ]5wasa@, {}#a"zB t wvalidatedQ<6^selected_npn_protocol I=@ NPN= a{ st if a next4`negoti!ifZ!isded by oneP&s0if w.HAS_NPNw/selected_alpn_protocol(self): """Return the currently selected ALPN > as a string, or ``None``Pif a next4was not negotiaURor if[i`supporeby oneQ!ofpeers."""if _ssl.HAS_r.'Dobj.G_alp!) Tdef cipher$73-tuple ``(name,\ ssl_version, secret_bits)``a(rshared_sa list o"s :1 byXclient duhandshake orSthis  a valid server connection.7pcompres. 1 algorithm in use5 if5 N{dpending `numberp bytes that can be read immedT/lyErf5do_QStartSSL/TLS . n f Tlounwrapf shutdownkr3_get_channel_bik, cb_type="tls-unique"CGet < < data for# Raise ValueErr8i`reques``F]3. y6or evailable (e.g. before)K7$ identifyingICdD SSL/. K Qrverify___post @ @) 3]copydoc(funcK"""Copy doc/P fromObject to dSocket@.__doc__ = getattr(SSL5#, "Z4__),:" class SSLSocke&t(socket): """This class implements a subtype of 3. that wrapsCthe underlying OS/ in an SSL context when necessary, andCprovides read write methods overwchannel. <def __init__(self, *args, **kw raise TypeError(B0f"{@1.____.__name__} does not have a public "Aconstructor. Instances are returned by7BSSLC#.X_i6().`)@|create(cls,}#, server_side=False, do_handshake_on_connect=True,Lsuppress_ragged_eofs+\@hostO=NonA sessioni\@.get opt(SOL_SOCKET, SO_TYPE) != r_STREAMDNotI"ed"only streame0re uorted")5 c CValu\"3Q can be specified J "in client mode+^" i7/in$ifu.check_1andI  M Frequires"({ = dict`amily=t!.f ,  r, proto $Sfilen (L Q` = clsMBew__super(SSLSElf).2elf.settimeouJ)ock.detach(". =b_$ = closed = i sslobj =  \'A._encode\(R+! # See if weue":trypgetpeer`Xexcept OSZ as e<if e.errno3 .ENOTCONN:  graise  connected = Fal_else:,UTrue hself._L $&ifm X# create the SSL object::try5wsslobj = context._wrap_socket(L;0, server_side 3lf.hostname,=downer=CQssionA._se7)Iif do_handshake_onEttimeout3get(\03if ! == 0.0W+# non-blocking#B ValueError(" should not be specified fork /s"b.d except (OS,)N[closeGareturnU@property#@_sslcopydoc!de|(g~K&$TosetterIW, ctxN]G =8.\#$ !if .o!is;Non& T.yF &" %PQ)q_reused0[7`t;at we can even withou&#  being set, e.g.C() first =%ed## EAGAIN.  self.getpeername() def read(! , len=1024, buffer=None):+/"""Read up to LEN bytes and return them.1Rzero-length string on EOF."""_._checkClosed()J2if sslobj is Araise ValueError(Aon cP or unwrapped SSL socket."i:tryU#ift?notx|.[4lenPf2JelsekHH@`exceptZ as xLif x.args[0] ==+_ERROR_EOFcsuppress_ragged_eofsI+039b''514SwriteJdataWP DATAthe underlychannel. snumber of"ofHactually transmittedNU_5.-'B@qcopydocS(CcertYbinary_form=Falsa_connect~x1selZ_npn_protocol]/%.HAS_NPN?&/alL/AL@  ocipher05 rshared_*sj self._sslobj.shared_ciphers() @_sslcopydocdef compression(self):0._checkClosed()2if sslobj is None=Aareturn9?els&O.Asend, data, flags=0'1not "ifZZ != 0aise ValueError("non-zeroLkallowed in calls to ) on %s" %L_class__lf#p.write($,zquper().4X y.to{_or_addr, ==rm"8to Pon instances ofJ20_SAelif s4!toj6yEX 3msg*args, **kw {# Ensure programs don'tm< unencryptf they try to# use this method.NotImplemented ?msg- 3all (count = 0-G with memoryviewP) as ,.cast("B"Pbyte_#amcElen((tRhile "< 6N.2v =PS[<.:][5U += v`2 ^CfileW , offset=0, """Send a /possibly by using os[@() il is^aclear-text socket. R>the total numbertst """  if self._sslobj is not None: dreturn-endfile_use_send(, offset, count)@;elsNP# os.98() works with plain sockets onlyHfuper()DI :def recv(, buflen=1024, flags=0)%._checkClosed(-"ifZV != 0\raise ValueError("non-zeroLallowed in calls to) on %s" %L_class__pRRread("%3^6S!) {V_intofer, nbytes=j5buffer and (JMP= len8fer#if? >/TYg   3 7  FfromN ~"con instances of]]A?len'Uh[I%L 49n>[F3msgl*args, **kw 8"NotImplemented?msg-/`32msg/, )Hwed on instances of " "%s" % self.__class__) :@_sslcopydocdef pending(2!):e._checkClosed()#if`sslobj is not NoneAEireturn-.pO?els80shutdown_, how=super().]Wt+aunwrap~  :s =l* J5 aise ValueError("No SSL per around " + str verify_client_post_handshake> .] ;Jp_real_c  ,?= +do-, block=False?ui_connectmttimeoutH3get6try/3if & == 0.0 and )-sX"=Iobj.(kfinall [9, addr, 7_ex.hserver_sid; Tcan'tN i<-<f mode"# Here we assume that the socket?,W5not#i3ed :Fcall. We'@ it,`nE it.K9 orMy attempt to{already-i ed.S!context._\_(3!, ,hostname,/`owner=k.QssionA._se.>_ex rc)(oVv@UR!if#.rc.= True  if self.do_handshake_on_connect: %  2)()(return rcexcept (OSError, Value )d\_sslobj = NoneFaraise Cdef (7g, addrPB"""Cs to remote ADDR, and then wraps Laion inbqan SSL channel."""ud._real0(, False)?_exc8Tru ac NAxs a new0dfrom abbclientd{s4pa tuple=taining thatQped with a server-sidk1theaess ofrnewsock5 = super().)#*context._B3et(#,]9[=Jsuppress_ragged_eofsGDJ_J=@bcopydozCget__binding2, cb_type="tls-unique"HsUais not (-.vpJelseK$ifl in CHANNEL_BINDING_TYPES5o(D"{0}"  nmplemented".format(mzqversioni5TV # Python doeort forward declaratbypes. SSLCT0ssl|Z`lass ={kSocket'object_c'O0 R, keyfile=Kf, certZoo%2_reqs=CERT_NONEaCssl_9=PROTOCOL_TLS, ca_ts qg+bcipherw): if serv er_side and not certfile: raise ValueError("$ must be specified for server-W"GN"operations")'`if key~4Xcontext = SSLC (ssl_version~&.verify_mode =T_reqs0ca_s!9@loadS>2loc(0e!ifRA]p_chain( *,D_ipherRset_c(5treturn wrap_socket(=,= ,, do_handshake_on_connect=9suppress_ragged_eofs=k) # some utility func5B deN_time_to_seconds9)eB"""R@the .C in .p since Epoch, given+astring reaenting "notBefore" or After" date from aqificateGin ``"%b %d %H:%M:%S %Y %Z"`` strpxLpmat (C NQle). ?fususe UTC (RFC 5280>2Month is one of: Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec *Zjshouldas GMT (see ASN1_TIME_print()"""eimportcalendar "."gmmFs = "Jan","Feb","Mar","ApMay","Jun"@"Jul! ug","Sep","Oct","Nov","Decz@_for<= 'GMT' # NOTE: no p, fixed2tryA"_number =1vs.index[:3].title()) + 1HgexceptV 'a %r doesqmatch 'O '"%%b%s"' % ,B7els3# found validltUJ[3:]Y2## an integer,~previous mk()-based/alement Hed a flo\1fraN%alare always zero her{$qgm((tt[0], tt[2:6]) PEM_HEADER = "-BEGIN CERTIFICATE!-"+GFOOT+?END)1DERe.B(derVbytesTTakesficate in bi8nary DER format and returns the PEM version of it as a string.""" '0f ='(base64.standard_b64encode(der_cert_bytes), 'ASCII', 'MAct')qss = [PEM_HEADER]+= [f[i:i+64] i in range(0, len(f), 64)4.append(NFOOTER + '\nk.join(ss) defato_DER A(pem _Ang):p"""TakepificateK`BDER-"dh- sequence"n{if not vqrtswith@ raise ValueError("Invaliding; must start MA %s"D %=rip().end%?endj?d ==[G0>-A\; deAs(d.I.e(]get_serv2(addr, ssl_p=PROTOCOL_TLS, ca~cs=None2"""Retrieve Afroml2 atpecified qAess,5PEM.+DIf 'd' is sS!, OCthe y against itE H0use!inpconnectvattemptzhost, port =%if0.7@_reqnCERT_REQUIRED?Oelse,ANONE(`contexz_create_stdlib_(h| = :dafile= Hn)Fsock/`.wrap_ 0et(0 sl 30derb.getpeR(True7S@_to_l<!%protocol_name(lP_*PNAMES} /, '') """Conats/fun[s interpreting results os_1t()&os.lstat(). Suggested usage: z1 im*r # Indicej!struct members69Stupleeed by  ST_MODE = 0 @INO 1 1DEV 2 NLINK = 3 UID = 4 ST_GID = 5 ST_SIZE = 6 ATIME = 7 M 8 C 9 # Extract bits from the mode def S_IMODE(): """Return+portion ofafile'sA that can be set by@os.chmod().1"""rUj & 0o7777?FMT'describesl_ type `170000(Constants used as) for various Xs # (not all are implemented onsystems) S_IFDIR@0o04u # directory!$CH!2!0chaer device(3BLKI6(Xblock$2REG$1#0mqregularH2IFO$0%$fifo (named pipe))#LNq1symbolic link%SOCK = 0o1bsocketq# FallbacksQ uncommon platform-specific cX@DOORX EPORT "WH p # Funcs to testdAeach~ kOSDIRlrTrue ifi0a.1 ==36DIRj/CHj#al~'CH~?BLKFz$6BLK?REGz6REGmOFIFOn1 s6IFOs/LNZ /n'LNN[yh[liLdoorgFFals]STn event x[ /WH4whiteoutWb# Nameppermiss:@SUID}o.0bit#SG &  @ENFM1S_I*# ing enforcBMVTX = 0o1000 # sticky bit S_IREAD = 0o0400Unix V7 synonym for (0USR0RWRITE1o200 # 0W0BEXEC/1` X0BRWXU070Amaskowner permissionsBRUSR/read by ."" # write#|#[execu%BRWXG%!07)]group3GRP/4/."2"#X#1#%CRWXOj 07others (not in 2)4OTH?4?>#2#$X$1$& # Names file flags UF_NODUMP "x0H0do Pdump 5.IMMUTABL."A may4be changed5kAPPENDc5only be appended to:kOPAQUE:8directory is opaque when view@hrough a union stackSNOUNLINKbe renamed or deletCOMPRESSE2QOS X:*hfs-compress:hHIDDEN"80j:dshouldEdisplayed SF_ARCHIVED1 BRrchiv2 22g 45SK [>o[SF_SNAPSHOT@is a snapshoth@ _[mode_table = ( c((S_IFLNK,Q"l"), 6SOCP"s"),LAMustar before IFREG and IFDIR as IF>3 ==|^7REG{-{&BLz: "b7DIR:d(CHc7IFO:ap")), Cr"),w|S_ISUID, /[LfY "S:Yx7GRP  1GRPG Y ?OTH  OTH|S_ISVTX, "t"@), (S_ISVTX, 8"T"GXOTHx")) ) def filemode(!):Q"""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 percentile,9,V8Mode (most commonKulti;@List`s?sua). quast Divide data into intervals with equal probability. =-  Calculate the arithmetic mean ("verage") of data: >>>#([-1.0, 2.5, 3.25, 5.75]) 2.625 bstandard medianRziscrete[([2, 3, 4, R.3.PG, or 50th percentile,\ata grouped into class a .ared onp valuesqvided. E.g. if your points are rounded to .nearest whole number1_3 ]) #doctest: +ELLIPSIS 2.83... This should bepD t@way: have twoi # inQ 1.5-Bthre1p0val -3 anBX'3.5-4.5. TheKthesf"s ing varispread -  */ Function pDescripb0p7nceb0Popx%. 1bSample)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(@, muWAExcesU A single e is defined: StatisticsErrorRa sub@of VK. """ __all__ 'NormalDist', Vfk geometric_kharmon!0E Khigh5low5ode Wultimru1quas', 'variance', ] import math tnumbersrandom from fractions 9FtdecimalDitertool;rgroupbydbisect9s_left, Rright-+hypot, sqrt, fabs, exp, erf, tau, log, fsum=operatorAitemgetter Zcolle@Coun # === Excep=== class StatisticsError(Value ): pass DPrivate utilitiesZ def _sum(data, start=0A5"""# []) -> (type, sum, c!) tReturn a high-precision) of the given numeric xU as a,Itogether with8r to be converted1and ea"s.AIf o;al argument ``R`` is@, it 2addUatotal.PIf ``4gempty,H(defaulting 0)Mr Bed. ExamplesR-2>>>[3, 2.25, 4.5, -01.0], 0.75)<"(<'float'>, (11, 1), 5Some sourcesround-off e5P willRavoided:# Built-ibs zero1e50, 1, - ] * 1000 007A), 3/ s s are also sup=& ZF\,[F(2, 3), F(7) A1, 4l5, 6)]t$s. t6 0)C?lDV = [D("0.1375"), E2108 E3061 u0419")]DI .K 90Mix2ypexcurrently trearn> that inCPallow1"""1= 0n, d = _exact_ratio(partials = {d: n}5t_get = A.get TRcoerce(int, 4WX0for0, v.Ss in 2RTP) # or raise Typt2bxin map(wa3E+= 1F7[d](d, 0) + n1pif None4FQ# The@ NANINF. We can ignohlMafinite^EY,just look at this special one# total = partials[None]  assert not _isfinite(total)$Qelse: 1# Sum all the pS sums using builtin.6 FIXME is this faster if we*Mm in order of denominator?K =6 (Fraction(n, d) for d, nIssorted(s.items())return (T, P, count) def"x)2try >Sx.is_0) # Likely a Decimalexcept AttributeErrorMUmath.xPCoerces to float first.cS2"""4 types T and SAa common, or raise Typ!. c@ion rules are currentn implementay detail. See?QeTestNtest class _s:RsticsAs+1"""7#Phttp://bugs.python.org/issue240685T]pbool, "1ial `Ib'same, no need5b anything. Put, so thae usual case (no BOSed) happens as soonIas possible"ifCS: oT,Mixed int & othereeKS21or  Zs6intSu`If oneGa (strict) subzK%8l(S, T)m7if #GT, S#OInts H7intJ m S,X%otfo# &3(or)4T, )"S,BpT.Gc m5AnyC mbjis disallowedmsg = "don't know how1 %s"%s` [(?% (T.__name__, S )vpexact_rZ(yB"""RReal number x|/p (numer$,1c) pairQ>>> _/^B0.25 b(1, 4)xbexpect@be aNt,C" )p# Optimh"ofbs. We uFmost ofte!`# usedBericuwill bets ry$make this as  # fast as possible.  if type(x) is float orDecimal:3; return x.as_integer_ratio()(:try5 # x may be an int, Fraction,uIIvral ABCo(x.numerator, x.denominwexcept AttributeError d  subclass8 ('# Just give up?NApassP(Overflowb, Valu)#1NANi&NFassert not _isfinitdq(x, Noneimsg = "can't convCI '{}' to /"Vraise Typ(msg.format(C(x).__name__)) def _e (v3, TC"""C{<n!icR T.""}.T(This covers the cases where T# K" i3F# a k$ (E"or)~^CTif isn0(T,(a) and $V != 12T =_H # FIXME: what do we CsoTpr{  UC) / jv9FelsenDfind_lteq(a, xuq'LocateleftmostD exactly equal2!x'4i = bisect_2N0f ioRlen(aa[i] == xi3 rlOrigh3b, lo=l=(5+ 1O - 1 rail_neg s, errmsg='negat'P"""It e ms, failingany are les{uan zerofor x in;uif x < 0  Statistics(&yield x # === Measures of centtendency (averages),mean(dataR=sample arithmetic 0]3!. b1>>>([1, 2, 3, 4, 4]62.8'cfrom f3s importDF >>> mean([F(3, 7), F(1, 21 A5, 3 1 ]) Fraction(13)  >>> from decimal import DEas D)mean([D("0.5"), 7 &62 3{M('0.5625')|&If ``data`` is empty, StatisticsError will be raised.1"""if iter(E)D :r = list#n'enif n < 1:m (' requires at least one lbpoint'pT, total, count = _sumvdassert1= nreturn _convert(D / n, T) def fJB"""C0to floats and compute the arithmetic E.This runs faster than0%a() fun=Pit always 2s ao!If:Qinput0set"it6 y[3.5, 4.0, 5.25OA4.25,2tryexcept TypeS,# HandleFPators t do not define __len__()e0(Vable)d!nonlocal0forx in enumerateD, start=1M:uyield x&0= fc)Felse ,&G E}"HZeroDivisionP78CNonegeometric_DRM/ i u containDzero, or=inegative valueNo special efforre made to achieve exact resultsz(However, tmay changeAsfuture.`Heround(H[54, 24, 36]), 9&236.WAexp((map(log,)jkV%Q non-4bE''ing posi|numbers')_oharmon^RV'!ofIThe 0, simes called0sub2AraryG,1thearecipr!o  reciprocals of the data, and is often appropriate whveraging quantities which are ratesG or ios, for example speeds. E!: -Suppose an investor purchasesequal value of shares in each ofFthree companies, with P/E (price/earning)Ja2.5, 3110.G@WhataeEQratio's portfolio?>>> harmonic_mean([g, 10]) # ForKFmentK23.6S Ussxarithmetic [ would giv>of about 5.167,is too high.\PIf `` ``qempty, Qy eleis less than zero-)```` will raise ``StatisticsError``1""" justificanbu\Gcs, seeFhttp://fixthepitch.pellucid.com/s-analysis-the-misc-cy-of-summary-s/`papers.ssrnWSsol3/cfm?abstract_id=2621087Aif iter(d)c :qr = list#errmsg = 'does not s4rt negat!s'>nQ'enPif n < 1x (o` requilat least on. point')p!el`(==a1x =X1[0]% sinstance(x, (numbWReal, Decimal))7Zx < 0>&return xJelseQMATypeC('ungsed type6try9`T, totcount = _sum(1 / xx_fail_neg#, except ZeroDivisione0sassert o1= n#_convert(n /T) # FIXME:c!ig ayp calculqmedians=B sorting? Quickselect? def *B"""Rf (middle)uqnumericW]5&es5Sodd, )V&\Iaeven, C]pinterpoAd byP5takuv{8Ctwo u([1, 3, 5]3R 3, 7#24.0 = "edfF(== 3"no for empty d ata") if n % 2 == 1:return data[n // 2]Felse&Bi = 9(:i - 1] +H i]) / 2 def median_low,)VB"""R{sthe low( of numericM!. rPWhen *`number&y points is odd,"middle value6ed.I itBeven3RsmallVdHtwo F`GH3>>>[1, 3, 5]m3$ 5, 7'(1"""= sorted-wn = lenB== 0M aise StatisticsError("no for emptyX1O< Bhigh !ofKROlarg&( %5h]Sgroup, interval=150th percentile ()I continuousB)TA2, 2L84, [!.7?A52, 4e352.uThis calculates." a , and should bex`used wAyourM42. Iabove example,Ij4s 1etc. actually represent!idZqclassesH0.5-1.5, 1.5-2 P2.5-3 O9The falls somewhere inHT` 3.5-4<polationto estimate it Op$al argum!``?Vval``hl gdefaults to 1. Changing 4a natur'`will c+e)I[;ed :GD ]A3.25 =2 @func9 does not checka@thercs are at least fapart. """ data = sorted() n = len ifA= 0:!%raise StatisticsError("no median for emptyh"[$elK1KQeturn'1[0]b# Find the value at midpoint. Remember this corresponds to+Gcentre of class interval.$2x ={bn // 2obj in (x,2)if isinstance(obj, (str, bytes)*.BType('expected nubut got %r' % obj06trysuL = x - / 2 # The lower limit uexcept ^# Mixed type. For now we just coerce\Rfloat;b(x) - t) g# Uses bisection searchR txr with log(n) time complexityP"AposiSof leftmost occurrencX<l1 = _find_lteq2, xs{YOrighZ e[l1...8H # Assuming always l1 <= l22r%l1 cf1- 02 -C"+ r;6L +@* (nxP - cff def modeB"""R@h6Rcommo i from discrete Qminal4. ``[@`` a&es0b, and s a singl0. T isQdard treatmenPode aly taught2schools:2>>>[1, 1, 2, 3"4]+36also works"no(non-numeric)l"red", "bluePgreenR'red'Ire are multiplesame frequency,_F@ fir!nePPencou/edu$, @', '*B* is$, !, !s"21"""pairs = CR(iter )._"(1 R C4[0];QIndexm ('\"')DNoneAYF@a liz 3tly s DWillmore than one result iO CRor an;if k>>> multimode('3aabcc') ['b'] >>> multimode(',ccddddeeffffgg4, 'd', 'f>*[1"""ccounts = C er(iter(data)).most_common(1max2 , P_item=next(groupby(!ps, key=!0getT1)), (0, [])Mreturn list(map{m-(0)b$)) # Notes on methods for computing quantiles # - # # There is no one perfect way tobe`@. H2we offer # twothat serve;mon needs. Most other packagsurveyedMed at lea+ne or both of thesekP, makthem # "standard" in'P sens "widely-adopt\nd reproducible".y are also easexplain,k)e manually, and have # straight-forward interpretations aren't surprising.The defaultFknown as "R6", "PERCENTILE.EXC","expected # valurank order s~pstics". alternativekL+R7m$INmaFor sample E! w\baa posi~probabilityabeyondArangt"Aata,R6 exclusa # reasonable choice. Consia randomrof nine:ps from EQpopul with a uniform distribu000.0%P1.0. b* #%` third4kedPpointdescribed by # betavariate(alpha=3,=7) which has=0.250, median!86Q # me 30AOnly< la" (HcorrespondsR6) givedesired cut 030% -@fallQbelow it1parto a res~n inv_cdf() funci idempotentRV B endst!to include<<7 & #`InsteaHr, it usiQ FmU3ior. Per Hyndman & Fan, "One nicpropertygF`verticLf Q7(p) dividetinto n - 1 #Avals[ exactly 100p$@ lieileft of #g0100(1 - p)% of the intervals lie to@right of Q7(p)." # If needed, other methods could be added. However, for now,T # position is that fewer opps make 3easier choices and/ # external packages can{Aused<anything morvanced. def quantiles(data, *, n=4,='exclusive'): """Divide *2*.o *n* continuousBwith equrobability. LReturns a lis] (n - 1) cut points separat D1Set~Ato 4Aquar (0default). +!10,0dec.  Rperce  which give@e 99sG C3100sized groups%Th.any iterableY0ainbsample6(are linearly`polate`tween yBIf **0set3*in%*,Qs treOa@pulaY0. minimum valueT6F0th VeF?max; *10=1""">if n < 1raise StatisticsError('n must"at least 1')D = sortedld = lenif ld < 2pnUhave p8two~#ifvU == ''bmd"esult = []1i in range(1, n2j, delta = divmod(i * m)F( G!= a[j] * D1) +`[j + 19/ nMr.append([fqr +>  1+ 11G"1 = P // nH#`cale i4*m/j = 1 if j else ld-> j # clampHA1 ..R*m - j* 1actg9athN{ W/) 3V%f'Unknown2: {`!r}') n=== Measuresspread ===See http://mathworld.wolfram.com/Varip.html #W1//mathworld.wolfram.com/SampleVariance.html #  http://en.wikipedia.org//Algorithms_for_calculating_vL # # Under no circumstfs use the so-called "computational formula4 # S ", as that is only suitable*e hand ons with a smalamount of low-precision data. It h`@erriSnumeric properties.`See a `arisonPQthreemethods here: # Rwww.johndcookblog/2008/09/26/[1ng-W-I@-of-uh-Ldard-devi8/ def _ss(, c=None): """Return sumusquare ?srequence :If ``c``uQ,@meanped in one pass, `MFfrom@ Aa secondF. Otherwise,1areM;Xas given. UhSBcaseAcareMait canM lead to garbage results.1"""@if c@not \`T, total, ce= _sum((x-c)**2x#)M7r(?@c = a!`@# Thqllowingshould mathematiy equal zero, but due rounding# error may notU2%2 _ - c)assert T == U(2=;2oM2 -=V2 ** 2 / lenK0< 0, 'negative=of r: %f' %\oN|uo, xbarVsNQ.H  0be ?1terof Real-valued numbers,at least two&!s.#op3argumentB, if,rV1 ofHa. If iU@miss+!or Fauto4}npis func when yourO8#a $Qa pop9Ron. TX' 1gentire:, see ``p,#``!Ex"s:2>>>= [2.75, 1b25, 0. A3.5](8\1.3720238095g If have already!ed(, !as| `` ``avoid re?$it>> m = mean(data) >>> variance(2, m1.3720238095 24This function does not check that ``xbar`` is actually the mean of y ``n``. Giving arbitrary values forKmay lead to invalid orimpossible results.Decimals and Fras are supported:+bfrom d4 U3rt CQ as Dm)0[D("27.5"), D("30.2 4#41.75")]c^('31.01875')fFF(1, 6), 2 D5, 3s@(67, 108q1"""Mqif iter ):r = list#n'enif n < 2:raise StatisticsError('K requires atqst two prpoints'3T, ss = _ssp , lreturn _convert(ss / (n - 1), T) def puAmu=None)B"""RHapopula6E of should be a sequence orPaof Real-d numbers, with1oneU&. The op al argument mu, if given, ze0. I@misso0or ,utomatic@calc#edQYUse t5to &J&Nventire J.To estimatTe 9a sample$``W&``{!isI"usaa better choice!ExHs = [0.0, 1.25, 1.`75, 2.Q3.25]k >y9 If you have already!d" ,2can pass it a=fsecondto avoid re'itAmu =tB, mu:>=;6_24.819&141 M1, 2:o13, 729J1s9:7one:9, ss = _ss(d&ata, mu) return _convert(ss / n, T) def stdev(d5xbar=None):=B"""R@the square root of ample variance. 7dSee ```` for arguments and other details73>>>w[1.5, 275, 3.25, 4.75]1.08108741552198271"""Uvar =?2try(var.sqrt(#except AttributeError5Bmath64varXpY/muWpopulation$[p\"]0.986893273527251\]v[G## Normal Dis'#!!_nQ_dist_inv_cdf(pCs, sigma# There is no closed-form solu!toilase CDF+e # kRion, so we use a ral approxim instead{# Wichura, M.J. (1988). "Algorithm AS241: Percentage PoiN!". Applied Statistics. Blackwell Publishing. 37J(3): 477–484. doi:10.2307/2347330. JSTOR :q = p - 0.5if fabs(q) <= 0.425 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_107r +  6.87187_00749_20579_0830e+2) * r + +  4.23133_30701_60091_1252e+18 E1.0)Rx = num / denreturn mu + (x * sigma6r = p if q <= 0.0 else 1.0 - pC#sqrt(-log(r)9@if r3A5.0:'+ur - 1.6# Hash sum: 49.33206_50330_16102_8903/2= ( 7.74545_01427_83414_07640e-4M 2.27238_44989_26918_45833e- 2.41780_72517_74506_11770e- 27045_82524_52368_38258e+0 3.64784_83247_63204_605049 5.76949_72213691_405509 4.63033_78461_56aO29599 1.42343_71107_49683_5773Eden p1.0507516_44416_84324e-9 5.47593_80849_95344_9460O 1.51986_66563_61645_71966 1.48103_97642_7480096.89767_33498_51000_04306768301_83803_8494 2.05319_16266_37758_82187 ,55.0# 7.52583_31754_92896_71629/ @2.01a43992_92288_13265e-7 2.71155_55687_43487_57815e-5 24 09473_88078_43860e-39 2.65321_89526_57612_30930. 2.96560_57182_85048_9129( 78482_65399_17291_3358P5.4639111_64114_3696.65790_4643JA7772r 2.04426_389939_78564e-15 "`151_17/0164 88?7 `1.8463175_10054_68180 7.86869_1356132_591)@4875#029061_48525 1.36929_88092_27358_05310e-1) * r +  5.99832_20655_58879_37699A1.0)Sx = num / denif q < 0.0:x&!-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__ = {k'_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 0 in0ce F F@ dnot is-(a, (list, tuple)p"0 = ".@xbarK @cls(&q, stdev% , )sn, *, seed=None"Generate *n*s for a given sgauss =.&0eedRwT else"R()/#mu4 = Alf._*[o(8)@i innbge(n)]#3pdfx Probabilitycs@func. P(x <= X < x+dx)x5nceu ** 2.00if ,-8)7pdefinednwis zeroBexp((x -A)**2.0 / (-2.0*)sqrt(tau.c.QCumul  2X2&x)&"0.5 * (1.0 + erf !X2.0))J3p3 """Inverse cumulative distribution func . x : P(X <= x) = p Finds the value of random variable such thatprobability ofLF2being les^an or equal toIp#ue givenMd.EThis is also calledercent point*or quantileb!5""" @if p100.0p >= 1.0:!Araise StatisticsError('p must be in`range K>> N1 = NcDist(2.4, 1.6*2*3.2, 2.0*#1.:(N20.8035050657330205i"# See: "The K aumx Z)#  s r`estimaN[z'woO/`ies" -- Henry F. InmanYEdwin L. Bradley JrFhttp://dx.doi.org/10.1080/036109289088301276!ifJisinstance(,CTypeExpected an<; VaX, Y =o!, 1#(Y , Y._mu) < (X._sigma, X._mu): # sort to assure commutativity X, Y = Y, XX_var, Y = X.variance, Y .qif not 51 or ;:#ppraise SsticsError('overlap()8 defined when sigma is zero')N dv-wm = fabs(Y._mu - X<+dv eturn 1.0 - erf(dm / (2.0 *C`* sqrt&))Sa#n*3"- ~*b*M4Y._ X@dm**r+ dv * log(H" /Htx1 = (a + b) / dv"x2-r(%qcdf(x1)) 4) +C22ldef zscore(self, x)S"""Compute thpndard S0. (x - meanastdev U( Describes *x* in terms ofK`number2staUdeviationsDPaboveQbelow9n7normal distribu<.<5""" # https://www.s howto.com/probability-and-$1/z-/N|/2"f!fn!muj3elfzps@proper'ArithmeticG <qMdiansR me"ut"od(""t?oderPThe m-!isgpvalue xre which(X dens@func (pdf) takes its maximum Ufd eSC.gO9{Equarcn r ** 2.0u__add__(x1, x2Add a conetanother NaDist i2ce.TAIf *(*B, translate mu by`,sleavingunchangedb, add bot=Qs andkTsMathematical#ly, this works only if the two distributions are independent or4y# jointly normallyF5ed.A5""" if isinstance(x2, N<eDist):'{greturn (x1._mu + x2 q, hypotasigma, %))LH , U3 3def __sub__(x1S"""Subtract a cowanother .YAIf *(G* isB, translate by]1mu,@leaving unchangl" b_4, s0meaand addr@varisMathematicA-(/muA-HA?mulAMultiply both mu and'by7Used for rescaling, perhaps to  measuremGunitSs?qed withabsolute value o| Q * Q * fabs(x2))\truedivoDivide//1posuR q$py^]=neglpNegateswhile keeps:_same.v -___radd__ = __ rusW from/P-(x1  !eq"H, x28Twoaobject7c equal& irH#ar%oif notQtImpl%edx1._mu == x2._mu and x1._sigma == x2 def __hash__(self):"NormalDist objects * equal if their mgcare both%%."NareturnA(j`._mu, t())NreprFqf'{typeH).__name__}(mu={Rqmu!r},  F!r})' """A collection of string constants. Public module variables: whitespace -- a=@tainHall ASCII w, ascii_lowercas<+slettersC?uppC+ C ) digits0decimal 0B hex :Khexa>?oct>6octvqpunctua-acharackprintabl6Auidered A q __all__ = [" 4", capwords",ZB "$!o >    K(Fz Template"] import _7 # Some ps for cu-style ! classificJ= ' \t\n\r\v\f'= 'abcdefghijklmnopqrstuvwxyz/. = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ/3 = # +Q= '0123456789'=$ +' %' B(' }= r"""!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~"""  vT8 + [+@ # F@ionsch aren't avail#asp method# Capitalize 5 in, e.g. " aBc dEf " -> "Abc Def". s (scp=Nonez6""" [,sep])CiQSplitargument into uss$6, cAeach6 &,-AjoinYdW@%A. I0 opfal second sep is abs0or @runsum"s replaced by]aingle r@lead trailing whitespace a4re removed, otherwise sep is used to split and join the words. .1"""return (>or ' ').1 (x.capitalize() for x in s.Z1o)) #0 import re as _re from collections "ChainMap(  _sentinel_dict = {} class Template:"""A string 0sup$-substitux.(:delimiter = '$'# r'[a-z]' matchesznon-ASCII letters whenwith IGNORECASE, butK1out?flag. We can't add re.0to s because ofIbackward compatibility. So wed?a localG)0 pa#n.NSee https://bugs.python.org/issue31672-#id< = r'(?a:[_b0-9]*)8Xbrace.2Non=.' _def __init_subr__(cls)~uper().()D$Cif ''Qcls._9&__J*&0 = $H3elsV,$ `escape.;.#idY [b /!or6P = frJ{:}(?b (?P<#d>%) | # E sequencgQ two KsLnamed>{id})|L5o1a PK0 idKfierL {{@d>{bP#}} L&LJinvalid>0# OI ill-formedZ expr d%Cile(,|VERBOSE)_(self, tDelf.% =#D# SearchV$$, $_F, ${"},ny bare $'sCi,'moi = mo.start(')'lines = B[:i];(keepends=True<qif not $ colno = 1%) ;i - len(''=vs[:-1])V. s raise ValueError('IW placeholderXg:@ %d,i %d' %p(m!no, noa def substitute(self, mapping=_sentinel_dict, /, **kws): $if.J is 1&-Ue = kws@@elif,_ChainMap(kws)@ # Helper function for .sub(%def convert(mo# Check the most common path first.n0named = mo.group('W') orvbraced'<1if -,not None&return str(5[6]MPescapp[elf.delimiterinvalid')V 6#._-b Rraise ValueError('UnrecognizedK! iwitern',D s0pat,: !, 7template) dsafe_substitcJ>try +except KeyLP !C 8j8# Initialize TP.s __initRclass__(Cautomatically ed # only1sub0@es, b 1 it .oO #4! #AFormq # see PEP 3101 details and purpose of this5 # The hard parts are reused fromkC implementa . 6py're exV d as "_" # prefixed methodsqSstr. kpoveralln0ser\ed in _string.formatter_parser. # The field name  is implemented in _string.D6_6_split class Ff: def 5c(self, P, /, *args, **kw )9=preturn 9#.vF@2#, : s.; t 4nPused_ = set()Nqsult, _Dlf._`%, Q6, 2M.check_un#( ,   reX recursion_depth,k@auto_index=0;if @F < 0J@raise ValueError('Max G> exceeded'!U = []for literal_text,pec, conve\C(.("):U$# output the| | R$if G.append()p iflbre's a,,itvnot None@# ths some markup? ndn object and doe!# %)Jting#`handle ,ing when emptys are given.k'if*n == ''q:if OFals00can5switch from manual- 'H'specification to_maticM Pnumbemw=P( H5 $] += 1)el.isdigit(S 3~p# disabuqrg incr+ing, if it getsa # later on,_An an p@will be 6dF !=  given the field_name, find the object it references C# a0qargumen2came from1 obj, arg_used = self.get_f(args, kw)I@_T.add(R-) )# do any conversion onresulting <4obj>Qw4expformat spec, if neededo'_'@autod_index"_v%(=A@,/Da, recu_depth-12 =oR@appe8o .,(*N-4)return ''.join(K:),  /@def QvalueiQ, key:if isinstance(*Fint)!U[key]>Oelse+-check_unGpass*cD#, D(+\ #, 2&\!(ifois NonIzp :f== 's'2strp.el>r>?rep?a?\asciipraise VError("Unknown ifier {0!s}".{)"# s an iterable thatQtains tuples ofL-A# (l3`l_text,8{y(# 9 can be zero length&$, in which casere's no73 tocoutput#7if ]i=tA,is looked upts# withZ_Pthen qRDparsNEat_string) Ater_=*r(8wgiven aQ.'# 2: the field being looked up, e.g. "0.name" # @or "3Uup[3]%used_args:-a set of which  have been ,]@, kw : as passed in to vformat-def get_field(self, _,eJ!):3first, rest = _string.X2terOCv_split(T%) F`obj = u.cvalue([y3#Yp through the!of gu, doingl # pattr or @itemeneeded(pfor is_)0, i2$if# 0getB(obj, i)^"Oelse8fobj[i]qreturn G # This file is generated by mk2prep.py. DO NOT EDIT. """Library that exposes various tables foun*Ahe SPrep RFC 3454. There are two kindsA:0s, I member t/ is provided, and mapping3 function8 from unicodedata import ucd_3_2_0 !4@.uni<P_versg== '3.2.0' 1in_@_a1(i(ifz.category# != 'Cn': QFalserc = ord(if 0xFDD0 <= c </F0<M@(c &%FFF) not(0xFFFE,` b1_/`t([173, 847, 615056`7, 820#1204 588, 65279] + list(range(65024,65040)))(b(p3_exceps = { 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!f81f03\u03b9', 0x1f84:'\u1f04\u03b9', 0x1f85566 .77E8091a2\b3\c d e f "902#91 #92 #93 #94 9p29p29p2p p2p2p2p2p p p ap6pap6ap6ap6ap6ap6pap6pap6pap p p p p p p p bB7pbB:03bpbBD03acb+.#429b+4bmb~\c c cemc.\ 4d.!080d911',nd dQenc0nen ne c#13e4hhf:1f7f!fy fy.\y8K2fcP 0x20l!rst2102:'c Axb0cr2210]425b!Dxb0fDb:'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:'e031:'f', 0x2133:'m', 0x213e:'\u03b3f#c045:'d', 0x3371:'hpa3373:'au S5:'ov @80:''5T81:'n4"82_%bcE3:'m S4:'kand85:'kbSE6:'m E7:'g Ta:'pf4Tb:'nf4cmc90:'hzP91:'kP92:'m V93:'gE4:'t'a9Paa:'k7Vab:'mEc:'gcb4:'pvTb5:'n/$b6E7:'m E8:'k99wb wrEd:'mEe:'k fPc0:'k#c99Tc1:'mcc3:'bqwc6:'c\u2215kgd7:'co.AD8:'ddc9:'gy(bP Td:'kk433d7:'ph'd~pr5Tdc:'s6Rdd:'wvrfb00:'ffb01:'fi4fb02:'fl\@fb03'i4T5:'st66 q 0xfb13574\u0576?(14$655bR1:57eE7.dE01d45 21:'H E2:'c'30 0xE4:'e25:'526:' 27:'m 28:' A9:'j N2b:')#c:` Ed:'n4Ee:'o4Df:'p B10:'Rr1d411:' E2:'s'E3:'t 24:''25:'$ 26:' E7:'x428:'~D9:'zE34:'R!35R83A!37R R'38R!39R4aR3hcR!3dR4hfRh'40R4P''42R!43R44Rr4 7R48R!49R'4aR!4bR4cR!4dR4'68R!69R4'6a!6bR4cR!6dR4eR'6f'70RT72:'k'74R7'76R7zA8R'79'7a!7bR'7cR!7dR'7eR!7fR4>>'9cR'9eE'9fE!a2+h#a5cx1d4a6:'k', 0x1d4a9:'n', ra:'o', Eb:'pEc:'q Ee:'s Df:'t4Tb0:'uUb1:'v E2:'w E3:'x4E4:'yD5:'z Ud0:'a D1:'b4Ud2:'cE3:'d E4:'e E5:'f4E6:'gE7:'h E8:'i E9:'j4Ea:'kEb:'l Ec:'m dE8!deER'dfE'e0ETe1:'rh'e2R!e3RA'e4R!e5Rh'e6R!e7R48R!e9R46504R1505R46507E1508E49E'aE150d+e+4f+6510+1511+4!12+4&13+6514+65161517481519[a151b4c7538'39!3b4!3c['3d'3e!40I4'41!42A'43!4446'a!4bc4d'4e!4f4!504'6c'6d&6eZ756f'70'71'72!73Zh!74'75'76!77484"574157dZ''57'58'58'58'58'58'58'5a'5a'5a'5a'5a'5a'5a'5a'5a5'5a'5a'5a'5a'5a'5a55'5b'5b'5b'5b'5b'5b'5b(5bdd'd6dddd'db'dcd5l55C5o5p4r'P(5eP(5eee!ed608:'a', 0x1d609:'b', 0x1d60a:'c', Eb:'d Ec:'e Ed:'f4Ee:'gDf:'h U10:'i D1:'j4U12:'kE3:'l E4:'m E5:'n4E6:'oE7:'p E8:'q E9:'r4Ea:'sEb:'t Ec:'u Ed:'v4Ee:'wDf:'x U20:'y D1:'z4T3c:'a!3dRE'3eR!3fRl'40R!41R4'42R!43R44R!45R46R!47R48R!49R4aR!4bR4cR!4dR4eR!4fR4'50R!51R4'52R!53R44R!55R4'70R!71R4'72R!73R44R!75R46R!77R48R!79R4aR!7bR4cR!7dR4eR!7fR4'80R!81R4'82R!83R44R!85R46R!87R48R!89R4a8:'\u03b1#a92a3b4#ac5$d6e7f8H#b09$#b1K#b2b$3cH4#b5#b6fH7%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 b{e be $beHf bf@f f hf Vf H f `f f H #70~H$71 #71$H$71 $71 7#72 b6', 0x1d722:'\u03b7', 0x1d723:'\B8', 49$5a6b7cH8d$9eafb%c0Hc1$d%b8e%c3f4H#305$#3162 3 c 3 c 4~5 5$$b25 5 45 5 %b6H 5 5 b5 $baH6 b6 $bc6 b6 %beH b6@v6 c 6 h6 V6 c 6 c 6 c 6 c6  8~9 9$H9 9 9 9 H 9 9 9 H 9  9 H 9@Ha a a VZa H a 6 a H 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)) + l ist(range(8298,8304)) + l65529,65533p119155,63))) def in_table_c22(code): c = ord if c < 128: return False0uni@data.category? == "Cc"82Tru7Hc in c22_specials 1:uQ or \& u v3qRiter_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 FBLicensed to PSF under a Contributor Agreement. # See http://www.python.org/2.4/liOR for ing details. r"""& T allows youcspawn ses, connecttheir input/out@ pip+qobtain + a complete descriO8 ofQthe PP docu'@. McAPI ======== run(...): Runs a command, waits for it toplete, then retur2% 1Com#dProcess instance. PopejbA clas\flexibly executing in a new pPA CoRDts - DEVNULL: Special value that indicatesos.devnull should be used PIPE:E ga pipe<created STDOUT: dstderrD go\stdout Older API =_ call*3the code. check_]Same as ) but raises CalleqError()U(ifT is not 0\coutput^wdIcontents of`Gead of aqI gete @V_shellk 6Ycbstatusi5pa (exit", b ) tuple """ import builtinsTerrno i o!Dtime esignaly%hreadinguwarning!xtlib from V monotonic3_Ftypes try:Z1pwd except II#pwd = None7?grp74grp7 __all__ = ["m@", " 8get!",E "f+70run# P3Sub)TimeoutExpired L("]# NOTE: We i3QionalGclude list2cmdlinZit isBconsidered anG@rnallementation detail. issue10838.amsvcrt`q_winapi_mswindows = TrueModuleNotFound 2QFalseI\eposixsGYselecors else`e(CREATE_NEW_CONSOLE, PROCESS_GROUP")STD_INPUT_HANDE7OUT0 ,VERROR>oW_HIDEr ARTF_USESTDuUS, STHOWWINDOWE  ABOVE_NORMAL_PRIORITY_CLASS, BELOW B MHIGHKLIDLECREALTIMIPCREAT _WINDOW, DETACHED_PROCESS,=DEFAULT_ERROR_MODE, BREAKAWAY_FROM_JOB) P__all__.extend(["1NEW_CONSOLE", _GROUP""STD_INPUT_HANDD8OUT ==oW_HIDEpARTF_USESTD6S%ST2HOW[D oUPINFO#nRJBDHOC < EY "]) # Exception classes used by this module.  SubprocessError(=): pass )xCalledP, <!):`"""Rairwhen run() is cA with check=True and the Creturns a non-zero exit status.kAttributesxr cmd, <code, stdouterr, outputc1"""def __init__(selfBS7B=NonT1err q:.{' =h%Pcmd = d( =4stderr =2err3str= 512(V= getattr dect, '5 ',1#@/selAhaveadvantagerequiring any extradescriptor, contrarilye1/kqueue (also,b"y Re a singl# syscall) ifl0orsAollS7or'<d_Popen# =Wors.P3+:Oor if _mswindows'BOn Wpjust neo! `1._h0` wXwe no longer0# it, soZakernelFfree it.QBgetsldFmplicitlyn` instancfinalized72e `.`@hich `aA` as essin [1])!erhsnothingfor `_cleanup`,"do#"[1] https://docs.microsoft.com/en-us//desktop/ProcThJ/Gcreating-processes_active = Non(YIpassThis lists holds V s w1vpunderly5@ hadP# exi7I0tim#s  method got }ed: those NTes arCwait()edsynchronously from Sa new0obj i#!# <0ed,avoid zombiyM"[]fK>z!is{CHC in e<[:]31s =|._internal_x (_deadstate=sys.maxsize)^b`if res  ^ try:  _active.remove(inst) &except ValueError:#3!# This can happen if two threads create a new Po"nstance.R It's harmless that it was alU"y d, so ignorLpass PIPE = -1 STDOUT 2 DEVNULL 3 # XXX2function is only used by multiprocessing and the test suite, # bu0ere%be imported when Pythk`compilithout #E. def _optim_args_from_interpreter_flags()$"""Return a list of command-line arguments reproducqcurrentp1iza settings in sys.qA."""+Q = []v6' =(Ke2if "2> 0KC.Dd('-' + 'O' *+rCrgs 6S,@warn1ons #_x$2_map = { 'debug': 'd',# 'inspecti2ter 'dont_write_bytecode$BBq'no_sitSaverbosvI s_!inbAquieq@# -OC@hand/in}/ =6@for eP, opt rU.item"wv = getattr(.!s,Bo%  rQ* v) !ifR.isolated"I'oFelse$ C_environ)EQ Gqno_userA #s'@# -WMAionsCopts"[: *' N# 5, '=R', {}dev_mode = ('dev'B9if fF > 1s!"e:BytesWarning"m,elKGdefault:I4if B'BP4in < {W(3opt# -X options if dev_mode:  args.extend(('-X', 'dev'))# for opt in ('faulthandler(tracemallocimporttime',=c'showrefcount.@utf8oldparser')$ifvxoptionsOvalue = Y[opt]t2if %gis Tru@Parg =g 8?els,'%s=%s' % (opt,a(QOaarg)) epreturn % def call(*popen , ?out=None, **kw"""Run command withMuments. Wait " to-plete oras, then 3the code attribute.6Theh@ are= same asqAP constructor. Example:H1ret`=["ls", "-l"]G1"""P wp6try risp.wait(=k'except: # Including KeyboardInterruF qd that.Cvp.kill(X# We don't q) again.__exit__ doesYM*us`Traise1]heck_7))Q. If was zero9, otherwise CalledProcessErr D object will havZ}{ inu/7P funcS c[  ifbcmd = `.get(""90if $0is 9=+&[0{- Cw(,VfW0Oioutputk,r`  hBits ^K!If WAnon-["itG?s aa. The^JrJ+#2argw(B>>> ui(w, "/dev/nulbb'crw-r 1 root1, 3 Oct 18 2007 <\n' The stdout argument is not allowed as iBused internally. To capture standard error in the result, use stderr=STDOUT. A>>> check_output(["/bin/sh", "-c",'0...o"ls -l non_existent_file ; exit 0"];s)_^b'ls:L: No such Zor directory\n' ;PThere5an additional op X, "input",[ing you toGpass a str!to=subprocess's>qin. If8use thisGR3may!soxPopen constru's "stdin"BA, asFit too will beD  Example:1sedes/foo/bar/t=b"when; course of fooman events\n".8bar.qBy defaall communicain bytes, andrefore any`should / return value<$ext mode[ WZ'PdecodSccordClocale enco, or by "" if set. TMis triggered1@settSof text,Vs]universal_newlines&2"""Y2f 'o'qkwargs:praise V@ED(-,overridden.')Aif 'Vkv[]FNone# Explicitly K=) was previously equival;%to0%ans# emptyQ. ThaQmaintained Df ac dspatibilitm$0if !gs.get('r ')$&')GE= ''7els%b&Y>=t`run(*pq,out=PIPE, time,C=Truz"**o").6P cl) CoBtedPs(objectS"""A 9 tnhas finished runningTD#isd) Attribute: The listn0strsPed toe"() \8, negative csignalD GBm6! (!if"d:ard error (None if not captured). """ def __init__(self, args, returncode, stdout=Non 1err !):DP;.:! =A M' =Z %f# =o 2errAerr Crepr [' ={!r}'.format!),G'5%)];1if !isp-_.append('-c/))__gstderr_ "{}({})"$Atype)).__name__, ', '.join("))__class_getitem__ = pmethod(Ks.GenericAlias) :bcheck_nu: """Raise CalledProcessErrorthe exit < tn-zero.{ga rb.6, HV '0 run(*popenU%npr@_outFalse, timeG=@**kwOCun command withpuments  a Completh instance.3The%ed will have attributesbGq. By defaultj#1areP!d,HthosnQ0be {`. PassE$@PIPE80/orin order to!S them1If XX@TrueC r wasQ, it K1s a . Cw objectKrP!inq## &2if 6qstreamsQDwered\Rgiven]p takes too long, a TqExpired^exception"bei Th~i! o( al70 "i", allowing you toZp byhor a str"!to 3sub'qin. IfA`use thu!rgiP[1mayjRalso '0e P constructor's "stdin"2, aNi be@!ternally[1allQunica%ais in qPreforyyb shoula+be/ stdout and std+err will be bytes. If in text mode, any "input" should2a string$d stdout an Z&s decodedN according to locale enco, or by "" if set. T1 isHtriggered1@settSaany of,V`errors]universal_newlines. OThe other arguments are the same as forPopen constructor.C1"""iIput is not None:Nif kwargs.get('stdin'),0raise ValueE3o1mayr@bothuused.')|y[u] = PIPEif capture_output :out\^:err$Q H e % 'L ['with  I) v\0(*p B, **6)+vprocess6try g6,>3#= 3.communicate(, timeout=except T @Expijas exco^Vkill(Aif _mswindow2# W accumulates(6a single blocking)># read() call run on child th1s, YqE beBdonew`join()L@thosL8. G # _after_ Arequ@to collect thaoadd it!to 2ion dDexc.  7els;Q# POSIX _0 alQy popX#e /socfar in CJKwaitJjD: # Inclu KeyboardInterrupt,p handle*atJwe# We don't^+.__exit__ do!at*use 0ret )po>4Aheck. wQ CalledP.,E =T`stderr2err@return Complet{ss(process.args, retcode, stdouterr) def list2cmdline(seq): """"Translate a sequence of arguments into a command H:string, using the same rules asMS C runtime: 7E1) A\are delimited by white space, ch is either aA" or a tab.YR2) A surroundU double quotation marks isPinterpre as UingleegardlessCcontained within. Ar$edcan be embedTin an@p3` prece@by a backslas(L literal QrD4) BL reCaly, unEtheyrmmediately/ ao V5) IfOes iD,xevery pair N=/ . _numbeLAodd,MlastAr escapeOnext% ardescribed in31 3.W S# See &http://msdn.microsoft.com/en-us/library/17w5ykft.aspx<or search FC for.A"ParRC++ CV-Line8result = [];@needae = Falsf rgmap(os.fsdebbs_bufPQP# Add to separEthisQ fromo(eB if S.append(' ')B@(" "@arg)nI("\t0not5if @s "s%ch 6if c == '\\'# Don't know!we~(2yetV/j%c)!%elt"sL<.esb `\\' * len({:)*2uy P?!Oelse Normal cha42if t9't0ext$**ch`remain@Q,6anyY result.extend(bs_buf) if needquote:r9"0app[3'"'Xreturn ''.join('$) # Various tools for executing commands and lookat their outputstatus. # def get#R(cmd)B"""R(exitcode,IH) of|md in a shell. Ee@ strW'cmd'* with 'check_'Ja 2-tuple (. The locale encoddqis usedCPto dea` process newlinespA trailG1 ispped fromJ.d 4the can be interpretQaccor!toTBrule> function 'wait'. Example:\>>> import sub.'ls /bin/ls')1Z(0, 'D 2catEDjunkG1, 'cat: : No such file or directory5i  ey27, 'shfnot foundVskill $$3s(-15, '1"""2try xdata = ,,=True, text stderr=STDOUTkG+1= 0eexcept CalledPError as ex2ex.> S2ex.7c!0if [-1:] == '\n'T"A:-1]3B ,A-} '@dout.MLike3), fis ignoredPvalueaPntain,-#'s/. a(([WV xB[1] i_use_posix_spawn(mC.I if h4 requires aEidQmenta}@that,perly reqseQparen*V, & sets errno on$`followfailures#*  attribute a s +"edi0* FG%()0Prefer an+&leQwhich1use vfork()some cases for best performance.1"""!if _mswindows or not hasattr(os, 'posix_spawn'):5RW# os.Q() is>available,return False if sys.plat == 'darwin'c `a7call on macOS and properly reports errorsk3Tru# Check libc nameGrruntimeqversionD6tryPver =confstr('CS_GNU_LIBC_VERSION')9}# parse 'gn2.28' as (', (2, 28)3 pa= ver.split(max &=1&qif len(-f) != 2yreject unknown k%at$raise ValueE4=Uts[0] = tuple(map(int,*#1]b'.')))ialinux'{o=%k">="4S%# R4 a new LV ; implementation using vforkP_whichNp to the0ent&BcessO?i# Note: Don't useF in earlier@beca,it doesn'#E (even if62.26 added a pipe  #$)except (Attribut',3A, OS< )X$ vw4Bpass># By default, assumC(at!()'M _USE_POSIX_SPAWN = _use_>() class Popen(obU""" Execute a chilsgram in2pro+o0For+ote descrip!of@argu@s see Python doc.A-args: A string,}a sequence ofgJ bufsize: suppliFsPbuffeO 55a) func2whe4p creatoastdin/stdout2errRfile X1 eVHareplac#to%eb", cYstderr: These specifyaes' standardPinputRs output[n handles, reletively0preva_fn: (w only) AnW0be  edB8WFjust befor&(is executed.  close_fds: Controls ing or inheritf file descriptors. D' shell: If true, the command will be executed through%9Gcwd: Sets current directory beforeuhild isWEenv: DefineHenvironmLvariables forInew procesGtextdecode stdin,@out stderr us given encoding#(if set)T) system default otherwiseuniversal_newl: Alias of ,QvidedbackwardsxpatibilityPstartupinfo creationflags (Windows only)restore_signals (POSIX$X_session&_groupaextra_ aOuser:_umask@passerrors: Text ma handlPo useopobjects#Attributes:B V^err, pid, returMe/1""" _c_ed = False #< here since __del__ checks itdef __init__(self, args, bufsize=-1,X,a=None,z6out 2err 70pre 2_fn"o =T=2%=S, cwd83env -K# F /=0  tp=(), *,D  K    F=-1)g@"""C e Popen instance.Y_cleanup()# Held whPanythais caltwaitpid has beenLAupda`o prevpclobberV<0if Y(5poll() ar #rom multiplreads at o After acquidFlock!# must re-0 .to see if anead justfinished aQpid().%[_@pid_# =Ning.Lock( _input =  JlAunic_,if bufsize is Ngone: bufsize = -1 # Restore default,if not isinstance(:j, int)Uraise TypeError(", must be an6xeger") d_mswindowsRif preexec_fn isN}DValu~:supported on Wq% "G"platforms").;elsUu# POSIX"Lass_fds andPclose /warnings. 4("p;overriding >.", RuntimeW7L-| = Truestartupinfo_ ;_only a:if creationflags != 07 6?is 7Dself.args =  stdin =  ?out?err?pidreturncodme8$= e # Validate the combins of textuniversal_newlinesaAif ((4@6^bool(h)e)Subprocess@'Candisambiguwhen both''A arelied but Mdifferent. PasAe orxwother.'1b# Inpu}0out objects. The general principle\6likW# thil#@# Pag Child)-))p2cwrite ------> p2Tpc2preadU<+out--- c2pDW:err,1err,;err,6"On,]c >0filscriptors. On@7?!se3 ;`handle7pMaG'0%deko!. F 1-1  usPIPEs. The child objects are -1  # when not redirecting. !(p2cread, p2cwrite,B c2p0"orBeger  # make sure tha are all posi here so weQ do less# checkingVC codDAgid_+(o^&ZM^~ d?uidc&us[_reuidZeR .2"rR|oif pwd -V#p_ "on S0pwdI pwI).pw_uid   elif isinstance(user, int): !`uid = " Nelse-raise TypeError("User must be a string or anpyeger") Z0if t?< 0`CValuafbID cannognegative, got {uid}d:tryYif p2cwrite != -1 self.stdin = io.open(5, 'wb', bufsize)>1if Atext_mod9'$eTextIOWrapper(!, _through=True,uRline_buffe=; encoding= 0, e"s= if c2preadJ 7outK5O, 'rJ9eK?outHtif len(j) > 804 = [:76] + "...W&_getitem__ = method(types.GenericAlias)9@propertyXuniversal_newlinesb.# $ as retained @an ag of text_mode 1APIl. # compatibility. bpo-31756#Iq.setter>, m = bool(nDi_translate7, data, eK`ing, esn!! =(0.der(.24.replace("\r\n", "\n")/__ente6X .3xitc`, exc_I, value, tracebackBelf. ^& $+er 8 try: # Flushing a BufferedW%ar may <2 an~NR*in|-in{kfinall%if(KeyboardIwNruptb# https://bugs.python.org/issue25942# In the casee-a k we assume*oSIGINTJ!was also already sent to our child processes. Wu?n'tJblock indefinitely that is not user friendly. *# If we have not already waited a brief amount of time inJan interrup;.C() or .communicate() call, do so hereLfor consistencif self._sigint_m_secs > 0:R?tryMF(Bout= `)\except TimeoutExpirednMpassHp = 0 # Note that this has been done`return8Presum:e KeyboardI p# Wait { the process to terminate,avoid zombies{E)\def __del__(, _maxsize=sys. , _warn=Pings. )?!ifA._child_creatc# We didn't get0sucbfully 51 a D :hcode is None@ <ting sub?exit status3s a>e whichtPis only destroye parent pythonCh BS'(" %sstill running" %HIpid,? ResourceWar/",  # In casg]0hased on, check if it'sDnal_poll(_dead?$e=:x and _activCM , keep us alAPuntil'1canj on it9nq.appendget_devnull@qhasattr4, '.' &K = os.open(os.,fO_RDWR,[stdin_writeWinput|UR.RL `2BrokenPipeError]a+ Cmust ignore bCp pipe eE j!OSb~ as exci if.errno ==Kno.EINVAL.# bpo-19612, 30418: On Windows, n) failLRwith o JJFr UJ # process is still running but closed the pipe. Mpass]else:>eraise :try(self.stdin.%(),except BrokenPipeError? # communicate() must ignore b? eAsb!OSZz as exca if.errno ==Cno.EINVAL*9def, input=None, timeo)s"""Interact with process: Send data to [B and6 it3Rea)@from+1out, stderr, until end-of-file ireached. Wait foryterminate.The optional "" argument should be@be s toYTchildlR, or *Rif no=LA 9 5 returns a tuple (stdout,Gerr)By default, allion is in bytes,N`theref5any 3 w"be[ Ifptext mode (ind Pd by Q._)y||be a string(d%s decodedB`accordQto locale encoDby "" if set. TIis triggere ttWpany of ,Z5 orAuniversal_newline6"""Flf._ion_started{R Valu("Cannotdq after I `&")# Optimiza: If we are QPworrib s,#uhaven't#m(ed0we 0@ one3AzeroPs, usgselect#(pthreads@unnec6ary~Cif ($4|XQ[-,#err].count(fg) >= 2F4! = `| S_q_write(%'elF?outGN( =.[qJ =out n+er"Kerr.read()  self.stderr.close() ! GwaitYelse:&if timeout is not Non$V0end(@ = _D() +9 Pb >^ 2:try1stdout, " =_communicate(inp",  except KeyboardInterruptr# https://bugs.python.org/issue25942# See the detailed ent in .~.7ucasigintua= min(_fm_secs,iAAremaining_(K)C@Z 'p = 0 #Phing x should LK>_5(=-T~Expired*^MpassPraiseRresum z ofinallMion_started = TrueI4sts& Hreturn (y") fdef polly)#"""Check if child process has terminated. Set and hEcodeattribute.""")iAnal___$,  onvenience for UP when0put+s$ifY3`&$ -Xr _c\1out|R, ori)tout_seq5 Cskip_Aand_k=False -Dif ase/* ?if  D() >{ Mz (XIKargsA-output=b''.jowY), I0err:IIf wait(self, timeout=None): &"""Wait for child process to terminate; returns self. code."""L$iff is not mls0end@ = _D() +5H:try5p|`_wait(<)< except KeyboardInterruptQ# https://bugs.python.org/issue25942S# The first k\$ i] s brieflyL3theP+toJexit under &ommon assumption that it also received,+^CL generated SIGINT and will frapidly.6asigintout = min(_i_secs,a==remaining[()<Jelsex# = u #p = 0 #Phing pq should 3   f T~ExpiredIpassPraisearesume  3def _close_pipe_fdsp2cread, p2cwrite+2c2p+?c2p+ 2err+1err+q#tdevnull*always defined~'_fd = getattr3 '_!',i)with contextlib.ExitStack() as s {if _mswindowsQ if"n != -1"&X`.callbl] .C .4if KU3VvV3V zFz7/_f ?1os.DCs5&EAb!-1 &j=6if SVt None:  stack.callback(os.close, devnull_fd) 1# Prevent a double / of these handles/fds from __init__ on error.Naself._Ad_child_pipe_<b= Truezif _mswindows:?# " W methods def _get_(~q, stdin1outFerr)e"""Construct and return tuple with IO object;p2cread, p2cwrite, c2p3c2p2err1errD9""""if is Nonelstdout4err X^(-1, - # =5 ' ' O  = _winapi.GetStdH(STD_INPUT_HANDLE)g if2(q7, _tCreatePipe(>, 0a=3 = N.C1_+%el#== PIPE# @'), DEVNULL = msvcrt.2osf./()gisinstance(;int m _.se# Assuming file-like  d/t.F,no;._make_inheritable(! C?OUTD Np}_*wFdG jH*I\@IIJ>jget_osfhandl e(self._get_devnull()) elif isinstance(stdout, int):*5c2pwrite = msvcrt.[osfhandl> b.seJ # Assuming file-like objectv$.H,no make_inheritable(")) zif stderr is Non4err_winapi.GetStdHSTD_ERROR_HANDLE!Y5if Mo)&_,)$= aCreatePipe(>, 0c>d#= 0`Close2_+A)~== PIPEerrread&@/), oSTDOUT  GDEVNULLH ) ?err p23d, p2cwrite. c2pread, c2p.2err.?err.unused_restore_signal* 3Vgid, s ?uid 4_umask)k_new_session):B"""E program (MS Windows ver56"""Kassert not " supported onQ.Gif isinstance(;strq[ /el=_bytes?1if Z Y`raise rqError('G1 isYallow)')H! ==2cmdline([],os.PathLike/path-likemwhen ' '8Otrue*.se 3)p'ifz?NonR ut = os.fsdecode( ]# Process /up details!CD = STARTUPINFO(# bpo-34044: CopyBQ sincis modified abov# so the caller can remultiple times k.copy(Ause_std_as = -16Ein ( ^ ;if I/startupinfo.dwFlags |= _winapi.STARTF_USESTDHANDLES startupinfo.hStdInput = p2cread02Out1c2pwrite2Error = err1 2attribute_lis4lpAIList9have_handl;[bool(Q.an "K_" in H$ 7[W9]) # If we were given an or need to Zte onr=if or (use_std"s and close_fds):,if~is None+/ ? = ] = {}q=| 7M = \@3 Y.get(v[, [])z=;if %+= [int(.0),  *)]uM0[:]8elf._filter (*!fif not&warnings. /("'['wO'] "T "overriding", RuntimeWG# When us>9the#we always request-jinheri1J#?`s but OEonlythat will be HZed arxJ#B es5N! = False&if shellOdwFlHOWWINDOWDwShowWindow FmW_HIDE:comspec = os.environmCOMSPEC", "cmd.exe")? args = '{} /c "{}"'.format ([ , % if cwd is!fsdecode(cwdHsys.audit("subprocess.Popen", executable,u[, envG0# SAE >tryhp, ht, pid, tidnrCreateP( \o  # no special security ! aNone, 5int(not close_fds),=creationflags8?env.?cwd.startupinfo)finally:R# Child is launched. C the parent's copy of those pipeKhandles that onlyDca should have open. You needJto make sureO5no _oXwrite endaoutput are maintained in this process or elsmIe will 0@ wheD"e Iexits andReadFileO]hang.&bself._{0(p2sad, p2cc2pread, c2p82err81err8)) @# ReMGC, buW thJ E#_ted = Tru']A = Hi:(hp& piB*piW_winapi.?tdef _internal_poll(O, _deadstate=__WaitForSingleObject=p_WAIT_OBJECT_0<6GetExitCodeP;)"""Check ifhas terminat urns returncodattribute.T^Qmetho^ called by __del__, so it can,refer to oCs(0in W0loc= _ ^   `AwaitE, timeoutI implement2?) on Windows.CY;!_millis = INFINITEelse:  timeout_millis = int( * 1000) + if self.returncode is None:(.# API note: R0s immediately if kM= 0.Hresult = _winapi.WaitForSingleObject(_handle,C =4if AIT_TIMEOUT7rraise TjrExpiredTargs,piuGetExitCodeProcessQ KB % %def _readerthM, fh, buffer).append(fh.5)wfh.close()kcommunicatejinput, endp, orig_ ;out|# Start s2er s feedingo a list hangoff of this1# o<, unless they've al^y been so*edstdout and hasattr""__0"%Y = []'KM = \'+#Ring.Trtarget=n(=.,Q t1_.daemon = True1(]?err ?err% &m7errc#1 *inin_write()u& # 0 foe out. If we, # aremainO the fds left open in caseG[ userLgcalls o again !is BjoinS_"in( xis_alive(eiTimeoutExpired(self.args, orig_timeout) 1if (stderr is not None:(3)_thread.joini_remainini@(endq)oG sJis_alive()y6rraise T_Expir 2# Collect the output from and close both pipes, now that we know #+have been  successfully.}stdout =T s">outT_Y_buffa"!.(k?errkIk?errk 5errk $# All data exchanged. Translate lists into stringsL@[0] bOelsee33 return (f", ;%) % de6nd_signal[, sig"""Send aanal to0pro.E."""Tt# Don't.#a ) p has alwjy died$Ocode ( CSig ==.SIGTERMjterminate[-elICTRL_C_EVENTNbos.kilOA.pidSHnal.7 d_BREAKh#; lsValueError("UnsupportedA: {}".format(' LBfETbs?O Be>try_winapi.P?._handle, 1vpxcept PQssionf^ # ERROR_ACCESS_DENIED (wine0 5)received whenM ud(Trc = GetExitCode >0if ABSTILL_ACTIVE3i 1.code = rc  kill = terminate Qelse: # POSIX methods def _get_handles(self, stdin1outFerr)cg"""Construct and return tuple with IO objects;p2cread, p2cwrite, c2p3c2p2err1err  T = -1, -1' h' |' O"if,w is Non6pasy%el5z== PIPE$os.pipe() NDEVNULLQ0 = .devnullQisinstance( ;intW2 .# Assuming file-like% >,^.1Bno()"N?out 6+ O?elfYYtdoutL 4 ` ?err 6 OnSTDOUT ifsW !*#%{% =/ [$~ # child's is not set, use parent GK!ays.__s&__p'x _err, xYYtderrx/ ` j{(2Y '8 ,' u&) {:posix_spawn:args, executable, env, restore_signalspwrite,  c2pread, c2pwrite, &2err,1err,)):-"""Execute program using os.posix_spawn().""":if env is NoneV|=Genviron >kwargs = {}if restore_signalsZ# 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_action "!fd1p2cSf if fd != -1w (os.POSIX_SPAWN_CLOSE, fd)2 W@(p2cN, 0).(I/ 1<;, 2E@DUP22JNR self.pid e`able, ,B, **f Gp_child_p teROTrueo_close_pipe_fdsX   9Rdef _e( 0pre)R_fn, >fds\vp passR, cwdH startupinfo, Nionflags, shellm NH B , gid, gids, u _umask2 &_new_session(SA ver0 if isinstance((str, bytes)b%N R/elO~athLikeN if shell:  'raise TypeError('path-like args is not allowed when ' H`'shellAmtrue')5`0= []Yelse:_( = list( )) #1if r9 # On Android the default0at '/system/bin/sh'.]Qunix_cL = (0= if26hasattr(sys, 'getaapilevel') $ '/, "-c"] + ~if executablOGW[0] =* VE+?NonM$=:[0]Isys.audit("subprocess.Popen",,?, cwd, env(_USE_POSIX_SPAWN`nd os..dirname(_40pre'4_fn_close_fds& Opass% ?cwdo(p2cread == -1 or ?> 2(c2pwrite89 ;err99 start_new_session /gi1gid}IuIumask < 0)'self._posApawnf env, restore_signals,P,T50c2p$, 52err5jreturnPorig_/ # For transferring possible failure from child to parentV # Data format: "exception :hex errno:descri"n# Pickle=wused; it complex and involves memory cak errpipe_C! =PJipe(S#(Amust5Qbe inqsard io 0, 1,2 fd range0low,A_to_^J = [ 0whim>< 3low_fds_to_clos e.append(errpipe_write)   = os.dup6 for low_fd in s_to_close:b1os.(5 >try2# We must avoid complex work that coul]volveDmalloc or freethe child process tocCpotential deadlocks, thus we do all this here.Eand pass itpfork_exec() 2if env is not Nonmenv_list = []N&@k, venv.items()-k&fsencode(k'pif b'='ckY 2 raise ValueError("illegalironment variable name"  2k ++/v)G/el]! = # Use Ustead of -!ut ifpath.dir (3l%#8,l 0# Tmatches Obehavior1os._vpe()M2xec otuple(51os.join(os.>Qdir),yTC 0diraos.get_[?(en!fdkeep = set(O_fdsn0?.adself.pid = _posixsub.2# Hargs ^,3 ", sorted(map(int, ?)))M 0wd,xp2cread, p2cR, c2p2c2p 2err/?err/49restore_signals, start_new_session gid, gids, u _umask3 0pre?_fn^self._child_created = True finally:(# be sure the FD is closed no matter what>1os.-(errpipe_write) -aself._,_)fds(p2cread, p2c9,8 2c2p8?c2p82err81err8(# Wait for exec to fail or succeed; possibly raising an# exception (limiin size).?data = bytearray(+Qwhilepart = os. ~, 50000Tb 0+= H )aif not 5lene2) >gBYbreak\'  8if /tr7pid, stsjwaitpid(eif pid == +t""_handle_exitstatus(sts?lseO returncode = sys.max } ChildProcessError`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 = 'Badp from cM: {!r}'.format  sc\_0typgetattrgbuiltins,m'ascii') Cif issubclass(A, OSV) andm*_num = int(hex_errno, 16) child_exec_never_called = (err_msg == "no#"D?if G:t]? ""%# The error must be from chdir(cwd).=bfilename = cwd+Oelse EAorig-outableQ ifno_num != 0^ bq os.strx>nUraiseqception_type:, QM B5) def _handle_exitstatus(self, sts,*$wa51_toCcode=os.Q_WIFSTOPPEDF:81SIG8 )q"""All rs to this funcu 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# H48m ( # Anoth`hread /edz% =(self.pid, _WNOHANG) if pid == self.pid:(;"_handle_exitstatus(sts]except OSError as eZif _deadMe is not Non/returncode =Belif e.errno_ECHILDb # This happens if SIGCLDset to be ignored orvI waiting for child processe`s otherwise beenIdisabledJ4ourH". ]0is NO, weLpcan't g0he {?us.0http://bugs.python.org/issue15756<5 0,finallyA_Fpid_lock.release(ve % odef _tryM(X , Xz_flags)"""All callerstfunction MUST holdqT5"""v/tr`(pid, =` = os.1pid O\CNPMf y9ingoI J ~=pidhjsts = m z , timeoutInternal implementa!of>() on POSIX."ifQ( 4$ifL 0end-D() +9 <0# E a busy loopwe have a9&?wasNPcribb rom Lib/threading.py in T() at r71065Pdelay .0005 # 500 us -> initial #nof 1 mwhile Tru` acquire(False_4break # An9 Jz'ed0  (pid, sts) = self._try_wait(os.WNOHANG) .assert pid =E $or0? $if(Opid:0 *_handle_exitstatus(=_break&finally &pid_lock.release(,remainingg_time(end>5if /_ <= 0raise TimeoutExpired(`args, e?outhdelay = min( F* 2,|_, .05;Xb.sleep: &NelseRwhilevreturncode is Non/Bwith2~\-"if/ a?note8) # Another thread ?ed.CU 0g# Check theand loop assUhas 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 ignoreG0if me?cloW 0std=~ Cerr  # Only create t;0appif we haven't alyMIself._communication_started:  self._fileobj2output = {}*1if -nstdoutJY! N[6o] = [][ ?err[ 3err[ \ " = WostderrW  X)_save_input()%#,4_view = memory (] R with _PopenSelector() ase qin and Y)G.registerestdin,es.EVENT_WRITE)Es0not>"f._.clos?s>outOREAD  ?err$?err PwhileTget_map()|Qtimeoremaining_@(end40if ?0is nANone?< 0x@rQcheckn4outqR, ori ?", f,<Bkip_and_raise=True$@ RunError( # Impossible :=A'q@o..., s/ ' 'failed to TExpired.'Rready9(?err# XXX Rewrite theseuse non-blocking I/O on! # objects;(@y arE longer usHC:io!Bfor key, events in & if1.Qobj i#/in6lrchunk ='_offset D H |D+ _PIPE_BUF]  _try: self._input_offset += os.write(key.fd, chunk)N except BrokenPipeErrorector.unregisterwoileobju -.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_*() 0s # 0hat0we  fwhile H we can continueJ en> input if we rwetry. if self.stdin and_input is None:3>4%_offset = 0' 1 = T $"ifm1notqtext_mod ( =.encode(Ming,JJrrors) J deHnd_signalwj, sig)<"""Send anal to the process."""T # bpo-38630: Polling reduces9brisk o} Y MTwrongm1 ifC| completed,Popen.returK KattributeQstill,id has been reas+edG(recycled) a new different . This race condition canMhappens in two cases#2`Case 1`read A calls `poll()B B+&se). In th5A, waitpid() succeed#YsN9exit status|0 ki because o P@did Ur yet. CaO EB prevent `thanks ___lock|%2. vpid, 0)5ed directly, without us methods: 6is tM L.w @to a default valueUu# sinceq) fails" PpLookupEK i}  c# Skipi9aQ that we knowq aljy dieds_# Themd 6 # describRbove ;: tw= mis padded1NULs<. Usage. Rea[Zs.f = sunau.open(, 'r') where ei@namea`or an > poWr*  must have methods (), seekIclose(). Whenvsetpos()hrewind()Dnot used,0N e0 ne 1aryi}Pturnssinstanc4cla5[dpubliczJDgetnZ() -- re]'u (1 forM pmono, 2' stereo)/0get[widthr1le 9B;9frequency6n7 ':comptypeo -- returns compression type ('NONE' or 'ULAW') getcompname() -- returns human-readable verR%of=DM |Dnot ed' matches aparams a dtuple consisting of all?the above in the Uorder4getmarker~None (foratibility withPD aifc modulel0(idraises an error since] * does notk _exist  frames(nat most n !hUaudiocrewind>1 tocbeginn|@u streamGsetpos(posDseekEspecified position:Ftell:~~current7Bclos1-- 6Pinsta(make it unusU) TheN)ced 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|cpublicKsetnchannel'b-- setPumberX!/setsampwidth]61le 0iKrate0 .n!4(,X8 v B C)weters at oncs aoutputvxM#raw(data  0 4qout pat upb 6H hea~Y"patch up the file header sclose() -- patch up the f4Q and 0B; aoutput< You should set: parameters beforefirst writef sraw or . The total number of / does not need to bes, but when it iscorrect value, M0havr2 beed up. IK@bestL7all, perhaps possiblyd compression type,[td audio[using0. W.nAbeen*ten, either c&X+P(b'')Z () sizes in0 . y1`methodL\ed automatiyl_0lasI8stance is destroyed. """ from collections import namedtuple _sunau_p77s =)('/', 'nchannels sampwidthdbrate 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 =.E1(1)3!if?#qraise EOF0qx*256 + ord(9Nreturn x}3, xdata = []Sd, m = divmod(x, 256jG.insert(0, int(m) x = d 4file.write(bytes(data)) class Au_read: def __init__(self, f):if type(f) == ''' $mport builtins<5f =.open(f, 'rb')'y ._ ed = True Uelse:U .FFals/Xfp(f)3del1if 2_6giclose(H^enterJareturnNv'ex[W*args~{ c , 2! =/._soundpos = 0magic = int(Q_u32(Z2if (!= AUDIO_FILE_MAGICraise Error('bad8gnumberhdr_size 1O< 24zqheader \too small_> 100Rridiculously large[X W{-`UNKNOWN_SIZE` encodingi1not in _simple_s $ <(yet) sup 'ed)0Gin (_ENCODING_MULAW_8,:/A.+sampwidth = 2O Qframe65= 1 .el= LINEAR_8]o)/16p |=3O(/324p & unknown ?rat/nchannelh !if" 6 PT# of bXframesize * self._nchannels Pif sehdr_size > 24: '!info = file.read(8_- 24)8, _, _ =lK.partition(b'\0';Oelse5b''f?try*data_posWtell(a xcept (AttributeError, OS )S QNone def getfp 8creturn2 07 & <sampwidth< & <framerate< & <ns:?s@== AUDIO_UNKNOWN_SIZES'VsXencoding in _simple_sV$//f0r# XXX--must do some arithmetic her}comptypXFILE_ENCODING_MULAW_8'/elVAUU si'NONE' ?namDCCITT G.711 u-law2bAb@not jressed]paramAw_sunau_$E.get2(),5get5(),n<: 9)))omarker /H, id Qaise WP('no ('s'kJ[#, D $ifI sUe16%;" *_:izeT`_soundp+= len(T/) y`NCODING_MULAkW_8: import audioopddata =.ulaw2lin(, self._sampwidth)?preturn *INone # XXX--not implemented yet <def rewind(t)#ifh_pos is `#jraise OSError('canlVseek'[p._file.k$._Y (Psoundq6= 0Atell9_73asetpos5W, pos: ifq < 0 or >getnframes(/position in range>W! +*_?izeV6pos%Qclose$$ =S1ile-0if  ! =$/3!jopened;!9.) class Au_write:__init__7, fif type(f) == ''' fbuiltinsDf = .w(f, 'wbCf = TruJelse .FFals/Xfp(f)3delP,g>_r __rdN'exuH*argHh}c,/ ! =6}Prate 6nchannels- = AUDIO_UNKNOWN_SIZE+writtenL olength;@info+''u@comp = 'ULAW' # defaultVU-law5set%(O YPge paters after starting to  0(1, 2, 4 sRonly (Por 4 |0sup\'ed!tF!if H('number of channels not set') return self._n) 0def.sampwidth(&%, !):'Ji*Cframeswritten!%raise Error('canrPge pa7ters after starting to Memin (1, 2, 3, 4 v1bad1le V%._! =)&5get"m!ifHOrateJ;pecified 2 5setl%,  nKji& = K"  HKJ m9*)3set#,  IgO < 0B# of[#s Pbe negativ2 $ =g ?setcomptypeC g, nameL0if  'NONE', 'ULAW'%S! =7m?elsW unknown ?qression@&')g D ::H63 == u'CCITT G.711 u-law'NA.NAN 2.)6ed'1sets,snV|,e,E :# =PV$(n %( %( %(!(  O-%Mw_sunau_$.r2(), _%),g<(),  self.getcomptype(), name()) -def tell("!):breturn8_nframeswritten9e1rawCg, dataIif not isinstance(!, (bytes, garray)5' = memoryview9).cast('B')._ensure_header_Ften(&#if == 'ULAW'yimport audioopf.lin2ulae_sampwidth{@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( . )channels$raise Error('# of ,specified7 _Z_ (1le ^Orate^ ( )\ x, })._LNONEN== 1encoding = AUDIO_FILE_ENCODING_LINEAR_8,wsize = 1$%el 2%)16`2$elif self._sampwidth == 3: encoding = AUDIO_FILE_ENCODING_LINEAR_249self._framesize = 3$Relif %s4%)32`_ Nelseoraise Error('internal e%')dcomptypeCj'ULAW'UD M3%_8Z1  *nchannelst_write_u32(5Hile,VMAGICsheader_25 + len=Oinfo+(:+ 7) & ~7 5YanUNKNOWN_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 0, '^or 'wb'") """Non-termisymbols of Python grammar (from "init.h").""" # This Dmautomatically gDenerated; please don't muck it up! # # To update the symbols in this file, 'cd' to"top directory ofD:python source tree after building>interpreand run:" B3 Tools/scripts/g__py.py Include/graminit.h Lib/$1.pyTqor just make regen-( import warnings . ( "T module is depreca `will b_rmoved ";in future versions of P+!",$DIBionW,stacklevel=2, ) #--start constants-- single_input = 256 fig7 eval"8 decorator29s$60!ed1 async_funcdef(2 p3 paramC4 typedargslisd65 tfp@Y6 var67 vR8 stm79 simple_70 smallf1 expr2 annassignp73 test_B_.W4 aug)G5 deXf6 passXf7 flowv8 break9 continu80 return&81 yieldg2 rais43#4@name$85Afrom65as_'7 dotted_8*+89+$90S91 globa)92 nonloc3 assert94 compoun#95\V96 if3@7 whF8 fod99 try/300 with10ite"302 except_clausH303 suit 4 d _3a = 305> 6 `_nocon307 lamb4308#E9 orNf10 andV1 not2#Pariso13130_op814 1315T6 xor1317gv8 shift @9 ar+"a20 ter&P21 fa:p22 powe*323 atomE!24'%cs6 trail=R7 sub'"8r9 slice!30-!31}@2 di0set33 classe34 arg25@umenY2336[ia= 337 !_f2338$@mp_i340 encoP_decl4X#421arg!39e_body_y"4456345<6V 476end-- sym_name2 = {} for _name, _value in list(globals().items()): if type(_/B) is0 $1symU[T2] =eB del o """Interface to the compiler's inal symbol tables""" import _symV from (USE, DEF_GLOBAL dNONLOC aPARAM,5bIMPORT5RBOUND ANNOT, SCOPE_OFF MASK, FREED[|_IMPLICIT, $EXUCELL)weakref __all__ = ["Q", "STPClass Function $p"] defB((code, fileo_0topq. < 6return _newF(topt@) c "rFactorye__init__(self]elf.__memo = )`.WeakV!Diaary() M1newH,BqYP. 6 ==L.TYPE_FUNCTION26x(d`)_ _CLASS\YL, 1__cQ\key =.G`obj = .get(key, None))0if ,!is  E@[key-XM[obj k/ =W t:! nl, raw_} & =, b% =m "sNrepr$ifq= kind = ""XOelse$k%s " %^!._"__%B.?(Z"top"ZW"<{0} pmodule {1}>".format(,8E` 0{1},{2` G0N1get {oMODULEmodule" if self._table.type == _symTYPE_FUNCTION: return "function"V_CLASSSVclassPnassertin (1, 2, 3), \"unexpected : {0}".format(!) @def get_id")8*id5Oname7' 9olineno;)=is_optimizeAboolZ is_nest[.Bhas_childrenQ 0GentifiersJsymbols.keys(JalookupA , Ssym =g@Aget('Zym is None UflagsDCJ[F]F.Vspace3f_check3#)5module_sco .Z"top"7A = S,!, , = L&ym,/[ident) for 2 inH,&)]d_`RoB_newTB(st,cP_filem%stY KM t.K:?A] # F("):N# Default valuesnstance vari3sp__param3[local1fre 'Mglob(:non?T!__s_matching9p, test_atuple(7ZOk&ifcs[D'])Z/et=q.`mlambda x:x & DEF_PARAM)# return self.__params def get_locals("!):;$if4 is None"&locs = (LOCAL, CELL)C!test = lambda x: ((x >> SCOPE_OFF) & MASK) in U E#._$ =idents_matching(l~  Oglob !GLOBAL_IMPLICIT, "EXi al = 2non( #&x & DEF_NONF0 T Ofree0is_ == FREEKm> class C(SymbolTable):__methodi!id = {}`for stt.children d[st.name] = 1KAtuple(d __init__ , vr, flags pspaces=&, *, module_scope=FalsUE! =LZ" =b U & # like PyST_GetS(m >or -) =c__repr.c1"".format\0.__)M5M4is_referenced9Abool2.__Jb& _symw7USE"isAeter4OiZPARAMK HB"""R>*True* if the sysG9.5""" \)Cin (%6_ and self.__flags & DEF_BOUND)) def is_nonlocal(self):return boo.__flags &KNONLOCALMdeclared_globT scope == GLOBAL_EXPLICITXB"""R *True* if the symbol is 7.5""" Ain (u, CELL)21or 0.__module_=@and H -xannotatedIyKANNOOfreeFz== FREE`_impor[IMPORoassigns namespac`s true, binding introduces new H.I+)qused as?target of a function or classsment, this will behNote that a single@ can.bound to multiple objects. Ifm )zOmay alsoTUotherDY, like an&1lisPat do2 otA aBD/JET 2sFget_ 0 a . 3ws }| G}Raises ValueErrorZsaif len'._4f) != 1r~ ("^x " <[0] if __"__main__"Ar os, sy&pwith opys.argv[0])ff4src = f.read(Pmod = table(src, os.path.split(sP[1], "execfx0denP mod.iwifiers(kainfo =&qlookup()`print(' , A.is_U&()g()) """AccessPython's configuraMJ!rm . > DDfrom "pardir, realp __all! ['o_h_filename', 'get_config_var',smakefile_HnameLpath_% C& ylatform;ython_versionjschemeWTparse] # Keys for () that are never converted to Pz integers. _ALWAYS_STR = {#MACOSX_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//ntnure?lib/site-packagesLU8bin%osx_frameworkLp/ @if:d WSa } _SCHEME_KEYS = ('(,  >5', 1, ') _PY_VERSION = sys.@.split()[0]%_SHORT = '%d.%d' %5_info[:23c_NO_DO:9 REFIX = os.path.norm (prefix) _BASE_P, _1OEXEC1 Fexec1b6g ;CONFIG_VARNone _USER1 =  def _safe_real!):-2try zreturn ('except OSError2QA ifbutable(_PROJECTsdirname(Cc)) elsJ#` can be empty if argv[0] has been changed and 1 is@# un to retrieve the program /_ os.getcwd()) (os.name == 'nt'I.lower().endswith(('\\pcbuild\\win32oamd64'))_i.join(,, pardir, pardir)) #4 set for cross builds if "_PYTHON_PROJECT_BASE" in os.environ: " = _safe_realpath(/[T]) def _is_python_source_dir(d)f fn("Setup", s.local"( if~p.isfilejoin(d, "Modules", fn);?return True False _sys_home = getattr(sys, '', None) EPos.na*b= 'nt'afix_pcolif d andnormcase(d).startswith(11os.0_PREFIX, "PCu/")*` d_  )0,_,a(checkP=w6if '\O0, 4) BUILD = 1 *ascheme@'posrefix', X'_INSTALL_SCHEMES[C ]['include'] = '{srcdir}/I~A JplatEprojectbase}/.' subst_vars(s, m2tryoPs.format(**0except KeyError; HLK& Pg as vaW$raise Attributey('{%s}' %/a) fromextend_dict(target q, other wkeys = ,.(key, valuHs.items(O`if key(OJ*#ccontin*@[keylaexpand(E#rsw re!{} ifAs isz3 = '_%,r_configj1)) RHBin (*3(nt+% ==Quser(*4res'):C'(_7*>4res[refault_[nr# the d; ;) !_p&I7 '/ # NOTE: site.py has copy of this function. # Sync it when modify this % def _getuserbase(): env_ = os.environ.get("PYTHONUSERBASE", None)6%if9GKereturn *x@joinxc(*argsy2os.path.expand*;7)Q ifname == "nt"APPDATA") or "~"ev@, "Python"qsys.platformvdarwin" and _framework]"~", "Library",8,"%d.%d" %2version_info[:2]m`.local _parse_makefile(Iq, vars=@"""P,C a M.p-style 4.AA diary containing S/value pairs is ed. If an op(alHis passed in as the second argument,!isCu*stead of a newP.&"""# Regexes needed for ! (imilar syntaxes# like oldQSetup"s)limport rez_variable_rx = re.comp}r"([a-zA-Z]0-9_]+)\s*=\s*(.*)"n_findvar1E\$\(([A-Za-z]I<*)\@2@{?}8!if #"6Q = {}Fdone6not with openx errors="surrogateescape")fjlines = f.read(0s60if p.startsA('#'Prip()&''72inuHm = p.match(H%Jif mHn, v = m.group(1, 2/3Av.st(`# `$$'va literal ` n  ,2tmpIreplace('$$', ''%P`if "$"+2 y[n] = vcNelse1>tryJ@if nh_ALWAYS_STR)-praise V3E`Zint(vB#gexceptBl# insertP L.S/$' I@# doO interpola 3 he65Slist(.keys()) 4 # Variables with a 'PY_' prefix in the makefile. These need to Cb!de availLKout thatKthrough sysconfig. ?Special care is]_r ensureFv expansion works, evenK!if#AusesEnamea re$d_bs = ('CFLAGS', 'LD 2CPP !) rwhile len(=a) > 0:@for _JGuple*&*value = notdone[6]H" m1 = _findvar1_rx.search(;),2,2, if m1 and m2v =%.start() < m2 yelse m2L  # 7f~ot NoneCn.group(1found = True@if n`Z"tem = str(%>[n]c$elHK # get it on a subsequent r ~NFalsxos.environ{ doz0likke: fall back to =Omentig2[n] B@if (9sp(n)}l3@[3:] j)k8.""" + 3 _]QfK? = 1if after = ;[m.end():p$,":mR()] +!+ O`if "$"$j~nSH?trye!in _ALWAYS_STR4 8praise V_Error)4?int#gexceptY Dame]%~.strip(b%lsJ  done[name] = value  variables.remove(7/) 00if ".startswith('PY_') \41and5[3:] in reC%d_|:p.% =Ch,@ notk :1 5& 0 4NelseF# bogus  reference (e.g. "prefix=$/opt/python");[# just drop it siCwe can't deal3J# strip spurious spacesgfor k, v?.items()if isinstance(v,Mk.k(T# save the resultshglobal dictionaryvars.update(U)`returnzs def get_makefile_5B"""R2iqpath ofM3A."""Zif _PYTHON_BUILDt0os.A.join(_sys_home or _PROJECT_BASE, "\" if hasattr(sys, 'abiflags'<config_dir_name = '-%s%s' % (_PY_VERSION_SHORT, sys.Nm CV'.implementa, '_multiarch R+= '- F.DsM[('stdlib'), 4, 'V#')_82sys+Adata;jenviron.get('SYSCONFIGDATA_NAME','X{abi}_{platform}_{0}'.5at(>@abi= XA UD=get1 R, '')A)nerate_posixnR"""GePp moduleutaining build-timem*,mport pprintQ = {}a# loada.Tlled Y/ =J2try0e_parse(D,sxcept OSError as msg = "invalid @: un to open %s" % je, "strep"'q+ " (%s)Ne0PTraiseB(msgIpyconfig.h: config_h = get_c_filename() try: with open(/f) as f"&UparseQ(f, varsOexcept OSError=e=msg = "invalid Python installation: unable tot %s" % if hasattr(e, "strep&")mq+ " (%s)N$e.0PTraiseB(msg# On AIX, there are wrong pathsthe linker scripts in/P Makeme@# --#se;K revHsource, but whe"#edK,mH`in ano directory.,if _PYTHON_BUILD['BLDSHARED'] =&[' D0# T 's a chicken-and-egg situ on OS X Cdregard FB_sysdata module afterp change?troduced by #15298#() is call-platform(ppart ofa `make pybuilddir.txt` targetPwhichWa precursorB 4.pyPbeing structed. Unfortunately,B _eventuallys _init_posix(), attemptsGto import /we won't have t yet. In orderI:forqwork, if we'reDarwin, just mock upZ 2manand populate it*d}q ismore than sufficient Pensurm@psubsequ 3 togsucceedsf@ = _% _Qif 'd'Dsys.QfBtypem!= !.MPType(__(.Q_time&yR s[@A = 'M/lib.%s-%s' % (Q_PY_VERSION_SHORTYsys, "gettotalrefcountcv+= '-pydebug'0os.jVdirs(), exist_ok=Trueu@dest*` = os.[Y.join7 + '.py')kA, 'w', encoding='utf8' f.write('# systemRfigurgenerated !us\'B2\n''j &rpprint.( , Cam=fP# Cre8'/ fixup -- see Modules8/getpath.c with open('pybuilddir.txt', 'w', encoding='utf8') as f: <f.write(= ) def _init_posix(vars)4."""Initialize the module as appropriate for POSIX systems."""# _sysconfigdata is generated at time, see __!()L`name ="tU_%P_temp&_import__(, globals(), loc !['_kR'], 0o T\..update( b2nonf%&NTZset basic install directories ['LIBDEST'] = get_a('stdlib')?BIN,Oplat0INCLUDEPY[yinclude\EXT_SUFFIX- .extension_suffixes()[0]1EXE/g'.exe'qVERSIONC_PY__SHORT_NO_DOT/aBINDIR.0os.@.dir)(_safe_real@(syslcutable)) # # public APIs # Dbparse_p_h(fp, GV=NonePP&2 a (.h-style file. A dictionary'taining /value pairsKreturned. If anA!op>His passed insecond argument, it i9u*stead of a new.i!if<pQ = {}/!re define_rx = re.compile("#p ([A-Z]a-z0-9_]+) (.*)\n"^undefAa/[*] #EA[*]/Ewhile True0linjpfp.read^pif not 2QbreakTBm = _rx.match(4"Jif mBn, v = m.group(1, 2/3:try2_ALWAYS_STR%)praise VCUError}Zint(vvgexcept9_] O [ncv7elseq%$%(a*)j0jp0_h_jK(RF"py1%.hif _PYTHON_BUILD`if os.U == "nt"inc_dir ='b`.join(_home or _PROJECT_BASE, "PC")  belse: inc_dir = _sys_home or _PROJECT_BASE1 ;7get_path('platinclude')4return os."c.join(:, 'pyconfig.h') def Mscheme_names()B"""RLa tuple containing the 5!s 6H."""2 (sorted(_INSTALL_SCHEMES)|z3xcW_KEYS2( =_default_ (), vars=None, expand=True@mappan install!. "```Q`` is6 '= . If not provided, it willDsdA forTcurrent Qform.8#ifS__K 4 []m(,r. correspond}!to~n es  )[F9V*args'With no arguments, ea dictionary of .I0uravariables relevant2 On Unix, this means everyL defined in Python'sed Makefile;OWindows it's a much smaller seto@listPvalueat result from look!upqEeach/ B global _CONFIG_VARS\)if 2Q = {}7%# Normalized versionsprefix and exec_re handy to havOKpin factrese aregtandar`used mos ce*Distutils`"[' ']aePREFIX> )._EXEC_3 3py_ 2PY_VERSIONd1l_short7o_SHORT=Onodo=o_NO_DODqred_baseb , ]|base'] = _BASE_EXEC_PREFIX  _CONFIG_VARS['platbase'] = 0Wrojec3PROJECT_BASEdalibdirf@sys.w4Etry: abiflagsC4except AttributeErrorS # }: may not be defined on all eforms._ 5'' +if os.name == 'nt'_init_non_posix()FqaTZPATH%''( nSqm# For backward compatibility, see issue19555z SO5P.get('EXT_SUFFIX'if SO isqKNoneFA['SO%SOk# Setting 'userNdone below the c to ;o function to enable usQget_config_var' in<V@-@[J4get&()# Always convert srcdiran absolute path#(= pjH', _ u if _PYTHON_BUILDD# Ifis a relativ` (typixy '.' or '..C#n it shouldvinterpretedV directory F#>@tainMakefile#$ =O.dirname(m5_:)5<]BPjoin(V, 4;elsF#,l0meaful sincep instalV_on isspread about3system. We choosN>L:>we know itE[exist (j"['H_safe_real( GFOS X require special customizaehandle# multi-architecture,pos-vers+&er!ifD!ldarwinYmport _osx_sup 7.es>vif argsvals = [] for name in args: vals.append(_CONFIG_VARS.get(name))0preturn 3FelseNE def get_config_varV8B"""RU0theYue of a singlriable u %dictionary rQed by'ias()'. Equivalent to6s().1"""0if  == 'SO'<import warnings-. ('SO is deprecated, use EXT_SUFFIX', DBionWN2, 2r _platform()Y a string that identifiesM@curr?/@Thisused mainly8distinguish 2 -specific build directorb1and, t P@ribus. Typically includ"OSOversion andarchitecture (as suppli` 'os.u()'), although9exact in=a|dpends on.@ OS; aLinux,skernel Oisn't particular-3ant]Examples"edleQ-i586V2 alpha (?" solaris-2.6-sun4uWindows will'0 on\ win-amd64 (64bit 4`on AMDaka x86_64, Intel EM64T, etcwin32 (all others - d, sys.Y)2For: non-POSIXa3s, sly just8s 'V0os.(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 explicitl if "_PYTHON_HOST_PLATFORM"os.environ&[A]M# Trvarious flavourAUnix os_, host, release, L, machine =Q(# ConverF1to cGremove '/' characters,ranslate# spaces (E "P Macintosh") osname = osname.lower().replace('/', '') machin. ' '_(OA-') Q#ifx[:5] == "linux":s# At least on L/Intel, '' is the processor --Ai386, etc. XXX what about Alpha, SPARC,?,return "%s-%s" % (,,.elWsunosPif ree[0] >= "5":# SunOS 5 Solaris 2&|R = "s "_ 3%d.Cint([0]) - 3,22:]^!# We can't use "platform.architecture()[0]" beca%a# bootstrapPblem.U* dict to get an error? if some suspicious happens'bitness = {2147483647:"32bit", 9223372036854775807:"64}rJS += "5[[sys.maxsize]4# fall throughstandard-o-ZrepresentationI 13(aifrom _aix_support imL ( j6jgcygwinYYu%rePrel_rre.compile(r'[\d.]+0m =g_re.match"Fif m9 = m.group:dar5_os38 = 0T.get_\(B >config_vars(),?0 :p) defh_python_version()tO_PY_VERSION_SHORT9p_print_(title, data=for index, (key, value) in enumerate(sorted(7.items())@J"ifC0|('%s: ' % ): 0\t%A"%s"'E_mai"""Display  inB sys detains.""]if '--genp-posix-'"Fargv_+_+  wPc:fH(-  309 Current installation scheme: "%s"' % _get_default_scheme()) print( _ _dict('Paths', ;p 2Variable6config_vars< if __name__ == '__main__':X() #! /usr/bin/env python3 """The Tab Nanny despises ambiguous indentation. She knows no mercy. tabn?-- Detec-? ofFB For the time being this module is intended to be called as a script. However it1possible1pimport nto an IDE and usey1fun check() cribed below. Warning: !API provi,by`likely{change in future releases; such s may notbackward compat.R # R>1public do, by Tim Peters, 15 April 1998.@XXX Note:`is nowD@tandtslibraryz@. # 3Pneedsuundergo!ho|;Mcurrent cod3tooH-@. T@will addressed later. __versionc "6" $os %sy tokenizeJhasattr(r, 'NL') raise ValueError("'.NL doesn't exist --  too old")1all!["=A", "<0Nag process_Ds"] verbose = 0 fileAonly def err*c(*argssep = ""pfor argZ#osys.stderr.write(7+ str(arg)O P 70"\n](qgetopt sglobal ), "6tryPopts,0s =Bopt.O(argv[1:], "qv"7dexcept-e6msgW32msg6areturn2@o, a3;Aif o/#-q); * =A + 1Z*DvD$ ="8!if "Usage:", 0A[-v]_or_directory .... *r classQNag(Eq3ion"vR8dh r() if d ngc 1.+0Capd~@hand2in )%n| __init__(self, lineno, msg ".! & . =?h%!nojWK Gineno def get_msg(self): preturn A.msg"de/Oline0 .check(file[6"""_or_dir) ^0If )* is a directory and not a symbolic link, then recursivelyLpdescendDtree named bym!, ing all .psLQalongJ_way. n ordinary Python sourcecb, it iKf0ed for whitespace related problems. The diagnostic messages arewritten to standard output usthe print qtement.:2"""oif os.path.isdirhgif verbose9s("%r: listA" % H1,))10s =1!+%1 insqAfullCBjoinh1lpFif (oB)w,s0 1-or0,normcase([-3:]) == ".py" _(r6tryf = tokenize.ope9except OSError as msg;7errAI/O (F: %s3F > 1XU`%r ...S process_!s(generate`f.readV)G2T  )mIndentationj/p#NannyNag'nab p = nag.2no(T 6*** Line %d: troubletab city! ***j3Q`offendA: %r:  2S,elp`if ' 'd:q = '"' + + ihb_only:)Bp#, p, repr(%hfinalls.close(Clean bill of healthK5 class WF#characters uspkand tab S, T = ' \t' # members:U raw #the original string n * nuO of leading whitespace characters ini/ntJ4tab1E[:n]*Enorm ormal form as a pair (count, trailing), where@% Ra tuple such that contains 9&[i8instancesS * i + Tc <yO' K5It's A Theoremm.indent_level(t) ==nn!for all t >= 1 iff m.pQ == n .Cis_simpleAtrue91raw.i(T*)(S*)def __init__(self, ws)N.raw = wsiS, T = Wd8.S,k*B = [Pb = nUt = 0T chu7Pif chSOE + 1Nmb%elNTNn-ntPj@if b2lenG + [0] * (b - ;b)3S[b] = b]) (Yy3elsuUbreak>wn"= b  t /=:, bQ( =B<= 1# return0gthqlongestiguous run(whether or noQpreceRa tab@P_run_of_E]2 = Fmax(&-16W K,Gsizeu#O, ilq#R iWrangew F0 n6[i]#`il + (i//0ize=$)* *P6"ilxquickerg`-R+ sumjse!s*aB[i] K3Mts *85d+o [( <)%|) Dnum_tabs]  "# and note that i//ts*count[i] is 0 when i < ts 5#, trailing = self.norm$eil = 0 for i in range(tabsize, len(O5)):-d@Ail +/1 * ,5[i],freturn#+ \A * (@"t)%# 2bue iff indent_level(t) == other.x # all t >= 1def equal(q,?w*c8Da list of tuples (ts, i1, i2) such5 i1MZ Os) !s3i2.C Intended to be used after #)`known,SwhichIcase it willk`at leane witness8@tab AAnot_h_'Mqn = max .longest_run_of_spaces(),L/3) +/Va = [f tsg1, n+14iL Da.append( #. "5) )ga+R]/Tr+ <*# The algorithmM0due{Vincent Broman.@Easy@prov]'s correct"qXXXpostvTrivial9ni sharp (consider T vs ST)6!Un e's a fasgeneral way. I suspected so atL# first, but no rc0ForW 8(&common!) Aqwhere MN are both$hecorm (T*)(S*), M.less(N)n() < N.d)K9`M.num_'!7= Np. Proof*evQkinda -w>ddXXXwri?$upNSMI he4M [0]) <= 1C Kin~nKBFals/7is_simpleH0.ntoVN#-b test already didv=ange(2, n+1)7: if self.indent_level(ts) >= other @Kreturn False]QTrue ## a list of tuples (ts, i1, i2) such that5_i1 ==33i2.CIntended to be used after not[Qless() is known, in whichHcase it willPt leane witnessing tab size0defl_g_&(x,e)Uqn = max .longest_run_of_spaces(),{/U) + 13ea = []`for tsrange(1, n+1c&1a.append(_  w6 5) )g| dformatCes(wfirsts = (str(tup[0]) $ up%wSprefix = "at"nif len(w) > 12 B+ "s1 " + ', '.join()process_tokens(INDENT = },DExNEWLINE;HJUNKCOMMENT,i!NL)@a[WhiteB("")pcheck_equal = 0]S(typeO, start, end, line)ysP0if 5# a programQtement, or ENDMARKER,eventually followk#, some (possibly empty) run he0m#s (NL | =B)* (2 | ;+)?6cIf an '?ars, settdOis wrong, and K0ndohen we see the_8 [2= 1'ely x :0thisguy = Vai. NP[-1].:(@*T) =5 no$ssA D0msgrP grea#Ae.g.4 Mraise NannyNag([0], msg vs u, u#@re'shRwe necheck here! what's important is # that when the run of DEDENTs ends,indentatio!;theHprogram statement (or ENDMARKER)itriggeredUn equal to whqleft at10topsp;ck Ouch! This assert zAs ifKlast lineQ\sourc2is ied *and* lacks a new> --On3p+utou{in air.bcheck_ # else no earlier NEWLINE, or an IN RI:= 13delVs[-1]Xelif ;pand typt in JUNK:i< s first "reken" following aLso iwmust beHDtokeim next `  q;N"a" argubexpose@leadwhitespaPfor tC; ~1cas9o,Lp{n emptystring, so willperly match7 ) with whi M""s" was seeded)9= 0uguy = W(.)'Pif no4.(@)[witness =jB.not_ B pAcmsg = s e.g. " + formatI3es(S K raise NannyNag(start[0], msg) if __name__ == '__main__' () #!/usr/bin/env python3 #-/ # tarfile.pyR5Copyright (C) 2002 Lars Gustaebel # All 8s reserved. # # Permiss is hereby granted, free Pcharge,  any person # obtainwpa copy/foftware |associated doc~0 # (@s (3 "S7#")p dV !! UPout #@tric, inclu #S limiGto use, #, modify, mepublish, dipbute, s`cense,/or sellD1ies5g,opx#t EsV@whom2' #furnished to Xdo so, subject to the following # conditions: # # The above copyright notice and this permission shall be # included in copies orstantial porx1 ofSoftware.jHE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THEPPIES #T MERCHANTABILITY, FITNZ@ FOR A PARTICULAR PURPOSE AND # NONINFRINGEMENT. IN NO EVENT SHALL TH2 UTHORS OR COPYRIGHT # HOLDEBE LIABLE|CLAIM, DAMAGE<aOTHER +b # WHEIN AN ACTIONCONTRACT, TORT~BWISE, ARISING # FROM, w OFIN CONNEKD!OR`USE ORPDEALINGS /"""Read from sPwritetar format archives. """ ver = "0.9.0" __author__Lars Gust\u00e4bel (lars@gustaebel.de)7credits__M2avo Niemeyer, lJ , Richard Townsend." #-P # Imsbuiltins i! open as bltn_  4sys o $ioeshutil4tat Dtime Ustrucre try: Espwd exceptRError#pwd = None7?grp74grp7 # os.symlink on Windows prior 6.0 raises NotImplemented ;_ion = (Attribute$,9)A# OS)` (wine=1314) will be2d icaller does@ hole6# SeCreateSymbolicLinkPrivilege .C+= ($,)B2Namwbass #ttarfile;*!ll["TarFile", @Info 3is_61Tar v  "Compresa "StreamuExtractTHeadeZ MENCODINGqUSTAR_FORMAT7GNU5PAX CuDEFAULT "&("]px0 # ^1conC( NUL = b"\0"C #Pnull 3acter BLOCKSIZE = 5122 # length.@procng blocks RECORDSIZE = BLOCKSIZE * 20 # length of records GNU_MAGIC = b"ustar \0"0# magic gnu string POSIX9R\x000;7Xposix9 LENGTH_NAME = 10k:Wximuma filename?OLINK?Hlink?`PREFIXA"55w~ the prefix field REGTYP"b"?# regular( A0\. /5LNK^1-@ # (inside]U) SYM828symbolicAE CHR030 character special device BL4;\block7&DIr57directory FIFO6-l# fifobECONT676contiguous2S_LONG6b"L;P# GNUfQ longF5GNU3?b"K3fRSPARS:S1fcsparse0XHDjx0!#  .1-2001 extended header XGL?g?dglobal=SOLARIS_XE# Solarisw USTAR_FORMAT =  a1988 (x) format,<116PAX12* o&E(paxmvDEFAULT@MO #-% #3 constantsO+File types that_supports: SUPPORTED_SS = (z$, #, _#, C#, $, /n#, L#, /7j,Z|I7 ;\) # will be treated as a.OULAR are part_4.Pv 1 elds from a paxr that overr%ide a TarInfo attribute. PAX_FIELDS = ("path", "link @sizemtime", @"uidg0una%1 "g .) # Fields from a pax header that are affected by hdrcharsetFNAME{ v}v/intnumbers, all other f! #@treaas stringsWUMBER!"ar: float%/"cF (CD: in8L -% # initialization #K%- if os. == "nt": ENCODING = "utf-8" else sys.getfilesystemencoding(5'# Some useful funcs) def stn(s, length, , errors)"""Convert a8 to a null-terminWbytes object.91"""as = s.`!e(5ingg#return s[:R] + ( -(s)) * NUL 0nts N  pfind(b"\0")if p != -1i:A[:p]"o.decod/i(crpython  P# Theore two possibleQs forVQ, see# itn() belowZ if s[0] in (0o200, 0o377Qn = 0@`i/Prangew(s) - 12(un <<= 88+= s[i + 1>"=={j~-(256 **#oB - n1:tryB?`"ascii#ct7l`int(s.p() or "0", 8j%except ValueE: nraise InvalidH'&2("i<{?nn, digits=8,mat=DEFAULT_FORMATj  5HA # POSIX 1003.1-1988 requiresxsDbYVed as!ofs# octalr follow.#`, thisPows v6ss up toER(8**( -1))-1. GNU tar allows storing numbers greater than # t if necessary. A lead80o200 or 0o377 byte indicate thisEparticular enco<, the followKdigits-1Es are a big-endibase-256 representation. This aMs values up to (256**(_S))-1."A s a positive8, a`a nega H>Vn = int(n)if 0 <= n < 8 ** a - 1):#g2s =("%0*o" %), n), "ascii") + NUL;elif format == GNU_FORMAT and ( sC V >= 0qarray([<]Oelse1 737715/Q + n for i in range<(s.insert(1, n &#qn >>= 8[ praise V5Error("overflowz field")return s def calc_chksums(buf`"""Cal `e chec%P a met's header by summ  up charactaexceptA>u which is ttd as ifEit was filled with spaces. Accor/WGNU tar sources,D@someas (SundQNeXT) ul`QignedCwill be differena0ther)0ars| bu$high bit set. So we5twoobs, uns4andE1"""(0 = +(struct.unpack_from("148B8x356B", s[EbEbEd ), ]opyfileobj(src, dst, length=None, 9aion=OSAsize!3opy; 8_@ src&niBT If82is vcM@entibontent3u0buf or 16 * 1024i[=$ #~pshutil.&~(TUblocks, remain= divmod(^F@b?\\Pbuf =DP.read,< 0) rExtractBKAvGeneraltb for e5 exsWOReadTL unable tar archiveUCompression\Qavail]c= methoddoStream_`supporPoperaas on sFP-like?FilSHeade} .h1yXEmptyW  e4 [TruncatedM( Yt8] 7EOFKWOfileY oInvalii6Y Subsequent@missZDand hextendedq? #- # internalrOface9 :_LowLevel"""Low-l aobject. S s [Aing.VP It0useAsteaa regularR(4ingAbaccessP _init__(self, name, mode|dA = {5"r": os.O_RDONLY,w WR" |,TCREAT VTRUNC8 }[i]Haif has)os, "O_BINARY"62 |=a#DA.fd Vopen(, 0o666) . Qclose c6os.7.fd0/X, siz3 $3.fd'qq$, (#os^self.fd, s) cla8ss _Stream: """Class that serves as an adapter between TarFile and ;a a sL-like object. TheQ onlyu+ needs to have a read() or write() method and is accessezblockwise. Use of gzipAbzip2 compression@possible.Acould be for example: sys.stdin,=@out,Aocke tape device etc. 1tintendedqbe used brnally2"""@def __init__(self, name, mode,type, fileobj, bufsize)onstruct a jS._extWu = True $ifqFNoneos7_LowLevelFile()L0pRFalse"%ifz == '*'r# Enable transparent2 `detect&th_#:facBcProxy( ~$ =$D.get&()! =%""## Y! =z ! 1  }L = b4pos060cloV :try J"gz"!c 6import zlibexcept I#^ErrorY(vraise C7, ("Uj0ulenot availi"G4=!Bcrc .crc32(b"L ifye/"rpDN_gz() ~e4+lsBop A,el?bz2 9bz2X'0bz2SKdbuf50cmp#z2.BZ2De/or!OS cmp = bz2.BZ2Compressor() elif comptype == "xz":#.>tryimport lzma5except I#_ErrorDsraise C1ion, ("U module is not available")o if-rself.dbuf = b""D$Qcmp =p.LZMADe$C' [8ion= kOelseJ  o!= "tafqunknown Q%r" %8 !if_extfileobj%3"z.close(!d = True;def __del__(6)nif hasattr2, "Rf") and8-iinit_write_gzVp"""Initialize for *ing with gzipJa.". Uzlib.xfbj(9, DEFLATED,L -AMAX_WBITSBADEF_MEM_LEVELE0qtimestapstruct.pack(" Usize:,3fileobj.write9![:0buf7.])8~=][/1:] 0def closW)}@"""C the _Stream object. No operation should beQ done on it afterwards."5""" "ifdJbreturn)f = Truu:try<Xmode == "w" andmomptype != "tar"<lCcmp.flush()*j ?buf\ _7= b8~c/gz.M ztruct.pack("rc)Dpos & 0xffffFFFFQnfinall2notC_extA _init_read_gz1 Initialize for )ing a gzip Isressed KCcmp dtzlib.de?Qobj(-$MAX_WBITSTd# taken from`.GzipF;with some alt_ _0(2)b"\037\213raise ReadError("|" Y1Y/10U@CompD3ion\unsupportedb?wmethod"Sflag = ord.1=:6;1if >:& 44OxlenT + 256 *p +(M t8t M51P0if `s or s>NULI*Ubreak=*160n22Atell R s!'s pointer posiL\2posoAseeko,B*=0v?Sets to4. Negative seeking  is forbidden. 5""" if pos - self. U>= 0: 4 blocks, remainder = divmod(1<,Fbufsize)Efor i in range(T)imQread( L$mJelseW%raise StreamError("seeking backwards is not allowed"PbreturnApos Adef !, uB"""R6the next" number of bytes from #s.Sasser8ANone~(Rbuf =_ s+= len(buf6bufE?elf"ifcomptype == "tar",c_U"c dUt = []3while c <| q# Skip u!ly uffer to avoid unaligned double b!6ingH:bufcl$b#,7fileobj.*6!if Ubreak7?try `cmp.deJress\@bexcept >ionRCReadinvalid Z~7ata^t.appendx/c !b"".join(tHLP = t[:>0t[:]() If internalRye, another , -/q ('6buf& ok g9# class _) Proxy(object"""Small p> that enables transparent4iondetection{ face (mode 'r|*')_Ai__init__#, self.fileobj = fileobj self.buf = f .read(BLOCKSIZE) 1Adef +, size):N8L&breturnm6bufYgetcomptype(KZ%if0 .startswith(b"\x1f\x8b\x08"1iE"gz"}'elK[0:3] == b"BZh" andgS[4:10v1AY&SY"^?bz2_b5d\x00P80", fd7zXZ")x/seFtar"IMclosCR." ) # class StreamProxy #- # Extraction L object3`p_FileIn(3"""A thin wrapper around an existingjT thatprovides a part of its data asCindividualE9.'"":__init__,4obj, offset, blockinfo=NonTobj =?g3K# =T Q=:izeAposiv:= 0name = getattr(~0, "1", 3d = False8&if1 is; pb = [(0&)]C# Construct a map rnd zeroesxmap_index GE= []ylastpos*BrealOg23forq2 in #if*3 > i !.And((K,12)<FTrue2! +^,o)D!+=' `cK$$if" <w D?map!8b!QflushBBpass'D=abl-Owrit-z.Oseek.%.,LtellB"""Rthe current Qu* k,G, whence=io.SEEK_SETF"""Seek to0in if whence == io.SEEK_SET:  self.position = min(max(a, 0), &Usize)=elif whence == a:CURa4if LJ < 0\# = ~ +B=OelseS?in(S:ENDm; BS )raise ValueError("Invalid argument"breturn %def read , f=None) """Read data from the file.Cd5""" !ifG@ is JI)a" = - %/~ r E)Gwbuf = bRwhile>l?Tru1p, startop, offsetAmap[map_index]B# <z < stop-2]breakL", ] += 1>(#le 7map0 d9= 0cclength->topT!ifemrobj.seek({!+ -)abH.0if Pb) != >gth[!unexpected end o6I+= b8+SNUL * 6a$ - f+$2buf5Ainto\7, b@'(bn1b[:8@uf)]y%ufjoQcloseli@d =  #class _FileIn"  ExObject(io.BufferedFer):l__init__oP, tar GinfoXobj =q(1.9._&0tar^.3Wspars/super().e)M #- # Expor}C-/es'6TarInfo(object).: """Informational class which holds the details about an< archive member given by a tar header block.30Tarr objects are returned;TarFile.getV7(),< s() and 5starinfo4are=usually created internA""" ,__slots__ = dict(.name = 'N!of %.'A mod.Permission bits#0uidPUser ID Suwho origi stored thisnHgH_GroupI*1sizSi)te2mtiTpof lastAificE`chksumH @chec%0typt (' .D is 3onese constants: ''REGTYPE, A 2LNK2SYM 2DIR BFIFO KBCONT#CH0#BLK0GNU_SPARSE.'S link+(,target file !,iis only present in >2?  uok gAdevmajor"rDevice  nu +*in++`offsetT8The0starts here[0_data = "5I1's 6"Bpax_qs = ('A ryItaining key-value pairsm/an 'associIpax extended |Pspars"'S  y0tarv = None_HP_stru9 w_c )def __init__(self,B="")h@"""Cbg+ as.1#op73h`[&.8" =T!C # .RU0o644.-pds3b0.!# a*id*D *gR +&,# W1-#0 R 475#Z B 263 = h. self.linkname = "" p# link   self.u) # user,g,_group-devmajor = 0r# device jnumber6/in66 7goffsetk the tar header starts here=T_dataB # =qfile's > ?PsparslBNone##  me information<Bpax_as = {}~4pax9:@propertydef path(!):F'In F@s, "" is called "75".'3breturn- @'S.sett r,x.>! =E Z*Q ? 5/ ,!6 '% =#Y __repr__D:O"<%s %r at %#x>" % *.__class__.__]5__,=1,id%&))h@get_ B"""RTarInfo's attributes as a dic~Aary.&5""" \! ": ,#Hmode# & 0o7777,3uid+O;uid"g"g"9sizp ECmtim$T $achksum$ %3typH #"":# 'fn' $^$ $Uo'-'}Z!if [""] == DIRTYPE and not  ].endswith("/"KBnfo[k] += "/"hi?Qtobuf", #,=DEFAULT_FORMAT, encoding=ENCODING, errors="surrogateescapea  string of 512 byte blocks 'f;SUSTAR'Gcreate_uU()8elii=GNUg return s elf.create_gnu_header(info, encoding, errors)  elif format == PAX_FORMAT:#*return se?paxe]+seHaise ValueE("invalid1") xCdef Tustarj/, kB"""Rthe object as a N q block.q5""" c["magic"] = POSIX_MAGIC1aif lend["linkname"].o!e(v) > LENGTH_LINKMrR is too long!2 {JNAME{prefix"]`"["R" =_posix_split_ 4 '=_Ds, USTARx.9GNU sequence?gthst# Test number fields for values that !edZ"u limit &N0@likeb@oredVfloatd  , digits in (("uid", 8), ("g size", 12Cmtim)0if VNw $d# The pax F has{ Avoid overflow;E = 0?valpot 0 <=| < 8 ** (@- 1)qisinstance(val, V  =5 - # Create a*extended3wecessar if- z0bufaelf._c[_sgeneric4(s, XHDTYPE,6ingOelse`6b""#preturn z8+ szcQ, USTAR_FORMAT, replace")R@classmethod'Hdef TlobalHcls, B"""R`object&jgGhblock sequence1"""?clsZ"GLZd"utf-8_posix_split_P(:,[0, esS5! a,p longerFn 100 char toTUrefixd and:7par.components =f.7("/_irange(1,+(;)@p = "/".join,F[:i]v.,+i:,a]d5ingC)LENGTH_PREFIX \zNJNAME&DUbreak]Jpraise V ("qq is too0N~'0kstatic1nfo, format, encoding, errors): )"""Return a header block. info is a dictionary with fileA! *0rma$@, fo  must be one of the *_FORMAT constants.F5""" has_device_fields =c.get("type") in (CHRTYPE, BLK )C=if Fdevmajor\0tn(`", 0), 8]?/in??Oelseastn(""w  4 5@partJ[G<name", ""), 100,9,>i:0mod>0) & 0o7777): =uid00 g02sizE, 12b 1mti 3 b"C", # checksum  )2nfo_Q, REG Olinkimagic", POSIX_MAGIC nuk/32 >g>f =  jeprefix/55|%] buf = struct.pack("%ds" % BLOCKSIZE, b"".join(.)!chr= calc_us(buf[-?k:])[0]q#:-364] + bytes("%06o\0{I, "ascii")$TF357:Jr2buf@staticmethodpdef _create_payload(sstring '2ledBzero^ up tonext 512$ borderLs, remain^= divmod(leg)t'if7:> 05E+= (& -3u) * NULF8J_classIgnu_long_`(cls,  , xW0GNU_LONGNAME or LINK sequencX1forp[" =!,!e(rrors) + NUL3 info = {} ["name"] = "././@LongLink"'2typ' 2siz@len(P)!QmagiceGNU_MAGIC # create extended header + L blocks.Sreturn cls._:_1(, USTAR_FORMAT, encoding, errors) + \L Mspayload+@classmethodDdef }pax_genericPcls, 0s, 6!):F~B"""Ra POSIX.1-2008or globalsequenceD% that contains a list of keyword, value pairs. ThesDmust be stringr&""# Check if onecthe fields`surrogcharacters and therebyw# forces hdr+ set=BINARY, see _proc_pax()*` more vrmationbinary = Fals_Value=Zbreak   if offset and numbytes:  structs.append((9,6-))7pos += 24 isextended = bool(buf[504]Bself.sparse = { G_data = tarfile.obj.tell(Q5TbC!+ Vq_block( FsizeCp = origareturnCdef _proc_paxO,)a"""Process an or global header as described inw POSIX.1-2008.5""" # Read theOinformation3?bufHAread.)(t# A pax`stores supplemental t for eitherfollowing $ () or all !s?(2)!if.type == XGLTYPE~Bpax_escOelse<i.copy((Check if3contains a hdrcht field. This 8s u3Pencod2oTth, linkpa Qunameg S@s. NElly,#"seus are UTF-8 ced but sinceuD$im_Gaaed to imraw binarywings ifMatranslAVfails match = re.search(br"\d+L=([^\n]+)\n", buf2if Ais not Non&["B"] =; .group(1).decode("utf-8"0For time being, we don't cp@abou1yth# than "BINARY"# The only o(Pvalue.t is currently8 owy~standard iK"ISO-IR 10646 2000C" in`Rwords  =MX.get(+ o6= ^v"#3 = PW. A record looks likO# "%d %s=%s\n" % (lengg0key !, 2).  -##  co-$texQinclu4B0 it newline. #Bboth encoded stricngs. regex = re.compile(br"(\d+) ([^=]+)=")/upos = 0while True:ZQmatchWAgex.(buf, posN*qif not # Dibreak [length, keyword =<.groups(^-r = int( !2if ^ == 0 raise InvalidHeaderError("i! h$value = buf[.end(2) + 1:pstart(1J- 1]4# Normally, we could just use "utf-8" as the encoding and "strict" #+ handler, but_abetterAtakeUrisk. For2# example, GNU tar <= 1.23 is known to store filenames it cannot # translate5PUTF-8@raw ngs (unfortunately without ahdrcharset=BINARY)rWqrst tryict standardM,Nif that fails wewfall back onNeuser'sEDet self._decode_pax_field(!, 0taru.spN in PAX_NAME_FIELDS,, {, ;elsQ2m? = # P ' }#s[1A] = )Sos +=F@# FeCnext:tryo&Cfrom(wexcept  ISubsequent)`("miss%or bad s&(")qProcess spZ ifmationif "GNU.$P.map"_E #Rextended 7 ft version 0.1bproc_gnu5@_01(:', m+elOsize200pfZ.get(NPjor")1"1"M/ %in/"0"x # GNU extended sparse format version 1.0. self._proc_gnu5_10(next, pax_headers, tarfile) A1if @ type in (XHDTYPE, SOLARIS_%):4|# Patch the TarInfo object witZ info._apply_"( 2.encoding.errors)Poffset =if "size"o *A# If replacesLy field,Bwe need to recalculate9R wherCz startsCdG = ?.]_dataK"if$isreg() or0notSUPPORTED_ Ss+ta_blocks. 1{2 = areturnLdef 000(,' 7buf"""Process a GNU [X,\0\5"""@es = []Qfor min re.finditer(br"\d+v.=(\d+)\n", !c.append(int(].group(1))Unumbyte'A %3ext = list(zip($, M)}1/17q x)n xS["GNU.map"].split(",")~Qc[::2], [1  1K-1\ENone*Pbuf =ZV.obj.read(BLOCKSIZEX =F!b"1*0 = 7while len(2) <}Zs * 21if ^ :buf!z+3/er.G@ next.offset_data = tarfile.obj.tell() next.sparse = list(zip(s[::2], 11)) < def _apply_pax_info(self,  headers, encoding, errors):>}"""Replace fields with supplemental Wrmation from a previousH s extended or global .*5""" for keyword, value inI_6s.items($if6 == "GNU=f.name"-ssetattrc"path"q)/el\?siz\&a, int()aAreal?&ein PAX_FIELDSZ*oNUMBER1'>tryJ! =v L[]6except V Ei0I!H.rstrip("/" DE.~) =Xcopy(adecodefallback_( DX a singlax record breturn.("7'ct50UniWSblock4Wcount+ound up a byte # by BLOCKSIZE and 5it, e.g. _b834) => 10244(s, remainder = divmod(v,t]&if0 OU += 1*QQisreg "'R Traf the Tar object is a regular ,.'w1typREGULAR_TYPES<HABisdiidirectory `== DIR?sym f a symbolic link.'  return self.type == SYMTYPE %def islnk($!):="'R;True if it is a hard f= 0).sC> 0,`Kare passedVcaller as exceptionsformat = DEFAULT_FORMAT # "to use when creatingOPencod= ENCODINGK4# Efor 8-bitdstringN=>0# EP handNpunicodesversiontarinfo =k Iudefault EP = ExO3 &Cile-#0ext9#()F__init__p, name=, mode="r",F3obj 5 deiA Nq="surrogateescape", pax_headers8 D- copybufsizp"""OpenC(uncompre)archive `name'. `mode' is either 'r' to read from an existing archive, 'a1 append data to+Lfile or 'w5create a new bverwricoCone.PdefaultssH'r'.@If `T1objgiven, itused for 4or xx. If itPcan be determined,Poverridden byxis mode not closMwhen TarF$#is<5"""Vs = {"r": "rb", "a + w w x Exb"}>!if ~!in %s:raise ValueError("rP must1'r',Ex'")BQself.1=] _ s[ %] "!if 7if Z=A and1os.path.zs(name)>2# Cr1non*1entxDs inv7z6 "w :"wb" = bltn_open,8@P6ext;UFalse*Jelse1if UANonehasattr(G0, " ")Lqisinstance0.., (str, bytes))Y&! =K1obj5 ]>if i"M KO S& !6Tru  0abs&& ) l@ame J 1`<zp# Init Yfibutes0 ifW!mafaY ^ or%=.{if tarinfoA&=0CdereferenceG *'= Oignore_zerosP +(= RPencodx!is&'$= FGe  if pax_headerwf= PAX_FORMATH=VB9){}_debugM $5bugn1if _levelB )=6evel # Init datastructures. self.copybufsize =  'losed = Falsemembers = [][# list of as TarInfo objectsEV_loadbH# flag if allIhave been readEoffset = fileobj.tell()*[# current position in the archive QGcPinode${}SP# dic>ary cachingF,%ofC3 #r>ly added AEtry: F"ifmode == "r"!%Rfirst_f = Non$(fnext(), yay# Move to0end!a,W# before1 empty block,while True Qseek(8# dH@tarir.fromtariaZEs.append(F5except EOFHeaderError`7]break}O as o1raise Read(str(e)? in ("a", "w>x")84 {Qpax_h.sJ)4buf5}.create_;cglobalB.RB/()write(buf,z += len,z bif notC_extk % c !P8b/#-6b# Below aclassmethods which actfalternate con3orsPL@TarFF. The open() S1 isMponly onZ at0nee3forJpublic use; i#"super"-@ andB1abl@selenIPadequJ"sub: for a particular compress~$us;smappingP^ OPEN_METH# This concep6t allows one to subclass TarFile without losing the comfort of # super-constructor. AN is registered and made available P`by addo it`Amappn OPEN_METH. 1@amethoddef open(cls, name=None, mode="r", fileobjbufsize=RECORDSIZE, **kwargs):T"""Open a tar archive for rea`, writor appen. ReturnHP an ropriatenr!  'r' or 'r:*' transparentypressioC'r:'b Fexclusively uncomCe_7T'r:gzDoOgzip3bz2@?_bzip2@x Olzma?aFaa, crea~/ if necessary"'wKwK AE wF= F /w:F ?F /w:F @ F xx3e2Gb, raisU an exception~@s alty xS F edl !if8  Q)n CBC'r|*ja stream of blocks|P)an_ ar/edP DM-a  EEEwream for wrifting c'w|gz'open a gzip compressed stream for wriB3bz2CB_bzip2Cxon lzmaCE""" if not name and fileobj:%raise ValueError("nothing to )")Vmode in ("r", "r:*")R# Find out which *G() is appropriateJl0he .!de_( Ktypeteturn cls.OPEN_METH[0] == 'tarr'f'ysorted(H, key=notfunc = getattrC,)!if0obj*JNone\(saved_pos =5n.tell(W?tryDr0(($",O, **kwargsSexcept (Read53, C)1ion0obj.seek(,continueY ("RR coul!beuccessfullyelif ":" MO,0 = .split(":", 14.y or "r"=\'7tar# Select thention accordfoaq# given^:ion!ifiZ q"?els X("unknow U%r" % s'|%|PSF5wW:must be 'r'8'w'9A= _S 4HRzbufsize0t =* Uv6d.close rgaise t._extfileobj = Fal"return t 8elif mode in ("a", "wEx"):&e<cls.taropen(name,>#, w, **kwargs)er ValueError("undiscernibleB"0@classmethodDdef qVcls, vE="r"zW=None"""Open uncompressedS archiveR for reading or writing.5""" 42not8= tmust be 'r', 'a w'~U'x'")o{sC!gzB%level=9S Tgzip 1V! Appenw0is Rallowed{vqr6try@Qfrom import GzipFilexcept I BC1ion$!("Utmodule vailableu + "b",,[!OS $ifcA and0 == 4AReadU!(">'/- Ot = vS obj.close(8:Y 3 K &?bz2AUbzip2kCbz2 ?BZ22Smfileobj = BZ2File(fileobj or name, mode, compresslevel=C) Etry: t = cls.taropen(Sj, **kwargs);except (OSError, EOF )_Cv.close(@{!ifz == 'r'8 raise ReadZ("not a bzip2 Y"P0 V5?obj >ct._ext0 = False\return tX@classmethod#adef xzOGcls,Q="r",obj=None, #et j"""Open lzmaed tar archiveb for readingwriting.P Appen!1is Ofllowed%5"""1)Ain ("w", "x"?c Value must beP, 'w'O'x'" Bfromimport LZMA, _I*:C1ion$!("Ntmodule vailable s,uX~ utq# All *e") }s are registered hereOPEN_METH = {=p"tar": I", # un>f/gz": "g.{ # gzip20bz2a7bz2aexeA"" #2}/#-6# The public]which Tar provides:Gself@"""CD the=P. In  e-&, two finishzero block1 aoQ$ d8)f = Tru 41if / a]=}(NUL * (BLOCKSIZE * 2):lf.offset += (BLOCKSIZE * 2) # fill up the end with zero-blocks3(like option -b20 for tar doeseI, remainder = divmod(self.offset, RECORDD'if?M> 0:Ofileobj.write(NUL * (\& -J)izfinallyXqif not WC_ext[ % yclose() def getmemberv, name)E """Return a TarInfo objectY; `6S'. If A can!bej found in archive, KeyError is raisedJ#a ^occurs morMthan onceQits last :!re$s assumed to be most up-to-date version.$5""" @tari =E  if{+vis NoneZ ("B1 %r>02" %rsLX@s of  as a li8fYs. Th~(1hasBpsame or?c Nicheck(<ploaded:4# if we wantPobtai%of&-[> ()S# all\ s,Kfirst have to@0 0# sITwhole@}  0Qtheir@s. I &Ved by6s().# [p.Is()]*d=,<O1obj 0Cre1rom`resultos.stat or equivalenton an existingfe ReitheZ#H, orGspecified9` Bobj'aZdescriptorKgiven, `arc$' \salternative|"heVbN0, oQwise,#[ttaken f:'' attribute D'H1rrgument<Ep should^Ya texvstring. S""" self._check("awx") # When fileobj is given, replace name by1,q's real!.(ifLnot None: S=(.Building th!of member invarchive{# Backward slashes are converted to for!,# Absolute path;Bturn8srelativt`if arc;='nEdrv,9P= os.u.splitdrive(9)3$ =8.(os.sep, "/"/ qlstrip(&V`# Now,lUTarInfo object with,information specificS;0tar.1 = ~(@.tar:) t needed0Use(pstat or l q, depen0on if symlinks shall be resolved 0if dereferencAres ( %?els; H :6%mf(;@obj.Fno()yV = ""I@stmdltatres.st_mode@tat.S_ISREG(/)inode = (DWino, 6devQH and8nA > 1\C"inYs/"!t[]L# Is it a hardyto an alread-#zsd0-e?0typ}LNKTYPEcYs .AThe 6madded onlyits vali4# For win32is always 0(?REG"if/[0Q@(elg?DIRg9DIR <OFIFO=>?LNK=9SYM<0os.' /CH /CH /BL *BLhelse:  return None # Fill the TarInfo object with all+information we can get."0tar#.name = arc 0modMstmduid = statres.st_ui%g%g%if type == REGTYPE:f2sizk+Oelse9 0+R1mti ) @link64 = $kif pwd*ryuJpwd.getpwuid(uuid)[0]^9except KeyErrorZEpass2jif grp%t g0grp7grgg&\pin (CHRP, BLK ) if hasattr(os, "major") and in >,H1dev=a = os. (Urdev)9=a= =<def list(self, verbose=True, *, members="""Print a table of contents to sy~dout. If `X' is False, onlyDsL {` are pm!edM itFan `ls -l'-likePQoutpu+`produc>`T op!almust be a subsetQ' DPed byP&()5"""6U._check()q$ifX[ V5elfNCfor 4 inC ;$if wa_safe_K%P.fileN )n9"%s/%s" % 6'U.uid,z.E'ischr() 4gisblk(y 10 y("%d,%d,.x)9 f J 3Rd-%02 :?" \ % i`.local n)[:6]) _safe_print(tarinfo.name + ("/" if isdir() else "")) if verbose:# F^sym()$(u"-> " +@link)^ ?lnk^O? tocdef add(self, P, arc =None, recursive=True, *, filter """Add the!0e `E'archive.may be any type of6 (directorysfo, symbolic , etc.). If given, `'Gspecifies an aanativeF for!in FDH re5&edly by default. This canvoided byPsetting ``+@Fals%c' is a function@that expect# TarInfo object argument anQturnsxchangedJ ;,#Rit re5: ' will beIPexcluAfrom4 I5"""2s._check("awx"9$if a! =`# Skipsomebody tr toQ %..1if u@not yCos.path.abs(%F) ==3 J_dbg(2, "tarfile:ped %r" % uG1## Create a u 3getc 1Unsupported1# CC or M i40ter  =^4ter x  E< r# Appen-tar headerkLdata5l.isregwith bltn_open"rb") as f0add+7, f&el.4 HD ` <af in s4(os.listhd/w(os.path.join (name, f), os.path.join(arc/ recursivEqilter=f%) 7Uelse:Lself.addfile(tarinfo1Ddef '#, , .obj=None)Q """Add the TarInfo object `;A' to archive. If `OH' is given, it should be a binaryT, and.size bytes are readN@fromL3]addedYou can creat directly, or by using get5().{5""" G._check("awx"k; = copy. &Ubuf =atobuf(Vformat, encodingjrrors)u.write(buf offset += len 0bufm=la#there's datalfollow, append it$!ifobj is not ZYh(C #, =N blocks, remainder = divmoduFBLOCKSIZE@'if;:> 0beuNUL * (S& -E)`B1ZZ'%* X+members.y{extractallL , ~c=".", <, *, numeric_owner=FalsEMD all> |current workingc1oryr, modification time!permissions onIifterwards. `' specifa diffe~J3to *c to. `0 op!alBmust1subfLlist returnedC3getP"() j`True, onlyKI!nu for user/group 9Aused]2FamesF= []O%if/is! =84 inD 4%ifgisdir(Y$# ^with a safee4.  ) -.mode = 0o700Q # Doset_attrs , as we will do that further down self.extract(tarinfo, path, set_attrs=not .isdir(),GR numeric_owner=%) 7 # Reverse sort directories.$&(key=lambda a: a.name)/r](rpSet corj , mtime and filemode on4for) i$: 0dirA` = os. `.join( ,A 7:tryHVchown`,i >Ju JB1-_chmod- except EBError as e1if Ve$level > 1(YraiseT?elsXY_dbg(1, "tar: %s" % eDdef 1, member8=""|True, *dfFalse)3"""# aO from the archive te current workingdyK usits full 0. I@ile rmation is edtaccurately:as possible. `' may be ad  TarInfo object. You ca2specify a diffe"y `@'. FBibutes (t , xP) areu unless `'|i. If `T`P2is Aonly nu s user/groupYsr us@hnd notK5""""C._check("r"eif isinstance(sW, str9(R" =2get,3;3W@PrepJ@links1get@make&()e if"Z.islnk( ._9@_tarM ): ?_l9 3L== 6 Z e/OS07I,Pif e.V ?Non elf._dbg(1, "tarfile: %s" % e.strerror) ]else:%self._dbg(1, S0 %rV(W@, e.qVname)dexcept ExtractEK as p1if klevel > 1YraiseM1e) CRdef e(5, member)|3"""# a from the archive a F object. `Iy' may b*) or a TarInfo;&If>is a regularar a link, an io.BufferedReaderQ is returned. Fsyll otheJexistingzs, None=does not appeaK(inR, Key%d.5""" ._check("r"if isinstance([H, st(@tariK=P2get,3 ;3%U3if .isreg()Atypein SUPPORTED_TYPESEG1# M\s with unknown @s are treatedMs-Grq:)el:lnkgissym(d ok@, _Sm26# A small but ugly workaround forcase that somecUtriesJD# to a (sym)B-a non-seekabloM #-Qeam ok blockZ)b P("can+ g"]I##'s3j0itsk:get _p._find_-_target(@# If0re' data associ  (directory, chrdev,P# blks etc.),W`nsteadF __,7 getpath, set_attrs=TrueFnumeric_owner=False ya physical p called-p# Fetch @`given >e# and build the destination pathname, replacing ## forward slashes to platform specific separators.;`target]6 = .rstrip("/"),e-, os.sep) 6# Create all upper directorie`dirs =E@.dir("ifN3uand not9uexists(T%):4 that areI part of the archive withGdefault permissionjpos.make ifvinfo.islnk() orKsym( self._dbg(1, "%s -> %s" % (K5,F@link)=Jelse V5tarH ?regDfiled M?dirMLOfifoMN@:if set_attrs/ch, numeric_ownerLh!if?.is9(_chmod ,0Outim/#-6Pa Belowdifferent _ methods. They%called via@_extract_membeSwhen b() is 5Fccan be\ded in LqsubclasU`implemother funcbality.@def ?O  """Make ay01"""6tryH@# UsJsafe mode!y,Breal! isSFPlater I*kv, 0o700except FileEZErrorEpass> makefile(self, tarinfo getpath): """Make a file called4+.* source = self.:;objc.seek(~.offset_data))ebufsizHCcopy#with bltn_openO, "wb") as if.sparse is not None+/Bfor !, +in@48btarget@ '(=p, ReadError, JnY*truncate("?els ndef makeunknown( from a TarInfo object 3an YQ typera at]I Q._dbg(1, "tar32: U* %r, " \9"extractedqregular=@." %.I!) C?Ofifo</foif hasattr(os, "mkq"2os.,ZGCrraise E ("Xv`suppor by system"?dev1cha`r or block devic!if Pnod")S/ lakedev*sspecial{q0mod kkisblk(- |= stat.S_IFBLK= /2CHRm7nod , 3,S',.`devmaj[inor)Olink(symbolic) > If it canbe created(platform limitation), we try to0 a  of the referencedNpinstead)a:tryDS# For ss that " and hardXsY| 3sym if os.path.lexists(targetO): # Avoid FileE4Error on followingVsymlink.EPos.unp *3os.F'Pinfo.4gname, 9Nelse# See extract()  s_t_o!os3]cself.__member(Hfindcx)), F5sexcept t_:ionO:trydBsA Keyrraise E$("unable to resolve  inside archive") def chownx %, numeric_owner q"""Set 7 ofp accord( toUJ. IfL is True, use .gid/.uid@tead_ .g0/.uMFalse, fall backWwhen the se` based\VfailsL5"""if hasattr(os, "geteuid") and z() == 0# We havpbe rootVdo sop5g =C5giduujif notr Bnif grp1grp.getgrnamI)[2]3%Mpass: ?pwd!0pwd(pwF8ibissym( 7l"Xx!_]u, g)%j?os.E!OSKUoQcouldibchange `?mod`Qfile permissions#\ """ trGy: os.chmod(targetpath, tarinfo.mode)/except OSErrorGraise Extract ("could not change O1") Qdef utime(selfs )c`"""SetAification =0 of1 according too5""" !ifhasattr(os, ''v5ereturn8.tr@8 @ |m)R; _/#-6Anext#A"""R"P the "q memberhe archive as a TarInfo object, whe[ File is opened for rea#. jpNone ifrr,qno more available.t._check("ra"1if Sfirst!is-xi=m =.p! K = F $b" m6# Advance fvpointeroffset !leobj.tell(W!Aseek.B6- 1/# 6+(1X-CReadunexpected end0dati # /8Vblock 2 whJTrue D.fromtarY EOFHeader raignore_zeros&_dbg(2, "0x%X: %s" % 7, e8@+= BLOCKSIZEO)ycontinu Invalid$el'O== 0 Lstr(y/WEmpty-Qv& "e\jTruncate r aise ReadError(str(e)) except SubsequentHeader1i as e:/:rWebreak ;if tarinfo is not Non[self.members.append(5?els7_loaded = Truexdreturn|/#-6 # Little helper methods:ndef _get(t, name,= , normalize=False)x"""Find an archive N1 byK from bottom to top.I I~given, it@usedthe starting pointB5"""N# Ensure that alls have been @@s = . 2s()$F@mit 10 se list upD[XN #[: e.indexe]&if = os.path. ( fo  in reversed(yTn4_ay.'8+/N='came ==2 (aHC0""" througheentirefile and look Ereadable# s whD KZnext(1 M B |Qchecka, mode C# if TarFis still op  heration'sNcorresponds'M)'"ifjclosed!OS@("%s*)2" %8__class__._&__M!if6/ !in&{ 6bad?%%rxufind_link_target ~Vq+X of a symF or hard )th?ivej~w.issym(E# Always X0 = "/".join(filter(None, (os.path.dirname(tarinfo. 4), AlinkG)) limit = NoneUelse:.# Search the ive before_, because a hard ; isIjust a reference to an already]yd file.<P- = ( member = self._get(Z0=, normalize=True;2if ;1 is< /raise KeyError("` %r not found" %#Zcreturn^def __iter__()n"""ProvideE$ator object?5"""#iffloadedLyield from% 41# Y6items using TarFile's next() methodP# WhelAs haU0en T, setHR as _Cindex = 0'# Fix for SF #1100429: Under rare circumstances it can?happen that 0s()called durkGion,?which willexhausted-Cfirsw0 SI+= 1?`while  h2if IQ< len~.pW)[B]Aelif . {Q&K~F$h! = $ ) s1dbgQ, level, msgU"""Write debuggu`output2sys.stderr U# <E print(msg,m=T)?_enzQmcheck( D3xit , type, value, traceback!if$[g.closew# An exception occurred. We mX L ##would tryywuend-of- locks and padding,@_ext:obj)" !d = True #------ # exported functions #% def is_tarfile(name): """Return True if  points to a tar archive that we; are able)handle, else rTtFalse. /'\' should be a string, A, or -like object.=1"""2tryif hasattr, "read""t = open(c@obj=)NS1 )t.close(;9Oexcept TarErrorV) ='PFile.! Smain( im argparseDpdescrip = 'A simple command-line interface for module.'S5r =_.ArgumentPm'r(i= >c.add_a7('-v', '--verbose', a='store_trudefault= ,t rhelp='VL output'~group = mutually_exclusive_&(required=? llist', metavar='<1/>'PShow >bing of5w u'--extracxnargs='+n(2 '') Ep@into get dir c'PcreatN>A<Cf0 from sources I_'--te$@Testzis validv2s() ifV s. is not None2src{%i3src Bwithsrc, 'r') as"\,tar.getmemberlprint('=sys.stderr55wVP'{!r}E=.'.format(YUr.exit(1, OK S+\nUM$el:%85Tar#:*f0tf.e(8=D.   arser.exit(16, '{!r} is not a tar archive.\n'.format(src)) elif args.extract =QNone:#'xif len()f) == 1#'Ysrc =O5[0]E"curdir = os. f2f", = nLsyparser.exit(1, d_help(.if is_tarfile0 with TarFile.open$, 'r:*') as tf1U$tfeall(path=)'\verbo!8>'.'j&Smsg =9ed.  </elxV(h W- 'K5a'into directory.') ?print(msg `create3I tar_name|,f.pop(0b_, ext.splitext(@,compressions = {EI# gz'.gz': 'gz',t<# xDxDxD[# bz2p0bz2 ba7}w<0mod|x'w:' + <[ext] ifz)in /6 'wLst3,Z_@for Z'!in.sptf.add(/  = Aif __!__5__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_)) Login@ N 3TTY ` Idle 1Whe2aWhere fGo van Rossumr pts/2  snag.cnri.reston.. Note that won't read until eof -- it just reads some data -- butguarantees to( at least one byte unless EOF is hit. It possible=pass a Telnet objecta selector in orderwait until morSavailable. Note that:this case,_eager() may return b'' even if there was0 on socket, becaus]e protocol negotiationVhave eate<;@. T`is why0Errs needediUdistinguish between "no" and "connecxclosed" (sinc also appearsQy for `ing whD). To do: - op^ - timeout should be intrinsicGthe instead of an Z!on0oy calls only """ # Imported modules i6 sy <as from 4monotonic as _ __all__ = [" "]x0TunT parameters DEBUGLEVEL = 0% defaults TELNET_PORT = 23-`characZ (don't change) IAC =Ks([255]) # "Interpret As Command" DONdx-y4]) DO A[3]) W(2 IL<1]) theNUx0]) SEQ40]) # Sub! End NOP"41)qNo Oper*9 DML2#Data Mark BRKC3 Break IP<4@ruptycess AO(B # Abort output AY8"46KAre You T) E"47$tErase C9 ELm8&yLine GA!9!Go Ahead SB = ]QBeginls codeK# sekps all caarpa/t.h BINARYxq# 8-bity path ECHO$# echo RCaprepar#reF SGA@p# suppr/Ago aFNAMS&# roximate message size STATU/# give status TMM#mnFRCTE P# remIcontrolled transmiss7NAO@#@e ab,n line width NA$ 6pfNAOCRD1nCR disposik'HT1negotiate abou,t horizontal tabstops NAOHTD = bytes([12]) # negotiate abou; dispositionB(FFB3Bformfeed<7VTS~4<bvertic V5: L6@output LFgXASCII7=extended ascii character set LOGOUT484force logout BM 9  macro DE?!20 data entry terminal SUPDUPJ!21+supdup protoco'HOUTP2-w SNDLOCRsend locaWTTYPE$ type EOR"Eor record TUIL2TACACS user identifivgOUTMRKU marking TTY} number VT3270REGIM regime X3PA3X.3 PAD NAW3window size TSPEE@~speed LFLOW3~ remote flow control LINEMOD3Linemode opYXDISP3X Display LOLD_ENVIRONOld - Environment variables AUTHENTICATI;@Authcate ENCRYP3QEncry?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 Xe4ch CHARS44^7 RS%4UT" R\Serial Port COM_PORT_OP4b1Com)" C! OPRESS_LOCAL_ECHOuvSuppress{l Echo TLB4u/tart TLS KERMI=4b SEND_URLw]-URL FORWARD_X#R PRAGMA_1rTELOPT % %^ SSPI0X0#.;_HEARTBEA1 d)W EXOP"25UExtended-Optionsj-List NOOPT = bytes([0]) # poll/select have the advantage of not requiring any extra file descriptor, # contrarily to e\kqueue (also,^"y Ne a single syscall). if hasattr(ors, 'PollSor'): _Telnet5 = 2.0_ else3Hor class e!: s2""" interface '. An instanc:Bthis represents a'nection to a tbserver. TheLis initially 0conB0ed;Rq open()Amethod must be usedeestablish. AlternativelyGhost name and opal port number canb3pasd1the<construcC tooDon't tr re an already%ed8TFPhas m3R_*() ps. Notcat som!emraise EOFError when70endQ0is _, becausAthey`returnempty strfor other<0son Se@individual doc6so _until(expected, [timeout]QRead (,N9 been seen, or[E1 is Fhit (default is no k); may block3all^@all data?EOF< =t least oneCvery_eagerIavailableOvdYfhe socket,rwithout8ingm!eifzr z OlazyiAraw y (procesF it first),ay do8H I/Oaz%s {bcooked~h `y h0sb_> &s 2P betwSB ... SE sequence. EQset_o_negotia_PTback( GAEach {  input flow0allU(if set):i!ed}`followzparameters G/L( command,5P will|echr(0) reno option. , No other action is done afterwards by telnetlib. """ def __init__(self, host=None, port=0,37timeout=socket._GLOBAL_DEFAULT_TIMEOUT)::"""ConstructorO0When called without arguments, create an unconnected instance. CaWith aEnameCS, it 9Us the<;u numberCand p are opV&alj;r1 .debuglevel = DEBUGLEVELS%U! = c! = = z0 =  rawq = b''i0ocooked2keof = 0Siacse/ # Buffer for IAC seque sbIq # flag-0SB k/SE3Cdatai _5Lback!ifg 1not"Popen(,f)#)%=0+3 to&Thiu second(u, whichdefaults\+Cdard\W (23)sDon't try5 reetalready2k  (0if y y = TELNET_PORTg.%6ys.audit("T.0", t)b2et._KGion(>)?S__delV $De  -- close].e&(_3msgmsg, *argsgPrint a  message=!enogis > 0!If extraspresent,AysubstituGs` using 0strpformatt Zopera!ifn;> 0`"('(%s,%s):' % )_.), end=' ' ifs[p_Qmsg %" 7Oelse4Aset_|{, 1Set:1 level. 6The higher it is, the more debug output you get (on sys.stdout). 5""" Qself.@rlevel =M  &def close(,!):H@"""Cconnection._`ock = :U.sock=z = Noneeof = Truiacseq = b''2esb = 00if o.)@get_/etaReturn$ object used internallyr5lofilenoh $O) ofx,.KBwrit, bufferW a string top, doublany IAC characters_`Can bli2 ised. May raisOSError 9dii!if#in 8.replace(IAC,8U+IAC)=6audit("telnetlib.T .A!",C:Nmsg("send %r"$M.$Ball(read_until+, match, timeout=1 QRead 2 a givenis encouSed or'LOrWhen nomsfound, `whatev~s available instead,possibly9Sempty@. RO EOFE"issPd andcooked datan = len(8process_rawq(iklq.findAif i >= 0_<5i+nm buRI[:i]# ~:[i:,5bufC%1notI deadline = _D() +GIbwith _Selector() as Us$.registers.EVENT_READa`while :eofZ$aR(-1 = max(0,Zs:)-n0%Lfill%/$,v;?, iJOi = i+n  buf = self.cookedq[:i] ') 8/i:8return buf[if timeout is not None:()= deadline - _/()1]?< 0UYUbreakBread_very_lazy() &Adef @all(()\"""Read all data until EOF; blockconnection closed."""^U.process_rawqQwhile+&6eof~<Lfill9Y #e = b''/Osomet least one byte of `6@less7Bhit.{ROX'' if#1 BbRif noHis immediatelyCavailableW$_q and_eagere# thing that's possible with!in I/O (Q)LPRaisePError 1* (no1  otherwise.FUDon'tuPin the mid|f an IAC sequenc0 eoUdTQsock_("!n@<7ilyAxkSB"""P-% that's alrea dy in the queues (lazy). +Raise EOFError if connection closed and no data available.Ceturn b''?no cooked0 otherwise. Don't blockGdunless midst of an IAC sequence5"""=self.process_rawq()r#read_very_ "() Kdef .%):DB"""RG#isA  P[b'',]L*ryo_whilec_getchar@$8z.iacseqi$D0 ==wONULL%)continueFb"\021"F) !=CBAbuf[0sb]?+ c OelsesoE? +=delif lenNo)V1U# 'IAC: IAC CMD [OPTION only for WILL/WONT/DO/DONT]' if c in (DO, (,; , </):4Gself.iacseq += c)continue "GO= b'o== IACAbuf[Oisb] = +OelseR == SB: # SB ... SE start.O = 1(PdataqS%elE*}0}7+A/1]A d1m1if Zoption_callback 3# C( is supposed to look into # the sb* (sock, c, NOOPT)FE # We can't offer automatic processing ofcE2subEs. Alas, we should not get anyF `unless;Qdid a/DO beforemsg('IAC %wrecognized' % ord(c).2len\:o) == 2 Rcmd =:-O[1:2%DOopt Z)md os %d',v = DO and 'DO' orANT',3?opt5D"1v~@md, xdO.sendall(+>/ +^{qu!^w yy.sendall(IAC + DONT + opt)  except EOFError: # raised by self.rawq_getchar(9@ iacseq = b'' # Reset onSf-isb = 0EpassR`cookedS + buf[0]-esbdata--11] .Idef Y!):"""Get next P from2r queue.F*Block if no y is immediately available. RI[mwhen connectionBgclosedg5"""0mt`.fill_ "if7:eof6:2c =5P[_i : ++1!8 8+ 1= >= len(YSE`Greturn cObv"""Fillexactly one recv() system call#Se@eof .<?P# TheZ)fer size should be fairly small so as to avoid quadratic# behavior in processe above+4buf.Qsock.s&50^Pmsg("P %r", !Xo= (not[e #y_ $@TestEther-@the C8et.with _TelnetSelector():s .register,<s.EVENT_READ r@bool4..OF(0))interact&fI1fun , emulates a very dumb tj clieneys.platform == "win32"Uf.mt_#IW4'orys.stdinwhile Truefor key, eventso (2 if9@eobj%b0=try text = self.read_eager() except EOFError:)@!print('*** Connection closed by remote host ***'wNoreturnq!if sys.stdout.write(.decode('ascii') C_flush-elif key.fileobj is ;/in@line!inY().en  @not 6iR'L!) rdef mt_interact(&)h"""MultithPped vers5of 4Q)."""Nimport _3.start_newr.listener, (vwhile 1`Tm(?if 8Ybreak/Fb / ,Helper forU) -- this executes in the other + F:try @data /0if ;' OelseI Cexpe , , timeout=NoneRead until one from a6 of a regular express matches.JThe first argument)HF@, eiDcompiled (re.Pattern instances) or un%strings).A opal second,!s; defaultGTis no2R a tuplee items:Pindex]z&e\$T thatX;L@re.Mhf objecoqed; and*  up tillincluding$ If9KH1wasNp, raise(%iOwise, whenohieBes, ` (-1, s,).r !is received so far (may be!bempty  if a timeout happened). -If a regular expression ends with a greedy match (e.g. '.*')Eor if more than oneL3can=the same input, theEresults are undeterministic, and may depend on; I/O timing7"""Tf = Nonfplist = 5[:])indices = range(len($)fC in ,:=KPif nocQsattr<[i], "search")/3re: import r!0[i]e.compile^ if!is sdeadline = _time() +6_TelnetSelector() as s U.register(self,.s.EVENT_READQwhile2J.eofZ$process_rawq(D$ "m2i]..cookedqW5I_m.end 0texnk6[:ew$) =Ff'[e4 return (i, m, v$LRready.(8>out]5D = dk-ka)4mh?< 0(V_breaklOelse@ ~continuLfilll) f._very_lazy,N raise EOFError1-1,!def __enter__i:n.3xit- , type, value, tracebackE>.close() CStest(#"""Test program t?3libUsage: pythpy [-d] ... [host ["]]Default is local 3; d/c is 23kdebuglevel = 0+qsys.argv[1:]V] == '-d'$ G !+1RTGdel CE = '''if*&:]f0 G=2=&0str2a try:  port = int( Tstr) except ValueError:#0 = socket.getservbynameLr, 'tcp'Swith Telnet() as tnQtn.set_debuglevel( ?stn.open(host, , timeout=0.5)interact() if ____ == '__main__'0tes'2"""Temporary files. This module provides generic, low- and high-Lerfaces for creating t\7 directories. All of theE vgd by tcan be used \out fearCrace conditions pfor 'mk5'. is subject to = should nott@; it9] backward compatibility onlyLe default path s are returnedstr. If you supply bytes as input, all4 v`s will"in-q. Ex: 1>>>@.mks(.(4, '/tmptpu9nin8 7d7suffix=b'%b>pbi8f0hy'6Falso;some data itemspAuser TMP_MAX - maximum numbe0Ethattried before(0givwQup. 0dirWIb is!sePa str,GPfirst]: ofXany routine from,consider Dother candidate locaQstore """ __all! [Se"NamedvFile", # 9safb/o"SpoolJ D2y",zIo!mk ",K #%y ;I# deprecated un;0getjprefix[#bstants7)7dir7 Ib$b p] # I9t2i functool% _ rwarning  io4_ioo($osashutil& Berrn>  srandom {RBas _ <"syg%syh1typx! _ *qweakref _thread e_lock = 1.al _text_Pflags)os.O_RDWR | _ UCREAT@EXCL hasattr(_os, 'O_NOFOLLOW') [gs |= _os.O_NOFOLLOW _bin_openflags = _text if hasattr(_os, 'O_BINARY'): Bt|= _os.& AtTMP_MAX@{3os.R else`v = 10000 # This variable _was_ unused for legacy reasons, see issue 10354. # But as of 3.5 we actually use it at runtime so changingwould # have a possibly desirside effect... mwe do not want to support # thatan API. It is undocumented on purpose. DJQdepenthis. template = "tmp"+Internal routines. _once_lockurallocat() def _exists(fn2tryos.lstat except OSError*return False)IDTrueybinfer__type(*args"""Look at the of all & and divine ir implied Q1A."""eb = NonDaarg inT if,rcontinuBif isinstance(arg, byte##ifWis st@#raise Typea("Can't mixVAnon-d<"path components.")0 Y .2 &-o1str @ # _@files! abafault.Y9 sanitize_params(prefix, suf6dir@Comm+eter processingBmost0in u moduleaoutput[#if7 = ^(:2if R6(if0 ;=j3n,mfsencode(9ds8P= getR3dir -b. ,  class _RandomNameSequencd"""An L+ generates an endlessBsMce of unpredtrytgetcwd() xcept (AttributeError, OS NKccurdir['ROCalculat@ to v];IThis routine shouldscalled exactly oncWe determ1whether or not a!usb1tryPo crepand wri2o a!in B If thisis successful,Ctest=s deleted. To prevenial ofCrservice=Joa&e I@mustrFizede2r"$ pdir_list() for dir inQlist: if != _os.curdir":path.absU(dir)F # Try only a few names peyuectory..0seqrange(100)u@ = next( l@file @join,}0:try`#fd?Topen(Sp, _bin_flags, 0o600P?T with _io.a(fd, 'wb', closefd=False) as fpBfp.write(b'blat'*ofinall}>(fdC? ;eunlink>BQreturywexcept FileExistsErroz(Opass9Permission9r# This hion is thrown when a the chosenA u# already e on windows)@if (= 'nt' andf@`.isdir) nEA`access(,<[W_OK)-,continueMbreak # no point trying morest22dir GH? OSoc(Qraise NotFoundd(_errno.ENOENT,"No usable temporaryfU_%s" %J 0dir!@) __sequence = None def _get_candidate)#s("""Common setup Aall user-callinterfaces.""" qglobal X+if+_once_lock.acquire( Qh ;RandomNameS&k:dreleas& d n0mksQ_inne3, pre, suf, output_typeBde c3to H4, T$, d sVbytesD1mapfsencode"s)$ sTMP_MAXIs = _os.path.join(dir, pre + namcsuf)  _sys.audit("tempfile.mks 0", -Etry::Afd = _os.open(-, flags, 0o600;except FileExistsErrorNcontinueZ# try againrDPermissionDr# This +ion is thrown when a directory with the chosen malready e on windows.)@if (b== 'nt' andpath.isdir) =j=`access$,8jW_OK))#,' ENelse+Uraise(return (fda0abs1)) -7 (_errno.EEXIST,)"No usable GQoraryJb found") # User visi-interfaces. def getAsprefix( """The defaultwfix formqies."""QOlatebbc$~ as bytlfsencode(0) dir = Non-A%orj.?aglobal1dir$iff$_once_lock.acquire( J Cget__^kfinallLdreleas8dirA@ ver" o.Y3[))&(suffix=HT 3dirtext=FalseQ-callPfunctto create wa uniqu; )Pvalueba pair)Pre fd"thA descriptoroced by ,C9.BIf ''"1not,Ea- will enda2at 65otherwise7"re/Sbe no'nn@begia pa6wis usedq?dirn#bed in thatQoy7 r1sspecifiedGtrueY0is dew1extmode. Else (default) the fil*e is opened in binary mode. If any of 'suffix', 'pre  and 'dir' are not None, they must be Jsame type.V$7Qbytes4` return,@willA!Q; strHotherwisqThe filreadableAwrit ponly by creating user ID.T!IfBoper`system%s permissio ts to indicate whe! aGQexecu|no one. CdescriptorSinherited4childrenthis processQCalle:responsi for delet/when done with it 2"""", , dir, output_ = _sanitize_params(4)Nif text:YPflagsD_ Oelse*7bin)*2@ _mkp_inner( _ ) def mkdtemp(=? 1dir )"""User-callbPfunct!"toba unique fQorarydirectory. .AvaluApath o4WArguments0as  , except tha0e 'l51 isf ac+#edIlZ$, W,easearchgW kX{[kget_candidate_!())if1is - = map(_os.fsencode, 0sequrange(TMP_MAXbI = next(;Q = _"X.join! +m# +:_sys.audit("J.!",I-6try> os-0ir(8v, 0o7000pFileExistsErrorCcontinueO# try again\DPuD0# T+wis thrown0n a\Kachosenmq@# al1y e on windows%@if (r == 'nt'Aisdi~) fA(h"ssWW_OK)(' E 'Uraise(F# rror(_errno.EEXIST, $"No usable temporary directory name found") def mk((suffix="", pre Plate,?q=None):y"""User-calli function to return a uniquAfilea. TheKis not created. Arguments are similara0mks, except thae 'text' a91 isI[ ac+ed, and  abytes ,1notLfsupporTHIS FUNCTION IS UNSAFE AND SHOULD NOT BE USED\A mayWArefea1didexist at some point, but by the timLyou get ar+Rqing it,?one elsezp have bt n <!toTapunch.p""" ##pfrom warnings i]tP as _) "("Z is a potential security riskyour program",CpP RunWt, stacklevel=2)( ife=Pdir =-Cdir(0= _get_candidate_!() for seq in range(TMP_MAX^/ = next( s:;= _os.path.join(dirk! +# +:!if_ s(Is\]raise FileE'sError(_errno.-$^' class _TQqbCloserq """A separate object allow~proper closGof ao'punderly%I, without adda __del__ methodEtQB.:0 = $ # Set heY5ncePchecks i e_ed = Falsew8__init__(self,,, delete=Tru3(.lr=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. NotWCthis must be Pencedp`, beca/C W}may also before # __del__ is called.  def close(self, unlink=_os. %):,3pif not -.8_SB and@filek'JNone@D=i= Truei)>try>Bi-();ofinall?"if_deletcf.name)8# Need to ensure the Xbd on _|pX _X(m7els?* =D=;). class _TemporaryFileWrapperj5"""w? ThEprovides a #q around7s opened forAts use. In particular, i0eksautomatiy=Wremov@when3is no longer need 2"""u__init__, , ", =:! =.W:! =A M# =V _;r =~C r( Dugetattr# Attribute lookups are2gatunderlying#Bcach non-numeric results# (i.e. methodj;,dNSfrien6not" =__dict__['%']eCa = E`if hasa(a, '_ 7__'func = aX @_`tools. s(\$x_!per(*args, **kw h3preturn 6 . q# Avoid-1 as{kalive,F sesue #18879. . 0r4isinstancer;intsf6, aUag# The __enter__W 0swrong object!# g.6) so override#to=<7iBQ.# %Ftrap __exe@well _#geF#pused inJith statement  def __exit__(self, exc, value, tb): result = (e.file.; 54+uclose()rreturn P '2u1"""!CH the temporary , possibly deleting it.8D_!._k!r."()# iter() doesn't use __getattr__ to find __-__ methodkL@# DoT=#G), but yield from itn`avoid 1ingc# as longpit's beBusederator (see issue #23700). WeN ca'' here becak") sJobject ite, which has ae-1, aFuE would getOqed whenn3gen isalized, due.PEP380 semanticsfor line inU%0 dNamedTgFile(mode='w+b'ffering=-1, encod UNone,Y0newa=%s suffix 5pre ?3dir.@e=Tr*, errorss"""Createk+ a7!Arguments'B', ' pdir' --YL0mks@' # aSio.open (defa?c"w+b")<#buGA_ sizeH $-1E~DA 'A@?qwhether2 isSed on EJ2TheAis c#()a!docRSs an awith aH@-lik0terface;qname of Gqis accee"Pits '+ ' 9ibute. will be automaticallyKG it;Runles/'&'Qis se1RFalse[U,p, dir, output_type = _sanitize_params(4%Pflags3@bin_A1Set}O_TEMPORARYt( N OS#X@ is only supported by Windowpif _os. == 'nt'i: flags 6|= _os.O_TEMPORARY (fd, name) = _mkstemp_inner(dir, prefix, suffflags, output_type)IAtry: V@filePqio.openemode, buffering= ,7;newline=p, encod= , errors=)Dreturn _TemporaryFileWrapper(s, deletexcept BaseE 6ionAqunlink(2close(fdaise ifz2 != 'posix' or _sys.platform == 'cygwin's# On non-POSIX and C 0 sy s, assume that we cannot 0 a @# wh`it is .  = Namedd elseIs the O_TMPFILE  availabledoes it work?fR# The+is set to False if os$n]0) rBCs anGIsADirectoryE "io"__WORKS = hasattr(_os, ' '*Idef (h='w+b''-1}ONone=$ 5 J % 2dir % *J)-"""Creatm a /ArgumentsB'B', ' dir' -- as for H'" # a[ (default "w+b")@E_ sizeL (-1IHE Gw'EDtCB1s cd}() would do it.R object with-like interface. }fehas no,will ceaseexist when1is d5"""E|global zm@>'sanitize_params(4ts7@bin_p@ DQ2 = ( ! |HP) & ~uO_CREATn< fd I2, 0o600.  *# Linux kernel oldern 3.11 ignore: 6 # O_TMPFILE is read as O_DIRECTORY. Trying to open a directory # with O_RDWR|Fb failsDIsADBError, aJf cannot beto write. Set flaPFalse?notNtry again.__WORKS = M )except OS:# The filesystem of the,` does vsupportz# For example,v(95, 'OperationMOed')GOn Linux kernel older than 3.11, tregularL (or a symbolic link#a 8)jM"=Not#vbecause6N|Ipass4Nelse>tryreturn _io.(fd, mode, buffering= ,j?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(i 5rTextIOW(dGx >  newline=$) self._max_size = "rolled = FalseTemporaryFileArgs = {'mode': , 'buffering': ,I'suffix': b, 'pre GRencod 3, '3': Mdir': dir, 'errors': !} __class_getitem__ =  method(_types.GenericAlias):def _check(, file):V 0if "._: return # =("%ifA anda.tell() >rvsrWover(" 0new 9 = g0(**p)._}3del %j popif 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(:My def mode(self): 6try preturn '._file.mode0except AttributeErrorBTemporaryFileArgs['P1'] S@propertydef nam!7DONone|ewlines3"n*JAread8w, *argsr?-' BF1JK,s(LOseek- BAtellB &)rtruncatp, size=E!if@ is  K)0:lse0M> @max_u &lZrollover(TEvF6wriz# =~ Prv = .<tp_check("u&rvS>8, iterable!HBZ. u class +Directory(object"""Create and 4a tb$ d8. This has the sambehavior as mkd; but can be useda context manager. Forexample:IOwith)K[tmpdi!2...>Upon exitingw, peveryth*&Qainedin it are removed.2"""e__init__y, suffixAV, pre 1dirs_$ =4(A<,zl1_finalizer = _weakref.(^1,scleanupw,, warn_message="Implicitly 9up {!r}".format)r@jRmetho=rmtree(cls, 0one(func, path, exc_info+if issubg(%[0], Permission3 9=lresetperms(i&* _os.chflagD, 0)  except AttributeError: # Opass_os.chmod(path, 0o700) ,?try^0if : != name%resetperms(u5@.dir5|-))u 73&obunlinkih# PermissionM is raised on FreeBSD for directorieTS(IsAD+yS,d)/cls._rmtreegFileNotFoundfT elif issubclass(exc_info[0], URsDQ_shutil.P, one=@amethoddef _cleanup(cls,s, warn_messageCha_2Pings. (@, ResourceWarning|_repr__(selfi return "<{} {!r}>".format)1.__P__.__@__, B. _Oente`4NCexit, exc, value, tb;:s /"if_finalizer.detach(%[8 getitem__ = $(_types.GenericAlias) """Text wrapping and filling. # Copyright (C) 1999-2001 Gregory P. Ward.+ 2002, 2003 Python Software APation7Written 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 '  (1"""aObject= />iCtextpublic i9fonsists ofH@A%()J2() !s;7Tother@just reH(enoverride in order@weak7 default behaviour.DIf you want0completely replping algorithm,' you'll probably have to override _wrap_chunks(). 6(Several instance attributes control various aspects of KQping:E width (default: 70) the maximum(Aed lines (unless break_long_wordsDis falseVinitial_indenty$""# string that will be prependedQfirst%edxoutput. Counts towards"'s.2subsequent,1all1s s1he h  ; also cAeachI expand_tabs?5trud1 E$ $in input text=spaces before furthertcessing0 E4tabcome 0 .. '[Rize' N1, don its position!tsR. If!, fis treated as a le character|8<E u'c$' ~replace_white R+ /As in#bySPafter sion. Note""if6 ann@ue, Iy`l`converEto a!fix_sentence_ending s Ensur6-6 punctua3talways followcby two$. Off by p becausce algorithm i(unavoidk) imperfect B  Qhan 'R'Sthose,d3not@ pbroken, sdps might `@on_hyphen| AH/l.2,#Soccurm 0fer<F on sras part ofBcompoundwOdropRDrop leahsPtrailQ fromgs_Bmax_T7Non2Truncate@gholder' [...]'} Ape'latad text. """ unicode_whitespace_trans = {}" = ord(' ')for x in ::V [Dqx)] = uW# This funky little regex is just the trick y sp%1ingq# text up into word-wrappable chunks. E.g.0 "HelloW re -- you goof-ball, use -b option!";{sj! L/ /there/ /--/ /you/ /T/UP/ /us thS-b/ /]J (after stripping out emptyBngs) _punct = r'[\w!"\'&.,?]'L0letJS^\d\W9%s]' % re.escape()no4v'[^' + A[1:]s`sep_re[e.compile(r''w( # any@< %(ws)s+| # em-dash betweens" (?<=%(wp)s) -{2,} (?=\wWE, possibly hyphenatedI1%(n~F? (?B#16 C-(?:lt)s{2}-) |0-%(&-)8"= 3 -? $oend ofz (?os)s|\Z8; 11(?=40L0)'' a{'wp':w, 'lt': h,dP 'ws0TA, 'nO}8re.VERBOSE|9delnh ? ;?les@= on recognized ~/s.h /VWosimple^P(%s+)D.PXXX tmis not locale- or charset-awang.lowercase#US-ASCII only (and/refore English-sentence_end`[a-z]'z%# ve}   X.\!\?L$# }@-endU8HFOX"\']?#al end-of-quot: kr'\Z')#Edef __init__(self&>width=709ial_indent=""$ subsequent_indent="", expand_tabs=True#replace_whitespace* fix_sentence_endings=FalsWbreak_long_wordOdrop|Oon_hyphenO_ize=8*max_lines=Nonholder=' [...]'):jself.width =  sinitial: =  -Isubs= =  37 =  '> =  5? =  9< =  1 ; =  /M ` 13 = 5 = #7 = ! )# -- Private methods -I(possibly useful forclasses to override)}def _mung(g, text>"""*$ : string) -> ^TM] #1 inZ:sX and convert all otherD>characterus. Eg. " foo\\tbar\\n\\nbaz"Drbecomes&UPbar #.$&""00if .@=%"<. Eize)ZN9UtranslateThunicod_"eRretur^\QsplitD []SIA theNwrap into indivi}pe chunkC E are not quiteHsame as p; see _T_C!()EfullA`detail^As an example,P* Look, goof-bV --*-b option!0sfollowing'[P', ' c g#-- cc 'useF 'th %-b'7#ifA is o or in ball', ' ', '--', ' ', C'useF 'th $-boption!'6otherwise.5""" if self.break_on_hyphens is True:*chunks =4wordsep_re.split(text)1?els?osimpleFs[c for c in Uif c]pTretur  def _fix_sentence_endings(,H)?"""0r: [string])bqCorrecti ip buried'D'. Eg. when theGoriginal G" 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@ V h2en : int )H" ax2 of(most likely a f, not )[!is0X0fita@any d# Figure ouZen indent`largerdp specif_,(6mak0# sLat least`racterS'pped off on fy passf; < 2_left = 11N )" -&"en`# If we're allowed6 Ds s,n do so: put as much#the next0nto9vrO:{6fit lys|.append(f[-1][:].? = [C(:]+O1, we havp preser &he4act. On'dd,im:the if/@re's hing already there -- 2 # that minimizes how much we violate the width constraint. elif not cur_line: .append(reversed_chunks.pop()) 4# If we'reUallowed to break long words, andre's alreadyHptext on"Prent @, do\hing. N'0timPrough1Gmain loop of _wrap0(), ll wind up here again, butEen will be zero, sol nxentirelRdevot  we can't handle right now.Z+debself, )9"""! : [string]) -> \Wrap a sequence+@return a list!Es of'length '.q' or less. (If '__' is false,GAsomePs mayn0 er*qis.) C correspond t"tohg whitespace betweeNem: eachL5 isindivisible (modulo)+#ne5canFcorany twol`should have internalFr; ie. aC>either a`or a "d"W removed frombeginning>9endCinesDpart7(atdis preserved5"""BE= []6if ?V <= 0 raise ValueError("invalid%r (must7w> 0)" %Q)h1maxsK,No+:> 10ind=o2subM"t_z,;elsg) Binitial?rif len(01) +7placeholder.l" >SF too large for maxi"`Arrang ` order"Pitemsefficiently popped#Fpa stackafchucks;.b(Rwhile&s:U@# StuIPt@make%5curk|K@is je0!of_ in^ HFIine blen = 0Figure out which static string will prefix this line. !if)s:! indent = self.subsequent_ 0OelseB tinitial? @# Maximum width for! b- len(+) YFirst chunk on is whitespace -- drop it, unless| Hie very beginnbof the text (ie. nocs started yet)sSu_2and`s[-1].p() == '' 7del8 Swhile1l =;v ?# Can at least squeeze#YQ onto@curr4 Iif cur_len + l <=-*rappend(y.pop()).2\:= lr# Nope,NfullEZbreak\P# TheY,ntoo big toP# fitQ*any*E (not just>oneKXslA?) >a_handle_long_word,_# 2en,Ixt= sum(map(l.Kine)O2# I0lJ7all, "ifCd1ine Rw,Cen -H;u" /in1f (1maxhsyNone orts) + 1 <?7?fsZJG-1d*{%[0)0_%en)# Convert1^back to astore it in# list of _K (return valuX*.a + ''.join(1-D;J5if a Tlines;indent + ''.join(\/))E _break"EQen -=ine[-1]W2del!*^Oelse1if "VPprev_(" =/.rstrip(;@if (C)F5s5 = 1 + EJz g " e#.l23cbreturnp def _split_chunksg, text" =_munge_whitespace(e[!q# -- Public interface -Owrap1"""0 : &ng) -> [ ]FReformat the single paragraph in 'F' so it fits1 ofGno more than 'T' columns, and a list of 5pedHYa. Tabi~are expanded with.utabs(),Fkall other  characters (including newxU) areDconverted to .5""" ;! P;"ifEfix_sentence_ens1@_((oUR2N)Ofill0 0/. to+*1 no-*3new@pcontaindentireK1B"\n"q;:A) C ni% y\,]=70, **kwargsi"""Wrap a!of,= @. ingle paragr aph in 'text' so it fits-lines of no more than 'width' columns, and return a list7wrapped HQ. ByGdefault, tabh} are expanded with string..!()kGall other whitespace characters (including new ) cconverted t:. See TextW r class for available keyword args to customizeqbehaviour.1"""8w =b(F=`, **kwW)+M w.T() def fill!, 97=70<:="""Fill a single paragr0of M,a l AReformat theD0 to- ,(G,3new{ containwWentirX&edR. As$ )M.!ed!%  I  p 8 xshorten  Collapseptruncatqe given0fitz^.2The)first has $Tg`d. IfF@then9[*V *,!#iss is. Owise, as many psAas possi@join< ndn placeholder is P"::1>>>.Fp"Hello nDld!"]"128'#qworld!'O1OR[...]N'@max_7s=14+@' '."!.Kp().split())) # -- Loosely relafunctionality -6 _ _only_re = re.compile('^[ \t]+$'z.MULTILINE) _leaC >(?*)(?:[^ \t\n])K adedent)PRemovy common v<from every`,`is can be us@ make triple-quoAj2ngsD"upAleft@edge display,Ple st@pres ngm,@sour"odPin in edm!Noasboth treated as whitespace, but they are not equal: lines " hello" and "\\t!re:considered to havI common leadingx!. 6Entirely blanklbrmalizOPa new character.@1"""# Look foreongestx0str1of sDtabs#toG2all`margin = Nontext = _C_only_re.sub('', #)Ppindents08re.findall(37B in !s:N3if !is=9e# Current more deeply+ihan previous winner_@# no[nge (& is still on top)>yCelifc.startswith()_,Opassa stB!noe Ait's3new } ' bAFindd1lar+ between cRQ#*se0,, (x, y)/enumerate(zipd,~)qif x != yX E[:i] Rbreak# sanity check (testing/debugg3nly1f 0_!inM.split("\n"aassert1!or]O), \"7T= %r,Y P" % ()3 = r'(?m)^' +O*, RreturT de,1fixpdicate=z"""Adds 'prefix'jthe beginn]f selected s''r!If?]'provided,XwPe addoIQwhere3L/)RnTrue. jZnE1it lpdefault!ad+non-emptypthat doJ@ solP'ofm6s7 ifq l2pre(.c#p(':`fixed_#s(7';+/QyieldsQfix + Q else^''.join(prefixed_lin6es()) if __name__ == "__main__": #print dedent("\tfoo\n\tbar") " \thello there\n how are you?"9Z(ZH4.5PThis nzHed.")) 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 zbegubfr!""" d = {} for c in (65, 97)irange(26 d[chr(i+c)] = (i+13) % 26 + c) "".join([d.get(c, c) [r%s])) """Thread module emulating a subset of Java's t+amodel.import os as _os "sy%sy_A"functools from time >monotonicV$_weakref+rWeakSet AiterTIaisliceF q, count C tryw_collectionsEBdequD except IWErrorA@ # Note regardQPEP 8 compliant ,Qs # 8(y was originally inspired by, and inherited #&p convencamelCase 1ion5bmethod hat # language. Those+v0notany imminer of # bedeprecated (evenpPy3k),s$ispprovidex eman # alias5Othe 8_pthat usv,?new0 facilitates@titu)q # with?multiprocesRm1, which doesn't provide the old- # Java inspired names. __all__ = ['get_ident', 'active_couConditioncurrent_thread', 'enumerate*Emain' 'TIMEOUT_MAX6#Evy@Lock:R SemaphorPyBoundedTpBarrierJcBrokenAErro2Tim? setprofil{qsettrac Plocal\stack_sizeexcepthooEHookArgs'] # Re some stuff so "from Xing import *" is safe _start_newX3 = . ocate_lock* al _set_sentinel&  "Q try:>!na>+id+*_HAVE_THREAD_NATIVE_ID = True"__.append(D2') f Attribute]gFalse e!_C!w 3WNone FD del 1SupCfor ~Q and | QCs __1 = l_# V def b(func) """Set ae z3all!s V3ed emodule. @The E will be passed to sys.)dCeachL, before itsLrun() methodccalledi1"""%yglobal  ! = & -Li(  U6  # Synchroniza cl0s n 4(*args, **kw FvFactory8that returns a new reentrant AP must8Prelea:Tby thp XAacquit. Once a3U has #aa,N5samS4may/ it againOwithout bAing;;e7o6 imK#it4if b!isM@O _Py[%t s) class _R,Lock: """This class implements reentrant lock objects. 6A(must be released by the thread that acquired it. Once aM$6has#aa,N5samS4may/1 itIagain without bAing;;eP it ofor each timeM #it2"""def __init__(self)PT!._ = _allocate_!()'owner = Nonecount = 0sNreprsF{M6tryyactive[V].namexcept KeyErrorAEpass_return "<%s %s.%s, WA=%r =%d at %s>" % (?"red" if =.() else "un)",>2___.__module__' @qual )< bhex(id)at_fork_re-*N_+P&*nq, a=True,gout=-1B"""A! a7 or non-3ingWhen invoked|AarguG:ta alysTAincrrecursion levelUone, and wimmediately. OtherwiseQPf ano7ownza untiltD is mq #P (not an)an grab rship, se@Q ;to . If mor anioaitinga, onlyGv will b{able to5 of(p. There/$novalue in 8Ocase6 T@*t!do&5ing^@as w@callGs3M'false, do  $n b wouldq,.O ;n( Kreturn true.  :When invoked with the floating-point timeout argument set to a positive N value, block for at mostWnumber of seconds specified bygLand as longWcannot be acquired. Return true ifo-5hasQEbeen4e, fals-has elapsed. :5""" me = get_ident()ilf._owner == me:! secount += 1rRrc = 3P.(Ding,3 /rcu9 meu_"rc__enter__ =Adef release(L)|B"""R0 a p, decreB1ingrecursion levelrIf after'8 it is zero, re!he^ unh@ed (!dby any thread), ^!if1othiRs are ai&th;gqtbecome x, allow exactly one@them.Pproce still non&fremain!ed\rhe callylAOnly this method we 8Q ownsh5. A0RunFPErrorbraisedW!isk]aI& iOPThereU3no k# ! #("bC un-{dk"p$._@-0if ' 2vr = Nonl.&()__exit__, t, v, tbA :0# I3nal0s u0by  itvariablesn r_restor|, states_2-9,IoB_savleTt0Y+VE = 04 //(,(er!isvd 8]owner == get_ident() _PyRLock = _ class Condition: """Cthat implements a c* variable. 4A# allows one or more threads to wait until they areKnotified by another7l If1 l@argu is given and not None, it must be a 2or qobject,5 itEqused asbunderlyingm0. Owise, a newJ Fis creatE?nd N 92""" def __init__(self,u=)!if=!()N#._# Export's acquire()`releasumethods<V-! =. $C$$7# Idefines _'@_sav~and/or _b`_resto,Ithese overridme defaulas (which jGcallFzqU() on'). Ditto fis_owned().H:try0  Aexcept AttributeErrorS6pasq1t w=pi&@60ersPdeque?at_fork_reHF;A+._* ,fi.clearcr_enter_]xreturn d+)'ex_*argsF 1+J?rep%"<(%s, %d)>" %  S, len)F.' ()# No state z?, x^- ^0IgnNYdh`jYV2# RWTrue Iocurrent_r# This {2ped onlyI\doesn't have _(if!WFalseD`:!p<else: return True def wait(self, timeout=None):"& """Wait until notified ora9 occurs.]; If the calling thread hasG acquired$ lock when this method isEped, a RmeError is raisedwTBreleasesepunderlypA, an~0n bs(ityawakened by aPify() qy_all()A forisame conditionvariable in anothe/,Pl@ op8,al[U OnceOv imut, it re-^ reWtekpargumenP pres (@not ashould be aPfloat\point number specift*(Popera se2(or frac Wreof) an RLockiq @d us&itl#()zs, since ay actually unQ %it 6wasrmultipla@s re%ively. Instean internal 'faoH` class uswhich resBevenQ itsHbeenSseveruCs. At@ to restor7econ level3e5"""!ifw._is_owned(d P("cand on un d %")c#Per = `ocate_"(".As.append(>saved_state = 3l_Pgotit = Fals@try:#\Mno matter what (e.g., KeyboardILFruptE%if!is HNelsePt>> 0 >S |b 6pPZ Hr 10finN _( YY Iofs.removeU-except Valui pass def wait_for(self, predicate, timeout=None): """Wait until a condition evaluates to True. 6X should be< allable which result will interpreted as aMboolean pTe. A@ may: provided giving the maximum+5 toM5"""0end0 = 25out=H%()while notT[iR1 is'v %)!is$(%0= _UA() + )OelseGR-R GKO<= 0W*YbreakD.r(?2` creturn]{cnotify:"@all_(bers = lC_to_T= _deque(_islice(GF, n)` C wq\21 in&6ers <).release,:try.q.remove+&er'except Valu>JLpass&A_all*%5all -U}?allA(len.6")) PAll =0ify  class Semaphor"1"""wimplements s( objects @qs manag ou representL`number bs minu% ("()(, plus an initial(The acquire() met= 0")[s ._cond = Condition(Lock()'=Rsacquireing=True, timeout=NoneB"""A7& a?, decrementinternal s by oneWhen invoked@arguG s:, Iis larger thanzero on entrya|D andhimmediatelyL`it is DQLQ, waisome othread has calleflease() toQ@maker`. ThisAdone  proper ;W sotPif multiple )Rs aretded, re`will waexactlQ of@m upae impla] may pick at random, Qe ordOTwhich0 th%aned shoulds beaied on ren@r#@in t6?casU ? ettdL!e  th@as w,GM ~false, doa&ou4an y! w+ O ;#wif5thewlsa.} n 9,tf for aEmost; se0s. Q does* co`te suc@vfully iBthat/0valO B. R;!&&ot6t can't specifyAnon-wc`rc = F(0end! =z-  Swhile3,== E!Ubreakx%ifi:  if endtime is None:  )0= _1P() + ?out4?elsN:% =-XN$ifq_ <= 0-]breakKself._cond.wait());value -= 13rrc = Truereturn rc __enter__ = acquiredef release(gf, n=1)B"""R a semaphore, incrementing the i`pnal cou  by one or more.oAWhen3*is zero on entry and another thread$6nVfor ito become larg2"anQagain, wake up thatP1"""#if n < 1praise VError('n must be'Pwith O OE+= n~l in range(n@Inotify()]__exit__t, v, tbG?) class BoundedS( <q"""ImplRs a b1TA checks to msure its current doesn't exceed!rinitial%. If it ,,!d. In most situationsHs are usedguard resources limited capacity!IfJvL!ny*Ps it''psign of1!ug"nobgiven, default$1nLike regularg.s,as manage abrepres`number calls minus$)"()$, plus a 4TheY() method bloVecessary untilQcan rw0out! negative> :Vl >.__+:"Aial_H" =Y-,M!Dreleases exceeds the number of acquires, raise a ValueError. 5""" if n < 1:B?= ('n must be one or more')6with self._condO#ifvc + n >initial_ 6"Semaphore released too many times"B_U += nfor i in range(n)@.notify() class Event3A"""Cimplementing e! objects5s agflag that canaset to true Wset() method and resetwto fals-Uclear/. The waiBblocks untilM"isQQrue. 6 "lykI2# After Tim Peters')(out is_posted())`def __`0__(mP = Condition(Lock@'0= F [at_fork_red b# Private[called by Thread._i_internal_9(d} _l0is_-"""Return!ifqonly ifw !is).xrAZ ._&pisSet =q(k,f om Al.sQDabecome are awakened4H!llFq() once will not w at allbTlu = True6@_all5PE =he 9Subsequently, t\ s nD))z8Wagain*# L,jout=NoneB!Y I on entry, immediately. Otherwise=0ano!ml"s R to q,zg opw$ald occur%AWhenN@argupB!nt4, it shouldapAfloa;Tpointspecifying a timeout for the operation in seconds (or frac s/ureof). !This method return' internal flag on exit, so it will always5Prue except if a timis given and#Ws out5"""Twith self._:signaled =# "tif not ) ?Cf`.wait(Iout)Q(Q # A barrier class. Inspiredqpart bypthread_0`_* api! # xCyclicBN from Java. See # http://sourceware.org/\s-win32/manualrinit.htmlvLj` sun.com/j2se/1.5.0/docs/api/!/util/concurrent/ #C `! #ainform. # We maintain two  states, 'filling'q 'drain@enab$<2ao be c4A. T\Qs areQallowtPuntilhas fully ced # since`previousYeP addiG, a 'resettsts which isNmilar toRthat s leave a BrokenError, # Aa 'b'.Yp5allM geYQion.  S"""Implements aaUsefulsynchronizing a fixed number ofwat known 19PpointPblockV'f)simultaneously aw# oyOh/0madsat call:'`def __0__(? , igd=None,) """Create a , OqialisedR' @'e0' ibBable#, when supplied,S alby one ofN1Aafte%y e$he6just pri.oN`releasPthem > I'`provid itua!Jbdefaulsubsequent sb = Conev(Lock()x'R2 = $ = $ = s= 0 #0 B, 1,#ing, -1 R, -2  Icount = 0ho 2WaiI7 When the 2specified number of threads have started waiting, they are all 'simultaneously awoken. If an 'action' was provided forL barrier, one N eBwillPexecuthat callback priOo returning.LRsindividual indexfrom 0 to 'parties-1'. C5""" if timeout is None:= self._$CwithJcond=3enter() # Block whil e-v drainsywUcountu \Y += 1:try2#if'T+ 1 =Z"/3# We releas m).-()$;els]6g until someonzMs usN8r9(vr0 Eofinall(VZ-Zw# Wake up anyS  Debexit()&th0is y[us, or raisePexcep # !brRdef _y)._state in (-1, 1&1# IX1ingBesetId;_ .'@#see Rin a tK#ifn6< 0kBBQError!iassertED== 0OLA run9and Z1ingc#@\ i A"._L!# R'> notify_allcm B#an pion durw handler. Break Gb$s,-|+itex!weh_d. R&b"rw(,+Tif noO9/_for(lambda :lO!= 0H#Ud out,'!._,()  raise BrokenBarrierError if self._state < 0:#AiassertEQ== 1 F# If we are the last thread to exi2e b, signal any'sHwaiting forJ2Fadrain.(Pdef _V()count ==!in (-1, 1Da#reset1or ~1ingW?= 0 cond.notify_all()9g @"""R ^initial .IAN currently Rrwill ge * exceptiond\5"""Cwith ~a> $%P, wak!)up:. %-1%%el*-2,a#was b]`, set !o  _;#which clears when1 Nelse 3 _abortBPlacb into a ''+Useful in case of e0. (]s andaattemp@to 'A()' ?hav "%Xbreak_'@# An  er (detected. Th1 is:%to+3# aUC all parties awakenedh%-2H@property/obRRetur`numberqrequire0tri~.rFm n_?ingFa # We don't need synchroniza here sin isan ephemeral1ultA#way. It scorrect valuebsteady} GLreturn 0 @property def broken(self):"""Return True if the barrier is in a< state."""?r<U!._ == -2 # exception raised by]B]aclass ! BError(Runtime p1[ Helper to generate new thread names _counter = ().__next__() # Consume 0 so first non-mainShas id 1. K@_newe(template="T{C-%d""# %@er()dActive`administra11 _a_limbo_lockallocate$()&P = {}d# mapsS id  object Q1 _dangling = WeakSet() # Set of 91._ts sTdaemo!3s u_shutdownMto wait l all Pyth7Rs get deleted: # see8setE(). cs "Qs = s@ # M{3for3#s %R"""A *that represents a8control. CThis5can be safely subL"edYlimited fashion. There are tw<!ysQto specifC@ity:Ta callableconstructor, orQby overrid;&run() metho<_initialized = False!__j, group=None, target A Uargs=(), kw ?2*, u7h42"""r should alwaysed with keyword argum4. A }:\**P0be ;  rvor future extens0whe8IGZ@mple~#edbp%*" be invokSb. Defaults`, mean@noth:allS@. ByJT, a uniquenfUed ofTform #AN" wN6@a smdecimal numberr tuple "e 4cB 5*TSPa dicr0ary  bEj'{}EIf aoe%e .it must make sJ!to%kerHDbaseW(g.__init__()) before doing anything else to the thread. 5""" assert group is None, "argument must be for nowDif kwargsA:_E= {}self._target = name = str( por _new ;())- =   if daemon1not &Cic =1Cf2 current_2().NCc idf= if _HAVE_THREAD_NATIVE_IDsnative_id Fatstate_lock!`starte>lEvent(`is_stopp#UFalsebinitializ"6Tru!# Copy of sys.stderr used by >voke_excepthook76= _E E = _make_in_# For debuggLd _after_for_dangling.add()Udef _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: _shutdown() has been cFG), _ Nq. Do no3 ivis case ~#ifQ-2A/E04wacquireqi5# Tq isn't c,: it doerhave a kanymor  \aq_repr__ we;B, "T __u__() wasx`us = "+6ial7et(2tatB(B() # easy way ._U2setappropriat1 8<9nic:  status += " daemon"  if self._ident is not None:$(DX%s" %7*return "<%s(%s, %s)>,(d_class__.__name__,F", d!) O0def!rt<)"""Start the thread's activity.>It must be called at most once per? object. It arranges foeN$'s run() method to_invoked in a separat of controlDThisD will raise a RuntimeError if0morQ"an on0sam )""initialized^"("i0.__6A__()(X"<Psed.is_set('c1s c lyZFgawith _e_limbo_lock[1] =k3;try-kR_new_x._bootstrap, ())@except E:ionMHdel `%!._ed.wait(x+"hB"""Mrepresenting97You may overridY!ubP. TheYndardsv.Cablea passeDaconstructor a:NPtargepgument,"Qany, q@sequal and keyword ar.us takenMAfromBargs2w 1p, respe[(el[T J "._"(*y3, *knkfinall# Avoid a refcycleK@runna function+E# an% that has a memb%at pointsa.G^n`# WrapaaroundUreal 1 coat ignores"# ions durinterpreter cleanup. Those typiyBhPn whe89 wakes upRan unfortunat0B# moAfindP worlit destroyed,Xs somGfrandom *** while trysto repoexception in  *# _bootstrap_inner() below ***. Those random exceptions @- # don't help anybody, and they confuse users, so we suppresEthem. W@ m only when it appears thatg worldindeed has already been destroyed?7 inCduring normal business hours are properlyGreported. Also,m for daemonic th's;Gif a non-%encounteiS@methelse is wrong.FEtry: ^self.$ 42if 7@_sysrJNone0hVretur\Qaise jdef _set_ident(^)D.E = g')= if _HAVE_THREAD_NATIVE_IDB`native_iddh#l(pMtstate_lockO1"""W`Set a & object which will be released by  iapreterIpthe und^# (see py 0.h)&s deleted" =sentinel()z ,.acquirebif not with _shutdown7s '+ &2.ad'._ Br>.o$v'OL"!ta';setm;!ac_limbo9$[QN1] =uQdel _M/]Ntrace_hookays.set$!(_+ KGoprofilI &#(_ M ;run4/_invoke_%nkfinall-}#%Acall"._m ca"5lso;# grabs _,,[<)]  except:  Qpass def _stop(self)/# After calling .&), .is_alive() returns False and .joine}&# immediately. ._tstate_lock must be released before~.P  Normal 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 bWed 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 _shutdowfunctiony0 =  1if $!is3).Eed()B\V= Tru =A!if{(jdaemonFwith_s '  s.discard() ldelete""Remove currennP from]P dict ply runnLi%."active_limbo Rdel _$[get_ident()]Fr# ThereRby pythonqbetweenppreviounJa.pOtherwiP tracV could try to acquirrePPagainki0samN7, (P#()wa.,, timeout="""Wait until terminatesPBThiss,4 Eawhose ) method ?'edk` -- eiW! nPly orough an unhandled ion or until the optional timeout occurs. AWhen+"argument is pres and not None, it should be aJfloating point number specifya1fortPopera in secondsP(or frac s/reof). As join() always returnsyou must callMis_alive6DfterCto decide whether happened -- ifO`thread#astill \,#Y~_d outqeu#or*'wiblock unterminate#A 0canEqed many. raises a RepmeErroran attemp)qmade to|current1aAat w?cause a dead1. INalso an emW O`beforehas been started sTdo soREsamePAexce+5""" !ifself._initialized:"O- *1("T*!._6A__()IEed")? a.is_set()f0can;$is q_o>w&")[4wi ._wait_for_tstate_ (Jelse7#abehavior of a negativeisn't docfed, bu# histori0y .<(@=x) @x<0 Z!acSs#0N14max`C, 0))Odef S!, d=True,7=-1# Issue #18808: Ptbe gone.A# AtP0endK5's life, a0all knowledge*Mimoved from C data structures, C code relea[Hour This method pas/Dits  <acquire()FI Y$dAis d8z._stop() i#Ted. That sets ._`toppediG.?"= mO%if:p: # alyBy detthe C code is dWone assert self._is_stopped$elif lock.acquire(b, timeout):+V.release()c`1() @propertydef name()W#"""A string used for identification purposes only.^,It has no semantics. Multiple threads may be given the sameF. Th0qinitial is set by2constructor1""" iJized, "T0.__a__() not calledAcreturn)@ q.setterm H,N. ._u =( er of this or None if it been startedhT9 is a nonzero integer. Sebe get_`) func77!Uifierrecycled when aexits and another%isNpcreatedfevailable et1aftBc NGO if _HAVE_THREAD_NATIVE_ID 8s|tive_id!P"""Na 4ral0+ID,^ G-negk nNrepresent#e ID as repogkernelFx.E Q2_idis_alivCR>3whel5Qrmethod ts True jus0for?e run() *qs until*W 1terminates$emodule enumeratJ`a list<Aall Ss.#if}'0ed. 7et(vFFalsS9wait_for_tstate_F()C5fi daemon(self): 0 """A boolean value indicating whether this thread is a daemonC. T)must be sefore start()=called, oZwise RuntimeError isMraised. Its initialherited from the cre;MCmainTKas _>`collec|s@>Sdtuplt Y"(J''?'exc_type]_&') MW(args !(*'EA7, /DHandle uncaught uPrun() ep!.<0if w.== SystemExit # silently ignX*])4sysANone_sys.stdery v '= .n$elcG."._]OL#@# doh:if 4@was   # when the thread was created ereturnUelse:,# do nothing if sys.stderr is None and args.p Gh,if31notO hname =,.H = get_ident()-print(f"Exception i)%{8E}:",.r file=, flush=TrueU_V$_eT( exc_type,Hvalutracebacksy~r.() def _make_invokebhook()P1# C a local space to ensur0 at variables remain alive[f called, even+&it late duringLPython shutdown. I0mostly needed for daemo1s. @7old2 =  :sys$_ );if L9raise RuntimeError("Fing.P"Z ^ XR_info = !1 = 3sys6K?9?lglobalh6try-1if ! =e2 = HookArgs([*3(),*])>aQQ as exc.__suppress_context__ = dM!de, y"ifD! `$=Q   <"._M =(3 :i D   _C , H.g0ept 8 (rkfinall: # Break reference cycle (`storedaable)  args = None Jreturn invoke_excepthook # The timer class was contributed by Itamar Shtull-Trauring c1T=(Thread):q("""Call a function after a specified number of seconds:Bt = \30.0, f, =E, kw )t3t.start(cancel()$ # stop tB's aif it's still wait62""" def __init__(self, interval,#Q4.KY.X% =c!a=z !'! =;3 ifQs not" else []5^# =g9i;*{};finished = Even!5*I"""Soit hasn't Q@yet.4G.9.sek1runh 0"d{!if  11is_d!(*3s2, * 8\" @ # SAal tIto representCmain# R_MainKs ]1 |, name="Q", daemon=False_tstate_lockt_#ed/Ret_id! if _HAVE_THREAD_NATIVE_ID'Anative_id{`with _ve_limbo C [K@] = SDummyi b here.R`se aregarbage collecQ0wheey die, nor ca!bes`ed forL Ify anything Ping.pat calls current_I1(),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@_new!("[U-%d")RTrue)V with _active_limbo_lock:  [self._ident] =  )def _stop()>Fpass#is_alive&assert notTA._isNsped andstarted.Aet()zreturn TruelAjoinh, timeout=NonevFalse, "can8 a dummy thread" # Global API functions current_.(cB"""RCthe $! TR object, corresponding to ,saller's of control./If( A wasOpcreatedJAough71ingA{module, with limiEality is y#ed1"""S6try$ C2getA1()]-except KeyError9D7C() I$ =Y}_count`numberZIsO1ly 5The WTequal`lengthRFlist2"bynumerate()X2g#rJClen('A) + 2) C2 = _&_ef# Same as Q, but1out0. Internal use only.4ist.values()u2!a Ajof all4 5includes daemonicYeads,$s #`P1(),CmainLs. It exidterminhk4lqat haveyet been \] u ing_atexits = [] _SHUTTING_DOWN = _register3(, *arg, **kwargsCPython i/$: @ *:*0@be cd before usv~$ed@$is=6arguments jus[U1allBnon- 3s ated in `_shutdown()`PproviDa similarJppurpose`A.2()`: iprior toJ{ insteadB=tpreter 4For2to ,&edin reverse. """  if _SHUTTING_DOWN: raise RuntimeError("can't register atexit af shutdown") D call = functools.partial(, *arg, **kwargs)3_threading_[s.append(M) from ' import stack_size # Create the main S object, # and make vailable for4 interpreter # (Py_Main) asJTing._@. _f!= /T() def ."()^1"""PWait `l{UPytho st0of Gnon-daems get deleted.NV# Obscure: otheV s may be waiting to join . That'sS# dubious, but some code does it. We VFC#to releaseK A's t_lock - that woah # is nearly dead. So weshere. Noat just Ib_stop(wNwoenough7 alC ?Gon _PA._isj2pedT was _!ed1)breturnOkglobal* d = Truu,tm=&;# T? is!finished yet, so it1te _4havDbeenrassert bot Non2.S#ed0.Y nz@0# C>#ed aions befor9Qs are_p# Orderyreversed, similarKPM_ i4(+5J'eaQwhilecFwithycs#p\s = list()& d.clear!aif notseRbreak)x .# mimick E.>6.acquire 3S# news spawned Afwe werDIQs@comp R!.In normal condit,3im Pwhich)B.^Fstar'"" return _main_thread # get -local implementation, either from the- # module, o python fallback try: @xdRort _r1as  except ImportError<3ing7i'; def _after_fork()<1"""sCleanup3ingP statat should not exist O0 a Q.GO# Reset _active_limbok, in case we9ped whildek was heldR# by anofP(non-n3ed). http://bugs.b.org/issue874900Joglobal ,shutdowns:, _]` = _al!te91() +#() only copied;dcurrenp; clear references to sm3newwR = {}^RR[get_ident()]U7KeyR<`calledax!chbspawne>#by*Qing.TQ. For exaD%, K=p.start_"()eBMaineg3 = ,%2# r!(){#s:s re-registerQir _t a belowA q  ,d = setOwith>p# Dangl a instamust still havM"ir,G because someone may join(U&emags_enumerate())O$@.upd#_d" foCRA01Any`/condi\ variabl$bel) ed[Uin anKrinvalid@, sokreinitializ6#if4 isi &p# There$=>B. Wep5 j9 toI its new value since it canvchanged7@!.__internalwfs(Truey/= W, &[!3] = +Oelse>1Allp are aly stoppOFalsU_ .Y(( _active.clear() _active.update(new#assert len( == 1 if hasattr(_os, "register_at_fork"):kL_os.0(af*in_child=_7v) #! /usr/bin/env python3 """Tool for measuring execution time of small code snippets. This module avoids a number of common traps b bs. See also Tim Peters' introduc o the Algorithms chapter in P& Cookbook, published by O'Reilly. Library usage: seeZTimer clasCommand line*}<it.py [-n N] [-r0s Sph-] [statement] Opsb-n/--n2N: how many^Cs to5e 'A' (defaultPbelow`-r/--repeat L+vrI! 5@s/--setup S: p$bed once initiallyD'pass').%ENRthis jgais NOTdE-p/--process: use._&()#is erf_counter()v/--verbose: print raw/results; ore digits precision -u/--uni{t5`outputM e p (nsec,Ac, m aor sech/--help @ mes u@exitp-parate o7V fromjV when rts with - ~HdG A multi-may be givenVpspecifyIBeach.sas a se@argu; indented&s are possibleL`enclosK4an 6 in quotesu @lead(Pspace>Meple -s(are treaqqsimilarIf -n is not, a suitaof loops)acalculIPby trq increa3s_Pseque(1, 2, 5, 10, 20, 50, ... untilAb total@@is apast 0.250ondPNote:/ rea certain baseoverhead associPng a   . It differs between verVAThe  he`oesn't to hide it, but you should awof it. Frcan be uPinvokCqprogramDout CAes: lQ Fun(Pit(st", ) -> floa^ $2lis#lpr() -> float """ import gc 4sys Dtime itertools __all__ = ["Timer", ", it Qrepea default_ r"] dummy_src_name = "<it-src>" 1number = 10\E = 5A+ .perf_counter _globals =  # Don't change the indentation oftemplate;"re#() calls # in .__init__() depend on setup being^ed 4 spaces and stmt ##8#$. $" inner(_it, R{z}): {t} S_t0 =%!()`for _i2_it264tmt515return _t1 - _t0 """ y Csrc,"""Helper to( a multi-line statement.Qjsrc.replace("\nN\n" + " "*) classA"""C0timwQexecuPspeedsmall code snippets. The constructor tak0be dd, an addi^!alA` used ,1d a9`r func5v. Both_sElb'pass'~u<@ is Rform-rent (seeE module doc string). If ''Aspecified,bwill bE=ed within that  (as oppoto insid2it'-)co measurtbrVfirst,N)it() method. avenienceN C"pl`a listYresul#Ps mayftain news, as longbthey dk on(  lZAals.  Edef \Qself,4 =""",c#r=A,G]S=None?r. See eG2.t" =mplocal_nt{Y1zT() ifT elseUV = ''f isinstance(l7strxr# CheckbPcan b@mpil!utahE!co(f 0, ""g/prefix =f + '\n&'=&b4MAelifu3abl q1['_$']s C+= ', _setup=_setuGp' stmtprefix = '@etup _s &()Yelse:Iraise ValueError("5 is neither a string nor callable")Gif isinstance(,2)i # Check that the code can b mpiled outside a functiong!co(e"+ rdummy_src_name, "exec?* = reindentG6, 8Eelif local_ns['_MA'] = init += ', &=G?tmtsrc = template.forma=!, = , =Rself.F # Save for traceback display %= Orc,  (9a, globl$, v uinner =!["1"] def print_exc(, file=None"""Helper to1' aAfromQtimed.aTypical uYwt = Timer(...)E #try/except:*ry<= t.%itN # ~b.repea EXH)he advantage ov0he Gdard"issource linesz!in+dtP will%(edDPhe op!al argument directs where[piwsent; it defaultssys.stderr.5""" aimportfcache,$ f 90ot > WB.[#A(lenI%),_s5.split("\n"z  # Kis already stored some,k., number=_ m" ' ' JuTAs of@main te[o`precis3his?ee; once, andthen return30takEoQEaimes, as a float measured in seconds. The argument is the number of timeQroughloop, defaultingEto one millionb0 mau@tate`,Btsetup sF andE!hetr function to be used are pas !toLconstructor.E5""" it = itertools.repeat(None,),gcold = gc.isenabled(@.disEtry:AOtiming = self.inner(it,OrRkfinallA1if W[2gc.`return4Cdef , =_)wp"""Call\eit() a few1s. k@This9a conveniencehat callGM?@edly?`a listcresultt first Especifies how many=|w%5;D` XKE &Note: it's temp:calculaten ndard devia^Afrom0 ve6`reportse. Howeverq5notG@veryQful. In a typical case5e lowest value gives aBr bound forv fast your machine can runBVn codvsnippet; higherksm $re8ly !caby variabilityEPython'sed, but by otherprocessew`terfer~Bwithaccuracy. Sy7min*3he is probably onTyou should b interest. After that,2alook af entirB apply commo`nse raQn`tistics2er = []"iPbrange(&dk."3it(KD$r.append(trr'BautoiP,9Pback=vB"""R=,p.s taken s72otaw >= 0.2 method pincreask%s @sequ1, 2, 5, 10, 20, 50, ... until is le=50.2F2. #s U,_)@If *-* is given and is not None, it will be called after each trial with two arguments: ``6 back(number, time_taken)``.I5""" Ui = 1while True:~for j in 1, 2, 5"s = i * j= = self.#it)1!ifmR Np  >= 0.2Wsreturn C Vi *= 10 defhit(stmt="pass", setup~r=default_,P?!, globals=!)#"""Convenience function to create Timer object andI method.3r)_repea*B", 1j'@()main(arg, *, _wrap Main program, used when run as a script. /`The op@al 'd' specifies the comm@linebe parsedy0ingsys.argv[1:]kPvaluean exit codTs0to Da(); it0mayfPindicssuccessjW[!ce happens duriming, a traceprinted tomastderr c1. Exbs at othersAq(includrhe templpcompilavQ) areTcaugh''0an Brnal BfaceLunit testing. If1 @mustBaable that acLFs anr'! (i )$ if\s|x5yimport getop6try7Ropts,S=%.,., "n:u:s:r:tcpvh"q"["S=", "u2, "=D "FAPclock 0pro@pverbose:bhelp"]ey getopt.error as err: print(err)"use -h/--help for command line "5return 2 Gtimer = default_stmt = "\n".join(args) or "pass"%Anumb@0 # auto-determine setup = []PrepeaVoverbose = 0@_uni/#NoPs = {"nsec": 1e-9, U6, "mC3, " 1.0}Xprecision = 32o, a in optst@if o("-n", "--&")$0 = al@s@ ?.append(?u? >"ifHaJelseh"Unrecognized [. Please select , usec, q,isec.",fTfile=sys.std >r/ ~DN<= 05= 1wpw|processxZ<.$AKvK K3if +4 hu Z__doc__, end=' '_ .# Include the current directory, so that local imports work ( CpathJcontainsKC of this script, ratherVn*uE8q1 osq.insert(0, os.curdiiif _wrapr is not Q )()f@ = Tj(V!, :#, #k4if E %# Q!@0.2 <= totalKR < 2.Scallback =lDdef 4(k_takenJ0msg {num} loop{s} -> {secs:.{@}g} 06plural = mR != 1#msg.format.=s='s' if M? ''N= , =)6tryA~`_ = t.drange(>;jexcept>!t.V_exc(*Xreturn 1  if verbose: print() 6tryraw_timings = t.repeat(, number)8fexcept;!t.WR_exc("oreturn 1ldef formatfVe(dt)A@unitu@ime_ 3E0if  is not Nonqscale =& s[,]=,el.![( ,8) !, 1 ins.items()TX$Ps.sor verse=True&2forNeT9'if dt >=0 $Vbreak^"%.*g %s" % (precision,O/N~("raw times:O", ".join(map(', ,&))JKS[dt /@i dt D]0besCmin(>KW"%d loop%s, *Pof %dA per" P, 's'` != 1 G '',14 (k* = = 2wor*ax2if ">=6* 4import warnwc. _explicit("The t%results are likely unreliable. P J (%s) was more than fourObslower92theZ.(% `( ),-0{+)) b UserWP," 0D/@ 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/1I2 CIRCUMFLEXEQUAL = 43 LEFTSHIFTEQUk4 RIGH5 DOUBLESTAR*6@LASHO7'@8 AT59 Af50 RARROW = 51 ELLIPSISt2 COLON?P53 OP`4 AWAIJ55 ASYNC6 TYPE_IGNORE7aCOMMEN.8 # These aren't used by the C tokenizer but# needed for.py ERRORTOKENh&9 c@60 NP61 ENCODING = 62 N_0 63 # Special definitionsgpcoopera with parser NT_OFFSE 256 tok_name = {value: ' !, " in globals().items()1if isinstance(5, int) and notdp.starts('_')} __all__.extend(.Bs()) EXACT_ {}'!=': NO,%': PERCENT&&': AMPER(&t(': LPA%V)': R@*': C*Z_*B+3LUS@+$HPLUS$@,': ?A%u-': MIN5-5"MI$>5d.': DO* ..J#/ q/S.:3LONZ:&;3EMI<$ES<$% *+x>/2@@W<[3SQB]^FIRCUMFLEX$^FCn{NSBRACE,e|': VB|;5}t5~': TILDE, } def ISTERMINAL(x):return x < -?NON0.>=1>EOFY== ENDMARKER """TAhelpPython programs.(readline) is a genEhat breakstream of bytes#o Ws. It decodes*according to PEP-0263 determinsource file enco1. It accept-like method whichcalled repeatedlyp0get` next input (or b""R EOF)es 5-tuplesMt members: the token type (se.py) "(a stringstarting (row, column) indices of?p2-tupleFintsHOendiF/original lin It is designed to match@work{bPythonizer exactly, except that it produrCOMMENT3 s for comments and gives^!OP all operators. Additionalh2allLq lists c with an ENCODING#@ whiells you AencoPbwas usadecode@byteYream. """ __author__ = 'Ka-PYee ' __credits+('GvR, ESR, Tim Peters, Thomas WouFred Drake, 'X\ 'Skip Montanaro, Raymond Het^er, Trent NelsonCMichael Foord') from builtins import open as __+c)lookup, BOM_UTF8 A`collecs7$io\TextIOWrapper0itertoolsv$re #syQo*e *EXACT_TOKEN_TYPES cookie_re = re.compile(r'^[ \t\f]*#.*?@[:=]]*([-\w.]+)',6ASCII) blankKbL(?:[#\r\n]|$<S!ll%A.__aA+ ["ize", "gen !e_stdetect_,",291"un:OTInfo"] deL class (a.named%('"A', '1end^A')):def __repr__(selfannotated_I= '%d (%s)' %k0lf.,_[A]Fwreturn (6C=%s,0=%r 1art 1end0=%rnMiBlaceP 1)) 50@pr!tye 1if Xa == OPF=in I &G]2Oelse@u group(*cho3): g'(' + '|'.join( !)':?any8 P0*0_maybe2?' # Note: we@ uniPs ("\w") but ascii$ # number lfals. Whitespac'[ \f\t]*' Comment = r#'#[^\r\n]*' Ignore = Whitespace + any(r'\\\r?\n' +) + maybe(Comment) NamB#r'\w+' Hexnumber = r'0[xX](?:_?[0-9a-fA-F])+' Bin'$bB'1 9Oct $oO !-7!7Dec!A(?:0g0)*|[1-9.9])*)' InPegroup(%, %, x%, b) Exponent[eE][-+] h' Pointfloa+h r' (]\.(?:n)?', Mr'\.-'|v, FAQ, ExpKk) Imag)]x[jJ]', WA+ r'4) NiS 2%, ) # Return the empty string, plus all ofSvalid prefixes. def _all_8_1():ho# The = Only contailower case versions# and don't2any permutat+ (include 'fr', but nots 'rf').Zrious>will be generated.:_ = ['b', 'j 'u fbAfr']># if we add binary f-, s,Q: ['fI$fb5PresulA{''}G3foruO in q.t)itertools.)(2 # create a list with upper|Aeach># characteruroduct(*[(c, c.j@()) -c-+t]d.add(''.join(u))nr" compile(exprN'., re.UNICODENote that since qs# AQ # SLP-@ can^ j (making it opYal). ;"= *jTail end'q. Singl;"[^'\\]*(?:\\. x)*'" # <"<BDoub<H'[^"< K)*"'<,''z3{~|'(?!''))'"MM`"(?!""M""' Trip; P+ "'''",+ '"""') # 7-line ' or I Prefix + r"'[^\n'\\]*(?:\\.[^\nz)*'", StringPrefix + r'"0"?:)*"') # Sorting in reverse order puts the long operators before their prk es. # Otherwise if = came-`==, == would get recognized as two instances # of =. Special = group(*map(re.escape, sorted(EXACT_TOKEN_TYPES, =True))) FunnyHr'\r?\n', b) PlainToken'Number, =", [, Name) +0Ign &+ A # First (or only) line' or " s. ContStrsd "' <" + ("'", r'\\)&h' 'h9'"'h) PseudoExtras|\Z', Comment, Triple5QWhitespace +V+, C|or a giveni  plus quotes, endpats maps it to a regex # Qmatch`remainsof thatX3. _Zcan be empty, forDa normal singlW! tdF (with no4). = {} forhin _all_A~Qes(): 8[ + "'"] = S$0'"'$oDouble$8"''J3'8'""M3 PA set0allS?andW0es,H`includ;@open ". K_0d =m2() i KtE %u%Q(t +  3"'"fs vq.add(u) >"%@'B B tabsize = 8 class Error(Exception): pass#AStop'_izing'K0Untaizer: def __init__(selfAelf.1![]1prev_row = 1 co0Aencof= NoneUadd_ww, startRrow, X\0if < .!or=&lfvG02colC raRValue|"t ({},{})Pcedes PviousQ"K  .f$t(,.prev_col))  row_offset = row - self.prev_row (0 if,:1tokens.append("\\\n" *4)4eucol = 03colf0 = 5col) if, ]!) Ipdef unt@ize(, iterable)Vi (@indents = []startline = Falsefor t in it`Hf len(t) == 2 .compat(t S#Ubreakjtok_type, !, s, end, t2 if+5ENCODINGencoding =6)enKvcontinu d~DMARKERe <nINDENT91+eld/DEd Npop(\Grow,X=- in (NEWLINE, NLY+TrzM"Cand *C$ ="6[-1j"ifSa[1] >=Q0.0 /E6"0 tJadd_whitespace(2 &P] += 1@return "".join.sFF i Rtoks_" =`k]"0[0] .2strK23 ok=_tools.chain([[] atoknum vakjtok[:2?num&vaoUd AM_UMBER*0tokb+= ' 'D# Insert a  between two consecutive Ns if toknum == STRING: if prevstring.tokval = ' ' +  IFy = True"Nelse^ 4iFalse 6 ifn!nunINDENTEindents.append()Hmcontin c/DEc Opop(Z in (NEWLINE, NL)startline<6if "Cand IStoks_ %N[-1]P"= z%GQ def untokenize(iterable"""Transformens back into Python source code.It returns a bytes object, en'd using the ENCODING:, which is!Rfirst} sequence output byBize.gEach elemen!ed(4he must be a?Xwith at leay$woP%s,1pnumber  value. IfDonly two`s are passed,`resultsis poorRound-trip invariant for full input(Udwill matF-rexactly+e`limite h4# Ovd2ize!to|t1 = [tok[:2] toAu`f.read+%)]70new+( =&t14@ = Bd3IO(4)PN/t2 O0rt A= t2M1"""Vut = zrDo?ut.T9aif ut.is not NonLFo($e( 2ing`  _get_normal_name(orig_encPImita +5 inDr.c.0# Oc ab12 charactersdenc = w[:12].lower(place("_", "-" if"utf-8" or.s(#-"QJ"latin-1iiso-8859)k\, t(D-EF?-")u``detecteoding(~EThe +coding() fun(ction is used to detect the encoding that should be/0code a Python source file. It requires one argument, readline,Q!inqsame way astokenize() generator. 2It will callM a maximum of twice, and returdK(as a string)/`a listD@any ps (leftbytes) it has{6 in@lAfrompresence\ utf-8 bom or anq`cookierspecified in pep-0263^f both aC$a 62re l!t,Nbut disagre SyntaxErrorIbe raisedY UQis anNinvalid charse;( aWr. Note=Gif ais found'P-sig'$edTEf no!,Tnq defaulO'P1"""Atry: n}=.__self__.*except Attribute>EANone3Abom_r = Fals%= *#= @1def_or_stop()p 90!()C`StopItH6ionI"<2b''`yRfind_(Q| B# De s UTF-8. Either> declara#which casej|xpure ASCII,5pit mustvI5peru.$_! =!.d( E0Uni vtmsg = "#por missG8!if:r/1not! )e '{} for {!r}'.format(msg,F6-) smatch =EA_re.%Qi!t " L[= _get_n l_(C.group(1)b xcdookup(T2L # This behaviou2micinterpreter)  v"unknowU: " + WOelseHT: {}" F ) raise SyntaxError(msg) if bom_found:if encoding != 'utf-8'$(# This behaviour mimics the Python interpreterc?if filename is Noned)umsg = 'problem: Y?elsJ for {!r}S.format()d^raise^+= '-sig'Fereturnffirst = read_or_stop(z+ rst.startswith(BOM_UTF8)5u = Truep[E[3:]`defaulwqif not 3c7B, []= find_cookie(>% O1, [2blank_re.matchS CBosecondU#P D", :E ]% def open"""Open aS1 inF only mode usdetected by,_ 1().1"""buffer = _builtin_b, 'rb'2try P, lines = iZ.#D;fseek(00texTextIOWrapper(,,To_@ing= D.M= 'rcfexceptPc.close! tokenize(?IEThe $) generator requires one argument,q, which must be a callable object$ providesbaface aG() method of 2-inKWs. Eacho1 tofunctionKsshould PPinputv@byteIAlternativelyG;canf` termi70ng p StopIt=2iond1ead|=+ my.__next__ # Examp;3f aeoproduces 5-tuplesthese members:` type;string; a 2E (srow, scol)1ts specifyqrow andHcolumn where]N begins in the source:; a 2-tuple (erow, ecol) of ints specifying the row and column where token ends in+qsource;K3&`line o81ich&8was found. The (passed is)Gphysical !. /bfirst Ksequence will always be an ENCODING*>!whells you Pencoduto decodbytes stream.H1""":, consumed = detect_P(read)3 mpty = _itertools.repeat(b""#jrl_gen$dchain(f , >Z , <0, e\Dqeturn _&Bize(U.__next__, x) def+$:lnum = parenlev =Atinu0$numchars = '0123456789'contstr, need %2', :(q = None2@indeR= [0]%if-1not/!== "utf-8-sig"$(T# BOM8y have beenRipped/4 Wpyield TTInfo(~E, (0, 0)"''Slast_"b', while True:n # loop over:T<`einput,Hh`K` itselfwritten at;endH!is tg 9% =(except StopIterationJ<T[9.~(pE+= 1\pos, max = 0, len(B)-X!if?str; #&estringcFk\ RraiseError("EOF`multi-5 ", VstartCendmatch =Qprog.#N. po{ enTj.end(0pM aSTRING! +j[:end]>1str0, ("d)DE} ]*Kv elifOy*[-2:] != '\\\n' and line[-3:] != '\\\r\n': yield TokenInfo(ERRORTOKEN, contstr + M,<Kstrstart, (lnum, len(6"))H BbO= ''7 = None :inuNelseh Tt* +E elif parenlev == 0 and notK-d: # new statement?O!if/xy: breakcolumn = 0while pos < max:J  # measure leading whitespacA8!ifP[pos]/' :)I+= 1G/\tH 2= (R//tabsize + 1)* cfc ;4i  os. J  fRin '#c# skip com*s or blanksN2 R_== '# Q _t! =O:].rstrip(')cg 4pCOMMENTW0 &Epos)3W9BG5=6 7NL,B 2if  > indents[-1]t# count!de* Bs.append?+ 1IND [:0)$ Rp<$in.[qraise IationError(V,2"unQ does<match any outerpM level"1("<rize>", 3pos }3s =gjs[:-1]( "DE%''x zN # continued statement if not line:$raise TokenError("EOF in multi-5W", (lnum, 0))KBcontE= 0 while pos < max pseudomatch = _compile(P!).(,G u7if D: # scan for ts6start, end =[z.span(1~5qspos, e= J)/Aend)X s if_Prt ==x "c^ >, initial =[}g:end],]TDif (<in numchars or # ordinary'=ber/N== '.' andl/ !_..'))RyieldInfo(NUMBER,O(, zEelifin '\r\n'mJarenlev > 0% LA?els _oEWLINEd  #aassertG.endswith("\n"PCOMMENTqftriple_quotedwxendprog#Aats[G]1end= XBM  if;R # all on onee Mf/(0. Opos]^ 2kSTRINGBpos) 1strY #6"pla( :str/0 ^break # Check up to the first 3 f{to see iff # 'Ay'reuhe sing set. If so,)Ga string. Weau[F, because w!looking for  # "rb'" (for example) at the start of token. If A # we switch to longer prefixes, this needs/beBadjusted.Note that initial == O[:1]2eAlso n7single qu checking must come aftery^ trip9~(above)ydelif (2in y_y>d od@ ?2] 434-):g#ifh0-1]AP'\n': # continued stringN52str#= (lnum,2)1# Again, uWfirst 3 charsl@0. TSais looPmatch?endG dregex 6correct type? acter. So it's reallyA endpats["'"] {'"'], by try/toF CskipoHs, if anyrog = _compile(tats.get)E C/1]D/?2])XAstr,e = line[_:], 1G/,3(_breakOelseI # ordinaryM6pyield TqInfo(STRING,, spos, e-) J.isidentifier()>namONAME3z\z3 ~-mt%=8%ifAin '([{'+eparenlev +e" Q?)]}Q-Q /OPeOnInfo(ERRORTOKEN, line[pos], (lnum, pos), 2+1)B)=pos += 1 *# Add an implicit NEWLINE if the input doesn't end in one>if last_F and[-1] not.q'\r\n':2yield TokenInfo(rC, '' - 1, len(_)0 + "''for inden `s[1:]: # pop remaining7olevelsgDEDENT4, 0  ENDMARKER=  def generate_t.`s(readm)N1"""Gize a source $Python code as uni strings.This hassame API/q ize(), except that it expect3*n*- callable to return str obj2instead of bytes.51"""1{\r, None)(import argparse# Helper error han3g routine]p!(messageSsys.stderr.write#"R'\n')[ Z, filename=, locationxOkargs = (HE,) +F4 + ,3`"%s:%dp: %s" %7s1Eelif H B FQ/seH9 \cexit(1Q0# Pargumentso opG0r = #.A,>r(prog='p4-m 54dr.add_et(dest='v@', nO='?'vmetavar7?.py/`help='jg8; defaulj`o stdic '-e', '--exact',  ac*='store_truerdisplay( @s usZYS type@3 = GI#s(6try#Me if s.w7&?%with _builtin_openP'rb')fZ9}lQlist($f.) !"<>[Q_mdin.readline, None)  # Output the tokenization"2for2 in %s:F6r_type =!. $if args.exact?C*V Im@rangnq"%d,%d-a:" % ( .start +Iend)Eprint("%-20s%-15Ir" %& R_r,Qa_name[h]en.string)kexcept IndentQError as errline, column =.)[1][1:3]e>B(err0], file8, (F T{v.oSyntaxw 3/OS8 .KeyboardInterrup]iYed\n"=E=ionp"unexpected`or: %sh2errJ%raise if ___ == "__main__" () #!/usr/bin/env python3 # porys copyright 2001, Autonomous ZonesVunes, Inc., all 3`s... # ... reserved and offered topublic 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 usZpy, modify, di;bute thissoftware$ # its associaTdocum $any purpose without fee is hereby # granted, provid{"hakWabovenotice appearskcopies, # t=Bboth '="ndpX in # supk9ng e [ qneither& #U8 or0 beydpdvertis2or pity pertainUto #  ]specific, written priW. # """program/module to trace Pyth on program or function execu @ Sample use, command line: trace.py -c -f counts --ignore-dir '$prefix' spam,Ieggs<t2-yykcalls W @mati+y import sys # create a T object, telling it what to , whether toE!do 1!or- Tboth.1r =-!e.r(Wdirs=[sys.base_2,O], 0e=0aunt=1)run the new usRgivenr.run('main()'F0mak' re@`, placCoutput in /tmp r.results(Ar.write_show_misA=Tru\verdir="K") """ __all__ = ['1', 'CoverageRaC'] Tcache$os &sysconfigYtoken %izCtinspect$gc %di]pickle from timehmonotonic as _threading PRAGMA_NOCOVER = "#pragma NO " class _IZ| def __init__(self, modules=None, W )17(._mods = set() if not<Q elseM:" <V]96[os.path.norm &(d>D Pfor dMR]w* = { '': 1 }Snames @file #iftf/creturn[<])# haven't seVhis one before, so7{C D iCojP list?:<AIdenXstIOII = 1)1[check@is aJsper subof someth,nZ#!mo`# Needta care sinceX,# "cmp" mustEmean*70" bdBBSpamCk also Ef.Eggs" .startswith(W+ '.'1" -BNow t isn't in one of the directories if filename is None:$ # must be a built-in, so weiignore4bself._R[moduaY] = 1)return 1 1# IP! a when it contains one ofaable pathfor d in LdirsThe '+ os.sep'to ensure that@s a parent:%y,`as com&d to cases likE d = "/usr/local"I '<.py*,or; [4^.startswith(d +)Iee -QTriedQdiffeqDwaysfbdon't ab this S0%z0 def _modn(:B"""Ra plausi[l - YIpatch."""`base =MN./\cW, ext+splitext(4)+2Ofull-2# ICg '@part^`ckage,nCQisn't# enough uniquely identify it. Try!doDPrightSng byDqlooking0ys.jlongest mr%prefix. We'llBSassumr3!iss!pa.ci@norm~2= "8dirO2dir$if0~ dxir) and P[len(@1] =Z6seppP$0 > $ = 3if W! =S!q) + 1:]r7els1#xdrive letter`PneverPaZ82#, Oo .#%$.replace(R, "."p if9alt64! =f;'>.lstrip( class CoverageResult_init__(, counts=, calledfunc in40r,outfile=None)3: self.counts = 8if vis None=D!E= {}=Her =I.copy() # map (filename, lineno) to Lalledfunc' & z r%rs /rs D K~m inT2 = 93out 6 P# Trymerge existing s R.I:tryBwith open(i, 'rb') as f370, c pickle.load(f)>kbupdatew__class__(Y )Jexcept (OSError, EOF QValue >errprint(("Skipp9 %r: %s""% >aerr)),=sys.std Odef is_ignored_lB4)"""Return True if the]) does not referampwe wanthave reported&""rkp.starts'0('<!nd_|C.end6>')z, otherM!indata from an, CoverageResults " '6_iC_:" =..w>*"rs6for key inL %U[key].get(key, 0) +=)c   hDO = 1H /rsD+rs@rwrite_rshow_missing=, summary=False, c@dir= RlWZX.Cage g.x:param ra: Shows that had no hits*:: Includem per module=dir: If None, the results of each module are placed in its directory, otherwise it is includDEthe +Nspecified.$5""" if self.calledfuncs:print()".btions >*:"'=s =a Lfor filename,. _ 1qsorted(R)$("IH: %sMQ@4% (FB$, >E))) ?r;ing relaCLhips@@last0 = c A0((p, pmod, pA), (31, cc5) \?3in e/rsl1if m" !yW;P"***"Qile,  C+i" =}%; = %D2if !EG andZ"!=  " -->",*iQ %s.%s -> W" % ( xp# turn counts data ("lineno) = #") into something# accessible on a per-oFbasiAper_E= {}?", vX S#Ps_hitS[B]G.get*{}qH[ no;u[;!()]Baccumulate summary info, if needed0sum&{}@ b#{.items(@/is_ignoredP: 3%continue~%if9.endswith(".pyc"D`% =6G[:-1TcoverdirpJNone%= os.path.dir0abs Am6p = _mod 1w,?els 15%otexists(dir0os.makedir& QmFfulllename)  .# If desired, get a list of the line numbers which represent E2# executable content (returned as a dict for better lookup speed)Nif show_missing:olnotab = _find_|_nos(filename)<OelseN){}.source =cache.getb`coverpath = os. .join(dir, moduQ + ".-"with openp, 'rb')C.fpencoding, _ = tokenize.detect_(fp.read qn_hits, n:s = self.write_results_M(", ,-, count, ummary and@percl= int(100 * $ /6 ZVsums[4] =,#, R , O% S pr"ts cov% @ (L)m in sorted(V)W ]=%5d %3d%%(%s)" % zJ[m])0out 3# t@storAuntshP infoobF :tryV8D, 'w48pickle.dump((;q"s,calledfunc?rs)Jf, 1Uexcept OSError>errwCan't sav(Qs because %s2erry=sys.stderrOdef  , X,4s, mqW=None]A"""R acerage ]E."""B# ``eE`` i(of~ , T! "1"d PW, "w"A("trace: Could not}1 %rcF %s ]"- skipping , )DryF0, 0 E = 0o!N{no, line in enumerate(lines, 1): # do the blank/comment match to trymark more LGQ(helpJreader find stuff that hasn't been covered)H!ifaQno in ^s_hitoutfile.write("%5d: " %7[>no]g?nZms += 1 ?!*el notab and not PRAGMA_NOCOVER # Highlight never-executed, unless[ contains# #pragma: NO ( =>/ "+y /se dU/ d )l.expandtabs(8)) rreturn @, n_.s def _s_from_code(c, strsB"""RFdict where keys a] number table."""nos = {}afor _,@dis.+astartsD6!in L=4nos   k4 @all & objects reach G`# get 3oformation6@V(is scope levelCb#aQcheckconstants referencesQothert)cA.co_Dstif inspect.is%'(c#-anc, so recurse into itv7@.upd#(cstrings(name, encoding=Noneaof possible docFi"s.a2The/AmapsS5Qs. T3is an en#1forp only aing or a part of a triple-quotedBf. mdgC0# IOe first token a,Rn it'2HmoduY# Add thpecial case@test* loop passesAprev_ttype =q.INDENTwith openf) as fz4tokLqize.gen_@s(f.X`# `, tstrCart, end, line in tok: if ttype ==en.STRING&1if prev_/nINDENT/3sline, scol = start}$e(e(?end&for i in range(]<_ + 1)`d[i] = 1Wreturn d def _find_executable_nos(filenamevC"""R9ict where keys are 5 numbers)th [A."""6tryBwithize.open{V as f+prog = f.read()Prencodin  "except OSErrorW6errYprint(("Not Ecoverage data b%r: %sp%% , err)), M=sys.std?!{}code = compile(<0, ""cstrs =fstring$, -f s(k , F) class Trace _init__(self, count=1, t' sfuncs=0 `callerignoremods=(), 3dirn$ NoP6outJtiming=Falsf_ b@param true iff it should of times eachoP5@ is 6uteiiOA out])that isj"be}/ungsl@justkput a liffBmodu , l)Otionw d at leawnce; This GOrideE`q' and `G']+: csCs toXCnCdirectorieG0allu(recursive) content  from whic c store~%beBv added intofresultY0?o&inm_write: Z\pinforma  be display{/".i"= = I3(7 self.counts = {} # keys are (filename, linenumber) self.pathtobas)E# for memoizing os'.& B`donoth(:= 0trace =  _calledfuncrP_cach]*{};start_timENoneif timing:  6>(*if count/rs?aglobal1 = R_k>|$elXV< TnRe andY%ltQ!;locae_and_>U {{Ph{*seu# Ahem -- do /? Okay.7kR!1 def run(Zf, cmd)aimport __main__0Ledict =0.__!M.runctx(cmd, )w!-z",  s=]!,  f'@ is *:#ifB(R'2notZ threading.setu/.1?sys+:tryiBexec1[s_kfinall8 if :W)0- , , /, *args, **kwPresul,ECeB%q(~BDrreturn *_module_ttion_of?Grame00cod]f0.f_t0 = @.co_]$4if  Z,0mod else:  modulename = None Cfunccode.co_ 0cls86@ if / in self._caller_cache:>//if#[>] is not 59{c@h;elsv3 i-## use of gc.get_referrers() was suggested by Michael HudsonIP all Stions which N to this7iobject<6s = [f for f[ 6)7wi6spect.isQI(f)]3# require len('`) == 1avoid ambiguity causKs toK@new.Cj): "In the facRK,g;theD`temptaByguess."$%ifs/AdictAdAdAOs[0]ENIsinstance(d, ] G(D(aclasseccHR hasattr(c, "__bases__"2DF*q# ditto7Oobj(:-eh!._O)__a!# 45result - assumpis that O* isIKed laterNrdisturb|1relgOshipH  could be flushedyG:s i#3newR get .~`;H"%s.%s" % (J,)return fi1,&0/def globaltrace_k0rs(, frame, why, arg)"""Handlerd7 events.^C0AddcAform about whoI [efsg&""Q if'v's# XXX Shdo a betM0job#identifying method_w" =J_8A_of( Naparent&>z.f_backEy._callers[(parent_func, this )] = 1 def globaltrace_count0 s(self, frame, why, arg):7; """Handler for call events.\%Adds (filenHDmodu g) to the r ._I edxs dict.r ifP == '1'w" =V_}tion_of()V< [N9/lt13!If  code block being entered is. be ignored, returns `None',Eelse3locT!=0.f_l8c $Zs.get('__"P__', u0if @ Z`# XXX  () doesn't work rightpackages, soEc6p supporAG C@& = s7if 3ais not/4_it.qsDsHfi>?_itn*'+print((" ---`: %s, "7? 6% ( , L@.co_D/))Br q9xB_B_and~j"line"r# record P and . number of01ry ~ 54L$ 0W'noz $0key!# Ps[keykey, 0) +B"ifstart_time$E'%.2f' % ('L() -;), end=' ' bos.path.basY /pq"%s(%d)vE,&no0*Pcache oF)tAku7e file name and line number of every trace  filename = frame.f_code.co_ 0W'no. %if self.start_time: print('%.2f' % ('L() -;), end=' ')Ebos.path.bas( /p"%s(%d): %s"vE,-9no,`cache.get oF)breturnRlocalpFdef p_count(?,, why, arg)F ifP == """L0keyO/#.s[key] =1(key, 0) + 1; qresults7CoverageR&@, in = 6out4 5calledfuncsm_>r:Prs) Smain(`import Rparset 5r =.ArgumentP%"r('c.add_a ('--version', action=' !='b 2.0')togrp = S_group('Main opR*s'@'Onethese (or --re) must be givenm qc', '--Xstore_truetphelp='CZ8 thas each is executed Fuwrite ' 'Hs to .cB forUTN, \'s directory. See also verdir, --,JC--noQs below.. will be0tenge/E/E.mmissing]PAnnot7able lines that wVd!">/ "ssummaryWa brief ? nAeachUCan only3use5or SZo'--timfqPrefix ^Ftime sinc{startedOh(0rac@Filt m'#beied multip0ime-ignore-append', default=[]tI?bgiven I1(s)rits subs6(if it isv). Accepts comma sepaG`d listpfQ name W help='Ignore files in the given directory ' '(multiple(ies can be joined by os.pathsep).') I"parser.add_argument('--module', action='store_trudefault=False,H help='Trace a SA. ')1ypprognamdnargs='?'`T" to run as main <?ram_ Bs', `1arg.REMAINDERo8tlqopts = J!r.N#s(e0if #!.iQ_dir:8% _prefix = sysconfig.get_("stdlib"3/Oexec4 Eplat8h2def_6(s).expanduser(vvars(s)6s.replace('$3', )!PdreturnQ.normsGDN = [mod.strip(J* Pfor iTE0modi.split(',')]<00dirr K+ r[ wGrl]6freportbif notR sr.error('-r/--A requires -f/--:,7QresulCoverageR0(in+= P, out yNs.write_(Cmissing,ssummaryc{3dirQany([<tK,3unt listfuncs(wkcalls] must specify one of --:qe, --co_=,x88'--~rD~e*R and i2 or0canWboth VS)v0Q]L .$--4V@only[qused wi?up u4 is Nonek(-:n opskAt = o[1e, +  )C2ers+", 3mod_ K$diI, infile=opts.filIe, outfile=opts. , timing )5Atry: A1if 3fmodulemport runpy1-r_name =@@prog (%, mod_spec, cod5Uc._get_Ndetails(Mrsys.argv = [F@.co_*1, *arguments]globs = {U!'___': '__main__'^ l( }Vqpackage1.parent^jloader//M -&acached(;Non5};elslYi 8ppath[0] s. @.dir(J%) with open&, 'rb') as fp6 = compile(fp.read(),, 'exec'Q# try to emulate  Pspacex@muchpossibleZ 2 r W?'__t.runctx(F!, )except OSError6errexit("Canno*  %r because: %s" % (-[0], err)cSystemExit_Bpass$`result#t. (?0if zaPno_reD.s.write_bsmissing*ssummarycoverdir) if #&==c/() """Extract, format and print inion about Python stack 7es.""" iqcollectionsitertoolAline"sys __all__""'e_g'l@t_tb_:ion'W_only8GlisteCo n50exc ep "laon" 'bclear_framesDFSrSzTracebackEFwalkItb'] # # FFting #Bs of_ s. # def _'(!ed,F=)i"""Print the list of tuples as returned by extract_tb() or pstack()3a formatted  7e to the given file."""E!if is None:^& = sys.stdertfor item in SxSummary.from_list(!ed").&()[`print(G,}=l, end="") defC RIA"""F0 a x<or Frame objectsT |Qing. GB B ,`string1adyDV REach *lresultingcorrespondsSP withZsame indexFargumentE8. ieLin a newline;E}s may contain internal.Qwell,kQthose.sGwsource tex nez1not~.(gp # # Pc+Rand E=Tracebacks. #jytb, limit=  1"""W0 upq','hentries pS 'tb'u4If =ais omi!ord, all I2arePed. 9,'(<output goe; otherwiseA'L should be an op"1 orS-likeC\a write()EjmethodS `:)b :tb(A0rth6'^ ( l5))'Qg* R) a4represenj8pre-processed=4@This+auseful`!al te(ofs5lrtA> [yau=0attribut$pilenameubneno, |; ="inion thatztusually)" aEp. The Z4 Alead ndQiling;whitespacepped; if0is availabla'  7extract(walk_tb(tb), limit=B) # # Exception formatting and output. # _cause_message = ( "\nThe above exHwas the direct <" "2!of`followj7p:\n\n")moontexto0Dur5Phandl O ,nanother e occurredn def print_&(etype, value, tb8None, file= chain=True):0""PMsqup to 't' stack trace entries from 'tb')_1'. OThis differ'{tb() inLways: (1) if?gbqris not "its a header "T+(most recentFcall last):"; (2) A8 7<:` afterG@; (31is SyntaxError@hI>appropriate,line wheres! sS eTB with a caret oEQnext BaindicaxaximateFAposi.{`."""#Q ignored ]# some time,code such as cgitbW# passesRboguss& a result. For compatibilityOYw"# =,1(ra$@thancEnew !BAPI)!if1 isS2 = sys.stderr4for]XM>D(@)F").(B#(Rp, end="aB d F0) a:C"inl5ione arguments havame mean correspond5V"to@). breturn)a list of stBqs, eachGe\in a new8acontaiinternal%s. WhenEQtheses are concatenatedNed, exactly1 isG&Odoes'j(;7 tb, limit=limit).format(chain=)) def _exception_only(etype, value): """FGU the 0 part of a traceback. 2The arguments are:dB andg such as given byDsys.last_- . fcreturnHis a lisDtrings, each ending in a newlineNAlly,BpcontainRsingle sM; however,AfSyntaxErrores, it Fs30al us that (whenA printed) display detailed inion about wheOswAe|occurredmessage indicat0whi  6 >@lway e {\6`1"""!$(T E` Qd, None {p# -- noficial API but folk probably usUpwo func"s._7`_finalh_y Lstr = _some_str()&if]1 or#2str#'b = "%s\n" % JDOelse($: , 2str|Z#ne U2try 4  &A'' % w .__name__ 8[ (lk=c, file n8=TrH`ShorthUfor 'D (*@exc_A(), [V4)'.r7===", )(9exc# ULike {!()oa"".join(g y pAThis/ sz y]n,%, !if#hasattr(sys, "^"z`aise Vm@A("no{I" 0ionUu$) # # P0 Ex?Stacks. #@s#(fT 1"""Z 22ack; from its invoon pointloeal 'f'^p can bed to specify an alternate stack frame at which tort. The optional 'limit' and 'file'Carguments have the sO meaning as for print_exceP1().>1"""if f is None:f = sys._get().f_back#Tlist(extract_A(f, =0), =p) def%ma/=w4 )"""Shorth@'for8tO))'.*dreturnj E-@raw ;eVQ frompcurrent !!. uvalue has3 `tb(). OCSfO/' LD\Each item in9Ra quadruple (Qname,Dline number, func q text),entries areaQorderD2`oldest90new X0N0= SSummary.\T(walk)P)=.reverse(aclear_eDs(tbC all referenceslocal variables'@V of aV.while tb;not2trytRtb.tb.G RuntimeError=r# Ignor.ion raised if"still executinghApassI Rtb = next class FB"""A single\P- :attr:``(3"no1  within=0 thaactive whenb was capturedom 9or methodiTBll=ncache modu] ora`of codA runzs` Either2ps were supplied, or a dict@mapp) tot repr()7<d2?__slots__ = (gC ',@neno _ "')R __init__(self, filename, lineno, name, *, lookup_=True, locals=None,< %):%"""Construct a FrameSummary. &h:paramlQ: If p `|cache` is consulted for the sourceMAcode. Otherwise,-M will beq ed up when first needed.PsuppliedQf u, which`captured asOobject representationss1ineqprovided, use this instead of0ing)inqGh5"""'self.file4 = !]Ano =]*no: ?5i]3!l.oa = {k:>1(v)sk, v in.items()} d` else vdef __eq__(Z0, o'Pif iseQance(,,qreturn NG=Y5and8.^64 n$ =20 2)_tuple',   )|t=NotImplemented0get7pos? |r X[pos]hCitere`!([Ie(])aa("< $ {k}a {D0no}{}>".format(QV9=@ R ?len4@property[XF"if !is b5getQJ {).strip(R0 walk_stack(f"""Walk a ` yieldQ61andq numbertQeach T[follow f.f_back from-0givh3."noBGscurrent isd. Usuallyp with STrextract0if  qf = sys._getframe().rf_back. while f is not None:yield f, f.f_lineno1f =Q def walk_tb(tb)D"""Walk a trace+ Ting the frame and ^ number for each!. tThis will follow tb.tb_next (B@thus!in[opposite order t stack). Usually used with SSummary.ex!t.1"""0 tbj1,=Ctb = _RECURSIVE_CUTOFF = 3 # Also hardcoded K.c. classV(list!A 2 ofO s.@=amethod (kY,4_gen, *, limit=%, lookupqs=True,D8capture_locals=False"""Create aY from1$orSbjectDf:param: A generator thatn3s () tuplesLqincludee"hevn:)D to 4a!s |exnaXQ: If \o(s" immediatelyotherwise?is deferred until,rendered p variabW 3be Qad as o representations intoFXI"if = getattr(sys, '!',)_9Wzmit < 0i4NE = 0JF 8"/>=S = itertools.islice 7elsQacollecrY.dequRmaxlen=-)Aresult = &(tfnames = set orG` #coVAr@file\ = co.co_ & " Eds.add(?!cache.lazy *zglobals7b# MustZosd`we havlled check]h~$if6 #f'zs  f_locals = None  result.append(FrameSummary((3filename, lineno, `ookup_P=Fals!ocals=f_l %))MDfor IP in fD%s: iJcache.check (5K# If immediate l was desired, triggeres now.k#if " f.Mrreturn . @classmethoddef from_list(k1, a)a1""".e0Cresa Stackq objectK a supplied V5 of=4s or old-style2v tuples # While doing a fast-path  )isinstance(,E) is # m0aling, idlelib.run.cleanup_traceback and other similar code mayNbreak this by makrbitrary fss plain, so we need toL on8RAW basi!) =(9#in7if 5+(, 0u4r!Jelseg9 Rine =!1 lP=ormat(selfA"""F` the sa readydprinting.]Rt5s astrings7r Each "&th :Ecorresponds todRingle,x6`e;@ new;may continternal2s as well, those items with source texts Fong sequences of$am_,first fewrepetitions are shown`llowed~.PUexactL`number1fur^CyU = []GPlast_ d count = 0]  LAif (g!isMP!O.#u%or_/ DD?no B_ BBname):  if count > _RECURSIVE_CUTOFF: &/.-=0/result.append(#^f' [Previous line repeated {s} more 'Ctime{"s" 1 else ""}]\n=)Slast_file = frame. Oname++ /no)CT 'I = 0I+= 1zcontinurow = []X4row@' F R"{}",{}, in {}\n'.format 7,G)~'if*  sc.strip()]^ocals_@for p, valuessorted(\8.items())A RQ} = {U6=q=" B''.join(row( J u (/f'!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 crO/a insta7 objects,kconstructorVindividual components0- :c:`__cause__` A*of|*1!*.fJoontextL3Nsuppress_JW<>*__*DS"th 3 Pstack `S Summary`@reseg Aexc_type` $of the original +traceback. - :attr:`filename` For syntax errors - the "a where H occurredXolinenoV _umberXOtextVP_offseR Q into b ?msgcompilers messageLA""" a def __init__(self, exc_type Cvalu , *, limit=None,Jplookup_@s=Tr= capture_locals=False, _seenA%):B# NB: we need to accepth7 toKppermit `wards qat withr existing API, otherwise weFstub thunk objects just`glue i geBb # Handle loops in __cause__ or on&__4"if@ is ]R4 = set().add(id()!0# G<rfully h(way Python 2.4 and earlier did)%ucase ofn@# be4bcalledM0no 3| (,)t1xc_8.!ais notB{3)1fGseenU7x@ = T  ExYIion(_,a +n&%5.__O.__3^cN t SC=7JelseFs6if .5 &&?>__) ('* =t1 =  self.__context__ = # 0sel#suppress,\&-exc_value.__/5if " else FalseC# TODO: locals.stack = SSummary.extract(+walk_tb(leback), limit=, lookup_lines= ,Lcapture_=)+pQype =8typCJ- now to permit freeing resources: only complication is in thOunofficial API _format_final_ _str = _some ! and issubclass., SyntaxError):d{# Handle#`'s spe)ly-5tfilenam5. /3lnoZ%)no#R = str(lno) if =is not None~ @ i'ioffset)+9msg(5msg% OR_load1() 9@amethoddef from ep5P(cls,, *args, **kw """Create a Trac*2ExcCR0 anFA."""preturn cls( )reexc.__|.__ @PrivAPI. force all  `to be -)ed`for frd0in b.1 k!.W"if. 4L. T*oause__F D&`_eq__(Ih, othe{if isinstance(,ZSa.__dic=^/NotImplementedSi&e6str1eo_?A"""F part ofh.]RThe r.Da generator;Pstrineach endin a new ONAlly,qGemits a singlering; however,@6bs, it Gs4athat (whenB0prit) display detailed inN.about wheresEe occurred.  4The message indicating which exception occurred is always the last IP str;!inoutput. 5""" if self.exc_typeVUNone:"6yield _format_final_2Pline(/,FY_str):ureturn se=/C.__qualname__+Nmod *Xmodul(+not in ("__main__", "builtins"):+ '.' + 1if Tssubclass(+, SyntaxError_1 g2?elszBfrom3s{ _e|(Q)5def %Belf,A"""Fns (internal helper).?# Show exactly wheretproblem was foundAfilesuffix = ''Z noc a' File "{}", 4r {}\n'.(Wb or "<,#>"E&no$el7!is"_U ({}) Dtext 0if # = " foo\n[1# rB! lz "foo<$ .r+fp('\n' dC.#.l'[ \n\f*spaces = len(/1) - D W +# Convert 1-based column offset to 0index into'AppedDt@careE@or 0B1 - 42if 7J>= 0Sa# non-8"te (likes tabs) must be kept for alignmenKkC`= ((c 1.is0() KQ ' ')Hc8![::]kR o^F''.join(9`)>4msg Sno detail available>Xhp"{}: {}"{, msg, L-L, *, chain=True>.%"If:\*B*, *__cause__* and onAwill beYgmattedVQ valuPa generator ofvngs, each ending in a newline and some contain)dternal-s. `print_exception` is a wrapper arouQthis method which just D`s the s to a file. The message indicatG occurredClwayX5astK0str;!insuoutput.5""" if chain:if self.__cause__mnot None+/yield from7.format(c=)i>j %delif (jontext T5suppress_>)l5 TZstack~@'Traceback (most recent call last):\n'9y\j '_only() I`collecs.abc import Sequence, Iterable/functools)total_orde ?tfnmatchTcacheeos.pat pickle # IPtypes q1ionq`lement 2n C _tGUmallo*_get_object:!, Js def _6Psize(c, signIfor unitl('B', 'KiMGCTiB'3aif absOq) < 100Jj!= 'B'*# 3 digits (xx.x UNITS 8return "%+.1f %s" % z, F?elsCB * 1024 &@== '  !# "5x%0.B 1 /= class Statisticip differH on memory ar between two SnapshoTbstanceV__slots__ = ('|rcount')eq_init__O%, 5Aze, 1A&& =2X#q0 =  Q" =YChashpb(.},]c \)eq__(self, other)3: if not isinstance(other, Statistic)-4return NotImplementedO(self.traceback == W2TAand 6Fsize1,Vcount-!) 0def __str__text = ("%s: aQ=%s, =A=%i"?!% C,$ _format_S1 , False)4{%))U"if  average ="a" / .Dc+= ", 8j=%s" %BES?repT-5('<9 3=%rhig%>'ig, )sort_keyqa BN) classBDiff{"""!difference on memory allocations between an old Qa new`Snapshus.g__slots__'@', '_  !S_init,,5OG& =I#>izeU #" =#3  Chash(#S X01 2 3_eq,qz1[us&y+2. Y 3 S (%s)=%i (%+i) #_, Tru#>JF average = self.size / wcount text += ", 8=%s" % _format_?(, False)Bpreturn E def __repr__(!):r-(''LP!% f.D,G m_diff,>" .g/ 0'))sort_keyo1abso?Q {0p1NA) m compare_grouped_stats(oldR, new !}as = []6for , #6 in;s.items(ByppreviouDlW.pop(7Non,5if 5pis not ! Wz)= !S(A % -z\ OG. I OelseP&.append(  = P 0, -$z @#9# @total_ordering class Fram1""".V of a."__slots__ = ("_fD#",dS_init!, ! #0 isduple: (filen str, lineno: intp" =Er@propertyOd|J?[0]EC1CzE__eqWother!ifisinstance(",)NotImplemented.!= P l$mL<Chash- /st2B"%s:? 0lineno) def __repr__(self): return "" % 9. , H.#) @total_ordering class Traceback(Sequence{1"""B of instances sorted from the oldest f=!tomost recen.c__slots__ = ("_?bs", '_n1') 6def __init,,q8s, /D=NonJ.<)S #F is a tuple{cs: seeconstructor forKPormat@aWB@; it`reversed, because _tgmallocHsD pT#to{[, butPython API expects-G to Fw8" =((&s)9/{5l@propertyh3z M?S__len:1lenT. =sgetitem=w, indexDTif is(U, sli.(()3 in:[O]@FelseVP_ <D__contains+ UChashLEW#eq9w, other@Pif noV",-NotImplemented 2 ==wsl.zoQ</st1str9[0]+us = f"<" {D")}?#if4 vs += "><#*f"~{t.`}Esyf2q, limit,_<_first=Fals%[] "ifDx":> 0!-_! =,![-:d( >:>=9 frame_slice = self if most_recent_first:% >reversed()0Afor 2 in w R lines.append(' File "%s", E %s'R "% {.filename,i.;6no)7! =Wcache.getD z.strip(K!ifG d ! %.Careturns def get_object_traceback(obj)d1"""Get the $a whererPython F *obj* was allocated.CR}4a Th instance. "qNone if\pmJ module is noting memorymqions orq5did*H0ati`=_s = _`"ifs7msMelse+@ class&#KT of aZblock__slots__ = ("2",)b__init__(,He# a tuple: (domain: int, size 3:+)H2See! construct!or`format \wK." =@propertyH?[0]CA1AF((*92:]%eqWother!if$isA(",o)NotImplemented1d!= P ChashhdJ :?str9"%s: %s" % @D2, _&_. , False)c?repd1(": ,._s(Sequencxsc3.)NYmDs: s s'?len2lens) def __getitem__(self, index): if isinstance(w, slice%,return tuple(Trace(ta) for @ in f!._!s[O%])mFelse{VP<=def __containsg  P%eqJWotherJhif not"1, _s+NotImplementedjQs == S)Creprj""< len=%s>" % _A) -normalize_filename( R = os.path.57cas+4if -.endswith('.pyc'L#% =.Q[:-1]C$ class BaseFilterS_inithclusiv*#in5 = FQmatch,jraise UError(> ,_pattern,lineno=None, all_frames=False, domainr:super()._^C#@ = _0' j2 = d' = %# =@property,n5\x UG_nQ_implH,Zz! 7!fnl.z,Xs"if=n@ is B6 9ETrue8t(J(==Y1,|:ke@ ^ (b0Cback4u aif anyA. O )[7 ]<8 : eno = traceback[0] return self._match_frame(filename, lineno) 8Bdef ((4, trace):Xdomain, sizeback, total_n^" =86Yres =X:( )/"if,m is not None(inclusiv#Sand (S=z3?elsI %orH!Hw class D:Filter(Base \ys_init__{#, super()._3-"._;# =D@propertys|'z JA3(B@ ^ ( bSnapshot'1"""2 ofs memory blocks allocated by Python.=E msg_limit?#qis a tuple|s: see _Tgs constructor forz# the exact5mat.RcIUs &Adump $, *QWritesq into a9F(4with open"wb") as fp5xpickle.3p, HIGHEST_PROTOCOL@staticmethod+EloadruLoad a OfromrPp!_f_#des, exclu.;if 5 R!ifP2any([!;2for6< inn9QFalse,if r 6FTruessXCreate a new instance 2Rteredas sequenceFters;Qlist of Filter or DomainFilter instances. If fs is an empty  list, return a new SnapshotG with a copy of the tra`H5""" @if n?s(, Iterable):.raise TypeError("1 must be a },c&%svH d% type).__name__)~i include_oU = []5g/ex! 2for&D4 in kN)if,.Nsive+/ .append(o1?elsO OAnew_ms  Qself.#s.* >1if 11(,AK A)B 4.4(ic(@,?back_limit) def _group_by(h`, key_, cumulativW%if"+Uin ('^', 'file lineno'DValuuunknown[: %r" % ()'ifE and7y mode canpby used  ! "1keypF@stat!{}?   .ids, size,}, total_nframe = @>tryY0acec; !s[`{4except Key]w7== r0YS -,elcC`>[:1dVse: #/i(N[0][0], 0), k*@ = T\6(2tracebacks[t`race_tback] = + Mtry:$pstat = %s[@],.size += &Pcount'1$except KeyError = Statistic(,E, 1)fJelseS# cumulativeEs22for= in self.d"s.`sR2ddomain.,, total_nframe rDv""inCr20aceq !s[b[if key_type == 'lineno'1yQs = ( ,* #dfilenamefg[0], 0)nD = T?=s6Rf  qxM0|*$w"areturnp!s 1def(f,,v=False)]1"""BWGroupH5 byE2. Rva sorted list of<Hinstances.ggg ed_D_by(5/! =}(9ed.values(),.(reverse=True= ._"F_key?arfcompare_tofold_snapshot[t Compute the differe: with an old _ lU. Get`?as UDiff #, C5 byK?_by2new([* =O_S0ed_%s(e%, $ey=StatisticDiff._sort_key) return statistics def take_snapshot():11"""tTake a  of traces memory blocks allocated by Python.DLif not is_C4ingmraise RuntimeError("thenm\ module must bCing L"Bations to"'es = _get7es(back_limit = #,jSTW,. ) """Terminal utilities.0 # Author: Steen Lumholt. from t7os import * __all__ = ["setraw", cbreak"] # Indexes forClist. IFLAG = 0 O 31 C 32 L 3 ISPEED = 4 O 5 CC = 6P}(fd, when=TCSAFLUSH[2Putinto a rawemode = tcgetattr(fd[1] =4& ~(BRKINT | ICRNL@NPCKPSTRIP 7XONJJJWOPOST)))CSIZE | PARENB2 Q| CS8[VV@ECHOPCANON AEXTE 8SIGepC][VMIND1XC@TIME05tcsK,?),7L <YDefine nam%built-in types that aren't directly accessible as a 40in. 1sysbterators inOa matter;m@ but protocol. A large # and changBnumb8zimplement *some* flavoaC # iP. Doacheck Uype! Use has] both # "__E1__"q"__nextttributebstead.D_f(): pass Funcp1Typype(_f) Lambdalp: None)Q# SamqJX Code= _f.__code__) MappingProxy%op.__dict'S9N5pacAsys.S,_cell_factoryBa = pFe0non 1l alosure__[0] Cell g}(yield 1 Gene=pe(_g()) async def _c(): pass _c =4 CoroutineType = type(_c) _c.close() # Prevent ResourceWarning as_ag(): yield _agf AsyncGeneratorlag) class _C@dm(selfiMethod9 C()._m) BuiltinFunction%Dlen) C[].append) # Same as R@ Wr-rDescripobject.__init__) n4*F_str+Xstr.join) C#V+!di__['fromkeys']) Modulsys) trys`raise Error except&tb = sys.exc_info()[2]TracebackDI1tb)IFram~ptb.tb_f"ZNone; del tb # For Jython, the following twos are identical GetSet  r.__code~?mbe 3pglobals6 sys, _f, _g, _C, _c,  # Not for export Provide a PEP 3115 compliant mechanism6@crea Anew_(name, bases=(), kwds=<, exec_body@"""CJzB ` dynam8Qly usXhe appropriate meta3A."""resolved_3 = (<B, ns = prepare>O+?&if is not 5(ns4 Q9:ns['__origb__'] =SAturno X **{!) !Qr0"""8lve MRO entries~as specified by!5560vs = list`updated = Falseshift = 0i2 in enumeFRif isinstanc,gI#rcontinuk!ifqhasattrW, "__mro_?__"F .@Wu.TrX{, tuple ( must reaC"oFelseAoAs[i+: +1e0( += len("Q) - 1'`o)tuple(new_bas6es) def prepare_class(name, bases=(), kwds=None): """Call the __<_ method of appropriatea\!. BReturns (met , vRspaceq) as a 3-tuple7*/O* isfd*Q-!d r0+an updated copypassed in argument with anyF'' entry removed. If no<5is W, this willKbe an empty dict.1""""ifK0is Q = {}'MelseN(() # Don't alterRprovided mappingG8if Y! =W.pop(-)A "if_AEQtype(~2[0]> B0dif isinstance[ , M3a# whenBa , we first determine most-derivlMm!eainvoking9initial candiJ directl%=_calculate_if hasattr's'Ans =.!A, ** O=3rKB, ns(  D D.cwinner1foriY4'! =&'1sub(Z5,.continueu ?l", J ?! =`IM ^*# rraise TypeError(" conflict: P "c3Eof afF<Pmust _ (non-strict) ;w z es1its "s"G(" DynamicChAttribut"""Route  access on ato __get$#__NT7i.descriptor, u`to def2V8at act differentlyued throug U7 anC. ItqremainsOnormal, but toiQr@d toIME('sBhod;=is done by agh. This a(llows one to have properties active on an instance, and+virtual attributeN the class with`same n(see Enum for[example). K1"""def __init__(self, fget=None, fs 3del1doc !):C:.9! =@ 0set;set0del"deK# next two lines make DynamicCA=$asXyf__doc__ = doc or. +overwrite310is )# support[bstract methods'S__isa"!bool(get(7?, '+', False))&ge2Qowner %ifY s?if  *.areturn2Uaise uError()#$elgrC"unreadable"Y( 5s5Wvalue,`can't 5]L", zedelete7`C5del<ggetter0fRQ LJelseHPresulAtype_) Aset,fq.fdel, l"orN.u=- 8s7set,7 = g G?del_?  _GeneratorWrapper# TODO: Iment this in C. 7genwVqd = gen:Risgen1.__ __LType6H1gen!',mqualname__ = getat'tr(gen, '__qualname__', None) def send(self, val):preturn .__wrapped./)(ASthrowBtp, *restH60OQcloseOD+@propertyIogi_codK-=KOframL.Mrunning3gi_0QyieldfromS2U!cr,8 = 1cr_ . Rawait f.__next__s<Niter<ilf.__isgen !__r__ = __o }coroutine(func"""Convert regular generator (tion to a @Q.""" mif not callablYaise TypeError('types.I() expects_E%')\.__class__ is FuncUA andlqgetattr32;. 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" |]r*LC# The following Mprimarilyusupportas that## Sq-like obj(for instancers=compiled with Cython).RDelayv@oolsq _colles_abc imor speed1up )YO V@'t+.TssPgped(*args, **kw pn & if (coro.__class__ is CoroutineType or /Generator/Aand $ gi_code.co_flags & 0x100):P0# '/'ya nativeA object or an iterabl Kareturn=if (isinstance(k, _collections_abc.U) and=Onot A3)either a pure Python g>@tor,)it# implements . (~Qdoes 3 K @.*P_qWrapperF)+$n s= ofq]# some o$-- pass it through wAd icAlias = type(list[int]) __all__ = [n for  globals() if n[:1] != '_'] """ TheKing module: SupportCtgradual##as defined by PEP 484. At large scale, the struct!of`following: * Imns1 ex , all public names should be$licitly added to .Onternal helper fun:$seJPneverP`used iide outside thisU_SpecialForm5itsBs (s3ms): Any, NoR0, CVar, Union, Opal * Two es whoseX0canR argu1 iniBs: ForwardRef0Varahbeiics API: \v_Variadicvlatter is currenQonly Kby Tuple@Call. All subscriptypes like X ,=], etc., ar3of Y$seA:0cou@part consists#: Protocol\PZ@get_ _hints, overload, cast, noPcheck Q_decote} esT sB ABC15few Cal psIpes: Newq, Named , PdDict1}ruio rela.@ from abc6abstractmethod,aMeta intextlibDools!opr import re *as stdlib_re # Avoid confusion with the re we export. imD sys types from  #WrapperDescriptorType, Method )!GenericAlias # Please keep __all__ alphabetizedin each category. +`= [ Super-specialing primitives.''Annotated',y CallabletlassVarUFinal orwardRefVLiter0WOptio@uProtocoP6TupzAH Union', # ABCs (`collecfds.abc)bstractSet',) (C.Set+ByteString}ContaineextManagHHash:ItemsViewHI [%toW9Key0GMappR0MutrhuSequenct) "SlYValueAAwaip#\AsyncCoroutinC M?aN p Structural checks, a.k.a. pYwReversi0SupDsAbs |Complex,FFloaPT>Ind*-In(@RounConcrete ChainMapVCountD5DicoxDefault5LisxOrdered'w'FrozenSNamedJNot really aHU' r# One-off thingUAnySt+&cafuget_argPorigi/$'U_hint(0New?1no_$Wh_decoruNoReturipoverloayruntime_TX5TexTYPE_CHECKING', ]The pseudo-submodules 're' and 'io' are part o9e public # namespace, but excluded /Bpbecausey might stomp on # legitimatesfCose . def 7onvert(arg):`"""ForqNone to3( !),s|sF_A."""Hif arg is 3\^return type(None) if isinstance(arg, str):!return ForwardRef%<arg def _type_check&, msg, is_argument=True]@"""C* that the &` is a Lc, and hit (internal helper). A1 special case, accept NoneEV( ) ead. Also wrapAingsTGinto/%s. Consider seversQornerzs, for example plainPforms like Union are not valid, whilA[int]OK, etc.N0The^ 4human-readable error message, e.g::1"[P...]:M should be"."2We appendrepr() of`actual ue (truncated to 100 chars)1"""!in_generic_B= (G, ProtocollHH+ (ClassVar, Final)Targ =`onvert|(%_`Alias)bXarg.__origin__ in  2raise TypeE(f"{arg}1 asP"in (Any, NoR_9OB, _S@Form) or,P  \(, |) (@call-^msg} Got!r:.100}.Rs 3objZ2"""ian objecUq-casings If8$wearter vers8Athanyqdefault;0.____, based o(Rmodulqualified nameuBch i@typiHy enoughuniquely identify $ aything elwe fall back(>  Bobj,'.ctNr Eai]A.__m__ == 'builtins'`-rd`obj.__-'!__k 2f'{#T#}.4!}'66...mie('...'s.Function$B97.__' def _collect_type_vars( s): """Collect all  variable contained ins order of@first appearance (lexicographic -). For example:: ;"_c}(T, List[S, T])) == !S)61"""tQ = []Pfor tsaif isinst(t, TypeVar) and t no6N6:a.Bnd(t} R(_GenericAlias, )g9Uextend([t .__parameters__ if]return tuple(O) def _check_gf(cls, Sc, elen-P corrBcoun2c of a O cls (internal helper).|This gives a nice error message@casePhmismatch?!ifQraiseET(f"{cls} is-Bass"$alen = len(1if !!=i Too {'many'7>6 else 'few'}c; f" actual {R}, expected {%}"deduplicate# Weed out strict )reserving the of each occurrence}2allxts = seti!ifD$1) <V6newG2o iny= $Y!x.removez6 = K9BsserD,*sImi_dups_flattmk"""An 6'Union creat substitu#: T )sWamongp,"n W2# F0O[`...], 2 Tp; Ap, _U .2F#s.p.__args__"-elVQ) > 0@p[0]wj 3[1:=e/se/"p)/(_t_literaPJ6vL:,s Varameters:  if isinstance(p, _LiteralGenericAlias): . params.extend(p.__args__)&Oelse41app4+return tuple(V0) _cleanups = [] def _tp_cache(func=None, /, *, typed=False"""Internal wru r =ing __getitem__ of gEs with a fallback toPorigiM|tion for non-hashable arguments.21"""decoratorKQed = Wools.lru)9Q8!.2nd(I.5r) .@^ sMpinner(*|, **kwd:trywd?)except TypeErrorKpass # All real e(s (not ungs) are raised belowtj#*!if@ is s`/ 9 Peval_(t, globalns, loc recursive_guard=frozenset()""""Evaluate alls ward references in the given" t qFor use|D andA see:`docstr1get_hints()L "uzto preventinfinite 4!onV`ve For2Refa, 't,)0t._c(_p a((_(, t!ev# ={+/(a)! a/5if b5= t"r.S ="(i4__,*_`.copy_(6 P cl _F6`"""Mix8ohibit sub*0ing __slots__ = ('__weakref__', __j_Ar__(selfif '_root'0in VP("Canh specialn7Ees")PImmutYPindicthat object shouldbe copied.    +deepcopy__(self, mecmo): Vreturn self # Internal indicator of special typing constructs. # See __doc__ instance attribute for@fic docs. class _SVForm(_Final, _root=True__slots__ = ('_name', 'q getitem') def __init__(#, "S#._$ ="A n!._+__&_E.mro_entriesWbases raise TypeError(f"Cannot sub3{I!r}"CreprUN'A.' +.oreduceAs5Ccall3, *args, **kwd'otiate "ucechecki8obj 0L2} c7be used with isS*()?^ k/cl k Sk@_tp_cache=parameter{20$ VyLiteral] cb(typedF@ >Any3"""}eRan unQained!.- Any is compatibleSevery*)PassumBo have all methods.- All values .bs)3AnyNote thatMthe above statements are true from #PpointHqview of|2!ic ers. At runtime,pshould / nK2or IH1"""!isWsubscriptableC1NoR functions5n Example:: 6timport #]stop() ->Z" PExcep~('no wayLBThisz is invalid in other posi6s, e.g., ``List[1]``Zwill faiV '8Cb4Vararameters): ) """Special type construct to mark class variables. 8 An annotation wrapped in C/ Var indicates that a given=attribute is intendedqbe used as ayA and=should not be set on instances ofp. Usage:: TStarship:Q stats:[Dict[str,]] = {} #A@0damj.R = 10V #Q6accepts onlys! cmfurther subscribedBNoteM!is'Kqitself,QFytwith isO() or issubP1()./1"""item = _;_check(parameters, f'{r)} asingle1.')Hreturn _GenericAlias(;0, (ds,)) @_Form def Final(x) :ing fE@ namo %er%re-assigned'overridde a53For exampleMAX_SIZE:q = 9000$  += 1 # Error reported b H`Connec sTIMEOUTo@[int*10<CFast@3or( 3ionX KATherno runtimeese propertijkkt_Unionk =!; [X, Y] means eiX'YTo define a u^,S e.g.Bint, str]. Details- The arguments mus 0oepat leas*e@- Noz.I3a sAcase+ isu1lacuk(D-s are flattened, 0[,`, floa=!o#a R vanishs=! #Kor actually uRedundant40skirL, =]`When comparI7, tP ordeo ignorZ9]pstr, int] #- You cannot subclass or instantiate a union. 2 use Optional[X] as a shorthand for U8[X, None]A1"""Iif parameters == ():fraise TypeError("C0takX of no types.")<iBt is6ce(dw, tuplef8 = *Mqmsg = "m [arg, ...]: each arg must b. Ur (__check(p, msg)Gp inv @_remove_dups_flatten2Jif lO1NHeturj1[0]/r_GenericAlias(self, @_SpecialForm def.|4"""!!. v5is equivalent to3 t)= NBP, f"{0} rR!reRingle}#()] @_Literal2n0ingmdefine lWes (a.k.a. valu#s)BThis=0can_@usedIPindict R>that the correspondingmvariable@func! h7OprovidedJp(or one0sev+2s): validate_simple(data: Any) -> P[True]: # always  s y |]eMODE =B'r', 'rbw"b'open_helper(file: str, mode: L2str o@'/some/pathj0r')aPasses :Uother;Btypo> @"er%y%be ed. At runtime, an arbitrary[is allowedfSargumseW, but^2mayGmpose restriIs# There is'' call beca7~sA arel#0s, l6g ma__sp66try+%b (pP p, _q_deduplq(list(_pB_and#f"))fexcept&aunhash{Bpass;r_as(self, parFameters) class ForwardRef(_Final, _root=True): """Internal wrapper to hold a foB reference.""" 9__slots__ = ('__+_arg__', @code8u%evaluated*>? iszument__') def __init__(self, arg, - if not isinstance(23str1%raise TypeError(f"o- must be a string -- got {arg!r}")2try[4 = compil"'_0'Aexcept Syntax P n expressionS. =d #3 %  = False+o = Non&})w*globalns, loc recursive_guard;if K in 5 Qeturn< Pdd__ or1 is ^4if )#H and= 5~6=,E= {}$/el_KFaE!= Etype_ =_icheck( 1val5__,U-),@s@ to >s.">r=*__: 8_,K | {b  eFr5_eqHothev",2vNotImple%ed(` i `AL == I&an &Hvalue__)  return self.__forward_arg__ == other :def __hash__(@!):V B)COreprC2f'FPRef({g L%!r})' class TypeVar(_Final, _Immutable, _root=True0"""0P vari#.rUsage:: U T =W'T') # Can be anythingA*A', str, bytes6@Must7bstr orf !s exist primarily for the benefit of static type~ checkers. They serve as8parametersKSgener=s$AwellFa!function defini aBSee oGJ2morpinforma.I on n5. 4]`s workufollowszcrepeat(x: T, n: int) -> List[T]tb '''R0a lAcontaining n references to x.'''R[x]*n q longesqA, y: A~Ax20twoOingsox if len(x) >= y) else yThe latter example's signature is essentiallyoverloadAof (1str~Qand ("->. Also not@thatarguments a~AnstaRrome sub1tr,b9still plain"yAt runtime, isi^p(x, T) $isa!(CwGQraiseSErrorM Sed with con+(rac@used6@decl@ ; E/qPEP 484) details. ByiJault<bIain allsintrospected. e.g.]T.__name$'Tconstraints!()" BFals*%ntK# "NA.___QNote z on6ype1ined in global scope pickled.2"""KR__slo4 ('', '__bound__ '&'5sdict__' __H , 7, *r!, _=None{z=U*, 1gname if covariant and contra7: raise ValueError("Bi) types are not supported.")Cuself.__o__ = bool(-15nstraintsbound isONone4Typ&Co@0canbe combined with T8=..{Vlen(cOo) == 1 pA singlrwallowedQpmsg = "Var(name,w, ...):s must be.."vsmptuple(__check(t, msg) for t in^ % _YA, "BaiOelseW :try/def_mod = sys._getframe(1).f_globals.get('__S__', '__main__') #picklingjexcept (AttributS,1) 4if != 'typing';KamoduleL3 def __repr__(,z0if   ^prefix = '+'P(el:/__>-> e~'sreturn + NduceA8 is_dunder(attr1p.starts!')B7end class _BaseGenericAlias(_Final, _root=Trueg"""The ce9l part of internal API.PThis 1ese" gb version8 'origin'Qargum7'params'.QTheretwo kindF`hese aes: user{ special.  Q onesTpwrapperQbuiltllectionBABCs.A.abcZ!seT`have '' always set. If 'inst'False, thenQ can'(antiated,VtS isd by e.g.Yring.LishR.Dict4""" <S_inito", yP, *, n , =6%! =,4! =; _e !Qslots u<1doc #edYcall__(self, *args, **kwargs): if not self._inst"raise TypeError(f" " {0name} canC0be @antiated; "eJ Tf"useI_origin__.__UQ__}()OUead")Iresult =7 (*2;tryC!._<_class__R6except Attribut HEpass0rreturn  def __mro_entries__(6h, baseres = []7',if"in; res.append_L72i =;a.index)dfor b ^j[i+1:]dRif isce(b, _BaseGenericAlias) or issubR$lUbreakJelseoE.jtuple(res)nugetattrj # We are careful copy and pickle.ja# Also$simplicity we just don't relay all dunder Bif 'i'd.__dict__x<B_is_B(0!, 3 V+s+W, val0?pUcheck7objO2Ptype(1 Z &=I, cl ,"Subscripted g-s.used with)!" O( $s") # Special typing constructs Union, Optional, L, CallableWTJ0 # sthree sSsinternal bookkeep$ofes: # * __@eter]Qis a  of unique fkm ,aQA # U,example, Dict[T, T].h== (T,);T reference toype that was s,{Re.g.,Fo0intqU"==,the non- version ofK.:__ Fargumentsde8ingR int). class _GenericAlias(_BaseGene-, _root=True): def __init__(self, origin, params, *, ins6, name=NonAEsuper().IC88=)x7if not is"Tance(sHtupla.4 = &I.__args__ = ?(... if a is _TypingEllipsis else^-()>Ompty;Pa forynE Beter_collect_type_vars9-Bamodule~4.__ &eqCtherNco"8, _E15return NotImplementedpZ2.__!= \48Cand 6)Chash(,`)O@_tp_cach#8sgetitemai$ifNCin (;, Protocol3# Can't subscript 2[...] or9.'raise TypeError(f"CanTNalready-@ed {W-}"]"s,K msg = "P;R to g s must be%."V check(p, msg)V>p iV_(_iQ, len1.__d$__t = dict(zip0Q)71newuU = [] rgh (ifAarg,(Va arWF[argl/elL(,U)E1sub{s = arg,+2 0sub!x]xAQ9Carg[K |.append(argHcopy_with(Y9$3Qs__class 8K ._Ai{c__reprMb2elfASQ = 't.' + self._name  belse: name = _type_repr(self.__origin__)/args = ", ".join([6a) for a in B06__]Areturn f'{v0}[{"A}]' cdef __reduce__)#ifW; = globals()[+]\'9/3 = tuple0.__pif len( ) == 1 and not isinstanceB[0],K;@, = {,operator.getitem, (,/);mro_entries@w, basesp G # generic version of an ABC or built-in classsuper().__y2xeR is G| if ProtocolMI "(^2i =a.index "bXn[i+1:]^(ifb, _BaseaAlias)bBG(4i,) # _nparamsZthe numberccepted !eters, e.g. 0|Hashable, # 1AList2 Dict. It may be -1 if vari8k' #dd are a|(needs custom __a__). & _Special/(A, _root=TrueEinitP, *, V7 , D=NonBq!if@ 12 = W0.__%__)tyt8Y3 = W&ifrmodule__,'`Jins'P@_doc(O f'A{p.__qualU__}.'vX/}.lm@_tp_cache,Q :&s%B = ( ,~0msgP75 to0`s must!.",Lcheck(p, msgp1,w_(_@ , 4copy_with*<H_c,P params,  name=self._ c, inst 0) <def __repr__(/!):return 'typing.' + "Q?subclasscheckHW, clsMPif isyance(cls, _SpecialGenericAlia2$isc:.__origin__,)nif notunc!super().__ )creduce"I1 R _Callable((_, _root=TrueT cassert8T == 'g'@1len.__args__),S2 and@[0] is EllipsisC&n$(fkIf'[[{", ".join([_type(a) for a in:-1]])}], M7f'{D -16'+!* =yL(Q)H?3... = list( [:!, 5-1]aBoperator.getitem, (K5)Y_Type(Xcopy_withx, parama?,  n" tuple) or k) != 2Paise BtError("n must be used as " 8[[arg, ...], result]."*# =|[# This relaxes what+@ canon purpose to allow things likeHPEP 612 P. Responsibilityl`whethet@userWusingI[0 pr ly*deferredpstatic  <Eers.F ; -A = (1)-CJelse9\x2W@inne5>$@_tp_cachM 2I}msg = "Callable[args, result]:  must be a type."  0= _r_check(e, msg)*if args is Ellipsis:Nreturn self.copy_with((_Typing4,)Znot isinstance(i, tuple)e2 = "C2(`onvert*P) for0 ins9params =4 + "8) class _TType(_SpecialGenericAlias, _root=Tru@_tp_cacheFdef __getitem__(G#, g#if[ == (_mpty,x oz| ,#rif len()S2 and0[1]56...0qmsg = "9[t, ...]: t5*p t;[0],;p,  T0, t1Oeach " =Qpp,B&eXUnionX((_fWU~^[u'] %eqWotherw;if "1, _N6NotImplementedu1set 0.__!__^gChashtp(frozenGF)GNreprG" = $2C![0qD(Non1f't=.Optional[{s[1])}]'A$elizi30isuper().__0__(u_value_andBiter"SetersFA((p,2(p)&/iLJ ^ _"pl xn ?,  hash__(self)3: For example, a@mappf might be defined as:: zM0"(G[KT, VT])fdef __getitem__J, key: KT) -> VT06".. s # Etc3Tcan then!usw follow~lookup_name(#: ,ault: VVar D%] c0allgMpif len(Q)) !=TbJelse|4# S8a regular1sub1 _C_(,sXo_uXAliasC)Tinit_"__(*`, **kw super().__9 4tvars = [if '__orig_@s__'!jdict__Ge% =6 in;.Dr@ and cls.__name__ != 'Protocol' if error:raise TypeE("Cannot inherit from plain Generic")Aif '__orig_bases__' in cls.__dict__ntvars = _collect_type_(5Lh# Look for[T1, ..., Tn].-If found, tmust be a subset of it6 :/is)Also checand reject,,(multiple;...gy = NoneIqm8 sif (isinstance(;3, _Alias) andd81.tin__ is)m52if 0is Q*. -[D Z]'s.@#= parameters__eet = set( ws%%!if2CRet <=J/et@s> = ', '.join(str(t)*Aif tZ$inR}Ps_arg RgRgt> pf"Some  variables ({y}) are"qF!f"`listed{/}]G Dgl = tuple class _TypingEmpty"""Internalceholdero() or []. Used by TU@Meta`P Callto allow ea /specificgs, without3ing themHPsneak7where prohibitedL""" llipsisc... (e/").L _TYPING_INTERNALS = ['__WC8!%, 4c:__'&d'_is_p!, vruntime] _SPECIAL_NAMEabstractmethodB_Uation?docp'__initdmodule4new Aslot[ a'__subDhook3tweakref _getitem__'] # These  al attributes will be not copllected as protocol members. EXCLUDED_ATTRIBUTES = _TYPING_INTERNALS + _SPECIAL_NAMES + ['_MutableMapping__marker'] def _get_t_attrs(cls): """Co v from aclass objects. @This includes names actually defined in the @dictionary,AwellJa?that appear:`annota3s. Speciali(above) are skipped.L1""" = set()for baseZ cls.__mro__[:-1]: # without4(!if70.__ __@3('P', 'Generic'Y5continueJ` = get(W, '__r__', {}L.}Alist60.__S__.keys()) + JKpif not Rp.starts('_abc_') and&?in  QUN`s.add( areturnLsis_callable_ W_only# PEP 544hibits using issubO!()"U!s ?have non-methodk4ll((Acls,, None)) u_L) no_init(self, *args, **kw qif type$d)._is_Nraise TypeErrorj1s c bstantiated'allow_reckless_&s_cheks(@"""A%0 inA!ce)q checksslstdlib moduleQe abc:functools$ indiscriminately h4 isq(] o)whole MRO of a user=, which may Y6ain 7tryO@sys.frame(3).f_globals[' ']^P['abc!']except (Attributb, Valu )GFor platformsU}) True _PROTO_WHITELIST = {z"'cPions.1: [D#'CLAAwai @Itere 0tor VAsyncJDHash1PSized.Containe;10ionReversible',F]'extlib': ['AbstractKextManagP r], } _pMeta(ABC!# Bmeta-Qis repunfortupexists n because of#@lack{$__bhook__dU1 __,Q # We ne%ed this method for situations where attributes are # assigned in __init__. if ((not getC(cls, '_is_protocol', False) or8_ )callable_members_onlyIm)) and4issubclass(instance.____, cls)):6return Tru if*. 5if all(hask,+r# All *ls* can be blocked by setting them to NoneRDZ(c,;)YC2 0is y))6! #b5get_s /;hsuper().Cucheck__A) # P:(Generic,a$=_CMeta"""Base "Aes. <P defiBas::'L1(3colo0defh(self) -> int#..~ISuchzprimarily used with static type "ers that recognizstructural subtypR(>Rduck-!),~exampleC009rfunc(x:9 x. &()@<C()) # Passes /See PEP 544details.x5colesdecorat\@.runtime_d~ act as si)-minded ' Q6P presence of given(Sp, ignorRtheirX@aturPg;gOthey1GenI?[T]T1"""__slots__ = (6<& =_99" =. 4it_ __V, *args, **kw C 9 4e# Determine ifEis a or a concreteL!if,cls.__dicOget( H5  = any(b isbi._bases__# Set (or override)raS hook def _proto_hook(other): if not cls.__dict__.get('_is_protocol', False<Greturn NotImplemented c# First, perform various sanity checks.4getattr(cls, runtimeif _allow_reckless_cla_heks(raise TypeError("Instance and g can only be used with"Z 4" @!Table 9s")A/@call,_members_|A"ZPMs non-method don't support issubm/()3isi_, typ# Same e message as forgz1, int) ' arg 1 musta!,')(fSecond)the actual structural compatibil> 7 in _get-_s 6@base6*.__mro__10# C@ if  appearsE Xionary..J0if 7|2 *[@] is None8<Zbreak'P# ..."n annotations,it a sub-:4 = _z__', {}Gif (7, collec.abc.Mapping) IMUN4H, Generico .|?els"FTruedif '__M-1__')in X6 72 = ptc# We haveWhing more to dofs(m o ... otherwi-se check consistency of bases, and prohibit instantiation. 1for/ in cls.__=5__:#*if not (+(object, Generic) or151.__module__<_PROTO_WHITELIST< ?nam:[^]issubclass$Fis_protocol)raise TypeError('P,s can only inherit from other'P'us, got %r' %)=init__ = _no_ 1  _AnnotatedAlias(_, _root=True"""Runtime represent=Dan aOq type. At its core 'q[t, dec12, ...]' is G b1theK2 'twith extramions. The a7behaves like a normalE2ing#, ngylxsame as0ng punderlyE, bindingL@t tod esJAalso5O31"""*Qdef _ __(self, origin, metadatalRif is4ce() 04G# =ZF[E__ +h2\4%__'super()."v u=uOPcopy_gparamsassert len(Q == 1A@new_2 = 5[0]mreturn4-, ) __U"typing.{}, {}]".fn%t(R2.__92__)%", ".join(1(a)a2 Oduceoperator.getitem, ,, N,) +5 #eq,C,3zNotImplemented} /Ns4V ^:P)__Chash(t){C`"""Addtext specificHparf0Exa%: Ir[int, r_check.UnsigneNd] indicates to the hypothetical runtime_check module that this type is an unsigned int. I`Every Lr consumer of :can ignorTis metadata and treat1"as_The first argument Annotated must be a valid!. ;Details:`- It'sPerrorFecall `L` with lessUn twovsP- Nesx6 are flattened:n#[ qT, Ann1!2]P3] ==[#"nstantiatinga tsequival)i1punderlyD7C|P1](5)DC(5) be used as a generich alias^Optimized .!1()]H[d[int-Dint, =>IListw?[T]@y}.G2"""9__slots__ = (Mdef __new__(cls, *arg0*kw %):raise TypeE (" 9!no Ced."j@_tp_cacyclass_getitemgparamsz0if Z"isY2ce(#, tuple) or lenV) < 2F B[...] shouldJ"= "at least3 (a{ nd J ?@ion)(jvmsg = "0t, 7: tq;.aorigin = _M[0], msg)=C)61:]%return _AP(i,Iinit_subT !"C  OE {}.".formatA.__m6&__@) @able2]"""Mark a protocol L:ESuch8)d$is"()RJ if appliedja non-8 Th@llow simple-minded structural H`similanZone trick ponie collections.abc spas Iter/{pFor exarQ@$^ class Closable(Protocol): def close(self): ... "assert isinstance(open('/some/file'),d)9Warning: this will check only the presence ofrequired methods,0notir type signatures!1"""0if * issubclass(cls, Generic) or cls._is_p raise TypeError('@runtime_>r can beapplied to M yAes,'` ' got %r' % cls))qPa= True$`return41 ast(typ, va"""Cast a uea7TJsU'unchanged. Tol!er}l;a LG haAe de(type, but atB we intentionally don't"anything (we wanl!is@ toAas fs possible). /_get_defaults(func"""Internal helpo extracy6 arguments, by name.o6tryJpcode = d0.__!__except Attributi8# Some built-inA sThave Q5, _r__, etck!{}wpos_count = q.co_arg!@arg_s!1var !-%[:Y]&^ __($kw)+ reVdict(V) if g else Poffset - len(qf 1ame:uV zip(?LE:], =!VRin re s[2] =) _allowed_ipes.Func,0s.B)inRlJ!.M<?aModule6WrapperDescriptor) G ))^]_hints(obj, globalns=None, locinclude_hvs=FalseRR R an objectis oftenpsame as'.__annotaNs"it handlforward refers encodedF0str`literaMpadds OpRPal[t]aT$` equal}@ is  anhcursively replaces allD"'APed[T,]' with 'T' (unless '9 %')e may be a module, class, method, or function. The annota s are returned as a di/ary. ForR8es,; include alsoHinherited members.  TypeError is raised if tprgumentnot of a type that can containJd an emptyKYif no1areKspresentBEWARE --behaviorglobalns and loc is counterintuitivU(unless youV familiar with how eval()Mexec() work). search orde1ts first,"n _1- I# aQs`passed+@ att*made to usg U from obj (orop respec module's-!), QthesejZ . object does cappearLtto havep Cused1oneio3 for botha{U:twoU ePthey +?ifyP,O1ly.l2"""fif getattr(obj, '__no__check__', None):91 {}0# Ces require aal treatmvif isinstancepj[thints =\n0ase in reversed<.__mro__>/@!is!Sbase_r = sys.h s[[w`__].__!__=OelseWan6cann = fZ.get('__kw9{})u name, valuann.items(k$if)&L=( u# 1_, strt/! =wardRef(T, is_.j=False=_=4,AC[(2] =#P_extras  {k: _strip1(t)@k, tC{}L{ Dl1s.Mj8Typc ? =  nsE/Jc# Find!!ns@unwrda2ect2while has\ wrapped__'):  nsobj = .__wrapped__ 'globalns = getattr(1R, '__s__', {})9aif loc7is None:]"= B!ns/el9 5Hhint1objannotation2if 5 # Return empty C for something that _could_ have them.if isinstance(_allowed_types)rw%{}B;els5raise TypeError('{!r} is not a module, class, Uod, 'R 'or func'.'.format)+adefaul`T_get_#ZJq= dict( :0name, value inuw.items($if#+> = 6( e)W, str\' = ForwardRef("Q_eval",,50if T and [] P = Opy1al[]QHA=' nclude_extras 4 {k: _strip_1(t)@k, tC} def7@"""STs rom a given1""" Rt, _AhedAlia .__origin__W|GenericU 0arg'otuple(da!a@t.__0n if\i#F == (&(t.copy_with((0rT03(tpa"""Geth unsubscripted version of ajaThis supports g!s, CallabT, Union, Literal, FinC71VarR.En"edg. Examples:: BnP[42])+1int#n B[intM.Generic) is Generic get_origin(G]) is *Union[T, int-+List[Tuple0BT]][4q== list31"""if isinstance(tp, _AnnotatedAlias):(ureturn Ac(_BaseD,)SCtp._$__W'tp `-None def csargs(tpn)"""Get type arguments with all substitutions performed. aPFor us, basic simplifica2used by  constructor arePIExamples:Dict[strD== ()B/Pint) $, W, strA(intD RD]]{?]KCallable[[], T((HQ,) + metadata\ #(_O 2s =T^P"if __acollec T.abc. and res[0]'not EllipsisU reo((0a:-1]),; /(1res#() 0no__check(arg`Decora`to inde that aGc hints&ThN must be a class or fun ; (t2, iapplies recursively toqmethods0Ses defined inQ(but $o :.its super2e3sub)Pis muUs the0(s)/@(es)aplace.}Aarg,srarg_attrarg.__dict__.copy(8f<t 0valn -gitems(W[9if ,bases__ + ,.2P.pop( 3obj{o.valueyR2obj3s.FOTypeiobj.____ = TrueW>aS MB(obj6try\J * wpexcept Error: # built-inl9pasyarg def no_type_check_decorator( ): """D to give another - the @no_typeT effect. GThis wraps+9with something that(!edEfunction inm. 2"""n@*Qools.t)1defe7ped*args, **kwdsM& =()R( (=)#preturn  0 _overload_dummyzHelper for @2raise when called.#NotImplementedError("You should notBD an a!ed6. "7A series of-5s5outside a stub module~always be followed; byiaH!is-)[KN%/3ods$Infile, place two or more`definis1Asame8a row, eachs1ed '. For exa:K nU Butf8(value: None) -> B: ..79Qbytes: ;return f # Some unconstrained~variables. TOcare usphe cont1r1fs. # (*not for ex.) T = TypeVar('T')"An9. KK $Ke V V QValuei. T_coc_co', coynt=TruevKs. VII# VK;LntraS QDitto#raInternal; #blP[]. Cvro5V, bound=)UA),fu`@withjt[ isresents strJRis one *is*R!) AnyStr', bytes,N)Various ABCs mimickg#hose in collections.abc. _alias = _SpecialGenericA` Hash!*(B"1, 0uRNot gD. Await@ #, 1) Coroutineq#, 3) AsyncIterf 'j9 to\  '9m"/c /1tor/pReversi/= $3_Sized0Ck#jC>o$34allC v iT, 2) .__doc__ = \4"""$; a[[int] ]2Qa fun)(int) ->*!. KThe subscrip syntax must always b,exactly twoAv s: argument li>!nd^ (FoBbe a;Pypes Sllipsis;M5TsinglQ4to indicate o alaukeyword!s,BEsuch> types are rJarely used as callback types. """ AbstractSet = _alias(collections.abc.Set, 1, name='3') Mutable@ $$, 1) # NOTE: Mapping is only covariant in the value$. -!5, 2(;Sequence5"B6 )=pByteStr$, 0) # Not generic # Tuple accepts A ble number of parameters. -1= _ `Type(t@, -1, inst=False'"')8.__doc__ = \@!;`[X, Y]cross-product'X and Y. FExample:@aT1, T2B!a 3 two elements correspondingD"to]As T1eCT2. Yint, float, strbDaof an &a(Ba-3ingTo specify anv-length@homo1ous,vT, ...]7Lis|2lism)@') Did,+9') /seaSet') Frozen3f93OViewRr% @Keys 2"/OItem0 #VJ2 $dContextManagerDlib.  + ') AsyncZ 0_ 'icPdict, 20DicpDefaultd!J7') OrderedE!ZCountXrhainMapCTG9atoVy#3, 3b6i(l=1V)C?ypeBAPal constr) usS to annotate class objectsRFor e>, suppose we have t he following classes::  User: ... # Abstract bas<r; 8PBasic=()C !0ProLTeam @ And a function that takes a argument'2sub!ofDY and returns an instance of the correspondU = TypeVar('U', bound=X)b def new_user(_:8[U]) -> U:.r%0 = ,(L# (Here wuld write2 object to a data@^Vjoe =)!ABais poiMe type checker knowsd I2has G.""" @runtime_>Qable  SupportsInt(Protocol)"""An ABC with one amethod __int__.e%__slots__ = (@54<Q(self2intyJOpassOFloa#f:&>Complex|"c<&@_Bytes"b:&>?Ind$i:&>"&Ab|o[T_co] abis covariant in its]$aRbr@"__2Cc, ndigits: 1= 0T_co: : pass def _make_nmtuple(name, types, module, defaults = ()): field[n for n, t in;]#F = {n: _ _check(t, f"f@ {n} annotation must be aG!")G  g} nm_tpl = collecI s.dp!s,2Q=  =x6.__es__ = _new__! screturn2 # attributes prohibited to se``NamedT class syntax _.= frozenset({'__', '__init__ Tslots getnewarg"'_JC _&'^'g5qreplace aasdict source'}) _specia  E 0PMeta({1): B(clsUP, bas#ns bassert[0] is _^R'bns.get(' R', {}A.<_w6[;a\:j%"ifA$*ns!% e.append([-DelifVQraise TypeError(f"Non-g |& {l9} "r 1f"ct followM?{'s' if len() > 1 else ''{L.joiK}+ =M  Zs.items()' s=[ns[n]`]H/r=ns['__ F__']# update0am user space without overriding 0key 3if `A e""Cfwrite ~7@ " +dTz!noFb0and. .0set((,;, ns[keyW iB,s=None, /, **kv0"""d`d vers !of{.PUsageldPython,s >= 3.6: class Employee(NamedTuple): name: strid: int This is equivalent to::K"Emf = collections.[ dtt$('#P', ['', 'id'])GThe resulting class has an extra __annota[__ attribute, giv5adict that maps field qs to types. (pare also inGQthe _!skPwhich part of (^a API.)AAlternative9keyword syntaxJvacceptedV Jy=str, id=intLIn Python vers <= 3.5 useb$[(pstr), (,")]1""""ifl*FNonegG= kwargs.items(?Celif1 raise TypeError("Either lisuQ3or Os " can be providedP, not both"6trymodule = sys._getframe(1).f_globals.get('__ ____main__'Q ex4 (Ab, ValumqBXreturn _make_nmOq,t", 9=F) _! =.__new__ vMeta, '+', (), {}) def _mro_entries(basescif lenF > 1? Mple inheritance with supportedqassert {0[0]'5+(F,) &(._O__ =2 _PdDict-(y SAcls,e,, ns, total=Trut"""Create new!d probject.}`methodcalled when!1subB1ed, </or)instantiated. _5way4 s all threeforms described in its docstring.NS)|0ces;jaactual@ionajJh1forhys!ifX)O  15 !'cpQ from(' ay% 'I'and a non-*:1tp_  l(+ ,)nCannotations = C{}  own_annotations = ns.get('___', {})8@_key<Kset(R.&():msg = "TypedDict('Name_f0: t0, f1: t1, ...}); each t must be a type"{@n: _2_check(tp, msg) for n, tp in fitems(1required( opG*alt@bases%s:.update(&.__dict__I K *'()M M *M yif total"  D{HJelseD D !tp.7 = . __ = frozen( k = =if not hasattr(LQ, '__MJ__') #.!" =xsreturn ) a__callP # sBc method&def __subclass__(cls, other!#  Ns are onlyYstructural subtyping.QraiseDqError('O_Q doessupport instance and  2s')$__# 0 h(d name, fields=None, /, *,S=True, **kwargs"""A simple d F space. At runtime it is ~valent to a plain7. creates aaionaryb that expects all of itsNs`0havq@certg0set+r, whereRkey 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, label='first') == dict(x=1, y=2, label='fir!4 The type info can be accessed via the Point2D.__annotations__aQ, andL *required_keys__&H opD$alfrozensets.L TypedDict supports two addi9 _valent forms::5 = H#('', x=intAstr)z@a{'x': =%'y H': str})By default, all P mustf@presFin a. It is possibleto override this by specifying totality;XUsage@clasQ(,8=False):ix yTmeans that a p"Lhave any ofHomitted.AyPpcheckeronly expected to a literal or True ae value ofP argument.-i-nd makesPitemspined inPB@body.C!esyntaxKPython 3.6+, whileQotherd=P work 712.7AA3.2+.1"""if fieldsvFNone= kwargs/Celif)QraiseuError("#! t ei! ayukeyword^"s,; " but not both"{ns = {'Q!':c(!)}6try`# Settcorrect module ne0ary7adS es pickleable.qns['__mI#__'] = sys._getframe(1).f_globals.get('__name__', ;bain__'Aexcept (AttributeV0, V mBpassGreturn _}PMeta(j, (), ns6) /! =.__new__(I5, 'Y'ME{}) .__mro_entrie= lambda bases: P,) def NewA(#tp3""" creates simple uniquqs with almost zeroqruntime^head.econsidered a sub'epFc _cs. At b,Y*a dummy funcr#y )E its-. yUserId =k' ',= ME_by_id(user_id: /@) ->V4#.. UserId('user') # Fails type check name_by_id(42)/ 43QUserI:)3'OKYSum = !a5) + 1A#Q: int2"""5def new_A(x):3return x'#1.__@_ = /PsuperL_"!tp K' # Python-version-specific alias ( 2: unicode;2 3: str) Text = P Constant that's True whening, but False here. TYPE_CHECKING = class IO(Generic[AnyStr]#3"""b base /@for IO and BinaryIO.EThis is an abstract, g_  of the rof open()CaNOTE: I does not distinguish betwehe different possiblePes (tBQvs. bp, read Qwrite /,=append-only, unbucd). TheC subsBbelow capturefctions which isEpervasive inD interface; however we curQly do+o! aDpway to kDSotherN^ system.<?q__slots"()A@pro+@amethodumode(self) ->{OpassKKGclosONone'MdOboolNffileno@?int?Flush>~fisatty@->1, nkQ = -1=M7abl!2linB, limit2UshWDList.CseekVRoffse,$ce0PvK0[M+Atellass @ab)stractmethod def truncate(self, size: int = None) ->:15Qpass ?@abSrwritablSAOboolB?, 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."""__slots__ = () RUnion , Rarrayqp 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+2re #! /usr/bin/env python3 # Copyright 1994 by Lance Ellinghouse&"athedral City, California Republic, United States Am?@a. #PAll R~s Reserved # Permis to use, copy, modify, and 0distribute this software and its # documentation for any purpos(Hwithout fee is hereby granted, # provided that the above copyright notice appear in all1ies9r # bothE;n_is permiss V # supporting,gname of Lance Ellinghouse # not be used pdvertisSor publicity@tain5to jPion #\pDspecific, written priWJ. # LANCE 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*OF8. # # Modified by Jack Jansen, CWI, July 1995: # - Use binascii module poactual line-by-p conver" # between BOPry. Tqresults 1000-fold speedup%1e CIUstill 5 times faster, ' ghQ- ArgWPs mor mpliant  python standard """Imple!ofrUUencodAUUde @funcBs. (in_file, out 0 [,,5e], *, backtick=False) N;& [=6, quiet])@ im\$os sys __all__ = ["Error", " t"] class #`(Excep): pass def :R=None RR"""UuM )1"""j#C If C`a pathb open itAchange defa5;&!edys]2try~ibf== '-' = sys.stdin.bufferK# elD0sin9&ce3str9'1if 0is # k!P= os.P.baseT)u-!ifFN 2mgEstat^@.st_ f4e 3 At+$ e = open(in_file, 'rb') popened_s.append(in)#3# Open out# if it is a pathname, &if2u== '-':O= sys.stdout.buffer) elmsinstance(5o, str)Q,/'w\Set defaults for and mod#zis None!ifJX0d = 0o666 3 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 x1"""b0Qinput#,iwneeded.,Q = []' m h(ing c/ b! =9/ ^ Z'trt# Read until a 0is 4 untered or we've exhaustedbO[H ;Tru2;hdr1((Gif not hdrraise Error('No validK` foundcPC_.startswith(b';)vcontinuhhdrfields =.split(b' ', 22)&30[0] Fint(GZ1], 8)Ubreakexcept ValueW{+Epass<^ b # If$ the filename isn't ASCII, what's up with that?!? @out_=% = hdrfields[2].rstrip(b' \t\r\n\f').decode("ascii")Iif os.path.exists([)):)}raise Error('Cannot overwrite @1ing: %s' % NM`if modZ Noneff= int(V1], 8#Ka# OpenJaoutput{ 2Z= '-'w = sys.stdout.bufferEelif isinstance)[, str.fp = open&F'wb'Pos.chmod% %5 fp?Qpenedvs.appenJD/QMain 6looQ' s W.readline(Pwhile s and + p != b'ende:tryvdata = bin.a2b_uu(sp&fexcept&^ 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 } {@ is ,v!mat unix-compatible%f(s, args) = $_Dpif len(V) > 2+2r.e`incorrect number,arguments rexit(1)Q# UseV ryeams underlybstdin/(in 0V[0] if len(args) > 1: output = A[1] if options.decode1FtextQif isinstance(\j, str)(,u = open,Q'wb')$7elsprint(sys.argv[0], ': cannot do -t to stdoutQ?9fexit(1m(input,  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 0in @dardimRstr(x'}'1getRraw 16 by!ofb!x. b'\x00\x0N1\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f' # make a UUID from a 16-byte string(>>> uuid.((bytes=x.)!''00010203-0405-0607-0809-0a0b0c0d0e0f') """ import os `sys fSenum xEnum __author__ = 'Ka-Ping Yee ' # The recognized platforms - known behaviors if sys.platform in ('win32', 'darwin'):_AIX = _LINU False else: L__system =.(B].= 4r= 'AIX'R ] = 'Linux' _MAC_DELIM = b':'OMITS_LEADING_ZEROES = 0if  A.WETrue RESERVED_NCS, RFC_4122, MICROSOFTFUTURE = ['reserved for NCS compatibility', 'specified@RFC f/',?MicrosoftE g future definition'] intt0int3^built-in Qtype * (* class Safe8csafe = 0#un#-1kt= None HD"""Instances of the  q0rep!nt_s as E.n9 objects are immutable, hash `and us O0dic8ary keysIpConvertiRto a _P with () yields someth/!in'12345678- q9abc'. constructor acceptsJfive possibled0ms:`imilarof hexadecimal digits, La tupleL`of six beger f(32-bit, T81andJ4 values reptively)^an argument named 'm'SKbof 16 v1allN8intin big-endian ordermH qR pj lyfirst thre'olittles o3_lersingle 12.?as !Rint'.`s haves#ad-only attributes:,| 15" (contain31six< zn 0_leCZ16-byte string (with time_low, omid, 2and"hi_version in little-endian byte order) FbfieldsS a tuple of the six integer 'OUUID which are also available asPdividual attributeswo derived/:+$ first 32 bits sB8mid> Bnext 16A{=Aclock_seq_FiariantA8 @0low9@ Cnode3 @olast 4A D ; Ba60-bitYstamp919!149sequence number4hex/ja 32-character hexadecimal stringCiiGsC1128~31urn/ 30URNspecifiedRFC 4122@v5(onconstants RESERVED_NCSy@RFC_g,,MICROSOFT, orgFUTURE1 s (1 through 5, meaningful onlyFAwhen4is }bis_saf} An enum indicating whetherIhas been generatea way that is efor multiprocessbAapplnons, viaMTuuid_s_1RA(3).02"""__slots__ = ('int', ' __weakref__'def __init__(self,a=None,s 3_le w 2int! /3*, P=Safer.unknown):5r"""Create a $ from eiado 32}fdigits+d@ytesAV's' argument, .  M:_leP7sixJQs (32&16 {B+, _low, 48-bit node) as 'the 'fields' argument, or a single 128-bit integer as 6Eint'H;p. When>tring of hex digits is given, curly braces,G*hyphens, and a URN prefix are all optional. For example,%seHexpressions6y$ 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 ''U must "be@. T#0verN$B; if/ resultingOb will have qvariant^ 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`, via B_SQ_timeE(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 =&_lF, 160"if!_l"_l/16v\a 16-charbA = ( _le[4-1::-1] +P[6-1: @@8-1:0,C>8:]Q if len(bytes) != 16: raise ValueError('0 is not a 16-char string')Bassert isinstancen!, E_), repr :int = int_.from_1)>order='bitif fieldsJNonei'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) |9;2 &oA< 64@T4 ifAQ/12U0/isT/12U3if 1]-O<= 5uillegaleknumberE# Set the v to RFC 4122.&= ~(0xc000h #e|= 0x8! n0ifH&64 %|=U<< 76jobject.__setattr__(self, 'int',N-`s_safe1 !) cdef __getstate])Qd = {k : xQ.int}: if self.is_s afe != SafeUUID.unknown: `# is_s+Eis a- instance. Return just its value, so thatN%t can be un-pickled in older Python versions withoutw.N3d[''] = self...r!d def __setstate__(:!, )qobject.*Eattr)S'int'0[ !])Y81rwas add3.7; it Flso omitted when""L%',,| (- 25if W=V else)P%eq!WotherJTif is2( , t${.int == - %NotImplemente# Q. What's the of being able to sort!s?V# A. Use4m as keys a B-Tree or similar mapping./lt><g?>!lU %< ?>"Chash$  T$in6&4rep1'%s(%r)' % n__class__.__name__r)9set.,_haise TypeError(' s are immut'_]Nhex = '%032x*>G'%s-+($hex[:8], C8:12 T12:16 C6:20 C20:]@propertyQTRbytes"*B.to_(16, 'bigP<_leS@ n([4-1::-1] + @6-1:@8-1:-1] +  bytes[8:]) @propertydef fields(self):(qreturn .time_low, &8midhi_version,DH5clock_seq_+cariantAdOnodepint >> 96E?midE.F80) & 0xffffP @W/64W\8E\ $56\Z?lowS/48S TJ(='W0fff) << b|@90mid(W32) |?low-G6(3>8) k: Fkdh?hexK'%032x' %?intD?urnDurn:uuid:' + str(Iveif not & (0x8000'48$pRESERVED_NCS/elL4L FC_4122H 2H MICROSOFTR&se4oFUTURE;`Ic# The P bits are only meaningful for RFC u UUIDs."ifz0 ==+h3intD>> 7@@) (_get_command_stdout(s, *argsimport io, os, shutil, subprocess6trypath_dirs = os.environ.get('PATH'L@.def)).split(os.Esep)I.extend(['/sbin', '/usr ]1executable =f.whichT=m`.join(i)L7if Oois Non # LC_ALL=C to ensure English outpu*tderr=DEVNULL)sprevent" # on 'stderr (Note: we don't have an example where the words)search # for are actually localized, but inAory some system could do so.)Nenv = dict(os.environ['LC_ALL'] = 'C';proc = sub ess.Popen((executable,) + args,6 xstdout=N?IPE88err8DEVNULL;venv=envpif not :return None#, =7.communicate(Y@io.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[ is universP(0) #Ply (1ministered. Network cafrom hardwPmanufrers will # always bek&adV to guarantee global-tqueness0MACO> any particular machine mayointerfac 0ich" #8ly F. AT`latter-ubridge UQ to #ZTouch Bar on MacBook Pros. # # This@Ps outbBA42ndcounting [@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_C(macD & (1 << 41)) ;find_mac_near_key(7Band,- ps, get_"c_indexhA"""SSes a <'2put  l$ aW!. `Each l#ofn:GHis case-insensitively  edgH1Tgivengs. Upon a matchqinvokedHto pick a", [ Z . EH, lambda i: 0 w1getBUTRbBwhil<[i - 1@:dprecedG.1"""stdout = _get_command_stdout(, args) if  is None:areturn first_local_mac =,for line inPHqwords = .lower().rstrip().split(JiGrange(len(A&))R(1if 0[i].1key %)>try0# =F@get__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 should 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').PHN?by  q@part8 0if *f) != 6|COMITS_LEADING_ZEROES1# (Only) on AIX theC 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')U S_) == 4  (hexstr, 16)  except ValueError: %return def _find_mac_under_heading(command, args, )F """Looks for a MAC address F$ a1c in a M's output. The first line of words43the, is searchedpQgivenD1. W;0at AsameM index as-asubsequentGPs are(n examined to see ify look like1es.D1"""stdout = _get__ X)02if BNonee 32key$=4P.read().rstrip().split(^6tryPrcolumn_$= N.(8A`_localK" ="t B 7! =(s[]O#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 0ip_$# =".gethostbyname(7)+OS # Try gett| from arp basedN on our IP address (Solaris). mac = _find_mac_near_keyword('arp', '-an', [os.fsencode(ip_R)], lambda i: -1)U ifX: e`return # This worksqOpenBSD:/i+$Linux, FreeBSD and Net-'(%s)' % i>$R2i+2S2# RENone instead of 0sZ= def _lanscan_getnode()"""Get the hardware;on Unix by running FA."""QmightRHP-UXpOti', [b'lan0'g#0)netstat,F 1AIX Tru64 UNIunder_heading('f iaP2b'A'ipconfig[DEPRECATED]  wWindowsbpo-40501: UuidCreateSequential() is nowonly supported approachfwindllFbiosRP # Im" optional C extension at toplevel, to help disablit when testing tryiTQ_uuid?_generate_time_safe = getattr((>, "%0", _= 51has`.$s except'RError:! = 6|(eload_system_funcs kPlatform-specific 3 I#t iOunix{  us@Iemodule?if X8*0, _(-UUID(bytes=uuid_ time).node def _windll_get%(): """Get the hardware address on Windows using& _uuid extension module."""Pif _UuidCreatedh6_bytes ="!()7#return UUID(*F_le=8 orandom"a  5 ID"# RFC 4122, $4.1.6 says "For systems with no IEEE $, TQly or# pseudo-mly generated value may be used; see Sect44.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, PtargeLfor a specI0 OSplatform. #H is by 'common practice'%D8ed ?Note: 'posix' and '+Hows'prefixedga dll/dlload() method # whichsuccessful, means noneIpthese "HSrnal"@sg`called ka(also)OAtest0.py3SkipUnless(), e.g., #X` @unit/&.s$;0_if,$igK_P...) RLINUXt = [_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( +F#ntkQ|]Ex1 _S= Non the hardwarfe address as a 48-bit positive integer. The first time this runs, it may launch a separate program, which could L&be quite slow. If all attempts to obtain the hardwarfail, wechoose a randomnumber with its eighth 0setb1recommendein RFC 4122._1"""global _nodx"if is not None:+breturn"@ for getter in _GETTERS + [_@_get^]F6try W# =I%()pjexcept-rcontinu>Bif (B) and (0 <= < (1 << 48))R Rassert False, '2() 2 ed invalid value: {}'.format) _last_^qstamp =T def uuid1(=i, clock_seqq"""Gene}a UUID from a host ID, sequence !,fbcurren@If 'r'`given,} ()@usedNb'TP%itI!as ;Jxotherwi!14 /Npchosen.=R# WheO`system@videversion-13gCor, use it (but don'tMUuidCreate here 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 ^ &if 0 =@.get%bits(14) # insteadstable storagC_lowa & 0xfff time_mid = (timestamp >> 32) & 0xffff _hi_version1"48101clock_seq_low = XV[`ariant[Z3if node is None:HP= get !()return UUID(fields=,3mid ,=V ,X3), , =1) def uuid3(namespace, )"""Generate a from the MD5 hash of a5@&3andA."""91lib import md5PdigesdAmd5(T.bytes + , "utf-8")usedforsecurity=FalseN").bS=V[:16]"3"/4(arandom^Bos.u*7(164a5_SHA-1.Asha1&0 = | XS V 5) # The following standardI@s arr use withA) or 5(). NAMESPACE_DNS =<('6ba7b810-9dad-11d1-80b4-00c04fd430c8')=4> """Python part|warnings subsystem gsys __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 &hed?way0t_|ylfile = msg.file if file is None:= sys.stderr37#2U when run with pythonw.exo<warnings get lostu areturntext = _format7msg(msg)*ryp.write(7"except OSError-R# the(probably )invalid - this z0ings.pass defQ_implvcategory = msg..__name__Qs = f"{"!}:lineno}: {; )message}\n" F!ifc2 t4pimport .QcacheC& =@.get.,o"now;{E2ion0# W.a[iYgged durlP@ shutdown, Q# and machinery don't work anymor R ! =-7els# "!if<v.strip(s += " %s\n" %: Qsourc1notYtracemalloch@LoggPkpshould Yraise a new  # catch ,6aonly I8XRecursion!WCsuggest to enable Ait's}Pavail"H.Z= Tru(tb- ? E@.is_7ing/yh0?get_objectGQeback9>' "3  .O9%>;YPif tbqY !'O ated at (most recent call last):\n']tfor frame in tb_!cP(' FB"%s"6!noi N11% (WBno))- i6@i ./'6ce/gC  line = None except EMion:"*B 0if 9 !.strip()a`s += 'kq%s\n' %T+elif not tracingm=(f'{category}: Enable0 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 Jta file;kyou like."""2tryK+sw|NameError/ApassEFelseif sw is(]#'s.9() #*@call3(sw !raise Typ#(" fmust be s Bo a C"or method") 3 sw.message, msg.3nam9no,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>TRa sub$"ofA?)re}  y8n_Aeger number, 0 ees allq 'append$' -- if true, append to the list of filters """assert action in ("error", "ignore `always pdefault module",HT p"once")Hcnvalide: %r" % (t!,)@isinstance(message, strF must be a9ing@category, typeBC[classB1sub(0, WarningE 9 P1?strlineno, int) and  >= 0, \F"+t*!" )4if P2or :Cimport re-#>= re.compilBre.IOelse6ANonep & [T1 = STR_add_f&, ,I6==) def simpleLC=C%=0EbFalse)R"""IngP` entry whsA (atrfront).AF matches alls!!s.'p)0one/2or ce!a G3 thk2 ofA?Aeger number, 0T'? /;vV FT*item# Remove possible dupli!, so new @willaplaced #correct C. IfQ=TrueXexists, do nothing if9 6try O1s.r(qexcept ValueE" <2pas,IiF(0, L !if$in [N_filters_mut'ated() def resetwarnings(): """Clear the list of % filters, so that no are active."""L/[:] = []_D_mutclass _OptionError(Exce used by o" processing helperspass # H4 to-3 -W? s %ed via sys.Zs'_`S(argsfor arg insBF6try B_setA@) e z as msg@print("Invalid ignored:",5, e=wstderr) ) {pparts =.split(':'qif len("R) > 52Yraise("too many fields (max 5): %r" % ",)ZXwhile]<]q.append('uon, message, category, module, linenos.strip(n?s|r = _get (a"( &$if3 orRimport re5," = re.escape(a 4 3) + r'\Z'o=: !0 =  w[/6< 0I3QValuey(, Overflow*,I H#"i2r,)) from Non^Felse&A = 01x n =aif notV"oneturn "defaultl#if( == "all": r)always" # Alias#('HB', '* X E @oncee'}}0.st1Dwitha Yc!SGYbKWaif '.'{%inN3builtins9Pk=7 WQ\, _, . .r]iF('.'G umS_4__(T,1, [^]) except ImportError: raise _Option ("invalid module name: %r" % (m,)) from NoneP6tryYcat = getattr(m, klass))0excAttributet; unknown warning categoryif not issubcr(cat, WJ)x x`return def _is_internal_frame(y"""Signal whether the "t is an = CPython implementa detail."""@file" =F.f_code.co_(!'ilib' in # and '_bootstrapnext_ex AFind, that doesn't involve+s4AbackGwhil+v d&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_ 4i BValuG +globals = sys.__dict__ filename = "sys"lineno = 1Qelse: 9globals = frame.f_"X#code.co_,k* `if '__s__' in iPmodul[0]C m/"registry =c.setdefault("__warning(__", {})c_explicit(message, category, ", ", $, P,I], source) def m[V=NoneC)r = int(  #if@ is t0mJior ") # Quick test for common casehn7keyareturn)# Search theV@itemM0filaction, msg@, ln1temBif ((msg"0 or5a.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 XerrorDaise-0s# Other :oncr@[keyi)-0if &)( Mreturn onceregistry[ key] = 1 elif action == "always":!Apass *gmodule*e aD altkey = (text, category, 0)\%4if BR.get(5)%ereturn41[-defaultFelser# Unrecognized's are erroraise RuntimeE( ? "K (%r) in warnings.filters:\n %s" %E(r, item)<# Print message and conj>rmsg = WbM%(- filename, lineno, sourcefP_showmsg(msg) classZobject): }_WARNING_DETAILS"}D", "    !",MI "*("")xdef __init__(self,  n_=Nonerj h.$ =q% = !4 = !Cno = 3: 64 8# = __!._U__ if > >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 isi`y an arnative .!4d '2'Cimported und#)iis only useful when testing the warnings module itself. """ def __init__(!, *, record=False,Aq=None):?CSpecify whether to:}and if an alternativeRKshould be used oMhan sys.m4s['#']8For compatibility with Python 3.0, please consider all arguments to be Kkeyword-onlyf0&"._## =e_/ =$0is ZN elsMentered = Creprargs = []8if /.append("~=True")@?not_@c=%r" %lname = type@).__%__return "%s(%s)K(", ", ".join(()),G- *edraise RuntimeError("Can0 %r twicec!._&S fi . - \-&[: M_!_mutated(Cshow[Ul msg_impl:_!@pj o:log Yc = logf8# Reset 2Ping()default e Pationmake surMXthat () callsd< 5ing_orig&lo4 A%R xexc_info30if  Z 0xit zAout @ing firstd -(e]"   # Private utxAfuncDed by _PyErr_WarnUnawaitedCoroutine |z$_u$_c( @line)[ f"#K '{coro.__qualname__}' was never awaited\n" ]if coro.cr_origin is not None:#- import linecache, traceback$`def ex6t();?for file,Fno, funcP in rJsed( HL! =E@.get(a)7myield )9@msg_\*s.append("Coroutine created at (most recent call last)\n"K6 +==.format_list(B)<msg = "".join().rstrip("f # Passing source= here means that if the user hs to haveamalloc8p# enabl!ndk[wTF c,aAwarn-3illMrcontain$<. This doesye*both*F~JQ*and*ey'll get twoKpartially-redundant?s. If we wanto be clTcouldIrobably detect tcase and avoid it, but 0nowC`don't 1er.K6, category=RuntimeWPp, stackDl=2,P) #cSters ms a sequence of 5-tuples # The components$!6 are: # - an action: error, ignore, always, default, module, or once ?diLRregexmust match4emessag9lass representU+ )gPis beGO#edEq numberp,1ing0>`A any #9deitheroasW^,anything. try8`from _Sings ~3, _p, _onceregistry,NT , p_explic@_filY@_mutz d+ =uew"!s = True except IYEVB = [ "rb = {} xversion = 1 uglobal #AVP [QFalseM@ iniy0izaR _processop`s(sys.A) if]00# Sal warning cateNgories are ignored by default in regular builds if not hasattr(sys, 'gettotalrefcount'): -filterwarnings("_ ", category=DeprecationW(,l?  module="__main__", append=1)4bsimpley"("p F PendingM dImportA ResourceCd del __s """Stuff to parse WAVE files. Usage. Reaf = wave.open(8, 'r') whereI is either the name of a`or an >pointer. The@ muszve methods read(), seekand close(). Whenvsetpos() rewind()DSused,0N e necessary. 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?thePaboveb Dordegetmarkerz_None (foratibilitytBifc hhA(id)8h0aisan error si$*P doesNg_exist . aP (nPat most n !\aZ0$Pbegin:>s streamEo0pos~ECspecified posi8Atell}F|current53m4(make it unusable) The position returned by tell() and the$given to setpos() are compatible2have nothing,qdo withJfactualQ in file. The close() method is called automati@y wh0ass instance is destroyed. WritPWAVE eAs: f = wave.open(, 'w') where,}`either name of a`or an >rpointer a must s write(),m`, seekCand s. Thissr cl_`followcpublicGsetnchannels(n) --PumberV!*setsampwidth41le .framerate. ,n !2mPtype(,)6@ress9?the: human-reada A9arams(tuple Pall p/eters at ot   current6aoutput{P.raw(data.r audio 5out patc up_ 6s header%VO o} z a"--20 JYou should`beforeNb firstwraw or 0. utotal n^/P does%P need& besR, but it0setcorrect value,}MaRto beed up. IK1besLY , perhapsiPsiblyd ,Yt E us~`raw. W.n AbeenCSten, je+P(b'')Z ()  $@size,1pL\J$ """ from chunk import C PollecJs2d 0p$opbuiltinsestructys __all__ = ["W", "Error PWave_ zB"] *`(Excep) pass WAVE_#FORMAT_PCM = 0x0001 _array_fmts = None, 'b', 'h',i' _wave_param*namedtuple('O', 'nchannels sampwidth framerate n s comptype d') class WQread:b """Variables used in this /!: &uThese v)are avail8p to the>r though appropriateAmethods of]_file --DQopen 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-~cusoundposuPposite_treamkEtell+,  Cesetpos/ternally onlyDp_chunk_+@1 ifae FMT  has been %`_data_v_needed;ed correctly=01forYRsa-- instantia_Cof a C4BDATAi_S!izsbof oney602"""F@def ~fp(self,)4._convert7B;= 0p@ = Cx( , bigendian 2if k&.ame() != b'RIFF'{raise Error('4 does not start 9O id'h#(4fOWAVEf \ a &%U(mtbJ. wh`1V55= 18 "tr chunk = C(self._file, bigendian = 0) except EOFError:(Ybreakhbname =t@.get(["if == b'fmt 'cread_fmt_`( Q,'_6I = 1.el|Odata|if not Waraise - ('U before '4@ dtnframes&.Wtsize //"?izeClseek_needed +W.skip*7 orFu B :( and/or 6Kmissing') def __init__F, f)[-i_opened_thef = Nonif isinstance(f, strFwf = builtins.O';'rbqfK # else, assume it is an V  object aly96tryJnFfp(fT +#if  (Wwf.closev3delu,?^enter/areturn['ex_*argsc #i# User visible methods.Qgetfp+Slrewind1__Cm#psoundpo0U!"~ =&-._!if? V 5 c@gV1Ltell 0channels; n& <: $ 8sampwidth: & <OOrate< & <comptyp; % :u :% :_param]_wave_params(self.getnchannels(), selfsampwidth(), ,framerateAnT? ycomptyp>name()) @def getmarkers({!):return None/,H, id0aise Error('no W's'kRsetpogW, pos< ifq < 0 or >6_kposition not in range')._soundpos =_ data_seek_needed = 1CreadyL#, ,._J $`chunk.tV(0, 0.*5ize3B oEs=posu* 0i$ifZ == 0n05b''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' % (, _^T# of 3@size_ )<2F = 'NONE R = 'not compre(ssed' class Wave_write: """Variables used in this 0!: &uThese v)0are-`r sett< through appropriate methodsB)ofV{_file -- the open Dwith; (), close @tellaseek()\M5setV__init__()R0_comptyp}pAIFF-C ression p('NONE'#n 0setC;A() ooparams5namhuman-readLl ~nchannels|number of audio qK sampwidthrbytes per|+/lez(Sz `framerh8ling frequencylEl n(Vaten tooheader]Bternally only_dataleng@size< 0!es_iUAactu)C2"""Edef self, f)0`lf._i_jbed_theV= Nonrif isinstance(f, strFJf = builtins.O'J'wb'!qfK#tr 5Ffp(fPfexcept+1if . (,#f.AzVraise=wU,.1Iconvert N'K = 09a:8v6V; ;=8FalB__del__( =^enter/areturnA__ex\, *argsc # # U ser visible methods. #def setnchannels(self, !):'1i*lf._datawritten"raise Error('cannot Yge parameters after starting to M8e')jO < 1fbad # ofhG&._J= lg Hhnumber At{return Vsetsampwidth CQF or ?> 4,1le & =U g  ^H$ ,@setfCrate Q_ <= 0-  = int(round(&))g >$ * Tgn3 = j= $6ten?setcomptyp} , GnameTZin ('NONE', unsupportedression H a=,$Vy" " <g< |E\]O %t1set z,!, ,B " =Rsawritten:  2raise Error('cannot change parameters after starting to write') Jself.setn=Unels( )%sampwidth( %f~Urate( %n#s(!comptype( , aname) qdef get s(!):0if %._7 or NR q\8allk7setWreturn _wave_", , 03.) &qsetmark$, id, pos, & 3)0upported'| V~ K0no (s<-er9FNoneAtelldbD6ten9ePAsrawCg, dataI+isinstance(!, (bytes, garray)5' = memoryview9).cast('Bensure_header_rten(len85 = A // %._0$ *C#ifvconvert"rAo!= 1 and sys.order == 'big'cqaudioop/Pswap(5[Pfile.! DWten +%FG*= #+ 6t 3`X\?length !>:ten5Xb_patch&(pQclose:tryCyD b0+N:m $v.flush(kfinall01 = &NH gi_opened_the_ 30if # =oHE.#h# Internal methods.h_ssize): if not self._headerwritten: 'if(nchannels$/raise Error('# )=pecified')\sampwidth\ (1le +^framerate^@ing ,_ :4e@(datasize) Ydef _!4, initlength)bassertrPgBq._file.Zw(b'RIFFY  Dn' =S // (*%yv+# =,]<9 N6tryBorm__E_poscVtell(except (AttributeA, OS o` ENonemqstruct.pack(' w = TrueRpatch$,VGRTten =8 ereturnE?cur   Aseek+._z6, 02+e(;', '=tenA vvEqb?ZBR open(f, mode=!if@ is if hasattr7'8'4P = f. ;elsq = 'rb'&tqn ('r',\ Wave_read(f)el:w:$wb return Wave_write(f) else: raise Error("mode must be 'r', 'rb`w', or 'wb'") """Weak reference support for Python. This module is an implementation of PEP 205: http://www.pBorg/dev/peps`-0205/~ # Naming convenO : Variables named "wr" are wobjects; # they#called tpinstead"ref" to avoidX collisions withFp-globalp() func0 imed from _iref. '" (3get)lcount,s3ref Sproxy @Call PCType R$_remove_dead)4set Set, _IterarGuard _3e s_abc # Ie afterjcirculard.K4sys itertools Us = (-, ) __all__ = [1, "9K", "t #s"D9! QKeyDi0ary/ P > -sYXValuec4Set-`Methodfinalize"] .Set.register(fNSet)'0MutC.p class >wR(ref)Z1"""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=None2try Qobj =5.__self__X!!except Attribute `("argument should [bnot {}.format($(.2)))gcb(argQ`# The - trick is needtQcreatVqcMRcycle\! =cB_wr(!if. 4 = = Falser$%if0ot M-(Z =.Gobj, _cb*.4((meth_type = type(meth) self._alive = True_wr = ref()7preturn  1def __call__,:gobj = super().&N@func" _r 0if Dis None or % im) .__ E,Z)#eq, other)`if isinstance(, WeakMethod*aif not$b!or:^4-!mref.__C anduK2 ==$._QnNotImplemented/ne{T 3/ !"__hash__. class ValueDictionary(_colles_abc.MutableMapping63""" K@thatzerences 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,@ref=), _atomic_&2al= pe_dead_ 7refQU:MIF!iffXH&%._iterating$Mj._pending@als.Ind(wr.key6OelseP1# A ecessary+Athis^TP# caned asynchronously by//GC= p|.data, ; U# A list of keysb"be%ed'E C[ = []$&t(YDZ = {}7update(other, **kw) def _commit_removals(self): $@l = ._pending*#d#Edata+# We shouldn't encounter any KeyError, because this method6Jalways be called *before* mutating the dict.7vwhile lkey = l.pop()+e_dead_weakref(d, key/_getitem__* d/if.#mR {oSW[key]if o is NoneWUraise](o" % *__class__.__name__, id)Bs w, valuek4GE =$aedRef(q,fBcopyR4new = WeakVDictionarywith _IteraCGuarO0forr, wr in.'s(U.M'wrk9 i"4newOoR2newA __?P__ = PP_deepag, memoAfrom5 import 1m:$BO] = |1get,ault=None):  if self._pending_removals: $ecommit#%()$:try1Bwr =Zdata[key]-except KeyError9return default4:lse)go = wrif o is Non/ # This should only happeng&e1!o Kdef items(9)o4with _IterationGuardkfor k, wr in.,vT@if vX?not\&Pyieldqv?key!ifY__iter__ =  rvalueref B"""R an3rator that N s the weak references toV"s.k8The'@are guaranteed:be 'live' atGAtimeCPthey 9rused, sjresult of calling9VneedsEo be checked before be8W". 0can(UavoidDPcreat2fwill causegarbage collec>oEAkeep&+ around longeg n 'edE5"""@\W from"()R\o YZ?obj\!is6obj 0pop 5hile TruK1keyT. rhR1pop,aw, *argskelf._commit_removals() Etry: o = self.data.pop(key)2except KeyError>ENoneSif o is  +zif argsareturn5[0]JOelse1Eaise62_!o $def setdefault(s, key, =)u1 _[key]-C._pending_ (ecommit'$ ==cedRef(,@e4BF/KocupdatekQotherd, /, **kwqi/lf  d?nothasattr(, "items"!r = dict. 92for`Qo in ..M(Mdo ]K^Z*%valuerefsC"""R list of weak references to the D"s.z-8The'@are mguaranteed:be 'live' atG6timaPthey 9rused, sjQresulqcalling9Qneedsto be checked before be8W. This can(UavoidDPcreat2fthat will causegarbage collector toEAkeep&+ around longer than 'edE5"""@-4r 2())q__ior__%, b"NMif isinstanceZ3, _Fions_abc.MappingcKcopy /c.8c`NotImplementedrM__class__ c.update(self) return cNotImplemented class KeyedRef(ref):5:"""Specialized reference that includes a key corresponding to the value. NThis is used in PWeakV$Dictionary;avoid havKacreateFQa fun, object for eachFstor_mapping. A sharedDcallbackB0can'key' attribute of ar insteaFpof gettafrom an enclos)SscopeA""" __slots__ = "key",def __new__(type, ob, , =.5"/.=HF$ainit__e uper().__3)m6Keyq(_colles_abc.MutableMC"""  ss weaklyhtEntriessdjwill be discarded whe re!nolonger a strongc!. J beM2d t>associate addil data withowned by other parts ofan applicaA:1outR&ngs=SthosesD"es ly1fulN0overrideZBaccesses.: , eS=None[.A= {}C>remove(k, %qref=refn)A. $ ='(!if t %p._itera$,jA._pe_`als.ap*(kz1OelseK1del5[k]d\e# A listAdeadrefs (key2be >dU5ingL = [yRtNDdirty_len = Fals!ifjApupdate( )Necommit:# NOTE: We don't neeN tFmethod before mutm,Cbecause a C never compares equal=da livejIpeven ife1y h}<E$,P# Howo, it meanmay alreadQtve beend@l-lfs d = self.data while l::trydel d[l.pop()]0except KeyError<Qpass 3def _scrub_removals()5/d %._pending< = [k for k in%"ifdOdirty_len = False_delitem__W, keyAATrue.#nP[ref(?]`?get`SreturD3len#if 3and Bx#& may still contains which werGexplicitly ed, we have to  them (see issue #21173).FLF 3)#(1lenE) -  )NreprBU"<%s at %#x>" % lf.__class__.__name__, id~)\sw, value,7B)] =4Bcopyo new = WeakKeyDictionary()with _IteraCGuarFpM#eyV.'s(10o =oif o is not Nonem"Vnew[o2new __P__ = SP_deepg, memoAfrom5 import 1JC@(h P;1getM, default=?: 7,5 (s dTwr = R[OType\1)wr,/wrkey = wrM/ey Pyieldbz=keyBtionGuard(seglf): for wr in self.data!,obj = wr()<0if is not None?(Pyield+ C__iter__ = keysdef values(with _IterationGuard$f,F w.items(T0!if mkeyref"""Return a list of weak references to the.Q8The%1areZguaranteed8be 'live' atEAtimeYCPthey 9rused, shQresulqcalling9VneedsEo be checked before be8W. This can(UavoidDPcreat2fthat will causegarbage collector toEAkeep&) around longer than 'edC5""">r1)op0pop._dirty_len = TrubQwhile 4key}=Q.e ?o UQ oj ,T, *argsW(ref(key)Nmsetdefaultt= { \>c,0_remove),JcupdatenAdictf, /, **kw'd 0if :a!ifohasattr(-0, "#'s"g = type({})0 !in/d[2] =Mlen(1!s__ior__JWother;rNMif isinstance(O3, _ions_abc.MappingcKcopy&#c.S rcNotImplementedrM__class__# v finalize: ) """Class for finalization of weakrefable objects ) e(obj, func, *args, **kw ) returns a callEa!erFS which will be,ped whent is garbage collected. TheCfirst time ther7ved it evaluates(I5andJresult. After thisadead, andBo0ingpEjustNRNone.7W^ program exits any remain@$t at3 attributeEtrue?run in reverse order1cre.By default R2rue2"""2# FE don't havePstatebtheir own. By ar!#  used as keys to lookup _Info^ registryK!is# ensure aty cannot7@parta ref-cyclu__slots__ = ()K_`R = {}shutdown = Fals_index_i = tools.countMZdirty7`ered_with_e[rcw:Y "@", "d[e \ "")def __init__(self,e/0if V5.+ -p# We ma1eqO0moran once becaufC#thread race, bu atrharmles1TimporH. ._@M (ub = Tru0i"= # . ='-vB.! =%0 =  3 = 0or a %.$s = next 0ry[@] = k4# ~~ _=):"""If alivpen mark"XWC_;hpotherwise0h ary.pop,A!ifZr0 (*l.a(7{})adetach!UB,(,) e""" info = self._registry.get(3) Robj =.1and .weakref(&0if )is not None .K^1pop^,"%):elreturn (obj,gCfunc Cargs kw or {}) Cdef peek]W"""If alive then d_M", U!);Ootherwise45"""!@M6@property+,0Whe finalizer is>r; inAsCtexi[>"""tshould be called at =}Pbool(4) !.a v.setter(#)w, value\E@!if^=1 = `__repr__x  =@'<%s0ect%#x; dead>' % (type.__name__, id Oelse^cfor %rmg\:y !, Jobj)5@classmethod_vselect_for_uG(cls}2# RS(s marked 7, oldest first^L = [(f,i)* gin cls&items() :%]C.sort(key=lambda /:[1].indexw*[fp"L]h At shutdown invoke+sbbwhich N=Utrue.`# Thisonce all n non-daemonic threads have beenGfjoinedYreenable_gc = False.:tryy*ifp import gcEif gc.iso'd( 6Tru#`gc.disJpending =, `while [?iB!isC or finalize._dirty: pending = cls._select_for_exit()9finalize._b = False0sif not l_breakB4f =?O.pop/tr # gc is disabled, so (assumno daemonic@# threads) the follow=!isonly line inE is function which might trigger creaEof a new r-f/except E?ionBsys..chook(*_info()%rassert "in`registryl# prevent any mores from execut|0durzshutdowx^j = Trupif reen>_gc2gc.2() """Implements (a subset of) Sun XDR -- eXternal Data Represent. See: RFC 1014 U import struct 3io rBytesIO;Doolswraps __all__ = ["Error", "Packe 5Unp Conversion)R] # ions class ( )5""" )for this module. Use: U xdrlib.Rr as varNXbvar haF$pinstancf\eXPublic ivarsJ0msgrcontainPrmessage71"""def __init__(self, msg.O=4Crepr4/preturn O;j/st57str4 } (r`pass Zuraise_c _e(#3ion0""" WrapP3di.0{s in a s . .@cWQesults, valuesD & 7S62 2e& (e.args[0])'2Nonzr dY!"",`ious d'to a buffer.  NIN. +@__bu"()50get"fe0:P.__buf.getvalue() # backwards compatibilityget_buf = Afer @raise_conversion_errordef pack_uint(self, x):t ._Y.write(struct.4P('>L'/)hg"lg{r_enum =2intOboolmif x: Ab'\0"1'iOelse, #0'uouhyperw6tryQ\vx>>32 & 0xfxcept (TypeE#, j) as e^% C7(e.args[0]) from Noneb'ZhOfloa fuiodoubleFdjPsfstringOGn, sif n < 0BValu-#('E size must be nonnegativedata = s[:n]{n = ((n+3)//4)*4.+ (n - len(P)) * U'. (tfopaque! ~s9r[dnf(\l2 vTbytes4lisp ,7temfor item in &  1=( 60ffarrayRx!if!j) != ndiawrong `mY KQ"a!n,^ class Un"er2"""s various  representationsfthe given buffer."""i-__init__G! self.reset (data) def reset(self, :.__buf = vpos = 0Mget_positionT)Nsreturn U6pos7s7$, FA:% = E|obufferz 6buf5Ldone/'ifR < le $ raise Error('unextracted0 remains'punpack_uinvP7i =zmuj = i+47buf[i:j]!if&V) < 4!OF5btruct.S('>L'"6[0]B_lsenum = =intLbool658)>hyph~')$lo hi)<<32 | lo}x\&~if x >= 0x80 WIzx - 0x1'%00xOfloafKZ^doublem_1 87 8d qfstring8, nf n < 0{QValuei#('B size must be nonnegative'u4 + (n+3)//4*aif j >O7buf?0jyy3i+nvfopaque: >nO "`#(n^ string unpack_bytes = unpack_string deflist(self,aitem):(,!U = []vwhile 1#'@x = G.oeuint()4#if x == 0: break,!=W8'raise ConversionError('0 or 1 expected, got %r' % (x,)|6tem  .append(?preturn ! >cfarray@nCfor i in range(nplP( ?en ]  import contextlib$os GpathdshutilEstat y4zipfile __all__q'ZipApp', 'create_archive"get_interpreter'] # The __main__.py used if the @rs specifies "-m module:fn". # Note that this will always be written as UTF-8 (> and # function names can5non-ASCIIPython 3)mWe add a coding cookie even thoughg!isxdefaultH # because resultL(@ may(pnded torun under 2. MAIN_TEMPLATE = """\ # -*-p: utf-8{$} .{fn}() """Windows launchersUHwhen parsshebang lines^has no BOM. So#3on hZOn Unix,!_0sys"eno. if sys.platform.startswith('win'B_9A = ' b' else%\6get{A() class a(Valueypass @o. manager _maybe_open(,eFif isinstance"(str, os.PathLike)0 RR as f'qyield f" C e__prefix(f, """Write a Z.X\-= b'#!' +\.#e(%) + b'\n'_!f.*kDcopyK4new D=Non"""Copy an applica*0ify n(archive, 'rb') as src:  # Skip the shebang line fromgource.1Read 2 bytes of& and check iy are #!?first_2 =.read(2)]5if !v= b'#!'# DiscardvuinitialErestLjE b''1src 5() with _maybe_open(new_archive, 'wa:dst_write_file_prefix(dst, interpreter1# I@re was no3, "" contains  L Q, so =m before copying DHA JAdst.N(_pshutil.^<obj(src, dst](if GisinstancefFstr)^os.chmod$xos.stat).st_mode | .S_IEXEC) def create!(s, target=NoneBmain + filter  compressed=FalseA"""C{ an application WrSOURCE.BThe q can be@namea directory, or aeQ-likeobject referroPexistzv!en_is packed?in TARGET,yTwhich . oNZOqomittedGwill default to+QA.pyzKappendedd`dhave aA`specifOWthat it should run xINTERPRETER (the'beR!ifJ20is !),@a __b__.py bruns MAIN (if !isHBnot 0iedA  GPused)At is$ArrorJ#toIyafw@nythBo0 th a!noGvd/kd`Qh( I1"""0# A`&an?*1_is1 = if hasattr&']/ndI' _2TruFelse( = pathlib.Pathw2#ifO.(k source_is_file = True if source:_copy_archive(&, target, interpreter)3breturnZ # We are creating a new Q from a directory.Fcif not.exists()raise ZipAppError("SQ does<5"has_main = Q / '___.py').(21if 1Dand > /A"Canpecify entry pointj3the[ ( or& A.8 nou"")P_py = None# Check that@has right formatmod, sep, f_c.partition(':'P+_ok = all($.isidentifier()\  in mod.split('.')E/fnD/fnC_sep == ':' 0mod[ ensxInvalidkQ: " +8wMAIN_TEMPLATE.K(module=ISfn=fn#iff1 is~# =G.with_suffix('.pyzv#elhasattr(9, 'write' = pathlib.Path0f _maybe_openNb') as fd_ck@_pre/fd1compressioD@(zip.ZIP_DEF-D9'bed els ?fSTORED!pipFile(T'w', aGion= zpfor child.rglob('*X,`arcnamv6.relative_to0if filter3 or(P2!z.~(l,m}.as_posix(Q3:_pyKIstr(2,_py.encode('utf-8Zbc.chmodc.stat().st_mode | .S_IEXEC) def get_s##D, 'r{.read(2)%Vb'#!'! f'Alinerip().deshebang_"4ing`(args=a"""Runk`zipappm]jRface.The ARGS2 am lets you syargument list directly. Omitting ARGS (or seit to None) works as for argparse, usingGsys.argv[1:](0the(ument listn1"""/`import"J  5r =A.ArgBPo7r()'c.add_a ('--output', '-o', default=,8help="The name of ? archive. 0 "Required if SOURCE is an6" apythonp P? interpreter?use(: no shebang line). 2maim1 functionOqapplicaKqan exis __Q___.py compressSQc', a='store_true'C8 files withdeflate methodF3Aare eDd unTed byyf 8inf0FalPqDisplayAfrom _sourc S0 di)1ory]Yrargs = . s()# Handle ` -m zipapp=`pyz --`- if  s.:jif not os.path.isk.),0raise SystemExit("Can only get ];Bc=5_ zprint("I: {}".format(@ or "")?tPe0A/if5!isf(3.'U) andCLsamex,RIn-place edio~sW0sup((ed'0gs.&Gachange6when copying"iscreate_ X/=. , w <F)) if __t__ == '$'T0() ]@Read write ZIPs. XXX refere.nces to utf-8 need further investigation. """ import binasciilib.utilo tertoolso posixpath(shDEstatFtrucyDthreading*Dtime contextlib try: zlib # We mayits compression method5qcrc32 =6. except IRError`Yi= None;9? ?bz2yAx ]Olzma^+B_ __all__ = ["BadZipFile", fe!",| "ZIP_STORED0fDEFLATTBZIP2KLZMABdis_zipdqZipInfo0'PyULarge Path"] class !(EBion)Tpass (Q *-Raised when writing a T, the  requires ZIP64 extensand those are disabled.'x r# =$  # Pre-3.2atibility name_LIMIT = (1 << 31) - 1 FILECOUNT$&16$MAX_COMMEND  # constants for Zip sr1A = 02A = 83Q = 125Q4 # O1ZIP s not suped DEFAULT_VERSION = 2r'64145 p 6 t63 # we recognize (butpnecessarily|) all featu upthat ver  PhEXTRAC63 # Below@someRPmats 8associated data 2/headers usH#sq module. TheV3of @/1rdsused # inTPKWARE descripZ1 offormat: #8http://www.pkware.com/documents/casestudies/APPNOTE.TXT # (URL valid asfJanuary 2008)4@"endcentral directory" , magic number, size,pindicesn1sec4V.I ") R EndArchive = b"<4s4H2LH";ingPK\005\006" yEndCentDir =P.calc(a) _ECD_SIGNATURE = 0 _ECD_DISK_NUMBER = 1 _ECD_DISK_START = 2ENTRIES_THIS!K = 3OTAL = 4SIZE = 5POFFSEP6COMMENT_&L7 # These last two indices are not part of the structure as defined in the # spec, but theyA!us!ternally by this modulFa convenienceB = 8LOCATION = 9  "central directory" , magic number, size, and #B3ies? (section V.Fformat document) CE alDir = "<4s4B4HL2L5H2L"$9ing$b"PK\001\002" VP.calc(#)indexes  _CD_SIGNATUR#0CREATE_VERSc1bSYSTEMCD_EXTRACT.3./4FLAG_BITSCD_COMPRESS_TYP6(0TIM 7 0DAT 8 1CRC<E1/UNFILENAME_LENGTHm2Yg_FIELD%4N!15OINTERNAL_q_ATTRIBUTE1/EX"L_HEADER_ 18The "local file headerA QFileHd2$2H "R3\004  #l) _FH/FHp1*5CT_p2GENERAL_PURPOSE_3")ION_METHOD:FH_LAST_MOD_5167 89$ 0 1Zip64 end /to WuctEndArchive64Locato%LQ%rx06\x070End8DirMT " recordG tQ2H2L4Q "6# =y EndArchive64) _CD64_SIGNATURE = 0DIRECTORY_RECSIZ1CREATE_VERSION = 2wEXTRACT3DISK_NUMBER = 4_START = 5-_ENTRIES_THIS_FO = 6#OTAL = 78bOFFSETrp_CENTDIj9 _DDx08074b50 __FIELD_STRUCstruct.S (' 18aise BadZipFile("zipfiles that span multipleAare not supported")rp# Assum 'zip64 extensib=Aata'fpin.seek(offset - sizeEndCentDir2, 2 *1 = M\read(D'pif len(.)  &  DV sig, sz, create_version, pgQ_num,!q_dir, \Edircount 2  =4struct.unpack((# Update the originalCa usingQ from$ZIP64 recordBo[_ECD_SIGNATURE] = !DISK_NUMBER#5(USTART'=dir'ENTRIES_THIS_\.b.HOTAL*2+1SIZ0dir SOFFSEr$  def _EndRecData()B"""Rma"End of ral Directory"v,RNone.r2Theis a list?nine items in a@centaCdir" followed by a tenthE,B  l#isB."""# Determ51izeh0"jUtell(SCheck toythis is ZIP : with no a comment (thtB# "eXX\ure should bAlast?#r4if kacase).!2try-except OSErrW&(=wF2 anC`[0:4] ( Q*1-2:*`b"\000"M#`signat;`is corJ@re's",  uc4LD4 7=(C2P# Appua blank3andP star. !.a>B(b""iTez  0Try.2 "Zl directory" structure %return _EndRecData64(fpin, -sizeEndCentDir, endrec) =# Either this is not a ZIP file, or it with an archiv# comment. Se@ them1 of P0 fok`e "endcentral directory"record signaT. Thed^last item ind and may bup to 64K long. Issumed thatBc magicnumber doe3Tppear -BmaxCStart = max( - (1 << 16) - !0)Dk.seek(N#, "qdata = )Rread(9ss.rfind(stringEndA)2if ,Q>= 0:u\`# foun e ; attemptVaunpacktinterpretBr0 = [e:+]3sif len(:K) !=1Zipcorrupted.P%"2Non p = listBuct.&$, 0@`Size =rec[_ECD_COMMENT_SIZE] #as claii!bygzL ' !6+9B.append(#  S" + "P# TryZ`"Zip64! -',) # Unable a valid + class ZipInfo (object)A"""C ttributes describing each rive."""__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 self.orig_filename = # Original "in archive # Terminate the.#atrst null byte. N As in1Nis are used as tricks by viruse6%s.;b_b.find(chr(0))*!if-U>= 0:5[0:_]-# This isto ensure pathgenerated ZIPqs alway3Iforward slasheshe directory separator,required7theIhormat specification(if os.sep != "/" and.replace(N,L)_self.Kb0# NQlizedc?qdate_ti > # year, month, day, houvin, sec5if >[0] < 198raise ValueError('Jdoes not support stamps beforeK'p# StandvNsIcompress_typtZIP_STORED # T4of %sion forHlK_'level = NoneA # L=**orbcomment = b"";3# CEAeach @_extra>BB!Edata9 if sys.platform == 'win32'+0cresystem = 02# Sbwhich *jsJelse]# Assume everything &Unix-y=n3K@vers= DEFAULT_VERSION?VSj?ct_T$# Spneeded %ct! Sreservedx## Must be zero,7flag_bits8# @lag ! 80vol mnumber ofk headeinternal_attr3# I jibutes/ex>E}Cm@_siz !of) <B7# SF/unHw# OtherYset by class ZipFile: # header_offsets Byte to the file.?5CRC5 CRC-32 of:uncompressedG Adef __repr__(self)result = ['<%s5name=%r' % ..__class__.__@__, G.!)]h"if_type != ZIP_STORED}1.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 G_sizJ '`g d.((fjU) andEn z9 or1 - h.f -  @(>'turn ''.join(*)SHG, zip64=NoneQ"""ReIN@per-bR as a bytes object."""d date_time os = (dt[0] - 1980) << 9 | dt[1] 5 20dosK =%3%"11&43Vv5] // 2Pflag_bits @*08P# Set se to zero because we writepm after U datag=i! =,E = 00;els>@5CRC)Y ]  /rPSTextraK min_version"if5@ is 8 HP >64_LIMIT or e ] fm]u'0), )Esreturn L+[/ +"raOdef )6try _'..('ascii')^except UniE _Errord^utf-8d | 0x800!def(P# Try$Iw field.0tra)" unWwhileK >= tp, ln = ;r('U 8&5BadrCorruptWp %04x (|=%d)" % (INPif tpn0x0001o0dat0[4:]B#k! (Ss and/orf archivesF `E in (0xFFFF_', G1 = ; ("0[ |,@Q', ";[:8="" =).8:?$if self.compress_size == 0xFFFF_?: field = "Compress ?"0cself.c,k , = unpack(' 2107j, 12, 31, 23, 59oX# CreBstor information $if =;0os.P.norm (Qsplit(.7)[1Twhilex0in =1sepgaltsepJ% =91+diY4e+= '/'zd = clsEb(.external_attSode &F) << 16 # Unix +eibutesuc\-E = 02 | 10mgMS-DOSEflagAAelse zinfo.file_size = st.st 3 return zinfodef is_dir(self):,B"""R/ True if this archive member  directory."""AmW2name[-1] == '/' # ZIP encryption uses the CRC32 one-byte primitw'for scrambling some # internal keys. We noticed that a implementaois faster'n # relyWon binascii.crc32(). _crctabl^PNone =@_genC(crc>j in range(8if crc & 1i = D >> 1) ^ 0xEDB88320RNelse8Q>>= 1$r4crc\supports a password-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) _%s = 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__^_comp = l32 0@prop*lzma._encode_filter_erties({'id': &pFILTER_&1} z)L(FORMAT_RAW,iters=[S'?_de , s ]) # return struct.pack('[eY1ZClz77!90wav?4ppmd', } 2a_checkDion(W3ionFiion == ZIP_STOREDKApass/el1hDEFLAT3if not zlibH>aise RuntimeError([#"Crequires the (missing)Z module"mVBZIP2'bzyr4?bz2  . "Compression requires the (missing) lzma module") else: raise NotImplementedError("That ccmethod is not supported") def _get_14or( e_type,Klevel=None)%if+ == ZIP_DEFLATED&*FM&*return zlib.5obj?, hR, -15%C TZAULT_COMPRESSIONP'el VBZIP2'tbz2.BZ2 w@ 0##8xignored forALZMA9#p M%de O;e_checku5ionflUaHSTOR_3 5bj(UO DJl F udescr =or_names.getU!1if 7rT %d (%s)" % e,Z)W 2id)class _SharedFil_init__(self, file, pos, close, lock, writn0 ._0! =78Ppos =J W_ l! =s $ = seekable. &Dtell"  0offset, whence=0Rwith  #if(9 SValueCan't reposit3!in1ZIPU while "C `"theretan open! handle on it.B Cv;before trying to read.ev(@0, 8(* retur n self._pos def read(, n=-1):Cwith2Flock#ifwriting(9 raise ValueError("Can'ts from the ZIP file whuthere "I"is an open | handle on it.< QClosev ;before trying to9.")& ._Q.seek6N 'cdata =.dn&M:pos+Ztell(*preturn Wcyv is not None9objy! =@K) # Provid_ method for un2able stream class _Tell__init__G, fp5ufp = 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 - 1CBRead'5!ed*s in 4k bs{MIN_READ_SIZE = 4096IRChunk@ durASEEKD"24B ileobj, mode, zipinfo, pwd=q,V >uobj=Fal'aG Ppwd =e  \* =leNt_type =. a@_leff4 4 ++_' ( = _get_,)._"aeof = V _b k = b'' 9Spnewline F! = Q8namU?if hasattr(Fs, 'CRC'expected_crc5CRCw-srunning,crc32(b'') else:  self._expected_crc = None '#seekable = False:trySif fileobj.5*()#Worig_compress_start =@etell()k7; izzipinfo.S&iz=A*_s=z 1Pprunning9f = Truexcept AttributeError3Lpassdecrypterjif pwdA4if flag_bits & 0x8(@ # @are against the type from extended local headerscheck_byt(_raw_time >> 8))ff=CRC otherwi04_>> 24~Bh = Uinit_k if h != cNraise 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.AUPvread(12z left -= 12JcreturnaW)[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(' [closed]'3) result.append('>'turn ''.join(*!) ;def readline(self, limit=-1):"`"""Read and reN a 3 from the stream.V4"IfJ is specified, at mostbytes will be.uNiN6< 0h # Shortcut common case - newound in buffera>@i = ._"find(b'\n',offset) + 1?\f i >{\[mPI: i]O9!M = i!ra Aio.BedIOBase.+Cpeek-n=s84ed thout advancingposition."""if n > lende9) -\ Tchunk&(n&1en((?) >K.TH1 = :# +9 0hJelse~1 -=$2# Rup to 512nto reduce allocad` overhfor tight loops{+v]S2abl "if8jclosed raise ValueError("I/O oper"n 7v file."JTrue:?, n:n8 !IfargumentPomittNone, or negative, data$4ed until EOFFchedg y" jH0 F0is  4buf. ,i = b''#*= while not J_eof+1f.MAX_N+2bufuend = n0if " 0 and not -Eeof:'/cdata =read1(n)"if n < len(-)@D[=buffer = * F(n!Rbuf +=N[:n] Ireak2 Fn -=return buf def _update_crc(P, new1# U% the CRC usingQgiven.S#ifQexpected] is None@# No need to computeXfif we don't have a reference valuesw._running= crc32(,#z# Checka're ataend of 6fil!of}!p raise BadZipFile("Badz-32 for tb %r" %Vname)1"""Read uppn bytes withmost one ?() system call."""_j1 or!0O[:,e = b''x#> % UVMAX_N+!if  br&IR= n +Q0if "_#Kt ?endwT5end|T1n =-c @ H +> % a? u", %>_$ c8 2^)# ]oressedh,=# decryptFdecompress theCm. if self._eof or n <= 0: 'return b'' # Read from fileRcompress_type == ZIP_DEFLATEDb ## Handle unconsumed dataW# =$dea6or.7U_tail6if n > len(A){"$ +Yread2(n -3)QJelseA= <))a LSTOR V;Alefta pn = max(n,MMIN_READ_SIZE t X:, n:( 32or.rm 3O and62not_m ! C:eof Vfflush(M < ?Et"{#or"~=K"[:UD]@6 -= 7{ !@e= True9update_crcTRdef _{;Nj%8W '%in_l@obj.(.CaU aise EOFError% decrypter is D?Non 0Qclose0:try/_  $.-6kfinall[usuper()-Y%}seekabl^drLQValueN("I/O operation on 7"Q{&, offset, whence=08f,  io.UnsupportedOperation("underlying stream is not seekable") curr_pos = self.tell(if whence == 0: # Seek from start of fileQX3newTeoffset)elQ1Qent position7 T'_/+ _ 2_?EOFR`_orig_o_size ^9se:Braise ValueError("- must be os.SEEK_SET (0), "@ "1CUR (1), orEEND (2)") E4if l> , ,W?< 0D01Rread_% =$- Fbuff)7+228if 5>= 0 andb< len(T1:er)0# Jmove the index if5new6!in_VsxW '>E = 0 n3# P RbeforZ,q. Reset|ZipExtF@obj. 3compress_running_crc.B25WJleft7o;2.Ger = b''#$deoBX_get_,%__type&eof = Fals #ifdecrypter;Nonz1ini2(hwhile x>len = miBAMAX_XREAD,@A(J_len s"-=H8len5BturnwAdef  jclosedBB on ..:@lf._ Tio.UnsupportedOpera?("ufe7" -_- !!reFfilepos cla.ss _ZipWriteFile(io.BufferedIOBase): def __init__(self, zinfo, zip64*.!0._z1 = F1p64>p64@filefcompressor = _get_(h.e_type,@{ @Relevel)A@_siz0z qrc = 0 7@property_\1obj_Mrreturn 0zip'2.fpG9writable9JTrue-*g, datai"ifebclosed3raise ValueError('I/O ation on 7 '8nbytes = len(rY1S2+= . "c9Qcrc32B,F_crch*or|$ =;I1[P + @obj.eO5  @:trysuper().<(# Flush any from the or, and update header rvl%?bufof / 6:buf0=s) _ u Jelse`{R N86CRC)rcv(J.!# dflag_bits & 0x08Y qs afterAb fmt = ' ZIP64_LIMIT6:RuntimeError(   'File size unexpectedly exceeded ZIP64 limit') Jif self._compress_O>;_LIMIT::Nraise RuntimeError(,0#'Cf/ed' # Seek backwards and write fheader (which will now include# correct CRCLF?s) / Preserve current position in 4b0zipZ.start_dir =|obj.tell(?%Rseek(bzinfo._offset> ( ?DH3Op64)I 7# Successfullyten: Add0 to our caches>alist.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',@lusireate 'x'CB 'a'e@ion:@H (no[!), DEFLATED (requires zlib)e\! /WBZIP2,@bz2)<GLZMARlzma)P: if >cO!s [extensions whenn0, 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 acceptedhen using ZI$P_BZIP2 integers 1 through 9 are accepted. """ fp = None # Set here since __del__ checks itL_windows_illegal_name_trans_tablebqtry&qio.openc. ex?1 OSV!ifNA-U . co;u, !Ubreak;els-_{61/A!1%3ileQsgetattrR'!',bVOpARefCp`lock =eading.RLock(Dlf._seekable = True self._writing = False Etry: 3if mode == 'r' PRealGetContents()D$elFin ('w', 'x')M# set thetified flag so central directory gets 9teno# even if no files are added todfarchiv8didModifyB# +@start_dir = {fp.tell0 except (AttributeError, OS (6U = _Tellable( ~-06'P_seekS"Nelse"a# Someu -like objects can provide  but not oOg1fp.@ l#k .a.P# See is a zipEw V ek7 ofFand overI ?Wd`BadZipFil$, just appendV0, 2)K3RO)@D_S+>raise ValuJ0("MmZ be$, , or 'a'"/ &fp :Non@_fpclose(fpbdef __enter__areturnC .3xit-, type, v, tracebackE/t?repssult = ['<%s.%s' % .__class__.__module__, }9qualname__)]<!if0.fpQ $_=jPassed!yresult.append(' file=%r' % self.fp) Celifilename is not None:,7result.append('`6 dJ j :9mod2;els~ @[closed]'5 #>turn ''.join(*!) def _RealGetContents(.) """Read in the table of c0A for1ZIPA."""^6Cfp =fp6try`&endrec = _EndRecData(except OSError=raise BadZipFile("Qa zip"/!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@_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 fil ename = fp.read(centdir[_CD_FILENAME_LENGTH]) flags = 2)5]2if "& 0x800:H# UTF-8 file s extension-%$!il.decode('utf-8'OelsesHistorical ZIP|Wencodingy[cp437y# Create ZipInfo instance to |eu informat4x =;( px.extra EXTRA_FIELDx.commentACOMMENT=header_offseC1LOCAL_HEADER_OFFSETA(x.c@_ver%, `system(ct$reserved, x.dP_bits9compress_type, t, 19CRC+@sizel_ )J1:123if q > MAX_zCT_VERSION~raise NotImpleedError("zip %.1f" %6(\/ 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 +@ Kl 4 7  51if $debug > 2lqprint(""",") ;1defp(I)@"""Return a 2 ofs in the archive."""r7U[data@ for"a:kY] Tclass!\shW return self.filelist def printdir(self, !q=None):#'@"""P& a table of contents for the zip=E.""":]("%-46s %192s" % ("File Name", "Modifiedo, "Size"),I `=)zinfo in =date = "%d-%02 :K.-_time[:6]kG d8(9`name, C&, ]_sizeS4kqtestzip Read allt;s and check9CRCQchunk~ = 2 ** 20h|"or> :tryO=!# 1by ds, to avoid an OverflowError or av=# Memory# with very large embedded-s.>0Mopen"r") as f| whqf.read($ ):A # CQmCRC-32{$y passexcept BadZip}breturnv00get ,  ?rqinstanc@ZipIpgiven '8'U" ="u To0P.get(-Q1if ,0is  raise Ke('There is no item@d %raarchive' %)<} 0seteCword:pwd0SetAault,uencryptBPif pwd not isM(pwd, bytesgAType("pwd: expecd3q, got %@typeN@).__c)__e> @=Jelse)-@property9;qcomment7s"""The  text associaV1ZIPz F_C.setter,v,ifI.(#>KTvalidq length if(K > ZIP_MAX_COMMENTimport warning). 2('Ayis too long; truncatinga"%d' %MENT, stacklevel=2) comment = [:ZIP_MAX_COMMENT]0cself._(2 didModify = True def read(E, 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"nF"w"'5 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_" =5iono3x4l 46Jelse`# Get G? k\0get1] b4_T@_to_!e( B4for"if8:ingLzb"Can'tDfrom while there "/ "is an open writing handle on it. "8Close the7before tryLto read.") H0# Oo1forEing:self._fileRefCnt += 11zef = _SharedFile(5 fp, zinfo.header_offset,==@_fpc", lock, lambda:)Q6tryKa# Skip $f4 = .!P(sizeHeXsif len(;Z) != / c3raise BadZipW("Truncated "ib = struct.unpack(H#, * ?$if[_FH_SIGNATURE]VtringDBad magic number 4 ]fname[FILENAME_LENGTH] EXTRA_FIELD0 l?#ifflag_bits & 0x20g# Zip 2.7: compressed patched data ^NotImplementedError("C (x bit 5)O4strong encryption =6v GENERAL_PURPOSE_FLAG_BITS]\/80QUTF-8C Yq_str = .decode("utf-8GNelse8D_cp437o2#!=)Aorigd ' B in directory %r anddiffer.'F2% (p , )q# checkTlag &qpasswordn6is_0/ 8if 4$if not pwdA0pwd*pw? sRuntimeopT%r isDed, cm p"requir:or extrac]1" % else:  pwd = None $return ZipExtFile(zef_file, mode, zinfo, pwd, True)@uexcept:R>v.close(-Craisdef _open_to_write(selfoforce_zip64=False)h7if  and not @._allowZ81| ValueError(""U!isf, but TQ was ` when ^ing "Nthe ZIP L. #if?ing p"Can't -Xe to d` while_re is"anotherMahandle on it.ACps first CRbeforJg6.")ya# SizePCRC a/0verten with correct data after processVYw.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=.H(?)pKN:P_ZipWIPsextract%member, path=p; B"""E72 a 3Q fromOearchivcurrent work diHory,ufull name. Its Prmati#s ed as accuratelyPas possible. `P' mayaVdP or a?Info object. You canP@specqa diffe `5%'.7&""8!ifSV 8 = os.getcwd() welse: path = os.fs (%) $ return self._extract_member( , 3S, pwd8Cdef +@all(<%r=None, 8s1pwd )B"""EkD all0 from the archive tocurrent working directory. `' specifies a diffe;(TH to.L`' is optional and must be a subset ofRlist B(edKpby name &()e5"""&%if0is 9 " =O!if@getcwd(){&for zipinfo in  C5D@classmetho:U_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.split| aRjoin,ibempty j@sep.6-(xjV if x`;j, targetj@ZipIobject ''ea physical file on>`k'\isinstance|)S0get4'q# buildpdestinaPRo#mward slashesplatformxc separators# =;.h".rP('/',.$%ifjaltsep\ T1os.O6 _Z# interpret absolute as relativeJ drletter orQ# UNC;+wdundantQ, "."".." component(9r(E)[1]tinvalid_path_pa rts = ('', os.path.curdir pa3) arcname =2sep.join(x for x in &t.split(\6sepIPif x notJinvalid_f_partsC(if == '\\':\# filter illegal characters on Windows3 = self._sanitize_w-_(&*I`target+',(7@normJ(%) j# Create all upper directories if necessary.5(0dir1dirfC"if[31and9uexists(T)pos.make;$if member.is_dir(@%ot is$ nrk&!vreturn EBwithRopen(, pwd=pwd) as source, \T 0Sa, "wb"1 shutil.copyfileobj(X/def _writecheck(w, zinfoC@"""Cerrors before <Ping a%e to thehive.""""ifX.&p.NameToInfoimport warningb. ('DuplicZ{: %r' %p, stacklevel=31"ifAmodein ('w', 'x'a' aise ValueE  ("e() requires LDyor 'a'"t*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(self, filename, arcname=None, compress_typ" Qlevel6%):7 """Put the bytes from filedQ intoarchive under GE."""if not self.fpsraise ValueError(6"Attempt to write 0ZIP that was already closed")K"if}_@?ing_Can't~while an open#ing handle exists %) zinfo = ZipInfo.s_s(X, 5Dstrict_timestamps=s_1if .is_dir(e9_size = 0$9CRCJelseh%if1 is *z* =A pF6ion4*_N2 G LM CwithNlockb{seekabl 0fp.&( Pstart.b) header_offset =fp.tell() # SCB of +sJ^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_,/ I* u8,:A"""WaA =. The contentsa'', whichDmay be either a 'str' or a 'bytes' instance; if it is a 'str', encoded as UTF-8 first.&'zinfo_or_arcname'Meither a ZipInfoq5 or;@the 2@ of qfile in archive."""0s(data, str):"0 = .("utf-8")(Pif noN , ^($ =(=H date_time=`.local (.v())[:6]Ce.compress_type = self5ion3_4\level4 62if l[-1] == '/'odexternal_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-)= =WW X>X@_sizn1len|)D# UnB0ed +BwithZ_lockM(o, mode='w')wJdest5v.edef __del__(q"""Call^"0()" methodvAcaseuser forgotP.9n lP=P, andU 'w', 'x'1'a'E~Vendinyrecords"ifO fpbreturn+0 "z ez j ""on it. > CAbabefore:Wzip."e8try2 if self.mode in ('w', 'x"a') and self._didModify: # write ending records Cwith=]lock:!0#if#seekable'+0fp.*( start_dir)\$_R_end_(-zfinallysBfp =)fpWONNone_fpclose(fp) Ndef H)tfor zinfo.filelist:rcentral directoryg#r dt =K.date_tim0dos = (dt[0] - 1980) << 9 | dt[1] 5 *2]` osS =)3)"11*47Zv5] // 2iextra = [U#if_size > ZIP64_LIMIT \4 0.compress6_{.append(ph< . n2S= 0xf  F +?els d i0 header_offsetW @)  =  @_dat{. 0min_version 1if 11# AN" a field to the5'Mq_strip_(n, (1,);"truct.pack(' ZIP_FILECOUNT_LIMIT:/ Q"Files c"+&el\]/64U directory 6b2`,j^:if # Need to @ the;$64 sCbif notp_allowZ b)raise LargeZiph() +Y4t" would@xtenR&s">*zendrec  mBEndA064,9ing 8b44, 45Y0, 0,  >+d :T)?loc"oLocato+?, 1 'Q= min1d, 0xFFFF55 437_9entDirOffsetS, 0xFC) endrec = struct.pack( EndArchive,7ingAH 0, 0, centDirCount? 9ESize8 Offset, len(self._comment))Mfp.write(,DC1if mode == "a":fp.truncate(acflush(edef _fpcloseV, fp)Tbassertu_fileRefCnt > 0xtE-= 1_if noB;andPmd|2fp.) class PyZipFile(A"""C!to create ZIP a%s with Python library s Zages."""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: initname = os.path.join( P, "__%__.py") %if5pisfile(*7)):)4# This is a package directory, add it6pif baseTSW = "%s/%s" % ( , : 6OelseP;self.debugCprint("AddingWin", WEas",f~P, arc 1 = v_get_codno[0:-3]N "if@"zjwrite(+pdirlistorted(os.5dirb)7.remove(# Add all *.py Us andz4subi=ies1for5h in?ath,|Groot, exmsplitext(; j>eg 0[z} NR#:8!py,5 filterfunc= ) # Recursive callRBelif0= "u ifkO7not4 vk8' %r skipped b1' %EbJcontinue%  ^/ZHL ($\ v ?NOT ses at top leve T@from*EQ svthname)):  path = os. `.join( name, file -) 9 root, extAsplitext(; "if8= ".py":`t ifterfunc and not)@Dself.debug+ /pprint(' %r skipped byw@' % 'Fcontinuef]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'2Qbimize == -1:  # legacy mode: use whatever file is present 4if (os.path.is*(_pyc) and-1 os.stat(.st_mtime >=)-):L# Use .pyc.!arcname = f0ile +/elpycache_opt0 ,#Pthe _~5_/*, but write it to ,9pycl# !in.~archive+! QPH!1H1H1H=2H2H2H/se6@Comppy into PEP 3147 JRif _c7u if sys.flags.optimize == 00})_1__1)' #/eljf E<W# newcgiven }ation levelC@elf. + elif self._optimize == 2: fname = pycache_opt2)Oelse?msg = "invalid value for 'opt|': {!r}".format(self.g)lpraise VMError(msg*if not (os.path.isfile(_) andXsos.stat'.st_mtime >= uile_py))}Q_compv4$, =Cc = arc5_pysarchivecsplit(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'`_dedupdict.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_iterable(map(_parents, names)) as_dirs = (p + posixpath.sep for p in p?7 return _dedupe(_difference(Rkl1def|list(self): = super(CompleteDirs, +.": As + -._implied( 1)) m_=_set>presolve\1"""kaIf thep repres a directory, vAthat)=(as)a (withOtrailing slash).2{?0dir! =ve + '/'Jdir_match0not2Ps and ;_ if+M2els@classmethod@pmake(cl_ource[Given a s%a (file`or zip)]!an_appropriate iA subOif isinstau,Ah*1if KLhZipFil0GBcls(K# Only allowFastPath whenM is read-onlybif 'r'nNV.model clM1 recls.__new__ivars(res).update('ares  iLookupj9 to ensure 1citQexistCare d rapidlyYSZycontextlib.sups(AttributeError26r5s  Af 1l  2.__C  A  lib-compatible interface@zip "s.Consider a this structure::/ ├── a.txQb0c04$e8U>>> data = io.BytesIO(<Szf = (), 'w') >>> zf.writestr('a.txt', 'content of a') >>> zf.wr-?b/c/c/?d/e1e1filename = 'abcde.zip' Path accepts the zip0 object itself or a H:proot = EB(zf)@FromKre, several pg operations are available.8Directory it) (includingR")::pa, b = .@Fdir(fa(#, )b)3b/'0 pr'ty b.@#'b_join with divide 6Gator8c = b / 'Ac \ &c{F=Read texto`.read_!cexistence:s7ATruef(qmissing))..RFalseCoercion to stringe5c/p2"""I__repr = "{.__class__.__B__}(R!r}, cat!r})Odef __init__(Q,O, at=""):}.S = FastLookup.make(*a$"ateCopenamode='r', *args, **kw oMOpen this entry asbinary follow2semanticsof ``pathlib.^.)`` by pa argumenUrough@to io.TextIOWrapper().bpwd = .pop('pwd', None$@zip_0 = 5[0]Mstream = r0at,<, pwd=pwdWif 'b' inVF ifs6 #raise ValueError("enco invalid for zFion"KPeturn5eamr L?@yHMM2\PposixA.bas)P.at.rycp("/")Fdef b'%Fstrm6 m(Qbytes p?b')`_is_child_,e 71dir_D 6# ="/") def _next(self, at): return PathQ.root$ $def is_dir:@not Xd.at or .endswith("/")KOfileL r9oexists8"in._name_set(GOiter5if |$+raise ValueError("Can't listdir a !")51subs = map.,>&()5Rfilteq._is_child, Sq__str___posixpath.join%.|)atS?repTh __$b.formaS=FqzuW, add? = ay-dd_@RqresolveT)__truediv__ = @propertyRparen9_at0dir8at.rstrip('/'5if > Bq += '/'*+@) main(args=Noneimport argparse'description = 'A simple command-line interface for zip module.S5r =_.ArgumentPm'r(i= Pgroup=, .add_mutually_exclusive_&(required=True?6au('-l', '--3', metavar='<5>',RVhelp='Showing of a'ueuextract', n2l( '')>Eno target dir cPcreat/'+>A<Cffrom sources G`'--tes 0 gTest i is validv}_B'@@rgs.@\2src%Q ZipFrc, 'r') as zf>0badIQ = zfiBzip(m3if " 7print("Th@llowenclosedgcorrupted: {!r}"S)) pr%int("Done testing") elif args.list is not None: $Vsrc =% with ZipFile(src, 'r') as zf>Bzf.printdir(yoextrac|, curdir0#=Ball(V ocreate zip_name,u.pop(0)Zfiles#m  def addToZip(zf, path, zip )8`if os.0.isW( %Vzf.write N, ZIP_DEFLATED2]\$if F| n(for nm in sorted(ou{8.d Cjoin Enm),DjZ, nm)# else: ignore O, 'wKs7% =@baseZ !if8Q$U6direfEain ('';( pa;M= '' q if _Y__ == "__main__" () """zipimport provides supwing Python modu@from 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 $0too_@direpy_cachedict, mapp;#sEzip 6 info 4 s,ju(in!._A. Iqusually`neededXvuse the9plicitlykA is d!by/builtin  mechanism "sy0P itembat are0 toa""" #O4libY_bootstrap_external+1 #_verbose_message _ _frozen_5lib\Ks7J _unpack_uint16, _unpack_uint32 import _frozen_lib as _bootstrap # for _verbose_message?%im$check_hash_based_pycs)oLDopentmarshalEload34sysemoduleEtimek __all__ = ['ZipIError', 'ziper'] path_sep =_external.T alt_ , arators[1:ajclass (): pass # _read_directory() cache _zip_ = {} __type = (sys) END_CENTRAL_DIR_SIZE = 22 STRING_!`ARCHIV b'PK\x05\x06' MAX_COMMENT_LEN = (1 << 16) - 1 Q7"""(archive<W) ->  object Create a new%instance. 'L' must b2\1 toGa<file, or to a specific (Pinsid60zip(. For examp5it can beN'/tmp/my3Q.zip'X5/myg', if Q is aQevalid * Cthe . B`raised[ doesn't pointg1Zipu Z5TheJ' attribute of;#ers contains 1nam)"th D targeted.p2"""q# Split;E"suba" from4Zip, lookup a matchingU# entry in sysq, fetchVgnr#EQfoundPelse x6 it6def __init__(self,"if not is(oW, str&*1 os. = os.fsdecodeA)%a(i6 b#>bempty'=E Z ^+! =G.replace(.RC)`prefix]while Truea:tryA/ste;tat6except (OSq, Value .# On Windows a,/Udtoo longs@# Back up one% element,0dirD ,   >z ifCF( ('not a Zip file', path=;)  = dirnamerefix.append(base' G]else::# it existsif (st.st_mode & 0o170000) != 0: # stat.S_ISREGHh's a not &raise ZipImportError('3a9) ebreak ]:try{ s = _zip_directory_cache[f]<except KeyHFreadI(C xj! =ydself._archive =,Q# a p" following the ZIPm9.:V;= _bootstrap_external._r_join(*)f[::-1]7if G '" +R_sep # Check whether we can satisfyi 1 ofpmodule Ad byp# 'fullU', orNit could be `ortionJaABspacJ# package. Return4 ifload it, a strSpcontain $thF`;!itcpossibs ion, None+wAccan't ndef find_0er(Q , j4I)y8"""3-1 ->,5C. Sek for a mvspecifiezt. P mustpLby qual>(dotted)Xa. It r}s2zip!erIinstance it;was found I|Hy.(,"orowise. The opl@al '> ' argument is ignored -- vKBercompatibility with protocol"5"""H mi!geule_info8  mieGY@# Thh$or+V&[]LV# NotGor regulaH1 Se tlU, and# refore  # We're only interested inYR last on%ofnearlier (s are recordQ.2)0mod = _get_module_path(self, fullname) if _is_dir#0mod1%):#*# This is possibly a portion of a W[space8package. Return the string represent @its y,@without a trail+separator.,raNone, [f'{.archive}{]c_sep}{E}'] A ="] # Check whether we can satisfy imamodule Ad by_4# 'x'3 ifR , "'tdef find_mXN,1=;8"""3-A -> !ory. Se1r for a v specifie  must beL{by qual>(dotted)X3R. It }s=B zipS%erIinstance it!if+was found, Itit wasnJ`The op@al '' argumentignored -- it'!re compatibilitP protocol$5"""z.ploader(( 4)[0get_code %K)7w object!_. Raise ZipIGErro qcouldn'  x0, i/,@ = _z MK.Cdata.UZ.%.Pfile #8 associated 4Qm3!OS,5 ifb]%pif alt_ l! = .replace(6S@)7key8&ifL`startsJF! +#P TO[len9w:tryHtoc_entr ._/es[key]except Keya Br|(0, '', keyk %, )Y#aPmatch_%__?d"ul m0""") %for the specified module. 5""" # Deciding the filename requires workout where(GcodeDwould come from if&y was actually loaded<I, ispackage,path = _get_C_'(self, full)Ddreturn:! @def Alsource<:$7"""']B -> ; string.W3Rp0#A forXspeciy Raise ZipImportError ,cJn't be found, DNoneYarchive doesIqcontain7, but has no/it +miwLinfo;pif mi is Q"rP(f"ca4fin$ {q`!r}", =)r V4bootstrap_external._`_join( , '__init__.py'lOelseY0f'{=}3:try2toc_entry =  ._w$s[]cexcept Key4 G# we havI\kAdataR._%, @).de#()_## a bool signify*bwhethe %#a c or no3is_~7"""')+)5Tru.%byF }O >aT} %miLoad andqmdd by '{' (Ge A mus5&thfby qual(dotted)+1uleoC. Its;im?,s itg A-0mod62ys.`s.get( if mod is None or not isinstance(mod, _module_type): Ymod =!(fullname))Bsys.G$s["u] = mod(mod.__loader__ = self :try}if ispackage# add __path__ to thepule *before*code getsk@# executeW4get ($, 8)<bootstrap_external.AjoinJ.archive, 4N31[]7u!ifrhasattr'__builtins__'5\$3 -_cfix_upu.__dict__!, w( 8%jexceptOdel h Vraise VH ~ KeyErroraq Import@(f'Ld~{$1!r}found in'^._verbose_message('iia {} # <d from Zip {}'k `return 0def _resource_reJ-B"""RE^R7R6s for a a zip file.phDIf 'G' is3awithin9#, 5the'y' object. OtherwiseG.I5""" FC.is_U rdW<7Zip# ;7}_8 ._registeredM %lib.abc  B .\(>&f = Tru; __repr__#Rbf'' # _zip_se.order defines how we oaN`Zip # :@ive:-Zfirst3Ka __ini @thenPt # non-! .pyc, and .py entries. Thecre swapped by X() if we run in Foptimized mode. Also, # '/' is replaced by path_sep there. _zip_searchorder = ( (*+ '__init__.pyc', True/),- {', Fals-'G!H5) # Given aule name, return potential file! i! # archive (without extension). def _get_module_(self, fullj!):o.prefix +$.rpartition('.')[2]Does thisrepresent a directory?cis_dir{w# See ifGeis a "< ". If so, it's eligible to b!rta# of a7@spacckage. We testbseeingjc23 anEappendedseparator, exists.'0dir" =&+v##1in Y_s, we have(_C 8sRsome informa0 abC,~ & for suffix, isbytecode !pas x`1 Oo+M\!&if$ 4E('iAPNone +implement"P_read(;A) ->Z s dict (new reference) #to a Zip|q, buildct, mappm # (local6the: us*PSEP aw)*oc entries.`A toc_ya tuple:!(__0__,#a# valu0@use $`availaO"al]s]< @# end"he/Rysteming # comsion kind; 0$un ed;data_size< # ) & on disk6c6+de80boffseth=hM header from start*B ti# *Dp(in dos@mat)75dat=7fP 72crc4 # crc checksumrOGA # ) D|pies can,arecognH!byTPtrail{KSZA and_8c are 0cR2try fp = _io.open_Mexcept OSError:  raise ZipImportError(f"can't open file: {archive!r}", path=) with fp: 6try fp.seek(-END_CENTRAL_DIR_SIZE, 2);. header_position = fp.tell((bbuffer_read(^3except OS  \rif len(_) != N@[:4]pSTRING_zARCHIVE# Bad: End of Central Dir signature# Check if there's a comment.* $0ile_size B& J #Cmax__start = max(O- MAX_COMMENT_LEN -u?0m <@Bdatau tu`pos = ~.rfind( 0if 4:< 0;o'not a /', ?l[pos:pos+]kk!t"corrupt".-40) +_7_unpack_uint32fv[12:16]4Poffse6G6:2063if 9< -Ec'bad c@directory ?O'O directory of fset: {archive!r}', path=3) header_position -= Esize'`arc_ofW !43"57if 8E< 0:~raise ZipImportError(f'bad central directory B or c ffiles = {}# Start of CeDe%count = 0:tryfp.seek(- Yexcept OS ="can't read "while Truehbuffer = fp.W6(46rif len((Z) < 4A$1EOFR('EOFwhere not expected'^l&T]2if }[:4] != b'PK\x01\x02'Pbreak9 h# Bad: F!H ^!= 46v'@flag_unpack_uint16qj[8:10]4compres4[10:125time = e[12:141?dat1K4:161;crca$32L16:2Qdata_ 6L20:2&6 K4:28Oname6hL28:3Oextr7L30:3kcommentp O32:3JL42:4zaL'+ (+ W{>Slocal@'+= iD ;r F v'TA) Y+ # On Windows, calling fseek to skip over the fields we don't use is a# slow0an reading=data beca6 fsaflushes stdio'Iinternal buffers.g Sessue #8745.}Itry:2if len(fp.(header_size - name o)) != UY raise ZipImportError(f"cal file: {archive!r}", path=)except OSNxt5 uif flags & 0x800wq# UTF-84s extensionKT! ='.decode(?lsedHistorical ZIPmL@encoG jz'ascii',s0UniD~/ 'latin1').translate(cp437_table) Areplace('/'J_sep, = _bootstrap_z ._c_join(M,v APt = (*, compress, ,g offset, time)je, crcU s[Y] = tcount += 1._verbose_message('zipi>: found {}s in {!r}'Sunt, areturns # Durh%,may needAloadMs # package from auQ. But- 3 is implemented #`Python "+s\. # # Break out of this dependency by usABAion >o for #!. dn# ASCII part, 8 rows x 16 charc-'\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f'e2'\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1fG !"#$%&\'()*+,-./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\xbc\xa1\xab\xbb' '\u2591230 24 66'567!5515% 57!5dcb'1071V32%1 00+3 5e '5f7!5a7 69 !66756='677!68%75=5566n1%0V8 8I89t803b1\xdf\u0393 c0a P3\xb5%c4@03a6 98 a9bd021e c7E22297p2261\xbu 26 265 32`321\xf42483 xba219\xb1a07f\xb"a0\xa0' ) _importing_zlib = False # Return the .decompress function object, or NULL if, couldn't # be dved. The="is cached when found, so subsequent calls # don'tIcagain. def _get__1():{global ,if3-# Someone has as.py[co] iir Zip fileN6let's avoid a stack overflow.(_bootstrap._verbose_message('zip1:v UNAVAILABLE')CPraiseIError("ca' b data;Hnot available") K b = Tru6tryBfromG dHexcept E6ion:rgfinall.Wr;$ # Given a path to a@0 an.toc_entry, A|C(uncx1ed)ata(archive, Bo$, C,Aa_size,| offset, time)e, crc =Y&ifFF < 0'negative6 |'with _io.open_codev) as fp[p# Check:make sureQlocal header Yaorrect fp.seek(_]!OSW9fzEread3: {Q!r}",=lbuffer = fp.?6(30rif len($g) != 3n1EOF('EOF read where not expected') if buffer[:4] != b'PK\x03\x04':(/ # Bad: Local File Header% raise ZipImportError(f'bad l9f9h9: {archive!r}', path= name_size = _unpack_uint16(u26:28])_extra3 G8:3034V30 + x&+ Re_offset += A # Start of 'U data9:tryYfp.seek(+Rqcept OSK 9m"can't read k"k@raw_` = fp.A(tif len(-)7'a("zipi': <"if compress == 0O#E@ is %%edWtreturn D# De, with zlib4 d&v= _get_b_func(!exE6ionL;available"`1g, -15) # LenientLae/time4parison tion. The precisionPthe m0` # in nWlower tha)p stored. a .pyc: we # must allow a diA@encee at most one second. def _eq_T(t1, t2);P# dosR onlypcs even>s, so bet'abs(t1 -OQ <= 1 Gi>contentsA[co], unmarshals # and \@de object. R`NQif it9magic word doesn'tatch, or if&recorded@metat5 m4- source, # (we do this inst0of kring an as we fall back # toofU"@want&mask other e#s)$_code(self;`, full exc_details = {f'*!':? ,N } @flagV_bootstrap_external._classify_pycsC  hash_based$P& 0b106if %Jbcheck_ ;0<sif (_imp.2Ls,p'never'r6(6he or _imp.check_hash_based_pycs == 'always')): source_bytes = _get4_(self, fullpath);2if &>is not Nonedo*gGimp.(Y0_bootstrap_external._RAW_MAGIC_NUMBER,;\"-) 5>tryvalidatej?pyc@Tdata,)Oname, exc_details\:except ImportErrorareturnx7els 0mtiqsize = \0l(P_and_$?_of ;< # We don't use MPstamp`# to allow for a more lenient 8y check.;@if (A_eq_(_unpack_uint32(u[8:12]))I) orKA12:16]) !=@ m=._verbose_messageE f'code is stale{GN!r}'>B= marshal.loadsB16:]A!ifisinstance(60, _W_typeraise Type(f'compiled module {5 a Ls object& l0 = s!.___) # 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_2(p5  "".r!(bs', b'\n, *=1tGiven abuffer containcPython#, Q it #W ,>  nZ7&, [p'exec',Lt_inherit=True)!Co/ values foundZip archiveT% # that'mpatible "8Ma storeM.pyc filesparse_dos/S(d, t 0.mk((d >> 9) + 1980,## bits 9..15: yea/5) & 0xF. # bits 5..8: mconth d & 0x1F,# bits 0..4: day-xt >> 11, -11..15: hours1(2!5)e3e18..10: minute2R) * 2j20..7: seconds / 2gB-1, ()) # Given a path to a .pyc file in the archive, retur # modification time of/matchingIH@and &(size, # or (0, 0) if no source is available. def _get_m]P_and_@B_of_0a(self,!):2try strip 'c'q'o' from *.py[co]2)aassertHP[-1:]('c', 'o')'!='6:-1@toc_entry = ._= s[1&q# fetch"d stamp42.py+for comparison}# with an embedded I*%= &[5Xdate 6 unwRressei )3)_parse_dosr([,=), Lexcept (KeyError, Index AType k+ *contentso ,#INone/ #?pyc/# yu@ qF {ut\XMelseAdatal. x)!etcode object associatedImodule specified by # 'fullname'+_R|$, & m- -Usuffix, isbyteX apackagp_zip_seVorder z\2 + M\_bootstrap._verbose_message('try  {}"',#fSXB_sep", CVity=2 u G6pasR 0mod 0[# " = ,.'iflUunmarshal 4D , 7Pb4ilemodpath, data)' if code is None:(# bad magic number or non-matching mtime9qin bytea, try next)zcontinuBmodpath = toc_entry[0]<creturn^ispackage, ;,7elsraise ZipImportError(f"can't find<ule {fullname!r}", =) class _JResourceReaderE"""Priva/used to sup~c.get_rC!_rDA(). RThis pis allowGreference the innards and p{parts ofL%Azipi1er.1"""_registered = Falsedef __init__(self, E%, 5&.%( =3o'?% =JxEopen}*)pDC_as_7.replace('.', '/')/%f'E4}/{k%}'0from io E BytesIO6try(Pdata()except OS TFileNotFound%C=z$, =U# All@s arKRzip file, soPs no R!K`# Rais ` tellsH higher level APILpextract O# binary #0creS@a te  },isR pMaybe wuld do better, but ifQan ge, it's am. Otherwit isn't3y? = 2 e  /7TruCAents n bit convoluted, because will be a,#_sa list ofs relativet0top"&th# archive's5pace. We want:@comp*lsE;all t1s inside%represented byx. So wamodule|Fr into a relative to the#  # top of the archive, andn we iterate through _files looking forMnames insid2at "directory".) from pathlib import Path!0ullL_%! =(self.zip1aer.get*f8%))KrelativeK#."toB`Lp# Don'tget that P s a package, so its will include# __init__.py, whichswant to ignore7uassert .wW == 'L'c+ =;eparent,subdirs_seen = set(@for o=in %s:Na:tryV)@except ValueErrorcvcontinuj82# I7}" (z%is ~9zip#mpace),9 given whenQ resourcreader was created, haM,=Pn it'am usPvskip itI_M.V _rif len(6)v0}UyieldJWelif HP not RVI.add e A. HISTORY OF THE SOFTWARE = PythonRearly 1990s by Guido van Rossum at Stichting Mathematisch Centrum (CWI, see http://www.cwi.nl) in Netherlands successora language called ABC. remains 's principal author, althips many Cributions o`s. In#5,h+nd his work onv.pCorporaN>! N pal Reseha Initios (CNRnri.reston.va.us) inAton, VirginiamPre heeased several versp softwabMay 2000core developmeeam moved to BeOpen.com<AformDLabs team. In Octobe#same year 3j Digital C*:0becCWZope pm2001, the PythPon Software Foundation (PSF, see https://www.python.org/psf/) was formed, a non-profit organizaM created specifically to own PSA-rel#Intellectual Property. Zope Corporwas a sponsoring member of the PSF. All` releases 0Opeurce (see `openso Q3`Defini). Histor, most, but not all, have also been GPL-compatible;table below summarizesuvarious. R qDerived AYear t Owne z=Dfrom R? (1)0.9.0 thru 1.2;1991-1995 CWI1yes41.3:5<A7<9<%NR=<6P !1.C Q 2000 <!now%2.&&1.K; Be .c;Q1.6.15 ;CC (2){#AD2.0+T52001PSF {92.0{;-;2.1<$1+Pw<L5200<3<1<2 and above < @-nowW x Footnotes: (1)n doesn't mean that we're distribut[a undergGPL. blicenses, unlikeGPL, let youUeFa modified versvwithout makyyour changes  B ThE Be it possXoscombine mtother sibd3s don't. (2) Accordto Richard Stallman, !is ,`becauss! h`choice`law cl'|qBh, however,|'s lawyerOPtold *G@is "&inY".. ThanksV  many outside volunteers who TworkeJGuido's direcGG"ma3%se). B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE UPYTHON ============== Python software and documentation licensed under the9S9RFound2L.P VersB2. Starting with v3.8.6, examples, recip other code in the^dual ] PSF  VHZero-Clause BSDA6ome incorporated into#is differentDes. The>sA@fall Na?. PYTHON SOFTWARE FOUNDATION LICENSE VERS?2 - 1. ThisHAGREEMENT is between ("PSF"),+NaIndivior Organiz #("e") accessAand awise ut"("#@") iurce or binary form its associ . 2. Subject toPterms;` condiQs of ` Agree,Ihereby grantsWe a nonexclusive, royalty-free, world-wid reproduce, analyze, test, per /or display publicly, prepderivativedks, distribute[eAalonCwin any Gv , provided, however, that'GPSF's notif copyright, i.e., "C (c) 2001,23456789q10, 201<1<1<1<1<1<1<1<1< 20B$21 p; All Rs Reserved"aretainAM Ed by3r. 3. Ic ev7se8s aBworkagon or s!or@partBreofwrto makeJ E available@X   in5en @by a/s:QincluAsuch a brief summ!ofchanges madzP. 4.u0mak3 n "AS IS" basis. AMAKES NO REPRESENTIS OR WARRANTIES, EX IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMIK#hAND DISCLAIMS ANYzyZMERCHANTABILITYFITNESS FORAPARTICULAR PURPOSE&THAT THE UF PYTHON WILL NO>T INFRINGE ANY THIRD PARTY RIGHTS. 5. PSF SHALL NOT BE LIABLE TO LICENSEE ORCOTHER USERS OF PYTHON FINCIDENTAL, SPECI OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULTTMODIFYING, DISTRIBUT1OR WISE USING#, DERIVATIVE EOF, EVEN IF ADVISEDbTHE POSSIBILITNEREOF. 6. This License Agreement will automatically terminate upon a material breach of its (s and conditions. 7. Nothing in twshall be dd to cretany relaO0hipnagency, partnership, or joint venture betweenCand ?e. does not grant pPssion0useK trademarkssP name!a ! sZto endorse.promote productBservices0any/!rd y. 8. By copying, installZor otherwise ustPython,0e asbe bound bbe  $. BEOPEN.COM; AGREEMENT '2o 2.0 -Y e` SOURCChVERSION 1 1%%is BeOpen.com (" p"), hav0)an office at 160 Saratoga Avenue, Santa Clara, CA 95051,the IndividualqOrganiz4 ("") acces,  tqsoftwarTQsourc>binary formuuassociated docusSthe SI"). 2. Subject" HG#, !bhereby4Se a non-exclusive, royalty-free, world-wide lRto reeWalyze, test, and/or display publicl 0rep3derivatived0ks,,atributV(d s e 'Q alonl0in M0ver ,vided, however, thatI 4 is retained&-r,s" pIT. 3.`is mak vailable9 n "AS IS" basis.  MAKES NO REPRESATIONWARRANTIES, EX IMPLIEDDPY WAY{EXAMPLE, BUTn`LIMITAK,kAND DISCLAIMS }B|]MERCHANTABILITY O#R FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE UF SOFTWARE WILL NOT INFRINGEIQTHIRDO Y RIGHTS. 4. BEOPEN SHA6 BE LIABLE TO LICENSEuPOTHERvARS Ox xINCIDENTAL, SPECI OR CONSEQUENTIAL DAMAGESLOSS AS A RESULTZUSING, MODIFYING(DISTRIBUT{,ANY DERIVATIVEREOF, EVEN IF ADVISED]<POSSIBILITY,H. 5. This License Agreement will automatically terminate upon a material breach of its(s and conditions. 6lshall be governed by@ interpreted in all respects#the law of St of California, excludingflict of 6aprovis` Noth%Oin td"d to crerany rela0hip%agency, partnership, or joint venture between BeOpen?e. does not grant pst to useNtrademarksya namesK ! sto endorse/promote produoor servicesany thirdPy. A| ep,"Python" logos available at http://www.p&labs.com/-.html may-used accor toes!@ed oat web page. 7. By copying, installor otherwise us]software,,0e a-svqbe boun-*6[ l. CNRI~ AGREEMENT dPYTHON 1.6.1 -4 1nT4is xaCorpora for N al Research Initiatives, havan offic 1895 Preston White Drive,Dton, VA 20191 ("1"),IndividualxqOrganiz4 ("g ")!esZ T%  in sourc`binarym}its associa`@docu{. 2. SubjectB , r herebyhqe a nons) royalty-free, world-wide lRto ree=alyze, test, perfor/or display publicly, prepare derivd0ks,,atributVd(e WQ alonJ(nyM0ver,0vided, however!at 's License Agreement and CNRI's notice of copyright, i.e., "C (c) 1995-2001 Corporation for N al Research Initiatives; All RY s !rved" are retained in Python 1.6.1 alone orany derivOP versxprepared by Licensee. Alternately,>@lieu* Agreement,= may substitute the following text (omitthe quotes): "is made availableUqject toUPterms` condiFs  v. This together with ~be located ons InSet us unique, pZ#stent identifier (known as a handle): 1895.22/1013SIalso be obfrom a proxy server  URL: http://hdl.X.net/". 3. I ev#e ,J work that is bas/ uc*es0or @partXPreof,` wantsPmake ; i@to osUprovided herein,W%n @by a`pinclude0Bsucha brief summary ofcchange)toQ. 4.0mak N on an "AS IS" basis. HMAKES NO REPRESENTATIONS OR WARRANTIES, EX IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMIK,iAND DISCLAIMS ANY{z[MERCHANTABILITYFITNESS FORAPARTICULAR PURPOSE&THAT THE UF PYTHON@WILL INFRINGEI`THIRD OY RIGHTS. 5s2SHA4 BE LIABLE TO LICENSEsPOTHERt RSv 'PINCIDlL, SPECIAL,CONSEQUENTIAL DAMAGEt LOSS AS A RESULTZMODIFYING, DISTRIBUT1OR 0WIS9ING#, 7DERIVATIVE'REOF, EVEN IF ADVISEDhCSPOSSIEOF. 6.iwill automatically Fi0 up material breachin nO. 7lPshallPgover by federal intellectualperty laws0Uni|`States\out limit4YMX,SS!exT U.S.*A doe@ appCommonwealth of Virginia, excluding 's conflict of law provisions. Notwithstan7the foregoing, J regard to derivative works based on Python 1.6.1 that incorporate non-separable material(was previously distributed under GNU General Public License (GPL),& of Commonwealth shall govern thisI Agreement only asissues arisV$orspect to Paragraphs 4, 5, and 7zd dp. NothTi $@be d0creQany relat*hip of agency, partnership, or joint venture between CNRIwe. Thisdoes not grant permis@!2useLptradema1or  name in a ! sto endorseppromoteducts or servicesDQthirdy. 8. By clickQoQe "ACCEPT" button wherqdicatedLpby copy installBr otherwise u,40e a5*be bound byQtermsbQcondi3 ( CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 - Copyright (c) 1991 -5, StichtMathematisch Centrum Amsterdam, The Ne4lands. All W@s reled. P=,, modify8softwareNits docu bpurpos&out fee is "byAed, 2dedbQaboveice appear llin9R bothCF 9$(is/9notTq suppora GG/of 0or 3b!edRdvertAor p>0ity@tain5to t2ion%e xNific, written prior P. STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDV7xIMPLIED?OF MERCHANTABILITY AND FITNESSA` NO EVD SHE BE LIABLE sANY SPECIALLDIRECT OR CONSEQUENTIAL DAMAGES2 WHATSOEVER RESULFROM LOSS OF USE, DATA;PROFITS, WHETHER IN AN ACTION OF CONTRACT, N#EGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF)IN CONNE! WITH THE USGPERFORMAV F THIS SOFTWARE. ZERO-CLA.BSD LICENSE FOR CODE INNPYTHON DOCUMENTA/ -2L Permission to use, copy, modify, and/or distribute this software for any purpose with or  out fee is hereby granted. (  IS PROVIDED "AS IS" ANDAUTHOR DISCLAIMS ALL WARRANTIESv REGARD TOfp INCLUD6xIMPLIED>OF MERCHANTABILITY yFITNESS.NO EVENT SHEBE LIABLANY SPECIAL, DIRECT, IN /CONSEQUENTIAL DAMAGES;WHATSOEVER RESULTFROM LOSS OF_`, DATA;PROFITS, WHESIN AN.CONTRACT, N > OR  # system configuratkgenerated_vd by the/+6ule build_time_vars = {'ABIFLAGS': '', 'AC_APPLE_UNIVERSAL_BUILD': 0 "IXHDATEGENUINE_CPLUSLT_SOABINDROID_API_LEVELR/root/repo/emsdkupstreamcripten/emarR1rcsUBASEC-Wno-unused-result -Wsign-comp~-Wunreachable-codeG%PPIfMODLIB9B cpython/installs/-3.9.5/binOINLIBDEST?3libP23.9IL@RARYI2libona!`SHARED i"ccA  EX0XTq+_GNU_TYP1x86_64-pc-linux-gnu*YTESTR_DEPP!\\ CCR!&CCK ! -DNDEBUG -g ' '-fwrapv -O3 -Wall -O2'W-fPIC|?FORP_ALIA P-fno-ct-aliasingDR_NODI%ONFIGFILE75ure#re.ac acT.h py :.in'Makefile.pre.CfGURE_O 'CONFIGURE_C(FLAGS_NODIST': '-std=c99 -Wextra -Wno-unused-result ' '2parameter5 missing-field-initializers?strict-prototype3error=implicit-function-declara xfvisibility=hidden', 'CONFIGURE_CPPd]"I/root/repo/cpython/build/sqlite-autoconf-3270200/'-Mbzip2-1.0.2A#zlib-1.2.11%LDL!_ARGS': "'C@=-O2 -g -fPIC ' "S$"':=7P0'") '--without-pymalloc--disable-shared';Aipv6!en#big-digits=30P,qoptimizsEhost=wasm32-unknown-emscriptenO=x86_64-pc-linux-gnu1prefix=installs/o-3.9.5Gvo_alias|4(CCbemsdk/upstream*O/emcBPKG_o_PATH=&oLIBDIR}system/local/lib/pkg'7ig:sF@%'"NCLUDEDIRW/includeG/PYF!%33.9PREPYTHONYQVERAGE_INFOL!/Pct/coverage.infoIQREPORKPlcov-/rtIp_OPTION'--no-branch- --title "C Qn'p"q Vr. -I./I Ghon/build/sq lite-autoconf-3270200 ' '-I/root/repo/cpython/build/bzip2-1.0.27+zlib-1.2.11', 'CTYPES_FLAGS': '-DHAVE_FFI_PREP_CIF_VAR=1 LOSURE_LOC=1LC-!AL/{ XXrbemsdk/upstreamcripten/em++;qDESTDIR@"installs/2l-3.9.5'9O/lib=*?3.9G4-dynload;LIBO DF@PATHG`SHARED0Zh ldIRMODE': 755@DISToREADME.rst ChangeLog .Vigure b.ac acT.h py 8.inp'Makefile.pre Include Lib Misc Ext-dummyd+AFILE$ * ' LINCLDIR/.LLIBRARYOUBLE_IS_ARM_MIXED_ENDIAN_IEEE754': 0z*?BIG$nLITTLE'1K@TRAC'A_DEP#(\\RHEADE1OBJ-`YNLOADe_shlib.o#1ENA4PV6 EN0PIP4rupgrade,X:EXEEXPORTSFROM81&YMEXTRATESTOPT*_CEXT_SUFFI.R-39.s0644AFLOAT_WORDS_BIGFLOCK_NEEDS_LIBBSGETPGRP_4ARG2GITBRANCPGITTA GITVERSION@GNULY"'nTPCCEPT3 OSYDDRINFO': 0LARRIGNED_REQUIf[LOCA_YPLTZON;SIN&2SM_*+TA*BIND_TEXTDOMAIN_CODESEBLUETOOTH_ X ROKEN_MBSTOWCS': 0, 'HAVE _BROKEN_NICE': 0, 'HAVEPIPE_BUF?OLLSIX_SEMAPHORES$THREAD_SIGMASK#SEM_GETVALU1UNSETENV<UILTIN_ATOMIC': 7jCHFLAG[CHOWN&JROOT0LOCK:TIMC3>SETOMPUTED_GOTOjONFSTRiONIO_H{COPYSIGOPY_FILE_RANGQCRYPTE mjTERMID_*RPURSESp/TE /zHAS_KEY`IMMEDOx ePIS_PA_RESIZE#&v_OSYNCTYPEAHELUSE_CPWCHGApDECL_ISFINIT IN *NA.RTLD_DEEPBINPGLOBA S<0LAZ/OC7KMEMB qoNODELEsANOLOIu9NOWVATZNAqFVICE_MACRVL@V_PT .Y_PTMXRDIREC'*IRENT_D_ m0IRFxKLFCN|[DLOPE:UP2_:UP3 YLD_SHARED_CACHE_CONTAINTpYNAMIC_Y9INGH\ENDIA"EP_CREATE1AR0ERF^;2RRN0XECPLICIT_BZERO#EXZMEMSE/JEXPM{FACCESSWPFCHDIrZFCHMO; ( (F; (;NTLPFDATA8 3 FD JDWAL FE( F_ b ORJORKPTY': 1, 'HAVE_FPATHCONF': 1, 'HAVE_FSEEK64': 0O'^TATAT;VFS:YNCLTELLb bKTIME9kRUNCATU)Nv GAI_STRERRORnYGAMMAGCC_ASM_FOR_MC68881 X<=X878UINT128_RGETADDRINFGETC_UNLOCKEDETENTROPYkGRGID_ETGRNAM`OUPLISCG00OUPY3GETHOSTBYNA 0ej_3_ARGXO_R_5"6" I  `LOADAVq -\LOGIN;zPAGESIZ`GETPEEV-GILPGRPpP'mRIORIT@PWEN /PW?PWUlRANDOMz_SYSCALL/ESNRESUSP *MSPNAW1'LIBC_MEMMOVE_BUIRP_HMHQHTOLE7JHYPOIRIEEEFQc2IF_9DEXINET_ATO=PCITGRH\{NTTYPES!IO(PA_PURE_CONST!KIP*@QUEUV@LANGm*LARGEFILE_SUPPOR$pLCHFLAGJ@CHMOFJCHOWLa&0IBDk K^ IB }|LIBINTLIBREADLINLSOLVD@SEND 2UTI\)NKjKLINK[LINUX_CAN_BCM @_J19396RAW_FD_FRAME~v$ ^NUX_CAN_RAW_JOIN_FILTERS': 0, 'HAVE_LINUX_MEMFD_HNETLINKOQRTRoRANDOMOTIPCVM_SOCKETS1AWAITwOCKF': +LOG1P2NG_DOUBLEJSTATZUTIME.jMADVIS:yMAKEDEV<zMBRTOWCdPCREATAaMEMORYzMEMRCHRBKKDIRkMKFIFO' (;NOD'=NOD& '*MASLNAME<L_APPEND_HISTORRL_CATCH_SIGNA OMPLETIONECHARACTEG+DISPLAY_MZ OOJZ' < QPSUPPRs *PRE_INPUT_HjRESIZE_TERMI0OUNI1RTP@ dSCHED_GET_PRIORITX# 7!RR:kINTERVc"`SETAFF _PARAMo1SET$+UL0SEMu@VALUz M0EM_DWAIT': 0, 'HAVE_SEM_UNLINK': 0, 'HAVE_SENDFILETEGID': 1)>TEU'lGROUPS=}HOSTNAMilITIMER.ALOCA PnLPGRP>PRIORITYR?RESW?RESRS;JVBUF{HADOW_HmM_OPEN{IGACTIO-IGALTSTACIGFILLSET\IGINFO_T_SI_BANmTERRUP7PARAM_H': 1, 'HAVE_SYS_POLL_H': 1, 'HAVoRANDOMESOURCEoSELECT_NDFIL4OOCKE4oTATVFSN/TA1OYSCASYSMACROMYS_DOMAINj0oTERMIO?IMEN?TIM?TYP/U] {U OTSNA]?WAIQXATTRITCGETPGRP?TCSjEMPNAM* &i=jTGAMMA<KIMEGOF % MP(  W_R': tjM_ZONE<kRUNCATZJ <UCS4_TCL'@aUNISTDiLINKATyUSABLE_WCHAR_2UTIq LMENSDNSW rUID_CREUPENC_B GENERATE_Q?SAF$ 7UT34-IDP. _PCSCOLs0CSF jWCSXFRajWMEMCMWORKING_TZSEiWRITEV X509_VERIFY_PARAM_SET1_HOS;ZLIB_COPY_nTOST_GNU_': 'wasm32-unknown-emscripten'INCLDIRSTOMAK'/root/repo/cpython/installs/-3.9.5/include ' Ge?3.94Q0PUDEDICB 1STA'/usr/bi3 -co#@_DAT,(y -m 644/QPROGR2 +PSCRIP*n/install -c"', 'INSTALL_SHARED': '/usr/bin/install -c -m 7551`SONAME-libpython3.9.a!0O_HModules/_iom$.h$@OBJS'!\\WLDCXXroot/repo/emsdkupstreamcripten/emccCAFLAGUp_NODISTlpLIBRARY#LD 0DIR#5-pVERSIONR23.9U0IBC "DE/c^"s/-oS5/libSEFFI_INCLUDEFM4-lm3OBJ"P/1IBP/pkgconfigT PL~DB3.9/K1O2YTH ,__OMIT_FROZE!IB g-ldl <aSUBDIRtkinter Y/test _ Zmd5Q&gb_implsu@cachNBconnLgcursormicroprotocolNprepare_<T?row atement.o Modules/util.o Moduq_cryptm7' ''6bz2%Vqueue=multibytecodecfA@s_cn?_% hk% ;piso2022@ jp% @/kr twQlsprof.oFrotatingtree9e`decimarLbasearithNconstantstext.o Iconvolut cr1difradix,E(fn1pfourste7D'io`mpalloO&mpBnumbertheoryL3sixkLtransposxFmmapcVposixQVerrno&=.wd1_srxK8`weakre+_functools?qoperato|llectionB ab}Oiter|_atexiosignal0staL?tim*o_threa_localAi ioelAfileSs!CbufferedGastring"faulthandle dtracem_?_peg_pars> hsymtab.xxsubtype.o', 'MODULE_OBJS': '\\ULTIARCH _CPPFLAG/ VWDELCH_IS_EXPRESSION': 0aNO_AS_NEEDEDNlOBJECTvOPENSSL_INCLUDEb*LDz(IB-Th-DNDEBUG -g -fwrapv -O3 -WallOTHER_LIBTOOL_OP7PACKAGE_BUGREPORDNAMElSTRING?TAR-ETPGRP_HAVE_ARBpSGI_ABI|@ @1@HELLs/bin/sh2LIB#ldl -lmp_SUFFIX43.soM_NEEDS_LIBRTq SIGNED_RIGHT_SHIFT_ZERO_FILL^SITEPATHPMIZEOF_DOUBL-8S@FLOA_4@POS_'16 IN(0LON i @._8': 1OFFm1PID[0PTH0O_KEY 1SHO=2 AMTIME}UINTPTRVOID_P': NWCHA+@_BOO 1O12-39QLITEMODULENAM'_=\'"sqlite"\!'Parser /pegen Objects PT Modules/_io ProgramsRC_GDB_HOOKU./Tools/gdb2.py.PTDC_HR-TRICT_SYSV_CURSE"/* Don't use ncurses extensions */"pTRIPFLAL#'-AUBDI`0TOOInclude Lib Misc&YSdm_SELECT_WITH_1': TCLTK_INCLUDmMJ e"`PYTHON.M,(QRUNNE2 }scripts/run_Usj OU112054LIB1HM_INFZ/usr/share/zoneinfo:;lib& 5etc&UNICODE_DEP'UNIVERSALSDK9,PPDATE =3.9update_fileUSE_COMPUTED_GOTOnhI"3.zWINDOW_HAS_+.DECIMAL_CONTEXTVA8OC_STRING7(+%YLbLIBINTL': 0, 'WITH_NEXT_FRAMEWORK': 0,PYMALLOCVALGRINDX87_DOUBLE_ROUNDING MLLIBSUBDIRS': 'xml xml/domQetree qparsers @sax'abs_builddir>/root/repo/cpython/!/P e-3.9.5:?src8@datae9installs/ta/sharezexec_prefixB<7$-.'} This directory exists so that 3rd party packages can be ed here. Read the source for site.py more details. """A pure  implementation ofort.""" __all__ = ['__import__', ' amodulenvalidate_caches reload'] # Bootstrap help #!HtUntil bNping is cote, DO NOTR any s[attempt # to%Ulib._Y" (ly or in). Since this #ially initialise` wouldpresent in sys., those #1get an unT@copyversion,Pead #!La fu* (either2frozen oneW onubelow if1is not available). F ( # Just61tinaonent,pFsys try: _bortlib as  except IRError?efrom .F\@._setup(sys,b) elseD#? &iW!e 3-in%P, ensfwe don't createq# a second .#Q_namev '14 4)SW g2filg"__ .replace('__P__.py7Apy'){GNameye$# Q5guaranteedbfined, e.g.mqde getsaK by a tool like cx_Freeze>+2pas8n[A8] =Ev_external:_bootstrap_external._setup(_bootstrap) . A_ext6' =!k else:?.__name__ = 'importlib^'ClpackagF22try~ 2fil<"__ .replace('__init__.py', 'except NameErrorw$# Z) is not guaranteed to be defined, e.g. if this code gets# frozen by a tool like cx_Freeze.+2pas8sys.modules[e ] # To simplify s in test __uint32G.#O _un2 % # Fully bped at/cpoint, whatever you%<, circular # dependencies and startup overhead minimisation permitting :) s types warnings Public API #%w from "__t __ def invalidate_caches()"""Call the% method on & meta path finders stored inWJAeta_$`(wherelemented)."""*3forD% 8if hasattr(p=, ''1*.(#() !_loader(],S=NoneK"""Return+ &specified 4!. Tis a backward-compatible wrapper around_I(()?AfuncN isQrecat] favor ofMQutil. Ian. T('DepOsince Python 3.4. =1'Usn instead.',9 nBionW,@cklevel=2 {f!= 3]._%__k3if 10is 5raise ValukG('{}Gf5'.format)?rt;KeyW"Attribut ;setmz P&._B # We won't worry about mal 0ed Nps (missattributes).  if spec is None: areturn)~.loader0 submodule_search_locations4kraise ImportError('for {} missing w'.format(name),E%=))n! space packages do not havey/s'm Ci;/ def i_ ,u=~)2"""2 a ,!. SThe '' argumentXrequired when per(8a relative~A. ItMifies th to use aanchor point from which&presolve=O g#an absolut}1"""4level = 00if I.startswith('.'!$ot2,msg = ("# $to! K" F!r}"J&NBType9msg.Apcharact=n 6if "j!= '.'!rQbreak.DA+= 1|_bootstrap._gcd_s[2%:]{!, ) _RELOADING = {} re~(A"""RS and 'it:C musUbeen successfullyed before=)H!orisinstance, types.M( ")H%bev6try# =0.__F0__.except Attribut?8"__B2ys.Cs.geL",%Fin sEW,uvame in [] 2 Qpparent_<! =p.rparti4"[0U7if 1 W.( =[t[.1Key$ `!tAR {!r}v3~ MM+=5A_$7elspkgpath = parent.__path__ Uelse:0pkg$u = Nonetarget = modulEspec0.____ = _bootstrap._finds(name, d", V)f0if A1 is~ qraise MNotFoundError(f"6Pnot f for the {w`!r}", =uPexec(M,<'6# TRmay have replaced itself in sys.&%s!Yretur[]!vfinally'tr del _RELOADING;except KeyGpass """Core implementation ofort. ThisOT meant to be directly1ed! It has been designed such that it can< p(nto Python as@ As QLsrequire2DnjecCifics and attributes order to work. One should usdortlibpublic-facing vers.t% . V # # IMPORTANT: Whenever mak<Pchang'o <,@sure]run a top-level # `make regen-imp` followed by#` dfrozen # updated. Not doso will resultU0qMakefil@failU # all others who don've a ./prto freeze$ #aearly sta!of compil. # # Se._setup()! wc Xaglobal`space.JP edit@code0awaO0uteB time CANNOT # reference any iPed ob1s! Iincludes Sonly dbut alsoO@nythyaclass BP@-rel L#"& _external def _wrap(new, old)UA"""S substitutefunctools.`>rper."""$or,B['____', '__ Hqualrdoc__'] if{T(old,Z"1set#,( 9new.__dict__`2) 3newxrtype(sys) A loc"!## A P mapp>LUweakrefs of _ModuleL8ock instances # Dictionary protected by the global import lock _module_ s = {} # A dict mapping thread ids to _M2)Loy _bBbing_onG class _DeadError(Runtime ): pass /_"""A recursiveplementa which is able de# dzsgT(e.g.Q1 tryRo takX0s A(n B, and,2,I0B01A).A""" def __init__(self, name.B = _b.allocat!()J,owakeup.n! =u Gowner = Nonecount = 0`waiter0Dhas_^$# ` avoid for concurrent circularBorts?'meget_ident atid = ?e{(se.while TrueNcz.get(tidx)#ifss3 F!return FalsQi.1if ;= mT6~in seen# bpo 38091: chain om's we enjer herb# eventually lea a fixpoint or a cycle, butAdoes not reach 'me'. This meanPwould%@#aca>can happen if other?Ls are at`beginnof acquire() belowz}tB.add%{Q OAtm?U. If a potential1ed,jGaM&fraisedOQwise,n'dalwaysd_ES[tid]:tryBwith 8 "if"P == 0k?tid=A+)gO+= 1(Di$ 9.t  #('k detected by %r' % self) !if.wakeup.acquire(False):3FQ.waiters += 1* # Wait for a release() call,N &QLzfinallydel _blocking_on[tid] 45defZ tid = _thread.get_ident(Bwith8\ tRowner != tid"A raise RuntimeError('cannotC un- d g'Bbassertcount > 0.-N== 0@i= None^bF C%G" "&r__repr__((return '_ModuleLock({!r}) at {}'.format7.name, id)) class _DummyB"""A simple _ equivalenPython builds 1outbmulti-Ging support."""c__init , ! =X/& 0O2 / ?FTrueD}v 3+m  Manager: __ =Oente4_ym.l 2)'ex\*args, **kw G# The followtwo functions arr consumpB by 1/imAc.  4"""Get or create the ETgiven?.A/ i] Irglobal Pto protec_lfs5_im'trf j T[]?%except KeyBq4"if!is 2$if is None:  lock = _DummyModuleLock(name) (y else:@ ; *def cb(ref, Z=)N_imp.acquire_[(r>try9$# bpo-31070: Check if another thread created a new c HQ# aft6e previous. was destroyed<but before the weakrqallbackDcalled.BQif _mRs.get is ref:del<[k]gofinallJereleas B bEP.ref([B, cb ocareturnl0 90_unRy B"""A2sn#n  GO for a given!. @This_used to ensure a+is completely initialized, inzFevent itJbeing impors+by1""":E3get" /+&except _DeadRError%# Concurrcircular, we'll acCPa par KXbobjectApass& ..() # Frame stripp&magic #Jp_with_fU s_removed(f, *args, **kwdsq2""""cortlib:P.c wi@lwaysR sequence#of=Blib { that end 0 a Mt]functionp1Use(0nst ofRormal6in places where includ,T1libn~pintrodu4Punwanv0noii0ntoa traceP(e.g.\n executingM3cod*f(Vverbose_message( Vity=1QPrint/.`stderr-v/PYTHONVERBOSEW ded on.if sys.flags.gRe >= 'itsif not mp.starts(('#', 'Y3 ')2 = '# ' +C3!p .ft*), file=)4!res_builtin(fxny"""Decoratoraverify+d=&-i7 \in_wrapper(self, fullname): %if not in sys.builtin_module_5s5< raise ImportError('{!r} isH!a CB-in D'.format(,Pu=.-return fxn(s#_wrap(_requires_!in@per,9)*I+v def frozen(fxnA """Decorator to verify the d<A."""|Y x!if\_imp.is_TQ)M?e *0 # Typically used by loader classes as a method replacement. -Oshimyq"""Loadspecifie1nto1@s anjAit. DThisis deprecated. UseS.exec insteadA60 =  m_%er , 'R2ys. $s[r]J_(v,.cE4AFelser/R)Mfifications ##b_repr( # The impl mB of aType._7Q__().g = getattQA, '_er__', Noneaif has+<2, 'Z'A# As soonBwVFs_Namespace!erJ@drop+irSs for. we can add aCion warning here g6tryGex_except E:ionHApass+ bw# =0.__!__(OAttributeTP !ifi4n{)# We could~A__._8$__f'i1the# variousr permutsw ZeError: name = '?' Atry: Cfile module.__!__#except AttributeError>if loader is None]return '<[ {!r}>'.format(w)f,?els> (D)E,M I_ from ,  class MBSpec """The specification for a a, usedQing. A!!'s>2tJQource0"inS`about !Wa. ForIdata associated with*, including s]"!'sF#er``absolute9!of;`:.T toQ when u`parent<w aAwpackageqPin. v>PderivgcJ3is_I` determines iEconsidered a 2 enot. On`s this5`reflecx!by`__path__` a'eorigin63 lo:,IIwhich tok,8at 1is available. W" iRset, will matchDhas_P` indeAat aB's "@#" 5s a.{/tTrue, `U$a[4setecached94 bytecodeany. Itcorresponds toB2`__<2subcu_searchssequence` entri&9`importYs!f  should be4--and False otherwiseP&s are simplyF(may) have zg ha@non- value in `4,FEbsystemNP4 aslsOnly finders (see alib.abc.MetaPathF#A and{ %!REntry&)Tgmodify instance2"""def __init__(self,_4, *>=2b_state")Gb.! =h<<1r =Ie6# = :oader_state = loader_state .self.submodule_search_locations = [] if is_package else None Ft# file-7 attributes#iP_set_+!{ = Fals_cached =cdef __repr__(I%):X1arg'name={!r}'.format*.%),/" '1%)]30if t.origin is notW.append('-_-))_sAE={}'p .Dreturn '{}({})o__class__.__{__, ', '.join(#"))8#eqw, otherbsmsl =|:try2 ==eE and=24 44 /Hu5hasexcept A_ErroriNotImplemented@propertyjd/isa%X#) b if _bootstrap_external041rai":=jS._get"VpKK:q.setter| P", #XG# = P Rparen7Cp"""The  of the -2's 2A."""lp.rpartiv('.')[0  >D GM< Xw, value_ Rbool(*0 spec_from_s( ,R, *, =,p"""Return a module )spec based on various loader methods.""" if hasattr(", 'get_filename'):(, _bootstrap_external is None(, raise NotImplementedErrorNQ_froml_location = e.. Oif is_packageoeturn K(,(= )_search = []4k!el%ne,rh,<<submodule_7"s=) :try/# =5.M>1except Import U U # aka, undefined*x B# the default(| = False'MSASpec, origin=,a=R) def _X(N=S [# This funcis meant for use in _setup(). w2 = m".__(sAttributevBpass('ls!if#D?notG:_#ifO tIK# ##qwill stay:! O } >Z#ifDC sq_ORIGINm  #KW(m hcached9,! =]3isti.__path__x V ^"y3.[u:E qB Tru@= .s = submodul-e_search_locations return spec def _init_module_attrs(", , *, override=False):K# The passed-in0 may be not support Vibute assignment,Din which case we simply don't set theB#s.8__name__Dif (p or gett('.', None) is 6try =.;! =6.wu$except AttrZErrorG!0# __loader / b"n2if 8# A backward compatibility hackj)"if2sub `ea i@_bootstrap_external404raise NotImple6!edb&_NamespaceLb? = n.' I0,= +\ew__()Dd._path7 ?~. %q# Whiledocs say that.__file__bJ?forIVbuiltas, andYcode below will avoidting it ifP5haszf9`, thisincorrect for SNpackages.  @ havk A, bu2i ____.origin} us,irCshould alsoFconsistency. a bit of aW#best place to ensur8is ] See # https://' .python.org/3/library/imlib.html#Babc.Q&j2bpo-32305 1=|'zC__ =4y2z0{=oparent&? uX! = spec except AttributeError: Apass # __path__if override or getattr(module, '-', None) is Zif spec.sub6_search_locations4;not86tryIF.z/ =` :e # file__/__cached5has9V9 Boorigin&9 .F$__,+rreturn kc def `_from_()"""Create a( based on the provided1""" # Typically loaders will implement cZ_1().<! =#aif has.R9, '@'L# If^ 0s ``n it means defaultpBdion should be used*(.6e)[/elCexec1raise Import"('d`s thatGine >A() 'm'must also< ")'i3QC_new5R.name?S_init_s",F%4OreprR(0 to@ forQ.We mostly replici() using> =st = '?' R else(G  k"#''.format(kJ,> (D)E,R NlT pooC s}.name, spec.origin) # Used by importlib.reload() and _ _module_shim(). def _exec(spec, ): """Execute the "!'sSified- in an existing's namespace."""Q! =B. qwith _MLockManager(!if sys.m(Rs.get"s is notw0rmsg = '4Q {!r}+(inKs'.formaO<qraise IPError(msg,=.:try{@pec.u erJNone$c(2sub_search_locations<@P'miss{'u)@4# N package.%T_init?Yattrs3, override=Truee?elsR)!if0haso0, ''F8 # (issue19713) Once Builtin!er9ExtensionFileLoaderTw# have z () lemented, we can add a depreO@warn?hers V Hkfinallc# Upda%order of inserX intoqC for # clean-up at shutdownD 2pop '[-#8] =dreturn U_backward_compatibleiQA-1,.# ! )er fexcept"w%]AXS# The must be,this point!7Move it to0endW9Gaif getWA, '_uper__', ) >.<L except AttributeError: Apassif getattr(module, '__package__', None) is F6try Z# Since G.E th__ may not line up with{5# spec.sub;_search_paths, we can't necessarily relyE"onHparent here.#^& =iname__1!if>has *')ea.rpartition('.')[0]rexcept A'g:! =B"creturnO def _load_unlocked(d1# A helper for direct use by the import system!if.U erU# Not a kcspace C S, 'exec_ backward_compatible <B]`_from_j%# This must be done before putting L in . # (otherwise an optimiza] shortcut inM.c become>bwrong)._initializ}a= True 4sys[7m]1i 5 $( 1locs<@ raIB`('miss<!',!=)@ E` so doBhing9-Felsebu.\jw @ @Q8del PA Key YH 5Dh# Move!tohend of1# W't ensur@!at7-related% Us}!se n replacemcase. SuchOs are onHtheir ownAA.pop.|i_verbose_mBge('q {!r} #"',b ovfinally: RFalsec method used during testing of _load_unlocked() and by #module_shim(). de3 (spec): """Return a new 4 object, beUP the 8"'s1r. A4The5 is not added to its parent,GIf a-already in sys.{s, that eximQ getsqclobberedU1"""qwith _M.LockManagerS.namer A) # Loaders #1 class BuiltinImporter:@"""Meta path i` for b.3-in0sAll methods are either bor static#to avoid!ne.instantiateAdR%_ORIGIN = ""@h,^b_repr( tj T(zQ is deprecated. #machinery does0jobs7elfNV2f''- Pfind_B(cls, fullU,=None, target !if$?+kif _imp.is_4in(s[*>Q_from%er/!, origin=cls)mOelse'@db"""Fin@If '-'1Aever0ifi1hen `search"`consid0 a failureNCThis.. oFUse  ) 4$eax\^a =M.5R.dAr if y escreate_gQself,I YC&, aX-#inc,sRaise Error('{M v'.format,UM=d J`_call__frames_removed('%!Cexec(S` UOExecS  gc d @_requires_builtin def get_code(cls, fullname):!%"""Return None as C -in modules do not have L objects."""HrE @classmethod__requ_sourc6N7is_packagOFalsPare never NJ@KRload_7 = X'(__shim) ! FrozenImporter:J"""Meta path ia for f-.-BAll  s beither or static#to avoid thQed toinstantiatedC%_ORIGIN = ""@f* _repr(m/s3The is deprecated. machinery doesjob itselfNV"''.format(m.__;__,.)* find_spec,=, target if _imp.is_c(e*mf%er/!, Norigin=cls?Felsee ;"""Find aOThisFUse O ) 7ead>Ocls J Lccreatem default semB!cs  F1ion-Dexecl;i# =!._Z0__.S!if =#I)braise tqError('!isA J,oJ%=)) = _call_with_frames_removed(_*, G (L,odict__ zMo"""Loa) """ + return _load_module_shim(cls, fullname) @classmethod_requires_frozendef get_codeH:!LB"""R|@the + object for R E."""<@imp.i*_@(+_sourcNone as }s do not have LBYis_packag~True ifOc is a I_\is\ # Import itself #+! ^" _VLockContext:%3""" manager+iAlock*__enter__()!Ac Aa)__( ]3xit\, exc_type Cvalu traceback|Release regardless of any raisedaqeptionsrM resolve_(,s, level+ a relative 8 to an absolute onedbits =Y.rsplit('.'dQ - 1)pif len(12) <TError('attemptedbeyond top-'jbY = j1[0]}5'{}.{}'.format(),))Pelse " Gfind_spec_legacy("er8S#thI # This would be a good placea DeprecaWarning if# we ended up gothat route.$Rer = ."thoPoaderml{WAfrom#erSu)path, target=S """Find aJ0's a9Pmeta_=u = sys.5if B# Py)_Cleanup()&1runSor has been called@1i"H, Pythonvlikely I `"shuttSdown")!if"_w s. -('3y',-W# We check;Rs herhA re case. Whilpassed-in 2 # target will usually indicate a reload there is no guarantee, was # sys.modules provides one. 3is_M= name in2$for findermeta_path:e with _ImportLockContext()#':tryYs_spec =e.a)except AttributeErrorPK_E_legacy(1er, , )`d1if @~is None^%continue>?els/M(c},}?not# The parent in may have alreadye2is 0if `1and.N( ="[] e_ D__ = DV# We useb found@sinc at'0the] thatnGwe wouldUqused ifVx_hadn'Ebeaten us to<Junchoareturn U64if 7-c g>o :2. & def _sanity_check#ckage, levelI"""Verify arguments are "sane"."""pinstanceT3strIaise TypJ#(' must be st2ot {}'.format(typR"))"ifF < 05r`DValua[[>= 0'A>A#pa #__.!__0seta3ingz;#elj1s('attemptedSativev no known'L'x6(==\SEmptyR ') _ERR_MSG_PREFIX = 'No&5d '%< = 0+ '{!r}'CP_and_~_unlocked^_b`! =>e.rpartition('.')[0] if pareSnt:  if parent not in sys.modules&-_call_with_frames_removed(import_,J)]# Crazy side-effects!if nameu Yretur[4]E_( =[,:trycpath =D0.__%__cexcept AttributeErrorI msg = (_ERR_MSG + '; {!r} isYa package').format(3jqraise MNotFounduQ(msg,5=>) from Nonespec = _find_ d"th0if 6s){FelseN_load_unlocked(|5# Set the ?tas an aws on its.w.H qchild =C.rpartition('.')[2*0set(m!, P,2Pf"Cany=set{mF2forlk! {zE!r}"y_warnings. /IWVh _NEEDS_LOADING = object() defR1andV)"""Find and 2.""<" _LockManagerPG 4.ge2 7$if:is %%'Z$,  ` \ :pmessage'5 of {} halted; 'By'E 'c| n_qfhBgcd_*=, level=02"""WPTbasedQN1 isbeing made,V1v adjustment.This func representsY greatest common denominator7Sality~Ttween_A__. tincludes sett-'Q__ ifOoader did_sanity_checkmh"ifvF > 0Nresolve_E_find_and_loa%d(name, _gcd_import) def _handle_fromlist(module, ", 1!_, *, recursive=False): """Figure out what _h__ should return. 24TheX parameter is a callable which takes the B of 1 toJ@. It?required to decouple=function assumingWlib'sNqlementa4`is desX1"""/ # `hell t!is`IC ...$If a package was_orted, trya stuffBGDrfor x ix|Pif noinstance(x, str#&if=swhere =[0.__l__ + '.__all__'-OelseG0"``? "''+6raise TypeError(f"Item{} must be*, =A f"{type(x)5}")elif x == '*'; and hasattr' Q=;C>[=True xy = '{}.{}'.forma&6, x`:try!_p_with_fs_removed(_+s Oexcept MQNotFound~ as excm$# Backwards-compatibility dictates we ignore failedS#_s trigge%byQ LWat don'tGRexist if (exc.#Wq.an6Qsys.mes.get(2, _NEEDS_LOADING)4Non\AcontinueYjscalc_____(globals?"""Calculatz,#beHguarante|be defined or c etto representBts proper value_dunknow;|3 = \''Nspec&#__#%if!isP0if 0-!!= v.parent8_warnings. '("` != __Z#__< Cf"({t0!r}?{><a!r})",Y  ImportWarning, stacklevel=3) %return packageelif spec is not None:62!q.parent7els%"_ww s. ("can't resolven from __K__ or __Q__, "Xs "falling back on __name__ andDoth__",@ = globals['g%']Z@if 'q'-$in13P .rpartition('.')[0W`& def __i0__(,d=, locals Vlist=(), "0)2""" a module. SThe '' argument used to infer where the "`occurrzOto handle relativ01s. k jqignored"F'P(,ifies what should exist as attributesmP beed (e.g. ``f<zr>``). <'J!represents9Ein aJ T..pkgqmod`` whave a 's' of 2)"""/"ifR == 0~s = _gcdLJ  _4 ifr 81 {}g= _calc_Y4__(Vr.,"3!ifa2# R upqfirst dot in '3'X iscomplicated by2fac0# t\7f may b.kBr m0 3vYN/| (# Figure outbo slicA0's c -\v#; cut_off = lenE% -  WSend needsqbe posi)to alleviate"!bal-casK#en ``'.&``(DBsys."s[. [: #)-]0hash(,,gq__5, mqbuiltinW_name(name):  spec = BuiltinImporter.find_(name) if.is None:braise <Error('no bS-in module IQd ' + Sreturn _load_unlocked(x) def _setup(sys_mHc, _imp )@"""S'! iclib by ing neededs and inject&Atheminto the globalqspace. As sys isY0for.rs acces_*0to P7, those two4 s must be explicitly passe1"""Fq,( =3=%H# Set up Aexis in/froze!s.Qm_type = E,0 in{.s.items(Pif isinstance([=c,0`X_s(-.er%Aelif=B.is_PF+erOs7econtinue+!= zmbJS_init)a_attrsL<)PDirecLE0durbootstrapCselfc C![_k1__]('_thread', '_warnings weakref'"if!inY@ notE4syss n1AfromD(<,el(Lv[E0sets(!,V ll2ZI#ll1ersE eta_path.append(3*  _externalc>"""that requir< filesystemcp H3zen:lib&_>ES5'._%) """Corelementation of 1-bas. ThisPNOT meant to!ded! It has been designed such that it c(an be bootstrapped into Python as the implementation ofort. As such it require2Dnjec-0specific modules and attributes in order to work. One should usdortlibpublic-facing versCthisg. """ # IMPORTANT: Whenever mak:Pchang'o :,sure to run a top-level # `make regen-imp` followed by#`A getLdfrozen #Nd updated. Not doso will resultU0qMakefilfail for # all others who don't have a ./pProundafreeze!inearly # sta!of compil. # # Se._setup()p what iVglobal namespace.JP edit@code0awaOexecuted `} time CANNOT # reference any iPed ob@s! T"includes not only dbut alsoO@nythyaclass Isbuiltin"s !V _imp o &sy"uwarning&marshal _MS_WINDOWS = (sys.platform == 'win32') if +S: 0 nt;8_oswinreg else-Tposix0 Wpath_separators = ['\\', '/']R("# Assump#@made_.join() asserl(len(sep)1_0sep10$) 4 = 5[0]_tuple = (*F;a = ''. + seps_with_colon = {f':{s}' } Bx@-rel #" _CASE_INSENSITIVE_PLATFORMS_STR_KEY_win',- TBYTES/1cyg2P 'dar ; _ = ( [/+ H ) def __Ex_case()(f .p.starts =iA"oIM0key`PYTHON5OK'+/*b'01:"""True if 'p must be checked c2ase-insensitively and ignore environment flags are not set.""" breturn1ys.1.J_Jakey in _os. IQelse: def _relax_case()"""True if filenames must be checked 9 QFalse|{1 pack_uint32(x"""Convert a 32-bit integer to little-endian|c(int(x) & 0xF).to_bytes(4, '@$')(unNdata!4 @b?$an0assAlen(PX == 4 int.from% "16I!2/2 if _MS_WINDOWSpath_join(* SpartsJ]rReplace`or os.+.6)>.!if_Jj00if o1)u17%1[0]Tgoot = T(F = [$for new_root, tail@map(y_1b_split! lG0.st*Qwith(0sep_tuple) n_.ends% ]|% =u.rstrip]qarators^+<a_sep +%(el;':'-0if j.<fold() !?# Drive T `s havebsolved by the OS, so w et Zabut dorQadd aaprefix.=h$Lg A 8.append(<)^8 > :`\p4p+Fif p}-:[0]# Avoid losing%'s trail2sep` when (Ihingr1% +#6) Zacement for os.path.join().""" preturn B_sep#[part.rstrip(arators);B @for ?# iV As if]) def _WAplitb!):X"""Replacement Ms,qi = max>.rfind(p)2p|9sepif i < 0m1'',B[:i][i + 1:],taStat theO!. QsMade a e function to make it easieroverride`experi sJ(e.g. cache sjresults)j@_os.'% {is_mode_type , Test wheth1 isspecified5 EW6try`~t_info =4except OSError9QFalse)(R1.st & 0o170000) == Risfilg-v400o1y0]1dirVq5dirpaif not= @os.getcwd( 04if _MS_WINDOWS\Xisabs0-3oot[3rooOR[0].r ('/', '\\'?@len(4) > 1 and rtswith('\\:@ or *E.end')) else?g write_atomicb, dataf=0o666IBest-effortJE8FaD TQally.FPBe pr ed&PhandlFileExistspconcurr[`ing ofItemporary ] at5ted`# id()"usppgeneratrpseudo-randomEBname(tmp = '{}.{}'.formm,W#)#fdKAopen?Q_tmp,.O_EXCL | UCREATbWRONLYxXzI # We fir"v,then use osA) toYP# per3 an6 re$P _io.IO(fd, 'wb') as?+ file.write(dcata) _os.replace(path_tmp, $except OSError:86try LIeunlinkHBFEpassWraise _code_type = (_write_atomic._!_) # Finder/loader utility C/ #NdMagic word to reject .pyc files generated by other Python versions. # It should change for each incompatible changeithe byte. # # The value of CR and LF isC2rposo if you ever read or 0F # a in text mode qm number will be wrong; also,& # Apple MPW compiler swaps"irs, botching strconstantre were a varietyold schemes '@sett? .D currentk(< to0rem?previous by # 10`AStarh@with adoptionPEP 31475A3.2,e`y bumpA3 # C4ludes a new "$ tag", i.e. a humana/`used # drepresAcin __pycache__ directories. When XM8he @,AmustC setTuniqu-qtag. Glly this # can"named after8 TmajorD}7, but # itO0reaapbe anyt>, as longit's diffeEthan)Q elsea&come before. >tags ared`follow<t3, s 1 # C3.2a.RKnownGTs: # 1.5: 201216.1: 1/.26KP50428K422.0=823h/5014\60202414?2: 2N<717N3a0: 6201l11 (!)R4R4R14a3l5!b165N781 (ast-branchA@91 (!22 ({d WITH_CLEANUP op8b101 (fix{:  x,?...:@ :x += yield7Python 2.5c1 : 62121 (fix wrong lnotab with for loops and # !storing constants that should have been removed)LPython 2.5c23Qcode:x, in ...listcomp/genexpM16a0M 51 (peephole optimization STORE_MAP opjH1H61 (WITH_CLEANU0L 67~C71 (u e  `rehens/change LIST_APPENDL8LPcondial branches:Q introduce POP_JUMP_IF_FALSE OTRUE )F91 (M`SETUP_1)201BUILD_SET010qMAP_ADD0SET :3000: c3010 (w UNARY_CONVER 43020 (added ,3,keyword-only parameters :4:signature an}8 50 (print becomes a func6m60 (PEP 3115 metaclass syntax6Q1 (stliteralsuH uni4 q09 raise 337 make __file__P__nam { kill str8 interning1merge from 2.6a0, see/51853 (1poio source ;`3.0a4:Q .6 b16lexical excep stacking!@clud{EXCEPT E#302l!1al4qtKdict~ Fd, add ]#21835P8 M471528hU #610h tag: cp<-3202a27) DUP_TOP_TWO,IXTROT_FOUR #922 s: cpython-320 # Python 3.2a3 3180 (add DELETE_DEREF #4617)203a1290 (__class__ super closure changed;200 (PEP 3155 __qualname__ added #13448>1ed size modulo 2**32 to the pyc headerL?645L2 3220 ( 80 implementation #14230A4A30 (revertsCVicit !^#1485U4U250 (evaluate posial default argus before keyword-only?s #1696~6Z LOAD_CLASS; allow locals of overridfree var|M7853I70 (various tweakID>237Jaremove>} UcompuO9301F3%moK#arc2 33Jlter& N20625P3465: Matrix multiplicoperator #21176 5b3Jt48: AddUnpacking GeneralizXs #2292Oy340 (fix dicry display |"or?120b33GET_YIELD_FROM_ITER opcode #24400!5."51 BUILD_MAP_UNPACK_WITH_CALLH>728"t6a0 33>FORMAT_VALUE:>548661 (lineno deltac ode.co_lnotab becomes sign"N2610!6aLp16 bit ?66421CONST_KEY>714Es2 (MAKE_FUNCTION sfg#, %CLOSUREn #27096(73gSTRING.07=:5:SETUP_ANNOTAS and STORETs /9836 (  y K Bs & nr _#2721KY7 (seyell from type.__new__ #23722) # ,Python 3.6b2 3378 (add BUILD_TUPLE_UNPACK_WITH_CALL #28257C0rc1C9 (more thorough __class__ validation07a1"90LOAD_METHOD and opcodes #26110!7a 91 (update GET_AITER #3170934}2 (PEP 552: Deterministic pycs>/65qb 3 (remove STORE_ANNOTATION _ #325A54Astored docstring as the first stmt inSbody; this might affected8Jline number=91180400ve frame block handlto compilH?176H1END_ASYNC_FO?304|!10C570 @PosiIal-Only Pa0ter>6548411 (Reverse evaluorder of key: ueaOdict\rehensionzN5224Azq2 (Swap~ps qal argso3in ast.argumentO7593413 (Fix "break"r"continue""finally" #3783O9a0 342PASSERA_ERR?488;1 (simplified byte for withc>2942/pBEGIN_FINALLY, a :4POP(xi>3389J2423IS_OP, CONTAIN ?JUMP_IF_NOT_EXC_MATCH]M9156]4 y5 *e unpackingC5CD # # MAGIC must change when@emit7!bymay no # longer bpderstoo0 olVeks~ loop (usum # due tog1add03new>1s).W_NUMBER is!d,Drsramagic_Ps array #PC/launcher.cAalso<Id. h= (3425).to_'s(2, 'little') + b'\r\n' _RAW_;int.from:E # For import.c _PYCACHE = '__pycache__' _OPT opt-' SOURCE_SUFFIXES = ['@.py'] # _setup() adds .pyw as needed. BYTECODE_SUFFIXES = ['.pyc'] # Deprecat,oDEBUG_1OPTIMIZED 24 def cache_from_source(path, debug_override=None, *, optimization=): """Given the CP to a file, retur!it c"!. H5The5 does not)Qexist; this simplyXsx1theM2.py]p calculBx!if/1.py{ were importc<'' parameter controlvyresumed level ofMbytecodes[. If _iU,string representuPoargument is taken and verified1be alphanumeric (else ValueErrorNis raised) @is dcN +`a True vvphe same@sett !tobempty Kwhile a FaRpequival ?to T3'1'pIf sys.DeC\.0tagn NotImpl)!ed9!5Q1"""+if<*O,0_warnings. ('" Ho sq; use 'mJ "Jinstead", FBionW})E*ifjmessage = '*orCpmust be ?B Typ([~q.' ]1v= _os.fs Ohead, tail = _g_split#base, sepAst =/.rpartition('.'N!=@ gKHU/('palmost_^nM= ''.join([(-#Srest)Btag]i'cflags.fe == 0$F~, `< RHstr(!n!if>8.isalnum(d('{!r}D'.format almost_filen2ame = '{}.{}{}'.format(almost_filename, _OPT, optimization) f"; = 4 + BYTECODE_SUFFIXES[0]6if sys.pycache_prefix is not None:'a# We need an absolute path to the pyRavoidossibility ofNcollisions within , omeone has two differentM`foo/bar.py` onz irQatem any import both of%pm using Ns. Let's say[6C`C:\Bytecode`;` idea here`@that we get `Foo\Bar`, we firsvmake itv(_PSomewP\= ),i$n 0root-relative/(`< so}end up plac# bWin anNunambiguous \e5\`.8!ifd_A_isabs(head)qu2 = &join(_os.getcwd(), %) U# Strip initial drive from a Windows.@knowHhaveO2, ssecond partD check rules out a POSIXi Qphappens$PcontaM colon at acharacter3[1] == ':'!0]N!inu_separatorsO3?2:]9FB`7`ampleteconversio@back*)a  before 6inghreturn9 , 0.ls()*N@DT, _PYCACHE,) def source_b_Czq"""GivePto a 8.J#, r>J0its#!.0ThecB doeto existdis simplyXs 1 toi.calculatedpcorrespsR. If}J!0con>PEP 3147/488 at, ValueError will be raised. I Qement.G@_tag'`n NotIv)"edU$isP(1"""5?ys.Y c/(''?i =  fs  Ihe = _path_split(path) found_in_pycache_prefix = False${if sys."is not None:'Ostripped_b/ =8!.r$_separatorsCif head.startswith(2V + ]<)y:7! =>J[len75):]-5Tru*|x#, 1 = 0_spj '!= _PYCACHEJraise ValueError(f'{*}s bottom-level directory in 'N 0f'{;B!r}'dot_count =_filename.3('.,6if /in {2, 3}expected only 2 or 3Is{u)elqF== 3hoptimizationr}'.', 2)[-2!ifDBkK_OPTW "=A por4of ;B doe/ " " {|B!r}"Bopt_(= u/4.isalnum( fq{pC!r} /an "alphanumeric vEbasePpartiNw"[0creturnWPjoin(V*, O+ SOURCE_SUFFIXES[0]) def _get_source(bytecode"""Convert a !pb to a D(if possible). This func exists purely for backwards-compatibilit@@PyImQ_ExecCodeModuleWithF0s();the C APIz"""f0if V == 0?Qvrest, _, extensU B*.r7q>=.lower()[-3:-1] != 'py' bR6try&lJa_from_ @except (NotImplementedG,Sb e [W0,#if!isRe) elseC d(7hi?B.endktuple()2 1d-source(filename)#  except NotImplementedError:$+Apass!elif filename.endswith(tuple(BYTECODE_SUFFIXES))Gereturn<N-se" None def _calc_mode(pathN"""Calculate the ! permissions for a bytecodetA."""t6trys:0= _^R_stath1.stv1$+OS<Q0o666)# We always ensure write access so we can updacached^ # r even whenRsourcs are read-only on Windows (#6074)|= 0o200r~\Pheck_v(method_ Decorator to verify thatmodule being requested matches#!onzaloaderhandle.  Thrst arguz (self) must define a whichZfsecond3i9compared against. If0ison failn Import is raised($_wrapper , 7=, *args, **kw F6!if(c+wB0 = . c1 !=E =#('h %soBnot re %s' %ae)=X6J33' q oE = _bootstrap.*hAName# XXX yuck)(new, olreplace in ['_ule__', '_Y @qualvdoc__']Rif hasattr(old, b&1set++3, g A`=new.__dict__.-p.;=(_c#, /( DfindCshim1ful`"""Try07 a rpspecifi "y delegat*!toA_?#()xCThis1pdeprecaZiPvor o{Qnder.Aq?q# Call !b2it ps a strc(indichL#au sp?package 4@ion)0ner`a warnK1and#f .,@sl2$if]!isI and len(s-msg = 'Not idirectory {}: missing __init__3' _warnings. (msg.format(portions[0]), ImW-)?,return loader def _classify_pyc(data, name, exc_details):@`"""Pern basic validity checking of a pyc heeS and wthe flags field,Swhich determines how *Dshould be furtherqated against,source. R*A* iscontentsWfile. (Only$first 16 bytes areIrequired, though.)aa ]module be i`ed. Itused for logginggUPa dicpary pas7#toError if it rai1forimproved debub :s7Awhenmagic numberincorrect or &h)_. EOF^-found toPtrunc1"""Z = 4A[:4]2if != MAGIC_NUMBERmessage = f'bad/0n {a!r}: {J7!r}Nbootstrap._verbose_Qs('{}', Bpx(#G, **2aif lenYo) < 16preachedL while readH M%of0 = _unpack_uint32R[4:8]&+# >3twoare defined.U& ~0b11!inNE{2V!r} irSmate_timestampP _m#, Csize @"""V)3ate last-modified z>{! 4 C_ F@None<N;m=5 5mS(And@codeDstal/if` 8:12]) != (source_mtime & 0#xFC): message = f'bytecode is stale for {name!r}'4_bootstrap._verbose_Hs('{}', )3raise ImportError(#, **exc_details2if (source_siznot None andV_unpack_uint32(data[12:16]) !=D6& 0  def _validate_hash_pyc#,  , N(, C"""V@0 a ,-based pyc by checking the realW+ against&!in%,@header. *(*contents of>/file. (Onlyfirst 16 "Qs areIrequired.)Y`ilib.util.#$()t wK'D ,module be ]`ed. Itu1tloggingoUa dictionary pas7(toq if it dimproved debub*An=s:iV9 [2"""Y f  [8J i(= f'71 inodoesn\'t match,$of;,H #) compile_=,S_pathB"""CP6 as founda.(= marshal.loads9 is Pance(-0, _S_typer+ 1 object from { qLiP(_imp._fix_co_1Ypreturn FelseS P'Non-."in.format() =!,  : de_to_timestamp0, m%=0#=0"Produce^b0 a 4I.!%=#array(MAGIC_NUMBER3#.extend(_/0)! % +Qdumps% 72a,ded=Tru510ytearray(MAGIC_NUMBER) flags = 0b1 | checked << 1 data.extend(_pack_uint32(8)D assert len(source_hash) == 8F" marshal.dumps(codecpreturn def de_Oxqbytes):XA"""D$  representing 7 CS and `the string. EUniversal newline support is used in 68V1"""?!im,tokenize # To avoid bootstrap issues.2_Q_readup= _io.B*IO.%?Pencod$= u.detect_ ?c_2er xIncrementalNYr(None, True@G G.O y[0])) # Module specifications ## _POPULATE = object(hCc_from_file_lomt(name, =*BadernAsubmu_search[%s=R"a 40 ba]Pon a `To indae that@Pis a age, set to a list of directory paths. AnARempty'is sufficient, though its not otherwise!0ful`1theEdsystemPhe lo[ must take a!asWonly __init__() arjf# # The caller may simply want,rtially populatedM-E or!ed. So wea~0a bogus valueaF@fill6as much asF2cankK= ''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 Bis o", but doesn't actu}cexist,Huwe could here,."no#id. However, we \don't have a good way of testing since an # indirect location (e.g. a zip file or URL) will look like aBnon-existent1relative to thesystem. 5#spec = _bootstrap.ModuleSpec(name, loader, origin=)@._set_fileattr = True_# Pick aE if one wasprovided.K%if&qs None:3for_class, suffixes in _get_supported_6s()EId^.endswith(tuple(R)37N) =P.\.;%Ubreak7els$areturnSSet subm _search_paths appropriatelyW -s is _POPULATE+q# Check3L`if has(, 'is_package'>6tryW?/S.X Nexcept Im^ErrorUEpassHfL6if kF#4A= []j b7TO?if D|0dirt_split(2)[0+w .append(V)<a # L(?s #1!  WindowsRegistryFinder:"""Meta ! f *s declared$L# rMB."""JREGISTRY_KEY = ('Software\\Python Co{sys_version}'6"\\Fs\\{full"}'lo_DEBUGrFs\\Debugyl_BUILD = FalsewRChang%3up(@amethoddef _open_B(cls, key (winreg.OpenKey(HKEY_CURRENT_USEROp/OSYLOCAL_MACHINEZ[K wif cls.Q~ registry_key = cls.REGISTRY_KEY_DEBUG Uelse:oregist@,_..format(fullname= ,5a sys_version='%d.%d' % sys._info[:2])N:tryAwithd_open_(key) as hke2filepath = winreg.QueryValue(3F, ''vexcept OSErrorreturn Nonef @classmethoddef find_spec(cls, ? =U, target )|]v_searchKio!isOv q_0_stFc)for loader, suffixes in _get_supported__('s(P.endst(tuple(R)37t = _bootstrap.S_fromjS D ;)O"uorigin=Euo omoduleq-"""Find 2 dDthe j.oRThis  is deprecated. Use exec_L() instead@5"""$,w1if 0ois not%.i! 1 _LrBasics:"""Base "of common code needed by both SourceE2 anslessFil.is_package(self! Concrete implementation of Intz.Pchecking ifr! r{a has aof '__init__.py'J5#= 8Aplit.U(U))[1]? _bh=u1.rsH'.', 1)[03Qtail_=Np.rpartiv('.')[20Zj=' W! dcreatez default semantics  G1ionF]9[/): "" "Execute the module.""" code = self.get_((__name__).0if ! is None:Nraise ImportError('cannot load} {!r} when o9) 'IM r'returnv'.format_bootstrap._call_with_frames_removed(exec,,p.__dict1def_(&`, full)s"""ThisGdeprecatedo a\_shimf class SourceLoader(_Basics): path_mtimeI Optional method that s(Pifica' K (an int) for#ospecified h (a str).!RAs OS/ be handled.YZC[Co_statsPing a`adata  gPossible keys 1- '~' (mandatory)qnumericTstamp of last st P;- 'size' (oa in bytes]v\RImplementtRallow er to readVVfiles2# {>:| &)}p_cache__-", "  which wri;/ (] s) a L 6]o-ofL3Thenis needed2ordcorrectly transfer permissionsMF# For backwards compatibility, we delega-`o set_(V= d$8:[hConcrete i]DPof InZtkP #tk(o6tryuO_bytes = self.get_data(path) except OSError as exc:&raise Import&('source not available through gej9)',IM name=full `) from6return decode_v(_bytes) ,Cdef 0to_-p(self, , , *, _optimize=-1)B"""Rj@the ? object compiledc.tPThe 'd' argument can be anyE0typaO`() supP!s.L5""" _bootstrap._call_with_frames_removed( _'execwdont_inherit=True, +5m(g TConcrete impleation of InspectLoader.NZpReading,l requires_stats tomaed. To writeNA3, s must als>_H0 = [@file(t2mtime = NonsLhash_based = FalsRScheck 0 = 6tryxP`cache_|Bb *DNotI!ed_ Jelse/ $stg.  _ Epassint(st['&'] ,(vM X xc_detailf{ '4': '9': /}o3@flag_classify_pyc(=,FGs = memoryviewMo)[16:]; f& 0b1 != 066if 9Y c0d Aif (_imp.Ft,s@ 'never' and  (check_source or " R_imp.6hash_based_pycs == 'always')):Ku_bytes = self.get_data(_path)J1 = @(@_RAW_MAGIC_NUMBER,7h2_validate_X(#, i, fullnamer exc_detailsOelse timestamp7&m]st['size'],=*W H except (ImportError, EOF !Opass  _bootstrap._verbose_message('{} matches {}', Pcode_b ?A*return _compilex(s , =X LU= = $ifks is Non/:"dobjectE0to_T  E bBfrom e Hif (not sys.dont_writJ andD1  g- 0if X|&Hq( r)N9M46_toEc", W Q cHh= len(source_bytes)) Itry:self._cache5code(source_path, KJdataX except NotImplementedErroroEpassqreturn ] object class FileLoader: 0"""Base file l +twhich i{Es th"protocol method!atPcrequirPsystem usage."""sdef __init__((, fullname, )@"""CD}pmodule )A and01 to found byafindery.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-argubWm of super sZWationTrof that6can be upd without breaking*3zen8I9t( , ().+ @get_  R*IH as S KGN G(mrx1raw&sPif is-CanceY!(SZer, ExtensionK)x _io.open_+Q(str()}@3f.read(Jelse1d!IO]_, 'r'a&B# Re Re ABC API/~r6_#er0!ifk.is_package($FNoneW}vxp1 = b_join( Qsplit7.#e)[0], @ { d8[ULeif not6(resource):   raise FileNotFoundError #path = _b_join( split(self.)[0], resource)?preturn # tdef is_*B, name):!y!if2q_sep in!WUFalse6er;Ppisfile(O)contents;iter(_os.listdir')) class S.}vLoader( ,"):"""Concrete implementation of2 using the system."""JC_sta,uB"""RGmetadata forX?Q%stVB){'mtime': st.st_f, 'siz }_cache_bytecode", l$, # Adapt betweentwo APIs@modePcalc_ (b @set_k(!, E=JH3As , D4, *3W0o666"""Writes.Q to a qparent,_ _parts = [] # Figure out what directories are mis_.3bwhile ~ and not5 isr;Z/"th.append($# Create needed7YpreverseHZF}:try'mk5aexceptaExistsF# Probably another Python process already cd6diro6inu9!OS as excCould be a per @on e5qad-onlyt`: just69getxA# abg4rit_bootstrap._verbose_message('cua {!r}:-',uy:exc1P  _wq_atomic  Q 'l&th>`# Sameabove: just don't write the bytecode. $_bootstrap._verbose_message('could not create {!r}:', path,MX exc) class SourcelessFileLoader( 2, _Basics): g2""" which handles sN file imports."""9def get_(self, fullname):[0 = ..L#(,+Hdata+(@)## Call _ify_pyc to do b validation of"but ignorNresult. There's noUcheck againstexc_details = {N'%':  '+':}B (S', xreturn _compile_(UmemoryviewVj)[16:]= T_= ) 5B"""RpNone asHre i{Qg3$ # Filled in by _setup(). EXTENSION_SUFFIXES = [] ExtensionTfor eC modules.The constructordesignedJwork withseFinder: O__init__AQJ0 = ! =bE__eqUWotherP]s"._a__ == *5andmuj__dict5c__hashF) ^ J7_4g, specUB"""C]an unitializedQ8 = Pcall__frames_removedaS_imp.sdynamic2U  X lad from'x .;,l4#JexecH" JI@? anB 9,z*v,)Q?ute.>elf.1pis_packlname): - """Return True if the extension module is a package.""" <file_name = _path_split(self.E)[1].rkGany(9= '__init__' + suffix4f3for in EXTENSION_SUFFIXES) 6def get_code`, full!):"PNone as ancannot create a Ty objectK _sourc }s have no L} q@_checkv 1 to~C.found byofinder  class _NamespacePathppresentk#u0's . It useswm.0to 0 it/Crent, and from8re it looks up0 pa.!'sG__. When this changes,/ya's own"recomputed,GQusing_er. For top-levelTHais sysNb6,pv0 = /Kc! =C Rlast_r = tupl ._o;())@Za.ds+(R of (~---|Q-attr)6q, dot,  @.rpartition('.' if0b == ''B0# T+. . containt.5MS'sys', ''!}# Not aL. . tF/ {,~7__' 9<_0th_0 = 4.q0get=( X.s[g]h_recalculat2# IS4 ha7d, ?J5b # MakN%pyC#ifF! { sEspecJl7.i _path) 6 # Note that no changes are made if a loader is returned, but we # do remember the new parent path - [@specWnot None and .s:9E"if( submodule_search_locations48`self._/ =B u9Rlast_EbP# SavRee copyE; H def __iter__()3._recalculate())BsgetitemE~, indexLb G[+]MsM,SLC! =#J3len9?len?rep'_NamespacePath({!r})'.format[ )contains , 73 in xaappendj H.'S) # We us$is exclusivelypPfrom_ () for backward-compatibility. class LC[5nitBname _fr' =X`>@emethodb(cls, qA"""RV %:(.[XBThe ]20dep`ted. import machinery doesajob itN1"""Z"'S!0.__'__Xis_package@full&hBTrueget_sourc9*''7?cod50ile('', ' exec', dont_inherit=rcreate_ """Use default semantics9 G@ion.uv [/]Fpass 1d0"""0 a }s K/isL) instead@9#~system never calll.5 _bootstrap._verbose_mess?'ad with`%',NR)0 return _b)ootstrap._load_module_shim(self, fullname) # Finders #1 class PathY: """Meta path fs for sys.and package ____ attributes."""J@bamethod[ def invalidate_caches(cls): Call the,") O@ on &~c entrysIstored in_importerz (where implemented),]MTlist(  R.items()G%if@fs None?del[].elif hasu(=, 'Z';..,/()Ahook,]"""Search-8aN''e,if6ais not* m rY A_warnings. *(', is empty', IW/)TX = i:tryRpreturn @(Wcexcepty^ErrorBcontinue;els$e= _1GetdsQ6rom V.!IfH9!inBappropriate/ it. If no#available, !x!ifj == ''r= _os.getcwd(FileNotFound# Don't Sfailure as cwd can easily change toA# a , directory later on.."> =[l?KeyLHcls."D >T En# =aiK_legacy_get_spec4s'er # This would be a good placea Deprecation'5 if# we ended up going that route_loader'):   loader, portions = finder._(fullname) 7e else:+ @omodule@2t%[]L3if Kis not Nonk return _bootstrap.spec_from,M+( ==MESpec,v 5B.sub_search_loca6o @classmethoddef _get_$d(cls, i, path, target=)o"""Find the@ or `space_< for this /package'A."""B# If*ends up being a+R =,e'isGaist of s that will become its _<%__; '= entry inU!if$isinstance(-, (str, bytes);4continueer = cls. imser_cach]5#if2 'hasattr(g0, ' '5 R! :Aflegacy.erX1if A!is" _]>. ,D C&if 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.@or ' "'.#BThe `QXbased4p_hooks G_if path is None7: path = sys. spec = cls._get_(fullname, ,, target)50if ( is Nonejareturn1#el3.loader:s`space_wpec.submodule_search_locations_:if @ ## We found at least one8B. RaYwhichlMcan create thFmckage.45.origin ="S# = _Name'GPath ,fq ;els..*T'@classmethoddef find_j(cls, p=e)0"""2e65 onP or '0x' based_hooks an|_importer_cache. "RThis deprecated. Use6() instead>5"""J%\\!sX^eVsdistribu=z*args, **kw vkYFind >-n iterable of all Dp+ances cap&a2ingetadata for paKps match#``context.%``D1(orvps if ``0q`` indiS) alog3As intElistIof directories q3&``Rfrom TTlib.m# MN%ero".5 w(1 bR FileY:0"""-K#er IncQ with@fileVtem are d`erformq, beingrefreshed wheI9ySnPhandlhas been modifie<LU!__init__(self*%er_detailsInitializeB to 7aQ varinumber ofyh`2-tupl`ontain{I+quffixes!Hrecognizes.[&es = [],4, sT2in  s.extend((8, loader) for suffix in Ses) self._loaders =  # Base (directory) path @! =u or '.' if not _#u_isabs(3%):'# =0join(_os.getcwd(), % amtime = -1Z1@cachLset(?relaxed)Kdef invalidate_KE"""I$U the 7 A."""Oqfind_modul_a_shim %X, fullnamepTry to /# aA forspecified ms,HQspacep package portions. Returns (, list-of-#").?This method is deprecated. Use_() instead> =Rpec =60if PnJNonerr E, []59. 2sub#_search_loca 3"[]B_get,sf_class,4, smsl, target|>(=_from_file 7=d,=)=w:"""rmatchingf efound.P5is_v = FalsFtailp.rpartiv('.')[2B:trykAstat.<Q).st_1except OSError["ifp# !#wT =.*l" =Y(# QkeepsToriginal casing,_ie__ and friendsJAif _g_case(q( G-g.lower;els jb'p# Check|[lW of a"(sthus a h)1if "in Abase = _path_joi n(self.path, tail_module)  for suffix, loader_class in @_)s:7Binit_filename = '__C_' +T 4Pfull_1 = _join(base!, CV uf8 is%(Q)0Treturget_spec( , D []?JrgetNelsetp# If a Ospace package, thth if we don't'# find a 9next section.66is_x`Visdira# Check  a M w/ a propev existsl.0 >try,xn w$xTexcept ValueErrorgyINone3_bootstrap._verbose_message('trying {}'(Zity=2if cacheeiT 4$v 8if [ F possibleAV` IMS2 , 9Q.subm/_search_loca.Gs =  !zg @def !l_]t"""Fill ! of potentialTs andszthis directory."""n" =  M0coni_os.list5@ or getcwd()4:(FileNotFoundB, PermissionTNotAD%#  has either been removed, ed into r,:mad# unreadablezg%[]# We store twoPd ver s, to handle runtime changes&th}# PYTHONCASEOK environment variif not sys.platform.startswith('win'&E$t( \ # Windows users can import\with case-insensitive file # suffixes (for legacy reasons). Make the( lowercase herL o it's done once instead of _every import. This is safe asupecifiedes to check aga^ are always s/Kin aPC-sen ymanner.%__contents = set()*item in ):"ename, dot,0 = 6.partition('.'Z8 if5P@new_X = '{}.{}'.format(i..()\OelseZK S T.add( nself._path_cache => Ciif sys.plat.startswith(_CASE_INSENSITIVE_PLATFORMS)vzrelaxed~4{fn(fn!} @classmethodAdef hook(cls, *loader_detailsQ"""A B C which returns a closure us&&as8Cwill= a0staXRusingQs andOcalled on.o!If4 ,not a directory, IvError igraised^5""" P_for_FileFinder(O"""Path ?lib.machinery.C.l@0if  Oisdif*e('only1iesn0supAed',=KA cls3zI_ )5__repr__(%A'e({!r})0.3 #Oup #+! fix_up_module(ns, B c S=None#@func cused by Py\_ExecCodeM\Object() = ns.get('__#__V 4G6pec% Bpec.2eli%E == ESourcelessLO)M2 = HDame) if not spec: ! =_from_file_location(name, path rloader=)F6tryO`ns['__UC__']Y'p=  "@{ "ccachedDc%except E6ion # Not important enough to re.epass def _get_sup!$ed2s()\"""Returns a list of -based module 1s. gEach item i7rtuple ($, suffixes)1"""5extensions = E QFileLu, _imp.'_H(source = S 9SOURCE_SUFFIXESovbytecod1Hless5{BYTECOD7r % [2s, z$, S]_setup(_bootstrap_m.[S!A theSsers forclib by ing neededsuilt-ins and inject* th1ntohpglobal SspaceOther components are extracted >?Ucore rDc2sys&, ' =# sy)A.sys 6.wCselfE2ys.p@s[__2__])# Directly#os" (\@ dur@os_detail('posix', ['/']), ('ntQ\\', bRin_osx_separators in Z|W# AssumpP made)_S_join* assert all(len(sep) == 1F0sep98u9=! =1[0]&6if Psd*/os?V0UbreakhJelseP 1e+_e(&osB {fIMZError$continue graise >"('requires 8 or nt')setattr(, '_os',+'_/!'.VI)F  seps_with_colon', {f':{s}'- U} . builtin_na mes = ['_io', '_warnings marshal'] if builtin_os == 'nt':names.append('winreg')'5forC'9 insNm*0not.sys.module,~ = _bootstrap._Pfrom_O( EFelse(W[E#3setattr(self_8,!) # ConstantsH'_relax_case', _make"()EXTENSION_SUFFIXES.extB_imp sion_suffixes9wfSOURCEUC.pywif '_d.pyd' e"WindowsRegistryFinder.DEBUG_BUILD = True def _i'6ll(h)XB"""I# the path-based import components."""no_setupS0sup9ed_loader3V_get_Dfile(,}b_hooksvsd([File&(*Jc&)]FPmeta_-XBPathD#) $os )4lib0zip9temfunctool?pcontextBq7package(k! Return a Traversable object cgiven @.r@fallback_resourcesp.__spec__)+!f_directory =@lib.<(,.origin).parent2tryEqarchivez1 = 4.4+4rel' |.tI3to(9-?@*d, str(ec) + '/qexcept E6ion2pasK^ F @. rmanagerl.0(re", 23=''j# Not using -.NamedTenale as it leads to deeper 'try'E# blocks due!2@need Qcloseb`orary work on ELproperly.qfd, rawt& =0mksQ( os.write(I 11os.2(fd=Zyieldt%gfinalln sCos.remove(:LNotFoundError&5 @.ledispatch @contextlib.c manager def as_file(path): """Given a Traversable object, return thatQ as a8K oe local b system iS .8xwith _temp8.read_bytes, suffix=g`.name){iRyield~C @.registerUP# @ $_/  Degenerate behavior for HZs( """Abstract base classes related to import.cfrom .` _boot=/p _external"machinery try6g _frozen_lib except IPErrorp3exc8Qf exc] != 'A'(Qraise & = Nonej \3' =5 D abc warnings7dtypingwProtocol, runtime_check" 0gas_cls, *J.0cls*9Acls)?#.ifq is notKM. = getattr(?, cls.__l&__FAttribute  z'ir aA) O Finder(meta=abc.ABCMeta): I"""Legacy XfM"s.7It may be sub]!ed.compatibility l`third partyz reimplementations of theg/. Otherwise, ? =should derive Mmore specific H0or REntryD ABCpDeprecasince Python 3.3> @\Camethodc_module(self, fullN,.=-nNkR2 a T]95The[ a str andX opg!alt!or.FRs a Loader )l Z(Je0 ^6@sys._!I# We don't define _P() hewould break \ # hasattr checks we do to support backward compatibility. def find_module(self, fullname, path):  """Return a loader for the AW.SIf no is found, r@None. Then%a str andG\Bpathplist of&ings or J0This method3deprecated since Python 3.4 in favor ofopfinder._spec(). If$p existsn]$s-^&leLunctionaqprovided 565"""@@warn. ("MetaPathF!mo)^Q " aD(available`e3.4)",o DBionW*stacklevel=2)NiTt'&')olCw = selff/C6."ifu1notQ else def invalidate_caches"""An op%clearingf}Qer's F, if any. used by imNlib.)>r _register(, machinery.BuiltinIW(erVFroze ?:WindowsR"ry) class 54Ent( :e@`bstrac2se 5A3e:?$s TH.*0# W80n't1ine6D herthat would break5`&, 0(+, namespace Cion)]e `q Lpa seque;'_ies contributQo parapackage.4vZmay be empty. qb, U willHbe ignored.a`discarDWother(%erX lo:as a normaloC  zd_spec() is provided than backwards-compatible functionality is <.#5""" warnings. ("PathEntryFinder.find_loader()N deprecated since Python R"3.4 in favor of bospec()E(availableve3.4)",mDBionW*stacklevel=2)Nif not hasattr(self, ' 5'):+rreturn None, []found = @I>(fullnamep,!isyJ c&.submodule_search_locas51por( =Oelse0 m N40$, }*t8<+j = _bootstrap_external._#a_shim 9def invalidate_caches"""An op al method for clearing the bQer's F, if anyEDThis=is used by<)? _register(, machinery.FileR) class LAmeta=abc.ABCMeta): b8ct base * im !s.@0cre<< ,  BR"a ( to initialize and into whichk.i=should raise ISErrorr thprevents itEQfrom "Sa new. It may `@indiDAthat TeT4/# By default, erh semanticswWQ## We don'tSine exec_ld() her wBQbreak# checks wO1supC Bi/q%, 63""" 3$ed$3The must be adbo sys.s6Rhave @-relhHibutes setperly. bSa str: Vsk0d oWilure+7is i/)r.E. If p existsQ@n it/ to. able functionality for this method. 5""" if not hasattr(self, 'exec_module'):-@raise ImportErrorreturn _bootstrap._loadHS_shim`fullname)Bdef mD_rep~B"""Rca/0's 1Used by the$ type when Q doesNotImplemented]TN is deprecate\# The excep will cause M\aType.___ to ignoreu class ResourceLoader("):eP"""Abct base 4&ers which can data from;iback-end storage 1ABCesents one of<! oal protocols specifisPEP 302Mc@abc.a2@get_TJpath-9 it should9Pbytes@l|k0.  must be a str.4!OSJ InLt%0sup" iMion abouto@syaCis_packageGD"""O`whetheeb#a yy" @s a bool GRs" ia0can(be found.'?cod M :p object `s.Codezpossible, elsV|NIif a=make sen:(e.g. built-in?). a3i0 = .\()F2if e 3\<@_to_( - K#th module. The fullname is a str. Return3 "Raises ImportError if the module cannot be found.:5""" rFEa@staticmethod-def source_to_code(data, path=''):/"""Compile ',' into a > object.p/(argumentanything that cU!()handle. The''F`shouldIQwhere% was retrieved (when applicable).*}@ , 'exec', dont_inherit=True)"_m= _bootstrap_external._LoaderBasics.0Oload@0 _register(Inspectk, machinery.BuiltinK(erUFroze) class ExecutionN \"):P"""Abct base <@for 2erswish to supa1 of@s as scripts< This ABC represents one o opal protocols ified in PEP 302Moc@abc.a get_filee(self, As which rQ@valuAat _Z __Qto be cset toJ M$6 S5N0if  (e.g. b3-in)!0 = .()i3:try%mJohexcept KpOelse=)C *ExtensionFile/(B, ReC,j\ partially impleE8eY2 an Js:7S  (Fless,ass SourceLoader(_bootstrap_external.SourceLo!Y, ResExecution!): """AbI ct base class for loading H code (and opHally anyGcorrespon2@byte/").eTo supportUHfromZs, the amethods inherited 0j   need to be implemented. To alsO`  specified directly by this ABCOis requiredI 8not5 inL*.get_datap" #filename2""" def path_mtime(self,%):Q"""Reture (int) modifica ;#Np (str).f0if ]._stats.__func__ is $Draise OSErrorr1int>(m1)[';'])4aaaU dict0poiM_e=Possible keys#- (mandatory)Hqnumeric]stamp of last'] ;- 'size' (aes]v.EY ${:0D}s ,  W2O!to c (if pAccepts a strZ]1 ass/!nyf0ed rmediaryories are&ae crea!IfOEsomelRreasoj@ canbe written becausepermissions, failGs:tly _register(q, machinery63Fil:B) j ReRQ(meta=abc.ABCMetaG to provide r3-reWVes that-4 4TPexpec&to? `` 9_9per(full 0)``1hod9have it either rY2Nonor an object compatEwithq2@ xTopen_ ~pened, file-like object for binary reading. The 'resource' argument is expected to represonly a file nameJ!and thus not contain any subdirectory componentstIf the @ canEbe found, FileNotFPErroruraised.5""" 7@abc.abstractmethod95def_path(self,!):':"""Return psystem 82specifiedCz2doe}exist o!, [  <4is_ubTrue iK%0d '',consider a02 an iterable of strings over=B5package.l[] _register(RReader, machinery.S Lo) @runtime_check class Travers(Protocol3An M`with a0setlib.Path M`s suitP|+tdDing @ies 4@openEs>w7 U?diry;XYieldPs in *r>o_bytesu "iA as :r Atextq`, encoS=None9?is_c |@is a0is_sm9n@joino, childv '/E#__truediv__|A @abc.abstra"ctmethod def open(self, mode='r', *args, **kw !):/35""" 0 may be 'r' or 'rb' toV as textbinary. Return a handleK suitable for reading (sameFpathlib.Path.5). ;AWhenp3s, accepts encoMparameters suchWFthos2ed by io.TextIOWrapper.n @abc.abstractpropertyVAnameV;# type: () -> str. UThe base C of this object without any parent references class Travers]Resources( cReader &\files5"""gthe loaded package.B(#_r`$, !r7.`).join(0()b_,Bbaise FileNotFoundError]R,is[,0.is(}contentea(item.X@ in iterdir()) """ImachineryIimportlib: finders, hooks, etc- _imp from ._boot#p ModuleSpec#BuiltinI|/er(_Froze'_external{(SOURCE_SUFFIXES, DEBUG_BYTECODfIOPTIMIZED2 EEXTENSION) WindowsRegistryF7,,S2L 2Oless6Extension5 all_suffixes(G[s a listall recognizedDule ;;-pprocessiB 1. +> +  $io $os $re 4abc 4csv %sy+Temail4lib0zipLDatorfunctoolL PposixU3 collections from configparser import ConfigP from contextlib$suppress 9{_module$D.abcGMetaPathFinder)tertools%starmap __all__ = [ 'Distribution',XPackageNotFoundErrordJs)entry_pointEfile metadata1frequir Fvers] class !(MB !):"""The p was not fE."""XEP(99`collec6s.namedtuple(',Base', ' value group')1An   as defined by Python0ingE2vent eSee `t%idocs oXs,`_Bfor more inform+..pattern = re.compile5br'(?P<>[\w.]+)\s*'D?pr'(:\s*&Dattr$,)?&?P\[.*\]"$I)SWA regular exuion describ4Bpsyntax a>which might look like:c"- xh/e. :e<:object.*#! [11, "2]Other combins are possible~Rwell...is lenient about whitespace ar3 F#':dfollow]f, and 2anysDdef load(self,Rq"""Loadh6a#it<i. If only a`is indf, return that6!. 5Bwise' e #d w-match = ...{/# =(1.?"('P&')6_s = filter(None, 5#') or '').split('.EAfunc=.reduce(get= , #s,)&@property6 yw@W'ef extras(seclf): match = self.pattern.(evalue)/return list(re.finditer(r'\w+', : .group('extras') or '')) G@classmethoddef _from_config(cls, {[4 cls(name, !, {(2for3 inW.sections(+O1oitems(^]Btext A = CParser(delimUVs='='-# case sensitive: https://stackoverflow.com/q/1611799/8121834s0.opPxform%tr!6try>2read_string(2except AttributeError: # pragma: noc2W# Python 2 has no b *qfp(io.S"IO!!EntryPoint.Vet_f!__5"""pSupply ) so one mayFstruct dicts of ws easily.FRR(z.qn#nreduceB(_P?1.__\9__, g.,4 1A) J PackagePath(pathlib.PurePosix8"""A reference to a 0B FJ, encoding='utf-8'YBwithlocate().open(3 ) as stream3.{( q_binary{O'rb'n$}iB"""R\/th-like object AthisSFRdist.]R_fileFileHashc__init`g, spec.mode, _,~70pec.partiF(c__reprVP$'< ]B: {} 0>'.!at~{ Di buS Rion p.7@abc.abstract Hi`ttemptload metadata / given by the =."a:param(3: T$B0B!in< FinfoQ:N@ if found, otherwise None4 """ %@abc.abstractmethod def locate_file(self, path):!%5""" qGiven a#` to a 8 in this distribution, retur.Ceto it.^ k@classfrom_name(cls, RdWthe D}P for gqpackage@!. oa:paramB: Th 1 of: Ato searcha:E instance (or sub`Preof)F r, if foundnraises P@NotF!Error: Whed'kmetadata cannot ber*Zresolvercls._discover_'s(7ODs = !('Finder.Context(=)))D@ = n$Piter(s), None+!if@ is !)hJelse*rnm)P**kwargs3"""0an @able objects.4allsPass a ``cDp`` or pkeyword argumenHconstructing#a ?Z:h: A `` ro: Iter{2 = Ic.pop(''$ifC and3QValue>#("oaccept@"gx% =')or (otools.chain.3(.>} Tkstatic>at( s@indiS%d YC'w@: a 3"ngsth-like`Kcretg]?DtHPath@lib. )  B"""S(_$(s.declared = getattr(f$0, ' js for finder in sys.meta_path )return filter(None, declared) '@classmethod def _local(cls, root='.'):h from pep517 import build, 'system =.compat_(W?er = functools.partial(P{a..,source_dir=Z =z , PathDistribution(zipfile.(_as_zip(Der))PpropertyM4data(selfFB"""Rthe parsedA- for this . QThe r?ed object will have keys that name avarious bits ofI. See PEP 566details.,5""" ztext = `.read_('METADATA'ht , rn result  return file_lines and list(starmap(make_!, csv.reader(2P))) MPdef _.s_distinfo(self):$(5""" Read the }of RECORD!-ptext = O_"('2%')4 a.splitf(?egg 'SOURCES.txt might contain literal commas, so wrap eachin quotes.z'"{}"'.format, @propertyrequiresGenerated %ments specified for this DistributionDreqs%_q_R() or8egg>4B a7H.metadata.get_all('R -'[ DZdsource#('<s?7Q._deps_from!)@classmethod$;!cl ecP_pairBcls.Cs"s(t Ep&A = {:Qsator.itemgetter(''), results)ZE[I#9 ini}tools.groupby(2/, x$'q}[$convert__to_simple:Jslstatic} s(su = None+! i9 ,]@4]_match = re. (r'\[(.*)\]$'; m9if <Wey*(1O1"6inuyield locals@.y~Historically, setup/ would solicitP)e 'extra'~, including those with environ# markers,@pin sepaDas. More modern aexpect6< dependency to be definedRany relevant?environment markers attached directly to that requirement. This method converts the former=e< latter. See _test_deps_from_X`s_text@ an example.B5""" def make_condition(name):"preturn  and 'extra == "{@}"'.!at>=%) CeHparsf0secn i4 = Uor ''J|t, sep, s0R.partI':')91if <: _c = '({ %})= bEs = list(filter(None, [5 s:)])Nv'; ' + 'v'.join(i@) if7`s else24forM , +4 ins.items(30dep)1$PyieldM? +  class DistribuFinder(MetaPath~*A  capable of discovering installhbsM0Con Keyword argus presented byciT57``ds()`` or ``.;to narrow[Ascopa search ]:oin allR&s.nOEach# may expect anyuameters_`should@empt}Qhonorcanonical23parE` defin2elow when appropriat~@)0 = Specific{pwhich a V! fW RmatchA=Pof ``i1`` "!esM j6__init__(self, **kwargsiAvars").update('@Ierty_Bpath9Q@The ,Q OD0Typ`ly refto Python packag_snvdefault"Bto ``sys.&``3 Pget(';4', F,@abc.abstract$_.,='()l 64Rtan itern lsEncesof loading the metadata for packages match#``context``, a DistributionFinder.C( instance./""" class FastPath:TMicro-optimized ,Bsear`a path;childrengI def __init__(self, root)pl.! =7base = os.n.AnameK6).lower() 9p@join.%!, qareturn@lib.*O/N?1ren$Gwith suppress(Excep~"mos.listdirGkq or '')+Q6Ezip_It&[] *</ = zipfileZ{s(_3.()c.1dict.fromkeys(".split(posix{sep, 1)[0]-1@ in s'ais_egg", j1 = F " =/.versionlesd_A0or 3p.starts(v.prefixJ.2and/2end-w'.egg')?p "&jrn_low =4ZBif (&`q.exact_em41or 3564suffixes#6# legacy casee"orU%) n'egg-info'?RyieldB(O)UPrepared 93A pn<on a possibly-dTHanormalA= ''X6 %R.dist!, 9 9  = [''][:TR'l 4l! =s!if{ is Nonb,ER.replace('-', '_Q9<B+ '-= # Af "in&esaQess_egg_name4 = self.normalized + '.egg' class MetadataPathFinder(Distribution): @3amethoddef find_d3s(cls, context=N".C#()X\1"""S u S%.  Return an iterable of all j instances cap&Dloading the m for packages match##``u.name``D1(orv s if ``None`` indicated) alogpaths intElistIof directories q35``.)#found = cls._search_0(s(.)JrD@map(9!, [)q p , esc"in0 heuristically.tools.chain.from_(:.(Prepared()( th@Fast  U)-#- +__init__(T}"""Construct a ! a1 to- >ya:param01: A@lib. or similar object supportingP.joinD(), __div__, .Gnt, and .read_/().! =K<%a, file`Awithress(FileNotFError, IsAD/y#Ke M Not4PermissionEz @encoQ='utf-8'm.__doc__ =A!* loB_mE# /t qE( _wa"""Getl(``G/8d( ``: The 2>#E` as a s"ngR:1subCreofDG ta- 5s(**kwarg-pcurrent environment3:: AT discover(**kwargs$) def metadata(distribution_name): """Get the,A for'd package. 0}:param O`: The 21 of>#E to query.Mreturn: An email.Message containingLeparsed>1"""FE' DQ.from.$version* #+ L/ng)`e as defined in>!'s/V"S3 ke W#.Lentry_points(cR EP objectsCall installepsq:="eps = itertools.chain$Uable(.PHAs())7by_group = operator.attrgetter('',ordered = sorted(eps,~=F(4(3by(D*, 3*! {0p: tuplehZ , 1in %ed<}_files`a list25VEBLdcomposA>!.orequir H :3men"S\A`, suitmqGing.)".Rv"Ls import os a3 . 0abcxresources_abc#s_common@ s_adextlibpmanagerbppress0/{_module$.!# RcLoader)ouBytesIO, TextIOWrapp&GpathqBPath?TtypesBM3Typ0typ~ContextM@Iter@, Optal, Uni3 =Ecastrio import BinaryIO, TextIO __all__ = [ 'Package',uResourceas_filcontents/ Kis_r?open_binary3DtextDpath Kread00C] = Union[str, ModuleType] "os.PathLikeFAdef lve(name) ->G:`"""If  is a string, lve to a m|A."""4if hasattrX, '__spec__')V|areturn[6rimport_S@A) Rget_p(sTake a &e3 or object and v3the!. AIf a7&, qed. If dA?bfis not, raise an exception.1<& =)'#iff.SB.sub5_search_locaYsGNonet~TypeError('{!r}' '.formate|+mn*Plize_(2strwD"""N$ th by ensuJ0 itY~vresultingw Pains h separators,RQhd\parent, _P= os.LP.spli"th2if /=IValu>must be only a]9F2th)VCFG|_1er(x:cO?4al[:ds_abc.rReader]2# RoWQP's lo$p if it' =. We can't use# a issubclass() check here becaup<bc.'s __2/2__(# hook wantsLPcreatweak referencgWS, but2zip. ber doez0supO Os[Cin aM. That seems terribleN$ =[C'.`?, ' _cast( k.i(  := (p.originjG\CZ'5hasM FileNotFoundf@D no # {ZD!r}'K^: Package, resourc8e: Resource) -> BinaryIO: """Return a file-like object opened for b6 reading of the rYA."""O = _normalize_path())ppackage(Cget_($m$er#@_ +!ifer is not Noner:._O pabsolut` = os.@.abs([.__spec__.origin or 'non-existent^'4 \dirname(:Lfull7Djoin,5=try (N, mode='rbexcept OSError># Just assumeBloadwaw Q; all%relevant6# importlib.machinery7s are and an AttributeD:data() will make it clear what0eed1rom.H = cast(,L#, /Z! =qSif hasattr @4, '&')`Qwith suppress( $(y.N1if -!is o_{. =xBmessV'{!r}xfound in 0'.ft.@~`$aise FileNotFX(-BytesIO(q) defT_text2: Pz, . "@enco@: st}'utf-8''2s%qstrict'{OTextyw `vWrapperu!_b#$, = 1, e=M? HOAbrl<@ consS b as fpe:0fp.(P `#stX @deco8i AThe )ing-related arguments have the same semantics as those of bytes.decode().1"""$with open_text(package, resource, encoding, errors)`1fp:?_ return fp.read() def filesQ2: PZE) ->]s_abc.TraversableUgGet a 9 from a 6_common.*_(U(_get )Qpath(K4: R.@'ConFManager[Path]'2A c " m!` provi\! a/ object to the!. m)If does not al~y exist on its own H system,Ja temporary}will be created. l:4was,H7deleted uponAting* (no exceptisFraised i] sUTprior Q@0exiq Qer = _r__M>)=2if U else0as_(!`).joine(_normalizeu(&))c@Nu2 d_Z!u&suppress(FileNotFoundE)T`yield (.e(gxqm#er# =L.: H8e_b(8O, suffix=r3:try%=H0except Attribut Br E('{}I$set'.formatq)) fromm !ifoF y!}7 zpAf~ def =J)B"""R8CX TifiedShFirst,Rcheck0seeDCB!Ifz$su(contains a dot)L:!is>automatical1TheD and arguments works3arortlib.i_l1().lIn other9ds, relativ 1s (pleading s)1k@full1 = resolve_)p.starts[`('.') 5if Pi% =3.rpartition]1[0]V#ifx5uNS = __0"_(-,Ylist=['_B__']c@ parent_path = pa!._G__  except AttributeError as e:(3raise ModuleNotFound0(+/$f"r$ a_` not f9R on {_name!r} "H while trying to find {full:0", =) from eP;els{#6Non-return _gd_spec(X,LJ)^ Zmr = sys. $s[>]12if @ is | m3:try%# =H!._ BBValuE('{}Iset'.format(d)\ !}a z Af @contextmanager def _d_to_loadPis_re! =:8 in j? 3.ge#!ifO^# This must be done before open()a`calledothe 'io']Gimplicitly imports 'locale' and would otherwtrigger anEnfinite loop.type(sys)%!Aputt#he E6# ( an optimization shortcut=.c becomes wronghI0.__ializing__ = Tru|]' JSyield8E6ion V8delW[go1KeyJnApass2gfinallqFalse  seckage(fxn)bp"""Set  __|e. Afuncis deprecated""""@&ools.wrapsu_per(*args, **kw warnings. S('TheUtem now takes caY0f tuautomati_Ay.',Q DBionWj, stacklevel=2ym = fxn^`if get(7, 'b!',2954hasrule, '__path{__'): module.__package__ = .rpartition('.')[0]Kcreturn55setWwrapper def loader(fxn"""Set ____ on the ra#edc!. eThis func is deprecated"1"""*@&Pools.st _per(self, *args, **kw @warnings. ('The import system now takes care of tautomatically.',Q DBionWj, stacklevel=2)8o = fxn,if getattr(76, 'l', None)I *1./0 = %]^SC_forw"""Decorator to handleraectingcpropersR for 8sdF)ed)apassedEduse insteade[`name. S2D in<d0ionAeither from.4As ifMit already exists or7Sa newv0. I5@new,@n __"__NsO first argumentxmethod,Yi4oTaf, andL$accordingly (iTlf.is(2defined) will btQbefore it4!to`AdoesMnot worktm^x` post- ) If an excep,0rai"an`or creB_isubsequently removZ u,Wassumes that\@1" a{esecondiDg M@fullx Sith _J!to9(9C) as=FU0):try6x/f1 (IError, AttributeI2 G?lse&f Jge__ = fulln[ame ]else:%!module.__package__ = fullname.rpartition('.')[0]EX# If ;"was not set above, __import__() will do it later.Oreturn fxn(self, , *args, **kw !) 7/%_for_loader_wrapper class _LazyMr(types. bType):M"""A sub2cof the 4 which triggers king upon attribute access."""W de!5get##__)B"""T]{` Cand @unT# All*metadata must be garnered from __spec__ in order to avoid`O usmutated valuesd# Stop*this method'1.__]bSq1Getoriginal make sure no objectPstitu occurrerin sys.$]_]#= .0Figvout exactly whatts were %qbetween@creaO6now,|s_then @er_s['__dict__'`?@|6now<d"1updE= {}for key,%U-gitems(]`Code tL2  may have kept a reference *th# assignedP, makidentity more  ancan equality~ ifi&ur[key] ='elif id(/1now+F) !=g" )b.exec_u) ) used dire thi guaranteNDput intoy5if g' 6,+[H]\wpraise VError(f" $ {GU!r} "EB"suby+ed@ duryoa lazyN"USe afterl!siRhat'swould happen in an ecager # loading situation. self.__dict__.update(attrs_ %d),return get!(; , !) $def __del(__!:!"""Trigger the@ and n perform Q dele5""">o# To t@raise an excep91 ifIWibuteFdoesn't exist5!__ class LazyLoader(abc. "):A"""Aat creates a module which defers*Quntilg access.@staticmethodpcheck_e _2er()if not has% , 'exec_m'/hTypeError('UP mustGine ?3()'@# factory(cls,'erp"""Construct a callab(sA made lazy%ocls.__;)X lambda *args, **kw S: cls)()Einit%=*@# =QhDGspeckH.60S5,Sq"""Make{'u*ilw0.__5__.[{-&___ = (@# Doneed to worry aboupep-copy=Qas tr `to set!Kw@# onobject would havekf,6ue.g. `` cNone``Pa+GfromKt8,oe = {}$['F'] =N (T:*__;o_T4M@ = _5Ml  he asyncio package, trackPEP 3156 # flake8: noqa import sys # This reliesbeach o2subsYan __all__ varig .  .base_events b*coroutine0 0^futurGMlock,protocolm .runners import * from .queues instreamubprocesNtask^hread@rans # Exposed for _asynciomodule.c tolement now deprecated # Task.all_"() method. This function will be removed in 3.9. =g _O_compat # NoQA __ = (base_events.6+ coroutine < Pexcep<_futurYOlock8protocolorunner/5; }GM ) if sys.platform == 'win32':pragma: no coverswindows *"*= 'za else:,NLunixK_8\East $Fcode ncurrent.&einspecD4systg5ing5ypewarnings -_ class AIOInteractiveConsole(.1): 2 def __init__(self, locals2op)XZsuper()..()G!@elf.i< ompiler.flags |= ast.PyCF_ALLOW_TOP_LEVEL_AWAITGploop = 0run \ = co!.F"()KeOcallback(Fglobal repl_V _iw0rup ,D = NoneD = FalsexO@ = t#.F\2Typ , .96try"! =( SystemExit=Jrais5Keyboardpo as exB] :Tru[R.set_jjion(ex)ireturne1d BaseEh isif not .iscoroutine(cor[o): future.set_result(coro)(yreturn >tryQRrepl_V = self.loop.create_taskc5s._chainD(P", # except BaseE ion as excA8ion(exc) all_soon_threadsafe(callback- (.Su SystemExitUraised- 07if _interrupted(write("\nKeyboardI36\n"0OelseFshowtrace() class REPLT0(7Bing."):bdef run( Hbanner = (f'asynciop {sys.version} onplatform}\n'BUse "await" directly instead of "c.?)".FType "help", "copyright redits" or "license" for more in_ationp{getattr(sys, "ps1k>>> ")}import jBconsole.0>actd=,Aexitmsg=' 4ingvF...'Kkfinall)warnings.filter'ignore'message=r'^utine .* was never ?ed$=category=RuntimeW ' @stopif __name__ == '__m"_'>,$ =".new_event_()"locals = {$':Y}M ke4 {' ',package__'__loader-@spec U3'__builtins ,0filV})[key] = !() @ = A!IOractiveC<,, b = Non6y  = Falsex l6lBq # NoQAIYVErrorBpassOt! =.daemon = Tru=`.startNCQwhile(t %@_forsKeyboardInterwrupt: if repl_future and notz.done()7B8.cancel()\ %`_intered = True/gcontinJelsew!break """Base implementation of event loop. The< can be broken up into a multiplexer (the part responsible for notifying usj2I/O]!s)59~ proper, which wrapskwith funcQalityhpschedulicallbacks, immediately or at a given time in . Whenever a public API takeX, subsequ4BposiP arguV`s will4passed tog@ if/when it is ed. This avoids0prolifertrivial lambdaslosures. Keyword kA aresupported; thisa conscious design decision, leavmMdoor openku to modify@mean:!ofX itself.@ ima collesF.abcncurrent.1"5oolTheapq8Xiterto(dsocket)6sta ubproces,threading/V @racen%sy90wareakref try ssl except I Error: # pragma: no coverssl = None from .&@ort ]tants|routine 's8oSTDOUT:estdout<%fdset_reuseport(soc(if not has_et, 'SO_REUSEPORT'aise ValueError('W_XJ0sup bed by O module'_6trya3@.set"opet.SOL_SOCKET,V.2, 1^Cexcept OS _r'", c 5` defin!utimplemented.'ipaddr_info(host, > , family, type, proto, flow*=0, scopeid=0# Try to skip /0ddr-P if "[" is already an IP. Users migh!ve#d name resolution inLir own code and pass)ved IPs.J^inet_pton[ 9:0n {ocket.IPPROTO_TCP UDP} or \E,roAtnkqv_STREAM8={1TCPuAelif H?DGRG$UDG(6= 0E, bytes)0ort7b''C :strA@A# If's a serviceflike "http", don'tT 6p = int( B(Typ,;R$et.AF_UNSPEC1vafs = [!QINET]Wif _HAS_IPv65afs.append^=6 g]je`ost.dec('idna`if '%')7# Linux'P does!acban IPv6 zone index after host, # like '::1%lo0'.return None for af in afs:E6try socket.inet_pton(af,v)4'Q# The has already been resolved2if _HAS_IPv6 and3== pAF_INET68type, proto, '', ( port, flowinfo, scopeidOelse^&Kexcept OSErrorQBpassn0# "" is not an IP address def _interleave_+%s( q, firstess_family_count=1)E"""IF list ofyN tuples by >A."""q# Group*8ess$ 3_byz = collections.OrderedDict(/s1ddru0ddr{! =t1[0]h#if;=}.[_V] = [[)q.appendp-H1s =P!.values())2reo~F > 1>D.extr_[0][: R - 1]1delbA V!a itertools.chain.from_Uable(26+zip_longest(*id) if aE+<" A run_until_complete_cb(fut!ifSfut.cancelled(`exc = 3ionif isinst; (exc, (SystemExit, KeyboardWrupt)[A# Issue #22429: forever()Dfinished, no need toF# stop itIZ*futures._get_loop.7p() ifRattr(, 'TCP_NODELAY'set_nodelay-r1if .l {P.,}A5. SOCK_STREAM4 5IPPROTO_TCPgc0set1opt7et.1 V, 1) :  class _SendfileFallbackPAcol(c2`_init__(self, trancsp):  if not isinstance(transp, orts._FlowControlMixinAHraise TypeError("< should be E s%")fself._?= !dproto Q.get_Lcol(M_resume_reading<$is: Iwrit:su_paused.]s0if *._|)sy_fut =Alort._loop.create#7ureOelseXQNone async def drain(is_closing()BConnectionH 9ed by peer3 _0if '0is ereturn+Pawait.cQ_made dRuntim Invalid state: "j "k: have been established alOy.")Clost7exc *1 is# Never happens ifC diss after sen[the whole contentg# Thus?0ion~always an excep from user persp)veN if/@\+._.{f(Q5z-is=N1.lAion_)*k\8* P Ec ult(FalseiQdata_receivedO\8 d:eofic;async def restore(self):  ._transport.set_protocol,.)22if 5should_resume_readingZa)^ ,(UBwritMy_fut is not None[# Cancel the future.|# Basically it haJ effect because hswitched back,Lno code wait forZ\anymo~ !.cXM8M.I(() class Server(events.Abstract1): def __init__, loop, sockets,_factory, ssl_context,!:log$t'handshake_timeouton! =u;1$ = active_count = 0ers = []84col- = 2Tlog = !( 2  <Pervin_False_forever1=,Creprreturn f'<{{_A__.__name__}="W!r}>'`aattachH_dassert*Xe G+= 1a/dea ?> -^r #== 0 and=`wakeupVa #._  Tq1 in:ers!if0&g.done(~EJ2lt()wrstart_s 8 \ *f = TruZ+etq.listen#._DB`*._'+ ,A) ]@get_9}!/is 5f8@property def sockets(self): 0if #._ is None")return ()8tuple(tr>.TransportSl(s) for s ine!) Hdef closeNZets =75cs / =M1ockV ?loop._stop_serving(I( = Falseh1if .@_forever_fut1notE andY a>w.done()3/gcancel/  2elf._active_count == 09swakeup()`async Tstart  #}# Skip one  iteration so that all '.add_reader'U0# g(erough.await tasks.sleep(0,`=ODerve )(  7raise RuntimeError( f'S@er {0!r}A aly being 0ed  &)'JG#d'%6~O tp.create54ureI^:try;5WGrexcept aions.C1ledq V g| HU_(d)kfinall>'~= :wm<k =/erl,"._2s.append($K class BaseEventLoop(e s.Abstract"):n__init__j"r_4led% 0(pz= collec`s.dequ&*scheduled = []default_executor?Cinternal_fds = 0# # Identifier of the thread runningevent loop, or None i.J%t is notC$bself._`Q_id =J  clock_resolution = time.get_info('monotonic').. MPexcepF_handlert set_debug(coroutines._is_mode())[Q# In 0 , R execof a callback2`a stepbga taskLed this dura in seconds,EslowQ/Bdulogged.M`+_|_RZ= 0.1*_current__l_factory"4_origin_tracking_enable\False~l 8saved_depths<# A weak setPll asynchronous generators that ary@# be it#Qed by_ G_Uagens =qref.WeakSet( Set to True when `NshutdownH` $_7): = ;/# p default_/orw#vvdef __repr__(c!):Creturn (@f'<{(.__class__.__name__}="3is_h[()} 'Gfclosed+*~F()}>C!) Ncreate_futureA"""C A a F" object attacho&1"""XX"s.>(=M , 6P, *, =RW@"""Sz0uleI).RUp._checkG7sed2if !isT"asks.Task4,':1ask._source'e! a+1del',E[-1]Jelse=v 20s._ ( [8#h 3et  will be usA.n'()4If =6!Yset. If -factory is a callable, it should have a signature matching '(loop, coro)', where '' will bBreference to the activeG`event 60, 'L=utine object. TheEmust return a Fu.5""" 7if not None and  (%%)::raise TypeError('taskQG1 or`%')G`self._8_d$ =B &ydef get$(7D"""RLB,r1 ifndefault is in use.7a _make_sockransport , , protocol, waiter=WA, *,<Sextra.Cserv; aCreatekDet t NotImplemented 5sl_C(\, rawsslcontext >2*, _side=Falsehostname 8 ;ssl_handshtimeoutM{_connection_made=TrueR?SSLO-datagramTG D  raddress H#-read_pipe x c-_writeB z(`async nubprocesslargs, shell.`stdin, stdouterr, bufsizeI`, **kws(b@_to__} lWa a bytm'-U,{wake up the event loop. This may be called from a differ3ithread5*e subclass is responsible for implementing the self-pipe.y5""" raise NotI9redErrordef _process_events(R!, u_list):NB"""P-xRector)/s.ucheck_closedsg if_#f.ZqRuntime0('E4U'')ndefault_executorx!_shutdown_[ : has been asyncgen_finalizer_hookg, agen$._3s.discard('bif not@#isB(GDKb_soon_Asafez.create_task!.aT(()T_firstit 6s\ warnings. (!f"Hhronous genera{!r} was scheduyfafter D!f"^!()-",{ResourceW", =TZ$adRE def)|<C"""S all active C  J tr = True)>2len )# If Python version{<3.6 or we don't ha)nyF#gs aliv freturn@ing_@s =  b w.clear(`resultI`await s.gatherxE*[ag iag in ]1_exceptions=p $ >hBzip(*s,u if isinstance34, E .d&_handler({L*'message': f'an eT occurred dur_ of 'GO G  '7;' ':/?ult)1Qgen':[ }( :): " ""Schedule the shutdown ofdefault executor.""" dself.__<_called = True.2if 1T9 is None:+`ereturnfuture =Drcreate_%()&Pthreaz Qing.T(target=o, args=(K,,)Lh.startc*rybawait @kfinall*.join() ,fdef _d(,N)itv(,._K.(=V7b_soon_Csafe.set_result,?except Eion as ex_Ixion, excheck_running ?%is"}raise RuntimeError('This event loopk al$#y h'"if+@s._g_9 ();1not x@'Can>1runXwhile anotherL(run_foreverp"""Run bl stop/edjgclosed_ !coroutine_origin_track6bugXWl*_ii@idenc2old_agen_hooks0ys.*Uasync!ys !firstiterc,z~/izH0nalH 0s._?[Y8| h..W_once'_NpingD'Ubreak kGv = FalsF#W#* N!` 7*EhH*_completeOv WFis done.I/PargummUis a @, it@wrapped in a TaskBWARNING: It would be disastrous to _Awith`Fsame twice --would wrap it in two different Tasks and that can't be good. 1$Return the Future's result, or raise its exception.<5""" self._check_closed()running()new_task = not fBs.is (O0 = 5s.ensure_-p, loop=84if k:9F# An2 isAd if[@ didEcomplete, so+reMis no need to log& "destroy pending" messagCpc._log_6_6v= False>-add_done_callback(_run_until_6_cb:try..5wforever /Oh!().cancell FThe coroutine~ua BaseEy ConsumeO9ion}N!toIzPa warq,6per doeshave access*thNQlocal3?kfinalluBoremove1.y ^ RmeError('Ev   stopped be .7d.'r*$1defL(C)"""Stop e`Every  already scheduled will st run. This simply informsivuafter ao itera Cp?S= Tru~Caclears%Rqueueshuts dowexecutor,1butwait forF,gfinishcc|Q mustB$be0if 0.isQK( e@"Can$ ab "b9?]w,Zdebug+qlogger."("A%r",ol j}. _,edj(! =._default_not None:  self._default_executor = None %.shutdown(wait=False) +def is_closed([!):A"""Returns True if the event loop was <E."""9r6 O.\oq__del__m, _warn=Pings. bif notI!CR(f"un{!r}", ResourceWarning, =")Q v0run1(w*<.v(Q4!8R3is <R5._thread_id is!Atime+{" according to'2ck.@Thisp!a float expressed in seconds since an epoch, butZ_precision,uracy and drift are unspecified5mayEdiffer per..monotoniccall_later1, delay, back, *args, context=k $Arrange for a9T!bet a given Wb a Handle:=opaque object withYncel() method thatcan be uPto ca,z e$3an int or,. It ispalways relative@curr AEachRP willzced exactly onceh@f tw ll.sre scheduledm:zAsame[, it undefined which {WfirstAny positional arguments afterO!pa%toe'0hen!is/ed10.=1_at.B() +w bimer._`_traceN1delW)E[-1]~r[n, whenZ2LikB)Q@uses'rabsolut correspVc_check(J Zdebug>99_!-( , 'call_at')  timer = events.THandle(when, callback, args, self, context) FQ if K._source_trace9:$,?del)E[-1],`heapq.Ppush(v._scheduled,D|!u = TrueObreturn6 1defQ_soon`*f=None)"""Arrange for aIa to be`ed as ]possible.} This operates$a FIFO queue:DSEs arRVin thorder in whichy.registered. EachNv will bCed exactly oncAny positional um(` afterq Z passed tog"th Va it is;5ed.(5""" check_closed(!ifv._debugm9Xthrea9 !( 0, ' 'qh# =w#8 1:2if =* ,O_, gmethodif (coroutines.is E) or<' 4@func&<k7raise TypeError(X&f"Zp cannotLuMbwith {I}()"`)Fable ~'E object was expected by>, '`'got {SX!r}')1allW  :aAy6ZRy.append(b tH@"""CR thatSPurren m*B> running)W loopXBNon-,b-safe 6`s of tsclass make`assumpA and!likely behave incorre)?is violatDShould onI " =S). T1sIaresponGw M1ondperformance reasons. """   if self._thread_id is None: "ereturn."= ing.get_ident()*#if![,!=n faise RuntimeError(Ir "Non-t!-safe operation invoked on an event loop other "Lthan the curr/aone") )def call_soon q(1,back, *args, context==)q"""Like0Ks(), but6.""_._check_closedO Vdebugf90all( 0, ' 'thandle .C :2if =._source_tracew ?del*A[-1]xwrite_to_Jrun_in_executorc, func\o7d'f4if judefault%)q# Only B whe3 jbeing usedA7jsl%3conW.futures.TfTPoolE B_name_prefix='asyncio'1; % =DKRwrap_ z.submit(!),e=u;Lset_ if not isinstance(rYHLwarnings. 0'Us@ thaaUN of |'deprecated and will be prohibiKin Python 3.9',DUBionW6, 2.sR_getaddrinfo_J host, port, family, type,to, flags)msg = [f"{;0}:{<F!r}"#ifK6msg.append(f'l"={:!r}2> ={ :Tproto; msg.append(f'proto={s!r}') if flags:cmsg.ap= !={ =msg = ', '.join(msgZlogger.debug('Get address info %s', 1zt0 = self.time(K95= socket.get (host, port, family, type, ,N*dtge - t0 fJting{msg} took {dt * 1e3:.3f}ms: {&Psif dt >slow_callback_duration~: SOelse+eNareturnIasync def As(, G%*,L d"=0fh $6=0)"if_ST_func_4,A lBwaitrun_in_executor(h/TNone,%` ! hI j@name(j+ 0"Qj,)e) 4_sendfile , , offsetacount= *_=TrueA andout() != 0!raise ValueError("the: et must be non-blocking"ku._check_params( !, ?;tryPA_G\hnative\. Bx rexcept cions.SNotAvailabl&0 as( if not fz xl I,  tb2elfd# NB: @ sysz1 is 0sup5ed for SSLZs#aAmmapqs even <OKUby OS=U ep $f"a@et {!r} " "and file {!r} combination") async def _sock_send/_fallback(self, ,O, offset, count):HL#ifOb.seek(9)1blocksize = (4Amin(_fnstants.SENDFILE_FALLBACK_READBUFFER_SIZEZD"if else coGPbuf = bytearray(#Ptotal@Ut = 0D:try whJTrueu5 = !6 - z%, $;&if"_ <= 0j/Ubreak@viewPemory u(buf)[:x]3read = await N.run_in_executor(None].-`into, ]pif not '} # EOFPdall( r [:[]ye1 += ^greturnkfinall'if+ > 0 and hasattr(20, '4'`Q' +M8cheoparams1'b'qhin getmode', 'braise ValueError(" should be opened in 0ry K"s.type ==et.SOCK_STREAMuWonly 0 KUets are supported|x1 is j1isiQ$cei 3Typ "t@must!a positive integer (got {!r})".formatw)7MG', $"< !non-nega% N;, <3 EqconnectPexceps, addr_info, local_addr_infos=None): """Create, bind and connect one socket."""3my_exceptions = [].append(-))family, type_, proto, _, addresW 50 = 6try%2et.(o=v={=I.setblocking(False$if local_s is not U0for_@_, l9= inG;? .(V %UbreakB OSError as exc3msg = (K 1f'eLwhile attempting torOon 'B %{O!r}:3{exc.str}.lower()}i.Texc =(Werrno, msg6  >exc2else: # all%s failedjraise fJpop(`await self _(+l 3areturny  !ifY$ k.close `1aasync def c::ion\col_factory, hostlS, por [c*, ssl$9=0,#=0, flags 3 ) server_Bname 3ssl_handshake_timeouhappy_eyeballs_delayO interleav` VEto a TCP%. x0 a !am@rans00ion)a given Ir1net_M5:]2et N AF_INET or.@6 des"onM5(orM@Npecified),D SOCK_STREAM. must bePa callable r_ya8 instanceThis method. a coroutine which will tryestablish the;n in the background. When successful,"coroutine returns a  (transport, protocol) pair.$5""" if server_hostname is not None and Essl:4kraise ValueError('G only meaningful with ssl') M} y`# Use as default forP. It@an esB# ifFis empty oret, e.g. w}+an8already-connected socket was passedK= a  Fis given. To avoid th, you canQ ; ib='' --=pwill by*' Bcheck. (TrAalsohs thata numericAIP/IPv6 address, we |0attM to verifyS[exactD<;probably fail, but ipossible toFcreate a certific`a spec6 IP[so weDdon't judgepihere.)$!ifO K You must se _'ZA '=Pusing/8Qout a' ! =% asl_handshake_timeN# /'s^happy_eyeballs_delay interleav R# If 2P P,$7to F@es bpImily+9= 1O !or ?ock! H "'~/R|).$beQed atsuIinfos = awailf._ensure_resolved((~,P), fa7=,-Ptype=et.SOCK_STREAM=, flags=, loop=self Z9#OS0get-#()##edMlist f local_7 l#_[;g=family,  type=socket.SOCK_STREAM, proto=+, 5aflags=, loop=self),if not laddr_infos:$Qraise OSError('get21() returned empty list'kNelseYv = None }if interleav?~Vs = _%_!s(,A)]exceptionC,[]yhappy_eyeballs_delay is#Fausing : : XJDfor A in R+?try = await ._connect_(y5,, 7_break]U%continueE"O # Ef, _, _taggered.s __race (functools.partial(D[ LO )wW   O0if $ = [exc 0subjin sub'vif len(2o) == 1F,.[0Q  g# If they all have same str(), aOone.Bqmodel =.  ifj(\1excBG)+(1# Rhqa combiS1 souser can see#+various e messagesMultiple : {}'.formatU', '.join7.)RValue'host and port wasspecified"no, .1 !=- 1# Wow AF_INET, 6 UNIX as long as they  # are SOCK_STREAM. "* # We support passing AF_UNIX sockets even though we haveI!a dedicated API for that: create_unix_connectionDisallowi| is method, breaks backwardscompatibilityhraise ValueError(C'f'A Stream S  was expected, got {#e!r}') DPtransP , protocol = await self._ _4 ^F_factory, ssl, server_hostname,ssl_handshake_timeout=)9#ifedebug:Q# Get theQ from because SSL Zclose#94oldM3and&qs a newD)et& =^.get_extra_info('!6et'qlogger.S("%r {ed to %s:%r: (%r, %r)"J@^ , s", |freturn$/async def Aelf,8N  1 &7side=Fals9bNone): .setblocking(J ( Ber =wgfuture&*slsslcontext = if isinstance("bool) else2 } _m)! v", <p =]~! ; :tryZ(njexcept).lEsendfile(g,w, offset=0, count=8 *, fallg@=Tru """Send a XCRhe total number of bytes whicQre sent.;3The uses high-performC os.e if availabcle. file must be a regular  object opened in binary modCoffset tells from where to start reading theY. If specified,count is)total number of bytesTtransmit as opposed toE9senm until EOFZreached. Fpositionupdated onKreturn or also@casePerrorawhich 3.%()B0canXu figure out 6UwDHsentallback qo True makes asyncio"manuallyyP and _n platform does not suppor= syscallI(e.g. Windows'SSL socket on Unix)Raise SendNNotAvailableEOfmsystemv fis False.05""" 1if ?.is_closing():#rR:m0("Tw8-8" = getattr(fD, '__compatible'qconstants._+MpUNSUPPORTEDv!if8 $f"cfed forM% {7!r}TRY_NATIVE:tryawait self._hnative|ijO!, p/rexcept Tions. as(0if M!i4 , p0dis{d?:'3 9#f" , {] def !7,,*, CY(w%96T@"")#if.seek(offset)# blocksize = min(count, 16384) if R else:uf = bytearray(J)#total_sent = 0 proto = _SendfileFallbackPcol(transpI5ry:?while True6 - %, $;&if"_ <= 0j/greturn] "@viewPemory u(buf)[:]3read = await self.run_in_executor(None, [.-`into, ]pif not ' } # EOF~.drain(np.write( [:z]*<!+=qkfinall'iff > 0 and hasattr( , 'seek').(offset +M restore() async def start_tls(", Qort, col, sslcontext, *,B server_side=False+hostname=Ysl_handshake_timeout4""""Upgrade to TLS.RXa new(That ** shoulde usingimmediately.5""" if1@ is raise RunError('Python4`module;available'isinstance(ssl.SSLC;}BTypez&f'LexpectedGdbe an u! ol?, 'PVgot {U?!r}1get|%'__compati!, X[% { 0!r}j`suppor"by)Ber =create_futuW?Dssl_G,!sl)4 (w% ls Fe#, G *6 L 9call_connection_ma# Pause early so tC"_ .data_received()" doesn't# have a chhget called before "ssl_protocol.connection_made()".  transport.pause_reading() #5setV(c)-0cond_cb = self.call_soon2 %, MoresumeL..% %y:`await %erexcept BaseE :ion7kfclose(U{.cancel /cbFaiselxreturn \e._app_,async def create_datagram_endpoint(}$, _factory,local_addr=None, remote*Mfamily=0 flags=0C reess=_unsetallow_broadcast=Q sock )A"""Cc c PE."""s!ifA is not 6Gj!.type !=.et.SOCK_DGRAM/3r ValueError(nf'A UDP Sockes expected, got {J!r}'Fif (8 or& o%i-\ 0+ yi\# show theblematic kwargs in }ion msgopts = dict=5 =!, =E   4P N= ]0proR"', '.join(f'{k}={v}' for k, vhJ.items() if vOet modifier keyword arguments can6be used 'af'when9g@specQTd. ({+})}.setblockZFalser! ={Jelse!ifZE2if 6Z == 0P I4'un 0F >addr_pairs_info = (((family, proto), (None, g)),) elif hasattr(socket, 'AF_UNIX') and PB == !.:JUfor addr in (local_, remote )7;#if:Qs not} isinstance(O?strGKraise TypeError('string is expected') 6if |1[0]0, '\x00'?tryif stat.S_ISSOCK(os..).st_mode`G0os.W(ve< *except FileNotFoundOpassK !OSA as errH # Directory may have permissions only to createa{logger.eaUnable?qheck ori ved0le / 'MQ' %r: %r',6", V_pairs_infol P<), .sea# joinezess by ):colGs = {} # UsLorder preservMdictAidx,v7(0,f1)-}assert 7Rtuple1lenL)M2, (I1'2-<C 02 await self._ensure_resolvedq x,y=r, type=.<o_DGRAM =, flags=0op=f?fosn.sP('get() returned empty listH5afam, _N0in U 0keyhE?proo0if 0hc :,[key] = [dj]Q ;@[idx@>essb# eachG0hasKinfo for each (family, proto) pair Paddr_s_info = [$3e(key, .j) for 2 in!Is.items()Nif not ((local_WB and?[0] is None) o(remoteF1F=)] :(jraise ValueError('can1get@ess rmation')qPexcepse # bpo-37228~rif reusastn_unset 0""Passing `n`=True`Ino "G"longer supported, as the usage ofJSO_REUSEPORT]UDP poses a significantPsecurity concern."Oelse5warnings. y("The *.* parameter has been"deprecated,of 3.5.10is scheduledN0val63.11.", DeBionW,stacklevel=2h*((eSPess, Pess))asock = r?tryS2et.(]=r, type=4.SOCK_DGRAMk=qLsQ_set_^((j)if allow_broadcas(F@.set?opt-pet.SOL_@ET, 8_BROADCAST, 1,lblocking(FalseBh6if TJbindSiUEawait self8_connect F  091 OSx"?excif sock is not None: sock.close()%exceptions.append(exc+'h0if g is not-]raise?elsYbreak0,X E[0] 7protocol = _factory8 waiter = self.create_futur^transport)_make_datagram_ (C,~, r_addr, unj_debugif local; clogger.info("D endpoint;=%r remoteJ"N" d: (%r, %r)",1 ,j%,  s  / ":trya& )oreturnP$ async def _ensure_resolved( , oess, *  family=0, type=et.SOCK_STREAMBvAPflags Vloop)chost, WE[:2]1` = _ip_(5,\0, *,vess[2:]g0if ?0# "[""already a @E IP.[U(@.get9=x={hs", w) ._server_* gKBs = 8.x)J Q ! Q= , = &C OSError(f'2{-R!r}) ed empty list'^screate_serveGr( self, protocol_factory, host=None, por :)*,family=socket.AF_UNSPEC%Elags$I_PASSIVE%C{ abacklog=1000/sl/reuse_address ssl_handshake_timeoustart_serving=True):"""Create a TCP 'Eer. !1Theh parameter can b1 string, in that case theJ5 isKbound toP1andlCalsoqequence of } s Ho  1allsI(sYa. If aHappears multiple ks (possibly indirectly e.g. whenCFnamepresolvessame IP !),: is onlyo!toe< Return a Server object which1useEstopn7iceGThis methoda coroutine.z5""" if isinstance(ssl, boolbraise TypeError('ssl argument mustn SSLContext or &')?if 1not0_!isCValu_Wbmeaningful with /!or ?ock!C &'~/1Wbe specified atI9if  * 'P= os. == 'posix'ys.platform != 'cygwin'Vets = []!ifQU'6 :gelif (,,>I) ore + / collections.abc.Iterable)Ca /se0KfH1._c`er_get9Pinfo(8#,  Qf)2forisawait tasks.gather(*fs, loop= \infos = set(itertools.chain.from_iterable(infos)) completed = FalseItry::for res in S"&af, socktype, proto, canonname, sa =G _=xV! =]0et.?et(o)[dexcept>_errork # Assume it's a bad family//col combination.wNif self._debugv,logger.warning('create_server() failed to / 'wO '6=B%r, ?)',Hv`, exc__=Truezcontinuqs.append(Jif reuse_addressVD@.setOopt( %et.SOL_SOCKET_REUSEADDR, OportQ_set_(P# Dis IPv4/IPv6 dual stack supA@ (en%Od by# default on Linux) which makecsingle!D`listenCSboth |?iesif (_HAS_?and]Eaf =AF_INET6 6 qhasattrHet, 'IPPROTO_IPV6'))8et.@=V6_V6ONLY<S0.bi-a+0OSEo as ercraise .(err.errno, '56le attempting@'to ?:o%r: %s`% (sa,A.str@.low0)) N NonZg ofinall`if not*D/et fclose(Jelse\1aock is %ValueError('Neither host/port nor sock were specified') !if%.type != et.SOCK_STREAM:0;'raise ValueError(f'A Stream Socket was expected, got {;!r}pets = [ %] nf#ins0.setblocking(False)Bserver = S d(self,L, protocol_factory,{ssl, backlog, ssl_handshake_timeoutVRPtart_;ing8._s#(>w # Skip one loop iteratio that all '.add_reader'# go through.await tasks.sleep(0,h= ?elf._debulogger.info("%r is !", &ercreturn async def connect_accepted_9et( *Z=None()"""Handle an Bion.@Thissused bys9s outside ofbio but7Duse 0to e(leF `method a coroutine. When comple thG s a (trans7ff) pair<5""":?ock62- y@not P and 6ssl X''^only meaningful with '2F2 = q._create_Eion_4 6ockrD, ''e_TO=Tru@# Geetet from XP becaFSSL iclosesj#94oldM@new D  :& =^.get_extra_'!+eteZd: (%r, %r)r}!1~$ S_pipe} t !- =&er = self.create_future() transport = self._make_read_pipe_!(, protocol, waiter) L%y: `a#(jexcept)eX.closGVraiseg#ifZdebugIqlogger.p('Read %r connected: (%r, %r)',h 7.fileno(), Eoreturn$async defa_writea(vU_factory,)x% =,q$er_creatW\?l_log_subprocessmsg, stdin1out7errinfo = [msg]8 is not None%7.append(f'e={_formatrA6)}'V8outW@ andverr == .STDOUTw out=stderr9out async def O`_exec(i.lpgram, *,F=\Q.PIPE3=outM=err6 universal_newlines=+/=06 =a",  n  /if`n S %F Popen_5q = (proG@) + 0cYhey may cont ain sensitive information # (password) and may be too long-debug_log = f'execute program { I!r}'7Pself.7_subprocess(Lq, stdin1outEerr)Ctransport = await QGmakeR_((; protocol, popen_args, Falsel{,@bufsize, **kw=#if? is not None:Qplogger.('%s: %r', 9%, jfreturn,v \def get_excep_handler(,)B"""RL5an . .A, or if the default oneqin use.s\5""" p.s, 4Set1 asnew event loop.o%If=!is,C U willobe setPa callable object, hould have aKsignature matching '(, context)', where 'Fa referenc!ac3, 'O@Cdictp (see `5()`document> for details abouti- @(raise TypeError(f'Ass expected, G sf'got {tl$ =I]sE?E DT zf@Thisq ed)n coccursFDAset,)0canETby a custom@that wants to er behavior6B loge messageUotherp-depend,R. In. mode, a truncatedCPstack/cqalso apO`d show~kSgivenDs(e.g. af!fuor task) was crez,29anye parameter hsame meanFas ibJ= context.get('message') sif not : = 'Unhandled exception in event loop' ;"= context.get(' 1 isJNoneexc_info = (type(4&), .__traceback__?els[VFalseif ('sourceM'$inE and5self._current_:5,._)`"['e_] = \elog_lines = []Vpfor key ssorted( $if'{', }DJEinuemevalue WF[key!j>== d tbu'.join(0.format_list(r)Ae> Object created at (most reccall last):\n'G+= tb.rstrip(l'el CHH  c= reprv ..append(f'{key}: {9}')ger.error('\nD6S=\?@def _c r(,@"""CCthe s &r.T5&` argum6pis a diXontaining _`followVkeys:G%- Z0: E;G-s1 (oeal): Eo 4yfuture'1F instance0Jtask.OTask, .\protocol2Pdtransport5T6[socke3S0asyncgeneA hronous generator that cause=  :0NewWs maybe introduced5e. 0Note: do not overload this method in an event loop subclass. For custom exception handling, use the/U`set_)_)Ser()`sY5"""6if self.: is None:,:tryBodefaulcontext)I (SystemExit, KeyboardInterrupt)lFrais~JTBaseE(8# Second protecM layer for unexpected errorsf#Cthe implementaL, as wellR/edKes with$Ced "a"qlogger.%('G <Mer',Kexc_info=True?els ($/, `?exc 0user setx.erL# Let's try4F1".A{'message': 'Und  = '- '::+'$':,}Bd<R *# Guard 'i'4case it i F/ed!/ 'ue'whileE G/in  $def _add_callback"""Add a He to _scheduled (Timer) or _ready.Passerinstance(e,R#s.?D, 'Afis required herem"ifP@e._cMJlled/areturn$is(handle, events.TimerHandle) self._ready.append(h#$def _add_callback_signalsafe(=#, 0:0Wz"""Like8p() but Ged from a LBUr."""E\.zd#write_to_1() Bt__cancelledNotification that a 6 has been M #if._scheduledD_count += 1rrun_once)G"""Run one full iterof the event loop.OyAThis|s all currently s, polls for I/O,MAsdresulting:and finally /A'v_later'6.  ?Q= lenWHif (/> _MIN_SCHEDULED_TIMER_HANDLES andf/>8<imCANCELi_FRACTION4# Remove delayed Uvat were[! iir number# is too high6new~Y = []@ in 3Vf&*UM = False*OelseD @`heapq.Iify(8) 9 = - , 5= 0,head of queue\while F[0].Q -ln0 = W]?popz<82Tout = Non#if#orstoppingEDs# Computedesired L {Den =hEwhenA = min(max(0, &" -A!()), MAXIMUM_SELECT3OUTK@_lis selector. (M6out'process_B!s(I^ # Handle 'later' callbacks that are ready. end_time = self. B() +_clock_resolution8Swhile%scheduled:^UhandlY_&9[0](2if +._when >= QUYbreak?< = heapq.Apop(u)4. = False&C1rappend(m%) (# This ibe only place where|actually *6ed*# All otherAs just add them to# Note: We run all currently n, but not any%5&by8^t around --Cthey will bthe next 3(after anI/O poll)Use an idiomT~-safe without using s@ntodo = len9yfor i in range(0)_ _A.popleft(Jmcancel&zcontinuU#if6Zdebug5>try_ *$t0 %@_._run"*dtG_ - t0qPif dtTslow_]P_duraBlogger.warning('Execut%s took %.3>conds',I _format_J, dt70fin_:NonNelseB i0 = F # Neededp cyclesOn PexcepH occurs.def _set_coroutine_origin_trackP, enabledif bool(2 ==1.Q_1 breturnR$ift (^ saved_depth = (_sys.g <*()7( 7 p constants.DEBUG_STACK_DEPTHbp& ) self._coroutine_origin_tracking_enabled = def get_debug(self):preturn ."5s5,V>7 v]"ifYis_running(="Acall_soon_threadsafe ._0 __D _ = () import reprlib from \ bident ."format_helpers # States for Future. _PENDING = ' ' _CANCELLED ' _FINISH @' 1isfUC(obj"""ChecksauRThis s True when obj is - instance ordvertisingF ity as duck-type compatible by setting _asyncio_A_blom.H!Se8sment inmore details,1"""4 (hasattr.__class__, 'ra') andC:Oobj./not None)l_qbacks(cbt function __L$__size = lenB0if o^ cb 'S$b($,s.u_sourceAR, ())bp;= 1Ucb(cb[0][0])'el525'{}, {}'.>(_E,'11Z [/> Z@<{} (>e# _ - 2,2 -'cb=[{cb}]# bpo-42183: rPeeded~a proteO" # or Task result contains directlyn. # The logicq`borrows@lib.recursive decorator@Unfortunately, the _'` usage`/"ss ecause of # AttributeError:.'ect has no . '__module__' e<0. #Pfter fixut th cwe can2 to based approach. m =j$b_info(2# () -> strC2"""VB = [Y0._s;.lower()]Q9if E == !'exception is not None: info.append(f'exception={future._U!r}')<;elsJkey = id(:), get_ident(8{0if -in _repr_running)result = '...'| P.add(key}'>trym`# use lib to limit the length ofoutput, especiallyL# for very long strings,.M"._0fin~ odiscar j"={2if ._callbacksuBv_format'9)Tsource_trace\[uframe =~ *E[-1]Pf'created at {GS[0]}: $1]preturn < import collec ssubproces0wars from . =protocolsPtrans_4log4logger class BaseSqT9(C.1):  def __init__(self, loop, , args, shell,4stdin, stdostderr, bufsize1pwaiter=_s, extra @**kwl)super().0._closed = False% = "! = ! =  ip !0cod Rexit_Vs = [aending!^g.deque 20ipe*+{}gfinish iffin == V.PIPE|`pb<[0] G?outH1H?errH2H1# CwPchildQ: set_attribut. ^`start(==F= H"')=1 BWgRraisep uroc.pid_extra['subprocess'] = self._proc #ifloop.get_debug():#*if isinstance(args, (bytes, str)/3program = / NJelse`19[0]4rlogger.' ess %r created: pid %s',7Y,Fpid) Sb_task(connect_pipes(waiter)=def __repr__/ info = [F_class__.__name__jclosedF.append('!%');is not NonbDrf'pid={Opid}Nreturncode U2\c/el'runningF'started' Vstdin *(0Q&S!={."ostdoutr1rostderr$2$4KS and > is ?out="f'=35out![f] 9mf1X '4nfoX1err5errsw '<{}>'.format(' '.join( &,p, shell1din1outerr, bufsize, **kw raise NotImplementedErrori,0setStocolv1proI4 = $II? F;0is_H?ing9 $&ed7 2Z )r = True^2for5 inpes.valuesQcontinue44.(1if &YF]i GK# has the childm finished?2[_[q_t g# transport h asn't been notified yet?  self._proc.poll() is None): -2if ,loop.get_debug():'_ logger.warning('Close runp child ress: kill %r',_)u>try_A.=)() except ProcessLookupErrorIJpassp@# Do9clear the  referenceE: _post_init() may st2runOdef __del__(0, _ =Aings9 if0._c.d?R(f"un transport {a!r}", ResourceWy", =" %.K(r1pidcreturn6pid1Ocode8 ' ?Upipe_CG, fdvif fd i:pes\pes[fd].[Oelse6a_check 7& SOaise{esend_signalb", jg IPterminatA\ ?Tm@:J`async o_connect_s gwaiterb $ =5roc|%op!ifz`.stdin1not +0_, @ = a M.Qwrite(9lambda: W(0SubessPipeProto?0),?/W.{as[0] =?out(Areadk ORead1 ?out 1?errm2 ?err 2dassertending_calls loop.call_soon(self._protocol.connection_made, 7) @for @back, data in(._pending_ )s:7B)lo|&F*G gy Qu = NoneWexcept (SystemExit, KeyboardInterrupt)MraisBQBaseEMion as exc7if waiter is notA and .cancelled(u$Bset_vion(excOelsevHpresult(B!) DAdef b, cb, /if,0.ap ((` A *Wpipe_Clost0fd,Wr#G$, B)try_finish(ED_receivedfG.FArocess_exitjreturncodelvassert ,2/ 8:&._:*get_debug logger.info('%r S with B %r'm9 =>=Vproc. %# asyncio uses a child watcher: copy the status intoUPopenu. # object. On Python 3.6, it|required to avoid a ResourceWarning.P + 8 Lwake up futures@ing (I'_(+er/if=!q2L ,"""Wait untilo es!itu v.6This methoda coroutine."""'3FE/` $ 1uCer =#create_future()  self._exit_waiters.append( ) &return a 1er def _try_finish(S!):8assert notm'%ed"#ifccode is NoneGK 8Pall(p-_1 and p.disconnecthC for p inupipes.values()/.ed = True"c- _}ion_lost,)0&:W, exc:tryfprotocol.j(>ofinallAaloop =/Oproc }" class WriteSub>essPipeP(Rs.BasWcol):s_init__BG, fd 0 = ffT = FalseSCmadetransporteipe = Ic__repr7Q f'<{!__@__.__name__} fd=@fd}  V!r}>'gm :h !X ._c U2.fd |6gpause_writing>m! 1,_resumK 2$) ORead,7 data_received ,  @ipe_ 3t@) im linecachetraceback from . *base_futurescoroutines R_taskPinfo(8 = N.W 10if ?._must_cancel# replace statusdhr[0] = '4Cling0.inKP(1, ''b=%r' %k1get;#():0 = ._format_.eP2, f'+0=<{3}>'Z$fu5O3O6"={AB!r}'< Qstackd, limiframes = []Mif hasattr-, 'cr_frame'):  # case 1: 'async def' coroutines %f = task._.cr_frame elif hasattr(%R, 'gi'1'):*Js2: legacynGDn/agn23: generatorFm-se4: unknown objectL2Nonif f is not I_while%if limit?"&F<= 0^Qbreak\I-= 1s.append(f) = f.f_bacQ2reverse(2exception%tbW*.__traceh%__3/tbIs"&4BRtb.tb sAnextrreturn D def _8_print_stackQ,c, fileL ex'ted_list = []Vchecked = set0fornn$ge\=Vclineno Zc2codname = co.co_8  &0ile*3in T.add(_ dacache., +'0 = #@.get +n,vglobalsk y.>L1)) >exc!if \a(f'No  {,B!r}'=m MTg N (most recent call last):gWSS! .P( ?if )F in \uformat_u_only(exc.__class__,T(O, end='') import enum # After the conneclost, log warnings a+(is many write()s. LOG_THRESHOLD_FOR_CONNLOST_WRITES = 5n!Seconds to wait before retrying accept(). ACCEPTJ_RETRY_DELAY = 1 # Number of stack entries to capture in debug mode. # The larger the nuC , RsloweoperationA # (see extract_w ()%format_helpers.py). DEBUG_STACK_DEPTH0Qecondwait for SSL handshakesompletedefault timeout match0hatNginx. SSL_HANDSHAKE_TIMEOUT = 60.@Usedsendfile fallbIc-w We us@platPs # tpdon't support LA, orTLS connecOs. SENDFILE_FALLBREADBUFFER_SIZE%24 * 256-The enum should be her break circular dependencbetween # base_events and sslproto class _SPMode(j .Enum): UNSUPPORTED =q.auto()PNATIV; 8 __all__ = 'coroutine', 'is1fun0 Q' imhDcollS4abc8Doolstinspecto%sy e&Etypewarnings from . U fufsconstant8$54logSlogger def _is_ _m# If you set _a!utrue, @@ will wrapresultingP# genor objectsa CoroWrapper ice (definewlow). ThatI&pa message when~n`is nev^t#edGover, which may hnB`forget "a*"bp"yield "Lvwith a Scall.BNotePvalue1 Mflag is taken6decorator"used, sobG1any1pit must$se+abeforeR rs. A downsidOusing this feai{sw.__next__ methoyV2rue+return sys.Qs.devvG(notignore_environmentfAbool(os.:.get('PYTHONASYNCIOs'))) =# C$# Uc!. |_init__(self,/ , [S=None`assert,e5.isP(gen),.VqIh`.gen =m self.func = func # Used to unwrap @coroutine decorator self._source_traceback = format_helpers.ex t_stack(sys._getframe(1))P _name__ = getattr(gen, '_}', None7Oqual;?wdef __repr__(!):C = _-,0if >OS/ =,E[-1]R/n+= f', created at {LS[0]}: U1]}' @return f'<{_class__.I5} {a#}>;?iteSOh-Nnext>-.gen.send(<Ow, value}?%|Qthrowc, typeG=g , u\GA<)nQclosenL%6@property1gi_G (~HrunningJ*L?cod0gi_'Fo__awai .yieldfrom,P~>delw# Be careful accessingq~5 -- might not exist.~7genE'genB%T  /2if 2!iswB and.f_lasti == -1?0msg^'!r} was never "eD5om'.tb G', (8Zif tbO''.join(c. {list(tbK8+= (f'\nCUhobject :f'(most recent call +1unc?to A {constants.DEBUG_STACK_DEPTH}M lines):\n'btb.rstrip(#logger.error(msg) f5f=D"""DRqUmark *"s.fIf the 4 before itdestroyed,1an message#d. """ warnings. F('"@coroutine" decorator is deprecated since Python 3.8, use "async def" instead', DIBionW}&stacklevel=2) Dif inspect.isfunction( !):*.F# In5 that's all we need to do for Ns@defined with.$preturn z  Agene> v" =?Felse@7ools.wrapsg-1def(*args, **kw#3res_ %C$if (base_futures.is `(res) t JN is@ance', CoroWrapper)/yield from re! # If 'res'an awaitable, run it06try_<p_meth =2.___except AttributeErrorV:paso< ;Qcollets.abc.AHC P(H&p`types. ( 9if not _DEBUGQper =K D+ds8w =M 1,M=:if w._source_traceback$?del)A[-1]$#[< 3.5 doesimplement __qualname_FU# on K objects, soset it manuallyA# Wekgetattr as some calls (such ay#tLpartial may lack)pBw.__3 = t4, 'z', Noneo9=AwWP._is_: = @ # FV # A markerW*. e=P() 4#B"""R&qTrue if_!ed9,A."""r(1 or1 <ne', None) is _is_coroutine) # Prioritize native ! check to speed-up # asyncio.is(. _COROUTINE_TYPES = (types.CnbType, Generator/ collections.abcH , SWrapper) __^cache = set(Gdef $a(obj):s """Return True if obj is aobject."""4!ifF0 inQ`ra AisinstanceG,, =?`# Justicase we don't wantmore than 100f<Aposis. That shouldF`ever hIn, unless>someone stressing the system on purpose.3if len(0) <+A.add>%))`L>FelsePFalse v_format(_iassert(wg7 = ' sget_namej#ws compiled with Cython oStimesAhaveW?proper __qualb@__ o q. Whilg a bug@#ini, Rcrashan AttributeErrorDits __repr__ fun%imq;helpers.qallback=.^, (), {})Cif hasattr'8, 'a') and. . =+/ellp hd'`# Stop maskpbugs, exnma friendly wayG@f'<{-1)._1__}Dout %>'%'{JB}()'is_runningW6try LI4.cr7kkexcepts B S W-giW#['8@_codF2Non !cr% K Z`-giUU"g = get_name(coro)  if not coro_code:# Built-in types might.have __qualname__ or __ .Bif is_running(c)_creturn f'{@#} 0'G7els85 ,frame = Noneif hasattra, 'gi_&a') and. N $W.elY.crYY $# If Cython'sPutine a fake  object without proper# co_file -- expose that=a.5or ''lineno = 0ppif (is_%pwrapperY.func isC &inspect.isgenerator8AtionF)IPsourcformat_helpers._get_;_&B2if /%, 3EI E krepr =done, defined at {q2}:{r} ZL]M   9)2.f_F1EC \r2rst4w cI """Event loop& epolicy.""" __all__ = (J'Abstract?QLoopP./',5', 4dServer+`Handle TTimerH__,Oset_6/7newApchild_watch 'l h_YC -) imporntextvarso dsocketsubproces y threading from . a C class oB"""Oz)ed by callback regi methodsr__slots$$'_6Q_args cancelledyB'_be|/u _weakref__> '_co)ntext') def __init__(self, callback, args, loop, co8q=None):<@$if@ is  7$ ='vars.copy_%()M.3 ! = ; "! = cancelled = False arepr =2if .get_debug( $source_trace_ = format_helpers.ext_stack(fCsys._getframe(1)8JelsewsQ_infoB = [I_class__.__name__]A I.append('$'AxI1notkL <__oFTelf._',QF # =D ,6[-1' f'created at {IS[0]}: 71]}#preturn @_LT+5nfo!;r'<{}>'.y(' '.join()^ ` f #:led_ f = TruS +# Keep a esentatioV  mode to k'!E andG@# pat For example,@log the warning>"Executing took 2.5 second":! =V ($ "A Y;&if isinst(,+m1 < 5v(NotImplementede,@h;3 orER_eq__ kg<H><g<H <-q,58 ==>E and~$._6: '62 z2 o`  ._^r_S2ledV/ (;-): """Return a scheduled callback time. 1The is an absolutstamp, using the sam?reference as loop.`5()."5""" rself._when class AbstractServer:24"""! s Aed by create_0().i8def close(i)Mq"""StopMing. This leaves existconnections openZ@ raise NotImplementedErrorS|@get_ 1GetIQevent0q object0tta? to~!is?ingqTrue if|@uLccep`async _startS / aqIl`method idempotent, so it can be1ed Q85lready be.-; ^_foreverla untilcoroutinecancelled!er"? "Qwait_BdC0to +"ic;#0__aU?"""1a F/8donZl$'s result, or h ityx/on5re .=pas soonreasonablExactly how)1thamay depend oi7a,Q, butxno more I/O{s should&Bis_rh(self): ,"""Return whether the event loop is currently running."""  raise NotImplementedError #def is_closed(self):?~s True ifBwas <u6qCg.2Theshould not be) ispidempot+and irreversibleWANo oYmethods _be called aftxxis one. f `async lshutdown_OgensS% all active 0hronous generatorswC default_executorqchedule" o @ @4# Msc1ingtbacks. AlluBse rsHandlesO_timer_h`_cance",  Notification that a TE] has been M7S_soonw, *argsv.&_later(0,4^(8~, delay2 U#atOwhenQ,Ncreate_future@O& sNa coroutine object: dw a taskK_z,<, *, name=Nones for interng with thread6_"af,jrun_in,d, funcf4Cset_^/Network I/O  F0getaddrinfohost, portB family=0, typePproto flags=0 .@sock/, Wrror as ync def create_connection( self, protocol_factory, host=None, por :c*, ssl$family=0K9=0,,PflagsCsock3local_addr 1pserver_Oname"sl_handshake_timeouhappy_eyeballs_delayO interleav`%): raise NotImplementedError #+as^Z8P/et.AF_UNSPECV$I_PASSIVE, backlog=10Qreuse3ess7s{`start_ing=Truec"""A coroutine whichs a TCP :er bound toA and.The return value iBSCt object`an be useQAstopF1ther7ice\"IfwSn empty string or !B allKfaces are assumed\a list of multipleets willed (most likelyEone for IPv4another @6). 9 parameter can also beOa sequence (e.g.)=sq!biyPb/t'!eipAF_INET 6force thze:2use6. If not set itd7minSBfrom(default+)qbitmaskI0getXinfo(/ op1@allyspecified in ordera preexistingaG#ettmaximum numbf queued Rs pas^MYen() 9100!slan SSLContex`enable0 ovjaccept%Cess tellsp kernel"1 a 5 in TIME_WAIT state, without waiLits natural 5 toDfexpire:Vautomaticz& oMUNIXallow this endpoinL%beAsameB as .@9 long asKyn}X@ wheing created. This option is not supported on Windows. sl_handshake_timeoutD@the  in seconds that an SSL serverHwill wait for comple0of K3h before aborting"J`connec<. Defaul)60Ptart_?set to True (d4p) cause`e crea1@to sIa accep~s immediately. Whe jeFalse,user should a S".bd() or !_ Vver()O`o makegH.;5""" raise NotImentedErrorasync def sendfile(self, trans4 , , offset=0, count=Nonh*, fallback=%):"""Send aX through ar`Returnn amv! ot bytes-N_tlsprotocol, sslcontext, *Tk_side=#+hostnameI 4 TxUpgradeH0?TLSOF newp**lUusingp"f_unix_p(U/_factory, path 3sslBsock S_~s JrW. `qlog=100  ( ?ingA coroutine whichOs a UNIX Domain Socket{RThe rPvalue^a object,Yan be usedEstope'ce]Qstr, represenhasystem:U@bind[YU'to^JC can\@allyspecifiedPorderY usppreexisb[_maximum numbervqueued %Rs pas liste n() (defaults to 100). ssl can be set!an SSLContex`enable over the?accepted connections^_handshake_timeout isD  in second2at ~u servergwill wait foZcomplete960sPtart_]4ing6Tru6p) cause`e crea1@to sI K immediately. WheJeFalse,the user should aS.bd() or !_forever()Oao make\H.;5""" raise NotIQmentedError5async def_datagram_endpoint(self, protocol_factory{local_addr=None, remote*Mfamily=0 flags=0CBreus~5essBport>allow_broadcas=Q sockH%):I"""A coroutine whichsDs a v vvThis method :0try establish#9backgrounduccessful,9`return`(transicol) pair P mustzaa callfSSaB instanceL32et  AF_INET,J3et.66*UNIX dependa%onmhost (orPif specified)V type SOCK_DGRAM #R tellA`kernel|"1 a & iTIME_WAIT[te, with-its natural> %toexpire. If not2 itautomatinyy)  tuT to_bN hQsame Mas other exist@ds are ? long asthey all} wo beM!.  op|5notF0suped on Windows and some !'sQ@:py:3:`~]SO_REUSEPORT` pdefined=n(capability%un~_3point to sen3d messages to the broadcast address. ,sock can optionally be specified in orderMuse a preexistingGet object.5""" raise NotImplementedError# Pipes and subprocesse%async def connect_read_pipe(self, protocol_factory, %):"""Register = event loop. Set4<non-blocking mode< r` shoul3stantiates with P interface*pis a file-lik<$Return pair (transport), where @ sup$s TReadT?P# The'0sonmaccept instead of jus! descriptort# is: we needQ2ownclose it athfinishg# Can got complicated eFs if pass f.CWno(),cfx%Sthen vVversa} _write&>7in .OBase > is al/y switch4non$'W6HZo_shell<fcmd, *Aqfstdin=V_.PIPE6?out7!?err7**kwargs __exec/*a -"?std,   stderr=subprocess.PIPE, $ **kwargs):) raise NotImplementedError ## Ready-based callback registration methods.1The add_*() return None'oremove*True if so^ing was 0da# Fals&Qthere"@noth.to delete.1defreader(self, fd,?, *R_U^D+Owrit> U@# Co ;I/OesFuturesc`async sock_recvh, nbyte{PY_intoU?buf RysendallPOdataQ&yconnectQoaddres'XaccepS&Ifile, offset=0, count=eDC*, f .# Signal handling?9 s_?sig3^Task factoryset_task_ha gLC!# c$erZ exT9ionf_HH,wQdefault_UcontextUR7# Debug flag manag1d$R<, enabled): 6 raise NotImplementedError class AbstractEventLoopPolicy: """A ! p for accessing the e: loop.""" 9def get__b(self)W[;GetA^Tcurrent context.V8Returns any object iEBase interface,O"or$Qxception in case nofhas been setJ A and@does not specify to create oneIt should never r N&hs, Sf?new C <Xa newaaccordeo thisi's rules. Ifre's need40 as!d5forO, must be called explicitly!# Child pro_es handl(Unix only)"ac3_watcherdb 2e%."JA s#, aP~"lDefaul(3"""8+a ~!InhA, each thread hits ow`. HowA, weh automati/y Bby d7AmainDts; other's 2;hav6O2!ies may ,Qdiffeq4 (e.g. a le global|7 ,  p4GuZS some!no$of[whichassociated).R n_factory =1r_Local(EPing.l(A9P_set_ed = FalseU__init__!._`2 = ~)=Vx C4"""%{\' Returns an instance of EventLoop or raise#exception. 5""" if (self._localop is None and*=Y not 2set_called0threading.current_ ()g Emain)):xpheR_loopGnew_5)) 8*if5r ^- RuntimeError('There/3no  i H"n U %r.'t$ %-MW.namenreturn det,5"""Set the.7[e= Trueaassert_=`$is{(, Abstract)C j.! =P 1 Create a newCnYou must  +) to make thisM( op_factory() #~ policy. The 0 itBalways global,0 if# #.'s rules say tha!an23perZ (or other #0ioncontext)sdefaultgbke first #GXto gem_G(). ! =5Lock for protecting on-the-fly c  . 3k ==XqQA TLSd>@runne, used by _!. class _R65(e _pid = (,_R* =M! z(WB"""R@. R) a) Rnone.T@func-specificr# NOTE: 6implemented in Ce _asynciomodule.cM!if7pl3no M'hxo0 T U5is a low-level pntended9%beK_sTzZ) running_loop, pid = _runnin._pid if  is not None andA= os.getpid():8<ireturn@ def _setu(u;"""Set the;p event $!. _@Thisa low-level function intended to be used byE&s.E6s thread-specific&1""".# NOTE: t{6implemented in C (see _asynciomodule.c)E j1 = ,H),Qinit_t_policyi~global !pwith _lock/if.M: # pragma: no branchLfrom . import DefaultEQLoopP 1/ =8(/geC"""G"@curr " . _g" #If,dkrestored gassert@ or isinstance(, Abstrac # =W B"""R3an !When called ma coroutineaback (e.g. schef!d ;Q_soonor similar API)K&is-will always z If re/no@ seteed]aesult of `,Rq1()`@(9if * ^ )[ =-()G X%OpEquival!toOing bK8o.59new?""" G1 8child_watcher{"Equivalent to calling get_event_loop_policy().child_watcher().""" return; def set_U]!):Y"""Equivalent UB # Alias pure-Python implementations for testQpurposes. _py__qrunningb= = * * *S (1+ =b tryy#() is one of the most frequently?!edb# func in asyncio. Pure 23 is;about 4 times slower than C-accelerated./cfrom _a]ort (O<, _8,@ <, ) except ImportError6pass else*C /_c#- P -_ce+, 4"""x` __all__ = ('Cancelled'', 'InvalidStatebTimeouL'P'Inco_VteReaGLimitOverrunG 'SendfileNotAvailablo) class a(BaseE6ionpThe Futor Task was cS(M op@ion ;AededSgiven deadlineV 4[is not alCd in this sw \)@(Run^0@ sys5jf!. Raised if OS doe0sup5# sF3socket orGR typesK(EOFF+p read e. Attributes:- partial:(0byt trabefore0end astreamSreach - expected: total number3 [P(or NXif unknown)'__init__(self,,f/%r_a= 'undefined'is None else repr(expected) -super().__init__(f'{len(partial)} bytes read on a total of 'ELTf'{r_m$} L'~Celf.k3 = Xs==H "def __reduce__(-!):return type!, o , 1.^) class LimitOverrunError(Exception_"""Reached the buffer l8 while looking for a separator.Attributes- consumed:^`numbereUto be A.1""", message,8 - % =Eovsargs[0]v^) import functools0instreprlib%sy)traceback from . Sdtants Aget_hion_source( 3 = yr.unwrap!h%if is- ^acode =0.__!__>(.co_filenam"derstlinenoussinstan,],c_.[omethoda#DNoneformat_call , #j_K = _5s. , ]0(2if +n+= f' at {$T[0]}: 21]}7 p_and_kw (", A"""F iYrguments and keyword;Special case^Pingle<ameter: ('hello',) is&matted as)D`# use qclib toalengthhe outputitems = []f .extend([.)10 ins( Gpf'{k}={F2libNAv)}'N@k, vOB.9"()Yrr'({})'.R(', '.join(,)*  r^, suffix=''@n'7# +ql_).args, func.k,eywords, suffix) if hasattr(func, '__qualname__') and .:<@~_repr ='&/eld`\ #X/se,+= _format_args_and_kw (", )a#if+f#+=+areturn  def extract_stack(f=None, limit )Z"""Replacement for 8jeback.D) that only does thenecessary workDasyncio debug mode.+1"""if f is  = sys._getframe().f_590# L amount ofto a reasonableK, as#y# can be calledeach coroutine}ture inE= constants.DEBUG_STACK_DEPTH' =vStSummary(Dwalk!),Dp=8ookup_lines=False,.reverse( """A Fu'class similar to!on@PEP 3148. __all__ = ('B', 'wrap_fQ$is ) importqcurrent.sutextvartlogging"sys from . OCbasess]eventxceptionhelpers 8 = e. _PENDING# _CANCELLED# _FINISH$4  BUn - 1 # heavy-duty:" """This is *almost* compati0witRn.I.#Differences:*- [not thread-safe8- result(Eea() do 4ake a timeout argu1andv` rais >Q whenZ isn't d5yet|@Calls registered @add_/_[#re alwaysq1vialgb loop'"u_soon()o gtthe wai0as_"Sleted methods/,cot packagc(In Python 3.4 or later we may be able to unify the implementations.) """ ## Class variables serving as defaults for instance+.B_state = _PENDINGresult = NonePexcep Iloopsource_tracebackcl_messagv_# A saved C$ledErrorlater chain6an scontextdtled_exc~# This field is used`a dual purpose:-- Its prese9is a marker to declare that a csD Future protocol (i.e.intendedQ be duck-type compatible)`# Thlue must also be not-H,F enb a subPat it7notm by settft,!to60set+__iter__() below soTask._step() can telle differYubetweenr`await 5()` or`yGfrom(correct) vs# ,?4(in)&_asyncio_f`_blockr= False\Y__logdef __init__(self, *, =)DInitializ."e v.f#o[al event_JP argu allows explicitle2>M:bobjectbJv If it's6avided,"5NHhG !if $.=Jfs.get_(-$el ?@callnes = []2if 3pgdebug(^format_helpers.ext45ck(fCsys._getframe(1))_repr_info = basex#s. !1]6]return '<{} {}>'.1.____.__name__,' '.joinBv$()3del!ifHd 0 #WCR() wa2or uV() or# has consum8&he+ ) :BE = {n''2f'{N t}0evetrieved''': exc,  'future': self, % } !if._source_traceback:#5context[''O'] =BA|._loop.call_exception_handler(_!) 4def __class_getitem__(cls, type)return cls:@propertyH6log(@9.__+Q .setter^ W, valcif bool(Traise ValueError('m can only be set to False')D" ='M1get B"""RBthe event  F; is bound to."""z( "ifEvis NonecRuntim"j`objectqnot initialized."qr_make_cancelled_eO"""CreateC-{[!if isV.PThis shouldece when Ting aDaa sinceKit eraseswcsaved  (S5ue.5_messageG~Vexc =X*s.(h;els< o.PSxc.__%__5%xcr# Removreference; we don't need tganymor"]! =dJ2excI'`, msg=C D9] and schedule ?s/IT/is alreadyDe or Ced, . OtherwiseRchangRQ's stoJ /Tr]G _!= _PENDINGkb:= _CANCELLED!W = #__X_4 Internal: Ask+uoll all'ThE are,Sed as soonpossible. AlsoRclear)4gR list """  callbacks = self._@[:] #fif not.:ureturn IF = [N5forK, ctx ins\LPloop.`_soon( ,, context=ctx)def cancelled(E)XA"""R True if the future was:E."""s._state == _CANCELLEDz4# Don't implement running(); see http://bugs.python.org/issue18699 rOdone0is 4.-Done means either that a result / exception are available, o,1theO%. != _PENDING$T thisrepresentsIphas bee[ , raises CError. :$'s& is8yet LInvalidSOKO P and 'an}Bset,"is%d.Oc/if5excUmake_ _e%()a/ kFINISHEDj;T-s.2('R{!isUvready.'.__log_tracev = Fals .ONoneW/ j/ '^Dbset on0The_$P (or 'noH):ed only ifa-m FB\ ys> E#?set1k@add_asv, fn, *) UAdd a@` to beu@ whebecomes done.  The callback is #ed with a single argument - the future object. If M is already done when thisf,0~Htschedul#e_soon."5""" if self._state != _PENDING:$%Uloop.RA(fn,>, context=)<JelseJ$if.;Non nG$ =+vars.copy_(c1s.append(21)) # New method not in PEP 3148.#def remove__X(gV, fn)A"""R+ all instances of aQ from"L[c" listwqReturns,`numberJ5Hsdfiltereds = [(f, ctx1l Dfor +.J< 2@if f>5fn]*Cd_count = lenBV1) -iJ| n[:] = OaHP# So-jed internal(s (note: no set_running_or_notify_cCl())C*Qesult1, r =AMark@ andh0 itBW(If0,, raises InvalidS_ErrorV#^ exceptions.`B(f'{n1}: F!r}'!+# =4? = _FINISHED _(&anTif is(8g, type>& =+!if6F)StopIteraH eAType)(",acts badly0genLFors  "x0can"be/ o a Future")  self._exception =  "" $state = _FINISHED _schedule_callbacks()$log_trace = True %def __await__(s!):bif notWdone( / ._asyncio_future_blockingg)QyieldP # This tells Task to for comple.raise RuntimeError(" wasn't used with ")areturn.result()BMay XBtoo.4__iter__;,Amakebatiblej'from'. # Needed@test+purposes. _PyFH2 = 1 get_loop(futp# Tries91.*) if it's availableN# Otherw0f7G usthe old 'q' property=6try#l =T{ Attribut;Bpass(6lseYAfut.Bset__unless_cancelled)", 1"""Helper setz#P only1 8TA."""!if'(j)tconvert:sexc(excexc_class = typeU if.is concurrent.4s.C ]Lto c noS*TIther Future m ay be a concurrent.futures.F. """assert source.done()if dest.cancelled():>areturnA2not0 CXE_tFelseeexception =15if @ is 7NonI&mEset_,(_convert_ (); fresult%r) def _chain{(',B0inan@"""C*R two s so that when one completes,does the other. BThe F (or3C) of_P will>copied to8Ip|Fe gets B too< Compatible with both asyncioO and!if"isE)C`isinst, DGraise TypeError('Arequired foreargument'b 7^ ^" _loop = _get ]) if l ]4 @"E JK0f _bstate(3,"O$?S_copy_Lf,*T Fn)all_check_T(biZ!isp g d@d 2O .csoon_threadsafeS){8if B (o*pis_closjBru6PL&orK$ KEHK /QM_soon_threadsafe(_set_state, destination, source) .add_done_callback( _check_cancel)6C1z) def wrap_future(, *, loop=None):W"""Wrap concurrent..1s.F= object."""1Rif is#XJrreturn /assert isinst5,rA), \<R/f'is expected, got {yA!r}'A!if@ is V = events.get_ _(p3new?! =Fs.create&d_chain&, <Lb try import _asyncio except IRError(pass elseC# _Cis needed for tests. =+=h """Synchroniz primitives __all__ = ('Lock', 'E; PCondi Semaphore vBounded3) `collec6swarnings from . +s$ions class _ContextManagerMixin*Y __aenter__(self`await .acquire.# We have no useghe "as ..." clain the with>Ament9Clock 3xit, exc_type G, tb`releas(;D"""P "s.A Pis a 1@ tha not ownedby a particular coroutine whenY_ed. nain oneGqof two O@s, 'ed' or 'unI#d %C. It hasVbasic methods,p U and ]@. W`[%, 6Dqchanges-#toV2s immediately`C7#is7b bs until a E6 to1 inChanothey it1tVFrresets 3z(edg. The}M should onlyG!beSeK;_b4to D;If an attemp@made" aOVP, a RF!mer will be raisedT@moren one coroutine+ is blocked in acquire() waiting for the state to turn"un;, only one coroutine proceeds when aF`releas`call resets\Tw; firstQQwhichGe|assed. 1Gis aTand should be ed with 'a'ALocks also supportasynchronous context managementatocol.'/_9'R*ubUsage:50 = !()S".._  (.)Etry: .:kfinall!IC?r u6   objects can`tested%aif not.Ied()c$ Ielse.#J(Qd?& 2"""def __init__(self, *, loop=None ._f`ers = \ = False!ifQ5  :op = events.get_ _< ?.vwarnings. R("TheAarguis deprecasince Python 3.8, "OS"cchedulpremovalF_10.",GDBionW,icklevel=2)Crepr resuper().__&textra = 'E' if:MY$ ''( W1f'{ !},ers:{lenP3&)}W!ref'<{res[1:-1]} [F6]>'KB"""RD@True(b.plb8iAf0 a dbZThis methodqs untill,T,!n BUit tod*0ed N s &@if (0;mzl all(w.cancellowV'))q==  B J[y = collections.deque()  fut = self._loop.create_future() %#waiters.append(fut) ## Finally block should be calle fore the CanceWErrorC handling as we don't want31 toW; _wake_up_first() and attempt/a up it:Etry: aI fut+f @/c_40bremove0rexcept Zions. Teif notJcked!Su  Vraise1ed = True/breturndef release(9)B"""R0 a O.dAWhen1 is ed, reset i un{.v If any other coroutines arel0ed k86fornto becomillow exactly one of:m,|proceedinvoked on an L, a RuntimenEPThere2no f value5"""/if v = Fals5!\Felse0 0('L!is{acquired.' tt @WakeuPer if is[done.;ers Pnext(.) StopIterationjk0# . () necessarily means that aPwill Rlater9dL!eit'$S, or,!Twas c-"0 wa9HAn already, {h\his agai&Sa new}e3fut set_result(.) class Event0 """Asynchronous equivalen thAing.3cCEimplementeR objects. An PmanagR flagt0cani"seto true with0 seamethodF}@to f9)clear() +1The+u s l`!isv . 1PinitinVH_(!__P, *, W=NoneP_ = collecns.dequ^ if loop is None:  self._loop = events.get_ %()1?els? F,dwarnings. `("The $ argumentdeprecated since Python 3.8, "OS"and scheduled for removal inF_10.",GDBionW, stacklevel=2) =def __repr__(5)Hres = super().&8xtra = 'set' if A._value U@ 'unk$vwaitersmeP1f'{ 4}, (A{len#._5)}'Wreturn f'<{res[1:-1]} [F6]>'ais_setKB"""RD@True@only the internal flagvtrue.""vsNSet \1to \ All coroutines 1ingUit toabecome6 are awakened. C? that callH@() o~N} will not block at all.$!if) 0 = `0fut+ F*jfut.done( set_result(r_clearsfalse. Subsequently,W5ing"()D@`until )<1Ped toI i againm*j0= FV`async ('A"""BMR.If'on entry, m immediately. Otherwise,U0anoPsE5+,n}  Zv=.create_future<Wlers.append(fut&:tryqa.E futnhkfinall? rer class Condition(_ContextManagerMixin@"""A,hronous equival]hreading.M.RThis hPimple4s cs variable objects. Aallows one or mores)'Atheynotified by another coroutine. A new Lock object is created and us s the underlying lock.B2"""Kdef __init__(self,&=None, *!op!)::pif loopv(E!._ = events.get_ %()JOelse?F,]warnings. R("Theqargumen adeprec since Python 3.8, "OS"; scheduled for removal inF_10.",GDBionW, stacklevel=2)zxI/ckI! =( =;>mvis not  Xraise ValueError("O 9must agree with"XAck =# Exportn!'s!ed(), acquire()`releasrmethods a?#edb.i"P# $f$wI_waiters = collections.deque(Crepr re;super().__&xtra = 'B' if0() B 'un') eX1f'{ 3}, Q:{len.;&)}Wreturn f'<{res[1:-1]} [F2]>'"`async WO"""Wait untilrSified!If @callt2 had' when thisHped, a RsmzSThis :,tubwb1l iGawakened by acy() or p_all() +tsame condiU variableG!ane Once@x,3re-/fs TrueD if r IA WP('canFd on un d |'aFh:trygRfut =.P_futuU.append(futW& da9futQ-, kfinall1e@<0# MG#re4ancelledMtcancelled = False' while True:#>tryawait self.acquire()>)]breakrexcept ions.CancelledErroruc$! = X5if !@_raiseqKasync def P_for(, predicate)Z@"""Wvuntil a$ becomes true.Z 7The%should be a callable which result will beinterpreted as a boolean value. aWfinalg5 isFthe retur85""" =J23notF8Y $9cnotify:n=1 By ault, wake up one coroutineing on this condition, if any.0If !2D@has d'lock wheXemethodLjaP, a R'!meA is d2is Bsat most n os0forwP variW@; ittpa no-op&no Es ar%Note: an aW6ned3D doedtuallyTvfrom itp lccan reL Kp. Sinceh)f~urelease2,k\2er R ifVk7ed(F!P('canv?3un-d"')Auidx = 0bfut inw_ :ers.0if 9J>= nS=Rfut.done#ydx += 185Bset_`c(FalsegA_allk Zall thread X0. Th'ac6likW, but%lldpinsteadRone. / =5ed,M>S.A(len4.)) class Semaphore(_ContextManagerMixinfF"""A* implementa4A sK! mCs0cou"Eqis decrFed by each acquire() call and incremented by each releas'". The counter can never go below zero; when aefinds that it is&, qblocks,Nwaiting until some other threads!. 6 Semaphores also support tntext manag protocol>optional arguP givee initial value foaternal;defaults to 1. If=Un0les]Ban 0V]PErrorqraised.\2"""`def ____(self,=1, *, loop=None):8"if#F < 0b v%("E must be >= 0")["._=f ers = collecbs.deque(H!if e = events.get_ _JOelse?.warnings. ("$is deprecasince Python 3.8, "OS"Pscheduled6removal inFB10."; DBionW, stacklevel=2)Crepr=ser().__&extra = 'qed' if y0() ZR f'unx!:{&%}' ?_ n1f'{ 4}, (A{len.;)Wreturn f'<{res[1:-1]} [F7]>' wake_up_nextRRwhileg * =$.popleftqcif notg.done(l"S.set_result($p A"""R bs Trueo}d immediately.Oko2= 0`async uH!AcDD a sU_i,\&Alarg!an  on entry #deUaby one k[Z iodcoroutine hasE&edt@make!0,tC,<=5fut.create_futug]ps.append(futl try:  await fut yexcept: # See the similar code in Queue.get.5fut.cancel() if self._value > 0 and no8^led()=wake_up_nexteUraise{3pE-= 1return True def release(6B"""R a semaphore, incrementing)internal cou v by one' When it was zero on entry `anothehroutine is `0for:!tobecome larger thanTpagain, (0 upCt coS5"""K+'Ks class BoundedS( =b"""A b&9Q impl8bation.QThis 0s V 0Errn@) ifRwould}"asBabovinitial & __"!__,'=1, *, loop=Nonen!if warnings. Q("The%P argudeprecated since Python 3.8, d "scheduled premovalFQ10.", ?DBionW, stacklevel=2)/=_super().=^27NaN =w e,('y#d too many times') """Logg\configur&import l" # NamZaer aftxe package. =8%eSer(__&!__|@Even`Pop usa proactor 1rel4kfes. A!is a "notify-on-coSN " multiplexer. Currently a `vis only edWindows with IOCP.% __all__ = 'BasePLoop', 0$io $os dsocket*6ingTignalthreading`collecs from .`base_eGsconstantlfuturex1if L_1 isE._attachEK.Q_soon`$._.ection_made,z#ifu# only wake up the37onna() has be" rfuturesresult_unless_cance`P>,O#zCreprz-OB = [F_P__.__5__]0ock(L0.apk!('&d'e%elC:ing >7ing?=-Fbf'fd={6.fileno()}X_\0^ |/!r[u 8< !f'1] > ^self._buffer7: info.append(f'write_bufsize={len(self.ufer)}')>2if @eof_9?ten\S'EOF &Ereturn '<{}>'.format(' '.join(1)) sdef _set_extrav, sock)u!['pipe'] =%DCprotocolF J4 = IDget_I?%;is_closing9 $8e36ingB*| = Trueonn_lost += 1cif notbuffer ande_fut is Nonewloop.call_sooZconnectioz,CkDreadfj(.cancel(K$! =nfq__del__h, _warn=Pings. }EP(f"un{ed transport {!r}", ResourceWarning="K(fatal_errorexc, message='F  @ on "':tryif isinstP(V0OSEi6\(odebug(+/rlogger.$"%r: %s",Y`, exc_= ;elspW6!._dQexcepchandler({0'/$':9,(Q ':&"':M%&.[W}kfinallQforcege '-]empty_waiter>(._'\.done if!BwGpresult(40 F@G7J" Y  B cf._read_fut.cancel() self._read_fut = None"pending_write = 0 obuffer<loop.call_soon(Qconnection_lost, exc) [_def _%@*:*6try eprotocol.i(h(kfinallA# XXX If there is a  overlapped 60 on& o+ZP# endn it may fail with ERROR_NETNAME_DELETED if w|Djust close ourS`. Fir alling shutdown() seems to cuQt, buPbe us;3DisEx() would be better.Gif hasattr._sock, '*')).'(et.SHUT_RDWR$. oo!rvxe s1not:._detachj7K5i2get,_Q_size5#2 = ]6He#ifGLT+= leb2[preturn ) class _ProactorReadPipeTransport(IBase,tG s.ZV5"""B forGpipes."""q_init__: , J , $, , waiter=Rextra   LdataY"aused = Trusuper()._ Ctra,< +6ing VFalse9$is2; CFand y6ingQpT73 or7d^E ]# bpo-33694: Don't `0bec'anG WSASend() loss silently the currenth"Limplementa##$AIf Cm!IoXsOT_FOUND,eans that N costed (even'EHasO4IoC"2() as 0), but # Overlapped.cancel() currently sil ignores the ERROR_NOT_FOUND # error. Once*o]B is D!d,IOCP loop will`Pcompletion I/O event and so not readNresult ofwLWSARecv(). if self._.get_debug():#rlogger."%r pausesQing",F)X@def 0me_@ing(dSvclosing or'!._\dbreturn`* = False_@_fut|JNoneTDcall_soon , ;|adata =._pending_Z! =F"0if 2b a# Callprotocol methode after <5(),dD# siHcan decide toy again.D(_received,)<]=^E_eofw]vJ EOFI:trykeep_open .)Lexcept (SystemExit, KeyboardInterruptw7raiBQBaseEMjas excafatal_(Vpexc, 'F#$: ! j failed.'F !if#e(',< K>Kr# Don't5any2e while"isdV# The;!beU\ed on)?oassert  "N &r^(Ox!J`isinstB$._,s.BufferedP  lHrs._feedCto_bLi u ]1 5J9tion as exc:+ self._fatal_error(exc,' 6P 'F4 4: protocol.buffer_updated() 'Lcall failed.')2ereturnUelse:data_received(!) 0def _loop_reading(:, fut=None)W60 = ;g6try! if;q is not, $passert i.w@_fut31or uE andyHf~closingI bg.done(# deliver ( later in "finally" clause3=:.result(wP# the= ure will be replaced by nextactor.recv `fut.cancel(#c#ifM# since !e() has beenned we ignore any u-  r !ifH == b''"we got end-of-file so no need to reschedule a new e}# bpo-33694: currentlyqfast path bec9 ofh2# aloss issue )overlapped WSASenRrlation.!ifppd F-?V._pro`sock, 32768except ConnecAbortedEmz as exc ]:ing"  on pipe transporta%elget_debugrlogger. _"Readf0 whx"S exc_info=True=_Reset;Porce_ze O/OSBWaions.Cdl 7raiO F  self._read_fut.add_done_callback(s!Aloop&cing) finally:if data is not None!%V(_received() class _ProactorBaseWritePipeTransport( ,ntL!s.`\)5"""` for w pipes.""" h _start_tls_compatible = True"def __init__O, *args, **kwmsuper().-'m&empty_waiter =fnkV>!ifisinstancew, (bytes, array, memoryview)Eraise TypeError( f"w argument must be a`s-like object, "?:B{typname__}"~2if G@eof_6tencRuntim')e_eof() al y ?ed'[gh0una "to7; sendfilein progress')< Yeturn)conn_lost0 a >= cots.LOG_THRESHOLD_FOR_CONNLOST_WRITESOlogger.warning('socket.1() d exception.M> Y += 1r# ObservEfstates# 1. IDLE: e and _buffer both~P# 2. 9ING7Eset;8# 3. BACKED UP56<We always copy theA, so ur can't modify itA wh.we're still 1ingPI/O to happen.;0futtA: #94 -> 7&cassertXL*isJ(0# Pa, if it'sXPimmut= SO=|s)#el6 P# Maku which wez extendi! = bmaybe_pause_protocol(!seAduP(alsoOies). def _loop _writing(self, f=None, data C): 6try if f is not 7P and H.VPe_fut zclosingLP# XXX most likelyM`force_7e() has been called,vGA# it*3setF!to.6ireturnbassert ( ! =c#rpending"I = 0$Sf.result()-c8=ibufferA*!ifKa#if]cPloop.Q_soonp!._connection_lost,; Gm1eof?>ten*sock.shutdown(et.SHUT_WR^# Now that we've reduced the size, tell K# protocol to 0me w`ing ifwas paused. NoterJwe do this last sinc-e@back?ed immediatelyKit may add more1(evUu#be~ again)Obmaybe__! Nelse@AJKactor.sendO Ug.done(@3  4-P len(C84P.add_?ingJ sh' rwv/mpty_waiter- eLA.setV0lt(aexcept CVResetError as exc`e=excO/OSB`atal_eh(exc, 'F!e  on pipe transport') qdef canQe_eofrV True23.'e(aabort(self): ' self._force_close(None) def _make_empty_waiter(4!):"&#ifF% is not N+/raise RuntimeError("E_ _:already set")ix.# ={loop.create_future(82wri d`.set_resultcreturn~: re? ;r! =3 class _ProactorWPipeTransport(NBase q_init__, *args, **kw%super()._-' i #_pQ.recvm._sock, 16C.add_done_callback93pipd)W, fut if.cancelled(t# the tF has been d,aassert_) == b''#lN:ingA Dz . @s, (fut,Woae x-`Broken)wJelse? Datagramdmax_size = 256 * 1024G#", protocol, address=,;a extra '_G$ =QK  # We don't need to  N.connection_made() since our basem# constru2 does it for us.& ,Q# The {sets _buffer|0 we6her%/Bcoll`s.dequ0m+.&Q_soon .__3ing('ck_ 1et_'Bget_$z+L1 sum(len(data) T, _ i4E abP asendto", e !ifisinstance(data, (bytes, array, memoryview)): raise TypeError('data argument must beLs-like object (%r)',LW Ptype(P5)) )pif not  Yeturn)self._address is:None and @in (), 1CValu f'Invali[Eess:_Y or {b*}'conn_lostQ t#if2>= constants.LOG_THRESHOLD_FOR_CONNLOST_WRITESAlogger.warning('socket.sendto() d exception.')I+= 1!r# Ensure that we bufferimmutable.Gd#.append(-, 45write_fut[ # No curr,` operas are active, kick I5offAhPloop_AE"# else: A e]qalready[0ed YZVmaybe_pause_protocol(BYdef _w4`, fut=:tryH `assertcp.b* 0 = # ifIyA# We{Kin a0) d callback, get the result`Bfut.7V[(8XHP# The0nec: has been closednlosingWw.T_soon@all_q=,c|CrM6# =S.popleft(H{cQactordv  z {/to6 + =1 OS0 as ? .e_received(exc3) except Eion as exc:!( self._fatal_error(exc, 'Fq write  on datagram transport'o?lse\D_fut.add_done_callback(~Ploop_'6ingP maybe_resume_protocol() Qdef _BqreadingU, fut=None)0 = ;b6try!2if conn_lost $breturncassert<0 isA or (._E andH1los/ =d [!ifais not 0s ='.t$ltk@'F* # since close() has been ed we ignore any d Hpaddress2j , /s = res,=esseF J 3kM7 2.Mactor.recv]sock,}amax_size*1=oOfrom5z:0OSE8.#_receivedDNions.Cancelled` ;!if_8:ing"UraiseW$Tn, &znfinallGk9%S<~) class _ProDuplexPipeT(IRead?PBaseWD%s.y5"""a for d pipes."""1canQe_eofDff False36e_eof(self):  ,raise NotImplementedError class _ProactorSocketTransport(ReadPipe", ];BaseWrite@t%s.u!):v5""" for connected sas.""" ,_sendfile_compatible =2stants._S!Mode.TRY_NATIVE? def __init__(self, loop,i, protocol, waiter=NoneRextraS serv*Dsuper().mg !, Q,L)Fbase_eveset_nodelay()D ^H_ =et_'GPcan_wA_eofJreturn True2.0if _._closing or1eofe6tena?." =},cpfut is  XI.shutdown@et.SHUT_WR):=ExXLoop("&): pKB logger.debug('U2pV: %s'Q1.____.__name__H|$._: = W@sele!"@ #Hvenient alias7f_reading_futur}s )caccept#as = {}`0et  descriptor => FNG.< Pmake_ f_pipe(Sif th.current_ ()' ing.main :# wakeup fd can only be installed to afrom the [asignala1_fd0._c". Hno()_M6 V={ 1'sl>0raw;(sslcontext*s_side=False@hostc v %ssl_handshqtimeout()j%ya = ssl.SSLProtocol(  self, protocol, sslcontext, waiter, / server_side, hostname.sl_handshake_timeout=s)k _ProactorSocketTransport(qrawsock_>aextra=={`return Zt._app_t i`def _mdatagram"address=None  !):.D 0  hU  )uplex_pipe Ws0 KPipe-  ) OreadBORead _writeB+ 0# We want connection_lost() to be called when other end closes  W90if .is_running(raise RunError("Cannot3 a : event loop"bdaqPif thing.current_W() isEmain`Fsignal.set_wakeup_fd(-1 # Call these methods before0ing$ (eallingp# BaseEQLoop.), becauseGy can schedul-backs withIF_soon(), whichforbidden_8the!is5ed.I_stop_accept_futures($_ N p0 =  0ele0# Csuper().close() async def sock_recv(self,s, n): return await %._proactor.90ock3 3[Y_into`?bufb@g:iysendallgOdatah?( !, 6dyconnectdaddressgB<mXacceplc8Lock)Y__file_native, offset, countx6try /Pno = .Ano()  ex" (AttributeError, io.UnsupportedOperation) as errdbraise Kions.SendkNotAvailablY("not a regular"size = os.fstat(Vpno).st_ !OSDPblockw" =y3 if `else f0if 5 0 # empty 7u = min(, 0xffff_;send_pos." +,) 3n 8PtotalVt = 0 uwhile True-95if ^ <= 0`'-wgljx.6 += q(kfinall7if 8>b.seek(R Mqtransp,v Oresume_reading = 74.isLEpaus3s%a_make__'er* B '(U,fallback=False|_resetj:if O  transp.resume_reading() def _close_self_pipe( !): $0if ."A_future is not None263.cancel()a/ ! =]-XQsock.I7c77internal_fds -= 1=?mak<1# A=-yet, really. :-,.$._7.Opair.setblock\False^Q' +Iloop)@, f=1:try Oif f*f.result() # may raise$fy7 # When we scheduled this F,assigned it tovC . If it' there now, something hasM0tri"o P the ]b whilecallback was still in*Pqueue (see windows_events.ProactorELoop.run_forever). InOthat case stop instead of continu%toTo a newNiteration.Zretur3f =pQ.recvj0._sf, 4096rexcept aions.CaledError#)` been v2ed,@waitfor data ~ (SystemExit, KeyboardI>Grupt#V BQBaseE`ion as ._3ion_handler({e'message': '0 onP fromT /_ .',Mr ':"!': }/ls-I = ff.add_done_#z write_to!10# Tv#bea different th, possibly afterY1 orkFit i # running. Guard y bemI1d.  a &e\ closed, send() raises OSError (with errno set to # EBADF, but let's not rely on the exact>or code).>csock = self._1if  is None:{ureturn :try!<.send(b'\0')+dexcept 6#ifZdebugwqlogger.("Fail to write a null byte into"w? "`-pipe Oet",1 exc_info=True)def _start_serving(W, protocol_factory,ebsslcontext=q , N#er backlog=100B _handshake_timeouM"):aloop(f[)g 3@if f \ 3"conn, addr = f.result($ ( `%r got0ew oection from %r: %r Y],L- =600._mssl_transport( f&, A<Q_side4 extra={'peername':}H=. ~k;elsg$_ocket'$  is_closed(X :f1pro/0.ac)( p B~ as excock.fileno() != -1(]Rcall_]1ionJ_ler({2p'messag/!'Ap failed|a?et'{'m ':*pet': tr $.T#S &@}>G el>m6  b/et sock, exc_info=True) rexcept ions.CancelledError:.9sock.close(K?lse/pelf._acg_futures[Dfileno()] = fg f.add_done_callback(loop) +s[X_soondef _process_events(.!, f_list)1# E$S are 7ed in the IocpProactor._poll() methodBpass{KstoptBfor h &.values(55!.cCcclear(4qserving , ea? = R@pop(1.W, NonV#if`p`;6ockewz#"""Abstract Protocol base classes.""" __all__ = (T'Base0H', ' Datagram43Sub 'BufferedQ )  g """Common pinterfaces.LUsually user implems that derived fromyFlike" or lThe only cDIwhenK should beed directly ismawrite-Htransport Q pipe)r__slotsconnection_madeUYa &a ;@ is >p@arguJV representingQ.Ho receive data, wait_@d() s9W[v 'd,lp_lost()C&edD>H2,$lB or 0 an[ epp object8 (Xelatter(@meanMa regular EOF">82 waNhpaborted&)`pause_g A's b goes overhigh-water markPk and resume>aired -- BonceAstriWD( if subsequent es increases the buffer size even more), and tually resume_writing() is called once when theGb`preaches  low-water mark. 1Note that if*BRequalAGhighB,AKpaus4not -- it must go strictly over.CConversely,  %isG0 or er. These end conditionFare important to ensur$`thingsas expectedeeithergHzerooOTE: Thisthe only Protocol7@backt#L[through EventLoop._soon() rfuQwere, ould have noFbeffectit's most needed (lapp keeps Awithout yielding until 6ed)2"""0rai Axcep1)WZPwants requests a ,r0y p*apfactory:a utility funclx (e.g.,reate_conne#-()made successfulB!_5  a suitabler objectIn data_received()Cqwill be@ed 0nb times[8 (bytes) @(G;P; fin,_lost() m2exa<"ncwT an epNone as@argupState machine of"s: start -> CM [-> DR*] AER?]L2end2X* CM:{_* DR:O* ER: eofhI* CLOO=__slots__ = ()QQP,~q VAsome#S)/@#!a i 41ed(self):  0"""Called when the other end calls write_eof() or equivalent. D# If this returns a false value (including None),htransport Fwill close itself.Z'itX3truW,+U5theDV is up tomprotocol.)""" class BufferedP&T(Base !):4 """Interface for stream Z with manual bQ` contruB ImBant:-has been addedasyncio in Python 3.7<P*on al`visioncasis*! Consider it as an experimental API thafmight be changedyremovedu8Event methods, suchd`create_server` and connection`,accept factoriesPimple"iqThe idea ofPllowsRly allocat)sreceive2. loops caQn use.Pprovi!by to avoid u essary data copies. ThisEa`result noticeable performance iml~j9Hig amounts)v. Sophistidx~ p only o1at ion timeState machinem3:start -> CM [-> GBaBU?]]* AER?]!L2end;P* CM:?Kq_made()* GB: get_3BU:_updatedER: eof_#)CLgClost5 __slots__ = ()8def, sizehint1<_s a new Q5*I*a)Pommenhqminimallv!edB@. W0set "-1xBbe arbitrary4MusxTbobject}Rvc:ref:`_" <@6s>`!Itpn error a zero-db\onbytes90 wa%,Od*Y( to``numberw"Awere9tUo7{   If this) returns a false value (including None), the transport  will close itself. If itX3truW,+U5theDV is up tomprotocol.)""" class DatagramP&T(Base !):4"""Interface for d5 \S__slots__ = () @5def3_received(,c, addrmE"""Called when some)D.wc\error`?excYa send or R operation raises an OSEZ.(Other than BlockingIO&M-arupted!.):{Subprocessp}tsDf callsPpipe_ *"fd/qawrites into stdout/stderr i4 fdint file descriptor% byXfobject;D]p_connecS_lostR associatq1ith7Pchild5 isd%Qt was/ed S_exitBhas 4 R_feedto_buffered_9( w_len = len(!wh0ata Pbuf =cto.getb9)=)Y6bufif not buf"\7{ RuntimeB'('h) edPemptyHCfer'qE if]1 >= iPbuf[:"] 'F..C@_upd$+>Oelsenm$[:9Lw*D*[!):]L"r) __all'Queue', 'PriorityELifo  @Full+ E{t imR coll#s Theapq warnings from . %keventsWsp`(Excep!@"""R-*nowait()SVed on3)VH;pasnm n the Queue.4put_nowait() method is called on a full Queue.""" pass class :`"""A q+, useful for coordinating producer and consume#routines. KIf maxsizeless than or equal to zero, thet .infinite. If itPis an integer greaterS0D@n "a put()" will block whengI reachesq, untilc0temremoved by get()`UnlikeN standard librarye , you can reliably know thil!'s`with q(), since@r gle-threaded asyncio application won't beJPrruptaetweena do2perHo.M) `def ____(self,3=0, *, loop=None)C_!ifFE ._7 = events.get_ !(){-Oelse?F,0warnings. R("Theargumentpdepreca(pPython 3.8, K"`schedu]%eal in FY10.", KDBionW,Kcklevel=2+G=zaUp# Futuru4getters = collec/ws.deque^?/pu?kushed_taskt0#!0 = 0s.E(= 0 .sy M() `# Thesree are overridable1sub)OJ"._-FI 0?preturn F.popleft($g, item@9qappend("aEnd ofscwakeup_next&7ersn# Wake upQ+ % (if any)j>qPcance`,vSwhile4sI=:cif not%g.done(&M_result(a@(Rbreak,b_repr_Wf'<{type ).__name__} at {idb:#x} {format()}>'e/std S @_get__(cls, type):  return cls def _format(self):result = f'maxsize={##._E!r}'.if getattrH, '_queue', NoneX\+] )R={lis.)a~vgettersQ#Q[{len#._9)}]S/puS#SSunfinished_task  \ 8cqe """Number of items in the E."""X,#)b@property//rallowedzXwi_emptygRvTrue ifA is 4, False otherwiseBnot ywOfullvsre are fUTNote:Q0 waitialized withM@=0 (default),~IQthen )`never .##ifL<= 0;3DOelse'3sJ) >=^`async "pu, aPut anV into.G%+ I, wait until a free@slot3available befoQddingERwhilee( loop.create_future()0C_6s.append( ):try>a/ Wnexcept1+.cancel() # JustRcase done yet ur# Clean!b from u#edesVA oremove- ValueError'E# Thcould be \d wY by aPF# previous1_noOcallMpassI0if ^sDA andcompleteF@Used* consumers. For each@() u(to fetch aS,a subsequenll to task_done() tells the queue thatprocessing !ontask is complete. "If a join()"&urrently blocking, it will resume when all items haveNSbeen ed (meaning a _done() cCwas received for everyOb<Bhad ] ut1nto)Raises ValueError ifled more time?asre wereplaced ing.5""" if self._unfinished_us <= 0:(r ('*ed too many%')BgE-= 1$=Pb.set()async def))@"""Bg untiliP@gott0&ndThe count of E*s goes ups1 an1add0&. VBGdownD@ conrsl%toLwindicata@trie1and`work ohW5Mdrops to zero,}A) uns>Sawait class PriorityQY("""A sub(1of B; re @s en 0s iG order (lowest firstE/a0ypiy tuples ,form: (p number, data)`_init(, maxsize!._"R = []8$pu7, heappush= q.MnV*#emFX$geX0(opQ'opPbreturny(opV3) ALifow6Amostj<.JA~.append(l.6=!pop() __all__ = 'run', from . import coroutines\event@s run(main, *, debug=NonI"""Execug ,#ltThis function rune passed@, tar c!ofmanaging the as.yncio event loop and finalizing asynchronous generators. This function cannot be called when anotherN piW@runnpin the same threadgIf debug is True,(@willxcrun in-CmodeA always creates a newcloses it atn1nd.It shouldq`used aDmain entry point foprograms,c?Mideally onlyP94oncExample:qP def t1():J0awaio.sleep(1)#print('hello')Yrio.run([81"""@"if&ss._get__; ()FNoneraise RuntimeError(K"t)Bsfrom a k"0if vcoroutines.is  CValu5"a - was expected, got {!r}".formatLv" =as.new_ 6tryXs.set)Fb i I"0D (@areturn_t@l_co>"tel i_cancel_all_tasks({k$hshutdown_ogens()?!default_executorF iKP() M#to1 = .-<kD+.>T"oclass \(."vx4"""q loop. "2See%s.8API specification@p_init__4%f,=6}+super()._/)|QI:!gs.Default(/.debug('UsCV: %s'1.__W__.__name__HUself.6j"@make'gf_pipe3 = .WeakValueDicZCary(VT;_AdQock, col, waiterrE, *,Sextra.Cserv;)tD_\Th 'sl WP, raw sslcontext >*sa_side=)@host 8 7 2`handshtimeout=_HANDSHAKE_TIMEOUTz@q8P(N7y  4v . ssl_handshake_timeout=ssl_3) _SelectorSocketTransport(self, rawsock, Gprotocol,>Eaextra=, server={ireturnZt._app_t i`def _mdatagram"address=None, waiter  !):.D 0]!, )Qclose0if .is_running(Yraise RunError("Cannot R3 a : event loop"b0da*_+_ f_pipe(Psuper()."h5@ is W.( J#0 = FL S9._remove_readerz0._s.fileno()4elf N:cU77internal_fds -= 10^ 1# A8-yet, really. :-7.Gpairk setblock\False^Q.' +=n?add P_from=f\_process_g , 8Gpasse P3-while True:tryi! ==recv(40965*!if5K!Ubreak-H eexcept Ibarupted;mcontinuel>B/IO=;write_to O# This may be called  a differ th, possibly afterc-# ) has beenU!or  Wit isA.. Guard fora beingp2 ordd. WhenF"a =dQnd() As OS6 (with errno set toGEBADF, but let's not rely on the exact error code). csock = self._1if  is None:=ureturn :try!<.send(b'\0')+except OSE 6#ifZdebugwqlogger.("Fail to write a null byte into"w? "`-pipe Oet",1 exc_info=True)def _start_serving(W, protocol_factory,ebsslcontext=q , N#er backlog=100B $_handshake_timeout=constants.SSL_HANDSHAKE_TIMEOUT)g._add_reader(.fileno()( ac_connection  Vcrver, N>ssl (# This methodz only called once for each event loop tick where# listeningyet has triEed an EVENT_READ. TBmay be multipleN`s waitXBan .y() so itAin av# See https://bugs.python.org/issue27906more detailsCw_ in range(: `, addr5ock' $ `%r got0ew j  from %r: %ra Ul,H> ^.setblocksZFalse(j#(B$!IOs, InterruptedCDAbor Qx# Early exit becausvb p bufferVemptyDAZ yv as exc;)ere's no o nn@ jus%Ng it if]`.errnoM( .EMFILE,FQno.EN =fNOBUFS>OOMEMH?# Some platforms (e.g. Linux keep repori_FD as # ready, so we remove th ad handler temporarily.  # We'll try again in a while2self.call_exception_o/({dw'message': 'socket.ac? () out of system resource',Mzo': exc*lP': tr .TransportS()@/})_qq_readerF.fileno()77later(constants.ACCEPT_RETRY_DELAYGstart_serving9protocol_factory, , sslcontext, Q/erPqbacklogA shake_timeout_else:\&raise # The event loop will catch, log and ignore it]extra = {'peernam]addr}2 = `p_connec-2(3U3!, z\?sslCcreate_task(!) async def _I/, T%T=None* *=SSL_HANDSHAKE_TIMEOUT)0 = j\ty>B (dwaiterYkfuture*'if( os\0._m A/ 2=_side=Truez=berver=&B{=sV x_ U+tr'ab )erRkd BaseE\.clos4a Z# It's now up to{l!. except (SystemExit, KeyboardInterrupt): Uraise0excBQBaseE ion as exc7if self._debug^context = {]'message';# Error on transport creatfor incoming connec/',nPion':&}8if protocol is not None$['3E'] =@\]4^ _Ucall__handler(!) 6def _ensure_fd_no_V(FG, fd1fileno = fd?!ifisinstance(&L, inm>try@/ =0<.5())gk (Attribute"T, Typ BValu <# This code matchesectors._uobj_to_fd funS.G3 j(f"Invalid C object: {fd!r}") from=K w =&f. s[V5no]>1Key SFpass*+lsp.is_closing(3bRuntimX(] f'File descriptor;wused by'D{H!r}'add_reader , back, *argsq._check6ed(K  = events.H(NM,,; 5key1selK.get_key(fd: @register(fdVs.EVENT_READ( rmask, (a, writer) = key.&, Idata Pmodif , T |F"2if `$ .clrreturn  lremoveiX5W ~Z7FalV6Dlalse else: mask, (reader, writer) = key.events, Mdata: &= ~selectors.EVENT_READ*pif not k }dself._D.unregister(fd)G@modify(fd,pu, (None)) S2if 1 is-$.cancel(return True_.RFalsedef _add_( , callback, *args)$._check_closedhandle = !.H(NM , D , 6tryeQkey =+`get_keh:except KeyErrorFk@ AiWRITE,J)8 b |#w #if 4g[hlremovekZA"""R$$ a9E.""" ifEf.is `Dl### Dbothand conn.j + k _# *"""Add aensure_fd_no_transport)dc c& +b (fd) def add_writer(self, fd, callback, *args): """Add a 4*U.."""&J ._ensure_fd_no_transport(fd))~ /def remove R$"rreturn `async sock_recvL<, nceive data from the +2et.mRThe r~value is a bytes object representingES!re`!d.Kmaximum amount ofdto be 3q at onclspecified byJnZT_check_ssl_(#ifGdebug and.gettimeout() != 0npraise VvError("/P mustnon-blocking"s;tryMQ.n-except (BH!IOp, InterruptedEpass!Rfut =create_future(h fd"ock.filenog8`handleHPelf._Apreader(AGa, fut,m.:Tdone_(functools.partial._r_=5=)rtPawait/ G\LJW=Nones2if s or not.cancelled(5-)F6H$# cv() canE0 ita as an I/O1 ifoperation3%'th#G immediately. Don't use it directly&() if^.J r 8=W6t # try again next uSystemExit, Keyboardx  BQBaseEbfas excfut.set_svion(excOelse1presult(%/S_into47bufB"""Ry ,!iso@ten f *buf* (able buffer >8number of bytes written. 5""" _check_ssl_socket() if self._debug and !.gettimeout() != 0:3fraise ValueError("the: et must be non-blocking"s;tryMQeturn>.recv_into(buf4except (BO!IOw, Interrupted)[EpassRfut =create_future(h fd"ock.fileno' ensure_fd_no_transport(fdD`handleHYadd_reader(fd,_a, fut,), @fut.Adone_callback(functools.partial(y_= , }=)rPawait bKdef \ t#1) can add it as an I/O @ if ?operation~#='M immediately. Don't use it directly,VAV)' if.Y(7F `nbytes+3} # try again next SystemExit, Keyboard  BQBaseE_0ion6excBset_svion(exc=Oelse1rresult(.)U`async [bsendalGdata"""Send 1 to+<2et.STconnected5ta remot. This method continue+0to tBfrom until either allhas been3ft or ae occurs. None is ed on success. On ., l& ivd drL`no waydetermine how much,`vany, waLwfully proPed byZ receiving zoQ/ioln(SeT0if n == lena #9EsentK() fd = sock.fileno() self._ensure_fd_no_transport(fd)# use a trick with a list in cloA to stor(mutable stateo`handlexadd_writer(fd, _sendall, fut,,Ememoryview(data), [n]@fut.sdone_callback(Xfunctools.partial(_> , =)hreturn await cXdef _[ q, pos):3 ifC.v(# Future cancellation  be scheduled on previous loop q,eNpstart =5[0]6try7n\([;:yexcept (BlockingIOError, Interrupted GSystemExit, KeyboardJ C6aisBQBaseE1jas exc+Bset_1vion(excR += n$ ifHQ= len jresult(NonehJelse`pos[0]tj`async `_sconnect_, addresXB"""C)a remotekTet at3.d This method is a coroutine.5""" _check_ssl0et(debug and.gettimeout() != 0ra Value5E("th@mustSnon-bo&")if not hasattret, 'AF_UNIX') or`family3et.# `esolveb0Rr eL", g=d. r, proto ,=[>F5_, R4 = v fuC.create_f= _DDt  f@y q'\Kk# Issue #23618: When X!C )ur) fails`EINTR,+## .9@runs(pground. We have}(PuntilG~+etNbecomes Y"totified wwon succeed o7r # fails.self._ensure_fd_no_transport(fd)-handle = 6add_writer('t3fd,&sock_connect_cb, fut, , addressf@fut.[done_callbackbunctools.partial(Z_B , =)pexcept (SystemExit, KeyboardInterrupt):UraiseBQBaseEMion as exc7Bset_1wion(exc?lse1result(None) x[def _a=6X2if @ is s or not.cancelled(\bremove]r   obreturnO6try80errpock.get @opt(et.SOL_SOCKETif_ERRORqF0if IJ!= 0_# Jump to any*clause belowJ3 OSError(err, f'C Ced {&}' (BlockingIOG%, !ed #M etstill registered, thezE wbe retried late%Apass`async $0_ac?A"""A3 a Fion.x4The^must be bound` and lsning forNqNr` valuea pair (a whereF%3newobject usableAsendreceive data onAion,$N!is'@6$etJ`other l!of41ect:75"""[_check_ssle#if+Qdebugrtimeout() mVI'("Snon-bQ"s0fut?create_future(#CX%Pawait:| :L fdgfileno h#7 conn.setblocking(False) except (B IOError, Interrupted%):4;self._ensure_fd_no_transport(fda-handle = 6add_reader(fd,psock_acp, fut,  H@fut.=done_callback(ofunctools.partial(xQy_A , }=)oSystemExit, Keyboard UraiseBQBaseEeion as excKBset_1wion(exc?lse1 result((conn, address)) async def _sendfile_native",  , , offset, count3del0Rorts[ !._Q1fd]qz!medSing =e4.is(FEpaus3TawaitA_make_empty_'er*:try!rreturn B(z, f=\kfinall|!rer:if O #L '$82process_events1 H_lis for key, mask in & gbobj, (, writer) =A. key.data"ifa&ectors.EVENT_READ and W is not Non6 Ty._cancelled&7Rremovfileobj)eG EQWRITE/'4( MNstop_servz*._n7no(close() class _SelT._FlowControlMixin7L"):pmax_siz256 * 1024 # Buffer passed to recv().<!_b$0_fay = bytearrayBConstructs inip value `AO# Attribute upin the deGor: it must be s*et even if the constructor # is not called (see _Sele#SslTransport which may start by raising anMexception)_sock = None  def __init__(self, loop, *, protocol, extra=9, server !):Gsuper().O3P&Qelf._ ['eet'] = tr .pSocket(=6trypNAnameP9@.get(F OSErrorQif 'peerZ'0in ? U L 9&Net.e%[^ 'K! =3_fd.fileno()<h'_connecte2ZFalsePDset_,( N_th Cq_bufferJ0_fa y+_lost = 0_ Se:!ena0 to2ion(scheduled.y1clo]!= Malose()U:#if #&._attach4._t#s[0`ock_fdCreprsinfo = ?_class__.__5__]2!is3 L.append('7ed'elC?ing> 7ing?]`f'fd={.G_fd}+d# testQ$P was {.edPjA andfB.is_?(A@pollf0= _z#_s_tF!._C,A 0_fdns.EVENT_READhL3if d5nfoSread=+B(Oelse>Widle'<R SK9<_WRITE=state = ''|34* bufsize = self.get_write_buffer_G() info.append(f'.=<{state}, buf4#={ 6}>'?return '<{}>'.format(' '.join(Y1)) mdef abort(!):._force_close(None6set_protocol=$,  G% =$ i"_connected = True4'qg%;!is?ing9 6ing8e3"ifS48 H4ing(loop._remove_readers._sock_fdcif not: ~RD_lost += 1sZs 5call_soonpaectionv+, +q__del__3, _warn=Pings. ^1 isP EP(f"un\ed transport {!r}", ResourceWarning, ="Vt.Q(_fatal_erro', exc, message='F  6 on'# Should be 5ped fromJ ep; handler only.if isinstance(x0OSE]9P-kdebug('+rlogger. "%r: %s",W_+=.JelseN!._wB_exc_%({'=$':G,$I ':(""':E". O}9exc-,h 1 $/k.clear'~E E:ingS !t 1 N@_ 5\l*6try z% )-*.qk~finally:  self._sock.close()  = Noneprotocol"Oloopdrver =e bAif sq is not:#$._detach!KF def get_write_buffer_size()kreturn len.,%) G_add_reader#, fd, callback, *argsRy6inglp^ ._J.ic class _SelectorSocketTransport("):k _start_tls_compatible = Tru_sendfile constants._S!Mode.TRY_NATIVE`p__init__& , $, L, waiter=t,cRextra! (1Ly_cbsuper().m,h aeof = Fals {opausedbempty_`# Disaythe Nagle algorithm -- small s will b~# sent withoutIing for O TCP ACK. This generally~decreases1latency (in some csignificantly.base_eve set_nodelayk5+x.*D_sooa .connection_made&lfqq# only  [when 9() has beUalledD_!if/erqwake up, futures._result_unless_cance \,U 1isi94ce(0+1s.B3edPd=~d _Jelser 71 _data_receivedM !is1ingvB7and.yl&T e or self._pauseGd: ereturnself._paused = Trueloop._remove_reader(6sock_fd)12if 4get_debug()rlogger.A"%r  s ]Qing",F!) Xdef resum}1ing~Svclosing or notE  LFals?adda!y/y I G_cb(I0y__CbuffRonn_lost@[:try!Tbuf =rotocol.p&-1'A!ifwlen(bufraise RuntimeError('P") ed an empty 'iexcept (SystemExit, KeyboardInterrupt|xBQBaseEMion as excqfatal_eDpexc, 'F# #?: p*) call failed.D( enbytes.recv_intok(BlockingIOg%, !ed " PGebTY@ on et transportI ?^Hvon_eof(i#_updated(zSWj$h  M?y__data_received  ]f.max_sizek exc, 'Fatal read error on socket transport') ureturn if not data:0`self._\y__on_eof(P ?tryHprotocol.i_received(Pexcept (SystemExit, KeyboardInterrupt)_UraiseBQBaseEMion as exc7afatal_;(Dpexc, 'F#^/: ) call failed.')^Adef ;@{0if ._loop.get_debug(#rlogger.D"%r Da EOF",Dy/ keep_open =,%._6eof  !# We're ing the connectTJ so 9#$ can write more, but we still+'t:/so removed !erYback.;@_4s2er(7_fd:lse)cclose(FE,"8isinstance, (bytes, array, memoryview)A` TypeE0(f' argument must be aOs-like object, 'O f'B{typ).__name__!r}:eofcRuntim@'CanWr) after ^mpty_wai,!ist;Nonsunable toc; sendfile is inpZgressvL _Z_lost0 0 >=ts.LOG_THRESHOLD_FOR_CONNLOST_WRITESOwarning('0et.1() d ephM6 Y += 1 8jbuffer# OptimizapP: trylJ nowi VR{o&(BlockingIO%, !ed #<Ipassexcept (System Exit, KeyboardInterrupt): Yraiseexcept BaseE ion as exc? self._fatal_error(exc, 'Fq write  on socket transport')yireturnNelseypdata = I[n:]2Iaif not =!j# Not all wasten; registere handler.sloop._add_"r(R_fd, _ready) F# Add it to the bufff<pextend(D"maybe_pause_protocol(hBdef cassertk@, 'DkashouldTbe empty'#if5conn_lostu m:try 3n =A, .s(BlockingIOEw%, !edEpasslEoSystem- )B%bremove 5.clear(!w3@_wai!is?Non}0R.set_0ion 3del:[:nwXresum # May appendFF zohK 7p O0lt(M0k~closing&ZPcall_RectioW%elY?eofU hutdown(et.SHUT_WRoeof = Tru:/.s2can_W[iu,>super()._26exc(   self._empty_waiter.set_exception( `ConnecvError(" is closed by peer")) Bdef _make_lq(self):"g0if .%Vnot None+/raise RuntimeE :already set")if={loop.create_future(80if ?jbufferPpresult(Mcreturnw33!re 4r! =, class _SelectorDatagramTransport("):~_0_fa:py = colGions.deque)q_init__ , C , sock, protocol, address=,a extra super()._nh<f }$ = K.call_soon$._%.ca_made,c# only start oing when 9() has be_alled@add_V/er7<x2_fd.:y'if" wake up the3 d]0s._!_unless_cance \8,mget_writeAsizeRum(len(data) for T, _ i`SyVZ_lost[v:try } .recvfrompP.max_ (BlockingIO, InterruptedBEpassE!OS*z as exce_received(excSystemExit, Keyboard  TBaseEafatal_@, 'F 1 on $ t '+lsh >"asendto,r" S`isinst, (bytes, array, memoryview)4C Typ f' argument must be aOs-like object, '  f'not {type(data).__name__!r}') ;0if )#:ureturn if self._address.0if Lin (None,1)2daise ValueError(nf'Invalidc{ must be gY or {E=conn_lost and.  2>= constants.LOG_THRESHOLD_FOR_CONNLOST_WRITESOlogger.warning('socket.send() r(d exception.>I+= 1K8jbuffer# Attempt to  it right away first.d:tryD+extra['peer.'],0"Oelse@!to,:HSd (BlockingIO, InterruptedAloop&_writer(4_fdTto_ready!OSg0 asVprotocol.e@_received(excVSystemExit, Keyboard TBaseE afatal_pexc, 'F' M -@ on gram transport# Ensure that w"e  is immutableg#@.appa(bytesZ)[m1maybe_pause_"()uXdef _"eSwhilez x '.popleft(J(4)) # Try again later1Ubreak:koardInterrup[t): Yraiseexcept BaseE ion as exc?self._fatal_error(Lmpexc, 'F'q write - on datagram transport')Dureturn w!maybe_resume_protocol() # May append to buffer.?rif not F loop._remove_"r(zsock_fd#ifRzclosingS =call_connection_lost(None) imR collswarnings tryY,Cssl I>E:pragma: no cover`ssl = o from . JconstantsZ 4logLlogger def _create_1text(server_side, hostnameV&La Value1('SM M SSL needs a valid0Conv"')I# Client2may pass ssl=True9use a default?2# cF; in that case the:JQed isjzT# TheMsecure for cs4Python 3.4+: up-to-date strong sett34ssl=.~| c|gNt.check_#c = Fal<n{ # States of an _SSLPipe. _UNWRAPPED = " " _DO_HANDSHAKE7" _6 " _SHUTDOWN0 `" clvd(objecP"""An """.pipe allows youcommunicu@withSSL/TLS ! i?cNthrough memory@s. I0@n be`implem!a ity layer!anx@exis9a wheredon't have accessQb's fildescriptor, ogsome reasonR@wantKx/it'!ca`in "wrqd" and "unmode. In  , {4ed 7!un-aformed=O;lYlevelMpencryptPoqrecord *rvice versa.5*N.!isclowestBeZ su@is wqtravelsL`as-is NGwireN sl initiallyS1". To start{ , I^do_handshake()'hutdown SSL again, call unwrap(). """ max_size = 256 * 1024 # Buffer passed to read()<def __init__(self, context, server_side hostname=None):SThe *F* argument specifies the ssl.SSLCmBuse.EI indicates whether this is a 5 or1cliide transportnoptional *w{can be uJyk6 you areP necting to. You may onlyAis parameter ifO,_ssl module sup1s Sr Name Iion (SNI!G%#._ =k B=P(, 00tat_UNWRAPPED!Pincom&=MemoryBIO())_outgo)sslobj =  E@needXdata = False#handshake_cbEshutdown!D@propertydvc 7.4SSL constructor.rreturn ]=|ssl_objectPinterO- instancRwP0 ifP pipe|@not 2pedsWmore record level 0is Acomplete a @thatcurrently in progressp^< ~curity lay)s Xeffec@ dur ~4= _5do_J , |ObackQStart9Za list of4. A A ele"(bs`)Ell a P@willJ edLn? . +  <LD1ithm successful, else an exceg],if self._state != _UNWRAPPED: )raise RuntimeError('handshake in progress or completed')Eself._sslobj = context.wrap_bio(/{$incoming,4Poutgo ,rver_side=8%se,+{hostnam/ tate = _DO_HANDSHAKEWr_cb = callback&sldata, app @feed(b'', only_OV=Trueassert len(Ie) == 0hreturn so def shutdown(,f=None)"""Start the SSL8 sequence.TRla list ofv4. A element is (vbuffersJThe optional *=a* argu? can be used to install aQ that@will0Jqed when . ~* ;KCeithout%s."5""" #ifs4=U no security layer presentLbSHUTDOWN\^#"._Sin (_,14= _ ",w  []Eb'']1eof end a potentially "ragged" EOFThis methodE anH_ERROR_EOF exce1 if%isunexpectedcMp.write_m2KQ4i8 ,  KFalsb@Feed record level>Q into8pipk2The!@mustra bytes ! Ie OK srn empty*<2 Z5getefor a  initiated byOtendpoint(%r) tuplex(d0 3aaining?p` needs0be 0 QremotL#element is a" list of buffers containing plaintext data that needs to be forwardedthe application. TCm4mayfOan emptyA indAng an SSL "close_notify" alert]"is F musbe acknowledged by callshutdown().5""" if self._state == _UNWRAPPED:&# If unwrapped, pass5straight throughtB!if[ W1app10= []xOelse3 /return ([],P%) Q@_ssl = False#8incoming.write(?\Q[:tryDO_HANDSHAKE-2%# Call do_handshake() until it doesn't raise anymoreFzsslobj.L(,&# _# '>_cbR(o(None)TFonlyPn4# H6 done: execute f block;A. q# Main *a: readQ from while Trutchunk =k(max_sizS=.1nd(L}*qif not "_: # 2Kbrea@/elBSHUTDOWNC+(-`obj =  $% ){ G_cb(NB/z0 DrtpossibleYafter \)Bexcept (ssl.SSLError, `Certife) as exc exc_errno = getattr(exc, '!',p ifH7Min (*SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE,  .SYSCALL):,if self._state == _DO_HANDSHAKE and!handshake_cbHI(](exc)tYraise:need_ssldata = =`_errno %) I # Check for record level PPthat bs to be sent back.BqHappensDthe initial renegotiations@Moutgoing.pending0.l"d(3fread()6return (6P, appPdef f9O,, offset=0"""Feed plaintext+` into Vpipe.UR~aV) tuple. TheP elemXis a list of_buffers containingJremote SSL instanc1 isnumber of@byte%atN were processed, which may'1les/nR`lengthR(NOTE: In case short writes, this call MUSTXretried with[ESAME+0 pa*va* argugQ(i.e.>id() must\&th_Psame) ispan Open:arequir . A further particularity3:'a  will always havq0, becausef moduldoes not enablez#al5. And evez2oug&Fzeroe stbe encrypted6"""ssert 0 <=9 @len(v3UNWRAPPED#A thrG in unwrdC%if{ z U' @ = [U[5:]]&Oelse< / ikTz>view = memory 2while Truk = Fal>try *w3 +=qsslobj.(8@<`except5yError as exc@# It-pallowedhis) after() until y# close_notify is acknowledged. We return the condition to+  # caller as a short write.+ exc_errno = getattr(exc, '', None)8if exc.reason == 'PROTOCOL_IS_SHUTDOWN':9uFk = ssl.SSL_ERROR_WANT_READD}not in (=,> >_WRITE?"SYSCALL)]raiseself._need_ssldata = =)) M# See ifre's any record level ]back for us2if outgoing.pending0.ap#(7jread();if offset3len(view) ortpUbreak,Z) class _SSLProtocolTransport(t s._FlowControlMixin :O"):~_sendfile_compatible =stants._S!Mode.FALLBACK=def __init__Fp, loop,#_pNi#! =*'# 0 in}cm95sslVvI*closed = Falseget_extra_infoname, default=7"""Get op5al L B0rmaE."""+._ yS5setM a:6app>8 ^WM0is_l?ingK $&ed7 2@"""Ch.6Buffered will be flushed asynchronously. No more.6`receiv@ AftsN a$is\,C= 's'0nec_lost() method g(eventually)dEAwithits argumentUN7?Tru ._start_shutdown(]U__del`_warn=Pings. 0if }_warn(f"unclosed transport {self!r}", ResourceWarning, ="7) .close() def is_reading(!!):7Ptr = ._ssl_protocol._+if tr is NoneBFraise RuntimeError('SSLhas not been initialized yet'return tr._pause@"""P  the receiving end. No data will be paswo6!'s&_F6ed(pmethod vl resum)ucalled.85""" j . gFA"""RD"edonce again  8 ! set_write_buffer_limitsp, high=Q, low 1Set)P- and(r-water JQ for b flow control"These two values# when to f.$`m)9s. If specified,E8low@ mus> less than or equal5the>. Neither1 canegative defaults are implementation-c@onlyz`given,' jUto anFt"@Sett/@zero 0ces%asQwell,cT,s  to5 OpheneverCp becomen-empty. 1to h> 6 q|-j2is aEbUse of`  enerally sub-optimal as itD@redu) opu es>0 doU2I/O(Bompu)<concurrently)!;g;Asize9 $Rd3he  *(L"e R.r8}-.@property _protocol_paused(self): %# Required for sendfile fallback pause_writing/resume logicLpreturn b ._ssl_protocol._transport._Z!d ?@def deg, data"""Write some bytes to the _OThis does not block; it buffers8g and arranges!itEPto bet out asynchronously.'5""" !ifqisinstance(f1, (,oy, memoryview)xraise TypeError(f"Ep: expec! aIts-like k&, G f"got {typ).__name__}")rK@_app>)1canJQe_eofB"""RATrue if t@ supBs)Cq), Fals.Hnot. _abort{QCloseqimmediateB@"ed@will#lost. No morreceived0DThe p's conn0on_H() method B(eventually) bePcalle$th None as its argumento$c@d =  class SSLP($s.e"""SSL.PImpleation ofMp on topa socket using incom outgoingwhich are ssl.MNBIO objects6__init__, loop, app,Kcontext, waiter,?server_side=#, @hostS=:_Pmade=b,Dhandshake_timeoutYh if1 isG0Run<Jq'stdlib4amoduleavailable'?[_m =  ts.SSL_HANDSHAKE_TIMEOUT]/elpO<= 0CValu"G/f"`shoulda positive number?3L5x3ssl?  = _creates(OWj d-# =_side if server_hostname and notwside: lself._7=1I4?elsBENone7gslcontext = s &# SSL-specific extra info. More are set when the handshakn# completes.]Tv= dict(= %) 3 # App data write buffering#V_backlog = collections.deque()2P_size = 0zWaiter = w Cploop =  set_app_protocol( transporS_SSLP9T(l , F!# 2 ipstance (a untilBconn is made@N`._sslpC = ; ssion_established = FalsG5in_#shutdown"%# , ex: SeorSocket 5 Vcall__% Y6sslp_timeou>]def _ , ).1) =, GB_is_E = \)bBisin $, 1s.B$edp|rwakeup_ c= )`"ereturn#if8 .cWlled(]<`if excXI\$B.}PexcepF(exc,B BaresultI@&l2 b3P"""CaElow-level G.ZQStart6SSLzf1"""-& =^ $L2,3[p4 qs(.Q_losto#D or closedyThe argumentan exception object or None (the latter meaning a regular EOF is received>8connection was@Rabort&closed).5""" if self._session_established:&' = False.loop.call_soon(Capp_protocol._lost, exc)JJelse# Most likely an0!epoccurred while in SSL handshake# Just mark Gapp transport as 6 so that its __del__Hdoesn't complainh`aais not T'1#._V= Truk+'! =S { #if getattrE, '_3_timeoutAle',^)d4.cancel(0wakeup_waiter(!&tsslpipedef pause_writingq"""Call&!enlow-level's buffer goes ov.high-waterB[.%) _resum6drains belowcV Tdata_l , rAsome'.The argument#Pa byt_bjectni!is #Wing, 2destroyed7freturn:tryW0sslP, app $ =Vc.feed_&("except (SystemExit, KeyboardInterruptP'aipBQBaseEM ;as ;fatal_error(e, '$1b't for chunk9 Y.!e(4CX H@ H"ifi < GB_is_J5s1s._3_to8"ed(8iz,)  delse:  self._app_protocol.data_received(chunk)@except (SystemExit, KeyboardInterrupt)x_raiseRQBaseE]ion as exFfatal_error(Sex, 'applicatW failed to P SSL 'Oireturnjastart_shutdown(Tabreak Pvdef eof{CC`"""Calwhen the other end oflow-level streamYis half-closed.rI92is s a false value (including None),ftransport_Qwill \0 it. If itX3truW,+U&th V` is up.m5""" :try1if _loop.get_debug(Irlogger. 4"%rqd EOF",H)*3[wakeup_waiter(ConnecX`ResetE 7aif notQ._in_handshakkeep_open =0  !O5if A warning('Jfrom5) 'nA'has no effect  usX7sslMkfinallW.J(E_extra_info(1, name, default=tcame inH?  [T]%elPpO0}bG  V %inz1cw._abort(yf = Truv%PwriteznH(b'' 1,"._)backlog.append((SF, 0)^ .uffer_size += len1 -zprocessc 3X Ws\A$_start_time = self._loop.time() Uelse:,handshake_start_7u = None.*5in_-f = Tru"0# (b'', 1) is a special value in _process_write_backlog() to doj# the SSL k @.append(}-E1outele = \X 8call_later(E1ssl7& Iout,?C?^checkA   h_def _I)#if !is'qmsg = (c)f"taking longer than "8{3} seconds:;Pabortdconnectionf6mfatal_error(C8AO1edEWmsg))Ko_completeI,yG_excXm Uf= Fals#u.cancel(sslobj =sslpipe.?eobjectc:try*if1not *iZraise1peercertD.getGxcept (SystemExit, KeyboardInterrupt6\}eBQBaseE ion as excif isinst7(exc, ssl.Certificate mq'failed on verifykP'F2\ ?  gfreturnget_debug(d # -K wrlogger.\J"%r:v took %.1f ms",V, dt * 1e3# Add extra info t becomes available after.(A.update(x= n cipher=s/()3 ompression8= <k bO_mad0app7ktocol.0._app_transport)  self._wakeup_waiter()   session_established = True)&# In case transport.write() was already called. Don'tCimmediately _process_F _backlog(), but schedule it:A_on_handshake_compleacan beped indirectly fromAv?andw is notH@reen %t.KPloop.b_soon(u!) ;?defx=) Try to make progress on the G G#ifsNone ortsslpiper&breturn:try!for i in range(le)Gdata, offset = 61[0]%.0if 9 0ssl V.feed_app%(*KCelifl d&do(_.5(1TOelsetshutdowfinalizez {Pchunk~>< |0 < SC/J 8? =  <# A short@means that ais blockedk a  LpWe needaenable-ing if itapaused!AcassertNQ_Y6"._f3presume_7ing -Vbreak # An entire t!Wn@# de*areduceIoutstandKbuffer size3del@  o'T_T6 -=q5except (SystemExit, KeyboardInterruptFraisABQBaseEMion as exc&inH #%# Gs will be re-raised i n _on_handshake_complete. _self.-Y(exc)1Yelse:NCfatal_error9@, 'F  on SSL transport') HXdef _;M, exc, message=IEif isinstance0OSE)%0if d._loop.get_debug('+rlogger. "%r: %s",?_info=True0,wcall_exceptiQler({{'$':,$I!'::"3:%._Pprotocol'- "}KM k._force_clos inalize(5._sslpipe = None;#q is not( \abort:tryHtfFfle5) """Sup; for running coroutines in parallel with sta ed rt times.""" __U_ = '&_race', imgcontextlibtyping from . (levents@s as[s_mod+Llock?tasks async % (b_fns: .Iterable[ACall4[],$PAwait&]]UdelayGOal[float'*2B": .AbstractECLoopd, ) ->zaTuple[2AnyRy$inwDList&EiB]] ]h"""Run and take the first to finish.iThis metho+cs an ig6 ofjP funcEs. TPaone isstarted immediately. FOthen on, whenever(p precedZfails (raise Q), orK! ** seconds has passed,cAnextJKC0is inues until !of?6&eNsuccessfully, which case all others are c ll#orb1allG_eus provided should beR well-behaved in the following way: * They should only ``return`` if completed successfully.> always raise an exception ify did notU Z In particular,<handle cancellaX,VLprobably re, like this:Ctry:2 # do work asyncio.Cy|edError=BundoEallydSk?FArgsIcoro_fns:<iterable of utine funcs, i.e. call&es thatg' a>object when:ed. Use ``XQools.zyal`` orPlambdas tss arguments.tdelay: amountPtime,seconds, between st&ngYs. Ifs``None``) will run sequentitPloop:p event 3use&R}tuple *(winner_result, findex,0s)*G&re3- *-<*  !heOT, or Yif no#oniml k7 ina ``o`p{! IIG mauPturn 4 on,* be usedKto definitively determwhether an["roqwions*: lis! rQed by's.f``len(7)`` is equalFK`numberlDP actuLqed, andsPorderOFpsame as!.k 's entryH=1"""p# TODO:Pn we  aV!()anext(), a P!in~!D=K"orYs.get_running_"!()~Penum_@0 = derate(( 2! =8A/Q = [],RtasksR+A_one(E previous_failed: typing.Oal[locks.EGQ]) -># Wait forO ,!sh$! 4if 9(Hmwith contextlib.suppress(exceptions_mod.TimeoutError): # Use asyncio.wait_for() instead of() here, soLthat if we get cancelled at this point, EventnjOs alO@, otherwise e will be a "Task destroyed but it ispending" later."aa tasks previous_failed(), delay)D@# Gee next coroutine to run(:tryq_index,6Q_fn =E`(enum_JF_fnskexcept StopIterationTVreturtq# Start @0runOl{$hi = locks.(_1"op.create(run_one(C)@qrunning0@s.ap(U(assert lenV3A) ==[BE + 2# Prepare plac pu&is2's O@ionsfnot wo<ONone+%1 result = fY (SystemExit, KeyboardInterruptUraisetBQBaseE>ion as e8' [F] = JA.set() # Kicksgh+lss orrnner's  nonlocal wi&,2d0/@ is  ( !J&h# = #1# CB allns. We take c0to a}{currentMSas well. IS`do so,5Pn sinAno `={` afterN'3and1led usually thrown@one,$ IPencouq` a curKner case wj0the;endN upQdone(1VTrue,6fFalse, I0. Ttbehavior(specified i0# https://bugs.python.org/issue30048ufQp, t in e \ghif i !h$("t.""()7Qfirst%hNone)) running_tasks.append(first) try: # Wait for a growing list of G to all finish: poor man's version ofPcurio's TaskGroup or tunursery.done_count = 0gwhile != len(run)., _ = aw. 7f6cG'# If run_"ro raises an unhandled exception, it's probably ap#Pgrammherror, and I wantlysee it.7if __debug__Ad in2#Pif d.!()onot d.cancelled%d.(_E -return winner_result,findex,,s7ifinallMake sure noare leftP if wave this funcUt 8 !t() __all_B(C'StreamReader', HWrit Protocol',<open_conne?start_server') import socket$ys 0wareakref if hasattr(=, 'AF_UNIX'Q+= ('Ounixsfrom . coroutines ]event format_helperp;4logclogger{(sleep _DEFAULT_LIMIT = 2 ** 16 # 64 KiB async def (host=None,  *DCloop(jlimit=, **kwdsp"""A wrrfPcreat2() 5Aa (rp1, wh) pair. VBThe 3ed is a P instS; theG'D++`Pargum rFfusual ?to aC_factory; most common\@posi0al }with various o[al keywordAfoll4AddV6 (to set+ H2use9 6rbuffer `passed21theFp%)u(If youcustomizemand/orJo classes, just copy the code -- re's really nothing special here except som<nvenience.):1"""if loop is None:[= events.get_ _(D7els1warnings. R("TheZargumentcdeprecated since Python 3.8, | "and scheduled for removal inBU10.", CDxBionW, stacklevel=2reader = StreamRq(limit=,=2protocol4P(R 7transport, _ = await[.create_connection(lambda: t, host, Hb**kwdsGwritW(uC=`returnZRder, L async def9rt_server(clientRed_cb=O *%h=_DEFAULT_LIMIT, """Start a socket , call back%Reach  QAed. Qfirst paramet`- `, takes two,s0E3#. |_aZobject, while2B2 .b. Thi can either be a plain!unQ or a coroutine;Aif i, wiRe automatibyN0verainto aDGTask^prest of `s are Wusual!toH^$()_factory; most common]B@posi< @&with various op%vkeywordFfollowingo2e rPvalueqsame as  4AddqE (to set7qPinsta5to use) 0 6rbuffer passed toQF)c, i.e.S z anu@stopAice.def factory():  reader = StreamRq(limit=p, loop=") 4 protocol8P(V, client_connected_cb,EMs xereturn LQawait>.create_server(factory, host, port, **kwds) if hasattr(socket, 'AF_UNIX'): #  Domain S&s are supPed on this platformasync def open_unixion(path=None, *1=_DEFAULT_LIMIT"""Similar to `ion` but works withA."""iO!ifc@ is h = events.get_ _(>Jelse9warnings. R("Thefargumentodeprecated since Python 3.8, "and scheduled for removal inFO10." DBionW, stacklevel=2 T6M Ptransn, _ =  x*ulambda:V , K,Gwrit+W(|", ;P (Rstart)E:4/, 7#4;^$*()1P <;iah  class FlowControlMixin(g$s.I"""Reusable flow conPtrol logic for StreamWriter.drain(). This implements the protocol methods pause_writing(),:Wresum and connection_lost(). IfVsubclass overridesGthese it must call.Cper 7Await__helper() coroutine.m2"""def __init__(self, loop=None):,!if@ is 7 ._7P = ev?Q.get_ %()JOelse?F,Yud = FalseAer = " H'`_tassert not !._.d=f = Tru#if4gdebug(_C@loggA"%r N#s !",F) qS Q%H3if '!isng> m!if?M\.donep&@set_0lt(pd 67excj * # Wake uper if currentlyd^ d1ereturn;! ='.$ _R {j Pb oif exc<. /2Pexcepd(!`async    eaise CResetError(' 'AK3 or6.cancelledk-create_future, <# =\EaQg`close_ #er,slsrMDNotIf!edL2 sReaderP|(FlowConeMixin,$s.%f"""Helper class toJ adapt between Protocol and StreamReader. (This is a helper class instead of making = itself aDd1sub>, because thev has other potentialDQuses,to prevent>quser of to accidentallyF call inappropriate methodsCp!.)12""" _source_traceback = Nonedef __init__(1, sL!_rM, client_connected_cb=@a, loop !):svsuper().T%$*ifd1notJ*).__wr = weakref.ref(f@ 4.#Oelse8/if8&#  created by"`P_servb` function.v# Keep acong reference toI until a ;ionGis establishede3ong) =r3eamN,UrejecFion = False(`_write VKtransport/ = zover_ssl`closedPelf._.future()R@2ert`zf2S &/isareturn GQ_made%, Q  `contex{'message': ('An open% was garbage coll[` prior'MQ'wnetwork/; @ N"*.()" explicitly.'H} Y ,['%']K  lnall_excep_handler(c z.abort(0hd3& =$$%3if (?is  @.set({over_ssl = tr#ansport.get_extra_info('sslcontext') is not None  if self._client_connected_cb1:293stream_writer = SW3(tr,a,@D oreader7Yloop)rQres =(o!l  uif coroutines.is Z(res)SQ.create_task- (rstrong_" =( deyion_lost(4W, excx;#._I2if  ifY \@.feed_eof(&Oelse4sception(closed.done(?exc Appresult( @/exsuper().c M  _w] &# data_received=7 Hc(!) C:eofL over_ssl# Prevent a warning in SSLProtocol. =R"retu6true from 1 @# ha effect when usvAssl"4[V FalsFTrueb_#0_wa o(TFa_del__<4" res about unhandled%s.P# Bet8Ithanq._log_traceback =U hack?dyA and(.cancelled, ) class"""Wraps a T./This exposes 2(), l a[can_]) (). It adds drain() which @returns an optional Future on which you can wait for flow control. It alsoE adds a transport propertyLreferences the T(=directly.A""" def __init__(self,`,atocol, reader, loop):;2&._=> $1proK% =V"# drain() expect!atx0 haKQ exceJ() methodDcassert is None or isinstance(M, StreamR)B$# =J ! = complete_fut = M/R.creaLure(p8.set_result()Creprinfo = [p_class__.__name__, f'"={&U!r}']#ifais notHt.append(f'.\Y  '<{}>'.format(' '.join(N)@U 1Qwrite5g, data; 4.+% @_linesE0JA_eofI0Acan_I 4M2losE,=is_closing1G`async O,edNa=R._get0_"er6 `extra_X , ,pQault=Z I C  """Flush buffer.KThe intended use1to .&2 w([:%"w.s"/ 5exc.qT.#(Praise:.?4# W`connecK_lost() call`7Rx+ @ errkf any,5CZaResetE+otherwise-Yield toQevent so connection_lost() may be &# called. Without this, _drain_helper() would returnB immediately, and code that]s/~write(...); await o+(),in a loopQneverV connecti{, so itBnot see an error when the socket is closed.@vsleep(0elf._protocol.2 class StreamReader: _ _source_traceback = Nonedef __init__(self, limit=_DEFAULT_LIMIT,=8!):WZ# The line length< a security feature;8it also doubles as half&bbufferK.m"ifV <= 0raise ValueEr0('L@ can!be4&')M!._" =Xi!is( k9 = events.get_ _>XOelse?.vY= bytearrayO#eof = False# Whether we're doneX3#er # A fu used by _#_for_datat@xcepD transport!pag<2if Egdebug(a$cformat6@s.ext_stack(fCsys._getframe(1) Crepr~info = ['V%'][ =.append(f'{len_"._-!)}&s'O?eofLO'eof5:!= I!f'3"={a }ZNF "J/!rMeJ %SVV %VVS'!4 '<{}>'.(' '.join(5xyG&sqI=W, excB ; = A# =A `& = None   if not waiter.cancelled(): "$set_exception(exc) +def _wakeup_+W(selfIA"""W read*() funcGsing for data or EOF."""^V0 = X.e!ifEQer isJNone80 = !?a #presult(N 'transport %, cassert!QD, 'TE0 al8ey set'9=f`maybe_5me_-#ifpaused and len'._buffer) <_limitb?u= Falsec .Ging(Afeed_eof~Beof = Tru_ P/atN"""ReturnL if the Qempty '' was ca( rI@^UP,@Reof, 6q after FBeof'Yd% ).extend(6)"Tj.T58K0W'=and%vS> 2 *y+W:tryh.r_m$ NotImplementedErrorXV# Thei can't be a-d.# We'll just have tof1all6aForget so we dotkeep trying@ ;els%9gcasync pit_for_2,W_nameit until2) ()8TIf streams, automati/"y B6 it51# SBReader uses a futurAlink`zprotocoVmetho#a coroutine. Runn;two2s asame timr# would an unexpected behaviour. It'7qpossiblAknowv# which5<next data.  if self._waiter is not None: raise RuntimeError( +f'{func_name}() called while another coroutinel'Dalready ing for incom udata') 7aassertaeof, 'P_for_10 afFEOF':`# WaitTa'@pausill make deadlock, so prevent it.`# Thisessentialexactly(n)case when n >{8limN  = False!transport.resume_Ging(;*fDer =oop.create_future()`:trya>: %er,kfinall0 sfasync def Pline(,)o"""Read chunk of from the stream Pl newC (b'\n')bfound.m'On success, returnZthat ends withK. If only pariacan be due to EOFZaplete /Z5outDqtermina0. W%pEOF wasZ chKqno byted, emptyM`objectre1If taZb, Valu wad. In E, iflbW, com`include+\eemovedKinternal buffer. Else, cleared. LB5 isN against6,$IfNzk0, tBtionautomati"y i: it! ed{s5"""asep = len = len(sep|'= ; :rexcept `ions.INSL as 9< e.JQOverrunO`starts p, e.cond43delg>&[:/ + seplen]G3;elsV"._E.@!@mayb5_M +8(e.args[0]~b 0lf,qarator=R``sep? ``, the data and separator will be removed from the internal buffer (consumed). Returned dataKyincludeCn ate end. b#Configured stream limit is used to check result. L@setsNHmaximal length ofthat can, not countingFIf an EOF occurs and5 completeQPis stUbefound,Tan In4ReadError exceptionCeaised,hJset. Theb.partial attributmay contain 4*ly 2theX0canead becausewBover5, a|OverrunYBSleft g, so iad again.F5""" seplen =4() if#E= 0:ra Value5('SVPshoul at least one-by+vtring')fFlf._ !isONonev)se/K2# Cc wholeb ls, which,%is#@ les]#ans. Let'scorner cases with>F='SEPARATOR'# * we havt0ceiuPalmos N(^1outf T). i.='some texty@'. I!is& w1# QsafelA - 1is?His first0 ,A  ='abcdefghijklmnopqrS'. We  peveryth4 @, bukis require toBqanalyzesHTmatch- @This@slow5/ormFSM. For t%(I ouriQmenta0opt`, sinc"0reso9ingD is known0 loo9 InAreal world,&COGZnoticBperforma problems. Even when readMIME-encodedmessages :# `offset``qanumberEytesp beginnc!ofdwhere there is no occurrence of `separator`. offset = 0 # Loop until we find> in the buffer, exceedg size,Por an EOF has happenedwhile True:6buflen = len(self._u)(# Check ifnow have enough dataI for)toxV# fitc if#- 5>= seplen.@sep .G(,F =0f i@^!= -1\##*is0. `A` will be used laterJ# to retrieve3 (Zbreak~# see upper commenteexplanationPH=ZS+ 1 -T #if22 > _limit Qraisep{0s.L,OverrunError(a$'S(` is nound, and chunkY'B # Complete message (with fullP) may@presR in+f# even whed@flagset. ThisGv&Blast b# adds4which makesPfound\at's whywc*fod#*|* inspectingf #if>eof{= bytesv %dyclear()% )3IncBRead+vm, None_wait_for_4"()tresume readtream was pa aG R'E'}i$   C, bu)Ulonger than /  [: +HElen] de')bmaybe___transportcreturn!async def<v, n=-1)g0"""0 up2`n`HQ froms.@If n'provided, or Vato -1,pNG1allA. Ifn.1receivedinternalempty, return an empty bytes object. If n is zero, retur2 immediately>positive, this function try to read `n`, and mayoless or equal, than requested, but at least one'. If EOF wasNreceived before an s/K 6R(ed valueRnot limited with , configuredestreamX@crea( R%P paus Vwill automaticallJsume it if_uneeded.6"""if self._excepUNone:5(\raise/ Kkn == 06%K b''+<*0# T7/just loop ! ng a new waiter hoping to# collect everyth$#inbbuffer@that wouldAdeadlock if the subprocpsends mI< Dha. So u(8_9p) untilobis = []]while Tru4@ = a$p M50if p ]break81s.append()%LR.join#*s)"ot_#:eof__for_data('Z'^P(work righnp1is rnI>Y" =7F[:n]9delmaybe_re_transport(E.s<async def:qexactlyF, n)@"""R["cQRan Incomplete4PError 7 isi&ch-u can bek_. TheP.partial attribute oJeNqcontainm<bx 2x ,Vxsize can not be less than zero') if self._exception is not None:(/\raise/ Kkn == 06eturn b''+while len(}buffer) < n=*ofincomplete = bytesP 1n.clear()%5s.IgReadError({7, nPfSawait( _for_data('readexactly ,==D ;elsVJ[:n]3del"@wmaybe_resume_transportgrvdef __aiter__).\.casync 4Nnext4gval = vGline1if '=oPStopAlPIteraval __all__ = 'create_subprocess_exec',shell' im 4warnings from . *keventsprotocollstreamDtask4logZlogger PIPE =.z STDOUT DEVNULL class SSP(.FlowControlMixin,p.\VB"""Like s$er#, but for a2"""ic4inib, limit, loopasuper().__- ==!._@" =HPstdinBgstdoutQerr = 6aited = FalseDpipe_fds = []Q_clos?_.PfuturY94?rep@infocD___.__name__z|P.append(f'-!={] F!r}'TZ U6outV?outWW6errW:errWa'<{}>'.format(' '.join()sq`connecQ_madeB, transport):  self._transport = # $ stdout&.get_pipe5(1);.if>is not None:)lm = streams.SReader(limit=)_ ,BF DloopA6oop8Y7.se(8fds.appendfstderr@jD2aD >D?errDl>errD | D)2)/inC0`C =B-inA`Writer Kprotocol=r==; Adef data_received( `, fd, )if fd == 13S/a%el727 7err7s#f(3if  `.feed_(\connection_lost?exc0H%inii %Cv.close(. d0excc! Fq_stdin_fdpresult(4 v,elFPexcep>(VreturE?if ^ e;eofL4n @.1in #  .remove(fdself._maybe_!close_transport() def process_exited(self):"*._${ = True$omaybe_i_"bqaif len._pipe_fds) == 0 and / .%()$v = NoneC_getawaiter, stream2 isZstdinbreturn_ \d class P7__init__x,tocol, loop*5 = $1proC% =N "[! =b 8. $;out%=out&;err&:err&8pid.8pidc__repr+vBf'<{_l__.__name__} bpid}>'@propertyHAcodeb^m5lQasyncrR K"""Wait until the S A."""ajw_Asend_signal",  3:1terminat0 F)>2kil$4XR_feed`WinputHsdebug ="r.write(H_1if 3qqlogger.(,'%r communicate:  e (%s bytes)',,v:tryrIg.drainexcept (BrokenPipeError, ConnectionReset) as excd#() ignores SV 9 = ,u got %r#3excA[W Vm'1oAnoopibzN00reaB7G, fd; 6(fdPif fd$2 stream = self.stderr Uelse:assert fd == 1stream = J5out!"if_loop.get_debug()_name = 'stdout' ifk Eerr'Xrlogger.Q '%r communicate: read %s', , c)@output = await .4(%g_closetransport.)rreturn  async def (, input=None"if is not  Tstdina_feed_(PA: Gnoopp o .__/(1} 8~?err~  ~2~ 8 ~@", -tasks.gather(+,=E v a4outG) h reate_subprocess_shell(cmd1!ins o 2err-r limit=s._DEFAULT_LIMITc**kwds0if [ = events ! warnings. R("TheZargumentcPdepred since Python 3.8 ""and scheduled for removal inAO10."DwBionW*stacklevel=2)Z protocol_factory = lambda: SSP+(s=$, &.0 q=C<Serr, M-P(,? exec(program, *args0IzD stderr=None, loop=None,  limit=streams._DEFAULT_LIMIT, **kwds):H0if Z@ is ]`= events.get_ _!()<Felse1warnings. R("TheZargumentcdeprecated since Python 3.8 "T{ "and scheduled for removal inAO10."DwBionW*stacklevel=2protocol_factory = lambda: SubprocessStP+(r r=transport, = awaitq%.se_exec(/program, *argsastdin=p, stdouW $0err%5err^ureturn P(,) """Suptasks, coroutines 5the r.""" __all__ = 'Task', 'create_I''FIRST_COMPLETED&EXCEPTION8ALL$']@_for as_completedTsleeplQgathe'Qshiel!ensure_future2Erun__threadsafeEscurrent 's!_register#>_un)en#EleavQ) imx3conq.sutextvarfunctooltinspect3Iiter Etype-"+.weakref from . 2bass5  xceptionvU _i # Helper to generate new  names # This uses .count() instead of a "+= 1" opIion because latter #5Bnot  . See bpo-118660a longer explana!. __Mer =1).__next__ def >(xw0B"""Ra)0ly hu \0run=^=_)1setu!lls5h?oop4 # Looping over a WeakSet (s) isn't a#0 caP updaA0ano? # thread while we do so. Thereforcast it to list priorfiltering1s # 3 self requires iteration, somQrepea[several tim)0gnoWM0RunErrors (which are not very likelyoccur). See issues 34970 and 36607 forYdetails.Qi = 0  QTrue:6try aasks =p(_all_t)2xexcept Bei += 10Uif i >= 1000-Uraise07els Qbreak return {ta t in + if futures._get_loop(t) is 2bt.done()} def _compat(/b=None)# Different from " r()" by ing *all* T;, including`# the cleted ones. Used`implemcpdepreca$"J.oKcmethodf0is  = events. `# Loopover a WeakSet  isn't safe a can be upddanotheothread } l1setY`_name( , j!if  M=! =.$Attributes #Fpass0 S(h) class(n1PyFy ):,Inherit Python+ 0p#gaD_ F!. H"""A coroutine wrapped#"a 8B.""",@# AnFPortanG@vari maintainea.4#q`# - Ei _fut_wa ,ha_step(|scheduled;>,or:Csome Ae*not* GThe only transition from the latter to"former is through # _wakeup(). When _fut_wai<is not None, one of its callbacksEwmust beM If False, don't log a message if@taskdestroyed whereasmI`status&still pendingS_log_=_r = Truedef __init__(self, coro, *, loop=Aname !):X"super().?0)$0if U._source_trace GK?del(H[-1]Nuutines.is ( X# raise affFuture), attrs are required for __del__yLaprevenAging*Tn: hTypeError(f"a was expected, got {R!r}")0if  m = f'Task-{__`_count%}'OelseF@str(<f_cancel =T"T=O ! = Qntext vars.copy_co(.Q_soonp.__step5=C_register+;_D2*tate == fs._PENDING and"JE = { '!':K,X1': Hed but it/*!'D}R ,['A'] = lexception_handler(c  class_getitem__(cls, type;return clsSrepr_info.Abase!s._1K@get_I! 3a3 !31set3h, valuf32tr(! @cresultB '\cRuntim]2doesupport ?` opera' or&Bion operation') def get_stack(self, *, limit=None):(,"""Return the list of : frames for this task's coroutine.oG!If@ is not done,>rgs(`where it issuspended. U ha~ mpleted successfully or waGcancelled}an emptycEpterminal0by ;xceptionV;tracebackG-4The\are always ordered from oldest to newest>o"alR giveYmaximum number~5 to@; by*ault all availabl,t_meaning differs deon whether aGo ^:%ofA%+P, but/+7m;P. (TRmatch1Fqbehavio3Csmodule.\For reasons beyond our control, on#neZ%a Zh5"""` base_!s._ Oprino, fileP8l nproduces output similar1thaoq,retrieved@). Y argumentEis passedx65an I/O streamFto whichis writtenS Esys.stderr.?msgARequc :0 it7 vis arrang4a Ce0Erro be thrown into&vwrapped" otnext cycl<"ug^event loop#cPthen @a chclean upCU denyir usQtry/e/finallyUnlike Future.2doeguaranteaP will>2ledtion might"u 5and ac} uprPdelayJation of the task or preventing .cancellation completely. The task may also return a value orFraise a different excepU%. &pImmedia` after this method is called, Task.ed() willG4notTrue (unless twas already FU). ADV be marked aqed whenRwrapped coroutineDerminates with a CMvedError (x3 if%()E%).5""" self._log_traceback = Fals1if 'udone():<1_fut_wai0is JNoneB^-(msg=msgswr# Leave:A; itVb4Y that@catches and ignore@so wVy havBC# toxxagain laterm()W# It must+dAcaseP_steptscheduleda_F_9 = f!_message = msQdef _~(?,q=s.InvalidState(h"f'q%):c[0: {!r}, {exc!r}' `y`isinstFA(excF*s.\Sexc =CmakeiPled_eu3. RR  <8 = wp_enter_f1op,# Call eithera`.throw)u`.send(_=try@!is a# We u0e `S`xdirectly, beca$wsDq# don'tj@ `__61__`p`__nexts<result = i;els;); StopIter as p#led righAfore_ stop"  cxsuper()N=v 65"KAset_it(exc.value)# rexcept ions.CancelledError as:18# Save the original%eption so we can chain it later.Dtself._cm`_exc =F &ruper().(() # I.e., FutureN)a (KeyboardInterrupt, SystemExit)sr0setY(exc)UraisepQBaseEQ:^Jelseoblocking = getattr(result, '_asyncio_f_,z', None4if q is not% nsYieldedg must come from.__iter__({?2if s._get_loop)}.D0new = Runtime(w$f'Task {Xs!r} got/ '5{N2 attached to a different 'Mym.call_soon.s_step, , context=o'el32if dO'~ ^4b0can=pawait okz+B)/23$AR/.Ig = Fal8@add_done_Oback:_wakeup:>@fut_Cer =2if 5wd2gnf84msg_message)w ? 0f'y was used instead of H Iin tVwith ^bA> elif result is None: 0# Bare yield relinquishes control for one event loop iteration.P`self._&.call_soon(a_step,XBext=fIext)Ielif inspect.isgenpor(result)Yeing a 0 is just wrong.dnew_exc = RuntimeError((,"f'$was usedstead of>Afrom.'An task {!r} with {J!r}'* Yi*nws"[`somethe@else^@an e4\0f'Trgot bad::jzfinallyTp_leave_ , \ ! =^ # Needed to break cycles when -@xcep: occurs. def __wakeupp, future+tr".5(eda BaseE ion as exc # This may also be a cancell!._XG(excql8# Don't pass the value+`` explicitly, #!`F0.__t__` and Pawaitdp net# If we " `,()` ,)`Python evalPwould  `.send(T0)` $!odo E4ins4`__next__()`, whichQaslowerG*sthat return non-UAors utheir `: *A _Py = 5 import _asyncio Iy4 `@# _CK!edRtests='=b.0 ]Screatcoro, *, name=f"""ScheduleRexecuf oroutine object in a spawRa+1"""K" =Qs.get_running8{! =k.A_set_(1return task R # wait() and as_completed() similar to those in PEP 3148. FIRST_COMPLETED = concurrent.futures.%5EXCEPTION5 %O ALLh # async def fs, *, loop=None, timeoutreturn_when=K ): """Wait for the Fu6coroutines given by fs6M!. E0The iterable must not be empty(CQ@willpwrappedSTasks*Rs two sets ofA: (dpending)2bUsage: %@ = a >0io. B(fs)0Note: This doesrraise TMcError!s that aren't hcCp occurs( f`second.<1"""4if `"is F or 5.is 1ype(f"expect a listEU!s,P{typeC.__name__}"),fs]CValu^1'SeS$s/>#is'O|Kin (D",  /, f'Invalidliv7: {}#}'!if6@ is 9L = events.get_running_(Felse30war! s. (", argumentedeprecated since Python 3.8,  "scheduledpremoval2BQ10.", ?DxBionW, stacklevel=2@fs =vif any( y)f#fsNp8ing explicit passingWq objectX)O6LO1O3{ensure_u#(f >}q_,J@) _release40er(;er, *arg!ifw.( .s`esult(`2p_for(fut~R Ul\ Md, with3 2(Returns result o2f the Future or coroutine. When a timeout occurs, it cancels@task and raises T3Error. To avoid,DAlation, wrapWin shield(). (Iswait isxEled,OFalso;This funcd&]1"""pif loop$QNone:= events.get_running_!())7els30war! s. R("The\qargumendeprecated since Python 3.8, ~ "c scheduled for removal inBB10." ?DxBionW, stacklevel=2)t%if:is return a=fut2F<= 0Afut = ensure_fiQ(fut,=Etif fut.done()Dwwresult(8_SP_and_ hH:try] V"rexcept aions.C1led0 as J epu(s. p() from8f <C pAer =Ge.creat_u_handle*all_later(!, _release5Ber, ]GBcb =Dools.partial(4x@add__callback(cb #a untilM completese F.&  b 1e%# We must\Q thatsis not >QafterSr_for() /s.,See https://bugs.p.org/issue327519hk33c_['/# W/# S O # In case  lation failed with some # exception, we should re-raise it/See https://bugs.python.org/issue406075Itry:fut.result()s.CancelledError asR?ions.Timeout6p() from: n?lseKBgfinallto_handle.c () async def _wait(fs, ., return_when, loop)"""Internal helper for A1). The fs argument must be a collec of Futures.51"""passert G'Set( is empty.'*tAer =.create_fTb = Noni$ifV1not :.call_later(!, _releaseD1er, "er>0cou-ben(fs)!ton_comple#(f`}nonlocal ?U -= 1Dif (u<= 0 or5 == FIRST_COMPLETED.EXCEPTION and (/fJPled() tx %f.(()) E0is +, !ifABk.done(u&Cset_rvf in fs`f.add_P_,iback(_> }ai8G  f.remove, pending = set(),=or Oif fmO:"(f7eo) @ A_andL(fut the *fut* D or task until it 0es. cb = functools.partial(@ R/cbF,# We can/3 ondirectly to maky# sure _L:p itselfreliablyYBable@ fut.remove'_done_callback(cb) # This is *not* a @coroutine! It@just an iterator (yielding Futures). def as_completed(fs, *, loop=None, timeout): """Return`whose values are 1s. 8When waitfor the 'ed. you'll get"results (orGexceptions!) of$original-SS), in)"deGin which and as soonTthey pdiffers from PEP 3148;Vproper way to use t:6f qU#@ = a*@ f 1e '' may raise. 3b# Use =DIf aspecified,QBwillRQTpError wt occurs before alq}Note: The fnA 'f'not necessarily membWRof fs1"""$if>2.isHw(fs) or5.isj'Q Type(f"expec0bleAZ0s, P{typeH.__name__}")@.queimport QI@hereavoid circular .rproblem." =B(rl!ifFNone$ = events.get_ _!()77els1warnings. (", argumen-deprecated since Python 3.8, Q "9scheduled premovalBQ10.", ?DxBionW, stacklevel=2todo = {ensure_#(f)~^0set}r_handle = LC_on_#(Lyz!f.eI32ion/p.put_no()2;ra dummy9_'_for_one()-Jq.clear(ACan't do 0(f)~'(f!ifG r0 # +Q was [first f"{d!is4 (.cancel(=aasync LDfb3get=xz8# D   ..]e[() # May raise f.exception(). for f in todo:.add_done_callback(_on_compleB),!if9 and timeout is not NoneQ_handle = loop.\s_later(! , g d_range(len(&))^'yield _wait_for_one() @types.coroutine def __sleep0(A"""Skip one event run cycle*@Thisa private helperC'asyncio.[()', used$when the 'delay'Eset to 0. It+s a bare '':expression (which Task.__step knows howJX1instead of creating a Future object.`1"""s1  $, result=A, *,ACbc that 'es after a givime (in seconds).1if nV <= 0acreturn!if_Ek" =s.get_running_(57els0war! s. R("The\Pargum#is deprecated since Python 3.8, Y "*scheduled<premovalBU10.", CDxBionW, stacklevel=2)fj "e_hz" @@s._sF_unless_cancelled> Qx6trylgfinall)"h.oUensur3_orpWrap a -q or an ~@ablea!IfZ1, ied directlyl&ifqEs.is~( \ 'Etask  un0lsource_trace'@del H,._(E[-1]N*CelifY jZroD0s._Oraise ValueError('E belongsXa differV"n H'Ospecified as9C>'C! + inJEt.isLensure_future(_wrap_awaitable(coro_or_future), loop=) else: raise TypeError('An asyncio.FB@, a Tutine or an nU is 'MQ'required') @types.Lk def _Z)"""Helper f{censureA(). WWraps(an object with _&__) into@0tha*ll later be ped in a Task by ~1"""Ereturn (yield from.[()) U._is_9 =  class _Gathering(s8g3) This overrides cancel() to  all the children and act moreAlike.?, which doesn't immediately mark itself asA7Aled.@ _init__(1,3, *CNone}super()._8$Uelf._=Vv"_ested = FalsedKmsg=0if g.done(dR5retf|O%"if;msgx*g2Trujif retQ# If anyW tasks wereSually&led, we shouldGX# propagateHUslation [ regardless of?*)`_excep6s* argument. See issue 32684Cy.s  a! %*sBss,/7urn=nB"""R"a @ aggting results_Vgiven^"s/5sACorowms will.rschedul[QeventU b. TheyFnot necessarilyV >0sam4derApass^3Alls must shar=|!. QROaF#@ sucafully,/#edb#'s;oDlist4U1(in< or#of iginal sequence, #T8Qarrival)0is S,DRP treaK'as?v,o ; otherwise, the f:irst raised exception will be immediately propagated to the returned Dfuture. QCancellaMA: if/qouter F(R is c%ed, all children (thahave not comple{yet) are alsoC. If anyG1 isc@thisv1tre as$itedError --A V*not*{A in ]case. (TjoCqprevents of onetuse other tE&beq".)eQIf *r_ s*dFalse,2`ing gaWP() afi`s been marked dSwon't<R`submit}awaitables.For inst,d:;SuA!anASpcaller,-Qrefor ll3"``.EA()``D]Pcatch''an(!bykoa) fromG] 31"""6#ifrros_or_!s:pif loopFNone!= as.get_ _%()D;els9warnings. R("ThefPargummis deprecsince Python 3.8,  "and scheduled for removalFU10.",GDBionW, stacklevel=2a=!.cI%.set_result([]B $Pdef __Sback(fut)nonlocal nfinisheR += 1P"ifb.X(L3futargM# 'arg' wa%! F-,Aqrefore,Qa new3#4d specifi y KdA. Sk^0't Arol 8`isable "destroy i_task"!waS_log_J_J@= Fa M(I+= 1R[arg] "g@add__Zback(G # There's a duplicate Future object in coros_or_fGs. fut = arg_to"e[arg] #children.append(fut)outer = _Gatheringz(3p, loop=)Pqreturn 9 def shield(arg, *1aNone):2"""Wait for a ,5@ing rom cancellation.The statement0reswV}something() is exactly equivalent to tUNv*except* that ifEutine contain$is0ed,*task run&'n v is not6@. FaPOV ofC3X13A didFh. But itrller isEDtill:sy -fwexpression s.Rraise?CedError. Note: Ifped by o^R meanF`this wa-#()If you wacompletely ignore(CrecommendedA caA mb0) with a try/ clause, as follows:t2try  $] 8K31"""!if} 80warJ s. ("*u.6PdeprePd since Python 3.8, d "and scheduledpremovalBQ10.", ?DxBionW,cklevel=21inn|`ensure2ureFt1if -c.done(Wi# Shortcut1M# =yps._get_(#! =pe.creatO_2__callbackF"if.8led!ifM&*b# Mark's resultretrieved0WvBion([MFelse[Rexc =.0if ' DqFset_F:exc ;+. g `  . eL-L.add_done_callback(_inner_done_ca) outer.add!(_ 2breturn9 def run_coroutine_threadsafe(, loop):o"""Submit a 2 object to a given event9!. 9Rv6ncurrent.futures.F?ccess the result.=1"""fif notyEs.israise TypeError('A9is required'_ = co"()9(x2try,Ss._chain_t(ensurei=n", 'Fexcept (SystemExit, KeyboardInterrupt4:BQBaseEMion as exc#if~.set_running_or_notify_cancel_7nvion(exc&.FY_soon{ r?` # WeakSe @ntai all alive tasks. _all_ = weakref.9# DictionaryI3that are `ly act_Ain #n`s. {ELoop: Task} _C#{}{_register(zC"""Ra a new iRyncioecuted byn+Xse/p,Yv: = P.get(3$ifM1 isFNoneQs RuntimPf"CanQ into {!r} while another : f"5( {Cis being ex#"." [1] =!Qleave!=! @Leav+2doec_matchh $;del/un U! ah.udiscard:_pyl f # z% 'H"5 from _asXimport (;, _|,F _6, _v4 sks, _current_tasks) except ImportError: pass else_c_register:: = 5]_c_un( *(enM Uleavem """High-level sup for working with threads in asyncio""" i functoolscontextvars from . ,events __all__ = "to_aQ", aU def (b, /, *args, **kw )R@"""Ahronously runPion *?* separate!. #2Any[E and^AliedFthisTare directly!edJ#too . Also, the current :class:` ".C,` is propogated,MPallow1 variables V\Cmain to be accessed1theJReturn a coroutinaat canI`waitedW1getual result ofgqloop = .s.get_running_!()-cctx = ,c.copy_%r_call =}h.partial(ctx.run,gr 2_in_executor(NoneCj)Abstract Trans.(dU'Base*', 'ReadHWrit#8 #Datagram`SubproQ )  z !tsq__slots('_extra',)__init__(self, !=,vE"if3Q = {}L.m!ur)4S_infoxPname,Lault"""Get optional  B0rma}(fis_closing3"""@qTrue if!#s :1 or *edaise NotImplemd6Aey@CloseBuffered data willrflushed*. No more.6received. After ba\Cprotocol's0nec_lost() method((ually) be$0th ] as its argu/.k2rWDset_^,{ Set a new  raise !NotImplementedError def get_protocol(self): """Return the current .E."""+oraise j class ReadTransport(Bases """Interface for read-only t9svw__slots__ = ()0is_9?ingqTrue if\ is receivinghH_pauseyP pcR end.F No data will be passed to6v!'s&_FAed() Amethod until resum)ucalled.1\ S-t;ingD"edonce again $ FWritw4Aset_;_buffer_limits, high=None, low a"""SetZ)P- and(r-water J4b flow controlcThese two values#P whenj"foy`[)s. If specified,EI8lowP mustless than or equal5the>. Neither1 caEnegativeaults are ication-cuzOagiven,/ 2defjUto ant"@Settg/@zero 0ces!%asQwell,c,s  to pheneverC becomes non-empty. 1to h> 6 q|-j2is aEbUse of`-  enerally sub-optimal as itD@redu) oppunities>0 doU2I/O(Qomput)<3con/ly~S~=eAsize *%C + raise! NotImplementedError def write(self, data):@"""WQ some bytes to the transport.O4This does not block; it buffers8g and arranges for ityto be sent out asynchronously.'5""" _raiseSlineslist_of_ a " (or any iterable) ofeedault iation concatenaQphe argusScallsA) onAoresult  = b''.join(W.1)A_eof% QClose; efter flushing!ed!(is like typ- ^D into a UNIX program readfrom stdin.bData may still)receivedAcan_Return True if t@ supCq), Fals.Onot._abort ~immediateBo# w)lost. No morE0Theptocol's0nec_H() method^(eventually) bee$th None as its  class T|U(Read!, """Interface repre]dra bidir-alQThereo[veralas, but!y,"Auser   F newis; rather8platform{Qvides~EWusefuNfat arePed usLb's bes`practicesnever instantQ6s a %0ly; y " atility funQ, pas@it aC factory o> innecessarybRcreatn61proQr. (E.gBERLoop.8C_conm() or !server()\    a  @hook/bm up b5!'sU_made^ M ZGhere raises Not2Implemented for every method except writelines(), which calls() in a loop.8A""" __slots__ = () class DatagramTransport(Base!):="""Interfaced7 (UDP) t>/s.qdef sendto(self, H, addr=Noneo+q"""Send"v to theg.(This does not block; it buffers8f and arranges!itEPto bet out asynchronouslyI' is target socket6ess'!If*D use3Bqess poi&on creationJMyraise Not,RError [ abZ I0CloB immediate B6ew@willlost. No morereceivedThe protocol's connec_H#() B(eventually) beed with Eas its argu(o$Subprocess  0dqget_pid fG_1 id 8[returncodeb,See alsoyhttp://docs.python.org/3/library/s# v.Popen.cPp{05pe_$N, fd?$Bpipenumber fSms_signalw {ik\XR#S%terminat#AStopBAliac@On Posix OS=ds SIGTERM&eOn Window?Win32 API fun$ TP%() 4Oto s *V2kile ]KE - On Posix OSs the function sends SIGKILL tosubprocess.  On Windows kill() is an alias for terminate(). 8See also:http://docs.python.org/3/library/# p.Popen.|J5""" 0raise NotImplementedError class _FlowControlMixin(Transport):Ha"""AllQlogic(write) flow c? in a mix-in base cqThe subt must iQ get_Q_buffer_siz1B It,Acall_maybe_pause_protocoxwheneverL L L increases,FCand J_resumKSit de8.!ayEoverride slimits() (e.g.Aspecify di1entBdefaults $constructor super().__init__(extra). ThisVPwill 1user may2 A and^,!}4ir 2's Ping()%Fv!be"eda-__slots__ = ('_loop', 'dhigh_water3low)~Edef <aself, Bp=None, \ s aassert;@not M f.! =& / = False&e`ize = .z"if><0_^hreturn8d  9#f = Trub:try: >.m+except (SystemExit, KeyboardInterrup0BJQBaseEU2oas excV._ion_handler({]w'message': '  failed':'k ':&t!':'&.0}jE(1if V u= h>_protocol_paused = False Itry:self._protocol.resume_writing()0except (SystemExit, KeyboardInterrupt)d;raiJQBaseEUion as exc?loop.call_=ion_handler({'message': ' failed',Cl ':&transport': '&w01}) qdef gete_buffer_limits(jnqreturn ._low_water,b._high[/_s\ , 4=None, low q!if!@ is $  if3[ = 64 * 1024JelseO325low1j Rlow =B// 4TLbif not!>=J>= 0u ValueError(tC!f' ({!r}) must be U\({low#0'Ck  )[B=6low:maybe_pauseB( AsizeFeNotImplementedn0 imSt socketwarnings class T|S(:C"""A:-like wrapper for exposing real 0"s.CThese objects canrsafely led by APIs d`O.extra_info(' ')`. All potentially dis="ivoperations ([" "=.close()") are banned.y2"""__slots__ = ('_9'',__init__,:0et.-e! =%d3_naC8wha4. 41f"Uy{3A} onT6etsRAfrom;! "8`f"willprohibited iJyncio 3.9. Please reNyour use c Oto bugs.python.org."aDeprecWCPurce=,h0@pr!ty.afamily1:..(fF>typAeturn self._sock.type @propertydef proto(self):'preturn q._sock.'D6__repr__9Us = (GKf"0get)iname()+1if .E60f"{&!={&pexcept fet.errorOIpass~rOpeer.k&!={&">"yiNtate}raise TypeE("Cannot serialize sobject"h  (:try!R.set_f_fd(-1%a(Value,)n6logger.info('i failed: %s', F  if(.errno == ~.EINVALraise Runtim(f'sig {sig} can6be caught'OelseT-Cdef (,):@"""I helper that is*`actual4!Ur."""/ =1.gec$ifkis Nonreturn # Assume it's some race conditionER._cancels.remove r)nR it properlyalQ_add_callbackXRsafe({?elfa'0r f. UNIX onR6True if a.CBwas 1d, '6not5che(o 1Key ifNjSIGINT;qr.default_int ?vSIG_DFL ,lF 2zovAst ?2 3exc} return True def _check_signal(self, sig):"&"""Internal helper to validate a/Bnal.T2Raise ValueError if the) number is inG or uncatchable.{IiRuntimK re?a problem setting upivhandlerI5"""U if not isinstance(sig, intr2Typ{(f'sig must be an3,L{sig!r}') if in #l/s(o64(f' 9nl make_read_pipe_transport,,tocol, waiter=None,Qextra.return _UnixReadPipeTx!, Q,_writeBq W|%RasyncMsubprocess#roargs, shellstdin, stdouterr, bufsizI`, **kwwith events.get_child_wer() as (Z\.is_active,0# C{f early # exception before^P crea B# pr ` execu0?!isSyQ> it&!("/io;[fated, "0supylled.")0 = ..e_future(*2" =S ,6N=\=XJ&C.add"r(6_pid()qL^_callback, V yia 1 (SystemExit, KeyboardInterrupt): Yraiseexcept BaseE >ion8transp.close()Abcawait %_ %|<creturn5 def _child_watcher_callback(self, pid, :Scode,?(.6_soon_threadsafe(process_exiteO)`async create_unix_connection(q, protocol_factory, path=None, *,2#slBsock !erver_hostname"sl_handshake_timeout( assert sN@ is or isinstance(&V, strjif ssl[ (% ValueErrorC"'you have to passwhen using'Jelsew1not ,} '9only meaningful withL|C X/'sZJ!if?ock! ,`'P and P can be specified at the same 'DCp= os.fs (']=d0et.2et(.AF_UNIX,SOCK_STREAM, 0H>tryH.setblocking(False9 .  4wpgwt_B 'nj&th7wercs1if .family !xj? or HGtype3g X@f'A  Domain Stream Socket was expecPgot {;!r}t=6ort7 = _,'_4 lF1Lssl, 9dshake_timeoSut)  return transport, protocol $async def create_unix_server("IV self>_factory, path=None, *,23ockbacklog=100, ssl .sl_handshake_timeout(Atarting=True):Iif isinstance(ssl, bool"(raise TypeError('ssl argument must be an SSLContext or "')8G ifq is not0A and 6ssl>CValu^only meaningful with  ?ock!&'jsR1can be specified at the same DCp= os.fs (#] = 2et.(.AF_UNIX,SOCK_STREAMF# Check for abstract6a `str`q`bytes`s are supC9ed.!if$1[0]in (0, '\x00'y:trytat.S_IS(os.stat x.st_mod5os.remove2 (except FileNotFoundOpassC!OS9 as err@a# Dire% may have permissions #toy slogger.epUnable ;2or p stale O/ 'PT'%r: %r', 2x_.bindnj'.xc'Cjclose(`if excPno ==no.EADDRINUSEO6# Let's improves7 message by adding#Lpwhat exaddress it occursumsg = f'A/{0!r}_already in usei2I(err, msg) fromW OelseY 0. Go!is^A  GJ"waB>,!noUD if (sock.family != socket.AF_UNIX or &W.type3SOCK_STREAM):6raise ValueError("gAf'A xDomain Stream S was expected, got {e!r}') P.setblocking(False) erver = base_events.S(self, [C], protocol_factory,Dssl, backlog, ssl_handshake_timeoutif start_serving9Ier._#(># Skip one loop iteration so that all '.add_reader'0# g,irough.await tasks.sleep(0,h=+vrreturn async def _Q_sendfile_nativem , , offset, countE:try4os.Nexcept Attributg 7)0ionNotAvailabl8"t() is not a6" Ano =.* (, io.UnsupportedOp ) /rr&" regular size = os.fstat(P).st_ !OSDw" ='3 if `else f!if5 0 # empty [`fut = .create_future_impl(fut, None,Z/noJ %, 6, 0r}2futz!, registered_fd Ptotal fdWoxWilenoP ifhC # Remove the calls early. It should be rar' at,^#eP says 0 fdu'Ay bu4`r still lsGEAGAIN, and I am willing to take a hit in{case inEPorder2s<1ifypcommon 3 !.r0_wr(  if .cancelled():  self._sock_sendfile_update_ @pos(no, offset, total.Gt) ereturnif count:,blocksize =' -Q +6if .J<= 0JN8Ofut.set_result(+:trysent = os.X\(fd, MLexcept (B+ingIOError, Interrupted)r if registered_fd is None&7add_cancellation_callback(fut, <6awriterP_native_impl, L+F l!. `,&P!OS5z as excMif (<1not@O andexc.errno == .ENOTCONN4type(exc)b`Connec{ (# If we have an d this isn't a first = to$# (), i.e. the c was closed inomiddleK!of Aoper8, normalVeK to Kto make its nt across all Posix systems.Bnew_exc =l(+O"h$etKed", ;j.__cause__ =L g. 'if7 # We can get here for differUreasons,6mais# one being 'r'a#ular mmap(2)-lik6,which case we'll f" on usingQplainp.()2err: ep3s.S{NotAvailableV~failed"$"Tzion(errv?elss h%&xc1 (S4 Exit, KeyboardInterrupt):  draise except BaseE ion as exc:%- self._sock_sendfile_update_ @pos(no, offset, total.)t)Kfut.set_|vion(exc#Jelse|if sent == 0Y# EOFa8Oresult(=1 += M#if registered_fd is Non(ladd_cancellation_callback(fut, z<@:writer(fd,  native_impl, P NJSock, -2<, count, blocksize_GKdef {^'if, >yos.lseekos.SEEK_SET) S cb)S ifs.P;ed( $Afd =.o(Gzd != -1`@.remove_HFdone]cb) class _UnixReadPipeTransport(t s."):7@max_ = 256 * 1024 # max bytes we read in one ev%Ploop LE__init__( , ', pipe, protocol, wa:=[q, extra [super().O&^!._ ['_A'] =h R_! = 64|' aclosing = Fal @@ause9<mode = os.fstatH.pno).st_!.if not (+.S_ISFIFO(#E) or''OSOCK'2CHR&HB jF A "> ValueError(" 1for s/_ets only."!os9ingL,.1.S_soon3q.connecmade, self) % # only start reading when connection_made() has besalled self._loop.call_soon(P_add_\5er,5< 5fileno, 9>%y)=if waiter is not None:Uwake up the3M futures._set_result_unless_cance$ \,!) def __repr__I)info = [_class__.__name__]AX#ifA@pipe($L.append('closed'e%elC6inga9nfo>7ing?]bf'fd={}*selector = getattrSD, '_!'& @ andX%@poll=,_events._testy(\|zs.EVENT_READY:3if } UY&/#;elssW'idle6 - EIopenE w .' Creturn '<{}>'.format(' '.join(<):trydata = os.5/'._f.max_sizexexcept (BlockingIOError, InterruptedyWEpassE!OS*z as exc`atal_eb(exc, 'Fe A on transportk f lpprotocol.%_received(/</get_debug( Aplogger.("%r was  by peer"f|;-{ETrue_!%q_removee]8 !5eof BRDlostBpaus1ingC or{1f._7d?Z)9 = 80 if self._loop.get_debug(): rlogger. "%r pauses reading", self) 5def resume_ (S!if0._closing or not\d.areturn_P"._) = FalseA_add!er._fileno.%y)?Bset_protocol$, o(% =$]:I?)JF;$ist9 8e3'if":ingge(None"q__del__T, _warn=Pings. qpipe iswP nEQ(f"unrd transport {!r}", ResourceWarning, ="fAipe.Q(fatal_erro[, exc, message='F  A on '# should be called byMeption handler only(isinstance({0OSEP) and@.errno ==gno.EIOwX + C: %s_info=TrueMJelsemuB_exc_%({'\$':f,$I ':":'#]'". ,}&8exc)!  = 5b_removN  0RAsoon]!._`connecRR_lost%@*6try 4.iofinallAhX` = $" " class _UnixWritePipeT.(#s._FlowControlMixin <ZV'):nU_init,#, waiter=1tra Auper()._Opextra, Pt" [''] = pipe self._pipe = # cfileno.+()%protocol' "buffer = bytearrayEconn_lost = 0? closing = False # Set when  e() or write_eof() called. J0modos.fstat(P).st_!.`is_cha-.S_ISCHR($`is_fif%NFIFO&Psocke(LSOCK(tf not ({4or a F%): = None  Braise ValueError("P-transport is only for "} "2s, `s and facter devices")os.set_blocking,  Ploop.S_soon2.eection_made,q# On AIX, the reader trick (to beRified}&p end of6#""d)*Qworks0 .vother platforms itJ3C:=`(Excep : OS X 10.4? Issue #19294.( ifX>6qDsys..startswith("aix")#'17onnl() has be%R_add_,9= N.=y`if wai isC bpwake up35futures._result_unless_cance,def __repr__ !in[,_class__.__name__]f!if''!isa $L.append(''r%elC?ing> 7ing?]bf'fd={}*pselectoqgetattr ._CD, '_!'&:`  kX%@poll=+_events._testy(\Ns.EVENT_WRITEZ?3if ~ V5nfo&') else: info.append('idle') %bufsize = self.get_write_buffer_)()3T#f'A#={ &}'.BelifX_pipe is not NonSY'openE .gclosed0return '<{}>'.format(' '.join(<)Odef  )NS@len(.GQ_ready#=0# PBwas by peer.V&Aloopgdebug(Fplogger.^("%r S!",oZPp(BrokenvError()DZ99g, dataassert isinstance(!, (bytes,  array, memoryview)), repr,.ifH@tf' =TL' ,Iconn_lost orm ._B:ingA1Q>= cots.LOG_THRESHOLD_FOR_CONNLOST_WRITESOwarning('T}$edT'X5B'os.B raised exception.TEI+= 1j3\8# Attempt to send it right away first&>tryEn = ocfileno  (BlockingIO, Interrupted J~i0NSystemExit, KeyboardQJmJTBaseE0 as %qfatal_epexc, 'F  @ on  transportN if n == B ^n > 0FI[n:]D.B_addr{$._%1 +=bmaybe_pause_protocol(C:uZzIf, 'Data should0be &y'g s self._buffeCr) except (BlockingIOError, Interrupted%):4;EpassESystemExit, KeyboardH A\raiseBQBaseEion as excxself._buffer.clear(!conn_lost += 1g!# Remove writer here, _fatal_e() doesn't it<because is empty.(qloop._rn_n(ofilenopexc, 'F  on pipe transport'JJelse2if n == len~> ]%8maybe_resume_protocol() # May append to WG2if zclosing"# creader8<Pcall_GRectioMV(Nonel-ireturn!elw>> 03delQ[:n] >rdef can,A_eofjV True2Z.+ Lxcassert_o" =~3o7 >44soo ", D6set\M$, kM.(% =$[gI?@1;3is_$8e3t1notP and N #=";all what we needeow3 thaPak)q__del__, _warn=Pings. 5 EQ(f"und {!r}", ResourceWarning, ="  ._=.Q(Qabort1, ] *(,, message=# should be Ped byM eps handler onlyif isinstance(#/OSk|get_debug():  &logger.debug("%r: %s", self, message, exc_info=True) DUelse:8._loop.call_exception_handler({04'g%':q$I ':,"transport':#protocol"$._ O}close(exc) URdef _! f=None).%`ing = :=!if._buffer6:D_remove_writer(lfilenoJ|.clear( MOreadM 0CsoonxaconnecAlost  %@*6try .D~(ofinallABipe.4=ppipe = !" class _UnixSubprocessTu(base_s_.Base('):WSstart2args, shell, stdin1outerr, bufsize, **kw13$_w~G == JPIPE# Use a socket pair forince not all platformsXP# sup90ng  events on the  end of aB(which we use in order to detect m ofT EPotherb ). Notably this is neededAIX, and workjust fine*Q.p!inC.I *c Yopen(i'=-=0out:A N universal_newlines=Falsek=s E_!_w[!otn Z1elf!c.)1 =  _w.detach(), 'wb'dfering S M4r2AbstractChildWatch4""" ? cv`monito c8 p2es.@Objects derived from this class moni.tor a collection of subprocesses and report their termina1r interrupby a signal. ;8New callbacks are registered with .add_child_handler(). Starting a new  must be doneC`in a 'M' block to allow watcherSsuspeits activity until.Dnew jif fully(this is needed toprevent a race condiin some implement:#s) 0Exa:E' =.Popen("sleep 1")E/_IU.pid,)FotesuIUclassthread-safe~0Sin objects may cqsSIGCHLD7twaitpid(-1),1re shouldPonly ecD per.I2"""Ndef qiself, , *args)C"""R   Arrange for(^returncode`!be'1henDess 'pid'xes. Specify 0noteuthe sameKreplacesI OiousQNote:)^raise Not>edError(ekremove t,k }rThe funps True ifEpwas sucj%d,6DFals70re 1nw2to .2attach_loop( A$)2an g1I*2ly p BPun it isfirst deeeCforeD_( 5b"ne*)Qclose# C T#make sure that anAderlEresource_freed(2is_R0 ``$``iePis usyQOMinstalledPy to handle process exit notifications. 5""" raise NotImplementedError()1`def __r__(self):>("""Enter the watcher's context and allow starting new p"esbThis func must return r!3xit, a, b, c?xito class PidfdChildW(Abstract~1"""/$ iy0 us' Linux's pid file descriptor3cvKTpolls_ 80 (ps) to await ?q termin. In some respects, is a "Goldilocks[Y . It doesn'quire signals oLdreads,$igfere with anyes launched outsideevent loop,ascalesMlinearlyLnumber of sub Y+byTQ. TheMmain disadvantage@thatPfds a0pec{ onaork onM0rec(5.3+) kernels. %inZH. ._b = Noncallbacks = {}Pr ._exc_type, Cvalu eo3pasxis_activeZxais not2elf.is_runningMclosX!aattach'(%,,B!ifz z,isw;0war s. (!'A}e be deNed ',bfrom ay,@pend>handlers',>RuntimeW) 2for, _, _ i%._.'s(";#._remove_"erb-2os.Ek@clea4 s=*Aadd__`,$, Rw, *argsAexis=+Ps.get ifn/ Fu[pid] =98[0]|JelseMa = os. _open(pid)  self._loop._add_reader(pidfd, do_wait, pid) < callbacks[pid] =(>q, args :Sdef _Q(_V:[z <, =k@.popMiremove)6tryos_, status = os.0pid^6, 08 except ChildProcessErrorMp# The c%" p&` is alZy reaped# (may happen if )9 ed elsewhere).=returncode = 255logger.warning(z"pid %d exitNd: "B will report ]255",/ A <@= _comput()Kos.closef6,0, *B+ _handler 7O_, _??Key6e False6VpTrue U ifWIFSIGNALEDtt died because of a signal-os.WTERMSIG[%el{OEXITyexited (e.g sys.'()%x@os.WXkSTATUSz/see], but we don't understand its)is should0Eif it does, let's justZ4tha; perhaps helps debug itw9! class BaseWatcher(Abstract"):P q_init__)l = NonpC&{}P> Maattachz(Qis_active!1not jais_run\|-, expected_raise NotImplemented(NM_allD /passert - or isin0ce(, events.EBLoop if self._loop is not None and self._callbacks: warnings. (&%'APbeing detached ',from a child watcher with pend>handlers',>RuntimeW%) !2if  $.remove_signal_t(.SIGCHLDa:! ={u O.addl ,sig_chld|d# Prevent a race condition in caseUterminatedB0dur`the switch.!do_waitpid_all(@def (*)Z6try k -._Jexcept (SystemExit, KeyboardInterrupt`4UraiseBQBaseEMjas exc#V should always be available her^pe# as ''BPadded"a ( 7:`in 'at} .n_5ion{OS'message': 'Unknown$ep:'h ':< \}) class SafeCW(e@"""','implementa.ZThis  avoids dis ot code spaws processes by@poll-explicitly each)  instead of w1ingNoI(-1)s a safe solu but it haignificant overh^Bwhenacbig number}[ren (O(n) 1is !d)>2"""C\close~Qr.clear(>=super().= _em,__Rareturn:|c__exit-, a, b, c hFpass/a, pid,w, *argsE%[pid] = (!, 1hvvlready %}4(pi~2K 1delN v6TruZError1RFalse_do_waitpid_all(self): for pid in list ._callbacks):*1>._do_waitpid(pid)MHdef +, expected_)LiassertB > 0Ji6try.pid, status = os.b,WNOHANG) except ChildProcessErrorap# The c%" p& is already reapedT# (may happen if )9Ced elsewhere).=t= returncode = 255logger.warning("Unknowns%d, will report h]255",L 6!if>J== 0S stZalive4  _compute_*(50if ._loop.get_debug(+P '%s exited with*>%s')I ,( 1tP, argRs.popp?2Key # pragma: no cover19# M.remove__handler( >Pafterds|" watcher got an unQnO: %r1exc_info=True fa,0, *) class FastWX(Base`@"""','implementation.ZThis qs every termina`es by 1ing-1) directly, possibly breaking ot\:P spawE!esM1and."Utheir0ereno noticeable yhead when XJa big numbFf1rens(O(1) each time au#esB1"""1qq_init__z0sup$._ Vlock = thing.Lock(&`zombie!{}t\elf._fork]close.s.cleari[>l~__enter: self._forks += 1 return selfdef __exit__(, a, b, c)::Awith4f._lockZ5q-q#if9cor notzzombiesOS collateral_victims = str#._L)4.clear()Wlogger.warning(;)"Caught subprocesses termination from unknown pids: %s",E~vadd_child_handle,L, callback, *argsTasserBU, "Must use the context manager" ?try@codene[Ozpop(pidrexcept KeyErrorQ0# Tp is run|.7s[pid] = 6 9 n dead already. We can fir8t", ] Zoremove f3deln {U Truek 1VFalse_do_waitpid_all;`# BecaG of signal coalescing, we miAkeepCing PU() as# long as we're able to reap a gQwhile 0 ,pid, statu4os.-1, os.WNOHANGCwPrNo more VexistjJelse if^ == 0!:# Au!still alive|6  = _compute_.(D2" ! , ./s.0: !#l= $ le(0# Iybe registered ye4 OrRR8loop.get_debug({' ,'k %s exited '  'with returncode %s', 0 Gpid,>):continue!callback = Non$_else:: if self._loop.get_debug()/rlogger.('process %s exited '  5if !iswarning(A"Caught subtermination from unknown pid: "G%d -> %d",'~( , *args) class MultiLoopChildWatcher(Abstractb"""A w( that doesn't require run  in the ma aread. This implementregisters a SIGCHLD signal handler on>instanti8(which may conflict)aother :;0ll VPfor tn)ae soluis safe but it ha0ificant overhead whe_ing a big numb#f es (*O(n)* each time ais received).2"""B:# I?3notb# The keeps compatibilityA ABCf# To achieveempty attach() method85andaccept explicit@argu0|Padd_c_3er()/remove5@retrsbccurrenc0by n6def __init__($._<as = {}qsaved_sig'\is_active] Gais notxMclosH v.clear(ud t al (. r6$!=zig_chldm A"Kwas changed by outside"p , PR /~__enter7CgH __-, exc_type val, exc_tb):# Qpass #def add_child_handler(self, pid, callback, *args):7H loop = events.get_running_%())N$._Is[pid] = ('a``A# Pr] a race condition in case the  is already terminated.do_waitpid(pid)koremove6tryOdel z%return Trueexcept KeyErrorV1VFalsebattach^t , B# Don't sav  but initialize it<1 ifed first tim # The reason to do it hereiXthat )N5rom# unix policy only forpmain th6# MU`requirWor subscripon SIGCHLD signalu#ifSd_sigQnot Nonepj"-._@=k.r(.,wvig_chld logger.warN ("Eiouswas set by non-Python code, " "restoretefault Uon watcher close."G vSIG_DFLM# Set SA_RESTARTulimit EINTR occurrences [siginterrupto_A_allz0pid=Alist*R 2lI, expected_[_iassertF > 0 Swstatus = os.b,vWNOHANGUCProcess^8p&@ireaped?# (may happen;Pelsew$)Jt= \ri = 255  \"Unknowns%d, will report h]255",L @debuAg = l if/Z == 0q stZalive24'+_compute_*(6 debug_log =s True Etry: loop, callback, args = self._s.pop(pid)<except KeyError: # pragma: no cover-i# May happen if .remove_child_handler() is+ed> after os.waitpid() returns.*logger.warning("C` watcher got an unexpected pid: %r",Fpid, exc_info=R :lseT0if W.is_closed()!Z Loop %r that sI!",Z,Oeif debug_log and>Q.get_7$'process %s exi4Cwith~code %s'? T$ s_N? ,>}_soon_threadsafe( E0, *!) def _sig_chld(, signum, frame /S._do_jV_all((SystemExit,boardInterrupt`FraisBQBaseEG:ion!'Unknowneption in SIGCHLD--r' class T@!ed W (Abstract4"""3 ?implementa.m5The!ruses a S per >@for U@ing 4the s finishS It doesn't require subscrion POSIX!al]6butz1creOnot free\has O(1) coxity, itsformanceRdepenon amount of spawne2"""q_init__ejPpid_cMer = itertools.&(0z/\&{}cis_activedh( *_5joir(O ,1""" nal: Join all non-daemons[ Alist..values()I#iffx al )b.]7r%s.  _ep! __:-Btype 2val 'tbSHpassA5del@_=0ing'rn:threads = [thread for thr in list(self._s.values()) #if=.is_alive()])%s:D_warn(f"{j,_class__} has registered but not finished child processes",W[ ResourceWarning#!=~!) Cdef add_a_handler , pid, callback, *args)loop = events.get_runz_(7Q# =2Qing.Tyq(target._do_waitvsname=f"2T-{nexpid_counter)}+ U =( )L Ddaemon=TruejRU[pid]w.start(oremove# asyncio neverO?U) !!!z# The method is no-op}is implementgecause9abstract base e requires it+preturn rRttach(# , |Fpass//, expected_4iassert.B > 0`6try.Pstatus = os.g(r0except CPZErrorXqlx aly reaped;# (may happen if )9ed elsewhere).=0pid& code = 255plogger.Iing("Unknown4 %d, will report h?2557pidJ:lse6@= _compute_(C!ifTgdebug(_! '_p %s exiHwith?%s'  !uis_closed{ "Li%2at sirE"D  M:.8T_soon@afe(@1I.popA)  _UnixDefaultE(sPolicy(8OBase"r"""UNIXh! pB a watcher [aes."""_loop_factory =! _UnixSelectorEventLoop def __init__(self):super(). )elf._watcher = NoneQP V`with evs._lockqu0if ]!is^: # pragma: no branch; <= ThreadedChildW(3Aif t*ing.current_W() isEmain J .attach_loop  al6op)6Aset_+ , 6"""Set theC .Dz As a side effect, if a c  was set before,Nn callingQ.`) from, Q will< 5 onO .6"""t ~P&3if Kais not*E and]yDQAget_"NC"""G3forprocesses!If0yet?, ap objectautomatiy createdtr E Djreturn,  3dassertM or isinstance(N, Abstract Y Xw.close(I $ == / =uDefaultdPolicy0 $ P proa2 s oWindows.Nimport _overlapped dwinapiTerrno Emath TsvcrtVsockeEtrucDtime(weakref _#. u sbase_sub" lfuture4exceptiont s/Ltask2wNT_util4loglogger __all__ = (a'S', 'PDIocp"',>', 'WindowsSelectorEventLoopPolicy', 'WindowsProa&) NULL = 0 INFINITE #xf ERROR_CONNECTION_REFUSED = 1225 SABORT 636 # Initial delay in seconds for connect_pipe() before retrying to " `_PIPE_`_DELAY.001 # Maximumj:7MAXi100 class _OverlappedFuture(f"s.!):b"""Sub32of  which represents an oP operation. ECancelling it will immediately cO theE2"""Mdef __init__(self, ov, *, loop=None7super().2%)$0if H._source_traceback#?del(E[-1]NKwov = ov.Q_info5 = )ov is not state = 'pending' 3ov. else 'completed'.insert(1, f'1=<{aD}, {.address:#x}>'preturn N_S X;tryelf._ov.k(except OSError as exc=context = {b'message': ' As failed='Pion':'C!':i } U,['+ ']w3  l4e.call__handler(co3 ], msg&*[/+(KFmsg)j6setj,u epx 0y"._p .Dcresultq n( h<BaseWaitHv+b wait .b ',4wp) i f self._source_traceback: ?del(E[-1]+# Keep a reference to the Overlapped objectk-it alive until-Owait is unregistered{ov = ovhandle = W_7 =  )# Should we call UWaitEx() if@ completesB orcancelled?r = True~def _poll(')# non-blockingw: use a timeout of 0 millisecon,return (_winapi.ForSingleOo.u, 0) == @AIT_OBJECT_0)repr_infoO = super()._))f$.&Rnd(f' ={W:#x}'1,onot None8@stat'signaled'Zl) else ' Eing'>J9=Ifl3F Bo_;!cbxW, fut}Q# The2: waOp: it's 71safqdestroy#Gz"ifx  m-s = Fals= = J! =:!:try4_ov.(Gexcept OSError as excS ifQ.wine$8!= fERROR_IO_PENDING=context = {'message': 'Failed{8+/',GPion':&Pfuturl$}\i ,['/ ']]I  tp._loop._#r(g ,#  means that^mis pending&A%M\IDa, msg= H( super().cancel(msg=msg) def set_exception(self, !):(,._unregister_wait() zuper().PJ rcresulto l$=() class _WaitCancelFuture(_BasebHandleub"""Sub:2of  which represents a for the c_ la:Q of a zd using an event.&6"""__init__2ov,+,p!_h, *, loop=NonezF@==elf._done_callback = bwraise RuntimeError("v must not b03ed"a", isZi!is{0 ~ 0 !8j m# , )]jproactortKp= }$._d4 = m"{ = True)X = _overlapped.CreateEr(,9, False, GM_fut 3_cb7futK _winapi.CloseP!._9 N $A# IfD was6ed,may neverpsignall!%sol# it's required to  it. Otherwi`SIocpPF .cw() willO1forwU#z/Bcome9Ep already receiv$heR@safeL() because we kept a referenc<Opw objectM>is used a>PuniquNyb&ov -u*_wait_cb(fut)  def _unregister_wait(self): $pif not $._*&ed!%ereturn4 - = False "j_handle =](Ju = None!:try_overlapped.UwWaitEx(I,veevent)Pexcept OSError as excb ifQ.wine$8!= uERROR_IO_PENDING=.context = {x'message': 'Failed to P the  B/',GPion':&Pfuturll$}\#if;source_traceback,['/%']  t._loop.call_E#r(g| ,# 1 is1an ,d7was|&edA0_fuproactor.Qq_cancelX!._.f_ ` b) class PipeServer(objectA"""C!representing a pipe s1.@Thismuch like a bound, l&n9qsocket.1"""Mq_init__, address$ ="A free_inst:s = weakref.WeakSet( # raializeattribute before 5__&; M`becausJis function can raise "1ands`destruhs#close() method   ac(B5RTrue)get_unconnecteda# Create new  N previous one. 5jensureat (until ^ d) realways at least&#b fYz"erif a client attempF3to it willfail with FileNotF4tmp. m MX:7tmp7d, firs1# RdP a wrr  k(): return None flags = _winapi.PIPE_ACCESS_DUPLEX |FILE_FLAG_OVERLAPPEDJif first:c`|aDaFIRST_qINSTANCE;hCreateNamedPipe(%`self._address, o," TYPE_MESSAGEwREADMOD HOWAITgUNLIMITED_S.windows_utils.BUFSIZE, 0NMP_FOREVER,UNULL)8kpipe =^LHandle(h+Pfree_instances.add(D'K gdef closed(C)+1 is)>&=0if O._accept_qp_futureC1notGn 2 .c&l(. ! =[(0# CU all  which have been connected to by a client.L@for 3 in   .. 7g ! ~s.clear(__del__ =  class _WSelectorEventLoop _ems.Base&3"""H version oB B loop."""|JProatpt &t Bt using IOCP2__init__4f, ;=e+%if  9t = Iocpsuper().r3run_forever:tryrcassertu_reading(.call_soond .__B "kfinall@V Oov =I._ov3d.jP3#c/ was just led so if it hasn't @ # finished yet,/n will be (it's possible that%has 2 # already finished and its callback is waiting in the queue, A# where it could still happen if<event loopYrestarted). K # UnregisterTotherwise IocpProactor.close wj0 fo.N}foreverPif ovnot None:#tself._pw%_uM(ov)3/_aing_future =e 2async def create_pipe_connection(A, protocol_fy, address)@f = .HU(2xkB = a6l- =w(Utransrmake_duplexm_Pport(f5 extra={'$':}qreturn sj `hP_serv\7er = PipeServerP:q_accept 0(f=S6tryNif fGf.result ._free_instances.discard).23if =e+d((p# A cliwPed beuIR was MKAdrop6R(3)Eexit|8'-:s F}  /,  B._get_un*1if 9!ishY r ex OSError as exctE.fileno() != -11t_fion_handler({.2'message': ' failed''f ':*!':h&8!el_debuglogger.warning("A failed on pipe %r", pipe, exc_info=True)8`except"eptions.CancelledError:.q0if V{.close(h>lse3server._ac_>_future = f{ f.add_done_callback(loop@%) 7Pself.)__soon*return []Basync def _make_subprocess_transport(c, protocol, args, shell~ stdin,1outerr, bufsizeIextra=None, **kw)wwaiter = s.createp = _WindowsST<6M=FI>N6tryJ#af %er&P(SystemExit, KeyboardInterruptI\raiseBQBaseE:ionyg!_lm1 class IocpProact4""" implementa1 using IOCP."""<6s_init__$concurrency=0xf _0 = results = []@iocpoverlapped.C@IoCoP9 _0INVALID_HANDLE_VALUE, NULL, 0, @cach%{}] registered = weakref.WeakSet-)un/ 0sto_pR{acheck_dh"if_6!isl a Runtime(('B is ]'ovS_reprq0nfo'o#=%s' % len!._F)'1&s) .!End('  '<%s %s>___.__name__, " ".join(T)1set; ,  ! =1TselecSz1out): if not self._results: poll(timeout) Ztmp ==8SU = []return tmp Cdef }(7, value)5futiloop.create_future(tfut.setNHey6futyCrecvvconn, nbytes, flags=0&gister_with_iocp(9ov = _overlapped.O V(NULL*6tryif isinstanceW, socket.0pov.WSAR.fileno()v5Jelse{ov.ReadFil} LEexcept BrokenPipeErrorSo7]R(b'')}qqfinish_trans, key, ov .Bdbov.getn"!OSz as exc' ifP.wineX in (ERROR_NETNAME_DELETED,[CGOPERATION_ABORTEDJraise ConnectionReset(*exc.args6P=P(ov, J', Y_into7?buf4I \X5MF60(4Ifrom3jh ov.WSARecvFrom(conn.fileno(), nbytes, flags) except BrokenPipeError: 'return self._result((b'', None)) .def finish_recv(trans, key, ov)W:trylcov.getl"!OS~ as excI ifP.wine in (_overlapped.ERROR_NETNAME_DELETED,jGOPERATION_ABORTEDJraise ConnectionReset(*exc.ar6NelseP gister(ov, ,psendto()3buf*=0, addr=. d_with_iocpwXov = 0OS(NULLov.WSASendToF7ssq<f6aif isinstancef, socket.}0-@rriteFilo Bj ac>lo7nerC,q# =eBget_\_(1v.familytbrlapped.Overlapped(NULL) ov.AcceptEx(listener.fileno(), conn%) 7def finish_a?(trans, key, ov):+iov.getresult(}*# Use SO_UPDATE_ACCEPT_CONTEXT so getsockname() etc work.a buf = struct.pack('@P', }s`@opt(het.SOL_SOCKET,fR_overW._, bufvvtimeoutx4get)3areturnrgetpeer`async _coro(future:  # Coroutine closing the ? 1 ifH is cancelled!:try.bawait ; . exy dions.CV^ErrorKeFhVraise qelf._regFr(ov,t6# =Dtasks.ensure_s(=, loop=s| \-@ect(3, address!if.type ==.j_DGRAM5# WSAConnect will complete immediately for UDPNsvwe don'tc# need to O any IOCP operation2#(X ;5futBe.creatfQfut.set_dJNone!vs5k_with_iocp?S# Thes be locally bound before we  vFEx() ! PBindLS.Vamily71 OS,Z as eif e.wineL != errno.WSAEINVAL.B # Probably already; check u8 M #0[1]0 Xov = *Oxx7Mw,~5oCONNECw1DATE_CONNECT_CONTEXT, 0) return conn self._register(ov,(, finish_5Bect)9def sendfile(;`, sock.le, offsetBUunt):l*e_with_iocp(=ov = _overlapped.O W(NULL*ic_low =v & 0xffff_{_high = ( >> 32)3v.TransmitF@ock.Uno(),Za msvcrt.get_osfhandle(7<=Fncount, 0t, key, ov6try ovvresult(|"except OSError as excI ifQ.wine(Hin (ERROR_NETNAME_DELETEDzGOPERATION_ABORTED:raise ConnectionReset(*exc.args:NelseP< W)WX acTD_pip[  TF(F edE#v.`NamedPX!if$Zected#XED) failed  @PIPENECTED which meansg# that the 6 iswp. Thereno need to wait for4 K`comple0 of LIion., gj Nree I(I`async SwaddressVdelay = CON_@INIT%AYwhile Tru# Unfortunately[0wayfdo an {5 to_W1# a. Call Create ) in a loop until it doesn'tb` NnJBUSY @ jYbreak$$! o raise ' )# ConnectPipe() failed with ERROR_PIPE_BUSY: retry laterEdelay = min( * 2, CONNECTBMAX_DELAY);await tasks.sleepA%) &return windows_utils.Handle(h1@def RR_for_r(self, , timeout=None):f@"""WSfor a-.Ra Future object. The result of the f!is True ilcompleted, or Fals( did not (D (on%).G5""" r ._m ,s22ccancel/event, done_callback/ofut = o;a,i# add_U`() canbe used becauseN may only# in IocpProactor.close(), whilD loop isYvrunningKJfut.* =sj2futr@s b, _is_fKEacheck_#d(@T ms = _winapi.INFINITEJelse0# RegisterForSingleO() has apolution1 millisecond,] # round away from zero to *at least* Fs|Gmath.ceil(g * 1e3 C# We reate ov so weC= ov.address @key Vcachex ov:overlapped.O V(NULLM 3LWithQueue("}Wiocp,F, msi'if# fzC6(ov,=scZPZ U wif f._source_trace\ ?del%B[-1]vpzmfinishtrans, keymm8P# Notsat thismeans thatWbshoulds9use#=* s types where a successful\\+noE1effJA So s0pro;@es aKll right, but locksGor semaphor5 not. Also note if the handle is # signalled and then quickly reset,Pwe maKturnCFalse even though we have not timed out.7 reJ f._poll() (self._cache[ov.address] = (f, ov, 0, finish_wait_for_ha)E_W def _register_with_iocp(ku, obj)::# To getifications oft@ps o is=ects sent to.K`compleB port, were must 2 " ifY@ in .&ed 2(&_overlapped.CreateIoC@Port4.fileno(),u'q0\O# XXX We could also use SetFileZ5NotFlModes(Ito avoidC@ding3sT F,op that succeed immediately.v, callbackVcheck_closed2# R a future which will be set g`result5thea# oper^ ww3it es. The\p's valu actuallyG3the Ued by&()Vef = _OF(RRloop=  ifsource_trace( ?del%E[-1] ifp ov.pen C#5has d, so no nto postpone]aawork. !an~ ak(is short cut ifNBNumberOfBytes, 2Keyg's h PostQueued9hStatusj:try=bNone, &ov-except OSError as eRbf.set_+[ion(eD/ls5( 60# Efif GetPR@() wU 0to O forn&)0ion/GeYh pto keep a referencehb# OVERLAPPEDect, otherwisWe memory is frEpWindows1 read uninitializedAuRElater. Not%atl#only store obj to prevent it from being garbage # collected too early.!self._cache[ov.address] = (f, ov, obj, callback)9return f def _unregister(W?!):E"""U! an overlappeddBect.L-*Call this method when its future has been cancelled. The 5canxalready be signa,` (pend/in the proactor@queue). It is alsoOqsafe if6mis never_pbecause6was)z6"""Uheck_closed(jL.]0ed.6bnd(ov)3get_accept_socketgfamilyBs = ".(#.settimeout(0svCpolli1W=Noneo-KMmINFINITE'el8:< 04 raise ValueError("negative "Jelse?`# GetQdCompletionStatus()\a resolu of 1 millisecond,# round awayzero to wait *at least* Fs Gmath.ceil(f * 1e3*if ms >= 5 # PCbig":-while Tru&sF = _.9iocp, msN>is YbreakY0l"err, transferred, key,  H>try"?S.pop(Y exfA Key}]2if Ploop.gdebug(,i_`ion_handler({8'message': ('")  ed{'OSb'unexp;*'))'herr=%stkey=%#x ?% ( )}#0peither @, orQis us'-f a pipLA"#  which shouldapavoid akA!ifnot in (0,cINVALID_HANDLE_VALUE:  _winapi.CloseHandle(key) continue if obj in self._stopped_serving:-Of.cancel(b# Don't call the back if _register() already )result ork#8H`overla has been 9led3elif not f.done()>tryuvalue =(transferred, key, ov7except OSError as e`bf.set_/^ion(eLP s.Nnd(f,?elsi B(>j R# Remove uned futures&ffor ov?-  cache.pop(ov.address, Non*J.clear()Adef (2,# is a sockebq pipe h%. It will be c>Ed in# BaseProactorEventLoop"zr) whichHmake anyDpending operations fail quickly.+\~"G(obj#if@iocpQ #yB :breturn^1# Cp remain@(fut0,T)'Alist"._ witems() ifkk?led`# Nothto do with@ W6pas8`isinstR_WaitF 9-# &Q mustUOl:3fut ]f *xc'91loo9?=+Guext = {'message': 'HlaOed',E ion': exc.  ':d+}sv_source_trace=,['7@'] =.Q.J2_r(context)  :# Wait until all cancelled overlapped complete: don't exit with running N8 #7)to prevent a crash. Display progress every second if theNloop is stilln.!msg_update = 1.0start_tim.monotonic()&next_msg = 1&+ W+while self._cache:5if M<<= r -1logger.debug('%rrM after closing for %.1f$9s',zM ,' -:  |# handle a fewqnts, or9out.v._poll(a%) $ results = []_winapi.CloseHu(0Fiocpr = NoneCdef __del__7)2le() class _WindowsSubprocessTransport(base_s_.Base('):{^z, args, shell, stdin1outerr, bufsize, **kw1 _B = w_utils.Popen(Q=n=t=z J=nhcallback(freturncodw.+@ess_o6ed(@5f+.Ractor.wait_for_A(int##c.)xf.add_done_ @SeleZEL=( JI !qPolicy(sDuDefault_"D_!_fMy = q1Pro- Oq& P? 3 = 4 """Various* specific bits and pieces.""" imz sys if.platform != 'win32':pragma: no cqraise IFbError(3u only')afpitertoolsdmsvcrtotempfile0war(s __all__ = 'pipe', ' 1IPE#ip' # Constants/globalHBUFSIZE = 8192 PIP .p STDOUT%ubprocess.STDOU T _mmap_counter = itertools.6() # Replacement for os.pipe() using handles instead of fds def p**, duplex=False, overlapped=(True, ), bufsize=BUFSIZE): """Likezbut withJ support and0notA."""Paddress = tempfile.mk (sprefix=r'\\.\\python- R-{:d}'.format:>os.getpid(), next(kA))) j#if;penmode = _winapi.PIPE_ACCESS_DUPLEX=.2acc,GENERIC_READ |CUWRITE> obm1, i$ =*OelseqINBOUND9  0Lo|FILE_FLAG_FIRST_(INSTANCEal?[0]QOVERLAPPEDH1Hflags_and_attribVP SC0xh1 = h2 = None 6try oCreateNamedPw/o$, J,8YWAIT,2:1, !20NMP0_wFOREVER3ULLz JFile2:, 0POPEN_EXISTING I6N'ov`vConnect9huov.GetOaResult)%preturn I!h2fexceptif h1 is 50QloseHb6(h1a?2?2?Qraise Wrra class L9"""5nA` whichvaguely j-object like.The IOCP evdloop can use these[rsocket F!s.\def __init__(self,HY"._\[?Crepr?79if :Z"f' (={9A!r}' 3P = 'cd,R3f''@propertyrdef handle(self)3: return self._handle def fileno()3)if/ is None![!raise ValueError("I/O operation on closed pipe")t9 3`, *, CBH=_winapi. ?not?h! =G6q__del__?, _warn=Pings. !GQ(f"un0d {!r}", ResourceWarning, ="A(()Senter .3xit-, t, v, tb7x.f# # Replacement for subprocess.Popen using overlapp s class ,(=y?"""g+.The stdin,1outqerr are or instances of Pipe.1"""CG__in.AargsQ0in=5 6out 3err c**kwdsvpassert  .get('universal_newlines'2.bufsize', 0) == 0]c_rfd =$_w 3err 3&wh2r 1 09ZyJPIPE2h1in_X(=(False, True), duplex= pmsvcrt.iB_osfV(oos.O_RDONLY:;els1%inq?outRout_r !, )7|#h(Kestdout.?==   7}# mSTDOUT?9\  25err.;try_uuper().,T 0std#, 8jexceptFSh in w]h'rh> if h is not None: _winapi.CloseHandle(h)+Uraise;elsKif stdin_whp Qself.+d = Pipp+_wwW_out_rX=outY@ Z?errZ=errZ@Zzfinallygkin == PIPE@os.c|(6rfdS BCwDDDf'''This module implements specialized container datatypes providing alternatives to Python's general purpose built-inPs, dict, list, set, and tuple. * named factory function for creating5 subclasses withA fields * dequevvV-like5fast appendspops on either end * ChainMapKL a single view of multiple mappingqCounterNOMing hashable object;OrderedDict ;that remembers the o.` entri&ere addepdefaultI~calls ato supply mis` valueBUserP wrWr arounddionary@easin`ing * MAList& MGG0StrO s^K ''' __all__ = [G'#',$er&4que ;', ] import _colle@Ts_abcheapq as _ 1syssys from itertools/Rc% &arepeat' (qstarmap) *tkeywordv$is,operator-e/eqpitemget~M/treprlibMrecursive_ 6_weakref7Qproxy. C trLW3 except IError: pass' else: _collections_abc.MutableSequence.register(db) try;Ifrom@ import defaultdict except IRError= pass def __getattr__(name)"%# For backwards compatibility, continue to make the Q ABCs # through Python 3.6 avail @smodule.CNote, no newg were added ing7=0if  nr__all__cobj = (0,J)W.qrwarning. ("Using or " '9' instead "hT>"of7 .abc' is deprecated since/3,S!an; 3.10 it will stop working",DoBionW, stacklevel=2-globals()[u] = objVereturnraise Attribute2(f'@ {__D__!r} has, {!r}') #<Q OrderedDb`<# class _eKeysView.1): Kreversed__(selfBRyield>%#._mapping)OItempfor key`(key, _[key]_ValueKYLink(object __slots__ = 'prev', 'next0key__weakref__'K#(O'ionary that remembers\ ern o'5# An inheri7JP mapssvQ od[i]=y'z# Setting a new createsz1 ataend of ved list#vg`inheri8>0d)vAkey/V pairX!ifD4not$map[key] =! = *$ ={4las 1ink,a,  = >,, =1ast2 Z" =(X=`A)h0del h?M-__3(00del4(y]2D3an exis?|T usesb1uto find0a whichW# removed[ @ predecessord3sucVnodes42RVzpop(key#_/_.  </ #AX#4 #JNone<1 = @ter__(self):# 'od.__iter__() <==> U(od)'&# Traverse the linked list in order.-root = self.__pcurr = U.nextawhile ais not$: Qyield$I.key9=Xdef __re@d__()U 4 $Aprev 8XY _clear) -> None. Remove allms from od..| s.__map.Cdict&!) qpopitem, last=True$''nd return a (key, value) pairnrionary.iPairs areC edBLIFO1 if is true or FVfalse&'';!ifvraise KeyError('hqempty') .i ^ ~IM_! ="I "P"OelseA M&o"_ "D 3key: Q4delmap[key]UA0 = C.pop7keytqVUv_to_end:Mn existing element toend (or beginn!-)R\S2doexmN Bs XPsoft_##_ F:KF4=  as)U.pk&as wP \8astG6firr,k = root  link.next = first .prev = soft_0 #DrootAdef __sizeof__(self):X = _sys.get rn = len7@ + 15# number of |s including Q`W.__dict__)X# instance jionaryF0+= N$ofGmap) * 2HFaternalF and inheritedS @hardXnX# objects? ;@}# proxy@areturn U`update_ collections_abc.MutableMapping.)@Akeys1"D.) -> a set-like!via view on D's 4"_OrderedDictKeysViewpOitem5 Io_valuen . Vj `__ne__ )A__marker ="()1popm,, default=4`'''od.0Qk[,d]v, remove specifiedH#the corresponQ. If4is not found, d is Ced if given, otherwise KeyErrorP1baised.d6''' h n (Presul5U[key]71del5 @4$ifJT.R xU(key)E[3setJNoneaInsertdqwith a zfH`0key0in 3QRc F1for[i^ ?d, else.:elfY$ =^]>@_recursive_repr(mU_q) <==> ;9od)[9 /'%s()' % .__class__.__name__,l3/%r5 _, list(self.items())) def __reduce__(self):'Return state information for pickling'0inst_dict = varsPu.copy()&<Bk in#OrderedDict()|P.pop(k, NoneIrelf.__class__, (), :1 or6<a, iter   #od -> a shallow ,f of odmn@amethodfromkeys(clsable, value=P''Crera new o> uionary with Q ZQB andTs set to.n&''l = cls eyGVB6Q[key]5lue\pC__equw, otherc'''od.# y) <==> od==y. Comparison!an=b OD is-sensitivzwhile c: regular mappingA%inC.$Pif isiQance(', ;0all(map(_eq,  GX___ior_]c.updat b"NMoif notNotImplemente %=B?new 8newrgY]B tryVp_collecus importd except IRError= # Leave the pure Python versin placepass #<Q namedtupleb: -_{ogetter.% = lambda index, doc: property(_BO(!)"p=doc) yP(type, field_ qs, *, rp=False,Qaultsy, modul2""""s 1subMadms>>> Point = namedtuple('Point', ['x', 'y']) >>> .__doc__ # docstring for the new classF_q(x, y)'X2p =\(11, y=22)Z# instantiate with positional args or keywordiW[0] + p[1]O Wdexable like a plain !33ND = p> # unpackKwregularMFS&22]0p.x,.yY# fields also accessiqby nameVd._asdict(QS# convert to a &P!ryId]!11N(**dSW XNfromZ@%x=Zp._replace(x=100a%# B) isiDstr.6) but targetsd5dz#00f 2""" p# ValidepGas. Atuser's op~, either gener8an errorY# messageautomatically Sh0a vz.IRif is1ce(0_s, str):%~" =)$ ', ').split( 8list(map(str,F).@type = _sys.intern.("))SAif r,seen = se}or index, in enumU7qif (not4.isidentifier$cor _is&( "orK`startsjO('_'( JR[]1'_{ })DC.addAd[WZU0if $A6str"hraise TypeE (' Cs an-pmust beaGings0if ^ tnOValuo  &f'@s: {:!r} (0canb#b  . [%vF8start with an underscore: '  f'{name!r}')*0if  in seen:Jraise ValueError(f'Encountered duplicate fieldI/: eZP.add(k!) d3_defaults = {}5if is not None= tuple( 6len0 > s&s)P3Typ'Got more vgs thansJ^ = dict(reversed(list(zip1,Yr)\# Variables used the methods and docstrings{ Ymap(_sys.i"n,_nAnum_; dY@arg_ = ', '.join(3I&K6= 1B+Crepr_fmtVH(' +\}=%r' foru2)KED_new ._!___1, _&, _len, _map, _zip,,g!, 4zip0Cre%@all Rnamed1to be addo'QclassRspaceM<10'"':Z U'__builtins__': {}V f' d`_{type"}'.code = f'lambda _cls, {#}:-(()vd = eval(U,]$Pame__ a.__doc #f'minstance of Gshmz@c0def*1ke("@iter{Presulq;new+H!if{(2V) != {++f'Expected {4} arguments, got {_!rreturn _make.__func__~(f'Make a s object from a sequeD'or 7'8Vreplace(self, /, **kwd0 = #.(((I.pop,')w0if )Z (4uneac0: {p)tS MR| Oobject replacing specified '  'fields with new values') 3def __repr__(self):N 'Return a nicely formatted 1esentation stringr9P.__class__.__name__ +@p_fmt % %oasdict0ew " which maps  ]s to their._>Q(_zipe!._>!s,)getnewargs as a plain tuple. Used by copy and pickle2}# Modify func`metadataBhelpPintro$ddebuggingfor method in (__new__,pmake.__p wreplace*+_7Up.__qual__ = f'{type5}.{$B__}' # Build-up WApaceaionary#v@use Z ()<b@=bresultD/NsN1= {1'__doc__':({arg_list})'.Qslots0(()kGn _defaults(+=':  '_4    # *}Naindex,enumerate(1 doc = _sys.intern(f'Aliasqumber {[1}')l [Q]Ouqgetter(6S, docr=:?81, (62,),8.8R# Forto work,qp__modulvariable need`be setthe frameq# whereAd_ is created. Bypass this stepUvironmentsDPGdHnot defined (JythonYexample) or 5P;Bargurgr than 0 (IronP\ ),Quser hasOa particular ;.%#ifFNone6try 8 (1).f_globals.get('', '__main__H except (AttributeError, VM zm k.=J't #########, ### Counter P,? def _cW_elements(mapping, iterable): 'Tally ( from the(!.'(@s_get = A.get1forC5 in9`d.[e]>L(, 0) + 1 try:2 # Load C helper function if availa_colle"s import! except IRErrorpass classT(dict@''Dict sub$ |ing hash ms. Sometimes called a bagor multiset. E are stor, s zionary keys and1ir tsJ3values. &u>>> c =`'abcdeabcaba') #WGa 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'{# updatesI1...cA+= 1# by add1 to each"'s`N!c0now"reEeven7Hdel c['b'# removeg"'b5*# Tzero A0dZsimsalabimUG # make anothe%er"c. (dv2 #SbsecondJDLEnineK9c.clear(%Pempty"()UNote: If a1p is setPor reducedP will1ainW(inta untilPentryUdeleted orP er2ed:aaabbc')hM-= 2  # reduce the count of 'b' by two ,>>> c.most_common() #5is still in, but itsWbis zerQ[('a', 3), ('c', 1 b', 0)] u1'''# References: http://en.wikipedia.org//Multiset.qwww.gnu)software/smalltalk/manual-base/html_node/Bag.Mdemo2s.com/Tutorial/Cpp/0380__set-m/Catalog] \code.activestatebrecipes/259174/4Knuth, TAOCP Vol. II section 4.6.3Qdef __init__(self, iterable=None, /, **kwds)i '''Create a new, empty C+ er object. And if given,elementsMfrom an inp~p. Or, Xializ2other mappingO4of c0 to"ir{"s.u$ =&#%erq K'gallahad'13er tU{'a': 4,QH: 2}[ U  a=4, b=2K/ Skeyword argsJ;super().R)\.update(bZNumissing8keyzT`not in [.1# Needed s0at [pitem] does Nraise KeyErroreturn 0Q1, n:a''List n 1 30and/F7P leasg@If n`then lp4allb ('abracad)')352 Tr', 2h`# Emul*3sortedByxSjisY}F.s(), key=_pgetter(=reverse=TrueF_heapq.nlargest(n,R )z I@tor overs repeating each as many times'ABCABC'%c.)!b['A', B C C'] 6# Knuth's example for prime factors of 1836: 2**2 * 3**3 * 17**1 2>>>8_8= Counter({2: 2, 3: 3, 17: 1})9oduct = 1O: in_.elements():# loop overL1...$"prh#*=## and multiply themLH  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 semanticsKwould 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 NotI edError(O'Dundefined. Use instead.'pupdate(, /, **kwdsb'''Lik.=) but add Yif`replacqSource cann I,2tanotherGanceO&c z'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?the other counts for a mismash that 2# doesn't have a straight-forward interpretation in most countingJcontexts. Instead, we implement\@addiN`. Bote inputsOpand out are allowed to jain zero (negative5s. H if iterable is not None:! %sinstance(0, _collecs_abc.Mapping)?CNselfp_get = 6.ge for elem,m.items(z=Z[>3] =@+oz(I, 0);;els# fast path whenU erH]emptyL6super().updatM yu_U_Pents(,Bzif kwdsl-u)def subtractQ= q, /, **2Q'''Like dictUU) butLs s 7ead of replacing them.C,s can be reduced belowK#dSource%anT1, aionary, or another Tt>>> c =#('which'!.w@'wit #KU from VA('wa^)[Vc*erUP['h']?0# 2, minus 1 ]0 ?['wg UM Ug "-15'''u8"E,& " -ZX8fs 1oWAcopyp'Return{h &.r .__class__FZ"__W: return self.__class__, (dict( ),) def __delitem__, elem):!%`'Like =.,#) but does not raise KeyError for missing values.'R!ifd1 inkoysuper()lCrepr!if Treturn f'{.__name__}():try?#() preserves the order_ed by most_common()2d =H ()except TypeI handle case where^A areOable|n r{d!r})'}&# Multiset-style mathematical operations discussed in# Knuth TAOCP Volume II sec9 4.6.3 exercO!19<and at http://en.wikipedia.org//9% Outputs guaranteed to only include positive counts.: To strip nega&Czero/, add-in an empty*er`c += Ca] Rich comparisonM2orsKw subset ) StestsGbely omitted duesemantic conflicts withBPexistainheri<ict equality method. SDfs ignore +require that p≤q ∧ q → p=q;Mhowever,-Qwouldb? o$p=Za=1, b=0#rq)<ionariesF.%3addqw, otherxb'''Adds from tw3ersH5>>>'abbb') +Bbcc'- {'b': 4, 'c': 2, 'a': 1}+&''isinstance(,g;NotImplemented{\sult t,.L+s(f1newY# =.+F[B]oX.2> 0B re:4 = [E1*~PB?subB ORtract!,_BkeepP ~ >>> Counter('abbbc') - Counter('bccd') {'b': 2, 'a': 1}) #5''' if not isinstance(other,`%):+areturn NotImplemented"result ==(for elem, c in self.items(f2new&=.!- [B]o.:> 0!:4 = [El!if4C and<20 -.Tdef __or__(&,&'''Union is the maximum of value` ei"RinputzBers.h!5>>>`F') |?bcc^_3, 'cf_i'1" =1"ifL) <Belse Ez'?and IHsect$incorresponding7 &|Yg   S. 3pos Adds an empty^0effvely strippnegativeSBzero1s%b/; 8?neg''Subtracts from @. Sls posiunts,  and flips the sign on negative counts. 5''' result = C&Eer()for elem,B in self.items():)W#if&:< 0f[Nr] = 0 -.Crreturn (def _keep_posi(x '''Internal method to stripents with aror zero 4noni1 =   r if notLU > 0]:6Z 1delSm<  q_iadd__|, other place add from an&@er, Ning only W>>> cf'abbb' +4L'bcc  Y {'b': 4, 'c': 2, 'a': 1})'A~,F2 +=O.Q|k__isub`ssubtracX1but\Yzf G* -gdh`G-`&/or_runion imaximum of value ei'er2|!3_`$="ifL> M(=2 /anliHsect$incorrespondw&"Y7vRgRw <D$ ############## ### ChainMapD2u classY(_collections_abc.MutableMapping): ''' A5 groups multiple dicts (or other m=ps) togeF to create a single, updaterq view. *The underlyingP are stored in a list. That  is public and canObe accessed ort0d u the *maps* attributeT0ereP"noJSstate@LookasearchH!su{ively until a key\afound.ZIn contrast, writes!s,Adele only operL!on{QfirstJ~2'''Tdef __init__(self,Initializ by sett+!tovUgivenJUIf noprovided,a empty>QionarCusedI.! =( )@[{}]"# always east one 0mis 7key raise KeyError(=getitem=%foLZ tryUreturQG[key@ #'t use 'E-' with defaultVeexcept{Epass2&__, N# support sub[@es twdefine =A3getDkey,X=None  "if8 n T else<\S__lenMlen(set().union(*JT!))# reusesghash values if possiblepNiterqed = {}Q reversed "d.(.fromkeys3 8(d)zCains,h=0any !m BRCboolNI 7@_recursive_repr()<N1f'{M!____.__name__}({", ".join;(H,>t3)})@<emethodywPcls, 8w, *args$'C2with a single dict created from the iterable.' return cls(4.,Tkeys(,, *args)) 4def copy(self):K'New ChainMap or subclass with a new9 of maps[0] and refs to=1:]i1.__M!__x.A.A), *%31:] __A__ =ynew_childM, m=None):# like Django's Context.push()' map followed by all previous.FAIf n is provided, an emptyvis used6&''0@if m=em = {}k4YmGC@property<qparents:2m<(op; 6|N[1:] __setitem., key, valueO30][key] =$)\__delJC:tryiMdel X<except KeyError;Uraise(f'Key not found inPfirst$ping: {key!r}'0pop|s'Removes anbm pair$9. RU  `8.70'Nos .p Y*key* 2its"f ; in ((&Qclear% 'C, leaving1:] intact.TU__iorWothern <rupdate($ KUiHt isinstancS, _collections_abc.MapFrNotImplementedJ[m mr; return NotImplemented m = dict(other)for child in reversed(self.maps):*Im.update(3F|7__class__(m) #<Q UserDict `:! a(_collections_abc.MutableMapping): !# Start by filling-out the abstract methods0def __init__n,=None, /, **kwarg^data = {}G!if; is not B 82if f1 )3len1len. 6sgetitem:W, key? ey> `X[key]rhasattr~, "__missing__"r;U3.1Nlraise KeyError(s , | ! = E0del3-Jdel C<Citer9s# Modify __contains__ to work correctly when sqpresentCi>k# Now, add;2Qs but:in ?repo6", $if isinstanceB,#eTs" |^2b^#o /JJ& |+^Yi47 |=bFelseJ2-"Ncopyinst = self.__class__.__new__(self.__3) inst.__dict__.update-,!# Create a copy and avoid triggering descriptorse["data"] = h.\(vpreturn  R1def!):$ifQ is UserDict'+TJ.}~aimportpi) :tryh#U = {}(1c =Vr)uofinallLSNcEc5@amethod:Ffromkeys(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."""c__init , - VU = []%if2#@not  # XXX should this accept an arbitrary s?]if type(B) ==Y2 [:4= Z els 6ancb,Y&[:Jelse ! =Creprh)8l^other=<Bast(/ Le", LcM/eqM=M g> g> 3J/ | ?ycontainsNNitemMnD3len?9len(self.data) def __getitem__(self, i): if isinstance(i, slice!(preturn >.__classM.data[i])QFelse_ >/ /s , x:! =A0del1 2del?85add4Wothers , UserList( 1 + @+(dAtype/k#f + list(())rKr& +/el6kf 7i57 +=)k^ "UP  -3&"5mul@n/.C * nj1__rEQ = __ `i (, aO*= n Ccopy" =zc.__new-6.__dict__.updat,# Create a  and avoid triggering descriptors e ["&"]}5[:]9y@HcappendF(I.& <dinsert<.)i#B4pop?7=-1{*iRremov]VV6& Qclearxr5l /!%Ecoun 7temo@., QindexV, *argsH 3H-reverse(self):  self.data.reverse() def sort(", /, *args, **kwds):&*!C0 'McextendOWotherDif isinstance(, UserList( pS/)Felse7_) #<Q`Stringb:w classc (_collections_abc.Sequence):__init__7seqZ xseq, st Dg = seqn?gF7[:]Nx0tr(3strk`returng___rep78$inEn"in2nOfloa8pcomplex >Ohash;8`getnew>:I[:],\#eq6G7ing+ ,%/0 ==1inge7(+l@<' e0G<0(g0H>0' 0H>0(contains8chaG 0 = E in 3len| return len(self.data) def __getitem__ , index):"&qreturn =s__class,L[0]S3add#w, otherOif isinstance(, UserString*}" +`)/elf(st_Z  b + str)rCy 6?5mulnQzC * n1__rEQ = __ t&mo!Oargsc!% 1NrOtemplateS5tr(-! % # the following methods are5 ined in alphabetical order6DcapitalizeWD.:CcasefoldO8 MQenterK, width, *X=D >@Countbsub, start=0, end=_sys.maxsiz 7sub = sub ".cremoveprefix 7, / "!2 = S.A6suf  "!SY!C(Rencod coding='utf-8', errors='strict'v9#= .E if is None else W4 = Y<l :8Cp!e(4ingEendswithAnLF8drxpandtabst Vize=8? return self.__class__(self.data.expandtabs(ize)) def find-, sub, start=0, end=_sys.maxs5:48if isinstance(7UserString)(,Psub =[Cvreturn Sormat/, *args, **kwdssX9 0C_map\JmappS4.QSindexLQ cFqisalphah (J?num;( ;Oscii;( ;decimal=* ?2igi d( ;identifier}- E?low@( ;numeric}* ?printableA, C0spa?elf= ( ;?titz( ;?upp3(;Ajoin_, seq *q=Bljus)s, width-G2C =a  S5yTlstrivchars=NoneB<Zmaketransu5tr.partitiocpu?/pDreplV, old, new, /wplit=-1W 3.3Pold =R 3 ClCPnew = Chb`3r?elf4l(sub, start, end) def rindex(self, sub, start=0,)=_sys.maxsize):6:preturn 6d.data.GA?hCjustgwidth, *argsU__class__3dC =apartition3_, sep]0pISstripEchars=NonB<)ZDspli1sepW , ^?=-1 =p2[r\>]\Slineskeepends=Falsf;5kSswithYoprefix$N H !, |A; qwapcaseO8MOtitlJ5 GrranslatKtt@_upper5QzfillG!, :<6) from _collecs_abc import * __all__% CallableGenericAlias # This directory is a Python package. # Copyright 2009 Brian Quinlan. All Rights Reserved. # Licensed to PSF under a Contributor Agreement. """Execute computations asynchronously using threads or processes.""" __author__ = 'Brian0 (b@sweetapp.com)' : concurrent.futures._base(FIRST_COMPLETED,RV7EXCEPTION7?ALLlCancelledErrorkTimeout4InvalidState9bBroken Future?, Executor0Owait, as_completed) __all__ = ('FIRST_COMPLETED'XEXCEPTION>ALL,CancelledError+yTimeoutdBroken*dFuture ProcessPool;kThread) def __dir__(): treturn  + ('__author__', '__doc__'@`getattDCnameHglobal .,  |0if B_ == '9'Krfrom .p importla as pe]7U( =!.pe th1t!'= traise AttributeQ(f"module {__<__} has no * {}") # Copyright 2009 Brian Quinlan. All Rs Reserved. # Licensed to PSF under a Conor Agreement.]1I = 'd0 (bs@sweetapp.com)' collectionstloggingd5imekypes  '$$)' " V' _AS ' # Possible f states (for internal use by th's package). PENDING_ c' RUNN U' # T@d was c\user... CANCELLEDT B...and _Waiter.add_F#()VSa workerQ_AND_NOTIFI^ ~BNISH$"FI ' _FUTURE_STATES = [   ogB ] a_TO_DESCRI_MAP = {s: "pending"F~v: "runn5: "34 ): "finished" }GLogger 6. LOGGER = >B.getD("concurrs") class UPExcep"""Base $3all-related e5s.""" pass class CancelledError( ): """The Future was c-A."""$pass clKqTimeoutCIoperation exceeded the given deadlineZInvalidState_ is not allowed in this s?`_Waiter(objectProvidesevent that wait() and as_completed() block ongdef __init__(self^a.W= threading.Ei!()`'finished_fqs = [] $cadd_resulte", ' m F.append(. PpS7AS+pD_AsC{"""Used by<^uper(f , %).8 jLock()] Awithf.M s  7uL.set-a>-a_First= return_when=FIRST_COMPLETED)').* :(sbe \( -?All-EXCEPTION?ALL@num_Hing_calls, stop_on_/5.4= = 3 T. =h 3? Lock() 0 super().__init__() def _decrement_pending_calls(self): (Pwith V.lock:numBQ -= 1h$bif notF / S/Wevent.setadd_result, future*$_#Dexceptionq- t"ifstop_on_* Oelse+cancelled- t class _AcquireFs(object"""A context manager that does an ordered aFB of J7 diWs."""sq?.s = sorted(, key=id__enter__0I3fort2 inF R._con.A__exh, *argl'preleaselcreate_and_install_waiters(fs, return_when(if == _AS_COMPLETEDG sCompletedW\!()r.elM_FIRSTO _FirstR @ount1um(yf._statein [CANCELLED_AND_NOTIFIED, FINISHED] ~#fsMEXCEPTION/,ll -, R=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 /0eactcollection of sets *ref_collect*. 4The aim of this function is to avoid keeping stale references afterHthe future:yielded and before !iterator resumes.;1"""while fs:f = fs[-1]#orhs_set in;?(.remove(f)Jwith f._condi =@._was<AUdel fO# Careful not;5 a.popped value>1 fs.pop() def as_completed(fs, timeout=None)`"""An YAoverkTgiven*a that ds each as it ^s 8Arg~0s: @sequ$FS (possibly created by dift Executors) to e pmaximum numberv seP. If ,nrKPis no limit o! 9AgReturnG0N assy? (finished orcancelled)Kany Gre duplicAy will be%edODonceGaiseT`Error:PentirHFsult!Qcould`be genf=!ifN0outF@end_9% =(+ .monotonic+@fs =2(fs^btotal_O5len_AcquirezUBk0f fE;f ifPstate"[CANCELLED_AND_NOTIFIED, FINISHED]?@pend't= fs - ber = _5p_and_inVlm_AS_COMPLETED`Mu = listr6tryq from _ _=S>,5er, F="))K7  1 - "6W= JelseV6z-p/!ift>< 0`1rt j($'%d (of %d)$unO' % @ G9), ps5er.event. (wait_timeout)7 with waiter.lock:)finished =(_futures3P (_ = []-event.clear()# reverse to keep Zing orderT3ed.5)()yield from _ _1(,,A ref_collect=(fs, pending)vfinallyl# Removeq$un ifor f in fsEf._condition#2f._1s.ru() DoneAndNot F3 = ions.namedtuple('/ 9', 'done not_ a') deftimeout=None, return_when=ALL_COMPLETED)"""Wait 4thegiven sequenc*complete.N7Arg-vfs: The14of (possibly created by different Executors) to[Ie upon.mmaximum number of ses=R. If then thereLcis no limit o!P hvL: Indicates \ this funcs should}. op Bare:GVFIRSTA - Re3anyzes or iVH cancelled!mEXCEPTIONmpby rais#)anBP Aexce$noAees an "J it is equival19to  J - I#llsJHGare +!A 1 2-o"tsfirst set,&', contains|X,d that X0d (J&or) beforeEJ= .%un8JM1"""_Acquire3(fsC =r!(fLH?!if f._stateg[CANCELLED_AND_NOTIFIED, FINISHED]kkPs) - |FGif (B == A and66 v(e,t elif (return_when == FIRST_EXCEPTION) and done: if any(f for f in$ #.if not f.cancelled(Uf.exception() is'ZNone)kH re DoneAndNot Futures(,>_ %) aif len ) +fs_[#waiter = _create_and_install_bs(fs, __p.event. (timeout)Q&fswith f._condi2$f.t.remove(X#errd.updat.finished_fE|g set(fs) -) class s(objectb """Represents the result o= asynchronous computaB."""def __init__(selfY"""Initialize^. Should` be catp by cli`CVW = threading.Cm(0state = PENDING =   ks = []:_Cback"#&finvoke /V= T T:tryC_$ E=gLOGGER'41ion1ingXP%r', Nrepr", !ifL#._jNISHED(,$(r'<%s at %#x ^=%s raised %s>' % (-<_H__.__name__,1"id"_STATE_TO_DESCRIR_MAP[m]@&-._;els$% A'$!  RIPTION_MAP[self._state]) def cancel(!):A"""C the future if possible.A+Returns Tru#13was`led, False otherwise. AZwcannot be7vit is running or has already completed.G5""" Pwith ._condition#if  in [RUNNING, FINISHED]37rQCANCELLED, _AND_NOTIFIa X `=P$.notify_all(&invoke_callbacks()K3?led6 .KV9>is currently executing/3== bOdone (of ]finished9f'__get_result!^excep?trypCaise8ofinall; # Break a reference cycle Rh ei u = NoneJelse  @add_v$J, fnAttaches a able that will)lled when sJArgs_fn: AX ?Cthis as its onlyargumentsV\pled. Th ll Qgalwayspby a thsame process]whichO0it 60addzIOSMbeenJ6ytyimmediatelys44;Bs ar edRorderthey were Mndition:  if self._state not in [CANCELLED, _AND_NOTIFIFINISHED]: MR done_callbacks.append(fn)0ereturn:tryT0fn(S9except E:ion/rLOGGER.%Uion('  1ing for %r',!) def resultx, timeout=None)mA"""RC the21 ofiQ thatPfutur#presents.j2FArgsTo: The numberWseconds to waityiykL`isn't P. If ,nre is no limit oe 0[RaisePCancelledError:Ud was c".T70didfinish execut `beforeV give::outj{rdMC6at zwill be #N5""" Awith ._-it K (y#+elt4==  .r)r.__get_2(t$%.(/ OelseD^ kfinall: # Break a reference cycle ZV#ink! =:'+*5 0 by34T7 m7$ OGd2 orVcompleted without raising. uRaises:CancelledError: If the future was c".9Timeout7didn't finish executing beforeaYgivenQtUj6"""with self._condition#if state in [CANCELLED, _AND_NOTIFIED]C;*e )()+ell== FINISHEDQSeturnPexcepu c.wait()+ {Oelse  S(0# TPollowCmethods should only be used by Elpors andRtestsP det_running_or_notify_()q"""Mark3as > or procesky& Q0icas{S implement:Sunit | has beenSled ()Or%edKPTrue)n any threads xj on  co(though callsNcto as_'@ed()"Ls()) are!edFalse is , 7notpthen it>1put%he(4 to's() will 3 ZRThis !be | jwork associated tk.{yKP8#be'eddR  JiF,) otherwiseQ P0Run#X als=1or t_resultsCuor set_CA'7Q6&==*KJf ) S11forX erC+er3-C.add2led \#Wcondition.notify_all() is not necessary because # self.cance9triggers aAification.9return FalVBelifU_state == PENDING:F}( RUNNING&l:TruNelseTLOGGER.critical('Future %s in unexpected m: %s',s '@ id()*'.)Wraise RuntimeError1') B deRt_result", )"""Sets the rvalue of work associaAwith)f.hShould onl5 used by Executor implements and unit tests(1"""TnPcondiR" 3in {CANCELLED, _AND_NOTIFIFINISHED}MQiInvalidSn{}: {!r}'.formaN,)n# =wl"N4 = #for waiter1sH.addNE.notzhinvoke_callbacks(VPexcepY\VjA as beingUegiven H^+& =7dL}g>__class_getitem__ =  method(types.GenericAlias) !us(objectp"""Thisan abstract baseY nconcrete asynchronous e s.b]Bubmi , fn, /, *args, **kw }i1&Wable to bea1ed ! @argu6s rcheduleIlas fn(xreturns a Future instance representing the execution ofcallable. Returns:A\ S`given H.25""" raise NotImplementedError()tdef map(self, fn, *iters, timeout=None, chunksize=1)3"""A an =tor equivalent toc]);ArgQfn: A that will take as many argusthere are5bpassedFbles%: The maximum numberpsecondswait. If @thenris no limit o% =J ~NXv)bbe broken intobefore ber to a child process. ThisC is onlyNu;Bby P7QPoolE`or; it8ignored b>hThread51EA>:?8uncQ) but$ be evaluated out-of-order T&:rBsultcould not be genern JIz.*PExcepvfn(*args) `s for !ifi!ou g@end_% =,+ .monotonic`fs = [.submit(rgs in zip(<")]`C# Yield mus)AhiddP clos4"so"fG"e r5ted)'# MGfirsr}6red` re_ at :trypreversekeep finishaM.3fs.3-(){while fr7# CarefulR1to qa refereSt(e popped * eK $yfs.pop().'0Nelse&Jq-g "ofinallgi?" .c}lrS shutdown=True, *, P_^ss=False """Clean-up the resources associated withExecutor. .It is safe to call this method several times. Otherwise, no oJ2s can beKed afterS7oneyUArgs:=wait: If Truen shutdown will not return until yrunningJNfutures have finished eping andd2pused by N8"orObeen reclaimed..scancel_ +Opend3. Fthat are comple3or ')benl5"""'Bpassdef __enter__(self) .3xit-, exc_type 2val 'tbHA.(=)iFalse class Broken (RsmeError\0Raicwhen as become non-functionalae failureU# Copyright 2009 Brian Quinlan. All Rs Reservip# Licento PSF under a Contrib Agreement. """Is ProcessPool. The followrdiagramext describC data-flow throug system: |=R In-p} "|== Out-of(U| +-+v   "-31+ |E| => | Work Ids 0| CQ5|H+ |P -}# G #0| !PP| ...{H "ka c 6;?!5,oB() | 5| 7 X  ! L .(t| Local@LP. #er" | #1..n P).oThread"Pk"- -"! #1| <P Item <=Result Q $<= | | P |7 +-+"! 6 | P| 6: call()c$ Q| ...i!P future/i| 4, resultP ~/P3, excepP/ @$" -+ Executor.submit()=6ed: - creates a uniquely numbered _WorkItem and adds it to the "Work s" dict -#Qid of'D 8ds" queue Local worker threas ids fromRyAlooks up"corresponding D3tem2: i ihas been cancelled]0n is simply removed , otherwise.repackaged as a _Call@`put inb " Q". New'os are ( until9 is full. NOTE:UDsizea(ksmall because s placed no longer be awith FI.6b(). - !_RA" Q", upd?0sto3 :@dele9| entry Process #1..n^e'!es0_!s,a2putT 6in  """ __author__ = 'Brian Quinlan (b @sweetapp.com)' import os concurrent.#s "T_base/Ebmultip0ingk$mp* .connectionq ZuQh rweakrefIfunctool<tpartialAiter 4sys traceback _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" ") def clear(self):pif not ._closed!Swhile reader.poll(D'E%recv_bytes() _python_exit@global __shutdown q = Trueitems = list(_thvs_wakeups.1())+rfor _, $#A in %a# callprotected by ProcessPoolExecutor.Q_lockf c.(Ot, _y`t.join&# Register `1q` to beed just before Aing all # non-daemons. This is used instead of `at#.ry0()`|0 # compatibility with subinterpreters, which no longer support ~ # See bpo-39812b context. 6Ting.__( ) # Controls how many ms than ppes will0Aqueu2 th> . # A smaller number50mea;'atNRspendntime idle waitxfor # workle a lar W ake Future.cancel() succeed less frequently # (+s3 @ can Hled). EXTRA_QUEUED_CALLS = 1 8On Windows, WaitForMultipleObject!toMto finish6 It'on, at most, 63 oOr0eresan overhr4two%Q: # -bresult eQ  O_MAX_WINDOWS_WORKER`63 - 2@Hack1embed stringificationremote traceb-in local class _R,T+`(ExcepIq_init__bC, tbqtb = tb.13str0,breturnr%tbsEWithN ;exc.format_e(type(exc), =<"''"tbPexc =505\n"""\n%s"""' %oreduce_rebuild!, Y.`)X'exc.__cause__ =v5excrWorkItem(lf0, f rgs, kwargs2((2 = . fn2F0 =  .a# =jResultItem(objec+t): def __init__(self, work_id, exception=None, result >B5.4$ =>]J& =V #]# =f class _CallItem(objecfn, args, kwzfn = fnH! =W c# =l SafeQueue(0""" F set to the future p linkeda job""" max_size=0, *, ctx, pending_tems, shutdown_lock,Nthread_wakeupQ/ =fV5 r* = + }9 = +uuper().a=ctx) -'@on_q_feeder_error e,iif isinstancet,' tbraceback.format_(type(e), e, e.__t+1__)Ecause__ = _RemoteT.('\n"""\n{}"""'h(''.join(tb))OkNelf.@.pop ,  GNith 7$ .=(Q#tem can bev if another process terminated. In this2q# case,0executor_manager_ fails allw EwrBrokenPzIPoolj&if?q is notw.8.see Jelse@s1 get_chunks(*iterables, 3izeP""" Ites over zip()ed 53 in7$. [Ait =*\while TrutPuple(Xtools.islicG7!ifI> Vretur}Ryield$(GBes a; ocR passUBmap.+ARunsP@func &X() onP1the) /UUThis Q`is runta separate1` [fn(*|Q) for?]@send_C(result=None, e.xception=None): """Safely send back the given result or e=1"""92tryBF(_queue.put(_R:Item(work_id,N=-,F= x= !));d BaseEV as euexc = _WithTrace(e, e.__t"__Y Rexc)) def _process_rer(callJinitializer, FargsEvaluates Cas from @ and places4s i'!. /RThis p is run)a separate /FArgsIN: A ctx.Q of _Callat will be read}SeAd by.%kUmuwrittenDi/tobgtqallable,$S52PtupleA for"?6'(ifZz@not ]^ KM (* kw NA_base.LOGGER.critical(' X0:',_info=TruelN# The parennotice that<~ stoppeR# marYpool brokRretur`while gitem =.get(block"if&2+isqWake up  managem th* os|Cpid(& rU.fn(*.7, * kw v'>_ #_(,Y. :7els[#|&=rHRdel ra# Liberesource@soonpossible, to avoid holding onto# open filesshared memor$atAneedUymoreA classqecutorMh!rTd(kBing.(e communica between tz $eres. The manager is run in a local thread. Args: executor: A reference to the ProcessPoolE( that ownsCGDthisg A weakref will be01 byTmas well aIsinternal objects usedqrospectUstate of$e .2"""def __init__(self,*)v# Store neDary As ofnoa# A _T`Wakeupallow waking he queue__P fromZORmain Q and avoid deadlocks ca$by permanently2kedes .l"_w= $._ +Fshutdown_ F |(.,t hEUsed#Ydetermine i has been garbage collectM[ can exitA`# When -^ gets\,% callback,  |0men sQat it7ateL re pno pendkwork item e_cb(_,F &= 9 9 qomp.util.debug('x: triggerH_ for'` ' Q`M}gIup')2Ywith   .G&() _$ =(!,7_cbEDlistWCctx. instance F\orkerp)esma be filled _CallItems derivedAr# _Work"Cfor k _ bSimpleof _Resultgeneratedx~ r; .~ ids e.g.n([5, 6, ...])s$/O_idss odict mappR#mto _WorkItemss e.g. #{5: <_WorkItem...>, 6E...}:self.pending_work_items = executor._ @uper().__init__()def run(`%):/# Main loop for theip manageRread.Iwhile TrueJ].add_call_to_queue'aresult$, is_broken, cause = KSwait_*!_or_wakeupQ&ifG oOterminaten(m) )ireturn3if  is not Non?ltprocess6(Bu# Delete reference touto avoid keeping*s"# B+con newOs,3del# attemptincrement idle m count_(&ifm R ._6er_semaphore.releas.> "ifis_shuttWdown(=JTflag_L 4 \8@# Si0no  %s can be added, itm1saf e# this th0 ifre are no 1 f!if0JsR-Fjoininternals3r\.Zj`# Fill"llPe with ]ds from0# T#afunctiver block7_.full>tryB4_idsQ.get(j=False#rexcept OEmpt_?elsy4tem[$.d]!ifW'.future.set_runn5or_notify_cance2'.^put(_Call<(,8/;/fn@+HargsB  work_item.kwargs), . block=True)4]else:?del self.pending_"s[ /d]9continue def wait_result_broken_or_wakeup(d)# Wait for a 4 to be ready in th Nqueue while checkingw# that all er processes are still running, orv7 upHPsignand. The # s come either from new tasks besubmitted,*executor- shutdown/gc-(U8the&1 ofpython interpreter..I_CBer =D.2assert not- th=._closed.#upD` 3@%er3Ss = [,]Md0_se_!el:$p.pQ..values()Ihy = mp.connection.(Sers +2n)Xcause = Non#is0 = k 4f9"inp:try4Wn.recv(FFalsQexcept BaseE ion as traceback.format_Dion(type(e), e, e.__+'__J0eli `Bwith7_ 2 gclear(Pretur%, x!, a, P}received This canO 0PIDa#exited gPfullyAa _RsBItemif isinstance(8,:-u# Clean{using its PID7(avoids mar o0is_tu p`hes.pop [kp.joinE&ifH 4?__`KnalsR/C ]6# RltItem so mark the future as completed.  work_item = self.pending_s.pop(result*.d, None)O"# Qacan be% if another process terminated (see abovN'ifOais notO:t8if exception*.. U.set_4  FOelse` ]!) def is_shuttPdown()e# Check wheLwe should start = =executor_reference(# No more )#s added if - The interpreter is!ORD$# 2 that owns thisxer has been collec6G**%return (_global"E or !is$.:w_threadb_brokey, causeT 1 be+0 itVRin a I1te.|## argumentused to displaypinforma42 onvArrorMBleadYoSoming.C# MaCpool)1 sob submits fail right now)if7B. = ('A child''abruptly," Eusable anyx'sey = True-" =c# All  tasks arebe markedqed withfollowingGBPPe5"mbpe = &5("Abim -Uwas "E"N$d zb whileL@runn$or&."{"ifvNabpe.__{__ = _RemoteTraceback(f"\n'''\n{''.join(>c)}'''"4A *for work_id, w ork_item in self.pending_w s. gs():  .future.set_exception(bpe)0# Delete references to object. See issue16284:Edel nclear() )# Termina|qmainingQ ers forcibly: the queues or'irDlocks may be,a dirty stXPand b#PUever.;Pfor p2rocesses.valueV4p.t n up resourcesbYjoin_executor_internalsEdef flag#PshuttPdown(D`# Flag TD as 4 4 cancel reXtasks if# requestedCPearly possible if it is not gc-ed yetA=_I(j4if SJNone" .__thread = True2# C: 6"._%_A_0s5kCall . .n0updn K\nly haveEthat are currently run C5newms = {}o$!d,!T#w!if R4temcI 2[JFd] = ? = V As# Drainc1ds_O since we no longer need toB3add]!toc IQwhileM?try.get_nowaitT-(_.Empta_breakMake surd@is oo)"toaste time loopingK$on$ pZQ over/ 5Ojr= FalseB9&. 0):6for i in range(4d< - C:tryX call_queue.put_nowait(None)1 q] += 1*rexcept XOFullabreak > def join_executor_internals(.shutdown_workers(# Release the's resources as soonpossible.]Wclose] gthread&BwithJlockK;_wakeup.n`# If .d() is not Qed oncreated processesn# some ctx.Q methods may deadLMac OS X p`.values(8pL:`# Thisan upper bounnumber of ` 0return sum(p.is_?() ) _system_limits_checked = False0 . Bzglobal 1:ed,!ed*if3 #&ed raise NotImplementedError("ed* oq = True 9nsems_max = os.sysconf("SC_SEM_NSEMS_MAX"^(Attribute0, V= Oavailable or setting7if F= -1# indetermined p, assum$"at'VeV# by memory only# h>= 256minimum semaphorJ|`accordto POSIXv "("0vidwoo few qE(%d"Op",0 neavary)" %m}@ain_from_iter_of_lists(%"""Specialized iPation#5tools.chain.\2Each item*1x* should be a . This function is careful not to keep referencesyielded objects.71""" for element in iterable:`.reverse()Twhile=15s.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{Zhat can be u%to[Me e bgiven calls. If 1 ortRs manCB@will|2cresgmachine has-#orL: A multiS;alaunchXSs. ThzN\p shouldxvide SimpleQueue, D andf>r([  fCeI)FPtuple@argup!to.Wr_check_system_limits if&1 is X'._^ = os.cpu_count() 1? if sys.platform == 'win32'\` min(_MAX_WINDOWS_WORKERS,f> V7els#A N<= 0r ValueError("@mustgr than 0"vhoelif (^ c/> Pc W&fO<= {g6}")}? a( =L-]3cETp.getdrL= pq^ () HD4Typ+ a/=alizer  self._initargs = 3 # Management thread?executor_m)"r_&z = NoneJp of pids to processesQX = {}AShutdown is a two-stepI.Hs._False&clock =ing.Lock()/idle_worker_semaphore7S,(0=broken = queue_count = 0xqpending{P_item+{}&tcancel_-`future*q.A# _TbWakeupP communication channel usedinterrupge waitNof the main loofrom anothernV (e.g# when calling I.submit or). We do not_result_dbsend wasignalo Nas it could Y in a deadFRif a % dies with awrite Estill acquired#_s_3bmust b@ acc K _=>(()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/[%.# Killed0canRduce spurious "XUpipe"# tracebacks+0's Dewe detect kLanyway, so silencm `._ignore_el = TruQc.Simpl ,_X=.1def _start_executor_manager_thread(self): 0if ._executor_m0 is None29 # Start the processes so thair sentinels are known.wEx C= _EMTI .s)()2 s_wakeups[ Y] = \@Y 6def _adjust_.l_count@# ifTre's an idl`, we don't need to spawn a new one^A_worker_semaphore.acquire(blocking=Falsebreturn a = len.&esd$if# = 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 n0# W]pup queu C` F s2t .{(s7 y z f.join(# To reduc@riskopening tooPfiles, remove reference# objects`t use 7 descriptor ! =Z-_ 7%, 5g.close"{#e   S5n.__doc__ = 6_base.Executor.shutdown.__doc__ # Copyright 2009 Brian Quinlan. All Rs Reserved. # Licensed to PSF under a Contribl Agreement. """Impls ThreadPool""" __author__ = '0 (b@sweetapp.com)' from concurrkfutures import  itertoolsTqueue t5ing5ype+tweakrefbos _3!s_HCs = &.WeakKeyDictionary() _| = FalseGock that ens (new workers are not created while the interpreter is # aQting  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. __( ) class _WorkItem(object_init__(self, , fn, args, kw2).(# =1nnF! =U a# =j 1run|!ifn.set_running_or_notify_cancelbreturnb6tryresult = b1n(* 2, * 4except BaseE ion as exc]K99vion(excPT # Break a reference cycleW`>a 'exc'6;j0 = MOelse ()&!__B@_getmethod(t.GenericAliasv_##(e_,> , rializer m(ifl Q (* Q N>.LOGGER.critical('3nit0:',`_info= 2 = or_referenceG()  if executor is not None:%0&._initializer_failedTareturnB6tryKwhile Tru_work_item = queue.get(block=3 *6 'K.run# Delete references to object. See issue1628462del # attemptSincrement idle count2g% =_] .__semaphore.release`7 continue/# Exit if&# - The interpreteshutting down OR6that owns theer has been collectedJ..Dif _5 orjf.* AFlag0as [  as early as possible if ie#gc-ed yettY$ ! = W# Notice others'@put(- Lrh except BaseE 6iona_base.LOGGER.critical('*3 in', exc_info class BrokenThreadPool(UE\)t1"""Raised when ab! tCs&a OB k ~Aing.MU8G"):0# Uto assign uniqueRnames_t_prefix>supplied_er = itertools.().__next__}Qdef _H__(self, max_@ers=,xA='',#er:sargs=()x-E"""Is a newhinstance.;BArgs:maximum number ofyat can be ut ~Pe givBallsYp: An optional  !toH our threads.  initializer: A callable used to  worker threads. A'@argsDtuple of argumentsI1pas7theUrG5"""Srif max_rs is None: u1# TPoolExecutor*Toften 3* CPU bound task which releases GILeX* I/O2(3,zcourse)? ! WY cpu_count + 4 for both typesK a# But we limit itT 32avoid consuming surprisingly large resourceon many core machine.$= min(32, (os.() or 1) J<= 0raise ValueError("lmust be greatuuan 0") (ifG1not'P and ()4Typ+ ahself._=(_queue = .SimpleQ(9/idle_semaph=vTing.S,(06m = setTbroken = Fals qshutdow h_lock MLockk_name_prefix = (%or(.("r-%d" % N\er())=3yB( % mdef submit(*, fn, /, *#`, **kw YCwithW8, _global_ #if;  9B"._5'2SwUcRuntim @'canFschedule new futures afP'upk5'b'interpre <f = _base.FWwWorkItem(f#, ,.j.put(w$sadjust_ |return ft.__doc__. _h): # if idle threads are available, don't spin new&# if self._D_semaphore.acquire(timeout=0):4;ureturn # When the executor gets lost,weakref callback will wake upIDdworker.Cdef H_cb(_, q=2k_queueq.put(None)Dnum_1b= len(F)q8if ,<.@max_r:ersA_name = '%s_%d' % `_prefix orT,s_.3t =/Qing.T (=, target=ucargs=(tA.ref,)F .{9initializer: )4z.start( j.add(t!:ms[t] =l_q_failedDCwithBshutdown_lock\broken = ('A b bs pool 'a 'is not us7 anymore'# Drain  l and mark pending futures twhile True>tryl__itemd.get_nowai:bexcept_.EmptbYbreak>!if{E .R.set_Qion(BAPool"._),s! , =1, *, cancel_bhs=FalsEh! = ij a@ork as from,t)irlj# associated?.&= FAE'>I,MQ2UG() # Send a wake-up to prevent threads calling  # _work_queue.get(block=True) from permanently Iing.EXself.Hput(None)'if wait:for t in A $(rt.join(Nshutdown.__doc__ = _base.Executor." """ Standard "encodings" Package "tPython ( modules are storedcthis pAdirectory.PUCodec= must have names corresponnormalizedz/as defin|%e 0_() function below, e.'utf-8' be implemented by the *c_8.py'gEach cEPexpor]e following interface:* getregentry() ->J!s.Info object;The12APIoreturn a 9R with3`er, de!r,PAincr!al%!, streamwriter and7!erJattributes which adhere<3$ IuJpIn addi4, aq`may opally also]5APIfhen us'aesearchraliasessequence ofL{ -suse as 9AF3get("()b /by. Written Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. 5a#" imU$csAsys .I _cache = {} _unknown = '-- R--' _V_tail = ['*'] _D$ =b.r classRegistryError(Lookup , System )Fpass defOCing)'N' a %a @ss: all non-alphanumeric=characters excepC2dotN]6areDPollapreplaced a single underscore ' -;#'F@beco'_'. LeaQ@trai*C@remo+Note that6s should be ASCII onl1"""if isinstance(s, bytesd =) "ascii")  chars = [] punct = Falsefor c in encoding:-if c.isalnum() )f== '.'$(X2andq $.append('_')f c[2Jelsef(2Trureturn ''.join() def search_fDion(1): # Cache lookupentry = _cE.get6, _unknown2if .eis not&rImport the modul#~# First to find an alias 7normalized=Pname ea usingM0ed -,noE< standard ischeme, i.e. fE in^s packageuat top-level.7_0 = sA\i` _8.replace('.', }"if%edc 3Nonf0modrf2,  S-0# s!if7'.'+*ccontinu:try"## is absolute to prevenpossibly TciousLIof a#! with side-effects thatgg'3$s'iV0mod_6__(2@.' +m, fromlist=+OtailX"=0cexcept_Error, may occur because (b)' doelZexist#?#itW1s a3 @ (see mbcs56oemEpass {Qbreak i (agetreg =tM:Attribute"=# Not a codecA"ul { if"*EVmisse[J@] = 8_Qw askmPregis 0 7 = (t@isine1ce(,,0s.CRInfo) if not 4 <= len(entry)G7: 'raise CodecRegistryError('module "%s" (%s) failed to r*9er'KV % (mod.__name__, file__))Eif not callable[0]) or1\A3 5Q2] is4None and [12])\B3B3Br1> 4~/[4U4U5U5UO5]))incompatible c@s in ?9 <766 P += (f,)*(6-B:) +x.split(".", 1)[1],{K=.aInfo(*!) d# Cache th 1ry '% _c$[encoding] ="# ger its aliases (without overwriting previouslyhCeredF96try =C.get(1except AttributeCApasshFelse2for g##if&Cin _| &*["*0mod%oaReturnpt jr{ Zsearch_functionbPythonV1ry "s.d;er(=) if sys.platform == 'win32'3defd_mbcs(t import _winapiqPansi__page = "cp%.s.GetACP34if y F'3 s. *g&T1reg|YI VL"# Qs mayR while we are shutIdowncFws) """ E{# A^0SupjV@Thisis used byd P packy  F!to5mapi s sm3.n0Not0!ata OnormalizesRabeforeq dolookup, so3@mappwill have to map normalized encoding names to module!. %Contents:8The follow=!aliases dictionary contains mappings of all IANAVGcharacter sett for which the Python core libr\providesGodecs. In addithese, a fewIspecific c4Bhave also beeNed. """ #2= {)# Please keep this list sorted alphabetically by value !>WasciiP'646'1: '(!','ansi_x3.4_1968/$_$ # some email headers usenon-standardx8 xRcp367 $s!< $=ibmI $so646_usp$_646.irv_1991+$3ir_ $ e# =us_HE# base64_|_/9_64,0: 'Z$',cIbig5hmig5_tw=4ig5` cs5 " X]hkscs]>2ig5  (/"z2 g&z2`<,,Xcp037;,03}(;ibm)9: '$ebcdic_cp_ca$/nl$cH/wtH$9B8lrhcp10264 6\QcsibmY]%# J)12L1125!cp_ )&kcp866uN & ru&)40/;1408$40d  (%^*25^/25^windows_1!cp1250',  # cp1251 codec '' 2: ')"',%windows_-%&^2^2^2^-^%^3^3^3^-^%^4^4^4^-^%^5^5^5^-^%^6^6^6^-^%^7^7^7^-^%^8^8^8^-^%^)273%2780ibm $.cs&$)42T%42&V7[ $ebcdic_cp_he, $;ibmF' $3%43| 73`'cspc8ECpage1[$ K$85004500k7" $"b"8H$$chu H0ibm2e$)77%775FF775baltic[$0ibmD $)85F/85F850multilingual'!%0ibmw', %85 7Ep)[$ K$ ~/85~] )[["H C/85C  )g "$ A%85 : 'cp858', 'csibm9: '$"' $I# cp860 codecS'860'R7*60 ) $ "Hm111Kp_is&$"6M $ "H22}72spc862latinhebrew'}6$ K$333] )[$"$444 )$ "$555 )$ "$666 )$ "$999Kp_gr&$ M $ "H)93+93 7 ms _ $Ykanji$_%$4F+944>'ms&[$9uhc9$5b/95b Q[5[euc_jis_200|jisx021/.`eucjisA?: '+n ,+ pqE(, Ep?p9?p-uj}%J+krk`^$krjkorean_%Zsc560 % 'ks_c_56051' : 'euc_kr', 'ks_c_5601_1987*%Hx100H/ %;_x_'%p# gb18030 codec'R_2000_1', ';H2312:tchinese5 gb)rcsiso588b2: '%)cnIJ'_1#Note that the ( is implemented internally in C and aGlot fasterMnMrcharmapu1 which uses'CsameFencoding. Th}s why we discourage<1 of>Z1C`lias it toinstead.-'93: ' hBcp81"&p&=ibmM&G &_pv 'L1&ir_100' : 'latin_1', 'l1' &5 )& P &s# mac_cyrillic codecD'macl : /1', ,E[greekB?3 B ?{icelandACA CN2BcentraleuropeHB-z0ent'%):# )[romandintoshf,ch {turkishijAC8bcs<Fansi6|4bcsd _Xxptcp154[#cs`4: ' Wpt154"c&]&b_asian/ Lqquopri_82: '/quoted_printablo+ *c +hrot_13Zrot13?)shift_ji!cs6jisA1: ', & ( $!(5 x;I_200?0jisD12jisqss.Z :x02Iv2jisuD-.Zxtis_6207ctis620D3: '*8_)&D2529+& &iso_ir_166 &hutf_16'u13)=utf'5: '% ^9_bea nibigunmarked'<7_bedA_16b ( # utf_16_le codec 'unilittleunmarked' : 'utf_16_le',+0le'9 () # ;)32g(327><'32a '% ^*_botf_32b@32_b ?l?"32?77?7 &$P_1_1_A1$888 %[$ J$H_ucs$4r $wcp65001" 3 u_cu5H+3', =Nzlib?=zip@6: '-2 * )j&temporary mac CJK aliases, will be replaced by propers in 3.1J'x_mac_japanes: 'shift_jis)ekorean: 'euc_kr&simp_chiS: 'gb231tLJtrad&big5', } """ Python 'ascii' C? Written Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. ift8R ### APIs class(6!s.$):Note: Binding these as C functions`resultBthe X1not# convertCm to methods. This ntended.4 en# =.E_!/de!IncrementalEPr#):W"f f (self, input, final=False*Foreturn(8E.errors)[0]DpBdef %> `Stream1er( ,i8cs.5pasFORead99C#2er(I, < ! !7 ings module c getregentry(): return codecs.CsInfo( name='ascii', en2=0. 'de incremental86r=IEXr/J /Dj/streamwriter=S W R#Eread#R #) """Python 'base64_1c' 2 -  content transfer ing. ThisUA de/es from bytes to 0. ten by Marc-Andre Lemburg (mal@l `.com). importdsS ###APIs def_ (input, errors='strict'):cassertD == return (mVc), len )}}2Q}Rclass (oself,  N)&Z(Z"< 2) 2 final=False*.$ '  @8c=:(,j.charbuffertype = LcLL ings module API_getregentry(I3=_is_text2ing) # # big5.py: 0UniGF for BIG5+Hye-Shik Chang #SDs_twY`_multitc as mbc &= :A.get (''a Acodec.encode decode = "c. class IncrementalEn!r(mbc.Multibyte ?, @>cs.4!):5 D 4 StreamReader(Codec, !,G(s.^OWrit^ ! ^^def getregentry(&dreturnQInfo(name='big5'Ie=/2().4iE:.r=/J //sr=v #wd#;#`) # # hkscs.py: Python Uni for BIG5HKSCS5G&ten by Hye-Shik Chang # import _VTcs_hkm\#0 asm" =:A.get($')8( !s. gnP [-$C93"""B'bz2'- bz2 compression ing. This\A de/es from .Cs to and is therefore usable with ,.transform() /'un. AdaptedRaymond HettingerzBzlib.py which was written by Marc-Andre Lemburg (mal@l .com). """ import codecsbz2 # this needs the optional $module ! ### CD APIs def"0_enZ(input, errors='strict'): assertD == return (bz2RpressPc), len )t/det9NmvRclass(x1cs.  oself,  ?bz2>)W?de(W9 2) IncrementalEr__init__ ".A# ="coPobj =hT.BZ2CAr() 0%|final=FalseZ1if Ac = t m->c +8bflush(,Jelseo>rsQresetu ?% D;ezZ /  ?tryG_6bj.txcept EOFEQ&''d  StreamWriter(u,(s.charbuffertypeDytes1OReadLL rbings m2APIgetregentry(I9UInfo([name="bz2",b&e="@d iA.r=/J /6der/sw=M #rc#U#_is_text2ing!) Generic Python Character Mappi ng Codec. Use this c directly rather than through the automatic>conversion mechanisms supplied by uniZ() and .en. Written& Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All Rs Reserved. NO WARRANTY. """#" importbs ###  APIs class(1cs.)"):*# Note: Bindingse as C functions will result i:"e X1not2"# 4tCm to methods. Tis intended.45# =.charmap_# de#IncrementalEr#):Yf __init__(self, errors='strict', mapping=None7[>cs.[.Q)p9g.U$ =_Bdef input, final=Falsoreturn8(:n!, {O)[0]:Dk::![:-:'@:`Stream1er(Q,e5s@,;t[ 4 Pt# v4,fcORead))B[)3#,)94 )ings module 8getregentry(eqUInfo(kcname='Q%',f!e=2 idE.r=/J //rwriter=2[ #rH#Reader, Z) """ Python Character Mapping Codec cp037 generated from 'MAPPINGS/VENDORS/MICSFT/EBCDIC/CP037.TXT' with?cNP.py. v#" import cs ###sAPIs 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 API getregentry(7 UInfo(aname='%',d!e=02(). if:'r=y/J //spr7=D #w##") [TD5cod2 = '`'\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\91rONTROL '`\x85' # 0x15 -> CONTROL X'\x08"6"BACKSPACE$(87$7$ F1F8"EANCEg(19C9!END OF MEDIUMk(92(A( k(8f"B"(1c"C"FILE SEPARATORm(1d)D)_GROUP*e*E*oRECORD+ F+NUNIT)'80T 20) 1"1"//22"3D3"4"4"n ! F2FLINE FEEDL$2HTRANSMISSION BLOCK4bZXXVESCAPyW2W 8X2X EaeR R8R2R f0i2KtENQUIRY(06CACKNOWLEDG0G>5BELG94349434134SYNCHRONOUS IDL9=3=9=3=(x93= <9; "0f)>]j963696369636963616dDEVICEF FOU (BNEGATIVE )93O 51KSUBSTITUT  4Q aq4ONO-BREAK )e4VLATIN SMALL LETTER A WITH CIRCUMFLEXe,4j?DIAERESIS> >CGRAV8\xe/4:%AC:8\xe4:FTILDt4:RING ABO#4? LETTER C WITH CEDILLA '\xf1'  # 0x49 -> LATIN SMALL LETTER N WITH TILDE:(a2:A:CENT SIGN$.!# ^B$FULL STOP$<$C$LESS-THANM()D)FT PARENTHESIST++E+GPLUSO|$F$VERTICAL LIN&( 50(AMPERSANDpB\xe9'F 51$FEFCACUT^H\xea:2: CIRCUMFLEXyb?3? VDIAER'H\xe8>4> FGRAVd:5:Ie:6: f?7? c>8> dx(SHARP S (GERMAN)!u5,EXCLAMATION MARK+$+3gDOLLAR*&5sASTERISI)#/ORIGH0;,0SEMICOLO9\xa<0(NO-G6+HYPHEN-MINU/'.TSOLID"8\xc\6PCAPITAa'"c4f6A )(c0@@ +cS6< (c3x< (c5<<RING ABO(c7A ACv Jd" >L6z BROKEN BAR,"E6CCOMM% ;PER_'7LOW>#|GREATER?,KQUES8\xfl7#O[ ST8\xc^70; Z`ca' # 0x7'2 -> LATIN CAPITAL LETTER E WITH CIRCUMFLEX '\xcb' # 0x73A DIAERESIS@8@4@ UGRAVE<d<5<IFACUT<e<6< fA7A c@8@ `9# u9< r ACCENT :'A'RCOLON # B NUMBER SIG&@&C&COMMERCIAL An1"'"D(APOSTROPHw=ME%gEQUALSs"&F&QUOTATION MARK8\xd> 80)OKaf&81=ESMALAl8+ /B// /C// /D// // /F^g /G/h/ /H/i/ /I/3\xa{b8 LEFT-POINTING DOUBLE ANGLE (bDORIGHE"f0 ETH (ICELANDIC)f==Y f:3:_THORNy(b1LPLUS-MINUv8\xb9MgDEGREEjMK96Jk/6l/6L^m/6M/n/6o/6O^p/6P/q/6Q/r/6R/3\xa696FEMININE ORDINAL INDICATOR '\x@ba' # 0x9B -> MASCULINE ORDINAL INDICATOR +X'\xe66C6LATIN SMALL LIGATURE AE2(b82D2tCEDILLA"cTE"ToCAPITAV(a4VF4CURRENCY SIGN\'b5( A0(WMICRO%~"1  A1%CTILDs 2 rETTER Stt/3/T/u/4/U/v/5/V/w/6/W/x/7/X/y/8/Y/z/9/Z/B\xa12A/ INVERTED EXCLAMATION MARK4(bf44MQUES1(d01~ETH (ICELA)p(dd? ?Y WITH ACUTXH\xde<{_THORN}aAREGISTERED^hBCIRCUMFLEX ACCENB\xa3/wBHPOUNQ8\xaYB7YENtH\xb7HMIDDLE DOm9%COPYRIGHTNaN1SEC MByPILCROWN(bcwVULGAR FRAVONE QUARTEbB6DHALF bB 3ETHREkF[`LEFT SE BRACKEG].C/8\xa&BUMACRO8aBDIAERESI8\xbB OdpMULTIPL[{CZCURLYA-}kB11BC11C1D11D1E116F11G1 0xC7 -> LAT IN CAPITAL LETTER G 'H'# 0xC8 -> LAT1H1I191I1B\xad4bA1SOFT HYPHEN&(f4&B&ESMALO WITH CIRCUMFLEX?6?C? DIAERESIS>2>D> UGRAVE:3:E: FACUT:5:F: CTILD:}71 Q D0:RIGHT CURLY BRACKETJ.1.Y J1K121K1L131L1M141M1N151NO161ObP171P1Q18Q1R18R1B\xb948UPERSCRIPT ONH\xfb*<U<c?<?< <> <ax<: <f:<Y \<@E@EVERSE SOLIDU7,E<DIVISION SIGoS%E3YT13U13U>V13V1W13W1X13Y13YbZ13Z18\xbE3#TW8\xdoE3 qdqE5A )xd7@ 9duE9<ER O WITH ACUTE '\xd5'  # 0xEF -> LATIN CAPITAL LETTER O WITH TILD<09" < F0<DIGIT ZEROa1%1%#ONI2$2$#TWH3$3$3HREJ4&4&BFOUR5%#IVJ6J6%2SIXI7$7$BEVEN&8&8&REIGHT&9&9&$NI)3\xb FA%SUPERSCRIPT T B\xdbT,B,UCIRCUMFLEH\xdcACA DIAERESIS3\xdD@ 4GRA~H\xda|E< 'AC(9f<CONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB! cp1006 generated from 'MAPPINGS/VENDORS/MISC/CP-.TXT' with7P.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(bname='%',e!e=12().ig:'r=z/J //sqr8=E #w##") [Table 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$$33 -> DIGIT THREE '4'# 0x34 -> DIGIT FOUR%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 AYB121B1C131C1D1D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa' # 0x61 -> LATIN SMALL LETTER A 'b'# 0x62/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/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$[$P$$G$$C$$9$=8= $9@9@9@9@control> '\x92' # 0x92 -> $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$'a0$ A0$NO-BREAK SPACEAu06f+! A1)EXTENDED ARABIC-INDIC DIGIT ZERO;1f;\; (ONu:r: (TWt:: 8HREv<< GFOUR;; (IVv;; 7SIXu :: GEVEN<"<< WEIGHT<:<< (NI0 ;+Ef COMMAb1T'.'SEMICOLO(xa5A5SOFT HYPH1Q7QQUESTION MARK7fe8B/LETTER ALEF WITH MADDA ABOVE ISOLATED FORML{BjL;;|;\FINALs8y8&Bw 8?BEH91Bw:LNITI&b5Bt 9Ps&b5Bs:s&e9#Bq 9 TE_RBUTAByB9Bw:'b6(t 9t&b6)BB -> ARABIC+ LETTER TTEH INITIAL FORM '\ufe99' # 0xBC -> ARABIC:H:|SOLATED;b;D;ud:E:oJEEM Iuf;F;u5b7a:.C0:/TC6b7c<1<w6ea1;2;?HAH&a3:3:s5949Kt 7;5;uI.C6:?DAL6b84t7:H<Na.C8=T<;.C9;R'b8A:;&ea.CB;OZAIN(J'eb?SEEu'eb;b/SHv D<wD?SAD`&ebKD:sIDDsD:scDTVcDZ:Z&ecD:=FINc7cD9>MED c GH:%ceD<9&d0tBIC LETTER G6HAIN MEDIAL FORM '\ufed1' # 0xDF -> ARABIC LETTER FEH ISOLATED:3:/E0:?NITs5919?QAFs7:2:s9939Ksb:4:s6b92959Gs6b94:6:s6edd979?LAMYf:8:s&e0999wew.EA8?MEEexB;6b9eC:NOON GHUNNA(eDB/eE;'e8uWAW WITH HAMZA ABOVE"FK5ba6<FHEH GOALy6ba8??&baF>k6baa{=DOACHASHME:8F|<'e8?YEH8K=FIN8FHI&efFJf"F:fF7'bb9oBARREE&baQFR&7c_SHADD76FORM ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB* cp1026 generated from 'MAPPINGS/VENDORS/MICSFT/EBCDIC/CP6.TXT' with@P.py. x#" import rs ### uAPIs class($.): def e(self,input,errors='strict'):,0creturnoB=,4ing(CoAo*B ooIncremental$er h final=False*Y.S 4[0]Dc(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(bname='%',e!e=12().ig:'r=z/J //sqr8=E #w##") [T ~2 = (`'\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 -3TWOx13' # 0x13 -> DEVICE CONTROL THREE '\x9d' # 0x14/("(85"5"(08"6"BACKSPACh(87$7$ h1F8"TANCEL(19C9!END OF MEDIUM((92(A( k(8f"B"(1c"C"FILE SEPARATORm1@D)_GROUP*eSE*oRECORD+ F+NUNIT)'80T 20) 1"1"//22"3DS f4"Fn  h2FLINE FEEDL$2HTRANSMISSION BLOCK4bZ2XVESCAPyW2W C8X2X aeR R8R2R f0i2KtENQUIRY(06CACKNOWLEDG0G>5BELG94349434134SYNCHRONOUS IDL9=3=9=3=(x93= <9; "0f)>]j963696369636963616 6FOU (BNEGATIVE )93O 51KSUBSTITUT  4Q aq4ONO-BREAK )e4VLATIN SMALL LETTER A WITH CIRCUMFLEXe,4j?DIAERESIS> >CGRAV8\xe/4:%AC:8\xe4:FTILDt4:SMALL LETTER A WITH RING ABOVE '{'# 0x48 -> LEFT CURLY BRACKET-B\xf10-9-ATIN SMALL LETTER NlCTILDgH\xc7:A:eCAPITA<C<rCEDILLAx.;2 xB>FULL STOP$<$C$LESS-THAN SIGN)()D)FT PARENTHESIS+++E+GPLUSO!$F$EXCLAMATION MARKO&+ 50+AMPERSAND$B\xe9' 51$LcE'EACUTc(ea:2: CIRCUMFLEXyb?3? VDIAER*H\xe8>4> 4GRAH\xed:5:Ie:6: f?7? c>8 dxESHARP S (GERMAN)Au011 IG15BREkPu0130<G\ 8DOT,*;+5csASTERIS)#]ORIGH^;,^SEMICOLO^$^c ACCEN-,6_HYPHEN-MINU/'bTSOLID"B\xc2%(6J (U8xc4ALA ]c6N@ _c6P< C(c3R< 5<O< [>6RlSQUAREdF oAu015D SB ,DCCOMM% $0PER6_'(sLOW LIN>#|GREATER?,'QUESTION MARK '\xf8'  # 0x70 -> LATIN SMALL LETTER O WITH STROKE;(c9;1;eCAPITA=E=FACUT<a<2< CIRCUMFLEX}bA3A DIAERESIS@ 4@ FGRAVd|5<Ie<6< fA7A c@8@ Pu0131>-9< -DOTLESS Il:2dA7RCOLON B\xd6#WB  I Au015V@C@SqCEDILLA~1"'"# D>0APO#PH=%E%EQUALS SIG \F&U (xd8 P8 '>/ /B&'/p /C/ /_ /D/8R /^E /F^g83 /G/h/" /H/i/ 3\xa{ LEFT-POINTING DOUBLE ANGLE QUOTATION MARKs9\xbD1ORIGHE}6E CURLY BRACKETs`.&c ACCEN'8\xa8(B4RN BARL1\xbEr8'PLUS-MINUQ"b0y-9gDEGREEwj#9Jk/ml/L^m/M/n/bo/O^p/7 -> LATIN SMALL LETTER P 'q'# 0x98 -> LATIN S/Q/r/9/R/B\xaa2^A/ FEMININE ORDINAL INDICATO5b5B5oMASCUL6 (e6kC6 IGATURE AE(b82D2tCEDILLA"cTE"TCAPITAL LV(a4VF4CURRENCY SIGN\'b5( A0(YMICRO%f A1% O WITH DIAERESIScs`1 ~/A2>/t/3/T^u/4/U/v/5/V/w/6/W/x/7/X/y/Y/z/Z/B\xa12x INVERTED EXCLAMATION MARK4(bf44KQUES1].RIGHT SQUARE BRACKE$/gDOLLARp@&COMMERCIAL ANB\xae+REGISTEREDRG\xa2*BJCENT$3$KPOUNI0B9YENH(b7HMIDDLE DO9%CCOPY<aN1SEC BzPILCROWcwVULGAR FRAV@ONE &TE d66EHALFIB 3ETHREk9\xa(NO|tB!IC NZaBUMACROa{B 8\xbIBACUTE ACBdpMULTIPLVge.CQCQ AC<\?B11BC11C1D1 1LETTER D S 'E' # 0xC5 -> LATIN CAPITAL LETTER E )+'F161F1G171G1H181H1I191I1B\xad4A1SOFT HYPHEN&(f4&B&ESMALO WITH CIRCUMFLEX?~<2 eC?CTILDIB\xf2# D _FGRAV:3:E: FACUT:5:F: Pu011f</D0:G 4BREJ5;&D1: bJ9K121K1L131L1M141M1N1&<O1&ObP1&P1Q1&Q1R1&R1B\xb94&UPERSCRIPT ONWb**U *"\\=*D*ARSE SOLIDUSf4i 4af4: 44YDIAERESIcxE8x>7><DIVISION SIGoS%lE3T13TzU13U1V13V1W13W1X13Y13YbZ13Z18\xbE3#TW8\xd]E3 _#5gNUMBER9\xdD -> LATIN CAPITAL LETTER O WITH GRAVE '\xd3'  # 0xEE -> LATIN CAPI<FACUT<5<F< CTILD<09" x F0<DIGIT ZERO1%1%#ONI2$2$#TWHm3$3HREJ4J4&BFOURK5%IU6J6%2SIXI7$7$BEVEN&8&8&REIGHT&9&9&$NI)3\xb FA%SUPERSCRIPT T B\xdbT,B,URCIRCUMFLE">'CAQUOTATION MARK3\xdjD)j ah< (9f<CONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB for CP1125 /#" import b,APIs class ($. 1): UAdef e(self,input,errors='strict'):,creturnoB=,ing_map)mm*B mmp)Incremental$er  h final=False*W.Q ?[0]D~L!@OStreamWriter(J,W5pasORead9 9XFs module API getregentry(7 UInfo(name='cpB%',e!e=12().ie:.r=^/J //sqr8=E #w##ZK0MapB}map = codecs.m0ake_identity_dict(range(256)) decoding_map.update({ 0x0080:@410, # CYRILLIC CAPITAL LETTER A5"1:515&BE62626V63636'GH74747D65656I66666Z7777m8686I{9595gSHORT ;a;a;K"b6b6&ELc6c6M6d6d6N6e6e6O5f5f5P9d2d%ERl9e2e&ES6e2eTe2eUkc2c&EF6c2cHP9c2c'TSc2cC9d2dSf2fC9d2dHARD SIG9k2k7YERm2mKSOFTut2ts2sYt2tY1at3tOSMALaq3q 3ao3o 4am3m 4am3m# CYRILLIC SMALL LETTER DE 0x00a5:@435, # CYRILLIC 4I46464 'ZH57575 48484 I9393 gSHORT 9a9a9 &KAmb4b4 &EL4c4c4 M4d4d4 N4e4e4 O3f3f3 P b04E25914LIGHT SHAg#b1'2'lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS vVERTICA{"b47%24]7 AND LEFT b,6256 @qu SINGLEAg DOUBL4@?256H8HXS6255 CDOWN|Dc6255DxDt6256 D Y|?255YpAy6255Tyu6255U=%UPx6255 ;/UPw6255: Bu O2510 c1  Rc3;HORIZONTc2;B1B m 0: z3zF5 T IERTICAL DOUBLE AND RIGHT SINGLE 0x00c8: 0x255a, # BOX DRAWINGS DOUBLE UPC<9<4< ODOWN>a>/69> zHORIZONTALbA6A CcC0C VERTICALdB5B |e:/6c|GfG7G#UPAN#d0H8H LH Q#d1H/WN2J53J5k#UP$(#d4C Cb5C2E6E3EyV7E/6bEIC6CNNdU1iLFLEFT:Q0Q:6=M8wFULL BLOCK&08LOWER HALF,8+ 9E,8,?UPPe6044, CYRILLIC SMALL LETTER EReE04414S460444Tye60444Ug6044~3&EF4u6044E4&HA4d6044Y4'TST60445'CH5;6044v5S"60445TER SHCHA 0x00ea:P44a, # CYRILLIC SMALL LETTER HARD SIGN ';b;b; FYERU6c6c6 KSOFTqd;d; Ene3e3 Yf4f4 Ah"f04.014eCAPITAI&IO61656 }424/90jGHE WITH UPTUR#f3Cw A4A/04UKRAINIAN I"f5@5@ >6>/06~BYELORUSSIAN-M7L5L J8J/07&YI9656 4&0b4MIDDLE DOTZ6221SQUARE RO'6211jNUMERO{f{'0a{URRENCY)q625abBLACK }e0(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'" #00 -> NULL!1!1!START OF HEADING-2-2-2TEXlx3*3*0ENDU (4(4(RANSMISSIOX5050UQUIRY6$6$ACKNOWLEDGtL7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZONvTABULATn2a2LINE FEEDb(b&VERTICAL V:x0c0c0HFORMVr$d&CARRIAGE RE!e.e,SHIFT OUf&f&I11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /"TWcJ'\x113 -> DEVICE CONTROL THREE '\x14'  # 0x0014 -> DEVICE1EFOUR05050NEGATIVE 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 IB33BfC33C3D33PITAL 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%7TDELET#Pu0410%#8CYRILLIC CAPITPA\6166Bm277V7377(GH84886577In67 7Z788o877I966hSHORT <a<*<K,b707'ELc787M7d7E7!e7L7&6b=`6P2t9t En2u9u E7u9u 2u9u ms9s &EF2s9s HA '\u0426' ) # 0x0096 -> CYRILLIC CAPITAL LETTER TSE '\u0427' 878 (CH88888 7SHAp9898 C:a:a: HARD SIGNxb>b> GYERU9c9c9 LSOFTwd>d> ]e6e6 Yf7f7 '307)a07ESMAL9A(31414B(32525V53535G(34646Dk5555I565 y >Zwaw 6ktat 5Ipap 4hSHORT :pap :Kgag 5'ELcac 5M5ZaZ 53YaY 5OiVaV 4P8259 bTLIGHT SHAs8259bHmMEDIUM)b<LDARK'0P.BOX DRAWINGS uVERTICA82520b08 AND LEFT&9256< Asu SINGLEBg DOUBL:6PI9IY5bc ICDOWN~EbsEzE6 E #^5^BWINGS DOUBLE8 VERTICAL '\u2557' # 0x00bb -> BOX DRAWINGS DOUBLE DOWN AND LEFT>d>c>?UP <c<d<$UP}<w SINGLEbCeC3SC(10CfC_LIGHT'14=/c0=RJy3<1< HORIZONT2@/c2AC1C3C5E 0?/c4B|3|5: |G(5e6GA  (5fJ7JJ[(5aJ8JA59=|(69|a?|R(66BD L5CE~ [; ~Hc#UPB ['68Sd( I Z6d555?K*5tdG 9 #I lDD2SF3FRF{dFW6dNc6SdSONTAL DOUBLE , '\u2518' # 0x00d9 -> BOX DRAWINGS LIGHT UP AND LEFT ;(0c;a;ADOWN=RJ>8yb>FULL BLOCK'4ec'LOWER HALF- d-?EFT,(90Ye,-8-f-?UPP8044- e0- CYRILLIC SMALL LETTER ERG0441/e15S52525'TE53535U4/e44'EF55i55'HA56565(TS7676(CH6/e86S9l29SHC8a8/8HARD SIGNb<-<8YERe=7LSOFTsdsL<Qe4T4Yf5\5'0/fdeCAPITAf&IOH57f5 *ff lGHE WITH UPTUR9yuB0f UKRAINIAN I5A?0f BYELORUSSIAN-N MK0f 'YI 75!xb3-fMIDDLE DO(21fSQUARE RO()11hNUMERO!xawxURRENCY*Hu25a{fBLACK SQUARE '\xa0 ' ## 0x00ff -> NO-BREAK SPACE ) ### Encoding Map e_map = { FC100:K000, # NULL 1 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSIONV5/5/VQUIRY#6#6#ACKNOWLEDGE'7'7'(BE8 8 2ACKGZ9%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 STOPMr2rWSOLIDH3k30, # 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 SOLIDU5d, # RIGH T SQUARE 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*CfCURRENCY SIG\bfLMIDDLE DOb#40"fRCYRILLIC CAPIT'I$406UKRAINIAN I#40f@BYELORUSSIAN-M$40LYj#41q8#41-8OCYRILLIC CAP ITAL LETTER BE 0x0412:@082, # CYRILLIC CAP6V63636'GH74747D65656I66666Z7777m8686I{9595gSHORT ;a;a;&KAqb6b6&EL6c6c6M6d6d6N6e6e6O5f5f5P"206/906%ERl#21616S6e9eTe9eUkc9c&EF6c9cHP2c9c'TSc9cC2d9dSf9fC9d9dHARD SIG2k9k7YERm9mKSOFTut9ts9sYt9tY13tatESMAL3qaq 33oao 43mam 43mam 53kak 43iai 437: 0x00a7,  # CYRILLIC SMALL LETTER ZE 0x0438:@0a8,4I39393 gSHORT 9a9a9 &KAmb4b4 &EL4c4c4 M4d4d4 N4e4e4 O3f3f3 P"404/e04 %ERh#41414 S42424 T3434 Ug4343 &EF45454 H:#46464 'TS7575 'CH5DeD SFeFC7DeD HARD SIG4KeK 7YERMeM KSOFTqTeTSeS YTeT Y5 f  I5f UKRAINIAN I%5fZ BYELORUSSIAN-K$5f: Y{9DfeCAPITAGHE WITH UPTUR?93 A4211JhNUMERO63221fSQUARE ROOT3250cG BOX DRAWINGS LIGHT HORIZONTA3250b9hVERTIC7dy7DOWN AND R1b= 6LEF1wc<!UPwRIGHT 0x2518: 0x00d9, # BOX DRAWINGS LIGHT UP AND LEFT &b0x251c:/c3: VERTICAL@RMA"24A/b4A 22@ ADOWN}HORIZONTAL3/c1B @5@ F"50/cdFDOUBLE :1:/ba: "528d4aSINGLE; E3E6}#WN4EVEt >5/b8r?D6D7DDTD7DbDD=2UP o 9d#UP2CTaCcK <b</be BIb B dcB}e;c?fIKIOJZ6 PIB;G 6*b HX-b HA)d\u. 5d7JJ`;cJC:/cf ;A E0HND HORIZONTA L SINGLE 0x2569: 0x00ca, # BOX DRAWINGS DOUBLE UP AND HORIZONTALAaA/d8AtVERTICAy G`NbN7N  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&af NUL711START OF HEADING[+2+2+ETEXT(3(3(END OF TEXT '\Px9c' # 0x04 -> CONTROL 2'\t " "5"HORIZONTAL TABULATION02x862060 R8x7f"7"dDELETEC(97!8! C(8d"9"e"A"(0b"B"oVERTIC0)C.FORM FEEDrP+D$CARRIAGE RETUR%0E*SHIFT OUTN)x0'F$IG"10sl 10#DATA LINK ESCAPT(11+1+TEVICE6 ON-2-2-4TWO(13-3-5HRE\91r8x85Qr (08"dBACKSPACh8E1f F1FgDANCE8x19gfEND OF MEDIUM9/l81l `1`ILE SEPARATORm1@e_GROUP*e1eoRECORD+ lNUNIT)8r2r 8i2i "/2^ "S2S "42Fn 2FHLINE(x1$2HTRANSMISSION BLOCK72X j8W2W S(x8X2X a2R R8R2R f0i2KtENQUIRY02CACKNOWLEDGk0G>5BELG94349434134SYNCHRONOUS IDL9=3=9=3=(x93= <9; "0f)>]j9636963696369b' # 0x3B -> CONTROL '\x14'  # 0x3C -> DEVICE)U FOUR.5.D.NEGATIVE ACKNOWLEDGE/(9e//E a"F"SUBSTITUTG "" !40%3PAC B\xa0# 41 NO-BREAK S)(e2)2)LATIN SMALL LETTER A WITH CIRCUMFLEXe,/43? DIAERESIS> 4> EGRAV(e15: %AC:H\xe3:6: FTILDt/47: RING ABO7y8?CjdEDILLA)f9<N< aA:CENT SIGN^.MB$FULL STOP$<$LESS-THANM()LEFT PARENTH++ GPLUSO|$VERTICAL LIN&(5AMPERSANDB\xe9'5EF 55&:&by&?&8>&> &d:&I5&:fy+?c>*> dx(SHARP S (GERMAN) !u5,EXCLAMATION MARK+$+3gDOLLAR*&5sASTERISI)#/ORIGH0;,0SEMICOLO9\xa<0(NO-G6+HYPHEN-MINU/'.TSOLID"8\xc\6PCAPIT> c>6A )c@6@+ '\xc1' (# 0x65 -> LATIN CAPITAL LETTER A WITH ACUTE '\xc3'  <6< FTILD<5<7< RING ABOVA7A8ACtCEDILLA(d1>9>N> (a6<A<BROKEN BARa,"# B%CCOMM% C PERCENT SIGNG_'D'sLOW LIN >#E#GREATER-THANO?,F,QUESTION MARKwB\xf8+ 70(ESMALO ST;(c9;1; QE= Qa<2< CIRCUMFLEX}bA3A DIAERESIS@ 4@ 7GRAd|JIe<J<fAOAc@N@`97L 0 AC\:'7CCOLO# 2gNUMBER@&8XERCIAL ATn1"'"90APO#PH;=M;gEQUALSs"&5=OTA6d>86 888 s@/+ /B'/ /C// /D// /w/ /F^g8 /G/h/ /H/i/I/3\xa{8LEFT-POINTDOUBLE ANGLE QU(bDORIGHE"f0 ETH (ICELANDIC)f # 0x8D -> LATIN SMALL LETTER Y WITH ACUTE '\xfe' # 0x8E ->:THORN (ICELANDIC)?(b1?F?PLUS-MINUS SIGN*0* 90*gDEGREE&j#" 91&JUk/2/K/l/3/L/m/4/M/n/5/o/6/O^p/7/P/q/8/Q/r/9/R/B\xaa26 9A/FEMININE ORDINAL I)5ATO5b5B5oMASCUL6 (e6kC6 IGATURE A(b82D2tCEDILLAcTCAPITAL LVPu20acXGEURO@\xb5"A9MIC%~"ACTILDs St/T/u/U/v/V/w/W/x/X/y/Y/z/Z/8\xaA INVERTED EXCLAMATION MARQB\xbffA4MQUES1dAz?ETHo(ddp  ?dA{aAREGISTERED^BCIRCUMFLEX ACCENB\xa3/CBHPOUNQ8\xaYB7YENtH\xb7HMIDDLE DOm9%COPYRIGHTNaN1SEC IByPILCROWNb:BVULGAR FRAVONE QUARTE0B6BHALF\xbe' # 0xB9 -> VULGAR FRACTION THREE QUARTERS '[' # 9A9`LEFT S)E BRACKET.].B.ORIGH/B\xaf2]C/bMACRONPH\xa8!D!DIAERESIH\xb4$E$ACUTE ACCENH\xd7'F'MULTIPLICA3SIGy{+1 C0.ZCURLYA-1-ATIN CAPITAL LETTER AB121B1C131C1D141D1E151E1F161F1G171G1H181H1I1LI1B\xad4SOFT HYPHE 8\xfaCWESMALO WITH CIRCUMFLEXe(f6e? (f2>>CGRAVH\xf3::25:+:CTILDt}77D78J.8JK18K1L18L1M18M1N18NO18ObP18P1Q18Q1R18R1B\xb948D8UPERSCRIPT ONH\xfb*<U<c?<?< <> <ax<: <D<Y \vwE@EVERSE SOLIDUfE<PDIVISSQ # 0xE2 -> LATIN CAPITAL LETTER S 'T'# 0xE3 -1T1U141U1V151V1W161W1X171X1Y181Y1Z191Z1B\xb24WA1SUPERSCRIPT TWO*(d4*B*O WITH CIRCUMFLEH\xd6ACA DIAERESI9\xdD@ UGRAVE3|E< FACUT<5<F< CTILD<091 _ F0<DIGIT ZERZ1%1%#ONII2$$#mCTHREJ&&BFOUR0% %IU%%#SI7$BEVENo8&&CEIGH9&&$NI)3\xbr B\xdbT,UcAA@ a|< (9f<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*,self.errors,encoding_table)[0] class IncrementalDecoder(>cs.): def d, (self, input, final=False*.sreturn Ucharmap_@:F.errors,StreamWriter(Codec,UzDpass0Rea9 9D### 4s module API getregentry(7 eQInfo(1name='cp1250',e!e=12().i:'r=E/er/J //sqr8=E #w##@) K[Ping TE2 = (`'\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! EXCLAMATION MARK C'"'  # 0x22 -> QUOTATION MARK !+'#)3)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 L LETTER R s 'S' # 0x53 -> LATIN CAPITAL LETTER S )+'T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[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~\x7f' # 0x7F -> DELETE '\u20ac' # 0x80!EURO SIGN$Ffffe$1$UNDEFINED$F201a$2$ SINGLE LOW-9 QUOTATION MARK6 Z36Z~4$ODOUBZ F202656HORIZONTAL ELLIPSISF2020.6.gDAGGER!1!7! ( 8(3m9$PER MILLEx7016)A)LATIN CAPILETTER S WITH CAROF2039B<EFT-POINTING A7015CD 6ACUXF0164D<TF017d<E<Z<< 9 %189 SLEFT ]I62019ORIGH69kk<9.k6 &22.fBULLET&13!!wEN DASH"9")EM" _1QTRADE6 9oSMALL  9*b fF0165: : 9 : 7017:!xa ANO-BREAK SPACIE02c7A &2d9AFBREV@&14ALTSTROK=!xa{CURRENCY50*AAeTOGONE!xaQeBDN BA)!xa%1SECS!xa ' fDIAERE!xa4$ ACOPY 5A CAPITAL LETTER S WITH CEDILLA '\xab' & # 0xAB -> LEFT-POINTING DOUBLE ANGLE QUOTATION MARKDcDCDNOT SIGN#d#D#SOFT HYPHE&e&E&REGISTEREDPAu017F*LATIN CAPITAL LETTER ZDOT ABOVE'b0j B0@hDEGREEf8xb1&1&PLUS-MINUS*Fu02d B2*TOGONE$Pu0142M B3!ESMALLVSTROK49  B4;ACUTE ACCENT5'5'XMICRO8xb6%6%zPILCROW'7'7'MIDDLE DOq8%8% ]Au0109"A 0 5f_;A;b1ORIGHAu013 bDCARO<Gjjj h!17{: :Au015Z>Cx RtmcC< < C,< CIRCUMFLEX}WCL }6BREc}M} DIAERESIS|%39Cf@}<CqC< )C> !xc2 nEAu011%< (xcCy&1a@Z!xc|I!xc< <C6 AD}r<D0 -> LATIN .CAPITAL LETTER D WITH STROKE '\u0143' # 0xD1 -> LATIN =N=HACUT<7<2< SCARONx!xdvx3<Ox0xd4v<4< CIRCUMFLEX}Pu0150C5A xDOUBLE 0xd6A6CIAERESIS!xd:@7@MULTIPLICATION SIG.8p8.R.jVu016e<9<U<RING ABOV0xda?AA 'Gu017jB< jcCC jd@D@Y 62>xE<T<uCEDILLAf<9F>ESMALdSHARP 57s/E050xe18oE oA :::O0?6BRE[eE:DAu013x >LAu010: :C:!xe8+: vv<.(e9 :EAu011<t:dOGONEK(ebu;1@y>!xe%c :I!xe::Gf}:F: ;FTIN SMALL LE TTER N WITH CARON '\xf3' # 0xF3 -> LATIN SMALL LE:O:UACUTE:4:4: CIRCUMFLEX?Pu0151Ay5? zDOUBLE 6? 6A IAERESIS8xf7>7>DIVISION SIG 9*8( R ZVu016f:9:U:RING ABOV_a=A? Gu017ZB: Zc{CA Zd>D>Y 6lE:T:sCEDILLAGu02dF<3DOTS) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1251 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##) ### Decoding Table decoding_t = ( '\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$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 AYB121B1C1vbC1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6GRAVE 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/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x7i7TDELET!Pu0402F!8CYRILLIC CAPIT(DJ6366G6F201a6 SINGLE LOW-9 QUOTATION MAR'W\u045ll / jODOUBj F2026pHORIZONsELLIPSIGf\u2020.SDAGGE!1! (aEURO SIGL3mPER MILLE)F0409u. L36EFT-POINTING A0zITAL LETTER (NJE '\u040c' # 0x8D -> CYRILLIC CAPITAL LETTER K6b6E6 8TSHmf7F7 (DZ7%527)907ESMALDF2018414 LEFT SINGLE QUOTATION MARK F2019525ORIGH6C 936kODOUBk dk45k6 2 56gBULLET3W6!wEN DASH"4"7"M"Ffffe"8"UNDEFINEDF19$QTRADEOT SIGN*7045TA*a L&3aB4$-POINTING A7045ECEy 5  5 9  4 5 9  50xa0ANO-BREAK SPAChA wSHORT U:: 80oA8 r!xaCURRENCYC9A]GHE WITH UPTUR8xa6:BROKEN BAR8xa7%1SEC%  01)%IO\0ACOPY 0^ / IUKRAINIAN I!xah:2_9!xaD9 NO!xa#(SOFT HYPHEvK&REGISTERED}  $YITb_BhDEGREE[!xb& PLUS-MINUS* 'B BYELORUSSIAN-Gu045K  GI9# I b5 # 0xB5 -> MICRO SIGN '\xb6'  # 0xB6 -> PILCROW'7'7'MIDDLE DOTLPu0451'L8% CYRILLIC SMALL LETTER IO31211393JNUMEY4YA&YUKRAINIAN IEc0xbb; B=RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKE8GCEJxVu04053D3eCAPITA'DZ656E6 D 4F4&YI%10)C03 A4/C14 B&12i25 V53535 (GH6&/C46 D5p/C55 S7u04C5 >ZCD6yCT k9?UihSHORT :a: i nKcCao'ELMcj Q j'EM5d5S Ee5 R jF041f4 R 4P2TDT &ER2UDU 'ES5UDU TUDU UiSDS 'EF5SDS HE2 DS (TSSDS C2TDT SVDV C8TDT HHARDwFu042[D[ 8YER]DC -> CYRILLIC -CAPITAL LETTER SOFT SIGN '\u042d' # 0xDD -> CYRILLIC <E4e4E4 'YU5f5F5 A5%305)E05ESMAL21212B&32323V33333(GH44444D35353I36363Z7474g8383I9292hSHORT 8a8A8Kb3B3'ELc3C3M3:E: Em39E9 3Oe6E6 2P44F4&ERf45F5'ES35F5T5F5443F3'EF3F3H/43F3(TS3F3Cg44F4S6F6 C64F4KHARD4;F;8YER=F=~4DFD CFCz4DFD YA ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1252 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withA.py. """#" import codecs ### C APIs class($.): 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 9Js module getregentry(7 UInfo(name='cp1252',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 IDLx17' # 0x17 -> END OF TRANSMISSION BLOCK '\x18' # 0x184eCANCEL!9!9!UeMEDIUM(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"'"> uAPOSTROPH(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+'E11F11FG11G1H11H1I11I1J' # 0x4A -> LATIN CAPITAL LETTER J 'K'# 0x4B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/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/IN SMALL LETTER U 'v' # 0x76 -> LATIN SMALL LET/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 MILLE7016)@CAPIzSMECAROF2039EFT-POINTING A5IGATURE O} Y YF017d XRZ ` ` $9 $E20189L%6201U96 9kYk$9k6 29DBULL|&13vEN DASH&14")EM"702dS 8u21QTRADE- t9V 9, 99V7017YfDIAERE!xa4! ANO-BREAK SPAC!xav)1 -> INVERTED EXCLAMATION MARK '\xa2'  # 0xA2 -> CENT SIGN$3$3$ZPOUND%4%4%CURRENCY(5(5(:YEN#6#6#BROKEN BAR7%7%1SEC 8'8'DIAERESISK9$9$COPYRIGH a)A) FEMININE ORDINAL INDICATOb5B5LEFT-POINTING DOUBLE ANGLE QUOTcDCD+NOd#D#SOFT HYPHEe&E&REGISTEREf*F*UMACROK'b0! B0!iDEGREE(b1&1&PLUS-MINUS*BSUPERSCRIPT TWObB *EHREE,BACUTE AC'BZMICROBzPILCROW'BMIDDLE DOTqBuCEDILLA"B&ONBoMASCUL bBbBVULGAR FRA ONEARTEbB6EHALFeH 3T1 QUkbBINVERTED QUES2cCLATIN CAPITAL LETTER A WITH GRAVcC< cC< CIRCUMFLEXACA FTILD'C'< Cc@C@@ R7ABO:\C\AgCg2C ^cC>E> C< C< CAITH DIAERESIS '\xcc'  # 0xCC -> LATIN CAPITAL LETTER I WITH GRAVE<d<D< FACUT<e<E< CIRCUMFLEX}fAFA DIAERESI'd0@/D0@4ETHs(d1313N,ETILD(d2<2<O< h(d3<3< h(d4<4< h(d5A5A 6<6< 7@7@MULTIPLICATION SIGN8.8.cVSTROK9=9=Ua<A< b<B< DdDY DFTHORDESMALpeSHARP eE 5A =eE: eE:eE? 7eE: eE>RING ABOeE ?9eEv 0CtCEDILLAeE <E< E: E:E?E >leE:  0xEE -> LATIN SMALL LETTER I WITH CIRCUMFLEX '\xef' # 0xEF -> LA?DIAERESIS>'f0>/F0>5ETH11111NUTILDE:2:2:O:FGRAV:3:3: FACUT:4:4: \(f5?5? 6:6: 7>7>DIVISION SIGNS8(8(SVSTROK9;9;Ua:A: b:B: c?C? Td>D>Y e:E:FTHORFm) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1253 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(name='cp1253',  encode=Codec().#, 9 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 &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,' # 0x2C -> COMMA '-'p# 0x2D HYPHEN-MINUS'.'E'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$<$CLESS-THAN SIGM=)LgEQUALS&>&K|GREATERR?,SQUESTION MARK @(4YERCIAL A4A(\LATIN CAPITAL LETTER B1i1BC1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151Q1QR1;S1jT1U1UV1V1W1W1X1Y1YbZ1Z '['  # 0x5B -> LEFT SQUARE BRACKET #@'\\'.C.REVERSE SOLIDUS*])XD*?IGHY^/E/CIRCUMFLEX ACCEN_,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/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/{/ZCURLY|-VERTICALB}(RV~.CTILD~3\x7f7TDELET!Au20a1!8EURO SIGQ\ufff$UNDEFINEQ\u201$ SINGLE LOW-9 QUOTATION MAR`\u01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI(&20.SDAGGEx!1! ( @88 -> UNDEFINED '\u2030' # 0x89 -> PER MILLE SIGN)Ffffe)A)jUNDEFIM9$B$SINGLE LEFT-POINTING AQUOTATION MARKhCD h D$E$F$/90$E2018 91$ 6201- 925_RIGHT6ck36kDOUBLE kd545k6 &22656dBULLETF2013!6!wEN DASH"4"7"M"  98" (21QTRADE89a 9999!xaANO-BREAK SPACEE0385AGREEK DIALYTIKA TONOS0600 CAPITAL LETTER ALPHA WITH@!xa"XPOUND!xa%%CURRENCY((:YEN##BROKEN BAR0xa7%1SEC!xa'DIAERESI !xa$ACOPYKuA8xab@!xa NOU!xa #SOFT HYPHE!xa&REGISTEREAu201DApHORIZON!xbB DEO*7xb1BPLUS-MINUS*BSUPERSCRIPT TWObB *8HRE#BKb|ZMICROBzPILCROW'BMIDDLE DOn1038 |EPSILON'\u0389' #0 0xB9 -> GREEK CAPITAL LETTER ETA WITH TONOS '\u038a' # >A>/IO?0xbb=?B?RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKcGCE~OMICRON0xbd@DBVULGAR FRACqONE HALFue5uE3u_UPSILu;fBFBOOMEG{%90@&C0@ESMALyDIALYTIKA AND&91K1K VALPHA&925258BET43434HGAMM545459DELj5555E6767Z7474 38383*TH595CHKAPPqCHLAMD5C'MUxgvgN2uCu'XIdeCe 7a\D\ PiaCDC4RHOe6fffDAUNDEFINED$603a1D18SIG1a1D1'TAZa/D//D/(PH).D.C3.D.(PSf,D,]-D-aFTC;D;HFLDL B aXDX >ON WITH TONO-S '\u03ae' # 0xDE -> GREEK SMALL LETTER ETA WITH TONO<f<F</IO=%b0=/E0=rUPSILON}DIALYTIKA AND&b1N1NVALPHA&b23238BET23232HGAMM343439DELf5353E6565Z7272 18181*TH39393!a2A2HKAPPcb3B3HLAMD3c3C3'MUd0D0N0UEU'XI`IEIvOMICRON5cAFAPec#F#7RHOa!F!FINAL SIGc(F( 3(F('TAcc&F&?&F&(PH4%F%C1%F%(PSb#F#GOMEGc$F$V 72F2<DCFCD <cSFS @cFc8~7fff>qUNDEFINED ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1254 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP7.TXT' withAP.py. y#" import s ### Codec APIs class Codec(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 API getregentry(7 UInfo(name='cp1254',!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 IDL17 -> END OF TRAN SMISSION BLOCK '\x18'  # 0x18 -> CANCEL!9!9!END OF MEDIUM(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+'E11F11FG11G1H11H1I11I1J1LATIN CAPITAL LETTER J 'K'# 0x4B -> LATIN CAPITA1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/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/U '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 MILLE7016)@CAPIzSMECAROF2039EFT-POINTING A5IGATURE O} Y Y $$ $ 9 $E20189L 6201=96 x9kAkdk6 29DBULLd&13WvEN DASH&14")EM"702dS8u21QTRADE \9V 9, 997017 HBYfDIAERE!xaANO-BREAK SPAC}!xa`) INED EXCLAM!xaI4 '\xa3'  # 0xA3 -> POUND SIGN '\xa4' %4%CURRENCY(5(5(:YEN#6#6#BROKEN BARp7%7%kSECTIOL8'8'DIAERESISK9$9$COPYRIGHTa)A) FEMININE ORDINAL INDICATOb5B5LEFT-POINTING DOUBLE ANGLE QUOTAEMARKcDCD+NOd#D#SOFT HYPHEe&E&REGISTEREf*F*UMACROK'b0! B0!iDEGREE3(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWO(b3* *EHREE,BACUTE ACCENT'BZMICROBzPILCROW'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@I WITH GRAVE '\xcd' # 0xCD -> LATIN CAPITAL LETTER I WITH ACUTE 1<e<E< CIRCUMFLEXAfAFA DIAERESIS@Au011/D0@GEBREV'd1|/D1<N<FTILD<2<2<O<7GRAx3<3< q(d4<4< q(d5A5A 6<6< 8xd7@7@MULTIPLICATION SIGN8xd8.8.cVSTROK9=9=Ua<A< b<B< cACA dPu0130BuDOT ABOGu015QS9uCEDILLADESMALJdSHARP !xe! E 5Aq JeE: eE:eE? DeE: (xeE>IRING(xeE ?FeE 0C eE <E< E: E:E?E >F E: ;:LEX '\xe0f'  # 0xEF -> LATIN SMALL LETTER I WITH DIAERESIS 3a'\u011@>/F0>G>SBREVE:7xf1x/F1:N:FTILD:2:2:O:7GRAt3:3: FACUTt4:4: CIRCUMFLEX5?5? 6:6: 8xf7>7>DIVISION SIGN8(8(SVSTROK9;9;Ua:A: b:B: c?C? TAu013D>DOTLESS IcGu015*E7S(sCEDILLA<!xf:" sY<) ### 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 ($. 1): CAdef 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='%',ee=Codec().encodCe, decode=Codec().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,$uCOMMA '-' # 0x2D -> HYPHEN-MINUS '.''E'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=)LgEQUALS&>&K|GREATERR?,SQUESTION MARK @(4YCOMMERCIAL A4A(\LATIN CAPITAL LETTER AYB1i1B1C1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151Q1QR1;S1jT1U1UV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET '\\' # 0x5C -> REVERSE SOLIDUS*])*D*IGHT SQUARE BY^/E/CIRCUMFLEX ACCEN_,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/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\x787TDELET!Au20a1!8EURO SIGQ\ufff$UNDEFINEQ\u201$ SINGLE LOW-9 QUOTATION MAR`\u01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI(&20.SDAGGEx!1! (702cwMODIFIERtFLEX ACCENT  '\u2030' # 0x89 -> PER MILLE SIGN )Ffffe)A)UNDEFINED$F2039$B$SINGLE LEFT-POINTING AQUOTATION MARKD hCD h $D$E$F$/90$E2018 91$ 6201- 925_RIGHT6ck36kDOUBLE kd545k6 &22656dBULLETF2013!6!wEN DASH"4"7"M"702d8"SMALL TILDEH1QTRADE:9a 9999!xaANO-BREAK SPACL0xa1)INVERTED EXCLAM!xa 40CEN!!xa $YPOUND620a{ANEW SHEQEL*8xa5~:YEN#6#BROKEN BAR;8xa7%1SECw!xaDIAERESISK$ACOPY5 dtMULTIPLIC] {b6!xaE+NO#SOFT HYPHE!xa&REGISTERE8xafUMACROKbBYDEGREX(xbBPLUS-MINUSVbBSUPERSCRIPT TWObB *5HREbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DO](xbBuCEDILLAB%ONfq# 0xBA -> DIVISION SIGN '\xbb'  # 0xBB -> RIGHT-POINTING DOUBLE ANGLE QUOTATEEMARKEcECEVULGAR FRAC/ ON=UARTER6d6D6EHALF3e3E3ETHREkS9f9F9INVERTED QUESPu05b03 C01qHEBREW c SHEVA^-1-1-HATAF SEGOL32323WPATAH33333TQAMAT4444GIRIQa5-5-WTSERE-6-6- 7-7- 8-8- 9.9.THOLAM1fffBA-UNDEFINED$"05$ IQUBUa. .DAGESH OR MAPk7 7WMETEG-TUNCTU$QA)`3G RAFcD_GPASE*cDSHIN DOTcDS/DSOF PASUfLIGATURE YIDDISH6VAVf =gVAV YO1f  :L = WGERES fD! 4_SHAYID*  !D! $!H $ $ $  $605dELETTER ALE=d E-'BEdE,GGIMEdE.9DAL\EHdE LETTER VAV  '\u05d6' # 0xE6 -> HEBREW LETTER ZAYIN .7.7.7HET,8,8,T,9,9,7YODXa,A,FINAL KAF2b2B2 ,c,C,HLAMEd.D.7MEMe2E2 ,f,F,^'NU%e02.F02 ,1,1,fSAMEKH&e2/2/ (&e3-3-'PE^4141 +5+5+\WTSADI_F .F'QO\eF8RESDF(SHleF4TAV6fffVFvUNDEFIN $ $7200HLEFT-TO-RIGHT MARKu6200F%.6 - ~~) ### 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,[ pass class StreamReader(Codec,c(s.(): pass ### encodings module API def getregentry(7sreturn XeQInfo(TXname='cp1256',e!e=12(). deRincremental:6r=IE/er/J /Dl/s8r8=+R#cwriter#W #") K[ing TableE[ _t2 = (`'\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&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(I# 0x28 -> LEFT PARENTHESIS ')'# 0x29 -> RIGH,*,A,ASTERISKO+#B#PLUS SIGN$,$C$RCOMMA - D HYPHEN-MINU.'E'FULL STOPK/$F$TSOLIDF0" 30"DIGIT ZEROG1%1%2ONE$2$2$#TWH3$3$3HREJ4&4&BFOURo5%5%#IVJ6%6%2SIXI7$7$3EVE8&8&E-L9&MM$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1UV1V1W1R W 'X'  # 0x58 -> LATIN CAPITAL LETTER X (0'Y'191Y1Z1A1Z1[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/7/G/h/ IH/i/ /I/j/ /J/k/f /K/l/L/m//M/n//N/o/O/p/7^P/q/Q/r/R/s/"t/u/Uv/V/w/W/x/y/z/{/ZCURLY|-`VERTIC~B}(RV~.CTILD~3\x77TDELET!Au20a1!8EURO SIGQ\u067$dARABIC7#PEbQ\u201, SINGLE LOW-9 QUOTATION MAR `\u01926F WITH HOO97201ADOUBoW-9 QUOTATIO%N MARK '\u2026' # 0x85 -> HORIZONTAL ELLIPSIS.0.6.gDAGGER!1!7!jOUBLE (702cw8(MODIFIER LETTER CIRCUMFLEX ACCENTd39<PER MILLE SIGN)F0679A)dARABICcDTTEH-7203-B-SINGLE LEFT-POINTING AQUOTATIOMF0152qCDLATIN CAPIPLIGATURE OEx7068 D4 &CHF0698bE.J,8,F,FDDAL%afY.90-4GAF,6201Y 91,$ 06201` 925_RIGHT6c36kDUkd545k6 29 WBULLEx&13WgEN DASD&14")EM"706a 'KE(21QTRADE 9x9&RRF203a'oSMALL 7200ZERO WIDTH NON-JOINL00 ,706bNOON GHUNNA!xaFANO-BREAK SPACAFCOMMP?P!xa4$ZPOUND%E%CURRENCY(5(:YEN#\#BROKEN BA8xa7H1SECO!xaLfDIAERE!x$ACOPYXPu06bevxAHEH DOACHASHME0xab6a!xaD NO;!xaz#SOFT HYPHEa!xa&REGISTERE]*UMACROKbBYDEGRE!xbGBPLUS-MINUS`(xbB2 -> SUPERSCRIPT TWO '\xb3'  # 0xB3 -> SUPERSC*EHREE,4,4,ACUTE ACCENT'5'5'MICRO SIGN%6%6%zPILCROW'7'7'MIDDLE DOq8%8%uCEDILLAn9"9"$ONPu061b,A*ARABIC SEMICOLO) ;B+RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKcnECEVULGAR FRAC/ ON=UARTER6d6D6EHALF3e3E3T1 QUkS9f;F9AQUESUu06c1/'C0/LETTER HEH GOAL`21114AMZVu0622_2.ALEF WITH MADDA ABOV2C>Hv >>>2WAW{=={ WBELOW%1>/ >?YEH{ G=E =jO-M -7BEH,Y,W , TEHRBUTaaET`d`b `H-L-J -GJEEMC-A -(HA<,: ,K-.C.D%30 D+)TH-'D'R 3%D%4ZAIFu063D8SEE-D*SH.D6SAD3DD,!xd5DMULTIPLICck0DT3DZ,D eD)GH.4gTATWEE<4FEH '\u0642'  # 0xDE -> ARABIC LETTER QAF '\u0643' ,F,K,0xe0*, E0,LATIN SMALL]A WITH GRAVEf4< E1: 3LAM,0xe2*f2,fCIRCUMFLEX?5Ak3? k4MEEl-6-4-GNOONZ7-5-7HEH,8,6,3WAW,!xeV7,CWuCEDILLA<f<8<E<0xe9:9: DACUT8xea:A: 8xeb?B? DIAERESISC> ALEF MAKSUR&55D5Y8xee=IRf?P?FbxFATHATAcj*RKDAMM*d*PTKKASR*T;~!xf:F5O"$fGfAu065o'B'(xf=F=DIVISION SIG0&51)TSHADD+!xf^UQb4UKU!xfaa`f?}? `7200 LEFT-TO-RIGHT MARK[Gu200 %.6 -706dtYEH 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'):,creturnoBinput,errors,enc*oding_table) def decode(self,input,errors='strict'):,0preturn 1cs.charmap_B=,oclass IncrementalEnG r(>cs.xe, h final=False*@:.,][0] D"N!@StreamWriter(Codec,TDpassORead9 9D### 4s module API getregentry(7 2UInfo(Sname='cp1257',e!e=12().ig:.r=`/J //sqr8=E #w##@) K[Ping TEc2 = (`'\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(SUBSTITUTE '`\x1b' # 0x1B -> ESCAPE X'\x1c!C!FILE SEPARATOR)d)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &1 20)CSPAC! 1 EXCLAMATION MARK"+2+LQUOT)#)3)NUMBER SIGNO$&4&XDOLLA&%&5&wPERCENTM&'6'AMPERSANDq0"'" 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+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM' # 0x4D -> LATIN CAPITAL LETTER M 'N'# 0x4E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/ 5C.REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/ /L/m//n//o/p/7^q/r/s/"t/u/v/w/x/  LETTER X c 'y' # 0x79 -> LATIN SMALL LETTER 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 MARK6 Z36Z~4$ODOUBZ F202656HORIZONTAL ELLIPSISF2020.6.gDAGGER!1!7! ( 8(3mPER MILLExM9xEFT-POINTING A h0xa8f" (gDIAEREF@02c7&$DCAROH)xbDtCEDILLAg ?9 Au201Hf9Lv6201'9V6 9kkd9k6 &226DBULL@\3!tEN DASH=F2014")EM" _1QTRADE99 996MAC}Vu02db_OGONE9 |!xaANO-BREAK SPACW jAMMHCENTd!xa$ZPOUND%%rCURRENCY( Ad6LgBROKEN BA!xa%j1SEC8!xd'o~@CAPIO WITH STi!xa=ACOPY7 1015# 0xAA -> LATIN CAPITAL LETTER R WITH CEDILLA '\xab' & # 0xAB -> LEFT-POINTING DOUBLE ANGLE QUOTATION MARKDcDCDNOT SIGN#d#D#SOFT HYPHE&e&E&REGISTEREDP(c6*F*MLATI$AE'b02 B02iDEGREEX(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWOz3*3*6HRE4,4,ACUTE ACCENTS5'5'ZMICRO$ B6%zPILCROW'7L7'MIDDLE DOq(f8%8%pESMALcOcVSTROK9;9;)$ON*Au015 BA*ebBORIGHbBVULGAR FRAC ONUARTERB6EHALF3e 3T1 QUkS9e Au010RSCS ATOGONEAu012= =I=0r= =zTMACRO =3=Cz##c CC<yDIAERESIcc\C\@ R%GABOV1.xAE t1Y== 7= 7&CAs(xcCy sAu017>x xZ <1x KDOT n21@G| Gu013~>K> 2a>! 3= 5L{6_DTIN CAPITAL -LETTER S WITH CARON '\u0143' # 0xD1 -> LATIN CAPITAL <N<WACUTE<5<2< sCEDILLA>!xdxz3>Ozcz4< 6MAC!xdy5= DTILD0xd6w<6< DIAERESIS7@7@MULTIPLICATION SIG 7208.U#cOGONEKk1=9=L=TSTROKVu015a=A=S 6<B< aC= aVu017bD@ZDOT ABOV&7d@E@ L0xdf:F<ESMALJdSHARP Au010/E05A 2r; pI;0E ;v v ;Cv7xe4 E :u !xe'^E>LRING 19 ?E h1;; -OE ;- Me :gE : :1 :t;2' >Gb Gu013z <K<2E < 3p" 6CF! vFr::H CEDILLA '\xf3' # 0xF3 -> LATIN SMALL LETTER O WITH ACUTE /p'\u014d<:4: cMACRON;0xf59" ;5; DTILDu8xf6:6: DIAERESISx7>7>DIVISION SIGAu0178(UcOGONEKc2e;9;L;TSTROKVu015b;A;S; 6:B: csC; Q)@D>ZDOT ABOV 7e~>E> &CAAVu02d9:F:^) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB+ cp1258 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 ~ = ( '\x00' # 0x00 -> NULL '\x01' 1START 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$IG'10#1hDATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1v -4TWOH1{1{ -6HRE\1 /EFOUR]1NEGATIVE k11SYNCHRONOUS IDL12 e BLOCK1UCANCE(19UeMEDIUMIa(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$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'SMALL LETTER A 'b'# 0x62 -> LATIN SMALL LETTER 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 MARf\u01926F WITH HOO97201ODOUBo F2026oHORIZONTAL ELLIPSI(&20.SDAGGEx!1! (702cwMODIFIERCIRCUMFLEX ACCEN7d3PER MILLE&39EFT-POINTING A5@CAPIGLIGATURE Oe A $ # 0x8E -> UNDEFINED '\ufffe' # 0x8F ->$ /90$E2018H 91$ LEFT SINGLE QUOTATION MARK}F2019525ORIGH6c636kODOUBk d545k6 &22656gBULLET3!6!wEN DASH"4"7"M"702d8"SMALL TILDEH19&QTRADEQT SIGN*  9A* F203aB$-POINTING A7015CEbLATIN LIGATURE O D2 $E$7017nzCAPITAL LETTER Y WITH DIAERESIS#0xa0ANO-BREAK SPAC8xa1)INVERTED EXCLAM!xa3]0CEN!xa9$XPOUND!xa9%CURRENCY(5:YEN#6#BROKEN BAR7%1SEC`!xa{a$ACOPY] ) FEMININE ORDINAL INDICATOb!xaty+NO2#SOFT HYPHEo!xa@&REGISTEREfUMACROKbBiDEGREE3bBPLUS-MINUS*BSUPERSCRIPT TWObB *5HREbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DO(xbBuCEDILLAB&ONBoMASCUL bBbBVULGAR FRA ONREARTEbB6FRACTION ONE HALF '\xbe'  # 0xBE -> VULGAR FRACTION THREE QUARTERS9f9F9INVERTED QUES;DMARK1'c01 C01LATIN CAPITAL LETTER A WITH GRAVE<1<1< FACUT<2<2< CIRCUMFLEX}Au010C#/C3A 7BRE4}4< DIAERESIf(c5@5@ RING ABO6A6A07272CsCEDILLA-8xc8>8>E> 9<9< a<A< 8xcbABA Au030&C@`COMBINu ACCENT*dqD1I* C< CA &11DDUSTROKbdDN=DTILD<g&gDgJHOOK'd3eDOk edD< eGu01a%ADHORNdD; (xdDMULTIPLICA6SIGnDn  BDUc D< D< 8xdcA dF@;!xdc^ESMAL4eSHARP 6ew5E0 -> LATIN SMALL LETTER A WITH GRAVE '\xe1'  # 0xE1 -> LATIN SMALL:FACUT:2:2: CIRCUMFLEXyPu0103Ay3? 7BRE48 4: DIAERESISx8xe5>5> RING ABO}6?6?&7070CuCEDILLA8<8<E< 9:9: a:A: 8xeb?B? Au030C>aCOMBIN}u ACCENT"doD1I" e:E: f?F? &11/F0>DUSTROKPf9FN;DTILD:Fu032qF]DOT BELOWZf,hOh ZfF: ZAu01aF?EHORNF9 (xfFDIVISION SIGfFf FUS fF: F: 7xfcF`? TPu01b0@>Au20a9JDONGFYN) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB cp273 generated from 'p5"-m+s/CP273.TXT' with0P.py. g#" import sdAPIs class ($s.Codec):  def encode(self,input,errors='strict'): preturn 1cs.charmap_B=,ing_table) Co de>o)B ooclass IncrementalE r(~>cs. h final=False*Y.S ][0] D"(@QStreamWriter(Codec,TDpassORead9 92###ings module API getregentry(7 QInfo(name='cp273',=02(). eif:.r=_/J //spr7=D #w##@) J[Ping TD5cod2 = '`'\x00'- # 0x00 -> NULL (NUL)7&1&1&START OF HEADING (SOH22222TEXT (STX/3/3/0END_-E-)9c-4-0STRTERMINATOR`_t052 CHARACTER TABULATION (HT53x86765SELECTED 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 OPERATING SYSTEM COMMAND (OSC) '\x85' # 0x15 -> NEXT LINE (NEL+)08+6+BACKSPACE (BS*)87*7* END OF SELECTED AREA (ESA61`86CANCEL (CAN(9^9(^MEDIUM (EM.)92.A.PRIVATE USE TWO (PU2188f'B1SINGLE-SHIFT THREE (SS34)1c4C4FILE SEPARATOR (IS40d0D0ZGROUP1ae1E1jRECORD21F2JUNIT01(80b 200PADDING CHARACTER (PAD31313HIGH OCTET PRESET (HOP3  223BREAK PERMIT0HERO&PH63i362NO 9/'NB/4/4/INDEX (INn%2FEED (LF12rTRANSMISSION BLOCK (ETB;bg`2 PSCAPE 2wpTABULATdSTm 2:WITH JUSTIFICME(HTJ)8a*D~V~ .rPARTIALCFORWARD (PL{)x8020 6X7U027ENQUIRY (ENQ)6/ACKNOWLEDGE (ACK- *wBELL (B9 3 DEVICE CONTROL STR.6(DC9$3$POf&PU13"SYNCHRONOUS IDL}Y93@T ST'(S9#3#l<6(CCU9|3.MESSAGE WAIT%MWV94PSTARTUGUARD&SP00;kF(EOTl =3=l'SO 434 GRAPHICI0DUCFSGCIw 131FE >= 939IEQUENCE =&CSz1&@ FOUR (DC4) '\xA15' # 0x3D -> NEGATIVE ACKNOWLEDGE (NAK) +Y'\x9e6E6PRIVACY MESSA1%PM001a':" fF0SUBSTITUTE (SUB, ) ,!40,DPACE}#a0$M 41!NO-BREAK S*)e2*2*LATIN SMALL LETTER A WITH CIRCUMFLEXj{=3@EFT CURLY BRACKET.:\xe4.nEGRAV#e1l5; FACUT;3;6; FTILD; /47; RING ABO7{8@C_dEDILLA.f9=N= )c4xA;lCAPITADIAERESIS|.>BAFULL STOP%<%C%LESS-THAN SIGN*(*DL'vPARENTH{+,:7LUSQ!%/EXCLAMATION MARK}&,5/AMPERSAND%C\xe9(`53 Em ` 5D; DI\xeb{D@ I\xe8?U? Ud;UI 5U;f{Z@c?Y?~85W =d\=U $b=gDOLLAR*'?sASTERIS)$9mRIGHT :;-:SEMICOLO^%:c ACCEN--6;HYPHEN-MINU//(>TSOLID#9\xcj6&[e(ElSQUAREmcm6q%\xc1' # & 0x65 -> LATIN CAPITAL LETTER A WITH ACUTE '\xc3' @ # =6= FTILD=5=7= RING ABOVB7B8BCtCEDILLA)d1?9?N? )f6=A=ESMAL6O;DIAERESIS|,< :B?CCOMM%!C!PERCENT SIGNI_(D(sLOW LIN(>$E$GREATER-THANQ?-F-QUESTION MARKzC\xf8, 70):SSTROKI\xc9<1< vE@ va=2= CIRCUMFLEX)cbB3B :\xc4A 7GRAd~sIe=s=fBxBcAwA`:7u!0 AC:(`CCOLO#!BgNUMBER9\xa$7H1SECH2"'"H0APO#PH=uJgEQUALSu"'D1OTAwEdI8E IG8G U0: 0B0( 0C00 0D00  00 0F`g8 0G0h0 0H0i0I04\xa38LEFT-POINTDOUBLE ANGLE QU3bEORIGHF!f0 # 0x8C -> LATIN SMALL LETTER ETH (Icelandic) '\xfd' # 0x8D ->>Y WITH ACUTE;e;E;_THORN{)b1@F@PLUS-MINUS SIGNk(b0+ 90+gDEGREE'j$ 91' JWk020K0l030L0m040M0n050o060O`p070P0q080Q0r090R0C\xaa3} 9A0 FEMININE ORDINAL INDICATO6b6B6oMASCUL7 )e6mC7A)b81tCEDILLAcTeCAPITA~V)a4VCURRENCYH\xb5)AYMICRO&)df&SHARP S (Germans<2ASt0T0u0U0v0V0w0W0x0X0y0Y0z0Z09\xaA INVERTED EXCLAMATION MAR:\xb5MQUES2d@A &d&A < @(d(A%*aB4REGISTERED#a2SB6JCENT%3%5KPOUNK B9YENJ)b7JMIDDLE DOI\xa9&COPYRIGH@'BCOMMERCIAL ASbzB6 -> PILCROW SIGN '\xbc'  # 0xB7 -> VULGAR FRACTION ONE QUARTER7d787EHALF4e494ETHREmS:aA:UNOT S|[ B$VERTICAL LINEMBu203C)GOVER$3xa8P$D$DIAERESI)b4%E%ACUTE ACCENTq9xd7(F(MULTIPLICAb9\xeW C0/ LATIN SMALL LETTER A WITH Ak&C1?PCAPIT AB222B2C232C2D242D2E252F262G2k ,GH22H2I22I29\xa\CSOFT HYPHEf(Y (O(CIRCUMFLEXg6CBROKEN BA)f2& fCGRAVI\xf3; ;:)f5;3;FTILDv ,D?U ?Jw?D?JK2?K2L2?L2M2?M2N2?PO2?OdP2?P2Q2?Q2R2?#b95D?UPERSCRIPT]I\xfb+C, C}=-CRIGHT CURLY BRACKE fLo LamL; Lf; # 0xDF -> LATIN SMALL LETTER Y WITH DIAERESIS '\xd6' # 0xE0 ->?eCAPITAAOA)f7A1ADIVISION SIGNjS& j2) jT232TdU242U2V252V2W262W2X272X2Y282Y2Z292Z2C\xb25A2SUPERSCRIPT TWO+)d4+B+%CIRCUMFLE#\\@CBREVERSE SOLIDU:\xdD+m UGRAVE3jE= FACUT=5=F= CTILD=0:FIDIGIT ZERJ1&.&#ONKK*K%%3HREL''BFOUR7&&I])&&#SI %%3EVE8 'CEIGH9''$NI14\xbFC\xdbV-U ]? SQUARE BRACKE4\xdrr ap== )9f=APPLICATPROGRAM 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): Adef e(self,input,errors='strict'):,:creturnoB=,4ingCo6o*decode(input,e!rrors,decoding_table) class IncrementalEncoder(>cs.): def e, (self, input, final=False*.sreturn Ucharmap_@:F".e?[0]De'@StreamWriter(Codec,Dpass0Rea9 92###ings module API getregentry(7 eQInfo(name='cp424',!e=02(). if:.r=_/J //spr7=D #w##@) J[Ping T%D52 = '`'\x00'- # 0x00 -> NULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ&(9c&4&TSELECGt 5!HORIZONTAL TABULATIONw"86260REQUIRED 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$IG1i1i@DATAxK51u1uDEVICE CONTROL O1w1w -3TWO(x1|1| -5HRE91RESTORE/ENABLE PRESENTj5]j1 a(08#BACKSPAC}8d1 PROGRAM OPERATOR COMMUNIC1]UCANCE(19~dMEDIUM.9[PUNIT  1CUSTOMER USE1ILE SEPA~1d' # 0x1D - > GROUP SEPARATOR '\x1e'  # 0x1E -> RECORD+f+F+NUNIT)'80) 20)1DIG*DLECT{(81'1'START OF SIGNIFICANCE02020OFIEL(83*3*WUNDERSCORT4*4*BYPASS OR INHIBIT PRESENTATIONn7 8 259LINE FEED$2x17&\ 26$0ENDTRANSMISSION BLOCK4b474FSCAP8!8!SET ATTRIBUT(9(9(^4fEXTEND(8a/A/pET MODE dSWITCH8B-CONTROL SEQUENCE55FIX2c_C2rMODIFY (051D1tENQUIRYS(06"ACKNOWLEDG0DBELLE93%3%13SYNCHRONOUS IDL93INDEX RETURc(x93W POSI(x933hUPARENv9NUMERIC BACKSPAr0'3vUBSCRIP~3NT TABULc(x93REVERSE FORMk93USTOMER USE THRE1tDEVICE 6FOU" WNEGATIVE q9Q3- uSUBSTIT  c4Au05d_4HEBREW LETTER ALEF-- -$BE,k, ,DGIMEC.. .9DAL\~. .HY{+ +7VAV, ,DZAYIZZ. .H, ,T,!xa7ACENT.FULL STOP$<$LESS-THANM()QLEFT THESIS '3+' # 0x4E -> PLUS SIGN +'|$F$VERTICAL LINE(&( 50(AMPERSAND$`\u05d9)p 51$HEBREW LETTER YO,a,2,FINAL KAF^b232 ,c,4,HLAMEd.5.7MEMe262 ,f,7,^#NUH&e0282 ,1,9,bSAMEKH!* A/EXCLAMATION MARK+$+B+gDOLLAR@*&C&sASTERISI)#D#RIGHT PARENTHESISu;,SEMICOLO!xa 7NOT-G6HYPHEN-MINUn/'TSOLID"2'064AYIVu05e3-PU^41 +5+RTSADIM_64 .7.'QO&e8,3RESt6HD!xa6BROKEN BAR,z6RCOMMA % hPERCEN&_'7LOW>#GREATER-THANu?,KQUESYV\ufff=7xUNDEFINe7 K2TAV P P t $!xau{7NO-BREAK SPAC M M |$ r $62017jzDOUBLE `7gGRAVE AC.:'a^# \XNUMBE@&bERCIAL ATn1"'" TcAPOSTROPHP=MeXEQUAL"&_)OT '\ufffe'  # 0x80 -> UNDEFINED 'a'$1$LATIN SMALL LETTER A/b/2/B/c/3/C/d/4/e/5/E^f/6/F/g/7/G/h/8/H/i/9/I/3\xa{A/EFT-POINTING DOUBLE ANGLE QUOTATION MARKDbDBDORIGHEAufffyCE T\$D$E$2xb1'lF$PLUS-MINUS SIGN0*9gDEGREE&j#" 9JUk/_l/L^m/M/n/o/O^p/P/q/Q/r/R/ ?9c 9$ 2xb8c9cCEDILL (a4FCURRENCYG\xb5(AWMICRO%~"ACTILDs SNt/T/u/U/v/V/w/W/x/X/y/Y/z/Z/ AAA BA A '\xae'  # 0xAF -> REGISTERED SIGN '^'* B0*CIRCUMFLEX ACCENT,B\xa3/,1,HPOUNQH\xa5%2%7YENtH\xb7#3#MIDDLE DOm9%4%COPYRIGHTNaN5)kSECTIOu6P6'yPILCROWN(bc'7'VULGAR FRAVONE QUARTER(bd686EHALF3e393ETHREkS9[6 BA9`LEFT SE BRACKEG].B.C/B\xaf2C/SMACRO0H\xa8!D!DIAERESIH\xb4$E$[ACUTEOdMULTIPLICA{RCZCURLYA-LATIN CAPITAL LETTER AUB11B1C11C1D11D1E11E1F11G11GbH11H1I11I18\xaICSOFT HYPHEAufff>CUNDEFINE?\$$ $ $  $} DJ.J9K1K1L1L1M1M1N1O1ObP1P1Q1Q1R1 DUPERSCRIPT ON DDDD -> UNDEFINED '\ufffe' # 0xDE -> UNDEFI$F$\DSH E0$REVERSE SOLIDUSr2xf7,*1*DIVISION SIGN(S% E2(LATIN CAPITAL LETTER YT131TbU141U1V151V1W161W1X171X1Y181Y1Z191Z1B\xb24A1SUPERSCRIPT TWO* L EB*L /EC$D$E0fFDIGIT ZER1%%2ONE$II!3H$3HREJ4&&BFOURo5%%#IVJ6%%#SIAr$3EVE8Jg&CEIGHQ9&\&$NI)3\xbPFP  FRFRFRFR2x9fR 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 ementalDecoder): def decode(self, input, final=False*.preturn /cs.charmap_@:F.errors,ing_table)[0] class StreamWriter(Codec,UzJpass9ORead9 9 ### encodings module API getregentry(7 QInfo(1name='cp437',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: 0c7,k # 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( O9fu@f9fR  9fATIN SMALL LETTER U WITH CIRCUMFLEX 0x0097:0f9, # LATIN SMALL L@VGRAVE;8;f; Y{DIAERESIS?9?+d6?eCAPITA|OAaAcA bA%a2ACENT SIGNc%3%[POUND&d&5&;YEN$e$E20a7$kPESETA'f'6019FEHOOK!a0:50e1a:A:FACUT#a1;d; I;2;f!v v3;av  ;4; NGTILD5;d; y=6=a FEMININE ORDINAL INDICATORfb6oMASCUL7 bbbINVERTED QUESTION MARUE2310RREVERSED NOaAaA$$bVULGAR FRACONE HALF3bX4gQUARTE%DqEXCLAMAp UE00abLEFT-POINTING DOUBLE ANGLE QUOTEs&0bEORIGHFb6259LFG SHAbk'25lMEDIUM(X6259XLDARK&C6250.BOX DRAWINGS 4EICALb?E252477P AND W@D6256 @q1 SIyAHO?256HXHa6255M CDOWN| Dn6255D &56 D?255YA82557, # BOX D!RAWINGS DOUBLE DOWN AND LEFT 0x00bc: 0x255d, # BOX D=/UP;d;c;$UP{vv SINGLE}eBbB2}RBfB/10B_LIGHT#c0<4< RIw"c1;3;HORIZONTAL@2@2; B3B1B VERTICAL@ 4A0: z593zF6F/5e} #c7IfI IZ8IaI@9<<za>/69zMbA6A C6GB |6R|G /67#UPA Rd/68HH Qd%6/WN//6575k d95 gCCC/52EB3EyV>6IC6CNNdU1i% 0x00da: 0x`250c, # BOX DRAWINGS LIGHT DOWN AND R )0x00db: 0x2588=FULL BLOCK&c&4&LOWER HALF,d,OLEFT+e+%90W,f,8,?UPP e0,E03b1X GREEK SMALL LETTER ALPHA!e1450df4ZLATIN4vSHARP S62653936jeCAPITAlGGAMMl36c6 &PIg41ag 8SIGg56c6 g 46450b5MICRO SIGN7&&3c6TAU282%a6X2 )'PH9494GTHET]a6/a9j GOMEG6?03b 8DELj521ejINFINITY<03c  '03 2gEPSILO&22INTERSECTI(f6226IDENTICAL TOfCPLUS-MINUS f62263GREATER-THAN OR EQU_6226oOLESS1623232TOP)FGRAL6232oBOTTOM0%f7DIVISION6224oALMOST&0b DE R6221BULLET OPERATOR&0bMIDDLE DOT&E221aSQUARE RO'&07SUPERSCRIPT lf60b2c<'TWG625abBLACK '00(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'@ # 00 -> NUL(!1!1!START OF HEADINGN2-2-2TEXW3*3*0ENDU (4(4(pRANSMIS505 -> ENQUIRY '\x06'  # 0x0006 -> ACKNOWLEDGE (7(7 -> BELL!8!8!tACKSPACGt$$ o9&HORIZONTAL TABULATIONXn2a2LINE 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`4141EFOURa5050NEGATIVE11SYNCHRONOUS IDL 1 END OF TRANSMISSION BLOCK 1UCANCE*19YeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAN0"'"R*2APOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ>{3{DIGIT ZER8''2/&y&)&&t& (t'sO3FIV$ 'q'2SIX3& 0x0037 -> DIGIT SEVEN '8'# 0x0038 -> D(REIGHT(9(9(BNINE':'a'CCOLOq;"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)LSMAL5b1062 -> LATIN SMALL LETTER B 'c'# 0x0063 -> LATIN1C1d141D1e151E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s1S1t1T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LIN^}*ORIGHZ~0CTILDR3\x7C7UDELET#"c7H#8PCAPITC WITH CEDILLA3\xf@U>DIAERESIJ\xe9E@6ACU*e2<A<CIRCUMFLE-J\xe4A"A0@1@EGRAVy*e5<<<RING ABOA L*eaYx<bAiA <\xe8' # & 0x008a -> LATIN SMALL LETTER E WITH GRAVE '\xef' 2 # <b<I<DIAERESIS@e@c@ CIRCUMFLEXAcAdA *c4<e<eCAPITAA*c5BfB RING ABOB)c9C/90CFACUT6>1>IGATURE A4c4246f-&936j&O+fw4A +*f25@ *fb<6<U 7A } $/98<Y} d99@ |B %9 B Ba}CENT SIGN*a3gZPOUND' 698YEN%Pu20a7NZ9iPESETA(1019( F^DHOOK e1a a{ ; yd<y <f'a xK <ax < N+ETILD5d<~ C>a FEMININE ORDINAL INDICATORb7voMASCUL8 rarINVERTED QUESTION MAR Pu2310ZGaeREVERSED NO QaQ %b#4VULGAR FRACONE HALF ZC5eQUARTE+aTqEXCLAMArxab' # 0x00+ae -> LEFT-POINTING DOUBLE ANGLE QUOTATION MARK '\xbb' # 0x00afFORIGHGPu2591IG b0GLGc SHADEo(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS VERTICAL(24_48 A AND]A65As1 SIBI 6IYI(567ICDOWN~E5E8E 9E# ^aB 97b9 wd>c>%UPAzc<d</UP}E #UPS(10 C1c=&y3<<HORIZONT@cAC1C  E 0?c|3|y G'5ec (5fJXJ[(5aJ5 |(69| |R6cD SZ 5C~ [RAWINGS DOUB>LE VERTICAL AND HORIZONTAL '\u2567' # 0x00cf -> BOX DRAWINGS UP SINGLEBw DOUBLEI8I/d0I3 I_I4I1IRDOWN 5 KaK5K2K5 KaK(59K3K#UPISRIGHTD #4DwDD25D  F3F6F5(6bF7F}J (6aO8OOe1n9OL!UPHFLEFT;(0ca;kXd>8yb>FULL BLOCK' c'LOWER HALF- d-?EFT,(90e,-8-?UPPG03b1Ze GREEK SMALL LETTER ALPHA0xdf3beZLATIN5sSHARP S7Hu039eleCAPITAnDGAMMnHu03ce7 &PIiai2 i9SIGi 77 i5!xb xMICRO SIGNceY\6TAU3 a6he=3 'PH9e#5GTHETda e7GOMEG7b7 26DELlH221e&INFINITYcZ 0%3eEPSILO9222/INTERSECTI)6+f+BIDEN#TOxRfPLUS-MINUS1226Af ATER-THAN OR EQUAL TO # '\u2264' # 0x00f3 -> LESS-THAN OR EQUAL TO 28320242TOP HALF INTEGRAL.1.5.oBOTTOM10xf7/61DIVISION SIGN[0248,7*lALMOST!xbV8,kDEGREET(19T9(BULLET OPERATOR+xba,MIDDLE DOT'Xu221aSb'SQUARE RO(807f(c(UPERSCRIPT LATIN SMALL LETTER 0xb2;d=&TW!5a8e,bBLACK x'Uf)NO-BREAK SPACE ) ### Encoding Map e_map = {Q_100:g000,Nv2NUL- 1 1 START OF HEADINGL2,2,2TEXU3)3)0ENDS '4'4'pRANSMIS5/5/VQUIRY#6#6#ACKNOWLEDGE'7'7'(BE8 8 2ACKG9%9%HORIZONT0ABU?O11a1a1LINE FEEDb%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .zu11 .7HRE^1 02FOU_1NEGATIVE z11SYNCHRONOUS IDL1Fe BLOCK@11VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPAN1_GROUP+1oRECORD,1OUNIT*22 22EXCLAMAT-6MAR2022, # QUOTATION MARK 0x0023:, # NUMBER SIGN'4'4'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt7%7%POSTROPHE&8&8&LEFT PARENTHESIS,9,9,ORIGH-a-a-wASTERIS>b$b$KPLUSc%c%VCOMMAd!d!HYPHEN-MINUe(e(FULL STOPMf%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&&ON~#32%2%'TWJd,33%7HRELd3dFFOURc3c7FIVLa3a&6SIXKa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES]4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G242H242I242J242n44&Ld4dM2 4 24425525 5  Q52: 0x0052, # LATIN CAPITAL LETTER R 0x0053:,/ #2S24242 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 B0/630 C06 D06 06 0F`6 0G06 0H06 0I06 0J06 0K06L060M060N06O077`P07 Q07 77 977  77 77 77 77 77 77 77]CURLY77`VERTIC_77d, # RIGHT CURLY BRACKET 0x007e:, # TILDE!f!f!VDELET""a0"f"NO-BREAK SPAC*1*%adL INVERTED EXCLAMATION MARK"a25%9b5CENT SIGN%3%c%[POUND&5&;YEN$a$%a6J FEMININE ORDINAL INDICATORb6e6LEFT-POINTING DOUBLE ANGLE QUOTcEaE+NObm8$jDEGREEbj%f1'PLUS-MINUS+`fSUPERSCRIPT TWOb@e[MICROQ7fMIDDLE DOybh7oMASCULi bimORIGHjbj/VULGAR FRAC ONFARTE"bda7FHALF4@aAQUESm "c4f8LATIN CAPITAL LETTER A WITH DIAERESISsc8$LARFABOV"c6%92 BIGATURE A5/805CvCEDILLA9t? E?7ACUd/a5| N= d9= O=qdO9 /UA%eAESMALfSHARP e 8 6'7GRAe0 m; ke0+83.;CIRCUMFLEXe4@le+ekes"e88 / 8; a: 0x0088, % # LATIN SMALL LETTER E WITH CIRCUMFLEX 0x00eb:089,@ DIAERESIS?c?d? IVGRAVE;d;/a1;GACUT;e;/8c;f@b@"f1?/a4? NFTILD"f2;/95; O; 0"f3;/a2; 0"f4;/93;0#f6@ 07?%f6DIVISION SIGN"f9)%97)Ua;a ; 9v {/98 Y ?$19Rf? F?DHOOKn#39QeQGREEK CAPITA=VGAMMA68ie16FTHET6alB67SIGlaxe65PHIaD%ea4FOMEGb+e06 GGALPH4VeFj 47DEL#b5>eh eEPSILO33c06jPcog1 mc}45TAUkc23207fSUPERSCRIPT320aF9;hPESETAD3221fBULLET OPERATOR32214fSQUARE ROOT'neINFINITY$2veINTERSECTI3224>feALMOST EQUAL TOS6f{IDENTIC(4: 0x00f3, # LESS-THAN OR EQUAL TO 0x2265: 0x00f2,1GREATER423104%a94REVERSED NOT SIGNa#32-%f4-TOP HALF INTEGRAL-1Z%f5-oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi2502i'b3i 9hVERTIC7c7/da7 DOWN AND R57/bf=FLEFT<4y/c0< /UPw8;d$; uc%{2b fA 2o3/c18@(F5doDOUBLE5bq:C05d4aSINGLE NE3:6#WN4EVEt 45/b8r?6/b7DDTD7DbDD=2UP o9d#UPCTaCcK <b</be BIb B dcB}e;c?fIKIOJZ6 PIB DRAWINGS VER!TICAL SINGLE AND LEFT DOUBLE 0x2562: 0x00b6, # BOX DRAWINGS VERH8HXH3H9H?OA4A/d1A(WNHORIZONTAL5J2JJ 6J/cbJLQ DOWNJ7CfC/UP8H/d0H9H/caHE/UPaA/d8AL G bN7N  cN/ceNE N"80GdUPPER HALF BLOCK,cs?LOW,OLFULLR&ddR}9_RIGHT"91bAL,FSHAD9{MEDIUM (eKDARK&aflBLACK SQUARE } """ Python Character Mapping Codec cp500 generated from 'MAPPINGS/VENDORS/MICSFT/EBCDIC/CP500.TXT' with gencNP.py. v#" import ccs ###sAPIs class($.1): Qdef 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): pass 2 ### encodings module API def getregentry(): return codecs.CQInfo(!name='cp500',d0e=C02(). deQincremental:6r=IE/er/J /Dl/streamreader=S R R#Ewrit#W #1) J[ing TableDZ _t2 = '`'\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 "42Fn 2FHLINE(x1$2HTRANSMISSION BLOCK72X j8W2W S(x8X2X a2R R8R# 0x2C -> CONTROL '\x05'  # 0x2D -> ENQUIRY"6"E"ACKNOWLEDGE&7&F -> BELg'90 30C(91"1"1 32"SYNCHRONOUS IDL(93M3+ o4"4"/35" 6"0f7"END OF TRANSMISSIOND(988. 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#4?CjdEDILLA)f<N<[)LEFT SQUARE BRACKETh..FULL STOP$<$LESS-THAN SIG(){vPARENTH ++GPLUSO!$EXCLAMATION MARK&+5AMPERSAND$8\xeL5"SES B53:353?3%53> 3d53I53:fy8?c>7> dx 0x59 -> LATIN SMALL LETTER SHARP S (GERMAN) ']'# 0x5A -> RIGHT SQUARE BRACKET/$/B/DOLLAR SIGN&*&C&ASTERISK#)#D#xPARENTHESIS,;,E,SEMICOLOs^$F$CIRCUMFLEX ACCEN-, 60,HYPHEN-MINUw/'1'TSOLID"B\xc2%= 62"LATIN CAPITA}vA WITH H\xc4A3A VDIAERH\xc0@4@ UGRAVE|1<5< FACUT<3<6< FTILD<5<7< RING ABO7A8ACvdEDILLAd9>N> (a6z-BROKEN BARa,"2 #CCOMM% 0PERD_'!sLOW LINJ>#GREATER-THANO?, QUESTION MARB\xf8+7 NO STH\xc9;0; E= Qa<J<JbAJAJ J@ Jd|JIe<J<fAOAc@N@`97L p:'7# 2@NUMBU@&8XERCIAL A0"'"90APO#PH;=M;gEQUALS5"&5=OTA6d>86 8F88 s@/+SMALL LETTER B 'c'# 0x83 -> LATIN SMALL LETTER C/d/4/D/e/5/E/f/6/F/g/7/G/h/8/H/i/9/I/B\xab2IA/EFT-POINTING DOUBLE ANGLE QUOTATION MARKDbDBDORIGHE(f0CEETH (ICELANDIC)fD=Y WITH ACUT3\xf:E:_THORNy(b1F?PLUS-MINUS SIGNb 90*gDEGREE&jM1 91&JUk/2/l/6L^m/6M/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~ELANDIC) '\xdd' # 0xAD -> LATIN CAPITAL LETTER Y WITH ACUTE 1<e<E<THORN (ICELANDIC)AaAFAREGISTERED SIGN*2k B0*JCENT$3$1$KPOUNI5%2%9YENH(b7#3#MIDDLE DOT9%4%COPYRIGH N5)kSECTIOu6P6'zPILCROWc'7'VULGAR FRAVONE QUARTERb/B86EHALF3/B93ETHREkS9aA9(NO|1 t BB#`VERTICo%IN`"af+(C(VMACRO8!DIAERESI(b4$0 ACBdMULTIPLICA{RCLEFT CURLY BRACKE+A-cAB11B1C11C1D11D1E11F11qG11GH11H1I11I18\xa7CSOFT HYPHEfaCWESMAL@O@CIRCUMFLEXefC? fC>CGRAV8\xf.C:2CC+:CTILDt}D718J.8JK18K1L18L1M18M1N18NO18ObP18P1Q' #  0xD8 -> LATIN CAPITAL LETTER Q 'R' # 191R1B\xb941A1SUPERSCRIPT ONE*(fb*B*ESMALU WITH CIRCUMFLEX?c?C? DIAERESIS> D> FGRAVaxE: FACUT:f:F:Y \<! Y E0>REVERSE SOLIDU7,*1*DIVISION SIGNS% R2( YT131TbU141U1V151V1W161W1X171hY13YbZ13Z1B\xb24 34TWO*(d4*3 OD5(d6A5A )xd7@ 9(d3|9< ;(d5<;<CTILDw09F9DIGIT ZERZ1%4%I0I$#$3HRE&&3FOUJ% %I%%#SI $$3EVE8&CEIGH5L&&NIbF 8\xdFdFA@  F< 9FCONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """Python Character Mappinlg Codec cp720 generated on Windows: Vista 6.0.6002 SP2 Multiprocessor Free with the command: python Tools/unicode/genwincx.py 720 """#" import 'scs ###APIs class($.): def eZ (self,input,errors='strict'). returno.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 QInfo(aname='%',d!e=02(). if:'r=y/J //spr7=D #w##") [Ping TD5cod2 = '`'\x00'- # 0x00 -> CONTROL CHARACTER>-1-1- 2-2- 3-3- 4-4- 5-5- 6-6- 7-7- 8-8- t+9- n-A- 3x0b/B- c-C- r+D- 3x0e/E- f-F- 11 111 -> CONTROL CHARACTER '\x12'  # 0x12 -> CONTROL C-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- * v 20-RSPACE!!1!EXCLAMATION MARK,",LQUOT*#*NUMBER SIGNQ$'XDOLLA'%'wPERCENTO&(AMPERSANDt2"'"APOSTROPH(KLEFT PARENTHESISR,'),ORIGH-*-sASTERISh+$GPLUS,%2MMA-!HYPHEN-MINU.(}FULL STOPM/%uTSOLIDH0#3kDIGIT ZEROI1&p&#ON~)3i%#TWJ!%d%3HREL'd3FOU&cM3FIVL &a&2SIX%a%3EVE'b'E<N']'$NI1:VVCCOLOn;!SGSEMI%<%SLESS-THAN}=*\XEQUAL>'[|GREATERT?-cKQUES@)4iCOMMERCIAL AT<A)lLATIN CAPITAL LETTER 4B2y2BdC2x43 -> LATIN CAPITAL LETTER C 'D'# 0x44 -> LATIN2D2E252E2F262F2G272G2H282H2I292I2J2A2J2K2B2K2L2C2L2M2D2M2N2E2N2O2F2O2P2/502P2Q212Q2R222R2S232S2T2 T2U2 U2V2 V2W2 W2X2 X2Y2 Y2Z2 Z2[2 EFT SQUARE BRACKE[%\\05REVERSE SOLIDU]* +ORIGH[^0CIRCUMFLEX ACCEN_-cOW LIN`$6YGRAVELa(ESMALA3b0 0B0c0 0d0 0e0 0f0 0 g0 0 h0 0i0 0j0 0k0a 0l0 0m00SMALL LETTER M 'n'# 0x6E -> LATIN SMALL LETTER N0o0F0O0p0/700P0q010Q0r020R0s030S0t040T0u050U0v060V0w070W0x080X0y090Y0z0A0Z0{0B0EFT CURLY BRACKEN|.C.VERTICAL LINEW})D)ORIGHX~/CTILDPC\x7f$7CONTROL CHARACTETR\x80'E\x81 (e9C8E WITH ACUT~)e2;A;CIRCUMFLEF\x840KKEGRAV&86F7FvCdEDILLA)ea= )eb@@DIAERESII\xe8?? e8Izez\?%8d&8e f 9yQu0651n98ARABIC SHADD)^))3UKUA\xf4O" (Oa@9CURRENCY SIGiBu064itTATWEELIf 9,Uf9@ Hu062_"GHAMZe2e /BALEFME ABOzn3~?x ?}?ARABIC LETTER WAW WITH HAMZA ABOVE '\xa3'  # 0x9C -> POUND SIGN&Qu0625(&D&ARABIC LETTER ALEFeWBELOW?6?E?8YEH>}7>F>}l8..A0.7BEH-9-1-TEH MARBUTA5a525-b-3-Hc.4.GJEEM\d.5.(HAe-6-K.f.7.6DAL'30-8-)TH.1.9.R'32-A-7ZAI3.AB.8SEE.4\ *SH/A3SAD"xaWALEFT-POINTING DOUBLE ANGLE QUOTATIONlKEbEORIGHFGu259pBLFT SHAD 'jB mMEDIUM(dBLDARK&0NBOX DRAWINGS fVERTIC7252B7P AND W2Hu256 @q1 SIyAH-HXH5BG HCDOWN|DxB^Dt DYA 8B8uB=%UP<xIB ;/UPwLB Bu 1B B1 C<34' # 0xC1 -$> BOX DRAWINGS LIGHT UP AND HORIZONTAL '\u252c' # 0xC2 -@ODOWNB1B3BVERTICALFR'004A3z59 zF'5e6F@fSINGLEv DOUBLE'5fI7I8IZIaI8I@ M'54<9< >'69>A>zM'66ABACCC 5BDB|RE: |G7FG2UP A R&68H/D0H H^Q6-D1H45/J5kD7#UP559 gCC2CE3EBEy'6bE> CDCN&1iU eFLEFT:0QDQ:!_=8wMFULL BLOCK&0LOWER HALF,+9ED ,8,?UPP7063"EARABIC LETTER DAD7063IE -TAH '\u0638'  # 0xE2 -> ARABIC LETTER ZAH '\u0639' -3-7AIN-a-4-)GH/'41/5/$FE1xb5+6-MICRO SIG!42(7& 6QAF'43-8-K-4-9-7LAMZA-8MEE.6[B.8NOO7.C.H6Wu0648-D-7WAWE-ALEF MAKSURA6F6Y7226 F0-IDENTICAL TOUb F1(xFATHATAc+KDAMM+d+KKASR+e+f(~('50({((22FLMOST EQU$"xbQFiDEGREE7221FBULLET OPERATOR}"xbYRMIDDLE DOT&Gu221FSQUARE RO'(07SUPERSCRIPT LATIN SMALLx"xb<%TW*225akFbBLACK x&SNO-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'):, creturno B=,ing_map)m0m*B mm)Incremental$er  h final=False*W.Q ?[0]DP~L turn codecs.charmap_decode(input,self.errors,ing_table)[0] class StreamWriter(Codec,D8cs.): pass9ORead9 9### encodings module API def getregentry(7sreturn QInfo(name='cp737',d!e=02(). incremental:6r=IE/er/J /D/spr7=c*R#w##0) IZping MapAWd_map =2make_identity_dict(range(256)) map.update({F0x0080: 0x0391,k # GREEK CAPITAL LETTER ALPHA61626 7BET52535 GGAMM63646 8DELl4656 vEPSILON5868 Z6575 47484 )TH68696 (IO 95a5 GKAPPxa6b6 GLAMD6b6c6 &MUsc3d3 N3d3e3 &XIfe3f3 XOMICRf8/a08 Pk9SaS 5RHO9Qa 7SIG9Ra &TA<9Pa U9Ra 'PH Na C4Ma 'PShMa FOMEG9MbOSMAL9Lb 4 9Ib 3 9Gb4, # GREEK SMALL LETTER DELTA 0x009c:@3b5,m # GR4vEPSILON6d666 (ZEie373 2f282 (TH4#a0494 'IO#a13a3 FKAPP6#a24b4 GLAMD434c4 %MUe#a41d1 N151e1 &XIb61f1 WOMICR"a76/c06 Pg8111 6RHO9232 GSIGM`a424 kFINAL :b:4: 'TAj6c6 U6a6c6 'PH:5c5 C25c5 &PSdb36259LIGHT SHADEb'6259_lMEDIUM(6259LDARK& 6250NBOX DRAWINGS VERTICAL62527 AND LEFT@"6256 @qu SINGLEAg DOUBL 9?256H8HXK6255 CDOWN|D^6255DxDp6256 D Y}?255YpAy{6255yu6255!=%UPx6255 ;/UPw6255 Bu 6251H Bc1 S LIGHT UP A ND RIGHT 0x00c1: 0x2534, # BOX DRAWINGS L. UP AND HORIZONTAL@2@/2c@ ODOWNB3B1B VERTICALF 4A/00 593zF6F/5efSINGLEv DOUBLEK7IfI 8IZI8IaI@ M9<< >a>/69zMbA6A CcC dB5B |e:6R|GfG72UP A R#d0H8HH^Qd%6/WN//6575k#UP$95 CCC/52EB3EyV>/6bEIC6CNNdU1i e6LEFdQ0Q:6wM8wFULL BLOCK&08LOWER HALF,8+ 9E,8,?UPPe603c GREEK SMALL LETTER OMEGA00e1: 0x03ac , # GREEK SMALL LETTER ALPHA WITH TONOS +0x00e2: 0x03ad? EPSILONA3AeA T~4=/ca= $IO>DIALYTIKA5B/afB 6>/cc> _OMICR7A? U?8Ab A9E OOMEGa?+86oCAPITAEbA8A G cC9C   d? I K @e@  @  fC  C  #f0C  C!f1A50b1FPLUS-MINUS SIGN9fE2265+ GREATER-THAN OR EQUAL TO4E22644OLESS1af "  XG50f7DIVISION6224oALMOST60b0TE~ R6221BULLET OPERATORb&0bMIDDLE DOT&p6221WSQUARE RO'T6207OSUPERSCRIPT LATIN'Q50b2<'TW<625abBLACK !0(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'0 # 000 -> NULL!1!1!START OF HEADING-2-2-2TEXx3*3*0ENDU (4(4(pRANSMIS5050UQUIRY$6$x0006 -> ACKNOWLEDGE '\x07'  # 0x0007 -> BELL!8!8!tACKSPACGt$ G9&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 ACK*16161SYNCHRONOUS IDL 1 END OF TRANSMISSION BLOCK 1UCANCE*19YeMEDIUMMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"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&q&3EVE8' # 0 x0038 -> DIGIT EIGHT '9'@# 0(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)LSMAL5b1 1B 'c'  # 0x0063 -> LATIN SMALL LETTER C 'd'141D1e151E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s1S1t1T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LIN^}*ORIGHZ~0CTILDR3\x77TDELET#Pu0391J#8GREEK CAPIThRALPHA\72778BET6366HGAMM74779DELn577cEPSILO.699Z76 6 5855*TH7977)IOa66HKAPPb7"7HLAMD7c7(7MQzd' # 0x008c -%> GREEK CAPITAL LETTER NU '\u039e' # 0x008d -4'XI4f4e4vOMICRON9(a09f9Pm'a14/9047RHOi3515WSIGMA74727'TAB(a5535YUPSIL6949(PH7555C58565(PSj9575GOMEGDb87ESMALHALPH52l958BET4 a48GAMbb59DELj c5Eb[ Z [ 4 3 U 3*TH5aV 5)IOaaU 4VKAPPAS(bb5S 5HLAMD5c5S 5M(bd2L 2baI 2baF 2 caH 7cCaC c aA cvaBlFINAL ;HaH (cFaF &cFaF $cEaE "cEaE 8259bCLIGHT SHADE8259fb7mMEDIUM)b+LDARK'0P BOX DRAWINGS LIGHT VERTI6CAL '\u2524' # 0x00b4 -> BOX DRAWINGS LIGHT VERTICAL AND LEFT A(61A5A;eSINGLEBv DOUBLE(62I6I9IYI(56I7ICDOWN~E5E8EzE(63E9E^ 5^aB {(57{b9 (5d>c>%UPzc<d</UP}bCeC{ (10CfC1/c0=R"3<1< HORIZONT@/c2AC1C3C 0?c|3|y |G'5ec ](5fJJ[JaJ5 |(69| |R6cD SZ5C~ [; ~Hc2UP  B ['68d( I_d55d? DRAWINGS DO BOX DRAWINGS UPI^RIGHTD8D4DwD2D5DCDOWNyF 3F6F{F(6bF7FVERTICALc(6aO8OO1n9OL!UPHFLEFT;(0ca;k7>8yb>FULL BLOCK'4ec'LOWER HALF- d-?EFT,(90Ye,-8-f-?UPP803c e0- GREEK SMALL LETTER OMEGA803a/e15ALPHA WITH TONOS@d/e2@EPSILONBeB/ETce>$IO?DIALYTIKfC cB?_OMICRcDBUDceB  cFA(86I@@CAPIN eBP 8D 8R@T A A 8D 8f 0xb1WfPLUS-MINUS SIGN @2265.f ATER-THAN OR EQUAL TO5ffLESS-THAN OR@ EQUAL TO '\u03aa' # 0x00f4 -> GREEK CAPITAL LETTER IOTA WITH DIALYTIKA EbE5EUPSILONH0xf7F6HDIVISION SIGN@2248,7*lALMOST0xb0*V8, DE T 19*T9(BULLET OPERATOR+xba,MIDDLE DOT'Iu221^b'SQUARE RO(807f{c(UPERSCRIPT LATIN SMAL 0xb2;d=%TW125ae,bBLACK x'Uf)NO-BREAK SPACE ) ### Encoding Map e_map = {Q[100:c000,7rFNULL 1 1 START OF HEADING,2,2,2TEXu3)3)0ENDS '4'4'pRANSMIS5/5/VQUIRY#6#6#ACKNOWLEDGE'7'7'(BE8 8 2ACKG9%9%pHORIZON@TABU?O11a1a1LINE FEEDb%b%`VERTIC@Tc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .zu11 .7HRE^1 02FOU_1NEGATIVE z11SYNCHRONOUS IDL1Fe BLOCK@11VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPAN1_GROUP+1oRECORD,1OUNIT*22 22EXCLAMAT-4MAR0022: 0x0022 , # QUOTATION MARK 0x0023: *NUMBER SIGN'4'4'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt7%7%POSTROPHE&8&8&LEFT PARENTHESIS,9,9,ORIGH-a-a-wASTERIS>b$b$KPLUSc%c%VCOMMAd!d!HYPHEN-MINUe(e(FULL STOPMf%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&&ON~#32%2%'TWJd,33%7HRELd3dFFOURc3c7FIVLa3a&6SIXKa3a%6EVE3b3b'E<N]3]'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cNQUES]4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242442442F42G242H242I242J242n44&Ld4dM2 4 24425525 5  Q0x0052: 0x00@52,  # LATIN CAPITAL LETTER R 0x0053: 2 S24242 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(ESMALAX20  0B0/63` C06 `D06 06 0F`6 0G06 0H06 0I06 0J06 0K06L060M060N06O077`P07 Q07 77 977  77 77 77 77 77 77 77]CURLY77`VERTIC_7d: 0x007d, # RIGHT CURLY BRACKET 0x007e: ,/VTILDE!f!f!VDELET""a0"f"NO-BREAK SPAC*b*8LGREE SIGNs#b1Q1'PLUS-MINUS+2+d+SUPERSCRIPT TWOV7+a+MIDDLE DOf&6&DIVISIONz2386OeOK CAPITAL LETTER ALPHA WITH TONOS3388AbjAEPSILONC9CcC Ta?=/IO@c@e _OMICRe<U/f0 /EG9o8A 9z8FBETA532/82 GGAMM64636 8DELl5646 `/858 Z787 4/87i )TH68Dj/89k GKAPPxbB GLAMD68 &MUdi N398 &XIf)888 PkaS9S %RH#3a9Q 7SIGa9R &TA<a9P u 9R 'PH 9N C49M 'PSh97, # GREEK CAPITAL LETTER OMEGA 0x03aa:@0f4,o # GR6IOTA WITH DIALYTIKDbD5D UPSILONGcG+e1GESMALCALPHVTONOSd?2? E AeA3A  =f=  F >"b1>/98{ #b2494 6BET#b33a3 GGAMM444b4 8DELh54c4 66d6 Z73e3 282f2 )TH494/a04 Wa GKAPPjGa GLAMD44a &MU&a N1a &XIb /a6. uOMICRON6#c0d76 Pgc3a3 6RHOc1a FINAL SIGc8ak 48a8 &TAjc6a6 E6a6 'PH:5a5 C25a5 'PSd3e3 c4e gBcBe BESeE cce Aseo =207f: 0x00fc,  # SUPERSCRIPT LATIN SMALL LETTER N (0x2219: 0x00f9,<BULLET OPERATOR+a+b+SQUARE ROOT'#48'7'ALMOST EQUAL TO+#64+3+LESS-THAN OR15121GREATER425004%c44BOX DRAWINGS LIGHT HORIZONTAL25029b9hVERTIC7c7/dap DOWN AND Rt1/bf=5LEFy#51N/c0< /UPwd$; uc%{2b fA 2o3/c18@5@ F5/cdFoDOUBLE"51qbq:l5d4aSINGLEw NE3}/d6#WN4EVEt 45/b8r?6b F{DTD7D  DKD=2UP od#UPCTcK <be AQBIb B dcq B}e;c?fIKI JZ6 VERTICAL AND R IGHT 0x2561: 0x00b5,! # BOX DRAWINGS VERTICAL SINGLE AND LEFT DOUBLEH2H6H 8HXH3H9H?A4A/d1A(WNHORIZONTAL5J2JJ 6J/cbJLQ DOWNJ7CfC/UP8H/d0H9H/caHE/UPaA/d8AL G bN7N  cN/ceNE N"80GdUPPER HALF BLOCK,cs?LOW,OLFULLR&ddR}9R&91AL,FSHAD9{MEDIUM (eKDARK&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.5pasReader(Codec, e=,0cd =ffA )A+9/0c  9eIGATURE A$9c35/4d Oc 9fq<b9 A9a?CENT SIGk9+5a dS 5 ;,0d x#0d# LATIN CAPITAL LETTER U WITH DIAERESIS 0x009b:0f8, # LATIN SMAL?O?fSTROKE<c<%a3<POUND SIGN&d&db8CAPde>7dMULTIPLICATIONmf/%a4/CURRENCY)!a0)5100) AVMACRO"a1>/2a> I>2>&0f8|tFACUTs!a3;?17by ZyDOT ABOVA4AcA |?5? ? 6;E201dzRIGHT DOUBLE QUOTEMARK? a77E00a67BVN BAR&8&9&BCOPYa #a9*e*REGISTERE#aa+,;NOTH@bVULGAR FRACONE HALF8bX4gQUARTEI51417 L aIa:EFT-POINTING?ANG_bEcFb|7259 FSHADbeE2592{MEDIUM (O6259OLDARK&:6250NBOX DRAWINGS LVERTICALb06252Q7 AND LEFT@10@hVOGONEb46010*>C(CAb:/11y E= {R&11x{>jbi6256 :r;6255'A s625538ODOWNu6255=/UP;2Z2 p/16 S 2510, # BO#X DRAWINGS LIGHT DOWN AND LEFT 0x00c0: 0x2514,m # BO<!UP:RI;1;3;HORIZONTAL@2@/2c{ B3B1B VERTICAL4A/00 z593zF6FE0172LATIN CAPITAL LETTER U WITH OGONEK@7>/6a>fMACRON>8>6255> DOUBLE 9<< 8a>%69z7bA6A CcC; dB5B |e:6<|GfGE017d=Z=(CAdK0105=ESMALxA; xd<010y <C< w6011 ;E; wO0117 <DOT ABOVEdO012f? I{O0161< S< 3; db< dO017e< %18; O Md0: d8wFULL BLOCd8{LOWER HALF,8+9,y6258,?UPPeh,0d O<FACUTei/0d SHARP S (GERMAN) 0x00e2: 0x014c, # LATIN CAPITAL LETTER O WITH MACRON *c0x00e3>3> N>VACUTE=4=;0f5=LSMALyGTILD;5;d; =6=b=MICRO SIG7&?144 8;+36; KvCEDILLA9?7? =a=b= |L|b?  |=c=4 =3 d=/12 E e>4}f?E2019} RIGHT SINGLE QUOTATION MARK f07E00ad7SOFT HYPHEK"f1'%b1'PLUS-MINUSvf7201EFT DOUB50beaVULGAR FRAC@THREfARTERSb{PILCROWqa"SEZ 6f\f(PDIVIS; )_6201_LOW-9r[50b00DEG ^C'22BULLET OPERATOR1&0bMIDDLE DOT&&0b!SUPERSCRIPT ONf&0b+X&0b -&WO+625aBLACK SQUAR'00(NO-BREAK SPACE }) ### Decoding Table d _tA = (}`'\x00'0 # -000 -> NULL!1!1!START OF HEADING-2-2-2TEXxx3*3*0ENDU (4(4(pRANSMIS5050UQUIRY$6$6$ACKNOWLEDGq7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZON@TABU~<'\n2a2LINE FEEDb(b -> VERTICAL TABULATION '\x0c'  # 0x000c -> FORM FEED&r$ &d&CARRIAGE RETURRe.Re,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'b'  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=+ 0x003d -> EQUALS SIGN '>' # 0x003e -> GREATER-THAN.?.f.QUESTION MARKX@* 40*COMMERCIAL AT*A*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353E3F363F3G373G3H383H3I393I3J3a3J3K3b3[L3c3LfM3d3M3N3LO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.cOW LIN`%6YGRAVENa)LSMAL5b1 13c1 11d1 1/e1 1f1 1+g' # 0x0067 -> LATIN SMALL LETTER G 'h'# 0x00681H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t141T1u151U1v161V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LINEY}*ORIGHZ~0CTILDRB\x7f%N7TDELET#Pu0106%#8PCAPITC WITH ACU>0xfc<$ >U<DIAERESIJ\xe9@E@|1>|A<SMACRO@\xe4;= Pu0123B}+G}rCEDILLA@\xe5<~8~RING ABOV7CHXu0142<SLWSTROKy1_ uIu015lk lR| 7@ zN>(2bI| 7q= Z? '\xc4' .# 0x008e -> LATIN CAPITAL LETTER A WITH DIAERESIS '\xc5'  BfB RING ABOVEC9C/90CEEACUT>*e6>1>SMALL LIGATURE A4c424 6Pu014dl&936j+OdMACRONfs4= hXu0122}5@GtCEDILLAa>  96@CENT SIGXu015af7&Sf>b>8> !<+xd 9< _ "0xdc|aBU B*f8BbB USTROKT*a3=c=XPOUNDb+xddd'bf*d7fMULTIPLICATIONo*a40CURRENCY*Pu0100,a  :a I~ ?*xf>a{ w7wa {Z{9DOTAu017=@  @ 8201VaRIGHT DOUBLE QUOTEMARK 1aBUN BAR' ]aBCOPYc0xaeAaREGISTEREa0,m)NON!xb%PVULGAR FRACONE HALFbZH5dQUARTE1Y!L  CYLEFT-POINT?ANGbFojGHu259bDSHADt(bu|MEDIUM )a)2 -> DARK SHADE ) '\u2502' # 0x00b3 -> BOX DRAWINGS LIGHT VERTICAL 8(24848 AND LEFTA9010A5ALATIN CAPITAL LETTER A WITH OGONEK?c6?C?VCARON>(18>7>E> }(16?8? DOT ABOVEH2563B9B weDOUBLEx @H2551BaB {(579b9ODOWNwd>c>-UP<H012e<d<Iv(60?e?S? 9251>f> r1/c0=R3p3<1< HORIZONTk/c2AC1C  0?c|3|yb|G8017cU '6a=c?7MAC19255? 5 {(69|<8256cD   5CE~ E; ~H8017cZF DG0105d>OSMAL{d=d< 0x00d3 -> L2ATIN SMALL LETTER E WITH DOT ABOVE '\u012f' # 0x00d4 -> LA@I@fOGONEK=(61=5=S=VCARON<(73<6<U< yb=7= :MACze=8=Zz H2518<9<BOX DRAWINGS LIGHT UP AND LEFTH250c;a;ADOWN=RJ>8yb>FULL BLOCH2584ec'LOWER HALF- d-?EFT,(90Ye,-8-f-?UPP!xd e0-eCAPITAOSACUTE!xd>1> SHARP S (GERMAN)@Hu014&e2@~ L4?/e3?N f5S}FTILD <| >b>~MICRO SIG4OehPu0136g KvCEDILLA(37@k >"en> ~L~ p@ ~>48 (12>  y ?H2019SINGLE QUOTATION MAR|0xad6f SOODYPHEU!xb4(PLUS-MINUS8201fODOUBbcVULGAR FRAC@THREcARTERSw!xb;xPILCROW!xa)"SE\E+xf)lPDIVISB*Au201fo_LOW-9zb0' # 0x00f8 -> DEGREE SIGN '\u2219' # 0x00f9(BULLET OPERATOR,0xb7*,a,MIDDLE DOT'Q'b'SUPERSCRIPT ONE,3Sc,FTHRE.2.d.#WOZPu25a0.e,BLACK SQUARU'f)NO-BREAK SPACE ) ### Encoding Map e_map = {zE100:M000,f\FNULL 1 1 START OF HEADING,2,2,2TEXuu3)3)0ENDS '4'4'RANSMISSIOV5/5/VQUIRY6#6#ACKNOWLEDGfJ7'7'(BE8 8 2ACKGE9%9%HORIZONTAL TABULATa1a1LINE FEEDb%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROLx11 .Tz.1 .01 02FOU/1NEGATIVE z11SYNCHRONOUS IDL1Fe BLOCK@11VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPAN1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2fNUMBER22LOLLA'2{PERCENTO2 AM&AN22APOSTROPH2v2v LEFT PARENTHESIS 0x0029: 0x0029, # RIGHT PARENTHESIS %"a:-a-ASTERISK$b$b$PLUS SIGN%c%c%VCOMMA!d!d!HYPHEN-MINUe(e(FULL STOPMf%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&6ONE%2%2%'TWJ3%3%7HREL4'4'FFOURr5&5&'IVL6&6&6SIXK7%7%6EVE#38'8'E<N9']V(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cQUESTION MAR4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 24425525 5  Q5 5  Y5 5  5 5  5 5  U 5  V2 5  LATIN CAPITAL LETTER W 0x0058:, # LATIN CAPIT2X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKET/c/c/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(ESMALAX2020 B03030 C04040 D05050 6060 F`7070 G0/680 H06 I06 0J06y 0K06L060M060N06O077`P07 Q07 R07 977  77 U7 V07 77 77 77 77]CURLY77`VERTIC_77RX7FTILD77VDELET"af"NO-BREAK SPAC*9?F SIGXa9[POUND&9uCURRENCY)a6: 0x00a7,  # BROKEN BAR 0x00a7: 0f5,&SECTION SIGN(9(%a8(COPYRIGHT*b*e*LEFT-POINTING DOUBLE ANGLE QUOTAoFMARKocEaE,NOid$%f0$SOFT HYPHEe'%a9'REGISTERED"b0+fkDEGREE'1'1RPLUS-MINUS+2+d+SUPERSCRIPT TWO#b3+c+FHREE-5-%e6-[MICRO~6&%f4&{PILCROW(nMIDDLE DOTt%fbN'ONf+*bVULGAR FRA ONCFARTEba7FHALF%%f3 4T1 QUmS:"c4d8ATIN CAPITAL LETTER A WITH DIAERESIA8,LARCFABOVnc%92 BIGATURE A59> 5EFACUT=de= O=esz=GTILDz= od9MULTIPLIC "d89p STcd9Y>U(fekAESMAL\SHARP S (GERMAN)e?e8f?eIe8 fa; V fe( ; f;ffc]DIVISfSTROKE 0x00fc: 0x0081, # LATIN SMALL LETTER U WITH DIAERESIS +b0x0100?+a0?eCAPITAAAAfMACRON>1>+83> }<4<+b5<zfOGONEKz5>dz <6<8< zCVACUTEy7=7 y;+b6;x)CAkdxd x ;"12;/edx E "13>+89> <j+b8< >DOT ABOVn1nda ?8b ("19>+d2 <2t9 GtuCEDILLAf2u ? {=aa+ I| "2b>/8c <e<bj > 4f>/d4z <3jej K p3he =2+ea pL|+eb? =4ar ?VSTROK_486{ <e N F4e y;+ee/x 4) z =  |O Z492 <58d # LATIN CAPITAL LETTER R WITH CEDILLA 0x0157:@08b, # LATIN SMAL=a=+97=C|S|VACUTEzb=8= z;"60;+be;xUCARONx"61=+d5=x ;c U9MACyd> y<"72+c6 >eOGONEK"73>d>z <9</8dz Z 71al ;./a3xDOT ABOV`"7c+a4A |?d?+cf? rA )"7e=d ;3201pex RIGHT SINGLE QUOTATION MAR3201&f2EFT DOUB6am7 f1_LOW-92%f9BULLET OPERATOR3250cBOX DRAWINGS LHORIZONTAL9)b79hVERTIC7?&dapDOWN AND %t1bt=FLEFT<4*/c0y /UPw8;dO; uc%{2b fA 22 3/c18@ F5c F:bq:05 DOUBLE DOWN AND RIGHT 0x2557: 0x00bb, # BOX DRAWINGS DOUBLE DOWN>7LEF=a=/c8= !UP; yd</bc< w"60;c; VERTICAL}"63B/b9} B 6Ac7HORIZONTALz#69Ca =AcAeA G8N%dfGUPPER HALF BLOCK"84sdz?LOW,8,#LFULLR%dd~i}9S,1}&b0We SHADE#92'1'lMEDIUM(02(KDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP850.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,8creturno.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='cp850',d!e=02(). id:.r=]/J //spr7=D #writer=StreamWriter, ) ### Decoding Map d_map = codecs.make_identity_dict(range(256))5.update({d0x0080: 0c7,w # 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( O9fu@f9fR  9f f @ {f Y5d4Ad AAf WSTROKg%a3POUND SIGN9db ddoMULTIPLICATIONm/19F FHOOK 0x00a0: 0x00e1, # LATIN SMALL LETTER A WITH ACUTE '3#a1;d; I;2;/f3; O;3;a; U;4; N;GTILD5;d;eCAPITA)=6=a FEMININE ORDINAL INDICATOR_76b6oMASCUL7 87f INVERTED QUESTION MARKi92%ae2REGISTERED SIGN+a+c+;NOT$b$bVULGAR FRACONE HALFXc4X4gQUARTE#d7aqEXCLAMAp e5bLEFT-POINTING DOUBLE ANGLE QUOTEfEbEORIGHFb}6259LFG SHA}biE2592lMEDIUM(V6259VLDARK&A6250NBOX DRAWINGS 2EICALb=E25247P AND W@Bci BkbBc=CIRCUMFLEXN%c0B FGRAVbT%a9=ACOPY bL6256 &\^'b6255'A vE25578ODOWNu6255=/UP;;CENbs5;YEN:R6251 cH1 8c\3;HORIZONTct2 B1B 2 0: z 0x00c5: 0px253c, # BOX DRAWINGS LIGHT VERTICAL AND HORIZONTAL 20x00c6: %e3FLATIN SMALL LETTER A WITH TILDE;7;c;oCAPITA= 8=E255ax DOUBLE UPRy9<4< ODOWN>a>/69> z3bA6A CcC0C  dB5B |e:68z |GfG600aCURRENCY SIGN"d0)fb6ETH212d2 Y 424cPf 4CIRCUMFLEXv3BbB DIAERESISA4A8AFGRAVM!d5=;131= DOTLESS Iu+cd8 IGACUTue=5O00cfB515 FLEFT0: ?d8wFULL BLOCKc8LOWER HALF,700aROKEN BARR}600ce $s6258?UPPevd Oe  fSHARP ed.K sNe/d2N B e+f5= ; e},0d; =b=ZMICROekfk FTHOR:e]d4N CAPITAL LETTER THORN 0x00e9:0da, # LATIN CAPITAL LE6U WITH ACUTE=a=b=CIRCUMFLEXBbB9BGGRAVc=+fd=ESMALYd;d; =e=%afxWMACROVf"%b4":u ACCENT"f0(aSOFT HYPHEO"f1'%b1OPLUS-MINUS SIG+2+E2017+DOUBLE LOW LIN? f3+E00be+VULGAR FRACTION THREE QUARTERS4:6:{PILCROW5(a"SEZ 6(f(PDIVIS )7)%b8yvCEDILLA8#0#0DEG JaJDIAERESIbMIDDLE DObSUPERSCRIPT Os%b3+o/b2-&WO+625apBLACK S(NO-BREAK SPACE }) ### Decoding Table d _tA = (}d'\x00':Q00 -> NULL!1!1!START OF HEADING-2-2-2TEXxx3*3*0ENDU (4(4(pRANSMISj5050UQUIRY$6$6$ACKNOWLEDGq7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZON@TABU<'\n2a2U FEEDb(#  0b&VERTICAL V:x0c0c0HFORMVr$d&CARRIAGE RETU!e.e,SHIFT OUf&f&IJ'\x11@DATAuK ESCAP11DEVICE CONTROL\ 1 /T/ 1 /[11 1EFOUR0 1NEGATIVE  '\x16'  # 0x0016 -> SYNCHRONOUS IDLE '\x17' -7- END OF TRANSMISSION BLOCK68686eCANCEL#9#9#YeMEDIUM*a*a*SUBSTITUTb'b'VESCAP#c#c#FILE SEPARATORud+d+_GROUP,e,e,oRECORD-f-f-LUNIT+ (  20+CSPAC!"1"EXCLAMAT3MAR"-2-LQUOT+#+3+NUMBER SIGN&$(4(XDOLLA(%(5(wPERCENTQ&)AMPERSANDw1"'"APOSTROPH(MLEFT PARENTHESIST-')-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJ0$3{DIGIT ZEROK1''#ON2&y&#TWL3&t&3HREN4(t3FOU5'sO3FIVN6'q'2SIXq3q&3EVE(r(EKP(m($NI9:fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sKQUES@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG' # 0x0047 -> LATIN CAPITAL LETTER G 'H'# 0x00483H3I393I3J3a3J3K3b3K3L3c3L3M3d3M3N3e3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.rOW LINE`%6YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1)h1 1'i1 1%j1 1#k1 1!l1  1m11n11o1p17bALL LETTER P 'q'# 0x0071 -> LATIN SMALL LETTER Q1r121R1s131S1t141T1u151U1v161V1w171W1x181X1y191Y1z1a1Z1{1b1EFT CURLY BRACKEU|/c/VERTICAL LINEY}*d*ORIGHZ~0e0CTILDRB\x7f%f"UDELET#)c7# 80#PCAPITC WITH CEDILLAJ\xfc@U>DIAERESIJ\xe9@E@6ACU*e2<A<CIRCUMFLE-J\xe4A"A0@1@EGRAVy*e5<<<RING ABOA L*eaYx<bAiA<8@x@ < 8mI|e| @ A cu< r c;B =cw9 y6@9IGATURE Ac46f-9OfwA lfd95 -> LATIN SMALL LETTER O WITH GRAVE '\xfb' # 0x0096 -> LATIN SMALL<U<CIRCUMFLEXA9A7A }f<8<Y}DIAERESIS|*d6@9@eCAPITABcBaB B*f8BbB AUSTROK~*a3=c=POUND SIGN dd' f*d7fe?MULTIPLICATIONoPu01922f0o FDHOOK e19 O/a0;A;EACUT *ed<1<I<fI/a2< x*fax3< < 4<NETILDd<5< >aFEMININE ORDINAL IND$ORb7oMASCUL8 aINVERTED QUESG5MAR *aeXREGISTEREaa8NOT+xb!kVULGAR FRACONE HALF Zc5eQUARTE)atbEXCLAM; OakLEFT-POINTING DOUBLE ANGLE QUOTFbFORIGHGAu259bGE SHA(bymMEDIUM)hQfLDARK'0PQBOX DRAWINGS L=CICALPu25243_M8P AND ]A!xc~bRc>R >  c0C^C aKbdACOPY Iu256\+ DOUBLE VERT8ICAL AND LEFT '\u2551' # 0x00ba -> BOX DRAWINGS DOUBLE VERTICAL 979b9ODOWNwd>c>,UP<0xa2:d<CENT SIGN:xa5&e&8YEN%Pu2510'f% oLIGHT '14=/c0=RJIu253<1< HORIZONTA(2c}2AC1C3CV 0?/c4B|3|5: | G0xe3  c6GLATIN SMALL LETTER A WITH TILDE+xc<7<oCAPITA> 8a|: c8> :859= w(69|| 8Xu2566BD   5CE~ A; ~ H!xaBCURRENCY,!xf*dl4ETHcd33 c5cXh5CIRCUMFLEXx cbCC DIAERESISB8BB DGRAV[Hu013Ud> DOTLESS Iw 1IDACUTw:xce>:fC :S<dS 0d;8yFULL BLOCK  '\u2584' # 0x00dc -> LOWER HALF BLOCK -0xa6+-d-BROKEN BAR'*cc'e'LATIN CAPITAL LETTER I WITH GRAVE>0@f>?UPP d3+ e0-kOkSACUTEk:xdf>1>ESMALuSHARP S72u27 uCIRCUMFLEXC2z3C #:xf5>4> FTILD <5< >b>6>MICRO SIGN*fe7' ETHOR5d585 7al97Ub>a> 9CbC d>- +Y <g 2>aUMACRObCt ACCENTafSOFT HYPHEQ1frPLUS-MINUSEPu2017. fg`DOUBLEE LINb<fPVULGAR FRACTION THREE QUARTERbfMxPILCROW!xaf:"SE\  )%PDIVIS* b8S(tCEDILLA[b$0DEGLaLDIAERESI MIDDLE DObfSUPERSCRIPT O| f,x f .#WO,Au25apBLACK S'$NO-BREAK SPACE ) ### Encoding Map e_map = {z 100:000, FNULL 1 1 START OF HEADING,2,2,2TEXuu3)3)0ENDS '4'4'pRANSMISi5/5, # ENQUIRY 0x0006:, # ACKNOWLEDGE'7'7'FBELL 8 8 wACKSPACE9%9%HORIZONTAL TABULATIONVa1a1LINE 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/NEGATIVEz1%160SYNCHRONOUS IDL1 END OF TRANSMISSION BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 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 # DIGIT EIGHT 0x0039:, # DIGIT NINE&a&a&VCOLON!b!b!KSEMI%c%c%LESS-THAN SIGOd*d*kEQUALS'e'e'GREATERTf-f-QUESTION MARK"40)%40)COMMERCIAL A<#41)1)LATIN CAPITAL LETTER A[2222 B23232 C24242 D25252 #46262 Fd7272 G28282 H2/492 I24J242O4&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 SOLIDU5R[5CIRCUMFLEX ACCEN5HOW L66\GRAVEL66OSMAL66 066 064: 0x0064, # LATIN SMALL LETTER D 0x0065:, 0E06060 F07070 G08080 H09090 I0a0a0 J0b0b0 K0c0c0 L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T0/750 U07 V07 W07 X07 Y07 Z07EFT CURLY BRACKEN7VERTICAL LING77ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARab5CENT SIGa9[POUND&cCURRENCY)b;YEN$dBROKEN BAfaf1SEC fnDIAERESIabBCOPY OaM FEMININE ORDINAL INDICATOaLEFT-POINTING DOUBLE ANGLE QUOTa,NOf SOFT HYPHEaREGISTEREeVMACROMb=jDEGREEbfwPLUS-MINUS SIGN 0x00b2: 0x00fd, # SUPERSCRIPT TWO ##b3+c+FHREE-4-%ef-ACUTE ACCENT(5(6(MICRO SIGN&6&%f4&{PILCROW(7(a(MIDDLE DOt8&7&vCEDILLAq9#b#'ONa+aN MASCULINE ORDINAL INDICATORbb7!RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKFcFVULGAR FRAC0 ON>GARTE}d77FHALFke4%f3 4T1 QUmS:f:%a8:INVERTED QUES "c02bTLATIN CAPITAL LETTER A WITH GRAV#c1=5o= cb= CIRCUMFLEXB'cGTILD7/8eDIAERESIlcP8W Ri8ABO?l/92IGATURE Ay/805C ocdE? 9| = d=d d Id = d =dBd/d19 5ETHbda N1 bde O= kdek = ndek =nde B 99, # L!ATIN CAPITAL LETTER O WITH DIAERESIS 0x00d7:09e, # MULTIPLICATION SIGN/8/d/LpfSTROKE>9>/eb> UGGRAV=a=9=GACUT=b=a=CIRCUMFLEXcB9BjdAe; Y e=8 GTHORf616ESMALfSHARP "e06/856 A "e1;/a0; "e2;/83;"e3@/c6@FTILD"e4;/84;#e5?zRING ABO"e6@9IGATURE A/87 CuCEDILLAe8 E= /82x ; 8v8@8~ ?Iab; /8c0 ;81fd 5ETHf  N' Ff97  WfaW ; bf97 ;bfe @ ;f7]DIVIStf9R O WITH STROKE 0x00f9:097, # LATIN SMALL LETTER U WITH GRAV;a;/a3;GACUT;b;/96;CIRCUMFLEXc@/81@DIAERESIS?d?/ec? Y e;0 VTHORNof4/98o 2131?/d5? DOTLESS Iw21928/9f8 FCHOOK:B2017:%f2:DOUBLE LOW LINB2500+%c4+BOX DRAWINGS LIGHT HORIZONTALd#50b>9hVERTIC7/dap DOWN AND Rt1bt=FLEFT<40y /UPw8;/d9; uc%{2b fA 2 2 3cB8@@ F5/cd:~bq:058m 5/bb > 5cp 3{t yb< w6d; *m }"63)b4 B 6Ac76c =Ae G8NdUPPER HALF BLOC#58ldz9LOW, 0x2588: 0x00db, # FULL BLOCK q0x2591:&%b0&LIGHT SHADE'2'1'lMEDIUM(3(2(KDARK&"a0&%fe&TBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP852.TXT' with2c;P.py. c#" import cs ###`APIs class($.1): `def en(self,input,errors='strict'):,tcreturno.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='cp852',d!e=02(). id:.r=]/J //spr7=D #w##)Z~0MapA0codTmap =make_identity_dict(range(256)) 5.update({F8%c7LATIN CAPITAL LETTER C WITH CEDILLA?+fc?ESMAL=U=DIAERESIS?/e9? E?DACUT3008e zA;CIRCUMFLEX{4/e4{ @5??16f? RING ABOV6@0x v 7;/0e; 8=/147 L7WSTROK9<&0esALL LETTER E WITH DIAERESIS 0x008a:@150, # LATIN CAPITAL LETTER OAOUBLE ACUTEDbD1DOSMALBcB?0eeB ICIRCUMFLEXd@;179@ ZB e=?0c4= A=DfA?106A CA ~!90=/0c E=1=/13= L=2=a ;3;,0f3 ;4#94@ 2@q!95?;13d UCARON,#96=l ;7;52 xSo8=b ;9;,0d/ xq1;0dc| AUA6 ATA r;165~ ;4[ xVSTROK9%d7yMULTIPLICATION SIG W  ae ;B a/0ev  ;50f3 v ;  ; ;/10  eOGONEKa0  <7+  7 ;+18h x ,11 k<a:NOTa7SMALL LETTER Z WITH ACUTE 0x00ac:@10c, # LATIN CAPITAL LETTER C=VCARON=d=+5f=ESMAL;S;fEDILLA=e=60ab=EFT-POINTING DOUBLE ANGLE QUOTATION MARKEfEbEORIGHF b0FF2591FV SHAD,#b1'2'lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS LVERTICAL"b47%24]7 AND LEFT@5@700cA .#b6=.=CIRCUMFLEX7B511aBE p"b8=/5e= r b9?6256 ;qs<aA5<A b878ODOWNuO255d= /UP;7mDOT ABOV,17 ?O2510c1 oc3;HORIZONTcc2  B1B i 0: z?253zF197BRE5c0g= 5;6255 z5<n q/69>z3/66A C67 3255B# BOX DRAWINGS DOUBLE HORIZONTAL 0x00ce: 0x256c, # BOX DRAWI:VERTICAL ANDGfGE00a4GCURRENCY SIGNp!d0)5111)LATIN SMALL LETTER D WITH STROKE<1<0<oCAPITA> 2>/0e>GCARO3=?0cb= EDIAERESIS4A;10fA |5;+47; N| =6=?0cd= I=GACUTq7=3 =CIRCUMFLEX8B,118 6 9;E2518 LIGHT UPFLEFTua:0:ADOWN<RI=b=8wFULL BLOCK&c&LOWER HALF,d,E0162 TvCEDILLAk?016 U?RING ABOV62588?UPPe?0d3 On 0e/0d fSHARP e'0dL sfe/14 " 4 ;,; e&16; Sh =/16E ;5 xRx +O00da  =K0155= -x?017- x <00f  Y,0d; 4=  xe600bf ACCENfa# SOFT HYPHEN 0x00f1:@2dd, # DOUBLE ACUTFCENT/2/b/fOGONEK"3"%c7"GCAROr4!%d8!VBREVEB5!&0aBSECTION SIGI6(f(^DIVIS)7)brvCEDILLAt8#0kDEGREEs9'aJDIAERESISLa%62d9LhOT ABOb%5171% LATIN SMALL LETTER U WITHgcB5BeCAPITADRD d== ;e;625a+BLACK SQUARf('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (d'\x00'00 -> NULL!1!1!START OF HEADING-2-2-2TEXx3*3*0ENDU (4(4(pRANSMIS5050UQUIRY$6$6$ACKNOWLEDGq7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZONV@TABU+<'\n2a2LINE FEEDb(#x 0b&VERTICAL V:x0c0c0HFORMVr$d&CARRIAGE RETUR1!e.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /4TWOX11 /6HRE` 1 1EFOURa 1pNEGATIV  11SYNCHRONOUS IDL 1Z2R BLOCfJ'\x11UCANCE )191YeMEDIUMa*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1UNIT SEPARATOR p ' '# 0x0020 -> SPACE -'!"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,&c&RCOMMA-"d"HYPHEN-MINU.)e)FULL STOPO/&f&TSOLIDJ0$3{DIGIT ZEROK1''#ON2&y&#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-'E33F33FG33G3H33H3I33I3J33J3K33L31LfM3fM3N33O3 # 0x004f -> LATIN CAPITAL LETTER O 'P'# 0x00503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1ac0REVERSE SOLIDU]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`%6YGRAVENa)ESMALkAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1W 1K1l1 1L1m11M1n11N1o1p17bq1r1s1Pt1"u1 v1 w1 x1y' # 0x0079 -> LATIN SMALL LETTER Y 'z'@# 01a1Z1{1b1EFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%f"UDELET#)c7# 80#0PCAPIT2C WITH CEDILLAJ\xfc@1@ pU>DIAERESIS@*e9@2@E@6ACU*e2<3<A<CIRCUMFLEX}4A4A Au016b`/85@RING ABOV~Au010A6A| :$ <7< Au014>>8>L<TSTROK:xeb8e8 50B}t uOxDOUBLE Xu0151EC0xeeAC I AAu017A ZC+xc>I 06BBc9Au013@|9 D >a9<*xf89 !xf5Aw(3dSCARONv9x9 <57 zSq3z<+xd4 z6*xd+90x6LETTER T WIT-H CARON '\u0165' # 0x009c -> LATIN SMALL LETTER T WIT<(41<d<eCAPITA>L>cSTROKE{0xd7={e?MULTIPLICATION SIG 0d2f0Cm!xel/a0<A<EACUTev<1<I< f3<2<O<a<3<U<Pu0104>,&a4< cOGONEK?&a5? =72|6= |ZXu017e7> {<(18<8< zEz (19?9? {=0xac;a=;NOT7b%c< Pu015f> SsCEDILLA0xab<LEFT-POINTING DOUBLE ANGLE QUOT4MARV+xbFORIGHGAu259bGT SHAD(2(mMEDIUM))LDARK'0PBOX DRAWINGS LVERTICAL=Hu252b8P AND ]A!xc~b 8!xc>>CIRCUMFLEXHu011b  5b}Iu256 @|y AAu255CB 125599ODOWNw b>-UP<1017.z s,DOT ABOV401700x00be -> LAPTIN SMALL LETTER Z WITH DOT ABOVE '\u2510' # 0x00bf -> BOX DRAWINGS LIGHT DOWN AND LEFT =4=/c0=!UP;GRIGH<3<1< HORIZONTAL(2c}2AC1C3CVERTICAL0?/c4B|3|5: |GH01026G LAeCAPITAA6BREH0103>7> ><H255a<8<B:DOUBLE 59= =(69|a?|8H2566BbBD cD  5CdC~ Ae; ~ H!xacCURRENCY SIGNrG01114dl .DjUSTROKi)01id= ?(0e|? DCARO0xcb<d>EDIAERESIS 0fD(dB~Xu0147<< N~>0xcd<I>DACUTw!xc6> |>CIRCUMFLEX1? ;_8<_L]0d; Y8yFULL BLOCK1258LOWER HALF-8016ld  LTtCEDILLAm1016m@U@LRING80dUPPER HALF BLOCK '\xd3'  # 0x00e0 -> LATIN CAPITAL LETTER O WITH ACUTE 3>f>1>ESMAL<uSHARP S74727uCIRCUMFLEXCAu0143CN>>4> <8<5< VCARON(60<6< S >1>7> <58< zRz ax$ 9>U>Pu0155@>a> zIu0172b< zjDOUBLE fdcE Y+xd<d< >Iu016e> zTzsCEDILLA/!xbf>t ACCENT)afSOFT HYPHE2f2 XPu02db;0cOGONEK{Xu02c7# (2d1fmEBREVGaBfSSECTION SIG+xf)@\DIVIS*bsS, _Z$iDEGREEvaLDIAERESI,9 uDOT ABOf O Q )15 <125a3zBLACK SQUAR'ZNO-BREAK SPACE ) ### Encoding Map e_map = {f100:000,|FNULL 1 1 START OF HEADING,2,2,2TEXVu3)3)0ENDS '4'4'pRANSMIS5/5/VQUIRY#6#6#ACKNOWLEDGf7'7'(BE8 8 BACKSPACE 0x0009: ,  # HORIZONTAL TABULATION 1a1a1LINE FEED%b%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURe+e+SHIFT OUTf%f%II"10$%10$DATA LINK ESCAPEP#11,1,EVICE CONTROL ON.2.2.6TWO\3.3.7HRE^4040FFOUR_5/5/NEGATIVE ACKNOWLEDG_6060SYNCHRONOUS IDL,7,7, END OF TRANSMISSION BLOCK8585fCANCEL"%19"WfMEDIUM)1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22FSPAC22aEXCLAMF MAR22OQUOT*2NUMBER SIGT22LOLLA'2{PERCENTO2AMPERSAN22APOSTROPHv2vLEFT PARENTHESISW22ORIGH-2wASTERISh2KPLUS2VCOMMA|2|HYPHEN-MINUy2yFULL STOPMr2rWSOLIDH3k3kDIGIT ZER3p3p&3i3i% 3d3d% 3d3d 3c3cM6FIV3a3a&5SIX+3a3a%6EVE3b3b'E<N]3]''NIC3V3V7COL3S3S SEMICOLON 0x003c:, # LESS-THAN SIGN *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 06TIN SMALL LETTER F 0x0067:, # LATIN SMALL LE0G08080 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*Cc*CURRENCY SIG\af<{SECTION(fDIAERESIaiaLEFT-POINTING DOUBLE ANGLE QUOTAj6MAR~aa;NOT{fSOFT HYPHEb0jDEGREENb-e-ACUTE ACCENbuCEDILLAbKcbqPCAPITsqA WITH cb=CIRCUMFLEc8BcU8C Ec9? E? dm = 0x00cd: 0x00d6, # LATIN CAPITAL LETTER I WITH ACUTE )52ce:=7=CIRCUMFLEXB"d3B/e0B O#d4=2=6B/99BDIAERESIS7AeAMULTIPLICATION SIGN/a/ep Uc=%9al=dA/edA Y~f=1=ESMAL'fSHARP "e16a 6Aq"e2;/83q ;e/84@-e8 CuCEDILLA#e9  =E= T#eb; #;a e/8c1 ;qfa f9 ;{ @5ff]DIVISfa  f8 ;e #10Ic8KEBREV#10c ;a [=dOGONEKC2105/a5 <+8f< z #10 8/ ;axECARO#109x ;dz xDqCARON 0x010f: 0x00d4, # LATIN SMALL LETTER D WITH CARON 'c0x0110;1;lCAPITA=fSTROKE>1>0>y <8<+a8< zEfOGONEKz9>9> z<a<+b7<z 1b=dy ;39l LFACUTk3+92 x;d+95; = e=6=x ;4+9d;x "42y8i  <3</e3z Nj#44=N ;7;dj = /e= j;5/8a OzDOUBLE a5+8bD B 9  R 5;e ;9+fcx v5fx ;H SH9- x;b; =uCEDILLA;5.a =6je| m6ce1 l6d xTl 6e# z=9| 9z ;dxAL LETTER U WITH RING ABOVE 0x016f:@085, # LATIN SMALL LETTER U @"70@+eb@lCAPITABDOUBLE ACUT"71DfDB9B/8d Z a=a ;b;bx;DOT#7cAe |?d?+a6? ~AUCARON#7e=7=| ;22c7;%f3; !#d8!4!6BREx#2d%fa! #2d_%f2%dOGONEK#2d%f1"!s ACCENT/3250c OX DRAWINGS LIGHT HORIZONTAL92bB9hVERTIC7d7DOWN AND Rt1%bf= 6LEF"14/c0< /UPw/d9; uc%{2b fA 202 3cPB8@O@ F5cW F:Kbq:l585bB> 5/c8p{t #5/bc< w6d; *m }"63db4 B 6Ac76GcGS DOUBLE UP AND HORIZONTAL 0x256c: 0x00ce, # BOX DRAWINGS DOUBLE VERTICALG"80G%dfGUPPER HALF BLOCKs#84,c,?LOW,8,b,KFULLR"91&%b0&LIGHT SHADEy#92'1'lMEDIUM(3(2(KDARK&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'):,&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='cp855',d!e=02(). id:.r=]/J //spr7=D #w##)Z~0MapA0codTmap =make_identity_dict(range(256)) 5.update({FG&45; CYRILLIC SMALL LETTER DJ2008/405oCAPITA75453lGl/405 l 7&45;l&IO 5G/404 k666/54 UKRAINIAN IK7>04, # CYRILLIC CAPITAL LETTER UKRAINIAN IE 0x0088:@455, # CYRILLIC SMAL>'DZ59505 u 7a7/56l BYELORUSSIAN-bJ0J LcL/57 &YId404 6e6/58j Jkf404 j6"906/59j L51505 k 727/5al Nl3505 l 747/5bl 6TSHD"95606 m 868/5cn K7505 m 7el uSHORT U99 p ;ft (DZN|6 q 8h4 jYh24 l6h4] jHARD SIGNNo2; q=av/30P Apat13 p5r/31h Baq14 i6p4h J'TSko25 k 7n/34 Dkm14 k6l3 (ag14 j6b4 j&EF`24 j6c: 0x0433, # CYRILLIC SMALL LETTER GHE 0x00ad:@413,' #5oCAPITA7e750ab7LEFT-POINTING DOUBLE ANGLE QUOTATION MARK|fEbEORIGHF b0FF2591FV SHAD#b1'2'lMEDIUM(2(LDARK&3&0NBOX DRAWINGS LVERTICAL"b47%247P AND W@5@E0445@&HA46424 676/38j Ii8313 i5956256o HJaA5A b878ODOWNuc=d= /UP;q%39;gSHORT *s/419 _ ;iE2510t c_1 ccs3;HORIZONT.c/2cB1B ] 0: z?253zF%3a-Kc14 (662556 #5<` c6z%%66%AC6) ?255B |?256*|G00a4, # CURRENCY SIGN 0x00d0:@43b, # CYRILLIC SMALL LETTER EL41414oCAPITA626/3cj Mj3414 j646/3dj 5414 j666/3ej O7313 i585/3fh &PEi94E25184BOX DRAWINGS LIGHT UP AND LEFT:a:0v:ADOWN<RI=b=8wFULL BLOCK&c&4LOWER HALF,d,?041 2e646 &YAf4E2580?UPPe92` be;4boRe924 jE6;%41jSj924 j6;/42j Te924 j6</43j U:23 i5;O0436h 'ZH6?0415 j 70?043  Vk>?0414 k6H4JSOFT&eM2; q=V1jNUMEROdfQ&0aLVHYPHEsfB} 06YERfD6 8F/37  fF14 lZ6F8HfG5CAPITAL LETTER SHA 0x00f7:@44d, # CYRILLIC SMALL LETTER E38323oCAPITA595/49h 8SHCa727 l 9b9/47p 'CHc525 n 7d7&0a7SECTION SIGN9e(E25a0BLACK SQUARf('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (}d'\x00'00 -> NULL!1!1!START OF HEADING-2-2-ETEXT*3*3*0ENDU (4(4(RANSMISSIOM5050UQUIRY|6$6$ACKNOWLEDGqL7(w7 -> BE8!8!2ACKY2'\t$ Cc9&pHORIZON`TABULAn2a2LINE FEED&2x0b(# 0b&VERTICAL V: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-'$(4 -> DOLLAR SIGN '%'# 0x0025 -> PERCENT S)&)6)AMPERSANDO0"'"KO7&POSTROPHE'-'(M8'LEFT PARENTHESIS-)-9-ORIGH.*.a.ASTERISKS+%b%GPLUS,&c&RCOMMAH-"d"HYPHEN-MINU.)e)FULL STOPO/&f&TSOLIDJ0$ 30$DIGIT ZEROK1'1'#ON2&2&#TWL3&3&3HREN4(4(BFOUR5's3FIVN6'q'2SIXM7&q&3EVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sQUESTION MAR4@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33O33-P35'3Q30QR30wS' # 0x0053 -> LATIN CAPITAL LETTER S 'T'1# 343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1c0REVERSE SOLIDU]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)1)ESMALAZb121B1c1 bC1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1L1m11M1n11N1o1O1p17bP1q1Q1r1R1s1Pt1"u1 v1 w1 x1y1z1{1ZCURLY|/`VERTIC|}*0x007d -> RI GHT CURLY BRACKET '~'# 0x007e -> TILDE"B\x7f%"f"TDELET#Pu0452%# 80# CYRILLIC SMALL LETTER DJ60616oCAPITA8(53n28 nGn 636 n 8(51n48 n#IO4Iu040555 m7(54l67 lUKRAINIAN IQ ?7? vA(558A (DZw 696 w 8(56na8 nBYELORUSSIAN-p KbK M(57cM 'YI 5d5 7(58l:  55 l7'59l9L606 8(5anNn 6 8(5bn8TSH 7 9(5cpK 6 8(5enwSHORT U : <59)DZT 7 94x 25x 74hxHARD SIGNT2< >'30aAr14 60431' # 0&x00a2 -> CYRILLIC SMALL LETTER BE '\u0411' # 0535oCAPITA7(46747 l'TSm2656 m 8(34n68 nDm1575 m7(35l87 lIl 595 l74a7 l&EF25b5 l7(33c7 l(GH 6d6 m80xablWe8LEFT-POINTING DOUBLE ANGLE QUOTATION MARK+xbFfFORIGHGHu259 b0GLGF SHA@2592  b1(mMEDIUM)bjLDARK'0P\BOX DRAWINGS VERTICAL9u25b]8P AND ]A8044bh &HA525 e 7(385 g lIk14 d k69256ve SP 9255 pB H2557t9ODOWNwd>{>-UP<H0439<  _eSHORT /9041: e <H2510vy  yco=i c<HORIZONT<ccAC1C  0?c|3| GTAL '\u0(43a' # 0x00c6 -> CYRILLIC SMALL LETTER KA '\u041575oCAPITA79255787BOX DRAWINGS DOUBLE UP AND RIGHTtH25549=ODOWN?(69?a?|HORIZONTAL(66BbBD0DcDVERTICAL5CdC~c~e; ~ H!xa4fHCURRENCY SIGN4G043br!d0*^Ei9041515 ^73)d27 &EM1535 l7(3d47 l 1555 l7(3elO 4 6(3fj $PEkH25185L7LEF0};Q 8yFULL BLOCK8dsLOWER HALF-9041] 90447Y7 YE8258dF?UPP2beI d8044deK $ER290425 I l7'41 eK lSl 5 I l7(42l K l'TEl 5 I l7(43l L lUk 4 J k63beKG'ZH16F6 l8 '\u0432' & # 0x00eb -> CYRILLIC SMALL LETTER VE '\u0412' 5c5oCAPITA7(4c7d7 lSOFT SIGNs2<e< s >H2116zf>hNUMEROf0xad& f0(NWHYPHE 4b*6 f1(6GYERU 727 9(37p39 :Z 545 n7(48l57 l7SHA 666 m 84tJ78 n2484 l6(4996 j9SHC 8a8 n :4\'CH26] 8!xa6^xSECTIONXu25a0 KBLACK SQUARx'R6O-BREAK SPACE ) ### Encoding Map e_map = {%_100:g000,KAFNULL 1 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSIO5/5/VQUIRYy6#6#ACKNOWLEDGfJ7'7'(BE8 8 2ACKGE9%9%pHORIZON`TABULA a1a1LINE FEED%b%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROL ON.1 .5TWOP11 .7HRE^1 0FFOUR_1NEGATIVE z0016: 0x0016 , # SYNCHRONOUS IDLE 0x0017: , END OF TRANSMISSION BLOCK58585fCANCEL"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'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 44y4y2Bd42C242442442F42G28: 0x0048, # LATIN CAPITAL LETTER H 0x0049:, 2I2a2a2 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 066 066 066 066 06606606677`77 77ALL LETTER R 0x0073:, # LATIN SMALL LETTER S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKENc.c.VERTICAL LINEWd)d)ORIGHXe/e/GTILDPf!f!VDELET""a0"f"NO-BREAK SPAC*Cc*CURRENCY SIGNaf{SECTION(DaLEFT-POINTING DOUBLE ANGLE QUOTAEFMARKm2%f0SOFT HYPHEblYm2401-8CYRILLIC CAPIT{$IO3402616%DJp#40/837G78ZnUKRAINIAN Iw8:@'DZ787BYELORUSSIAN-1A8AL&YI6#86/)9L709N79A7TSH^A9Ko 9eSHORT #40:9'DZ1PaPA1XaNB1XeVV6Wa]GWa#41Ma1Le # CYRILLIC CAPITAL LETTER ZHE 0x0417:@0f4, # CYRILLI7686/b86Ik95e5gSHORT ;a;/c7;&KAqb6/d16&EL6c636M6d656N6e6O5f5dkP"206/e26%ERl#216&ES6266lT36UUk45/abk&EF656bHP"266a'TSccC2dfSf/fan8SHC9d/9f9HARD SIG2kf^7YERme;OFTutf1s9>Yt/e0Y13ta6ESMAL3qaI 3B3o 4V4ma 4G3m 5Dika 4I4i.e9n 43g 5idb 43`b@ 3 3`c= 3WdA 3c: 0x00d2, # CYRILLIC SMALL LETTER EM 0x043d:@0d4,/ #4N4e464 O3f383 %PE4"404/e14 &ER41434 S42454 T3474 Ug43/aa3 &EF454b &HA464a 'TS75/fb 'CH585 S959j 8SHC7a7/9e7 HARD SIG"4b;fH 7YERc6/edq KSOFTqTf KS/9cn YT Y5 8 I5 /80 &DJ5!/825 G5#8Y UKRAINIAN Is-8d 'DZ5.8 BYELORUSSIAN-x5C8I4B8 %A9 L5? N599- 'TS599 Kk fSHORT 59 %DZ3211%efhNUMERO3250cBOX DRAWINGS LIGHT HORIZONTAL32503b9hVERTIC7;d7DOWN AND Rt10bf, # %BOX DRAWINGS LIGHT DOWN AND LEFT 0x2514: 0x00c0,O # <!UP:RI;8;/d9; uc:/c3: VERTICAL{2/b4A 22@ 2HORIZONTAL3/c1B 8@5@ F#50IdFDOUBLE :1:/ba: 5r; 3#57vbv > "5a=/c8= t yd</bc< w6d; *#63}4 B 6Ac7#69C =AeB G8N%dfGUPPER HALF BLOCKl8ldz?LOW,#KFULLR9USHADEy"92-b{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"+GQUOT) '#'  # 0x23 -> NUMBER SIGN '$'&4&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$TmCTHREJ4&TBFOUR5%SK3FIVJ6%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;S1 L LETTER S s 'T' # 0x54 -> LATIN CAPITAL LETTER T )+'U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/C.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\x77TDELET!Pu05d0F!80 -> HEBREW LETTER ALEF '\u05d1' # 0x81 -> HEBREW LE-7BET,2,2,WGIMEL.3.3.9DAL\4.4.'HEY5+5+7VAV,6,6,WZAYIN.7.7.H8,8,T,9,9,7YODa,A,FINAL KAb2B2 ,c,C,HLAMEd.D.7MEMe2E2 ,f,F,^'NU%e02.902 ,9fSAMEKHe9 (e9Pe9 +9\WTSADI9 .9'QO\e98RESD9(SHle9T6fffV9uUNDEFIN!xa9POUND SIGA I IdIMULTIPLICATIONR RuvA$ $ $ $ $ $ w$ m$ e $!xaA\REGISTERE!xa*Y8NOT!xb#PVULGAR FRACtONE HAL )xbV_3tQUARTER papLEFT-POINTING DOUBLE ANGLE QUOTCMARKh)xbDBRIGHETING DOUBLE +ANGLE QUOTATION MARK '\u2591' # 0xB0 -> LIGHT SHADE&2&1&mMEDIUM'3'2'LDARK%0L3%BOX DRAWINGSVERTICAL&24[46 AND LEFT?Ffffe?5?UNDEFINED$6$7$0xa9jS8$RCOPYRW4IGNq7256/9) tDOUBLE  7255A@ w 57B7ODOWNsd<C<,UP:!xaD:fCENT S0xa5\$E$8YEN#Pu2510%F# 41CC;23::HORIZONTcC?A1A3 { 05C=x3x6 E {CWCWVu255aFW .5i =6rCfxF2566oBu  5A|;z9 z F!xa}CCURRENCY *D D$ p$ S$S 8%$$$ d m $ m2518' # 0xD9 ->* BOX DRAWINGS LIGHT UP AND LEFT '\u250c' # 0xDA ->9ADOWN;RH<&88<B<FULL BLOCK%4%C%LOWER HALF+0xa6)D+BROKEN BARP@fffe'E%UNDEFINED$F2580$F$/PPtuO!E0+ O $1$2$3$4$5$0xb5L E6$MICRO SIGN( 7% L $8$9$il Q$ P$ I $8xaf!HTMACRO!xbBEACUTE ACCENA7xadHFASOFT HYPHEM1&CPLUS-MINUS@2017,FIDOUBLE LOW LINE!xbFOVULGAR FRACTION THREE QUARTERS9hFdxPILCROW!xa`g"SEXE)xf'jPDIVIS(b,OmuCEDILLA"k0DEGHaHmDIAERESI mMIDDLE DO b9honSUPERSCRIPT Oj3*t*f2,| ,#WO*Au25apBLACK S%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$erncode(self, input, final=False):  return codecs.charmap_en(:self.errors,ing_map)[0] class IncrementalDe< r(>cs.~Qdef d,(b", n@:FXtableStreamWriter(C,DpassORead9 9D### 2s module API getregentry(7 UInfo(name='cp857',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@?131@ DOTLESS Ihe8,0ch afA /A19 f B h9/e6IGATURE A9c3p5f( O94: 0x00f6, $ # LATIN SMALL LETTER O WITH DIAERESIS 0x0095:0f2,? VGRAVE;6;b; UzCIRCUMFLEX@7@9@ {8;;130;eCAPITAI}xDOT ABO9A?0d6A 8aAcA ybA+f8AWSTROKzc<%a3<POUND SIGN`d&db % de>515edX >ScvCEDILLA}f?f? =!a0=?0e1= AzFACUT#a1;d;  ;2;fV . ;3;av   ;4; NGTILDd; =/11 Gz7BRE?a/11 ;&0b;INVERTED QUESTION MARKKaaREGISTEREaa:NOTayb"VULGAR FRACONE HALFqbX4vQUARTER7aqEXCLAMAp y'0aWEFT-POINTING DOUBLE ANGLE QUOTE&0bEORIGHFb6259LFG SHAbt6259DlMEDIUM(a6259aLDARK&L6250NBOX DRAWINGS 2EICALlbHE25247 AND LEFT@McH MvbM&0c;= bR/0c  0b8: 0x00a9, # COPYRIGHT SIGN 0x00b9: 0x2563, # BOX DRAWINGS DOUBLE VERTICAL AND LEFTAaA/51A8b878 ODOWNuc=d= /UP;d;E00a2; NULL!1!1!START OF HEADING-2-2-2TEXxx3*3*0ENDU (4(4(pRANSMISj5050UQUIRY$6$6$ACKNOWLEDGq7(7 -> BELL '`\x08' # 0x0008 -> BACKSPACE 2'\t$$ &9&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 BLOCK 1eCANCEL#9YYeMEDIUM*a*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAN0"'" *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 # 0x0039 -> DIGIT NINE ':'# 0x003a -> COLON";"b"GSEMI&<&c&LESS-THAN SIGQ=+d+gEQUALS(>(e(|GREATERV?.f.QUESTION MARK@* 40*COMMERCIAL AT*A*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353F363FfG373G3H383H3I393I3J3J3K33[L31LfM3fM3N33tO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\1{5-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.EOW L+`%6YGRAVENa)LSMAL5b1 13c1 1C 'd'  # 0x0064 -> LATIN SMALL LETTER D 'e'151E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t1T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LIN^}*ORIGHZ~0CTILDR3\x77UDELET#"c7H#8PCAPIT7C WITH CEDILLAJ\xfc@U>DIAERESIJ\xe9@E@6ACU*e2<A<CIRCUMFLE-J\xe4A"A0@1@EGRAVy*e5<<<RING ABOA L*eaYx<bAiA<8@x@ < 8b -> LATIN SMALL LETTER I WITH DIAERESIS '\xee'  # 0x008c -> LATIN @CIRCUMFLEXAPu0131CAdADOTLESS I90xc47 ze9eCAPITAA*c5BfB RING ABOVE9C/90CEEACUT>*e6>1>=IGATURE A4c4246f-&936jO +xfw4A (*f25@ 6GRAe*fb<6<U 7A }0&98<p<#*OT$d;9B~ = dc/9aB B*f8BbBUSTROKs*a3=POUND SIGN dd * fAu015LiScEDILLA@f@ >!xeca >L dx< ! <f\a x3 <ax < NlETILDd< >Hu011a >G|5BRE >a<!xb:INVERTED QUESTION MARKU!xa3REGISTEREaa9NOT%b,VULGAR FRACONE HALFbZ5tQUARTER8aqEXCLAMAr '\xab' 2# 0x00ae -> LEFT-POINTING DOUBLE ANGLE QUOTATION MARK '\xbb'  FfFORIGHGu2591' G b0GLGc SHADEo(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS VERTICAL(24_48 A AND]A!xc5ALATIN CAPITAL LETTER A WITH ACUT!xc>6> CIRCUMFLEX0C7C EGRAV*a9>8>ACOPYS SIGNiIu2569+ cgd ,Au255.d/baB { 579b9ODOWNwd>c>,UP<+xad<HCENT0xa5`8YEN%Au251b @1cX=>3<l<HORIZONT%ccAC1C  0?c|3|  G!xecLSMAL5TIL+xc<>8a z5 w6#| 886D   5CE~ A; ~ H!xaBCURRENCY,!xb*dMASCULINE ORDINAL INDICATOR '\xaa' # 0x00d1 -> FEMININE ORDINAL INDICATOR ,K'\xc727LATIN CAPITAL LETTER E WITH CIRCUMFLEXCbz3C DIAERESISB8B4B SGRAVE>Pufffe@5>UNDEFINED&0xcd$$ &6&IDACUTd!xcb>7> 'f8C 'Au251)9BBOX DRAWINGS LIGHT UP AND LEFTPu250c;a;ADOWN=RJ>8yb>FULL BLOCK'4ec'LOWER HALF-0xa6+Rd-BROKEN BA'e' @2580gf>?UPP d3+k e0-kO"de>ESMALGeSHARP d2uuY*d2C#:xf5>| <STILDE+xd<z =>b>MICRO SIGNe e{ *d7^pMULTIPL8IONV*xdeLU eO> 9TC eek  <fzz <Y +xa@TMACRO+xbxQd ACCEN*xaftSOFT HYPHEQ1.f^PLUS-MINUS 1fS 1bf6VULGAR FRACT2THREE QUARTERbf3xPILCROW*xaf "SE\+xf) PDIVIS*b # 0x00f7 -> CEDILLA '\xb0' # 0x00f8 -> DEGREE SIGN(*a8(9(IAERESIS&*b7&a&MIDDLE DOT'9'b'SUPERSCRIPT ONE,3,c,FTHRE.2.d.#WOZAu25ae,BLACK SQUARU' $f)NO-BREAK SPACE ) ### Encoding Map e_map = {zg100:o400,~FNULL 1 1 START OF HEADING,2,2,2TEXuu3)3)0ENDS '4'4'RANSMISSIOV5/5/VQUIRY6#6#ACKNOWLEDGfJ7'7'(BE8 8 2ACKGE9%9%HORIZONTAL TABULATa1a1LINE FEEDb%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II1x1xDATA LINK ESCAP11DEVICE CONTROLx11 .Tz.1 .01 0EFOUR11NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WfMEDIUMK1SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2fNUMBER22LOLLA'2{PERCENTO2 AM&AN22APOSTROPH2v28, # LE FT PARENTHESIS 0x0029:, # RIGH-a-a-ASTERISKQb$b$PLUS SIGN%c%c%VCOMMA!d!d!HYPHEN-MINUe(e(FULL STOPMf%f%WSOLIDH"30#%30#DIGIT ZEROI#31&1&6ONE%2%2%'TWJ3%3%7HREL4'4'FFOURr5&5&'IVL6&6&6SIXK7%7%6EVE#38'8'E<N]+39'(NI1V3VGCOLOnS3SKSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cQUESTION MAR4i4iERCIAL AT<4l4lLATIN CAPITAL LETTER 44y4y2Bd42C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 24425525 5  Q5 5  Y5 5  5 5  5 5  U 5  V 0x0057: 0x0057,  # LATIN CAPITAL LETTER W *28: 2 X29292 Y2a2a2 Z2b2b2EFT SQUARE BRACKET/c/c/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(ESMALAX2020 B03030 C04040 D05050 6060 F`70  G0/68` H06 `I06 0J06 0K06L060M060N06O077`P07 Q07 R07 977  77 U7 V07 77 77 77 77]CURLY77`VERTIC_77RX7FTILD77VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARab5tF SIGa3: 0x009c,  # POUND SIGN 0x00a4: 0cf,&CURRENCY)5)%be);YEN$6$%dd$BROKEN BARs7&%f5&lSECTION8(9(DIAERESISM9%%b8%COPYRIGHTa*%d1* FEMININE ORDINAL INDICATOb6aLEFT-POINTING DOUBLE ANGLE QUOTAFMARKcEa{,NOd$%f0$SOFT HYPHEe'aREGISTEREf+eVMACROM"b0"f=jDEGREE:#b1':PLUS-MINUS+2+SUPERSCRIPT TWO#b3+c+FHREE-eACUTE ACCENT(%e6U[MICRO%f4&{PILCROW(MIDDLE DOt7NvCEDILLA%fb#'ONoMASCUL b!bVULGAR FRA ONFARTE%ba7FHALF%f3 4T1 QUmbaINVERTED QUEScbLATIN CAPITAL LETTER A WITH GRAVcb= cb= CIRCUMFLEXB'cGTILD78 _cP8WA R8ABO?l%92 BIGATURE Ay8 5C ocd?E? 9| = =d de, # LATIN CAPITAL LETTER I WITH GRAVE 0x00cd:0d6,_ # L=GACUT=e=7=CIRCUMFLEXfB8BDIAERESISA"d1A/a5A NFTILD"d2=/e3= O= :#d3=0= :#d4=2=:#d5B  6=/99w7AeMULTIPLICATION SIGN8//9dpWSTROK9>/eb> Ua= = b=azcB9Bj"+e1ESMALfSHARP "e0w8 6A1eR ; /eP8P;-eSc@ eQ/84' feN8zRING ABOGeQIGATURE AeC8= CuCEDILLAQeQ8W =E= eN8{; L8-;O8@L/ec ea " 8v8 f N WITH TILDE 0x00f2:@95, # LATIN SMALL LETTER O WITH GRAVE ';3;/a2;GACUT;4;/93;CIRCUMFLEX{5@/e4@GTILD{6;9;DIAERESISz7?%f6zDIVISION SIGN)8)%9b)YWSTROK9<7< Ua;aZ ; b;9;c@/81Zf?/ed? Y ?211e?aeCAPITAGA6BRE#11|aq ;"30x+98 xIxwDOT ABO|"31A8 DOTLESS Ia#15/9ey SyvCEDILLA?+9f? =3250cEBOX DRAWINGS LIGHT HORIZONTALv3250ob9hVERTIC7[%da7DOWN AND Rt1b= FLEFT</c0y /UPw/d9; uc%{2b fA 22 3c B8@@ F5c[ FoDOUBLE5bq:0585]b4> 5c=E UP AND RIGHT 0x255d: 0x00bc, # BOX DRAWINGS DOUBLE UP AND LEF;"60;c; VERTICALA7RIG}"63B/b9} B 6A/cbA ADOWNHORIZONTAL#69CaC AcAeA G8N%dfGUPPER HALF BLOCK"84sdz?LOW,8,#KFULLR"91&%b0~Le SHADEy#92'1'lMEDIUM(2(KDARK&af:BLACK SQUARE } """ Python Character Mapping Codec for CP858, modified from cp850. D import c3cs ###?APIs class($.^1): `def en(self,input,errors='strict'):,Gcreturno.charmap_B=,ing_map)m/dem-B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~e!@OStreamWriter(J,8cs.5pasORead9 9Fsule API getregentry(7 UInfo(name='cp858',d!e=02(). id:.r=]/J //spr7=D #w##)Z]0MapA0codTmap =make_identity_dict(range(256)) 5.update({Fh%c7LATIN CAPITAL LETTER C WITH CEDILLA?f?ESMAL=U= DIAERESIS 0x0082: 0x0P0e9, # LATIN SMALL LETTER E WITH ACUTE '0x0083: /e2; A;CIRCUMFLEX@4@4@DIAERESIS?5?0?GGRAV6;5;RING ABO@7@7@ CfEDILLA8=a= r79@b@7a?8? 7b;f; Izc?e?d@c@ e;ckeCAPITAfA 2A4#90B i B k"91=/e6IGATURE A"923c3p5f( O9fu@f9fR  9f Uf @ {f Y{d4Ad AAf WSTROKg%a3POUND SIGN9db ddoMULTIPLICATIONm/19F FEHOOKa%e1 % ad;  ;fCv ;L  ;4: 0x00f1, ! # LATIN SMALL LETTER N WITH TILDE 0x00a5:0d1,;oCAPITA= 6=%aa= FEMININE ORDINAL INDICATORs76b6oMASCUL7 87fmINVERTED QUESTION MARKi92%ae2REGISTERED SIGN+a+c+;NOT$b$%bd$VULGAR FRACONE HALFXc4X4gQUARTE#d7aqEXCLAMAp e5bLEFT-POINTING DOUBLE ANGLE QUOTEfEbEORIGHF b0F6259LFG SHA}#b1'2lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS 2EICAL"b47%24]7P AND W@Bc} BAFACUTbBc=CIRCUMFLEXN%c0B GGRAVT%a9=ACOPY bL6256 &\^'b6255'A vE25578ODOWNu6255=/UP;;CENbs5;YEN:R6251 cH1 8c\3;HORIZONTct2 B1B 2 0: z?253zFeZ VTVc ; =6255  zk  0x00c9: 0x2554, # BOX DRAWINGS DOUBLE DOWN AND RIGHT *0x00ca: >/69> !UP<HORIZONTALAbA6A CcC0C VERTICAL dB5B |e:/6c|GfG600aCURRENCY SIGN/"d0)fLATIN SMALL LETTER ETH212d2oCAPITA424%caf 4 WITH CIRCUMFLEXv3BbBDIAERESISA4A8AVGRAVE=5=620aKEUROK6%O00cdb IGACUTb7=e="8BfB"9A6251" L z6LEFd0:s ,d8wFULL BLOCK8LOWER HALF,~700aROKEN BARRj600c `6258?UPPec/d3 Oen  fSHARP epd. psNep/d2 el+f5= }FTILDej<00d; =b= NULL!1!1!START OF HEADING-2-2-2TEXxx3*3*0ENDU (4(4(pRANSMISj5050UQUIRY$6$6$ACKNOWLEDGq7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZON@TABU<'\n2a2U FEEDb(b&VERTICAL V:x0c0c0HFORMVr$d&CARRIAGE RETUR!e.e,SHIFT OUf&f&IK11@DATAuK ESCAP11DEVICE CONTROLJ'\x11 /T/ 1 /[11 1EFOUR0 1NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE )191YeMEDIUMMa*tSUBSTITi 1 x001c -> FILE SEPARATOR '\x1d'  # 0x001d -> GROUP,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-'E33F33FG33G3H33H3I33I3J33J3K33L304c -> LATIN CAPITAL LETTER L 'M'# 0x004d -> LATIN3M3N3e3N3O3f3O3P3/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 v' # 0x0076 -> LATIN SMALL LETTER V 'w'# 0x00771W1x181X1y191Y1z1a1Z1{1b1EFT CURLY BRACKET/|/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%of"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: d9ETTER O WITH DIAERESIS '\xdc'  # 0x009a -> LATIN CAPITAL LETTER U WITH DIB*f8BbBESMAL@O@dSTROKE*a3=c=POUND SIGN'ddd'f*d7fe?MULTIPLICATIONoPu01922f0o FDHOOK e19 P/a0;A;EACUT *ed<1<I<fI/a2<  x*fax3< < 4<NETILDd<5< |>a6>FEMININE ORDINAL IND$ORb777oMASCUL8 f%88INVERTED QUESG5MAR *ae393REGISTEREaa8NOT+xb!kVULGAR FRACONE HALF Zc5eQUARTE)atbEXCLAM; bkLEFT-POINTING DOUBLE ANGLE QUOTFbFORIGHGAu259bGE SHA(bymMEDIUM)hQfLDARK'0PQBOX DRAWINGS L=CICALPu2524?_M8P AND ]A!xc~bRc>R >CIRCUMFLEX0C^C EGRAV*a9>dACOPY Iu256\ +gd ,Au255.mrB 9P99ODOWNw>>,UP<+xa:CEN&*a5Fe -> YEN SIGN . '\u2510' # 0x00bf -> BOX DRAWINGS LIGHT DOWN AND LEFT =4=/c0=!UP;RJ<3<1< HORIZONTALA(2c}2AC1C3CVERTICAL0?/c4B|3|5: | G0xe3 c6GLATIN SMALL LETTER A WITH TILDEB+xc<7<oCAPITA> Pu255a|: c8> :DOUBLE 59= =(69|a?| 8Xu2566BbBD cD  5CdC~ Ae; ~ H!xaBCURRENCY SIGN0f*dl4ETH3d33 c5cXh5CIRCUMFLEXx cbCC DIAERESISB8BB DGRAV[Hu20adIEUROQ*cdd IDACUTd:xce>>'fCC '@)d@ >0$; :8yFULL BLOCKAu258LOWER HALF-!xa6ROKEN BART!xc'z6 !58p?UPPdes "O"de1 -> LATIN SMALL LETTER SHARP S '\xd4' # 0x00e2 -> LATIN CAPITA9O WITH CIRCUMFLEXC2C3C TGRAVE>*f5>4>SETILD<d<5< >b>6>MICRO SIGNe7'" ETHOR5d585 7al97UFACUTb>a> 9CbC d>c> +Y <d< 2>*afze>UMACRObf#@t ACCENTa f0)SOFT HYPHEQ1t f1(PLUS-MINUSEPu2017.gfgDOUBLE LOW LINb<fPVULGAR FRACTION THREE QUARTER b6e fMxPILCROW!xa):"SE\  )%PDIVIS**b8|(tCEDILLA[*b0$0DEGLaLDIAERESI MIDDLE DObfSUPERSCRIPT O|3,x f .#WO,Au25apBLACK 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%pHORIZON9@TABU)1a1a1V FEEDb%b%VERTICAL Tc/c/FORM FEED 0x000d: 0 , # CARRIAGE RETURN #e+e+SHIFT OUT%f%f%II"10$%10$DATA LINK ESCAPEP#11,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 SEPARATON%1d*_GROUP+1oRECORD,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[GREATERTc3cAQUESMARK 0x0040: 0x0040, # COMMERCIAL AT !1)1)LATIN CAPITAL LETTER A22222 B23232 C24242 D25252 E26262 F27272 G28282 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O255P2 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 0 66 0 66 066 06a: 0x006a,  # LATIN SMALL LETTER J 0x006b:,0K0c0c0 L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0&7b0EFT CURLY BRACKEN7VERTICAL LINEW7ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARab5CENT SIGa9[POUND&cCURRENCY)b;YEN$dBROKEN BAfaf1SEC fnDIAERESIabBCOPY OaM FEMININE ORDINAL INDICATOaLEFT-POINTING DOUBLE ANGLE QUOTa,NOf SOFT HYPHEaREGISTEREeVMACROMb=jDEGREEbfwPLUS-MINUS+fSUPERSCRIPT TWbf +6HRE'beACUTE ACbe[MICROf{PILCROW(MIDDLE DObvCEDILLA 0x00b9: 0x`00fb, # SUPERSCRIPT ONE 0x00ba: %a7+ MASCULINE ORDINAL INDICATOR7b7f7RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKFcFcFVULGAR FRAC0 ON>GARTE}d77FHALFke4/f3kETHREmS:f:%a8:INVERTED QUES "c02bTLATIN CAPITAL LETTER A WITH GRAV#c1=5o= GACUT=2=6=CIRCUMFLEX"c3BcGTILD4=/8eDIAERESIl#c5AW Ri8ABO?6B/92IGATURE A75/805CvCEDILLA48?/d4? E? 9=9| = d=drBd Id = d =dBd/d1 %TH.da N1 bde O= kdek = ndek =nde B 9j =9pMULTIPLFSIGN/9dpVSTROKQdeYUe = 0db: 0x00ea, # LATIN CAPITAL LETTER U WITH CIRCUMFLEX .0x00dc: 09a, B DIAERESISAdA/edA YVACUTE=e=8= VTHORN6f616ESMALfSHARP "e06/856 AFGRAV"e1;/a0; "e2;/83;"e3@/c6@GTILD4;/84;#e5?zRING ABO56@9IGATURE A73/87 CuCEDILLA#e8=  E= 9;2x ; a; vb@9{8~ Ia:; /8c ;/8b@fd 5ETHf  N' Ff97 O; WfaW ; bf97 ;bfe @ ;f7DIVISION SIGf9 VSTROK)f9)  aZ ; 9n m;r @Zev LATIN SMALL LETTER Y WITH ACUTE 0x00fe:0e7, # LATIN SMALL;VTHORN4f4/984 oDIAERESIS?B20ac?%d5?EURO SIGd2192%%9f%FEHOOK_"17:%f2:DOUBLE LOW LINB2500+%c4+BOX DRAWINGS LIGHT HORIZONTALd#50/b39 hVERTIC7a7 DOWN AND Rt1b=FLEFT<40y /UPw8;/d9; uc%{2b fA 2 2 3/c1@ F5/cd:1bq:058m 5/bb > "5ac] 3{"5d</bcy < w6d; *m #63}4 B 6Ac7#69C AeB G8NdUPPER HALF BLOC#58ldz?LOW,#KFULLR9FSHADcb{MEDIUM (GKDARK&af:XLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP860.TXT' with genc;P.py. c#" import codecs  ### Codec APIs class (c!s.): def en(self,input,errors='strict'):,0preturn 1cs.charmap_B=,ing_map)m de<m)B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~eL!@OStreamWriter(J,8cs.5pasORead9 9Fs module getregentry(7 UInfo(name='cp860',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@3@GTILD{5;0;GGRAV;6;+c1; o 7=e m8=az =k09@c@ BaB/e8 7b;+cd; }I 7c=/d4= O=dBe } e;cgCAPITAL LETT ER A WITH TILDE 0x008f:0c2, # LATIN CAPITAL LETT=CIRCUMFLEXB#90B9B EFACUT#91=0= GGRAV=2=8= z =3=+f4=ESMALO4@5@ t#95; t{ 6;+dav U m7=f x; x8;/ccx Ix =9=d+ m -a=z DIAERESISbAanCENT SIGN%c%3[POUND&d&dA  e=F20a7c[ESETAdd- a%e1d= M ;/ed;  ;f v  ;P v N Tad; =a FEMININE ORDINAL INDICATORaa|b6oMASCUL7 x%bfINVERTED QUESTION MARKim  amam+NO+aPb)VULGAR FRACONE HALF_bX4gQUARTE5paqEXCLAMAp hE00ab3LEFT-POINTING DOUBLE ANGLE QUOTEbEORIGHFb6259LFG SHAb{6259lMEDIUM(h6259hLDARK&S2502, # BOX DRAWINGS LIGHT VERTICAL 0x00b4: 0x2524, # BOX7 AND LEFT@5@/61@qu SINGLEAv DOUBLEH6H2H 8HXH7H/56HCDOWN|D8D5DxD9D/63DHAaA5YpA8b87y c=d= /UPd;c;/UPweBbBu fB/10B#c0<  RMs"c1;3;HORIZONT"c2@2; B3B1B  0: z3zF/5eTfI ? IaI@5<z/69zM6{C6GB |6R|G 6#UPA Rd/68 Hd%6/WN/6DOWN DOUBLE AND HORIZONTAL SINGLE 0x00d3: 0x2559, # BOX DRAWINGS UP DOUBLE H]RIGHTC4C8CuCT5C2CCDOWNwE6E3EyE7E/6bEVERTICAL^8NaN N9N1iL!UPGFLEFT:a:/0c:f=b=8wFULL BLOCK&c&4cLOWER HALF,d,+e+%90WWf,8,?UPP e0,E03b1X GREEK SMALL LETTER ALPHA!e1450df4ZLATIN4vSHARP S626&39j@CAPIlGGAMMl603c6 &PIg?03ag 8SIGgy<03c6 g 4hE00b5MICRO SIGNI603c6TAU2-E03a6X2 )'PH60394GTHET]603a6GOMEG6?03b 8DELj521eINFINITY<03c  '03 2gEPSILO&22INTERSECTI(f6226BIDEN%TOfCPLUS-MINUS f62263GREATER-THAN OR EQUAL _6226oOLESS1623232TOPUFGRAL6232oBOTTOM0%f7pDIVISIOf6224oALMOST&0b DE =6221BULLET OPERATOR0b7, # MIDDLE DOT 0x00fb: 0x221a, # SQUARE RO'c'607f'UPERSCRIPT LATIN SMALL LETTER Ncd<O00b2<6TWO+e+E25a0+SBLACK(f('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00'00 -> NULL!1!1!START OF HEADING-2-2-2TEXx3*3*0ENDU (4(4(RANSMISSIOxX5050UQUIRY6$6$ACKNOWLEDGE(7(w7 -> BE8!8!2ACKY2'\t$ ec9&HORIZONTAL TABUKn2a2LINE FEEDb(# 0b&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 !"EXCLAMATION MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&) AM&"AN0"'" *2APOSTROPH(MLEFT PARENTHESISf)-RIGHT PARENTHESIS c '*' # 0x002a -> ASTERISK -'+%b%PLUS SIGN&,&c&RCOMMA"-"d"HYPHEN-MINUS).)e)FULL STOP&/&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 -> L3X3Y393Y3Z3a3Z3[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\x7R7UDELET#"c7H#8 C WITH CEDILL3\xf@U WITH DIAERESIS '\xe9'  # 0x0082 -> LATIN SMALL LETTER E WITH ACUTE 2<2<3<A<CIRCUMFLEXA3A4A FTILD}0<5< EGRAV<*c1<6<eCAPITA 7>7> 3CeEDILLAa>8>q5cA9A C*e8aC A <d<b< I <*d4>c>O>*ecCdC  qe<  scf> co/90C| >c/91> 9 | >f9)f59A zfz9< d09Us sf< zc9 qd0 2d| |DIAERESISatCENT SIGN& R9YPOUND'dGIAu20at9jPESETAf 3 ea Y\ < a < <fa <fa ACUTE '`\xf1' # 0x00a4 -> LATIN SMALL LETTER N WITH TILDE 1K'\xd<5<oCAPITA> *aaz6> FEMININE ORDINAL INDICATORub777oMASCUL8 fo88INVERTED QUESTION MARKk*d2393 OEGRAV*ac>a>NOT SIGNc*bd%b%VULGAR FRACONE HALF5 Zc5eQUARTE;ad8qEXCLAMAr*abe6LEFT-POINTING DOUBLE ANGLE QUOTFbFfFORIGHGAu259 b0GLGE SHA((1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS OCICALXu2524__8P AND ]A6d As1 SIBI oIYI(56 ICDOWN~E5EE  E# ^B 979 wu>%UPAz< </UP}C C{ (10 C1c=&3<<HORIZONT@cAC1C   0?c|3|y  G '\u255e' < # 0x00c6 -> BOX DRAWINGS VERTICAL SINGLE AND RIGHT DOUBLE '\u255f' J7J9J[JaJ8JA&UPD=4=9=ODOWN?(69?a?|HORIZONTAL(66BbBD0DcD5CdC~c~e; ~H7HfH(UPVB ['68I/d0I I Z6-d1I5Ka`(652K5 KaK5t-d3K#UPI~ D #4D3D25D  F3FRF5(6bFN OSdS9O1neL"%FLEFT;0]da;%d>8y]FULL BLOCK' @LOWER HALF- *,9Vd-8-?UPPG03b1e GREEK SMALL LETTER ALPHA0xdf3teZLATIN5sSHARP S7Hu039eleCAPITAnDGAMMnHu03ce7 &PIiai2 i9SIGi 77 i5!xb xMICRO SIGNc 0x00e7 -> G$REEK SMALL LETTER TAU '\u03a6' # 0x00e8 -> G3eCAPITA56PHI5(98595VTHETA7(a97a7GOMEG7(b47b7 6DELlH221e5c5INFINITYcd% Z (b5Xe3tEPSILONj9222f7INTERSECTI)'61`!f0)DENTICAL TOR!xb' f1)PLUS-MINUS SIG~6 f2,GREATER-THAN OR EQUaHu226w f35OLESS2832042TOP HALF CGRALAu232z f5.oBOTTOM10xf7]61DIVISION4 f7*lALMOST!xbV DE T1fBULLET OPERATOR+xbMIDDLE DOT'Pu221aSQUARE RO(807f(SUPERSCRIPT LATIN0xb2;=$TWTAu25abBLACK x'UNO-BREAK SPACE ) ### Encoding Map e_map = {Qy100:000,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^10OL FOUR 0x0015:  ,  # NEGATIVE ACKNOWLEDGE (6060SYNCHRONOUS 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'%25'{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 44y4y2Bd42C242442442F 0x0047: 0x0047,  # LATIN CAPITAL LETTER G *28: 2 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R23232 S24242 T25252 U26262 V272  W2 /58d 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`771, # LATIN SMALL LETTER Q 0x0072:, # LATIN 0R03030 S04040 T05050 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 MARKa9(CENT SIGN%9[POUND&ac FEMININE ORDINAL INDICATO)aa#LEFT-POINTING DOUBLE ANGLE QUOTa+NObIjDEGREEbF%f1PLUS-MINUS+<fqSUPERSCRIPT TWOBbe[MICROQufMIDDLE DObhPMASCUibiIjbj VULGAR FRAC` ONFARTEb8ag7FHALF4aAQUESm c9PCAPITA WITH GRAV?c8= 7ACUc 8]= CIRCUMFLEcd8aTGc9%80CuCEDILLAjc/92? E? 89| = 88 =89&I08b, # LATIN CAPITAL LETTER I WITH ACUTE 0x00d1:0a5,O # =N=GTILD=2=9= O=GGRAV=3=/9f= 4=/8c=CIRCUMFLEX5B9 9=d Ua=6= c=a=DIAERESISfA+e1AESMAL,fSHARP 6"e068' 6Aeb0q ; e`/83;ec/84@ #e77; CuCEDILLAd#e8=  .E= eZ/82x ; .X/88;.[8 F daU ; f f9 }fag ; {9 ;gfy @ ff:DIVISION SIGNfF9 fFa ; A ; #39e\GREEKEGAMMl#39le6FTHET6al67SIGl"a6eb64PHI#3ae 4FOMEGbe56 EALPH43b4: 0x00eb,  # GREEK SMALL LETTER DELTA 0x03b5: 0x00ee, 4uEPSILON6#c0636 &PI13151 FSIGM#c4474 6TAUf62d2 $PHB207f2%fc2SUPERSCRIPT LATIN?B20a7<9;PESETA SIG'2219'%f9cBULLET OPERATORC221a+b+SQUARE ROOT'e'eINFINITY$2v%efKINTERSECTIB2248LfeALMOST EQUAL TOS#61+0SkDENTIC(fLESS-THAN ORY%f2YGREATER4#32%f44TOP HALF DGRAL$32~oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi2502#b91VER5250c7%da7DOWN AND R=1b= 5LEFJ#51c</UPw9d$; uc%{2b fA 2po3/c1 @ a F5c oDOUBLE5bq:l5d4aSINGLEw NE /d6=E4EVE@L45r/b8r? mb: ~#WN4DTCb D=# BOX DRAWI#NGS UP SINGLE AND RIGHT DOUBLE 0x2559: 0x00d3, # BOX DRAWIC2CTCaC/c8C@&UPC<b</be< >LEFcBdBB dBcB?Be;/c6;VERTICALfI7I  #60I I"61B/b5 z Z#62H HX3H9? HA4A/d1A(WNHORIZONTAL5J2JYJ 6J/cbJQ DOWNaJ7CfC ;A 8H/d0HJ/caHEGHdHL  ZdRfc G8dUPPER HALF BLOCK,?LOW,OLFULLRd+)}9o91ALkFSHADj9{MEDIUM (eKDARK&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_encode(input,err0ors,encoding_map) def decode(self,input,errors='strict'): ,preturn 1cs.charmap_B=,m table) class IncrementalE3er(Mx h final=False*@:. ?[0]D ~(@OStreamWriter(Codec,RDpassORead9 9A### Kings module API getregentry(7 0QInfo(}name='cp861',d!e=02(). id:.r=]/J //spr7=D #w##0) IZping MapA$ =bmake_identity_dict(range(256)) map.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?0?GGRAV6;5;RING ABO@7@  t8=a} r79@b@7a?8? 7b;dr 6ETHc4f4 + 2d2+de fVTHORNhe6cM 6fA A9 K BM 0x0091: 0x`00e6,  # LATIN SMALL LIGATURE AE 0x0092: c3oCAPITA535/f4hETTER O WITH CIRCUMFLEXu4@ u @DIAERESIS?5?e VTHORN464b4 U7@+dd@(YBGACUTe8=f= ;9;d+ xm-aAc AbA+f8A WSTROKc<%a3<POUND SIGd&db de>F20a7d[ESETAef'E0192' FEHOOK;!a0:?0e1: A: #a1; I;f;w va  ;c c =d = =%bf/INVERTED QUESTION MARE23102REVERSED NOTyaa$db:VULGAR FRACONE HALF\bX4vQUARTER7maqEXCLAMAp d700a>EFT-POINTING DOUBLE ANGLE QUOTE&0bEORIGHFb6259LFV SHADzbz'25lMEDIUM(g6259wLDARK&R6250=BOX DRAWINGSZ0HT 4EICALlbN6252(7 AND LEFT@Q6256 @q SINGLE AND LEFT DOUBLE 0x00b6: 0x2562, # BOX DRAWINGS VERTICAL8 AND LEFT SINGH7H/56HODOWND8D5Dx 9D/63DaA/51A8b878 uc=d= %UPxd;c;/UPweBbBu fB/10B@LIGHz.WN#c0<4< RI"c1;3;HORIZONTAL@2@2; B3B1B D 4A0: z593zF/5e}TKfI IZIaI@5<z/69zM6{C6QB |6R|G 6#UP;A Rd/68 H Qd%6/WN/6 &75k d95  AND RIGHT DO UBLE 0x00d5: 0x2552, # BOX DRAWINGS DOWN SINGLE AND RIGHT DOE6E3E4EV7E/6bEVERTICAL}IHORIZONTALN8NaN  NN9N/18NL!UPGFLEFT:a:/0c: f_=b=8wFULL BLOCK&c&4cLOWER HALF,d,+e+%90WWf,8,?UPP e0,E03b1X GREEK SMALL LETTER ALPHA!e1450df4ZLATIN4vSHARP S626&39j@CAPI4lGGAMMl36c6 &PIg41ag 8SIGgy<03c6 g 4hE00b5MICRO SIGNI603c6TAU2-E03a6X2 )'PH60394GTHET]O03a9j GOMEG6?03b 8DELj521ejINFINITY<03c  '03 2gEPSILO&22INTERSECTI(f6226BIDEN%TOfCPLUS-MINUS f62263GREATER-THAN OR EQUAL _6226oOLESS1623232TOPUFGRAL6232oBOTTOM0%f7pDIVISIOf6224oALMOST&0b DE =6221BULLET OPERATOR&0bMIDDLE DOf6221SQUARE RO'&07SUPERSCRIPT lf&0bSUPERSCRIPT TWO 0x00fe: 0x25a0, # BLACK SQUARE(f('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00't00 -> 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(#F 0b&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+#+NUMBER SIGh$(HOLLA(%(wPERCENTQ&)AMPERSAN0"'" *2APOSTROPH(MLEFT PARENTHESISf)-ORIGH.*.sASTERISq+%GPLUS,&RCOMMA-"HYPHEN-MINUS S '.' # 0x002e -> FULL STOP -'/&f&rSOLIDUS$0$ 30$DIGIT ZERO'1'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=+d+gEQUALS(>(k|GREATERV?.sQUESTION MARK@*4yCOMMERCIAL ADA*|LATIN CAPITAL LETTER A]B33B3C33C3D33D3E33F33FfG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33tO33-P35'3Q30QR30wS30lT30U30UV30V3W30W3X30\Y30YfZ3# 0x005a -> LATIN CAPITAL LETTER Z '['# 0x005b -> LEFT SQUARE BRACKET0$\\10c0REVERSE SOLIDUS,]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)1)<ESMAL:AZb121B1c131C1d141D1e151f161Fbg171G1h181H1i191I1j1a1J1k1& K1l1L1m11M1n11N1o1O1p17bP1q1Q1r1R1s1Pt1"u1Uv1V1w1W1x1X1y1Y1z1{1ZCURLY|/`VERTIC`|}*RZ~0CTILD3\x7R7UDELET#"c7H#8 C WITH CEDILL3\xf@U>DIAERESIJ\xe9E@6ACU*e2<A<A\xe4A # 0x0084 -!> LATIN SMALL LETTER A WITH DIAERESIS '\xe0' # 0x0085 -@ UGRAVE<5<6< RING ABOA7A7ACuCEDILLAa>8>E>IRCUMFLEXAbA9A <8@a@ <dxb<eCAPITA4ETHf5c5 3*ded3 hTTHORNj*c47e7YcfB )c9/90CFACUT6>1>-IGATURE A4c424.6f-&936jOfw4A f9 f9U*dda-YC f><d0 zs 2*dc B Bf9USTROKh*a3POUND SIGdd fAu20aa9hPESETAgPu0192( FDHOOK( e19 ?a ;& ea>Iw <fAa x < 8a <c 8c >dCAPITAL LETTE R O WITH ACUTE '\xda'  # 0x00a7 -> LATIN CAPITAL LETTER U>*bf>8>INVERTED QUESTION MARKqPu23105q93REVERSED NOT SIGN.0xac, a. %*bd%b%VULGAR FRACONE HALFZbZc5tQUARTER8*a1md8qEXCLAMAr:xab6e6LEFT-POINTING DOUBLE ANGLE QUOTFbFfFORIGHGAu259 b0GLGT SHAD(2(1(mMEDIUM)3)2)LDARK'0P3'BOX DRAWINGS ?CICALsXu2524_48 P AND ]A65As1 SIBI 6IYI(56w CDOWN~E5E~E  E# ^B 979 w>%UPAz< </UP}C C{ b C1c=&3<<HORIZONT@cAC1C   0Jc|3|y G'5ec ]5JMcXJ[JJ0c8 -> BOX D.RAWINGS DOUBLE UP AND RIGHT '\u2554' # 0x00c9 -> BOX D=ODOWN?(69?a?|HORIZONTAL(66BbBD0DcDVERTICAL5CdC~c~e; ~H7HfHUP SINGLEBS8I/d0II_I-d1I552K5t-d3K#UP95#4DDD25D F3F6F{(6bF7F}J aO8O%Oe*1neL7LEF0]da;kdy8y]FULL BLOCK' @LOWER HALF- *,9Vd-8-?UPPG03b1e GREEK SMALL LETTER ALPHA0xdf3eZLATIN5sSHARP S7Hu039eleCAPITAnDGAMMnHu03ce7 &PIiai2 i9SIGi 77 i5!xb xMICRO SIGNceY\6TAU3ae=3 'PH9e#5GTHETda ea -> GREEK CAP)ITAL LETTER OMEGA '\u03b4' # 0x00eb -> GREEK SMAL5EDELT5H221e5c5INFINITYZ(c6%d%Z6PHI3(b53e3tEPSILON7H22297f7INTERSECTI)'61)!f0)DENTICAL TOR!xb' f1)PLUS-MINUS SIG~6 f2,GREATER-THAN OR EQUaHu226w f35OLESS2832042TOP HALF CGRALAu232 f5.oBOTTOM10xf7]61DIVISION 48,[7*lALMOST!xbV8, DE T1 f9(BULLET OPERATOR+xba,MIDDLE DOT'Xu221aSQUARE RO(807f(SUPERSCRIPT LATIN 0xb2;=$TWTAu25a8bBLACK 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'(BE8 8 2ACKGl9%9%pHORIZONq@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 IDL1Fe BLOCK@10018, #  CANCEL 0x0019:, # END OF MEDIUM)a)a)SUBSTITUTE&b&b&WESCAP"c"c"FILE SEPARATORLd*d*_GROUP+e+e+oRECORD,f,f,OUNIT*"20*%20*FSPAC#21!1!EXCLAMATION MARK#22,2,OQUOT*3*3*NUMBER SIGNQ4'4'\DOLLA'5'5'{PERCENTO6(6(AMPERSANDt7%7%POSTROPH8&8&LEFT PARENTHESISR%29,ORIGH-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 44y4y2Bd42C242442442F42G242H242I24a, # LATIN CAPITAL LETTER J 0x004b:,o # LA2K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R23232 S24242 T25252 U26262 V27272 W28282 X29292 Y2a2a2 Z2 &5b2EFT SQUARE BRACKE[5REVERSE SOLIDU5ORIGH[5CIRCUMFLEX ACCEN5uOW LINE66\GRAVEL66ESMALSAX6 0B06 0C06 0D06 06 0F`6 0G06 0H06 0I06 066 0663 06606606677`77 77 77 977R T 0x0075: 0x0075,  # LATIN SMALL LETTER U (6060 V07070 W08080 X09090 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"a359POUND SIGN&NaLEFT-POINTING DOUBLE ANGLE QUOTkea:NOTibGkDEGREE'%f17PLUS-MINUS+2fSUPERSCRIPT TWObTe$[MICROQfMIDDLE DORb2)3b3VULGAR FRAC ONqVARTERa7FHALF4az>AQUESm ;c%a4PCAPIT:A WITH ACU"c48R=DIAERESISc8a~ RFABOV0c/92IGATURE A5/805CvCEDILLA9? E? 4  4I=dZ805ETHda4Oq_  =dS9~ VSTROKd1a Ux9{=9~ Y~68 CAPITAL LETTER THORN 0x00df:0e1, # LATIN SMALL LET4uSHARP S6"e06/856 A WITH GRAVE;1;/a0;GACUT;2;/83;CIRCUMFLEX{4@4@DIAERESI5?6?RING ABO6@9kIGATURE A73/87s ChvCEDILLA8=a= E= 9;2; a;8;b@9@d?aeI fcz %THb#f3m' Om9 ;'fM @'fYfDIVISION SIG fE/9b hVSTROKf a U9;c8 @F9 Yez9 #19/9fe FoDHOOK#39eGREEK CAPITAEGAMM#39ed6FTHET6als67SIGlaeK65PHIae4FOMEGbZeZ6 GALPH4e47DELb%ee4eEPSILOI#3c^e 6PcoI1 mc0GREEK SMALL LETTER TAU 0x03c6:@0ed, # GREEK SMALL L23PHI2B207f2%fc2SUPERSCRIPT LATIN>N<"a7<%9e<PESETA SIG'2219'%f9'BULLET OPERATORR321a+b+SQUARE ROOT'e'eINFINITY$2v%efKINTERSECTIO"48L%f7(ALMOST EQUAL TOS#61+0+{IDENTIC(4(3(LESS-THAN ORY5121GREATER423104aV0REVYD NOT#32-%f4aTOP HALF DGRAL$325-oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi2502b(91VERb250c7'da pDOWN AND R=7bt=5LEFw#51c</UPwfd; uc%{2b fA 223/c1 8@  F5 oDOUBLE5bq:l5d4aSINGLEw NE36=E4EVE@L45/b8r? bg ~#WN4DTpb D=2UP oSd(UPCTcK C<b: 0x00be, #- BOX DRAWINGS UP SINGLE AND LEFT DOUBLE 0x255c: 0x00bd,. #B2BRBdBcB?%UPB;e;/c6;VERTICALNRIGHfI7I I #60I I"61B/b5 z #62H X3H9? HA4A/d1A(WNHORIZONTAL5J2JYJ 6J/cbJQ DOWNaJ7CfC ;A 8H/d0H9H/caHEGaA/d8AL  bNRf/ce G8dUPPER HALF BLOCK,?LOW,OLFULLRd+)}9o91ALFSHAD9{MEDIUM (eKDARK&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)IncrementalEralEncoder):  def encode(self, input, final=False): *preturn /cs.charmap_@:F.errors,ing_map)[0] class IncrementalDeM r(>cs.~d,'@XtableStreamWriter(Codec,DpassORead9 92###ings module API getregentry(7 UInfo(name='cp862',!e=02(). i:'r=EKr/J //spr7=D #w##0) IZping MapA0codTmap =make_identity_dict(range(256)) 5.update({F0x0080: 0x05d0, # HEBREW LETTER ALEF.1.1.6BET-2-2-VGIMEL/3/3/8DAL^4/4/&HE[5,5,6VAV-6-6-VZAYIN/7/7/H8-8-T-9-9-6YODa-a-FINAL KAb3b3 -c-c-GLAMEd/d/6MEMe3e3 -f-f-`&NU9e -eeSAMEKH9e 49eP9e,e^VTSADIe /e&QOi9e7RESKeSHIN 0x009a: 0x05ea, # HEBREW LETTER TAV p0x009b:-50a2-CENT SIGN%c%3%[POUND&d&5&;YEN$e$E20a7$kPESETA'f'6019LATIN SMALLF WITH HOOK!a0:50e1a:A:VACUTE;1;d; I;2;f!vO;3;;U;4; N;GTILD5;d;eCAPITAc=6=a FEMININE ORDINAL INDICATOR_76b6oMASCUL7 87fINVERTED QUESTION MAR92E23102REVERSED NO aa-E00ac-$$bVULGAR FRACONE HALF3bX4gQUARTE%DqEXCLAMAp UE00abLEFT-POINTING DOUBLE ANGLE QUOTEs&0bEORIGHFb6259LFG SHAbk'25lMEDIUM(X6259XLDARK&C6250.BOX DRAWINGS 4EICALb?E252477P AND W@D6256 @q1 SIyAHO?256HXHaO2556CDOWN| Dn6255 D &56 D?255YA86255]yu6255=%UP<x6255 ;/UPw6255} Bu f: 0x2510, * # BOX DRAWINGS LIGHT DOWN AND LEFT 0x00c0: 0x2514,<!UP:RI;1;3;HORIZONTAL@2@/2c{ B3B1B VERTICAL4A/00 z593zF6F/5efSINGLEv DOUBLEK7IfI 8IZI8IaI@9<< Na>/69zMbA6A CcCN dB5B |e:6R|GfG72UP A Rd/68HH^Qd%6/WN//6575k#UP$95 CCC/52EB3EyV>/6bEIC6CNNdU1i dQ0Q:6wM8wFULL BLOCK&08LOWER HALF,8+ 9E,2580, #  UPPER HALF BLOCK 0x00e0:@3b1, # GREEK SMALL LETTER ALPHA41450df4ZLATIN4SHARP S (GERMAN)?2?5393?seCAPITAuGGAMMu36+c06 &PIg41ag 8SIGg56c6 g 46450b5MICRO SIGN7&53c4& Z6TAU282+a62 )'PH94/984 GTHET]a6/a96 GOMEG6b6b 8DELjc4E221ejINFINITYd$<03c * e2\gEPSILOf66222INTERSECTI(f$6226$IDENTICAL TOfLPLUS-MINUS f62263GREATER-THAN OR EQU_6226oOLESS1623232TOPFGRAL6232oBOTTOM0%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$ jc9&pHORIZON@TABUK<'\n2a2LINE FEEDb(#0b -> VERTICAL TABULATION '\x0c'  # 0x000c -> FORM FEED&r$ &d&CARRIAGE RETURRe.Re,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'b'  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=+ 0x003d -> EQUALS SIGN '>' # 0x003e -> GREATER-THAN.?.f.QUESTION MARKX@* 40*COMMERCIAL AT*A*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353E3F363F3G373G3H383H3I393I3J3a3J3K3b3[L3c3LfM3d3M3N3LO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.cOW LIN`%6YGRAVENa)LSMAL5b1 13c1 11d1 1/e1 1f1 1+g' # 0x0067 -> LATIN SMALL LETTER G 'h'# 0x00681H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t141T1u151U1v161V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LINEY}*ORIGHZ~0CTILDRB\x7f%N7TDELET#Pu05d0%#8dHEBREWBALEF\/1/ /B.2. .CGIME 030 09DAL`40 0H5- -#VA6. .CZAYIb070 0H8. .T.9. .7YODa. .FINAL KAb4 4 .c. .HLAMEd0 0#MEPe4 4 . .b'NUe9 .9SSAMEKe2' # 0x0092 - > HEBREW LETTER AYIN '\u05e3' # 0x0093 -/FINAL PE34343 -5-5-`WTSADIc6666 070707QOF^8.8.GRESH/9/9/)SHRa/a/3TAV]0xa2,b.CENT SIG!xa&c&ZPOUND'k'd'8YEN%Iu20a,e%iPESETA(1019f(LATIN SMALLNF WITH HOOK)e1/a0;A;DACUT^:xed<1<I<f'/a2<O<<a U< <N<ETILDd<!<eCAPITAi>a)FEMININE ORDINDICATORb70oMASCUL8 f:INVERTED QUESTION MAR Pu23105Ga>REVERSED NOc,= %b#4VULGAR FRACtONE HAL+xbZC5eQUARTE+aTqEXCLAMAr:xabeLEFT-POINTING DOUBLE ANGLE QUOTFbFORIGHGAu259bGE SHA(b{mMEDIUM)jQhLDARK'0PSBOX DRAWINGS L?CICALHu252abO8P AND ]A6T As1 SIBI _IYI5bq ICDOWN~Ew~EE AND LEFT D!OUBLE '\u2563' # 0x00b9 -> BOX DRAWINGS D0 VERTICAL AND LEFTB(51BaB 979b9ODOWNwd>c>/UP<c<d<$UPX SING8(5bCeC3S(10CfCoLIGHT '14=/c0=RJy3<1< HORIZONTALA2@/c2AC1C3C w 0?/c4B|3|5: |G(5e6GA  (5fJ7JJ[(5aJ8JA5 |(69| |R(66BD L5CE~ [; ~Hc#UP_B ['68Sd( I Z6d555?K*5tdG 9 #I lDD2SFdRF{dFW6d7 -> BOX DRAWING@S VERTICAL DOUBLE AND HORIZONTAL SINGLE '\u256a' # 0x00d8 -> BOX DRAWINGO9 OeO(18O,9 OLIGHT UPHFLEFT;(0c;a;ADOWN=RJ>8yb>FULL BLOCK'4ec'LOWER HALF- d-?EFT,(90Ye,-8-f-?UPPG03b1Z e0- GREEK SMALL LETTER ALPHA0xdf3 e15ZLATIN5SHARP S (GERMAN)@Pu0393B e2@u@CAPIHwDGAMMwHu03c&e37 &PIiai42 i9SIGi 757 i50xb565MICRO SIGNc$ e7' \6TAU3 a6\/F3 'PH9e,5GTHETd(a9l(7GOMEG7b!7 6DELlH221el/INFINITYc'Z 0.3eEPSILO92228INTERSECTI)64f4BIDEN#TOx[f(PLUS-MINUS1226AfATER-THAN OR EQUAL aHu226wfOLESS2(32Df2TOPHCGRALIu232 oBOTTOM10xf7DIVISION4flALMOST!xbV DE T1fBULLET OPERATOR+xbMIDDLE DO8(21fSQUARE RO(!07SUPERSCRIPT z:xb26=$TWTAu25aibBLACK '5NO-BREAK SPACE ) ### Encoding Map e_map = { 0x0000: 0x0000, # NULL "1: 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSIONV5/5/VQUIRY#6#6#ACKNOWLEDGE'7'7'(BE8 8 wACKSPACE9%9%HORIZONTAL TABULATa1a1LINE FEEDb%b%oVERTICTc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f%II"10$1xDATA LINK ESCAPJ11DEVICE 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 STOPMr2rWSOLIDH3k3kDIGIT ZER3p3p&3i3iDIGIT TWO 0x0033: , # DIGIT THREE '4'4'FFOUR&5&5&'IVL6&6&6SIXK7%7%FEVEN'8'8'VEIGHT'9'9'7NINa&a&GCOLOnb!b!KSEMI%c%c%LESS-THAN SIGOd*d*kEQUALS'e'e'GREATERTf-f-QUESTION MARK"40)%40)COMMERCIAL A<#41)1)LATIN CAPITAL LETTER A[2222 B2/432 C24D242442Fd42G242H242I242J242O4&Ld4dM2 4 2b442Od552P2 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 SOLIDU5R[5CIRCUMFLEX ACCENf: 0x005f, # LOW LINE 0x0060:,$GRAVE ACCENT(1(1(LATIN SMALL LETTER A02020 B03030 C04040 D05050 6060 F`7070 G08080 H09090 I0a0a0 J0b0b0 K0c0c0 L0d0d0 M0e0e0 N0f0f0 O07/700 P07 Q07 R07 S07 77 U`7 V07 W07 X07 Y07 Z07EFT CURLY BRACKEN7VERTICAL_77ORIGHX7FTILD77VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARa9((F SIGa9[POUND&9;YEN$a FEMININE ORDINAL INDICATOMaaGLEFT-POINTING DOUBLE ANGLE QUOTaB:NOTbmkDEGREE'jf=PLUS-MINUS+`fSUPERSCRIPT TWb@eVMICROQ0x00b7: 0x00@fa, # MIDDLE DOT 0x00ba: &a7& ASCULINE ORDINAL INDICATOR7b7f7RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKFcFcFVULGAR FRAC0 ON>GARTE}d7b7 FHALFkf484INVERTED QUESm #d1252LATIN CAPITAL LETTER N WITH TILDEodo+e1=ESMAL;SHARP S (GERMAN)?e|0? AzFACUTzez I;fv4v #f3-2; Ov7;%f6;PDIVIS.ESIGNf3) TUd2192d9;F;5HOO#39e\GREEKTGAMMA2398p%e96FTHET6al67SIGl#a6l65PHI#a944FOMEGb e6 GALPH44j47DEL#b54e> heEPSILO33c06jPco1 mc/45TAUkcd #5d8gdHEBREWr5ALE58 .%BE#5d8 -TGIMEL#5d"8S /8DAL^8 /H#5d8} ,6VAVD8# -EZAYI #5dR8 /H8? -T-88 -6YOD8e -F]'KAW8. 3 ->8>-ETTER LAMED 0x05dd:@08d, # HEBREW LETTER FINAL MEM 3e3e3 -f-f-`5NUN`"e03/903 -1-1-fSAMEKH]20207AYI3.3.&PE`4242,5,5,^VTSADIa6565 /7/7/6QOF\8-8-7RESK9.9.(SHKa.a.3TAV32076%fc-SUPERSCRIPT LATIN SMALL420aPESETA SIG'#21fBULLET OPERATOR#21&fbQUARE ROOT'eINFINITY$2veINTERSECTIO4fALMOST EQUAL TOS6f/{IDENTIC(fLESS-THAN ORYf+GREATER4#31aV0REVYD NOT#32-f,TOP HALF DGRAL$32-oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi#50"b(91VERb250cd7DOWN AND R=7b= 5LEFw#51c</UPwfd; uc%{2b fA 2o3c:B8@ a F5 oDOUBLE5bq: 0x2552: 0x`00d5, # BOX DRAWINGS DOWN SINGLE AND RIGHT DOUBLE 10x2553: 0x00d6E4EVE4E/c9Et>5>/b8> >LEF6D7DD 7DbD D8=/d4=/UP9C3C aCcK&UPb</ben< LcBdBBRdBcB?B;e;cVERTICALfIKIZ#60I PIB1Bb;G#62H ] -b H)/d1 HORIZONTALl65/d2JJ-;cJC:/cf A E0HJ/caHEGHdHLyG ZdRNdfcNG8dUPPER HALF BLOCK,?LOW,OLFULLRd+)}9RIGHT HALF B LOCK 0x2591: 0x00b0, # LIGHT SHADE'2'1'lMEDIUM(3(2(KDARK&"a0&%fe&TBLACK 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'):,acreturno.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='cp863',d!e=02(). id:.r=]/J //spr7=D #w##)Z~0MapA0codTmap =make_identity_dict(range(256)) 5.update({F8%c7LATIN CAPITAL LETTER C WITH CEDILLA?+fc?ESMAL=U=DIAERESIS?/e9? E?DACUT3008e zA;CIRCUMFLEX{4c@ B5Be;GGRAV6;%b6PILCROW SIGN7(e c8=ae"]"9@b@a: 0x00e8, # LATIN SMALL LETTER E WITH GRAVE 0x008b:0ef,;I;DIAERESIS?c?e?CIRCUMFLEX@d@E2017@DOUBLE LOW LINe+E00c0+eCAPITAA f=ahSECTION SIGN"90(/c9e LFACUT#91=8= #92=a=L"93B+f4B O@4@+cb@ a #95A L AN"96Af U7@ @ 8;a=CURRENCY"9)d)haBch h%a2AKCENT%a3%[POUND&<00d2  4d=s&19M FEHOOKa%a6BROKEN BAR&b0 AC2(}f-B;v  @ ;qa0aUb%vCEDILLA7bSUPERSCRIPT THREa$aVMACROa c a$6231REVERSED NOaa$%bdVULGAR FRAONE HALFbX4gQUARTE3b 7Q 9 aaEFT-POINTING ANGLE QUOTA7MAR&0bEORIGHF MARK 0x00b0: 0x2591, # LIGHT SHADE c0x00b1'2'lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGSVERTICAL47%24]7 AND LEFT@5@6 @qu SINGLEAg DOUBL 6HH8HX7H/56CDOWN|D8D5DxD9D6 / YaA5Y Ayb87x uc=d= %UPxd;c;/UPweBbBu fB/10Bc1  Rc3;HORIZONTc2; B1B m 0: z3zF/5eTfI ?IZIaI@5<z/69zM6 C6GB |6R|G 6(UPA Rd/68UBLE AND HORIZONTAL SINGLE 0x00d1: 0x2564, # BOX DRAWINGS DOWN4 AND HORJHDOUBJ2J5J4 J 3J/59J7UP HSRIGHT4C8CuCTC5C2C E6E3Ey7E/6bEVERTICAL N8NaN 8N9N1iL!UPGFLEFT:a:/0c:fy_=b=8wFULL BLOCK&c&LOWER HALF,d,+e+%90,f,8,?UPP e0,E03b1X GREEK SMALL LETTER ALPHAeE00df4ZLATIN4vSHARP S66039j@CAPI&lGGAMMl603c6 &PIg?03ag 8SIGgy<03c6 g 4h600b}MICRO SIGNI603c6TAU2-E03a6_2 )'PH60394GTHET]603a6GOMEG6?03b 8DELj521eINFINITY<03c  '03 2gEPSILO&22INTERSECTI(f6226BIDEN%TOfCPLUS-MINUS f62263GREATER-THAN OR EQUAL _'22.OLESS1623232TOP)FGRAL6232oBOTTOM0%f7pDIVISIOGN 0x00f7: 0x2248, # ALMOST EQUAL TO 0x00f8: %b0+DEGREE SIGN'9'E2219'BULLET OPERATOR+a+E00b7+MIDDLE DOT&b&E221a&SQUARE RO'c'607f'UPERSCRIPT LATIN SMALL LETTER d<O00b2<'TWe+625abBLACK f('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00'1 # 00 -> NULL!1!1!START OF HEADING-2-2-2TEXx3*3*0ENDU (4(4(RANSMISSIOxX5050UQUIRY6$6$ACKNOWLEDGE(7(w7 -> BE8!8!2ACKY2'\t$ c9&HORIZONT0ABUKn2a2LINE FEEDb(b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETURme.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 !"EXCLAMATION MAR"-LQUOT+#+fNUMBERL-'$(HOLLA(%(wPERCENTQ&) 0x0026 -> AMPERSAND "'"# 0x0027 -> APOSTROPHE'0'('#'8'LEFT PARENTHESIS-)-9-ORIGH.*.a.ASTERISKS+%b%PLUS SIGN&,&c&RCOMMA"-"d"HYPHEN-MINU.)e)FULL STOPO/&f&TSOLIDJ0$ 30$DIGIT ZEROK1'1'#ON2&2&#TWL3&3&3HREN4(4(BFOUR5'5'#IVN6'6'2SIXM7&qCSEVE8(r(EKP9(m($NI9:'fCCOLOq;"cGSEMI&<&cLESS-THAN=+lXEQUAL>(k|GREATERV?.sQUESTION MAR4@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33O33-P35'3Q30QR30wS30T30ATIN CAPITAL LETTER T 'U' # 0x0055 -> LATIN CAPITAL3U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1bc0REVERSE SOLIDUS\]+ ,d,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)1);ESMAL9AZb121B1c131C1d141D1e1 f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1% 1K1l1L1m11M1n11N1o1O1p17bP1q1Q1r1R1s1Pt1"u1 v1 w1 x1y1z1{1ZCURLY|/`VERTIC_|}*RZ~0CTILD\x7f' # 0x007f -> DELETE '\xc7' # 0x0080#LATIN CAPITAL LETTER C WITH CEDILLA@*fc@1@ESMAL>U>DIAERESIS@*e9@2@E@6ACU*e2<3<A<CIRCUMFLEX}cA4A C*e05C AEGRAV|*b6<6<PILCROW SIGNe7) e*eag8>c'*ebA9A 8@a@ $*ef<b<I|e@c@ Au201~!dADOUBLE LOW LINc e,P ah ySECTIONc49 6c9 > cM9> R9xf49OAc9 cV9 Xf fA aBCURRENCY+d* nd9 C nag9ICENT*a3YPOUND'd8y :d Au0199 FDHOOKaaBROKEN BAR'ba0 AC8)f3aTTER O WITH ACUTE '\xfa'  # 0x00a3 -> LATIN SMALL LETTER U WITH <*a8<4<DIAERESISbb&5&uCEDILLA$3J6$SUPERSCRIPT THRE*af.7.dMACRONQ*ce#8#eCAPITAICIRCUMFLEXCPu2310E9CREVERSED NOT SIGq ac, Ha. %*bd%b% VULGAR FRACTION ONE HALF+xbZc5uQUARTER8 d8X :*abe;LEFT-POINTING DOUBLE ANGLE QUOTAEMARK FfFORIGHGPu2591 b0GLGT SHAD(2(1(mMEDIUM)oQ2)LDARK'0PBOX DRAWINGS VERTICALXu25248P AND ]A61 As1 SIBI VIYI(56q ICDOWN~E5EE  E# ^B 979 wu>%UPAz< </UP}C C{ b C1c=&3<<HORIZONT@cAC1C   0Oc|3|y  G'\u255e' #< 0x00c6 -> BOX DRAWINGS VERTICAL SINGLE AND RIGHT DOUBLE '\u255f' # J7J9J[JaJ8JA&UPD=4=9=ODOWN?(69?a?|HORIZONTAL(66BbBD0DcD5CdC~c~e; ~H7HfH(UPVB ['68I/d0I I Z6-d1I5Ka`(652K5 KaK5t-d3K#UPI~ D #4D3D25D  F3FRF5(6bFN OSdS9O1neL"%FLEFT;0]da;%d>8y]FULL BLOCK' @LOWER HALF- *,9Vd-8-?UPPG03b1e GREEK SMALL LETTER ALPHA0xdf3teZLATIN5sSHARP S7Hu039eleCAPITAnDGAMMnHu03ce7 &PIiai2 i9SIGi 77 i5!xb xMICRO SIGNcx00e7 -> GRE-EK SMALL LETTER TAU '\u03a6' # 0x00e8 -> GREEK CAPITA56PHI5(98595VTHETA7(a97a7GOMEG7(b47b7 6DELlH221e5c5INFINITYcd% Z (b5Xe3tEPSILONj9222f7INTERSECTI)'61`!f0)DENTICAL TOR!xb' f1)PLUS-MINUS SIG~6 f2,GREATER-THAN OR EQUaHu226w f35OLESS2832042TOP HALF CGRALAu232z f5.oBOTTOM10xf7]61DIVISION4 f7*lALMOST!xbV DE T1fBULLET OPERATOR+xbMIDDLE DOT'Pu221aSQUARE RO(807f(SUPERSCRIPT LATIN0xb2;=$TWTAu25abBLACK x'UNO-BREAK SPACE ) ### Encoding Map e_map = {Qy100:000,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 0 FOUR 0x0015: 0x ,  # NEGATIVE ACKNOWLEDGE (6060SYNCHRONOUS 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'%25'{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 44y4y2Bd42C242442442F 0x0047: 0x`0047,  # LATIN CAPITAL LETTER G 0x0048: 2 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R23232 S24242 T25252 U26262 V272  W2 /58d 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`77 # LATIN SM ALL LETTER Q 0x0072:, # LATIN SM0R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKENc.c.VERTICAL LINEWd)d)ORIGHXe/e/GTILDPf!f!VDELET""a0"f"NO-BREAK SPAC*9CENT SIGNa9[POUND&9CURRENCY)W%a0BROKEN BA aM8{SECTIONNEaDIAERESI*aaTLEFT-POINTING DOUBLE ANGLE QUOTAjFMARKaO,NO+aVMACROMb'jDEGREE#b11%PLUS-MINUS+f`SUPERSCRIPT TWOba +6HREbaACUTE AC$UWeU[MICRO8&{PILCROW(ffMIDDLE DO}bvCEDILLAAwbVULGAR FRA ON3FARTEbaX7FHALFa 4T1 QUmcT8iPCAPITA WITH GRAVc?8A=CIRCUMFLEc8BC c9h?E? 9| =rc!%92ez 0x00cb: 0x00@94, # LATIN CAPITAL LETTER E WITH DIAERESIS -0x00ce: /a8A IACIRCUMFLEXBfB/95B#d4A9A O#d9BdB UBUGRAVE#db=e=#dcBaBC+e1AESMALfSHARP "e0w8y 6A#e2;3q ;#e7@7@ C{uCEDILLAq#e8= /  e/82x ;FACUT#eav v'8@eh/8c fe#/8b@"f3a9 b 9f, ;9f,%f6DIVISION SIGNf9U fa ; 9B ;8 @ #19%9fFJDHOOK/#39e\GREEKEGAMM}#39}e6FTHET6alg67SIGl"a6ues65PHIae4FOMEG#b1j0F6 GALPH4eR47DEL#b5h,4eEPSILO#3ce6Pco1SIGMA 0x03c4: 0x00e7,  # GREEK SMALL LETTER TAU c0x03c62d2 3PHI2B2017282DOUBLE LOW LINE+"7f+%fc]SUPERSCRIPT LATINN<3219<9<BULLET OPERATOR+a+b+SQUARE ROOT'e'eINFINITY$2v%efKINTERSECTIO"48LfiALMOST EQUAL TOS#61+0SkDENTIC(%f3(LESS-THAN ORY5Y21GREATER423104aV0REVD NOT SIG#32-%f4aTOP HALF DGRAL$325-oBOTTOM0#50]c] BOX DRAWINGS LIGHT HORIZONTi2502b(91VERb250c7'da pDOWN AND R=7bt=5LEFw#51c</UPwfd; uc%{2b fA 223/c1 8@  F5 :bq:l5d4aSINGLEw NE36=E4EVE@L45/b8r? bg ~#WN4DTb D=2UP oSd(UPCTcKINGS DOUBLE UP AND RIGHT 0x255b: 0x00be, # BOX DRAWINGS UP SINGLE<LEFT DOUBLEBcBdB2BRBdBcB?;e;/c6;VERTICAL fI7I JZ#60I IB1B/b5 GWH2H 8HXH3H9? "64A/d1A#WNGHORIZONTAL#65J2JYJ 6J/cbJ[ DOWN7CfC ;H8H/d0H2 3H9H/caHEGAaA/d8AL `NZdR fc} 8dUPPER HALF BLOCK,?LOW,OLFULLRd+)}991ALV SHAD9lMEDIUM(eKDARK&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'):,%creturno.charmap_B=,ing_map)m/dem-B mmatable)ss IncrementalEncoder(cs.Increment): def e, (self, input, final=False*.sreturn Ucharmap_@:F.errors,ing_map)[0] class DeM~d,'@XtableStreamWriter(Codec,8cs.Dpass0Rea9 92###ings module API getregentry(7 eQInfo(name='cp864',!e=02(). iJ:'r=w/J //spr7=D #w##0) IZping MapA0codTmap =make_identity_dict(range(256)) 5.update({F0x0025: 0x066a,k # ARABIC PERCENT SIGN/!80/50b0/kDEGREE'1'7'MIDDLE DOTM2&E2219&BULLET OPERATOR+3+SQUARE ROR4'5592RMEDIUM SHADEO6250FORMS LIGHT HORIZONTAL26Z0Z2hVERTIC070%3c0O ANDo8?/24?7LEFT99xODOWNta;1;?R(b:3!UP4Vc91 d505 e61 4f48 9!&3b(K SMALL BETA79&E221e_INFINITY$$E03c6$P6PHI+$E00b1+PLUS-OR-MINUS9+E00bd.FRACTION 1/2V+700bn(4(!&24,ALMOST EQUAL TO+E00ab{D POINTING GUILLEMET 0x0098:0bb, # RIGHT POINTING GUILLEME494Efef74ARABIC LIGATURE LAM WITH ALEF HAMZA ABOVE ISOLATED FORMaX8X%[FINALUrb: NoneS UNDEFINEDzc%d+ eGc?# G f a1iE00adiSOFT HYPHEN a2'Efe82'WETTERDMADD#a5J4J J67%3fe8n/8f?BEHa/95;T;bC/99;H<c<=060YVCOMMA9 OJEEM/a1/HAf?feaK< b0<K0660w-INDIC DIGIT ZEROb,66 36ONE2 <066  2'TWd33 GTHREf44 % fFFOURX<066: 3'IVf6f6 6SIXe72  e7SEV;b]<066 4EPhX<066 4(NIPd" LFbP=061SEMICOLO b@?febgOSEENbTb/SH=Ub=/ADxU=061QUESTION MARK 0x00c0: 0x0P0a2, # CENT SIGN 0x00c1: 0xfe80%ARABIC LETTER HAMZA ISOLATED FORM=2=1=ALEF WITH MADDA ABOVEM3M3MM 4M5M2WAWL5L/caLAIN FINAL68/8b8?YEHMNITIK7KdKi8<9_BEH Iv9: TEORBUT"aC7C}b:>/THc;fuOJEEMd;a/HA-e:K;f;9?DAL5#d0;&<aURadabZdbcOSEENdbd/SH<b*?SADvbD:c{TNbcZ;cdc/GH<E00a6BROKEN VERTICAL BAR;dE00ac/+NOd600fDIVISIONd|600d)MULTIPLICAT/pcpep=064/uTATWEELe^dF^e] ?QAFe[db, # AR!ABIC LETTER KAF INITIAL FORM 0x00e4: 0xfedf,h # AR:?LAM:5:/e3:?MEE;6;7;ONOONv7;b;?HEH:8:d:WAW ISOLATED%9;%ALEF MAKSURADaDf/Yb:b?DADuc;/cc~AIN MEDd9e9 GH;=FINQe::if=/e1wT"f0<7yoSHADDA f15=065q5H) f2*Ofee53<9<;e;f/f0t f/f2A8dyddQ(f;IGATURE QWITH  M_ABOVEBf6X#d"fdK#fvv625aBLACK SQUARE%cf: Non5 NUNDEFINED }) ### Decoding Table d _tA = (Pd'\x00'00 -> NULL!1!1!START OF HEADING-2-2-ETEXT*3*3*0ENDU (4(4(RANSMISSIONX5050UQUIRY$6$6$ACKNOWLEDGl7(7 -> BELL '\x008' # 0x0008 -> BACKSPACE 2'\t$$ &9&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 BLOCK 1eCANCEL#9YYeMEDIUM*a*SUBSTITUT 1  1ILE SEPARATOVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAMC MAR"-LQUOT+#+NUMBER SIGh$(HOLLA(Q\u0662ARABIC PERCENTX&XAMPERSAN0"'"VAPOSTROPH(MLEFT PARENTHESISm)-ORIGH.*.sASTERISx+%GPLUS,&RCOMMA-"HYPHEN-MINU.)FULL STOPO/&TSOLIDJE3DIGIT ZER?''96&&0-&{&'$({'zO3FIV$'q'2SIX3 &q&3EVE(r(EKP # 0x00 39 -> DIGIT NINE ':'# 0x003a'RCOLON";"b"GSEMI&<&c&LESS-THAN SIGQ=+d+gEQUALS(>(e(|GREATERV?.f.QUESTION MARK@* 40*COMMERCIAL AT*A*1*LATIN CAPITAL LETTER A3B323B3C333C3D343D3E353F363FfG373G3H383H3I3I3J33J3K33[L31LfM3fM3N33tO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30X3Y30Y3Z30Z3[30EFT SQUARE BRACKEb$\\1{5-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.EOW L+`%6YGRAVENa)LSMAL5b1 13c11R C 'd'  # 0x0064 -> LATIN SMALL LETTER D (0'e'151E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r121R1s131S1t1T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LIN^}*ORIGHZ~0CTILDR3\x77UDELET#"b0H#8DEGREE SIGBJ\xb7(MIDDLE DO`\u2219)OBULLET OPERATO,a,SQUARE ROT8592(MEDIUM SHAAu250}qFORMS LGHORIZONTA{\3 \31(3c1_ AND q(24@@6LEF[)52z:ODOWNv1<<@t ;!UP51: 06 '\u2514' # 0x008e -> FORMS LIGHT UP AND R '\u25185f5DLEFT4G03b24 904GREEK SMALL BETA-H221e-1-INFINITY%H03c6%2%R3PHI,0xb1* 93,PLUS-OR-MINUS SIGN/d/4/FRACTION 1/2)c)5)4)Hu2243 96)ALMOST EQUAL TO,:xabU7,L POINTING GUILLEME_+xb4845Pufef7k 995`ARABICATURE LAM WITH ALEF HAMZA ABOVE ISOLATED5Y aY ZFINALV)ffbVUNDEFINED| &c&!ef2d& H@H P 0xa0aBNON-BREAKSSPACE*xaaDSOFT HYPHEHufe8aGWETTERDMADD :xa3fIOUND^*a4'^CURRENCY*,^a_ *ufa d &{&(e8am0e8f rm?BEHU(95< U<T<9<; /TH=8060aR=SCOMMAsAufe9u UOJEEMa= J=/HAaAL<K=1066ZybX=-INDIC DIGIT ZERHu066b]4$ON3hbh g(TWfRPfHTHREh4b^ 5T FOUR '%\u0665' # 0x00b5 -> ARABIC-INDIC DIGIT FIVE '464647SIX37373GEVEN58585WEIGHT595955NINHfed14a4 LETTER FEH ISOLATED FORMp(1b<b<SEMICOLO9febic-iOSEENj9febd=H> e>/ADzH061ff<QUESTION MARK0xa2/V c01CENT SIG 80(| c1&|w_HAMZA8fe8L.c2>ALEF WITH MADDA ABOVEN33N N .c4N2WAWM(ca'AIN FINAL8fe8c9?YEHNNITILdLn$9fe9=B`x9; TEORBUT*9}cDI C/TH6c_JEEM xa?HAH; K<%c?DALBa+d /TH=_d Rg8feahd Z!bidbjdS= /S; D;c1' # 0x000d7 -> ARABIC LETTER TAH ISOLATED FORM '\ufec5' # 0x00d8 <Z<b<9xAIN INITIALwf;a;/GH=0xa6;b=BROKEN VERTICAL BAR:xac0c0NOT SIGN%*f7%d%DIVISION*d*e*MULTIPLICAT0c9\cf0 G0640<'e0<sTATWEELXufed3+1+?FEH.e2;?QAF;.e3;K;.e4;?LAMve5;?MEE<6<?NOOejHd(edi?WAWe*iLEF MAKSURAEf4sYbq ?DADwco} <?MED$e2 :$>FIN_ ;(e1y^8fe7{fSHADDA 8065sf6Hefef<f<8feffA'f2f9d{Edj-f< IGATURE QWITH  M"_ABOVEPfPfRABIC LIGATURE LAM WITH ALEF 2MADDA ABOVE FINAL FORM '\ufedd' # 0x00fb -> ARABIC LETTER TISOLATED<9<c<OKAF <(f1<d<?YEH<H25a0<e<BLACK SQUARE8ffe)f)UNDEFINED ) ### Encoding Map e_map = {L100:#000,<2FNULL 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 OUf%f%II1x1xDATA LINK ESCAPJ11DEVICE CONTROL ON.1 .5TWOP11 .7HRE^1 0FFOUR_1NEGATIVE z11SYNCHRONOUS IDL1Ff BLOCK1VCANCE11WRMEDIUd&11SUBSTITUT1 1ILE SEPARATON1_GROUP+1oRECORD,1OUNIT*22 22aEXCLAMF MAR22OQUOT*2NUMBER SIGT22LOLLA'd2dAMPERSANh2]2]APOSTROPH2N2NLEFT PARENTHESISz2X2XORIGH-02a: 0x002a, # ASTERISK 0x002b: , # PLUS SIGN%c%c%VCOMMA!d!d!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%6EVE#38'8'VEIGHTN9'9'(NI1a&a&GCOLOnS%3b!KSEMI%S3SLESS-THAN}3\3\[EQUAL3[3[GREATERTc3cQUESTION MAR4i4iERCIAL A<4l4lLATIN CAPITAL LETTER 44y4y2B442C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 24425525 5  Q5 5  Y5 5  5 5  5 5  U 5  V2 5  W2 5 TIN CAPITAL LETTER X 0x0059:, # LATIN CAPITAL 2Y2a2a2 Z2b2b2EFT SQUARE BRACKET/c/c/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(gESMALeAX2020 B03030 C04040 D05050 6060 F`7070 G08080 H0/690 I06 J06G 0K06L060M060N06O077`P07 Q07 R07 977  77 U7 V07 W07 77 77 77]CURLY77`VERTICp_77RX7FTILD77VDELET"aaNON-BREAKING SPAC.c.CF SIG\aa[POUND&aCURRENCY)[dkuBROKEN D&BAab: 0x0097,  # LEFT POINTING GUILLEMET 0x00ac:0dc,3NOT SIGN$d$%a1$SOFT HYPHE'"b0'%80'jDEGREEN"b1'%93'PLUS-OR-MINUS.7.8|MIDDLE DO"bb&%98TORIGH b%954FRACTION 1/4b/94(2(d%de(MULTIPLICAV Uf/d/PDIVIS)33b2WUK SMALL BETA33c6,2U,4PHI+#60aARABIC COMMS#61[%bbS(SEMICOLO261f,bf,AQUESEMARK42e\uTATWEEL*55f*uSHADDAH*6TbT-INDIC DIGIT ZERO3]b] 36ONE2bh 2'TWd327HREf44z4FFOUR533'IVf4+b6 6SIXe/b72 &EV3668Eh949h (NIa32y PERCEN3221b8BULLET OPERATOZ3221Z8SQUARE ROB221e9LINFINITY3224 9rLMOST EQUAL T732508pFORMS L* HORIZONTA*32508]2hVERTIC080DOWN AND P$51>658"5/UPi,8S4 ga73m2: s2s9E3t`;9tFORMS LIGHT VERTICAL AND HORIZONTAL 0x2592: 0x0084, # MEDIUM SHADE("a0(%fe(BLACK SQUAR(Cfe7d(0(aARABICP!DA^sAL FORM]3fe8],c15LETTER HAMZA ISOLATED=1r/c2=ALEF WITH MADDA ABOVEMaM=FIN33 4M/a5M5Jck2WAW-bL6?YEHLMNITI.7/c7Ke/a8<  f999?BEH(9ut;9u TEORBUT9/aaC,"97c; 9:/abuH.)< w/adwOJEEM/cc< waa '/HAa;ufK;a<wcw?DALbadN/TH<dRPadOZAINbb?SEE<d<ebb/SHxd=yRM 0xfeb9: 0x00be, # ARABIC LETTER SAD ISOLATED FORM 'b0xfebb;/d5; kNITIAL:d:/eb:Duf;/d6; u#c1:7:?TAH#c5;8;Z;`/df;?AINvavc`; FEHOOKa%e1K ad;  ;f;v ;D  ; N&FTILDad; =aFEMININE ORDINAL INDICATOR 0x00a7: 0x00ba, # MASCULINE ORDINAL INDICATOR #/#a87f7INVERTED QUESTION MARK292E23102REVERSED NOT SIGN-a-E00ac-$b$%bd$VULGAR FRACONE HALFXc4X4gQUARTEd7%a1kqEXCLAMAp e5b5LEFT-POINTING DOUBLE ANGLE QUOTEfE4ECURRENCY2 b0)6259LIGHT SHADE#b1'2PlMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS FICAL4727P AND :@5@6 @q1 SI\ArH6HHXHDE2556- CDOWN| DQO2555D c&56 qw?255YA8O2557yu6255%UP<x6255 ;/UPw6255 Bu '25 Bc1  Rc3;HORIZONTc2; B1B , 0:z3zF/5eT  I?IZI I@5<ND RIGHT  0x00ca: 0x2569, # BOX DRAWINGS DOUBLE UP AND HORIZONTAL -AbA6A ODOWNCcC0C VERTICALGVRIGHTdB5B e:/6c|GfG7GUP SINGLEA`#d0H8H ^H1H4H2J5J3J5k#UP$ 4CC5C2E6E3Ey7E/6bEI:8NaN 8NdN9N1iL6LEFdQ0Q: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 8DELj521e3INFINITYd: 0x03c6,  # GREEK SMALL LETTER PHI 0x00ee:@3b5,2vEPSILON6f6E22296INTERSECTI("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 LATINd<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 0x001b -> ESCAPE '\x1c' # 0x001c -> FILE SEPARATOR+d+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+%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-'E33F33FG33G3H33H3I33I3J33J3K33APITAL LETTER K 'L'# 0x004c -> LATIN CAPITAL LETTER L3M3d3M3N3e3N3O3f3O3P3/503P3Q313Q3R323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1-5-REVERSE SOLIDU]+ ,&ORIGH]^1$CIRCUMFLEX ACCEN_.rOW LINE`%6YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1!l1! 1m11n11o1p17bq1r1s1Pt1"u175 -> LATIN SMALL LETTER U 'v'# 0x0076 -> LATIN 1V1w171W1x181X1y191Y1z1a1Z1{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: d6' # 0x0(099 -> LATIN CAPITAL LETTER O WITH DIAERESIS '\xdc' # 0x009aBUB*f8BbBLSMALdSTROKE*a3=c=POUND SIGN'ddd' fPu20a7he?hPESETAgXu0192(f(g F DHOOK e19 H/a0;A;EACUT*ed<1<I<fA/a2< x*fax3< < 4<NETILDd<5< >a6> FEMININE ORDINAL INDICATORb777oMASCUL8 f%88INVERTED QUESTION MAR Pu23105oaREVERSED NOTu*xaa %b#eVULGAR FRACONE HALF Z]5eQUARTE+anqEXCLAMAr0xabeLEFT-POINTING DOUBLE ANGLE QUOTF4FCURRENCY8Au259fbrIGHT SHAn(b^mMEDIUM)MQKLDARK'0P6BOX DRAWINGS L"CICALAu252_28P AND @A67 As1 SIcByI BIYI 56T ICDOWN~E5EaE s E|# ^B 9]b9 wC>%UPAzc' # 0x00b6d -> BOX DRAWINGS UP DOUBLE AND LEFT SINGLE '\u255b' # 0x00be C3CSC(10CfLIGHT DOWND=4=/c0=!UP;RJ<3<1< HORIZONTALA(2c}2AC1C3CVERTICAL0?/c4B|3|5: |G(5e6GA ]P(5fJ7JCaJ8JA59=(69|a?|R(66BbBD cD 5CE~ [; ~H7 #UP B ['68Id( Id555?K*5tdG 95#I lDD2SF3FRF{dFW6dNc6SdSO1ne%{;0]da;%7>8ydb -> FULL BLOCK '\u2584' # 0x00dc -> LOWER HALF B-c-d-?EFT,(90,e,ORIGH-8-f-?UPPG03b1Z e0- GREEK SMALL LETTER ALPHA0xdf3 e15ZLATIN5sSHARP S7Pu03939 e27leCAPITAnDGAMMnHu03c&e37 &PIiai42 i9SIGi 757 i50xb5 65MICRO SIGNc e7' \6TAU3 a6\/83 'PH(98595GTHETd(a97a7GOMEG7bb7 6DELlH221el&INFINITYc0 0%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#ACKNOWLEDGEJx0007: 0x00007, # BELL 0x0008:  ACKSPACE%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, END OF TRANSMISSION BLOCK%18aVCANCE11WfMEDIUMK1SUBSTITUT1 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]'$NICx003a: 0x0030a, # COLON 0x003b: !KSEMI%c%c%LESS-THAN SIGOd*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 I2a2J2/4bd O4&Ld4M2 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# LATIN SMALL LETTER E 0x0066:, # LATIN SMA0F07070 G08080 H09090 I0a0a0 J0b0b0 K0c0c0 L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U0/760 V07 W07 X07 Y07 Z07EFT CURLY BRACKEN7VERTICAL LING77ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*a INED EXCLAMATION MARa9POUND SIGaaCURRENCY)ag FEMININE ORDINAL INDICATO-aa'LEFT-POINTING DOUBLE ANGLE QUOTa":NOTbMkDEGREE'JfPLUS-MINUS+fuSUPERSCRIPT TWbe[MICROQyfMIDDLE DObhPMASCUib$VULGAR FRAC ONbFARTEbaM76HALAbakAQUESm ce8PCAPITA WITH DIAERESID0x00c5: 0x00@8f, # LATIN CAPITAL LETTER A WITH RING ABOVE .0x00c6: /92BIGATURE A575/805wCwvCEDILLAt9?9? E?FACUT|"d1=/a5| N=GTILD=9= O=DIAERESIS"d8~/9dAWSTROKc>a> UfA+e1AESMALfSHARP "e0683 6$7GRAen ; #e2v3 vCIRCUMFLEXk#e4@4@#e5?6?e+ke7s eZ8 j P8; a&8 vb@ Q{8O ?I dza; e;/8c ;/8b@fT fT9  0"f3a% ; 0f9 ;0fK @0WfDIVISION SIGN2fC9 h fD9  ZDa ; Z?9 ; Z0x00fc: 0x00@81, # LATIN SMALL LETTER U WITH DIAERESIS +0x00ff: /98? Y?3192?f? F?DHOOKy2393:%e2:GREEK CAPITAVGAMMA68696 FTHET6al46 7SIGl#a6l5PHI#a94aj FOMEG#b1606 GALPH444b4 7DEL#b54e4 uEPSILON#c0636 Pco51 mc74 6TAUd2 3207%fc2SUPERSCRIPT7B20a79;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 2o3cB8@ aL AND HORIZO NTAL 0x2550: 0x00cd, # BOX DRAWINGS DOUBLE HORIZO:1:/ba: hVERTICr28/d58WN SINGLE AND RIGHT3E6EEVE4E/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,c, # LOWER HALF BLOCK 0x2588: 0x00db, # FULL&c&d&OLEFTQ#90+e+ORIGH,1,%b0,L,USHADE#92'1'{MEDIUM (3(2(KDARK&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 ~e!@OStreamWriter(J,8cs.5pasORead9 9Fs module API getregentry(7 UInfo(name='cp866',d!e=02(). id:.r=]/J //spr7=D #w##)Z~0MapA0codTmap =make_identity_dict(range(256)) 5.update({F8&41 CYRILLIC CAPITAL LETTER A5&415B2008&416V654136'GH74?4147qC0085656Il6666Z7777m?4186 TER I 0x0089: 0x0419, # CYRILLIC CAPITAL LETTER SHORT I 'c0x008a;a;&KA6b6b6&EL6c6c6M6d6d6N6e6e6O5f5f5%PE6"906/206&ER61616S62626T3636Uk4545&EF65656HP#96666'TS7777'CH78787Sf2fC9d2dHARD SIG9k2k7YERm2mKSOFTut2ts2sYt2tY1at3tESMAL3q3q 3B*ao3o 4V4m3m 4Gam3m 5Dik3k 4I4i3i 4Zg3g 5id3d 4a`3` 3 a`3` 9aW3W 4aS3S 4aJ3J 4aI3I4ETTER O 0x00af: 0x043f,  # CYRILLIC SMALL LETTER PE 4 b04E25914LIGHT SHAD'1'2'lMEDIUM(2(3(LDARK&3&0NBOX DRAWINGS VERTICAL47%24]7 AND LEFT@5@6 @qu SINGLEAg DOUBL 6HH8HX7H/56CDOWN|D8D5DxD9D6 / YaA5Y Ayb87x uc=d= %UPxd;c;/UPweBbBu O2510Bc1  Rc3;HORIZONTc2; B1B m 0: z3zF/5eT wI?IZIa@5<z/69zM6 C6NGB |6R|G 6(UPAL DOUBLE  0x00d0: 0x2568, !# BOX DRAWINGS UP DOUBLE AND HORIZONTAL SINGLE 4H1H4HCDOWN4 J`J2J5J4 J 3J/59J SRIGHT4CuCC5C2 E6E3Ey7E/6bEVERTICAL8NaN @9N1iL!UPGFLEFT:a:/0c:f_=b=8wFULL BLOCK&c&LOWER HALF,d,+e+%90,f,8,?UPPe6044, CYRILLIC SMALL LETTER EReE04414S460444T(e60444Ug6044~3&EF4u6044E4&HA4dO0446 'TSTO04475 'CH5;6044vS"60445C760447HARD SIGN60440;7YER-604460SOFpq<O044dM KDO044e3 YLO044f4 fT0 @CAPIV%IOBfV56 4V0 jUKRAINIAN Ifb5@SMALL LETTER UKRAINIAN IE 0x00f4:@407, # CYRILLIC CAPITAL LETTER YI65656OSMAL464/0ejvSHORT Uo7;5; o 98950b0tDEGREE SIGN`9'E2219'BULLET OPERATOR+a+600bMIDDLE DOT&b&E221aQSQUARE RO'c'5116'kNUMEROd'E00a4'CURRENCY)e)625abBLACK }f('00(NO-BREAK SPACE }) ### Decoding Table d _tA = (Ud'\x00'AX00 -> NULL!1!1!START OF HEADING-2-2-2TEXlx3*3*0ENDU (4(4(RANSMISSIOX5050UQUIRY6$6$ACKNOWLEDGfL7(w7 -> BE8!8!2ACKY2'\t$ c9&pHORIZONvTABULATn2a2LINE FEEDb(# 0b&VERTICAL V:x0c0c0HFORMVr$d&CARRIAGE RETURme.e,SHIFT OUf&f&IK11DATA LINK ESCAP11DEVICE CONTROL ON/ 1 /4TWOX11 /6HRE` 1 12FOUJ'\x11NEGATIVE 11SYNCHRONOUS IDL 1Z2e BLOCK 1UCANCE )191YeMEDIUMMa*SUBSTITUT 1  1ILE SEPAVdu_GROUP, 1oRECORD- 1LUNIT+  =2 !"aEXCLAM MARK '"'  # 0x0022 -> QUOTATION MARK '#'+3+NUMBER SIGN($(4(XDOLLA(%(5(wPERCENTQ&)6)AMPERSANDw0"'"7&POSTROPHE'-'(M8'LEFT PARENTHESIS-)-9-ORIGH.*.a.sASTERISF+%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?.sKQUESz@*4yERCIAL ATDA*|LATIN CAPITAL LETTER IB33BfC33C3D33-'E33F33FG33G3H33H3I33I3J33J3K33L31LfM3fM3N33O33-P35'3P 'Q'  # 0x0051 -> LATIN CAPITAL LETTER Q 'R'323R3S333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKEb$\\1c0REVERSE SOLIDU]+Zd,?IGH]^1e1CIRCUMFLEX ACCEN_.f.LOW LINE`% 60%YGRAVENa)ESMALAZb1 1B1c1 1C1d1 1D1e1 1f1 1Fbg1 1G1h1 1H1i1 1I1j1 1J1k1 1K1l1" 1L1m11M1n11N1o1O1p17bP1q1r1s1Pt1"u1 v1 w1 x1y1z1Z '{'  # 0x007b -> LEFT CURLY BRACKET '|'/c/VERTICAL LINE*}*d*ORIGHZ~0e0CTILDRB\x7f%|f"TDELET#Pu0410%# 80#CYRILLIC CAPITrETTER A\61616 Bm2727 V73737 (GH84848 65757 In6767 Z7878 o8787 I9696 hSHORT <a<a< K,b70b'ELc787M7d7E7N7e7L7O6b=`6P2t9t &ERn2u9u 'ES7u9u 2u9u Ums9s 'EF7s9s H[2s9s (TSs9s C2t9t Sv9v C:t9t HARD SIG2{9{ 8YER}9} LSOFTw9 9 Y9 Y;3azSMALL Lu0431' # &0x00a1 -> CYRILLIC SMALL LETTER BE '\u0432' # 525V53535(GH64646D55555I56565Z7676k8585It9494hSHORT :a:a:'KAob5b5'EL5c5c5M5d5d5N5e5e5O4f4f4PG25915 b05LIGHT SHAs8259bHmMEDIUM)b<LDARK'0P.BOX DRAWINGS uVERTICA82520b08 AND LEFT&9256< Asu SINGLEBg DOUBL:6PI9IY5bc ICDOWN~EbsEzE6 E #^5^B {5hb9 wdb>%UPzb </UP}Mb C{ (10 C1c=R3<<HORIZONT@cAC1C   0?c DRAWINGS LI+GHT HORIZONTAL '\u253c' # 0x00c5 -> BOX DRAWINGS LI:VERTICAL ANDG(5eG6GAaSINGLEHR[fDOUBLE(5fJ7J9J[JaJ8JA&UPD=4=9=ODOWN?(69?a?|(66BbBD0DcD CdC~ [e; ~H7fH2UP B '68I/d0I3 I_I-d1I5 KaK52K5 KaK5t-d3K#UPI9D #4DwDD2S  F3FRF5(6bFNB OSdS9O1ne}%FLEFT;0]da;%8y]FULL BLOCKe8@LOWER HALF- *,9VdY -?UPP8044-e CYRILLIC SMALL LETTER ERG0441&e5S5e5'TE5e5U4e4'EF55' # 0x00e5 &-> CYRILLIC SMALL LETTER HA '\u0446' # 0x00e6 57TSE67676(CH68686S9696 C8a8a8HARD SIGNb<b<GYERU7c7c7LSOFTsd<d<Qe4e4Yf5f5''015)f05eCAPITA^&IO5717 5(04l25 lUKRAINIAN I5A3A v?0)f4? 'YI 757 v50f lgSHORT 5< :0xb0`fiDEGREE8221{f{BULLET OPERATOR!xbToMIDDLE DOT'Hu221fZSQUARE RO((11fKhNUMERO!xaw7xURRENCY*Au25af-bBLACK x'S!NO-BREAK SPACE ) ### Encoding Map e_map = {QV100:^000,wmFNULL 1 1 START OF HEADING,2,2,2TEXiu3)3)0ENDS '4'4'RANSMISSIOV5/5/VQUIRY6#6#ACKNOWLEDGJ7'7'(BE8 8 2ACKGE9%9%pHORIZONyTABULATa1a1LINE FEEDb%b%VERTICAL Tc/c/KFORMTd%d%CARRIAGE RETURde+e+SHIFT OUf%f% IN 0x0010: 0x0010, # 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,f,f,OUNIT*22FSPAC22EXCLAMAT6MAR22OQUOT*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 44y4y # LATIN CA PITAL LETTER B 0x0043:, # LATIN CA2C24242 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 066SMALL LETTER L 0x006d:, # LATIN SMALL LETTER M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V07070 W08080 X09090 Y0a0a0 Z0b0b0EFT CURLY BRACKENc.c.VERTICAL LINEW%7d)ORIGHX7GTILDP7VDELET"af"NO-BREAK SPAC*CfCURRENCY SIG\bSkDEGREE'fsMIDDLE DO;#40IfyCYRILLIC CAPITCI$40O6UKRAINIAN I$40/@$YI#40f6eSHORT @#4148Ap18epB1k8V6q8ql'GH78I#41~8~m18Z8mZ86!185!;8.;K"86E}#4186#418 E-41e: 0x008e,  # CYRILLIC CAPITAL LETTER O 0x041f:@08f,5 %PE6"206/906&ER61616S62626T3636Uk4545&EF65656&HA66666'TS7777'CH78787S9797C9a9a9HARD SIGNb=b=7YERc8c8KSOFTud=d=We5e5Yt9tY13tatESMAL3qaq 3B3oao 4V4mam 4G3mam 5Dikak 4I4iai 4Zgag 5idad 4I3`a` 3gSHORT 9`a` 9KWaW 4&ELSaS 4M4JaJ 43IaI 43FaF 34DeD 4EeE E4EeE 4EeE I4CeC # CYRILLIC SMALL LETTER EF 0x0445:@0e5, # CYRILLIC4&HA46464 6TSE57575 'CH58585 S9595C7a7a7 HARD SIGNb;b; FYERU6c6c6 KSOFTqd;d; Ke3e3 Yf4f4 "514/f14 %IO #54434 UKRAINIAN I5Zf &YIrf dSHORT 3211fhNUMERO3221fBULLET OPERATOR3221xf=SQUARE ROOT'2500$%c4$BOX DRAWINGS LIGHT HORIZONTAL929b]9hVERTIC7d7DOWN AND Rt1b9= 6LEF1 /c0 /UPw/dv$; uc%{2b fA 22 o3cyt@G@ F5c FoDOUBLE9bq:l5d4aSINGLEw NE3%d #WN4EVEt 45br?b7, # BOX DR'AWINGS DOWN DOUBLE AND LEFT SINGLE 0x2557: 0x00bb, # BOX DRD?KD=8=/d4=#UPoSRIGHTC9C3CC aC/c8C@&UPb</be< AOBcBdB2~B dBcB?B}e;/c6;VERTICALfI7I  #60I I"61B/b5 GWH2H 8HXH3H9? "64A/d1A(WNHORIZONTAL-#65J2JYJ 6JcJ:/cf ;A E0HJ/caHEGHdHL1G ZdRNdfc G8dUPPER HALF BLOCK,?LOW,OLFULLRd+)}9o91ALkFSHAD9{MEDIUM (eKDARK&afTBLACK SQUARE } """ Python Character Mapping Codec generated from 'VENDORS/MICSFT/PC/CP869.TXT' with2c;P.py. c#" import codecs ### Codec APIs class (c!s.): def en(self,input,errors='strict'):,0preturn 1cs.charmap_B=,ing_map)m de<m)B mmdtable)IncrementalEr  h final=False*W.Q ?[0]D ~eL!@OStreamWriter(J,8cs.5pasORead9 92###ings module getregentry(7 UInfo(name='cp869',!e=02(). id:.r=]/J //spr7=D #w##0) IZping MapA0codTmap =make_identity_dict(range(256)) 5.update({F0x0080: 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"92D8OMICRON WITH TONOS 0x0093: None, # UNDEFINED%4% 5:R#38L# GREEK CAPITAL LETTER UPSILON WITH TO6C"abCDIALYTIKA7G50a9GCOPYRIGHT SIGN*8*538f*_OMEGA9A50b2ASUPERSCRIPT TWOla+3+FHREE-b-53ac-ESMALKOALPHc?&0al[POUNDd&?3ade EeA  /ETf= | =/IO>"a0>/ca >&"a1B/90BK AND"a2Lc _OMICR#a3A ;"a4A+91 ~3ga9g 66BET_a9]5GGAMM6?394 8DELl/956 ?3968 Z?3975 4&0b VULGAR FRACTION ONE HALF?398h )THj9wk0RLEFT-POINTING DOUBLE ANGLE QUOTAFMARKE&0bLFb'25L6HADb'25MEDIUM S(s'25LDARK&X6250BOX DRAWINGS VERTICALbN62527W@X  XFKAPP#bYhGLAMD6Y | lR MU 0x00b8: 0x039d,  # GREEK CAPITAL LETTER NU `0x00b93E25633BOX DRAWINGS DOUBLE VERTICAL AND LEFTAaA/51A8b878 ODOWNuc=/UP;d;E039ex$&XIe3f3 vOMICRON8f8E25108 oLIGHT #c0<4< RIw"c1;3;HORIZONTAL@2@/2c{ B3B1B T 4A0: z593zF6F603a$P$#c7336RHOiO255ai|5< `/69z"/66A C6e & ?255B |?256'|G603a=USIGMAd603a6&TAdE03a5p4WUPSILd603a8&PHd603a4C4O03a8 'PSh603ahGOMEG>biESMALGALPH4+b2 47BET3<03b 38GAM1  Ed0:Nx00db: 0x25808, # FULL BLOCK 0x00dc: 0x2584&LOWER HALF,d,603b, GREEK SMALL LETTER DELTA`e45`4vEPSILON6f6E25806?UPP e0,E03b6,b'ZE#e1373 222Me)TH4349f (IO43a3 FKAPPb#e54b4 GLAMD464c4 %MU#e71d1 N181e1 &XIb91f1 WOMICR)"ea6c)Pgb11g 6RHO"O03c32 GSIGM`*/c24 kFINAL :0cd 'TAj,'03UTONOSf'&0aSOFT HYPHEzf&0b PLUS-MINUS+c Ufc &PHfc C2&0a2{SECTIONc 'PS8DIALYTIKA w&0b DE &0aDIAERESIQ FOMEGf e WITH < EL AND  S#625aSBLACK SQUARE0(NO-BREAK SPACE }) ### Decoding Table d _tA = (U`'\x00':@ # >00 -> NULL!1!1!START OF HEADING-2-2-ETEXT*3*3*0ENDU (4(# 0x0004 -> END OF TRANSMISSION '\x05'  # 0x0005 -> ENQUIRY$6$6$ACKNOWLEDGE(7(7 -> BELL!8!8!tACKSPACGt$ 9&HORIZONTAL TABULATn2a2LINE FEED~b(b&oVERTICV:x0c0c0HFORMVr$d&CARRIAGE RETURme.e,SHIFT OUTf&f&IK)10% 10%DATA LINK ESCAPR:x11-1-EVICE CONTROL ON/2/2/4TWO*13/3/6HRE`4141EFOURa 1NEGATIVE 11SYNCHRONOUS IDL 12e BLOCK 1UCANCE*19YeMEDIUMMa*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& (t'sOFIVE '6'  # 0x0036 -> DIGIT SIX 0'7'&7&BEVEN(8(8(REIGHT(9(9(BNINE':'a'CCOLOq;"b"GSEMI&<&c&LESS-THAN SIGQ=+d+gEQUALS(>(e(|GREATERV?.f.QUESTION MARK@* 40*COMMERCIAL ADA*1*LATIN CAPITAL LETTER A]B323B3C333C3D343D3E353F3FfG33G3H33H3I33I3J33J3K33[L31LfM3fM3N33tO33OfP35'3P3Q30Q3R30R3S30S3T30U30UfV30V3W30W3X30\Y30YfZ30Z3[30EFT SQUARE BRACKEb$\\15-REVERSE SOLIDU]+ ,&R]^1$CIRCUMFLEX ACCEN_.EOW L+`%6YGRAVENa) # 0x0061 -> LATIN SMALL LETTER A 'b'# 0x00621B1c131C1d141D1e151E1f161F1g171G1h181H1i191I1j1a1J1k1b1K1l1c1L1m1d1M1n1e1N1o1f1O1p1/701P1q111Q1r1R1s1S1t1T1u1U1v1V1w1W1x1X1y1Y1z1Z1{1EFT CURLY BRACKEU|/VERTICAL LIN^}*ORIGHZ~0CTILDR3\x7t7TDELET#Aufff #8UNDEFINE*\&&&&& &@0386.GREEK CAPITLPHA WITH TONOK h0xb7f$ hMIDDLE DO3\xa'sNOT SIG1\xaLBROKEN BA`\u2018uLSINGLE QUOTATION MAR797k8 8038o8d -> GREEK 6CAPITAL LETTER EPSILON WITH TONOS '\u2015' # 0x008e -> HORIZONA4BAR+H0389+f+lGREEK o/TAkG038a@/90@/IOAaA1ADIALYTIKAc2E_OMICR5HfffeD3DUNDEFINEDj &4&9038L5&VUH03ab6D !xa  97HCOPYRIGHT SIGNH038fs8+OOMEG0xb2@m9BSUPERSCRIPT TWOn:xb3,a,CHREE.Iu03ab.ESMALOALPHanc@[POUND ad; 9d'g}H03aeB}B  NcNa? 0Wu0390aC J AND803ca M803caOI (91B <q9 aGBETA6i6HGAMM749DELna6ppZ7665!xba VULGAR FRACTION ONE HALF8jj&THl~ @mxhLEFT-POINTING DOUBLE ANGLE QUOTADMARKFbFdG9u25b0 -> LIGHT SHADE '\u2592' # 0x00b1 -> MEDIUM )3)2)LDARK'0P3' BOX DRAWINGS LIGHT VERTICAL(24_48 AND LEFTAH039aA5A GREEK CAPITAL LETTER KAPPA7b767HLAMD7c777'MUkd484N49256v94 OeDOUBLEP H2551vaB H25579b9ODOWNw c>-UP<H039ezd<$XIH039f4e4tOMICRON9H25109f9 b1/c0=Ry3<zy<HORIZONT3cAC1C  0?c|3|*|G903aP-ac6RHO5ac  '5 ?'69c|'H2566BD k  5CE~ 0; ~H803aSc^GSIGMad7%TAG03a5vd5VUPSIL803ad9(PHd5CAPITAL LETT+ER CHI '\u03a8' # 0x00d4 -> GREEK CAPITAL LETTER PS59555VOMEGAl(b1767ESMALjHALPH525758BET43484EGAMM59251 95BOX DRAWINGS LIGHT UP AND LEFTH250cpa;ADOWN=RJ>8yb>FULL BLOCK'4ec'LOWER HALF-903b-d- k9DEL75be5wEPSILON07f7?UPP6- e0-Z7414 3T/e23*TH5/e35)IO4a@ iEKAPPkH03bb5@ 5HLAMD5ee>$MUH03bdg;N2e29X (bf26VOMICR4803c4e27Pic=e&26RHOce236SIG803cpe:lFINAL ;ue@'TAq83<STONOS!xaf7SOFT HYPHExa(+PLUS-MINUS,Hu03cf$U803cf&Pecf%!xa1#|SECTIONf 8DIALYTIKA b DExL(DIAERESIyhf =c4fd WITH A '\u03bB0' # 0x00fc -> GREEK SMALL LETTER UPSILON WITH DIALYTIKA AND TONOS '\u03cePdPROMEGANT@925ae@BLACK SQUAREix'f)NO-BREAK SPACE ) ### Encoding Map e_map = {Q100:@00, v# NULL 1 1 START OF HEADING,2,2,FTEXT)3)3)0ENDS '4'4'RANSMISSIONV5/5/VQUIRY#6#6#ACKNOWLEDGf7'7'(BE8 8 2ACKFE9%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-2wASTERISh2b, # PLUS SIGN 0x002c:, # COMMA!d!d!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%6EVE#38'8'VEIGHTN9'9'(NI1a&a&GCOLOnb!b!KSEMI%S%3c%LESS-THAN}3\3\[EQUAL3[3[GREATERTc3cQUESTION MARK4i4iERCIAL A<4l4lLATIN CAPITAL LETTER 44y4y2B42C242D242442Fd42G242H242I242J242O4&Ld4dM2 4 24425525 5  Q5 5  Y5 5  5 5  5 5  U 5  V2 5  W2 5  :5 5  LATIN CAPI TAL LETTER Y 0x005a:, # LATIN CAPI2Z2b2b2EFT SQUARE BRACKET/c/c/REVERSE SOLIDUS+d+d+?IGH[e0e0CIRCUMFLEX ACCENf-f-LOW LINE"60$%60$\GRAVEL#61(1(5ESMALeAX2020 B03030 C04040 D05050 6060 F`7070 G08080 H09090 I0/6a0 J06 K06L060M060N06O077`P07 Q07 R07 977  77 U7 V07 W07 X07 77 77]CURLY77`VERTICp_77RX7FTILD77VDELET"af"NO-BREAK SPAC*s9POUND SIGYa 8IBROKEN BAaf_{SECTIONNfDIAERESIa9LBCOPY9 a0LEFT-POINTING DOUBLE ANGLE QUOTATION MARK 0x00ac:089, # NOT SIGN$d$%f0$SOFT HYPHE'#b0'8'jDEGREEN#b1'1'PLUS-MINUS+2+9SUPERSCRIPT TWO#b3+aV +FHREE-7-8MIDDLE DOT&b&%afSRIGHT-POINTINGab=%abFVULGAR FRACONE HALFz2384zezHvK TONOS'5'%f7['DIALYTIKA161+861 CAPITAL LETTER ALPHA WITHA8AdA EPSILONC9C /ETa?9 ?/IO@/92 _OMICRe5C UfCOOMEG9laEAESMAL;AND9/a4 }9a FBETA5a GGAMM6a 8DELlad %au[ nZRa5 4M/acx )TH6@a 6b GKAPPxb GLAMD6bb &MU$b N3b &XIfu/bep 8alc PkaSc %RH#3ac 7SIGad # GREEK CA PITAL LETTER TAU 0x03a5:@0d1, # GREEK CA4vUPSILON86828 6PHI47434 C48444 'PSh9454 VOMEGAa69  IOTA WITH DIALYTIKDbD6z NGcGbGESMALCALPHVTONOSd?d? E AeAeA  =f=f= F >"b0>/fc> @[ AND O1OdJ?#b247 6BET#b3383 GGAMM444 8DELh /e0 Ze  8 2e 2)TH4e 4+e 3GKAPPje 4GLAMD4e9 MIbue6 N1ee4 XbY/e9 WOMICRcQ/ea6 Pgc3e} 5RHOc1e FINAL SIGc8e 48e c6f T6f c5f c5ff c3f  0x03ca: 0x00a0, # GREEK SMALL LETTER IOTA WITH DIALYTIKA .q0x03cb:B/fbB UPSILONEcE/a2E TOMICREVTONOSdA3A AeA/fdA COMEG ?B2015?%8e?HORIZONTAL BARC2018*0 LEFT SINGLE QUOTATION MARK696c`ORIGH7 25007%c47BOX DRAWINGS LDp25029bP9VERTICAL7/dap DOWN AND =1/bf=6<4c/UPw/d9w ; uc%{2b fA 27o3/c1@5@ F5c} DOUBLE :1bq:058; #57v> "5a=/c83{q yby< w6d; *m }"63b4 B 6Ac76c AB G8NdUPPER HALF BLOC#58ldz?LOW,#KFULLR9USHADE9MEDIUM SHADE 0x2593: 0x00b2, # DARK SHADE b0x25a0&%fe&hBLACK SQUARE } """ Python Character Mapping Codec cp874 generated from 'MAPPINGS/VENDORS/MICSFT/WINDOWS/CP874.TXT' with@cOP.py. w#" import cs ###tAPIs class($.1): `def en(self,input,errors='strict'):,creturno.charmap_B=,ing_table)o/deo-B ooIncrementalEr  h final=False*Y.S 4[0]D"e!@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 &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDG7&w7 -> BE88tACKSPACCt" Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUf$F$IG1h 10#DATA LINK ESCAPB(x1t1tDEVICE CONTROL ON-v1vDEVICE 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$3T$&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+'E11 E 'F'  # 0x46 -> LATIN CAPITAL LETTER F '0'G'171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V1V1W1W1X1X1Y1Y1Z1Z1[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/ # 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 TDELET!Pu20ac#! 80!EURO SIGNf\ufffe$1$UNDEFINED$$ $  $F2026HORIZONTAL ELLIPSI  R $ {$ p$ e$ Z$ Q$ M$ C$ G$ 9J $E20189JL2SINGLE QUOTATION MARK[F20195[6 9mkODOUBk dk~k6 &226DBULLf\u2013!wEN DASH4")EM" 999999990xa0@! ANO-BREAK SPAC@0e01+)THAI CHARACdKO KAI60e0A 0YHO KH2A{THAI CHARACTER $KHO KHUAT '\u0e04' # 0xA4 -> THAI CHARACTER 37WAI35353'ON26262wRAKHANG57575wNGO NGU181810CHO9292Ia3A3 b3B3WSO SOc/C/'OE2d2D2JYO Ye1E1D)'DAcf2F2TO PATAK2%102/B02 HOl&11212NANGMONTH1&12828hPHUTHA53535XNO NE(B(XDO DE%B%ITO T#B#T/U1!B!38AHA$B$4Og%B%*1!B!xBO BAIMQ1!B!WPO PL1"B"jPHO PH,#B#HFO Fb!B!b Y!B!a2CbISAMP2"C"GMO M2C2CXRO RU`CR2CILO L2CL] C XWO WA2CAs2CSS%2Cb LCfHO HIP_2CLULA '\u0e2d' # 0xCD -> THAI CHARACTER O ANG '\u0e2e'/E/HO NOKHUK3f3F3PAIYANNOI3%303/D03gSARA A01010MAI HAN-AKAT62626fg3131Mb4141505016161'UE717128282b9090U1a1A1ePHINTH16fff DB1UNDEFINEDU $C$H  $60e3DURRENCY SYMBOL BAH|4E4E1EO160e4EI MAIMUAN9EA97ALA4ELAKKHANGYAEMN'MO4EvMAITAIKb60e4EPEcE0(THE1R,b%E 1wCHATTAW&4c6 6THANTHAKH&4d5 5xNIKHAHIE% 2iYAMAKK53E3vXFONGM150F0DIGIT ZER[5*F**'ON"5"F")(TWRF)8HRET F +FFOUR75F*(IVTF*7SIXSF)7EVE58' # 0xF8 -> THAI DIGIT EIGHT '\u0e59' # 0xF9+GNINE*a*A*CHARACTER ANGKHANKHU4b4B4UKHOMUFfffe0C0UNDEFINEDT $D$E$F$) ### 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'):,PcreturnoB=,4ing&Co?o*B ooIncremental$er h final=False*Y.S 4[0]Da(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(aname='%',d!e=02(). if:'r=y/J //spr7=D #w##") [T ~2 = 'P'\x005 00;ANULL011START OF HEADING+2+2+4TEX8x03(3(0ENDQ&(9c&4&dCONTROt 5"HORIZONTAL TABULATION"862 060 R8x7f"7"TDELET88x97!8! C(8d" "| "0h"B -> 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-5HRE\(9d/4/Q(85"5"(08"6"BACKSPACh(87$7$ h1F8"TANCEL(19C9!END OF MEDIUM(9/A( k8/1B"1`1`ILE SEPARATORm1@e_GROUP*e1eoRECORD+ lNUNIT)8r2r i2i "/2^ "S2S "42Fn 2FHLINE(x1$2HTRANSMISSION BLOCKbZ2X j8W2WcC8X2X aeR R8R2R f0i2KtENQUIRY(06CACKNOWLEDGk0G>5BELG94349434134SYNCHRONOUS IDL9=3=9=3=(x93= <9; "0f)>]j963696369636963616D(6FOU (BNEGATIVE )93O 51KSUBSTITUT  4Q2u03Q4O GREEK CAPITAL LETTER ALPHAu0392' # 0x'42 -> GREEK CAPITAL LETTER BETA '\u0393' # 0x434HGAMM545459DELj5555wEPSILON6767Z7474 38383*TH59595$IO[/{qA4LEFT SQUARE BRACKET..B.FULL STOP$<$C$LESS-THAN SIGK()D)FT PARENTHESIST++E+GPLUSO!$F$EXCLAMATION MARKO&+ 50+AMPERSAND$a) 51$HKAPPb5HLAMD5c5'MUd2N2e2'XIdf2XOMICR &a07Pi&a126RHOa&54SIG&]c5ORIGH$/gDOLLARu*&sASTERISm)#x ;,eSEMICO^$CIRCUMFLEX ACCEN-,6HYPHEN-MINU_/'TSOLID"ac6'TAsaa6Uaaa6(PHB`6C3`6(PSf^6GOMEGaF6 WITH DIALYTIKCT6HF|`VERTIC2INE[,(%COl% 0PERt_' # 0x6D -> LOW LINE '>' # 0x6E -> GREATER-THAN SIGN,?,F,QUESTION MARK(B\xa8+T 70(DIAERESIS$Pu0386&$1$GREEK CAPITAL LETTER ALPHA WITH TONO@f@2@EPSILONB93BT0xa0<" 4>NO-BREAK SPACa\a+)5)/IOh?c?6?_OMICReB7BU* fB8BNOMEG,`;c,9@AVE ACCENT:'A'CCOLO# B gNUMBER@&C&COMMERCIAL An1"'" D(APOSTROPH=MgEQUALSs"&9  DE4Xj9Jk/l/L^m/M/n/o/O^p/P/'q' # 0x98 -> LATIN SMALL LETTER Q 'r'#/9/R/`\u03b74/A/ZGREEK^7ETA181B1*TH393C3)IOea2D2HKAPPb3E3HLAMD3c3F3#MU0xb4.! , A00ACUTE ACCENT'~$ '1'RTILDE s 2 S/t/3/~u/4/v/5/Vw/6/W/x/7/X/y/Y/z/Z/d4N0e0'XI`f0vOMICRON5&c05Pe&c107RHOa31DSIGM!xa1BPOUND SIGa=B9ALPHA WITH TONO\aB>EPSILON@B@T|c]B"<yDIALYTIK Fu03aB4A c8B=& @:S@U:c(Bd@ c~yDOOMEG2BPFINALrAu03cB'TA&c5j,165HCBC1CBPSI '{'  # 0xC0 -> LEFT CURLY BRACKET 'A'-1-ATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1B\xad4A1SOFT HYPHEN&Pu03c9(&B&GREEK SMALCOMEGf\u03903C3IOTA WITH DIALYTIKA AND TONOS~bKDKUPSILONNF2018ENSINGLE QUOTATION MARKF20155F5pHORIZON2BAR)}$6D6ORIGH7J.7J_K17L17LbM17M1N17MO17ObP17P1Q17Q1R17B\xb14D7PLUS-MINUS SIG8\xbaD;VULGAR FRACisONE HAL'H\x1a];SUBSTITUT}` 87'ANO TELEI6201D 0xa6_DuBROKEN "\\#%EEVERSE SOLIDU E SN>EVT1U1UV1V1W1W1X1X1Y1Y1Z1Z1\xb2' #  0xEA -> SUPERSCRIPT TWO '\xa7' 0 # *B*ECTION SIGN'(1a'C'UBSTITUTE%D%(abJE%LEFT-POINTING DOUBLE ANGLE QUOTADMARKi(acDFD7NOT0 " F0#DIGIT ZER1%1%#ON2$2$E3$3$3HREJ4&4&BFOUR5%5%#IVJ6%6%2SIXI7$3EVE8J8&REIGHTL9&9&$NI)3\xbJFt 3\xaT,vPCOPYRu)\xxFxFxbxFxoy"9f yCONTROL ) ### Encoding table e_ =codecs.charmap_build(de3$ ) # # cp932.py: Python Uni= CB for CP932-*Written by Hye-Shik Chang # import _Rrcs_jp, multibytec as mbc &' =:A.get!('') class(!s.!):Q2e =t. PIncrementaleer(mbc.M ,U 4 D 4 StreamReader(T,!.^N^ ! ^^def getregentry(&breturn"UInfo(Sname=WJ0=#()?5iFI.r=/J //sr=w #cwriter#<#/49/49ik Chang # import _codecs_kr, multibyte as mbc =:A.get('cp949') class C](!s. ): en" =t.doPIncrementalEBtr(mbc.M ,Us >cs.4 D 4 StreamReader(T,!.^OWrit^ ! ^^def getregentry(&breturn"UInfo(Sname=WJ0=#()?5iFI.r=/J //sr=w #we#<# ) # # cp950.py: Python UniU for CP950-? ten by Hye-Shik Chang # import _codecs_jp, multibyte as mbc =:A.get ('euc_jis_2004') class Cd(#!s. ): en" ={.dvPIncrementalEBtr(mbc.M ,Us >cs.4 D 4 StreamReader(T,!.^OWrit^ ! ^^def getregentry(&breturn"UInfo(Zname=^Q7=#()F<iMI.r= /J //sr=~ #wl#C#c) # # Yx0213.py: Python Unic for EUC_JISX*;Mten by Hye-ShjH^9p.py: Python UnicDode Codec for EUC_JP # # Written by Hye-Shik Chang # import _cNqs_jp, c multibyte as mbc &= :A.get('euc_jp') class(!s.): en" =u.dpPIncrementalEBtr(mbc.M ,Us >cs.4 D 4 StreamReader(T,!.^O^ ! ^^def getregentry(&breturn"UInfo(Tname=XK1=#()@6iGI.r=/J //sr=x #cwriter#=#)Mkr.py: Python UniW!KR/A)$kr+kr/krE2kr'!gb18030.py: PythLon Unicode Codec for GB18030 # # Written by Hye-Shik Chang # import _cO`s_cn, _%csmultibyte as mbc &= :A.getA('gb') class(!s.): en" =v.dqPIncrementalEBtr(mbc.M ,Us >cs.4 D 4 StreamReader(T,!.^P^ ! ^^def getregentry(&breturn"UInfo(Uname=YL2=#()A7iHI.r=/J //sr=y #cwriter#>#)gb2312.py: Pyth$/ArCX!) # # gbk.pyN: Python Unicode Codec for GBK # # Written by Hye-Shik Chang # import _cK`s_cn, [%csmultibyte as mbc &= :A.get('gbk') class(!s.): en" =r.dmPIncrementalEBtr(mbc.M ,Us >cs.4 D 4 StreamReader(T,!.^L^ ! ^^def getregentry(&breturn"UInfo(Qname=UH.=#()=3iDI.r=/J //sr=u #cwriter#:#S) """B'hexf'L - 2-digit hex content transferXing. ThisYB de/ps from Bs to 0. < Marc-Andre Lemburg (mal@l `.com). '(5binascii ###`APIs (input, errors='strict'cassertD == 6(l.b2a_hexTc), len )xx4?a2bx  oself,  D)WW9 &final=False*. ': 3*wcodecs.Strea2mWriter): charbuffertype = bytes class StreamReader(Codec, c(s.L ### encodings module API def getregentry(IdreturnjxQInfo(name='hex',bbe=hex_ Rdecod incremental66r=IE/er/J /Dh/s@wq=2~R#rc#p#_is_texting=False!) """ Python Character Mapping = generated from 'hp_roman8.txt' with$&ac.py. VBased on data:ftp://dkuug.dk/i18n/Cmaps/HP-ROMAN8 (Keld Simonsen)OOriginal source: LaserJet IIP Prin User's Manual HP part no33471-90901, Hewlet-Packard, June 1989 (Upermissio"""#" importe -5API(!s. "):2 (self,input,errors='strict' 4(e(=,Ving_table=oro)B ooe h f*Y.S 4[0](@QO[5pas9 9u="p-;{ 1().w$e=") CTT2 = `'\x00' # 0x00 -> NULL11START OF HEADING+2+2+ETEXT(3(3(0ENDQ& '\x04'  # 0x04 -> END OF TRANSMISSION '\x05' .5.UQUIRY"6"6"ACKNOWLEDGE&7&7 -> BELL88tACKSPACCt"9$HORIZONTAL TABULATn0A0LINE FEEDxb& B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUR[e,|E*SHIFT OUTf$F$IG'10# 10#DATA LINK ESCAPB8x11+1+EVICE CONTROL ON-2-2-4TWO(13-3-6HRE\4/DEFOUR]1NEGATIVE k11SYNCHRONOUS IDL1 e BLOCK1UCANCE(19UeMEDIUMIa(SUBSTITUT1 1ILE SEPARATOFdo_GROUP*1oRECORD+1LUNIT) {v2! aEXCLAMC MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSANt1"'"P uAPOSTROPH(IfLEFT PARENTHESISH)+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDFP3[DIGIT ZER%`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE8' # 0x 38 -> DIGIT EIGHT '9'v# 0x39&BNINE%:%A%RCOLON ; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK@( 40(COMMERCIAL A4A(1(LATIN CAPITAL LETTER AYB121B1C131C1D141D1E151F161FbG171G1H1WH1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/\5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa'LSMALb/ /c/ /d//ER D 'e' # 0x65 -> LATIN SMALL LETTER E '0'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/4/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$c$G$d$C$e$9$=8= $9@9@9@9@9@9@9@9@9@9@9@9@9@96 -> '\x97'  # 0x97 -> ` < d1\B\Nz f<W x:a:Q INVERTED EXCLAMATION MARKb^4MQUES149CURRENCY}(a3%ZPOUND%5%&:YEN# #1SECAu019B 6Fp5HOOa7~ e$Ck SMALL LETTER A WITH CIRCUMFLEX '\xea'  # 0xC1 -> LATIN SMALL LETTER E?(f4?2?O?b?3?U?(e1?4?UACUTE9:5: :(f3:6: : k7: :(e0t8:FGRAV8:9: :(f2:A: : \B: :eNC:DIAERESIS MD> >(f6E>>c>F> >'c5>&D0>eCAPITARING ABOeAIHd&D USTROKcc9D =A2e d Hf ecD  eQD Ed z zdz @D @ (ef >SHARP S (GERMAN)?d 8KcE cVE }FTILDO <IN SMALL LET TER A WITH TILDE '\xd0'  # 0xE3 -> LATIN CAPITAL LET<ETH (ICELANDIC)?f?4?OSMAL= (cd|5= |IEACUT(cc<6< EGRAV<(d3<7<Ox(d2<8< x5<9< f<A< i:Au016B: fSSCARON<1<C< v:0xda8 XD: vUvPu0178>vE<Y<DIAERESIS0xff>|F@ >'de>&F0> _THORN A1A ?(b72?MIDDLE DOTbFMICRO SIG8xb6JzPILCROW' VULGAR FRACTION THREE QUARTERhPu2014bFuEM DASHFj [%ONY6Fd6DHALF3aoF[FEMININE ORDINAL IDATOR5b5ToMASCUL6 ab^FP EFT-POINTING DOUBLE ANGL1OTADCMARKzFu25aFXpBLACK SdbkEORIGHl!xbNPLUS-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 = codec class IncrementalDecoder(mbc.Multibyte ?, @>cs.4!):5 1 = @ clStreamRea|yCodec, !,<(s.^Writer(^! ^^def getregentry(&dreturnpQInfo(7name='hz'G en=-2().di:'r=E\r/J //sr=t #wb#9#) # This module implq s the RFCs 3490 (IDNA) and 1 (Nameprep) import stringD, re from uniG@datad/ucd_3_2_0 as @ # m$ section 3.1 dots = re.compile("[\u002E\u3002\uFF0E]61]")D 5 ace_prefix = b"xn--" sassumes querys, so AllowUnassigned is true wCc(labelyQ# Mapf1newQ = []for c in #iftN.in_table_b1(cV&^ to nothingWcontinue.append(D.mapfQ2(c))4 = "".join(@!) # Normalizc/$.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 "c0ere"a /Ry. Must perform furtherE|# tests^a1) TheSsY5.8 MUST be p;ed.Xn1 C.8, which was already checWked '# 2) If a string contains any RandALCat character, the- JMUST NOTDC >.3 if#(zprep.in_table_d2(x) for x in label):>'raise UnicodeError("Violation of BIDI requirement 2") G?# 3aA' !be.GfirsC;theE, and az SKlastA` s3not_w[0] or ?-1]e13eSretur def ToASCII(6tryv# Step 1: try -5" =0.en("ascii")&iexcept[Bpass&6lse# Skip to sz3: UseSTD3}Rules is false, soC~ 98kif 0 < lenV < 64s> Pemptytoo longd1p2: nameG6=4 F)4 kE^k5: Check ACE prefix #ifstartswith(sace_$L ; <_ A6: E(PUNYCODEx @puny! I7: Prependm G" + 58 2siz  8L11if isinstance8w, bytesQpure_Cb = True"  &_ ! ;F~ 22: Performprep  label = nameprep(3) .# It doesn't say this, but apparently, it should be ASCII nowFEtry: Zf" =.encode("ascii"}except Uni ZErrorGYraise ("Invalid character in IDNl^# Step 3: Check for ACE prefixbif not6.startswith(ace_')return strA%, Mp4: Removem1I[lenh(] FP5: De using PUNYCODE$dresultJ11.d*`("puny4)")L6: Apply ToD42 =(U :`7: ComR the #P of sZ 6 -5one3`#V2 will already:in lower case.,iQ V.'V() !=u2v#1DNAround-trip",2B8: r5   ### Codec APIs class(1cs.ICdef self, input, es='strict'):H#if !##A is quite clear that implementations mustiBjunsupported` handl""+BBP 6fb'', 0 5W" =6'6'6\<EpassJelse#ame: fast path2(3s =.split(b'.(^, js[:-1]r*%P(0 < -c) < 64%&6 empty or too long>&ifcs[-1]) >= 64d[,g = bytearray(YCdotsWAQs and5 @trai0_do 2del I'- #if% b# Join0RU+002-.extenda )Vbytes(result"+trailing_dot), len(input) def decode(self, , errors='strict'):/3#ifD != !:Nraise UniYEK("Unsupported@P hand2 "+oBbif not \eturn "", 0# IDNA allowsing to operate on ngs, too.ssinstance), bytes)# XXX obviously wrong, see #3232Vq" =IV ace_prefix# Fast path^:trysr&.'ascii')-dexcept'D`Fpass~labels =.split(b"."'1and[-1]) == 0fi = '.'Fdel AOelseH 'result = []A2forX2 in sP5.append(To()".".join(9)  class IncrementalEnA r(cs.Buffered"!_b&!_e<s, final4a is quite clear that impltions must beg%ctZiu;w(b'', 0Cdots) m&b'm/if.\ & U $#eld_# Keep potentially unfinished until the next calldcfarray(tsize = 0.{0if 5 Join with U+002EU@.extFb'.' ]Y += 1> :uToASCII8@eF^2i;!O(M,)) ;entalDecoder(codecs.BufferedIncrementalDer): def _b&!_d (self, input, errors, final48#if != 'strict'Sraise UnipEH("Unsupported@ handling "+l!) Bbif not \eturn ("", 02# IDNA allows \to operate on ngs, too.uisinstance($st1labels = dots.split-)JJelse# Must be ASCII1Xq =P, "ascii"Y(17"." @trai[_dot = ''i2if @ pJ[-1]w T.U3del^Ct#elcO^# Keep potentially unfinishedU until the next calldhbPresulN%[]size = 03for"in sF.append(To%(z)0if a AU += 1x3lenOPw = ".".join(H) + QcM!rI,) class StreamWriter(C, 8cs.VJpass9ORead9 9 ### encodings module API getregentry(7UInfo(name='idna',c!e=/2().ri:'r=E/er/J //sowo=b #rY#L# ) # # iso2022_jp.py: Pyth6 1ISO(!JP7 ten by Hye-Shik Chang # im " __w", multibytc as mbc &, =?A.get#('QE_jp' " =~{d(mbc.M j .s.4  alDecoder(mbc.MultibyteIncrementalDecoder,  >cs.4!):5 1 =  class StreamReader(Codec, mb!,<(s.^OWrit^ ! ^^def getregentry(&dreturnQInfo(7name='iso2022_jp'O en=52().di:'r=E\/J / sr=|#wj#A#f) # # _1.py: Python Uni for ISO#AJP_1;M&ten by Hye-Shik Chang # import _Y3cs_{m(0 as~" =?A.get(D_1')(#!s. P( pm 4  4 q#/_1%2%2%2% codecs.IncrementalEncoder): 2c = class . De"r(mbc.Multibyte ,MQ @ T StreamReader(Codec, !,(s.^OWrit^ ! ^^def getregentry(&dreturnUInfo(4name='iso2022_jp_2'Qe=72().di:'r= /J //sr=~ #wl#C#h) # # 004.py: Python UniB  for ISO(qJP_2004AS&ten by Hye-Shik Chang # import _\3cs_m(0 as" =?A.get(T004')\(&!s. &#P 4!  ~b 4 z.aTI?13.3+3(4odec.decode  class IncrementalEncoder(mbc.Multibyte ?, @>cs.4!):5 1 =  De 4 StreamReayCodec, !,(s.^Writer(^! ^^def getregentry(&dreturnpQInfo(name='iso2022_jp_3'Qe=72().diM:.r= /J //sr=~ #wl#C#g) # # ext.py: Python Uni for ISO'aJP_EXT?Q&ten by Hye-Shik Chang # import _[3cs_ms(0 as" =?A.get(Text')Y(%!s. # P+`KJH>-/kr)/KR%22_kr') class Codec(c!s. ): en0 = "c. de class IncrementalEBr(mbc.Multibyte ,Us h>cs.4 D 4 StreamReader(T), !,a(s.^OWrit^ ! ^^def getregentry(&dreturnUInfo(name='iso2022_kr'O5=5#()D:iKI.r= /J //sr=| #wj#A#) """ Python Character MappingZ iso8859_1 generated from 'MAPPINGS/ISO#/-1.TXT' with2P.py. m#" importS ###jDAPIsr=N (self,input,errors='strict' charmap_B=,ing_table) oo)B oo<  h final=False*Y.S 4[0]eN!@Q([,T5pas  9 9Js module API *`]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$$3 -> DIGIT THREE '4'# 0x34 -> DIGIT FOUR%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 AYB121B1C131C1D1D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa' # 0x61 -> LATIN SMALL LETTER A 'b'# 0x62 /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:7UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$a$[$P$$G$$C$$9$=8= $9@9@9@9@ntrol> '`\x92' # 0x92 -> X'\x93$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$'a0$ A0$NO-BREAK SPACE(a1)1) INVERTED EXCLAMATION MARK4UAUCENT SIGN$UAUZPOUND%VAVCURRENCY(ZAZ:YEN#YAYBROKEN BARZAZ1SEC ]A]DIAERESISK]A]COPYRIGH bAb FEMININE ORDINAL INDICATOsAsLEFT-POINTING DOUBLE ANGLE QUOTA+NOASOFT HYPHEAREGISTEREAUMACROKbBiDEGREEbBPLUS-MINUS*BSUPERSCRIPT TWObB *5HREbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DOTqBuCEDILLA"B&ONBoMASCUL bBbBVULGAR FRA ONEARTEbB6EHALFeB 3T1 QUkbBAQUES2cCLATIN CAPITAL LETTER A WITH GRAVcC< cCLATIN CAPITAL LETTER A WITH CIRCUMFLEX '\xc3' # 0xC3 -> LATIN CAPITAAUTILDE<4<4< DIAERESIS@5@5@ RING ABOV6A6A27272C0eEDILLA8>8>E>7GRA9<9< FACUTa<A< bABA c@C@Id<D< e<E< fAFA 'd0@/D0@ETH (Icelandic)1(d1?1?N8 ^(d2<2<O< mdD< tdD<tdDA D<DMULTIPLICATION SIGNDnUSTROKdDUD< D<DAdDY D_THORNRDESMALSHARP S (GermaneE >- ReE: eE:eE?TILDE '\xe4'  # 0xE4 -> LATIN SMALL LETTER A WITH DIAERESIS 3`'\xe5'  >5> RING ABOVE?6?6?07070CuCEDILLAl8<8<E<7GRA9:9: FACUTa:A: CIRCUMFLEXb?B? c>C>Id:D: e:E: f?F? 'f0>/F0>ETH (Icelandic)l(f1=1=N.ETILD(f2:2:O: Y(f3:3: h(f4:thfF? F:FDIVISION SIGNFfVSTROKFUF: F:F?TFY F_THORN2Fy) ### 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): Adef e(self,input,errors='strict'):,[creturnoB=,4ingCo8 orors='strictS'):  return codecs.charmap_de(input,errors,ing_table) class IncrementalEn6 r(>cs.xQdef e,r(self, h final=False*@:F.?[0]De'@StreamWriter(C,TDpassORead9 92###ings module API getregentry(7 UInfo(Sname='iso8859-10',!e=52().ik:.r=d/J //sur<=I #w##@) O[Ping T*I5cod2 = ,`'\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 c' # 0x1C -> FILE SEPARATOR '\x1d' # 0x1D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" ~ 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- 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+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM1bM1N' # 0x4E -> LATIN CAPITAL LETTER N 'O'# 0x4F1O1P1/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/P /K/l/ /L/m//M/n//o/p/7^q/r/s/"t/u/v/w/x/y/TTER Y '3z' # 0x7A -> LATIN SMALL LETTER 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$9$a$[hb$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 SPACAu010AEPCAPITEA WITH OGONEKAu011`=^=E=fMACRON=2=w=G=wCEDILLA>{>I> {@== Au013<<Ky (xaASECTION SIG3ueeLe>>D>WSTROK6==S=)CA6 0xAB -> LA.TIN CAPITAL LETTER T WITH STROKE '\u017d' # 0xAC -> LA=Z=SCARON<!xa:<D<SOFT HYPHE&Vu016abE&bUb6MACcGu014=F=4ENG b0n B03DEGREE SIG 05( B1&ESMAL3AcOGONEKaVu0113;2;E; 2;3;G;vCEDILLAw&2bw4<I< w9;5; GTILD&37:6:Ku !xb:7<MIDDLE DOT&3ca8%La1<9<D< 6;A;S;9B:lel tjGu201jpHORIZON6BARO6%m ck;k ;iAu010k Ci xE !xcC=DACUT0xc2F<<CIRCUMFLEX&!xcAA8xc4}<DIAERESIS||@RING ABOV6 A2Fu012xC< 0C oC,!xcv <,8^< !xcy= }f}@+OTCr !xc | '\xcf' 0 # 0xCF -> LATIN CAPITAL LETTER I WITH DIAERESIS '\xd0' @/D0@ETH (Icelandic)?Pu0145A?1?NwCEDILLA>c>2>O>cMACRON=0xd3;/D3= UACUTE<4<4< CIRCUMFLEXA}5A FTILD}6}6< Pu0168Bt7@U6 |:8<rTSTROKVu0172y9=yeOGONEK2a;zA= b<B< g}CA s8xddD@Ys e<E<_THORNd8xdfAESMALSHARP S (German 01@.E >A be96E; e(::eE? eE: eE>RING ABOV (xeE ?0Au012 0 NAu010; ;C'CA7 e9 :E:Au011<t: (xeE; y7y>+OT) >f(xeE:yy (xfFETTER ETH (I6celandic) '\u0146' # 0xF1 -> LATIN SMALL LETTER N WITH CEDILLA<d<2<O<cMACRON;0xf39w3; UACUTE:4:4: CIRCUMFLEX?5?5? FTILDy(6: DIAERESISxPu0169zh7>U, x88x8:fTSTROKAu017hu9;ucOGONEK8xfavA; b:B: c?C? g!xf-D>Yg exE:THORN (IH3kF? KRA ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_11 generated from 'MAPPINGS/ISO$/-11.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-11',i!e=52().ik:'r=~, 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\x77UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$h[$$P$$G$$C '`\x8e' # 0x8E -> X'\x8f$F$'90$/90$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$@9@9@9@a@A@NO-BREAK SPACEAu0e0GAETHAI CHARACTER KO KAI0S0Q 0YHO KH2a2_27UATep3n3Wf3}3'ONe22wRAKHANG55 5wNGO NGU11 10CHOn22I33 3 3WSO SO/ /OY2 2JYO Y1 1D)'DA 2  2TO PATAK212B 2gHO THA1 B THO NANGMONTH11(B(8hPHUTHA5+B+XNO NE(B(XDO DE%B%ITO T#B#8THU1!B!3Ad$B$4Og%B%*1!B!xBO BAIMQ1!B!PO PLA '\u0e1c$' # 0xBC -> THAI CHARACTER PHO PHUNG '\u0e1d3D3WFO FA/e/E/b'AN2f2F2a0%200/C00bvSAMPHAOe&21515GMO M&22/2/gYO YAK_3030XRO RU`4040U\5,5,XLO LI&26161]7,7,hWO WAE~8181hSO SAL9191GRUSIa1A1SLb0B0gHO HIP`c0iLO CHUC9O ACHO NOKHU@CPAIYANNO'3DWSARA 3DAI HAN-AKAT-3 D fg D 1Mb D 1D01D1'UED12Dv3D01DePHINTH1Tfffe' 60e3DURRENCY SYMBOL BAH 4E*4E\A1E4ExI MAIMU4EA97ALAa4ELAKKHANGY4EM'MO$4EvMAITAIK20e4 0xE8 -> TH!AI CHARACTER MAI EK '\u0e49' # 0xE9 -> TH07THO1a1A1'RI1b1B1CHATTAWA6c6C6THANTHAKHAT5d5D5xNIKHAHI2e2E2YAMAKKANdf2F2XFONGM1%501%F01DIGIT ZER[&51*1*6ONE&52)2)(TWR3)3)8HRET4+4+GFOUR~5*5*(IVT6*6*7SIXS7)7)7EVE&58+8+GEIGH5Fz)NIQFANGKHANKHUFUKHOMUTfffe'= ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_13 generated from 'MAPPINGS/ISO$/-13.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-13',i!e=52()., incrementalencoder=IncrE3, i-de/D/streamreaXS R #rwriter=#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- lHYPHEN-MINU.' # 0x2E -> FULL STOP '/'p# 0x2F$rSOLIDUS"0" 30"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?,SQUESTION MARK @(4YCOMMERCIAL A4A(\LATIN CAPITAL LETTER AYB1i1B1C1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151Q1QR1;S1$T1U1UV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDUS ']'# 0x5D -> RIGHT 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/C/L/m/4M/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}(V~.CTILD~3\x77UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$h[$$P$# 0x8C -> '\x8d'  # 0x8D -> VULGAR FRACTION ONE HALF (X'\xbe3E3THREE QUARTERS9(e69F9LATIN SMALL LETTER AE0Pu01042&C00fCAPITA2 WITH OGONEK=2=1=I=&00z2=A=fMACRONz0z3=C=DACUT!xc" <4<yDIAERESIc c5@5@ RING ABOVPu0118C6AE t&12=7= 7c=8=7&CAs0xc9:9<sAu017>A<Z <1B<x 2a6>! &3b= {L{6_DS>Uu0143zDN< 4 D< o!xdxeDOzD< m!xdy=DTILD!xd"<< Q d7m@MULTIPLICA7SIG7DU# > 41mTTSTROKFu015DS 6< != aJDC76@CARON '\xdf'  # 0xDF -> LATIN SMALL LETTER SHARP S (German) 3'\u0105' >/E0>A WITH OGONEK;&2f;1;I;&01;2;vfMACRONv&07;3;CvSACUTE:0xe484:uDIAERESIS>'>5> RING ABOV}Pu0119h6?E h&13;7; -d;8;-&CAg!xe9:gVu017atA:Z :1B:tGxsCEDILLAGu013zD<K<&2bE< &3c;Lw6CFS<Au014 FN: %46F: c!xfQFOvF: a(xfF;DTILD!xf: -fN>DIVISION SIG7U &42<TSTROKFu015F; 6: ; QU@)U&7e,>7u20FRIGHT SINGLE QUOTAT MARK ) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCodec iso8859_14 generated from 'MAPPINGS/ISO8859/-14.TXT' with3 codec.py. """#" import s ### 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='isoa%',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]5' # 0x15 -> NEGATIVE ACKNOWLEDGE '\x16' # 0x16 -> SYNCHRONOUS IDL+7+7+ END OF TRANSMISSION BLOCK_8484eCANCEL!9!9!UeMEDIUM(a(A(SUBSTITUTb%B%VESCAP!c!C!FILE SEPARATORod)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &"  20)CSPAC! 1 EXCLAMAT3MAR"+2+LQUOT)#)3)NUMBER SIGN$&4&XDOLLA&%&5&wPERCENTM&'|AMPERSANDq1"'" uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOU5%SK3FIVJ-3Q%2SIX$Q$3EVE&R&E-L&M&$NI):FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H18 -> LATIN CAPITAL LETTER H 'I'# 0x49 -> LATIN C1I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /i/ /j/ /k/E /l/t /m//n//o/p/7^q/r/s/ETTER S C't' # 0x74 -> LATIN SMALL LETTER 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$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 SPACAu1e0#AEPCAPITEB WITH DOT ABOV@?@a@ >!xa<" >{POUND SIGN(Au010%|c C1010@@ >(1e~>CAPITAL LETTER D WITH DOT ABOVE '\xa7' # 0xA7 -> SECTION SIGN'Pu1e80)'8'LATIN CAPITAL LETTER Wg7GRAc9: c9<COPYRIGHTe2+eA)e DACUTVu1e0b<B<ESMALGu1efzC> YdxD<SOFT HYPHEA8xae&E&REGISTERED@0178,F*DIAERESIS1l@/B0@F Uu1e1f&B1@ J>6012)&B2> JG~F0121~3@ ~>71e4~4> ~M~71e4~5@ ~>0xb6  B6>yPILCROW11e5)sP8 Au1e5zz :x3> >x 6 Sfz z|4 zM&85@@ z>6 >!xc4OCA6!xcx< <!xc <<CIRCUMFLEX!xcA}DTILD!xc<} !xc@|JRINGcA AT2CuCEDILLA-> pE> ZCCAPITAL LETTER E WITH ACUTE '\xca'  # 0xCA -> LATIN CAPITAL LETTER E<CIRCUMFLEXAbABA DIAERESIS@c@C@IFGRAVd<D< e<E< fAFA Pu0174Bz/D0@W d1? /D1ANAETILD:(d2<2<O< v(d3<3< vd4< 5}5A 6<6< 11e6.7@T5vDOT ABO(d88@uVSTROK9=9=U} v< D<DA v(xdDYd<DESMALeSHARP 'e0E 5A eE:(xeE:eE? UeE: eE>JRINGReE ?E(e7 0CtCEDILLAeE <( E: E:b' # 0xEB "-> LATIN SMALL LETTER E WITH DIAERESIS '\xec' # 0xEC >I>UGRAVE:d:D: FACUT:e:E: CIRCUMFLEXyf?F? Pu0175@/F0>W} f1= 0/F1?N?ETILD(f2:2:O: j(f3:3: j(f4:4: *5? 6y6: @1e6b@7>T+vDOT ABO f8<8>iVSTROK9;9;Uy a:A: B: F j(xfFYH7: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): Adef e(self,input,errors='strict'):,creturnoB=,4ingCo8o*B ooIncremental$er h final=False*Y.S 4[0]DZ(@s,decoding_table)[0] class StreamWriter(Codec,c(s.): pass9ORead9 9### encodings module API def getregentry(7sreturn QInfo(name='iso8859-15',i!e=52(). deVincremental:6r=IE/er/J /Dl/sur<=h/R#w##@) O[Ping TI_ _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&' # 0x26 -> 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 B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1UV1x56 -> LATIN CAPITAL LETTER V 'W'# 0x57 -> LATIN1W1X181X1Y191Y1Z1A1Z1[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/w/x/y/z/{/ZCURLY|-`VERTICB}(RV~.CTILD~3\x77UDELET!"80D!8H\x81$$2$$3$ $84' # 0 x84 -> '\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$@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 SPACEaEAE INVERTED EXCLAMATION MARK4UAUCENT SIGN$UAUXPOUND%Au20a8rAVHEURO$(xaVAV8YEN#Au016GULATIN CAPITAL LETTER S WITH CAROmAm1SECc)cpcOSMALa ACOPYRIGH2A FEMININE ORDINAL INDICATORgALEFT-POINTING DOUBLE ANGLE QUOT A+NOASOFT HYPHELAREGISTERE(xaA7MACbBhDEGREE!xb&PLUS-MINUS*BSUPERSCRIPT TWORbB *4HRE=Au017B yZybB;MICb/BzPILCROWBMIDDLE DOT'\u017e' #% 0xB8 -> LATIN SMALL LETTER Z WITH CARON '\xb9' ! #:9:SUPERSCRIPT ONE*a*A* MASCULINE ORDINAL INDICATOR6b6B6RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKEPu0152GCECAPITAL LIGATURE O434D42&782E2fGYGDIAERESIS0xbf> KF@INVERTED QUES7xc01 C01 qAqDGRAV8xc1<1< FACUT<M/C2< CIRCUMFLEXcZA3A FTILD}44< f(c5@5@ Rc7ABO:6A6A7272CuCEDILLA-U- WE> C"< C< CA c7Id< 5< e<<CA dD4ETH%dDN, RdDO< adD< hdD<hdDA D<DpMULTIPL5SIG&dDnUSTROK?dDUDTER U WITH ACUTE '\xdb' # # 0xDB -> LATIN CAPITAL LETTER U WITH CIRCUMFLEXAcACA DIAERESIS@d@D@YAe<E<UTHORNqf5F5ESMALeSHARP 'e05/E05AEGRAVa(e1:1: (e2:2: (e3?3? FTILD4:4: (e5>5> RING ABO06?6?7070CtCEDILLA (e8<8<E< 9:9: a:A: E E >IE: E:E fF4ETHfFN" 6fFO: MfF: \fF:\fF? F:FDIVISION SIGfFfUSTROKfF F: F:F?TFLETTER Y WITH ACUTE '\xfe'  # 0xFE -> LATIN SMALL LETTER THORN3f3F3Y WITH DIAERESIS ) ### 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): 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-16',i!e=52().ik:'r=~/J //sur<=I #w##") [T ~2 = ,W'\x00S 00SANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIO(05.5.UQUIRYv6"6"ACKNOWLEDG(07&w7 -> BE88tACKSPACCt"  09$HORIZONTAL TABUn0A0LINE FEEDb&+ 0B$oVERTICR8x0c.C.HFORMRr"D$CARRIAGE RETUt00SHIFT OU0$IN '\x10'  # 0x10 -> DATA LINK ESCAPE `'\x11'  +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)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &" {2CSPAC! EXCLAMAT3MAR"+LQUOT)#)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq1"'" uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZERu3`%$Y$$T$&T%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:rFCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1vLATIN CAPITAL LETTER C 'D'# 0x44 -> LATIN CAPITA1D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/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//ALL LETTER N 'o'# 0x6F -> LATIN SMALL LETTER 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~.E.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@9@9@9@9@a@A@NO-BREAK SPACAu010AEPCAPITEA WITH OGONEK==2 -> LATIN S2MALL LETTER A WITH OGONEK '\u0141' # 0xA3 -> LATIN CAPITAL=L=dSTROKE=F20ac=4=EURO SIGN$&1e$5$ DOUBLE LOW-9 QUOTATION MAR&60666SDCAROr0xa7:7<1SECc70168'cS5a9a9:COPYRIGHT@0218+]A)c ]eOMMA BELOW>0xab@BBEFT-POINTING L_ANGLEL7CDZLDACUT8xadD<SOFT HYPHErPu017a(bE& K`::F: "<DOT ABOVb&  B0@hDEGREE!xb&1&PLUS-MINUS*Fu010 B2* C,xK2BK I1017iBIw w7201<aa0xb6axPILCROW(xbLBLMIDDLE DOTBJ7010J 3m&21B[ :YbwY6Z5ZIGATURE OPu0153{R 27FB^ YDIAERESISd + bcbCb ~^6GRAcxCx< zcZCxCIRCUMFLEX0CiC7BRE4}}s0`| :|<AS(xcC7 -> LATIN CAPITAL LETTER C WITH CEDILLA '\xc8'  # 0xC8 -> LATIN CA>E>UGRAVE<9<9< FACUT<a<A< CIRCUMFLEX}bABA DIAERESIS@c@C@Id<D< e<E< fAFA Pu0110B/D0@DTSTROKVu0143=1=N= d2: k/D2<O< kdv<3< x4x4< rGu01525A zDOUBLE 66C 17@S<|Gu017U<DC <(xdD< (xdDA-!xcOGONEKcAu021=TyCOMMA BELOWB(xdDESMALeSHARP eqE 5Au 'e1E: eE: Au010*E?6BREeE: 07x >: E :A9!xeh 0j e< <GRAVE '\Pxe9' # 0xE9 -> LATIN SMALL LETTER E WITH ACUTE /X'\xea:A: CIRCUMFLEX?b?B? DIAERESIS>c>C>IFGRAVd:D: e:E: f?F? Pu0111@/F0>DTSTROKVu0144;1;N; f28" u2:O: f(f3:3: tt4: fGu015(5? jDOUBLE(f66A 27>S2Gu0178:U:FA F:!xf: (xfF?lcOGONEK?Au021;TmCOMMA BELOW@(xfFY@) ### 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'):,ccreturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 3[0] IncrementalDecoder(cs.Incremental): 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-2',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"+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?,SQUESTION MAR @(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S13 -> LATIN CAPITAL LETTER S 'T'# 0x54 -> LATIN CAPI1T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/C.REVERSE SOLIDU]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,F,LOW LINE`# 60#YGRAVEJa'1'TESMALAVb/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\x77UDELET!80' # 0x8 0 -> '\x81' # 0x81$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 SPACEAu010AELATIN CAPITAL LETTER A WITH OGONEK=!2d=^GBREV]4 Z]L]TSTROK=!xa AsCURRENCY SIGN!13Yewe GCARO<5<<SFACUTAxSECTION!xa"DIAERESIS6 4<< gEDILLAzg>>T z7b<<Z< = SOFT HYPHE7(bb <&< uDOT ABO!xbBBhDEGREE?fB?SMALL LETTER A WITH OGONEK '\u02db' # 0xB2 ->!6142!3!LATIN SMALL LETTER L\cSTROKE\0xb49\4;ACUTE ACCENT'Pu013e)5'bVCARON:56:S{:62c7t7:Z0xb88 eEDILLAB0161$9"|\Vu015f:A: v5<B<T v&7a:C:Z: ,&dd:D:PDOUBL7E.h chF: DOT ABOVmVo&C0>eCAPITAR!xc/C1<B!xc<A x<CIRCUMFLEXI0CaA5BRE!xc}b} DIAERESIS|%39sC{ |Vu0106<} <Cq}<C0)C> 3!xcz EAu011< i!xcy=1C@Z!xc|1I!xc< x<C6 AD}r0dD< Vu0143=Ny 4D<!xdv2DOx(xdD<n525 -> LATIN CAPITAL LETTER O WITH DOUBLE ACUTE '\xd6'  # 0xD6 -> LATIN CACIAERESIS@7@7@MULTIPLICATION SIGN.Pu01580n8.nRGCARO<&6e<9<U<RING ABOVa? AA 'Pu0170>B< jcACC jd@D@Y 62>E<T<sCEDILLA0xdf<F>ESMALedSHARP 57s/E050xe18o/E1:A ::2: CIRCUMFLEXPu0103{3? 6BRE[ e48y4: DAu013x5>L: C:!xe8: vv<8xe9( :EAu011<t:cOGONEK8xebu;1@y>!xe%c :I!xe::Dyf}:F:TSTROK^Au014;Nu:F:!xf(Ft!xf::b5(? fwFA 1(xfFDIVISION SIGN + '\u0159' # 0xF8 -> LATIN SMALL LETTER R WITH CARON :&6f:9:U:RING ABOVE?0xfa=yA? DACUT:Pu0171<B: xDOUBLE A0xfc?{CA IAERESISd>D>YxPu0163<E:T:sCEDILLAvGu02dF<3DOTS) ### 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 ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='E-3',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +P'\x00p 006ANULL0H1START OF HEADING+2J2+ETEXT(S3(0ENDQ &4N4&RANSMISSIj8x05.5.UQUIRYv6"6"ACKNOWLEDG9x07' # 0x07 -> BELL '\x08' # 0x08ACKSPACE$t" $9$HORIZONTAL TABULATION0n0A0LINE FEED$2x0b&xB$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 BLOCK1UCANCE(19UUeMEDIUMIa(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%SK3FIV%Q%2SIX#$Q$3EVE&R&E-L&M&$NI:3F4COLz; CSEMICOLON '3<'  # 0x3C -> LESS-THAN SIGN !+'=)D)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/IN SMALL LETTER G 'h' # 0x68 -> LATIN SMALL LET/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/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@\x9a' #  0x9A -> '\x9b' 0 # $B$c$C$d$D$e$E$f$F$'a0$ A0$NO-BREAK SPACEPu0126+ A1)LATIN CAPITAL LETTER H WITH STROK=62d8=2=DBREV 0xa3 : A3 POUND SIGN8xa4%4%CURRENCY(cufffe'5765 CIRCUMFLEXA8xa7v7AxSECTIONu!xa8'DIAERESISKAu013n9$ICuDOT ABO&Au015@@S@vCEDILLA~1>>G>F<J<FASOFT HYPHE 7PtZt .!xblBhDEGREE fBOSMAL 7xb2BSUPERSCRIPT TWO{(xbB *5HRE biACUTE ACCENTS5}5L\MICRO'bMIDDLE DOB y 31 DOTLESS I7 7< <3 :bBVULGAR FRA6ONE HALF 7! cC3A35GRA]!xcC  <(xc C x j (xcCN g%0apC@C 9Au010C6LATIN CAPITAL LETTER C WITH CIRCUMFLEX '\xc7' # 0xC7 -> LATIN CAPITAAeEDILLA>8>8>EUGRAVE<9<9< FACUT<a<A< bABA DIAERESISc@C@Id<D< e<E< fAFA dufffe''d1M/D1MNETILD(d2<2<O< ;(d3<3< B(d4<4< BPu0120C2/D5AGvDOT ABO d6> r/D6@ (xdDMULTIPLICATION SIGNAu011 (xdDU D< D<hA hAu016B:@5BREGu015<S5DESMALeSHARP e&E0Z 5At eE: eE: OeEL03E >  Au010>> (xeEG? EeEE <CeTIN SMALL LE TTER E WITH ACUTE '\xea' # 0xEA -> LATIN SMALL LE:CIRCUMFLEX?b?B? DIAERESIS>c>C>IFGRAVd:D: e:E: f?F? dufffe''f1K/F1KNETILD(f2:2:O: 8(f3:3: 8(f4:4: 8Au012h/F5?GvDOT ABO(f6}6> v8xf7>7>DIVISION SIGNAu011W8(  8xf9g9?U F: F:F? XGu0160>5BREGu015:S+ Au02dl3) ### 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'):,creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@input,self.error!s,decoding_table)[0] class StreamWriter(Codec,c(s.): pass9ORead9 9b### ens module API def getregentry(7sreturn QInfo(name='iso8859-4',h!e=42().incremental:6r=IE/er/J /D}/str;=g.R#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"+LQUOT)#)NUMBER SIG@$&HOLLA&%&tPERCENTM '&'  # 0x26 -> AMPERSAND "'"$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;S1jT1U1UV' # 0x56 -> LATIN CAPITAL LETTER V 'W'# 0x571W1X181X1Y191Y1Z1A1Z1[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\x77UDELET!"80D!8H\x81$$2$$3$$ol> '\x804' # 0x84 -> X'\x85$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@a@A@NO-BREAK SPACEAu010AELATIN CAPITAL LETTER A WITH OGONEK=3=^=ESMAL;6KRA151k1 nRndCEDILL>!xa" >CURRENCY SIGNf2fIfGTILD3d<L< AxSECTION!xaDIAERESIS6S7ARO1<<E<9MAC=2==G= Gu016 >T>TSTROK}(xa"A"SOFT HYPHE7($cZcC(xa<A< !xbuB9hDEGREE6B6 4&2daB4 U5F\$ \"b"B4 -> ACUTE A0CCENT '\u0129' # 0xB5 -> LATIN SMALL LETTER I WITH TILDE:&3c:6:L:uCEDILLA<62c7<7<SCARON 0xb88 B0161$9"S~\Vu0113:A:E:6MAC-;B;G; '16C<T<cSTROKEVu014aD;eCAPITA6ENG3&7e3E3 Zn{mb:F: k%001&C01 Am R!xc/C1= DACUT0xc2w<2< CIRCUMFLEX%!xcA3A 8xc4}4< DIAERESIS|5@x6RING ABOV6A A2Cu3 2cOGONEKFu010C=CS!xcbh yt C< !xcy= }f}@+OTdr!xc |< 6CA DD 7DN= )4jDO> 3DK= {(xdD{ t!xdDA Rd<< !xd_@MULTIPLICATION SIGN '\xd8' # 0xD8 -> LATIN CAPITAL LETTER O WITH STROKE 2p'\u0172?=9=U=cOGONEK=0xda;" =A= DACUTy8xdb<B< CIRCUMFLEX}cACA DIAERESIS@Au0169D@ DTILD<<E< cMACRONy8xdfF=ESMALgSHARP 017r/E05A pe9/E1; e:2:  e3?3? `8xe4:4: 8xe5>5> RING ABOV8xe6?6?0Au01270I APu010dm; C;'CAE e98\ :E:Au011<t: (xeE; y7y>+OT) >f0xeev:: y z|;FD 4;N;sCEDILLAaAu014-< 3FKw(xfFw h(xfF? .f*F: !xf>DIVISION SIGf.(f 7 cfhvA -> LATIN SMALL LETTER U WITH ACUTE '\xfb'  # 0xFB -> LATIN SMALL:CIRCUMFLEX?c?C? DIAERESIS>Pu0169@}D> DTILD::E: eMACRONu'2duF;DOT ABOVE ) ### 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'):,5creturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='E-5',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +P'\x00 ( 006ANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSI8x05.5.UQUIRYv6"6"ACKNOWLEDG8x07&w7 -> BE88tACKSPACCt"Q9$HORIZONTAL TABUn0A0LINE FEEDT0x0B -> VERT ICAL 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 s '@'  # 0x40 -> COMMERCIAL AT +'A(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P15P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[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 '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@9E -> '\x9f'  # 0x9F -> CYRILLIC CAPITAL LETTER HA '\u0426' # 0xC6 -57TSE67676 (CH68686 S9696 C8a8A8 HARD SIGNb<B< GYERU7c7C7 LSOFTsd<D< Qe4E4 Yf5F5 '%305)D05ESMALZ21212B&32323V33333G&34444Dg5353I3YDY 2ZWDW 4gTDT 3I3PDP 2hSHORT 8PDP 8KGDG 3'ELCDC 3M3:D: 339D9 3Oe6D6 2P44E4&ERf45E5'ES35E5T5E5443E3'EF3E343E3 43E3 44E4 46E6 44E44;E; 4c' # 0xEC+ -> CYRILLIC SMALL LETTER SOFT SIGN '\u044d' # 0xED:E2e2E2'YU3f3F3A3E21163 F03kNUMERO&51&1&$IOYF0452323'DJ&53434G44444UKRAINIAN Iq5=5=(DZ4264BYELORUSSIAN-~"7}7I'YI38383 9393L4a4A4N4b4B48TSHLc5C5Ki!xa5JFJ|SECTION?F?gSHORT D5DFD 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(name='iso8859-6C', 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 &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_+#rFPLUS',' # 0x2C -> COMMA '-'# 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$BEVEN&8&8&REIGHT&9&9&$NI):%A%CCOLOk; B GSEMI$<$CLESS-THAN SIGM=)LgEQUALS&>&K|GREATERR?,SQUESTION MARK @(4YERCIAL A4A(\LATIN CAPITAL LETTER B1i1BC1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151Q1QR1;S1jT1U1UV1V1W1W1X1Y1YbZ1R Z '['  # 0x5B -> LEFT SQUARE BRACKET %@'\\'2 .C.REVERSE SOLIDUS*])*D*?IGHY^/E/CIRCUMFLEX ACCEN_,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/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/{/ZCURLY|-VERTICALB}(RV~.CTILD~3\x787UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$ # 0x8A -> '\x8b' # 0x8B ->$c$C$d$D$e$E$f$F$'90$/90$1$1$2$2$3$3$4$4$5$5$6$6$7$7$8$8$9$9$a$A$@9@9@9@9@9@9@9@9@9@a@A@NO-BREAK SPACEoufffe' (xaACURRENCY SIGNBi'1060eAcARABIC COMMA(xafAfSOFT HYPHEQR A1061B}SEMICOLO1061AR?RQUESTION MARKP 1062u<Cs<LETTER HAMZAu062.} .ALEF WITH MADDA ABOV1062>>v >> >2WAW{== =>TBELOW21062> >?YEH{ = ={j- -7BEH,, , TEHRBUT 4 4`C)THC-GJEEMZ HAH '\u06 2e' # 0xCE -> ARABIC LETTER KHAH '\u062f-F-6DAL,%30,.D0,)TH-1-1-'RE&32,2,GZAIN3-3-8SEE-4-4-H.5.5.'AD6,6,D,7,7,T&38,8,Z,9,9, 7a,A,'GH.Tfffe' !6064,E,gTATWEEU4(E(F(4(E(4QAF6064'E'K,&E&7LAMX$E$8MEE-%E%7NOO4&E&H &E&7WAW&E&LEF MAKSURA5/E/Yb['EB[xFATHATAc*C*KDAMM*d*D*KKASR*E~E{'5Fx'FWSHADDG5FESUKUb!4[) ### 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'):,XcreturnoB=,4ingCo6on codecs.cha rmap_decode(input,errors,ing_table) class IncrementalEn6 r(>cs.): def e,r(self, h final=False*.sreturn U1cha@:F.?[0]De'@StreamWriter(Codec,DpassORead9 92###ings module API getregentry(7 QInfo(name='iso8859-7',!e=42().ij:.r=c/J //str;=H #w##@) N[Ping T)H5cod2 = +`'\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 1 ILE SEPARATOR '\x1d'  # 0x1D -> GROUP SEPARATOR `'\x1e' *E*oRECORD+f+F+LUNIT) &~ 20)RSPACEt! 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- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOUg5%SK3FIVJ6%Q%2SIX7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM1bM1N1 1LETTER N S 'O' # 0x4F -> LATIN CAPITAL LETTER O )*'P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/z 5C.REVERSE SOLIDU]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALGAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/N /L/m//M/n//N/o/p/7^q/r/s/"t/u/v/w/x/y/z/A -> LATIN SMALL LETTER Z '{'# 0x7B -> LEFT 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$9$a$A$b$Pc$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 SPACAu201KAEmSINGLE QUOTATION MARK5\5VM6 (xahAhPOUND SIGN[aK[iLEURO$$ixDRACHMA'(xalAlBROKEN BARp(xamAm1SEC!xa%" spDIAERESISK$pDCOPY1037wMuGREEK YPOGEGRAMMENIWA-POINTING DOUBLE AxT:NOT.ASOFT HYPHESfffe'HORIZONTALebB0 -> DEGREE SIGN '\xb1' # 0xB1 -> PLUS-MINUS S*2*2*SUPERSCRIPT TWOT3*3*CHREE,Pu0384.4,GREEK TONOS&5&5&DIALYTIKA06060 CAPITAL LETTER ALPHA WITH@0xb7> 7@MIDDLE DOT8'8% e~EPSILONg9B9BT>a>A>/IO?0xbb=B?RIGHT-POINTING DOUBLE ANGLE QUOTATION MARKcGCE_OMICR0xbd@DBVULGAR FRACqONE HALFue5uE3uUy fBFBOOMEG{%90@&C0@ESMAL^y9ANDkAu039C955GBETA444HGAMM5C 9DELjC 5CZ 3C*TH5CCHKAPPqHLAMD5C'MUxgvgN2uCu'XIdeCe 7a\D\ >PiaCDC$RHgufffe'rD8SIGaD'TACaDD(PHDGREEK CAPITA$L LETTER CHI '\u03a8' # 0xD8 -> GREEK CAPITA3(PS39393WOMEGAha5A5IOTA WITH DIALYTIKCbCBCUPSILONFcFCFESMALCALPHWTONOSd>D>E @e@E@ <f<F<A =%b0=/E0=;\ AND N1N1NE:&b23237BET&b3232HGAMM343439DELf53536565Z7272 1E *TH3E 3!E 2HKAPPcE 3HLAMD3sEs'MUeEeN0UEUXbIEIvOMICRONcAFAPec#F#7RHOa!F!FINAL SIGc(F( 3(F('TAcc&F&?&F&Pc%F% c%F% c#F# c$F$Vrc2F2<DCFCD '\u03cd'2 # 0xFD -> GREEK SMALL LETTER UPSILON WITH TONOS '\u03ce' @E@_OMEGA>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): DAdef e(self,input,errors='strict'):,tcreturnoB=,4ingCo6o*B ooIncremental$er h final=False*Y.S 4[0]DX(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(cname='E-8',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +P'\x00[] 00]ANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDGE&7&w7 -> BE88tACKSPACCt"Q9$HORIZONTAL TABULATn0A0LINE FEEDb&B 0B$oVERTICR8x0c.C.HFORMRr"CARRIAGE RETUR[e,|~SHIFT OUf$FrSHIFT IN '\x@10'  # 0x10 -> DATA LINK ESCAPE X'\x11+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)D)_GROUP*e*E*oRECORD+f+F+LUNIT) &1 2CSPAC! EXCLAMAT3MAR"+LQUOT)#)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq0"'" 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 B1i1BbC13 -> LATIN CAPITAL LETTER C 'D'# 0x44 -> LATIN CAP1D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T1T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'ESMALA,b/ /B/c/ /d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/: /l/i /m//n// SMALL LETTER N 'o'# 0x6F -> LATIN SMALL LETTER 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~.E.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@9@9@9@9@a@A@NO-BREAK SPACdufffe'a.A.CENT SIG8\xa.A.POUND SIGN '`\xa4'  # 0xA4 -> CURRENCY SIGN X'\xa5(5(:YEN#6#6#BROKEN BARH7%7%kSECTIOL8'8'DIAERESISK9$9$COPYRIGHTdtA)MULTIPLICA{bWB.LEFT-POINTING DOUBLE ANGLE QUOTDEMARKcDCD*NO(ad#D#SOFT HYPHEwe&E&REGISTERED(af*F*UMACROK'b0! B0!iDEGREEG(b1&1&PLUS-MINUS*2*2*SUPERSCRIPT TWO(b3*3*EHREE,BACUTE ACCENT'BZMICROBzPILCROW'BMIDDLE DOqBuCEDILLAB%ONfq\DIVISbBbBVULGAR FRAy ONEARTEbB6EHALFe 3T1 QUkcufffe'F 1201#DZeLOW LIAu05de*EcHEBREW LETTER ALE0-l-j -$BE~,n,l ,TGIMELD105dr.p .9DAL\t.r .Hx+v +7VAV,} ,DZAYIZdE .HZ ,T,,HEBREW LETTE(R YOD '\u05da' # 0xEA -> HEBREW LETTER FINAL KAF2b2B2 ,c,C,HLAMEd.D.7MEMe2E2 ,f,F,^6NUN^%e02.F02 ,1,1,gSAMEKH[2/2/8AYI3-3-'PE^4141 +5+5+\WTSADI_6464 .7.7.'QO\&e8,8,8RESD9-9-)SHDF4TAV_fffe' 6200pFLEFT-TO-RIGHT MARK:6200qF%.6 -t) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB iso8859_9 generated from 'MAPPINGS/ISO#/-9.TXT' with2P.py. m#" import sjAPIs class ($. 1): 3Adef 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-9',h!e=42().ij:r=IncrementalEncoder, incrementalde&=ID/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- lHYPHEN-MINU.'iFULL STOP '/'  # 0x2F -> SOLIDUS '0'" 30"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?,SQUESTION MARK @(4YCOMMERCIAL A4A(\LATIN CAPITAL LETTER AYB1i1B1C1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151PQ1Q1R1;S1$T1U1UV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 zREVERSE]) # 0x5D -> RIGHT 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 CURLYi|-VERTICALB}(V~.CTILD~3\x77UDELET!"80D!8H\x81$$2$$3$$4$$5$$6$$7$|$8$q$9$f$h[$$P$$G$d' # 0x 8D -> '\x8e' # 0x8E$f$F$'90$/90$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$@9@9@9@9@a@A@NO-BREAK SPACEaEAE INVERTED EXCLAMATION MARK4UAUCENT SIGN$UAUZPOUND%VAVCURRENCY(ZAZ:YEN#YAYBROKEN BARZAZ1SEC ]A]DIAERESISK]A]COPYRIGH bAb FEMININE ORDINAL INDICATOsAsLEFT-POINTING DOUBLE ANGLE QUOTA+NOASOFT HYPHEAREGISTEREAUMACROKbBiDEGREEbBPLUS-MINUS*BSUPERSCRIPT TWObB *5HREbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DOTqBuCEDILLA"B&ONBoMASCUL bBbBVULGAR FRA ONEARTEbB6EHALFeqB 3T1 QUkbBINVERTED QUESTION MARK '\xc0'  # 0xC0 -> LATIN CAPITAL LETTER A WITH GRAVE<1<1< FACUT<2<2< CIRCUMFLEX}3A3A FTILD}4<4< DIAERESIS|5@5@ RING ABO:6A6A7272CuCEDILLA8>8>E> 9<9< a<A< bABA c@C@Id<D< e<E< fAFA Au011DG6BREdDN< [dDO< jdD< qdD<qdDA D< (xdDMULTIPLICATION SIGNdDnUSTROKHdDUD< D<DA dAu0139DOTGu015QS9 dDESMALeeSHARP ge E 5eE1 -> LATIN SMALL LETTER A WITH ACUTE '\xe2'  # 0xE2 -> LATIN SMA:CIRCUMFLEX?3?3? FTILDy4:4: DIAERESISx5>5> RING ABOV}6?6?07070C`uCEDILLA8<8<E<7GRA9:9: a:A: b?B? c>C>Id:D: e:E: f?F? Au011@D/F0>G6BRE'f1x/F1:N: ?fFO: VfF: efF:efF? F: (xfFDIVISION SIGNfFfUSTROK fFUF: F:F? TAu013DOTLESS IcGu015*S( Hf: FY<) ### 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 &% =:kr.getcodec('johab') class Codec(c!s. ): en0 = "c. dePIncrementalEBr(mbc.Multibyte ,Us h>cs.4 D 4 StreamReader(T), !,a(s.^OWrit^ ! ^^def getregentry(&dreturnUInfo(Sname=WJ0=0#()?5iFI.r=/J //sr=w #we#<#) """ Python Character MappingU2 koi8_r generated from 'MAPPINGS/VENDORS/MISC/KOI8-R.TXT' with ge?`c.py. o#" importS ###lDAPIstP (self,input,errors='strict' charmap_B=,ing_table) oo)B oo$  h final=False*Y.S 4[0]eN!@Q [5pas  9 9Js module API '2-r'ee@ing Table deco ding_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$ # 0x33 -> DIGIT THREE '4'# 0x34 -> D&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 AYB121B1C131C1D1D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1;S1SbT1U1UbV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *RY^/CIRCUMFLEX ACCEN_,EOW L`#6XGRAVEJ'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/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LIN0}(ORIGHV~.CTILDN3\x7:7TDELET!Pu2500F!8BOX DRAWINGS L|HORIZONTA\828826n6DOWN AND <1< 3LEF|w&14;/UPu8:: s9 y2@ 2(?i3:A3?J?NGS LIGHT VE2RTICAL AND HORIZONTAL '\u2580' # 0x8B -> UPPER HALF BLOCK +4+C+?LOW+8+D+MFULLPc%E%OLEFTz9F*ORIGH+1U 90+L+VSHADE&92&1&|MEDIUM '3'2'KDARK%&32 93%2TOPhINTEGRna,4,BLACK SQUAR6219x5'ULLET OPERATOR621a*6*KV ROOT&4 97&ALMOST EQUAL TO*6 98*LESS-THAN OR0590GREATER3xr 9A3NO-BREAK SPAC'32oBOTTOM\!xbZXDEGREE SIGN!xb&SUPERSCRIPT TW 0xb7*MIDDLE DZ)xf%DIVISIONwAu255gABOX DRAWINGS DOUBLE5A9"VEpp 7WANGLEOD(04{CYRILLIC SMALL LETTER I4w1A $WNBAND w SIw6255A D+FDOWN=A q @2556;-C3C CF C CAR <2UP m}AB>Aa B1BSBVAz&UPB;b> }l;AA AAQAd A>A:e: :efHBH 65BR '\u2561' 8 # 0xB2 -> BOX DRAWINGS VERTICAL SINGLE AND LEFT DOUBLE '\u0401' G3G CYRILLIC CAPITAL LETTER IO5F2562545|l|G3G5G>@4@6@(WNpHORIZON[I5I7I3I 6I8I|[ DOWNI7B9B/UP8GAG9GBGD/UPa@C@G F F256bMDM/ cMEMD M!xa>FFCOPYRIGHT SIGN)Uu044eo!C0)gESMALe&YU3&30313A212 eB4C 3'TS43wCgD3aC3I34f3'EFPC3(GHg4Hg\C3I)C2hSHORT 8?C8K%Cr3'EL CX3M3dj>33+fE043feD4P34Y14gD5&ER4hD5'ES32D4TD4IC SMALL LET#TER U '\u0436' # 0xD6 -> CYRILLIC SMALL LET27ZHE42474V3&4c383SOFT SIGNm&4b:9:8YER75A5Z83B37SHAd4C4f92D29SHChE6C&4ajF4KHARDr%2e:)E0:eCAPITAYr&10515 ?&11424 BB2/E35 'TS6&14k46 D55555 I52j Q >&EFI&13j R 5G2 U 6L1EP 5IEO 4hSHORT :EV :KEW 5'ELbEZ 5M5EY 51  Z 5OifFT PK5T Y=2FU &ER2FU 'ES5FT TFT \FS 1T 2FFS 2FZ 1F] 2FX  '\u042d' % # 0xFC -> CYRILLIC CAPITAL LETTER E '\u0429' 4D4 WSHCHA878E8 (CHna6F6 HARD SIGN ) ### 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'):, creturnoIB=,4ingWCopo*B ooIncremental$er h final=False*Y.S 4[0]D(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(`name='E-t',e!e=12().ig:'r=z/J //sqr8=E #w##") [T ~2 = (P'\x00 00ANULL011START OF HEADING+2+2+ETEXT(3(3(0ENDQ &4&4&RANSMISSIONT5.5.UQUIRY"6"6"ACKNOWLEDG!x0w7 -> BE8E8tACKSPACCt"C9$pHORIZONrvTABULATn0A0LINE FEEDb& 0B$VERTICAL Rx0c' # 0 x0C -> FORM FEED '\r' # 0x0D$CARRIAGE RETURN*2x0e,*E*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!ILE SEPARATOFd)_GROUP*1oRECORD+1LUNIT) {2CSPAC! EXCLAMAT3MAR"+LQUOT)#)NUMBER SIG@$&HOLLA&%&wPERCENTM&'|AMPERSAN"3"'"!"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:3FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(40 -> COMMERCIAL AT 'A'# 0x41 -> LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/(5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'LSMALb/ /c/ /d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/SMALL LETTER K p 'l'# 0x6C -> LATIN SMALL LETTER 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/{/B/EFT CURLY BRACKEG|-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f#d7TDELET!Pu049b#!8CYRILLICKA WITH DESCENDE~\B3BB2GHECUSTROKF201a@ SINGLE LOW-9 QUOTATION MARK'v26vPCAPITWBxeBODOUBx F20266pHORIZONrsELLIPSIkf\u2020. FDAGG=F2021! (7fffUNDEFINED7203mPER MILLE SIG<b< |HF2039EFT-POINTING Ab F04b7-D C|bBC E g 60499j ilE20189lLr}i62019aR6 ckakkd5TkDOUBLE QUOTATION MARK '\u2022' # 0x95 -> BULLET!&13!6!wEN DASH"4"7"M"Ffffe"8"UNDEFINEDF19$QTRADET SIGN* NA*N603arB$SINGLE RIGHT-POINTING AlQUOTAT iCE i $D$E$F$/A0$E04ef A1$CYRILLIC SMALL LETTER U WITH MACRO[604e)A2>oCAPITA@ &51~3@ ~#IO!xa<!A43yURRENCY604eAI0xa6fBROKEN BAR7%1SECA A; A8xab7LEFoDOUBLE 8xacD8NOT]8xad#SOFT HYPHE!xaEREGISTEREDPu7xb0tBhDEGREEJ!xbPtBPLUS-MINUS**SUPERSCRIPT TWsAu040VB  B 104eY  YbBzPILCROWBMIDDLE DO B1211rhNUMEROo bB i i c $  $8xa9~ACOPY @044e+$Cx#YUHAu04333A2C2&BE34C kTSE '\u043%4' # 0xC4 -> CYRILLIC SMALL LETTER DE '\u0435353I34f63'EFf3f73(GHg84'HAg8g93I292A2hSHORT 8a8B8Kb3C3'ELc3D3M3d3E3N3e3F3O2f2/D02P313Y1&40f23&ER&41333S3234TD4Ue&36e3Z34V0D3SOFT SIG4D:8YER7=ZD8S4D9 o4D89SHCh;C4D<KHARDr2vEDeCAPITAYr1EF 5G1EG 4B2EI 5'TS61EL 61EN 52j Q 51ER 5 2 U 6L1EP 5T1EO 4 u041a' # *0xEB -> CYRILLIC CAPITAL LETTER KA '\u041b' # 0xEC5 'EL5c5D5 M5d5E5 N5e5F5 O4f4/F04 &PE52515 Y=&20j25 'ERj1535 S52545 T3555 Ui&16464 'ZHj176 V52F/F85 SOFT SIG2/F9< 8YER7A7 Z85X (SHFY }&29jX 9SHCl[ C&2an\ BHARD) ### 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): Adef e(self,input,errors='strict'):,\creturno B=,4ingCo2o*B ooIncremental$er h final=False*Y.S 4[0]DT(@QStreamWriter(N,[5pasORead9 9### encodings$ module API def getregentry(): return codecs.CQInfo(!name='koi8-u', en3=12().)deincremental:6r=IE\r/J /Dl/streamreader=S R R#Ewrit#W #) ### [ing TableEcoding_t2 = (`'\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&%&wPERCENTM&'|AMPERSANt1"'" uAPOSTROPH(IfLEFT PARENTHESISH)+pDRIGH,HESIS '*#' # 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!Pu2500F!8BOX DRAWINGS L|HORIZONTA\82886n6DOWN AND <1< 3LEFw&14;,UPu\u2518' # * 0x85 -> BOX DRAWINGS LIGHT UP AND LEFT '\u251c' # 969VERTICAL?RL@&24@7@ 28?ADOWN{HORIZONTAL39A?A? E&80BEUPPER HALF BLOCK8C+?LOW+8VD+MFULLPE%_z9F*+1z 90+@VSHADE&92&1&|MEDIUM '3'2'KDARK%&32 93%2TOPhINTEGRa,4,BLACK SQUAR6219xULLET OPERATOR621a*KF ROO)&249ALMOST EQUAL TOP69LESS-THAN OR05GREATER3x9NO-BREAK SPAC'32oBOTTOM\!xbZXDEGREE SIGN!xb&SUPERSCRIPT TW 0xb7*MIDDLE DZ)xf%DIVISIONwAu255A DOUBLE 5A9pp 7WANGLEOD(04{CYRILLIC SMALL LETTER I4Fu045?A3UKRAINIAN I5= Q6 zBYELORUSSIAN-II,IEYI (@)?7255?A y<AM <_UP SI 62559A\ BFAAND ASQAu?B;b } DOUBLE '\u0>491' # 0xAD -> CYRILLIC SMALL LETTER UKRAINIAN GHE WITH UPTURN '\u255dJEJBOX DRAWINGS DOUBLE UP AND LEFT:e:F:VERTICAL SINGLE@SRIGHTTHfH/B0HHYH&60H1H?HAU-B2A:x 7040G3GeCAPITA$IO|F040445 $IE?F2563?5?@F0406@6@BYELORUSSIAN-K7K7K EYI (B)A72568AADOWNHORIZONTALB9B(UP@ F2568AGTOG 9GBGDbG@a@C@w  7049% 9 ;&6c; &!xaBGDCOPY#GN)Fu044pC( &YU33C3A2C2B|6044C 'TS43C 4D35nC7044f  f'EFIC 3'GH4Hg[C3I)C2hSHORT 8>C~8Kbjq3Er6043 CW 7'EMdf>fu043e' # '0xCF -> CYRILLIC SMALL LETTER O '\u043f' # 0xD02&PE34313'YA30f23'ER31333S32343T3353Ue&36262'ZHf374V3&4cg83SOFT SIGN&4b:9:8YER75A5Z83B3(SHd4C4f92D29SHChE6C&4aj<KHARDr%2e:EDeCAPITAxYr1EF 5?1EG 4BB2EI 5'TS6&14 L 6D555 N 5I52j Q 5&EF1ER 5G2 U 6L1EP 5IEO 4hSHORT :EV :KEW 5'ELbEZ 5M5EY 51  Z 51eFT 25T 2FU 2FU E2FT 2FT U '\u0416'' # 0xF6 -> CYRILLIC CAPITAL LETTER ZHE '\u0412676 V5&2c585 SOFT SIGNq&2b<9< FYERU7&177A7 Z85B5 6SHAk&2d6C6 j94D4 9SHClE8 C&2anF6 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<s,D ssIncremental$er final=False*G.Z 4[0]Dd T@P UStreamWriter(Z,5pasORead: :ings module API getregentry(7 QInfo(bname='%',e!e=12().im:'r=/J //ssr9=F #w##") )[T ~2 = (P'\x00YG 00\ANULL1 1 1 START OF HEADING,ZL2,ETEXT)3U3)0ENDS '4'4'D OF TRANSMISSION '\x05'  # 0x05 -> ENQUIRY#6#6#ACKNOWLEDGE'7'7 -> BELL 8 8 tACKSPACEt#9%HORIZONTAL TABULATn1A1LINE FEED{b'B%oVERTICT9x0c/C/HFORMTr#D%CARRIAGE RETURde-E+SHIFT OUTf%F%II(10$ 10$DATA LINK ESCAPJ9x11,1,EVICE CONTROL ON.2.2.4TWO)13.3.6HRE^4040EFOUR_ 1NEGATIVE z11SYNCHRONOUS IDL 1END OF TRANSMIe BLOCK 1UCANCE)19WeMEDIUMKa)SUBSTITUT 1  1ILE SEPARATONdr_GROUP+ 1oRECORD, 1LUNIT* ~ *2!!aEXCLAMC MAR",LQUOT*#*NUMBER SIGT$'HOLLA'%'wPERCENTO&(AMPERSAN2"'"rAPOSTROPH(KvLEFT PARENTHESISW),ORIGH-*-sASTERISh+$GPLUS,%RCOMMA-!|HYPHEN-MINU.(yFULL STOPM/%rTSOLIDHY3kDIGIT ZER&p&%i% %d%'d&cM3FIV&a&2SIX+%7 -> DIGIT SEVEN '8'# 0x38 -> DIGIT EIGHT'9'9'BNINE&:&A&CCOLOn;!B!GSEMI%<%C%LESS-THAN SIGO=*D*gEQUALS'>'E'|GREATERT?-F-QUESTION MARK@) 40)COMMERCIAL A<A)1)LATIN CAPITAL LETTER A[B222B2C232C2D242D2E252F262FdG272G2H2^H2I22I2J22J2K22OL2&LdM2dM2N2 2bO22OdP252P2Q2 Q2R2 R2S2 S2T2 U2 UdV2 V2W2 W2X2 X2Y2 Y2Z2 Z2[2 EFT SQUARE BRACKE[%\\05REVERSE SOLIDU]* +R[^0CIRCUMFLEX ACCEN_-EOW L`$6YGRAVELa(LSMALb0 0c03 -> LATIN SMALL LETTER C 'd'# 0x64 -> LATIN SM0D0e050E0f060F0g070G0h080H0i090I0j0A0J0k0B0K0l0C0L0m0D0M0n0E0N0o0F0O0p0/700P0q010Q0r020R0s030S0t0T0u0U0v0V0w0W0x0X0y0Y0z0Z0{0EFT CURLY BRACKEN|.VERTICAL LING})ORIGHX~/CTILDP4\x77TDELET"Qu0402H"8CYRILLIC CAPITN(DJ7377G7G201a7 SINGLE LOW-9 QUOTATION MAR>X\u045nn  lODOUBl G2026pHORIZON sELLIPSIYg\u2020/SDAGGE"1" )'ac)EURO SIGN3pPER MILLE*G0409O5 L37EFT-POINTING A0|N|804977 KA WITH DESCENDER '\u0!4ba' # 0x8E -> CYRILLIC CAPITAL LETTER SHHA ,w'\u040f8F8 FDZHE8&528)908ESMALn%DJ5G2018515 LEFT SINGLE QUOTATION MARKkG2019626ORIGH7c737mODOUBm d646m7 257gBULLET3Y6"wEN DASH#4#7#M#Gfffe#8#UNDEFINEDH19%QTRADEWT SIGN+8045\A+7 L3l 9B5+-POINTING A8045FCF{N{G049bD5KA WITH DESCENDERbC * (5(9( 6&1xa0A&NO-BREAK SPAC204b,A 1TRAUXSTROKJ1vJ/J SH dA@H 4CHWS"xaCCURRENCY}eb5bBARRED O1xa6eOBDN BA9xa7&R1SECc 04WI;hACOPY 9Ag L?GHE"xamumt"xaEt NOI"xa$cSOFT HYPHE:"xa'GpREGISTE ^- < iBDhDEGREEc"xb'APLUS-MINUS+>B" BYELORUSSIAN-UKRAINIAN IHu045L & nJeP7 J  '\xb5' # 0xB5 -> MICRO SIGN `'\xb6' &6&zPILCROW(7(7(MIDDLE DOTNQu0451(t8& CYRILLIC SMALL LETTER IO42211494JNUMEWu0493[A'[GHE WITH STROKEh1xbb?BARIGHT-POINTING DOUBLE ANGLE QUOTATION MARKFQu04d9HCFVSCHWA7'a27D7eCAPITA"ENDESCENDEREEE ^C fFC@STRA& U&10<)C0< 1/C15 BGu041//C26 V6 /C36 (GH7447 D656_  I6Co6ZvC~7m8  CkwSHORT I;ap  pK"q'ELlcl  l'EM6d6 6e6 x l7041jCj 5P2dDd 2eDe &ES2eDe TeDe ;2cDc 'EFcDc HP2cDc (TScDc C2dDd SfDf C9dDdL LETTER HARD SIGN '\u042b' # 0xDB -> CYRILLIC CAPITAL LETTER YERU8c8C8 LSOFTud=D= Ere5E5 Yf6F6 Al&306)E06ESMAL31313B'32424V43434(GH54545D45454I46464Z7575i8484I9393hSHORT 9a9A9KWEW A'ELSES 4M4JEJ 43IEI 4OgFEF 3P4DFD&ERh4EFE'ES4EFETEFEI4CFC'EFCFCH:4CFC(TSCFCCx4DFDSFFF C7DFD5>5>?VBELOW6?6??YEH}7>7>}l8.8.6BEH-9-9- TEGRBUTa5H Tbs2s%(TH.u&62u [FJEEMm&62m .'HAg&62g -K.\2\5DALdYO0630FH.737Rd5356ZAId$3$7SEE.3)SH/36SAD3D-3Td3Z-3 >3)GH/&05LEFT SQUARE BRACKET:d&05REVERSE SOLIDUS7&05Rs&05CIRCUMFLEX ACCEN &05 LOW LINEe 4 fTATWEE7e 4 F e 4 2QAF~x00e3: 0x06403, # ARABIC LETTER KAF 0x00e4: 0x0644-6LAM-5-5-7MEE.6.6.FNOON\7.7.6HEH-8-8-6WAW-9-9-ALEF MAKSURA6a6a6Yb-b-wFATHATAc+c+JDAMM+d+d+JKASR+e+e+f(f(~("f0(,50({(1(1(VSHADDO#f2)2)6UKU"f3(7Pwf7(TT.8(TCdfd&AEaFVaGf8FDDAL9[(RR&07LEFT CURLY BRACKET, right-lefth&07VERTICAL LINE5&07ORIGHp9JdkYEH BARREE }) ### Decoding Table d _tA = (`'\x00'<0 # 8 000 -> CONTROL CHARACTER.1.1. 2.2. 3.3. 4.4. 5.5. 6.6. 7.7. 8.8. t, 9. n.a. 2x0b0b. c.c. r,d. 2x0e0e.L CHARACTER '\x0f'  # 0x000f -> CONTROL CHARACTER $Y'\x10./10. 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. 1  Y$ 2SPACE, left-right!.EXCLAMATION MARK9"9OQUOT7 #7NUMBER SIGNk$4_DOLLA4%4PERCENTi&5AMPERSAND0"'"T{2 APOSTROPHr(eLEFT PARENTHESISl-')9ORIGH: *:'ASTERIS+1*OPLUS;,2.8MMA; in Arabic-script context, displayed as66C ARABIC THOUS SEPARATO-xxHYPHEN-MINUJ.5FULL STOP'B|DECIMAL/z_SOLID3DIGIT ZERO; Q0v-INDIC Ho'_ONE; o1o2ONEn+nCn TWntext, displayed as 0x0662 ARABIC-INDIC DIGIT TWO '3' # 0d033 ->&HREE; in Arabic-script context, displn3nHp4p4poFOUR; p4pHo5o5o?IVEo5o2IVEo6o6o_SIX; 6o2SIXn7n7nOEVEN7nHp8p8p_EIGHTp8pHp9p9p?NIN9pHo:oaoCOLON, left-right.;.b.OSEMI2<2c2LESS-THAN SIGi=7d7oEQUALS4>4e4GREATERn ?:f:QUESTION MARK @6 406COMMERCIAL AT7A*1*LATIN CAPITAL LETTER A3B323B3C3fC3D33D3E3]3!F3!3FfG33G3H33H3I3l3I3J303J3K353K3L361L3M32fM3N313N3O3*3mP35'3PfQ30ER Q 'R' # 0x0052 -> LATIN CAPITAL LETTER R +0'S'333S3T343T3U353U3V363V3W373W3X383X3Y393Y3Z3a3Z3[3b3EFT SQUARE BRACKET, left-right<$\\=c<REVERSE SOLIDUS8]7 8d8?IGHu^=e=CIRCUMFLEX ACCEN_:f:LOW LINE`1 601SGRAVEf a)1)ESMALA1b1A 1B1c1? 1C1d1= 1D1e1; 1E1f19 1F1g17 1G1h15 1H1i13 1I1j11 1J1k1/ 1K1l1$L1m11M1n11N1o1O1p17bP1q1Q1r1Os1Mt1Ku1Iv1Gw1Ex1Cy1Az1SMALL LETTER Z '{'# 0x007b -> LEFT CURLY BRACKET, left-right;|;c;VERTICAL LINE6}6d6ORIGHr~<e<RTILDEB\x7f%f"CONTROL CHARACTER.)c4. 80.LATIN CAPITETTER A WITH DIAERESISB*a0B1BNO-BREAK SPACE, 6-A7*c7727yCyuCEDILLA@9@3@E@EACUT%*d1>4>N> c*d6>5>O> 5*dcB6BUBe7BySMALL L e8< EGRAV:*e29< CIRCUMFLEXeraA ;Pu06ba8dARABICNOON GHUNN/ ab4$ 6-POINTING DOUBLE ANGLE QUOTATION MARKe e>*e8< <9 x I9} 9xed9 IAu202z9pHORIZONELLIPSISexx X9A f9 @q*f3o5+xbn&f9LfAL |9PDIVISOSIGNfa' # 0x#009c -> LATIN SMALL LETTER U WITH ACUTE '\xf9' # 0x009d< FGRAV<b<e< CIRCUMFLEX}cAfA DIAERESIS@ =$ a0@SPACE, right-left.!.1.EXCLAMATION MARK9"929OQUOT7 #737NUMBER SIGNk$444_DOLLA4`\u066a9 a54ARABIC PERCENTp&+!a60MPERSAND1"'"/h72POSTROPHm(e83LEFT PARENTH l-')999ORIGH: *:a:ASTERIS+1b1APLUS/k0kjkRCOMMAd-[WHYPHEN-MINUS^.5PFULL STOP2/2A_SOLIDb 605b1-INDIC DIGIT ZEROp (need override)P1PSP)ON%O2OiO/TW3OO?HRE4QQOFOUR?5P ?FIV6P  P?SIX7OO9EVE8Q@E-Q/NI:PCICOLO1.@~Q SEMI9-<[;LESS-THANr=7IWEQUALht-left C'>' # 0x00be -> GREATER-THAN SIGN, right-left 2p'\u061f?:f:ARABIC QUESTION MARK1G274a1 c01EIGHT TEARDROP-SPOKED PROPELLER ASTERISK(21Q1QLETTER HAMZAH0622020ALEF WITH MADDA ABOVE@3@3@ z @4@4@2WAW?5?5?@WBELOW6@6@?YEH 7?7?n8/8/7BEH.9.9. TEHRBUT Ra6dbdb.Hc/c/GJEEM^d/d/(HAe.w K/lcl6DAL'30]di ])TH/GdGR3EdEGZAIN4d48SEE/#d#*SH0d7SADdD.dT3dZ.d Ed%GH0[ dLEFT SQUARE BRACKETU\=<REVERSE SOLIDUS8]7tRu ^=CIRCUMFLEX ACCEN_:LOW LINE4egTATWEEH4eF4e6QAF4eK.e'LA4eETTER MEEM '\u0646' # 0x00e6 -> ARABIC LETTER NOON /7/7/7HEH.8.8.7WAW.9.9.ALEF MAKSURA7a7a7Yb.b.xFATHATAc,c,KDAMM,d,d,KKASR,e,e,f)f))'50)'f0)~)1)1)WSHADDW(52*2*7UKU&7'f3)BP7.f4.(TT/8/f5/Cr(d5&AE (a4-Vaf6GAF\8fFDDAL/9$RR{fLEFT CURLY BRACKET, right-leftj|;VERTICAL LINE6}6ORIGHrc9 !J.dx.YEH BARREE ) ### Encoding Map e_map = {B00: ,?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-1/10-1: 0x0011, # CONTROL CHARACTER 0x0012:, - 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-%20-SPACE, left-right-a-(-3-1Z1ZEXCLAMATION MARKe8a8 p@%22pOQUOTn 6a6l2NUMBER SIGN3a3f2_DOLLAf 3a3f2PERCENT2AMPERSAND1a1-2-APOSTROPH2a2dd2dLEFT PARENTHESIS8a8 p2ORIGHq9a9 r2ASTERIS|0a0`2OPLUS91a1bT2T8MMA; in Arabic-script context, displayed as_66C ARABIC THOUS SEPARATO22HYPHEN-MINU4a4HEN-MINUS, right-left 0x002e:, # FULL STOP, + -r6; in Arabic-script context, displayed asM 66B ARABIC DECIMAL SEPARATORy/aeyt ff1xSOLIDUS`/a/^"30^%30^DIGIT ZERO; 0@-INDH#31n1n_ONE; n1n6ONEm2m2m TW2m6TWOm3m3mOHREEF3mHo4o4oOFOUR4oHn5n5n IV#5n'IV6n6n?SIX%6n6SIX7m7mOEVEN7mHo8o8o_EIGHTo8oHo9o9o!NIq9oHnanan_COLON3-b-bZbZOSEMI^c1c1LESS-THAN SIG6b6dldloEQUALSi3b3f38GREATER 9b9 rJ3JQUESTION MARK4P4PCOMMERCIAL AT-4 4 LATIN CAPITAL LETTER A242B2x0043: 0x00403,  # LATIN CAPITAL LETTER C 0x0044: 2 D25252 E26262 F27272 G28282 H29292 I2a2a2 J2b2b2 K2c2c2 L2d2d2 M2e2e2 N2f2f2 O2"502/502 P21212 Q22222 R232  S2 /54d T2 5  U2 5  V2 5  W2 5  X2 5  Y2 5  Z2 5 EFT SQUARE BRACKET, left-right;d; 6-A;d5dREVERSE SOLIDUSr7d7n5ORIGH<d< x5CIRCUMFLEX ACCENZ9d9 r&5&OW LINEQ0d0`6T6TSGRAVE6J6JESMALA0H6H 0B0F6F 0d6D6D 0b6B6B 0`6@066, # LATIN SMALL LETTER F 0x0067:,O # 0G08080 H09090 I0a0a0 J0b0b0 K0c0c0 L0d0d0 M0e0e0 N0f0f0 O0"700/700 P01010 Q02020 R03030 S04040 T05050 U06060 V0/770 W07 X07 Y07 Z07EFT CURLY BRACKET, left-right:f: 5-@:D7DVERTICAL LINEo5f5j~7~ORIGH;f; v7VTILDE7CONTROL CHARACTE"a8NO-BREAK SPACE, a8/LEFT-POINTING DOUBLE ANGLE QUOTATION MARKQbQ9KR'c8PCAPIT mA WITH DIAERESI c|8l ACAuCEDILLAc[8{ ?E?FACUTd8 =N= de8 =O=d 8 AUAeU ETTER A WITH GRAVE 0x00e1:087, # LATIN SMALL LETTER A WITH ACUT;2;9;CIRCUMFLEX{4@a@DIAERESIS?7?d? CvCEDILLA=8=f= E= 29;e; 2a;/90;2b@1@2d?2? I e;4;f@5@f/96? NFTILD#f3z O; f9 ;#f6{ @%9b DIVISION SIGN, right-leftf9 U fcp ; * ;*c* @ *#60?aARABIC COMM#61bR(SEMICOLONI#61b,PQUESTEMARK02c0DFHAMZ2=c /BALEFMADDA ABO#62%c3?x ?c ?2WAW}>5c >?VBELOW*c ??YEH}c >}l/c8(6BEH-<c [TEH MARBUT6c 5bc%(THc.FJEEM\cETTER HAH 0x062e:P0ce, # ARABIC LETTER KHAH .f.f.5DAL-"30-/d0-(TH.1.1.&RE#32-2-FZAIN3.3.7SEE.4.4.H/5/5/&AD6-6-D-7-7-T#38-8-Z-9-9- >a-a-(GH/4efTATWEE 4eF4e5QAFg4eK-e6LAMZe7MEE.e6NOOy4eHe6WAWeLEF MAKSURA6eYb&,eb&wFATHATAc+c+JDAMM+d+d+JKASR+ee~(5f{(fVSHADDO5fFSUKU6yby-INDIC DIGIT ZERO, right-left (need override)6b O?ONENb N/TWb N?HREb POFOURb O/IVb O?SIX.b. NFEVENPft (need override) 0x0668:@0b8,# # ARABIC-INDIC DIGIT EIGHT, right-left (need oveP9P9P ONINEOaO+a5O PERCENT SIGN7~,f4/LETTER TTEH.e]/f3.P-#86- [(CH/Xf /EDDAL#91]a'RR\9\e.J-#a4[7-V-f- 5GAFb/8bZNOON GHUNNA5#d2bf5YEH BARREE45464A,32029HORIZONTAL ELLIPSIS|g3274%c0g TEARDROP-SPOKED PROPELLER ASTERISKP\} """ Python Character Mapping Codec mac_croatian generated from 'MAPPINGS/VENDORS/APPLE/CROATIAN.TXT' with:cPP.py. x#" import cs ###uAPIs class($.1): `def en(self,input,errors='strict'):,4creturno.charmap_B=,ing_table)o/deo-B ooIncrementalEr  h final=False*Y.S 4[0]D"e!@QStreamWriter(N,8cs.5pasORead9 9Js module API getregentry(7 UInfo(name='mac-%',k!e=72().im:'r=/J //swr>=K #amwriter=StreamWriter, ) ### Decoding Table d _tA = (/`'\x00'9 # 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&%&wPERCENTM&'AMPERSANDq1"'" APOSTROPH(ILEFT PARENTHESISP+')+ORIGH,*,sASTERIS_+#GPLUS,$~2MMA- rHYPHEN-MINU.'mFULL STOP '/' # 0x2F -> SOLIDUS '0'" 30"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?,SQUESTION MARK @(4YCOMMERCIAL A4A(\LATIN CAPITAL LETTER AYB1i1B1C1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11P151PQ1Q1R1;S1$T1U1UV1V1W1W1X1Y1YbZ1Z1[1EFT SQUARE BRACKET$\\/5 zREVERSE]) # 0x5D -> RIGHT 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 CURLYi|-VERTICALB}(V~.CTILD~3\x77CONTROL CHARACTEGB\xc4O,8PCAPIT WITH DIAERESIXH\xc5@@RING ABOV(c7A ACcCEDILL%H\xc9> >E>EACUTz(d1< <N< c(d6<  <O< 7dw1 @U@eBATIN SMALL LETTER A WITH ACUTE '\xe0' # 0x88 -> LATIN SMALL L:FGRAV:2:9: CIRCUMFLEXy4?A? DIAERESIS>3>B> FTILD5:C: RING ABO7?D?CjuCEDILLA9<E<E< 8:F: a:/90: b?1? d>2>Ic:3: e:4: f?5? (f1>6>N f/97:O: f9: +f9:+(f6?+9> + U+9: + :+ ? +Au202AdDAGGERYb ADEGREE SIGN&a)AJCENT$AxZPOUND%AcxSECTION'rKdBULLETbAA.xPILCROWH(xdAeSHARP !aAREGISTEREAu016?eCAPITASQDCAROSGu212TRADE MARKblA0 ACaA2NOT EQUAL TOKu017d' # 0$xAE -> LATIN CAPITAL LETTER Z WITH CARON '\xd8' # 0xAF<O<cSTROKE=Pu221e?= B0=INFINITY#0xb1! ` B1#PLUS-MINUS SIGPu2264,M2*LESS-THAN OR EQUAL TOZ05030GREATER3&06343INCREMENTW!xbU5$[MICRO&02I6%PARTIAL DIFFEREN T(7/N-ARY SUMMATIVu220fY8*dPRODUCGu016R9(ESMALSVu222bbA:INTEGRAL0xaa!B# FEMININE ORDINAL INDICATOR5b5C5oMASCUL6 Pu03a9mD6\GREEKSOMEGAkGu017w fB :!xbCVERTED QUESS MARK!xa1#IN1REXCLA 4c 4;NOT{1j2CSQUARE ROO 9C F 4HOOAu224$_mALMOST'01MCc vCeDACUT9!xaLEFT-POINTING DOUBLE ANGLE QUOT&,Au010.+ &02 C?pHORIZON/ELLIPSIS03NO-BREAK SPACc)9AFGRAV<3e@< ETILD<dCF<<Gu015*MIGATURE Op4{G212D>D g&01DJsEM DASHFu201 D8PGA@201dtJ_RIGHT6!DZ EF6201DVk/SI60xf7&DbDIVISION25ca' # 0xD7 -> LOZENGE '\uf8ff' # 0xD8"Apple logo%0xa9#%9%COPYRIGHT SIGN)Pu2044+NA)FRACTION SLASH)&ac)B)KEUROM3xMC$SINGLE LEFT-POINTING AQQUOTAiFMARKh&3ahDDE0xc6CEELATIN CAPITAL LETTER AV8xbb2F2 poDOUBLE 13G E0EFEN DF0xb7  E1"MIDDLE DOT1 E2%G_OW-9 9 1e]}36L6 &30646PER MILLE0xc2'5)S WITH CIRCUMFLEX10106AESMALC?EACUT(c1{<Pu010d>v.vDCARO0xc88C: DEvFGRAVt<V<I< <i< i!xcAA DIAERESIS!xc@@ d<yOd<x< Au011*FA D{USTROKdF; | F<Uy dwF< !xdq}A Gu0130 0OTLESS I 2u02_gMODIFIERXe ACCEN102d^<mETILDaF6MACFu03cFbGREEK MP)xcg Au02dR&BOb1FxsCEDILLA:!xcEZTTER E WITH CIRCUMFLEX '\xe6'  # 0xFE -> LATIN SMALL LETTER AE0Pu02c720F0CARON ) ### 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): $Adef e(self,input,errors='strict'):,zcreturnoB=,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> p!00@ONTROL CHARACTER=,1,1, 2,2, 3,3, 4,4, 5,5, x/06, r47, 88, t*X9, n,A, 2x0b.$/0B, c,C, r*D, 2x0e.# 0x0E -> CON TROL CHARACTER '\x0f' # 0x0F -> CON,'10,/10, 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, 1  U" 2RSPACE ! 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%Q%2SIX$Q$3EVE&R&E-L&M&$NI):3FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YCOMMERCIAL AT4A(\LATIN CAPITAL LETTER A 'B' # 0x42 -> LATIN CAPITAL L1B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R1R1S1S1T1T1U1U1V1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/5 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,cOW LIN`#6YGRAVEJa'ESMALb/ /c/ /d/ /e/ /f/ /g/ /h/ /i/ /j/ /k/ /l/SMALL LETTER L 'm'# 0x6D -> LATIN SMALL LETTER 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#57CONTROL CHARACTEG`\u0410.,8CYRILLIC CAPITfA4144Bi255V5355(GH64665555Ij655Z766k855I94 4hSHORT :a::Kb55EMc5#55d5055e5754MKP2T9T 2U9U E2U9U TU9U iS9S &EF2S9S HA '\u0426'' # 0x96 -> CYRILLIC CAPITAL LETTER TSE '\u0427'676 (CH68686 7SHAl9696 C8a8A8 HARD SIGNtb<B< GYERU7c7C7 LSOFTsd<D< Qe4E4 Yf5F5 E20205 A05cDAGGER!xbH!A1![EGREE9(n A2&nGHE WITH UPTUR0xa3h3BIPOUN!xa%4%ySECTION@2022N5'eBULLET6HyPILCROWH1040)H BYELORUSSIAN-UKRAINIAN Irar#REGISTERE*zOPYRIGHY(21TRADE MARK 'DJ56 ESMAL@47226NOT EQUAL TOAu040Y G6  41221zjBINFINITY7xb1 BPLUS-MINUSH@2264,MLESS-THAN ORF22650GREATER36045sBI q bzGBYMICRO1049nB! 0F u I?  "=0C4|YGu0455 ? r30h < L56> i 40BE -> CYRILLIC C*APITAL LETTER NJE '\u045a' # 0xBF -> CYRILLIC SMAL484/C04g&05313C$DZ0xac4 C26NOT SIGN6221 C3#SQUARE ROOT&@0192K C4&ZLATINF WITH HOOK9722459ALMOST EQUAL TO*&06c6*INCREMEN0xab"7$LEFT-POINTING DOUBLE ANGLE QUOTATION MAR)xbD8DORIGHEGu2029EpHORIZON&ELLIPSIS8xa0A.NO-BREAK SPACAu040gB)M 7TSH757C7  50lD5 lK56E6 k 4#Pu20135D#sEN DASHU"4",EM"D.%WdW6D  EFjk9kk/SI60xf74D(PDIVIS 001e*B,_LOW-96tSHORT U7045::  8&0f8 )DZ7 + o56211D)iNUMEROF0401 I7045534&YAe3LE- 2E'2BO3E83V3E63G3E44DgJE23I3E/3 \37' # 0xE7 -> $CYRILLIC SMALL LETTER ZE '\u0438' # 0xE8 -> 3I29292hSHORT 8a8A8'KAkb3B3'EL3c3C3M3d3D3N3e3E3O2f2F2P%403/F03&ERf&41313S32323T3333Ue4242'EF35353H/&46363(TS7474(CH44F4S6F6 C64F4HARD SIG4;F;8YER=F=LSOFToDFD CFCY720aDBEURO) ### 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](@input,self.er$rors,decoding_table)[0] class StreamWriter(Codec,c(s.): pass9ORead9 9b### ens module API def getregentry(7sreturn QInfo(name='mac-farsi',h!e=42().incremental:6r=IE/er/J /D}/str;=g.R#w##@) N[Ping TH^2 = +`'\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   D2SPACE, left-right!,EXCLAMATION MARK7"7 0x22 -> QUOTATION MARK, left-right '#'# 0x23 -> NUMBER SIGN2$242_DOLLA2%252PERCENTe&363AMPERSAND0"'"70POSTROPHE1+'(a81LEFT PARENTHESIS7)797ORIGH8 *8A8ASTERIS+/B/OPLUS/,0C0XCOMMA,; in Arabic-script context, displayed as 0x066C ARABIC THOUvS SEPARATOR<-vDvHYPHEN-MINU@.3E3FULL STOP'B|DECIMAL/xFx_SOLID0. 30.DIGIT ZERO; IF0 EXTENDEDv-INDIC QO1v1v_ONE; v1v 2ONEu2u2u TW2u 2TWOu3uu_THREE/F3u Qw4wOFOUR4w Qv5v0FIV/F5v #IV6vAv?SIXM6v 2SIX7uuOEVEN7u Qw8wwEw8w Qw9w w!NI9w Qv:vJICOLO ';'  # 0x3B -> SEMICOLON, left-right %0'<'0C0LESS-THAN SIG5=5D5oEQUALS2>2E2GREATERj ?8F8QUESTION MARK@4 404COMMERCIAL ATA(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151E1F161F1G171G1H181H1I191I1J1A1J1K1K1L1L1M1bM1N11N1O1 1O1P151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET\$\\;/5REVERSE SOLIDUS6]55ORIGHq^;(CIRCUMFLEX ACCEN_8/~OW LINE`/6-SGRAVEb9a'#LSMAL1b/! //c/ /-d/64 -> LATIN SMALL LETTER D 'e'# 0x65 -> LATIN /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/4/T/u/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKET, left-right9|9VERTICAL LINE4}4ORIGHn~: CTILD3\x77CONTROL CHARACTEkB\xc4O,8PCAPIT.A WITH DIAERESI|H\xa0@ NO-BREAK SPACE, *-5/H\xc75 uCuuCEDILLA>9> >E>EACUT(d1<+ <N< W(d6<8 <O< +(dc@I @U@eZ ee:EGRAV0(e2p:CIRCUMFLE9\xe^? 1Pu06badARABICNOON GHUNN ab2" 4C -> LEFT-POINT'ING DOUBLE ANGLE QUOTATION MARK, right-left '\xe7'  # 0x8D -> LATIN SMALL LETTER C WITH CEDILLA<9<E<E<UACUTE:8:F: FGRAV:a:/90: CIRCUMFLEXyb?1? DIAERESIS>d>2>IPu2026<g 93:HORIZONTAL ELLIPSISe8  94:tf?5? (f1>6>NETILD(f3:7:O: b8:RIGHT-POINT (f49QBBfA? B` 9B>PDIVISOSIGNfC4U<f9: Xfv:%cd? % ; cA^SPACE!,oEXCLAM "7 #5NUMBER $2_DOLLA2Q\u066AARABIC PERCENTl&`AMPERSAND.1"'"ZAPOSTROPH_(a~LEFT PARENTH h+')7d8 *8]ASTERIS+/NAPLUS#]0]J]CCOMM-W7HYPHEN-MINU.30FULL STOP/0!_SOLID^ f03BEXTENDED -INDIC DIGIT ZERO, riHght-left (need override) '\u06f1' # 0xB1 -> EXTENDED ARABIC-INDIC DIGIT ONE, rigV2V2V OTWO,V3V3V?HRE4X4X OFOUR5W5W/IV6W6W ?SIX7V7VOEVENX8X8X _EIGHTX9X9X ?NIN]:RAWICOLO; 1b1;B,2Q SEMI7+<&WC+LESS-THAN SIG`=5D5oEQUALS2>2E2GREATERj  1f=F8QUESTION MARKe\u274a/ C0/ TEARDROP-SPOKED PROPELLER ASTERISKO6062C~LETTER HAMZA.[C[ .ALEF WITH MADDA ABOVE>CCC>v >)C) >2WAW{=C =>WBELOWC >?YEH{ C ={jC -7BEH,C , TEHRBUT>c 4`cCc)THce YGJEEMZd-] -(HAe,W ,K-LCL6DAL%30YDI Y)TH-'D'R \u0632' #  0xD2 -> ARABIC LETTER ZAIN '\u0633' # -3-8SEE-4-4-H.5.5.'AD6,6,D,7,7,7TAHX8,8,Z,9,9, 7a,A,%GH.[)oeB.LEFT SQUARE BRACKET, right-left\;C:REVERSE SOLIDUS6]5pD6?IGHq^;E;CIRCUMFLEX ACCEN_8F8LOW LINEw 404 E0/sTATWEELVu0641)1)'FE&42,7QAFXEK,E7LAMXE8MEE-E7NOO}4EH E7WAWELEF MAKSURA5EYbxFATHATAc**KDAMM*d**KKASR*e**~f''{'5Fx'FWSHADDG5FGSUKU7FPn7F(TT-8F)TCVdF&AEa3FVa{FG8F7DDA<9$RR{F_CURLY|9VERTICAL}4Rn 99JEH '\u046d2' # 0xFF -> ARABIC LETTER YEH BARREE ) ### Encoding table en_ =codecs.charmap_build(de$ ) """ Python Character MappWCB2 mac_greek generated from 'MAPPINGS/VENDORS/APPLE/GREEK.TXT' with7P.py. r#" import soAPIs class ($. ): def e(self,input,errors='strict'):,0creturnoB=,2ingF)o;o*B ooIncremental$er  h final=False*Y.S 4[0]D]N!@QStreamWriter(N,[5pasORead9 9Js module API getregentry(7 UInfo(name='mac-%',h!e=42().ij:'r=}/J //str;=H #w##") [T ~2 = +P'\x00HJ 00JCONTROL CHARACTER=,1,1, X2, 3X3, 4,4, 5,5, 6,6, 7,7, 8,8, t*49, n,A, 2x0b../0B, c,C, r*D, 2x0e.E, f,CONTROL CHARACTER '\x10' # 0x10 -> CONTROL CHARACTE,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, )" 2RSPACE! 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%Q%2SIX$Q$3EVE&R&E-L&M&$NI):3FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YCOMMERCIAL AT4A(\LATIN CAPITAL LETTER B1i1AL LETTER B p '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/ /R 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#7CONTROL CHARACTEGG\xc4,8PCAPIT4A WITH DIAERESIXH\xb9@SUPERSCRIPT OH\xb2**#TWh9\xcT EEACUT(b3f f5HRE,(d6, hOh (dc@ @U@Pu0385B8PGREEKfLYTIKA TONOl e0." 0EGRAVe|:CIRCUMFLER9\xe%#? '@2 (a8+ J8xe7$'CorCEDILLAc9\xeU5<SeO: wa9] twb?\y -a 9pPOUND SIGQ\u2129kTRADE MARK*8xeeYI|C9l ? 8u20jBBULLi '\xbd' $# 0x97 -> VULGAR FRACTION ONE HALF '\u2030' 383PER MILLE SIGN)0xf4')9)LATIN SMALL LETTER O WITH CIRCUMFLEX?6?A? DIAERESIS>a>B>BROKEN BAR%Pu20aceC%AEURO # before Mac OS 9.2.2, was SOFT HYPHE9IDKUSGRAVE8xfb:E: 'yF? 'Fu202 A0>UDAGGE#@0393# A1!GREEK CAPITASGAMMAAu039525HDELT58j359THE5?j45HLAMDjej55&XIa'62P20xdfbAYfSHARP 5[REGISTERED(xaoA\COPYRIGHT)Gu03aF8SIG aaV=5BIOTADIALYTIKd0xa7A["SEQ$Gu226Y7NOT EQUAL TOb%N$ DE)xbt MIDDLE DOTK1BI EALPHb3BPLUS-MINUSBLESS-THAN OR05OATER3!xa19YENF0392VBKYdEPSILOPk7PZk44 333BDKAPPRi&MUgm2$PHB3UldF2BF(PSyGxBF -> GREEK+ CAPITAL LETTER OMEGA '\u03ac' # 0xC0 -> GREEK SMAL3ALPHA WITH TONOS>&9d>1> s#NU2xnp22NOT SIGN#Vu039fU3# UgOMICRO7&a17474RHOjF2248353ALMOST EQUAL T*F03a4*6*&TAb173LEFT-POINTING DOUBLE ANGLE QUOTATION MARK)xbD8DORIGHEPu20269EpHORIZONtELLIPSI0xa0,A.NO-BREAK SPACE:5+WB)YUPSIL77C76CHIj8D38E@E6153FBTLATIN&IGATURE O62012DXtEN DASH6201@D<7BAR)D3I@:Fu201DE:6*DDk/SIk9DFk6 !xfhDRPDIVIS 8^Gg/ET&8aA>/IO?{;?:638eOB&Bah '3aq @aDz <=c=w =; }u;9c9E@ y bQE@uE03b2E37BETcrE2'PS bE1DELTA '\+u03b5' # 0xE5 -> GREEK SMALL LETTER EPSILON '\u03c65656PHI1&b3171WGAMMA37383(ET19191)IO2e2A2Xa0B0HKAPPb3C3HLAMD3c3D3'MU)d0E0N0f0F0YOMICR05/F05P+c[/F10OMEGA WITH TONOS&c1n2>7RHO1`/F318SIG`&c4d43(TA881*)THcF(2f*lFINAL 0F0CcF0UbF3Z5F5 DIALYTIKcCFCD9TL ANDbKo N!xaF: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'):,creturnoB=,2ingJ)o?o*B ooIncremental$er  h final=FalseC):  return codecs.charmap_en(input,self.errors,ing_table)[0] class IncrementalDe> r(>cs.Qdef d,(d", p final=False*@:FStreamWriter(C,zDpassORead9 9D### 4s module API getregentry(7 UInfo(name='mac-iceland',j!e=62().i:'r=Er/J //svr==J #w##@) P[Ping TJ5cod2 = -`'\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 11 11 11 11 11 11 7x191 8x1a, 11 11 8x1dD -> CONTROL CHARACTER '\x1e'  # 0x1E -> CONTROL C,f,F, )" X 20,RSPACEx! 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- D HYPHEN-MINU.'mFULL STOPK/$eTSOLIDF0"3[DIGIT ZEROG1%`%#ONt2$Y$#TWH3$T$3HREJ4&T3FOUk5%SK3FIVJ6%Q%2SIX7$Q$3EVE8&R&E-L9&M&$NI):%FCCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SKQUESi@(4YERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1LbM1bM1N11O' # 0x4F -> LATIN CAPITAL LETTER O 'P'# 0x501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/IC.REVERSE SOLIDU]) *D*?IGHY^/E/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALGAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/N /L/m//M/n//N/o/p/7^q/r/s/"t/u/v/w/x/y/z/TER Z '{#' # 0x7B -> LEFT CURLY BRACKET %+'|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F CONTROL CHARACTERzG\xc4, 80,LATIN CAPITETTER A WITH DIAERESIS@5@1@ RING ABOV(c7A2ACuCEDILLA9>3>E>EACUTz(d1<4<N< c(d6<5<O< 7(dc@6@U@e7@ySMALL L (e0z8: 6GRA(e2:9: CIRCUMFLEXejA? 1(e3}w e:e?e<(e8: a:9 tb??d> >I 9: et:-9? f9 >Bf9@ +f9: +f9:+f9?+9> f+ +9: +x9E -> LATIN SMALL LETTER U WITH CIRCUMFLEX '\xfc'  # 0x9F -> LATIN?DIAERESIS>'dd>&A0>eCAPITAYTACUTE<(b0<1<DEGREE SIGN&(a2&2&JCENT$3$3$ZPOUND%7%4%xSECTION'Au202r A5'dBULLET(b6H6!xPILCROWH8xdf'7'XeSHARP O(ae585REGISTERE9*9*COPYRIGH8u21A)TRADE MARK(b4SB*0 ACr(a8'C' Au226ED$NOT EQUAL TOKcKE'$ >A4d} 2OpTSTROK=Au221`BINFINITY'b1BPLUS-MINUS.0MLESS-THAN OR05\0GREATER3!xa1 B)YE)xb#[MICRO0BARTIAL DIFFEREN 'N-ARY SUMMA1*0**dPRODUC3Fu03cBKd&PIX&2b,INTEGRAL#0xaa! FEMININE ORDINAL INDICATOR5b5oMASCUL6 Au03am tDMEGAkeB fB 0!xb CVERTED QUESa1#IN1REXCLA 4'C8`(CSQUARE ROO &19C FCHOOKAu224$_]ALMOSWAu220~*INCREMEN!xaaLEFT-POINTING DOUBLE ANGLE QUOT bDEppHORIZON?WELLIPpaH NO-BREAK SPACE '\xc0 ' # 0xCB -> LATIN CAPITAL LETTER A WITH GRAVE 1X'\xc3<C< ETILD<(d5<D<Ox<Pu0152>E<IGATURE Op44F4~SMALL L262012 D02sEN DASHUu2014!D1"M"c"2" LEFT DOUBLE QUOTATION MARKWd535ORIGH68646kOSINGk 9555k6 0xf74! L D66PDIVISESIGN05ca*(7(dLOZENG0xff J8"~|YDIAERESIS`70179> @7204A@AFRAC)SLa%WEURO 8xd0 $ET@)xf3 1(ded1DTHOR)xf53E WEACUTbEMIDDLE DOT6201Ep_LOW-9NEG6 3f6PER MILLEcS  M CIRCUMFLEXxAAEA1E/  x(cb<I <} K!xcIK@  .GI xZ< 5BEw} 9@ d < dz< x< 2uf8=FApple logodF_ CAPITAL LET TER O WITH GRAVE '\xda'  # 0xF2 -> LATIN CAPITAL LET<U<FACUT<b<3< CIRCUMFLEX}9A4A Pu0131>5<ESMALDOTLESS IsVu02c6767MODIFIERv 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 MappWCB) mac_latin2 generated from 'MAPPINGS/VENDORS/MICSFT/MAC/2.TXT' with=.py. Written by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY.62000 Guido van Rossum. #" import sdAPIs class ($. 1): Adef e(self,input,errors='strict'):,&creturnoB=,4ingCoo*B ooIncremental{$er h final=False*Y.S 4[0]D(@Q`Stream1er(N,[5pasORead9 94ings module API getregentry(7 QInfo(name='mac-"%',i!e=52().ik:'r=~/J //sur<=I #cwriter#Writer, ) ### Decoding Table d _t = ( '\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%`%$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 AYB121B1C1vbC1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1;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\x7i7UDELET!"c4D!8PCAPIT WITH DIAERESIM`\u0100B@@SMACROu=1=A{ ;0xc99" x xE=5ACU< <ySOGONEH\xd6y =Oy 1#xd}  @U@e21 5z<: 2;H CCARON '\xe04'  # 0x8A -> LATIN SMALL LETTER A WITH DIAERESIS 3p'\u010d@>B>C>WCARON:6:C:eCAPITAz<WACUTE<7<D< :0xe98" E:E t7<:F: Z<ax<&90< :&0e:1: vDvb!xe&92< vI: &0fv3:tVu0112:4: b9MAC&13=5= ;N&96;xDOT ABOVR!xfy,7@ {O,1/98:x~/99>xCIRCUMFLEX !xf? 0xf5n>>FTILD/: /U/< ]b< :0xfc8 (Pu2020@xAdDAGGERb_ADEGREE SIG&18GdOGONEKcaAXPOUNDb!xa~xSECTION'AhdBULLETmbWANxPILCROWH!xd%o5dSHARP 2!xa50REGISTEREp*COPYRIGHTGu212TRADE MARK*1011U )!26 _NOT EQUAL TO_Au012'G>wCEDILLA<A< E y# 0xB0 -> LA,TIN SMALL LETTER I WITH OGONEK '\u012a' # 0xB1 -> LA;lCAPITA=dMACRON=F2264=2=ESS-THAN OR EQUAL TO05030GREATER3F012b343 F0136;5; KvCEDILLA&02>6>PARTIAL DIFFEREN /&11/7/N-ARY SUMMATI57014Y8*LdSTROKEe7013 9; = F013cA> K<d<B<zA&F013e<C<x :9:D:vHACUT,E<v :4F: vN f4v&C0> x<3C>!xaCwNOT SIG1CSQUARE ROOTe4CrVu0147q<C72207oINCREMEN!xadLEFT-POINTING DOUBLE ANGLE QUOTyD MAR)xbD~ORIGHEGu202pHORIZON2ELLIPSISQ0xa0xNO-BREAK SPAC 48+Ce;>1015e:c O(0!xdlCGTILD5Cl:}:sC 62016DrsEN DASHFu201DX,EM"D>[RLWDPL6D` EFk D[k(SI6ON MARK p'\xf7'  # 0xD6 -> DIVISION SIGN p'\u25ca*(7(tLOZENGE"F014d"8"ATIN SMALL LETTER O WITH MACRO]F0154;9;eCAPITA=R=GACUTw&55<A< w:8:B:v'CAF2039<C<SINGLE LEFT-POINTING A`QUOTATSDMARK17203SDDORIGHE7015EELv F0156F:dEDILLA1015:&E0>wC<%60z&E1< zS 62015 E2<y_OW-9 k&1er36@DOUB6F0161646\70155: bvv:!xc"   vAX<Fu016E <T< 6016E :!xc2 vIv 7>Z< 7d:6: Uv 0xd3 =%!xd<<CIRCUMFLEX6XF/F=R4BOV!xd4F6 }f7F< ^{Fu017mF tA 7ZA2UOGONE'10177~~ ;!xd!wATIN CAPITAL LETTER Y WITH ACUTE '\xfd'  # 0xF9 -> LATIN SMALL:Pu0137<:A:KtsCEDILLAvVu017b<B<eCAPITAxZ>DOT ABOVVu0141@C@L@WSTROK=&7c=D= {&22>E> G{ '2c5F>CARON ) ### 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$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'\x00s !007ONTROL CHARACTER=,,1, ,2, 33, 4,4, 5,5, 6,6,\x07' #  0x07 -> CONTROL CHARACTER '\x08' 0 # ,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, 5,5, 6,6, 7, 11 8x19X 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&T3FOU3%SK3FIVJ%Q%2SIX$Q$3EVE&R&E-L& 0x39 -> DIGIT NINE ':'# 0x3A -> COLON ; B GSEMI$<$C$LESS-THAN SIGM=)D)gEQUALS&>&E&|GREATERR?,F,QUESTION MARK@( 40(COMMERCIAL AT(A(1(LATIN CAPITAL LETTER A1B121B1C131C1D141D1E151F161FbG171G1H181H1I191I1J1J1K11CL1LbM1bM1N11PO11ObP151P1Q1Q1R1R1S1S1T1U1UbV1V1W1W1X1X1Y1Y1Z1Z1[1EFT SQUARE BRACKET$\\/75 REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,EOW L`#6YGRAVEJa'LSMALb/ /c/ /d/ /e//ER E 'f' # 0x66 -> LATIN SMALL LETTER F '0'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/4/T/u/5/U/v/V/w/W/x/X/y/Y/z/Z/{/EFT CURLY BRACKEG|-VERTICAL LINEU}(ORIGHV~.CTILDNB\x7f#O7CONTROL 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}wR> e:e?C WITH CEDILLA '\xe9'  # 0x8E -> LATIN SMALL LETTER E WITH ACUTE 0:8:F: FGRAV:a:/90: CIRCUMFLEXyb?1? DIAERESIS>d>2>Ic:3: e:4: f?5? (f1>6>NETILD(f3:7:O: (f2:8: +(f4:9: +(f6?A? +5>B> + C:U+/9D: + t+ ? +Pu2020-8AdDAGGERhb YADEGREE SIGN&a)AJCENT$AxZPOUND%7ocxSECTION'rKdBULLETbAA.xPILCROWH(xdAeSHARP {aAREGISTEREACOPYRIGHGu212TRADE MARKbYA0 ACraA!26ENOT EQUAL TOKcKeCAPITA]Aqd} 2sTSTROK=Au221`BINFINITYb BPLUS-MINUS.Au2260MLESS-THAN OR0<0GREATER3!xa1B)YE)xb#[MICRO0BARTIAL DIFFEREN  '\u2211' # 0xB7 -> N-ARY SUMMATION '\u220f' *8*tPRODUCT(F03c0(9(GREEK SMALL LETTER PI0F222b0A0INTEGRAL#0xaa!{B# FEMININE ORDINAL INDICATOR5b5C5oMASCUL6 Pu03a9mD6eCAPITATOMEGAk e63E5ZLATIN$AE0(f80F0O WITH STROK;bk C0;INVERTED QUEST MARKl'a1l)C11REXCLA 4c424wNOT SIG1`( C3#SQUARE ROO 0192K&4&F4HOOAu224$959ALMOST EQUAL TO~*6*INCREMEN!xaa5LEFT-POINTING DOUBLE ANGLE QUOT bDORIGHEGu202pHORIZON[ELLIPSIS!xaHNO-BREAK SPACq) g AiFGRAV<3<'< ETILD<(d5<-<<Gu0154IGATURE Op48262012D/sEN DASHePu2014TD ,EM"">5/WdW /6D0 EFzkD,k/SI60xf7D8DIVISION&5cD<TOZENG(xfD Y|fDIAEREGu017>1@7204%AFRAC)SLa%JEURO'03K E0)Gu2031DE1fb0tTFG6fb0PDFVu2021' # 0xE0 -> DOUBLE DAGGER '\xb7' # 0xE1(@MIDD(#OT%Pu201a'%2% SINGLE LOW-9 QUOTATION MARK6e6366 &30646PER MILLE SIGN_0xc2' 5)LATIN CAPITAL LETTER A WITH CIRCUMFLEXAA6AEA17AUACUTE}b<8<}DIAERESIS@8@9@ FGRAV|d<A<I 5B< vf}CA c@D@ (d3<E<O(d4<F< Auf8fEFApple logodF F<UF< 7xd9FA Au013JESMALDOTLESS I,Pu02c6u7MODIFIERe ACCEN102dH<mETILD)aFTMACROAu02dG5BREj  jyDOT ABO$$RIRING%!xbg6vCEDILLAdGn. UOGONE102c! 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): sAdef e(self,input,errors='strict'):,bcreturno.B=,4ing(CoAoeturn codecs.charmap_decode(input,errors,ing_table) class IncrementalEn6 r(>cs.): def e,r(self, h final=False*.sreturn U@:F.?[0]De'@StreamWriter(Codec,DpassORead9 92###ings module API getregentry(7 QInfo(name='mac-romanian',!e=72().im:.r=f/J //swr>=K #w##@) Q[Ping T,K5cod2 = .`'\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 3x1a, 0x1A -> CO NTROL CHARACTER '\x1b' # 0x1B -> CO,c,C, d,D, 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_+#GPLUS,$~2MMA- 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@(4YCOMMERCIAL AT4A(\LATIN CAPITAL LETTER B1i1BbC1v1C1D11+'E11F11FG11G1H11H1I11I1J11J1K11ML1 0x4C -> LAT IN CAPITAL LETTER L 'M'# 0x4D -> LAT1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V161V1W171W1X181X1Y191Y1Z1A1Z1[1B1EFT SQUARE BRACKET$\\/ 5C.REVERSE SOLIDU]) *ORIGHY^/CIRCUMFLEX ACCEN_,rOW LINE`#6YGRAVEJa'ESMALAVb/ /B/c/ /C/d/ /D/e/ /f/ /F^g/ /G/h/ /H/i/ /I/j/ /J/k/ /K/l/ /m//n//o/p/7^q/r/s/"t/u/v/w/R W 'x'  # 0x78 -> LATIN SMALL LETTER X &0'y'/9/Y/z/A/Z/{/B/EFT CURLY BRACKET-|-C-VERTICAL LINE(}(D(ORIGHV~.E.CTILDNB\x7f#F CONTROL CHARACTERzG\xc4, 80,\PCAPIT^A WITH DIAERESIS@5@1@ RING ABOV(c7A2ACuCEDILLA9>3>E>EACUTz(d1<4<N< c(d6<5<O< 7(dc@6@U@e7@  (e0zM:6GRA(e2:X:CIRCUMFLE9\xejh? 1(e3}w> e+e?e<(e8: a:9 tb??d> >I 9: et:-9? f9 >Bf9@ +f9: +f9:+f9?+9>TILDE '\xf0a' # 0x9C -> LATIN SMALL LETTER U WITH ACUTE /X'\xf9:D: FGRAV:b:E: CIRCUMFLEXyc?F? DIAERESIS>Pu2020@ A0>cDAGGER!!xb" !1!EGREE SIGN& a2E&2&JCENT$3$3$ZPOUND%7%4%xSECTION'r5'dBULLET(b6H6!xPILCROWH8xdf'7'dSHARP 48xae585REGISTERE A9*COPYRIGHGu212A)TRADE MARK(b4}B*0 ACr(a8'!26ENOT EQUAL TOKGu010eCAPITAA5BREAu021c <S<COMMA BELOW # for Unicode 3.0 and later1221^BINFINITY#7xb1BPLUS-MINUSYAu226[MLESS-THAN OR@2265\0GREATER3!xa1&B)YE)xb#[MICROBARTIAL DIFFEREN Au221N-ARY SUMMA\*0**dPRODUC^Fu03c:BK'&PIX2XINTEGRAL#(xazB FEMININE ORDINAL INDICATO 5oMASCUL6 Au03a SOMEGA5 o :"!xbRCVERTED QUESD!xa 1#IN1REXCLA 4bC(cC SQUARE ROO7&19JCnF CHOOKFu224GC^ALMOS1220INCREMEN!xa7 -> LEFT-POINTING DOUBLE ANGLE QUOTATION MARK '\xbb'  # 0xC8 -> RIGHT-POINEPu2026GE9EHORIZONTAL ELLIPSISs a0, sA.NO-BREAK SPACE)c)B)LATIN CAPIZLETTER A WITH GRAV<3eC< ETILD<(d5<D<Ox<Pu0152> E<IGATURE Op44F4~SMALL L262012 D02sEN DASH<Uu2014!D1"M"c"2"DLEFT5/Wd535/68646k/SIk9555k6 0xf74] D66PDIVISESIGN 05ca*t D7(dLOZENG0xff J~|YfDIAEREGu017> @7204%AFRAC)SLa%YEURO '03K E)Gu2031DE7021EVTVCOMMA BELOW # for Unicode 3.0 and later1021H\)@2021\Er^cDAGGER(xbExMIDDLE DOT%E{L_LOW-96e|6 3G|PER MILLE%!xcEpnCIRCUMFLEXxQA{AEAbAEACUTc< p} !xc@@ l<I << v0xEC -> LATIN CAPITAL LETTER I WITH DIAERESIS '\xcc'  # 0xED -> LATI@TGRAVE<(d3<E<O|FACUT<4<F< CIRCUMFLEX}Puf8ffC F0AApple logo%0xd2# F1% a<2<Ub<3< 8xd9A4A Pu0131>5<ESMALDOTLESS I,Vu02c6767MODIFIEREv ACCENT<dHs7<mETILDa8&gMACRONG89!5BREq2u02gA yDOT ABO$$B$IRING%!xbgC%wCEDILLAdqDOUBLE u fOGONEKO&c7O CA) ### Encoding table e_ =codecs.charmap_build(de3$ ) """ Python Character MappWCB6 mac_turkish generated from 'MAPPINGS/VENDORS/APPLE/TURKISH.TXT' with9P.py. v#" import ssAPIs class ($. 1): "Adef e(self,input,errors='strict'):,creturnoB=,4ing&Co?o*B ooIncremental$er h final=False*Y.S 4[0]Da(@QStreamWriter(N,[5pasORead9 9ings module API getregentry(7 QInfo(name='mac-%',j!e=62()., incrementalencoder=IncreE3, i-de/D/streamreaXS R #rwriter=#W #) ### [ing Table ~Ping_tA = (a'\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.XB, 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&%&wPERCENTM&'AMPERSANDq1"'" APOSTROPH(ILEFT PARENTHESISP+')+ORIGH,*,rASTERIS_'+' # 0x2B -> 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):%A%CCOLOk; CGSEMI$<$CLESS-THANl=)LXEQUAL>&K|GREATERR?,SQUESTION MARK @(4YERCIAL A4A(\LATIN CAPITAL LETTER B1i1BC1v1C1D11D1E11F11FbG11G1H11H1I11I1J11J1K11CL1LbM1bM1N11O11P151Q1QR1;S1jT1U1UV1V1W1W1X1Y1YbZ' # 0x5A -> LATIN CAPITAL LETTER Z '['q# 0x5B1EFT 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/ /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/{/ZCURLY|-`VERTICB}(RV~.CTILD~3\x77CONTROL CHARACTEGB\xc4O,8 A WITH DIAERESIXH\xc5@@RING ABOV(c7A ACcCEDILL%H\xc9> >E>EACUTz(d1< <N< c"d6<# 0x85 -> L ATIN CAPITAL LETTER O WITH DIAERESIS '\xdc' # 0x86 -> L@U@(e1@7@ESMAL~A>TACUTEz(e0:8: FGRAV:2:9: CIRCUMFLEXy4?A? 1(e3>B> FTILD5:C: RING ABO7?D?CjuCEDILLA9<E<E< 8:F: a:/90: b?1? d>2>I/93: et4: f?5? f9 N f9@ f9: +f9:+(f6+?+9> + + +9: + :+ ? +Au202AdDAGGERYb ?ADEGREE SIGN&a)AJCENT$AxZPOUND%AcxSECTION'rKdBULLETbAA.xPILCROWH(xdAeSHARP RaAREGISTEREACOPYRIGHGu212TRADE MARK '\xb4'  # 0xAB -> ACUTE ACCENT '\xa8' 'C'DIAERESIS$Pu2260&KD$NOT EQUAL TO'0xc6%rE'LATIN CAPITAL LETTER AE2d}F2O WITH STROK=Pu221eq B0=INFINITY` b1! B1#PLUS-MINUS SIGN*4,M2*LESS-THAN OR05030GREATER3!xa1438YEN)xb#5#XMICRO%Vu2202{6%PARTIAL DIFFEREN 17/N-ARY SUMMATIO&0fY8*dPRODUC3Fu03c B9(GREEK SMAL&PI&2bXA0INTEGRAL#0xaa! FEMININE ORDINAL INDICATOR5b5oMASCUL6 Pu03a9m TOMEGAkeB fB 0!xb CVERTED QUEST MARKa1#IN1REXCLA 4c4 1`(CSQUARE ROO &19C F4HOOAu224$_]ALMOSW~*hINCREMaLEFT-POINTING DOUBLE ANGLE QUOT bDORIGHEGu202pHORIZONVELLIPY!xaHNO-BREAK SPACxq) g AiFGRAV<3'< ETILD<dC-<<Gu0154IGATURE Op48262012D/sEN DASH Fu201D ,EM"vD>5/WdY5 /6D0oEFT SIkD,k6 '\xf7'  # 0xD6 -> DIVISION SIGN '\u25ca'(7(sLOZENGE"0xff J8"ATIN SMALL LETTER Y WITH DIAERESIS>Pu0178@9>oCAPITA@&1e@A@GDBREVAu011|B< :&30vC: IvxDOT ABOz&31@D@ zDOTLESS I-5E7 wSwwCEDILLA>F> u<6202 E0<DOUBLE DAGGERd0xb7  E1(@MIDD(#OT%Fu201T E2%SINGLE LOW-9 QUOTATGMARK6 E366  E46PER MILLE8xc25)L \A\IRCUMFLEXx(RAEAbAkDACUT8xcb } !xc|@5GRA8xcd|  x <CvA 8xcc (d3<O (d4< x< 2uf8yFApple logodFf ZF<UF< 7xd9FA Fuf8aFundefined1Pu02c6c?MODIFIERe ACCEN102d6<CETILDaFUMACRO[102dvGt 2 XI!2d$@IRINGn!xbgxFC -> CEDILLA '\u02dd' # 0xFD -> DOUBLE ACUTGCENT.b.E.fOGONEK!&c7!F!CARON ) ### 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"_B_StreamWriterYKC CLReadCCxCOings module APIgetregentry(GA)QInfo(bRname=,c"e==i2'r=e]/J /^ssr0=l) #.#er## ?oem?"""K5oem Heq;/dPu [Bencode class StreamReader(codecs.): der = oem_  ### encodings module API def getregentry(Fpreturn K@cs.CnQInfo(cgname='oem',b"e==incremental26r=IE/er/J /D/s.r.='R#cwriter#W #) """ Python Character Mapping  for PalmOS 3.5. B ten by Sjoerd Mullender (s@acm.org); based on iso8859_15.py. {#" importxAPIs class[ (self,input,errors='strict', charmap_B=,ing_table) oo)B oo/e h final=False*Y.S 4[0](@Q+1er(M,5pas9 9Enpalmos2().$e=@T2 = `'\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' # 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?,F -> 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//TTER J '3k' # 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#7TDELET!Pu20ac#!8EURO SIG@\x81"" $`\u201a&$ SINGLE LOW-9 QUOTATION MARf\u01926F WITH HOO9F201e9ODOUBo F20266HORIZONTAL ELLIPSI(&20.SDAGGEx! (702cwMODIFIERCIRCUMFLEX ACCEN7d3PER MILLEGu016)@CAPISMDCAROVu2039EFT-POINTING A5IGATURE O}'66BLACK DIAMOND SUI 6663-LCLUB*5**\HEART+69+ZSPADE+5018V9L*6201Z96 9k^kdk6 29DBULL1w9EN DASH '\u2014'  # 0x97 -> EM DASH '\u02dc' "8"SMALL TILDE&F2122&9&TRADE MARK SIGN*F0161*A*bLATIN VLETTER S WITH CARO:0x9b8B:^ 53&C$ ^IGATURE O0x9d0VD2 V8x9e$E$Pu0178&zF$zCAPITAL YDIAERESIS0xa0> A0@NO-BREAK SPACa?)1)INVERTED EXCLAMATIONz]424HCENT!xa9$3$ZPOUND%44%CURRENCY(5(5(:YEN#6#6#BROKEN BAR7%1SECU!xa{a9KCOPYRIGH a) FEMININE ORDINAL INDICATOALEFT-POINTING DOUBLE ANGLE QUOTi+NOASOFT HYPHE*aAREGISTEREf7MACubBiDEGREEbBPLUS-MINUS*BSUPERSCRIPT TWObB *5HREbBACUTE ACSBZMICROBzPILCROW'BMIDDLE DOTqBuCEDILLA"B&ONBoMASCUL bBbBVULGAR FRA ONEARTEbB6EHALFeB 3T1 QUk>bBAQUES2jcCAEGRAVcC< xC< CIRCUMFLEXACA (xc'C4 -> LATIN CAPITAL LETTER A WITH DIAERESIS '\xc5'  # 0xC5 -> LATIN @RING ABOVEA6A6A27272CuCEDILLAp8>8>E>7GRA9<9< FACUTa<A< CIRCUMFLEXbABA c@C@Id<D< e<E< fAFA 'd0@/D0@ETH (Icelandic)x(d1?1?N8ETILD(d2<2<O< m(d3<3< t(d4<4< tdD D<DMULTIPLICATION SIGNDnVSTROKDUD< D<DAdDY D_THORNRDESMALrSHARP S (GermaneE > ReE: eE:eE? LeE: eE>RING ABOVE p'\xe6' # 0xE6 -> LATIN SMALL LETTER AE %07070C WITH CEDILLA<8<8<E<FGRAVv9:9: FACUT:a:A: CIRCUMFLEXb?B? DIAERESIS>c>C>Id:D: e:E: f?F? 'f0>/F0>ETH (Icelandic).(f1=1=N.ETILD(f2:2:O: Y(f3:3: h(f4:4: h(f5?5? FFDIVISION SIGNFfVSTROKFUF: F:F?TFY F_THORN2Fy) ### 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): PAdef _e(self,input,errors='strict'):,hcreturnoB=,4ingCoo'strict'):   return codecs.charmap_de(input,errors,ing_table) class IncrementalEn6 r(>cs.0): vQdef e,r(self, h final=False*.@:F.?[0]De'@StreamWriter(C,TDpassORead9 92###ings module API getregentry(7 QInfo(name='ptcp154',!e=22().ih:.r=a/J //srr9=F #w##@) L[Ping T'F5cod2 = )`'\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 0x1C -> FILE SEPARATOR '\x1d'  # 0x1D -> GROUP*e*E*oRECORD+f+F+LUNIT) &" ~ 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- 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+'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 DELETE (DEL)u`\u0496)' 80'CYRILLIC CAPITHE WITH DESCENDERE2E1E GETSTROKVu04eeB2B UgMACRON3@3@ 72014@ DOUBLE LOW-9 QUOTATION MARKv7202=56pHORIZON7ELLIPSIS.704b.6.kC&ka7E ASTRA@U8= "HAgZ19DS-&a0eBASHKIR KAes=I "a@@"ENA&9aDK@bDD7SHH&b8{7C=f l%97K9 ZI 62019LoSINGLE.&19x6 c6k&1d5k6 2#9DBULLV\u201f9tEN DASHF2014y)EM"704bD  ~b  F04a1    ;>  > b  B BE -> CYRILLI&C SMALL LETTER SHHA '\u04b9' # 0x9F -> CYRILLI5 CHE WITH VERTICAL STROKEI0xa0GI A0INO-BREAK SPAC)Pu040e+r A1)rgCAPITAORT U (Byelorussian)rGu045I2I G &083G Je545 BARRED O9;5; ZsDESCENDERDboD6D pSTRAIGHG 77ISECTION SIGNp 01)p8'I!xaY\95AOPYR ^dA) DSCHW0xabaB8LEFT-POINTING DOUBLE ANGLE QUOTACMARK8xacDCD;NOT ef%D# hU!TMACRO;!xaE>pREGISTE 9h  "KAktBkDEGREEbB C 6B BYELORUSSIAN-UKRAINIAN IK  I9}KB IbeB  B !xb|xPILCROW}(xbyByMIDDLE DOT w uAu211uhNUMERO~Gu04d r Y pbpBpqBqNm&aab  b"ES2.wB&9d  4 Fu041C 4 C 4B\u0412' # & 0xC2 -> CYRILLIC CAPITAL LETTER VE '\u0413' # 535 (GH64646 D55555 I56565 Z7676 k8585 I?9494 hSHORT :a:A: 'KAob5B5 'EL5c5C5 M5d5D5 N5e5E5 O4f4F4 P%205/D05 &ERj&21515 S525U TUDU UiSDS 'EF5SDS HE2SDS (TSSDS C2TDT SVDV C8TDT HARD SIG2[D[ 8YER]D] LSOFTsdDd cDc YdDd Y'3dEdESMALM2aEa 2BV3_E_ 33]E] 3 3]E] 43[E[ 33YEY 3 3WEW 44TETILLIC SMALL #LETTER I '\u0439' # 0xE9 -> CYRILLIC SMALL 2YSHORT8a8A8'KAkb3B3'EL3c3C3M3d3D3N3e3E3O2f2F2&PE3%403/F03'ER31313S32323T3333Ue4242'EF35353H/&46363(TS7474(CH48484S6F6 C64F4HARD SIG4;F;8YER=F=LSOFToDFD CFCYDFD YA ) ### 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 = setc2stri.if 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@ 262Rjres digitab"abcdefghijklmnopqrstuvwxyz0123456789"generate_ lized_integer(N#13 G2) variable-length 9s0G = bytearray(-j |Lsif N < tQa2[N]e7M"s(2! Bt + ((N - t) % (36 )YN^"%//#jRadapt, first, numU"ifb//= 70kOelse 2u02+= %//cA# ((-`) // 21455)divisionJxW\> 455tB35 #hSW+U7 = H*5b + 38)Bias $tesBlen,Hcq4 Bias aycode parameters: initial bias = 72, damp 00, skew = 38 result = bytearray()>for points, delta in enumerate(1s):,Wy1gen_ lized_integer2,p6.extend(sTadapt;==0, baselen+"+19areturn"s([) def punycode_enS(textK", ed = segreg& = insertion_unsortJ?M $te`s(len(t)X!ifQase + b"-" +"n? # Decoding  0d4etnumber(n2post, error"""3.3 G variable-length Cs"""01 Cj = fhile 1#6try Ochar = ord[extpos]%except IndexE D#if == "strict"#Fraise UniPG("incompleteq A6ng"= + 1, None "= if 0x41 <= <= 0x5A: # A-Z;+@digi(-7 !elI*30I*39 C22 # 0x30-26K,(uInvalid DnR '%s'%;(-1:lse* l)2T(j?B += 5* w#if?< ti E8w * (36 - tmjh"1 |ca,m_endedi42 I Q4ing\/8I po-\j!72z s < ?1newX&? = >uD@sL # There was aning. We can't continue becaus# synchroniza is lost.'puN+{+0+= 6// ""if> 0x10FFFF:  if errors == "strict": raise UnicodeE1 ("Invalid character U+%x" %)D$ = ord('?'`pos = % (len(base) + 1$0 = [:pos] + chr(T+Upos:]s0biaXadapt(delta, (extiu== 0), mi!q newposNareturn} def puny0_dec(text,D)9if isinstance!3strS50 = 1.enHr"ascii"BmemoryviewIQbytesj@_rfind(b"-[B= -1DQ = ""extended = str\$, r.upper(mMelseJ4:*h [pos+1:]6)pinsertion_sort9$, h ### Codec APIs class(z1cs.1): self, inpu"='$' rem=7"P2res|sOsnot in (, 'replace', 'ignoreUnsupported handling "+# zjIncrementalE rtfinal=False*lD\ 0if &.J Rq 3StreamWriter(+,85pasdORead9 9@ings module|getregentry(7]QInfo(Xdname='%',g!e=3#()iI'r=D/J /Y/ssws=G #r]#P#Q) """ for quoted-printable encoding. This codec de/es from bytes to . """ import2sqquopri 63io $B@IO def #_a(input, errors='strict'): assertD == Cf = ZG)gr.rPf, g,tetabs=True( return (g.getvalue(), len_) de-Srpclass C(1cs. boself,  %TZZ"< 2) IncrementalE$er final=False* .O)[0]Dj$ StreamWriter(,.charbuffertype =1OReadLL #ss module APIYgetregentry(GnQInfo(bname='%',=<i]G.r=V/J //sw=T #rj#\#_is_text2ing!) Python 'raw-uniC-escape'0 zten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. #rcs ###sf 1): # Note: Bin these as C functions will result in$ 23notFconvertingmmethods. is intended.4$ =;Craw_R_Re.. #]9(9 y.raw_unicode_*escape_encode(input, self.errors)[0] class IncrementalDe0 r(>cs.): def d,(U#, bfinal=False*.sreturn Upraw_uni_KERStreamWriter(Codec,D8cs.wDpassORead9 9A### <ings module API getregentry(7 QInfo(.name='raw--%',#q!e==. # i8'r=Er/J //sywy=M #rc#V#) #!/usr/bin/env python """ P  Character Mapping  for ROT13. ThisFB de/s from str to0. ten by Marc-Andre Lemburg (mal@l `.com). import`0s 5APIL  o='strict'.3(str.translatrot13_map), len1)) -llK Jd   u01_ot-13/() 2().[_is_text"2ing)UMap # =.make_identity_dict(range(256))2@.upd{0x0041: eh 2f3&50415246: 0x0053, 0x0047:D54, 8596a7b8c9dae&41f2#5031#52#53#54#55#5650450&4b0&4c0%4d6&6e&6f&7070670670670670670670670670670666767070706706706706706706706706d, }) ### Filter API def rot13(infile, out ):.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 //sreader=StreamResader, streamwriter=S W #,) # # shift_jis_2004.py: Python Unicode Codec for SHIFT_JIS,?Q&ten by Hye-Shik Chang # import _[rcs_jp, multibyte as mbc =:A.get*('') class(%!s.!):  en" =}.dxPIncrementalEBtr(mbc.M l >cs.4 D 4 J Rem(T,!.^W/er^! ^^def getregentry(&breturn"QInfo( \name=`S9=#()H>iOI.r=/J //r ##_x0213#X,##J`d#oder,  incrementaldecoder=ID3, streamrea)S R #rwriter=#W #0) """ Python Character Mapping Codec tis_620 generated from 'py7"-m-s/TIS-620.TXT' with2`c.py. k#" import cs ###hAPIs class($.1): `def en(self,input,errors='strict'):,(creturno.charmap_B=,ing_table)oo)B ooEr  h final=False*Y.S 4[0]eN!@Q(N,A8cs.5pasU9 9Js module API getregentry(7 UInfo(name='tis^'f!e=22().l: l{/J //1[TF5cod2 = )`'\x00' # 0x00 -> NULLH11START 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(x1t1t DEVICE CONTROL ONE '\x@12' # 0x12 -> DEVICE CONTROL TWO "X'\x13-3-EHREE/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) &1 N 20)CSPAC! 1 EXCLAMAT3MAR"+LQUOT)#)NUMBER SIGN$&HOLLA&%&wPERCENTM&'|AMPERSANDq0"'"3 uAPOSTROPH(IfLEFT PARENTHESISP+')+pORIGH,*,tsASTERIS_+#rGPLUS,$uRCOMMA- lHYPHEN-MINU.'iFULL STOPK/$bTSOLIDF0"3[DIGIT ZER1%`%#ONt3Y$$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#'E1 # 0x45 -> LATIN CAPITAL LETTER E 'F'# 0x46 ->1F1G171G1H181H1I191I1J1A1J1K1B1K1L1C1L1M1D1M1N1E1N1O1F1O1P1/501P1Q111Q1R121R1S131S1T141T1U151U1V1V1W1W1X1X1Y1Y1Z1Z1[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/70 -> LATIN SMALL LETTER P 'q'# 0x71 -> LATIN SMALL/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 UDELET!'80! 80!H\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@cufffe'iAu0e0+A)THAI CHARACRgKO KAI0705 0YHO KH2E2C2#UA\T3R3HWAI '\u0e05' # 0xA5 -> THAI CHARACTER KHON '\u0e06262wRAKHANG57575wNGO NGU181810CHO9292Ia3A3 b3B3WSO SOc/C/'OE2d2D2JYO Ye1E1D)'DAcf2F2TO PATAK2%102/B02 HO9&11212NANGMONTH1&12828hPHUTHA53535XNO NE4040XDO DE%B%ITO T#B#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 2CE -> THAI CH$ARACTER HO NOKHUK '\u0e2f' # 0xCF -> THAI CH3PAIYANNOI3%303/D03gSARA A01010MAI HAN-AKAT62626fg3131Mb4141505016161'UE717128282b9090U1a1A1ePHINTH1Tfffe'> 60e3DURRENCY SYMBOL BAH 4E*4EP1EO60e4EI MAIMUAN9EA97ALAa4ELAKKHANGYAEM'MO$4EvMAITAIK60e4EEcE0(THE1R,b/EB1wCHATTAWU&4c6C6THANTHAKH&4d5D5xNIKHAHIe2E2iYAMAKK53E3XFONGM150F0DIGIT ZER[5*F**'ON"5"F")(TWRF)8HRET F +FFOUR75F*(IVTF*7SIXSF)7EVE5F+8EIG5F+)NIQF0ANG j5FARACTER KHOMUT '\ufffe' ) ### 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* Dg$;`Stream1er(,5pas3ORead9 9Lings module getregentry(7creturnUInfo(nWname=,h!e=2().Qi8:.r=1/J //strwriter=H #r^#Q# cu-escapeh# Note: Bin- hes C funcsresult inW1not# convert}0hemmethods. %.4$ =gu_N_**S0{= (.O)[0]crementalDecoder): def decode(self, input, final=False*.preturn /`cs.uni _escape_GAN.errors)[0] class StreamWriter(Codec,D8cs.sJpass9ORead9 9 ### encodings module API getregentry(7 QInfo(*cname='-%',m!e=9.  incremental86r=IE/er/J /D/suwu=hR#r_#R#) """ Python 'utf-16' 0 ten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s importp, sys 2s D# =&.utf_16_8(='strict'E9t, True)(k__init__M.C)N = None }9if J!isKRoresultxG&9f ys.byteorder == 'little'k2J#$le+OelseIbI8Pc4QresetI<./C.p rgetstatc!#  info we rto the caller+R# 0: 2 is in natural for this platform# 2: endianness hasn't been determined yet3(we're never 0ingu)unw0(2 D3elfr 6 0)s, H8kb .Dgcoder = codecs.utf_16_be_encode class IncrementalDe r(cs.Buffered"): def __init__(self, errors='strict')-U.K)jAa".d = None b_ Tinputw, final9if T!isUrA(outF consumed, byteorder) = \*p$ex 0 A&if_j == -1e *= p#lep W,elYXbX^ >= 2raise UniE ("UTF-16 stream does not start with BOM"}return &" (vx"=Qreset4 .7Khrgetstatek# additionalte info from the base qmust bee here,|# as it isn't passed along toHecaller1 B.5[0]D!we zD# 0:is in natural Z for this platformq1:)un<*2: endianness hasbeen determined yet3g(?6, 21add = int((sys.."big") !=r5+is)u )sx,b#[1] will^ignored by X65+?&[1h<F0H;I3$= 3d4 _6 el6ode`} y N ig"   else codecs.utf_16_be_de$) 1&:Rself.'r = None class StreamWriter(H8cs.)Jdef __init__(O1, s:, errors='strict'1wO.E c0.enBTQresetm )Z r[, input 9if N!is[2result =j d9^ ys.byteorder == 'little'c. m2le_p3(I bIrreturn c_(b( LRead1): h4.:tryL2del/fexcept AttributeE ;Fpass@K(object, consumed, U) = \#ex M, 0, FalseX&ifWP*-1 lj,elPO O:>=2raise Uni~("UTF-16 does not start with BOM" mq) ### $ings module API dgetregentry(tL@cs.CUInfo(name='utf-16',e"e=u=incremental26r=IE!/J /D)r/rg=, #w #-#) """ Python Q-be' 0 -ten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s importj2s B 9 L    <t, True)qwIncrementalEncoder): def encode(self, input, final=False*.preturn /cs.utf_16_be_B<I.errors)[0] class IncrementalDeC r(cs.Buffered"|!_b"!_d8. =kStreamWriteeWO OLReadOOOR ###nings module API getregentry(S qCodecInfo(name='utf-16-be',==i2'r=E"r/J //srA=: #w##) """ Python Ale' 0 -ten by Marc-Andre Lemburg (mal@l .com). (c) Copyright CNRI, All R s Reserved. NO WARRANTY. s import2s B l)9(50='strict'q#le  <t, True)on & ^ p   OROO6u Cl  $32 :"""R, sysn #32)/32H__init__5ZlEncoder.__init__(self, errors) .encoder = None Bdef :input, final=False):*J9if J!isK!%result = ncs.utf_32_f`G5[0]bAfys.byteor= 'little'k.J u#lex aOelseIbIrreturn c(4QresetoIncrementalE./C  getstatec!#  info we rto the caller+ # 0: stream is in natural for this platform# 2: endianness hasn't been determined yet3(we're never writingu)unw0(2 D5elf 6 0)s,H8kb .Dw class e Dey r(cs.Buffered"(>__i='strict')U.KWd !_b_ #, |+4r< A(outconsumed, U) = \x 0 A&if_j == -1a  p#lep W,elYXbX^ >= 4raise UniE("UTF-32Rdoes notrt with BOM" &" x"U Q padditional"teAfromRbase must be None here,  # as it isn't passed along to the caller 0 state = codecs.BufferedIncrementalDeQr.get-(self)[0]D# additionalQqinfo we z:7 0: stream is in natural order for this platform:1:)un<*2: endianness hasbeen determined yet30if ".dFNone;return (E, 2)?1add = int((sys.byte== "big") !=3Qacs.utf_32_be_)u !) d de,)#[1] will be ignored by s5i?&[1h6= 045elf33= ( 3d4 _6 Delse>ol: el^1NM _2_p  class SdWriteru__init__ , errors='strict'1/0.enAr = w8cs.k.a QresetmQ)[, input 6r{Fsultu4(d"^ #'little'. m2le_p/(I bI rec_(b  LRead&):+_4.)6try58delP)except AttributeE ;Kt, errors='strict'): (object, consumed, byteorder) = \*1codecs.utf_32_ex_de (input, errors, 0, False)=&ifWf == -1YRself.M0 = Tg#legN,elPObO:>=4raise UniE("UTF-32 stream does not start with BOM"}return m) ### encodings module API def getregentry(L@cs.CUInfo(name='utf-32',e"e=u=incremental26r=IE/er/J /D&/9reader=SFR R#Ewrit#W #) """ Python Q-be' cimportMi^2s n2be_ 9='sH g <, True) class T((6#, }bfinal=xB<I.O)[0]Buffered"!_b"fZkeWO OT OOO6[Bhl0l4X(crementalDec oder): _buffer_decode = cs.utf_32_le class StreamWriter(,W enO OLReadOOA### [ings module API def getregentry(SdreturnCodecInfo(name='utf-32-le',h"e==incremental26r=IE)r/J /D/srA=:R#w##) """ Python 17'  (ten by Brian Quinlan (b@sweetapp.com).Is importX M2s  "7_(input, errors='strict'7 8t, True)nxj>s(self, final=False*4 U>8E.O)[0]B'ed"x g! oS l_K Km@78 Marc-Andre Lemburg (mal@l  (c) Copyright CNRI, All R s Reserved. NO WARRANTY. %808[odecs.StreamWriter): encode = cs.utf_8_ class StreamReader((K de KR ###mings module API def getregentry(OdreturnCodecInfo(name='utf-8',==incremental26r=IEr/J /D/s9r9=2R#w##) """ Python a-sig' . This work similar to UTF-8 with the following changes: * On/~ a; d BOM will be prepended.`ten as_ first three bytes.a#@ing/a if31_ are ~,/Bse Xskipped.s import(h]s^(input, errors='strict'oBOM_UTF8 +Z  KB)[0]2len#")) eprefix = 01if e[:3] =m&# =.13:]?R3A(outconsumed) q, True)B I+j)2DX__init__(self'i>cs.M.C9Y.A= 1 z",I, final=FalseB0if &E9A + \#'dw>Jelse sLMQresett/Cigetstate^7s3!, ?3" =Buffered"YK 7U%!_b_> if len(input) < 3: if codecs.BOM_UTF8.startswith(:6E$# not enough data to decide if this really is a BOM~H=> try again on the next call4return ("", 0)#Oelseself.first = 09511if $|[:3] ==L(output, consumed) = \\utf_8_de[3:], errors, final E. w&+30$^>cs.m idef reset(()HBufferedIncrementalD'r.7KE!1 cgetstatef vn BYq!# C[1] must be 0 here, as it isn't passed along%erJ@(PF0], )s,~7@willignored by NX51] class StreamWriter(j 36try52delZ enwexcept AttributeE ;@R,='strict'w 3p& Y)>LRead>y>3>H>@>bif len #y/# u q/elF; Ft' ) re turn (output, consumed+3) # (else) no BOM present self.decode = cs.utf_8_*!ren#1(in&errors) ### encodings module API def getregentry():` \CodecInfo(name='utf-8-sig',h"e==incremental26r=IE/er/J /D7/streamreader=S R R#Ewrit#W #) """Python 'uu_n!' P - UUtent transferir. ThisB de/s from bytes to 0. vten by Marc-Andre Lemburg (mal@l .com). Some details were adaptedauu.py which was `Lance Ellinghouse and modifiedJack Jansen Fredrik Lundh. importsbinascii 3io &B"IO>BAPIs2uu_ ='strict', files',se=0o666rassert D == ? inD3 = k;out92 = ;.KJ7. # Remove newline charc) % =.replace('\n','\\n', r,4r')5f(('begin %o %s\n' % (m`v& 0o777_3)).'"')chunk = 2(45@whil2unk5r.b2a_uu(@L& Pw(b' \nendV .getvalue(), len)K,K,J 0? = 4Find start of@0ed <i1es;^(Vif not s)praise V2E('Missing " " GA in 6wy?if s[:5]QbI'aTbreak}FTrue0 R or sj:j :try15 = }0a2b}s"fexcept"Z as vJ # Workaround for broken uu rs%/k Lundh  nbytes = (((s[0]-32) & 63) * 4 + 5) // 3 0 data = binascii.a2b_uu(s[:O)])/#sys.stderr.write("Warning: %s\n" % str(v)8(iif not s:Zraise ValueError('Truncated input >1') 2return (outfile.getv;(), len(2)) class Codec(c!s. )z`def enb(self,k0, es='strict'..z3uu_8k2W/deW#8 WIncrementalEr final=False* ;.D)[0]YvDfUs 4;pStreamW!r( , 8cs.charbuffertype>1_ReadeLL 2###bings module API getregentry(IaQInfo(name='uu',=6 iK?'r=^/J //sr==J #r##_is_textl2ing!) """Python 'zlib_4'0 -  compressionr. ThisB de/rs from C"to 0. ten by Marc-Andre Lemburg (mal@l `.com). importds6# t~needs the optionalm*0! B7s8He cassertD == <l(O*Q)I'_%v0OS x .:TX/deX!: Xf__init__errors='strictS'):  assert errors == 'strict'"Tself. ) compressobj = zlib.1() /def encode(S, input, final=False"if@c = =` (Q)m-return c +8fflush(0Jelseo>rsQreset ?$class IncrementalDe- r(>cs.dy__init__|,=)1'de 2Ii..Oobj. <x5$ 2StreamWriter(Codec,  charbuffertype = bytes LOReadLL 2###ings module API {getregentry(I8QInfo(*`name='*%',=_ ,"de i37'r=,Esr/J /u/srC=5 #w##_is_text2ing!>) # Copyright (C) 2001-2007 Python Software Foundation # Author: Barry WarsawLntact: email-sig@pG.org """A package for parsing, handl and generatingI messages.""" __all__ = ['base64mime'4setsu@feed$eroh!EatorP _from_fil obinary /ngTk hquopriDutil)] # Some convenience routines. Don't import Parser M as side-effects # of/l since those cascadingly import most of the re " # email package. def message_from_string(s, *arg*kws): """Parse a ( into a MC` objecQdel. 4Optional _class and=ct are passed to^r constructor.E1""" .pr9$rreturn (5~str(s) _bytes'/ngvB  file(fppRead a &@ its_tentsv?(fp`inary_b-6%:""" Routines for manipulating RFC2047 encoded words. This is currently a -private API, but will beRqsiderediPpromoU |`public6! i rebdemand. <v # An e looks like this: # #@=?ch^t[*lang]?cte?!!?=1oq`nformas about C0 sebemodule. He8tTone #`preferEMIME8names (hopefully; you never know when ing). # cte (Con Transfer E#yeither 'q' or 'b' (ignoWe). In #Qory o/`letter0uldu  + in>in practic is # (al#?)happens. Th#coZ'a b adp entrieK:CTE tables<QYAGNI/Qnow. is Quoted Prin.,bBase64P mean$of4 sh`obviou'''Qo@ # a@dicaq byC brackets (they0notqsyntax)2is )# #)[untered in pratctice. # # The general interface for a CTE decoder is that it takes the encoded_string # as its argument, and returns a tuple (cte_Xd;, defects). > # %e original binary4was` using # specifiedQC. 'i'Na list of MessageD instances indicatPany # problemmu1`ed dur"conversionicharset''lang' arecorrespond:sAs extracted from+ EW, case preservedea8sequence Anputr0the5_JQwhich?n ascii-only EEach;must also supply a length functiontX Y Q!of4QresulKcmain APIsamodule", @calle # referG0d b4w!r,G2addFappropriatRFC 2047 "chrome" to>dbR`can op= alSputomatiaselect>shortest possible(ing. Sebir docps below # details. import re ebase64!in Qools \ E*_letters, digit)Temail(errors __all__ = ['f_q', '% .b. =lenB (VT !] f0QuoPrintable # ;@gex GdQ. _q_byte_subber =I.partial(re.compile(br'=([a-fA-F0-9]{2})').sublambda m: Y s.hex(m.group(1).())) def2_q(V1d):l" =Ced.replace(b'_', b' ')*D NP, [] dict mapp$ircm class _QByteMap(91): lsafe = b'-!*+/' +_.!('uC') +p NP__misE__(self, keys if@ in .![key] = chr(?Oelse/"={:02X}".format<X` 0Wmap =")`In headers spaces are mapped to '_'. _q_byte_map[ord(' ')] = def encode_q(bstring): return ''.join(Gx] for x in 5L?lenIlsum(leI)J # # Base64 #Y!de"b(d# First try ing with validate=True, fixthe padd if needed. # This will succeed only i#d includes no inc charactersHpad_err = A % 4gmissing_= b'==='[:4-;]s else b''=2try(b6B.b6420; + z,#)),H[errors.IP:Defect()&[]F)Pexcept binascii.EW# Since we had correct0, tis likely anw w#s  The non-alphabet are ignored as farDgoes, but don't know how many thereOQ. So}Bout +M_0seesit work8  [False;C6  #A# Ad[Dmuchdcould possibly be necessary (extra.:P$is) 37;! +'CGG F9_ ;E'hpns when52ed  'sgth is 1 moreO than a multiple of 4, whic8 :Lbpo-27397: Justv;! s)r'M0way_X/, eLength~3/_b#Q(&.!('"')M$ Jgroups_of_3, leftoveCadivmod8i2, 3@# 4 s out for each 3 `bytes (or nonzero fraction thereof) in. return groups_of_3 * 4 + (4 if leftover else 0) _cte_decoders = {HR'q': 2_q,bbc} def(Q(ew):*P"""DeQ0 end word and(string, charset, ladefects) tuple. OAn RFC 2047/2243V0hasb form:1 #=?[*ZS?cte?_|"?=-wC! ''' may be omitted but]oia parts#Tnot bThis fun0exp exactly such a u (that is, it does KPcheckiasyntax/raise errors4theNi?AwellAed),8sO0 d first from its Content Transfer E0ingTLn0V`result into uni0 us'specifiedT. IfPR cte-jdsuccessfullyYLaacter Q"a M is added toc`s listunknown octet8are replac y''0'vs\\uFDFFT oRuage aPed. 2pdefault(kPwhich`rarely  evncountered,qSemptyL1"""%_s@cte,~, _ = ew.split('?')3XR_! =@set.i4('*. te!te.lower(DQ# Recyoriginal 7bdo CTE2ingb5=. ('ascii', 'surrogateescape<,8= _c[cte](&T<2tryoR.(=aexcept U"EBs.append(1.UnIPableBD!!("eY"contains_aE>${} ".9%at)J |kLookupT $if]D != f-8bit'Q2UCu3("UJ {} QI9"inw;ced as pQrencoders = {  'q': encode_q, bb} _cte_)length = {1D9lenA>3deff (string, charset='utf-8', ing=None, lang=''):dA"""E @ using the CTE< that producesshorter result. OP"an RFC 2047/2243Jed word ofCRform:9!#=?*R?cte?"d_"?=-qwhere ''' is omitted unles'D' parameis given a value.Optional argument@ (defaults to L) specifi !seO#to binary beforZ]it. N'1ing5cteQr forh'should be used ('q'Nor 'b'); if it7 (X)OYwhichI#std sequenceTt, except!'qpreferred!upPqto fivezacters longer A '')PytDuage#to=Fy in1"""F!ifset == 'unknown-8bit'<b=d.e('ascii', 'surrogateescape')^OelseFb3i0is B~qlen = Nc['q'](I0b0P# Bia ward q. 5arbitraryNZ=0- bs@< 5  ~d4rs[G !if = '*' +Vreturn "=?{}{}?0=".r3at(X " ed) """Header-Hser imple'various email-rela~1parGrules. TheB6methods definis moduleb _ _ [ Princip"momb5322, i  followon to822 and primarily a clarificavIt also s mdecoding. !0 go=o considerable trouo maintain backlcompatibility withNqe phasele cleann!upstructure ooqe gener 9q. Thiser supports correct,9 by tagggwhite space as folding white space only when%is allowed in the non-obsolete rule sets. Actually,' parser is even more generousc`acceptinput than RFC 5322 mandates,0low(spirit of Postel's Law, ch? ?encourages. Where possible deviations from stord are annotated o'defects' attribute`tokenstUce. Thal structur/3he  foTs , and uses its terminology wt direct correspondence. #implement requires a somewhat differenttqused byformal grammar, new!s +Qmimic)closest exissQP. Thus, it re( helps to have a copyX2RFCChandRstudy`is codkI8o[$2str,Pat haready been uned accor5to ua"CthisAaie very firsO!ep +Rleave,~=@stepa higher level messag+Q will(2 alPdetecline breakfwat need`while 3Z~6`beginn0end~each header0out!ofhTList object0a lqsubclasQ />recursive data+efinal nodesS T*#als{<2strXse do noC U lyxs 1butqinstead practicalacombin&rus. All   'value' bproducga seman`ly meaAful =L atKYp subtreP.@ allb"te((no matter howyA-they may contain)c singlr, as perZa~TiPinclud'CFWS'0is 3in !a1al s reaone ex o  <`collap!Xinto *3Qs: inOa 'bare-quoted-Y' (a  with no leaor trail)di`appear0etw`z marks is preserved in the returned value. Note that"all Terminal strings quoted pairs are B@intoTRir un%VPs. AJokenList andXobjects also have al?, which attempts to b%"canonical" representation of RFC-compliant form2sub produced6parsed subtree, including minimal useI ing. Whitespace run" not collapsed. Comment t 'content'ribute provifound betweeparens (any nested csps) withS9@'defis a possibly 1y l ll6= le creatf!B. Df may appear on "/Wabpositev0of r  pvailablQroughS'all_5OV od.U(For "notes x.7g == x.H.) Each !a n jcalled a '!',,e55has_type' att#Qgivesname fromRFC 5322 grammar6 it6as. Not)-BnodePthereone non-2\bW: 'ptext'. A Cof printascii characters. It.Pin plb!ofsX (cc/-)== (qs. XXX:Ye3'le2} es. """ impor2 4sys urllib # For ..  Lhexdigitsoperator itemgetter Temail_encoded_words as _ew(Serrora A utils # # Useful constanpnd funcKs # WSP = set(' \t') CFWS_LEADER = |(') SPECIALS3 r'()<>@,:;.\"[]') ATOM_END"-|GX DOT_ -a.') # '.', '"p'(' do fend phrases_order to supBobs- } PHRASEh"T5= ( t/?=')) 1') TOKENR<A@(= WP"*'%"eTRIBUT4DEXTENDED_AT* %') def quote_string(value): return '"'+str.replace('\\', '\\\\')b"', r'\"')+'"' # Match a RFC 2047 word, looks like =?utf-8?q?someword?= rfc2047_matcher = re.compile(r''' =\?# literal =?T[^?]* # charset : ;:UqQbB]; 'q' or 'b', case insensitiveW5.*?S # encoded` \?=xP?= ''\2e.VERBOSE | re.MULTILINE) # # TokenList and its subclasses # c &(list): t<_type = Non syntactic_break = Truew_combine_allowedPdef __init__(self, *args, **kwgsuper().-'K&elf.defects = []f3streXp'.join(x) for x in )E?repF{}({})'.format1.__\__.__name__, m)@property@g!x.& C if ]Call_Lcwsum((x.) f!),Ajstartswith_fws_{elf[0].-GTas_ewg T0"""all top leve kens of this part may beA."""{9@all(3.} D}commentqX5.extend(+c)/Afold9, *, policyZ0_re) _p+S_tree41=Rpprin, indent=''Y 0.pp%KJ4'\nB_pp(L=SQyield '{}{}/{}(MyU S%U if not hasattrh, '_ppW@ + '!! invalid ele"U ;%   'list: {!r}'.format(token)) .Yelse:yield from 5._pp(indent+'!'Fif self.defectsMextra = ' D& {8QF'G'{})P!, 0) class WhiteSpaceTUList( 1): U@propertydef value()return ' '7comments:[x.content for x in@a if x.n_type=='J%']Unstructured Ezu4'JoPhrase; p%'H?ord2 FwordeACFWSnT Fcfws?OAtomp Fatom12 qHencode_as_ew = False!E/dWG"d-cte = NoneMxcharsetDlang_QuotedStringEq,!-s-i  x  == 'bare-q 59!x.6F_$ res = []SCs.append(str(x%re5''.join(res)Opped d#if$;IBarey 9t5~__str__7"4 )F<_R C( Aum([Po["("],# .96(x)&self],  [")"], ], [])) %def quote(self, value):/"if .token_type == 'comment'*.return str(IH .replace('\\', '\\\\')9W'(', r'\(7)7#)'@propertytqcontent ''.join(x) for x in AS0sT[=.x] class AddressList(T "):2 'a+b-list'!%exW if x$==h/']dmailboxdusum((x.'u  T)Eall_hy +2 display_nam!if{7[0]_group0elf2YHDz3|E[0]]i/elKinvalid-S LQ7/es  &XW BM8 B %[BCB  hJJ $('w<, 'R4)] 0G2.[,$aif not1 or4!= dg retusrn []  return self[0].mailboxes "@propertydef all_%(7!):Paif notM1 orUtoken_type != '?f-list'=A  class Group(TgbList):x= "group"/esG[2].PQ2f0> X$display_name'80].+NameAddr '`o-addr'_ bif len_ == 1cENone  local_partjeMF-1].*ComaiHd&DOrout %Bq__spec )OAngla) / rfor x i(Hif x@== '- d0x&A Aobs- ?ddr'   JOelse= quote_string(n) + x.ZRE'<>'AObsR ' u2[x.! } @== 'domain']  class Mailbox(TokenList): t_type = 'm''@property*def display_name(self):J0if H[0].U0= '.f-addr'.2ereturn6]local_part M)KodomainG %COrout?VsG__spec ( Invalid i.-)BNone2 = [1 = 5 = iD X'as_ew_allowed = Fals_P''.jo/uper().value.split())YtAtomh 'dot-atom'8OText<_-textETrueZNoFoldLiteral\ no-fold-l.^DYPAddrS -U +7 )pK GSif le O < 3,R[-1].Xv-u"a"0]o ~.rstrip()+4142#.l%_set = se|.n)J.1) >Y-DOT_ATOM_ENDSdlp = quote_!ng0eJelse=0 is not  Elp + '@' +&b@ObsLP Aobs-8-  aD NroPhrase>-name' ew_combine_allowed = False @propertydef display_name(self):.res = TokenListif len(res) == 08<turn res.value7res[0].tYP_type@l'cfws'Es.pop(0)?Jelse% iff?[0]T F[1:]lZ/-1?O-1][U=-1]F7:-1+ret6KUquote.y0if .defects/3'Trfor x inJ BFLif x Zd-string4$~) != 0 and + z prpost = ''*V P"==1 or q! hPl/' f Fg#i jApre+ _X. )+ Jssuper() class LocalPart(3"):x0 'l)R-part_as_ewV"J"30elf+_a6/0j_m\# Strip whitespace fromnt, back,around dots.fRU[DOT]!la9DOTm_is_tl4toka[0] + Q $lif tokgcontin @if (R@dot';?2U0 3D 0/isinstance(tok,/2f (3T  0tokj"= Xv.appendR else:  res.append(tok)  last = res[-1]_is_tl = res = TokenList(?V1:-1]]`returnY.value class DomainLiteral(D1): _tU_type = 'd-"-l.'"as_ew_allowed = False=@property)Bdef Aq(self):''.join(super().split())S,ipOfor x in gfjXif x.= 'ptext'(,x1MIMEVersion/ bmime-v,-major = None6minParametera p)^wsectionkextend`charsel'us-ascii'bW|_numbern# Because the first b, attribute (name) eats CFWS asecond #< is alwaysE0 if reEone.7B[1]./.?ed else 0O_ @Thisxapart o "handle quot^jIvs" hack 4strippedW9 X-:/ng` f(` _bare-e Am,-45.=$%''vInvalid 4i0-KA E   Z I.endswith('}#GCxS JVH |$! =/&[0v == 'cfws, C if token.token_type.endswith(  ('quoted-string', 'attribute extended-9)):Gqreturn o.Gpped_value($Rself. class MimeParameters(TqList): >W = 'mime-p/'#syntactic_break = False@@property+Adef ? s(# The RFC specifically states that the orde)# oIq is notca # guaranteed and may be re@Qed byO transport layer. So we hav=# to assume5 2231 pieces can come in any. However, wLQoutpum1we first see a given name, whichs@us a&ble __str__.k = {} # Using preservdict from Python 3.7+D2for\ ~ ifz".-''gcontin"ifP7[0]S8 != 7L<& =P'%()?1ame#inf s[Xi] = []E.append((.section_numb)iV,{ tsoN{.items(>parts = sorted(`, key=/getter(0`\_W" =hZ[0][1charset = 0. # Our arbitrary error recoveryto ignore duplicatexp,Npto use 9c ihere aIBrfc   Mgaps. This mimicVebof get"H;)otc2len^) > 18its[1][0] == 0%i&1].defectsJ_s.InvalidHeaderD#ZK'xR;3(s)+d'2C4:2"@# El)`*0* waosz`...notD is differenL#P, butregister " =tzearlier2 Yi = 0M 4.tsif section_number != i: $# We could get fancier here and look for a completeH duplicate extended parameterKignore the second onM'seen. But we're not doing that. The old code didn't.!if=.  (defects.append(errors.InvalidHeaderD#(tI'X fname; iOd'))Lcontinu.OelseT"inconsistent RFC2231numbering"mi += 1rvalue =F.'_ *#if% ?tryZ = urllibose.unquote_to_bytes(&except Uniz!Ent# source had surrog'qscaped s`. Wha} do nowP# is a bit of an open questio51I'm!sun_is isNbest choice, but itfw ialgorithmnP:`W0, e5ing='latin-1'k  )0.de(charset, 'eILookupE 0`# XXX:Qre sh]really beIbustom d]NNunknown acOset to make@easy_find,M because otherwise _Y_osilentL failurex1 = 'us-ascii'if utils._has_[.v !Un PableBF_par  = ''.join6 )`yield ," tdef __str__(self)as = []+D in self.params:  if value:  !params.append('{}={}'.format(name, quote_string(G9)))I?els[L6w = '; '.join(#return ' ' + 4 if s '' class PeterizedHeaderV(TokenList): # Set this false so thae& doesn't wind up on a new line evenJif it and thes would fiVre but notJ*QfirstN.Jsyntactic_break = F@property+$def(self)Pfor t in reversed%"if(.._type == 'mime-j'[68.*s%{}ContentType(R2 'c9-'aas_ew_allowedw@main(LBtext04subVplain)Disposition#dAs_3} = None+ransferEncodo(7#-e8 te0F7bit6YLabel6xh` -l+k _MsgIDT omsg-idN 2fol, policyE # message-idQs may}0be ;"edu/2str)kS.5sepMW1ID(s {VwInvalid?ICi/-KH # # Terminal &!esinstances #(D(str) ATrueew_combine:__new__(cls,p, = super().8,+ RyP.defects = []2elfsbrepr__ -"{}({})",!__h __game__,P&))elpprintc.RP + '/r) @property def all_defects(self):return list.(!) #>1_pp, indent=''A ["{}{}/{}({}){}".format(Fi@,.__class__.__name__%token_typeuper().__repr__() '' if not l else ' {}' D&)]pop_trailing_wR# This terminates the recursion.r{BNone]@property#{ocommen[__getnewargs__ B(str, SA)  WhiteSpaceT$l( /):Rvalue[ \2' '7startswith_f<ETrueV[,FFals/EW)$(@__st 5 ''_InvalidEwError(es.HeaderParseD3"""0 encoded word found while parsing hCs.""" # XXXse need to become 8*es and used as instances so # that a program can't changeT@m inQ treeLscrew # up othere s. Maybe should have tests forq, too. DOT = G '.', 'dot') ListSeparator*,* $-s%') RouteComponentMarke<@<r+$-c,!-m-') # # 0r #b strings accordto RFC822/2047/2 5322 rules.Huis a stateless0r. Each get_functiona2ept3su2 # As eiu$a }p or a T4 oQesent he object `d # byp methodantcontain=3rem un ed!racters # fromLinput. Thu,rbcconsumunext syntactic truct # of a given R!a AA plu0der]For example,&first ele;Cured 'phrase',Q1en:Y, value = get_phrase(value) # # returns the complete ph'Q fromstart of Qring D, plus any # characters left in0Qafter^is removed. _wsp_split&P= re.ile(r'([{}]+)'.format(''.join(WSP))).7 _non_atom_end_matcher J0"[^J"I@ keescapeXATOM_ENDS)_K_printable_find_\x00-\x20\x7F]").(2all?_token/_TOKENattributee/ATTRIBUTEiextended_r8EXTENDED_{ def _validate_xtext(!):"""If input m contains ASCII non-s, regisra defect.""" LO+1 = a2 if`_#sd.cs.append(errors.NonPXD(|$))_utils._has_surrogatesmpUndecodSBytesqaR"Non-0Pfound0hea`B")) Pget_p0_to~:siQ, endVScan */quoted-pairs until5C and2 un) k.This function Pa runqcent, c -without-comments, ord-g, into a single st#by@<S. Itj?,`remainAS1anda flag that is True ifpre werey o W@frag2, *s)= z1svQ = []( = Falseihad_qppfor pos,range(len(~)4if [pos] == '\\'&x  };OelseO 08?2inu2if J -el%in CUbreak6 2 {=1+ 1Ereturn ''.joTin(vchars), ''.join([fragment[pos:]] + remainder), had_qp def get_fws(value): """FWS = 1*WSP hThis isn't the RFC definition. We're using fws to represent tokens where folding can be done, but when we are parsOpS*un*f5has alreadyMPbeen C0 so< do@needwatch out for CRLF.1"""?1new1 = .lstrip()= WhiteSpaceTerminal(,R[:len )- M)], 'fws'F`return$, #encoded_wordM - = "=?" bet "?" ' `ed-tex*="bew = EnWmcif notstartswith('=?') raise errors.HeaderParseE(.'"expected1ed found {}".formatetok, *[2:].split('?=', 1/ if[# ='Zremstr =y(() > 1 and+[0] in hexdigits#1#tok.coung') < 2# The ? afterpCTE waslowed by anescape (=XX).+stQtok = + !stQ0if ) ew.defects.append({rInvalidD# ~wsy inside"")dew.cted6tryd,p, lang,A = _H' +xcept (ValuEQ, KeyOw_!Ew %fX" i'e: '{}'n;Det =0ew.! =0ext`while "3ext6WSP1en,44 = CS$$ewH continue. Q_wsp_f@ter(bC3v1 = I'._~Pate_x8(  -[#s should6fol WS if value a nd value[0] not in WSP: ew.defects.append(errors.InvalidHeaderD#(6="missing trail whitespace after encoded-word"))?return ew, def get_unstructured()8""" = (*([FWS] vchar) *WSP) / obs-+n)  = *((*LF *CR *(0ctext) )G2FWS?#c = %d0eNO-WS-CTL / LF / CR q is control acters exceptr/CR/LF.>So, basically, we have printable runs, pluVor nulls in0the olete syntax, separated by  . Since RFC 2047 uses theK8obsGHits specification, but requires\ on eitherLpside of\# #s, I can see no reason to needs;KEnon--P from* @! i{y occur, so wparse thiBAto xjtokens8BWSP Because an ''P mustq`defini.`stitutsre entir,'get' routine doesGa remain6@only 0d TCList1"""a# XXX:what about bare CR and LF? They might signal` start oP# end)an. YAGNI fQow, sfour current #rswill never sTus strings with5or 8rG = UJ(Rwhile^"if& " ! =3fws&R>~#Einue<m_ew = Tr.nsS('=?'L6tryx _o_0EwE[FFalsxEIBP[MNpfigure 0howPregisQB wheo# appropriate here._$2pashNelsev<_ws5xif len(^) > 0I28if *Q[-1]._type != 'fws'=A>Defect(  "missing whitespace before encoded word")) B have_ws = False(%if# and len(unstructured) > 1:6n8if *[-2].token_type == '-'FJ G1] = EWWSTerminal(A E~, 'fws').append(+vcontinu6tok, *remainder = _wsp_splitter(value, 1K0# S in the middle of an atom ifre is a rfc2047#ch does not" WSP on both sides. The defect will be registeredOnext time throughg loop.*This needs to onlyUpperform"hegvalid;Jotherwise, ? itQan in2  can cau#`parser gob@kfinite1if X@_ew h_matcher.search).partition('=?f vtP0= V F',_Pate_x6( ; # = ''.join(Fireturn def get_qp_cwAr""" = !otARFC @, since we are handlnested comments P`unquot-ed-pairs here. We allo0yth&A'()'Hcharacters, butfwe find any ASCII B thadefined N/, a NonPDad!toK#'ss list. SM `converC2ir  edues, whatOQed isM@a 'p!' x@. Iis case i5.a M, so it'scMris ' '.1"""_,&0, _>p_to_endms~#/ =}(,/ $ 2entC"""q@ = q#2 / {PM pDQUOTE KJ)NyJonPrintableDefect is added to the token's d#s list. Any quoted pairs are conver=!irP#un*values, so whap returned is a 'ptext'u. In this case itN)VJTerminal. 1"""D!, m, _ = _get__to_endchars("F'"')99 = ](8,*_validate_x$ 6c` def a.!):t1""" = We allow any non-ATOM_ENDS in 2P, buta an InaATextD1 tos if we findaT +qacters.>fmXnon_atomTW if not m\ raise errors.HeaderParseE(b'`"expecNfound '{}'".formatop)= m.group(p" =Q[len((1):]p 1, '! d|Rbare_s_string0""""-"-" = DQUOTE *([FWS] qcontent) A=qwithoutleading or trail white spacegt)!is7p betweeeb marks, a FEIpreserved and/zdecodedC#if0] != '"'("A'\"'' n  = BareQS=14#[[0] =<! =8.append(ERwhile4 y >fin WSPZnT #fwk&%elH":2'=?$e_ew = False:tryxQ |!en\_word3!)U\ XN"w wc insid"d &") 2:Truoexcept  {# Collapse~8wo at occur' # bare-quoted-string. if valid_ew and len(bare_quoted_4i) > 1:9D?if - [-1].token_type == 'fws'` CGt=[-2Gencoded-word')J 1] = EWWhiteSpaceTerminal(21],)7Jelse,Vue = get_qcontent(value=.append(E)bif notPj;tdefectsCerrors.InqHeaderD# "end of h" inside  "")_~return % [1:] defFcomm3""" = "(" *([FWS] cL") 1")"s%  = ctext /-pair / R 1We handle nestedps here, ?in our qp-]rroutineO"""O!ue>[0] != '('DSaise `ParseE @xpec '(' but found '{}'".formaWC = CW" =HRwhile 6")"fin WSPIY'!' is an intermediate class defined by thispr e RFC grammar. ItT&thtring without any attached CFWS. """quoted_string = QS!()#if value and a[0] inN_LEADER:*Ybtoken,( = get_cfws(CQ' x.append(<$ GYbare_8U Qbyreturn Q defCatomG0"""@ = [] 1*atext l1An %pcould b rfc2047 encoded word30= AsiBgATOM_ENDS! raise errors.HeaderParseE('"expectedbut found '{}'".formatb .startswith('=?')6try fh_h`oexcept [# XXX: need to figure 0howregister defects whenk# appropriate hereTFelse22%lc Z@dot__>""" dot-% =aT*(".")i* M` = DotGFText)3not"or , Qat a B of "Rwhile ?in  '$tb== '.'&N2DOT"\" =A[1:] if[-1] is DOTeg 0end r A'.'+) &dot-atom-text [CFWS] Any place we can have a dot atom,ould instead"n rfc2047 encodedOQword. 1"""@dot_I = DotAtom() if value[0] in CFWS_LEADER: btoken,( = get_cfws(9G'd.append(7f.startswith('=?')e&ry O? v_ ~ except errors.HeaderParseE [# XXX: need to figure out howregister defects when# appropriate hereq X_textFelse:SsB andK`returniQ def20"""! = / quoted-stringbEither!*or"Q may P PR. Weto peel off this` first determine which type of @?. AfterwardaspliceNthe leading~, if any, into pCad sub-.SIf nenais found beforeQnext special, a  is raisedoAThe   ed#q or a QSH, asThis means'-Q' levlformal grammarknot represent~n)"a tree;/abecaus\that extra layer manipulat#NHm6bconfus%Pan itshelpful &* #er 2b = Non0if @ 3(-'`"ExpecJ'''@S' but?nothing."[0]=='"'$ U_  .SPECIALSO  "a'{}'".e J!ifeB[:0] = []dqMphrase(value): """ phrase = 1*word / obs-%)1 = '!*(/ "." / CFWS) 0This means a^can be a sequence ofHs, periods, andHq in anyMorder as long it starts with at least oneQP. If?thing other thanOs is detectedv ObsoleteHeaderDefect%added to the token':Nlist. We also accept:tha% followed by a dot;Lt6is registeredan Invalid@, siDinot supportVOAeveno grammar.1"""(A = P!()2try!`, valu'@get_G(0'J.append(5!exrerrors.`ParseEhAdsI7({"?a does &%"")Swhileq1[0]4in PHRASE_ENDS"if2[0]=='.'{z2DOTj{ C"$'O'# =51:]Jelse =+,?z_LEADER,Lcfwsr+.e)K"comment foundBout atomu3_Uraise$creturn.` def olocal_part7- =M- / quoted-str, _@ = LlPklb = Non6! = !ift#5  - A"exp $bu'{}'".forma8 l@dot_Gm \`\'`,q!= '\\'<J raWise token = TaList() if leader is not None:>7[:0] = [)]local_part.append(+Uvalue and ( [0]=='\\' or qin PHRASE_ENDS)|Fobs_g,6z = get_V(str(+2) +-:if 3._type == 'invalid-obs-J-'Ftdefectserrors.IFHRD#(/>"G`u dot-atom, quoted-string,- &")7els_Z Obsolete$a  (contains CFWS)[3 t 6tryU0..encode('ascii'except UniE"EpHNonASCIILOPartAnon-? charactersvreturn _ def0"""s = word *("." 1"""@ Se = Obs last_non_ws_was_dot = FalRwhile#+"ifFK= '.1^ .]N" repeated"9% s2DOTo#K:Tru_# ="1:%AI'in3'el: VUTerminalX,h'misplaci{pecial' ("V outside of  /cD /_--t8! = NO-WS-CTL / quoted-pair 1We allow anyth,a0thelluded characters, but if we find8IASCII other than ARFC defined +, a NonP1 isN adw!toFs 'sJ list. Q s are converted 9i"unJs, so what is  ed 0a p o,@this case aV7Terminal. Ifure were\s, an Obsolete1"""J, had_qp = _#p_to_end0b, '[]'#9 = (1, '*#if^^  Pfoundmdomain-literal"_Pate_x1 W_check_for_early_dle", i_i_ 8"end of inp=Snside e @']',0S-end'4BTrueget_domain_literal(value): """ domain-li = [CFWS] "[" *([ rdtext) 3"]"$ EI_IDZLY!()%1if p[0] in kr_LEADERbtoken,( = get_cfwsG' p.append(=l2notH^ raise errors.HeaderParseE("expected"So!= '['Y'[' at start ofi% ""but found '{}'".format" =A[1:]Fif _check_for_early_dl_(1,}ukreturn \V^Terminal('[', '*b-"') 6WSPQs!G@:JFP I]!]?end6v ]4end%V3andqP A def)K = dot-atom /r / obs-@1 = 8Q*("." /))2 = lbq = NoneX06  ?if   h=/ O2if 1 is$T@[:0]-^+0 domain, value try:  oken, value = get_dot_atom()+ except errors.HeaderParseEO K#ifn2and [0] == '@'I_raisep('Invalid Domain'Aif l is not NoneSt [:m" [)]dE.append('Q .?tdefectsG+Obsolete3D$(v~"@`a dot-5 (contains CFWS)")52if 7A[0].Q_typeG@30F:] =<Rwhile K6DOT TPJ[1:]/N=!creturnPQ defaddr_specX)@""" - = local-part "@"L 1"""/I = AddrSTzQ_Qx D!ifJ"ore!.LKB with no"Fa6V#Terminal('@', ':ess-at-symbol'^95B|9obs_routeVAobs-0 = }-list ": @= *(mw / ",")4 *("," [6] [M"])OORAs anv the appropriate sub-s (that is,~MRthereN0in Lpq tree).8q = ObsR% <[0]==',' !inzs_LEADER_ %$V@Bcfwss'  (elu/, BListSeparatorn="1:  "expected but found '{}'".format ComponentMarkeldomain(value[1:]) obs_route.append(tokenwhile value and [0]==',':?CListSeparatorK(I=G51:]Bbif notX4Xbreak(E[0] in CFWS_LEADER6,P = get_cfws(=a "ifGsW== '@ @RMComponentMarke3bdomain3[1:- dB; raise errors.HeaderParseE("end of h pparsing-"a7W!= ':g "expected6P marka}"B"obsw but found '{}'".format) VTerminal(':', 'end-of-Y-3er'D`return/~Q def6angle_addrhA""" -@ = [`] "<" -spec ">"/h-3 JT D"""HD@ = AA/7S3h06 or98<8D{q#. $<$&Td-start # Although it islegal per RFC5322, SMTP uses '<>'qcertain# circumstances.g>. >4endC@tdefects!rInvalid(D#(>W"null'in"Q)8olh2tryY*T_T5oexceptP]aQa,.@ObsoleteAG' ification%hSc 6 "expected addr-spec or obs-route but found '{}'".format(value)) `angle_D.append(token!!, 8a = get._rN KI #ifA2and [0] == '>':?CdA[1:]Felse$gtdefectserrors.InvalidHeaderD#(Hb"missing trail q'>' on [- "")eV?Terminal('>', '&8S-end'<in CFWS_LEADERfHcfwsak 9Sretur$Q defdisplay_name[C""" - = phrase ; Because this is simply a ,-rule, we don't QG containyaf,rather a9 5BwithD!heBent of theD.1"""(B = DN.X" FE.ext 2[:]Gh." =[3 SgC = [E] 3M0 = RAddr(a# BothAoptionaly _txcan start  .(lne1one6THbif not8craise `ParseE  /5( W!= '< PHRASE_ENDSU/.^q2if q^7NonP[0][::" [0# ~_ 0* H} # qmailboxe): """ mailbox = name-addr / -spec """&# The only way to figure out if we are dealing with aYSor anJc0 isJtry pars9each one.,M!()Atry: token, value = get__g(5 except errors.HeaderParseEP]a\_&a,e,_raise(+"expected but found '{}'".formatif any(isinstance(x,srInvalid bDefect5n for x in na.all_d2&s):.$@_typ"'ig-' .append(2}dreturnQ defN_A, endchar""" Read everyth[ upmone of the 1=.@Thisqoutside,[l grammar. A TList that ised acts like a 3 , data attributesMNE : =  Swhile2and x[0] not&if%in PHRASE_ENDS$ V}TerminalA[0],7'misplacedRial')C# =51:]eJelseWCbphrase YD* )`mD_lis-C = (d *(",")) / obs-mbox+  = *([CFWS] ",")@N[]!/ $)PFor tproutine go3PorderAcimprov@hand. We recogniz84endoJa*e$O1t a ';' ("0grodAtor)"sospwe can AK{es into4 s )continue1anyJ`remainG4Ralso allowq entrierbe nullkconditionpH)ppropriately ahigher levelWn$ =Z and value[0] != ';': 6try  token, value = get_mailbox();._list.append(B' except errors.HeaderParseE }ly = Nonei"if[0] in CFWS_LEADERBF Ocfws0bif not`2 or i(',..z, 0tdefects3Obsolete%D$(I"empty elementc-.")Nelse/P 2zinvalid , ZD2if 1 isQo/s[:0] = [9]d P /hIg  Yi (elW== ',p (k n +,"F and5K!in( # Crap afterM; treat it as an .T# The; info will stbe available8!$ =<V:[-1q'.@_typ'-'+6$QO.ext7)".(/ ListSeparator'># =)"1:|ireturnOa defQgroupYA""" /% / obs-group-liCst obs-group-list = 1*([CFWS] ",")  01"""0_0G=aList()if not value:j3.defects.append(errors.InvalidHeaderD#(>B"end of h" before X""),breturn,QlAa= None"ifB and p[0] in v_LEADER@R = get_cfws( # This should never huemail parsing, since-only is aJ# legal alternative toUap, whichE@the Q LHplacW Iars.(wZ% i,r2nd(p& !f== ';' g0Ztoken1box1'qif len(2S.all_)fes)==0(^0ext{xA!ObsoleteD with empty entries  [:0] = []~f^+rA def?^2"""9 = display-name ":" [0_] ";",1 = '# "]_]E6 orW!= ':craise M`ParseE_("expected5C at M F"  but found '{}'".formatYEq VTerminal(':', '!-oX"-t"Ctor'V# ="1:  a ;u0[l|64ks.}!N"Helif value[0] != ';':  raise errors.HeaderParseE('."expectedB at end of group but found {}".format(value))G'.append(VTerminal(';', '!"-tCtor'9E1 = A[1:]O"ifB and [0] in CFWS_LEADERbtoken,( = get_cfwsQ4breturnFQ defIdaddresLtC"""  = mailbox /B pNote that counter-intuitively, anAcan be either a single!orP`a listyRes (ar). This is why the rBed A object hasP' es' attribute which treatsaalengthNone. When you need to differentiate betweentwo cases, extractRelement,&is! o. .z1"""Ba# The l grammar isn't very helpful w0par}$. Nn, especially>allowingn obsolet{ps, starfwMsimilarly. It$onNBreach oneP@, <,:R!CknowLwf you've got. So, we try H0in AwithwCmoreL`likelyuE0twoeld perhaps mak0is : efficient by lookingOfaphrasetm`branchbased onnext cha1er,tBLPwould* a premature optimization.)$ =(2try 012oexcept=LY]_*c,/O'{}'+#!: %_!*C = (EU *(",H@)) /;--H6obs` = *([e] ",")(N[?Qess /*"])`We depAfromn @herepcontinu0to qe until51end!ofinput, assum21he @ntirPQcompoAf anCalways truK e:0ing7!d m2s uto skip invalid addresses to parseitional va$ones. """7_list = AFaList()!Pwhile@1ue:>6try Roken,'s = get_Zb(valueL*u.append(tB'except errors.HeaderPE0 as l%u = Nonep"if[0] in CFWS_LEADERB,F Ocfws0bif not`2 or in== ','a5y( 0tdefects9#Obsolete+D$(M"R-entry with no content")7elsI 6!inv_mailboxA,YG2if 1 isT@/r[:0] = [9] n!([F]c :wIvd s(elQB"empty elementT 'j n 6V"F andM!M# Crap afterR; treat it#4an z."c# The  info will stbe available82=w|j[-1][0*._type = '-'+>#PO.extS9!: # Must Z , at this pointb ~VITerminal(',', 'list-separator')) value = A[1:]return address_list,# def get_no_fold_literal(C!):Ap""" no- -  = "[" *dtext "]") M = NoFoldL]bif noti raise errors.HeaderParseE(_'"expectedbut found '{}'".format~[0] != '[','[' at the start o 6'" K.append(VTerminal('[', '-# Stoken ! = *n;K2 orX]X.]X?endVY]V4endTY !O_cmsg_idWi"""msg-id = [CFWS] "<" id-left '@' right ">"% (= dot-atom-c/ obs-F-I. 6 @1A &  = MsgID(%6and"0in r_LEADER^JCcfwsA j5n<- <`L!# .?try6 @dot__?oexceptiTa#a is same as local-padd-spec9 Aobs_;_;1Etdefects#Obsolete+D$ 'C#"o'>0 in>G-id"ES/ (orP !8 gund '{}'".format(value)) msg_id.append(tokenqif not ,2 or [0] != '@':>BtdefectsJerrors.InvalidHeaderD#(:> "msg-id with no id-right"$# Even though there is.@, if local partfb# endsa`>` let's just(se it too and return;Ralong<Bthe .!"if=+"W== '>" hVTerminal('>', ' W-end'<Y" =kE[1:],!o @oaddress-at-symbolvnP# Par-6try = = get_dot_atom_texxsexcept &aE8Ta eno_fold_literalg2k V as ep1 xldomaino-2 ObsoleteC#"o+0 in8-id$, 0_raise /"expected dot--P, no--2Eobs-F" but found '{}'".fo } =7els issing trail \'>' oej`in CFWS_LEADERLcfws 5NR def*_message_idT|3"""b= "M/S-ID:"Q CRLF 1""":c_id = 22ID(  `O~S;S% xK9unstructures3 = 2FU P'N +"Ve: {!r}>3ex)B # V$alue after parsing a valid msg_id should be None.  if(5ue:message_id.defects.append(errors.In^qHeaderD#(BF "Unexpected {!r}".format(vA))) 3vreturn t # # XXX: As I begin to additional h~ers, I'm realizwe probably # have two level of7 routines: the get_XXX methods that a token in #*rammar, andL9e an entire fieldpp. So #\_address_list above lyadE, as. #)unstructured. # de_mime_version@""" - = [CFWS] 1*digit4"." 1"""T# The)is implicit he RFC 2045 BNFDThis is a bit verbose, factor out aE3intN = MIMEV)bif not70MishRequiredV "#|t number (eg: 1.0)")} 30[0]?v_LEADER,! =CcfwsGc ; =O$"E "but found only ,as = ''Swhile-a!= '.'!inP EY"+=M1[0]`@ "1:,81.is &() p3L (_major. jsk Terminal(4, 'xtext'7els% FS= int=M )o xp .duH!if,`.!isRa+ t$H "Incomplete MIME version; found only major number")) if value:mime_version.append(V'Terminal(5, 'xtext'Qxreturn B[Sc'.', 'v-separator]r" =A[1:]WC and0] in CFWS_LEADERbtoken,( = get_cfws;#bif notF\)if.r!is,?Nonc tdefectserrors.InvalidHeaderD#("Incomplete MIME A;digits = ''qRwhile imE+0P81.is &()c 4$"Expected.Tminor4 C but>{!r}".format('s) (4 )7els FE= inq7 )o x<&d>0cesU n- b after7 A def7i_SmeterD""" Read everything up to the next ';'. This is outside#rl grammar. The AParas TList that isPed acts like a 5,data attributes are 1"""O - =(' !=[PHRASE_ENDS$( f"A[0],9'misplaced-special6E z ' bcphrase  [FT +d t (value): """ttext = We allow any non-TOKEN_ENDS in 3, but add defects to the token'sIlist if we findTF characters.xso register[1forPQ*any*>printables even thoughRFC doesn't exclud0 of!m,Jqbecauseo`spirit*ER5322.1"""7m = _non_D_end;q(value)&if not m:R raise errors.HeaderParseE('+"expectedhgfound '{}'".formatopK= m.group(1 = Q[len((1):]p @ = VTerminal#1, ''I_validate_x?$Ureturj def get$  = [CFWS] 1*jm@The equivalen(!isUS-ASCII@sept space, ctls, 3tspecial`?tab? pimpliesF !isexplicit about it)che BNFGD<@ = T "ifB and 0[0]Dir_LEADERD$B,(! =mCcfwsl'm(.append( nm#! ) 6BAattr)@4"""d = 1*(RATTRIBUTEV)  04in X%'sIILOOfor ,Pothem, -_ibuteLhO{!r},+ 4, ' ) return attrtext, value def get_attribute(): """ [CFWS] 1*#< "This version of the BNF makes? explicit, and as usual we use aKy terminal for@0act+!ru`characters. The RFC equivalent ofLiftoken =a, with`@subtS'*', "'"A'%'.QWe include tab in<!exd set justRwe dov.)1"""IiiE = Au)"if%0[0]lDr_LEADER! =CcfwsQ'q.append(8q ATTRIBUTE_ENDSt raise errors.HeaderParseE(tx"expected q but found '{}'".format) u(bCCEureturn ZextendedcU0"""; = 1*(any non- plus '%')Xis a special parsing routine so thatmSget adOs % escapes a E`le strN`(whichEhdecode$G(klater)m = _non_ _end_matcherif not m'Q|"qfO{!r}m.group(" =BT[len(+1):]@ = VbT)4, '--'^_validate_x3ih [OB qis like3QexcepVvallow %$s,uwe can pick up an enCdHJn ?# XXX: should@haveHE\I TsQList?{b nEXTENDED_&N but found '{}'" .format(value)) token,  = get_extended_attrtex10ibute.append(AL#ifH2and [0] in CFWS_LEADER:FzCcfws'q ureturn #Q defssectionT|""" '*' digits iAThe 2l BNF is more complicated because leading 0s are not allowed. WeOPcheckQ` that add a defect) also assumF$yM betweenP1theI , though 0RFC>crystal clear on.Icaller should already have dealt with.%1"""EUC = S_K&or !=~ raise errors.HeaderParseEp("Expecsibut found {}"N RV Terminal('*', '#-marker'9E# =11:]!if&or a[0].is/()'pnumber { = ")as = ''Rwhile,<+074a== '0'e &0'y.$s'rInvalid.)"C 8has an i;#0"/./b= int(! /)2, ' *;, quoted-str\/ {Av = (J`^5rend of "ber = Noner6W ; HonlyH" _1$Felse: dP?!if$er} P[:0] = [v5r return v, v alue def get_parameter(v!): """ attribute [section] ["*"] [CFWS] "=" 5 4@The  is implied by the RFC but not made explicit in!BNF. ThisKs@fBtform of&Q from T"isOato con+Ewith 1BNFPthrough som|tra checks. We do it this way becausemakes both errorNrecovery and working x`resultparse tree easier.?1"""@# It,spossibl=would also beHcitly allowSRetwee7On'extended-' marker (!Q*') ,we've never sW#atP wi`e will^refore ignTRilityYE = Pa)Xbtoken,9! =(@.append(5@!ifGy2 orI[0] == ';'AtdefectsIs.InvalidHeaderD#%("Mbtains N"name ({})<"no} ".z#at)1qreturn "if:*6tryE>1/*l.!ed = Truev#Zbexcept"s. PE 2pas9 '_raiseR("Incomplete("C+ x VTerminal('*', *^- 'JR=?1:]5ZWW!= '= r$foyF =! se 4torlb = Non5!inv_LEADERLcfwsm4remainderBto =|"if .w "w# Now forserious hackto handle common i case ofP# douquotes around an K!acE(Pacd as encoded than't reallK7qstring, ?"d_ inner_value = qstring.stripped_value @semiid = Falsif param.section_number == 0:AHif innerIhue and0[0]4:"'"6: 'TrNelse4 token, rest = get_attrtext()N"if4= 0?tryextendednexceptUIpassaif notD!6if  =defects.append(errors.InvalidHeaderD#(v"Quoted 1ng T for seter is iT*")qL "SSt in  Qif t.KP_typeq'bare-q-V'9=t[:] = []oto = t!Ybreak =7 premaindF Non~)Pmarked as@but ars to have a ""H @thatnon-encoded#if& = ,IK(#'w"orz >;M2 orh=!= %Dndto' !isuaassert!~ v5 = " "breturn B7$"Apparensditial-Y-6ttribute.2"wan4or !inZ 8g8 # Assume the charset/lang~qmissing  I.7+Mjrequireddelimiters8 40aram, value else: if token is not Non"for t in(:B.D _type == 'extended-attrtext'8<UbreaktKB 'appendto. 9(t)param.charset = t.value$1if [0] != "'"raise errors.HeaderPLE("Expected RFC2231 j/lang encoding "m "delimiter, but found {!r}".format()VTerminal("'", '-^'AQ# =51:]C and',$t = get_U ?#J=q %!if"or1T^if remainder# Treat the rest o as bare quo0strcontent.Av = s(Rwhile NQjin WSP   K?fwsF(elPn"^P'"', 'DQUOTE'R 9i q/vvGc k c`\fassertUln& =Vqreturn 2@ defse_mime_Deter0"""& amh *( ";!) aThat BNF+meant to indicate this routine should only be called afterKf7!ngPhandl1lea';'. Thereono correspon qrule inM8ls gramma it?more convenienQr us K0he !ofL!@be ts its own T+TList. isf 'p'because it|sumes the remaining @value, but it would never be called to parse a full header. Instead it is .K2J ything after the non-parame of a specific MIMEg O1"""Umime_=s = MimePN1s()'awhile [:6try Roken,'f = get[(=N, }.append(tG*except errors.H-P@E0 as l%u = Nones"if[0] in CFWS_LEADERB,F Ocfwsbif not\Jau{return 6n== ';'v2if bN'r k? /tdefects7rInvalidD#(z" entry with no content")Nelse7 i +W[[:0] = [] O .C-Z {!r}".formatTH B and!Kg# Junkpotherwis&ids. Mark it as ## 0 wi av.1, =:[-1y(._type = 'k'[-( k?ext< ` trail_text  `# Musta5 at this point VTerminal(';', '~0-se Gtor'l# =k"1: def _find_Clist)"""Do ouh stc>s$an  if value[0] in PHRASE_ENDS: tokenlist.append(ValueTerminal(v [0], 'misplaced-special'))K,1 = E[1:]Oelsew,+ = get_phraser Y $bif notIcareturn,';', 'parameter-se 4tor @parse_mime_+7s)) def 'content_type_header+)""" main "/" sub `*( ";"F1 ) 6The10and1s2Aare s. Theoretically they couldDbe checked against"P offi` IANA 3Q + x-T, but we@don't do that.1"""c2= CRType(recover = FalsID.defectserrors.HCMissingRequired("#  fication"0 zH2tryQ1yexcept P*ELcrInvalidD Expected<found {!r}".format]_find '-# XXX: If we retwant to followal grammar, shB makB# ma alized TLists here. Probablysworth i`2 or&[0] != '/'5^"ifzp^0=..strip().lower 1 '/)-Y &U%j:r]; ctype.defects.append(errors.InvalidHeaderDefect( "Only parameters are 4 after content type, but "A found {!r}".format(value))))# The RFC requires that a syntactically iu-u be treatedPas text/plain. Perhaps we should postel thiswrobablyPo"do ifHwere checking the sub against IANA.KPdel c&P.main ,>*_find_mime_(<,&ueAbreturnIA'VpTerminal(';', 'S0-se Ctor' <]parseC[1:]3 @ def33se__disposition_hm:G""" #`*( ";"I|4 ) -1MB = CDi(bif not1n=!.d MissingRdJ "#"r#y6tryStokenq = get_-1sexcept PELiExpected+39w1 = -..strip().lower* "ifS[0] != ';'{;xZ I2|@ transfer_encodinglamechanismt6# WA&Qidate_rs, sinclist is fixed 3cteyTE AMissingRequiredValue( "Missing content transfer encoding"))2return cte_headerAtry: Xtoken, vkq = get_(Kexcept errors.HJ`ParseELh.defects.append(;rInvalidBD# Expected but found {!r}".formatOelseacte = ..strip().lower(5bif not6ho\while+r+'tra text after3"if[0] in PHRASE_ENDS 4Terminalo [0], 'misplaced-special'HH# =y51:]~ ,z bphraser)F?%b # # ~@ fol/ is complex, with lots of rules an rnsases. The #S2low de does its best to obey theHahandle coS@ # cU,you can be sur(re are few bugs:)@Thisder generally;onicaliz goes, preferrngified # versionCeach ntain in/that supportsder, inclupD whiSs edQways.bFoldedis accumula#pin a siP lists ('lines'), ` # one!``should{0lesan policy.max_<_length ('maxlen') def _steal_trailing_WSP_if_exists(="s)Nwsp = ''1if A J[-1]bin WSPBF2$Q" =^B[:-1eBwsp re _pf_tree( C, *,B"""RDYBz<}d!orbto RFC!. 1""",# f00/Nmeans no limit, ie:cinitely long.B# = `or sysAsize3e= 'utf-8' if@Putf8  'us-ascii`b = [''Rlast_ew = Zwrap_as_ew_blocked = 0Gant_zDFalsd1`not_al\5Terminal('', "'wrap_as_ew_blocked') parts = list(parse_treeRwhile#:.2" =b.pop(0-!ifp is endnnot_allowedC+U -= 1g$continuetstr = strty.token_type == 'ptext' and set(?) & SPECIALS# Encode if *  ains special characters.`want_e=ing = Tr*ryh\..!e(6ingPhdset = oexcept UniZErrordif any(isinstance(x, e(s.UndecodableBytesDefecLfor x ina.all_d-*s)o/'unknown-8bit'%Nelse;# If policy.utf8@false this should really be taken from a_c3# '' property on thed 41 = 'utf-8  zmime-parame0'Q# MimZ P fold<0(usRFC2231) Textra x_7_k_k, lines, maxlen,I i a:if ;Nnot  0if 'O.h a0= F last_ew = NonAwsyntactic_break)F ed%U;(t=s)[:-len.AMep)]S("inil?# It fits a !len30if 3) >! -O[-1]DQ# Butie, so start a new onep?0newr = _steal_trailing_WSP_if_exists(%szC# XXX what has no lea#OFWS?%On.append(}.3# +od u# EitheriKemajor  mwe don'tk#2 it by itself even&iCm, or iE # doesn't f$it on a line by itself. Either way, fall through # to unpacking the subparts and wrapp)m.?if not hasattr(4, 'encode'):,va# It's4a Terminal, do each piece individuallyoCds = listqA) +  nOelse5a t|P it a d word, possiblyZ# combinit with previouslyFs if allowed last_ew = _fold_as_ew(tstr,s, maxlen, +,B.ew_#e_, charset)HQwant_y= False"vcontinuaif lenC) <=! -[s[-1]@ += d a# This is too loo fit. The RFC 0s u# break at[# "major syntactic$Ps", s less we don't consider thisEto be oneD0eck ll<AnextF1if ._%nd%_6+ 1c S0newVCsteal_trailing_WSP_if_exists(%s>!orf0.st[_fws(lH.append(}+ ^-6Non<UQ M@try L }0new" J "otCWD_blocked1Ou>end_ew_not\ B8D9.[ VP does need CTEing, bute6PnywayFiwe can#;: it{s.insert(0,b 'TrxI 1# W't figure out howA, itvgive up?= _@<80olduonto the next line either... s[-1] += tstrreturn policy.$ep.join( ;) + def _fold_as_ew(to_encode,"s, maxlen, last_ew, ew_combine_allowed, charset):"""Fold string TR intoXB as iPd worCT03if YRthe new value foror None if is False. 0If Tealready an0 in$a1 ofs (indicated byPaa non- _) andtrue, dennMPexistjg it withI,W2re-C@. OSwise,NzS. InM0 ca'VsplitSnecessary so thatd segments f#in!]1"""z!if=0_ewg2not6 =>(Lget_unstructured[F:] +%))?*" = #[:7](&if;0[0]6WSP# We're Qqthis topd text,>Xdon't#PP lead@Rblanki_wsp =# 2[1:"cif (leC) =='.append(_steal_trailing_WSP_if_shN$+=D!'' ];in ^@LikeJf space*s +&-1   ":#Cnew_ 3 DelseG_as = 'utf-8' if w'us-ascii' ?%?# The RFC2047 chrome takes up aracters plus:AngthP#%UC nam#LC_len7))d+ 1) >*raise errors.HeaderPE P"max_Uz0gthtoo small(3 h"")VwhilePemain : - _-r?-i23ext5F<= 0Rs)6' 'Vcontinuez_ d_word = _ew.enco de(to_encode_word, charset=Sas) excess = len( d6) - remaining_space5cwhile ;E> 0:V# Since the chunk to [ is guaranteedfit into lthan 100{acters,\#shrinking it by one at a time shouldn't take long.A : = Y[:-1]1r = _ew.f/jlines[-1] +=D[5:] 5&if q.append(' '*new_last_ew30)Ptrail>1wsp{xreturn F'if ew_combine_allowed else None def _fold_mime_parameq(part, r, maxlen,$Bing)"""Fold TokenList '7't'A0' l0as f f.5 Usr0 deYd0'of+ and values, formatm accordAoHpRFC rul,Qinclu uguRFC2231 "he\ cannot bexpressed in '@ing'0/or+1too@withDJ'1"""# Special case : start from 'ss2 us#: iff needed#t0NotHI! 1GP2s beM2addDOlength calculations arq0unt6fossibly-x psemicolCwe'll be adISname, inj!t.<s4# XXX Whatis ';' puts us overRfirstpthroughNloop? WQ splijs headeroVamtTP# but1do !werecognizearlier or repU , so I'm gosto ignorIaat bug@now. Itb@only7 us * 0if !.rstrip().endsC(';'1.5';'lfCset e5ingerror_handler = 'h&ct<6tryf& _required = Fal""xcept UnipEE lIng_required = True if utils._has_surrogates(value):-8 charset = 'unknown-8bit')error_handler/]jescape2Oelsem Ftf-84if encoding_required@1ed_ = urllib.p}.quote(,, safe='', !s=)60tst "{}*={}''{}".format(name, 0,ES0'{}R Ns_stringKif len(lines[-1]) +Q 1 < maxlen*16 = + ' ' + > gcontinH#elz+iO2 <=j.append(_b `# We need multiple sections. are allowed to mixnE andc# non-C , but we aren't going to[3'llKP themf.PE = 0extra_chrome =u + "''"&awhile n 9@_len!enESCstr(t)3t K#if\:+ 3xxgroom for@ leafq blank,Ptrail&semicolon,J#{0 at@ast one acter ofHP. If_don'tHhave that, we'd be stuck, so in case fall back toIthe RFC standard width$Y = 78Fsplitpoin1max 7 - b9- 2<ypartial =&[:i]E8e8 w)O7]breakY -= 1 zR" {}*TR 0fc(,  q *YWQ, +:"if\';' # Copyright (C) 2002-2007 Python Softw`Founda5ntact: email-sig@p0.org """E address parsinrg code. Lifted directly from rfc822.py. This should eventually be rewritten. """ __all__ = [ 'mktime_tz', 'parsedate',"p%5quo!] import J, calendar SPACE = ' ' EMPTYSTRINGu' COMMA", ' # Pl0 a  field _monthnames'jan', 'feb0mar!ap0may!ju#3jul@'aug$0sep0oct0nov?dec2ajanuarZDfebr Pmarch6Papril eOjulyOQaugusvseptembeCocto 5nov2dec v] _day !mo!tum0wedt0thu0fri"sah@un']_1Thezone table does not include the military- .#s defined # in RFC822, other than Z. According to$Q1123,Rdescription in #822 gets!signs wrong, so we can't rely on any such" # . Ig recommendPat numeric/ indicators be usstead of)c@. _;y{'UT':0, 'UTC #GMZ-eYAST': -404!AD 3 # Atlantic (Q|Canada)EEE58"'EER # Eastern3C363C3@ # Central3M373M3@ # MountaigP484P4`700 [cificg} def Pq(data):*"""Convert3strLaP tuplglunts for.Tr=_{!if2res_Cretu]if res[9] is None&1= 0I5R(res)xCto extendedlast (addiJal) element` offse seconds, except if// was speed as -0000. InRt casvKges a UTCRstampHpexplicideclaims knowledge oVsourc,PopposPo a + _~1the H1 reQUTC. % ( =a.split( # qFWS aft e aday-of-weeko !al seM and # adjust for this. if data[0].endswith(',') orlower() in _daynames:>B# There's a  . Skip it*4delTFelseH4i =a.rfind)gif i >= 02<a[i+1:]7pif len(#) == 3: # RFC 850ke, deprecated2RVstuffP.split('-')#Y*ZCr1 = +k/a[4sv3K"s.+i&-1@ 0 ?i >>3:] = [s[:i], s[i:] bP.appe') # Dummy tz&V) < 5return None*#":5s[dd, mm, yy, tm, tz+4mm = mm.if mm not[monthU:I, dd>B& _p.index(mm) + 1F> 12mm -= 12!`dd[-1]6','' ddRd[:-1 #yy : 9! =>$yyf/yyfwyy = yyffJ yyisdigit()_z_z_/tm_t&tm_U!tmN-@[thh m!tmo ts-1'0'#elvA3AW, tssF 41 and '.'FVtm[0]E# Some non-compliant MUAs use4 to separate time elementf $0].  0  K 6try5fint(yy&dd`thh = 7thh;'mm"ssexcept ValueError q# Checka yy specified1wo- mat, then convert it toH# appropriKfour<according6 POSIX standard.f2p# callsyE a tK1but,2822 (which obsoletes2822 0# m^3a 4yy. For more information, see documentation for # the time module.if yy < 100:,The year is between 1969 and 1999 (inclusive)J9NF> 68Myy += 1900d A2000dO2068dOelse^;^tzoffset = None = tz.upper()if tz in _VzonesXEA[tz]; 6try9=bint(tzqexcept ValueError:Apassb,"==tz.startswith('-')@z# Convert a W into seconds ; -0500 -> -180l7 < ;tzsign = -1v4= -! S/GF6T* ( (//100)*3600 + %B)*60# Daylight Saving T@flag;to -1, since DSTrunknown return [yy, mm, dd, thh, ttss, 0, 1,G] def parsedate(data:"""@ str#to tuple."""6J2_tzMif isinstance(t,:i\Ot[:9 mk"c@"""TQa 10-B as :Ved by:)lqa POSIXUstamp0if 0[9]mhQ# No info, so local. better assumption than GMTCx.0@[:8],B-1,) ecalendar.o!gm8,Y$ -6quote(strx"""Preparepbe used!a 2d!. ds backslashbdouble/ charactersbEpairs. ThesyHonly6that need to bW]side Does not addXsurrounds. str.replace('\\', '\\\\')""') class AddrlistC0"""2essm"r +by Ben EscotoIpo under0d wCthis2does, it helps 0havcopy of RFC 2822 inPfront3youbgNote: Uinterfacedeprecated0maymRremovSfuturUse email.utils.PList 6ead^\__init__(self, field): """Initialize a new instance. ' `f8' is an unparsed address header %, containing@one or more55es.5""" self.specials = '()<>@,:;.\"[]'( po#00LWS8; \t. CRK\r\nF2z=!+ *CRXpatomendr 0; # Note that RFC 2822 now ? fies `.' as obs-phrase, meaA7%it#obsolete syntax. Yrequires9we recogn6L@, so allow dots in .replace('.', '')e9" =! commentlist = []tdef gotonext(C Skip whipace and extract R(s.V&wsbA"leHQ< lenm.s2"if+[P.pos]. f'\n\r'`:>0notB7;w.appendn0E+= 1q/el=lLUE 3get*()NelseUbreak return EMPTYSTRING.join()  etl@"""P\eRe@s a ?2_of thSresulF?whi?Bad =AgJess(2^if ad3|U+= adb/"('jt' ba(f a5. h0old5posToldcl4Y!pg\"et(aK .w/>= # Bad email technically, no domaindb(SPACE1), DC[0])6[.pos] in '.@G':  # email address is just anKspec00thi'n't very efficient since we start over<self.pos = oldposcommentlist&)cl%1 = N4get)()*creturnI[(SPACE.join(9i%),5)] EBelifeafield[7pos] == ':'HBua groupKp hblen = le Y += 1^Rwhilea)"""Parse!(R -path value).S<Tbmethodskips all.a stuffsEW.45""" ( L!= 'VRexpec = FalseXE 5 adBU = ''B,7if p=zetdomainI> Ah >42s 8Kelif self.field[self.pos] == '@': "] += 1expectroute = True#Qelif B=fieo:oNelseadlist =fgetaddrspec()?posYbreak40gotonext() rreturn |Hdef ~<)"""Parse an RFC 2822 -E."""]#as"[][Rwhile`< len(|.q.preserve_ws .3if sand not[-1].strip(7O.popappend('.' OFals" "%s"' % quoteo2get*))"inatomends.#aD\.VKtom(P!/8if 0w h'wst,>=2 orM!EMPTYSTRING.join(~t''@ gdomain!ifA # Invalid #, an emptyIess instead of#Uing aZ# local part to denote failedYsing.3n/ J# +$7"""Get the complete= name from>59ess3s%[]^ ?:LWSL g(bLpcommentu3get yi [i sdlist.append(self.getdomainliteral()) Qelif *afield[ pos] == '.':.9"^ += 1dlist.append('.'o@o # bpo-34155: Don't parse s with two `@` like# `a@malicious.org@important.com`.3return EMPTYSTRING#6"inNatomends@[breakN.se(sJv0getXb.join(>!) i@def relimite, beginchar, end s, allowcomments=True)A"""P}a header frag+$ d] by special Tracters.A`x' is the start.A for^I9not looking at an instance of fAthen   ?empty stringsa sequee-@ableA-u:stops when onPtheseencounteredAIf `j non-zero, embedded RFC 2822 )B are%ed1!in`Jdg5"""0!&!=B#V6 ''su = ['']Zquote = Fals:posaRwhile\R< len1if ] k@ 3J  8C!"if"nd  (H3getOQcontinue P# havMready advj d @fromaO8#a/\\p} L)[}`I^ H|v"""Get ax e] &~1's .f O('"', '"\r',) t(self): 2"""Get a parenthesis-delimited fragment from self's field.""" areturn E.get@('(', ')\r', True) 4@def (omainliteral(^!): U"""Parse an RFC 2822 d2-3'[%s]' %[]KFalsAatom , ends=None -.OptionalE specifies a diffej set of end token 6%rs(the default is to usew). This used e.g. inEgetphraselist() since ings must not include z`.' (whichMis legal inC)s)iv = ['']9f0is Y89* =ZCwhilpos < len.P"ifH[]P.pos]k 5UbreakNelse(Bw.appendj)HV += 1:EMPTYSTRING.join(a 1yr.` seque&of9:sA8a5qwords, @ are3eeitherUs or quoted-strUA. PysFcanonicalized by squeezing allM@runscontinuous`tespacqto one .6p!]h<6>FWS</eln== '"'L ]1get^*()X\ (\0com* giidY`.c)dE< class AddressL C5X"""An& encapsulat1pd" aY%es__init__,#j .-"if? E|'0get(@slist = []  def __len__(self): return len.addresslist) &=3add=w, otherD# Set union2X0newKB = ARList(None)$t0 = 5[:]2for x in&~bif not+ P *.O.append(x*-i, in-placeL *?sub differen rj g+2+ ".remove*ugetitemYindexQMake  ing, slices, and 'in' workf[@] """Policy frame; 0the 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 _8RBase:LObject basicY.'RThis Dis useless un1subted. A p should"inw' attributes with!Qaults any values that are to bAmanaged by ! oQ. Thstructor will)0n a.pnon-defri`A setXtheseat instaxcreation timev!sbe callable, takingbse samkeyword argument;Za newidentical p%ed%d excep4oseqchanged F C. Is may be added, yield1newDany non-defau.lt values from the right hand operand overriding those in/2lef.*. That is, BFA + B == A()/Tepr of an instance can be used to reconstructaobjectqi9d only ifrQPE,.2""" def __init__(self, **kw)::"""Create new Policy, possiblyMSsome siBSee class docstryfor a listable attributeCK;Rname,kw.items(+`if hasR8 $(rsuper(_PBase, p).__set?0__(;s)=Felse/raise TypeError(3!"{!r} isvalid keyword argument {}".formatIM1.__pP__.__3__)Dargs = [ "{}=tDx"ddict__% ]`returniE({})h7 , ', '.join(ScloneRhawith specifiedr changed=1has7sam#s @curr,RexcepoPs pas  in@ Anewp> = 9#ew S  ,FPi  noo? ]_,g1ame]( ', kbmsg = un Pread-q" J+noQDA4msgS__add, other):  ("""Non-default values from right operand override those"qleft. I) The object returned is a new instance of the subclass@5"""LA* self.clone(**other.__dict__) def _append_doc(doc, adde!):O doc = doc.rsplit('\n', 1)[0]!1& ==.,1,T + I& +43extstrings(cls`if clsPoc__ Z.startswith('+'4`%) =bases__[0]\,i)for name, attr in#Qw.items(u!if)R:nce0(c  &g.mro()HpP= get(!c,P), '_2__'3 if N WK!ttqZFQbreak]acls  Policy(_Base, meta=abc.ABCMeta):Fr"""Controls how messages are interpretedformattedHDMostcg8tnd manypmethodsemail package accepts as parameters. A! contain!seN1andPfunctions that0@rol Pinput- 3out`render|For example,T 'raise_on_defect'nPs wheH ot an RFCPviolaq result"an error being Xd= , while 'max_line_length'Oemaximum !7Rn a M serializO0Any!idibute may be0denIpis crea-by passingN ita keyword argument toKconstructor. mmutable,P3but{ 0can only cer.rchanged byO@callo;QAD )zQs canL@also, produc] 6QwhichnJ1ttry s !in&(h-Dwrit.pspecifi4N>_1SetTs  -- If tru"n s should"ass.  Default: False. "plinesep -- string contain the value to use as separationLA between output r3. S '\n'cte_type@@-- Tof allowedent transfer encodings? 7bit -- ASCII only 8/Content-To#-Eo!: $$is 5q. AlsoProls _pdisposiP? of (RFC invalid) binary data in headers; seeXI document0 of0P_fold method@max_q_length\-- maximum "ofp, exclu '7_sep', uvserializ. None or 0 means noaJ Pwrappwis donepUis 78ngle_from_ !a flag that, when True escapes F/p?the DbodyZmessage by puttPa `>'G_front them. This isd>\is being b eda generator.:'_factory*!--,Tclassto create new objects. Iza!is,adM2"""praise_on_defect =oAep =ge0= '' C= 78#[=def handle(self, obj, !):_L """Based on policy, either 2call register\J xr$ should be a=1subP, butany case must+QExcep7 . Twhichh{ed if itE2notCd. $!is.M#is?an error, o\1wis8and&ar0pas/to{.i40ded0be m`parserat discover$The email pack49aalwaysR&Dwithinstances.  C""" if self.raise_on_defect:!) 7segister7S(obj,)!) +[def r&;(, ,p"""Record 'q' on 'obj'.RCalled by handle is False. This method isMpart of the Policy API so thatsubclasses can implement customN1ingweFault7ation callsydappend%ofPTs attribute3obj]objects us3email package byP1defPget p0d t will always have agJwith an r.0(1header_max_count(2[name)+AturnAmaximum allowed number)N s ?0d 'Lrwhen a -6Aadde`a MessGiB. I. re%edPvalue=not 0 or None, and@re already aKOb equal"e lP, a V~PError dpBecauseqbehavio('s __setitem__J$to5the7Qe lisD?Ps, it:@easycreate duplic (Mout realizing its certains^b7mitiinstancesvmay be  programmatisy. (Thyfobservuparser,Mawhich [faithfully[duce as manyPas exXmN be(d#d.>p.s@ for.p%s.^76@abc.abstractR9X_source_Zlines1Giv}F#ep terminated strings constitut , 1a single#, -(N,;`) tuplat shouldNstorIQmodele input x8!reUtheir&!ep0cha33ersM! in 0condJsurrogateescaptinary data""" #raise NotImplementedError @abc.abstractmethoddef header_store_parse(self, name, value):/K"""Given the<*A and1 provided byapplicationKprogram, returR(v that should be 2d i+emodel.N5""" /_fetch7Afrom 0 toQed to6>Z6is requestingJb. Thea passe@ email package may contaisurrogateescapinary data iflines were @a BytesPQr4not~] any zs.(Ofold1a stringa8`ep cha1ers$ i^.omO`accord +RpolicOrolsLb Krj:by L X_Ha!M *M  @_extend_doc,s class Compat32(P"):A"""+@Thisrticular iGe backward cGibility LQ. ItE"ree6ehavior o version 5.1uGpmangle__ = Truec_sanitize_` 8# I7s~s, return a Header using # the unknown-8bit charset to encode#bytes asd words.Iif not isinstance(value, str):'w# Assume i0 already a hiobject3qreturn Sif _has_surrogatest o<]!.Hd),#=_.UNKNOWN8BIT,iT`_name=)3Jelse(3def_source_pzr(self, WlinesA"""+=@The wA is ;dverything up':' and ed unmodifiedPQdetermined by0ippT@leadwhitespace off$`remainmop first `, join@all subsequens together,P3str}any trailBcarriage1 orcAfeedacters. H5""" 8,Q( =m[0].split(':', 1=5!.l(' \t') + ''.(F[1:]?r(z#.rEr\r\n')):tor>3are&rYfetchIcontains binary data,converted into a  {@. OM4wisl._sanitize_Cfold  s :  algorithm, which preservesPexist,e breaks inNoR wraps each resul3 to,P@max_K_length. Non-ASCII5CTEJ\ uj$, [=Truey_EȰIf cte_type7bit, non-asciiais CTE encoded using the unknown-8bit charset. Otherwise%original source header is used, with its existcline breaks and/or binary data. K5""" folded = self._(name, value, sanitize=!cte_type=='7bit')Ipreturn Aed.encode('ascii', 'surrogateescape')Bdef u_/, {%):fparts = [].append('%s: ' %Iif isinstance('trZgif _has_s, '+Bh = !.HK,)#=_ .UNKNOWN8BITD_T=tOelse# If we have raw I in a byte string,(no ideaa# whatis. Thereno safe way to spli0/isP~ . Qit's m-subset,jncould do a normalO>v`, but 5WQmulti7theSkgQT's no0 so= least harm seems toQ be2not>e risk it be\too long.MH5%6Non6+r I# AssumeRis a <-like objectvBif hO t #pV class interpretpL1 of; for maxZ`len astj # default0:078,*recommen_by RFC 2822]9= 0Z"if@max_P_lengI PS.? c hm2sep ,=e)6 Lz;##''.join(2) compat32 = C () :mod:`email` Package Architecture = Overview -a The V# pUconsiststhree major ronents:FMode?#Anu trepresents an email message, and provides an API for creating, query 4Pmodif$ aM!. >aParser L0TakZ sequence of characters or byt"0duc ` model,5theL  represented by those[Generatolturns it into a G. Tcan either beLQendedPhuman consumption (a printablunicode string)'1sui*MtransmissHover the wire. Ilatter case all data isperly enrqd usingIcontent gf+ings specifie relevant RFCs. Conceptualle package{organized arounduYboth "external" APIs^0use qapplica_programslibrary, ?"inP@0J components. This diviia bit fuzzy;btdescrib?is document!isa public, s1API# 1ows7an R withal needs to impleb its own pT/or g'. In addi;three major func'al ,ra third key *Iarchitecture::UolicyAn object that fies various behavioral setd carriesIUsV C-@roll`methodQThe P framework2/! s[;@veni00wayS |G@ maksit possible$Kbe used in a very flex.0ashwhile leveragSCPcommood`quiredP%, BeS-likes. For exaA,  default :rfc:`5322` pL0, wso have a manages HTTP head&# fK lidnQ2616`CdualV s, such as maximum lin6@ngthNe  , palso bet+nSo mee"al!re|\ ]M$ - Js8)e :class:`~a.3".M!` e model divides &a message into the two fundamental parts discussed by'P RFC:  header section andbody. The `Md ` object acts as a pseudo-di=ary of namedXQs. I" interface provides convenien\cess to individualL]. However, alare kept cpnally i ordered list, s*!atrinforma2bou0Bthe "sKaoriginal{s preserved. 3Plso h4 `payload` that holdssA"can be onewings: data, or a |latter is used to reo` multi%T MIME. Lists can be nested arbitrarily deeply in^X)a, withAterm;leaves having non-  Ss. z Lifecycle -qgeneral l)s: Cre Ac+1`a ParsoSor itDinstantia#s an emptyMan applic.qManipulN+ may examidr more,0/orCDDDbmodifyL CB>B!isAbe dnl top levelBB)Tby sub-F .izPModelrTa unicode0binnvstream,x$ mC1ard2 HPolicy Control Durc s0 Of rmajor cRQs exel qi`manage]" d{x. MostCsp't need|Pbe aw`of thi?A$ es~nf/ways: via Pby beset to a specific valuepgram afr`alreadU. Similarly, a?xit arializA a G1tort'retrieved from a bye0pro#e  hooks full four opse pathH@stor3(,Op) tupler identifi.s during parsing, and passes them to :meth:`~email.policy.Pheader_source_parse` 0Pod of? * The result$at*iq (name, value) tuplebe stored inRmodel. When an application program suRes a W (for example, throughV `Message` object `__setitem__` interface)7 e 23the\2are@Pd to ;: , which return*?xretriev+(2anye dict or list s:  k_fetch cCobtak$ei0 Generator request%during serializT jAare ,l Ofold Aa st0conline breaksappropriate places.a cte_type` d%rol determines whether or not Content Transfer Encodis performed oDdatavre is also a ybinary_/use by g`s thatRduce 7s outputR 0Q$ed $as2, possibly 'at differ^B thacorresponwould be. Handl"B Data -1 Iideal world all m  Z0conjWRFCs, meanh  tharser cadecodeQ"in rized uni'#LAsendiginally wrote. Ir  package must Rbe abqith badotrmatteds, inclu[s ai non-ASCII characterQat eihave no ind&ed)1 senot vali[;. Since O*primarily* textP opl@ions%6  :98.(except qpayloadtTcours %sC5 as)Un-decodable binar4y inside text data is handled by using the `surrogateescape` error -Ar of'ASCII codec. As withbinary filenames Dwas introduced to ^, this allow8mail package to "carry"Ujreceived dur1paralong until4output stage, at which time itregenerated in its original form. Ti>,most entirely an implementation detail. The one place whervisible in0API"internal" API~ Parser must do4@ncod3of ; in , and pasx0at  appropriate Policy methodf usyGQor to access header values preserv. d` bytesll other ks convertl ei*P backpoF2 oraa safeA (lo0 inin some cases). Backward Compatibility -(e :class:`~e!.p@.G.G432`Xprovidesj( cjf@versI45.1](. It doN`is via0 foY dfour+1s described above: _source_je Spl.3first lin}` colonCobta , discards any spacesOVafter<@join0e rnDna%I*#$s,nep characters.LPTrail9`return?1/orHfeedMare stripped fromN`resultOc&6ng.c8torbRl=vC` exactp$s lq applic]WfetchI2O0con#, LLas a:!.H` object,~A setG`unknown-8bit`. Owise just|} . d=OUses a's fol!to rsame waxl|(or did. {_P~S6aa@, bu2_p'ascii'VNew AlgorithmM  m]legacy behaviorstore_parse " Same as legacy behavior. header_fetch_parse 1 If the value is already a 1 object, returns it. Otherwise, KsEPIPusingB new#er, andGu`result*eD.O`surrogateescaped` bytes get ed into unicode unknown character Lpoints. fold1UsealgorithmAspecpolicy sets `are en&d #``q-8bit``qset for``cte_type=7"Ror ``.C. Ra string. 7At some re will also be a Z3"``for thatJ BserializeWA ide dx`messagoth RFC-likbDing, conver4_ any 2g/(glyph. binary_e*f tBback)EY`accord1)to :rfc:``5335``. # Copyright (C) 2002-2007 Python Softw#Foundation # Author: Ben GertzfieldNntact: email-sig@pI.org """Base64jtent transfer0pers 2045-2047. This module handl?conGmethod definUT2 tone arbitrary 8-bit dataSthree in four 7/ sQ2as P. It"us8MIME standards H0 to attach images, audioRtext CsBG7provides an`erface0 deS both]/d bodies witha. RFCYmCs a ~Qinclu q informRWBan `qd-word'2. is commonly Xhreal names in To:, From:, Cc:, etc. \@s we{As SuDl: line:does not do[$` wrappoQd-of-Msion necessar:y for proper internationalized headers; it only does dumb encoding and de . To deal with the various line wrapp6issues, use&bemail.p module. """ __all__ = [ 'body_r7e', !dstring5m_7clength* ] from base64 import b64<uinascii22a_1S, a2b  CRLF = '\r\n' NL n' EMPTYSTRING(' # See also Charset.py MISC_LEN = 7 # Helpers def_(bytearray):*"""Returnu% of s when"is"ed.~groups_of_3, leftover = divmod(lentA, 3)w@# 4 Qs outsceach 3(or nonzero fracreof) in.EGn = A * 4%ifCn += rn-#(2, ci='iso-8859-1'<Ee a singlemB"[n a givenZ!. h` names acter set too#. It defaultsN6to =. s0ined in RFC 2045Wcif not_OD!""oif isinstanceA3str0N) =].%#e( )6d =^ `").!("l"6p'=?%s?bT=' % [,D%d)Dmp(s, maxlen=76, eol=NLFr"""B EDs will bed at, at mosti4s (1 toa'76)3c$ofR texts#eneol, which%O"\n". SetcBthisr\n" if youJ@be ut`result$22fundirectlyMbin an  UsJs7`encvec]8bmax_uns * 3 //iprange(0An(s)bB# BAW: should?(]uherit b0()'bpbehavioJ0addQa new!to,h?2 encps[i:i +x]siP.endsX(NL) andf != NL`/penc[:-1] +(ncvec.append(enc) return EMPTYSTRING.join! vec) def decode(string):<A"""D a raw base64 $,[ing a bytes object. >)This function does not parse a full MIME header value enad withGu+(like =?iso-8859-1?b?bmloISBuaWgh?=) -- please use the higGlevel email.qclass for thataality.|1"""!if\(oelif isinstancP,4U9Ba2b_x.('raw-uni -escape')a-se I# For convenience and backwards compatibi@ w/ 0dar$module body_# =( !# Copyright (C) 2001-2007 Python Software Founda # Author: Ben Gertzfield, Barry Warsaw \bntact:a-sig@pW.org __all__ = [0'Chk2t',add_aliasc$uc$r] fromools imporctial YJmimeaquopriP/Lgerrorsrn_7or8bitc# Flag yp}fJ/pings QPo= 1 # Quoted-Printable BASE64#Q2 # B SHORTESTQ= 3 #Qshorter of QPR., but onlyRcs # In "=?i?q?hello_world?=",V=?, ?q?,Q@?= add up to 7 RFC2047_CHROME_LEN = 7 DEFAULT_CHARSET = 'us-ascii' UNKNOWN8BITpnknown-?'' 'QDefaults RQS = {<p# input   0out#p4'': (QP,< SNone)/2/3/4/%# 5 is Cyrillicespeciallykd666AArab41lso@particular777`Greek,^Awill9make it readFo88oHebrew99 /O10': 11OThai101(QP, QP, pNone), 'iso-8859-15': (QP, /6/windows-1252':^viscii': Fus-a1( 0big] (BASE641 /egb2312$% /oeuc-jp/&gm@2022)shift_jis;8 L:8 gakoi8-rd) /Tutf-8. (SHORTEST,'#`} # Aliases for other commonly-used namcharacter sets. Map # them to real ones <in email. ALIASES = {latin_1': a'- _:2: )_3t3: )_4:4: _9: _:*10; )_71 _Hx  *_9x5 W_10':x6<@cp94X 'ks_c_5601-1987?Beuc_'kkc$kr2'4 } 8@Map  ir Unicode c strings. CODEC_MAP }4_cn '3_tw# Hack: We don't want *any* conversionstuff marked , as all# sorts of garbage might be sentQus inPguise,U7-bitR.KLet that xpass through withouttto/from;FtX}P # Cnience functionextendingabove mapp def add_(, header_enc=mW bodydoutput8$!):a"""Add  properties;the global registry. = i#Pe inpharacter set, (and must be the canonical name of a character set. Optional header_enc PAbody is either Char9aQP for>quoted-printable,%`BASE64) base64 encoding$SHORTEST&Oshortest^qp or@por None75 noY4. RNis only valid- . It describes how message sHbodies ineQinputSset are toed. Default is noJ\  OAhaveesvalue as%in.N1"""def __init__(self, ,=DEFAULT_CHARSET):7 # RFC 2046, $4.1.2 says s are not case sensitivWe coerce toOu because its .lower() is locale inLIargumentOlready a \p, we le)it at that, but ensur@eIdASCII,Vstandard ( XXX) requiresf'6try4pif isin=9ce(nW, strc/ %0.en('ascii')*Jelseo @ =f y NUexcepZErrorYpraise e2s.C/' [ 0# Sh4putW after filtering throughfaliase.g = ALIASES.get  # `an tryguess which 8and0to  byM_map dictionary. T\hat firsluser overrid&ithqhenc, b3 =  ,$ (SHORTEST, BASE64,0)#it &~}s, allowXts~Yw defauliuheader_ = r$Hbody": "  :,a# Now hBdecsone isn'tined forj"# aRraW2wit$asMODEC_MAP! = B{" |  self.output_charset) ,def __repr__('!):preturn 7.in<y.lower(C#eqA, otherH"trb == str((Mget_body_encoding7B"""Rthe content-transfer-7 used for N .This is ei Nstring `quoted-printable' or `base64' depen5 on0?e|,4 itba function in which case you should callM3with a single argument,Message object beingFed. Theq0thetHCGTGE~Mheader it to whatevs appropriatea # This l doesn't fit so pop i)f.AZ.pop(## Does nothZUow`first ?Y if2Qs andnmMsNNoneOelse=separator = (' ' Cs4> ''Mt/ed =1bytX , c (r(T sJ7Z'<H? = ? = breturnH fdef _getjr(self, ) 0if _== BASE64+-oemail.base64mimey /elQ/QPMoquopriMSHORTESTSPlen64c 2 >UlenqpAAT<*qpcD $: 6l*Cbody"""Body-Be a " by convert%iD1to .eThe typetF1(3 or quoted-prin table) will be based on  self.body_encoding. If  is None, we assume theEoutput charset.ta 7bit T, so re-> decodedFstring us thj@cii %c produces:correct 2Wversi#of&entent.a5""" Tif noB:creturn]>if ,jBASE64Cif isinstance(,R)(o =$!e(mY_Y)8`email.g64mimez8/el*QP# quoproT takes a , but operates on it as if#were a list of byte s. For a (minimal) historyQ;whyL@this{pso, seey0nge{0cf700464177. To ,"ly;e aM]acter set,:nQmust it into pseudoPs via, M`latin1 r, which~A anyB% a lk pointPbetween 0 and 255Swis whate`expectG IQ "('' iii78JelseD._ascii import bin,Z:setzmessageerrors from < Y class CoManager: def __init__:hIget_handlers = {}7s WGadd_>^s, key, Ql t[key] =+ScSmsg, *args, **kwW)_type = msg.@((9if 1"in3sHK &[H-](%EOmain  (D w) i f '' in self.get_handlers: _retur&[''](msg, *args, **kw);raise KeyError(content_type) &def add_s{( , %Skey, )!.2#s[-4] =/_)z[:obj`aif msg9P_maine() == 'multipart'6/# XXX: is this e a good idea or not? We can remove it later,Jq# but w* 't()` so dofT)w.;zBType{" valid on "s" =J_finB31cclear_3(O) xh,W, objfull_path_for_he= None0typA.__mro__ ifn)p Z ) U]}*pqname =\p.__qual)__%0mod = getattr(typ, '__module__', ''MZ = '.'.join((K!, y0)) _Belse ~5if LJ!isK-=C\\-x b"if_-1 [`typ.__ 0if z-Dy!ifxUQG ) raw_data_manager = CM(&"Etext s='replace'  =Npayload(decode=Trueycharset+Sram('SASCII b.P(-,x"s=).r (' ',_ 9nonVE'audio image video application'.split(a  Z message_contentB(msg): return msg.get_payload(0) for subtype in 'rfc822 external-body'.split(Maw_data_manager.add_Whandler('message/'+[ , _content) defand_fixup_unknown_- # If we don't understand a 5,' are supposed to treat it as@# if were application/octet-s0cm, per/tools.ietf.org/html/rfc2046#sec< -5.2.4. Feedparser doesdo that,Nso do our bestfix things up. Note3is *not*`ropriaoMTmodel/partial pR as M objects, srey are dLhs well. (Howreassemblem is out of scope Qthis comment :)Qnbytes(?) rW';oT_prepare_set`, main,J0heaibmsg['C-Type'] = '/'.join((A)3if Iif not hasattr( [0], 'name't,Amp =apolicy^=r = [mp._factory(*qsource_"([(]H %% %s]z6try;0 #'@.def#'Sraise8*&[0$.8except email.errors.HD#:exc`ValueE3("Invalid: {}".format(kb.fold(= ))) from exc_finalizpdisposii`, file, cid, params27if ,PNone ,7~6= 'attach'XC"D)`Q #sTram('- !+=4replace=True?cidC !ID"ci]#if;>`key, vtrs.items(] (key, value)X # XXX: This is a cleaned-up version of base64mime.body_encode (including a bug # fix in the calculatD"un6&d_bytes_per_line). It would be nice to # drop both tand quopriin favor!enhanced binascii # routines that accepted a max_length parameter. def _l(data,4t): as = [], =H // 4 * 38Pfor iJrange(0, len?), U20 = _[i:i+76 .append(HD.b2a _@).de !('k1'))return ''.join(W9) \text(string, charset, cte, policyY+.T(1q).split$( Cep =G.:embedded_(.3): "ep A) + %epConormalACb'\n6?= ifb==NoneP # Use heuristics to decide odb"best"}Aing.M; if` ((60x) OxO|, default=0) <" R:try'7bit',  > ex@ UniDDJ^ErroriIpass<$ifcte_type == '8?, 'surrogateescape'Vsniff = 1[[:10]* _q(L%latin-1'),u&. % =2#little unfairqp; it i$es#s,& doesn'tea_qp) >rcte = '' 7els-)quoted-printable3%!ifp/10"xq];Y/ ='elJJ ] iata = quopri mime.body_encode(normal_(lines).de'latin-1'), policy.max_K_length)>elif cte == 'base64':[sdata = _ (embedded/, f &seVraise ValueError("Unknown content transfer ing {}".fbt(cte)`return ,  def set_text_O(msg, strinubtype="plain", charset='utf-8',P_=None`disposition' filename2cid HLbparams"r header)#_prepare_set'B', s,6cte, payload4(b, msg.B5E( Sram('J'cemail.".ALIASES.get(mreplace=True|2['C#-T -E#ping'] =g_finaliz7,P, cid0`) raw_;_manager.addy_handlerB,R)jzmessagem="rfc822ot( %`/ b $ifKwpartial/, is not supported for M  objects" n mOAin (z '7bit', '8sbinary'$.# http://tools.ietf.org/html/rfc2046#sec-5.2.1 mandate. n"dXts do=B # will get coerced on seria4 ifMActe_U. We# may end up claim)dhen it isn't needed, but the only negativOresult of that should be a gatewayPCs to 0havto look through}dwhole C VDdiscover whetherP!orgit actually hado anything;N0is ZP else^V external-y&on-5.2.3 manwdate. raise ValueError()2"message/external-body parts do not support cte={}".format(cte)) Ecte = '7bit'f@elif3 is None:+4# http://tools.ietf.org/html/rfc2046#section-5.2.4 says all future G# subtypes should be restricted to , so assume that& _prepare_set(msg, '#$',m, headersmsg.set_payload([1]['Content-Transfer-Encoding'] ='_finaliz~pdisposi , filename, cid, ams) raw_data_manager.add_handler(email.".M , "_cq) defTbytes f`, mainu'base64', =2cid @bparams")[ 4== JP = _e"e_(x_line_length=policy.ma jquoted-printable't# XXX: quoprimime.r won't @ new characters in >#Pwe ca9use it. This means ignored. AnotherO0bugRfix later. (Note:2rs.Ibroken on Rends._binascii.b2a_qp`istext=Falsel?tabs=TrueQ.decode('['$  xMake sur#p reallyonly ASCII8 e early warning here seems%worth the overp...if you care writecr own y 6 :)`in ('8u0, 'N3ry'gH , 'surrogateescape)<C?msgLpfor typ(~ , array, memoryview2typF) # Copyright (C) 2001-2006 Python Softw`Founda~ # Author: Barry WarsawLqntact: ga-sig@pGT """s and re>Qd funs.""" __all__ = [O'B_7or ', 'encod e_noop', 'encode_quopri] from base64 import +bytes as _b+A +astring,+ def _qA(s):renc = _-(s, quotetabs=True)+T# Mus spaces, which0Ipri.G) doesn't doA`return .replace(b' ', b'=20') E_ C(msgA"""E; the message's payload in B>!. oAlso, add an apprpate Content-Transfer-W8qheader.?1"""orig = msg.get_n0(deencdata = str((?), 'ascii'JLsL;/['b'] = ''3(3d-printable=m9/. 9z7or8bit:1Setj / to 7bit or F.:0if is None+`# Ther$no. For backwards compatibility we use<G?msgR'2# We play a trickmake this go fast. If HASCII succeeds#AknowZ0mUb, otherwise treat itW6try 6.u)e(aexcept UniVError6q7els<Kr _Do nothing1># Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw #act: email-sig@pG.org """ package 1ion classes! " MlH!(E\6ionw9` for eps iWRParse\i_P parsmo ZHY^z%leS Bw!ry0(QCouldn't find term.inating boundary.""" class MultipartConversionError(Message R, Typ ): """1t to a mJ is prohibitednqCharsetU bWAn illegal c. was givenL# These are parsdefects which th!er=@ablepwork ar.D?\(ValuRBase -0for3 s def __init__(self, line=None'!if&@not Tsuper().LF)w@elf.! =I0NoBUaryInc"""A mpclaimed% bebut had noAubameterTStart@NotFr!ThZzs?cpnever fHi_Closei/A _Y , 4correspondTciFirstHeaderLineIsContinuationtV7a c: as its fd! heMisplacedEnvelope{ 'Unix-from'Zi 1 in8middle of a$[blockvuBodySeparator P withU1leamwhitespace anocolon before blank:# XXX: backward compatibility, justc1(itOemitted). Malformedo = Mis qeInvariantViolw `no subns were z5lidentTransferEnco]n invaliGsntent tA# eBASset o%  itSpUndecodu_Bytes~ }pained b4 that coul Qt be U!edr_64Padbbase64ed sequenceact lengthl_acter o D ~3in .alphabet}LU base64 encodehd sequence had invalid length (1 mod 4)""" # These errors are specific to header parsing. class HeaderDefect(MessageD): """Base c/cfor a Ld(.~+def __init__(self, *args, **kwP)super().-' IH P2""" is not #A, me gives details60MisRequiredValue(DgAthat must have asuAnonedNonPrintablV\SCII characters outside the ascii-pI range foundlS|Enon_5s,  *)Jelf.: =  .3strnreturn ("following A6nons3 inj1: "^"{}".format` $))<Obsoletez# uses syntax declared oG by RFC 5322rLocalPart2il&_part contain!n-Caifect only occurs durBtunicode,Awhen4# K0&d from binary. # Copyright (C) 2004-2006 Python SoftwNFq ation # Authors: Baxter, Wouand Warsaw[ntact: email-sig@pV .org """FeedParser - An)Q feeder. The implements an interfacar incrAallyC+aY `, line. This has advantagePr cerq applics, such as those readenoff a socket. . (){primary@pushUnew datao! p.q. It r\ s 0re'Ut;more it can do with$` avail Y. When you1no :9~Rcall .close(). @ co1tesgDroot&` objecVotherP of tJ"er0 atwill never rais%ing excep"rnstead, it finds some#unexpected,Wadds a 'P' to ecurren2. ej qinstancat live ons B's ._s attribute.  __all__ = ['FeedParser', 'BytesFeedPa ] import re from email gerrors._policybase%compat32'collections!Rdeque$ioStringIO NLCRE = re.Kile(r'\r\n|\r|\n')"L_bol&(')(e( %\Z*_crackT # RFC 2822 $3.6.8 OpNal fields. ftext is %d33-57 / %d59-126, Any character # except controls, SP, and ":". header0^(F|[\041-\071\073-\176]*:|[\t ]EMPTYSTRING = '' NL$\n' NeedMoreData = object() class BufferedSubF#): """A file-ish> that can have new d^loaded into it. A1You+also pushpop line-matching predicates oAa stack. When theOvcurrent/ B es" [, a false EOF responsE(i.e. empty s)areturnstead. This let_pA adhere to asimple abstion -- it 0qs untilKclosmessage.J1"""def __init__(self0# Tystream of1lasoAtialYk@to thHSee issue 22233 for why/Qis a jand not a listHQ._par|$= @(newA='')u!A Tfull,+s(U" =2(F2The H-ZcheckN 1eofYU = []p# A flag inDqwhether` has been @d or a0= FR_eof_r,.append()K-opJD K0pop:p# Don't get any trail v.seek(05sn+R.read)2NP@trun2q_d = True7q if0+#ifX !q%''P Q# PopZp2 ofjsfE/G$icate. line = self._ s.popleft() 0# RFC 2046, section 5.1.2 requires us to recognize outer level F # boundaries at any" of inner nesting. Do this, but be sure it'sin the orderD@mostQleastL5ed.0qfor atel reversed(eofstack):/"if2(  p# We'refalse EOF. But pushlD back firstJ's.append)return ''/ def unread,Q# Letconsumera)0inte bufferbassert*is not NeedMoreData &.Gdata@"""PKsome new  is object."""Mspartial.write(6Iqif '\n'"inSyand '\r A# Nocompletes, wait cFmore#@# Crs, preservingep charactersSNfseek(0ssH truncate()"Ifpelement list doeend in a:,8un treat# it as a [. We only che="orhere because L0endMBwithAmighJ+ that was split`middle#A+sequence (segs 1555570 :1721862)!if_s[-1].ends({ r:&()).K!s($H)slaextendsC__iter__;.pn__next-!ifj == ''eraise StopIterap] class FeedParserJ"""A feed-styleRs$Qemail+S4ini , _factory=None, *, policy=Gat324"""/ is called  no argucpmessageI3Thek keyword specif0pcontrol4AnumbOa= tsp's operation.  The default policy maintains  backward compatibility. !5""" Sself.K=T  _old_style_factory = False(5if is None:#if[v.messagK/3from email4 import MC a2=(;els:xSqE { 3f:try*(t=J )q)except TypeErrorK # Assume this is an old-  TXq6Tru' input = BufferedSubFile((msgstack = []sparse = gen().__next__0Qcur =T 0lasn headersonl##H -public interface for sup^Ping PHr's HAflagDdef _set_().!1 = OBAfeed6g, data<"""Push moreao the ;-r._a.push(NgQcall_="()  .CZStopIteration"FpassrQcloselq` all rn and returnSroot B object l W3op_cassert notja# LookKfinal set of6ect0if p.get_content_ype() == 'multipart' \`N! D5is_,(S,Pdefec e.4s.MUInvariantViolD+@.handle_S({,EE_newNR#ifK ` C5msg.0]iqY._curt/digest'. _:'T/rfc822'9S Nself._msgstack[-1].attach(msg) self._msgstack.append#cur = msg;Clastdef _pop_message(b!):tretval = zFpop(+if AE< lOelse9ENone+rreturn  |arsegen# Create a new  and start by parsing headers.V5new%-U = []1# Collect theP, searchcfor a line that doesn't match57RFCOC2822H or continuation pattern (includ_an emptyb)wu#inZinputt!if7 is NeedMoreData%Yyield$cif not1RE.(x)# If we saw definedB/body separatorp# (i.e.dP, jusrow it away. OtherwiseLp-!ofy`o pushJb 4?NLC 0def8= errors.MisHTBodySD*?fpolicy.handle_Z`._cur,H6ect=A_p.unread= Ybreak<h# Done wit-A, somfigure out w)Fwe'rN# supposed to see in#e_{(sVs-onlPis a wards compatibility hack, which wasP# nec_$ryRolderr3could raW AllH`remainRsN0 ar9rown into   _ while Tru3(.7X*f-j'nmZ== ''sJcur.set_payload(EMPTYSTRING.join5*s)if self._cur.#get_content_type() == 'message/delivery-status': /# ( Sains blocks of headers separated byNa blank line. We'll represent eachGXU as aQ M0nese object, but the processing iFbit differentKthan standard * 1s becauseV reMno body for M Ws. As; subparts.Ewhile Trueself._input.push_eof_matcher(NLCRE.)R:retval in Hparsegen()j44if 3s NeedMoreData/3Yyield, 'FOinue!]breakTmsg =3op_(# We need to poppAEOF  erPorder tell if we're a!#?0end`0curJ file, nov!Blast #E s)opAThe . stream mu`e sitta0newB or 1EOFP want!8see  $isO, soOPfirst51sumI,LTn tes!xt"wO6 th~0's 2P jVCP.readY2"ifisp 0P# Not"so/ go!to/ Z%unA ereturn#ifHcur.@main\  # &`claimsKbe aCwhat follows is   # another RFC 2822 message. #for retval in self._parsegen():,1%if/s NeedMoreData+/Yyield( R'continueYbreak3op_)() ereturn#ifcur.get_kent_maintype() == 'multipart'boundary =H 4if  is NoneQT# The /claims/ to be a but it has notD# defined av. That's a problem which we'll handle byNreading everyth until the EOF and mark? asNdefectivr = errors.NoBh4InMD@ `>rpolicy._Q(P_cur,:ect=lines = []  ^inputH2if ,1 +vs.append( .set_payload(EMPTYSTRING.join=.s)? Cu# Make sur`valid @ent F was specified pxz045:6.4tvif (str#('P-transfer-enco', '8bit')).lower0not0('7-5, 'binary')9!InContentTE?p# Creat_ match predic!es`inter- #  as wellwend-of-_u. Don't pushMthis ontotput stream we've scan@past* Fp1+bl separator = '--' + @Rre = re.compile(%'(?PKre.escape(h@) + (0r')6end>--)? ws>[ \t]*T\r\n|\r|\n)?$'7capturing_[ = Tr dz = Falsdclose_Z_seen( while True: line = self._input.read-().0if  is NeedMoreDataWfYyield( P'continuem_== ''c]break9mo = boundaryre.match(/mo]# If we're looking at the end`,#done with# this multipart. ]there was a newc/ofL`e clos,n we need to initializeKrepilogu( empty str^(see below).Bif mo.group('end')M$e_q_seen =[3Wsep =f'2# We saw an inter-A. WAe inpreamble?if captu,_+?if %`Accordto RFC 2046U last/?ngsJ#{+`d% =O[-1]c 1eolvNLCRE_eol.searv0astMs1if B;&@! = _q[:-len(E?0)) Dcur.U = EMPTYSTRING.join(~ = Fals{o%unqh)R separatE0wo s. Consume any#&leKs that may be following. OurJdpretation of BNF grammar does not produc9b# bodyjin such doub?iesQwhileogy1+'ch(line)  if not mo: self._input.unreadline()9 _break"# Recurse to pa his subpart; the r stream pointsM!at1>'s first .3 push_eof_matcher(boundaryre.for retval in Q_gen()R%if7s NeedMoreData3Yyield0+continue% Because of RFC 2046,a0newT preceding0l # separator actually belongsA,/th#wEviou' 's payload (or epilogue if1pre/i is a multi).#iflast.get__ent_maintype() == 'I'=U&ifkb/[o = Non\3(eld!is27 moYLCRE_eol.search(u<8/if}'end = len(mo.group(0)Z 7[:-end]qOelset _Pif isinstance(.,-9aA `L$ =O<[:-n)o R2I.pop2,message((B# Se@ up cleansing, which will# happenX@we'r a nested=< 0=curhr# I think we must b9p/blassert capturing_preamble .append(line)*# We've seen either the EOF o end boundary. If we're stillMcapturingE, we never sawXstartW:Not # that as a defect and storeClaed tex(payload.2if -1:#=f= errors.SB@NotF D(F>self.policy.handle_Q(S_cur,=#S.set_(EMPTYSTRING.join(Q)Bepilogue = []@for B in ^input#if,s NeedMoreData-1Yyield, 'zcontinuGcur. ireturnx#not process@thenmight ha Lpwithout.G9at !..uis also dclose_Z_cC C5SRpEverythpfrom heo"4is ,# VPendedPa new-`'ll neo make sug%he]k isn'tM:NonY>sepZ1*''3Oelse2 0_/ i[WS Any CRLF atfront of Atechnically p+of. Also, watch 8(an empty st)e,Kwhich meanlE$ PEPfirstXD*[0bolmo = NLCRE_bol.m(@s1if 6uQe[0] = GQ[len(7.group(0)):  ING.join(epilogue) ereturn6# Otherwise, it's some non-multipart type, so the entire rest of the _# file contents becomes7payload.zlines = []@for  in self._input:!i#if$s NeedMoreData%)Yyield$ H#6inus.append( Acur.set_(EMPTYSTRING.join5As)) pdef _parse_headers(G,&s)# Passed a li]~?at make upLH 0current msgs2ast(Y = ''_value{"noenumerateaq# CheckHFatio[%0[0]QZ' \t'F%Unot l#'# The first<~ qs was a}1inuu. ThisF# is illegal leAnoteddefect, stor-N, and ign3!itpurposesq = errors.FH2LineIsContDFc.policy.handle_a}r._cur, A ^A##@_Qraw(* r_sourceS()s,],venvelopeY, i.e. unix-fromine.startswith('From 'a-no == 0Strip of[ trailing newc ~Umo = NLCRE_eol.search_if moOh! =d[:-len(mo.group(0)),-, N)el(os) - 1# Someth(AlookVike a1 atQend -K# probably.nAbody0push back)LOstop9ip.unread59r3Aelse  )# Weirdly placed unix-from line. Note this as a defect < # and ignore it.%@ = errors.MiszEnvelopeHeaderDg()Hself._cur.Rs.append(5continueR# Split the1 on colon separating field name !Zvalue # There will always be a M, because ifc)Basn'|{part ofparser that calls us would have started (4Jbody1i =.find(':') lI4 is _" o! h'{clearlyMmalformed, but we mightble to salvag^Pe res[ Iessage. Track!<Wkeep goingf i == 0:N!yInvalidxP"MissK.."U assert i>0, "_"e_zQs fed with no :gpno lead9WS"NBlast>M[:i]"@ = [P# Donath allo"s, so hand+3ast{6if ~ {+set_raw(*rpolicy.r_source(K)) class BytesFeedP( )p"""Like feed accepts bFB."""@def (c, dataN1super().".decode('ascii', 'surrogateescape')) # Copyr0(C) 2001-2010 Python Software Foundation # Author: Barry WarsawLntact: email-sig@pG.org """C esXgeneraterin text2a mM object treep__all__"'G@ orDd] import re 4sys 5timrandom AScopy :@deep$ioStringIO,"IO!d.utils*U_has_s UNDERSCORE = '_' NL \n' # XXX:Olonger used by below. NLCAre.compile(r'\r\n|\r|\n') fcre = ! ^FC ',MULTILINE >es outpuMTcbasic por writ%he!togiven file object as plain text. 1"""# Public interface def __init__(self, outfp, mangle_from_=Nonexheaderlen!*,Gapolicy!%): """Create the generator for message flattening.T1 is8output file-like objectFqwriting(Ruto. Itmust have a 0e() methodrOptionalaaat, when True (default if tis not set), escapes FX lines inqbody of `by putOPa `>'4Sfront1m specifieHlongest length?a non-continuedp@. W"a J r (in characters, with tabsHexpanded to 8 spaces) than ma,ewill spliJpdefinedzH class. SetQp@zerobdisabl\g@rappve The Ps 78,gqrecommeA(butrequired)by RFC 2822S keyworda.Pthat rols a number ofea#tsJP's opU0ionDf no]%issd=associatedChe McBpass&thBE8useM-ifT[&z" =cVb3S else.2lb._fp = 4) = *) )K=ai7, s0# JQdelego aC_fp.L)^msg, unixq=False,Awith7msg5""">@# We'q_XXX co!tsm oping on data that comes directlyNmsg, and _encoded]Nhas already been0ver(to bytes iJB O)|J2ins8 into a temporary buffer.,G = 5 if self.0s NHelseD!if?wais not0: L"= s.clone(=)3maxheaderlen]@max_Y_length=QoE_NL 95sep"*( ,NLTEMPTY = ''K!AaNQ# Because wD (below) ewe recursively process message#W0parUbYR$us7@ompu$ ()K` s will automatically get settUcTthey are^0is Xold_gen_=%6msg%t:tryW .E0 pif unix Z=u pDget_*(' !t 2I"^Fnobody ' + time.c(..()cbwrite(L+H_j)_*6msgJ0fin .:0 =  + K(Adef V, fp)k@"""CHu this g] exact same options.creturn_class__(fp_mangle__2 As, # Useting, which we've adjusted  policy=self. 0) .# Protected interface - undocumen";/,9 Note that we use '_write' when w@are ing is com BfromS the source, and J@_fp.6eM# aObuffer (beca_$Bytes subclass has already had a chance to transfordata in itspe metho0case). Thisan entirelypragmatic split determined by experil;Qcould be more general bLalways usI%80hav$z!ctW)it!edinput; but, si'@wholt%ishack anyway t(seems good enough.Edef _new_(!): Gtor overridesWto return(5IO.;StringIO(qaencodem?, sp<! sXs-bX ys{c_linesu yjWe hav~z+ endingsfpif not s04" = NLCRE.x()#1forIZ[:-1]V>=s 6_NL!!if]/s[T "8# XXX logic tells mjs else sh pneeded,1tests fail# with it\pout it. (ls0a blank eleO!ifJponly ifwR< il0newN.X#<j;5(8% .@(sfpCvalue()) Udef _2 , Q# GetGA1for], n try to R f_"._%__W, str|-raise TypeError('str3 expected: %s' %P{is_surrognT(msg. uycharsetSram(''3if (# XXX: This copy stuff4 an ugly hack to avoid modify5the?Jp# existmessage.$msg = deepp H0del['content-transfer-encoding']Y'.s , g" T[I_munge_cte =  ,I 7msgEVype']3if x`angle__fcre.sub('>F$',QN e_s# Default r_6iBody =:multipar# The trick herem!to!e out each ?ly, merge them allK# together,Vthen make sur0 at5 boundary we've chosen isn'tLpresent in5]0msgVs = [0sub( \0eli&# e.g. a non- ctHse of a  with no starZ,(uI! DjF9k, list# Scalar U:j r fo6r _new_buffer#zclone(sg.flatten(`, unix`=Falseanesep=Bm).append(sgvalue(# BAW: What abQies tPre wrEddouble-quotes?  boundary = msg.get_0() "eif not-:# Create a! that doesn't appear in any of theBmessage texts.0all = self._encoded_NL.join(msg s7FmakeU 4sE'1# I%re's a preamble, write it out, with a trailing CRLF !ifk<1 is]JNoneY#ifmangle_from_#PI= fcre.sub('>From ',k8;elsqN$t_lines(' b('( 6_NL!t# dash-d-nsport-padd6ALf'--' +m+' ^body-party- F\B_fp.`mRx.pop(0)*encapsulation # --> delimiter * 1for_0m #j l o_NL + E># IK4.oclose-N/ N.epilogueU.IU"U,f 2U'!) )def _handle_multi&q_signed`),# The contentsy- 9 s has to stay unmodifiedw0ordao keep|# C ature intact per RFC1847 2.1, so we disable heaMwrapping# RDM: This i(`enoughcompletelycQserve}P, butjGhelp,pepolicyX = p.clone(maxf_length=06tryDB zy5ofinall9{_#very_statusPWe caQCjustr$thcs directlyB's file objec # because, this will leave an extra newline between the last header # block and$boundary. Sigh.)'es = []for part in msg.get_payload():'k:self._new_buffer()#Ag = #{clone(s.flatten(r, unixfrom=False, Asep=B:_NL>@text_[value|>0 = (r.split(I}encodedQ# Strip off8 unnecessary trailing empty !ifsuzc[-1] =_tZEMPTYGK}.appendb.join(VZ:-1]) OelseS 6`# Now VA allQ withr@. T1has)elovely# effect of separat'3achS, but not addingMone afteru6onefp.write31)) bdef _handle_mg8, c# The .#a hr/rfc822Zshould be a multi sequence#Blength 1e zeroth elementFist VMM bj!0subw@. E]ct that o&, stringify it,Jrv it out# Except,Pturns , when it's aV insteadQich hs*gAonly! HParser is used onC.mime typE 4uchs are generated by, "example,Groupwise`forwar unadornedV. (Issue 7970.) SoKiPat caNe just emie%Fbody^U=.TPif isWSance(-A'stVgt /0)h18 7f#toG odule level function; we( a classmethodd=# _compile_re so7can continue to providemmN=@back Vatibility by do # _make_boundary = Generator._make_boundary # at the end of $module. It *is* internal, so we could drop that...L@classmethodJdef t(cls, text=None):(Craft a random f3 is given, ensure~gchosenM> doesn't appear in0|stoken =z.range(sys.maxsize)][= ('=' * 15) + (_fmt % NE'=='6iereturn5>b =0couE = 0)while TrueYcre = cls._compile_re('^--' + re.escape(b(--)?$',MULTILINEif not cre.search(K%UbreakP + '.Cstr( iU += 1G( pms, flagsG3re.-(%A  BytesGener<( H3"""`es a b. versionIa Message object tree. Functionally identical toSbase \or excepoutput isx1andstring. When surrogates were used inEto encodeL,se are de`d backmBfor he policy hacte_type set9A7bitY~mis transformed suchnon-ASCII`properly contenYC#erd, using charsetMunknown-8bit0The$fpqmust acrin its write 92"""x(self, jS._fp.!.o('ascii', '6'))V_new_buffer\{M8IO(5c{ 4s<_headerstW, msgy`# ThisPalmose same ass ,6handling"# .ps with c#80, vmsg.raw_items()kBelf..fold_binary(h, v)k # A blank line always separ9 1 frd6p0(H._NLJ e_ HIn;original source wasDj2 itout. if msg._payload is None: ereturnif _has_surrogates(mD) and not self.policy.cte_type=='7bit'b"if-_mangle_from_#g = fcre.sub(">From ", ")<_write_lin,;elssuper(BytesGenerator,O)._handle_text!) H# Default body %rB=G?:@classmethod0def _compile_re(cls, s, flags)#C re.-(s.encode('ascii')5 _FMT = '[Non-@ (%()s) part of message omitted, filename %( a)s]' 0 Deqd&( 3"""Qes a xrepresentationway.Like the <or base u, except that ns are substituteRwith a format string k@.1"""_init__(, outfp, =?xheaderlen3fmt !*,Q'!,1"""$._)pan addiBRal op gargumentsallowed\fWalks through all4sA If0subN&&aiC ` ',,n it printb2e d# qoROtherwise, fm is used insteado$. Mexpanded 3 fokeywords (#%(#)s"):C : Full MIME  Amain&9OMain93sub8 : Sub-q q#Fi adescriT6: D associatG\v@Conttransfer , Th@YPvaluexfeaning1  Q(if5w ._% = _fmt = fmt def _dispatch(self, msg): for part ing.walk( 'maintype =+.get_content_%()S34if  == 'text'v#`print(U payload(decode=False), file= d,elfPmultiNk# Just skip this*asOelse._fmt % {KO'2' N :9?(),<<@<@0sub`?|?q@name@Q('[no%/]'description'G2('C<'-D  ? _encodingTransfer-E) e}B # Helper used by Generator._make_boundary _width = len(repr(sys.maxsize-1)) _= '%%0%dd' % 4 # Backward compatibility d/ =# Copyright (C) 2002-2007 Python Software F # Author: Ben Gertzfield, Barry Warsaw \ntact: email-sig@pW.org """Header cQ and ing funcqa.""" __all__ = [\'A'';1e_hVq ] 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')Med-word stringsthe form =??q?Hello_World?= ecr0re.ile(r''' =\?& # literal =? (?P[^?]*?) %non-greedy up to next ? is7? iji>[qQbB])ieither a "q" o b", case insensitivefBed>. # non-greedy up to the next ?= isencoded string \?= # literal ?= ''', re.VERBOSE | !MULTILINE) # Field name regexp, including trail colon, but not separatwhitespace, # accor; o RFC 2822. Character rangefrom tildeexclamation mark. or use with .match() fcre = compile(r'[\041-\176]+:$'nd a header embedAin a putativevalue. Usedcheck for ##Qinjecattack. _T_d \n[^ \t]+: # Helpers _max_append = email.quoprimime. def dek(r0): A"""D a messagAout convercharset. BReturns a list of (i#, )p) pairsC@tain@each+dMTparts0set@None]T non-6,Ootherwiseower-case !of3t1setKspecified in#} ` may buQ that!or0conT2047 PSwords2r i8MH obNq#Anrerrors.$PEo`be raiwhen cerzy*occurs (e.g. a base64@)@xcep!)./1"""@# Ifi , we can just r, ?bchunksOif hasattrB, '_!'F0[(__=yCstr(0)),G0for&5ing.];"no1 6:4 noecre.searchI , )~First step@to pI allX inVripleXCform(9"d_,@@. FMn+(!s,o2las A# twpts willB = [oGlinedPsplit's( "= 0#($)fe= TruePwhile"ts*u=f.pop(0O%1if V ;? .l<*p(E/Fv = Fals5if @g-.%(())n if p{arts: charset = p!.pop(0).lower()/encoding0+ed/ Wwords.append((eAed, Sing, )# Now loop over ? and remove that consist of whitespace# between twoled strings.#Pdropl>A= []for n, w in enumerate()^aif n>1Bw[1] \[n-2]1][0].is(G2n-1dreversed(+B2del A[d] # The next step is to decode each  by applyCthe mKbase64 or quopri transformation. Y d_Msmanow a UTof th5" (/)s )2ed_9( 7vis Nonez*iQan un-!edO%  8Belifnj== 'q' = email.cmime.header_y0j`#5D_2bpy|r = leny % 4 # Postel's law: add miss0pad??2if V t += '==='[:4 -5->tryF FF except binascii.Errorbqraise HPQ(2('B ie?'p;elsy3e DPAsserUnexpectedxU: ' +`convert alD)Qbytescollapsebecutive runs ofD# similarly`=\@]Alast*` 4! =V .if isinstanc, kN1 = 'raw-uniw-escape6if ;=0l #2 !=kIB[,7charset))  last_word =  1 charset = #Jelif$is None:#NF\ += BSPACE +m?els5 =Scollapsed.append((],!))0ureturn 7 def make_header(decoded_seq, maxlinelen=", %R_nameYcontinuation_ws=' ')"""Create a Hm from a sequence of pairs as bed by !) v  takes a value string andQ"pJtof the format B,t) where1 is6hNM%acter set.This func#!on_those =linstance. OpP'al , @ arem!inO^ constructor.1"""3h =( u=1,?( c + Ufor s~3 in YS#k" means us-ascii but we can simply pass it on to h:lI(if2notYA $iss(bset, CE$ = 1l! h cl__init__(self, s q "- ' ', errors='$ctMIME-compliantmQ thatain many+s,Qsm4ialPQ. If, $ ,HQ You laK n with ,method calls. s may b5byt|or a UniX,0seea documentF semantickserves two purposes:#ha1ame#}D1arg{h`t alsoD defaultLrall subytK<@omit &seO{ provided   set is used both as s's initial charset andthe default for  subsequent .append() calls. %(The maximum line length can be specified explicitly via4/hlen. Fuplitting RfirstXto a shorter value (Qccoun25eld&header which isn't included in s, e.g. `Subject') pas)Luname ofN!el<[_$0. D3max` is 78drecommendeby RFC 2822Qcontinuation_ws mustJ+ complia ld*whitespace (usually`either; o hard tab)@willc0prehed to N`errors89`hroughA. 8.H5""" %ifis None:= USASCIIelif not isinstance(.2, C)M 1)Vcself._H$ = =1<_ws0hunks = []1if <x$s,", t'ifMK= MAXLINELENk_& &7if jJ'ulen = 0@;elsa# TakelaseparaQcolon&inCnBlen(~R) + 2def __str__(8"""Return trUc!ofS.D._normalize(/ucPlastc=Qfor sL B# We,ppreserv|aces between encoDnon-6worV# boundaries,#Pmeans us we neUo add\@when%goOdfrom a/us-ascii, or $ (aJ. Only do thio@seco7nd  :@# Doi  already ha"a `(trail:aor leadQn transi,D2nex  $= .UNKNOWN8BITPoriginal_bytes = string.encode('ascii', 'surrogateescape') : = original_bytes.deKlreplacCif uchunks:[hasspace and self._nonctext(>[0] if lastcs not in (None, 'us-)u`if nex95SFJ.append(SPACE*u = &el~ >A+-1>Ccs =I | return EMPTYSTRING.join(7!) M<# Rich comparison operators for equality only. BAW: does it make sense to {p# have 9xplicitly disable <, <=, >, >=g?def __eq__(w, otherY# may be a Headerkax Both are fine so coercecourselves to a unia (of the un2d h`value), swap"KAargsQdo anI.*!=&s, charset=, errors='7ct'A"""A CMIME.Optionala, if given, should]C instancV6namMAof aIacter set (whO@willIconverted,a VU). A'j1 of (odefault) means thatuo&thconstructor is usedsBb;GU hpng. IfWis a -(i.e. is&0(s,P)w@fals8Etheni!e ceing ofLe,Z#a E X`raised&J0can2be =bd with=Xsb@ing,anM hint specify}RF6s iL/@n ei case, w(`produc[an RFC 2822TUliant us+(047 rules0q2ed 1-poutput c|0set YPto the  output codec, a Uni Error will be raised. Optional `e)s' is passed as the  argument to de_Icall if sAa byte string.$5""" if charset1UNone:= self._$pelif no>instance($2, CZ)S 1)VT s, JTinput$ =. or 'us-ascii'a3if )D == M.UNKNOWN8BIT:bs = s.z(^, 'surrogateescape'8;els_ N ,F# Ensure that`s we'ro@ canfd*#/acter set, otherwise an earlyL.{|#if%?!y?try0.en(x9eexcept9X &!=/^#^ u = UTF8Munks.append((s,Rset))def _nonctext(57, sq"""True!a 5Rof RFC822 return s.isspace()<s in ('(', ')7\\'~Aplit=';, \t', maxlinelen=] , sep='\n'Qr"""E a message header intoRFC-compliant formatDThere are many issue`volvedconverting a givenUfor use inCmail. Only certain XAsetswpreadablFU mostKeHclients, ansob!onbPa sub%ofJ7-bit ASCII, c0ustPtakenPpropeoe (withM`Base64quoted-print)s. In addi,y reaM675-length limit on pd`field, soH `-wrappm0perPed, e double- Z specifieYmaximum of each generated, exclusive of  linesep string. Individual lines may be longer than max$len if a folding point cannot<found. The first[L@will' shorter by the length ofheader name plus ": "wO#was specified at H@construction timedefault value fos determinUz U Opkal splitchars is a str,qcontain haracters which should beNgiven extra weight._tGalgorithm ducrnormal Kawrappi1Thiin very rough support RFC 2822's `higher levelMsyntactic breaks':  s precededa @ areeferredO],a, with ;*2pre=1 in or(%inMLthey appear*. Space and tabPincluXO6 to indicate whetFence to one overNo9a!0R"n  Ps do S &P be4tBdoes=affect 047 encoG/s.)ep to@used Psepar 6%ofWk is most useful~v typicaa`Pythonltions, but ii0set@\r\npproduce-compliant oqPen ne.%5""" bself._KUize())if us None:1D"= J*8# AJof 0 mean@n't . For all p-% purposes,KPchoos a huge number here ac0she~!at1makn@# _VFAt\ mufimpler2 O== 0 !10fg=y(5Glen,)kAn@inuaB_ws,^]lastcs =Ahass( = ! $3for, etm|Zhunks5if XiQ %&=aYnonctext(6[0]<!ifcd@in (h, 'us-ascii'):/  if not hasspace or charsetin (None, 'us-ascii'):J] formatter.add_transition()3OelifkA andAlast}yF = stringaself._nonctext(J[-1]>Dcs = By= False@line9Za.split 1if feed('',*D[0], OelseHL B1fore1 in_s[1:]S 0new .header_encod!isf\< continua^_ws, ' ' + .lgIp(),K(@s* =ml fw/`[:len( )- D/)]6Ff06]ns) > 1HD3if TZhunks=9value = +A_str6sepSif _embedded_.search(C Xqraise H.PrError(": 3 appears to ]ain "TD"an y ?: {!r}".breturnd P`def _nPlize(1# Step 1: N#a the cR so that all runs of identicalsh`# get collapsed into a single unicode.6l6= [V_0 = d0Iunk 4A%ngo"._e #C == Wt(@unk.#ndm{&{5ast9i(SPACE.join()),),(b"&":unk+x class _ValueFormatter: def __init__(self, headerlen, max continuation_ws, splitchars)HL?"._4# ==f J; = 0 _len = len(8)9' = &lines = []current_! = _Accumulator(!!) 6D3str@3 0TZ>if (.is_onlyws() and#M ?C@[-1] += 07OelseM .append(MNjw.reset(add_transih dB`Afeed>1, fqtring, 'etT# If thes has no encoding (i.e. it is an ASCII#Ln we mustvP!at"highest level syntactic break"T~# possible. Note that^don't have a lot of smarts about fieldHc x;<jbtry top on semi-colons,sn comma Iwhitespace. Eventually5is should be plugga=$iff.A__kis Nonjaascii_(;|# Otherwise, we're do ei a Base64 or a quoted-printGwhich meansV@needXHaLs. We can basicN find enough9`acters_0fitT7theNrq, minusRFC 2047 chromWF@make!is trickierM!thw-"wem#to at octet boundaries, notM$ but it's P safe/a>Xh so atO:w3Gget close.&!edcharset.header_encode_lines(string, self._maxlengths()) # The first element extends the currR, but if it's None#nLnothing morU@t on# F so start a new Z.DEtry: A = edvs.pop(0except IndexErrorIre are noK s,we're doneVretur"if/q is not  ouappend_chunk(fws,< Blast`9was only  p0new)(l_c.push(ontinuation_Br# Every#2elsBfull! i.vmselves1for! r"s.x! +N!) hHdef )Y662's FYyielde -%~B2 while TruelM:._ccG_lenascii_splity!, o]charsRFC 2822 header foldalgorithm`simple`princi 1butC@# co"x#actice. Lq may beZed any place where "rMwhite space" ars by insert@sep Pacter{front ofwPQFWS. !icAthat2allq s or tabs qualify as FWS,PRand w alupposed to prefer break at "higher levelGAsynt+ +s". We can't do eit7se withowntimateKknowledge structur ds, which doo8havPP. SoJP best+0can=5specified0s, >0hop?aW@choo,nyL0arePlegal. (Thisat least bet1thaVU old `we wouometimes *introduce*f0 afQ%a ,*h7b@ befldQ q runs intoSsingl .Gparts = re.split("(["+FWS+"]+)", fws+string) if parts[0]::0] = ['']Oelse+f.pop(0Y0forq,_ in zip(*[iter(\Z)]*2)Iself._append_chunk(fwsC!) Jdef "5#, U._current_line.pushV.W~if len(4B) > fmaxlen`7## Find the best split point, working backward from,Eend.{HThere might be none, on a long first 9j chcZcharse,i+_range._count()-1, 0, -1Jif ch.isspace(%)Sfws =DV[i][0[+ ifC@ and~[0]==ch3Ybreak@prev_-1][1$=J?[-1 BcontinueIE/v/if._initial_size > 0y"# @willa header, so leave itine by it 0new(#`if not$# We don't use Xation_ws i@becaQwhiteSdafter should alwaysB ;=' 'e ireturnJremainder_*(iN}r"s.}O(str)8u.reset() class _Accumulator(list):l!__s(, y'=0W) =.super()._Z?K6   +E"opLIicpopped6[i:W.U 7R1'== return ('', '') return super().pop() def __len__(self):85m((len(fws)+ part) for fws, A in ?,?C._initial_size~?str~EMPTYSTRING.join(()z Qreset , startval=None%if@ is 7s9U = []U[:] =>  "F = 0is_onlyws:elf@==0 and (notr or strA.isspace()R_counf@1) """Rep4QntingrmanipulaDemail headers via custom objects. This module provides an implementation of the HeKRegistry API. The.is designed to flexibly follow RFC5322 ruleEventually awill be a publicr, but it isn't yet, l,Pprobakchange some before that happenv""" from typesort MappingProxyType $J0imp$_utils_error__value_parser asser class Address:y_, display_name=fEuser adomainaddr_spec<"""Create) rCb full G es,W3An  can hav'd', a ' nde'. InzAaddi`0to 0ifykB= separately, they may beOCivgether by usT keyword *instead of*SK5sfBP0stre#is%itN@mustproperly quoted accord: to ;aR raised ifR not.5JI has<$, ", Z,fattributes, allwhich are read-0. ?MND~IObothLwithout any Content Transfer EncoV=inputs = ''pfilter(L8, (,_) if '\r' in inputs or '\n' in7: >raise ValueError("invalid arguments; address parts cannot contain CR or LF") Z# This clause with its potential 'x ' may only happen when anIapplication program creates an Aobject usingW_specKkeyword. The email library codeelf must always supply usernameNand domain.!if,y@ is (JNonet%ifPE ##D Typ Rified0 and/or "G"tV alsoN)")9a_s, rest =ser.get_( 8!if6lIl1ddrT;O'{}' "could bepd from >".format(  a_s.all_defects '9[0]~ = *`local_T &$  self._display_8 =  *r "aF @property9defd()preturn  MI %EC #A D0"""  $ (@RQ) poraof theess, quoted6WPccordto RFC 5322 rules, but`no Con Transfer Enco9[&""Blp =ps!ifu0par DOT_ATOM_ENDS.isdisjoint(lpS6p_string*]Alp + '@' ++B/lp=E'<>'+Q__repr__+H"{}( e={!r},l )&__class__._u5__,1, 3/stJ r.SPECIALS.isdisjoint(disp):  = parser.quote_string.-0if , >addr_spec = '' if self.=='<>' elseXreturn "{} <{}>".forma%, N)51 m def __eq__(w, otherif not isinstance(", Address+NotImplementedjk. lay_name ==z &an<@Z.user84gdomainj) class Group:EinitR=NonekQesses """Create an object representingPess gw.w!An consists of aV6followed by colon and apAlist7ues (see terminatBqa semi-Ib. TheOAis cq1ify  possibly empty M@Rs. Ao can also be used to> a singleII0tha2n aZ, which onvenient when manipulaN!s Lare a comb$0ionK&shindividualRe%InM thwzase the$`should0setSP. In^ticular,8Ni #ata9Kwhosg0is Y7sam9,e4 onpd only ( ie!es6"""_O) = *es = tuple()9#)Q@propertyTx( M{J &G __\1"{}PX={!r}p;$!__A__._d?__,*,zI>strF<x 1len U:==1{+tr+6[0]c" =  w SPECIALS.idisp):   disp = parser.quote_string(") '$ adrstr = ", ".join(str(x) for x in self.addresses;T' ' +J$if Celse oreturn "{}:{};".format,,!) .def __eq__(, other):if not isinstance("w, Group)-xNotImplementedKi. lay_name ==x &an<^&99 # Header ClaMP # c R Base"):0""" $message hH"s.(s generic behavior and provides tools1subVeD$A  must define a}pmethod 1d 'X' that takes an unfoldWbvalue s a dictionary as its arguxs. The"Awillcontain one key, 'defects', initialized to empty list. After the caN btwo addilm"s:B_tree, setg1the 0 obqed from41ingz,'decoded'K(5!of:3iderepresenta Bdatap;. (Tais, enpP wordn#e 4s0hav'bnonicaz w@5so 3ed.7 is intenducollectq, whichX r sequently 0oseas appropriate?9`should,PpinsofaruPpractP, rainy errorDAbZ q3eadv}Cdarders regisv1RFC`compli issues,obsolete RFC syntaxunrecoverableg1ingN   0mayu. In this cas\0n ''gb ss-u0key use (usually byCsett`msimilarlyattributes)remove allyPPextras$Qed byFPthen 0sup[oZ-1entPXB wit`remainjalso make surea 'max_count' attribute is def:ined that is either None or 1. XXX: need to better define this API. D2""" def __new__(cls, name, value):p0kwds = {'defects': []}cls.parse(9 , 0) if utils._has_surrogates('['decoded']qu$ =Fsanitize@rself = str. q11delpMb.init( **Gpreturn 'U0S1*, #`_tree,I- ._c! = _>' =K &$ =b@property/i(t=f@Qtuple#._*)Jy__reduce__#(_reconstruct_header,! /3.__class__Zame__7)_bases*"tr E)ycdict__@Rmethox9  (NAfold , bWolicyG"""Fold 9 according"p-.L2TheYd representation of theF0is w)edPRFC5322 rules, as modified byHz2 IX Econtains /QescapDtWbytes are CTE enHe usingI( cht 'unknown-8bit"Any non-ASCII /acters in@n ;set utf-83mak"a setting|"ed1an P-onlypossibly $ulinesep, and enswith a .0. 0strMincludesNDB7R': ' separator`R# At some point weput fws here if it wauusource.1r.H %([!nK[Label!%VTerminalE.2, 'k-'@6':':ksep')];]4!if0.ncr.append(  parser.CFWSList([WhiteSpaceTerminal(' ', 'fws')])) Gheader.append(self._EV_tree(sreturn /fold(policy=) def _reconstruct_. (cls_name, bases, value):YNtype)H{}).R(: class UjQuredH!: Vmax_count = None=r = staticmethod(wr.get_uU)O@o+K3c, kwds`![''N'] = cls.15qdecoded2Bstr(Kq~ Unique ()1NIDateF2"""b whose  ists of a single timestamp.2Provides an additional attribute, date6, which is either32war' uj! ajzone, or a naiveMb if th%!ininput stringn-0000. Also accepts aK1as 3.EQThe ''Gonormalized form,Cmeans it<0out!of;5at_o2"""b d`# This\used onlyX ing, notPcreat 'l`%X!ifwdefects']rerrors.0MisRequiredVY(HoS lv!''P!1 = qr.Token04Gif isinstance,26  = utils.c5_to=m&rF{!U^rgI c h>-Ainit_, *args, **kw{{ = kw.pop(''super().UO@property~Du |Y( I rAddresss@(value):  address_list, value = parser.get_!( 3) assert not:, 'this shoulduhappen'3ireturnw @classmethod2defC(cls, kwds):!if isinstanceW, str#'"# We are translating here from the RFC language (/mailboxNto our API4cgroup/:%).3!['W_tree'] =q = cls.a_(r {dis = []`1forO* i\.&es4L.0d(G.display_name,g7"[AG9(mb>o or ''DXmb.localtB%bdomain> Ch D$mbBS.all_Jes])E`defect97F9 5Jelse# Assume it is B/i stuff{#ifPCsatt, '__iter__'M, 1q(None, [item]) m5, 'L'h  B 4-X]Y p ;! "Qcoded"', '.join([str(() d] 8if !in   &#de)&init(self, *args, **kw"._ = tuple(kw.pop(''/0 = super().wq@property1bm#A D2if @": b %7f-s R1in Bp 1Qes s UniqueyHeader("):)max_count = 1?_Singl?y def address(self): aif len1.ad#fes)!=1#*raise ValueError(("v of single > header {} is not "mJ+"a5").formatename))7preturn [0] class UniqueSAH(1): Zmax_count = 1KMIMEVersionC._parser = staticmethod(.r_mime_vU)}@-Adef .a(cls, \g, kwds![''_tree'] =6q = cls.<( KBqdecoded?2strC*fects'].exten+q.all_de 7Qmajor_cNone i8PminorGelse.;d2O.)cg VXt'{}.{}'!"']!['q&']Y }2ini, *args, **kw, = kw.pop('}*('&rN&quper().@propertyng_"?? "? A $Parameterized # Mixin that handles thams dict. Must be subaed andD# a 'A forKspecific!provided. % psQ"!{}o`# The b RFCs syE orderingsarbitrary.X\3sxutils._sanitize(@.low: A C 3! @m8 in/}Dcgs, **kw):  self._params = kw.pop('2') & super().init(*args, **kw) #@propertyBdef B(`!):Kreturn MappingProxyType') class Content"Header(PeterizedMIME"):Pvalue ser = staticmethod(parser."_cZq_type_h\(, >`._mainc = utils._sanitizse_tree.,t?subC+co REeD $C~H  + '/' + ] &Disposition->db4B cd-~O" = cd ifs None else/cd.y  ransferEncodingmax_count = 1;a#_eb @XEla(cls, pg, kwds[@'] =l1ls.<|( Bqdecoded?2str*fects'].exten+q.all_de 6?cte3cte~""ctC%teMessageID PQ^&mQ%_ir # The  factory # Cault_map = {'subject':   UniqueUnstructuredHeader, )p'date': >IDate6resent-= 0Oorig./ fosender6SingleAddressF9/tot%xr@3/ccl+@lb-9@3OfromD@loreply-v^9mime-versionRMIMEV Y@cont?typ<C:Typ57dispositu7Duransfer-encoding>TE Cmessage-id4M(ID5} class Registry: ?a"""A hP_factory and# r.B."""1 def __init__(self, base_dD=Bas3 default 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 ~ 0.upF(nR_map)q3pmap_to_q6b, cls): """Re6gister cls as the specialized class for handling "name" headers. 5""" pself.re]0ry[2.lower()] =m +def __getitem__(7 , /!):!Y = RP.get('V, default_)Breturn type('_'+cls.__@__, (cls@Cbase=X, {})Icallw, value"""Create a  instanceD4 'z' from 'D'GBsC@by c_auparsingand represent9DfiedZTombin"ufactoryGo with _0 orQE  , 0pas'1 toconstructedI5's 'orA=]6> # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw Lntact: email-sig@pG.org """Variouss of useful iterators3gen.1 __{A = ['body_line_9"',d_subpartCwalk*# Do not include _fure() siPit's I`debugg$AAPI.r] import sys 3io  StringIO # This funcG will becom/dmethodirMessage &o"""Walk ovee# m3tree, yieldSeach $@The O is performed in depth-first order. Ais au&!if .is_multiJ(/V~_payload+/^b6.%()^uese twoc s SIn.py interface module.ob(msg, decode=Fals2"""Qe2s, ~s  s @-by- Op#ald# (/ massed through" 1  `3msg1[% =#5getNTif is(CW, str  /l@main ='text',?Non} sgiven MIMEx. Use `mai ntype' as the main MIME 0 to match against; this defaults to "text". Optional `subtYiYTW!ifIomitted, only"is1ed.,1""" for subpart in msg.walk():$if".get_content_[Q() ==7; is None p NM LPTyield def _structure(msg, fp=k, level=0, include_{c=False """A handy debugging aid"Tif fpfp = sys.stdout.tab = ' ' * (}Q * 4)`print("+fK!(), end='', file=fp9,ifU' [%s]' %Y_Y QLelseC !!ifIis_multi3xpayload*h-+1#) # Copyright (C) 2001-2007 Python Software Founda5 # Author: Barry WarsawLntact: email-sig@pG.org """Basic message object 6W pack`model.! __all__ = ['MCP', 'Em] import re $uu quopri from io * BytesIO, StringIO # Intra)s9_ utilXerror._policybaseyP, compat32`pcharset_ &._encoded_wordsX deC_b C>$= =. SEMISPACEG0; 'Regular expression thats `special' `acters`parame,  # existence of whichpce quot of* : value. tcps = re.ile(r'[ \(\)<>@,;:\\"/\[\]\?=]') AplitQ(u0# Sv headerrs. BAW:* may be too simple. It isn'q # strictly RFC 2045 (secQ 5.1)liant, but it cses mosts0# fP<wild. Wy eventually need a full fledged2ser[# RDM: we mhave a HPhere;x now justngify itCa, sep, O3str;.iE(';'0not.return a.Ap(),zb&MXforma,Tquote=True): L """Convenience function to format and return a key=value pair. This will quote the %if needed or if is true. If )@s a Lthree tuple (charset, language,/R), itrpbe encocaccordingIo RFC2231 rulesnit contains non-ascii heactersXlikewiseLe" a, using Qutf-8W!seBGea null.1"""i not None|Alen(%a) > 0:-*3# A(pis used parameter;s where itemsL/arp %. is a string, 2a CNpinstanc:RFC s qRnever`d, perTif isK,))1# E4 asFt% y += '*' = utils.8@_rfcGv3[2]z%[0 91])G$'%s=%s' % (r9,Jelse:try!(''E"except Uni^ErrorMHj 1, 'K', 'A# BAW: Please check thi n)at)@it shouldp#!ce;t@even7necessaryIzor tspecials.search QH"%s"&O;I 62 def _p#(sa# RDM ymight be a Header, sC nowbify its = ';' +"(splist = []dwhile s[:1] =/T@Bs[1:*end = s.find(';"H 1> 0 (s.count('"', 0, end) - '\\V) % 2{mBB + 1# ifV( <. = PfV[:endif '=' in f}i = f.index('=J`f[:i].p().lower() +O+ f[i+1: k:~.append(f?s3endu$ %!un#'is different than ut:ils.collapse_rfc2231_value() because it doesn't # try to convert the 4a unicode. Message.get_param() andF s re both currently defined]preturn qtuple inMface of RFC  taeters.'if isinstance(!, I!):!dR[0], `1], ut0cunquot@A[2]);MelseE1) class 7"""Basic m6 object. _A5 isas something that has a bunch1822Jpheaders! a payload. It may optionally have an envelope ;F(a.k.a. Unix-From or _&)Sficontainer (i.e. aOmultipartGa/rfc822),G`a listJJ6s, otherwi{cstringQ4fs implement6VS`mapping' interb, which assumesuke@exacbone ocN@D perd. SomZMdo in fact appear le times (e.g. ReceivedS for thosK,you must explicit APIR!sespget allhbs. No!ofM@ ovods are;"edh1"""1def __init__(self, policy=compat32x .# =(F_@ks = []Punixfk= None6@char # Defaults]preamble = pepilogukdefectqYtVmutatc4,bamodify] $'s in place. Optional1i rs that index intoLA`a flag;icating wheC should b\dnot, accord@~Content-Transfer-Enco!eheader(defaultWhen True and".\%a , if this 's ueO`quoted-printable'`base64'asome o(e is d,6=bZqmissingHhas bogus data (i.e.V!uum!ed%)J#ised as-isOIe is]csknqiQ# Her[alogic YB for , !(email5.0.0 P# iU is_mu result1# - -G!  k-%,J-=1 b-(h : element i (a M|G Oe" (g;; ;(l1d (bytesBNote$PBarryR1nnefactor out the 'decode' case, but that # isn't so easy now! we handle the 8 bit data, which needs to beMconverted in both>decode and non-Upath.<if self.is_multipart(): 2if < return Nonqif i is6y_payloadrOelse75[i]:# For backward compatibility, Use isinstancthis error messag # *aead ofMmore logical .Y testQ1nott|(k, listsraise TypeEp('Expec-, got %s' % typeQ%))\" = l # cte might be a Header,1forstringify i8R= str|get('content-transfer-encoding', '')).lower($# 0maybytes hereQ(1,{ 4 if utils._has_surrogates4 /bO$ =.e('asciiIvescape'B0if $#>try.L\_param('charset), 'replac]except LookupM!n/el%l0Uni0# T wogphappen 1RFCTliant3s (s<= # aining only ASCII p pointszuv input)KP# If o!, IBq0 inin a wayguaranteetOfail{sCraw--!if]== 'quoted-printable'Acquopri( j~= 'base64Oq# XXX: Ais aDof a hack;_b should probablzfactore@# ou0mew`I have]qfigured%where yet.  ,value, defects = decode_b(b''.join(bpayload.splitlines())) C3forD3 in )s:#'self.policy.handle_z( [qreturn Qelif cten('x-uuenK', ' !*')in_file = BytesIO ='praise VwError("There may be at most {} wG"in a message".format(h)N.(.!nd.store_parse MUjTC"""DZ6ll s, if presentD?pception1A,missingZ 2newFes = []/foX T!en(`containsa\Fin []hCiterd^<X/ues yN1\AkeyskXA"""Rq a list!ll.'ss,These willQ@sortnC orFtheyviViginao`, or wPadded!o1and duplicate-2Any"s ] d 7qre-inseare alwaysnk0[k V *C|y appeared in the original  message, or were added to/ and may contain duplicates.KAny fields deleted 7re-inseralways appenkeheaderMFlist[5"""return [self.policy.=_fetch_parse(k, v)5P for A in A_;1s] ,def items(!):="""Get all2's @@valu<These will be so i0derSy@aredQ #1get, name, failobj=None.Like __get__() but pU instead of `B wheis missing! =v.lower(Dif k<" =L "&~4"## "Internal" methods (public API,3only intuse by a #tgenerator, not normal _ion codeD#yset_raw QStoree"_model without modif7ionThis is an "v. ((!, &))@raw_R* ?_pairsC?Aiter.Tcopy(RAdditional useful stuffp qget_allR a Ids ;yd <@/ 9>A If no suc*h fields exist, failobj is returned (defaults to None). 5""" values = []pname = .lower() for k, v in self._headers:#fDif k<" =L "&}.append(Orpolicy.U_fetch_parse(v)rif not C [2 sdef add0, _1, _)@, **Fams)f"""Extended setting.YG4the%add. keyword arguments can be used'1setOadditional parameters  a, with uncores convertedOto dashes. Normally J]P will ad as!="" unlessOl,which case on\:keyVu. If aG}Q contains non-ASCII charac$it1specified asOthree-tuple of (<set, language,A)$itAencoccordingRFC2231 rulJOtherwise B :UusingPlQutf-8set and a'''PExamples:cGmsg.'/ent-dispos/', 'attachbp', file='bud.gif'UP g!('', Fußballer.ppt'|A'oKpartXrw.items( if sd!Zk.replace('_-.OelseD _ft((Q7, vT#if/ binsert(0[] = SEMISPACE.join(=)LP>B"""R# a!'first matchxrPfound#Amess re1i/Qorderdy-noV waUund, a KeyError ioraisedN(" =C"T2i, zip(range(len~O9)),`s): if k.lower() == _name: self._headers[i] = rpolicy._store_parse(k, _value)MUbreak;elsqraise KeyError(!) 1# Use theree methods instead of0 thbabove.:Gdef get_content_type()"""ReturnJmessage's 4 4.O*QThe r0ed string i.erced to fT caseAformAP`mainU@/subQ'. Ire was no Cb-Type v! iH,qdefault as given by) will beI. Since accordto RFC 2045, qs always have a ^OR thisi-e1 a ,P`Hdines ai 's to be text/plain unless it|aappear idmultipart/digest`ainer,PRwhichit wouldr/rfc822Z5"""s@miss+= object(BSget('T-$3', <2"if Rz0# TZ!shno parameters-t.+c = _splitL(D)[0]4.#section 5.2 sPif itvalid, uD1if u.count('/') != 1''BF f0"enGt!isj'wt Ued by{{J/ %dBB?[0] g s's sub-P X~1  `+' DMost  4, except forq~`at areys=s5uchI2sub7lt content t ype of message/rfc822. 5""" return self._default_type #ydef set(-0, c&!):'Y"""Set the `I' content ,.S,< should be either "text/plain" or "", although this{is not enforced. The  +stored inHC -TAoheader6 /" =7_get_params_preserve;failobj, dEv# Like ;t() but As quotingvalues. BAW#\'a@part/public interface?@missX= object()h" =)Bget(#, 4*2if -$issb+U = []Pfor pI!se#(^4T:tryePname, = p.split('=', 1(,0 = g.strip Pval =P"except V^Error# Must have been a bare attributeo )'':(s.append((E)# = utils.decodefBams(-#, T=None#='-P', unge=TrueB"""R9's eters, as a listXelements!ed, oq2-tuple"Akey/QB paiWK2! o$ `=' sign]0lefand sidn%iEkey,JQwhileHrigh9.P. If&"reu5 inLh.u2`empty #ng]Ra3udescribs() methodXOptionalMm'B to f* i:5. VUto search instead ofDY7WEZ,d js>73if ? $if& Dec[(k, _(v)) for k, v in params] Uelse:Tretur) def get_=b(self,I, failobj=None, header='content-type',D[unquote=True)B"""R2theceter value if found in CfCType{.iOptional1 is6object to if re!8no V@, or, $z has no such4. LnZsearch instead ofgPkeys are always compared caseJensitively. TheYcan either be a stringa 3-tupl~}uwas RFCL 2231 encoded. When it's D,=elementsR%ofM"form (CHARSET, LANGUAGE, VALUE). Note that both +E andI6 2be in which)you should considerd%beLus-ascii charset. Youiusually ignore.KK(r(ed item inN)Yfd, unless #!seWFalse\If your applicaC doesn't c1whe)s  /0, i<!n X85ntot as follows:1rawov = msg.e'foo')u,) email.utils.collapse_rfc_t(W)n5"""N$if0notm :for k, v5%._s_preserve(6: [if k.lower() ==W / _%v;(BvD.s.s(='kV', re5gllanguage=';aplace=F"""Set a;=I6already existssWwill 3!read with2new, vKZt yet been defined dEthispmessage set to "text/plain" and the new parameter# value will be appended as per RFC 2045. 1An alternate header can>specified inwargument,zE allMsBquotnecessary unless re is FalseIf charset,feAencoccording to 2231. Optional language [sZ 5231 , defaultingM!to-empty string. BothdQhouldR-%s.K5""" Pif noinstance(, tuple)m:5'C = (,)$iflan self[ .lower() == 'content-type'tc = 'text'Oelse/nR.get(n)3 _(,=4 Z9  = _formatPV,8NSEMISPACE.join($[-,z]|xGi_crfor old(,  Esl?,S !un=)no`!ifk Y; ]C^] g7K "u ? qVZ2if 9!!= qif replac[__,_/1del[A]f" =Yrdef delc((, % W=True"""RemoveRgivenIRcompletely from$C 4Typ)$Thre-writtenQ withoutQoeor its. All values will be quoted as necessary unless reS is 6False. Optional header specifies an alternative to the Content-Type L<.]5""" #if not in self:Cereturnnew_ctype = ''for p, vD.get_params(=A, un=)oif p.lower() != D +!if"& = _formatX(,)4OelseRSEMISPACE.join([n,QU ]!!=qj R1del"[]5 =  &def set_(+ , ,5(='q'IW=Truea"""SetAmainD and subP > d.5+@mustQa stringq; "_'/Z", otherwise aJValueError is raisediThis method replaces`, keep0all%ebPetersFT. Ifo{0, tqCleavhexistingL!'sHm@s is"Ee.t z6(thdefault)AQq@ canmxdnargument. Whe%#,set, we'll always also add a MIME-VersioMl# BAW: should weetrict?<.!otu.count('/') == 1 B$# , you get]t#'c'r'mime-v ''* ']61.0{$ &s mT `# SkipWb firstR; it'2oldhLJ[1:]is.!)yfilenamefailobj=NonReturn the fil!ename associated with the payload if present. rThe fil>is extrac@Afrom@ Content-Disposition header'sH`E' parameter, and it is unquoted. If thatDumissingMQthis method falls back to looking forL`.5"""  = object() = self.get_$('3', AC, 'c/d/'N)ifo7:nWrnOtypegreturn failobjutils.collapse_rfc2231_value().strip()Q@def boundary(1,bf=None)B"""R4#> CTypexD's `6'';`; $9$ # RFC 2046 saysiMies may begin but not eFn w/\ TMy).rDset_  0Set ;D in xDto ''' is%subtly differenXan deletb P0add+a new oneB{via add_J(). TheNEmain ceu ')0rveNporder o:e0original message*HParseErrorQraise=4 has nog=Ps__(:4. #zOre wwe don't know wlY#M0setqto, so & an excep3 eU,s.g?('NK f%3newE= []'p = Falspk, pv in pargams:  if pk.lower() == 'boundary')4newparams.append((., '"%s"' % B)))kBf]p = TrueOelsergpk, pv[rif not Z B# The original Content-Type header had no attribute.*# Tack one on the end. BAW: should we raise an exceptionFinstead???Y'# ReplacexistingAwith&wnew val2newes = []for h, v in self._' hIif hDcjOtypeHKpartjrkr n'Aif vb jk$z B`'%s=%s(+val = SEMISPACE.join(D}vdrpolicy.j_store_parse(Ual)) s]?m6 = 2`def get_0_ch t(8, failobj=None)"""Retur%3 6qeter of.vrF`ed stris always coerced to  case. I[re is no#k`, or i/&at 6 ,I_%5""")@miss= object(_=O_#('3', ?5%if$iss2Pif istSance(ch, tuplB # RFC 2231 encoded, so de it, and it betend up as ascii Mpk$ =0[0]uA'us-0'0:try# LookupError will bcde^ isn't known tG# Python. UniU Y textKaains a aci ;pas_byte B[2].nr('raw-u-escape'?8 =(Q$, q 2 (LookupError, UnicodeError): charset = 5[2]%#acters must be in us-ascii range7:tryi[0.en$('8%')4iexcept Dreturn failobj8# RFC 2046, $4.1.2 says sets are not case sensitivWlower() `def get_ts(self,W=NoneRB"""Ra list containing the(s) used@this message.tQThe rK"edKof items describesSContent-Type headers'G parameter for t and allMsubparts5itsGwpayloadAEach will eitherPa str(value of^ `!in!< at1t) (e WE'',(defaults to 2, iQ doesehave aLmain MIME tXof "text",i?hdefine! D one eF# V, plu6/RJ$er5p (i.e. ), so that a non-multi`j stg of length 1.65""" /[W.#()k&N.walk()]Z?Pdispo!oneW$!'s^;it existsFPs can'inline', 'attachment'I`accordtre rfc21834j! =4 ('  #if!is c_d = _split(tT)[0].2c_d0# IBR): .. from email.iterators import 0 class0bPart(Me"):`Y__init__, policy?#if @",= .&) 2as_@unix=False, maxp1len`entireematted4as =Optional '', when tru0eanQcludeFUnix From_ enveclope header. max #len is retained for backward compatibility with thN'base Message class, but defaults to None, meaning thatC policy valuP| max_line_length controls6Rimum #B. 'OE' is`passed the Generator instance userializecmu; if itNis not specifiX$heassociated# Gny.Z5"""  = self.$ifi!isOD els}; if!{:! =W.s2 return super().as_string(G= ,S=!) LPdef _<0__()c`>=,.clone(utf8=True)[is_attachmenta4c_dOPget('Oent-disposition')  Faa0if > uCc_d.C_CV == ''find_body, part, preferencelistJart.!maintype, sub ! =gT.get_().split('/:BVtext'q%if[+in *.zyield (s.index() z8~!= 'multi? 7e 60rel 4j0subN s@ter_+s(pBfrom_I @'  T{PE Rcandidate =6Xstart#qparam('  :=Y[@id']ma- Ubreak Lsjyload(@s[0]Ei7! OwQeOU >=('related', 'html', 'plain')): 6"""Return best candidate mime part for display as 'body' of message. N"Do a depth first search, starting with self, look`3the2sPPmatch$@eachs(items in preferencelist, and r( JcorrespondO0to "P that has a u, or None if no %sDhave*. If 'related' is not includedconsiderPBrootqof any multi/\ encounteredaJBgnorsu'Content-Disposition: attachment'.E5""" _prio = len(u)(Qody =3;,!inp._find_G(  T0if D! < !%.n! = bN== 0[>Ereak8dS _types = {('textp,&I&)%P '-alternative')}0def&r_s!an-ator over4`non-ma~@artsa ASkip1e2of Accur;(/!,  gFv (unlesSthey   header)TA allF reL0sub0ter<. When applied to aHAns exceptM%3. %anMVemptywv/;'orzP, sub " =Rget_cf().split('/'*4if BU != ''tS7= ''$xpayload(x`# CertmalformedsJ 0set`5/*`u# but still;Rsinglt ,which casp.copy()sLBfailAttributeError:trywXT except AttributeError:  # payload is not a list, itmost probably a string.Cureturn if maintype == 'multipart' and subrelated'CFor , we treat everything but the ros an attachment4# T)may be indicxp by 'st@; ifR0re' e or we7# can't find0b named/,Pfirst1 as, g= self.get_param(){"ifg -found = Falsis = []U!Afor !insb'!if('content-id')8<>Tru!Oelse?.append( G1if kKyield from.sI rzs.pop(0yW$ Q I# Otherwise@morefless invereClogic in FbodyAis only really workI edge cases (ex: non-textW5 or# alternatives) P sendagent sets dispositionAseena` # OAskipexample of eachKpdidate J 1,` % =__().split('/']if ((H)hs_jD\d+ .F.is_)()%0in ) h+in8tydef iterA0ts(pA"""R)'ator over all immedi0subTs%a .eHQemptyuNah725"""DdDent_(M3 4_"() Z , *args,_manager=None, **kw-,if( + M {policy. b3 4set (=e, **kw):   if content_manager is None: ! %= self.policy.: S.set_(@, *args, **kw) 8def _make_multipart,subtype, disallowed_s, boundary)"ifgwP_mainFu() == 'd'7existinga K|!()6/ =C + (C,C=if /inD  raise ValueError("Cannotvert {} to {}".format(C #, )keep_headers = []Jfor name, v2 in. !if-.r().startswith('H'-'.append((w/;elsE 8if s p# ThereXVt, move itthe firstkO.P1 = <")(}= 2.Y) = [._payload *lI 1-@pu%2['C-Type'] @/' +16%ifw[tparam('A'Lsrelated1=\Y '< ', ('alternative', 'mixed')x0|"@q,r"l":f^M_addfQ_dispXS1if .!E' or>d() != 5qgetattr{{/.(|1if U and 'osition' !in/<bEtent-Disposition'] = _disp self.attach(part) def add_related(', *args, **kw):(F ._.PmultiF#('9'5w='inlineE malternativeq=^ eOmentdVmixed^>R Qcleari 1headers = []Lpayload = NoneNT_contV (n, v) for B in zu if not n.lower().startswith('?-') class EmailMessage(MIMEPh:9set4 i"up0@if 'iP-Vers[-%''1.0' # Copyright (C) 2001-2007 Python Software Foundad # Author: Barry Warsaw, Thomas Wouters, AnCy Baxterlntact: e1a-sig@pg.org """A parser of RFC 2822 and 7" mis.""" __all__e!'P<Q', 'H{[Bytes $[ 'Feed.] from io import StringIO, TextIOWrapper(S.feed6S!, a9_policybasepcompat32 __init__1, _=lR, *, R=Gd2"""Lf"Creates an in-memory object tree representing theu, which0can%n be manipu  turned over to a Generato re =MvtextualO.QThe sP mustformatted as a blockAr O2inuuPs, opJ ally preceded by a `Unix-_"' He. TheNis terminp eitherH0end oaK`blank + Z1he 8finstantiatep$ewQs wheyb?cd#isVhave a construcAhat &akzero argus. Default is Message.Message. The policy keyword specifies aobject that controlnumber ofOa=pts of tZarser's operation. stdefault`maintainsIbackward compatibility5"""-self._class = =qPdef p(A , fp, headersonly=False):J"""Create a mJ structure fromdata in a fillReads all'5+ and returns#DrootKqyP. Op[(al iCflagying whether to stopN after read{ or not1is %,I@mean;"it[aentire;&en.;@feeder = FeedPr,=.)M(if ]c._set_(Bwhile True>P= fp.'V(81925_ if* ( :Ubreak (8Q .close()"sto, text.a7ingqR 1   =H M Mt(StringIO(y)zZb) Heg +<C.!#-(0] f2RBytes:x__init__*args, **kw2"""9binary RFC 2822MIME email|ss an in-memory ree repres!ng\ Ku, which0can%n be manipulatedRed ovGPa GenoVr&=M6ual k input mustaformatPblock@!h ~ continuatio-n lines, optionally preceded by a `Unix-from' header. The  block is terminated eitherHthe end of qinput oaJQblank%. a_classY2he to instantiate for new message objects whenoyMmust be cre#isVhave a constructor that can tak zero arguments. DefaultM.5""" self.parser = P (*args, **kw)Adef &(1S, fp,sonly=False):WA"""C% a@ure  data in a binary filewReads all.<+ and returns#DrootC. Oi4a flag specifying?uto stopN after readWsY1not6e d,,I@mean;"itb`entiret.;fp = TextIOWrapper(@enco='ascii', errors='surrogateescape')W6try`b ,bC!fi Gfp.detach() WSbytes\Otext^. a Sy stringR- 1oucture% *- % M- %M-c0 = .decode('ASCII @str(S 0BHh <h 8TrugH>z2plE """This will2hom9 bpolicyPhooks@new 'ademail6 fea s.f import re Asys 90"._kSbase ,P}, Compat32, c _extend_docP MTutilsGU_has_Z ((registry import HeaderRegistry as Heade from email.contentmanager import raw_data_2tmessage+EGM __all__ = [ 'Compat32',cdPolicyM tdefault"UstricDSMTP%HT ] linesep_splitter = re.~ ile(r'\n|\r') @_extend_doc]ngs class (1): A"""+ PROVISIONALThe API Tsions enabled by this p are currently provi01al.ZRefer to the documentation for details.vXdds new h parsing and fold lgorithms. Instead ofyssimple ,Gsstom objects with cuattributesFQdepenl!onqtype of field. - a fullyEs RFCs 2047C5322qIn addi.@setts listed above that apply tojAall Jies,Oafollow>p'alb@utf8-- if False (K$) KQQll beB serializs ASCII, uencoded words;N any non-H characters iUsourc -% @True?e  Lwill not Bain @(see!L A65329Qmore %isXCmat)Y re_QvalueQa"3 % Qcame Rof some yN&ishP indicates whether or7a generator should N %when transformsback inJ) `stream1mpossible d`D =none -- <use original AlongK GPhave B+iVhan max_A_length  Y/ed  A refolded.   The default is 'long'. 2header_factory% -- a callable that takes two arguments, 'name' andK= 'value', where5Ris a }p field MLan unfoldedHo,J `returnstring-like object`repres E. AhXis proviQN understands some of the RFC5322otypes.O (Currently addressqs#T dateOhaveJ special treatile all otherJ/arI Aed as unstructured. This list will bG completed before extension%marked st".)content_managernwith at leastmethods: get_@* Vand s+q. WhenB? orE A a Messag!is?ed,M !it&scorresponding\t~M @pass:i+:e mPas ite5rst/P /5any-s or keyword@at w<x_ed to asvitionalV` D #/is. :data:`~email.<^P.raw_ L`y2""">+0= EHxutf8 = Fals re_source =, y1= HRegistry()&< =  def __init__(self, **kw):F;a# Ensu}at each new in ce2feuniqueoE(as opposq clones`ach shaa#e )Jif '' not in kw.__setattr A,56Esuper()..max_count66E"""+iTaQ for dclass Z attribute fro3m 0the specialized header class that would be used to construct a /Nof type 'name'.5""" return self.?_factory[6].max_count 4# The logic `he next three methods is chosen such itpossible toP(switch a Message object between a Compat32 policy and a sderivedMpfrom th4+Phave Zresults stay8istent. T2allows aK h`ed wit$is to3pasa libraryLonly handlesPs, orrreceive8$an $anconvert it/"usnewer style by just changing it@. IDalso@becaNit postponese relatively expensfull rfc5322Mparse until as latePwhen %source, since in man2applications :Sa fews will actually} in9Bted.3def-_h_| e(", qlines):E"""+ dpeveryth upY1':'rMed unmodifiYPPvalueQdetermined`strippT@leadwhitespace off`remain`first `, join@all subsequens together,P}any trailBPcarric@feedZracters. (=Ni51sam) a", =[0].split(':', 1)b-!.l(' \t') + ''.(F[1:]?(z#.rE~\r\n'))AItore@>@u edc inputShas apattribuO ndSmatchb ignor0se,.P4is {O&unO$wiE#nd=Fare  NRxrdSustomN5theJC Inpase a V3PError80raici;containsP CR(LF `if hasg(,)( .h.lower() == AZq a~if isinstance(value, str) and len(value.splitlines())>1: (# XXX this error message isn't quite right when we use T N0(se<&sue 22233), but I'm not sure what should happen here.Kpraise VE("Header Qs mayRcontain ifeed "G "or carrireturn characters")>(name, self.h_factory1)) 9Ddef &etch_parse(>", J0A"""+<bIf the has a '7' attribute, it is ed to unmodifiedE`OtherwERE  with any;7sep removedare passoD  method,cresulting customJ8i objec`. Any" rogateescaped bytes get Ainto.unicode unknown-r glyph._&"" ifaW(,j)3gp# We ca" P beca"it)s on more than \r'&\n= ''.join(Asep_h2ter)_ Ofoldr50is nAroll} re_source policy set4DRsiderL be?$A' if!@only pit doesN1hav9P (hav8c means=aPof some sort). If a ` needst2be ed accordingPconverted a!byk N!he>~)5the`. Fol o is done byM@callm@its OscurrentS/ s ^0 us[V65 isZ7to ,8^ reW#edVFpep from.Nkr ed. The exception@0ainnon-asciiJbinary datanPt cas >ed regardlesskg`, which causes the binary data to be CTE encoded using the unknown-8bit charset. )5""" return self._fold(name, value, re_b=True)HGdef (A', <%):dE"""+ The same asA if cte_type is 7bit, except tha1e r"ed5 isPWbytesIO, non-ASCII Kis converted back intoZ Headers with@sare not% ed/gardless ofMIhL setting, since)r`no way whether yP qconsistm0le 0actor multi 1@utf8| tr s d%0, o@wiseQasciij0uni renderedOHwordVOed =y.A0=='@%')@ = ''o3q else ''3l2ed.(H, 'surrogateescape'A_ GWFalse if hasattr(w'I'##.P(policy=qdmaxlen@max_line_length  sys.maxsize=2s =ya.split(r1 = ._source == 'all' orT1long' an/(B lenP[0])+:c)+2 > xp any(1&x),for x in bf[1:]))#if3 or U_has_sh_factoryxc''.joi/)) + ': ' +4(epI  default = EmailPK() # Mak #g uhe class D del.PstricqX.clone(raise_on_defecteeSMTP =K+='\r\n') HT%,p=None) `pUTF8 = # Copyright (C) 2001-2006 Python Softw$Foundation # Author: Ben Gertzfield Nntact: eoa-sig@pI.org """Quoted-printable content t8ransfer encoding per RFCs 2045-2047. This module handles the content tGmethod defined inUT2 ton' b'?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`'1abcdefghijklmnopqrstuvwxyz{|}~\t'):0ABODYcchr(c) Helpers def header_check(octetG"""Return True if the " should be escaped withL quopri."""rF>T) != }1] Obody3J8(plength(]array-ated-printable 4 D!. !Note that this does not include any RFC 2047 chradded byA`_Ce()`Yu:param Q: An 1 ofs (a.k.a.1s).Q:S: The3 in2oVMwhen it is K:quo2sq )sum(len(# ) C_e ( H3ingN@bodioM K _max_append(L, s, maxlen, extra='u"ifsinstance(s, str 0s =1(s)2L!#L.js.lstrip()+@elif(L[-1]) + Ss) <=E#2 +=A + snGelse%jy!un#(s@"""Ta!in form =AB toASCII charactervalue 0xab int(s[1:3], 16)c/+c)"e(X_!s,set='iso-8859-1p"""Encoat singleBlineb(like)i[pDefined"5,5`Q'- psimilar3 \Q, butOused specificallyTemail`fieldsGTallows with mostly 7  bit characters (and some 8) to remain more or less readable in non-RFC O 2045 aware mail clients. iset names the{ Qto usTRFC 2046 header. ItGdefaultsiso-8859-1.1"""# Return emptyCds as abstring7cif not'q_bytes:HrJ!''# Iterate over every 2, encoding OecessaryaIed =d .decode('latin1').translate(_QUOPRI_HEADER_MAP)qNow addA%0chrrto eached chunk Aglue.sGtogether`=?%s?qc=' % (ded) BODY_ENCODE9 = MAP[:] for c)rb'\r\n'Y *D[c] = chr(c) def body_?( , maxlinelen=76, eol=NL)W@"""Ee with quoted-printp, wrapp'atIsEKg5 ofStext will endbeol, which "\\n". Se1thi@"\\r#2youMPbe us`resultv4function directly"in=ail"beped at, 8ost<@ bef1the^Beol & (m '76@,]maximum valuHpermitted by ). Long ]s2havQ'softb breaks { "=" appendedthem, so^%d be identical3p origin3extRqThe min@is 47Proom akb("=XX"bfollow +a 'bmaller<2genhaVWSError(if2< 4 Vaise ;'("pmust besleast 4!otzK# speciala)! =E ;)S_ = '=' +@# le&Qspaces-$!atAof a>381 =#2- 1pW#d_![]8P$ =.8ody.split#s(~#1 up into pi no longer thanBstart = 0Dlast@len(Yw) - 1 -E/bwhile 1<= laststart7:  stop = start + maxlinelen1'!# make sure we don't break up an escape sequence=0if U[l- 2] == '='sappend(.Cart:491])S-iop - 2!+elv1vr #Oelse0] +  # handle rest oO, special case  ends in whitespa#2and0-1]+K' \tErooma- lasto1if (N>= 3# It's a character at@-of- , qwe haveU im# for the three-Kquoted encoding.;Aq = %Y-M,O== 2qThere'sbnd a sof[~++_J N)# Aonly r %d} _R`will bR!e Lcontent onj2subt0" +vgq5"])# add back final newX qpresentqif bodyovin CRLF_#''Ureturn eol.join(U0ed_B) # BAW: I'm not!if.i<1was`signat5o$is functi`ao be #:same as base64MIME.decode() ori... def ,B=NL)A"""D7" ad-printable strLines ar@para@@withP,4ch defaults to \\n1"""A ift"edT@!ed+2see comm_#in: () above. Again, we're buil]"thN#d  concatena\Pcoulddone much morNefficiently\bd = ''crSpd.split#s(w" =&r&p(-$*6r +=y.BinueUi = 0$nn!enkjwhile i < nj c = line[i]' if c != '=':$decoded += ci1# Otherwise, c == "=". Are we at the end of line? If so, addOpa soft 'y break.!elif i+1jncontinueK1# D Rn form =AB$o2 < n and[i+1] in hexdigits2cunquote([i:i+3])3 v0not, pass literally9Oelse  G21eol6# Special caseooriginal string did (Twith ;Qif enA[-1]$in '\r\n'uoP.ends:V(eol)3 = Q[:-1]dreturn # For conveniencea(backwards compatibility w/ standard base64 module body_ox  def _q_match(@"""T!a Q1 toVASCII character  value 0xab"""2s =H.group(0n 1(s)bHeader! is done a bit differentlyh.&(seaRFC 2045 MIME DB `Q'Qing. This function does @parsIfullCkGn'd-printable (like =?iso-8859-1?q?Hello_World?=) -- ple"usBhigh level email. cl~for thata5s.replace('_', ' ' re.sub(r'=[a-fA-F0-9]{2}',4, s, flags=re.#) # Copyright (C) 2001-2010 Python Software Founda\ # Author: Barry WarsawLbntact:a-sig@pG .org """Miscellaneous ut)@ies. __all__ = ['collapse_rfc2231_"',0{_params1G"jataddrJdate_5tim!ge8Eesse{make_msgid= mk44_tzq] " 6o@] import os $re  random import socket import datetime urllib.parse from email._Saddr ;_quote# AddressList as _9 mk?_tz %, R_tz, E# Intrapackages cht" C COMMASPACE = ', ' EMPTYSTRING=' U@CRLF6\r\n' TICK = "'" specialsre = re.compile(r'[][\\()<>@,:;".]') escape,0\\"!+ def _has_surrogates(s): """Return True if s contains 0-ed binaryQa."""C# This check is based on the fact that unlessfre are^ss, utf8M(Python's default encoding) cane any string. i] fastestNcway to9forvsee issue 11454 timings.@2try'+!s.1e()r;QFalseexcept UnicodeEfeErrorG4op # Howdeal with aing bytes before han0 it9the # applicatiwProughj 'normal' interface.sanitize(D0# T \{binto u 'unknown' Q. Ifm3 #`happen be -8+y will instead get de2pd, evenCtheyKwere invalid iY{ se\e source wa0ppo@to b5Jseems like?is not a bad thing; aw2ectNtregisteredoriginal_=`'utf-8@'9 F.(=replace') (qelpers ftha(pair,Cset=?P"""Thverse of8 ),s takes a 2-tupl%1orm4(realname,_>ess) and yJP valuRitablXan RFC 2822 From, To or Cc header. pLfirst element ir^flVhe second*!isFed unmodifi op)$al7XTbacter Z atuOEVcase SASCII safe. Can!an1ancfastr orOaJ-1objphich ha#_ method. D"0 = 1v$e MUST (per RFC) b-e ascii, so raise a UnicodeError if it isn't. address.en%!('@!')if name: -6try ;eexcepta Dsinstance(charset, str))TB = C)1# d_3 = 6.header_( 7return "%s <%s>" % (-K,/77els!|quotes = ''9if specialsre.searchD"E = escapeHub(r'\\\g<0>',x0'%s'd2$, C; def getes(fieldvaluesB"""RHa list of (REALNAME, EMAIL) for each AA."""20allOMMASPACE.joinj'R = _AList(all. _format_timetuple_and_zone( , '%s, %02d %s %04d :1 %sVw['Mon', 'Tue0Wed0Thu0Fri1SatUun'][U[6]],I2A['Ja_0FebC0Mar!Ap0MayFJun'IP 'Jul0Aug0Sep!Oc0Nov9Decg1] - 1yF0], 345@[I2dat|val=None, local[=False, usegmtg@s a D2bing ash fied by RFC 2822, e.g.: YFri, 09 Nov 2001 01:08:47 -0000%Optional0val>pgiven iuPfloatrQpoint%  acq gmf() and(), otherwthe curreN is+d.ag that when True, interprets@val,{8relative to _6 0eadUTC, properlyK0takdaylight savingto accountPargumb means-~s written out asw"an , not numeric one (so "GMT" "+r"). ThiIis neededAHTTP'YAonlyW=?# Note: we can0usef3p() becaPhonore e# require'aat day%Qmonths be the English abbreviations. if timeval is None:=#.!()if local or usegmt:dt = date!. @from`stamp( Fval,)zone.utci7elsW?utcZC Dt.asu = Falsereturn format_C(dt,o) def!=M)@"""TPab into  string as specified in RFC 2822. #If| True, dt must be an awareb@withoffset of zero. InPthis case 'GMT' willJarenderPstead:Pthe n l +0000 requi%!byM1RFC0 TWis to support HTTP headers involvW 1"""M0nowQtStupleiWif dt.tzinfo!sDHraise ValueError(" op@us a UTCf"vB" =M/elw1-R'3!pdt.strfC("%zs_+P_and_:`(now, ") make_msgid(idu=0, domain R, suitable compliant Message-ID, e.g:6<142480216486.20800.16526388040877946887@nightshade.la.mastaler.com> OPgivenaHAusedtrengthen thuniquenessme id. a_providesI>ionF` after(@ '@'nt defaultJMl9defined hostname =0Cb()*100{pid = os.getpid*`randin om rbits(64;4if A ?= ' E.' +KTY\= socketCfqdnGA<%d.%s@%s>' % DPpid, Eint,z!QPparsew7_to3ata!*dD, tz = _00z(d'.tzq` (VI[:6]* ,kY=2awdelta(seconds=tz))) def parseaddr(): """P  into its constituent realname and email-0essXAts. GReturn a tuple of9P, unlA0theEse fails, inMwhich case rX%2-Z('', '').-s = _AddressList.qesslist3aif notsk](?@s[0] # rfc822.unquote() doesn't properly de-backslash-ify in Python pre-2.3. C6strqRemove ]s from a string.pif len(8F > 1 if+.startswith('"')vstr.end6str[1:-1].replace('\\\\oH\\')"1"'))C}<}#>'6g}S x RFC2231-related functions -Dameter encoding"de  Pe_rfcG#(s@"""D'e:9AccorCpto RFC /zpY = s.split(TICK, 2$f) <= 2dbNone, s5@, ch"t=9languageE If neitherZT nor X is given, then sed as-is. If#4A but]NE]"isPed usnQemptyM' f qurllib..((s, safe=>Ding=or 'ascii%if!is-h *DA= ''7Q "%s'S" % (,r0, s_continua = re.compile(r'^(?P<>\w+)\*(um>[0-9]c?)?$',~r.ASCII)rparams(@L s 0/ aI,a sequencI@tainp ,[valueCnew_X2= [ A[0]]V# Map!'sPR to a of>AThe iss are aI3P tinumberB,*ca flagGpspecify1wheTaticular segmGQis %-"edQ = {}T&t>#F[1:]L! =h('*')  value = unquote(3) mo = rfc2231_continuation.match(name.eif mo:=D!, num = mo.group('', 'num'?0!if-is not NoneP$Nzint(num?params.setdefault, []).append(=,, encoded)N;els{Cnew_XCame, '"%s"' % CK%if?<@for (, YKs in3.items();Y = []qextended = False# Sort bye9ber f.sort(r# And now B allAnumerical orderyvertinghA# %-pPings 4the segments. If any of thFQs end@a *,2n entire string, aft# decoding|@ and`catena, must haveVpcharset) language specifiers at5`beginni.Benum, ss $ifA 0# Dpe as "lq-1", so0actin s directlyG# represenrpercented octet ># collapse_treats this#anMsequenceOsprllib.p.BEing= 6:Trum :sD# =EMPTYSTRING.joinR 3Tset, K" =6[ ([)a Mvreturn 5_ def, errors='replace',K}fallback_='us-ascii'5Wot isinstanc, tuple) or leV != 3V(r# While comes to u@ uniV, we need it&be a bytesLobject. We do0wantes() normal utf-8 rU&agSaightOinterpretF string as cha"racter bytes. charset, language, text = value$$if' is None:@# Issue 17369: +/Q0 , decode_rfc2231 couldn't pN2thez, so use fallback_< = $U1raw" =(, 'raw-uni-escape')16tryreturn str(I, , errors7except LookupEF#3not a known ~cnqunquote) # # datetime does7rovide a localfunction yCso p% one. Code # adapted from\patch in i9527. This may be perfect, but it is # betOAthan(having it. # def@(dt=:, isdst=-1)"B"""Rg as an awareobject. If called without arguments, JqcurrentS. Otherwise *dt*F40 sh bRminstance, andp converA to?Gzone accord %q system "pdatabas!IfRnaive (thae, dt.tzinfo>B#),assumed to"inmeU@In t0cas` posit^ror zeroia for ** causesJ!to0prem initially asummers (Hexample, Daylight SBTime+Pis orZp(respec0ly) efh0ifi im/A@nega5=5() to attemptJto divine whe" /is1"""P@if d (\. Enow( .utc).as(;\BJ>gt=# We havewL5a (8)QtupleSpass # mkB tog@ hint. S-Cwill6# seconds since epochAtm =1ime()[:-1] + (,A=.i2(tmK.Cime(7& Pdelta|}.:5=Gm.tm_gmtoffG,tz;(@,a97EAttributeHCompute UTC offset@comp*y implied by tm_isdst3.  # If the values match, usezone name implied by tm_isdstFdelta = dt - datetime. !(* gm(seconds)[:6])`dst = !.daylight and localtm.tE > 05gmtoff = -(:1alt0if P elp#='=b%):s7 tz5\(:, tz5G[dstJreturn dt.replace(tzinfo=tz) # Copyr-.(C) 2001-2006 Python Software Foundation # Author: Keith DartJntact: email-sig@pE.org """Class representing applicX/* type MIME documents.""" __all__ = [" A7"] fromwfort encoders .mnonmultipart-RDNonMA ck()for genera= def __init__(self, _data, _sub='octet-stream',LC# _="s. _base64, *, policy=None, **_paramsFreate an%.  is a strpcontain 8rawP/a@C/)C2ent!`, defaUng to ZrZ`a func which will performbactual;5forc`transpZo  yMAny addial keyword arg opassed toM constructor,s0qm into eters on Content-TypeJfheaderq%ifD< `raise PError('Invalid']N.'d'] i.set_payload(R)7) AnNy Baxter-&Oudio''^A1a'] imcsndhdr0$iowBytesIO,@G email.mime. nonmultipart import MIMENonM _sndhdr_ map = {'au' : 'basic', 'wav' :'x- #Paiff'# $c$ } # There are others in  that don't have types. :( # Additional ones to be added G"? midi, mp3, realaudio, wma?? def _whatsnd(data):`"""TryFidentify a sound file!. +g.E.() has a pretty cruddy interface, unfortunately. This is whyMwe re-do it . It would`easierreverse enginehe Unix ''Ncommand  use the standard 'magic' , as shipped with a modernT.N1"""`hdr = -a[:512]@fakey = BytesIO(hdr)or testfn.smSres =&:$, RD$0if 'is not None@ {return .get(res[0]K'@*Qclass^A(2OC*for generating P!/*A documents..c_init__(self, _4B`, _sub=L@_enc="s. _base64, *, policyB **_params"""Create anv 2Pa strpcontain M2rawO0f tL0can deJd byPython `I'y@ule,%nH*P willQautomaticallf0clui6 Content-Type headerOmwise, you @specs #icz0via rBeteragiven,4no Nv%beMguessed, a PError}hraised`a funcb whichpperform actual 45forsQtransDoue imagept takes^A arg,h!isKI: in` ceAt sh{get_payload() s%toJRchang2o0ed b@also2 anHPfer-EJ"orn:`@mess%as0necre defaultOAis B0AnyukeywordCs pa {constructor, which tu rns them into parameters on Content-Type uheader.5""" if _subtype is None:@= _whatsnd(_audiodata),I`raise Error('Could not find Tc MIME '^NonMultipart.__init__(self, '>%',, policy=,1**_Qsw].set_payloa_encoder>) # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry WarsawLntact: email-sig@pG.org """Base class forApecializ^ s. __all__ = ['P9'] importa./b from message oE(".M#)BKdef P_main*&, xL """This constructor adds a#0: az5-Version: 04;The7#2ataken /Ethe Z=Jarguments. Addi(altc) dMkeyword U#if 3'" =.compat32R  FnAc = '%s/%s' % ("0qBadd_%1', P: ']yA1.0'HYCrepresenting image/* :C doc  I1oimghdrs.mime.nonm2{J v(%ogenerahH =f=. _base64, Create an%. W_>Pa strpcontain 2rawO a. If Lcan be de/Ad bystandard`' module, then the  (subtype will be automatically included in the Content-T3header. G Otherwise, you can specify< ic image y1via_Opparametb _encoder is a function whichqperformSqactual 4uing forJtransport of-data. It takes one argument,huis thisKIinstance>should use get_payload() and s%toJachange21 to edmbalso add anyHPfer-E7@or o s`@messa0necry. The defaultOis Base64. z0Anyial keywordCs are passed{base clas{constructoru@turnxem into #5ype5"""4if uPUNone:= imghdr.what()1, _10)5R`raise >Error('C'not guessDMIME!'_NonMultipart.__init__(self, '%',, policy=,1**_[sw].) # Copyright (C) 2001-2006 Python Softw `Founda0 # Author: Barry WarsawLntact: email-sig@pG.org """C@ represent0/* 8A doc s. __all__ = [' Mge'] fromj1 im#K.mime.nonm,MQ h('){!Kdef F_msg ='rfc822', *yE}reate a 1/* Ce=1q objectAmustT$n ne, or arderived  'X& a;uNd OpH%al1ine9Q\containedBis "<0" ({1def;bdard, eve0EoughOsFtermMHCechnloutdated by RFC 2822)od  y=policy)  if not isinstance(_msg, message.M1): / raise TypeError('ArgumenIP4an QC of F%')F# It's conveni:!to use this base class method. We need to do itK4way or we'll get an exception- .attach(self, And be sure our default type is set correctlycLS.set_/_/#('z+/rfc822') # Copyright (C) 2002-2006 Python Software Founda# Author: Barry WarsawLntact: email-sig@pG.org """BUfor MIME multipart/*s.""" __all__ = ['0M/'] fromna.mime.aimport]pR  @(!Y#def __init__0subt='mixed', bAry=None, _subsP*, polic1!*_params6"""Creates aY%. M$ByQ?, c9, with properCContent-A andx-Version headerss th)Y,eing to}`'_g_Pstring. i7Wcalculated as'eddea sequenceDial  `payloaEI7@mustterable object, such~a list. You can always>F newu0to tIa by us:2he 0$() @Addi1al YUeters  ataken 5thekeyword as (or passed in&%).A.f''RY8?5, *)# InitialE_AmptyvI<a superK'p# imple{ %s_ assumes that lib#wsBF= []&ifT *Op in bZp%if T0aV( U on Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Base class for MIME type messages that are not multipart.""" __all__ = ['MIMENonMu"'] from| import errorsp.mime.b#Base N\($): Enon- .< def attach(self, payload[# # The public API prohibits:Bing ile subparts to Kpderived'types sinc^ ne of them are, by defini,wcontentMBzUart/*Sraisen.ConversionE(/@'Can A addz al TA/*')gpyright (C) 2001-2006 Pl` SoftwB3 Clrepresent|btext/*s documents_JText.charsetC 2non%ar,r m$^2"""}ogenera __ #___ `, _sub='plain', _=None, *, policyTreate a LU%. 8q0 is@ strSthis Cx object69Ae ,2aul1o ""GG`acter `paramePadded1theent-Typeheader. T0defx"us-ascii". Notes a side-effect,Owdransfer-Encodi will also be.;u# If no was specified, checkQsee i< re= Y%# #s ;.`t, use '', otherwCVutf-8b# XXX:,0can@remooP#7304Vfixed8&if0is :tryc .eB&e()%' = &except Unicodee v.GM'.':umt,C**{' ':Y(set)}) > self.set_payload(_text, _charset) """ General functions for HTML manipula.- import re as _re from html.entities $5' __all__ = ['escape', 'un ] def (s, quote=True): Replace special acters "&", "<" and ">" to-safe sequences.PIf the op2lagv is true (!default),/a2Q markI, both doubleL1(")Fsing(')aT1lsoOtranslatedrs = s.r(&") # Must be done first!N 6g"if~ Pp'"', "&R%!\'&D#x27&return s # see http://www.w3.org/TR/=/syntax. #tokenizing-wa-refer _invalid0ref{0x00: '\ufffd', # REPLACEMENT CHARACTER-d-r)# CARRIAGE RETURN'8T@20ac+# EURO SIG!1H0x81uB2!Pu201a## SINGLE LOW-9 QUOTATION MARK333B01923LATIN SMALL LETTER F WITH HOO6460201| # DOUBi 53"26iHORIZONTAL ELLIPSIS6+0+EDAGGN$87| %8%302cnMODIFIERCIRCUMFLEX ACCENT|993203|PER MILLEa&3016&6@CAPI8S8ECAROb9B2039EFT-POINTING AcA9015zIGATURE OE}!x85eR7#/# Zf90x8fZ9!x9$!8Dd# LEFT9@ORIGH3 3201Weee3 TBULLEU9"13sEN DASH9#14MdSDTILD9#12QTRADE9;P WITH CARON  0x9b: '\u203a', # SINGLE RIGHT-POINTING AQUOTATION MARK BcBB0153BLATIN SMALL LIGATURE OE/d/0x9d-q!e!Pu017e#)# PETTER Z WITH CARON7f787CAPITAL L9Y9DIAERESIS } _invalid_codepoints = {X# 0x0001 to 80x1, 0x234567!8,,CEC!1F00xe%f!10T1U1V1W1X1Y1Z!1809aA0x1abcdc"1f($7F97888888888 89i"8ac10x88888d9d9d9d9d9d9d$96L9h9h9h99d9d9d9d9BFDD04FDE1fdd1fdd1fdd1fdd1fdd1fdd1fdd1fdd3fddQ0xfdd1fdd1fdd1fdd1fdd1fdd1fdd3fde$e13fdeeeeeee3fdee3fdeeeee'cothers6"ff&!ff#1f 2 3 \40x4 (5 6 7 L8 (9 a b Lc (d e f L$10 fN def _replace_charref(s):gZs.group(1)if s[0] == '#''Z# numeric E.21] in 'xX3num = int(s[2:].rstrip(';'), 16t)Felsen;1;7 if|8sN}return &X[num]0xD800 <=Y<= 0xDFFF or> 0x10FFFF`'\uFFFD'Ri{C=rchr(num )# named_html5h_&[s # find the longest matchingg (as defined by)standardPfor x|range(len(s)-1, 1, -1z) if s[:x] in _html5: Tretur[s[:x]] + s[x:]-Jelse;70'&'- _charref = _re.compile(r'&(#[0-9]+;?'Q p'|#[xX])oa-fA-F/ [^\t\n\f <&#;]{1,32};?)') def unescape(s)1"""}Convert all named and numeric acter references (e.g. >, >,J &x3e;) in the string s tocorrespondvunicode`!s.DThis function uses=rules defined byHTML 5 standard@for both vali"in ,qlist ofEY70in F.entities.5a0if 0nots~2st 5.sub(_replace, s) """}y.{ __all__ = ['@', '2zPpoint 2Pdefs'] # mapy,UZ MiA = {'AElig': 0x00c6, # latin capital letqLAE = igature AE, U+00C6 ISOlat1^Qacute_^1^a with 0L1LAcircK L2L 0cumflexQ2QGgrav0Q 0 k0kElpha!39\greekfa*E$39E=?0c5 0o above$g;0C5Gtild3o 0L3L2uml4L diaeresisP4P3BetGP!39HAbetaD2392RCcedi@7C0lF:0C73ChiaN2chi"A7aDagger>Q0x202 double d0s3pub7$elQ0x039Lrd*D&DBgrk3E1ETHy /0d1ETHC+0DEFH9HEH0L C9  'Ecirc': B 0x00ca, # latin capital letter E with circumflex, U+00CA ISOlat1 'Egrave': Q8Q 0L8Lpsilon':L0395L\greeke*GB395 ta; o0x0397?#ta;7;3uml<b; diaeresisH:0CBCGamm3Pg*E0393EBgrk3WIacut[dEI0L00CDLlIeL 0 EQRQcQ 0CLo.9L.%io9% f<% FHKapp!k*239ARLambd>G=l*>=!MuW[F#muBCVNtild2/d1 N20D:0D1 N~nDROEligo0x0152igature OE~3152~2DE_dAO0L!0DHOK/d4L0#D4OR Q0L2meg2/3ao*E03A92WOmicr9o*G#9FmVslash!stroke =:!O Pd+0DOsl 0L5 /d6 *D6P1Phi aPG1phi!3ACPB0CB0B2rima 0x203double p = seconds = inche+JBtech%Psa8, # greek capital letter psi, U+03A8 ISOgrk3 'Rho':  0x03a1, # greek caC3rhoC1;aScaron>`0x0160;\latin;qS with 0D0160Clat2LAigmaK3Ls*E03A3EUTHORNE00deE*E00DEE3lat2TauC4E1tauC23A4GThet/98;*=9aUacute`0x00daEUV0L:0DAQUcircKV?0dbL 0cumflexQBQGgrav9Q 0L9LBpsil@z5Liu*G03A5GBUumlcG0 diaeresisP00DCP#XiN9ExS9BYFdYDY!17SL !17^hZ.0396Azeta"2396ae+Esmalla*E1ah!00e2J.,E2O2Ob accent = spacing 00B4G3diaGeligIe = igature aeY E6YSa[e)9. d!a gDpalefsymhQ0x213Q symbol = first transfinitePdinalS4C NEW7lphb+ (?103B 0amp_2Sampersand4!02-3numv&nd3A2227ogical and = wedgjjDtech>1222jDangl03Camso03rin2e3 x.] abov'"E$syQ0x224almost equal to = a'qtotic tp+CamsrFtilde,small letter a with tilde, U+00E3 ISOlat1 'auml':  0x00e4, # latin small letterJdiaeresisN4NRbdquoO`0x201eN double low-9 quotation markF201E NEWBbetaA03b2BZgreek(>@03B2Cgrk3BQrvbarD a6Bbroken bar = verticalK00A6K3numJ&ul1202`bulletF4lacQcirclb'E2pubE1cap 0x2229intersec P= cap<Ctech=Bcedi e7=c. laL@00E7LL b8Lla = spacing D B8D3dia2entB!0acent sign3AD3chi23!3c1chi@!3C[BQ0x02cmodifier%umflex acL!2CBlubsL`0x2663bclub suirshamroc!661D2ongC 45Dapproximately equal to@2245C5opyA100acopyrighI99I2rary!1bydownwards arrow1orn"ftarriage returF21B5w*cua unD= cuAQurrenSa=c(cy'$dAd0D!1D3amsRdagge g 2010020d;q9qj9je"0bieBn5lQ0x03b3.SBdelt!3B!QdiamsX!661ond*66adivide=frsFiVeacut7ekee.100Eie5eLJ.OeOGgravO.JJ3mpt|0Ce! sCnull g@eterJ1220Bamso 4ems00Q!emE0J*en2;)en2:2Qpsilo^GGe(03B5 ISOgrk3  'equiv': 0x2261, # identical to, U+ ISOtech +B'eta57@03b77greek small letter etaA@03B7ADgrk3AhA00f0A\latinAhA00F0AClat1A3umlBo0x00ebA with diaeresisN,EBN%roN@20acNeuro sign420AC NEW~Bxist17 030pthere eg@2203g7Bfnof6p 0x01927fhook = function Alori7 VBoral Lqfor all!20=Qrac12= bdvulgar frauone half~ W@00BD2num:&14VEV@quar=m\C\3\ecthree Gs bEbsE 0044bAslasF2044Cgamm Q0x03b(w!3B !ge2W 65xgreater-than or equ5g1003 C:003ChArrQ0x21dleft right double arrow@21D4}Bamsa)haB9B;9;QeartsB0x26pblack h suit = val!ne!663pubTellipF0026Ahorizontal  sidot leaderP0026PRiacutei.I100EQicirc!0eJ.cumflexOO5exc200anverted 1amaBmarkD A1Wigrav.IE$ma91@capiI = imaginary partQ1211BamsoTinfin-1221-1ity3!21%in;2sintegra23o9-%io9BCique bfBi = turned @00BFXs0208Welement of4@22084 esis, U+00EF ISOlat1 'kappa': 0x03ba, # greek small letter (, U+03BACBgrk3CBlArrBp 0x21d0Cleftwards double arrowA@21D0ACtechABambdbAl(D@03BBD6ang0329D -pointing angle bracket = L@2329L2quoMQ0x00a LSquotation mark = , xguillemetn100A4num >9>7979DceilD2308 = apl upstile}&Camsc~dE201cE E001CEe 2264Dss-than or equal to?0264?oBflooBQ0x230C HdownQowast`0x2217asterisk operator+17!oz9"5cRozeng7!5Cn3pub6'rm1000em-to-right n00E NEW RFC 2070B$sayQ0x203!siOI>3 proposedYX&01^J 18H#03@sign:003 2mac @00afon = spacoverline = APL !ba@00AF2diaRmdashs/1c0em 1201UGmicr!b5 B5eRmiddobCPle do2Georgian comma = G)$100B`X5nus22125nus@2212"mu2103b!mut!3BBnablS!200ack differenc!20Cnbspano-break2nonN:00AnN3(en3nY~tPgie;1220contains as membei1220==100ax5not100AkRnotinrz02@an ePnt of1220n2sub;8<f subse:8BamsnRntild  f1MZlatinn with tilde, U+00F1 ISOlat1 'nu':  0x03bd, # greek small letter nu, U+03BD@Bgrk3@aoacuteD`0x00f3@Zlatin@qo with .J00F3JQocircI?0f4J .cumflexO4OEeligO.15igature oeB$152Ggrav2 .J;0F22linIp 0x203eJ@over = spacing Ascor203E NEWEmega03c9Co(03C9`micronEfC(E'BF@plus?,@2295A@led  = direct sum@%CamsbrAp@2228Dlogical or = ve0228;Dtech;#df=k aa; feminine ordinal indicator@00AAE5numDmDbDQmascuEBEQslashGfstroke, = MFBtild9iqE].J5 J"me`0x2297<Qtimeszctor productI*I1uml@00f6IdiaeresisN@00F6N3parbNpilcrow sign = $QgraphHBHEpart1220ial differential> YRpermi0per millewM20309pxaup tack = orthogo to@erpe1ula122A#hiQ!3c0phi103C p@AA@@vdpi symboF<03DzAlusm^z10b1Flus-minusG'or!0BBoundapI4A42rim.g0 = t2fee!03~#rotA!20"Tn-ary@220F$8pro1TCorti1221NscZs26quo 1002quotation mark = APL quote, U+0022 ISOnum 'rArr':  0x21d2, # rightwards double arrowA121DACtechBBadicC`0x221aBsquare root = r#qal signE021AE"ngD!32E-pointing angle brackeV1ketM-32M2quoN`0x00bb MTation ma4- zrguillemp@00BBCaC9C<9<:DceilE2309 2ing 09qCamscsdF201d8 F001DF}#ea|s011cEblackletter capital Real part symbolR011CRCamsoe y aeSregisteredMRtradev@00AEWBflooV0x230 !30$h 03c1greek small 0rhoA@03C1vCgrk3"lmA@200fA-to-left=200F NEW RFC 2070B$saQ0x203!sisIb3 proposedZY'019`K1GX*sbEQlow-97 1Aascaron&Q0x016dZlatindqs with .F+mClat2J1dotHm02c5mdot operator7@22C57Camsb7&ec7@00a771secQ77#hyl!0a?soft hyphen = discreG3ary:00AFRsigmaN`0x03c3g(B03C3ifDC@C2finD#maINI!23UtildeG = varie= similar t1223cspades@2660& B sui0660$pu!ub7 8subset of1228n3ube5L 86n4 or equal 86s@ 1 n-Asummz1J#upyR!28Ysuperp#p17b6cript one = Adigi;00B8up2Q5Q?twoQquared, U+00B2 ISOnum 'sup3':  0x00b3, # superscript three =Fdigicubed, U+00B3]e]F2287]et of or equal toA#ACtechBzligC dfBlatin small letter sharp s = ess-z DFOBlat1O2tauM 03c4OZgreekO0tau@03C4ACgrk3AQhere4DQ0x223At@fore44Qtheta3u/b8u(C@03B8C wqtasym':C/d1C r symbolJdD1 NEWAinsp`0x2009F thL2pac0009{4pub41orn3z00fe4thorn withx00FEGz3ild `0x02dcHt602DC63dia}Fimes}d@multiplication sign=00D7=6trar@2122rU mark9 9BuArruR 0x21mupwards double arroww@21D1>3amsRuacut fax2u. .J@00FAJ4)ua99Rucircb .cumflexBGgrav6.JK"ml~!0a diaeresispacing HARupsihIQ0x03d"loZ hook 2 *GE c5%EY(03C5%uuj FUweier!11capital P = pow`et = W4strass p1211.BamsoE xi!3b xi@103ByDd*yD/#yeJt"yeb = yua !0Anym  m z03b6(03B61zwj 1200zero width joiner<@200Dz RFC 20704zwnB>AInon-ECE} # maps the HTML5 named characreferences to the e0quivalent Unicode character(s) html5 = { 'Aacute': '\xc1', ae,;-.RbreveUu0102] 3c.F223edfEee\u033GSAcircue*H%xca+,&b4#utx2Acy?Vu0410,3SAElig6+ee*X%xca+,"afFu206"frU0001d50 1~TAgravae,c%xc-.ralefsymUu2135OlephSAlpha5039abCAmac 0Samalg`52a3l0AMP&)mp1AMP6! %An%a5a5227^'nd&a5'ndFc0CslopWu2a58v\a&22%ngD&9a5ngl /%ms&22Fdngmsda729ab79a96(9al;9ab6'9al;9ad6%9aa~%9aTangrt*21v(2bMFrtvb9s&22|3ngsf'xcDgzar5237SAogon'01 J3Aop3 5pc62240p)&a6p&a7`&24%pi &240posZ3"'"ApplyFuncti`approx4:'\u&eq}DArin|"ae*B+,svc%49abTAssig6225* E$5lef5$Frigh%'b8n&42JElk12Flk14F7lk3H%oc`&58xnf=\u20eUnequi;261 Nen%31BBopfX%39 5L&2aFotto2wtizcRoxboxGu29c|4xDL&553oxD*Fu25587oxd0xdl;': '\u2510', 'boxDR;': '\u2554', r3d020'0cHG0h0%HD'66/&Hdh050h02UH90&Hu7h0803TminusK729f3(pleFtime5a$ULM755d3&Ulu0b0u01Ua0U5(u0Hu01V1_v0DV-6V.6v0v03H6V6v0 026V5v05v01Tprime9%03DBrev602dAvbar&xaer_5Bsc1KU0001d4b6BsemiHFu2044sim&23s'2cof\9DsolbC%9cubsolhsu&7c#ulFFu202TulletK $mp&24DumpE)aa{&22dBumpeq1 ITCacutK5010ch&Cadc2Ucapan%a4ucapbrcuJ(a44M%a4y9cap2UcapdoV%a4CapitalDifferential%146capf29\ufe7car4Scaronj502ceCayleyP%12Zch%a4CK1c2BedilJz&ccex-.2ircEu010)cceCconin|%23|5ccuV2a4c', 'ccupssm;': '\u2a50', 'CdotD010acbAedilE9xb8DC+-larcemptyvVu29b2H"nt\a+xtCenterD8xb7C%er2CfrHUu212d0U0001d523Hcy16042ah43eck/E2713`heckmar3Chi2703aJci&5c4ircC52c6uSirceq8225Fclearrowlef621b$ir"Grigh# uUledas,29c;229^Uddash9C|Xu2299BledR7;xaeSEu24cPTMinus%29%(Pl5VGTime;GER&9c4ire uEfnin.%a1ddcirmid44aefVcirsc%9c ClockwiseContourIntegralE4232ECloseCurlyDoubleQuot&01x( "~5lub &66%uiVColon<:4a74c+25"mms,F2mma@p(01f1Kcompleme266lex+%10Econgi4`Fu2a6Xongrui6(CoH&22/ %2"$pf }5pro2 Co"ucl8\u23OPYV2subFu2ac6subd5csu&adK7sup/2', 'ctdot;' : '\u22ef', 'cudarrl;':938r5%ep72de$sc0'2dd5lar161b61p3493d%Cu42d3c'2aEbrca1%a4FCupC%24`9cup2pf(a4f4dot(28Ko'a4&%ps/2a\ufe00r7m9793cwlyeqpred|r7sucdrlyveeW*2c9Gwedg81ren7xa42renL vearrowlef* r!Grigh"2wedqFu22cewconinK5232w1TylctyL%32UDagge%022dddalethK1;DaIAE95das\%01uTDashv/%ae/&2aGdbkarow2%90=Ddbla-602d CcaroEu010+dJ$DcQ60413$DD1,d%14dyI 3cuDDotrahM'913Totseq|%a7t2degbd2deg)x%De%%20=RDelta,Eu039dbEmpty&9b6fis&97]fvU0001d5}d#Ha5Eu2966dha&1c$hcDDiacriticalAcut"x!DD02d9n !GubleHuukBGravk`GBTild\A5dia6%2cqeDiamon1 5suiY&665iam %xaDifferentialLFgammADdisi522f#di=%xfbdivide ;': '\xf7',  'divideontimes;': '\u22c7', ?onxCDJcyE04020j5Slcorn0E231e0Ulcrop%0dQollar$ADopf\U0001d53bd$552Dot54xa8dTu02d95Dot-Tu20dcRdoteqEYu2250LD2251DotEqual6Fminuo3'pl$14PdotsquareQaldoublebarwedg!4306=D!ContourIntegr*2f(1BDownArrow:1d3<KLeft".D"LRigh''%Te,ae 0ongK m%7fJF&q;7fa?ong'f#:1d2J#2x)Up%1d iVerticalB%2$ 9?wna,do 8s)91W fDBrev5031z%1charpoonlefEu21c"rac wn6RVectocF\u29~&4epa622dEpars%9eFeplu72psi~Eu03bHFEpsiH'03J 4Depsi503fL&eq'u2/eqSeqsim5224\eqslantgts6lesEEqua'a7#ua3=x,ETild 6ues'5f6uilibriu&1c%qu6226$DD&a71+qv5rar9rG%EsD2130e2e,%25/E%a7]e(3Eta5039peb2ETH dm2ethf2ETHRxd0', 'eth;': '\xf0', 'Euml'$cbee(;)*BeuroUu20acU1xcl!1istd\u2203oExistsexpectation&13xponentialE$47Veefallingdotseq 4252?3FcyD0424f4Eemale%64cffiligH&fb)ff1lc2FfrGU0001d509 2X }12FilledSmallSquar%5f$OVery($aaL$fj%fj%la666d+U\ufb0jEfltn%5bBfnofEu019/3Fop 3b 5RForAl}r?orak522dTforkv%adFouriertrFu213epartin&a0Rrac12ibgx3Fu215F4Ff/*xb5F506I8&2'Grac2d6d3ea*xbFx3 428b5Grac5K 7sK05row&32#sc %4bWTgacut501fRGamma'Eu039gb0d1d(13gap/52a8VGbrev1 gfpTGcedi&&01SGcircc6011 Gs1g34Gdod5012r2g7%26Zg5226w$gE62a8e&2dOB&eqfnGqsla7Zeac>52aa6ges2a80', 'g esdoto;': '\u2a82', 'gl42db\ufe00%es6962GfrU0001d50a3 24g3Uu22d9/&6b+5ime4137.CGJcyZD0403'gj5C%27C3glaBE2aa5B%lE9L%ljaEgnap8napprox^&26&ne,8?neq E4sim0%2eBGopf%3eb 5}2rav`.GreaterEquaO695LesA%2d#KFullFe*Eu2aa bYSlantc%a7$BTildU\u227,9Gsc4|g7u21yIEgsima%a8A%a9x GT>o)gt!GT !GtD%Dgtcc'%aaeCgtciFu2a72tdoBWd05lPa1%99egtques36a7cr6rO7u/trOreqlUYgtreq(a8 7*?gtrxvertneqd !(vn SHacekt502cDUhairs.0>3hal4xbd#UhamilX%10CGHARD2Ghard4Al%1d'ha%94w521a"Ha^b,410fDHcir&01"h\UheartF6i"uiw9\u26llif2tdhercon%2b|H8h42HilbertSpacuhksearo)9:Jhkswof4Uhomth$23'hookleftarrow;': '\u21a9', 'hookrightarr!a!EHopf8$0dhU0001d55SDrbar440154HorizontalLine!5500!%sc8410bhl&4bTslashK410f4cHstrokD0126h7HumpDown8H224eVEqualmUhybul40435dhyphen2%01aIacute%xcie,E -."icEu206SIcircnie*B%xc+,yTu0418&ic3DIdot-&13E.*'ie3ARiexcl%a1p[xf$d4,&If`1B_5-TIgravcFie,c-."iiEu214%Tiiiin'62a0E%22Uiinfi`'9d15otab2SIJligE0132j9m-&2105Ima5012+iEimag HuginaryIe Gmagl'1=P5par)SDimat6013%mo%2bSimped}501bisImplies621d)n&20Fncar0H &21P%ti3&9d)no+I&22r7ntcbfnteger2r62O/erQIntersectioc/Ttlarh62a1|Tntpro~52a3InvisibleComm!6Tim%06w'IO@0C'io55Iog6012 I4i5{I5039ibbiquestbxIscr;': '\u211 0', 'iscr;': '\U0001d4be"inXu22085dot(f5E9s4v3{v4062-cItildeF6012 TIukcy14406Ji5AIuml#6xcf,e(W )*RJcircEu013jZJ1j3)Jf450dj%27Dmath%23BJopf55413 $5bJTajb>GJserj5J0F 5RKappaTu039akb503f5dKcedilJ%13*kIK1a3K0kTkgree5013$'KHd2'kh4Ki%0c!j5K4k6 a? csClAarEu21d-VLacutl2tlaempty529b!TlagraF5211WLambd;lbCLang!727e}Tlangd/%99el727e1p/%a8LaplacetruRlaquoaJxLl9(lA . b[Gu21eeErrbf%91Hlarr%hkLal 1p(29TrrsimL%97u3t3%1a%lawab5Ata7291S 72aa%teaad\ufe0FB^9 )lbElbbr*&77brace;': '{',  'lbrack;': '[', !keh\u298b6sldfudcLcaron5013le2Fedil2cc25lce1F2308!ubH{1LcyW\u041Y33dca-D2936CTldquo&01reldrdha6967K8rus4}$shL51b22E&264264*LeftAngleB$et8%7e#Drrow8190?adJleft 8A8B*1eQRight)}ca&ta%1atCeiling>ODoubb$wnTeeVecto1JDown!?1c3!8959$6Floa430aHharpoondow$621b$3eft"$up&1bt0eftFs!cbk9rCBd!_!B !m"$1eftgZsquiga %94m"&Tea:Teeta9 Y5threetime%2cA0riatH2+cD"DEqua922b.Up)95/Upi*Up)1b59 ?^ =%lEa[e'2duqK7leqgUqslan%a78l $cc`%aaWlesdoG%a8uG%a8x8lesU\ufe096usapprox&859s'2desseqgt Msseqqgtr;': '\u2a8b', 'LessEqualGreater;': '\u22da#AFull' (66 >7flessgtX{S4aa1S54sim42721YSlant8a7d!_Tilde=dlfisht497c5Ulfloo&30fU0001d50f3 %29gb24lgE&a9#HaFEu296Tlhard/%1buTharul%96Tlhblk4584CLJcy6040j5L[42d8Clp5lar61c7-Fcorn^431eLleftarrow&21{l %96Tlltri1%5fTLmido6013 $40Tlmous2;23b5achJ4nap%a8*lnapprox&26Fn^&a8/6neqC  E,e{5oan&7e/of_5obr.7HLongLeftA47f5C &7f?ong @`LRigheer% 07lj%J%dmapstod%7fgU!_?ong!BAloop&1a F!l@'98H"pf$43+lo5Bplus8Gu2a2Ftime3?Flowa4'21[#wb_{PLower ?%191!t'19Az%5celozeng@  Fu29eYp(Ulparl&990r#crb#rh_V\u21cv`r%00'lr&2b_Esaqu&03?&scs1D d4c1', 'Lsh;': '\u21b0', 'l$im-6272-4ime8a8dgf!qb[!uoi\u2018racLstrokD0141l LT<(t!LTL!LtU\u226ul%Dltcc'6aa6[%ci6a79"doBWd05hre@62cb1Dimesb'2cJ5larc'97KEquese'a7L$riJ65c3c&ri{(b4f0FVltrPaz9zWurdsh478uru65vertneqqj268\ufe0?vnE@macr5\xa\1 l%64#maU\u272t%es12Map\Tu2905,m1Umapst DdownL71a7Lestolef%1aSu'1a5rke55aeQTcommaj%a2D3McyF041c/3&da&01'DD3measuredangy%22MediumSpacf%05Mellintr%13#MfU0001d51 2h2jBicro>bGxdEu222Cmidak*?(idfAiddos7\xb\ &nu1Binus:B92m3@ub6u2aM3(Plh%lcd%adC3mld}Eu202?mnpGFodel3Mop4R 5%215Msc'mb&4cEFstpo3`M'6039b7lti&2bquEnabl%20TNacut5014n"5nanT02200dn%245napEa70\u0338', 'napid;': '\u224b\u0338', 'naposG0149Cprox(224tur666e2_turalgE211551bsp8xa0F 2umpeVbumpef%ca<4a43icNcaron6D0147n.TNcedi6014 6K3ongc(22cdongdotAHarrf\u2904NUinfind(lA3'vl4il<&ri8b8rn3)rt9 4sim;23cwTwarhk&92Wwo51d6ow(*19$owJ 6nea[$27KaOacute %xdyof,^ -.2oasee$9bq5oci429aSOcirc,f*nd+,yEu0415&oc3 9dOdblacG4150o1#iv0F2a38o9Dsold0%9bDSOElig5015)oe'of[%9b#OfqU0001d51J 2|4ogoo502dTOgrav.Gf,x~o-.ocJ'hb%b54hN603aJ&ina2l.bs)ol00RcrossEu29bEolin0;O COmaczFu014\ iCmegav cVOmicr%39o 7omik9Uominu2RBOopf=44 6(oplpenCurlyDoubleQuotN1 O' !IBperp8opl.O62a51&22Zr+r6%a5EordeF'13[Cdero8*u2fa#rd+xm)#rdx&igk!2b 'oror;': '\u2a56', 'orslope;': 7vbS44c8BOscrU0001d4aaoTu2134aOslashu%xdHof,` -.BosolFu229EStildeq5ofOE%xd- .2mesFu2a3A'ti+29a4COumlof(s%xd)*CovbaTu233dVOverB903e5rac-3d2ketjFu23bverParenthesi43dc\pr%22ZBparabcx6lle D2sim2Wu2af3ss1%af5par4202/PartialDJ#cyD041f1p3Bercn`%*QeriodC.%mi7030p+V\u22a+dertenk40311#Pf&51 23PhiJ603a{c&03Rphmma\v5honC%60CPscetchfor%2dk'piElanc/&10h&21TplankL23u+bsplusacigFu2a2Dlusb^%293 2h%do31Tlusdua5lusQ%a7JsPlusMin5\xbd#mnZ a -B2VEustw%a2pqGPoincareX&10Sointi1BPopfUu2119w6BoundaHxPbp%275praz&ab5rcu&27"rEmFu2abr,&aa4rec- recapprox xeccurlyeq~fPrecedVEqual;': '\u2aaf', 'PrecedesSlantEqual;': '\u227c%VTilde e pEqa^unapprox(b976neq9)b54sim682e87EPrim60332 2sc'114napa&nEn$od0'20t_oductprofalar%325lin'31eofsurf61o421dProportion4>237 <epropto8VprureW%b0i#scU0001d4abpcn3Psi}603acEuncs%00)Qfz4514zq5qin%a05Qopz511aH%56)qp5zQafq%c6juaternion0Hquat18"es?KEeste%25@QUOT"+)ot" # CrAaryEu21d5rac23d\u0331jTRacut5015r#Qradiczraemptyv%9b)DRang'7e!Erang%99729a5ngl'7eI0quoG7\xbu#quaR;aE(rAR&rr'974rrb*1efY&92y5arre9nGrarr11%hkda+l1p:)94m%97&t3L%1aw99WrAtaiJ*ra#tiEu223i raj%alF''RB&91^ <(rb0Erbbr\&77b\'}', 'rbrack;': ']', 'rbrkeh\u298c6sldeu$90cRcaronD0158r9fRcedil26r715230JArcubH}*1RcyU\u042r43dca-6293medldhar6oDdquo401dur1 $sh041b30R|&11|$ea2'in1bFrealparta Ls%ec/%5a0REG6\xa,eg2REGS ' ReverseElemeno%20!quilibriumDLu21c%>UpE'596fEfishe%97Urfloo3~fgU0001d52bH 4y5har)81c1'&1cmEharu%96$RhS703aG]#ov,503f-RightAngleBe%7e$CrrowAD2192adr^  :A:B'91e5Z ALeft cMc&ta&1a2!tCeiling@ODoub%wnTeeVect%957% "%1c "*95FQharpoondow<2F#$upO!Aleft T"G$| G8Qsquig#93%Te*2a,:TeeaL~threetime%2cC0ria2l)T d C6Equ*2bjUpDown%94+I/Up *UpC%1bxC 5-#!ctorBar;': '\u2953', 'ring;': '\u02dasingdotseq'226Dlarr51c477lhacm.500fTmoust:3b1OacheDnmid5aee5%oaG27edf04brkH67e70p4986DRopf/'11_U0001d56\Toplus4'a2{Ftime&35eundImpli4970r)gD&99eppolin5a124r9Rrightarrow41dbdrsaquo%03,6Rsc10%4cc4RshH1!qb-]1Ursquo0EthreK&2c %2cArtriuV\u25bb6triHb/55b8GtrilK%9cRuleDelaye&9f7uluJ&96Sx%11MTSacut5015s)sbD1$Sc_%ab's&27B6cap,cScaron5016sDsccu5227Y3scEG52ab%sc,%ab]cScedil/5015s|DScir7015 n17scn-Uscnsi%2eC,sc/(sc37y'4274%do%2cBsdotFY\u22a/P6Eearh&92I'eAMd(seS9O!ctx%xa3sec m;WGsesw2]Vetmins'21$tm2xsEu273/#SfI5I 3Usfrowd%32pEshar,&66FHCHc7hch4S0f .ShortDownArrow;': '\u2193', 'ShortLeftArrow;': '\u2190!s!4mid%22<parallel 5;\LRigh]2"+Up|11shy7xadjRSigmaFu03a cf1cs1vmE223cTimdot7a6ae'24x?meqg7a9eF%gEa%imn&a96iml/'9fGn6Eplusa'24Drarr&97!l%SmallCirclj%18Pfsetminp&21Tmashpo&a31emepars&9e&mi3ma%mt&aa6mteuac\ufe0cSOFTcy604277oft4/3olbA629cEolbaw%333SopU0001d54 6O6pad%66s%ui %22Esqca2?,:293,Gsqcu77475Sqr&215qsu8%28s&29@&seL 47set 89Gqsupii@i8u%5aUSquargs2IntersectionW%8SubBEqua7\u2Q$phW ! G&)Un3uar7u25/qu&19f#sc6&4a[ c?s\'st%2c&St/%60.&60{0traDUepsil=03f"3phiX803dns;': '\xaf', 'Sub;': '\u22d0', 's'824dot/7abdE'c5e8286H'c36mulb'c1ncbdaDplus~7abfDrarr4979USubse}  TseteqM ai_Equal:nVgsetneqW 4simR4ac77sub(ad5sup2d$cc'27bccapprox6ab8fwcccurly7#uSucceedV %ab YSlant%2`FTild7&cc^\succnq)ccob7ccnq%2eJTvSuchThaf0]%Su'21$ng'66!p1'xb"p1+ 2)$p2)3)$p3)SH'2d^%28,8sup&beC)pd]pp8(peb$c4bYSuper b U5hso(7cchlm:supscGsupnJ c9p  9u22z89((ac R9supTwarhk'92A&1dw*19$owJ 6nwa:2xBzlig'drFx#TaptFtargw%312Tau?Eu03at5tbr%3b-dTcaronF164', 'tcaron ;': '\u0165', 'Tcedil2t34Tcy/'42/43dot-D20dbCdtelrec&31"frU0001d5173 %31Rhere47Tu2234TOforetSTheta4D0398Ptb5sym3d?tavickapprox7224RTicksiRD223cThickSpac05f\u200a#dthinspW4009JThin;Ethka4 AHORNP4xdebRthornfT* +,5ildt602dDEqua6224KFull!o!TuBimesd-xbUu22a0/#ba7u2ad4'a34n4522dK$oe6292+oaFtopbz6336F6pcifBTopf{4 >rtopfork9Fu2ad'osUtprim0DRADEH1X&ra UianglK%5b"trDdownR55bf5lefh%5c5>$eq@&2b\@5=Frigh]b< ^4(5e[2rTminus%a3vTripleD6s&9c7rit&a3 erpeziu%3e3TscmV&4a c(TScs47TSH0'sh5TTstro5016It5wix&26`wohead*Tarrow%19t# $%cUacutejuf,ixn-.rr;': '\u219f', 'uArr;': '\u21d1'a9uUarroci249492SUbrcyJD040eu5dUbreve1716c1 dQUcirc4xdbuf*[ +,&23W4d$c5.bUdblac[Tu0170uIFudhaF6cufishtJ5297#Uf/U0001d518d $32cUgrave2uf,y%xd-.(uH Bharl-Tu21bf(uh8bTuhblk0&587Tlcorn&31e *u25rop40}Dltri%5f8DUmacIE016a U2umlKaC#umxcUnderB_U4rac523d%ke&3b^RParenthesis&3d5nio0%2cU5Plu4%28}5Uog450176uL2opf{4 %66bpArrow97u21LpM} 4N_U\u291UkADown&tp9i[pdownu<Equilibriumz9pharpoonlef# 6rig1,ppperLeft9@perRV "7s!503dP'upDh/VUpsilR'3a: LEUpTe22 2upu!&1cr;#u; ;#Dring1 )urkF$Usj;&4b c5tdo+%2f3TUtild66016 u'\u25b5', 'utrif;': '\u25b4', Duarr41c8AUuml.4xdcuf(? )*ruwangleTu29a7Xevangrt9]varepsilonF03f56frkappa0snothing822083phi903d6Ncpropto4E221dA> KU9b$rhGE03f1Gfarsigm(c2ubsetneqx8a\ufe0s%&?acb&pK%KcKFthetd1tri5lef(2b"Grigh#35VbaA4aeb(vBv4ae9/3Vcy60413SVDash.522as)Vd\v0 0`la%ae_%Ve&2cF2]'ee%2b7vee$5advellipv42ee7VerJ%01v|- + )Gical&220ert2Lin 8Separato%75V>BTild?U\u224VeryThinSpac %00 #VfVU0001d51 3Dvltr2EnsubVu82\u20dFvnsut*833Vop4N 6$rr9Vsc&4b[ cGTsubnEgA\28sup> 4> y Vv"|%2aevzigza%99SWcirc25017w7wed4a5fFWedgcTw2%25KUweier%11Wd1w3W4w6jw\u2118',  'wr;': '\u2240', Oeath3Wsc0U0001d4b24 $ccExcapMc2Txcirc65ef/u/3Edtri/$bd)Xf451bx%353hAr6Vu27faa7XyD039exblZ8-lZm&7f34nis&2fDodot%a0BXopf&54N %69Eoplug6a01BtimeQFu2a0rJr6IXb cFxsqc%a0O*xu4h)xue%ve&2cGwedgHaYacute%xdyf,% -.2AcyEu042'yaY5017yYF2.y4"ena2yenxY=1y3'YIr0'yi5Y5y6Y8byc'YU2'yu4"ml$fBYuml%Eu017yx,Z1.(zSZcaro`fzZ1Tz3Z65017 zSzeetrOEu212ZeroWidthSpac?%00QDZeta%39zbZH ezH1G'zh8zig1Z]y>zz6 Yb;zc23zwj 6200'wnu} # maps the Unicode point toHTML entity name #"2J = {K 1Ie character # (or a character reference if theis outside*Latin-1 range) entitydefs = {} for (name, codepoint) in 2.items(): *2&[&1] =8%k[&Echr(-a) del0| """A parser HTML and X .""" # This file is based on sgmllib.py, but0API$slightly dif< t.H*XXX There should be a way to distinguish between PCDATA (7d #zqdata --vnormal case), R5replaceabl4 # :AonlyQAsd tags apecial) #g( Y/en:. import re p_markupX from html (unescape __all__ = ['P '][Regular expressions u?ing intereh_5= re.compile('[&<]') inZlete &[a-zA-Z#&P#(?:[1`+|[xX] a-fA-F]+)[^0-9') starttagopen<') piclos>oommentpr'--\s*%# Note: # 1)0you;0ngefind/attr rememberupdate locate0oo;O2Ooand/orC$he@willN "lode, so don't do it. # see http://www.w3.org/TR/p5/tokenization.P#tag-Yc-stateBB0tag#_tolerant&r'8^\t\n\r\f />\x00]*)(?:\s|/(?!>))*') rOr'((?<=[\'"\s/])[^\s/>] =>V\s*=+\s*'0\'[^\']*\'|"[^"]*"|(?!B?>\s]*))? rU% [@ #\0 *@# opal whitespace before -TibuteQS685 # value indicatorY*(?:'[^']*' # LITA-endE;$  7;:%'"3# bare value c ) 3\s* # possibly followed by a spaceD)?(?:\s|/(?!>))*_)? d w# trailing whitea """, re.VERBOSE) endendtag =+compile('>') # the HTML 5 spec, section 8.1.2.2, doesn't as between # 'r5.~Pset_cB_modg, elemB%! =!.lower()&'interesting = re.compile(r'' %V,-I4Bj4.find('<', i|%if j < 0C# if we can't I the next <, either!aare at5endD#0e's moreRoming^latter is TMApassy#tox_ in case2havaC# a b@ cut4@halfend. Trydetermine if@thisx0bef edpby look fnKa& near1end se{Y it'sPa spa2r ;gampposr('&', max(i, n-34) BCif (B@>= 0, [\s;]').search", Q)U?break # wait till@get c YNelseTmatch i)<&r1if I`.gi   cbreak Yj = nif i < j:5if self.convert_charrefs and notdata_elemBFCphandle_+(unescape(raw}[i:j]))OelseS J I2i =updatepos(i, jnn== n: :startswith = i. n&f ('<', i)YVtagopen.match3 # < + lettercSkaparse_wZtag(i+$elqQ(""<"*N Jif k < 0!if?end BXpfind('> 1 "SGS5W&[TXok += 1(+eG, k,= [^[i:k]8k) Y/&#U3 = C Y1if 5bname =".group()[2:-1]I(C *'|_.end($7wV';', k-1UY?k -G  sGcontinue else: if ";" in rawdata[i:]: # bail by consuming &#CVself.handle_F(N_i+2])9Ai = =updatepos(i, i+23YbreakMelif startswith('&', i)match = entityref.5 Y1if %Nbname =".group(1(@0kWOend($iif not;', k-1Y]k - 1kcontinueJ2 = incompletej.#e`) willtain at least 2 charsf end andK)===A:.(if k <= i4#OnmOi + a#nV9=(XO < n#i1theC0of qbuffer,Rcan't be_fused #  some other/ostruct05T?"&"/ $,assert 0, "interesting.search() lied"#6Fwhil+iixFHcZ_elem ponvert_Orefs> Sunescapej[i:n])f KnnfL@  G0# Ih%nal -- parse html declarations, return length or -1 &terminat# See w3.org/TR/M5/tokenizO.#markup-g-open-statJBalso_,V_C2bas03def)a.(.0[i:k == 'tgtpos =C./('>', i+93if .J= -1\ )-1a.[(1+2:P]gG+LJelset)agbogus_# Internal -- * * *#, Klength or -1 if not terminatedM see http://www.w3.org/TR/5/tokeniz.#l-la-stateK2def_"0, ivport=1)=" =Odassert 2]('>"= iY1:-1]eF unescape(O 'Ps.app)%np)8b^cend = 2[k:1w].stripS ifLin (">", "/>")lineno, offset = ggetposNrif "\n" in%_Z_textX1\3 = +8p.count([ CAlen( v):-qIqNelse /+ }phandle_$[i `return5posJswith('/>'# XHTML-style emptyvq: Z 0end2tags>;k if=CDATA_CONTENT_ELEMENTS~dPset_cD_mode(tag 7# Internal -- check see if we have a complete &; NJPor -17$in/.2def[_for_whol'_7, ibKdlocateei,ifjl&c0nexz^[j:j+%^= ">"Uj + 1[n^O= "/9$if.7, j%Lm2m!Q"P# buffer boundary  return -1 # else bogus input#if j > i:M[jX3 Ji + if next == ""<# end of Tin ("abcdefghijklmnopqrstuvwxyz=/""ABCDEFGHIJKLMNOPQRSTUVWXYZ")  in or before attribute value,we have the# '/' from a '/>'=ing)0 + !raise AssertionError("we should not get here!") # Internal -- parseStag, f`r -1 ircomplet2def5_endtag(self, irawdata = .}a q[i:i+2]o |1ot : 5rgtpos =-e.end()HA{tagfind.{y's0=9i+3;5n__comment(i0tag! =D.group(1).lower`# consume and ignother stuff between(7theHNote: thisw 100% correct, since we might0ings likJ@# ">, but looking for > after thaYcovera`# mostuQcasesis much si 4$ =.Q('>',lX SU( (f"+1Z elem = match.group(1).lower() # script or style if self.cdata_elem is not None:(/1if !,!=4 (,Uphandle_[@(raw[i:gtpos])[3qreturn  Ipendtag(?!bclear_Vmode( W0# Overridable -- finish processing of start+end tag: Cdef (,0, attrs).34tag* Btag) RyG kOpass_  ] Tcharacter referenc#Bref(Onameboentity_ a(  |commentSV%declarationZW?ecl.instrucb$pi`?ata`unknown_0r"""JSON (JavaSPObject) a subset of = syntax (ECMA-262 3rd edi) used as a lightwe  interchange format. :mod:`x ` exposes an API familiar toW rsc0thendard libraryEmarshal` and Xpickle` modules. Itderived from a version` externally maintained simplex. Encodbasic PythH`hierarchies::.>>> import J] .dumps(['foo', {'bar': ('baz',], 1.0, 2)} '["foo", {"bar": ["baz", null.E]}]'jgprint(p "\C\?)7'\u1234'4"1 \-\){"c": 0, "ba}, sort_keys=Truez!{"/?}$ioxStringIO >>> (io = StringIO() >>> json.dump(['streaming API'], io)io.getvalue?9'["2 "]' Compact encoding:: laimports mydict = {'4': 5, '6': 7}"s([1,2,3,4 ], separators=(',', ':')',{"4":5,"6":7}Pretty print(( , sort_keys=True, indent=4{p6 5,Q6": 7R} De2_ JSON7 obj = ['foo', {'bar': ['baz', None, 1.0, 2]}]bloads('["foo", {"bar":["baz", null;') == objD M0"\\O \\L4'ax08ar'4 =from io )] j+p(io)[0] W SpecializjSect dz def as_complex(dct):`0...d if '_ __' in dct%*wreturn J`['realzdct['imag']^54dctu Ws('{"A": t"_p": 1, "]b": 2}'aobject_hook=R(1+2j qtdecimalD1.1', parse_float=.e (''e d,eN(objisinstance , )P[obj.T,F.SmMraise TypeError(f'O_ of type {B__class__.__name__} 4Htf'is not,A serRable'::...s(2 + 1j, default=;0'[29B1.0]e/E?er(B.RiQr''.joinZYJiter]^@ UsQtool  the shell to validate and p-$ echo '{"G":"obj"}' | python -m.af3 4T 1.2:3.4P PExpec property UQlosedSouble quotes: line 1 column 3 (char 2) """ __v ersion__ = '2.0.9' __all[ 'dump',s Dload2s',&JSONDecoderEErro#En"0 ] jQuthorm'Bob Ippolito ' from .dc import g'r, t2es2 Ecs _default_3=S.(skipkeys=Falseensure_ascii=Trucheck_circularallow_nanindent=Non>separatorsp) def (obj, fp, *,    3 cl  @ g sort_3q **kw):N """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`resultaOverflow (or worseN.%itDValu1 toss2out  ng M v5s (``nanS2inf - )Ict complia!owpecification, |uz1theIJavaScript equivalent2NaNxInfinity- -arnegative integer,pnarray elemo"an#P membFpretty-prJbd withu level. And0@onlyert newlines. ``bhe mosT1actGrepresentJsa ed`` shouldXe(item_",p1)``gtuple. The R0``(`p, ': ')^2f ** B130otherwise. T\o get the most compact JSON representation, you should specify ``(',', ':')`` to eliminate whitespace. @ ``default(obj)`` is a funcdT that`return a serializable versionMof obj or raise TypeError. The jr simply$s% EIf *sort_keys*ctrue (>: ``False``),)n output ofD!diaries will be Ued by keyTo use a custom ``j Encoder`` subclass (e.g. oneoverrides}s3``.(G`method}.`e addiVal types),qit withJ``cls`` kwarg; otherwS isd1"""C# cached eif (not skip\0 an!sure_ascii*Ycheck_circular allow_nan) lsNRiindentseparator*B8 3p Ekw):7Aiter3= _C_. 4Gelse>6f cAls =t @XtDcls(K= F, enQ= E _=,k=u", Z= Ob= ##=,e= , **kw)?1# cgqaccelerNith writelines in soms of Python, atE# a debuggability cosfor chunkHi1fp.k($) def dumpsE, *,=" jTrue, j=m"=| c@\a]C"""SGre ``objaw formatted ``str`` Ifpthen ``6 eyaat are9Rbasicv(W, ``int`` Cfloa Bbool6``)FakippedFpinsteading a ``  fb value can contain non-ASCIIwcharacteOfy appear9tstrings; eda4. OIcNWsuch S3Rescap; U H>referencexner types wiLll be skipped and a circular reference will result in an ``OverflowError`` (or worse). 0If ``allow_nan`` is false, then it\a ``ValueM!toCserialize out of range ``float`` v5Qs (``c, ``inf`` - B) inLtrict complia of JSON specification, insteadsPusing)FJavaScript equivalent2NaNxInfinity-)Pinden is a non-negative integer'array elemo1andobject membersOpretty-prJd with thau level. An L0H@onlyert newlines. ``Nonerthe mosT1actGrepresentJa edseparators`` shouldXe(item_"V, key1)``gtuple. The defas ``(', @: ')2f **B10otherwis\Po get 1 ,4youy`to eliminate whitespace'#``A(obj@func.return a #able versioof obj or raise Typ_.5bsimply$s% If *sort_keysBctrue (P: ``F3``)AoutpD!diFarieUPed by`To useustom ```Encodebsubclass (e.g. oneoverridess3``.(Gmethod to.`e addiVal types),y!thJ@``clukwarg; # isd1"""C# cached eqif (not\ensure_ascii*{echeck_Y ) ls Z *k8 3XEkw):7_?_.,Fif c@=Z.VAcls( 2= (, 8= 6 B=%, = .=?KA= ,= , 8= EY**kw)% =!de DDect_hook=,Vpairs) def deting(b): bstartsw ith = b.startswith if b((codecs.BOM_UTF32_BE, QLE)):@Dreturn 'utf-32'X /16X?16_X/16X 8t8-sig' len(b) >= 4if not b[0]@# 000--  1-beO"&!XX#1- -&,16&*'[1] elseC2-beZ1 XXsL32-l&&/16&# L #le2] or b[3lSelif vF== 2av p 1# 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 rvalue 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 ,7Gparse_int,  parse_constant=, object_pairs_hook=, **kw) def loads(s, *, cls=NoneGAiRfloat$# #in ? E:L"""Deserialize ``s`` (a tr``, ``byte#or array`` i!ceIcontaining a JSON document) to a Python,!. 5#``Rs an optional func that will be called with th~result of anyd literal decode dict``). The return value ofvAused0eadh th.ONis featur0can6to imple s customrs (e.g.1-RPC class hinting)'b-L_rdered lis` . @0 D )%``8FP&ThJ FV. If{NOis also defined,2) takes priority{jif specifiN q stringof every H#bePd. Byatis equivalent toH:(num_str,is!use another datatype orrG'ordecimal.Dy?int0i?int8eintegezW  on>Zb@llow s: -Infinity, ANaN.1 1raiQ exce if invalidqnumbersCare encount1To u ``Dqr`` subp,0y igX ``cls```qkwarg; Zw K iskd1"""6s@ancexKp.starts('\ufeff')#' Error("Unexpected UTF-8 BOM (Z0 usutf-8-sig)",OQs, 0)(else:  if not isinstance(s, (bytes, array)): raise TypeError(f'the JSON object must be strHFs orQ9, 'Q\ f' {s.__class__.__name__}');#s = s.decode(detect_encoding(s), 'surrogatepass') ;if (cls is None andX_hook0 parse_in0:Ifloa:!coe 'y]pairs'kwreturn _default_rs7if =D5r$if~:Bkw['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 IaE%! =  __all__ = [' `7', E '] FLAGS = re.VERBOSE | MULTILINDOTALL NaN = c('nan') PosInfinf') Neg-! F<R(Valubb"""Sub-6of ` with afollow00ddial properties:cmsg: The unformatted e- 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! =*no4yreduce__(self): return self.__class__, (Bmsg,3doc pos) _CONSTANTS = { K'-Infinity': NegInf,6Pos0NaN+ ^#a backslash denot8L,anr follow6)= UbreakHelif["!=!U*ctJ# %r at" % (,;EHP{0!r}Kw.formatONZ:end3;els 6$Einue0try:  esc = s[end] except IndexError:raise JSONDecode# ("Unterminated string start Iat",EIs, begin) from None6# If not a uniyape sequence, must be in the lookup tablH if8z != 'u':trychar = _b[esc%)1Key<msg = "Invalid \\escape: {0!r}".format(esc)Ygmsg, s, end3end += 1HJelse0unid_uXXXX(K5Kif 0xd800 <=0xdbff andC: 2] == '\\`HOuni2J + 11ycy2z:fff-0x10000 + (((-) << 10) | !2 Nc00)|O9= 60chrD9_append( return ''.join(chunks) # Use speedup if availCscanGG= c_Wor py WHITESPACE = re.compile(r'[ \t\n\r]*', FLAGS)._STR = '%q' defObject(s_and_end,@ct, !_opo%s_hook, Rpairs 3 memo=V, _w=`.matchs)[kB = [1 = ./# Backwards "atibility!if1 isxyQ = {}'a_get =/.setdefaulta slice to prevenN be!d,followingIcheck will 'a a mor.cific Valu~:0cis emp@next>140# Nlly we expect 3Q= '"'&if<"<fin _ws>BCD= _wn.#s K"# Trivialo~} R 2Presul 8([ 29#:N#if9 C}y. elif nextchar != '"': raise JSONDecodeError(#.-"Expecting property name enclosed in double quotes", s, end)Mend += 1 while True1key/ = scanstring(C , "ctKkey = memo_get(=6key!8# To skip some function call overhead we optimize the fast paths where l#' {separator is ": " or just ":".6if s[end:1 1]:C= _wf).end(I*':' delimiterA6try#]:_ws"E ;.?L + 1except Index _pass XvalueoT_once8eStopIteraBjas errovqn1rr.) from Nonhpairs_app, =n]Li?in p Km-9%'' n[== '}.Vbreak@l0,0/',F - 1t!  H _if object_@hook1notresult =0(;2rreturn 1j &x = dict3}<)Cr&qA defArray(s_and_end,b, _w=WHITESPACE.matchsR_STR)MRs = [}   j] # Look-ahead for trivial empty array if nextchar == ']':return values, end + 1@_app=.while TrueK6try \UT= scan_once(g)H' except StopIteration as errPraise JSONDecodeError("Expecting0", b1rr.) from Noner(!%p s[end:E+ 1]"Jjin _ws1C= _wKf).end(iI#+=3z  Ubreak(el0W!= ',0L',' delimiterTfnd - 1 "if:/] x ;&?a OQIndex" Qpass ) classdr(object)F"""Simpl drbPerforms the followatransls)4by default:A*+- +|#| Python|**+= T> | dictT = T?lisT.0str@VS| str number (int)+in T'real) | floaVTDtrue TFfalsU9| FT#@null:| It also understands ``NaN``, ``Infinityvand ``-1 asDtheir correspondH!``"``Rs, which is outsideb spec.2""" `def __|__(self, *, M`_hook=, parse_l2int.0con strict=True7,  object_pairs_hook=None):%S"""``& !``, if specified, will be called with the resultIof every JSON R decoded and its return valueYuused inJplace off given ``dict``. This can:to provide customIdeserializations (e.g. to support-RPC class hinting). DC #"5 ofN"Wan ordered listwe>MF?of %pinsteadRPMW`featur _implementa5rs.?IG is also definIy`` takesLpriorityparse_floatestringY L #bePd. By`ault tiis equival%toL>(num_str). use another datatype or rK!or Tdecimal.D B?_in 5?int &?int> 10) & 0x3ffO"s22c2n* 1 bs1, s2g1_@") classE:r(objectExtensible' ]Tr for@datauctures.Supports the followrs 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 callQsuperJation (to raise ``TypeError``). """item_separator = ', ':key:)def __init__(self, *, skipkeys=False, ensure_ascii=True,V|check_circular! allow_nanWsort_U Bindent=None, sbdefaul%):9"""Construcfor JSONEncoder, with sensible Es4%IfR is fpthen it%a n to attemptejping of  that are not str, int, float or U. IfCjnY` such sJasimply:pedAt the outpuguaranteed be~robjects*all incom non-ASCII characters esca Fcan contain X M n lists, dicand custom /edall be V0ed % references durG %toKprevent an inf+e recursion (which would cause)Overflow%).LpOtherwiT"no takes placeG bNaN, I0y, -1 wiwQed ast. This behavior[JSON specificatcompliantbYpconsistimost JavaScript based!rs!des$itr a ValuL [n !of5pionarie "Ped by0; tis useful6aregresRtestsgEqerializE s ompared on a day-to-day,ia5negativeR egnUarrayrelementsP memb pretty-printedElevel. A 0only insert newline!Pact represent" (ed 1 shcb`(!,)Qtuple(, ': ') if ** `` ``H0(',30oXQo geti  A4you$y `!')W liminate whitespace.  2If specified, default is a function that gets called for objects E%4can't otherwise be serialized. It should return a JSON encodable Lp vers|cof then` or raYa ``TypeError``. 96""" self.skipkeys = .!ensure_ascii =  )check_circular =  -allow_nan = #Tsort_ #indent = if separatorsnot None:#JUitem_.!, 6keyNACelifxbe = ','G(ifX~=0%deA(F, o)"""Implem'this method i^subclass such#it}am```o``,xsdbase ita#?(to)pFor exaB , to support arbitrary itep, you c3d{'` like "::3; "6tryP0bleeter(o)#uexcept I6pasn;+lsTlist({V# LetD.B nE3er.FoV_YA(f'O ype {o.____.__name__} JPf'is " "').esI"""RXstring representa Python data structure>>> from json.sr,O1#()5 ({"foo": ["bar", "baz"]}'"'w0# T!isextremely s cases and benchmarks.sinstance(o,Nl[8lf.d"6_mG +eD>@does\Jtor directlyJ''.join() because# exceptions ar%en't as detailed. The list call should be roughly %# equivalent to the PySequence_Fast that ''.join() wL5do.Echunks = self.iterencode(o, _one_shot=True)4if not isinstance(F0, (, tuple)):2$! =2Tereturn-!) BGdef ), WFalsepA"""Egiven object and yield each stringgrepresentationavailable.&For example::Afor in JSON8r()]2big>mysocket.writ[ 5""""ifcheck_circularw`marker%{}9Oelse'ENone)bensure_ascii9_0Br = R_baseW0Mv= Xfloatstrallow_nan= .,j)_=<!._ __, _inf=INFINITY, _neg- 0# C` specials. Note`this type of tes processor#/or platform-Rfic, so do@s which dodepend 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| 0ind0is ( _9+ =_ -,Wdefault, qnkey_separator1=temsort_keysIAskip4P L,?strsort_keys,   self.skipkeys, _one_shot) (return _iterencode(o, 0) def _make`markerKdefault, _7r, _indenfloatstr,h_key_separato,9tem@sort&]K ## HACK: hand-optimized byte!; globals into localsValueError= bPdict==Wid=idgnt=intsinstance=i Plist=Istr=8atuple=&0_in^m.__repr__1): $if is not None and (Qstr):= = ' ' *N^2_0(lsscurrent?g_levelW!if6lstkoyield '[]'3if  J!pid = idRCTid inO C(fraise ("Circular ref,e detected"d"s[id] = lst0bufX[ _[U += 1YsnewlinehT\n' +I D! =: + b 9/+="Jelse K! = R(first = Trueor value p1if 6 @v = FalsN%= 7if j*, h'M+R(2 \Delifs/LV'nullik C5C OtrueC +D fOE 7int1# Subclasses of/ may override  but we stillNwant to q them a-Regers\ JSON. One examplNPithinF  dard library is IntEnum.*):   # see comment above for int  yield buf + _floatstr(value)-Yelse:G? if isinstanceQ, (list, tuple))OSchunks = _iterencode_8E_current_indZlevelH/elOdictz0z+]rRfrom Nzif newline is not NonCU -= 1Nl@'\n'o? * >95%]'if markers4del%[-Aid] C9def Odct,jot dctk&{}areturnt = id(dctCTid in kpraise VvError("Circular refe detected"ds6 =iP<, +" q/= -item_separator+> ! )! =0Q -first = True\sort_keysYe-.&()#/mQkey, b. w /7str&Epass[# JavaScript*weakly typedQ these, so it makes sense toIalso allow them. Many r7em to do something like this.N  1Aint/.0_i i0key16key!&!is  }"v= 'true;/Fa`<f=s None:  key = 'null'  elif isinstance(key, int):'3# see comment for( /float in _make_iterencode@p_intstri)#_skipkeyszcontinuXNelse+raise TypeError(f'S must be str!, , bool or None, ! f'not {key.__class__.__name__}'if first = Falsyield item_separatorC!_c ?keyA `value,/Ll, 1 is\F=?Tru=Jtrue z_{f}?2-kGG_u<(list, tuple)Zchunks = =_8(|, _current_indZlevel%H)?dic2z0zb]!Rfrom if newlineh CU -= 1Nlt'\n' + U*95}Eif markers4del%[-Aid] U8def /(o }ooA9o96 11 12 3o } int/float in _make_iterencode yield _intstr(o) elif isinstance(o, float):#G# see comment for int/*/ i|-~(list, tuple)Wfrom _2_current_ind_level {0 4delYhreturn" """JSON token scanner import re tryM`Sjson Z6R as cl except IKpI '! = __all__ = ['Z '] 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 _ _owng, idx?dpnextchaV2Q[idx]QGndexaStopIteration(q =,6if mR= '"'(` + 1, &ct W{W (X)Y0R", >  ,  [ \ == 'n' and string[idx:idx + 4] == 'null': return None, -!elif nextcharBt' and aOtruea?Truafa5OfalsbF%5 m = match_number(*)&if m is not  &integer, frac, expU.groups(FY!if&0 or( H res = parse_float(^@ + (`:0'')ijor '')dOelseZ %inX ;res, m.endN3?NaNconstant('))sE + 3vqIq8qInfinityv.{8{-{9{-N zQ /}9}  raise StopIteration(idx)def scan_once6try i_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 (R2) """ import argF `sys bmain()prog = ''pdescripO = ('A simple crface for= module F;' objects.'}%.ArgumentP r(=', = Ic.add_aB('infile', nargs='?', Utype= FileType(encoding="utf-8")Bqhelp='a y%bed/eddefault=sys.stdin0outp $ type=argparse.FileType('w', encoding="utf-8"), 3help='write the output of infile to 'Fdefault=sys.stdout)r$r.add_argument('--sort-keys', action='store_true', P_FalsewN !diV aries alphabetically by key' no-ensure-asciiBst='_ f%disable escapingknon-ASCII characters json-lineC30 in us `JSON Le format. 'I'Use with --no-indent or --compactKproduce valid ax.group = @@mutu_exclusive_&( i"4,9?intWseparate items1newtp and us2is number'of spacesG a =tabQconstJr.0='\2O'tab 2?Non |rather than    `uppres}ql white Vion (most e) ops=As() tAdumpA = {'_T#: F.'5%" (.}~%ifp:[x@] = #@ors''',', ':'[#as,0out4 as6try Q_ #'0obj($p.loads(*) 3 in5OelseO(:), ?pfor obj^objs:   json.dump(obj, outfile, **s_args) ,&.write('\n'$except ValueError as e:D raise SystemExit(e) if __name__ == '__main__'=2try (uqBrokenPipv&xc2Qsys.elxc.errno) from enum import IntEnum __all ['HTTPStatus'] class (4)k0"""! s1 codes and reason phrases V%the following RFCs are all observed:<*" 7231: Hypertext Transfer Protocol (`/1.1),Goletes 2616K6585: Additional C 13229: Delta encod!in8 +Q4918: Extensions for WebDAV;518?5842: BincB#toA 1 7238: Permanent Redirect'R2295:40par)@ContpNegotia  r2774: A Frameworkl0772_0Wa to ReLegal ObstaclesB?540 0VerZ# 22&C2324C T0Coffee Pot 9rol:CPCP/1.0HF8297pIndicatLHint8470: Us Early Datag1"""!deew__(cls, v[,J, descrip3=''obj = int.__n?Qobj._S2_ =\a# =q_.|( =&return objV# informW!al(CONTINUE = 100, 'inue', 'Request received, please cont%DSWITCHING_PROTOCOLS = (101, 'Switchl1s',7#to new p=; obey Upgrade headerPROCESSING2, 'Proces'aEARLY_HINTb103, ''0suc84aOK = 2 (OKpfulfillPdocum.snqCREATED?pCreatedDD1cS, URLl>RACCEP?0(20 AcA*a,+`s off-line+NON_AUTHORITATIVE_INFORMATION6203'Non-Authoritative I7 @Fcachs_Z1ENT4, 'No Content0', 'Request fulfilled, nothing follows' RESET_CONTENT = 205>set ContentOClear input forms furtheOyPARTIALQ6, 'PartialScf MULTI_STATUS7, 'Multi-StatuALREADY_REPORTED+8, 'Already ReportedRIM_US&2PIM Us # redirectionPLE_CHOICED(300ple Choices',1R 'Object has several resources -- see URI list')8 MOVED_PERMANENTLY = (301joved Permanentlykm$p$g@FOUN$302, 'FoundFtemporarilyFSEE_OTHER = 303, 'See O  MMethod and URLLNOT_MODIFI(304, 'Not ModifiedrDocumen[ not changed since given timeVUSE_PROXN5, 'Use ProxFYou must use pQ spec in Loca to access thisoTEMPORARPDIRECP0(30TVd.(8_REi)# Ri0 P# clirQerrorBAD_REQUES4CBad rorsyntax or unsup! mAUNAUTHORIZ4Unauthoriz0No dission+sschemes_qPAYMENT$IRc 1PayX.irgPchargI _FORBIDDEN4Forbiddene @willS help+%(4(~N`matche3URILpMETHOD_STALLOW "A( S is invalidgCCEPTABLE~ccceptable#Pavailpreferrei$ma;_9ENTICATION7 Authenti ,be with(Qbefor5sceedingb"s_TIMEOU*kxTimeoutd out; try again later]aCONFLI_409, 'Conflict', 'Request conflict' GONE = (410, 'Gone',)'URI no longer exists and has been permanently removed')ALENGTH_REQUIREDe1, 'Length Requiredp Client must specify Content-7]PRECONDITION_FAILa2, 'Precondition Faile in headers is falsecEST_ENTITY_TOO_LARG.@3, 'REntity Too LargBis too l `2URI]2ONG%4\-Y8ong*UTUNSUPPORTED_MEDIA_TYP 5, 'Unsupported Media Typbody in u1jformatED_RANGE_NOT_SATISFIABLs6K-ed Range Not SatisfiablCannot sWqr8}EXPECTA7, 'Expecta!`could q#betiIM_A_TEAPOT8, 'I\'m a TeapotServer refuse brew coffee because itk1a t@.MISDIRECr23MisdirecIx!isO to produce a responUNPROCESSP = 42=UnprocessG+ALOCKg 42bLocked_DEPENDENCYO Dependency1NBEARL)CEarl!xUPGRADE?0426fpgrade?m ?s2 A yThe origin ss the reVto be<#alAMANYBESTS@9, 'AManyHestswAuserPs&m/ss4a given amount of time ("rate limiting") HEADER_FIELDSo.31! H Fields-is unwilling{C <ss fi=are)qUNAVAILFOR_LEGAL_REASONi5qUnavailFor Legal Reason}@deny"aco`resourP0s as0nce1a lgPdeman#MaerrorsINTERNAL_SERVER_ERROR/ 50Internal LE:3got itself!@trouEIMPLEMENTED = (501, 'Not Implemented', 'Server does not support this operation')2BAD_GATEWAY = (502, 'Bad GatewayYInvalid responses from another sxc/proxy^SERVICE_UNAVAILABLEf13, ice Unavailablen3TheS@ canprocess the request due to a high load{_TIMEOUTwC4, ' Timeoutsg{1didEreceive a timelyo HTTP_VERSION_NOT_SUPPORTEDz@5, '$ Version S Ctfulfillg)VARIANT_ALSO_NEGOTIATES = 506, 'Variant Also Negotiates'INSUFFICIENT_STORAG 507, 'Insufficient Storage7LOOP_DETEC508, 'Loop Detec`aEXTEND`510, 'ExtendedPNETWORK_AUTHENTICAT5aREQUIR:G(511Network Authenticz Requir=5!clQneeds7,cgain nT acSp') r"""S/1.1 Clibrary <, too> E`Connecg.through a number of "st", which define when a may legally makemor fetch for a particular /0. Tdiagram detailQ1se p transi1s: R(null.1 |J | (!v!AIdle 23put .est-started90( pader() )* endhesK4entH/\_ &?T| get() raises<+ =(O&| SError7vJuUnread-a 0i#[R--8]k| T|.R!()|    *-u 4/ / | P/ &Req-sent2  |h.read()  /v Request-sent This diagram pres the following rules: -- a second rG" may not be started until {response-headers-read}G [object] canIxretrievKBthere is no differentiation between an unv nbody and a#partially ( Note: t$enforcementvapplied by-HTTPConnecclass. Thef R @ doe#t Zgstate machine, whichD imss sophisticamqclientspaccelerB/Hpipeline. Cau`shouldtaken, though: QSsI0bey above patterny knowledge of)tserver'Cc4 -close behavior for certainls. For example, it is impossible to tell whe%wb will i~IQUNTIL14 @ have2ad;@mean.`at furnI{splaced in4he /iW0Tn tha40NOT. Logical SH!__4 __( -$  --- Idle_CS_IDLEUNone = 7REQ_STARTED 7 73ENT7U-7 <,_>--^ OC C?ent@5 C CP""" rt email.parsertmessageDhttp $io r dsocketBcolls.abc from urllibmu rtsplit #Mv!, _B1(),y/tus code constaPare #&!on@omitsYicity __all__ = ["Ra1", #",PExcep.3Not- ed!UnProtocol?TransferEncoding9&edFileMode?@IncoQteReaoInvalidURLDImproper1ionF "CannotSendRequest", "CannotSendHeaderResponseNotReady", "BadStatusLine0pTooLongRemoteDisconnected[errorJris"] HTTP_PORT = 80S443 _UNKNOWN = ' S' # gion states _CS_IDLE*QIdle'REQ_STARTED-started$ EN'!Pent' j0hack to maintain backwards compatibility globals().update(http.:.__members__)Zanother b# Mappingu0desofficial W3C names h = {v: v.phrase for v in .values()}maximal line length when call@read(). _MAXLINQ65536HEADERS = 100Sy/la ABNF 4&://tools.ietf.org/html/rfc7230#section-3.2) # # VCHAR= %x21-7E # obs-text80-FF # h-field = -= ":" OWSSOWS #%Tu= token+O#*(-content /efold )1vchar [ 1*( SP / HTAB )L]?perLCRLF\" #;RoleteC?ing)Rsee S` 3.2.4OP= 1*t "!" / "#$%&'.*"~A/ "+-.^_`|~ADIGIT / ALPHAbR; anya, except delimitersxtdefinedW5234#appendix-B.10he patternsAbothR and Vqare moriQthan RFC # iRallowI_is_legal__P= re.ile(rb'[^:\s]r\n]*').fullmatch B)ilD E\n(?![ \t])|\r \n])').search`These % ac\ Anot ed within P@ URL00hs.1SeesvG398693W0the?; 0A pqPrevents CVE-2019-9740. Inclu8rolsuch as \r\nEWe don't restrict-s above \x7f.Bputr1() 1s uASCII. _kains_disallowed_uLrl_pchar_re = re.compile('[\x00-\x20\x7f]') # Arguably only these _should_ allowed: # _is_$_udser"^[/!$&'()*+,;=:@%a-zA-Z0-9._~-]+$"xWe are more lenient for assumed real world atibility purposes. # TaactersTCnot  within HTTP method names # to prevyhttp header injection. _contains_disR_Fc 1_0 # lways set` Content-Lengthw~as because some # servwill otherwise respond! 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) is rvalid L(. Use %se('utf-8') "if you wantsend it vd in UTF-8." %(.title(),X[: Bend])) from None class+Mt(email. P# XXX:u of thiskQis in # d.@.CGIRequestHandler. Mayb!ve* rG@that doesn't need!rbe parte public API. sAPI hasFnever been defined soc {backwardsEAissu@getallmatchingPcs(selfpp"""Finddlines > a given zoLook through#A lisvd and fb[M4 (9`their @inua  CU). Ak2the" iX1ed,out interpretI@. I%e'occur, a1LRemptyo4is Z B9s multiple times,[#Rrence#LDCase`imports!inV.}! =<.-r() + ':'|0n =)lst = [] hi0uCc.keys(}z!if[:n].lower() == name: yhit = 1 elif not line[:1].isspace()A0Anif hit,lst.append([)5%return lst def parse_headers(fp, _class=HTTPMessage@"""P.s only RFC2822 < from a file pointer. xaemail <r wants to see strings rather than bytes.9But a TextIOWrr around self.rmwould buffCroo manyGF!thnBeam, which we later needrread as% So'Grcorrect"e here,1h, for "toi1""";A= [] wh>7Tru@` = fp.(_MAXLINE + 1bif len4 > % raise LineTooLong(""NsFk$)nHEADERSqNException("got more$%dE1" %Jqine in (b'\r\n', b''rQbreakQhb = b''.join(.decode('iso-8859-1'q$.!"r.()Cstr(hA) ? Response(io.BpedIOBasRP# SeeJ 2616 sec 19.6 andA19456XsdetailsFS# Theocket objFare o|32.2notes an epMIME-en8dtext followingb2047. asic statusb)DC acs__init__(, sock, debuglevel=0, method=None, url P# If rp includ content-length,Z# make sutSclient doesn't 7the?specified number of . iG, it will block untilF@serv`imes o&nd closesPonnecl!isQEhMbn if aK_() is done (with\ size) wheF0.fp3Ped or. So, n6lf.^'by@=qs unlesy know wha_ y Rdoingv= .G("rb&(' =5%_@# =IjbY2is &ed via urllib. The clients )# of http and urllib expect different attributes for theAheaders. is used hereXsupportsa. msg iprovided as a backwards compatibility layer%. Tself.!= vf= None(`# from Status-Linethe responsH version = _UNKNOWN # HTTP-V sX.$ #m;Cod]Jreas\A # Rg-Phrasychunked`Cis "!q" being?"]_leftF@# byto read in cur; NmlengthJ# number`X/injwill_closeOp# conn " "`at end[Pdef __(7!):lQ= str@.fp..(_MAXLINE + 1), "iso-8859-1")Apif len(1D) > 4bf`raise ]TooLong(" 8 N.debuglevel > 0Mprint("reply:", repr 1not^ =# Presumably,bserverGd\0ectVbefor`# sendMua valid.(RemoteDisUBed("drwithout"LP"}E:try", u3hp.split(6, 2Dexcept ValueErrorU f j! = b1b2" ;# empty yause next test to fail>6'= z0if <p.starts ("'/"?E_(2Badc3TheP codeGa three-digit; }0 =  $ifa< 100 orZ> 999 Adreturn  Qbegin{!is # we've already started ing the response ureturn #3 until we get a non-100Cwhile True:C^version,@tus,Vson = self.__status():#if4 != CONTINUE]aYbreak9a# skipheader fromFN0fp.line(_MAXLINE + 16pif len(=D) > --raise LineTooLong("j"^W! =k.strip=Uaif not$v;7debuglevel > 0BTprint1:",m)EI@code)2rea 3if O in ("HTTP/1.0", Z0.9")# Some ser; might still  "6 , treat it as 1.0 anywayGi%10&el.sUswith J1 # use !1 64forx where x>=1xspJUnknownProtocol( dsmsg = parse_('fp:.  hdr, valFS{.items(` Nphdr + "Y7valP# are$uschunked-style of transfer encoding?7dtr_encTget("6-6}iU:Band E.lower() == ""! =$ _left = Non,el1ed = Falset0# wpconnectclose at1end"%he^C_4b_check( do hav Content-LengthV# NOTE: RFC 2616, S4.4, #3 saysBignore this k&isX7lc /$ c#  5 :tryC =  except ValueErrorI h lf.length < 0: # ignore nonsensical negative lengths Rself.!u = None'Uelse:<- # does the body have a fixed? (of zero)7 if (status == NO_CONTENT or T_MODIFIED or>d100 <=-P< 200= # 1xx codep_methodx"HEAD") %0 vA# if%connection remains open, and we aren't using chunkedKa content-was not provid1then assume that|MWILL close.bPQwill_!$-$ !A!is,2cb= True9def _check(O@L0 = .headers.get("e"7*@versZ== 11# An HTTP/1.1NSxy isH@d to3yj unles## explicitlySdT0 ifn'! "SA" inw.lower(1breturnCFals0d# Some0 implementatsdsupport for psN#A#s,rules differenQa,.For older, Keep-AlWindicateswm./ifkIaI x At least Akamai (es a "C:"" I, `which d8!se @be s"by\Ylient  fProxy- netscape hack{pypG 8"otherwise,?@ it _@ _ $fp%fpE 1fp.e"()P1k:try 0sup?c # setud" flag}kfinallA*fpY"}.}# These1are(enefit of io.Bu!dR# XXX This class should probably be@ revised to act more like # the "raw stream" that BufferedReader expects. 5def flush(self):Jsuper().)0if *6.fp,0eelf.fp01^readablea """Always returns True""":S# End ofrmethods#risclosedrc1 if*connection is 3.# NOTE: it!possibleUwe will not ever callJ(). This# case occurs whenG_4fTRUE, lengthNone, and wGL[0 uplast byte, but p6it. IMPLIES:`FALSE,&n ALWAYS blled, meaning?)6ful[&`, amt=: ^2b""RE4_@ == "HEAD";_2( FZ!am4 Sq# Amoun"given, implement us6Eintol1b =array(amt2n =n=*(b!memoryview(b)[:n].to6sOelse (unbounded v) so we must check #^vchunked !B_}Call_./()M$TsC0fp.S>tryNQ_safe. 1except IncooteRead\oNFrais4I = 0 Y2#iything;|.7, b0"""alen(b) s 2 ! b*]enumber{!of-H&adR$N/fp^022X =to_chunked(bC)  if self.length is not None:$+if len(b) >1 %)# clip the read to "end of response"^9b = memoryview(b)[0:]q# we douse _safe_n() here beca this may be a .will_close~# connection, and@user T`ing moUytes than ITprovidedO(for example,Ain 1k chunks).2n =M2fp.kFto(b !ifnbl# Ideally,would raise Inco~0teR!ifcontent-z# wasn't satisfied, but it might break Vatibility.BZ_P(/elcEY -= nb $ return nEAdef 0a_next_`_size(C)Z!# C* *Q fromY6filOKline(_MAXLINE + 1U"X%LineTooLong(""M0 = J.find(b";f i >= 0[/6[:i] # strip-extensions:tryBX@int(MF, 16except ValueError<*1oseE5 as protocol synchroniFon i#*bably lost. V and_discard_trailer* *4 upCRLF terminator0### e: shwhave anyJ%s!2while Trumhl) pvV.  # a vanishingly small number  siREOF withouB@sendB" in (b'\r\n', b''@DE$geOleftRg_(Ra newJ %wecessar9#8 =1 at,rcurrent+Q, neeS& i1 MD No Achunk, should read next. 0# This function returns non-zero or None if the last chunk has F` # bee>&ad\'_left = self.Sif noS,: # Can be 0~.p"if. it:'+# We are atSend o?, discardNM end@`_safe_<(2) # tossOKCRLF[$ L>try'e__isize()Kexcept ValueErrorY raise IncompleteRead(b''I GN== 0J#: 1*("0") [2p-extens6 ]  ?:S_and_p_trailer1B# weeverything; closeqo"file"h'__connZP E # )r Adef 2all0ed(Q)Pgasserted != _UNKNOWNHvU = [] ;while True`<rB_get /isK_Ubreakb.appen.2):&I = 0^rb''.join(jG    P)Binto3?, b total_bytesmvb = memoryview(by}(if len(mvb) <= /nSm@ 1!PO - n5N + nStemp_Fvb[:[~D2Y.n:PV? +=0ncompleteRead(bytes(b[0:total_])) def _safe_read(self, amt):#"""Read the number of G requested.O0This function should be used when B"!""present for~qing. Ifxare truly not available (due to EOF),0nMIncompleteQexcep0canto detect; problem.D5""" pdata = 6@.fp.(=!pif len((0) a buffer.Qamt =bn?( Oif nr(b[:n])njn1Jn=-1 with at most one underlysystem call. \bat lea)m3 isCed, that instead$ifAN"or_method == "HEAD"bhMchunked0#1_((BC`length:Pand (0 or n >*X*Presul# 1r)tn:_close_conn(/elE" -rMQOpeekPP# Hav5t enjs IOBase`line()x0 mo0hanu"#ea time fp*Q)0fp.'l"z, limitW# Fallback}` whichw!s ) v[fuper()9_!is}Y(/1 < G K ">TeOe Vlimit:  self._close_conn() Qelif length is not None:&*%-= len(resultMrreturn  >def _read1_chunked(IF, n)_ # Strictly speaking, _get4_left() may cause more than one _,nP# buttok, sinc/to satisfy the protocol.I|" =# ,"ifI/!is@ or n == 0r'8b''@vp(0 <= n~)>8n =l`# if nnegativew`largern-o20fp.61(n. &ad%x!ot~ aise IncompleteRead(b"";x'Bpeek&:try77kexcept+ O+`b'' # " doesn't worry aboutZ5eof<his allowed to zrequested. Jus VKSentirg , and truncate what we getvh0fp.(S6)[: ]<afileno[/ L%)7getheader:, name, default=NA'''Rs value of F matching *J"*.jI(re are multiple0@!s,MZs*Hcombined into apgle strnseparated by commasjjspaces,nov<cfound,3s **L& i6!0specifiedn, unknown, r$ s http.client.ResponseNot2yJ'+Wm _ R>.t@all() if isinstance(7,/vhasattr'__iter__'NFd;els|)', '.join\s(self): " """Return list of (header, value) tuples.""" if self.*s is None:!( raise ResponseNotReady()%rx(O.items()) +8# We override IOBase.__iter__ so that it doesn't check for closed-ness LDdef ;t)yFDompatibility with old-style urllib r"s.:gLinfoc2'''ms an instanceuthe class mimetools.Message containing\Pmeta-brmation associatedP3URL3PWhen `methodPHTTP,4se are those rUed byx@server at:8retrieved HTML px(includContent-Length and _Type) Fa2E will bepresent if (anow usual)@passack a filCl%in ttPe FTP%al request. A~)$er UMIME type can0gue `local-,Surnedqsra Date re1ingD 's last-modified time, a|0giv?;@ siz+6nd <1 a J@!'s. See alqdescrip!of.w module(5'''vr glhreal URLl`In som1sesS ] _redirects a clito another1 ThVopen() funchandles this transparently, but inGcaller needskQwhich}5wasE!o.'#) A u9bto getiFs2url%Bgetcode g`tatus .Awas ,!or!`is notWs}" 9QConne:_http_vsn = 11_str = '9R/1.1'3_W=PMBdefault_port Q_PORTPauto_Erdebuglevel = 0 @staticmethod def _is_textIO(stream): """Test whether a file-like object is a @ o rbinary J.I return isinstancexa, io.TaBase) 2 get_content_length(body, Get the 1-1 based on>.s%IfNone, we set Cx!-Lxs: 0 forys that expectN a _ (RFC 7230, Section 3.3.2). We also` daM#nym* iaxYbytessand not"if0is p# do anlicit checkX1 here to distinguishDbetween unIbut empty.#if.upper() in _METHODS_EXPECTING_BODYlf0SOelse+if hasattrYg'read'Yf#[  [:try\es it implemenbuffer protocol ( , qarray, ))?mv = memoryview)"@mv.nLsexcept TypeErrorIpass", "k3lenl _init__(self, host, port=(, timeout=socket._GLOBAL_DEFAULT_TIMEOUT,esource_addressNblocksize=8192~.l$ =vV R: =  -j5 = #! ={ _K= []_response9__CS_IDLE?-<ptunnel_! ! headers = {}>.^!, OH)FPelf._( 5_validateT(`# Thisstored as} variablallow unip# testspreplacewith a suit<kmockup^0creCconn$ Bset_|Q"""Set up6 ]port for HTTP CONNECT tunnelling. In a connection that uses HTTP <ing, the host passed toQconstructor isKd as a proxy servergrelays all communicaoOnxendpoinrR`set_`. This done bbnding anJsrequest 0wheeis established;v method must be called beforeOhas been] e headers argument shoul^p a mappof extrai3uto sendeAwith ."6"""if self.sock:#3raise RuntimeError("Can't set upfH for7&")he_U,xcport =1get$(- )$if3 fU=,?Oelse9s.clear(Ydef _m,!!, S!if;Nonl1i =6.rfind(':'yj 0]')# ipv6 addreshave [...])if i > j>trya = intsj[i+1:]'except ValuN2ostF == "": # http://foo.com:/ /rw.default_1GInvalidURL("nonnumeric: '%s'" % :[:i<B and 0](6'['"-1.]'V1:-1]qreturn jdebuglevel(i!, )e.&" ="F?8zT = b"Q%s:%d/1.0\r\nr(pT.encode("ascii")I&3= [ 0, v3 inp_s.items(Dappend(f"{A}: {O}latin-1").C!b"2 P# Maka single!()} instead of one per line encourages +# the host OS to use a more optimal packet size instead ofCpotentially emitting a series of smalH%s.: self.send(b"".join(headers))%Cdel  response = Eq_class(sock, method=_ \(version, code-ssage) = R._read_status()!if5 != http.HTTPS&E.OK:h}fclose(|raise OSError(f"Tunnel connection failed: {Q} {me.strip()}"Qwhile True~0fp.(_MAXLINE + 1Jpif len(&D) > ) [)LineTooLong("t-aif notJ# for sites which EOF without (X trrc]Ybreakin (b'\r\n', b'.')D Edebuglevel > 0;rprint('1:',0.de#(): de7B"""Cand port specified in __init__."""_create_Q(-2.,<h"),Sstimeoutsource_address+7s@.set@opt(et.IPPROTO_TCP, TCP_NODELAY,s"ifw!_t_ dkOY MZ>verB_\_CS_IDLE;try4ockn*_:ock2./y = None6!Cock.2Q # it manui0...re may be other ref0fin+ $__ %if @9Y=}j, data`Send `'0ser```` can a ng object, a byHvn array!Lfile-like that supAs a /#()K, or an iterabl6]-!is P"auto_openo B;els1 NotConnectecd() if self.debuglevel > 0: ' print("send:", repr(data))'if hasatt, "read") Jn r`Ing a Nv()able"u*encode =_is_textIO+3if .2and0 37ing file us iso-8859-1 wh%1M3block = .~Jsize6aif not1&X&Ybreak5T .?e("ZPsock.1allpA ereturn:tryIDexcept TypeError>if isinstance, collections.abc.Iter9);for d in^#!Nelse;Vraise ("l should be a bytes-like object "&X"or an i, got %r" % typ)def _output(7, s"""Add a line of * to the current request buffer.7Assumes that2H does *not* end with \\r\\n.&""#._]append(s"_WSOv] Oa@K G;Tru^Ih! =JFB :QyieldmO message_body=None,_chunked=False@"""Sw#ly%edQclear}tAshSextra0+(A @ mayspecified,8V edY0ext(b"", b""umsg = b"\r\n".join#Rdel self._buffser[:] self.send(msg)  if message_body is not None:&E# create a consistent interface toJb<if hasattr(n, 'read'):.2# Let file-like take precedence over byt. ThisFPeededallow the currposition of mmap'edEsAbno account.2chunks = v_Iable);Nelse >try#@this`solelyPcheck Ksee  lA# implementsbuffer API. it /would/ be easierGto capturxPyObject_CBTwas exposeto PythonT!memoryviewF)except TypeErrorAZC:ite ,s*Vraise(("0 shpoas"wO !"ozp or an w, got %rH[% typ#Oe=.anxE0can passed directlysocket methodA 2,&Afor *2 in s3!if(G"ifdebuglevel > 0,0print('Zero length} ignored'p7continueif encode_bed and_http_vsn == 11#"edG?ingw] = f'{len():X}\r\n'.('ascii') +U/ \LA+ b'< "Ae )R# end_ransf0b'0'?def putrequest(,,, url, skip_host=False," $ ac_<2ing/@"""S#a nrserver. `method'! specifies an HTTP request method, e.g. 'GET'. W`url'<the object beingEe@/index.htmlH0skip_host' if True does not add automatically a 'Host:' header ! `Haccept_encodingSnQ 'AC#-ECjE""" 2#a prior response has been completthen forget about itOif self.__E= 0Zeab'[' +?o+ b']'g# =:default_mt host_enc = h ost_enc.decode("ascii") self.putheader('Host', "%s:%s" % (hS, port)) L# note: we are assuming that clients will( attempt to set theseOs since *this* library must deal withFDconsequences. C also means@when@@ sup?ingKz1iespupdatedrecognize other forms,SX/isN should be changed (removed or c,).n we only want a Content-Encodxof "identity"?we don't# e<s such as x-gzipx-deflate.=!ifskip_accepu:) cA1D', ''^rwe can e "chunked" TransferGs, but no zPNOTE:2TE ]P impl*Q*\ # TEpif TE iLp_0d i eu"it`appear#avsnection:  3Con0(TEJelse# For HTTP/1.0r serverse "not "Bpass@def rPode_ro0st(4#, ){r# ASCII helps prevent CVE-2019-9740dreturnK.1e('@valis_method C"""V*2 a P nameC put6.""#ChttpB inj match = _contains_disallowed_pchar_re.search(1if G5Craise ValueError(t"f"N23't 0rolhracters. {*F!r} Hf"(found at least {.group()!r})" Cpath?url|?urlt P m=urlj7g !InMURL(f"URLO?urlLPU'U VValidate a h ost so it doesn't containrol characters."""  # Prevent CVE-2019-18348."match = _Rs_disallowed_url_p[_re.search(host)?1if B:z raise InvalidURL(f"URL ca {^F!r} P f"(found at least {.group()!r})") def putheader(self, , *values)P"""SeY request, line to the server.`For example: h.o'Accept', 'text/html'?0if .__state != _CS_REQ_STARTEDte`CannotH"if hasattr('encode'*# =.&('ascii'Snot _is_legal_:S_namee [VhsError('l ;s %r' % B',)r = list(Afor i, one_ in enumerate. 87/, Yfs[i] =i#wlatin-14elif isinstance(j;int#1e6str1)j 8!if)ilN?[i]pC  = b'\r\n\t'.joinw#] + b': ' + Wcoutput 2endIsmessage_body=None, *, _chunked=False"""IndicaAthatlA]has been s;This method)!dsM7 6 The optional Pargumqcan be usedrdpass a4  associated withzHf =f ,5ENTqJelsed^WSsend_  a, url,(@s={}$ ^4`P a co%te h+s) def _send._request(self, method, url, body, headers, encode_chunked): # Honor explicitly Ved Host: and Accept-EGDing:Z.Ik_names = frozenset(k.lower() for k in=)=@skip6%{}if 'host'1]: ['_/Y] = 1Fa?ingQ:_:\]wC.put1( **5s) /## ing will happen if HTTP/1.1 is used{geitherFthe caller passesP=True or )followingAconditions holdQ# 1. content-length has not been&7setS!2.nvQa filiterable, butIPa strbytes-likeI3. Transfern?NOT1 byzm? '~~Mb# onlyB1setbackwards# compatibility, assumpclient &lready handl$ Net%<# @ canbe automatiNy determined, fallM2 to3"ed +v = Fals#_}!= dZ_get_(kID$ifKvis None'#if)1"ifdebuglevel > 0Y0print('Un 1\ size of %r' %C F *<2put-('YC', ''u?els/ YC3L3 ',()`X 9hdr, values.items(:if isinstanceL;strI# RFC 2616 Sec2 3.7.1 says that text defaulta#@char<ozo-8859-1?-2 = p' self.endhea ders(body, encode_chunked=) def getresponse(self):"""Get the #Q fromrserver.I.!IfHTTPConnection is in correct state, returns anpinstance of GR0 orwhatever objI#isEUed byF_class variable a request has not been sentrif a previouj$,k4 handled, NotReadyraised. AWindicates thascEshould be closj7the8ft will q beforewct@When o(ish underlying socket.?6""" ## =6ior;fbtcomplet forget about itU0if 5.__ 0R=VZ,K,k rmethod= tOelse%L Y:tryY v.begin(except ConnectionError: self.close()Yraiseassert response.will_? != _UNKNOWN3b__state = _CS_IDLE %/ifT# this effectively ps the connQon to m Oelsexremember, so we can tell when it is complet8s$__% = freturn<jexceptMB try5import ssl L! IM class HTTPSC\()] "T5Qallowmunication via SSL."default_=lV_PORT## XXX Should key_file and cert be deprecated in favour ofVtext?Qdef __init__( , host, e=None,hj P timeout=socket._GLOBAL_DEFAULT_TIMEOUT,=source_addressg4 *,;`check_Bname* blocksize=8192Qsuper , %).R,T B! Eif (pis not 7 or% L: OO FUwarningsU. $(", m are "Lp", use a custom3 instead."t D;BionW:, 2b.% =  %+& = 'i]D0con =._create_.chttps_$ B # enable PHA for TLS 1.3#s if avail) B.post_handshake_auth@=Z= Tru!I`verify7.P_mode`ssl.CERT_NONE Bis None:   check_hostname = context. 2Z if  and not will_verify:3?raise ValueError("Fneeds a SSL} with "LP "either CERT_OPTIONAL oREQUIRED")Jif key_file+Acert Qload_(achain( @,J c # '%@key / means the user wants to authenticate.Jenable TLS 1.3 PHA implicitly even for customFsJpost_handshake_1 isNNone =i= Truecself._5f $  S b K j0defPnect(C)@"Con  on a gi[(SSL) port."Ssuper().c?*()0if m._tunnelq yEQerver 50?elssF ]csock =`.wrap_e%. ,| =&__all__.append("HTTPSion") class Exception( Q# Sub)e[at define an __init__ must call ?.# 9"args. O`wise, str()R fail^Dpass3Not9ed(-InvalidURL+UnknownProtocol0, version|$ =4 TransferEncoding UnementedFileMode6IncompleteReaLpartial, expected=-3 = Y% =d!arepr__~u<', %i moreb2' %Bs C'!return '%s(%i bytes read%s)' % (self.__class__.__name__, 2lenEpartial), e)>__str__ = object.! n ImproperConnectionState(HTTPExcep!):LDpass8CannotSendRequest(J< oHeader;ResponseNotReady;0Bad_usLindef __init__Oc, lineaif not( = repr( }aargs =8-[TooLongH_typ ."got more than %dAwhenqing %s" % (_MAXLINE3)RemoteDiscf6ed(pResetError, x*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 attribu ofsystem a--/,Binguish them cleavPython 4@. C diagram$trt BSDDB1JaraMSIE* `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'okieJar', 'LWPCookieJar', 'LoadErro vMozilla!] import os Dcopy datetimer urllib.parse, trequest:threading as _http.client # only for the default HTTP from calendar gm debug = False Nset to TruePenablW@bugg1viai"lopmodule er = NoneX1f _](*args): if not areturn!rglobal N341ing*K ing.getLogger("7Qjar")5|q. DEFAULT_M_PORT = str(J.) MISSING_FILENAME_TEX3("a filename wassupplied (norn! " "instance initialised with one)") warn_unhandled_exception(# There a few catch-all -: statements in this ,s#7input that's bad4unexpectays. Warn 3anyAnAionsPcaughHAere.#@io, ings, traceback#f = io.StringIO($`.print(2, f! msf)Svalue8f. < bug!\n%s" % msg,'cklevel=2) # Date/g conversion # -9 EPOCH_YEAR = 1970 def _xSgm(ttyear, month, mday, houin, sec = tt[:6]KPif ((4F >= c) and (1 <=L )120day!31N (0t!24 0min(59c<= 61)F`Felse$ DAYS = ["Mon", "Tue0Wed0Thu0Fri1Satun"] MONTH;!Ja;0Feb0Mar!Ap0MayQJun",` "Jul0Aug0Sep!Oca0Nov5DechP_LOWE0[] <": '.append(%.lower()2isoz(t=<A"""Rd arepresent 7oseconds si]epoch, t. !If@funcE0 isVlithout an argu., it will use8qcurrentKpV0TheIRmat oa$edis like "YYYY-MM-DD hh:mm:ssZw 0Unipal Time (UTC, aka GMT). An example of this format is: 1994-11-24 08:49:37Z1""""0if 0a None:8dt = datetime. utcnow()(?els2@fromGrstamp(t=return "%04d-%02 :aZ" % (m.year, dt.month 1day3houQinutesecond) def 2netscape(t=)B"""Ra string represent ;B in Ps since epoch, t.RI2e function is called without an argument, it will use the currentpV4The1e r$ed`is likEWed, DD-Mon-YYYY HH:MM:SS GMTu!s,@-%s-   DAYS[dt.weekday()]QMONTHA-1],O =+  UTC_ZONES = {"GMT":h, "UTC  Z p} TIME?_RE = re.compile(r"^([-+])?(\d\d?): P)?$",)aASCII)poffset_;B_tz_3(tz! =z.0+ Gm = p.searchk-@Fif mNR3600 * int(m.group(2)(>3K <+ 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?#dahQhQMBiBDBsec)Eif yr < 1000:# # find "obvious" yearcur_yr = time.local (.e())[0]0Cm = 4U% 100vtmp = yZVDyr +05- m.Gum - tmpif abs(m) > 50:if m > 0: W~$Felse -E# convert UTC tuple to seconds since epoch (not'zone-adjusted)LPt = _gm((yr, mon, day, h0in,Tq, tz)) 3if t is VFNone"# ]ma using x string,0getQolute!dhzi 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` valuean integer!0ed whe format0str!unrecognized, this outside(ble range, or4YH[P. If+O@taintB,is assumedT#;Fmay be numerical (like "-0800""+0100") aR3{, "GMT", "BST?EST"). Currently, onlyGs equivalentS(zeroP) 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 makeZclosest current 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`"zero ddian", i.e.3 t@)?$"^`re.X | ASCII) def iso=)r AspQ http$, but parses t$he ISO 8601 formats: 1994-02-03 14:15:29 -0100,--74/-- zone is optional5( -- only date.T2-- Use T as separator70203T141529Z3 scompact  <+  /1"""# clean upptext = .lstrip()j@# tzBtime#specifier )!ngA day, mon, yr, hr, min, sec,A= [None]*7Vloose regexp parsB0m =_DATE_RE.search()i@if m@not S:# XXX there's an extra bit of I'm ignoring 1G: isIa this4Prightng to do?( , _ = m.groups(Felseareturnt # baddP_str2(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"""Pa   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  ca, but we relaxM thQquire3for) Ms2= #D"1= ( |ameter) *( [";"]en | parametqer)) Qtoken = 1*AA"(" | ")<>#@"6,A| ",$;:\$<"l. @| "/$!"[]?=l {$}tSP | HTquoted-stringh= ( <"> *(qdtext | %apair ))#9!= ODTEXTO4<">J01"\"~tRmeter! = attribute "=" value/!=  , Each header is represented by a list of key/[rs. Thea for absimple (not par@a 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(+ # no value, a lone token value = 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 produc3csingleMF. 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 hav use this a parser inNstead of split_header_words. XXX This may not make the best possible effort to parse all&AcrapIthat Netscape Cookie qs contain. Ronald Tschalar's HTTPClientHp_r is probably better, so could do worsan following !ifHtever gives any troubleCurrently, -is also used 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#aW: TheAdoeslstrictly adhere tos}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#0 anhS if Z08_quotes(val,3ITrue#'eleR~#_Svert (A datMseconds si]epochimhttp2time(A) #(9yinvalidvD.append((*1if % ip pairs.append(("version", "0")) result.append(pairs) "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/block8""" if IPV4_RE.search(text): return FalseTrue def user_domain_match(A, BC """For blocking/accepting 21s. VA and B may be host" names or IP addresse73"""?= 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 convenientcarisonV=1url.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!-1I0% 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 i to A-Z, a-z, 0-9, '_', '.',p'-' thaRn't # need to be esc%aped to form a valid HTTP URL (RFCs 2396 and 1738). _PATH_SAFE = "%/;:@&=+$,!~*'()" ESCAPED_CHAR_R% re.compile(r"%([0-9a-fA-F] )") def uppercase_esc_char(match): return "%%%s" % .group(1).B(ND`_path(BA"""E^r any iniacters in ,UR all WQs.""" # There's no knowing what Ta encodRas us}`creatersIpcontain)#%-h, 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 (tVis, 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 doe3"t 9-=-8ONhoriginmoreq_host = request_host(request) if not domain_match!_host, rea1.origin_req1)):CGreturn 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[ ed=cserverBNotetport mayM1e headers, but unspecified ("Port"o#ra!anQ=80",r0exa2 );1acase, ysis None2"""def __init__(self,sion, name, value,LV\_',+|ial_dot?`path, f _securexpiresZdiscardocommenO_url8?res5rfc2109=a7"):Z$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). Need1oM ,!$DK # value.#  self.domain_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 Hvalu^W[SA] = #2is_d,owif now is : p= time.(1if G#.e ais not8[) and <=MiEmATrueVFalseq__str__sE"ifFportep = ""Raelse: 1:"+)0 @limi>rc + p +\5ath,q\rB#= "%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 rulesrNetscapRFC 2965 -- override that if you want a customized policy. """def set_ok(self, cookie, request):'3 Return true if (and only if): should be accepted from serverPCurrently, pre-expiredGs never get this far -- the C5Jarclass deletes suchG itw raise NotImplementedError()'r"B[Ted to rdomain_K Afalss0notSed, givenS Z.} ,V TrueAMpathAX 3rDefaultRP!( 5""""sstandard 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"))"""Construct0rguZ^be passed as keyword a&P,L4 = !$ =G <+  7H8 =  )9 = + #9Gerifiable = strict_ns_unverifiable eself.s$domain = 1set_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:]6TruVFalse QM, orYB6s , G ,ifYQ! w(sis_not_Q#ifB(/is  > s :s #okcookie, ri'stYRIf you override .>ok(), be sure to call this method. If it f), so should]r subclass (assumingPwantsifbe morC about which .accept)._debug(" - checkw= %s=%s",LU.name value) assert cookie.name is not None for n in "version", ifiability@@pathQdomai+eport":OV0fn_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, Zvaluer;`.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)   if ((cookie.version > 0 or % (== 0 and self.strict_ns_set_path)) H2not2$_return_ok^, request)):@_debug(" , attribute %s is `a prefix ofK- "J"GS%s",  9e FalseQTrue @def ok_domain()e`i1lf.is_blockedA   in user DV-list)) not_allow$H(_specifiedDreq_host, erhn = eff_S( U$ = +"" ( .count(".") >= 2(# XXX This should probably be compared with the KonquerB# (kqjar.cppr Mozilla implementations, but it's alosing battle.!Ci = Qrfind &j&j, 0, iksPif 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"sAnon-'contains no embedded dot", }domain)return Falseif cookie.version == 0:$kif (not erhn.endswith(oM and263Rstart5O".")2 eP("."+j)k.))j_debug(" effective request-host %s (even added "P "initial dot) does2endC/%sC#, #ir(m> 0 orG(self.strict_ns_o1 & DRFC2965Match@!if; _m'(s(7^-^x Yi>rS\oNoDots>]_prefix =s_d[:-len!]P(:P.findo) >= 0IPV4_RE.search(reqrq c%s forcontains a 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 .G), be sure to call this method. If it !returns false, so should your subclass (assumingwants toPbe more strict about which cookie. v5). 85""" # Path has already been checked by .path_G_ok(), and 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$ifT2A > 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)  if req_port is None:  "i= "80" for p in cookie.J.split(",")Muif p ==w"uYbreaki?els_debug(" QPuest  %s does not match)",]s,2).return FalseQTrue  de`*_ok_domain(self^,*host, erhn = eff_req_( 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).endkNetscaper l>_1_ok/l# Liberalp. Thishere as an optimizatgto avoid# havingload lotsfiles unless necessary.EiCtq `+M}I "E A2N oSe$"(dotdomain) or erhn.endswith(dotdomain)): #_debug(" request * %s does not match cookie *",LXreq_host,*)&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 and4vu"/") or{[8Clen:0+1]'#Kd< SL->0H vals_sorted_by_key(adictrkeys = !."()X3mapPget, "0) `deepvalues(mappingZ """Iterates over nested &, depth-fir#in@ ordByeA."""b? = Qpfor obj4(# =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.$.build_opener(bProcessor).a(url).@] non_word_re.compile(r"\W"_quote!([\"\\])'rstrict_/\.?[^.]*/( %/tsKb^\.+")>_magic$R#LWP- s-(\d+\.\d+)"c.ASCIIC__init__`olicy=p1 is policy = DefaultCookiePolicy() qself._p2 =  c< s_lock = _threading.RLockO0R = {}Lsdef seti(v,m+):n A_X_for_domainJ , requestS3U = []hpif not .C_return_ok(T;(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 neverNiear...version = cookie.version sif not Y_set: +} = True#$ifCN > 0CGattrs.append("$Vd=%s" %>)) [# quote cookie value ecessary.(for Netscape protocol, which already has any`sG intact, due to the poorly-specifiedcC: syntax)LRif ((.sqNone) and/'self.non_word_re.searchF:4r)so!= 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"ifD $otD.has"Cookie"):  request.add_unredirected_header( . "Cookie", "; ".join(attrs)) 5 # if necessary, advertise that we know RFC 2965<if (self._policy.rfc% and not ahide_c2" K24has]2")):4Bfor T3 in s'_#if .version != 1,0|R, '$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 syT are name, d, standard, rest, whe#&65the}I&LPa dic8ary)t P-ibutes (discPsecurP", smax-age,Idomain, pathQport)  $%ofOU5""",(NV = []boolean_Ss = "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(sprefer )).max_age_set = False  bad_cookie = False  standard = {}Nrestfor k, v in X_attrs[1:]:@flc = 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$max_age_setH# 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.N"( v = self._now + v  if (k in value_attrs) orsboolean:?NCv 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(self, tupSWquest#qvdict ofm-sD(st,&th#BEthem =6domain =b.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 %Jf  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 = "/" _specified = domain is not Absent ,# but first we have to remember whether it starts with a doEdb_initial_dot = Falseh3if &specified: DRbool(.~e("."))>[ [ req_host, erhn = eff_request( T/5rhnnAelifI z$r = "."+  J# 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[!(\~.cookies = []   for tup in cookie_tuples: ! = self._T_from 6(tup, request)B#if`:s.append(M.Tretur!s Fdef _process_rfc2109z s(,V)(as_ns = getattr0._policy, ''etscape', None8if 'As is"m' #S= not1m.!19651} z8.version == 1xKGb109 = Truei" H&# treat fXS as Nrather thankIas RFC29655)& 0KmakeresponselB"""RBsnce of C objects extracted  P E."""#8-@pibutes ARFC 6andprotocolsD`headerjf.info(a1_hd'1.get_all("Set-f2", []:/ns5 42U._now int(time.2())0n*2(QPif (()ZPE) orM2 -B- _3 ad[] # no relevant5 : quick exit6tryN ,mis_set(8bsplit_lx_words(),;except E:ion_warn_unhandled_.7ionyV = []9if j c P#2| u,$ns4?`parse_( ?drs105"9, )[]:Sa# Look <s (from Set- Cookie headers) that match  # corresponding RFC 2965 c@s (from Set-R2S.IFor eachf, keep theT and ignoreNetscapeO% ( section 9.1). Actually,`5109,arMbundled in withx7 for this purpose, which isreasonable 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# DDmakeN():  if self._policy.set_ok(cookie, request): - _debug(" setting 7c: %s", ):tl2p,zfinallyw5_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 KeyErrorno match!h exist5"""!ifq 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 backA9Pserverovided you're uDefaultCP), this m.ethod is called by CookieJar itself every so often, and the .save() mM`won't  expired cS 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, policylYe 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 * =&dbelse: V MISSING_FILENAME_TEXT)   with open(filename) as f: !self._really_load(f, 1, ignore_discardexpires) Ldef revert(O@a=None,$m Tl=FalseZ) """Clear all cookies and refrom a saved.{Raises LoadError (or OS 3) i sion is not successful; theobject's state will0be alteredOthis happens5"""I!ift00if T.&*<=&`Cpelse: ra Value(MISSING_FILENAME_TEXT7w_k_lock.acquire()`Ftry:a7Bold_= 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`"10rjoin_header_words([h]) classJar(FileCookieJar): """The LWPCookieJar saves a sequence of "Set-#3" 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 docsdfor File@Jar.*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"secure1vrmversion",  "port", "pathdomain", . "expires"acommenV eurl") SEtry: hzwhile 1line = f.read )()9$0if  == "": break%1not).startswith(header)yYcontinueMoME[lenF].strip(Hfor data in split_{_words([S]name, valu F=[0]fstandard = {}"Orestkboolean_attrsp[k] = Fals-(X0, v[?1:]Vif k is ONone*\lc = k.lower#?elsIp9D# don't lose case distinction unknown fieldsI`if (lcgD) or ok = lcl R if s : v = Tr+z v"eln [ Dh = oO.get%U = h(Bdisc3h(" "+4if Y-= iso2time(` ' _specifie/".>Cookie(h("version"), "h( ),/"):", 6I?dotJb1athN:osecure,  discard,  h("comment")-?url0_rest)if not ignore_s and c.:9continue! ZsexpiresZ2is_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.Don't expect@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 !us4he jL by default (Mozilla can cope with that). """(magic_re = re.compile("#( Netscape)? HTTP Cookie File")<header =M5\ #2 0 # http://curl.haxx.se/rfc/cV'_spec.html # This is a generated file! Do not edit. def _really_load(self, ilename, ignore_discardexpires):Inow = time."()1- = f.readline( !if{.)_re.search(d0raise LoadError("%r doesWlook like ahrformat Ds%=" %I=6trymzwhile 1 2if ' v: break6"%# last field may be absent, so keep any trailing tabkP.endss("\n"):_[:-1]skip comments and blanWnes XXX what{o$ for?}(.strip().start("#", "$")) or;; =, %continuedomain, 7ified, path, secure, e , `, valu\split("\tZD = ( = "TRUE, 6@!if$#.txt regards 'Set-: foo' aHce#!nor, whereas.85jara!itRK0Rv.," =!<o = Noninitial_dot = /".cassert.;fPt3 = False$ifoK/""e _ = Tr# assumeOis f3c =)(0 ,s,( OB V( r# _,  discard, ONone!+={})aif not ignore_s and c.:5continue RsexpiresR2is_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%= t=False,usw%ifG@ is J 0if n.&0*<=& belse: 0RValue1MISSING_FILENAME_TEXTwith open"w") as fbf.writz.headernow = time. 3for1 in _i',?W1+#if.secure:  = "TRUE"&OFALS'Ydomain.starts("."): initial_dotn +seS!is )b= str(.> !.H "2 v!#s.txt regards 'Set-C`: foo'a+ # k@ no , whereas http.5jara!itRK0R.,mA9# =.- F` >/= ' e P B"\t".join([.,,Opathv S0#, \,2])+ 8 "\n") #### # Copyright 2000 by Timothy O'Malley ; PAll RJs Reserved '0Permission to use, copy, modify, and distribute this software #its documentatKfor any purpose&)without fee is hereby # granted, provided that the abovenotice appear in all #!1iese;BbothE ;n_Eis p= # Xsupportingename of #T0 beRdpdvertisSor publicitppertain&tolH!ofp Dspecific, written # 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: Cookie.py,v 2.29+/08/23 05:28:49 % Exp # G_a Python@ule  Phandlpof HTTPgcUs as 70dic ary. See RFC 2109J!moSr informJ3on I The original ideaStreat rk c@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... >>> q http i'hs Most {time you start;cla2S3C =@s.Si>q() OncI'C edXr,  can add values just@if it were a yC["fig"] = "newton" C["sugarVwafer.output().R'Set-b: fig=JH\r\nN=IB' N5printablYpresentation of a Cookie is the appropriate formatr a Set-+: header. This:default behavioYou can change`; and printed attributes by using+.output() function >>> C = cs.Simple%()"["rocky"] = "road"b["path#/P&$(C"="h1:")j k=fs; Path=Ns MSs=[],W The load() method of extracts from a string. In a CGI script, you would us$isX3to OsR#HTTP_COOKIE environment variable.. "chips=ahoy; vienna=finger"h'>H\r\n L'Fis darn-tootin smart about identifyx withinZEscaped quota marks, nested semicolons,other such trickeries do not conf/itF &'keebler="E=everybody; L=\\"Loves\\"; fudge=\\012;";'N`CUTSR Each ele!ofE) also supports allthe RFC 2109 ). Here's an exa which setsG:b["oreodoublestuffC! ,5U=P!di5ary)has a 'value' ",PgivesQ backT+` assoc d ?keyBtwix1nonlAC["t".u')ZP expeAthat;As shvbe standards. Just to Yure, Rbinvokestr() buil to:Pvert NjHF!enPs are@ O-sty["number:7I2C["wh"sevenJ4L/7'= D$ \,=7=H Finis. """ # # Import our required modules # i$re dstringtypes __all__ = ["CookieError", "BaseTSimpl] _nulljoin = ''. _semispace%; Define an exception visible to Externalbclass $(E:): pass # These quoting routines conform`the RFC2109 specifica, which in # turn references 6character di5as fromQP068. 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. # BecauseT browsers really handle co{s (as opposedAwhat says) we also encode "," and ";".Pare taken*, _LegalChars rahe lissTdon'tq0 "'6#_T"or hash-tafor fast:(# w"= .ascii_lett&+ds + "!#$%&'*+-.^_`|~:" _Unescaped=+ ' ()/<=>?@[]{}' = {n: '\\%03o' % nAn in set(range(256)) -map(ord, 8))}i.update({_ord('"')z6"',#\\\\', }) _is_l _key = re.compile('[%s]+2re.(V)).fullmatch def _ Se(str)r"""Quote ak? Cin a header. I# does not nebe double-m d,QPn jus7I1theJC. Otherwise, surround6#inSRs F("\)&al!s.#1""" ifS@None ^!re1str=Belse_.(`0) +5P _OkJPattr"\\[0-3][0-7A") _.s[\\].")!un"# `re are9any?n#anPre ca)byEB Se(TL1lenM < 2)F7`[0] !=dstr[-1; # We have to assume that we must decodis string. # Down6cwork. PRemov/Ae "sPstr =;d[1:-1])Check for special sequences. Examples:C#q\012 --> \n1" "Qi = 0 n = len(str)res = [] while 0 <= i < nml o_match = _OctalPatt.searchL2, iO,q,_Quote, tif not _1andC:O# Neither !ed 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(return _nulljoin(res) # The _getdate() routine is used set the expiration time incookie's HTTP # header. By default,bs<iurrentPappropriate # "v0es"0mat a Set-Cyp`one opal argum_is an # offfrom now,`secondKRFor eOD, an.of -3600 means "chour # ago". C[ may be a floating point number. # _weekdaynamec'Mon', 'Tue0Wed0Thu0Fri1Satun'] _month@QNone,1'JaT0Feb80Mar!Ap0MayNJun'8 ul0Aug0Sep!Oc~0Nov0Dec6deffuture=0, =%, =)BTmport gm,Qnow =(CyearT, day, hh, mm, ss, wd, y, z =K(A"+ B"%s, %02d %3s %4d : GMT" % \_' (C[wd][ 2], ) class Morsel(dictR"""A to hold ONE (key, value) pairCRIn a }, each such" have sever ttributes, so thiski}Akeepa2 associated wi:th the appropriate key,value pair. This class also includes a coded_v1attribute, which is used to holdLp network representation of~y1"""5# RFC 2109 lists(5se qPs as KSrved:3` path comment domain*pmax-ageQsecur versio'-For historical reasons,"re/rexpiresReis an exteny from Microsofthttponly<B0dicMary provirmappingPlowercase<variant onP left+Qtradi`l9pformatt]<Rright_A = {1b"U" : , "* WPath"=C ?A: "D?xMax-Age ?S y"HttpOnly!3`V@ samesiteAPSameS !} `_flags3'D', 'y'%def __init__(self)7# Set defaultf&._key = kcb= None< Sy!0for<3 in\'.__setitem,:R, "")q@2ert_class___ame__z?js_# Print javascript%""<# type="text/9&">(!-- begin hidingdocument.c = \"%s\";"c// end87 --V/!""!.replace('"', r'\"'! 2D, $Build up our&ul'#result = [0app=6. # First, theT=U pairX4S("%s=." # Now add any defined attributes !ifs is None:!1s = self._reserved#Aitemaorted(&5())%for key, value in # i#ifZ== ""continueV ifY@ notV:m expires" and isinstance(n, int)Uappend("%s=%s" % "[key], _getdatM)#elmax-age'd} comment}?str(?quo#inc^flagspI?str sC J# Return the resultr_semispacejoin(r%!) 'p__class(Q__ = method(types.GenericAlias) # # Pattern ^finding cookie This used to be strict pars* baoqRFC2109 068 # specifications. I have since discoverahat MSIE 3.0x doesn't # followcharacter rules outli1oseofcAs a #K,=;here are less8. # _LegalKeyChars = r"\w\d!#%&'~_`><@,:/\$\*\+\-\.\^\|\)\(\?\}\{\=" BVD"= U+ r'\[\]' _Cm= re.compile(r"""0\s*]@# Op^al whites% at start ofA(?P 4# S5group 'key'o[""" +"""]+? # Any worduat least onfhH)wA# En@ (% ::are mayBbe a.O\s*=Y # Equal Sign2;?val; =2val="(?:[^\\"]|\\.)*">adoubled!ng}|1 A# or,\w{3},\s[\s-]{9,11}d:]{8}\sGMTqal case"ttr |   P# or ![""" + _LegalValueChars + r"""]*$ # Any word or empty stringE)&# End of group 'val':?5 x8optional vGA#\sH`numberqspaces.;(\s+|;|$ing either at >, semicolon,2EOSP""", re.ASCII | qVERBOSEb#8may be removed if safe. # At long last, here is the cookie class. UsBthis'almost just like # us'Qa dicCry. See :module's doc fxample usage. # ua BaseC(O!):H"""A containerFPa setvMorsels.""" 32def_decode(self,T"""real_ , (d =+$ue>qSTRING)[:Called prior totD"'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#J D style a AmentEMgsinstanceBue, Q*w# allowIconstructed7qs (e.g.LpicklingJ Jelses3, cy3_v o4]BZoutput(self, attrs=None, header="Set-Cookie:", sep="\015\012"): """Return a string suitable for HTTP."""1result = []items = sorted(self.5())%Nkey, value in #^.append(*.output(attrsXrsep.join(C!) y__str__ = Fdef __repr__lEl'%s=%s' % ()'<%s: %s>6` __class__.__name__, _space#l)2js_!, KW=None  JavaScriptl.Q_nullr 2loa, rawdataaLoad c7fs from (pNQmably_COOKIE) ork2dictionary. SW V$E 'd'B is equivalent to calling'Bmap(`.__setJd.keys(), d.Lsif isinstance( ,mPparseM4ing/Jelse!# 9update() wouldn't our custom x/Z p3rr[key] =eQ$ 9, patt=_\wPatternPi = 0k # Our startUpoint{n = len(str)6# Length oft5ing1 d_T![]60# Pd (type, :) triplesBmorsel_see}False # A6=5 pair was previously encountered+zTYPE_ATTRIBUTE = 1hpKEYVALU26# We first the whole^ and reject it &t'# syntactiy invalihis helps avoid some  esU inT5ion#eacks).while 0 <= i < nT0# S l!ngaC$qmatch ==. 6, i"'qif not ! j# No mor"Vbreakdkey, value = match.group("key"), wval") 3i =#zend(0) f key[0] == "$":Gif not morsel_seen$(## We ignore attributes which pertain to the cookiekG mechanism as a whole, such"$Version".@See RFC 2965. (Does anyone care?t~continuparsed_items.appF(TYPE_ATTRIBUTE,D1:], value)c1elif.lower() in MO._reservedTxsInvalidV stringmreturn"if is None"_flags59BM, Tr=A?els/# 0 e_unquote(  mYqprKEYVALUuq, self.Qo_decodx! =l ZRR5# T, apply it1M =|# curren{Zafor tptpQ1 Pif tp  %sassert Mv!M[key] =2 AV =\rval, cval`#__set(key, 3 h,S0 class SimpleCC(Bas )1"""& supportsss. When sett|a usingdictionary assignm@nota,Qcalls;pbuiltin ()H@convh@to a ping. VsF received from HTTP are kept1s#deWJp*b )$eD!enD st =4^strval, _quote(strval) """HTTP server classes. Note: Base RequestHandler doesn't implement any )" r*q; see S! AQfor sDations of GET, HEAD and POST, ?CGILCGI script!It, however, op]Fallyp/1.1 persist`connec-As, avcon 0.3_s on / - b ThisfsBs to cgi-binf the os.fork() fun is not presP(e.g. Windows), subprocess.Popen()5#used as a fallback, with slightly altered semanticdn all cases, Z inT1ionynaive --8 's are executaPynchronously. SECURITY WARNING: DON'T USE THIS CODE UNLESS YOU ARE INSIDE A FIREWALL -- it mayj arbitrary Python code or external program  that status-0200lPprior0iona$S, so @ cansend otherY`s such302 (redirect). XXX To do: - log,even later (8apture byte count)2puser-ag"aheaderyresting goodies - Qerrorsto separate fileC # See also: # #]P WorkMoGroup T. Berners-Lee # INTERNET-DRAFTF'#R. T. Fielding # 7 H. Frystyk Nielsen # Expires September 8, 1995>TMarch/.PURL: p://www.duci.edu/pub// / N1andNetwork!R7 0Com~s: 2616et al # Obsolete>?068,@Juneb9 # Category: Standards Track Ofaqs.org/rfcsP.html1LogEs # HPHere'0quo1romANCSAd docs about'Amat.CP| The8as follows. Each linnxP: # | host rfc931 auth [DD/Mon/YYYY:hh:mm:ss] "Y" ddd bbbbC # | hos t: Either the DNS name oIP number of!remote client # | rfc931: Any information returned by identd f]is person,GN@ - oXwise. authuser: If q sent a i\$Qentic,+n pxDD: DayMon: Month (calendar5)&YYYY: Yearhh: hour (24- *machine's timezoneSmm: minutesTss: secondrequest: The first lineSHTTP $2 asG!by- xAddd:status code> server, - if not availablBbbbbMWtotalbBbyte*Rincluding/1.0 header*{+ You can determ file accessed through%. # # (Actuallylatter is only trueyou know configurQ # at was made!) __version__ = "0.6"1all [ /"S{", "Threa" @BaseRHandler",C_Simpl _ "CGI9] import copy @dateemail.utilsFhtml 2tp.p$io mimetype:o posixpath,eselecthr ocket # For gethostbyaddr()$ypurllib.parse+ contextlib from functools $partial Dhttp]SV* # Default error message template DEFAULT_ERROR_MESSAGE""\ <>8Eresponse """ CONTENT_/= 6 class G!(sB.TCP1): ;allow_reuse_ad,dress = 1 # Seems to make sense in testing environment 2def server_bind(self):"""OverridM'astore th name."""=bsocket^Q.TCPSh.o1host, port = ,!adE[:2]- {3q.getfqdn(O)0c class ThreadingHTT(!vMixIn, (1daemon_t(ETrue`@Base3RequestHandlercjStream""):0"""?" r@" hAa base .)The followxplanation of& guyou through3code as well to 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 partPW1. One line identify70typUad path`2. An op`al setRFC-822-style hea030Adata.Q and  arparated by a blankoQfirst hak"rmi <> fwhere &p (case-itive) keyword suchyGET or POST,]>0strOpcontain zr inform1forhoD should bTnP/1.0";1". en@d us"AURL scheme (%xx to signifyJ2 ASCII character with hex$xxspecifica-s cCRLF bcompatibilityowidest rangeclients ammendscs also LF. Similarly, whitespac%he G0is {dbly (amultiple Es between onE4Ptrailv~;qoutput, s tb9Bpairbut most vgrok LFs just fineF!IfI)?Q(i.e.Tsion> is lef+t out) then this is assumed to be an HTTP 0.9 request;/form has no optional headers and data partE the reply consists of just1!. *T*g!of! 1.x protocol againQthreeo"s:D1. One line givingEresponse codemV2. An0setRFC-822-style003. jA,^  are separated by a blank  e i <rstring>/fwhere 5!is>N0 ("Z/1.0" or A1"), m) 3-digit O indicatlsuccess orDpfailureZL,@human-readable * explainp2whaG Umeanshis server*"se qcalls a@func specific.7Gtype (). S+BallySaN SPAM willsThandl(method do_$(IQIf noSsuch "!exL@sendf error toAclient. If it D, 0is ped withargument[hfNote tP name0casnsitive (i.e.&Aspam)differenWE%s)e various:Pdetaictored in instanc/,"- P_addrE IP xb (hostbport);#- a, path<Obroken-downCi%aof email.message.M (or a derived5`class)OtyX0 in:asArfil!a object openh aN poRoned Wo stQinputVtlwb. l0wri* IT IS IMPORTANT TO ADHERE THE PROTOCOL FOR WRITING!1firH`Pten mabg . nfollow 04morsn"thHbactual p(if any;Qs depo\c execu8;Pmost [@s, w1 isreturnedhould be at least o ne header line of the form Content-type: <a>/L .rwp('\r\n1 ($ =XZwordsz$qif len(+f) == 0ra 6P>= 3:`Enough`determprotocolxzHQ1 = I[-1] :try5Vif nostartswith(''0raise ValueEZ j%Dbase4_number 0:'/', 1)[?version_number = base_version_number.split(".") *# RFC 2145 section 3.1 says there can be only one "." andJ - major r minor `s MUSTGtreated asA separate integers;*- HTTP/2.4 is a lower T than!13, which inKp turnHF>O12.3Leading zeroignored by recipients.xsif len(}) != 2:-raise ValueError% K =@ `_[0]),*1]except (oq, Index{)self.send_e(Status.BAD_REQUEST,,"Bad requestt(%r)" % b!reYFalseW$if5k >= (1, 1)protocol?$"_/1.1"close_conn?/= O2, 0L0_VERSION_NOT_SUPPORTED[qInvalid A (%s\@hHG=e if not 2 <=`words)3hQY U Qtsyntax PJlinePcommand, path = H[:2]=) =9=TrunZ'GET'N# %',+1E/0.9Etype2 .<23!, <# Examine headers`look fc& Ct0dir~&vei:try+wK= http.cls.parse_()_rfile@ q_class=HMessageC.`LineTooLong as err HTTPStatus.REQUEST_HEADER_FIELDS_TOO_LARGE, "Line too long"!str(err));return False except http.client.HTTPEion as err:1self.send_error(!C&Too many headers y(conntype = c.get('Connection', ""P4if 9.lower() == 'close'_4Pg = TruvPlif ( Tkeep-alive' andW protocol_vers@>= "so/1.1") a# ExamW$hey look for an Expect dirvU4Q!(e4"100-continue"~ 8request7bif notprhandle_[_100(d^Ndef OS """Decide what to do with"Q*: -!. frIf the B is Ping a<# Ci response, we mustDd|leither=e finalHu beforeF@waitwE body. The defaultto alwaysO . You can behave differently (pvexample#0rejunauthorized s) by overridthis methodYT should  (possibly after .5ing2) o,] se cF5"""Use_only()CONTINUE5P&s({eCone_F(C H@ a single unormally don't need'e @; se1ass__doc__ str0infXp on howU specificFcommands such1GETGPOSTr?try|4rawline = self.rfile.readline(65537) if len(self.raw_request/@) > 2)6:2=/+_ = ''& _version*command"send_error(HTTPStatus.REQUEST_URI_TOO_LONGireturnrif not close_connectITrueVmTparsek.()mQ# An  code has been sent, just exityPmnameUbdo_' +l @qhasattr!, >5 JNOT_IMPLEMENTED,0 "Unsupported method (%r)" %@]= get *(Vwfile.flush() #actuallyd the response = almuy done.e except socket.timeout as e0#a ? or a write -d out. Discary6is gs3log'""RH: %r", erGtdef handle-&A"""H multiple Ys*ecessary."""K &v7_onF"Vwhile R s0OP.,0, mge=None, explain PSend Tlog aqreply. eArguments arP*l:!0an O<3 digits*p: a sim opPal 1 tson phrasS*( HTAB / SP / VCHAR / %x80-FF L1 defaults to short entry matching@OadetailYssageYBlong\Ao~AThiss(so it mu`be calbefore anyvfoutputgenerated), logs,5finNa piece of HTMLZ2@TGuserN try:  shortmsg, longmsg = self.responses[code] 2except KeyError:!Nq'???', -if message is NoneI$= S;explain;=:Plog_e ("E %d,P%s", )=Tsend_(*header('Connection close') [3# M @bodyomitted for cases described in+# - RFC7230: 3.3. 1xx, 204(No Content), 3t ModifiedC1: 6.3.6. 205(ResetC=1if  >= 200 and) not in (HTTPStatus.NO_CONTENT,040_RESET3NOT_MODIFIED)):_# HTML ento prevent Cross Site Scripting attacks# (see bug #1100201Zcc =)1lf.z__format % {V9'"':B': html.escape(, quote=False)['# > > {} .Hp('UTF-8`replacI"r-Type",)[Z_type| Fe-Length', str(len(&))?;'s("ifcommand != 'HEAD' J CLwfile.writem deM1. a="""Add the h 1 tos buffer0log:E.PAlso { two standard``s withH server softwareXqversiont@curr0Gdateg5"""3.log_request( VQ_only& 1('S_string(i:DDate8W_time: ?Sen.&w%_TTP/0.9'zB !if@wself.responses?: message = self.responses[code][0]6OelseL )''7if not hasattr(j, '_headers_buffer')V*.(J = [& .append(("%s %d %s\r\n" %.protocol_version, #, $P)).en(DL'latin-1', 'strict')) /def sendr, keyword, value"""Send a MIME +s to the"s 9A."""cifTquest != 'HTTP/0.9'ih:+ (!jH$if[.lower() == 'connection .Klose)]pc_Qy = TrueBelif Xkeep-aliv]VFalseKJsK;*blank line ending@Ss>- }!b"u)1Tflush6(# ,/ifD@.wfile.write(b"".join4 Z)}alog_rejR2='-', size """Log an accepted >.^This is called by7'(), isinstance( , gStatuse! =.3p('"%s" F5s','+ 8pQ, str)  dDerroformat, *arg5. *dwhen aR@ canube fulfiMU. Bydefault it passes0 onn yArguments are8same as for 6AXXX should godseparate Aha 8Hmessage(self, format, *args): """Log an arbitrary message. &'This is used by all other logging functions. Override?it if you have specific=iwishesp e first argument, FORMAT,aA str}Vor thpa to befped. If& <containsany % escapes requieparameters,Gy should bxed as subsequens (it's just lik:printf!)0cli@ip and curr date/time are prefixed to?eve6"""sys.stderr.write("%s - - [%s] %s\n" %S0(self.address_?(),1 1@log__7%)def versionC] `Return server softw4<@.r6O.7_.r+ ' ' +4sys G , stamp=None80ted $ ay header&ifk(nR! =+.%()email.utils.(->, gmt=True[4mat[ ?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 % 3k-s_(#[0# Essentially static class variablelT# The@" o HTTP protocol we support.p# Set t0to ,@/1.1a enZa automskeepalivR,b?02# MqCdto parse 'r= http. .S # hack to maintain backwards compatibility responses = { v: (v.phrase, v.description)%for v in HTTPStatus.__members__.values(1} class Simple4RequestHandler(Bas1): r2""":o" r<" h= with GET and HEADbmands.@This serves fil rom the current directoryEany of its4sub ies. The MIME type Wis determined bgqcallingop.guess_7() methode s are identical except thae0a omitsnactual contentsu2"""#r_version = rd/" + _!__nPexten,s_map = _encoding_default['.gz': 'applicaSq/gzip',S~<'.Z"octet-stream*y = os.getcwd r.%ufspath(L.uuper().ado_GETP! ar9. `Af = send_heaJif f:tryD@@copyq2(f,Qw)ofinallBf.close()$)}  RCommon cod "ndAaz$er8qReturn bneither a object (which has to be copied!to!`output1 byer unles@comm1waslAmust` Fdll circumstances), or.,KHcaseD@nothB1furSto do5 translate_3. ~ if%p.isdir( o@part4urllib.parse.urlsplitf5qif not <P.endsK('/'b1B# re browser - do0bas @ly wapache does  "self.send_response(HTTPStatus.MOVED_PERMANENTLY) 5new_parts = ( R[0], 1 2] + '/',AM737/4]rurl = urllib.parse.urlunsplit(=header("Location", 8?url6%5.s(#return Nonefor index in " w.html",)":4* = os.path.join( ,O%if-qexists(D)\`K" =L }!YbreakNelseMYlist_directoryctype = *`guess_ &# check 8 trailing "/" which should u404. See Issue17324# The testLhis was added_httpserver.py<However, some OS platforms accept a `Slash [ filenam# discussion on python-dev and34711 regarding,Prejec5 ofmgs with sD0if P.ends*K("/"XerrorNOT_FOUND, "File noRFund"1 :try2f$peF'rb'F!exZ0OSE 9=os.fstat(f.6o()# Use browser cache ifossibl,if ("If-Modified-Since"V4<Wq-Match""inI< ># compare {x@timeG la#m (d im1email.utilrsedate_to_k(R=[ (*Q(Type-0, Ie OverflowBValu''# ignore ill-@ed v5s>pas^if ims.tzinfo is% '# obsolete2mat0no Gzone, cf.D!# ://tools.ietf.org/html/rfc7231#section-7.1/ ims = ims.replace(tzinfo=datetime.zone.utc)H!ifA9O is <:<# compare to UTC@ of last modificaG*_*% =C.@fromostamp(Fafs.st_.,J=  <# remove microseconds, like in If-Med-Since  `O=0) HiD<self.send_response(HTTPStatus.NOT_MODIFIEDDHGheaders(/ f.close& return Nonen*OK}.("Content-type", c4Length", str(fs[6]); ELast -",_x_string(bm7fhjexcept Craisldef list_directory(v, path)M"""Helperproduce a 6E ing (absent index.html).RPvalueX either a file object, orQ (ind$Vng anrror). In Acase, the  s }P, mak&thinterface3same as for oD(5"""~6try?` = os. Adir(<1@ OSE <le ^FOUND["No permission";r1 .sort(key=lambda a: a.lower(er = [] pdisplay = urllib.parse.unquoted.!(s='surrogatepass'nUnicodeDeyX 1.escape(!, f=False<enc = sys.getsystemencod*title = 'Dy listing for %s' % displaypath r.append('')=(>\n?enctitle>%s=sreturn f def translate_(< , D"""T' a /-separated PATHthe local filex syntax.ktComponents that mean special thingsKq systemE(e.g. driveqots) are ignored. (XXX They shouldGprobably be diagnosed.)&""# abandon query Vmeter2! =9.split('?',1)[0]t;ath$#$p# Don'tGget explicitiling slash when normalizing. Issue17324p1tra4_4rstrip().endswith('/') Etry:  path = urllib.parse.unquote(, errors='surrogatepassSexcept UnicodeDeE4iw = posix P.norm (Pwords)ath.split filter(None, DW = self.directory!1for11 ins`if os.C<Pname(_') 7(os.curdir,- )H # Ignore components that are not a simple file/ wJcontinue" =qth.joinRif trailing_slashGe+= '/'_preturn  def copy(^, source, output """Copy all data between two objects.` The SOURCE argument is a0` open qreading>(or anything with a $() method) and the DESTINATION?r@writ]6(or7 r$es @only"so`overri this would be to changblock sizepperhaps, replace newlines by CRLF --te howeversXdefault ser0use%is?bbinarywas well5"""2tshutil.3Oobj(0\guess_type^{ PG#'3 ofA7bPATH (?V)*RRvaluee0str!ofcPform h@/sub,@usabp MIME Content-(w headerkbation lookk's extensionnptw|.'s_map, usaapplicZ/octet-streamLaM; &itxpermissi5(if:Pslow)jq inside(to make Ater Pbase,1ext 0ext (U[ext]P=.lower(mJ , _ = mime!!s."if: turn guess  Zreturn 'application/octet-stream' # Utilities for CGIHTTPRequestHandler def _url_collapse_path(path): o@""" Given a URL $ , remove extra '/'s and '.' elementc_Kany '..' reference%Ds a /dK!. 74ImpSsomething akin to RFC-2396 5.2 step 6parse relativeN!s.NQThe u#y of this funcN is limitedEpis_cgi s!odQhelpsGpprevent security attacksR0s: wreconstituaURL, which will always start with ^I aises: IndexError if too mWQoccur;h@# Query component should not be involved-A_, q5=I`.parti0R('?')ath = urllib!se.unquoteU# Similar_0os.`t.split(@norm7) but specific61URLr# semantics rather than local operaVystem-_#s #'/Ehead!![]xU41 in R[:-1]951if $!==V.pop() #Amore8QpriorP{D$elc|l!l'kqappend(H C"th9Atail s}(;  & Y)'' BFelseC2 ''"if&?'.join((<"))@B = ('/' +#55), A_=2"/"6RbrS+1 nobody = Noneb_uid()"""Internal routineVBget -d's uid/cglobal#ifPi@%6tryimport pwdexcept I+J!-1* F^wd.getpwnam('B')[2^;Key[) = 1 + max(x[2]#xVRall(): Rexecutablq"""TestO"d file.KNos.access, os.X_OK) classRequestHandler(SimpleHTTPRequestHandler): """Co#0te & server with GET, HEAD and POST commands.?1GET%lso support running CGI script49TheL is *only* mented for=2"""z# Determine platform specifics have_fork = hasattr(os, '$')HMake rfile unbuffered -- we need to read one lpthen pask# the rest.a subprocess, soJcan't use cainput.rbufsize = 0pdef do_uq(self):)S" aHr"@ThisWVU3Y 0if t.is_cgi(|2runFelse)send_error(+rStatus.NOT_IMPLEMENTED,,Q"Can g["6qOhead8Version o0nd_'U thatU%"" breturn40.@"""T{rwhetherpath corresponds2aR/Ras Truequpdatescgi_info @PibuteJUtuple"Q(dir,$) .Eires pFalse oGwiseIf any exceptis raised,0allhould assume8.was rejeckas invalidact accordinglyvdefaultWadtests normalized urlbbeginsfW!of`string|directoriek,( next charactera '/' orP0end[)Mcollapsed_t= _url_N=)dir_sep = +A.find('/', 1. whd41> 0n;not>#[:$3] iU  g. #+3if J > 0Rm, tailU,OE+1:]"]vG&= ^ ' I = ['/cgi-bin', '/htbin']  def is_executable(self, path):  """Test whether argument(v is an D file."""@Xretur#(a !opython%! P?y script}head, tail = os.{.splitext -.lower() in (".py", 6w")qrun_cgi 0ESe a CGI`dir, rV = u.cgi_info = dir + '/' +0 1i =.find('/', len(dir)+1)'while i >= 0a@next^GE[:i]5b[i+1:]oDtranslate_3(b5%ifeisdir(FC)'N , .+JelseVbreak # \plicit query string, if present.C, _,+=.partition('?'Cr# dissect the &a afterdirectory name into aN&w# a possible addm!al#, to be storedPATH_INFO=P/ifA=F6[i:Pn<F, ''|! t J !I 5notcexistsK send_error(}HTTPStatus.NOT_FOUND,&"No such (%r)" % ZK8if is3FORBIDDENqa plain4spy4is_ "ifhave_fork orJispy Y) `0 %&*"* B&# Reference: http://hoohoo.ncsa.uiuc.edu/cgi/env.html>PXXX Muof the following could be prepared ahead of time! env = copy.deep (os.environ)(['SERVER_SOFTWARE'] = self.version_string(77NAM3rserver.Z_namelGATEWAY_INTERFAC;'CGI/1.1'-PROTOCOLprotocol_72ORT31tr(KportREQUEST_METHOD= ucommandguqrest = urllib.parse.unquote( YPATH_INFOT?NQenv['"TRANSLATE|translate_path(< _vSCRIPT_Ycript~if query:w+{QUERY_STRING)($REMOTE_ADDR#Pclient_address[0]4authorizationOers.get("""9if  * =+g.splityif len(9j) == 2Z,m base64, binascii$AUTH_TYP ` 0 [0].lower(~"basic"<t z [1].encode(''jA I0.de?[bytesF-.\L E except (w.Error, Uni)!oOpassOelse7 R/':7aEW2USEW ~Gc# XXX /UIDENT"if_'content-type') is NonvCONTENTL_K_K]WP[0olength)2#y:gth aLENGTH@6referers lmHTTP_REFER+l!acV\Rall('V', ()HTTP_ACCEPT'] = ','.join(accept) ua = self.headers.get('user-agent',eif ua:;B env['HTTP_USER_AGENT'] = ua(co = filter(None,p_all('cookie', [])u_str = ', &co#6if &aCOOKIE-# XXX Other #* #Since we're setting the env in parent, provide emptyCvalues to overr#previouslyU "3Pfor k^('QUERY_STRING REMOTE_HOSTCONTENT_LENGTH',C ", REFERER')M.setdefault(k, "") hFsend_response(KStatus.OK, "Script output follows"Ccflush_(adecoded_query = .replace('+' '1#ifkave_fork# Unix --  as we should9args = [s]if '=' not mI.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 exe@ OSE[FIpassos.dup2(.ono(), K 02ile01os.execve(H] , , 1server.handlesrequestclient_addres1os.'G(127Jelseyd# Non-use subproceGimport subprocess  cmdline = [scriptfile] if self.is_python(*)):+/nterp = sys.executable(1f i+.lower().endswith("w9"]a# On Windows, use 4S, notE wBx# =t[:-5] +:-4:3(>`, '-u'7 jaif '='in query*9.append(&)Gxlog_message("command: %s", subprocess.list2R()Ntbnbytes z(length6except (TypeError, Valu Q0TPopen,*o gstdin=OPIPE8?out9#?err9 env = env ih == "post" and _>> 0Q@datayrb.read(3 mOelseA:Non # throw away additional q[see bug #427345=PwhileAect.select([_sock], [^0)[0]!ifM 9.recv(1BYbreakstdout, stderr = p.ounicate( (qwLbwrite(B %Q@e;T('%s'~ D"p..close(?outPstatup.returncod%R"CGI c exit ]0%#xoj I Yed OK") def _get_best_family(*address@info,`et.get (3Stype=3SOCK_STREAM!Tflags"AI_PASSIVW , L, proto, canonname, _ = next(iter(s} H0test(HandlerClass=BaseHTTPRequestT Serv- Th0ing2*Pcol="/1.0", port=8000, bind=None): """Test the HTTP requhandler class. -This runs an.server on port 8000 (orOargument)C1"""KS9C]address_family,  = _get_best(,i)HFprotocol_version = rWwith w(g(, D) as httpd!Bhostu" =.socket.get name()[:2]g4@url_8p = f'[{ }]' if ':' in Q else 8eprint(K f"2ingp2on O {d"} S/0f"(D://{"}:*f/) .../)l6tryFC!d._forever(/ except KeyboardInterruptD4"\n($ i) received, exiting."_@sys.(0) if __j__ == '__main__'q im  argparse 5r =#.AP%'T.add_('--cgi', action='store_true',4help='RunF3CGIm'g ', '-b', metavar='ADDRESSl mSpecify alternateA_ess ''[default: allofaces] directoryCd', H0=os_cwd()'Eive Yvcurrent6 ! `, type=intnargs='?S rU.Cs ifRs.cgi_` = CGIR8partial(SimpleC =. # ensure dual-stack is nosabled; ref #38907PDualS0er(Threading1ef  r_nW(self#`# supp @EwhenCAIPv43Scontextlib.E!(E;ionh5CsC+op(`et.IPPROTO_IPV6, V6_V6ONLY, 0e4return super().server_bind() test( HandlerClass=h _c,$DServ#DualStack%port=args. { :) # This directory is a Python package. # # XML-RPC CLIENT LIBRARY # $Id$"%an%client interface forVN6the marshalling and response parser code can also be used to # implemcss^Notes: # tpversionadesignF work with 2.1 or newerH0HisJ 1999-01-14 fl Created # 5hanged dateTime to localtime363Added Binary/base64 el, defaultGPRPC2 )icF9FFixed array}aC (from Skip Montanaro'21@pconstrue, etc.A2-022Qing, e empty sequencesD!10Drproblem: s 26-2JSpeed improv<s, pluggablSps/transs (0.9.8 2000-11-28Cpboolean{`check truth value of its argument # 2001-02-2&"encoding/Unid/SafeT patches>compare supswrappers9/1.0b1D1-030Mak8&re[Ptuple a singletonz23-2LDon't requirkparamsVNicholas Riley$6- ol in _xmlrpclib accelerator(2B8UBase < .Error on built-in ExceptPaul PrescodPA9-03fAllow 1subgYoverride get9@Lazyg0orturllib, cgi,D(20x#s%upB10-0qRemove c inmemo cache when doneDthemGUse faster escape method (80% dumps CMore%microtuningfK!imPexpat(0,Guido van Rossumr10 sm @long#s{bs"as ifqy0't Gflow!17MATest`1intHX00 (ason 64-bit systems21-1P`repr()t doublecSFelixA2v"17a void buffered read when po6ssible (from James Rucker) # 2002-04-07 fl Added pythondoc comments *'16*__str__ methods to datetime/binary wrapperCG5-15Cerror constantsAndrew Kuchling26-2Merged with P CVS versionW10-22nbasic authentication (based on code )Phillip Eby}@3-01M!sm( support for the bool type|@3-02gvr Remove apply call3{024 S Use cStringIO if availablP~4-25 ak5nilu6_.gn%.struct_ 2 7-12 gp Correct marshaly of Fault10-31 mvl-@ mulG$llVq4-08-20'Bump minimum&$ed:12.1>14-12-02 ch/dokoworkaroundr gzip bomb vulnerability # # Copyright (c) 1999- by Secret Labs AB.- Fredrik Lundh.[Rinfo@ ware.com # http://www.O # -0 # The XML-RPC client interface isYBy obtaining, usAand/pying this soft i:associated docuT{, you agree that have read, understood, #SP willJ{afollowAerms)Pcondi!s:`Permisluse, copy, modify,5distribut  # its any purposePbout fe hereby granted, provit ab+Qnotic<`ears iaBpies=BbothE="ndp9 # Z4 inH aA!atname of #N ^ or_P be u[in adverti:)apublicC per[!ofsVQspecific, writtePpriorMRSECRET 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 DAMAGES OR ANY #WHATSOEVER RESULTING FROM LOSS OF USE, DATA=PROFITS, # WHETHER IN AN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS #3`, ARISv0OUT@OSRCONNETWITH THEIPERFORMANCE #2THIS SOFTWARE. # -0f """ An XML-RPC client interface for Python. The marshalling and response parser code can also be used to implementmservers. Exported exceptions: Error Base classe%s Protocol6Indicates an HTTP p! 3R Re2 broken ckage 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 aaPuctur8UnmQ$LPincom,`XML evOBmess<PTransg Handltag SafeF B/S Cronstantg(none)1funBgetp0CreiB centhe fastest available& attachuh;object dumpsqpConvert}AarguN# aZGyE (orP, if emethodo1 is). loadr  et"edd0plugname (NoneCnot !).Nort base644sys  j1 imydecimalDFRhttp.gqurllib. C2xml$rsGTexpat2Rerrno+$io"BytesIO try:Rgzip ! I$1 = #python can be built without zlib/gzip support # -02 # Internal stuff def escape(s): s = s.replace("&", "&") < 3lt;hreturnB>"`gt;",),used in User-Agent header sent __version__ = '%d.%d' % sys.info[:2]Oxmlrpc integer limits MAXINT = 2**31-1 MIN-;T02- # Error constants (from Dan Libby's specification at # http://x-epi.sourceforge.net/5s/rfc.fault_codes.phpFRanges of es PARSE_ERROR = -32700 SERVER600 APPLICATION 56SYSTEMS400 TRANSPORT300 # SNOT_WELLFORMED32PUNSUPMuNCODING1 INVALID_ET_CHAR2aXMLRPCpMETHOD_RFOUND!|&60]'bPARAMS] 60]dTERNAL >3C5@xceps ## # Base class for all kindclient-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=P 3=f ,:msgI Crepr ! ()2"<%%s: %s %s>" %#1.____.__name__,  6msg nVP broken XML-]response packep[ is #unmarshalling he XML-RPC response is # malformed. class R aError(): """Indicates a broken r0 package."""/pass ## # 7n XML-RPC fault? This exceptionraised by the unmarshalling layer, if_pcontainau}string.kcan also be upa, to # generate Ko@mess b@parammCode Thecode. # +S-F: d def __init__(self, , **extra.?)M.=X#d %'Creprreturn "<%s %s: %r>" % 1.____.__name__,Q &, o) # -0 # Special valueBackwards compatibility boolean = B UWrapper for\DateTimebpconverttO"at$byMQ

# !be given AdateTrobject,0 in #mat "yyyymmddThh:mm:ss"1q9-item Jtuple (as ! #`.local'()), or an integer 972w<Buses!XC to 2^Ato a,. \k,# n ISO 8601 *:, #j  a . Issue #13305: differentujs across plats _day0 = @(1, Q) if P.strfm('%Y') == '0001':# Mac OS Xe0iso_d1at(_"%Y%m%dT%H:%M:%S") el4# Linux.4"se9.zfill(17) delh1 co6if isinstanceP,$+/ _ if not isinstance(value, (tuple, time.struct_ S)): 1if .V == 0?8%()7 Qlocal!!) 'return "%04d%02T :2" %~[:6] class DateTime4""" wrapper for an ISO 8601 string or 1 or integerq to generate 'ds@.isoR' XML-RPCC. 2"""def __init__(self,X*=0\7str#h?.e" =Fl3els -]_strfymake_comparableHothe~7if , 6 = }Ao = =/elana__format(qln rhasattrr0, "d""2 )"ENotImplementedsHs, ol6[M+e.4,]if o is |KO #B;s <eEtUd=gA}>A}>A/eq|= Ap L, "%Y%m%dT%H:%M:%S"!##`# Get /;K!@d%O, as.str__(self):  return self.value def __repr__(!):3"<%s %r at %#x>" % *.__class__.__name__,`A, id(&))kadecodeg, datao~q = str( w.strip(D'enD7outCout.write("<>")/|="BdnnF)d('ascii')+3" fast expat parser for Python 2.0 and later. def __init__(self, target): cself._O=X=g!.PgCreate(None, )_?tV# =_W.StartElementHandler, .s 2?End06tryKU78 = Dexcept AttributeErrorA&ss0:lse3del[,x# get rid of circular referenceZ4b"", True) # enA _ # -0 # XML-RPC marshall(uncode ##1t@param  Default\8-bit strings. TheV) # value isO (interpreted as UTF-8). # @see dumps class Me"""Generate ans chunk from a[ructure.g' a` instance0each set]aeters,=1use8Qthe " " method to convert your }(represenra tuple /toJPo wri xresponse, pFjead. You may pIuse Bodulfunctionthis purpose'2""";A# byDpway, if don't underEd what's go{on in here,92# tperfectly okD ~=V, allow_none=: memo = {}l _% = :q' =~dispatchr9,sout = [].= out.appI_6Pif is(dsN(ul`#?-C}1("\n"s1({'cCode':.-1S 3}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. /FAtwrite(" I\n") \v in values: A>@#dump(v, + _A("n" and "1" or "0$4" MAXINT< MININTOverflow}@int &eds XML-RPC limitsC") write("str(int($.))=/7!\nA dispatch[int] = dump_long ~# backward compatible)>int42defGdouble(self, x!, !):C3Drepr </6Ffloa/ounicod, escape=nstring885str _bytesjfbase64  enBd = .] W!@d.de:('ascii'~R>f[array%&u"  ci = id>if i in V.memo$raise TypeError("cannot marshal recursive sequencesc>U [i2NonFJ" =x __ j>7ing=name>%s\n") dispatch[datetime] = dump_ ("efinstance(self, value, write):+W # check for special wrappers%"if?.__class__ in WRAPPERSMQn.f" =nGb.encodFdel B:Jelseg# store  attributes as a struct (really?gc='(__dict__'yXDateTy| 'eBinary %# XXX(twouters): using "_arbitrary_0"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__5useE@=Fal0bui5b_types:Dq = None{stack = []_marks411 = Methodnamej$= "utf-8"ABnd =v_. )_k0 =  !1 or$? by<Bk# return (a tuple(0tarmt#ifZ!._sraise RfError(5 P== "fault"DF2(**kR6[0]L.w)2get$@_'>##2` handl`1xmlP3coding, RHalon_? K2# FIXME: assertG == 1 ???xzAtag,s # prepare to handle this element if ':' in tag:Ptag =.split(':')[-1]% if == "array" orzstruct"Sself._marks.append(len(ustack))_data = [wvalue andu0notdispatch~ raise ResponseError("unknow` %r" %M j1= (1= "1") @def v, text)z_ !;%,z9 # call the appropriate eqhandler&ry<@f = X.F[tagGexcept Key  <T _return # B?#t c2 ! fd"".joiv)## accelerator support_RRAtag,$# %Z  w decodershC= {} ef(S_nil OONone0c["nil"] =^ obbooleaZ i%/0GFals(el9199Tru8&sez4TypCbad  ) _< = 6  ?int|%%i1vi/i2 4 8 /ntbiginteger%9odoubleofloat([{}h["float"] = end_double defbigdecimal(self, data):$(.append(D)#)#_value = 0dispatch["aK"] =t ostring1if _encoding! =q.decodeG./ 7  Kname" # struct keys are alwaysJingsQarray cmark = fs.pop(a# map Bs to Python lists*F`stack[E:[]2o *CdictionarieU = {}Uitems4#for i in range(0, len(9G), 2 >c[0[i]: ,+10m@ = [: $TU Vobase64VWgBinary! .Ne("ascii")Lpuse_bytesqK1 = .LRLaVb rdateTim "nD = D&z aOtime_`_type(H =.iso8601 # if we stumble upon a element with no internal##s, treat it as a1" ^7 oparamsapB = "*"a c_faultb) a` _methodNaCr._pp0e = "methodName" # no params dispatch["methodN&] = end_ ## Multicall support # class _QCallMG:]# some lesser magic to store I`s madea^Bs objectBPfor b executiondef __init__(self,R_list, name) 0.__s!& =-N%;! =Biugetattrl&amreturny, "%s.%s" % K)rW*argsp .append(T5)Iterator 2""" es over the results of a mp. ExcepQs areraised in5Aponsxmlrpc faGQ.""" -M k  =WEAugetitemi>1 = "E1[i]~if type('B) =='{}B' F+!['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 = []/m4repVr{"<%s at %#x>P__.__a__, id\())\6f Zmarshalled[7*H ,  6 MC"{' 1' : 2, '4^}HKN!or0..system.R(Z?# -0 # convenience functions FastMarshaller = EPars 8Unm None ## # Create a p0object, and connect it to an uG.ing instance. # This function picks the fastest available XMLl . return A (,fer) tuple. def get%(use_datetime=False, builtin_types): """?C) -> p ,n? of1attach itF4_B. RRboth !s.61"""(if.if"$mk.5 = :'n$mkbytes = base64.decode)#elqTl-w_binarya/seT1 OctargetBs(True, @&, -Eult)iKc(_$(el9 = u:=  h " / ? 6_Expat(", Ionvert a Python or a FaultLXML-RPC packet @Pdumpsams, **opUs) # @paramVams Ad bB@key.methodname If given, cCall requPfor # t" AYrespons]R"]Id with a,fp must bsingleton (that is,"it' contain exactly one element)Pencod3The| *PA str([ Ecd data .-=g", &r_ allow_nonr3 [,] `n argu\D(or 2, i  0 is2d).pIn addi9 foUDPs canas keyword!s:b methodn ame: the method name for aCall packet -presponsArue to create<R!@.@If this option is used with a tuple, must be?$a singleton (i.e. it can contain only one element).encoding  (defaultbUTF-8):All byte strings in@dataucture a`ssumed0use& j. UnicodS=utomaticallyqverted,Cwhere necessaryP2"""Passerinstance(params, (G0, F)), "argu[t2 or$ C"xTif isVN:" A = 1CelifL1O andR)R3lenu) == 1, "J3eif not\= "utf-81FastMarshaller3Jm = (F)*se/G+, allow_none]E= m.dumps%if% !fxmlheader = "='%s'?>\n" %V H!# :,7 # dard XML-RPC wrapp9)o#: +Z (""<@Call 4sName>",R, " unmarshalled data, method name Convert an XML-RPC packet to As plus aGAK (None if not present).blIf the^#re'O fault condition, this funcgPraise,F,Pexcep.1"""p, u = getparser(use_datetime= , builtin_types )U`.feed(Abclose(return u.r, u.getj () ## # Encode a string us@gzip`tent e'such as specified byL #,-SPing: CP # in" HTTP header,Cdescribed!RFC 1952 a@param:!un2C # @ A defw_":40"""0T"ex  ?as ~o7 NotImplementedErrorf = BytesIOAwith.GzipFile(mode="wb", fileobj=f, comslevel=1)e6gzfzgzf.writepJf @valuC/De:Theb# @key=Rmax_dMaximum bWD(20 MiB de) negative #s for unlimit2X;ing"VX!iscorrectly l!d.R51maxped payload length xVeded &, =20971520)0""" E (e r >)2try'if# < 0: # no &[dszf.read!Jelsea7B + 1+Qpt OS2 K<P("invaliL"E q>= 0 an/(7) >c_xvIb_Return a deco|ded file-like object for the gzip encoding # as described in RFC 1952. # # @param response A stream supporting a read() method # @return a Athat@decodata can be Hfrom class GzipD+R(.sFile if$ls): """"o | sqed withdEm,(k.def __init__(self,<.##r doesn'tO tell() and @quired bycAaif not ' raise NotImplementedError;.io = BytesIO(.)+z.mode="rb",~Cobj=[!) BQclose: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/0 #Standard trans Oover HTTP. #

# Youcreate customEs by subLCthis,0 # V ri] selected"$s.3T"""Handles+scaction-12"""U # client identifier (mayP2denfpuser_ag.= "Python-xmlrpc/__version___if true, we'llG>paccept__O!c= TrueK if positive,=eQ us0>'it exceeds dthreshold#!e LRmany s will get confused, so only use it\you knowKFAtheyAsuch *%e_ = None #@= do&9 use_datetime=False,_builtin_typesvZ*, headers=()self._use_datetime = use_datetime `self._builtin_types/  4connection = (None, )(`headerRSlist( &cextra_a = [] H"## Send a complete request, and parse thssponse.7TRetry-0 ifCgached shas dis#ed=C@param host Target % dandler"RPRC h )_body XML-RPC 0verbose Debugging flag%return PDd re4def[(,,,#, k=False):C()#rF@onceKcIgone cold?for i in (0, 1X\6tryi.single_7( ]M except http.client.RemoteDNif iQFraisBcOSError as e;Q or e.errno not.ECONNRESET, ABORTED,Mo <KPIPEj6Q  `t'%l issuej} _v0 = x_.send(! =W@.get(isp.status == 200$ =!_w )**ZFaulto$(E:ion,#All unexpected1ors leav|)in# a strange e, so we clear itV[close=[#We got anG#luard anyQ dataQ &io2get("content-length", ""rW.readaProtocol(W% + Q0 us2 sp^:sonQdict(+:s()v") bCreater~@UA 2-tupl@taina3>an unmarshaller.d def getparser(self): # get parser and unmarshaller&`return+*(use_datetime=S(._,:g'builtin_types? !) E"## Get authorization info from hosCamet0# Hmay be a string, or a (1, x509-dict) tuple; if+xit is checked f@"user:pw@H"Amat,@a "Basic>Authentic" headerRQaddedqppropriate.6c @paradescriptor (URL)I# @AA 3- containing (actual>s, extras#&]c. The$sfields kRNone.0def4_&_~,q"):$cFA= {}if isinstance(Z=WU,k = urllib.p._splitZiO6uthI Cunquote_to_bytes(%)7base64.encode,0.de("utf-8"<q"".join].B()) rid of whitespace}_mYs = [ ("M#",A " +h 3]EJelse% q] )*Connect to server~#0TarZ%cn HTTPM/bobjectmbmake_cm:ion#an exist84possibleis allowsA/1.1 keep-aliv2if >T= ==:[0]x E&[1p# creat`Da@ dc, 7get5D  , http.client.(xCA0leay cached- Usn the eventSsocket errors*a5Qclose+,f^A $(N ,  GD.ASend request.  # # @param host Hdescriptor (URL , x509 info) tuple).Candler Target RPC h(a path relative tor)Brequest_body The XML-H  3debug Enable rging if is true return An HTTPConnection. Xdef send_ra(self,,#, ,i!):@TcU0 = @f.make_(m0theaders-_+=d_extrafxLeQ.set_vlevel(1qilf.accept_gzip_encod:@and X3putw("POST"Sskip_WRV=True}.append(("A#-E@", "&")8Oelse A uContent-Typertext/xmlv 5User-Agent",`user_aIB(#, /c /oo4X#DSendrThis fun provides a useful hook for subclassingz]6}X httpO^list of key,value pairskd0uJ_t val inR!CB.put_(6)~IFe M_&, 0#op Qally Te theF?1if .$_thresholdonot None and262h< len(): M"I n! =e o`Length=tr(2endxst}@ParsTspons]file Stream"@r"Re8e and target method. def parse_response(self, !):(,e# read data from http1R, andT7 it=Check for new3Kobject, otherwise it is a file .Mif hasattr(w'getheader'%ifj.%("Content-Encoding", "") == "gzip"Estream = GzipDecodedR8)3OelseI540u,-pp, u = 2r()~ wh?1"= X.Z(1024aif not >WUbreak"if_verboprint("body:"_0pr()wbp.feed^{!is  fclose(X$p.return u## # Standard transport classXML-RPC over HTTPS. TSafeT3( """Handles an:aaction to_server."""__init__use_datetime=False, builtin_types2*, 'ps=(), csxt=None'super().{au ,cA' >$ =/ # FIXME: mostly untestedMmake_conneTGhostrGelf.)'":[0]b ("1]dF.client, "bC"< ra&NotImplementedError("your versj!ofxe doesn't sups"h# create a6!a descriptor#Pmay bGstring, or a (6, x509-dict) tuple=c Ccextra_ 5_+Q_infoU==,.k(yo,VP, **('{} o proxy. Thisyestablish= virtual/ #? #

#Lclass is ava ilable as ServerProxy and . New code should # use/, to avoid confusion. # # @def*(uri, **options)#param uri TheA0nec point on the s.12key4transport A factory, compati@withG # standard5Zclass^encodingdefault used for 8-bit strings`(.is UTF-8)Z verbose Use a true valueG!en`debugg~`outputA (printed*"dTsee T!  : 0"""p#[,] -> a logicaln XML-RPC DA isU0, given as8scheme://host/target.Simplementa always supxr"http" RQ. IfbSSL socket/s is ava(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!toI" p8rK1use*.2"""e'__init__(self,,e=None,Ib=FalsehaWS_none#_datetimbuiltin_types-L *, headers=()aQntext)Z&# establish a "V">.31getO5urlx p = urllib.parse.urlsplitG)'Rif p. not in (1", 's"oraise OSError("unW%edprotocol"h0.__ = p.netlocoandler"un ["", *p[2:]]b!if JY 3 = YL&if7o: D1$==$ $lhFSafeWextra_kwargs = {"co ":#}&8Oelsen j X 3 = F(use etime,  use_builtin_types=/, ?headers=1**extra_kwargs)aself.__transport =  &encoding = or 'utf-8'.verbose = !allow_non$ wdef __close(,):?.&)9qrequest;, methodname, paramsO# call a& on the remote server[|Y = dumps(O c=4.__4!).@N 'xmlcharrefreplace'Pspons]2(T1&JhostjandlerJ  mif len(ref) == 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-2")(f;d , """A workaroundget special.dibutesSQProxyc\! out interferN#__%__:5""" !ifo"W"8"<(el>SB &Fraise AttruError("0 %r f*P" % (M),)[enh1Cexit-1, *-) # compatibility 2 = O # -0 # test code i`!____main__":# simple4program (fromrXML-RPCXfication8s# local, available ?Lib/xmlrpc/".pzrverProxy("http://localhost:8000") try: print(server.currentTime.getC1())3except Error as vJ"ERROR", vnmulti = MCCallmPlXData(xpow(2,9radd(1,2 for response in W&()'Fr"""XML-RPC S2s. This module can be used to create simple ;mBs by!bing a  and either installfunctions, a classnce, or by extend-Qthe SsbXMLRPC7Q. ItHalsoGhandprequesth a CGI environment usi2CGIbR-HCrqe Doc* !esr a that  pydoc-style docuwadHTTP GET !.  5 s dynamically generated ba0on 6gmethods registered with*A list of possibl age patterns follows: 1. I j#: L/ =5(("0", #))1._MO(powlambda x,y: x+y, 'add'1x_forever() 2%anp": J MyFuncsddef __init__(self|# make all'h6sysp availa:through sys.Q_namex`importj.N=MP! t(1 soHGtem.Bnp# knowsvadvertise4 .-areturn_public_#E + \- ['3' +O 7M!)]N;, x, y): *R* +_x + y0introspe%s(vCnce(Xr!r.3custom dispatchI7athR)@must/@pres?sys+qto workk[uv, 'pow'AHelp, G system.methodHelp # to workif method == 'add':5return "add(2,3) => 5"#*elA?powApow(x, y[, z]GhnumberL*se}# By convention, Uempty# string if no help is available-F"{def _dispatch(self,, params)*={ ,m9S[0] +7[1]G 'raise ValueError('bad ') server = SimpleXMLRPCS(("localhost", 8000))1.register_introspecA_fun /s(*stance(Math(K_forever() 4. Subclass2: G6try:We are forcBthe 'export_' prefix onP`s that1F1calj through XML-RPCrp`nt potal securiproblems\p = getattr+)5except Attribut 3E)Sion('@"%s"9pnot sup^ed' %dl*(QGc AWx + y _5. CGI script:Q2CGIRequestHandlDrE(powh/"_r=() """ # Written by Brian Quinlan (b@sweetapp.com). # BasedWfcode w?Fredrik Lundh. from xmlrpc.client im Fault, dumps, loads, gzip_enV de HRhttp.FJHTTP/Dools-rpartial!insignature Fhtml ybsocket$ys o RTpydoc!traceback ycfcntl I- = None resolve_dotted_f8`(obj, t, allow"names=True?"""Ea, 'b.c.d'!a.  RzBs a }n} e=an object. R+anany attribute in the chain starts with a '_'. If %#optional allow_dotted_names argument is false, dotQe notGsupported and th+0uncU operates similar to getattr(obj, !).H2"""/if:$31s =;.split('.') Nelse*[3]]for i in?s,Rif i.*)V('_')xraise AttributeError(v'attemptaccess privater; "%s"' % i?M Yobj =?i/return obj def list_public_methodsnA"""R11s a+7 ofstrings, found*%specifiedobject, which repres&wcallabls[member  Qin di ifh * q.(lE))] class SimpleXMLRPCDispatcher"""Mix-in ,dthat d%s XML-RPC requestsTT2pis used register6 handlers> en1i7m. Vdoesn't ne[!be=instancedKectly when)byServer but ivcan be E <MultiPath.Czz__init__(self,bnone=F>encoding=None,Ause_builtin_types9#ZP.func%{}C0 = a > %5 = or 'utf-8', =q w_&0 NEs an6Prespooi AvOnly on  llt a time7.et0 haK_t86@willp"edet `3"anzits parameters }Btupl "Ee.g..('add',(2,3)).nuhave a K Ubsearchfind a mi %):qC"""RG5s a2*prespond KsTGa0canuto set a Uniq+1fort.?}# decorator factor&if0is =return partial!.A8$)_;!if;X,% =}!._%__. s[,]-c'Q Aospesx @Ptxesystem9spasee http://xmlrpc.usefulinc.com/doc/resed.htmlN .update({'~a.listMQs' : *_,KF2SignatureJ NOHelpI}+ Pmulti <? in Cwww.iscuss/msgReader$1208 _marshaled_dispatch(self, data, dispatch_method = None, path C): C"""D1es an XML-RPC >from marshalled (XML)j%. E 4Us are1ed D?theHF`using (_1andresult is returned asA . For backwards compatibility, aAfunction can be provideargument (seeO %in@ SimpleXMLRPCRequestHandler.do_POST) but overrid?Pexist|through subclas!is preferred meanof changFLbehavior.q6"""6trytparams,= loads([, use_builtin_types=.)aT# generate response %ifais not 0E, =8(E)gOelseM L e# wrap` in a leton tupl( ,Fumps(!9=1, allow_none`, encoexcept Fat@as f 7$&, g] 7 # report  to server#1exc,/b_value tb = sys."Vinfo(wT !  l"C(1, "%s:%s" % (f:}/)) f kfinall# Break dence cyc(& =K Lxr(.!e(j ing, 'xmlcharrefreplace'C0deftem_listMs@ xsystem.%) => ['add', 'subtract multiple']R@s a D1 ofsPPs supmQed byd.M-Q= set.]s.keys()1if Pinstak4# I$implement _listMethod to return a list of 1# m)s if hasattr(self.instance, '_F]Is'):7XOz |= set?.=9())=# if the m a _dispatch$Kn we=don't have enough informationsprovide >#of^ pelif noX 9_public_& ssorted(.!) def systemGSignatureO,W_name2"""6.O6'add') => [double, int]sRGs@ describing$ s" oe@. In F0abo@xamph3add takes twoegers as argument3and result. This server does NOT supportB F."""A# See http://xmlrpc.usefulinc.com/doc/syssig.htmlA'sN2ed'+ OHelp1K"AddHtogether0strpcontain 1doct?0for specifie /f = Noni[A in SZfuncs?@![;]E%,iZz U3# I` can ixM =:Phelp au O _ .c f&:try@( =olve_dotted_niibute(3  F,/r[-\TallowH{  except Attr_ErrorBpass 9# Note that we arePcheck9 actually # be a callable object of some kind if method is None:"return ""?els$pydoc.getdoc(T!) 7def system_multia(self,f_list)x2"""...2[{'S!Name': 'add', 'params': [2, 2]}, ...]) => \ [[4]Allows the|er to package pple XML-RPC#s into a singleJrequest.\!See http://www.xmlrpc.com/discuss/msgReader$1208K6"""Fresults = []"1for1 in43 q_name =%[4L-8(&']%:tryc # XXX A marshalling errorany response will failnVentir>K#u2. I on!rey should fix this.@2.append([[._dispatch", 9)])Fexcept Fault as f  i C!{'=rCode' :J.,4 4kString6}8exc_type, Cvalu @tb =.Zinfo(Q ( 1+ "%s:%s" % ( )Iofinall/# Break reference cyc$& =N OC>+] ,C"""D }Js are forwarded a registered function thatm.gF+edn \uno suchIDQexist] llZ }instanceqif avai!IfJ;u has a XR/bped with-)Rk( a6"tsJPeters2Wa tup4Te.g. S(2,3)Zdoes not hav {then the inst"ance will be searched to find a matching method and, if fou Bcalled. (M7s beginnIwith an '_' are considered private andF0not^F """jEtry:1" # 0F thearegistmfunction4 = self. "s[]&except KeyErrorsFpass*:lse0punc is ;Non!preturn ~(*params)T!aaise ERion('T "%s"[supported' %)+"ifAinstif hasattr(2, '_disp*')|`)`1 onM > r.G($,  @z`$'sydirectly2 9 = resolve_dotted_ iibute(B1 ,#?TallowpFnameQc AAttr5 e)(r&class SimpleXMLRPCRequestHandler(BaseHTTP2"""; XML-RPC r>" h? `S`s all ST POST2sattempts`decode2m a f!s.1# C8P list accessible path components;G#,3!is@ult in a 404 e@rpc_Rs = ('/', '/RPC2'5#ifA, enresponses larger tha!is"po3_threshold = 1400 #armon MTUp#Override form Stream@: fuPufferof outputm#no Naglewbufsize = -1%disable_n%_algorithm = TrueP a re a gzip Ac -E1ingO0aep!rn.Pile(r\s* ([^\s;]+) *#content-codi (;=qC= ([0-9\.]+))? #q 1 """, re.VERBOSE | IGNORECASE) def accept_encodings(self): er = {}Pae = #.headers.get("AcF#-EFe", "")5for e in ae.split(","dkTmatch\aepattern.&(eL,1if 2v =.group(39#float(v) if v else 1.0'!r[gLu1)] = v&return r def is_rpc_path_validM"if<&sR_E3 0k =e# If .* is empty, just assume all [s are legalTXFTrue|do_POST"""Handles the HTTP ( request.BW0Atts to interpret 6s as XML-RPC calls,QwhichforwardedR~server's _dispMpmethod ~hEing.K6"""# Check that#B !bif not eport_404(hF:>#q  ac_|ings().get("gzip", 05;Oif qY?try!0 = h~e 5hEy0inglX hA  NotImplementedEF Ipass{  uCwfile.writ'`def des_"_c)A#sup'# % oVz,s!d-%uidentity").lowerT&ifkE== "+spreturn  ;"7rL/_!(X   d501, "@ %r bUed" %x_Valuexo0400o1ingC content") else: 'self.send_response(501, "encoding %r not supported" % )LH header("Content-length", "0"0w/As() L`def rej`_404 (X)1# R!0 a #Qerror<0 6404x = b'No such page'C@typetext/plainJ 7str(len(&)) wfile.write@4log_request4, code='-', siz H"""Selectively log an accepted JB."""c1if server.logRqsBaseHTTPRHandl0) class SimpleXMLRPCShs(socketu2TCP, DDispatcherd XML-RPC Z<  that allows functions and a single instanceCto blled to hYs. The default PmentaZCattempts<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}@ (ex$ioOstack tractails) when .s are raiseC2sid #= qdo_POST__dRback_Fs = Fals+__init__R,Xl=G s8=,a_none=},_=NoneD`bind_aS3ateJbuiltin_>sQS =s"(.-, w^ W(_)tb{F) # -9 # Self documenting XML-RPC Server. classHTMLDoc(pydoc.): """C+used to generate . . document for a seA""" Cdef markup(self, text, escape=None, funcs={}, e `method Mark up some plainTgiven a cone of symbols@look.LEEach- dictionary maps object name?banchor.B# =@ or .mresults = []here = 0+N'# XXX Note that this regular expression does not allowE theY# hyperlinking `arbitrstrings be2as nAc. Onlybs with8@sistCof word charactersGand '.'s are&edpattern = re.compile(r'\b((http|s|ftp)://\S+[\w/]|'d7r'RFC[- ]?(\d+)2?PEP2\.)?((?:\w|\.)+))\b')rwhile 1Smatch = .search( , @3!if6u: break` @starWQnd = &j.span(F.append(t[s:F6]))\all, scheme, rfc, pep,Adot,vkgroupsx#if@ ]5url< (all).replace('"', '"N5 '%s' % (url, url) @elif'w ://www.rfc-editor.org/rfc`%d.txtdzint(rfca?pepapythondev/pepsd-%04d/?pepK[end:end+1] == '(' 9y( ,|&##??dotg').%):?"""Produce HTML documentation for a X2or N object.""" Kanchor = (cl and cl.____ or '') + '-' + 9note = ''LAtitl!%s' % (Nself.escape(8), &))pif callable($Rargspec = str(signatur-)Felse_ ;g'(...)if isinstancL, tuple0[0]T~pdocstring =![1-%""(6pydoc.getdoc,rdecl = #+ A + (kJgrey '\n,,Ul0defpserver(' ), package_Zn XML-RPC p fdict = {}key, value in){.items(BP[key]#5keyO$P&3P_@headpR  /JPresul.W@ing(Q, '#f' s7799ee')=Q[uHws nQ+ ' t hH=#   #@ str&centire.F D i_html_% . P) => F QynzG%s 50 us introspec#Lpinstall!unas and 0nceQat do not impleD_dispatch. Alternatively,Mcan choose toOKR_get_B_arg(M)hCyprovide1arg in$ b5thewOHelpq help text)Fk vfs = {}&B in ystem_listM(]f 9Vfuncs*d 1lf.%[?]-Belif1 is ONone]_info = [% , @] # Jpec, ptif hasattrJ.z?, ''D4[0]N.L n<1B )eTtuple2) if method_info != (None, O): 1( =: )elif not hasattr(self.instance, '_dispatch'g?tryresolve_dotted_kmibute(7  3z__name0)&except Attr_Error~ XOelseC6;assert 0, "CouldCfindA in Bfunctions an&= "\{" illed" 0"s[l]+ documenter = ServerHTMLDoc(v%a4 = qer.docs6--, 2t;sc )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_404psponse =0.generate__P().en('utf-8'{rsend_reWO(200 header("Content-type", "text/t"6length", str(len(w+))?tswfile.write@ t8( n6BDocGO#or  documentation server. Adds the ability to !r documentation-2cap01iesGof SimpleXMLRPCScb2"""kdef __init__(self, addr, requestHandler=DocFR,iR3log$s=True, allow_none=False, encoding=NoneD`bind_asctivateJuse_builtin_typesQ%):',  -, M )vDocGenerator.) class DocCGI/O( Ur3"""d for XML-RPC data andSs passed through9CGIhxA_getpt#HTTP GETC*Interpret )Ds as5scr? e.$response = =".gye_html_B1().e('utf-8')G print('Content-Type: text/H' )Length: %d' % len()4sys.stdout.flush(buffer.writeVE*L# W } *0 iname__ == '__main__'`importRetimex60Exa"2ice/v|getDatareturn '42'NRcurrentTimO @sqcmethod&mC:(0"t1dat. Cnow(MOwith(("localhost", 8000)).register_funcdG(pow'J&lambda x,y: x+y, 'add _instance($()5pdotted_Nmulticalls9%ng5on  %8It is advisablesrun this eCin a secure, clonetwork.] try:  qserver._forever()  except KeyboardInterrupt:"*print("\n($ i) received, exiting."_=@sys.(0) # pysqlite2/__init__.py: the* package. # # Copyright (C) 2005 Gerhard Häring 8This file is part ofd[#rsoftwar'>rovided 'as-is', without any express or implied # warranty. In no event will authors be held liable forTdamages # arisAfrom:0usetPermissiongPed toR0one = :rpurpose, # includu commercial applications, anY`lter id redistribute it # freely, subject`follow` re1cU:1. The origin must not8Pmisre{ented; you #d@clai5!atQwroteD_5al A1 If$ !Jin a product acknowledgm!inX"P docu/ would beKappreciated butrequired. # 2. AZed source vers be plainly marked as suchd$Ts *- be @ # 3 isjpice may upremoveda aion. 3.dbapi2(Yort *DB-API 2.0WAface# /4-isrepresente'd as being the original software. # 3. This notice may 6 be removed or altered from any source distribution. import datetime `collec0qs.abc S_sqlite3 B$* paramstyle = "qmark" threadsafety = 1 apilevel&2.0" Dat4. Y Timustamp =1@def OFromTicks(t): return! (*1`.local (p[:3]) GG !G83:6HM&RQversion_info = tuple([int(x) for x in &.split(".")]) _B - I` Binarmemoryview '.Sequence.register(RowZ_adapters_and_conver(#_C(valval.isoformat()  9=7" "@{\. (*map(int, zob"-"))U7 J`part, " ) =Pyear, month, daI:]@_ful.5.")- hours, minutes, seconds = @P5[0]H6:")Iyif len(-b) == 2Vmicrof'{:0<6.6}'. F[1].decode(oEOelse[ 0/, va 7Z (e/, "tBval n (u&, E0 4 8@er("k3", -K2<)  # Clean up namespace_/l(> ) # Mimic 3$sole shell's .dump command # Author: Paul Kippes Every identifier9sql is quoted basN1n ab3ent$ite # documenta "SQLite adds new keywords91 to when it # takes on new fe*atures. So to prevent your code from being broken by # fu8 enhancements,6B should normally quote any identifier that # is an English language word, even ifU%do not have to." def _iterdump(connection): """aReturng-@ator@the 9A of atabase inSQL text f1t. L@Used=`produc )H. Useful0san in-memoryNdsfor later restora. This funWt be calledHirectly but instead C  method, 1().H2 Vcu = Q.cursor() yield('BEGIN TRANSACTION;')%# sqlite_masPtableOQtainsm5CREATE stat=k5q =SELECT "name", "typ2sql%iFROM "!QWHERE"" NOT NULL AND!\Q == ''ORDER BYG>schema_resNu.execute(qHV_ , ,;<.fetchall([6if ;sequence',yDELETE 2",/elbOtat1_bANALYZVY .startswith(''continue`#E: Virtual  support%AimplT!G#9sqltVIRTUAL TABLE#;ql" =j.replace("'2''"/4r"INSERT INTO(1tblT,rootpage,sql)"\WsVALUES(c,'{0}'0,'{1}');".(@,F'"))OelseNT{0};'mq# Buildfinserteach row@currvk_;'"', '""' us'PRAGMAinfo("{0}") lacolumnR[str(/IA[1])S]'" S{1})'>;""lwK%",".join("""'||("{0}")||'""".format(col.replace('"', '""')) for col inumn_names))  query_res = cu.execute(q"D0rowD-:@Gyield("{0};".frow[0])) *# Now when the type is 'indextrigger', or 'view'9qq = """ kSELECT "@", "J6sql%FROM "sqlite_masterFQWHERE"" NOT NULL ANDg%\_ IN ('schema_RN,A, sq6.fetchall()fb'b'b4sql_&COMMIT;') # Copyright 2001-2019 by Vinay Sajip. All R$>s Reserved. # # Permission to use, copy, modify, and distribute this softwareits # documentatKany purpose(without fehereby granted, # provided that=Qabovenotice appear0all1iesc9r # bothE ;n_Fis p V # supportingg8 ofk # not beLdpdvertisMor publicity@tain&todPion #V?j>specific, written priWD. # VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING # 9xIMPLIEDAOF MERCHANTABILITYZ FITNESS.PNO EVENT SHALL BE LIABLE FOR ANY SPECIAL~0DIROR CONSEQUENTIAL DAMAGES OR #4WHATSOEVER RESULTING LOSS OF USE, DATA OR PROFITS, WHETHENIN AN ACTION0CONTRACT, NEGLIGENCE;O0 TORTIOUS1`, ARIStPOUT #@ ORRCONNETr0THEIPERFORMAXF0. h@Logg"qpackage Python. Based on PEP 2820comsreto in comp.lang.p;& 57(C)96# T(simply 'im," l'log away! #sys, os, time, io, re, traceback, wars, weakref@llecWs.abc from 3ng YTemplateFter as Str __all__ = ['BASIC_TBuffering1CRITICAL PDEBUG xERROR',TB'FAT&FileHandlS'Filt C"DINFOM 'LogRecord', 'Logger RAdapt`NOTSETNullHandl& u'Stream` 'WARN30ING addLevelNamebasicConfig',NcaptureWarnings-critical Qdebug QisablM[errorGexception,2fat>9get [ClassP@infoK!lo~makeLogReD2setG= 'shutdownI1war!inMyLpFactorykS  ,lastResort0draiseE%s'] import threading __author__ = "Vinay Sajip " __status7`produc_B" # The following module attributes are no longer updated. __version__ = "0.5.1.2l!j07 February 2010" #-7 # MiscellaneousOdatak;@ # #IrtTime is used as the base when calculatO re @ve t7of events # N=.#0() k pto see if &Ps duroh should be #propag< # Ua= Truep If you don't wanz A0rma41 inplog, se&is to zero # logT/s ^ multiprocessdM>l gPe7- #ed stuff;# # Default lRs and p names,se can be replaced with any positive # of values havcorresponT.Wr%a pseudo-~", , which #only really reUa lower limit foror-define3s. A # linitializ{p so thapey will6 all messag_ # atv # CRITICAL = 50 FAT  ERROR = 40 JB = 3 3 =  INFO = 20 DEBUG = 10 a= 0 _7 To| = { CRITICAL: 'CRIT ', ERROR: 'WARNING: ' pINFO: '@DEBU(NOTSET: ' ', } _nameToLevel = {{$: 'FATAL': :0': 7ING=ING : *!: ": def get`Name(l!):1""")Return the textual or numeric representation of logging L! '1'. L!IfHp is one3\predefined:5s (= )VPn you correspondstring. If%AhaveassociatuPwith @s us;5add Z "KDrB&eda@[value(to is passed0in, A ?is -ot plno matchW/3or 9 kd'b %s' %& _-# See Issues #22386, #27937 and #29220 for why it's this waymresult = _ To"C.get&%3if (is not None@p#1.(= ;V0" "  ,? A#(' T-i'ed when convert3As to40 du messageu0mat)._acquireLock()@try:J#unlikelyTcause an excepyQ, butnever know..^?[6] =k((,(vfinallyt_releas if hasattr(sys, '_getframe'mbcurrenambda: sys., (3) else: #pragma: no coverH(\7"""{p object|2aller's stack $.Dzi traise Es6exc_info()[2].tb_uf_back # # _srcfile$usY@walkV( to check wh)en we've got the first # caller stack frame, by skipping`s whos5lename is that of this # module's source. Ihrefore should containLDB# #D file. # # Ordinarily we wM`use __$a__ for, but frozenRs don't alway7hav:Aset,?some reason (see Issue #21736). Thus,!ge! #from a handy code objecfunction defined #is. # (TherAno particular@pickaddLevelName.) # _src  = os.path.normcase(. __Q__.co:U) # Bis only usDconjwith sys._get, () To provide compatibility 1older versions3Python, sety # to None if alnot available; value will prevenQfindC ()@m be3d. You can also doJif you wantPavoidhe overheadUfetchMr informa , [ when& #`. #if hasattr(sys, ''): # ! = def _check (l0): .if isinstanceS, int#Qrv = 42elif str-3) =P1"if/@in _*!To}&*praise VError("UnknownAr: %r" % )~6U[]!FelseeaCType` aneger or a id?ingyreturn rv #-7Thread-relate?ufff; P_lockto serialize accessshared data ~ucturessThis need6be an RLa@beca_TConfig() creates an0figW #Handlers,so might arbitrarK s. Since 5,1updZTthe #i1@_Wb&itqacquireMP. But=curing, #6 al!y Sbeen H`d - so . #The sargument applie7bLoggerManager.l@Dict1= t"Aing.e#()y(1""" Aa-'   data. This should be released with _Lock(). """if _lock:.acquire() defC-CRm the module-level X Id by calling _ # Prevent a held loggYr`from b a child (). if not hasattr(os, 'register_at_fork'): # Windows anFRiendsD 5q_reinitF(instance)2_@passVno-op when os.{Q doesexist. elseE# A collection of fs$a  method (Handler)@# to4Qed in5`after ing. The weakref avoids us keepingNdiscarded gRalive= 0_\Tset =f.WeakSet>s" oL2tryR  F.addDlfinallH -Ofc's((Rfor h6_/ 5.2B#A was0par`ebeforeB dB is pializedO unsed stat7(=,R_1in_Z"=_ oJ=Bo) #-72 # Y recordd;0 clxALogR^s(objectp%A ! represent w be[2ed.:s are created9ry time somethB!is0ed.[ycontain allqinforma`pertin!toJImF > as inain msgargs, whichqombinedF usstr(msg) % .message fi!ofI also includes susM2Fsource line whe,re the logging call was made, and any exception informaR to b?1ed.1"""def __init__(self, name, level, pathaineno,6`msg, args,_x, func=None, s @**kw+%):HPInitialize arecord with interestWBNct = time.%()s.! = msg = msg# The followstatement a`s passof a dicary as a soleK@argu< , so that you can do somethK8lik6.debug("a %(a)d b %(b)s", {'a':1, 'b':2} # Suggested by Stefan BehnelBP# Notp!att1out}test for [0], we get a problem becaus0dur6Kto see if^arg is presNuE+A'if =R:'. I7 ev. bee edFe.g. 'Value7%d'K.u ed{ fails g@n no0matIis done. For exampl8ogger.warning(, 0) wouldK & instead of(0'suse case,x, this shu0notaz\Issue #21172: a requqNPrelax0 isance check\to hasattr(4'__getitem__'). Howevere docs on st6J@` still:msp a mapp`object$ir# Thus, while Premov7M , it does now loo Qcolless.abc.M`rather n,qbefore,j1if 1len a) == 1?rqhPrgs =Es[0]aZ  .@getLQName({FBno =A JM% =X!6tryOCfile{0os.@A.bas(7module = 5splitext.V)> (TypeError, B Attribut X "Unknown m'exc_info = exc_cinfo self.exc_text = None# used to cache traceback / E`stack_]@ = s lineno = funcName = created = ctmsecs = (ct - int(ct)) * 1000+relativeCM(]- _startTimeBif logThreads:Y)Et2 = ing.get_ident()04current_u().name> else: # pragma: no cover!~ #`if notMultiprocessingx0Z 2b'MainPu'- mpUys.modules_:('m'jif mp is .# Errors may occur 6 W2 haDfinished loadingO ye@e.g.Ia custom import hook causes third-party codI#{run when c callsX. See issue 82G# for an exampll>try: 4mp. 9except Eoion: # 4Epass\{P`es andattr(os, 'getpid')A = o27pid   def __repr__7nreturn ''%;!, levelno,e@path)= Fmsg)getMessage_5"""YRm.Uthis .V0 after merging any4r-supplied~arguments withK.$0msg!tr."if<;arg6%#`msg # # Determine which classv usen instantiatQlog rts. # _lFactory =K 45set]%"(f-1Set beNd as:param @1: A#0ablich will be called to instantiate a log record.1"""global _logRqFactory C = f def getL91():<aReturn the;be used when?ingTrL  Emake[(dictuMake a $ whose attributes are defined byspecified Rqionary,This function isful for convertg Peventeived overIa socket6"neO`(whichVs5Gas ah) intoI*ceNrv =r(None, p"", 0, $())XPrv.____.update_rv #-7 # Formatter class%ndusq;e_str_frU= Stri() del1  PercentStyle(obje{sdefaultW = '%(message)s'#yasctime# #bsearchF#E`valida!_p1n = re.compile(r'%\(\w+\)[#0+ -]*(\*|\d+)?(\. )?[diouxefgcrsa%]',E1I) __init__(self, fmfhP._fmt)amt or  MusesTimeMH<OQ.find%._ f) >= 0Q QB"""V"ePinputmat, ensure it matches$correct sbif notq4ionx.>raise ValueError("InFP '%s'  ~6 % Q,{ UH[0])5 a %TJ 2try [N(zM$except Key[ as eF &'IQfieldfound in : <E% e) H]{}\s ! !!'G@fmt_I ^(.?[<>=^])?[?#?0?(\d+|{\w+})?[,_] )?[bcdefgnosx%]?$', re.I) 0 field_spec = re.compile(r'^(\d+|\w+)(\.\w+|\[[^]]+\])*$') ? def _format(self, record): preturn c._fmt./"**+.__dict__SvalidateTLC"""V the input Q, ensure it iscorrect string(t style"""s = set()6trybfor _,7`name, <, conversion in _strter.parsS&ifS qbif notGq.match([=raise ValueError('inhz ?p/expresr: %r' %NzWs.add?&(if!8andin 'rsa'w!if v8fmtKF1badRTifierBgexceptxZ as eY[@: %seN"nos class S$TemplateS (Percent sdefault = '${message}'yasctime" "bsearchD"EXq_init__S, fmtVO =2 or L/dtpl = XrusesTimp1fmt!lf2Ycind('$p') >= 0  &wpattern. m0.finditer Ad = m.groupK`if d[':d']9'#"elD_braceE(FP(0) =A]bare \'$\'callowed'om74 tpl.substitute(8 BASIC_FORMAT = "%(levelU)s:%( message)s" #_STYLES = { '%': (PercentStyle, BASIC_FORMAT),'{'StrForma)'{levelname}:{message}';$;ingTemplatei('$A$B(${C} class zter(object):1""" instances are used to convert a LogRecorjtext. BBs ne5know how6 isMstructed. TheykEresponsible for*w9ingDto (usually) a str"which canK'be interpreted by either a human or an external systemV base2Oallows a@mattqxto be specifi If none is supplied, theIs&-dependent default value, "%(e)s", "Q", orB" ",e'Th initialized with :Pmakes1 ofiledge ofattributes - e.g. mentionedMhabove d3fact thaoCr's  and arguJApre-OfJHinto@. Currently1fulJ(inI describB: %( )s5Nam&logger ('channel)n"%(o@Numeric 1"i" (DEBUG, INFOW} WARNING, ERROR, CRITICAL~5ameOText{ "|~""+ "JpathDTFull osource file where&N call was issued (if availableT 0ile@ porlv%(modul9A M 9_:lineno)d2 S~ number MC 0uncQ FuncM%(created)fN1TimonnS.p (time.(R> breturn&P%(asc6 @ual wXmsecsL MillisecondAthe 1ion`ArelativeC!d Fin mIse LogRecord was created, relative to the time logging module MoloadedK(typically at application startup])@%(thread)dT ID (if available1bName)s51Oname3wprocessePeemessagb The result of record.getM*(), computed just as aB is emittPA""" 7converter =/`.local def __init__(self, fmt=None, datestyle='%', valiq=True):jwInitializ`formatwith specified  strings.A qeither HLe, or a@defav as described above. AllowdqOy op!al*fmt argument. IfBis o, you get anI ISO8601-like (or RFC 3339)aUse a p parameV1of 0'{'0'$'ay that}uwant to~puse one"%-ting, :meth:`str.` (``{}``(5 orKa:class3ing.Template`/ inr.. versionchanged:: 3.2d AddedS!``&``.*#if/not in _STYLESoraise ValueError('S mb&: %s' % ','.join(qD j.keys())|&k!._$ =[][0](fmt-%ifr F.&()C "= bU._fmt( E5_1_ = '%Y-%m-%d %H:%M:%S'N.Hmsec.us,%03d'SCTimet rXaReturnZALogR`3 assVGtextsPThis od should be x3rom;s() by asQwhichZstQmake Xf/d o0canloverridde2in n1terUpprovideB anyfic requirevP, butbasic behaviour& Fs: i(R)%D, it is used with time.strf () to format the creation'0 of#  record. Otherwise, an ISO8601-like (or RFC 3339)^.NThe resulting stris returned. This func`uses ar-configurableQ*to converto a tuple. By default,F`.local $()>;*change tor a particular5terLinstance, se'er' attributeZafhe samsignature as "or"gmS. To itE allQters,example if you want0P loggUsbe shown in GMT7 inI! Fiter class 5"""ct = self.,(z5ed),if datefmt:2s ='F, ct?Oelse9 &__= Ju"if-Cmsec- e- [.s % (s, s1 s 0defmatExcep)(WV, ei)v`C andkspecified eI2 ina|.{ iCBmentB@justs.traceback.print_j(sio = io.S'IO(tb = ei[2]_# See issues #9427, #1553375. ComRed ou6nowp#if getA'fullstack', FalseQ#-(tb.tb_frame.f_, file=sio Pei[0][1], tb, NonC??io.getvaluesio.clos[-1:] == "\n"NF[:-1MgATime PCheckFL=cLF\N u_style.)bMessag<L\ PS!, _R`method0providedan extensBpoin}pealized"ofu xpe inputasaBaBurned from a call to 2:func:`traceback.print_stack`, but with the last trailing newlineJremoved. The base implementation just returnsYvalue passed in.B5""" 1 R_infoi def format(self, record):9EF*uspecified2 as textO's attribute dicary is u<he operand to a0str0t 'C which yield 2ed 6 cBeforeF, a couple of preparatory stepsare carrPout. wmessage!of%computedI usALogRqR.getMGR(). I@/Htime (as determined by2sTime(),& iexr`event ` reQexcepG;Eion, it%HBted E;0() bappendzI}M.$# =y : f R.usesM0asc" =.0!,datefmt)_s25'$if1excv q# CacheoDGvoid converit multip# (it's1stant anyway%Pif no?. (! ' l dif s[-1:] != "\n"d! +y}a$| _~1_1S(t s # # 5sdefault0teruse when no otherLkC # _76%= () class Buffe8cobjectXAqsuitabl%a numbersED__init__Ffmt=Nones2 ODRally Ppwill beFeachndividualmp3if $ =$Celse:  self.linefmt = _defaultFormatter &Qdef fpHeader(7, records):%)5""" Return the h6p stringJspecifiedI.<HrH,""OFootf6=V0 an3result as aGv = vtif len(F > 0r1Prv + .613for3 in sT' XT`)Y 2 orv #-7 # Filter classesfunctionsn; dqs(object?pinstancre used to per' arbitrary fWrof LogR.-bLoggerPHandl `can op@ally\ u#toZdesired. The base(> only allows events which areKbelow a certain pointY(l hierarchy. For example, alI initialized with "A.B" willUQd by "rs*,F5A.C",D.C.D D" etc. but not B!B.h!IfE Sempty,Pare pjde __L#__Osname=''"f- I P1 of , togetherK1itsHchildren,[uhave itahrough[u. If noI}5is  ow ry"ntw? = SQlen =)NLKDetermine i0 is"beEdiUs Tru?m should 6, or False onFwiseIf deemed appropriate,RP0mayM2mod8win-placD7"ifn!= 0: return True  elif self.name == record:'.?2e.find(PC, 0,^len) != 0UFFalsj(Y[T@len] ".") class Filterer(object)a1"""rA base +for loggers and handl which allows them to sharcommon code.V^def __init__~0$ Initialize^ list of fsmbe an emptyh<H6Q= [] 2add ,\1Addspecified/Dthisif not (2 insss.append9)oremoveR0_from  @ IyDetermine if am1 isable by consultingb"s.3The default@ to,!ow.!beZted; anycan veto=M/7thethen dropped. R@s a zero valuNi;, else non-:.. versionchanged:: 3.2@ AYjust call3sJrv =f if hasattr(f, 'w'. reR = f.%)& P<5 # assume - will raisf9not[Ld W{UbreakLr rv #-7b # H`~etfunctionso;% _= weakref.WeakV!Ditary() #map2 ZsMLh@ddedT'"82be d^ reeb`order 0d _.cRef(wrd-ah reference e internal cleanup9G# This functBion can be called during module teardown, when globals are # set to None. It MGalsoRfrom another thread. So we need toLpre-emptively grab th%vcessarynd check if#Ay're,Jto prevent race conditions and failuresinterpreter shut.Kacquire, release, handlers = _sLock, _#(AListJ3if /- +!s:)X*%()6try#if wr in #X.remove(wrPkfinallT() def _addHCRef(O)i1"""TAdd a0 to Qnal cleanup list usZa weak referenceiOT _X.append(PVref.r) cclass 8(Filterer instancKispatch loggsspecific destina!. ?The baseB. Acts as a placeholder which definesjLvTface.s opr use FormatAto fIarecorddesired. Byxtault, n.E#s 0ed;0thix"sep'raw' m gedlmined by p. !isE*ed _init__(self, level=NOTSETM Initializ1 -xi`y settK;"0to y&}>(._,._name =liL( B F # 7 NU (for%on m p.createK1getqreturn :!3s3 , #9&l *'if]l(5del&s[]&! = !if"/x[1] =< 8 > = property(Z,C)D@ """ : Acquire a thread lock for serializing access to the underlying I/O. B""" q self.L=Zing.RLock()& _register_at_fork_reinit_:(D!) -Kdef $:v.r.)Da <3I/O&if xrelease R#u6xsetLevel0, l )1Set@logg, of this handler. D must be an int or a strH| = _checkdcformatorecordF*specified 2.Y@If amatter is set, use it. Otherwisevdefault5:"omodule16terkRfmt =S"`Oelse/_5ter2return fmt.O(Q?emiODo whatev&at takeactually logm(tuT0pversionsintendedebe implemented by subclasses and so!aiV NotI5OErrohr2/ (' 'pR'by H'hConditionWVXAEmisTdepends on filters which may have been adu`8AWrap$ e^eLa with s/e5 of9` ! Refk pd=nNb%rvBZif rvH're2:try,0 ]!fi7gr 2 rv5set4?fmt< """  self.formatter = fmt def flush($!):5""" Ensure all logging output has beenD2ed.VAThis version does noth<and is intended to be implemented by|subclasses.Bpassu_close Tidy up any resources usu the handlerxremoves+ from anrnal map ofK%s,_^s, which}4for/ lookup by name. SHshould e`that tpgets calledoverridden )DomethodW0#geSe module data lock, as we're updat shared structure_acquireLock(}@try:&#unlikelyPraiseIexception, but you never know..^C"if_. ].5in t76del[7]%zfinally;t_releas-~QError, recordWHj e0soccur durXn emit()  !be%rW)enS1 isencountetA If EsVfalse s 8silently ignored. i at@0mos wafcsystem - -0illH0 caDbout@%inHF, y 5Bmore eslin applicaqNbPYou cmP, howRplaceswith a custom!ifFwishL3Thew?`proces0is Ped inJiys.stderr: # see issue 13807,t, v, tb = sys.exc_info&r0f.write('--- L&v ---\n'8traceback.print_F(q, None,fFCostack:x`# Walk &P framc until[$of@# so 1to P{vcontext2k= tb.tb_ $qwhile (os.path.dir.f_code.co_fprame) ==N  __path__[0]):  frame = }.f_back)"if CPtrace8.print_stack(Q, file=sys.stderr)\OelseX # couldn't find the right b, for some reasona.write('Logged from %s, line %s\n' % (JN precord.cname, L>no)$# Issue 18671: output logging message and arguments?try4MQ}: %r\n'J  $'Az:Omsg,FN FOargsexcept RecursionError: # See i8_36272]raiseTE[?ion9Unable to U - possiVpformatte`.\nUsedNwQ abovFhelp,YR 5#OS#pragma: no coverg@pass5# sI5971)~finallydel t, v, tb 3def __repr__(selflevel = getL AName$.return '<%s (%s)>N.__class__.__C__, >  StreamHandler(1"""2A h  4awhich dss, appropriately"edPato a stP. Notsat this]does not clo-02, a$@out w may be used. terminator = '#Cinit,lS=NoneIInitialize.!fF" ispecified, 0err8e7.__ic ma' =of!QflushfF! esk[gacquire( Celf.qhasattr1, ""):  self.stream.flush() finally:1release() def emit(, record)81"""(@cEmit a$.@If a formatter is specified, itsused to&E theGBT1then written92 with a trailing newline. Ifexception in s presentted using@traceback.print_Pand appendM has an 'encoding' attribute!determine how doRK`outputx+tr`msg = .(?) !# issue 35046: merg 2wo -.es into one.>$(+Fator  RecursionError: # SeeI6272{UraiseDE(wahandle]+@5AsetS|::@Sets 3HY3r's37q value,m#ifHdifferentbReturn`3oldTA, ifs was changfor Non `fwasn'tN#ifXDX 7result =^Oelse(J`acquir 0 ' n.:2rr __repr__ level = getL AName$.Bname( #0, 'V', ''0# bpo-36015: !p can ben5int=( B!if7 #u += ' 'B'<%s %s(%s)>' % __class__.__=1__,W#, ! !S File( .r"A |"r 8Qwhich#esD@loggsGdisk filesRCinit,&, mode='a', =, delay=False, efs a Op&hee 30usea FR1# Im#27493: add support for Path objects to be passed in filename = os.fspath()'#keep the absolutL th, otherwise derived cles which use thisJmay come a cropper when] current directory change?self.baseF?.ab60modencoding = !Prrors delay = "if:q#We don't op stream, but we still need@call EHandler constru)-set level,matter, lock etc.DC.__init__( .u = NoneBJelseSV!, J_A()) Fdef closeyM1"""!C!s '_acquire(6tryWO "ifa 1 9~Wflush|kfinall{( =!o2 ' if hasattr(11, "t/")5.., # Issue #19523: unconditio= to`# prev3a hBleakT} is set; t#p.releas/WhO ,Q withP(orig ) hE andTRRetur`result}v{r1C ap,m=',VZe* Aemit, recordcEmit a$.a!Ifr was noped beca''qspecifi;,8it beforeg=Qsuper~0's qL ]F =\ ~o . YT_reprdip = getL2Nam.k'<%s %s (%s)>' % q.__class__.__name,__, self.baseFilename, level) class _StderrHandler(Stream): """RThis 6is like a 1 using sys.sW, but always usesIwhatever) [urrently set to rather than the value ofEeR at h construction time.-def __init__(s=NOTSET InitializelZ ^ ;.f!) @propertysvgreturn% _defaultLastResort =WARNING) l% :O #-7 # Manager&es and funso;PlaceHolder(objectB! instanc re2d i[0loghierarchyAtakepp of nodes for which no =s have been defined. <MintendedC @rnalQ only:not as partrublic APIF sa- Awithspecified0 bera child1is hsP\Y.~Map = { : None } aappend,'?Add?as $ifn h"in- [1] =1 #Determine-!toCwhen@tiatZm`s. # AsetLC (k `S"hebb_a2ashouldP) suc #at 3 argumentrequired,"thz") `b call  )w1if 3 !=*si`q1subE ,)raise TypeError("XPderivf1romBing.": C+0.__"__global _d" =;gRuE+_loggerClass  class Manager(object): """There is [under normal circumstances] just oneL2 inq, whichKholds the hierarchy of loggers.$w def __init__(self, rootnode InitializecmQ with? @txK |.<=disable = 0emittedNoHandlerWarning = False-Dict = {}C^= Non=RecordFactory %F@propertyYXNqreturn _$ 5@q.setter Ih, valu I = _checkLevel(,^JAgetLX, namKSGet a6specified; (channel), creat}!itif it doesn't yet exist. This9a dot-separated0EicalK, such as "a", "a.b.c" or similar.If a PlaceHol^aed for Q[i.e./0did?0 bu!Pchildid], repk%edIX and fix upnrparent/S`refereP poin to-Kmer to now* v$rv'if not isZ(t'tr*raise TypeError('A-2 mbe a string')_acquireLock(2try^Same 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.6C Set the4 class to be used when instantiating a logger with this Manager. B""" a if kWA!= L::$if not issub(/,-).2raise TypeError("Gderived fromCing.w G+.__name__)Rself.iC=+ " def setLogRecordFactory(62, f!tSet the&! rf $ =z_fixupParentsaEnsure thare are eitherers or placehold1all5wayspecified?qroot of9 hierarchy3 = .o@i = .rfind("."rv = None.while (i > 0) and*rvcsubstrYE[:i]@3if !4in zgerDictL2 ![?P] = PNHN(;NelseQ\obj =xW DRif isoce(obj07=objI3Passer g 4obj.append, 0, i - 1R |sh!.p\ = rv9Children:4ph,}>c=21 phWconnected 4 len = len((for c in phFgerMap.keys(@#Themeans ... c7p.startsH6(nmhB9if , [:blen] ! B Zclear_cacheC'+ s( DCallXlevel changes6madmm8_acquireLock(+ufpum.value logger, Loggker): logger._cache.clear()&self.root!_releaseLock() #-7a # L classes and functionsn; dqu(Filter31"""Instances of the/ represent a single `ing channel. AH"" indicatP areabpan applion. Exactly how anJ," is defined Qup to? developer. SinceC$pcan havy number\reas,s identifiedby a unique string. A30as hbe nested (e.g. 1reaFof "input procesO" might include sub-s "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__(,,Pw=NOTSET8InitializOwser withPan opT"alUAM. /! =E. = _checkL ( A0parCj= NoneCpropagate = Truhandlers = []9disabled = Fals9a = {} 8r2setle1Set}^HtZp must ba@ inta(r|9BmanaSdebugAmsg, *args, **kw Log 'msg % &'>severity 'DEBUG'.:lTo pass exceV informabB, uspkeywordU um@exc_*aNa true value, )j["Houston, we %s", "thorny problem", exc_info=1) 5""" if self.isEnabledFor(DEBUG):%8&B_log, msg, args, **kw !) 3@def t(4)* *]Log 'msg %Z' with severity 'INFO'.fpTo passaeptionx0rma , use the keywordTPument0`Na true value, e.gjqlogger."Houston, we have a %s", "interesting-Y Xwarning?WARNINGjbit of a-  s. p("The ' ' method is deprecated, "0ing' instead", D3BionW6, 2r3 Z_error_ERRORVjT_majorQ-OM 2exc TrqConvenience_@for 1an (6wf.?OOM `critical @ CRITICALfji disaster self.isEnabledFor(CRITICAL): self._log!, msg, args, **kw !) 6fatal = critical@def BLs, levelE*<F|1"""RLog 'msg %v' with the integer severity '^"'.y= To pass exception informa Q, useJpkeywordaPument0_*ma true value, e.gjplogger., "We have a %s", "mysterious problem",j5=1)hif not isinstance(_;intif raiseEsR ! TypeError("N must be a!V"8OelseNUeturn0if s.isEnab[a &X ?findCaller(:q, stackc=FalseM'=1mJAFind> frame ofc^ so that we cany esourcefile name, line number and func\.2f#aurrent(j#On some versionsIronPython, c8! 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 FbreaO6 rvmakeRecordKUp, fn, lg1exc,! =, extra=None, sinfo=None): 5""" 2A factory method which can be overridden in subclasses to create T specialized LogRecords.iutrv = _l&F(name, level, fn, lno, msg, args, exc_u, func,\ s*)$if extra is not :pfor key* "Cif (" ["message", "asctime"]) or#rv.__dict__}Hraise KeyError("Attempt^zwrite %rS0" %Mor[key] = return rv 1defU(self|sD3tra Qstackk=False'=1ALow-" logging routinec6s aR and then calls0all handlers of thisZ erS&r8! =!_if _srcfile #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;)Oelsek g"[ Gif isinstance(TBaseE*v = (typ;)j 0.__r eb_z1lifHtupl|Dsys.(\A1 = BmakeH. u s,}()$#, 30rs 2theCfiedA._T]4qis used7uunpickl3s;0eivrom a socket, awell as thoseZ@d lo y.3ger+`filter-is applied""" if (not self.disabled) andfilter(record): 4callHandlers' 'sdef add(.g, hdlrG1""",VAdd the specified hX to this logger.2>_acquireLock()#:try0if (2 inis. q.append=dkfinallht_releasoremoveR/Ofrom: @)3hass'hSee if has any*s configured.Loop through all/9forPits 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 ci {GgFYbreak%c.*P6("c.er"rvd 5-, 5(cPass a$4GvantdtHItoutput a one-off errorpmessagesys.stderr. JY J4ose`s are (EXE = 02F O5+ 1W#if.levelno >=?5{Epropagate:  c = None#break out Yelse:9vc.paren/if (found == 0)6if lastResortQif 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. ReturK`first u.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(.name, suffix))# return self.manager.getLogger(suffix) /def __repr__(1!):Jlevel = ; AName$MEffectiveL5())7~'<%s %s (%s)>' % ;__class__.__name__, !, t Nduce# In general, only the root l will not be accessible via its r.# However,H1's A has91own5v methodJ!if3jA) isfeiimport pickleSraise .P ingError('3can@-d',R,) 4Roo$1"""AV that different to any other, except +Iit must have a'2ing@ andz re)one instance of it inIhierarchyzCinit4Ut+bInitialize}qer with* "U"g4@19.__r2z k6hT6B) _C32 = mAdapter(objectRBAn a 4 fos which makep easierspecify contextualoinformation in%boutputr,}Sextra4 *!er#a dict-like }Jprovides Q. Thi structor signature allowsKeasy stackfss, if so desired.You can e&ly pass keyword arguments as shR inr| foxexample:_R(some,&(p1=v1, p2="v2"{.i! =%er1 = pdef proU, msg, kwargsP0gqmessage4 edt%to=@calloinsertiHmanipulat its or both. R`H= modified (or)suit your needs3Nb@lly,2'll&8poverrid0is v in a $ LoggerAdapter subclass for your specific needs. 5""" kwargs["extra"] = self.%return msg, 1 # Boilerplate convenience methods&def debug(g,S*B, **\!):+PDelegbaB call to the underlying lu.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 @, afeaddingcontextual0rma from this aR0OanceL"if+isEnabledFor(A_process(~40gerX)  Cb"Is2" e@! '%'?;>g <)@setL1Set"ed) on the underlying logger. 5""" Sself.!setLevel(l!) %def getEffective"7!):!URGet the e2 OA forounderlpreturn ihasHandlers(5oSee if has any hI3}A_log, , msg, args, exc_info=None3tra Rstack_FalseBLow-\log implementation, proxied to allow nested 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(**kw6[1Do &) cVrsystem.*EThis does noth(jp alreadsred, unless@pkeywordux *force* is so ``True``e Ita venience method intended&use by s scriptsto do one-shotIo upackage e default behaviourto create a StreamG which writes tosys.stderr,a ma"0 usYBASIC_FORMAT!` strin!ndJ1addFl;A number of op/ ` fataw(R-O._ERRORLA has$nosLandler with a pre-defined format. 1""" if len(root.handlers) == 0: 8basicConfig()/error(msg, *args, **kw ) def exception%exc_info=True4pLog a message with severity 'ERROR' on the logger,*ymqion. If4/ has no ),  is called to adFa console7taok0  CywarningAf2WARNING47   P~< =: C s. p("The ' `' funcdeprecated, 43"us.ing' instead", D/BionW2, 26\ OINFO4Odebu"/ODEBU 7log(level, ^p'msg % 'wintegerV 8kL~(* PrdisableT=CRITICAL)GD%A all1ingcNs ofBand below.manager.w = level root.#manager._clear_cache() def shutdown(handlerList=_ ): """Perform any O!nup actions in the logging system (e.g. flushingEbuffers).  Should be called at applicaYa exit.*`for wrqreversed3[:]#errors might occur, Aexample, if files arAckedn>we just ignorem1raiseExceps is not set;2try<Hh = wr()"Jif h' <h.acquir !h.j e&oh.clos<eP (OSE/q, Value LH2# I`Swhichf'usH2# because hs have been Fd buI8# references tostill arounA d9#WMpassAkfinall6yh.relea[S4: #< yt, as we'ret/ u;if f(! 6#else, swallow #Let's try andoj automatisNy on.. import at .register(<) # 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:beveloper simply need(instantiateOa`add it^Ptop-lN;er module ozpackage_(self, record:"""Stub.3Oemit1createLock7`w.lock = Noneoe_at_fork_reinp9B # W&Ategr3 _=cs_show c_(message, category,oname, lineno= .IAmentfsredirects to logging8, which will first check to see if the file parameter is None. If ais specified, itVPdelegateSLoriginal warnings implementation of show. Otherwise,P\F calDs.format4A andA logresulting strAto aO3s+ger named "py." with level&ing.WARNING.D1"""%if 1not$:XDif _S_N.2/(message, category,u, lineno)Felse5s =~ :^fX0log9a= getL (?*0if 1.handlersNR.addH T(Null )MFS("%s", s) def captureWc()lI)true, redirect _t>rpackage FFalse, ensure thatkA ared edYU0butetheir *adestinstoglobalYQic *.As5's.!8 = 0  =h qc # 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[KdPion #Vsj>c, written priWD. # VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING # 9xIMPLIEDA"OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALLBE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR # ANY\WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER # IN AN ACTION OF CONTRACT, NEGLIGENCE OR O0 TORTIOUS1`, ARIStPOUT #p ORSRCONNETWITH THEqERFORMAXF THIS SOFTWARE. """ 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 = .Ebq # # `follow@code"lea listener5on-the-flyC9recz$of.e_?Ahold< object doj;6= None def file(fname, defaults=%, disable_existing_ers=True): /@Read "a oParser-format!. MThis can be called several times Gn applic4, at`an endrOability to sel!Dvarious pre-cannePs (ifIdeveloper provides a mechanism\ppresent2` choic#Snd loachosenN !).G#p(if isinstance'H.Raw_Qcp = lBelse IF();1if hasattr'Wline'u+0cp._j-G .)q$ters = _create_B(cp) # critical se@ing._acquireLock(6trys_clearE#s(]$# 1 adpmselvesg34ll_@(cp,0mat5_*X1ers)6AgfinallEdreleas _resolve(name): """R esolve a dotted name to a global object.""" =.split('.')Sused Rpop(0@foun__import__(*ar n inQ:Gf!1 = + '.' + n6try+/cgetattr(2, nd"except AttributeErrorE<R? = bqreturn % def _strip_spaces(alist)o,map(str.(", "<create_formatters(cp>A"""CS and L)fqw = cp["]["keys"]Kif not len(0cY!{})1 = 2","^+ =!4 = R0or +{Asect&= a_%s" %3)!fsT.get(5,4 ", raw=True, fallback=NoneAdBdatefmtC?stl_styleA#'%/c = logging.F(cclass_ 4cp[]"M1if 2Qh"_r(% f`(fs, d7stl s[] & install_handl,'iB"""I)4h.`w1 =    ~@ixup[] #for inter-) references/!W0ion0p["%3lerk3 = 2[!6fmt)G", "1 H]Qeval( s, vars() Q(RR, Nam]0N^P0argIg", '()31 =  kw V'{}VXZAh = (*cB, **2#h.if "level"#[0%`h.setLI(0x"ifmo/3cer(formatters[fmt]) if issubclass(k , logging.handlers.MemoryH%):>Etarget = section.get("V", ""m/rif len( ): #the  p may not be loaded yet, so keep for later...`fixups.append((h,])g s[ Q] = hF#now allDs ar!, Xp inter-8ler referencess2 in2s-ah.setT.(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 holdzQthem;Lcand by, you stopc do1any =However, don'tEecren of named7@ers,that's probablMwhat was3n by user. Also,n4ow XaNOT beJDd if is false 0roo/K0logu.Per = /.manager.Dict[log]GhJ O%sinstance(OcPlaceHolder8.8QLevel>fNOTSET 07frs = [ %propagate = Trul$Jelse=$ll4(cpV.@`"""CreC t#LeGR firsE@llisBcp["s"]["keys"".split(",0 = F(_strip_spaces(> .remove("@6 = _ } _YqPif "l"Uj[,c7log-I$hSy6[:]\"(h=hv_Y 1en(']? p! o7y% 5add)#and now the +others... #we don't want to lose the existing loggers,1asince F threads may have pointersICthemeKQis segcontain alljand as we gokAoughnew configuration weremove any which are+aed. AtB3endwhat's left in!is)$ofeZ@were2+previousk8but2!nog5 -,= list(root.manager.Dict.keys())a1The.Q need~be sorted s= atH2can0avoid disablTchild of explicitly1Ename!. With ab it is easier4qto findH a .(We'll keep7Z aW_0ren T here&_Dbs = []H1nowuu5one$0forl:6>1secb= cp["Y`_%s" %1^(Sqn = -`["qual"!propagate(.getint("", fallback=10]w =s@ging9L6(qn'Pif qnaF5i =`.index> + 1 # start wentry after qRCprefixed =nU+ ".". 0fle Dlen(,"Dnum_4en( )while i < 3 Qi?`[i][:pT] == 48 .u.append:[i]2ii += 1.T if "level" [09wP.setLN(5hb(handlers[:]m5H&&(hI@ B%[0h> 0if +)1 = .split(","  = _strip_spaces( )c"inR mL5add s[1]) !#DHwoH0. T~R's no@ delg8"M@inueHhSreferences;'byL, you sto@m doany logging. z #However, don't disable children of named loggers, as that's #probably not what was intended by the user. #for log in existing:Pg = root.manager.Dict[log]/ if2 in_)&s:"U.level =2ging.NOTSET+handlers = [oMpropagate = 1DDelifF#_e tdI_~ ?(P,,q) def _clearEH"() @"""C and close Qrs"""Y41rs.[)()shutdown(/rList[:].5delP! IDENTIFIERe.compile('^[a-z_]0-9_]*$', re.Ivalid_ident(sFm = R.match(s0if m raise ValueError('Not a Z Python aifier: %r' % Preturn True class ConvertingMixin(objectg"""For$XXX's, this m0 F provides common functioncl_with_key(self, key, ue/`place=esult = 2.configurator (v821#Ift"edb is different, save next timeA&if2r$!re Q[key]&[if type(W)"(J,x~,@D ?WTuple?)m0.paN V%Pkey =!?  .ly>| g # The2XXX,es are wrapparound standardpcontain! #they serve to  any suit}sL0the#C. #sversion ts base dicts, listslAshStheird # equivalen1whereas strings which # adoaformateM ap riately. # # Each wrapper *should have a configurator attribute holding the actual #,to use forversion. class ConvertingDict(dict,Mixin): """AC0 ,ionary wrapper.""" , def __getitem__(self, keyLPqvalue =H.-L,preturn G".c_with_key(key, N)~6getv, default=None3)(?pop3, replace=False)List(lis, A?1oidx=-1y (P (L #pTuple(t%-6*B7 t# Can't1 a 7 entry.=WBaseCs(objectr0The'Rbase LPwhichines some0fulsL&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 want 8a different one, e.g. importlibaer = staticmethod(__#__.EinitCWfig =.v -t=,vsresolvespkKR& strings@s usgstandardF andRyntaxWc0nams.split('.n(used = name.pocp(0) Etry:  found = self.importer(used5(r frag in nameF"4 += '.' +, i# ~getattr(,E -except AttributeError+ $p? = qreturn 0I>Pe, tbdys.exc_info()[1:]Cv = Valu('Cannot resolve %r: %s' % (s, e)v.__cause__, traceback__ = nraise v def ext_convert(80, v)Z"""Default )er for the?:// protocol."""[6V.(]?cfg)?cfgBst =mWORD_PATTERN.match(rest_if m is NonD"Unable to"b %r" %|Sdq <C*Jsban appropriate type. dicts, lists and tuples are "replaced by their converting alternatives. String? checked toJ`see ifEy have aKsion format and5ted35do.K5""" if not isinstance(value, CQDict)[&d:N@+ =AW)*.configurator = self&/el?Lisl AHTA\)St/rhasattr, '_fields') w7w"str): # strqY py3km.CONVERT_PATTERN.matchJif md = m.groupa("prefix = d[' )']%keW._bs.get(?n, Nonei%ifMrf5suf )xa = get,b9& ='(h.qreturn ) !deZe_custom(n7fig@C"""Ce an object with a user-supplied factory.Dcfig.pop('()'callable(cy=p.resolv![props],.'0# C/valid identifiersLPkwargM0{k:Jafig[k]5Ck in0D_DE(k)}B`result2(**O  $for name,h&{.items( sm,>m$1as_=c"""Utility funct8Pwhich s /Qs to Hs/if&1cw" =C $ class `X(Baseas`e loggI us a -ionary-liketo describe@v2ion` <MP"""DoG6figuration.""" # config = self.if 'version' not in #:$H raise ValueError("dictionary doesn't specify a S%")E#ifX[po] != 1h UnsupportedW~: %s" %Qoncremental =)v.pop('i', False7EMPTY_DICT = {}logging._acquireLock(7: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 3Unable toj4ure9!]' } from e=<2ji KBure_I(_,w#er1_, Tru{wvrKroot0if Z/F(I^uGz/')0dis8_existinx g$s'  _clearExistingHandlers() *# Do formatters first - they don't refer to anything elseJE= config.get('', EMPTY_DICT)B name in 5:(?try=[P] = self.Eure_"(^EGsiFexcept Eion as e raise ValueError('Unable/ 'a %r' %e~) from # Next, do fil, eitherD Z27 : (& whD andK5As E6cano`, sort;_ keysIEllow a deterministic order of9}urationB NO dred = []\1for~4ed(X)v <p]r >0.! = (,$ =1if 'target notqed yet'6tr(e.__cause__6.append(x.s7"?]'9 UP# Now8any that were 0r% igure_handler(handlers[name]) (.'0 = , T3 = =1except Eion as e:+raise ValueError('Unable to configureq/ 'HL a'%r' %) from e ># Next, do loggers - they refers and filtersIwe don't want8@loseK existingb,since othshreads may have poinuU^them.@cQis secontain allas we go through5new at.weremove any which are7aed. AtN?endwhat's left in!is5$of?}r@were>the previous?but>!noA uaroot =@ing. ]p= list(%.manager.qDict.keys()A#The:` needsbe sorted s at=can|#avoid disablQchildof explicitly=-. With az it is easier@qto find yI%.(We'll keepO~ Xaren of~ here..2_ns = []`1nowou5OonesOIc.get('', EMPTY_DICT1for2Pi(U))5i =jp.index() + 1 # look afte| CprefixedDo + ".".@flen64en(:XDnum_55while i < ?ii N`[i][:p@] ==J@ D 1.append(/[i>oi += 18H.i. try:  self.configure_logger(name, s[/])Cexcept Eion as en raise ValueError('Unable to x/ 'rp'%r' % ) from e >A#Dismsany oldh s. There's no point deletingD@themother threads mayAtinuh_referencesGand by d@ing X, you stop0 doNing.IHowever, don'tQe children of,_that'probably not what was intendethe user0forR in exis? #er = root.manager.Dict[log];$ifdsi2W.level =>gJoNOTSETe7handlers = [.propagate = True_Delif_+ ],/ed\_R(c,,m{[)] And finallys-ern =7fig.get('~', Noneo!ifOf(dKBo'b -_releaseLock(3defdformatter(,)OD"""C5 a 0Va dictionary."""pif '()'Reactory[-0] #`P8xD 2result = rcustom( fB TypRif "'!'"in str(te.P#Nameparameter changedR0fmtjVRetry with& This is so that code can be used with older Python versions #(e.g. by Django)"config['fmt'] = .pop('format'5!()4}factory\result = self.Zure_custom(^Yelse:E fm>(E.getf, None;d.@date/Vstyle^[', '%Lcnam-dclass'[ qif not 6 c = logging.Fc9ter@ 8_resolve(\)) 7 # A TypeError would be rai7if "vali" key is pasnV"a ter callablecthat doeshacceptYas a parameDif 'C' inmp: # ifr hasn't mentioned it, the defaN@will:fin#rpc(fmt, !, ,n[]AvSrreturn -3defspfilter( )A"""Cbure a - from a dic uary."""N(()H s}! /c#Badd_s3er,s)4Add5 to.$er0list of s3Pfor fycs2:try*rer.addFQ"[' \s'][fOxE{ion as aR Valu@('Unw %r' % f)ec_handld.Pe|q_copy =PrestoringX@case{eT`5terF&if F l[1ter&]le )6set) '_c '*Qlevelnfig.pop('level', None) filters = config.pop(' .if '()' in/:IPcG6()'j!if not callable(c)A$Eself.resolv% epfactorykJelseJPcname$[classk: = r= #Special case for handler which refGto anothe if issub(|, logging.Qs.MemoryH`i) and\FJ'target$:try$th$['|4'][a-]]|Cisinstance(th@f.update(_copy) # restorhdZred cfgOraise TypeError(nuC;yet=[8}'] = thoexcept E{ion as yMDValu Un to set _F'lE c'%r' %}) from eE/eloDSMTPmmailhoso C-EX`as_tup&['# f_ysLog address# ," LpropV.PPkwarg'4{k:!k]_ke if valid_ident(k)}h result = 2(**f.tif "'stream'"Gin str(te#The argument P changedAstrm c ;Retry with old=."This is so that code can be used=er Python versionsI(e.g. by Django$8[m# 2} ifjmatter=r.setFor!$(f hif levelMILevel(logging._checkLevel(lC)) if filters:self.add_(result,. BKprop@for name, value in &.items()nrUtattri>mrreturn  @def handlers(, logger, re"""AddS to a0P fromaist ofQs."""khY :try4OH.config['JV'][h]:except Eion as eapraise VjError('Unable %r' % h)eArcommon__I, incremental=FalseZ)Perform 8@uratwhich is rroot and non- %s.L# =Xa.get('v', NoneA1if o1not <iC.setogging.2 M T#Remove any existinglK:[:]S-$r]Gh$A  !4%ifuK_C(W K C~"})K3ureDC\ure a0Pa dic9ary! =E@AgetL(PlC, ?B[agatea c!ifw50is % m}.G& =6db\ >*/erX *VR=P Class = Dict@or X((4"""-e us%HpMbure() r!listen(port=DEFAULT_LOGGING_CONFIG_PORT, verify=Start up a socket8 server on the specified port, and listen for new configurations. These will be sent as a file suitableGprocessing by CQ1()._`Return<Thread objectwhich you can call start() to ,O 8 join() when appropriate. TD(opCeHQstopL 0ing1Use/``verify`` argum2to  any bytes received across<AwireMfrom a client. If, it should`aSX1s aJ^&le-i*of_ dataJnetwork -r either ``None``,pindicat atyIpassed in c0not(ydiscarded, or@ str@iG#n b tot machinery asnormal. NoWtransformed`, e.g.decryptingK;s"in2"""bclass StreamHandler(sRequest!):WVBD`a logg " rI.w6It expectQcompletelyDGusespto insty"iteQdef hW(self * DEach3 is edgpbe a 4-z length, packed uIpstruct. (">L", n), follow4?Updi`grunt % 4D6trypconn = *. ecU '`hunk =n.recv(4)% if (c,n) == 4pM1slet'un<=[0]]9V7 wh4len < -1h+8' -r"ifR.^y@o| @2if 5is dB #iD .decode("utf-8"6Z im json  d =json.loads(chunk) $  assert isinstance(d, dict7 "Config(d*except EOion: #Apply new c[uration. 7 file = io.StringIO?try &[ -2traceback.print_exc(dif self.server.read +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 ', port=DEFAULT_LOGGING_CONFIG_PORT,pShandler=None, y Rverif 9".(3), d ;$._acquireLock.abort = 0>oreleas>`timeou@1@[" =2 = _until_stopped + im9ectc wh.Anot yxrd, wr, ex =W.select([._no()]L_[], [3ug _^if rd9|_reques&''.f3 m#J3 r_close()/$(t!. "):%ercvr, hdlr,P *bsuper(c,&f)V Y:W9cvrn! =u=1[5@EvenM def run(selWf):  server = self.rcvr(port= , handlerYhdlr,BM Rready0 1Sverif2 )d"ifZ == 0x._address[1]T1Z.set(qglobal _listener:logging._acquireLock@9BoreleasB_until_stopped() Mreturn S(ConfigSocketReceiver, btreamH , F$, hP def [LCing($1"""iStop the Bing  which was created with a call to21().IQ^V6try&ifu.abort = 1w q = Nonegfinall` # Copyright 2001-2016 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 #@ ORRCONNETr0THEIPERFORMAXF0. @AddiS$al s ^ packagePython. Th9%rePis baon PEP 28240coms@retocomp.lang.pO& e7(C)if0 To , simply 'im\ logging.handlers' and log away! """ import&ging, socket, os, pickle, struct, time, re from stat ?ST_DEV, ST_INOTMTIME_Tqueue threading2copy # # Some constants... # DEFAULT_TCP_LOGGING_PORT = 9020#/UD#1#=HTT$F2#?SOA#3 SYSLOG_hT= 514"" _MIDNIGHT = 24 * 60- # number of seconds in a day class BaseRotatingHandler(logS.File0): 6 ARfor h9s that rOe files at a certain point.NNot meant to be iiated directly. Instead, use Mor Timed nnamer = None:odef __init__(self,<, mode, encox=I, delay=FalsQrrors:6 Use the specified` Rqstreamea8D. =LP ,Ee)4Q.! =M q% =d !O  Cemitorecord}0Emi$.@ aOutput, cateringrollover as describedJcin doR#"()2tryWilf.should?,Hh"3except E:ionkEv(=}G@ion_-)default_ aModifyx=aDR whenY7ingThis is provided soa customW0cane* E#e Plemenpon call0e 'r' attribute"thCor, if it's< ab@pass8KiO5 toait. IfcUisn'tI( (A!is!),4OLs returned unchangedd:paramF: ThNqfile. ""3"  if not callable(self.namer):%,result = default_%"Oelse0R(;)<rreturn a def rotat, source, dest&""BWhen5Bing, e the current log.`4The implementations;'or' attribute ofHhandler, if it's>L, passing/A andP argurEs toLQit. I_pFisn' (J is None),dN0s s@y reAd to(F!inc:param : wA filA`. ThisunormallyOEbaseu;, e.g. 'test.log'1w1: w |Bo Awhat#is  E.1'.IOq# Issue 18940: AA may[have been created)PdelayIFTrueNif os.path.exists( u+2os.#  5 class RwingFileHT(Base2@ forggpo a set1 s, which switches from one1`next wEA rea<a certain sizC?__init__,b, mode='a', maxBytes=0, backupCount=0,bencoding=ohlay=False, errors7 BOpenpecifieduse it aqhstreamH$Bygrows indefely. You can soy particular`values.Qallowlto rollover atLa predeterminedR3aoccurseC2logis nearly5 inLalength&ris >= 1 system will successivelyL1newsas withPsame |,)R, but-extensionsO".1", ".2" etc. appendev pFor exak,Eaw5M(s pof "app@", you would getD,app.log.2", ... through to "app.log.5". The file being pwritten/is always9" - when it getsApled up,is closedNand renamedR@1",  ifCeb.'u2" etc.Oexist, tthey are`52",+.3Frespectively. ]If maxBytes is zero, rollover nefoccurs5"""@# If rotation/9is wanted#doesn't make senseuse anotherOPmode.Ufor example 'w' were 0ifiX if"remultipleOaruns o& calling applicW logs from previous 8xwould bPRlost v3is Z@beca0theU F truncat*# on eachpaiE> 0:!e = 'a'QBaseR ngHandler.__init__(self, , @, encoding= ,Neadelay=, errors=)Ar.V=a !backupCount = sdef doR) EDo a, as described in )a?1if fstreamc.( f = Non+W iQrange.1- 1, 0, -1yRsfn =_("%s.%d" % VQseFilJ, i)OdO&G_i + 1if os.path._s(sfnl,d,0os.remove((#F]sfn, (* 3&banz + ".1"qi9u bif not,Rv_open() sh  , recordYDetermine0H T@BasiQy, se2D sueOiKdKexceed the size limit we have. 5""" if self.stream is None:*# delay was set..O%D=R}_open()jmaxBytes > 0hp # arerolling over?Gnmsg = "%s\n" %oformat(recordv/).seek(0, 2) #due to non-posix-compliant Windows feature 4.tell() + len(msg) >:?return 10 class TimedRotatingFileHandler(Base)` for loggDto a file, rU'1log at certain t{intervals. If backupCount-> 0, when done, no more than8Ksakept -oldest onerdeletedkdef __init__(,Bnamed='h', 8=1,}1=0,encoding=,=False, utc at%EQrrors`.U'a',  Z =2, e/.=g.upper!=='Putc =  &2 = # Calculatge real6k0ichFAjustnumber ofLseconds betwes. Also=i suffix usedMaPoccurECurrent '/' events supportedsr# S - SUM - MinutesH - HourxD - DaypmidnighYRW{0-6} -)Eon a`day; 0Vonday: Case of1specifier`not imant; low!r ?F cas!# will work$2Lv == 'S'A!Q` = 1 # +Y-%m-%d_%H-%M-%S. extMatch = r"^\d{4}-\d{2_ (\.\w+)?$M-elM #60 miv}_\d{2}-\d{2}(\.\w+)?$" elif self.when == 'H':&interval = 60 *# one hour/suffix = "%Y-%m-%d_%HvW extMatch = r"^\d{4}-\d{2_ [D' orMIDNIGHTR* 24 ?day.startswith('W')3* 7Iweekqif len(j) != 2\raise ValueError("You must specify a day for fly rollover from 0 to 6 (0 is Monday): %s" %)[1] < '0K> '6qInvalid?ied dayOfWeek = intB:[1]/#4*see.compile, re.ASCII<o=*9># multiply by units requestedp# The fW wing line added because t!ilename passed in coul%' aMpath object (see Issue #27493), butTbaseFUwill be a stringQ#fiw6%`if os.z.exists(7 0t =*Fstat#[ST_MTIME]Q,el:Ptime.+() A+@uteR[qver(t) bLdef 1, currentTime&""Work outs  Ad on.xLPresulw" +P9# If we are+at midnight,Jalready known`# What^@needafigurepis WHENQV nextis. In other words,oif you Ayour?\ 1QR@want< tday clock at m idnight, not now. So, we # have to fudge the rolloverAt value in order'Ptrigg he first/T"atI} time. Aft72at,egular interval will take care ofQest. Notcis code doesn't9about leap seconds. :)Mif self.when == 'MIDNIGHT' or.startswith('W'):A:A# Th}Puld b0ne ,B les, but I wanted it>be clearM:utcfj2t =B gmI(currentTime)Oelse?_localB [@Houru9[3]aMinute!4!Su!5!1Day6a# r isnumber o left betweenB and+ exitationWa-[?Non#rotate_ts = _  J[8!((Tk .hBb* 60 +Qm; )* aE)) )x4- (s ")  Gl& Kif r < 0O1# R.SPbefor#e Q(for example k # AtMQ13:45!it14:15), %oion isHtomorrow.?r +J+ 1) % 7QPresul: + # If we H@ing L on a certain day, addZdays until|#`offset by 1 since}0jus Plcula|c SgYBday r. Ther@thre:ses`# Case*0TheRoday;-pase, doKhingM 2)zM`furthe/6(i.e., tl #2 (Wednesday)fop 6 (Sun"@. D+toQB nzsimply 6 - 2 - 1,Q353behind us8} is day 5 (Saturday) and rollover is on day 3 (Thursday). # yDays to?6 - 5 + 3, or 4. In this case, it's theSnumber ofs left iAe current week (1) pluK 5RKF3nexCPuntil-(3 The calculations described2D3) above need`have al addedFTis becauseB9timqp takes o midnightX day, i.e.PPstartN th xt if self.when.0swith('W'):]"=pDay # 06mMonday/i2 !=ddayOfWeekY].<-1daysToWait b - 6Oelse T+O + 1\CnewRMAresult + (X* (60 * O24))Kbif noty?utcstNow = t[-1]LDstAt.ime.localp()J tH!= dWd<: # DST kicksISbefor`, so wUdeduct an hournynd = -3600/ 4bows out ?add 1 +=N/ndo)= 5+rreturn & def should(, record1"""2 Determine if?Hr occur._-J&used, asare just comparing s, but it4eeded so}method signatures L6sam]@int(b.(ycif t >E}*At?0KgetFilesToDeleteMEf78d9 [RM(specific tha"earlier r, whichav glob.glob(). """ dirName, base  = os.path.split(self.Filename)=1fil4s5listdir(T(result = []<prefix =yF+ ".plen = len(+ODfor {5 in %s:^%if [:OR] == M *.2sufZ[3:%1if extMatch.m(@)Y4.append(`Djoin-,)!if>2) + dfptation_B  0- + P.strf M,2\O%ifexists(dfn`2os.eh< , H,Y"J > 0sZ0getsToDelete( s) if not self.delay: stream =&u_open()'newRolloverAt%tcompute(currentTime:jwhile @7<= , *=:+interval#If DST changes and midnight or weekly r, adjust for this.JAif (when == 'MIDNIGHT'I.startswith('W'))t2not:utcTdstAt+ = time.local (U)[-1]if dstNow != K f,0A: #kicks in befor'xt@so wed to deduct an hourbaddend = -3600#Pelse:(bows out?add QB +=  2 class WatchedFileHandler(logging.)1"""`2A h,`0Xa file, which w\Qs the<to see if it hasd4 leuse. This c@appecause ofF@usag  programs such asPasysloglogrotate_ch performD$ "3ionv , Anded}under Unix,B Qsince last emit!(A s deviceinode have..IF,d2oldVKalosed,  Pget a@ 7!. @ is |appropriYcWindows, beC8 rObe movedrenamed - XB4I s  exclusive lo- so"reQ needC%. Furthermore, ST_INO7t supported C ; stat always returns zero*po valueB0basn a suggestionp2 by Chad J#Schroederdef __init__,U> , mode='a', encoding=None, b=Falseaerrors+.z _M  E errors=errors) self.dev, ino = -1, -1$_statstream() Hdef B!):^"ifT5sres = os.fX(;.).fileno()2G[ST_DEV], FINO]reopenIfNeededj5"""R*P log Q if n5.N`Checksthe underlyin2has changed, and(%itahas, close >Bold ,`to getAscurrent6.r# Reducc ce of race conditions by z'by path onlyTa# onceQthen /our new f0we aAed a? # See issue #14632: Thanks to John Mulligan for problem reporD#Vpatch`:try`#HL0, cgexistenceG!1`.baseF6amepexcept NotFoundE` P6Nonh# comparejbsystemwith thatkM)VhandlG!ot1 or2 !=8dev:ino  is not ((# we hav$ean it up_; Vlush(U $4$ ! =" lIl21742: _ () might fail=m#6nq info from/fd  G^Aemit, recordcEmit a$/If spbefore wt%&thl&it=zSologging..H r.i class Socket)(=}"A "r <which writesxs, in picklekqmat, toaXsb. The kLVacros]Rcalls!Ifwpeer resets it attemptI@madeKUnnect on7Pnext NM@is s"is|onALogR! 'sg ribute dictionary (_%_dict__), so that the receiver does not need to have#logging module installed in order2yprocess5qevent. 6To unpicklYyrecord i enXto a LogR&A, us6JEmake function.2"""odef __init__(self, host, port):-1Initializehandler with a specificIP addr1andTHAWhenattribute *closeOnError* is set7True - ifapocket e$qoccurs,Ps!>ilently X d twreopened oEnextLBcall0"".H.C)IQ.P! = c! =!ifFNoneOQ R?els. (oR/0 = p 5r = FalsretryTime@#J# Exponen4 backoff parametersa4\Start = 1.0RMax = 30Factor = 2.0S timeout=11A fIy method which allows subclass qo defing preci/type of m`hey waM`1if #it PresulU.create_conne.2$, = [b(.AF_UNIX&.SOCK_STREAMUGC.sett( ':try< >except OS6I[() # Issue 19182Vs(rarreturn FjH=0Try/Oan eHaa max . ThanksWRobert Olson fororiginal patchH(SF #815911)has been sligh&"re&edRnow =(# Either!isS,4!ca%is#cQfirstZ# after a disG, or8 we've waited long enoughD< "attempt = Tru3e Uelse:attempt = (now >= self.retryTime).3if - B:tryWESsock QmakeSocket(S*.s = None # next time, no delay before tryingFexcept OSError#Creation failed, so set the ~l@ andIurn.`d+if 1 iso/dPeriodn]StartbIM `*mFactoraK ;>;?Max= =Maxr1R0 = j+o 9 dec0nd(6F, s)1"""# Send a pickled string toy2et.Q.This funcallows for partial sends which can happen whenRwpnetworkFbusy!^* .c#<!be` either because we haven't reached%ry#<} yet, o;8 Vried,Jbut are still unableovconnect  ) .Zall(s   #pragma:Ncove@o.closepbk # !weXcall RP}orecord*s) in binary mat with a length prefix,returns id: transmissRacrosgoRei = .exc_infofZif ei`# justg/raceback tHintoM&..~Tdummyrformat( # See issue #14436: If msgAargsobjects,My may not bq# availo0eiv"pend. So@bconvere % d#aZ`, savez!as%0zap74dic0.__&__d['msg']getMessag0d['(C4d['# Issue #25685: del!ete 'message' if present: redundant with 'msg' ed.pop(9u, None)s = pickle.dumps(d, 1len = struct.pack(">L", len(s))return s0A+ s adef handleError(self, record):#5""" H/P an e3 during logging.X5A"has occurred/ Most likely cause -k*connection lost. Close the socket so that we can retry on#Fnext event.0if .c]!On B andi -2(c ! =#!to\ EtimeJelselVu/r.wOemitaEmit a'rdPlsC writes it ttin binary formad IfDVre is., silently drop1 eHwas a problemJJre-establisheYS:trytqBmake(Q$fsend(sexcept E;ion[9elfXYwacquire0ock?&:ock^/ 6!?ock Elfinall`releas class Datagram !(SBA"r <cwhich Ss, invA, to3a duT The.V0is o Q LogR\"'sLttribute diH0(__E__),receiver does not need2havmodule installedPorderbprocesG1#RTo unv4 at0eiv enXFto a , "thEA funp__init__, host, portW0 Initializba specificIP addrT5 >.#self.closeOnError = False def makeSocket(self):5""" The factory method of 8Handler is here overridden to createIqa UDP sq (SOCK_DGRAM).#x0if P.portaFNonefamily =T.AF_UNIXN?els2EINET2sM(d,c5return sYAsendS?, sVSend a pickled string5akOThis function no longer allows for partial zs which can happen whhe networkXabusy -does not guarantee delivery andGZ0 paAPs outsequence ]|9c%()w;.Rto(s,#address) class SysLog(logging.k3A 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 redqchangesGhave been made# from ?# =2npriorities/facil  are encoded into a single 32-bit quantity, wMthe bottom 3 bitsIgpy (0-7) itop 28+K1big number). Both<S5iesO53mapJroughly one-to-oneJAs inMd(8) source 0. I@mappi62clu! t*#il#.a(these ordered)iLOG_EMERGrA = 0@ # 0temrunusabl2QALERT*1= 12a must be taken immediatel@2CRI?F = 2@ccal condi33ERR)3= 3 P# er0`WARNIN6= 40@warnB2`NOTICE+0= 5 normal but significantmBINFO72= 6 G0infB%al-@DEBUV = 7-debug-level messa5 # yBKERNB # kern el messages LOG_USER R = 1  # random user-lev:BMAIL12= 2 :mail systeme`DAEMON$0= 3 +&v daemonBAUTH%2= 4 .ecurity/authorization`SYSLOG80= 5m generated internally byElogd#LPF = 6Hqline pr<B sub6BNEWS-2= 7 network news6BUUCP-2= 8 6d"CRM9.SclockNM@PRIV,"10-O# sM (private)I#FT)*0# *N*0# SECURITY# Log auditVCONSOLE ))6ler)3SOL!3= 1# Scheduling# (Solaris) e# other codes throughCreserved for'!te6DQLOCAL\3= 1+D7PlocalP 6I3= 1+6U3= 1+6^3= 136k1= 2 x1= 26<1= 26<1= 26 {@prioG_names = { "aI ": fALERT,Bcrit; #2`workedNU set =`to they d   +=&>) k AOet.c6 d!iss#r didn't specify falling backEfail|  .* [ -,Cp ) I$raise def encodePriority(self, facility, pC): 5""" E>E the4E and7 . You can pass in strings orEintegers - if!1are59ed,``_namesfAmapping dictionari0re used to convertWEm toH.if isinstance(#7str%0 = P.[]g [,  [[[[ureturn << 3) | def closeuC!s7 socket)acquire()_6tryE(I|- logging.Handler.$6(ofinallY`releas;maplevelNamecMap a  . FPa keyyF mappThis is1ful2`wo sceos: when customd s Qbeing,Aphe case;Bre yep't do a7aightforwardCby lowercas(because of locale-Ispecific issues (see SF #1524081)@.1+Aget(], "warning")ident = '' # prependall messages ap0_nul = True # some old syslog daemons expect a NUL terminator;Aemit, record10EmiG$.@3The9 pformatt.ts"to^server. IfHPexcep2 inF0ionS0preB@, it@NOT KH 4msg`d(wAelf. E"V + ms#BG+= '\000'P?r# We neGe, maybe tEwill Ldchange]ffuture$r<%d>' %@,cC .y).('utf-8'(2# M is a string. Convert to bytes as required by RFC 5424  msg = msg.encode('utf-8')&`prio +- if self.unixsocket: n>try:6.send(msg|&except OSErrorJnclose(HLr_connect_(address; $el'type == et.SOCK_DGRAM}( to ,ZOelseH0allIKER:ionCahandlek(record) class SMTPHr(logging.)J1""""A G"r :`which As anI email for each Qq event.FNdef __init__ , <host, from#@, tos, subject,Ecredentials=NonecCcure timeout=5.0: 0Ini>tize the%. k !instance with3@ and0ess$ndKqline 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!0ailD~3(V0lf.Q B , vH hame, self.password = credentials Uelse:self.username = None!fromaddr = !if isinstance(to(zs, str)gC = [ ]Ef3 = subject = @ecurs `timeou<  def getSZ(, record1""".,Determine theA forbemail.\. If you want to specify a9lJwhich isz`-depen,wpoverridvis method.preturn .()OemitcEmit aaFormat& and send i@ied oessees:try#import smtplibGx `message .EuM 3 5VutilsSl=+D A`f not  >.SMTP_PORTB%.pQhost,^#, = )Khmsg = (!['From']s5 IA['To&','.joinwW"46 5ADate2`.local.set_conten!.fp(b c"if"a,[.ehlo starttls(*\ ,0P4log{,"pa Y5n_O(msg#Gquitexcept E:ionhandleErrorn class NTEventLogH%r(logging.*"A M"r @0s eJs )1NT [ Log. Adds aregistry en^?Ypplication 0. I@ dll" i provided, win32service.pyd (nains some basic \placeholders)Bused. Notat use of8se . will makKByour logs big, as94irexp sourcemqheld in%2logETslimmer logs, you have 'to pass in the name of your own DLL which contains,message definitions8 want to useWevent log.M1"""`def __=__(self, appP, dll `=None,;type="Applican1"):Flogging.Handler.V)'6try48import win32evtlogutil,=0.$ =#x_welu =HY )dif not l = os.path.split).a.__file__9=?[0]4Vjoin(3A, r'+service.pyd'H!2$ = #0log$ =#AddSourceToRegistry(% #efi.EVENTLOG_ERROR_TYPE8ymap = {`qDEBUG :_INFORMATIONe,I*YI.WARNING C CRITICALC}except IZError!print("The Python Wq extensfor NT (", %"\ep")1earto be available."e0 =  _BgetM$!ID, record RRetur\0ID A1. I are usingzrzJC s, could do this by hav7Z1msg ed5theHPer be+an ID rather than a@matt0str` Then,Fhere3youPa dicary lookup|9get[ID. This0ver! r+Cs 1,iSbase "in&|Q) 1ECategoryc=)gOverrideiCpspecifyP2ies !?s 0n 0 def getEventType(self, record): 5""" Return the e8 type for;%. /Override this if you want to specifyQr ownL@s. T,version doesOa mapping ushandler's?map attribute, which is set up inL__init__()a dictionary6containstsDEBUG, INFO,LWARNING, ERROR and CRITICAL. I3are2you`levelsU willOeither needoE method or place a suitable% .wr.map.get(Ano, !0def$)def emitOcEmit as8Determin9e message ID,vcategoryk<e1log@i#NTF?log"ifV_welu :tryBid =2BgetM#ID-)a+7cat0C4a 5Te4msg0Tforma*b.Repor.appname, id, cat,fz, [msg]Kexcept E>ion'iUError"8BclosPCleanQLr9You can remov>papplica Q from`registF1s asource of& entries. However,!do,qnot be e2s aintended  E LogViewer - itsXjaccess toG1DLL#:SSFromR% 20loglogging.H. class HTTP(/"A 2Ssends*a Web ser:aGET orPOST semanticsar, host, url, i`="GET" cure=False, credentials=None B?1ext| 0IniC"izinstance withrequest URL,O(""ulogging.Handler.__init__(self) method = v.upper( #if not in ["GET", "POST"]:JQraise ValueError("W must be GET or < e^secure and context isxONonej 3 parameter only makes sense " b"with f=True"6.host = Jurl = url] h# =q credentials =  ''=1 def mapLogRecord1, r )I&"" Default implementation oJping the logG into a dictuK1thaqsent as3CGI data. OverwriteHyour class.? Contributed by Franz Glasner&creturn0.__&__getConnec,v get a HTTP[S]A.Yride when a custommrequired, for exa\5 ifPthere*a proxyimport http.clienq#ifc8.S( ;= ;els}_ ^H=NCemit 0Emi$ASendm1 toWeb servera percent-encodedeionary]:tryWurllib.parse9wN!lf,  42lf.1SZ_UvB.urlN.)`A4lf.!=  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 i2ostO'":j`Aif i`0=I[:i]V@# SeOsue #30904: putrequest call above already adds this header # on Python 3.x.Rh.put7("Host", host)( if self.method == "POST":&v PContent-type",,0"application/x-www-form-urlencoded"9mlength", str(len(data))>credentialsimport base64s = ('%s:%s' % O").('utf-8'A'Basic ' +gC.b649s).strip().de('asciiK 'AuthorizLJ', s{Rh.end*s(Asend[ 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 #0 isQed toJ, a check @madegsee if& should be flushed. If it,.n ()Mbexpectpdo what's needed def __init__(D, capacity. 0Ini#0izew)R sizek5A?y.1.% =!nQ= [] 2F,Sa hC its?]Returns truPis up0. TCacan beIoverridden3implement customstrategiesPr C) >="OemitcEmit a.@aAppend3[x) tells us toU"ll ()uprocess !.a})L"()/Obehaviour.version just zape__emptyacquire() try: self.buffer.clear() ofinall1release() -def close(O)b1"""!nC! the handler.=This version just flushes and chains to>parent class'w%).gs[ logging.H! |s Memory!!(BD3ingAr which y#s n records in m^, periodic0ing ma targetb0. F=#occurs whenever3tKis full, or$` an ev^of a certain s<0ity'greater is seenx__init__ , capacity,cLevel=s.ERROR,a=None,!On?S=TrueZ!y InitializeeQ withla size,l2 atyp=qshould Dan optional0NotyOuithout !beOet either hereMvia setT&()a]nano usehnyone!>Ae ``(`` argumPis ``8`` for backward compatibilityreasons -$old behaviou th1hene"isdZLsg1ed,_1 if> hasn't been exceeded noPM"r. To prPthis,P to ``False``2> ..' =%=5# See Issue #26559@why B hasUadded7Ty{aBQChecka-}por highSWreturn (lenkQ) >= )h\H(.%%no7K[X1Set"}`p.acquirpb _CKFor 7, flushing means just sending the buffered records to target, ifre is one. Overrideyou wantE!diVnt behaviour. BThe gUalso cleared by thjperation.=5""" self.acquire()Etry: 1if +  4for"in++/L.handle('+L.kfinall1`releasdef close() QFlushappropriately configured, set None and _qlaf0OnCNO.#E |Z = BAingH'r.R -Be class QueueU(logging.<T2rqs eventn0a qJp. Typic , it would be used togetherwith a multiprocesscentralise pfile in 6N4(inM-q applicr), so aQvoid IPwritee0tenKtbetween_#es co5Ps newPython 3.2, bu2is Z0cancopy pasted intocQuser KAuse earlier Vversions?=Q__init__T,|,RInitiHan instance, uoF0pasc8D.8dG" =7!enrfnE+# a}base implement_s put_nowait. You may8"ovhmethod, blocking, timeouts or custom .y&bprepar+,P+s' Le *object returnsxdkPformato merge message[@argu!s,removes unpickleabtems fromG" in-place. You might want to override this method if you$uconvertFthe recordBa dict or JSON string,send a modified copyE7of Hwhile leavingoriginal intact.95""" # The format operation gets traceback textGoP.exc_H!(ire's excepIdata), a ls@Qturnsv7tedFmessage. We can(Cn us^tA @sg + args, ag#sebe unpickleablca0zapOFAinfo attribute\y are no longerB`needed@,  not None, will typically 7be Emsg = self.*(3)"# bpo-35726: make!3 of]void affectother handlers icf chain"i! =P.v |#.e = msg! = 4n{ Xdef emit(C,%):qcEmit a$QWriteGU LogRyqueue, prepa0 itIkOfirsw6try[1.enT.Xey]$ EdITError@ class QListener(objectT.implements an erSPthrealI which watchesh5@s be ad6Qto a 2movdm0T pass)Ihrb processing_sentineldC__init__c,*Vcspect__level=False%i Initialise"stance withV P<fsZ5=9>% = !_`= re ? = Q!de@_blockD*V1 reQit, o!GUbase uQget. %aydO QpimeoutshBworkcustom queue implementations. 5""" return self.queue.get(block) &def start(%!):JGS! the listener.>)BThisCs up a background thread to monitorEE formLogRecords,oproces#._YS= t =fQing.Tp(target=+z)mt.daemon = True qprepare1, r$P+# a'` handl /method just spassed-inE. You may want tooverride tPif you neetdo any custom marshal {qmanipulF1 of before Ping i /erf5KH6eJ l6@loop4Yrough` offerAthem<"toe5" =7DF3forF3r ic&rsF!bif notNrespect_*j_level/3 Oelse1 .YTno >=L3if jR.(W_XMs, and askgto deal witmruns on a sate, internal Th0will terminate ifAseesJntinel objectM!q.$dhas_task_done sattr(q, ''TQwhile :tryy!de{(Q(#ifv 2_seY1 &*%q.(y"Ubreak]?if qexcept _.EmptG!en. Ris usp<_x e base impFs put_nowait ide this  .method if you want to use timeouts or work with custom queue Aimplementations.5""" Qself.8.put_nowait(_sentinel) /def stop!):hOStop the listener.<(This asks!`threadterminate, and n qs for iVdo soNote that#don't call tg`before>r applicp exits,dr)may be some records still left on0], which wpbe processedI!enaP%()< _ _.joinV = None """wsgiref -- a WSGI (PEP 3333) Reference Library Current Contents: * util -- Miscellaneousaful func3wrappers * headers|PManag0dsponse&Candl'base classeserver/gateway ?s_)k"a  BaseHTTPSDsupports ?validate: Cion 5its between an#"a v detect errors in either To-DoHDcgi_a-- RunQs under Cpending a deploy standard)JJ:4appI*`routermiddleware compon hs URL traversalGP from .u@ imzb FileW% , guess_scheme, is_hop_by;D>HS# `sys, oime __all__ = [5'Har', 'S- 7CGID8IIS '_environ' ] # Weekdaymonth nam d/ matting; always English! _wH="Mon", "Tue0Wed0Thu0Fri1Sataun"] _}?, # Dummy so we can0 1-m!d 1P numbz1"Ja0Febc0Mar!Ap0MayQJun",)8 ul0Aug0Sep!Oc0NovpDec"] 'pformat_#_#(Sstamp8Ryear,, day, hh, mm, ss, wd, y, z =0.gm@E return "%s, %02d %3s %4d : GMT" % (5C[wd]j[C2], C) _is_request = {'SCRIPT_NAMEPATH_INFO QUERY_STRING REQUEST_METHOD', 'AUTH_TYPE', 'CONTENT_TYPE',`LENGTHPHTTPS REMOTE_USER!IDENT', }.__contains__ def _needs_transcode(k):wreturn _is_request(k) or k.startswith('{/_'0SSL\MJor (<REDIRECT(?andb[9:]))read_environ("""Read ment, fixing variables"""enc = sys.getfilesystemencoding()&s&'surrogateescape'2try"1''.;e('utf-8', escExcept LookupError8eacreplacYa = {} k# Take the basic from native-uniC os.F. Attempt toLafix upN that comePk90 topensate forM)tbytes->}"deD@ stegat will aly have taken .KfSh, v inTitemsjiE!# On win32,3 is-Bly U/. Different serversN0 uscd?Bings!ifkplatform == '' (software =get('SERVER_SOFTWAR').lower()+B2IIS 2be d as UTF-8 IlongP#PinputFsa valid8snce. Otherwise i(Ju=U} page (mbcs), ]t no way# detect this happened. Because!is more likely , 1inhly unrelIQ (an "Ostri1S hays to be20not!asT8# always recre7original  |?W Pmicroqc-iis/'N2[v = v").('iso-8859-1'Apache mod_cgi writes5-as(as if ISON) direct!to@. Nogification .ed/ela OpasshPython 3's http.F@.CGIvRstHandlert co#Nthe urllib.unquote default of UTF-8, amongst other # issues.melif (@software.startswith('simplehttp/')7and 'python/3' in I /-):y v = v.encode('utf-8').deiso-8859-1') @R# For servers, guess that they have written bytes toKthe environ using stdio3 -oriented interfaces, end'/upNA system _ page/seenc, 'replace## Recovers from uni,urrogate escapes# where available (Pj 3.1+)/el ?esc 0[k]&dreturn class BaseHandlerL"""ManageinvocationGa WSGI appli2"""_# Configur.parameters; can Oride per-sub~!orinstancePwsgi_ub= (1,0Dmultithread = Tru5@proc run_once = Falserorigin_Q^# We are transmittdirect to cl = "1.0" # VersT should be used for respons_p = NoneG0Str}@name)0, if anyS# os_2 islto supply c$OSBmentE# byCit's a copyC'os.e@' asimport time, but you##@this@e.g.$r __init__ method = (ollaborator N|'file_wrapperCileW!sed`to disheaders_UB = H8`# musta R-likepError h_Q(alsotraceback_limit Print enti'self.get_stderr(Jep_statusP500 IQnal S "/ = [('Content-Type','text/plain')]4body = b"AQ L occurred. Please taEhe administ.J StP@varis (don't m "seresult = None headers_sent = False b = NonEbyte*!0 ' def run(self, application): K"""Invoke the$5"""%# Note to K: don't mov6close()! Asynchronous servers shouldn'tPScall 8 from finish_responO, so if you*anywhere buNdouble-error branch +,A'll break a'byprematurelyxCing.must return'h)' witho0ingt might stie output\iterate over.6try.setup_environ().!Presul6 .5,e.startvI lexcept (ConnecXAbortedE, BrokenPipe)QReset# We expect0cli!toop abruptly2tim J#WO e v8zqhandle_h y I8# If we get an ; H0, jVgive up already!JVeraise # ...and leIcactual figure it&. / Xk`"""SetqHmfor one request<Renv =m3$osW.copyy.add_cgi_vars()env['wsgi.input']fget_stdi4~s5 47err54ion65_run_once656url_schem86multithread'] `n`procesn9}"if#file_wrapper is not G0)']nrorigin_R "_softwarew' default('SERVER_SOFTWARE',C)  0 qnd any ble data,n53' Subclasses intended for use in asynchronous servers will -want to redefine this method, such that it sets up callbacksEin the event loopRiterate overdata, andE@'self.close()' once respons finished.65""" Etry: Pif nolf.result_is_file() orBsend AE@for KJ)-!`write(4)!_content(&jexcept[s# Call " ogY blturned byaWSGI application#case of an p6ionQif hasattr(1, '*')2' yUraiseJelseD# We onlyYvwhen noA is Ld, becautY# status,Cult, headersenviron fieldsJNone # See bpo-29183 more details.#A() def get_schemeN>P"""ReBURL ( being usedr,XguessR.u4set`_length}Compute C!-L)@swito chunked encodif possible }blocks = len|  (TypeError,AttributNotImplemented#>6pasW2if :==1q=*['d'] = sbytes_sentB# XXX Try->corigin 0cli5gis 1.1:cleanup_F"""Make any necessary changesdefaultsSubclasses c teto add other :=4,( must be at least 4 characters"Ef[:3].isdigit()t messageTgin w/3-(_ codeP3]==" "Jhave a space afterMif __debug__for name, val in \ &;&b !#, UeBf6valD_valueEmis_hop_by(5),\rf"Hop-by-hop@, '{6}: {val}',allowed"breturnRwriteOdef Uue, title)TB"""C`/check}0ue 6.""!if( )6strG"7D"{0}" og str (got {1})".format(c, repr<send_preamble( Transmit version/,/date/server, viac_d+()W.origin_4 client_is_modern(Lh('HTTP/%s %s\r\n' % c.http_,3P)).en('iso-8859-1')cif 'Date'YiCg3g (V:_Q`_time(./()^s_software and 'S$(?kn Jelse FE"('f ]Rg, dataNB"""')' callable as specified by PEP 3333V(Vbytes, \ "write() argument must be a bytes instance" if not self.status:#raise AssertionError(j before start_response()")a(elcheaders_senti2# BMthe first output, send sstored E \ = len(data)# make sure we know content-lengthNw_l%() Jelse |+} # XXX check C{L{ aruncate if too manyEten?q_e flush() }1defCPfile(;)"""Platform-specific ) transmissionHH Override this method in subclasses to support p[ c. It is only called he applica%'sCreturn iterable ('.result')L%an5 of:)Pwsgi__wrapper'.Tsshould pa true valuqit was to actuallymHtjdb-like object using a2approach) Gfalsbnormal78Pbe usanstead. An excep.@ can7d0indeHIthat#ttempted, but failedVYNOTE:;  v<' i'DiB goLv direct1 of."5""" Fan # No by defaultsfinish_u!En- have both beentaO[LzeroAAt bysE (so!# HEAD requests3satisfied properlyve #3839DGC.set3*('o', "0"; )Xpass ~+ifubshort?7Oclos4C)Eaeeded)reset allBvars\S3may wantkalso drop_0cli`connec  try:  if hasattr(self.result,'close'): , &.%%()$zfinally511 = theadersUstatuenviron = None\}=bytes_sent = 0;RqFalse =def send_v"""Transmit # to the client, viag_write()"""\ucleanupdX6Trubif not`origin_server or_is_modern(preamble!?.'))*lAfile(n,que if '/' is an instance o Pwsgi_J_wrapper';  -dtreturn 0!is3 t and isz/ K+ can accept r;Q.['SERVER_PROTOCOL'].u() != 'HTTP/0.9'`log_exp1ion,exc_info1Log'' tuple inE2log Subclasses may overrideretarget<`outputchange its format.+tr from traceback import printKdstderr Bget_  C(DHU[0], 1 =2],7_limit, -n!g.flush Whandle_erro@curr$,  #topossible b4ys.&()_,start_responseqNefinish"V# XXX else: attempt advsPd recy techniqueP HTMLRtext? t #,  """WSGI mini-app9icreatefpBy defaS this just ua'Y3', p'tPbody'pributesPgener$an page. It be ov.erridden in a subclass to dynamically generate diagnostics, choose an appropri+!message for the user's preferred language, etc. ONote, however, that it's not recommended fromecurity perspective toPspit outqany oldP; ide, you should haJ' dMomething k0ialJXenablo put, which is why we don't`includ:uy here!5""" start_response(self.error_status, headers[:],sys.exc_info())Oreturn [6bbody] # Pure abstract ods; *must* be ov64"esAdef _writu,data):B"""O@et>Gpbuffer 16@sendbclient^sI okay if thisP actu transmitszQ; BaseHandlerjust sepa!s and flush opAionsgreater efficiencyIAwhenlqunderly!Vystemhas such a distinction.Draise NotImplementedEd_`force U ofLSent '0)' i is a no-op (i.e.,Hv&get_stdinAsuit'wsgi.input's?err.sadd_cgi_varsinsert CGI varis}'onviron " SiQ(]3"""1's m initialized with streams, eThitor synchronous HTTP/1.0 origin serverNs tentire f3givcorrect :sU"::3\Jr = ! %inp,out,err,env, multithread=Falseprocess=TrueBm.run(app)' _l!__(,6out,stderr,envicron, multithread=True, process=False-!):7self.stdin =  2out=out2err:errbase_env = environ Qwsgi_" =,- /def get_(preturn  4?err5 jadd_cgi_vars8fq.update#.)~C_wriY,data1sul}Bout./*Qif re,is None orq== len(16Efrom warnings import"("SimpleHandlerL ) should not do partial &s"DeprecationWv)jPhile  0 = [%:]5U"if|:ata:Ybreak/Db.Ya_flush0std!7 a* class BaseCGIQ(_"):)"""CGI-like systems using input/outerror streams and{ mappingNcUsage:[h, =inp,out,err,env2.run(appSThis  i eful for gateway protocols ReadyExecs FastCGI, that have usable $an2men. It's also the , which just uses0syssin, os.,r so on.]The constructoroakes keyword argu7s ''Kjp' (defapng to '-! ''pectively)$qcontrolNconfigurnP sent&Rappli! sets 'origin_server' toKoq (to en)rassumes'(_once' iNK.V2"""; u1 = $((3 %bd invo@ via5/$ z) e difference between t b # iit alwayi .#of,multithread' oHf 'False', and 'wsgi.multiprocess' of 'True'. It does not take any initialization H$parameters, but always uses 'sys.stdin', 'os.enviroand friends. If you need to overridexof these nuse BaseCGIHandlerHinstead. 2"""^_run_once = "A# Dofallow leak between requests in Google App EngineLaother Z-run CGI cases. This iZeasily testable# See http://bugs.python.org/issue7250r3os_TR = {}def __init__(self):- 1.'!%4%, u.buffer=7)Lpor meta .ForScriptMappings82<7)@G6# By default,gives a PATH_INFO that duplicatesSCRIPT_NAME at#front, causproblems for WSGI apI0ionKpat wishximplemenOrouting.<Qtrips!FsuchdX#0can|"urdpcthe correctt#es"an0bug"re3TRANSLATED0wroALuckF@vari$ iKbrarelyj7pguarant!by(@. On<7, thoughr0set @only made on a vhost level, affec-Ball sHmO`, manywhich br@expoi!to2buga# For ASreaso0almSneverC"edfix. (Eve37.qs it be reUstill no UIaBit.)R# The%ano way @coden@tellwas set, so a se4te is providey  = %b#= 'a.get('iJ' , .SCRIPT_NAME', ''3) if (path+'/').startswith(script:.5environ['PATH_INFO'] = EC[len95):]6 BaseCGIHandler.__init__(!Wself, sys.stdin.buffer@,;:\\"/\[\]\?=]') def _format[(,^a=None,Be=1)"""Conveni@func60 to1mat?return a key=q pair. TBwill\r if needed or  tr1"""E$if4`s not |)sR) > 09#ifo5or -.search(1-1" =g.replace('\\', '\\\\')"', r'\"'D '%s="%s"' %3ramd.Jelse</%s: 62 classk\ra colle"ofrhmn)]P#&4 = &if & [if type(7)Blist_raise TypeError("N must be a 55Rname/vtuples"r#._ogif __debug__for k, v@ !?_c-rt_string_k)-"v)5N;Nrt/checkb.uv$t6strG#V"AAssen  vswsP"  str (got {0})".S(repr)p_len__(tB"""Rr%total numberg, includOduplicates Bb ssetitem, name, val):  """Set the value of a header.""" %del self[name]"._0s.append(9(#convert_string_type(K!),W/._!qval))) Pdef __delitem__W,B: l """Delete all occurrences, if present.\<Does *not* raise an exception3$ is missing.| / =!.lower())7*ds[:] = [kv for kv inQ!Tkv[0]I@ != Y]1?get1 GSfirst y'R'R'Return None insteadvL9ingNvNote thatMJared multiple times,exactly whichDq gets r edundefined. Use!all() to 5Hqs matchQfieldlu2getDcontainsL)i5truimessage >  1not @get_|,`a listZ$'!d These will be sortnPorder %y iciginalpr were addedAthissance, and may& duplicates. AnyN1s d2d8qre-inseadQlwaysnneRIf no@s ex/@witha given^,sKmptyGuUH o[kv[1]? ==o]g,default= CC, or# 'L'0.k,MDif k( $7v!Akeys ,s$Kl%nstance, and may contain duplicates. Any fields deleted and re-inserre always appended to the headerMFlist[5""" return [k for k, v in self._E1s] .def values(!):B"""RG a js of all5.F0These will be so!inPorder y@aredtoriginaXsp, or wedis instance,=t|vtOitems1Getf0(uDq'[:__repr__"%s(%r)" % ".__class__.__name__,4)4O__st["""str() ds0matps, comp with end line,suitable< direct HTTP transmission.'\r\n'.join(["%s: %sk +['','']_bytes;x).encode('iso-8859-1'Hsetdefaultb,V,ifirst matchingj '@''F' Iflre is no<1$d 8add a new~$#m i lbsult =@get(D)>Qif re#vis NoneV:.(!._convert^ing_type]CG1&))/;els'_3add:!, "1, _l, **_params2Ext settingH  add. keyword arguments cane"us5setpadditioRQeters> a,}underscores~%edOto dashes. Normallyi ] will be add ed as key="value" unless  is None, in which case only theA will be added. BExample:6h.add_header('content-disposition', 'attachment', filename='bud.gif')ONote that ik !e corresponding 'email.message' method, this doe*not* handle '(charset, language, )' tuples: alls must bestrings or?.5""" parts = []Aif _gy1not>: = self._convert_rb_type(#)7m}.append!for k, v_params.items()}/k x ks ifRA G k.replace('_:-')LNelseDv vC uq_format(7, vosI(), "; ".join())) """BaseHTTPServeri.s[Python WSGI protocol (PEP 3333) Tis both an epr of how90can[ed, and a basis running s& web applicas on a local machi@suchA@migh done when testOor debugg(anT. It has been reviewed security issues, howeverwe strongly recommendCyou use a "real"sdfor produc'e. For8u#B, seI'_ __=="__main__"' block at| of  module. See also %B doc~other API in@ion.$ from http.eimportSRequestH6r, R *4sys urllib.pZwsgiref.3rs 5S V+@plat#p_)+ __version__ = "0.2" __all [' demo_app Rmake_R'] ecDRW/" + G sys*a() + ":Csys..split()[0] softwareJ + ' ' + o class J(X)Nh sdef closet:tryr_.log_request(  self.status.split(' ',1)[0], bytes_sent 9)finally:'SimpleHandler.close(O ) class WSGIServer(HTTP 1): Hv"""Basea that Vments the PythonJ protocol"""Capplication = NoneQdef sxR_bind"""Override' to storey@` name.q.#c%.setup_environ(),)# Set up base >]Senv =4asebX = {}%['SERVER_NAME']4 .GATEWAY_INTERFAC4'CGI/1.1'-[BPORT[!trgFportAenv['REMOTE_HOST']='QCONTENT_LENGTH!fSCRIPT&''Rqget_appLbreturn+,8s8,"D.7 =  sRequest( Bvers"/s/" + __&__ \.Ck.copy(rROTOCOL0rrSOFTWAR''w5REQUEST_METHODjucommandbif '?' iFpath\d,query?MOelse>,MaPATH_INFOurllib.parse.unquote(w, 'iso-8859-1'^QUERY_STRINGGiDhostaddress_string1if (!sclient_0:[0] j! =AAADDR [iQlf.headers.get('content-type') is7TYP.L_K_KP []dlengthr#2if # =,sfor k, vvgitems(hk=k.replace('-','_').upper(); v=v.p!6if k in env:  continue p# skip #ent length, type,etc. + if 'HTTP_'+k in env:!-Eenv[&] += ','+v # comma-separate multiple headersNOelse`5= v5Qretur def get_stderr(self)Q.Bsys.!5lhandle1A"""H a single  request"""BlS.raw_rline = file.readq(65537): if| A@) > .62URU = ''P "_version&/ndsend_error(414ePbif notTparse (): # An I code has been sent, just exit br = Server)r(5s,w )environ(),K thf=False ._) # backpointer for loggingo6B.run s.app()) Pdemo_,start_responsefrom io import StringIOp`stdoutF(print("Hello world!", >=3' hcorted(`.items0k,vHhtk,'=',repr(v)s ("200 OK", [('Content-Type','text/plain; cht=utf-8')]V" [bvalue().en!("03")]rRmake_k`host, YP, appI_class=WSGI#, R """Create a new D s listening on `|p` and ``NP`app`i7} ((9)7A.set^2app/ if __name__ == '__main__'Xwith 2'', 8000, ) as httpd32a =p.socket j(0"`on", sa[0], "1B...">webbrowserp.open('://local;:/xyz?abc'S("d.2D one1b, then"""Miscellaneous-related Utilities posixpath __all__ = [ 'Fi leWrapper', 'guess_schemeapplication_urirrequest 'shift_path_info&setup_testing_defaults', ] class Fi{:H3""" to convert file-like objectsiterables""" =def __init__(self,:9, blksize=8192)m'.`&% =1Q!=$ =Gif hasattr(F,'close'fIg.tgetitem7keyHimport warnings. (w"dU's __a method ignores 'key' parameter. "IAUse utor protocol instead.",.RDepre6W stacklevel=29) ydata = Q.read.00if 3areturnYraise IndexError{xtF-4nexg-HPStopI (environB"""R!a ' for whether 'wsgi.url should be 'http' or !s'@iX3if i.get("HTTPS") in ('yes','on','1GZPFelse!' {Gthe , 's base URI (no PATH_INFOQUERY_STRING)Turl =[b]+'://from urllib.parRquote" !'!X_HOSTt+u%]n  .SERVER_NAME']v 4 ==w 6YPORT'] != '443'04V':' +: >, ")['4r/80q$r3r'SCRIPT5) '/', encoding='latin1'W2urlV, include_query=True|Sfull A@, opCallyD@ing +Jz stringz t = quote(environ.:get('PATH_INFO',''), safe='/;=,', encoding='latin1') if not environ.gHSCRIPT_NAME'):'+url += path_info[1:]Oelse'#if include_query anduQUERY_STRINGvT'?' +2)['.return url def shift_"(e@"""S! a name from AG to ", ]qing it If there are no remain"s segments inWHa None.GsNote: '' is modified in-place; use a copyyou needAkeepIthe originalr8 or.u7whezjust a '/', thisAs ''appends a trailing{0'/' 1even though empty86rmally ignored,NK doesn't no. en@. TiitentionalHbehavior,ensure that an applica. can tell difference betweenL2'/xa'/x/' :ptraversto objects1"""7 +$ =bi,3Q|4$gparts .split('/&[1:-1] = [p for p Aif pp != '.'Wgt"[11del_sscript_7 0Pposix. (!P+'/'+Z.Awith?#7 = [|Z)Z +=7(['Tx)A] K`.join(a)\# Special cas:X/.' o0get strippZ`# becaLPwe doU!last ele6 ofC#x's only one  left. Instead@1fix3hisBabove, we fix it ?"soS gets!izAnKbeZ&ame=='.'=CS-etup_testing_defaults4gUpdateqP triv8fM purposesadds various@`ameteroaquired@SWSGI,6JHTTP_HOST'SERVER_NAME, SjERVER_PORT, REQUEST_METHOD, SCRIPT_NAME, PATH_INFO, and all of the wsgi.* variables. It only supplies default valuesGdoes not replace any existing sets for thesef This routine is intended to make it easierEunit testsAWSGIFrserverspplicationsF set up dummy environmentsshould *not*Lbe used by actual g cGor abp, sinceP dataQfake!L2"""xC.setK2('S','127.0.0.1');2PROTOCOL','HTTP/1.0')h$s_HOST',U[|]q Vd','GETkGif 'f ' $inc'z : 3','-d4,'/V(ion', (1,0).run_once', 0+ multithread.rprocess/from io import StringIO, BytesIO%einput'-( Perrorh2url_scheme',guess()$if!['I9]=='http' P', '8l]s^0443: _hoppish = {mp'connecOkeep-aliv'proxy-authentu"e'Aoriz?t7atrailez'transfer-encodingBupgrade' }.__contains__ def is0_by(header_name)U"""Return true %'0an /1.1 "Hop-by-Hop" )orGhl`.lower4# (c) 2005 Ian Bickiributors; writtenpPaste ( ://pythonp.org) # LicenAundeAb MIT l#: :www.opensource=/#cs/mit- .php # AlsoCFced ZdApachetU, 2.0b^a432.0\cto PSF^ca Cont` Agree bMiddlewareQcheckaobedieYo\pecification.  Some of the thingss checks: * Signatur(Bapplication and start_response (including that keyword arguments are not used).fpEnviron}H - is a dic{ary (and Ha subclassN7That allrequired}!inev: REQUEST_METHOD, SERVER_NAME, PORT, wsgi.versionSinput berrorsE+multithread#sprocessrun_once HTTP_CONTENT_TYPEt tLENGTH U (these headers should appear as dN!ndC{]Warns if QUERY_STRING is missing,PScgi module actsQPunpreQably at case.CGI-style variables at don't contain a .) have\(non-unicode) strgvalues\ha tuplu"url_scheme%'http' or ps' (@@:this too revrctive?)t. e?RknownQAprobR)"aSCRIPTPATH_INFO Pemptyr with /t least onN:or M8setz*@posi integer0\!ist'/' (itkbe '',V )/'r0 hae methods dQline, sbQ__iter__Q Rflush, writeQ0The0tusav,`space,&2rts$an*$-Jin range (> 100!* H}`list (I ,h another kind of sequencePTitems ]RBngs. atBrno 'status'`0is CGI, butin WSGIy 1newncolons, endV_t-, or r charact s below 037Content-TypPgiven/bent (CGI oftena defaul#BtypeA doe?no r1wheIw^ ` \exc_infoc2 too*tuple or None. < * That all calls to the writer are with strings, and no other methods on7accessed. ewsgi.input is used properly: - .read()"ed}exactly one argument1it returns aSdline,  __#__=:s;b.close1not""ed!N+`provid#X`errorsk!()Z. sw e response CatorZ0is | (it should be a list ofzSingleGs; a  will work, but perform horribly).Uu.__next__()\ed over until start_ hac been0 (tcan signal eiPa serJor application .(doesn't raise excepB, only printsRsys.stderr, because we*`know i8N^AwhenvaobjectEis garbage collected). """ __all__ = ['valid'] imporE 4sys @warn header_re = re.compile(r'^[a-zA-Z]0-9\-_]*$') bad_9_value? [\000-\037]') class WSGIW{(!):ZRSFd in!to8-spec-relatBF= def assert_(cond, *args`!ifqmA5@ionE(6 Pbcheck_&a_type(v, title[ 7strf :w"{0} must1of \str (got {1})".g1at(#pr}")) () /jWj e tw=am#)+R, thi{rmiddlewRo2B forGOPlianc a numberZqlevels.WThis J`amodifyPrequerain anyC2wayb:an 0 if1thing seems off@(a failure7Wq, whichCz"be ed=0 --A0re'v@ wayz1at bpoint) clint_app, **kw): asse rt_(len(args) == 2, "Two arguments required") @asse:not kw, "No keyword9Yallow8 environ, start_response =6%s `ccheck_.() # We use this to 1 if the application returns withoutb# calling:" _ved = [];defA_wrapper(*Sv, **kw)VA> xI or E3, (8"Invalid number of;: %s" % 6,)):v<cstatus9[0]eheader1+if ^exc_info`2BOelse5 FNoneRBtus( !(#content_typeJ/, 0( GPrted.30nd( s WriteWZ Di)h0['wsgi.input'] = I E%| aerrorsEE E&iterator <H0is )U and != False,+"TCmust5 an?,<@onlyempty list"3p( "I%* #edB>lint_app class:u__init__(self, _l' ="ECreadA<y 1Fv = `.JDC;v) is bytesEvOline?<= N8s$$ 5:">=f0qine in $ $ ~ C) return lines def __iter__(self):vwhile 1<0 = +P.read%()4#aif notf < re 0Qyield/\closeassert_(0, "input.'a) mustube called") class ErrorWrapper:bc__init, wsgi_e+s( =$HBwrit(, ;type(s) is str*[.D)V\flush3!2Ds7W, seq1forc0 in YA(BVa LW*rs'r$3 __ [bytesR%(s;PartialIteratEM. ?# We want to make sure[%edWf .de, None ,* Echeck_start_responseoriginali| /]0 = ( ; d = FalseH? = SY-4nexE"2 %d,"s Ir after "@v = e  1if cvcq %&, z|qed non-8tring (%r)" % (v,)k}T|; The application }s and we n!ed atover its body, but%A has"yet been(r! =/& v  P6Tru ifAattr5.%1, 'T'PT .c(__del__(self): if not self.closed: sys.stderr.write()"Iterator garbage collected without being `%")Cassert_(~,\$ def check_environ()uEtype is dict""E>@ment&of the right @T: %r E*%)"0% ('"4), !) %for key in ['REQUEST_METHOD', 'SERVER_NAMEVPORT')'wsgi.version/Uinputoerrors=multithread3oproces9run_once']ei f@miss(requiredQ" % (key,)6HTTP_CONTENT_TYP* oLENGTH$inashould/Ahave key: %s P"(useinstead)D[5:]if 'QUERY_STRING'_Nwarnings.  B!inDWSGI;Qcgi ''module will argv wheKis variablec,Gso application p are more likely'fW7c.keys(: .'9 p# Exten, we don't c ab1its 6continue`[key]):str&al- %s/fa stringp (value 09w>, Vtuple"/ Qbe a )B (%r 'url_scheme']`('httpU= 0G"Invalid - A |?if  '4 in xOne of 5or : are required (" "should at least be '/' iZis empty)"wMI|P') !=I 0canmS; it qinsteadv', and "/A ") def check_input(wsgi for attrR['read', Hline s __iter__']0hasJd,[\.U (%r)have the5ibute %s<.% ^ berrors% PflushAwrit sX!&?` rstatus( # =string_type(A, "S8# Implicitly5 that we can turnzinto an integermp_code =9tus.split(None, 1)[0]K 3len7h) == 3 SBs multhree charactersVrPint = k *e>= 100|R is i m2intl6if ) < 4 or1[3]" ')w s. (C"The: .!a `-digitF followed by a single space#acexplanationP*, 7headers(ugClist, "Headers (%r) must be of type list: %r" B% (h2,#1)))$for item in ):@assert_(\(&) is tuple,%)"IndividualF< @!% _j1len'b) == 2 name, value = = check_string_A, "H "QK789P.lower() != 'status'6QThe S6a canno used; it conflicts with CGI "script, and HTTP nMgiven throughisD(R)." %NP'\n' U!in5t)': cQs may?contain ;or '\\n'}{=z_re.search('c, "BadF 9P.endsPQ('-');_')FName0end8@'-' _sif bad_i)uo0+ (bad char)"% ,v.group(0C def)2ent*M,ds[2, "1cod2nt(!.split(None, 1)[0])# @@: need one more person to verify this interpretationRFC 2616#J http://www.w3.org/Protocols/rfc.-sec10.htmlA NO_MESSAGE_BODY = (204, 304=N}D 'J*!ifDC== '-'01if `;in ,_areturns("Content-TUB foua %s response,IKb"whichv]Q.") %MO"No - s)[') exc_info( hO0-"6!isa<B4D0# Mexc_info checks? def check_iterator( "): # Technically a bytestring is legal, whichwhy it's a re23badHidea, because it may the response to bTturne=character-by- Zassert_(not isinstancer, (str,1)),4"You should < rer3 a as your application 6, "HsFead Aingle-item list contain5B.") """Excep_ cls raised by urllib. The base e.vURLErrornherits from OS. It doesn't define any behavior of 5pown, buM v for all sI d in this package. HTTPz-an1thadalso a valid 5  Z"esh wa?5protocol e Rs areT Zqs, withatus code, headers, and0odypan someexts, an @wantPhandlNAlikeUgular. import __all__ = ['@', 'M ContentTooShortB] 8( sub-type*$t ' shG&!of#implementp. need override __init__U__str__.BIt sets self.argsXcompatibilityTother=1sub"es@Ahave0typY2matNerrno inIQlot 01str5sP1. Tbe better than+Bhing@(,son, filename=Nonew&=,treason %ifT[>^{% =2 G'' %g(X,.addinfourlkB"""RBwhen|@occuzActs FBnon-%"""~q__superk/ =}.,pmsg, hd#fp[3! =*Rmsg = msgH! =O  fpp4 # L  depend on fp be`IAobject. In some cases, the HTTPError may not have a valid # file object. If this happenL simplest workaround is toGbinitializebase classes.+Pif fp?2UNone:self.__super_Q(fp, hdrs, url, code) 4def __str__(8)Kreturn ' %s: %s' % -.I , 8I.msgS?repTU # since URL7specifies a .reason attribute,should alsl# providb&is5. See issue13211 for discussion@property>|=m=headers> ?.u.setterE#, G$ =1 V ContentTooShort\(eD"""Exception raised when downloaded sAdoes(rmatch c\-length."""_t, messagey.3)S)s$ =} """Parse (absolute and relative)Rs. urlp(Pmodul }ad uponfollowing RFC  caA3986 (STD66): "Uniform Resource Identrs" by T. Berners-Lee, R. Fielding L. Masinter, January 2005. q2732 : "FormatLiteral IPv6 Addre=0 in 'swR.Hinden, B.Carpe`qoDecember 1999p_396:  (URI)": Generic Syntaxy?T. ,'L.`August868: "The mailto scheme",bP.Hoffman , LLJ. Zawinski, JulyW0180WR Locatorsd, UC IrvineWdne 1990173WN)/L)  M. McCahill, 4v isqsideredcurrent standardaany future change 41con`with iz -3is kl&rely compliant B due to defacto scenarios2ingPbackwOatibility purposSsome 7 quirks from olders are retained. testcases in test_urlparse2.py provides a good indicator of parsing behavior. """ import re 4sys Etype collection warnings __all__ = ["urll@e", (unCjoindefrag", 1Ssplit$(unQencodXS;_qs>l?Aquot- U_plus_from_byteC!un/* :/to:DQResulVParseS 9B' ">C] # A classif0ion schemes. # The empty str.es URLs with no 4 specified, # be2the default value returned by “urls” and”. uses_relative&'', 'ftp"ht`gopher"nnYimap'!+P'wais)@fileCs ?mms:prospero$1rtsusp1svn `vn+ssh woSwss']onetlocntelnet'  '} B'sne _rsync~A 'nfw0git2git  }mparams dlI Z '1i?sip'C0tel%Hse are not actually used anymore, but should stay for backwards # compatibility. (TheyUundocumentedHhave a public-looki name.) non_hierarchical:h9Qmailt /'gP] (s4Qqueryx_yxC b 'I |-# 'uDV'I; - D '\nCharacters ie:"s GP_char('abcdefghijklmnopqrstuvwxyz'v 'ABCDEFGHIJKLMNOPQRSTUVWXYZ-0123456789'  N'+-.') # Unsafe bytes to be removed per WHATWG spec _UNSAFE_URL_BYTES_TO_REMOVE = ['\t', '\r0n']_ 5s containing a n` element @property,rusernam. %rinfo[0]fHpasswordvH1HOhost# =pif not DANone# Scoped IPv6 address may have zone e, which mustcbe lowercasedO'like http://[fe80::822a:a8ff:fe49:470c%tESt]:1234/keysAseparator = '%' if isinstance(,) else b'%'?!percent,=.eition(l)@#G.S() + P! +Q" !___getitem>z(types.GenericAlias OStr(7, _3StrP_t PnU5,_ # =*.6'@',&if8 /YSY$, 0 = $hd'':^^_; j&9 = 4 .t( = 5*{1{Q_, _,hl-ave_open_br, bracketed = hostinfo.partition('[') if have_open_br: hostname, _, port = bracketed.paR]R9_29-:-OelsetOinfoFaif not M{u = Nonepreturn T% class _NetlocResultMixinBytes( as *)__slots__ = () ~@propertydef _userS(self;An0 = .65,@, 2 = /&.r7b'@u/VZpassword, 0 = $:(b'I F k&V u( = 5*}};n_b,B% = M>/b' K l from collecAs im?dtuple _Defrag@Base2ame (('', 'url 1ment') _Split>'#Bcschemev path queryW_ParseW #Wnparams^a.__doc~H""" 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 (,th, query, fragment) A 5-tuple that contains the differen>mponents of a URL. Similar to ParseResult, but does not split params. """ _S.Base.scheme.__doc__ = """Specifiesl "A forrequest."OjnetlocO Network location wher#e N is made to.KpathXThe hierarchical $, such aG to a fiho downloadh_queryi3 co,Inon-Cdata%along with 1 inMRidentta resource insPscopeTURI's[and nZ"fru F rlows indirect!secondary b cx a prim# and addi $alYying inform# (", ,barams, $, }6}op_d z[e , _B "B@  >&@P8Qeters0lasL`th eleP used\Edere`he URI@orde provide access20per some oper" op o !C $ # For backwardsatibility, alias _NaMixinStr # 0no  ert0ocuYbed APIit is # reed since depre6#n't worth1whassle u= # Structuredult object0strclass De\((_2, _): __slotsc!()def geturl(self)-0if .iCr4n"url + '#' +3b.Oelse@ " S(S,?: return urlunsplit(self) class ParseResult(_ Base, _Netloc MixinStr): __slots__ = ()def geturle)-rps! # Structured r objects for bytes databDefragB)(_ %!0if +.pFment"url + b'#' +4/OelseA S((_ *! c#*- %et up the encode/de3`pairs R_fix_I_transcoding(1(G(, ,+', )R,l)<_Bd, _Td in D-.,_counterpart =C(.: 1~/ D_ del  2urlurl, scheme='', allow_Lcs=True1"""( a URL into 6 components:///;?# 4The*is a named 6-tuple with fields correspon50 tosCabove. It is either a8 or:BdepeW onW type of CVeter.@user, password, hostand port sub-1U#can also be accessed as attribuar#ed}P argu  providesdefault valu2 when noKAfoun3urlp,If.)0Fal no1emp@made se= tesGP from previouc, which *#beHaY!Noiat % escapes are not expanded.>1""" , _coerceWargs(+ =( ]) scheme, @netloc, url, query, fragment = splitresult if scheme in uses_params and ';'1rl:-1X$1= _PQ(url)(Felse2Q = ''~ = ParseR(), : ereturn _coerce_V(n) def}if '/' 0i =7.find(';'E".r2/')xif i < 0P"  aQ7A[:i]uh[i+1:]c, start=0)~delim = len) # position of enddomain partdefault is&Pfor c`'/?#':p# look miters; the order?NOT importanZ:w0Wc"0 # `Q firsQthis 7$3if IA>= 0#Ufound6Hq = min( ,J# earliestv;Iv:F !:]q)(fd, restScheckcif not3 or .isascii('`1ing`charac like \u2100 that expand to 'a/c~`# IDNAs NFKC equivalence, so normalize_| unicodedata4n =replace('@', ''i# ignore already includeG.B:Ba # but1z@surr2text A#A\?32. ('(B', n$ =2,F6@:'%"if_ >Baise ValueError("'S '" +b + "' contains invalid " +G"~ una/"1urlQ,!='', allow_Pcs=True1""" a URL into 5 components<R>://<>/?<4>#<_!> 0TheOa named 5-tuple with fields correspondoCabove. Iither a S }Bytes object,BBdepeW onWP typeH0urlXvameter.@user, password, host1V sub-(Uycan also be accessed as attribuf the return2ed object. The scheme argument provides the default value of2A`compon7twhen noOis found in urlpIf allow_fragns is False,=pattemptmade to separatezs; |@from previous, which can be eitherHpath or query!Noiat % escapes are not expanded.>2"""CCurl,, _coerce_res6=Wargs(+)E {= bool(,Pkey =Kn (`, typef) @cached = _parse_.get(key, None)1if !d:'ereturn(&5Hlen(\) >= MAX_CACHE_SIZE: # avoid runaway growthiRclear(Ynetloc =5 = A= ''9i.find(':'9if i > 0Sfor cF[:i]#inj_chars&*QbreakzJelse$v,m.lower()b[i+1:]@b _UNSAFE_URL_BYTES_TO_REMOVE`2urlT.replace(b, "")L ifu[:2] == '//':IRsplit22, 27if (('['# and ']'!2) oK5('2in #9[9)8praise Vd Error("Invalid IPv6 URL"i@#6urlXm-u('#', 1Q/'?=n:?:b_check(SPv = S^R($,,:>[key] = viav) de!un(sc"""Put a dL back toge p again. ris may a}slightly different, but equivalqURL, ifURL that wasvG'originally had redundant delimiters, e.g. a ? with an y/F(raft stat atyse ).`W-ms(zI * if'am_"%s;%s" % 5Rurlunl query, frag,ment))) def urlunsplit(components): """Combine the ele; s of a tuple as returned byNL) into aHYlete URL2a string. The data argu] can be any five-item iterable.O(This may result in a slightly different, but equivalent~A, ifAthatQwas parsed originally had unnecessary delim s (for example, a ? with anOempty query;mRFC states tgse areQ)."""?scheme, netloc,T,N`, frag', _coerce_1= (==`args(*)E#if}R or (S and in uses_url[:2] != '//'Aid%1% ': 00' + |31url/(fgor '')*#if9@+ ':A1urlZ"ifF /n@+ '?,.m1#1$4  F(urlljoin(basedallow_Fcs=True=Q"""Jo0Ea possiblRlativXto form an absoluteinterpretationelattert0ot i@0not #8 n ev)sb2, bq, bpathqrams, b4, b-A = \t1url`K'', _lkji"pahgfUurl, j,U PM"re ]7HO\CAE9X"un@"@PyA$ =C0ot t%M=$%O RD2 1"O `_parts.Y2'/'!if%#[-W'#h last item is not a directory, so will not be taken into account # in resolving the relative path)del base_parts[-1]  # for rfc3986, ignore al.Dq should]first characterQroot.L!if0[:1] == '/':segments =$.split('/')#Oelse-/ +:]P# filrout elejathat w@causdundant slashes on re-joiningOHV9ed_H@[1:-zz(None, )cIC = [{y0seg8 ifMG'..H6try) fR.pop(Zexcept IndexErrorC#Pny .. Jotherwise T'anSBq# when popped from#if JEpass(el continue.\ ,append(seg])('.', '..')8# do some post-processhere. if4DlastLf was aEdir,#/n we need ` trail\5'/'2#''"return _coerce_result(urlunparse((scheme, netloc,.(b@) or$, params, que1fra))) def urldep4"""Removes any exist'n!BURL.9R0rtuple oPX1ed URL anQ. If"ained no o!s,Ydsecond70 is>empty string1"""Kurl,X% =Aargs,`if '#'E6url=s, n, p, a, q, =76url A2'')1 KF = '4M'DR44p_hexdigY 0123456789ABCDEFabcdef' #tobyte = nquote_to_"s(_"u!p'abc%20U`) -> b .s# Note: s are encoded as UTF-8. Thisonly an issue3it !c# unescanon-ASCIIs, which URIsn# Is it a-like object?  string.split return b''if isinstance(2,:!): 3 =Qencode('utf-8')(Fbits"sC(b'%pif len(%f) == 1]dK reJ[-A[0]]append = res. # Delay the initialization of table to not waste memory@i'Afunc7is never called&global _hextobyte'if is None. = {(a + b).<0): Hs.fromhexXs for a inp@dig b}9@item>61:]6try `G([=R[:2]]%)'2:except KeyError_KOhb''.join(res) _asciire.compile('([\x00-\x7f]+)') def unquotgCing=0, es='replace'B"""R %xx escapes bSir single-character equivalent. The op7!alwC andr parameters specify how deH percent-=rsequences into Uni+s, as ac#edSW(\qmethod.By default,u qBare Cd with UTF-8,binvali 2W!a c@holdH;!. 'abc%20def') -> '1"""/=TC\A_to_"").(c4ing$aif '%'!#inF^ #= 42%= 24 = ">1.range(1,7, 2_ _?[i]`aC2C + 1H parse_qs(qs, keep_blank_values=False@ict_- v~ , max_num_fields=@, segtor='&1P a query given;` argum!A&s:=qs:SW# be@6sed7 : flag indicating whether blank values in percent-encoded queries should be treated asIstrings.HbA truee indicates that7SaretainT E` The default fals`C`are toPignorq(ndif they wereGnot included. ct_parsing: flagPing wto do with )k error2#If&(t#),, silently s!Ift2raise a VEr exception3andm: specify how2 de sequencesJinto Uni3characters,2 acPed byjr bytes._() methoa max_num_fields: int. If set,An throws A mobhan n SA reawe_qsl()separator: str. `symboluse for &E4y argumentDs@&j`Return0dic2ary1"""`Pd_resC= {}Qirs =\qs, keep_@_,i,= = P=8 =,#3or=-1or)@Uname,,q pairs:0if !2 in"& [1].append(n*Oelse<A = [8]r b def9x =F ~\s='utf-8'{'replace', YX=None^B'&')a"""ParQgiven %ngA:=qs:S ng"be d7  e /s.C ,/ "g what to do with parsing errors. If false (the default),, are silently ignoredAi true,G^ raise a ValueEr exception. 2Pencod3andm: specify how to decode percent-3ed sequencesMinto Uni3characters, as ac`ed by bbytes._() methodmax_num_fields: int@set,An throws f(!reAmore than n SA reawe_qsl() separator: str. The symboluse for &Equery arguments.Ds@&j`ReturnAlist-0G-dRendedE1"""Mpqs, _co_result =args(qs)*\or, _$)dif notpor or (isinstance(4, (str, A))):oxv4("SF must be of typeU6"orH#."Z# If 0 is@inedpn checktp numberZ#6@less(nRpis prev a memory exhaus(C DOSIattack via poRodiesCmanyQiKFNone+ = 1 + qs.counthXT<( @'Max. #Seded'wpairs = [s1@1 inHspli]nr+ `name_vn6L]$ppstrict_6ing2continueoVnv = E.i'=', 1+len(nv) != 2T!ifwsf ?R"bad ^: %r" % (&,)D# Handle cas a @rol-59no equal sign?if keep_blankVs&nv.append(''7elsi, P2if *@[1])u = nv[0].replace('+', ' +qunquote*!, ;Ding= = C J (u1 ,5P( r.appenNd((name, value)) return r def unquote_plus(string, encoding='utf-8', errors='replace'): Lt"""LikeF(), but also r+ Z signs by spaces, as required foring HTMLm7s. !'%7e/abc+def') -> '~ /1"""2 = .('+', ' 'e ,*) _ALWAYS_SAFE = frozenset(b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'5  b'abcdefghijklmnopqrstuvwxyz7 0123456789' i_.-~')_BYTES = bytes() _safe_rs = {} class Q, r(collections.defaultdict)`A mappBfrome (in range(0,256)) toS are percent-!edK , unless the key < 128, andl!in"" set (eitherspecified @, or=!).GF# Keeps a cache internally, us , efficiency (lookupsSB# ofFd s don't call Python code aKl__init__(self,uU!"":%s object."7.(= p.union()knCreprnh# Without this, will just displayaK}"<%s %r>" % 1.__bP__.__@__, :)0miso9, beHandle-. Store ds2 in0chr(b) if b/>else '%{:02X}'.format(bI@+[b] = re}j~0='/nDNoney= 2"""<:iaabc%20sEach partqa URL, e.g.path info,query, etc., has aCdifferentGreserved character@at mbgQ. TheBA fun2 oPG utious (not minimal) way6S1mosQthese<RFC 3986 Uni Resource Ident r (URI): Generic Syntax listK`followO(un) = ALPHA / DIGIT / "-"._~8:gen-delims / sub >f!":J/?#[]" / "@" sub-delims = "!" / "$&'(0)" ( A/ "*+,;1=" 1Each of the reserved characters isin some component9aa URL,L but not necessarily in all)Rthem.u The quote function %-escapes/that are neitherR1theq)uns ("always safe") nor@addig!als set viaJ0G argdefault fD#P'/'.  , !inZtypical usagep is being called on a path wher3IPexist(Qslashtto be p Python 3.7 updates from usIRFC 2396 to 1398 URL strings.Now, "~"includedP;of LA and@ maystr or byobjects. encod6aerrors2muskbe specififaL#op ]q parameXPy how!deal withnon-ASCII, as accepted byAstr.ie methodL3By `,='utf-8' (Vs@d~ UTF-8),H ='_ct' (unsupporIraise a UnicodeEZ eES)"""Cif isinstance(W0ng,Y!):qc!if`return08ing1zis None7#=  <:$= 9# =(k", <)17els%ifMzS2TypH!("9() doesn't $ 's'N"w3m!isXk*Ji__afe) defY_plus7=''B= c"""Lik"() also replace ' '1'+'4required:@HTMLm values. Plus signszoriginal1Krd unles2AtheyQ. It Bhave)(# Check if.,~bQ. IfU#-re are no spaces, the regular quote will produce-ight answer. if ((isinstance(string, str) and ' ' not inqing) or;?;Rbytes=b>%):=breturnyafe, encodqerrors)58if *Spspace =2Nelse/ =1 + MB.replace(' ', '+') defWa_from_(bs, safe='/' r"""Like,(), but accepts a 8 object rather than a,Adoespperformring-to-CS. It always s an ASCII6E 'abc def\x3f') -> %20def%3f'1""""if9](,carray)Oraise TypeE-(") expectedB%s"&bs" ';# Normalize '' by converting tossPremovBnon-;BcharB! =.{e('ascii!rignore'  af&([c for c~if c < 128]=e@bs.rp(_ALWAYS_SAFE_BYTES8afegybs.decode(L6try?zPr = __ s[ ] exA Key:1bPQ r(I).__getitem__Ur.join([w([) 0har3bs]d3url`query, doseq=Falsem'@=Nona`s ztR_via= Cplus=@"""E'e a dict or sequence of two-element tuples into a URL bvIf any valu,(uarg are`dp is tru1achI$is eda separate 0met<+IfwiyRoQorder!heK[VboutputRmatch9 1Gqinput. The componentsmaJ"may each be ei%or@GtypeP}Eis~Ppassew wnFdfunctionqspecifi:! (D[@onlyqa)s<Xif hasattr(0, "'#s" query = query.items() else: # It's a bother at times that strings and -like objects areJsequences.6trylpDnon-* should not work with len8 # <Semptys will fail thisx/!ifDaquery)aisinstance([0], tuple)Craise TypeError_# Zero-length s of all typeget heresucceed,L1butsminor nit. Since the original implementationIallowed ' dibehavior probablyb # preserved for consistencysfexcept! B ty, va, tb = sys.exc_info f ("`a vali"n-d% " "or mapping0").S_traceback(tb) Eal = [] !ifVdoseqk, v in 1y7if Rk, bytesKk = quote_via(k, safeH  9bstr(k)>, encoding, es7 vvv_ 9vl.append(k + '=' + vr 84-el?str QVa< 0# Inisufficient testxZa-ness?;1x =A "Z5t abf 3c<& # loop over for elt in v:  if isinstance(elt, bytes)3Jelt = quote_via9_safe)jOelseU0strY0), Z, encoding, errorsll.append(k + '=' + elt0 return '&'.join(l) def to_C(urlwarnings. ("urllib.parse./ ) is deprecated as of 3.8", D)BionW^, stacklevel=2_e S6"""+"URL") --> 'URL'."""2# Most URL schemes require ASCII. If that changes, the conversionFcan be relaxed.XXX get rid i0urlrhS2try url = url.1e("").decode(Y+except UniE LYraise (& " + repr! +Q" tains non-,racters"rb3urlaunwrapd"""Transform a string like '' into '1'. 4TheKiRed un d  t'@t a 0ped'y~v.pm if[:1] == '<' and2-1:">'CJurl[1:-1]K47:*4:8 ^splittypea0", 1@"use1url 0() D?ead0@ _prog = None_'t6"""'7p:opaque3ng'I', '&uglobal v\&ift , = re.compile('([^/:]+):(.*)',rDOTALL)vmatch =[.wk, data = s.groups%-.lower()5X ,=suK0K{return _splithost(url) _ prog = None def _spli': """0'//9[:port]/path') --> 'B', 'A."""Fuglobal w&if1 isuy, = re.compile('//([^/#?]*)(.*)',DOTALL) Xvmatch =].[1if m_ , " =!.groups()X;!1and*[0] != '/'M(%! +)B{return rq, url Puser(5)iwarnings. ("urllib.parse.1)Xdeprecated as of 3.8, @"useyK1urlT() instead",5 DcBionW, stacklevel=2Ah /'[:passwd]@ !$&, delim,! =.rpartition('@'(52 if7Q else)B{13B1 !> "'0 = t:3, (/ ?ortH/s H!# Btag(@#tagt0, ' S <X}6ortMg6dF:([0-9] [Q.full|p , 5 6ort5@a xngyf?=-1>se urllib.pa rse.urlparse() instead", DeprecationWarning, stacklevel=2)4 return _splitnport(host, def) def!Q=-1):K@"""SF AP and A", cing numeric.4RPgivensAault if no ':' found;ys to -1?X%al;pa validrrber areG` afterW A@Nonerobut not CA."""Blim,o=p.rpartioB(':'^rt delim%C! ==SAelif#6try 4p = int(W`except ValueError9n4!, [  query(urlwX s. ("urllib..1c) is ded as of 3.8, TY"use LG M7"""q'/path?%r') --> B', '/*/ = /?/ +F?Qurl, ?tag/q  M#tag?tag#?tagOattr0  ; 01=v1 2 P2;...>L 2X', ['6c9u', ...]Swords3(';L"R[0], 31:]]0(c2.7L_qsl 8 DeprecationWarning, stacklevel=2) return _splitvalue(attr) def:67"""1'2==q') --> B', 'A."""8), delim, 0 = `.partiI('='2, (."if> else None) """An extensible library for opeT URLs using a variety of protocols The simplest way to use this module is to call the urlopen func, which accepts a strtacontaia or a Requmobject (described below). It s osURL andPresulks file-like Q;52ed  has some2ra methods | |.OpenerDirector manage`collecFsHandlercdat do (actual work. Each 3q0men Ucular` or opi0.  ismposite that invoke#e os needed" ed. For exa ,!S HTTPA performs A GETbPOST rsdeals with non-errorB1Red]_automatically E- 301, 3023gS307 rD e!s,04DigestAuthc U! dp authenuh# (url, data=k -- Basic usage5ame as original?lib. pasA url0ata@post"anS1URLf get a0bacEOne differencat you can also gQinsta-`nsteadURL. RaisAURLE`(subclQof OS!);SVkr:'", be treated& lisponse. build_ erd"FuOc<Lnew q. Will ldefault hSs. A0oneDmores as argu, eitherQ0nce+ Yfqt will {`ntiate!f efA X2'a [ t3]2 beAlled ?". 'llJI$ll=ca9aCer. 7sinterest: r-- Sets upUser AgentPython-urllib cli$nd> %K4!le08 P"re/Ds. 8T-- Anthat encapsulates the state of a request. The can be as simpl 7URL. It !@also include extra HTTP headers, e.g. a User-Agent. BaseHandler -- internals:and parent _call_chain conventions Exausage: import urllib. # set up auth= caA` info  + =8.BasicAuth%()1.add_password(realm='PDQ ApplicO', uri='https://mahler:8092/site-upd?.pyAser='klem#d='geheim$parole') proxy_sup. P {"A" : ://ahad-haam:3128"})a build a new opener that addswcaching FTP h #s 9 ]_(,\i ~ .CacheFTPinstall it .N) f<0url( ://www.python.org/') """9XXX issues: # If anTerror&W0trio perform #5for some reason but fails, how should _ be'ignalled?  client needs to know4 9code. But if #0n!atproblem wa,it didn't1Dat hash algo%Qed inN chnge, it wbe good to # <!"rmPalong, too. # ftp s z' d cleanly # check digest aga correct (i.e. non-ap[!) =Ament~qPossibl10ens co x  not sure wMpexactly@ meant by this`bstrac`ctory %erdbase64&dbisectTemail {5libBttp.+$io $os posixpath$re UsockelestringyB5tim3utempfilwcontextwarnings from @URLE?, CKntTooShort CPparseN(1url,gQsplit join, unwrap, quote 9_-btype, Dhost  Duser "wd65attTquery+Evalu\tag, _to_bytes@unquote_to_bytes, urlunparse) fromlib.response import addinfourl, closehook # check for SSL try: :ssl except ILRError#_have_ssl = False elseTrue __all__ = [a# Classes 'Request', 'OpenerDirectorBaseHandleHTTPDefaultK1Red@ 'CookieProcess\UProxy'BPasswordMgtCWithRealm',:'PriorAuthAbstractBasicz! 'QoDigestRS* 8Fil5FTP!z 'CacheEData"uUnknown,# FunctionpurlopenB@instJdbuild_A'pathname2url6Durl2getproxies# Legacy interfaceIurlretrieve8urlcleanup4URLww 'Fancy ]_used in User-Agent header sent __version'%d.%d' % sys.c[:2] = None def(Pdata=, timeout=socket._GLOBAL_DEFAULT_TIMEOUT*, cafileD ca3 ds=, context)!'' the URL, which can be either a string o  object. z*`* must9#an specify>&0al .0 to+Y1 toFpserver,l if no such6is needed. See 1forDsdetails2urlc module uses 8p/1.1 ancludes a "Conne:|"XRin it=" rlcThe op** parametD ifmpsecondsjPblock1PoperaPas likec attempt (#tk@ied,*K@globo gP setta@will). This only work&x0S-0FTPP%CIf *fH* is&it ssl.SSLC "nce describing pvariousZ!s.;@ morE .**.yet of trusted CAcertificateS should point to a sHingle file containing a bundle of CA certificates, whereas capath should point to aMdirectoryChhashedGvs. More information can be found inLssl.SSLContext.load_verify_loc8Qs(). -The *cadefault* parameter is ignored. ,qis func{always returns an object whichswork as1 ext manager and has the prop6es url, headers,%qstatus.0See"lib.response.addurl for m%detail on_saFor HTTPb S URLs, th http.client.0Rslightly modified. In 3 to three new methods above{[msg attributei):samAgreason61---^cphraseQed byserver --- instead8bI itAspec! if documentc(xAFTP,Adata}requests expliciO ha_alegacysURLopenKVFancyPclassB?urlJNote that None mayvred if no r (thoughuZpqalled global OD uses UnknownHr to ensur, nethappensz,proxy settings are detected (9qexamplean a *_3penviron variable like)`et), Pk3is Jd`makes 0Qd0=!1'''R;_ Pif caC or z :&import wars. "("N,L6K0pre d,E a "Lhq"customead.", DeEBionWE, 2)Hk"nodraise ValueError(>@"You't pass both!an "  _have_ssl 'SSL sup9Pavailp'TL = screate__(Purpose.SERVER_AUTH, cafile=cafile, rcapath=)<https_handler = HTTPSH(context=6Aopen/bbuild_(L-Selif ?:uZ is None}"= 9 = s4*=creturnF.#(url, data, timeout) def install?(-2er)sglobal [  _url_tempas = []Yurlretrieve~ Pname=, reporthook ~1"""sRF a URL into a r orary location on disk. 7cquires7argument. If a passed, itqused asD7thei4nW. The a should beCa callable that acceptblock number, a read size, and thAQtotal0 of btarget>Qvalid2qencoded (7qpoints yol resourc(QresulBa copy from/ato new{R Qtupleaainingt^newly createdYas well as7E3Message object.;ZQype, k= _splittyp)IAwithextlib.closing.[ ))"fp=`headerfp.info(T# Just r[# "CQ" for<1://C URLs. No sense in performunless requested@4if P == "O"1notn40os.P.norm (3), ;0"#  IYsetup~p3tfpn(!b, 'wb'c(el5$4.NamedTemp2File(delete=FalseJ<2p = tfp. q u.append9t?% =_4b6i1024*8~!Y = -1<9= 0aLnum Aif "nt-length": tCint($0["Cnt-Length"])  if reporthook: (blocknum, bs, size) 0while TrueH= = fp.read(bs)<qqif not +B"]break8Qr += len[tfp.write!u0numH1b% )!if7 >= 0 and < raise ContentTooShortError("retrieval incomplete: got only %i out of ibytes"@0% (, resultcreturn def urlcleanup()@"""C up temporary files from3e calls.""1for3_. in _url_Es`X6try os.unlink(.@except OS0 9Bpass;delp1[:]global _opener$ifO  = None # copiedcookielib.py _cut_`_re = re.ile(r":\d+$"zq.ASCII)hrequest_host( qR%-% , as defined by RFC 2965.VariationRRFC:  ed value is lowercased, convenientcarisonV1urlP.full4 =parse(url)[1i2if F= ""Y .get_header("Host", ""# remove ], if presI~.sub("",y2, 16 .() class R:G__init__(self,p, data=", Qs={},origin_req3unverifiable=False;amethod2 VqhvZ = {}unredirected_hdrs$_pX Wq_tunnel :TDkey,rn.d.itemsSei4add;$;if UQ( %Uy2  )2if  o# ="p@propertyC~]HWelf.fragment'{}#{}'.format(self._full_url, sfragment) breturn. @=q.setterDdef (Tq, url):T# unwrap('') --> ''BV$ =Qh% = _splittagOg|parse()OdeleEz = Nonetselector = ''propertyGpAdatay != @ , F!if3 != ! =-# issue 16464f we change:need to remove content-length headi^*# (cause it's most probably calculated for previous valueG"ifBhas_f9("C}"26y 77z\T7_! 0.f, rest1ype\81 is praise V*Error("unknown 8r: %r" %8V.}}(4 NCquot+$get_method(B"""Ra string indicat the HTTP requGEA."""ddefaul` = "POST" ais notQ else "GETDqgetattr2, 'm:', c d6T#$vset_proxy7 , 1,C == 'https' and\_tunnel_B 1+@8Qtype=*ns5"f! =/`a@4addm`, key,CS# usefulg soUlike authentii!onWs[key.capitalize()] =bunredirecteAwillabe addW a redirected request  self.unredirected_hdrs[key.capitalize()] = val 8def has_header(C", q_name):'breturn (@ in 3.Es or/3M/ )?get, default=NonY.get(,7 A4})oremove?eOXs.popH!, ,67a_items o = {**]#, }VPlist(F.`class OpenerDu"or1__init__client_version = "Python-urllib/%s" % _!%__3add = [('User-agent', \%)];#$andlers is retained only for backward compatibilityDhB8= [_manage the individual .D@_ope{lb`_error process_response# q""Cadd_,/`if notSattr(/0, "=wparent"/(aise TypeEQ("expb BaseH7 instance, got %r" %BDtypes$added = FalseB@methj%di 4if %$["/_Oa", "do Rproxy] # oops, coincidental match'continue1i =.find("_")9protocol&6[:is?bconditFk[i+1:]c%f '.startswith("a V7j =3 + i + 100kinj>try=!;@int( !except ValuXHMpasslookup =W]N, {}y [0A[ r7elijP == ""4 = P F] open  elif condition == "response": kind = protocol lookup = self.process_Q /y_questx8P w.secontinue ,handlers = .setdefault( Y, [])34if 6fbisect.insort((,2 J/el5t.appendE ;@adde(Tr1if  d.add_parent(7)<def closem# Only exists for backwards compatibility.QFpassV_call_chain\!, ", meth_name, *args){Hraise an excepif no one s should try to# the req, or return N@ ify can't but anotherGrHcf@. O Rwise,<Pg{4.ge&()]+4 in}sfunc = getattrI%, HP/result = 8(b!3if $ais not s'+4opefullurl, data=Y, timeout=socket._GLOBAL_DEFAULT_TIMEOUT ac` a URL2a Ru objectif isinstance(~7strP4q =F),D re7XvQ!if 1 q.c! =-3>Creq.$ ="` =G.typc# pre- ;3+"_"(gD ori%0 mPO7C(reqvsys.audit('urllib. ',._Y:Srheaders @get_\(odQ_2reqg# post[4\ \(]0^"sor, meth_naWme) response = meth(req, %) ,ereturndef _open(self8q, data=None):>psult = (._call_chai9q.handleJ, 'default',? -<' if6ult?2ultprotocol = req.type/reH$, % +Ii'0eunknowne'+ Serrorw, *args"if  in ('http', 's''`# XXX #2[s]6cols are special-cased25dic\K[eA'] #Ss is not different than P0 = [2] # YUCK!%.@_nam:h_tb_%s' % 0#I = 1Porig_krJelse30+ 'z9or')0(k,1) +/)!if  P04or_A^$) probably also want an abstract factoryE t Ns when it makes # se[to skip a superclass favor ofb6andFaight #NKinclude both QbuildBer(*r"""Createper objerom a list9.CThe 0will use several b 3", 0ingAportpfor HTTP, FTP applicableSr`If any5the\ passed a`gument Be su4#es3sM   be!d.=1"""= OpenerDire(\M_es = [ProxyHBr, U] ` $DET0"1RedE4FTP#R File r, HTTPErrorProcessor, DataHandler]$if hasattr(http.client, "HTTPSConnection"):0Wdefault_classes.append(2])-skip = set(Pfor k6K in G`&Pcheck&hsif isinstance(-g, type(,1sub,-1R.add(%!elO {* /K0!7 t.remove > 0I`opener_AEE()) Gh` hXSh = hphrreturn !! S Base*_order = 500def add_parent(self, .# =@Qclose;3# Only exists Vbackwards compatibility/FpassUa__lt__Vw, other]eif notZ9, "R_# Try to preserve the old behavior oving custom N%esHinserted afterh ones (works oIKuserF\ which are aw F)).=ETrue " t3""" 0 e1p respon1""" c = 1000 #)2all" pI6ing_Srequest,kcode, msg, hdrs =%.L.$Sinfo(H# Accordto RFC 2616, "2xx" L indicates that9'## was suc+fully received, understood, and acceptedr(200 <=W< 300#lf.(&'^'H Q,bHSjIs5ttpVD][T__rN, fpQraiseiP(req.vM_url8M)Redirect# maximum nu4mber of redirections to any single URL # this is needed because?the state that cookies introduceAmax_repeats = 4# maximum total nu(regardlessoURL) beforZ # assuming we're in a loopeyQ= 10 &de%_request(self, req, fp, code, msg, headers, newurl):E"""ReturyRHq or Nonresponse\n.@T\@call\ y Thttp_error_30x methods when a| iis received. If awion shouldCtake placeDnew [llow %toDqperform. OtherwisZaise HTTPE if no-onCelse@ try/PhandlYis url. i\f you can'tpbut anoy! H?r might.#5""" 0m =R.get_c%()if (not (Y(301, 30237) and m"GET", "HEAD"G!orL' E@== "POST")Z:r9(req.full_url6fp)]# Strictly (accord+to RFC 2616)10302G@# a MUST NOT c Y`withou`nfirmaSMR# fro"user (ofClib.},~iPcase)n practice,I essentially all clients do K, so we dge same# Be conciliant P URIs@tain;a space. gmainlyeredundB0mor[mplete encod$ Z82() it}akept fKmpatibilityC&rs# =1.re(' ', '%20',CONTENT_ERS = ("content-lengthGtype3new# = {k: v@k, v g.itemshif k.lower() ;in }mry(>V =+`origin`_host= <unverifiable=Trued0# IAmente: To avoid>server sen!uJ# infinite,3?q objectptrack wURLs we # have aJlready seen. Do this by adding a handler-specific # attribute to the Request object.''def http_error_302(self, req, fp, code, msg, headers):;f$Some servers (incorrectly) return multiple LocationHF(so probably same goes for URI). Use first>.>Sif "l[5" i_newurl =?&s[4]K elM?uriH/C*sez e# fix a possible malformed URL'urlparts = 2se()LFor security reasons we don't allow redi|to anyth;Uotherqa# than,s or ftp.p#ifts.scheme notu ('G1', s 0ftp'0raise HTTPEt(z z"%s - Rq'%s' isqed" % (T-),OX!ifGyts.path andjnetloc/ = list()v[2] = "/"wunparseD'#.client.'_P() de s as ISO-8859-1. Recover Joriginal bytespercent-enI non-ASCII#,$Aany o'alMpcharact @suchthe spaceZquote!, |ing="iso", safe=string.punctuQ`@Bjoin(req.full_url, t# XXX Pzpwant toxget about1 state of wcurrentrZ, althoughK`t migh te poorly with {s9also uses`new = ._T | ewK?Nonloop detec&# dict has a keyD I was previously visited, if8'T Z? = =; (@C.getkc, 0) >Vmax_repeat >B4lenB 4<4 req.full_url, coode,  self.inf_msg + msg, headers, fp)AUelse:Vvisited = new.redirect_dict = req%{}A=[newurl] = R.get(, 0) + 1 6# Don't close the fp until we are sur atw-guse itDwith HTTPError.fp.read(1fp.k&()qreturn 9parent.open, timeout= ;`http_eqy_301 = 372a= "The server Ted a  q0 thould " \ "lead to an infinite loop.\n.vlast 30x_message was:\n" def _parse_proxy()@B"""RD#(scheme, user, password, host/port) given a URL orauthority.#If is supplied, it must have6 (^:^`componAccordingRFC 3986,D5an | :a meansuLytwo slashes after(y1"""/B, r_ = _splittype@)eif not(p.startsC("/"d#9\ENone!=  #H .raise Values!("fR 6 nor: %r" %@# We , so for -Pliant^s (by ss 3m# and 3.3.)sth is empty`N8'/'e'@' inyRT_separator.find('@'0 en9%2"/"I5 C 261if jJ= -1 q[2:end]BinfoA(G!if2co5L d(<M % =1& = Z class PHandler(Base H#!2iesM beBfronPh9P_orde2100_L0__(+,@ies=^$if%! *S= get Passersattr(proxies, 'keys'), "proxies must be a mapping" Tself.(#= for type, url in!.items():*P*! =1.lower() setattr(u, '%s_open' %3,,Plambda r,{ay=url,/=np, meth=QyR F.(LH1)) y2defcC3reqy-[Porig_p = req. IlHyP, user assword, hostport = _parse_.(1iY is None f5 =  !ifqC andpbypass( areturnm IE _X =0:%s(unquote()2L0)&creds = base64.b64encodb.Q)).dez"ascii"Iadd_header('Proxy-authorization', 'Basic ' + zD;%e3set R,&if" =C: orz'https'# let other handlers take care of itK;elsd# need to start ovbecause thesJdon'ia# grok,a's URL # e.g. if we havconstructor arg|like so{': 'ftp://p.example.com'},^may end up ;inga:Puest px://acmeM/a into one' C)/a(`arent., timeout=H ) class HTTPPBMgr:__init__dsswd = {}2 q6p, realmidP# uri could^single URIa sequenceif isinstance(uri, strSUx= [uri]9@ not [2]Ydefault_in True, Fareduced_etuple(Nr*)H(u, a) u6uri;xd[Is9", $Pfind_U((self, realm, authuri): domains = self.passwd.get(realm, {})-for default_port in True, FalseV]reduced_tbS_uri(,TnErQuris,@infotw.items(37,> !"if`is_subRuri, ^=ereturn'`None,  3def]p!, sT=Qu"""Accepthority or URI and extract only the&path."""# note HTTP URLs do have a userfcomponent:@part(urlsplit(I1if !:[1]n#'scheme =1)0]!1!= 2] 5'/'De`# host(:. 9uri6{_ , `A = _% )if,1 is2)!is [d2= {"http": 80, !s": 443#}sBj&,"%s:%d" % (V!3 , N&%base, testCheck if;`below /a{R tree[Both args must be$s.e form.G<"if[!==q =1R[0] !4+[07@8`common@osix.prefix((2[1]F[1])\rif len(0A) ==1? } q class/PordMgrWithDR&(O "):qPfind_W_\Bord(`JN-ssword =~.S GE!if^1not^1 ? ! PriorAuth~ lm): de f __init__(self, *args, **kw C):  .authenticated = {} uuper().Q K +def add_passwordxrealm, uri, user, !id, is_vl=Falsejupdate*(N @) # Add a default for prior q requests01if is not None Rs '6j7G7 :#p could be a single URI  s1ncesif isinstance`7str%uri = [uri]]i_port in True,  H-u":uriKreduced_h.4(u,hg;1[?R=] =ss SN7uriG1 =  r"in>3E"if'is_suburitdI ;_returh class AbstractBasicAuthHandler:Q# XXX this allowsmultiple-schemes, but will stupidly pick# the last one with aspecified.tkjdouble- and@-quo}b value3# ("@s ar0violation of2RFC`appearBwildrx = re.compile('(?:^|,)' # startL`string1','p'[ \t]*<P # opal whitespac/'([^ \t,]+)'ucq like ""n+nmandatoryo#O=xxxX O'xxx"O"xxx=(["\']?)([^ *)\\2',vTre.I)pre-emptively send info already accep((RFC 2617d # 0oZc2 2,]e1.2 immediat_after "cred2alsq# produ5)~["ord_mgr=f"ifA": password_mgr = HTTPPasMgr() `self.pAd = 7 #Dadd_7 = 7. 6def _parse_realm(/, header):$!# % WWW-Authenticate*: accept multiple challenges per'Oefound_$ = False r mo in AbstractBasiczHandler.rx.finditer(scheme, quote, = mo.groups[/"if*@ noty['"', "'"](warnings. !(" REq was uny5d",;RUserWQB, 3)'tyield ( #LFTrueG!if ' #if {# =!.split()[0]Oelse=)''. CNonehttp_error_auth_reqedreq, host s may be an 7ority (without userinfo) or a URL 5 an#8lss.get_all(d6reqz2 C# noS aufreturnunsupporte//$fo^l#10alm*.<F2if ?.lower() != 'b'. =!hcontin#if!ism # Use the first matching f.# Ignore follow82s even if^y2 XMkaretry_I(q3alm8if Vraise ValueEC/("CB doe\"v"}'O: %r@ %) K, pw _(:L ?pw >Y"%s:%s" % (SoB3 =  " + base64.b64encode(raw. Q)).de"ascii") if req.get_header(self.auth, None) == ;: areturn& Xadd_unredirectedTe\)@X parent.open(req, timeout=e >Jelseedef http_request, ):if (not hasattpasswd, 'is_enticated') or]!;3.1.full_url)x@Ereq T0if T4hasL'Authorization'Hbuser, 8 = Pfind_ _@ord(~@credals = '{0}:{1}'.format(Mm).encode(B3 _str = base64.standard_b643gO).deG] ,'Basic {.strip()) RfsponseSR/ifXif 200 <= reV.!j < 300+/jupdate f, TrueANWGFalsX=s) =!5" class HTTPHandler(Abstractc, Base&"):Hb#error_401@fp, r, msg, Ks@url qj[_freqed('www-'P urlqxV\Proxy>W*R]7]#< 4uires that there is no info component in#ority. Assume?n't one, sinceZClib.X@ doeagt (andQ`should , RFC 3986 s. 3.2.1) support ests for URLs containingN.fChost response = self.http_error_auth_reqed('proxy-enticate', 9ority, req, headers)Creturn response # Rn random bytes. _r = os.u class AbstractDigestAuthHandler:p"#  ion is specified in RFC 2617. 7 XXX The client does not in8`t the nTS-InfoEin a successful f It should be possible to teshis implementatsagainstea mock server that just generates:c set of challengbEPqop="(-int" supports,Bhakydef __init__(G, passwd=None)w-#ifA5 = HTTPPBvordMgr()^.( @Aadd_Rord =(d. 5@retr:= 0nonce_count Qlast_"0 = `reset_Wy>  wxJ0,_>k, hostQPSreq =`s.get(@Z"if,6> 5N^# Don't fail eQssly - if we0ed 0, we'll probablyC#*econd time. Hm. UnlessG Manager isEprompting foe inform. Crap. Th*sBgrea# but it's bett)n@curr'repeat unti{cursiondepth exceeded' approach .QraiseEe(req.full_url, 401, "d,?ed"m !s,JelseE.E+= 1!ifp;req2tcheme =.split()[0]<M>+.lower() == ''S/!y_0z6req=.eln!= 'basicmtRValueu"""~ "3`follows: '%s'" % )/tr ,ftoken,f' ', 1# = parse_keqv_list(filter(http_list(challenge))) auth = self.get_orization(req, chal10if $:BI_val = 'Digest %s' %+ *if req.headerss(|B, None) ==?X nrareturn* `]add_unredirected_Xivv\$spparent.opetimeout=i >Qresp @def [acnonce!, )b# The #-value is an opaqueI^# quoted string +provided by tHlient and usaboth cM"server to avoid chosen plaintext attacks,#jx mutualJuthentic:,|4to 0some message XPgrity0tecl.LThis isn't a fabulous effort, but it's=bably Good EnoughGs = "%s:A" % {.zc_count ,  .c(b.encode("ascii") + _randombytes(8 dig = hashlib.sha1(b).hexd(*dig[:16](,436try qrealm =!['%']W"" " qoV'qop'Dalgorithj({', 'MD55b# mod_A doeFsend, even th2 it p# suppoto be op;2'ZTexcept KeyErrorN\PH, KD0u_impls(5@if HJcuser, pwfpasswd.find__Aord(.full_ur.y# XXX not @emenh5yet0@dataX+2ent _#tyT.B]JelseJe(A1 0alm;|%A2,)method(),selector: what aboutx0xie d y_ urlsIsG# NOTE: As per RFC 2617, when "0s ",h-int",Acoul either `(`# or `auth-int` to the response back. we use `auth$Osend)# if qop is None:\dig = KD(H(A1), "%s:%s" % (nonce, H(A2))):`elif '@' in^.split(',')a1if E == self.last_ )!_count += 1v";els 8 7%~" = _ncvalue = '%08x' % 0c Bget_91+Sbit =b:h k", I,g ~f|3# XXX handle o.[aise URLError("A@'%s'Fnot supported.(Uqop) @_Rshoulpartial digests be encoded too?:1bas|username="%s", realm  3uri 5' \l@ '7#(WN,q.selector,DKV6dig_if opaquS+= ',.kif entdig@7@.@)algorith,/ l@qop=t, nc=%s}(preturn @def p_impls(%, 0# lambdas assume1 modules are imx1 attop level]vZ'MD5'3H =k x: hashlib.md5(x.("ascii")).hex( f?SHAfOsha1gJMD5-sessrV%UnGentication "P " %r&KDIs, d: H(>6"ZH, KD#3ty_g!data, chal"Lemented yete class HTTPD|QAuthHcr(Base , Abstract'}Q"""An,B protocol defined by RFC 2069O 8improves o0!ic!entication b(ecause it does not transmit passwords in the clear..A""" auth_header = 'Authorization'"handler_or$490 # before Basic FPdef http_error_401(self, req, fp, code, msg, x1s):ihost = urlparse(req.full_url)[1])retry = ].q_reqed('www-enticate',?l ?vareset__count()!qreturn  class ProxyDigesthHYS(Base , Abstract'"):aT-O;7!7psCHTTP__init__-debuglevel=0._6 = MNXSQ #L_get_content_lengthLwrequestN{.client.`Connec.NGUZ.dataemethod()) doD1R =A(.}!ifEaise URLEP('no %s given')%ifZ" iFPNone:EPOSTo1& if isinstance(W, strFpmsg = "b ( should be bytes, an iterable of9" \rL"or a fi/bject. It canbD@type-."Dr4BType56msganC.has2('Cl-_'4add_unredirectedA p V Y P'appl`ion/x-form-urlenl-d'(2 9n1anduAT}Afer-|_ing')  fd if content_length is not None: request.add_unredirected_header(5H"'Cn-nz', str(-))C?elsBTransfer-encoding', 'chunked') sel_host = 4if has_proxy()8 scheme, sel = _splittype(:selectors9U_path>F(sel1!ifRk'Host'(5zmi`for navalue inqf.parenxs3! =:.capitalize(X ? 1 7!, dreturndef do_openYf, http_class,+B, **onn_argsB"""RUan HTTPResponse object 60theI;w, usingd.fy must implement B^Connection API fromK@.cli5"""  =. u raise URLError('noh given# will parse#U:porta(i, timeout=req. bD.set_debuglevel.p = dicte.6drsx..update({k: v@k, v%[itemsAif k3in 4}# TODO(jhylton): Should this bdesigned to handle# persis% c&s?:p# We wa*so make @/1.1|"buKaddinfourle isn't predeal with a.E"It0tryread all remainBdatawsocket,BRwhichEblock whileserver waitsBDnextS 2sur>: gets closed after_V(only #V&["a"] = "LrPs = {.title():hV.d}dc._tunn p}K_auth_hdrProxy-Authorization" if proxy_auth_hdr in headers:*5stunnel_ [:4] =:  I0# Pv-Authori should not be sent to originC}server.?delbh.set_S(req. d_host,C=!%) p:try# 4h.requestcget_method(), uselectorEdata{,kI encode_chunked=J3has('Transfer-(iing'))Nexcept OSError as err: # timeout)or3raise URL7J(errWr.getresponse( s 3Yh.clo&fip# If thQ does&send us a 'Connec!: S'Ef# HTTP) assumes[Tocketbe left open. Manuallyh# mark8 toyd when this  object gFawayif h.sock/v = None&qr.url =Ugfull_url0# Tline replac.msg attribute oo/Rcwith . , because urllib clients exp'toGAhaveC`reasonyq. It w pbe goodq'isBis deprecated and get]n<winfo() #rD.mreturn r classKHandler(Abstract0"):def http_JQ(self)Z2.do(2.I.U>\&_]? = Q!0_ j as5(;a0, 'cSd'S __init__debuglevel=0, context=, check_oAnameQak;R_q$ ={$ + n/;sb'pCB=f. 4 https_reques*t = AbstractHTTPHandler.do_request_ __all__.append('-S.') class CookieProcessor(Base)!):Ldef __init__(self, c5jar=None(ximport http.%Ff:@ is =d4+ =E.UJar()Qh& =_, IR.add__header(3{sreturn  ojsponsepB, rez!ex~$s(2<TsE!5"sUnknown u%V_open`type =$. raise URLError('IP url )q: %s' % 0) parse_keqv_list(lg@"""P  of key=value strings where s are not duplicated."""aad = {}for elt in l`k, v =.split('=', 1if v[0] == '"' and v[-1JKqv[1:-1]tq[k] = vss as described by RFC 2068 Section 2.6In particular, se comma-separ*bNthe elements ofmay include quoted-J. Aa could@contain az,Bnon-C0C hav\s1theCmiddle. NeitherJRs norws@nt if theyescaped.BOnly doubley2,8Esing1@rres = [MR = ''_b" =r = Falsg0curs2if 4t += cur, XU2inum"if Z ifU:\\'6b'TrL e'elU"T?hc,c4resP` Y"# P lastZt!if j 'return [part.strip() for part in res] class FileHandler(Bas ): # Use local file or FTP depending on[m of URL51def-_open(self, reqSWPurl =.selector9if url[:2] == '//' and`2:3] !(req.host"AE2+'&aif not.get_names(15PraisepError(" :// scheme is supported only%%")BelsehVqreturn >_7_a!) <!# y3 tha= None\(if.=!is> :try?<= tuple({#`socket^ byoQ_ex('')[2] +> VT ()Gjtexcept -0aie(6 et ,m ot entirely sure whatrules are her  T imr email.utilsDmimetype 1pG % =P2path0(   6stats = os. (L4psize = #)_!modified =.formatdate(<mtime, usegmt=Truelm5 = !p.guess_9[0]`headertmessage_from_string'Content-\d: %s\nlength: %d\nLast-'9' %(or 'text/plain', -$, @)0if !, F= _split ( C6\= _safe_g<<)oBorigP'~:2+! + {LP[Iaddinfourl(, 'rb'), /#, aR!OSOz as exp r6exp?  not on local host') def _safe_getpbyname( ): try return socket.43eexcept&}aierrorF None class FTPHandler(Base ftp_open(self, reqimport ftplibmimetypes =D. aif notJraise URLEb('ftp 1 no0 given')LY!, = _split Z&"if#0is  v0# =.FTP_PORT<Oelse1@int(<%) ,`# user/password hp5ing%#, z!, [$d =(6@ = unquotSser or ''t$ = g *!OSz as msg '6msgpath, attrs!(req.selector/!di(6.=7('/^list(map(' , )G, file =R[:-1]'E[-1]!ifA andH:[0]H&1:= VPfw = .connect_ftp %h!.timeout{ 1'I'D'1fora1 ins#r`, valu( v0!ifJ.lower() == '')\?,O('a', 'AiId'D'8\" =@.uppu e fp(Ptrlen`w.retr( , A QheadeM)""Km,5 = p.guess_full_url)[01if =`m+= "Content-P: %s\n" %9 0if !is} aO>= 0mlength: %doB q = email.message_from_string($ Kaddinfourl(+%q.4r8Q.all_:sB:exp_exc =i%r' % exp exc.with_traceback(sys.exc_()[2]) def0 connect_ftp(self, user, passwd, host, port, dirs, timeout): return ftpwrapper(D,CIpersistent=False) class CacheFTPHandler( # XXX would be nice to have pluggable cG strategies;this stuff is definitely not thread safe3`def __"!__BQ.iA= {}0H soonest = 03delay = 6@max_qs = 16 5BsetT(, Rt5MaxConns6mpm:L- ke@|'/'.join()S0if ;1in u"uq[key] =.B() +:WOelseG_EQ )8"5acheck_(T"6%# first Y for old [`"ifiJ<= tcOk, v in listGout.items()Plif v (authoriza1ed)I `__tempBNone@p= "Pythrllib/%s" % __!"__0nstructo__init__(self,(Pxies=g, **x509`msg = "%()s stylePinvokrequests is depre. " \ ")Use newer urlopen functions/methods" % {'class': self.____.__name__} warnings. (msg, DeprecaVW, stacklevel=3)=if proxies is None:`S= get (?assert hasattr(!, 'keys'), " must be a mapping"h(= key_file = x509.get(e'LAcert . / addheaders = [('User-Agent',version), ('Accepz'*/*')]`__tempM unlink = os. # See cleanup\N@cachn# Undocumented feature: if you assign {} to E,? it@used#dretrieved with3(). Thi9not enabled by default;ince it does /work for changing s (and I?haven't got the logicheck expir <Uyet).2ftp$= !YV`can usdifferenBftp W#byDhe .j member;rqin caseBwantally independent URL 37ers=9XXXthreadsafe. Bah. -def __del__().close()-+Z /# code sometimes runs whenrest of tLamoduleW#[0 aly been deleted, soP cany globalor import anything "if? in* .:try?2.__(Q  exW OSErrorH6pas5=del&[:u X.r1w, *args """Add au be!HTTP interface onlyve.g. u.e[sound/basic')"",3@s.ap(# Externalyt>fullurl, data=\ 0URL2Per().  insteadx, 'r').b = unwrap(_to_bytes(fullurl))  = quote", safe="%/:=&?~#+!$,;'@()*[]|"?if self.tempcache and U+in:xfilename, headers =0[J]8p = open(BF'rb'^return addinfourl(fpj,4urltype, url = _split+`if not) G@ = ''$if1 zproxiesAy  Cies[V  , &Zyhost%,eUector/(/ 3(6 # Signal special case to6_*(DOelseENone 5D_' +-!h]ype ==.replace('-', '_hasattr(Q , 4A) or Q == 'alocal_ "ifo \qW.Dunknown_Y_Bf, data&A*W J:try!ifl@ is r b~1,hdrs = fp.info(!fp.close url2path(Bhostq`[1]), fwexcept OSErrorEpass1 Xf, data _heade~}tq@(:f, 'wb'q>lse=garbage, B0ABZor ""y7#, =g`query(>8Oattr7 suffix = os._.1ext66)[1E(fd,@) = kP@.mks (U __$0s.append2Bs.fdd &`result#, ='i40is  3d'2 = t `bm1024*8size = -1read = 0blocknumif "content-length"Cint((3["CDLD]if reporthookY (`, bs, Rwhile 1LA p.>(bsA!if/J&]breakZ]r += lengtfp.write% >+= nE'IofinallB -"# raise ion if actualB doe4jmatch zNqtA>= 0u knows how to` that 2URLHQdef _9#generic_http(self, connection_factory, url, data):"""Make an HTTP8g usingr_class.}pThis is<internalshould be called fromzA) or7s()dArguments- ltQ hostZS and %an| C$ instance.#-/1the toI!ri1Aor aflative-path pairEoFpayload f:POST request7Non{6"""euser_passwd = )Sproxy Tif is(7str&`, sele! = _split3)i-!if,#I(N J5 = unquote%Creal%Jelse 5url/l# check whether ;Htains authoriza1q inform I5p# now we proceed with0urlAwantb n0urla%stT XS=jtHA ifW.lower() != ''i. 2 Z(rest24if 5!X+"?^"@a"%s://%s%s" % @type / byr Vaif notX: raise OSError(' e a', 'no&w given' if* ` D1 = base64.b64encode(O.Q)).dev'ascii'Q3A_c Wt auth = base 64.b64encode(user_passwd.Q)).de'ascii') Uelse:auth = Nonehttp_conn = ection_factory(hostSheaders = {}Bif proxy__ q00["P!-Authorizac"] = "Basic %s" %F\VP Q;K@realAHost( =# Add Conn :close as we don't support persistentPgs yet.OThis helps in N ing the socket and avoidResourceWarninga"R&e")Bfor -p, valuewself.adds8Sif data is notVB@"ConR-Typeaapplic/x-www-form-url%d",.request("POST", sele,,sM*GEL#s=):tryresponse = Y4get(Qxcept'.client.BadStatusLin# somethwNwrong with(aHTTP s=7 li1raise URLError("`ptocol eX: badA"q# Accor}to RFC 2616, "2xx" q@ indqes that%'s##  was successfully received, unURtood,c(&ed0if 200 <= W.\< 300turn addinfourl(5,?Qmsg, :" + url,AEz h!re_z_q(av.fp ugreasondef open_(,)=)8q"""Use T1pro'6.""_Wrgeneric_dEu00fp,^ aHandleV=Fors.0Derd class can override this, orvspecific hRrQnamedb_DDD where ie 3-digit# B# First check if1{re's a zr for this ecrror name = 'http_e_%d' % errcode)if hasattr(self, :%): Pmethod = get* )if data is NoneFJresult = S(url, fp, msg, headers)`?elsU1, [2if : return%.VdefaultKOdef ?W/, SB"""D|=or handler: close the connection and raise OSEA."""1fp.6(-AHTTP/> ,!) Qif _have_ssl_&s_tKhostto1.client.%SC(6,rkey_file=n.CGcertDBopen= q"""Use protocolX_aqgenericih. aTz 6$`local & or FTP depending on form of URLif not isinstance:7strc2URL`'j:xy supportk currentlylmplemented' ifP[:2] == '//'url[2:3] !12].lower()e&/'RValue":// schemeped only1O"7sI  m_email.utilsNimimetype,= _splitI =P2path((:tryYstats = os. (H4dexceptK as WQe.strV@, e.P0siz)ou_pmodifie%.uatdate(8mtime, usegmt=TruedmCNp.guess_95[0]t2 = smessage_from_string(- 'Content-Type: %s\nContent-Length: %d\nLast-modified'W' % (mtype or 'text/plain', size, <%))5if not host:Qurlfile =  !if[:1] == '/'; ?'@a://' +7 K#return addinfourl(open(localname, 'rb'), headers, , port = _split (&@if (and socket.get4 byy?R in ((),) + this*))5L%el2.raise ValueError("WG may start with /7. Unknown'0of Uq0" %W02URL'e:2on }1') @def 4_ftp(self#"""Use FTP protocol."""=isinstance(url, strE) Cftp proxy sup_P for o currentlyimplemented'J!im<@mimense, path> !nog given~RERuser,Ak,0if :Esswd pa("belse: u = NoneO = unquotelGVB 'g 1 eftplib/;,.FTP_PORT#1@int(<*u, attrsS( ' !di=.07('/1,& = b[:-1], 5-1]!if D\,20]:</1:1A[0] M`0keyu,q`.join(q# XXX thread unsafe!Laif len! .ftpcache) > MAXFTPCACHE# Prune the ., rather arbitrarily_k2Klistj \.if k != key:  v = self.ftpcache[k] ! ?del)v.close()GEtry: Pif key not inV )- yey] = \P'ftpwrapper(user, passwd, host, port, dirs7!iffile: type = 'D'c7elsIfor attrs`, valu^a_split( .lower() == '_' andO('a', 'AiId>D')p\" =!.uC (fp, retrlen)5@ey].E(,J Dmf@mime s.guess_ ("ftp:" + url)[0headers = ""1if V3 += "Content-Type: %s\n" %9 Nalen isANonesO>= 0mLength: %doB q = email.message_from_string($ Kreturn addinfourl+), Mr except ftperrors() as expraise URLE&a('ftp 1` %r' %1 ).with_traceback(sys.exc_q()[2]) wdef open_data(, , =^"""Use ""'."isinstance(url, strC O: proxy sup  protocol currentlmplemented'# ignore POSTed}# syntax of##url :=:" [ media ] [ ";base64" ] ","5c-A:= [t "/" subC*( ";" parameter *urlchar_6!:=ibute "="++ [Aurl.v(',', 1Vq!OS!('"ba~[* Mtext/plain;set=US-ASCIIasemi =S.rfind(';e""1'='3!in4[*:]encodingX$:+1: [:FuR' msc[9 msg.append('Date: %s'%time.strf ('%a, %d %b %Y %H:%M:%S GMT', N0.gm(.U())))Gmsg.append('Content-typ0 % . if encoding == 'base64':O# XXX is this03/de99ok?0rdata = L.'pebytes(.qe('ascii'))"('latin-1'JelseB = unquoteQ/Length: %d' % len45{Lt 0 = '\n'.join(msgheaders = email.message_from_string1f = io.S*IO#f.fileno = None # needed for addinfourlgreturnC(f, , url) class FancyURLopener( )t"""Derived 0with handlerrors we can (perhaps).""" def __init__(self, *args, **kw t.3 [2R.auth_cache = {}@trie04max&10Qhttp__defaulturl, fp, errcode 5msgb?=."orj -- don't raise an exception3pj0, "@:" +)?302 , =q E 302 -- relocated (temporarily`E+= 1{2tryb%1if ,2and>">= >BshasattrG500"0Smeth ^O2+E; I6(Q?500  "Internal Server : Redirect Recursion"I  dresult rT#_it  N{b Ukfinall.+'= * VAif 'tion' in@"newurl = headers['location'] elif 'uri' in headers:&newurl =[/C*se2ereturnEfp.close() -# In case the server sent a relative URL, join with originalm0url( (self.type + ":" + url, (urlparts =!mparse(%@# Focurity reasons, we don't allow redirecY to anything otherthan http,s and ftp.We are usBnewer HTTPErrorElderu_internal methodpaThis o. will get deprecated63.3#ifts.scheme not' ('1', s 0ftp&')2VraiseZ, errcode,- errmsg +% :" Rvq'%s' isced." %v G, fp' VCopen"1def _eA_301,AIDmsg,C, data=None;2"""301 -- also ed (permanently).""""!2(/fp 363 esially identicalE?302U767!refed, but  POST into)or!if  II%`/el ^default;54" retry=Fals 4 2uth4|required.2funPsuppozBasic a>LonlyW'www-(!e'\)0URL%7er.ND4;C)CXstufficate'] match = re. ('[ \t]*([^!+) +realm="([^"]*)"', stuff) Dbif notO:URLopener.http_error_default(self, url, fp,8< errcode, errmsg, headersscheme, " =.groups('2if *.lower() != 'basic'rY_retry&' 0j Dname = '}P_' + .type + '_'e_auth'Qif data is Nonereturn getattre!)(?els@ ,!) Gdef w2407us JG=  v=False)@"""E 407 -- proxy entication required.This func supports B >only."""=Aif 'h-h!e'$inqe.$ =[]L_RxPhost,ector = _splitTMnewurl = 'http://' + host + selector pproxy = f. ies['http']%urltype, !yK= _split()/&1u 55 96i =c.find('@') + 1],7[i:ser, passwdget_user_}, realm, ipf not (13 orK): return None"%s:%s@%s" % (quoteE, safe=''),88:=sel@ = 'f://' +6 if data is:iopen(newurlOelse3,f!) _0defN1ry_-_s_basic_auth(qU, url={)o?, ` s?sC _promp ?:" =gAE """Override this in a GUI environment!"""`import :try = input("Enter name for %s at %s: \x)rh0get V DwordV*in\Mrb9except KeyboardIJruptWprint:Vg, # Utility functions _local " =)~(B"""Rthe IP address of Qmagict'A$'.vglobal q,'iff.Pocket byk(k:0 _o4 eqcurrent O tuple(s;_exR))[2]4Azaierror2p^gba _ftphsbc0set?8raised byPFTP classhal _ftperror s if _ftperrors is None:mport ftplib2=R.all_F'greturn\ _noheaders =gU def "()wB"""R=an empty email Message object."""jvglobal ^[." =_".m__from_string("")NR # Utility classes uwrapperC" used by openC() for cache of FTP connections-__init__(self,Qr, passwd, host, , dirs, timeout=None,Epersistent=True_q.user =e<q# =z ! = 4:ort! = $ = refcount = 0keepalivep$2tryZ(oexcept(Wclose)-araise aKUSiJ%^.busyEftp ^7FTPs6Cftp.).z!, l E!=Rlogin;0/`_targeed'/'.jo3&UCcwd(3)retrfilen , X, typt!endtransfer!ifC in ('d', 'D'): cmd = 'TYPE A'; isdi1Jelse(1' +L.R.Avoidcmd(cmd 87libJ':H\<.!ifO and not m# Try to ieve as a7K OPRETR ' 6%Aonn,_Rlen =#n (7 ,>P_permjreason4rif str()[:3] != '550'-1P URLE ('Xk: %r' % K.with_traceback(Msys.exc_info()[2]it d# Set P modeiASCII!j fa6 ectory listing. Verify thatexists. if file: pwd = self.ftp.pwd()%>try:IU@cwd(~Y'except ftplib.error_perm as reason|<raise URLE7a('ftp Bs: %r' %Ac) from ofinall >pwd cmB'LIST ' +h d?elsy7'/conn, retrlenntransfercmd(cmbusy = 1 Nftpobj = addclosehook(`P.makes('rb'),Aile_)[refcount +`yI/3## Pass back both a suitably decorated object and aieval lengthreturn ()tdef end()+.02 ,keepalive = False"if F<= 0j QR.real@(g& ww-wK2not ;Gf's(?pass # Proxy handling getproxies_environmentAB"""R& a dictionary of scheme -> ?y server, 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 anyTAcond"eAonlyHj`q, value#s.Y.item/+! =.N}#ifDY)[-6:] == ''[+r:-6]] =B# CVE-2016-1000110 -we are runningCGI script,:get HTTP_PROXYL(non-all-i);i6y:2set4webaby a ":P# hea/cclientjIf "proxy" is lowercase, it will st8be used thanks to the next block if 'REQUEST_METHOD' in os.environ:'+ proxies.pop('http', None)"for name, valueE.items():+M!if.[-6:] == '__&y'"&Q! =*r.lower(m"ifn 6N@ies[B[:-6]] =,'Oelse=Asreturn eQ def y_bypass_=ment(host,Aies=2sp"""TestJ should not Ya particular P!. @Chec!he`py dict 2Rof no^s, whichfB"be a list of comma separated DNS suffixes, or '*'^1alls1"""Niaies iskS= get (# don't I,0 isspecifieds6tryd*=Q'no']*except KeyError6QFalse*#1is k0al _Cways,_*Y2TruX! =: # strip porf"^2Ronly,= _split)X4c ,5 ends with any`+=.cG(','%+amH1l2 '.') # ignore leading dots& ;s/oQ >q= '.' +i ik.RQ(3) y# otherwiy # This code tests an OSXfic data?ucture but{,able on all # platformsmacosx_sysconfYy_settings R` iff t\[@cces usayfunctions0Mac framework SystemConfigura.*to fetch6P@y in#e from _scS._getget mocked i { 'exclude_simple': bool,  eps': ['foo.bar', '* @.com 127.0.0.1 C0/16}Sm@fnma im fnmatch hostonly, port = _split ( ) def ip2num(ipAddr):parts = .@]('.')"list(map(int, 8)&rif len(V != 4dh"s + [0, e])[:4]qrreturn *[0] << 24) |1'16282[3]# Check for simple6b namesif '.' not in if proxy_settings['exclude_N&']-1BTrueIP = NonPvaluep _P.get(ceptions', ()p# Items9@the  are str like these: *.local, 169.254/16d!if: continm = re.match(r"(\d+(?:\.\d+)*)(/A?", A Am is\ !if^ IP#x:try4G`socket( by 4),except OSError+fAbaseEem.group(1 &tmask = 21if !!is+t= 8 * (D1).countJ + 1TOelseI incsk[1:]*b< 0 orN> 32L # System libraries ignorvalid prefixEgthsgQA32 -~L01if QIP >> a) == ( Lrelif fn @ <False if sys.platform'darwin'Ifrom _sc0 ima _get_a,2ies&bypass_macosx_sysconf %+g()b, 40getu-ieB"""RPa dicary of scheme ->b server URL mapp. This funBP uses MacOSX frameworkConfigurap~to fetch:@y in'.(5""" (Mries() H_A #,  should be 8'edsttings gathered from the environment, if specified, 5or /MacOSX framework SystemConfiguration. ;5""" proxies = get _%()+3if !:areturny_bypassBQhost,6iesOOelseImacosx_sysconf(L)7def&()L7 or9_b ) elif os.name == 'nt'_ u_registry~B"""RPa dic|ary of scheme -> y server URL mappingsWin32 usesk to storeE(ie3%{}2tryimport winreg'except IZError6# Std module, so should be around - but you neUknow!`zRnternetSett"# =.OpenKey(.HKEY_CURRENT_USER,pr'Software\Microsoft\Windows\CurrentVersion\Ix y'LvyEnableQueryValueEx(iBAHS'ProxdU')[0]&5  "# ed as UnicodeproblemsZnot converted\YASCIIiMST= strv;kp |#if '=' iy,+# Per-protocol sJ ,[for pV.split(';'e-_, addresSp:^=', 1@P# See;has a type:// prefixB0if  re.match('(?:[^/:]+)://'G|= '%s://%s' % (%Dies[34] =  # Use one 0allsN8 A[:5]Shttp:' ')'yFi\>P Q ^  proxies['https'] = ://%s' % "yServer 5 $F2ftpD?ftpB internetSettings.Close()gexcept (OSError, Value 2Typ %):1# Either registry key not found etc, or the vPk in anDunexpected format.! already set up to be empty sow@hing)doBEpassareturnkAies sdef geth(B"""R1 a dictionary of scheme ->K URL mappe^*Es0 ga91rom! environment, if specified,FKn.`5"""&_[ ()M"()N  @y_by9_!Ghost:tryimport winregYIP 6# Std modules,`should!arG- but you never know!a0 # =.OpenKey(.HKEY_CURRENT_USERjr'Software\Microsoft\Windows\CurrentVersion\Ix z'tLkfEnableRQuery,x(Hb'ProxydU')[0]&5pOverrid4str ;m" p r# ^^^^ 1ed as Unicodeproblems"i`conver<to ASCIIz v 1 ifA+(b !F # to make a 3p list fname and IP addressrawHost, F= _split (G&C = [1 d = socket.get; by(>W!ifC != $D.append(aBq K Ifqdn- #Scheck0 en replace # '<local>' string by the host entry andcorresponding # canonical0.proxyOverride = .split(';')1# now check if we match one ofPregisfvaluesmfor test ini:_"if&Q== '<*>'"&a'.' noO~rawHost'+return 1f=j.replace(".", r"\.")8 # mask dots<*<%.*<change glob sequenceG?GF8 # GIcharCS0valRaif re.(`, val,.I). .!0 z2def_bypass(xKB"""RpPTrue,%" should be 82ed.QtCPsX settings gathered from[environmentZspecified,Kd4he e5"""&ies = get _^(i:ies0r=y  B,6iesOOelseI^& 6# By default use variable ^se classesdurllib. The ba"P, add,ines a minimal file-like interface, incluq read() line(). b1typ se object is an addinfourstance, which n #() metho?2at s headerL0d a#?url+@url. import temp __all__ = [' 0', closehook url'] iF(Y@._TekaryFileWrapperE"""B #L5add{0. Igood idea-garbage collection.;+# XXX Ad9o expose timeout onpunderlyrsocket?F__init__(self, fpcsuper(10, #%).2bfp, ''elete=Falset# Keep refer around as this was partoriginal API.fp = fpCreprK '<%s at %r wh%Aq%r>' % 1.____.__name__,  id(self), .file) 9def __enter__%:#if0p.closedraise ValueError("I/O operation on 7 q%")Xareturn\ 3xit, type, v], traceback)`() class addhook(addbase4A"""C$ to'" a + nnH."""'in2fp,;:0, *CargshPsuperzC).__L&fpL& =_3#j! = k 6try2&H! =k'_& %&if fCoINone@&^? = %F(mJkfinallL 2@info -Qadd an &) method1oheader$YAKA c.;%30url 9"""() and g$l(s%, url, code=z 5w&C 3#, <Purl =Z;.fN2ode.0@pr!ty(ostatus> E>00get1iurl """ robotparser.pysCopyright (C) 2000 Bastian Kleineidam,,You can choose between two licenses when using this package1) GNU GPLv2!d2) PSF> for Python 2.2u2Thes.txt ExclusProtocol is implemed as specified inhhttp://www.stxt.org/no@-rfc`( import collecjsqurllib.E request __all__ = ["RsQFilePwR"] R(ARate;d.namedtuple("&C", "]s seconds" cjToprovides a set offfaread, answer questions about a single robots.txt file. """ def __init__(self, url=''):)-.entries = []sitemapdefault_=y = None=disallow_all = Fals" set_url(url)[last_checked = 0Qmtime"""Returns the # AP was [ fetchedR)This is useful for long-running web spiderdat need to8Rimpor"7 " =C&()1 URL referrxLto aN.6O0.ur:urlRhost,Q`path =!lib.parse6 V[1:3]?reagBReadh\and feeds itZ ]r6tryfprequestAopen dexcepterror.HTTPE z as err_ if.code in (401, 403|I 6Tru%(elRp>= 400 2errfZ< 5009^ [Jelse4raw = f.K\p(raw.de("utf-8").splitlines()B_addY!, `if "*"&.useragents#6 F9@cons!edc"if55U ^/b[firsthIwinsZ/[ [=+`5ies.append(y3d*!, Q.@"""PE Rinput#_ fromZ1We @ thah-i:Cnot preceded byone or more blank2%s.!w# state`# 0: rtt`1: sawr^\#2##an4or 3 -{^ = Entry self.modified() for line in%s:"aif not state == 1#entry = EwD) 0zSelif ?= 2cself._add_m(H"# remove optional comment and strip% 1i =.find('#'if i >= 0=I[:i]V.y W continueRplit(':', 1@len()3[0]4[0]k.lower212urllib.parse.unquotem%[1G @!ifbu= "user-agent"U0P 'T/X$.s.appendY) 1>p= "disallow !qS@rule\uRuleLin, False)I2Y?Tru4crawl-delays+ # before trying to convert int we need:makl@# suHhat robots.txt has valid syntax otherwisJ it will crashr.isdigit():i?o = int  7Srequest-rate+tnumbers"/# check if all}ues are sanv@if (ctfaRhand numbers[1].strip().isdigit()): entry.req_rate = RequestRate(int(numbers[0]), O1]))["stN2" elif line[0] == "sitemap" # According to http://www.8s.org/protocol.htmlt # "This directive is independent of the user-ag,M so it doesn't matter where you place" inr file."NT8fore we do not changeNparser.JFself ap(6[1]2if RJ== 2wAQ_add_(!) mdef can_fetch(*,.-W, urllQ"""us1he d robots.txt decide ifB\ \K&"",disallow_allreturn False74 6Tru3q# Untilu has been read or foundr#`exist,must assumPat noyFable!# prevents fP posis\1n a0 erroneously}PcallsGA) beU&()s if .last_checked]# search for given Gches[Afirs+ch count!"`_url =$Alib.A.url G(url`nquote?"unAq('','', dkZ.path Hrams/cquery,Afragment z+ur&"/`2 in:ies0if y.applies_to(24V2ancPQ# try rdefaultc +%f#8 lg '.yf==> access granted^rawl_delay gmtime(&6Non$Qc return s elf.default_entry.delay return None def request_rate(self, useragent):'?pif not !w.mtime(!]Afor 2 in;6iesX'"if&.applies_to(,kLQy.req  qA'N+ 4site_maps1 &%${Pd6|__str__kYies =Y 1 is~ N 1+ [ G]`'\n\n'.join(map(str,ies)) class RuleLineu"""A rule linea single "Allow:" (a ance==True) or "Dis$:"(False) fo;ed by a path.""1c__initQ, !, Vn = == '' and<*# an empty value meansX, own0 = p urllib.parse.urlun (5%))D* =I`quote( -& =\, filename, .b50"*"..startswith()gZ(B" ifFelse") + ": " +)Eny has oneAmore-sEzerosV[EO< = " =;" /:ret`!p0retend(f"User1: {@&}"On RaCrawl-21: { X[4ate.R-0: {2s}/xseconds0ext'(7ret ^F"""checkCthisapplies to the specified agent""" # split the name token and make it lower case6AuserK5 = .J("/")[0].7%()42for in self.:%s:&#if)j== '*'!# we havecatch-all6 K.return Tru "&inaaFalse def allowance(`, filev)U"""PreconditionD- ouCapplies to this entryg-Y is URL decodedEline@rulesM0if .sO_to(*2"""createmPnipulC data types`Python import os as _os, sy 4sys9!  __version__ = "1.1.0" from _c% ZUnion, Structure, Array,_PointerCFuncPtr *3RTLD_LOCAL, oGLOBAL,ArgumentErrorscalcsize X if $!=,raise Excep2("Vl number mism(",O,M)q0os. == "nt"cTFormaDEFAULT_MODE =Taposix"r_sys.platformqcdarwinu# On OS X 10.3,r2use\o0default mod]e# beca* does not work at least on som8libraries. xD` 7, socheck forWr# that.dif int(_os.uHP().reme0'.'R) < 8]@1 &FUNCFLAG_CDECL_1, \ PYTHONAPI.2USE_ERRNO22LASTERROR6 # WINOLE-> HRESULT _() # # STDMETHODCALLTYPE(j)(=,QC5API@ _string_buffer(init, S=None, .aBytes) -> character a create_s(tring_buffer(anInteger) -> character array create_s7Bytes, ?1"""Gif isinstance(init, bE!): kif size is NoneQ= len>5)+18_sys.audit("ctypes.2", xK)>0buf4P = c_! * 3 = &(8.value =X1`return2/el7int ~;?buf raise TypeErrorgt def c0X, =P): ##c"deprecated, use7 Cead"5import warnings. $("{e,PDBionWx, stacklevel=2VF) _c_funuP_cach !{}4CFUNCTYPE(res`, *arg ss, **kw?""", use_errno=FalserP_last"orion proto|!. P: the result : a sequence specifying4rargumen6sUNThe r can be called in di}=sways to/! a)able object:]"(i addresseoreignI3S,b and r1a CvEfrom Qindex, method name[, paramflags]qfUISa COM= a(ordinal number, dll)c ex]ced by K ba*A^@ = _FLAG_CDECL$if kw.pop("1", C|DUSE_ERRNOHMLASTERRORQvV"unexpected keyword (s) %s" %bkeys()K7trySo 6[$|!, !)]except KeyRclass CF0ion!(_5PtrN _argtypes_ = argtypes @_res! Aflag? q_c_func;scache[(?,i!, 4p)] = CF.uionTypeFkreturn if _os.name == "nt":3afrom _us import LoadLibrary as _dlopen/FUNCFLAG_STDCALL4  ?K_winQ = {}pdef WIN:FTYPE*gr, **kw)r# docstring set later (very similar to CT.__doc__)qBO@ = _#" if kw.pop("use_errno", FalseM|NUSE_ERRNOP@lastU/orULASTERRORYraise ValueError("unexpected keyword\ument(s) %s" %fkeys()(;try[h except Key \class Win!(_;Ptrv_#u m" $G D, = N #i %'0UNC;.replace("G", ">l") el_posix! / Hsizeof, byref, addressPalignt@, re'@!ge0no,%/no)_SimpleCData Hp_check_[`(typ, Vcode=Non0# C&@ if )2of(_-) against struct.calc'b. Thi # should protect somewhat=a misconfigured libffi.4^{e %if@ is q# Most _ s are the sas used inT1 =`.C`actual0qui=dtyp), TeC!2if :b != re<aSystem ("Iof(%s) wrong: %stead of %d\,wB)) >py_object(;a = "O"d4_repr__(self)x ret urn super().__repr__() except ValueError:"0retA "%s()" % type(selfS0name__ _check_size(py_object, "P") class c_short(_SimpleCData)p_Sy_ = "h"K4DuEHE5FOlong lD3BuC LC4) if _calc.x"i") ==2l")# if int and q have the same A, make c_( alias for c_3=u2R elsew/in!i"bn!) Lm/ MIM;zOfloafz4DodoubleEdE5F_J g"2of(7  =l=q=>C ? anH _DR!0 q ; \WQW ##ndef from_param(cls, val}$(a('d', K('-PLvmethod({ --[Oubyt QB" c_(A.__cB0le_F b # backward compatibility: ##c_uchar\ pb'  vucu'u u u u/_pw z^Xm)LS!%sOK1R__.__T, c_void_p.@abuffer.0).v)_p, "P") class c_void_p(_SimpleCData): _type_ = "P" )5p =3# # backwards compatibility (to a bug) _check_size(D_p) class c_bool| ?" from _c s import POINTER, pointer, _ Vcachei_wchar !Z"def __repr__(selfreturn "%s(%s)" % "1.____.__name__,*.q_buffer.w).value  Au" areset_(.clear()a_c_funA9 pif _os. == "nt"O_win= (# ;1.c_1_p_Qparam(!) U77 _^ ],_p\6a[None]tcreate_unicode`init, =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 (1 Rper U~ ]$#  1len _sys.audit("=/s.!", r0bufN! *?cbuf = '9"! =Y1~1buf/el7int  raise TypeErrorm # XXX DeprecatedBSetP1(S, cls.get(cls,)1not oraise Runtim`conven- (named 'cdecl' on Windows). ,3Thee'eddcan be accessed as attributes, or by@PindexAwithb {. Examples:q.qsort ->Rable @T#!['$/']&'C us releasee Python GIL dur7,2 ank reacquires it afterwards.d1"""_ _flags_ = _FUNCFLAG_CDECL#1res8 = c_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"b"""Whe contains ".a("` ends BM ")"ue.g., "libFOO.a( bso)" -[ akfon archive(membasyntaxdlopen()," is adjusted JOtherwisei,0preded to S9 file argumentLaU!if-.Q(")")6!in) B|= ( _os.RTLD_MEMBER |BNOW 3!ifp == "nt"X3if ) $I|=, Nelse1 im (CKnt._LOAD_LIBRARY_SEARCH_DEFAULT_DIRS  if '/' in name or '\\(: , aself._0= nt._getfullpath(!)Abmode |< LOAD_LIBRARY_SEARCH_DLL_EDIR Bclass _FuncPtr(_C )_flags_ = ?_restypeEfunc,`% =uif handle is NoneA"= _dlopen , ?elsC Ldef __repr__Treturn "<%s '%s',%x at %#x>" % \1 H1.__fA__._B__, ,56 & (_sys.maxsize*2 + 1))7!ido)2dgetatt,!if.startswith('__') and7end raise AttributeError("# =kitem__&s , :H Qh;_or_ordinal:(0)w ot isinstance27intgk! =He : PyDLL(CDLLT"""This  esents the Python library it. It allowskaccessing01API^tions. The GILnot released,BhQexcep5C ared correctly.-1"""_O_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#`mentedC, so that the  -# method definition itself is not included in the traceback Bp # whe7 raises an error - thatJwwe want (and PythonEdoesn't have a way toSRBxcepcaller'sCuframe)._check_retval_ = HRESULT )class OleDLL(CDLL):"""This $represents a dll exporting func@s us5theEWindows std $`conven6 , `returnW@valugre automatiTy-d as OSEe>sU5""" _a_flags(FUNCFLAG_STDCALL)prestype+" $LibraryLoader(objectQ`def __f0__(c,EH!rP._dll$ ="BugetattrEn0if [0] == '_'a Attribute'(1))= "s>C Oitem5])EYd!E!__B_get" =  (_ys.GenericAlias) cz"er-? py PyJ if _os.#B"nt"paapi = -"("5 ", None, _sys.dllhandle) elQplatformVocygwinZ2lib]P%d.%dQ2" %]version_info[:2]d/se/) ?win1Win?ole#qGetLast2 = V.kernel32.qfrom _c0 im get_last_9, sS1Winh`(code=q, descr 0if #&$(= ("ifS<n = Formaw).stripH(2)sizeof(c_uint)(cvoid_p c_ _t ,R7c_s2int|UOlongV-W X\1` # functions from _ctypes import _memmove_addr,4setstring_a2cas ## void *B(s, const, size_t); ' = CFUNCTYPE(c_5O_p, =()|5set{5intrq?setp6(c_m) def PY0resA`, *arg s): class CFunctionType(_3Ptr$(_8D_ = B` Pflags_FLAG_CDECL | PYTHONAPI8jreturn0 _( =py_object !)(>#)M(obj, typx+!5 _Xvc_int)(4zHB(ptr3=-16""" ["b]) ->  %R%3the@ at 2A.""""66_atqb) try>frobw5 except IRError=pass else_8&5m),{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 ! l._endianABigEStructure, Little # Fill in specifically- d1es 8 = c_byte c_uintufor kindGq[c_shorGY@longV]!if0of(<)12: nA16 =R /el+4+/32+ 8: c_int64 = kind for  in [c_ushort, c_uinAlong ]: if sizeof(Is) == 2:9316 `*/el,4,/32,8,$64,2delx- _reset_cache() """ Lib/ctypes.util.find_library() support AIX Similar approach as done!eDarwin4by using separate files but unlike 2- no extensioAY\macholib.* dlopen() is an interface to AIX initAndLoad() - primary documentation at: https://www.ibm.com/s/knowledgecea/en/ssw_aix_61/com2aix.basetrf1/O.htmZ=AloadX 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 only0ABIA`ed, orxdirectories 2CSmost QAsoluay fO  (iEAIX)z20y (b sufficient as i "ies can beP - evp0harmAsameK. In= -Prefer to\#"" ?is ;a"Z(read)a callsEs . Default activity occurb1no  inais provided. When p`ath information is provided dlopen() does not search any other directories. For SVR4 - the shared library name`Athe !of' file expected: libFOO.so O?AIXN is4 ressed as base(member). T`is forj $t (e.g.,ga) and once#GQfounds- identified by s Vso, or shr.o)OPlocatnd loaded. -mode bit RTLD_MEMBER tells initAndLoad() that it needs to us"R(SVR3) naming style. """ __author__ = "Michael Felt " import re from os environ, p8&syxecutabl8Uctypec_void_p, sizeof ?ubproces(Pu, PIPE, DEVNULL # E^0EP - 32i`64 # U to filte`in an aive by", -X64 AIX_ABI =4of(s) * 8 0max def _last_version(libs, sep): & [!, ]S4pparts =sp.split(w#0num"[52tryB whL @.insert(0, int(*.pop()))iexcept ValueErrorLEpass,preturn \[M`max(reU%edT), key=_K!) get_ld_header(x# "nested-func, but plact module levelEq = NoneAline in p.stdout0if 0.stwith(('/', '.G./')Xg=gelif "INDEX"ok"!B.rstrip('\n'"_#)#p5an 0 waeSund, |Qknown'$s,zsk1 #b!se?!s @ @ a digit3 = re.match("[0-9]"+neT`.appen]"ne8^Jelsepq# blank ^arator), consum1endmAloopRQbreak  s(=3Par 9IAr see$l Th unction calls /usr/bin/dump -H as a subprocess and returnlist of (ld_header, _info) tuples.>1"""e# get_*s parsing:$1. Find a line that starts with /, ./, or ../ - setQG2. If "INDEX" in occurs a followingd-E 3. (s:a[0-9]).3ldras = []p = Popen(["/ud", f"-X{AIX_ABI}", "-HQile],=tuniversal_new=True, stdout=PIPE err=DEVNULL# be sure to readthe end-of-file -tall entrie wh ld =8"(pt%&ifG;".append(= AF(p))YJelseQQbreak+"p.r.close(5cp.wait  Q deffshared"s)hextract >,able objects from>0cha2er "[" is usestrip offMApath^rrmation*QNote: =vE"]" Ss0are;aoutputnot removed here_d2for@, _)(s# potential memberCs contain-otherwise, no Moeneeded* if9u+in6# S5@rail@colon (:m]/[.index("["):-13 one_match(exped libFOO.a( qso) hasiwbeen found. V1ingis expected to follow9GNU LIBTOOL conven0s: C@ (x,Un X.y 3Y.z* find [oo.so.X]e /.Y 2.Z]`Beforev b becamstandard scheme regardless ofSQ size/packagers used[q"as-is"KEsarchive[Rs but?an "distinguishing"x  Pinsereither 64 or _64 betwP!OOy1.so- generally-1so,@occa$64;#U es-D end@s must start 0# 's[0-9]',3*`at lea.ne digit# while multiple, mspecificrs 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"*.as E#2= [-1@line13!me"e.@line) if m:  versions.append(m.group(0)),4if ' Areturn _last_#(bs, '.'E( None def get_member(name, "s)`1"""}R`an archive( matching the request in M.;qName is!qlibrary without any prefix like lib, sufA.so,K$or0 nubGiven a list ofs find and rmost appropriate result_PrioritygTto generic0XXXo_&eda.a.b.cMxfinally, legacy AIX/bschemee# look first for a~g -(r,A .souexpr = rf'lib{a}\.so'! =Aone_U(4*rCD%@elif_ABI == 64.T &64QJ6# since an exactd4 asS`was noa1undxr? DIf a{ edG, orHh vp&seql(m&s)libpaths( On, buildtime se1`storedEexecutablas "loader heinformation"The comm /usr/bin/dump -H extract%0is =5PibrariesLD_LIBRARY_PATH (Geerred)11LIBif defined. These Ps areended to toktPpythodalinkedThis mimics\ dlopen() behavior' = environ.get("" if} KC![](ellc .split(":`@obje2ld_&s(:(_, lines)`;#sH#second (opsal) argument#icludes a /DP! =2)[1`if "/"- 0ext&L(":")) return libpaths def find_shared(, name): """ is a list of directories to search for an Aive.=P<the abbreviatedh` givenAlibrary():Process:^""frchive, and ifvlQfound~r}Qresulget_memberkIBAnot Fc then GANoneWqdir in 8<`# /liba symbolic link@/usr, skip itU7i[P == "!"Qrcontinup# "lib"gprefixed`emulate compilermresolution,p# e.g., -lc9Elibcbase = f'lib{E}.a'! =.join(dir, 7)'"if sexists(6a@s =  ld_header:[:9G(re.escape(2), s:#if@ !=  k](F EOelse8V,\6PU"""AIX implementactypes.util.;yHFind that will dlopen(). If available:als file (or) with a .'quffix. zsupports two Pschem.can be usedKFThe so-called SystemV Release4 (svr4)0matcommonly se wh(default) @ has bendingCc1 .a(AshJmultiple^2s (ba32-bit 64 )61one[M_@argu@ pas#to must include bothaDIsea single string 8 looks firsE (.a@suit(E+ pasG,`6P=L(= ,O!if0f"{2}({2})"@# To@ herbJ6:Bbeenv# In other words, ei@# a)aA was~j?b!1did!{have a }2/So^ # Check lib@paths for .so file # Note, the installation must prepare a link from a .so <to a versionedV*This is common practice by GNU libtool on other platformssoname = f"lib{ Q}.so"`dir inG:@/libza symbolic pto /usr, skip it70if S@== "!"QUrcontinu2 she = }.join(dir, )V"qexists(6)[creturn:9# if we xPhere, have not found anything7CusibMNone import sys fsctypes * _array_0 =  (A) def __endian(typB"""R37Q withA'4' byte order. SimpleaRs likFc_int and soalready !__Q_be__$Ale__%attributes which 1ain!s,@moreplicatedCs_structuresv0sup<1ed.)"""x# check _OTHER_ENDIAN (present0typprimitiv`if has7V,Oed?get,/oQif is3ncehf .)@_) *3._length}s;wsubclasswS\u1typ6raise TypeError("=Q does.p: %s" %1) t _swapped_meta&e("_sY__(self,is, value,%if "_fields_"Q = [];0esc[ 7#x = desc[0>1Drest=.2: .@nd((l,@) + Kwsuper()._G]5O) #," e: The  *Pce* (.Rthe #v!) of a!!s_J to determineH2bite in # Pntain%b@ ifq.[/clittle- =4= "!" aL1Ez=';Big*, metaclass=_swapped_meta): """Structure with big endian byte order"""3__slots__ = ()b5sNone elif sys.L == "big"_OTHER_ENDIAN = "__ctype_le__" `ABigE%= #class Little,(* , +=lU;"se raise RuntimeError("Invalid2") import os eshutilubproces ys # find_library(name) returns the pathc of a (P, or . if os."Bnt":def _get_build_version(ZRji!hMSVC that was used to H Python.d3For 2.3 and up,Snumber is included inA{}0. Oearlier s, assumeUbcompilO%6.K# This functioncopied from Lib/distds/msvcZ5.pyR`prefixfMSC v.e1i =6.(/s@if iN"-1M% 6hN}i + lenEzs, restp[i:].split(" ", 1ubmajorV = int(s[:-2]) -s)f *Z>= 13 E+= 1>mind2:3]) / 10.0*# I don't thinks are affecteG P5 in # K== 6 i;>; Jselse we`know w. CPEs isBmH@_/rt!of BVC rH dll=%iff!isO O# better be safvan sorr \ k!None el == "posix" and sys.platformrdarwin"from ctypesoCdyld _U as _t possible = ['lib%s.dylib' %,F0''framework/%sU]]4in w:tryb^ sexcept ValueErrorG Xc.startt4aixs# AIX has two styles of storing shared 1ies # GNU auto_tools refer to seAsvr4(3aix4(System V Release 4) is a regular br, often31.soR5uffL uses an /aive (s(B .a)?members (e.g., shr.o,bssl.soy# see issue#26439q_aix.pymore details*/D# Andreas Degert'sm functions, us gcc, /sbin/ldconfig, objdump_ re, tempEM_is_elf(o""RpTrue ifa givenQn ELF"kelf_header = b'\x7fELFSU opentp, 'br')0theN.read(4)ZlerLib_gcc@N# Run GCC's linker \-t (aka --trace) ophpexamine#)Y it prints out. Theh command will fail because we  # haven't supplied a propergram with main(), but that does notKumatter.expr = os.fsencode(r'[^\(\)\s]*lib%s\.' % re.escape(name)) Nc_compileTshutil.which('gcc')) if 0:: = HGu# No C available, give upvreturn Noneptemp =  file.NamedTemporaryFile(:tryargs = [, '-Wl,-t' 1o',[.JPl' + ]env = dict(os.environy#['LC_ALL'] = 'C'env['LANG S@proc ub ess.Popen(,].stdout=sF?IPE@8err@oSTDOUTB{env=env0xcept OSError: # E.g. bad execut+ &' #ptrace ="c.W.read:kfinall>X.closyfeNotFound # Raised if the p was aly removed, 1 is'onormalNbehaviour of GCCXlinking fails46pas re$re.findall(!, 63:resah2for=in 2p# Check n.s an elf: gcc caC6porGnR# som;pat are er scriptMdKactu:# shared objects. See bpo-41976 more detC _is_elf()vcontinuJ/!de? p if sys.platform == "sunos5"a #  /usr/ccs/bin/dump on solaridef _get_so+(ff] y-("", "-Lpv", f)DP,DEVNULL) except OSError: # E.g. command not found return Nonewith proc:>adata =.stdout.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 eobjdump = shV.which(''B`f## 1 is;available, give upT >tryb ub ess.Popen((y`, '-p'j.dynamic', f),_|T'=sf?IPE@8err@zDEVNULLOe4bad execut; 21 41+:ump+;if sys.platform.starts(("freebsd", " dragonfly")): F(hnum_version(libq o"libxyz.so.MAJOR.MINOR" => [ !, % ]]ap3 = X.split(b"."-0num[>awhile Y tL.insert(0, int(.c.pop()p)qRValue #IpassnhP or [maxsize]\find_library(Yebescape% n@expr#':-l%s\.\S+w@\S*/a)' % (P!,  aF!en)q#a'/sbin/ldconfig^?-r'Uj = b'' 9 proc:   data = proc.stdout.read() (res = re.findall(expr, >))if not res:Mreturn _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/>'4FNonexenv = dict(os.envirenv['LC_ALL'] = 'C'D!if ]0arg z, '-64'NOelseBbe j>tryUx` = sub ess.Popen(,AK =F?IPE@8err@DEVNULLC{env=envIxcept OSError: # E.g. bad executable( BAwithHfor line in");)=0z.strip($$if$@arts~(b'Default Library Path (ELF):H).split()[4]J9$ A 1dir Caths`?":"libfile = join(dir, "lib%~A" %  h%if8Qk0% i""_ln = FalsekGdBF) or S_ldconfigP import structBF.calcsize('l')4@machu4().y+ '-32'_i2G*64G1_map = {`Vp'x86_646: 'libc6,x86.K'ppc,o64bit'+Ospar-@390xtXia64-64': 'libc6,IA-64', } abi_type = mach_map.get( ine, 'libc6') 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_ALL': 'CBLANG ~}) 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(zcontinuvrO xE>ion?0 #~will beo _library(name):  # See issue #9998  return _findSoname_ldconfig(i) or \3?a_get_s3(?rLib_gcc78##ld"? #, # test code def1():from ctypes import cdll`if os. == "nt"4`print(+.msvcrt)3 bload("!,")#O_library&J }Wposix # >P and e_version;$b c! 0bz2#f#}if sys.platform6gdarwin>TLoadLlibm.dylibg*p 2ocrypto7_Systen4framework/#F-26439 - fix brokenx call 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'6ind.8rpm' " 5Oelseu:?_64xUk){!f"{i\t:: {k''8 JIJ oo :9o') L /??.so3 ")` if __!__{__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): _<q_ = "v"def __repr__(self)-return "%s(%r)" % "1.__t__.__name__, ;.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 .$ifdsizeofR5) = y-!c_\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(SRB9)TAPW WN&.2SC_ !SERVICE_STATUS1RSome ant structure def8initions class RECT(ctypes.Structure): _fields_ = [("left", LONG), $o("top"Origh@ dbottomCP] tag@ = _1L =a_SMALL#'Left', SHORTO'Top R" B#&] _COORDXX,%'Y]]OPOINx[$"yV  ~OSIZE/"c~ cW0 = | def RGB(red, green, blureturn 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) W)ed0", DWORD);, ("dwReserved1", DWORD)( cFileName", WCHAR * MAX_PATH1Alternate:14)] #, # Pointer types LPBOOL = c.POINTER(!) oEAN = @EAN)I1YTEI )aYTE) P  FCCOLORREFh&tj k)qFILETIM /) PFLOAT}QQHANDLO M~) PHKEYJIKt < KL INP #INT) PLARGE_>GERe /?CID&0CIDo@LONGM q&!MS% $0MSG#3J '1) PJ1REC H&GP (Q2SC_p) PSHORw Gp1SIZ '4IZE&P' (LnPMALL_RU P PI) PUS 1 O!PUH2) P WIN32_FIND_DATAA  "JWJJ WJ OR P ) |2s 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/trunk""" Enough Mach-O to make your head spin. Seerelevantqer filek/usr/includeb-o And also Apple's documentation. 3 ____ = '1.0'dyld emul- import os 0.framework import framework_info from ctypes.macholib.dylib import -itertools!* try: N_O_dyld_shared_cache_contains_path except IoRErrorMOdef = r(*args)1raise NotImplementedT __all__ = ['find', 'fra#.(', ] # These are the defaults as per manCd(1) # DEFAULT_FRAMEWORK_FALLBACK0os. .expanduser("~/Library/FAs"),"0Net# oSystem"%] LIBRARY6libusr/local/ "1ib"Senv(env, varif env is None= os.environ`rval =1P.get(F1if  Freturn []'+.split(':') image_suffix="x1env'DYLD_IMAGE_SUFFIXw) y ARvIPATHTl`R Pfallback_',f$}__search(Pator,Z"""For a potential  1Madd  semantics"""zS! =:_)$3if 'w/u_inject=",K=RP3fornv"!if!.endswith('@'F(Qyield/f[:-len,3] +4 + B87elsRA 6  overrideMnameB# If Lset and this0ib_Da}%#  B, us5first filat exists inS6FTpf any. Ptherehnone go on to CDYLD_LIBRARY_PATH # if any. framework = _info(name)&&if is not None:DWfor path in dyld_MV(env).2yield os. `.join( ,j ['#']# If DYLD_LIBRARY_set then use first filat exists#1the . TEnone;original |.3 library_ @base[_b) def2executableYq_search(+, =~Qwe haven't dBany Aing and found a 1the#0ib_ starts with "@y /"an construcyDZF:"ifGSR-('R!') ig_ 8,rO[lenk:Ns{defaultk(nv_s 2-{allback* =?d_fopD1u,V +e$  7P=x DEFAULT_FRAMEWORK_FALLBACK0ve 5ot 5OfindZ:, e1"""u)FiD&or0 usk semantics='_image_suffixachain(mm0override,/),1  8 pD$ 0):%%if is!areturn:tryrAif _shared_cache_contains\ return pSath  except NotImplementedError:$+Qpass raise Value(L("dylib %s could not be found" % (name,)) def framework_find(fn, executable_path=None, env )1"""fFind aG using dyld semantics in a very loose manner.Will take input such ashaPythono./Versions/Current*eVq = None6trytareturne*,%Aenv)PV as ec~fmwk_index = fn.r''V8if +F= -1Sr len(fn68hfn += Rfn = os.@.joi5,@base1V(fn[:_"])X4N5WinallPtest_env = {}Fgassert'libSystem.I') == '/usr/lib F$/N/Library/Fs(' if __!____main__'$  pGeneric0ib |ipulation$ import re __all`1 [' _info'] DYLIB_RE = re.compile(r"""(?x) (?P^.*)(?:^|/>)'QshortB\w+?HP(?:\.v>[^._]+))?7 :_ksuffix\0$ )A(filAB canone of th2@llowfour formL/Name.Somen!_Sn/( KIs1 if or a mappequivalent to<Udict($=')',!;/=' 27 '='O #"='e)Note that DR and 2p are op!al0may 9present.4 isOTib = f.matche0D/e None return is_dylib.groupdict() def test_info(): d(location=None, name WshortFvers)asuffix+PTqreturn eg ,g  ! o) qassert 3 'completely/invalid') is 4e_debug;aP/Foo.') == d('P', ' 'CpI O", #='_/.A[W/'ARX^ ".A, ^X%, ` if __ __'__main__'5 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) (?P<>^.*)(?:^|/h>'e>\w+).v/"":V s/.>[^/]+)/)?&%P=H9@(?:_1>[^_]+))? )$)$mP(fileEAC can take one of the following four forms=CLpW/NameCSome $!_SjA":f, Rp if notnd, or a mappequivalent to#'$'r ='8 DI T'=' #F"=')Note that DR and 2p are ops!alfmay begLqpresentl5is_ = STRICT_FR$AMEWORK_RE.match(filename) if not is_framework:return None-.groupdict() def testMr_info()Td(location=X ,  WshortFvers)asuffix+Pg ,g  ! ojuassert g 'completely/invalid') isu8/_debug?EP/F.3 m'/F') == d('P', '!/F'1 %/FS!j2', #='+b iVs,!<//A>+; dFO, 'AKB5,a 'A_` if __g __'__main__'- """Core XML suppo8or Python. This package contains four sub-s: dom -- The W3C Document Object Model. Qks DOM Level 1 +# Namespaces. parsers[` wrapp1for#(currently onlys Expat). saxI SiS API H0, dpoped byZr-Dev, lTDavidMegginson and 7Sed to8?Lars Marius GarshoDthe SAX 2. etree0EleGTtlibraryJ@is apset of KDfulld >release.  __all1 ["dom", "N 0saxB"] #!isgqmappingE interface NodeFilter from #P2-Traal-Range. ItUconstant@clasK1"""IHDOM2tb OFILTER_ACCEPT = 1ePREJEC2SKIP = 3 SHOW_ALL S= 0xF -pELEMENT-01-ATTRIBUTE+' -2-=TEXW -4-CDATA_SECTION^Z8-ENTITY_REFERENC-,10-S -2-PROCESSING_INSTRU-4-?COM; 8-ODOCU.Z/10-D_TYP;2-FFRAGcZ4-JNOTAc-A800 < def acceptNode(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 contains[p 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 PDA"""C0givY@Typewstants."""g__slots__ = ()#Ltis may use this as a E their ownY# `s. Ify don't,  defined her# should still bedcanonical9ithey match.values givenRrecommend. Client code casafely r0 to3se Uin all tests.4Typ+.e$G_NOD &"= I1= 3  -"= 2 '1= 5H$A = 6$N1= 7$"= %1= 9H$ )#= %)2= 1j  = 12 #ExceptionCode INDEX_SIZE_ERR = 1 DOMSTRING'= 2 HIERARCHY_REQUESTM= 3 WRONG_DOCUMEN = 4 INVALID_CHARACTERF5 NO_DATA_ALLOWED!F6#MODIFICATION+= 7 NOT_FOUN@1= 8#~SUPPORTgi9 INUSE_ATTRIBUT@E= 10>STA"G11 SYNTAX%12H = 13 NAMESPACK6= 1cmACCESStQ= 15 <bD= 16 class DOMP( 0): *"""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 ( 4ERRQNamespac  <oAccess INVALID_ACCESS_ERR class ValidationErr(DOMExcep ): code = VALIDATION>UserDataHandler2A"""C\giving the operf constants for A!.hIq().""" # Based on DOM Level 3 (WD 9 April 2002).NODE_CLONED = 1DIMPORTED = 2@DELEF = 3PRENAMC= 4 XML_SPACE = "http://www.w3.org/XML/1998/namespace"7/NS9 2000/xmlns/" XHTk1999/xhtml" EMPTYcCNonePREFIX =  from .domreg import getDOMImplement, registerQ """Rfacilitie'DOM. This module should not be used directly. Instead,!@funcvs_ 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, factory4"""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;=$3=()U?"""5[7` = ()) F.G suitableq&3 is5mf*Oof aL, or None. If Nit is not None, imports the corresponding module and returns DOMImplementation object if EQ succeeds. 6tIf name|given, consider~available`As toDfind one with3required feature set. loEA canEbe found, rais! IError. TheN s list must be a sequenceICof (w, version) pairs which are passed to hasFB.""",oZcreator =emod = well_known_i{`s.get(Y)/ if: ?_6ort__(mod, {}]['get"']L@Ti +(*2eliy9registered[]1 ot sys.flags.ignore_environ\y"PYTHON_DOM" in os.# l' =7[R"])# User didspecify a[, tryNsarbitraryo# order,,A@thatif isinstanceWvs, str)os = _parse_u_string9Dfor T6in .values([Tdom =.if _good_enough(dom, @,2domW 9key6try[ 3except Eion: # typically, or AttributeErcontinu)ur("no suit;DOMk") defs ![] pa= s.splitQi = 0 length = len(-A0whi <6gthd1 = /"[ii0[0]""0123456789"B+VqF("ba,v: %r" %d)>Qi + 1;WvOif v): = vs.append(<EFtupl ) """FacilityM1useNPExpatto load a mini3Re from a strXing or file. This avoids all the overhead of SAX and pulldom to gain performance. """ # Warning! # # Ymodule is tightly boundFiimplementation detailswthe # miniu1DOM can't be used with other ! M@s. #~Pdue, @art,~`a lackjappropriate methods*V(` # no way?0cre0aEntity#Nonodes viaKCpLevel 2nterface),59forIe latterPcause some fairly # cryptic code. qPq hacks:! - .character_data_handler() has an extra casewhich continuing # <qappende=0istWPText 0; tX0cana@speedup since pyexpat &reak up  mnto multiplPcallb even though we setvbuffer_tattribute o+Ecparser& also gives usDadvantage that^ do~Vneed @epar normalizBpassPDeter"ngNa&p existsR0donEban ideZcomparisonCN. raPn a truth test|`searchXm4andIE5any"object if itb. (A xGTnice KPchiev/as well!) from xml.`importbuilder,o, Node.EMPTY_NAMESPACE, PREFIX, XMLNSC#s uey@dom.__child, _set_K_ ?1Fil TEXT_NODE =. CDATA_SECTION$ DOCUMENL  FILTER_ACCEPT =aR.DOMBl.,:_REJEC:,:OSKIPr*6INTERRU/ theDOMIF=GM.getp() # E typename -> TypeInfo _info_map = { t" ": *.3(@, "c2"),1BENUM0 1aenumer27ATITY9h 2_IES":intities"), "ID": minidom.TypeInfo(None, "id"), $b"IDREF1.:ref1S21 s2pNMTOKEN32|nmtoken3g3 g} class Elementobject):__slots__ = '_attr_info', '_model tagName' 3def __init__(self, !!, 3=R`P$.#$ =-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_ANY7;eMIXED)FVFalseVisEmptyIJ_EMPTY !Id,';Q< 7%Idpeuri, e1, a  # sure this is meaningfullZhisId((N1) intern(builder, sh"._(_setdefault(s-Fparse_ns_MPassert ' 'parts = .split(' 'zs? = Dqif len(K)s3T@b, prefix = .?t(prefix, prefSix) qname = "%s:%s" % (prefix, local.qintern(=!, %83 = ) Velif len(parts) == 2:7uri21 = & = EMPTY_PREFIX& =&se*raise ValueError("Unsupported syntax: spaces in URIs not %@: %rVHdreturnGuri)", Z class ExpatBuilder"""Document b that use02 to a ParsedXML.DOM d:1instance.""" def __init__(self, options=None)G$if@ is  7c = xml".OL(8d&._- G9if #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!, Zone if neededRelf._  ^ __setdefault =c.!.!qE+buffer_texFOTrue,ordered_attributes = 3 specifi5!ll/3D  Free all data structuresPd dur2con9ionT. = theDOMImpa.!(C2NAMESPACE,f`curNod$uNeT_info(. 3cv= False5p, ?I ll callbacks"Dinto the parser.""3" # This creates circular references!,parser.StartDoctypeDeclHandler = self.s"_d r_decl_h"I{ElementErfirst_e@?End>?end< ProcessingInstruction-piz"if0_op1s.entities:Y*Ey$6y @Notac>n@ 0combC 3cdata_se?b/C(S' l0 I x TdMKCharacterDatac__\OelseZT;rxternalC;Refe _K4ref K?XmlE?xml@|: Attlist>a |Adef }PFile(Lv, file)c@"""Pp a docuq from a* object, returning the+fKvnode.""w1getf5r()3AbuffETrue6try`zwhile 1@.read(16*1024j(rif not 3K#Ubreak.(?, Falsee 2and_. j._setup_subsetyr o= @"", mIqexcept ]Escap%ssQ4doc re^_f = NonVO EcStrings ,  .Parse(string, wTrue)  self._setup_subset(string'except ParseEscape:CEpassadoc = Vdocument red^ _p]r = None1return doc Kdef elf, buffer)"""Load the internal 0 ifre might be one."""c*ifl.doctyextractoIdSBE(X2.Sh(~*&= 32get^ U@k.3Gcstart__decl_handler(R,u Name, systemId, publicId,Dhas_^}Pimple9ation.createDMYType(|G)d.ownerP ~[_append_child]\4 <$ =FV[_filter andl0.acmSNode() == FILTER_REJECTt{ J)2delljlUs[-1]- q.EntityDeclH?21Not4?if ; $if]q is not; $F .e0iesZq = [+n, 0ComProcessingInstruc=BEndD = " op2s.cs^v 9[b; ,-piD!if._elem_info orRN_finish_9ent = id+p`, target, dataSLnodeC(Hm0cur , ciA: == FILTER_REwJECT: self.curNode.removeChild(node) , def character_data_handler_c(E , )^cGW@s = "g_"if#QE(( _continue?'Fand `P[-1]. Type == CDATA_SECTION_NODEB @appendData( vireturntdocument.createSectionQ*W = Tr0eli2ild` ATEXT X . value = *.! + %!= 1  Oelseminidom.Text()CacownerDg w/__,4.K2  ,? = %>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( 1 ? 5D"if1 is;Non # internaly<p# *should* be readonly, but we'll cheat9p n(w=""s.>(*udoctypeT._seq:9pfilter M_p.accept|FILTER_RE2del .entities._seq[-1] def notation_decl_handler(self,Name, base, systemId, publicId):MQpnode = >.document._create_j( WG[)P Idoctype.@s._seq.append(|:"if_filter and.acceptNode: == FILTER_ACCEPT2del@ ]0com WOdata5 4C@(2_a_child@.cur/de3[REJECl.removeC}Upstart_cA_sec`[S+q = TrueFt_continu^VFalse2end?jFgkxternal_entity_ref?ext-return 1first_ele5nattributesC qis None2notWZ_infopfinish_LZ = idgetParser().SEH5G  J#(1-, 7[u1[|w0 = jO6if for i in range(0, len(.G), 23a = minidom.Attr2[i], EMPTY_NAMESPACE,p=#8fPREFIX11vals][i+1]]$a.* cownerD  0U_set_u_]I, a)f0 is  _ \gd%@lY N# To be general, we'd have to call isSame(), but this#sufficient M oi!de/elf.document.documentEle;: ireturnfilt = self._ er.startContainer(node)50if + == FILTER_REJECTr# ignore this J & all descendents[Rejecter( z.el|OSKIPz, but make it's children become#"of the parent ._Skipp.se.curNode =g.s rJ.removeC.unlink() I0# Iis ever changes, Namespaces.end_eK_handler() needs toF#be<d to match.Odef Hv, name) H3 = . *_finish_(4&i,`Einfo,_D.getY@.tagB0if %T_white_text_sL,9 J R$if2 isd. "ifE`accept)t ./e,-21if D._options.m5_inucontent@aor not3.is<Went()-A# We have '4AtypeM0rma and should *6abl&# 0; i.ify for 0s$0ch ain onlyAeL = []%O 1 inS.sL9fc.T== TEXT_NODE4?.data.strip(.KL.append(-1# RtQ fromFtree L }rZS_decl{w, modelZ;Non.G[;C] = kPInfo(V(elP assert info._model is None i != ( !6def attlist_decl_handler(self, elem, name, type, default, required): if0 = ; ._;_P.get()r-0if Bnfo = ElementInfo>% d[`1] =WgBattruappend( I[, 0&])<?xml8version, encoding, standalone)@docu.63 =  (U% =`*`# ThisZ#still a little ugly, thanks to the pyexpat API. ;-'ifV >= 06  j = TruOelseB False # Don't include FILTER_INTERRUPT, since"t's checked separately # where allowed. _ALLOWED_LRETURNS = (@ACCE[tREJECT,|SKIP) class FilterVisibilityControl]cobjectP"""Wrr around a DOMBuilderF which impss`to make whatToShow fribute work."""__slots__ = ',"',__init__ !# =l>Pstart5ainQ8nodEmask2e_[.QType]tzBelf.w. & 8 K4val_1 aa6=Q [,raise ParseEscap0if J no \UValueErrors") returned illegalue: " + repr(val)3)b%acceptNode(T_Np =6JQ# movep child arent, and re*t%Kp-! =C.parentNode  for child in node.Nodes[:]: /parent.appendC>(6).#T is handled by the caller0return FILTER_REJECT%if val not_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"._!A2 = ! .SElementH56end3?End1T1 = N"_ep_ q@ a>=end< Re8er(Z/()L.cb@name("ProcessingInstruction"G"Com'haracterDataT   "StartCdataSectionHandler", " O"End/xternalEntityRef` )):x setattr(parser, name, None) )Pdef s_element_h(self, *argsU._level = 6+ 1S?endQ)ifFJ== 0# restore the old s`builder._ +"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 constructss given XML sourcAtexta>.9The|bexpectprovide informa0 ab"th`namespace declarations which are in scope at the start of fragment.A""" def __init__(self, context, opfq=None):/J$if# .nodeType == DOCUMENT_NODE.2X.originalDocu$ =GZ,#Oelse]d.ownerukExpatBuilder.$)EQresetB+ C"0 = kTparseFileXX, fil@"""P"D a dULafrom a3 object, returningr3.0 pString(w.read()"31, s/5s._source =|irqelf.get:5r()"Adoct . 0ident = ""fF @ubse,D.internalS"ort_getDeclari_.publicIdh%('PUBLIC "%s"'( 4% (Z,.systemId),='el$r'SYSTEM- %^& ktnsattrs:!NS() # get ns decls 's ancestorsp;q= _FRAGBUILDER_TEMPLATE % (1, s#, :tryt.j`f, True6jexcept9/)tUraise=?! H ##B_u# $/c F Re-create` 2:.fThis is only needed if we don't alxQy havfnSCas a]Ar . pPfor iPrangeB.notw.length=#% =!s.item(i)  hif s:  s = s + "\n "#"%s' \e$ psystemIdOelse dSYSTEM lYfor i in range(doctype.entities.length)x"My = 3nitem(i/gENTITY $kD m#, }zLelif& 'f<  OfirstChild.datazhcO"%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 #@realqRback,Q intoAfrag2to  originalD2V)= B!.c9F}(3 tR l:try6(._source, TruflF  r,0 = --j = Non2 -1: else:  "return ExpatBuilder.external_entity_ref_handler( 9-self, context, base, systemId, publicId) class Namespaces:M"""Mix-in Rfor bs; adds support n?Q.""" Cdef _init\()b# list of (prefix, uri) ns declarations. attrs areeF constructed from this anded to the element'sE.B._ns_ordered_ves = []createParserA"""Cu a new -Qing p9"@ = 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 = _8lMelseU = EMPTY_NAMESPACE w_U f = Non6[ePREFIX?node = minidom.E (ku", A>.ownerDocuD" =di_a_child.curNode, GU! =~  P0uriZ  :h=a4Attr(_in, 'xmlns:' +>%), ?VXMLNS}"RCI D,, f?IwP.valuU=uriZa/ _set_attribute_node(g, a) del self._ns_ordered_prefixes[:] .5if Q%s:LZ._ensure_%(kBs = /(sG!*NS#)NS%for i in range(0, len(Mjs), 2)waname =9[i]Y&Lvalu&.+1(`if ' 'XoMuri, local|", V0, q = _parsex(!, P 8La = minidom.Attr(I/, hDc[:] j&JNS[(\)3Oelse , EMPTY_NAMESPACE,  =oPREFIX 0X ;a.ownerDocument =@d $a.V P3EleOwif __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=_;m O), \9", stack messed up! ())"? Ia - badHJ 4 s8amek  Y r% =`parent 9._finish_- ) class ExpatBuilderNS("s,Builder): : """Document builder that supports namespaces.""" def reset(self): bExpatBH."6!self._initNX() class FragC6NS(',)x4"""71L_getNSattrs""""Return string ofc 3ibutes from this eleE andHancestorxp# 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 = []Twhile`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=.parentNodr]ParseEscape(Excepp5"""p raisedOshort-circuit pars in InternalSubsetExtractork+Dpass,(uXML processor which can rip out3i~$ datype s8v = None2getgeGCas aTcl_+k2QeFilekc, file;:trys=, file) except ParseEscape: Qpass Pdef p'String(self, s )56try FExpatBuilder.Ac/sinstall^r .StartDoctypeDeclHandler = .s"_d r_decl_h"IElementEe@A:d name, publicId, systemId,Chas_internal_subset?if ! 1get9r()/`Y = []C}.Defaul5.append7?End?end ;elsXraise&()P:s = ''.join.\.replace('\r\n', '\n') ;s 6 U", 1WattrsO R(file<spaces=True@1"""p a docu, returning the resultD"b node.['^' may be either a  or an openqobject. 1"""!if,sbB8 = Q#NS -Qif is:3nce(st8Awith'rb') as fpr3 = rrFile(fp< 1 2ile3rtm& {us from a Ri M )@Fragcontextf99 ofQgivenL8which it was originally extracted. 5`should3`parentk1theC2B(s) XRare ivOH builder = FragmentBuilderNS(context) else: b%75, if isinstance(file, str)Jwith open'rb') as fp%sresult = |.parseFile(fp1 2ile3rreturn ,r def YString(s#, , namespaces=True@"""PC a fA of a docu^p from aing, given theZ7%which it was originally extracted. 5 should beKC`parent}]node(s) TRare iv.51"""'ifz-.e ~)Cmake(optionsCreate a' based on an O. object.H.$GExpa2G 1 #-ython version compatibility support for minidom. This modul*ains internal imple_a details and 0not im\ed; use xml._g @ead.H # uHHonlyI using "Ya *". #:e followU vdefined:% NodeList -- lightest possible# AUEmptyFA that is guaranteed to #| remain e^ (immutab3" aTypes Ptuplel t#defproperty5Afuncui$njGetattrMagic;these togetherAneed .om workFas efficiently~in both PO2.2+D@nd o:s. For exa jclass MyC(/):o9 p_get_my,_(self4 <something (2, "q/", M"q value")t6p newer, t@willstruct am j, which avoids? # !needing to override __getattr__(). It will onlyFwork for read-( @ibutes. #6For older versions of Python, inheritOfromCGRMagicuse the traditional; hackerybachievFsame effect,Gbut less&iciently defproperty() should be used@Deach? ofsrelevant $_() func. __all__ = ["NodeList", "EmptyStringTypes "] import xml.dom . = (str,) class W(list): uq__slots1() def item(self3dex/3if 0 <= index < len*#'preturn D[+]^llength;7U5Gset_5w, valuewTraise .NoModificatAllowedErr("attempt`m0y+" 'y#'"$4 = (6, _,osdoc="The numberanodes in'.s # backward compatibilityd_zqstate__[!, &"if i"ne  A= []TB:] =P T(tuplVU__addWotherFNL =)NL.extend(2,'NL%/_rcM7oneg00-9  (k, name, doc:cget = %!("1" +0)?R8setKP=UP;HQrepr(sassert not hasattr(klass, "_set_" + name), \ "expected not to find 3/pprop = erty(get, sdoc=doc)'8set|r,5) """Simple *mentation 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 only@ 8/Ribute`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"Bcine='\n'0if . =9de.m # Can passmVto document, to put it into XML header self.writexml( r, "", indent, newl, encoding, standalone)JUelse:_XB%ifc{ is NonQrreturn .getvalue(B 3detach()<def hasChildNodes()HAbool%.c+%) CV_get_*E[@ ?Qfirst ?;if ;p $;[0]b/laa;'-1binsertBefore>Q, ref  if^.nodeType ==DOCUMENT_FRAG JNODEfor c in tuple(newMn'$ c'### The DOM does not clearly specify what to his caseM i"in V_"j_typesraise xml.dom.HierarchyRequestErr(k "%ne1be . of %s" % (reprL)!pr&))o`parent<V.-q.removep%if4WSoappendD:try?#x y!s.(4except V^ErrorW NotFoundHKL1in  bs_with>renj__id_cach} d- ( 4nextSibling = %.previous0G 0!ifbx[o20.r4*od<B  n!e'  , 5;ode9lf.DOCUMENT_FRAGMENT_NODE: for c in tuple(node.childNodes)-8self.appendC(9(c)Q$### The DOM does not clearly specify what to returnhis caseM 0if .ATypea1in __j_typesraise xml.dom.HierarchyRequestErr(g "%n1be _ of %s" % (repr51), &))-el1in bs_with:ren_7_id_cache(\X`parent" inJNoneJ.)r.remove_r,o"0.nextSibling = q0def3lacrQ, newB, olKn "==ADOCU1ref^% =_  '.insertBefore(v.Mk\U U#4k?# ?6-  L:tryCcindex !s.(Aexcept ValueErrorO NotFoundCk[k5] =# #+#5if ` C:'or0odesn?  4previousE8 <!Y }$ E (  Ma]". z g(self, oldChsild): 6try  self.childNodes.remove(oldC):except ValueErrorH raise xml.dom.NotFoundErr(C4if X .nextSibling is not NoneU..previous>=U y $} 2 }y 4 [! =?nodeType in _ qs_with_:ren>_clear_id_cache(%) ]`parent ereturn`<def normalizUxeL = []dAfor k5"if). = de.TEXT_NODE159b^.data#'# empty text `; discard'Oif LI"[L[-1]2h T$ E*gunlink elS and n+==# collapsef" =f!! = +7 m9?ksL.append(BQ /el62 6.ELEMENr<. 0[:]7Pclonefg, deepo_'(!, ^ownerDocument orisSupported=feature, versionqY`.implecation.hasFG(O_get_localNam# OverriddenEauAttr where @p can beU-NullS'/| # T interfaces from Level &3 (WD 9 April 2002) def isSameNode(self, other):!%preturn 2 is?getInterfacAwfeatureC!if?.isSupported(&X, Non, sFelse&@# The "user data" functions use a diary thatnly presentm # 0ome4I has beet, so be careful not to assume iErexists.igetUserDataj7key%?tryy .__[key][0] except (AttributeError, Key c/6s,Ey, handlQold = " - ?%{}2 NE = d if key in dHd6!if  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*" =ownerDocumentFelf.child6se6'a*.) <0deLy)%previousSibling*%neM$Knext !@# A  its own context manager,bensure_4an   occurs.Q@ThisOpsimilar>how a file object work20__eo,__c__exit-, et, ev, tbp defprL0ty(, "firstC", doc="F s node, ?.")B&laABOLastAocalName", A pspace-l name of tUnode.") def P_append_child(self, node): # fast path with less checks; usable by DOM builders if careful D[Nodes = b.e6if x8lz=A[-1]1.previousSibling = 5$ V.next 7 r.() p.parent def _in_document3# return True iffG is part of a 8Q treejUwhile*not NoneRiG.Type == .DOCUMENT_NODE04d@! =i/SFalsewrite_data( 0r,  "Wschars to (!."S!if>! =.replace("&", "&")< lt! \OB!\"-1quo/>gA()pget_eles_by_tagName_helper(, name, rc1forN0 in7ent5ELEK and(oC"*" k..rc_ 1/rc$ -ns'sURI, localG3DbUif ((s 7  )vB (n BnspaceURI%)CE Csclass D@Frag(M3 2EFRAG|X+T = "##-fU$`Value nattributO3,c_HA_typ3. ,B0 QB.TEX) CDATA_SECTION&2 ENTITY_REFERENCE5PROCESSING_INSTRUp5COM ENOTA!) %q_init__9 gdeList() class Attr(Node): __slots__=('_name', '_valu spaceURI',26'_prefix4PchildYss_localNPownerDocument1Ele)WnodeType = F.ATTRIBUTE_NODE#attributes%!nespecified = FalsV_is_i*__jA_typG Q.TEXTh,}ENTITY_REFERENC!) Fdef __init__(self, q(, -=EMPTY_NAMESPACE, ]=NoneL" Lgb.0!" =) = )# = <}sdeList(m# Add the single 2 n that represents&d1 of p.append(Text()r]VR and Rare set elsewhere6getj2tryqreturn 7except A_ErrorB(.split(":", 1)[-1] % =8 )41set4,CU" ="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"Eb/is=0new+J 3"%s:%s" % (prefix, self.localName) "ifownerElement:%_clear_id_cache(J/Mname = newj Lprefix = property(_get_E, _s )1def unlinkp)# This imp ation does not call the base&# since most of that iAneeded, andHrexpense'eCbmethodq< warranted. We duplicateIremoval ofEchildren, but0's 2we Q fromAeclass.Bnelem =!1if $FNoneL 1del"._attrs[0ode]H+1NS[.spaceURI,j Coj_is_idc~v = Falss p._magicnodes -= 1*N@Docu8Zcount8Afor 2 inNb .Mu 86[:]AisId9 return Tru 9doc% "!0if E0is 1 or BPnfo =F.s`_info( 0if [YX.P!NSR ;elsPNschemaTypSR_no_typehA8^YgetAttribute29 \ 5defr0, ". ",  ="Y i0is an ID.") HMPdoc="1- 7XOS"",Se  tG!  ydm Map(object): """The at@tribute list is a transient interface to the underlying dictionaries. Mutas here will change= element'sG1y. Orderingimposed artificially and does not reflectdo:1 ofG#at s as found in an input docu..2"""~__slots__ = ('_FCs', !NS cownerE)9def __init__(self, =HNS, 7!):xI-.j" =5$NS+NS Y) =hget_lengthreturn lenAitemw, index<6tryM[X8S.keys())[F%]]except I]_ErrorTFNones^VL = [Xfor nodewvalues(9L.append((4.QName,C.4%))L/NSDamespaceURIPlocal)__contains7keyif isinstance(key, str!0;key`$Oelse4&NSI'qm'9#NSr3 N;'s(v1get1, n-K= 82R__C_cmpnHothe7if ?0get(*2, "e;", 01(idb) > id]V)) - <5_eqo!!X == 0C/geC>Ce >l<l<0get0attO_or_tuple]e(attname_or_tuple, G): return self._attrsNS[attname_or;]3OelseA ?@# same as setdef __setitem__(#, ~w, valueif isinstance(W, str#:tryhnode =(except KeyErrorISAttr()>n.ownerDocument|0Ele # F.setNamedItem(X n. " =1Goif notE Fraise Type "("imust be a}ping or B object" ^g. ,  [3 >_None #NSUspaceURI, localONS[(I)`remove6;n f01 is5 _clear_id_cache(._J9del n.(&.q&n.s =`if hasX(n, ''hn0 = nW'xml.dom.NotFoundErr()G J/NS;J Q+od ], z 1HierarchyRequest9p"%s canbbe child of %s" % (repr!, self)))  old = self._attrs.get(node.name)  if,:old.unlink()L[H@] = ?&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 ofds in the @.") AttributeLis^! class TypeInfo(object__slots__ = '"', 'Cinits%, + N"O1ameV#fCreprfUi!lfLt"<%s %r (from %r)>" % 1.__P__.__#__  |ROelse 1getA38 % _no_type =&`None, )B(?1=('T@DocuB`parent.0tag  }prefix'0URI5_cPchild[s /NSQextSibling*previous*0 = ^.ELEMENT_NODE!@Valu-cschema8N`_magic:Ss = 0_}[ t PROCESSING_INSTRUCTION; 5COM, 2TEX) CDATA_SEENTITY_REFERENCE) def __in2it__(self, tagName, namespaceURI=EMPTY_NAMESPACE, prefix=None, PlocalG!4): d.parentNode = B 1 = .@nodeK$ = /# = ) = )PchildsdeList()%nextSiblingprevious8# Attribute dictionaries are lazily created4a4(double-indexedN#W/&->kKu URI, (in the future: considery generaZ5of objects this is too tricky2for now because of headaches with,%s._u/ne!NS1ne def _ensure;s"ifn#kj !{}_'{}Eget_ {:tryhcreturn7nfexcept_ErrorB .split(":", 1)[-1]( #9lunlink3L1not P in loD.values()g4.{ WON)5get,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"""[#NS]Ys%, m NS$turn self._attrsNS[(namespaceURI, localName)].value except KeyError: return ""  def setAttribute(self, attn!, Z)Cpattr = &'.g8SNode(6)Zm ifJr is NoneGK{:!" =p # alsoys nodeV5ownerDocument 4rCelif!!= iZ.isId9_clear_id_cach)#NSqualifiedcprefix;: = _nssplit(<# /NSY@ , F", a:w 5s$#9,"0D43 !=>|#'& S%w_9 =  '>Ni}@lf._s$@<Frb9`/NS)!NS/vVr4.1Elenot in (,,2raise xml.dom.InusePErr("T^ already f&d"t._ensure4&s("Dold1e"s`.,01if 3it sVremov7HJold2x{{V2ZV@ and~2A_set;_V() if old1 is not attr: # It might have already been part of th@de, in which caseJit doesn't represent a change, and shouldbe returned.I if25!2 6setAttributeNodeNS = +def remove2(self, name)10if  ._H0sNSFNone"Z raise xml.dom.NotFoundErr()$:try5R#lf_[}]2except KeyErros ({) 'NS spaceURI, localNh@NS[("6p4ode8+odDOnode;8[[.8_clear_id_cachrgunlink# Restore<@sinc e /still usefulwotherwiU"# W%ed>.ownerDocum`*lf071?has """Checks whe the eleahas an}Q with"specifiedj.s Rs True iO!JO\,svs Falsex5"""5 F9n0ame( L[?- &NSBgetE`sByTag 4"""all descendantsgiven tag<1lis{N(direct childrenonly) with t he specified tag name. 5""" return _get_elements_by_tagName_helper(self,G, NodeList()) Hdef getE?2ByT='NS8spaceURI, local]!):? $ns37___repr__c"" % 4.A, idwritexml!, r, indent="", addwnewl=""@"""WE an XML  to a file-like object 48the10 that must providePa method (e.g.r or StringIOI)O# = currentUationl#( =" ddhigher levels:20 = Qine s .(hp+"<" + ,8rattrs =wibutes((`for a_I@ in $ws.keys(Pzrp" %s=\";<),_-a_data( "r,Z[.z].value5)a6\"""ifPchildsbp ;>:qif (len.C) == 1 and2S*[0].nodeType%(15.TEXT_NODE.CDATA_SECTION)\;tt Tr, ''<Jelse6QW 5# P1-R ,z @ % !"%sq;  I/F#%(6 ! ._ensure_$H2Map/"s, "NSshasAttrWo~> x6Tru&RFalse[ # L! 3|, based on e22 Oct 2002 drafUsetIdJ!5get0*(v.VNode(idAttr) * def setIdAttributeNS(self, namespaceURI, localName): i60 = 1F.getE odICB9 Bode(Z!) )$<#, *f is None or notpisSameN@:.ownerElement raise xml.dom.NotFoundErr()$ if _get_containing_entrefF)}9 ]ModificationAllowejJj_is_idS u = Truet3._magic_id_nodes += 1&@Docu4^count4`_clearURcache defproperty(dD, "al9s",zPdoc="edvMap of . on the e?.")a`-'hHthis[e _set_3(,4 $) ._ensurePsJ!j s[.=1] =e& %ENS[((H)AB0# Tcreates a circular reference, but s.unlink# breakscycle sinceAAs toR{0dic0ari{re tossed.- $ = class Childlessp"""Mixiat makes c#-ness easy2imp2 and avoidsvM coBxity e |p methodat deal withb2ren1"""H__slots__ = (1s =*aPEmpty CListeQfirst7+laM}5y"breturn 4S3aappend0 , =i ,HierarchyRequest4+CA + "PPs canEhavel"R1has6sVFalse;insertBeforQ, newF, F3!dovaremove}B, olaNn") def normalize(self): # For childless nodes,0@) hathing to do.>Qpass def replaceCMhQ, newQ, old |raise xml.dom.HierarchyRequestErr([ .Name + " do not haveren") class ProcessingInstruction(c, Node^aType = .PROCESSING_INSTRUCTION_NODE__slots__ = ('target', 'data')__init__) , 'z2 = g1! =8]#Value is an alias for&;P_get_,zbreturnbdv7s70, vo>7" =?m = property(9, _`2 - 8w88 7writexml!, r, indent="", addwnewl=""k3.("%s%s" % (=,,&l)CharacterData@=('_ownerDocument','parentIpreviousSiblingDnext  e" =j!nel4 {67U = ''O.salengthK1len.3)VQ__len+? T.8RN3P2 41' =9 ! Crepr'l 0if f) > 10z2dot = "..."9Oelse,)pp''SqE___.__name__;[0:10], 7dotsubstring+G, offset, count#if; < IndexSize"O@ canbe negative"@[!>=Zd .raise xml.dom.&IndexSizeErr("offset cannot be beyond end of data") if count < 0:raise xml.dom.d3cnegativeYreturn self.t[:+B!] rdef appendData(3f, arg)G& =S +&DginsertDl L2if 4 [a>= len] i 6arg*^.0"%sQ" % (n!)[]-,d&])hodeleteh^ _[jY736 &- +T:UoreplacBt3 ) defproperty(Character, "length", doc="Lthe string.") class TextH__slots__ = ( nodeType = Node.TEXT_NODEN0Namq"#text"attributes7&ne>Qsplit,c< 0 or"/ >R&tillegalIHvalu0new[!__&6__('#(]*ownerDocument3 3x"nextSibling "if`parent and self in self.parentNode.child Gs: if next is None(sIpappendCO(newText)R?elsGinsertBeforeH,N{udata = [:offset]usreturn  def writexml(<,r, indent="", addnewl="")_C_( `r, "%sR" % (=,Bwl))# DOM Level 3 (WD 9 April 2002%_get_wholeOPL = [.npreviousSiblingpwhile n?not.nodeType in (".TEXT_NODE, CDATA_SECTIONi"L.Q(0, n /n."=UbreakFl( ''.join(L6replaceW8, content # XXX This needs to be ser6 ly changed if minidom everr # supports EntityReference >%s.*r!Z? =  s.remove5ext;.$ot]OcX n"(FK/if*$ =! \i'&+isWhitespaceInElementC &if3w.strip(hWFalseQem = .aining_el(self) if elem is None: return Falseinfo = self.ownerDocument._get_N_$( )7 f i?elsH`.isElewContent() defproperty(Text, "isWhitespaceIn3%",doc="True iff this text node contains only wT"CGP" and!in[1ent>"/")Pwhole"heof all logically-adjac^Qs.")  1ing&)@c = .parentNodpwhile c;notPif c.6Type == 7.ELEMENT_NODE] Cc'vcs&`ntref(y@NTITY_REFERENCE3 class Com(CharacterDataHG5COMG1!Name = "#cJ!" def __init__(6, dZ{ r.,: ._:! =A^writexml^r, indent="", addsnewl=""if "--" in/g aise ValueError("'--'{pallowed@#a ".("%s%s" % (, , ))DATASection7__slots__ = ^ <_SECTION8'"-sa`-a.find("]]>") >= 0iP]]>'  gC h1)h*sfor n i 2\$C = N%(n, n.publicId systemIdhHRs.append(:n._call_user_data_hV(z_, n, Fe U#Py = E7y(ee$e., Hg|.actualEncoding = eq=e7 1 qversiong /f*iey?e, D(!, ;elsN'*writexmlr, indent="", addwnewl=""3.(""%s PUBLIC '%s'" @ % (,wd', )$el aSYSTEM"uC`^ F?not  ' [_ c Y.er.write("]"3) qwriter.(">"+newl) class Entity(Identified, Node):@attributes = NonenodeTypede.ENTITY_NODE BValu!1ne actualEncoding<Petversion'Bdef __init__(self, name, publicId, system notation 3.0Nam=Y5!D %Pchild%vdeList(qg%_iRa_mixin()Jget_'qreturn c * GTA $ ;{: #9pappendC8Q, newaise xml.dom.HierarchyRequestErr(i"cannot \ 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()`# icreateDocu~spaceURI, qualj, doctyp$ifD and p.parent is not None:  raise xml.dom.WrongDocumentErr( + "doctype object owned by another DOM tree")<doc = self._create_dd5() 'add_root_ele = not (namespaceURI is None5and qualifiedName:n!if [m :# The specunclear what to here; SyntaxErr@would be the kobvious candidate. Since XercesWsHInvalidCharacterErr, s;klistedEBfor -0, tPseemsbetter choice.FXXX: need1`check Yillegal c s +inDE2.M#Level III u s this up when talking about\return valugB# of=function. If 1, qmQ@DocT*,arHANulllmxped with%a  Oqw if,rA are 6n we go back]above problems-J#("1 no"@* prefix, local[ = _nssplit(wa2if ; == "xml" \! BSN!= "http://www.w3.org/XML/1998/,"p V5"0use4S'xml'F2pt?URIv _ #cmsq =X.e)NS,g Kdoc.appendChild() A % Q: c.parentNode%.r;t>3^2impqa"9T;def-( =, publicId, systemId)I..SId = publicI3d doctype.systemId = $sreturn + # DOM Level 3 (WD 9 April 2002)%def getInterface(self, feature):J0if R.hasF(%X, Non+/3CFelseQ&@0# i1nal6_create_documentjD) class Ele0Info(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__ = 'tagName',uq_init__mX, nam.6! =;getAttributeTypRaD@_no_@'NSspaceURI, localOT#is CR9VFalse|isEmpty-A"""Ros true iffs is declar@have<QEMPTYk k. !Id,, Ke4d aa DTD-style IDwidentifie-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|L.COMNATYPEEN =I .-NT_NODE nodeName = "#document" @ValuANoneattributes = parentNod,previousSibling = next? W3# D| bfrom Level 3 (WD 9 April 2002):actualEncoddVestandalonxversionstrictErrorCheck\BFalsexHandler8C4URI_magic_id_count = 0def __init__(self):1y.doctypPchildwdeList()A`# mappof (namespaceURI, local) -> EleGInfo>i and tag-,_elem_info = {}I0achsearch_stack;"6get^( , n7ent1$if.R_key =(S.OelseH  0rreturn .get(key L *D",@ #9?URI= ' Am> $ ;K? ( CA & ? H / QQE #9pappendC8,!if.TTnot ic __/sraise xml.dom.HiermpyReques(#p"%s cane1be _ of %s" % (repr(n1), &)){0is N @# Theeds to be dbefore the: test sinc)isay *be*0,*which case it shouldEend up re-orderedIend.,.r.removeK =<de.ELEMENT_NODE \_sS#._x(` "two document eles disallowed") return Node.appendChild(self, node) -def remove!"ol0!):%U6try K .cVf"s.F(;:except ValueErrorH raise xml.dom.NotFoundErr(U.nextSibling = previousENone(Parent9 = #1if 1doc`E_5 isf .Uys[_get_lr1for2 inm !if(.`Type =de.ELEMENT_NODE36lunlinktaais notB X&.Lv" 6(Pclone g, deep,t  L" =U2impation.createD(8,Eb.encod'`standaw +tversion(%*{A = _ _"(n:!, vassert <d.owner b.isSam>w(O n(ifj ODOCUS.H4/elqOTYPE2 vnr1doc&=  (.p?*] _call_user_data_handler(<UserDataH._CLONED,Jg CH5 )@FragDd = A$ dcdzdvm, tagNamevDe = $Uetet1Tex9ur@isin0ce(!W, str&  (" contents must be a;3ing t = TextC() t.data = ownerDocument = selfreturn t def createCDATASection(2,W!):(rif not isinstance(xW, str&*raise TypeError("node contents must be a;Fing"Ic = /c.c om!n"ProcessingInstruemtargetmOp = 7 1ppAttribute WqName^$(oao a.value = ""4za0Ele#NSnamespaceURI, qualifiedprefix, local = _nssplit(5n #*, u]e e:^P1 .,, /# A couple of impaS-specific helpers toz Qtypes#g supported by the W3C DOM I&s:k_w_entityD, publicId, system 1not3B < Sn = N(nnL3get CById'idif id inU._id_cache&F#E[id]4Lb._elem_info orYQmagic_Gount`3NonsSstackvqsearch_y@ is @ # we neve>`efore, has been cleared`[dY+=elfUelif not staWck: *# Previous search was completed and cache is still valid;Fno matching node. return None result =while staV" =e.pop()J<# add child elements to0 for continued9ingBt.extend([J8T"inYNodes="if.Type in _ qs_with_JLren]check thiss h@infoelf._get__(_ K0if  # We have"process all ID attributes before>in orderI1getE8theFoset toFbe IDs usIEt.setIdA:*()JU. .values():!if.namespaceURI*.?.isIdNS(f :,MlocalNameuKs1id_P[O>] =22o == id9rc' &elif not._magic_idsi_breakaYGE-)'%!# O_is_ ,de)1. ^NI/l3if t" K9fdef getElementsByTagName(self, name):  return _get_elements_by_ta5w_helper<, NodeList()) Hdef getE?2ByT='NS8spaceURI, local$nsr _isSupportedfeature, versionhB.impation.hasF9(A imk3mnode, deepg0if .qType ==g.DOCUMENT_NODEraise xml.dom.NotErr("cannot P docug5s")F/el|OTYPE6t`clone_((,lwritexmlRr, indent="", addAnewlencoding=None,N`standa"adeclarbs = []64if X 4.append(f',4="{ 6}"'6if @ is ]:="{"yes" Pelse "no"tC.(f'{`#}'1fori1 in`.childsv , ca# DOM Level 3 (WD 9 April 2002% rev)n+  t.ownerD/ ~TWrong5Zs from other^s;\n">expected %s,\nfoun D" % )QnYN@in (E.ELE]..ATTRIBUT sk() only applies to n and attribute4ame != EMPTY_NAMESPAC`if ':'y gprefix! =.split(':', 1=3bif ( =n"xmlns, VXMLNS b@+ j[4 "illegal use of 'xmlns' prefix") Yelse:if ( name == "xmlns"&*Q and*spaceURI != xml.dom.XMLNS_NAMESPACEB .nodeTyprNode.ATTRIBUTE_NODE)UraisepANameOErr(n "illegal use of the '' attribute(l prA} = None^Plocal! =!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 shoulda# calluser data handlers for0_REM@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-level4is =A.") b _clone_(, deep, newOze"""C6" ag!itZXpCalled by .z )ip.import5r|Y-PsSame-(Ffation UserDataHN.EaCLONEDx BcIMPORTDY 3 |.'!NS node.nodeName)# for attr in node. ibutes.values():.5clone.setAttr*0NS(6.namespaceURI,V.SCNameR)OBa = SgS?odeWPlocalX L.specified = vzif deepUchild ZNodes*A = __(,,W, newOwnerDocument?CpappendCu2(c)BelifXType == .DOCUMENT_FRAG FNODE- =t.create@Frag(_TEXT_@TextL(]R.datavCDATA_SECTIONn;SectionrPROCESSING_INSTRU{ ProcessingInstruutarget,@/OM1ComgATTRIBUTEm $!F2ame^^ ETruea ! prefix dictStcurrentXk<[-1Eending_e!] 1popXPresulw \>del "bPs4setuL#, -"LQtartP1sMappingLE,TPEshasattr+'_xmlns_'s'. ! a@"((@ or 2ns'Z%;self._current_context.copy()) self._current_c&[uri] = prefix or None 5def endPMapping(F,/!):(` ]2 = $nspvs.pop()astartElementNS_name, tagName , attrsn# Retrieve xml /space declaration5uibutes.xmlns_uri = 'http://www.w3.org/2000/$+/'4` = get !'_._1s',=r if"nsq is not$9=Pfor a, value in9 -1o.W"[(Buri,F)I5-AU = []#@Plocal! =Vjif uri# When using.s, the reader mayU5notO# provide us with8rorigina@. If4, create@0*a*1%id+AfromG z%if1/is$P7 4#if (n+ ":" + v ROelseM >"if|@docu\FDnode&.hUcbuildD(JFVD1tag9ed, it just appears as:#R1(o+g,Y w.items(.aE, a_" = 1if *3 ==[ N'J1= '1'?/q=~ v$>cO:' +I AAttr1NS(!, ] tF.set20ode6:ttr.!el ' TZx \  qname = a_local attr = self.document.createAttributeNS(a_uri,R)Enode.set2!od6:ttr.]else:@( T(X ,P.valu lastEvent[1] = [(START_ELEMENT, i), None]:OK +Qpush(J~def endEle0NS( , , tagName)7.^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 }ignorableWhitespaceHchar oTextNode(4S IGNORABLE_WHITESPACE, node), None] self.lastEvent = A[1] ,def characters(&,1s):!PDnodeC document.createTextNode(E%s)3I[1] = [(CHARACTERS, U))cstartD"ifFactory is)import xml.dom.minidom# M=3.`.imple(VationlTbuild&, uri, tagname# Can't do that in , since we need theF# XXX: obtain xEType# .7( !! =d>START_DOCUMENT'fPpush(# Put everything2have seen so far inth$e Qfor e~Tpending_eXsHf 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$LVpop()qQclearwk" ): Explicitly release par^ ]Uures" q class rHandlerkqwarningp, excepfprint(m;es998Qfatalv =1DOM@fStream__init__Rs,,er, bufsiz.'0dhCer =E Q$ =[ if not hasattr(self.parser, 'feed'): "getEvent = e_slurp(reset() Bdef S.pulldom = PullDOM()6w# This contqhandler relies on namespace support;\.setFeature(xml.sax.K".f_IFs, 1 FCH1__getitem__#W, pos im warnings. ( A"DOMuStream's e method ignores 'pos' parameter. "LUse iterator protocol instead.",.DeprecationW stacklevel=29A$rc'7Zif rcbreturn rcLraise IndexErrorTc__nexte`t5QStopI(8ionw=w3-expandNode GnodeeJ#parents = [:]awhile ? Btoken, cur_2" =%9O&if 0is ( E% 8_ != END_ELEMENT<[-1].appendChild(!j2if W== STARTYUP(elR 0del*d ]%1# ucrementalP interface, so we get the desiredY # f effecbif notu dom.firs:[1]^3.la'A~[k4bufXsQ.read.bufsize`:buf2g.close2 U None<F(bufzV[1][0_I eC1C&rc+/""" Fallback replac8@ for#() using0 tandard SAX2cwhich meansl> SAX events into memory (no performance gain, but we are compatible to all SAX parsers).35""" Rself.#(zstream)'@getE1 = %F_emigreturn1() @Adef +[!):""" Fallback replacement for m() that ls;?Pthe es" _slurp() read previously$rcpulldom.firse[1][0]m&C 1C&rc_clear): Explicitly releaseing objectsD2del"z = None` classV2DOM(PullDOM):qstartEl!NS, name, tagName , attrsH.=<tcurNodeezwStack[-oparent+2+.appendChild(j 1rprocessingInstructiontarget, data;n$la}?0][+ fignorableWhitespace?cha2 koacters )c default_bufsiz(2 ** 14) - 20 ""e(_or_string, r=C4if Y!isw+=  if isinstpz3strd = open.B'rb'FFelse8stream_or_string if not parser: = xml.sax.make_!()'return DOMEventStream(s,Q, bufsize) def`String*4ing*b=None)from io import 01IO wQc = lenEUbuf =. =4buf """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 instance92is @to psettings to \YExpatN.Vb# 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 sF*, 1 + =/d return self.errorHandler def _set_x(self, !):/3 I) =+ *Yget_filterSEqreturn L"66", >7# =wsetFeature@name, stateE"ifsupports4.';" =C and 1 or 0!6try%settings=@elf.l0[(_ip_xform( )]Wexcept KeyEcraise xml.dom.NotSiedErr(L3"unBed f,: %r" % ,)) from NoneCNelse@for , value i-bsetatt._options,D)ws AFoun"unknown" + repr'))''U?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_entitie0 [[ +parameter2- 2 _e_if_schema ) Mbcreatey_ref_nod. W ("create_e ntity_ref_nodes", 1): [ ("create_e.%],-!(""iH0H&0)G{ Ke)1)9whitespace_in_element_content", 4cc cdata_section% % E omB9x9 harset_overrides_xml_encodingc5 0 5 eeinfosevj3namvdeclara DPvalidif_schema# ' I #"type_normalizx + 2c9 supported_mediaas_onlyD%0 ; !=! ^A!} def getFeature(self, o!): }x@ = _p_xform( )"6try/3`returnZAattrWA._op!, Q>except AttributeErrorP!ifT == "+ "va0 = q$(0. 7;Rand o. B- C Enot declarations   or options.validate_if_schema = ' ?0cre=entity_ref_nodesD=i5cdata_sec)))r0raise xml.dom.NotFoundErr("feature %s not known" % repr(name)) L def parseURI(self, uri):#0if .yResolver $onput =)".r2E;R(NonebaOelseO2DOM7v/()Obreturn (i 0 = copy.*#._t.filter%errorHandl+1Qfp = .byteStreamif fp is HE andsystemIdmport urllib.requestN"p .urlopen9.Zc_d_sD(fp, uWithContextV,0, cO1, a }ir_legal_s`ValueEt ("!a 3a"CNotImplementeAor("Haven't written this yet..."/",  ixexpatbuilder% ='b.makeB3"(oC.RFile(@) _b_xforma.loweruplace('-', '_'Cnclass cobject__slots__ = '_UQer', 9publicId, zeassert U$source =IS("".j4 = Eb #%elf._get0().( # determine the encoding ifQtransprovided i5}_guess_media_(-|base URIPewe can@posihNX'tparts =kI ~e, netloc, pathrams, query, frag` # XXX should we check the scheme here as well? if path and not .endswith("/"):,3-p= posix .dirname( {) + "/"1Srts =, netloc,irams, query, fragmentBsource.baseURI = urllib.parse.urlun (parts) =rreturn @def _get_opener(self:tryCCelf.4_except AttributeError?_8GccreateN%()P_p! :]dimportfrequesIY;f.buildjguess_media_encoding-,Oy0nfoyteStream.infoif "Content-Type" in $ 4for param.getplist(u-`ram.st ch,t=1 f.split("=", 1)[1].lower() class DOMInputSs(object__slots__ = ('b@', 'RacterstringData',m'j+publicId bsystem 'q_init__U!.u = Nonex $ &>Fset_>&, ? ' N FVJ + H+, Y , =1 `O& >g, dataD%! =! 3C=$ :$, D% =# I?$ :$, D% =# I?$ :, systemId):# self.systemId =  "def _get_baseURI(/!):Apreturn .#8s8W, uri=6 = class DOMBuilderFilterr"""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&Q/T &?`acceptb:2, eZFzContainerJ!7del0ocu%LSPMixincreate d#`s thatO@form!%load/save spec.async_ = False 00g, flag6!ifraise 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)[.toxml()%OMMODE_SYNCHRONOUSA2mode, schemaTyp.7 elO*yeS0if == self.MODE_SYNCHRONOUS: return DOMBuilder() if mode == self.MODE_AKaise xml.dom.NotSupportedErr(V}"asynchronous b~s are not s="rbValueError("unknown vA for1") odef 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<f: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 RESULTFROM LOSS OF USE, DATA=pPROFITSpWHETHERAN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS3, ARISING OUT OF OR IN2 CONNECTION WITH THE USE OR PERFORMANCE # OF THIS SOFTWARE. # ---." # Licensed to PSF under a Contributor AgreementySee http://www.python.org/psf/lOR for ing details. ##tmited XInclude support6athe EloTree 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 ^wd. 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|?Gbase_url b URL oPorigiU,$lv@rela9F ePfBmax_maximum number of recursive inclusions. #  Limited to reduce the risk:malicious content exploBAPass a negatcPvalueObdisablPlfPation7@throws |RIdeError If{@link max_depth} was exceededN_FatalC@func{` failsde a given resource, or iAtreeains malformed Xi elementP)IODload} wqreturnsAnodets replack!it&an.R def0de( , ler=None, base_url b=DEFAULT_MAX_INCLUSION_DEPTH):4&if@ is ]NJQ = -11)el36< 0/praise V77p("expecEnon-Yne 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 Pdirec%O)jw (""y%if c0 = urljoin( ,  HVparsej~", "xmlrxUrm * +("@f %sJ H(==Iqa (8"maximumz reached whenePing fC _.add(# =$!,  1if . |uacannotc %r asR pp= copy.() # FIXME: thiVkes little sense with=des+Y, href, max_ depth - 1, _parent_hrefs)  .remove(,+if e.tail:FU2nodF = ( or "") +< ;elem[i] = 4 elif parse == "text"| = loader,5, e.get("encoding")A~is None_ raise FatalIncludeError()q"cannot %r as %r" % ?| /+=dOif it2 = ?-1]%~ 9?elsNm.4O ) O3delcontinue5"unknownO type in xi:i tag (%r) "gXINCLUDE_FALLBACK"xi:fallbackmust be child of _B(e, j, base_url, max_soi += 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)0ingwpperiods10namr7-09-10<new selection engin2200'2'cL0"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_ O1999By obtaining, usand/or copyBthis soft its # associP docuMation, you agree< that you have read, understood, # and will comply with the following terms)!conditions: # # Permission to use, copy, modify,5 distribute this software # its associated documentag for any purpos3out fee is # hereby granted, providedQaboveright notice appears in Bpies;!bo/at=naEis p* #Z in supportinge name of # Secret Labs AB or`author_0 bejd]advertis^or publicity #@tain5to !ofSQspecific, writte0priY.SECRET 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 _. # -0 # LicensRo PSFb a Con$or AgreeySee http://www.python.org/psf/lO' details. #AImplPSPmodultr XPath@. TJ's usually no3 so Pto immFdirectly;RBEkTree does2Pfor #, if needed. X re xpath_tokenizer_re = re.ile( r"(" '[^']*'|\"[^\"]*\"|%:: 5//? F\.\. 5(\) [/.*:\[\]\(\)@=]((?:\{[^}]+\})?[^/'F\s]+*2\s+{) def (pattern, spaces=None):default_' =*.get('')@2ame@` else EC0par2_atQAQFalseP^> _re.findalluttype, tag = CQ!ifJtag[0] != "{""`if ":"x:tagprefix, uriaag.split(":", 1)m,>tryE if not namespaces: raise KeyError'yield ttype, "{%s}%s" % (names`[prefix], uri)FeexceptfaSyntax"("V %r not found in 0map) from Noneelif default_A andTparsing_attribute VZ, tag?elsSIoken v = FalsPL == '@' def get_parent_map(context)3 = .6if 1 is?s6( =1A= {}H-Pfor p6root.iter(&*e*pk0[e]n`greturn{_is_wildcard_tag(U3qtag[:3]8p{*}' orB[-2:$}*N@_pre I_isinstance, _str = "stz ifYi"*'# Same as '*', but no comments`proces lructions.CIt can be a surpr@thatU includes thosedPthere'noHjustificab '{*}*' doing the same{idselectat, resuliL@elem! 7if P(/B.tagY '0%+2tagj}i1Any!is'Uin a >D el70 =  1C[0] != '{AC xQ# ThePny (o)suffix =/[P # '}9'no_ns = slice(-len(7!),<AK53:]@M:1t %l !R]:$# !inh]given ns = tag[c:-1] ns_only = slice(None, len(ns))' def select(context, result):%Sfor elem in! $el_tag =)I.tagB"if _isinstance(1, _str) and [~] == nsjL@yiel1!emgFelse)raise RuntimeError(f"internal parser e, got {tag}"creturn0 $prepare_child(n(Stoken'[_wildcardC(tag1yD = _c1tag('+ )S(dAfrom ' \ if tag[:2F'{}'cVag[2:] # '{}tag'' $ @if e?tag%)Be 2 XOstarW  ?elf%k~ descendants6tryY\0 = |(Mxcept StopIteration1h![0i6"*"'d1"*"*elif not o<[0]) tbSyntaxs"invalid 1") iy(g.iter(31 is^Y2J8rJ +Ielem:  yield e  return select def prepare_nt(next, token):4%1Q(cont cresult!Y## FIXME: raise error if .. is applied at toplevel?\;y_map = getq)-yU = {}for elem in $a%ifp #'2 = h[W]i&#if$F notv2W1 []r] = Non")| redicateeplace with realser!!! refs$# http://effbot.org/zone/simple-iterator-parser.htm8javascript.crockford.com/tdop4l5signature = [bprwhile 1#6try 0 = (+except StopI:ion9TH"if[0] == "]"/]break.+w('', ''P# ignore whitespacN6inu5and@[:1]cK"'\"c = "'"[0][1:-1Qh.append(5for "-"3 *"1]#Iqu".join(#e# use  to determinekB typ'if-u'@-# [@attribute]@0key6[; $?.get(key) %.<o}%/='='value'+ K1== 90-" tre.match(r"\-?\d+$",7[0]f# [tag29tag0B fio/ag1F.='" or (signatur*e == "-='" and not re.match(r"\-?\d+$", predicate[0])): # [.='value'] or [tag'Ytag =E< 5-1]fif tagpw def select(context, result)for elem in% M$(%-.findall(tagT0if "".join(e.iter0())Tk;Qyield Ubreak"JelseWB?lemcreturnif signatur"A /()&-"# [indexhlast() -v^zM!Q3Fy = int(J - 1*"f -:< 0ZH"raise SyntaxError("XPath position >= 1 expected")\)ifVP != "swunsupported func}o6,(()|$>try  6=2])6.except VQU expressionciO> -2_offset from g() must be negativerF = -8parent_map = get_2m ]w[#c# FIXME: what #heor is "*" ?7Us = list(v. 7!ifFs!is1 (IQ, Key  Epassvinvalid`") op{J0"":r_child,*Cstar.4elfLnt, "//": prepare_descendant, "[": preppredicate} _cache = {} class _SelectorContext:H@nt_map = None def __init__(self, root)4.! =_ # -0 ## # Generate all matching objects. iterfind(elem, path, namespaces=# compile s/Atern ifh[-1:] == "/"X! =! + "*" # implicit(FIXME: keep this?) W_key = (G!,)'ifi/+= tuple(sorted(.items())c6tryA"= [S]yexcept KeyError:rif len(6v) > 100r.clear(:.:19 raise Syntaxt("cannot use absolute]0on Fent"apnext =  (xD_tokenizerSKP)).__1!__ !?0 = (`StopIt{:ionCretu0Hm[^ whe1: *@.append(ops[P[0]](!, ) 8&xqinvalidlv") from430"if/[0$GUbreak% =%`# exec_lPresul\[vc- =.e3fori3 in MYw(U", ENFind first\D(97!),)sJ1all r Olist ~ c  ) qdefault  ( =.a or ""r 9 """Lightwe XML support for Python. XHML is an inherently hierarchical data format, and the most natural way to represent itUwith a tree. This module has two classes_ t purpose: 1. ElementTree `swhole XML docu&3 aspD2D@a single node in~ Interactions wpl(readingkP writ to/from files) are usually done okelevel. ve  pits sub-sja ]$ ra flexible container object designed to store  structures;memory. It can beEbcribedcross between a listQa digaAU Each$`a numbf properties associated#it1'tag' - a /'s name."'attributes<gPython D8JBtextD0str1*~5ent>1ail>@n op}/alext aftere#agNHAnd ?cchild .s ed#a qsequencTo create5 instance, use}bor, o4Sub factory fun1You0LalsoQHwrapku\aconveru!toXXML. """ #-1 # LicensPSF under a ConCqor Agre. # See http://www.pZ.org/psf/lO 4details. # ## # Copyright (c) 1999-2008 by Fredrik Lundh. All +s reservedRf)@ware.com #@4*ThQtoolk--PBy ob0ingand/or copyKT@softXits #Datp, you aQ that0hav2ad,`stood,Fnll complyjafollow0ermad& did!s:Permissi,,&2ifyn diK0 #  XCany Vout fee is #F hereby granted, provided that the above copyright notice appears in # all copies, an=BbothG=n$is permissioF Z in supporting documentatione name of # Secret Labs AB orPuthor be used]advertis^or publicity #@tainto distribuz1 ofSsoftware without specific, writte0priY0. #ECRET LABSBAND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD # TO THIS SOFTWARE, INCLUDING9xIMPLIEDAOF MERCHANT- # ABILITY FITNESS. IN NO EVENT SHS'OR0 # BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGESUANY #WHATSOEVER RESULTING FROM LOSS OF USE, DATA=PROFITS, # WHETHERAN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS3`, ARISv0OUT@OSQCONNE!!USIPERFORMANCE #2 _. # -0 __all__ = [ # symbols@"Com&"",Ddump 2Ele# " DTree@fromfng", "Dlist$`indent 6iseNiterparsL 0 "PTErrorC PI?`ProceszpInstruc[#EQNamK3Sub&to eBuildeutVERSIONB0XMLWXMLIDrDPullKregister_nEspaccanonicalize?`C14NWrTTarge?3] = "1.3.0" imD sys $re 0war$ioQcolle6F.abc*ntextlib 3 . sXPath class q(Syntax "):`""An e` when $ean XML!. /pIn addi to its excepvalue, ar@ convtwo extra at~"es`'code' " -c#'A'pos'1Pline dcolumn1"""?_pass 6U def ?(GbReturn True if *!*p to3an .r:0has2Z, 'tag')Element: "'""An XML element. This class is the reference imp,ation of E interfaceJ$An['s lengthSits numberA3sub s.}at means if youwant to checkaZQtruly empty,4s should/ABOTHFx@AND text attribut4TheV tag,! names, andvalues can be eitherqbytes or stringsQ*tag*iZB. *Pan ophaal dic ry containinge=s. *extra* are addi;ldugiven asKkeyword argu0Exaa form:*(CH...tailS2""" 3a= NoneG7"""m!'s`.. 1D #'sE C|Tbefore first .#is# a.MNote thate0no ~0, tS{ute may*\p, depending onmcparserK+lRafter,2endCbut n@siblt/Pstart5i ! . OOwas #iG"def __init__(self,b={}, *8)if not isinstance(,)raise TypeError(",@ musb3,Pq%s" % (:11.__P__.__U__,))-.I"ta@AS = {*J}A_ren = []#Crepr#return "<%s %r at %#x>z B!ids&))iCmake_ y"""Create a newAwithsame typ c65zq4~Iionat >op|!DoBcalltmethod, us$Te Sub2factory fun h3eadOXq(b`AcopyY L"Return copy of current element. This creates a shallow copy. Sub2s will be"red with theIoriginal treea5"""$warnings. ("i.w() is deprecated. Use)) instead.",GD7BionWm )return self.__YB__()Edef "%):8~" =8@make@ent('R.tag,fattribo'T.text< UU.tail9ail3[:]ZQlen__,1len._childrenNbool<The behaviorhtNPmetho"ll change in future versions. specific 'p)' or ' not None' testFl, stacklevel=2?t! != 0 # emulate oldur, for nowsgetitemJ~, index2[&]HsH,QPif isQance(Iw, slice% el7F assert_is_z6elt/Jelse;7r;)$ =?delI 2delnFaappend5, s"""Add *@* toE end4new!p ar@docul order afterVlast existing (or directly82 , 1t'sJXfirst but before*1tag.qk6exts`s fromhequenc[*D*3a s#@zero<m*.$GYv ini=A"""I, at position *@*.""" se lf._assert_is_element(sub 3)  se,children.in5(index, 12Odef Yelf, e):%Z# Need to refer the actual Python impation, not theEshadowing C..&!if9isinstance(e, _EZ7_Pyraise TypeError('expected an 6 %s' % type(e).__name__) z premove(C ,A"""R%` matchT.J`Unlike find methods, this compares s based onHidentity, NOT ON tag value or contents. TEs byJother meane easiest way isuse a listrehension toGselect whatto keep, and n Kslice assigncFpdatCnMDVfd if a|9a could6be foundH5"""#Pert i(DBlO1/`path, Sspaces=NonA@"""F ^first!by@N**Pa strw0hav!ei$anG or XPL*]K@n oppal mappOFfromp prefixAfull`Return ,%no?was rY.j&ItextqdefaultAO for Q%~t!ifw Qm,O ex#}? of)%ifAnone`. Not1 at-i, 0no I[te empty#2is Je&i`C> v9all2lx  alw Ename or path.3 *path* is a string haveither an element tag ofXPath,EnamespacesKn optional mappOUfrom ( prefix to full.Returns list containE alQ0tch s in docuWorderJ5"""rV" E.findall(self, ,)def iter-*u=None):k"""Find 5sub!byOTzable yield (cqQclear TReset]This func removes!, Wattributes, and setsthe textVtail /~v...o%()W_children = []t!= (w = k1get, key, defaultG'qEquivalo".get, but some impVaUs may handle toa bit more efficiently. *key<Cwhatd0uteAlook for|H*53to 0if ZFwas not foundhl B`value,|5 ifm:Q(s S [key] = O s65andJ*~Y Wit toKD  Akeys  4a'ofqskNC are] edpan arbitrary t, just like"ordinaryPython dict. Sr./melement attributes as a sequence. The attribu're returned in arbitrary order. Equivalent toGC.items()`RM a list of (name, value) tuples05"""Uj self.adef iter(", tag=None):B"""Create tree-GatorpD loops over the elemand all subs@docu n#,@1ing52with a match7tag!Ifs structure is modified dur7ion, new or removedr ma  not be included. To gettable set, useK() function onH , 65`result=P*tag*@what@s tosk for (default"#toE B)Vn containykh ifv == "*"=i`tag = V.!is.*=I BQyieldB._children8`from eXSr(tagAtext5ext N0innB7extvq,5tag0if isinstancea, str)i7!is$ 0-L3t =a5ext 7" +)]0 = e.tailx-| BSubEqq(parent,={}, **extraE"""S factory which cEs anUappends i!to+1xis0B@ute sQEPs cansaeither bycor Unicode4ing*v$%, A2, *#?nPan opral dire'8", aR* areE3ddiD'` givenSkeyword arg 4S = {*}`"= S.makeCf$('- def Comment(text=None): """Comment elefactory. !This function creates a special6which the standard serializerJs as an XML c}m*1* iatring contain ]0! s71"""b2= E().e0 = dreturn def ProcessingInstru(target,< G1 2V VjX p& i', ,x >&ents, if anSDC!if q+ " " +2> OPI = class QNameo """Qualified name wrapper>6can be used to(" aL attribute value in order)1getaproperespace handon outputt_or_uri r`eitheryfAformu{uri}local, ortag argu/is given,URI part of"ag@n opN&alF?$ifLwill makeVBfirsw)Yinterpreted` URI, and t9"agSbi 5e__init__(selfX, tag"ag)u4 = "{%s}%s" % N4n@3str7>0?rep1'<%s %r>'>!__P__.__A__, Ohash:7#le50, oPif isQance(,5%2 <=Mn' "lqj(&g. return self.text >= other# return sel'"def __gt__(",B!):Bif isinstance(`w, QName%)hL &p/eq@='_ # -0 class ElementTree\"""An XML e hierarchy. RThis >$also provides support for serialization to and fromC@dardhV*o* is an op:ual rootQnode,C]*file- handle or pname ofUQwhoseHcontents will be usedAinite the tree with1"""@-a=None, v# asser0is .#is@()h !._=# first *!ifx;?`parse()0getVkB"""Rr@of t.akb'_sc,K lZplace mPk@discKcurrent >"rec%it+TgivenR. Usf care!{N{, source, r5"""Load external=P docuT into-*Y. "object, *y(2v that defaults4@XMLP`r}PError0rai`iCeQ fail@iIs"e @cclose_,S= Fal/if not hasattr(&, "read",w = open+&b"( q2Tru:try$if 40# I(was specified, create a+rEs6r =#(%%if0A, '_ v_whole' 0 # The default XMLParser, when it comes from an accelerator, P# canP0ine1internal _pY _whole API for efficiency.N!ItQbe used to HR the Lsource without feedingO!it) chunksuself._root =n(r.(r)cvreturn D &while True:Hrdata = ].read(65536hpif not 1GK]breaka9 r.!(< Yjclose((zfinally1if F_ .%1() def iter(, tag=None)>"""Creatd#d Atree8`&element.`xd,loops over all .s in this Z,@docuIg orderO*tag* is a stringhtag namerek(jo)j5""":# assertp1(!O.G(tagrCfindrQpath,ospacesFind first match80 by@@ or NS `as get1().z&)x0ichE.*) k1hav0ithn or XP*Kpn optio@mappO(p prefixAfullR,  was foundM!!ifh[:1] == "/".76 = "." +* warnings. ( "TBsear@brokn 1.3 and earli8 will be E`"fixedJa future version. If you rely oze currentJ beour, changQ%r" %FsW, stacklevel=2>R% ItextOL8 ]=), which is Element.findtext() *path* is a string haveither an ele@a tag ofXPath,EnamespacesKn optional mappOUfrom ( prefix to full.Return the first matchG,None if nowas foundM5"""# assert self._root@not N(0if [:1] == "/":: = "." +* warnings. (="This search~ broken in 1.3 and earlier, will be E`"fixed9a future version. If you rely oLcurrentJ beour, change itQ%r" %{FsW, stacklevel=2)rV, default,V@def @all(@,)=)"""Find alD3subGAs byS;Same as get+!())b), whiE$ )Fdlist contai *'qin docuWorder`V@iterZWe X.! X0an able yield s]A[:1] == "/":' path = "." + warnings. (D"This search is broken in 1.3 and earlier, will be "IPfixed9a future version. If you rely on the currentJbehaviour, change it to %r" %,FsW, stacklevel=2,) return self._root.iterfind(I, namespaces) 6def write(5, file_or_- encoding=Nonexml_declaration$default_]&bmethod, *h short_empty_elements=True): 0""W !P treeva as XML.1AArguJD0 *B* --AC or Pobject opened forW6ingb4 *?G7toutput # ( : US-ASCII; *cHbool indicating if an  should be#S Padded*.ZP 2is S&ifIS NOT either ofu , UTF-8,{yUnicodeb@`#Asets (z"xmlns"pD'"), "html, "text"i"c14n"Vrcontrolaformat$ofsa ` that Maain no 1entOey are emitted0a single`-closedMPag, o@wise\OpairN ofrt/end tagsi&""rif not  _d6xml2Celif0;in _serializeB raValueError("unknown@i T}2== C !;Vutf-8+ls5vs-ascii8enc_lower =.(with _get_.,r(,<H)-' xml" and (xml_declaration or :(xm(is None and1 enc_lower not in ("utf-8", "us-ascii nicode"))):Jed_encoding =Y - ifuS== "u[X# Retrieve the defaultC_A forBxml " wLimport locale"B /.getpreferred-()Fwrite("\n" % (B *,)kif method C^text"@_serialize_"(, self._rootTNelseEqnames, paces = _(O, bG []"., ,Atshort_empty_elements=!) FAdef 3Q_c14ng, file# lxml.etree compatibility. use outputfinsteabreturnk(`,/ ="y") # -04 # O%@ sup` @con#Clib. manager Q_get_r@_or_,"# s RB release all resourTafter using}6try{! =}|.0except AttributeErrorB#<Q is aE(]\ = open6"w"W=T=kes="xmlcharrefreplaceAwithQyieldJ 9 -like object@# determines if itsor binary #\abur as is$# wrap a 3TextIOWrappeH+6ExitStack()s m6sOance9 io.BufferedIOBase):  pfile = @_or_Yname % elif isinstance()1, io.RawIOBase):AQ5 =*BufferedWriterN)?# Keep the original open when \? isMdestroyed stack.callback~.detachOelse!# This is to handle passed objects that aren't i"# [ hierarchy, but just have a wNo methoU(.U!ab&lambda: Tru" 1T9'?try/D# TextIOWrapper use%#isKdetermin`Gif BOM (for UTF-16, etc) should be addC.S.seekBOtellc.:except AttributeError1P Hk N,.encoding= ;s="xmlcharrefreplace"Dnewline="\n" /# Qyield4e def _Ospaces(elem, defaultD=Non3# identify 9dJAree # maps q*b*ed* prefix:localJ2+0= {t : }MAuri:cBe>bQ = {}L.if2[b] = ""w$Aadd_(># calculate serialized representation ^"if1[:1] == "{"2uri, tag =-1:].rsplit("}", 1#" =a.get(uri-#ifxT O_mapX5\ prefix = "ns%d" % len(namespaces) Bif p9!= "xml":(;Ls[uri] =; 1ULqI[F`"%s:%s(^, tagOelseRtag # default elementL$if5_9r# FIXME: can this be handled in XML 1.0?uEraise ValueError(&* "cannot use non-qualified  with "? option3wssexcept Typ /__serializa|!_eG!) I# populate 3 anqs table*1fordv.iter()v=#A.tag4I if isinstance(tag, QName:'tag.text x"insa'Aadd_N2;/elp?strni d!isBANone80Com *PI }`key, v(ms 6q+key = keyF if6key"Axe4l2x&exm ' k1ext/zTretur,2e def xe_xml(write,,4,z= short_empty_pents, **kwargsrt  ifC is ("DPfis ProcessingInstrucTIM?%s?F@O=U[tag]T[:ext_escape_cdata(#Ce:F  short_empty_elements=$) 4Uelse:write("<" + tag+items = list(c.+()'!f  or namespaceshOf #for v, k in sorted(R~,7key=lambda x: x[1]): #Z on prefixNNif kl`k = ":<kFb xmlns%s=\"%s\"" % (4dk _escape_attrib(vA k@k, vkif isinstance(k, QName)-Xok.text PvPQv = q![vW]XE2 [k], vL0if 1len') Onot :s.>"]48`cdata( +eN_serialize_xml(]C, e,}o, None j/  : v@(" R&elJProcessingInstructionXO?%s?U 6tagP{j:ext# mes, None)  belse: write("<" + tag)items = list(elem.+()'!f  or namespaceshn/if #for v, k in sorted(R~,7key=lambda x: x[1]): #Z on prefixNNif kl`k = ":<kFb xmlns%s=\"%s\"" % (4dk _escape_attrib(vA k@k, vkif isinstance(k, QName)-Xok.text PvPQv = q![vW]XE 2__html7 # FIXME: handle boolean mOutes [k], v1*>"`ltag =z.lower(0if _2if ;= "script"^tyle"8&X m\6Zacdata(D EleiE_serializeVC, e,j, NoneS0notYHTML_EMPTY_O@("E>EgEareturnexcept (I, AttributYo 3aG4Pute v 50v/\"!\"9quo# Although sec 2.11 of XML specifc stateSQCR orm# CR LN should be d with just LN, it es only to EOLNs # whic2h take part of organizing file into lines. Within attributes, # we are replac?!these with entity numbers, so they do not count.Lhttp://www.w3.org/TR/REC-xml/#sec-W-ends6The current solution, contained in follow2sixH, waFrdiscuss0issue 17582 and 39011pif "\r"ZUtext:0 = . e(., " ")/HnH"n"H0HtHtH(09Hareturnexcept (TypeError, A)_raise_serializa _e5( ) def _escape_LR_htmlI"# la value2try&f;&&8ampF>F>F,gtE/\"F!\"G9quoIK?# -0tostring(element, encoding=None, method *0 xml_declar&&default_namespace7short_empty_|cs=True"""Generate aresentmCXML =!. `sAll subsincluded. If is "unicode", afF2is 5Otherwise a byte$|*v*[Ban ES instance, *]# op^al output}$ Hto US-ASCII, *D which canN`be one-s"xml" (V@), "" or "c14*%*M@sets 0 (fDsxmlns")Rds an (2ly)#edv!heXCdataE2"""tream = io.SgIO() iC== '`' else,B+FDTree).write(sa    @ i=D method=?,  short_empty_elements=)Jreturn stream.getvalue() class _ListDataS"(io.BufferedIOBase):H"""An auxiliaryQ accumulating into a list reDqnce."""Bdef __init__(self, lst_`.lst = 5writable50FTrue-Oseek-ZW7, bZ.append(b)aOtell1len0) tostring(, encoding=None, *xml_declaration7default_namespace8P=7t![]:*- ="EvDTree#).KE @ DyKBlst Adump7}"""Write  tree or structure to sys.stdout.This func should be used for debuggConly6*m* is either an ,0a se. The exact output`formatL2imp0 de=ent. In tversion, it's 5ten as anMPordin`XML fileE#0Pif no}rinstanc,ho( =Kf="unicode"Yatail =Wproot().NM[-1] != "\n"U e()-pindent(", " ", level=0A"""I*:@docu by inserpnewlinem"d [ZEafte{s}*.%th[7cmodify(() "en* itYQ willbe changed, but ^) text of allAs in its0subJbe adaptedBwhit IeachUR, twofTpractersM^j2j>ialTQ. Setto a higher " value than 0 can be used for indenting subtrees*#t are more deeply nested inside of a document.!1"""if isinstance(VP, Ele)aTree):&S0 = .getroot()if level < 00praise VError(f"InitialSation:@must>= 0, got {S%}"cqnot lenqreturn p# ReducBe memory consumplpby reusCMrstringss = ["\n" +* space]oRdef _0_children(elem,/# Start a newthe first Mz_" =[A + 1 6tryw1=t"s[!R]Gexcept IndexUO" +$Ws.append()V0 f L.text or.'p(b70=D^m~@ in 4 n aeTK,q-i'T.tail=$# =c3@# Dep after L$laK by overwri@previouss  !s[( 2D, 0) # -0` # par0 e(source,der=Non"""Parse XMLQ into2enta*I* is a filename p objectj@tain^VAata,*r?1n o#al~r defaulo"r.R8 an=%b( =*. NJJiter0aeventsN[AIncrCBally igThis class also reports what's go\Qon topuser ba "hen@* ititized with. The sup\2ed /FY1ngsK "sp", "end-ns" and (9"Mato getM de0ed <G information). If *events* is omitted, only "end" # are reported. q*source>a filename or object containing XML data,yKa list ofo#ton back, *parserln optional  instance Returns an iterator provid(, elem) pairs81"""# Use the internal, undocumented _x1arg for now; When:H (!ofvPremovvthis can be killfApull.0r =AQPullP !s=$s,=.)"dep1():V6try while Trueyield from b.read_|(m,b# loadu buffer}$ 2 = FP(16 * 1024Raif not@S]breakePfeed(u ]hroot =_close_and_rJ_$ 0it.F0 = kfinall2if .%"()class Iter  `collec0ds.abc.__next__ =7$).i$; ]KANone05delL,hr = Fals>hasattr("0, "u"w = open'"b"%_*~b it =6XML`:&C__init__(self, s=6, *zT# The +!is.ZA uset and mustbe reliedN# upon in2r code. It will6K!aa futuglease.ESee http://bugs.python.org/issue17741more detail!._queue = eWdeque.1% =0or ptarget=TreeBuilder()# wire upZs*5ingiI0is  C7Qs = (,jR._set+ ~'aB, """Feed end3 to.x_0if C.craise ValueError("|@) ca; after endSastream if datGa: :tryself._parser.feed(data)9 except SyntaxError as excO events_queue.append(exc) W def _close_and_return_root()Va# iter needs this to set its 6 attribute properly :(k# = [~(v = None@jA7"""Finish I@ing L"r.@Unlike XMLP{, does not A thet element. Us2ad_g ()btconsume.as from`2ulld.5""" .&req3 R$!anator over currently available (,w) pairsE;S are dinternal C `@they3retrieve<0terQ$s 'URwhile{s/# =.popleft`%if isinstanceE[7ionP-CraispJelseRyield0 dXML(text, =h1""""P docuci0str~CtantTyfunction can be used}embed "XML Lals" in Pyth.3odeG*v* is a i@taintA32, **n op{#al K, defaultB!to9e@dard|bs an EXH!ifo& =Z(target=TreeBuilder()[-WJ)/ID0A for!$ID^{x(|, dict) tuple,2PwhichQ maps-qent id:Octree =|.y id8!{}w3.(u.(lem.get("id"fHsids[id]4?^, ids #  document from string constant. Alias for XML(). from'=f def list(sequence, parser=None): """P= documentA 74 of@frag!1s. >*$p* is a o/UotherA2, *y&n optionalKipdefaultpto the @dardrReturns an Ele H"2"""_Sf notq <Z(target=TreeBuilder())Dxutext in K`.feed(&4rx.close() # -0 class """Generic estructure b"DThisl@vert start, data, and end methodcalls to a well-formed{sYou can use t"to usa custom {c, or ag!Rsome XML-like3mat*c_factory  ` whicheto create news, as necessaryy0com ygS(Y be.daead of . If *insert_Epfalse (6f!),H&Q will* bel@erteuDtree/pi0pro8ion} ?pis u2I__init__(self,H2, *C<P *3;4  =F,B_pis2 ._q = [] #` colled)) [stack(plast = *1 # / )7roo))FtailRtrue if we're afterend tagd;if K %2= CeJ(  0 $ =6s/6if  5= P"Inion self._pi_factory = # self.insert_pis = %if elementMis None:$P %2= E7&oE=W )def close(/)d""""Flush builder buffers and return toplevel docuA."""_ asA lend ._ ) == 0, "missing end tags8._root is not :X6entBB _f2if -Fdata 9las '+text = "".joiR)'VNtailJ#?}., , "internal error ()D E = ;elsnA?extE;V = [] , a"""Add to current ^.append(LfSstartgtag, attrsmOpen newb 2it.M?P*tag*5the-qname, *Xa dict contain ,gibutes]pr@ # =(\ QD[-1]Bu%elAI ~c_ E = 070,f C5Rh$V.pop(=l ag7\\C "A mismatch (expected %s, got %s)" % (<C .`&(i1i;o0com="""Create a )! uZ*'( @ of 4. phandle_n*le K,&!s,a) def pi (self, target, text=None): """Create a processing instruction uthe pi_factory. B*_P* is % name ofY.C5extAOdata: v, or ''A5"""Mpreturn ._handle_5le($!,3insert_pis9)Kdef VI#, ,;ert, *argsjdelem =((#if9uflush()-plast = \ "if_ S=[-1].append(etail = 1bc0 # also see ElementTree and Builder class XMLParser3"""4 qRure b2@ for0 source based onXqexpat pPPan op#al object which defaults to anDtancystandar , *encodingm1ingJsif given, override52pecified iXML file0 http://www.iana.org/assignxs/character-setss_init__*$, 2try>from xml.~s import n&except ICErro WJ!pyL; asU$Y $Xraise| #"No moduledn; use SimpleXML(6eadrF@.l(gV, "}"3$if0is  tZ=W# underscoredPs areQvidedPcompatibility only# =? ,:_ , _e "2s = {} # memo cache+# main callbacks".DH@rExp4if hasattr(, 'start']Sb*8Z ?endX?EndV?endT v6_nsY parser.StartNamespaceDeclHandler = self._s"S_ns if hasattr(target, 'end_ns'):&-parser.Endb =:`Odata^CharacterData.9Z # miscellaneous callback comment y6|/piUProcessingInstructionc%pi^# Configure pyexpat: buffering, new-style pibute hEing.F8_text = 1ordered_Js&specifi(^doctype = Nonekentity = {}:tryd*version = "EA %d.P" % e.#U_infoNexcept AttrZError`pass # unknown ;def _setevents(", e_queueto_report # Internal API for XMLPullP0c?#TF: a list ofB to b0 du ing (same ar# the **C wS's con&oreactualqY that will be populated!bypunderlyes.append = |.%` _n$in.V,vi[/A== ""*. *.,eeh#g,3_in^=", =,M=(L!((g!, 78(ta=)))kY0Ele; 5.els?endq %3end?end0end?End&b?-ns # TreeBuilder does not impb! .=N_ns({self.target, "start_ns"): def handler(prefix, uri, event=_name, append=,Na"stzt=self._:Z!((u$, 2=)))yOelse;a or '': parser.SNamespaceDeclH$ = Belif == "end-ns"# TreeBuilder does not implement .end_ns(Gi asattr(qtarget,mA<): 01 ONone?End+@'com'Otext  2.(jC?'pi 2pi_o, data p (;pi(ProcessingInstruction  raise ValueError("unknownFb %r" % R!) %_<e60, vGperr = P]!B6err.code =; @posi"clinenoku.offset2G err0fixW, key# expand q# , convert  string to ascii, if possiblev:tryF;=.5es[key]1except Key=5key0+if "}" in 3 tQ"{" +# >' =$ return name def _start_ns(self, prefix, uri):&*preturn #.target.82a or ''8 )d" n=i!\ exhez.strip(!if P @.app> W1n = / #zK > 2w type = self._doctype[1] 0if  == "PUBLIC" and n-4:0?Qname,7, pubid, system = seq>"if5\`T" ='O[1:-(elgSYSTEM3^MNoneOelsenmreturn1if hasattr(.target, "/")O-.+(1)w2yrwarnings. (RT"The ) method of XMLParser is ignored. "J_DefinMn the TreeBuilder 7?.",NRuntimeW-) )R1 = &def feedg, data"""Feed encodedQ to p6."":tryt)(]v, FalsecexceptOerror as vLa_raise##(vQclose Qinish;ing element structureb"", True) # enb9&= ^_handler* |AttributeEd _Fpass0 'Ws(kfinall# get ri circular referenceo2del/, _ **o # -0 # C14N 2.0 canonicalize(xml_=F, *, out from_file**options"""Convert4K5itsm serialised form.If *out*]provided, it must be a s1 or -like object that receivu_hcoutput (text, not bytes) through ``.write()``m a. To `, open0in V mode withV"utf-8".Mthis funcR returns the outp"ut as text string. Either *xml_data* (an XML') or *from_file path orE-like object) must be provided}SinputwThe configuration ops are the same61for``C14NWriterTarget``.~1"""4if is None and :/raise ValueError("'J''C'!")WQsio =}nif outz'a= io.SBIO()parser =P !(t=`(out.wC, **F)G 1nothd.feed(bclose(JelifRU(4", H=return sio.getvP() if/WQ else _looks_k_prefix_n( = re.compile(r'^\w+:\w+$',UNICODE).match class JNCanonicalizd"r  2XMLSerialises events totC 2.0.*Y`* funcAusedc1ingD`result1eami(9bytes). To Cea, open it inmode with encodingQq"utf-8"Cp0bits ``l`` methodC:0- *^P_comm `*: set1tru`includ"0- * p_4 whitespace beforRaftertcontentR!re=.esX@replOXYies by "n{number}t@- *q*_aware_tagSa1of  P tag +sydwhich Zq`shouldKd?@lOattr_ibute  !ex_o DthatX4e sFd4- *N bVGdef __init__(self,%A, *,p  p=False,yi ZP=,+@ Gs% P): self._write = # self._data = []with_comments< ,strip_text = &exclude_attrRIset(Y) if  else NoneL add neweation.3#ifrewrite_U*es ri,&J_map(# =Y+U[uri]z+A = f'n{lena9)}'_[-1].append((uri!)))>00if !''#in  default  ed#noAv needed> 3Tfor u ^+Bu # As soon as ac isUined,M# anything that has no(Pthus,y) goes thereraise ValueError(f'N "{uri}" iScope'def data , !@ignoZdepth1!H cc_flushe_join_text=''. s96 = $5 .__3del&[:Qstripfm^preserve_ R! = .E(x^0ing$rtfJNoneLSargs, 35endI , C SqK_looks_liky(! ) Rrstart(*e6if +iW{qOroot;(_escape_cR_c14nI"_ns,SD # we may have to resolve qnames in text content if self._data:uflush()ns_stack[-1].append((uri, prefix)) 2def start(8, tag, attrs)mexclude_tags is not None and (QS._ignored_depth ordSsC! ?I+= 1hereturn/ 2new_namespaces = []PdeclaUQ ;RqZ__awar56tag  .U# Need to parse/Pfirstsee if it requires a eation.S0ing1frt = (,, 7 |NNC yr z u",  =o(jH  O = {k: v for k, v.items()Uk#in k}HB{*H}resolvednz<2# RBBibuta,'if : = [_R3] =#_&((fRs.add#Qfind_(; I(%x Pqs)-rvalue = [)7%if _looks_like>H37 # UYNelse! =, ()# Assignlexicographical order of used URIs1c"Tl"n:61(n)njsortedNs, key=lambda n: n.split('}', 1))`Write $O,&..+if?q attr_listk = [ ('xmlns:' + prefix if Relse !}', uri)@0for,3in new_namespaces2]attr_list.sort(]x:+# almost always empty"M%] # ... followed by *ibutes in URI+e order7!if(s@k, v90ed(Ns.items())/lAif q$ is not None and kFVresolvedBOSv = parsed_q*s[6j[v]][0l82,d Qk>D# NoNGdefault ('') .P6qappend(Az@uri 8v))Honour xml:c+pp_behavi.=&s.get('{http://www.w3.org/XML/1998/}C'self._preserve_. |4= '7' ! =kI[-1]Write the tagw"= Da1('< B0tag4 E '.join([f' {k}="{_escape_ib_c14n(v)}"' /7U&])mS/>'  text contentj_nRcdataS yZ\iroot_seen = Truetns_stack1[@def ',D#ifignored_depth8)._!U -= 1vereturnXOWflusheRf'':rif not Aroot_seen:Za^a'\n') pdef pi(, target, n)?#if[ignored_depth _areturnS3Jdone/p(._6*el<C andKM `Rf'' if h else 8?}0 z"#  character2try%# it's worth avoiding do-noth calls for strings that areMD@shordthan 500w , :o. assume>'s, by far,Ethe most common case inapplications.5`if '&'%0 = .replace('&', '&/'EgE/\r!\rG8#xDS, except (TypeError, Attribut_raise_serializs _e5A) aHa ute valu5 |"~"}>quotH!\tI8#x9/\nHnHAHV?# -0 # Import QC accelerators z# Element is goto be shadowedA2imp+ . We need to keepa#mPython version of itbssibleFome "creative"gexternal cod! # (see tests) _Element_Py = Element #S, Sub, ParseError, TreeBuilder, XMLr, _set_factoriesNrfrom _eatree import * Kexcept I<:@pass else 6@(ComD, ProcessingInstruction) # $Id: __init__.py 3375 2008-02-13 08:05:08Z fredrik $ # epackage # -0d # Thej toolkit is # # Copyright (c) 1999-S by FQLundh-By obtaining, u, and/or copying this softwareits # associated docuNa<, you agAthathave read, understood,Fnd will comply with the follow@erms|` condid!s:Permission to use,, modify distributeo # its for any purposPout f  hereby granted, provided Qabovenotice appears in Bpies=!bo/at=naEis p9 # Zp in supTH aA!atn name of # Secret Labs AB or `author_0 bejd]padverti:)publicity #[!ofSVQspecific, writtePpriorM.SECRET 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 RESULTFROM LOSS OF USE, DATA=pPROFITSpWHETHERAN ACTION0CONTRACT, NEGLIGENCE;O.TORTIOUS3`, ARISv0OUT@OSQCONNE!!USIPERFORMANCE #2 .>5 # LicensRo PSFb a Con$@or AySee http://www.python.org/psf/lO' h`etails?aDeprec$Qalias*Pxml.e.B! A"""P interfaces`PXML p`rs. T|4Ps oneule: expat -- O wrr for James Clark's Expat parser, with namespace support. """Interface to theHnon-validating XML[.8 imE sys from pye* # providesubmodules as xml."s.< S sys.,-['*el'] = model/ aerrors0 Simple API fora(SAX) mentationPython. Thist4uleLs an4!ofJtSAX 2 ia; informXQabout'Java verso;5& can be found at http://www.megginson.com/SAX/. The Tpis docueUd <...>package contains`follow m : handler -- Base class nd=stants which defineKy 'client-side' of .. saxutilswIT=convenienccommonly used toxR work2SAX. xmlread8  }Driver that as=V.InputSource#!ContentH0, E=2`_exceps0ortE,NotRecognized\y@SAXP-rSAXNotSGRNotAvailable def!(s#, !, =A()):cr= make_'()J.set:(_ & `z )c)String(si)if is None) = Idinpsrc = pif isinl%ce3str?haracterStream(io.R#IO<)7els AFByte<s;r(:)t<iN$P listAd by_P funcd if no # alternatives are given as nparameters to the function default_parser_list = ["xml.sax.expatreader"] # tell modulefinder that importing sax potentially's J _false = 0 if S: . 1 id os, sys:0not %.flags.ignore_environment and "PY_SAX_PARSER" in os.&v&].split(",") del os _key = "python.Z" sys.platform[:4] == "java"registry.containsKey(Z) :getPropert:S make(3=()g"""Createsreturns a SAX 2!. 'WCirst it is ablevinstantiate ofAonesCPgivenDAiter5cd by chaining[>t. The Kss must R|PnamesPIms(pIbothv2 a BNB."""4forjZlO) +  6try ) _}Sg)+except I1ZErrorKJF/,ifY B3#f was found, butK%it<# failed unexpectedly, pass thi3ion throughCUraisePSAXReNotAvailP 1det `t won'Ark pQ5ly,lbso trySfext on"?C("Noy=", None)q--- Internal utility methods use" j8 : l ?defK %from org.CcoreBdrv_+ =.eHName, 0, globals()F.r) elseOR = __)__{},{},['p/']N"""Differ}Akinde5E@ions&  (P.lang]Eort R~@ # = SAXEXCEPTION = ==== class SAXException( %): """Encapsulate an XML error or warning. This Pcan containC]basic3 informav from either thedPparseeEaapplic2`: you j2subwit to provide addi[!al?Bfunc@ity, to$ localizU. Note that althoughh2wilGreceive a51 asqargumenhandlers in E:H interface,g are not actually requiredQraiseC[e; insteadC1imp= adw iqit.""" O def __init__(self, msg, cS=NonepCreates'e message isQ, but,yLAis oy!alp._msg =0H& =$.)BgetMReturn a fo&isn%."pr.9msgcevmbedded_x0 if;re was nonezS__str a string represent! osr __getitempH, ixt""Avoids weird.ssomeone doehu[ix] bymmistake, since _W has definedVD Attribute'("6p") # =PARSEEXCEPTION7P(I?EJ | includetF[ originalO1doc.^us  1 xi2to 6!"it <min it and J a differa%.Sbtn%a t of&,Yinheritsxpabilitywrap anoU/,3tor`,"UF The parameter is allowed to be None." SAXException.__init__(self, msg, e)4._locator =  !r# We net cache this stuff at construcvg time.<"If.z is raised, the objects through which we mustItraverse2getVqinformaz0maydeleted by_Fit gets caughtsystemId =  S.getS(;ocolnum3ColumnNumber7Oline8ELine60def Q!):"""The ct! nu o~Te end text whereHoccurred.""Ycreturn!   W9numPublicIdG41e p! identifier/ty>')> {;T&IdS__str Create a string represent[G>sEsysi0'2if &!is= "w\7geti4if *cF= "?]\ ^ ^+] \B"%s: %s" % (,,Cnum,Zmsg) # = SAXNOTRECOGNIZEDEXCEPTION q class'otRecognized(5"""  @for an unrC.>An XMLReader willpwhen itpconfronqwith an gfeature or property.q applic~s and extensions mayJ similar purposes QSUPPORTP SupportO(sB M a service it can:not perform is requested (specifically setting a state or value). SAXFapplications and extensmay use this class for similar?purposes.""" # =]NOTSUPPORTEDEXCEPTION" LSAXReaderNotAvailable(SAXNotSupportedExcep!):q5"""`a missdriver. .bAn XMLf module (") should raiemr when iiis first imb, e.g.$2a s_cannot be/.It also U"bevPd dur0parYif execunArnalHaprograhpermittedBSAX the pyexpat C@. T'works with *`.__ver__ == '2.22'. `  = "0.20" from xml.sax._Fs* *"thandlerfeature_valid$, namespacesC/_prefix7aF_ges|pG st_interning property_xml_:%, DP_dictZ_'Bers.Pdoes IError in Jython p sys ifP.plat9@[:4]b"java"^J"vqai?, None) deleR trySN , 6|4ed"BelseC!ifhasattr(p, "ParserCreate"UOr&4saxAxmlr, saxutils,  AttributesImpl =;/.*/NS,&If we're uPufficiently recent Aof P&, we can # weak references to avoid cycles between [O:content #, otherw`we'll just haveTpretend.,_?refdef _mkproxy(oeturn o S;$ =.K`%, r_ClosedDg@passzP--- EftLocator(.&3"""ubExpatParser clas(s. This uses a weak reference to the parser objectavoid creatingFa circular@xbetweenE1andcontent handler.E1"""def __init__(self,!): ._ref = _mkproxy()FgetColumnNumberME05 = N`#ift#._&vis Noneareturn;7?h.Error OLineL1 PublicIdA! 9%source.get oSystemf) # --- ExpatP0x class(xmlreader.Incremental/&, sLocator"""SAX driver forA0pyel C module.=_>namespaceHoing=0, bufsize=2**16-20o .[F){<K8 = KAputS(/,* =IKEs =  xClex_T__propSoing = FalseDentity_stack = [] xternal_ge0 in_1Ia# XMLR methodse\", :"!0 anBP docu8 from a URL or%In`.Hqaxutils.prepare_i0_o(_8Celf.>G:tryWresetHS.setD(8 L)"FF 9.=jexcept# bpo-30264: CloseQP on eRnot lsJsxml.sax) doesn't give accessIFpunderlyr#'Zcalle0._c dWraiseN7V): if source.getSystemId() is not None: self._parser.SetBase(C!) 8"# Redefined setContentHandler to allow changing hPs durj2ingM>defE(,9)xmlreader.IncrementalP Fir6ing_{._reset_cont_(getFeaturedGname0if R == f(_jspacesorreturn v%/elM stI}_intern S$^Din (validation, exlual_pes,@1@_prefixes/0Hsg5 'Q raise SAXNotRecognizedExcep#("Q '%s'r&1" %sk, stat ySupport0Can4setvs while O"Cw c" =-~PwR O 4s , -E= {}!Nelseg7c9%* Po"expat does= ~%")9pKK }ameter entities JhY re   L{getProperty~e): if name == handler.property_lexical_7: return self.*&_?*'elaYinterning_dictX)Q xml_stringM#ifjparserif hasattr(), "GetInputContext")=A =.;%()2OelsePaise SAXNotRecognizedException(KO!"This version of expat does not support getting"I the XML R"rSj"d@ canAbe rXqed whenVn%#"PQ '%s'ErL1" %!)  de$t2,!w, value-\9lex&" =b  "M]resetyl{Yt R| iset" %/!:[# IncrementalP methods|Cfeedudata, isFinal=Fals}q D8_4y = True!Dcont.startDocu(M:trywT# The parameter is LQal toVyreader.p# If it51set0Crue,will check2PidityZentir3# d0. WFding chunks,Qy arenormally fw+ -e{invoked from closeGh1er.(V.error as Pexc = K6E6S(e.code), e,i# FIXME:to invoke errogr()? self._err_handler.fatalError(exc) /def _close_source(9!):O0 = .%6try+/@file-L.getCharacterStream()</1if 2is not NoneP%".>ofinall~ OBytey4/'1if :._entity_stack or8parser is1 orOisinstan"._/@, _C!dP>)p6# If we are completing an external @, do`hIhere}ereturn .feed(b"", isF{Z=True)U_conttendDocument-j= Fals# break cycle created by expat as pointo our methods nAer = J-ifq# Keep ~ColumnNumber andDLinePfter gEing.4  _).uJ!s)H FT~ &"YresetatAZ.ProcessingInstructionHI = \{1R pXM1FData{$ Uc(s4lexQ\_prop0lexs ,(0if F +@.ComA;)StartCdataSes3?End1dDoctypeDeclE0 ;els Rlex.c:s#ODATA=;CendC9 parser.StartDoctypeDeclHandler = self.s"_d w_decl !paE?EndClex.endDTD 7def reset(]!):O"ifo_namespaces!0"._o = expat.P~aCreateR ._source.getEncoding(), " ",lOrintern=x Iing)F._prefixes = 10yElementue?_nsE?EndCOend_AOelseY8 T[_V& #;r_cont_h(#!Un dEntityAu!!_e" C KNotationEn>)N>D  ?EndI [ G~H[9_prop = None'9lex) *@() #wr.DefaulT(Expand =.NotStandalone Ex<"al5Ref0e 5refI?trycSkippen VsUYexcept AttributeErrork# This py_ does not support ~Y6pas SetParam  =n.XML_PARAM_ENTITY SING_UNLESS_STANDALONE)ing = Falsgystack = []?# Locator methodsgetColumnNumber[xQer is Lareturn=.n OLine/return self._#parser.ErrorLineNumber def getPublicId(self):preturn ._source./)FoSystemF/F# event handlersstart_element, name, attrsScont_F.=E<6AttributesImpl(Ep?endng 8endeNP?_ns apair =.split()pif len(#f) == 1A# no9Uspace63 = (None;V,elX3X=Q[0], %1]aJelse2#WOault RtupleG1newU = {}dqs`for (a, value) inw.items([@partD4 ^"length =h6rts( *#  1 = aY%  Db"%s:%s" % (![2jrts[1]U7{,, = $a={ }[+2] = $gs"\ !NS!, ' YP!NSR!, 's)]   ;Uo#ir-o& m5# this is not used (call directly to ContentH%processing_instructionmtarget, datahGIF @Q*character_  7!s(-e1_decl(self, prefix, uri):  self._cont_handler.startP.Mapping(p< <def end_namespace_decl(O", /f ?endd)_y_doctyp_t, sysid, pubhas_internal_subset4lexR_propBDTD(RKYunparsed_entity8Lbasenotation! 4dtd._E^DFW*, Q&@ I#exh3refH_ext, | if ,%._M6gesreturn 1source =;rresolveE(;) ?axutils.prepare_input__(,7;=.getSystemId() orM#""pyZmstack.append(w!._#r,)%=#.E9PrCreate( H_H:tryxmlreader.Incrementalc.", RhjexceptL 0 # FIXME: save error info here?]UE[-1]3delO#Vskipp)Q", Wis_pe1if  # The SAX spec requires to report k PEs with a '%'7q =+ ON) # --- ch(*args, **kw RExpat )TAif ___ == "__main__"!impxml.saxJp = 9p.setContentH(A.XMLGenerator("9EG 7 .j"http://www.ibiblio.org/xml/examples/shakespeare/hamlet.xml") """ This module contains the core classes of version 2.0 offor Python.Hfile provid5nly default classes w^ith absolutely minimum functionality, from which drivers and applications can be subclassed. Many of these cs are emptyE re included only as document\ B interfaces. $Id$ """ ion = '2.0beta' #=8 # # HANDLER INTERFACESf8Q= # Pd ERRORq0 c> ErrorHandler: """Basic for SAX e-" h.50If you create an object that impleyfs thisT,nqregister=wHyour XMLReader2 parser will call5F`methodbrIto report -rwarningns. ThereDIthree levels ofs available: E, (possibly)?precover&7,.und. All atake aE@SAXPPExcep32theparameter.#de(self, e9)$"= a !."w&Vraise@ _Qfatal*dOnon-h"Ze,fprint( CONTENTrContent"Ireceiving logicalR" c@d eventTae mainFback0 inU#ae mostw imiant toa ordervL `E mi2kainform ;e Y__init__Qk._locator = None0CsetDqL#@#, 1I"""Called byqto give$ aDX`origin 1K?strongly encouraged (though nottrequired)@suppj: if it does so, Rmust )E orGby invok#is1S befo$c other0\ .U4The<"owHto determine the en3d position of any document-related event, if the parser isFnot reporting an error. Typically,9qapplicapwill useDthis inform"7forUcits owZs (such a character content that does 0mat1'n '?business rules). Thereturned byilocatoprobablyppsuffici use with a search engine. BNotee`(} correctEonlyC0dur@0invc kqterfaceCq shouldattempt toa it at1other time."""Gdself._#= def startDn(/%):>"""Receive}$if5o`beginnL4SAXEkbis method = once, before+8  n DTDHandler (except forE%seL1or))! ?end$1end30and+!b/de last3F'd kFpUshallF7zR` untilsahas eiH`abandogU5ingEP(becaFn unrecoverableo)qreached BZinput|PrefixMapping1, pZ, uriB{^Rscope.-URI Namespace mQ  2rom" inecessaryH nL`0pro(Aing:XML reader P autoN @repl!esh0ele attribute nP whendB http://xml.org/sax/features/3#s true (thdefault)!re cases, however,@s ne6in @data6in @valubAwherE0cansafely be expandedO;JI/endN7@t su es2  toixe2ose`xts it9E, ifD>XZthat start/endPrefixMapping events are not guaranteed to be properly nested relative to each-other: all7_startowill occur before the correspondingFrElementP, andj/ e`G^aftergC ]0but(ir order isE #Q.""" 0defI (self, po!):(P`"""Endb scope of a'b-URI m.[3OSee Mfor details. This ValwaymotAs isAGwiseK (s$name, attrs)rSignals-N-3n epin non-@space mode9@The p paramercontainTraw XML 1.0( oflhtype as a str7^holds anBqinstanc1Attributes class U Q %ofF M>endKD?endB<^6.e, justpas with]> !)NS#qo*&?ame&"u7 (uri, local1) tuple,'J|D9 used in9source docu>(sRB yAYyW0urit PNone =s which havek!nou =/NScharacters:ent@Rece^notificationj>[ databParser`call tmethod to report each chunk of &character data. SAX parsers may return all contiguous> in a singlej, or theyL`split 5ntoDrseveral1`s; how,t of? sd#nyfEevent must come from: same external entity so that!BLocator provides useful information.""" 1def ignorableWhitespace(self, w!):/l"""Receive notificT' oJ:@elemyBent.|MValidating Puse this method to repoz0(seFe W3C XML 1.0 recommenv5on,E0sec 2.10): non-vJ@alsoUGiy are capW@Pand uYgmodels a  F   F , =`procesKaInstruqtarget, a/P& iQ3The@ wilP0vok`once for` founditE/atUoccurG`before afthe main docujrA should nY!an$bdeclar(5&!8)o text 5 Se4.3.1) skippedEOname@#eY;. Noi'}Cies E"ha8P seen<s (because,Gpxample,(BC was; edd&anDTD subset). All[&or Ties, dependo`values5the http://xml.org/sax/features/@-gen-Fal-parameter-entities `proper.""" # = DTDHandlerw class:E2"""( events. This interface specifies only those5 required for basicFparsing (un 4ed  and attributes)!def notationDecl(self, name, publicId, systemId):a@q declarL"."fEYyl, ndatas$n Ny{ENTITYRESOLVERResolver@"""BWkr%cY . If you create an object`implem,Ing t, then register:P withTrDaParser/ r will call6method in4E!to> e -external3ies. Note that Default%r  Rthe d6 behaviourY~bZT #""v0 idCpfier ofc!tyreturn eithe1= to read from as a string, orWInputSource=J4yf`Id #5 # # CORE FEATURES^5H feature_spaces = "http://xml.org/sax/)&s/*" # true: Perform NameFr proces"). # false: Opmpally do=/ pC #n(p-prefixP # acv0: ('Aing)-Ca; (not@o/write_VaReportPorigixXd^s3 usIXsID>rkK   s,{]- oR(v,_nZ 0-0rRAll eoa#, qe@ URI!nd # local names are interned using the built-in function. # false: N@not necessarily4ed, althoughTy may be (default)M ac8`: (par~) read-only; (Z /write feature_valida = "http://xml.org/sax/)&s/*" # true: Report all  errors (implies exal-general-entitband # &parameter(60Do rz v0O_ges , $qInclude%/  (text)  i> :3,\/_p 1", 4DTD subset5anya d@even?&_ `F$Dall_%C = [ _rpaces,  $_prefix, rstring_l?ingV$l&pes] #=8 # # CORE PROPERTIESc8 = property_lexical_handler/Cies/1-1data type: $sax.sax2lib.L_H^ # descrip[a: An o !alcnsion ZS for n ts like commentsy_declar5ODecl&DTD-relatedVother @thans and un89om_node@dom-* org.w3c.dom.Nodescription: W.hen parsing, the current DOM node being visited if this is # a3iterator; w[:not_7roo\+a META tag)i^: return (possiblywthroughK auto-detec%initial value: UTF-8 #interning_dict  7-7 !Di?ary1ionary usedNs common2s idocument`Requesae erWs a specific rO, to7Rllow cross diffeuIypor None}Fall_C = [y_lexical_handler, ,@dom_#% `eclaraUW %  \] """\ A libr offul helper classes4SAX,# convenienc$aapplic and driver !0rs.s import os, urllib.erH($io codecs from . G 0xmler def __replace(s, d):B"""RB subsa u' aA."""=for key,"d.items(^(ds = s.{/)Cospescape(o, entities={}OA"""E"a &, <,c>w#of]You can Wc otherh by passing a dictionary as the op'l entities parameter. The keys and values must all beFstrings; each.1 wi replaced with its correspondingQ.EA""" #`do ampersyQfirstpdata = .^("&", "&")&>&/gt% <%l%%if:[7~P = __R_,.areturn def unescape(.B={})`C"""U$ q, <,> in a t1 of\.;uYou canec other,s- by passaq4O, "< 2>%,#la"")quoteattr E&0@ an 4Tibute8*B&, <%>","n Lit for use ^\" characterd as well, ifnecessary0)T= {**, '\n': ' 'r3t':' '}.2 =  >`if '"', nif "'"* = '"%s"' %0'"'4Felse^Fc"'%s'"F +' m'  _gettextwriter(out, coif out is Nonimport sy`sys.stdoutif isinstancedio.TextIOBaseiB#  id] (codecs.StreamW), bReader)-?eam# wrap a bidWrapper if isinst ance(out, io.RawIOBase): # Keep the original file open whenTextIOWrapper is@destroyedclass _w.ls!____ = out.>& def __getattr__(self, nam)sreturn .+Sbuffer =+().close = lambda: None$Felse!# This is to handle passed objects that aren't i>H"#  hierarchy, but just have a write methoRAio.B"edKA8abl2TruL.'$ 6try2*# 0use#is sdetermi67# if BOM (for UTF-16, etc) should be add>7Cseek+CtellS #except AttributeError0I9io.(, encoding= ,7eks='xmlcharrefreplace'8 newline='\n* _through=1) ` XMLGenerator(r.ContentHAr): mEinitj@out="iso-8859-1",rt_empty_elements=Fal\w7.__l0outqgettextro,!._$  Sflush  @ns_cxts = [{}] # ains uri -> prefix dict`tcurrentE2 = XK[-1]vundeclared_ns_map} &% =w H=sho :0pen@_staB1 = qF|"""Builds a qualified from a (ns_url, localJ) pair"""!if3:[0]# Per http://www.w3.org/XML/1998/Ospace, The c' # bound by defz1ion_U. ItOdoes not needI4be  and will!pusuallyf+inL0 H.%Oif ' B' ==N0]:   return 'xml:' + name[1] Q# The is in a non-emptyYspace3prefix = self._current_context[f*0]g2if 7:Kp# If itnot the default,>ApendJ Io + ":"2# RiunqualifiedmTL11] def _finish_ing_start_element(R,endEv=False)#if4?(L._write('>')F1 = w0# CntHandler methodsEDocuh\n' %N3)?end gflush(2PrMapping}(fix, uri$ns@s.ap>5 v.copy()s curi] =r,undeclared_ns_mapr(?end '[-3del{ " ,}, attrs  ;B Pfor (g, value)rw.items(yH_P %s=%s' %CPquote(M|0shos{  f = TruOelse=:">"_zf/'/!M `'b)NS0q+7>\0)EWC/ GA' xmlns:%s RPM)C = [' 9e) in attrs.items():  self._write(' %s=%s' % (`qname(), quoteattr(value)))J2if 1short_empty_elementsqpending_sta0*u = TrueVOelse=Q">") ,def endEF!NS , !, oF'/>'BG = Fals`'xTwcharacterszcontentfinish_(if not isinstance(XW, strr  = -_@enco dUescape)ignorableWhitespace>processingInstructiontarget, dataP-}'8'<e^Uont_handler. startDocument() def endaself):._cont_handler..E^PrefixMapping(=1, p_, uriY B< id :end;b 1Ele%name, attrs^ <6 !]V 4end3T#NSp$2, q2NS(8 ?o fcharactersy?entY 60ignorableWhitespace\/ha =nsprocessingInstructionctarget, data F @skippedEntitykc 60Sb# DTDH methods@notaGDecll, publicId, systemId5dtd7 H~Bxdunpars~?, nhUO"# nResolver(r')# preturn 7._ea JDXMLRead<msourceparent.setContent6)-_Error+3X ) setLocall .(IgetFeaturJH 4.NsNo, stat N.UgetProper_parent.getP roperty(name) def setP`self, !, value):(,._parent.5/W# XMLFilter methodspAgetPE(Rapreturn h6q6", >7# = # --- Utility functions 0preH_input_source(, base=""cu"""ThisB takes an I=S<@ and ope!alD@ URLIs a fully resolvedFobject ready for ring."""if isinstanos.PathLik= os.fspath)K3strC0xml7er. Oelif hasattr0, "5JQBf = h? = d) f.\Z(0), +TCharacterStream(fPFelse 7NByte2@f, " ") f. SystemId(-#ifL.get) is Nonep7get#UsysidtX{ 0hea(0os.)@.dir(@norm(,);`@file. k'Q.join,X!, '6 if) is>(! H  /K.bJopenS&b" furllib.parse.urlPz3prequest5H :sf!:` """Anfp Readerthe SAX 29a$!r.0Prs should be`d on tacode. jfrom . import handler Q_exces"SAXNotSup04edE!,NotRecogniz =pREADER = class"""Interface0ingwXML document uscallbacks.9:XML1iMDthatF1 's`2 driv1ustdPimplee!. DQallowpapplica0 toeQqueryEafeaturC2d pPies ie@ser,<PregisK evsF&or`proces,mto initiate a d:ocument parse. All SAX interfaces are assumed to be synchronous: theB@methods must not return until( ing is complete, and readersC;wait for an event-handler callback]before reportingGthe next?B."""def __init__(self):0t._cont_o#= .ContentH+()6?dtd5?DTD1efEntityResolverf?errfVErrorh, source "PaTXML d from a system identifier aInputSL!."i9raise NotIV!edr("This Fbe i&6!");getfROsv@curr 3- D rsr, {gisters a new objectVceiveDBs a7get84 R 4DTDnrjsj -basic DTD-relateds  3m >+r~ v  external .>tie4 = b1get11msm e-message cLocale|l zp""Allowyapplicationx1set 4/sTwarnings#reBquirprovide Q"iziW_@; ifPy can0supp requesS%e,Chowever,'yEaPexcep6. AUs mayC]" ae change inU middle of aye.""" raise SAXNotSupportedException("Locale s$ not implemented") def getFeature(self, name): $"Looks up and returns the state of a22 fG%."<5raiRecognizzQ '%s'r&2" %s,?SetdgetPropertyNHvaluNpHO|P2!, QHclass IncralParser(XMLReader"""This interface addree extra methooB8that allow XML ppEs toGi<#Sing. j for tAis oal, since1allCunderlyinguM@funcbality.AWhen1er stantiated itPreadybegin ac!!ng{data fromHCfeed*` immedHly. Afterhas beenBfinished with a callnQcloseVTresetWqmust be'Qed toE2mak,P new , either!orB usCo)0Not_ at#se!s W_not_0durKGPing, cUis, a $e `beforez& Byi@aultQ"e Falsoeef ", ttsG M5sponvenie to 2.0 drivekwriters."""C__init__Ebufsize=2**16J_#._3 =  .QXsourc.Sort saxutils^0% =.prepare_input_ (t+$@fileY.getCharacterStream()1if .vis NonegHIByteC buffer = file.read(self._bufsize) while buffer:1Rfeed(4/ =bHclose() bAdef Yv, data)|"""This method gives the raw XML01 in< parameter toa2parser and makes it-%se<, emitting=correspond events. It is allowed forconstructs to beE split across several call). may raise SAXException."""UNotImplementedError(6must be i&'!"prepareP!, source!isPed by.Kcaa"SAX 2.0 driv 0 itM?ingB overriddenk2whe_aentire@docuo has been`passedahrough(,'QnotifCD@that3re are no more!. \j do=@ finjrhecks o Aempt internalQ2Ther will no^Yy another lFunti[TresetJWpX afl MQ0r s at;is =5new9sIresults of*R1 orH twithout*Vundefinedjyh!edi0# = LOCATOR class Locato`@"""IvAfaceqassociaa q % alJ1 A or objectreturn valid 8nly duringEDsHandlers; at any Ptime,Y=UunpredictableN#getColumnNumber\Rc(! n)R wherscurrentWends.@"-1CsLineNumber(self)3: "Return the line number wherecurrent evUnds."?r>1-1 def getPublicId(self)mp$ identifier forqlINonenoSystemn s$n&0# = INPUTSOURCE class InputSource"""Encapsulation ofbinformneeded byXMLReader toMPread Rties.RThis smay include VQaboutR c,X  , byte stream (possibly with character encodingErd) and//ORof anyaApplics will create objects, us~,.parse methodFing from2EntityResolver.r n belongs tow& a,q is notgpallowed5imodifySBpass%!itQ@falthough it make copiesbthose."""#__init__", `_id = ?8.__" (%PG ! g fOfile k AsT%, P"SetsKi[aV~# y9set7 g{F;~ >6_idyCsetE|j"I S5The must be aEacceptable^ean XML0Eadeclar (see secR4.3.3e;recommend-)pattribu=uignored i&also contains a character stream.""" self.__encoding =  $def getE (0!):B"Get the character@ of this InputSource.ypreturn PusetByteSw, bytefile3""S (a Python 0-like object which doesnot performdF-to-conversion) foriAs The SAX parser will ignore?ere is also aBV specified, but itOQuse ain preferenceFpto opena URI connection itI applica$_knows eqf,should se!thIsQ method! =`   E   n5forw, or None if unOn[ __: DsetC^ +   (#`must b`F2.0 Unicode-wrappedZ5thaAV84 to>bings.)-u +8eam W_1any/>2andpattempt B"toystem identri! = HC?|0# = ATTRIBUTESIMPL class AttributesImpl:__init__sXattrs""Non-NS-awamplement-.H9 "beem {name : value}T=!= TMaLengthC1len!._9c:AType , >y"CDATA"oV6 p[X]@oByQNam} G ?F !if iVattrs:  raise KeyError(name) preturn  def getQNameBya(self,#!):$9!if not in $v._attrs$(~"wsxrAlisto.keys())B'q__len__g!enz__getitem< 6.[{] x__contains u "gea, alternative=None.>_ 8$Acopy?GT_clasV@_-_value@.A0# = ATTRIBUTESNSIMPL!  AttributesNSImpl(&):ge__init<0, q<s """NS-aware implementation.Lf= should be of the form {(ns_uri, l\1): u, ...}.y: %:5"""=1 = :3s =mV!Bytzpfor (ns#)[. "ifq1 == ;i$ClXo e *QA.| ",sW@) c_test(9XMLReader(BIncr>UlPars`Locato&` if __f __2"__main__"8_- # # Package analogous to 'threading.py' but using processes<SmultiDing/ 1.py cThis pais intendedcduplicate0unc ality (and much of # the API) of threading.py but uses proces vinstead+ s. A # subpackage 'multi4Kdummy' has the samq` is a simple # wrapper for 'J'. # # Copyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor AgreementX import sys from . context }q stuff &default %# __all__ = [xx in dir(%#._6_+) if not x.startswith('_')] globals().update((name, getattT , (!)) )XXX These shouldreally be docued or public*SUBDEBUG = 5 SUBWARNIN"25ZQAliaszmain module -- will\reset by bootsting childg # if '__G0__'Qsys.mQ`s: [+p.=] =qain__']A higher levelt ussockets (or WindowsUd pipes)E /connection.py"Dg 'Client', 'Listener @Pipewait' ] $io $os TtructEtime eempfilitertoolsi_ [LutilAuthenticaEError, BufferTooShortF>Areduy _ForkingPickler = .R tryGq_winapiZfWAIT_OBJECT_0, ABANDONED TIMEOUT, INFINITE except Ifwfplatform == 'win32' Qraisea= Nonem # BUFSIZE = 8192 # A very g @ous out when i0mesPlocals... CONNECTION_T = 20. _mmap_countX.D() family = 'AF_INET' 0iesf|,5bUNIX')V!Z@+= [[[1_X_PIPE'X!] s _init_\(=>areturn.monotonic() +3outVVcheckW> "> def arbitrary_address(yG"''Ran arbitrary free address for the given family '''#if == 'AF_INET':(return ('localhost', 0) -el>GUNIX>-# Prefer abstract sockets if possible to avoid problems witho # size. When coding portaI applications, some implementX haveNun_path as short 92 bytes in_un struct.Cif util._-pets_sup&edLP"f"\0listener-{os.getpid()}-{next(_mmap_counter)}"qAtempfile.mk (prefix='Uq', dir=@get_&o_dir()GPIPEj r'\\.\pipe\pyc-%d5' %(/, )$""&seCraise ValueError('unrecognized') def _validate_()OQCheck)#A is =Acurrent environRGif sys.platform != 'win32' ane j F0 %sFnot C.' %!) n {{ 0dou<cO0if vhasattr(,wA(Zess_type( R&As of.This can be, A, or}X~Htuply"@ : is#p.startss('\\\\'<WW"orn;is_q_namespacD f Y  q8%r l#) # # Connec} classes # & _$Bax_handle = None__init__(self, &`, read=True, wriS/# =8.Nbdex__(Q#ifO < 0 2"in YF%Y H"at least ones`[`\`Y`` must ") self._handle = # self._readab  "Cwrit"  #(# XXX should we use util.Finalize instead of a __del__?=4def(!):T0if is not None%)&wclose()Wacheck_d]Yraise OSError("9B is T"m<o% mconnectionqroe-onlyuu %utbad_message_lengthxt] = False?elss%()' /Cbad  )@property;pK """True if the 31"""EumreturnEx 0z 5|!vv5v!vVofilenofFile descriptor or ko' ~C" rq:tryGdfl3W=send_bytes, buf, offset=0, size=o3q"""Send; data from a -like object3om = memoryview(buf;# HACK for-indexing@non-wgbuffers (e.g. array.Lif m.itemJ > 1 <&m)@0n =&(m#ifSJ < 0ObSValue}negative"J3n n: 'Qbuffer length (XO too larg1_esult r/W.tellI #BXTooShort(\ 2# M can fit in destEjseek(0A6 //(P>)<]o9 6x] Ploadsas '()uApoll, timeout=0.hWhether any input avaia to be0& d() self._check_readable() rreturn &poll(timeout) $def __enter__('!):@= .3xit-, exc_type Cvalu 'tbJYP.clos if _winapi:Yclass PipeConnection(_ GBaseO5"""% Fbased on a Windows named pipe.8.Overlapped I/O is used, so the handles must have been createdF with FILE_FLAG_OVERLAPPEDi _got_empty_message = Falsev,7@, _C9H=8.@/"._$dsend_bytes'[, bufLov, err =.WriteFile4[<5, oTV=Truet6try["if`aERROR_IO_PENDING48xwaitresaitForMultipleObjects(6[ov.event],, INFINITE5uassert z= WAIT_OBJECT_0inexceptov.cancel`YraiseFofinall6nwrittenfov.Get~Result(*= \ == len( Irecv9maxsize=Non#if} .#P@io.B+IOVNelsefb = 128 if  5S min(,)3ORead2,@ d =!t%<|F5 0 n: 0:  f = io.BytesIO() $f.write(ov.getbuffer()4 return fYelif err == _winapi.ERROR_MORE_DATA:=bself._get_more_data(ov, maxsizeexcept OSError as eiQ.wine( BROKEN_PIPE@aise EOFm?elsA 8rSqRuntimeW$("shouldn't get here; expected KeyboardInterrupt") Rdef _poll(I , UJout)1if ._got_empty_message orMPeekNamedPipeIhandle)[0] != 0qFITruebbool(wait([] -(, # bu  <,:buf{Vleft  )1]pqassert A9> 0$if is not None and len($ +; jT._bad{_length4zReadFil,pcerlapped=  rb{, ov.GetOv1~Result(7 = ZW2 .   class Connection(_ CBase1"""f :#based on an arbitrary file descriptor (Unix only),M`a sock& (Windows).jr $ifBclos1, _ =_multiprocessing.h 2 p  QFsend'Oread&Arecv& "os""osp0os. {q, buf, !=_|remaining =b^ whv2n =Pa"._i }^E-= nXD7if |:= 0c#Rbreak5 buf = buf[n:] def _recv(self, size, read=_!):'+buf = io.BytesIO()handle = E"._remaining!5izefwhile 6> 0osqchunk =(VO,n = len(4 |if n ==^6'if!== &raise EOFErrorOelse9 !OS8("got end of f0durmessage"buf.write9E-= n`return`send_b7buf=I7b> 0x7f pre_headertruct.pack("!i", -1+ZQ", n*E(d#X # For wire compatibility with 3.7 and lowev FZ16384A70# The payload is large so Nagle's algorithm won't be triggered C#we'd better avoid th stvconcatenation.G~ ['# _c# Issue #20540: e before sing, todelays du2L#&"on a TCP socket# Also note we wantJ% a 0-lengthEfer separately,0A"broken pipe" e(As if~QotherRclose)_ +) 0maxW=NoneQ4&(40,'unxgetvalue()4!if"M*-1 k87oo@not O3 >  , BTCpollwtimeoutI`wait([B4], # a bool(r) # # Public funcn s # class Listener(objeck1'''QRSs a l( (.@Thisa wrapper for a bound` which&'listening' f!or connections, or for a Windows named pipe..1'''def __init__(self, address=None, family backlog=1, authke!):L/# =8(QD and]T_typeE)) \AEor default_U#P=Nfarbitrary_(6%) 8_validateQ"pT if== 'AF_PIPE'($._listener = PipeL#, *)}OelseJ nSocketLTU$if is not i isinstance(w, bytesraise TypeError('. should be a9 string'U1=v^aaccept\wA"' a on the bound sP of `}"`.lJReturns a `C` object'}0if F!isF ##OS!is closed';c =T.$w: ndeliver_challenge(c,S0JOansw/r#" c5 Cg1 %  =CuD.@property,&R.T5MRlast_,edKS 4Ys__enter .x1excZ , Rvalue 'tbJ vfClientssGq1 to-b4a ``@h /7   Y * ,t0Mp{ is not None3:  answer_challenge(c, authkey)%_deliv&'return c if sys.platform != 'win32': ,def Pipe(duplex=True)1''''RWs pair of connection objects at either end$ea pipeCO2if tnfs1, s2 = socket.t().setblocking(i!2! ec1 = C(s1.detach()kc)2)Jelsepfd1, fd=0os.  1writable=False fd2, read1r1, c2 gaddress = arbitrary_('AF_PIPE'%openmode = _winapi.9_ACCESS_DUPLEX 2accw0GENERIC_READ |GYWRITEBobsize, i = BUFSIZE, .iv uINBOUNDA70ThCreateNamed&z%, FILE_FLAG_OVERLAPPED |?d+QFIRST_INSTANCE,3TYPE_MESSAGE7MOD HJWAITg:1, ,0NMP0_zFOREVER=.# default security descriptor: the handle cannot be inheritedINULLh4IYFile(/7", +7, 06ULLOPEN_EXISTINGeAA5SetPH KStat&h2Tb, None )overlapped (h*R_, err = LU.GetO0kResultUbassert:6= 0I1ionc2 = PipeConnection(h2, readable=duplex)  return c1, c2 # # Defini<s for conLs based on sockets # class SListener(object):i1'''Representa^S of aI which is bound to an address and lZ1ingJR`def ____(self,5, family, backlog=1+"._# =.(getattr(I!))z>2try # SO_REUSEADDR has different semantics8Windows (issue #2550).ZMif os.name == 'posix'p'@.set3opt.SOL_SOCKET,^;C8et.6, 18 wblocking(True+Sbind('()D4elf".g7(7except OSErrorE Wclose9Uraise=/U# =^ plast_acted = Nonel#if6AF_UNIX'not util.is_abstract_Uspace? # Linux 8 8Ps do b1nee[be explicitly unlinked" =Finalize(*.,1t, args=,), exitpriority=0A:lse Tm", 6 <|sH)C (s.detach()PHg 0 3fglbY G#ifF) J"._@P() dClientRGa- z4thegiven by ``RiF_typ+CwithN v ) as s #s.o" ?ad pipeCif sys.platform rwin32':?dOPipeb''' Representation of a named pipe 5''' def __init__(self, address, backlog=None):3F*#._*$ =4$handle_queue = [:Bnew_(first=True)] Alast_accepted = 'util.sub_debug('listener crea4Dwithb=%r', )N@clos[Finalize((s, PipeLt3._f._s_,<Qargs=r. $ , exitpriority=0I)5[", aLFalsflags = _winapi.PIPE_ACCESS_DUPLEX |FILE_FLAG_OVERLAPPED"ifk *(h|iLaFIRST_yINSTANCEUereturnCNw!, z} TYPE_MESSAGEwREADMOD LOWAITo UNLIMITED_S, BUFSIZE g0NMPe_FOREVER, MNULL; "L{q.append-'._[)64# =ZCZpop(0/>try&'ovvConnectSp, overld4 ex' OSError as ehif e.wine$!ERROR_NO_DATA8FraisI)# ; can occur iclient has already c.ed-# written data and th%is6 -- see Issue 14725. /lsw(reWaitForMultipleObjectsl:[ov.event], g, INFINITE-^ov.cancel(8<kCHY(0lc, err = ov.GetOnqResult( k6bassert>*= 5ionO @sucmethod:izeW(W, address):  #util.sub_debug('closing listener with address=%r', ') G for handle in queue:!-_winapi.CloseH.(5!) -def PipeClient(w)J1''')N Return a connection object ed to the pipe given by `Y`LXt = _init_timeout(vwhile 1:tryWaitNamedf, 1000W1h{%reateFile($$, jGENERIC_READ |oWRITE,K0EFNULLOPEN_EXISTING<~FILE_FLAG_OVERLAPPEDIW{ except OSError as Fif e.wine$0notr(ERROR_SEM_TIMEOUTF APIPE_BUSY) or _checktAy raise?elsUbreak($H!&SeJ>KStathuMODE_MESSAGE, NonebrYC[(h) # # Authenticarstuff # `_LENGTH = 20 CHALuE = b'##' WELCOM #' FAILUR @#' deliver_challenge(, authkeyimport hmac1if +sinstance(0s, bytes7 a Value "key must be?,^{0!s}".format(typf"))`message = os.urandom(;)a.send_(A3 + K/PdigesF.new(, 'md5').+presponsrCrecvr@256)A# re`Tlarge_K"= d\ 11' received was wrong')NOanswM/ # reject large message assert[:len(CHALLENGE)] == 3, '; = %r' %8K [M!:]' digest = hmac.new(authkey,NhRd5').+!()8connection.send_bytes(#"response = -Crecv-@256)# reject l5if K!= WELCOME:;raise AuthenticarError(' sent wasded') # # Support for using xmlrpclibserializT # class CWrapper(ob)def __init__(self,, dumps, loads,# ._$+7" =? L" =T attr in ('fileno', 'close @poll'obj = getV( , "s  R, obj%a/:0 = 6!._P62elf ks!WWsR.#w8YcreturnyJP(s) SG_xml0$.,), None1).encode('utf-8x^q\Emethod = f)9.deK4objXmlListener( |laccept/fglobaluK!im"@.cliL/as*$r.hNA&, u AXmlC~(*args, **kwHo R@Wait)if sys.platform'win32': _exhaustive_wait(handles, timeout2# RCALL ( which are currently signalled. (OnlyoCthe first0 might create starv issues.pILq%isready = []-rwhile L re_winapi.5ForMultipleOMs(L, FalseDZWAIT_TIMEOUTh(Ybreak:Qelif 5OBJECT_0 <=e+ < + 5LR*-=/eABANDONEDh res < WAIT_ABANDONED_0 + len(L): res -= WAIT_2 (Oelse:aise RuntimeError('Should not get here')Lready.append(L[res]!AL = I+1:];huout = 0qreturn V _ _es = {_winapi.ERROR_BROKEN_PIPE, NETNAME_DELETED}Pdef wait(object_list, W=NoneV1'''eWait till an =$ i G2 is/Rable.t?R s p of thoseHsIwhich arePK$if  = INFINITE'el=?< 09=_Dint(P* 100F0.5)9/= ;handle_to_obj}$ovC[Uvy,0ect+Fset(RTR:try[for o " 7fileno =9attr(o, ' C.except Attributn+ [o.__index__()] = o1q# start@verldwlength zerT>ov, err =ReadFile( (), 0, True:!OSO as -oq, e.win8 3!if9in k}9r-WS=IO_PENDINGZO/ovv.event4t# If o.KRpipe @O andI= 0 then!reOHTmessageGi< x, but it HAS NOT been consumed...GPif ov sys.getwindowsversion()[:2] >= (6, 2 c# ... Bon WL! 8alater, w'S#  =  Stry: _, err = ov.GetOverlappedResult(False)G except OSError as exu`e.wine7b aif notand hasattr(o, '_got_empty_message')~.o.8 = Trueready_objects.add(otimeout = 0 RF handles = _exhaustive_wait(0_too.keys(), Tukfinall# request that o {is stopfor ov in ov_list?ov.cancel() #  C>allm/top"  !if@in _V!y_s:Nrais[K!= _winapi.ERROR_OPERATION_ABORTEDY1o = /[ov.event]O== 0~R# If o.fileno() is aHEb pipe _ thenJa zero length  HAS been consumed.C/if, vnupdate1[h]hX3sreturn [o*o*WA if >s] else:import selectorsr# poll/P have{ advantage oO(iring any extra # descriptor,}trarily to e`kqueue (also,byzire a singl# syscall)ors, 'PollST_Wait& =.2N9N"or51defL(isW=NoneW1'''qgQ till s| y/Rable.t?R s ybthose sIwhich areP '''   with _WaitSelector() as s#: )for obj inect_list$)>.register(obj,Us.EVENT_READ) bif timeout is not Nonebdeadline =0.monotonic() +:out[while TruOuready =.()1if 4return [key.file4<(key, events)FD]^?elsZ ,5 = 2-2 :n?< 0( # # Make connection and socket>%s sharable if possible # if sys.platform == 'win32' deVduce_a( )!Phandl"6no(.fromfd(2,.AF_INETSOCK_STREAM%lpE . import resource_)erdLds =!Q.DupS&(sXZWbuilda, (ds,c.xJ@writJ/ ?=83;s.detach>C(-(,%, YAreduE7 !?pip Paccesa((_winapi.FILE_GENERICvp sQ 0) |wHUWRITEIIyD!dhADupH", 8b"re hK9D0(dhq+adh!FPipeD  B0) 'bR,dfz!Fd$v#nUifZ .i dfd fd`f`\/fdLX:7duce_connection) import os %sy threading from . .{processreduction __all__ = () # # Exceps # class PGeError(!): pass)BufferTooShort(P8.rTimeoutW, Authentica3 %Base type for contexts. Bound methods of an instanceBthis8are included in ,of __init__.py&rCh(object): #) =O 7: = $-8 =  !? = current_" = static(.')k/pa; &:active_childrenv ')def cpu_count(selfT'''Returns the number@CPUssystem'''7num = os.Y ifH is Noneraise NotImplemented'cannot determinVcpus'as such as `Lock()`, `Condi|()` and `Queue()`Mcan be used to create shared %s..sCSync6P(ctx= S.get_&()cm.start(rcmUAPipe^, duplex=True] woM!neAed by a pipe4con7y(a non-recursive locksynchronizej_ _-<R' '\j ,=Ac8f (/, 8HSemaphorvalue=1):  '''Returns a semaphore object''' % from .synchronize import S5+rQ(value, ctx=self.get_context()) 9def BoundedR(.!, ?A=1):) b6# sc QEvent0n e#kT (\aarrier, parties, action=None, timeout" bHB3 (1SQueuemaxsize=0q-sY (hJoinable8>3 a HSimpO1T CPoolprocesses, initializerargs=(),v> maxtasksperchild1i_ pool>pG(Jw, # ;L @RawVw/typecode_or_ 0, *sosharedcI3q (.RawArray? aP ~, lock=Trues"d y return Value(typecode_or_ , *args, lock=?,  ctx=self.get_context()) .def Array(# , Z f1siztinitializer, *waTrue):J{'''Returns a synchronized shared ak5'''2bfrom .c}s import(rW *freeze_sup" Check whether this ifake forked process in a frozen executable.If so then run  specified by commandline and exit?U if sys.platform == 'win32'9getattr(sys, 'x', FalsDpawn . 0c{ologgerF3 package ( -- if it does not already!st*~ itycreatedDutilHg(log_to_stder, level=Non:'''Turn on1ingxpadd a her which prints to W (Pallownection_picklingInstall P send3conBsusocketstbetweene3# T-undocumen0 I: evious versions of multiK5ingo# its only effect waOmp objectAherixvWindows/q+Fset_;&,   Sephe patha python.exe orwbinary used+5runEchilHePstead@n us`the 'smstart method. Usefulpeople embedP'\, 6 ($+server_preload[module_names]P list& &=0tryHw^really just6int$R 5fcontext(self, method=None): Aif m@ is "return self3:try%ctx = _concrete btexts[Z]:except KeyErrorFraise Value('cannot find conT for %r' %a) fromgctx._check_available()Actx def get_start_(, allow_none=Fals9F(f._nameMsMZ,cPAset 0 ofk "')~@propertyqreducer'''Controls how objects will be 7`d to am that can be]shared with other processes.'''(rFglobals().get('dEtioner.setter?,7Z[V6] =- N Lpass # # Typentdefaultm -- underlying at most once # class P($S.Base & =r@staticBd_PopenPC_objHt_{ 3()..KD/@ext( nD$ =ls_init__8|.$ =U(dactual!%cq1!if+._o!5) n(Kelse)NRsuperL( "&P and LforceRuntimhas already beeZ&t' hd3ZbM7> H EA 'ifk  =lt_context  return self._actual_context._name ) def get_all_start_methods(:!):%) if sys.platform == 'win32'$(x['spawn']AJelse+j4 = ., 'fork'] odarwin' J" [*-, iif reduction.HAVE_SEND_HANDLE/.append([server'))0 # # CW types for fixed P! mPL # !Cfclass ForkProcess(pS.Base # ==Ks@staticd_Popen^G_objV%pfrom .p&_ import 8a* Q`S %Ht4Vo_posix,S,$`m=[0( 6T( = O[ '%\`]b1gO{Ucheck_availableB.oif notraise ValueError cZ~"') Pcrete Us = {!':$&),s!: b!2F  +}R D# bpo-33725: running arbitrary code afterjk() is no longer reli}pr# on macOS since 10.14 (Mojave). Use  by default instead.M_LB = D, o]JQ#tR']) M class SpawnProcess(pS.BaseC): _start_method = 'spawn' r@static def _Popen_G_objW^pfrom .p&_V_win32 import ?R1breturn X 'pclass SContext( }__name" =E]_concrete \Qs = {x::s1(),!}_defaultAB = D/ d[X]) # # Force the  w1# rf (" ._actualy0 = C]Check that`curren read is ing a child `p # _tl7 th-ing.local()2getAing_(getattr(G,,s', NoneLsLRQB.l1 = "Vasser(?if :raise RuntimeError(/'%s objects should only be shared betweenB&eswA through inheritance' % type!._)__y#) bTerrno $os selectorUignalUocketFtrucy5*warnings connection9/c6Oredu5resource_trackerT  util __all__ = ['ensure_run@', 'f`ed_fds_to_new_'@ 'forkserver_preload'OMAXFDS_TO_SEND = 256 SIGNED_STRUCT = sg!.SQ('q')`# large enfor pid_tFw n H!kS(Rect):G_init__(self1n'._`addresd(`live_f?) /pi$ {! = p`lock =0ead\kLock()&p_module['__main__Lstop2# M usy unit tests to 3zRwith "m;0_un ed.#ifXD!is" jreturn  # close the "alive" file descriptor asks!server to stop 1os.E(self._fork*_QE_fd),# = None *os.waitpidXopid, 0V=pidQif not util.is_abstract_socket_namespaceoaddress):os.unlink10S xdef setAbpreloa, modules'''Set list of' 0tryIF in  process.''''all(type(mod) is str;^F_"raise TypeError('' must be astrings' f = 4>get_inherited_fds'''ReturntEfds 3 from parent_aThis r@s1 if8cur3A waslstarted by;kd.` `connect_to_new_H, fdQquestzPcreat~_child)s a pairY,(status_r, data_w). The callingI can readc l0's and (eventually) itfBcodev4tshould w`pickleeparation anDeensure_running(pif len(} + 4 >= MAXFDS_TO_SEND=DValutoo manyRwith .(.AF_UNIX) as clientc., _w = os.pipe* #r,/*0all:5= [4 #w,3,8mresource_ker.getfd()]0s +=N :try'[PreducP.send8=", I $2F/ wm[excep>26ra #w#D p0finCNchild_r)  os.close(child_w)  def ensure_running(self):"'''Make $ that a fork server is :.S5This can be called from any process. NoteSusually a }, will just reus5e started by its parent, soI )Rdo nothing.*5''' Pwith f._lockresource_tracker.dG.#ifI<@_pid?not None_5#was launch`efore,?Pit st ?xG pid, status = os.waitpid*._,!WNOHANG)K if2N pidk#]alive>"mreturns# dead, it agai(s>_fd+Pddres x 0Q_fd =1, - cmD!(' Smulti import main; ' +EF@ 'Q(%d, r, **%r)'& ypreload_modulesdesired_key{a_path', 'sys }data = spawn.get_preparation_('ignore' = {x: y x, y in .items()x ?elsAE^}qocket.s(.AF_UNIX) m~istener*a@`connec.arbitrary_#('Nl\c.bind(1outil.is_absm"t__namespaceB55hmoi~, 0o600p (LL# all clientes own the write end of"}" pipe;;Q# whe:yXqterminaae readLqbecomesycB_r, wr(?try&fds_to_pa[er.fileno()_-r]O%= (8, ,OS9exevexecutable()  args = [exe] + util._ _from_interpreter_flags() A2 += ['-c', cmd](Rpid =fspawnv_passfds(exe, G, fds_tonexcept:^os.close(alive_w>]raise@finallyYrYself._forkserver_addres\ r3f"4Qapid # def main(listen2d, Qr, preload,$_path=None, sys)v'''Run A.'''$ifJ*Y`if '__|d__' in"F ando is not v<@process.current_()._inheriting = Tru/tr`r.import( Cdel  for modname #__#_(@ ! IZErrorU}O _stdin()psig_r, w = os.pipeos.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, ?5 ^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:9selectors.EVENT_READ) while True::try-#rfds = [key.fileobj for (key, events) in selector. 9()]}L0if SVbreakif alive_rmC# EOF because no more client processes leftassert os.read(t, 1) == b'', "Not ati/?"Eraise SystemExit?sigGot SIGCHLDjM, 65536) # exhaus pa# ScanVchild<3`ppid, stPos.waitpid(-1,oWNOHANG)_except CP_ErrorKxO `if pid0G)"@_w =N_to_fd.pop(ONone4if >pis not 0 returncode =;J`status|@exitG(stsp# Send 2 3; to+O%write_signed(&, >BrokenPipe8#vanished 2Opass% os.close;els{a# This shouldn't happen really pwarning@rn('forkserver: ]Oed 'J  'unexpected` %d' % Dif listeneIncomingJk reque5ithW0.ac()[0] as s# Receive Cfrom(= reduction.recvfds(s, MAXFDS_TO_SEND + 1en(fds) >:v bRuntim(0 "Too many ({0:n}) fds to send".format( len(fds)))/child_r, w, *fds = fds5s.close(Wpid = osk(1if +O= 0:o0# C$ code = 1% ?tryj nlistener-selecto1runused_li[alive0sig/w] N .extend(pid_to_fd.values(B@_serve_one( r,,D >!old_handlerskrexcept E?ionBsys.6chook(*__info,0stderr.flushofinallzos._exit(Oelse a# Send^to client proces!write_signed& w,m\r BrokenPipeError 8#vanished/pa !t[pid] =Z o for fd in?]Ifd) 7!OS/O as if e.errno != .ECONNABORTEDraise def % u%, Pose unne[ary stuff and reset '%al:.set_wakeup_fd(-1Q9sig, val?t.items(){Gdignal(4F:na(_fork'r. _#fdresource_tracker._-*I`._inhe:)fT# Run object received over pipe parent_sentinel = os.dup(child_r)&code = spawn._main ,B!) 2preturn 9" # # Read and write signed numbers # def read_Q(fd):Ldata = b'' length = SIGNED_STRUCT.sizwhile len(90) < 2gthMsmC(fd, - 5,if not s> raise EOFError('unexpected'?Q += s bunpackx2[0] % 3, n =msg@nu6msgSnbyteX2msg2&6= 0;sRuntimeashouldget hereBmsg[{!:]_forkserver = ForkS () ensure_runnin,. get_inheK@d_fd/  connect_to_new_proces7%G set]_preload = .%(Module which supports allocation of memory from an mmap<Smultiing/heap.pyDCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. im bisect `collec#s defaultdict  $os%sy tempfile thBing g.contextdAreduv, assert_1.)util __all__ = ['BufferWrapper'" I3able classTwrapsw,`blocks can be!ed+ f sys.platform == 'win32':r_winapizArena(objectn1"""+ A shared area backed by anonymous (Windows).CO _r$= ._RandomNameSequence(__init__(self, f&~"for i in range(100>%0nam_'pym-%d-%s' % (os.getpid(), next.)AQbuf =8.2(-1P, tagb=83if .GetLast) hUbreakW# We have reopea preexist3buf.clos{JelsePFileEWs@'CanPfind  y1new self.name = ' self.buffer = bufP_stat=(-asize, N%) 2def __get1!__0%): wassert_spawning# "breturna{ bsb!, p i ( =W ~# Reopen existing mmap#Z3.3(-1v0tag =/ )F # XXX Temporarily preventbuildbot failures while determi:Mthe correct long-- fix. See issue 23060= _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]"Cinit", Wfd=-1-5izevyfd = fd0if J= -16#r is created anew (6!6, it means we'r)ImingeLqfrom re!_az) below.1fd,X! =@.mks(`6 fix='pym-%d-'%os.getpid(),32dirJp_choose(G)os.unlink(wutil.Finalize, os.close, O.fd,Zftruncat9( #0  G2elfJ C1# C a non-storage? diUif possibleV# to improve per5:anctfor d i ;@st =FZvfs(dxt.f_bavail * s fr1 >=H: # enough free space?* *@get_-creducea^_if a.iraise Value'uunpicklable because 'P'fork^`was en;`d when'F P, (a.?0, rtion.DupFd(a.fd)) def rebuild_arena(size, dupfd): return A#.detach()) ,reduction.register(4!, ee) # # Class allowing ca= of chunks memory from as # c=Heap(object):# Minimum m[c() alignment_B = 85(_DISCARD_FREE_SPACE_LARGER_THAN = 4 * 1024 ** 2 # 4 MBPDOUBLE_ARENA_SIZE_UNTIL5jr__init__(self, s=mmap.PAGEAz#._lastpid = os.ge !()~$ock = threading.Lock&# CurrentFp N! =# A sorted listavailable bl7Bs inds;engths = []T# FreA`manage~# - map eachhU to a`jstart, stop)`/_to_seq = {}i L)` tuplepJthe  jK! Pt tha12fse&B # en/ a +op3Map /ir  5useCQated_defaultdict(set 9LpO@to fS- see comP() belowC_# StatisticQ"n_m0YnS @sGqcmethodroundup(n, # must be a power2IV0mas5- 1P(n + )P) & ~ 2new PCreat~2newP withY@leas_e given **lXTelf._1maxl ._/:), E# We carve larger and  s, for efficiency, until w1# rPa:A-ish (roughly L3 cache-d2if # < 86*= util.info('7 a<R%d', # = v$s.append(arena)#  return (arena, 0, length) #def _discard_$q(self, !):%K# Possibly delete the given (unused)53i" =U.size# Reusing an exist  is faster than crea new one, soJwe only reclaim space if it's large enough.6#if0 < ._DISCARD_FREE_SPACE_LARGER_THAN  UMblocks =Jallocated_B.pop)3assert not %3delHstart_toG[C_, 0)]-.op,1s.removeX5seq0lenUBseq[K{4seqAB]N!if:seqCdl~mvk 9s a{ -- it might be much'rhi = bisect.Q_leftn"._1s, w4`f i ==h )4new6izeGJelseAvfgths[i]+Pq} ,"8p, stop)iO%]'1g&Tadd_free},0b# make available and try to me~with its neighbours inB &:try Bprev@lf._,except KeyErrorV5asstx5, _svabsorb(# Mnext)_e % =:Patop - %FV.append(uy Llength] = [bwlock] bisect.insort(self._lengths, %) 2 start_to_bP[(arena, Q)] =  5/op4'op34def _absorb,P!):# deregister this" so it can be merged with a neighbourE =op)Odel V1Rc = stop -EN0seq@Bseq[5seq.remove({)Aif not seq>B?lenW)qsebreturnK_allocated7LJ s X!s[C/(Z)(, +0# A is entirely free, discardtBfromuprocessE/_~C'T_pending#s$ Free all theAs in; list - call-e 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}) is not last pid {1:n}".format( os.getpid(),self._>Upid))0sif not ock.acquire(False):*a# can't $ the lock right now, addb!to {list ofMpending +s to free%)__.0.ap(Lelsebwe hol a:try0vnpis += 14#3ing((O1addQ( (,remove_allocated4ofinall.release() Qdef m[(nX, siz# return a3 of) (possibly rounded up!ifOJ < 0Xraise ValueError("Size {0:n} oue rangen psys.max1 <=ieOverflowhtoo lare 74 != asJ n>.__init__() M!0ialafter fork/Dwithf?ockc"n_ # #w Lbe marked availabl[npup(max(S, 1),alignment(arena, startDop) PK 6real_stop+:! +7[6if ( < / ?%A# if"ed$A is r than necessary,7 hGremainderU*   ; !s[Bs].add((GH"} o . # # Class wrappKpa Heap -- be inheritEy child pro:Q # cWpBufferW]er(object):| _hP=WF U9 = . .._state = (block, sizCe) .util.Finalize(self, BufferWrapper._heap.free, args=(block,)) Fdef create_memoryviewJ!):!j(arena, startop), size = vu._state1wreturn RB!.b!)[I:+G:] # # Module providing manager classes for dealing # with shared objects Gmultiprocessing/FAs.pygZCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = [ 'BaseM', 'SyncMBaseProxyuToken',<q!'SM91 ] `Import! i D sys Pthrea=dsignalTarray Tqueue 6tim 5ypeRos from os orgetpid tracebackformat_exc".connection;.context Aredu, get_spawning_popen, PSErrorA:Lpool. 1 kB trye! HAS_SHMEM = True except I)RFalseRegister some thingBpick !e_#(a_., (a.typecod.tobytes()) Cv#.rv(4: c0) _KPs = [ (getattr({}, name)())  in ('items','keyvalues')] if R[0] is not list: # only neededPQPy3.0ibuild_as_6C(obj @ 0, (!,&3[ sCy"'I, re)ATypeidentify)   3ect1'''Hto uniquely P* a.6__slots_o (' idMpaddress 7id'__init__", 2#, 0C, id%O2id,)id) = (FWQ__getwbiQsQ7ateXQRao__repr3'%s5=%r4 id=%r)' % \N>!__P__.__.#__Q<P ^d1Fun for communicaTtion with a manager's server process # def dispatch(c, id, methodname, args=(), kwds={}): ''' @Sendbessage tom using connec `c` and return response GOc.send((!))1Pkind,Dult = c.recv(0if  == '#RETURN'k1ultLPraisevert_to_error(Dc))?con$d ~_ERROR} $el1in ('#TRACEBACK', '#UNSERIALIZABLE')cif not isinstance(result, str(,QTypeE!"R<q {0!r}  '{1}') type is {2},rstr".format(IQ@@)% *SRemot'Unserializable m~: %s\n' %DOelseV5 1FValurecognized,T{!r}'!)) class PExcep__str__(self ('+ '-'*75 + 1str2.args[0])$) # # Funs for find th9thod names of an objectBall_Ss(objR`a list@I4Q`obj`)7temp = []8w in dirgfunc = getatt,"pif call (.m@.appWg9Sopublic2 which do/2art"'_4[ .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  _c.I.W zOSErrorXkcontino handle_request, args=(c,]t$t.1 V7, cIH a new connecM|,funcname$0sul0 = 7 l[.deliver_challenge(c,_d T:Oansw9kc.recvignore, a, kwds eassert22 in public, '%r unrecognized' %- It = getattvE):ionxmsg = ('#TRACEBACK', format_exc())  belse: :tryresult = func(c, *args, **kwds)Aexcept E>ionNmsg = ('#TRACEBACK', format_exc()Q ERETURN', < c.send(msg% O as L e iIpassJutil.info('Failure to message: %r', m: ... request was2 66ion85e) c.close( def serve_client(self, conn)5'''AdHandles from the proxies in a particularcess/threadHTdebug('st;"ng"r 7DQrvice G9*ing.current_h().namarecv =. N id_to_obj = #.[while not"stop_event.is_set():- `method2 = qENone$ 0 = (!vident, P", 7_ YQ obj, exposed, gettypeid = [u]T KeyErrorkb\t0`local_y: raise ke"'if$inDPLAttribute0('a %r ofbject ismo=%r' %H(Hw , U(obj)^H ot=%@attrM53resT(jiERROR', eje$0andI.getUaK!ifr/id rident, rexposed = self.create(conn, typeid, res) token = T(3Maddress, ridentDmsg = ('#PROXY', (!, `)<_else:VsRETURN' 0except AttributeErrorSif methodname is NonzvTRACEBACK', format_exc(>tryfallback_funcmapping[]Fresult = >S(04", ), obj, *args, **kwdsB \D/ulBE?ion2X Z/OFutil.debug('got EOF -- exiting thread servI%r',`/ing.current_0().x0@sys.lI(0) Y send(msg@('#UNSERIALIZABLEI ^ ZO as binfo('2oion inu ... message was  , 68e<~.close(2126defgetvalue()Z`returny G?strB,?obj?repH-IE = {"'__str__':'6str0'__O !"#GETVALUED>h}TdummyHGpass&J_+5'''ZR so,nfo --- useful to spot problems with refcounting ''3' # Perhaps include debug info about 'c'?0with self.mutex:Presult = []keys = list(<id_to_refcount. =())4j.sort(for ident in 9 #if"n!= '0'!%.append(' %s:4 P=%s\nY%s' %(,  [/],FH str'3obj>[0])[:75],return '\n'.join(!) ndef number_of_objectsaF, c)&''N0 of shared 7Q-# Doesn't use (len^.obj) - 1) as we should.6='0} HrshutdowoS' this process6tryQutil.('manager received  message'0c.s[('#RETURN', Nonejexceptrimport traceback.print_exckfinallpstop_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?2) +O Z:v = '%x' % id(obj)  # convert to string because xmlrpclib # only has 32 bit signed integersFutil.debug('%r callable retur6object with id %r', typeid, ident) Qself.id_to_obj[#] = (obj, set(exposed), metho+R)J"ifa not in Zrefcount:1%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_proxyTL /3 \.2 :,6( =DSpr re-end& INCREF P?elsraise ke!de#L T  Q !DEPskippY(u (if J<= 0Q5PAsserR(u* "Id {0!s} ({1!r}) has refcount {2:n}, not 1+".format( ident, self.id_to_obj[/],6/@refcy4)))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()s8jP ReQa<_forever() method and address attribute 5''' if self._state.value != SINITIAL:/B3=3zSTARTED37raise ProcessError("Already started server")p/elr HUTDOWNsManager has shut downr/seN "Unknownte {!r}".format(l)return S*registry,address,y %Uuthke4serializer) 8def connec)C## m2object to the" pXAListener, Client = l!_c[]I# =:" a=?Jdispatch(E, None, 'dummy'&= .c, initP=Zargs=()K{Spawn a5 for thiscM\(ifq is notgA and callable(/+BType'+ must be a J';# pipe over which we will retrieve , oVswriter = ion.Pipe(duplex=FalseusyErunsd\*=Cctx.(+target=typefr)._run_ i`o @o)",   q)DD"id':'.join(str(i)Ci in !._06ityB!xname = ___ + '-' + D? @) # get address of server writer.close()dself._7= reader.recv&=># register a finalizt]state.value = SuSTARTEDI*shutdown = util.FQ('+p, type( 4)._y_manager,0Qargs=+._process, :juthkey?s 0.zClient).exitpriority=0!) @classmethoddef _run_S(cls,W4ry,3, aii",  c init)a=None,1)):},5''' Create ae0verport its and run it7C# bpo-36368: protectO from KeyboardInterrupt signalsW.(.SIGINT,-C_IGN^!if is not (  (*-H2# cY = cls._S( ^inform parentcof the1'v~b.send(.$!un_*Vp#('ing at %r'Pm_forever(Fid, /, *p, **kwds new shared object; returQtokenexposed tuplePasser 1, 'r@yet started/0conN[=$;try4d, = dispatch(j,2, 'R@', (Rid,)+LJl`I KTGT]U, id)Ajoin, timeoutl2Joie (t has been spawned(#if>u'.Z f /is_alive(- *! =q_debug_P*ARPsome ,a aboutyssaection) '''  conn = self._Client( address, authkey= ) >Etry: return dispatch(c, None, 'debug_info'CkfinallG7.close() adef _number_of_objects)1'''.RBthe 8 of shared ?,8|Y$_enter__#ifstate.value == SvINITIALC;fstart(H!HzSTARTEDH3{ raise ProcessError("Unable to server"9/elr SHUTDOWN:sManager has shut downr/seNkn"Unknownte {!r}".forma)fS_exit, exc_type 2val 'tb/A.j@ticmethod|Rize_m"(p,, -,#, Tqh@Shutx U U; will be registeTas a rIT$ifB.is_alive(/Putil.('sendingamessagf= 1(=D5N? 1 EMexcept E>ionBpassb4.join(timeout=1.0Qp0 st ifFattr'terminate'cg0tryEto `7D()` {I.; ( %:0.1%.-/5u after '@ state.value = State.SHUTDOWN Etry: del BaseProxy._address_to_local[]5except KeyErrorNQpass +@propertyCdef Jf(self)7preturn CclassmethodFregister(cls, typeid, callable=None, prexposedKc4i( create_W=True5'''IR# a with the manager0<Rif '_ry' not in cls.__dict__+0" =*r.copy()?.&if @ is  P+q = AutoA:4 = or getattr(<C, '_ 1_',fA_= = Eor \  s F|-ifl for key, value|\list([ .items()): # isinstance?aassertP(key)vstr, '%r a string' %|D F& %[Y] = (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 cleafter a fork # /ProcessLsSet(set|__init__]1er_Z_X(, lambda:.(XnreduceZ$M0), 0Def( ''' A base for proxies of shared objects '''_address_to_local = {}mutex = util.ForkAwareThreadLock() )$def __init__(self, token, serializer, manager=None,8rauthkey exposedincref=TrueH_owned=False):Pwith BaseProxy._otls_idset =* Q.get(. , )lM6if P!is" o&# 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@ det 9is |L0ands value appropriatelyyM_by_3if ?not+T'=P.Auth casString('(Celif7?is jz7#._\Jelse1( cb"_p3().$ RZu~0regr_after_forkj/)Wdebug('mak$toZ'aOname !4.Ding.@0().+ != 'MainS'"+= '|' + 9Ke conn = self._Client( token.address, authkey=3) dispatch(conn, None, 'accept_ection', (name,);RFtls.(0 =  `def _callmethod", M args=(), kwds={}):95''' pTry to K# aA of the referent and return a copy"EsultMY6tryrvW A ex AttributeErrorGutil.debug('thread %r does not ow$nn^]=ping.cur_0().B4Ject(}%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"._ +!._H 5 4tls3Tidset )9 exitpriority=10 !) @staticmethod def _decref(token, authkey, - e, tls, idset, _Client):=a.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&dconn =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^bif not and hasattr( ''0 %r>{proxies so1ing%',}HGping.cur_z().nameFtls..A(#0del'after_fork(self#._)! = -.!inUxy may just beaWQwhichXY;binfo(':% %_reduce__kwds = {}\if get_spawning_popen()0 eC#['R'] = zZd", '_isauto', False0YwexposedY_-return (RebuildProxypR(Auto , serializer, vvBtype~jw deepcopyg, memo/WQ._getE(CCrepr?9C'<%s3 , idat %#x>' % \j('0.__)__.! idU' /st5'''gR@esenon of the referent (or a fall-back if that fails) 5''' Etry: return self._callmethod('__repr__'Iexcept E?ionJ6(O)[:-1] + "; '__str__()'Jed>" # # Function used for unpickling # def RebuildProxy(func, token, serializer, kwds)] pO objects.8 server = getattr(process.curz_(), '_manager_6r', None6 ifL3and .address == util.debug('$ awned by w C=%r' {Hckwds[') _o:'] = True%6oken.id not i.id_to_localfxy_obj=*[ ids\p7 ;6obj/+incref = (2b.pop('!',U) and%inheriting', FalsjCr(,q=@, **)s to create0ies ty typesAMakeType(name, exposed, _cache={})RQr whose s are given4`Q`/E = tuple( 2[!)]U%KeyErrorTQpass #dic = {}yz5exec('''!%sX, /, *argst0 B%r, 3p''' % (w,*r), dic)B(Bas,/.#._4_ =/5 = <(AAuto=t, authkeyT = SnN"o-'` ;@_Cli= listener_c%[sB][1]Y$if1 is'sconn = Q  = dispatch([p, 'get_bods', h&,)Qkfinall&Bs.close($ ifm$ =#._S ;hkey = proce#ss.current_process().authkey ProxyType = Makea('Auto[%s]' % token.typeid, exposed)GpG& =O(-, serializer, manager=#, =,K rincref=p._isauto = True>qreturn ` # # s/callables which we will register with SyncM # class Namespace(object):j def __init__(self, /, **kwds#.__dict__.update($FCreprF;items = listbH"() gtemp = []Vfor name, value in 6"aif not)p.starts G('_')e.append('%s=%r(f f.sort(q'%s(%s)= kP__.__N__, ', '.join(w$))V4codp, lock='|+4 = E"A=I"geQ6.s.5. d/__iIr, %r)'%(()G^ =3perty(get@t) QArray\AnquenceSa1.7)Yps used by~Iterator1B(Bas@__ = ('__next__;@sendPthrow bclose'___itev(Y^h, *arg3 ._jimethod3QM4:', IJ5 K!K5KAcquirea,Yreleab1ing, timeout=None!.T,) if-@ is 0u else ($  G-QH0 /en a__exit__(self, exc_type 2val ctb): 4return self._callmethod('release') class ConditionProxy(AcquirerPR_exposed_ = ('a"5', Np, 'waitfnotify a_all')@def '(, timeout=Nonei;C', (8&,)VuX?n=1O4QnKOJ3 A_forF, predicatefsult =+(Pif re ,d$if\ is not c :0endH! =+.monotonic() +5outQOelse?[)~[ Qwhile Q4if  ^0- 6iyJ<= 0|"Ybreak<.(?2 oREventkABase e gQis_seSPclearYj)hI/@?set=<.x=;0out`bBarrie(b __getattribute__\q, 'abor}*re{7JoW.J>.>@propertypartiesNE#('E'g n_I?ingi+Gkobrokenh+DeiNamespack _zS__delc_attr__(self, key):  if[0] == '_'!return object.__getattribute__(self,@)Pcallmethod =8 &'_-'Bt,('y', (key,)6rdef __s, value&SM{0del&LMt)) class VProxy(Base  _exposed_ = ('get', 'setD1get2.yAVs:;A{1, (k  = property(get, set) V!__QPitem_<(types.GenericAlias AListb = MakiType('Tk'__add__&__contains2del8get0len)H0mul '__reverXrsE:`appendbAcoun3extPindexQinser0popremove',Er"so(2__iw"#))<#;  1__i%  Y`` I b_ DicDiter p 'clear@copy>s@keys0popsetdefaul`update8!s'I&))"._@_to_i{(3'__: 'Iterator} Array33 {wOPoolcbAappl5 `_asyncAclos1ima_unordereACjoin'%6mapCCstar _async', 'termi#nate', )) BasePoolProxy._method_to_typeid_ = {,'apply_async': 'A cResultNO'map Ostar$ @imap_Iterator\_unordered"} class (!):&def __enter__(selfpreturn -3xit,Q, exc 2val 'tbG@`.termij() # # Definition of SyncManager # ![1'''2Sub@of `' ` which supports a numberpshared object 1s. O2Thep regist^ are those intended for the phronizaD of threads, plus `dict`, `list` and `Namespace`z`multiprocessing.()` funcc creates ?ted instances ofQthis .+ N.('Queue', q.)+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 "Ys one or more mz segments."7LTname,-_Cs=[]84 self.shar ed_memory_context_name = ' self.segmen%Is =  0def register_$(A,2%):2i "Adds the supplied shared a block to tracker."Eutil.debug(f"Rv# {!r} in pid {getpid()}")O .append(J)destroy""Calls unlink() on Bwith& and removes it from2rlist ofIss beingHOd.""JDI: I ch!.SM?|.close(.q   4allMs4forOr o:[:]&' .L q__del__ 0$lf.__class__._RC__}.G1 @ getstateqreturn . D  jsj!, x G__init__(*#  jrServer("):'public = .9+ \K+1 ['', 'release6s']kY, *args, **kw 4 baddres3lf. #c# The QLinux abstspaces can be bytesDif isinstance(L,) :! = os.fsdecode7 $ @/ =_TU(f"shm_{v/}_ @Jzx~rted byiacreate, c, typeid, / A"""C< a new distributed-F object (not backed by a shgared 2memory block) and return its id to be used in a Proxy Object.""" L # Unless set up as a shu p9, don't make__context#?tandard part of kwargs. ThisJs things easier for supplyingQsimple functions. if hasattr(self.registry[typeid][-1], "_9"):K*['/Q'] = f MServer.createR, c, 0, *B, **x%) Ddef shutdown8 "Call unlink() on stracked , terminate the .e, _segment#, \_name0Add(ei :1's j?er.3'er wrelease+!lf "sFAwith xmoves it from2 instance *id"wdestroyDlist(s 1""Ra1s  !at is currently=ing"s qclass SMmManager(Base """Like Sync@ but G@tead.xT Itwvides methodsA7ingXs**[> { -lo! (DableList) b?#byBMJ. It alsoQthat le -ort synchronizap acrossbcesses (i.e. multi-proU-safesvsemaphores)+,_w) =__init__  @`if os. == "posix"## bpo-36867: Ensurresource_tracker is running before # launch#the manager process, so that concurrentDshared_memoryDipulation both in ]3andLf does not create two resource_trackerG=es.from . importL m.ensure_runZ)()aRBaseME .__init__(self, *args, **kw 8util.debug(f"{1.__class__.__name__}d by pid {getpid()}") def __del{%):k.BkGJpass|get_server p'BetterWn monkeypatfor now; merge into SJ ultimately'2if .state.value != SzINITIAL7=7~STARTED7;rraise 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', (sms.,!Cpexcept `E ^Oas erKkunlinkL mrableList_quenc%<&!po#&ed0sUinput set7  with self._Client( address, authkey=) as conn: sl = shared_memory.SpableLis`}quence);>tryP_dispatch(s, None, 'track_segment', (sl.shm.name,)_except BaseE 0ioneuN~unlink(Oyraise e*return sl # # Module providing the `Pool` class for managa*cess pooBmultipro@ing/1.py^TCopyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = ['', 'Thread!] }pImports1i collections itertoolo Tqueue(t_5ing&imraceback5ypeHwarnings # If J is avail{x&n should b ed. Therefore # we avoi7p-level s which are li]o fail on some systems. from .9[ util get_context, TimeoutError(SEBwaitConstants representDbstate of aI INIT = "P" RUN RUN" CLOSE " TERMINAT "uMiscellaneoujob_counter = .() def mapstar(args)p(lQmap(*0-4 j-]P[0], JR[1]))@Hackembed stringifica%premote Qg in localR-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 run by workereMaybeEnco p"""Wrapssible unpickleBePs, sory can bYpsafely @ough$ socket.""" nWvalueUself.exc = repr(exc) self.value = r ! uper(MaybeEncodingError, ;).__init__(B.excT!) idef __str'!):return "T@ sena result: '%s'. ReasonB" % k,IM <%s: %s>__class__.__name__@) worker(inqueue, out :ializer=None, args=(), maxtaskswrap_exception=FalseUDif (9 is not \Q) and(isinstance*ztI JdC>= 1|7raise Asser3("MT {!r}valid".format)Uput =,A.put geL2.geif hasattg'_writer'8r.close(q._reader!|!if]! (* _completed = 0RUwhileRN7 orm:<.6try7g = get0Q (EOFA, OS J=util.debug('T got 79 -- exiting'EDRbreak1if !is psentinelejob, i, func, x, kwds =}q .n` = (TrA"(*A **C>FE}Z as e:if {V_helper_re/s Jq5 = nWithTraceback(e, e.__t*__"6, e Tput((D:p.T6[1]"Possible ek el ( !%sN (+)Q= job! =V! =W$ =XA+= 1K0 after %dUs' % @)8%3(ex'Pickle-a5U{ for use by _guarded<_task_generation.' raise ex # # Class representing a process pool # c%_PoolCache(dict):O1"""Ithat implements a c1 for the C! cO+will notifyF$pool managE threads every timeKYis emptied. TheEP!ic is done by6use of a queuIsvided whenEinstantiaq. def __init__(self, /, *args,ier=None, **kwds60.Eer =0b!uuper().bYJ )udelitem kJ)#Dm1# N @ay_ isPimporP becaQtyHkeeps maintainWworkers untilQ gets drain!isLeliminateKrace condi in which a finished afterL's _handle_method has en:another it=5 loop. In this situq,@only"ntPcan wake up !isTto be (no mores available)' if< PbP.put(#) Pool(obje"''$^0sups an async versionPapply@funcs to argu.V_wrap_excep+r = Truer@static6PE(ctxWreturn ctx.0) #esUializA=(),W0maxzsperchildGqcontext# AttribuYkpd early8m" suHthey exist iz# __del__() i)d _w[ = []}e = INITj4Pctx =w0 or_,()IQetup_\s," =!.S+Q.# _change_";%toO  M_!._l)5) re"a  |E_/@vari=runf Y = ._7 = $=self._change_notifier)  self._maxtasksperchild =  2initializer = (Cargs%  #if processes is None:= os.cpu_count() or 1, J:< 1F raise ValueError("Number omust be at least 1")1notP and callable())3Typ'+  J' :tryp5repopulate_pool(except E:ion>for p in G< !{.exitcode'p.terminatejkp.join:sentinelqEget_(Qworker_handlthreading.T (^target=Pool.5_C)s,)"=(ccache,FiEqueu3ctxP  Iv <1 )inW2out N|Dis Rwrap_O0ion@ dochange2Sar.daemon = True+_state = RUN* Pstart 'z? = Aquick_put+Dpool.^AOsM )K (I{dresultwJ"CL* K%geKe +! *# = util.FinU uP3xtqueue, self._inqueue, self._outq}pool, .change_notifierEworker_handlEtaskSeresult(jcache)exitpriority=15R)state = RUN # Copy globals as function locto make sure that they are availableK during Python shutdown when5 Pool is destroyed.9def __del__(, _warn=Pings. ,a=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 #/Lutil.debug('$up6z%d' % i8.(JAed =O u=del:repopulate 8#Y ,4!ic3S._ctx:Pbv= self ._pool, self._inqueue, ;2out<KitializerO!initargs<!maxtasksperchildD!wrap_exception) @staticmethoddef _repopulateM_&(ctx, Process, p e rlZT "  :"""Bring the number of $a up to#specified-kfor use after reapW workers which have exited. Ei in range(Dp - len(&))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_put2=._writer.sen3f5&ge5x._reader.recvcheck_running#ife != RUN7raise ValueError("2Pool not running") def apply(self, func, args=(), kwds={}): -1'''9 Equivalent of `< (*<@, **;5)`.-Ptmust be.Wpreturn .p_async(`g).get(9map iterable, chunksize=None)A` 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, callbackCierror_!hronous version` @, *,  _guarded_task_generationCL_jobQ Provides a D orVs for imap) _unorderep%thappropriate handl>5s which throw exceps duringI.6trye,ei = -16n, x in enum!e(P(bl-xyield (*i-(x,), {})c$ E_eQ+1, _helper_reraises_Ltion, (eijAh 1= E`-- canMUCH slowerMn `Pool.(.G}._check_(&ifZ == 1^ = IMapI 1torCevqueue.put(!;. 2set_leng G)) return resultUelse:/if chunksize < 1"raise ValueError(@"%"CFmust be 1+, not {0:n}".format>B task_batches = Pool._get_s(func, iterable,   = IMapI.tor(self(.[queue.pu;qguardedC_generation(o._job,Bmapstar;!(A)Aset_length `(item forx$ is"in!) Tdef imap_unordered/, 6=1)1'''G*`Like `M()` method but Ycing ofs is arbitrary.COcheck_running( ),==*B`Uim U=M^d&!r^EXvNapply_asyncKargs=(), kwds={}, callback=None e_!vAihronous versioni`e!Q@ = AR&, back) 8 self._taskqueue.put(([(result._job, 0, func, args, kwds)], None)) rreturn : def map_async(kJiterable, chunksize=P, callbackG_ error_!%):"5''' Aqhronous version of `map()` method.0<&._wmapstar,Y )^nXmappec$3aHelpertto implement , map and their  counterpartsD._check_running()if not hasattr(T'__len__'B"u = list2L#fJ1 is"i, extra = divmod(lenS , pool) * 4J"ifB `dX += 1Uj) == 0>:2= 0#Q_batches = Pool._get,s(Fq = MapR, =I`O(3qguardedp_genera  ;?O6)k R Tr@staticA. _wait_for_updates(sentinelsjange_notifiqtimeout3D8'Qwhile)ch[w.empty(T %Cget(l@classhandle_workers(c`ache, V, ctx, Process, p .eskC, in@3out initializ ]8 0maxsperchild, wrap_excepl&, }E 3thread = ing.current_=# Keep maintai1 7` until c< gets drained, unless#terminatewhile thread._state == RUN or (cache and thread#!= TERMINATE): cls._maintain_pool(ctx, Process, p e ool, inqueue,GR 2out) initializer?oitargs@maxtasksperchild, wrap_exception) current_sentinels = [*get_worker(E), *0]Pwait_for_updates(f, change_notifier)`# send to stop s(*.put(NoneDutil.debug('8 handler exiting'@icmethod\Rdef _._d s(jv, put, !, @!F# =ODing.(}@for aseq, set_length in iter}a.get, >! =V:try)#Vaw cannot failA0i>seqU)#if>?RUN-1Z?fouFRUN'B]break";}Y5$ E<_ as ejob, idxask[:2]y !U [job]._set(idx, (False, e)9KeyError-6pasR?els'ifZWdoing6/()=01] S@ask ? -1L6&O + 1 co-ueI=ofinall@-seq = job} B`Ur got # tell result+to finish when is emptym elp f w jwps thereqno more 1W p { put(None)  except OSError:  util.debug('task handler go2 when sendingtinels') KGtexiting,@staticmethod>Rdef _u_results(outqueue, get, cache)thread = ing.current_(vwhile 1>:try=s!()@(AQ, EOFK(  R:/LF -- #Afreturnf#if ._Le != RUNkassert-== TERMINATE, "TJfnot in"vZfoundg=d'JK^break}~is None1sennjob, i, objD9ask[job]._set(? '1KeyJpassks= job =}, afi n !PignorUextra co2)ueif hasattr- '_;er'>Aensu#Tthat i@ is Kfull.# If we don't make room available:HIthenT# attempts to ad*e ()C;mayBblock. Thereguaranteed:be no more than 2_)s.JPfor irange(10=!if".lo.poll(48 ?geti(M'result hand!ler exiting: len(cache)=%s, thread._state=%s', 0 -!) *@:icmethoddef _get_tasks(func, it, size):$cit = iter(it)vwhile 1'+x = tuple(0tools.islicYC2if not xHereturnpcyield x_reduce__(self raise NotImplementedError(Z 'pool objects canbe passed between processes or pickled'K\closeutil.debug('!@ing ~'0if z == RUN$ i CLOSE worker_handlerP0 change_notifier.put(Noneterminat %e = TERMINAT A'e({OjoinN rN(RValue "Pis still running"+elW1Ain (,jIn unknown e  ($"oresult$f3 inx p#p.VfO help_stuff_finish(inqueue,  a# may be blocked try`to putcms on [ZXQremov5T from0a untilq  (ed0._rp.acquirk.is_alive() andq ._MKoll($Grecvitime.sleep(0 l@class4_0(cl93askkS, out(+,  [   a",  his is guaranteQo onlcalled oncepfinaliz' #ify that the Y` has b@d so-n## _?`s loop$un(0ed)4order toI@send\[@atio]ntinel allworkers.  worker_handler._state = TERMINATE & change_notifier.put(None) #OtaskK )util.debug('helping = /s to finish')=Pcls._6r_stuff_!(inqueue,I, len(pool)if (not result,.is_alive()) and (<cache) != 0):raise AssertionError("&@"CanlQhave MX with|0er "|" "1out # sentinel# We must wait for the exit before terminating#4s because we don'Z%ntPto betarted behind our back.QD@joinD 4if threading.current_Q() is>  .q(3# Ts which  aly&ed0if sqhasattrd[0], 'L+e'%sAp ink .@code'+$p.ne< H>  V?ool)K"!2 ha @yet %edqgAclea~#up %d' % p.pid<p,def __enter__(self._check_runj(Upreturn %L3xitK, exc_type 2val ,tbf # # Clasose instances are rx y `Pool.apply_async()` # c>ARj(object):'in`, call0, eU_ _/! = ._event =Event() self._job = next(job_counter) s&cache = pool._ "llback = ca "derror_: =  .d[~pjob] =  'def ready(!):areturn*._event.is_set():successful?bif not?`\`aise ValueEq("{0!r}61".formatZG 2wai2, timeout=None}.(/geD =Tt"if1_Z v99Kelse-_,-, i, obj,@ =+E3and0? q!._ZU  [N_ 8e*3del 3=0 = Yz__class_getitem__ method(types.GenericAlias) AsyncResult = Apply # create a1 -- see #17805 # # Cc whose instances are red by `PkPmap_arq()` # B Mapt("):-q_init__L,, chunksize, length,,\b/._W,o   =Mu = TrueY@ = [3] * &$&if_ <= 0number_lef0=b S u&//r+ bool(& %  ,M!_rqE-= 18", 99J)W>X2[i*)l:(i+1)pbt 0  +callback:  self._callback(yvalue) )r del !bcache[ Mjob]+event.set(M"pool = NoneDUelse:if not success and .2 # only store first exception[-Lv = Fals"& = resultK#ifnumber_left == 0consider theR ready once all jobs are d#sUerrorq- *j # # Class whose instancereturned by `Pool.imap()` # c7IMapIterator(object): def __init__ , m)! =8*cond = thing.CondiB(fLock()Ujob = next(job_counter&F|&chvHitems = collec{ws.dequeQ*ndex = 0llengthc4punsorte+{}8! = \3ter\V - u, timeout=7Awith5 ._x:try ._ Ps.popu) I"E(Li%"._>0W"?Braise Stoion from.Tc.wait(-9) -'f8" *&2TMW$, S 4- __#__ W# XXX3 , i, objiyY `append; self._index += 1 hwhile '#inunsorted:5D[obj =*W.pop(L):!tems.append(obj, Mcond.notify(INelse6[i] = obj #if?=nlengthU3del1bcache[eIjob]W=pool = Nonezdef _set_cK", )qDwithj+on[4# == Rc+8# # Class whose instances are returned by `Pool.imap_unordered()` # clATIMapUIterator( *):mf i,fi 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  lb6tryf?Trusvq(block=Yt,KEmpt]Epass{for i in range(size): inqueue.put(None) 0def _wait_for_updates(self, sentinels, change_notifier, timeoutep.sleep(  import os signal from . 8util __all__ = ['Popen'] # # Start child process using fork # class 5s(objectmethod = '+'s_init__WC_obj:;._flush_std_streams();").returncode = \ finalizer_launch(duplicate'fd6 fd:Dpoll+lag=os.WNOHANG8pidAstatus_to_exitF(sts4 vGDc= $if@ is KISmultiing.connection C!ifY!([4]^  W # This shouldn't block if f") 9`ed suc ifully.D#eoI0.0 else 0b_send_7sigV*Sos.kiH] GP oLookupROpass<m)P=0.1)EAVraiseterminate $ A.SIGTERM?GKILL?Xr,7 E = 1"parent_rRild_wGpipe%/&yCCgi0Voos.close(vr os.close(parent_w) code = process_obj._bootstrap(8sentinel=child_rGfinally:\os._exit(e4Jelse-os.close(`  ~Qself.izer = util.F@ize(,c]_fds, 3r, 6w,)+d.$Mn!r hAdef {)1if :is not Non! (() 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(!+trUPdump(V, buf8l + -~ )>`X, w =connect_to_new_ # Keep a  of the wpipe's w end as am+M!byPI.4_3_wos.dup(#^?({%lfC_Pwith (w, 'wb',Lfd=True)f!f..(buf.getbuffecr()) self.pid = forkserver.read_signed("sentinel) :def poll, flag=os.WNOHANG):%b1if @returncode is None$(from multiprocessing.connection import wait\8timeout = 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 Aos DtextAredu, set_spawning_popen3,_ 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]Puuper().D>cduplicate_=, fJe.Vnd(fd<7zK{gresource_tracker_ &v.getfd(?%prep_data = G_0ara(f._nameBfp = io.BytesIO P; `.dump(F, fp7Z * ,0fink=(6"parent_r =%_w 9 )'r,Gwos.pipe)rpC_r, 3\*m5command_line(= ,j _handle= yVextend([child_r, chilwd_w]) self.pid = util.spawnv_passfds(.get_executable(),CN Qcmd, gO_fds~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.append(fd$IDizerF@ize(,s(, Y/) child_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-_handles(* QU s%  .CHC(%_# # 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 pipe will be duplicated byN<# -- seep_main()6py.+  bpo-33929: Previously,has "stolen"P it leaked a V1 if\  had beenHbterminPeforeMcould stealFTxWr)2, w 5 = reatePipe(?6, 0 wfU.B_osfB(whandle, 0)  cmd = spawn.get_command_line(parent_pid=osppid(), 9pipe_handle=r):w ' '.join('"%s"' % x for x in%) 1python_exeexecutable(- # bpo-35797: When runningXa venv, we bypass the redirectq"# \ or and launch our base P./if WINENV._path_eq(b, sys.T%):<K)@ys._g .env = os.environ.copy(_R env["__PYVENV_LAUNCHER__"]b\JelsejFNonewith open(wfd, 'wb', closefd=True) as to_childP# start processz:try-hp, ht, pid, ti_winapi.CreatePJ(K:W,Q", False, 0, % ]\H:(ht(nexcept< %eGrais # 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=i.e!is$I3if BE $msecs = |INFINITE;Rmax(0io* 1000 + 0.5u(repWaitForSingleObject(7`.1), _1if KWAIT_OBJECT_0).GetExitCodeProcess(self._handle) if code == TERMINATE:&5' -signal.SIG1 +self.return2 ( ' def poll()4wait(timeout=0)9terminate>,ifn is Noneb:try_winapi.T^Process(inti[,A gexcept OSErrorc O1.0)Rraiseukill = NMclos^.finalizer() # # Module providing the `` class which emulates `threa.!.T `Kbmultip(Cing/ 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'''/R4 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=y, target Cname args=(), kw ){}y *, daemon5assert group is None, 'group argument must be None for now' count = next(_process_5er)' self._identity = _current31+ (@,?oconfig=l.copy(7"paiid = os.getpid'Onamec qpopen = Pclosep[FalsePtarge5 args = tuple( kw = dict( $or type(@).____ + '-' + \':'.join(str(i)Pi in Gyif daemon is not:];%=.!_dangling.add def _check_W[#ifraise ValueError("p object8&")p self._popen.kill() def join(self, timeout=None):"&5''' Wait until child process terminates,8a._check_closed())rassert $parent_pid == os.getpid(), 'can only* a Popen is not HestarteJTres =Ic.wait()0if +f?C_-ren.discardris_alive=DReturn whetherz1is ;O4Tx!ifB_curxrzETruef eNtestQ0._piRFalseKcode!po$D+!isa Jelse&e4n Cb the P object.This method releasesources held byDf It ian error to call t[!ifCmstill running.v} H (.Wraise ValueEP("CanZV% apwhile i % "R"You should first) ) .F()."Mp. ! = 1del._sentinelx ~xAd = A@property=nammF!t@ ~.setter@ , /isinstance(!P, str must be a6ingr}! =Z Rdaemo}0 >7 `config"('41', @ ,m/ic?Set8e.o74, 'has already starteCd'  self._config['daemon'] = 1ic +@propertydef authkey(A!):Spreturn W,#']Mq.setter< S,a\&''1Set" orization key of processU5 = AuthenticLsString() exitcodesR+ , or `None` if it has yet to stop heck_closed())#ifypopen is _ (?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#(" not started") fromZ8__repr__Lut=1 '!status = '#elF. :9"pagid != LunknownMxinitialA 5 ?5if -!iso-'pel5'info = [typ}.__name__, ' c=%r' %]e.append('pid=%sS<}6nfo0 3O_pid4_4= _ 1_to (, exitcode)   info.append('exitcode=%s' % $) 0if self.daemon: J!':return '<%s>\' '.join(7!) J"##def _bootstrap(r, parent_sentinel=None) from . import util, context\global _curLprocess, _]_counter, _childrenO6try_start_method is not /3y._force9.O<_ = itertools.+(12z = set(5`._clos;din 4olds- =Ff cp*lf$ uSPP|(.V .Rname,=pid( if threading._HAVE_THREAD_NATIVE_ID2Rmain_()._set_native_id- b finalizer_registry.clearB1run_after&Kkers*Ql?# delay !ization oce old A object until j |?# _executed30delf4  !('rcallingWrun()EY. f0I = 06_8P_func5qexcept SystemExit as e6Pif e.I _" elif isinstance(IW, intG) ;els4sys.stderr.write(strg{) + '\ns5i1d  )BtracebackF '` %s:\n2 P.print_exc|shutdow$Ewith0 %d E_flush_std_stream@& # # We subclass bytes to avoid accidental transmiss auth keys over network # JAuthenticationString(bytes): def __reduce__(selffrom .context import get_spawning_popenJ0/if() is Nones)raise TypeError(F 'Pickling an Authenticatip object_'>disallowed for security reasons2)D_returt", @+,) # # Create`represng the parent process # class _PPS(Base 1): Cinit, name, pid, d'el@._id~fty = (@! =GclPpid =Z _ ! = PcloseV[False% = "config = {}is_aliveVSmultii0ing0nec5Ewaitg@not "([ ], timeout=0)@propertyDm YO2pid=/Ajoin.\T&''Wait untilF terminates9!   OmainCMain(]'e[??'authkey':(os.urandom(32)),'semprefix': '/mp'},# Note that some versions of FreeBSD only d>semaphores to have#? 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)@_cur_G = _4() _counter = itertools.(1) _childrenGrt() delKProcess # # Give names to some return codes # _exit@_to_+ = {} for:, signum in list( al.__dict__.items()): if6[:3]=='SIG' and '_' notEd,0  [-aum] = f'-{/}' # For debugR'leak testing _dangling = WeakSet() # # Module implemen.Q queu# multiprocessing/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.4BconnQ text _ForkingPickler = conQ.redu.#cDutilg, info, Finalize, register_affork, iss-a  u a 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, .Dwrit.Pipe(duplex=False5Prlocktx.Lock(!opid = os.getpid! if .platform == 'win32'IjwjENoneOelse- c3sem BodSemaphore(6`use bycurrent.futuresignore_e1 = 6 #1res !  .$)getstateassert_spawningVo(._=5Z,1C9 4sem G s!, 6" =Ahdebug('Queue._after_fork()') self._reset(#q=True) &Cdef !-', 'qFalse):(Q'if<._notempty._at_reinit(Oelse;  = threading.Condition(fLock()Qzbuffer = collec4ws.deque|+Ku = NoneOjoin cancelled = " DOclos |send_bytes = vwriter. kKrecv3;6er. 3Epoll`-@put(, obj, block2, timeout=: 1"._  raise ValueError(f"Queue {4r!r} is 9"cif notsem.acquire(lBFullCwithH #if!is %J._start_,\!.append(obj%.notify($ge{ayD and [r& r7hreleas/"ifmdeadlineCime.monotonic() + fh<lE T>tryKW5 = - e6 (L , .elRKG pS>em. ofinallQ9;# unserialize the data having 6dareturn _ForkingPickler.loads(resQqsize.&0# RGtImplemented on Mac OSX because of broken sem_getv-%0maxu - self._sem._semlock._get_value() def empty(self):return not h._poll6Ofull51Usem._zxis_zeroBonowaitH get(FalseGput_:^, objput(obj, D\closey3_d = True6try#-qreader.4%().kfinall2%# =R1R1if  hlf = Non`pjoin_th debug('Queue.(&)'Tasser^Ad, "4a {0!r}s".forma#ifd pcancel_/j)/le.;except AttributeErrorFpassmo_start *W0# SF  which transfers data from buffer to pip3 g.clear[=dRing.TKuqtarget=y._feed, Qargs=~"._p,1notysend_bytesBf 4w1Dwrityignore_eG@on_q@er_eCJsem);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 [* %10@staticmetho_q1izet(twr): debug('joining queue thread') v = twr(#if+ is not None:6=:.`9z9...v +e};elsU; al2y d@staticmethod def _finalize_close(buffer,fempty)mLtell" to quit*EwithFEd.append(_sentinelO%1not.notify() =eed , send_bytes, writelock, , ignore_epipe,^yonerror,N_sem Pstart feed data Xnacquire =.}ynreleas$$HwaitEpbpoplef!h"p5 = | if sys.platform != 'win32'w& =Y Kw )v`LPjhile 1:try*p o0 if :S#nsXMl58wMdobj = [)0if , isp4$er5got?p -- exi; o0freturna# seriB thedrbefore  e YC  = _ForkingPickler.dumps(obj15if /is){Y BxB DH, !except IndexEQuIpass8E?{ion as ~)if and getattr(e, 'errno', 0) == b.EPIPE return +# Since this runs in a daemon thread the resources it usesK may be become unusable whilb e process is cleaning up.KWe ignore errorsEch happen afterR/hastarted toplif is_exiting():/ainfo('!@queu: %s', e)9rwOelsej e object has not been sent, we need#pdecrease size of>AC. Thgo acts K2# i6dilently removed from` anYpis step ne0ary`have a1perly workingL_sem.rel(!on0(e,w!) M@staticmetho`def _on_Wyfeeder_:1"""F=Private API hook called when G Ddatabackgrou&hKraises an exception. For overridKby concurrent.futuresiimport tracevi.print_exc() _`inel =,0ecta# # A A typch also supds join() ask_done() a s D0Not atoayou do1' t5for each finish0askxn # eventually counter's semaphZ3flow caus9Bad Things <r. # class JoinQ("):/_init__(self, maxq=0, *, ctxa</._1,=0QD._un_ 0s =V$.S&(02Ccond&PCondi10gete )1 + ._e", q Mlsl!, zsl)_[:-2]}" =bV[-2:]1put , block=True, timeout=None#iffclosedHp ValueE1(f" {0!r}9"!if#.acquire(lBFullCwithnotempty, self._conGd: if self._thread is None%0&Sstart,)()J!buffer.append(obj% unfinished_tasks.releaseRnotempty.notify() w@def =`_done(})Cwith>con3not acquire(FalseSraise ValueError(' ) called too many times's |_semlock._is_zero( ._H_allOjoin8@wait# # Simplified Queue type -- really just a ed pipe # class<e7HVect):__init__, *, ctx.&3er,writer = connection.Pipe(duplex=^C4wtx.Lock!cpoll =cq.Hys.platform == 'win32'pwpC;els|-c4Mclos7"&.Pogvreturn P__getstate=context.assert_spawningdxFc"._ r; ,:__s!, c#G ](1getr !0) uR h 2 gzl;specific def1ion?if c}# Windows+EDupHduplicatTsteal]:r_winapik18(>, target_\9, inheriq=False,Vr*, source=8D'''D2 a rJ. (t5 is not a pid!)recurren3 = R.GetCPn kmY Q+if/P += PDuplicateHandlGe( source_process, handle, target 40, inheritab,_winapi.DUPLICATE_SAME_ACCESS) <def steal_b(y$idu!):*@'''S-# ac from identified by JE.'''Dw4 = ROpenP !0PRO_DUP_HANDLE, False,s)p6tryereturnpDuplicateHc t0,h+GetCurrentD), 07& |CLOSE_SOURCEkfinallDClos3endU(conn destination_pid 6endover a local F ec7 dh = Dup,,Qf.send(dhHrecv ReceiveIq_().detach(xWclassjobjectzPPickl wrapper fo3 )ef __init__(self"ac'pid=Nonedif pid is   # We just dD the!inc5andvFQ# let.rS5ing0h >= os.getpid(\g) q dW.(l%< z-,!$, 0Ev* ?c# =l "2pida#$ [C'''G . This should only be calle)ceb# retrievr Wcwhich ~ly owns it0if .) =DThas alread&endtQIess.t| $ZmZ  from the proce ss whose pid is self._pid.  proc = _winapi.OpenProcess( PROCESS_DUP_HANDLE, False,JU |)2Itry:8ereturnDuplicateHandle(04,h(,AGetCurrent) acFDUPLICATE_CLOSE_SOURCEofinallIDClosr) 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 aa.from;_ 'y0256omsg[0]w AssertionT@"Leng{0:n} but \`1!r}".9/atCG"3a),=rflist(aexcept (ValueError, IndexError): Epassraise Runtime. ('Invalid data received') 5def send_handle(conn, , destination_pidz'''Send a, over a local F ec7A.'''iwith socket.fromfdp.fileno(),uAF_UNIXSOCK_STREAM) as sfds(s, []Hrecv Rs`returnvV1)[0]{DupFd(fR7a wrapper for an fdpopen_obj =text.get_spawning_!%()1if 4is not None~*.duplicate_for_chilhelif HAVE_SEND_HANDLEe/ . import resource_sharere #(fdvs>DValu<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 |Plist.-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.6) Uk Rdf = s et, (df, s.family, s.typeproto) def _rebuild_socket(df, f531:26fd = df.detach(Krreturn I.(L, fileno=fd=register(4;,Cduce) class AbstractRe0r(m=ABCMeta)4'''+b base ? for use in implementing a QBtion*suitable 7`replac4the standard r?mechanismC@usednmultiprocessing.''' ForkingPickler = $$4 = @dump1umpsend_handle = Frecv  if sys.platform == 'win32'QVstealDD$duplicat DDupH Gelsejcendfds1fds$` @DupF_pe_metho ; _descripto:@partial = (&$9%_init__(self, *args!R(_C().f)Q }/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@fierBrc. The uncU will connect #b`,s}_rits pidthen receivesN%he import os esignalRy'|ing from .Jtcontext^ util __all__ = ['stop']  5+6ADupS;.w(objectf1''' wr3rRaOUP&1new$wock.dupc"H(, C share = new_sock.share(pid) conn.send_bytes(+ 'self._id = _resource_(r.register(C4, nruclose) odef detach(O%):'''Get the et. This should only be calleice.'''DNwith@get_aection|P) as  ! =S.recv *dreturnAfrom<CR else`__all__ += ['DupFd']aclass w(object '''Wrapper for fd which canused at any timq__init__G, fd\fos.dup(f D(* , @=Aredu]Fchandle2a: Z#(V2os.? y>E!/fdhVWWB) 7#_RSrA'''Manag= s using background threadQ :~ukey = 0cache = {}clock =ging.Lock(?lHner = NoneDaddress Eutil_after_fork =."!3@lf, ", X C'''R g", kan identifierg6ockS2if !is &*'WstartWE+= 1T[Askey] =  3!3key9@staticmethodAK ZEPm Tto receiveMdo V6.Gimport Client=V3c =0(( authkey=process.current_3()."c((key, os.getpid())#Uc*Cstop@out= -AStop1 d and clear registered resources.''' from .connection import Client'with self._lock:G#ifaddress is not None*.3c =^(Q6,T* authkey=process.current_3().")Fpc.send(nclose(thread.join(timeout+.is_alive()util.sub_warning('_RrSharer IV did ;'qstop when asked'lOner.! = XK% p&for key, (!, C) inXcache.itemsT3Aclear() def _afterfork( ( RP._at_w_reinit_G`P  H]startD[L? cassertP, "Alty have >"?Oqdebug('Eing G4andOa whandles#8=j([}ML].3t =Qing.Tu(target=;Vservet.daemon = TrueI.>?tT if hasattr(signal, 'p?_sigmask')(.&?.SIG_BLOCK, )PvalidMfnals()zwhile 16:trysO.accept() as 6:Qmsg = W.recv*0if )!isJ,Ubreak~pdestinaY`_pid =V/# = 4vpop(key&b sen d(conn, destination_pid) finally:0jclose(=nexcept4 if not util.is_exiting()*ZBsys.Jchook(*_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 .update(8'<': ZR.sem_,N2_6t:.sh1}dclass Tder(object):def __init__(selfo._lock = ing.Lock&Afd =M%pip] mRwith 4rz#if fdr !%#mbreturn # ing the "alive" file descriptor stops main() os.close(self._fd = None <swaitpid>opid, 0B9pidCdef getf:%):Xqensure_runningqreturn %2_fdL 2!U'''Make V that resource tracker process is w.^,This can be from any6. Usually a child will use6the~ created by its parent.'''/CwithFlock)#if fd1not %)#swas launch`efore,EPit st?Ivcheck_alive(n$C# =>P( M)r <Sdead, it again+ $ # Clean-up to avoid dangling=es.8>tryQ0# _P if t,N4]otherdOdpython, which has star(=_N?is .?os.)except CP7_Error&Talready been terminMpass8\ *0wardDrn(': died unexpectedly, J2'rebing. Somes might leak.')lGpfds_to_Y = []2.append(sys.stderr.Jno()E>ion | cm'Smulti ;q importu;z:%d)3r, w = os.piper;#@out  us, so no need t)idF exe = spawn.get_executabl-@argsexe] + util.__-_interpreter_flagsC+= ['-c', l:% r(# bpo-33613: Register a signal mask that will bloce signals. c# This S mask; e inherited by the child_is goingPto be spawned andQwprotectIfrom a race conditionQcan make@die before it registerhandlersRfor SIGINTSIGTERM. TheTis unRBfterbMtry:if _HAVE_SIGMASK&*.pthread_sig(SIG_BLOCK, _IGNOREDS_NALS)ypid = util. v_passfds(exe, args, fds_toFofinallP/UNnexceptAos.close(wYraise NelseDpself._f3w/Q9pid %1r) 2def _check_alive(t)@'''C|pipe has not been sending a probe.'''f # We canH@use = here asW calls ensure_running, creat # a cycle@os.wGI, b'PROBE:0:noop\n' OSErrorreturn Fal'FTrue_, name, rtypehRG" of resource withytracker] ._B('REGISTER'l` U-/UNZ, cmd!.(msg = '{0}:{1}:{2}\n'.format(V.encode('ascii pif len(v) > 512# posix guarantees!o@s to)oIsn PIPE_BUFKpbytes aatomic,L20 >= 9Fa Value (' too longnb/= 6msg>tassert 0="3, "{0:n} butsg) {1:n}".format( nbytes, len(msg)) _resource_tracker = RT() ensure_running = 7.#q registO,4 un To getfd% def main(fd):t'''Run  A.''' # protect the cess from ^C and "killall python" etc;rsignal.(.SIGINT, __IGN)1 OTERM2if _HAVE_SIGMASK`pthread_sigmask_UNBLOCK, @OREDEaNALS) for f in (sys.stdin, 3out@l6tryyf.close(except E:ion0Bpassucache = {rtype: set() _CLEANUP_FUNCS.keys()} b# keepD of E6ed/3%edsCwith ope', 'rb') as f@line E cmd, name, = G.strip().decode('ascii').split(':'NKcleanup_func Aget(fo, NoneC9if F!is- lraise ValueErrorB&f'Cannot {}automatic": y> f'unknow3ype2#}' 7md == 'REGISTER'[9`].add(='el[/UN]oremove`_PROBEI OelsecRuntim'$cognized comm%r' % cmd  ]Gchook(*~_info()s40gfinall!#  roes have terminated;p any re7*/ +_> w.items(0"if-)0war_ s. $(': There appear to be %dU  'leaked %s objects to clean up at shutdown' % ; (len(rtype_cache), -))=except EMion:"bIpassfor name in[i>0# For some reason the process which created and registered thisu# resource has fail+Do un; it. Presumably it+Jdied. Werefore unlinkC 1>try_CLEANUP_FUNCS[ ](<0 _ as ex/warnings. $('_tracker: %Qs' % u?, eofinall"""Provides shapmemory direct acdacrosses. The API of package is currently1visional. Referthe 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) limit14 characters. _SHM_SAFE_NAME_LENGTH = 14] #QblockJp prefixQLAPREFw'/psm_'%!wn% def _make_fileq"()\!"Ccp a rand!L !."a# number?Abyte1useCm-n1= ( ! - q)) // 2Bsassert I|>= 2, '1 too long'4= = &2+ s.token_hex(Y}lC3) = 0raise ValueE0("'B`' mustpa positinteger")\~ U$.__O_CREX |$"if= number different from zero!is )!4elf&JEXCLM@' ca ly3="") :"# Shared Mp# !QwhileW = _make_file($?tryE!/_%xshmem.shm_open(1u," _`) Rmode=. Uexcept FileExistsrcontinu- ! =YbreaksHQ"/" +NVcNG) ]{! Ss;#ifD os.ftruncate(self._fd, size) stats = 5 1+`ize = &Ps.st_QPppmmap = .Vexcept OSError:S~unlink(iraise 5from .resource_tracker import register3name, "shared_memory")fVelse:T# Windows Named S<! M< +if createwhile TrufPtemp_ = _make_file`() if is None  G1# C and reserve   block with thisL until it can be attached to by "h_,_winapi.FileMapping(73INVALID_HANDLE_VALUE,6ONULL&PAGE_READWRITV( >> 32) & 0xFc2+>try``last_ep@_codMqGetLasto==if D$= EERROR_AL9Y_EXISTSP1not1 5 ,bExists$/qerrno.E2or4(>)?*E  WcontinuemU "-1P, tag=ofinall CloseHandle(1Pz5 = |Zbreak T[ O# Dynamic determine the e1ing;d_Iq!'s` whichlikely a multiple ofRSIZE.  h_map = _winapi.OpenFileMapping( % -FILE_MAP_READ,+_FalseMname4)Mtry:Wp_bufMapViewOf7/0J ofinallCloseHandle(HGsize*VirtualQuerySize(K7belf._m".P(-1, RP, tag=%) s8#! =* memoryview(1]Fdef __del__) =c(except OSError>Bpassgnreducejzreturn Kn__class__ *k. )2; 2) #Orepr1f'{O0.__B__}(2!r}=}2})'"@property0_ ` $. _`Szfd >= 0#os^/fdfvfd = -1munlink""Requests t(hat the underlying shared memory block be destroyed. 2In order to ensure proper cleanup of resources, unlink should be H called once (an !ly) across all]cesses which have ac!toE."""'if _USE_POSIX sself._name:&dfrom . _tracker import unregister5_posixshmem.shm_(d)/F#2, "_") _encod= "utf8" class SableList"""Pattern for a mut" list-like objectRvia ad} . It differs >built-inX type in t]sts can not changepir overlength (i.e. no append, insert,Retc.)Because values a`d intoview as bytastructP@packObformat(rny stor] must require0morAan 8Fpcharact to,cribe itsR1mat}+S# Theafarea is organizedrfollowsR# - 8: number]items (N)1a 64-bit#eg9(N + 1) *CpoffsetsDeach elementPstart"th# @data{a4- KjRie(with /izp de ?oY0eirXqpectiversRN``@ strGNPindexKpo _back ns'os_mappF&(iRrecon6corresponbPython_Fi1= {Zint: "q"@floadbool: "x?str: "%ds qNone.__`%__N#?x:}a_align>=10: lambda:, #!, , y&1E .rp(b'\x00').decode(>P), # I2I#":3:_ : 8*#9}@staticmethoopdef _exgt_recreation_`)Y`"""Use c=1rt Rto convert value3s $into the appropriate Python objects when retrieving/em fromFAlist as well6Dstor3E."""2(if not isinstance(value, (str, bytes, None.__class__)):@return 0OelifS?str:1: <2</seA3 #QType 0 def __init__(self, sequence=, *, namz0aame isR5 or9L@ [& =-Qor ()C_formats = [._types_mapping[}(item)]04 - )6_else s O % (wA<alignment * (len3 //\ _+ 1),N@for 5 inO ; p_len = l ^assert sumfmt) <= 8 s0fmtr: =Dlf._\ offset =b# 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_recreation_code~ |extract3rosD@sizetruct.calc\S"q" +:+_)_metainfo +"".join($5QpackingT 0back_transAB )p=qshm = SM(k!, @e=Tr=&  OZ %if4p_enc = Yodings*_fo,  self.shm.buf, 01_list_len "*("allocated_offsets)^ struct.pack_into(,"".join(_formats)zx_data_startG0*(v.encode(_enc) if isinstance(v, str) else v for v in sequence _ing_metainfo/M\sL t *bPtrans_nQ*(_recreationv %) :a = lenp) # Obs size from  0buffer.P )Y>ist? un_c$Y0at_B0F"Y1 * 8;def _get(`, posi|)Z"Gets the 0ingT0mat a single value storedP0%."\% =gB>= 0*+ LEif (&+>='Q) or .7< 0 raise IndexError("R%Fstedout of range."0v =jJ"8s"k& +E)[0]fmt = v.rstrip(b'\x00'fmt_as_str = fmt.deFWoding`return&3x= k= 2 RP funcnK"."rpbset_back_tra nsform_codes + position E)[0] 3tra0@func( = self._back_ s_mapping[c%] Lvreturn S#def _set_packing_fat_andg(|,, fmt_as_str, value):q"""Sets the U UP and a$% aFbsingle]1 inNqlist at specifiedB."""SDif (e$ >>B_len) or $._G < 0E raise IndexError("Requestw out of range.")pstruct.e_into(\Y"8s",e.shm.bufN_offMJ * 890.enf!(_Eing)|&-uextract_recref(I b#1y _getitem__:=_6 if >= 0 else+O|6try]_data_start Kallocated$s[+Q@(v,)Op!unrJfromr+d ,)P4[gexceptB `il SR ;get1v =|K#(v'v)s) 0Ag 7 l_-scurrentzma,massignment  if not isinstance1, (gbytes) a}length:ypraise VError("bytes/str exceeds available storage" current_format[-1] == "s"w3new': = 8 > self._types_mapping[str] % (L] ,&)^set_packing_and_trans i/ Y Upstruct.wg_into(A shm.buf, *, def __reduce__(9)Rreturn partial.__class__, name=3.lC), (Z?lenW!unfrom("q",Z0)[0]/prT1f'{0.____}({list#)}-R!r})'k@property{a?"0"Th Bing * used byQ!ly!ed=1s."^zjz"".join1ge0(i)l i in range ._F_len.size_metainfoG rfor the'3agexQq" * f>c5OF?mat 8sW"LFback_sS'S Pb_data_stara# - 8 G5gth(!(N- *2telement6  2)F_n Z^3" +__$s{offset_back_ transform_codes(self): preturn ._offset_packing_6Sats +list_len * 8 Bdef countWw, value^2"L. -> integer -- |number of occurrences5"."k1Asum( == entry for i)6_indexB""L.!R)afirst (Raises VError if the is not present.""position,enumerateQo#ifY)ZJelse.rA(f"{ 1!r}in this container"[__class_getitem__ = ,method(types.GenericAlias) # # Module which supports allocaac= objects from shared memoryJmultiprocessing/"<".p$@Copyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreem` # im lweakref #. %Kheap@get_Q4ext.5Preduc, assert_spawning _ForPickler = -.q __allQ['Raw0', PArray 1copsynchronized'] uM@_to_ A = {cC'c':.c_char,8 'uw1bCbyte1Bu1hQshort2('Hu2i"in0H 'Iu0lAlonga8 'Lu1qH, 'Q15fBfloa('dadouble1}~Q_new_g_"@size s.#of!EQwrapp2.BufferW(/)'>rebuild_G#, C, None) Y$!ors, *args1'''_Rs3s a+/edHAnoO.get'mobj = Is.memset(addressof(obj), 0,i\.__init__(XY5obj9t1_orEializerG aFcated from shared memory '''type_ = code_to_ P.get( !or,')Eif isinstance(size_or_initializer, int):-~YvO_ * 3,obj = _new_value_yLcMs.memset(addressof(obj), 0, kDreturn objwOelse?lenNOsult re#!._%@__(* 5Q5u def V  *args, lock=Truecx=NoneRa synchronization wrapper for ah9?Raw !ifi is FaU r)2n (x = ctx or get_context(i#$c.RLockif not hasattr(&, 'acquire'@ raise AttributeError("%r; no method;1" %N ed|Bctx)QArray 2, *D21Raw|@copy^7 $Kpointer(3e)[0] =eLrwJaasserteobj, S edBase), 'object already*"ed>b h_SimpleCData&$./el[T if@._fc_charoString21 Y3clsz-S:trys*class_cache[cls]c1except Key= names = [field[0] for in cls._Ws_]  d = {name: make_property()F E)s}>Pclass = 'Synchronized' +u_)__6qscls = =_cache[cls] = type(78, (TBase,), d)Npreturn Q(obj, lock, ctx) # # Functionspickling/un  # def reduce_cQobj):eassert_spawninge~if isinstancevypes.Array?irrebuildb , 3 ._n_, obj._wrapperrlength_mBelseQLV)BPTNone)(25_, )t2if  is not G<3_ *,4_ForkingPner.registerpkTbuf =.create_memoryview(&4objq.from_buffer(buf!GP:objB to p 4ies2try ?fexcept KeyError5wLexec(template % (J,)*7 eV = d[o VQ= '''get%s(self .acquirem'_!%sVgfinall "`releasIYsm, valuetKm" =;u%\)!, )  !} pweakref.WeakKeyDi@Cary(S3H aect): __init__=cHx )  =-J6ockX- ! =/ H,0ctx tx or get_context(force=True\- ]ctx.RLock5!L6 = 0a- *2Senter3K_4.__+)@xr_*argsF 1+JE +<$!, .1lf.1obj(kMelf._obj def get_lock(self): preturn .! def __repr__3'<%s wrapper for %s>' % (type4.__name__,a obj) class Synchronized( CBasevalue = make_property(''K_ArrayP?len1len"._)sgetitem:3, i"Awith[ _hobj[i]asR!, YR" =6Zgetslicestart, stop^ >:= fsngs0iStringmE7.aw!raw') # # Code used to  processes when using the spawn okserver #5methods.USmultiGAing/91.pyCopyright (c) 2006-2008, R Oudkerk # LicenPSF under a Contributor Agreementu import os %sy Trunpys from . 77_(t_ 1tcontextNreductionutil __all__ = ['_main', 'freeze_supset_executable@ 'ppreparazT_data5command_linI|_path'] p_pythonw1 isassumed '#& . # People embedd2PLP want9modify i f sys.platform != 'win32'XWINEXE = FalseWINSERVICKelse0getattr(sysV0oze`G)Hlower().ends"("ice.exe") if ;P= os.1P.join9c_prefix, 'U6') D  4(ex@wglobal B =G,(M 4" #5pis_forkCargv51'''jR`whether rq indicatPPe areEG8@0if Z >= 2 and [1] == '--W-': return True else: !re False def freeze_support()-1'''5$Run code for process object if this in not the main'@Hif is_forking(sys.argvmkwds = {}7r0arg_0B[2:]! name, value = arg.split('=')J)$if&= 'None'I$[R@] = $ B J0 4Aint(|`spawn_0(**-ys.exit()get_command_line2KRs prefix of 4 4Q usedzing a childpgetattr, 'frozen', $; ([executable, '--multi@ing-I'] +@.['%s=%r' % item 0in . Bs()]& saprog =+m s.0 im u; B(%s)N%= ', '.join(C0optutil._args_from_interpreter_flags(3F[_python_exe] + J+ ['-c',gX.(pipe_handparent_pid=p, trackOspecified by data received over e:oassert`, "Not"70if ;platform == 'win32amsvcrt6h_winapi &f 1 is1;ssource_3 = Ib.OpenP(U2%SYNCHRONIZE |;PROCESS_DUP_HANDLE,BB, o S3new = reduction.duplicate6X u=Rfd = .open_osfn(, os.O_RDONLY<sentinel = f E$ .#re11 .._95_fd<V osga!= j5(fd*.(38@withV fdva'rb', closefd=) as from_parent:# process.current_()._inheriting = True5Etry: I preparation_data = reduc.pickle.load(from_pak)B,e(J &Oself\kfinallCdel  preturn |._bootstrap(_sentinel) def _check_not_impor@r_main()4if getattr(7, '', FalseAqraise RuntimeError('''An attempt has been made to start a new before th#Hfinished its p"uphase. @This<bably means that you are not us;FforkEyourFPchildGaes andAhave forgotten=!us,per idiomG in  module:0if __name__ == '_2__'#freeze_sup(%)..!isd"]a"if0os.)b.isabsc)S1process.ORIGINAL_DIR k7$= t_join(L,Jd['init_NAfrom$6'] U@norm return d # # Prepare current r # oldals = [] def p6S(data1'''_`Try to TQ readunpicklenq object@Hif 'name' in h._0().1! =/[>]NauthkeyQ4T'Wlog_to_stderr]8 !]Yutil.&()UlevelT :get_logger().setL-&['=]S2sys)Thm%[',Oargv@*,@&di!os.chdir%Porig_ 8start_method8et_#'], force=True\ bb_fixupW(gB]P c c'ls# MultiPBing  helpersfix up the"in # spawned subD!es) @mod_ ;2# _P_.py sd packages, directori zip archivetc, run=#@ir " only" code unconditionally, so we don't even tFpopulate anyth%inq, nor dA1mak%p change)C aibutes=%l4s['4!']+*T == ""CD.endswith(".!Y+W# If thisy!wakEked,r may al4be dmain.__spec_ _, "name", None) == mod_3: qreturn # Otherwise, __main__ may contain some non- code where we need toJsupport unpickling it properly. We rerun asnpqand makeJ ths@rmal&an alias to that+2oldCmodules.append(current)*_& = types.M5Type("__m"2ent = runpy.runF(Y,`\9=j<alter_sys=True.__dict__.update(.Bsys.-4s['\'] = I8 def _fixu$from_pathq )f# If thiscess was forkedgalready be populatedQ$']Unfortunately, A ipython launch script historically had nQ"if _0 __>-" guard, sowork around# by treatelike at.py filSee https://github.com/ssues/4698` = os.x.splitext(@basepA)[0]A7if D3= 'r'r$ 4__ hahe setwe expect#re's noth@moredwif getattrR, '__k'|@e pas a = through ra0n a.u@`assumeis an executableQ6g#7%3b%Hb "fU/Y imw1'''=SetM0_']2 at7? R # # T implemen synchronization primitives3multipro)Fing//Ae.py#Copyright (c) 2006-2008, R Oudkerk # LiLcensed to PSF under a Contributor Agreement. # __all__ = [ 'Lock', 'RLock', 'Semaphore BoS(dSCondition!aEvent'K] import threading4sys tempfile_multiprocess3time from . X{context< util # TryB)the mp.synchronize module cleanly, if it fails # raise IError for platforms lacking a wor sem_openlya-. # See issue 3770 try:: @M0Sem , Yunlink except ()K e("Thiss a funcZ1" + ", therefore requiredC v primitives needed will notF O.") # #8stants # RECURSIVE_MUTEX, SEMAPHORE = list(range(2)) SEM_VALUE_MAX = _..)u0BasD1ass!s1s and mutexes; wraps `Z` clFl(object):  _rO$= F._RandomNameSequence(),def __init__(self, kind, value, max c*, ctxB if is NoneZcctx = ._default_%ge !()5@name60tx.!start_method&_now = sys.h == 'win32' or Nr= 'fork}eRi in 7100!q  slmelf._semlock(?Wtp._make_?(),>0VFileExists (IpassY;els'Ubreak($: n('cannot findxf'lar.debug('createdRwith handle %s' % sl.0s_*if! `after_A N5obj'._/'PregisP'', 9 P.MIQ# We only get WPwe ara Unix Aing & # disabled. When the object is garbage collected or#' # process shuts down we unlink/ semaphore name>from .resource_tracker import register3(self._semlock.[5, "l)")6util.Finalize;`, SemL;_cleanup,  T)),I exitpriority=0) +@staticmethodDdef f(!):M $un1Bsem_^K, 'Rmake_sUacquire = dJnreleas-x_enter__tkreturnl_.VC3xitBw, *argsI4.0geteQJcontext.assert_spawningl# if sys.platform == 'win32'CDh = m&gej_popen().duplicate_for_child(sl.handleNelseZ)#(h, sl.kind maxvalue (s(!, 6/ ' = _multiEing.k@rebu*Cdebug('recreapber with b %r' %6[0] :+( `'%s-%si(.current_()._config['semprefix']- Vnext( and)) # #" # class2():'in=1, *, ctxn_1SEMAPHORE, <, SEM_VALUE_MAXF=Js,l2_/?rep6tryPi \.U'except E?ionI'unknown'qQ'<%s(oQ=%s)>_P__.__%#__,vBoundedSK$__xelf): try:  value = self._semlock._get_%()/except E?ionI'unknown'8return '<%s(T=%s, max u)>' % \1(_class__.__name__, 9,Q) # # Non-recursive A # L Lock(Sem1): ydef __init__z, *, ctx)3.(SEMAPHORE, 1@ctx=:ZCreprZR +if_is_mine(6!  = process.current_0().!2if threading43 != 'MainT('@] += '|' +S .elr^ == 1tpv= 'None^Pcount() > 0KSomeOther /se;P~( ' owner=%s/._ MRR8RECURSIVE_MUTEX1) lh+"!, P );, 0|2, U 3, 'nonzero>MENPRW/,  `]gCondition variableW(object[=f"! =0 or.)sleeping_! =+Semaphore(0) self._woken_count = ctx.Semaphore(0) s-Tait_s 0make_methods() Ndef __getstate__([!):mcontext.assert_spawning'&qreturn ._lock, I._sleeping,2\&9w s!, " =g9T^enterQ+>*4.__+ Cexit?w, *argsF1+ xH.acquireX kreleas*rO_rep6tryY@num_Ters => 2._value() -H KEOexcept E?ion 'unknown''<%s(%s, %s)>' %_class__.__name__', , timeout=NonefKis_mine(), \%c'must  () condition before using ")';# indicate that this thread is go61to u.1^ ? G(for i in range(1gHp # YPnotif*$or^ eAdU(True[inalls Ahas 6 {ElC# re rI 'mKMU1y7n=1'[\not ownedtCo False), (': Should Ghave been able to$ v1+ ''##Bqtake ac4 of5s since last notify*() we subtract  # woken_count from sleepingand rezero+Awhile self._K.acquire(False):0xSres =4 n 7 6 assert res, ('notify: Bug inG'A{@+ '-L should not be 5') 9 er0)@< n '2@ 1 wait_semaphore.release()# wake up one%er&sF+= 1$if.sPfor i7drange(? Z0it Sao1 toL#H case some timeouts just happened~ Km Bpass0defify_all(!.nc(n=sys.maxsize>1for<, predicate,H=Nonresult =+%() if:ultcreturn-(0 is k :0end$! =.monotonic() +&ouOelse?[zE[ I Q4if  ^0- 65if J<= 0|"Ybreak<:(2  # # Event # class(object):z__init__<l*, ctxp_cond =.Condition(ctx.Lock()S_flag/SN'(0ais_settlCwithq :Ci]_ oSITrueN*  l&o!&LBcleaKt zSDire(False):  self._flag.release() $Yelse:7cond.wait(timeout) *2if )`acquire(False)T+yreturn Truek\ # # Barrier # class(threading.#"):def __init__( , parties, action=None, g*, ctximport structfrom .heap !BufferWrapper(w9 = (O.calcsize('i') * 2 =`.Condi.__setstate__(( , L#, )dEAE = 0QcountQq&!, >0l%._&"._r,Bs,X 2" =c,Parray-@.cre memoryview().cast`g8P|# @propertyYGu!._3[0]C_2S.settp Hh, valu H" =!P12 H %1]Module provi various facili to others of the package9multiprocessing/util.pyCopyright (c) 2006-2008, R Oudkerk # LicensedlPSF under a Contributor Agreement.3os itertool%sy tweakref+datexitX # we want to install it'sS0# cleanup fun before $a does 3sub<`_args__interpretert"s 5.,; __all__ = ['sub_debug', ' @infoawarnin get_logger'2'log_to_stderr2#qtemp_diPregis afDfork<0is_c\FinalizeEForkAwareTTILockTLocalGQclose fdR@cept.SUBDEBUG sWARNING6]pLogging,aNOTSETe:Q = 5 D = 10 INFO = 20 SUBWARNING = 25 LOGGER_NAME = 'multiprocessing' DEFAULT_(ING_FORMAT+[%(levelname)s/%(7N] %(message)s' _logger = None_to_stderFalse def sub_debug(msg, *args): if I.log(SUBDEBUG, ;VR$OOinfoOINFOowarnin#oWARNIN3get (C1'''KReturns used by +3dglobalaimportEAing Ring._acquireLock()6trydif notO:=$ =\Q.getLD(W15.propagate = 0X\# XXX should cleanup beforez_if hasattr(atexit, 'unregister'e*'.% (_8_function62U0 FelseS>Bihandlers.remove(O, (), {}) FoappendF/gfinalldreleas-r 6log i=:atTurn on and add a  which prints to rxEt"\.qformattF(JvrStreamH>&F.setWuJxder.add<6)1if 42@setLlMPq = True  # Abstract socket supP_plat_3s_a0_0stif sys.1 == "linux"sys, 'getandroidapi ?i_space(addres Vif isinstanEd, byteL'P0[0]0w/elD3strBA"\0"Eraise TypeError('address type of {,!r} unrecognized') abstract_sockets_supported = _platform,s_0D() # # Function returning a temp directory which will be removed on exit # def _r_<_dir(rmtree,Mdir): (& current_proc#= .!()0-# @ canNone if the finalizer is called?late durdPython-a &,iffG@not d ._config['A'] =3(6get$# get nam automatiy cleaned upt BU.get(Y9Qempdi3 im`r shutilAfilew{ @.mkd (prefix='pymp-'k3info('crea+v2%s'f(/ # keep a strong reference to.dQ), si #3I?ed Edown4FR(,, , args=(8#il,HBpriority=-100 b>1dircrzS  for reiniti of objects when boot` pp"ta child_afterfork_registry = weakref.WeakValueDi]gary() 4counter = itertools.N"un0_eCers(,items = list(#".!"()I S.sort;(index, ident, func),0 in&ms6try .B(obj`except EKJas e54ker raised =6"e)&U"eru] Y[(nexV0er)B)C2obj  ussIfv = {} _hs class ge3ect1'''C$ls9ect D;_q__(self,DbackQ), kw \Hif ( `) and isinstance-4,inL TypeError(  0"Exitpriority ({0!r}) must be None or int, not {1!s}".format( J eQx, type(E))) 8if obj is]n:Pself._weakref = .ref(obj, !)3Xelif mZV raise ValueError("WithoutJect,D0can"~._callback = "pargs =   kw3 = \or {}$Yey = E , next(_finalizer_counter) {pid = os.getpid(>registry[5akey] =]Qdef _0__($P, wr=Z,# Need to bind these loy because globals can haveK been cleared at shutdown,=sub_debug= ", 0=:)5'''1Rununless it has alreadPalledPPcance HT6trymSOdel Hexcept Key H%(': no longer Vered'GJelseF!if ._\#!=*(!p@igno different process}E re@pving %s with 4and|?%s'R{ ._ ;72 @"(*@*B(II = \!Lf:k` ]`returnC _ation of#eobject6FEpassr/\SIstill_activeK Rwhether thisX erIP waitto invoke''' ret(urn self._key in _finalizer_registry def __repr__(3!):6try Sobj =Yweakref()/ except (AttributeError, Typ [NBNone0if e0is  ~0ret@'<%s%ect, dead>' %_class__.__name__ZIx = ;callback=%sA(-._S,)qgetattr?$._X4, '#',)6#ifJargsx += ', e=' + seD kwF HJey[0] is notexitpriority\C\x + '>' |6runUs(minO41'''wRun all s whose  : and at least _Fs with highestK@are ed first;|1iththe same8ewill b<in reverse order of creation.C/if# This funcEG mayppafter t"module's globals arer# destroyed. See _O_[ (inSy for moNRnotes_k(iff = lambda p : pFelse2 G(>={# Careful:pOmutated whilr#running (either by a GC run o!nothread).Vlist() shouldratomic,u8.items())2notkeys = [ ?in E) if f(key)]p@c.sort(b=True)Q([/ =bA.getdc- # yhave bee50mov|1rom2jsub_debug('F%s',U uE6ionimport tracet.print_exc(`7 >er_registry.clear() # # Clean up on exit # def is_ing(): '''Returns true if the process is shutting down19r9 X6 or is None r= False_function(info=, debug=, _run_finalizers=,active_children=.<current_4< A# We holdlto references to As inTarglist due 1thep# situa described below, where thisPcalled afterJmodule's globals areUtroyed. 'eif not"Vb= True.#('* &!')i&`('runnEpall "at&"  with priority >= 0D 7(0)+f  ()"Tcheck=7 x`becausF2it'`, any +``e()`` will raisB# an AttributeError (@` winds0try@+toTget aEs from util._l). On{jcan happenJif someone hasmanipulated sys.0s, 9"bgarbage collected. Thuctor fo$e F,ypEthen repla|dUvaluez:Bdictj.For instance,[ setuptools runs a test itn Eja copy cre$earlier. See issueS#9775 and #15881. Als^g: #4106, #9205d7iDp a $if p.daemon>!Pnfo('erminate(): %s', p.nameBp._popen.tA" Cjoin "p.2 Qremai2) .register(U@SomeB@k awPtypesclass ForkAThreadLock(object ): def __init__(self ._lock = threading.Lock()>&acquire = 5. *kreleas**register_afAfork, ForkAwareTP._at_#0_re!) H D D(E0_en hreturn_+ @x_w, *argsF1+ classfLocal(lSWlambda obj :.__dict__.clear()]nreduce0Btypej , H# # Close fds except thspecified # tryMAXFD = os.sysconf("SC_OPEN_MAX") EEL:ion8P256 cv_all_fds_54(fd~a= list + [-1, ]Dfds.sort`assertr[-1] ==,, 'fd too large';or i in range(lene3- 1=1os.%fds[i]+1,cfi+1]) >sys.stdin and replace @with0pdevnullO_]_$(w6if Jris None@B4T (OSError, Value o<OpassS"fdopen(os.,O_RDONLYxE FCAfd, fd=False=@|6(fd)Qraise7Flush standard streams, if anyf'_" Aout.1 sAttributnz Z?errZ,Start a program Enly  kpspawnv_fds(path, #, Dimport _posixsubprocess*Puple(ed(map(intJerrpipe_$, @writ0os.j 4 .yQexec(l[os.fsencode)], True, B,A#, None, None, None , -1, None) finally: os.close(errpipe_read,write) def :_fds(*fds)V@"""CR each file descriptor given as an argument"""for fd in fdsM $fdy_cleanup_tests(z multiprocessing resources whenGcompleted.Pfrom " import sup ## U.$()6Stop the ForkServer . if it's runningJ QforksC+&._o._stopR_Track(d"_tI .._ bpo-37421: Explicitly call _run_izers() to remove immediatelyy@# te ary directories created by.util.get_:q_dir().L x.gc_collect]reap_children() # # S= aAPI of  package u thsE */dummy/__init__.py&Copyright (c) 2006-2008, R Oudkerk # LicensedKPSF under a ContribuPAgree. # __all__ = ["'Ph', 'current_eactivesfreeze_'"',G@LockR Semaphore BodConditionCQEvent.`arrier AQueuBRManag1Pip@Pool$Joinable,!] DIDtv m4systweakrefqarray p.connecHT!, %, ,, ?, 2, B0qkpclass DP(!.T"):s(self, group=o, target Cname args=(), kw #{} l.a\ , W,HsOq._pid =d3 = .WeakKeyDiLary(N`start_eW[FalseX pa; = 6G32if Bnis notGraise RuntimeError(   "Parent is {0!r} but cur_process1!r}".format( ; qself._pP,DE()))6*start_called = True"if hasattr(-W'_children'):/(.&[v] = Non_threading.T .k!) V@propertydef exitcode&|0if d!._Drand notis_alive(return 0dFelseZ#! ## Ps= Dummy &=  +&()1 = weakref.WeakKeyDictionary() eactived. =afor p in list(9!if?/p.<4q.pop(p,b3 Zfreeze_supportQpass [ # class Namespace(object__init__, /, **kwds#_dict__.update($FCreprF;ritems = H(Gtemp = []VyWname, valuea6 T\)swith('_SSe.append('%s=%r' % (=f !.s[q'%s(%s)=kP__.__N__, ', '.join(w)o`ict = K Array(type, sequence, lock=R[a1.7)V=xmu?+4 =  "C" =%xbG?.q.setternxCC 9/__ '<r, %r)>'%^g)`,ef Manager[sys.modules[+]shutdown2SPool(0es=@ , wializersargs=()Sfrom ..pool im' $RGh c ^) JoinableQueue = t Analogue of `multiQconne` which uses qFs instead:qsocketsR E /d&/Kction.py # #h Copyright (c) 2006-2008, R Oudkerk # Licensed to PSF under a Contributor Agreement. # __all__ = [ 'Client', 'Listener Pipe' ] from queue import Q familiesGNone] class I(object): def __init__(self, address=@!, Ry backlog=1):>B5#.__=()laacceptjD`returnnection(*Wg.get()M\closeL90 = @property IPI;s__enter<= .xiexc_type, Cvalu 'tbJC.@) v(,_in, _out ~#),)/`.put(()b, _in)4ConPv(duplex=TruexOa, bsV.(),@b, ac @in = qsend = j A_bytDB0 /Drecv/ / inApollW, timeout=0.09"ifv_in.qsize() > 0%Ft$ifRo <= 0.3UFalse4Fwithonot_emptym c.wait(.0$Fpass#C]""" Python unit testing framework, baon Erich Gamma's JU0 and Kent Beck's SmalltalkJ0 (uIxpermission). This module contains th &re eqat form%basis of specific{p cases 0sui(TestCase, Sq etc.),'also a text-rutilityxqP runn+a rewresults (Textk`RunnerSimple usaget~R  IntegerArithmeticM(..QJ1AddnR): #method names begin '0'.assertEqual((1 + 2), 3)  self.assertEqual(0 + 1, 1) def testMultiply(4%): ' G(0 * 10), 0J*5 * 8), 40) U if __name__ == '__main__'t@unit.-() Further information is available in the bundled document*, and 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 undersame terms as~ it, so longt}cmessage 'disclaimer retainedair original 6. IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, IN SPECIAL`CIDENT 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. """ __all ['TestResult', @Case IsolatedAsyncio) qSuite',Pw ? xt`RunnerEBLoad@Func9L` GadefaulJ<@Skip8VDskip$If kUnlessLexpectedFailur#TeinstallHarBregister&lremove>AaddMcCleanup'] # Expose obsolete fs backwards compatibility.extend(['ge%KPNames Cmake` 'find5"@s'])_ = True 1 .r import 5Dcase(,0e,, $,  ,  29"If!+, )sx@Base ,lz-(*Q-, d%, :,, Y) _main import TestProgram, main from .runner import Text*R,Sesult3tsignals4 installHandler, registerR4Jmove- # IsolatedAsyncio}Case will beeed lazily. # deprec6% _n, = # There are no tests , so don't try to run anything discovered * # introspect the symbols (e.g. Function). Instead, all our #AcomeX0 wipP unit. def load_ s( \, pattern): # os.path# top level directory cached on[1nce4this_dir =K.dirname(__file__))TreturD.(`(startA=J= ELazyfv0 .aP_case-t8!s io, which is relatively heavy, but mostt9o not need it. g_3__(Nglobals().keys() | {'$'}Jgetattr__(8R0if O == By' 8_raise AttributeError(f"module {____!r} hasU, {!r}") """Main en_point""" ksys if sys.argv[0].ends@("__d__.py"F We changHmake help message more useful# executablrPthout]h, unquoted,(it's just a hint)2way # (if you have spaces inrd#get what deserve!H@baseV(+"2?( =je+ " -mW"del os __o1Crue vJ !(md=None)tlogging@coll4onsMMT_BaseContext _LF`Watche{H.dtuple("*!", ["records", "output"]) class _Capturing(.k#A " h$ cA(raw and form%d)2}.P __init__(selfqmk.(?'6%.wD,Watcher([], []) def flush(self):Fpass#Aemit", record*9.watcher.s.append()Vamsg = 2mformat"NdoutputMmsg) class _AssertLogsContext(_BaseTestCaseb"""A c( manager used to implement =%.a]b().""" LOGGING_FORMAT = "%(levelname)s:%( message)s;h__init__Itest_case, logger_>!, R.LkIY( =g"ifqt=7Aing.0ToLB.getROelseNEINFO4pBNoneo4Senter5if isinstanceR.SL[9*4+ ge=ger7ter8Ft8 q;Qhandl9_CapturingH(&F.setXv(}s3 = ]'Cold_!s4er.>[:]/,&propagate*.voC = [{x$1set$a = Falseimreturn  xexc_type, value, tbv=w@Tb123 0x!if is not z # let unexpected3eptions ! through< Qgnk,j) == 0y_raiseFailure(dh0"no3s o {} or higher triUed on {}"@. (e*'4NamQ"),'0er.)) import asyncio0ins) from .^*[ IsolatedAD!( > # ps inten{ally have a long prefix#Preduc ch clashing with us%er-defined attributes # from inherited test case The class doesn'#$ll loop.run_until_complete(self.setUp()) and familyNbut uses a different approach:%1. create a long-running task that reads m< awaitablepqueue aI with a futur2 2.2B the <object pass{!in1set(fresulttAinto[ > 3. Outer code puts+'~ = T!a J" 1forK9%trick is necessary because every c) callE2newy=embedded ContextVa .;To share c#vars between ,nearDown() we neo execut0theAsideAsame#. uQNote: modifies!nt policy if,was not instantiatedX4yetasyncio.get_event__D#()3tdefaultm`on demn^returns NonI believ!isot an issue in@qr levelE s Vpython it cestingjshould rea in!ryI0$ul!byfs)tModule()def __init__, methodName='runTest')super().60)%h_BfLoop =J %aCallsQ 'MC  SE$.T1Y0ddA<qCleanup-, func, /, *args, **kw G# A trivial tramkne to addN#Xtion existzQit hays2tic2#@igna##s accepts regularuJa):coroutin} W0tenUpally do|0addupect.isDGheckI ` argumo Rtherea2 wa}@to cGHC reliably@1. Ibn be "15P()" iPA2. CSc:: __ __>?C3. Rx"gturns awaitable object self.addCleanup(*(func, *args), **kw  3def _callSetUp(>!):P!.s)4QAsync4 .a D)YTestMethod*1, m fQRMaybeV& MaarDownKC>"Te2 t(8B , <Ction@? % 9 n?, /m passert !._ iobLoop is not NoneQret =($Uinspect.isawaitable(ret: fuL|.create_future(4 .CallsQueue.put_nohp((fut, j7oreturn.run_until_completeC M_g?if [Fo`!8d;h"9JelseO2ret e ioaRunnert,@ = q73 = .Gi0fut_result(Owhile TruPqueryUcG.getW{.task_don if9 ryv "og)ry#?tryK? 7^!if cancelled(f$%4set8 Pexcept (SystemExit, KeyboardInterrupXFraisJQBaseEVZCError) as ex!zhion(ex'Qsetup( `n-lnew_event_Ru!&`debug( self._asyncioTestLoop = loop 3fut.create_future()#self._asyncioCallsTask6Ytask(*nRunner(fut)P.run_until_complete& vdef _tearDownAyOa!):$yassert wis not None1{/ =1%O=J %Queue.put_nowait(zIrjoin())6try# cancel all s3to_ #= Q.all_*( 0!if07 m"freturn1for|O in ;u.(B )gather(*o,=I", _exceptions=TrueIL!ifGled(~HvcontinujB7() e9 .c7_handler({2'message': 'un0%d B during test shutdown',O:"':/()72&}x#:gen0<5kfinall8Hset_event_J >P.clos(1runkQsult=Xsetup  super() 0(re[4j(P) """ p case ibPmenta""" impo;$ys functooltdifflib dpprint$re uwarning7`colleciWntextMtracebackFtypes from .Dutil(strclass, safe_repr, _count__=purpose,hashableBmmon_shortenX) __unit9 = O` _subp_msg_seel = objectDIFF_OMITTED = ('\nDiff%s characters long. 'aw3'Se1max<!to to see it.') P Skip!(Eion): """" Raise this exception in a test to skip it. 0Usually you can use TestCase.+ () or one of theDping decoratorsNpinstead'@rais"directly.& """ class _ShouldStop(E%):'2Thes,^ stopIUnexpectedSuccessPwas supposedfail, but it didn't!Outcome(objectdef __init__(self, result=None%.@ing_sure = Falsen'B# =K_prts_subs = hasattr(@, "addSub*")Fs,k = Truped = []6bedFail $@rror"[]j@contextlib. qmanager9BPartExecutorJ_case, is=-VFold_d\R 2trys)Uyield;I KeyboardInterrupt4B4@SkipZ as e0 !kipped.append(( vstr(e))tT r2pas^- !exc_info = sys.(c:1if  M+(.Yb,;els"B 7%eq)o+6# explicitly break a reference cycl2"-> frame ->i7 u9 = P2andrh0fin G i c0 0_id return obj _module_cleanup5AaddMCP(func, /, *args, **kw [@"""Skcas add9,w1epth items are called even ifRsetUp} xs (unlik^barDown )." ]#, )"doJ&s(be all % Ups. Norm1for3aft/tearDownModule.""" exceptions = []while _module_cleanups:4@func3, args, kw- =3e.pop()86tryEI (*AB, **K3$ E0 as G%.append(excD if/6 # Swallows all but first-. If a multi-a handler # gets written we should use that here instead.8Vraisens[0] def skip(reason)1"""8pUncondizAally*r a testY)Gdecorator( S_itemOyif not isFance&g, type,0@ools.wraps/g$z_&=per+ SkipTest#! =^ &"P.__un1st__ = True+@why_/}1areturngG(if=2:3s.FTH2 = 1JW = ''w$ >5If(),k"o; if the 3 is trueT&if"j 6_idoUnlessu3expectedFailur;c5Ring_f7Ap; p_is_subg(Aed, baseo a'HtuplcIall(XQP for  G; ) and issubclass! ` _BaseCaseContext:__init__(self,L8cas.*& =%G-2, standardMsg;R0msg-6elfT._formatMessageJ.msgD]Cl eCU(msg)pAssertRs ()@est_,_regex=Non>b.v_case)  self.expected = # !test_case = #%if7_regex is not None:'Q_(= re.compile()8 J -pobj_nam Qmsg = def handle(j , :, args, kw)1"""6!If& empty, assertRaises/Warnsbeing used as a@context manager, so check for a 'msg' and returnEspcall a able passpositionalRukeywordMarguments.6try !if_is_subtypDQ,`_base_J@r. TypeError('%s()Y 1 must be %s' %6(.sV_str)N9 ?%Q.pop(,7 L3"ifsNran invalid ']'this func' % (next(iter(;)),9N 5p_obj, *& =s <=L!._)__Gexcept AttributH YHstr(] Awith{I5(C, **)kfinall# bpo-23890:u# break a reference cycleKu class _A-C (CBase8["""A 7Yto imple TestCase.* methods.%0 = nE;ionDr = 'an @ion  or tuple o"s'W`__enter__c .3xit-,r< value, tbFc%Y 1exc! =+*U!trY "ifw. _>Failure("{}rd by {}".format(|,B  self.obj_name)) (Yelse:2_raiseFailure("{} not d".format(excWS traceback.clear_frames(tb!if^issubclassZatype, expected)# let un exceptions pass throughreturn Falsev# storeA, without , for later retrievalB =Kp_value.J_GY(None;_regex is ( UTrue y9=2-j 4.search(stry)l_'"{}" does`match '!xX ~pattern, $ !__'_getitem__ = pmethod(;s.GenericAlias) " _AssertWarnsContext(RSsBaseb"""A c, manager used to implement TestCase.ab"* Rs."""`_base_0 = 1ing)_str = 'a warning /or tuple of"s'Zdef __enter__({# The __Rregistry__'s nebe in a pristine stateQtestsMto work properly.&vHsys.modules.T's(Gif getattr(v, ', 8</v./U = {}.$s_=<0s.cs(record=`} E _ U.w:%!.s$filter("always"x 3xit,] ]G, tb'? GA%ife(i:tryl/!._m%__; AttributeErrorM!tr.Qafirst_m=tgmL hw = m.messagWsisinstance(w K5m=inuJ g is None:  first_matching = w !if (self.expected_regex is not None and4@8.search(str(w))):9continue# store warnfor later retrieval0z- filename = m. Dalineno% #ereturn'# Now we simply try to choose a helpful failure messag;if f *r_raiseFN('"{}" doe '.format(K .pattern,  5)))H1if >@obj_M1"{}7triggered by {}"1excI,c  Oelse )) class _OrdChainMap(collections.def __iter__Wseen = set(b@mapp"innJmaps&Sk in + ]Aif kzE.en"&f.add(kuyield kTestCase(objectR"""A  whinstances arngle test cases. By default, th!`ode it should be placeda method @'run'X!IfOAfixtu ayCPused 8Gmany, create asi2s aneeded. When @tiatpsuch a H1sub, specifyconstructor arguments" o.OAthat%z ceto execute authors?their own Ds. C"ioeand de8ion's environ3 ('o') can be!poverrid3 p'setUp'O 'tearDown'@s re:ctivelyPIf it0necLpWe __init__G[BbaseM $ must always+@callIkimportan4at Oe/RchangQsigna~ ir 0sin+.>j edPomatiyKTpartsframework in order :to be run. When subclassing TestCase, you can set these attributes: =* failureException: determines which eQ will~aised whenKthe instance's asserQ methodsje; test1raiEthisIodeemed to have ' ed' rather than 'errored'.I* longMessagee6 " m!s (includ@qrepr ofGobjects u#in)printed on ur` *addi*Qto any explici p4dmaxDiff:s maximum length of a diff irm+by! us9 lib. It is looked up as anH:1 soU be configured by individuals if require2"""uD = A0E'r = Truer = 80*80# I0str$ng_Threshold, normal compariso1ead#_6$ See #11763 Q = 2**16#AtfiSuite for RSetUp2_upFailed = Fals_cleanups = []9def __init__(self,Name='runy"')"""CreateOt1usey!na1estH# j executed. Rs a Value _F doeb notaU1ith{specified }K ._YMk# =K *outcome = NoneGDoc = 'No'(6tryP3` = get+ )@ %$ R'ifE !=  (~# we allow0tiap wD(nohIBQ# butan *incorrect* or miY@e("no such=%s: %s" %! 9#.__)D:lse .__doc__w1 U" 0sub@(:# Map typesccustomf Eq@funcaMio#0cesAsaidT%@more0ailbgenerate a more useful # error message.self._type_equality_funcs = {}'addTypeE(Func(dict, 'assertDict/'):6lis:?Lis:UtupleuTv&seu/Setofrozen>%5strMultiLinH1') +Odef ` , Pobj, ation):6"""Add a% specific e style< to compare6.NThis method is forK by TestCase subcl_s that needTregistertheir own`s6provide nicersFArgs: The datPall t/ on when both valuesMof the same(inN&()>7dcallable taking two arguments and an opaHEmsg=3bpraises .failureExceF with a U qre not 5"""[,[5] =SCleanup(B, /, *args, **kw b,O,@0be t'edVest ipleted. |sm0ed ?on a LIFO basi%re'after tearD@on to or succesh itemsteven if setUp Ds (unlikec.).cPs.append((#E#, M]@3assO(clsSaHB1, e>CP Qcls.__h rmDHook@sett!upixture before exercis&6it.(Fpass+rdeconstrucy[vzs rs @classmethod def setUpClass(cls):b"Hook .@ for*ting up c0 fixture before runn tests in the*1." W@8StearDowndeconstrucbUafterOall ~countTestCases(selfreturn 10adefaul2oResult3r.Z()EshortDescriptionDA"""Rzs a one-line d11 of^, or None if noX/has been provided.( Th[ implementaf$isszafirst %oftspecifiedz<'s docstring./5""" `doc =  ._M5Doc"H.Ip().split("\n")[0] OAelse ,idmW"%s.%s" % (str*1.__ M__),GNamea__eq__7w, otherLqif type) is not *DNotI"ed /2 ==|H>c__hashu&(( ?strP"%s (%s)]p\?7/ )qaddSkip", ,tP_caseGasonQ2 = getattr(6'!',)3if $!(( {G 50war s. &(" %nowb, skipreported",` RuntimeWg6, 2).fuccess@contextlib. qmanagerv0submsg=_submsg_sentinel, **paramU3 a _ ` that will enclosed blockpof code#a ~0 id{!by!oal message anuDkeyword eters. A failQ<]Bmarkvt1 as6!utmes execuat the end of the enclosed "block, allowing further test code to be executed.:5""" if self._outcome is None or not.result_supports_subo%s:PFyielereturn%parent =^F3if " _params_map = _OrderedChainMap()MOelse@i.6.new_childG%xSubTest(`, msg,:try~Cwiths.CQPartE!orT.]@, isjj=True)M\n/ifksucces@G*2if )!-3and.failfast?raise _ShouldStopa,el.expectedFailurR# If the2is 2 a ure, we really want toxHstop now @gistOhCPK:0finx 5 =:Aent def _feedErrorsToRu,f1, e"fo, exc_info in' }if isinstance(}3, _QC.add$3a_case,zw>s4 +subclass(4B[0],0ExceptionG42#L JJaddE  E# = a}e Attribute `warnings. ("PW0 ha {`methodsQs passes",} RuntimeWs QS&$37RaddUn(edb~ =  y4 ass method, reporting as failure", RuntimeWarning)*$# We need to pass an actual exception and traceback*BaddFz y# otherwise the legacy result can choke.Itry: raD _UnexpectedSuccess from None3 0Z.(self, sys.exc_info()'JelseF=addE!) def _callSetUpBn!.s 0TestMethod51, m )=(9aarDown7/l#te 6bCleanu`, func, /, *args, **kw S'(#"ru,=CSorig_=$9#if1 is7pdefault8R(.Bstarun = getattr(E8, ' !',o A8if $1not) no.I0 t , &._!FNameDif (*_class__, "__unit;_skip__", False) oroC,? >A# If{3 orP was z?ped*o_why ='why__', '' %orP QbuaddSkipD, 6ofinallP.stopereturnCing__ 17R (f5T%_0x/? = /or=outcome = _O  &._: Swith .PartExecutorGGelf.@) if outcome.success: !expecting_failure =  >EwithdtestPartExecutor(self, isTest=True)(`._call*pMethod(N )w ]False2arDown() _doCleanups(@for , reason in1~skippedS_addSkip(result,G e0feedErrorsToR4;1 =&if&.if N?2edFQ04AaddE2 JOelsel$UnSnUQ.D Brreturn +9zfinally$P.stop @ M^Brig_* is NonCRun = getattr7, '!',C gG7if 'k1not, ,- "#=licitly break reference cycle#e -> frame  .&]C 58L / U{pk.clear# G! =; :!# BD the, no more needed]#._b RGdef )2"""Qe allunup functions. Norm 0ed you after"teE."""vRor _O~#bwhile *2 P, args, kw+ =5G.popX"3all(*zB, **## Athis.0bac&ds compatibility'# even though welonger use it inter5ecEq@classm-1assCleanups(scls): 6"""Execute all class cleanup functions. Normally called for you afterNtearDownCGE."""Dcls.a_excepYU = []%`while +__s, args, kw/ =:e.pop()b?:tryPT (*LB, **V ;$ EH .append(sys.exc_info()) `def __Y__(self, dpreturn %H.run'dsOQdebugL 'Run the test without collecting errors in a TestResult{HsetUWqgetattrq,_cMethodName)C% 5*-1@skipjreasonASkip thisC `raise !D>CfailZmsg=None\Fail immediately,given messageva5ureG(msgassertFalseoexpr, Check that+ession is fE 0if # Smsg =fA"tMP, "%sM2notQ" % safe_repr(O)b?Tru.:truq0if %T8_\ , standardMsgkaHonourClong  ib when genera\!s.5:8If C1is c%Gmean* Use only an1TlicitU` if itprovidede* Otherwb1use?y: S/If$s , plus ' : ' and9expRTS.LT(orS if@\> return standardMsg Etry:  # don't switch to '{}' formatting in Python 2.X<it changes the way unicode input is handled:return '%s : %s' % (stae, msg)2except UZ De`ZErrorU Vafe_repr`E), sk!) mdef assertRaises(self, expected_ion, *args, **kw )"""Fail unless an 7 of classS+rv *!byY#callable when invoked with specified positional anFkeyword arguments. If a different type!is$2 , it will not be caught,ptest case&(beD`deemedcqhave su}d"iactly as8 an?$unQ.0If )9'an omitted,9ancontext object used like this::xIelf.BQSomeE7ion&4do_something(SAn op  'msg' can`provid#"isZas a L5The manager keep8!re6 cef6a6' ' attribute. This allows youJ intI@` after?ionc&cmo 6thee = cm.3>iEqual(= .e_6, 35"""IG= _AC( , uM Y.(('0 ',)3s, mfinallAbpo-23890: manu# break a +Icycl_b= NoneRMWarnwarning 4|Cis triggervFwl ? xd: depend;!onother  warning filter !rules in effect, it might be silenced, printed out, or raised as an exception. ,If called with the able and arguments omittrwill return aLcontext object u}like this::xsself.assertWarns(Some Xing):`4do_something()XAAn oal keywor 'msg' canC`providGhen s"isD HT9manager keeps a refer1 tobfirst matcp!as)'' attribute; similarly,$f Hame'Iw'lineno=s give you informaa aboutM2G of Python code from whic* wriggered.@This allowsvpto inspkAQafter?ion0//cm5 4GDthe_S= cm. /gEqual(9._e, 147)A5""" IF= _AC?0(ex $ed , vJ{E.handle(':90s',s, kwargs"3defPLogs(U@, lo=None, level y"""Fail unleslog message of5! *<*whigher is e3Bon *qQ_name.its children. IfiTdefaults toKAINFOQ'* &JCroot;aod musM ,bFyiele@cord6twos: `output`H0`re4&s`"Av0endJ G  be a listF[ 0ted d$Ab( ZcorresponALogRJsr|Example0T'foo''/')Iing.getL(> ).#('d'>?.bar').error('second7 E 2cm.1, [Z:foo:,)  'ERROR:foo.bar:second message']) 55""" # Lazy import to avoiding loggif it is not needed.Ffrom ._log: _AssertLogsContext-oreturn"a(self,rer, level) 8def _getVEqualityFunc5rfirst, !):5"""Get a detailed comparison functi or the types of wo args.NRs: A callable accept#(, msg=None) that willraise a failure exFaon if H3 != with a useful humanI1eadTerror! f#os F!# NOTE(gregory.p.smith): I considered isinstance1(ua # and vice versa. I optedeV ervative approach in casesubclasses are}intendedbJntheir superNK @s usa# eV. This means tesJ0subs won't automagiyBt. CallersMThould7"irspecific artSpama metho0i@desifpriate)R# See`iscuss)in http://bugs.python.org/issue2578B#yp6)=9d0er @lf._+__`s.get(){B#if3 erk g)yW, strC*$ = getattr 7!Mg._base& p#k"""The defaultAimplementa,VN s.&!if!r =YidardMsg = '%s %s' % _common_shorten_repr 4mCrformatM@(msg#anj 8R8UET:I N@Fail)wo object!un0 asermined by@E'=='  operator*o1iongetAssertEqua lityFunc(first, second) assertion_f&, msg=msg) 0Bdef 0NotEqual(self, \6aNone):7j"""Fail if the two objects are eM as determined by+E'!='G operator.5""" bif not3 !=@msg lf._formatMessage(msg, '%s == %s' % (safe_reprA%),kKL)J`raise S.failureExcep _Almos pplaces= Qdelta0/un(ir/difference rounded to given number of decimal D (default 7) and comparingKzero, or<0hatfGpbetween" is more tha E..a Not2tp (from )qusuallyHsame\as significant digits (measured O9+)Iw {"thy will automatic6a{L # 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 >rdMsg) X raise self.failureException(msg) def assertNotAlmostEqual(self, first, second, places=None, msg IMQdelta)%):*"""Fail if the two objects are e as determined by+%irDifference rounded to' given number of decimal D (default 7) and comparingKzero, or~0hatfGdpbetween" is less tha!.B@Note'tp (from ))usually noX sameas significant digits (measured O+)Otutomaticm.5""" ialta isANones*TypeError("specify ;Beboth")u = abs(f2 - # !ifB$==Cb> 7UeturnstandardMsg = '%s == %s within @(%s ]i)' % (IMafe_repr/),"# zE )=Jelse#iff 9= 7g (~n) != 0^rsrdsSK|H%5m@_formatMessage', gK4@Sequ`@seq16q2, seq_type"An3itymion for ordesgs (like lis nd tuples1For[purposesthis func, a valid_ &on'which can be indexed, has a length,operator$JArgs,R: TheK&P]Qe-Bseq2122y: The expected datatype of the sequences, or None if no =should be enforced.1 msg: Optional message to use on failure insteada list ofIadifferj5"""- if_ais not:!J1seq"u_name =2!._)__.@t isance(seq1,6)]a@raisT3lf.AExcep('First>q a %s: %s'|M % , safe_reprI1)))L2'oSecondO2Jelsep "%" 7Qing =:tryNlen1 = 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{  seq_type_naome)) mbreak if item1 != -2:#Mdiffering += ('\nFirst element %d:\n%s?' %NR((i,) + _common_shorten_repr(,) P~ elseif (len1 == len2 and seq_type is None%`(seq1)+>2))iP# The^uences are tame, but haveAR/s.{jreturn if01 >  %s contains %d additional '{'s.\n' % 9!_nY-?try' Vcextra qRNr2, safeC[]A except (TypeError, Index bNotImp!ed Unable to iOj oAof fcLq,Rw j$el<s \nSecond I!2 1\121szstandardMsg =o'P + e.join($(Plib.n (pprint.pformat 1).splitlines(),=A=2=&)) self._truncateMessage($,6Msgm:8Wmsg, =4.`fail(mKNdef {belf, m} @max_01 = RqmaxDiffO5if # or(7E) <=! ye + diff  return message + (DIFF_OMITTED % len(diff)) 1def assertListEqual(self, list12, msg=None):7;A"""A&-specific e@3itySBion.g0FArgs>c: The firstN to compare.l.2.osecond/ msg: Optionalto use on failure instead of aR)ofx|7werences5""".9.N@Sequ+RL, seq_type= RTuple<U0, t1(&>1d 1K R )Se# se"?set?set&`?setZ,- K 5ys 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)!ifPk4E1 or7ce2I-lines = []s'if@1M lines.append('Items in the first set but notsecond:') for item<difference1:%06linpPrepr(7)N6if A2A =   l  standardMsg = '\n'.join(self.fail( _formatMessage(msg, J1)) adef assertIn9, member, contain msg=None),"""Just like rG`True(a1b),with a nicer default mA.""" #if| &inw(!%s0Pfoundx%s' % (safe_%),iEEHDw(/Noz<E?in ~(zunexpectedly Be/ O#Ispexpr1, ?2,  s}"p21 i 2 , =1a?2<_IsNot`7!d ` identical: n-DictEqua, d1, dk|@IsIn1ce(1qict, 'Fdargumentba dictionaryiN!2,/A, 'S O  if d1 !w= d2: (standardMsg = '%s != %s' % _common_shorten_repr(d1, d2)Ddiff = ('\n' + `.join(Plib.n (4 pprint.pformat(d1).splitlines(),<2<*)) self._truncateMessage($ , C5Rfail(?=Wmsg, B1)) def assertDictContainsSubsetI1, s sctionary, msg=None)"""Checks whether di1 is a superset ofUA."""owarnings. /('LPdepre/d'D#BionWY/`missin\%[]mismatched = for key, value ingitems( if-@ not*(&.append(key Celift'!=L_[key]OR'%s, expected: `actual 5' %nR(safed&,  T5!if6(F or  fbreturnf1'UP 2 1MB ',',0m) Em in]z'if (if pf+= ';  MsiUQRCountEqua, first, secondEAs that two iterables have the same elements,number of times, without regard to order.-9xer(list() 3  Example- [0, 1, 1] and [1, ] compare eH.5'5 2#un45nD_seq 7 = , F:tryK = colle$s.[ second = collections.Counter(second_seq) except TypeError:!# Handle case with unhashable elements3differences = _c|__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 standardMsg#)) def assertLessEqual(self, a, b, msg=None):/3"""Just like ,.ATrue(a <= b), but with a nicerjault message."""Srif not =jnstandardMsg = '%s*less than or e to %s' % (safe_repr(a), 5b))r[relf.fai._formatMg(msg, ~2Greater0,>/(?> b.g1%cZ1>Z)=,]h Isw\?obj}Same aspobj is E/),:>5 i+ ~_obj),s;tkIncluded for symmetry Lnd unexpectedlyf'\:@IsIn}(ce?cls4isiIFKcls)?def O( %sM4an o of %r/ 1?NotM< !$Qg)) def assertRaisesRegex(self, expected_exceptionr)?, *args, **kw %):,A"""As s that the message in a r%d w matchesw%. LFArgsZ4: Ee classc to bep.U G!:  (re.Pattern object or string)W IMkPfoundTerror {/`: Functcalled antra posi 0al 1 Ct+ "amsg: O$alA use case of failure. Can only/%NwhenN2 isXacontext manager5"""U%2= _*C<(+, )Qsreturn X.handle('!',M", 3)i3defOWarn$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 not be empty."   expected_regex = re.compile($) 4zif not .search(text):,4standardMsg = "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 afunction.  This is useful 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 3K521doc;.__doc__%F,doc.split("\n")[0].strip() or1 Q _Sub6(): $!_cmessage, params ;3 = e! = #t" =}s self.failureException = test_case 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, eL_& =&gsuper(Q%).mg Ugetat , }G#!= 3nhdZ[Gure(h =w@0 R`_make_2ed_(}CoN0= '8o module: %s\n%s' % ToU I?CI+)sN0n, suiteClas@s): message = 'Failed to call load_tests:\n%s' % (traceback.format_exc(),) Kreturn _make_fM@(i" name, exception, suiteClass,o) defFomethodCB = __Test(D  ((A5,))bskippe!Wm`@case.;U(str( )tS\S(self:>ApassKattrs = {': 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,!PcB"""Ra@ 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_tests deprecaFtion via *args and **kws. See issue 16662. def loadTestsFromModule(self, module,M, pattern=NonX!):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 posi) 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_attribute _.pop(tb# Last so we can0 ituser if needed _make_failed(N , .CC/ot `0# Etop level  @: reC tha!Ss.append(6_ h'[1Sobj =31for1 ins+pparent,V =P, getIQ(obj,H oAlZ as eo1# WR't traverse somy^\Iif ('__path__'!)1notv7andZ/-`# This)a package (no z p lib docs), gwI# encountered aj[oCing.*Otell#difference betwee`.Wrong +L .w5_ Fjust -5is more informative.  self.errors.append(_message) , rreturn *Mcase&]else:B# Otherwise, we signal that an AttributeE has occurred.P, = _make_failed_test(Cpart, e, suiteClass,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 ;,s found within testCaseClass 5""" def shouldIncludeMethod(attrname):+>tif not .startswith(self.qBkPrefix?Creturn False\<Func = getc(,w)8callable5H|fullName = f'%s.Y' % (k .__module__,np.__qualD O HPatterns is None or \Dany(fnmatchcase(2, p@T) for O in e Fns = list(filter(,Q, dirv&))L"ifnsortTestjsUsing]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 hem. Only0filMAhat 6,U willMbe loaded. ( shell styleRERing.)dAmust be importAtop c2 ofuroject.Iq0]D2yKnKi%eparately.BIf a?package & (In '__init__=)`mj2theQ{#qchecked0a '_!' uion. Ifthis existsAn itLBalle  (J"ersg) unle"Ohas already had sB\yinvocation,|`which  hmH0 obPscannc%orO 2 - Ansur_@at wPaRTuses ;VurtheJQchild@`at infeqon doesjhappenXeay>S*not*Sej,Nis responsibleDing gsUHkage. < The pattern 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@Path1 e sorted before being impto 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 sB[firstK4in .minimise lihood offlicts between inst Pwd!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  # look 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#, 7return self.sui0teClass(tests) 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* a[is 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<*Qfind_L , space=Fals@"""UXpby discy. Yields W suites it loads.""p# Handl$e  J3is 1kAelf.(#R'.' when & @ (anf:bUP# def_U a%)."ifu != TP#in{ ds1V whilAcallt\jTQFromM 2s, B_recurser*:Y9+!ifs_G;Non^&yF) ma+ot A?# Either an error 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 filea 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, '_?__', full_pat[h)) realpath = _jython_aware_splitext(3B0os.6.?(mod_filec1fulco_noexti-N_|j4if .lower() != 32:module_dir = dirname(]G';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 = & " ==P_get__' >tryypackageOQ[( 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, True finally:(self._loading_packages.discard(name)9JelseGreturn None, False defaultTestLoader = "()#b _make!(prefix, sortUsing, suiteClass=_NamePattern)h.YqMethodsd& =p,i(P2 = %! =/'if :\V1 geV@Casei 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= 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. Simpler 0to 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 byF # print them anyway unless other warnings sett Ware # specified byJ5aarg 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 tha behavior is unchangand depends on{sed to -W =!swTest =  'testRunner = %ELoad% %progName = os.path.basename(argv[0])2arseArgs 0runAs() 6def usageExit(`, msg=)K if[F(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 = None  elif self.defaultTest is None: ## create"s will load tests fromIimodule;a(qNames =^"isinstance(.j, str)$R6)as ?MlistCB01() ^8defB,  _discovery=False, Loader=YPatternsE.." =| +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.!!= ~if self.catchbreak is None: parser.add_argument('-c', '--catch', dest='K)',DO action='store_true5phelp='Cv Ctrl-C and display results so far')Vself. = False$1if #obuffer 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 ((', 'pattern etop'):07parser.add_argument(arg, nargs='?',04 default=argO.SUPPRESS;Nhelp8%) tqreturn Xrdef _do_discovery(self,v, Loader=None".;U= '.'`# = '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.runWif self.exit:  :sys.exit(not self.result.wasSuccessful()) main = TestProgram # mock.py # tools for+ing and patching. # Maintained by Michael Foord # BackportCother versions of Python available frohttps://pypi.org/project/mock __all__ = ( s'Mock', HagicsentineltDEFAULT4ANY 5cal&create_autospec#IAsynkFILTER_DIR#aNonCal T_openDPropertyA0seaa) imba$iocontextlib intUpprin4sysbuiltins  a ppiscorouNfunction(Ttypes&CodeType, Modul Pethod3unittest.util;safe_repr$ewraps, partial _ = {namev tin dir(!P) if ".startswith('_')} !rue # WorkaroundXissue #12370 ithout this, the __class__ pies wouldn't be set correctly _super =  def _is_|_obj(obj):iinstance_8$is%, B<return FalseWrhasattr50'__{7__'6obj = get(HY'XS) or .isawait (%if|, '__code__', None(<)BelseV3Mj3@# caFuse s@ on 0 ob`s beca#they overrid&# The base =j1all@s isQ6k1sub7(K12VPexcep+LY &t, BaseE9*),5C(obj 2Aobj,d2(staticmethod, class M)UV4".__%if'!',m)v zis_list(obj): # c!hecks for list or tuples # XXXX badly named!return type(obj) in (@,> ) def _instance_callabl/:E"""Given an object, YTrue if theD is D.?For classes8ws would be=1"""@if not is-,)palready*@rgetattrA!'___', None)j  ;@# *c*broken by a overriding __mro____dict__ viaFaa metaAbasepobj,) +@.G0if ).UV.get( 6tTFalseset_signature(mock, original, F=4l # creates a function with I (*args, **kw ) that deleg;4to u. It still doesJc`!by a lambdavzAsame#;"as.skipfirst =R&WMPresul((_g'_((%, ^)B3if E!isc+K,# =4=sigVNsig.bind#E`_copy_b_details( $, Z)8% =0.__!__E.isidentifier(s@ = '^Aopy'9`contexH4{'_r5_':~0, '0': }5src = """-%sO !Fe !Q""" %++exec (src, $ =[]4a_setupYQAopy,@Gx93.! =XN!rt0ed_ FI.9 e`! 4 [$no + 8 ced_onced9 e' >kwargs) def assert_has_calls(*args, **kw C): return mock.76a1anya`6_`reset_(funcopy.methodys = _CallList()A+?ock) d.oCdret = I'e_value#if _is_instanceret) and not E!is^s:retwUned = FalspP_coun06_o = Non8@_lis< 7a^ 'Z 7! =. -side_effec +k_childrenZ  2Zt_with =(4o9>p0/ .6 = $ P*1not.|>2L_ a 4__signature__ = sigdelegate|0 s_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(_, /, N0get-..,)(1for c in ('}Aed',9  (s--721ny_**s++Red'):7 #2attr(mock, attribute, wrapper) causes late binding # hence at8 will always be the last value in7oopDUse partial(w,S) to ensurOlis boundKcorrectly.0set3W(mockW,s ) def _is_magic(name):Ureturn '__%s__' % [2:-2] == class _SentinelObject(oJ"A unique,5Cd, s. (!."r_init__(self0F. 8Crepr82r0.%sI zoreduceD!  ""Accesssa , usable as a)?.""$_hs = {}g# ]!ifp'__base g# Without this help(unittest.{P) raiIan exceptiond? $ AKUError! .setdefault,p())D' 3& =Y() DEFAULT = _missingMISSING _deletedDELETED _allowed_'_BP', '_O_side_effect',9) >fparentNDnew_= &$ }!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(list):~containslmot isinstance("#, L?.__[2lenEb = lenX) len_self = len(self)  if_value > !:!(return False for i in range(0,>! - UJ+ 1)Osub_list = l[i:i+len]`z6if .!= R M&ETrue>def __repr__J.pprint.pformat(*A) @check_and_set_parent(,, name, new_  = _extract_mock()Tif not _is_instance% Bif (K.2x2 or5 or& 61 is_None),0Sq/2 = :dwhile |# setting a 6 ) as a childqS` of 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`.B`"""Lz_(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',&')JM%A and2Q_obj(Yarg):  bases = (AsyncMockMixin, cls) " new = type(cls.__name__,?, {'__doc__':9.}Binstance = _safe_super(NonCallable|w`ew__(newBtreturn I! def __init__(self, spec=None, wraps  "B_set CSparen" _)Btate+Q _new B='',2 K>4as_=False, _eat_U un**kwargsL%): (ift@ is  2 = 9_dict__ = c_!['_mock_A&']LG *a( PA*/1basealed`q!if<?not@0pec)gu = TrueZ(z1addC(v|,YS)K children%{} (5% (delegate+{*alM |Pcall_U'+Qcount,0TB_lis-_VList(m `<s`3kmethod_0 c_ B2if  configure(1QpD/).B3pec7 , xx, _s#)battachy , X, attribute5"""DA8! a/f as an4 of this replacing itsE andJ . s to theKRached_will be recorded in&C``^ ``Ns.Qinnerqextract(J*. ! = 'Y + inner_mock._mock_name = '' Qinner.D_new'UNone *setattr(self, pibute, Z") )1def_add_spec/ , _set=False):\"""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_(Jclass = 8signaturZPasync;&[]@fttr in dir(ta 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_value35ret%}-y3elfGdelegate e V3._`3is DEFAULTOQchild(Cdpparent=!, F='()- ~/ tcG ret__c!, ojD_>" =cC : _check_andB.  , E) __return_value_doc = "The  to be returned when the mock is called." 'K = property(__get_E\, __sDH_@1) 2@hdef __class__(self):U0if b._spec%FNone%)R typeDC G = _delegating_"('!')M o_count0 #4Oargs3 " 2O_lisj 7'<_o#'side_effectEdCed =J!4if d EwHFsf =J.#`if (sfe@not P and rable(sf%isinstanc', _MockIter)G_is_exceptionLN8! @f'fh,= _try_iter(sQelf._n" =I;elsld re6/ visited=9,*,=False, M`"Restore>`objectbits initial stateP$if{~F U = [];Qif idD) inA 9,3H.append(?)Wj >_E! =@0ijCallList(} `*omethodRy)if p( = DEFAULTGF$Cfor childzAren.'s(Nt-, _SpecSD&) Ws8ted continGue child.reset_mock(visited, return_value= , side_effect= %) [ret = self.W_A&if _is_instance*(ret) andq is notI:7?ret") def configurW, /, **kwargs)Q """Set attributes on the  through keyword arguments.mA;@plusAurn =s( 4s can be setjts using dard dot QationO`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 ew:0get2R(obj, `s #__E2__(Gname0if !{'_Cs', unsafe'}eraise (LAelifLZfJNoneT/in;%or_all_magicsFB"Mock object haa %r" %^ 4h mi U R I&ame.startswith(('assertmassretRZ Z Y ,J1"or4"x;sul{_rren.get2Qif re2is _deletedPWHG@wrapm| ', 1# XXXX should1get7P out triggering code  # execution?  wraps = getattr(self._mock_, name) 9result = .get_child8(+hpparent=-O=T!, a=p, _new_ E J !)i@ren[ZR] = elif isinstance( , _SpecState):^! = create_autospec*.,x E_sety,e7?0 +(creturn def _extract @_lis[q]_.\'(!laML doa5'.''8if }= ['()']7'Idwhile is not None9(?w.append('lj + dotR C0== 3I$ =Pa0 = (reversed()A_firXame or ' 8lenGJ > 1&=1[1]@in (,'.'i8+= 0[0],i''.joi|_repr__*_string = '.,6 +Gxa=%r' %  P) p>!._"oclass $ o=k#if #H* L )%e".__@"<%s id='%s'>" % zBtypeF \i  "idQ)-?_di@"""Filter the output of `dir( )` to only useful members."""j!if?FILTER_DIRobject.__dir__(self)3 extras = self._mock_methods or []*from_type = dir( (6*))$dict = list 0.__+__(Qchildr[Em_name for , m_value inEren.items(cF&if6s not _deleted][se!if<e.startswith('_')= = DD9 or_is_magic(eireturn sorted(set(&+  x 'l2)) def __setattr__ , x!, k%):in _alloweds## property setters go through hereR/object. 9Qelif `._specH andi@None#D} Q;?and/   raise AttributeError("Mock 0 ha v# '%s'" %{uaunsupp zmsg = 'Attempting to 9 P S %r.'u ?msg?all/if [_ is_instance%({.2C_get:(D7@original =g !}Bambda *args, **kw: =, iNelse>Q# onlQ _new s1at calls is trackeQ# but=U2 _check_andb_paren& , K fu*1@ren[]se== '__class__';m! G?if   d> sealed and not hasattr(self, name): Pmock_` = f'{(._extract_P()}.{&)}'>raise AttributeError(f'Cannot set {DE}') =return object.__set'__, value) 7def __del)!if in _all_magics andAtypef).__dict__c():@j2in 9P.a# for methods that are still MSProxy tJr[on the instance it 1kDASobj =children.get(, _missing)N _safe_super(NonCallableMock,stmc@elif@ is Jetedo EC' G1del.[J]M"% =Sforma4c|signaturn, args, kwv @or 'q# _i d5 dfailure_messag, action='f'4 = 'expected %s mfound.\nE: %s\nActual :u_string_y_C5=%C#aj*D{2% ( +, 93ualp ;getQ_from~g5"""P* If #Aects;Passer0aga # a_A/funP like4.x1P1the@re could be no&[o to lookup. HeoEjustN!5Fspec1 of}&od be .QObPemptyOn remove ()split by '.'&ge@listIsiterate throughP  until a potentialPmatch" A5 @creaqonly duu accessMso if we get a _SpecSt en;s YS wereM%edO0cansafely exited.# 5""" if not name:( return self._spec_signature )sig = NoneJ1s =R.replace('()', '').split('.')2children =nTmock_m1forV1 ins11 = ren.get(j"if"1 is or isinstance(>, _SpecState)fCUbreak;els?# If an autoBced object}attached using _6 thPI# would be a function with :_ asPribute fromOewhich p has toZderived.5 = _extract3 eb- ..$L+/q2ig def _call_matcher(,Given a 7 (or simply(args, kw) tuple), wa comparison key suitable QotherksQAThis best effort method relies on &'s,if avail,falls back=argumentsKgmselveN Y, and len(Z) > 2Q._get'__A6[0]4@MI: ifH (if,==DU = '' . %7Q/, =:try<Qbound8 ig.bind(*M#** 7&, I.=Fexcept TypeError as i e._eh({ 8assert_no+!ed $P thatswas nevW_count != 0v ms("Expected '%s'Rhave beened. Called %s times.%sJt!% ''-8' Is_repr())zKqraise A\ionError(msg)  def assert_called(self):!2"""  that the mock was 2 at least once9 0if W.1_count == 0fjmsg = ("Expected '%s' to have beenqE." %[: .__name or '9'))0qraise AionError(msg) ' _^Aonly.X5""" oif not1$m! C %s times.%su!% 2,- ' Rs_repr()-Awith, /, *args, **kw  l{Pmade Nspecified arguments.R)Ks an-1 if>| and keyworE0s p1vd in ardifferentG!toN.!plzis Nonee1=Lr_format _signature(F#, 6 actual = '7Ied.'#e)_message'{0found.\nq: %s\nA] Re4% (K", 1 O_(#"m^ /tfailure0return msg$ _matcher(_(R, two=TrueEW#if7D != '@causisinstanceException) elser=@ pq) from v SmY_$3ed exactu!at<+wx {!be/edm self._calls_repr()))  raise AssertionError(msg&return self.a(Ped_with(*args, **kw 1) `Cdef .1has2 s(D!, , any_order=False):82"""; the mock has been=0ed {specified%s.EPThe `<|` list is checked forB.~EIf ``2 (default):nw must be~sequential. There can be extra5before or afteA @Trueo inh hU, butGBtheyall appear in4E."""1expected = [W_matcher(c)RcDS]:cause = next((e(e(Sif isinstance(e, Excep)), None2all = _CallList[N`if not% 5if 'O *.!is"&problem = 'sufound.'3)OelseG !(' processing>.\nZ^Ds: {}').format(1 ?[e   L]q^3f'{m}3f'E6: {N7/)}61f'{OW prefix="Actual").rstrip("."Gq) from . m()%Anot_Awk%in L:trydb.remove(D ea Value|F.[+ndFw =r'%r doe=RcontaQ of %1itsg., '3.stead' % H*1nam')',)etuple(5), Q E 5\, /, i70 has been called with the specified arguments. The assert pAs if7mock has *ever* been ca\, unlikeE`:2rt__{k` and Concethat onlyw5 ifMI3 isst recen1Ue.""",expected = self. _matcher(_Call((args, kw), two=True))Gcause = Oif isinstance(, Exception) else Nonactual = [c) for c in_e_list]2if &or0not9_AnyComparer(o%)::u_stringpformat_$signature Mqraise AionError("s1'%s found' % 6b) from def _get_child(F, /, **kw"""Create1 sbattributesreturn value.By default @bwill bXsame typiv&ntDPSubcl`s of M/may want to overridMo customizUe wayare madeFor non-2Cable(@variyused (rather thanm3any# s)T`_new_n= kw.get(""55if .__dict__['_x_asyncs']A9( S_x= v$is()p, MagicI) _method_m*sa# Any hronous 'a becomH Hk/ =!elC GWMixinNKif (0ll_$9 or5z L$ ~I r 76 onx  "< ~4%4N_Q15Non4 7\?ockbv*se'.__mro__[1]#"ifG+_sealed:  attribute = "." + kw["name"] if  in kw else "()" <Pmock_2 = self._extract_U() + k >traise AeError(9%) -return klass(**kw) def _calls_repr(, prefix="C5"):H"""Rendersl? as a string.\Example: "\nN0: [0Q(1), V2)]."1-IfZis empty, an hB is ued. The output will be truncatedpvery lo&""lif not0u 6Rf"\n{>}: {safeX.. )} _MOCK_SIG = inspect.signature(No3ableMock.__init__c _AnyComparer(listP"""A  which checksit contain#may have anFargument of ANY, flipping the components item and5Q 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.;* =trytzsQ Type/# XXXX backwardsuatibility=# but thislow up on firstf -r maybe we should fail early?O" fMixin(Base):v=l, side_effect]_value=DEFAULT,{Swraps3 [4_seMn D_.Ctate?A_newkQ='', C Cargs:;.__dict__['C'] =_isuper(A,&)(3rQpec,  , ", Bet, 16,k'_mock_check_ sig(self, /, *args, **kw C): # stub method that can be replaced with one a specific signatureNapass def __call__can't use  in-case a function /we are mocking4s5z# in the] ._;p_check_* !I.increment8Oall(3areturnh0(&p `execute q#.ed = Tru_count += 1phandle =_zneeds tolset here so asserAs on:P argu~ s aW befou"# "9of awaitedFs|P = _Cr(#, `, two=)0+9_list.append(j)pinitialvcff for*s2do_( =Pparent is not Non5Z_name9 2ocksR!ewAis_aA! = # == '()'+X]s50'',s)Ifollow upchain ofsGS_new_/ Chwhile 2a:7pw#;if R m.J JM z K, p} + '.' +_qFthiso5NU ( |gz az~(if'O`5if Qvdot = 'Oelse3 .4 is_a_call = _new_parent._mockname == '()' &Rcall_'D + dot + 4 T# follow the al chain:)!adef _execute(self, /, *args, **kw )n # separate from _incrementH so that awaited functions are## dT"lyV`their , also AsyncMock overrides this methodeffect = b.side_w2if  is not NoneEif _is_excep(1&SraisePbAelif^_OableE@esulDnext' NR r7.# K;els/L# =(a.2if ZCzDEFAULTF*creturn.E"if4%o_valueR ); 5YTwrapsRCO12  class P(Call`Mixin,a3ock1"""0CreNpa new `@` object.takes several opal arguzsHrqspecify1behaviour of\[:30* `2@`: TMcan be either a list=strings or an existingK1 (a" or instance)Pcts a e oPificaXA forOC. IfPPyou pU inx0n isNamed by:cdir onOEDp(exclud#unsuppormagic attributes andbs). AccessingQ6any-"in9Rwill Tan `AWrError`.C If#anA (ra?thaZe`?1.__B__` q~a.a`sGB tov4`iss` tests6_set`: A cter varian3X` used,)1emp8to *set*G`or getz oIeDTisn'tDed at |!ct`: A function to be called whenever the Mock isq. See *`side_effect` attribute. Useful for raising exceptions orD`dynamixpy chang)return values. The func;Q with4samarguments asmock, and unless it _s `DEFAULT`,+| of this~Dused^3#. ;:If is an iterablelan eachSzIS willMBnextdP fromAN. If anye membersuN8areBtheyt!beed insteadA#ed2* `_!`: ;7By defaultYB newf (created on first access)vW< w* `wraps`: ItemI`objectw$@.\rnot NonnC2pasc throughW'[pmH(?K0reasult). A;Jq># aN@hat torrespondlS) soH@empt5$to an tidoesn't exist@Ce an`sError`)C !haexplicit_@ setn' s x#edi to#f '&isp* `name0&e  e1be  inS repr[>nYuPdebug"e_is propagtto chilNsYn als arbitrary keyword m$se!toi%syPafter4.<!""" def _dot_lookup(thing, comp, import_path):52try ?0get|;)-.J?#__`#_( i;_ 8er(target!onD"= .split('.'9! =1b.pop(0$ ? = p7 inGi+= ".%s" %+@i6return thing c lass _patch(object): attribute_name = Noner_active6res = []4def __init__(,Jself, getter,\, new, spec, create,8pec_set, auto(new_callable, kwargs5%): if^+q is not%) zDEFAULT#'raise ValueError"@"Canguse 'new' and ' together";)%if2Q.# = E& = #Pnew = 0  )! =C O# =X has_local = FalsUwY @= !, =_additionalErFEGPcopy(-Der =.-!, ~l@elf. i3.$(* {._7 ?58(!p.;) for p in ;7] sreturn p r!__g, funcif isinstance(g, type#^decorate_c4%Pnt.iscoroutineX6- [Uasync77 W, 60, kruLdir( l!ot .startswith(r.TEST_PREFIXW7continueq _vzhV.1has(=A, "_+?__"|ybp0setd,_(~)<@sextlib. qmanagerl/ion_helper0d, %, keywargs):  extra_args = [] with contextlib.ExitStack() as exit_s:3:for patching in 4ed.s/3Warg =Qs.enter_|(:)h9"if_ing.attribute_name is not Noneq<@keyw.update(arga(elc0newXDEFAULTWNr.appendY w += tuple(2 `yield ?4s, 1) Kdef decorate_callable(self, func)# NB. Keep the methodQsync JaP`if hasd(_4, ''s'lY O(areturna@wrapsd.o@ed(*=E, **Am.ion_helperI1ed,B- l.1(ne_U, new %(*4* 6_Q*/ ?5*/j 5QawaitA;Lget_originaletarget = H.getter( ?V3 = Wolocal = False2:tryFC.__dict__[}except (A*Error, Key X0get(` , X,;elsm7Tru!ifB _builtins and isinstancekModuleTypeocreate = a"ot#_ is DEFAULT:' raise AttributeError("-"%s does not have the a6 %r" % (target, name)E return original, local /def __enter__(self):""Perform~patch."""!new, specp_set = F.Celf.  %ABauto dkwargs>M6new_callable2)=$(getter()# normalFalse to NoneG!ifA is !"@/ =26:::6U and 1iO 3Typa"Can't1ify J"^Qif ((^? orv)F=in (True,M)+provide expliciSR*and*" $_*`if newpDEFAULT [`inheri; X  # R^!toobject we are replacingW:4= {(?is I&M( #elk7#'%j M g ?" h8 %ifAJ(Puse 'n' with create=Aif isinstance(k, typec/# If we're ing out a classPthereac !D #DS_is_async_objK0= A-IMock[NelseP4]Magic4_cY = {}Mo dnew_callable   elif spec is not None orH_set%: 8 Qthis_?=2 !^JQ N6R_is_list(1)Qnot_callable = '_1__'5in A gOelseU5d Q0if async_obj,hKlass = A2MMockSI CNonC QMagicT U _kwargs['?'] HL/P  # add a name to mocks"if (isinstance(A, type) and,`issubcg,#1ock7 self.attributek 3 ..update(N)anew = 3(**1)Gif inherit\_O(new # we can only tell if the > should b(<# A# a  %d*F.- N( ql-=not@_(6:M4 =9^ .a.pop('/ $new.return_value(_new_parent=new, Fo='()',R UM@auto Uignored, `*must*4default,Ljtreate# as a boolean. SwAheck@<AthatZ #,O?!ifzDEFAULTraise TypeError(D!"!cs:o for you. Can'_ify "H 0and.( if original"use 'autospec' with create=True") spec_set = bool( &pif auto@ is H:GR"= original %Snew =_.( , _= ,?d_name=self.attribute, **kwargsRelif  # can't keyword ; when we are Ding the mock# XXXX If is a Mock@could call.configure_E(raise TypeError("CCpassQ to ad &")z@new_ =3Ttemp_ &is_local = _exit_stackontextlib.ExitS(:try0set(Ktarget, H+if) not Nonek4aextra_E= {}T~DEFAULTH,L[A] = r+for patchM#indditional_?ersuRarg =4y.enter_c}(C:ing0%if.8.update(ar_vreturn .pF5newyjexcept0if U__(*sys.exc_info())3^5qEdef :H4, *<:q"""Undo4E.""" 2andz 7!is,.T;els0del2 ?O e (d?hasM5 orPB in ('__doc__', '__moduleDP Dpefaults;I`annota$N6kwdP=# needed  roxy objects like django&]tings&J?del^? exit_stack = self._exit# ?delvreturn 7"._D_(*exc_info) Mdef start(l!):e"""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 failYBNone#&,  _get_target( , attribute = .rsplit('.', 1B(Typ,_Uaise &("Need a valid`2 to. You supplied: %r" %S",) getter = lambda: _importer)'P." ,u_object(| /, new=DEFAULT, spec={3b=False!B_set%_ auto4new_callable***kwargsXYT[0namqember (`P`) on2 (``) with a\".e`[.` can be uss a decorator, class or a contextY manager. Arguments `new`, `, (!`,<`)Q` and8!a` havesame meanbs for r`. LikeMf  takes arbitrary keyword aPconfiguringN %3 itsDGWhen3 (shonours.TEST_PREFIX`o@hooswhich methods?Qwrap.(tif typeg is str=[2f"{(p!r} musidactual toMed, not aftm]sq3 qH,i#6,Y+(, E tmultipl*c}}@Perform  es in a single call.% It takes the object to be patched (either as an'or a string3XfetchGby importing)O and keyword arguments for7mAs:: -Bwith.multiple(setR s, FIRST_PATCH='one', SECONDetwo'):NR2..._Use `DEFAULT`value if you want `~`Rcreat!Bmockyou. In this case+"d ( are passed into a decoratedfunction by( , 5Aa diary is returned when!isOui context manager vcan be 8or, class1or Xn\G The`spec`, @_set !`,9Q`auto&`new_callable` havKsame meanpau `.tsX@willpappliedR*all*Qpes donekFW\   6 honours TEaREFIX`Pchooswhich methodsQwrap.(1"""if type(target)6strgetter = lambda: _o$er3GOelse5^if not kwargs4praise VaError(XN'Must supply at least [  'L#B# ne in a list&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=T=Nonef=False%"**w5`` actsu%a l"RInsid qbody ofwU"oruPstateo, the `target` ' is patched with a `new` object. When the function/'statement exits K&LUundone. #IfVis omitted,UZ`target5ereplacn=`AsyncMock if69@an a&R or a?AMagi?` otherwise. `@used as a decorat?%ndJ created mEsDi an extra argu& toGb%edcontext managerDzL~returned by$ 8`j` should be a string iform `'package.module.ClassName'`. The|Nis impor1andspecifiedI +hJ1, s% Y@must^able fromaqenviron]byou ar@call`1 Pgis execudnot at!tion timPThe ` `  _set` keyword s1 pa/& `xfione for youpIn addiA canY`=True` , which cause-2 to? 0 be~j$/_` allows0to 30ifyhPifferAc],6Q, that will " ede rBy default :NF /sjCrestA more powerful#Bm ofnb` `auto`6sett{YVda/ P.NAll attributes[also hav1$correspondingLH#xr Method:s.H~d{'irPcheckTn|pll rais`TypeError` ifMAthey9!wrong signature. Forss"a eK2ir 2 value (J'instance')R same!asrNpInstead-b=some_U`uarbitraryj `fail to replace a8ttributes that don't exist. If you pass in `create=True`, and the aGU doesC, patch willK> 31fordAwhen5ed function is calledrJdelete it again afterwards. This4puseful `writing tests3!stIayour produ|Rcode s at runtime. Itdaoff byJdefault becauscan be dangerous. Withswitched on*eKo C APIactually!! ;PrO be used as a `TestCase` cldecoratorVworksAeach5p method2theDjQreducAe boilerplat>XJs share a common+ings set. `q` finds=P look1namat start whD.TEST_PREFIX`.K4By t-`_`, which mFRe way `unit"sM@You pspecify an alternative prefix bycontext manager,statement. HereDNB)Papplio indented block; N IfL@"as"( Pobjecq ll0bouj`IE`; very%ifa m_Byou.B` takes arbitrary keyword argu 1eseYQed to`AsyncMock` if@is a$hronous, to `Magi6Fotherwise or @new_AableY9ied.dict(...)`,.multiple`.r_PavailgvS-case1"""wgetter,= _get_target(),return _E(  Cp, new, ,(,._set, auto/r, kwargB) u_ !):T( a "pionary,}b like <5b resto7Vto its originalB&te!in`buor a mapp@aineffQu'tpit must`least support oEing,<Aand cBitem<plus iterab@over salso be a string specify the name of dictionary, which willn be fetched by importHAit. +`values` ca.&a Se to set inW#$. ANE@alsoxan iterablq`(key, P)` pairsIf `clear` is Truef k1be +Aefor+A new^Ps are_p`patch.called with arbitrary keyword argumentsa "::O~6th t('sys.modules', my =Mock(), other_!):nN/..!be used as a context manager, decorator or classWh. WhenB$7 ;bhonourCTEST_PREFIX` fe@hoosaq methodBQwrap.2"""-def __init__(self, in_( s= =False, **kwargs":.9$ =Ck=P# supE anyHyP(...)DstructorBa[=,)#.update( #" = _original = None %%fif isinstance(f, type qreturn !e_&(f@spinner(*t~ ]V_(R|:tryfW"f l;o)unq;Y_A Eh, klasH@attrLdir( _` = get) , @if (p.startsi(.9U) ande0has;@rR, "__ +")3Xor =  ,s  OFed =2s&ed0`s__enter@"""P.C i"!p#r ( =. s:^'trG}!er9in_dict = self.in_dict clear = self.  Etry: 0original = Hu.copy()&except AttributeErrorE #  like object with no Mu methodRx# must support iteration over keys/){}!fo/4 in m>V[key]M/_+4 = >1if P b_(D)4 r#.update(valueso5Uq(s '2 = ' def _unpatch5)JB}cR n_M+aO@_exit__(w, *args B"""U?A the6E."""!"if is not Nonea.return FalseQstart Activate a ", Aing any created mockeresult_enter__>_Q0._acees.appendu U "op+"""Stop an [ { bremovebV!If hasn't been fed this will failYNH#,A) u |v = list,(r4del#_stopall({)lles. LIFO to unroll nes~G%esreversed(u3.(M"= ?_ multiple !f al]X TEST_PREFIX = 'test' magic_4Qs = (; "lt le gt ge eq ne " "getitem s1del " "len contains iter hash 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 ceilbool nexNdfspatha4) B = (add sub mul mat2dive lshift r xor or powediv" ) inplace = ' '.join('i%s' % n for n inD.split()) right6r6P # no(cluding __prepare__, __ancechecksubclass` # (asy are meta hods) # __del__ it supported at all ax s problems if it exists _non_defaults = {|'__get__', '__s ddeletereversedpmissingGWreduc1 ex#[Dwnitargs4newHfgetsta{sgetformaFDreprh%di }e;4get } def +method(name, func):u"Turns a callable object (like a mock)]o a real>Btion/b]self, /, *c, **kwgrareturn?(+(I0.__P__ = >" _magic%# %7/1 inD\[=_%s,Y#, !, Z$])kN0# Mt`as usedfasync `with` qments _gA"__aOQ__", 5xit \__"} q th:rre onlyt gQs butqhronoussmselves _"L L.| Jb _allk\1+& 9$| wU _unKT 6att<$etm<4newq&',*'st 3 .'*p_calculP_valuf__': lambda :}2.__()s3str__(self),  '__sizeof__': lambda self: object.!(`), 8nfspath8rf"{type..__name__}/{?._extract_mockr()}/{id0 }", } _return_values = {v!ltrNotImplementedg /le<  "in[1lcontainsTUFalse1len02exi@ ) cox-%1j.Bfloa/&1.DAbool*6TrulCindeA@ao} def _get_eql:T_eq__(other)0ret! =!._&.H14if 4is not DEFAULTT'<+>#A is 52I n\/ne$if U;"3 Niter?__( # KLE([]);'# =was already an -ator, then calling ow shouldMg1the'> unchange(&`( __'__>QasyncDa.E $F3 _A@Iter(Un(- _side_effeYethodi$':2[mn1terb2r5az9set(1, m , Cfixed = /`s.get(&,r2if 1b.Bue =4n  p_calcule=FNoneG' =' e!orUE+n side_effector = _side_ _methods.get(name) if %or is not None:"&<.** =8(mock) class MagicMixin(Base)Ldef __init__(self, /, *args, **kw(t ._W`_set_mQs() # make  work for kwF@ in __safe_super( , ^%).<$3fixbroken by upper level J [Corigs | _async!U!Sthese7 = Dy$if getattro"R1s",)Ae.intersection^,\)IWremovBset( "8 - ZPentry Eu\5if +Atypendict__19"# V unneeded,7delvt # don't overwrite existing 6`ibutescalled a second timep) ="0 - a_9 [ Th "s\J,[,aProxy(nNonCallable9ock!Yw"""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 be1286pec2,A NZ M* M40ockRa subAof Mock with default implementations of mostthe magic methods. You can use MMock without having toJconfigure I yourself. + IfV,`spec` or _set` argusOn *only*D that exist in, N will be createdyAttributes and.return value5a ``G@alsoL1s`.1""" deGpck_add_(,=False):3}"""Add a( to a mock.`{`eitheran object*aElof strings. Only ao\Tbe fetched a3Afrom#"If` is Tru n v tbe set.2N$ ._c86pec2),Aset_s() classProxy(Baf__init__name, parenta0 =  z/# =8]``Rentry = ZSNmf._get_childa=Ww, _new_@Z4o=at(#, gm"_/_/,m/,'& m)_obj, _type=Non:]PAsyncXMixinawait_count = _delegating_property('$'Oargs5 # 4_n 9((') @/, *(`, **kw Ksuper(). +# iscoroutinefunc() checks _is_ {say if anKoUis a 63. WBthisY it looksJ eeJ it!$# /r, whichJ0aseIis not (sinc )1# Ip set through __dict__ becaAwhenl , %"likely undefinInc)['Z`'] = a5io.:)s.%s JN0/7.None se%lf.__dict__['_mock_await_args_list'] = _CallList() Acode2` = Non" ableMock(spec_set=CodeType7.co_flags = in2t.CO_COROUTINEi*se_z_  /async def _execut`_call(H`, /, *`, **kw !):< # This is nearly just like super(), except for ial handlingHof coroutinesaQ ((#, , two=Tru..count += 1gJX .append()effect = URside_N2if   ote<rif _is_#Bion(1b&SraisePbelif not RE:tryAPresulDnext@ g& StopIterationP@# It impossible to propogate aE jn# through because of PEP 479<.A -  W# K%is@funcK&E1 = (j es?;C D3if zot DEFAULTCturn."if0_re%`_valueR); 5YBwrapX8nA}v 0=b;5r2 wbassertD!eds5"""LA* that the B wased at least once.8Dt_!J== 0msg = f"Expected {name or ' '}have been.<6ionError(msgM_ *exactly   1sg = (f"Expe cted {self._mock_name or ''} to have been awai1once." Cf" A%V3_count} times."): raise AssertionError(msg) 'Qdef a_Led_with(, /, *args, **kw !):7&""` that the lastP was Sspecified arguments.Q0if ._z is NoneAexpef=0r_formatncall_signature(F#, vF%4f'E]4: {nS}\nNo3ed'LJP _ee_message(3"Omsg ufailure7@, ac!=''eturn msgfk matcher(_Call(, two=True)_oactualE 5 if84!= fcause  if isinstance(5p, Excepa) else q) from v$ w2ed exactly bO and2not_Z == 1ch5(f"3yrX "ny&!e has everA..[b_c) for c in]e_list]"ifHin _AnyComparer(p 2o_strin &S3'%sfound' % 70 2hasfsgs, any_order=False):  B"""  Assert the mock has been awaited withspecified calls.CThe :attr:`5_args_list`  is checked forM)5s. EIf `any_order`3pFalse (default);ns must beFsequential. There can be extra before or afteA@True qqin any U, butcBtheyall appear inChPexpec= [self.__matcher(c)jcX%s]cause = next((e(e(Sif isinstance(e, Exception)), None)NBall_* = _CallList( 7,T`if not?:n5if 'i +/!is"&problem = 'Asyfound.'.OelseH ('Error processingNs.\n[_Es: {}').format(1 ?[e  L#]qSraiseN1ion3f'{o}3f'E6: {V)6Actual: {a}nq) from ! freturn ()'Anot_5F = [sk%in @:tryWc.remove(E {ea ValuetG.l+ndFn =1'%r-E' % (tuple(*), Qdef a_61!edW)awas never0/edM7if 1count != 0jmsg = (f"g_8A_namS'Q'} toIhaveP.{U1f" x#edU_} times."53msgBreset_mock(self, /, *args, **kw C): 5""" See :func:`.Mock.reset_mock()`'3xsuper()* l8self.await_count = 0 = None@_lis@ _CallList() class Async( cMixin,Cagic& Enhance :M :`# ` with features allowing to @an az Aation. &ThM ` object will behave so the!is?recognized as eQ, and7result of a call i/pRable:1>>># =kiscoroutine()"2Tru+nspect.isd+'()-u ``RD()`` 8b whichRutcom}of ``side_effect`` or ``return_value``>- i/,? ~Q& FthatBjpn exceplGaisek3] @iter}\]Qnext (0`Ehowever,8Pseque$of exhausted, ``StopIrd immediately, not definR}8= by 0, h,default-Gus a new  IfX" oO MP obtaQ whens&G!is"edbJ C it (7o R )test author c.@lso ify a wrappedE ```s``. IBcase y"0ior9"@sameS!an9a:+sAmay Zbmethodi@f s0Basn Martin Richard's0pro.\R_ANY(zA helper(\PcompamPequaljything."Wdef __eq__(q, otherW return True def __ne__(self, other):!return Fals3Crepr5. '' ANY = _ANY() oformat_call_signature(name, args, kwXmessage = '%s(%%s)' % /N@ted_4&'p_string, '.join([(arg) forq0 in1s])9}; `'%s=%r(key, valueQXMr.items(`g!ifuhq #if  ; if4matV Zb+= ', -g0%qclass _Call(tuple1"""!A :P holdthe results of a  to a mock, eiR+L`1o` or `K"`.Iv( are empty then{ will comp%qqual toyawithout thoses. This makes>isons less verbose::z, ('', (), {})) == ;-/1,/] (1,)4Y'a': 'b'a{",)QThe `` object provides a useful shortcut#P(1, 2r3], a=3@'foo<H.foo@ Ifq has no2Bn itmatch any.:_new__(cls=CP='', nt=None, two=&,Hfrom_kall=y3 = E= {}G_len = len(h2if := 3 N" =='el?2?first, second:if isinstance(0t;'1 = $~ Hq,])*5+ PJelse8[:6jy G1{,@)s@ $w{"= args = vaWlue Yelse:kwargs = va1 jif two0 return tuple.__new__(cls, (E", M5)) G3lname, 9:def __init__(self,P=(), 8=None, parent two=False,Dfrom_kall=True)]p._mock_X! =_Al# =u#f5 =  %eqWother6tryAlen_%q = len( )xexcept TypeError=xNotImplemented\%''T!ifjj) == 2U_ 0 = Ehn,*CDif (getattr'0', d) and ( /, )Y9WA != F :ZjQ7= = R:= 0R7S T%{}"elK3K,g WV1V#, 8 if isinstance() 2-wk#&p(stD)K n zQgDF = ( #C n# could be (,D) orZePfirstzOcond0Z* lp  sew,52( Z? 6DPV LHUKG."if j!OL L # this order is important for ANY to work! return (other_args, kw) == (self ! H__ne__ = object.def __call__H`, /, *\C, **J:I0if c._mock_name is None$(_Call(('', SQ , ;b='()')5- =a + ( [ hY, parent=2)ugetattr )"s=I, from_kall=False)$ = '%s.%s' %\ , B1 >= oa_ibutew in tuple.__dict__raise AttrNUError@w2getarguments 2len2dI;els<45$N@property+\$?r/._O)[0]P*R1RT__rep G8noti#IP or '4')!if.startswith(x&WD M;?if  -P", SU!ot 5!'el9,']n'fbc_formaysignature(= Mb\_list"""For a "r` that  es multiple%@s, `-O`@s a g of all the intermediatB as well5theDQfinaleE."""vals = []\thingbwhile 0is 1"if"Gv.append(thing) thing =._mock_parent return _CallList(reversed(vals)) call =#(from_kall=False def create_autospec( , B_set,, instancee=None,R_name **kwargs):+A"""Cv0 a object ustanotherAas a. Attributes on theNBwill use correspondP65 ```QtheirL!. Functions or methods beRr1ed t1havuir arguments checkedH"toP that`y are D thct signature"If` is Truqn attempt`to set!ndon't exis76Nraise an `cfError`pa classUused  value of(FS)IQ same. You can asY[@ for[Laby pasQ`=<c`. The!edN bonly buable ifs&'`L` also takes arbitrary keyword0Qed tothe constructorfA.""",if _is_l k#D!'t0 a #0 toO lRas itbhKinterpretOof strings+1ypeT)Wis_type = is , )@is_async_func /)_XP = {'q!'::}Ff :x 2 62eli8< # 2 we/with a normal3out u5andk0['_D_as_-A'] =P).update(lK= MagicMockpect.isdatadescriptorZ&# "s NO`# beca#we'aknow wCtheyt6{ |qRuntime3("I@ not\ when AL1"isj1an   ";pAp_/ gKlass = NonCallableMagicMock elif is_type and instanc Tnot _P_callBq(spec):@DKlass = NonC#e&_name = _kwargs.pop('1', #) (!ew, if _parent isfe|# for a top level object no _nNshould be setT B= ''qmock = (u=}#ew =P,cg!same, **f], FunctionTypesl## only happen at thebecause we don'# recurse7fes_set_signature(!, *p_async_HA#up?D)>7elsg_checkmg , 4,,26NonL. ._X_children[l1] =o\O 'return_value'  pg.* = create_auto ._=TrueCX@='()P/#entry in dir{Ua@is_m()s%#  already doeswquseful > methods_uXEcontinueh# XXXX doneed a better way of getting attributes withouptrigger(code execu= (?) Probably-j1aactual<!toQ it sw?srather o a property than3La!descriptor. LikewiTwant oout dynamijyL`provid .Fpwhat abE.t raoPexcep2s o7hanFA\Error on beTfetched?+Awe cbe resili0aga+ it, or catch4Pagate0GP whenzQ from@6tryqoriginal =8", 9w KP = {'4': o}Y!if% O =! ABRsI(f0new3SpecState7spec_set, mock, entry, instance) `mock.__children[1u] = new-Uelse:Bparent = > Tif isp(spec, FunctionTypes)J N.S Tskipfirsq`_must_], is_typkwargs['_eat_self'=O ecoroutinef(original5_klass = AsyncMockV; :NMagi:gnew = *(u=s, name=W_new_ r /HO2 "**LB$_check_signature[,m%, = %) T# so s created with _setXu become attributes,O*plus* their underlying exists in 0 of2 <NP. AddC,to7may be unnecessary where we are alsoN@settI_as an?,o?newn 0set(3newiareturn def o 1"""R@pwhetherashould9x` argumA0on #A's ``G.^nif not_h"ifge, '__dict__', {}#h2 - 1n'te.UFalsej! =@.__c"__Bfor .i.__mro__Presul(.Q.get(!, DEFAULT3if 7$isRvcontinu 6>, (staticmethod,  ),/elW # Normal h1 =>g if looked up on c<# ($ ,  is alreadyS6ped3B8])(#f dynamically providedv3En! ^ _SpecState(object):,|_init__(,S=,=None,  name=None, ids nstance=False): *self.spec =  Pids =G )C_set4 !Pparen iZ !! = FunctionType(-# python ftype(create_auto!),%# xamethod1ANY.__eq__), ) file_<0 = J def _to_stream(read_dataKTif isas, bytes%preturn io.B&IO-)Felse/jString0mock_open( 3=''1"""bA helper;B to 50 a Dreplace the use of `e`. It worksN3for called directly or: d as a context manager. >PThe `sp` argum6!isup objectconfigure. If `a` (theHdefault):n a `MagicMock` will be d you, with1 API limite"o $s attributes available on RPdard / handles`0` is|R 1`, line` and s`qa q. This_n empty f3by ._/ =/_state = [1, ] L s_side_effect(*args, **kw {#if$.:.`_value1noth:&> -6[0]n "& 9  yield from _iter7Ewhile Tru?\ g  Xo >E in N%/Jnext;5&,next(_state[0])  global file_spec&if is None:3import _io? = list(set(dir(_io.TextIOWrapper)).union"BytesIO)))) T~if mock| = MagicMock(name='open', = Gxhandle 0#)n'.__enter__.return_valu>  l.write('QOread$?linL(sQ vside_effect = __0_state[1]"`&(D".H:FT,s-h:2__i f 4lnext__m45 def reset_data(*args, **kw ) 0 to_stream(;+f #= L&1]_9b# OnlyP the  !if user hasn't overridden it.Gbf, d DEFAULT  :"; O class Property1"""SA/ intended to be used as a p@ , or other descriptor, on a j@`p`>vides `__get__` and2_` methods so you canw1ify#a =!whfetched.;Fking a instance from an objQcallsUa, withs0no `. SettS:it -,; be'#seCZ`child_g(self, /!EPQ_H@obj,`_type=0 rAyA7val700 1Pseal($"""Disable automatic generation of [sPGiven`input  , ^@s itwensure no furiw`s willa!ed `access~an attributat was not aluy defin1@The recursively>@ pas in, meanlAthatthe mock itseBlf, any mocks generated by accessing one of its attributes, and all assigned Iwithout a name or spec will be sealed.B1"""9 .__q = True1for{ in dir('!):6try pm = get,,>)1except AZErrorCccontinTif not isinstance(m, NonCallableMock3Dmnew_parenS (m) class _AsyncIt<Wraps an i(@an a3uhronous wdef __init__(seE.% =LQAcode, =(_set=CodeType7.co_flags]n2t.CO_ITERABLE_COROUTINEr__dict__['__La_'] = $ / Danex Bpreturn .EBStop:ionApass `raise . ion """Test result object import io 4sys traceback from . .Butilfunctoolsw( __unitttd failfast(method@5-Qinner, *args, **kw5%if4, 'a', False-1&f.stop(do% STDOUT_LINE = '\nStdout:\n%s':ERR3errmR("""Holder Binformation.vDs are auto"cally managj@the .ACaseR BSuit esAd dopneed toMexplicitTbipulatX wrssTEach p holds total number4B runz`collecRy0ure{0d eDJ at occurred among those Ows. The PM-ain tuplec (2bcase, l0ionh), where i}3'"he7 th _previousC|Z_pRunEnte=_moduleSetUpFailed 7 kstream=None, descripbverbosity, f A= []f.errors = [3] self.testsRun = 0skipped = [4expectedFailures#$un%Success&shouldStop = Falseobuffertb_local~;_stdout_C;Non^#?err# original,out = sys.\ _+ er+;err+mirrorOutpS$def printE" s(!): "Called by TestRunner after a run" /JPstart)H,#Nwhen the giv est is abRto beX9A+= 1r_>q_setupS&() *0if .U0is  ,0I -= io.StringIO()04 X4E=q= a-e9-#1Run#$"""once before anys are executed.SESee W for a method cqJAeachK.)""q/opprhas beenl%""awurestore2qB_=34;W aNoout.getvalueIeK?err. 2if `xcif not#.endswith('\n'*R@ += )* '.write(STDOUT_LINE %|11if  ".`4ERRL|9out,//^Q>wz.seek(0={ (|truncatP++S self._std"err_buffer.truncate() def stopTestRun(self):"""Called once after all tests are executed.Q65SeeU for a method cMHAeachI.pG@failfastaddError,8_, errpwhen an or has occurred. 'err' is a tuple of values aso returned by sys.exc_info(),9 .es.append((%!, _@_to_string(err5)))x. miJOutput = TrueFailureo:"""?ureJ0Sub 2sub(at the end#a 1-qNone if/&7ed successfully, otherwise it's al d@# Byault, we don't do anything withRs, buL# more sophistidR results might want to recordm if_I@not 8eif getatt'', False1(if issubclass:2[0]=.VureExceptionV" =1aJelses9G!J_m{completBpass_f7kipci, reasZmis skipped.  Yxpected"< / e1m :$UnnS5ev]Dwas ? tself.unexpectedSuccesses.append(test) def was#ful(self):!"""Tells whether or not this resultAB a sgE."""> # The hasattr check is for _Ar's OldRMw. ThatG2waysmethod works on objects that lack the ogibute.D(where wouldhinstances come from? o%tored pickles?)Mreturn ((len2.failures) == Rerrore0) andB\(M!J, 'unexpec]') or=i3'0)Astopd IndicateE@As sh+be aborted).#Stop = TrueW_exc_info_to_string}a, err, ConvertsL4ys.?()-style tuple of values into,[ exctype,*`, tb =vAa# Skip runner tracebAelevels,0whi}b _is_relevant_tb_17(tbvtb.tb_next3if l?Exception1assert*().length =^countsJelsetFENone(ftb_e =$.T7(-, limit=a, capture_locals=bUsmsgLines = list(.format(q"ifjbuffer`outputys.stdout.getP(kG*?err*2if X lE!if,.endswith('\n',.+@ += % JSTDOUT_LINE % l*4ERR<@''.join(") %e?L`__unitNR' in yframe.f_globals_cE = 0 7. PE+= 1Q 27q_repr__Wreturn ("<%s run=%i errors pfailure j>" % (util.strclass(self.__ Q__), testsRun, len$a,),P"y))) """Running L""" import sys Dtime 0war0s from . /cresultvsignalsrgisterR$p __unitr = True _WritelnDecorator(object):"""Used to d"e file-like +s with a handy 'wR' methodkdef __init__;s,streamj#d2 =  =tgetattr@ ?!ifb in ('>', '__getstate__'/rraise AttributeE.(Ww#ceturn |'Beam,)*#, arg=Noner"rgZ[:Q(arg)M '\n') # text-modes translate\r\n if neededTextTest (7.A"""A " that can print formatt3ext+s~a.65by ~aunner.Asepat1 = '=' * 70"2-i Gy , descriptions, verbosityUUuper(&).UON$hshowAll =J > 1BIdots"-==#) =oFgetD(doc_first_line =Y.shor<"if\Z and J r3.join((str(,9)kOelseH=Astars; . sQ9" ... "'vflush()addSucce, <$gln("ok$el0- ?'.'d, self).addError(test, err) if self.showAll: tream.writeln("ERROR"B$elDOdotsA F('E'; dflush() def addFailure(&, isuper(TextTestResult,').A;_|OFAIL'FISkipreason)A;(skipped {0!r}".format(X'"sO".stExpecte/ I',e" fx;$Un|wSuccess91F2u" su;printError 1 or,haList(' '!.e2 U18s au, flavour7ors6for'0 in/or !ln0.separator1 k %s: %s" % (.getDescriptionw/))P<21"} class unner(objectA"""A! r 3that displays rAs:textual .1It s out the names ofY@s asPy aref0occand a summaryB%hea^4endS.D1"""= def __,init__(self, stream=None, descriptions=True, verbosity=1, failfast=False, bufferresultclassaswarningP*, tb_localsF%):&"""Construct a TextTestRunner. (1Subt)es should accept **kwargs to ensure compatibility as theIinterface changes.5""" #ifF@ is I0b = sys.stderr;.!_WritelnDecorator()0) = )& = #4 = !# = & = #4 = !7if #>?notBHelf.*=8def _makeRu<qreturn pJ',^H)l1run=g, testj@"RunFa given case or fsuite.? register3i.Lq8. $'*Ewitht.catch_($ #",# $set, use itfilter allcNIr.simple7.>1Bthe /'default''always', special-2G#Q fromdeprecated unit7q method@show(m# no more than once per modulu0eca#they can be?rlyK isy. The -Wd and -Wa flags>@usedoPbypas/isKonly wheWY8-5n [c$, a]?a."(' '7zcgory=DBionW9 message=r'Plelassert\w+ instead.'QstartTimeime.perf_couT(, = getattr(2, 'L !',! AYp$ J startTestRun() Itry:test(result.ofinall2Cstopa = getattrC7, 'z', NoneXu7if 'q is not,0- ime = time.perf_counter+rTaken =z31- s-5ime .printErrorsFkif haseparator2')self.stream.writeln&%.s5 ruEsRunM"Ran %d -%s in %.3fs" %7= `(run, o!= 1 and "s" or "",F*)}%) eexpectedFails = unSuccesseskipped = 0: /map(len, 4TfUures,F M.< except Attribute% EpassJelse/s,.#, x2 = sn@info!%[]d!if@+C.wasxOful( ("FAILED"@failed, e%le7), +sG0if -*edb.append("&Sc=%d" %5 LcM'sK &edL G("OK ww9if K )j/ifFa $ sFej \ @ln(" (%s)(", ".join(<(),O  MG("\ncreturn import signal weakref from functools -wraps __unit= = True class _I?ruptHandler(objectLdef __init__(, default_h0) Q.callEFFalsm@origk<, =Nisinstance(tdler, int):  if default_handler == signal.SIG_DFL: 1 # Pretend it's/I&inMinstead.C-vF =/el?IGNNot quite the sam ping as IGN, butclosest we~ # can make it: do nothing `(unused_dCum, nframe)qIpassNelse+ raise TypeError("expected3INTb syto be "Zo "$DFL, or aHcallable object"){^self.  0`def __L0__(9,L E~Valled,bal.get(6INT>if ? is v # if we aren'B>q,Yn delegate immediatelyx@# to+:@ % 2/V!if.5*edID,Ef = Trufor result in _ {s.keys(.stop() , = weakref.WeakKeyDictionary() registerRi(I^G[c] = 1 6Omove4return bool(@C.popZp, None)interrup=aHAglobal _;/if1 isV  xT = _I aZOINT,() m^qmethod=G2if ;notr@wraps(#inner(*args, **kw initial'6 re!v2try 8 +ofinallDY. `r_ndler is not None: rsignal.(.SIGINT, _interrupt_handler.original) """TestSuite""" import sys from . Kcase,util __unittest = True def _call_if_exists(parent, attr)func = get ", lambda:)/() class Bases(objectY"""A simple s that doesn't provide M or module shared fixtures.{v_cleanup_init__(self,uCs=()& ._as = []Xuremoved!0 0add!s(A!) yCrepryoreturn "<%s%s>" % (A.str1.__ __), list)f#eqdd, otheif not isinstance("", \2@NotIamented2 ==\ ?ite|:PcountVQCases%A 1for]1 in !if [!+=.'". i# sanity checksAableF7naise TypeError("{} is7".format(sD)(if, type) and issubf9,|( . , fJr*8s must be tiated " "before passing them to &)"; s.append6}sSEs, s@ s0an " o!s,aM7ingG  3runTresulVRindex0enumerate402if D.shouldStop&Ybreak(:+!if.M_#0AtI(Md9Q", ?o0"""P hold@a referenceG1the at index."""  Ptry: test = self._ s[index]&except TypeError@)# support for suite implementations that have overriddenrkEpassLelsepSome unit s add non TestCase/ Sobjects toVgR# the.if hasattr(\, 'countQZ:s')M>rremovedF1 +=.>)()m9hw = None 'def __call__(,, *args, **kwdsSreturVJrun((OQdebugL=a"""Run without collecting eas in agResult"""?$ (.~) classIP(BasedA"""AE is a composgRq consisof a number of\. For use, create an instance/},nSb5ase*s-When alls beAddedBpcan be qed to a45runner, such axhR. It will rindividuaxR case,iPorderPwhich`y wereqaggrega.r0s. 1subing, do no0getV b)rtructorL ", l!, c=False<topLevel = Aaif getB'bRunEntered',4)!> z867 = u3Trutu,Renumerate<0#if.shouldStop&Rbreakif _isnot9q"AarDownPreviousCB3] \:handleModuleFixture8h_SetUp5 hp=kaest.__3*__Dif (v,2, '7SetupFail%or*GKCm DqGhcontin!if(t M/#if ocleanuMsi0AtI()a if topLeveGl: self._tearDownPreviousClass(None, result)6handleModuleTB(/gstRunEntered = FalseZcreturnq def debug()&"""Run the tests without collecting errors in a TestR1"""[[P = _Dd (tQ.run((r, True)# &_'SQSetUp,^p = getattrXD, '_"V0', qcurrent! =j@.__c%__:if )$= [:+=moFailed9 ~, "__unit_skip__",!:tryrX.RSetup wexcept TypeE2 M#? may actually be a function# so its mR will.builtin-typ2Bpass-s!~6, '$ 6if q is not _call_if_exists\s(vStdout'P fm6TE[ion as e'if isinstance 57rai9) 6Name = util.str(P 8q_create"Or ULevel-e,{G F& 0fin'restore) [!isNu?x1.do]Cleanupsi/iif len._ions) > 0uFpfor exc3 JEIi,<[1]_ 'info=exc) def _get_previous_module(self, result):,0'M&} = NoneClass = getattr(G5, 'gATest&!',C)D4if e!q is not& 8#._%__\ereturn` bhandledFixtur Otest8.Rrcurrentm0 = b@.__c</__;if 5= !1TearDown) -.ESetUpFailed = Fals:tryxCr = sys. )s[]except KeyErrorIs0]a7, 'VT_call_if_existssetupStdout' n(/Eion as eAVrcase.doCleanupsd(h.xcj-acreatew"OraULevelEexc,A K* Z lif isinstance|_DebugR17rai36Tru1[Y'U4Qkfinall9urestore;xo<v , u method_name) pan!, e{Name = f'{cB} ({:1})'_._add+ b~G l weption,S info=None): error = _E qHolder(UName)( addSkip = getattr(result, '1', \33if q is not  and isinstance(exception, case.fGTestJV, str:)Felse9!if{JinfoA.add^pys.exc_5(^3bIA!) def _handleModuleTearDown(self, Bprevious.0 = (d._get_!_mJ4if #>!is} areturn#if.XSetUpFailed9::try!2ys. *s[]>A Key J-t6f:, '" " |_call_if_existsg, '_setupStdout'wE  (2EK as D(if6., _DebugR<1Uraise@McreateClassOrSULevel-e,CK J& B Gkfinallrestore:c"do1Cleanups(+Xo7N kPkOtest+p'& qcurrent0 = j@.__c!__:if )=7: 9%if 5iS$>x', FalsxCR'LpreviousClass, "__unittest_skip__", False): ureturn tearDownClass = getattr(previous9, '(', None)F9if !q is not& _call_if_exists(result, '_setupStdout'Z:tryE(1except Eion as eCif isinstanceq_DebugR =xUraisecCName = util.str M 9self._createpOrModuleLevel-e,|G I& ofinallrestore 1.do"Cleanups0jif lent._ions) > 0Cfor exc in ~GBF#=_xc[1]'t%6M /info=exc) W _ErrorHolder(object1"""aPlaceh! a TestCase inside a . As far1&Gis concerned, this looks exactly likK . Used tog1ertFarbitrary es into a1 suite run.,# Inspired by the from Twisted# http://tmatrix.com/trac/browser/trunk%/trial/runner.py$ # pibute u!by>.P__to_stringufailure! = Tdef __init__(, description8.( =)M!idG: A3fshortDvA5c__reprn("<=%r>" % e(,)]/st\5id(1f run(self, result): # could call .addError(...) - but this test-like objectF shGn't be run anyway"Qpass `def __p__(self,xpreturn R.run()AcountTestCasesG?10 misnotsuite() "A crude way to tell apartcYQ and :s with duck-typing"6tryMBitercexcept TypeP)ATrue*False class _DebugR(qUsed by the Shold previous H@whenning in dW._,FCwR= Non_moduleSetUpFailed = ?EStopa"""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 Y0skil)gVlen -,1if -> s = '%s[%d chars]%s' % (s[:Y!],HE, s[v1:])ms__repr(*args 1 = M(map(safe' , )V maa = max'! if7<= 42 = ( tS = 4_p X3 (- Ko#ifn>8XW {D/ +8) <\<4 = (,,>9R + s[ len:] for sz v {w    !, = try: res ult = repr(obj) except EAion:2res1object.__:&__<if not short or len(6) < _MAX_LENGTHURturn &k're'[:6] + ' [truncated]...' def strclass(cls)^H"%s.%s" % .__module__, cls.__qualname__)Lorted_list_difference(expected, actualg"""Finds elements in only onethe other of two, sap input g1s. R0s a(-Q` tuple=+The firs? contains thoseK=""rA but1in P, andJksecondd A ^G .PDupli O!ei. are ignored.M!""i = j = 0missing = []$unwhile True'6try De = ;"[iM3a =*[jif e < aL4.append(ekai += 1G == $C!el>aj 40[j]A?els@ 0`kfinall0. IdIndexError2.1ext.yJ[i:], *Qbreak^d&, D unorderableSame behavior as Bf@istss items (like dicts)As it doe linear search per8 (remove) itfhas O(n*n)$formance."? oV.pop( .(=-_Value*<p# anyth@leftgh8 isp ) three_way_cmp(x, y): """Return -1 if x < y, 0 == y and a> y"""9r6(x > y) - (; ) _Mismatch = namedtuple('*', 'actual expected value') def _count_diff_all_purpose(5,6's list of (cnt_act, exp, elem) triples where the j s k1er'#- ents need not be hashable$as, t =q"),)(@m, n(@en(s"Ben(tNULL = object(PresulX![]>Rfor i in enumerate(s!if@ is Trcontinuant_s =j0imjgrange(i, mf"if s[j] ==r j!nes += 1V9r, other_~t+ tt !if 3s ! 5 = [sYt.append(?!)  nF @ !01~wgX?musC#er4),  7 = #ss.items(Gbt.get(00fQ}Nin t&Oin s? q. ;"# IANA versionke 2020a are valid PEP 440 identifiers;recommended # way to translat^Uto use YYYY.n:0`n`a 0-based index. __9__ = "2021.1" # ThisAosesoriginal number. _VERSIONJa" Africa/Alg Atlantic/Cape_Verde#Ndjamena/Abidjan Africa/Bamako AfrDnjultConakryTDakar FreetownDLome NouakchottOuagadougou Atlantic/St_Helena&ECairEAccrdBissau(N($biAddis_Abab0FAsma>Dar_es_Salaam6uDjiboutFeKampalBMogadishu Indian/AntananarivoUComoreMayottuMonroviRtTripoli<MauritiusCasablanc2uEl_AaiudUMaput!BG%yrpvBujumbuuGaboron!FHara/UKigalLubumbash5sakWindhoekELagoUBangu9Brazzavillz7Dou[uKinshas\YLibre0ULuand UMalabUNiamePorto-NoeReunio4PSao_T5MahJohannesburgUMaserjMUBuKhartouD&Jus`Tunis &0rctL0Cas3nta:Dav"dMawsonPKerguEDumontDUr NXSyowa+XTrollhVostokPRothe!psia/Kab Yerevan A BBaku !DhVThimp "ChbBrunei2@Yang|sShanghaSUrumq Hong_Kong5DTaipA0Mac@PNicos? Famagusta Europe/cTbilis^ Di5rKolkatafJ Pontianak`Makass7QJayapHFTehrRghdad5JerusalemRTokyo 4Amm2bAlmatypQyzylorY0QosRbAqtobe)4AqtDAtyr BOral!PBishkH4SeotPyongyaYbBeirut3Kt_LumpurTchingMaldives3HovUlaanbaatChoibalsKathmand5PKaracG3GazDHebr@Manij"QYcBahraibRiyadh3AdeSKuwaipSingapoIPColom' `Damasc\Tushan^kPhnom_Penk1Viecshgabar4DubDMuscSamarkan1 Tan4Ho_Chi_Mibustralia/DarwuPerth A0Euc"`BrisbaQLindeiAdelaideIfHobart/Melbourne Australia/Sydney ABroken_Hill Lord_Howe Antarctica/Macquarie Indian/Christmasocos Pacific/Fiji uGambierMarquesa/WTahit15uam.eSaipaneTarawaEnderburyKiritimaPfMajuro"vwajaleiUUChuuk fPohnpeeKosraeVNauruFoumeAuckland yChathamMVcMurdRarotongF7NiupWorfol6alaPort_MoresbBougainvillHvPitcairPPago_VMidwaG6ApiGuadalcanal0fFakaofT6tapgFunafu6WakFEfatWallis Europe/LondondJerseyWGuernIsle_of_Ma1Dublin WET CET MET E]dTiraneOtAndorraUViennTMinskuBrusselESofi*UPraguUCopenhagen Atlantaroe AmerUDanmarkshavn"ScEsundN7EThulfT4nHelsinkiM5ham!6Parc0Ber$qPBusinGibraltarMUAthenBudapestReykjavi.5Rom VaI@San_$no^5RigJTVaduzeVilniuxLuxembourg!M ChisinauUMonaceAmsterdamaOslo ArgyearbyedWarsaw.WLisbo AzVMadeiI`Buchar$SKaliningradSUMoscoaSimferopol A&khXVolgoBtSaratov16Kir FSama Ulyanovsk Asia/YekaterinbM$OmrBarnaul*Novosibir%To)dkuznetKrasnoya.EIrkuRChitaW'YaVladivostosKhandyg,@Sakh>:rMagadan SrednekolysUst-Ner<KamchatkUAnady0BelNvLjubljaPPodgobq5jevUUSkopj@dZagreb,BratislavMadrid AfS@/Ceu!UCanarStockholdZurich\dIstanbEurope/Kiev Europe/Uzhgorod EurZaporozhye EST MST HST 5EDT CST6CD7MDT PST8PDT America/New_YorkuChicagoNorth_Dakota/CenterJ_SalemeBeulahGDenvJLos_Angeles#eJuneauUSitkaMetlakatluYakutat#Anchorage6Nom Adak Pacific/HonolulnuPhoenix;FBois<Indiana/Fpolig/MarenJwVincennTell_CitywPetersburg6Kno0}Winamac-FVeva^Kentucky/LouisvillMonticellfDetroijMenomine>vSt_JohnwGoose_B}fHalifaJGlac"uMonctonBlanc-SablfTorontyThunderkWNipig4Rainy_RivAtikokanvWinnipeqVReginoSwift_Curren 0EdmGhVancoujDawson_CreewFort_NelsHCresPangnirtunWIqaluvResolutRankin_InleCambridgpYVwknif?VInuviWhitehor VCancuVMerid5Matamoro_FerrejMexicofOjinagHChihuahuxHermosi0Maz!Bahia_Ba!aWTijuaGNassygBarbadBelize Atlag/BermuCosta_Ric(avbpSanto_D5!El_SalvadocwGuatemaPort-au-PrHxTegucigalpvHJamaMartiniquWManagG Pa9VGCaym`PuertoqMPGrand_TuUArgentina/Buen'irfCordobOSaltHTucu2L/oj5gSan_Ju6FJujuC'aroMendozi'Lu5Rio_Galleg[Ushuaia America/Aruba America/La_PazfNoronhUBelemgSantarFortalez1eRecife2Araguain!eMaceio!FBahiSao_Paul Campo_GrandVVCuiab6Porto_Velh8Boa_Vist&eManausyvEirunepURio_BrancE6iagPunta_Arenas Pacific/Easter A ctU@PalmdGBogofCuracaULower_PrinceKralendijkGuayaquil{ Galapagos Atlantic/Stanley5fCayennGGuyaAsuncion0GLimaNouth_GeorgParamarib_of_SpaiMvAnguillfAntiguvDominicG\dwuadelouuMarigotMontserraSt_Barth vSt_KittdgSt_LucSt_Thoma#Vn]ToVevide Cas Etc/GMTEUTC niversalAZulu GreenwichDMT-0 +  4-146-13 2 1 798 7 6 5 hgf(+o++2+F+Z+n+++%+1&+1f12 Factory AfdAsmeraTimbuktu+Argentina/ComodRivadav6Atk|Buenos_Air0CatCoral_HarbourkWCordogEnsena<H_WayeodthabDIndianapoliFJujuuKnox_IN3LouisvillWMendoEreal4Vo_Acr4WRosar va_Isabe8vShiproc@Virg S@ Posia/Ashkhabad A`CalcuthongqingUhungk0Dacu)lh rKashgar3KatmanduMg&PRango DSaig Tel_Aviv2 Th2 Ujung_PandaUlan_Bator"fFaeroePJan_Mt Austral'CT@CanbWurrie7LHI8NSWGorthQueenslandyTasmania Australia/Victoria AustrGWestYancowinna Brazil/Acre DeNoronhDEastJCanada/Atlantic 0Cenp74ernuMountaiNewfoundland$VPacifQSaskatchewa7Yukon Chile/Continentalt"IsUuba Egypt Eire Etc/UCT Europe/BelfTiraspol GB GB-2GMT+0 GMT- 0 Greenwich Hongkong Icen+Iran Israel Jamaica Japan Kwajalein Libya Mexico/BajaNorte4SurGeneral NZ NZ-CHAT Navajo PRC +/JohnstonePonapeUSamoaETruk aYap PoPortugal ROC ROK Singapore Turkey 9PUS/Al aeutian `rizona 0US/b-IndiaUS/Hawaii0 p-StarkebMichigY53US/#UTC Universal W-SU Zulu TZif2@)35 `0@ٮ1111 q@K(1ͩ1΢C1ϒ41Ђ%1r@N@1 c@1E1t61d'1T1MD(131#12!11Ӡ1Ñ1H1111|1 lr1!\c1"LT1#1?p1@o1A`1BO1Cdo1D/1EDQE 6 CDTCSTCWTCPT CST6CDT,M3.2.0,M11.1.0 TZif2 @&3ji(@b€@ӔP@t]@A[f!Q1;H@ʼm1$e01̜O1 1;1ӣ11`@1}P1=D1S 1;1 1ũ1h1@@11w@p@@`P15 1@1H 1 1{ 1 1 j 1 i1 ن 1 K1h11}01Q1f 111F1["&p1;d1] 1F1?1(1\`1 1>1zS1 1 Z51!o1"CQ01#N1$#31%.1&1'p1'@1(1)މ1*״1+k1,1-M1.x1/~/10wZ11gK12W<13G-14@Y(15262!"88180191:Ƶ1;ې1<01=r1>1?T1@f["ED1E1G$(1Gܩ2I!P 1J1Km1L1M1NN1OwPPT_1Y LMTHMTaY5Y/[//1]D' u@ c@1E1t61d'1T1MD(131#12!11Ӡ1Ñ1H1111|1 lr1!\c1"LT1#1?b1@o1A`1BO1Cda1D/v1EDCE: EDTESTEWTEPT EST5EDT,M3.2.0,M11.1.0  3 w@}M1ȓo@{111ˮ1)1ͬ 11Ϗf1Щy1ф`@ҊPP16c@1-1 1`01@m0111ﰳ7@y% 1 1ZY 1s 1; 1U11601E01 119 101۾1100gA%@g1YW0IAa1+1C01 01$E 1 1 x 1 < 1 1 1 10101d 1t( 1 1U\ 1n171OP01011H 1p1{ 1<11pP140"01g 1 1!a 1"z\1#D 1$b'1%%S0"&^1?sW1@z`1A\s`1Bq\1C1E01F1 1Fj1H1H01I1J 1Kp1La 1LX 1L 1Su81S 1Sڼ0T$P/_ U*0 LMTEEST EET-2 TZif2' @&3W A&0 @0111@ 1v1e1{1N1?1%`1'2*,!(2!11l11N1y01011pL1r1P.1IZ(1012v12X!1011W11(111x1z1Xy1Q018[1:1X1 1I1!1N1,(2.!2p!18111޴1߮11rH1kt1R*1T12 1= 1)1T1 1q11S11011g1}1aI1_1Jf1_A1! 1?#1111111{@ǻp(@p 1)X1P1 :20!2 l!1 N@ H1 01 11q1.1Q1y111X@#P1812!11Ñ@81111k1 lr1!M1"LT1#a/1$,61%JKX1& 1'*-1'42) !1*1+1,1-1.1/t101]/0qD1@] 1&i"֙IN y0 11pL1r1P.1IZ(1012v12X!1011W11(111x1z1Xy1Q018[1:1X1 @&1ʗY11w;1ͱ@`X(1ϐ1n^1r121ih1c)`1I1!1B8101N 1 1.12p!1(111޴1߮11rH1kt1R*1T12 1= 1)1T1 1q11S11011g1}1aI1_1Jf1_A1! 1?#11111"81{ǻpp 1)X1P1 :20!2 l!1 N@ H1 01 11q1.1Q1y111X@#P1812!11Ñ@81111k1 lr1!M1"LT1#a/1$,61%JKX1& 1'*-1'42) !1*1+1,1-1.1/t10o1]$:@1@[@  LMTBSTG DST GMT0BST,M3.5.0/1,M10 a TZif2B @%3@] 1&"10111171v1e1{1N1?1%`1'2*,!(2!11l11N/?rHkt R*1T12 1= 1)1T1 1q11S11011g1}1aI1_1Jf1_A1! 1?#1111111{ǻpp 1)X1P1 :20!2 l!1 N@ H1 01 11q1.1Q1y111X@#P1812!11Ñ@81111k1 lr1!M1"LT1#a/1$,61%JKX1& 1'*-1'42) !1*1+1,1-1.1/t10o1]$:@1@[@  LMTBSTG DST GMT0BST,M3.5.0/1,M10 a TZif2B @%3o ps`H_HST10,DER@icAM10!ۓ@Kqx1Ҡ @k׀@ԓX@B81s:1>A2.2!92!11ܸ11ޢP1߶1@(h1Oi1v1/K@_Ǩ 1-1?1IX11+1m1 1O11l`1w1N1W101@p1h1 1G1%~1a1`1C1B1_1^`A@@#0"1~1n1]1M@G((@781&1=1 1 1 1 ֩1 ƌ19ol,@k p~w LMTHKSWTJST HKT-8 TZif2< @&30D`@@ш@rQ1(1S 16 1<' 1t 1M @=' 8@1&C`1&1%1ˬB11͌$1μ1l1М1K1҅1+1e19(1Eq11%S12p!w1 1ܹY141ޢu1߮1W11b91m1B1M1!161 11111~11`1"81j1_1S(1_A131?#1d11F11(1OE -` +00-01GMT GMT0D@l}@ȋ@H@t-@A@0!:1Ug(1EJh171-1( v1(۝1)˜"*1+`1,VX1- 1.01/o7 10a 11Pj 12B 13214%u15#0"616V 17 18֊ 19P1:1;1{v 1?m 1@\ 1AO/ 1B?.1C11G01HO01IN1J1K01L01M 1Nz; 1Oh 1P[n 1QKm1R=1S,01T'01U 1VZ 1V 1W 1Xэ1Y1Z01[F01\ 1]z 1^u' 1_g 1`W1aJ21b801c+f01d 1e 1eG 1f 1g1hR1i01j01k3 1l 1mf 1ns 1ob 1pU 1qE1r71s&R01t01u 1u 1v 1w? 1x>1y1zr01{01| 1}+ 1~n 1a_ 1Q^1C1201%01 1K 1 1~ 1}1101701 1j 1{ m8]HP#8>@1V@ H1 17 1 11B101v01# 1 1W 1y 1i1\b1K01=01,C 1 1 v 1 111/01õ01b 1 1 1 1t 1gO 1WN1I1801+01 1 ; 1 1o 1n1101'01 1[ 1 1s 1c1V1D017G01% 1z 1( 1 113101Ƚf01ɬ 1ʞ 1ˍG 1 1o1bR1Q01C0123 1$ 1g 1 11r101ɥ01ظS 1٪ 1ڙ 1ی 1| 1n]?H10"0818FP8@?HLMTTMT+0330+05+04Q30 <>-3:30<+0430>,J79/24,J263/24 TZif3 @&3dV@0EAY!@811ͬ11Ϗ1Щ1ф}1Ҋ01e1l 1Z01X1/1c2!1۴41ܹ=11޴81ߤ1v"V1f16_1H1A1t12& zGP| @@ `1 311![11n1@1w|01@`PH1 1!I 1"^01# ] 1$Z0 1%?1& 1&01'1( 1)01* 1+e 1,1-G1._01/{)10H 11H121?|01@s61AP 0BLWACHO1D,q@E 0F SAFc1G51H01I1J 1K1L 1M1N01Ot1P^B wQTـ  6@! G*0 G AJMTIDTISDT IST-2IDT,M3.4.4/26,M10.5.0 TZif2 @(PTZif2 i#~@3@pA `01 1 @ ٢1 g1101f1e1yH1iG1Y*1I)19 1) 1")p1 `a LMTKMTESTEDT EST5 O 3  K@e¤p2>0Y11;2!1c݌0Y~JDTJST JST-9D@@~6 @5@ `1F@P-,v@ nA W@+11+10+09-12+12 <+12>-12D @$1ݻ1#1x@e 1/?11Nƛ1B1 1+1* 1_ 1̯11z101 @1 1 pJ1!a~ 1"R1#D1$4@1%%701&@12N13D60145j00PPQTـ CRifvj \,    CZ`CETEE^?ET-E5 1 1z@ٮ1111 q1K1ͩ1΢C1ϒ41Ђ%1r@N@1 c@1E1t61d'1T1MD(131#12!11Ӡ1Ñ1H1111|1 lr1!\c1"LT1#1?1@o1A`1BO1Cd}1D/1ED_E: MDTMSTMWTMPT MST7MDT,M3.2.0,M11.1.0 TZif2 @%3`w@AL@@QX@xh@C`1X1#1811@01m1̧1O11p1111n1ƒ1N1cp1.~1L1`1,o1}p@ښ@A !0 A 1 1 ~11^11>1xg12XI!f28+!h2!H!e2*!G1 1)11g 11 F1!1"0 h1#i1$1%. 1&B1' 1'$1(1)1*ͧ1+#1,1-1.k1/j10mM11J12ViH13*146K15 16-161718Ӌ191:m1;81s11?~1@\N1A^1B<01C>1D2Ex!FZ`//@t @ LMTNZS @DT P-12NZ09.54//3DE@AD@ږ;^1>1xg12XI!f28+0`@2!H!e2*!G1 1)11g 11 F1!1"0 h1#i1$1%. 1&B1' 1'$1(1)1*ͧ1+#1,1-1.k1/j10mM11J12ViH13*146K15 16-161718Ӌ191:m1;81s11?~1@\N1A^1B<01C>1D2Ex!FZ`/@D\ LLMT+1215+134245 <+1245>-12:45<>,M9.5.0/,M4.1.0/3:45 TZif2] @&3a^ @:@111e@ 1E1 1ˉ @#p 1a(1/v1(1X1v@u01X1W1:190P 0Aw@q@a1P1@10151 1 @1 1 0 ٿGA 110111ye1id1YG1IF19)1)(1"Ep1 1'1&p1 11111 v@1!1"U1#jp1$51%J1&!'*GA' 1) r 1)1*T1+1,p`1-1.R1/~g10411g`12s13Gf14R15'H16217*18p18 191:1;ۻ1< p1=1>1?1@o1A`1BO1Cd}1D/1ED_cE# 4  *MDTMSTMWTMPT MST7MDT,M3.2.0,M11D @~6C)1@y1Y^1 1ӽ1 1|@1;>1Ӌ{01B1E" 1L1<1fP10@A|@R 1i@ ~1!I}1"g 1#)_1$G1%|21&'e1&^1(G6(@q~p LMTCDTCST CST-8 TZif2@)3XH@1*11ˉ@#p 1a&8@ 1f1e1H1G@*@) 1 1x @q(@a'1Q 1A 101C1 1 @1 1 1 `1 110111ys1ir1YU1IT1971)61"Sp1 1514p111111 v+@1!1"V 1#jp1$51%J1&1'*1'P1) 1)1*b1+1,~`1-1.`1/~u10B11g`12s$13Gt14S15'V16217818p18191:1;1<p1=1>1?1@o1A`1BO1Cd1D/1EDmE : PDTPSTPWTPPT PST8PDT,M3.2.0,M11.1.0DRw@VP@*A `01ٮ111@(1e1}|@1v޿1K1ͩ01΢C1ϒ41Є82ѕ!@1b1K#81^01)1,1 1(1x1TX@񴀠11і1 1캳111Z1zw1<1ZY11:;1}:X0~P U 0 A71t(1d1T 1M6(131#12!11Ӓ1Ã1H!A11|s1 ld1!\U1"LT?1# "01!q1 101@1 1 1 1? 1 "1/ @ypH0VA1 ݉t@ ν1ۡATp^/@q= p~~ CSTJSTCDT CST-8D@x@1C'1e71311-"1ۭ181݌1O)1kX@h`1bp@L1/phRx֐h4x1째115qx `1!ng1"B#NI'@w9w~  LMTKSTJSTKDT KST-9 TZif2< @&3 @~6S1@gN@ `1ʳ@ˑ_@Hmha] a] bp g g ixpppSMT+07 2039+08 <+08>-8Ds@V@1 @վ@ec@{P1N 1? 1%' 1'1(( 11 11@1ȁ?11J01΀1ˮ1k 1Ӣ91C1L @1){`1+1 ]101?1 1\@1 1ݲ>11b1h@8@np29 uA |1 1 ^@ 1 @1 U117@P(1@ܰ1`111 1s1|d1 lU1!\F1"L71#<(1$,1% 1& 1''P1'1( 1)1*1+1,1-@1.1/t10d11] 12r13=14Ry15262[!b18x@18D19Z1:&1;<1%1?1@f1A81BE1Cc1D%1EC1Fɿ@G#x1G2I!1J1K1L̿81M1N1Onn 1P1QW1Rle1S8 1TLG1UN2V>!0W.P?/,P( h*0 *08@pIMTEESQ3+04O3>-3D UTC UTC0o#N &V_@>yA*09i1W@lA90<@Am0=22h!=@EP`'@@AP01 1C 1̓@ 111s1|d1 lU1!\F1"L71#<(1$,1% 1& @''p`1'@(2)x!1*1+1,1-1.1/t10d11]h12r13=14Ry15262[!b18x@18D19Z1:&1;<1%1?1@f1A81BE1Cc1D%1EC1F1G#1G2I!Ϋ1J1K1Ḷ81MoTL` +` #9#91#w ? 8@*0FP  !pLMTMPSTMDSDMSK+05EETEEST MSK-3 TZif2p @&3' 0@ c@1E1t61d'1T1MD(131#12!11Ӡ1Ñ1H1111|1 lr1!\c1"LT1#. Lines beginning with '#' are comments. # All text uses UTF-8 encoding. Th/vha!leHas follows:W51. ~/-1, current T) 5AN9761 8-11-06). See: Updates ond #? https://isotc.iso.org/livelink Open/16944257 # 2.usual English name for 5d region,ochosen so that alphab#etic sorting of subsets produces helpful lists. # This is not the same as English n!inISO 3166 tableGb # TheJed by countrQde. #)&is*intendedpan aid for users, tovm select time # zone data appropriate< their practical needs. Itu #btake or endorse any position on legal!territorial claim- #code *$of$, 7y, area,Ksubdivision AD A{Tra AE United Arab Emirates AF Afghanistan AG Antigua & Barbuda AI Anguilla AL Albania AM Armenia AO"`ola AQA!ar" AR Argentina AS Samoa (American) AT AustrOU al W Aruba AX Åland Is s AZ Azerbaijan BA BosniHerzegovm0BB 'ados BD Bangladesh BE Belgium BF Burkina Faso BG BulgaBH Bahrain BI'undi BJ Ben@L St"thelemy BM Berm0"BN Brunei BO Bolivia BQ Caribbean NL BR Brazil BSjamas BT BhuBV Bouvet BW Botswana BYparus BZ ize CA Canada CC Cocos (Keeling)Es CD Congo (Dem. Rep.) CF Central Af4 CG-(H Switzer CI Côte d'Ivoire CK CooknL Chile CM Cameroon CNna CO Colombia CR Costa Rica CU CCV Cape Verde CW Curaçao CX Christmasop CY CypCZ Czech!ublic DE Germany DJ Djibouti DK Denmark DM Domin%DO nD`Z AlgeEC Ecuador EE EstoEG Egypt EH Western Sahara ER Eritrea ES SpWET Ethiopia FI FinWFJ Fiji FK Falks FM Micrones5vO FaroeR France GA Gabon GB Britain (UK) GD Gre'Gorgia GF French GuibGG Guernsey GH GhI Gibraltar GLIeQGM GaGN Guinea GP Guadeloupe GQ Equa#RDS South Ge & Sandwich GT[temala GU Cm GWz-Bissau GY GuyHK Hong Kong HM HearQ & McDonal@s HN0duras HR Croatia HT Haiti HU Hungary ID Ind`IE Ire IL Israel IM Isle5`Man IN1Qia IOIndian OcT y IQ Iraq IRsn IS Ic_T Italy JE JerpJM JamaJO Jordan JP Japan KE Kenya KG Kyrgyz KHbodia KI Kiribati KM Comoros KN St Kitts & Nevis KP Korea (North) KR1SouW Kuwait KY Cayman Islands KZ Kazakhstan LA Laos LB Lebanon LC St Lucia LI Liechtenstein LK Sri Lanka LR Liberia LS Lesotho LT Lithuania LU Luxembourg LV Latvia LY Libya MA Morocco MC Monaco MD Moldova ME(tenegro MF St Martin (French) MG Madagascar MH Marshall1MK ,p MacedoML Mali MM Myanmar (Burma) MNtgolia MO Macau MPC0ernFiana_Qstinique MR MauritahSMtserrat MTvSta MU%`ius MVdives MW awi MX Mexico MY ysZ MozamblNA Namibia NC New CalNE Niger NFCfolk2 NG7I Nicaragua NL Nether, NO9way NP Nepal NR Nauru NU Niue NZw0Zea4 OM Oman PA Panama PE Peru PF p PolynePG Papua Guinea PH Philippines PK PakiQPL Pog PM Pierre & M  lon PN Pitcairn PR Puerto RE PS Palestine PT Portugal PWrau PY P y QA Qatar RE Réunion RO Rom`RS Serx`RU RusRW Rwanda SA Saudi Ara$SB Solomo!SC Seychelles SD Sudan SE Sweden SG Singapore SHHelena SI Slove_SJ Svalbard & Jay>K$akia SL S*a Leone SM S)rino SN S_al SO SomaSR Suriname SS Y T Sao Tom{ Principe SV El Salvador SXMaarten (DutPSY Sy1pSZ Eswa4p (Swazi) TC TurkCaicos Is TD Chad TCern & Antarcticds TG Togo TH ThaW TJ TajiG TK Tokelau TL East Timor TM}2menppTN TuniTO Tonga TR$ey TT Trinida{@Tobav V Tuvalu TW Taiwan TZ Tanz8pUA UkraQUG Ug/UM US minor outlying iUS United States UY Uruguay UZ UzbeVA Vatican City VVincent VE Venezuela VG Virgi (UK) VIS) VN Vietnam VU Vanuatu WF WalliFutuna WS Samoa (western) YE Yemen Yyotte ZAQAfrica ZM ZBa ZW Zimbabwe # Allowance for leap seconds added to each time zone file. # This  is in the public domain&`generajQautomKlly from@JdataL-Lp # NIST1mat-`.list , which can be copied] # # or $ee)TP TimescalebbLeap S  www.eecis.udel.edu/~mills.html>. Wrules for  are specifi Annex 1 ( s) of: # Standard-frequency-signal emissionsIPnatioTelecommunic Union - RadioSector # (ITU-R) R<2end;TF.460-6 (02/2002)itu.int/rec/R-REC-4-0`02-I/> Earth Rotl Reference Systems Service (~periodicallysj to keep UTC to within 0.9 s0UT1qa proxy`'s ang7n space as measured by astronomers9she data in a!ed;hb _A.dat@ See: Levine J. Coordinatedaversal-(heBURSI Sci Bull. 2016;89(4):30-6. doi:10.23919/3@RSB.&.7909995ieeexplore. .org/document/0re were noPs befP1972,v no official mechanism # acdWdiscrepa"between atomic -e (TAI)eoc's # rs!. 4first ("1 Jan "")lm!in  # does not denote a&4; iPstart`curren!@finifI1AllMs?S'ary (S) at1Pgiven9h`correcY0 (+V -)2Jmade9'@, sounlikely # evof a negativR,w` look <P this YEAR MON DAY 23:59:59 - S/ yp esAq60 + S `s Jun 30_ oDec 31/3  4 5 6 Leap 1977 Dec 31 23:59:60 + S Leap 1978 D9 81 Jun 30Z/82 3 5 7  /90< 9 9 /94 /95x 7< ?200Z?200< 1?201O20166 # UTC timestamp when this leap second list expires. # Any additional+s will come afterM4TUED line is("mented out for now, # so that pre-2020a zic imple1azs do not rejectj file. #iA2021a28 00: # POSIXs|the data iMp: #upda1467936000 (Sq-07-08 U0:00K3) #( 16406496.|21-12-2.C # U^through IERS Bulletin C61 # File on: 28 December # versionAa # r7 np^D"ise public domain. R d 1916 o - Jun 14 23s 1 S1919 - O Su>=1 40 - 7<]Mar 2<897W9R!20FAO 23O!214 2l832S 1vN 19 1 244 1945 - Ap M.!44XO 8 255IS 16M7QAp 25AS 267rWy 6 0}0O 21H24 12gS 22 3!80cCO 31Z Africa/Algiers 0:12:12 - LMT 1891 6 0:9:21 - P#911 0 d WE%sT[10 Fd 1 d C6 O 7 0 - WE'56 Ja 29 PC 63)14O077  M 796(8yN Z Atlantic/Cape_Verde -1:34:40912`1 2u -0-0202 SP1 -01`5 O 15"- #75 N 25 2 -1 - -01 Z Africa/Ndjamena 1:0:12 - LMT 1912 1 - WA 79 O 14 1 1 WAS80 Mar 8&$ ZRAbidjan -0:16:8R0 - GMT L,oBamakoOnjulConakry _DakarFreetown!OLomeNouakchott#Ouagadougou$tlantic/St_Helena R K 1940 o - Jul 15 0 1 SO 1 0 0 -11-Ap0JS 1612g@4 - 4 c2LJO 27333\5 - N~52Jf!57PMay 1 0195( &584 `59 198P 6gS 30 3`66 199j8f)25O!83*124!89665$90 `95 201$Ap lastF 0s 0UTh 24A2006uKS 21|lS Th>=d!Aur SZAu 20T1 Au 0S 92Si!1458`Jun 26#2063n6 nCairo 2:5:900 O 2 K EE%sT R GH N{0:20 +0020 24:Ja 1 2 0>3dS @4@.2 d5$5c!:33p51 1956+PAccra00:5p5 N 2 0 %sp2 F 8 0`-3zt46 Ja 6(Bissau -1:2=0`1 1u - -0075 Nbi 2:27:108 May 22028 3a 3 - E 30oL4 241Q36 D @ 2:4@R+02457KAddis_Ababa$OsmarDar_es_SalaamEDjibouti!oKampalgMogadishcIndian/Antananarivo L Africa/Nairobi Indian/ComorMayotte Z? Monrovia -0:43:8 - LMT 1882 Mq919 Marr4:30 - 72 Ja 7  GMT R L 1951 o - O 14 2 1 S2Ja 1 0 0 -3:O 9/4/50S 3E_6 082 1984 - Apz35 8egAp 6 08eOAp 4:O 3G7|9|O!97 dO{/2201?Mar lastF 1O2wTripoli 0:52:4#920 1 L CE%sT9 2 - EE )8290 May 4"096  '77 O%2012 N 10 NdO 25 2OP R MUD<O3<2WqMU 2008H!Su]8A20096TZPMauritius 3:5@07 4p+04/+05B 193N0S 1b1MEN 19!40~FB 194wIN 18050PJun 1b:O 2b6E232v7oBun 2,3 19S167 !ayd7'uX!R 4:S 27 'AuM 1 08Au ?B 201s8Au 2201!Ap PJul 3::!20V:c03 1'K7 AuZc3OA4 CP8s 42lI i453l14%23*133*174Y4-42s9 3 -1 - R M 2020 o - May 31 2 0 - R M 2021 o - Ap 11 3 -14*16424kMar 275:y 8434+194ZAp 30444044454KF 232;Ap 61+1512d73 2182.Ja45e93+14;F 1cDG !30K:F 1`JD 22b3*F ,D 3,JaKN 28bIJa 93;N 2:D 2'3 +N JD 17aOD,O 3NQ3+O ;N 1KS 26#+N Sk O4+S O4 Auk b:S 24 Aua 2:S 2v4d IS 134[Jul 2YL 44 r3 43  40Juny ln d5 D4lr 434 x54 255 4 |5 Ap 4 95p 3 5,Ap3 5a y5416 54 +Ap5F K 5+F 22060 o - F 1 3 -1 - R M 2060 o - Mar 7 2 01jJa 16 3;F 222281JF 19cKD 3113J:F 40D40-Ja;D 7a51*11cKN 2226231ON 141JD 2617I,N V,D 80=R?#5 !%Ap"-D Windhoek 1:8:24 - LMT 18&92 F 8 1:30 - +0130 1903 Mar 2 - SAST 1942 S 20 2 2 1'1 21, 90> 21 2 NA %s Z Africa/Lagos 0:13:35 - LM]p05 Jul G8 (D14 0019 S 1 - WAT LfsoBanguirazzaville"oDoualaKinshas_Libre] _Luand>oMalabozoNiameyPorto-Novo Z Indian/Reunion 3:41:5|11 Jun 44Sao_Tome 0:26:56884 -0:36:412 Ja 1 0uB20181R 20192(BMahe$48m5907BR SA@1943 Su>=15 $- 3%6Mar"60 -Johannesburg 8!SAv IpoMaseru$ `babaneD 1970 o - MayD`0198ipO 15 0 1R S616@Ap 351 S6#2 6Ap lastSu 0WKhartoum 2:10:q3SD CA%sT 2000P5 12 u EAA17 N7CATWuba 2:6:2PE21 FPR n 1939!3s N 18 23s54IAF 25-5O 6E2f+9#d4XN 2 3a30!29y#S 1~Ap 17 23!Ap42:O 404zAp M>=1g4:O 85:S 1!77$EhS 24 0D!783 3O282Junv`88 199S : 26;9 2200S1h@2006k2"O2B3@Tuni@40:4`@2881p2 0:9:2P10r 1an CE%s+`ntarct PCasey)0 -0u069 0+0819 O 1S0+11>Y75 2*11 O 28 2*h21 17u+6+2 11 - +11 2018 Mar 11 4 8 - +08 2018 O 7 4 11 119*87 3*x9 O 4 3*!20*8)!20)50:1+ Z Antarctica/Davis 0 - -00 1957 Ja 13 707 1964 N "E69 F0200a18 2 525g10 20u,k11 O 2,P2 F 2* hMawson04 F6p/6  Z Indian/KergueleA0 jDumontDUrviller@47 1!+1#2#4E56 N# UWSyowaLaA29 3`3 R Tra5 ma -lastSu 1u 2 +02#4#&O !Z0 +00rUTrollr@2005002 0i*%s-eVostok.SD 16 ^ .hRother`76 D -0-03-sia/Kabul 4:36:4LMT 1890 44 1945 4:3U0430 R AM::1 ok2s 1 - 2xYerevan 2:5w924 May 2qMar 4 R +04/+05 1991|q31 2s 3@3/+0p95 S 24)97A`2011 4SZX74 "5Baku 3:19:2N242 SK'2sh96 4 E$AZP R BD9Jun 19 23 D Q4Dhaka 6:1:4`5:53:2H0t941 O 6% 63|!42D15 55S-t51 S 30 6t+06/+07aThimphu 5:58:3~947 Au m 876kChagos 4:494907n  Y,Brunei 7:36 26$ 773Yangon 6:24:4F880 RO2rM! 99^3I R Sh 191PAp 12 ;1 Dm40 S&40"7 0 4ON415=11 2:#7 5Ap !AZ Asia/Shanghai 8:5:43 - LMT 1901 80C%s!49~@28 8 BUrumqi 5:50:20A28 6 - +06 R HKAp 21 0 1D 1 3:30s 0 -67SAp 13:N4;8;72;ra52 - O#28$}P9 195?$u53 1964G3$54#1Marl1lH`65 1973k6l$1#!73Dc!79LOKHong_Kong 7:36:46(04 Ol0q 8 - HK31 Jun 15 3 8 1 HKSO 1 4 8 0:30 HKWPD 25 J)5 N 18 2 8@HK%sT R fJ5KHb0'E 0 N r0Wd c f#52`rOf 52G$ i>5 h56 h 60Pa 67l]75 - Q Q;Jul0PTaipe4 1896CJ37 OSWT!f =0R _v ApFA23 1qN 17 236))2bC#3s*4b5/:9 25^!O[AO 31O5N#2a>=!;!O lastSaB%51b^=LO 286fxo5\z!55=16 3:30 0 S Z Asia/Macau 7:34:10 - LMT 1904 O 30 8 - CST 1941 D 21 23 9 _ +09/+10 1945 S 30 24 8 _ C%sT R CY|5|Ap 13 0 1 S PO 12 -63kMay 154KO 114P7 198"Ap 97T0S 2R&0 m8,O 9 1997 - S lastSuq 81 v8 - Mar"VNicosia 2:13:2*X21 N 14 2 CY EE%sm98 S 2 EFamagustE?5:4E 2016 S 8 3 - +037 O 29 1umLsEurope/Tbilisi 2:59:11&F880 0TBM024 2y@1957( 4 R +04/+05?1 31 2s 3P3/+04=e40 4 F36 OS 4 1 \q22004 Jun 27uA200512 484Dili 8:22:2i!12!0+08!D2 F !tE!763(2000 S 17 9a9aKolkata 5:52#85"8 ~Hj870 5:21MP906 54- IO!632"15+22 S+I5 O )Jakarta 7:7:1267 Au 10 13 D03:41" 7G@+072b32 N 76+07rpOl-23+8dA1950 R064 4WIBPontianak 7:10SPaTJa 29 05 S 4U4#@WITA8Makassar 7:57:36 92yNq4#qJayapura 9}QT4 S 99!64  WI i 02,! 1S 18 24 !80JS 22!91e 92Y549Sm9w,S 99&71 n 7 ( n2001 200Mar 21 24 1 - Rp i 20013 - S 21 24 0 - R4 o - Mar 201S454O4h84 hhd9 2011 kn/12nn 13n5nn6nn7n9nn/20nn 02 Jn 2no5 20272n8: )2to30 203,t 32: tt4:23t6:" tt3" 3t4"4" tt4"4" tt4" tt4" tt4" tt5"5" tt5"5" tt5" tt5" tt5" tt6"$62 tt&63 qn/66nn7nn/70nn/71nn72/74nnc7 S 21 24 0 - R i 20768 - Mar 20 24 1 -S049 o7171S 24t80 20827 nn/83nn4n6nn7nnO8 maljZ Asia/Tehran 3:25:44 - LMT 1916 T430 - +0330 1977 N 4 i +04/+05a9 3:30330/+0430 R IQ 1982Sy 1 00198Oz364Ua5 - Ap7:79S lastSu 1s XA6 19!z#Dt91 2007`(3s3\UBaghdad 2:57:4VA890 3BVB18 3Sp2 May 3/0+03> R Z 1940;3Zu 1 D0S 3Zu 0 SyN 16 2442U#O Q73p[4<w5Z8!2252 D$AuuV8uO9 - $Ap85AS 14#51r3u48 u pS 13 24*8@May  5BAu 28pQTj1;5SgR2Bfi+p 78 S 1bdSN29g#235 1991 o - Mar 23 24 1 D R Z 1991 o - Au 3140 S2`Mar 2850S 5333hAp 2 0e0'0 /4/1/uy 15133IS 3 161 14=O lastSujZ Asia/Jerusalem 2:20:54 - LMT 1880 `40 - J918 2 Z I%sT R JP 194pMay Sa>U4|1951 - S C8 25 !Ap0350 > `Tokyo 9:18:5907 D~P15u 9JB 197N1JunA1Jp1975 - -47by6!N%0 3! J.@Ap 3aGSH8!Ap`0 `s86 1988:92O Fji8<6!90Y70S 2c91 9283{ 9398[o59SW5 0s 0Jul\&s ]199 4F9"0200q! Th"A<k"%U2200O7OE  S 6 1m0D 2wF20148  UZ Asia/Amman "2:23:44 - LMT 1931 2 J EE%sT Z Asia/Almaty 5:7:48*24 May 2 5 - +05=0 Jun 21 6 R +06/+07 1991 Mar 31 2s 5P5/+06p2 Ja 195c2004 O36b6Qyzylorda 4:21:529+0481 Ap 5 1 1981 O e24"4/a91 S 2A19925p 2018 DW ostanay 4:14:2Z Aqtobe 3:48:40l pAqtau 3kD v)@19945R  2tyr7 33OC9&8@Oral05:2 86BR KG*0199Ap Su>=7 0s 1 - !S lastSu 0 0 P7 200}"I2:30E%:OE#HBishkek 4:58ec3 A1 Au 5"+0TAu 12R 1948 o -z 1 DS 12 24 0 S94KAp 339 1951 - S Sae 9$509 l!516S%555;S 8%5632%1 r 5kA60 -" !- S Sa>=17 24 0 S R KR 19878 - May Su>=8 2 1 D!O3@Z Asia/Seoul 8:27:52 - LMT 1908 Ap 8:30 - KS12 9 - J 45 S 8 90K%s 54 Mar 2173KR 61 Au 10. |Pyongyang3}QAu 24A2015d5|A2018`4 23:3 R l 1920 o6r 28 0 1TO 25 0 0 -2120Ap B0O/2/6a O x131ZAp 2200S 1H15!619y 14O67~9>OBeirut 2:2j 880 2 l EE%sT R NB 1935 1941S 1":2d D$ -SKuala_Lumpur 6:4Y1 6:55:25 - S`5 Jun  +0O`33 7 0p@+072@@36 7$- 47@+073&q42 F 160+09$;12 )082 ?6+08ching 7:21i0926R @@33 8'q+08/+08}kIndian/Maldives 4:54M060 $p+05 R X81!ApP1I3*KO!! KRX 200V"ApKa<@2006#<2A| @o15 201!a Hovd 6:6:3E0 0+060P8 7 X6Ulaanbaatar 7:7:3 9AA78 8A9AChoibalsan 7:3 >8AAp 9NP9/+10!Or 31fKathmandu 5:41:,hD20 55c86 5:4143 PK`b!ApxR PK 2008 20P09 - N 1 0 0 - R PK 2009 o - Ap 15 0 1 S Z Asia/Karachi 4:28:12 - LMT 1907 5:30 - +0530 1942 S R1 +06q5 O 15 -+51 S 30 5? 1971 Mar 26 5PPK%sTP 1999+eAp F>=5R PU3 - O841O 1544 267  gA200620S 21a7*13K8KmZlastFP8829S 4!10.K)26HGAu 1Q 201130 0:SQuc20u 3 12h14 -QTh 24?:20S 2k37R*248AO 231#18ASa>=!%O r9r6,vZ20 matN<-kGaza 2:17:52h0 O 2 Z EET/EESTjP8 MayX2 K EE%s67 Jun 5.Ie96 2 J#c99 2 P2008 Au 2-`98 S$010 0EET0 27R 'H1 Au*2Hebron 2:20:2LJERH 19351 DF8!0 05:2=15 2 1 S !O c 2 0 -B62 o;)297:O 103 1965 - Mayj!63LJS 3044 K5/6ZAp 246 1976 - K787S8"84  k8IF 16 O Id71Mar}-88:O 3d&884 %894O !901B  |&9100Es91 1992{0A9A)8 2 /26YS 25 J4d M4 v 5G9GjZlastMm9:UZ0S 26200PFPgN F>=12200$Ap+N 2 ir10 2011mRQ12 ma/r 9OZ Asia/Damascus 2:25:10LMTD0 2 S EE%sT -ushanbe 4:3-4 2 +05 1930 Jun 21 6 R1/+0 1 s 5 1 +05/`1991 S1xBangkok 6:42:E880 BQ Ap 727 L>Phnom_PenhVientiane{Ashgabat 3:53:3  +05! 4"4/%92 Ja 19 :xDubai 3:41o(dMuscatASamarkand 4:27:57/92 zP 1981LkP81 O ;"82 Tashkent2!7: 2 Y pHo_Chi_Minh 7:6:4 rp06 Jul 6P1y4q 1942 D 3 I0+085q14 23 9`98S 2=78"55u2/59^7&Dn 13J R AU 1917 o - Ja 1 2s 1 D R AU 1917 o - Mar lastSu 40 S !42 -Ja:: @S 27Tt43 1944w 3w4O 3< Z Australia/Darwin 8:43:20 - LMT 1895 F 9 - ACS9 May 9:30 AU AC%sTcW 1974a5ASu>=58=8[=!91\8N 1W9l9A20069DR AW 2007;#W8 - OXqPerth 7WW1D 8B@W%sTP3 Jul0W A FEucla 8:35:2rF0:45I+0845/+0945O'W Q4 1R A8F89 1991? 90!2 "HoO1993C!93 CBrisbane 10:12:" 1Eb!710Q A _Lindeman 9:55:564U46ER10 Ho&aS+_ 1985A!8}DO 19"R ~7;7 U77v 7]6"5EP -z,2277,2075l): lS+:Ap tm:@8 ma)p D 3200O Adelaide 9:14/S/1 z1R AD 0191@A8 C6c@?!68<2=_gA!#7#D8" @ 82`BbE 84## E /87+ S R AT 1987 o - O Su>=22 2s 1 D R AT 1988 1990!klastSu! 91!9!B1 2005 - Mar C20 SdA2000'Au2001 ma`B2006=p~[7{8\A?Z Australia/Hobart 9:49:16 - LMT 1895 S 10'@AE%s-q19 O 24$U !67TPV 19788O!2F3?y" 86"5 #&87\!{f!4?95  V1$ ? 8R A `!Melbourne 9:39:52$F!71VN !'27 1"8< 1R A@J"J8J#E 19"_7=; 90! 96"NCC !FC CCSydney 10:4@N@Broken_Hill 9:25:48Q- AES6 Au 23 "AC9 May 9:30 AU AC#71NSP R LHE 1 - 2%0' 0!5>0A B O  > #`" d:200 # a  - O Su>=1 2 %0:30 - Z Australia/Lord_Howe 10:36:20 - LMT 1895 F 1AEST 1981 Mar )0 LH +1030/+1130_5 Julpntarctica/Macquarie Z0-00j99 Nj16 O 1 2P1 AED"17qAU AE%s9 Ap 1 0s N09480 25>-!67T>@2010`@2011A Z Indian/Christmas 7:2:52!w7 - +07/ocos 6:27:4MQ900 6~ +0630 R FJ 19989 - N Su>=1 2 1 -P9 200FF lastSu 38 a2009 o<(299?Mar810 2013 - Ow2x ? v$12>!Ja?*18!14?2 14?8^2015 ma - >2\;8!20xKD 201Te6Z Pacific/Fiji 11:55:44915 O 26 12+12/+13 6Gambier -8:59:4`12 O -7-091Marquesas -9:10 W-09305`Tahiti2V58:16e -1QbGu 195aJun 27AD R !611Ja .50 S7Ss6 1 2Ma 26 0:1 4i2i@Au 3X57)@71 -r!SZ ;!73JD 16s7rKF 242620May lzAu 22 27"ApQ0u 2Huam -14:2 844 D 31 9:3!90l1- GY41 D 10 +09 1944M7 10G @D 23- ChST LG|iSaipanF@rawa632:7+12-Enderbury -11:24 -13@197910-11^ 0Kiritima]10:29X03A-104*] -19]7+14`Majuro(24+G14 Og 19S3#-G1 Ap.Qa 30 Q6 CKwajalein @r=F 6p{ - P1993 @0 24Chuuk -13:52: 52 - LMT 1844 D 31 10:7:8 90 - +10 1914 O 9 09`9 F 10W41 Ap U45 Au! Z Pacific/Pohnpei -13:2o632:1i1y%37u? 19/aKosrae48:4T51:56G 1969 O 1+12 1999 1Nauru 11:7:4921 Ja 15 11:3@+11342 Au 29=S 8*79 F 10 2 R NC 1977!D Su>=1 0 1 -8#F 27 0 096 o - D 1 2s5!97PMar 24-`Noumea05:4y!123NC +11/+12RZ 192SN 6 2 1 S8kw4 2 0 M1933 - O8@<"5%D 34psAp lastSu!S f4&?!74NCPD R kr 5:45b!75<Fu1s 0k= >3R N>0198{OA%1 ~-5 DD6$=!F!89 <`90 200? CBE7 - 5E "H2007 ma - @B2008@&Ap @UAucklandW'39@68 N;NZ NZ%sT6 6Chatham 12:138JA2:15 21(4I:45 k +1245/+1345 LAntarctica/McMurdo R CK0N 10@9,H !#0 D!Rarotonga -10:#C1-10[77`12 -10-10/-0930)0Niu]H1:1901 -11:2N 125-@78 O*h - -11X`orfolk-114:E1G51 11:30 - +113 0 1974 O 27 2s 11:30 1 +12975 Mar 2- +1130 2015 O 4 9 Jul 11 AN*%/+12 Z Pacific/Palau -15:2:4 - LMT 1844 D 31 8:57:56P901 9Z(09Cort_Moresby 9:48:402A880 q32 - PM^@95 1"7+10GBougainville 10:22:1zH Q 1942u5 Au 21m@28 2#Pitcairn - :2 -8Q- -0898 Ap 27 -8 Iago_Pago 12:37:1J!89` 5 -114>0911 - SST LMMidway R WS00 o5 lastSu .-1Ap Sa>=1 4 0 S:Wa 3 1`2 ma -.Su;<u<XAApia3W 6ZcA1950WS -11/-11 D 29 24 13w+13/+14~GuadalcanalH3_912 OpFakaofoj8:2400-11o 30~@3 R TO 1999j O IbTO 200S19 2s2001 - N f2;q0="Ja8u 2@!16u=!17"JaZ15 3:Tongatapu+19"12@+122%41>TO Funafuti 11:56:5101  @Wake,66:2 +@R VU3D 22 12u(4c2 83dSX22 24>$84!A(#*D 92#@3 - O?a>="OcnAEfat'13PJa 13/VUaWallis5McR G 19 `May 21ii1 BST !O E0 GM(MAp 851S 1 68s2s m S n'j 8S 8&20p @O 2523n!O  52m67O/ 7m2:2fS"0 GMT R G 1924 o - Ap Su>=9 2s 1 BST R G 19256"/16#a38 - OD2!E0 GMD/7 c 8c9c /30B 31 1932B 3B 4(35 & 367 8B 9 Nbc4!F 23!41^2May! 1s 2 BD4B 43u#9# C`2 1944"+2" EESA 16 BD?M>=>1Jul@4g!464BMar @ PAp 13 @u 109-N 4p4@O 31 >Ap LO 306h50 195 t#A {5%&53 1960555"cld i5,5, 6 b B66`lastSuM$ 64 F:1jLF 18a7M8I? W$ 8P95 - F)1u$81F81u 9:F"%2 "Z Europe/London -0:1:1rLMT 1847 D 1 0s 0 G %s8 O 27 1 -Gb 1971 u&`96 0 E$/lLhvJersey _Guern Isle_of_Man R IEU -1 -+#*I3 2uE]81 ma0f "6e&O  QDubli2 80 Au 2 -0:25:21 - DMT 1916 May 21 2s -0:25:21 1 IST 1916 O 0 G %s 1921 D 6 BGMT/(p40 F 25D0=4=6@- GMQ47 Mar 1hk47 N 2+r8 Ap 18GAn68 O 27 1 IE/GMT R E 1977 1980 -<Su>=1 1u 1 S o - S lastSu40 - 8 71u o9 19958q81 ma -Xu"96 Ov/W-s!s  ! y@cAp 30 23I"18@M>=117 %S ?!40$ 22Bp!43q+2930O 4dP4 194!Apj4ROj5S #77982a7   u >eB0 q <R@0Jul MS PD 28 4M&31 22 2 MD8 R98380vaMSD R r Au"#SK!21UBF 14F6cZ2 +058@S 1 / 6~j 814~413 - 5 -:P5 201p3"$96"B Z WET 0 E WE%sT Z CET 1 c CMMEET 2 E E0R q2Jun[z3a(0 374m9260i 0602`OG0O `06 0 1 S R q 1978 o - O 1 0 0 - R q 1979 May 5 0 1 S0S 3/1%801319O 4a!810ZAp 260JS 2712121 O x30ZAp 180 %840/Z Europe/Tirane 1:19:20 - LMT 1914 1 - CE 40 Jun 16 1 q CE%s84 Jul 1 E TAndorra 0:6:4S001 `WS 6 ge85 Mar 31 2TrR a 192sAp 5 2s@S 13"%4640O 72a7 19480]Su>=15@Ap 6P8j83g0S 2:Vienna 1:5:2893 Ap 1 ciE 1 a040 9 2s& 452P1 CES1R'81PMinskD0:16p880 1:5M<124 a 2 - E3B21 3 - MSKl1V*28V` 3 3 R)/MSD 1990:%91+qs 2 R E220120p+03 R bc49 0DB1919a#3s/ /hr 1 23;OF 14AO 2326LO 256 6 2272 W9sW5 ]7575 O PV8 193{233Jn9.3J1Ap 33' 4'7Ap $4 % $N#N11N 1gi4FM40S 1(i4i 4"S }dOhGBrussels 0:17:3:680 BM1892M1,DP14 N > 16, 1 c CE%sT 1918 N 11 11u 0 b WE%sT 1940 May 20 2s 1 c C4 S 3 1 bb77 1 E R BG 1979 o - Mar 31 23 1 SO 1 1 0 -80 1982 - Ap Sa>=9!80UKS 29:117 2SZ Europe/Sofia 1:33:16 - LMT 1880 1:56:5I94 N 30 !EEQ2 N 2r5 1 - C"5#6&79 2E;82 S 26 3 2 c f91 2 eR7 2 EP R CZ5AAp MsNN!2s666:6 246V9 - O SuTT7 8!5BDAp 9sPrague 0:57:44t650 Pt:1 O^5w09 1tQ6 D 1@-1 G;P947 FX2+7;VD 191 143@S 304j<C15 0p2R#941u 1-M 40S 12744@Au 184@Au 8MgCopenhagenE0:209Cur894 1 D"! ",r%Z Atlantic/Faroe -0:27:,908 Ja 11 Wl8 E R Th 1991|ilastSu 2 1 D"%S 0BP3 200t @ O@s2007 maJ8?Ng |Z America/Danmarkshavn -1:14:4Jul 28 -3 - -03!0t06 2E@/-026.FGMT aScoresbysunda@27:50 aH8a`-02/-0i!81@29 -w-01/+00mNuuk -3:2Y e LThule -4:35: L40A%spTallinn33TY918 Ft19 Jul 1:%2y p0 Au 6 0MSKP1 S 122 3 R MSK/MS82 0EES` 89 8209 OI4@2002>/ FI2 sAp 2 24 O 4 1 0 - R FI 19812 - Mar lastSu 2 1 S R"S #3 0 - Z Europe/Helsinki 1:39:49 - LMT 1878 May 31 H0921 2cPEE%sTa3 2 E - L]mMariehamn 1916 o - Jun 14 23s0191qO Su>=1 0R F 7<2<89779R!20FAO 23O!214 LO 256262 1938 - O Sa#23<Ay 26X<4Berlin 0:53:2Z93 Ap5\b2 1 Sor06 1w'80dZurichBusingen"Gibraltar -0:21:24U!80  0s 0 G %s 1957  4 A- CE  gUJul 7 S 41 o - Ap 7 0 1 S R g 1942 o - N 2 3 0 -3Mar 30 01@O 4 15HYJul 10a0!75aAp 12 0sa@N 26%76391 23@O 1037 1978 - Ap Su>=97SSl'2s$784!79( 9gS 29 2H&800FCS 28GZ Europe/Athens 1:34:52 - LMT 1895 S 14 A@916 uH:1 2 g EE%sT130 1 g C44)88E8 R h 191899C15 220 - S M>=15:2 6!45 May 1 23P1N 1;kI45O 7m44 O -%542 9O1)22#5OVb6 1957 - Jun 5 S lastSur5EAp 6cWM}01 1983 - EQ9!p@Budapest 1:16:u0 N 1 cYe18 1 h4}I7 23&)45&b84 1 E5@ R wu1BF 19*6O 2+EN 16F#21rN53!ApO242F 20"40b42 1g74!1!3@6!1B!2!2bO6s1;O 56zY6; 9 Z Atlantic/Reykjavik -1:27908 -1 w -01/+0c8P7 1s SpGMT R I C3 24'0191S2O+31790O 6M2 L 2 20MEM@S 18f< 144L4g9kI 1944 o - Ap 2 2s 1 S R I 1944 o - S 17 2s 0 -5hAp 2 21hS 15 10603MarKd;O 6c7396 00O 583@F 29Ld0O 3166 1968 - May Su>=22S:6@S 24;7;99 90Jun !70r*31nS lastSuR71 1972!71Z?2OW33q 73q427U 5U7UqU+30s7suu"S SZ Europe/Rome 0:49:56 - LMT 1866 D 12 R93 O 31 231 1 I CE%sT.3*V0 1 c 4 4)8$E$) LVatican San_Marino R LV 1989 199b # iga 1:36:3 `918 Ap$2 .@1 LS 1856 3#- 595 49~/226!26011  EEd40 Au 5 3  SKy\1 JulxO 13 3 R MSK/MSD( ! !EE789  2ZEp97 Ja 2"E P2000 jA2001'3 2 &dZuricheVaduz yVilnius 1:41:1|2W~0917W05:3#KP9 O 1P1- C 20 320 O 9 1 %D-D0n 2 /AuE2C 2 Rb1991 S{F 2 c8#P1998 29 1u 1  31G2003LR LX 191!S14 23~~183 4LAp M>=159iRSUo+ 3 P2-F O23f 2 O  55$25 R LX 1922 o - O Su>=2 1 0 - R LX 1923 o - Ap 21 23 1 S72747lMar 2984X/8 r5;LAp 596,177 n8,1459$20Z Europe/Luxembourg 0:24:36 - LMT 1904 Jun 1"@CE%s18 N 25 0W29 O 6 2s 0 b 40 May 14 3 1 ca4 S 18$b Yb77 1 E1 R 7^S31 0sSx#0s 5@S 16O5b5 1979 015 #!a80 - S@ A!80e;eMalta 0:58:4_0893Kr 0s 1 I"3 D 1*81D 1997 ma -0flastSu #O 3'Chisinau 1:55:2@880 A - C18 F 15 1:44:2B31 Jul 24 2 z EP40 Au/0EES74*1c 44*24 3 R MSK/MS9u6 2 2 RX9eb7 2 MD `MonacoF9:32m20:9:21 - P!11=f29 0 F56F RN 191 0 1 NST R OfE0 AM12 5 S 78MAp M>=1 2q!SM!y%22 BQ22 19 $_Jun F2]a@6Q5S3My 223==[= 37V 6t3X34 2c-Amsterdam 0:1435 @N %s7 0N +0020/+0120 19}6{F!45o 2 1 NOzNPS 30 !R L`59 196R7xF<#5y5D6h4SPOslo 0:43 - LMT 1895 1 NO CE%sT 1940 Au 10 23 1 c5 Ap 2 2/b80 1 E& L Europe/Oslo Arctic/Longyearbyen R O 19189 - S 16 2s 0 -P9 o -l 1531 S$443WO 4 2J$450W29 0 IXN 1 0060X14 0s10O 7y!4720May{ 27K{O Su>=1989PAp 1805mxJun 2 1m5m!58O`lastSu 5n`Mar 30o5o-31t1961 - 1$603861 1964 - Vu$62"&S ZAWarsaw 1:2I`LMT 18kW0915"18Ss3 2 O E22 Jun 1 J3AI44 O)r77 1 W-W 19880R pPS17 23:kmtF 28 232192v!14i1T8R2KF 294!214k 2-O 2c26 192a3M2=Ap U2p36 a2932!32V /3 Ap `34 193?O STq 36 3Q,26A Nv 4% f 405k4g4!45r 4h5 22s 2 M  u 2Xj23 W3!Au2y"Ap"1@4]= p#5WpS? ?7L27 0s 1 S R p 1977 o - S 25 0s 0 - R p89 - Ap Su>=1 61 S 9!O 8a9 1982TlastSu 1X!80qCMar 60s W$81?"1"3A2Z Europe/Lisbon -0:36:45 - LMT 1884 `912 Jau 0 p WE%sT 19663 2 1 - CE 76'96 1* 835 1s 0 W-B 927S1 E CY096 @31 1rE0 Z Atlantic/Azores -1:42:40`1:54:3]H2u -2 p -02/-0C 42b25 22s`+00 197u 1434-174v3 Au 28444&22h4464541454!-1"1/5 -1$-0#0 jQ 1993 28-3pMadeiraK7:36F;1u mpZ+ 4 4 4 4 4 4,g R z 19321y 2(0193`O_G3?2 &79Z37 0BS_}wAp 5 2355159PA93 -7 W"ALBucharest 1:44:24RV91 O BT31 Jul 24 2 z E=!8129 2s 2 c)91(97eR7 2 E Kaliningrad 1:2U'9E 1 c4,b10 2 OG#7 3 R MSK/MSD96R/32017M+03 2014 O 2.V- EETMoscow 2:30:171680 M/!16/31:19 R %s 1919A1 0u2q P22 O E30 Jun 2159 31$2 2199FZ :MSK 6MSKSimferopol 2:16,1S24 May 2-41 NsT 1944 Ap 13 3 R MSK/MSD 1990 3 -  Jul 1 2 2 - EET ae EE%s4 May 3 e5F6 Mar 31 0s 3 1 ]6 O 27 3 v7v7=lastSu 1u 2 Eo0201or 30 2 4`O 26 2Y Z Europe/Astrakhan 3:12:1 LM2L- +03 1930 Jun 21 4 R +04/+05 1989aP3/+041 31|2 29b"+0222012 272 2201H ,Volgograd 2:57:40 - P0 Ja m61 N 182199E88@20 D36+03Saratov 3:4:18#19!0uVKfW6 D 41KirO18:4&bSamara 3:20:2 35/27$2"2/T91 S b 91q90 3cB2010UlyanovskkO3:36% 211sC Asia/Yekaterinburg 4:2:3-t!16w3 3:45:5 - Pf15 4!k5^5/+06Pk95 uL Sa+05 Z Omsk 4:53:3SN 14 , 6\6/+07(195 7 )7 Barnaul 5:3fs9 D 10 , 7\7/+081992 Ja 19 2s 7 R +07/+08 1995 May 28 6 6/+07 2011 Mar 27 2s 7 -3`4 O 26666, Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6 L1930 Jun 21"31{1992 Ja 19 33+bJul 24_ 2TomJ9:51/22CA2002/1 ,5 akuznetU48:48 24~E"10J8mKrasnoyae`6:11:2Qe 20cD ('W6201(=@IrkuYd6:57:5XE880 I%25~8P8/+09 5 99Chita 7:33:52#5 - 9\9/+10 5 1<M az6201 "Yaw`8:38:53i Vladivostok 8:47:3Zt22 N 15 l 10ml10/+11mS m 6 nyN nYKhandyga 9:2:13U?04 1 S 13 0s2-- @ Sakhalin 9:3005 Au 234A5 11~\1/+12~  77`lastSu ;2s 11 - +11 LZ Asia/Magadan 10:3:12 - LMT 1924 May 2 10 - +10 1930 Jun 21 11 R +11/+12 1991 Mar 31 2s 10P0/+11q2 Ja 1911722017!27|+12 2014 O 26~2016 Ap 241#1 Srednekolymsk@14:5Q{ Ust-Nera 9:32:54}19 D 15 8)08{9C209/_81 ApM1 S 13 0si 1KamchatkaU34:36v22 N 10I V2`12/+13:V;8199V7P2010 #28)RrAnadyr 11:49:5 R 33/+14 19821-1%JEurope/Belgrade 1:2 @884  CE4@ 18 23 1 c CE%s5%5 Qb 1 CES$2 - Q8b27 1 EM< L Ljubljana#Podgoric#SarajevoEoSkopje fZagreb ePragueratislava R s 1918 o -5 23 1 S1919 - O 6 24s 0 -9665$241;O 4L%2637M6\Sa>=1:7:9902*2033L ;O 23g2M3g32 M93L3;O 7d!42 eWS 1 14m41Ap 638!@O SuV ?A5 19?S lastSu^2Ap /4P7G"75c ,!7 76 1977 - S lastSu 1 0 - R s 1977 o - Ap 2 23 1 S8scO 1 2sJbSp 196KJun 3 123403!74e3H24 03SK"76Q- May6ZS 28 L0Au L+Z Europe/Madrid -0:14:44 - LMT 1900 D 31 23:45:16 0 s WE%s40 Mar 16 23 1 s Cb79 1 E Z Africa/Ceutac_21:16c38:44 0 - WEa!18`K3WES0O 7u+28'29Gu67 0 Sp#84a 1 - Ck*86tlantic/Canary -1:1:3 22C -A-01 1946 S 30 1y 80W6 0s 180 b1u 0 E Stockholm 1:12:12)8V:A - S'00!16- 14S1 1 C. 6 1+88@R CHn0M>=C= !O 2Zurich 0:34:8p53 Jul 9P:29:4BBZ894 Jun 1~886P#200rEO 25112EAp 3O-!R 2/*261&O 1 b4 1925 - 5eM4T } O DWG0S 2U/,Ap0 4 k`  47iAp Su>=1 5TOc9,75 P5 K26G3eOfV6 2 7Ib 73 ^K`&`9422 7o1r7r015 )71)2958lO~840 1~1093 3r ls 1 S R T 1986 1995 - S lastSu 1s 0 - R T 1994 o - Mar 2041 Sc5 2006="6"O]Z Europe/Istanbul 1:55:52 - LMT 1880 1:56:5aI910 O 2 T EE%s78 Jun 29 3 T +03/+04 1984 N 1 2-2007 2 E<B2011P7 1u wFEET 8040"30#- 010b5 O 25Q1 EES_N5 N \6 S 7 3 -- LEAsia+ =Kiev 2:2:47K52y B193071rMSK 1941 S 20 1 c C_43 N 6 3 R MSK/MSD=l^1199?s9 3 2 edXsUzhgorod 1:29:1|9`1 - CE44 O 1 1 CK@1944a'6 15 9:9 !31(9A ZaporozhyeK0:400+02>9\Au 25Q R u 19189l2 1 D !12 0@!42 @F 9 6W6!45Au 14 23u 1 PXS 30 J-67 0197$Ap8r7AJa 6F46LT8Ap Su>=1[=3 ma:8N:6 Z -\EST Z MST -7FH1HEST5EDT -5 u  Z CST6Cs6 u C%sG 7MR7 u MPPST8PP8 u PR NY 1920J _1 1964!5}= $55A aZ America/New_York -4 8}u2:3:58 !NY&256 67Q R ChC?%130192 ;1;S?2j!6 6Chicago -5:50:3C6d9:24 -8Ch C%sT 1936 Mar 1 2 -5 - EST 1936 N 156 Ch C%su42 -6 u6 67# Z America/North_Dakota/Center -6:45:12 - LMT 1883r8 12:14:48 -7 u Mxc92 O 2` New_Salemc/39c'21c@2003c6c aBeulah`?7:7_I2:53_i10 N 7^R De 19201 - Mar lastSu 2 1 D "Vo - O50 S 1 May 22 2 65 1966 - Ap<Y! \BDenv@59:5L 70:4$De5*465 R CA 1948r 14 2:19EJa 15J :!kS1A$621Los_Angeles -7:52:587:2 -8 u P8+Juneau 15:2:1p67 O 19@33:3[P:57:4p900 Au LA - P|gX6 69 80(2R9 u Y%80J8/ 30,@30 -WAK%sTSitka 14:58:47:T:1:13S2MetlakatlasF13:444:55 -8:46:1<X@2015#s_ 2018 N 4*@9 Ja2pYakutat041:F88 -9:18:5" Yh4h%AnchorageD0:24 p4:31:37E59:3 10b10 u Ar67 Ap -"H##H$ @NomeO58:2/3:29:35 -11:1:3u Nb11 u NU1B11B1u AK%sT Z America/Adak 12:13:22 - LMT 1867 O 1944:35 -11:46:38#900 Au 20 12 - NST 194Qu N%s6S67 ApB1!692u B183 O 30 He0 u AHpN 30 -1 Z Pacific/Honolulu -10:31:26896 Ja 130:30 - H{U33 Apl@1 HD33 May 216 u us7 Jun 8NR Z AmSPhoenix -7:28:13883 N 18 11)R7 u M!44 0:1 -7 - M 441/%O . 67<%68 Mar 2RPBoiseU44:49/2:15:11 -8 u P2 13 74xY74 F #P R In:Q1 o ->22 2 1 D1954 - S lastSu 2 0 S #6 &Ap!AzIndiana/polis -5:22 -6 u C0$In*46 55 24Q5 - Ep57 S 29C8+7+R5 u ED71 -@2006P R MaC   C;P4 196>! AcqMarengo^O5:23@@4:370^ 51$Ma^ 61,1968Q6 1 Cc74 O 2M"A 1971 ?V6 R  53|< G?5xT31 0X6?X!609O<6 q 62X ;Vincenne+050:} @9:53 V2 2Xs2007 N PP R Pe~D  e!/61.Tell_City 7:c .J12:5//Pe0 x9) N 9i9 1 0 1 D R Pi 1955 1960 - S lastSu 2 0 S R P 6 f4 - Ap!41 D!$61!O A8Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 12:10:53 -6 u C%sT3Pi  6525 2 -5 - EST`6 O 30<%77+A2006A +2007 N 45 u E%sT R St 1947`1!5& F f[56 - %a5a/58@9 @eAKnox_06:3`@3:30Q` 47%St`29 ``3 O 27`%91` /uKPP!KP K K+sWinamac.2.5.6P 61.yC9GP 1971K`Mar 11cQVevay00:1T@9:44 54 3 3 R v 1921 o - May 1 2 S0404 16i970:1o4UJun 28$50(; 5w5gKentucky/Louisville?3:2I6:58 21vl 424]61 Jul 23@F1968]`4 Ja 6$`6 1 CD'74LMonticello@39:2 RA20:3 2- C}@2000}A}1R DL8 qDetroit02:1!90"15 #mYG!Dt9 7 SQ14 0:)7( 75G(lQ R Meq ;6;Menominee -5:50:27 - LMT 1885 S 18 12 -6 u C%sT 1946$Me69 Ap 27 2 -5 - ES&!739= R C 1918 o -14 2 1 DOMC 0 S!4211F 9/W50Au Hj3u 1 PgS 30 2Jr74 1986~alastSuS`74 200 %O $87Ap Su>=1>2007 ma - Mar8N:Yj7&p 4ES 1790May 5 23D2d`20 1937;!3=[ 361y M>=9 0zOw}4<#50<}  O2/51 l59 - S68}W1 0:1=!8?02 DS}-894@jU1W8"=< Z America/St_Johns -3:30:52 - L%4 2j N&18C9*!35"30 042 I#11G!+i2011 N& Goose_Bay -4:1:41- NW) 6A1966  15P4 j AN14 C@ R H6EAp 1(O/!20/SX0@Au 22126b2/2SS 5 0LJ ApZ3 192 :S 4P4;S 1hJS 28010S 1s2 0S 2I18OyLo+S MR*S 3 3c3cJM>=23g!330O3`I2!S H2z1JunK1K]3yJun 1 0 1 D R H 1936 o - S 14 0 0 S R 78 - May Su>=1 0 1 D !41;KM>=2>9V;)288Q40 198X 46 9 - Ap lastSu 2x S51 1954? ?~5~5 ?62 1973~ O Z America/Halifax -4:14:2 LMT 1902 Jun 15 -4 H A%s 18C942 F 9 2s% 46% 74 Glace_Bay -3:59:4 9v3HW5W@- AS)72 t0R ol315 -38 1 S3%>< >>7v9ZSa>=29%40)199%414/72$!56Y5? CF`93 200>!Ap'@1 0:_!@!aqMoncton 9:V883 D 9 -E  3 o47-9@20079Blanc-Sablg3:48:2|50D R t 191r 30 23:3EO 26%202S1*152!S ~2B2B88 W?i4 1927>>3 ?2?8> F?3 /40 3?  45M 4[ 4 {?Nw5<5<2'pn>lToronto -5:17:3m 95i3C Ext%5 %[%5 %g=ica/Thunder_Bay -5:57 - LMT 1895 -6 - CST 1910 -5 - E 42PC E%s7t3, 74, Z America/Nipigonu93:4w"5 / 1940 S 29C@1 EDn42 F 9 2s)XRainy_River -6:18:12C C]\6 1 C]"6 )]AtikokanZI6:280Y )q5 S 30 P2@ R Wp6 o - Ap 23 0 1 DS 17 0 0 S81H14 21gO 27 21!371iMay 1620S 2c!422}C 1 Wz!450Au zj3u 1 PS lastSu42JO 132729R4 q!50q p"51 1960p 5p9pO68!638&Ap90S 24`66 1988s`66 200s$87 Ap Su>=1 2@Winnipeg@28:3oY87 Jul 164W`1200F0R r!Ap- `30 193  O1=8Mf:Q1k9U 9&5& &8n+ v5<GFbSw 195V:;W6W>>6(> `Regina5905 S -7 r M 60yb Swift_Current -7:11:2*RCR*46Rm 50|$Sw+*72+eCST R EdA3191 >FS R Ed 1920 1923 - Ap lastSu 2 1 D R Ed 1920 o - O50 S1">S !42=1F 9UW8!45Au 14 23u 1 PQ794;72 1986`72 200! Z America/Edmonton -7:33:52 - LMT 1906 S -740M%s 87 C  R Va 1918grO 27 2 cCCKS 30M6:60S 27 1961 - ^96=Vancouver -8:12:28>`884 -8#P<@8 C  Dawson_CreekE00:5D4Z 1947SQ72 AuW- MSTZFort_Nels8:10:47 46[@- PS i 2015 Mar 8 2xCCresPI46:4sMcH16 Osh18 JunR?R Y_ ^9aMay 25SN 1 0 63D /80Z/80?7Ap Su>=1hPangnirtung 0 - -0s21 -4 Y A 953As -5 C E`9 O 31P6 C Ca2000 OW,wIqaluito4,YX)ResoluteY7 o1 -6 YP- EST&101 3+6+71-Rankin_Inle 57[YCambridge_Bay 20pYO 199P0 N 5<- C#7 .Yellowkniff)358 <gInuvik 53YP 1979RWhitehorse -9:0:109 Y Y%sT 1967 May 28 -8 Y P%sT 1980C2020 N -7 - MST Z America/Dawson -9:17:40 - LM?00 Au 20 -9 Y YTO73 OhR m 1939 o - F 5 0 1 D PJun 230 S!4019D 91!41wAp 1 0 /3AD 160WG4 15`AF 121PJul 3ac`96 200Ap Su>=1 2O lastSu Z2200 <S92 ma - u3200 sCancun -5:47:4P22 JaC:12:56 -6 - CS81 D 23 -5 m E!98  2)0m C2015 F 1Y5 - ET`Meridax_58:28y!:3OxM2tMatamoros -62`31 23:8Hu@19890fonterreyf01:1PiP18:44@l]exico_Cit_G36:3_4` 1927 0!103x30 N 15+!31I31 O'@2 Ap!@01 SmF"6 )pOjinaga(5Ej2K9A 1998T33m M0uChihuahua -7:4:2  A55:4?fHermosilloV23:52P@36:8X4) 2!4941- P7rE1999Mazatlan5=S!rica/Bahia_Banderas -7:1 - LMT 1921 D 31 23:59 -7 - MS7 Jun 10 23 -6 - Cx30 N 15+p31 May E *91 O'H2 Ap!48 24%49 Ja 14 -8 - Ps 70"m M%sT 2010 Ap 4 2L m C%sT Z America/TijuanaF48:42Y 0:11:56R n2!31`8 1 PD5x31 S 30'W'45 Au 14 23u,C1 PP@N 12 485e#5@CA P$@19612E 76u9m1200,2002 F 2#1# R BS 1942 o.U4 1 W4YU4 0 S5YF 1 02R 4iO 17 2N64 1975 - O lastSu 2n &Ap!71 D0Nassau -5:9:30/`12 Mard5EWI@5 u B7-@2 2 _3R B01970vO Su>=1P8 198t"Ap 5@9[S :#8022`Barbados -3:58:29jBP32 -4AGR BZ 1914%AO Sa14 0@0530'91- F'84CST"$2F1 CW,CPND 15XP7 196 46!73I1D 5%CD7pF 9 0 08LD 1858O0F 16Pelizek@52:41PBZ %sgeX1Ap ;1 -8PAp 1355SOi0a 1O3" 4OUM478 !Nj=lS;Z1R B#52>2 "AA!56X| >  Z Atlantic/Bermuda -4:19:1E890 Be BMT/B"30 e m4 2854 C6uP R CR+9 1980 - F lastSu 0 1 D R CR 1979 1980 - Jun Su>=1 0 0 S!p91 1992!a Sa>=15B@91 o