-
Notifications
You must be signed in to change notification settings - Fork 77
Fix ReadTheDocs Builds #271
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
Conversation
Codecov Report
❗ Your organization is not using the GitHub App Integration. As a result you may experience degraded service beginning May 15th. Please install the Github App Integration for your organization. Read more. @@ Coverage Diff @@
## main #271 +/- ##
=======================================
Coverage 99.01% 99.01%
=======================================
Files 26 26
Lines 3958 3958
=======================================
Hits 3919 3919
Misses 39 39
|
addressing https://stackoverflow.com/a/56469300 (sphinx >=1.3)
this should fail the readthedocs build: https://readthedocs.org/projects/python-driver-for-arangodb/builds/
(the less changes the better)
| @@ -0,0 +1,3 @@ | |||
| requests_toolbelt | |||
| importlib_metadata | |||
| jwt | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is required to support the sphinx autodoc functionality (for example, see the following no module named 'jwt' error: https://readthedocs.org/projects/python-driver-for-arangodb/builds/21620433/)
fixes #272
Address the ReadTheDocs migration required as indicated by recent builds (which have also been silently failing):
Image
This is done by introducing a
.readthedocs.yamlfileSee https://blog.readthedocs.com/migrate-configuration-v2/
Preview the fixed API Spec page: https://docs.python-arango.com/en/fix-readthedocs/specs.html