[Bug] Cannot build python3 bindings documentation of notmuch 0.28.1

classic Classic list List threaded Threaded
3 messages Options
Dan Čermák Dan Čermák
Reply | Threaded
Open this post in threaded view
|

[Bug] Cannot build python3 bindings documentation of notmuch 0.28.1

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:

$ 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
[hidden email]
https://notmuchmail.org/mailman/listinfo/notmuch

signature.asc (847 bytes) Download Attachment
Jani Nikula Jani Nikula
Reply | Threaded
Open this post in threaded view
|

Re: [Bug] Cannot build python3 bindings documentation of notmuch 0.28.1

On Wed, 06 Feb 2019, Dan Čermák <[hidden email]> 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
> [hidden email]
> https://notmuchmail.org/mailman/listinfo/notmuch
_______________________________________________
notmuch mailing list
[hidden email]
https://notmuchmail.org/mailman/listinfo/notmuch
David Bremner-2 David Bremner-2
Reply | Threaded
Open this post in threaded view
|

Re: [Bug] Cannot build python3 bindings documentation of notmuch 0.28.1

In reply to this post by Dan Čermák
[hidden email] (Dan Čermák) writes:

> 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:
>
> $ cd bindings/python/docs/
> $ make dirhtml
> sphinx-build -b dirhtml -d build/doctrees   source build/dirhtml
> Running Sphinx v1.7.6

I have queued Jani's fix [1] for this; I'll probably make another point
release if no one objects.  This has the side-effect of requiring python
3.3 to build the bindings, but this is probably inconvenient for less
people than breaking with python 3.7.

[1]: https://nmbug.notmuchmail.org/nmweb/show/20190211182237.32201-1-jani%40nikula.org
_______________________________________________
notmuch mailing list
[hidden email]
https://notmuchmail.org/mailman/listinfo/notmuch