OpenStack should be buildable with sphinx 2.4: FTBFS in many packages

Thomas Goirand 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:
>> 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)



More information about the openstack-discuss mailing list