docov
Light-weight, recursive docstring coverage analysis for python modules.
Overview
docov provides light-weight docstring coverage analysis for python modules. It recursively collects symbols defined by the specified module and checks whether these symbols have docstrings and if they are longer than at least 20 symbols.
Installation
docov is available via PyPI:
$ pip install docov
Usage
Once installed, docov can be used from the command-line
$ docov <module-name>
which will produce a badge and a report on symbols, which were deemed to have insufficient docstring.
A short help text on available options can be found with
$ docov -h
usage: docov [-h] [-o OUTPUT] [-d DEPTH] [--no-badge] [--no-report] MODULE
Command line utility to analyze docstring coverage of python modules.
Works by recursively fetching the module's symbol's docstrings and
checking that hey are non-empty and consist of at least 20 characters.
Generates a badge and a report if not specified otherwise.
positional arguments:
MODULE The module which is to be analyzed.
optional arguments:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Output directory.
-d DEPTH, --depth DEPTH
Analysis recursion depth.
--no-badge Generate a badge in <output>/docov.svg.
--no-report Generate a report in <output>/docov.txt.
15 Dec 7, 2022
1 Nov 8, 2021
7 Mar 19, 2022
1 Jan 6, 2022
3 Mar 2, 2022
0 Feb 14, 2022
4 Dec 31, 2022
831 Dec 27, 2022
1.4k Jan 7, 2023
243 Dec 20, 2022
3.8k Dec 30, 2022
263 Dec 23, 2022
1 Dec 19, 2021
1.9k Dec 31, 2022
1 Nov 19, 2021
3 Dec 23, 2022
4.1k Jan 06, 2023
41 Dec 30, 2022
1 Jan 06, 2022
1 Dec 28, 2021
3.1k Dec 24, 2022
0 Dec 13, 2022
1 Mar 17, 2022
17.7k Jan 07, 2023
1.4k Dec 31, 2022
6 Nov 05, 2022
2 Jan 26, 2022
2 Feb 12, 2022
643 Dec 31, 2022