This project is in early alpha, and there are a lot of broken/missing features.
While I encourage you to try it out and give feedback, please do not use in production environments until a stable version is released.
Features may appear or disappear at any time for any reason. Assume that every alpha release will be breaking.
Rant is a high-level language for templating and procedural text generation. Write more expressive and dynamic templates, dialogue, stories, names, test data, and much more.
Rant 4 is a complete remake of the Rant language and runtime. It delivers a superior text generation experience designed around the needs of everyone-- from writers and programmers, to anybody else!
Rant is basically the opposite of Regex: Instead of matching a string to a pattern, you generate a string from a pattern!
It's easy to express your desired output as a set of branching possibilities. For example, consider a simple regex that matches on three strings:
regex
(foo|bar|baz)
The Rant equivalent to generate any matching string is quite similar:
rant
{foo|bar|baz} # Resolves randomly to "foo", "bar", or "baz"
Rant's standard library provides convenient utilities for many common use cases, cutting down on the amount of boilerplate you need to write.
Even for more complex generation tasks, Rant has your back. With its powerful set of synchronization, branching, and generation tools, you can get results with far less code than conventional programming languages.
Rant does more than generate random strings: its behavior is infinitely configurable for a wide range of use cases ranging from natural language generation to simple code templating. What you do with it is up to you!
Need to work with structured data rather than just strings? No problem. Rant offers a fully-featured object model including common primitives like numbers and booleans as well as collection types like maps and lists.
Rant comes with a CLI tool that includes a REPL. You can install and run it with:
sh
$ cargo install rant --version=4.0.0-alpha.3 --all-features
$ rant
Add Rant to your Cargo.toml:
toml
[dependencies]
rant = "*"
You can run a Rant program with just a few lines of code:
```rust use rant::Rant; use std::error::Error;
fn main() -> Result<(), Box
// Compile a simple program
let program = rant.compile_quiet(r#"
[$greet:name] {
{Hello|Hi|Hey}
// Run the program and print the output let output = rant.run(&program)?; println!("{}", output);
Ok(()) } ```
The latest documentation can be found at the official docs.rant-lang.org.
Since Rant 4 is early in development, some documentation may be outdated/incomplete, but it is actively updated to ensure that it reflects current features with reasonable accuracy.
Rant is distributed under the GNU Affero General Public License v3. See LICENSE for more details.
An alternative, commercial license is planned for the future.