stdeb3 0.9.0.post2

Python 3 支持

如以下详细解释所述，stdeb 的核心是 sdist_dsc distutils 命令。此命令运行一次以生成 Debian 源包。此 Debian 源包可以指定为 Python 2、Python 3 或两者都构建包。现在只能通过 python3 解释器执行此操作。默认情况下，仅构建正在使用的 Python 版本的包。要覆盖此设置，请使用 --with-python2=True 或 --with-python3=True 作为 sdist_dsc distutils 命令的参数（或两者都使用以确保）。例如，使用 Python 3 解释器仅构建 Python 3 包

python3 setup.py --command-packages=stdeb3.command bdist_deb

使用 Python 3 解释器构建 Python 2 和 Python 3 包（并且仅安装 Python3 包的脚本）

python3 setup.py --command-packages=stdeb3.command sdist_dsc --with-python2=True --with-python3=True --no-python2-scripts=True bdist_deb

新闻

• 2019-01-31：版本 0.9.0。迁移到 stdeb3。有关更改，请参阅 RELEASE_NOTES.txt。

• 2015-02-18：版本 0.8.5。请参阅 下载页面。错误修复：已撤销在虚拟环境构建时安装到虚拟环境的更改。改进：添加 –allow-virtualenv-install-location 以允许安装到虚拟环境位置。支持 Debian Squeeze（6）、Debian Wheezy（7）、Ubuntu Precise（12.04）、Ubuntu Trusty（14.04）和后续版本。

• 2015-02-16：版本 0.8.4。请参阅 下载页面。错误修复：再次在 Python 3.4（例如 Ubuntu Trusty）上工作。改进：改进了 Python 3 的自定义（Dirk Thomas 添加了 force-x-python3-version 和 X-Python3-Version，Louis 添加了 Recommends3、Suggests3、Provides3 和 Replaces3 支持）。支持 Debian Squeeze（6）、Debian Wheezy（7）、Ubuntu Precise（12.04）、Ubuntu Trusty（14.04）和后续版本。

• 2015-02-14：版本 0.8.3。请参阅 下载页面。这是一个错误修复版本，修复了 Unicode 支持的几个方面。测试通过 Debian Squeeze（6）、Debian Wheezy（7）和 Ubuntu Precise（12.04）。Python 3.4（例如 Ubuntu Trusty 14.04）的支持被错误地破坏，并在 0.8.3 版本中修复。

• 2014-8-14：版本 0.8.2。请参阅 下载页面。这是一个错误修复版本，修复了在某些情况下请求 Python 3 包时构建 Python 2 包的严重问题。

• 2014-8-10：版本 0.8.1。请参阅 下载页面。由于 0.8.0 中的错误，这是 0.8 系列的第一个宣布版本。自 0.7.1 以来亮点

  • 完全支持Python 3。这包括使用Python 3运行以及为Python 3生成包。默认情况下，使用Python 3运行时构建Python 3包，从Python 2运行时构建Python 2包。可以使用命令行选项来构建其他Python解释器的包。

  • 为源包构建.changes文件。虽然这仍然需要在例如上传到PPA时签名，但在某些情况下仍然有用。

  • 切换到Debian源格式3.0（quilt）。实际上，过去随源包提供的.diff.gz文件现在被.deb.tar.gz文件替换。

  • 使用Requests与PyPI通信时验证SSL证书。（验证需要Requests >= 0.8.8。）

  • 许多错误修复。

• 2014-05-05：版本0.7.1。请参阅下载页面。本次发布亮点（您还可以查看完整的变更日志）。由于0.7.0中的错误，本次发布是0.7系列的第一个发布。自0.6.0以来的亮点

  • 新增命令：pypi-download和pypi-install，分别用于直接从PyPI下载和安装包。py2dsc-deb直接从源tarball创建.deb文件。

  • 新增distutils命令：install_deb，允许您将Python包直接安装为标准系统包。

  • 许多错误修复，包括新的PyPI URL。

  • 感谢Travis CI自动运行测试套件。

  • 感谢许多人的帮助，特别是Piotr Ożarowski对stdeb的帮助。

• 2010-06-18：版本0.6.0。请参阅下载页面。本次发布亮点（您还可以查看完整的变更日志）

  • 新增debianize命令，在您的setup.py文件旁边构建debian/目录。

  • 错误修复。

• 2010-01-09：版本0.5.1。错误修复版本。请参阅下载页面、变更日志和发行说明。

