serf 0.10.0 → 0.11.0

data/spec/serf/util/null_object_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+require 'securerandom'
+
+require 'serf/util/null_object'
+
+describe Serf::Util::NullObject do
+  let(:random_method_name) {
+    SecureRandom.hex.to_sym
+  }
+
+  it 'returns itself on any fuzzy method call' do
+    subject.send(random_method_name).should == subject
+  end
+
+  it 'returns itself on a missing method' do
+    subject.my_missing_method.should == subject
+  end
+
+  it 'returns itself on a missing method with params' do
+    subject.my_missing_method(1,2,3,4) {
+      nil
+    }.should == subject
+  end
+
+end

data/spec/serf/util/options_extraction_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+shared_examples '#opts with nonexistent option' do
+  context 'with missing option' do
+
+    it 'returns default data' do
+      subject.opts(:nonexistent_option, 'DEFAULT').should == 'DEFAULT'
+    end
+
+    it 'returns nil data on no default' do
+      subject.opts(:nonexistent_option).should be_nil
+    end
+
+    it 'returns block data' do
+      calculator = double('calculator')
+      calculator.should_receive(:calculate).and_return('DEFAULT')
+      subject.opts(:nonexistent_option) {
+        calculator.calculate
+      }.should == 'DEFAULT'
+    end
+
+  end
+
+end
+
+describe Serf::Util::OptionsExtraction do
+  let(:given_options) {
+    FactoryGirl.create :random_options
+  }
+  subject { OptionsExtractionWrapper.new given_options }
+
+  describe '#opts!' do
+
+    it 'returns given data' do
+      subject.opts!(:option_a).should == given_options.option_a
+    end
+
+    it 'fails for missing option' do
+      expect {
+        subject.opts! :nonexistent_option
+      }.to raise_error
+    end
+
+  end
+
+  describe '#opts' do
+
+    it 'returns given data' do
+      subject.opts(:option_a).should == given_options.option_a
+    end
+
+  end
+
+  it_behaves_like '#opts with nonexistent option'
+
+  context 'with no options given' do
+    subject { OptionsExtractionWrapper.new }
+
+    it_behaves_like '#opts with nonexistent option'
+  end
+
+end

data/spec/serf/util/protected_call_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+describe Serf::Util::ProtectedCall do
+  subject { ProtectedCallWrapper.new }
+
+  context 'has a raised error' do
+
+    it 'returns an error message' do
+      result, error = subject.pcall do
+        raise 'Some Error Message'
+      end
+      result.should be_nil
+      error.should be_a_kind_of(RuntimeError)
+    end
+
+  end
+
+  context 'has a succeeding app' do
+    let(:response_parcel) {
+      FactoryGirl.create :random_parcel
+    }
+
+    it 'returns a good response parcel' do
+      result, error = subject.pcall do
+        response_parcel
+      end
+      result.should == response_parcel
+      error.should be_nil
+    end
+
+  end
+
+end

data/spec/serf/util/uuidable_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+require 'serf/util/uuidable'
+
+##
+# NOTE: Not really great tests here... I really should mock out
+#   the uuid_tool to really get at the meat of the work.
+#
+describe Serf::Util::Uuidable do
+
+  its(:create_coded_uuid) {
+    should_not be_nil
+    subject.size.should == 22
+  }
+
+  describe '#parse_coded_uuid' do
+
+    it 'works' do
+      subject.parse_coded_uuid subject.create_coded_uuid
+    end
+
+  end
+
+  describe '#create_uuids' do
+
+    it 'works with no parent' do
+      uuids = subject.create_uuids
+      uuids[:uuid].should_not be_nil
+      uuids[:parent_uuid].should be_nil
+      uuids[:origin_uuid].should be_nil
+    end
+
+    it 'copies origin from parent' do
+      uuids = subject.create_uuids origin_uuid: 'MY_UUID'
+      uuids[:uuid].should_not be_nil
+      uuids[:parent_uuid].should be_nil
+      uuids[:origin_uuid].should == 'MY_UUID'
+    end
+
+    it 'sets origin from parent[:parent_uuid] if origin is nonexistent ' do
+      uuids = subject.create_uuids parent_uuid: 'MY_UUID'
+      uuids[:uuid].should_not be_nil
+      uuids[:parent_uuid].should be_nil
+      uuids[:origin_uuid].should == 'MY_UUID'
+    end
+
+    it 'sets origin, parent from parent[:uuid] on missing origin and parent' do
+      uuids = subject.create_uuids uuid: 'MY_UUID'
+      uuids[:uuid].should_not be_nil
+      uuids[:parent_uuid].should == 'MY_UUID'
+      uuids[:origin_uuid].should == 'MY_UUID'
+    end
+
+  end
+
+end

