Skip to main content

Bears for coala (Code Analysis Application)

Project description

.. Start ignoring LineLengthBear

::

.o88Oo._
d8P .ooOO8bo._
88 '*Y8bo.
__ YA '*Y8b __
,dPYb, YA 68o68**8Oo.
IP'`Yb "8D *"' "Y8o
I8 8I Y8 'YB .8D
I8 8P '8 d8' 8D
I8 8' 8 d8888b d AY
,gggo, ,ggggo, ,gggo,gg I8 dP ,gggo,gg Y, d888888 d' _.oP"
dP" "Yb dP" "Y8go*8P" "Y8I I8dP dP" "Y8I q. Y8888P' d8
i8' i8' ,8P i8' ,8I I8P i8' ,8I "q. `Y88P' d8"
,d8,_ _,d8, ,d8' d8, ,d8b,,d8b,_ ,d8, ,d8b, Y ,o8P
ooP""Y8888PP*"Y8888P" "Y8888P"`Y88P'"Y88P"Y8888P"`Y8 oooo888P"

.. Stop ignoring LineLengthBear

About
-----

coala-bears is a Python package containing all the bears that are officially
supported by coala. It features more than **65 bears** covering **35 languages**.
You can see all of them `here <https://github.com/coala-analyzer/coala-bears/wiki/Available-bears>`_.

+----------------------------+----------------------------+----------------------------+
| Languages coala provides algorithms for |
+============================+============================+============================+
| C++ | Lua | TypeScript |
+----------------------------+----------------------------+----------------------------+
| C# | Markdown | VHDL |
+----------------------------+----------------------------+----------------------------+
| CMake | Matlab/Octave | Vimscript |
+----------------------------+----------------------------+----------------------------+
| CoffeeScript | Natural Language (English) | XML |
+----------------------------+----------------------------+----------------------------+
| CSS | Perl | YAML |
+----------------------------+----------------------------+----------------------------+
| Dart | PHP | |
+----------------------------+----------------------------+----------------------------+
| Fortran | Python 2 | |
+----------------------------+----------------------------+----------------------------+
| Go | Python 3 | |
+----------------------------+----------------------------+----------------------------+
| Haskell | R | |
+----------------------------+----------------------------+----------------------------+
| HTML | reStructured Text | |
+----------------------------+----------------------------+----------------------------+
| Java | Ruby | |
+----------------------------+----------------------------+----------------------------+
| JavaScript | Scala | |
+----------------------------+----------------------------+----------------------------+
| JSP | SCSS | |
+----------------------------+----------------------------+----------------------------+
| Julia | sh & bash scripts | |
+----------------------------+----------------------------+----------------------------+
| Latex | SQL | |
+----------------------------+----------------------------+----------------------------+

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.readthedocs.org/en/latest/Users/Tutorials/Writing_Bears.html#guide-to-write-a-bear>`__.
There you can learn how to easily write bears yourself! Be sure to let us know
if you do so, then we'll be able to include it here and spread the word about it.

Installation
-------------

coala-bears can be installed with ``pip3 install coala-bears``. If you need more
information about the installation and dependencies, take a look at our
`installation documentation
<http://coala.rtfd.org/en/latest/Users/Install.html>`__.

The latest code from master is automatically deployed to PyPI as a
development version. Get it with ``pip3 install coala-bears --pre``.

Be sure to use the latest 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-analyzer/coala/wiki/FAQ#installation-is-failing-help>`__
in this case.

|PyPI|

Usage
-----

Basic analysis:

::

echo "print('Hi!') " >> hw.py
coala --files hw.py --bears SpaceConsistencyBear

Finding out what analysis routines exist:

::

coala -l JavaScript # Shows bears for JS
coala -A # Shows all bears
coala -B -b SpaceConsistencyBear # Shows full bear documentation

If you want to learn more about **coala-bears**, its functionality and its usage,
please take a look at our
`tutorial <http://coala.readthedocs.org/en/latest/Users/Tutorials/Tutorial.html>`__.

Authors
-------

coala-bears is maintained by a growing community. Please take a look at the
meta information in `setup.py <setup.py>`__ for current maintainers.

Getting Involved
----------------

If you want to contribute to coala-bears, please take a look at the `Getting
Involved Information
<http://coala.readthedocs.org/en/latest/Getting_Involved/README.html>`__.

We appreciate any help! Join us on one of:

- `gitter <https://gitter.im/coala-analyzer/coala/>`
- `#coala at freenode <webchat.freenode.net/?channels=coala>`
- `Telegram <https://telegram.me/joinchat/AuL-lwKZ8JLFZiI6SbtQVw>`

(All channels are linked with gitter. Approach @sils1297 if the link doesn't
work properly.)

Project Status
--------------

|Linux Build Status| |Windows Build status| |OSX Build status|

|Documentation Status| |codecov.io|

License
--------

|AGPL|

This code falls under the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.

Please note that some files or content may be copied from other places.
Most of them are GPL compatible. There is a small portion of code in the
tests that falls under the Creative Commons license, see
https://creativecommons.org/licenses/by-sa/3.0/deed.de for more
information.

.. |PyPI| image:: https://img.shields.io/pypi/v/coala-bears.svg
:target: https://pypi-hypernode.com/pypi/coala-bears
.. |Linux Build Status| image:: https://img.shields.io/circleci/project/coala-analyzer/coala-bears/master.svg?label=linux%20build
:target: https://circleci.com/gh/coala-analyzer/coala-bears
.. |Windows Build status| 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-analyzer/coala-bears/master.svg?label=branch%20coverage
:target: https://codecov.io/github/coala-analyzer/coala-bears
.. |https://gitter.im/coala-analyzer/coala| image:: https://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg
:target: https://gitter.im/coala-analyzer/coala
.. |AGPL| image:: https://img.shields.io/github/license/coala-analyzer/coala-bears.svg
:target: https://www.gnu.org/licenses/agpl-3.0.html

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coala-bears-0.3.0.dev20160514161102.tar.gz (14.1 MB view details)

Uploaded Source

Built Distribution

File details

Details for the file coala-bears-0.3.0.dev20160514161102.tar.gz.

File metadata

File hashes

Hashes for coala-bears-0.3.0.dev20160514161102.tar.gz
Algorithm Hash digest
SHA256 040f0a16ec7ecfeda7e428c7725aa5f84d6501de7d77eb55e2b4b2ab170a08ff
MD5 d1604e0cb1d330934ec24364f72305c2
BLAKE2b-256 b419cefe19779dbf77904736b52a2d707f9165b23ba75e632df6e2b3f219414a

See more details on using hashes here.

File details

Details for the file coala_bears-0.3.0.dev20160514161102-py3-none-any.whl.

File metadata

File hashes

Hashes for coala_bears-0.3.0.dev20160514161102-py3-none-any.whl
Algorithm Hash digest
SHA256 5e518667bf17d6c96a20b5268ae063f3494eb8d5dc063134db53d7b1230aa17c
MD5 7640fc7cc5a16ba8c77080a59975512d
BLAKE2b-256 dcf9f93677d3c25d80135d85841a916ef88997460ad5d5d599e1ab7615a8faeb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page