1 unstable release
0.0.1 | Mar 12, 2024 |
---|
280KB
12K
SLoC
tree-sitter-just
WIP: Tree-sitter grammar for Justfiles (casey/just)
To use treesitter based highlighting, folds etc. the queries need to be added to the runtimepath, until I get a PR into nvim-treesitter/nvim-treesitter
you can install this repo as a plugin using Plug/packer/manual clone etc. This plugin also adds a simple ftdetect
plugin for detecting justfiles.
Packer:
use "IndianBoy42/tree-sitter-just"
Plug
Plug 'IndianBoy42/tree-sitter-just'
Manual
git clone https://github.com/IndianBoy42/tree-sitter-just ~/.local/share/nvim/site/pack/tree-sitter-queries/start/tree-sitter-just
You can then do require('tree-sitter-just').setup({})
to register the parser with tree-sitter. You can then do TSInstall
/TSUpdate
as usual to install the parser
You can also add the parser manually using (This is similar to what is done in require"tree-sitter-just".setup({})
)
require("nvim-treesitter.parsers").get_parser_configs().just = {
install_info = {
url = "https://github.com/IndianBoy42/tree-sitter-just", -- local path or git repo
files = { "src/parser.c", "src/scanner.c" },
branch = "main",
-- use_makefile = true -- this may be necessary on MacOS (try if you see compiler errors)
},
maintainers = { "@IndianBoy42" },
}
Don't forget to :TSInstall
after adding this. With this method you do not have to add this repo as a plugin.
If you run into problems relating to C++ 11 features, try including this in your setup (you may have to brew install gcc@11
):
require"nvim-treesitter.install".compilers = {"gcc-11"}
Contributing
The easiest way to get started is, fittingly, with
just
.
# Make sure dependencies are available
just setup
# Create autogenerated files and run tests
just test
# Create autogenerated files without testing
just gen
# Check linting rules
just lint
# Apply formatting
just fmt
Note that just lint
and just fmt
must pass for all changes. You can verify
these automatically before committing by running just pre-commit-install
.
All our queries are in queries-src
. This directory is what gets tested by
tree-sitter, and should be usable by helix. To generate queries for NeoVim,
run ./build-flavored-queries.py
(this is run as part of npm run gen
).
You can use the :InspectTree
command to explore the resulting parse tree, and :Inspect
to view highlight groups.
Quirks of Just
Just currently doesn't seem to support comments between attributes or within if statements, so we do not either.
[private]
# hello!
[no-cd]
foo:
foo := if true {
# nope!
"abcd"
}
Test Information
The tests directory contains "corpus" tests that are checked for syntax, as well as "highlight" tests that check the result. The "highlight" test directory includes some test files generated by the fuzzer that aren't always human readable.
TODO
- Implement a basic parser that is able to understand all features of Justfiles
- Implement support for highlighting using
nvim-treesitter
(reference,highlights.scm
)- Write the queries
- Implement locals queries
- Implement queries for textobjects compatible with
nvim-treesitter/nvim-treesitter-textobjects
- Write the queries
- @block.inner|outer (recipe)
- @function.inner|outer (recipe)
- @call.inner|outer (dependencies)
- @comment.outer
- @parameter.inner|outer
- @conditional.inner|outer
- @statement.outer (recipe line or one variable)
- Definitions and references
- Scopenames
- Write the queries
- Implement support for indentation using
nvim-treesitter
- Write the queries
- Implement support for code folding using
nvim-treesitter
(folds.scm
)- Write the queries
- Write Tests
- Highlight the fish/bash/etc inside recipes (use tree-sitter injections)
- Fix weirdness around trailing whitespace (don't leave trailing whitespace after the recipe header)
Dependencies
~2.8–4MB
~76K SLoC