This bugfix release addressed the following issues:
- The cache will be correctly invalidated when changing section targets now. (coala#2708)
- Dependencies are resolved before asking the user for needed values. This will only affect custom bears that have dependencies that require settings. (coala#2709)
- PyPrint was updated from 0.2.4 to 0.2.5.
- PipRequirement uses
sys.executableinstead of hardcoded python. This will only affect coala or bear developers.
-
`Ns :s-
. mMd` :Nd.
:h /ss/` +md.
dN` :NMMMy` .ymmy. -+`
dM+ dMMMMMm`.NMMMMN. +Mo
` -sddy: yMMMMMM/+MMMMMMo dMo
s/ +MMMMMy.dMMMMM-:MMMMMM+ -yhs`
.Ms /MMMMMMo /hdh: oMMMMh`+MMMMm.
-MN. hMMMMMh `/osssoos+- dMMMMMs
oyhho.+mMMm:+dMMMMMMMMMm+ sMMMMMs
mMMMMMy``` dMMMMMMMMMMMMMh.`sMMMh`
yMMMMMMy `MMMMMMMMMMMMMMMMy:..`
`yMMMMMd yMMMMMMMMMMMMMMMMMMMMNh+`
.ohhs-+mMMMMMMMMMMMMMMMMMMMMMMMMd
.yMMMMMMMMMMMMMMMMMMMMMMMMMMMh
mMMMMMMMMMMMMMMMMMMMMMMMMMMMh`
yMMMMMMMMMMMMMMMNhssssyyyso-
/dMMMMMMMMMNy+.
./syhys/-
For this release, we have had 46 developers from around the world contributing over 150 commits in the last 9 weeks.
Improving the API available for bear writers is one of the areas we've focused on for this release, with several new and exciting features. General performance has also been improved heavily with some major changes under the hood. The documentation has also been worked on, with an emphasis on user-friendliness and design.
There have also been major internal changes in preparation for the complete decentralization of bears, which would allow the installation of individual bears.
Below are some of the important changes introduced for this release:
New Features
- coala now supports syntax highlighting in results!
- Questions are now printed in color; this will improve visibility when a lot of text is written to the screen.
coala-jsonnow supports--show-bearsand--filter-by-language- Added a
--show-capabilitiesflag that displays the types of issues coala can detect and fix for a particular language. - Display the line number when a line is missing; this could happen if a bear that had run previously overwrites it.
For Bear Writers
- Bears now have a new
REQUIREMENTSattribute which will be used to automatically resolve bear dependencies. This includes:- Native requirements (from package managers such as
apt-get,dnf,pacman, ...) - Conda requirements
- Python requirements through
pip gorequirements- Ruby requirements through
gem - NodeJS requirements through
npm - RScript requirements
- Julia requirements
- Native requirements (from package managers such as
- Language independent documentation parsing routines: these can be used to make bears for linting documentation without having to worry about the language.
coalangnow supports C, C++, CSS, Java, Python3 and Vala.- A new bear creation tool has been released: with this tool, it's easier than ever before to create external linter based bears for coala!
- A new ASCIINEMA_URL attribute has been added to bears. This should contain an URL to an asciinema video displaying the bear's capabilities in action.
- Bear results may now have a
confidenceparameter: this is supposed to quantify the confidence, on a scale of 1 to 100, the bear has when flagging results. - A
deprecate_settingsdecorator has been created to deprecate old, unsupported bear parameters. Please see here for an example usage. Code Simplificationhas been added to the set of possible fixes that bears can offer.
Bug Fixes
- Fixed an issue where errors were generated for lines containing only a single tab character. Issue #2180
- Fixed an issue with question where stray escape characters may be present. Issue #2546
- Group questions about missing values in a coafile by bears. Issue #2530
- An issue where an exception was raised wrongly when the same diff was generated multiple times has been fixed. PR #2465
Performance
- Caching is now enabled by default. This is a huge performance improvement
for HDD users - we've seen a 2x improvement when coala is run on coala.
To disable caching run coala with the
--disable-cachingflag. - An issue where coala takes over 2 seconds to print the help manual through
--helphas been fixed. Issue #2344 - A small performance improvement from reusing already loaded file contents.
Documentation
- A complete overhaul to the README page with a focus on design and readability.
- A new FAQ page has been created.
- Various other documentation pages have been improved with new resources, better explanations, and some corrections.
- The whole documentation has been moved to a separate repository. Please file any documentation related issues over there.
Regressions
- Dropped Python 3.3 support
Internal Changes
- There has been a shift of several modules from coala to
coala-utils <https://gitlab.com/coala/coala-utils/>. This includes the whole
StringProcessinglibrary,ContextManagers, and some decorators.
,o8b, .o88Oo._
P d d8P .ooOO8bo._
d' p 88 '*Y8bo.
.Y ." YA '*Y8b __
db, d" _ooQ.dPQ, YA 68o68**8Oo.
.8' YI.Y" b B "8D *"' "Y8o
.Y ;L 8, Yq.8 Y8 'YB .8D
B .db_.L q, q "q '8 d8' 8D
8" qp 8, 8 8 d8888b d AY
8 ",dP Y, d888888 d' _.oP"
"q 8; q. Y8888P' d8
'8 b "q. `Y88P' d8"
'D, ,8 Y ,o8P
'odY' oooo888P"
(Release logo by Fabian Neuschmidt)
For this release, 32 people from all over the world have contributed about 200 commits over almost two months.
The focus of this release is certainly on the usability of coala. Usability testing has made us aware of some important difficulties, users have to face when trying out coala. We have implemented a lot of countermeasures to lower this barrier.
The changelog below summarizes the most important user facing changes. Not listed are especially lots of internal improvements and documentation fixes.
New Features:
- Shell Autocompletion
- Patches are shown without prompting the user if small enough, otherwise diffstats.
- Bears have metadata and can be browsed. Browse the bear documentation repository for more information on all the bears.
- Lots of usability improvements! coala will suggest using certain options if no meaningful configuration was supplied.
- The help was revamped completely and is way easier to read.
- A
--verbosealias is available for-L DEBUG. - The
default_actionssetting accepts globs for bears now. - The
--apply-patchesargument was added to automatically apply all patches. - coala supports experimental caching. This can lower the run time to a
fraction of the time needed to perform the full analysis. It will be enabled
by default in the next release. To use it, invoke coala with
--changed-files. - Bear showing is divided into a new set of settings:
--show-bearsshows all bears,--filter-by-languageallows to filter them,--show-detailsand--show-descriptionallow changing verbosity of the output.
Feature Removals:
- Tagging was removed.
linterdoes no longer show the executable of the bear by default.
Performance Improvements:
- Globs will be internally cached now so they don't need to be retranslated every time. This may show improvements of several seconds when working with a large set of files.
- coala supports experimental caching. See
New Featuresfor more information. - coala does not delete
*.origfiles on startup anymore. This was a huge performance hit especially on HDDs or big file trees. The cleanup can be performed manually by runningcoala-delete-orig. Instead coala will keep track of*.origfiles more smartly.
Bugfixes:
**.pycan again be used instead**/*.py.- If errors happen before the initialization of logging, tracebacks will be shown.
For bear writers:
- Bears can have a number of attributes now, including author information, supported languages or categories. A requirements attribute will help generating requirements definition files more easily in the future.
- The
linterwrapper provides aresult_severityand aresult_messageparameter now. - Bears can now delete and rename files.
- The
LanguageDefinitiondoesn't need alanguage_familyanymore to load language definitions. - Results can be created directly from the Bear class more conveniently
with
self.new_result(...).
.o88Oo._ .". " .".
d8P .ooOO8bo._ dPo. O#O .oPb
88 '*Y8bo. 88o. .o#o. .o88
YA '*Y8b __ Y88o. .8. .o88Y
YA 68o68**8Oo. W8888O888888888W
"8D *"' "Y8o w8888'88'8888w
Y8 'YB .8D `o88:88:88o'
'8 d8' 8D .O8`88'8O.
8 d8888b d AY oO8I88I8Oo
Y, d888888 d' _.oP" oO8|88|Oo
q. Y8888P' d8 oO8.88.8Oo
"q. `Y88P' d8" .oO.88.Oo.
Y ,o8P .oO888888Oo.
oooo888P" .oO8 8Oo.
+oO8+ +8Oo+
'bo. .od'
This release is shaped a lot by working on high quality bear writing tools. Our codebase has matured further (improved tests, various internal improvements) and key features for writing and organizing bears were introduced.
Over the last 1.5 months, 22 unique contributors have helped us at the coala core project.
This time, the release logo is carefully hand crafted by Max Scholz!
New features:
- Smart globbing: use backslashes without an extra escape now if they don't escape delimiters.
- Results now can have additional information appended.
- Bears expose information on which languages they support. You can query for
bears e.g. with
coala --show-language-bears C++for C++.
Bugfixes:
- Linters suppress the output correctly now when checking for linter availibility. (coala#1888)
- The result filter algorithms can handle file additions and deletions now. (coala#1866)
- Ignore statements without a stop statement are now accepted as well (coala#2003).
For bear writers:
- A tutorial for managing bear dependencies is available in our documentation now.
- The Result object has a field
additional_infowhich can be used to give an elaborate description of the problem. - A
typechain()function is now available for easy conditional type conversion. (coala#1859) - Bears have a
name()shortcut now which provides the bear class name. - A
get_config_directory()function is available that returns the root directory of the project guessed by coala or provided (overridden) by the user. - A new
linterdecorator makes it even easier to write new linter wrappers. (coala#1928)
Notable internal/API changes:
FunctionMetadatahas a newmergefunction that can be used to merge function signatures and documentation comments.
.o88Oo._
d8P .ooOO8bo._
88 '*Y8bo.
YA '*Y8b __
YA 68o68**8Oo.
"8D *"' "Y8o
Y8 'YB .8D
'8 d8' 8D
8 d8888b d AY
Y, d888888 d' _.oP"
,q. Y8888P' d8,
d "q. `Y88P' d8" b
Y, Y ,o8P ,Y
8q. oooo888P" .p8
8 "qo._ _.op" 8
8 '"P8866ooo6688P"' 8
8 8
8 8
8. .8
"b d"
'b d'
8 8
q. .p
q. .p
"qo._ _.op"
'"P8866ooo6688P"'
With this release we declare coala proudly as beta. Most features are now available and coala is ready for daily use.
All bears have been moved out of coala into the coala-bears package. If you
want to develop bears for coala, you can now install it without the bears just
as before. If you want to use the coala official bears, make sure to install the
coala-bears package and if needed follow the instructions to install linters
needed by the bears for your language.
According to git shortlog -s -n 5fad168.. 56 people contributed to this
release. We sadly cannot name all the new coalaians here but every single
one of them helped making coala as awesome and polished as it is today.
New features:
--no-configallows to ignore existing coafiles in the current directory. (coala#1838)In-file ignore directives now support globs. (coala#1781)
coala-jsonsupports the--relpathargument so the JSON output can be moved to other systems reasonably. (coala#1593)--bear-dirsare now searched recursively. They are also added to the Python PATH so imports relative to a given bear directory work. (coala#1711,coala-formatexposes the{severity_str}so you can get a human readable severity in your self formatted result representation. (coala#1313)Spaces and tabs are highlighted in the CLI to make whitespace problems obvious. (coala#606)
Actions that are not applicable multiple times are not shown after applying them anymore. (coala#1064)
Documentation about how to add coala as a pre commit hook has been added: http://coala.readthedocs.org/en/latest/Users/Git_Hooks.html
Actions emit a success message now that is shown to the user and improves usability and intuitivity of actions.
A warning is emitted if a bear or file glob does not match any bears or files.
coala-jsonsupports now a--text-logsargument so you can see your logs in realtime, outside the JSON output if requested. You can output the JSON output only into a file with the new-oargument. (coala#847,coala-ciyields a beautiful output now, showing the issues noninteractively. (coala#1256)A
coala-delete-origscript is now available to delete autogenerated backup files which were created when a patch was applied. This is called automatically on every coala run. (coala#1253)The
--limit-filesCLI argument was introduced which is especially useful for writing performant editor plugins.
Exitcode changes:
- coala returns
5if patches were applied successfully but no other results were yielded, i.e. the code is correct after the execution of coala but was not before. - coala returns
4now if executed with an unsupported python version.
Bugfixes:
- The
appdirsmodule is now used for storing tagged data. (coala#1805) - Package version conflicts are now handled with own error code
13. (coala#1748) - Previously inputted values for actions are not stored any more if the action fails. (coala#1825)
- coala doesn't crash any more on Windows when displaying a diff. Happened due to the special chars used for whitespace-highlighting Windows terminals do not support by default. (coala#1832)
- Escaped characters are written back to the
.coafilecorrectly. (coala#921) coala-jsondoesn't show logs when invoked with-vor-hanymore (coala#1377)- Keyboard interrupts are handled more cleanly. (coala#871)
- Tagging will only emit a warning if the data directory is not writable instead of erroring out. (coala#1050)
- Unicode handling has been improved. (coala#1238)
- Cases where
--find-confighas not found the configuration correctly have been resolved. (coala#1246) - Some cases, where result ignoring within files didn't work have been resolved. (coala#1232)
For bear writers:
- A new built-in type is available from
Settingfor using insiderun()signature:url. Lintbased bears have a new argument which can be set to test whether a command runs without errors. This can be used to check for example the existence of a Java module. (coala#1803)- The
CorrectionBasedBearandLintclass have been merged into the new and more powerfulLintclass to make linter integration even easier. It also supports you if you need to generate an actual configuration file for your linter. LocalBearTestHelperas well as theverify_local_bearhave been revamped to make it even easier to test your bears and debug your tests.- File dictionaries are now given as tuples and are thus not modifyable.
- A number of new tutorials about bear creation have been written.
- Bears can now be registered at coala and thus be distributed as own packages.
Notable internal changes:
- API documentation is now available at http://coala.readthedocs.org/en/latest/API/modules.html
- coala switched to PyTest. Our old own framework is no longer maintained. (coala#875)
- As always loads of refactorings to make the code more stable, readable and beautiful!
- The main routines for the coala binaries have been refactored for less redundancy. If you are using them to interface to coala directly, please update your scripts accordingly.
- Loads of new integration tests have been written. We're keeping our 100% test coverage promise even for all executables now.
88 .o88Oo._ 8 |8 d8P .ooOO8bo._ 8 | 8 88 '*Y8bo. 8\ | /8 YA '*Y8b __ 8 \|/ 8 YA 68o68**8Oo. 8\ Y 8 "8D *"' "Y8o 8 \ | /8 Y8 'YB .8D 8 \|/ /8 '8 d8' 8D 8\ Y / 8 8 d8888b d AY 8 \ / / 8 Y, d888888 d' _.oP" 8 \|/ 8 q. Y8888P' d8 8 Y 8 "q. `Y88P' d8" 8 | 8 Y ,o8P 8 | 8 oooo888P"
New features:
- Auto-apply can be enabled/disabled through the
autoapplysetting in a coafile. - Auto-applied actions print the actual file where something happened.
- A new bear was added, the GitCommitBear! It allows to check your current commit message at HEAD from git!
- Filenames of results are now printed relatively to the execution directory. (coala#1124)
Bugfixes:
- coala-json outputted results for file-ranges that were excluded. (coala#1165)
- Auto-apply actions that failed are now marked as unprocessed so the user can decide manually what he wants to do with them. (coala#1202)
- SpaceConsistencyBear: Fixed misleading message when newline at EOF is missing. (coala#1185)
- Results from global bears slipped through our processing facility. Should not happen any more.
We are dropping Python 3.2 support (and so PyPy). Also we are removing translations, the default language is English.
This release contains these following feature changes:
- Auto-apply feature added! Results can directly be processed without user interaction specifying the desired action!
- A missing coafile that is explicitly wanted through the
--configflag throws an error instead of a warning. Only default coafile names (ending with.coafile) raise a warning. - Various new bears integrating existing linter tools, e.g. for C/C++, Python, Ruby, JSON and many more!
- Allow to ignore files inside the coafile.
- Results can now be stored and tagged with an identifier for accessing them later.
- OpenEditorAction lets the user edit the real file instead of a temporary one.
- All usable bears can now be shown with
--show-all-bears. - Only
#is supported for comments in the configuration file syntax. - Multiple actions can now be executed on the CLI.
- Patches can now be shown on the CLI.
- A
coala-formatbinary was added that allows customized formatting for results to ease integration in other systems. - Printing utilities have moved into the PyPrint library.
Bear API changes:
- A bear can implement
check_prerequisitesto determine whether it can execute in the current runtime. - The PatchResult class was merged into the Result class.
Bear changes:
- SpaceConsistencyBear offers more verbose and precise information about the problem.
.o88Oo._
d8P .ooOO8bo._
88 '*Y8bo.
'*Y8b __
YA 68o68**8Oo. _.o888PY88o.o8
"8D *"' "Y8o.o88P*' Y.
Y8 'YB .8D Y.
'8 d8' 8D o 8
8 d8888b d AY o d'
Y, d888888 d' _.oP" d88b 8
q. Y8888P' d8 Y, d8888 P
"q. `Y88P' d8" q. Y888P .d'
Y ,o8P "q `"' ,oP
oooo888P" `Y .o8P"
8ooo888P"
This release features the following feature changes:
--find-configflag: Searches for .coafile in all parent directories.- Add code clone detection bears and algorithms using CMCD approach.
- Console color gets properly disabled now for non-supporting platforms (like Windows).
- coala results can be outputted to JSON format using the
coala-jsoncommand. - Automatically add needed flags to open a new process for some editors.
- Save backup before applying actions to files.
- Return nonzero when erroring or yielding results.
- Write newlines before beginning new sections in coafiles when appropriate.
- The default_coafile can now be used for arbitrary system-wide settings.
- coala can now be configured user-wide with a ~/.coarc configuration file.
- Manual written documentation is now hosted at http://coala.rtfd.org/.
- Changed logging API in Bears (now: debug/warn/err).
- clang python bindings were added to the bearlib.
- Exitcodes were organized and documented. (http://coala.readthedocs.org/en/latest/Users/Exit_Codes.html)
- Handling of EOF/Keyboard Interrupt was improved.
- Console output is now colored.
- Bears can now easily convert settings to typed lists or dicts.
- Bears have no setUp/tearDown mechanism anymore.
- Colons cannot be used for key value seperation in configuration files
anymore as that clashes with the new dictionary syntax. Use
=instead. - The
--job-countargument was removed for technical reasons. It will be re-added in the near future. - A
--show-bearsparameter was added to get metainformation of bears. - The coala versioning scheme was changed to comply PEP440.
coala --versionnow gives the version number. A releaseddevversion has the build date appended, 0 for local versions installed from source.- A
coala-dbusbinary will now be installed that spawns up a dbus API for controlling coala. (Linux only.) - The StringProcessing libary is there to help bear writers deal with regexes and similar things.
- A new glob syntax was introduced and documented. (http://coala.readthedocs.org/en/latest/Users/Glob_Patterns.html)
- The
--apply-changesargument was removed as its concept does not fit anymore. - Bears can now return any iterable. This makes it possible to
yieldresults.
New bears:
- ClangCloneDetectionBear
- LanguageToolBear
- PyLintBear
Infrastructural changes:
- Tests are executed with multiple processes.
- Branch coverage raised to glorious 100%.
- We switched from Travis CI to CircleCI as Linux CI.
- AppVeyor (Windows CI) was added.
- Travis CI was added for Mac OS X.
- Development releases are automatically done from master and available
via
pip install coala --pre. - Rultor is now used exclusively to push on master. Manual pushes to master are not longer allowed to avoid human errors. Rultor deploys translation strings to Zanata and the PyPI package before pushing the fastforwarded master.
Internal code changes:
- Uncountable bugfixes.
- Uncountable refactorings touching the core of coala. Code has never been more beautiful.
We are very happy that 7 people contributed to this release, namely Abdeali Kothari, Mischa Krüger, Udayan Tandon, Fabian Neuschmidt, Ahmed Kamal and Shivani Poddar (sorted by number of commits). Many thanks go to all of those!
coala's code base has grown sanely to now over 12000 NCLOC with almost half of them being tests.
We are happy to announce that Mischa Krüger is joining the maintainers team of coala.
Furthermore we are happy to announce basic Windows and Mac OS X support. This would not have been possible without Mischa and Abdeali. coala is fully tested against Python 3.3 and 3.4 on Windows and 3.2, 3.3, 3.4 and Pypy3 on Mac while not all builtin bears are tested. coala is also tested against Pypy3 and Python 3.5 beta (in addition to 3.3 and 3.4) on Linux.
This patch release fixes a major usability issue where data entered into the editor may be lost.
For more info, see release 0.1.0.
coala 0.1 provides basic functionality. It is not feature complete but already useful according to some people.
For information about the purpose of coala please look at the README provided with each source distribution.
Note that this is a prerelease, thus this release will be supported with only important bugfixes for limited time (at least until 0.2.0 is released). Linux is the only supported platform.
Documentation for getting started with coala is provided here: https://github.com/coala-analyzer/coala/blob/v0.1.0-alpha/TUTORIAL.md
If you want to write static code analysis routines, please check out this guide: https://github.com/coala-analyzer/coala/blob/v0.1.0-alpha/doc/getting_involved/WRITING_BEARS.md
We love bugs - if you find some, be sure to share them with us: https://github.com/coala-analyzer/coala/issues