Validate Python Docstrings Against Function Signatures with pydoclint

Check that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves.

agentskillexchange Updated 28 repo stars

File contents

Validate Python Docstrings Against Function Signatures with pydoclint

Check that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves.

Prerequisites

Python, pydoclint, Python source tree

Installation

Use the upstream install or setup path that matches your environment:

  • pip install pydoclint
  • pip install pydoclint[flake8]

Requirements and caveats from upstream:

  • Pydoclint is a Python docstring linter to check whether a docstring's
  • Here is a comparison of linting time on some famous Python projects:
  • also install flake8 to the current Python environment:

Basic usage or getting-started notes:

Documentation

Source

agentskillexchange/skills/tree/main/skills/validate-python-docstrings-against-function-signatures-with-pydoclint commit 792016497c

Frequently asked questions

npx skillmds@latest add agentskillexchange/validate-python-docstrings-against-function-signatures-with-