sinject 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 84ae556b8e2fd2b90c6a6098c655a72133e3190c
-  data.tar.gz: d6994c60f60a5dad2d1cb7179c166c1255301585
+  metadata.gz: ae615b99554095a49b4dfdcc5a9a9ea78e4a08d1
+  data.tar.gz: 30d3a94b536b9144b89a6ec56f652f3f769421d0
 SHA512:
-  metadata.gz: bc23325620a024329a2acb4c49fe97fbed19e647353e943da931cb7c9ed900175ccfcd4dc2ced889a1366a35237f696933e3c401247693b841435be9c491ea7b
-  data.tar.gz: 1e8ba21b96980fbd99b62a18f59cb28b6c9f0549301a8882b09255262ec0ccdbc89a1b30e8d652748fd8c659883dd49cdd89dbb6789403ca99c4df056118bcb5
+  metadata.gz: c4087a95afe29888fcb5a2a80a9c8171a762e82ce1be89fae688f35fa97615d20ada0e325ce7bbc2840a1d6335109f242561f5b92a8e802133ee925c3ee31aeb
+  data.tar.gz: fb588c3e58110e11bcb3bb3e38c69b7d14a80499b1fb03a605e97f0079fda8d949e97dfc480a94ff4a606ab89be3715651f8858ca073022d3bef5c594b502be5

data/README.md

@@ -56,7 +56,7 @@ Dependencies with a custom initialization block must return an object of the reg
 
 **Dependency Contracts**
 
-Dependency contracts can be defined to validate registered dependencies are valid for the task they are being registered for.
+Dependency contracts can be defined to validate registered dependencies are valid for the task they are being registered for. *(If you are familiar with other type based languages then you can think of this as a kind of Interface)*
 
 To create a dependency contract you need to create a new class with empty methods for each of the methods that the dependency needs to respond to in order to fulfill it's role:
 
@@ -75,6 +75,27 @@ Sinject will then validate that the registered dependency meets the requirements
 - `DependencyContractMissingMethodsException` is raised when 1 or more methods from the contract could not be found on the dependency.
 - `DependencyContractInvalidParametersException` is raised when the parameters of a contract method do not match the parameters found on a dependency method.
 
+**Dependency Groups**
+
+Dependency registrations groups can be created to allow groups of dependencies to be set without the need for manual registration *(e.g. to include with a gem for auto registration)*, or to allow different dependency groups to bd loaded in different circumstances *(e.g. per environment)*.
+
+To create a dependency group create a class that inherits from the DependencyGroup base class and implement the *'register'* & *'is_valid'* methods.
+
+For example:
+
+    #create a development only dependency group
+    class DevelopmentDependencies < DependencyGroup
+        def register(container)
+            container.register(:cache_store, LocalCacheStore, true)
+            container.register(:logger, TerminalLogger, true)
+        end
+        
+        def is_valid?
+            Rails.env.development?
+        end
+    end
+
+Only dependency groups that return **True** from the is_valid? method will be loaded.
 
 **Assigning dependencies**
 

data/lib/sinject.rb

@@ -85,6 +85,15 @@ class SinjectContainer
     end
   end
 
+  def load_groups
+    DependencyGroup.descendants.each do |g|
+      group = g.new
+      if group.is_valid?
+        group.register(SinjectContainer.instance)
+      end
+    end
+  end
+
   private
 
   def validate_contract(dependency_class, contract_class)
@@ -205,3 +214,19 @@ class DependencyInitializeException < StandardError
   end
 
 end
+
+class DependencyGroup
+
+  def register(container)
+
+  end
+
+  def is_valid?
+    return true
+  end
+
+  def self.descendants
+    ObjectSpace.each_object(Class).select { |klass| klass < self }
+  end
+
+end

data/lib/sinject/version.rb

@@ -1,3 +1,3 @@
 module Sinject
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sinject
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - vaughan britton
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-02-09 00:00:00.000000000 Z
+date: 2016-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler