跳转到主要内容

一个小型库,可以轻松地使您的版本保持最新。

项目描述

“””任何名字的版本都一样甜蜜。”””

一个小型库,可以轻松地使您的版本保持最新。

每次发布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

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分布

rose-1.0.0.tar.gz (3.6 kB 查看哈希值)

上传时间 源代码

支持者