+ ,jJ>N^RIHt^RIHtHtHtHt^RIHtH t !RR4t R#)) annotations)ListOptionalTupleUnion) PyVersionInvalidVersionErrorc]tRt^t$RtR]R&RRlt]RRl4t] RR l4t R R lt R R lt RRlt RRltRRltRRltRRltRRlt] RRl4tRRltRRltR R!lt] R"R#l4tR$R%ltR&R'ltRDR(R)lltR*R+lt] R,R-l4tR.R/ltR0R1ltR2R3ltR4R5lt R6R7lt!R8R9lt"R:R;lt#R<R=lt$R>R?lt%R@RAlt&RBt'RC#)EVersiona This class implements an order relation between version strings. Version strings can contain the usual alphanumeric characters (A-Za-z0-9), separated into segments by dots and underscores. Empty segments (i.e. two consecutive dots, a leading/trailing underscore) are not permitted. An optional epoch number - an integer followed by '!' - can precede the actual version string (this is useful to indicate a change in the versioning scheme itself). Version comparison is case-insensitive. r_versionc V^8dQhRRRR/#)versionstrreturnNone)formats"7lib/python3.14/site-packages/rattler/version/version.py __annotate__Version.__annotate__sc \V\4'd\V4VnR#\ R\ V4P : R24h)z/Version constructor received unsupported type z for the `version` parameterN) isinstancerrr TypeErrortype__name__)selfrs&&r__init__Version.__init__s@ gs # #%g.DMA$w-BXBXA[[wx rc V^8dQhRRRR/#)r py_versionrrr r)rs"rrrs)rc 4VPV4pWnV#)z4Construct Rattler version from FFI PyVersion object.)__new__r )clsr"rs&& r_from_py_versionVersion._from_py_versions++c"%rcV^8dQhRR/#)rrz Optional[str]r)rs"rrr&s % %} %rc 6VPP4#)z Gets the epoch of the version or `None` if the epoch was not defined. Examples -------- ```python >>> v = Version('2!1.0') >>> v.epoch 2 >>> ``` )r epochrs&rr* Version.epoch%s}}""$$rcV^8dQhRR/#rrr r)rs"rrr5DDGDrc \\PVPP44#)z Returns a new version where the major segment of this version has been bumped. Examples -------- ```python >>> v = Version('1.0') >>> v.bump_major() Version("2.0") >>> v = Version('9d') >>> v.bump_major() Version("10a") >>> ``` )r r&r bump_majorr+s&rr1Version.bump_major5""'' (@(@(BCCrcV^8dQhRR/#r.r)rs"rrrHr/rc \\PVPP44#)z Returns a new version where the minor segment of this version has been bumped. Examples -------- ```python >>> v = Version('1.0') >>> v.bump_minor() Version("1.1") >>> >>> Version("1").bump_minor() Version("1.1") >>> ``` )r r&r bump_minorr+s&rr6Version.bump_minorHr3rcV^8dQhRR/#r.r)rs"rrr[sDDGDrc \\PVPP44#)a& Returns a new version where the patch segment of this version has been bumped. Examples -------- ```python >>> v = Version('1.0.5') >>> v.bump_patch() Version("1.0.6") >>> v = Version('1.1.1e') >>> v.bump_patch() Version("1.1.2a") >>> >>> Version("1.5").bump_patch() Version("1.5.1") >>> ``` )r r&r bump_patchr+s&rr:Version.bump_patch[s"('' (@(@(BCCrcV^8dQhRR/#r.r)rs"rrrqsCC7Crc \\PVPP44#)z Returns a new version where the last segment of this version has been bumped. Examples -------- ```python >>> v = Version('1.0') >>> v.bump_last() Version("1.1") >>> ``` )r r&r bump_lastr+s&rr>Version.bump_lastqs"'' (?(?(ABBrc V^8dQhRRRR/#)rindexintrr r)rs"rrrsKK#K'Krc ^\PVPPV44#)a{ Returns a new version where the last segment of this version has been bumped. Examples -------- ```python >>> v = Version('1.0') >>> v.bump_segment(index=1) Version("1.1") >>> >>> Version("1.5").bump_segment(-5) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): exceptions.VersionBumpError >>> Version("1.5").bump_segment(5) Version("1.5.0.0.0.1") >>> ``` )r r&r bump_segment)rrAs&&rrDVersion.bump_segments$('' (B(B5(IJJrcV^8dQhRR/#r.r)rs"rrrsDDGDrc \\PVPP44#)aB Returns a new version where the last segment of this version has been bumped with an alpha character. If the last segment contains a character, nothing is added. Examples -------- ```python >>> v = Version('1.0') >>> v.with_alpha() Version("1.0.0a0") >>> v = Version('1.0.f') >>> v.with_alpha() Version("1.0.f") >>> ``` )r r&r with_alphar+s&rrHVersion.with_alphas"$'' (@(@(BCCrcV^8dQhRR/#r.r)rs"rrrsFFgFrc \\PVPP44#)a1 Returns a new version where the local segment of the version has been removed. Leaves the version unchanged if it does not have a local segment. Examples -------- ```python >>> v = Version('1.0+3.4') >>> v.remove_local() Version("1.0") >>> v = Version('1.0') >>> v.remove_local() Version("1.0") >>> ``` )r r&r remove_localr+s&rrLVersion.remove_locals""'' (B(B(DEErc V^8dQhRRRR/#)rlengthrBrr r)rs"rrrsPPsPwPrc ^\PVPPV44#)a Returns a new version that is extended with `0s` to the specified length. Examples -------- ```python >>> v = Version('1') >>> v.extend_to_length(3) Version("1.0.0") >>> v = Version('4!1.2+3.4') >>> v.extend_to_length(4) Version("4!1.2.0.0+3.4") >>> ``` )r r&r extend_to_length)rrOs&&rrQVersion.extend_to_lengths$ '' (F(Fv(NOOrcV^8dQhRR/#rrboolr)rs"rrrs))4)rc 6VPP4#)a  Returns true if this version has a local segment defined. The local part of a version is the part behind the (optional) `+`. Examples -------- ```python >>> v = Version('1.0+3.2-alpha0') >>> v.has_local True >>> v2 = Version('1.0') >>> v2.has_local False >>> ``` )r has_localr+s&rrWVersion.has_locals$}}&&((rcV^8dQhRR/#rrzList[List[Union[str, int]]]r)rs"rrrs((5(rc 6VPP4#)z Returns a list of segments of the version. It does not contain the local segment of the version. Examples -------- ```python >>> v = Version("1.2dev.3-alpha4.5+6.8") >>> v.segments() [[1], [2, 'dev'], [3], [0, 'alpha', 4], [5]] >>> ``` )r segmentsr+s&rr\Version.segmentss}}%%''rcV^8dQhRR/#rZr)rs"rrrs.. ;.rc 6VPP4#)z Returns a list of local segments of the version. It does not contain the non-local segment of the version. Examples -------- ```python >>> v = Version("1.2dev.3-alpha4.5+6.8") >>> v.local_segments() [[6], [8]] >>> ``` )r local_segmentsr+s&rr`Version.local_segmentss}}++--rcV^8dQhRR/#)rrzOptional[Tuple[int, int]]r)rs"rrrs.. 9.rc 6VPP4#)z Returns the major and minor segments from the version. Requires a minimum of 2 segments in version to be split into major and minor, returns `None` otherwise. Examples -------- ```python >>> v = Version('1.0') >>> v.as_major_minor() (1, 0) >>> ``` )r as_major_minorr+s&rrdVersion.as_major_minors}}++--rcV^8dQhRR/#rTr)rs"rrrs&&&rc 6VPP4#)z Returns true if the version contains a component name "dev", dev versions are sorted before non-dev version. Examples -------- ```python >>> v = Version('1.0.1dev') >>> v.is_dev True >>> v_non_dev = Version('1.0.1') >>> v_non_dev >= v True >>> ``` )r is_devr+s&rrhVersion.is_devs$}}##%%rc V^8dQhRRRR/#rotherr rrUr)rs"rrr)s999T9rc LVPPVP4#)z Checks if the version and local segment start same as other version. Examples -------- ```python >>> v1 = Version('1.0.1') >>> v2 = Version('1.0') >>> v1.starts_with(v2) True >>> ``` )r starts_withrrls&&rrnVersion.starts_with)s}}((88rc V^8dQhRRRR/#rkr)rs"rrr:s==W==rc LVPPVP4#)a Checks if this version is compatible with other version. Minor versions changes are compatible with older versions, major version changes are breaking and will not be compatible. Examples -------- ```python >>> v1 = Version('1.0') >>> v2 = Version('1.2') >>> v_major = Version('2.0') >>> v1.compatible_with(v2) False >>> v2.compatible_with(v1) True >>> v_major.compatible_with(v2) False >>> v2.compatible_with(v_major) False >>> ``` )r compatible_withros&&rrsVersion.compatible_with:s.}},,U^^<>> v = Version('2!1.0.1') >>> v.pop_segments() # `n` defaults to 1 if left empty Version("2!1.0") >>> v.pop_segments(2) # old version is still usable Version("2!1") >>> v.pop_segments(3) # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): exceptions.InvalidVersionError: new Version must have atleast 1 valid segment >>> ``` z-new Version must have atleast 1 valid segment)r pop_segmentsr&r )rrvnew_py_versions&& rrxVersion.pop_segmentsSs8*33A6 ((8 8%&UV Vrc$V^8dQhRRRRRR/#)rstartrBstoprr r)rs"rrrns&HH3HcHgHrc VPPW4pV'dVPV4#\R4h)a Returns new version with with segments ranging from `start` to `stop`. `stop` is exclusive. Raises `InvalidVersionError` if the provided range is invalid. Examples -------- ```python >>> v = Version('2!1.2.3') >>> v.with_segments(0, 2) Version("2!1.2") >>> ``` zInvalid segment range provided)r with_segmentsr&r )rr|r}rys&&& rrVersion.with_segmentsns844UA ((8 8%&FG GrcV^8dQhRR/#rrrBr)rs"rrrs--s-rc 6VPP4#)z Returns the number of segments in the version. This does not include epoch or local segment of the version Examples -------- ```python >>> v = Version('2!1.2.3') >>> v.segment_count 3 >>> ``` )r segment_countr+s&rrVersion.segment_counts}}**,,rcV^8dQhRR/#r.r)rs"rrrs B BW Brc TVPVPP44#)z Returns a new version with local segment stripped. Examples -------- ```python >>> v = Version('1.2.3+4.alpha-5') >>> v.strip_local() Version("1.2.3") >>> ``` )r&r strip_localr+s&rrVersion.strip_locals"$$T]]%>%>%@AArcV^8dQhRR/#rrrr)rs"rrrs & & &rc 6VPP4#)zy Returns the string representation of the version Examples -------- ```python >>> str(Version("1.2.3")) '1.2.3' >>> ``` r as_strr+s&r__str__Version.__str__s}}##%%rcV^8dQhRR/#rr)rs"rrrs 6 6# 6rc >RVPP4 R2#)zt Returns a representation of the version Examples -------- ```python >>> Version("1.2.3") Version("1.2.3") >>> ``` z Version("z")rr+s&r__repr__Version.__repr__s!4==//12"55rcV^8dQhRR/#rr)rs"rrrs((#(rc 6VPP4#)z Computes the hash of this instance. Examples -------- ```python >>> hash(Version("1.2.3")) == hash(Version("1.2.3")) True >>> hash(Version("1.2.3")) == hash(Version("3.2.1")) False >>> hash(Version("1")) == hash(Version("1.0.0")) True >>> ``` )r __hash__r+s&rrVersion.__hash__s }}%%''rc V^8dQhRRRR/#rkr)rs"rrr//G//rc 4VPVP8H#)z Returns True if this instance represents the same version as `other`. Examples -------- ```python >>> Version("1.2.3") == Version("1.2.3") True >>> Version("3.2.1") == Version("1.2.3") False >>> Version("1") == Version("1.0.0") True >>> ``` r ros&&r__eq__Version.__eq__ }}..rc V^8dQhRRRR/#rkr)rs"rrrrrc 4VPVP8g#)z Returns False if this instance represents the same version as `other`. Examples -------- ```python >>> Version("1.2.3") != Version("1.2.3") False >>> Version("3.2.1") != Version("1.2.3") True >>> Version("1") != Version("1.0.0") False >>> ``` rros&&r__ne__Version.__ne__rrc V^8dQhRRRR/#rkr)rs"rrr..G..rc 4VPVP8#)aH Returns True if this instance should be ordered *after* `other`. Examples -------- ```python >>> Version("1.2.3") > Version("1.2.3") False >>> Version("1.2.4") > Version("1.2.3") True >>> Version("1.2.3.1") > Version("1.2.3") True >>> Version("3.2.1") > Version("1.2.3") True >>> Version("1") > Version("1.0.0") False >>> ``` rros&&r__gt__Version.__gt__(}}u~~--rc V^8dQhRRRR/#rkr)rs"rrr rrc 4VPVP8#)aJ Returns True if this instance should be ordered *before* `other`. Examples -------- ```python >>> Version("1.2.3") < Version("1.2.3") False >>> Version("1.2.3") < Version("1.2.4") True >>> Version("1.2.3") < Version("1.2.3.1") True >>> Version("3.2.1") < Version("1.2.3") False >>> Version("1") < Version("1.0.0") False >>> ``` rros&&r__lt__Version.__lt__ rrc V^8dQhRRRR/#rkr)rs"rrr!s//G//rc 4VPVP8#)a Returns True if this instance should be ordered *after* or at the same location as `other`. Examples -------- ```python >>> Version("1.2.3") >= Version("1.2.3") True >>> Version("1.2.4") >= Version("1.2.3") True >>> Version("1.2.3.1") >= Version("1.2.3") True >>> Version("3.2.1") >= Version("1.2.3") True >>> Version("1.2.3") >= Version("3.2.1") False >>> Version("1") >= Version("1.0.0") True >>> ``` rros&&r__ge__Version.__ge__!s.}}..rc V^8dQhRRRR/#rkr)rs"rrr:s//G//rc 4VPVP8*#)ah Returns True if this instance should be ordered *before* or at the same location as `other`. Examples -------- ```python >>> Version("1.2.3") <= Version("1.2.3") True >>> Version("1.2.3") <= Version("1.2.4") True >>> Version("1.2.3") <= Version("1.2.3.1") True >>> Version("3.2.1") <= Version("1.2.3") False >>> Version("1") <= Version("1.0.0") True >>> ``` rros&&r__le__Version.__le__:s*}}..rrN))(r __module__ __qualname____firstlineno____doc____annotations__r classmethodr&propertyr*r1r6r:r>rDrHrLrQrWr\r`rdrhrnrsrxrrrrrrrrrrrr__static_attributes__rrrr r s   % %D&D&D,C K,D(F&P$))&( . ."&&&9"=2W6H*-- B & 6($/$/$.,.,/2//rr N) __future__rtypingrrrrrattler.rattlerrr r rrrrs"//:G /G /r