service_objects 0.0.1

data/spec/tests/helpers/validations_spec.rb

@@ -0,0 +1,60 @@
+# encoding: utf-8
+
+describe ServiceObjects::Helpers::Validations do
+
+  let(:invalid)         { ServiceObjects::Invalid           }
+  let(:message_class)   { ServiceObjects::Message           }
+  let(:messages_module) { ServiceObjects::Helpers::Messages }
+  let(:test_class)      { Class.new                         }
+  let(:validations)     { ActiveModel::Validations }
+
+  before { ServiceObjects::Test = test_class        }
+  before { test_class.include described_class       }
+  after  { ServiceObjects.send :remove_const, :Test }
+
+  it "includes ActiveModel::Validations" do
+    expect(test_class).to include validations
+  end
+
+  it "includes ServiceObjects::Helpers::Messages" do
+    expect(test_class).to include messages_module
+  end
+
+  describe "#validate!" do
+
+    subject { test_class.new }
+
+    context "when the service is valid" do
+
+      it "passes" do
+        expect { subject.validate! }.not_to raise_error
+      end
+
+    end
+
+    context "when the service is invalid" do
+
+      before { subject.errors.add :base, :invalid }
+      before { allow(subject).to receive(:valid?) { false } }
+
+      it "fails" do
+        expect { subject.validate! }.to raise_error invalid
+      end
+
+      it "populates #messages from errors" do
+        begin
+          subject.validate!
+        rescue => err
+          message = subject.messages.first
+        end
+
+        expect(message).to be_kind_of message_class
+        expect(message.type).to eq "error"
+        expect(err.messages).to contain_exactly message
+      end
+
+    end
+
+  end # #validate!
+
+end # ServiceObjects::Helpers::Validations

data/spec/tests/invalid_spec.rb

@@ -0,0 +1,69 @@
+# encoding: utf-8
+
+describe ServiceObjects::Invalid do
+
+  let(:messages) { double :messages }
+  let(:object)   { double :object, messages: messages }
+
+  subject { described_class.new object }
+
+  describe ".new" do
+
+    context "without arguments" do
+
+      subject { described_class.new }
+
+      it "fails with ArgumentError" do
+        expect { subject }.to raise_error ArgumentError
+      end
+    end
+
+    context "with an object that doesn't responds to :messages" do
+
+      let(:object) { double }
+      subject { described_class.new object }
+
+      it "fails with TypeError" do
+        expect { subject }.to raise_error TypeError
+      end
+
+      it "returns a proper message" do
+        begin
+          subject
+        rescue => err
+          expect(err.message)
+            .to eq "#{ object.inspect } doesn't respond to #messages"
+        end
+      end
+    end
+
+    context "with an object that responds to :messages" do
+
+      it "doesn't fail" do
+        expect { subject }.not_to raise_error
+      end
+
+      it "initializes a RuntimeError" do
+        expect(subject).to be_kind_of RuntimeError
+      end
+    end
+  end
+
+  describe "#object" do
+
+    it "is initialized" do
+      expect(subject.object).to eq object
+    end
+  end
+
+  describe "#messages" do
+
+    it "returns an array" do
+      expect(subject.messages).to be_kind_of Array
+    end
+
+    it "is delegated to the #object" do
+      expect(subject.messages).to contain_exactly object.messages
+    end
+  end
+end

data/spec/tests/listener_spec.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+
+describe ServiceObjects::Listener do
+
+  subject { described_class.new double }
+
+  it "is a simple delegator" do
+    expect(subject).to be_kind_of SimpleDelegator
+  end
+
+  describe "#otherwise" do
+
+    it "is defined" do
+      expect(subject).to respond_to :otherwise
+    end
+
+  end # #otherwise
+
+  describe "#finalize" do
+
+    before do
+      subject.__getobj__.singleton_class.send(:define_method, :item) { nil }
+      subject.singleton_class.send(:define_method, :on_success) { nil }
+      subject.singleton_class.send(:define_method, :otherwise) { nil }
+    end
+
+    it "calls #otherwise when no other methods has been checked" do
+      expect(subject).to receive(:otherwise)
+      subject.finalize
+    end
+
+    it "calls #otherwise when undefined method has been checked" do
+      expect(subject).to receive(:otherwise)
+      subject.respond_to? :on_error
+      subject.finalize
+    end
+
+    it "doesn't call #otherwise when defined method has been checked" do
+      expect(subject).not_to receive(:otherwise)
+      subject.respond_to? :on_success
+      subject.finalize
+    end
+
+    it "returns self" do
+      expect(subject.finalize).to eq subject
+    end
+
+  end # #finalize
+
+end # ServiceObjects::Listener

data/spec/tests/message_spec.rb

