由于内存消耗，精神病患者无法读取DOCS构建

Question

我有一个项目（https://github.com/jfkominsky/PyHab），它本质上是精神病（http://psychopy.org/）的扩展。我想用Sphinx和ReadTheDocs来编写代码文档。我在文档中使用了Sphinx的自动类特性，其中大部分都包含在代码中，这在本地构建中非常有效。在ReadTheDocs上，这意味着我需要添加一个带有psychopy的需求文件。这将导致生成以以下方式失败：

/home/docs/checkouts/readthedocs.org/user_builds/pyhab/envs/latest/bin/pip install --exists-action=w --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/pyhab/.cache/pip -rdocs/requirements.txt
Command killed due to excessive memory consumption

我在这方面很业余。有没有办法使用设置.py虚拟环境让精神病患者工作？readthedocs是不是太吝啬了？我注意到精神病本身有一些问题与RTD建设现在，不确定如果这是相关的。。。你知道吗

编辑：我应该补充一下，我在RTD中使用Cpython2作为我的环境。当我使用CPython3时，我得到了一个不同的失败：

我再次尝试使用Py3，但出现了另一个错误：

ERROR: failed building wxWidgets Traceback (most recent call last): File "build.py", line 1321, in cmd_build_wx wxbuild.main(wxDir(), build_options) File "/tmp/pip-build-7a1lqn7v/wxPython/buildtools/build_wxwidgets.py", line 374, in main "Error running configure") File "/tmp/pip-build-7a1lqn7v/wxPython/buildtools/build_wxwidgets.py", line 85, in exitIfError raise builder.BuildError(msg) buildtools.builder.BuildError: Error running configure Finished command: build_wx (0m10.842s) Finished command: build (0m10.842s) Command '"/home/docs/checkouts/readthedocs.org/user_builds/pyhab/envs/latest/bin/python" -u build.py build' failed with exit code 1.

Answer 1

我已经设计了一个解决方案，至少对CPython2.x来说是这样的。RTD需要更好地宣传这个解决方案的长与短之处在于，你可以把一堆“mock”塞进形态py为了绕过编译文档时不希望实际导入的模块。您需要在2.7中的需求文件中使用mock（大概是单元测试.mock在3.x中）

这个想法来自这里：http://blog.rtwilson.com/how-to-make-your-sphinx-documentation-compile-with-readthedocs-when-youre-using-numpy-and-scipy/

它在FAQ中连接回这个：http://read-the-docs.readthedocs.io/en/latest/faq.html#i-get-import-errors-on-libraries-that-depend-on-c-modules

我意识到您可以为任何东西创建模拟模块，如果您使用MagicMock，您可以根据需要向它们添加属性。我试了几次才得到所有正确的模拟模块（主要是因为RTD环境很难在本地进行模拟，它只会在错误消息中向您显示它未能导入的第一个模块），但最终，我说服了RTD，它在不超过内存限制的情况下拥有了所需的一切。你知道吗

这个解决方案不是针对精神病的。这将适用于任何你有麻烦pip安装RTD。你知道吗