• 2009-12-30：版本0.5.0。请参阅下载页面。本次发布亮点（您还可以查看完整的变更日志）

  • 新增pypi-install脚本，可以自动下载、创建.deb文件并安装来自Python包索引（PyPI）的包。

  • 移除了setuptools依赖。

  • 新增选项（–guess-conflicts-provides-replaces），用于查询原始Debian包的Conflicts/Provides/Replaces信息。

  • 由于这些更改和修复了一些错误/瑕疵，进行了一些较小的向后不兼容的更改和弃用。请查看发行说明。

• 2009-12-28：版本0.4.3发布。请参阅下载页面。请参阅变更日志和发行说明。

• 2009-11-02：版本0.4.2发布。请参阅下载页面。请参阅变更日志和发行说明。

• 2009-10-04：版本0.4.1发布。请参阅下载页面。请参阅变更日志和发行说明。

• 2009-09-27: 版本 0.4 发布。请参阅下载页面。此版本切换到 debhelper 7。请参阅0.4 版本的变更日志。

版本 0.3.2 及之前的版本与 Ubuntu Hardy 兼容。

• 2009-10-04: 版本 0.3.2 发布。请参阅下载页面。请参阅0.3.2 版本的变更日志

• 2009-09-27: 版本 0.3.1 发布。请参阅下载页面。请参阅0.3.1 版本的变更日志

• 2009-03-21: 版本 0.3 发布。请参阅下载页面。请参阅0.3 版本的变更日志

• 2009-02-17: 版本 0.2.3 发布。请参阅下载页面。请参阅0.2.3 版本的变更日志

• 2009-01-29: 版本 0.2.2 发布。请参阅下载页面。请参阅0.2.2 版本的变更日志

• 2008-04-26: 版本 0.2.1 发布。请参阅下载页面。请参阅0.2.1 版本的变更日志

• 2008-04-26: 版本 0.2 发布。请参阅下载页面。请参阅0.2 版本的变更日志

• 2007-04-02: 版本 0.2.a1 发布。请参阅旧下载页面。

• 2006-06-19: 版本 0.1 发布。请参阅旧下载页面。

命令

pypi-download [options] mypackage

pypi-install [options] mypackage

py2dsc [options] mypackage-0.1.tar.gz # uses pre-built Python source package

py2dsc-deb [options] mypackage-0.1.tar.gz # uses pre-built Python source package

python3 setup.py --command-packages=stdeb3.command sdist_dsc

python3 setup.py --command-packages=stdeb3.command bdist_deb

sudo python3 setup.py --command-packages=stdeb3.command install_deb

python3 setup.py --command-packages=stdeb3.command debianize

[global]
command-packages: stdeb3.command

示例

这些都假设您已将 stde3b 安装在系统 Python 路径中。stdeb3 也从非系统 Python 路径（例如 virtualenv）工作。

pypi-install mypackage

python3 setup.py --command-packages=stdeb3.command bdist_deb

wget http://pypi.python.org/packages/source/R/Reindent/Reindent-0.1.0.tar.gz
py2dsc Reindent-0.1.0.tar.gz

cd deb_dist/reindent-0.1.0/
dpkg-buildpackage -rfakeroot -uc -us

cd ..
sudo dpkg -i python-reindent_0.1.0-1_all.deb

python3 setup.py --command-packages=stdeb3.command install_deb

wget http://pypi.python.org/packages/source/R/Reindent/Reindent-0.1.0.tar.gz
tar xzf Reindent-0.1.0.tar.gz
cd Reindent-0.1.0

python3 setup.py --command-packages=stdeb3.command sdist_dsc

cd deb_dist/reindent-0.1.0
dpkg-buildpackage -rfakeroot -uc -us

cd ..
sudo dpkg -i python-reindent_0.1.0-1_all.deb

下载

文件可在下载页面找到（对于旧版本，请参阅旧下载页面）。

git存储库可在http://github.com/astraw/stdeb找到

安装（或，使用 stdeb 创建 stdeb 安装程序）

为了好玩，以下是使用stdeb安装stdeb的方法。请注意，stdeb也存在于Debian和Ubuntu中，因此此食谱仅用于安装较新的stdeb。

STDEB3_VERSION="0.9.0"

# Download stdeb3
wget http://pypi.python.org/packages/source/s/stdeb3/stdeb3-$STDEB3_VERSION.tar.gz

# Extract it
tar xzf stdeb3-$STDEB3_VERSION.tar.gz

# Enter extracted source package
cd stdeb3-$STDEB3_VERSION

