tag_options 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5802916aaa57253843bc9fa02aed005828d4ffa30a8ccf514b9949c5c0859d2d
-  data.tar.gz: 80ee0b00682ee8d94595039cd1569c0152d0dedb225a78672986416118bec6fe
+  metadata.gz: 6e2a2a1f14c436d95569da59c07b36ea56ca1ef5f0a69546cb445423243d69ab
+  data.tar.gz: 2a5f69f7f214a7a00d3dfd47d7b627968960c6525ee4c65ec91a4590cdbab140
 SHA512:
-  metadata.gz: f498f2aa015310a8b4d3800dcb435c5b946665f5f53bf54630a80666e3c56f05c54b75788ea84b2d57829d2369404408621a4b2b7adeec1c5668fad2e61ac37a
-  data.tar.gz: 9e04caa1298cec89d34af81daa7c11b51c18020c3bb013aaf7b104de5f1e5c80d545aeaae334929d3c2796d5fa00f31aafb59028b588bf9aefd218278e56bb9c
+  metadata.gz: 2eee9711c6e3cf2163ef43aa45ea15c50fa247c1dada13d21e225e0cab19dbc5e52cb3843168d23cd33434d8e496e4a6da12247232cc881af3ec5f98a1adf0ff
+  data.tar.gz: cb281c5639b6381795d7d7f975ef5cf558ac0f9065ad38ac25d9c62e7257748b84df3d07a9f72d161709ae436c4712196aa26805bffc359522b1db0719305fcc

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## [Unreleased]
 
+## [1.2.0] - 2023-03-01
+
+- Added `at().default!` option for setting values that are not already present.
+- Fix for passing an array of values to `combine1` or `set!`
+
 ## [1.1.0] - 2023-03-01
 
 - Switched to inheriting from ActiveSupport::HashWithIndifferentAccess.

data/README.md

@@ -41,6 +41,7 @@ Would render:
   - [General Usage](#general-usage)
     - [combine!](#combine)
     - [set!](#set)
+    - [default!](#default)
   - [Conditional Usage](#conditional-usage)
   - [Custom Property Resolvers](#custom-property-resolvers)
   - [Development](#development)
@@ -71,9 +72,12 @@ TagOptions::Hash.new
 
 hash = {class: "flex"}
 TagOptions::Hash.new(hash)
-=> {:class=>"flex"}
+=> {"class"=>"flex"}
 ```
 
+`TagOptions::Hash` inherits from `ActiveSupport::HashWithIndifferentAccess`,
+implementing a hash where keys `:foo` and `"foo"` are considered to be the same.
+
 ### combine!
 
 Combine HTML attributes with an existing `TagOptions::Hash` by chaining `at` and
@@ -82,7 +86,7 @@ Combine HTML attributes with an existing `TagOptions::Hash` by chaining `at` and
 ```ruby
 options = TagOptions::Hash.new(class: "flex")
 options.at(:class).combine!("mt-1")
-=> {:class=>"flex mt-1"}
+=> {"class"=>"flex mt-1"}
 ```
 
 Values can also be specified as arrays.
@@ -90,7 +94,7 @@ Values can also be specified as arrays.
 ```ruby
 options = TagOptions::Hash.new(class: "flex")
 options.at(:class).combine!(["mt-1", "mx-2"])
-=> {:class=>"flex mt-1 mx-2"}
+=> {"class"=>"flex mt-1 mx-2"}
 ```
 
 HTML attributes are only added if they don't already exist.
@@ -98,7 +102,7 @@ HTML attributes are only added if they don't already exist.
 ```ruby
 options = TagOptions::Hash.new(class: "flex")
 options.at(:class).combine!("flex flex-col")
-=> {:class=>"flex flex-col"}
+=> {"class"=>"flex flex-col"}
 ```
 
 You can also combine values on nested hashes.
@@ -106,7 +110,7 @@ You can also combine values on nested hashes.
 ```ruby
 options = TagOptions::Hash.new(class: "flex", data: {controller: "dropdown"})
 options.at(:data, :controller).combine!("toggle")
-=> {:class=>"flex", :data=>{:controller=>"dropdown toggle"}
+=> {"class"=>"flex", "data"=>{"controller"=>"dropdown toggle"}}
 ```
 
 If a nested hash doesn't already exist it will be automatically added.
@@ -114,7 +118,7 @@ If a nested hash doesn't already exist it will be automatically added.
 ```ruby
 options = TagOptions::Hash.new(class: "flex")
 options.at(:data, :controller).combine!("dropdown")
-=> {:class=>"flex", :data=>{:controller=>"dropdown"}
+=> {"class"=>"flex", "data"=>{"controller"=>"dropdown"}}
 ```
 
 ### set!
@@ -126,7 +130,20 @@ existing values.
 ```ruby
 options = TagOptions::Hash.new(class: "flex")
 options.at(:class).set!("block")
-=> {:class=>"block"}
+=> {"class"=>"block"}
+```
+
+### default!
+
+Chaining `at` and `default!` functions nearly the same as `set!` with all the
+same usage patterns. The only difference is that the default method will only
+set the specified values if the value is not already specified.
+
+```ruby
+options = TagOptions::Hash.new(class: "flex")
+options.at(:class).default!("block")
+options.at(:role).default!("alert")
+=> {"class"=>"flex", "role"=>"alert"}
 ```
 
 ## Conditional Usage
@@ -139,7 +156,7 @@ unconditionally and key/value pairs have their key added _IF_ the value is true.
 # assuming `centered?` returns `true`
 options = TagOptions::Hash.new(class: "flex")
 options.at(:class).combine!("mt-1", "mx-auto": centered?, "mx-2": !centered?)
-=> {:class=>"flex mt-1 mx-auto"}
+=> {"class"=>"flex mt-1 mx-auto"}
 ```
 
 ## Custom Property Resolvers
@@ -164,7 +181,7 @@ pass `as: :style` to `at`.
 ```ruby
 options = TagOptions::Hash.new(style: "display: block; margin-left: 0;")
 options.at(:style, as: :style).combine!("display: flex; margin-right: 0;")
-=> {:style=>"display: flex; margin-left: 0; margin-right: 0;"}
+=> {"style"=>"display: flex; margin-left: 0; margin-right: 0;"}
 ```
 
 A `TagOptions::Resolver` class is available if you wish to implement your own

data/lib/tag_options/hash.rb

@@ -28,9 +28,9 @@ module TagOptions
       populated_keys = []
       data = self
       keys.each do |key|
-        data[key] ||= TagOptions::Hash.new
+        data[key] ||= self.class.new
         data = data[key]
-        unless data.is_a?(TagOptions::Hash)
+        unless data.is_a?(self.class)
           raise TagOptions::Errors::NotHashError.new(populated_keys, type: data.class)
         end
       end

data/lib/tag_options/hash_at.rb

@@ -15,6 +15,11 @@ module TagOptions
       set_value! @resolver.call(current_value, *values, **conditions)
     end
 
+    def default!(*values, **conditions)
+      @opt_hash.populate!(*@keys)
+      set_default! @resolver.call(*values, **conditions)
+    end
+
     def set!(*values, **conditions)
       @opt_hash.populate!(*@keys)
       set_value! @resolver.call(*values, **conditions)
@@ -22,6 +27,12 @@ module TagOptions
 
     private
 
+    def set_default!(value)
+      root = @opt_hash.dig(*@keys)
+      root[@value_key] = value unless root.key?(@value_key)
+      @opt_hash
+    end
+
     def set_value!(value)
       @opt_hash.dig(*@keys)[@value_key] = value
       @opt_hash

data/lib/tag_options/resolver.rb

@@ -1,7 +1,7 @@
 module TagOptions
   class Resolver
     def initialize(*values, **conditional_values)
-      @values = [*values, *resolve_conditional_values(conditional_values)]
+      @values = [*values.flatten, *resolve_conditional_values(conditional_values)]
     end
 
     def self.call(...)

data/lib/tag_options/version.rb

@@ -1,3 +1,3 @@
 module TagOptions
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tag_options
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Alex Monroe
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-01 00:00:00.000000000 Z
+date: 2023-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport