wampus 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 14ca9589d293012e05857f4bae923a158b794099
+  data.tar.gz: a4da144a3fbf35345d47b75d56ebcd9a9b715c66
+SHA512:
+  metadata.gz: bde24c014aa16619a31a9c591df246b4782884586009c02971dfe8dd4c9c6744f745825524e06e0c3175adcd480dccbc4f5ac1eac3225fedcb421758dac437bd
+  data.tar.gz: 7b049c53ba81457f85279a43991b6b8044a961363aacf662aae9203d5f93ee2d5dc5069ea98898ecb6ecc12644ee2a8e6c2937acbfcb1e99a771739704358667

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+.idea
+

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in wampus.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Michael Stack
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# Wamp
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'wampus'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install wampus
+
+## Usage
+
+TODO: Write usage instructions here
+
+## 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

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/lib/wampus/after_init.rb

@@ -0,0 +1,36 @@
+module Wampus
+  module AfterInit
+    extend ActiveSupport::Concern
+
+    included do
+      class_attribute :after_init_blocks
+      self.after_init_blocks = []
+    end
+
+    module ClassMethods
+      private
+
+      def after_init(&block)
+        after_init_blocks << block
+      end
+    end
+
+    def initialize(*args)
+      super if defined? super
+      exec_after_init
+    end
+
+    def exec_after_init
+      after_init_blocks.each do |block|
+        self.instance_exec &block
+      end
+      after_init_blocks = nil
+    end
+
+    private
+
+    def after_init(&block)
+      self.instance_exec &block
+    end
+  end
+end

data/lib/wampus/backends/redis.rb

@@ -0,0 +1,97 @@
+module Wampus
+  module Backends
+    module Redis
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :backend_redis_defaults
+        self.backend_defaults = {
+          :redis => {
+            :host => 'localhost',
+            :port => 6379,
+            :database => 0,
+            :password => nil,
+            :gc => 60,
+            :lock_timeout => 120,
+            :namespace => ''
+          }
+        }
+        class_attribute :backend_redis_config
+        self.backend_config = {:redis => {}}
+      end
+
+      module ClassMethods
+        def configure_backend(backend, options = {})
+          backend_config[backend] = backend_defaults[backend].merge options
+
+        end
+      end
+
+      def connect_backend
+        @events_namespace = backend_config[:redis][:namespace] + ':events'
+
+        @completed_events = []
+
+        @redis = ::Redis.new(:host => backend_config[:redis][:host], :port => backend_config[:redis][:port])
+        @subscriber = ::Redis.new(:host => backend_config[:redis][:host], :port => backend_config[:redis][:port])
+
+        if backend_config[:redis][:password]
+          @redis.auth(backend_config[:redis][:password])
+          @subscriber.auth(backend_config[:redis][:password])
+        end
+
+        @redis.select(backend_config[:redis][:database])
+        @subscriber.select(backend_config[:redis][:database])
+
+        Thread.new do
+          @subscriber.subscribe(@events_namespace) do |on|
+            on.message do |channel, message|
+              handle_message(message)
+            end
+          end
+        end
+
+      end
+
+        def create_event(connection, topic, payload, excluded, included)
+          create_event_on_redis(connection.id, topic.uri, payload, excluded, included)
+        end
+
+        private
+
+        def create_event_on_redis(connection_id, topic_uri, payload, excluded, included)
+          @redis.publish @events_namespace, [SecureRandom.uuid, connection_id, topic_uri, payload, excluded, included].to_json
+        end
+
+        def subscribe_to_events
+          Thread.new do
+            @subscriber.subscribe(@events_ns) do |on|
+              on.message do |channel, message|
+                handle_message_from_redis(message)
+              end
+            end
+          end
+        end
+
+        def handle_message_from_redis(message)
+          begin
+            id, connection_id, uri, payload, excluded, included = JSON.parse(message)
+
+            connection = find_connections(:id => connection_id).first
+            topic = topic_for_uri uri
+
+            return unless topic
+
+            topic.subscribers(connection, excluded, included) do |subscribers|
+              subscribers.each do |connection|
+                connection.websocket.send event_msg(topic.uri, payload)
+              end
+            end
+          rescue => error
+            # TODO Handle Error
+          end
+        end
+
+      end
+    end
+  end

