Python 3.2:如何为项目设置版本控制

时间:2012-08-06 15:04:46

标签: python python-3.x

好的,所以我一直在四处看看,虽然我是python的新手,但我看到了几个不同的选项,所以我有点困惑。这就是我要找的东西:

我有一个包含多个.py文件的项目。我有我的文件和我创建的库的lib目录。我的问题是,如何设置项目以获得版本?我看到很多文章说我把这个版本放在setup.py中。 setup.py在哪里?还有什么需要在setup.py文件中?我只是将setup.py导入我的python文件中吗?我如何检查它是否有效?如何检查每个.py文件的版本以确保正确导入?

2 个答案:

答案 0 :(得分:4)

阅读hitchhiker's guide to packaging以学习开发Python项目的良好实践

  

setup.py文件是Python项目的核心。它描述了有关项目的所有元数据。您可以在项目中添加相当多的字段,以便为其提供描述项目的丰富元数据集。但是,只有三个必填字段:名称,版本和包。如果您希望在Python包索引(PyPI)上发布包,则name字段必须是唯一的。版本字段跟踪项目的不同版本。 packages字段描述了将Python源代码放在项目中的位置。

     

我们的初始setup.py还将包含有关许可证的信息,并将重新使用README.txt文件作为long_description字段。这看起来像是:

from distutils.core import setup

setup(
    name='TowelStuff',
    version='0.1dev',
    packages=['towelstuff',],
    license='Creative Commons Attribution-Noncommercial-Share Alike license',
    long_description=open('README.txt').read(),
)

答案 1 :(得分:1)

通常,项目会在其顶级命名空间中将其版本作为__version__属性包含在其中。

例如:

>>> import myproject
>>> print myproject.__version__
'3.2.0'

有关从__version__文件中访问setup.py的更多信息和方法,请参阅http://www.python.org/dev/peps/pep-0396/