Skip to content

PackageName#

PackageName #

normalized property #

normalized

Returns the normalized version of the package name. The normalized string is guaranteed to be a valid conda package name.

Examples#
>>> p = PackageName("test-xyz")
>>> p.normalized
'test-xyz'
>>>

source property #

source

Returns the source representation of the package name. This is the string from which this instance was created.

Examples#
>>> p = PackageName("test-xyz")
>>> p.source
'test-xyz'
>>>

__eq__ #

__eq__(other)

Returns True if this instance represents the same PackageName as other.

Examples#
>>> PackageName("test-abc") == PackageName("abc-test")
False
>>> PackageName("test-abc") == PackageName("test-abc")
True
>>> PackageName("test-abc") == PackageName("test-ABC")
True
>>> PackageName("test-abc") == "test-abc"
True
>>> PackageName("test-abc") == "not-test-abc"
False
>>>

__hash__ #

__hash__()

Computes the hash of this instance.

Examples#
>>> hash(PackageName("test-abc")) == hash(PackageName("test-abc"))
True
>>> hash(PackageName("test-abc")) == hash(PackageName("test-ABC"))
True
>>> hash(PackageName("test-abc")) == hash(PackageName("abc-test"))
False
>>>

__ne__ #

__ne__(other)

Returns True if this instance does not represents the same PackageName as other.

Examples#
>>> PackageName("test-abc") != PackageName("test-abc")
False
>>> PackageName("test-abc") != PackageName("test-ABC")
False
>>> PackageName("test-abc") != PackageName("abc-test")
True
>>> PackageName("test-abc") != "test-abc"
False
>>> PackageName("test-abc") != "not-test-abc"
True
>>>

__repr__ #

__repr__()

Returns a representation of the PackageName.

Examples#
>>> p = PackageName("test-xyz")
>>> p
PackageName("test-xyz")
>>>

from_matchspec_str staticmethod #

from_matchspec_str(spec)

Parses the package name part from a matchspec string without parsing the entire matchspec.

This extracts the package name by splitting on whitespace or version constraint characters (>, <, =, !, ~, ;).

Examples#
>>> p = PackageName.from_matchspec_str("numpy>=1.0,<2.0")
>>> p.source
'numpy'
>>> p = PackageName.from_matchspec_str("pillow >=10")
>>> p.source
'pillow'
>>>

from_matchspec_str_unchecked staticmethod #

from_matchspec_str_unchecked(spec)

Parses the package name part from a matchspec string without parsing the entire matchspec. This function assumes the matchspec string is a valid matchspec.

This extracts the package name by splitting on whitespace or version constraint characters (>, <, =, !, ~, ;). The original capitalization is preserved in the source, while the normalized version is lowercase.

Examples#
>>> p = PackageName.from_matchspec_str_unchecked("Pillow >=10")
>>> p.source
'Pillow'
>>> p.normalized
'pillow'
>>>

unchecked staticmethod #

unchecked(normalized)

Constructs a new PackageName from a string without checking if the string is actually a valid or normalized conda package name. This should only be used if you are sure that the input string is valid.

Examples#
>>> p = PackageName.unchecked("test_xyz")
>>>