data/lib/wampus/clients/wamp.rb

@@ -0,0 +1,7 @@
+module Wampus
+  module Clients
+    class Wamp
+      # TODO Implement
+    end
+  end
+end

data/lib/wampus/connection.rb

@@ -0,0 +1,48 @@
+module Wampus
+  class Connection
+
+    attr_reader :id, :websocket, :prefixes, :topics
+
+    attr_accessor :authenticated, :pending_auth, :auth_timeout_call
+
+    def initialize(id, websocket)
+      @id = id
+      @websocket = websocket
+      @prefixes = {}
+      @topics = []
+
+      @authenticated = false
+      @pending_auth = nil,
+      @auth_timeout_call = nil
+    end
+
+    def subscribe_to_topic(topic)
+      @topics << topic
+    end
+
+    def unsubscribe_from_topic(topic)
+      @topics.delete topic
+    end
+
+    def close_connection
+      @topics.each do |topic|
+        topic.remove_subscriber self
+      end
+    end
+
+    def add_prefix(prefix, uri)
+      @prefixes[prefix] = uri
+    end
+
+    def resolve_prefix(uri)
+      prefix = @prefixes.keys.select{|p| uri.include? p}.sort(&:length).last
+      prefix ? @prefixes[prefix] + uri[/(?<=:)(.+)/].to_s : uri
+    end
+
+    # TODO Use
+    def shrink_prefix(uri)
+      # TODO Implement
+    end
+
+  end
+end

data/lib/wampus/errors/call_error.rb

@@ -0,0 +1,17 @@
+module Wampus
+  module Errors
+    class CallError < StandardError
+
+      def initialize(error_uri, error_desc, error_details = nil)
+        super error_desc
+        @error_uri = error_uri
+        @error_desc = error_desc
+        @error_details = error_details
+      end
+
+      def to_call_error
+        [@error_uri, @error_desc, @error_details]
+      end
+    end
+  end
+end

data/lib/wampus/protocols/wamp.rb

@@ -0,0 +1,65 @@
+module Wampus
+  module Protocols
+    module Wamp
+
+      URI_BASE = 'http://api.wamp.ws/'
+      URI_TOPIC = URI_BASE + 'topic#'
+      URI_RPC =  URI_BASE + 'rpc#'
+      URI_ERROR = URI_BASE + 'error#'
+
+      PROTOCOL_VERSION = 1
+
+      WELCOME_MSG_ID = 0
+      def welcome_msg(connection_id)
+        [WELCOME_MSG_ID, connection_id, PROTOCOL_VERSION, server_ident].to_json
+      end
+
+      PREFIX_MSG_ID = 1
+      def prefix_msg(prefix, uri)
+        [PREFIX_MSG_ID, prefix, uri].to_json
+      end
+
+      CALL_MSG_ID = 2
+      def call_msg(call_id, proc_uri, *args)
+        [CALL_MSG_ID, call_id, proc_uri, *args].to_json
+      end
+
+      CALL_RESULT_MSG_ID = 3
+      def call_result_msg(call_id, result = nil)
+        [CALL_RESULT_MSG_ID, call_id, result].to_json
+      end
+
+      CALL_ERROR_MSG_ID = 4
+      def call_error_msg(call_id, error_uri, error_desc, error_details = nil)
+        msg = [CALL_ERROR_MSG_ID, call_id, error_uri, error_desc, error_details]
+        msg.delete_if { |x| x.nil? }
+        msg.to_json
+      end
+
+      SUBSCRIBE_MSG_ID = 5
+      def subscribe_msg(topic_uri)
+        [SUBSCRIBE_MSG_ID, topic_uri].to_json
+      end
+
+      UNSUBSCRIBE_MSG_ID = 6
+      def unsubscribe_msg(topic_uri)
+        [UNSUBSCRIBE_MSG_ID, topic_uri].to_json
+      end
+
+      PUBLISH_MSG_ID = 7
+      def publish_msg(topic_uri, event, exclude = nil, eligible = nil)
+        msg = [PUBLISH_MSG_ID, topic_uri, event]
+        msg[3] = exclude unless exclude.nil?
+        msg[4] = eligible unless eligible.nil?
+
+        msg.to_json
+      end
+
+      EVENT_MSG_ID = 8
+      def event_msg(topic_uri, event)
+        [EVENT_MSG_ID, topic_uri, event].to_json
+      end
+
+    end
+  end
+end

data/lib/wampus/protocols/wamp_cra.rb

@@ -0,0 +1,39 @@
+require 'openssl'
+require 'base64'
+
+module Wampus
+  module Protocols
+    module WampCra
+
+      include Wamp
+
+      URI_PROCEDURE = URI_BASE + 'procedure#'
+
+      def derive_key(secret, extra = nil)
+        if extra.is_a?(Hash) && extra.has_key?(:salt)
+
+          salt = extra[:salt]
+          iterations = extra.fetch(:iterations, 10000)
+          key_length = extra.fetch(:keylen, 32)
+          digest = OpenSSL::Digest::SHA256.new
+
+          key = OpenSSL::PKCS5.pbkdf2_hmac(secret, salt, iterations, key_length, digest).unpack('H*').first
+          Base64.encode64(key).strip
+        else
+          secret
+        end
+      end
+
+      def auth_signature(auth_challenge, auth_secret = nil, auth_extra = nil)
+        auth_secret = '' if auth_secret.nil?
+        auth_secret.encode! 'UTF-8' if auth_secret.encoding.name != 'UTF-8'
+        auth_secret = derive_key auth_secret, auth_extra
+        digest = OpenSSL::Digest::SHA256.new
+
+        hmac = OpenSSL::HMAC.hexdigest(digest, auth_secret, auth_challenge)
+        Base64.encode64(hmac).strip
+      end
+
+    end
+  end
+end

data/lib/wampus/pubsub/handler.rb

@@ -0,0 +1,25 @@
+module Wampus
+  module Pubsub
+    module Handler
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :subscribe_handlers, :publish_handlers
+        self.subscribe_handlers = {}
+        self.publish_handlers = {}
+      end
+
+      module ClassMethods
+        def expose_pub(method, options = {})
+          as = options.fetch :as, method
+          subscribe_handlers[as] = method
+        end
+
+        def expose_pub(method, options = {})
+          as = options.fetch :as, method
+          publish_handlers[as] = method
+        end
+      end
+    end
+  end
+end

data/lib/wampus/pubsub/server_ext.rb

