B
Wz|2 @ s| d Z ddlZddlmZ yddlmZmZ W n$ ek
rP ddlmZmZ Y nX e dZ
dZ dd Z G dd d eeZ
dS )
z
An OrderedSet is a custom MutableSet that remembers its order, so that every
entry has an index that can be looked up.
Based on a recipe originally posted to ActiveState Recipes by Raymond Hettiger,
and released under the MIT license.
N)deque)
MutableSetSequencez3.1c C s" t | do t| t o t| t S )a
Are we being asked to look up a list of things, instead of a single thing?
We check for the `__iter__` attribute so that this can cover types that
don't have to be known by this module, such as NumPy arrays.
Strings, however, should be considered as atomic values to look up, not
iterables. The same goes for tuples, since they are immutable and therefore
valid entries.
We don't need to check for the Python 2 `unicode` type, because it doesn't
have an `__iter__` attribute anyway.
__iter__)hasattr
isinstancestrtuple)obj r /builddir/build/BUILDROOT/alt-python37-setuptools-58.3.0-4.el9.x86_64/opt/alt/python37/lib/python3.7/site-packages/setuptools/_vendor/ordered_set.py is_iterable s
r
c @ s e Zd ZdZd;ddZdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z e Z dd Z
dd ZeZeZdd Zdd Zdd Zd d Zd d Zd!d" Zd#d$ Zd%d& Zd'd( Zd)d* Zd+d, Zd-d. Z d/d0 Z d1d2 Z d3d4 Z d5d6 Z d7d8 Z!d9d: Z"dS )<
OrderedSetz
An OrderedSet is a custom MutableSet that remembers its order, so that
every entry has an index that can be looked up.
Example:
>>> OrderedSet([1, 1, 2, 3, 2])
OrderedSet([1, 2, 3])
Nc C s g | _ i | _|d k r | |O } d S )N)itemsmap)selfiterabler r r __init__4 s zOrderedSet.__init__c C s
t | jS )z
Returns the number of unique elements in the ordered set
Example:
>>> len(OrderedSet([]))
0
>>> len(OrderedSet([1, 2]))
2
)lenr )r r r r __len__: s
zOrderedSet.__len__c s| t |tr|tkr S t|r4 fdd|D S t|dsHt |trl j| }t |trf |S |S n t d| dS )aQ
Get the item at a given index.
If `index` is a slice, you will get back that slice of items, as a
new OrderedSet.
If `index` is a list or a similar iterable, you'll get a list of
items corresponding to those indices. This is similar to NumPy's
"fancy indexing". The result is not an OrderedSet because you may ask
for duplicate indices, and the number of elements returned should be
the number of elements asked for.
Example:
>>> oset = OrderedSet([1, 2, 3])
>>> oset[1]
2
c s g | ]} j | qS r )r ).0i)r r r
[ s z*OrderedSet.__getitem__.. __index__z+Don't know how to index an OrderedSet by %rN)
r slice SLICE_ALLcopyr
r r list __class__ TypeError)r indexresultr )r r __getitem__F s
zOrderedSet.__getitem__c C s
| | S )z
Return a shallow copy of this object.
Example:
>>> this = OrderedSet([1, 2, 3])
>>> other = this.copy()
>>> this == other
True
>>> this is other
False
)r )r r r r r e s zOrderedSet.copyc C s t | dkrdS t| S d S )Nr )N)r r )r r r r __getstate__s s zOrderedSet.__getstate__c C s" |dkr| g n
| | d S )N)N)r )r stater r r __setstate__ s zOrderedSet.__setstate__c C s
|| j kS )z
Test if the item is in this ordered set
Example:
>>> 1 in OrderedSet([1, 3, 2])
True
>>> 5 in OrderedSet([1, 3, 2])
False
)r )r keyr r r __contains__ s
zOrderedSet.__contains__c C s0 || j kr&t| j| j |< | j| | j | S )aE
Add `key` as an item to this OrderedSet, then return its index.
If `key` is already in the OrderedSet, return the index it already
had.
Example:
>>> oset = OrderedSet()
>>> oset.append(3)
0
>>> print(oset)
OrderedSet([3])
)r r r append)r r& r r r add s
zOrderedSet.addc C sJ d}y x|D ]}| |}q W W n$ tk
rD tdt| Y nX |S )a<
Update the set with the given iterable sequence, then return the index
of the last element inserted.
Example:
>>> oset = OrderedSet([1, 2, 3])
>>> oset.update([3, 1, 5, 1, 4])
4
>>> print(oset)
OrderedSet([1, 2, 3, 5, 4])
Nz(Argument needs to be an iterable, got %s)r) r
ValueErrortype)r sequenceZ
item_indexitemr r r update s
zOrderedSet.updatec s$ t |r fdd|D S j| S )aH
Get the index of a given entry, raising an IndexError if it's not
present.
`key` can be an iterable of entries that is not a string, in which case
this returns a list of indices.
Example:
>>> oset = OrderedSet([1, 2, 3])
>>> oset.index(2)
1
c s g | ]} |qS r )r )r subkey)r r r r s z$OrderedSet.index..)r
r )r r& r )r r r s
zOrderedSet.indexc C s, | j std| j d }| j d= | j|= |S )z
Remove and return the last element from the set.
Raises KeyError if the set is empty.
Example:
>>> oset = OrderedSet([1, 2, 3])
>>> oset.pop()
3
z Set is empty)r KeyErrorr )r elemr r r pop s
zOrderedSet.popc C sT || krP| j | }| j|= | j |= x,| j D ] \}}||kr.|d | j |< q.W dS )a
Remove an element. Do not raise an exception if absent.
The MutableSet mixin uses this to implement the .remove() method, which
*does* raise an error when asked to remove a non-existent item.
Example:
>>> oset = OrderedSet([1, 2, 3])
>>> oset.discard(2)
>>> print(oset)
OrderedSet([1, 3])
>>> oset.discard(2)
>>> print(oset)
OrderedSet([1, 3])
N)r r )r r& r kvr r r discard s
zOrderedSet.discardc C s | j dd= | j dS )z8
Remove all items from this OrderedSet.
N)r r clear)r r r r r8 s zOrderedSet.clearc C s
t | jS )zb
Example:
>>> list(iter(OrderedSet([1, 2, 3])))
[1, 2, 3]
)iterr )r r r r r s zOrderedSet.__iter__c C s
t | jS )zf
Example:
>>> list(reversed(OrderedSet([1, 2, 3])))
[3, 2, 1]
)reversedr )r r r r __reversed__ s zOrderedSet.__reversed__c C s& | sd| j jf S d| j jt| f S )Nz%s()z%s(%r))r __name__r )r r r r __repr__ s zOrderedSet.__repr__c C sP t |ttfr t| t|kS y t|}W n tk
r> dS X t| |kS dS )a
Returns true if the containers have the same items. If `other` is a
Sequence, then order is checked, otherwise it is ignored.
Example:
>>> oset = OrderedSet([1, 3, 2])
>>> oset == [1, 3, 2]
True
>>> oset == [1, 2, 3]
False
>>> oset == [2, 3]
False
>>> oset == OrderedSet([3, 2, 1])
False
FN)r r r r setr )r otherZ other_as_setr r r __eq__ s zOrderedSet.__eq__c G s< t | tr| jnt}ttt| g|}tj|}||S )a
Combines all unique items.
Each items order is defined by its first appearance.
Example:
>>> oset = OrderedSet.union(OrderedSet([3, 1, 4, 1, 5]), [1, 3], [2, 0])
>>> print(oset)
OrderedSet([3, 1, 4, 5, 2, 0])
>>> oset.union([8, 9])
OrderedSet([3, 1, 4, 5, 2, 0, 8, 9])
>>> oset | {10}
OrderedSet([3, 1, 4, 5, 2, 0, 10])
)r r r r r itchain
from_iterable)r setsclsZ
containersr r r r union6 s zOrderedSet.unionc C s
| |S )N) intersection)r r? r r r __and__I s zOrderedSet.__and__c sH t | tr| jnt}|r>> oset = OrderedSet.intersection(OrderedSet([0, 1, 2, 3]), [1, 2, 3])
>>> print(oset)
OrderedSet([1, 2, 3])
>>> oset.intersection([2, 4, 5], [1, 2, 3, 4])
OrderedSet([2])
>>> oset.intersection()
OrderedSet([1, 2, 3])
c 3 s | ]}| kr|V qd S )Nr )r r- )commonr r ^ s z*OrderedSet.intersection..)r r r r> rG r )r rD rE r r )rI r rG M s zOrderedSet.intersectionc s: | j }|r.tjtt| fdd| D }n| }||S )a
Returns all elements that are in this set but not the others.
Example:
>>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]))
OrderedSet([1, 3])
>>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]), OrderedSet([3]))
OrderedSet([1])
>>> OrderedSet([1, 2, 3]) - OrderedSet([2])
OrderedSet([1, 3])
>>> OrderedSet([1, 2, 3]).difference()
OrderedSet([1, 2, 3])
c 3 s | ]}| kr|V qd S )Nr )r r- )r? r r rJ t s z(OrderedSet.difference..)r r> rF r )r rD rE r r )r? r
differencec s zOrderedSet.differencec s* t | t krdS t fdd| D S )a7
Report whether another set contains this set.
Example:
>>> OrderedSet([1, 2, 3]).issubset({1, 2})
False
>>> OrderedSet([1, 2, 3]).issubset({1, 2, 3, 4})
True
>>> OrderedSet([1, 2, 3]).issubset({1, 4, 3, 5})
False
Fc 3 s | ]}| kV qd S )Nr )r r- )r? r r rJ s z&OrderedSet.issubset..)r all)r r? r )r? r issubsety s zOrderedSet.issubsetc s* t t |k rdS t fdd|D S )a=
Report whether this set contains another set.
Example:
>>> OrderedSet([1, 2]).issuperset([1, 2, 3])
False
>>> OrderedSet([1, 2, 3, 4]).issuperset({1, 2, 3})
True
>>> OrderedSet([1, 4, 3, 5]).issuperset({1, 2, 3})
False
Fc 3 s | ]}| kV qd S )Nr )r r- )r r r rJ s z(OrderedSet.issuperset..)r rL )r r? r )r r
issuperset s zOrderedSet.issupersetc C s: t | tr| jnt}|| |}||| }||S )a
Return the symmetric difference of two OrderedSets as a new set.
That is, the new set will contain all elements that are in exactly
one of the sets.
Their order will be preserved, with elements from `self` preceding
elements from `other`.
Example:
>>> this = OrderedSet([1, 4, 3, 5, 7])
>>> other = OrderedSet([9, 7, 1, 3, 2])
>>> this.symmetric_difference(other)
OrderedSet([4, 5, 9, 2])
)r r r rK rF )r r? rE Zdiff1Zdiff2r r r symmetric_difference s z OrderedSet.symmetric_differencec C s || _ dd t|D | _dS )zt
Replace the 'items' list of this OrderedSet with a new one, updating
self.map accordingly.
c S s i | ]\}}||qS r r )r idxr- r r r
s z,OrderedSet._update_items..N)r enumerater )r r r r r
_update_items s zOrderedSet._update_itemsc s> t x|D ]} t |O q W | fdd| jD dS )a
Update this OrderedSet to remove items from one or more other sets.
Example:
>>> this = OrderedSet([1, 2, 3])
>>> this.difference_update(OrderedSet([2, 4]))
>>> print(this)
OrderedSet([1, 3])
>>> this = OrderedSet([1, 2, 3, 4, 5])
>>> this.difference_update(OrderedSet([2, 4]), OrderedSet([1, 4, 6]))
>>> print(this)
OrderedSet([3, 5])
c s g | ]}| kr|qS r r )r r- )items_to_remover r r s z0OrderedSet.difference_update..N)r> rS r )r rD r? r )rT r difference_update s
z OrderedSet.difference_updatec s& t | fdd| jD dS )a^
Update this OrderedSet to keep only items in another set, preserving
their order in this set.
Example:
>>> this = OrderedSet([1, 4, 3, 5, 7])
>>> other = OrderedSet([9, 7, 1, 3, 2])
>>> this.intersection_update(other)
>>> print(this)
OrderedSet([1, 3, 7])
c s g | ]}| kr|qS r r )r r- )r? r r r s z2OrderedSet.intersection_update..N)r> rS r )r r? r )r? r intersection_update s z OrderedSet.intersection_updatec s< fdd|D }t | fddjD | dS )a
Update this OrderedSet to remove items from another set, then
add items from the other set that were not present in this set.
Example:
>>> this = OrderedSet([1, 4, 3, 5, 7])
>>> other = OrderedSet([9, 7, 1, 3, 2])
>>> this.symmetric_difference_update(other)
>>> print(this)
OrderedSet([4, 5, 9, 2])
c s g | ]}| kr|qS r r )r r- )r r r r s z:OrderedSet.symmetric_difference_update..c s g | ]}| kr|qS r r )r r- )rT r r r s N)r> rS r )r r? Z items_to_addr )rT r r symmetric_difference_update s z&OrderedSet.symmetric_difference_update)N)#r<
__module__ __qualname____doc__r r r" r r# r% r' r) r( r. r Zget_locZ get_indexerr3 r7 r8 r r; r= r@ rF rH rG rK rM rN rO rS rU rV rW r r r r r * s@
r )rZ itertoolsrA collectionsr collections.abcr r ImportErrorr r __version__r
r r r r r s