# pip install docutils

parser = docutils.parsers.rst.Parser()

settings = docutils.frontend.get_default_settings(docutils.parsers.rst.Parser)                                                       

document = docutils.utils.new_document('<rst-doc>', settings)

parser.parse('Called for "reference" nodes.', document)

import docutils.parsers.rst
import docutils.utils
import docutils.frontend

def parse_rst(text: str) -> docutils.nodes.document:                                                                                                     
    parser = docutils.parsers.rst.Parser()                                                                               
    if hasattr(docutils.frontend, 'get_default_settings'):
        # docutils >= 0.18
        settings = docutils.frontend.get_default_settings(docutils.parsers.rst.Parser)                                                       
    else:
        # docutils < 0.18
        settings = docutils.frontend.OptionParser(components=(docutils.parsers.rst.Parser,)).get_default_values()
    document = docutils.utils.new_document('<rst-doc>', settings=settings)                                               
    parser.parse(text, document)                                                                                         
    return document

import docutils.parsers.rst
import docutils.utils
import docutils.frontend

class MyVisitor(docutils.nodes.NodeVisitor):

    def visit_reference(self, node: docutils.nodes.reference) -> None:
        """Called for "reference" nodes."""
        print(node)

    def unknown_visit(self, node: docutils.nodes.Node) -> None:
        """Called for all other node types."""
        pass

doc = parse_rst('spam spam lovely spam')
visitor = MyVisitor(doc)
doc.walk(visitor)

from docutils.core import publish_doctree
source = 'Hello *world*'
tree = publish_doctree(source)

tree

for x in tree:
    print(x)

content='''
#测试

##测试1

###测试2

####测试4 
'''
with open('xx_test.rst', 'w', encoding='utf-8') as f:
        f.write(content)
print("已生成测试RST文件xx_test.rst")

from docutils import frontend, utils
from docutils.parsers.rst import Parser
settings = frontend.get_default_settings(Parser)
with open('test.rst', encoding='utf-8') as file:
    document = utils.new_document(file.name, settings)
    Parser().parse(file.read(), document)

print(document.pformat())

type(document)

dir(document)

document.attlist()

document.attributes

document.next_node()

document.next_node()

for x in document:
    print(x)

document.next_node()

document.children[2].pformat()

para = document.children[2]
titletext = 'Hello, Sphinx!'

para += docutils.nodes.Text(titletext, titletext)

type(para)

para

for x in para:
    print(x)

para[0]

para[1]

document.children[2]

vv = docutils.nodes.paragraph('afds')

type(vv)