Awesome

NOTICE: Repository Archived

As of 26.6.2020, Rant 3 is no longer supported and the repository is archived.

Check out Rant 4, a complete redesign and reimplementation of the Rant language!

Original readme:

Rant is an all-purpose procedural text engine that is most simply described as the opposite of Regex. It has been refined to include a dizzying array of features for handling everything from the most basic of string generation tasks to advanced dialogue generation, code templating, automatic formatting, and more.

The goal of the project is to enable developers of all kinds to automate repetitive writing tasks with a high degree of creative freedom.

<a href="https://ci.appveyor.com/project/TheBerkin/rant/branch/master/artifacts"> <img src="https://ci.appveyor.com/api/projects/status/2vn0imlns20n739a/branch/master?svg=true&passingText=Master%20Build%20Passing&pendingText=Master%20Build%20Pending&failingText=Master%20Build%20Failing" alt="Build status" /> </a> <a href="https://ci.appveyor.com/project/TheBerkin/rant/branch/dev/artifacts"> <img src="https://ci.appveyor.com/api/projects/status/2vn0imlns20n739a/branch/dev?svg=true&passingText=Dev%20Build%20Passing&pendingText=Dev%20Build%20Pending&failingText=Dev%20Build%20Is%20Kill" alt="Build status" /> </a> <img src="https://img.shields.io/nuget/dt/Rant.svg" title="NuGet Downloads"/> Join us on the official <a href="https://discord.gg/5n7bnAD">Discord server</a>!

Features

Recursive, weighted branching with several selection modes
Queryable dictionaries
Automatic capitalization, rhyming, English indefinite articles, and multi-lingual number verbalization
Print to multiple separate outputs
Probability modifiers for pattern elements
Loops, conditional statements, and subroutines
Fully-functional object model
Import/Export resources easily with the .rantpkg format
Compatible with Unity 2017
And much, much, much more...

Examples

Liven up a narrative with a few simple queries.

<name-male> likes to <verb-transitive> <noun.pl> with <pro.dposs-male> pet <noun-animal> on <noun.pl  -dayofweek>.

Alick likes to mount shuttlecocks with his pet bat on Mondays.

Count to ten and spell it out.

[case:sentence][numfmt:verbal][rs:10;\s]{[rn].}

One. Two. Three. Four. Five. Six. Seven. Eight. Nine. Ten.

Write a poem

[rhyme:perfect]
The <noun(1)::&a> <verb.ed(1)-transitive::&a> the <adj::&a> <noun(1)::&a>.

The bread fed the red head.

The drug dug the smug plug.

NuGet

Rant is also available as a NuGet package. Enter this command in your package manager, and the latest version of Rant will automagically get installed in your project:

PM> Install-Package Rant

Or if development builds are your thing:

PM> Install-Package Rant -Pre

License

Rant is provided under The MIT License.

Improve Rant

If there is something you want fixed, added, or changed, feel free to submit an issue/pull request; I will try to get back to you within a day. If you would like to translate Rant into your native language, simply write a .lang file for it like this one here.

See CONTRIBUTING.md for a full guide on how you can help.