wirer 0.5.0 → 0.5.1

data/lib/wirer/dependency.rb

@@ -1,11 +1,14 @@
-# dependency :foo, Class, :features => [:feature, :feature], :optional => true
-# dependency :foo, Class, :features => [:feature, :feature], :multiple => true
-#
-# dependency :foo, Class, :optional => true
-# dependency :foo, :feature, :another_feature, :optional => true, :constructor => true
-
 module Wirer
 
+
+  # Models a dependency, and has class methods for interpreting dsl-like argument
+  # lists that declare dependencies.
+  #
+  # dependency :foo, Class, :features => [:feature, :feature], :optional => true
+  # dependency :foo, Class, :features => [:feature, :feature], :multiple => true
+  #
+  # dependency :foo, Class, :optional => true
+  # dependency :foo, :feature, :another_feature, :optional => true, :constructor => true
   class Dependency
     def self.new_from_args(*args)
       new(normalise_args(*args))

data/lib/wirer/errors.rb

@@ -1,24 +1,26 @@
-module Wirer
+# coding: utf-8
 
+module Wirer
   # Thank you to http://rubyforge.org/projects/nestegg for the pattern
   class Error < StandardError
-
     attr_reader :cause
-    alias :wrapped_error :cause
+    alias_method :wrapped_error, :cause
 
-    def initialize(msg, cause=nil)
+    def initialize(msg, cause = $ERROR_INFO)
       @cause = cause
-      super(msg)
+      super(msg || cause && cause.message)
     end
 
     def set_backtrace(bt)
       if cause
+        cause.backtrace.reverse.each do |line|
+          bt.last == line ? bt.pop : break
+        end
         bt << "cause: #{cause.class.name}: #{cause}"
         bt.concat cause.backtrace
       end
       super(bt)
     end
-
   end
 
   class DependencyFindingError < Error; end
@@ -26,5 +28,4 @@ module Wirer
 
   # raised when a dependency could be found, but failed to be constructed.
   class DependencyConstructionError < Error; end
-
 end

data/lib/wirer/factory/class_mixins.rb

@@ -29,9 +29,9 @@ module Wirer
     end
   end
 
-  # A more convenient form of Wirer::Factory::ClassMixin, this additionally adds some
-  # private DSL methods which let you declare your constructor_dependencies,
-  # setter_dependencies and provides_features.
+  # A more convenient form of {Wirer::Factory::ClassMixin}, this additionally adds some
+  # private DSL methods which let you declare your {#constructor_dependencies},
+  # {#setter_dependencies} and {#provides_features}.
   #
   # The DSL works nicely with respect to subclassing, so you can add extra dependencies
   # or features in a subclass.
@@ -64,7 +64,9 @@ module Wirer
       deps_hash[arg_name] = Dependency.new_from_args(*dependency_args)
     end
 
-    # as a convenience, will additionally define an attr_reader for this dependency name
+    # Declares a constructor dependency, also aliased as {#dependency}.  See
+    # {Wirer::Dependency} for documentation on how to declare dependencies.
+    # As a convenience, will additionally define an attr_reader for this dependency name
     # unless you specify :getter => false. by default it will be private, but :getter => :public
     # will make it public.
     def constructor_dependency(name, *args)
@@ -88,7 +90,11 @@ module Wirer
       constructor_dependency(name, *args)
     end
 
-    # will additionally define a attr_writer method of this name, unless :setter => false
+    # Delcare a setter dependency.  Setter dependencies, as the name suggests,
+    # are given to an instance using a setter method, rather than passing it in
+    # to the constructor.
+    #
+    # It will additionally define a attr_writer method of this name, unless :setter => false
     # is specified. this is private by default but made public if you specify :setter => :public.
     #
     # and a corresponding public attr_reader too if :accessor => true if specified.

data/lib/wirer/factory/wrapped.rb

@@ -55,7 +55,7 @@ module Wirer
           # since this allows it to stay instance-sensitive. see #setter_dependencies.
           @extended_static_setter_dependencies ||= setter_dependencies
         else
-          raise Error, "No constructor_dependency or static setter_dependency #{arg_name.inspect} found to extend on the wrapped factory"
+          raise Error, "No constructor_dependency or static setter_dependency #{dep_name.inspect} found to extend on the wrapped factory"
         end
       end
 

data/lib/wirer/version.rb

@@ -1,3 +1,3 @@
 module Wirer
-  VERSION = '0.5.0'
+  VERSION = '0.5.1'
 end

metadata

@@ -1,142 +1,157 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: wirer
-version: !ruby/object:Gem::Version 
-  hash: 11
+version: !ruby/object:Gem::Version
+  version: 0.5.1
   prerelease: 
-  segments: 
-  - 0
-  - 5
-  - 0
-  version: 0.5.0
 platform: ruby
-authors: 
+authors:
 - Matthew Willson
 - Tom Chipchase
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-07-27 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2014-07-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rake
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: minitest
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 11
-        segments: 
-        - 2
-        - 1
-        - 0
+      - !ruby/object:Gem::Version
         version: 2.1.0
   type: :development
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: mocha
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 35
-        segments: 
-        - 0
-        - 9
-        - 12
+      - !ruby/object:Gem::Version
         version: 0.9.12
   type: :development
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+- !ruby/object:Gem::Dependency
   name: rcov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.9
+  type: :development
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 41
-        segments: 
-        - 0
-        - 9
-        - 9
+      - !ruby/object:Gem::Version
         version: 0.9.9
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id004
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
-email: 
+email:
 - matthew@playlouder.com
 - tom.chipchase@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - lib/wirer.rb
-- lib/wirer/construction_session.rb
 - lib/wirer/version.rb
-- lib/wirer/service.rb
+- lib/wirer/dependency.rb
+- lib/wirer/construction_session.rb
 - lib/wirer/errors.rb
+- lib/wirer/service.rb
 - lib/wirer/container.rb
+- lib/wirer/factory/interface.rb
 - lib/wirer/factory/class_mixins.rb
 - lib/wirer/factory/curried_dependencies.rb
 - lib/wirer/factory/wrapped.rb
 - lib/wirer/factory/from_instance.rb
-- lib/wirer/factory/interface.rb
 - lib/wirer/factory/from_args.rb
-- lib/wirer/dependency.rb
 - README.rb
 homepage: 
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: A lightweight dependency injection framework to help wire up objects in Ruby
 test_files: []
-