require('pretty-error').start(function(){
    startTheApp();
});

PrettyError = require('pretty-error');

// instantiate PrettyError, which can then be used to
// render error objects
pe = new PrettyError();

// catch uncaught exceptions in node.js
process.on('uncaughtException', function(error){

    // this would render the caught error into a string...
    var rendered = pe.render(error);

    // ... which we can then use to log to the console
    console.error(rendered);

    // we should then exit the program, as advised in node's documentation:
    // http://nodejs.org/docs/v0.10.0/api/process.html#process_event_uncaughtexception
    process.exit(1);
});

// 'uncaughtException' will start listening on the next tick,
// so we must postpone everything that might generate errors
// to the next tick:
process.nextTick(function(){
    startTheApp();
});

// and of course, you can use it to render handled exceptions too:
try {

    aNonExistingFunction(); // this will throw an error

} catch (error) {

    // and we can render it out, just like unhandled errors
    console.log(pe.render(error));

}

// the start() shortcuts returns an instance of PrettyError ...
pe = require('pretty-error').start();

// ... which we can then use to customize with css declarations:
pe.adppendStyle({

    // this is a simple selector to the element that says 'Error'
    'pretty-error > header > title > kind':

        // which we can hide:
        display: 'none'

    },

    // the 'colon' after 'Error':
    'pretty-error > header > colon': {

        // we hide that too
        display: 'none'

    },

    // our error message
    'pretty-error > header > message': {

        // let's change its color
        color: 'bright-white',

        // I could use black, red, green, yellow, blue, magenta, cyan, white,
        // grey, bright-red, bright-green, bright-yellow, bright-blue,
        // bright-magenta, bright-cyan, and bright-white

        // we can also change the background color:
        background: 'cyan',

        // it understands paddings too!
        padding: '0 1' // top/bottom left/right

    },

    // each trace item ...
    'pretty-error > trace > item': {

        // ... can have a margin ...
        marginLeft: 2,

        // ... and a bullet character!
        bullet: '"<grey>o</grey>"'

        // Notes on bullets:
        //
        // The string inside the quotation mark will be used for bullets.
        //
        // You can set its color/background color using tags.
        //
        // This example set the background color to white, and the text color
        // to cyan, the character will be a hyphen with a space character
        // on each side:
        // example: '<bg-white><cyan> - </cyan></bg-white>'
        // (Note that we should use a margin of 3, since the bullet will be
        // 3characters long.)

    },

    'pretty-error > trace > item > header > pointer > file': {

        color: 'bright-cyan'

    },

    'pretty-error > trace > item > header > pointer > colon': {

        color: 'cyan'

    },

    'pretty-error > trace > item > header > pointer > line': {

        color: 'bright-cyan'

    },

    'pretty-error > trace > item > header > what': {

        color: 'bright-white'

    },

    'pretty-error > trace > item > footer > addr': {

        display: 'none'

});

PrettyError = require('pretty-error');
pe = new PrettyError();

// or:
pe = require('pretty-error').start();

pe.alias('E:/open-source/theatrejs/scripts/js', '(Theare.js)');

// to remove the alias:
pe.removeAlias('E:/open-source/theatrejs/scripts/js');

// or:
pe.removeAllAliases();

pe.skipPackage('chai', 'when', 'socket.io');

// to unskip:
pe.unskipPackage('socket.io');

// this will skip node.js, path.js, event.js, etc.
pe.skipNodeFiles();

// also:
pe.unskipNodeFiles();
pe.unskipAllPackages();

pe.skipPath('/home/dir/someFile.js');

// also:
pe.unskipPath('/home/dir/someFile.js');
pe.unskipAllPaths();

pe.skip(function(traceLine, lineNumber){

    // if we know which package this trace line comes from, and it isn't
    // our 'demo' package ...
    if (typeof traceLine.packageName !== 'undefined' && traceLine.packageName !== 'demo') {
        // then skip this line
        return true;
    }

    // You can console.log(traceLine) to see all of it's properties.
    // Don't expect all these properties to be present, and don't assume
    // that our traceLine is an object.
});

// there is also:
pe.unskip(fn);
pe.unskipAll();

pe.filter(function(traceLine, lineNumber){

    // the 'what' clause is something like:
    // 'DynamicTimeline.module.exports.DynamicTimeline._verifyProp'
    if (typeof traceLine.what !== 'undefined'){

        // we can shorten it with a regex:
        traceLine.what = traceLine.what.replace(
            /(.*\.module\.exports\.)(.*)/, '$2'
        );

    }
});

// there is also:
pe.removeFilter(fn);
pe.removeAllFilters();