Skip to content

Commit

Permalink
rebranding as cluster
Browse files Browse the repository at this point in the history
  • Loading branch information
tj committed Feb 11, 2011
1 parent ad99a1c commit 2136fbf
Show file tree
Hide file tree
Showing 31 changed files with 94 additions and 95 deletions.
20 changes: 10 additions & 10 deletions docs/api.md
@@ -1,19 +1,19 @@


## API ## API


The Engine API at its core is extremely simple, all we need to do is pass The Cluster API at its core is extremely simple, all we need to do is pass
our http `server` to `engine()`, then call `listen()` as we would on the `http.Server` itself. our http `server` to `cluster()`, then call `listen()` as we would on the `http.Server` itself.




var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var server = http.createServer(function(req, res){ var server = http.createServer(function(req, res){
res.writeHead(200); res.writeHead(200);
res.end('Hello World'); res.end('Hello World');
}); });


engine(server) cluster(server)
.listen(3000); .listen(3000);


### Plugins ### Plugins
Expand All @@ -28,14 +28,14 @@


To use them, all we need to do is pass it to the `use()` method: To use them, all we need to do is pass it to the `use()` method:


engine(server) cluster(server)
.use(myPlugin('/some/path')) .use(myPlugin('/some/path'))
.listen(3000); .listen(3000);


To use a plugin that is bundled with Engine simply grab it from the `engine` object: To use a plugin that is bundled with Cluster simply grab it from the `cluster` object:


engine(server) cluster(server)
.use(engine.logger()) .use(cluster.logger())
.listen(3000); .listen(3000);


### Settings ### Settings
Expand All @@ -49,14 +49,14 @@


We can take what we have now, and go on to apply settings using the `set(option, value)` method. For example: We can take what we have now, and go on to apply settings using the `set(option, value)` method. For example:


engine(server) cluster(server)
.set('working directory', '/') .set('working directory', '/')
.set('workers', 5) .set('workers', 5)
.listen(3000); .listen(3000);


### Signals ### Signals


Engine performs the following actions when handling signals: Cluster performs the following actions when handling signals:


- `SIGINT` hard shutdown - `SIGINT` hard shutdown
- `SIGTERM` hard shutdown - `SIGTERM` hard shutdown
Expand Down
4 changes: 2 additions & 2 deletions docs/debug.md
Expand Up @@ -22,6 +22,6 @@ Outputs verbose debugging information to _stderr_.


## Usage ## Usage


