refinements 9.0.0 → 9.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0746c18e226511e85f7d04c3f4cb6625ce9f5e693bf83a0cf305c2e21d4c4abe
-  data.tar.gz: 1684d702a617bd9ab4b9303bc8fdf8b0076c4ecb8d65c124a9a7442246bd6451
+  metadata.gz: aac49ade733ea3bd5f36bd51d47c805c50dd6841ee7f8f24102336ff67bc8d08
+  data.tar.gz: 8d8f3d7edcc8289b90ba632f71970a64f22c41309c14eb68f555312d5516d320
 SHA512:
-  metadata.gz: 19634c8df6dbc346faba14e88d13aabcdd257d0ecefb9ace0fc7e9a86f95be545d523a5e1c80caad5535310e4d035404e802e24aa9e3dc896430694540b90143
-  data.tar.gz: bc750c9a7659337bfb7e2bf971a78bbd764bc9981eda9325f993ed5f06ffdccf93817b37732763a331b91f179a855c6a2212d448740a4d878c1a1ee7e38b6804
+  metadata.gz: 82dcc0b789e630281874f9d73e891927231066caa2c0255e3f3d63242edae1e32cc0eca709e76b6f82a85c13be92852e9e59e6a2b47b4802f6913235e38c6a0a
+  data.tar.gz: d17b6d4ee10c5568f52b6eee57e97538b1af910ff7241fc8faca30079dd82168da472dbe6c6d1d6f9f015f1887a53e85ced855173c293bcb6f9efb56cfc454f4

data/README.adoc

