You love pydantic
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🍀 Supportspydantic >= 1.5.0
andsphinx >= 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)
This project follows the all-contributors specification. Contributions of any kind welcome!