Как я могу заставить сборку readthedocs.org игнорировать мой файл require.txt?

У меня есть небольшой проект приложения на github, который работает в Windows и требует pythonnet.

Мой requirement.txt содержит:

beautifulsoup4==4.6
pythonnet==2.3

Теперь я подумал, что создам для него документацию и выложу на readthedocs.org. Отправив свою документацию в github и импортировав свой проект на readthedocs.org, я попытался собрать документацию, но эта операция завершилась неудачно:

Collecting pythonnet==2.3 (from -r /home/docs/checkouts/readthedocs.org/user_builds/trelloradar/checkouts/latest/requirements.txt (line 2))
Using cached pythonnet-2.3.0.tar.gz
Building wheels for collected packages: pythonnet
Running setup.py bdist_wheel for pythonnet: started
Running setup.py bdist_wheel for pythonnet: finished with status 'error'
Complete output from command /home/docs/checkouts/readthedocs.org/user_builds/trelloradar/envs/latest/bin/python -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-iU2ADR/pythonnet/setup.py';  f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" bdist_wheel -d /tmp/tmpnPH_1rpip-wheel- --python-tag cp27:
running bdist_wheel
running build
running build_ext
/bin/sh: 1: mono: not found
Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "/tmp/pip-build-iU2ADR/pythonnet/setup.py", line 405, in <module>
  zip_safe=False,
  ...
  File "/usr/lib/python2.7/subprocess.py", line 541, in check_call
  raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command 'mono tools/nuget/nuget.exe update -self' returned non-zero exit status 127 

Я понимаю, что сборка не выполняется, потому что она пытается установить материал .Net, а именно pythonnet, в среде Unix, но я просто хочу собрать документы с помощью Sphinx!

Я отключил опцию venv:

Установите свой проект внутри virtualenv, используя setup.py install

Но как мне сказать, что процесс сборки readthedocs игнорирует мой requirement.txt?


person Jacques Gaudin    schedule 12.01.2018    source источник


Ответы (1)


Я решил эту проблему, создав requirements.readthedocs.txt пустой файл и указав на него процесс сборки в дополнительных настройках на вкладке «Администратор».

Кроме того, чтобы заставить autodoc импортировать модули .Net без жалоб, я поместил в docs/conf.py следующее:

class Mock(MagicMock):
    @classmethod
    def __getattr__(cls, name):
        return MagicMock()

MOCK_MODULES = ['clr', 'System', 'System.Windows.Forms', 'System.Threading']
sys.modules.update((mod_name, Mock()) for mod_name in MOCK_MODULES)
person Jacques Gaudin    schedule 12.01.2018