python - 如何在我的包中获取 setup.py (setuptools) 中定义的版本？

Question

如何setup.py从我的包中获取定义的版本（用于--version或其他目的）？

Answer 1

查询已安装发行版的版本字符串

要在运行时从包内部检索版本（您的问题实际上是在问什么），您可以使用：

import pkg_resources  # part of setuptools
version = pkg_resources.require("MyProject")[0].version

存储版本字符串以供安装期间使用

如果你想反其道而行之（这似乎是这里的其他答案作者似乎认为你在问的问题），请将版本字符串放在一个单独的文件中，然后在setup.py.

您可以在包中使用__version__一行创建一个 version.py，然后使用 setup.py 从 setup.py 中读取它execfile('mypackage/version.py')，以便它__version__在 setup.py 命名空间中设置。

安装期间有关竞争条件的警告

顺便说一句，不要按照此处另一个答案中的建议从 setup.py 导入您的包：它似乎对您有用（因为您已经安装了包的依赖项），但它会对您的包的新用户造成严重破坏，因为如果不先手动安装依赖项，他们将无法安装您的包。

Answer 2

示例研究：mymodule

想象一下这样的配置：

setup.py
mymodule/
        / __init__.py
        / version.py
        / myclasses.py

然后想象一些常见的场景，你有依赖关系，setup.py看起来像：

setup(...
    install_requires=['dep1','dep2', ...]
    ...)

还有一个例子__init__.py：

from mymodule.myclasses import *
from mymodule.version import __version__

例如myclasses.py：

# these are not installed on your system.
# importing mymodule.myclasses would give ImportError
import dep1
import dep2

mymodule问题 #1：在安装过程中导入

如果您的setup.py导入mymodule，那么在设置期间您很可能会得到一个ImportError. 当您的包具有依赖项时，这是一个非常常见的错误。如果你的包除了内置之外没有其他依赖项，你可能是安全的；但这不是一个好习惯。原因是它不是面向未来的。说明天你的代码需要消耗一些其他的依赖。

问题2：我的在哪里__version__？

如果您硬编码__version__，setup.py那么它可能与您在模块中发布的版本不匹配。为了保持一致，您可以将它放在一个地方，并在需要时从同一个地方读取它。使用import你可能会遇到问题#1。

解决方案：à lasetuptools

您将使用 , 的组合open并exec提供一个 dictexec来添加变量：

# setup.py
from setuptools import setup, find_packages
from distutils.util import convert_path

main_ns = {}
ver_path = convert_path('mymodule/version.py')
with open(ver_path) as ver_file:
    exec(ver_file.read(), main_ns)

setup(...,
    version=main_ns['__version__'],
    ...)

并mymodule/version.py公开版本：

__version__ = 'some.semantic.version'

这样，该版本随模块一起提供，并且您在安装过程中尝试导入缺少依赖项（尚未安装）的模块时不会遇到问题。

Answer 3

最好的技术是__version__在您的产品代码中定义，然后从那里将其导入 setup.py。这为您提供了一个可以在运行模块中读取的值，并且只有一个地方可以定义它。

setup.py 中的值未安装，并且 setup.py 安装后不会保留。

我在coverage.py中做了什么（例如）：

# coverage/__init__.py
__version__ = "3.2"


# setup.py
from coverage import __version__

setup(
    name = 'coverage',
    version = __version__,
    ...
    )

更新（2017 年）：coverage.py 不再导入自身来获取版本。导入您自己的代码可以使其可卸载，因为您的产品代码将尝试导入尚未安装的依赖项，因为 setup.py 是安装它们的。

Answer 4

你的问题有点模糊，但我认为你要问的是如何指定它。

您需要__version__像这样定义：

__version__ = '1.4.4'

然后您可以确认 setup.py 知道您刚刚指定的版本：

% ./setup.py --version
1.4.4

Answer 5

我对这些答案不满意......不想要求 setuptools，也不想为单个变量制作一个完整的单独模块，所以我想出了这些。

因为当你确定主模块是 pep8 风格并且会保持这种状态时：

version = '0.30.unknown'
with file('mypkg/mymod.py') as f:
    for line in f:
        if line.startswith('__version__'):
            _, _, version = line.replace("'", '').split()
            break

如果您想格外小心并使用真正的解析器：

import ast
version = '0.30.unknown2'
with file('mypkg/mymod.py') as f:
    for line in f:
        if line.startswith('__version__'):
            version = ast.parse(line).body[0].value.s
            break

setup.py 有点像一次性模块，所以如果它有点难看，这不是问题。

---

更新：有趣的是，近年来我已经摆脱了这一点，并开始在包中使用一个名为meta.py. 我在那里放了很多我可能想要经常更改的元数据。所以，不仅仅是一个价值。

Answer 6

使用这样的结构：

