marples 0.0.16

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/README.md

@@ -0,0 +1,47 @@
+# Marples
+
+A message destination arbiter.
+
+    "Alfred Ernest Marples, Baron Marples PC (9 December 1907 – 6 July 1978) was
+    a British Conservative politician who served as Postmaster General and
+    Minister of Transport. Following his retirement from active politics in
+    1974, Marples was elevated to the peerage."
+      -- http://en.wikipedia.org/wiki/Ernest_Marples
+
+As Postmaster, Ernest Marples introduced postcodes to the UK, making message
+routing easier.
+
+Marples, this gem, removes any uncertainty about which destination our messages
+go to by enforcing a naming scheme.
+
+
+## Usage
+
+### Sending a message
+
+    stomp_client = Stomp::Client.new ...
+    m = Marples::Client.new stomp_client, "publisher"
+    m.updated publication
+    # => /topic/publisher.publications.updated
+	{ 'guide' => { 'id' => 12345, 'title' => '...', ... }}
+
+### Listening for messages
+
+    stomp_client = Stomp::Client.new ...
+    m = Marples::Client.new stomp_client
+    m.when 'publisher', 'publication', 'updated' do |publication|
+      puts publication['slug']
+      # => "how-postcodes-work"
+    end
+    m.join # Join the listening thread
+
+
+## Logging
+
+You can inject your logger into Marples to get some debugging information.
+
+    logger = Logger.new STDOUT
+    logger.level = Logger::DEBUG
+    producer = Marples::Client.new stomp_client, "publisher", logger
+    ...
+    consumer = Marples::Client.new stomp_client, 'consumer_name_here', logger

data/Rakefile

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

data/lib/marples/client.rb

@@ -0,0 +1,54 @@
+module Marples
+  class Client
+    include Pethau::InitializeWith
+    include Pethau::DefaultValueOf
+
+    ACTIONS = [ :updated, :published ].freeze
+
+    initialize_with :transport, :client_name, :logger
+    default_value_of :client_name, File.basename($0)
+    default_value_of :transport, Marples::NullTransport.instance
+    default_value_of :logger, NullLogger.instance
+
+    def join
+      transport.join
+    end
+
+    def method_missing action, *args
+      return super unless ACTIONS.include? action
+      return super unless args.size == 1
+      publish action, args[0]
+    end
+
+    def when application, object_type, action
+      logger.debug "Listening for #{application} notifiying us of #{object_type} #{action}"
+      destination = destination_for application, object_type, action
+      logger.debug "Underlying destination is #{destination}"
+      transport.subscribe destination do |message|
+        logger.debug "Received message #{message.headers['message-id']} from #{destination}"
+        logger.debug "Message body: #{message.body}"
+        hash = Hash.from_xml message.body
+        logger.debug "Constructed hash: #{hash.inspect}"
+        attributes = hash.values[0]
+        logger.debug "Yielding hash: #{attributes.inspect}"
+        yield attributes
+        logger.debug "Finished processing message #{message.headers['message-id']}"
+      end
+    end
+
+    def publish action, object
+      object_type = object.class.name.tableize
+      destination = destination_for object_type, action
+      logger.debug "Sending XML to #{destination}"
+      logger.debug "XML: #{object.to_xml}"
+      transport.publish destination, object.to_xml
+      logger.debug "Message sent"
+    end
+    private :publish
+
+    def destination_for application_name = client_name, object_type, action
+      "/topic/#{application_name}.#{object_type}.#{action}"
+    end
+    private :destination_for
+  end
+end

data/lib/marples/null_transport.rb

@@ -0,0 +1,8 @@
+module Marples
+  class NullTransport
+    include Singleton
+    def publish *args; end
+    def subscribe *args; end
+    def join; end
+  end
+end

data/lib/marples/version.rb

@@ -0,0 +1,3 @@
+module Marples
+  VERSION = "0.0.16"
+end

data/lib/marples.rb

@@ -0,0 +1,10 @@
+require "pethau"
+require "null_logger"
+require "active_support/core_ext/hash/conversions"
+
+require "marples/version"
+require "marples/null_transport"
+require "marples/client"
+
+module Marples
+end

data/marples.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "marples/version"
+
+Gem::Specification.new do |s|
+  s.name        = "marples"
+  s.version     = Marples::VERSION
+  s.authors     = ["Craig R Webster", "Dafydd Vaughan"]
+  s.email       = ["craig@barkingiguana.com", "dai@daibach.co.uk"]
+  s.homepage    = ""
+  s.summary     = %q{Message destination arbiter}
+  s.description = %q{Message destination arbiter}
+  s.rubyforge_project = "marples"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "pethau", ">= 0.0.2"
+  s.add_runtime_dependency "null_logger"
+  s.add_runtime_dependency "activesupport"
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: marples
+version: !ruby/object:Gem::Version
+  version: 0.0.16
+  prerelease: 
+platform: ruby
+authors:
+- Craig R Webster
+- Dafydd Vaughan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-26 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pethau
+  requirement: &70334281116860 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70334281116860
+- !ruby/object:Gem::Dependency
+  name: null_logger
+  requirement: &70334281116440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70334281116440
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: &70334281115980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70334281115980
+description: Message destination arbiter
+email:
+- craig@barkingiguana.com
+- dai@daibach.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- lib/marples.rb
+- lib/marples/client.rb
+- lib/marples/null_transport.rb
+- lib/marples/version.rb
+- marples.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: marples
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Message destination arbiter
+test_files: []