refinements 9.0.2 → 9.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad550aa0de5b7885133c4a146ff83f8df49184e10fdafc36c57a32511d4ca4e3
-  data.tar.gz: 52279fbf8e921a3500b5b341bd421b7827ad37f5f5cd0c0976042b33a2332885
+  metadata.gz: 4d3e2ba6964cfd39388a7f055fa830a5654ee264d04b2f519c1a735b922c08a7
+  data.tar.gz: f711604bba6cd3809398a5a2f6cb0ec867851538e58355c403a2b26aac4d75e3
 SHA512:
-  metadata.gz: '095faf7714a553a86654fbb302ebaebe964ba8c291f5e6bf4dc010a2f96ae74ddf2b4bc2fd3a537eb4f76ae38d8bfdc1f06d9a70ac62b039d8437cdbe6fddd0d'
-  data.tar.gz: d642f75675fa88cf809ea086e4965b43d091c90ff75f11b0d5878ba2f4e900ef427c849b18345b6f1804729a91e20d805ce67223c334fe4af44f1c104b34026e
+  metadata.gz: a72da7caf3a0698ae29bce0c51e3ce66829c41ac471e90a0f8777dc0f2e587c79304daf5ffb98983bf6ac50c79afb621d570216e557e550d0771208a039a52ed
+  data.tar.gz: ad031fb50b8d0c747d69b856d6e3a41eea74ba7de959bb8bfeda6b17c5b866ef2480fadce96ba50baa9b66c8e2fa6469d82e0a115cfa09a0d645668c2b3a0ef3

data/README.adoc

@@ -183,6 +183,19 @@ Inserts additional elements or array between all members of given array.
 [1, 2, 3].intersperse %i[a b c]  # [1, :a, :b, :c, 2, :a, :b, :c, 3]
 ----
 
+===== #many?
+
+Answers true if an array has more than one element. Can take a block which evaluates as truthy or
+falsey.
+
+[source,ruby]
+----
+[1, 2].many?             # true
+[1, 2, 3].many?(&:odd?)  # true
+[1].many?                # false
+[].many?                 # false
+----
+
 ===== #maximum
 
 Answers the maximum extracted value from a collection of objects.
@@ -436,6 +449,19 @@ example.flatten_keys!  # {a_b: 1}
 example                # {a_b: 1}
 ----
 
+===== #many?
+
+Answers true if a hash has more than one element. Can take a block which evaluates as truthy or
+falsey.
+
+[source,ruby]
+----
+{a: 1, b: 2}.many?                                     # true
+{a: 1, b: 2, c: 2}.many? { |_key, value| value == 2 }  # true
+{a: 1}.many?                                           # false
+{}.many?                                               # false
+----
+
 ===== #recurse
 
 Recursively iterates over the hash and any hash value by applying the given block to it. Does not
@@ -694,6 +720,28 @@ Pathname("/example.txt").touch.delete  # Pathname("/example")
 Pathname("/example.txt").delete        # Errno::ENOENT
 ----
 
+===== #delete_prefix
+
+Deletes a path prefix and answers new pathname.
+
+[source,ruby]
+----
+Pathname("a/path/example-test.rb").delete_prefix("example-")  # Pathname("a/path/test.rb")
+Pathname("example-test.rb").delete_prefix("example-")         # Pathname("test.rb")
+Pathname("example-test.rb").delete_prefix("miss")             # Pathname("example-test.rb")
+----
+
+===== #delete_suffix
+
+Deletes a path suffix and answers new pathname.
+
+[source,ruby]
+----
+Pathname("a/path/test-example.rb").delete_suffix("-example")  # Pathname("a/path/test.rb")
+Pathname("test-example.rb").delete_suffix("-example")         # Pathname("test.rb")
+Pathname("test-example.rb").delete_suffix("miss")             # Pathname("test-example.rb")
+----
+
 ===== #directories
 
 Answers all directories or filtered directories for current path.
@@ -1055,14 +1103,14 @@ whether the struct was constructed with positional or keyword arguments.
 [source,ruby]
 ----
 Example = Struct.new :a, :b, :c
