types-docutils
Typing stubs for docutils
Decision gist · record as of 2026-08-14
Yes, if you use docutils and run a static type checker. It has no runtime cost, no dependencies, and is actively maintained. Install it alongside docutils in your development environment to catch type errors early. Not necessary if you don't use a type checker or don't use docutils.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; only useful when running a type checker (mypy, pyright, etc.) as part of your development workflow.
- Low friction; a pure stub package with no runtime dependencies.
- Actively maintained as part of typeshed, with a recent release (21 days old) tested against mypy 2.3.0 and pyright 1.1.411.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license; you can use this freely in commercial and open-source projects with minimal restrictions.
last release 2026-07-24 (21 days) · last repo commit 2026-08-14 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 12,966,958 downloads/mo, #1,300 on PyPI
Alternatives
Verify before relying
pip install types-docutils
# In your code, type checkers will now understand docutils imports:
from docutils import nodes
from docutils.parsers.rst import Parser
# mypy or pyright will validate usage against the type stubs- Whether the stubs cover all docutils 0.22.3 APIs or only a subset of the public interface.
- Compatibility with type checkers other than mypy 2.3.0 and pyright 1.1.411.
What it is and what it does
types-docutils is a type stub package that bridges the gap between the docutils library and Python's static type checkers. It provides type annotations for docutils so that tools like mypy and pyright can validate code that uses docutils for document parsing, transformation, and rendering without requiring the docutils package itself to include inline type hints.
The stubs are maintained as part of the typeshed project and are kept in sync with docutils 0.22.3. Since this is a stub-only package with no runtime dependencies, it installs quickly and adds no overhead to your application—it's purely a development tool for catching type errors during static analysis.
Use it for
- Enable mypy or pyright to type-check code that parses reStructuredText using docutils.
- Catch type errors in document processing pipelines before runtime.
- Integrate docutils into a codebase with strict type-checking enabled.
- Validate custom docutils transforms and visitor implementations against the correct types.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use docutils and run a static type checker.
It has no runtime cost, no dependencies, and is actively maintained. Install it alongside docutils in your development environment to catch type errors early. Not necessary if you don't use a type checker or don't use docutils.
Install
types-docutils on PyPI
Before you install
Low friction; a pure stub package with no runtime dependencies. Actively maintained as part of typeshed, with a recent release (21 days old) tested against mypy 2.3.0 and pyright 1.1.411.
Requires Python 3.10 or later; only useful when running a type checker (mypy, pyright, etc.) as part of your development workflow.
License in practice
Apache-2.0 permissive license; you can use this freely in commercial and open-source projects with minimal restrictions.
Quickstart
pip install types-docutils
# In your code, type checkers will now understand docutils imports:
from docutils import nodes
from docutils.parsers.rst import Parser
# mypy or pyright will validate usage against the type stubsVerify before relying
- Whether the stubs cover all docutils 0.22.3 APIs or only a subset of the public interface.
- Compatibility with type checkers other than mypy 2.3.0 and pyright 1.1.411.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 21 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 12,966,958 / month, #1,300 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Typing :: Stubs Only |
Evidence: types_docutils-0.22.3.20260724-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “docutils type hints”
- types-docutilsProvides type hints for the docutils library, enabling static type…
- docutils-stubsProvides PEP 561 type stubs for docutils, enabling type checking and…
- antsibull-docutilsProvides docutils helpers and utilities for Antsibull tools,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Documentation packages
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
Griffe extracts the complete structure and signatures of Python programs to generate API documentation or detect breaking changes in your project's public API.
Install it if you need to programmatically inspect Python code structure, generate API docs, or enforce API stability in CI.
A Sphinx extension that outputs documentation in serialized HTML formats (JSON and pickle) alongside standard HTML.
Alabaster is a clean, responsive Sphinx theme for documentation that requires Python 3.10 or newer and Sphinx 6.2 or newer.
A Sphinx extension that generates HTML help files from reStructuredText documentation source.
See also types-fpdf2 · types-mypy-extensions · types-yt-dlp · types-zstd · types-paramiko · types-psycopg2 · types-Pygments · types-python-dateutil · types-pycurl · types-pyRFC3339