Rant is a high-level language for procedural templating, providing a diverse and powerful toolset for easily creating dynamic code templates, game dialogue, stories, name generators, test data, and much more.
This project is in alpha. Expect to see 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 4 is a complete redesign and reimplementation from the ground up, written in Rust. It's designed around the needs of everyone-- programmers, writers, and everyone in-between!
Rant is basically the opposite of Regex: just as a regular expression compares inputs to a pattern, Rant generates matching outputs from a pattern!
Consider this regex:
```regex
(Hey|Hi|Hello) world! ```
The Rant equivalent is nearly identical:
```rant {Hey|Hi|Hello} world!
```
๐งฐ Painless API
Rant's API is designed to be as straightforward as possible. Integrating Rant into your project only takes a few lines of code!
๐ป Cross-Platform
Write once, run anywhere-- Rant code is fully portable across all supported platforms.
๐ Rant Standard Library
Rant's comprehensive standard library lets you get more done and iterate rapidly with far less boilerplate than other languages.
๐ฑ Advanced Branching
Fine-tune branching behavior with a multitude of configuration options and branch selection modes, including several iterative and randomized selection modes.
๐จ Dynamic Variable System
Inspired by other popular languages, Rant's built-in primitive and collection types let you represent whatever data you need.
๐จ Print Semantics
Every scope has an "output" you can "print" to. Easily build strings and collections without the need for temporary variables.
๐งฌ Delightful Combinatorics
Easily perform nested mappings, filters, zips, combinations, and more with Rant's powerful function composition and iteration engine.
๐ Automatic Formatting
Passively format text output with automatic capitalization, whitespace normalization, and number formatting.
๐งฉ Modules
Create libraries of Rant functions to easily share between your programs.
๐งถ Entanglement
Synchronize RNG behavior in different parts of your program with a single function call.
Rant's CLI can run Rant code from files or the command line. Install it from Cargo with:
sh
$ cargo install rant --version 4.0.0-alpha.17 --features cli
Then run it:
sh
$ 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 reference documentation can be found at 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.
The changelog is updated constantly throughout the development process, providing a complete summary of upcoming changes at a glance even before the next release.
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.
