synapses 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e3261f0f0862b7da1353c90061c96343d0ff71ed
+  data.tar.gz: 957ef33f068ceedaa4bfaa72baa9aa2635188745
+SHA512:
+  metadata.gz: 57e1246b031236ff6e9a273724bb1accebe35fc8e55f582c9185b530c252a3f6b1844a2b8b3e0f39e5ddfe5cc0fc73998c6d9ff5ef146d796a7dda72b1081ddb
+  data.tar.gz: b127deed76a22ad81f51991f621251eee0ff2a1b77977bc8d1403547df2dcd535dd1726ac3533455d475f57e2ab987c54e418b36b1a413695807f06db51eb978

data/.gitignore

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

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in synapses.gemspec
+gemspec
+
+group :development do
+  gem 'yardstick'
+  gem 'backports'
+end
+
+group :development, :test do
+  gem 'bson'
+  gem 'bson_ext'
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Alexander Semyonov
+
+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 @@
+# Synapses
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'synapses'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install synapses
+
+## 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,51 @@
+require 'bundler/gem_tasks'
+
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec)
+rescue LoadError
+  task :spec do
+    abort 'RSpec is not available. In order to run specs, you must: gem install rspec'
+  end
+end
+
+namespace :doc do
+  begin
+    require 'yard'
+    YARD::Rake::YardocTask.new(:default)
+  rescue LoadError
+    task :default do
+      abort 'YARD is not available. In order to run yardoc, you must: gem install yard'
+    end
+  end
+
+  begin
+    require 'yardstick/rake/measurement'
+
+    Yardstick::Rake::Measurement.new(:measure) do |measurement|
+      measurement.output = 'doc/measurement.txt'
+    end
+    task doc: :measure
+  rescue LoadError
+    task :measure do
+      abort 'YARDStick is not available. In order to measure documentation coverage, you should run `gem install yardstick`'
+    end
+  end
+
+  begin
+    require 'yardstick/rake/verify'
+    Yardstick::Rake::Verify.new(:verify) do |verify|
+      verify.threshold = 100
+    end
+    task doc: :verify
+  rescue LoadError
+    task :verify do
+      abort 'YARDStick is not available. In order to verify documentation coverage, you should run `gem install backports yardstick`'
+    end
+  end
+end
+
+task doc: 'doc:default'
+
+
+task default: :spec

data/config/amqp.yml

@@ -0,0 +1,2 @@
+development:
+  uri: amqp://localhost

data/config/giteaucrat.yml

@@ -0,0 +1,5 @@
+---
+commit_keyword: "#giteaucrat"
+copyright_owner: Alexander Semyonov
+copyright_format: "© %{owner}, %{years}"
+include_encoding: true

data/examples/config/amqp.yml

@@ -0,0 +1,2 @@
+development:
+  uri: amqp://localhost

data/examples/config/synapses/radar.yml

@@ -0,0 +1,19 @@
+gov:
+  name: radar
+  queues:
+    logger:
+      bind: amq.fanout
+  messages:
+    ufo:
+      class_name: UFO
+      schema:
+        shape: String
+        color: string
+    rocket:
+      schema:
+        speed: Integer
+        target: [Integer, Integer]
+    plane:
+      schema:
+        brand: String
+        color: String

data/examples/config/synapses/rocket_center.yml

@@ -0,0 +1,11 @@
+mil:
+  name: rocket_center
+  queues:
+    rocket_shield:
+      bind: amq.fanout
+    rocket_launcher:
+      bind: amq.fanout
+  messages:
+    protect:
+
+    shed:

data/examples/game.rb

@@ -0,0 +1,110 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'synapses'
+
+Synapses.setup
+
+module Messages
+  include Synapses::Messages
+
+  class UFO < Message
+    self.routing_key = 'gov.radar.ufo'
+    self.message_type = 'gov.radar.ufo'
+    attribute :shape
+    attribute :color
+
+    def description
+      "UFO in shape of #{shape}, colored in #{color}"
+    end
+  end
+
+  class Plane < Message
+    self.routing_key = 'gov.radar.plane'
+    self.message_type = 'gov.radar.plane'
+    attribute :brand
+
+    def description
+      "There is a #{brand} Plane!"
+    end
+  end
+
+  class Rocket < Message
+    self.routing_key = 'gov.radar.rocket'
+    self.message_type = 'gov.radar.rocket'
+    attribute :speed
+    attribute :target
+
+    def description
+      "There is a rocket flying to the #{target} (#{speed})!"
+    end
+  end
+
+  class Protect < Message
+    self.routing_key = 'mil.rocket_center.protect'
+    self.message_type = 'mil.rocket_center.protect'
+  end
+end
+
+class Radar < Synapses::Producer
+  exchange 'amq.fanout'
+end
+
+class RocketCenter < Synapses::Producer
+  exchange 'amq.direct'
+end
+
+class RocketLauncher < Synapses::Consumer
+  exchange 'amq.fanout'
+  queue 'mil.rocket_center.rocket_launcher'
+
+  on Messages::UFO do |ufo|
+    puts "RocketLauncher: Messages::UFO -> #{ufo.description}"
+  end
+
+  on Messages::Rocket do |rocket|
+    puts "RocketLauncher: Messages::Rocket -> #{rocket.description}"
+  end
+end
+
+class RocketShield < Synapses::Consumer
+  exchange 'amq.fanout'
+  queue 'mil.rocket_center.rocket_shield'
+
+  on Messages::Protect do |protect|
+    puts "RocketShield: Messages::Protect -> #{protect}"
+  end
+end
+
+class RadarLogger < Synapses::Consumer
+  exchange 'amq.fanout'
+  queue 'gov.radar.logger'
+
+  on do |metadata, payload|
+    puts "RadarLogger -> #{metadata.routing_key}, #{payload}"
+  end
+end
+
+rockets_center_channel = Synapses.another_channel
+rocket_launcher = RocketLauncher.new(rockets_center_channel)
+rocket_shield = RocketShield.new(rockets_center_channel)
+
+logger_channel = Synapses.another_channel
+radar_logger = RadarLogger.new(logger_channel)
+
+radar_channel = Synapses.another_channel
+radar = Radar.new(radar_channel)
+
+puts 'Publishing Radar messages'
+1000.times do |i|
+radar << Messages::Plane.new(brand: 'boeing') if (i % 3) == 0
+radar << Messages::Rocket.new(target: 'Moon', speed: 42 * i) if (i % 4) == 0
+radar << Messages::UFO.new(shape: 'circle', color: 'green') if (i % 5) == 0
+end
+
+EM.run do
+  tick_tack = true
+  EM.add_periodic_timer(2) { puts (tick_tack = !tick_tack) ? 'tick' : 'tack' }
+end
+
+sleep(10)

data/lib/amqp/integration/rails.rb

@@ -0,0 +1,37 @@
+require 'yaml'
+require 'active_support/core_ext/hash/keys'
+
+module AMQP
+  module Integration
+    class Rails
+      # @return [String] application environment
+      def self.environment
+        if defined?(::Rails)
+          ::Rails.env
+        else
+          ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
+        end
+      end
+
+      # @return [String] application root directory
+      def self.root
+        defined?(::Rails) && ::Rails.root || Dir.pwd
+      end
+
+      def self.start(options_or_uri = {}, &block)
+        yaml     = YAML.load_file(File.join(root, 'config', 'amqp.yml'))
+        settings = yaml.fetch(environment, Hash.new).symbolize_keys
+
+        arg      = if options_or_uri.is_a?(Hash)
+                     settings.merge(options_or_uri)[:uri]
+                   else
+                     settings[:uri] || options_or_uri
+                   end
+
+        EventMachine.next_tick do
+          AMQP.start(arg, &block)
+        end
+      end
+    end # Rails
+  end # Integration
+end # AMQP

data/lib/synapses.rb

@@ -0,0 +1,57 @@
+# coding: utf-8
+
+################################################
+# © Alexander Semyonov, 2013—2013              #
+# Author: Alexander Semyonov <al@semyonov.us>  #
+################################################
+
+require 'synapses/version'
+require 'active_support'
+require 'active_support/core_ext/class/attribute'
+require 'amqp'
+
+# @author Alexander Semyonov <al@semyonov.us>
+module Synapses
+  def self.manager
+    @manager ||= Manager.new
+  end
+
+  def self.default_contract
+    @default_contract ||= Contract.load_defaults
+  end
+
+  def self.default_channel
+    @default_channel ||= default_connection && AMQP.channel
+  end
+
+  def self.default_connection
+    @default_connection || manager.start && @default_connection
+  end
+
+  def self.default_connection=(connection)
+    @default_connection = connection
+  end
+
+  def self.another_channel(connection = Synapses.default_connection)
+    manager.channel(connection)
+  end
+
+  def self.setup
+    default_contract
+    manager.start
+    default_connection
+    default_channel
+    sleep(0.25)
+    #default_contract.setup!
+    true
+  rescue => e
+    STDERR.puts e.message, e.backtrace
+    false
+  end
+end
+
+require 'synapses/contract'
+require 'synapses/producer'
+require 'synapses/consumer'
+require 'synapses/messages'
+require 'synapses/manager'

data/lib/synapses/consumer.rb

@@ -0,0 +1,104 @@
+# coding: utf-8
+
+################################################
+# © Alexander Semyonov, 2013—2013              #
+# Author: Alexander Semyonov <al@semyonov.us>  #
+################################################
+
+require 'synapses'
+require 'synapses/contract/definitions'
+
+module Synapses
+  # @author Alexander Semyonov <al@semyonov.us>
+  class Consumer
+    include Contract::Definitions
+
+    # @return [String]
+    class_attribute :queue_name
+
+    # @return [Synapses::Contract]
+    class_attribute :contract
+
+    # @return [Array]
+    class_attribute :subscriptions
+    self.subscriptions = Hash.new { |hash, message_type| hash[message_type] = [] }
+
+    def self.inherited(child)
+      super
+      child.subscriptions = subscriptions.dup
+    end
+
+    # @param [String] name
+    # @param [Synapses::Contract] contract
+    def self.queue(name, contract=Synapses.default_contract)
+      self.queue_name = name
+      self.contract = contract
+    end
+
+    def self.on(message_type = nil, &block)
+      if message_type
+        subscriptions[message_type.message_type] << [message_type, block]
+      else
+        subscriptions[nil] << [nil, block]
+      end
+    end
+
+    # @param [AMQP::Channel] channel
+    def initialize(channel = Synapses.default_channel)
+      @channel = channel
+
+      queue.subscribe(&method(:message_handler))
+    end
+
+    # @param [AMQP::Header] metadata
+    def message_handler(metadata, payload)
+      if (typed_subscriptions = self.subscriptions[metadata.type]).any?
+        typed_subscriptions.each do |message_class, block|
+          message = message_class.parse(metadata, payload)
+          block.call(message)
+        end
+      end
+
+      if (typeless_subscriptions = self.subscriptions[nil]).any?
+        typeless_subscriptions.each do |_, block|
+          if block.arity == 2
+            block.call(metadata, payload)
+          else
+            message = Messages.parse(metadata, payload)
+            block.call(message)
+          end
+        end
+      end
+
+      unless (typed_subscriptions + typeless_subscriptions).any?
+        puts "#{self} -> #{metadata.type}, #{payload}"
+        #puts "#{self} received a message:"
+        #puts "  metadata.routing_key : #{metadata.routing_key}"
+        #puts "  metadata.content_type: #{metadata.content_type}"
+        #puts "  metadata.priority    : #{metadata.priority}"
+        #puts "  metadata.headers     : #{metadata.headers.inspect}"
+        #puts "  metadata.timestamp   : #{metadata.timestamp.inspect}"
+        #puts "  metadata.type        : #{metadata.type}"
+        #puts "  metadata.delivery_tag: #{metadata.delivery_tag}"
+        #puts "  metadata.redelivered : #{metadata.redelivered}"
+        ##puts "  metadata.app_id      : #{metadata.app_id}"
+        #puts "  metadata.exchange    : #{metadata.exchange}"
+        #puts
+        #puts "  Received a message: #{payload}"
+      end
+    rescue => e
+      puts e
+    end
+
+    # @return [AMQP::Channel]
+    attr_accessor :channel
+
+    def queue
+      @queue ||= begin
+        queue = contract.queue(queue_name, channel)
+        queue.bind(exchange)
+        queue
+      end
+    end
+  end
+end

data/lib/synapses/contract.rb

@@ -0,0 +1,114 @@
+# coding: utf-8
+
+################################################
+# © Alexander Semyonov, 2013—2013              #
+# Author: Alexander Semyonov <al@semyonov.us>  #
+################################################
+
+require 'synapses'
+require 'yaml'
+
+module Synapses
+  # @author Alexander Semyonov <al@semyonov.us>
+  class Contract
+    # @return [String]
+    def self.default_contract_path
+      File.expand_path('../contract/synapses.yml', __FILE__)
+    end
+
+    # @param [String] file_name
+    # @return [Synapse::Contract]
+    def self.load_file(file_name)
+      hash = YAML.load_file(file_name)
+      new(hash)
+    end
+
+    # @param [String] root root directory
+    def self.load_defaults(root = './')
+      contract = new(YAML.load_file(default_contract_path), root: root)
+
+      ([File.join(root, 'config/synapses.yml')] +
+        Dir[File.join(root, 'config/synapses/*.yml')]).each do |file_name|
+
+        if File.exists?(file_name)
+          hash = YAML.load_file(file_name)
+          contract.add_contract(hash)
+        end
+      end
+      contract
+    end
+
+    # @param [Hash] hash
+    def initialize(hash, options = {})
+      @exchanges = Hash.new do |hash, name|
+        raise "Unknown Exchange #{name.inspect}. Known are: #{hash.keys.inspect}"
+      end
+      @queues = Hash.new do |hash, name|
+        raise "Unknown Queue #{name.inspect}. Known are: #{hash.keys.inspect}"
+      end
+      @options = options
+      add_contract(hash)
+    end
+
+    # @param [Hash] contract_hash
+    def add_contract(contract_hash)
+      contract_hash.each do |ns, hash|
+        ns = hash['ns'] if hash.key?('ns')
+
+        name = hash.delete('name')
+        prefix = [ns, name].compact.join('.')
+
+        if hash['exchanges']
+          hash.delete('exchanges').each do |name, attributes|
+            name = [prefix, name].join('.').to_s
+            exchanges[name] = Exchange.new(name, attributes || {})
+          end
+        end
+
+        if hash['queues']
+          hash.delete('queues').each do |name, attributes|
+            name = [prefix, name].join('.').to_s
+            queues[name.to_s] = Queue.new(name, attributes || {})
+          end
+        end
+      end
+    end
+
+    # @param [AMQP::Channel] channel
+    def setup!(channel = Synapses.default_channel)
+      exchanges.values.each { |exchange| exchange.exchange(channel) }
+      queues.values.each { |queue| queue.queue(channel) }
+    end
+
+    # @param [Synapses::Contract::Exchange] name
+    def exchange_definition(name)
+      exchanges[name.to_s]
+    end
+
+    # @param [Synapses::Contract::Queue] name
+    def queue_definition(name)
+      queues[name.to_s]
+    end
+
+    # @param [String] name
+    # @return [AMQP::Exchange]
+    def exchange(name, channel=Synapses.default_channel)
+      exchange_definition(name).exchange(channel)
+    end
+
+    # @param [String] name
+    # @param [AMQP::Channel] channel
+    # @return [AMQP::Queue]
+    def queue(name, channel=Synapses.default_channel)
+      queue_definition(name).queue(channel)
+    end
+
+    # @return [Hash]
+    attr_reader :exchanges
+    # @return [Hash]
+    attr_reader :queues
+  end
+end
+
+require 'synapses/contract/exchange'
+require 'synapses/contract/queue'

data/lib/synapses/contract/connectible.rb

@@ -0,0 +1,9 @@
+require 'synapses/contract'
+
+module Synapses
+  class Contract
+    # @author Alexander Semyonov <al@semyonov.us>
+    module Connectible
+    end
+  end
+end

data/lib/synapses/contract/definitions.rb

@@ -0,0 +1,34 @@
+require 'synapses/contract'
+require 'active_support/concern'
+
+module Synapses
+  class Contract
+    # @author Alexander Semyonov <al@semyonov.us>
+    module Definitions
+      extend ActiveSupport::Concern
+
+      included do
+        # @return [String]
+        class_attribute :exchange_name
+        self.exchange_name = ''
+
+        # @return [Synapses::Contract]
+        class_attribute :contract
+      end
+
+      module ClassMethods
+        # @param [String] name
+        # @param [Synapses::Contract] contract
+        def exchange(name, contract=Synapses.default_contract)
+          self.exchange_name = name
+          self.contract = contract
+        end
+      end
+
+      # @return [AMQP::Exchange]
+      def exchange
+        @exchange ||= contract.exchange(exchange_name)
+      end
+    end
+  end
+end

data/lib/synapses/contract/exchange.rb

@@ -0,0 +1,48 @@
+require 'synapses/contract'
+require 'synapses/contract/connectible'
+
+module Synapses
+  class Contract
+    # @author Alexander Semyonov <al@semyonov.us>
+    class Exchange
+      # @return [String]
+      attr_accessor :name
+      # @return ['direct', 'topic', 'fanout', 'headers']
+      attr_accessor :type
+      # @return [Hash]
+      attr_accessor :options
+
+      # @param [String] name
+      # @param [Hash] options see {AMQP::Exchange}
+      def initialize(name, options = {})
+        @name = name
+        @type = options.delete('type') { raise "Type for exchange #{name} is not set" }
+        @options = options || {}
+      end
+
+      # @return [AMQP::Channel]
+      attr_accessor :channel
+      def channel
+        @channel ||= Synapses.default_channel
+      end
+
+      # @param [AMQP::Channel] channel
+      # @return [AMQP::Exchange]
+      def connect(channel)
+        @exchange = AMQP::Exchange.new(channel, type, name, options)
+      end
+
+      # @return [Boolean]
+      def connected?
+        !!@queue
+      end
+
+      # @param [AMQP::Channel] channel
+      # @return [AMQP::Exchange]
+      def exchange(channel=self.channel)
+        connect(channel) unless connected?
+        @exchange
+      end
+    end
+  end
+end

data/lib/synapses/contract/queue.rb

@@ -0,0 +1,47 @@
+require 'synapses/contract'
+require 'synapses/contract/connectible'
+require 'amqp/queue'
+
+module Synapses
+  class Contract
+    # @author Alexander Semyonov <al@semyonov.us>
+    class Queue
+      # @return [String]
+      attr_accessor :name
+
+      # @return [Hash] see {AMQP::Queue#initialize}
+      attr_accessor :options
+
+      # @param [String] name
+      # @param [Hash] options see {AMQP::Queue#initialize}
+      def initialize(name, options = {})
+        @name = name
+        @bind = options.delete('bind') { raise "Exchange :bind is not specified for queue #{name}" }
+        @options = options || {}
+      end
+
+      # @return [AMQP::Channel]
+      attr_accessor :channel
+      def channel
+        @channel ||= Synapses.default_channel
+      end
+
+      # @return [AMQP::Queue]
+      def connect(channel=self.channel)
+        @queue = AMQP::Queue.new(channel, name, options)
+      end
+
+      # @return [Boolean]
+      def connected?
+        !!@queue
+      end
+
+      # @param [AMQP::Channel] channel
+      # @return [AMQP::Queue]
+      def queue(channel=self.channel)
+        connect(channel) unless connected?
+        @queue
+      end
+    end
+  end
+end

data/lib/synapses/contract/synapses.yml

@@ -0,0 +1,14 @@
+amq:
+  exchanges:
+    fanout:
+      type: fanout
+    direct:
+      type: direct
+    '':
+      type: direct
+    topic:
+      type: topic
+    match:
+      type: headers
+    headers:
+      type: headers

data/lib/synapses/engine.rb

@@ -0,0 +1,9 @@
+require 'synapses'
+require 'rails'
+
+module Synapses
+  # @author Alexander Semyonov <al@semyonov.us>
+  class Engine < ::Rails::Engine
+
+  end
+end

data/lib/synapses/manager.rb

