hEATSrSSKJr SSKJrJrJr SSKrSSKJ r SSK J r J r SSK JrJr SSKJrJrJrJrJrJrJrJrJr S r\"S \S 9r\"S \S 9r\"S 5r\"S5rSSjrSSjr "SS\\\45r!\SSj5r"\SSj5r"\SSj5r"Sr"SSjr#g)a Cycler ====== Cycling through combinations of values, producing dictionaries. You can add cyclers:: from cycler import cycler cc = (cycler(color=list('rgb')) + cycler(linestyle=['-', '--', '-.'])) for d in cc: print(d) Results in:: {'color': 'r', 'linestyle': '-'} {'color': 'g', 'linestyle': '--'} {'color': 'b', 'linestyle': '-.'} You can multiply cyclers:: from cycler import cycler cc = (cycler(color=list('rgb')) * cycler(linestyle=['-', '--', '-.'])) for d in cc: print(d) Results in:: {'color': 'r', 'linestyle': '-'} {'color': 'r', 'linestyle': '--'} {'color': 'r', 'linestyle': '-.'} {'color': 'g', 'linestyle': '-'} {'color': 'g', 'linestyle': '--'} {'color': 'g', 'linestyle': '-.'} {'color': 'b', 'linestyle': '-'} {'color': 'b', 'linestyle': '--'} {'color': 'b', 'linestyle': '-.'} ) annotations)HashableIterable GeneratorN)reduce)productcycle)muladd) TypeVarGenericCallableUnionDictListAnyoverloadcastz0.12.1K)boundLVUcU/:wa[[U55O0nUb[[U55O0n[UR55n[UR55nXE-(a [ S5eXE-$)z Helper function to compose cycler keys. Parameters ---------- left, right : iterable of dictionaries or None The cyclers to be composed. Returns ------- keys : set The keys in the composition of the two cyclers. z"Can not compose overlapping cycles)nextitersetkeys ValueError)leftrightl_peekr_peekl_keyr_keys A/var/www/html/env/lib/python3.13/site-packages/cycler/__init__.py _process_keysr'>sh".2RZd4j)RF.3.?d5k*RF &E &E }=>> =c^^URUR:waG[SRURUR-URUR- S95e[[[ [ [[[44UR55m[[[ [ [[[44UR55m[[UU4SjUR55$)a Concatenate `Cycler`\s, as if chained using `itertools.chain`. The keys must match exactly. Examples -------- >>> num = cycler('a', range(3)) >>> let = cycler('a', 'abc') >>> num.concat(let) cycler('a', [0, 1, 2, 'a', 'b', 'c']) Returns ------- `Cycler` The concatenated cycler. zBKeys do not match: Intersection: {both!r} Disjoint: {just_one!r})bothjust_onec3N># UHn[UTUTU-5v M g7fN_cycler).0k_l_rs r& concat..ts'E9a2a52a5=119s"%) rrformatrrrrrrrby_keyrr )r r!r2r3s @@r&concatr8Xs$ yyEJJ ''-vYY+dii%**6L(.(   d1d5A;''($++- 8B d1d5A;''(%,,. 9B #E499E FFr(cH\rSrSrSrSrSSSjjrSr\SSj5r SSjr \ S S j5r S!S jr S"S jrS#S jr\S#S j5r\S$Sj5rSr\S#Sj5r\S$Sj5rSrS%SjrS&SjrS'SjrS(SjrSrS)SjrS)SjrS*Sjr\rS+Sjr\rSrg),Cyclerwa Composable cycles. This class has compositions methods: ``+`` for 'inner' products (zip) ``+=`` in-place ``+`` ``*`` for outer products (`itertools.product`) and integer multiplication ``*=`` in-place ``*`` and supports basic slicing via ``[]``. Parameters ---------- left, right : Cycler or None The 'left' and 'right' cyclers. op : func or None Function which composes the 'left' and 'right' cyclers. c[U5$r-)r selfs r&__call__Cycler.__call__s T{r(Nc[U[5(a1[URURUR5UlO7Ub-UVs/sHn[ R "U5PM snUlO/Ul[U[5(a1[URURUR5UlOSUl[ URUR5UlX0lgs snf)zN Semi-private init. Do not use this directly, use `cycler` function instead. N) isinstancer:_left_right_opcopyr'_keys)r>r r!opvs r&__init__Cycler.__init__s dF # #:@ DKK;DJ 1551$))A,5DJDJ eV $ $/5 U\\5990DKDK*4::t{{C 6s C7cXR;$r-)rG)r>r1s r& __contains__Cycler.__contains__sJJr(c,[UR5$)z!The keys this Cycler knows about.)rrGr=s r&r Cycler.keyss4::r(c ZX:XagX R;a[SUSUSUS35eXR;a[SUSUSUS35eURRU5 URR U5 UR b5XR R ;aUR RX5 g[UR[5(aURRX5 gURVs/sHo2X10PM snUl gs snf)z Change a key in this cycler to a new name. Modification is performed in-place. Does nothing if the old key is the same as the new key. Raises a ValueError if the new key is already a key. Raises a KeyError if the old key isn't a key. NzCan't replace z with , z is already a keyz is not a key) rGrKeyErrorremover rDr change_keyrBrCr:)r>oldnewentrys r&rUCycler.change_keys :  **  VC53%7HI  jj  VC53%}E  # s ;; "skk.>.>'> KK " "3 , F + + JJ ! !# + :>D +DDJDsD(c\^U"S5n[U4SjU55UlT1UlU$)a: Class method to create 'base' Cycler objects that do not have a 'right' or 'op' and for which the 'left' object is not another Cycler. Parameters ---------- label : hashable The property key. itr : iterable Finite length iterable of the property values. Returns ------- `Cycler` New 'base' cycler. Nc3,># UH nTU0v M g7fr-)r0rIlabels r&r4$Cycler._from_iter..s1S%S)listrCrG)clsr]itrrets ` r& _from_iterCycler._from_iters.( I1S11 G  r(c^[T[5(a8UR5n[[U4SjUR 555$[ S5e)Nc3D># UHup[XT5v M g7fr-r.)r0r1rIkeys r&r4%Cycler.__getitem__..sM}tqS6 2 2} z+Can only use slices with Cycler.__getitem__)rBslicer7rr itemsr)r>rhtranss ` r& __getitem__Cycler.__getitem__s@ c5 ! !KKME#Mu{{}MN NJK Kr(c#F# URc!URHn[U5v M gURc [ S5eURURUR5H-up#0nUR U5 UR U5 Uv M/ g7f)Nz=Operation cannot be None when both left and right are defined)rDrCdictrE TypeErrorupdate)r>r abouts r&__iter__Cycler.__iter__s ;;  4j #xxST[[9 1  1  :sBB!c n[U5[U5:wa#[S[U5S[U535e[[[[[ [ 4[[[44U5[[[[ [ 4[[[44U5[5$)zY Pair-wise combine two equal length cyclers (zip). Parameters ---------- other : Cycler z&Can only add equal length cycles, not z and ) lenrr:rrrrrrzipr>others r&__add__Cycler.__add__s t9E "8T 5U U  ad U1a4[014 8 ad U1a4[015 9   r(cgr-r\r|s r&__mul__Cycler.__mul__$ r(cgr-r\r|s r&rr(rr(c ^[T[5(a{[[[[[[ 4[[ [44U5[[[[[ 4[[ [44T5[5$[T[5(a8UR5n[[U4SjUR555$[$)z| Outer product of two cyclers (`itertools.product`) or integer multiplication. Parameters ---------- other : Cycler or int c3D># UHup[XT-5v M g7fr-r.)r0r1rIr}s r&r4!Cycler.__mul__..>sF gaU++ rj)rBr:rrrrrrrintr7rr rlNotImplemented)r>r}rms ` r&rr,s eV $ $VE!Q$Kq!t45t<VE!Q$Kq!t45u=  s # #KKMEF F " !r(cgr-r\r|s r&__rmul__Cycler.__rmul__Crr(cgr-r\r|s r&rrGrr(c X-$r-r\r|s r&rrKs |r(c[[[[0nURc[ UR 5$[ UR 5n[ UR5nXR"X#5$r-)r{minrr rDrzrCrE)r>op_dictl_lenr_lens r&__len__Cycler.__len__NsV>A3QT=U ;; tzz? "DJJDKK xx ..r(c[U[5(d [S5e[R"U5n[ X!5UlX l[Ul[UR URUR5Ul U$)zb In-place pair-wise combine two equal length cyclers (zip). Parameters ---------- other : Cycler z"Cannot += with a non-Cycler object) rBr:rrrFr'rGrCr{rErDr>r}old_selfs r&__iadd__Cycler.__iadd__Xsc%((@A A99T?"83  U[[%,, B  r(c[U[5(d [S5e[R"U5n[ X!5UlX l[Ul[UR URUR5Ul U$)zd In-place outer product of two cyclers (`itertools.product`). Parameters ---------- other : Cycler z"Cannot *= with a non-Cycler object) rBr:rrrFr'rGrCrrErDrs r&__imul__Cycler.__imul__jsc%((@A A99T?"83  U[[%,, B  r(c[U[5(dg[U5[U5:wagURUR- (ag[ S[ X555$)NFc3.# UH upX:Hv M g7fr-r\)r0rtrus r&r4 Cycler.__eq__..s7&6da16&6s)rBr:rzrallr{r|s r&__eq__ Cycler.__eq__|sN%(( t9E " 99uzz !7c$&6777r(c2^[S[S0nURc:URR 5m[ U4SjU55nST<SU<S3$UR URS5nSnURURX0RS 9$) N+*c3,># UH oTv M g7fr-r\r0rIlabs r&r4"Cycler.__repr__..s,t!vtr_zcycler(rR)?z({left!r} {op} {right!r}))r rHr!) r{rrDrpopr`getrEr6rC)r>op_maprbrHmsgrs @r&__repr__Cycler.__repr__ssGS) ;; ))--/C,t,,CSG2cWA. .DHHc*B-C::4::"KK:H Hr(cSn[UR[S9nUH nUSU<S3- nM [U5H"nUS- nUHnUSXE<S3- nM US- nM$ US - nU$) Nz)rhzzzzz
z
z
)sortedrreprr)r>output sorted_keysrhdr1s r& _repr_html_Cycler._repr_html_sTYYD1 C SG5) )FdA f F D..! g F  * r(cURnUVs0sH o"[5_M nnUH!nUHnX2RXB5 M M# U$s snf)a} Values by key. This returns the transposed values of the cycler. Iterating over a `Cycler` yields dicts with a single value for each key, this method returns a `dict` of `list` which are the values for the given key. The returned value can be used to create an equivalent `Cycler` using only `+`. Returns ------- transpose : dict dict of lists of the values for each key. )rr`append)r>rr1rvrs r&r7 Cycler.by_keysU*yy48 9DqDFD 9A ad# !:sAclUR5n[[SUR555$)z_ Simplify the cycler into a sum (but no products) of cyclers. Returns ------- simple : Cycler c3<# UHup[X5v M g7fr-r.r0r1rIs r&r4"Cycler.simplify..sDmdaGAMMm)r7rr rl)r>rms r&simplifyCycler.simplifys( cDekkmDEEr()rGrCrErD)NN)r *Cycler[K, V] | Iterable[dict[K, V]] | Noner!zCycler[K, V] | NonerHr)returnset[K])rVrrWrrNoner]rrb Iterable[V]r Cycler[K, V])rhrkrr)rz!Generator[dict[K, V], None, None])r}z Cycler[L, U]rzCycler[K | L, V | U])r}rrr)rr)r}rrr)r}zCycler[K, V] | intrr)r}objectrbool)rstr)rzdict[K, list[V]])rr)__name__ __module__ __qualname____firstlineno____doc__r?rJrMpropertyrrU classmethodrdrnrwr~rrrrrrr__hash__rrr7 _transposerr8__static_attributes__r\r(r&r:r:ws6 &* 8#  @"EH0L  $    ".    /$$8H I <JF Fr(r:cgr-r\)args r&cyclerrr(c gr-r\)kwargss r&rrrr(cgr-r\)r]rbs r&rrrr(cU(aU(a [S5e[U5S:Xa1[US[5(d [S5e[US5$[U5S:Xa[ U6$[U5S:a [S5eU(a%[ [ SUR555$[S5e) aw Create a new `Cycler` object from a single positional argument, a pair of positional arguments, or the combination of keyword arguments. cycler(arg) cycler(label1=itr1[, label2=iter2[, ...]]) cycler(label, itr) Form 1 simply copies a given `Cycler` object. Form 2 composes a `Cycler` as an inner product of the pairs of keyword arguments. In other words, all of the iterables are cycled simultaneously, as if through zip(). Form 3 creates a `Cycler` from a label and an iterable. This is useful for when the label cannot be a keyword argument (e.g., an integer or a name that has a space in it). Parameters ---------- arg : Cycler Copy constructor for Cycler (does a shallow copy of iterables). label : name The property key. In the 2-arg form of the function, the label can be any hashable object. In the keyword argument form of the function, it must be a valid python identifier. itr : iterable Finite length iterable of the property values. Can be a single-property `Cycler` that would be like a key change, but as a shallow copy. Returns ------- cycler : Cycler New `Cycler` for the given property zEcycler() can only accept positional OR keyword arguments -- not both.rzDIf only one positional argument given, it must be a Cycler instance.zdOnly a single Cycler can be accepted as the lone positional argument. Use keyword arguments instead.c3<# UHup[X5v M g7fr-r.rs r&r4cycler..sEndaGAMMnrz4Must have at least a positional OR keyword arguments)rrrzrBr:r/rr rl)argsrs r&rrsL  S   4yA~$q'6**( d1g Ta~ TQ B  cEfllnEFF J KKr(c^[U[5(aDURn[U5S:wa Sn[ U5eUR 5mU4SjU5n[R X5$)a Create a new `Cycler` object from a property name and iterable of values. Parameters ---------- label : hashable The property key. itr : iterable Finite length iterable of the property values. Returns ------- cycler : Cycler New `Cycler` for the given property rz2Can not create Cycler from a multi-property Cyclerc3,># UH oTv M g7fr-r\rs r&r4_cycler..;s#s!vsr_)rBr:rrzrrrd)r]rbrrrs @r&r/r/"s] #vxx t9>FCS/ !hhj$s#   U ((r()r z#Cycler[K, V] | Iterable[dict[K, V]]r!rrr)r rr!z Cycler[K, U]rzCycler[K, V | U])rrrr)rrrzCycler[str, V]r)$r __future__rcollections.abcrrrrF functoolsr itertoolsrr operatorr r typingr r rrrrrrr __version__rrrrr'r8r:rr/r\r(r&rs(V#99 $UUU  Cx  Cx  CL CL - 5 4G>YWQT]Yx       =L@)r(