infusible 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ead948e6538cdc8e066bc32341bde9763b3142993cda89a2f3e757bd43cc23f
-  data.tar.gz: c75f2bfe1ea6c13340844d51373a9e82241aee398a2dd29184081520c6381c7b
+  metadata.gz: aead1f7ed51f9d27432c30d1eed5281acf00492d0d3a28122bbea6c816c76c5f
+  data.tar.gz: e24374e305cc022c120fcb914631691cc7a0f0a7acbad0d438da0ef5958786d5
 SHA512:
-  metadata.gz: f6609b17d274e75e300c6867310639bb074455af38c0212e988bdf46e7c30e650a0a8000732d067462d2d73162e020a32c84e65e177ea1d2404ceb5e909e84a8
-  data.tar.gz: 46fee24a8fb9a5817139effbb467f66cd13fb03b812ae499423c94695227d6cea24f0cae905c72e99e19744614e4a050018cae5def3e7ba225e8cb57ad175401
+  metadata.gz: a78bd3911d1f83ab17f8cf1f4b814ef1b5790b3cdeb7ac5c3ae8823c87a7b662c8926ff158251cd9ab184cc540e7dde6410a424b9c19f07c35c24d3246a67f04
+  data.tar.gz: 5a5e117cf6173e932aeafb1126e40dae5297fcb86acd87d6daa55b4adebeae29b7b0d382bc17f32431ee5fab01977d4d758130376fa97d7ceb696ec021822eb1

data/README.adoc

@@ -326,6 +326,40 @@ demo.two    # NoMethodError: protected method.
 demo.three  # NoMethodError: private method.
 ----
 
+==== Infused Keys
+
+You have access to the keys of all infused dependencies via the _private_ `infused_keys` method which can be powerful in metaprogramming situations. For example, consider the following, which calls all injected dependencies since they have the same Object API (i.e. `#call`):
+
+Example:
+
+[source,ruby]
+----
+module Container
+  extend Dry::Container::Mixin
+
+  register(:one, proc { puts "One" }, call: false)
+  register(:two, proc { puts "Two" }, call: false)
+end
+
+Import = Infusible.with Container
+
+class Demo
+  include Import[:one, :two]
+
+  def call = infused_keys.each { |key| __send__(key).call }
+end
+
+Demo.new.call
+# One
+# Two
+----
+
+As you can see, with the _private_ `#infused_keys` attribute reader, we were able to iterate through each infused key and send the `#call` message to each injected dependency.
+
+Since `#infused_keys` is a private attribute reader, this means the infused keys are private to each instance. This includes all ancestors when using inheritance as each super class in the hierarchy will have it's own unique array of infused keys depending on what was injected for that object.
+
+All infused keys are frozen by default.
+
 === Tests
 
 As you architect your implementation, you'll want to test your injected dependencies. You'll also want to stub, mock, or spy on them as well. Testing support is built-in for you by only needing to require the stub refinement as provided by this gem. For demonstration purposes, I'm going to assume you are using RSpec but you can adapt for whatever testing framework you are using.

data/infusible.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "infusible"
-  spec.version = "3.0.0"
+  spec.version = "3.1.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/infusible"

data/lib/infusible/constructor.rb

@@ -7,6 +7,10 @@ module Infusible
   # :reek:TooManyInstanceVariables
   class Constructor < Module
     def self.define_instance_variables target, names, keywords
+      unless target.instance_variable_defined? :@infused_keys
+        target.instance_variable_set :@infused_keys, names
+      end
+
       names.each do |name|
         next unless keywords.key?(name) || !target.instance_variable_defined?(:"@#{name}")
 
@@ -94,6 +98,7 @@ module Infusible
       computed_scope = METHOD_SCOPES.include?(scope) ? scope : :private
 
       instance_module.module_eval <<-READERS, __FILE__, __LINE__ + 1
+        attr_reader :infused_keys
         #{computed_scope} attr_reader #{methods.join ", "}
       READERS
     end

data/lib/infusible/dependency_map.rb

@@ -11,13 +11,12 @@ module Infusible
       @patterns = patterns
       @collection = {}
 
-      configuration = configuration.dup
       aliases = configuration.last.is_a?(Hash) ? configuration.pop : {}
 
       configuration.each { |identifier| add to_name(identifier), identifier }
       aliases.each { |name, identifier| add name, identifier }
 
-      @names = collection.keys
+      @names = collection.keys.freeze
     end
 
     def to_h = collection

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: infusible
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-01-01 00:00:00.000000000 Z
+date: 2024-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: marameters
@@ -110,7 +110,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.4
 signing_key:
 specification_version: 4
 summary: An automated dependency manager and injector.