sphinx-contrib / aafig Goto Github PK

I started to do doc building in parallel using -j auto, and aafig raises the following warnings:

WARNING: the sphinxcontrib.aafig extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit
WARNING: doing serial read

The relevant sphinx extension documentation is here: https://www.sphinx-doc.org/en/1.5.1/extdev/#extension-metadata

Essentially you can declare aafig safe for parallel reading by adding this to setup():

parallel_read_safe=True

The question is if aafig is parallel read safe? If it is, I can submit a CR to get this added to the setup.

On one of my build servers, I am getting this exception when building the latex documentation using sphinx:

Extension error:
Handler <function render_aafig_images at 0x7f18d7786b80> for event 'doctree-read' threw an exception (exception: 'LaTeXBuilder' object has no attribute 'warn')
ninja: build stopped: subcommand failed.

I am using the following packages:

Name: Sphinx
Version: 3.2.1

Name: sphinxcontrib-aafig
Version: 1.0

Name: aafigure
Version: 0.6

This is strange, since on another server that I have configured some time ago, I'm not seeing the error.

What other logging can I enable to give you more details or to help solve the problem?

Hi !

It would be nice to release on Pypi the latest version since it adds the compatibility with Python3, now that Python2 supports has officially ended.

Best

Any chance of Python 3 support?

This project used to upload documentation to pypi directly, but that doesn't seem to exist anymore. A new hosting method should be used, probably readthedocs.org.

This is mainly a heads up for people that might have forked this repo, to know they should update their default branch too.

The reasons for the change are very well explained here: https://sfconservancy.org/news/2020/jun/23/gitbranchname/

There might be many places where documentation and tools needed to build and upload this project got outdated.

Here is a (non-comprehensive) list of keywords to search for places that need update:

• http://pypi.python.org -> https://pypi.org
• http://sphinx.pocoo.org -> https://www.sphinx-doc.org
• http://packages.python.org/sphinxcontrib-aafig/ now points to pythonhosted.org which is not supported anymore (#9)
• hg -> git (#8)
• python setup.py register / python setup.py upload -> twine upload (#11)