Skip to main content

Python docstring style checker

Project description

https://github.com/PyCQA/pydocstyle/workflows/Run%20tests/badge.svg Documentation Status https://img.shields.io/pypi/pyversions/pydocstyle.svg https://pepy.tech/badge/pydocstyle https://img.shields.io/badge/code%20style-black-000000.svg https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336 Gitpod ready-to-code

pydocstyle is a static analysis tool for checking compliance with Python docstring conventions.

pydocstyle supports most of PEP 257 out of the box, but it should not be considered a reference implementation.

pydocstyle supports Python 3.6+.

Quick Start

Install

pip install pydocstyle

Run

$ pydocstyle test.py
test.py:18 in private nested class `meta`:
        D101: Docstring missing
test.py:27 in public function `get_user`:
    D300: Use """triple double quotes""" (found '''-quotes)
test:75 in public function `init_database`:
    D201: No blank lines allowed before function docstring (found 1)
...

Develop

You can use Gitpod to run pre-configured dev environment in the cloud right from your browser -

Open in Gitpod

Before submitting a PR make sure that you run make all.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pydocstyle-6.2.1.tar.gz (36.4 kB view details)

Uploaded Source

Built Distribution

pydocstyle-6.2.1-py3-none-any.whl (37.6 kB view details)

Uploaded Python 3

File details

Details for the file pydocstyle-6.2.1.tar.gz.

File metadata

  • Download URL: pydocstyle-6.2.1.tar.gz
  • Upload date:
  • Size: 36.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.1 CPython/3.10.6 Linux/5.15.0-1024-azure

File hashes

Hashes for pydocstyle-6.2.1.tar.gz
Algorithm Hash digest
SHA256 5ddccabe3c9555d4afaabdba909ca2de4fa24ac31e2eede4ab3d528a4bcadd52
MD5 ae3b1019eb9a3387603cf8aaed30a218
BLAKE2b-256 b7c701674c093a29cc83261d2cd554dd9d0debf8cfad061c05359a5d18562863

See more details on using hashes here.

File details

Details for the file pydocstyle-6.2.1-py3-none-any.whl.

File metadata

  • Download URL: pydocstyle-6.2.1-py3-none-any.whl
  • Upload date:
  • Size: 37.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.1 CPython/3.10.6 Linux/5.15.0-1024-azure

File hashes

Hashes for pydocstyle-6.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e034023706489a5786778d21bd25e951052616b260d83e163f09d559dcd647b9
MD5 a79aae231d5956eda6ecd4b3757416e0
BLAKE2b-256 1e4a70a55fe6dada5acf640b202a4c2cda39a74cc51222edd44154c914600e9d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page