##What is Rant?
Rant is a language for adding rich variations to text. It combines a markup language with functional and imperative programming concepts to deliver a concise but powerful tool for procedurally generating text. The goal of Rant is to augment human creativity with the boundless potential of randomness, enabling content producers to consider their next idea as not just a concept, but a seed for countless possibilities.
###Features Some of the highlights of what Rant offers:
- Recursive, branching choices with various selection strategies (random, ordered, locked...)
- Access to external dictionaries using queries
- Word rhyming using pronunciation metadata
- Synchronize sections of random output
- Automatic capitalization
- Indefinite article (a/an) automation
- Multiple outputs (channels)
- Probability modifiers
- Overwriting (targets)
- Looping (repeaters)
- Conditionals
- List objects
- Subroutines
- Arithmetic
- And much, much more...
##Examples
Generate random sentence
<name-male> likes to <verb-transitive> <noun.plural> with <pron.poss-male> pet <noun-animal> on <timenoun.plural-dayofweek>.
Alick likes to mount shuttlecocks with his pet bat on Mondays.
Generate ten random numbers between 1 and 50 and spell them out using US spelling conventions
[numfmt:verbal-en][rep:10][sep:,\s]{[num:1;50]}
thirteen, twenty two, thirteen, nineteen, thirty one, thirty four, forty two, twenty six, twelve, forty four
Generate 32 random hexadecimal digits grouped into sets of eight
[rep:4][sep:\s]{\8,x}
Alternatively...
[rep:32]{\x[notlast:[nth:8;0;\s]]}
6fb34d31 42e27a48 5884bce5 bf743ec8
Insert text into existing output
The following word is [get:N] characters long: \"[mark:a]<noun-animal|fruit>[mark:b]\"
[send:N;[dist:a;b]]
The following word is 7 characters long: "kumquat"
##NuGet Rant is also available as a NuGet package. Punch the following into your package manager console and smash the Enter key enthusiastically to get it:
PM> Install-Package Rant
##Contributing If there is something you want fixed, added, or changed, feel free to submit an issue/pull request. You are welcome to help with any of the following:
- Documentation (wiki/code)
- Fixing bugs
- Optimization
- New functions
- New language features
- Improving old language features
- New API features
- Formatting support for other languages
##License Rant is provided under The MIT License.
##Documentation See the wiki for full documentation of the API and Rant language, as well as additional example code.
##Try Rant RantBox - Online Rant Interpreter