inoculate 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2649bf406a68234451cc147c069a8b9d58ce91d2a1538e728a532ff4abda2180
-  data.tar.gz: 3bf808d9e35467647432ed7d74cab98e669a41f7e887e889735c8d583844eaf7
+  metadata.gz: 7bd8610b9bbde1304734505a64fdf22c8665961e3b02d93171ac4fc6ccf313aa
+  data.tar.gz: 66ee174fa4bd02dfd671a39a946a8343da1d63bb88f9be05ee94816d033a5e4e
 SHA512:
-  metadata.gz: ff27ab41b2f2da2cc6ebf22e434c88b626b9b0c2bf6dab505a9baa1a777faf82c60512a44bb258e19bf0ceb71315b0f0123ab724d6dcb65dfb0468d3d9cf7b35
-  data.tar.gz: 23212f8eeb9dc79c159651ebebc93d4ca13ad7623aa2d85622fe8de7b64f993880db5837e51a072f9116bffc169f02030b0676247f1befb254e86023443436ed
+  metadata.gz: bbc2655324e68cd2ad977192b81f9cbef0d63b72da91f05521c59eb91f1d58993da68dbcd8d4f6b69be5e5d93708e847f567955f80cb042761e187b64c1bcdbc
+  data.tar.gz: ef316f9b6e6dfa9cd42811f8af5082f402d0c03478a280a2728b61ce9c706a9e0b1cd0249921d18818cfa85b28ccf81969a1330744c3d8d19e95e5fd4f73a81c

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## v0.4.0 \[Unreleased]
+
+* Add singleton dependency registration.
+
 ## v0.3.0 \[2022-10-11]
 
 * Add instance dependency registration.

data/README.md