data/spec/serf_spec.rb

@@ -1,7 +1,4 @@
-require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'spec_helper'
 
 describe "Serf" do
-  it "fails" do
-    fail "hey buddy, you should probably rename this file and start specing for real"
-  end
 end

data/spec/spec_helper.rb

@@ -1,3 +1,6 @@
+#require 'simplecov'
+#SimpleCov.start
+
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 require 'rspec'

data/spec/support/error_handling_wrapper.rb

@@ -0,0 +1,5 @@
+require 'serf/util/error_handling'
+
+class ErrorHandlingWrapper
+  include Serf::Util::ErrorHandling
+end

data/spec/support/factories.rb

@@ -0,0 +1,32 @@
+require 'factory_girl'
+require 'hashie'
+require 'securerandom'
+
+FactoryGirl.define do
+  sequence(:random_string) { SecureRandom.hex }
+
+  factory :random_parcel, class: Hashie::Mash do
+    headers {{
+      uuid: generate(:random_string),
+      kind: generate(:random_string)
+    }}
+    message {{
+      some_data: generate(:random_string)
+    }}
+  end
+
+  factory :random_headers, class: Hashie::Mash do
+    uuid { generate(:random_string) }
+    kind { generate(:random_string) }
+  end
+
+  factory :random_message, class: Hashie::Mash do
+    data { generate(:random_string) }
+  end
+
+  factory :random_options, class: Hashie::Mash do
+    option_a { generate(:random_string) }
+    option_b { generate(:random_string) }
+    option_c { generate(:random_string) }
+  end
+end

data/spec/support/failing_policy.rb

@@ -0,0 +1,9 @@
+require 'serf/errors/policy_failure'
+
+class FailingPolicy
+
+  def check!(parcel)
+    raise Serf::Errors::PolicyFailure, 'Failed Policy'
+  end
+
+end

data/spec/support/json_schema_tester.rb

@@ -0,0 +1,14 @@
+require 'json-schema'
+
+class JsonSchemaTester
+  SCHEMA_ROOT = File.join(File.dirname(__FILE__), '..', '..', 'schemas')
+
+  def path_for(kind)
+    "#{SCHEMA_ROOT}/#{kind}.json"
+  end
+
+  def validate_for!(kind, data)
+    JSON::Validator.validate! path_for(kind), data
+  end
+
+end

data/spec/support/options_extraction_wrapper.rb

@@ -0,0 +1,10 @@
+require 'serf/util/options_extraction'
+
+class OptionsExtractionWrapper
+  include Serf::Util::OptionsExtraction
+
+  def initialize(*args)
+    extract_options! args
+  end
+
+end

data/spec/support/passing_policy.rb

@@ -0,0 +1,7 @@
+class PassingPolicy
+
+  def check!(parcel)
+    nil
+  end
+
+end

data/spec/support/protected_call_wrapper.rb

@@ -0,0 +1,5 @@
+require 'serf/util/protected_call'
+
+class ProtectedCallWrapper
+  include Serf::Util::ProtectedCall
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: serf
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,33 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-30 00:00:00.000000000 Z
+date: 2012-11-05 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: &70327288822860 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 3.2.0
-  type: :runtime
-  prerelease: false
-  version_requirements: *70327288822860
-- !ruby/object:Gem::Dependency
-  name: i18n
-  requirement: &70327288821320 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.6.0
-  type: :runtime
-  prerelease: false
-  version_requirements: *70327288821320
 - !ruby/object:Gem::Dependency
   name: hashie
-  requirement: &70327288843640 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,145 +21,70 @@ dependencies:
         version: 1.2.0
   type: :runtime
   prerelease: false
