j/ddlmZddlZddlmZmZmZddlmZm Z m Z m Z ddl m Z mZmZgdZd,d Zeed eeeffZ ed eZ Gd deZGddeZGddeZejdejejzZejdejZejdejZ ejdej!Z"ddd-dZ#d.dZ$dd d/d$Z%dd%d0d)Z&d1d+Z'dS)2) annotationsN)NewTypeUnioncast) InvalidTagTagUnsortedTagsError parse_tag)InvalidVersionVersion_TrimmedRelease) BuildTag InvalidNameInvalidSdistFilenameInvalidWheelFilenameNormalizedNamecanonicalize_namecanonicalize_versionis_normalized_nameparse_sdist_filenameparse_wheel_filenamereturn list[str]ctS)N)__all__N/var/www/html/python-test/venv/lib/python3.11/site-packages/packaging/utils.py__dir__r s NrrrceZdZdZdS)rzs An invalid distribution name; users should refer to the packaging user guide. .. versionadded:: 23.2 N__name__ __module__ __qualname____doc__rrrrr.rrceZdZdZdS)rzi An invalid wheel filename was found, users should refer to PEP 427. .. versionadded:: 20.9 Nr"rrrrr6r'rrceZdZdZdS)rzz An invalid sdist filename was found, users should refer to the packaging user guide. .. versionadded:: 20.9 Nr"rrrrr>r'rrz%[a-z0-9]|[a-z0-9][a-z0-9._-]*[a-z0-9]z[a-z0-9]+(?:-[a-z0-9]+)*z (\d+)(.*)z ^[\w._]+\ZF)validatenamestrr*boolc2|r,t|std||dddd}d|vr|dd}d|vt 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' .. versionadded:: 16.2 .. versionchanged:: 20.4 The return type was changed to :class:`NormalizedName`. .. versionchanged:: 23.2 Added the *validate* keyword parameter. zname is invalid: _-.z--r)_validate_regex fullmatchrlowerreplacer)r+r*values rrrRsB811$7786d66777 JJLL c * * 2 23 < >> from packaging.utils import canonicalize_name, is_normalized_name >>> is_normalized_name("requests") True >>> is_normalized_name("Django") False >>> canonicalize_name("_not_legal") '-not-legal' >>> is_normalized_name("-not-legal") # roundtrips, but not a valid name False .. versionadded:: 23.2 N)_normalized_regexr3)r+s rrrs0  & &t , ,D 88rT)strip_trailing_zeroversion Version | strr9ct|tr0 t|}n#t$rt|cYSwxYwt|rt |n|S)aReturn 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' .. versionadded:: 17.1 .. versionchanged:: 21.0 The return type was narrowed to :class:`str`. .. versionchanged:: 22.0 Added the *strip_trailing_zero* keyword parameter. ) isinstancer,r r r)r:r9s rrrsyL'3  g&&GG   w<<    +>Kw'''G L LLs'AAvalidate_orderfilenamer?8tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]c|dstd||dd}|d}|dvrtd||d|dz }|d }d |vst|td |t |} t|d }n%#t$r}td ||d}~wwxYw|dkr|d}t|} | td|d|tdt| d | df} nd} |d} t| |} n=#t$rtd|dt$rtd|dwxYw||| | fS)am 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 `. >>> 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:: 20.9 .. versionchanged:: 23.2 Raises :class:`InvalidWheelFilename` when the version component is invalid. .. versionadded:: 26.1 The *validate_order* parameter. .. versionchanged:: 26.3 Raises :class:`InvalidWheelFilename` when an interpreter component is not an identifier, a tag set component is empty, or the project name is empty. z.whlz3Invalid wheel filename (extension must be '.whl'): Nr0)z0Invalid wheel filename (wrong number of parts): r__zInvalid project name: rz*Invalid wheel filename (invalid version): rEzInvalid build number: z in rrr>z\Invalid wheel filename (compressed tag set components must be in sorted order per PEP 425): z0Invalid wheel filename (invalid tag component): )endswithrcountsplit_wheel_name_regexmatchrr r _build_tag_regexrintgroupr r r) r@r?dashesparts name_partr+r:e build_part build_matchbuildtag_strtagss rrrszn   V $ $ " N( N N   }H ^^C F V" Kx K K    NN3 + +EaI y-33I>>F"#HH#H#HIII Y ' 'D%(## " E E E    {{1X &,,Z88  &EEEEE Z#k&7&7&:&:";";[=N=Nq=Q=Q!RSSBiG @@@ " 7*2 7 7    " Kx K K    '5$ ''s$>C C6C11C6 F:Gtuple[NormalizedName, Version]c|dr|dtd }n@|dr|dtd }ntd||d\}}}|std||std|t |} t |}n%#t $r}td||d}~wwxYw||fS) a5 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``), if it does not contain a dash separating the name and the version of the distribution, if the project name is empty, or if the version portion is not a valid version. >>> from packaging.utils import parse_sdist_filename >>> from packaging.version import Version >>> name, ver = parse_sdist_filename("foo-1.0.tar.gz") >>> name 'foo' >>> ver == Version('1.0') True .. versionadded:: 20.9 .. versionchanged:: 21.0 Added support for ``.zip`` source distributions. .. versionchanged:: 23.2 Raises :class:`InvalidSdistFilename` when the version component is invalid. .. versionchanged:: 26.3 Raises :class:`InvalidSdistFilename` on an empty project name. .. _Source distribution format: https://packaging.python.org/specifications/source-distribution-format/#source-distribution-file-name z.tar.gzNz.zipz@Invalid sdist filename (extension must be '.tar.gz' or '.zip'): r0zInvalid sdist filename: z-Invalid sdist filename (empty project name): z*Invalid sdist filename (invalid version): )rIlenr rpartitionrr r )r@ file_stemrSsep version_partr+r:rTs rrr2sVF## .I./   6 " " ^F |^, "      $-#7#7#<#< IsL L"#Jh#J#JKKK  " HH H H    Y ' 'D,'' " E E E    '?sC C2C--C2)rr)r+r,r*r-rr)r+r,rr-)r:r;r9r-rr,)r@r,r?r-rrA)r@r,rrZ)( __future__rretypingrrrrYrr r r r:r r rrr tuplerOr,rr ValueErrorrrrcompile IGNORECASEASCIIr2r8rNUNICODErLrrrrrrrrrjs{ #""""" ''''''''''????????????==========    rE#s(O+ , )3//*::"*,bmbh.FBJ:BHEE2:lBH55BJ}bj996;*)*)*)*)*)*)Z99998<@+M+M+M+M+M+Mb!g(g(g(g(g(g(T@@@@@@r