-Example.with_keywords a: 1, b: 2, c: 3  # "#<struct a=1, b=2, c=3>"
-Example.with_keywords a: 1              # "#<struct a=1, b=nil, c=nil>"
-Example.with_keywords c: 1              # "#<struct a=nil, b=nil, c=1>"
+Example.with_keywords a: 1, b: 2, c: 3  # #<struct a=1, b=2, c=3>
+Example.with_keywords a: 1              # #<struct a=1, b=nil, c=nil>
+Example.with_keywords c: 1              # #<struct a=nil, b=nil, c=1>
 
 Example = Struct.new :a, :b, :c, keyword_init: true
-Example.with_keywords a: 1, b: 2, c: 3  # "#<struct a=1, b=2, c=3>"
-Example.with_keywords a: 1              # "#<struct a=1, b=nil, c=nil>"
-Example.with_keywords c: 1              # "#<struct a=nil, b=nil, c=1>"
+Example.with_keywords a: 1, b: 2, c: 3  # #<struct a=1, b=2, c=3>
+Example.with_keywords a: 1              # #<struct a=1, b=nil, c=nil>
+Example.with_keywords c: 1              # #<struct a=nil, b=nil, c=1>
 ----
 
 ===== .with_positions
@@ -1073,106 +1121,125 @@ whether the struct was constructed with positional or keyword arguments.
 [source,ruby]
 ----
 Example = Struct.new :a, :b, :c
-Example.with_positions 1, 2, 3  # "#<struct a=1, b=2, c=3>"
-Example.with_positions 1        # "#<struct a=1, b=nil, c=nil>"
+Example.with_positions 1, 2, 3  # #<struct a=1, b=2, c=3>
+Example.with_positions 1        # #<struct a=1, b=nil, c=nil>
 
 Example = Struct.new :a, :b, :c, keyword_init: true
-Example.with_positions 1, 2, 3  # "#<struct a=1, b=2, c=3>"
-Example.with_positions 1        # "#<struct a=1, b=nil, c=nil>"
+Example.with_positions 1, 2, 3  # #<struct a=1, b=2, c=3>
+Example.with_positions 1        # #<struct a=1, b=nil, c=nil>
 ----
 
 ===== #merge
 
 Merges multiple attributes without mutating itself and supports any object that responds to `#to_h`.
+Works regardless of whether the struct is constructed with positional or keyword arguments.
 
 [source,ruby]
 ----
+example = Struct.new("Example", :a, :b, :c).new 1, 2, 3
 other = Struct.new("Other", :a, :b, :c).new 7, 8, 9
 
-example = Struct.new(:a, :b, :c).new 1, 2, 3
-example.merge a: 10                # "#<struct a=10, b=2, c=3>"
-example.merge a: 10, c: 30         # "#<struct a=10, b=2, c=30>"
-example.merge a: 10, b: 20, c: 30  # "#<struct a=10, b=20, c=30>"
-example.merge {a: 10, b: 20}       # "#<struct a=10, b=20, c=3>"
-example.merge other                # "#<struct a=7, b=8, c=9>"
-example                            # "#<struct a=1, b=2, c=3>"
-
-example = Struct.new(:a, :b, :c, keyword_init: true).new a: 1, b: 2, c: 3
-example.merge a: 10                # "#<struct a=10, b=2, c=3>"
-example.merge a: 10, c: 30         # "#<struct a=10, b=2, c=30>"
-example.merge {a: 10, b: 20}       # "#<struct a=10, b=20, c=3>"
-example.merge other                # "#<struct a=7, b=8, c=9>"
-example.merge a: 10, b: 20, c: 30  # "#<struct a=10, b=20, c=30>"
-example                            # "#<struct a=1, b=2, c=3>"
+example.merge a: 10                # #<struct Struct::Example a=10, b=2, c=3>
+example.merge a: 10, c: 30         # #<struct Struct::Example a=10, b=2, c=30>
+example.merge a: 10, b: 20, c: 30  # #<struct Struct::Example a=10, b=20, c=30>
+example.merge other                # #<struct Struct::Example a=7, b=8, c=9>
+example                            # #<struct Struct::Example a=1, b=2, c=3>
 ----
 
 ===== #merge!
 
 Merges multiple attributes while mutating itself and supports any object that responds to `#to_h`.
+Works regardless of whether the struct is constructed with positional or keyword arguments.
 
 [source,ruby]
 ----
+example = Struct.new("Example", :a, :b, :c).new 1, 2, 3
 other = Struct.new("Other", :a, :b, :c).new 7, 8, 9
 
-example = Struct.new(:a, :b, :c).new 1, 2, 3
-example.merge! a: 10                # "#<struct a=10, b=2, c=3>"
-example.merge! a: 10, c: 30         # "#<struct a=10, b=2, c=30>"
-example.merge! {a: 10, b: 20}       # "#<struct a=10, b=20, c=3>"
-example.merge! other                # "#<struct a=7, b=8, c=9>"
-example.merge! a: 10, b: 20, c: 30  # "#<struct a=10, b=20, c=30>"
-example                             # "#<struct a=10, b=20, c=30>"
-
-example = Struct.new(:a, :b, :c, keyword_init: true).new a: 1, b: 2, c: 3
-example.merge! a: 10                # "#<struct a=10, b=2, c=3>"
-example.merge! a: 10, c: 30         # "#<struct a=10, b=2, c=30>"
-example.merge! {a: 10, b: 20}       # "#<struct a=10, b=20, c=3>"
-example.merge! other                # "#<struct a=7, b=8, c=9>"
-example.merge! a: 10, b: 20, c: 30  # "#<struct a=10, b=20, c=30>"
-example                             # "#<struct a=10, b=20, c=30>"
+example.merge! a: 10                # #<struct Struct::Example a=10, b=2, c=3>
+example.merge! a: 10, c: 30         # #<struct Struct::Example a=10, b=2, c=30>
+example.merge! other                # #<struct Struct::Example a=7, b=8, c=9>
+example.merge! a: 10, b: 20, c: 30  # #<struct Struct::Example a=10, b=20, c=30>
+example                             # #<struct Struct::Example a=10, b=20, c=30>
 ----
 
 ===== #revalue
 
-Transforms values without mutating itself. An optional hash can be supplied to pinpoint and
-transform specific attributes. In the event that a block isn't supplied, the struct will answer
-itself since there is nothing to operate on. Behavior is the same regardless of whether the struct
-is constructed using positional or keyword arguments. A positional struct is used in the examples
-below but a keyword struct would work too.
+Transforms values without mutating itself. An optional hash can be supplied to target specific
+attributes. In the event that a block isn't supplied, the struct will answer itself since there is
+nothing to operate on. Behavior is the same regardless of whether the struct is constructed using
+positional or keyword arguments. Works regardless of whether the struct is constructed with
+positional or keyword arguments.
 
 [source,ruby]
 ----
 example = Struct.new("Example", :a, :b, :c).new 1, 2, 3
-example.revalue { |value| value * 2 }                             # "#<struct a=2, b=4, c=6>"
-example.revalue(c: 2) { |previous, current| previous + current }  # "#<struct a=1, b=2, c=5>"
-example.revalue c: 2                                              # "#<struct a=1, b=2, c=3>"
-example.revalue                                                   # "#<struct a=1, b=2, c=3>"
-example                                                           # "#<struct a=1, b=2, c=3>"
+
+example.revalue { |value| value * 2 }                             # #<struct Struct::Example a=2, b=4, c=6>
+example.revalue(c: 2) { |previous, current| previous + current }  # #<struct Struct::Example a=1, b=2, c=5>
+example.revalue c: 2                                              # #<struct Struct::Example a=1, b=2, c=3>
+example.revalue                                                   # #<struct Struct::Example a=1, b=2, c=3>
+example                                                           # #<struct Struct::Example a=1, b=2, c=3>
 ----
 
 ===== #revalue!
 