setup.py
mymodule/
        / __init__.py
        / version.py
        / myclasses.py

其中version.py包含：

__version__ = 'version_string'

您可以在setup.py中执行此操作：

import sys

sys.path[0:0] = ['mymodule']

from version import __version__

这不会对您的 mymodule/__init__.py 中的任何依赖项造成任何问题

Answer 7

在您的源代码树中创建一个文件，例如在 yourbasedir/yourpackage/_version.py 中。让该文件只包含一行代码，如下所示：

__version__ = "1.1.0-r4704"

然后在 setup.py 中，打开该文件并解析出版本号，如下所示：

verstr = "未知"
尝试：
    verstrline = open('yourpackage/_version.py', "rt").read()
除了环境错误：
    pass # 好了，没有版本文件。
别的：
    VSRE = r"^__version__ = ['\"]([^'\"]*)['\"]"
    mo = re.search(VSRE, verstrline, re.M)
    如果莫：
        verstr = mo.group(1)
    别的：
        raise RuntimeError("unable to find version in yourpackage/_version.py")

最后，在yourbasedir/yourpackage/__init__.pyimport _version 中是这样的：

__version__ = “未知”
尝试：
    从 _version 导入 __version__
导入错误除外：
    # 我们在没有 _version.py 的树中运行，所以我们不知道我们的版本是什么。
    经过

执行此操作的代码示例是我维护的“pyutil”包。（请参阅 PyPI 或谷歌搜索——stackoverflow 不允许我在此答案中包含指向它的超链接。）

@pjeby 是正确的，你不应该从它自己的 setup.py 中导入你的包。当您通过创建一个新的 Python 解释器并首先在其中执行 setup.py 来测试它时，这将起作用：python setup.py但在某些情况下它不起作用。这是因为import youpackage这并不意味着要读取名为“yourpackage”的目录的当前工作目录，而是要在当前工作目录中查找sys.modules键“yourpackage”，如果不存在则执行各种操作。所以当你这样做时它总是有效，python setup.py因为你有一个新鲜的空的sys.modules，但这通常不起作用。

例如，如果 py2exe 在打包应用程序的过程中执行 setup.py 怎么办？我见过这样的情况，其中 py2exe 会将错误的版本号放在包上，因为包是从import myownthing在其 setup.py 中，但之前在 py2exe 运行期间导入了该软件包的不同版本。同样，如果 setuptools、easy_install、distribute 或 distutils2 在安装依赖于您的不同软件包的过程中尝试构建您的软件包，该怎么办？然后在评估 setup.py 时您的包是否可导入，或者在 Python 解释器的生命周期中是否已经导入了您的包的版本，或者导入您的包是否需要先安装其他包，或者有副作用，可以改变结果。我在尝试重用 Python 包时遇到了几次困难，这导致 py2exe 和 setuptools 等工具出现问题，因为它们的 setup.py 会导入包本身以查找其版本号。

顺便说一句，这种技术可以很好地与自动yourpackage/_version.py为您创建文件的工具配合使用，例如通过读取您的修订控制历史记录并根据修订控制历史记录中的最新标签写出版本号。这是对 darcs 执行此操作的工具：http: //tahoe-lafs.org/trac/darcsver/browser/trunk/README.rst，这是对 git 执行相同操作的代码片段：http://github .com/warner/python-ecdsa/blob/0ed702a9d4057ecf33eea969b8cf280eaccd89a1/setup.py#L34

Answer 8

这也应该起作用，使用正则表达式并根据元数据字段具有如下格式：

__fieldname__ = 'value'

在 setup.py 的开头使用以下内容：

import re
main_py = open('yourmodule.py').read()
metadata = dict(re.findall("__([a-z]+)__ = '([^']+)'", main_py))

之后，您可以像这样在脚本中使用元数据：

print 'Author is:', metadata['author']
print 'Version is:', metadata['version']

Answer 9

我们想将有关我们包的元信息放入pypackagery中__init__.py，但由于 PJ Eby 已经指出它具有第三方依赖项（请参阅他的回答和有关竞争条件的警告），因此不能。

我们通过创建一个仅pypackagery_meta.py包含元信息的单独模块来解决它：

"""Define meta information about pypackagery package."""

__title__ = 'pypackagery'
__description__ = ('Package a subset of a monorepo and '
                   'determine the dependent packages.')
__url__ = 'https://github.com/Parquery/pypackagery'
__version__ = '1.0.0'
__author__ = 'Marko Ristin'
__author_email__ = 'marko.ristin@gmail.com'
__license__ = 'MIT'
__copyright__ = 'Copyright 2018 Parquery AG'

然后将元信息导入packagery/__init__.py：

# ...

from pypackagery_meta import __title__, __description__, __url__, \
    __version__, __author__, __author_email__, \
    __license__, __copyright__

# ...

最后用在setup.py：

