Python Code Style

Reference Code Standard

The Python Software Foundation is responsible for developing and maintaining Python language standards. The Python foundation uses Python Enhancement Proposals (PEPs) to document the language and capture guidelines. Two PEPs are relevant to the topic of code style.

  • PEP 8 – Style Guide for Python Code
    PEP 8 specifies the conventions used to develop the standard libraries that ship as part of a Python distribution.

  • PEP 257 – Docstring Conventions
    PEP 257 builds on PEP 8 to add the semantics and conventions for Python docstrings. Following these conventions enables off the shelf tools to process the docstrings.

Exceptions to the Standard

None.

Implementing the Standard

Pylint is the recommended code analysis tool for verifying compliance with the PEP 8 style guide. Pylint can be run from the command-line for integrating in CI environment. There are also Pylint integrations for most Python IDEs and many text editors.

When a rule violation is the result of a conscious decision a rule can be disabled with a comment of the form

# pylint: disable=no-member

Sample implementation

To help enforce the standard, you can hook into Git. This can easily be applied to any language enforcement tooling.

Here’s an example using Python’s pre-commit package:

$ pip install pre-commit
$ pre-commit install
  • Create a file named .pre-commit-config.yaml in the root directory.
# file: .pre-commit-config.yaml
repos:
  - repo: https://github.com/pycqa/pylint
    rev: pylint-2.6.0
    hooks:
      - id: pylint
        args:
          - --rcfile=.pylintrc
        verbose: true

Bibliography