Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/javiergarmon/hermod
Blazing fast communication between Node.js processes
https://github.com/javiergarmon/hermod
Last synced: about 2 months ago
JSON representation
Blazing fast communication between Node.js processes
- Host: GitHub
- URL: https://github.com/javiergarmon/hermod
- Owner: javiergarmon
- License: mit
- Created: 2014-03-20T20:11:19.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-09-27T00:45:16.000Z (almost 9 years ago)
- Last Synced: 2024-05-05T05:32:36.718Z (5 months ago)
- Language: JavaScript
- Size: 234 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-blazingly-fast - hermod - Blazing fast communication between Node.js processes (JavaScript)
README
# hermod
Blazing fast communication between Node.js processes
## How to install hermod
You can install hermod using Node Package Manager (npm):
```
npm install hermod
```
## Features
* Supports Request/Reply communication.
* Supports Send without Reply communication.
* Supports multiple server using round robin.
* Fault tolerant: clients will reconnect to servers even if server goes down and comes back later.
* Extremely fast (disables TCP Nagle's algorithm).
* Zero dependencies on other libraries.
* Block non-desired IPs.
## Examples
### Request/Reply: Server with one client
#### Server
```js
// Modules
var hermod = require('hermod');
// Create server
var server = hermod.createServer( 8000 );
// Listen petitions
server.on( 'hello', function( name, callback ){
callback( null, 'Hi ' + name + ', I am the server' );
});
```
#### Client
```js
// Modules
var hermod = require('hermod');
// Create client
var client = hermod.createClient( 8000 );
// Make a petition
client.request( 'hello', 'John', function( error, response ){
console.log( 'Server says', response );
});
```
### Request/Reply: 2 server with one client (Round robin)
#### Server 1
```js
// Modules
var hermod = require('hermod');
// Create server
var server = hermod.createServer( 8000 );
// Listen petitions
server.on( 'hello', function( name, callback ){
callback( null, 'Hi ' + name + ', I am the server 1' );
});
```
#### Server 2
```js
// Modules
var hermod = require('hermod');
// Create server
var server = hermod.createServer( 8001 );
// Listen petitions
server.on( 'hello', function( name, callback ){
callback( null, 'Hi ' + name + ', I am the server 2' );
});
```
#### Client
```js
// Modules
var hermod = require('hermod');
// Create client
var client = hermod.createClient( 8000, 8001 );
// Make a petition
client.request( 'hello', 'John', function( error, response ){
console.log( 'Server says', response );
});
```
### Send: Server with one client
#### Server
```js
// Modules
var hermod = require('hermod');
// Create server
var server = hermod.createServer( 8000 );
// Listen petitions
server.on( 'hello', function( name ){
console.log( 'I received a message from ' + name' );
});
```
#### Client
```js
// Modules
var hermod = require('hermod');
// Create client
var client = hermod.createClient( 8000 );
// Make a petition
client.send( 'hello', 'John' );
```
### Block non-desired connections from unknown IPs
#### Server
```js
// Modules
var hermod = require('hermod');
// Create server
var server = hermod.createServer(
8000,
null, // Host definition, use falsy values for autoconfiguration
[ '127.0.0.1', '192.168.1.42' ] // Accepted IPs. If it isn't defined all IPs are accepted.
);
// Listen petitions
server.on( 'hello', function( name ){
console.log( 'I received a message from ' + name' );
});
```
## Benchmarks
You can see benchmark results in https://github.com/javiergarmon/hermod-benchmark
## Changelog
* 0.0.5 ( 2014/06/26 ): Limit connections for specific IPs. Support host definition in server.
* 0.0.4 ( 2014/04/02 ): Optimized and `send()` method support.
* 0.0.3 ( 2014/04/02 ): Optimized and better documentation.
* 0.0.2 ( 2014/04/02 ): Optimized and prevent chuncked commands.
* 0.0.1 ( 2014/03/20 ): First version.
## To Do List
* Support encrypted communications
* `shout()` client method
* `close()` client method
* Authentication support
* Middleware support