-  version_requirements: *70327288843640
-- !ruby/object:Gem::Dependency
-  name: uuidtools
-  requirement: &70327288842560 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 2.1.2
-  type: :runtime
-  prerelease: false
-  version_requirements: *70327288842560
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &70327288841020 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 2.8.0
-  type: :development
-  prerelease: false
-  version_requirements: *70327288841020
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: &70327288839480 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 0.7.5
-  type: :development
-  prerelease: false
-  version_requirements: *70327288839480
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: &70327288837820 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.1.3
-  type: :development
-  prerelease: false
-  version_requirements: *70327288837820
-- !ruby/object:Gem::Dependency
-  name: jeweler
-  requirement: &70327288847420 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.8.3
-  type: :development
-  prerelease: false
-  version_requirements: *70327288847420
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: &70327288845020 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: *70327288845020
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
-  name: log4r
-  requirement: &70327288859780 !ruby/object:Gem::Requirement
+  name: ice_nine
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.1.10
-  type: :development
+        version: 0.4.0
+  type: :runtime
   prerelease: false
-  version_requirements: *70327288859780
-- !ruby/object:Gem::Dependency
-  name: msgpack
-  requirement: &70327288858080 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.4.6
-  type: :development
-  prerelease: false
-  version_requirements: *70327288858080
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
-  name: eventmachine
-  requirement: &70327288857320 !ruby/object:Gem::Requirement
+  name: uuidtools
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.12.10
-  type: :development
+        version: 2.1.3
+  type: :runtime
   prerelease: false
-  version_requirements: *70327288857320
-- !ruby/object:Gem::Dependency
-  name: girl_friday
-  requirement: &70327288856640 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.9.7
-  type: :development
-  prerelease: false
-  version_requirements: *70327288856640
-description: Event-Driven SOA with CQRS
+        version: 2.1.3
+description: Interactors with policy protection
 email: benjaminlyu@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE.txt
+- NOTICE.txt
 - README.md
 files:
-- .document
-- .rspec
+- .gitignore
+- .travis.yml
 - Gemfile
-- Gemfile.lock
+- Guardfile
 - LICENSE.txt
 - NOTICE.txt
 - README.md
 - Rakefile
-- docs/thread_pools.txt
 - lib/serf.rb
 - lib/serf/builder.rb
-- lib/serf/command.rb
-- lib/serf/error.rb
-- lib/serf/errors/not_found.rb
-- lib/serf/middleware/girl_friday_async.rb
-- lib/serf/middleware/masherize.rb
+- lib/serf/errors/policy_failure.rb
+- lib/serf/middleware/error_handler.rb
+- lib/serf/middleware/parcel_freezer.rb
+- lib/serf/middleware/parcel_masher.rb
+- lib/serf/middleware/policy_checker.rb
 - lib/serf/middleware/uuid_tagger.rb
-- lib/serf/routing/regexp_matcher.rb
-- lib/serf/routing/route.rb
-- lib/serf/routing/route_set.rb
+- lib/serf/parcel_builder.rb
 - lib/serf/serfer.rb
 - lib/serf/util/error_handling.rb
 - lib/serf/util/null_object.rb
@@ -189,11 +92,31 @@ files:
 - lib/serf/util/protected_call.rb
 - lib/serf/util/uuidable.rb
 - lib/serf/version.rb
-- schemas/caught_exception_event.json
-- schemas/message_accepted_event.json
+- schemas/serf/events/caught_error.json
 - serf.gemspec
+- spec/serf/builder_spec.rb
+- spec/serf/errors/policy_failure_spec.rb
+- spec/serf/middleware/error_handler_spec.rb
+- spec/serf/middleware/parcel_freezer_spec.rb
+- spec/serf/middleware/parcel_masher_spec.rb
+- spec/serf/middleware/policy_checker_spec.rb
+- spec/serf/middleware/uuid_tagger_spec.rb
+- spec/serf/parcel_builder_spec.rb
+- spec/serf/serfer_spec.rb
+- spec/serf/util/error_handling_spec.rb
+- spec/serf/util/null_object_spec.rb
+- spec/serf/util/options_extraction_spec.rb
+- spec/serf/util/protected_call_spec.rb
+- spec/serf/util/uuidable_spec.rb
 - spec/serf_spec.rb
 - spec/spec_helper.rb
+- spec/support/error_handling_wrapper.rb
+- spec/support/factories.rb
+- spec/support/failing_policy.rb
+- spec/support/json_schema_tester.rb
+- spec/support/options_extraction_wrapper.rb
+- spec/support/passing_policy.rb
+- spec/support/protected_call_wrapper.rb
 homepage: http://github.com/byu/serf
 licenses:
 - Apache 2.0
