`++- -o+`
-oo: :yhho ohhy: :oo.
:hhhoohhh+ +hhhoohhy:
``.--shhhhhy: /yhhhhho--..`
+hhhhhhhhhhh+ ohhhhhhhhhhh/
`/+/////+hhhh/ +hhhy+///////`
-yhhhs hshhhy-
.os/ hhhhy- -yhhhh +ss.
.yhho shhho``ohhhs `ohhy`
-yhhs` +hhhsshhh+ `shhy-
.::shhhs++/+yhy////shhhhhhs////yhy++++yhhho::-
/hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh/
-::shhhs++++yhy////shhhhhhs +shhhs::.
-yhhs` +hhhsshhh+ `shhy-
.yhho` shhho``ohhhs ohhy.
.ss+ hhhhy -yhhhh /so.
-yhhhs shhhy-
`///////+yhhh+ /hhhh+/////+/`
/hhhhhhhhhhho +hhhhhhhhhhh+
`..--ohhhhhy/ :yhhhhhs--.``
:hhhoohhh+ +hhhoohhh:
-oo: :yhho ohhy: :oo-
`+o- -++`
For this release we had 168 commits contributed by 66 unique contributors over 2.5 months.
The name of this release is PolarBear to reflect changes we have made to our release process. We have implemented a release freeze before all releases to serve as a testing period for all staged changes. This should also help us keep releases on schedule.
This release is an enhancement release which brings the usual slew of improvements to documentation and API. We have started preparing the codebase for the big changes that are outlined in the cEPs like section inheritance and the next generation core.
Known Bugs
- Results are cached even if a bear does not run. This can lead to empty
results where there should be errors. To temporarily deal with this
run coala with the
--flush-cacheoption
General
- Test cases have been improved across the board so they catch more errors before production.
- Log output via json has been added which is accessible by using the
--log-jsonoption. - coala domain has been changed from
coala-analyzer.orgtocoala.io. Please file a bug if you find any broken links or instances of the old url.
Usability
- emacs has been added to list of editors that coala supports.
- coala will now output a warning if you specify an editor that is not known.
- The
noqakeyword used by other linters as an ignore keyword is now supported as a coala ignore keyword. libclang-py3update to 3.4 is known to cause problems for some users. Please uninstall and reinstall it if coala tells you there is a version mismatch inlibclang-py3.C#now has proper language support and should work with AnnotationBear and all other bears which require language configuration.
Deprecations
change_linemethod inDiff.pyhas been deprecated and has been scheduled for removal.format_strsetting has been completely removed after being deprecated last release. Useformatinstead to specify a formatting string.
Developers
- Travis has been enabled for developers to test their changes on their own CI.
- Bears will now check for prerequisites using specified requirements
before running. Either override
check_prequisitesin the bear or write a new requirement class if you wish to have a custom check. - When a language is not known by coala, an
Unknownlanguage will be used. @linterdecorator now warns when using unsupported or anonymous capture groups.- New
dependency_managementpackage has been created to contain package manager and dependency classes used by coala. All of the old*Requirementclasses have been moved here. Some new dependencies classes areCabalRequirementandMavenRequirement. Developers should add requirement classes there now for the requirement types they wish to support. DistributionRequirementcan now check if a package is installed in many popular linux distros.- Diffs are able to add a single line using the
add_linemethod now. Languageclass ignores leading and trailing spaces in language lookups.Languageclass should auto-complete when using languages that have been defined.
Docs
- A Code of Conduct has been added. This will guide conflict resolution if the need ever arises.
- API docs are now part of the coala repository.
- Developer contribution documentation has received a major update
Bugfixes
- Fixed an issue where using linter bears on windows had thrown an exception. Issue 3323
- coala
-c(config file) option properly supports specifying directories. Previously it has thrown an exception. Issue 3221 - Documentation status github badge has been fixed.
- Console interaction uses a unicode dot to represent spaces instead of the bullet for better cross platform rendering. Issue 2751
Languageclass raises proper exception to fixhasattrbehavior. Issue 3160- Ignore statements in multi-line comments should be supported properly now. Issue 3441
This bugfix release addressed the following issues:
- The installer has been fixed to only install on supported python versions. Issue #3310 Issue #3383
- The format_str option to specify a format string has been restored to
coala run in format mode. This is deprecated and was only restored to
provide plug-in developers a grace period to switch to the replacement
setting
format. Issue #3303 - Setuptools was removed from our requirements list because having it only only caused dependency problems for other packages installed on the system coala Bears Issue #751
- PyPrint dependency was updated to a version which does not pull in setuptools anymore.
- API change: An auto-apply disable option was added to run_coala to fix issue detection by unattended services that use coala when the coafile contains a default_action Issue #3212
- A few specific language class behaviors were changed. This should only affect developers Pull #3175 Pull #3167
__
o#'9MMHb':'-,o,
.oH":HH$' "' ' -*R&o,
dMMM*""'`' .oM"HM?.
,MMM' "HLbd< ?&H\
.:MH ."\ ` MM MM&b
. "*H - &MMMMMMMMMH:
. dboo MMMMMMMMMMMM.
. dMMMMMMb *MMMMMMMMMP.
. MMMMMMMP *MMMMMP .
`#MMMMM MM6P ,
' `MMMP" HM*`,
' :MM .- ,
'. `#?.. . ..'
-. . .-
''-.oo,oo.-''
For this release only we had 58 different contributors from all around the globe contributing way over 200 commits over 2.5 months to coala.
The name of this release is GlobalBear to honour our GlobalBear class and leave a statement on how global the community grows: gone are the days when we visit conferences and we have to explain the project to all the people. More and more people know the project before we meet them and this is great! This is a huge step in our conquest to take over the world!
The GlobalBear class serves our users by providing project wide "global" analysis. This release it will probably make its last appearance because it will be deprecated in favour of a more sophisticated concept in the near future.
We have also worked a lot towards building our dream of letting users declare code analysis configuration completely language independently: to take a sneak peek at what we want to do, check this out. You will see that the first aspects are already in our source code and that bears can already associate results with them so future versions of coala will be able to tell the user a plethora of facts around the type of issue pointed out.
For users, we have added a lot of usability improvements as well as for example the ability to merge patches within one line: if you previously had to run coala multiple times because of patch conflicts, this is likely not the case anymore!
As a Bear writer you now have access to our Language facilities: they
will give you facts about programming languages that you analyse so you can
build truly language independent bears. Also, you now can use
http://api.coala.io/ to get more information about our classes and functions
you work with.
Command Line Interface Changes:
coala-ciandcoala-jsonhave been deprecated. You can now usecoala --non-interactiveandcoala --jsonrespectively.- Multiple patches within one line, even from different bears, can be automatically merged by coala.
coalareturns the exitcode 2 when not passing any--bearsor--filesas well as when no section is enabled and nothing was done.- coala can now automatically add
Ignore ...Bearcomments to your source code. Simply use theAdd ignore commentaction when offered. - Users can press enter to dismiss a result by default.
- Result action descriptions have been compressed to make them easier readable.
- The section name is now displayed when asking the user for missing settings.
coala --non-interactiveshows results and patches by default now.coala-dbushas been removed as it wasn't used by anyone.- A
--no-colorargument allows to run coala with uncoloured results. - Log messages are printed on stderr now.
coala --jsondoesn't output log messages in JSON anymore. This is a technical issue. Log messages can easily be fetched from the stderr stream.- Some performance improvements could be achieved.
- A lot more strings, like
rogerorno wayare allowed for boolean values. (https://github.com/coala/coala/commit/728b7b02da8ca8f91b91c67784872244c0820a77)
Bear API Changes:
LanguageDefinitionhas been deprecated. Usecoalib.bearlib.languages.Languageinstead. Consult http://api.coala.io/en/latest/coalib.bearlib.languages.html#module-coalib.bearlib.languages.Language for usage hints.- The deprecated
Lintclass has now been removed. - The
CondaRequirementhas been removed. - The
multipleconstructor forPackageRequirementclasses has been removed. - A
deprecate_beardecorator is now available so bears can be renamed seamlessly. - The
Diffobject has now dedicated functions toreplace,insertandremoveSourceRangeobjects.
Bug Fixes:
- A glob corner case has been fixed. (coala#2664)
- An issue where empty patches have been shown to the user has been fixed. (coala#2832)
- Wrong handling of periods when changing casing has been fixed. (coala#2696)
- A caching bug where results have not been shown to the user has been fixed. (coala#2987)
Documentation:
- API documentation is now available at http://api.coala.io/
Internal Changes:
- Deprecated parameters are stored in the function metadata.
- Python builtin logging is now used.
- Numerous changes to get started on https://coala.io/cep5 have been
implemented. The first aspects are already defined in
coalib.bearlib.aspectsand bears can already append aspects to results. coalangfiles now have an alias dictionary.
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
pip3 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 availability. (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#1712)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://docs.coala.io/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#846)coala-ciyields a beautiful output now, showing the issues non-interactively. (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 modifiable.
- 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://api.coala.io
- 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.
- Manually 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://docs.coala.io/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 separation 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 meta information 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 library is there to help bear writers deal with regexes and similar things.
- A new glob syntax was introduced and documented. (http://docs.coala.io/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
pip3 install coala --pre. - Rultor is now used exclusively to push on master. Manual pushes to master are no longer allowed to avoid human errors. Rultor deploys translation strings to Zanata and the PyPI package before pushing the fast-forwarded 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_NATIVE_BEARS.md
We love bugs - if you find some, be sure to share them with us: https://github.com/coala-analyzer/coala/issues