Package: enhanced-versioning
Versioning PackageThe versioning package is a fork from theversionpackage which implements semantic versioning. The primary reason for forkingversionis to extend functionality to support a non-semantic versioning schema.pip install enhanced-versioning==0.2.1Semantic version implementationTheEnhanced-Versioningpackage providesSemanticVersionwhich implements versioning as described inSemantic Versioning spec 2.0.0-rc.1.Example of simple X.Y.Z version:>>>fromenhanced_versioningimportSemanticVersion>>>v=SemanticVersion('1.2.3')>>>vSemanticVersion('1.2.3')>>>str(v)'1.2.3'>>>v.major1>>>v.minor2>>>v.patch3>>>v.pre_release[]>>>v.build[]Example with pre-release and build versions:>>>v2=SemanticVersion('2.7.3-rc.2.15+19.e02afe3')>>>v2.major2>>>v2.minor7>>>v2.patch3>>>v2.pre_release['rc',2,15]>>>v2.build[19,'e02afe3']SemanticVersionsupports rich comparison operators (<, <=, >, >=, ==, !=),
and thus can be sorted:>>>versions=[SemanticVersion('1.0.0+0.3.7'),...SemanticVersion('1.0.0'),...SemanticVersion('1.0.0-beta.11'),...SemanticVersion('0.9.0'),...SemanticVersion('1.0.0-rc.1'),...SemanticVersion('1.0.0-rc.1+build.1'),...SemanticVersion('1.0.0-alpha.1')]>>>print('\n'.join(map(str,sorted(versions))))0.9.01.0.0-alpha.11.0.0-beta.111.0.0-rc.11.0.0-rc.1+build.11.0.01.0.0+0.3.7Non-Semantic version implementationTheVersioningpackage providesNonSematicVersionwhich implements a non-semantic versioning system as described below.Non-Semantic Versioning SpecificationThis specification carries over much of the Sematic Versioning Specification except as noted.Software using Non-Semantic Version MAY declare a public API, but it is not required.A version MUST consist of one or more dot separated revisions. A revision MUST contain at least one non-negative integer or ASCII alphabetical character [0-9A-Za-z] in which integers, if present, must precede characters. The revision is treated as two parts. The integer value and the character value where the integer value takes precedence over the character value in comparisons. Each revision much increase. For instance: 1.2a.4 -> 1.2b.4 -> 1.3a.4.SeeSemantic Versioning Specification Rule 3Non-Semantic Versioning does not define a standard for stability.Non-Semantic Versioning does not require a public API to be defined.Revisions to the left MUST carry greater weight than revisions to the right, but Non-Semantic Versioning does not define precisely what each revision must mean.Revisions to the right MUST be reset to the appropriate beginning value when revisions to the left are incremented. The integer value of a revision MUST be reset to 0. The character value SHOULD be reset to 'a'.See rule 7 above.SeeSemantic Versioning Specification Rule 9regarding pre-releases.SeeSemantic Versioning Specification Rule 10regarding builds.Precedence MUST be calculated by separating individual revisions and pre-release identifiers. Precedence is determined first by the number of revisions with more revisions taking precedence over fewer. If the number of revisions is equal, then precedence is determined by the first difference when comparing revisions from left to right where the integer values of the revisions are compared numerically first followed by the character values compared alphabetically. Example: 1 < 1.0 < 1.1a < 1.1e < 1.2a. When all revisions are equal, the precedence must be determined by pre-releases. SeeSemantic Versioning Specification Rule 11for full details on pre-release precedence.Example of non-semantic versioning:>>>fromenhanced_versioningimportNonSemanticVersion>>>v=NonSemanticVersion('1')>>>vNonSemanticVersion('1')>>>str(v)'1'>>>v.revisions['1']>>>v.pre_release[]>>>v.build[]Example with pre-release and build versions:>>>v2=NonSemanticVersion('1.4f.2c-rc.2.15+19.e02afe3')>>>v2NonSemanticVersion('1.4f.2c-rc.2.15+19.e02afe3')>>>str(v2)'1.4f.2c-rc.2.15+19.e02afe3'>>>v2.revisions['1','4f','2c']>>>v2.pre_release['rc',2,15]>>>v2.build[19,'e02afe3']NonSemanticVersionsupports rich comparison operators (<, <=, >, >=, ==, !=),
and thus can be sorted:>>>versions=[NonSemanticVersion('1.0.4d.7f+0.3.7'),...NonSemanticVersion('1.0.4d.7f'),...NonSemanticVersion('1.0.4d.7f-beta.11'),...NonSemanticVersion('0.9.4d.7f'),...NonSemanticVersion('1.0.4d.7f-rc.1'),...NonSemanticVersion('1.0.4d.7f-rc.1+build.1'),...NonSemanticVersion('1.0.4d.7f-alpha.1'),...NonSemanticVersion('1.0.2f.12k+build.3')]>>>print('\n'.join(map(str,sorted(versions))))0.9.4d.7f1.0.2f.12k+build.31.0.4d.7f-alpha.11.0.4d.7f-beta.111.0.4d.7f-rc.11.0.4d.7f-rc.1+build.11.0.4d.7f1.0.4d.7f+0.3.7