third_party.pylibs.pylint.src/README.rst

82 lines
2.7 KiB
ReStructuredText
Raw Normal View History

2014-11-14 18:43:27 +00:00
README for Pylint - http://pylint.pycqa.org/
============================================
2014-11-14 18:43:27 +00:00
2015-12-16 15:29:35 +00:00
.. image:: https://travis-ci.org/PyCQA/pylint.svg?branch=master
:target: https://travis-ci.org/PyCQA/pylint
2015-12-16 15:41:49 +00:00
.. image:: https://ci.appveyor.com/api/projects/status/rbvwhakyj1y09atb/branch/master?svg=true
:alt: AppVeyor Build Status
:target: https://ci.appveyor.com/project/PCManticore/pylint
.. image:: https://coveralls.io/repos/github/PyCQA/pylint/badge.svg?branch=master
:target: https://coveralls.io/github/PyCQA/pylint?branch=master
2016-05-17 09:21:59 +00:00
.. image:: https://img.shields.io/pypi/v/pylint.svg
:alt: Pypi Package version
:target: https://pypi.python.org/pypi/pylint
2016-06-29 17:51:21 +00:00
.. image:: https://readthedocs.org/projects/pylint/badge/?version=latest
:target: http://pylint.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
2014-11-14 18:43:27 +00:00
Pylint is a Python source code analyzer which looks for programming errors,
helps enforcing a coding standard and sniffs for some code smells (as defined in
Martin Fowler's Refactoring book).
Pylint has many rules enabled by default, way too much to silence them all on a
minimally sized program. It's highly configurable and handle pragmas to control
it from within your code. Additionally, it is possible to write plugins to add
your own checks.
It's a free software distributed under the GNU General Public Licence.
2014-11-14 18:43:27 +00:00
2015-12-10 14:29:29 +00:00
Development is hosted on GitHub: https://github.com/PyCQA/pylint/
2014-11-14 18:43:27 +00:00
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/
Install
-------
Pylint requires astroid package (the later the better).
2014-11-14 18:43:27 +00:00
2015-12-10 14:29:29 +00:00
* https://github.com/PyCQA/astroid
2014-11-14 18:43:27 +00:00
Installation should be as simple as ::
2014-11-14 18:43:27 +00:00
python -m pip install astroid
Pylint requires isort package (the later the better).
* https://github.com/timothycrosley/isort
Installation should be as simple as ::
python -m pip install isort
If you want to install from a source distribution, extract the tarball and run
the following commands ::
2014-11-14 18:43:27 +00:00
python setup.py install
You'll have to install dependencies in a similar way. For debian and
rpm packages, use your usual tools according to your Linux distribution.
More information about installation and available distribution format
may be found in the user manual in the *doc* subdirectory.
Documentation
-------------
Look in the doc/ subdirectory or at http://pylint.pycqa.org/
2014-11-14 18:43:27 +00:00
Pylint is shipped with following additional commands:
* pyreverse: an UML diagram generator
* symilar: an independent similarities checker
* epylint: Emacs and Flymake compatible Pylint