#s(3Y??? Iv / / {6?6<S+ABINNN F # # =(I(I {2I>>>tr c e Zd ZU dZded< ded< ded< ded < d d fd
Zd dZd dZd!dZd"dZ d#dZ
d$dZ d%d Z xZ
S )&r a
Provides a thread-safe dict-like container which maintains up to
``maxsize`` keys while throwing away the least-recently-used keys beyond
``maxsize``.
:param maxsize:
Maximum number of recent elements to retain.
:param dispose_func:
Every time an item is evicted from the container,
``dispose_func(value)`` is called. Callback which will get called
z typing.OrderedDict[_KT, _VT]
_containerint_maxsize#typing.Callable[[_VT], None] | None dispose_funcr lock
Nmaxsizer Nonec t || _ || _ t | _ t
| _ d S r )super__init__r7 r9 r r5 r r: )r r< r9 __class__s r r@ z RecentlyUsedContainer.__init__R sD
(%--GG r r r" r# c | j 5 | j | }|| j |< |cd d d S # 1 swxY w Y d S r )r: r5 pop)r r items r r z!RecentlyUsedContainer.__getitem__] s
Y ?&&s++D#'DOC
&;??valuec d }| j 5 || j | f}|| j |< nR# t $ rE || j |< t | j | j k r| j d }Y nw xY wd d d n # 1 swxY w Y |#| j r |\ }}| | d S d S d S )NF)last)r: r5 rC KeyErrorlenr7 popitemr9 )r r rF evicted_item_
evicted_values r __setitem__z!RecentlyUsedContainer.__setitem__d sH
Y G G
G #DO$7$7$<$< < ',$$
G
G
G (-$t''$-77 $(?#:#:#:#F#FL
G G G G G G G G G G G G G G G G& #(9 # + A} m , , , , , $ # # #s2 B&3BA B?BBBBBc | j 5 | j | }d d d n # 1 swxY w Y | j r| | d S d S r )r: r5 rC r9 )r r rF s r __delitem__z!RecentlyUsedContainer.__delitem__} s
Y - -O'',,E - - - - - - - - - - - - - - - % e $ $ $ $ $ % %s /33c l | j 5 t | j cd d d S # 1 swxY w Y d S r )r: rJ r5 r s r __len__z RecentlyUsedContainer.__len__ s{
Y ( (t'' ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( (s )--typing.NoReturnc t d )Nz7Iteration over this class is unlikely to be threadsafe.)NotImplementedErrorr s r __iter__z RecentlyUsedContainer.__iter__ s ! E
r c | j 5 t | j }| j d d d n # 1 swxY w Y | j r|D ]}| | d S d S r )r: listr5 valuesclearr9 )r rZ rF s r r[ zRecentlyUsedContainer.clear s
Y $ $$/002233F O ! ! # # # $ $ $ $ $ $ $ $ $ $ $ $ $ $ $
)
)
)!!%(((( ) )
)
)s A AAAset[_KT]c | j 5 t | j cd d d S # 1 swxY w Y d S r )r: setr5 r r s r r zRecentlyUsedContainer.keys s
Y / /t++--.. / / / / / / / / / / / / / / / / / /rE )r; N)r< r6 r9 r8 r r= )r r" r r# )r r" rF r# r r= )r r" r r= r r6 )r rT )r r= )r r\ )r r r __doc____annotations__r@ r rO rQ rS rW r[ r
__classcell__rA s @r r r ? s -,,,MMM5555KKK <@ - - - -2% % % %( ( ( (
) ) ) )/ / / / / / / /r c > e Zd ZU dZded< ddZdd Zdd ZddZdS )HTTPHeaderDictItemViewa
HTTPHeaderDict is unusual for a Mapping[str, str] in that it has two modes of
address.
If we directly try to get an item with a particular name, we will get a string
back that is the concatenated version of all the values:
>>> d['X-Header-Name']
'Value1, Value2, Value3'
However, if we iterate over an HTTPHeaderDict's items, we will optionally combine
these values based on whether combine=True was called when building up the dictionary
>>> d = HTTPHeaderDict({"A": "1", "B": "foo"})
>>> d.add("A", "2", combine=True)
>>> d.add("B", "bar")
>>> list(d.items())
[
('A', '1, 2'),
('B', 'foo'),
('B', 'bar'),
]
This class conforms to the interface required by the MutableMapping ABC while
also giving us the nonstandard iteration behavior we want; items with duplicate
keys, ordered by time of first insertion.
r! _headersheadersr r= c || _ d S r )rf )r rg s r r@ z HTTPHeaderDictItemView.__init__ s
r r6 c h t t | j S r )rJ rY rf iteritemsr s r rS z HTTPHeaderDictItemView.__len__ s& 4
//1122333r typing.Iterator[tuple[str, str]]c 4 | j S r )rf rj r s r rW z HTTPHeaderDictItemView.__iter__ s }&&(((r rD r) boolc t |t r]t | dk rJ|\ }}t |t r0t |t r| j || S dS )N F)r, tuplerJ r rf _has_value_for_header)r rD
passed_key
passed_vals r __contains__z#HTTPHeaderDictItemView.__contains__ so dE " " Ss4yyA~~%) "J
*c**
Sz*c/J/J
S}:::zRRRur N)rg r! r r= r_ r rk )rD r) r rm ) r r r r` ra r@ rS rW rt r r r re re s~ 8 4 4 4 4) ) ) ) r re c X e Zd ZU dZded< d;d< fd
Zd=dZd>dZd?dZd@dZ dAdB fd
Z
dCdZ dCdZ dDdZ
dEd Zd?d Zd d dFd"ZdGd%Zej dHd' Zej dId* Zej fdJd,ZeZeZeZeZdKd-ZdLd.Z dMd/Z dNd1Z dNd2Z dOd4Z dPd7Z!dQd8Z"dQd9Z#dQd:Z$ xZ%S )Rr! ap
:param headers:
An iterable of field-value pairs. Must not contain multiple field names
when compared case-insensitively.
:param kwargs:
Additional field-value pairs to pass in to ``dict.update``.
A ``dict`` like container for storing HTTP Headers.
Field names are stored and compared case-insensitively in compliance with
RFC 7230. Iteration provides the first case-sensitive key seen for each
case-insensitive pair.
Using ``__setitem__`` syntax overwrites fields that compare equal
case-insensitively in order to maintain ``dict``'s api. For fields that
compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
in a loop.
If multiple fields that are equal case-insensitively are passed to the
constructor or ``.update``, the behavior is undefined and some will be
lost.
>>> headers = HTTPHeaderDict()
>>> headers.add('Set-Cookie', 'foo=bar')
>>> headers.add('set-cookie', 'baz=quxx')
>>> headers['content-length'] = '7'
>>> headers['SET-cookie']
'foo=bar, baz=quxx'
>>> headers['Content-Length']
'7'
z%typing.MutableMapping[str, list[str]]r5 Nrg r* kwargsr c t i | _ |@t |t r| | n| | |r| | d S d S r )r? r@ r5 r, r!
_copy_fromextend)r rg rw rA s r r@ zHTTPHeaderDict.__init__ s
'>22
%(((( G$$$ KK r r valr r= c t |t r| d }||g| j | < d S )Nlatin-1)r, bytesdecoder5 lowerr r r{ s r rO zHTTPHeaderDict.__setitem__ sC c5 ! ! (**Y''C(+Sz $$$r c z | j | }d |dd S )N, r5 r joinr s r r zHTTPHeaderDict.__getitem__ s0 ociikk*yyQRR!!!r c : | j | = d S r r5 r r s r rQ zHTTPHeaderDict.__delitem__ s OCIIKK ( ( (r r) rm c f t |t r| | j v S dS )NF)r, r r r5 r s r rt zHTTPHeaderDict.__contains__ s. c3 299;;$/1 1ur defaultc H t || S r )r?
setdefault)r r r rA s r r zHTTPHeaderDict.setdefault
s ww!!#w///r otherc t | }|dS t | | }d | D d | D k S )NFc > i | ]\ }}| |S r r .0kvs r
z)HTTPHeaderDict.__eq__.. s& ;;;A 1;;;r c > i | ]\ }}| |S r r r s r r z)HTTPHeaderDict.__eq__.. s9 @
@
@
!QAGGIIq@
@
@
r )r3 type
itermerged)r r maybe_constructableother_as_http_header_dicts r __eq__zHTTPHeaderDict.__eq__ s CE J J &5(2T
3F(G(G %;; ):):;;; @
@
%>%I%I%K%K@
@
@
r c . | | S r )r )r r s r __ne__zHTTPHeaderDict.__ne__ s ;;u%%%%r r6 c * t | j S r )rJ r5 r s r rS zHTTPHeaderDict.__len__ s 4?###r r c # V K | j D ] }|d V
d S )Nr )r5 rZ )r valss r rW zHTTPHeaderDict.__iter__! s< O**,, Dq'MMMM r c 0 | |= d S # t $ r Y d S w xY wr )rI r s r discardzHTTPHeaderDict.discard& s4 S DD s
F)combiner c J t |t r| d }| }||g}| j || }||urAt
| dk sJ |r|d dz |z |d< dS | | dS dS )a Adds a (name, value) pair, doesn't overwrite the value if it already
exists.
If this is called with combine=True, instead of adding a new header value
as a distinct item during iteration, this will instead append the value to
any existing header value with a comma. If no existing header value exists
for the key, then the value will simply be added, ignoring the combine parameter.
>>> headers = HTTPHeaderDict(foo='bar')
>>> headers.add('Foo', 'baz')
>>> headers['foo']
'bar, baz'
>>> list(headers.items())
[('foo', 'bar'), ('foo', 'baz')]
>>> headers.add('foo', 'quz', combine=True)
>>> list(headers.items())
[('foo', 'bar, baz, quz')]
r} ro r N)r, r~ r r r5 r rJ append)r r r{ r key_lowernew_valsr s r addzHTTPHeaderDict.add, s ( c5 ! ! (**Y''CIIKK :)))X>> 4 t99>>>>
! 8d?S0R C r argsValidHTTPHeaderSourcec t | dk r t dt | d t | dk r|d nd}t |t r2| D ]\ }}| || nt |t j r1| D ]\ }}| || nt |t j r`t
j
t j t j t t f | }|D ]\ }}| || nSt |d rCt |d r3| D ] }| ||| | D ]\ }}| || dS ) zGeneric import function for any type of header-like object.
Adapted version of MutableMapping.update in order to insert items
with self.add instead of self.__setitem__
r z/extend() takes at most 1 positional arguments (z given)r r r r N)rJ TypeErrorr, r! rj r r- r. itemsr0 r/ r1 r r2 r )r r rw r r r{ rF s r rz zHTTPHeaderDict.extendO s
t99q==T#d))TTT
t99>>Qr e^ , , * !OO - -
#
#Sc""""
#
v~
.
. * !KKMM
#
#Sc""""
#
v
/
/ *K S#X0F GOOE #
%
%
Ue$$$$
%
UF
#
# *}(E(E * zz||
*
*eCj)))) ,,.. ! !JC HHS% ! !r list[str]c d S r r r s r getlistzHTTPHeaderDict.getlistp r r$ list[str] | _DTc d S r r )r r r s r r zHTTPHeaderDict.getlistt r r _Sentinel | _DTc | j | }|dd S # t $ r |t j u rg cY S |cY S w xY w)zmReturns a list of all the values for the named field. Returns an
empty list if the key doesn't exist.r N)r5 r rI r& r' )r r r r s r r zHTTPHeaderDict.getlistx sg
?399;;/D 8O )... NNN s + A A A c t t | j dt | dS )N())r r dictr r s r __repr__zHTTPHeaderDict.__repr__ s4 t**%BBT__->->(?(?BBBBr c x |D ]6}| | }|g|| j | < 7d S r )r r5 r )r r r r{ s r ry zHTTPHeaderDict._copy_from sI 7 7C--$$C,/;#;DOCIIKK ( ( 7 7r c ^ t | }| | |S r )r ry )r clones r copyzHTTPHeaderDict.copy s, T
r rk c # K | D ]:}| j | }|dd D ]}|d |fV ;dS )z8Iterate over all header lines, including duplicate ones.r Nr r )r r r r{ s r rj zHTTPHeaderDict.iteritems sf # #C?399;;/DABBx
#
#1gsl""""
# # #r c # K | D ]H}| j | }|d d |dd fV IdS )z:Iterate over all headers, merging duplicate ones together.r r r Nr r s r r zHTTPHeaderDict.itermerged s_ - -C/#))++.Ca&$))CG,,, , , , , - -r re c t | S r )re r s r r zHTTPHeaderDict.items s %d+++r header_namepotential_valuec ` || v r)|| j | dd v S dS )Nr Fr )r r r s r rq z$HTTPHeaderDict._has_value_for_header s9 $ "dok6G6G6I6I&J122&NN Nur c ` t | }|t S | | | S r )r3 NotImplementedrz )r r r s r __ior__zHTTPHeaderDict.__ior__ s7 DE J J &! ! '((( r c t | }|t S | }| | |S r )r3 r r rz r r r results r __or__zHTTPHeaderDict.__or__ sD DE J J &! !
)***
r c t | }|t S t | | }| | |S r )r3 r r rz r s r __ror__zHTTPHeaderDict.__ror__ sL DE J J &! !d /00
d
r r )rg r* rw r )r r r{ r r r= r )r r r r= )r r) r rm )r )r r r r r r )r r) r rm r_ r )r r r{ r r rm r r= )r r rw r r r= )r r r r )r r r r$ r r )r r r r r r )r r )r r! r r= )r r! ru )r re )r r r r r rm )r r) r r! )&r r r r` ra r@ rO r rQ rt r r r rS rW r r rz r- overloadr r& r'
getheadersgetallmatchingheadersigetget_allr ry r rj r r rq r r r rb rc s @r r! r! s B 6555 2 2 2 2 " " " ") ) ) )
0 0 0 0 0 0 0
& & & &$ $ $ $
:? !! !! !! !! !! !!F ! ! ! !B _ _ _ _ 4=3G & J # D GC C C C7 7 7 7
# # # #- - - - , , , ,
r )r( r) r r* )!
__future__r r- collectionsr enumr r threadingr
TYPE_CHECKINGtyping_extensionsr r
__all__TypeVarr" r# r$ Unionr. r r0 r1 r r& r3 GenericMutableMappingr Setre r! r r r r s4 " " " " " "
# # # # # #
+***** #$4
5 fnUfnUfnU
N38
OFLc*+ (Z/ Z/ Z/ Z/ Z/FN38 4f6KCQTH6U Z/ Z/ Z/z- - - - -VZ S#X(> ? - - -`C C C C CV*384 C C C C Cr