Dh1; dZddlZddlZddlZddlZddlmZmZmZm Z m Z m Z ddlm Z m Z mZmZmZmZddlmZddlmZmZmZmZmZmZmZmZmZmZej>fdeed eed eefd Z d d deede!de"d ee edffdZ#GddZ$e$Z%deede!d ee edffdZ&deede!d ee edffdZ'deedeed eefdZ(d:deded eefdZ)deed eefdZ*deedeed eefdZ+deedeed eefd Z,e deed ee eeeffd!Z-e deed"eeefd ee eeeffd#Z- d;deed"e eeefd ee eeeffd$Z-e deed%e e!d eefd&Z.e ddeede!d e eedffd6Z4dd7d.eed8ed ee edffd9Z5y)?a Async-compatible version of itertools standard library functions. These functions build on top of the async builtins components, enabling use of both standard iterables and async iterables, without needing to use if/else clauses or awkward logic. Standard iterables get wrapped in async generators, and all functions are designed for use with `await`, `async for`, etc. See https://docs.python.org/3/library/itertools.html for reference. N)Any AsyncIteratorListOptionaloverloadTuple) enumerateiterlistnexttuplezip) maybe_await) Accumulator AnyFunction AnyIterableAnyIterableIterableAnyStop KeyFunctionN PredicateRTitrfuncreturncKt|} t|d{}||23d{}t|||d{}|)74#t$rYywxYw7576yw)aG Yield the running accumulation of an iterable and operator. Accepts both a standard function or a coroutine for accumulation. Example:: data = [1, 2, 3, 4] async def mul(a, b): return a * b async for total in accumulate(data, func=mul): ... # 1, 2, 6, 24 N)r r rr)rrtotalitems x/var/www/fastuser/data/www/generator.snapmosaic.io/flask_app/venv/lib/python3.12/site-packages/aioitertools/itertools.py accumulater"&sv& s)Cc? Kd!$ud"344 # 4si A)AAAA)A'A#A'A)A% A)A A A)A  A)#A'%A)'A)F)strictiterablenr#.c K|dkr tdt|}tt||d{x}rA|rt ||k7r td|tt||d{x}r@yy7H7 w)z Yield batches of values from the given iterable. The final batch may be shorter. Example:: async for batch in batched(range(15), 5): ... # (0, 1, 2, 3, 4), (5, 6, 7, 8, 9), (10, 11, 12, 13, 14) r zn must be at least oneNzbatched: incomplete batch) ValueErrorr rislicelen)r$r%r# aiteratorbatchs r!batchedr,Es 1u122XIvi344 4% 4 c%jAo89 9 vi344 4% 444s'4BA?>B5B6B=BBcDeZdZdeedeefdZdeedeefdZy)Chainitrsrc$|j|S)a Yield values from one or more iterables in series. Consumes the first iterable lazily, in entirety, then the second, and so on. Example:: async for value in chain([1, 2, 3], [7, 8, 9]): ... # 1, 2, 3, 7, 8, 9 ) from_iterable)selfr/s r!__call__zChain.__call__^s!!$''cvKt|23d{}t|23d{}|77 6)6yw)za Like chain, but takes an iterable of iterables. Alias for chain(*itrs) N)r )r2r/rr s r!r1zChain.from_iterablelsF d  #"3i  d   i$s0 9717 95359759N) __name__ __module__ __qualname__rrrr3rr1r4r!r.r.]s= (k!n (q1A ((;A(>=QRCSr4r.rcvKt|d{}tj||D]}| y7%w)aD Yield r length subsequences from the given iterable. Simple wrapper around itertools.combinations for asyncio. This will consume the entire iterable before yielding values. Example:: async for value in combinations(range(4), 3): ... # (0, 1, 2), (0, 1, 3), (0, 2, 3), (1, 2, 3) N)r itertools combinationsrr:poolvalues r!r=r=zs9s)OD''a0 $ 97&9cvKt|d{}tj||D]}| y7%w)aq Yield r length subsequences from the given iterable with replacement. Simple wrapper around itertools.combinations_with_replacement. This will consume the entire iterable before yielding values. Example:: async for value in combinations_with_replacement("ABC", 2): ... # ("A", "A"), ("A", "B"), ("A", "C"), ("B", "B"), ... N)r r<combinations_with_replacementr>s r!rCrCs9s)OD88qA $rA selectorscTKt||23d{\}}|s|76yw)a Yield elements only when the corresponding selector evaluates to True. Stops when either the iterable or the selectors have been exhausted. Example:: async for value in compress(range(5), [1, 0, 0, 1, 1]): ... # 0, 3, 4 N)r)rrDr@selectors r!compressrGs3"%S)!4oeX K!4s (&$&((&(startstepc&K|} |||z } w)z Yield an infinite series, starting at the given value and increasing by step. Example:: async for value in counter(10, -1): ... # 10, 9, 8, 7, ... r9)rHrIr@s r!countrKs# E     scKg}t|23d{}||j| 76 |D]}|  w)a* Yield a repeating series from the given iterable. Lazily consumes the iterable when the next value is needed, and caching the values in memory for future iterations of the series. Example:: async for value in cycle([1, 2]): ... # 1, 2, 1, 2, 1, 2, ... N)r append)ritemsr s r!cyclerOsW E3id  Ti  DJ  sA202A2A predicatecKt|}|23d{}t||d{r#||23d{}|757676yw)a2 Drops all items until the predicate evaluates False; yields all items afterwards. Accepts both standard functions and coroutines for the predicate. Example:: def pred(x): return x < 4 async for item in dropwhile(pred, range(6)): ... # 4, 5, 6 Nr r)rPr$rr s r! dropwhilerSsf" x.Cd 4111J d 1cs\AAA AAA AAAAAA A AAAAc~Kt|23d{}t||d{r#|)7$7 6yw)a) Yield items from the iterable only when the predicate evaluates to False. Accepts both standard functions and coroutines for the predicate. Example:: def pred(x): return x < 4 async for item in filterfalse(pred, range(6)): ... # 4, 5 NrRrPr$r s r! filterfalserVsA"8nd 4111J1%s, =;7;=9==;==cyNr9)rs r!groupbyrY sr4keycyrXr9)rrZs r!rYrY r4c^K|d}g}t|} t|d{}|g}t||d{}|23d{}t||d{}||k7r ||f|g}n|j ||}F7h#t$rYywxYw7]7T7=6||fyw)a Yield consecutive keys and groupings from the given iterable. Items will be grouped based on the key function, which defaults to the identity of each item. Accepts both standard functions and coroutines for the key function. Suggest sorting by the key function before using groupby. Example:: data = ["A", "a", "b", "c", "C", "c"] async for key, group in groupby(data, key=str.lower): key # "a", "b", "c" group # ["A", "a"], ["b"], ["c", "C", "c"] Nc|SrXr9)xs r!zgroupby..+sr4)r r StopAsyncIterationrrM)rrZgroupingitr jks r!rYrYs( {H cB"X~vH#d)$$Adc$i( ( 6X+ vH OOD !   % ( X+syB-BB BB-BB-B$ B  B$B-$B"%(B- B BB-BB- B$"B-$ B-__stopcyrXr9)rrfs r!r(r(Cr\r4__start__stepcyrXr9)rrhrfris r!r(r(Jr\r4argscKd}d}|s tdt|dk(r|\}n4t|dk(r|\}}n t|dk(r|\}}}n td|dk\r ||dk\r|dk\sJtd|}|dk(ryt|23d{\}}||k\r||z |zdk(r||$|dz|k\s-y7*6yw)a  Yield selected items from the given iterable. islice(iterable, stop) islice(iterable, start, stop[, step]) Starting from the start index (or zero), stopping at the stop index (or until exhausted), skipping items if step > 0. Example:: data = range(10) async for item in islice(data, 5): ... # 0, 1, 2, 3, 4 async for item in islice(data, 2, 5): ... # 2, 3, 4 async for item in islice(data, 1, 7, 2): ... # 1, 3, 5 rr zmust pass stop indexztoo many arguments givenN)r'r)maxr )rrkrHrIstopindexr s r!r(r(Qs0 E D /00 4yA~ Ta t Ta tT344 A:4<419$!)C C q$uu}49J   T 1  ^s6B B> B<B:B<B>/B>8B>:B<<B>cvKt|d{}tj||D]}| y7%w)a? Yield r length permutations of elements in the iterable. Simple wrapper around itertools.combinations for asyncio. This will consume the entire iterable before yielding values. Example:: async for value in permutations(range(3)): ... # (0, 1, 2), (0, 2, 1), (1, 0, 2), ... N)r r< permutationsr>s r!rsrss9s)OD''a0 $rA)repeatr/rtcKtj|Dcgc] }t|c}d{}tj|d|iD]}| ycc}w7)w)a Yield cartesian products of all iterables. Simple wrapper around itertools.combinations for asyncio. This will consume all iterables before yielding any values. Example:: async for value in product("abc", "xy"): ... # ("a", "x"), ("a", "y"), ("b", "x"), ... async for value in product(range(3), repeat=3): ... # (0, 0, 0), (0, 0, 1), (0, 0, 2), ... Nrt)asynciogatherr r<product)rtr/rpoolsr@s r!rxrxsT$.."=49"=> >E""E9&9 #> >sAAAA*Aelemc.K |dk(ry||dz}w)z Yield the given value repeatedly, forever or up to n times. Example:: async for value in repeat(7): ... # 7, 7, 7, 7, 7, 7, ... rr Nr9)rzr%s r!rtrts(  6   Q sfncKt|23d{}t|d{}t||d{6717 7 6yw)aV Yield values from a function using an iterable of iterables for arguments. Each iterable contained within will be unpacked and consumed before executing the function or coroutine. Example:: data = [(1, 1), (1, 1, 1), (2, 2)] async for value in starmap(operator.add, data): ... # 2, 3, 4 N)r r r)r|r$rrks r!starmapr~sK"(^++c#YD ***+*$sE A A AA A AA AA A A A  A cKt|23d{}t||d{r|(y7%76yw)a( Yield values from the iterable until the predicate evaluates False. Accepts both standard functions and coroutines for the predicate. Example:: def pred(x): return x < 4 async for value in takewhile(pred, range(8)): ... # 0, 1, 2, 3 NrRrUs r! takewhilersD"8ndYt_- - -J   -%s( ><8<>: ><>>cD|dkDsJtt|Dcgc]}tjc}dtdtjdt t ffd tjfdtjDScc}w)u Return n iterators that each yield items from the given iterable. The first iterator lazily fetches from the original iterable, and then queues the values for the other iterators to yield when needed. Caveat: all iterators are dependent on the first iterator – if it is consumed more slowly than the rest, the other consumers will be blocked until the first iterator continues forward. Similarly, if the first iterator is consumed more quickly than the rest, more memory will be used in keeping values in the queues until the other iterators finish consuming them. Example:: it1, it2 = tee(range(5), n=2) async for value in it1: ... # 0, 1, 2, 3, 4 async for value in it2: ... # 0, 1, 2, 3, 4 rreqrc fK|dk(rW t23d{}tjddDcgc]}|jd|fc}d{|K |j d{\}}|||ury|*7qcc}w7<6nU#t$rI}tjddDcgc]}|j|dfncc}wc}d{7d}~wwxYwtjddDcgc]}|jdfncc}wc}d{7y7w)Nrr )r rvrwput Exceptionget) rerr@queueeerrorrqueuessentinels r!genztee..gen s4 6 #'9  %!..@Fqr Ku%))T5M2K K%&UUW} u$KH$  K$-  nnPQPR&Tuyy!T';&T&TUUU ..FSTSUJ"W5599dH-=#>"W"WX X X -sD1 BBB BBB BB B D14D/5D1 B BBD1 C(C#5C  C#CC##C((D1D D1(D+)D1c36K|]\}}||ywrXr9).0rerrs r! ztee.. sK1#a)Ks) objectrangervQueueintrrbuiltinsrr )rr%rerrrs` @@@r!teers|2 q5L5xH>K0B0B60JK KK3#FsB) fillvaluercK|Dcgc] }t|}}t|}d} tj|Dcgc]}|j c}ddid{}t j |D]@\}} t| tr|dz }|||<t|||</t| ts@| ||k\ryt j|cc}wcc}w7w)au Yield a tuple of items from mixed iterables until all are consumed. If shorter iterables are exhausted, the default value will be used until all iterables are exhausted. Example:: a = range(3) b = range(5) async for a, b in zip_longest(a, b, fillvalue=-1): a # 0, 1, 2, -1, -1 b # 0, 1, 2, 3, 4 rTreturn_exceptionsNr ) r r)rvrw __anext__rr isinstancerrt BaseExceptionr) rr/rits itr_countfinishedrcvaluesidxr@s r! zip_longestr#s&;?$?3T#Y$?C$?CIH ~~'* +blln + ?C  #,,V4 JC%)A 's !),CE=1   y nnV$$  %@ , s-C%C#C%C C%C#AC%7-C%)rr rX)r ))rm)6__doc__rvrr<operatortypingrrrrrrr r r r rrhelpersrtypesrrrrrrrrrraddr"rboolr,r.chainr=rCrGrKrOrSrVrYr(rsrxrtr~rrrr9r4r!rs FF==    19  Q*1~1F !n    5C=! 04 KNs}U1c6]7S$ Q5C=!( Q$/$41$qAmA.>"[^ a(8.|'21~14|'21~1,  Q M%47 2C$D     Q )!Q$/ 5DG$%   =A* Q*&{1a4'89*5d1g&'*Z  Q !)# 1    LM Q "% /7} FI 1   .k!n.Xc].}Q?O.d-1 Q$SM5C=!**+ q>#&5C=!.qS-*:"+A+"5c":+1+,|'21~104L[^4L4LE-2BC2G,H4Lp/3$% s $%(+$%5c?#$%r4