coala / coast

Universal and language-independent abstract syntax tree

---

"Always code as if the guy who ends up maintaining your code will be a violent psychopath who knows where you live." ― John F. Woods

---

---

coala provides a unified interface for linting and fixing code with a single configuration file, regardless of the programming languages used. You can use coala from within your favorite editor, integrate it with your CI, get the results as JSON, or customize it to your needs with its flexible configuration syntax.

coala supports popular programming languages including Python, C/C++, Java, JavaScript, CSS, and several others out of the box.

Install coala | Get Involved | Chat | Roadmap | Blog | Twitter

coast's Issues

Add Flow language

Flow language is one we need for coala-bears.

c.f. coala/coala#5343

Swift.yaml: Add `grammar_file`

Swift.yaml presently has no grammar_file mentioned.
However, this exists. Link: https://github.com/antlr/grammars-v4/blob/master/swift3/Swift3.g4

Please add this link in grammar_file as is done in other languages, like, C, etc.

A good newcomer issue.

Add styling to the site

We need to add some design to the site generated to make it look more beautiful.

coala uses materialize css for designing the webpages. You can find some inspiration in the other repos which render html pages.

Add Travis CI to run latest coala

The repository has a .coafile, and GitMate does check it, but it is better to have Travis CI also checking it.

It needs to use the latest coala, from git

Add Complex Number data type in Python

There's no Complex number data type specified in the Python language definition, though it is a part of the language.

Missing language definitions for CSS and HTML

VisualBasic.yaml: Line length for `grammar_file` needs to be reduced

In VisualBasic.yaml:

coAST/data/Language/VisualBasic.yaml

Line 5 in 0110042

grammar_file: https://github.com/antlr/grammars-v4/blob/master/vb6/VisualBasic6.g4

The above line length (82) exceeds the maximum length, which is 79.
It'd be better if we shift this to a new line as is done in other files.

A good newcomer issue.

Add antlr language .g4

The keywords for both the versions are same and there is just a change of extensions where the newer version automatically constructs the parse tree.
So i will be sending PR on this, if its okay.

Add Jinja2 language

Netlify is failing

Netlify has been failing due to some inconsistencies in the Language file.
The problem as I read the logs are in the file

1. Pascal.yaml - Datatypes haven't been created
2. VisualBasic.yaml - A non string value present in the keywords.

The logs:

1. https://app.netlify.com/sites/coast/deploys/5bf80b4d9a063f48ba6cb4c6
2. https://app.netlify.com/sites/coast/deploys/5bfea5fa05c41723bdd7edc0

The error messages:

These messages occur after one of them fixed. I mean they occur one after another

WARNING Non-string values found in array (field: keywords, instance: Pascal, model: Language): True

ERROR	Error: Failed to build project. Run Statik in verbose mode (-v) to see additional traceback information about this error. (in file "/opt/build/repo/data/Language/Pascal.yaml"). Additional error detail: '1' is not in list

WARNING	Non-string values found in array (field: keywords, instance: VisualBasic, model: Language): True

ERROR	Error: Failed to build project. Run Statik in verbose mode (-v) to see additional traceback information about this error. (in file "/opt/build/repo/data/Language/VisualBasic.yaml"). Additional error detail: '1' is not in list

D.yaml: Fix `delimters` spelling

The file D.yaml has a spelling mistake at line 10

The delimter should be changed to delimiter

label: difficulty/newcomer

Probably should include a test case to enforce UTF-8 on text files

Yeah uhh I don't know if this exists but it should

10/10 issue styling

Netlify failing on pip install

9:08:24 PM: Finished restoring cached pip cache
9:08:24 PM: Collecting git+https://github.com/thanethomson/statik (from -r requirements.txt (line 1))
9:08:24 PM:   Cloning https://github.com/thanethomson/statik to /tmp/pip-req-build-j8yeyb_j
9:08:25 PM:     Complete output from command python setup.py egg_info:
9:08:25 PM:     error in statik setup command: 'install_requires' must be a string or list of strings containing valid project/version requirement specifiers; Invalid requirement, parse error at "'+https:/'"

Add .coafile

This needs a .coafile checking the yaml and templates.

Import languages from Linguist

Create a script, any language, which must be checked into /tools/ in this repo and be run in Travis CI, which creates data files for any languages that are in Linguist https://github.com/github/linguist/blob/master/lib/linguist/languages.yml but are missing from coAST.

This would replace coala/coala#4556 .

Try to include as much information from Linguist as possible, enhancing the local schema as needed.

Remove duplicate datatype files

There are some datatype files which are present, for example, long_java and long_d.

They should be removed, since duplicates are generally not required.

The new names of datatypes should allow it to be clearly differentiated from others and should be related to the concerned datatype.

AST vs CST

It is hard to auto-fix code if you only have an AST. Vital information has been dropped.
Also many of the generic bears rely on information typically not present in an AST.

Do you actually want a universal CST also?

Fix Documentation Error in _all.yml

The word currently has been repeated twice on line 10 of the file _all.yml

# 'block' currently currently implies a new 'scope', however we may need to

Label:- difficulty/newcomer

Unhandled exception

master currently has an unhandled exception

https://app.netlify.com/sites/coast/deploys/5bdde19202ed835358871ab4

This needs to be fixed upstream in statik

yamllint errors

A recent commit was merged with yamllint errors

Add antlr language version 3

Please assign this to me.

Remove `:` after a delimter section in Language file

A : has been added after the delimiter section in the Language file.
eg:- # string delimiter: needs to be changed to # string delimiter

Files where the changes are required:

1. https://github.com/coala/coAST/blob/master/data/Language/CPlusPlus.yaml#L20
2. https://github.com/coala/coAST/blob/master/data/Language/CSharp.yaml
3. https://github.com/coala/coAST/blob/master/data/Language/D.yaml#L10
4. https://github.com/coala/coAST/blob/master/data/Language/Rust.yaml#L18
5. https://github.com/coala/coAST/blob/master/data/Language/Verilog.yaml#L28
6. https://github.com/coala/coAST/blob/master/data/Language/Java.yaml#L14
7. https://github.com/coala/coAST/blob/master/data/Language/VisualBasic.yaml#L17
8. https://github.com/coala/coAST/blob/master/data/Language/CSharp.yaml#L18
9. https://github.com/coala/coAST/blob/master/data/Language/Golang.yaml#L14
10. https://github.com/coala/coAST/blob/master/data/Language/CPlusPlus.yaml#L20
11. https://github.com/coala/coAST/blob/master/data/Language/PHP.yaml#L16
12. https://github.com/coala/coAST/blob/master/data/Language/Pascal.yaml#L18

Label: difficulty/newcomer

Import languages from Pygments

Create a script, any language, which must be checked into /tools/ in this repo and be run in Travis CI, which creates data files for any languages that are in Pygments but are missing from coAST.

This would replace coala/coala#4556 .

Try to include as much information from Linguist as possible, enhancing the local schema as needed.

a relevant WIP is coala/coala#3162

Note the hard part of this is merging language versions to avoid essentially duplicate languages. See some of the logic from .misc/pygments_coalang_import.py in that WIP .

README.md: Change `release` to `released`

Last line here mentions:

Any code in this repository is to be release under the MIT license.

The word release should be changed to released.

A good newcomer issue.

Website listed on repo homepage leads to a shady website

You'd expect https://coast.netlify.com/ to show language details.

