.. image:: https://cloud.githubusercontent.com/assets/7521600/15992701/ef245fd4-30ef-11e6-992d-275c5ca7c3a0.jpg
coala-bears is a Python package containing all the bears that are officially
supported by coala. It features more than 78 bears covering
54 languages. Here is a generated list <https://github.com/coala/bear-docs/>_
that contains information about each bear, such as the languages it supports and
what fixes it can apply to your code.
|Throughput Graph|
.. contents:: :local: :depth: 1 :backlinks: none
To install the latest stable version, run:
.. code-block:: bash
$ pip3 install coala-bears|Stable|
To install the latest development version, run:
.. code-block:: bash
$ pip3 install coala-bears --preThe latest code from the master branch is automatically deployed as the development version in PyPI.
To also install all bears for coala at once, run:
.. code-block:: bash
$ pip3 install coala-bearsBe sure to use the latest version of pip, the default pip from Debian doesn't
support our dependency version number specifiers. You will have to use a virtualenv <https://github.com/coala/coala/wiki/FAQ#installation-is-failing-help>__
in this case.
|PyPI| |Windows| |Linux|
To see what coala can do for your language, run:
.. code-block:: bash
$ coala --show-bears --filter-by-language Python+----------------------------+----------------------------+----------------------------+ | Languages coala provides algorithms for | +============================+============================+============================+ | C | Latex | SQL | +----------------------------+----------------------------+----------------------------+ | C++ | Lua | Stylus | +----------------------------+----------------------------+----------------------------+ | C# | Markdown | Swift | +----------------------------+----------------------------+----------------------------+ | CMake | Matlab/Octave | TypeScript | +----------------------------+----------------------------+----------------------------+ | CoffeeScript | Natural Language (English) | Verilog | +----------------------------+----------------------------+----------------------------+ | CSS | Perl | VHDL | +----------------------------+----------------------------+----------------------------+ | Dart | PHP | Vimscript | +----------------------------+----------------------------+----------------------------+ | Fortran | Python 2 | XML | +----------------------------+----------------------------+----------------------------+ | Go | Python 3 | YAML | +----------------------------+----------------------------+----------------------------+ | Haskell | R | | +----------------------------+----------------------------+----------------------------+ | HTML | reStructured Text | | +----------------------------+----------------------------+----------------------------+ | Java | Ruby | | +----------------------------+----------------------------+----------------------------+ | JavaScript | Scala | | +----------------------------+----------------------------+----------------------------+ | JSP | SCSS | | +----------------------------+----------------------------+----------------------------+ | Julia | sh & bash scripts | | +----------------------------+----------------------------+----------------------------+
The number of bears grows every day! If you want to see any particular
functionality be sure to submit an issue, but please read the Getting Involved_
section before doing so.
You can read more at our documentation <http://coala.io/writingbears>__.
There you can learn how to easily write bears yourself! Be sure to let us know
if you do so, so we'll be able to include it here and spread the word about it.
For more information about how to do basic analysis, check out the
coala README <https://github.com/coala/coala#usage>__.
If you would like to be a part of the coala community, you can check out our
Getting In Touch <http://coala.readthedocs.io/en/latest/Help/Getting_In_Touch.html>__
page or ask us at our active Gitter channel, where we have maintainers from
all over the world. We appreciate any help!
We also have a
Newcomers' Guide <https://coala.io/newcomer>
to help you get started by fixing an issue yourself! If you get stuck anywhere
or need some help, feel free to contact us on Gitter or drop a mail at our
newcomer mailing list <https://groups.google.com/d/forum/coala-newcomers>.
|gitter|
Feel free to contact us at our Gitter channel <https://gitter.im/coala/coala>__, we'd be happy to help!
If you are interested in commercial support, please contact us on the Gitter channel as well.
You can also drop an email at our
mailing list <https://github.com/coala/coala/wiki/Mailing-Lists>__.
coala is maintained by a growing community. Please take a look at the
meta information in setup.py <setup.py>__ for the current maintainers.
|AGPL|
.. |Stable| image:: https://img.shields.io/badge/latest%20stable-0.11.1-green.svg .. |PyPI| image:: https://img.shields.io/pypi/v/coala-bears.svg :target: https://pypi.python.org/pypi/coala-bears .. |Windows| image:: https://img.shields.io/appveyor/ci/coala/coala-bears/master.svg?label=windows%20build :target: https://ci.appveyor.com/project/coala/coala-bears/branch/master .. |Documentation Status| image:: https://readthedocs.org/projects/coala/badge/?version=latest :target: http://coala.rtfd.org/ .. |codecov.io| image:: https://img.shields.io/codecov/c/github/coala/coala-bears/master.svg?label=branch%20coverage :target: https://codecov.io/github/coala/coala-bears .. |gitter| image:: https://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg :target: https://gitter.im/coala/coala .. |AGPL| image:: https://img.shields.io/github/license/coala/coala-bears.svg :target: https://www.gnu.org/licenses/agpl-3.0.html .. |Throughput Graph| image:: https://graphs.waffle.io/coala/coala-bears/throughput.svg :target: https://waffle.io/coala/coala-bears/metrics/throughput :alt: 'Throughput Graph'