Maybe this issue should be handled at the Twisted level, here:

twisted/src/twisted/web/_template_util.py

Line 387 in f28b36d

class _ToStan(handler.ContentHandler, handler.EntityResolver):

By adding the a correct resolveEntity method to the _ToStan class. Right now there is no resolveEntity() method defined at all.

What do you think @adiroiban ?

(Here's the trace):

Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/twisted/web/_flatten.py", line 321, in _flattenTree
    element = next(stack[-1])
  File "/usr/lib/python3/dist-packages/twisted/web/_flatten.py", line 237, in _flattenElement
    result = renderMethod(request, rootClone)
  File "/usr/lib/python3/dist-packages/pydoctor/templatewriter/pages/functionchild.py", line 73, in functionBody
    return self.docgetter.get(self.ob)
  File "/usr/lib/python3/dist-packages/pydoctor/templatewriter/pages/__init__.py", line 71, in get
    return epydoc2stan.format_docstring(ob)
  File "/usr/lib/python3/dist-packages/pydoctor/epydoc2stan.py", line 744, in format_docstring
    fh.handle(Field.from_epydoc(field, source))
  File "/usr/lib/python3/dist-packages/pydoctor/epydoc2stan.py", line 600, in handle
    m(field)
  File "/usr/lib/python3/dist-packages/pydoctor/epydoc2stan.py", line 529, in handle_type
    self.types[name] = field.format()
  File "/usr/lib/python3/dist-packages/pydoctor/epydoc2stan.py", line 353, in format
    return self.body.to_stan(_EpydocLinker(self.source))
  File "/usr/lib/python3/dist-packages/pydoctor/epydoc/markup/__init__.py", line 134, in to_stan
    self._stan = Tag('', children=node2stan.node2stan(self.to_node(), docstring_linker).children)
  File "/usr/lib/python3/dist-packages/pydoctor/node2stan.py", line 42, in node2stan
    return html2stan(''.join(html))
  File "/usr/lib/python3/dist-packages/pydoctor/stanutils.py", line 30, in html2stan
    stan = XMLString(b'<div>%s</div>' % html).load()[0]
  File "/usr/lib/python3/dist-packages/twisted/web/template.py", line 402, in __init__
    self._loadedTemplate = _flatsaxParse(NativeStringIO(s))
  File "/usr/lib/python3/dist-packages/twisted/web/template.py", line 356, in _flatsaxParse
    parser.parse(fl)
  File "/usr/lib/python3.9/xml/sax/expatreader.py", line 111, in parse
    xmlreader.IncrementalParser.parse(self, source)
  File "/usr/lib/python3.9/xml/sax/xmlreader.py", line 125, in parse
    self.feed(buffer)
  File "/usr/lib/python3.9/xml/sax/expatreader.py", line 221, in feed
    self._err_handler.fatalError(exc)
  File "/usr/lib/python3.9/xml/sax/handler.py", line 38, in fatalError
    raise exception
xml.sax._exceptions.SAXParseException: <unknown>:1:46: undefined entity

Support XHTML entities in XMLString #11581

Description

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions