[英]How can I get the version defined in setup.py (setuptools) in my package?
我如何从我的 package 中获取setup.py中定义的版本（用于--version或其他目的）？
要在运行时从包内部检索版本（您的问题实际上是在问什么），您可以使用：
import pkg_resources # part of setuptools
version = pkg_resources.require("MyProject")[0].version
如果您想反其道而行之（这似乎是其他答案作者似乎认为您在问的问题），请将版本字符串放在单独的文件中，并在setup.py中读取该文件的内容。
您可以在包中使用__version__行创建一个 version.py，然后使用execfile('mypackage/version.py')从 setup.py 中读取它，以便在 setup.py 命名空间中设置__version__ 。
顺便说一句，不要按照此处另一个答案中的建议从 setup.py 导入您的包：它似乎对您有用（因为您已经安装了包的依赖项），但它会对您的包的新用户造成严重破坏，因为如果不先手动安装依赖项，他们将无法安装您的包。
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 如果您的setup.py导入mymodule ，那么在设置期间您很可能会收到ImportError 。 当您的包具有依赖项时，这是一个非常常见的错误。 如果你的包除了内置之外没有其他依赖项，你可能是安全的； 但这不是一个好习惯。 原因是它不是面向未来的。 说明天你的代码需要消耗一些其他的依赖。
__version__呢？ 如果您在setup.py中对__version__进行硬编码，那么它可能与您在模块中发布的版本不匹配。 为了保持一致，您可以将它放在一个地方，并在需要时从同一个地方读取它。 使用import您可能会遇到问题 #1。
setuptools 您将使用open 、 exec的组合并为exec提供一个 dict 来添加变量：
# 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'
这样，该版本随模块一起提供，并且您在安装过程中尝试导入缺少依赖项（尚未安装）的模块时不会遇到问题。
最好的技术是在您的产品代码中定义__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 是安装它们的。
你的问题有点模糊，但我认为你要问的是如何指定它。
您需要像这样定义__version__ ：
__version__ = '1.4.4'
然后您可以确认 setup.py 知道您刚刚指定的版本：
% ./setup.py --version
1.4.4
我对这些答案不满意......不想要求 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的单独文件。 我在那里放了很多我可能想要经常更改的元数据。 所以，不仅仅是一个价值。
使用这样的结构：
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 中的任何依赖项造成任何问题
在您的源代码树中创建一个文件，例如在 yourbasedir/yourpackage/_version.py 中。 让该文件只包含一行代码，如下所示：
__version__ = "1.1.0-r4704"
然后在 setup.py 中，打开该文件并解析出版本号，如下所示：
verstr = "unknown"
try:
verstrline = open('yourpackage/_version.py', "rt").read()
except EnvironmentError:
pass # Okay, there is no version file.
else:
VSRE = r"^__version__ = ['\"]([^'\"]*)['\"]"
mo = re.search(VSRE, verstrline, re.M)
if mo:
verstr = mo.group(1)
else:
raise RuntimeError("unable to find version in yourpackage/_version.py")
最后，在yourbasedir/yourpackage/__init__.py导入 _version，如下所示：
__version__ = "unknown"
try:
from _version import __version__
except ImportError:
# We're running in a tree that doesn't have a _version.py, so we don't know what our version is.
pass
执行此操作的代码示例是我维护的“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 会将错误的版本号放在一个包上，因为该包是从 setup.py 中的import myownthing获取其版本号，但之前在 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
我们想将关于我们的包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'],
)
您必须使用py_modules设置参数将pypackagery_meta包含到您的包中。 否则，您无法在安装时导入它，因为打包发行版会缺少它。
这也应该起作用，使用正则表达式并根据元数据字段具有如下格式：
__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']
简单直接，创建一个名为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 3.7 3.4 2.7 3.3 3.5 3.6 我在我的包上使用了所有这些平台的集成和单元测试。 您可以在此处查看.travis.yml和appveyor.yml的结果：
另一个版本正在使用上下文管理器：
#!/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模块来处理 Python 2.7和3.6上的 unicode 错误
#!/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__ ) );
...
}
参考：
给猫剥皮有一千种方法——这是我的：
# 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.")
为了避免导入文件（并因此执行其代码），可以对其进行解析并从语法树中恢复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__或VERSION赋值是字符串值。 右侧可以是字符串或元组。
从@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
现在这很严重，需要一些改进（我什至错过了 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
将包部署到服务器和索引包的文件命名约定：
pip 动态版本转换示例：
赢：
苹果电脑：
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
)
我正在使用如下环境变量
版本=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
值得一提的是，我写了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
更多可以在文档中找到。
您应该在您的包中包含版本字符串，例如__version__ = 'major.minor.patch' in __init__.py ，而不是在您的代码中检索 setup 中定义的版本。
然后你可以在 setup.py 中导入你的包并传递version = your_package.__version__ ，或者你可以在 setup.cfg 中使用version = attr: your_package.__version__ 。
我创建了正则表达式模式以从 setup.cfg 中查找版本号?:[\s]+|[\s])?[=](?:[\s]+|[\s])?(.*)
import re
with open("setup.cfg", "r") as _file:
data = _file.read()
print(re.findall(r"\nversion(?:[\s]+|[\s])?[=](?:[\s]+|[\s])?(.*)", data))
# -> ['1.1.0']
许多其他答案都已过时，我相信从已安装的 python 3.10 package 获取版本信息的标准方法是使用PEP-0566起的 importlib.metadata
官方文档： https://docs.python.org/3.10/library/importlib.metadata.html
from importlib.metadata import version
VERSION_NUM = version("InstalledPackageName")
这很简单，干净，没有大惊小怪。
如果您在 package 安装期间运行的脚本中做一些奇怪的事情，这将不起作用，但是如果您所做的只是获取版本号以通过 CLI --help 命令向用户显示版本检查，关于框, 或者其他已经安装了 package 并且只需要安装的版本号的东西，这对我来说似乎是最好的解决方案。
您可以将此代码添加到您的__init__.py ：
VERSION = (0, 3, 0)
def get_version():
"""Return the VERSION as a string.
For example, if `VERSION == (0, 10, 7)`, return '0.10.7'.
"""
return ".".join(map(str, VERSION))
__version__ = get_version()
并将其添加到setup.py中：
def get_version(version_tuple):
"""Return the version tuple as a string, e.g. for (0, 10, 7),
return '0.10.7'.
"""
return ".".join(map(str, version_tuple))
init = os.path.join(os.path.dirname(__file__), "your_library", "__init__.py")
version_line = list(filter(lambda line: line.startswith("VERSION"), open(init)))[0]
VERSION = get_version(eval(version_line.split("=")[-1]))
最后，您可以将version=VERSION,行添加到setup中：
setup(
name="your_library",
version=VERSION,
)
Python setuptools：如何在 setup.py 中添加私有存储库 (gitlab)？
[英]Python setuptools: How can I add a private repository (gitlab) in my setup.py?
如何使用setuptools和setup.py从包中排除单个文件
[英]How to exclude a single file from package with setuptools and setup.py
在使用setuptools的setup.py中，如何仅选择Subversion中的.py文件？
[英]In setup.py that uses setuptools, how can I select only .py files that are in Subversion?
setuptools setup.py 可以定义多个包吗？我如何单独引用它们？
[英]Can setuptools setup.py define multiple packages and how do I reference them individually?
声明:本站的技术帖子网页，遵循CC BY-SA 4.0协议，如果您需要转载，请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.