https://github.com/robbestad/Rantjs

Procedurally generate text with JavaScript
https://github.com/robbestad/Rantjs

Last synced: 3 days ago
JSON representation

Procedurally generate text with JavaScript

• Host: GitHub
• URL: https://github.com/robbestad/Rantjs
• Owner: robbestad
• Created: 2014-12-12T05:22:54.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2016-10-17T06:34:06.000Z (about 8 years ago)
• Last Synced: 2024-11-08T14:59:59.703Z (5 days ago)
• Language: JavaScript
• Homepage:
• Size: 3.48 MB
• Stars: 220
• Watchers: 10
• Forks: 10
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Rantjs

Rantjs is a procedural text generator. The goal is to augment human creativity with the boundless potential of randomness. Inspired by [Rant][1].



The project is available via npm (do _npm install rantjs_). 

## Demo and more information

Interactive demo available [here][5]

Click [here][4] for a writeup on my blog

## Usage

    var rant = require("rantjs");

    var sentence=rant(' likes to   with  pet  on .');

    console.log(sentence); // 'Sean likes to chop parrots with his pet cat on Saturdays.'

For implementation details, please visit the [npmjs page][3]

## Install

```bash

git clone https://github.com/svenanders/rantjs && cd rantjs

npm i

gulp serve

```

Then open http://localhost:8000

## Development Plan

Easy way to choose alternative dictionaries

Indefinite article (a/an) automation

Overwriting (targets)

~~Capitalisation~~

~~Looping (repeaters)~~

Conditionals

## Contributions

Contributions are welcome. Feel free to submit an issue/pull request. The following areas are

of particular interest:

Documentation (wiki/code)

Fixing bugs

Optimization

Functions in the development plan

New language features

Testing. Currently, this is the result of the coverage report:

    Statements   : 96.44% ( 461/478 )

    Branches     : 67.65% ( 46/68 )

    Functions    : 100% ( 18/18 )

    Lines        : 97.24% ( 458/471 )

Ideally, it should be 100% on everything

## New in version 1.0.0

  Added option for custom dictionaries. Note that this replaces the built-in dictionary.

  

    var yourCustomDic = {}

    ...

    rant('your text', yourCustomDic);

     

A sample dictionary file can be found in the ./src folder. Also take a look at the built-in english dicionary in the same folder for reference.

## New in version 0.9.x

  0.9.7 - Added nonsense verbs from Rantionary

  

  0.9.5 - Added verbs for success and defeat

  

  0.9.4 - Added Death ()

  

  0.9.3 - Added climb ()

## New in version 0.9.1

  Rewrote Rantjs for CommonJS. 

  

  Removed several gulp tasks (concat, minify)

 

  Refactored the tests

 

  Renamed the app internally

 

  New usage syntax (not compatible with 0.8.x)

 

  You can now call Rantjs directly from require:

  

    var sentence=require("rantjs")(" likes to  

     with  pet  on .");

 

  Added randomization:

  

    require("rantjs")("A random string: [rep:8][sep:\N]{\C}");

    //A random string: XUACJGOGN

## New in version 0.8.6

  Added support for [rep:x]

  Usage:

    [case:title][sep:\n][rep:3]{I like  but not }

    // I Like Ogres but not Turtles

    // I Like Bulls but not Horses

    // I Like Poodles but not Owls

   Note: [sep:\n] dictates newlines. Alternatively, you can specify \s for space.

## New in version 0.8.5

  Added support for [case]-tag.

  Usage:

    [case:upper]

  Variants:

    [case:none|default|word|upper|lower|case|sentence]

[1]: https://github.com/TheBerkin/Rant

[3]: https://www.npmjs.com/package/rantjs

[4]: http://www.robbestad.com/blog/procedurally-generated-text-with-rantjs

[5]: http://rantjs.surge.sh/