template_class 1.1.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d10dcbdc76cd1f1ffddb70a98ee133e5686acb67ce73583715aeeaa9b10d4e70
-  data.tar.gz: 5f293dcd3eaf2e54882052e83f2eef8abd2c1fa71792a38f27cd688cbb641072
+  metadata.gz: 7009ef2378c645609f8d669f09a1a5f348c598740ebe3593c09b0789cc87ed38
+  data.tar.gz: 872c47796a2c4c5d4c972ca73327a14ee8bc4a373b594dfbce2d75e616a7b56e
 SHA512:
-  metadata.gz: d536399259e30cc20e4c6352410092aed9b4044a7ab42d4fcfab77b82589d25e64a66a9cccd073da9fbf01a022276e05c4b0acf5afa46dc9e94dc5c04ab94f3d
-  data.tar.gz: 3ba7a56886ab200f11f827b2078ffb8994b01456215cc6ff8c0c3d45475da06a2d2c19018d1f1f9af6005d190c1c326e1d3a29846b168b2e847a4b7888ad8a71
+  metadata.gz: 575c196c51373ac4b20980f177a85427c25032f297681739963df69d22c76d40848aa20f76c115533cd5c4ebbe41eda4873bd48f88ae2ab7570ae896bae77aa4
+  data.tar.gz: f789d966d43c6d82f1d5e367f6f114815ce4d347cf8246b813229835200f94cdaa843f4e3ac3fad04c4bdea7bd2791ed71231ba90c5ad25ec6692d08670801d0

data/CHANGELOG.md

@@ -8,6 +8,18 @@
 ### Bug fixes
 )-->
 
+## 1.2.1 2025-01-20
+
+### Bug fixes
+
+- Relaxed dependency.
+
+## 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.1'
 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'

data/template_class.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative 'lib/template_class/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'template_class'
+  spec.version = TemplateClass::VERSION
+  spec.authors = ['Moku S.r.l.', 'Riccardo Agatea']
+  spec.email = ['info@moku.io']
+  spec.license = 'MIT'
+
+  spec.summary = 'A way to define templated classes, in a similar fashion to C++ templates.'
+  spec.description = 'In most cases Ruby doesn\'t need templated classes, nor any other system of generics, because it isn\'t statically type checked. However, sometimes we need to automatically generate multiple similar classes, either because of poor design or because of external necessities. For example, to define a GraphQL schema with GraphQL Ruby (https://graphql-ruby.org/) we need to define a distinct class for each type. Since GraphQL is statically type checked but doesn\'t provide generics, if we need a set of similar but distinct types we\'re left to define them one by one.'
+  spec.homepage = 'https://github.com/moku-io/template_class'
+  spec.required_ruby_version = '>= 3.0.0' # Maybe we should check (?)
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/moku-io/template_class'
+  spec.metadata['changelog_uri'] = 'https://github.com/moku-io/template_class'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir __dir__ do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'activesupport'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: template_class
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Moku S.r.l.
@@ -9,22 +9,22 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-08-31 00:00:00.000000000 Z
+date: 2025-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 7.0.0
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 7.0.0
+        version: '0'
 description: In most cases Ruby doesn't need templated classes, nor any other system
   of generics, because it isn't statically type checked. However, sometimes we need
   to automatically generate multiple similar classes, either because of poor design
@@ -47,9 +47,11 @@ 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
+- template_class.gemspec
 homepage: https://github.com/moku-io/template_class
 licenses:
 - MIT
@@ -72,7 +74,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.6
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A way to define templated classes, in a similar fashion to C++ templates.