Plan 9 from Bell Labs’s /usr/web/sources/contrib/stallion/root/sys/lib/python2.7/collections.pyo

Copyright © 2021 Plan 9 Foundation.
Distributed under the MIT License.
Download the Plan 9 distribution.


�`^c@sddddddgZddlTddlZeej7ZddlmZmZdd	lmZmZ	dd
l
mZddl
ZddlZddlmZmZmZddlmZydd
lmZWn!ek
r�dd
lmZnXdefd��YZ dZ!dZ"dZ#e$e$d�Z%defd��YZ&e'dkr`ddl(m)Z)m*Z*e%dde+�Z,e,dddd�Z-de%dd�fd��YZ,x/e,dd�e,d d!d"�fD]Z-e-GHq�Wde%dd�fd#��YZ,e,d$d%�j.dd&�GHe%d'e,j/d(f�Z0e0j1GHddl2Z2e%d)d*�Z3e3e2j4��GHndS(+tCountertdequetdefaultdictt
namedtupletOrderedDicti�(t*N(RR(t
itemgetterteq(t	iskeyword(trepeattchaintstarmap(timap(t	get_identcBseZdZd�Zejd�Zejd�Zd�Zd�Zd�Z	d�Z
d�Zd	�Zd
�Z
d�Zd�ZejZeZe�Zed
�Zdd�Zed�Zid�Zd�Zd�Zedd��Zd�Zd�Z d�Z!d�Z"d�Z#RS(s)Dictionary that remembers insertion ordercOs�t|�dkr+tdt|���ny|jWn7tk
rog|_}||dg|(i|_nX|j||�dS(s�Initialize an ordered dictionary.  The signature is the same as
        regular dictionaries, but keyword arguments are not recommended because
        their insertion order is arbitrary.

        is$expected at most 1 arguments, got %dN(tlent	TypeErrort_OrderedDict__roottAttributeErrortNonet_OrderedDict__mapt_OrderedDict__update(tselftargstkwdstroot((s!/sys/lib/python2.7/collections.pyt__init__&s


cCsX||krH|j}|d}|||g|d<|d<|j|<n||||�S(s!od.__setitem__(i, y) <==> od[i]=yii(RR(Rtkeytvaluetdict_setitemRtlast((s!/sys/lib/python2.7/collections.pyt__setitem__6s
	
)cCs@|||�|jj|�\}}}||d<||d<dS(s od.__delitem__(y) <==> del od[y]iiN(Rtpop(RRtdict_delitemt	link_prevt	link_nextt_((s!/sys/lib/python2.7/collections.pyt__delitem__@s

ccs=|j}|d}x#||k	r8|dV|d}qWdS(sod.__iter__() <==> iter(od)iiN(R(RRtcurr((s!/sys/lib/python2.7/collections.pyt__iter__Is
	
	ccs=|j}|d}x#||k	r8|dV|d}qWdS(s#od.__reversed__() <==> reversed(od)iiN(R(RRR%((s!/sys/lib/python2.7/collections.pyt__reversed__Rs
	
	cCs7|j}||dg|(|jj�tj|�dS(s.od.clear() -> None.  Remove all items from od.N(RRRtcleartdict(RR((s!/sys/lib/python2.7/collections.pyR([s	
cCs
t|�S(sod.keys() -> list of keys in od(tlist(R((s!/sys/lib/python2.7/collections.pytkeysdscCsg|D]}||^qS(s#od.values() -> list of values in od((RR((s!/sys/lib/python2.7/collections.pytvalueshscCs!g|D]}|||f^qS(s.od.items() -> list of (key, value) pairs in od((RR((s!/sys/lib/python2.7/collections.pytitemslscCs
t|�S(s0od.iterkeys() -> an iterator over the keys in od(titer(R((s!/sys/lib/python2.7/collections.pytiterkeyspsccsx|D]}||VqWdS(s2od.itervalues -> an iterator over the values in odN((Rtk((s!/sys/lib/python2.7/collections.pyt
itervaluests
ccs$x|D]}|||fVqWdS(s=od.iteritems -> an iterator over the (key, value) pairs in odN((RR0((s!/sys/lib/python2.7/collections.pyt	iteritemsys
cCsC||kr!||}||=|S||jkr?t|��n|S(s�od.pop(k[,d]) -> v, remove specified key and return the corresponding
        value.  If key is not found, d is returned if given, otherwise KeyError
        is raised.

        (t_OrderedDict__markertKeyError(RRtdefaulttresult((s!/sys/lib/python2.7/collections.pyR�s
cCs"||kr||S|||<|S(sDod.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od((RRR5((s!/sys/lib/python2.7/collections.pyt
setdefault�s
cCsR|std��nt|r*t|�n	t|��}|j|�}||fS(s�od.popitem() -> (k, v), return and remove a (key, value) pair.
        Pairs are returned in LIFO order if last is true or FIFO order if false.

        sdictionary is empty(R4tnexttreversedR.R(RRRR((s!/sys/lib/python2.7/collections.pytpopitem�s
$cCsst|�t�f}||kr%dSd||<z5|sId|jjfSd|jj|j�fSWd||=XdS(sod.__repr__() <==> repr(od)s...is%s()s%s(%r)N(tidt
_get_identt	__class__t__name__R-(Rt
_repr_runningtcall_key((s!/sys/lib/python2.7/collections.pyt__repr__�s
cCs�g|D]}|||g^q}t|�j�}x'tt��D]}|j|d�qEW|rx|j|f|fS|j|ffS(s%Return state information for picklingN(tvarstcopyRRRR=(RR0R-t	inst_dict((s!/sys/lib/python2.7/collections.pyt
__reduce__�s#cCs
|j|�S(s!od.copy() -> a shallow copy of od(R=(R((s!/sys/lib/python2.7/collections.pyRC�scCs(|�}x|D]}|||<qW|S(sOD.fromkeys(S[, v]) -> New ordered dictionary with keys from S.
        If not specified, the value defaults to None.

        ((tclstiterableRRR((s!/sys/lib/python2.7/collections.pytfromkeys�s	
cCsGt|t�r7tj||�o6ttt||��Stj||�S(s�od.__eq__(y) <==> od==y.  Comparison to another OD is order-sensitive
        while comparison to a regular mapping is order-insensitive.

        (t
isinstanceRR)t__eq__tallt_imapt_eq(Rtother((s!/sys/lib/python2.7/collections.pyRJ�s(cCs||kS(sod.__ne__(y) <==> od!=y((RRN((s!/sys/lib/python2.7/collections.pyt__ne__�scCs
t|�S([email protected]() -> a set-like object providing a view on od's keys(tKeysView(R((s!/sys/lib/python2.7/collections.pytviewkeys�scCs
t|�S(s<od.viewvalues() -> an object providing a view on od's values(t
ValuesView(R((s!/sys/lib/python2.7/collections.pyt
viewvalues�scCs
t|�S(sBod.viewitems() -> a set-like object providing a view on od's items(t	ItemsView(R((s!/sys/lib/python2.7/collections.pyt	viewitems�sN($R>t
__module__t__doc__RR)RR$R&R'R(R+R,R-R/R1R2tMutableMappingtupdateRtobjectR3RRR7tTrueR:RARERCtclassmethodRHRJRORQRSRU(((s!/sys/lib/python2.7/collections.pyRs:	
															
	
	
					s�class {typename}(tuple):
    '{typename}({arg_list})'

    __slots__ = ()

    _fields = {field_names!r}

    def __new__(_cls, {arg_list}):
        'Create new instance of {typename}({arg_list})'
        return _tuple.__new__(_cls, ({arg_list}))

    @classmethod
    def _make(cls, iterable, new=tuple.__new__, len=len):
        'Make a new {typename} object from a sequence or iterable'
        result = new(cls, iterable)
        if len(result) != {num_fields:d}:
            raise TypeError('Expected {num_fields:d} arguments, got %d' % len(result))
        return result

    def __repr__(self):
        'Return a nicely formatted representation string'
        return '{typename}({repr_fmt})' % self

    def _asdict(self):
        'Return a new OrderedDict which maps field names to their values'
        return OrderedDict(zip(self._fields, self))

    def _replace(_self, **kwds):
        'Return a new {typename} object replacing specified fields with new values'
        result = _self._make(map(kwds.pop, {field_names!r}, _self))
        if kwds:
            raise ValueError('Got unexpected field names: %r' % kwds.keys())
        return result

    def __getnewargs__(self):
        'Return self as a plain tuple.  Used by copy and pickle.'
        return tuple(self)

    __dict__ = _property(_asdict)

    def __getstate__(self):
        'Exclude the OrderedDict from pickling'
        pass

{field_defs}
s	{name}=%rsW    {name} = _property(_itemgetter({index:d}), doc='Alias for field number {index:d}')
cBs@e|e�r*|jdd�j�}nee|�}e|�}|r��}x�e|�D]\}}ed�|D��s�e	|�s�|s�|dj
�s�|jd�s�||kr�d|||<n|j|�qaWnx�|g|D]�}e
|�ekred��ned�|D��sEed	|��ne	|�rded
|��n|dj
�r�d|��q�We�}xc|D][}|jd�r�|r�ed|��n||kr�d
|��n|j|�q�Wejd|de|�de|�dee|��jdd�dd!ddjd�|D��ddjd�e|�D���}|r�|GHnededd|ded ed!e�}y||UWn*ek
r�	e|	jd"|��nX||}
y%ejd�jjdd#�|
_ Wne!efk
r;nX|
S($sCReturns a new subclass of tuple with named fields.

    >>> Point = namedtuple('Point', ['x', 'y'])
    >>> Point.__doc__                   # docstring for the new class
    'Point(x, y)'
    >>> p = Point(11, y=22)             # instantiate with positional args or keywords
    >>> p[0] + p[1]                     # indexable like a plain tuple
    33
    >>> x, y = p                        # unpack like a regular tuple
    >>> x, y
    (11, 22)
    >>> p.x + p.y                       # fields also accessable by name
    33
    >>> d = p._asdict()                 # convert to a dictionary
    >>> d['x']
    11
    >>> Point(**d)                      # convert from a dictionary
    Point(x=11, y=22)
    >>> p._replace(x=100)               # _replace() is like str.replace() but targets named fields
    Point(x=100, y=22)

    t,t css'|]}|j�p|dkVqdS(R#N(tisalnum(t.0tc((s!/sys/lib/python2.7/collections.pys	<genexpr>AsiR#s_%ds*Type names and field names must be stringscss'|]}|j�p|dkVqdS(R#N(R_(R`Ra((s!/sys/lib/python2.7/collections.pys	<genexpr>LssWType names and field names can only contain alphanumeric characters and underscores: %rs2Type names and field names cannot be a keyword: %rs9Type names and field names cannot start with a number: %rs/Field names cannot start with an underscore: %rs$Encountered duplicate field name: %rttypenametfield_namest
num_fieldstarg_listt'tii�trepr_fmts, css!|]}tjd|�VqdS(tnameN(t_repr_templatetformat(R`Ri((s!/sys/lib/python2.7/collections.pys	<genexpr>dst
field_defss
css-|]#\}}tjd|d|�VqdS(tindexRiN(t_field_templateRk(R`RmRi((s!/sys/lib/python2.7/collections.pys	<genexpr>fst_itemgetterR>s
namedtuple_%sRt	_propertyt_tuples:
t__main__("RIt
basestringtreplacetsplittmaptstrtsett	enumerateRKt
_iskeywordtisdigitt
startswithtaddttypeRt
ValueErrort_class_templateRkttupleRtreprtjoinR)RoRtpropertytSyntaxErrortmessaget_syst	_getframet	f_globalstgetRVR(RbRctverbosetrenametseenRmRitclass_definitiont	namespaceteR6((s!/sys/lib/python2.7/collections.pyR st	

	

	%

%cBs�eZdZdd�Zd�Zdd�Zd�Zedd��Z	dd�Z
dd�Zd�Zd	�Z
d
�Zd�Zd�Zd
�Zd�Zd�ZRS(s�Dict subclass for counting hashable items.  Sometimes called a bag
    or multiset.  Elements are stored as dictionary keys and their counts
    are stored as dictionary values.

    >>> c = Counter('abcdeabcdabcaba')  # count elements from a string

    >>> c.most_common(3)                # three most common elements
    [('a', 5), ('b', 4), ('c', 3)]
    >>> sorted(c)                       # list all unique elements
    ['a', 'b', 'c', 'd', 'e']
    >>> ''.join(sorted(c.elements()))   # list elements with repetitions
    'aaaaabbbbcccdde'
    >>> sum(c.values())                 # total of all counts
    15

    >>> c['a']                          # count of letter 'a'
    5
    >>> for elem in 'shazam':           # update counts from an iterable
    ...     c[elem] += 1                # by adding 1 to each element's count
    >>> c['a']                          # now there are seven 'a'
    7
    >>> del c['b']                      # remove all 'b'
    >>> c['b']                          # now there are zero 'b'
    0

    >>> d = Counter('simsalabim')       # make another counter
    >>> c.update(d)                     # add in the second counter
    >>> c['a']                          # now there are nine 'a'
    9

    >>> c.clear()                       # empty the counter
    >>> c
    Counter()

    Note:  If a count is set to zero or reduced to zero, it will remain
    in the counter until the entry is deleted or the counter is cleared:

    >>> c = Counter('aaabbc')
    >>> c['b'] -= 2                     # reduce the count of 'b' by two
    >>> c.most_common()                 # 'b' is still in, but its count is zero
    [('a', 3), ('c', 1), ('b', 0)]

    cKs'tt|�j�|j||�dS(s	Create a new, empty Counter object.  And if given, count elements
        from an input iterable.  Or, initialize the count from another mapping
        of elements to their counts.

        >>> c = Counter()                           # a new, empty counter
        >>> c = Counter('gallahad')                 # a new counter from an iterable
        >>> c = Counter({'a': 4, 'b': 2})           # a new counter from a mapping
        >>> c = Counter(a=4, b=2)                   # a new counter from keyword args

        N(tsuperRRRY(RRGR((s!/sys/lib/python2.7/collections.pyR�scCsdS(s1The count of elements not in the Counter is zero.i((RR((s!/sys/lib/python2.7/collections.pyt__missing__�scCsP|dkr.t|j�dtd�dt�Stj||j�dtd��S(s�List the n most common elements and their counts from the most
        common to the least.  If n is None, then list all element counts.

        >>> Counter('abcdeabcdabcaba').most_common(3)
        [('a', 5), ('b', 4), ('c', 3)]

        RitreverseN(RtsortedR2RoR[t_heapqtnlargest(Rtn((s!/sys/lib/python2.7/collections.pytmost_common�s	"cCstjtt|j���S(s�Iterator over elements repeating each as many times as its count.

        >>> c = Counter('ABCABC')
        >>> sorted(c.elements())
        ['A', 'A', 'B', 'B', 'C', 'C']

        # Knuth's example for prime factors of 1836:  2**2 * 3**3 * 17**1
        >>> prime_factors = Counter({2: 2, 3: 3, 17: 1})
        >>> product = 1
        >>> for factor in prime_factors.elements():     # loop over factors
        ...     product *= factor                       # and multiply them
        >>> product
        1836

        Note, if an element's count has been set to zero or is a negative
        number, elements() will ignore it.

        (t_chaint
from_iterablet_starmapt_repeatR2(R((s!/sys/lib/python2.7/collections.pytelements�scCstd��dS([email protected]() is undefined.  Use Counter(iterable) instead.(tNotImplementedError(RFRGtv((s!/sys/lib/python2.7/collections.pyRH�scKs�|dk	r�t|t�rz|ra|j}xJ|j�D]#\}}||d�|||<q7Wq�tt|�j|�q�|j}x(|D]}||d�d||<q�Wn|r�|j|�ndS(s�Like dict.update() but add counts instead of replacing them.

        Source can be an iterable, a dictionary, or another Counter instance.

        >>> c = Counter('which')
        >>> c.update('witch')           # add elements from another iterable
        >>> d = Counter('watch')
        >>> c.update(d)                 # add elements from another counter
        >>> c['h']                      # four 'h' in which, witch, and watch
        4

        iiN(RRItMappingR�R2R�RRY(RRGRtself_gettelemtcount((s!/sys/lib/python2.7/collections.pyRY�s		
cKs�|dk	r�|j}t|t�r[x\|j�D]#\}}||d�|||<q1Wq�x(|D]}||d�d||<qbWn|r�|j|�ndS(s�Like dict.update() but subtracts counts instead of replacing them.
        Counts can be reduced below zero.  Both the inputs and outputs are
        allowed to contain zero and negative counts.

        Source can be an iterable, a dictionary, or another Counter instance.

        >>> c = Counter('which')
        >>> c.subtract('witch')             # subtract elements from another iterable
        >>> c.subtract(Counter('watch'))    # subtract elements from another counter
        >>> c['h']                          # 2 in which, minus 1 in witch, minus 1 in watch
        0
        >>> c['w']                          # 1 in which, minus 1 in witch, minus 1 in watch
        -1

        iiN(RR�RIR�R-tsubtract(RRGRR�R�R�((s!/sys/lib/python2.7/collections.pyR�s	
cCs
|j|�S(sReturn a shallow copy.(R=(R((s!/sys/lib/python2.7/collections.pyRC6scCs|jt|�ffS(N(R=R)(R((s!/sys/lib/python2.7/collections.pyRE:scCs)||kr%tt|�j|�ndS(sGLike dict.__delitem__() but does not raise KeyError for missing values.N(R�RR$(RR�((s!/sys/lib/python2.7/collections.pyR$=scCsI|sd|jjSdjtdj|j���}d|jj|fS(Ns%s()s, s%r: %rs%s({%s})(R=R>R�Rvt__mod__R�(RR-((s!/sys/lib/python2.7/collections.pyRABs!cCs�t|t�stSt�}xA|j�D]3\}}|||}|dkr)|||<q)q)Wx?|j�D]1\}}||krm|dkrm|||<qmqmW|S(sAdd counts from two counters.

        >>> Counter('abbb') + Counter('bcc')
        Counter({'b': 4, 'c': 2, 'a': 1})

        i(RIRtNotImplementedR-(RRNR6R�R�tnewcount((s!/sys/lib/python2.7/collections.pyt__add__Qs	cCs�t|t�stSt�}xA|j�D]3\}}|||}|dkr)|||<q)q)WxC|j�D]5\}}||krm|dkrmd|||<qmqmW|S(s� Subtract count, but keep only results with positive counts.

        >>> Counter('abbbc') - Counter('bccd')
        Counter({'b': 2, 'a': 1})

        i(RIRR�R-(RRNR6R�R�R�((s!/sys/lib/python2.7/collections.pyt__sub__ds	cCs�t|t�stSt�}xU|j�D]G\}}||}||krQ|n|}|dkr)|||<q)q)Wx?|j�D]1\}}||kr�|dkr�|||<q�q�W|S(s�Union is the maximum of value in either of the input counters.

        >>> Counter('abbb') | Counter('bcc')
        Counter({'b': 3, 'c': 2, 'a': 1})

        i(RIRR�R-(RRNR6R�R�tother_countR�((s!/sys/lib/python2.7/collections.pyt__or__ws	
cCsxt|t�stSt�}xU|j�D]G\}}||}||krQ|n|}|dkr)|||<q)q)W|S(s� Intersection is the minimum of corresponding counts.

        >>> Counter('abbb') & Counter('bcc')
        Counter({'b': 1})

        i(RIRR�R-(RRNR6R�R�R�R�((s!/sys/lib/python2.7/collections.pyt__and__�s	
N(R>RVRWRRR�R�R�R\RHRYR�RCRER$RAR�R�R�R�(((s!/sys/lib/python2.7/collections.pyR�s"+	
	#							Rr(tloadstdumpstPointsx, ytxi
tyisx ycBs&eZdZed��Zd�ZRS(cCs|jd|jddS(Nig�R�R�(R((s!/sys/lib/python2.7/collections.pythypot�scCsd|j|j|jfS(Ns$Point: x=%6.3f  y=%6.3f  hypot=%6.3f(R�R�R�(R((s!/sys/lib/python2.7/collections.pyt__str__�s((R>RVt	__slots__R�R�R�(((s!/sys/lib/python2.7/collections.pyR��siiiig@cBs/eZdZdZeej�Zed�Z	RS(sHPoint class with optimized _make() and _replace() without error-checkingcKs|j||jd|��S(NR�R�(R�R�(t_makeR�(Rt_mapR((s!/sys/lib/python2.7/collections.pyt_replace�s((
R>RVRWR�R\R�t__new__R�RvR�(((s!/sys/lib/python2.7/collections.pyR��siiidtPoint3DtztTestResultssfailed attempted(5t__all__t_abcollt_collectionsRRtoperatorRRoRRMtkeywordRRztsysR�theapqR�t	itertoolsR	R�R
R�RR�RRLtthreadR
R<tImportErrortdummy_threadR)RR�RjRntFalseRRR>tcPickleR�R�R[R�tpR�t_fieldsR�RWtdoctestR�ttestmod(((s!/sys/lib/python2.7/collections.pyt<module>sF


�f�)	

Bell Labs OSI certified Powered by Plan 9

(Return to Plan 9 Home Page)

Copyright © 2021 Plan 9 Foundation. All Rights Reserved.
Comments to [email protected].