123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220 |
- Metadata-Version: 2.1
- Name: pylint
- Version: 2.12.2
- Summary: python code static checker
- Home-page: UNKNOWN
- Author: Python Code Quality Authority
- Author-email: code-quality@python.org
- License: GPL-2.0-or-later
- Project-URL: Homepage, https://www.pylint.org/
- Project-URL: Source Code, https://github.com/PyCQA/pylint
- Project-URL: What's New, https://pylint.pycqa.org/en/latest/whatsnew/
- Project-URL: Bug Tracker, https://github.com/PyCQA/pylint/issues
- Project-URL: Discord Server, https://discord.gg/Egy6P8AMB5
- Project-URL: Docs: User Guide, https://pylint.pycqa.org/en/latest/
- Project-URL: Docs: Contributing, https://pylint.pycqa.org/en/latest/development_guide/contribute.html
- Project-URL: Docs: Technical Reference, https://pylint.pycqa.org/en/latest/technical_reference/index.html
- Keywords: static code analysis linter python lint
- Platform: UNKNOWN
- Classifier: Development Status :: 6 - Mature
- Classifier: Environment :: Console
- Classifier: Intended Audience :: Developers
- Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
- Classifier: Operating System :: OS Independent
- Classifier: Programming Language :: Python
- Classifier: Programming Language :: Python :: 3
- Classifier: Programming Language :: Python :: 3 :: Only
- Classifier: Programming Language :: Python :: 3.6
- Classifier: Programming Language :: Python :: 3.7
- Classifier: Programming Language :: Python :: 3.8
- Classifier: Programming Language :: Python :: 3.9
- Classifier: Programming Language :: Python :: 3.10
- Classifier: Programming Language :: Python :: Implementation :: CPython
- Classifier: Programming Language :: Python :: Implementation :: PyPy
- Classifier: Topic :: Software Development :: Debuggers
- Classifier: Topic :: Software Development :: Quality Assurance
- Classifier: Topic :: Software Development :: Testing
- Requires-Python: >=3.6.2
- Description-Content-Type: text/x-rst
- License-File: LICENSE
- License-File: CONTRIBUTORS.txt
- Requires-Dist: platformdirs (>=2.2.0)
- Requires-Dist: astroid (<2.10,>=2.9.0)
- Requires-Dist: isort (<6,>=4.2.5)
- Requires-Dist: mccabe (<0.7,>=0.6)
- Requires-Dist: toml (>=0.9.2)
- Requires-Dist: typing-extensions (>=3.10.0) ; python_version < "3.10"
- Requires-Dist: colorama ; sys_platform == "win32"
- README for Pylint - https://pylint.pycqa.org/
- =============================================
- .. image:: https://github.com/PyCQA/pylint/actions/workflows/ci.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://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
- .. |tideliftlogo| image:: https://raw.githubusercontent.com/PyCQA/pylint/main/doc/media/Tidelift_Logos_RGB_Tidelift_Shorthand_On-White.png
- :width: 75
- :height: 60
- :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
- ======
- Pylint
- ======
- **It's not just a linter that annoys you!**
- Pylint is a Python static code analysis tool which looks for programming errors,
- helps enforcing a coding standard, sniffs for code smells and offers simple refactoring
- suggestions.
- It's highly configurable, having special pragmas to control its errors and warnings
- from within your code, as well as from an extensive configuration file.
- It is also possible to write your own plugins for adding your own checks or for
- extending pylint in one way or another.
- It's a free software distributed under the GNU General Public Licence unless
- otherwise specified.
- Development is hosted on GitHub: https://github.com/PyCQA/pylint/
- You can use the code-quality@python.org mailing list to discuss about
- Pylint. Subscribe at https://mail.python.org/mailman/listinfo/code-quality/
- or read the archives at https://mail.python.org/pipermail/code-quality/
- Pull requests are amazing and most welcome.
- Install
- -------
- Pylint can be simply installed by running::
- pip install pylint
- If you are using Python 3.6.2+, upgrade to get full support for your version::
- pip install pylint --upgrade
- If you want to install from a source distribution, extract the tarball and run
- the following command ::
- python setup.py install
- Do make sure to do the same for astroid, which is used internally by pylint.
- For debian and rpm packages, use your usual tools according to your Linux distribution.
- More information about installation and available distribution format
- can be found here_.
- Documentation
- -------------
- The documentation lives at https://pylint.pycqa.org/.
- Pylint is shipped with following additional commands:
- * pyreverse: an UML diagram generator
- * symilar: an independent similarities checker
- * epylint: Emacs and Flymake compatible Pylint
- Testing
- -------
- We use tox_ and pytest-benchmark_ for running the test suite. You should be able to install it with::
- pip install tox pytest pytest-benchmark
- To run the test suite for a particular Python version, you can do::
- tox -e py37
- To run individual tests with ``tox``, you can do::
- tox -e py37 -- -k name_of_the_test
- We use pytest_ for testing ``pylint``, which you can use without using ``tox`` for a faster development cycle.
- If you want to run tests on a specific portion of the code with pytest_, (pytest-cov_) and your local python version::
- # ( pip install pytest-cov )
- # Everything:
- python3 -m pytest tests/
- # Everything in tests/message with coverage for the relevant code:
- python3 -m pytest tests/message/ --cov=pylint.message
- coverage html
- # Only the functional test "missing_kwoa_py3":
- python3 -m pytest "tests/test_functional.py::test_functional[missing_kwoa_py3]"
- Do not forget to clone astroid_ and install the last version::
- git clone https://github.com/PyCQA/astroid.git
- # From source
- python3 astroid/setup.py build sdist
- pip3 install astroid/dist/astroid*.tar.gz
- # Using an editable installation
- cd astroid
- python3 -m pip install -e .
- For more detailed information, check the documentation.
- .. _here: https://pylint.pycqa.org/en/latest/user_guide/installation.html
- .. _tox: https://tox.readthedocs.io/en/latest/
- .. _pytest: https://docs.pytest.org/en/latest/
- .. _pytest-benchmark: https://pytest-benchmark.readthedocs.io/en/latest/index.html
- .. _pytest-cov: https://pypi.org/project/pytest-cov/
- .. _astroid: https://github.com/PyCQA/astroid
- 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>`_
|