File: glossary.rst

package info (click to toggle)
python-flake8 7.1.1-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,212 kB
  • sloc: python: 6,592; sh: 21; makefile: 19
file content (57 lines) | stat: -rw-r--r-- 2,198 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.. _glossary:

================================================
 Glossary of Terms Used in Flake8 Documentation
================================================

.. glossary::
    :sorted:

    formatter
        A :term:`plugin` that augments the output of |Flake8| when passed
        to :option:`flake8 --format`.

    plugin
        A package that is typically installed from PyPI to augment the
        behaviour of |Flake8| either through adding one or more additional
        :term:`check`\ s or providing additional :term:`formatter`\ s.

    check
        A piece of logic that corresponds to an error code. A check may
        be a style check (e.g., check the length of a given line against
        the user configured maximum) or a lint check (e.g., checking for
        unused imports) or some other check as defined by a plugin.

    error
    error code
    violation
        The symbol associated with a specific :term:`check`. For example,
        pycodestyle implements :term:`check`\ s that look for whitespace
        around binary operators and will either return an error code of
        ``W503`` or ``W504``.

    warning
        Typically the ``W`` class of :term:`error code`\ s from pycodestyle.

    class
    error class
        A larger grouping of related :term:`error code`\ s. For example,
        ``W503`` and ``W504`` are two codes related to whitespace. ``W50``
        would be the most specific class of codes relating to whitespace.
        ``W`` would be the warning class that subsumes all whitespace
        errors.

    pyflakes
        The project |Flake8| depends on to lint files (check for unused
        imports, variables, etc.). This uses the ``F`` :term:`class` of
        :term:`error code`\ s reported by |Flake8|.

    pycodestyle
        The project |Flake8| depends on to provide style enforcement.
        pycodestyle implements :term:`check`\ s for :pep:`8`. This uses the
        ``E`` and ``W`` :term:`class`\ es of :term:`error code`\ s.

    mccabe
        The project |Flake8| depends on to calculate the McCabe complexity
        of a unit of code (e.g., a function). This uses the ``C``
        :term:`class` of :term:`error code`\ s.