Tired of browsing Python API docs online 😴 ?

Why not browsing them offline, directly in your terminal, thanks to #Griffe and #Textual 😎 ?

https://mkdocstrings.github.io/griffe-tui/

Also, I just realized that the `@typing.deprecated` extension for #Griffe (https://mkdocstrings.github.io/griffe-typing-deprecated/) was not made available to sponsors, so I added it to the insiders team too.

We just added an "autosummary" option in version 1.2.0 of #mkdocstrings-python Insiders!

See the docs: https://mkdocstrings.github.io/python/usage/configuration/members/#summary

See it in action in #Griffe's documentation: http://localhost:8000/griffe/reference/griffe/ 🚀

New #Griffe version 0.34.0 now supports Methods sections in docstrings, both for Google and Numpydoc styles! 🎉

More than that, it supports new sections for documenting classes and modules.

Thanks to this, we will be able to implement auto-summaries for the 4 categories of objects (attributes, functions/methods, classes and modules) in #mkdocstrings' Python handler 😎

Also, Griffe now documents the Numpydoc style: https://mkdocstrings.github.io/griffe/docstrings/#numpydoc-style

Productive days 😛 Second extension for #Griffe: support for PEP 702's `deprecated` decorator, to automatically insert a "Deprecated" adminition in the docstring, with the specified message.

After a long time, since the new Python handler was released, class inheritance support is back into #mkdocstrings 🌲

v1.2.0 for mkdocstrings-python, v1.2.0.1.1.2 for insiders.

I want to thank my amazing sponsors for allowing this to happen. This would not be possible without you 🙇

Thank you so much! ❤️

#Griffe docs now show inherited members: https://mkdocstrings.github.io/griffe/reference/griffe/dataclasses/

I just published a first prototype of a #Griffe extension for #Pydantic: https://mkdocstrings.github.io/griffe-pydantic/

My sponsors can immediately start using it 🙂 It's version 1.0.0a0, so still experimental!

It will change a bit the look of Pydantic models within mkdocstrings:

#Griffe/#mkdocstrings news: version 0.32.0 is out 🌻

Highlights:

- performance improvement (especially memory usage on medium/large codebases)
- new, better extension system

Full changelog here: https://mkdocstrings.github.io/griffe/changelog/#0320-2023-07-13

I've completely reworked the extension system of #Griffe, to make it easier to use.

To test it before releasing anything, I prototyped a #Pydantic extension. Here's a preview of the result in #mkdocstrings 🤩

I took the opportunity of #Python 3.7 becoming EOL to remove other deprecated things in #Griffe.

Look at this output of the API breaking changes detection command! 🤩

Things like `sys` wouldn't be reported if I defined an `__all__` variable 😅

Francesca Sofia Novello con i pantaloncini da boxe: in versione sportiva non rinuncia alle griffe #francesca #sofia #novello #pantaloncini #boxe #versione #sportiva #rinuncia #griffe #28maggio https://parliamodi.news/article/aHR0cHM6Ly93d3cuZmFucGFnZS5pdC9zdGlsZS1lLXRyZW5kL21vZGEvZnJhbmNlc2NhLXNvZmlhLW5vdmVsbG8tY29uLWktcGFudGFsb25jaW5pLWRhLWJveGUtaW4tdmVyc2lvbmUtc3BvcnRpdmEtbm9uLXJpbnVuY2lhLWFsbGUtZ3JpZmZlLw==