mr_darcy 0.1.0

data/spec/lib/mr_darcy/promise/state/unresolved_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe MrDarcy::Promise::State::Unresolved do
+  let(:initial_state) { :unresolved }
+  let(:stateful)      { Struct.new(:state).new initial_state }
+  let(:state)         { described_class.new stateful }
+
+  subject { state }
+
+  it { should be_a MrDarcy::Promise::State::Base }
+  its(:unresolved?) { should be_true }
+
+  describe '#resolve' do
+    subject { -> { state.resolve } }
+    it { should change { stateful.state }.from(:unresolved).to(:resolved) }
+  end
+
+  describe '#reject' do
+    subject { -> { state.reject } }
+    it { should change { stateful.state }.from(:unresolved).to(:rejected) }
+  end
+end

data/spec/lib/mr_darcy/promise/state_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe MrDarcy::Promise::State do
+  describe '#state' do
+    let(:stateful) { Struct.new(:state).new initial_state }
+    subject { MrDarcy::Promise::State.state stateful }
+
+    When 'the state is unresolved' do
+      let(:initial_state) { :unresolved }
+      it { should be_an MrDarcy::Promise::State::Unresolved }
+    end
+
+    When 'the state is resolved' do
+      let(:initial_state) { :resolved }
+      it { should be_an MrDarcy::Promise::State::Resolved }
+    end
+
+    When 'the state is rejected' do
+      let(:initial_state) { :rejected }
+      it { should be_an MrDarcy::Promise::State::Rejected }
+    end
+
+    Otherwise do
+      let(:initial_state) { :foo }
+      it 'raises an exception' do
+        expect { subject }.to raise_error
+      end
+    end
+  end
+end

data/spec/lib/mr_darcy/promise/synchronous_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe MrDarcy::Promise::Synchronous do
+  let(:sync) { described_class.new proc {} }
+  subject { sync }
+
+  it { should respond_to :result }
+  it { should respond_to :final }
+
+  describe '#schedule_promise' do
+    it 'yields immediately' do
+      expect { |b| sync.send(:schedule_promise, &b) }.to yield_control.once
+    end
+  end
+
+  describe '#generate_child_promise' do
+    it 'creates a child promise with the correct driver' do
+      expect(sync.send(:generate_child_promise).promise).to be_a described_class
+    end
+  end
+end

data/spec/lib/mr_darcy/promise_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+
+describe MrDarcy::Promise do
+  describe '.new' do
+    let(:driver) { nil }
+    subject { MrDarcy::Promise.new(driver: driver) {} }
+
+    When 'no driver is provided' do
+      subject { MrDarcy::Promise.new {} }
+
+      it 'uses the default' do
+        expect(MrDarcy).to receive(:driver).and_return(:thread)
+        expect(subject).to be_a MrDarcy::Promise::Thread
+      end
+    end
+
+    When 'driver is :thread' do
+      let(:driver) { :thread }
+      it { should be_a MrDarcy::Promise::Thread }
+    end
+
+    When 'driver is :Thread' do
+      let(:driver) { :Thread }
+      it { should be_a MrDarcy::Promise::Thread }
+    end
+
+    When 'driver is :synchronous' do
+      let(:driver) { :synchronous }
+      it { should be_a MrDarcy::Promise::Synchronous }
+    end
+
+    When 'driver is :Synchronous' do
+      let(:driver) { :Synchronous }
+      it { should be_a MrDarcy::Promise::Synchronous }
+    end
+
+    When 'driver is :celluloid' do
+      let(:driver) { :celluloid }
+      it { should be_a MrDarcy::Promise::Celluloid }
+    end
+
+    When 'driver is :Celluloid' do
+      let(:driver) { :Celluloid }
+      it { should be_a MrDarcy::Promise::Celluloid }
+    end
+
+    When 'driver is :em' do
+      let(:driver) { :em }
+      it { should be_a MrDarcy::Promise::EM }
+    end
+
+    When 'driver is :EM' do
+      let(:driver) { :EM }
+      it { should be_a MrDarcy::Promise::EM }
+    end
+
+    When 'driver is :event_machine' do
+      let(:driver) { :event_machine }
+      it { should be_a MrDarcy::Promise::EM }
+    end
+
+    When 'driver is :eventmachine' do
+      let(:driver) { :eventmachine }
+      it { should be_a MrDarcy::Promise::EM }
+    end
+
+    When 'driver is :EventMachine' do
+      let(:driver) { :EventMachine }
+      it { should be_a MrDarcy::Promise::EM }
+    end
+  end
+end

data/spec/lib/mr_darcy/role_spec.rb

@@ -0,0 +1,89 @@
+require 'mr_darcy/role'
+
+describe MrDarcy::Role do
+  let(:name) { :money_source }
+  let(:opts) { Hash.new }
+  let(:role_methods) do
+    proc do
+      def really_a_money_source?
+        :yup
+      end
+    end
+  end
+  let(:role) { MrDarcy::Role.new name, opts, &role_methods }
+  subject { role }
+
+  it { should respond_to :name }
+  it { should respond_to :options }
+
+  describe '#name' do
+    subject { role.name }
+
+    it { should eq name }
+  end
+
+  describe '#options' do
+    let(:opts) { { test_options: true } }
+    subject { role.options }
+
+    it { should eq opts }
+  end
+
+  describe '#pollute' do
+    let(:player) { Object.new }
+
+    context 'pollution' do
+      before  { role.pollute player }
+      subject { player }
+
+      it { should respond_to :really_a_money_source? }
+      its(:really_a_money_source?) { should eq :yup }
+    end
+
+    context "when the role has a method requirement" do
+      let(:opts) { { must_respond_to: :name } }
+      subject { -> { role.pollute player } }
+
+      context "and the player does not implement it" do
+        it { should raise_error }
+      end
+
+      context "and the player does implement it" do
+        let(:player) { Class.new { def name; 'my name'; end }.new }
+        it { should_not raise_error }
+      end
+    end
+
+    context "when the role is a method refusal" do
+      let(:opts) { { must_not_respond_to: :name } }
+      subject { -> { role.pollute player } }
+
+      context "and the player does not implement it" do
+        it { should_not raise_error }
+      end
+
+      context "and the player does implement it" do
+        let(:player) { Class.new { def name; 'my name'; end }.new }
+        it { should raise_error }
+      end
+    end
+
+    context "when there is an unknown option" do
+      let(:opts) { { must_be_super_awesome: true } }
+      subject { -> { role.pollute player } }
+      it { should raise_error }
+    end
+  end
+
+  describe '#clean' do
+    let(:player) { Object.new }
+    before do
+      role.pollute player
+      expect(player).to respond_to :really_a_money_source?
+      role.clean player
+    end
+    subject { player }
+
+    it { should_not respond_to :really_a_money_source? }
+  end
+end

data/spec/lib/mr_darcy_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe MrDarcy do
+  it { should be }
+  it { should respond_to :driver }
+  it { should respond_to :driver= }
+
+  # This spec doesn't pass on CI. I can't figure out why.
+  # describe '#promise' do
+  #   When 'no driver is specified' do
+  #     subject { MrDarcy.promise {} }
+
+  #     it 'uses whichever driver is the default' do
+  #       expect(MrDarcy).to receive(:driver).and_return(:thread)
+  #       subject
+  #     end
+  #   end
+  # end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+Dir[File.expand_path('../support/**/*.rb', __FILE__)].each { |f| require f }
+
+require 'mr_darcy'
+require 'pry'
+
+RSpec.configure do |config|
+  config.color_enabled = true
+  config.formatter = :documentation
+  config.extend ContextHelpers
+end

data/spec/support/context_helpers.rb

@@ -0,0 +1,19 @@
+module ContextHelpers
+  def When(msg=nil,&block)
+    context("When#{left_pad msg}", &block)
+  end
+
+  def Otherwise(msg=nil,&block)
+    context("Otherwise#{left_pad msg}", &block)
+  end
+
+  def And(msg=nil,&block)
+    context("And#{left_pad msg}", &block)
+  end
+
+  private
+
+  def left_pad(msg)
+    msg ? " #{msg}" : ""
+  end
+end

data/spec/support/shared_examples_for_promise.rb

@@ -0,0 +1,47 @@
+shared_examples_for "a promise" do
+  it_behaves_like :thenable
+
+  describe '#then' do
+    its(:then) { should be_a MrDarcy::Promise::Base }
+  end
+
+  describe '#fail' do
+    its(:fail) { should be_a MrDarcy::Promise::Base }
+  end
+end
+
+shared_examples_for 'a resolved promise' do
+  it_should_behave_like 'a promise'
+
+  its(:final)  { should be_resolved }
+  its(:final)  { should_not be_rejected }
+  its(:final)  { should_not be_unresolved }
+
+  it "doesn't raise an exception" do
+    expect { subject.raise }.not_to raise_exception
+  end
+end
+
+shared_examples_for 'an unresolved promise' do
+  it_should_behave_like 'a promise'
+
+  its(:final)  { should_not be_resolved }
+  its(:final)  { should_not be_rejected }
+  its(:final)  { should be_unresolved }
+
+  it "doesn't raise an exception" do
+    expect { subject.raise }.not_to raise_exception
+  end
+end
+
+shared_examples_for 'a rejected promise' do
+  it_should_behave_like 'a promise'
+
+  its(:final)  { should_not be_resolved }
+  its(:final)  { should be_rejected }
+  its(:final)  { should_not be_unresolved }
+
+  it "raises an exception" do
+    expect { subject.raise }.to raise_exception
+  end
+end

data/spec/support/shared_examples_for_thennable.rb

@@ -0,0 +1,10 @@
+shared_examples_for :thenable do
+  it { should respond_to :then }
+  it { should respond_to :fail }
+  it { should respond_to :result }
+  it { should respond_to :final }
+  it { should respond_to :raise }
+  it { should respond_to :unresolved? }
+  it { should respond_to :resolved? }
+  it { should respond_to :rejected? }
+end

metadata

@@ -0,0 +1,279 @@
+--- !ruby/object:Gem::Specification
+name: mr_darcy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- James Harton
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !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: guard
+  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: guard-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: guard-bundler
+  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: terminal-notifier-guard
+  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: pry
+  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: eventmachine
+  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: em-http-request
+  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: celluloid
+  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: |2
+    MrDarcy takes async promises from the javascript word, DCI from Jim
+    Gay's brain and sprinkles some ruby on top for great justice!
+email:
+- james@resistor.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/mr_darcy.rb
+- lib/mr_darcy/context.rb
+- lib/mr_darcy/deferred.rb
+- lib/mr_darcy/drivers.rb
+- lib/mr_darcy/drivers/celluloid.rb
+- lib/mr_darcy/drivers/synchronous.rb
+- lib/mr_darcy/drivers/thread.rb
+- lib/mr_darcy/promise.rb
+- lib/mr_darcy/promise/base.rb
+- lib/mr_darcy/promise/celluloid.rb
+- lib/mr_darcy/promise/child_promise.rb
+- lib/mr_darcy/promise/dsl.rb
+- lib/mr_darcy/promise/em.rb
+- lib/mr_darcy/promise/state.rb
+- lib/mr_darcy/promise/state/base.rb
+- lib/mr_darcy/promise/state/rejected.rb
+- lib/mr_darcy/promise/state/resolved.rb
+- lib/mr_darcy/promise/state/unresolved.rb
+- lib/mr_darcy/promise/synchronous.rb
+- lib/mr_darcy/promise/thread.rb
+- lib/mr_darcy/role.rb
+- lib/mr_darcy/version.rb
+- mr_darcy.gemspec
+- spec/acceptance/dci_bank_transfer_spec.rb
+- spec/acceptance/em_http_request_spec.rb
+- spec/acceptance/open-uri_http_request_spec.rb
+- spec/acceptance/simple_promise_spec.rb
+- spec/acceptance/simple_promise_with_chained_fail.rb
+- spec/acceptance/simple_promise_with_fail_spec.rb
+- spec/acceptance/simple_promise_with_then_spec.rb
+- spec/lib/mr_darcy/context_spec.rb
+- spec/lib/mr_darcy/promise/base_spec.rb
+- spec/lib/mr_darcy/promise/child_promise_spec.rb
+- spec/lib/mr_darcy/promise/dsl_spec.rb
+- spec/lib/mr_darcy/promise/state/base_spec.rb
+- spec/lib/mr_darcy/promise/state/rejected_spec.rb
+- spec/lib/mr_darcy/promise/state/resolved_spec.rb
+- spec/lib/mr_darcy/promise/state/unresolved_spec.rb
+- spec/lib/mr_darcy/promise/state_spec.rb
+- spec/lib/mr_darcy/promise/synchronous_spec.rb
+- spec/lib/mr_darcy/promise_spec.rb
+- spec/lib/mr_darcy/role_spec.rb
+- spec/lib/mr_darcy_spec.rb
+- spec/spec_helper.rb
+- spec/support/context_helpers.rb
+- spec/support/shared_examples_for_promise.rb
+- spec/support/shared_examples_for_thennable.rb
+homepage: https://github.com/jamesotron/MrDarcy
+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.1.11
+signing_key: 
+specification_version: 4
+summary: A mashup of async Promises and DCI in Ruby.
+test_files:
+- spec/acceptance/dci_bank_transfer_spec.rb
+- spec/acceptance/em_http_request_spec.rb
+- spec/acceptance/open-uri_http_request_spec.rb
+- spec/acceptance/simple_promise_spec.rb
+- spec/acceptance/simple_promise_with_chained_fail.rb
+- spec/acceptance/simple_promise_with_fail_spec.rb
+- spec/acceptance/simple_promise_with_then_spec.rb
+- spec/lib/mr_darcy/context_spec.rb
+- spec/lib/mr_darcy/promise/base_spec.rb
+- spec/lib/mr_darcy/promise/child_promise_spec.rb
+- spec/lib/mr_darcy/promise/dsl_spec.rb
+- spec/lib/mr_darcy/promise/state/base_spec.rb
+- spec/lib/mr_darcy/promise/state/rejected_spec.rb
+- spec/lib/mr_darcy/promise/state/resolved_spec.rb
+- spec/lib/mr_darcy/promise/state/unresolved_spec.rb
+- spec/lib/mr_darcy/promise/state_spec.rb
+- spec/lib/mr_darcy/promise/synchronous_spec.rb
+- spec/lib/mr_darcy/promise_spec.rb
+- spec/lib/mr_darcy/role_spec.rb
+- spec/lib/mr_darcy_spec.rb
+- spec/spec_helper.rb
+- spec/support/context_helpers.rb
+- spec/support/shared_examples_for_promise.rb
+- spec/support/shared_examples_for_thennable.rb