@@ -0,0 +1,167 @@
+module Wampus
+  module Pubsub
+    module ServerExt
+      extend ActiveSupport::Concern
+
+      attr_accessor :topics
+
+      def initialize(*args)
+        @topics = {}
+        super(*args) if defined? super
+      end
+
+      included do
+        include ClassMethods
+      end
+
+      module ClassMethods
+        # -- Topic Handler Registration
+        def register_topic(base_uri, allow_partial_uri_match = false)
+          after_init do
+            topics[base_uri] = Wampus::Topic.new(base_uri, allow_partial_uri_match)
+          end
+        end
+
+        def register_topic_handler(handler, base_uri = '', allow_partial_uri_match = false)
+          after_init do
+            handler.subscribe_handlers.each do |uri_or_fragment, handler_method|
+              uri = base_uri + uri_or_fragment
+              register_topic_subscribe_method uri, handler, handler_method, allow_partial_uri_match
+            end
+
+            handler.publish_handlers.each do |uri_or_fragment, handler_method|
+              uri = base_uri + uri_or_fragment
+              register_topic_publish_method uri, handler, handler_method, allow_partial_uri_match
+            end
+          end
+        end
+
+        def register_topic_subscribe_method(uri, handler, handler_method, allow_partial_uri_match = false)
+          after_init do
+            topic = topics[uri] ||= register_topic(uri, allow_partial_uri_match)
+            topic.subscribe_handler = [handler, handler_method, allow_partial_uri_match]
+          end
+        end
+
+        def register_topic_publish_method(uri, handler, handler_method, allow_partial_uri_match = false)
+          after_init do
+            topic = topics[uri] ||= register_topic(uri, allow_partial_uri_match)
+            topic.publish_handler = [handler, handler_method, allow_partial_uri_match]
+          end
+        end
+
+        def register_topic_subscribe_block(uri, allow_partial_uri_match = false, &block)
+          after_init do
+            topic = topics[uri] ||= register_topic(uri, allow_partial_uri_match)
+            topic.subscribe_handler = [nil, block, allow_partial_uri_match]
+          end
+        end
+
+        def register_topic_publish_block(uri, allow_partial_uri_match = false, &block)
+          after_init do
+            topic = topics[uri] ||= register_topic(uri, allow_partial_uri_match)
+            topic.publish_handler = [nil, block, allow_partial_uri_match]
+          end
+        end
+      end
+
+      def handle_subscribe_msg(connection, data)
+        topic_uri = connection.resolve_prefix data[0]
+        handler = get_subscribe_handler topic_uri
+
+        # Do nothing unless the server recognizes the topic
+        return unless handler
+
+        # Do nothing unless the handler covers partial uri matches
+        return unless handler[1] == '' && !handler[4]
+
+        topic = topic_for_uri topic_uri
+
+        if handler[2].nil? && handler[3].nil?
+          topic.add_subscriber connection
+        else
+          begin
+            if handler[2]
+              result = handler[2].send handler[3], [connection, topic_uri]
+            elsif handler[3].is_a? Proc
+              result = handler[3].call connection, topic_uri
+            end
+            topic.add_subscriber connection
+          rescue => error
+            # Nothing
+          end
+        end
+      end
+
+      def handle_unsubscribe_msg(connection, data)
+        topic = topic_for_uri connection.resolve_prefix data[0]
+        return unless topic
+        topic.remove_subscriber connection
+        connection.unsubscribe_from_topic topic
+      end
+
+      def handle_publish_msg(connection, data)
+        topic_uri, event, exclude, include = data
+        uri = connection.resolve_prefix topic_uri
+        handler = get_publish_handler uri
+
+        # Do nothing unless the server recognizes the topic
+        return unless handler
+
+        # Do nothing unless the handler covers partial uri matches
+        return unless handler[1] == '' && !handler[4]
+
+        topic = topic_for_uri uri
+
+        # Exclude true means to exclude myself from the message
+        exclude = [connection.id] if exclude == true
+
+        if handler[2].nil? && handler[3].nil?
+          dispatch_event topic.uri, event, exclude, include
+        else
+          begin
+            begin
+              if handler[2]
+                result = handler[2].send handler[3], [connection, topic_uri]
+              elsif handler[3].is_a? Proc
+                result = handler[1].call connection, topic_uri
+              end
+              dispatch_event topic.uri, event, exclude, include
+            rescue => error
+              # Nothing
+            end
+          end
+        end
+      end
+
+      def dispatch_event(topic_uri, event, exclude, include)
+        topic = topics[topic_uri]
+        topic.subscribers(exclude, include).each do |subscriber|
+          subscriber.websocket.send event_msg(topic_uri, event)
+        end
+      end
+
+      private
+
+      def topic_for_uri(topic_uri)
+        uri = topics.keys.select { |uri| topic_uri.include? uri }.sort_by(&:length).last
+        topics[uri]
+      end
+
+      def get_subscribe_handler(topic_uri)
+        topic = topic_for_uri topic_uri
+        nil unless topic
+        handler = topic.subscribe_handler
+        [topic.uri, topic_uri[topic.uri.length..-1], *handler]
+      end
+
+      def get_publish_handler(topic_uri)
+        topic = topic_for_uri topic_uri
+        nil unless topic
+        handler = topic.publish_handler
+        [topic.uri, topic_uri[topic.uri.length..-1], *handler]
+      end
+
+    end
+  end
+end

