dumpling 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b5d404a4a72ad2d88b92a4008aa5c875e52d6413
-  data.tar.gz: 492a47199347c218b0cb6b5cb3dad15a95695af6
+  metadata.gz: f385ef8e4373fe02d5a641294ad7cbc0393843db
+  data.tar.gz: e800048ab2616729db0086867caf77ea32ab5be3
 SHA512:
-  metadata.gz: 968bb215aa7e4f57291e65c32623107c1754add1860cc5fac55c14ffa9ce90e01969383d0ab21c2b0b2214214e15d00c90968c3b39e21425e5dbe4bf03e66a5c
-  data.tar.gz: 17530a9342d58289fec18806a023c4c6057bf8dc4eb15cad8f4c8c2aaa8facf25e9c98fa9bfcb62dfd39cc09bcff0cdd922decab655ed603e67ab7ea48aaaac7
+  metadata.gz: b5a86fc3c310dd05bb3c9c4f498126f7b43b293d8296c6a288128923e530ea32a57dc765a8e89ec973f2486af64201f95e755cd196f5cdcc1534ac4e1d1dfc5b
+  data.tar.gz: cea6309abeae32d6d34f133c652071de233b7a1db0ba7270cb36355df96acbf6bde7e1f0d70b14ae650eeefb2c4d609ed45ed4144da01ef50fcdff4cacb3153e

data/README.md

@@ -36,6 +36,10 @@ Or install it yourself as:
 
 ### Basics
 
+Use ```instance``` for long-lived objects. ```#get``` returns the same instance at each call
+
+Use ```class``` for short-lived objects. ```#get``` returns a new instance on every call
+
 ```ruby
 class UsersRepository
   attr_writer :logger
@@ -52,11 +56,11 @@ Dumpling.configure do
   end
 end
 
-# Every time you invoke the #get method you will get a new instance of the #class
+# Every time you invoke the #get method you get a new instance of the #class
 Dumpling.get(:users_repository) # => #<UsersRepository:0x00000000ebee20>
 Dumpling.get(:users_repository) # => #<UsersRepository:0x00000000e8a8f0>
 
-# Every time you invoke the #get method you will get the same predefined #instance
+# Every time you invoke the #get method you get the same predefined #instance
 Dumpling.get(:logger) # => #<Logger:0x00000000e281a0>
 Dumpling.get(:logger) # => #<Logger:0x00000000e281a0>
 ```
@@ -133,27 +137,56 @@ end
 ```
 
 ### Defining abstract services
+Abstract service cannot be instantiated (accessed outside of the container). Whenever you include an abstract service into a regular service, you inherit its dependencies.
 
 ```ruby
 container = Dumpling::Container.new
 container.configure do
   abstract :repository do |s|
-    s.dependency :logger
-    s.dependency :persistence_adapter
+    s.dependency :logger # => #<Logger:0x00000000e281a0>
+    s.dependency :persistence_adapter # => #<Sequel:0x00000000e281a0>
   end
 
   set :users_repository do |s|
     s.class UsersRepository
     s.include :repository
   end
+end
+
+container[:users_repository].logger # => #<Logger:0x00000000e281a0>
+container[:users_repository].persistence_adapter # => #<Sequel:0x00000000e281a0>
 
+container.configure do
   set :posts_repository do |s|
     s.class PostsRepository
     s.include :repository
     # overriding dependencies
-    s.dependency :postgres_adapter, attribute: :persistence_adapter
+    s.dependency :postgres_adapter, attribute: :persistence_adapter # => #<PG:0x00000000e281a0>
+  end
+end
+
+container[:users_repository].persistence_adapter # => #<PG:0x00000000e281a0>
+```
+
+### Duplicating a container
+
+```ruby
+original = Dumpling::Container.new
+original.configure do
+  set :logger do |s|
+    s.instance Logger.new(STDOUT)
   end
 end
+
+duplicate = original.dup
+duplicate.get(:logger).equal?(original.get(:logger)) # => true
+
+# Changes in the original container do not affect the duplicate and vise versa
+original.set :game do |s|
+  s.instance 'Tetris'
+end
+
+duplicate.get(:game) # => BOOM! raise Dumpling::Errors::Container::Missing
 ```
 
 ## Development

data/dumpling.gemspec

@@ -21,6 +21,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler', '~> 1.11'
   spec.add_development_dependency 'rake', '~> 11.1'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'rubocop', '~> 0.39.0'
+  spec.add_development_dependency 'rubocop', '~> 0.40.0'
   spec.add_development_dependency 'simplecov', '~> 0.11'
 end

data/lib/dumpling/container.rb

@@ -5,11 +5,6 @@ module Dumpling
       @abstract_services = Registry.new
     end
 
-    def configure(&block)
-      instance_eval(&block)
-      self
-    end
-
     def set(id, &block)
       raise(Errors::Container::Duplicate, id) if @services.has?(id)
 
@@ -35,6 +30,26 @@ module Dumpling
 
     alias :[] get
 
+    def configure(&block)
+      instance_eval(&block)
+      self
+    end
+
+    def initialize_dup(original)
+      @services = original.services.dup
+      @abstract_services = original.abstract_services.dup
+      super
+    end
+
+    def inspect
+      services = @services.keys.sort.map { |id| inspect_service(id) }
+      services.empty? ? to_s : "#{self}\n#{services.join("\n").strip}"
+    end
+
+    protected
+
+    attr_reader :services, :abstract_services
+
     private
 
     def create_specification
@@ -63,5 +78,22 @@ module Dumpling
     def build_service(specification)
       ServiceBuilder.new(@services, @abstract_services).build(specification)
     end
+
+    def inspect_service(id)
+      service = @services.get(id)
+      string = id.to_s
+      string << inspect_service_object(service.instance, service.class).to_s
+      string << inspect_service_dependencies(service.dependencies).to_s
+    end
+
+    def inspect_service_object(service_instance, service_class)
+      service_object = (service_instance.nil? ? service_class.inspect : service_instance.inspect)
+      "\n --> #{service_instance.nil? ? 'class' : 'instance'}: #{service_object}"
+    end
+
+    def inspect_service_dependencies(dependencies)
+      dependencies = dependencies.keys.join(',')
+      "\n --> dependencies: #{dependencies}" unless dependencies.empty?
+    end
   end
 end

data/lib/dumpling/registry.rb

@@ -21,5 +21,15 @@ module Dumpling
     def has?(id)
       @keys.include?(id)
     end
+
+    def initialize_dup(original)
+      @data = original.data.dup
+      @keys = original.keys.dup
+      super
+    end
+
+    protected
+
+    attr_reader :data
   end
 end

data/lib/dumpling/version.rb

@@ -2,7 +2,7 @@ module Dumpling
   module Version
     MAJOR = 0
     MINOR = 3
-    TINY = 1
+    TINY = 2
     PRE = nil
 
     STRING = [MAJOR, MINOR, TINY, PRE].compact.join('.').freeze

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dumpling
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Anton Kuzmenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-02 00:00:00.000000000 Z
+date: 2016-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.39.0
+        version: 0.40.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.39.0
+        version: 0.40.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement