pre-commit/flake8
1
0
Fork 0
mirror of https://github.com/PyCQA/flake8.git synced 2026-04-14 00:14:46 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add documentation for flake8 --extend-ignore

Browse source 
Also highlight the behavioral differences between `flake --ignore` and
`flake --extend-ignore`.
This commit is contained in:
Lars Butler 2018-10-24 18:03:30 +02:00
parent 52d88d8ca7
commit 144b5af7a8
1 changed files with 29 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

35
docs/source/user/violations.rst
View file

@ -18,19 +18,42 @@ by a version of |Flake8| may be different than the list used by a different
version. To see the default list, :option:`flake8 --help` will version. To see the default list, :option:`flake8 --help` will
show the output with the current default list. show the output with the current default list.
Extending the Default Ignore List
---------------------------------
Changing the Ignore List If we want to extend the default list of ignored error codes, we can use
------------------------ :option:`flake8 --extend-ignore` to specify a comma-separated list of codes
for a specific run on the command line, e.g.,
If we want to change the list of ignored codes for a single run, we can use .. prompt:: bash
:option:`flake8 --ignore` to specify a comma-separated list of codes for a
specific run on the command-line, e.g., flake8 --extend-ignore=E1,E23 path/to/files/ path/to/more/files
This tells |Flake8| to ignore any error codes starting with ``E1`` and ``E23``,
in addition the default ignore list. To view the default error code ignore
list, run :option:`flake8 --help` and refer to the help text for
:option:`flake8 --ignore`.
..
The section below used to be titled `Changing the Default Ignore List`, but
was renamed for clarity.
Explicitly retain the old section anchor so as to not break links:
.. _changing-the-ignore-list:
Overriding the Default Ignore List
----------------------------------
If we want to *completely* override the default list of ignored error codes, we
can use :option:`flake8 --ignore` to specify a comma-separated list of codes
for a specific run on the command-line, e.g.,
.. prompt:: bash .. prompt:: bash
flake8 --ignore=E1,E23,W503 path/to/files/ path/to/more/files/ flake8 --ignore=E1,E23,W503 path/to/files/ path/to/more/files/
This tells |Flake8| to ignore any error codes starting with ``E1``, ``E23``, This tells |Flake8| to *only* ignore error codes starting with ``E1``, ``E23``,
or ``W503`` while it is running. or ``W503`` while it is running.
.. note:: .. note::