initable 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96778d9b0314485a1c240e2c5ef7867df42092d4f906e794ec54097de2c6de93
-  data.tar.gz: 6b3619194eb1d9767e80ad31e13a7037fe10542c7b497a14df77ad7f04dade71
+  metadata.gz: b96c20f52e4c77200bfcacac75117f047fa0db27cd6141983d9c943177bc4254
+  data.tar.gz: '08bbff632d906c472eaa08d9ef8cf606c30b43364627e96fca6529fcc519d798'
 SHA512:
-  metadata.gz: ddabf5ef26a500fd501f59a89a6a7dc370b00136206737a14f534ee72fb7dce5ce58848b7c03985952c66212e6d53cfa1ce8882acefd7d36ca23befb1f070acc
-  data.tar.gz: 65e7d06a70d8f00f24b5b3edc7b4ccaf6672e7a357533c38991f7f4ea1619c5a9411b673f26d95444ba5530642e03c1ed0a339d4eeba2bdd47091e4cd7c1252c
+  metadata.gz: a99a16902d533a924f3144c1766e8c53d28e6af36ca4fb11511769c28640ef0d87a7e3f080358d9f3d533f6f4f025e9e9aaba1baf9fb79a764390938e1c4e159
+  data.tar.gz: 15d7caa01e8645f621a06907bdd866a5dbd495d9f2f71ab8e6d332d2fe7df98bcac71c270a69b4ac1a1a246a491941533f3e323dc4552141449fd3b8d221fc2c

data/README.adoc

@@ -129,7 +129,7 @@ There are eight _kinds_ of parameters you can use in method signatures as suppor
 [<kind>, <name>, <default>]
 ----
 
-💡 The default (third element) is always optional which, granted, isn't supported by {method_parameters_link} but is part of this DSL so you can supply a default value for optional positional or keyword parameters with minimal effort.
+💡 The default (third element) is always optional and isn't supported by {method_parameters_link} but is part of this DSL so you can supply a default value for optional positional or keyword parameters with minimal effort.
 
 As detailed in the {method_parameters_and_arguments_link} article, the order of each kind of parameter matters because if you define them out of order, you'll get a syntax error as you would get when not using this gem to initialize an object. For reference, here's the natural order of parameters for a method signature in case it helps:
 
@@ -316,6 +316,45 @@ end
 
 This is useful when needing to forward a block to the super class.
 
+=== Keywords
+
+As an added convenience, you can use keywords in addition to positional arguments when initializing your class. Example:
+
+[source,ruby]
+----
+demo = Class.new do
+  include Initable[one: 1, two: 2]
+end
+
+demo.new  #<#<Class:0x0000000135753678>:0x0000000136091f00 @one=1, @two=2>
+----
+
+The above is identical to the following but with more typing:
+
+[source,ruby]
+----
+demo = Class.new do
+  include Initable[[:key, :one, 1], [:key, :two, 2]]
+end
+
+demo.new  #<#<Class:0x0000000136f1ef78>:0x00000001518775b0 @one=1, @two=2>
+----
+
+You can also combine positionals with keywords:
+
+[source,ruby]
+----
+demo = Class.new do
+  include Initable[%i[req one], [:key, :two, 2], three: 3]
+end
+
+demo.new 1  # #<#<Class:0x0000000136ede9c8>:0x0000000151ebab98 @one=1, @two=2, @three=3>
+----
+
+⚠️ As with default `+#initialize+` behavior, ensure you don't duplicate parameter names to avoid naming collisions.
+
+In most cases, you'll want to use xref:_parameters[Parameters] as documented earlier. Otherwise, this is a nice way to initialize with safe defaults or utilize lightweight dependency injection without reaching for {infusible_link} when you don't need a full fledged {containable_link} container.
+
 === Defaults
 
 You've already seen you can provide a third element for defaults with optional positional and keyword parameters. Sometimes, though, you might want to use a more complex object as a default (especially if you want the default to be lazy loaded/initialized). For those situations use a `Proc`. Example:
@@ -325,12 +364,17 @@ You've already seen you can provide a third element for defaults with optional p
 demo = Class.new do
   include Initable[
     [:opt, :one, proc { %w[O n e].join }],
-    [:key, :two, proc { Object.new }]
+    [:key, :two, proc { Object.new }],
+    three: proc { StringIO.new }
   ]
 end
 
 demo.new
-#<#<Class:0x00000001532d4390>:0x0000000153a9b0b0 @one="One", @two=#<Object:0x0000000153a9ade0>>
+# <#<Class:0x00000001532d4390>:0x0000000153a9b0b0
+#    @one="One",
+#    @two=#<Object:0x000000012f89b108>,
+#    @three=#<StringIO:0x000000012fe361f8>
+# >
 ----
 
 Notice, for the `one` optional positional parameter, we get a default value of `"One"` once evaluated. For the `two` optional keyword parameter, we get a new instance of `Object` as a default value.
