New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs broken for v1.6.0 #150

Merged
merged 5 commits into from Apr 8, 2017

Conversation

Projects
None yet
3 participants
@deanmalmgren
Owner

deanmalmgren commented Apr 8, 2017

It looks like the documentation has not been building on readthedocs since we merged in #122. It looks like readthedocs is trying to build a wheel for pocketsphinx and failing because swig isn't installed on their build servers. Any ideas what to do here @barrust?

The traceback looks like:

Building wheels for collected packages: pocketsphinx
  Running setup.py bdist_wheel for pocketsphinx: started
  Running setup.py bdist_wheel for pocketsphinx: finished with status 'error'
  Complete output from command /home/docs/checkouts/readthedocs.org/user_builds/textract/envs/v1.6.0/bin/python -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-yHiy50/pocketsphinx/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/tmpnhbraQpip-wheel- --python-tag cp27:
  running bdist_wheel
  running build_ext
  building 'sphinxbase._ad' extension
  swigging swig/sphinxbase/ad.i to swig/sphinxbase/ad_wrap.c
  swig -python -modern -Ideps/sphinxbase/include -Ideps/sphinxbase/include/sphinxbase -Ideps/sphinxbase/include/android -Ideps/sphinxbase/swig -outdir sphinxbase -o swig/sphinxbase/ad_wrap.c swig/sphinxbase/ad.i
  unable to execute 'swig': No such file or directory
  error: command 'swig' failed with exit status 1
  
  ----------------------------------------
  Failed building wheel for pocketsphinx
  Running setup.py clean for pocketsphinx
Failed to build pocketsphinx
Installing collected packages: argcomplete, XlsxWriter, python-pptx, pdfminer.six, docx2txt, beautifulsoup4, xlrd, EbookLib, pocketsphinx, SpeechRecognition, pep8, coverage, docopt, coveralls, sphinx-argparse, bumpversion, olefile, ExtractMsg
  Running setup.py install for pdfminer.six: started
    Running setup.py install for pdfminer.six: finished with status 'done'
  Found existing installation: beautifulsoup4 4.4.1
    Not uninstalling beautifulsoup4 at /usr/lib/python2.7/dist-packages, outside environment /home/docs/checkouts/readthedocs.org/user_builds/textract/envs/v1.6.0
  Found existing installation: xlrd 0.9.4
    Not uninstalling xlrd at /usr/lib/python2.7/dist-packages, outside environment /home/docs/checkouts/readthedocs.org/user_builds/textract/envs/v1.6.0
  Running setup.py install for pocketsphinx: started
    Running setup.py install for pocketsphinx: finished with status 'error'
    Complete output from command /home/docs/checkouts/readthedocs.org/user_builds/textract/envs/v1.6.0/bin/python -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-yHiy50/pocketsphinx/setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" install --record /tmp/pip-aUUoMf-record/install-record.txt --single-version-externally-managed --compile --install-headers /home/docs/checkouts/readthedocs.org/user_builds/textract/envs/v1.6.0/include/site/python2.7/pocketsphinx:
    running install
    running build_ext
    building 'sphinxbase._ad' extension
    swigging swig/sphinxbase/ad.i to swig/sphinxbase/ad_wrap.c
    swig -python -modern -Ideps/sphinxbase/include -Ideps/sphinxbase/include/sphinxbase -Ideps/sphinxbase/include/android -Ideps/sphinxbase/swig -outdir sphinxbase -o swig/sphinxbase/ad_wrap.c swig/sphinxbase/ad.i
    unable to execute 'swig': No such file or directory
    error: command 'swig' failed with exit status 1
    
    ----------------------------------------
Command "/home/docs/checkouts/readthedocs.org/user_builds/textract/envs/v1.6.0/bin/python -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-yHiy50/pocketsphinx/setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" install --record /tmp/pip-aUUoMf-record/install-record.txt --single-version-externally-managed --compile --install-headers /home/docs/checkouts/readthedocs.org/user_builds/textract/envs/v1.6.0/include/site/python2.7/pocketsphinx" failed with error code 1 in /tmp/pip-build-yHiy50/pocketsphinx/
@barrust

This comment has been minimized.

Contributor

barrust commented Apr 3, 2017

@deanmalmgren I think there are a few possible solutions.

  1. We remove the pocketsphinx dependency and use it on the command line similar to textract. This is probably a good, but not great solution.
  2. There seems to be some information about this on the autodoc site which may be useful: http://docs.readthedocs.io/en/latest/faq.html#i-get-import-errors-on-libraries-that-depend-on-c-modules

It seems that we can set those packages to not be built by using the mock module.

@coveralls

This comment has been minimized.

coveralls commented Apr 8, 2017

Coverage Status

Coverage remained the same at 91.481% when pulling 8ae8a9b on doc-build-fix into b3b9e17 on master.

@deanmalmgren deanmalmgren merged commit ecaeab3 into master Apr 8, 2017

3 checks passed

continuous-integration/travis-ci/pr The Travis CI build passed
Details
continuous-integration/travis-ci/push The Travis CI build passed
Details
pyup.io/safety-ci No dependencies with known security vulnerabilities.
Details
@deanmalmgren

This comment has been minimized.

Owner

deanmalmgren commented Apr 8, 2017

This is far from elegant, but hopefully this fixes the problem!

@deanmalmgren deanmalmgren deleted the doc-build-fix branch Apr 8, 2017

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment