Contents

# 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 EchoConnection < Tribe::EM::Connection
      private
      
      def on_post_init(event)
        puts "Actor (#{identifier}) connected to client using thread (#{Thread.current.object_id})."
      end

      def on_receive_data(event)
        puts "Actor (#{identifier}) received data (#{event.data}) using thread (#{Thread.current.object_id})."
        write(event.data)
        enqueue(:shutdown)
      end

      def on_unbind(event)
        puts "Actor (#{identifier}) disconnected from client using thread (#{Thread.current.object_id})."
        super
      end
    end
    
    # Create your server actor.
    server = Tribe::EM::TcpServer.new('localhost', 9000, EchoConnection)

## 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.

## TODO - missing features

- Commonly used server protocols such as HTTP.
- Integration with my [AMF Socket] (https://github.com/chadrem/amf_socket_ruby "AMF Socket") gem.
- Client side sockets.


## 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

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
tribe_em-0.0.4	README.md
tribe_em-0.0.3	README.md