loading...
Cover image for 📦 Interrogate is a pretty awesome, brand new, cli for Python packages

📦 Interrogate is a pretty awesome, brand new, cli for Python packages

waylonwalker profile image Waylon Walker Originally published at waylonwalker.com on ・2 min read

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

Interrogate

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.

Install it

Interrogate is on pypi so it is super simple to install with pip

pip install interrogate

run it

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>

😲 I have some work to do

One of my new open source packages find-kedro only hit 71%.

interrogate find-kedro -v

verbose interrogate on find-kedro

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

double verbose interrogate on find-kedro

Give it a ⭐

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!

What do you think? 👇

Leave it in the comments on what you think the minimum docstring coverage for a project should be.

Posted on by:

waylonwalker profile

Waylon Walker

@waylonwalker

Making fun things in public. If you like this article and want to send a tip ☕ https://www.buymeacoffee.com/bBdtMQO

Discussion

markdown guide