engine(server) cluster(server)
.use(engine.debug()) .use(cluster.debug())
.listen(3000); .listen(3000);
12 changes: 6 additions & 6 deletions docs/logger.md
Expand Up @@ -16,20 +16,20 @@ The `logger([path[, level]])` plugin accepts an optional `path`, and optional `l


Outputting to `./logs`: Outputting to `./logs`:


engine(server) cluster(server)
.use(engine.logger()) .use(cluster.logger())
.listen(3000); .listen(3000);




Outputting to `./tmp/logs`: Outputting to `./tmp/logs`:


engine(server) cluster(server)
.use(engine.logger('tmp/logs')) .use(cluster.logger('tmp/logs'))
.listen(3000); .listen(3000);




Outputting to `/var/log/node` with a log level of `debug`: Outputting to `/var/log/node` with a log level of `debug`:


engine(server) cluster(server)
.use(engine.logger('/var/log/node', 'debug')) .use(cluster.logger('/var/log/node', 'debug'))
.listen(3000); .listen(3000);
8 changes: 4 additions & 4 deletions docs/pidfiles.md
Expand Up @@ -15,12 +15,12 @@ The `pidfiles([path])` plugin saves pid (process-id) files to the given `path` o


save to `./pids`: save to `./pids`:


engine(server) cluster(server)
.use(engine.pidfiles()) .use(cluster.pidfiles())
.listen(3000); .listen(3000);


save to `/var/run/node`: save to `/var/run/node`:


engine(server) cluster(server)
.use(engine.logger('/var/run/node')) .use(cluster.logger('/var/run/node'))
.listen(3000); .listen(3000);
4 changes: 2 additions & 2 deletions examples/basic.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var body = 'Hello World' var body = 'Hello World'
Expand All @@ -13,6 +13,6 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.set('working directory', '/') .set('working directory', '/')
.listen(3000); .listen(3000);
8 changes: 4 additions & 4 deletions examples/debug.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var server = http.createServer(function(req, res){ var server = http.createServer(function(req, res){
Expand All @@ -13,7 +13,7 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.use(engine.logger('logs', 'debug')) .use(cluster.logger('logs', 'debug'))
.use(engine.debug()) .use(cluster.debug())
.listen(3000); .listen(3000);
12 changes: 6 additions & 6 deletions examples/error.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var server = http.createServer(function(req, res){ var server = http.createServer(function(req, res){
Expand All @@ -14,9 +14,9 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.use(engine.debug()) .use(cluster.debug())
.use(engine.logger()) .use(cluster.logger())
.use(engine.stats()) .use(cluster.stats())
.use(engine.repl(__dirname + '/repl')) .use(cluster.repl(__dirname + '/repl'))
.listen(3000); .listen(3000);
6 changes: 3 additions & 3 deletions examples/logger.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var server = http.createServer(function(req, res){ var server = http.createServer(function(req, res){
Expand All @@ -13,6 +13,6 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.use(engine.logger()) .use(cluster.logger())
.listen(3000); .listen(3000);
6 changes: 3 additions & 3 deletions examples/pids.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var body = 'Hello World' var body = 'Hello World'
Expand All @@ -13,6 +13,6 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.use(engine.pidfiles()) .use(cluster.pidfiles())
.listen(3000); .listen(3000);
8 changes: 4 additions & 4 deletions examples/reload.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


// try loading, and changing "Hello", to "Hello World" // try loading, and changing "Hello", to "Hello World"
Expand All @@ -15,8 +15,8 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.set('workers', 1) .set('workers', 1)
.use(engine.reload(__dirname)) .use(cluster.reload(__dirname))
.use(engine.debug()) .use(cluster.debug())
.listen(3000); .listen(3000);
10 changes: 5 additions & 5 deletions examples/repl-unix.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var server = http.createServer(function(req, res){ var server = http.createServer(function(req, res){
Expand All @@ -15,14 +15,14 @@ var server = http.createServer(function(req, res){


// custom repl function // custom repl function


engine.repl.define('echo', function(master, sock, msg){ cluster.repl.define('echo', function(master, sock, msg){
sock.write(msg + '\n'); sock.write(msg + '\n');
}, 'echo the given message'); }, 'echo the given message');


// $ telnet /path/to/examples/repl // $ telnet /path/to/examples/repl


engine(server) cluster(server)
.set('workers', 1) .set('workers', 1)
.use(engine.logger()) .use(cluster.logger())
.use(engine.repl(__dirname + '/repl')) .use(cluster.repl(__dirname + '/repl'))
.listen(3000); .listen(3000);
14 changes: 7 additions & 7 deletions examples/repl.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var server = http.createServer(function(req, res){ var server = http.createServer(function(req, res){
Expand All @@ -15,15 +15,15 @@ var server = http.createServer(function(req, res){


// custom repl function // custom repl function


engine.repl.define('echo', function(master, sock, msg){ cluster.repl.define('echo', function(master, sock, msg){
sock.write(msg + '\n'); sock.write(msg + '\n');
}, 'echo the given message'); }, 'echo the given message');


// $ telnet localhots 8888 // $ telnet localhots 8888


engine(server) cluster(server)
.use(engine.logger('logs')) .use(cluster.logger('logs'))
.use(engine.stats()) .use(cluster.stats())
.use(engine.repl(8888)) .use(cluster.repl(8888))
.use(engine.debug()) .use(cluster.debug())
.listen(3000); .listen(3000);
4 changes: 2 additions & 2 deletions examples/single.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var body = 'Hello World' var body = 'Hello World'
Expand All @@ -13,7 +13,7 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.set('working directory', '/') .set('working directory', '/')
.set('workers', 1) .set('workers', 1)
.listen(3000); .listen(3000);
6 changes: 3 additions & 3 deletions examples/stats.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var server = http.createServer(function(req, res){ var server = http.createServer(function(req, res){
Expand All @@ -13,6 +13,6 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.use(engine.stats()) .use(cluster.stats())
.listen(3000); .listen(3000);
4 changes: 2 additions & 2 deletions examples/unix.js
Expand Up @@ -3,7 +3,7 @@
* Module dependencies. * Module dependencies.
*/ */


var engine = require('../') var cluster = require('../')
, http = require('http'); , http = require('http');


var body = 'Hello World' var body = 'Hello World'
Expand All @@ -13,6 +13,6 @@ var server = http.createServer(function(req, res){
res.end(body); res.end(body);
}); });


engine(server) cluster(server)
.set('working directory', '/') .set('working directory', '/')
.listen('/tmp/server.sock'); .listen('/tmp/server.sock');
2 changes: 1 addition & 1 deletion index.js
@@ -1,2 +1,2 @@


module.exports = require('./lib/engine'); module.exports = require('./lib/cluster');
2 changes: 1 addition & 1 deletion lib/engine.js → lib/cluster.js
@@ -1,6 +1,6 @@


/*! /*!
* Engine * Cluster
* Copyright(c) 2010 LearnBoost <dev@learnboost.com> * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
* MIT Licensed * MIT Licensed
*/ */
Expand Down
3 changes: 1 addition & 2 deletions lib/master.js
@@ -1,7 +1,6 @@



/*! /*!
* Engine - Master * Cluster - Master
* Copyright(c) 2010 LearnBoost <dev@learnboost.com> * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
* MIT Licensed * MIT Licensed
*/ */
Expand Down
2 changes: 1 addition & 1 deletion lib/mixins/receiver.js
@@ -1,6 +1,6 @@


/*! /*!
* Engine - receiver mixin * Cluster - receiver mixin
* Copyright(c) 2010 LearnBoost <dev@learnboost.com> * Copyright(c) 2010 LearnBoost <dev@learnboost.com>
* MIT Licensed * MIT Licensed
*/ */
Expand Down
2 changes: 1 addition & 1 deletion lib/plugins/debug.js
@@ -1,6 +1,6 @@


/*! /*!
* Engine - debug * Cluster - debug
* Copyright (c) 2010 LearnBoost <dev@learnboost.com> * Copyright (c) 2010 LearnBoost <dev@learnboost.com>
* MIT Licensed * MIT Licensed
*/ */
Expand Down

0 comments on commit 2136fbf

Please sign in to comment.