import pypackagery_meta

setup(
    name=pypackagery_meta.__title__,
    version=pypackagery_meta.__version__,
    description=pypackagery_meta.__description__,
    long_description=long_description,
    url=pypackagery_meta.__url__,
    author=pypackagery_meta.__author__,
    author_email=pypackagery_meta.__author_email__,
    # ...
    py_modules=['packagery', 'pypackagery_meta'],
 )

您必须使用setup 参数将其包含pypackagery_meta到您的包中。py_modules否则，您无法在安装时导入它，因为打包发行版会缺少它。

Answer 10

为了避免导入文件（并因此执行其代码），可以对其进行解析并version从语法树中恢复属性：

# assuming 'path' holds the path to the file

import ast

with open(path, 'rU') as file:
    t = compile(file.read(), path, 'exec', ast.PyCF_ONLY_AST)
    for node in (n for n in t.body if isinstance(n, ast.Assign)):
        if len(node.targets) == 1:
            name = node.targets[0]
            if isinstance(name, ast.Name) and \
                    name.id in ('__version__', '__version_info__', 'VERSION'):
                v = node.value
                if isinstance(v, ast.Str):
                    version = v.s
                    break
                if isinstance(v, ast.Tuple):
                    r = []
                    for e in v.elts:
                        if isinstance(e, ast.Str):
                            r.append(e.s)
                        elif isinstance(e, ast.Num):
                            r.append(str(e.n))
                    version = '.'.join(r)
                    break

此代码尝试在模块的顶层找到__version__or赋值返回是字符串值。VERSION右侧可以是字符串或元组。

Answer 11

给猫剥皮有一千种方法——这是我的：

# Copied from (and hacked):
# https://github.com/pypa/virtualenv/blob/develop/setup.py#L42
def get_version(filename):
    import os
    import re

    here = os.path.dirname(os.path.abspath(__file__))
    f = open(os.path.join(here, filename))
    version_file = f.read()
    f.close()
    version_match = re.search(r"^__version__ = ['\"]([^'\"]*)['\"]",
                              version_file, re.M)
    if version_match:
        return version_match.group(1)
    raise RuntimeError("Unable to find version string.")

Answer 12

从@gringo-suave清理https://stackoverflow.com/a/12413800 ：

from itertools import ifilter
from os import path
from ast import parse

with open(path.join('package_name', '__init__.py')) as f:
    __version__ = parse(next(ifilter(lambda line: line.startswith('__version__'),
                                     f))).body[0].value.s

Answer 13

现在这很严重，需要一些改进（我什至错过了 pkg_resources 中未发现的成员调用），但我根本不明白为什么这不起作用，也不知道为什么迄今为止没有人建议它（谷歌搜索有没有打开）...请注意，这是 Python 2.x，需要 pkg_resources（叹气）：

import pkg_resources

version_string = None
try:
    if pkg_resources.working_set is not None:
        disto_obj = pkg_resources.working_set.by_key.get('<my pkg name>', None)
        # (I like adding ", None" to gets)
        if disto_obj is not None:
            version_string = disto_obj.version
except Exception:
    # Do something
    pass

Answer 14

简单直接，创建一个名为的文件source/package_name/version.py，其内容如下：

#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
__version__ = "2.6.9"

然后，在您的文件source/package_name/__init__.py中，导入版本供其他人使用：

#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
from .version import __version__

现在，你可以穿上它setup.py

#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
import re
import sys

try:
    filepath = 'source/package_name/version.py'
    version_file = open( filepath )
    __version__ ,= re.findall( '__version__ = "(.*)"', version_file.read() )

except Exception as error:
    __version__ = "0.0.1"
    sys.stderr.write( "Warning: Could not open '%s' due %s\n" % ( filepath, error ) )

finally:
    version_file.close()

在 Linux 、Windows 和 Mac OS 上使用 Python 2.7、3.3、3.4、和对此进行了测试。我在我的包上使用了所有这些平台的集成和单元测试。您可以从此处查看结果：3.53.63.7.travis.ymlappveyor.yml

1. https://travis-ci.org/evandrocoan/debugtools/builds/527110800
2. https://ci.appveyor.com/project/evandrocoan/pythondebugtools/builds/24245446

---

另一个版本正在使用上下文管理器：

#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
import re
import sys

try:
    filepath = 'source/package_name/version.py'

    with open( filepath ) as file:
        __version__ ,= re.findall( '__version__ = "(.*)"', file.read() )

except Exception as error:
    __version__ = "0.0.1"
    sys.stderr.write( "Warning: Could not open '%s' due %s\n" % ( filepath, error ) )

您还可以使用该codecs模块来处理 Python2.7和3.6

#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
import re
import sys
import codecs

try:
    filepath = 'source/package_name/version.py'

    with codecs.open( filepath, 'r', errors='ignore' ) as file:
        __version__ ,= re.findall( '__version__ = "(.*)"', file.read() )

except Exception as error:
    __version__ = "0.0.1"
    sys.stderr.write( "Warning: Could not open '%s' due %s\n" % ( filepath, error ) )

---

如果您使用 Python C 扩展 100% 用 C/C++ 编写 Python 模块，您可以做同样的事情，但使用 C/C++ 而不是 Python。

在这种情况下，创建以下内容setup.py：

#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
import re
import sys
import codecs
from setuptools import setup, Extension

try:
    filepath = 'source/version.h'

    with codecs.open( filepath, 'r', errors='ignore' ) as file:
        __version__ ,= re.findall( '__version__ = "(.*)"', file.read() )

except Exception as error:
    __version__ = "0.0.1"
    sys.stderr.write( "Warning: Could not open '%s' due %s\n" % ( filepath, error ) )

setup(
        name = 'package_name',
        version = __version__,

        package_data = {
                '': [ '**.txt', '**.md', '**.py', '**.h', '**.hpp', '**.c', '**.cpp' ],
            },

        ext_modules = [
            Extension(
                name = 'package_name',
                sources = [
                    'source/file.cpp',
                ],
                include_dirs = ['source'],
            )
        ],
    )

从文件中读取版本version.h：

const char* __version__ = "1.0.12";

但是，不要忘记创建MANIFEST.in包含version.h文件：

include README.md
include LICENSE.txt

recursive-include source *.h

它集成到主应用程序中：

#include <Python.h>
#include "version.h"

// create the module
PyMODINIT_FUNC PyInit_package_name(void)
{
    PyObject* thismodule;
    ...

    // https://docs.python.org/3/c-api/arg.html#c.Py_BuildValue
    PyObject_SetAttrString( thismodule, "__version__", Py_BuildValue( "s", __version__ ) );

    ...
}

参考：

1. python打开文件错误
2. 从 C API 在 Python 模块中定义全局变量
3. 如何在 setuptools/distribute 中包含包数据？
4. https://github.com/lark-parser/lark/blob/master/setup.py#L4
5. 如何使用同名的 setuptools 包和 ext_modules？
6. 是否可以使用 dist utils (setup.py) 包含子目录作为包数据的一部分？

Answer 15

将包部署到服务器和索引包的文件命名约定：

pip 动态版本转换示例：

• 赢：

  • test_pkg-1.0.0-cp36-cp36m-win_amd64.whl
  • test_pkg-1.0.0-py3.6-win-amd64.egg

• 苹果电脑：

  • test_pkg-1.0.0-py3.7-macosx-10.12-x86_64.egg
  • test_pkg-1.0.0-py3.7-macosx-10.12-x86_64.whl
• linux：
  • test_pkg-1.0.0-cp36-cp36m-linux_x86_64.whl

from setuptools_scm import get_version

def _get_version():

     dev_version = str(".".join(map(str, str(get_version()).split("+")[0]\
            .split('.')[:-1])))

    return dev_version

找到示例 setup.py 调用来自 git commit 的动态 pip 版本匹配

setup(
    version=_get_version(),
    name=NAME,
    description=DESCRIPTION,
    long_description=LONG_DESCRIPTION,
    classifiers=CLASSIFIERS,

# add few more for wheel wheel package ...conversion

)

Answer 16

我正在使用如下环境变量

版本=0.0.0 python setup.py sdist bdist_wheel

在 setup.py

import os

setup(
    version=os.environ['VERSION'],
    ...
)

为了与打包程序版本进行一致性检查，我使用下面的脚本。

PKG_VERSION=`python -c "import pkg; print(pkg.__version__)"`
if [ $PKG_VERSION == $VERSION ]; then
    python setup.py sdist bdist_wheel
else
    echo "Package version differs from set env variable"
fi

Answer 17

值得一提的是，我写了getversion来解决这个问题，以满足我们项目的一个需求。它依赖于一系列符合 PEP 的策略来返回模块的版本，并为开发模式 (git scm) 添加了一些策略。

例子：

from getversion import get_module_version

# Get the version of an imported module
from xml import dom
version, details = get_module_version(dom)
print(version)

产量

3.7.3.final.0

为什么找到这个版本？您可以从以下方面理解details：

> print(details)
Version '3.7.3.final.0' found for module 'xml.dom' by strategy 'get_builtin_module_version', after the following failed attempts:
 - Attempts for module 'xml.dom':
   - <get_module_version_attr>: module 'xml.dom' has no attribute '__version__'
 - Attempts for module 'xml':
   - <get_module_version_attr>: module 'xml' has no attribute '__version__'
   - <get_version_using_pkgresources>: Invalid version number: None
   - <get_builtin_module_version>: SUCCESS: 3.7.3.final.0

更多可以在文档中找到。