Pylint_

.. _Pylint: https://pylint.pycqa.org/

.. This is used inside the doc to recover the start of the introduction

.. image:: https://github.com/PyCQA/pylint/actions/workflows/tests.yaml/badge.svg?branch=main :target: https://github.com/PyCQA/pylint/actions

.. image:: https://coveralls.io/repos/github/PyCQA/pylint/badge.svg?branch=main :target: https://coveralls.io/github/PyCQA/pylint?branch=main

.. image:: https://img.shields.io/pypi/v/pylint.svg :alt: Pypi Package version :target: https://pypi.python.org/pypi/pylint

.. image:: https://readthedocs.org/projects/pylint/badge/?version=latest :target: https://pylint.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/ambv/black

.. image:: https://img.shields.io/badge/linting-pylint-yellowgreen :target: https://github.com/PyCQA/pylint

.. image:: https://results.pre-commit.ci/badge/github/PyCQA/pylint/main.svg :target: https://results.pre-commit.ci/latest/github/PyCQA/pylint/main :alt: pre-commit.ci status

.. image:: https://bestpractices.coreinfrastructure.org/projects/6328/badge :target: https://bestpractices.coreinfrastructure.org/projects/6328 :alt: CII Best Practices

.. image:: https://img.shields.io/discord/825463413634891776.svg :target: https://discord.gg/qYxpadCgkx :alt: Discord

What is Pylint?

Pylint is a static code analyser_ for Python 2 or 3. The latest version supports Python 3.7.2 and above.

.. _static code analyser: https://en.wikipedia.org/wiki/Static_code_analysis

Pylint analyses your code without actually running it. It checks for errors, enforces a coding standard, looks for code smells_, and can make suggestions about how the code could be refactored. Pylint can infer actual values from your code using its internal code representation (astroid). If your code is import logging as argparse, Pylint will know that argparse.error(...) is in fact a logging call and not an argparse call.

.. _code smells: https://martinfowler.com/bliki/CodeSmell.html

Pylint is highly configurable and permits to write plugins in order to add your own checks (for example, for internal libraries or an internal rule). Pylint has an ecosystem of existing plugins for popular frameworks such as pylint-django_ or pylint-sonarjson_.

.. _pylint-django: https://github.com/PyCQA/pylint-django .. _pylint-sonarjson: https://github.com/omegacen/pylint-sonarjson

Pylint isn't smarter than you: it may warn you about things that you have conscientiously done or check for some things that you don't care about. During adoption, especially in a legacy project where pylint was never enforced, it's best to start with the --errors-only flag, then disable convention and refactor message with --disable=C,R and progressively re-evaluate and re-enable messages as your priorities evolve.

Pylint ships with three additional tools:

• pyreverse_ (standalone tool that generates package and class diagrams.)
• symilar_ (duplicate code finder that is also integrated in pylint)
• epylint_ (Emacs and Flymake compatible Pylint)

.. _pyreverse: https://pylint.pycqa.org/en/latest/pyreverse.html .. _symilar: https://pylint.pycqa.org/en/latest/symilar.html .. _epylint: https://pylint.pycqa.org/en/latest/user_guide/ide_integration/flymake-emacs.html

Projects that you might want to use alongside pylint include flake8_ (faster and simpler checks with very few false positives), mypy_, pyright_ or pyre_ (typing checks), bandit_ (security oriented checks), black_ and isort_ (auto-formatting), autoflake_ (automated removal of unused imports or variables), pyupgrade_ (automated upgrade to newer python syntax) and pydocstringformatter_ (automated pep257).

.. _flake8: https://gitlab.com/pycqa/flake8/ .. _bandit: https://github.com/PyCQA/bandit .. _mypy: https://github.com/python/mypy .. _pyright: https://github.com/microsoft/pyright .. _pyre: https://github.com/facebook/pyre-check .. _black: https://github.com/psf/black .. _autoflake: https://github.com/myint/autoflake .. _pyupgrade: https://github.com/asottile/pyupgrade .. _pydocstringformatter: https://github.com/DanielNoord/pydocstringformatter .. _isort: https://pycqa.github.io/isort/

.. This is used inside the doc to recover the end of the introduction

Install

.. This is used inside the doc to recover the start of the short text for installation

For command line use, pylint is installed with::

pip install pylint

It can also be integrated in most editors or IDEs. More information can be found in the documentation_.

.. _in the documentation: https://pylint.pycqa.org/en/latest/user_guide/installation/index.html

.. This is used inside the doc to recover the end of the short text for installation

Contributing

.. This is used inside the doc to recover the start of the short text for contribution

We welcome all forms of contributions such as updates for documentation, new code, checking issues for duplicates or telling us that we can close them, confirming that issues still exist, creating issues because you found a bug or want a feature_, etc. Everything is much appreciated!

Please follow the code of conduct_ and check the Contributor Guides_ if you want to make a code contribution.

.. _creating issues because you found a bug or want a feature: https://pylint.pycqa.org/en/latest/contact.html#bug-reports-feedback .. _code of conduct: https://github.com/PyCQA/pylint/blob/main/CODE_OF_CONDUCT.md .. _the Contributor Guides: https://pylint.pycqa.org/en/latest/development_guide/contribute.html

.. This is used inside the doc to recover the end of the short text for contribution

Show your usage

You can place this badge in your README to let others know your project uses pylint.

.. image:: https://img.shields.io/badge/linting-pylint-yellowgreen
    :target: https://github.com/PyCQA/pylint

Learn how to add a badge to your documentation in the the badge documentation_.

.. _the badge documentation: https://pylint.pycqa.org/en/latest/user_guide/installation/badge.html

License

pylint is, with a few exceptions listed below, GPLv2 <https://github.com/PyCQA/pylint/blob/main/LICENSE>_.

The icon files are licensed under the CC BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0/>_ license:

• doc/logo.png <https://raw.githubusercontent.com/PyCQA/pylint/main/doc/logo.png>_
• doc/logo.svg <https://raw.githubusercontent.com/PyCQA/pylint/main/doc/logo.svg>_

Support

Please check the contact information_.

.. _the contact information: https://pylint.pycqa.org/en/latest/contact.html

.. |tideliftlogo| image:: https://raw.githubusercontent.com/PyCQA/pylint/main/doc/media/Tidelift_Logos_RGB_Tidelift_Shorthand_On-White.png :width: 200 :alt: Tidelift

.. list-table:: :widths: 10 100

• • |tideliftlogo|
  • Professional support for pylint is available as part of the Tidelift Subscription_. Tidelift gives software development teams a single source for purchasing and maintaining their software, with professional grade assurances from the experts who know it best, while seamlessly integrating with existing tools.

.. _Tidelift Subscription: https://tidelift.com/subscription/pkg/pypi-pylint?utm_source=pypi-pylint&utm_medium=referral&utm_campaign=readme