Wheelhouse 0.1.4

什么是Wheelhouse？

Wheelhouse是一个本地缓存的Python包，以wheel格式提交到你的VCS。在持续集成和生产过程中安装包时，使用Wheelhouse中的wheel而不是依赖于PyPI或其他网络位置。

示例用法

wheelhouse build

vex -mr myproj # or: mktmpenv
wheelhouse install -- -r requirements/dev-env.txt
pip install -e .

示例项目

这个项目的代码相当基础，但重要的是概念。将wheelhouse的概念付诸实践，使我们在开发、测试和生产环境中管理项目依赖关系变得容易得多。

查看Keg以查看一个使用wheelhouse并结合tox来管理依赖的项目。

当前功能

• build：将构建所有配置文件中指定的要求文件中的所有包，并存储在wheelhouse目录中。也可以传递单个包或别名的名称。

• config：显示wheelhouse使用的配置。

• purge：清除wheelhouse中任何不是该包在wheelhouse中最新的版本的所有轮子。

可能未来的功能

• install：从wheelhouse安装包/轮子。

• status：将工作环境安装的包与要求文件、wheelhouse和包索引（PyPI）进行比较，并显示它们不一致的地方。

pip 配置

一旦有了wheelhouse（运行wheelhouse build），就可以告诉pip只从wheelhouse安装。要使用环境变量和tox.ini来完成此操作，将如下所示

# tox.ini
[testenv]
setenv =
    PIP_USE_WHEEL=true
    PIP_NO_INDEX=true
    PIP_FIND_LINKS=requirements/wheelhouse

或者，从命令行

pip install --use-wheel --no-index --find-links=requirements/wheelhouse -r requirements/testing.txt

配置

您必须在项目的根目录下放置一个wheelhouse.ini。这被认为是“项目根”，所有相对文件路径都是从该位置计算的。

您还可以在用户特定的位置放置一个wheelhouse.ini文件以覆盖Wheelhouse的默认值。有关更多信息，请参阅wheelhouse config。

配置文件由SafeConfigParser实例读取。有关可用的插值支持，请参阅相关文档。

以下是一个配置文件的示例

[wheelhouse]
# These files are relative to the project's requirements directory (default: `requirements/`).
requirement_files =
    build.txt

# Make sure each package has a wheel built for python 2 & 3.
pip_bins = pip, pip3.4

[aliases]
# Shortcuts to be used when specifying projects to `build`.
keg = https://github.com/level12/keg/zipball/master
ke = https://github.com/level12/keg-elements/zipball/master

问题 & 讨论

请将问题、评论、错误、功能请求等发送到：https://github.com/level12/wheelhouse/issues

当前状态

非常Beta，预期会有变化。

开发

要在本项目中开发，请首先运行我们的测试

git clone https://github.com/level12/wheelhouse wheelhouse-src
cd wheelhouse-src
tox

然后您可以检查tox.ini以了解我们的开发过程。特别是，我们

• 使用py.test进行测试（以及覆盖率分析）

• 使用flake8进行linting

• 将pip要求文件存储在requirements/

• 在requirements/wheelhouse中缓存轮子以实现更快速和更可靠的CI构建

变更日志