{"categories":[{"label":"Software Development","url":"https://skillfed.io/packages/category/software-development/14"},{"label":"Python Modules","url":"https://skillfed.io/packages/category/software-development-libraries-python-modules/16"},{"label":"Utilities","url":"https://skillfed.io/packages/category/utilities/8"},{"label":"Quality Assurance","url":"https://skillfed.io/packages/category/software-development-quality-assurance/3"},{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation/2"},{"label":"Sphinx","url":"https://skillfed.io/packages/category/documentation-sphinx"},{"label":"Documentation","url":"https://skillfed.io/packages/category/software-development-documentation"}],"enrichment":{"capability":"Measures docstring coverage in Python source code by scanning for missing docstrings in functions, classes, methods, and modules, then reports statistics and identifies gaps.","skillfed_tags":["documentation-audit","ci-integration","code-quality"],"use_cases":["Audit a new library or codebase to understand how well-documented it is before deciding to use or maintain it.","Enforce minimum documentation standards in CI/CD by failing builds when docstring coverage drops below a threshold.","Generate a coverage badge to display in a project's README as a visual indicator of documentation quality.","Integrate into pre-commit hooks to catch undocumented functions and classes before they reach version control.","Measure documentation debt over time by running the tool on releases and tracking coverage trends."],"what_it_does":"docstr-coverage is a command-line tool and Python library that scans your source code to identify which functions, classes, methods, and modules lack docstrings. It walks your project recursively, counts what's documented and what's missing, and reports both per-file and aggregate coverage percentages with a letter grade. You run it as a CLI tool pointing at a file or directory, configure it via YAML, or import its API into your own code to get structured coverage data.\n\nThe tool is designed to help enforce documentation standards in teams and projects. It supports fine-grained filtering\u2014you can skip magic methods, private functions, properties, or entire file patterns via regex\u2014and lets you override its analysis with inline comments for inherited or deliberately undocumented code. It integrates into pre-commit hooks, can generate SVG badges for README files, and supports both strict pass/fail thresholds and silent percentage-only output for CI pipelines.","worth_installing":"Yes, if you need to audit or enforce docstring coverage in Python projects. The tool is straightforward, has no security vulnerabilities, and low install friction. However, maintenance is dormant (last release May 2024, no commits for 829 days), so verify compatibility with your Python version before relying on it for critical CI workflows. For one-off audits or pre-commit integration in stable codebases, it's a solid choice."},"id":"docstr-coverage","links":{"html":"https://skillfed.io/packages/docstr-coverage","md":"https://skillfed.io/packages/docstr-coverage.md","pypi":"https://pypi.org/project/docstr-coverage/"},"maintenance":{"status":"dormant"},"meta":{"latest_release":"2024-05-07","license_spdx":null,"license_treatment":"permissive","name":"docstr-coverage","python_support":"unspecified","summary":"Utility for examining python source files to ensure proper documentation. Lists missing docstrings, and calculates overall docstring coverage percentage rating."},"popularity":{"monthly_downloads":190657,"position":9903,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"2.3.2"}