调试 conda recipe#
Recipe 通常很难一次就完全正确。构建的某些地方会出错，构建会中断。也许您只在测试期间注意到问题，但您需要比在 conda-build 中运行测试获得的更多信息。Conda-build 3.17.0 添加了子命令 conda debug，旨在方便 recipe 的调试过程。
从根本上说，调试是一个进入或重现 conda-build 在其构建或测试过程中创建的环境和 shell 环境变量集的过程。长期以来，这都是可能的——您可以观察构建输出，找出构建文件的放置位置，导航到那里，最后激活适当的环境。然后您可能还需要手动设置一些环境变量。
conda debug 所做的是为您创建环境，并为您提供一个命令行，您可以复制/粘贴以进入调试环境。
用法#
conda debug 命令接受 2 种输入之一：recipe 文件夹或已构建包的路径。
如果提供了 recipe 文件夹的路径，conda debug 会创建构建和 host 环境。它会配置您的 recipe 指定的任何源代码。它会将构建时脚本留在工作文件夹中供您使用。完成后，conda debug 会打印如下内容
################################################################################
Build and/or host environments created for debugging. To enter a debugging environment:
cd /Users/UserName/miniconda3/conda-bld/debug_1542385789430/work && source /Users/UserName/miniconda3/conda-bld/debug_1542385789430/work/build_env_setup.sh
To run your build, you might want to start with running the conda_build.sh file.
################################################################################
如果提供了已构建包的路径，conda debug 会创建测试环境。它会准备 recipe 指定的任何测试文件。完成后，conda debug 会打印如下内容
################################################################################
Test environment created for debugging. To enter a debugging environment:
cd /Users/UserName/miniconda3/conda-bld/conda-build_1542302975704/work && source /Users/UserName/miniconda3/conda-bld/conda-build_1542302975704/work/build_env_setup.sh
To run your tests, you might want to start with running the conda_test_runner.sh file.
################################################################################
后续步骤#
鉴于上面的输出，您现在可以进入环境开始调试。从您的终端复制粘贴并开始
cd /Users/UserName/miniconda3/conda-bld/debug_1542385789430/work && source /Users/UserName/miniconda3/conda-bld/debug_1542385789430/work/build_env_setup.sh
在这里，您应该知道要运行哪些构建命令来帮助您调试。每个构建都不同，因此您的体验会有所不同。但是，如果您完全没有头绪，您可能可以从运行输出中提到的适当的构建或测试脚本开始。如果您这样做，请记住这些脚本可能被编写为在出错时退出，这可能会关闭您的 shell 会话。明智的做法是仅在显式的子 shell 中运行这些脚本
bash conda_build.sh
bash conda_test_runner.sh
多输出的复杂性#
多输出有效地为 recipe 提供了许多要考虑的构建阶段。--output-id 参数是指定应使用其中哪些输出创建调试环境和脚本的机制。--output-id 参数接受 fnmatch 模式。您可以匹配输出文件名的任何部分。这实际上仅适用于 conda 包，不适用于其他输出类型（例如 wheel），因为 conda-build 目前无法在不实际执行构建的情况下预测其文件名。
例如，我们的 NumPy recipe 有多个输出。如果我们想调试 NumPy-base 输出，我们将使用如下命令指定它
conda debug numpy-feedstock --output-id="numpy-base*"
如果您有矩阵构建，您可能需要更具体
Specified --output-id matches more than one output (['/Users/msarahan/miniconda3/conda-bld/debug_1542387301945/osx-64/numpy-base-1.14.6-py27h1a60bec_4.tar.bz2', '/Users/msarahan/miniconda3/conda-bld/debug_1542387301945/osx-64/numpy-base-1.14.6-py27h8a80b8c_4.tar.bz2', '/Users/msarahan/miniconda3/conda-bld/debug_1542387301945/osx-64/numpy-base-1.14.6-py36h1a60bec_4.tar.bz2', '/Users/msarahan/miniconda3/conda-bld/debug_1542387301945/osx-64/numpy-base-1.14.6-py36h8a80b8c_4.tar.bz2', '/Users/msarahan/miniconda3/conda-bld/debug_1542387301945/osx-64/numpy-base-1.14.6-py37h1a60bec_4.tar.bz2', '/Users/msarahan/miniconda3/conda-bld/debug_1542387301945/osx-64/numpy-base-1.14.6-py37h8a80b8c_4.tar.bz2']). Please refine your output id so that only a single output is found.
您可以减少矩阵，方法是更改您的 conda_build_config.yaml，或者创建一个更简单的文件并通过 CLI 传递它，或者使用 CLI 来减少它。
conda debug numpy-feedstock --output-id="numpy-base*" --python=3.6 --variants="{blas_impl: openblas}"
Specified --output-id matches more than one output (['/Users/UserName/miniconda3/conda-bld/debug_1542387443190/osx-64/numpy-base-1.14.6-py36h28eea48_4.tar.bz2', '/Users/UserName/miniconda3/conda-bld/debug_1542387443190/osx-64/numpy-base-1.14.6-py36ha711998_4.tar.bz2']). Please refine your output id so that only a single output is found.
但是，这仍然不够，因为我们的矩阵包括两种 BLAS 实现：MKL 和 OpenBLAS。
进一步减少
conda debug numpy-feedstock --output-id="numpy-base*" --python=3.6 --variants="{blas_impl: 'openblas'}"
清理#
调试文件夹的命名方式使 conda build purge 命令可以找到并清理它们。如果您使用 -p/--path CLI 参数，conda-build 将不会检测到这些文件夹，您需要手动清理它们。conda build purge-all 也会删除以前构建的包。
特性#
您可以使用 -p/--path CLI 参数指定您希望调试内容的根目录位置。其工作方式是 conda-build 将其视为“croot”，包在其中根据需要进行缓存，并可能被索引。当使用 --path 参数时，您可能会在指定的路径中看到类似“osx-64”或其他平台子目录的文件夹。移除或忽略它们是安全的。