[Python-Dev] PEP 396, Module Version Numbers

[Ben Finney]

Howdy Barry,

Nitpick: Please call these “version strings”. A version string is hardly
ever just one number, and not in the general case anyway.


I'd like to suggest another user story:

Barry Warsaw <barry at python.org> writes:

> User Stories
> ============

    Emily maintains a package consisting of programs and modules in
    several languages that inter-operate; several are Python, but some
    are Unix shell, Perl, and there are some C modules. Emily decides
    the simplest API for all these modules to get the package version
    string is a single text file named ``version`` at the root of the
    project tree. All the programs and modules, including the
    ``setup.py`` file, simply read the contents of ``version`` to get
    the version string.

This is an often-overlooked case, I think. The unspoken assumption is
often that ``setup.py`` is a suitable place for the overall version
string, but this is not the case when that string must be read by
non-Python programs.

-- 
 \      “If you can't beat them, arrange to have them beaten.” —George |
  `\                                                            Carlin |
_o__)                                                                  |
Ben Finney
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 835 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/python-dev/attachments/20110410/379de3f5/attachment.pgp>