A linter for your Python code base that finds potentially outdated docstrings using version control.
Project description
Docsweeper is a linter for version controlled Python code bases that finds potentially outdated docstrings in your source files. For every code token in the file that has a docstring (see PEP 257), Docsweeper will interact with your Git or Mercurial version control system to determine:
in which revision the docstring has last been changed, and
how often the source code that is referenced by the docstring has been altered since that revision.
Used as a stand-alone application or as a plugin for the Flake8 linter, Docsweeper can be integrated into your code check-in or linting process easily and help you quickly determine which docstrings potentially contain obsolete information.
Compatibility
Docsweeper supports Linux, Mac, and Windows platforms that are compatible with Python 3.7 or newer. In addition to a working Python installation, you will also need at least one of the version control systems you intend to use Docsweeper with:
Git v1.7.0 or newer, and/or
Mercurial v5.2 or newer. This is the the first release of Mercurial with official support for Python 3.
Refer to the documentation for more information.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for docsweeper-1.2.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 96f099693dcbd8e558db579af46c1da800139e1e76bd092a2ae54e1c6dfafb43 |
|
MD5 | 76bff727d62284622e7bc2c370bd736b |
|
BLAKE2b-256 | a7cb3a42d453b9b435a801f06f00befd1c1fd3f16c0cd053466958cd2961cdf1 |