On 3/29/20 5:47 AM, Akihiro Motoki wrote:
On Sun, Mar 29, 2020 at 7:36 AM Thomas Goirand <zigo@debian.org> wrote:
Hi there!
Thanks for your reply.
On 3/28/20 10:05 PM, Akihiro Motoki wrote:
On Sat, Mar 28, 2020 at 6:34 PM Thomas Goirand <zigo@debian.org> wrote:
Sphinx 2.4 has been uploaded to Experimental. I just received bug reports against the OpenStack packages because some of them cannot be built with Sphinx 2.4. Here's the list:
- ironic - os-api-ref
I can build the document with sphinx 2.4.4.
For Ironic, the bug report is here: https://bugs.debian.org/955069
For os-api-ref, here: https://bugs.debian.org/955098
the bug in os-api-ref is *not* in its documentation, but in os-api-ref itself, unfortunately (failure to run unit tests...).
All os-api-ref unittests succeed in the OpenStack CI. For example, https://zuul.opendev.org/t/openstack/build/af69856854424ef59d7b096f4dbffc1b It uses sphinx 2.4.4 and sphinx-testing 1.0.1.
At a quick look of sphinx-testing, os-api-ref tests only works with os-api-ref>=1.0.1, while test-requirements.txt says os-api-ref>=0.7.2. read_text() method is from sphinx_testing.path.path class, but up to sphinx-testing 1.0.0 str is returned as app.outdir. The simplest solution would be to update test-requirements.txt to os-api-ref>=1.0.1 to clarify the requirements. Perhaps Debian testing uses sphinx-testing <1.0.1.
Oh, this is super useful, thanks! Indeed, sphinx-testing is in version 0.8.1 in Debian Sid. So I guess my next course of action is to reassign the bug to sphinx-testing. One thing less to take care of! :) Cheers, Thomas Goirand (zigo)