freestyle/README.markdown

Really terrible freestyle markov rapping

freestyle
=========

Really terrible freestyle rhyming markov rap generation

examples
========

rap.js
------

    var freestyle = require('freestyle');
    var fs = require('fs');

    var s = fs.createReadStream(__dirname + '/qwantz.txt');

    freestyle(s, function (r) {
        var A = r.couplet();
        var B = r.couplet();
        
        console.log([
            A[0], B[0], A[1], B[1], ''
        ].join('\n'));
    });

output:

    $ node examples/rap.js
    house up as a a rare rare pleasure kernes
    require extraordinary Extraordinary claims claims require require extraordinary bull
    out there is a part of it turns
    REMEMBER it turns out of the future full

methods
=======

freestyle(stream, order=1, cb)
------------------------------

Seed a markov system of `order` with `stream` and call `cb` with a freestyle
handle when it's ready.

freestyle handle
================

r.couplet(syllables)
--------------------

Generate a couplet with approximately `syllables`.
If `syllables` is falsy then lines can be any length.

installation
============

With [npm](http://npmjs.org):

    npm install freestyle