just/GRAMMAR.md

82 lines
1.7 KiB
Markdown
Raw Normal View History

2016-10-30 19:15:35 -07:00
justfile grammar
2016-10-30 19:16:33 -07:00
================
2016-10-30 19:15:35 -07:00
2016-10-30 19:40:11 -07:00
Justfiles are processed by a mildly context-sensitive tokenizer
2016-10-30 19:17:09 -07:00
and a recursive descent parser. The grammar is mostly LL(1),
although an extra token of lookahead is used to distinguish between
export assignments and recipes with parameters.
2016-10-30 19:15:35 -07:00
tokens
2016-10-30 19:16:33 -07:00
------
2016-10-30 19:15:35 -07:00
```
2017-11-30 08:44:06 -08:00
BACKTICK = `[^`\n\r]*`
COMMENT = #([^!].*)?$
DEDENT = emitted when indentation decreases
EOF = emitted at the end of the file
INDENT = emitted when indentation increases
LINE = emitted before a recipe line
NAME = [a-zA-Z_][a-zA-Z0-9_-]*
NEWLINE = \n|\r\n
RAW_STRING = '[^'\r\n]*'
STRING = "[^"]*" # also processes \n \r \t \" \\ escapes
TEXT = recipe text, only matches in a recipe body
```
grammar syntax
--------------
```
| alternation
() grouping
_? option (0 or 1 times)
_* repetition (0 or more times)
_+ repetition (1 or more times)
2016-10-30 19:15:35 -07:00
```
grammar
2016-10-30 19:16:33 -07:00
-------
2016-10-30 19:15:35 -07:00
```
justfile : item* EOF
item : recipe
| assignment
| export
| eol
2016-10-30 19:15:35 -07:00
eol : NEWLINE
| COMMENT NEWLINE
assignment : NAME '=' expression eol
2016-10-30 19:15:35 -07:00
export : 'export' assignment
2017-11-30 08:44:06 -08:00
expression : value '+' expression
| value
value : NAME '(' arguments? ')'
| STRING
2016-10-30 19:15:35 -07:00
| RAW_STRING
| BACKTICK
| NAME
arguments : expression ',' arguments
| expression ','?
2016-10-30 19:15:35 -07:00
recipe : '@'? NAME parameter* ('+' parameter)? ':' dependencies? body?
2016-10-30 19:15:35 -07:00
parameter : NAME
| NAME '=' STRING
| NAME '=' RAW_STRING
2016-10-30 19:15:35 -07:00
dependencies : NAME+
body : INDENT line+ DEDENT
line : LINE (TEXT | interpolation)+ NEWLINE
| NEWLINE
2016-10-30 19:15:35 -07:00
interpolation : '{{' expression '}}'
```