@@ -0,0 +1,37 @@
+require 'synapses'
+require 'amqp/utilities/event_loop_helper'
+require 'amqp/integration/rails'
+
+module Synapses
+  # @author Alexander Semyonov <al@semyonov.us>
+  class Manager
+    def start
+      AMQP::Utilities::EventLoopHelper.run
+      AMQP::Integration::Rails.start do |connection|
+        Synapses.default_connection ||= connection
+
+        connection.on_error do |ch, connection_close|
+          raise connection_close.reply_text
+        end
+
+        connection.on_tcp_connection_loss do |conn, settings|
+          conn.reconnect(false, 2)
+        end
+
+        connection.on_tcp_connection_failure do |conn, settings|
+          conn.reconnect(false, 2)
+        end
+
+        AMQP.channel = channel(connection)
+      end
+    end
+
+    def channel(connection = Synapses.default_connection)
+      channel = AMQP::Channel.new(connection, AMQP::Channel.next_channel_id, auto_recovery: true)
+      channel.on_error do |ch, channel_close|
+        raise channel_close.reply_text
+      end
+      channel
+    end
+  end
+end

data/lib/synapses/messages.rb

@@ -0,0 +1,30 @@
+require 'synapses'
+require 'json'
+
+module Synapses
+  # @author Alexander Semyonov <al@semyonov.us>
+  module Messages
+    extend ActiveSupport::Concern
+
+    def self.registry
+      @registry ||= {}
+    end
+
+    # @param [AMQP::Header] metadata
+    # @param [String] payload
+    def self.parse(metadata, payload)
+      if (message_type = registry[metadata.type])
+        message_type.parse(metadata, payload)
+      else
+        Message.new
+      end
+    end
+
+    included do
+      const_set(:Message, Synapses::Messages::Message)
+    end
+  end
+end
+
+require 'synapses/messages/message'
+require 'synapses/messages/coders'

data/lib/synapses/messages/coders.rb

@@ -0,0 +1,34 @@
+require 'synapses/messages/coders'
+require 'multi_json'
+
+module Synapses
+  module Messages
+    # @author Alexander Semyonov <al@semyonov.us>
+    module Coders
+      module_function
+
+      class << self
+        attr_accessor :coders
+      end
+      self.coders = {}
+
+      if defined?(::MultiJson)
+        coders['application/json'] = MultiJson
+      end
+
+      # @param [String] payload
+      # @param [String] content_type
+      # @return [Hash] +payload+ decoded from +content_type+
+      def decode(payload, content_type)
+        coders[content_type.to_s].decode(payload)
+      end
+
+      # @param [Hash] payload
+      # @param [String] content_type
+      # @return [String] +payload+ encoded as +content_type+
+      def encode(payload, content_type)
+        coders[content_type.to_s].encode(payload)
+      end
+    end
+  end
+end

data/lib/synapses/messages/message.rb

@@ -0,0 +1,99 @@
+require 'synapses/messages'
+require 'synapses/messages/coders'
+
+module Synapses
+  module Messages
+    # @author Alexander Semyonov <al@semyonov.us>
+    class Message
+      # @return [String] (nil)
+      class_attribute :routing_key
+
+      class << self
+        attr_reader :message_type
+      end
+
+      def self.message_type=(type)
+        Messages.registry[type] = self
+        @message_type = type
+      end
+
+      # @return [Boolean] (false)
+      class_attribute :mandatory
+      self.mandatory = false
+
+      # @return [Boolean] (false)
+      class_attribute :immediate
+      self.immediate = false
+
+      # @return [Boolean] (false)
+      class_attribute :persistent
+      self.persistent = false
+
+      # @return [String]
+      class_attribute :content_type
+      #self.content_type = 'application/octet-stream'
+      self.content_type = 'application/json'
+
+      class_attribute :attributes
+      self.attributes = {}
+
+      def self.inherited(child)
+        super
+        child.attributes = attributes.dup
+      end
+
+      def self.attribute(attr, options = {})
+        self.attributes[attr.to_s] = options # TODO add types
+        attr_accessor attr
+      end
+
+      def self.parse(metadata, payload)
+        new(Synapses::Messages::Coders.decode(payload, metadata.content_type).merge(metadata: metadata))
+      end
+
+      def initialize(attributes = {}, metadata = {})
+        @attributes = {}
+        attributes.each do |name, value|
+          if respond_to?((writer = "#{name}="))
+            send(writer, value)
+          else
+            @attributes[name] = value
+          end
+        end
+        metadata.assert_valid_keys(:routing_key, :type)
+      end
+
+      attr_accessor :metadata
+
+      def attributes
+        self.class.attributes.inject({}) do |attributes, (name, type)|
+          attributes[name] = public_send(name)
+          attributes
+        end.merge(@attributes)
+      end
+
+      def to_payload
+        Synapses::Messages::Coders.encode(attributes, content_type)
+      end
+
+      def message_type
+        @message_type || self.class.message_type
+      end
+      attr_writer :message_type
+
+      alias type message_type
+      alias type= message_type=
+
+      def options
+        {
+          routing_key: routing_key,
+          type: message_type,
+          mandatory: mandatory,
+          immediate: immediate,
+          persistent: persistent,
+          content_type: content_type
+        }
+      end
+    end
+  end
+end

data/lib/synapses/producer.rb

@@ -0,0 +1,28 @@
+# coding: utf-8
+
+################################################
+# © Alexander Semyonov, 2013—2013              #
+# Author: Alexander Semyonov <al@semyonov.us>  #
+################################################
+
+require 'synapses'
+require 'synapses/contract/definitions'
+
+module Synapses
+  # @author Alexander Semyonov <al@semyonov.us>
+  class Producer
+    include Contract::Definitions
+
+    def initialize(channel = nil)
+      @channel = channel
+    end
+
+    def <<(message)
+      EventMachine.next_tick do
+        exchange.publish(message.to_payload, message.options) do
+          puts "published [#{message.to_payload}, #{message.options}]"
+        end
+      end
+    end
+  end
+end

data/lib/synapses/version.rb

@@ -0,0 +1,10 @@
+# coding: utf-8
+
+################################################
+# © Alexander Semyonov, 2013—2013              #
+# Author: Alexander Semyonov <al@semyonov.us>  #
+################################################
+
+module Synapses
+  VERSION = '0.0.1'
+end

data/spec/examples/contract.yml

@@ -0,0 +1,10 @@
+exchanges:
+  direct:
+    type: direct
+  fanout:
+    type: fanout
+  weather:
+    type: topic
+  headers:
+    type: header
+queues:

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

data/synapses.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'synapses/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'synapses'
+  spec.version       = Synapses::VERSION
+  spec.authors       = ['Alexander Semyonov']
+  spec.email         = %w(al@semyonov.us)
+  spec.description   = %q{MQ-based application communication and event processing}
+  spec.summary       = %q{Synapses connecting your applications}
+  spec.homepage      = 'https://github.com/alsemyonov/synapses'
+  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 = %w(lib)
+
+  spec.add_runtime_dependency 'eventmachine'
+  spec.add_runtime_dependency 'amqp'
+  spec.add_runtime_dependency 'activesupport'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'yard'
+  spec.add_development_dependency 'evented-spec'
+end

metadata

@@ -0,0 +1,190 @@
+--- !ruby/object:Gem::Specification
+name: synapses
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Alexander Semyonov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-19 00:00:00.000000000 Z
+dependencies:
+- !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: amqp
+  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'
+- !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: rspec
+  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: yard
+  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: evented-spec
+  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'
+description: MQ-based application communication and event processing
+email:
+- al@semyonov.us
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- config/amqp.yml
+- config/giteaucrat.yml
+- examples/config/amqp.yml
+- examples/config/synapses/radar.yml
+- examples/config/synapses/rocket_center.yml
+- examples/game.rb
+- lib/amqp/integration/rails.rb
+- lib/synapses.rb
+- lib/synapses/consumer.rb
+- lib/synapses/contract.rb
+- lib/synapses/contract/connectible.rb
+- lib/synapses/contract/definitions.rb
+- lib/synapses/contract/exchange.rb
+- lib/synapses/contract/queue.rb
+- lib/synapses/contract/synapses.yml
+- lib/synapses/engine.rb
+- lib/synapses/manager.rb
+- lib/synapses/messages.rb
+- lib/synapses/messages/coders.rb
+- lib/synapses/messages/message.rb
+- lib/synapses/producer.rb
+- lib/synapses/version.rb
+- spec/examples/contract.yml
+- spec/spec_helper.rb
+- synapses.gemspec
+homepage: https://github.com/alsemyonov/synapses
+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.0.7
+signing_key: 
+specification_version: 4
+summary: Synapses connecting your applications
+test_files:
+- spec/examples/contract.yml
+- spec/spec_helper.rb
+has_rdoc: