Skip to main content

a tool to provide versions wit scm data.

Project description

============
vcver Python
============

--------------
What is vcver?
--------------

vcver is a versioning tool that includes tooling for creating versions
that allow easy correlation to the change in version control.

Defaults are also provided for a version string that is compatible
with semantic versioning, with
`PEP440`<https://www.python.org/dev/peps/pep-0440/> compatible and
incompatible variants.

----------------------
Version String Formats
----------------------

The default version string for vcver is of the form::

{tag_version}.{commit_count}+{scm_change_id}

Where:

* tag_version is retrieved from the last tagged commit with a leading v and is numerics and dots (e.g. v1.0)
* commitcount is the number of commits from the version tag consumed
* scm_change_id is a unique id in the form of version control, used to identify
the change that was used to build this version.

Pre-PEP440 Version
==================

Some (much older) versions of setuptools are unable to consume the default version string,
due to the plus in the version string.

If you need backwards compatibility and you would still like vc versioning, the
following format is recommended:

{tag_version}.{commit_count}.{scm_change_id}

--------------------------------------
Compatibility with Semantic Versioning
--------------------------------------

Semantic versioning is a standard to provided a meaning to the major, minor, and patch
versions of a version string. Compatibility with semver is possible if
new major / minor versions are tagged according the semver spec.

--------------
Special Thanks
--------------

- Zillow, from where this library is inspired.
- Taylor McKay (@tmckay), who implemented the original Python version at Zillow
- Mohammad Sarhan (@sarhanm), who designed and implemented the original Java version at Zillow.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vcver-0.0.1.dev4.tar.gz (5.0 kB view details)

Uploaded Source

Built Distribution

vcver-0.0.1.dev4-py2.py3-none-any.whl (10.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file vcver-0.0.1.dev4.tar.gz.

File metadata

  • Download URL: vcver-0.0.1.dev4.tar.gz
  • Upload date:
  • Size: 5.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for vcver-0.0.1.dev4.tar.gz
Algorithm Hash digest
SHA256 67ec76fd31844f58576024f3589cc4a24e8b97ab8f0b18b9ddd775aaa48a73fe
MD5 0e0addd7843223d6d622114b5d13ce8e
BLAKE2b-256 83fdd243b9e2164d5dd26a51ec108a702fbd3e2a262a1be9f9a501fa190ef0ab

See more details on using hashes here.

Provenance

File details

Details for the file vcver-0.0.1.dev4-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for vcver-0.0.1.dev4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4fd10d37419eaca42c37f21771c4114a10d3454dfbfffe49b08cc9f59c298be8
MD5 7dc908612d59bc8e3e7370e6efcc9367
BLAKE2b-256 f7947c4d92d0adbe2c03bf114313544b37b441bfc3888c15f0e1b4d5d2ef358e

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page