[Python-Dev] versioning standards?

Greg Ward gward@mems-exchange.org
Tue, 28 Nov 2000 18:51:47 -0500

On 27 November 2000, Guido van Rossum said:
> > AFAIK, __version__ with a string value is in common usage both
> > in modules and classes.
> Correct.  This was agreed upon as a standard long ago.  It's probably
> not documented anywhere as such.

I think that the "Distributing Python Modules" manual should have a
"Recommended Practices" section to cover things like this.  My personal
convention is that every single source file has a __revision__ variable,
and the "root" module [1] of a module distribution has __version__.

[1] the "root module" is the highest-level __init__.py in a package-ized
    distribution, or the module itself in a single-file distribution.
    Most non-packageized multi-module distributions have a fairly
    obvious place to put __version__.