Tribe EM
Tribe EM is a Ruby gem that adds event-driven network IO to [Tribe] (https://github.com/chadrem/tribe "Tribe"). It is based on [EventMachine] (http://rubyeventmachine.com/ "EventMachine").
Installation
Add this line to your application's Gemfile:
gem 'tribe_em'
And then execute:
$ bundle
Or install it yourself as:
$ gem install tribe_em
Usage
You can test the below code using a utility such as telnet (telnet localhost 9000), entering some text, and then killing telnet.
# Create a custom connection actor class.
class EchoConn < Tribe::EM::Connection
private
def exception_handler(e)
super
puts concat_e("EchoConn (#{identifier}) died.", e)
end
def post_init_handler
puts "Actor (#{identifier}) connected to client using thread (#{Thread.current.object_id})."
end
def receive_data_handler(data)
puts "Actor (#{identifier}) received data (#{data}) using thread (#{Thread.current.object_id})."
write(data)
shutdown!
end
def unbind_handler
puts "Actor (#{identifier}) disconnected from client using thread (#{Thread.current.object_id})."
end
end
# Create your server actor.
server = Tribe::EM::TcpServer.new('localhost', 9000, EchoConn)
Customization
Tribe EM is designed to be easily customized through inheritence of Tribe::EM::Connection. Communication between EventMachine and the Tribe actor system is provided by Tribe::EM::ActorProxy.
Protocols
Tribe EM has native TCP server and connection classes built in. Other protocol implementations can be found below. Note that some impmementations are marked as native while others are marked as wrappers. Native implementations are specifically designed to for Tribe EM and thus push most work to the actor threads. Wrapper implementations wrap existing EM libraries and usually do more work in the EM thread. This means that native implmentations (when used with real threads via JRuby) will scale better on multi-core systems. None of this really matters much with MRI Ruby since it has a global interpretter lock.
- [AMF Socket] (https://github.com/chadrem/tribe_em_amfsocket "AMF Socket") (wrapper)
TODO - missing features
- Commonly used server protocols such as HTTP.
- Client side sockets.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request