========
Pyflakes
========
A simple program which checks Python source files for errors.
Pyflakes analyzes programs and detects various errors. It works by
parsing the source file, not importing it, so it is safe to use on
modules with side effects. It's also much faster.
It is `available on PyPI <https://pypi.org/project/pyflakes/>`_
and it supports all active versions of Python: 3.6+.
Installation
------------
It can be installed with::
$ pip install --upgrade pyflakes
Useful tips:
* Be sure to install it for a version of Python which is compatible
with your codebase: ``python#.# -m pip install pyflakes`` (for example,
``python3.10 -m pip install pyflakes``)
* You can also invoke Pyflakes with ``python#.# -m pyflakes .`` if you want
to run it for a specific python version.
* If you require more options and more flexibility, you could give a
look to Flake8_ too.
Design Principles
-----------------
Pyflakes makes a simple promise: it will never complain about style,
and it will try very, very hard to never emit false positives.
Pyflakes is also faster than Pylint_. This is
largely because Pyflakes only examines the syntax tree of each file
individually. As a consequence, Pyflakes is more limited in the
types of things it can check.
If you like Pyflakes but also want stylistic checks, you want
flake8_, which combines
Pyflakes with style checks against
`PEP 8`_ and adds
per-project configuration ability.
Mailing-list
------------
Share your feedback and ideas: `subscribe to the mailing-list
<https://mail.python.org/mailman/listinfo/code-quality>`_
Contributing
------------
Issues are tracked on `GitHub <https://github.com/PyCQA/pyflakes/issues>`_.
Patches may be submitted via a `GitHub pull request`_.
If you are comfortable doing so, please `rebase your changes`_
so they may be applied to main with a fast-forward merge, and each commit is
a coherent unit of work with a well-written log message. If you are not
comfortable with this rebase workflow, the project maintainers will be happy to
rebase your commits for you.
All changes should include tests and pass flake8_.
.. image:: https://github.com/PyCQA/pyflakes/workflows/Test/badge.svg
:target: https://github.com/PyCQA/pyflakes/actions
:alt: GitHub Actions build status
.. _Pylint: https://pylint.pycqa.org/
.. _flake8: https://pypi.org/project/flake8/
.. _`PEP 8`: https://www.python.org/dev/peps/pep-0008/
.. _`rebase your changes`: https://git-scm.com/book/en/v2/Git-Branching-Rebasing
.. _`GitHub pull request`: https://github.com/PyCQA/pyflakes/pulls
Changelog
---------
Please see `NEWS.rst <https://github.com/PyCQA/pyflakes/blob/main/NEWS.rst>`_.
Raw data
{
"_id": null,
"home_page": "https://github.com/PyCQA/pyflakes",
"name": "pyflakes",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "A lot of people",
"author_email": "code-quality@python.org",
"download_url": "https://files.pythonhosted.org/packages/57/f9/669d8c9c86613c9d568757c7f5824bd3197d7b1c6c27553bc5618a27cce2/pyflakes-3.2.0.tar.gz",
"platform": null,
"description": "========\nPyflakes\n========\n\nA simple program which checks Python source files for errors.\n\nPyflakes analyzes programs and detects various errors. It works by\nparsing the source file, not importing it, so it is safe to use on\nmodules with side effects. It's also much faster.\n\nIt is `available on PyPI <https://pypi.org/project/pyflakes/>`_\nand it supports all active versions of Python: 3.6+.\n\n\n\nInstallation\n------------\n\nIt can be installed with::\n\n $ pip install --upgrade pyflakes\n\n\nUseful tips:\n\n* Be sure to install it for a version of Python which is compatible\n with your codebase: ``python#.# -m pip install pyflakes`` (for example,\n ``python3.10 -m pip install pyflakes``)\n\n* You can also invoke Pyflakes with ``python#.# -m pyflakes .`` if you want\n to run it for a specific python version.\n\n* If you require more options and more flexibility, you could give a\n look to Flake8_ too.\n\n\nDesign Principles\n-----------------\nPyflakes makes a simple promise: it will never complain about style,\nand it will try very, very hard to never emit false positives.\n\nPyflakes is also faster than Pylint_. This is\nlargely because Pyflakes only examines the syntax tree of each file\nindividually. As a consequence, Pyflakes is more limited in the\ntypes of things it can check.\n\nIf you like Pyflakes but also want stylistic checks, you want\nflake8_, which combines\nPyflakes with style checks against\n`PEP 8`_ and adds\nper-project configuration ability.\n\n\nMailing-list\n------------\n\nShare your feedback and ideas: `subscribe to the mailing-list\n<https://mail.python.org/mailman/listinfo/code-quality>`_\n\nContributing\n------------\n\nIssues are tracked on `GitHub <https://github.com/PyCQA/pyflakes/issues>`_.\n\nPatches may be submitted via a `GitHub pull request`_.\nIf you are comfortable doing so, please `rebase your changes`_\nso they may be applied to main with a fast-forward merge, and each commit is\na coherent unit of work with a well-written log message. If you are not\ncomfortable with this rebase workflow, the project maintainers will be happy to\nrebase your commits for you.\n\nAll changes should include tests and pass flake8_.\n\n.. image:: https://github.com/PyCQA/pyflakes/workflows/Test/badge.svg\n :target: https://github.com/PyCQA/pyflakes/actions\n :alt: GitHub Actions build status\n\n.. _Pylint: https://pylint.pycqa.org/\n.. _flake8: https://pypi.org/project/flake8/\n.. _`PEP 8`: https://www.python.org/dev/peps/pep-0008/\n.. _`rebase your changes`: https://git-scm.com/book/en/v2/Git-Branching-Rebasing\n.. _`GitHub pull request`: https://github.com/PyCQA/pyflakes/pulls\n\nChangelog\n---------\n\nPlease see `NEWS.rst <https://github.com/PyCQA/pyflakes/blob/main/NEWS.rst>`_.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "passive checker of Python programs",
"version": "3.2.0",
"project_urls": {
"Homepage": "https://github.com/PyCQA/pyflakes"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d4d7f1b7db88d8e4417c5d47adad627a93547f44bdc9028372dbd2313f34a855",
"md5": "a8da02dcbc3c4881e1523a3f0e22fbbd",
"sha256": "84b5be138a2dfbb40689ca07e2152deb896a65c3a3e24c251c5c62489568074a"
},
"downloads": -1,
"filename": "pyflakes-3.2.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "a8da02dcbc3c4881e1523a3f0e22fbbd",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 62725,
"upload_time": "2024-01-05T00:28:45",
"upload_time_iso_8601": "2024-01-05T00:28:45.903788Z",
"url": "https://files.pythonhosted.org/packages/d4/d7/f1b7db88d8e4417c5d47adad627a93547f44bdc9028372dbd2313f34a855/pyflakes-3.2.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "57f9669d8c9c86613c9d568757c7f5824bd3197d7b1c6c27553bc5618a27cce2",
"md5": "556adcc6980bd478657598718f2c1155",
"sha256": "1c61603ff154621fb2a9172037d84dca3500def8c8b630657d1701f026f8af3f"
},
"downloads": -1,
"filename": "pyflakes-3.2.0.tar.gz",
"has_sig": false,
"md5_digest": "556adcc6980bd478657598718f2c1155",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 63788,
"upload_time": "2024-01-05T00:28:47",
"upload_time_iso_8601": "2024-01-05T00:28:47.703269Z",
"url": "https://files.pythonhosted.org/packages/57/f9/669d8c9c86613c9d568757c7f5824bd3197d7b1c6c27553bc5618a27cce2/pyflakes-3.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-05 00:28:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PyCQA",
"github_project": "pyflakes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "pyflakes"
}
JSON