@@ -340,6 +384,7 @@ Notice, for the `one` optional positional parameter, we get a default value of `
 * Use procs because lambdas will throw a `TypeError`.
 * Use procs _with no arguments_ because only the body of the `Proc` is parsed. Otherwise, you'll get an `ArgumentError`.
 * Ensure each parameter -- with a default -- is defined on a distinct line because the body of the `Proc` is extracted at runtime from the source location of the `Proc`. The goal is to improve upon this further once Ruby link:https://bugs.ruby-lang.org/issues/21005[adds] source location with line start, line end, column start, and column end information.
+* This does not work consistently in IRB due to the above mentioned Ruby issue.
 
 === Barewords
 

data/initable.gemspec

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

data/lib/initable/builder.rb

@@ -4,14 +4,13 @@ require "marameters"
 
 module Initable
   # Builds initialization behavior.
-  # :reek:TooManyInstanceVariables
   class Builder < Module
-    def initialize *parameters, scope: :private, marameters: Marameters
+    def initialize *parameters, method_scope: :private, **keywords
       super()
+      keywords.each { |key, value| parameters.push [:key, key, value] }
 
-      @parameters = marameters.for parameters
-      @scope = scope
-      @marameters = marameters
+      @parameters = Marameters.for parameters
+      @method_scope = method_scope
       @names = @parameters.names.compact
       @instance_module = Module.new.set_temporary_name "initable"
 
@@ -26,18 +25,18 @@ module Initable
 
     private
 
-    attr_reader :scope, :parameters, :marameters, :names, :instance_module
+    attr_reader :method_scope, :parameters, :names, :instance_module
 
     def define_initialize descendant,
                           inheritor: Marameters::Signatures::Inheritor.new,
                           forwarder: Marameters::Signatures::Super.new
-      ancestor = marameters.of(descendant, :initialize).first
-      signature = inheritor.call(ancestor, parameters).then { |params| marameters.signature params }
+      ancestor = Marameters.of(descendant, :initialize).first
+      signature = inheritor.call(ancestor, parameters).then { |params| Marameters.signature params }
 
       instance_module.module_eval <<-METHOD, __FILE__, __LINE__ + 1
         def initialize(#{signature})
-          super(#{forwarder.call ancestor, parameters})
           #{build_instance_variables ancestor}
+          super(#{forwarder.call ancestor, parameters})
         end
       METHOD
 
@@ -55,6 +54,6 @@ module Initable
       READERS
     end
 
-    def compute_scope = METHOD_SCOPES.include?(scope) ? scope : :private
+    def compute_scope = METHOD_SCOPES.include?(method_scope) ? method_scope : :private
   end
 end

data/lib/initable.rb

@@ -6,9 +6,9 @@ require "initable/builder"
 module Initable
   METHOD_SCOPES = %i[public protected private].freeze
 
-  def self.[](*) = Builder.new(*)
+  def self.[](*, **) = Builder.new(*, **)
 
-  def self.protected(*) = Builder.new(*, scope: __method__)
+  def self.protected(*, **) = Builder.new(*, method_scope: __method__, **)
 
-  def self.public(*) = Builder.new(*, scope: __method__)
+  def self.public(*, **) = Builder.new(*, method_scope: __method__, **)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: initable
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -9,9 +9,9 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIEeDCCAuCgAwIBAgIBATANBgkqhkiG9w0BAQsFADBBMQ8wDQYDVQQDDAZicm9v
+  MIIENjCCAp6gAwIBAgIBAjANBgkqhkiG9w0BAQsFADBBMQ8wDQYDVQQDDAZicm9v
   a2UxGjAYBgoJkiaJk/IsZAEZFgphbGNoZW1pc3RzMRIwEAYKCZImiZPyLGQBGRYC
-  aW8wHhcNMjMwMzIyMTYxNDQxWhcNMjUwMzIxMTYxNDQxWjBBMQ8wDQYDVQQDDAZi
+  aW8wHhcNMjUwMzIyMTQ1NDE3WhcNMjYwMzIyMTQ1NDE3WjBBMQ8wDQYDVQQDDAZi
   cm9va2UxGjAYBgoJkiaJk/IsZAEZFgphbGNoZW1pc3RzMRIwEAYKCZImiZPyLGQB
   GRYCaW8wggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQCro8tj5/E1Hg88
   f4qfiwPVd2zJQHvdYt4GHVvuHRRgx4HGhJuNp+4BId08RBn7V6V1MW6MY3kezRBs
@@ -21,20 +21,19 @@ cert_chain:
   QzzPxZBiRB1sgtbt1gUbVI262ZDq1gR+HxPFmp+Cgt7ZLIJZAtesQvtcMzseXpfn
   hpmm0Sw22KGhRAy/mqHBRhDl5HqS1SJp2Ko3lcnpXeFResp0HNlt8NSu13vhC08j
   GUHU9MyIXbFOsnp3K3ADrAVjPWop8EZkmUR3MV/CUm00w2cZHCSGiXl1KMpiVKvk
-  Ywr1gd2ZME4QLSo+EXUtLxDUa/W3xnBS8dBOuMMz02FPWYr3PN8CAwEAAaN7MHkw
+  Ywr1gd2ZME4QLSo+EXUtLxDUa/W3xnBS8dBOuMMz02FPWYr3PN8CAwEAAaM5MDcw
   CQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFAFgmv0tYMZnItuPycSM
-  F5wykJEVMB8GA1UdEQQYMBaBFGJyb29rZUBhbGNoZW1pc3RzLmlvMB8GA1UdEgQY
-  MBaBFGJyb29rZUBhbGNoZW1pc3RzLmlvMA0GCSqGSIb3DQEBCwUAA4IBgQAX+EGY
-  9RLYGxF1VLZz+G1ACQc4uyrCB6kXwI06kzUa5dF9tPXqTX9ffnz3/W8ck2IQhKzu
-  MKO2FVijzbDWTsZeZGglS4E+4Jxpau1lU9HhOIcKolv6LeC6UdALTFudY+GLb8Xw
-  REXgaJkjzzhkUSILmEnRwEbY08dVSl7ZAaxVI679vfI2yapLlIwpbBgmQTiTvPr3
-  qyyLUno9flYEOv9fmGHunSrM+gE0/0niGTXa5GgXBXYGS2he4LQGgSBfGp/cTwMU
-  rDKJRcusZ12lNBeDfgqACz/BBJF8FLodgk6rGMRZz7+ZmjjHEmpG5bQpR6Q2BuWL
-  XMtYk/QzaWuhiR7pWjiF8jbdd7RO6or0ohq7iFkokz/5xrtQ/vPzU2RQ3Qc6YaKw
-  3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
-  gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
+  F5wykJEVMA0GCSqGSIb3DQEBCwUAA4IBgQBlzRfyAYx/fCFjizS0Npxw4+4T3aYL
+  hbXoDqQRWjxuhFZcXUymhz3r8/Ltyri9lSof8grzB+8/+mrMVms7Gwt5qolk6zdn
+  FkySGy/jmpN12ldOHFbBEnyVBZNBvOBVb8zkkw8PhiHdBdXOUm4Jy39yJvBLfjcC
+  iM1aeWPmgPy1GbvZU+leRGZLt6dRIR9oCDXcWLRjha8xLMoz6Yn9fJBYexBA3iEz
+  h5S7pn4AX/JhVRiSyl8pAy4jEKydpyQrliH3gHkpNmUS/XDczP+9xX1bAB4BvqL2
+  NCxMcQ+hiJNqCKpPgHxaOOHZfIxV33logIuPEQ8NryHAwZ9ZWnwtYDE8kQGGKskI
+  Kkm6QT474hZl7MpwiJjWgW313CR7jUEekQahX1QxCxHPI7LSrKpno0plH3uWIOQp
+  KUlkb9uyACBgyRO52ZHiDVI8YvtU5O/j9pSes9/3XgvBeC1onx4qWp+uRX7eVsYS
+  GiijocTc3enZVrXERetaXj8/9XWs3fB3HWY=
   -----END CERTIFICATE-----
-date: 2025-02-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: marameters
@@ -55,8 +54,8 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.adoc
 - LICENSE.adoc
+- README.adoc
 files:
 - LICENSE.adoc
 - README.adoc
@@ -88,7 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 3.6.8
 specification_version: 4
 summary: An automatic object initializer.
 test_files: []

metadata.gz.sig

@@ -1,5 +1,3 @@
-���*;4�!��yl�U!\���3������3ZoG-�ʫ�$1��M{�ҡiW����������S���7���Ӆ�tV��k	�c!�X	T
-�
��I����X;������/֘b\t��#����\�

-���n�_�]S�bq������x�K�:��eE�X�>�3��<j
-,
-p�c�����}��Ʉ2���!O�����3gl�Ү�Ǚ��U��=����\�[B/s�������/r��n@��4��{Tr�&��ia�
+i��<rB�(nr�pq��GL1- ��Ŵ�gk��aU?��F{s�
+����ĕ�����m��,J���'��NQCl
+����+��JH��j@lzk�����e9���c�9`�Q���ԏ>�+W�g����M