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 年 2 月 18 日：版本 0.8.5。请参阅下载页面。错误修正：还原了在 virtualenv 中内置时安装到 virtualenv 中的更改。改进：添加 了 –allow-virtualenv-install-location以允许安装到 virtualenv 位置。支持 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（被子）。实际上，过去与源代码包一起提供的 .diff.gz 文件现在被 .debian.tar.gz 文件所取代。

  • 使用请求与 PyPI 交谈时验证 SSL 证书。（验证需要请求 >= 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/目录。

  • Bug修复。

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

• 2009-12-30：版本 0.5.0。请参阅下载页面。此版本的亮点（您可能还希望查阅完整的变更日志）：

  • 新的pypi-install脚本将自动从Python 包索引 (PyPI)下载、制作 .deb 并安装包。

  • 删除 setuptools 依赖项。

  • 新选项（-guess-conflicts-provides-replaces）查询原始 Debian 软件包的冲突/提供/替换信息。

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

• 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

例子

这些都假设您在系统 Python 路径中安装了 stde3b。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 。

我最初写这个是为了 Debianize 我自己的几个 Python 包，但我觉得它通常很有用。至少在理论上，它看起来与easydeb、Logilab 的 Devtools、 bdist_dpkg、bdist_deb、pkgme​​ 和dh-virtualenv相似。

特征

• 为 python-support 支持的所有 Python 版本创建一个包。（使用XS-Python-Version: config 选项可以限制这个范围 。）

• 将 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配置选项。）

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

• 将补丁应用于上游源。（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 Policy规范或新的 python policy。这将包括几件事，其中包括：

  • 将项目提供的文档作为 -doc 包包含的能力

  • 将项目提供的示例、测试和数据作为单独的包包含的能力

  • 更多未列出

• 创建（更好的）文档

• 使用标准 distutils 机制的日志输出

• 重构源代码以获得更简单、更理智的设计

执照

MIT 风格的许可证。版权所有 (c) 2006-2019 stdeb 作者。

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

作者

• Ashley Sommer < ashleysommer @ gmail 。com >

• 安德鲁·斯特劳<稻草人@astraw 。com >

• Pedro Algarvio，又名 s0undt3ch < ufs @ ufsoft 。组织>

• Gerry Reno（初始 bdist_deb 实现）

额外学分

• Zooko O'Whielacronx 用于 autofind-depends 补丁。

• Brett（姓氏不详）用于 –ignore-install-requires 补丁。

• Ximin 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用于持续集成