setuphelpers 0.1.2

git_version

用于从Git提供包的版本字符串。如果最新的 提交已标记，版本将是该标记。如果没有标记，它 将是最后一个版本+1个次要/修补程序版本。devn提交数 从上次标记开始。如果从主分支以外的分支构建，则该分支 名称用作本地版本标识符。

示例：0.0.1，0.0.2.dev1，0.0.2.dev1+featureX

fromsetuptoolsimportsetupfromsetuphelpersimportgit_versionsetup(name="my_thing",version=git_version())

注意，您不能使用git_version部署sdist包，到期 需要访问.git。但请不要开始包括 .git在您的包中。你可以用一种模式 git_version写入要包含的文件，但我认为 没有必要这么做，因为它已经包含在书面文件中了 包元数据（wheels>；*）。但如果必须的话：

importosimportiofromsetuptoolsimportsetupfromsetuphelpersimportgit_versionfromsetuphelpersimportfind_version# VER_FILE should not exist in your checked in sourceVER_FILE=os.path.join("my_thing","__version__.py")ifos.path.isfile(VER_FILE):# this should only be run during rebuilding a sdist packageVERSION=find_version(VER_FILE)else:# this should be run only during the actual packagingVERSION=git_version()withio.open(VER_FILE,"w",encoding="utf-8")asopenversion:openversion.write('__version__ = "{}"'.format(VERSION))setup(name="my_thing",version=VERSION)

long_description

用于用 自述文件。如果找不到自述文件，将返回到 安装程序.py。

fromsetuptoolsimportsetupfromsetuphelpersimportlong_descriptionsetup(name="my_thing",version="1.0",long_description=long_description())

find_version

用于在指定的 文件路径。

fromsetuptoolsimportsetupfromsetuphelpersimportfind_versionsetup(name="my_thing",version=find_version("my_thing/__init__.py"))

test_command

用于构建用于运行单元测试的测试命令类 python setup.py test。默认支持py.test，但nose和 单元测试也是可能的。来自test_command的返回可以是 传递给cmdclass。

注意，tests_require依赖项仍然需要提供， 包括保险，如果你使用它（加上你需要的任何东西 使用测试）。

fromsetuptoolsimportsetupfromsetuphelpersimporttest_commandsetup(name="my_thing",version="1.0",tests_require=["pytest","pytest-cov"],cmdclass=test_command(cover="my_thing"),)