Side by side
PyDoctor vs Widdershins
Both stand on documentation generators. Which one you can start free with, which one lets you read the code, and what each costs once you pay.
Free plan LinuxMacWindows
PyDoctor provides static, configurable API documentation for Python projects, with inheritance, interface, and Sphinx-linking support. Its type-inference limitation and dropped Python 3.8 support are important compatibility considerations.
Visit PyDoctor Free plan APILinuxSelf-hosted
Widdershins offers several API definition inputs and renderer-oriented outputs, with templates and samples users can adapt. Its default schema expansion behavior may matter when preparing documentation.
Visit WiddershinsThe facts
| PyDoctor | Widdershins | |
|---|---|---|
| Free plan | Yes | Yes |
| Open source | Not published | Not published |
| Runs on | Linux, Mac, Windows | API, Linux, Self-hosted |
| Lowest paid plan | Not published | Free or on request |
| Plans published | None | 1 |
| Maker | Not published | Not published |
| Website | pydoctor.readthedocs.io | github.com |
| On documentation generators | #19 of 37 | #23 of 37 |
PyDoctor: what it does well
- Free plan available
- Generates static HTML API pages
- Resolves imports and inheritance
- Supports several docstring formats
- Runs on Linux, macOS, and Windows
What to know first
- Computed values need type annotations
- Python 3.8 support was dropped
- Best suited to libraries with internal subclassing
Widdershins: what it does well
- Accepts OpenAPI, API Blueprint, AsyncAPI, and Semoasa inputs.
- Produces Markdown, HTML, or ReSpec format.
- Templates and code samples are customizable.
- Free and MIT-licensed.
What to know first
- Schema examples default to a maximum depth of 10.
- Referenced request body schemas are not expanded by default without an inline schema.
Alternatives to PyDoctor Alternatives to Widdershins The whole list