 __    __    ______     ______    __  ___         __    ______   
|  |  |  |  /  __  \   /  __  \  |  |/  /        |  |  /  __  \  
|  |__|  | |  |  |  | |  |  |  | |  '  /         |  | |  |  |  | 
|   __   | |  |  |  | |  |  |  | |    <          |  | |  |  |  | 
|  |  |  | |  `--'  | |  `--'  | |  .  \    __   |  | |  `--'  | 
|__|  |__|  \______/   \______/  |__|\__\  (__)  |__|  \______/  

a full featured i/o framework for node.js

v0.7.7

hook.io creates a distributed node.js EventEmitter that works cross-process / cross-platform / cross-browser. Think of it like a real-time event bus that works anywhere JavaScript is supported.

You create custom i/o scenarios by picking and choosing from an extensive library of tiny, independent, autonomous "hooks" that seamlessly work together.

Email List: http://groups.google.com/group/hookio

20 Video lessons available at: http://youtube.com/maraksquires and http://github.com/hookio/tutorials

Features :

Build large, decoupled, distributed, and fault tolerant I/O heavy applications in node.js
Create hooks on ANY device that supports JavaScript (cross-browser support via socket.io)
Throw any block of sync or async code on a new process with a callback
Easily scale any tcp based messaging infrastructure (such as clustering socket.io chat rooms in memory)
Interprocess Message Publishing and Subscribing done through EventEmitter2 and dnode
Messaging API inherits and mimics Node's native EventEmitter API (with the help of EventEmitter2)
Spawning and Daemonizing of processes handled with Forever
Easily connect / disconnect hooks "hot" without affecting other services
Core library currently checking in at about ~450 lines of code

Available Hooks (more coming soon)

cron: Adds and removes jobs that emit hook.io events on a schedule
couch: Emit hook.io events based on your CouchDB _changes feed
irc: Full IRC bindings
helloworld
logger: Multi-transport Logger (Console, File, Redis, Mongo, Loggly)
mailer: Sends emails
sitemonitor: A low level Hook for monitoring web-sites.
request: Simple wrapper for http://github.com/mikeal/request
repl: Rainbow Powered REPL
twilio: Make calls and send SMS through Twilio
twitter: Wrapper to Twitter API
webhook: Emits received HTTP requests as hook.io events (with optional JSON-RPC 1.0 Support)
wget: Downloads files using HTTP. Based on the http-get module by Stefan Rusu

Getting Start / Demo

 npm install hook.io-helloworld -g

Now run:

 hookio-helloworld

Spawn up as many as you want. The first one becomes a server, the rest will become clients. Each helloworld hook emits a hello on an interval. Now watch the i/o party go!

Blog Posts

hook.io for dummies: http://ejeklint.github.com/2011/09/23/hook.io-for-dummies-part-1-overview/ Distribute Node.js Apps with hook.io: http://blog.nodejitsu.com/distribute-nodejs-apps-with-hookio

Tests

All tests are written with [vows][7] and require that you link hook.io to itself:

  $ cd /path/to/hook.io
  $ [sudo] npm link
  $ [sudo] npm link hook.io
  $ npm test

Core Hook.io Team

Marak Squires, Charlie Robbins, Jameson Lee

Contributors (through code and advice)

Substack, h1jinx, AvianFlu, Chapel, Dominic Tarr, Tim Smart, tmpvar, kadir pekel, perezd, mklabs, temsa

mwawrusch/hook.io