aboutsummaryrefslogtreecommitdiff
path: root/node_modules/sparkles/README.md
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2016-10-10 03:43:44 +0200
committerFlorian Dold <florian.dold@gmail.com>2016-10-10 03:43:44 +0200
commitabd94a7f5a50f43c797a11b53549ae48fff667c3 (patch)
treeab8ed457f65cdd72e13e0571d2975729428f1551 /node_modules/sparkles/README.md
parenta0247c6a3fd6a09a41a7e35a3441324c4dcb58be (diff)
add node_modules to address #4364
Diffstat (limited to 'node_modules/sparkles/README.md')
-rw-r--r--node_modules/sparkles/README.md41
1 files changed, 41 insertions, 0 deletions
diff --git a/node_modules/sparkles/README.md b/node_modules/sparkles/README.md
new file mode 100644
index 000000000..8dfdb9cb2
--- /dev/null
+++ b/node_modules/sparkles/README.md
@@ -0,0 +1,41 @@
+sparkles
+========
+
+[![Build Status](https://travis-ci.org/phated/sparkles.svg?branch=master)](https://travis-ci.org/phated/sparkles)
+
+Namespaced global event emitter
+
+## Usage
+
+Sparkles exports a function that returns a singleton `EventEmitter`.
+This EE can be shared across your application, whether or not node loads
+multiple copies.
+
+```js
+var sparkles = require('sparkles')(); // make sure to call the function
+
+sparkles.on('my-event', function(evt){
+ console.log('my-event handled', evt);
+});
+
+sparkles.emit('my-event', { my: 'event' });
+```
+
+## API
+
+### sparkles(namespace)
+
+Returns an EventEmitter that is shared amongst the provided namespace. If no namespace
+is provided, returns a default EventEmitter.
+
+### sparkles.exists(namespace);
+
+Checks whether a namespace exists and returns true or false.
+
+## Why the name?
+
+This is a "global emitter"; shortened: "glitter" but it was already taken; so we got sparkles instead :smile:
+
+## License
+
+MIT