Ë
|
Añúh ã óN d Z ddlmZ ddlZddlZddlZddlmZmZm Z m
|
Z
|
m Z ddl m Z ddlmZ e eef Z e
|
de¬ « Zeeegef Zdd
|
Z G d d e« Z G d dej0 ¬« Z G d de« Z ej6 d« Z ddZ ddZ d dZ d dZ G d de« Z!y) z
|
.. testsetup::
|
|
from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
|
from packaging.version import Version
|
é )Ú annotationsN)ÚCallableÚIterableÚIteratorÚTypeVarÚUnioné )Úcanonicalize_version)ÚVersionÚUnparsedVersionVar)Úboundc ó< t | t « s t | « } | S ©N)Ú
|
isinstancer )Úversions úZH:\Change_password\venv_build\Lib\site-packages\setuptools/_vendor/packaging/specifiers.pyÚ_coerce_versionr s Ü gwÔ 'Ü'Ó"Ø Nó c ó e Zd ZdZy)ÚInvalidSpecifiera
|
Raised when attempting to create a :class:`Specifier` with a specifier
|
string that is invalid.
|
|
>>> Specifier("lolwat")
|
Traceback (most recent call last):
|
...
|
packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat'
|
N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__© r r r r s òr r c ó0 e Zd Zej d d« Zej d
|
d« Zej d d« Zeej d d« « Z e j d d« Z ej ddd« Z ej d dd« Z y)Ú BaseSpecifierc ó y)z
|
Returns the str representation of this Specifier-like object. This
|
should be representative of the Specifier itself.
|
Nr ©Úselfs r Ú__str__zBaseSpecifier.__str__- ó r c ó y)zF
|
Returns a hash value for this Specifier-like object.
|
Nr r s r Ú__hash__zBaseSpecifier.__hash__4 r" r c ó y)z«
|
Returns a boolean representing whether or not the two Specifier-like
|
objects are equal.
|
|
:param other: The other object to check against.
|
Nr ©r Úothers r Ú__eq__zBaseSpecifier.__eq__: r" r c ó y)zîWhether or not pre-releases as a whole are allowed.
|
|
This can be set to either ``True`` or ``False`` to explicitly enable or disable
|
prereleases or it can be set to ``None`` (the default) to use default semantics.
|
Nr r s r Ú prereleaseszBaseSpecifier.prereleasesC r" r c ó y)zQSetter for :attr:`prereleases`.
|
|
:param value: The value to set.
|
Nr ©r Úvalues r r* zBaseSpecifier.prereleasesL r" r Nc ó y)zR
|
Determines if the given item is contained within this specifier.
|
Nr )r Úitemr* s r ÚcontainszBaseSpecifier.containsS r" r c ó y)z
|
Takes an iterable of items and filters them so that only items which
|
are contained within this specifier are allowed in it.
|
Nr )r Úiterabler* s r ÚfilterzBaseSpecifier.filterY r" r ©ÚreturnÚstr©r5 Úint©r' Úobjectr5 Úbool©r5 ú bool | None©r- r; r5 ÚNoner )r/ r6 r* r= r5 r; ©r2 z Iterable[UnparsedVersionVar]r* r= r5 z Iterator[UnparsedVersionVar]) r r r ÚabcÚabstractmethodr! r$ r( Úpropertyr* Úsetterr0 r3 r r r r r , sÙ Ø×Ñò ó ð ð ×Ñò ó ð ð
|
×Ñò ó ð ð Ø×Ñò ó ó ð ð ×Ñò ó ð ð ×Ñó ó ð ð
|
×ÑàQUð Ø4ð ØCNð à %ò ó ñ r r )Ú metaclassc ó e Zd ZdZdZdZ ej dez ez dz ej ej z « Z
|
dddd d
|
d d d dZ d&d'dZ e d(d« Zej d)d« Ze d*d« Ze d*d« Zd*dZd*dZe d+d« Zd,dZd-dZd.dZd/dZd/d Zd/d Zd/d Zd/d Z d0d Z d0d!Z d/d"Z d1d#Z d2d3d$Z! d2 d4d%Z"y)5Ú Specifiera? This class abstracts handling of version specifiers.
|
|
.. tip::
|
|
It is generally not required to instantiate this manually. You should instead
|
prefer to work with :class:`SpecifierSet` instead, which can parse
|
comma-separated version specifiers (which is what package metadata contains).
|
z8
|
(?P<operator>(~=|==|!=|<=|>=|<|>|===))
|
aÈ
|
(?P<version>
|
(?:
|
# The identity operators allow for an escape hatch that will
|
# do an exact string match of the version you wish to install.
|
# This will not be parsed by PEP 440 and we cannot determine
|
# any semantic meaning from it. This operator is discouraged
|
# but included entirely as an escape hatch.
|
(?<====) # Only match for the identity operator
|
\s*
|
[^\s;)]* # The arbitrary version can be just about anything,
|
# we match everything except for whitespace, a
|
# semi-colon for marker support, and a closing paren
|
# since versions can be enclosed in them.
|
)
|
|
|
(?:
|
# The (non)equality operators allow for wild card and local
|
# versions to be specified so we have to define these two
|
# operators separately to enable that.
|
(?<===|!=) # Only match for equals and not equals
|
|
\s*
|
v?
|
(?:[0-9]+!)? # epoch
|
[0-9]+(?:\.[0-9]+)* # release
|
|
# You cannot use a wild card and a pre-release, post-release, a dev or
|
# local version together so group them with a | and make them optional.
|
(?:
|
\.\* # Wild card syntax of .*
|
|
|
(?: # pre release
|
[-_\.]?
|
(alpha|beta|preview|pre|a|b|c|rc)
|
[-_\.]?
|
[0-9]*
|
)?
|
(?: # post release
|
(?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
|
)?
|
(?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release
|
(?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
|
)?
|
)
|
|
|
(?:
|
# The compatible operator requires at least two digits in the
|
# release segment.
|
(?<=~=) # Only match for the compatible operator
|
|
\s*
|
v?
|
(?:[0-9]+!)? # epoch
|
[0-9]+(?:\.[0-9]+)+ # release (We have a + instead of a *)
|
(?: # pre release
|
[-_\.]?
|
(alpha|beta|preview|pre|a|b|c|rc)
|
[-_\.]?
|
[0-9]*
|
)?
|
(?: # post release
|
(?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
|
)?
|
(?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release
|
)
|
|
|
(?:
|
# All other operators only allow a sub set of what the
|
# (non)equality operators do. Specifically they do not allow
|
# local versions to be specified nor do they allow the prefix
|
# matching wild cards.
|
(?<!==|!=|~=) # We have special cases for these
|
# operators so we want to make sure they
|
# don't match here.
|
|
\s*
|
v?
|
(?:[0-9]+!)? # epoch
|
[0-9]+(?:\.[0-9]+)* # release
|
(?: # pre release
|
[-_\.]?
|
(alpha|beta|preview|pre|a|b|c|rc)
|
[-_\.]?
|
[0-9]*
|
)?
|
(?: # post release
|
(?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
|
)?
|
(?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release
|
)
|
)
|
z^\s*z\s*$Ú
|
compatibleÚequalÚ not_equalÚless_than_equalÚgreater_than_equalÚ less_thanÚ greater_thanÚ arbitrary)ú~=ú==z!=ú<=ú>=ú<ú>ú===Nc óî | j j |« }|st d|« |j d« j « |j d« j « f| _ || _ y)að Initialize a Specifier instance.
|
|
:param spec:
|
The string representation of a specifier which will be parsed and
|
normalized before use.
|
:param prereleases:
|
This tells the specifier if it should accept prerelease versions if
|
applicable or not. The default of ``None`` will autodetect it from the
|
given specifiers.
|
:raises InvalidSpecifier:
|
If the given specifier is invalid (i.e. bad syntax).
|
zInvalid specifier: Úoperatorr N)Ú_regexÚsearchr ÚgroupÚstripÚ_specÚ _prereleases)r Úspecr* Úmatchs r Ú__init__zSpecifier.__init__Þ sm ð ×"Ñ" 4Ó(ÙÜ"Ð%8¸¸Ð#AÓBÐ Bð KK
|
Ó #× )Ñ )Ó +Ø KK Ó "× (Ñ (Ó *ð'
|
|
ð (Õr c ó¼ | j | j S | j \ }}|dv r1|dk( r|j d« r|d d }t |« j ryy)N)rQ rS rR rP rV rU rT rQ ú.*éþÿÿÿTF)r^ r] Úendswithr Ú is_prerelease)r rX r s r r* zSpecifier.prereleasesø sm ð × Ñ Ð (Ø×$Ñ$Ð $ð
|
!JJÑ'Ø Ð@Ñ @ð 4Ò G×$4Ñ$4°TÔ$:Ø! # 2,ô wÓ ×-Ò-Øàr c ó || _ y r ©r^ r, s r r* zSpecifier.prereleases ó
|
à !Õr c ó | j d S )z`The operator of this specifier.
|
|
>>> Specifier("==1.2.3").operator
|
'=='
|
r ©r] r s r rX zSpecifier.operator ó ð zz!}Ð r c ó | j d S )zaThe version of this specifier.
|
|
>>> Specifier("==1.2.3").version
|
'1.2.3'
|
r rk r s r r zSpecifier.version rl r c ó | j d| j nd}d| j j dt | « | dS )aT A representation of the Specifier that shows all internal state.
|
|
>>> Specifier('>=1.0.0')
|
<Specifier('>=1.0.0')>
|
>>> Specifier('>=1.0.0', prereleases=False)
|
<Specifier('>=1.0.0', prereleases=False)>
|
>>> Specifier('>=1.0.0', prereleases=True)
|
<Specifier('>=1.0.0', prereleases=True)>
|
ú, prereleases=Ú rT ú(ú)>)r^ r* Ú __class__r r6 ©r Úpres r Ú__repr__zSpecifier.__repr__& sU ð × Ñ Ð,ð T× -Ñ -Ð 0Ñ 1àð ð 4>>×*Ñ*Ð+¨1¬S°«Y¨M¸#¸¸bÐAÐAr c ó4 dj | j S )zÐA string representation of the Specifier that can be round-tripped.
|
|
>>> str(Specifier('>=1.0.0'))
|
'>=1.0.0'
|
>>> str(Specifier('>=1.0.0', prereleases=False))
|
'>=1.0.0'
|
z{}{})Úformatr] r s r r! zSpecifier.__str__8 s ð v}}djjÐ)Ð)r c óx t | j d | j d dk7 ¬« }| j d |fS )Nr r rP ©Ústrip_trailing_zero)r
|
r] )r Úcanonical_versions r Ú_canonical_speczSpecifier._canonical_specB s> ä 0Ø JJqMØ!%§¡¨A¡ °$Ñ!6ô
|
Ðð zz!}Ð /Ð/Ð/r c ó, t | j « S r )Úhashr} r s r r$ zSpecifier.__hash__J s ÜD×(Ñ(Ó)Ð)r c óî t |t « r | j t |« « }n t || j « st S | j
|
|j
|
k( S # t $ r t cY S w xY w)a> Whether or not the two Specifier-like objects are equal.
|
|
:param other: The other object to check against.
|
|
The value of :attr:`prereleases` is ignored.
|
|
>>> Specifier("==1.2.3") == Specifier("== 1.2.3.0")
|
True
|
>>> (Specifier("==1.2.3", prereleases=False) ==
|
... Specifier("==1.2.3", prereleases=True))
|
True
|
>>> Specifier("==1.2.3") == "==1.2.3"
|
True
|
>>> Specifier("==1.2.3") == Specifier("==1.2.4")
|
False
|
>>> Specifier("==1.2.3") == Specifier("~=1.2.3")
|
False
|
)r r6 rs r ÚNotImplementedr} r& s r r( zSpecifier.__eq__M si ô& eSÔ !ð &Ø ¤s¨5£zÓ2ô E 4§>¡>Ô2Ü!Ð !à×#Ñ# u×'<Ñ'<Ñ<Ð<øô $ò &Ü%Ò%ð &ús A" Á"A4Á3A4c ó> t | d| j | « }|S )NÚ _compare_)ÚgetattrÚ
|
_operators)r ÚopÚoperator_callables r Ú _get_operatorzSpecifier._get_operatorj s+ Ü.5Ø Idoo¨bÑ 1Ð 2Ð3ó/
|
Ðð !Ð r c
|
óà t t t j t t |« « « d d « }|dz } | j d« ||« xr | j d« ||« S )Néÿÿÿÿrc rS rQ )Ú _version_joinÚlistÚ itertoolsÚ takewhileÚ_is_not_suffixÚ_version_splitr )r Ú prospectiver_ Úprefixs r Ú_compare_compatiblez Specifier._compare_compatiblep sw ô Ü ×$Ñ$¤^´^ÀDÓ5IÓJÓ KÈCÈRÐ Pó
|
ð
|
$à't×!Ñ! $Ó'¨ °TÓ:ò
|
Ð?W¸t×?QÑ?QÐRVÓ?WØ ó@
|
ð
|
r c óD |j d« r_t |j d¬« }t |d d d¬« }t |« }t |« }t ||« \ }}|d t |« } | |k( S t |« }
|
|
|
j st |j « }||
|
k( S )Nrc Frz rd )re r
|
Úpublicr Ú _pad_versionÚlenr Úlocal) r r r_ Únormalized_prospectiveÚnormalized_specÚ
|
split_specÚsplit_prospectiveÚpadded_prospectiveÚ_Úshortened_prospectiveÚ spec_versions r Ú_compare_equalzSpecifier._compare_equal s¸ à ==Ô ä%9Ø×"Ñ"¸ô&Ð "ô 3°4¸¸°9ÐRWÔ XOô (¨Ó8Jô
|
!/Ð/EÓ FÐ ô %1Ð1BÀJÓ$OÑ !Ð ð
|
%7Ð7H¼¸Z» Ð$IÐ !à(¨JÑ6Ð 6ô # 4=Lð
|
×%Ò%Ü % k×&8Ñ&8Ó 9 à ,Ñ.Ð .r c ó( | j ||« S r )r¡ ©r r r_ s r Ú_compare_not_equalz Specifier._compare_not_equal¬ s Ø×&Ñ& {°DÓ9Ð9Ð9r c óD t |j « t |« k S r ©r r r£ s r Ú_compare_less_than_equalz"Specifier._compare_less_than_equal¯ ó ô {×)Ñ)Ó*¬g°d«mÑ;Ð;r c óD t |j « t |« k\ S r r¦ r£ s r Ú_compare_greater_than_equalz%Specifier._compare_greater_than_equalµ r¨ r c ó® t |« }||k sy|j s8|j r,t |j « t |j « k( ryy©NFT)r rf Ú base_version©r r Úspec_strr_ s r Ú_compare_less_thanz Specifier._compare_less_than» sT ô xÓ ð
|
TÒ!Øð ×!Ò! k×&?Ò&?Ü{×/Ñ/Ó0´G¸D×<MÑ<MÓ4NÒNØ ð
|
r c ó t |« }||kD sy|j s8|j r,t |j « t |j « k( ry|j ,t |j « t |j « k( ryyr¬ )r Úis_postreleaser r r® s r Ú_compare_greater_thanz Specifier._compare_greater_thanÓ s ô xÓ ð
|
TÒ!Øð ×"Ò" {×'AÒ'AÜ{×/Ñ/Ó0´G¸D×<MÑ<MÓ4NÒNØ ð × Ñ Ð (Ü{×/Ñ/Ó0´G¸D×<MÑ<MÓ4NÒNØ ð
|
r c óh t |« j « t |« j « k( S r )r6 Úlowerr£ s r Ú_compare_arbitraryz Specifier._compare_arbitraryñ s& Ü;Ó ×%Ñ%Ó'¬3¨t«9¯?©?Ó+<Ñ<Ð<r c ó$ | j |« S )a; Return whether or not the item is contained in this specifier.
|
|
:param item: The item to check for.
|
|
This is used for the ``in`` operator and behaves the same as
|
:meth:`contains` with no ``prereleases`` argument passed.
|
|
>>> "1.2.3" in Specifier(">=1.2.3")
|
True
|
>>> Version("1.2.3") in Specifier(">=1.2.3")
|
True
|
>>> "1.0.0" in Specifier(">=1.2.3")
|
False
|
>>> "1.3.0a1" in Specifier(">=1.2.3")
|
False
|
>>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True)
|
True
|
©r0 ©r r/ s r Ú __contains__zSpecifier.__contains__ô ó ð& }}TÓ"Ð"r c ó® | | j }t |« }|j r|sy| j | j « } ||| j
|
« S )al Return whether or not the item is contained in this specifier.
|
|
:param item:
|
The item to check for, which can be a version string or a
|
:class:`Version` instance.
|
:param prereleases:
|
Whether or not to match prereleases with this Specifier. If set to
|
``None`` (the default), it uses :attr:`prereleases` to determine
|
whether or not prereleases are allowed.
|
|
>>> Specifier(">=1.2.3").contains("1.2.3")
|
True
|
>>> Specifier(">=1.2.3").contains(Version("1.2.3"))
|
True
|
>>> Specifier(">=1.2.3").contains("1.0.0")
|
False
|
>>> Specifier(">=1.2.3").contains("1.3.0a1")
|
False
|
>>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1")
|
True
|
>>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True)
|
True
|
F)r* r rf r rX r )r r/ r* Únormalized_itemr s r r0 zSpecifier.contains sY ð4 Ð Ø ×*Ñ*Kô *¨$Ó/ð
|
× (Ò (±Øð /3×.@Ñ.@ÀÇ Á Ó.OÐÙ °$·,±,Ó?Ð?r c # óö K d}g }d||ndi}|D ]S }t |« } | j |fi |¤s"|j r |s | j s|j |« Nd}| U |s|r |D ] }| yyyw)aO Filter items in the given iterable, that match the specifier.
|
|
:param iterable:
|
An iterable that can contain version strings and :class:`Version` instances.
|
The items in the iterable will be filtered according to the specifier.
|
:param prereleases:
|
Whether or not to allow prereleases in the returned iterator. If set to
|
``None`` (the default), it will be intelligently decide whether to allow
|
prereleases or not (based on the :attr:`prereleases` attribute, and
|
whether the only versions matching are prereleases).
|
|
This method is smarter than just ``filter(Specifier().contains, [...])``
|
because it implements the rule from :pep:`440` that a prerelease item
|
SHOULD be accepted if no other versions match the given specifier.
|
|
>>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"]))
|
['1.3']
|
>>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")]))
|
['1.2.3', '1.3', <Version('1.4')>]
|
>>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"]))
|
['1.5a1']
|
>>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True))
|
['1.3', '1.5a1']
|
>>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"]))
|
['1.3', '1.5a1']
|
Fr* NT)r r0 rf r* Úappend)r r2 r* ÚyieldedÚfound_prereleasesÚkwr Úparsed_versions r r3 zSpecifier.filter5 s¥ è ø ð< Ø Ðà¨KÐ,C[ÈÐ Nð ò "GÜ ,¨WÓ 5Nà t}}^Ñ2¨rÓ2ð "×/Ò/Ù 4×#3Ò#3à%×,Ñ,¨WÕ5ð #GØ!Mð "ñ( Ñ,Ø,ò Ø ñ ð -wùs 0A9³AA9©rp N)r_ r6 r* r= r5 r? )r5 r; r> r4 )r5 ztuple[str, str]r7 r9 )r r6 r5 ÚCallableOperator)r r r_ r6 r5 r; )r r r¯ r6 r5 r; )r/ z str | Versionr5 r; r )r/ ÚUnparsedVersionr* r= r5 r; r@ )#r r r r Ú_operator_regex_strÚ_version_regex_strÚreÚcompileÚVERBOSEÚ
|
IGNORECASErY r
ra rC r* rD rX r rv r! r} r$ r( r r r¡ r¤ r§ rª r° r³ r¶ rº r0 r3 r r r rG rG c sR ñð Ðð\ Ðð| RZZØÐ%Ñ%Ð(:Ñ:¸WÑDØ
|
|
|
R]]Ñ"óFð ØØØ Ø"Ø Ø Øñ Jô(ð4 òó ðð. ×Ñò"ó ð"ð ò ó ð ð ò ó ð óBó$*ð ò0ó ð0ó*ó=ó:!ó
|
ó(&/óP:ó<ó <ó ó0 ó<=ó#ô**@ðZ RVð; Ø4ð; ØCNð; à %ô; r rG z ^([0-9]+)((?:a|b|c|rc)[0-9]+)$c ó g }| j d« \ }}}|j |xs d« |j d« D ]J }t j |« }|r |j |j « « :|j |« L |S )a Split version into components.
|
|
The split components are intended for version comparison. The logic does
|
not attempt to retain the original version string, so joining the
|
components back with :func:`_version_join` may not produce the original
|
version string.
|
ú!Ú0ú.)Ú
|
rpartitionr¿ ÚsplitÚ _prefix_regexrZ ÚextendÚgroups)r ÚresultÚepochr Úrestr/ r` s r r r v s~ ð Fà ×'Ñ'¨Ó,NE1dØ
|
MM%,3Ô à
|
|
3ò Ü ×$Ñ$ TÓ*Ù Ø MM%,,.Õ )à MM$Õ ð ð Mr c ó6 | ^}}| ddj |« S )zñJoin split version components into a version string.
|
|
This function assumes the input came from :func:`_version_split`, where the
|
first component must be the epoch (either empty or numeric), and all other
|
components numeric.
|
rÎ rÐ )Újoin)Ú
|
componentsr× rØ s r r r s' ð LEDØWAchhtnÐ%Ð &Ð&r c ó. t fddD « « S )Nc 3 ó@ K | ] }j |« y wr )Ú
|
startswith)Ú.0r Úsegments r ú <genexpr>z!_is_not_suffix.<locals>.<genexpr> s! øè ø ò Ø'-×Ñ6×"ñùs )ÚdevÚaÚbÚrcÚpost)Úany)rà s `r r r s" ø Üó Ø1Pôó ð ð r c óÒ g g }}|j t t j d | « « « |j t t j d |« « « |j | t |d « d « |j |t |d « d « |j ddgt dt |d « t |d « z
|
« z « |j ddgt dt |d « t |d « z
|
« z « t t j j |« « t t j j |« « fS )Nc ó" | j « S r ©Úisdigit©Úxs r ú<lambda>z _pad_version.<locals>.<lambda>¡ s ¸¿¹» r c ó" | j « S r rê rì s r rî z _pad_version.<locals>.<lambda>¢ s ¸!¿)¹)»+ r r r rÏ ) r¿ r r r r ÚinsertÚmaxÚchainÚ from_iterable)ÚleftÚrightÚ
|
left_splitÚ right_splits r r r s5 Ø " Jð ×Ñd9×.Ñ.Ñ/DÀdÓKÓLÔMØ×ÑtI× /Ñ /Ñ0EÀuÓ MÓNÔOð ×Ñd3z¨!}Ó-Ð/Ð0Ô1Ø×ÑuS ¨Q¡ Ó 0Ð 2Ð3Ô4ð ×Ña#¤ Q¬¨K¸©NÓ(;¼cÀ*ÈQÁ-Ó>PÑ(PÓ!QÑQÔRØ×Ñq3%¤# a¬¨Z¸©]Ó);¼cÀ+ÈaÁ.Ó>QÑ)QÓ"RÑRÔSô Y__× *Ñ *¨:Ó 6Ó7Ü Y__× *Ñ *¨;Ó 7Ó8ð ð r c óÒ e Zd ZdZ d ddZedd« Zej dd« ZddZddZ ddZ
|
dd Z dd
|
Z dd Z dd Zdd Z d ddZ d d dZy) Ú SpecifierSetzÌThis class abstracts handling of a set of version specifiers.
|
|
It can be passed a single specifier (``>=3.0``), a comma-separated list of
|
specifiers (``>=3.0,!=3.1``), or no specifier at all.
|
Nc ó" t |t « rc|j d« D cg c]# }|j « s|j « % }}t t t |« « | _ || _ yt |« | _ || _ yc c}w )a´ Initialize a SpecifierSet instance.
|
|
:param specifiers:
|
The string representation of a specifier or a comma-separated list of
|
specifiers which will be parsed and normalized before use.
|
May also be an iterable of ``Specifier`` instances, which will be used
|
as is.
|
:param prereleases:
|
This tells the SpecifierSet if it should accept prerelease versions if
|
applicable or not. The default of ``None`` will autodetect it from the
|
given specifiers.
|
|
:raises InvalidSpecifier:
|
If the given ``specifiers`` are not parseable than this exception will be
|
raised.
|
ú,N) r r6 rÒ r\ Ú frozensetÚmaprG Ú_specsr^ )r Ú
|
specifiersr* ÚsÚsplit_specifierss r ra zSpecifierSet.__init__¹ s{ ô, j¤#Ô &ð 4>×3CÑ3CÀCÓ3HÖ V¨aÈAÏGÉGÍI §¡¥ Ð VÐ Ð Vô $¤C¬ Ð3CÓ$DÓEDKð (Õô $ JÓ/DKð (Õùò Ws
|
¤B ºB c ó | j | j S | j sy t d | j D « « S )Nc 3 ó4 K | ] }|j y wr ©r* ©rß r s r rá z+SpecifierSet.prereleases.<locals>.<genexpr>î s è ø Ò6 Q1==Ñ6ùs )r^ rþ rç r s r r* zSpecifierSet.prereleasesß s? ð × Ñ Ð (Ø×$Ñ$Ð $ð
|
{{Øô Ñ6¨$¯+©+Ô6Ó6Ð6r c ó || _ y r rh r, s r r* zSpecifierSet.prereleasesð ri r c ó^ | j d| j nd}dt | « | dS )a A representation of the specifier set that shows all internal state.
|
|
Note that the ordering of the individual specifiers within the set may not
|
match the input string.
|
|
>>> SpecifierSet('>=1.0.0,!=2.0.0')
|
<SpecifierSet('!=2.0.0,>=1.0.0')>
|
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False)
|
<SpecifierSet('!=2.0.0,>=1.0.0', prereleases=False)>
|
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True)
|
<SpecifierSet('!=2.0.0,>=1.0.0', prereleases=True)>
|
ro rp z<SpecifierSet(rr )r^ r* r6 rt s r rv zSpecifierSet.__repr__ô sD ð × Ñ Ð,ð T× -Ñ -Ð 0Ñ 1àð ð ¤ D£ }¨S¨E°Ð4Ð4r c óX dj t d | j D « « « S )an A string representation of the specifier set that can be round-tripped.
|
|
Note that the ordering of the individual specifiers within the set may not
|
match the input string.
|
|
>>> str(SpecifierSet(">=1.0.0,!=1.0.1"))
|
'!=1.0.1,>=1.0.0'
|
>>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False))
|
'!=1.0.1,>=1.0.0'
|
rû c 3 ó2 K | ] }t |« y wr )r6 r s r rá z'SpecifierSet.__str__.<locals>.<genexpr> s è ø Ò ;¨!s 1vÑ ;ùs )rÚ Úsortedrþ r s r r! zSpecifierSet.__str__ s" ð xxÑ ;¨t¯{©{Ô ;Ó;Ó<Ð<r c ó, t | j « S r )r rþ r s r r$ zSpecifierSet.__hash__ s ÜDKKÓ Ð r c óâ t |t « r t |« }nt |t « st S t « }t | j
|
|j
|
z « |_ | j |j |j |_ |S | j |j | j |_ |S | j |j k( r| j |_ |S t d« )a Return a SpecifierSet which is a combination of the two sets.
|
|
:param other: The other object to combine with.
|
|
>>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1'
|
<SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')>
|
>>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1')
|
<SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')>
|
zFCannot combine SpecifierSets with True and False prerelease overrides.)r r6 rù r rü rþ r^ Ú
|
ValueError)r r' Ú specifiers r Ú__and__zSpecifierSet.__and__ så ô eSÔ !Ü Ó'EÜE¤<Ô0Ü!Ð !ä N Ü$ T§[¡[°5·<±<Ñ%?Ó@ Ôà × Ñ Ð $¨×);Ñ);Ð)GØ%*×%7Ñ%7IÔ "ð Ðð × Ñ Ð *¨u×/AÑ/AÐ/IØ%)×%6Ñ%6IÔ "ð Ðð × Ñ %×"4Ñ"4Ò 4Ø%)×%6Ñ%6IÔ "ð Ðô ð óð r c ó¶ t |t t f« rt t |« « }nt |t « st S | j
|
|j
|
k( S )a¡ Whether or not the two SpecifierSet-like objects are equal.
|
|
:param other: The other object to check against.
|
|
The value of :attr:`prereleases` is ignored.
|
|
>>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1")
|
True
|
>>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) ==
|
... SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True))
|
True
|
>>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1"
|
True
|
>>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0")
|
False
|
>>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2")
|
False
|
)r r6 rG rù r rþ r& s r r( zSpecifierSet.__eq__9 sD ô& ec¤9Ð -Ô .Ü ¤ U£Ó,EÜE¤<Ô0Ü!Ð !à{{ellÑ*Ð*r c ó, t | j « S )z7Returns the number of specifiers in this specifier set.)r rþ r s r Ú__len__zSpecifierSet.__len__S s ä4;;Ó Ð r c ó, t | j « S )zð
|
Returns an iterator over all the underlying :class:`Specifier` instances
|
in this specifier set.
|
|
>>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str)
|
[<Specifier('!=1.0.1')>, <Specifier('>=1.0.0')>]
|
)Úiterrþ r s r Ú__iter__zSpecifierSet.__iter__W s ô DKKÓ Ð r c ó$ | j |« S )ar Return whether or not the item is contained in this specifier.
|
|
:param item: The item to check for.
|
|
This is used for the ``in`` operator and behaves the same as
|
:meth:`contains` with no ``prereleases`` argument passed.
|
|
>>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1")
|
True
|
>>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1")
|
True
|
>>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1")
|
False
|
>>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1")
|
False
|
>>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)
|
True
|
r¸ r¹ s r rº zSpecifierSet.__contains__a r» r c óú t t « s t « | j s j ry|r!j rt j « t fd| j D « « S )a´ Return whether or not the item is contained in this SpecifierSet.
|
|
:param item:
|
The item to check for, which can be a version string or a
|
:class:`Version` instance.
|
:param prereleases:
|
Whether or not to match prereleases with this SpecifierSet. If set to
|
``None`` (the default), it uses :attr:`prereleases` to determine
|
whether or not prereleases are allowed.
|
|
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3")
|
True
|
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3"))
|
True
|
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1")
|
False
|
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1")
|
False
|
>>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1")
|
True
|
>>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True)
|
True
|
Fc 3 óD K | ] }|j ¬ « yw)r Nr¸ )rß r r/ r* s r rá z(SpecifierSet.contains.<locals>.<genexpr> s øè ø ÒRÀ1::d° :×<ÑRùs )r r r* rf r Úallrþ )r r/ r* Ú installeds `` r r0 zSpecifierSet.containsv sm ù ô< $¤Ô(Ü4=Dð
|
Ð Ø ×*Ñ*Kñ t× 1Ò 1Øá ×+Ò+Ü4×,Ñ,Ó-Dô ÔRÀdÇkÁkÔRÓRÐRr c ór | | j }| j r8| j D ] }|j |t |« ¬« } t |« S g }g }|D ]A }t |« }|j r|s|r |j |« 1|j |« C |s|r | t |« S t |« S )a. Filter items in the given iterable, that match the specifiers in this set.
|
|
:param iterable:
|
An iterable that can contain version strings and :class:`Version` instances.
|
The items in the iterable will be filtered according to the specifier.
|
:param prereleases:
|
Whether or not to allow prereleases in the returned iterator. If set to
|
``None`` (the default), it will be intelligently decide whether to allow
|
prereleases or not (based on the :attr:`prereleases` attribute, and
|
whether the only versions matching are prereleases).
|
|
This method is smarter than just ``filter(SpecifierSet(...).contains, [...])``
|
because it implements the rule from :pep:`440` that a prerelease item
|
SHOULD be accepted if no other versions match the given specifier.
|
|
>>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"]))
|
['1.3']
|
>>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")]))
|
['1.3', <Version('1.4')>]
|
>>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"]))
|
[]
|
>>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True))
|
['1.3', '1.5a1']
|
>>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"]))
|
['1.3', '1.5a1']
|
|
An "empty" SpecifierSet will filter items based on the presence of prerelease
|
versions in the set.
|
|
>>> list(SpecifierSet("").filter(["1.3", "1.5a1"]))
|
['1.3']
|
>>> list(SpecifierSet("").filter(["1.5a1"]))
|
['1.5a1']
|
>>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"]))
|
['1.3', '1.5a1']
|
>>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True))
|
['1.3', '1.5a1']
|
r )r* rþ r3 r; r r rf r¿ )r r2 r* r_ ÚfilteredrÁ r/ rà s r r3 zSpecifierSet.filter¯ sÈ ðX Ð Ø ×*Ñ*Kð
|
;;Ø ò PØ ;; x¼TÀ+Ó=N;ÓOð Pä>Ð !ð
|
24HØ:<Ð à ò *Ü!0°Ó!6ð "×/Ò/¹ Ú#Ø)×0Ñ0°Õ6à OO DÕ)ð *ñ Ñ 1°kÐ6IÜÐ -Ó.Ð.ä>Ð !r rÄ )rÿ zstr | Iterable[Specifier]r* r= r5 r? r< r> r4 r7 )r' zSpecifierSet | strr5 rù r9 )r5 zIterator[Specifier])r/ rÆ r5 r; )NN)r/ rÆ r* r= r r= r5 r; r r@ )r r r r ra rC r* rD rv r! r$ r r( r r rº r0 r3 r r r rù rù ² sé ñð 13Ø#'ð$(à-ð$(ð !ð$(ð
|
ó $(ðL ò7ó ð7ð ×Ñò"ó ð"ó5ó* =ó!ó ó@+ó4 ó!ó#ð0 $(Ø!%ð 7Sà ð7Sð !ð7Sð ð 7Sð
|
|
ó 7Sðt RVðM"Ø4ðM"ØCNðM"à %ôM"r rù )r rÆ r5 r )r r6 r5 ú list[str])rÛ r r5 r6 )rà r6 r5 r; )rô r rõ r r5 ztuple[list[str], list[str]])"r Ú
|
__future__r rA r rÉ Útypingr r r r r Úutilsr
|
r r r6 rÆ r r; rÅ r r r ÚABCMetar rG rÊ rÓ r r r r rù r r r ú<module>r" sº ðñõ #ã
|
Û Û ß ?Õ ?å 'Ý à Ñ%Ù Ð 1¸ ÔIÐ ØW cN¨DÐ 0Ñ1Ð óô zô ô4 ckkõ 4 ônM ô M ð`
|
|
Ð<Ó= óó,'óó ô*J"=õ J"r
|
