You love pydantic ❤ and you want to document your models and configuration settings with sphinx?
Perfect, let's go. But wait, sphinx' autodoc does not integrate too well with pydantic models 😕.
Don't worry - just pip install autodoc_pydantic ☺.
Features
- 💬 provides default values, alias and constraints for model fields
- 🔗 adds hyperlinks between validators and corresponding fields
- 📃 includes collapsable model json schema
- 🏄 natively integrates with autodoc and autosummary extensions
- 📎 defines explicit pydantic prefixes for models, settings, fields, validators and model config
- 📋 shows summary section for model configuration, fields and validators
- 👀 hides overloaded and redundant model class signature
- 📚 sorts fields, validators and model config within models by type
- 🍀 Supports
pydantic >= 1.5.0andsphinx >= 3.4.0
Comparison between autodoc sphinx and autodoc pydantic
To see those features in action, jump over to the example documentation to compare the appearance of standard sphinx autodoc with autodoc_pydantic.
Documentation
For more details, please visit the official documentation:
Acknowledgements
Thanks to great open source projects sphinx, pydantic and poetry (and so many more) ❤ in addition to the following contributors:
 Franz Wöllert 🚧 📖 ⚠️ 🖋 |
 TheBeardedBerserkr 🤔 |
 Jan Vlčinský 🛡️ |
 antvig 🐛 📓 |
 Hugo O Rivera 🤔 |
 yura bondarenko 🐛 📓 |
 Trevor Howard 🐛 📓 |
 thomas-pedot 🐛 📓 |
 Mat Utter 🐛 📓 |
 David C Hall 🤔 📓 |
 Josh A. Mitchell 🤔 |
This project follows the all-contributors specification. Contributions of any kind welcome!
1 maintainer
Metadata
1 maintainer
Release files for autodoc_pydantic 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| autodoc_pydantic-1.4.0.tar.gz | 18.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| autodoc_pydantic-1.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 37.8 kB
Release files / autodoc_pydantic-1.4.0.tar.gz
| Download URL | autodoc_pydantic-1.4.0.tar.gz |
|---|---|
| Size | 18.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ebfbf6dafa66a9809d0d42bb4c982b9ea6546073ce2700e4293689c9f10cd3c9
|
|
BLAKE2b-256 checksum How to use checksums |
fe4f03c7818ba1c94ff234bcffe0b7ebb7ebddb2c465f070268b4d19e3a9963e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.0.0 CPython/3.9.6 Linux/5.8.0-1039-azure
|
Release files / autodoc_pydantic-1.4.0-py3-none-any.whl
| Download URL | autodoc_pydantic-1.4.0-py3-none-any.whl |
|---|---|
| Size | 19.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b05b959fdac41105fb78f8a2fc2d7838136d5ccdd72561d3afdd73df24bc3ad7
|
|
BLAKE2b-256 checksum How to use checksums |
d57957ad0b2a8f00628262dd61c824df480455a00034bc686f788af6f66e470a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.0.0 CPython/3.9.6 Linux/5.8.0-1039-azure
|
