types-docutils

import os from docutils.core import publish_string # Example RST document rst_document: str = """ .. role:: red :red:`This is red text.` .. admonition:: Note This is an admonition block. """ # publish_string is a core docutils function to process RST # With types-docutils installed, type checkers can validate the arguments and return type. html_output: str = publish_string( source=rst_document, writer_name="html", settings_overrides={'initial_header_level': 2} ) print("Generated HTML snippet (first 200 chars):\n", html_output[:200]) # To see type checking in action, save this to 'app.py' # and run 'mypy app.py' after 'pip install types-docutils docutils mypy'. # Introduce a deliberate error, e.g., 'writer_name=123', and mypy will flag it.