Wednesday, September 19, 2018

autodoc_default_flags is now deprecated

We got an exception SphinxWarning: autodoc_default_flags is now deprecated. Please use autodoc_default_options instead. on two different places at the same day:

But on my machine no problem. The problem seems to be that atelier.sphinxconf sets wrong default settings for autodoc. At first I suspected something going wrong with the code that tests whether Sphinx is before 1.8 or not.

>>> from distutils.version import LooseVersion
>>> import sphinx
>>> sphinx.__version__
'1.8.0'
>>> LooseVersion(sphinx.__version__)
LooseVersion ('1.8.0')
>>> LooseVersion("1.8.0") < LooseVersion('1.8')
False

But Aris confirmed that above code runs on his machine as well as on mine.

Ha! The explanation is simple: the change that checks for the Sphinx version was not yet released! Now I released atelier 1.1.9. See Changes in atelier.

Sphinx 1.8 causes UnicodeDecodeError in feedformatter

I am still getting UnicodeDecodeError: 'ascii' codec can't decode byte 0xc3 in position 7: ordinal not in range(128) (#2534). I thought that os.environ['LC_TIME'] = 'en_GB.UTF-8' in my conf.py would fix it, but that was a mistake (the problem occurs only in my blog, and ATM I can avoid it only by saying export LC_TIME=en_GB.UTF-8 before running inv bd.

I still don’t understand why Sphinx (as it seems) changes the Python locale, but I understand that the Sphinx developers probably have more urgent problems than discussing this. And actually it is mainly a problem in feedformatter. Fixing it seems trivial, but how will I get this to PyPI? So now I contacted the author Luke Maurits:

Hi Luke,

thanks for your work on feedformatter. I see in the Google code archive that your priority for maintaining this project is low. Understandable. Now I have a subtle problem with feedformatter, and I would submit a patch. But before doing so, I wanted to ask you whether you still agree to maintain the project. Because I also see that other people have forked it on GitHub.

Lino Tera

I continued to work on #2492 but without pushing anything.