But it leads to a website (redirects to https://coast.netlify.app/) apparently having instructions on how to download games and software for free.

Update CI configuration to run on Python>=3.6

build fails because coala uses f strings which Python3.5 does not support.
Update CI configuration to run on Python>=3.6

Your web link is redirecting to some sketchy looking page

https://coast.netlify.com opens up some wordpress-esque blog (https://coast.netlify.app) that is peddling pirated games / mp3s etc.

You might want to look into updating the link to a more up-to-date one.

The role of keywords

keywords is covering too much things: statements, expressions(including operators), types etc.
I suggest to split them into several pieces like the delimiters.

README.md: Update grammar at line 97

Under Phase 4, it says:
For avoid these influences causing incorrect design decisions in coAST ...

For avoid doesn't look quite right and hence is to be updated.

A good newcomer issue.

Add language definition which is not in coalib languages but supported by a bear

e.g.,

• dart

Some insights on coAST

It'd be helpful if we get to know more about what problems coAST would solve? Prefereably in some detail
cc @sils1297

Pascal.yaml: Add declared `datatypes` to `data/DataType`

The datatypes mentioned under Pascal.yaml

coAST/data/Language/Pascal.yaml

Lines 74 to 79 in 0110042

	datatypes:
	- string
	- boolean
	- integer
	- real
	- char

haven't been declared under data/DataType here.

A good difficulty/low issue.

Grammar file produces a hyperlink even when no value is given to it in the Language files

Grammer file produces a hyperlink to the respective grammar files when we provide the entry to it in the language file.

Example:- C.yaml
grammar_file: https://github.com/antlr/grammars-v4/blob/master/c/C.g4

After the site is deployed, the results are rendered as: https://coast.netlify.com/c/
As you see here a hyperlink is produced for the grammar file.

But

When the grammar file field is empty or not mentioned in the language file such as Bash.yaml or Swift.yaml where the grammar file is not present.

When these files get rendered, they display the text None which hyperlinks to a page which do not exist.

Grammar File	None

This needs to be fixed. Instead of showing None with a hyperlink. It should only show None without any hyperlinks.

label: difficulty/low

Strange build failure

Strange build failure. Rebuilding without cache solved it...

8:32:21 PM: --- Logging error ---
8:32:21 PM: Traceback (most recent call last):
8:32:21 PM:   File "/usr/lib/python3.6/logging/__init__.py", line 997, in emit
8:32:21 PM:     self.flush()
8:32:21 PM:   File "/usr/lib/python3.6/logging/__init__.py", line 977, in flush
8:32:21 PM:     self.stream.flush()
8:32:21 PM: BlockingIOError: [Errno 11] write could not complete without blocking
8:32:21 PM: Call stack:
8:32:21 PM:   File "/opt/buildhome/python3.6/bin/statik", line 11, in <module>
8:32:21 PM:     sys.exit(main())
8:32:21 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/cmdline.py", line 211, in main
8:32:21 PM:     error_context=error_context
8:32:21 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/generator.py", line 15, in generate
8:32:21 PM:     return project.generate(output_path=output_path, in_memory=in_memory)
8:32:21 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/project.py", line 148, in generate
8:32:21 PM:     self.db.shutdown()
8:32:21 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/database.py", line 374, in shutdown
8:32:21 PM:     clear_tracked_globals()
8:32:21 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/database.py", line 61, in clear_tracked_globals
8:32:21 PM:     logger.debug('Clearing tracked global: %s' % name)
8:32:21 PM: Message: 'Clearing tracked global: FileExtensionLanguage'
8:32:21 PM: Arguments: ()
8:32:21 PM: 2018-10-27 13:32:12,866	statik.database	DEBUG	Clearing tracked global: Keyword
8:32:21 PM: --- Logging error ---
8:32:21 PM: Traceback (most recent call last):
8:32:21 PM:   File "/usr/lib/python3.6/logging/__init__.py", line 997, in emit
8:32:21 PM:     self.flush()
8:32:21 PM:   File "/usr/lib/python3.6/logging/__init__.py", line 977, in flush
8:32:21 PM:     self
8:32:21 PM: .stream.flush()
8:32:21 PM: BlockingIOError: [Errno 11] write could not complete without blocking
8:32:22 PM: Call stack:
8:32:22 PM:   File "/opt/buildhome/python3.6/bin/statik", line 11, in <module>
8:32:22 PM:     sys.exit(main())
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/cmdline.py", line 211, in main
8:32:22 PM:     error_context=error_context
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/generator.py", line 15, in generate
8:32:22 PM:     return project.generate(output_path=output_path, in_memory=in_memory)
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/project.py", line 148, in generate
8:32:22 PM:     self.db.shutdown()
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/database.py", line 374, in shutdown
8:32:22 PM:     clear_tracked_globals()
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/database.py", line 61, in clear_tracked_globals
8:32:22 PM:     logger.debug('Clearing tracked global: %s' % name)
8:32:22 PM: Message: 'Clearing tracked global: Keyword'
8:32:22 PM: Arguments: ()
8:32:22 PM: 2018-10-27 13:32:12,866	statik.database	DEBUG	Clearing tracked global: AliasLanguage
8:32:22 PM: --- Logging error ---
8:32:22 PM: Traceback (most recent call last):
8:32:22 PM:   File "/usr/lib/python3.6/logging/__init__.py", line 997, in emit
8:32:22 PM:     self.flush()
8:32:22 PM:   File "/usr/lib/python3.6/logging/__init__.py", line 977, in flush
8:32:22 PM:     self.stream.flush()
8:32:22 PM: BlockingIOError: [Errno 11] write could not complete without blocking
8:32:22 PM: Call stack:
8:32:22 PM:   File "/opt/buildhome/python3.6/bin/statik", line 11, in <module>
8:32:22 PM:     sys.exit(main())
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/cmdline.py", line 211, in main
8:32:22 PM:     error_context=error_context
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/generator.py", line 15, in generate
8:32:22 PM:     return project.generate(output_path=output_path, in_memory=in_memory)
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/project.py", line 148, in generate
8:32:22 PM:     self.db.shutdown()
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/database.py", line 374, in shutdown
8:32:22 PM:     clear_tracked_globals()
8:32:22 PM:   File "/opt/buildhome/python3.6/lib/python3.6/site-packages/statik/database.py", line 61, in clear_tracked_globals
8:32:22 PM:     logger.debug('Clearing tracked global: %s' % name)
8:32:22 PM: Message: 'Clearing tracked global: AliasLanguage'
8:32:22 PM: Arguments: ()
8:32:22 PM: 2018-10-27 13:32:12,867	statik.database	DEBUG	Clearing tracked global: Alias
8:32:22 PM: --- Logging error ---
8:32:22 PM: Traceback (most recent call last):
8:32:22 PM:   File "/usr/lib/python3.6/logging/__init__.py", linCaching artifacts