sinatra-websocketio
===================
* Node.js like WebSocket I/O plugin for Sinatra.
* https://github.com/shokai/sinatra-websocketio
* https://github.com/shokai/sinatra-websocketio/wiki
* [Handle 10K+ clients on 1 process](https://github.com/shokai/sinatra-websocketio/wiki/C10K)
* This is a component of the [RocketIO](https://github.com/shokai/sinatra-rocketio)
Installation
------------
% gem install sinatra-websocketio
Requirements
------------
* Ruby 1.8.7 or 1.9.2 or 1.9.3 or 2.0.0
* Sinatra 1.3.0+
* EventMachine
* jQuery
Usage
-----
### Server --(WebSocket)--> Client
Server Side
```ruby
require 'sinatra'
require 'sinatra/websocketio'
set :websocketio, :port => 8080
run Sinatra::Application
```
```ruby
io = Sinatra::WebSocketIO
io.push :temperature, 35 # to all clients
io.push :light, {:value => 150}, {:to => session_id} # to specific client
```
Client Side
```html
```
```javascript
var io = new WebSocketIO().connect();
io.on("temperature", function(value){
console.log("server temperature : " + value);
}); // => "server temperature : 35"
io.on("light", function(data){
console.log("server light sensor : " + data.value);
}); // => "server light sensor : 150"
```
### Client --(WebSocket)--> Server
Client Side
```javascript
io.push("chat", {name: "shokai", message: "hello"}); // client -> server
```
Server Side
```ruby
io.on :chat do |data, session|
puts "#{data['name']} : #{data['message']} <#{session}>"
end
## => "shokai : hello <12abcde345f6g7h8ijk>"
```
### On "connect" Event
Client Side
```javascript
io.on("connect", function(session){
alert("connect!!");
});
io.on("disconnect", function(){
alert("disconnected");
});
```
Server Side
```ruby
io.on :connect do |session|
puts "new client <#{session}>"
end
io.on :disconnect do |session|
puts "client disconnected <#{session}>"
end
```
### On "error" Event
Client Side
```javascript
io.on("error", function(err){
console.error(err);
});
```
Server Side
```ruby
io.on :error do |e|
STDERR.puts e
end
```
### Remove Event Listener
Server Side
```ruby
event_id = io.on :chat do |data, from|
puts "#{data} - from#{from}"
end
io.removeListener event_id
```
or
```ruby
io.removeListener :chat # remove all "chat" listener
```
Client Side
```javascript
var event_id = io.on("error", function(err){
console.error("WebSocketIO error : "err);
});
io.removeListener(event_id);
```
or
```javascript
io.removeListener("error"); // remove all "error" listener
```
Sample App
----------
chat app
- https://github.com/shokai/sinatra-websocketio/tree/master/sample
Test
----
% gem install bundler
% bundle install
% export PORT=5000
% export WS_PORT=8080
% export PID_FILE=/tmp/sinatra-websocketio-test.pid
% rake test
Contributing
------------
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request