@@ -209,17 +132,44 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2408210682612837552
+      hash: 3096022116459469640
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 3096022116459469640
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.17
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: Event-Driven SOA with CQRS
-test_files: []
+summary: Interactors with policy protection
+test_files:
+- spec/serf/builder_spec.rb
+- spec/serf/errors/policy_failure_spec.rb
+- spec/serf/middleware/error_handler_spec.rb
+- spec/serf/middleware/parcel_freezer_spec.rb
+- spec/serf/middleware/parcel_masher_spec.rb
+- spec/serf/middleware/policy_checker_spec.rb
+- spec/serf/middleware/uuid_tagger_spec.rb
+- spec/serf/parcel_builder_spec.rb
+- spec/serf/serfer_spec.rb
+- spec/serf/util/error_handling_spec.rb
+- spec/serf/util/null_object_spec.rb
+- spec/serf/util/options_extraction_spec.rb
+- spec/serf/util/protected_call_spec.rb
+- spec/serf/util/uuidable_spec.rb
+- spec/serf_spec.rb
+- spec/spec_helper.rb
+- spec/support/error_handling_wrapper.rb
+- spec/support/factories.rb
+- spec/support/failing_policy.rb
+- spec/support/json_schema_tester.rb
+- spec/support/options_extraction_wrapper.rb
+- spec/support/passing_policy.rb
+- spec/support/protected_call_wrapper.rb
+has_rdoc: 

data/.document

@@ -1,5 +0,0 @@
-lib/**/*.rb
-bin/*
-- 
-features/**/*.feature
-LICENSE.txt

data/.rspec

@@ -1 +0,0 @@
---color

data/Gemfile.lock

@@ -1,58 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    activesupport (3.2.2)
-      i18n (~> 0.6)
-      multi_json (~> 1.0)
-    connection_pool (0.1.0)
-    diff-lcs (1.1.3)
-    eventmachine (0.12.10)
-    girl_friday (0.9.7)
-      connection_pool (~> 0.1.0)
-    git (1.2.5)
-    hashie (1.2.0)
-    i18n (0.6.0)
-    jeweler (1.8.3)
-      bundler (~> 1.0)
-      git (>= 1.2.5)
-      rake
-      rdoc
-    json (1.6.5)
-    log4r (1.1.10)
-    msgpack (0.4.6)
-    multi_json (1.1.0)
-    rake (0.9.2.2)
-    rdoc (3.12)
-      json (~> 1.4)
-    rspec (2.8.0)
-      rspec-core (~> 2.8.0)
-      rspec-expectations (~> 2.8.0)
-      rspec-mocks (~> 2.8.0)
-    rspec-core (2.8.0)
-    rspec-expectations (2.8.0)
-      diff-lcs (~> 1.1.2)
-    rspec-mocks (2.8.0)
-    simplecov (0.6.1)
-      multi_json (~> 1.0)
-      simplecov-html (~> 0.5.3)
-    simplecov-html (0.5.3)
-    uuidtools (2.1.2)
-    yard (0.7.5)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activesupport (>= 3.2.0)
-  bundler (~> 1.1.3)
-  eventmachine (>= 0.12.10)
-  girl_friday (>= 0.9.7)
-  hashie (>= 1.2.0)
-  i18n (>= 0.6.0)
-  jeweler (~> 1.8.3)
-  log4r (>= 1.1.10)
-  msgpack (>= 0.4.6)
-  rspec (~> 2.8.0)
-  simplecov
-  uuidtools (>= 2.1.2)
-  yard (~> 0.7.5)

data/docs/thread_pools.txt

@@ -1,16 +0,0 @@
-Serf drives the incoming requests using runners. Each runner
-is implemented to either perform tasks synchronously or asynchronously.
-For asynchronous background processing, we rely on third party
-libraries. The following is a list of current and (hopefully) future
-libraries we hope to support.
-
-Implemented Runners:
-  * EventMachine http://rubyeventmachine.com/
-  * GirlFriday https://github.com/mperham/girl_friday
-
-TBD ThreadPool Libraries:
-  * ThreadPool https://github.com/danielbush/ThreadPool
-  * Threadz https://github.com/nanodeath/threadz
-  * Celluloid https://github.com/tarcieri/celluloid
-  * Resque https://github.com/defunkt/resque
-  * DelayedJob https://github.com/tobi/delayed_job