b6b01bf6d4
This is done for two reasons: 1. Such names cannot be given on the command line, since clap will intercept them and wrongly interpret them as flags. 2. The name '---' can conflict with yaml document delimiters. Kind of speculative, but I was thinking that it would be nice to make sure that '---' and '...' are illegal in a justfile, so that that one can be included in a yaml document stream. Is this silly? I am really not sure. This is backwards incompatible, but I don't think anyone will notice, since names that start with '-' are likely to be rare.
69 lines
1.6 KiB
Markdown
69 lines
1.6 KiB
Markdown
justfile grammar
|
|
================
|
|
|
|
Justfiles are processed by a mildly context-sensitive tokenizer
|
|
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.
|
|
|
|
tokens
|
|
------
|
|
|
|
```
|
|
BACKTICK = `[^`\n\r]*`
|
|
COLON = :
|
|
COMMENT = #([^!].*)?$
|
|
NEWLINE = \n|\r\n
|
|
EQUALS = =
|
|
INTERPOLATION_START = {{
|
|
INTERPOLATION_END = }}
|
|
NAME = [a-zA-Z_][a-zA-Z0-9_-]*
|
|
PLUS = +
|
|
RAW_STRING = '[^'\r\n]*'
|
|
STRING = "[^"]*" # also processes \n \r \t \" \\ escapes
|
|
INDENT = emitted when indentation increases
|
|
DEDENT = emitted when indentation decreases
|
|
LINE = emitted before a recipe line
|
|
TEXT = recipe text, only matches in a recipe body
|
|
```
|
|
|
|
grammar
|
|
-------
|
|
|
|
```
|
|
justfile : item* EOF
|
|
|
|
item : recipe
|
|
| assignment
|
|
| export
|
|
| eol
|
|
|
|
eol : NEWLINE
|
|
| COMMENT NEWLINE
|
|
|
|
assignment : NAME '=' expression eol
|
|
|
|
export : 'export' assignment
|
|
|
|
expression : STRING
|
|
| RAW_STRING
|
|
| NAME
|
|
| BACKTICK
|
|
| expression '+' expression
|
|
|
|
recipe : '@'? NAME parameter* ('+' parameter)? ':' dependencies? body?
|
|
|
|
parameter : NAME
|
|
| NAME '=' STRING
|
|
| NAME '=' RAW_STRING
|
|
|
|
dependencies : NAME+
|
|
|
|
body : INDENT line+ DEDENT
|
|
|
|
line : LINE (TEXT | interpolation)+ NEWLINE
|
|
| NEWLINE
|
|
|
|
interpolation : '{{' expression '}}'
|
|
```
|