template_class 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d10dcbdc76cd1f1ffddb70a98ee133e5686acb67ce73583715aeeaa9b10d4e70
-  data.tar.gz: 5f293dcd3eaf2e54882052e83f2eef8abd2c1fa71792a38f27cd688cbb641072
+  metadata.gz: e4c0985a84c4d73b07449fea319cd108c0a78477fa0975a0a946dcb82d05dbda
+  data.tar.gz: 35cc326a7341985c9d3a416fcad8b58a9465f4e72a083d7c4e9d153ed4f312d4
 SHA512:
-  metadata.gz: d536399259e30cc20e4c6352410092aed9b4044a7ab42d4fcfab77b82589d25e64a66a9cccd073da9fbf01a022276e05c4b0acf5afa46dc9e94dc5c04ab94f3d
-  data.tar.gz: 3ba7a56886ab200f11f827b2078ffb8994b01456215cc6ff8c0c3d45475da06a2d2c19018d1f1f9af6005d190c1c326e1d3a29846b168b2e847a4b7888ad8a71
+  metadata.gz: 1cc67fea8a072fd2fcf64a7bb7b17d22ae801b1547dd92cccd27a0e6f4c939870b032112bf845dc0974d8860d797f4e12c104f19437be369de70e8d0009ff21a
+  data.tar.gz: f756b227610d4503557b949dde1ed5f908fac9da1f3353a7dd55a7772f84e145eb419a1fad568f0a497d08d772a29a340b20fc839910ceee92baeedda9cc8065

data/CHANGELOG.md

@@ -8,6 +8,12 @@
 ### Bug fixes
 )-->
 
+## 1.2.0 2024-08-19
+
+### New features
+
+- Bulk instantiation
+
 ## 1.1.0 2023-08-31
 
 ### New features

data/README.md

@@ -82,6 +82,32 @@ List[:any] = Array
 
 Notice that the parameter isn't constrained to classes: you can use any object.
 
+### Bulk Instantiation
+
+A module (or class) containing multiple templates can include `TemplateClass::BulkInstanceable` to be able to instantiate them in bulk using the same parameter.
+
+```ruby
+module Templates
+  include TemplateClass::BulkInstantiable
+  
+  class Template1
+    ...
+  end
+  
+  class Template2
+    ...
+  end
+end
+
+module Instances
+  Templates.bulk_instance Integer, into: self
+end
+```
+
+The new constants `Instances::Template1` and `Instances::Template2` are now defined, and they point respectively to `Templates::Template1[Integer]` and `Templates::Template2[Integer]`.
+
+The optional keyword argument `with_overrides`, which defaults to `true` if `Zeitwerk` is defined and to `false` otherwise, allows you to automatically access and reopen the instances in files that follow the Zeitwerk naming conventions (eg. you can reopen `Instances::Template1` in the file `instances/template1.rb`). If `with_overrides` is `false`, you can still reopen the instances, but you need to manually handle the appropriate `requires` in the appropriate order.
+
 ## Plans for future development
 
 - Multiple specialization parameters

data/lib/template_class/bulk_instantiable.rb

@@ -0,0 +1,21 @@
+module TemplateClass
+  module BulkInstantiable
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def bulk_instantiate(*args, into:, with_overrides: defined?(Zeitwerk))
+        constants(false)
+          .map { |constant_name| const_get(constant_name) }
+          .map do |constant|
+            into.const_set constant.name.demodulize.to_sym, constant[*args]
+          end
+          .tap { return unless with_overrides } # rubocop:disable Lint/NonLocalExitFromIterator
+          .each do |instance|
+            require instance.name.underscore
+          rescue LoadError
+            nil
+          end
+      end
+    end
+  end
+end

data/lib/template_class/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TemplateClass
-  VERSION = '1.1.0'
+  VERSION = '1.2.0'
 end

data/lib/template_class.rb

@@ -1,2 +1,3 @@
 require_relative 'template_class/version'
 require_relative 'template_class/template'
+require_relative 'template_class/bulk_instantiable'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: template_class
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Moku S.r.l.
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-08-31 00:00:00.000000000 Z
+date: 2024-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -47,6 +47,7 @@ files:
 - README.md
 - Rakefile
 - lib/template_class.rb
+- lib/template_class/bulk_instantiable.rb
 - lib/template_class/template.rb
 - lib/template_class/version.rb
 - sig/lib/template_class/template.rbs
@@ -72,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.6
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: A way to define templated classes, in a similar fashion to C++ templates.