使用distutils，setuptools等，在setup.py以下位置指定软件包版本：

# file: setup.py
...
setup(
name='foobar',
version='1.0.0',
# other attributes
)

我希望能够从包中访问相同的版本号：

>>> import foobar
>>> foobar.__version__
'1.0.0'

我可以将其添加__version__ = '1.0.0'到包的__init__.py中，但是我还想在包中包括其他导入，以创建包的简化接口：

# file: __init__.py

from foobar import foo
from foobar.bar import Bar

__version__ = '1.0.0'

和

# file: setup.py

from foobar import __version__
...
setup(
name='foobar',
version=__version__,
# other attributes
)

但是，foobar如果这些其他导入导入尚未安装的其他软件包，则可能导致的安装失败。与setup.py和软件包共享软件包版本的正确方法是什么？

setup.py仅设置版本，然后使用读取自己的版本pkg_resources，从而有效地查询setuptools元数据：

文件： setup.py

setup(
    name='foobar',
    version='1.0.0',
    # other attributes
)

文件： __init__.py

from pkg_resources import get_distribution

__version__ = get_distribution('foobar').version

为了在所有情况下都能正常工作，您可能最终无需安装就可以运行它，请测试DistributionNotFound并确定分发位置：

from pkg_resources import get_distribution, DistributionNotFound
import os.path

try:
    _dist = get_distribution('foobar')
    # Normalize case for Windows systems
    dist_loc = os.path.normcase(_dist.location)
    here = os.path.normcase(__file__)
    if not here.startswith(os.path.join(dist_loc, 'foobar')):
        # not installed, but there is another version that *is*
        raise DistributionNotFound
except DistributionNotFound:
    __version__ = 'Please install this project with setup.py'
else:
    __version__ = _dist.version

我不相信对此有一个规范的答案，但是我的方法（直接复制或与我在其他地方看到的略有不同）如下：

文件夹层次结构（仅相关文件）：

package_root/
 |- main_package/
 |   |- __init__.py
 |   `- _version.py
 `- setup.py

main_package/_version.py：

"""Version information."""

# The following line *must* be the last in the module, exactly as formatted:
__version__ = "1.0.0"

main_package/__init__.py：

"""Something nice and descriptive."""

from main_package.some_module import some_function_or_class
# ... etc.
from main_package._version import __version__

__all__ = (
    some_function_or_class,
    # ... etc.
)

setup.py：

from setuptools import setup

setup(
    version=open("main_package/_version.py").readlines()[-1].split()[-1].strip("\"'"),
    # ... etc.
)

……这很丑陋……但确实有效，而且我在人们希望分发的软件包中看到了它或类似的东西，我希望他们知道有更好的方法。

我同意@ stefano-m的哲学：

源码中有version =“ xyz”并在setup.py中进行解析绝对是正确的解决方案，恕我直言。比依靠运行时魔术更好（反之亦然）。

这个答案来自@ zero-piraeus的答案。重点是“不要在setup.py中使用导入，而是从文件中读取版本”。

我使用regex解析，__version__因此根本不需要成为专用文件的最后一行。实际上，我仍然将真实的单一来源__version__放在项目的__init__.py。

文件夹层次结构（仅相关文件）：

package_root/
 |- main_package/
 |   `- __init__.py
 `- setup.py

main_package/__init__.py：

# You can have other dependency if you really need to
from main_package.some_module import some_function_or_class

# Define your version number in the way you mother told you,
# which is so straightforward that even your grandma will understand.
__version__ = "1.2.3"

__all__ = (
    some_function_or_class,
    # ... etc.
)

setup.py：

from setuptools import setup
import re, io

__version__ = re.search(
    r'__version__\s*=\s*[\'"]([^\'"]*)[\'"]',  # It excludes inline comment too
    io.open('main_package/__init__.py', encoding='utf_8_sig').read()
    ).group(1)
# The beautiful part is, I don't even need to check exceptions here.
# If something messes up, let the build process fail noisy, BEFORE my release!

setup(
    version=__version__,
    # ... etc.
)

...这仍然不是理想的...但是可以。

而且，在这一点上，您可以通过以下方式测试新玩具：

python setup.py --version
1.2.3

PS：此官方Python打包文档（及其镜像）描述了更多选项。它的第一个选择也是使用正则表达式。（取决于您使用的确切正则表达式，它可能会或可能不会处理版本字符串中的引号。但是，通常这不是大问题。）

PPS：现在将ADAL Python中的修复程序移植到此答案中。

