DfZdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddlm Z ddl m Z mZ ddlmZn#e$r ddlmZYnwxYwgdZGdd eZeZd ZGd d eZeZeeeegZGd deZeeZde_dZdZ dZ!dZ"dDdZ#e#Z$dZ%GddZ&e&Z'e'ej(Z)de)_GddZ*dZ+dZ,dEdZ-dZ.Gd d!Z/e/Z0dFd#Z1d$Z2d%Z3d&Z4d'Z5d(Z6d)Z7dGd+Z8dHd,Z9dEd-Z:dEd.Z;dEd/Zd2Z?d3Z@d4ZAdEd5ZBGd6d7ZCeCZDGd8d9ZEeEZFdEd:ZGGd;dZKe)d?ZLdEd@ZMGdAdBZNeOdCkrddlPZPePjQdSdS)Iz$ General Utilities (part of web.py) N)local) iteritems itervalues)StringIO)1StoragestoragestorifyCountercounteritersrstripslstripsstrips safeunicodesafestr timelimitMemoizememoize re_compilere_submgroupuniqiterview IterBetter iterbettersafeiter safewrite dictreversedictfind dictfindalldictincrdictaddrequeuerestacklistgetintgetdatestrnumifydenumifycommifydateifynthstrcond CaptureStdout capturestdoutProfileprofiletryall ThreadedDict threadeddict autoassignto36sendmailc*eZdZdZdZdZdZdZdS)rao A Storage object is like a dictionary except `obj.foo` can be used in addition to `obj['foo']`. >>> o = storage(a=1) >>> o.a 1 >>> o['a'] 1 >>> o.a = 2 >>> o['a'] 2 >>> del o.a >>> o.a Traceback (most recent call last): ... AttributeError: 'a' cV ||S#t$r}t|d}~wwxYwNKeyErrorAttributeErrorselfkeyks 8/var/www/media/lib/python3.11/site-packages/web/utils.py __getattr__zStorage.__getattr__fs> $9  $ $ $ ## # $s (#(c|||<dSr;r@rAvalues rC __setattr__zStorage.__setattr__lsS cP ||=dS#t$r}t|d}~wwxYwr;r<r?s rC __delattr__zStorage.__delattr__os? $S  $ $ $ ## # $s % %cBdt|zdzS)Nz dict__repr__r@s rCrQzStorage.__repr__uT]]4000366rJN)__name__ __module__ __qualname____doc__rDrIrLrQrFrJrCrrQsZ($$$ $$$ 77777rJrcp |ddt durtdr  fd fdt}|t |zD]}||}t |tr?t ||trfd|D}n|d}t ||ts |}t ||trt |ts|g}t|||t|D]N\}}|}t||r||}|dkrt |ts|f}t|||O|S) a  Creates a `storage` object from dictionary `mapping`, raising `KeyError` if d doesn't have all of the keys in `requireds` and using the default values for keys found in `defaults`. For example, `storify({'a':1, 'c':3}, b=2, c=0)` will return the equivalent of `storage({'a':1, 'b':2, 'c':3})`. If a `storify` value is a list (e.g. multiple values in a form submission), `storify` returns the last element of the list, unless the key appears in `defaults` as a list. Thus: >>> storify({'a':[1, 2]}).a 2 >>> storify({'a':[1, 2]}, a=[]).a [1, 2] >>> storify({'a':1}, a=[]).a [1] >>> storify({}, a=[]).a [] Similarly, if the value has a `value` attribute, `storify will return _its_ value, unless the key appears in `defaults` as a dictionary. >>> storify({'a':storage(value=1)}).a 1 >>> storify({'a':storage(value=1)}, a={}).a >>> storify({}, a={}).a {} _unicodeF__call__cLr t|tr |S|Sr;) isinstancestr)srY to_unicodes rC unicodifyzstorify..unicodifys/   1c** :a== HrJct|drt|dr|jSt|dr|jS|S)NfilerH)hasattrrH)xr`s rCgetvaluezstorify..getvalues_ 1f   '!W"5"5 7N Q  9QW%% %9Q<< rJc&g|] }|SrFrF).0rdres rC zstorify..s!444!444rJrF) poprrcrtuplekeysr\listgetrPsetattrr) mapping requiredsdefaultsstorrArHresultrYrer_r`s @@@@rCr r |sB||J..HJu:!>!>        99D5000 " "  eT " " "(,,s++T22 "4444e444b (,,s++T22 $HUOOE hll3'' . . z%7N7N GEc5!!!!!(++## e 4   #YF B;;z&%88;YFc6"""" KrJcBeZdZdZdZdZdZdZdZdZ dZ d Z d S) r aKeeps count of how many times something is added. >>> c = counter() >>> c.add('x') >>> c.add('x') >>> c.add('x') >>> c.add('x') >>> c.add('x') >>> c.add('y') >>> c['y'] 1 >>> c['x'] 5 >>> c.most() ['x'] cR||d||xxdz cc<dS)Nrr setdefault)r@ns rCaddz Counter.adds/ 1 Q1 rJcrtt|fdt|DS)z$Returns the keys with maximum count.c&g|] \}}|k |SrFrFrgrBvms rCrhz Counter.most.."888daarJ)maxrrr@rs @rCmostz Counter.mosts8  4  ! !8888ioo8888rJc|t|fdt|DS)z$Returns the keys with minimum count.c&g|] \}}|k |SrFrFr}s rCrhz!Counter.least..rrJ)minrrrs @rCleastz Counter.leasts: !! " "8888ioo8888rJcpt||t|z S)aReturns what percentage a certain key is of all entries. >>> c = counter() >>> c.add('x') >>> c.add('x') >>> c.add('x') >>> c.add('y') >>> c.percent('x') 0.75 >>> c.percent('y') 0.25 )floatsumvaluesr@rAs rCpercentzCounter.percents+T#Y#dkkmm"4"444rJcRtfddS)zReturns keys sorted by value. >>> c = counter() >>> c.add('x') >>> c.add('x') >>> c.add('y') >>> c.sorted_keys() ['x', 'y'] c|Sr;rF)rBr@s rCz%Counter.sorted_keys..s arJT)rAreverse)sortedrlrRs`rC sorted_keyszCounter.sorted_keyss,diikk'8'8'8'8$GGGGrJcDfdDS)zReturns values sorted by value. >>> c = counter() >>> c.add('x') >>> c.add('x') >>> c.add('y') >>> c.sorted_values() [2, 1] c g|] }| SrFrFrgrBr@s rCrhz)Counter.sorted_values..s444AQ444rJrrRs`rC sorted_valueszCounter.sorted_valuess+5444!1!1!3!34444rJcDfdDS)zReturns items sorted by value. >>> c = counter() >>> c.add('x') >>> c.add('x') >>> c.add('y') >>> c.sorted_items() [('x', 2), ('y', 1)] c$g|] }||f SrFrFrs rCrhz(Counter.sorted_items..s!999DG 999rJrrRs`rC sorted_itemszCounter.sorted_itemss+:999d&6&6&8&89999rJcBdt|zdzS)Nz >> rstrips("foobar", "bar") 'foo' rrrrs rCrrDs 3f % %%rJc$td||S)aF removes the string `remove` from the left of `text` >>> lstrips("foobar", "foo") 'bar' >>> lstrips('http://foo.org/', ['http://', 'https://']) 'foo.org/' >>> lstrips('FOOBARBAZ', ['FOO', 'BAR']) 'BAZ' >>> lstrips('FOOBARBAZ', ['BAR', 'FOO']) 'BARBAZ' rrrs rCrrOs 3f % %%rJc>tt|||S)zz removes the string `remove` from the both sides of `text` >>> strips("foobarfoo", "foo") 'bar' )rrrs rCrr`s 74((& 1 11rJutf-8c\|rt|dr d|DSt|S)z Converts any given object to utf-8 encoded string. >>> safestr('hello') 'hello' >>> safestr(2) '2' __next__c,g|]}t|SrFr)rgis rCrhzsafestr..vs(((q (((rJ)rcr])objencodings rCrrks< wsJ''((C((((3xxrJcfd}|S)a A decorator to limit a function to `timeout` seconds, raising `TimeoutError` if it takes longer. >>> import time >>> def meaningoflife(): ... time.sleep(.2) ... return 42 >>> >>> timelimit(.1)(meaningoflife)() Traceback (most recent call last): ... RuntimeError: took too long >>> timelimit(1)(meaningoflife)() 42 _Caveat:_ The function isn't stopped after `timeout` seconds but continues executing in a separate thread. (There seems to be no way to kill a thread.) inspired by cfd}|S)NcGfddtj}|}||rt d|jr |jd|jS)Nc$eZdZdZfdZdS)3timelimit.._1.._2..Dispatchctj|d|_d|_|d|dSNT) threadingThread__init__rterror setDaemonstartrRs rCrz._1.._2..Dispatch.__init__sJ$--d333"&DK!%DJNN4(((JJLLLLLrJcd i|_dS#tj|_YdSxYwr;)rtsysexc_infor)r@argsfunctionkws rCrunz7timelimit.._1.._2..Dispatch.runs>4&.h&;&;&; 4%(\^^ s /N)rTrUrVrr)rrrsrCDispatchrsG!!!444444444rJrz took too longr)rrjoinis_alive RuntimeErrorrrt)rrrcrtimeouts`` rC_2z!timelimit.._1.._2s 4 4 4 4 4 4 4 4 49+ 4 4 4 A FF7OOOzz|| 4"?333w !gaj 8OrJrF)rrrs` rC_1ztimelimit.._1s)      0 rJrF)rrs` rCrrs#.6 IrJc eZdZdZddZdZdS)ra 'Memoizes' a function, caching its return values for each input. If `expires` is specified, values are recalculated after `expires` seconds. If `background` is specified, values are recalculated in a separate thread. >>> calls = 0 >>> def howmanytimeshaveibeencalled(): ... global calls ... calls += 1 ... return calls >>> fastcalls = memoize(howmanytimeshaveibeencalled) >>> howmanytimeshaveibeencalled() 1 >>> howmanytimeshaveibeencalled() 2 >>> fastcalls() 3 >>> fastcalls() 3 >>> import time >>> fastcalls = memoize(howmanytimeshaveibeencalled, .1, background=False) >>> fastcalls() 4 >>> fastcalls() 4 >>> time.sleep(.2) >>> fastcalls() 5 >>> def slowfunc(): ... time.sleep(.1) ... return howmanytimeshaveibeencalled() >>> fastcalls = memoize(slowfunc, .2, background=True) >>> fastcalls() 6 >>> timelimit(.05)(fastcalls)() 6 >>> time.sleep(.2) >>> timelimit(.05)(fastcalls)() 6 >>> timelimit(.05)(fastcalls)() 6 >>> time.sleep(.2) >>> timelimit(.05)(fastcalls)() 7 >>> fastcalls = memoize(slowfunc, None, background=True) >>> threading.Thread(target=fastcalls).start() >>> time.sleep(.01) >>> fastcalls() 9 NTc|||_i|_||_||_i|_t j|_dSr;)funccacheexpires backgroundrunningrLock running_lock)r@rrrs rCrzMemoize.__init__s;   $ %N,,rJc<tfj5jst jj<dddn #1swxYwYdfd }jvr |dnpjritj jdz jkr9j r(t j | n |jdS) NFc$j|rn jitjfj<jdS#jwxYwdSr;)racquirertimerrelease)blockrrAkeywordsr@s rCupdatez Memoize.__call__..updates|C ((// 00'0ty$'C('C'CTY[[&QDJsOL%--/////DL%--////  0 0s (A,,!B T)rr)targetr)F) rkitemsrrrnrrrrrrrr)r@rrrrAs``` @rCrZzMemoize.__call__ssU8>>++,,-   5 5<##C(( 5$-N$4$4 S! 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 0 0 0 0 0 0 0 0 0 dj F      \ ty{{TZ_Q-??4<OO  ///557777z#q!!s6A11A58A5rrTrUrVrWrrZrFrJrCrrsB11f----"""""rJrz# A memoized version of re.compile. ceZdZdZdZdS)_re_subm_proxycd|_dSr;matchrRs rCrz_re_subm_proxy.__init__s  rJc||_dS)Nr)r@rs rCrZz_re_subm_proxy.__call__s rrJN)rTrUrVrrZrFrJrCrrs2rJrct|}t}||j|||||jfS)z Like re.sub, but returns the replacement _and_ the match object. >>> t, m = re_subm('g(oo+)fball', r'f\1lish', 'goooooofball') >>> t 'foooooolish' >>> m.groups() ('oooooo',) )rrsubrZr)patreplstring compiled_patproxys rCrrsOc??L   EU^V,,,   D& ) )5; 66rJc\fdtdtDS)z Returns an iterator over a series of lists of length size from iterable. >>> list(group([1,2,3,4], 2)) [[1, 2], [3, 4]] >>> list(group([1,2,3,4,5], 2)) [[1, 2], [3, 4], [5]] c32K|]}||zVdSr;rF)rgrseqsizes rC zgroup..1s0 @ @!CAH  @ @ @ @ @ @rJr)ranger)rrs``rCrr(s6 A @ @ @ @uQC$'?'? @ @ @@rJc|pd}t}g}|D]<}||}||vr||||=|S)at Removes duplicate elements from a list while preserving the order of the rest. >>> uniq([9,0,2,1,0]) [9, 0, 2, 1] The value of the optional `key` parameter should be a function that takes a single argument and returns a key to test the uniqueness. >>> uniq(["Foo", "foo", "bar"], key=lambda s: s.lower()) ['Foo', 'bar'] c|Sr;rFrds rCrzuniq..AsArJ)setrzappend)rrAseenrtr~rBs rCrr4so  ++C 55D F  CFF 99    a MrJc #n Kdd dd fd}tj}t|}t|D]6\}}tjd||||z|V7tjd|||dz|zdzd S) z Takes an iterable `x` and returns an iterator over it which prints its progress to stderr as it iterates through. Fcndt||z dztt|||fzS)Nz%5.1f%% (%*d/%d)d)rrr])rylenxs rC plainformatziterview..plainformatTs2!eAhho%.barsWsh588d?d*S011 #: SD3J/44GGG99ggg..rJc|dkrdS||krt|}nt||z ||z z}t|d\}}t|d\}}d|||fzS)Nrz--:--:--<z%02d:%02d:%02d)r divmod)elapsedryrsecsminshrss rCetaziterview..eta_sx 66: 99w<.formatksk!T""S( 99CCC ss49;;*At444 ttECHH$s3xx/D999 s  rJ r N)rr enumeraterstderrwrite) rdrrrryyrrrrs @@@@rCrrMs EWWW/// 4 4 4         I q66D! 1 y!T : ::;;;JTFF9a!eT:::TABBBBBrJc6eZdZdZdZddZdZdZdZeZ dS) ra Returns an object that can be used as an iterator but can also be used via __getitem__ (although it cannot go backwards -- that is, you cannot request `iterbetter[0]` after requesting `iterbetter[1]`). >>> import itertools >>> c = iterbetter(itertools.count()) >>> c[1] 1 >>> c[5] 5 >>> c[3] Traceback (most recent call last): ... IndexError: already passed 3 It is also possible to get the first value of the iterator or None. >>> c = iterbetter(iter([3, 4, 5])) >>> print(c.first()) 3 >>> c = iterbetter(iter([])) >>> print(c.first()) None For boolean test, IterBetter peeps at first value in the itertor without effecting the iteration. >>> c = iterbetter(iter(range(5))) >>> bool(c) True >>> list(c) [0, 1, 2, 3, 4] >>> c = iterbetter(iter([])) >>> bool(c) False >>> list(c) [] c$|dc|_|_dS)Nr)rr)r@iterators rCrzIterBetter.__init__s!1rJNc` tt|S#t$r|cYSwxYw)zReturns the first element of the iterator or None when there are no elements. If the optional argument default is specified, that is returned instead of None when there are no elements. )nextiter StopIteration)r@defaults rCfirstzIterBetter.firsts? T ## #   NNN s  --c#Kt|dr |jV t|jVn#t$rYdSwxYw|xjdz c_:)N_headr)rcr/r)rr+rrRs rC__iter__zIterBetter.__iter__s} 4 ! ! *     46ll""""      FFaKFF  s5 AAch||jkrtdt|z ||jkr/t|j|xjdz c_||jk/|xjdz c_t|jS#t $rtt|wxYw)Nzalready passed r)r IndexErrorr]r)rr+)r@rs rC __getitem__zIterBetter.__getitem__s tv::.Q788 8 %df**TV ! df** FFaKFF<<  % % %SVV$$ $ %s AB 'B1ct|dr|dkSt|drdS t|j|_dS#t $rYdSwxYw)N__len__rr/TF)rcr5r)rr/r+rRs rC __nonzero__zIterBetter.__nonzero__s} 4 # # <<>>Q& & T7 # # 4 !$&\\ t!   uu sA A%$A%r;) rTrUrVrWrr-r0r3r6__bool__rFrJrCrr~sp&&P%%%        % % %   HHHrJrTc#PKfdt V )zPMakes an iterator safe by ignoring the exceptions occurred during the iteration.ch S#t$rtjYnxYw1r;)r+ traceback print_exc)itr)srCr)zsafeiter..nextsR & &tBxx     &#%%%%%  &s 0)r*)r<cleanup ignore_errorsr)s` @rCrrsL&&&&&& bBdff rJct|dzd5}||dddn #1swxYwYtj|j|dS)zWrites the content to a temp file and then moves the temp file to given filename to avoid overwriting the existing file in case of errors. z.tmpwN)openr#shutilmovename)filenamecontentfs rCrrs h % %  K!!!!!s 6::cNtdt|DS)z| Returns a new dictionary with keys and values swapped. >>> dictreverse({1: 2, 3: 4}) {2: 1, 4: 3} cg|] \}}||f SrFrF)rgrArHs rCrhzdictreverse..s EEE,3%EEErJ)rPr)rps rCrrs) EE)G2D2DEEE F FFrJc@t|D] \}}||ur|cSdS)z Returns a key whose value in `dictionary` is `element` or, if none exists, None. >>> d = {1:2, 3:4} >>> dictfind(d, 4) 3 >>> dictfind(d, 5) N)r) dictionaryelementrArHs rCr r sB"*-- e e  JJJ rJcfg}t|D]\}}||ur|||S)z Returns the keys whose values in `dictionary` are `element` or, if none exists, []. >>> d = {1:4, 3:4} >>> dictfindall(d, 4) [1, 3] >>> dictfindall(d, 5) [] )rr)rKrLresrArHs rCr!r!sD C!*-- e e   JJsOOO JrJc^||d||xxdz cc<||S)z Increments `element` in `dictionary`, setting it to one if it doesn't exist. >>> d = {1:2, 3:4} >>> dictincr(d, 1) 3 >>> d[1] 3 >>> dictincr(d, 5) 1 >>> d[5] 1 rrrw)rKrLs rCr"r"'sA'1%%%w1 g rJc>i}|D]}|||S)z Returns a dictionary consisting of the keys in the argument dictionaries. If they share a key, the value from the last argument is used. >>> dictadd({1: 0, 2: 0}, {2: 1, 3: 1}) {1: 0, 2: 1, 3: 1} )r)dictsrtdcts rCr#r#;s2F c MrJric\||}|d||S)zReturns the element at index after moving it to the beginning of the queue. >>> x = [1, 2, 3, 4] >>> requeue(x) 4 >>> x [4, 1, 2, 3] r)rjinsert)queueindexrds rCr$r$Is.  %A LLA HrJcZ||}|||S)zReturns the element at index after moving it to the top of stack. >>> x = [1, 2, 3, 4] >>> restack(x) 1 >>> x [2, 3, 4, 1] )rjr)stackrVrds rCr%r%Ws)  %A LLOOO HrJcBt|dz |kr|S||S)z Returns `lst[ind]` if it exists, `default` otherwise. >>> listget(['a'], 0) 'a' >>> listget(['a'], 1) >>> listget(['a'], 1, 'b') 'b' r)r)lstindr,s rCr&r&es' 3xx!|c s8OrJcT t|S#ttf$r|cYSwxYw)z Returns `integer` as an int or `default` if it can't. >>> intget('3') 3 >>> intget('3a') >>> intget('3a', 0) 0 )r  TypeErrorr)integerr,s rCr'r'ts<7|| z "s ''c|dd}d}|sdS|stj}t|jdkrtj|}t|jdkr tj|}n=t|jdkr%tj|j|j|j}||z }t|j |z|j z|j dzz}t||z}|dkr|d z}|rmt|d kr ||d S| d d d}|j|jks|dkr |d|jzz }|St|rLt|dkr ||ddSt|dkr ||ddS||dS|j }|j rt|j dz }t|dkr ||ddS||dS)ab Converts a (UTC) datetime object to a nice string representation. >>> from datetime import datetime, timedelta >>> d = datetime(1970, 5, 1) >>> datestr(d, now=d) '0 microseconds ago' >>> for t, v in iteritems({ ... timedelta(microseconds=1): '1 microsecond ago', ... timedelta(microseconds=2): '2 microseconds ago', ... -timedelta(microseconds=1): '1 microsecond from now', ... -timedelta(microseconds=2): '2 microseconds from now', ... timedelta(microseconds=2000): '2 milliseconds ago', ... timedelta(seconds=2): '2 seconds ago', ... timedelta(seconds=2*60): '2 minutes ago', ... timedelta(seconds=2*60*60): '2 hours ago', ... timedelta(days=2): '2 days ago', ... }): ... assert datestr(d, now=d+t) == v >>> datestr(datetime(1970, 1, 1), now=d) 'January 1' >>> datestr(datetime(1969, 1, 1), now=d) 'January 1, 1969' >>> datestr(datetime(1970, 6, 1), now=d) 'June 1, 1970' >>> datestr(None) '' Nc|r||z}tt|dz|z}t|dkr|dz }|dz }|dkr|dz }n|dz }|S)Nr rr^rzfrom nowago)r]abs)rywhatdivisorrs rCagohencezdatestr..agohencesr  W A#a&&kkC$& q66Q;; 3JC s  q55 : CC 5LC rJiQrDateTimedategư>rridayz%B %dz 0 z, %sihourrminutesecondg.Ai millisecond microsecondr;)datetimeutcnowtyperT fromtimestampyearmonthrir daysseconds microsecondsrbstrftimereplace) thennowreonedaydelta deltaseconds deltadaysrdeltamicrosecondss rCr(r(sr<    F r )&&(( CyyZ''--c22 Dzzj(( ..t44 d  & & DJAA $JEuzF*U]:U=ORW=WWXXLL!!V+IaR   y>>A  8Iu-- -mmG$$,,T488 9 IMM 6DI% %C  <4 |   ( (8L&':: :    # #8L(B77 78L(33 3* z: 2S 899 $$x)=$??? 8%} 5 55rJcZddt|DS)z Removes all non-digit characters from `string`. >>> numify('800-555-1212') '8005551212' >>> numify('800.555.1212') '8005551212' rc:g|]}||SrF)isdigit)rgrs rCrhznumify..s%:::!aiikk:A:::rJ)rr])rs rCr)r)s+ 77::s6{{::: ; ;;rJcg}|D]C}|dkr&||d|dd}.||Dd|S)z Formats `string` according to `pattern`, where the letter X gets replaced by characters from `string`. >>> denumify("8005551212", "(XXX) XXX-XXXX") '(800) 555-1212' XrrNr)rr)rpatternrrs rCr*r*sg C  88 JJvay ! ! !ABBZFF JJqMMMM 773<<rJc|dSt|}|drd}|dd}nd}d|vr|d\}}n|d}}g}t t|dddD]8\}}|r|dzs|dd |d|9d|}|r|d|zz }||zS) a Add commas to an integer `n`. >>> commify(1) '1' >>> commify(123) '123' >>> commify(-123) '-123' >>> commify(1234) '1,234' >>> commify(1234567890) '1,234,567,890' >>> commify(123.0) '123.0' >>> commify(1234.5) '1,234.5' >>> commify(1234.56789) '1,234.56789' >>> commify(' %.2f ' % -1234.5) '-1,234.50' >>> commify(None) >>> N-rr.rir,)r]striprsplitr!rTr)ryprefixdollarscentsrrrrs rCr+r+s4 yt A A||C abbEKKMM axxD A#g,,ttt,--1  q1u  HHQ    A ''!**C  sU{ C<rJc"t|dS)z3 Formats a numified `datestring` properly. zXXXX-XX-XX XX:XX:XX)r*) datestrings rCr,r,:s J 5 6 66rJcj|dksJ|dzdvrd|zSdddd|d zd|zS) a) Formats an ordinal. Doesn't handle negative numbers. >>> nthstr(1) '1st' >>> nthstr(0) '0th' >>> [nthstr(x) for x in [2, 3, 4, 5, 10, 11, 12, 13, 14, 15]] ['2nd', '3rd', '4th', '5th', '10th', '11th', '12th', '13th', '14th', '15th'] >>> [nthstr(x) for x in [91, 92, 93, 94, 99, 100, 101, 102]] ['91st', '92nd', '93rd', '94th', '99th', '100th', '101st', '102nd'] >>> [nthstr(x) for x in [111, 112, 113, 114, 115]] ['111th', '112th', '113th', '114th', '115th'] rr) z%sthz%sstz%sndz%srd)rr )rn)rys rCr-r-AsS$ 66663w,z&V , , 0 0R @ @1 DDrJc|r|S|S)z Function replacement for if-else to use in expressions. >>> x = 2 >>> cond(x % 2 == 0, "even", "odd") 'even' >>> cond(x % 2 == 0, "even", "odd") + '_row' 'even_row' rF) predicate consequence alternatives rCr.r.YsrJceZdZdZdZdZdS)r/z Captures everything `func` prints to stdout and returns it instead. >>> def idiot(): ... print("foo") >>> capturestdout(idiot)() 'foo\n' **WARNING:** Not threadsafe! c||_dSr;rr@rs rCrzCaptureStdout.__init__u  rJct}tj}|t_ |j|i||t_n#|t_wxYw|Sr;)rrstdoutrre)r@rrr oldstdouts rCrZzCaptureStdout.__call__xs_jjJ   # DIt (x ( ( ("CJJCJ " " " "||~~s AANrrFrJrCr/r/is<  rJr/ceZdZdZdZdZdS)r1a  Profiles `func` and returns a tuple containing its output and a string with human-readable profiling information. >>> import time >>> out, inf = profile(time.sleep)(.001) >>> out >>> inf[:10].strip() 'took 0.0' c||_dSr;rrs rCrzProfile.__init__rrJcddl}ddl}ddl}ddl}|\}}|j||}tj} |j|j g|R} tj| z } t} | || } | | dd| d| dt!| zdz} | | z } |j|n#t&$rYnwxYw| | fS)Nr)streamrcalls(z took z seconds )cProfilepstatsostempfilemkstempcloser1rruncallrrStats strip_dirs sort_stats print_stats print_callersr]rerIOError)r@rrrrrrGrEprofstimertrstatsrds rCrZzProfile.__call__sj  &&(( 8 !! di/$/// e#jj T# ..  ))) "  #e** $| 3 S\\^^  BIh        D qys-D>> E  E NrrFrJrCr1r1s<  rJr1c |}i}t|D]\}}t|ds|r||s.t |dzd |}t ||t |m#t dt |dt ddtj dzYxYwt d t d t|D]&\}}t d t|dz|'d S) aZ Tries a series of functions and prints their results. `context` is a dictionary mapping names to values; the value will only be tried if it's callable. >>> tryall(dict(j=lambda: True)) j: True ---------------------------------------- results: True: 1 For example, you might have a file `test/stuff.py` with a series of functions testing various things in it. At the bottom, have a line: if __name__ == "__main__": tryall(globals()) Then you can run `python test/stuff.py` and get the results of all the tests. rZ:r )rERRORz z r z(----------------------------------------zresults:rjN) copyrrcrprintr"rr: format_excrr])contextrresultsrArHrs rCr3r3si*llnnGG!'** L L euj))    #..00   cCiS!!!! LA Wa !HHHH L 'NNN Wg & & & %',,y';'='='C'CD'I'IJJJ K K K K K (OOO *!'**.. e gs3xx#~u----..s ))BA*C?ceZdZdZeZdZdZdZdZ e e Z dZ dZ dZ d ZeZd Zd Zdd ZdZdZdZdZeZdZdZdZdZddZdZdZeZd S)r4a# Thread local storage. >>> d = ThreadedDict() >>> d.x = 1 >>> d.x 1 >>> import threading >>> def f(): d.x = 2 ... >>> t = threading.Thread(target=f) >>> t.start() >>> t.join() >>> d.x 1 cDtj|dSr;)r4 _instancesrzrRs rCrzThreadedDict.__init__s##D)))))rJcDtj|dSr;)r4rrrRs rC__del__zThreadedDict.__del__s&&t,,,,,rJc t|Sr;)idrRs rC__hash__zThreadedDict.__hash__s $xxrJcfttjD]}|dS)z"Clears all ThreadedDict instances.N)rmr4rclear)ts rC clear_allzThreadedDict.clear_alls5l-..  A GGIIII  rJc|j|Sr;__dict__rs rCr3zThreadedDict.__getitem__ s}S!!rJc||j|<dSr;rrGs rC __setitem__zThreadedDict.__setitem__s" crJc|j|=dSr;rrs rC __delitem__zThreadedDict.__delitem__s M#   rJc||jvSr;rrs rC __contains__zThreadedDict.__contains__sdm##rJc8|jdSr;)rrrRs rCrzThreadedDict.clears rJc4|jSr;)rrrRs rCrzThreadedDict.copy}!!###rJNc8|j||Sr;)rrnr@rAr,s rCrnzThreadedDict.get!s}  g...rJc4|jSr;)rrrRs rCrzThreadedDict.items$s}""$$$rJc*t|jSr;)rrrRs rCrzThreadedDict.iteritems's'''rJc4|jSr;)rrlrRs rCrlzThreadedDict.keys*rrJc~ t|jS#t$r|jcYSwxYwr;)iterkeysr NameErrorrlrRs rCrzThreadedDict.iterkeys-sL (DM** * ( ( (=%%'' ' ' ' (s #<<c4|jSr;)rrrRs rCrzThreadedDict.values5s}##%%%rJc*t|jSr;)rrrRs rCrzThreadedDict.itervalues8s$-(((rJc(|jj|g|RSr;)rrj)r@rArs rCrjzThreadedDict.pop;s t} ,t,,,,rJc4|jSr;)rpopitemrRs rCrzThreadedDict.popitem>s}$$&&&rJc8|j||Sr;)rrxrs rCrxzThreadedDict.setdefaultAs}''W555rJc*|jj|i|dSr;)rr)r@rkwargss rCrzThreadedDict.updateDs" d-f-----rJcd|jzS)NzrrRs rCrQzThreadedDict.__repr__Gs"T]22rJr;) rTrUrVrWrrrrrr staticmethodr3rrrhas_keyrrrnrrrlrr*rrrjrrxrrQ__str__rFrJrCr4r4s"J***---  Y''I """###$$$G$$$////%%%((($$$((( D&&&)))---'''6666...333GGGrJr4c`t|D]\}}|dkr t|||dS)a: Automatically assigns local variables to `self`. >>> self = storage() >>> autoassign(self, dict(a=1, b=2)) >>> self.a 1 >>> self.b 2 Generally used in `__init__` methods, as in: def __init__(self, foo, bar, baz=1): autoassign(self, locals()) r@N)rro)r@localsrArHs rCr6r6PsJ"&))"" e &== c5!!!!""rJc|dkrtdd}g}|dkr5t|d\}}|d|||dk5d|pdS)ax Converts an integer to base 36 (a useful scheme for human-sayable IDs). >>> to36(35) 'z' >>> to36(119292) '2k1o' >>> int(to36(939387374), 36) 939387374 >>> to36(0) '0' >>> to36(-393) Traceback (most recent call last): ... ValueError: must supply a positive integer rzmust supply a positive integer$0123456789abcdefghijklmnopqrstuvwxyz$r0)rrrTr)qletters convertedrs rCr7r7es~$ 1uu9:::4GI q&&a}}1GAJ''' q&& 779   $$rJz(?5J5J K K K K Q   Aw''62(>(>??H"1nd;;L KK!&&((L 9 9 9 9 3   AQ AffhhG GGIIIw''**H KK'4 0 0 0 05Q?@@ @IIKKKKKrJcNeZdZd dZdZd dZdZdZdZdZ d Z d Z d Z dS) rNc 4 d}t|}t|}t|}||}||dg}||dg} ||z| z} ddl j|d|_ fd| D|_t|d||d|pi|_ |rd||j d <| |_ |j d d |j d d |j dd|j |dd|_dS)Ncdt|tst|gSd|DS)Nc,g|]}t|SrFr)rgr s rCrhz;_EmailMessage.__init__..listify..s...q ...rJ)r\rmrrs rClistifyz'_EmailMessage.__init__..listifys6a&& / |#..A....rJccbccrrcPg|]"}j|d#S)r)utils parseaddr)rgremails rCrhz*_EmailMessage.__init__..s.KKK15;0033A6KKKrJz, )FromToSubjectCczContent-Transfer-Encoding7bitContent-Dispositioninlinez MIME-Versionz1.0rF)rrn email.utilsrrr recipientsr#rr  new_messager add_header set_payload multipart) r@rrrrr rrrrrrs @rCrz_EmailMessage.__init__s / / / '""'""|,, WZ(( WRVVD"%% & &gbffUB''(("_s* !K11,??BKKKK KKK!:)>)>7 S S Mr    /!%2DL ''))   ;VDDD  5x@@@ 666   '222rJc"ddlm}|S)Nr)Message) email.messager%)r@r%s rCr z_EmailMessage.new_messages ))))))wyyrJc^|jsR|}|dd||j||_d|_ddl} ddlm}n #ddlm}YnxYw|p| |dpd}|}| ||d||dd | | d s| ||j|dS) Nz Content-Typezmultipart/mixedTr)encoders)Encoderszapplication/octet-streamr attachment)rEztext/) r#r r!rr mimetypesrr(r) guess_typer"r encode_base64)r@rErFrmsgr+r(s rCrz_EmailMessage.attachs`~ """$$C NN>+< = = = JJt| $ $ $DL!DN 3 & & & & & & & 3 2 2 2 2 2 2 2 2  *##H--a0 *)         ~|444 ,lXNNN&&w// (  " "3 ' ' ' C     s A&&A0ct|jD]S\}}|dkr|j|8|j||Ti|_dS)Nz content-type)rr lowerrset_typer!)r@rBr~s rCprepare_messagez_EmailMessage.prepare_messagesqdl++ . .DAqwwyyN** %%a(((( ''1---- rJc||j} ddlm}n,#t $rt t }YnwxYw|jdr| |dS|jddkr| |dS| |dS)Nrwebapiconfig smtp_server email_engineaws) r2r as_stringrr5 ImportErrorrr7rnsend_with_smtp send_with_awsdefault_email_sender)r@ message_textr5s rCrz_EmailMessage.sends |--//  /  / / /GII...FFF / =  ] + + 4    - - - - - ]  ~ . .% 7 7   | , , , , ,  % %l 3 3 3 3 3s6&AAcP ddlm}n,#t$rtt}YnwxYwddl}|j|jd|jd}| ||j |j dS)Nrr4r6raws_access_key_idaws_secret_access_key)rBrC) rr5r<rboto.sesses SESConnectionr7rnsend_raw_emailrr)r@r@r5botors rCr>z_EmailMessage.send_with_awss /  / / /GII...FFF /  H " "$m//0CDD"(-"3"34K"L"L #   t'8$/JJJJJ  &22c( ddlm}n,#t$rtt}YnwxYw|jd}|jdd}|jd}|jd}|jd d}|jd d }ddl} | ||} |r| ||r<| | | |r|r| ||| |j |j|| dS) Nrr4r6r8 smtp_portr smtp_username smtp_passwordsmtp_debuglevel smtp_starttlsF)rr5r<rr7rnsmtplibSMTPset_debuglevelehlostarttlsloginr8rrquit) r@r@r5serverportusernamepassword debug_levelrTrP smtpservers rCr=z_EmailMessage.send_with_smtps /  / / /GII...FFF /""=11}  a00=$$_55=$$_55m''(94@@ =$$_e<<\\&$//  3  % %k 2 2 2   OO       ! ! ! OO     1 1   Xx 0 0 0D-t MMMrIcV ddlm}n,#t$rtt}YnwxYw|jdd}|jdr Jd|jD]!}|dr Jd"|d|jg|jz}tj |tj }|j |d |j |dS) Nrr4r6 sendmail_pathz/usr/sbin/sendmailrsecurityz-f)stdinr)rr5r<rr7rnrrr subprocessPopenPIPEr`r#encoderwait)r@r@r5r8rcmdps rCr?z"_EmailMessage.default_email_sender;s1 /  / / /GII...FFF /=$$_6JKK$//44@@j@@@ 5 5A||C(( 4 4* 4 4 4 4t01DOC  S  8 8 8  l))'22333   rIcdS)NzrFrRs rCrQz_EmailMessage.__repr__OsrJc4|jSr;)rr;rRs rCrz_EmailMessage.__str__Rs|%%'''rJr;) rTrUrVrr rr2rr>r=r?rQrrFrJrCrrs""""H !!!!>444 K K K>(   (((((rJr__main__)rr;r)ri)r)RrWrprrerBrarrrr:r threadlocal py3helpersrrrr<io__all__rPrr r r r rmrkr frozensetr rrrrrrrrrrcompilerrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r_urlr8rrTdoctesttestmodrFrJrCrus    ****** !!!!!!!2 2 2 j%7%7%7%7%7d%7%7%7P MMM`T7T7T7T7T7gT7T7T7n  uc9%     E    e  "&&&&&&"222    " 222jP"P"P"P"P"P"P"P"f  WRZ    7 7 7 A A A2.C.C.Cb^^^^^^^^B """"GGG   $(                      ^6^6^6^6B < < <&222j777EEE0     4 ........b ).).).).Xddddd;dddN """*%%%:  +,,$$$$Ng(g(g(g(g(g(g(g(T zNNNGOs= A  A