OwlCyberSecurity - MANAGER
Edit File: cycler.cpython-38.pyc
U D��VW> � @ s� d Z ddlmZmZmZmZ ddlZddlmZm Z ddl m Z m Z ddl mZmZ ddlZdZdd � ZG d d � d e�Zd d � Zdd� Zdd� ZdS )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': '-.'} � )�absolute_import�division�print_function�unicode_literalsN)�product�cycle)�zip�reduce)�mul�addz0.10.0c C s` | dk rt t| ��ni }|dk r,t t|��ni }t|�� �}t|�� �}||@ rXtd��||B S )a 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 Nz"Can not compose overlapping cycles)�next�iter�set�keys� ValueError)�left�rightZl_peekZr_peekZl_keyZr_key� r �(/usr/lib/python3/dist-packages/cycler.py� _process_keys7 s r c @ s� e Zd ZdZdd� Zd+dd�Zedd� �Zd d � Zd d � Z e d d� �Z dd� Z dd� Z dd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� ZeZd'd(� Zd)d*� ZdS ),�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 : 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. c C s t | �S �N)r ��selfr r r �__call__m s zCycler.__call__Nc C s� t |t�r t|j|j|j�| _n |dk r:dd� |D �| _nd| _t |t�r`t|j|j|j�| _n |dk rzdd� |D �| _nd| _t| j| j�| _|| _dS )z\Semi-private init Do not use this directly, use `cycler` function instead. Nc S s g | ]}t � |��qS r ��copy��.0�vr r r � <listcomp>z s z#Cycler.__init__.<locals>.<listcomp>c S s g | ]}t � |��qS r r r r r r r � s )� isinstancer �_left�_right�_opr �_keys)r r r �opr r r �__init__p s zCycler.__init__c C s t | j�S )z2 The keys this Cycler knows about )r r% r r r r r � s z Cycler.keysc s� �� kr dS � | j kr(td�� � f ���| j krDtd�� �f ��| j ��� | j �� � | jdk r��| jjkr�| j��� � n4t| j t �r�| j ��� � n� �fdd�| j D �| _ dS )a 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. Nz-Can't replace %s with %s, %s is already a keyz)Can't replace %s with %s, %s is not a keyc s g | ]}� |� i�qS r r )r �entry��new�oldr r r � s z%Cycler.change_key.<locals>.<listcomp>) r% r �KeyError�remover r# r � change_keyr! r" r )r r+ r* r r) r r. � s" � � zCycler.change_keyc c s> | � | j| j�D ](\}}t� }|�|� |�|� |V qdS )z� Compose the 'left' and 'right' components of this cycle with the proper operation (zip or product as of now) N)r$ r" r# �dict�update)r �a�b�outr r r �_compose� s zCycler._composec s0 | d�}t � fdd�|D ��|_t� g�|_|S )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 : str The property key. itr : iterable Finite length iterable of the property values. Returns ------- cycler : Cycler New 'base' `Cycler` Nc 3 s | ]}� |iV qd S r r r ��labelr r � <genexpr>� s z$Cycler._from_iter.<locals>.<genexpr>)�listr" r r% )�clsr6 �itrZretr r5 r � _from_iter� s zCycler._from_iterc s< t � t�r0| �� }tt� fdd�t�|�D ��S td��d S )Nc 3 s | ]\}}t ||� �V qd S r ��_cycler�r �kr ��keyr r r7 � s �z%Cycler.__getitem__.<locals>.<genexpr>z+Can only use slices with Cycler.__getitem__)r! �slice�by_keyr r �six� iteritemsr )r rA �transr r@ r � __getitem__� s �zCycler.__getitem__c C s& | j d kr tdd� | jD ��S | �� S )Nc s s | ]}t |�V qd S r )r/ )r �lr r r r7 � s z"Cycler.__iter__.<locals>.<genexpr>)r# r r" r4 r r r r �__iter__� s zCycler.__iter__c C s4 t | �t |�kr(td�t | �t |����t| |t�S )z� Pair-wise combine two equal length cycles (zip) Parameters ---------- other : Cycler The second Cycler z1Can only add equal length cycles, not {0} and {1})�lenr �formatr r �r �otherr r r �__add__� s �zCycler.__add__c sN t � t�rt| � t�S t � t�rF| �� }tt� fdd�t�|�D ��S t S dS )z� Outer product of two cycles (`itertools.product`) or integer multiplication. Parameters ---------- other : Cycler or int The second Cycler or integer c 3 s | ]\}}t ||� �V qd S r r< r> �rM r r r7 s �z!Cycler.__mul__.<locals>.<genexpr>N) r! r r �intrC r r rD rE �NotImplemented)r rM rF r rO r �__mul__� s �zCycler.__mul__c C s | | S r r rL r r r �__rmul__ s zCycler.__rmul__c C sD t ttti}| jd kr t| j�S t| j�}t| j�}|| j ||�S r )r �minr r r# rJ r" r$ )r Zop_dictZl_lenZr_lenr r r �__len__ s zCycler.__len__c C sL t |t�std��t�| �}t||�| _|| _t| _t|j|j |j�| _ | S )z� In-place pair-wise combine two equal length cycles (zip) Parameters ---------- other : Cycler The second Cycler z"Cannot += with a non-Cycler object) r! r � TypeErrorr r r% r" r r$ r# �r rM Zold_selfr r r �__iadd__ s zCycler.__iadd__c C sL t |t�std��t�| �}t||�| _|| _t| _t|j|j |j�| _ | S )z� In-place outer product of two cycles (`itertools.product`) Parameters ---------- other : Cycler The second Cycler z"Cannot *= with a non-Cycler object) r! r rV r r r% r" r r$ r# rW r r r �__imul__& s zCycler.__imul__c C s< t | �t |�krdS | j|jA r$dS tdd� t| |�D ��S )z Check equality Fc s s | ]\}}||kV qd S r r )r r1 r2 r r r r7 B s z Cycler.__eq__.<locals>.<genexpr>)rJ r �allr rL r r r �__eq__9 s z Cycler.__eq__c sn t dtdi}| jd krD| j�� � t� fdd�| D ��}dj� |d�S |�| jd�}d}|j| j || jd �S d S ) N�+�*c 3 s | ]}|� V qd S r r r ��labr r r7 H s z"Cycler.__repr__.<locals>.<genexpr>zcycler({lab!r}, {itr!r}))r_ r: �?z({left!r} {op} {right!r}))r r& r ) r r r# r �popr8 rK �getr$ r" )r Zop_mapr: r& �msgr r^ r �__repr__D s zCycler.__repr__c C st d}t | jtd�}|D ]}|dj|d�7 }qt| �D ]2}|d7 }|D ]}|dj|| d�7 }qD|d7 }q4|d7 }|S ) Nz<table>r@ z<th>{key!r}</th>z<tr>z<td>{val!r}</td>)�valz</tr>z</table>)�sortedr �reprrK r )r �outputZ sorted_keysrA �dr? r r r � _repr_html_O s zCycler._repr_html_c C sB | j }tdd� |D ��}| D ] }|D ]}|| �|| � q$q |S )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. c s s | ]}|t � fV qd S r )r8 �r r? r r r r7 s s z Cycler.by_key.<locals>.<genexpr>)r r/ �append)r r r3 ri r? r r r rC ] s z Cycler.by_keyc C s" | � � }ttdd� t�|�D ��S )z�Simplify the Cycler Returned as a composition using only sums (no multiplications) Returns ------- simple : Cycler An equivalent cycler using only summationc s s | ]\}}t ||�V qd S r r< r> r r r r7 � s z"Cycler.simplify.<locals>.<genexpr>)rC r r rD rE )r rF r r r �simplify} s zCycler.simplifyc C s t | |�S )aF Concatenate 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` )�concatrL r r r rn � s z Cycler.concat)NN)�__name__� __module__� __qualname__�__doc__r r' �propertyr r. r4 � classmethodr; rG rI rN rR rS rU rX rY r[ rd rj rC Z _transposerm rn r r r r r M s0 # r c sj | j |j kr>d�dddg�j| j |j @ | j |j A d�}t|��| �� � |�� �tt� �fdd�| j D ��S )a� 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` z zKeys do not match:zIntersection: {both!r}zDisjoint: {just_one!r})ZbothZjust_onec 3 s$ | ] }t |� | �| �V qd S r r< rk �Z_lZ_rr r r7 � s zconcat.<locals>.<genexpr>)r �joinrK r rC r r )r r rc r ru r rn � s � �rn c O s� | r|rt d��t| �dkr>t| d t�s2t d��t| d �S t| �dkrRt| � S t| �dkrft d��|r�ttdd� t�|�D ��S t d ��d S ) a� 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.� r zEIf 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.c s s | ]\}}t ||�V qd S r r< r> r r r r7 s zcycler.<locals>.<genexpr>z4Must have at least a positional OR keyword argumentsN) rV rJ r! r r= r r rD rE )�args�kwargsr r r �cycler� s ( r{ c sN t |t�rB|j}t|�dkr(d}t|��|�� � � fdd�|D �}t�| |�S )aI 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 rw z2Can not create Cycler from a multi-property Cyclerc 3 s | ]}|� V qd S r r r r^ r r r7 , s z_cycler.<locals>.<genexpr>)r! r r rJ r ra r; )r6 r: r rc r r^ r r= s r= )rr Z __future__r r r r rD � itertoolsr r Z six.movesr r �operatorr r r � __version__r �objectr rn r{ r= r r r r �<module> s * a(=