docutils: add nodes.Text

Author: not-my-profile

stubs/docutils/@tests/stubtest_allowlist.txt

@@ -18,3 +18,7 @@ docutils.utils.Reporter.__getattr__
 
 # the constructor appears to be mostly internal API, public API users are meant to use docutils.utils.new_reporter instead
 docutils.utils.Reporter.__init__
+
+# these methods take a rawsource parameter that has been deprecated and is completely ignored, so we omit it from the stub
+docutils.nodes.Text.__new__
+docutils.nodes.Text.__init__

stubs/docutils/docutils/nodes.pyi

@@ -94,6 +94,17 @@ class Element(Node):
     def __iadd__(self: Self, other: Node | Iterable[Node]) -> Self: ...
     def __getattr__(self, __name: str) -> Any: ...  # incomplete
 
+class Text(Node, str):
+    tagname: str
+    children: tuple[()]
+
+    # we omit the rawsource parameter because it has been deprecated and is ignored
+    def __new__(cls: type[Self], data: str) -> Self: ...
+    def __init__(self, data: str) -> None: ...
+    def shortrepr(self, maxlen: int = ...) -> str: ...
+    def rstrip(self, chars: str | None = ...) -> str: ...
+    def lstrip(self, chars: str | None = ...) -> str: ...
+
 class Structural: ...
 class Root: ...