ó D«ÂVc@`sÆdZddlmZmZmZmZddlZddlmZm Z ddl m Z m Z ddl mZmZddlZdZd„Zd efd „ƒYZd „Zd „Zd „ZdS(u’ 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': '-.'} i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tproducttcycle(tziptreduce(tmultaddu0.10.0cC`s|dk rtt|ƒƒni}|dk rBtt|ƒƒni}t|jƒƒ}t|jƒƒ}||@r…tdƒ‚n||BS(u 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 u"Can not compose overlapping cyclesN(tNonetnexttitertsettkeyst ValueError(tlefttrighttl_peektr_peektl_keytr_key((s%lib/python2.7/site-packages/cycler.pyt _process_keys7s $$ tCyclercB`sÚeZdZd„Zddd„Zed„ƒZd„Zd„Z e d„ƒZ d„Z d„Z d „Zd „Zd „Zd „Zd „Zd„Zd„Zd„Zd„Zd„ZeZd„Zd„ZRS(u 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 : Cycler or None The 'left' cycler right : Cycler or None The 'right' cycler op : func or None Function which composes the 'left' and 'right' cyclers. cC`s t|ƒS(N(R(tself((s%lib/python2.7/site-packages/cycler.pyt__call__mscC`sÿt|tƒr0t|j|j|jƒ|_n=|dk rdg|D]}tj|ƒ^qC|_n d|_t|tƒrt|j|j|jƒ|_n=|dk rÑg|D]}tj|ƒ^q°|_n d|_t|j|jƒ|_||_dS(u\Semi-private init Do not use this directly, use `cycler` function instead. N( t isinstanceRt_leftt_rightt_opR tcopyRt_keys(RRRtoptv((s%lib/python2.7/site-packages/cycler.pyt__init__ps! ( ! ( cC`s t|jƒS(u2 The keys this Cycler knows about (R R(R((s%lib/python2.7/site-packages/cycler.pyRŠscC`s||krdS||jkr;td|||fƒ‚n||jkrftd|||fƒ‚n|jj|ƒ|jj|ƒ|jdk r½||jjkr½|jj||ƒnRt |j t ƒrå|j j||ƒn*g|j D]}i|||6^qï|_ dS(u 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. Nu-Can't replace %s with %s, %s is already a keyu)Can't replace %s with %s, %s is not a key( RRtKeyErrortremoveR RR Rt change_keyRRR(Rtoldtnewtentry((s%lib/python2.7/site-packages/cycler.pyR%‘s !cc`sUxN|j|j|jƒD]4\}}tƒ}|j|ƒ|j|ƒ|VqWdS(u† Compose the 'left' and 'right' components of this cycle with the proper operation (zip or product as of now) N(RRRtdicttupdate(Rtatbtout((s%lib/python2.7/site-packages/cycler.pyt_compose´s %   c`sA|dƒ}t‡fd†|Dƒƒ|_tˆgƒ|_|S(u­ 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 : Cycler New 'base' `Cycler` c3`s|]}i|ˆ6VqdS(N((t.0R!(tlabel(s%lib/python2.7/site-packages/cycler.pys ÔsN(R tlistRR R(tclsR0titrtret((R0s%lib/python2.7/site-packages/cycler.pyt _from_iter¿s c`sQtˆtƒrA|jƒ}tt‡fd†tj|ƒDƒƒStdƒ‚dS(Nc3`s(|]\}}t||ˆƒVqdS(N(t_cycler(R/tkR!(tkey(s%lib/python2.7/site-packages/cycler.pys Üsu+Can only use slices with Cycler.__getitem__(Rtslicetby_keyRR tsixt iteritemsR(RR8ttrans((R8s%lib/python2.7/site-packages/cycler.pyt __getitem__Øs  cC`s0|jdkr&td„|jDƒƒS|jƒS(Ncs`s|]}t|ƒVqdS(N(R)(R/tl((s%lib/python2.7/site-packages/cycler.pys ãs(RR R RR.(R((s%lib/python2.7/site-packages/cycler.pyt__iter__áscC`sOt|ƒt|ƒkr?tdjt|ƒt|ƒƒƒ‚nt||tƒS(uœ Pair-wise combine two equal length cycles (zip) Parameters ---------- other : Cycler The second Cycler u1Can only add equal length cycles, not {0} and {1}(tlenRtformatRR(Rtother((s%lib/python2.7/site-packages/cycler.pyt__add__çs  c`shtˆtƒrt|ˆtƒStˆtƒr`|jƒ}tt‡fd†tj|ƒDƒƒSt SdS(uÓ Outer product of two cycles (`itertools.product`) or integer multiplication. Parameters ---------- other : Cycler or int The second Cycler or integer c3`s(|]\}}t||ˆƒVqdS(N(R6(R/R7R!(RC(s%lib/python2.7/site-packages/cycler.pys sN( RRRtintR:RR R;R<tNotImplemented(RRCR=((RCs%lib/python2.7/site-packages/cycler.pyt__mul__õs  cC`s||S(N((RRC((s%lib/python2.7/site-packages/cycler.pyt__rmul__scC`sbitt6tt6}|jdkr0t|jƒSt|jƒ}t|jƒ}||j||ƒS(N( tminRRRRR RARR(Rtop_dicttl_lentr_len((s%lib/python2.7/site-packages/cycler.pyt__len__ s  cC`sst|tƒstdƒ‚ntj|ƒ}t||ƒ|_||_t|_t|j|j |jƒ|_ |S(u¥ In-place pair-wise combine two equal length cycles (zip) Parameters ---------- other : Cycler The second Cycler u"Cannot += with a non-Cycler object( RRt TypeErrorRRRRRRR(RRCtold_self((s%lib/python2.7/site-packages/cycler.pyt__iadd__s   cC`sst|tƒstdƒ‚ntj|ƒ}t||ƒ|_||_t|_t|j|j |jƒ|_ |S(u§ In-place outer product of two cycles (`itertools.product`) Parameters ---------- other : Cycler The second Cycler u"Cannot *= with a non-Cycler object( RRRNRRRRRRR(RRCRO((s%lib/python2.7/site-packages/cycler.pyt__imul__&s   cC`sMt|ƒt|ƒkrtS|j|jAr0tStd„t||ƒDƒƒS(u Check equality cs`s!|]\}}||kVqdS(N((R/R+R,((s%lib/python2.7/site-packages/cycler.pys Bs(RAtFalseRtallR(RRC((s%lib/python2.7/site-packages/cycler.pyt__eq__9s c`s¥idt6dt6}|jdkrd|jjƒ‰t‡fd†|Dƒƒ}djdˆd|ƒS|j|j dƒ}d}|jd |j d |d |jƒSdS( Nu+u*c3`s|]}|ˆVqdS(N((R/R!(tlab(s%lib/python2.7/site-packages/cycler.pys Hsucycler({lab!r}, {itr!r})RUR3u?u({left!r} {op} {right!r})RR R( RRRR RtpopR1RBtgetRR(Rtop_mapR3R tmsg((RUs%lib/python2.7/site-packages/cycler.pyt__repr__DscC`s¦d}t|jdtƒ}x$|D]}|djd|ƒ7}q"WxSt|ƒD]E}|d7}x(|D] }|djd||ƒ7}qfW|d7}qOW|d7}|S( NuR8uuutvaluu
{key!r}
{val!r}
(tsortedRtreprRBR (Rtoutputt sorted_keysR8tdR7((s%lib/python2.7/site-packages/cycler.pyt _repr_html_Os    cC`sZ|j}td„|Dƒƒ}x4|D],}x#|D]}||j||ƒq3Wq&W|S(uÓ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. cs`s|]}|tƒfVqdS(N(R1(R/R7((s%lib/python2.7/site-packages/cycler.pys ss(RR)tappend(RRR-R`R7((s%lib/python2.7/site-packages/cycler.pyR:]s    cC`s,|jƒ}ttd„tj|ƒDƒƒS(uÊSimplify the Cycler Returned as a composition using only sums (no multiplications) Returns ------- simple : Cycler An equivalent cycler using only summationcs`s$|]\}}t||ƒVqdS(N(R6(R/R7R!((s%lib/python2.7/site-packages/cycler.pys s(R:RR R;R<(RR=((s%lib/python2.7/site-packages/cycler.pytsimplify}s cC`s t||ƒS(uFConcatenate this cycler and an other. The keys must match exactly. This returns a single Cycler which is equivalent to `itertools.chain(self, other)` Examples -------- >>> num = cycler('a', range(3)) >>> let = cycler('a', 'abc') >>> num.concat(let) cycler('a', [0, 1, 2, 'a', 'b', 'c']) Parameters ---------- other : `Cycler` The `Cycler` to concatenate to this one. Returns ------- ret : `Cycler` The concatenated `Cycler` (tconcat(RRC((s%lib/python2.7/site-packages/cycler.pyRdsN(t__name__t __module__t__doc__RR R"tpropertyRR%R.t classmethodR5R>R@RDRGRHRMRPRQRTRZRaR:t _transposeRcRd(((s%lib/python2.7/site-packages/cycler.pyRMs,  #           c`sš|j|jkr_djdddgƒjd|j|j@d|j|jAƒ}t|ƒ‚n|jƒ‰|jƒ‰tt‡‡fd†|jDƒƒS(uøConcatenate two cyclers. The keys must match exactly. This returns a single Cycler which is equivalent to `itertools.chain(left, right)` Examples -------- >>> num = cycler('a', range(3)) >>> let = cycler('a', 'abc') >>> num.concat(let) cycler('a', [0, 1, 2, 'a', 'b', 'c']) Parameters ---------- left, right : `Cycler` The two `Cycler` instances to concatenate Returns ------- ret : `Cycler` The concatenated `Cycler` u uKeys do not match:uIntersection: {both!r}uDisjoint: {just_one!r}tbothtjust_onec3`s*|] }t|ˆ|ˆ|ƒVqdS(N(R6(R/R7(t_lt_r(s%lib/python2.7/site-packages/cycler.pys Ñs(RtjoinRBRR:RR (RRRY((RmRns%lib/python2.7/site-packages/cycler.pyRd¬s   cO`sÐ|r|rtdƒ‚nt|ƒdkr]t|dtƒsOtdƒ‚nt|dƒSt|ƒdkryt|ŒSt|ƒdkrštdƒ‚n|rÀttd„tj|ƒDƒƒStdƒ‚d S( uí 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 uBcyl() can only accept positional OR keyword arguments -- not both.iiuEIf only one positional argument given, it must be a Cycler instance.iudOnly a single Cycler can be accepted as the lone positional argument. Use keyword arguments instead.cs`s$|]\}}t||ƒVqdS(N(R6(R/R7R!((s%lib/python2.7/site-packages/cycler.pys su4Must have at least a positional OR keyword argumentsN( RNRARRR6RR R;R<(targstkwargs((s%lib/python2.7/site-packages/cycler.pytcyclerÔs(   c`stt|tƒrd|j}t|ƒdkr?d}t|ƒ‚n|jƒ‰‡fd†|Dƒ}ntj||ƒS(uI 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 iu2Can not create Cycler from a multi-property Cyclerc3`s|]}|ˆVqdS(N((R/R!(RU(s%lib/python2.7/site-packages/cycler.pys ,s(RRRRARRVR5(R0R3RRY((RUs%lib/python2.7/site-packages/cycler.pyR6s  (Rgt __future__RRRRR;t itertoolsRRt six.movesRRtoperatorRR Rt __version__RtobjectRRdRrR6(((s%lib/python2.7/site-packages/cycler.pyt)s"   ÿ` ( =