一个小型库,可以轻松地使您的版本保持最新。
项目描述
“””任何名字的版本都一样甜蜜。”””
一个小型库,可以轻松地使您的版本保持最新。
每次发布Python包时都不得不更新你的setup.py、你的Sphinx conf.py、你的__init__.py以及所有其他文件,这种痛苦令人难以忍受。让你的生活更轻松(&非常 semver!)
通过在顶层文件VERSION中放置版本号并使用此库,你可以减少重复工作,并无需依赖疯狂的导入技巧。
灵感来源于2013年PyCon上与George Hickman(ghickman)的疯狂讨论。
需求
Python 2.5+
使用方法
首先,安装rose(见下文)。然后,将版本号推送到它自己的文件中(通常称为VERSION)
$ echo '1.0.0-beta' > VERSION
更新你的setup.py,使其看起来像
# ... import rose setup( name='your_package_name_here', # UPDATE THIS LINE! version=rose.load_version('VERSION'), # The usual follows...
然后更新你的__init__.py
# Whatever is there, then... import os import rose # If you don't care about being cross-platform, you can just pass a simple # path instead. VERSION_FILE = os.path.join(os.path.dirname('VERSION')) __version__ = rose.build_version('your_package_name_here', rose.load_version(VERSION_FILE))
如果你使用Sphinx进行文档,你可以使用以下内容更新你的conf.py
# ADD THIS! import rose RELEASE_VERSION = rose.load_version('../VERSION') SHORT_VERSION = RELEASE_VERSION.split('-')[0] # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # # The short X.Y version. version = SHORT_VERSION # The full version, including alpha/beta/rc tags. release = RELEASE_VERSION
安装
使用pip,只需运行
pip install rose
许可
新BSD