linter-python-pep257

Linter for Python docstrings.

sfodje

5,713

3

Bug Reports

0.0.1

MIT

GitHub

This package provides the following services:

linter-python-pep257

A Linter plugin to lint Python docstrings according to the semantics and conventions spec'd in pep257. This is a fork of https://github.com/AtomLinter/linter-pep257 but rewritten to support the Atom-linter's new API.

In use side-by-side with the flake8 linter:

Screenshot of pep257 feedback

Installation

  1. If Linter is not already installed, follow the linter installation instructions.

  2. Configure linter to show "info" messages:

  1. Install python package pep257.

Execute in a terminal:

pip install pep257
  1. Install plugin.

Execute:

apm install linter-python-pep257

Configuration

setting values
Error codes to ignore (comma separated) Example: D100,D101 - all available error codes
Path to executable pep257 cmd Default: pep257

If using python version management, like pyenv, the path configuration will need to be set. For pyenv, the path for pep257 is discoverable by executing:

pyenv which pep257