question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Docs: "readthedocs" build failed

See original GitHub issue

The documentation on “Read the Docs” looks a little bit older. I saw some builds were running recently, but they were failing: https://readthedocs.org/projects/atlassian-python-api/builds/12652629/

It looks like it is trying to install the requirements-dev.txt: pip install --exists-action=w --no-cache-dir -r requirements-dev.txt. It fails then because it cannot compile a C library:

error: command 'gcc' failed with exit status 1
----------------------------------------
ERROR: Failed building wheel for kerberos

That behavior is expected:

We can’t support installing random C binaries on our system, … Source

I think the requirements from requirements-dev.txt are not required for the documentation build. I cannot see the admin configuration for the readthedocs-project. I guess you could take down the requirements file from the readthedocs project admin dashboard: Specifying Dependencies - Read the Docs.

Issue Analytics

  • State:closed
  • Created 3 years ago
  • Comments:5 (5 by maintainers)

github_iconTop GitHub Comments

2reactions
Spacetowncommented, Dec 30, 2020

The problem is that the requirement.txt was added to requirement-dev.txt. In the requirment.txt kerberos is used and it seems that the shell isn’t available on the machine. When changing the project I suggest to use a configuration file. This is also the recommend way according to the documentation.

1reaction
gonchikcommented, Dec 31, 2020

Checked - it works. Thank you guys for your contribution!

Read more comments on GitHub >

github_iconTop Results From Across the Web

build failed on read the docs · Issue #9783 · sphinx ... - GitHub
I received from read the docs (build failed). I'm not a skylled tech and I'd like to understand what kind of measures it...
Read more >
Read The Docs build failing without errors? - Stack Overflow
Today I tried building a development branch of my project on Read The Docs. The build failed. After a few hours of debugging...
Read more >
Frequently Asked Questions - Read the Docs
My project isn't building correctly¶. First, you should check out the Builds tab of your project. That records all of the build attempts...
Read more >
Read the Docs Documentation
Read the Docs will try to build the documentation of your project right after ... This means the build fails if there is...
Read more >
Build errors with docutils 0.18 - Read the Docs Blog
If your project's builds suddenly start failing with the above error message, or other cryptic errors that don't seem related to your ...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found