@@ -0,0 +1,191 @@
+# encoding: utf-8
+require "json"
+
+describe ServiceObjects::Message do
+
+  subject { described_class.new type: :foo, text: :bar }
+
+  it "is comparable" do
+    expect(subject).to be_kind_of ::Comparable
+  end
+
+  describe ".new" do
+
+    it "requires the type" do
+      expect { described_class.new text: :bar }.to raise_error ArgumentError
+    end
+
+    it "requires the text" do
+      expect { described_class.new type: :foo }.to raise_error ArgumentError
+    end
+
+    it "freezes the object" do
+      expect(subject).to be_frozen
+    end
+
+  end # .new
+
+  describe "#type" do
+
+    it "is stringified" do
+      expect(subject.type).to eq "foo"
+    end
+
+    it "is frozen" do
+      expect(subject.type).to be_frozen
+    end
+
+  end # #type
+
+  describe "#text" do
+
+    it "is stringified" do
+      expect(subject.text).to eq "bar"
+    end
+
+    it "is frozen" do
+      expect(subject.text).to be_frozen
+    end
+
+  end # #text
+
+  describe "#priority" do
+
+    it "is float" do
+      expect(subject.priority).to be_kind_of Float
+    end
+
+    it "is customizable" do
+      subject = described_class.new type: "foo", text: "bar", priority: 1.5
+      expect(subject.priority).to eq 1.5
+    end
+
+    it "is set by default to 0.0 for non-errors" do
+      subject = described_class.new type: "foo", text: "bar"
+      expect(subject.priority).to eq 0.0
+    end
+
+    it "is set by default to -1.0 for errors" do
+      subject = described_class.new type: "error", text: "bar"
+      expect(subject.priority).to eq(-1.0)
+    end
+
+  end # #priority
+
+  describe "#inspect" do
+
+    it "returns text, type and priority of the message" do
+      expect(subject.inspect)
+        .to eq %W(
+          #<ServiceObjects::Message:#{ subject.object_id }
+          type=\"#{ subject.type }\"
+          text=\"#{ subject.text }\"
+          priority=#{ subject.priority }>
+        ).join(" ")
+    end
+
+  end # #inspect
+
+  describe "#==" do
+
+    it "treats messages with the same type, text and priority as equal" do
+      a = described_class.new type: "foo", text: "bar"
+      b = described_class.new type: "foo", text: "bar"
+      expect(a == b).to be_truthy
+    end
+
+    it "treats messages with different types as different" do
+      a = described_class.new type: "bar", text: "foo"
+      b = described_class.new type: "baz", text: "foo"
+      expect(a == b).to be_falsey
+    end
+
+    it "treats messages with different texts as different" do
+      a = described_class.new type: "foo", text: "bar"
+      b = described_class.new type: "foo", text: "baz"
+      expect(a == b).to be_falsey
+    end
+
+    it "treats messages with different priorities as different" do
+      a = described_class.new type: "foo", text: "bar", priority: 1
+      b = described_class.new type: "foo", text: "bar", priority: 1.1
+      expect(a == b).to be_falsey
+    end
+
+    it "treats message as different from non-message" do
+      a = described_class.new type: "foo", text: "bar"
+      b = Struct.new(:type, :text).new("foo", "bar")
+      expect(a == b).to be_falsey
+    end
+
+  end # #==
+
+  describe "#<=>" do
+
+    it "orders messages by priorities" do
+      a = described_class.new type: "foo", text: "bar", priority: 0
+      b = described_class.new type: "foo", text: "bar", priority: 0.1
+      expect(a <=> b).to eq(-1)
+      expect(b <=> a).to eq(1)
+    end
+
+    it "orders messages by type" do
+      a = described_class.new type: "bar", text: "foo"
+      b = described_class.new type: "baz", text: "foo"
+      expect(a <=> b).to eq(-1)
+      expect(b <=> a).to eq(1)
+    end
+
+    it "orders messages by text" do
+      a = described_class.new type: "foo", text: "bar"
+      b = described_class.new type: "foo", text: "baz"
+      expect(a <=> b).to eq(-1)
+      expect(b <=> a).to eq(1)
+    end
+
+    it "orders messages at first by priorities" do
+      a = described_class.new type: "bar", text: "bar", priority: 0
+      b = described_class.new type: "baz", text: "baz", priority: 1
+      expect(a <=> b).to eq(-1)
+      expect(b <=> a).to eq(1)
+    end
+
+    it "orders messages at second by types" do
+      a = described_class.new type: "bar", text: "bar"
+      b = described_class.new type: "baz", text: "baz"
+      expect(a <=> b).to eq(-1)
+      expect(b <=> a).to eq(1)
+    end
+
+    it "treats messages with the same type, text and priority as equal" do
+      a = described_class.new type: "foo", text: "bar"
+      b = described_class.new type: "foo", text: "bar"
+      expect(a <=> b).to eq 0
+      expect(b <=> a).to eq 0
+    end
+
+    it "returns nil if other value is not a message" do
+      expect(subject <=> 1).to be_nil
+    end
+
+  end # #<=>
+
+  describe "#to_h" do
+
+    it "serializes type and text" do
+      hash = { type: subject.type, text: subject.text }
+      expect(subject.to_h).to eq hash
+    end
+
+  end # #to_h
+
+  describe "#to_json" do
+
+    it "serializes type and text" do
+      hash = { type: subject.type, text: subject.text }
+      expect(subject.to_json).to eq hash.to_json
+    end
+
+  end # #to_json
+
+end # ServiceObjects::Message