data/lib/wampus/rpc/handler.rb

@@ -0,0 +1,19 @@
+module Wampus
+  module Rpc
+    module Handler
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :rpc_handlers
+        self.rpc_handlers = {}
+      end
+
+      module ClassMethods
+        def expose_rpc(method, options = {})
+          as = options.fetch :as, method
+          rpc_handlers[as] = method
+        end
+      end
+    end
+  end
+end

data/lib/wampus/rpc/server_ext.rb

@@ -0,0 +1,98 @@
+module Wampus
+  module Rpc
+    module ServerExt
+      extend ActiveSupport::Concern
+
+      attr_reader :rpcs
+
+      def initialize(*args)
+        @rpcs = {}
+        super(*args) if defined? super
+      end
+
+      included do
+        include ClassMethods
+      end
+
+      module ClassMethods
+        # -- RPC Handler Registration
+        def register_rpc_handler(handler, base_uri)
+          after_init do
+            handler.rpc_handlers.each do |procedure, handler_method|
+              uri = URI_RPC_BASE + procedure
+              register_rpc_method uri, handler, handler_method
+            end
+          end
+        end
+
+        def register_rpc_method(uri, handler, handler_method)
+          after_init do
+            rpcs[uri] = [handler, handler_method]
+          end
+        end
+
+        def register_rpc_block(uri, &block)
+          after_init do
+            rpcs[uri] = [nil, block]
+          end
+        end
+      end
+
+      # TODO FIXME Use EM Deferred
+      def handle_call_msg(connection, data)
+        call_id, proc_uri, *args = data
+
+        uri = connection.resolve_prefix proc_uri
+        handler = rpcs[uri]
+
+        begin
+          rpc_call_exists = rpcs.has_key?(uri)
+          uri, args = on_before_call connection, call_id, uri, args, rpc_call_exists
+          unless rpc_call_exists
+            raise Wampus::Errors::CallError.new(URI_ERROR+'NoSuchRPCEndpoint', 'Missing Method')
+          end
+          if handler[0]
+            result = handler[0].send handler[1], [connection, *args]
+          elsif handler[1].is_a? Proc
+            result = handler[1].call connection, *args
+          end
+          result = on_after_call_success connection, result
+          connection.send call_result_msg call_id, result
+        rescue => error
+          error = on_after_call_error connection, error
+          msg = call_error_msg call_id, *error.to_call_error
+          connection.send msg
+          on_after_send_call_error connection, msg
+        end
+      end
+
+      # -- RPC Hooks
+
+      def on_before_call(connection, call_id, uri, args, call_exists)
+        [uri, args]
+      end
+
+      def on_after_call_success(connection, result)
+        result
+      end
+
+      def on_after_call_error(connection, error)
+        unless error.is_a? Wampus::Errors::CallError
+          error = Wampus::Errors::CallError.new(URI_ERROR+'generic', 'RPC Call Error')
+        end
+        error
+      end
+
+      def on_after_send_call_error(connection, error_msg)
+      end
+
+      private
+
+      def proc_for_uri(rpc_uri)
+        uri = rpcs.keys.select { |uri| uri.include? rpc_uri }.sort_by(&:length).last
+        rpcs[uri]
+      end
+
+    end
+  end
+end

data/lib/wampus/servers/wamp.rb

@@ -0,0 +1,120 @@
+module Wampus
+  module Servers
+    class Wamp
+      include Wampus::AfterInit
+      include Wampus::Protocols::Wamp
+
+      attr_reader :connections
+
+      def initialize(*args)
+        @connections = {}
+
+        super(*args) if defined? super
+      end
+
+      def run(options = {})
+        options[:protocol] ||= ['wamp']
+        options['sec-websocket-protocol'] = 'wamp'
+        EM::WebSocket.run(options) do |ws|
+          ws.onopen { |handshake| on_connection_open ws, handshake }
+          ws.onmessage { |event| on_connection_message ws, event }
+          ws.onerror { |error| on_connection_error ws, error }
+          ws.onclose { |event| on_connection_close ws, event }
+        end
+      end
+
+      def on_session_open(connection)
+        # Nothing
+      end
+
+      def on_connection_open(websocket, handshake)
+        connection = new_connection(websocket)
+        connection.websocket.send welcome_msg connection.id
+        on_session_open connection
+      end
+
+      def on_connection_message(websocket, message)
+        connection = find_connections(:websocket => websocket).first
+
+        # Consume any Non-WAMP WS messages
+        begin
+          data = JSON.parse(message)
+          msg_type = data.shift
+        rescue => error
+          # TODO Handle Error
+          return
+        end
+
+        case msg_type
+          when PREFIX_MSG_ID
+            handle_prefix_msg connection, data
+          when CALL_MSG_ID
+            handle_call_msg connection, data
+          when SUBSCRIBE_MSG_ID
+            handle_subscribe_msg connection, data
+          when UNSUBSCRIBE_MSG_ID
+            handle_unsubscribe_msg connection, data
+          when PUBLISH_MSG_ID
+            handle_publish_msg connection, data
+        end
+      end
+
+      def on_connection_close(websocket, event)
+        connection = delete_connection websocket
+        connection.close_connection
+      end
+
+      # TODO Handle Errors
+      def on_connection_error(websocket, error)
+        p [:error!, error]
+      end
+
+      def handle_prefix_msg(connection, data)
+        prefix, uri = data
+
+        connection.add_prefix prefix, uri
+      end
+
+      def handle_call_msg(connection, data)
+        super if defined? super
+      end
+
+      def handle_subscribe_msg(connection, data)
+        super if defined? super
+      end
+
+      def handle_unsubscribe_msg(connection, data)
+        super if defined? super
+      end
+
+      def handle_publish_msg(connection, data)
+        super if defined? super
+      end
+
+      def server_ident
+        Wampus::identity
+      end
+
+      private
+
+      # -- Connection Management
+
+      def new_connection(websocket)
+        connection = Wampus::Connection.new SecureRandom.uuid, websocket
+        connections[connection.id] = connection
+      end
+
+      def find_connections(filters = {})
+        connections.select do |id, connection|
+          filters.all? { |message, value| connection.send(message) == value }
+        end.flat_map { |conn| conn[1] }
+      end
+
+      def delete_connection(websocket)
+        connection = find_connections(:websocket => websocket).first
+        connections.delete connection.id
+      end
+
+    end
+  end
+end

data/lib/wampus/servers/wamp_cra.rb

@@ -0,0 +1,127 @@
+module Wampus
+  module Servers
+    class WampCra < Wamp
+      include Wampus::Protocols::WampCra
+      include Wampus::Rpc::ServerExt
+
+      class_attribute :client_auth_timeout, :client_auth_allow_anonymous
+      self.client_auth_timeout = 0
+      self.client_auth_allow_anonymous = true
+
+      after_init do
+        register_rpc_method URI_RPC+'authRequest', self, :auth_request
+        register_rpc_method URI_RPC+'auth', self, :auth
+      end
+
+      def get_auth_permissions(connection, auth_key, auth_extra)
+        {:permissions => { :pubsub => [], :rpc => [] } }
+      end
+
+      def get_auth_secret(connection, auth_key)
+        nil
+      end
+
+      def on_auth_timeout(connection)
+        # Nothing
+      end
+
+      def on_authenticated(connection, auth_key, permissions)
+        # Nothing
+      end
+
+      def on_session_open(connection)
+        if client_auth_timeout > 0
+          connection.auth_timeout_call = EventMachine.add_timer client_auth_timeout {
+            on_auth_timeout(connection)
+          }
+        end
+      end
+
+      def auth_request(connection, auth_key = nil, extra = {})
+        if connection.authenticated
+          raise Wampus::Errors::CallError.new(URI_ERROR+'already-authenticated', 'Already Authenticated')
+        end
+
+        unless connection.pending_auth.nil?
+          raise Wampus::Errors::CallError.new(URI_ERROR+'authentication-already-requested', 'Authentication Already Requested')
+        end
+
+        unless extra.is_a? Hash
+          raise Wampus::Errors::CallError.new(URI_ERROR+'invalid-argument', 'Extra is not a Dictionary/Hash')
+        end
+
+        if auth_key.nil? && !client_auth_allow_anonymous
+          raise Wampus::Errors::CallError.new(URI_ERROR+'anonymous-auth-forbidden', 'Anonymous Auth Forbidden')
+        end
+
+        auth_secret = get_auth_secret connection, auth_key
+        on_get_auth_secrek_ok connection, auth_secret, auth_key, extra
+      end
+
+      def auth(connection, signature = nil)
+        if connection.authenticated
+          raise Wampus::Errors::CallError.new(URI_ERROR+'already-authenticated', 'Already Authenticated')
+        end
+
+        if connection.pending_auth.nil?
+          raise Wampus::Errors::CallError.new(URI_ERROR+'no-authentication-requested', 'No Authentication Requested')
+        end
+
+        if connection.pending_auth[1] != signature
+          connection.pending_auth = nil
+
+          return EventMachine.add_timer expo(1.25) {
+            raise Wampus::Errors::CallError.new URI_ERROR+'invalid-signature', 'Signature for authentication request is invalid'
+          }
+        end
+
+        permissions = connection.pending_auth
+        auth_key = connection.pending_auth[0][:auth_key]
+        connection.authenticated = true
+        connection.pending_auth = nil
+        unless connection.auth_timeout_call.nil?
+          connection.auth_timeout_call.cancel
+          connection.auth_timeout_call = nil
+        end
+
+        on_authenticated connection, auth_key, permissions
+
+        return permissions[:permissions]
+      end
+
+      private
+
+      def on_get_auth_secret_ok(connection, auth_secret, auth_key, extra)
+        auth_id = SecureRandom.uuid
+
+        auth_info = {
+          :authid => auth_id,
+          :auth_key => auth_key,
+          :timestamp => Time.now.to_i,
+          :session_id => connection.id,
+          :extra => extra
+        }
+
+        results = get_auth_permissions connection, auth_key, extra
+        auth_info[:permissions] = results[:permissions]
+        auth_info[:auth_extra] = results[:auth_extra] if results.has_key? :auth_extra
+
+        if auth_key
+          auth_sig = auth_signature auth_info, auth_secret
+          connection.pending_auth = [auth_info, auth_sig, results]
+          return auth_info
+        else
+          connection.pending_auth = [auth_info, nil, results]
+          return nil
+        end
+      rescue => error
+        raise CallError.new(URI_ERROR+'auth-permissions-error', error.message)
+      end
+
+      def expo(l)
+        ((-Math.log(1-Random.rand)).quo l)
+      end
+
+    end
+  end
+end

data/lib/wampus/topic.rb

@@ -0,0 +1,45 @@
+require 'set'
+
+module Wampus
+  class Topic
+
+    attr_accessor :subscribe_handler, :publish_handler
+    attr_reader :uri, :allow_partial_uri_match, :connections
+
+    def initialize(uri, allow_partial_uri_match = false)
+      @uri = uri
+      @allow_partial_uri_match = allow_partial_uri_match
+      @connections = Set.new
+      @subscribe_handler = [nil, nil, false]
+      @publish_handler = [nil, nil, false]
+    end
+
+    def add_subscriber(connection)
+      @connections << connection
+      connection.subscribe_to_topic self
+    end
+
+    def remove_subscriber(connection)
+      @connections.delete connection
+      connection.unsubscribe_from_topic self
+    end
+
+    def subscribers(excluded = [], eligible = [])
+      connections = @connections.to_a
+
+      if !!excluded == false
+        excluded = []
+      end
+
+      if !!eligible == false
+        eligible = []
+      end
+
+      connections.delete_if { |connection| excluded.include? connection.id } unless excluded.empty?
+      connections.keep_if { |connection| eligible.include? connection.id } unless eligible.empty?
+
+      connections
+    end
+
+  end
+end

data/lib/wampus/version.rb

@@ -0,0 +1,3 @@
+module Wampus
+  VERSION = '0.0.2'
+end

data/lib/wampus.rb

@@ -0,0 +1,51 @@
+module Wampus
+
+  ROOT = File.expand_path File.dirname __FILE__
+
+  autoload :AfterInit, File.join(ROOT, 'wampus', 'after_init')
+  autoload :Connection, File.join(ROOT, 'wampus', 'connection')
+  autoload :Topic, File.join(ROOT, 'wampus', 'topic')
+  require File.join(ROOT, 'wampus', 'version')
+
+  module Backends
+    autoload :Redis, File.join(ROOT, 'wampus', 'backends', 'redis')
+  end
+
+  module Clients
+    autoload :Wamp, File.join(ROOT, 'wampus', 'clients', 'wamp')
+  end
+
+  module Errors
+    autoload :CallError, File.join(ROOT, 'wampus', 'errors', 'call_error')
+  end
+
+  module Protocols
+    autoload :Wamp, File.join(ROOT, 'wampus', 'protocols', 'wamp')
+    autoload :WampCra, File.join(ROOT, 'wampus', 'protocols', 'wamp_cra')
+  end
+
+  module Pubsub
+    autoload :Handler, File.join(ROOT, 'wampus', 'pubsub', 'handler')
+    autoload :ServerExt, File.join(ROOT, 'wampus', 'pubsub', 'server_ext')
+  end
+
+  module Rpc
+    autoload :Handler, File.join(ROOT, 'wampus', 'rpc', 'handler')
+    autoload :ServerExt, File.join(ROOT, 'wampus', 'rpc', 'server_ext')
+  end
+
+  module Servers
+    autoload :Wamp, File.join(ROOT, 'wampus', 'servers', 'wamp')
+    autoload :WampCra, File.join(ROOT, 'wampus', 'servers', 'wamp_cra')
+  end
+
+  class << self
+    def version
+      Wampus::VERSION
+    end
+
+    def identity
+      "Wampus/#{Wampus::VERSION}"
+    end
+  end
+end

data/wampus.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'wampus/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'wampus'
+  spec.version       = Wampus::VERSION
+  spec.authors       = ['Michael Stack']
+  spec.email         = ['michael.stack@gmail.com']
+  spec.description   = 'WebSocket server supporting the WAMP subprotocol'
+  spec.summary       = ''
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+
+  spec.add_dependency 'eventmachine'
+  spec.add_dependency 'em-websocket'
+  spec.add_dependency 'activesupport'
+
+end

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: wampus
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Michael Stack
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: em-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: WebSocket server supporting the WAMP subprotocol
+email:
+- michael.stack@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/wampus.rb
+- lib/wampus/after_init.rb
+- lib/wampus/backends/redis.rb
+- lib/wampus/clients/wamp.rb
+- lib/wampus/connection.rb
+- lib/wampus/errors/call_error.rb
+- lib/wampus/protocols/wamp.rb
+- lib/wampus/protocols/wamp_cra.rb
+- lib/wampus/pubsub/handler.rb
+- lib/wampus/pubsub/server_ext.rb
+- lib/wampus/rpc/handler.rb
+- lib/wampus/rpc/server_ext.rb
+- lib/wampus/servers/wamp.rb
+- lib/wampus/servers/wamp_cra.rb
+- lib/wampus/topic.rb
+- lib/wampus/version.rb
+- wampus.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.10
+signing_key: 
+specification_version: 4
+summary: ''
+test_files: []