AttributeError: No such element: flowables in <rinoh.frontend.sphinx.nodes.Emphasis object>

[m-aciek]

Is there an existing issue for this?

• I have searched the existing issues

Sphinx or rinoh output

Last Messages
=============

     c-api/memory
     c-api/objimpl
      c-api/allocation
      c-api/lifecycle
      c-api/structures
      c-api/typeobj
      c-api/gcsupport
     c-api/apiabiversion
     c-api/monitoring
    resolving references...

Loaded Extensions
=================

* sphinx.ext.mathjax (8.2.3)
* alabaster (1.0.0)
* sphinxcontrib.applehelp (2.0.0)
* sphinxcontrib.devhelp (2.0.0)
* sphinxcontrib.htmlhelp (2.1.0)
* sphinxcontrib.serializinghtml (2.0.0)
* sphinxcontrib.qthelp (2.0.0)
* audit_events (2.0)
* availability (1.0)
* c_annotations (1.0)
* changes (1.0)
* glossary_search (1.0)
* grammar_snippet (1.0)
* implementation_detail (1.0)
* issue_role (1.0)
* lexers (1.0)
* misc_news (1.0)
* pydoc_topics (1.0)
* pyspecific (1.0)
* sphinx.ext.coverage (8.2.3)
* sphinx.ext.doctest (8.2.3)
* sphinx.ext.extlinks (8.2.3)
* notfound.extension (1.0.4)
* sphinxext.opengraph (0.12.0)
* rinoh.frontend.sphinx (0.5.6)

Traceback
=========

    Traceback (most recent call last):
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/sphinx/cmd/build.py", line 432, in build_main
        app.build(args.force_all, args.filenames)
        ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/sphinx/application.py", line 426, in build
        self.builder.build_update()
        ~~~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/sphinx/builders/__init__.py", line 372, in build_update
        self.build(['__all__'], summary=to_build, method='update')
        ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/sphinx/builders/__init__.py", line 454, in build
        self.write(docnames, updated_docnames, method)
        ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/sphinx/__init__.py", line 257, in write
        self.write_document(entry)
        ~~~~~~~~~~~~~~~~~~~^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/sphinx/__init__.py", line 263, in write_document
        rinoh_document = self.construct_rinohtype_document(data)
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/sphinx/__init__.py", line 279, in construct_rinohtype_document
        rinoh_tree = from_doctree(doctree, sphinx_builder=self)
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 150, in from_doctree
        return mapped_tree.flowable()
               ~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 152, in flowable
        flowable, = self.flowables()
        ^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 182, in build_flowable
        return self.grouped_flowables_class(self.children_flowables(),
                                            ~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in children_flowables
        return list(chain(*(item.flowables() for item in children)))
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 182, in build_flowable
        return self.grouped_flowables_class(self.children_flowables(),
                                            ~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in children_flowables
        return list(chain(*(item.flowables() for item in children)))
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/sphinx/nodes.py", line 263, in build_flowable
        return super().build_flowable(id='%' + self.get('docname'), **kwargs)
               ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 182, in build_flowable
        return self.grouped_flowables_class(self.children_flowables(),
                                            ~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in children_flowables
        return list(chain(*(item.flowables() for item in children)))
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 182, in build_flowable
        return self.grouped_flowables_class(self.children_flowables(),
                                            ~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in children_flowables
        return list(chain(*(item.flowables() for item in children)))
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 182, in build_flowable
        return self.grouped_flowables_class(self.children_flowables(),
                                            ~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in children_flowables
        return list(chain(*(item.flowables() for item in children)))
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 182, in build_flowable
        return self.grouped_flowables_class(self.children_flowables(),
                                            ~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in children_flowables
        return list(chain(*(item.flowables() for item in children)))
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/sphinx/nodes.py", line 320, in build_flowable
        description = self.desc_content.flowable()
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 152, in flowable
        flowable, = self.flowables()
        ^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/rst/__init__.py", line 107, in flowables
        for flowable in super().flowables():
                        ~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 157, in flowables
        for i, flowable in enumerate(self.build_flowables()):
                           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 166, in build_flowables
        yield self.build_flowable()
              ~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 182, in build_flowable
        return self.grouped_flowables_class(self.children_flowables(),
                                            ~~~~~~~~~~~~~~~~~~~~~~~^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in children_flowables
        return list(chain(*(item.flowables() for item in children)))
                    ~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 145, in <genexpr>
        return list(chain(*(item.flowables() for item in children)))
                            ^^^^^^^^^^^^^^
      File "/Users/m-aciek/projects/cpython/Doc/venv/lib/python3.13/site-packages/rinoh/frontend/__init__.py", line 62, in __getattr__
        raise AttributeError('No such element: {} in {}'.format(name, self))
    AttributeError: No such element: flowables in <rinoh.frontend.sphinx.nodes.Emphasis object at 0x150548c20>

Source files

https://github.com/python/cpython/tree/3.14/Doc

Versions

* Platform:         darwin; (macOS-26.0.1-x86_64-i386-64bit-Mach-O)
* Python version:   3.13.0 (CPython)
* Sphinx version:   8.2.3
* Docutils version: 0.21.2
* Jinja2 version:   3.1.6
* Pygments version: 2.19.2

[brechtm]

I tracked this down to this reStructuredText in c-api/intro.rst:

.. c:type:: Py_ssize_t

   A signed integral type such that ``sizeof(Py_ssize_t) == sizeof(size_t)``.
   C99 doesn't define such a thing directly (size_t is an unsigned integral type).
   See :pep:`353` for details. ``PY_SSIZE_T_MAX`` is the largest positive value
   of type :c:type:`Py_ssize_t`.

The function add_annotations in Doc/tools/extensions/c_annotations.py inserts an emphasis node into a desc_content node. This produces an invalid document tree, since the desc_content node is a docutils Element and is not supposed to have children that are text or inline elements. To fix this, the emphasis node needs to be wrapped in a paragraph node. rinohtype is more picky about the docutils tree it receives compared to other builders (such as HTML and LaTeX) and fails on this.

Unfortunately, the validity of the docutils tree is not checked by docutils or Sphinx before it is passed to rinohtype.