data/spec/tests/null_spec.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+describe ServiceObjects::NULL do
+
+  it "respond to arbitrary method" do
+    expect(true).to eq subject.respond_to?(:arbitrary_method)
+  end
+
+  it "returns itself" do
+    expect(subject.arbitrary_method).to eq subject
+  end
+
+  it "is a singleton" do
+    expect(subject.class.instance.__id__).to eq subject.__id__
+  end
+
+end # describe ServiceObjects::NULL

data/spec/tests/utils/normal_hash_spec.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+
+describe ServiceObjects::Utils::NormalHash do
+
+  describe ".from" do
+
+    it "symbolizes keys of existing hash" do
+      source  = { "foo" => "foo", "bar" => { "bar" => "bar", "baz" => nil } }
+      target  = { foo: "foo", bar: { bar: "bar", baz: nil } }
+
+      expect(described_class.from(source)).to eq target
+    end
+
+  end # .new
+
+end # ServiceObjects::Utils::NormalHash

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: service_objects
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andrew Kozin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: extlib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: naught
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: wisper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: hexx-suit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+description: Base class for objects, that implements both the Interactor and Observer
+  design patterns.
+email: andrew.kozin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- LICENSE
+- config/metrics/STYLEGUIDE
+files:
+- ".coveralls.yml"
+- ".metrics"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- ".yardopts"
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- config/metrics/STYLEGUIDE
+- config/metrics/cane.yml
+- config/metrics/churn.yml
+- config/metrics/flay.yml
+- config/metrics/metric_fu.yml
+- config/metrics/pippi.yml
+- config/metrics/reek.yml
+- config/metrics/roodi.yml
+- config/metrics/rubocop.yml
+- config/metrics/saikuro.yml
+- config/metrics/simplecov.yml
+- config/metrics/yardstick.yml
+- lib/service_objects.rb
+- lib/service_objects/base.rb
+- lib/service_objects/helpers/dependable.rb
+- lib/service_objects/helpers/exceptions.rb
+- lib/service_objects/helpers/messages.rb
+- lib/service_objects/helpers/parameterized.rb
+- lib/service_objects/helpers/parameters.rb
+- lib/service_objects/helpers/validations.rb
+- lib/service_objects/invalid.rb
+- lib/service_objects/listener.rb
+- lib/service_objects/message.rb
+- lib/service_objects/null.rb
+- lib/service_objects/utils/normal_hash.rb
+- lib/service_objects/version.rb
+- service_objects.gemspec
+- spec/spec_helper.rb
+- spec/tests/base_spec.rb
+- spec/tests/helpers/dependable_spec.rb
+- spec/tests/helpers/exceptions_spec.rb
+- spec/tests/helpers/messages_spec.rb
+- spec/tests/helpers/parameterized_spec.rb
+- spec/tests/helpers/parameters_spec.rb
+- spec/tests/helpers/validations_spec.rb
+- spec/tests/invalid_spec.rb
+- spec/tests/listener_spec.rb
+- spec/tests/message_spec.rb
+- spec/tests/null_spec.rb
+- spec/tests/utils/normal_hash_spec.rb
+homepage: https://github.com/nepalez/service_objects
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Service objects (interactors).
+test_files:
+- spec/spec_helper.rb
+- spec/tests/listener_spec.rb
+- spec/tests/message_spec.rb
+- spec/tests/null_spec.rb
+- spec/tests/base_spec.rb
+- spec/tests/invalid_spec.rb
+- spec/tests/helpers/parameterized_spec.rb
+- spec/tests/helpers/parameters_spec.rb
+- spec/tests/helpers/messages_spec.rb
+- spec/tests/helpers/validations_spec.rb
+- spec/tests/helpers/exceptions_spec.rb
+- spec/tests/helpers/dependable_spec.rb
+- spec/tests/utils/normal_hash_spec.rb
+has_rdoc: