acfs 0.16.0 → 0.17.0

data/lib/acfs/service/middleware.rb

@@ -8,18 +8,28 @@ module Acfs
     module Middleware
       extend ActiveSupport::Concern
 
-      def prepare(request) # :nodoc:
+      # @api private
+      # @return [Request]
+      #
+      def prepare(request)
         self.class.middleware.call request
       end
 
       module ClassMethods
 
+        # @api public
+        #
         # Register a new middleware to be used for this service.
         #
-        # class MyService < Acfs::Service
-        #   self.base_url = 'http://my.srv'
-        #   use Acfs::Middleware::JsonDecoder
-        # end
+        # @example
+        #   class MyService < Acfs::Service
+        #     self.base_url = 'http://my.srv'
+        #     use Acfs::Middleware::JsonDecoder
+        #   end
+        #
+        # @param [Class] klass Middleware class to instantiate and append to middleware stack.
+        # @param [Hash, Object] options Options to delegate to middleware class initializer.
+        # @return [undefined]
         #
         def use(klass, options = {})
           @middlewares ||= []
@@ -30,14 +40,22 @@ module Acfs
           @middleware = klass.new(middleware, options)
         end
 
+        # @api private
+        #
         # Return top most middleware.
         #
+        # @return [#call]
+        #
         def middleware
           @middleware ||= proc { |request| request}
         end
 
+        # @api public
+        #
         # Clear all registered middlewares.
         #
+        # @return [undefined]
+        #
         def clear
           @middleware  = nil
           @middlewares = []

data/lib/acfs/version.rb

@@ -1,7 +1,7 @@
 module Acfs
   module VERSION
     MAJOR = 0
-    MINOR = 16
+    MINOR = 17
     PATCH = 0
     STAGE = nil
 

data/lib/acfs/yard.rb

@@ -0,0 +1,5 @@
+# YARD macros
+
+# @!macro [new] experimental
+#   @api experimental
+#   @note This class or method is *experimental*. It may change without further notice or major version bump.

data/spec/acfs/configuration_spec.rb

@@ -7,7 +7,6 @@ describe Acfs::Configuration do
   after { Acfs::Configuration.set @configuration }
 
   describe 'Acfs.configure' do
-
     it 'should invoke configure on current configuration' do
       Acfs::Configuration.current.should_receive(:configure).once.and_call_original
 

data/spec/acfs/messaging/receiver_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+module My
+  class CustomReceiver
+    include Acfs::Messaging::Receiver
+  end
+end
+
+describe Acfs::Messaging::Receiver do
+  let(:rcv_class) { My::CustomReceiver }
+  after { rcv_class.queue nil }
+
+  describe '.queue' do
+    it 'should return queue name based on class name' do
+      expect(rcv_class.queue).to be == 'my.custom_receiver'
+    end
+
+    it 'should set and return custom queue name' do
+      rcv_class.queue 'special.queue.name'
+
+      expect(rcv_class.queue).to be == 'special.queue.name'
+    end
+  end
+
+  describe '.receive' do
+    context 'with routed message' do
+      context 'with exact routing key match' do
+        it 'should receive messages' do
+          rcv_class.instance.should_receive(:receive).with(anything, anything, { message: 'Hello!'})
+
+          Acfs::Messaging::Client.instance.publish('my.custom_receiver', { message: 'Hello!' })
+          sleep 1 # Nothing better?
+        end
+      end
+
+      context 'with partial routing key match' do
+        it 'should receive messages' do
+          rcv_class.instance.should_receive(:receive).with(anything, anything, { message: 'Hello!'})
+
+          Acfs::Messaging::Client.instance.publish('my.different', { message: 'Hello!' })
+          sleep 1 # Nothing better?
+        end
+      end
+    end
+
+    context 'with not routed message' do
+      it 'should not receive messages' do
+        rcv_class.instance.should_not_receive(:receive)
+
+        Acfs::Messaging::Client.instance.publish('abc.cde', { message: 'Hello!' })
+        sleep 1 # Nothing better?
+      end
+    end
+  end
+end

data/spec/acfs/model/attributes_spec.rb

@@ -119,25 +119,25 @@ describe Acfs::Model::Attributes do
     it 'should add an attribute to model attribute list' do
       model.send :attribute, :name, :string
 
-      expect(model.attributes).to be == { :name => nil }
+      expect(model.attributes).to be == { :name => nil }.stringify_keys
     end
 
     it 'should accept a default value' do
       model.send :attribute, :name, :string, default: 'John'
 
-      expect(model.attributes).to be == { :name => 'John' }
+      expect(model.attributes).to be == { :name => 'John' }.stringify_keys
     end
 
     it 'should accept an symbolic type' do
       model.send :attribute, :age, :integer, default: '12'
 
-      expect(model.attributes).to be == { :age => 12 }
+      expect(model.attributes).to be == { :age => 12 }.stringify_keys
     end
 
     it 'should accept an class type' do
       model.send :attribute, :age, Acfs::Model::Attributes::Integer, default: '12'
 
