d2to1 0.2.12.post1

简介

d2to1（“d”代表“distutils”）允许使用distutils2-like setup.cfg文件为包的元数据与distribute/setuptools setup.py脚本。它通过提供一个包含所有包元数据的distutils2格式化setup.cfg文件，以及一个极简的setup.py来实现，该脚本将从setup.cfg中提取其参数。

注意：distutils2已被合并到CPython标准库中，现在称为“packaging”。此项目在更改最终确定之前开始。因此，所有对distutils2的引用也应假定是指packaging。

理由

我目前正在进行大量项目的包装重做。我希望所有这些项目都使用类似distutils2的setup.cfg文件，因为它们可能是未来的趋势，而且我总体上更喜欢使用它们，而不是使用可执行文件setup.py。因此，对distutils2的前向支持既是为了未来保障，也是因为使用平面文本文件描述项目元数据的美观。

然而，我不想让这些项目中的任何一个在安装时都要求使用distutils2——它太不稳定了，而且安装范围不广。因此，项目仍然可以使用熟悉的./setup.py install进行安装，例如。此外，我支持的一些包所需的所有用例目前还没有完全被distutils2支持。希望它们最终会通过distutils2核心或通过扩展来实现。但在此期间，d2to1将努力跟上distutils2分发的最新技术和“最佳实践”，同时增加它所缺乏的支持领域。

使用方法

d2to1需要使用distribute或setuptools的发行版。您的发行版必须包含类似distutils2的setup.cfg文件和一个最小的setup.py脚本。有关编写setup.cfg的详细信息，请参阅distutils2文档。一个简单的示例可以在d2to1的自身setup.cfg中找到（它使用自己的机制来安装自己）

[metadata]
name = d2to1
version = 0.2.12
author = Erik M. Bray
author-email = embray@stsci.edu
summary = Allows using distutils2-like setup.cfg files for a package's metadata with a distribute/setuptools setup.py
description-file =
    README.rst
    CHANGES.rst
home-page = http://pypi.python.org/pypi/d2to1
requires-dist = setuptools
classifier =
    Development Status :: 5 - Production/Stable
    Environment :: Plugins
    Framework :: Setuptools Plugin
    Intended Audience :: Developers
    License :: OSI Approved :: BSD License
    Operating System :: OS Independent
    Programming Language :: Python
    Programming Language :: Python :: 3
    Topic :: Software Development :: Build Tools
    Topic :: Software Development :: Libraries :: Python Modules
    Topic :: System :: Archiving :: Packaging

[files]
packages =
    d2to1
    d2to1.extern
extra_files =
    CHANGES.rst
    LICENSE
    ez_setup.py

[backwards_compat]
zip-safe = False
tests-require = nose

[entry_points]
distutils.setup_keywords =
    d2to1 = d2to1.core:d2to1
zest.releaser.prereleaser.middle =
    d2_version = d2to1.zestreleaser:prereleaser_middle
zest.releaser.postreleaser.middle =
    d2_version = d2to1.zestreleaser:postreleaser_middle

最小的setup.py应该看起来像这样

#!/usr/bin/env python

try:
    from setuptools import setup
except ImportError:
    from distribute_setup import use_setuptools
    use_setuptools()
    from setuptools import setup

setup(
    setup_requires=['d2to1'],
    d2to1=True
)

注意，指定d2to1=True非常重要，否则d2to1功能将不会启用。还可以将d2to1设置为'some_file.cfg'来指定要使用的setup.cfg文件的（相对）路径。但通常这个功能是不必要的。

如果向setup()传递了额外的参数，也应该可以正常工作，但应该注意，它们将被setup.cfg文件中的任何选项覆盖。

注意事项

• setup.cfg中的requires-dist选项是通过distribute/setuptools的install_requires选项实现的，而不是通过正常的distutils中的损坏的“requires”关键字。

• 目前还没有支持distutils2的所有功能。如果某些功能似乎不起作用，那么可能还没有实现。

• 不支持distutils2资源，并且可能永远不会支持，因为它严重依赖于仅在Python 3.2及更高版本中可用的sysconfig模块。这是d2to1应该被视为过渡工具的一个领域。我真的不想像distutils2那样包含回滚。在此期间，package_data和data_files仍可以在setup.cfg的[files]部分中使用。

更改