scorpion-ioc 0.3.1 → 0.4.0

data/spec/lib/scorpion/rspec/helper_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+require 'scorpion/rspec'
+load 'scorpion/rspec/helper.rb'
+
+Scorpion::Rspec.prepare do
+  hunt_for Numeric, return: 42
+end
+
+describe Scorpion::Rspec::Helper do
+  include Scorpion::Rspec::Helper
+
+  scorpion do
+    hunt_for String, return: "Shazam!"
+  end
+
+  it "provides a scorpion" do
+    expect( scorpion ).not_to be_nil
+  end
+
+  it "is configurable" do
+    expect( scorpion.fetch String ).to eq "Shazam!"
+  end
+
+  it "inherits global config" do
+    expect( scorpion.fetch Numeric ).to eq 42
+  end
+
+  context "child context" do
+    it "inherits" do
+      expect( scorpion.fetch String ).to eq "Shazam!"
+    end
+
+    context "overrides" do
+
+      scorpion do
+        hunt_for String, return: "KaPow"
+      end
+
+      it "overrides" do
+        expect( scorpion.fetch String ).to eq "KaPow"
+      end
+    end
+  end
+end

data/spec/lib/scorpion_spec.rb

@@ -1,40 +1,5 @@
 require 'spec_helper'
-
-module Test
-  module Scorpion
-    class Logger; end
-
-    class Target
-      include ::Scorpion::King
-
-      feed_on do
-        logger Logger, public: true
-      end
-    end
-  end
-end
-
 describe Scorpion do
-  let( :scorpion ){ Scorpion::Hunter.new }
-  let( :target )  do
-    Test::Scorpion::Target.new.tap do |target|
-      target.instance_variable_set :@scorpion, scorpion
-    end
-  end
-
-  describe "#feed" do
-    it "injects attributes" do
-      scorpion.feed target
-
-      expect( target.logger ).to be_a Test::Scorpion::Logger
-    end
 
-    it "does not overwrite existing attributes" do
-      logger = Test::Scorpion::Logger.new
-      target.logger = logger
-      scorpion.feed target
 
-      expect( target.logger ).to be logger
-    end
-  end
 end

data/spec/spec_helper.rb

@@ -13,6 +13,7 @@ Combustion.initialize! :all
 
 require 'rspec/rails'
 require 'scorpion'
+require 'scorpion/rspec'
 
 root_path = File.expand_path( "../..", __FILE__ )
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scorpion-ioc
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Paul Alexander
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-21 00:00:00.000000000 Z
+date: 2015-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -120,39 +120,59 @@ files:
 - lib/scorpion.rb
 - lib/scorpion/attribute.rb
 - lib/scorpion/attribute_set.rb
+- lib/scorpion/dependency.rb
+- lib/scorpion/dependency/argument_dependency.rb
+- lib/scorpion/dependency/builder_dependency.rb
+- lib/scorpion/dependency/captured_dependency.rb
+- lib/scorpion/dependency/class_dependency.rb
+- lib/scorpion/dependency/module_dependency.rb
+- lib/scorpion/dependency_map.rb
 - lib/scorpion/error.rb
+- lib/scorpion/hunt.rb
 - lib/scorpion/hunter.rb
-- lib/scorpion/hunting_map.rb
-- lib/scorpion/king.rb
 - lib/scorpion/locale/en.yml
 - lib/scorpion/nest.rb
-- lib/scorpion/prey.rb
-- lib/scorpion/prey/builder_prey.rb
-- lib/scorpion/prey/captured_prey.rb
-- lib/scorpion/prey/class_prey.rb
-- lib/scorpion/prey/hunted_prey.rb
-- lib/scorpion/prey/module_prey.rb
+- lib/scorpion/object.rb
+- lib/scorpion/object_constructor.rb
 - lib/scorpion/rails.rb
+- lib/scorpion/rails/active_record.rb
+- lib/scorpion/rails/active_record/association.rb
+- lib/scorpion/rails/active_record/model.rb
+- lib/scorpion/rails/active_record/relation.rb
 - lib/scorpion/rails/controller.rb
+- lib/scorpion/rails/job.rb
+- lib/scorpion/rails/nest.rb
+- lib/scorpion/rails/railtie.rb
+- lib/scorpion/rspec.rb
+- lib/scorpion/rspec/helper.rb
+- lib/scorpion/stinger.rb
 - lib/scorpion/version.rb
 - scorpion.gemspec
+- spec/internal/app/models/author.rb
+- spec/internal/app/models/todo.rb
 - spec/internal/config/database.yml
 - spec/internal/config/routes.rb
-- spec/internal/db/combustion_test.sqlite
 - spec/internal/db/schema.rb
 - spec/internal/log/.gitignore
 - spec/internal/public/favicon.ico
 - spec/lib/scorpion/attribute_set_spec.rb
 - spec/lib/scorpion/attribute_spec.rb
+- spec/lib/scorpion/dependency/argument_dependency_spec.rb
+- spec/lib/scorpion/dependency/builder_dependency_spec.rb
+- spec/lib/scorpion/dependency/module_dependency_spec.rb
+- spec/lib/scorpion/dependency_map_spec.rb
+- spec/lib/scorpion/dependency_spec.rb
 - spec/lib/scorpion/error_spec.rb
+- spec/lib/scorpion/hunt_spec.rb
 - spec/lib/scorpion/hunter_spec.rb
-- spec/lib/scorpion/hunting_map_spec.rb
-- spec/lib/scorpion/instance_spec.rb
-- spec/lib/scorpion/king_spec.rb
-- spec/lib/scorpion/prey/builder_prey_spec.rb
-- spec/lib/scorpion/prey/module_prey_spec.rb
-- spec/lib/scorpion/prey_spec.rb
+- spec/lib/scorpion/object_constructor_spec.rb
+- spec/lib/scorpion/object_spec.rb
+- spec/lib/scorpion/rails/active_record/association_spec.rb
+- spec/lib/scorpion/rails/active_record/model_spec.rb
+- spec/lib/scorpion/rails/active_record/relation_spec.rb
 - spec/lib/scorpion/rails/controller_spec.rb
+- spec/lib/scorpion/rails/job_spec.rb
+- spec/lib/scorpion/rspec/helper_spec.rb
 - spec/lib/scorpion_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/phallguy/scorpion
@@ -167,7 +187,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.2
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -175,28 +195,36 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: Add IoC to rails with minimal fuss and ceremony
 test_files:
+- spec/internal/app/models/author.rb
+- spec/internal/app/models/todo.rb
 - spec/internal/config/database.yml
 - spec/internal/config/routes.rb
-- spec/internal/db/combustion_test.sqlite
 - spec/internal/db/schema.rb
 - spec/internal/log/.gitignore
 - spec/internal/public/favicon.ico
 - spec/lib/scorpion/attribute_set_spec.rb
 - spec/lib/scorpion/attribute_spec.rb
+- spec/lib/scorpion/dependency/argument_dependency_spec.rb
+- spec/lib/scorpion/dependency/builder_dependency_spec.rb
+- spec/lib/scorpion/dependency/module_dependency_spec.rb
+- spec/lib/scorpion/dependency_map_spec.rb
+- spec/lib/scorpion/dependency_spec.rb
 - spec/lib/scorpion/error_spec.rb
+- spec/lib/scorpion/hunt_spec.rb
 - spec/lib/scorpion/hunter_spec.rb
-- spec/lib/scorpion/hunting_map_spec.rb
-- spec/lib/scorpion/instance_spec.rb
-- spec/lib/scorpion/king_spec.rb
-- spec/lib/scorpion/prey/builder_prey_spec.rb
-- spec/lib/scorpion/prey/module_prey_spec.rb
-- spec/lib/scorpion/prey_spec.rb
+- spec/lib/scorpion/object_constructor_spec.rb
+- spec/lib/scorpion/object_spec.rb
+- spec/lib/scorpion/rails/active_record/association_spec.rb
+- spec/lib/scorpion/rails/active_record/model_spec.rb
+- spec/lib/scorpion/rails/active_record/relation_spec.rb
 - spec/lib/scorpion/rails/controller_spec.rb
+- spec/lib/scorpion/rails/job_spec.rb
+- spec/lib/scorpion/rspec/helper_spec.rb
 - spec/lib/scorpion_spec.rb
 - spec/spec_helper.rb
 has_rdoc: 

data/lib/scorpion/hunting_map.rb

@@ -1,139 +0,0 @@
-module Scorpion
-  # {#chart} available {Prey} and {#find} them based on desired
-  # {#{Scorpion::Attribute attributes}.
-  class HuntingMap
-    include Enumerable
-    extend Forwardable
-
-    # ============================================================================
-    # @!group Attributes
-    #
-
-    # @return [Scorpion] the scorpion that created the map.
-      attr_reader :scorpion
-
-    # @return [Set] the set of prey charted on this map.
-      attr_reader :prey_set
-      private :prey_set
-
-    # @return [Set] the set of prey charted on this map that is shared with all
-    #   child prey.
-      attr_reader :shared_prey_set
-      private :shared_prey_set
-
-
-    # @return [Set] the active prey set either {#prey_set} or {#shared_prey_set}
-      attr_reader :active_prey_set
-      private :active_prey_set
-
-    #
-    # @!endgroup Attributes
-
-    def initialize( scorpion )
-      @scorpion = scorpion
-      @prey_set = @active_prey_set = []
-      @shared_prey_set = []
-    end
-
-    # Find {Prey} that matches the requested `contract` and `traits`.
-    # @param [Class,Module,Symbol] contract describing the desired behavior of the prey.
-    # @param [Array<Symbol>] traits found on the {Prey}.
-    # @return [Prey] the prey matching the attribute.
-    def find( contract, traits = nil )
-      prey_set.find{ |p| p.satisfies?( contract, traits ) } ||
-      shared_prey_set.find{ |p| p.satisfies?( contract, traits ) }
-    end
-
-    # Chart the {Prey} that this hunting map can {#find}.
-    def chart( &block )
-      return unless block_given?
-
-      if block.arity == 1
-        yield self
-      else
-        instance_eval &block
-      end
-
-      self
-    end
-
-    # Define {Prey} that can be found on this map by `contract` and `traits`.
-    #
-    # If a block is given, it will be used build the actual instances of the
-    # prey for the {Scorpion}.
-    #
-    # @param [Class,Module,Symbol] contract describing the desired behavior of the prey.
-    # @param [Array<Symbol>] traits found on the {Prey}.
-    # @return [Scorpion::Prey] the prey to be hunted for.
-    def hunt_for( contract, traits = nil, &builder )
-      active_prey_set.unshift define_prey( contract, traits, &builder )
-    end
-    alias_method :offer, :hunt_for
-
-    # Captures a single prey and returns the same instance fore each request
-    # for the resource.
-    # @see #hunt_for
-    def capture( contract, traits = nil, &builder )
-      active_prey_set.unshift Scorpion::Prey::CapturedPrey.new( define_prey( contract, traits, &builder ) )
-    end
-    alias_method :singleton, :capture
-
-    # Share captured prey defined within the block with all child scorpions.
-    def share( &block )
-      old_set = active_prey_set
-      @active_prey_set = shared_prey_set
-      yield
-    ensure
-      @active_prey_set = old_set
-    end
-
-    def each( &block )
-      prey_set.each &block
-    end
-    delegate [ :empty?, :blank?, :present? ] => :prey_set
-
-    # Replicates the prey in `other_map` into this map.
-    # @param [Scorpion::HuntingMap] other_map to replicate from.
-    def replicate_from( other_map )
-      other_map.each do |prey|
-        if replica = prey.replicate
-          prey_set << replica
-        end
-      end
-    end
-
-    private
-
-      def define_prey( contract, traits, &builder )
-        options, traits = extract_options!( traits )
-
-        if with = options[:with]
-          Scorpion::Prey::BuilderPrey.new( contract, traits, with )
-        elsif block_given?
-          Scorpion::Prey::BuilderPrey.new( contract, traits, builder)
-        else
-          prey_class( contract ).new( contract, traits, &builder )
-        end
-      end
-
-      def extract_options!( traits )
-        case traits
-        when Hash then return [ traits, nil ]
-        when Array then
-          if traits.last.is_a? Hash
-            return [ traits.pop, traits ]
-          end
-        end
-
-        [ {}, traits]
-      end
-
-      def prey_class( contract, &builder )
-        return Scorpion::Prey::HuntedPrey  if contract.respond_to? :hunt
-        return Scorpion::Prey::ClassPrey   if contract.is_a? Class
-        return Scorpion::Prey::ClassPrey   if contract.is_a? Module
-
-        raise Scorpion::BuilderRequiredError
-      end
-  end
-end

data/lib/scorpion/prey/captured_prey.rb

@@ -1,44 +0,0 @@
-require 'scorpion/prey'
-
-module Scorpion
-  class Prey
-    class CapturedPrey < Scorpion::Prey
-      extend Forwardable
-
-      # ============================================================================
-      # @!group Attributes
-      #
-
-      # @!attribute
-      # @return [Object] the instance that was captured.
-        attr_reader :instance
-
-      # @!attribute
-      # @return [Scorpion::Prey] the actual prey to hunt. Used to fetch the
-      #   single {#instance}.
-        attr_reader :specific_prey
-        private :specific_prey
-
-
-      delegate [:contract,:traits,:satisfies?] => :specific_prey
-
-      #
-      # @!endgroup Attributes
-
-      def initialize( specific_prey )
-        @specific_prey = specific_prey
-      end
-
-      # @see Prey#fetch
-      def fetch( scorpion, *args, &block )
-        @instance ||= specific_prey.fetch( scorpion, *args, &block )
-      end
-
-      # @see Prey#release
-      def release
-        @instance = nil
-      end
-
-    end
-  end
-end

data/lib/scorpion/prey/class_prey.rb

@@ -1,13 +0,0 @@
-require 'scorpion/prey'
-
-module Scorpion
-  class Prey
-    # {Prey} for a {Class} contract
-    class ClassPrey < Scorpion::Prey
-
-      def fetch( scorpion, *args, &block )
-        scorpion.spawn contract, *args, &block
-      end
-    end
-  end
-end

data/lib/scorpion/prey/hunted_prey.rb

@@ -1,14 +0,0 @@
-require 'scorpion/prey'
-
-module Scorpion
-  class Prey
-    # {Prey} for a contract that implements #hunt
-    class HuntedPrey < Scorpion::Prey
-
-      # @see Scorpion::Prey#fetch
-      def fetch( scorpion, *args, &block )
-        contract.hunt( scorpion, *args, &block )
-      end
-    end
-  end
-end

data/lib/scorpion/prey/module_prey.rb

@@ -1,14 +0,0 @@
-require 'scorpion/prey'
-
-module Scorpion
-  class Prey
-    # {Prey} for a {Module} contract
-    class ModulePrey < Scorpion::Prey
-
-      def fetch( scorpion, *args, &block )
-        contract
-      end
-
-    end
-  end
-end

data/lib/scorpion/prey.rb

@@ -1,94 +0,0 @@
-module Scorpion
-  # Prey that can be fed to a {Scorpion::King} by a {Scorpion}.
-  class Prey
-
-    require 'scorpion/prey/captured_prey'
-    require 'scorpion/prey/class_prey'
-    require 'scorpion/prey/module_prey'
-    require 'scorpion/prey/builder_prey'
-    require 'scorpion/prey/hunted_prey'
-
-    # ============================================================================
-    # @!group Attributes
-    #
-
-    # @!attribute
-    # @return [Class,Module,Symbol] contract describing the desired behavior of the prey.
-      attr_reader :contract
-
-    # @!attribute
-    # @return [Array<Symbol>] the traits available on the prey.
-      attr_reader :traits
-
-    #
-    # @!endgroup Attributes
-
-    def initialize( contract, traits = nil )
-      @contract = contract
-      @traits   = Set.new( Array( traits ) )
-    end
-
-    # @return [Boolean] if the prey satisfies the required contract and traits.
-    def satisfies?( contract, traits = nil )
-      satisfies_contract?( contract ) && satisfies_traits?( traits )
-    end
-
-    # Fetch an instance of the prey.
-    # @param [Scorpion] scorpion hunting for the prey.
-    # @param [Array<Object>] arguments to the consructor of the prey.
-    # @param [#call] block to pass to constructor.
-    # @return [Object] the hunted prey.
-    def fetch( scorpion, *args, &block )
-      fail "Not Implemented"
-    end
-
-    # Release the prey, freeing up any long held resources.
-    def release
-    end
-
-    # Replicate the Prey.
-    # @return [Prey] a replication of the prey.
-    def replicate
-      dup
-    end
-
-    def ==( other )
-      return unless other
-      self.class == other.class &&
-      contract   == other.contract &&
-      traits     == other.traits
-    end
-    alias_method :eql?, :==
-
-    def hash
-      self.class.hash ^
-      contract.hash ^
-      traits.hash
-    end
-
-    private
-
-      # @return [Boolean] true if the pray satisfies the given contract.
-      def satisfies_contract?( contract )
-        if self.contract.is_a? Symbol
-          self.contract == contract
-        else
-          self.contract <= contract
-        end
-      end
-
-      # @return [Boolean] true if the pray satisfies the given contract.
-      def satisfies_traits?( traits )
-        return true if traits.blank?
-
-        Array( traits ).all? do |trait|
-          case trait
-          when Symbol then self.traits.include? trait
-          when Module then self.contract <= trait
-          else fail ArgumentError, "Unsupported trait"
-          end
-        end
-      end
-
-  end
-end

data/spec/lib/scorpion/hunting_map_spec.rb

@@ -1,126 +0,0 @@
-require 'spec_helper'
-
-module Test
-  module HuntingMap
-    class Weapon; end
-    class Armor; end
-  end
-end
-
-describe Scorpion::HuntingMap do
-  let( :scorpion ){ double Scorpion }
-  let( :map ){ Scorpion::HuntingMap.new scorpion }
-
-  describe "#chart" do
-    it "yields itself when arg expected" do
-      map.chart do |itself|
-        expect( map ).to be itself
-      end
-    end
-  end
-
-  describe "#find" do
-    it "returns a match" do
-      map.chart do
-        hunt_for Test::HuntingMap::Weapon
-        hunt_for Test::HuntingMap::Armor
-      end
-
-      expect( map.find( Test::HuntingMap::Armor ).contract ).to eq Test::HuntingMap::Armor
-    end
-
-    it "returns nil when no match" do
-      map.chart do
-        hunt_for Test::HuntingMap::Weapon
-      end
-
-      expect( map.find( Test::HuntingMap::Armor ) ).to be_nil
-    end
-
-    it "returns nil when no match" do
-      map.chart do
-        hunt_for Test::HuntingMap::Weapon
-      end
-
-      expect( map.find( Test::HuntingMap::Armor ) ).to be_nil
-    end
-
-
-    context "multiple possible matches" do
-      before( :each ) do
-        map.chart do
-          hunt_for Test::HuntingMap::Weapon, [ :sharp, :one_handed ]
-          hunt_for Test::HuntingMap::Weapon, [ :blunt, :one_handed ]
-        end
-      end
-
-      it "returns the last prey that matches one trait" do
-        expect( map.find( Test::HuntingMap::Weapon, :one_handed ).traits ).to include :blunt
-      end
-
-      it "returns the last prey that matches all of the traits" do
-        expect( map.find( Test::HuntingMap::Weapon, [ :one_handed, :blunt ] ).traits ).to include :blunt
-      end
-
-      it "returns the last prey that matches a unique trait" do
-        expect( map.find( Test::HuntingMap::Weapon, :blunt ).traits ).to include :blunt
-      end
-    end
-  end
-
-  describe "#hunt_for" do
-    it "adds a Prey" do
-      expect( map ).to be_empty
-
-      map.chart do
-        hunt_for Test::HuntingMap::Weapon
-      end
-
-      expect( map.first ).to be_a Scorpion::Prey
-    end
-
-    it "adds a BuilderPrey for block hunts" do
-      map.chart do
-        hunt_for String do
-          "YASS"
-        end
-      end
-
-      expect( map.first ).to be_a Scorpion::Prey::BuilderPrey
-    end
-
-    it "adds a BuilderPrey for with: option" do
-      map.chart do
-        hunt_for String, with: ->(scorpion,*args,&block){ "YASSS" }
-      end
-
-      expect( map.first ).to be_a Scorpion::Prey::BuilderPrey
-    end
-  end
-
-  describe "#replicate_from" do
-    it "does not dup shared prey" do
-      map.chart do
-        share do
-          capture Test::HuntingMap::Weapon
-        end
-      end
-
-      replica = Scorpion::HuntingMap.new scorpion
-      replica.replicate_from( map )
-
-      expect( replica ).to be_empty
-    end
-
-    it "dups captured prey" do
-      map.chart do
-        capture Test::HuntingMap::Weapon
-      end
-
-      replica = Scorpion::HuntingMap.new scorpion
-      replica.replicate_from( map )
-
-      expect( replica ).not_to be_empty
-    end
-  end
-end

data/spec/lib/scorpion/instance_spec.rb

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