❤
npm
Sign UpSign In

purr

0.1.2 • Public • Published

purr

Make your application purr. Add audio when functions and properties get called.

Install

npm install purr

Purpose

A module that allows you to make sounds when methods get called or error. Can be used with CLI's or any other modules you are working with.

This module is a scarlet plugin, and uses events on method calls to play sounds.

Examples

When a objects function is called, make a purr sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
purr.when(Math,'min').play();
 
Math.min(1,2,3);
//-> a purring sound will now be played on your speakers

When a objects function is called make a sound using the predefined sounds

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
purr.when(Math,'min').play('bomb');
 
Math.min(1,2,3);
//-> a bomb sound will now be played on your speakers

When a objects function is called call some sound file on your computer

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
purr.when(Math,'min').play('/home/user/myCustomSoundFile.wav');
 
Math.min(1,2,3);
//-> a sound will now be played on your speakers

When a function instance is called make a purr sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
function FunctionObject(){
    this.anyFunction = function(){};
    this.anyFunction2 = function(){};
};
var instance = FunctionObject();
purr.when(instance).play();
 
instance.anyFunction();
//-> a purring sound will now be played on your speakers
 
instance.anyFunction2();
//-> a purring sound will now be played on your speakers

When a function instance errors make a sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
function FunctionObject(){
    this.anyFunction = function(){throw new Error("some error")};
};
var instance = FunctionObject();
purr.whenError(instance).play('bomb');
 
instance.anyFunction();
//-> a bomb sound will now be played on your speakers
//-> because the method threw an error

When a function is called make a purr sound

var Scarlet = require('scarlet');
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;
 
function anyFunction(){};
anyFunction = purr.when(anyFunction).play();
 
anyFunction();
//-> a purring sound will now be played on your speakers

Api

Available Sounds

purr provides a couple of sounds, but can be easily set to use any sound given a path

Sounds:

  • moo
  • purr
  • beep
  • bomb
  • donkey

Getting Started with this plugin

This plugin requires Scarlet ~0.5.11

If you haven't used Scarlet before, be sure to check out the Documentation. To use this plugin perform the following:

Install scarlet

npm install scarlet --save

Install plugin

npm install purr --save

Once the plugin has been installed, you can use it in your application as follows:

//load scarlet
var Scarlet = require('scarlet');
 
//Initialize scarlet with the plugin
var scarlet = new Scarlet('purr');
var purr = scarlet.plugins.purr;

Readme

Keywords

Package Sidebar

Install

npm i purr

Repository

github.com/tjchaplin/purr

Homepage

github.com/tjchaplin/purr#readme

Weekly Downloads

0

Version

0.1.2

License

MIT

Last publish

Collaborators

  • tjchaplin
Try on RunKit
Report malware