[Bug] Cannot build python3 bindings documentation of notmuch 0.28.1

[Jani Nikula]

On Wed, 06 Feb 2019, Dan Čermák <dan.cermak at posteo.net> wrote:
> Hi list,
>
> the python3 bindings documentation seems to be broken:
>
> on OpenSUSE Tumbleweed and Fedora 29 (both have Python 3.7 and sphinx
> 1.7.6) I get this:

Looks like a change in Python 3.7 makes the ctypes mocking in
bindings/python/docs/source/conf.py fall short. If you just remove
'ctypes' from MOCK_MODULES, it'll work.

However, that would probably break the documentation build at
readthedocs.org, which won't have libnotmuch around.

Short term, I guess someone(tm) has to hack the mocking.

Long term, I'd love to see the python bindings Sphinx documentation
merged to the main Sphinx notmuch documentation, and have all of that
get automatically built and updated to notmuchmail.org.


BR,
Jani.


>
> $ cd bindings/python/docs/
> $ make dirhtml
> sphinx-build -b dirhtml -d build/doctrees   source build/dirhtml
> Running Sphinx v1.7.6
>
> Configuration error:
> There is a programable error in your configuration file:
>
> Traceback (most recent call last):
>   File "/usr/lib/python3.7/site-packages/sphinx/config.py", line 161, in __init__
>     execfile_(filename, config)
>   File "/usr/lib/python3.7/site-packages/sphinx/util/pycompat.py", line 150, in execfile_
>     exec_(code, _globals)
>   File "conf.py", line 39, in <module>
>     from notmuch import __VERSION__,__AUTHOR__
>   File "/home/dan/packages/git.notmuchmail.org/git/notmuch/bindings/python/notmuch/__init__.py", line 54, in <module>
>     from .database import Database
>   File "/home/dan/packages/git.notmuchmail.org/git/notmuch/bindings/python/notmuch/database.py", line 25, in <module>
>     from .globals import (
>   File "/home/dan/packages/git.notmuchmail.org/git/notmuch/bindings/python/notmuch/globals.py", line 48, in <module>
>     class NotmuchDatabaseS(Structure):
> TypeError: __mro_entries__ must return a tuple
>
> make: *** [Makefile:38: dirhtml] Error 2
>
>
> Cheers,
>
> Dan
> _______________________________________________
> notmuch mailing list
> notmuch at notmuchmail.org
> https://notmuchmail.org/mailman/listinfo/notmuch