19

I had to install OpenStack using devstack infrastructure for experiements with open vSwitch, and found this in the logs:

/usr/lib/python2.7/site-packages/setuptools/dist.py:298: UserWarning: The version specified ('2014.2.2.dev5.gb329598') is an invalid version, this may not work as expected with newer versions of setuptools, pip, and PyPI. Please see PEP 440 for more details.

I googled and found PEP440, but I wonder how serious is this warning?

wim
  • 338,267
  • 99
  • 616
  • 750
Mark
  • 6,052
  • 8
  • 61
  • 129

3 Answers3

12

Each Python package can specify its own version. Among other things, PEP440 says that a version specification should be stored in the __version__ attribute of the module, that it should be a string, and that should consist of major version number, minor version number and build number separated by dots (e.g. '2.7.8') give or take a couple of other optional variations. In one of the packages you are installing, the developers appear to have broken these recommendations by using the suffix '.gb329598'. The warning says that this may confuse certain package managers (setuptools and friends) in some circumstances.

It seems PEP440 does allow arbitrary "local version labels" to be appended to a version specifier, but these must be affixed with a '+', not a '.'.

jez
  • 14,867
  • 5
  • 37
  • 64
  • 1
    Re: "the developers appear to have broken these recommendations" -- in fact, the recommendations were amended such that the developers are now breaking them. – j0057 Jan 17 '15 at 14:25
  • 1
    RE "build number". you correctly say that there are optional variants but the N(.N)* portion is called the release segment and they suggest ("major.minor.micro"). build number is about the building and packaging, not-so-much about versioning. Could build number look like micro and be called local versioning info....dunno but I think build should not be conflated with version. – Phil Cooper Jan 25 '15 at 17:06
  • Any option to not show this warning? – uday Apr 13 '22 at 18:37
  • 1
    PEP440 doesn't say anything about a `__version__` attribute in the module. – wim Jul 06 '22 at 18:38
8

As an end user, this shouldn't be a serious concern for you, it just means that, since the version number specified doesn't agree with the rules for python package versions, that the python packaging system cannot reliably discern which other versions of this package are before or after it.

In particular, its not specified if 2014.2.2.dev5.g... should come before or after 2014.2.2.dev5, since the rules don't say anything about what g is supposed to mean.

this is not likely to affect you too much; since either are going to be dev releases; and both strictly are between 2014.2.1 and 2014.2.2

SingleNegationElimination
  • 151,563
  • 33
  • 264
  • 304
0

This warning isn't something that you really need to worry about, it's more of a warning for the developers.

It basically means that there is a module to identify version numbers (which ones are more recent, etc.) for tracking dependencies for PyPi (python's package host) and that the given version is in a format that isn't recognized.

If you just wait until the next patch it will go away.

randomusername
  • 7,927
  • 23
  • 50