@@ -25,6 +25,7 @@ It provides several life-cycles and provides dependency access through private a
    1. [Dependency Life Cycles](#dependency-life-cycles)
       1. [Transient](#transient)
       2. [Instance](#instance)
+      3. [Singleton](#singleton)
    2. [Renaming the Declaration API](#renaming-the-declaration-api)
    3. [Hide Your Dependency on Inoculate](#hide-your-dependency-on-inoculate)
 3. [Installation](#installation)
@@ -100,13 +101,16 @@ class Example
    end
 end
 
-puts Example.new
+a = Example.new
+puts a, a, a
 ```
 
 This results in:
 
 ```
 Count is: 0
+Count is: 0
+Count is: 0
 => nil    
 ```
 
@@ -158,6 +162,54 @@ This results in:
 => nil  
 ```
 
+#### Singleton
+Singleton dependencies are constructed once.
+
+```ruby
+class Counter
+   attr_reader :count
+
+   def initialize
+      @count = 0
+   end
+   
+   def inc
+      @count += 1
+   end
+end
+
+Inoculate.initialize do |config|
+   config.singleton(:counter) { Counter.new }
+end
+
+class Example
+   include Inoculate::Porter
+   inoculate_with :counter
+   
+   def initialize(name)
+      @name = name
+   end
+   
+   def to_s
+      counter.inc
+      "[#{@name}] Count is: #{counter.count}"
+   end
+end
+
+a = Example.new("a")
+b = Example.new("b")
+puts a, a, b
+```
+
+This results in:
+
+```
+[a] Count is: 1
+[a] Count is: 2                         
+[b] Count is: 3                         
+=> nil   
+```
+
 ### Renaming the Declaration API
 The `inoculate_with` API is named to avoid immediate collisions with other modules
 and code you may have. You can use it as-is, or rename it to something you see fit

data/lib/inoculate/configurer.rb

@@ -27,6 +27,15 @@ module Inoculate
       nil
     end
 
+    # Register a singleton dependency.
+    # @see Manufacturer#singleton
+    #
+    # @since 0.4.0
+    def singleton(name, &block)
+      manufacturer.singleton(name, &block)
+      nil
+    end
+
     private
 
     attr_reader :manufacturer

data/lib/inoculate/manufacturer.rb

@@ -5,7 +5,6 @@ require "digest"
 module Inoculate
   # Registers and builds dependency injection modules.
   # @todo singleton life cycle
-  # @todo instance life cycle
   # @todo thread singleton life cycle
   #
   # @since 0.1.0
@@ -40,16 +39,7 @@ module Inoculate
     #
     # @since 0.1.0
     def transient(name, &block)
-      validate_dependency_name name
-      raise Errors::AlreadyRegistered if @registered_blueprints.has_key? name
-      raise Errors::RequiresCallable if block.nil?
-
-      blueprint_name = name.to_sym
-      @registered_blueprints[blueprint_name] = {
-        lifecycle: :transient,
-        factory: block,
-        accessor_module: build_module(blueprint_name, :transient, block)
-      }
+      register_blueprint(name, :transient, &block)
     end
 
     # Register an instance dependency.
@@ -72,26 +62,54 @@ module Inoculate
     #
     # @since 0.3.0
     def instance(name, &block)
+      register_blueprint(name, :instance, &block)
+    end
+
+    # Register a singleton dependency.
+    #
+    # A singleton dependency gets created once.
+    #
+    # @example With a block
+    #   manufacturer.singleton(:sha1_hasher) { Digest::SHA1.new }
+    #
+    # @example With a Proc
+    #   manufacturer.singleton(:sha1_hasher, &-> { Digest::SHA1.new })
+    #
+    # @param name [Symbol, #to_sym] the dependency name which will be used to access it
+    # @param block [Block, Proc] a factory method to build the dependency
+    #
+    # @raise [Errors::RequiresCallable] if no block is provided
+    # @raise [Errors::InvalidName] if the name is not a symbol, cannot be converted to a symbol,
+    #                              or is not a valid attribute name
+    # @raise [Errors::AlreadyRegistered] if the name has been registered previously
+    #
+    # @since 0.4.0
+    def singleton(name, &block)
+      register_blueprint(name, :singleton, &block)
+    end
+
+    private
+
+    def register_blueprint(name, lifecycle, &block)
       validate_dependency_name name
       raise Errors::AlreadyRegistered if @registered_blueprints.has_key? name
       raise Errors::RequiresCallable if block.nil?
 
       blueprint_name = name.to_sym
       @registered_blueprints[blueprint_name] = {
-        lifecycle: :instance,
+        lifecycle: lifecycle,
         factory: block,
-        accessor_module: build_module(blueprint_name, :instance, block)
+        accessor_module: build_module(blueprint_name, lifecycle, block)
       }
     end
 
-    private
-
     def build_module(name, lifecycle, factory)
-      module_name = "I#{Digest::SHA1.hexdigest(name.to_s)}"
+      module_name = "I#{hash_name(name)}"
       module_body =
         case lifecycle
         when :transient then build_transient(name, factory)
         when :instance then build_instance(name, factory)
+        when :singleton then build_singleton(name, factory)
         else raise ArgumentError, "Life cycle #{lifecycle} is not valid. Something has gone very wrong."
         end
 
@@ -105,7 +123,7 @@ module Inoculate
     end
 
     def build_instance(name, factory)
-      cache_variable_name = "@icache_#{Digest::SHA1.hexdigest(name.to_s)}"
+      cache_variable_name = "@icache_#{hash_name(name)}"
       Module.new do
         define_method(name) do
           instance_variable_set(cache_variable_name, factory.call) unless instance_variable_defined?(cache_variable_name)
@@ -115,6 +133,17 @@ module Inoculate
       end
     end
 
+    def build_singleton(name, factory)
+      cache_variable_name = "@@icache_#{hash_name(name)}"
+      Module.new do |mod|
+        define_method(name) do
+          mod.class_variable_set(cache_variable_name, factory.call) unless mod.class_variable_defined?(cache_variable_name)
+          mod.class_variable_get(cache_variable_name)
+        end
+        private name
+      end
+    end
+
     def validate_dependency_name(name)
       raise Errors::InvalidName, "name must be a symbol or convert to one" unless name.respond_to? :to_sym
       begin
@@ -123,5 +152,9 @@ module Inoculate
         raise Errors::InvalidName, "name must be a valid attr_reader"
       end
     end
+
+    def hash_name(name)
+      Digest::SHA1.hexdigest(name.to_s)
+    end
   end
 end

data/lib/inoculate/version.rb

@@ -2,5 +2,5 @@
 
 module Inoculate
   # The library version.
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/sig/inoculate.rbs

@@ -34,6 +34,7 @@ module Inoculate
     attr_reader registered_blueprints: Hash[builder_name, blueprint]
     def transient: (builder_name | _ToSymbol) { () -> void } -> void
     def instance: (builder_name | _ToSymbol) { () -> void } -> void
+    def singleton: (builder_name | _ToSymbol) { () -> void } -> void
   end
 
   class Configurer
@@ -41,6 +42,7 @@ module Inoculate
 
     def transient: (builder_name | _ToSymbol) { () -> void } -> nil
     def instance: (builder_name | _ToSymbol) { () -> void } -> nil
+    def singleton: (builder_name | _ToSymbol) { () -> void } -> nil
 
     private
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inoculate
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Stephan Tarulli
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-12 00:00:00.000000000 Z
+date: 2022-10-13 00:00:00.000000000 Z
 dependencies: []
 description: |
   Inoculate is a small, thread-safe dependency injection library configured entirely with Ruby.