Xix&SSKJr SSKrSSKJrJrJrJr SSKJ r J r J r SSK J r JrJr /SQrSSjr\\S \\\44r\"S \5r"S S \5r"S S\5r"SS\5r\R4"S\R6\R8-5r\R4"S\R85r\R4"S\R85rSS.SSjjr S Sjr!SS.S!Sjjr"SS.S"Sjjr#S#Sjr$g)$) annotationsN)NewTypeTupleUnioncast)TagUnsortedTagsError parse_tag)InvalidVersionVersion_TrimmedRelease) BuildTag InvalidNameInvalidSdistFilenameInvalidWheelFilenameNormalizedNamecanonicalize_namecanonicalize_versionis_normalized_nameparse_sdist_filenameparse_wheel_filenamec[$)N)__all__B/var/www/html/venv/lib/python3.13/site-packages/packaging/utils.py__dir__rs Nrrrc\rSrSrSrSrg)r'zO An invalid distribution name; users should refer to the packaging user guide. rN__name__ __module__ __qualname____firstlineno____doc____static_attributes__rrrrr'rrc\rSrSrSrSrg)r-zE An invalid wheel filename was found, users should refer to PEP 427. rNr!rrrrr-r(rrc\rSrSrSrSrg)r3zV An invalid sdist filename was found, users should refer to the packaging user guide. rNr!rrrrr3r(rrz%[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)validatecU(a)[RU5(d[SU<35eUR5R SS5R SS5nSU;aUR SS5nSU;aM[ SU5$)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 fullmatchrlowerreplacer)namer-values rrrBs211$77-dX677 JJL c * 2 23 >> from packaging.utils import is_normalized_name >>> is_normalized_name("requests") True >>> is_normalized_name("Django") False N)_normalized_regexr3)r6s rrrgs  & &t ,D 88rT)strip_trailing_zeroc[U[5(a [U5n[U(a[ U55$U5$![a [U5s$f=f)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' ) isinstancestrr r r)versionr:s rrrwsX<'3 g&G +>w' LLG LL w<  s AAAvalidate_ordercURS5(d[SU<35eUSSnURS5nUS;a[SU<35eURSUS- 5nUS nS U;d'[R "S U[R 5c[S U<35e[U5n[US 5nUS:XaeUSn[R U5n U c[SUSU<35e[S[U RS 55U RS545n OSn USn [XS9n XVX4$![an[SU<35UeSnAff=f![a [SU<35Sef=f)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 `. >>> 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'): Nr0)z0Invalid wheel filename (wrong number of parts): r__z ^[\w\d._]*$zInvalid project name: rz*Invalid wheel filename (invalid version): rDzInvalid build number: z in rrr?z\Invalid wheel filename (compressed tag set components must be in sorted order per PEP 425): )endswithrcountsplitrematchUNICODErr r _build_tag_regexrintgroupr r ) filenamer@dashesparts name_partr6r>e build_part build_matchbuildtag_strtagss rrrsZ   V $ $"A( N  }H ^^C F V">xl K   NN3 +EaI yBHH^Y KS"%;H<#HII Y 'D%(# {1X &,,Z8  &( D E Z#k&7&7&:";[=N=Nq=Q!RSBiG@ 5 ''/ "8 E  $ "**2 7  s$3E4 E# E  EE #E>cURS5(aUS[S5*nO5URS5(aUS[S5*nO[SU<35eURS5up#nU(d[SU<35e[ U5n[ U5nXV4$![ an[SU<35UeSnAff=f)aM 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. >>> 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 .. _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 (invalid version): )rHlenr rpartitionrr r )rQ file_stemrTsep version_partr6r>rUs rrrs,##.I/   6 " "^F |, "|   $-#7#7#< IL "%=h\#JKK Y 'D,' ? "8 E  s B B?*B::B?)returnz list[str])r6r=r-boolrar)r6r=rarb)r>z Version | strr:rbrar=)rQr=r@rbraz8tuple[NormalizedName, Version, BuildTag, frozenset[Tag]])rQr=raztuple[NormalizedName, Version])% __future__rrKtypingrrrrrZr r r r>r r rrrrOr=rr ValueErrorrrrcompile IGNORECASEASCIIr2r9rNrrrrrrrrris5 # ..33==  rE#s(O+ ,)3/ * : :**,bmmbhh.FJJMrxxX::lBHH56;")J 9"<@#M #M48#M#MR!Y(Y(Y(> Y(x/r