+ h8csnRt^RIt^RIHt^RIHtHt^RIHtH t Rt Rt Rt !RR 4t R tR tR#) 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': '-.'} N)reduce)productcycle)muladdz0.10.0csVe\\V44M/pVe\\V44M/p\VP44p\VP44pWE,'d \ R4hWE,#)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)Znextitersetkeys ValueError)leftrightZl_peekZr_peekZl_keyZr_keys&& +/usr/lib/python3.14/site-packages/cycler.py _process_keysr 4si"&!1T$t* rF"'"3T$u+ F  E  E }}=>> =csjaaVPVP8wdS\RPVPVP,VPVP, R74hVP4oVP4o\ \ VV3RlVP44#)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})ZbothZjust_onec3sf<"TF&p\VSV,SV,,4xK( R#5iN_cycler).0k_l_rs& r Zconcat..es'E9a2a52a5=119s.1)rrformatby_keyrr)r r rrs&&@@r concatrKs$ yyEJJ44:F"&))ejj"8&*ii%**&<5;5>? ? B B #E499E FFr csa]tRt^htoRtRtRRltRt]R4t Rt ] R4t R t R tR tR tR tRtRtRtRtRtRtRtRtRt]tRt]tRtVtR#)Cyclera 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. cs\V4#r)rself&r __call__ZCycler.__call__s T{r Nc sh\V\4'd2\VPVPVP4VnM7Ve-VUu.uFp\ P !V4NK upVnMRVn\V\4'd2\VPVPVP4VnM7Ve-VUu.uFp\ P !V4NK upVnMRVn\ VPVP4VnW0nR#uupiuupi)zN Semi-private init. Do not use this directly, use `cycler` function instead. N) isinstancer_left_right_opcopyr _keys)rr r opvs&&&& r __init__ZCycler.__init__s dF # # DKKBDJ  1551$))A,5DJDJ eV $ $ ellEIIFDK  277A499Q<7DKDK"4::t{{; 68s D*D/csWP9#r)r#)rr&&r __contains__ZCycler.__contains__sJJr c s,\VP4#)z!The keys this Cycler knows about.)rr#rrr rZ Cycler.keyss4::r c sW8XdR#W P9d\RPWR74hWP9d\RPWR74hVPP V4VPP V4VP e8WP P9dVP PW4R#\VP\4'dVPPW4R#VPUu.uF q2W1,/NK upVn R#uupi)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. Nz6Can't replace {old} with {new}, {new} is already a key)oldnewz2Can't replace {old} with {new}, {old} is not a key) r#rrZKeyErrorZremoverr r change_keyrrr)rr)r*Zentrys&&& r r+ZCycler.change_keys :  ** HC)  jj O"FsF46 6 # s ;; "skk.>.>'> KK " "3 , F + + JJ ! !# + :>D +DDJDs%Ec s\aV!R4p\V3RlV44VnS0VnV#)a5 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 : str The property key. itr : iterable Finite length iterable of the property values. Returns ------- `Cycler` New 'base' cycler. Nc3s,<"TF pSV/xK R#5ir)rr%label& r rZ$Cycler._from_iter..s1S%Ss)listrr#)Zclsr-itrZrets&f& r _from_iterZCycler._from_iters.($i1S11 G  r csa\S\4'd9VP4p\\V3RlVP 444#\ R4h)c3sL<"TFwr\WS,4xK R#5irr)rrr%key& r rZ%Cycler.__getitem__..sM}tqS6 2 2}!$z+Can only use slices with Cycler.__getitem__)rZslicerrritemsr)rr2trans&f r __getitem__ZCycler.__getitem__s@ c5 ! !KKME#Mu{{}MN NJK Kr c#s"VPf#VPFp\V4xK R#VPVPVP4F-wr#/pVP V4VP V4VxK/ R#5ir)r rZdictr!Zupdate)rr about& r __iter__ZCycler.__iter__sh ;;  4j #T[[9 1  1  :sB B c s\V4\V48wd$\R\V4 R\V4 24h\W\4#)zY Pair-wise combine two equal length cyclers (zip). Parameters ---------- other : Cycler z&Can only add equal length cycles, not z and )lenrrziprotherr'r __add__ZCycler.__add__sN t9E "$$'I;eCJ<AB Bd3''r c sa\S\4'd\VS\4#\S\4'd9VP 4p\ \ V3RlVP444#\#)z| Outer product of two cyclers (`itertools.product`) or integer multiplication. Parameters ---------- other : Cycler or int c3sL<"TFwr\WS,4xK R#5irr)rrr%rAr3r rZ!Cycler.__mul__..sN U7 3 3 r4) rrrZintrrrr5ZNotImplemented)rrAr6r7r __mul__ZCycler.__mul__sX eV $ $$w/ / s # #KKME#N NO O! !r csW,#rr,r@r'r __rmul__ZCycler.__rmul__s |r cs\\\\/pVPf\ VP 4#\ VP 4p\ VP4pWP,!W#4#r)r?Zminrrr r>rr!)rZop_dictZl_lenZr_lens& r __len__ZCycler.__len__sUWc* ;; tzz? "DJJDKK xx ..r c \V\4'g \R4h\P!V4p\ W!4VnW n\Vn\VP VPVP4Vn V#)zb In-place pair-wise combine two equal length cyclers (zip). Parameters ---------- other : Cycler z"Cannot += with a non-Cycler object) rr TypeErrorr"r r#rr?r!r rrAZold_self&& r __iadd__ZCycler.__iadd__#sc%((@A A99T?"83  U[[%,, B  r c rF)zd In-place outer product of two cyclers (`itertools.product`). Parameters ---------- other : Cycler z"Cannot *= with a non-Cycler object) rrrGr"r r#rrr!r rHrIr __imul__ZCycler.__imul__5sc%((@A A99T?"83  U[[%,, B  r cs\V4\V48wdR#VPVP, 'dR#\;QJd%R\W44F 'dK R# R#!R\W444#)Fc3s."TF wrW8HxK R#5irr,)rr9r:& r rZ Cycler.__eq__..Ls7&6da16&6sT)r>rZallr?r@r'r __eq__Z Cycler.__eq__Gs^ t9E " 99uzz ! !s7c$&67ss7s7s7c$&6777r cs W8X*#rr,r@r'r __ne__Z Cycler.__ne__Ns ""r cs:a\R\R/pVPf;VPP 4o\ V3RlV44pRS: RV: R2#VP VPR4pRpVPVPW0PR7#) Z+Z*c34<"TF qS,xK R#5irr,rr%labr.r rZ"Cycler.__repr__..Ws,t!vvtzcycler(z, Z)Z?z({left!r} {op} {right!r}))r r$r ) r?rr rpopr/Zgetr!rr)rZop_mapr0r$msgrQs& @r __repr__ZCycler.__repr__SssGS) ;; ))--/C,t,,CSG2cWA. .DHHc*B-C::4::"KK:H Hr csRp\VP\R7pVFpVRV: R2, pK \V4F2pVR, pVFpVRWE,: R2, pK VR, pK4 VR, pV#) z)r2zzzzz
z
z
)ZsortedrZreprr)rZoutputZ sorted_keysr2drs& r _repr_html_ZCycler._repr_html_^sTYYD1 C SG5) )FdA f F D..! g F  * r c sVPpVUu/uF q"\4bK ppVF)pVF pW2,PWB,4K" K+ V#uupi)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/Zappend)rrrr;rVr<r rZ Cycler.by_keylsU*yy"&'$Q$&y$'A ad# (sAc slVP4p\\RVP444#)z_ Simplify the cycler into a sum (but no products) of cyclers. Returns ------- simple : Cycler c3<"TFwr\W4xK R#5irrrrr%rLr rZ"Cycler.simplify..sDmdaGAMMm)rrrr5)rr6s& r simplifyZCycler.simplifys( cDekkmDEEr )r#rr!r )NN) Z__name__Z __module__Z __qualname__Z__firstlineno____doc__rr&r(Zpropertyrr+Z classmethodr1r8r=rBrCrDrErJrKrMrNZ__hash__rUrWrZ _transposer[rZ__static_attributes__Z__classdictcell__)Z __classdict__s@r rrhs66"EH0L  (""/$$8#H I <JF Fr rcsV'dV'd \R4h\V4^8Xd;\V^,\4'g \R4h\V^,4#\V4^8Xd \ V!#\V4^8d \R4hV'd&\ \ RVP444#\R4h)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 zBcyl() can only accept positional OR keyword arguments -- not both.zDIf 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.c3rXrrrYrLr rZcycler..sEndaGAMMnrZz4Must have at least a positional OR keyword arguments)rGr>rrrrrr5)ZargsZkwargss*,r cyclerr]sL 12 2 4yA~$q'6**45 5d1g Ta~ TQNO OcEfllnEFF J KKr csa\V\4'dFVPp\V4^8wdRp\ V4hVP 4oV3RlV4p\P W4#)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 z2Can not create Cycler from a multi-property Cyclerc3rOrr,rPr.r rZ_cycler..s#s!vvsrR)rrrr>rrSr1)r-r0rrTrQs&& @r rrs] #vxx t9>FCS/ !hhj$s#   U ((r )r\r"Z functoolsrZ itertoolsrrZoperatorrrZ __version__r rrr]rr,r r r^sB(V $ .G:ttn 8Lv)r