Package: vertere
VertereSemantic Versioning CLI toolAboutA command line program to generate semantic versioning for Git.Basic usage - Initialise versioningScenario - Given a project with Git initialised and with no semantic version tags.>vertereinit--initial-version=v1.0.0
Initialisingprojectwithversion:v1.0.0The command above will prepare the project for a git tagv1.0.0but it won't commit either push to git.Execute the next command to commit and push the changes to remote:>verterepush
Tagv1.0.0pushed.The push command will tagv1.0.0in current
git head branch and push to remote.Basic usage - Versioning Patch, Minor or MajorScenario - Given a project with Git initialised and already initialised with a
semantic version git tag.>vertereinit--incrementer=patch--prefixv
Foundhighesttag:v1.0.0
Nextversionv1.0.1Then executevertere pushcommand to push to git.Supported prefixVertere supports prefixes that can change how to print the version.>vertereinit--prefixvImportant!Prefixes should contain string values only and no blank spaces.Supported postfixBUILD-SNAPSHOTM[sequencer]RC[sequencer]RELEASEVersion with postfix structure:1.2.3.<Postfix><Sequencer>DetailsBUILD-SNAPSHOT - This postfix is configured to be not promotable,
this means that if thehighest tagis equals to1.0.0.BUILD-SNAPSHOTthe
next tag will be the same, and the push command will delete the previous tag and
commit it again in the HEAD of the current branch.Milestone and Release-Candidate (M and RC) - Those are postfixes with auto sequencers,
if the latest tag have same postfix (M or RC). Thevertere initcommand will
incrementer the sequencer only. Example from a tag1.2.3RC4->1.2.3RC5RELEASE - This postfix means a end version. Any promotion from a previous
version postfix with Release will increment the semantic version. Example from1.2.3.RELEASEand properties set to--incrementer=MINOR --postfix=RELEASEwill generate
a version:1.3.0.RELEASEPostfix weights DetailsAll tags have a weight value that is used in the version promotion, where this
program will use to determine what to promote.Important!A version without postfix have the highest weight of all configured
postfixes.Version ordering example: highest to lowest1.1.0.BUILD-SNAPSHOT
1.0.0
1.0.0.RELEASE
1.0.0.RC1
1.0.0.M2
1.0.0.M1
1.0.0.BUILD-SNAPSHOTImportant!prefixes do not interfere in version orderingPromotion Scenarios - examplesScenario 1:From:v1.2.3Config:vertere init --prefix=vv --incrementer=PATCHResult:vv1.2.4Scenario 2:From:v1.2.3Config:vertere init --prefix=v --incrementer=PATCH --postfix=RCResult:v1.2.4.RC1Scenario 3:From:v1.2.4.RC1Config:vertere init --prefix=v --incrementer=PATCH --postfix=RCResult:v1.2.4.RC2Scenario 4:From:v1.2.4.RC2Config:vertere init --prefix=v --incrementer=MINOR --postfix=RELEASEResult:v1.2.4.RELEASEScenario 5:From:v1.2.4.RELEASEConfig:vertere init --prefix=v --incrementer=MINOR --postfix=RELEASEResult:v1.3.0.RELEASEScenario 6:From:v1.2.4.RELEASEConfig:vertere init --prefix=v --incrementer=MINORResult:v1.3.0CLI Propertiesvertere --help

Usage: vertere [OPTIONS] [ init | push | read ]

Options:

--initial-version TEXT 
Required when a project has not been yet initialised. 
It will determine the initial version for a git project. 
Default value: 1.0.0

--prefix TEXT
Optional property that sets a prefix for a version. 
Default value: '' (empty string)
Example.: when --prefix=v, the version will be displayed as v1.2.3

--incrementer [ PATCH | MINOR | MAJOR]
Value that dictates how the next version will be incremented. 
Default value: PATCH

--postfix TEXT
Optional property that can be used to append a known postfix to the version.
It supports [BUILD-SNAPSHOT, M, RC and RELEASE].
Example: --postfix=RELEASE, the next version will be displayed as 1.2.3.RELEASE. 

--config-path TEXT
Optional property, used to point to vertere file configuration.
Default value: vertere.yml

--debug BOOLEAN 
Enables extra log lines while executing this program. 
it might help to identify a possible problem. 
Default value: falseFile configurationThis CLI program can have the properties persisted in the git project.
by default, it tries to loadvertere.ymlFile format example:versioning:initial-version:1.0.0.BUILD-SNAPSHOTprefix:vpostfix:BUILD-SNAPSHOT | M | RC | RELEASEincrementer:MAJOR | MINOR | PATCH