params-registry 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac097d76612371d0ccf0cd787b7aa3fa39b1b0392dd65ee09fb9188488785c67
-  data.tar.gz: 78d0cfe84914872dbc96852600af044b13dff6883cdf475810a411ce8c1d4b31
+  metadata.gz: b55a15071c752544d76d3256a835eb927507ff8685a90cc94cc00a9bf6fed373
+  data.tar.gz: c4e5cc3a55c98e39405fa5d61e88ccecdc279e5149d38a04469a6ab5db664e33
 SHA512:
-  metadata.gz: 54afd98474e0c2570a3aa40b6149395dae855a9c99e4b7da0791739760aaa96f0bf1c11694290c5a0f975e396deb218174f2926d7af5ac4ea78028b0ad5da162
-  data.tar.gz: 2c245cbd712bf4bad769ef3b9f5e11f4926597d8ca9d557540cf57b9e441868c6d5130f37c974235660fb1ecb12bf82ac0c58fbb564e29fd5f464c8b38e35d20
+  metadata.gz: 356602be7b8437695e5439bafcb74c62d85a1e5205a436c2ab90e8ec19d1cdc0692fdd0b25dd16ac18f86861c96d7a501b4114a357469b301e17f6396becd834
+  data.tar.gz: b7f9c511c11070da981d7d85d4354c4f46c7d72a780aee8b2e4eace3ce34c5d52eef6866dce51add8bd32947924614c853f677cf602d7e34d7ec7f6f17df2d19

data/README.md

@@ -18,9 +18,9 @@ _symbols_, which you have to _manage_, and this is a _problem_.
 table: named parameters that are exposed to the wild through
 mechanisms like URLs and APIs.
 
-## So, query parameters, isn't that like, _super_ anal?
+## So, query parameters, isn't that like, _super_ uptight?
 
-So, I vacillated for _years_ before making [the _first_ version of
+I vacillated for _years_ before making [the _first_ version of
 this module](https://metacpan.org/dist/Params-Registry) back in 2013.
 _Query_ parameters? I mean, who cares? Well, it turns out that if you
 want certain outcomes, this is the kind of software you need. _What_

data/lib/params/registry/instance.rb

@@ -220,7 +220,12 @@ class Params::Registry::Instance
       return @extras[param] = value
     end
 
-    @content[template.id] = template.process value
+    # XXX THIS MIGHT FUCK SHIT UP
+    if value.nil?
+      @content.delete template.id
+    else
+      @content[template.id] = template.process value
+    end
   end
 
   # Bulk-assign instance content.
@@ -239,9 +244,9 @@ class Params::Registry::Instance
   #
   # @return [URI, #query=] the URI with the new query string
   #
-  def make_uri uri, defaults: false
+  def make_uri uri, defaults: false, extra: false
     uri = uri.dup
-    uri.query = to_s defaults: defaults
+    uri.query = to_s defaults: defaults, extra: extra
     uri
   end
 
@@ -281,14 +286,39 @@ class Params::Registry::Instance
 
   # Serialize the instance back to a {::URI} query string.
   #
+  # @params defaults [false, true, Object, Array] whether to serialize
+  #  default values, or specific keys/slugs to include
+  # @params extra [false, true] whether to include parameters that
+  #  were passed in that aren't in the registry
+  #
   # @return [String] the instance serialized as a URI query string.
   #
   def to_s defaults: false, extra: false
     ts = registry.templates
+
+    # warn ts.inspect
+
+    # this should give us a list of keys that have defaults that we
+    # want to show up
+    defaults = case defaults
+               when nil, false then []
+               when true then ts.select { |k| ts[k].default? }.values.map(&:id)
+               when -> d { d.respond_to? :to_a } then defaults.to_a
+               else [defaults]
+               end.map { |d| ts[d]&.id }.compact
+
+    # the template keys should have the original order so we want to intersee
     sequence = ts.keys & @content.keys
     complements = Set[]
-    sequence.map do |k|
+    out = sequence.map do |k|
       template = ts[k]
+
+      # we want to skip the parameter if it's the same as
+      next if template.default? and @content[k] == template.default and
+        not defaults.include? k
+
+      # get the dependencies, convert to an array of strings, harvest
+      # complement flag (if present)
       deps = @content.slice(*(template.depends - template.consumes))
       v, c = template.unprocess @content[k], deps, try_complement: true
       complements << k if c
@@ -300,7 +330,12 @@ class Params::Registry::Instance
       v.map do |v|
         "#{template.slug || encode_value(k)}=#{encode_value v}"
       end.join ?&
-    end.compact.join ?&
+    end.compact
+
+    # XXX TODO complement and extras i just don't feel like looking up how
+    # that's supposed to work rn but they would go here
+
+    out.join ?&
   end
 
   # Return a string representation of the object suitable for debugging.

data/lib/params/registry/template.rb

@@ -289,6 +289,13 @@ class Params::Registry::Template
   #
   def composite? ; !!@composite; end
 
+  # @!attribute [r] default?
+  # Whether this parameter has a default value.
+  #
+  # @return [Boolean]
+  #
+  def default? ; !@default.nil?; end
+
   # @!attribute [r] preproc?
   # Whether there is a preprocessor function.
   #

data/lib/params/registry/types.rb

@@ -40,6 +40,8 @@ module Params::Registry::Types
     end
   end
 
+  Boolean = Bool
+
   # For some reason there isn't a stock `Proc` type.
   Proc = self.Instance(::Proc)
 

data/lib/params/registry/version.rb

@@ -3,6 +3,6 @@
 module Params
   class Registry
     # The module version
-    VERSION = '0.2.1'
+    VERSION = '0.2.2'
   end
 end

data/lib/params/registry.rb

@@ -244,10 +244,14 @@ class Params::Registry
     # @param params
     #  [String, URI, Hash{#to_sym => Array}, Array<Array<(#to_sym, Object)>>]
     #  the parameter set, in a dizzying variety of inputs.
+    # @param defaults [true, false] whether to include default values
+    #  in the instance
+    # @param force [false, true] whether to force something i don't
+    #  remember what though lol
     #
     # @return [Params::Registry::Instance] the instance.
     #
-    def process params, defaults: false, force: false
+    def process params, defaults: true, force: false
       registry.instance_class.new self,
         params: params, defaults: defaults, force: force
     end
@@ -404,10 +408,14 @@ class Params::Registry
   # @param params
   #  [String, URI, Hash{#to_sym => Array}, Array<Array<(#to_sym, Object)>>]
   #  the parameter set, in a dizzying variety of inputs.
+  # @param defaults [true, false] whether to include default values
+  #  in the instance
+  # @param force [false, true] whether to force something i don't
+  #  remember what though lol
   #
   # @return [Params::Registry::Instance] the instance.
   #
-  def process params, defaults: false, force: false
+  def process params, defaults: true, force: false
     instance_class.new self, params: params, defaults: defaults, force: force
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: params-registry
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Dorian Taylor
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-18 00:00:00.000000000 Z
+date: 2025-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-types