1
0

Update examples and README

This commit is contained in:
Jeff 2023-10-06 21:59:01 -04:00
parent 90352dd264
commit 12418a3bba
3 changed files with 39 additions and 44 deletions

View File

@ -11,20 +11,9 @@ A basic dust program:
Dust can do two (or more) things at the same time with effortless concurrency: Dust can do two (or more) things at the same time with effortless concurrency:
```dust ```dust
run { (run
function { output 'will this one finish first?' } (output 'will this one finish first?')
function { output 'or will this one?' } (output 'or will this one?'))
}
```
Dust can do amazing things with data. To load CSV data, isolate a column and render it as a line plot in a GUI window:
```dust
read_file { "examples/assets/faithful.csv" }
-> from_csv
-> rows
-> transform <{item.1}>
-> plot
``` ```
<!--toc:start--> <!--toc:start-->
@ -66,8 +55,6 @@ help {"random"} # Returns a table with info on tools in the specified group.
## Installation ## Installation
**WARNING**: Because Dust is changing so rapidly, there may be differences between the version you download using `cargo install` and the version to which this README refers. Even if you compile the code locally, some aspects of the documentation may not work because features are generally documented and tested before being implemented. You can run `cargo test` to identify things that don't work yet.
You must have the default rust toolchain installed and up-to-date. Install [rustup] if it is not already installed. Run `cargo install dust-lang` then run `dust` to start the interactive shell. Use `dust --help` to see the full command line options. You must have the default rust toolchain installed and up-to-date. Install [rustup] if it is not already installed. Run `cargo install dust-lang` then run `dust` to start the interactive shell. Use `dust --help` to see the full command line options.
To build from source, clone the repository and build the parser. To do so, enter the `tree-sitter-dust` directory and run `tree-sitter-generate`. In the project root, run `cargo run` to start the shell. To see other command line options, use `cargo run -- --help`. To build from source, clone the repository and build the parser. To do so, enter the `tree-sitter-dust` directory and run `tree-sitter-generate`. In the project root, run `cargo run` to start the shell. To see other command line options, use `cargo run -- --help`.
@ -192,13 +179,13 @@ print = function <input> {
### Empty Values ### Empty Values
Dust does not have a null type. Instead, it uses the "empty" type to represent a lack of any other value. There is no syntax to create this value: it is only used by the interpreter. Note that Dust *does* have the NaN value, which is a floating point value that must exist in order for floats to work as intended. Integers will never be NaN and no value will ever be null or undefined. Dust does not have a null type. Instead, it uses the "empty" type to represent a lack of any other value. There is no syntax to create this value: it is only used by the interpreter. Note that Dust *does* have the NaN value, which is a floating point value that must exist in order for floats to work as intended. No value will ever be null or undefined.
## Implementation ## Implementation
Dust is formally defined as a Tree Sitter grammar in the tree-sitter-dust module. Tree sitter generates a parser, written in C, from a set of rules defined in Javascript. Dust itself is a rust binary that calls the C parser using FFI. Javascript is used *only* to define the grammar, all of the compiled code is in Rust or C. Dust is formally defined as a Tree Sitter grammar in the tree-sitter-dust module. Tree sitter generates a parser, written in C, from a set of rules defined in Javascript. Dust itself is a rust binary that calls the C parser using FFI.
Tree Sitter generates a concrete syntax tree, which the Rust code maps to an abstract syntax tree by traversing each node once. Tree sitter is fast enough to be updated on every keystroke which is perfect for a data-oriented language like Dust because it allows only the relevant sections to be re-evaluated and the result displayed instantly. Most languages skip the concrete syntax and parse directly to an abstract syntax tree, but there are reasons for using a concrete syntax tree. Some of the project's long-term goals are to support interactivity and allowing comments to be aware of the interpreted code. In the medium-term it is helpful to produce error messages for invalid syntax because the evaluator knows exactly where it and everything else is in the document. Tree Sitter generates a concrete syntax tree, which dust travseres to create an abstract syntax tree that can be executed run the dust code. Each
## Contributing ## Contributing

View File

@ -1,15 +1,26 @@
suspects = ("White", "Green"); suspects = ["White", "Green"];
rooms = ("Library", "Kitchen"); rooms = ["Library", "Kitchen"];
weapons = ("Rope", "Lead Pipe"); weapons = ["Rope", "Lead Pipe"];
make_guess = { make_guess = function <current_room> {
current_room = input.0; if (length suspects) == 1
&& (length rooms) == 1
if length(suspects) == 1 && (length weapons) == 1
&& length(rooms) == 1
&& length(weapons) == 1
then then
output 'It was ' + suspects.0 + ' in the ' + rooms.0 + ' with the ' + weapons.0 '!'; (output 'It was '
+ suspects.0
+ ' in the '
+ rooms.0
+ ' with the '
+ weapons.0
+ '!'
);
else else
output 'I accuse ' + random(suspects) + ' in the ' + current_room + ' with the ' + random(weapons) '!'; (output 'I accuse '
}; + (random suspects)
+ ' in the '
+ current_room
+ ' with the '
+ (random weapons)
+ '!')
}

View File

@ -2,19 +2,16 @@ fizzbuzz_basic = function <limit> {
count = 1 count = 1
while count < limit { while count < limit {
count += 1
if count % 3 == 0 && count % 5 == 0 { if count % 3 == 0 && count % 5 == 0 {
output 'fizzbuzz' (output 'fizzbuzz')
} else { } else f count % 3 == 0 {
if count % 3 == 0 { (output 'fizz')
output 'fizz' } else if count % 5 == 0 {
} (output 'buzz')
} else
(output count)
if count % 5 == 0 { count += 1
output 'buzz'
}
}
} }
} }