Skip to content

Benjins/Rant

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rant logo

##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

About

Procedural text generation language

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%