-
Notifications
You must be signed in to change notification settings - Fork 2
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
Read the Docs apt module page is empty #48
Comments
http://apt.readthedocs.org/en/latest/apt.html the page is empty. Build error indicates failed import of ctypes is the problem. --- Also reword copyright and author info, because "© Copyright 2015, Matt Wilkie, shoulders of giants." just doesn't work. Supposed to be "because of standing on shoulders of giants", but that just doesn't work in this context. ;-)
test https://readthedocs.org/builds/apt/2958055/ failed.
I think this means |
requirements.txt is doc-specific, not for whole project, so don't need it at roor. Also, needed to activate venv on Admin Advanced Settings page (https://readthedocs.org/dashboard/apt/advanced/); was misled into thinking that was already set because the previous biuld error messages already mentioned venv.
...nope, still fails. much longer output though in addition to the same as above, not going to post all, here's the source: https://readthedocs.org/builds/apt/2958092/ However from "Requirement already satisfied (use --upgrade to upgrade): mock in /home/docs/checkouts/..." I think we can conclude requirement.txt is not the issue. |
...kind of a pointless nicety since neither seem to work, but...
Mock import now works, yay! but it looks like mock itself might need some patching.
which leads to only 3 search hits, the most relevant about Mock missing (at least) a true division operator: https://mail.python.org/pipermail/python-bugs-list/2014-March/235709.html I might have to give up on using automatic RTD and build and upload from local machine. :-/ |
...as per suggestion on Python.org bug tracker http://bugs.python.org/issue16396 Another run at #48
After previous commit RTD build worked, and module docs pages were built as well.
RTD requires modules relying on Windows-only DLLs etc. be "mocked". It doesn't need to be able to actually run the code, just process for docstrings etc. Initially I thought it was ctypes itself that needed to be mocked, but it turns out I needed to work closer to home and _mock the module which calls ctypes_, `knownpaths.py`. Thank you to @Dunes on Stack Overflow, whose comment I thought was off-track and not going to help. However it gave just enough of a turning to my mind and path of investigation to land me in the right place after all. Not all teachings look like teaching! http://stackoverflow.com/questions/30950870/mock-import-of-ctypes-fails-with-unsupported-operand-on-read-the-docs
When I build the sphinx docs locally with
make html
there is a module page populated with content, but at http://apt.readthedocs.org/en/latest/apt.html the page is empty.http://imgur.com/fo9TIYm
Under Builds, https://readthedocs.org/builds/apt/2900858/, there is an error with ctypes.
The text was updated successfully, but these errors were encountered: