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.2.tar.gz (36.5 kB view details)

Uploaded Source

Built Distribution

pydocstyle-6.2.2-py3-none-any.whl (37.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pydocstyle-6.2.2.tar.gz
  • Upload date:
  • Size: 36.5 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.2.tar.gz
Algorithm Hash digest
SHA256 5714e3a96f6ece848a1c35f581e89f3164867733609f0dd8a99f7e7c6b526bdd
MD5 0c31685e46368f13fec1c0ab9f20ee51
BLAKE2b-256 41dd4bb3fdb78755cd7ab4ae176c443f23ac7e4a81ce4b4f5b3aa5b2c6095945

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pydocstyle-6.2.2-py3-none-any.whl
  • Upload date:
  • Size: 37.7 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 021b33525927b43b4469c2715694c38082cb98146b52342df652b30806e3cb61
MD5 f24f7a11976944b4b78304986e8b1a88
BLAKE2b-256 96acb1c2fd6df55ef83435a1dd31530a918faa2b4cf7f38f0cdb10a084929301

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