_i& d Z ddlZddlZddlZddlmZmZmZmZm Z m
Z
m Z m Z m
Z
ddlmZ ddlmZ e
eef Z e de Zeeegef Zd ed
efd Z G d d
e Z G d dej4 Z G d de Z ej: d Z d ed
ee fdZ ded
efdZ dee dee d
e ee ee f fdZ! G d de Z"y) z
.. testsetup::
from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
from packaging.version import Version
N) CallableIterableIteratorListOptionalSetTupleTypeVarUnion )canonicalize_version)VersionUnparsedVersionVar)boundversionreturnc < t | t s t | } | S N)
isinstancer )r s /builddir/build/BUILDROOT/alt-python312-setuptools-69.0.2-3.el8.x86_64/opt/alt/python312/lib/python3.12/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 x e Zd Zej defd Zej defd Zej de de
fd Z e ej de
e
fd Zej de
ddfd Zej dd
ed e
e
de
fd Zej dd
ee d e
e
dee fd Zy)
BaseSpecifierr c 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__5 r c y)zF
Returns a hash value for this Specifier-like object.
Nr r# s r __hash__zBaseSpecifier.__hash__< r& r otherc 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$ r) s r __eq__zBaseSpecifier.__eq__B r& r c y)zWhether 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.prereleasesK r& r valueNc y)zQSetter for :attr:`prereleases`.
:param value: The value to set.
Nr r$ r/ s r r. zBaseSpecifier.prereleasesT r& r itemr. c y)zR
Determines if the given item is contained within this specifier.
Nr )r$ r2 r. s r containszBaseSpecifier.contains[ r& r iterablec 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$ r5 r. s r filterzBaseSpecifier.filtera r& r r )r r r abcabstractmethodstrr% intr( objectboolr, propertyr r. setterr4 r r r r7 r r r r! r! 4 s7 #
F t Xd^ $ S x~
TX !34 CKD> $ % r r! ) metaclassc e Zd ZdZdZdZ ej dez ez dz ej ej z Z
dddd d
d d d
dZ d0de de
e ddfdZedefd Zej$ deddfd Zede fd Zede fd Zde fdZde fdZedee e f fd Zdefd Zd edefd Z d e de fd Z d!e de defd"Z d!e de defd#Z!d!e de defd$Z"d!e de defd%Z#d!e de defd&Z$d!e d'e defd(Z%d!e d'e defd)Z&d!e de defd*Z'd+e(e e f defd,Z) d1d+e*de
e defd-Z+ d1d.e,e- de
e de.e- fd/Z/y)2 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(~=|==|!=|<=|>=|<|>|===))
a
(?P
(?:
# 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.
(?=<>===Nspecr. r c | j j | }|st d| 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)_regexsearchr groupstrip_spec _prereleases)r$ rR r. matchs r __init__zSpecifier.__init__ so ""4("%9$q#AB B
KK
# ) ) + KK " ( ( *'
(r c | j | j S | j \ }}|dv r1|dk( r|j d r|d d }t | j ryy)N)rL rN rM rK rQ rL .*TF)r[ rZ endswithr
is_prerelease)r$ rU r s r r. zSpecifier.prereleases sm ($$ $
!JJ' 6 6 4 G$4$4T$:!#2, w --r r/ c || _ y r r[ r1 s r r. zSpecifier.prereleases
!r c | j d S )z`The operator of this specifier.
>>> Specifier("==1.2.3").operator
'=='
r rZ r# s r rU zSpecifier.operator zz!} r c | j d S )zaThe version of this specifier.
>>> Specifier("==1.2.3").version
'1.2.3'
r rg r# s r r zSpecifier.version% rh 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')
=1.0.0')>
>>> Specifier('>=1.0.0', prereleases=False)
=1.0.0', prereleases=False)>
>>> Specifier('>=1.0.0', prereleases=True)
=1.0.0', prereleases=True)>
, prereleases= rO ()>)r[ r. __class__r r: r$ pres r __repr__zSpecifier.__repr__. sU , T - - 0 1 4>>**+1SYM#bAAr c 4 dj | j S )zA 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{}{})formatrZ r# s r r% zSpecifier.__str__@ s v}}djj))r c x t | j d | j d dk7 }| j d |fS )Nr r rK strip_trailing_zero)r
rZ )r$ canonical_versions r _canonical_speczSpecifier._canonical_specJ s> 0 JJqM!%A $!6
zz!} ///r c , t | j S r )hashry r# s r r( zSpecifier.__hash__R s D(())r 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 r: ro r NotImplementedry r+ s r r, zSpecifier.__eq__U si & eS !
& s5z2 E4>>2! !##u'<'<<< $
&%%
&s A" "A43A4opc > t | d| j | }|S )N _compare_)getattr
_operators)r$ r~ operator_callables r
_get_operatorzSpecifier._get_operatorr s+ .5 Idoob 1 23/
! r prospectivec
dj t t j t t | d d }|dz
} | j
d || xr | j
d || S )N.r_ rN rL )joinlist itertools takewhile_is_not_suffix_version_splitr )r$ r rR prefixs r _compare_compatiblez Specifier._compare_compatiblex s{ $$^^D5IJ KCR P
$'t!!$' T:
?Wt?Q?QRV?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 )Nr_ Frv r` )ra r
publicr _pad_versionlenr local) r$ r rR normalized_prospectivenormalized_spec
split_specsplit_prospectivepadded_prospective_shortened_prospective spec_versions r _compare_equalzSpecifier._compare_equal s == %9""& " 349RW XO (8J
!//E F %11BJ$O !
%77HZ $I !(J6 6 #4=L
%% %k&8&8 9 ,. .r c ( | j || S r )r r$ r rR s r _compare_not_equalz Specifier._compare_not_equal s &&{D999r c D t |j t | k S r r r r s r _compare_less_than_equalz"Specifier._compare_less_than_equal
{))*gdm;;r c D t |j t | k\ S r r r s r _compare_greater_than_equalz%Specifier._compare_greater_than_equal r r spec_strc t | }||k sy|j s8|j r,t |j t |j k( ryyNFT)r rb base_versionr$ r r rR s r _compare_less_thanz Specifier._compare_less_than sT x
T! !!k&?&?{//0GD>> "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
r4 r$ r2 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 rb r rU r )r$ r2 r. normalized_itemr s r r4 zSpecifier.contains sY 8 **K *$/
( ( /3.@.@ .O $,,??r r5 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', ]
>>> 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 r4 rb r. append)r$ r5 r. yieldedfound_prereleaseskwr parsed_versions r r7 zSpecifier.filterE s < K,C[
N G ,W 5N t}}^2r2 "// 4#3#3%,,W5 #G!M ( ,,
- -ws 0A9AA9rl Nr )0r r r r _operator_regex_str_version_regex_strrecompileVERBOSE
IGNORECASErV r r: r r= r] r> r. r? rU r rr r% r ry r; r( r< r, CallableOperatorr r r r r r r r r r r r UnparsedVersionr4 r r r r7 r r r rB rB k s \ | RZZ%%(::WD
R]]"F "
J(S (HTN (d (4 T . " "$ " " # B# B$* * 0sCx 0 0*# *=F =t =:! !(8 !
w
c
d
*'/' '/ '/ '/R:g :S :T :=g =S =T =#sG|!4 # #, DH,@#,@2:4.,@
,@^ UY; !34; CKD>; $ %; r rB z ^([0-9]+)((?:a|b|c|rc)[0-9]+)$c g }| j d D ]J }t j | }|r |j |j :|j | L |S )Nr )split
_prefix_regexrW extendgroupsr )r resultr2 r\ s r r r sR F
c" $$T* MM%,,. ) MM$ # Mr segmentc . t fddD S )Nc 3 @ K | ] }j | y wr )
startswith).0r r s r z!_is_not_suffix.. s! 1Pv6"1Ps )devabrcpost)any)r s `r r r s" 1P r leftrightc 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 | t t j | fS )Nc " | j S r isdigitxs r z _pad_version.. s
r c " | j S r r r s r r z _pad_version.. s
!))+r r r 0)r r r r r insertmaxchain)r r
left_split right_splits r r r s" " J d9../DdKLMtI / /0Eu MNO d3z!}-/01uSQ 0 234 a#QKN(;c*Q->P(P!QQRq3%#aZ]);c+a.>Q)Q"RRS *- .Y__k5R0S TTr c H e Zd ZdZ ddedee ddfdZedee fd Z e j deddfd Z defd
Z defd Z de
fd Zd
ed ef dd fdZd
edefdZde
fdZdee fdZdedefdZ ddedee dee defdZ ddee dee dee fdZ y) SpecifierSetzThis 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.
N
specifiersr. r c |j d D cg c]# }|j s|j % }}t }|D ] }|j t | t | | _ || _ yc c}w )aN 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.
: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 rY setaddrB frozenset_specsr[ )r$ r r. ssplit_specifiersparsed specifiers r r] zSpecifierSet.__init__ sv ( 0:/?/?/DR/D! AGGI/DR "%)I JJy+ , * ' ( Ss
BBc | 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.. s 6+Q1==+s )r[ r r r# s r r. zSpecifierSet.prereleases s? ($$ $
{{ 6$++666r r/ c || _ y r rd r1 s r r. zSpecifierSet.prereleases re 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')
=1.0.0')>
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False)
=1.0.0', prereleases=False)>
>>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True)
=1.0.0', prereleases=True)>
rk rl z>> 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 )r: r s r r z'SpecifierSet.__str__.. s ;{!s1v{s )r sortedr r# s r r% zSpecifierSet.__str__ s" xx ;t{{ ;;<>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1'
=1.0.0')>
>>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1')
=1.0.0')>
zFCannot combine SpecifierSets with True and False prerelease overrides.)r r: r r} r r r[
ValueError)r$ r) r s r __and__zSpecifierSet.__and__
s eS ! 'EE<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 r: rB r r} r r+ s r r, zSpecifierSet.__eq__- sD & ec9 - . U,EE<0! !{{ell**r c , t | j S )z7Returns the number of specifiers in this specifier set.)r r r# s r __len__zSpecifierSet.__len__G 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)
[, =1.0.0')>]
)iterr r# s r __iter__zSpecifierSet.__iter__K s DKK r r2 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__U r r installedc 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 r2 r. s r r z(SpecifierSet.contains.. s Rk1::d :>> 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', ]
>>> 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 r7 r= r
r rb r )r$ r5 r. rR filteredr r2 r s r r7 zSpecifierSet.filter s X **K
;; ;;xT+=N;O $> !
24H:< !0!6 "// #)006 OOD) ! 1k6I -..> !r r )NNr ) r r r r r: r r= r] r> r. r? rr r% r; r( r r r< r, r r rB r r r r4 r r r7 r r r r r su CG!( !(19$ !(
!(F 7Xd^ 7 7 " "$ " "5# 5* = =!# ! U>3#6 7 N @+F +t +4 !(9- !# #T #0 '+$( 7S 7S d^7S D> 7S
7St UYM" !34M"CKD>M" $ %M"r r )#r r8 r r typingr r r r r r r r
r utilsr
r r r: r r r= r r r r ABCMetar! rB r r r r r r r r r r s
( % 1 I WcND 01 _ z 4 ckk 4 nU
U p
<=
C DI C D UtCy Uc UuT#YS =Q7R U$G"= G"r