-      expect(model.attributes).to be == { :age => 12 }
+      expect(model.attributes).to be == { :age => 12 }.stringify_keys
     end
   end
 end

data/spec/acfs/stub_spec.rb

@@ -87,7 +87,7 @@ describe Acfs::Stub do
         Acfs::Stub.allow_requests = false
       end
 
-      it 'should allow real requests' do
+      it 'should not allow real requests' do
         @user = MyUser.find 2
         expect { Acfs.run }.to raise_error(Acfs::RealRequestsNotAllowedError)
       end

data/spec/acfs_messaging_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe 'Acfs messaging' do
+
+end

data/spec/spec_helper.rb

@@ -1,9 +1,9 @@
-require 'acfs'
 require 'coveralls'
 Coveralls.wear! do
   add_filter 'spec'
 end
 
+require 'acfs'
 require 'webmock/rspec'
 
 Dir[File.expand_path('spec/support/**/*.rb')].each {|f| require f}

data/spec/support/service.rb

@@ -1,7 +1,7 @@
 
 Acfs.configure do
   locate :user_service, 'http://users.example.org'
-  locate :comment_service, 'http://comments.example.org'
+  locate :comments, 'http://comments.example.org'
 end
 
 class UserService < Acfs::Service
@@ -11,6 +11,8 @@ class UserService < Acfs::Service
 end
 
 class CommentService < Acfs::Service
+  identity :comments
+
   use Acfs::Middleware::JsonDecoder
 end
 
@@ -38,3 +40,12 @@ class Comment
   attribute :id, :integer
   attribute :text, :string
 end
+
+class UserMessageReceiver
+  include Acfs::Messaging::Receiver
+  route 'my.#'
+
+  def receive(delivery_info, metadata, payload)
+    puts "UserMessageReceiver received : #{payload.inspect}"
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: acfs
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.0
 platform: ruby
 authors:
 - Jan Graichen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-11 00:00:00.000000000 Z
+date: 2013-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -16,42 +16,42 @@ dependencies:
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +80,20 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: bunny
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0.pre12
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0.pre12
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
@@ -125,6 +139,8 @@ files:
 - README.md
 - Rakefile
 - acfs.gemspec
+- gemfiles/Gemfile.rails-3-0
+- gemfiles/Gemfile.rails-3-1
 - gemfiles/Gemfile.rails-3-2
 - gemfiles/Gemfile.rails-4-0
 - lib/acfs.rb
@@ -134,6 +150,9 @@ files:
 - lib/acfs/configuration.rb
 - lib/acfs/errors.rb
 - lib/acfs/global.rb
+- lib/acfs/messaging/client.rb
+- lib/acfs/messaging/message.rb
+- lib/acfs/messaging/receiver.rb
 - lib/acfs/middleware/base.rb
 - lib/acfs/middleware/json_decoder.rb
 - lib/acfs/middleware/json_encoder.rb
@@ -166,7 +185,10 @@ files:
 - lib/acfs/service/middleware.rb
 - lib/acfs/stub.rb
 - lib/acfs/version.rb
+- lib/acfs/yard.rb
+- rubydoc.png
 - spec/acfs/configuration_spec.rb
+- spec/acfs/messaging/receiver_spec.rb
 - spec/acfs/middleware/json_decoder_spec.rb
 - spec/acfs/middleware/msgpack_decoder_spec.rb
 - spec/acfs/model/attributes_spec.rb
@@ -183,12 +205,13 @@ files:
 - spec/acfs/service/middleware_spec.rb
 - spec/acfs/service_spec.rb
 - spec/acfs/stub_spec.rb
+- spec/acfs_messaging_spec.rb
 - spec/acfs_spec.rb
 - spec/fixtures/config.yml
 - spec/spec_helper.rb
 - spec/support/response.rb
 - spec/support/service.rb
-homepage: ''
+homepage: https://github.com/jgraichen/acfs
 licenses:
 - MIT
 metadata: {}
@@ -214,6 +237,7 @@ specification_version: 4
 summary: An abstract API base client for service oriented application.
 test_files:
 - spec/acfs/configuration_spec.rb
+- spec/acfs/messaging/receiver_spec.rb
 - spec/acfs/middleware/json_decoder_spec.rb
 - spec/acfs/middleware/msgpack_decoder_spec.rb
 - spec/acfs/model/attributes_spec.rb
@@ -230,8 +254,10 @@ test_files:
 - spec/acfs/service/middleware_spec.rb
 - spec/acfs/service_spec.rb
 - spec/acfs/stub_spec.rb
+- spec/acfs_messaging_spec.rb
 - spec/acfs_spec.rb
 - spec/fixtures/config.yml
 - spec/spec_helper.rb
 - spec/support/response.rb
 - spec/support/service.rb
+has_rdoc: