marameters 3.8.0 → 3.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6907611c749d0afd13d7e724a625aaa344de5625a7e8a3430880412dacf250a
-  data.tar.gz: e628c69c662b7005b308854006149d93fbf394a801fde3b4abd589d5109d1b25
+  metadata.gz: 72e522d6b0e294687fe361c583d0c35d50287843e927e772ed4ce2c9e99cb122
+  data.tar.gz: 5c70165bfd8b9036982b01dd45926daeeb349b9fcbc880cf330d6635b4511ec9
 SHA512:
-  metadata.gz: 3ed5a571f16d65a033f1aa746d84f2f9ca69fdc3b86f0960673acfc24b882b8a69768859c9fe2ef6fe30af261365c45bb0726886aa12e89de6f015c85bcb7c64
-  data.tar.gz: 5a434f7bd2635a6b2ca6f3bec85b21d1e48aaa597fdc3447280bfff7f81f50c8e3072dbbd5acebe558b705b08a40726a161e8032ce1a573d0501ac9c97b72dec
+  metadata.gz: c43d9e5016ee8436764959892a642ecaac2a22ec66d2439b673f1646e9fc93b9e030f6b07304a6c936db4edd2c4687a268c2569fb73d487f39c3144e962886e2
+  data.tar.gz: 18ab62e24d33a6a03b34e2c01cacb1c6b2b844a245062a0db0e79e0fd66560b2c30b6f28829cc9ed0a2389dc6281bc546ac435692ffd41f466f9bf9591f31418

data/README.adoc

@@ -139,6 +139,7 @@ probe.positionals?         # true
 probe.splats               # [:three, :six]
 probe.splats?              # true
 probe.to_a                 # [[:req, :one], [:opt, :two], [:rest, :three], [:keyreq, :four], [:key, :five], [:keyrest, :six], [:block, :seven]]
+probe.to_h                 # {req: :one, opt: :two, rest: :three, keyreq: :four, key: :five, keyrest: :six, block: :seven}
 ----
 
 In contrast the above, we can also probe the `#none` method which has no parameters for a completely
@@ -165,6 +166,7 @@ probe.positionals?         # false
 probe.splats               # []
 probe.splats?              # false
 probe.to_a                 # []
+probe.to_h                 # {}
 ----
 
 === Categorizer

data/lib/marameters/builder.rb

@@ -7,11 +7,12 @@ module Marameters
       @defaulter = defaulter
     end
 
-    def call kind, name, default: nil
+    def call kind, name = nil, default: nil
       case kind
         when :req then name
         when :opt then "#{name} = #{defaulter.call default}"
         when :rest then "*#{name}"
+        when :nokey then "**nil"
         when :keyreq then "#{name}:"
         when :key then "#{name}: #{defaulter.call default}"
         when :keyrest then "**#{name}"

data/lib/marameters/defaulter.rb

@@ -2,28 +2,13 @@
 
 module Marameters
   # Computes a method parameter's default value.
-  class Defaulter
-    PASSTHROUGH = "*"
-
-    def self.call(...) = new(...).call
-
-    def initialize value, passthrough: PASSTHROUGH
-      @value = value
-      @passthrough = passthrough
-    end
-
-    def call
-      case value
-        when nil then "nil"
-        when /\A#{Regexp.escape passthrough}/ then value.delete_prefix passthrough
-        when String then value.dump
-        when Symbol then value.inspect
-        else value
-      end
+  Defaulter = lambda do |value, passthrough: "*"|
+    case value
+      when /\A#{Regexp.escape passthrough}/ then value.delete_prefix passthrough
+      when String then value.dump
+      when Symbol then value.inspect
+      when nil then "nil"
+      else value
     end
-
-    private
-
-    attr_reader :value, :passthrough
   end
 end

data/lib/marameters/probe.rb

@@ -32,7 +32,14 @@ module Marameters
     def empty? = parameters.empty?
 
     def keyword_slice collection, keys:
-      collection.select { |key| !keys.include?(key) || keywords.include?(key) }
+      warn "`#{self.class}##{__method__}` is deprecated, use `#keywords_for` instead.",
+           category: :deprecated
+
+      keywords_for(*keys, **collection)
+    end
+
+    def keywords_for(*keys, **attributes)
+      attributes.select { |key| !keys.include?(key) || keywords.include?(key) }
     end
 
     def keywords? = keywords.any?
@@ -64,6 +71,8 @@ module Marameters
 
     def to_a = parameters
 
+    def to_h = parameters.each.with_object({}) { |(key, name), attributes| attributes[key] = name }
+
     private
 
     attr_reader :parameters

data/lib/marameters.rb

@@ -10,6 +10,8 @@ end
 
 # Main namespace.
 module Marameters
+  KINDS = %i[req opt rest nokey keyreq key keyrest block].freeze
+
   def self.loader registry = Zeitwerk::Registry
     @loader ||= registry.loaders.find { |loader| loader.tag == File.basename(__FILE__, ".rb") }
   end

data/marameters.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "marameters"
-  spec.version = "3.8.0"
+  spec.version = "3.10.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/marameters"
@@ -24,7 +24,7 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ">= 3.3", "<= 3.4"
   spec.add_dependency "refinements", "~> 12.9"
-  spec.add_dependency "zeitwerk", "~> 2.6"
+  spec.add_dependency "zeitwerk", "~> 2.7"
 
   spec.extra_rdoc_files = Dir["README*", "LICENSE*"]
   spec.files = Dir["*.gemspec", "lib/**/*"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: marameters
 version: !ruby/object:Gem::Version
-  version: 3.8.0
+  version: 3.10.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-10-07 00:00:00.000000000 Z
+date: 2024-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: refinements
@@ -57,14 +57,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.7'
 description:
 email:
 - brooke@alchemists.io
@@ -113,7 +113,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.21
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A dynamic method parameter inspector.