METADATA 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220
  1. Metadata-Version: 2.1
  2. Name: pylint
  3. Version: 2.12.2
  4. Summary: python code static checker
  5. Home-page: UNKNOWN
  6. Author: Python Code Quality Authority
  7. Author-email: code-quality@python.org
  8. License: GPL-2.0-or-later
  9. Project-URL: Homepage, https://www.pylint.org/
  10. Project-URL: Source Code, https://github.com/PyCQA/pylint
  11. Project-URL: What's New, https://pylint.pycqa.org/en/latest/whatsnew/
  12. Project-URL: Bug Tracker, https://github.com/PyCQA/pylint/issues
  13. Project-URL: Discord Server, https://discord.gg/Egy6P8AMB5
  14. Project-URL: Docs: User Guide, https://pylint.pycqa.org/en/latest/
  15. Project-URL: Docs: Contributing, https://pylint.pycqa.org/en/latest/development_guide/contribute.html
  16. Project-URL: Docs: Technical Reference, https://pylint.pycqa.org/en/latest/technical_reference/index.html
  17. Keywords: static code analysis linter python lint
  18. Platform: UNKNOWN
  19. Classifier: Development Status :: 6 - Mature
  20. Classifier: Environment :: Console
  21. Classifier: Intended Audience :: Developers
  22. Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
  23. Classifier: Operating System :: OS Independent
  24. Classifier: Programming Language :: Python
  25. Classifier: Programming Language :: Python :: 3
  26. Classifier: Programming Language :: Python :: 3 :: Only
  27. Classifier: Programming Language :: Python :: 3.6
  28. Classifier: Programming Language :: Python :: 3.7
  29. Classifier: Programming Language :: Python :: 3.8
  30. Classifier: Programming Language :: Python :: 3.9
  31. Classifier: Programming Language :: Python :: 3.10
  32. Classifier: Programming Language :: Python :: Implementation :: CPython
  33. Classifier: Programming Language :: Python :: Implementation :: PyPy
  34. Classifier: Topic :: Software Development :: Debuggers
  35. Classifier: Topic :: Software Development :: Quality Assurance
  36. Classifier: Topic :: Software Development :: Testing
  37. Requires-Python: >=3.6.2
  38. Description-Content-Type: text/x-rst
  39. License-File: LICENSE
  40. License-File: CONTRIBUTORS.txt
  41. Requires-Dist: platformdirs (>=2.2.0)
  42. Requires-Dist: astroid (<2.10,>=2.9.0)
  43. Requires-Dist: isort (<6,>=4.2.5)
  44. Requires-Dist: mccabe (<0.7,>=0.6)
  45. Requires-Dist: toml (>=0.9.2)
  46. Requires-Dist: typing-extensions (>=3.10.0) ; python_version < "3.10"
  47. Requires-Dist: colorama ; sys_platform == "win32"
  48. README for Pylint - https://pylint.pycqa.org/
  49. =============================================
  50. .. image:: https://github.com/PyCQA/pylint/actions/workflows/ci.yaml/badge.svg?branch=main
  51. :target: https://github.com/PyCQA/pylint/actions
  52. .. image:: https://coveralls.io/repos/github/PyCQA/pylint/badge.svg?branch=main
  53. :target: https://coveralls.io/github/PyCQA/pylint?branch=main
  54. .. image:: https://img.shields.io/pypi/v/pylint.svg
  55. :alt: Pypi Package version
  56. :target: https://pypi.python.org/pypi/pylint
  57. .. image:: https://readthedocs.org/projects/pylint/badge/?version=latest
  58. :target: https://pylint.readthedocs.io/en/latest/?badge=latest
  59. :alt: Documentation Status
  60. .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
  61. :target: https://github.com/ambv/black
  62. .. image:: https://results.pre-commit.ci/badge/github/PyCQA/pylint/main.svg
  63. :target: https://results.pre-commit.ci/latest/github/PyCQA/pylint/main
  64. :alt: pre-commit.ci status
  65. .. |tideliftlogo| image:: https://raw.githubusercontent.com/PyCQA/pylint/main/doc/media/Tidelift_Logos_RGB_Tidelift_Shorthand_On-White.png
  66. :width: 75
  67. :height: 60
  68. :alt: Tidelift
  69. .. list-table::
  70. :widths: 10 100
  71. * - |tideliftlogo|
  72. - Professional support for pylint is available as part of the `Tidelift
  73. Subscription`_. Tidelift gives software development teams a single source for
  74. purchasing and maintaining their software, with professional grade assurances
  75. from the experts who know it best, while seamlessly integrating with existing
  76. tools.
  77. .. _Tidelift Subscription: https://tidelift.com/subscription/pkg/pypi-pylint?utm_source=pypi-pylint&utm_medium=referral&utm_campaign=readme
  78. ======
  79. Pylint
  80. ======
  81. **It's not just a linter that annoys you!**
  82. Pylint is a Python static code analysis tool which looks for programming errors,
  83. helps enforcing a coding standard, sniffs for code smells and offers simple refactoring
  84. suggestions.
  85. It's highly configurable, having special pragmas to control its errors and warnings
  86. from within your code, as well as from an extensive configuration file.
  87. It is also possible to write your own plugins for adding your own checks or for
  88. extending pylint in one way or another.
  89. It's a free software distributed under the GNU General Public Licence unless
  90. otherwise specified.
  91. Development is hosted on GitHub: https://github.com/PyCQA/pylint/
  92. You can use the code-quality@python.org mailing list to discuss about
  93. Pylint. Subscribe at https://mail.python.org/mailman/listinfo/code-quality/
  94. or read the archives at https://mail.python.org/pipermail/code-quality/
  95. Pull requests are amazing and most welcome.
  96. Install
  97. -------
  98. Pylint can be simply installed by running::
  99. pip install pylint
  100. If you are using Python 3.6.2+, upgrade to get full support for your version::
  101. pip install pylint --upgrade
  102. If you want to install from a source distribution, extract the tarball and run
  103. the following command ::
  104. python setup.py install
  105. Do make sure to do the same for astroid, which is used internally by pylint.
  106. For debian and rpm packages, use your usual tools according to your Linux distribution.
  107. More information about installation and available distribution format
  108. can be found here_.
  109. Documentation
  110. -------------
  111. The documentation lives at https://pylint.pycqa.org/.
  112. Pylint is shipped with following additional commands:
  113. * pyreverse: an UML diagram generator
  114. * symilar: an independent similarities checker
  115. * epylint: Emacs and Flymake compatible Pylint
  116. Testing
  117. -------
  118. We use tox_ and pytest-benchmark_ for running the test suite. You should be able to install it with::
  119. pip install tox pytest pytest-benchmark
  120. To run the test suite for a particular Python version, you can do::
  121. tox -e py37
  122. To run individual tests with ``tox``, you can do::
  123. tox -e py37 -- -k name_of_the_test
  124. We use pytest_ for testing ``pylint``, which you can use without using ``tox`` for a faster development cycle.
  125. If you want to run tests on a specific portion of the code with pytest_, (pytest-cov_) and your local python version::
  126. # ( pip install pytest-cov )
  127. # Everything:
  128. python3 -m pytest tests/
  129. # Everything in tests/message with coverage for the relevant code:
  130. python3 -m pytest tests/message/ --cov=pylint.message
  131. coverage html
  132. # Only the functional test "missing_kwoa_py3":
  133. python3 -m pytest "tests/test_functional.py::test_functional[missing_kwoa_py3]"
  134. Do not forget to clone astroid_ and install the last version::
  135. git clone https://github.com/PyCQA/astroid.git
  136. # From source
  137. python3 astroid/setup.py build sdist
  138. pip3 install astroid/dist/astroid*.tar.gz
  139. # Using an editable installation
  140. cd astroid
  141. python3 -m pip install -e .
  142. For more detailed information, check the documentation.
  143. .. _here: https://pylint.pycqa.org/en/latest/user_guide/installation.html
  144. .. _tox: https://tox.readthedocs.io/en/latest/
  145. .. _pytest: https://docs.pytest.org/en/latest/
  146. .. _pytest-benchmark: https://pytest-benchmark.readthedocs.io/en/latest/index.html
  147. .. _pytest-cov: https://pypi.org/project/pytest-cov/
  148. .. _astroid: https://github.com/PyCQA/astroid
  149. License
  150. -------
  151. pylint is, with a few exceptions listed below, `GPLv2 <https://github.com/PyCQA/pylint/blob/main/LICENSE>`_.
  152. The icon files are licensed under the `CC BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0/>`_ license:
  153. - `doc/logo.png <https://raw.githubusercontent.com/PyCQA/pylint/main/doc/logo.png>`_
  154. - `doc/logo.svg <https://raw.githubusercontent.com/PyCQA/pylint/main/doc/logo.svg>`_