# Build .deb (making use of stdeb package directory in sys.path).
python3 setup.py --command-packages=stdeb3.command bdist_deb

# Install it
sudo dpkg -i deb_dist/python-stdeb3_$STDEB3_VERSION-1_all.deb

背景

对于普通Python软件包，其源分发（使用python3 setup.py sdist创建的python_package.tar.gz）包含了制作Debian源软件包所需的几乎所有内容。这种近似等价性鼓励我编写了这个distutils扩展，它会执行setup.py文件以提取相关信息。《setuptools》可能作为可选使用。

最初我写这个是为了将我自己的几个Python包Debian化，但我觉得它可能具有普遍的实用性。在理论上，它与easydeb、Logilab的Devtools、bdist_dpkg、bdist_deb、pkgme和dh-virtualenv类似。

功能

• 为python-support支持的Python所有版本创建一个软件包。（可以通过XS-Python-Version:配置选项来限制这个范围。）

• 自动将Python包名称转换为有效的Debian包名称。

• 尝试自动转换版本号以保持排序顺序。另请参阅配置选项Forced-Upstream-Version。

• 精细控制版本号。（Debian-Version、Forced-Upstream-Version、Upstream-Version-Prefix、Upstream-Version-Suffix配置选项。）

• 安装.desktop文件。（MIME-Desktop-Files配置选项。）

• 安装.mime和.sharedmimeinfo文件。（MIME-File和Shared-MIME-File配置选项。）

• 安装版权文件。（Copyright-File配置选项。）

• 对上游源代码应用补丁。（Stdeb-Patch-File配置选项。）

• 将环境变量传递给setup.py脚本。（Setup-Env-Vars配置选项。）

自定义生成的 Debian 源包（配置选项）

stdeb将尝试提供合理的默认值，但这些只是猜测。

有两种方法可以自定义stdeb生成的Debian源包。首先，您可以为distutils命令提供选项。其次，您可以提供一个stdeb.cfg文件。

python3 setup.py --command-packages=stdeb3.command sdist_dsc --debian-version 0MyName1

[sdist_dsc]
debian-version: 0MyName1

python3 setup.py sdist_dsc --debian-version 0MyName1 bdist_deb

[DEFAULT]
Depends: python3-numpy
XS-Python-Version: >= 2.7

先决条件

• Python 3.4+

• 标准的Debian工具，如 date，dpkg-source 和 Debhelper 9（如果需要支持没有dh9的旧版本发行版，请使用stdeb 0.8.x）

• 如果您的setup.py使用setuptools功能 setup_requires 或 install_requires，则在运行任何stdeb命令之前，您必须运行 apt-file update。

待办事项

• 输出满足 Debian Python策略 规范或 新的python策略。这包括许多事情，其中包括

  • 能够将项目提供的文档作为 -doc 软件包包含在内

  • 能够将项目提供的示例、测试和数据作为单独的软件包包含在内

  • 更多未列出的内容

• 创建（更好的）文档

• 使用标准的distutils机制记录输出

• 重构源代码以具有更简单、更合理的结构

许可协议

MIT风格许可。版权（c）2006-2019 stdeb 作者。

有关详细信息，请参阅源分发中提供的LICENSE.txt文件。

作者

• Ashley Sommer <ashleysommer@gmail.com>

• Andrew Straw <strawman@astraw.com>

• Pedro Algarvio，又名，s0undt3ch <ufs@ufsoft.org>

• Gerry Reno（初始bdist_deb实现）

额外感谢

• Zooko O’Whielacronx为autofind-depends补丁。

• Brett（姓氏未知）为–ignore-install-requires补丁。

• 罗敏 Luo为错误修复。

• Alexander D. Sedov为错误修复和建议。

• Michele Mattioni为错误修复。

• Alexander V. Nikolaev为debhelper构建系统规范。

• Roland Sommer为描述字段错误修复。

• Barry Warsaw建议debianize命令。

• Asheesh Laroia更新PyPI URL。

• Piotr Ożarowski实现dh_python2支持。

• Nikita Burtsev为Unicode测试和修复。

• Mikołaj Siedlarek为错误修复。

• Dirk Thomas为–force-x-python3-version和X-Python3-Version。

• Louis为Recommends3、Suggests3、Provides3和Replaces3支持。

• kzwin为与virtualenv的互操作性。

• GitHub为托管服务。

• WebFaction（又名 python-hosting）为之前的托管服务。

• TravisCI为持续集成。