coala: Linting and fixing code for all languages
coala provides a unified command-line interface for linting and fixing all your code, regardless of the programming languages you use.
With coala, users can create rules and standards to be followed in the source code. coala has an user-friendly interface that is completely customizable. It can be used in any environment and is completely modular.
To see what coala can do for your language, run:
$ coala --show-bears --filter-by-language Python
You can generate a configuration from your command line arguments with the -s argument. Alternatively you can use coala-quickstart to generate a configuration tailored for your project.
|Official Website||Documentation||Video Demo|
- User-friendly interfaces such as JSON, interactive CLI or any custom format.
- Plugins for gedit, Sublime Text, Atom, Vim and Emacs.
- Optimized performace with multi-threading to parallelize the routines - can complete a 26000 line python repository in less than 3 seconds.
- File caching support - run only on changed files.
To install the latest stable version run:
$ pip3 install coala
Make sure you have Python >= 3.4 and pip >= 6 installed.
To install the latest development version run:
$ pip3 install coala --pre
The 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:
$ pip3 install coala-bears
You can also use
cib (coala Installs Bears), which is an experimental bear
manager that lets you install, upgrade, uninstall, check dependencies, etc.
for bears. To install it, run:
$ pip3 install cib
For usage instructions, consult this link.
There are two options to run coala:
- using a
.coafile, a project specific configuration file that will store all your settings for coala
- using command-line arguments
.coafile will look something like this:
[Spacing] files = src/**/*.py bears = SpaceConsistencyBear use_spaces = True
fileskey tells coala which files to lint - here we're linting all python files inside the
src/directory by using a glob expression.
bearskey specifies which bears (plugins) you want to use. We support a huge number of languages and you can find the whole list here. If you don't find your language there, we've got some bears that work for all languages. Or you can file an issue and we would create a bear for you!
use_spacesenforces spaces over tabs in the codebase.
use_spacesis a setting for the
[Spacing] is a section. Sections are executed in the order you
Store the file in the project's root directory and run coala:
Please read our coafile specification to learn more.
Using command-line arguments
However, if you don't want to save your settings, you can also run coala with command line arguments:
$ coala --files=setup.py --bears=SpaceConsistencyBear -S use_spaces=True
Note that this command does the same thing as having a coafile and running coala. The advantage of having a coafile is that you don't need to enter the settings as arguments everytime.
To get the complete list of arguments and their meaning, run:
$ coala --help
You can find a quick demo of coala here:
If you would like to be a part of the coala community, you can check out our Getting In Touch 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 newcomer guide 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.
Feel free to contact us at our Gitter channel, we'd be happy to help!
You can also drop an email at our mailing list.
coala is maintained by a growing community. Please take a look at the meta information in setup.py for the current maintainers.