Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Adds a Console (REPL) interface to your SocketStream app

branch: master

Merge pull request #4 from Lophilo/econnreset

catch socket error (such as ECONNRESET)
latest commit 721e58a553
Owen Barnes owenb authored November 17, 2012
Octocat-spinner-32 bin 0.1.3 July 24, 2012
Octocat-spinner-32 lib catch socket error (such as ECONNRESET) November 15, 2012
Octocat-spinner-32 .gitignore 0.1.3 July 24, 2012
Octocat-spinner-32 HISTORY.md 0.1.3 July 24, 2012
Octocat-spinner-32 README.md 0.1.3 July 24, 2012
Octocat-spinner-32 package.json 0.1.3 July 24, 2012
README.md

Console (REPL) for SocketStream 0.3 apps

Allows you to connect to a running SocketStream server to call commands such as ss.rpc() or ss.publish.all() from the terminal. This can be very useful when debugging your app.

The SocketStream console follows the client/server model. This ensures the console client starts instantly and even allows you to run commands against a live production system, should you wish.

Important Note The latest release of ss-console (0.1.3) is designed to work with Node 0.8 only. If you are using Node 0.6 please install version 0.1.2 from npm.

Installation

Add ss-console to your package.json then add the following lines to your app.js file:

var consoleServer = require('ss-console')(ss);
consoleServer.listen(5000);

Change 5000 to another number if you wish to listen on another port.

Connecting to a server

Install the client globally with:

$ sudo npm install -g ss-console

Once your server is listening out for incoming console connections, connect to it from the terminal by executing:

$ ss-console

By default ss-console will try to connect to a SocketStream server on localhost, port 5000. To connect to another host and/or port, pass params as so:

$ ss-console www.mysocketstreamserver.com 8500

Note: A new Session ID will be created for you each time you connect to the console, allowing you to call ss.rpc() commands which use the req.use('session') middleware.

Something went wrong with that request. Please try again.