flake8 is a python tool that glues together pycodestyle, pyflakes, mccabe, and third-party plugins to check the style and quality of some python code. https://flake8.pycqa.org
Find a file
Eric N. Vander Weele 1ba56b9056 utils: Change normalize_paths() contract
The `normalize_paths()` utility was doing too much — parsing
unstructured configuration path data and dispatching the scrubbed paths
to be normalized.

Towards moving the parsing of unstructured configuration path data
closer towards were configuration occurs, have the utility accept only
structured input for normalizing paths.
2019-07-28 10:43:06 -04:00
docs utils: Change normalize_paths() contract 2019-07-28 10:43:06 -04:00
example-plugin Add an example plugin project to source tree 2016-10-25 18:21:50 -05:00
src/flake8 utils: Change normalize_paths() contract 2019-07-28 10:43:06 -04:00
tests utils: Change normalize_paths() contract 2019-07-28 10:43:06 -04:00
.appveyor.yml Fix / improve recently merged patches + CI 2019-07-08 14:22:51 -07:00
.bandit.yml Configure bandit to ignore subprocess warnings 2016-06-14 07:58:13 -05:00
.coveragerc Add coverage reporting and uploading 2016-08-06 15:21:50 -05:00
.gitignore ignore .coverage files in --parallel-mode 2019-05-01 17:08:10 +01:00
.gitlab-ci.yml mypy now passes 2019-05-19 17:31:04 -07:00
.hgignore Ignore ./.tox directory 2014-03-30 23:54:36 +02:00
.hgtags Release v2.2.3 2014-08-25 19:03:13 -05:00
.mailmap Update name across the project post-marriage 2017-07-27 18:47:38 -05:00
.pre-commit-config.yaml mypy now passes 2019-05-19 17:31:04 -07:00
.pre-commit-hooks.yaml Turn off pre-commit's automated multiprocessing 2019-01-27 17:26:45 -08:00
.pylintrc Spelling and grammar fixes 2018-05-13 22:19:50 +02:00
.travis.yml Add Python 3.7 to tox and GitLab CI 2018-05-20 22:01:25 +02:00
codecov.yml Add coverage reporting and uploading 2016-08-06 15:21:50 -05:00
CONTRIBUTING.rst Add CONTRIBUTING.rst file refering to webpage. 2017-05-15 11:09:07 +01:00
CONTRIBUTORS.txt Tidy up last few bits for performance improvement 2016-12-20 18:29:10 -06:00
dev-requirements.txt Switch out dev-requirements for tox 2016-03-17 14:56:54 -05:00
LICENSE Update the copyright in the LICENSE 2016-06-25 10:49:32 -05:00
MANIFEST.in Revert "Update release machinery to include manpages" 2016-11-14 09:49:03 -06:00
pytest.ini fix CI build 2019-07-08 09:07:37 -07:00
README.rst Clearer docs, NOQA_INLINE_REGEXP comment - fixes #469 2018-10-28 20:17:01 +01:00
setup.cfg Fix / improve recently merged patches + CI 2019-07-08 14:22:51 -07:00
setup.py Move setup metadata to setup.cfg 2019-07-08 20:14:44 +00:00
tox.ini fix CI build 2019-07-08 09:07:37 -07:00

========
 Flake8
========

Flake8 is a wrapper around these tools:

- PyFlakes
- pycodestyle
- Ned Batchelder's McCabe script

Flake8 runs all the tools by launching the single ``flake8`` command.
It displays the warnings in a per-file, merged output.

It also adds a few features:

- files that contain this line are skipped::

    # flake8: noqa

- lines that contain a ``# noqa`` comment at the end will not issue warnings.
- you can ignore specific errors on a line with ``# noqa: <error>``, e.g.,
  ``# noqa: E234``. Multiple codes can be given, separated by comma. The ``noqa`` token is case insensitive, the colon before the list of codes is required otherwise the part after ``noqa`` is ignored
- Git and Mercurial hooks
- extendable through ``flake8.extension`` and ``flake8.formatting`` entry
  points


Quickstart
==========

See our `quickstart documentation
<http://flake8.pycqa.org/en/latest/index.html#quickstart>`_ for how to install
and get started with Flake8.


Frequently Asked Questions
==========================

Flake8 maintains an `FAQ <http://flake8.pycqa.org/en/latest/faq.html>`_ in its
documentation.


Questions or Feedback
=====================

If you have questions you'd like to ask the developers, or feedback you'd like
to provide, feel free to use the mailing list: code-quality@python.org

We would love to hear from you. Additionally, if you have a feature you'd like
to suggest, the mailing list would be the best place for it.


Links
=====

* `Flake8 Documentation <http://flake8.pycqa.org/en/latest/>`_

* `GitLab Project <https://gitlab.com/pycqa/flake8>`_

* `All (Open and Closed) Issues
  <https://gitlab.com/pycqa/flake8/issues?scope=all&sort=updated_desc&state=all>`_

* `Code-Quality Archives
  <https://mail.python.org/mailman/listinfo/code-quality>`_

* `Code of Conduct
  <http://flake8.pycqa.org/en/latest/internal/contributing.html#code-of-conduct>`_

* `Getting Started Contributing
  <http://flake8.pycqa.org/en/latest/internal/contributing.html>`_


Maintenance
===========

Flake8 was created by Tarek Ziadé and is currently maintained by `Ian Cordasco
<http://www.coglib.com/~icordasc/>`_