inheritance-helper 0.2.6 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31680a3ae280b81619d4eef1777f9821a4c47ef390225e56a4805b9686747fb9
-  data.tar.gz: 998ec788e4497c7e90870ece2d008dc76226344d7d24c0be408b7e6d4b859673
+  metadata.gz: 5d1e8987c76ed0af5063986813c435c9e755bce6f0d145ab7d63e9f0a35ba0f9
+  data.tar.gz: f1c481bd51c45d74e3e36a6e95fe656e29457fb489a9d99a1760539554577462
 SHA512:
-  metadata.gz: 47fc914a0bae8fedf35b01b0c9f4db8db002b1b1368d9bdaaf9b13a9ad537a5fc94a84900d652515874e6597acbd76f6d366bf50e2da6c798f9b756f89059333
-  data.tar.gz: 96f5b2c69b69ef9a8720b9c5db7f64aeb6cfb578516c2586a4bc57085b91700e393090872f986ebfbbd598ba26eb1578f7ec182fede9272e5bb887fa0362de8c
+  metadata.gz: c67b0fb5d1bbdcb65186c689c9e088739132de2cda3cc3d44ef51f131b868c64f73a4df073dfe8f4171257dedd4d8770af3dac7e47b451ca605574766c7add21
+  data.tar.gz: 7ef84095e953df92ee231e364ee9446e2020ee9f2d1fe9063c847bf389e13e594abe153c428669ef9f7e1f0ac00dd62b564790592fae2628622ffa80ee6cf386

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.3.0](https://github.com/dougyouch/inheritance-helper/compare/v0.2.6...v0.3.0) (2026-10-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* get_class_name no longer calls String#classify when ActiveSupport is loaded, so names are no longer singularized there (:line_items now gives LineItems, not LineItem). Class names are now the same whether or not ActiveSupport is loaded.
+
+### 1.0
+
+* clearer nil error, consistent class names, Ruby 3.3 ([#5](https://github.com/dougyouch/inheritance-helper/issues/5)) ([11bb5a8](https://github.com/dougyouch/inheritance-helper/commit/11bb5a8d056d7b6c2794895bd01c9d9bce14805d))
+
 ## [0.2.6](https://github.com/dougyouch/inheritance-helper/compare/v0.2.5...v0.2.6) (2026-10-05)
 
 

data/README.md

@@ -20,7 +20,7 @@ attribute definitions.
 
 ## Installation
 
-Requires Ruby 3.2 or newer. Add this line to your application's Gemfile:
+Requires Ruby 3.3 or newer. Add this line to your application's Gemfile:
 
 ```ruby
 gem 'inheritance-helper'
@@ -149,10 +149,38 @@ method keeps the visibility of the one it replaces, so a private class method st
 `InheritanceHelper::Methods.redefine_class_method(klass, method, value)` does the same for a class that
 doesn't extend the module.
 
+### Copy nested values before changing them
+
+Once a value is set with these helpers, every call returns the same object, and a subclass starts with its
+parent's object. Freezing covers only the top-level value: a hash or array *inside* it is shared by the parent
+and the subclass, so changing it in place changes both:
+
+```ruby
+class Base
+  extend InheritanceHelper::Methods
+
+  def self.config = {}.freeze
+
+  add_value_to_class_method :config, skip: []
+end
+
+class Child < Base
+  # wrong: appends to Base.config[:skip] too
+  config[:skip] << :logs
+
+  # right: build a new nested value and replace the key
+  add_value_to_class_method :config, skip: config[:skip] + [:logs]
+end
+```
+
+The same applies to a value from `redefine_class_method`: `dup` the value (and any nested values you change)
+before changing it, then pass the copy to `redefine_class_method`.
+
 ### Notes
 
 - The class method must already return a value: `add_value_to_class_method` and
-  `append_value_to_class_method` call it to get the current value.
+  `append_value_to_class_method` call it to get the current value, and raise a `TypeError` naming the method
+  when it returns `nil`.
 - Each call defines a method on the class's singleton class. Classes declared at load time (the usual DSL
   case) are fine; redefining class methods from several threads at once is not synchronized.
 
@@ -179,9 +207,9 @@ InheritanceHelper::ClassBuilder::Utils.get_class_name(:line_item, 'Has', 'Class'
 `nil`), assigns it to the constant in `base_module`, and evaluates the block in the new class. If the constant
 already exists it is replaced, with Ruby's "already initialized constant" warning.
 
-`get_class_name` uses `String#classify` when ActiveSupport is loaded, which also singularizes the name
-(`line_items` becomes `LineItem`). Without ActiveSupport the name is split on underscores and each part is
-capitalized (`line_items` becomes `LineItems`).
+`get_class_name` splits the name on underscores and capitalizes the first letter of each part, so
+`line_items` becomes `LineItems`. The result is the same whether or not ActiveSupport is loaded (before 1.0 it
+used `String#classify`, which singularized the name).
 
 ## Development
 

data/lib/inheritance-helper/class_builder/utils.rb

@@ -12,8 +12,8 @@ module InheritanceHelper
 
       # Builds a class name from `name` with an optional prefix and suffix.
       #
-      # `name` is converted with `String#classify` when ActiveSupport is loaded (which also singularizes it).
-      # Otherwise it is split on underscores and each part is capitalized.
+      # `name` is split on underscores and the first letter of each part is capitalized. The result doesn't depend
+      # on whether ActiveSupport is loaded, and the name isn't singularized (`:line_items` gives `"LineItems"`).
       #
       # @param name [String, Symbol] the base name, such as `:line_item`
       # @param prefix_class_name [String, nil] text to put before the converted name
@@ -22,15 +22,7 @@ module InheritanceHelper
       # @example
       #   get_class_name(:line_item, 'Schema', 'Class') # => "SchemaLineItemClass"
       def get_class_name(name, prefix_class_name, suffix_class_name)
-        name = name.to_s
-
-        class_name =
-          if name.respond_to?(:classify)
-            name.classify
-          else
-            name.split('_').map { |part| part.sub(/\A./, &:upcase) }.join
-          end
-
+        class_name = name.to_s.split('_').map { |part| part.sub(/\A./, &:upcase) }.join
         "#{prefix_class_name}#{class_name}#{suffix_class_name}"
       end
 

data/lib/inheritance-helper/methods.rb

@@ -80,11 +80,12 @@ module InheritanceHelper
     # @param method [Symbol, String] name of a class method that returns a Hash, Array or Set
     # @param value [Object] the value or values to add
     # @return [Module] this class
+    # @raise [TypeError] if the class method returns `nil`
     # @example
     #   add_value_to_class_method(:attributes, name: :string)  # {} => {name: :string}
     #   add_value_to_class_method(:fields, [:a, :b])           # [] => [:a, :b]
     def add_value_to_class_method(method, value)
-      old_value = send(method)
+      old_value = current_class_method_value(method)
 
       new_value =
         case old_value
@@ -106,12 +107,27 @@ module InheritanceHelper
     #   to `dup` and `<<`)
     # @param value [Object] the element to append
     # @return [Module] this class
+    # @raise [TypeError] if the class method returns `nil`
     # @example
     #   append_value_to_class_method(:callbacks, [:save, :log])  # [] => [[:save, :log]]
     def append_value_to_class_method(method, value)
-      old_value = send(method)
+      old_value = current_class_method_value(method)
       new_value = old_value.dup << value
       redefine_class_method(method, old_value.frozen? ? new_value.freeze : new_value)
     end
+
+    private
+
+    # @api private
+    # @param method [Symbol, String] name of the class method
+    # @return [Object] the method's current value
+    # @raise [TypeError] if the method returns `nil`
+    def current_class_method_value(method)
+      value = send(method)
+      return value unless value.nil?
+
+      raise TypeError, "#{self}.#{method} returned nil; define it to return a starting value such as {}.freeze " \
+                       'or [].freeze'
+    end
   end
 end

data/lib/inheritance-helper/version.rb

@@ -2,5 +2,5 @@
 
 module InheritanceHelper
   # Gem version, bumped by release-please
-  VERSION = '0.2.6'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inheritance-helper
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.3.0
 platform: ruby
 authors:
 - Doug Youch
@@ -42,7 +42,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="