-Transforms values while mutating itself. An optional hash can be supplied to pinpoint and transform
-specific attributes. In the event that a block isn't supplied, the struct will answer itself since
-there is nothing to operate on. Behavior is the same regardless of whether the struct is constructed
-using positional or keyword arguments. A positional struct is used in the examples below but a
-keyword struct would work too.
+Transforms values while mutating itself. An optional hash can be supplied to target specific
+attributes. In the event that a block isn't supplied, the struct will answer itself since there is
+nothing to operate on. Behavior is the same regardless of whether the struct is constructed using
+positional or keyword arguments. Works regardless of whether the struct is constructed with
+positional or keyword arguments.
 
 [source,ruby]
 ----
-Example = Struct.new :a, :b, :c
+one = Struct.new("One", :a, :b, :c).new 1, 2, 3
+one.revalue! { |value| value * 2 }                             # #<struct Struct::One a=2, b=4, c=6>
+one                                                            # #<struct Struct::One a=2, b=4, c=6>
+
+two = Struct.new("Two", :a, :b, :c).new 1, 2, 3
+two.revalue!(c: 2) { |previous, current| previous + current }  # #<struct Struct::Two a=1, b=2, c=5>
+two                                                            # #<struct Struct::Two a=1, b=2, c=5>
+
+three = Struct.new("Three", :a, :b, :c).new 1, 2, 3
+three.revalue! c: 2                                            # #<struct Struct::Three a=1, b=2, c=3>
+three.revalue!                                                 # #<struct Struct::Three a=1, b=2, c=3>
+three                                                          # #<struct Struct::Three a=1, b=2, c=3>
+----
 
-example = Example[1, 2, 3]
-example.revalue! { |value| value * 2 }                             # "#<struct a=2, b=4, c=6>"
-example                                                            # "#<struct a=2, b=4, c=6>"
+===== #transmute
 
-example = Example[1, 2, 3]
-example.revalue!(c: 2) { |previous, current| previous + current }  # "#<struct a=1, b=2, c=5>"
-example                                                            # "#<struct a=1, b=2, c=5>"
+Transmutes given enumerable by using the foreign key map and merging those key values into the
+current struct while not mutating itself. Works regardless of whether the struct is constructed with
+positional or keyword arguments.
+
+[source,ruby]
+----
+a = Struct.new("A", :a, :b, :c).new 1, 2, 3
+b = Struct.new("B", :x, :y, :z).new 7, 8, 9
+c = {r: 10, s: 20, t: 30}
+
+a.transmute b, a: :x, b: :y, c: :z  # #<struct Struct::A a=7, b=8, c=9>
+a.transmute b, b: :y                # #<struct Struct::A a=1, b=8, c=3>
+a.transmute c, c: :t                # #<struct Struct::A a=1, b=2, c=30>
+a                                   # #<struct Struct::A a=1, b=2, c=3>
+----
+
+===== #transmute!
+
+Transmutes given enumerable by using the foreign key map and merging those key values into the
+current struct while mutating itself. Works regardless of whether the struct is constructed with
+positional or keyword arguments.
+
+[source,ruby]
+----
+a = Struct.new("A", :a, :b, :c).new 1, 2, 3
+b = Struct.new("B", :x, :y, :z).new 7, 8, 9
+c = {r: 10, s: 20, t: 30}
 
-example = Example[1, 2, 3]
-example.revalue! c: 2                                              # "#<struct a=1, b=2, c=3>"
-example.revalue!                                                   # "#<struct a=1, b=2, c=3>"
-example                                                            # "#<struct a=1, b=2, c=3>"
+a.transmute! b, a: :x, b: :y, c: :z  # #<struct Struct::A a=7, b=8, c=9>
+a.transmute! b, b: :y                # #<struct Struct::A a=1, b=8, c=3>
+a.transmute! c, c: :t                # #<struct Struct::A a=1, b=2, c=30>
+a                                    # #<struct Struct::A a=7, b=8, c=30>
 ----
 
 ==== Symbol

