D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
lib
/
python2.7
/
dist-packages
/
setuptools
/
_vendor
/
Filename :
ordered_set.pyc
back
Copy
� . ^c @ s� d Z d d l Z d d l m Z y d d l m Z m Z Wn' e k re d d l m Z m Z n Xe d � Z d Z d � Z d e e f d � � YZ d S( s� 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. i����N( t deque( t MutableSett Sequences 3.1c C s- t | d � o, t | t � o, t | t � S( s 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. t __iter__( t hasattrt isinstancet strt tuple( t obj( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt is_iterable s t OrderedSetc B s e Z d Z d d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z e Z d � Z d � Z e Z e Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z! d � Z" RS( s� 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]) c C s/ g | _ i | _ | d k r+ | | O} n d S( N( t itemst mapt None( t selft iterable( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __init__4 s c C s t | j � S( s� Returns the number of unique elements in the ordered set Example: >>> len(OrderedSet([])) 0 >>> len(OrderedSet([1, 2])) 2 ( t lenR ( R ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __len__: s c C s� t | t � r% | t k r% | j � St | � rO g | D] } | j | ^ q8 St | d � sm t | t � r� | j | } t | t � r� | j | � S| Sn t d | � � d S( sQ 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 t __index__s+ Don't know how to index an OrderedSet by %rN( R t slicet SLICE_ALLt copyR R R t listt __class__t TypeError( R t indext it result( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __getitem__F s c C s | j | � S( s� 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 ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyR e s c C s$ t | � d k r d St | � Sd S( Ni ( N( R R R ( R ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __getstate__s s c C s- | d k r | j g � n | j | � d S( N( N( R R ( R t state( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __setstate__ s c C s | | j k S( s� 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 t key( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __contains__� s c C sC | | j k r8 t | j � | j | <| j j | � n | j | S( sE 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 t append( R R! ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt add� s c C sX d } y$ x | D] } | j | � } q WWn' t k rS t d t | � � � n X| S( s< 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]) s( Argument needs to be an iterable, got %sN( R R$ R t ValueErrort type( R t sequencet item_indext item( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt update� s c C s7 t | � r, g | D] } | j | � ^ q S| j | S( sH 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 ( R R R ( R R! t subkey( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyR � s c C s= | j s t d � � n | j d } | j d =| j | =| S( s� 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 s Set is emptyi����( R t KeyErrorR ( R t elem( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt pop� s c C st | | k rp | j | } | j | =| j | =x@ | j j � D], \ } } | | k r= | d | j | <q= q= Wn d S( s� 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]) i N( R R ( R R! R t kt v( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt discard� s c C s | j 2| j j � d S( s8 Remove all items from this OrderedSet. N( R R t clear( R ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyR2 � s c C s t | j � S( sb Example: >>> list(iter(OrderedSet([1, 2, 3]))) [1, 2, 3] ( t iterR ( R ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyR s c C s t | j � S( sf Example: >>> list(reversed(OrderedSet([1, 2, 3]))) [3, 2, 1] ( t reversedR ( R ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __reversed__ s c C s1 | s d | j j f Sd | j j t | � f S( Ns %s()s %s(%r)( R t __name__R ( R ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __repr__ s c C sd t | t t f � r+ t | � t | � k Sy t | � } Wn t k rO t SXt | � | k Sd S( s� 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 N( R R R R t setR t False( R t othert other_as_set( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __eq__ s c G sX t | t � r | j n t } t t t j | g | � � } t j j | � } | | � S( s� 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 t itt chaint from_iterable( R t setst clst containersR ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt union6 s c C s | j | � S( N( t intersection( R R: ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt __and__I s c se t | t � r | j n t } | rU t j t t | � � � � f d � | D� } n | } | | � S( s� Returns elements in common between all sets. Order is defined only by the first set. Example: >>> 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! | ] } | � k r | Vq d S( N( ( t .0R) ( t common( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pys <genexpr>^ s ( R R R R8 RD R ( R R@ RA R ( ( RG sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyRD M s c sP | j } | r@ t j t t | � � � � f d � | D� } n | } | | � S( s� 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! | ] } | � k r | Vq d S( N( ( RF R) ( R: ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pys <genexpr>t s ( R R8 RC R ( R R@ RA R ( ( R: sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt differencec s c s6 t | � t � � k r t St � f d � | D� � S( s7 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 c 3 s | ] } | � k Vq d S( N( ( RF R) ( R: ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pys <genexpr>� s ( R R9 t all( R R: ( ( R: sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt issubsety s c s6 t � � t | � k r t St � f d � | D� � S( s= 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 c 3 s | ] } | � k Vq d S( N( ( RF R) ( R ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pys <genexpr>� s ( R R9 RI ( R R: ( ( R sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt issuperset� s c C sU t | t � r | j n t } | | � j | � } | | � j | � } | j | � S( s� 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 RH RC ( R R: RA t diff1t diff2( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt symmetric_difference� s c C s& | | _ d � t | � D� | _ d S( st Replace the 'items' list of this OrderedSet with a new one, updating self.map accordingly. c S s i | ] \ } } | | � q S( ( ( RF t idxR) ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pys <dictcomp>� s N( R t enumerateR ( R R ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt _update_items� s c G s] t � } x | D] } | t | � O} q W| j g | j D] } | | k r: | ^ q: � d S( s� 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]) N( R8 RQ R ( R R@ t items_to_removeR: R) ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt difference_update� s c C s? t | � } | j g | j D] } | | k r | ^ q � d S( s^ 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]) N( R8 RQ R ( R R: R) ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt intersection_update� s c C sh g | D] } | | k r | ^ q } t | � } | j g | j D] } | | k rA | ^ qA | � d S( s� 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]) N( R8 RQ R ( R R: R) t items_to_addRR ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt symmetric_difference_update� s % N(# R6 t __module__t __doc__R R R R R R R R" R$ R# R* R t get_loct get_indexerR. R1 R2 R R5 R7 R< RC RE RD RH RJ RK RN RQ RS RT RV ( ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyR * s@ ( RX t itertoolsR= t collectionsR t collections.abcR R t ImportErrorR R R t __version__R R ( ( ( sB /usr/lib/python2.7/dist-packages/setuptools/_vendor/ordered_set.pyt <module> s