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
Ian Cordasco 879d3fc0d7
Modify stdin retriever to detect coding pragma
When we read in a file on Python 3, we use the tokenize module to detect
the coding pragma at the top of the file. We then use that to decode the
rest of the file. However, when we were receiving stdin, we would not do
that.

This updates ``stdin_get_value`` in a backwards compatible way to check
for that coding pragma and then fall back to UTF-8 if necessary.

Closes #306
2017-02-20 07:38:28 -06:00
docs Update and finalize v3.3.0 release notes 2017-02-06 13:46:04 -06:00
example-plugin Add an example plugin project to source tree 2016-10-25 18:21:50 -05:00
src/flake8 Modify stdin retriever to detect coding pragma 2017-02-20 07:38:28 -06:00
tests Return similarly named, non-submodule modules 2017-01-22 15:00:48 -06:00
.appveyor.yml Add dogfood testenv to AppVeyor list 2016-08-03 16:48:39 -05: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 Add coverage reporting and uploading 2016-08-06 15:21:50 -05:00
.gitlab-ci.yml Add Python 3.6 to CI services 2017-01-15 11:26:12 -06: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
.pylintrc Fix our evaluation formula 2016-02-19 15:30:54 -06:00
.travis.yml Add Python 3.6 to CI services 2017-01-15 11:26:12 -06:00
codecov.yml Add coverage reporting and uploading 2016-08-06 15:21:50 -05:00
CONTRIBUTING.rst Symlink the contributing docs to CONTRIBUTING 2016-06-04 15:46:51 -05: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 setup.cfg: Move pytest options to pytest.ini 2016-09-18 11:23:08 +03:00
README.rst Point documentation to http: instead of https: 2016-08-11 16:11:26 +00:00
setup.cfg Allow newer pycodestyle 2017-02-02 12:22:22 -08:00
setup.py Allow newer pycodestyle 2017-02-02 12:22:22 -08:00
tox.ini Change dogfood environment to use Python 2.7 2017-01-21 13:51:01 -06: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``
- 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
<https://coglib.com/~icordasc/>`_