162 lines
11 KiB
Plaintext
162 lines
11 KiB
Plaintext
|
Ë
|
|||
|
|
KÀjx& ã óò — d dl mZ d dlZd dlmZmZmZmZ ddlm Z m
|
|||
|
|
Z
|
|||
|
|
m Z ddl m
|
|||
|
|
Z
|
|||
|
|
mZmZ g d¢Zd d„Zeed eeef f Z ed
|
|||
|
|
e« Z G d „ d e« Z G d
|
|||
|
|
„ de« Z G d„ de« Z ej4 dej6 ej8 z « Z ej4 dej8 « Z ej4 dej8 « Z ddœd d„Z d d„Z!ddœ d!d„Z"ddœ d"d „Z#d#d „Z$y)$é )Ú annotationsN)ÚNewTypeÚTupleÚUnionÚcasté )ÚTagÚUnsortedTagsErrorÚ parse_tag)ÚInvalidVersionÚVersionÚ_TrimmedRelease)
|
|||
|
|
ÚBuildTagÚ InvalidNameÚInvalidSdistFilenameÚInvalidWheelFilenameÚNormalizedNameÚcanonicalize_nameÚcanonicalize_versionÚis_normalized_nameÚparse_sdist_filenameÚparse_wheel_filenamec ó — t S )N)Ú__all__© ó úR/home/antigravity/intellecton/venv/lib/python3.12/site-packages/packaging/utils.pyÚ__dir__r s € Ü €Nr r r c ó — e Zd ZdZy)r zW
|
|||
|
|
An invalid distribution name; users should refer to the packaging user guide.
|
|||
|
|
N©Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__Ú__doc__r r r r r ' ó „ òr r c ó — e Zd ZdZy)r zM
|
|||
|
|
An invalid wheel filename was found, users should refer to PEP 427.
|
|||
|
|
Nr r r r r r - r% r r c ó — e Zd ZdZy)r z^
|
|||
|
|
An invalid sdist filename was found, users should refer to the packaging user guide.
|
|||
|
|
Nr r r r r r 3 r% r r z%[a-z0-9]|[a-z0-9][a-z0-9._-]*[a-z0-9]z+[a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9]z (\d+)(.*)F)Úvalidatec óú — |r#t j | « st d| ›�« ‚| j « j dd« j dd« }d|v r|j dd« }d|v rŒt d|« S )a]
|
|||
|
|
This function takes a valid Python package or extra name, and returns the
|
|||
|
|
normalized form of it.
|
|||
|
|
|
|||
|
|
The return type is typed as :class:`NormalizedName`. This allows type
|
|||
|
|
checkers to help require that a string has passed through this function
|
|||
|
|
before use.
|
|||
|
|
|
|||
|
|
If **validate** is true, then the function will check if **name** is a valid
|
|||
|
|
distribution name before normalizing.
|
|||
|
|
|
|||
|
|
:param str name: The name to normalize.
|
|||
|
|
:param bool validate: Check whether the name is a valid distribution name.
|
|||
|
|
:raises InvalidName: If **validate** is true and the name is not an
|
|||
|
|
acceptable distribution name.
|
|||
|
|
|
|||
|
|
>>> from packaging.utils import canonicalize_name
|
|||
|
|
>>> canonicalize_name("Django")
|
|||
|
|
'django'
|
|||
|
|
>>> canonicalize_name("oslo.concurrency")
|
|||
|
|
'oslo-concurrency'
|
|||
|
|
>>> canonicalize_name("requests")
|
|||
|
|
'requests'
|
|||
|
|
zname is invalid: Ú_ú-ú.z--r )Ú_validate_regexÚ fullmatchr ÚlowerÚreplacer )Únamer( Úvalues r r r B s| € ñ2 œ×1Ñ1°$Ô7ÜÐ -¨d¨XÐ6Ó7Ð7ð
|
|||
|
|
�J‰J‹L× Ñ cÓ *× 2Ñ 2°3¸Ó <€Eà
|
|||
|
|
�%‰-Ø—
|
|||
|
|
‘
|
|||
|
|
˜d CÓ(ˆð �%Š-ä Ð %Ó (Ð(r c ó0 — t j | « duS )a7
|
|||
|
|
Check if a name is already normalized (i.e. :func:`canonicalize_name` would
|
|||
|
|
roundtrip to the same value).
|
|||
|
|
|
|||
|
|
:param str name: The name to check.
|
|||
|
|
|
|||
|
|
>>> from packaging.utils import is_normalized_name
|
|||
|
|
>>> is_normalized_name("requests")
|
|||
|
|
True
|
|||
|
|
>>> is_normalized_name("Django")
|
|||
|
|
False
|
|||
|
|
N)Ú_normalized_regexr. )r1 s r r r g s € ô × &Ñ & tÓ ,°DÐ 8Ð8r T)Ústrip_trailing_zeroc ó¦ — t | t « r t | « } t |rt | « « S | « S # t $ r t | « cY S w xY w)a Return a canonical form of a version as a string.
|
|||
|
|
|
|||
|
|
This function takes a string representing a package version (or a
|
|||
|
|
:class:`~packaging.version.Version` instance), and returns the
|
|||
|
|
normalized form of it. By default, it strips trailing zeros from
|
|||
|
|
the release segment.
|
|||
|
|
|
|||
|
|
>>> from packaging.utils import canonicalize_version
|
|||
|
|
>>> canonicalize_version('1.0.1')
|
|||
|
|
'1.0.1'
|
|||
|
|
|
|||
|
|
Per PEP 625, versions may have multiple canonical forms, differing
|
|||
|
|
only by trailing zeros.
|
|||
|
|
|
|||
|
|
>>> canonicalize_version('1.0.0')
|
|||
|
|
'1'
|
|||
|
|
>>> canonicalize_version('1.0.0', strip_trailing_zero=False)
|
|||
|
|
'1.0.0'
|
|||
|
|
|
|||
|
|
Invalid versions are returned unaltered.
|
|||
|
|
|
|||
|
|
>>> canonicalize_version('foo bar baz')
|
|||
|
|
'foo bar baz'
|
|||
|
|
|
|||
|
|
>>> canonicalize_version('1.4.0.0.0')
|
|||
|
|
'1.4'
|
|||
|
|
)Ú
|
|||
|
|
isinstanceÚstrr
|
|||
|
|
r r )Úversionr5 s r r r w sU € ô< �'œ3Ô ð Ü ˜gÓ&ˆGô Ñ+>Œ˜wÓ'Ó LÐLÀGÓ LÐLøô ò Ü�w“<Ò ð ús ’ 9 ¹AÁA©Úvalidate_orderc óä — | j d« st d| ›�« ‚| dd } | j d« }|dvrt d| ›�« ‚| j d|dz
|
|||
|
|
« }|d }d
|
|||
|
|
|v s%t j
|
|||
|
|
d |t j « €t d | ›�« ‚t |« } t |d
|
|||
|
|
« }|dk( rc|d }t j |« } | €t d|› d| ›�« ‚t dt | j d
|
|||
|
|
« « | j d« f« }
|
|||
|
|
nd}
|
|||
|
|
|d } t | |¬« } |||
|
|||
|
|
| fS # t $ r}t d| ›�« |‚d}~ww xY w# t $ r t d| ›�« d‚w xY w)a
|
|||
|
|
This function takes the filename of a wheel file, and parses it,
|
|||
|
|
returning a tuple of name, version, build number, and tags.
|
|||
|
|
|
|||
|
|
The name part of the tuple is normalized and typed as
|
|||
|
|
:class:`NormalizedName`. The version portion is an instance of
|
|||
|
|
:class:`~packaging.version.Version`. The build number is ``()`` if
|
|||
|
|
there is no build number in the wheel filename, otherwise a
|
|||
|
|
two-item tuple of an integer for the leading digits and
|
|||
|
|
a string for the rest of the build number. The tags portion is a
|
|||
|
|
frozen set of :class:`~packaging.tags.Tag` instances (as the tag
|
|||
|
|
string format allows multiple tags to be combined into a single
|
|||
|
|
string).
|
|||
|
|
|
|||
|
|
If **validate_order** is true, compressed tag set components are
|
|||
|
|
checked to be in sorted order as required by PEP 425.
|
|||
|
|
|
|||
|
|
:param str filename: The name of the wheel file.
|
|||
|
|
:param bool validate_order: Check whether compressed tag set components
|
|||
|
|
are in sorted order.
|
|||
|
|
:raises InvalidWheelFilename: If the filename in question
|
|||
|
|
does not follow the :ref:`wheel specification
|
|||
|
|
<pypug:binary-distribution-format>`.
|
|||
|
|
|
|||
|
|
>>> from packaging.utils import parse_wheel_filename
|
|||
|
|
>>> from packaging.tags import Tag
|
|||
|
|
>>> from packaging.version import Version
|
|||
|
|
>>> name, ver, build, tags = parse_wheel_filename("foo-1.0-py3-none-any.whl")
|
|||
|
|
>>> name
|
|||
|
|
'foo'
|
|||
|
|
>>> ver == Version('1.0')
|
|||
|
|
True
|
|||
|
|
>>> tags == {Tag("py3", "none", "any")}
|
|||
|
|
True
|
|||
|
|
>>> not build
|
|||
|
|
True
|
|||
|
|
|
|||
|
|
.. versionadded:: 26.1
|
|||
|
|
The *validate_order* parameter.
|
|||
|
|
z.whlz3Invalid wheel filename (extension must be '.whl'): Néüÿÿÿr+ )é é z0Invalid wheel filename (wrong number of parts): é r Ú__z ^[\w\d._]*$zInvalid project name: r z*Invalid wheel filename (invalid version): r? zInvalid build number: z in r r éÿÿÿÿr: z\Invalid wheel filename (compressed tag set components must be in sorted order per PEP 425): )Úendswithr ÚcountÚsplitÚreÚmatchÚUNICODEr r
|
|||
|
|
r Ú_build_tag_regexr ÚintÚgroupr r
|
|||
|
|
)
|
|||
|
|
Úfilenamer; ÚdashesÚpartsÚ name_partr1 r9 ÚeÚ
|
|||
|
|
build_partÚ build_matchÚbuildÚtag_strÚtagss
|
|||
|
|
r r r � sÑ € ðZ × Ñ ˜VÔ $Ü"ØAÀ(À Ð Nó
|
|||
|
|
ð
|
|||
|
|
𠘘ˆ}€HØ
|
|||
|
|
�^‰^˜CÓ
|
|||
|
|
€FØ
|
|||
|
|
�VÑÜ"Ø>¸x¸lÐ Kó
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
�N‰N˜3 ¨¡
|
|||
|
|
Ó +€EØ�a‘€Ià ˆyÑœBŸH™H ^°YÄÇ
|
|||
|
|
Á
|
|||
|
|
Ó KÐ SÜ"Ð%;¸H¸<Ð#HÓIÐIÜ ˜YÓ '€Dðܘ% ™(Ó#ˆð �‚{ؘ1‘Xˆ
|
|||
|
|
Ü&×,Ñ,¨ZÓ8ˆ Ø Ð Ü&Ø(¨¨ °D¸¸ ÐEóð
|
|||
|
|
ô �Z¤# k×&7Ñ&7¸Ó&:Ó";¸[×=NÑ=NÈqÓ=QÐ!RÓS‰àˆØ�B‰i€Gðܘ° Ô@ˆð
|
|||
|
|
�'˜5 $Ð 'Ð'øô/ ò Ü"Ø8¸¸ Ð Eó
|
|||
|
|
àð ûðûô$ ò Ü"ð*Ø*2¨ ð
|
|||
|
|
7ó
|
|||
|
|
ð ð ðús$ Â%D6 Ä#
|
|||
|
|
E Ä6 EÄ?EÅEÅE/c ób — | j d« r| dt d« }n/| j d« r| dt d« }nt d| ›�« ‚|j d« \ }}}|st d| ›�« ‚t |« } t |« }||fS # t $ r}t d| ›�« |‚d}~ww xY w)a‘
|
|||
|
|
This function takes the filename of a sdist file (as specified
|
|||
|
|
in the `Source distribution format`_ documentation), and parses
|
|||
|
|
it, returning a tuple of the normalized name and version as
|
|||
|
|
represented by an instance of :class:`~packaging.version.Version`.
|
|||
|
|
|
|||
|
|
:param str filename: The name of the sdist file.
|
|||
|
|
:raises InvalidSdistFilename: If the filename does not end
|
|||
|
|
with an sdist extension (``.zip`` or ``.tar.gz``), or if it does not
|
|||
|
|
contain a dash separating the name and the version of the distribution.
|
|||
|
|
|