Failure to process classifiers as part of consolidation fields in a reStructuredText docstring

[juur]

Using pydoctor 23.9.1 under Python 3.11.5, executing with args pydoctor --quiet --make-html --html-output docs --process-types --intersphinx-cache-path ./.sphinx-cache src/pyerp

The following snippet works fine:

"""A BusinessUnit is a top level organisational container.

:CVariables:
    `id`
        unique serial for this entity
"""

However, the following snippet generates an error:

"""A BusinessUnit is a top level organisational container.

:CVariables:
    `id` : int
        unique serial for this entity
"""

The error is:

bad docstring: Unexpected element in type specification field: element 'Text'. This value should only contain regular paragraphs with text or inline markup.

Based on the documentation, I believe this to be a bug as the classifiers should be processed in a definition list.

[tristanlatr]

Thanks for the bug report, it is linked to the —process-types options, it seem there is a bug Indeed.

[tristanlatr]

So here is the deal:

pydoctor/pydoctor/epydoc/markup/_types.py

Line 79 in 9becf85

"This value should only contain regular paragraphs with text or inline markup.")

We do not account for the cases where a Text node is directly put inside the document node. Which is what happened with consolidated fields. It should be a very quick fix.