NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1491 most downloaded on PyPI
Typing stubs for docutils
Last release 11 days ago
23 Sep 2026
Release timing varies
gaps range from 1 weeks to 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
97 releases · first in 2021
One column per quarter.
Annotate publish_doctree parameters
Annotate publish_doctree return type
* Improve types in docutils.io
docutils.io (#16260)Type Publisher attributes and the source/destination classes in docutils.core
* Replace NoReturn with Never
NoReturn with Never (#16079)Avoid class-scope name collisions in stubs
Avoid class-scope name collisions in stubs (#15994)
Class members such as list, type, cursor, Model, and datetime shadow the builtins, classes, or modules referenced by nearby annotations. ty then resolves those annotations to Unknown, which can hide invalid calls in APIs including docker, sqlite3, psycopg2, Markdown, and requests.
Qualify shadowed builtins and use private aliases for colliding imports and classes. This removes 15 stdlib and 120 third-party collision diagnostics under ty 0.0.58, restores the affected public types, and fixes four existing psycopg2 type assertions.
Upgrade black to 26.5.0
Upgrade black to 26.5.0 (#15801)
Import some items from typing instead of typing_extensions
Import some items from typing instead of typing_extensions (#15711)
Part of #13782
Use dashes instead of underscores for METADATA.toml field names
Use dashes instead of underscores for METADATA.toml field names (#15614)
Add @type_check_only to stub-only private classes in various third-party stubs
Add @type_check_only to stub-only private classes in various third-party stubs (#15535)
Fix Final literal values in various third-party stubs
Fix Final literal values in various third-party stubs (#15521)
Add missing __slots__ to third-party packages
Add missing slots to third-party packages (#15454)
[docutils] Update to 0.22.3
[docutils] Update to 0.22.3 (#14993)
docutils: docutils.nodes.Node.next_node can return None
docutils: docutils.nodes.Node.next_node can return None (#14833)
[stubsabot] Bump docutils to 0.22.2
[stubsabot] Bump docutils to 0.22.2 (#14765)
[docutils] Update to 0.22.1
[docutils] Update to 0.22.1 (#14737)
[docutils] Extend applicable types to _ContentModelCategory
[docutils] Extend applicable types to _ContentModelCategory (#14719)
Update mypy to 1.18.1
Update mypy to 1.18.1 (#14699)
Add __slots__ to third-party packages using stubdefaulter
[docutils] Bump to 0.22.*
[docutils] Bump to 0.22.* (#14500)
[docutils] Add return types for a few docutils table methods
Type inline_text in stubs/docutils/docutils/parsers/rst/states.pyi
[docutils] Fix type of standalone.Reader.document
[docutils] Fix type of standalone.Reader.document (#14447)
[docutils] Add missing stubs for writers dir
[docutils] Add missing stubs for writers dir (#14223)
[docutils] Add missing stubs for transforms dir
[docutils] Add missing stubs for transforms dir (#14234)
[docutils] Fix issue with *_path params
[docutils] Fix issue with *_path params (#14383)
[docutils] Add missing stubs for readers dir
Improve docutils.parsers
Improve docutils.parsers (#14191)
Bump flake8-pyi to 25.5.0
Bump flake8-pyi to 25.5.0 (#14140)
Improve docutils LanguageImporter's
Improve docutils LanguageImporter's (#14130)
Add visit_* and depart_* methods to docutils visitor classes
Replace Incomplete | None = None in third party stubs
Replace Incomplete | None = None in third party stubs (#14063)
Replace incomplete module markers
Replace incomplete module markers (#14030)
Generate docutils.core and type publish_parts's return type
Generate docutils.core and type publish_parts's return type (#13118)
improve type annotations in 'docutils.frontend'
improve type annotations in 'docutils.frontend' (#12735)
Co-authored-by: daniel.eades daniel.eades@seebyte.com
add type annotations for 'docutils.parsers.rst.directives.admonitions'
add type annotations for 'docutils.parsers.rst.directives.admonitions' (#12396)
add type annotations to docutils.writers (#12420)
Co-authored-by: daniel.eades daniel.eades@seebyte.com Co-authored-by: Jelle Zijlstra jelle.zijlstra@gmail.com Co-authored-by: James Addison 55152140+jayaddison@users.noreply.github.com
Fix type of transform argument of docutils.nodes.pending.__init__
Add type annotations for 'docutils.writers.latex2e.Babel'
Docutils: wrong type: SystemMessage vs system_message
Docutils: wrong type: SystemMessage vs system_message (#12314)
improve type annotations in 'docutils.parsers.rst.states'
improve type annotations in 'docutils.parsers.rst.states' (#11545)
remove generic 'context' from 'docutils.parsers.rst.RSTState'
remove generic 'context' from 'docutils.parsers.rst.RSTState' (#12291)
Expand docutils.parsters.rst.states
Expand docutils.parsters.rst.states (#12226)
Bump docutils to 0.21.*
Bump docutils to 0.21.* (#11805)
docutils: Correct 'parsers.rst.directives.format_values'
docutils: Correct 'parsers.rst.directives.format_values' (#11719)
Remove bare Incomplete annotations in third-party stubs
improve type annotations in 'docutils.nodes.Element'
improve type annotations in 'docutils.nodes.Element' (#11539)
improve type annotations in 'docutils.utils.Reporter'
improve type annotations in 'docutils.utils.Reporter' (#11521)
improve type annotations in 'docutils.parsers.rst.directives'
improve type annotations in 'docutils.parsers.rst.directives' (#11597)
improve type annotations in 'docutils.statemachine'
improve type annotations in 'docutils.statemachine' (#11469)
improve type annotations in 'docutils.parsers.rst.directives.misc' (#11524)
Co-authored-by: daniel.eades daniel.eades@seebyte.com Co-authored-by: Jelle Zijlstra jelle.zijlstra@gmail.com
Use PEP 570 syntax in third party stubs
Use PEP 570 syntax in third party stubs (#11554)
docutils: Use ClassVar for Directive class variables
docutils: Use ClassVar for Directive class variables (#11550)
These are intended to be set as class variables, in subclasses of Directive, rather than instance variables.
See also:
improve type annotations in 'docutils.io.Input' (#11540)
improve type annotations in 'docutils.utils'
improve type annotations in 'docutils.utils' (#11526)
Co-authored-by: Jelle Zijlstra jelle.zijlstra@gmail.com
Improve type annotations in 'docutils.parsers.rst' (#11523)
improve type annotations in 'docutils.parsers.rst.tableparser'
improve type annotations in 'docutils.parsers.rst.tableparser' (#11530)
Co-authored-by: daniel.eades daniel.eades@seebyte.com
improve type annotations in 'docutils.parsers.rst.states.Inliner'
improve type annotations in 'docutils.parsers.rst.states.Inliner' (#11473)
improve type annotations in 'docutils.readers.doctree'
improve type annotations in 'docutils.readers.doctree' (#11492)
improve type annotations in 'docutils.parsers.rst.roles' (#11481)
Co-authored-by: daniel.eades daniel.eades@seebyte.com
improve type annotations in 'docutils.readers'
improve type annotations in 'docutils.readers' (#11490)
Co-authored-by: Jelle Zijlstra jelle.zijlstra@gmail.com
Improve type annotations in 'docutils.node.document'
Improve type annotations in 'docutils.node.document' (#11468)
[docutils] Add remaining node classes and functions
[docutils] Add remaining node classes and functions (#11255)
Co-authored-by: Sebastian Rittau srittau@rittau.biz Co-authored-by: Avasam samuel.06@hotmail.com
Add docutils.nodes.system_message and .BackLinkable
Add docutils.nodes.system_message and .BackLinkable
Add stubs for docutils.nodes.system_message and docutils.nodes.BackLinkable
Ad docutils.nodes.raw and docutils.nodes.Inline (#11312)
Add type stubs for docutils.nodes.literal_block and docutils.nodes.Fi…
Your coding agent can read these notes before it upgrades. Set up the MCP server →