Skip to content

Latest commit

 

History

History
42 lines (29 loc) · 1.54 KB

UPGRADING.md

File metadata and controls

42 lines (29 loc) · 1.54 KB

Upgrading Versioneer In Your Project

Some releases of Versioneer change the way your setup.py and setup.cfg must be configured. This document contains a list of releases where, when upgrading from an older release, you must make changes in your project.

Upgrading to 0.16, 0.17, 0.18 or 0.19

Nothing special.

Upgrading to 0.15

Starting with this version, Versioneer is configured with a [versioneer] section in your setup.cfg file. Earlier versions required the setup.py to set attributes on the versioneer module immediately after import. The new version will refuse to run (raising an exception during import) until you have provided the necessary setup.cfg section.

In addition, the Versioneer package provides an executable named versioneer, and the installation process is driven by running versioneer install. In 0.14 and earlier, the executable was named versioneer-installer and was run without an argument.

Upgrading to 0.14

0.14 changes the format of the version string. 0.13 and earlier used hyphen-separated strings like "0.11-2-g1076c97-dirty". 0.14 and beyond use a plus-separated "local version" section strings, with dot-separated components, like "0.11+2.g1076c97". PEP440-strict tools did not like the old format, but should be ok with the new one.

Upgrading from 0.11 to 0.12

Nothing special.

Upgrading from 0.10 to 0.11

You must add a versioneer.VCS = "git" to your setup.py before re-running setup.py setup_versioneer. This will enable the use of additional version-control systems (SVN, etc) in the future.