refinements 9.6.0 → 9.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c0144180dd3a5cabe861b385cd0c766eaf54280ca6812dc6e82db4e564ce6c0
-  data.tar.gz: b339710c168c98fffbe5b1994031f033041c9f6c16b0df96555cb80fd5cd7269
+  metadata.gz: bfcbba638db46745a2a7bed58489bea5a2942fb8d414d6803696ee78d12b8ae2
+  data.tar.gz: bf5d97f24387a1b46c90b2ebce6e20a66a8ef7f817b60f7029c58ef7d8897236
 SHA512:
-  metadata.gz: 926090205f29ac111494e00e7de37b59b8549c6f979c8a0d62d852e9d87193093073ac0f005564243fc472eacf4de68f62bea8b1d45f3f363e113805758f726d
-  data.tar.gz: 22a524d073a48922d6347119f01f4c059bbd2bba8f65a2e6573951b137b772dc3f7797a3596ccb850bb63159a9b2ab501bb334f7ac8a80f66ca93f55886bdb09
+  metadata.gz: 72fc04e99a5e2cc9f6d7adbc2b7c9d461f6d3246249eb1615379d2f64f871f5066c27bdedc95bda42cd44e247e4c793514f6885e11a497ce70980763bb00cb32
+  data.tar.gz: 16be117393cd04565ca945c1812e25d63169f7cb5400f4fa11bfe1aac27cbe3061deeeac6fb0e160c2538cf1f274cd1998e7e296f7c9e6e3cde39a0c5a822307

data/README.adoc

@@ -278,6 +278,30 @@ example.ring { |(before, current, after)| puts "#{before} #{current} #{after}" }
 # [2 3 1]
 ----
 
+===== #supplant
+
+Answers mutated array where first target element found is replaced by single or multiple elements.
+
+[source,ruby]
+----
+%i[a b a].supplant :a, :z       # [:z, :b, :a]
+%i[a b a].supplant :a, :z, :y   # [:z, :y, :b, :a]
+%i[a b a].supplant :a, %i[z y]  # [[:z, :y], :b, :a]
+----
+
+===== #supplant_if
+
+Answers mutated array where all target elements are replaced by single or multiple elements.
+
+⚠️ Be aware that this can be an expensive operation on large arrays.
+
+[source,ruby]
+----
+%i[a b a].supplant_if :a, :z       # [:z, :b, :z]
+%i[a b a].supplant_if :a, :z, :y   # [:z, :y, :b, :z, :y]
+%i[a b a].supplant_if :a, %i[z y]  # [[:z, :y], :b, [:z, :y]]
+----
+
 ===== #to_sentence
 
 Answers a sentence using `", "` as the default delimiter and `"and"` as the default conjunction.

data/lib/refinements/arrays.rb

@@ -35,6 +35,20 @@ module Refinements
 
       def ring(&) = [last, *self, first].each_cons(3, &)
 
+      def supplant target, *replacements
+        index(target).then do |position|
+          delete_at position
+          insert position, *replacements
+        end
+
+        self
+      end
+
+      def supplant_if target, *replacements
+        each { |item| supplant target, *replacements if item == target }
+        self
+      end
+
       def to_sentence delimiter: ", ", conjunction: "and"
         case length
           when (3..) then "#{self[..-2].join delimiter}#{delimiter}#{conjunction} #{last}"

data/refinements.gemspec

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 9.6.0
+  version: 9.7.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-07-17 00:00:00.000000000 Z
+date: 2022-09-01 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -83,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.18
+rubygems_version: 3.3.21
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.