data/lib/refinements/arrays.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/shared/enumerables/many"
+
 module Refinements
   # Provides additional enhancements to the Array primitive.
   module Arrays
     refine Array do
+      import_methods Shared::Enumerables::Many
+
       def compress = dup.compress!
 
       def compress!

data/lib/refinements/hashes.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "refinements/shared/enumerables/many"
+
 module Refinements
   # Provides additional enhancements to the Hash primitive.
   module Hashes
@@ -12,6 +14,8 @@ module Refinements
     end
 
     refine Hash do
+      import_methods Shared::Enumerables::Many
+
       def compress = dup.compress!
 
       def compress!

data/lib/refinements/identity.rb

@@ -5,7 +5,7 @@ module Refinements
   module Identity
     NAME = "refinements"
     LABEL = "Refinements"
-    VERSION = "9.0.2"
+    VERSION = "9.1.0"
     VERSION_LABEL = "#{LABEL} #{VERSION}".freeze
   end
 end

data/lib/refinements/pathnames.rb

@@ -50,6 +50,10 @@ module Refinements
 
       def delete = super && self
 
+      def delete_prefix(pattern) = parent.join %(#{name.sub(/\A#{pattern}/, "")}#{extname})
+
+      def delete_suffix(pattern) = parent.join %(#{name.sub(/#{pattern}\z/, "")}#{extname})
+
       def directories pattern = "*", flag: File::FNM_SYSCASE
         glob(pattern, flag).select(&:directory?).sort
       end
@@ -74,7 +78,7 @@ module Refinements
         self
       end
 
-      def name = basename(extname)
+      def name = basename extname
 
       def relative_parent(root_dir) = relative_path_from(root_dir).parent
 

data/lib/refinements/shared/enumerables/many.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Refinements
+  module Shared
+    module Enumerables
+      # Provides shared functionality for knowing whether an enumerable has many elements or not.
+      module Many
+        def many?
+          return size > 1 unless block_given?
+
+          total = reduce(0) { |count, item| yield(item) ? count + 1 : count }
+          total > 1
+        end
+      end
+    end
+  end
+end

data/lib/refinements/strings.rb

@@ -64,11 +64,10 @@ module Refinements
 
       private
 
-      # :reek:DuplicateMethodCall
       # :reek:UtilityFunction
       def combine parts, method, delimiter = ""
         parts.reduce "" do |result, part|
-          next part.__send__ method if result.empty?
+          next part.public_send method if result.empty?
 
           "#{result}#{delimiter}#{part.__send__ method}"
         end

data/lib/refinements/structs.rb

@@ -15,10 +15,10 @@ module Refinements
     end
 
     refine Struct do
-      def merge(object = nil) = dup.merge!(object)
+      def merge(...) = dup.merge!(...)
 
       def merge! object = nil
-        to_h.merge(**object.to_h).each { |key, value| self[key] = value }
+        to_h.merge!(**object.to_h).each { |key, value| self[key] = value }
         self
       end
 
@@ -34,6 +34,13 @@ module Refinements
         attributes.each { |key, value| self[key] = yield self[key], value }
         self
       end
+
+      def transmute(...) = dup.transmute!(...)
+
+      def transmute! object, **key_map
+        mapping = key_map.invert
+        merge! object.to_h.slice(*mapping.keys).transform_keys!(mapping)
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 9.0.2
+  version: 9.1.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   lkHilIrX69jq8wMPpBhlaw2mRmeSL50Wv5u6xVBvOHhXFSP1crXM95vfLhLyRYod
   W2A=
   -----END CERTIFICATE-----
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-01-17 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -49,6 +49,7 @@ files:
 - lib/refinements/identity.rb
 - lib/refinements/ios.rb
 - lib/refinements/pathnames.rb
+- lib/refinements/shared/enumerables/many.rb
 - lib/refinements/string_ios.rb
 - lib/refinements/strings.rb
 - lib/refinements/structs.rb
@@ -77,7 +78,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.5
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.