Как я могу получить сборку 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
?
1 ответ
Я решил это, создав requirements.readthedocs.txt
Пустой файл и укажите ему процесс сборки в дополнительных настройках на вкладке Admin.
Кроме того, чтобы получить 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)