+ ,j*^RIHt^RIHtHt^RIHt^RIHt^RI H t ]'d ^RI H t ^RI Ht!RR 4tR #) ) annotations) TYPE_CHECKINGOptional)Channel)PackageNameMatcher) PyMatchSpec)NamelessMatchSpec) PackageRecordc]tRt^tRtR*RRllt]RRl4t]RRl4t]RR l4t ]R R l4t ]R R l4t ]RRl4t ]RRl4t ]RRl4t]RRl4t]RRl4t]RRl4t]RRl4t]RRl4tRRlt]R R!l4t]R"R#l4tR$R%ltR&R'ltR(tR)#)+ MatchSpeca A `MatchSpec` is a query language for conda packages. It can be composed of any of the attributes of `PackageRecord`. `MatchSpec` can be composed of keyword arguments, where keys are any of the attributes of `PackageRecord`. Values for keyword arguments are exact values the attributes should match against. Many fields can be matched against non-exact values by including wildcard `*` and `>`/`<` ranges where supported. Any non-specified field is the equivalent of a full wildcard match. MatchSpecs can also be composed using a single positional argument, with optional keyword arguments. Keyword arguments also override any conflicting information provided in the positional argument. Conda has historically had several string representations for equivalent MatchSpecs. A series of rules are now followed for creating the canonical string representation of a MatchSpec instance. The canonical string representation can generically be represented by: `(channel(/subdir):(namespace):)name(version(build))[key1=value1,key2=value2]` where `()` indicate optional fields. The rules for constructing a canonical string representation are: 1. `name` (i.e. "package name") is required. Its position is always outside the key-value brackets. It can also be a glob pattern or a regex if `exact_names_only` is `False`. 2. If `version` is an exact version, it goes outside the key-value brackets and is prepended by `==`. If `version` is a "fuzzy" value (e.g. `1.11.*`), it goes outside the key-value brackets with the `.*` left off and is prepended by `=`. Otherwise `version` is included inside key-value brackets. 3. If `version` is an exact version, and `build` is an exact value, `build` goes outside key-value brackets prepended by a `=`. Otherwise, `build` goes inside key-value brackets. `build_string` is an alias for `build`. 4. The `namespace` position is being held for a future feature. It is currently ignored. 5. If `channel` is included and is an exact value, a `::` separator is used between `channel` and `name`. `channel` can either be a canonical channel name or a channel url. In the canonical string representation, the canonical channel name will always be used. 6. If `channel` is an exact value and `subdir` is an exact value, `subdir` is appended to `channel` with a `/` separator. Otherwise, `subdir` is included in the key-value brackets. 7. Key-value brackets can be delimited by comma, space, or comma+space. Value can optionally be wrapped in single or double quotes, but must be wrapped if `value` contains a comma, space, or equal sign. The canonical format uses comma delimiters and single quotes. 8. When constructing a `MatchSpec` instance from a string, any key-value pair given inside the key-value brackets overrides any matching parameter given outside the brackets. When `MatchSpec` attribute values are simple strings, the are interpreted using the following conventions: - If the string begins with `^` and ends with `$`, it is converted to a regex. - If the string contains an asterisk (`*`), it is transformed from a glob to a regex. - Otherwise, an exact match to the string is sought. To fully-specify a package with a full, exact spec, the following fields must be given as exact values: - channel - subdir - name - version - build c4V^8dQhRRRRRRRRRRRRR R /#) specstrstrictboolexact_names_onlyextras conditionalsflagsreturnNone)formats"=lib/python3.14/site-packages/rattler/match_spec/match_spec.py __annotate__MatchSpec.__annotate__TsP.... .  .  .. .c \V\4'd\VVVVVV4VnR#\ R\ V4P : R24h)aw Create a new version spec. When `strict` is `True`, some ambiguous version specs are rejected. When `extras` is `True`, extras syntax (`pkg[extras=[foo,bar]]`) is allowed. When `conditionals` is `True`, conditionals syntax (`pkg[when="python >=3.6"]`) is allowed. When `flags` is `True`, flags syntax (`pkg[flags=[cuda]]`) is allowed. ```python >>> MatchSpec("pip >=24.0") MatchSpec("pip >=24.0") >>> MatchSpec("pip 24") MatchSpec("pip ==24") >>> MatchSpec("python[license=MIT]") MatchSpec("python[license="MIT"]") >>> MatchSpec("foo*", strict=True, exact_names_only=False) MatchSpec("foo*") >>> MatchSpec("^foo.*$", strict=True, exact_names_only=True) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): InvalidMatchSpecError: "^foo.*$" looks like a regex but only exact package names are allowed, package names can only contain 0-9, a-z, A-Z, -, _, or . >>> ``` z0MatchSpec constructor received unsupported type z for the 'spec' parameterN) isinstancerr _match_spec TypeErrortype__name__)selfrrrrrrs&&&&&&&r__init__MatchSpec.__init__TsXD dC *   D B4:CVCVBYYrs rcV^8dQhRR/#)rrrr)rs"rrrsWW(Wrc V\P!VPP4#)z The name of the package. )r_from_py_package_name_matcherr!namer%s&rr+MatchSpec.names! "??@P@P@U@UVVrcV^8dQhRR/#rrz Optional[str]r)rs"rrrs(((rc .VPP#)zD The version spec of the package (e.g. `1.2.3`, `>=1.2.3`, `1.2.*`) )r!versionr,s&rr1MatchSpec.versions '''rcV^8dQhRR/#r/r)rs"rrrs&&}&rc .VPP#)zJ The build string of the package (e.g. `py37_0`, `py37h6de7cb9_0`, `py*`) )r!buildr,s&rr5MatchSpec.builds %%%rcV^8dQhRR/#r/r)rs"rrrs--m-rc .VPP#)z" The build number of the package. )r! build_numberr,s&rr9MatchSpec.build_numbers ,,,rcV^8dQhRR/#r/r)rs"rrr**=*rc .VPP#)z- Match the specific filename of the package. )r! file_namer,s&rr>MatchSpec.file_name )))rcV^8dQhRR/#)rrzOptional[Channel]r)rs"rrrs==*=rc nVPPpT;'d\P!V4#)z The channel of the package. )r!channelr_from_py_channel)r%rCs& rrCMatchSpec.channels. ""**<<733G<>> from rattler import NamelessMatchSpec >>> spec = NamelessMatchSpec('3.4') >>> MatchSpec.from_nameless(spec, "foo") MatchSpec("foo ==3.4") >>> MatchSpec.from_nameless(spec, "$foo") # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): exceptions.PackageNameMatcherParseError >>> ``` )rer from_nameless_nameless_match_spec)rcrr+s&&&rroMatchSpec.from_namelesss)&&&{'@'@AZAZ\`'abbrc V^8dQhRRRR/#)rurlrrr r)rs"rrrsBB3B9Brc LVP\P!V44#)a Constructs a MatchSpec from a URL. Examples -------- ```python >>> MatchSpec.from_url('https://repo.anaconda.com/pkgs/main/linux-64/python-3.9.0-h3.tar.bz2') MatchSpec("python[url="https://repo.anaconda.com/pkgs/main/linux-64/python-3.9.0-h3.tar.bz2"]") >>> MatchSpec.from_url('https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2#d7c89558ba9fa0495403155b64376d81') MatchSpec("_libgcc_mutex[md5="d7c89558ba9fa0495403155b64376d81", url="https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2"]") >>> MatchSpec.from_url('https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2#sha256:adfa71f158cbd872a36394c56c3568e6034aa55c623634b37a4836bd036e6b91') MatchSpec("_libgcc_mutex[sha256="adfa71f158cbd872a36394c56c3568e6034aa55c623634b37a4836bd036e6b91", url="https://conda.anaconda.org/conda-forge/linux-64/_libgcc_mutex-0.1-conda_forge.tar.bz2"]") >>> ``` )rerfrom_url)rcrss&&rruMatchSpec.from_urls "&&{';';C'@AArcV^8dQhRR/#rrrr)rs"rrrs)))rc 6VPP4#)z Returns a string representation of the MatchSpec. Examples -------- ```python >>> from rattler import NamelessMatchSpec >>> spec = NamelessMatchSpec('3.4') >>> str(MatchSpec.from_nameless(spec, "foo")) 'foo ==3.4' >>> ``` r!as_strr,s&r__str__MatchSpec.__str__s&&((rcV^8dQhRR/#rxr)rs"rrrs;;#;rc >RVPP4 R2#)z Returns a representation of the MatchSpec. Examples -------- ```python >>> from rattler import NamelessMatchSpec >>> spec = NamelessMatchSpec('3.4') >>> MatchSpec.from_nameless(spec, "foo") MatchSpec("foo ==3.4") >>> ``` z MatchSpec("z")rzr,s&r__repr__MatchSpec.__repr__s#T--4467r::r)r!N)FTTTT)r$ __module__ __qualname____firstlineno____doc__r&propertyr+r1r5r9r>rCrHrMrrTrYr] classmethodrerjrorur|r__static_attributes__rrrr r sUCJ.`WW (( && -- ** =='' ** '' ** $$ '' 8cc(BB$) ;;rr N) __future__rtypingrrrattler.channel.channelr$rattler.package.package_name_matcherrrattler.rattlerrrattler.match_specr rattler.repo_datar r rrrrs)"*+C'4/_;_;r