OpenStack should be buildable with sphinx 2.4: FTBFS in many packages
zigo at debian.org
Sun Mar 29 08:01:16 UTC 2020
On 3/29/20 5:47 AM, Akihiro Motoki wrote:
> On Sun, Mar 29, 2020 at 7:36 AM Thomas Goirand <zigo at 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 at 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:
>> For os-api-ref, here:
>> 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! :)
Thomas Goirand (zigo)
More information about the openstack-discuss