This article was also cross posted to dev.to feel free to drop in to give it a ♥ and leave comment.
As usual while listening to python bytes 181 I heard of a tool that I had to try out right away!
This thing is 🔥 hot off the press folks, we're talking the first release only 3 weeks ago. Its something that the python community needed years ago, and it belongs in your CI today. I had tried several tools that tried to do docstring coverage in the past but they were a bit cumbersome and were quickly forgotten about. Not interrogate, its dead simple!
Nothing I have tried has come close to being this good
It runs documentation coverage for your python project. It allows you to set the minimum amount of docstring coverage for your project and has some great setup instructions right in the readme.
Interrogate is on pypi so it is super simple to install with
pip install interrogate
This is the best part, its super easy to run right from the command line! Just call it, and give it a path to run.
interrogate -v <path>
One of my new open source packages find-kedro only hit 71%.
interrogate find-kedro -v
Personally I really like the double verbose output that gives you the names of everything missing a docstring and the line they occur on.
interrogate find-kedro -vv
Every project this amazing deserves a big ol ⭐ on GitHub! Go over to econchick/interrogate and give it a one... it deserves it! While you are there check out the wicked good readme. It has great examples of how to run it from your command line, as a pre-commit hook, in your ci, with your code, or pyproject.toml.
While you are there check out the wicked good readme!
👀 see an issue, edit this post on GitHub
If you found value in this post
and want to send a tip.
Check out my otherblogs
I write short articles about developing a successful mindset for the tech industry once or so per week.Subscribe
Someday I hope to announce courses/side projects there as well.
Unsubscribe at any time