refinements 9.6.0 → 9.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c0144180dd3a5cabe861b385cd0c766eaf54280ca6812dc6e82db4e564ce6c0
-  data.tar.gz: b339710c168c98fffbe5b1994031f033041c9f6c16b0df96555cb80fd5cd7269
+  metadata.gz: 0dbec0b903b2ce6a78545bf34285ab60d20fd1b511975c750829a883107de915
+  data.tar.gz: 14c0fa259be4dd70fcc3766bcf745b9c267af3b1a58c0f32fc0f1fdfbb9d6458
 SHA512:
-  metadata.gz: 926090205f29ac111494e00e7de37b59b8549c6f979c8a0d62d852e9d87193093073ac0f005564243fc472eacf4de68f62bea8b1d45f3f363e113805758f726d
-  data.tar.gz: 22a524d073a48922d6347119f01f4c059bbd2bba8f65a2e6573951b137b772dc3f7797a3596ccb850bb63159a9b2ab501bb334f7ac8a80f66ca93f55886bdb09
+  metadata.gz: 0bdd1ea6074fd07ae02659c283a1a035da4695d5375150264eea4e88ca5eae7b041a41ea6a14384305143695752fd6c1397477be387a28e75d39f80c907c8f87
+  data.tar.gz: 0caa5d7b26ad27a5378daad28b9a0cc7c7bc6c6f0d5db5d3fc2f20cacc0a834ae902269b74432196df89b90510d918afa60a941ae19254cb6bf0eecc46fec8f8

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.
@@ -1346,7 +1370,7 @@ To contribute, run:
 
 [source,bash]
 ----
-git clone https://github.com/bkuhlmann/refinements.git
+git clone https://github.com/bkuhlmann/refinements
 cd refinements
 bin/setup
 ----

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.1"
   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.1
 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-10-22 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.24
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.