@@ -11,12 +11,11 @@ image::https://img.shields.io/badge/code_style-alchemists-brightgreen.svg[Alchem
 [link=https://circleci.com/gh/bkuhlmann/refinements]
 image::https://circleci.com/gh/bkuhlmann/refinements.svg?style=svg[Circle CI Status]
 
-Refinements are a collection of enhancements to primitive Ruby objects without needing to resort to
-painful and hard to debug
-link:https://www.alchemists.io/articles/ruby_antipatterns/#_monkey_patches[monkey patches]. These
-refinements give you additional syntactic sugar to develop clean and concise implementations while
-using less code. By refining our code we can acquire the functionality we wish the core primitives
-had!
+Refinements are a collection primitive Ruby objects enhancements without needing to resort to hard
+to debug link:https://www.alchemists.io/articles/ruby_antipatterns/#_monkey_patches[monkey patches].
+These refinements give you additional syntactic sugar to develop clean and concise implementations
+while using less code. By refining our code we can acquire the functionality we wish the core
+primitives had!
 
 toc::[]
 
@@ -148,7 +147,7 @@ Removes given array or elements without mutating itself.
 
 ===== #filter_find
 
-Answers the first truthy and filtered result from a collection.
+Answers the first element which evaluates to true from a filtered collection.
 
 [source,ruby]
 ----
@@ -184,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.
@@ -349,7 +361,7 @@ example                          # {a: "A", b: {one: 1, two: "Two"}}
 
 ===== #deep_stringify_keys
 
-Stringifies keys of nested hash without mutating itself. Does not handle nested arrays, though.
+Answers string keys of a nested hash without mutating itself. Does not handle nested arrays, though.
 
 [source,ruby]
 ----
@@ -360,7 +372,7 @@ example                      # {a: {b: 2}}
 
 ===== #deep_stringify_keys!
 
-Stringifies keys of nested hash while mutating itself. Does not handle nested arrays, though.
+Answers string keys of nested hash while mutating itself. Does not handle nested arrays, though.
 
 [source,ruby]
 ----
@@ -437,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
@@ -695,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.
@@ -827,14 +874,14 @@ parent_path = Pathname "/one"
 child_path = parent_path.join "two"
 
 child_path.make_path
-child_path.remove_tree   # Pathname "/one/two"
+parent_path.remove_tree  # Pathname "/one"
 child_path.exist?        # false
-paremt_path.exist?       # true
+parent_path.exist?       # false
 
 child_path.make_path
-parent_path.remove_tree  # Pathname "/one"
+child_path.remove_tree   # Pathname "/one/two"
 child_path.exist?        # false
-parent_path.exist?       # false
+parent_path.exist?       # true
 ----
 
 ===== #rewrite
@@ -886,7 +933,7 @@ Answers `true`/`false` based on whether string is blank, `<space>`, `\n`, `\t`,
 
 ===== #camelcase
 
-Answers a camelcased string.
+Answers a camel cased string.
 
 [source,ruby]
 ----
@@ -895,7 +942,7 @@ Answers a camelcased string.
 
 ===== #down
 
-Answers string with only first letter downcased.
+Answers string with only first letter down cased.
 
 [source,ruby]
 ----
@@ -977,7 +1024,7 @@ well in other languages.
 
 ===== #snakecase
 
-Answers a snakecased string.
+Answers a snake cased string.
 
 [source,ruby]
 ----
@@ -986,7 +1033,7 @@ Answers a snakecased string.
 
 ===== #titleize
 
-Answers titleized string.
+Answers a title string with proper capitalization of each word.
 
 [source,ruby]
 ----
@@ -1008,7 +1055,7 @@ Answers string as a boolean.
 
 ===== #up
 
-Answers string with only first letter upcased.
+Answers string with only first letter capitalized.
 
 [source,ruby]
 ----
@@ -1038,6 +1085,8 @@ buffer                     # "This is a test."
 
 ===== .keyworded?
 
+⚠️ Will be removed in the next major version. Use `.keyword_init?` instead.
+
 Answers whether a struct was constructed with keyword or positional arguments.
 
 [source,ruby]
@@ -1054,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
@@ -1072,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>
+----
+
+===== #transmute
+
+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>
+----
 
-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 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
@@ -1219,35 +1287,17 @@ To test, run:
 bundle exec rake
 ----
 
-== Versioning
-
-Read link:https://semver.org[Semantic Versioning] for details. Briefly, it means:
-
-* Major (X.y.z) - Incremented for any backwards incompatible public API changes.
-* Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
-* Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.
-
-== Code of Conduct
-
-Please note that this project is released with a link:CODE_OF_CONDUCT.adoc[CODE OF CONDUCT]. By
-participating in this project you agree to abide by its terms.
-
-== Contributions
-
-Read link:CONTRIBUTING.adoc[CONTRIBUTING] for details.
-
-== Community
+== link:https://www.alchemists.io/policies/license[License]
 
-Feel free to link:https://www.alchemists.io/community[join the commmunity] for discussions related
-to this project and much more.
+== link:https://www.alchemists.io/policies/security[Security]
 
-== License
+== link:https://www.alchemists.io/policies/code_of_conduct[Code of Conduct]
 
-Read link:LICENSE.adoc[LICENSE] for details.
+== link:https://www.alchemists.io/policies/contributions[Contributions]
 
-== Changes
+== link:https://www.alchemists.io/projects/refinements/versions[Versions]
 
-Read link:CHANGES.adoc[CHANGES] for details.
+== link:https://www.alchemists.io/community[Community]
 
 == Credits
 

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!
@@ -42,11 +46,9 @@ module Refinements
 
       def deep_symbolize_keys! = replace(deep_symbolize_keys)
 
-      # rubocop:disable Style/MethodDefParentheses
       def fetch_value(key, *default_value, &)
         fetch(key, *default_value, &) || default_value.first
       end
-      # rubocop:enable Style/MethodDefParentheses
 
       # :reek:TooManyStatements
       def flatten_keys prefix: nil, delimiter: "_", cast: :to_sym

data/lib/refinements/pathnames.rb

@@ -17,7 +17,11 @@ module Refinements
       def home = new(ENV["HOME"])
 
       def make_temp_dir prefix: "temp-", suffix: nil, root: nil
-        Dir.mktmpdir([prefix, suffix], root) { |path| block_given? ? yield(new path) : new(path) }
+        if block_given?
+          Dir.mktmpdir([prefix, suffix], root) { |path| yield new(path) }
+        else
+          new Dir.mktmpdir([prefix, suffix], root)
+        end
       end
 
       def require_tree root, pattern = "**/*.rb"
@@ -46,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
@@ -70,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

@@ -4,18 +4,21 @@ module Refinements
   # Provides additional enhancements to the Struct primitive.
   module Structs
     refine Struct.singleton_class do
-      def keyworded? = inspect.include?("keyword_init: true")
+      def keyworded?
+        warn "[DEPRECATION]: .keyworded? is deprecated, use .keyword_init? instead."
+        inspect.include? "keyword_init: true"
+      end
 
-      def with_keywords(**arguments) = keyworded? ? new(**arguments) : new.merge!(**arguments)
+      def with_keywords(**arguments) = keyword_init? ? new(**arguments) : new.merge!(**arguments)
 
-      def with_positions(*values) = keyworded? ? new(**members.zip(values).to_h) : new(*values)
+      def with_positions(*values) = keyword_init? ? new(**members.zip(values).to_h) : new(*values)
     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
 
@@ -31,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

data/lib/refinements/symbols.rb

@@ -4,11 +4,9 @@ module Refinements
   # Provides additional enhancements to the Symbol primitive.
   module Symbols
     refine Symbol do
-      # rubocop:disable Style/MethodDefParentheses
       def call(*arguments, &)
         proc { |receiver| receiver.public_send self, *arguments, & }
       end
-      # rubocop:enable Style/MethodDefParentheses
     end
   end
 end

data/lib/refinements.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "refinements/identity"
 require "refinements/arrays"
 require "refinements/big_decimals"
 require "refinements/date_times"

data/refinements.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name = "refinements"
+  spec.version = "9.2.0"
+  spec.platform = Gem::Platform::RUBY
+  spec.authors = ["Brooke Kuhlmann"]
+  spec.email = ["brooke@alchemists.io"]
+  spec.homepage = "https://www.alchemists.io/projects/refinements"
+  spec.summary = "A collection of refinements to core Ruby objects."
+  spec.license = "Hippocratic-3.0"
+
+  spec.metadata = {
+    "bug_tracker_uri" => "https://github.com/bkuhlmann/refinements/issues",
+    "changelog_uri" => "https://www.alchemists.io/projects/refinements/versions",
+    "documentation_uri" => "https://www.alchemists.io/projects/refinements",
+    "label" => "Refinements",
+    "rubygems_mfa_required" => "true",
+    "source_code_uri" => "https://github.com/bkuhlmann/refinements"
+  }
+
+  spec.signing_key = Gem.default_key_path
+  spec.cert_chain = [Gem.default_cert_path]
+
+  spec.required_ruby_version = "~> 3.1"
+
+  spec.files = Dir["*.gemspec", "lib/**/*"]
+  spec.extra_rdoc_files = Dir["README*", "LICENSE*"]
+  spec.require_paths = ["lib"]
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 9.0.0
+  version: 9.2.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   lkHilIrX69jq8wMPpBhlaw2mRmeSL50Wv5u6xVBvOHhXFSP1crXM95vfLhLyRYod
   W2A=
   -----END CERTIFICATE-----
-date: 2021-12-26 00:00:00.000000000 Z
+date: 2022-01-23 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -46,20 +46,22 @@ files:
 - lib/refinements/big_decimals.rb
 - lib/refinements/date_times.rb
 - lib/refinements/hashes.rb
-- 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
 - lib/refinements/symbols.rb
+- refinements.gemspec
 homepage: https://www.alchemists.io/projects/refinements
 licenses:
 - Hippocratic-3.0
 metadata:
   bug_tracker_uri: https://github.com/bkuhlmann/refinements/issues
-  changelog_uri: https://www.alchemists.io/projects/refinements/changes.html
+  changelog_uri: https://www.alchemists.io/projects/refinements/versions
   documentation_uri: https://www.alchemists.io/projects/refinements
+  label: Refinements
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/bkuhlmann/refinements
 post_install_message:
@@ -77,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
+rubygems_version: 3.3.5
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.

data/lib/refinements/identity.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Refinements
-  # Gem identity information.
-  module Identity
-    NAME = "refinements"
-    LABEL = "Refinements"
-    VERSION = "9.0.0"
-    VERSION_LABEL = "#{LABEL} #{VERSION}".freeze
-  end
-end