[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__.
Greg