把__version__中your_pkg/__init__.py，并在解析setup.py使用ast：

import ast
import importlib.util

from pkg_resources import safe_name

PKG_DIR = 'my_pkg'

def find_version():
    """Return value of __version__.

    Reference: https://stackoverflow.com/a/42269185/
    """
    file_path = importlib.util.find_spec(PKG_DIR).origin
    with open(file_path) as file_obj:
        root_node = ast.parse(file_obj.read())
    for node in ast.walk(root_node):
        if isinstance(node, ast.Assign):
            if len(node.targets) == 1 and node.targets[0].id == "__version__":
                return node.value.s
    raise RuntimeError("Unable to find version string.")

setup(name=safe_name(PKG_DIR),
      version=find_version(),
      packages=[PKG_DIR],
      ...
      )

如果使用Python <3.4，请注意该importlib.util.find_spec功能不可用。而且，importlib当然不能依赖任何反向端口setup.py。在这种情况下，请使用：

import os

file_path = os.path.join(os.path.dirname(__file__), PKG_DIR, '__init__.py')

接受的答案要求已安装软件包。就我而言，我需要__version__从源代码中提取安装参数（包括）setup.py。在查看setuptools软件包的测试时，我找到了一个直接而简单的解决方案。寻找有关该_setup_stop_after属性的更多信息，将我带到一个旧的邮件列表帖子，其中提到distutils.core.run_setup，这使我找到了所需的实际文档。毕竟，这是简单的解决方案：

文件setup.py：

from setuptools import setup

setup(name='funniest',
      version='0.1',
      description='The funniest joke in the world',
      url='http://github.com/storborg/funniest',
      author='Flying Circus',
      author_email='flyingcircus@example.com',
      license='MIT',
      packages=['funniest'],
      zip_safe=False)

文件extract.py：

from distutils.core import run_setup
dist = run_setup('./setup.py', stop_after='init')
dist.get_version()

根据接受的答案和评论，这就是我最终要做的事情：

文件： setup.py

setup(
    name='foobar',
    version='1.0.0',
    # other attributes
)

文件： __init__.py

from pkg_resources import get_distribution, DistributionNotFound

__project__ = 'foobar'
__version__ = None  # required for initial installation

try:
    __version__ = get_distribution(__project__).version
except DistributionNotFound:
    VERSION = __project__ + '-' + '(local)'
else:
    VERSION = __project__ + '-' + __version__
    from foobar import foo
    from foobar.bar import Bar

说明：

• __project__ 是要安装的项目的名称，该名称可能与软件包的名称不同

• VERSION是我在我的命令行界面时，显示 --version请求

• 仅当实际安装了项目时，才会发生其他导入（用于简化的软件包界面）

setuptools 46.4.0添加了基本的抽象语法树分析支持，因此setup.cfg attr：指令无需导入软件包的依赖项即可工作。这样就可以使软件包版本具有唯一的真实性，从而使在发布setupstools 46.4.0之前发布的先前答案中的许多解决方案变得过时。

现在，如果在package.__init__.py中初始化了__version__，并且以下元数据已添加到包的setup.cfg文件中，则可以避免将版本传递给setup.py中的setuptools.setup函数。使用此配置，setuptools.setup函数将自动从package.__init__.py中解析软件包的版本，您可以在应用程序中需要的地方随意导入__version__.py。

例

没有将版本传递给安装程序的setup.py

from setuptools import setup

setup(
    name="yourpackage"
)

您的包装.____ init__.py

__version__ = 0.2.0

setup.cfg

[metadata]
version = attr: package.__version__

您应用中的某些模块

from yourpackage import __version__ as expected_version
from pkg_distribution import get_distribution

installed_version = get_distribution("yourpackage").version

assert expected_version != installed_version

我知道很晚了。但这对我有用。

module / version.py：

__version__ = "1.0.2"

if __name__ == "__main__":
    print(__version__)

模块/__init__.py：

from . import version
__version__ = version.__version__

setup.py：

import subprocess

out = subprocess.Popen(['python', 'module/version.py'], stdout=subprocess.PIPE, stderr=subprocess.STDOUT)
stdout,stderr = out.communicate()
version = str(stdout)

对我来说，主要优点是不需要手工解析或正则表达式或manifest.in项。它也是相当Pythonic的，似乎在所有情况下都可以工作（pip -e等），并且可以通过在version.py中使用argparse轻松扩展以共享文档字符串等。谁能看到这种方法的问题？