---
id: types-docutils
version: "0.22.3.20260724"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-docutils — Typing stubs for docutils

License: permissive · Maintenance: active · Downloads: 13.0M/mo

## 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 above — verify before relying.

Provides type hints for the docutils library, enabling static type checkers like mypy and pyright to validate code that uses docutils for document processing and parsing.

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

pip install types-docutils
uv add types-docutils
poetry add types-docutils

## Installing types-docutils

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.

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 stubs

Requires Python 3.10 or later; only useful when running a type checker (mypy, pyright, etc.) as part of your development workflow.

Verify 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_current
- Install friction: low
- Maintenance: active
- Downloads: 13.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs docutils, docutils type hints, mypy docutils annotations, static type checking document processing, pyright docutils types, type-stubs, static-analysis

[View on SkillFed](https://skillfed.io/packages/types-docutils) · [View on PyPI](https://pypi.org/project/types-docutils/)