refinements 7.4.0 → 7.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa83a3ce542b62b6d89204aea8ac2411565a401f26150bfcdc64a2d4334d0313
-  data.tar.gz: c34503ce9aa7b522eac87ff66384fc8c1815c5907e4048a6023208f948a33cd1
+  metadata.gz: ba7c2934d38986ae19d3a41bdc1305164ebe2355bb30afa925eebbeb9746f962
+  data.tar.gz: 1945d2226c6ca304aa9958635aab6a87880b66e43566691c3ab509f5b2e77f6b
 SHA512:
-  metadata.gz: 8bc6f8633db7a9caed51998e190aeccb77b74a755d83a8a982e93d7c4c9576044598e626b9457fb40da667aff76c9d87314ad42f4e2815d8287435eee5d71e2a
-  data.tar.gz: c23828f5179b57747cd0a173baa7deeee2fc1513791ecf1042612a23addf8443c7c012c6f316596b197a8765904e66d93f31141037271673e50bf2a6b9b56da8
+  metadata.gz: 34e601f3bfe0ebe6b35ddf54dea67ef9c33d7436fae5103a2ce03106a34026f1920a6f06369ba2516ceb0a550bb6868fcd5491084cca5b6dd20ed746b4772a39
+  data.tar.gz: 8e4d5de5f29f28df044333dbaa34fb0a6d9b34911e3e911bd5593caf4dfeb52c0c0767f5a01d164542c54a4d936453b14f6131c055234a5911d73c80673c7d14

data/README.adoc

@@ -15,62 +15,22 @@ toc::[]
 
 == Features
 
-* *Arrays*:
-** `#compress` - Removes `nil` and empty values without modifying itself.
-** `#compress!` - Removes `nil` and empty values while modifying itself.
-** `#ring` - Answers a circular array which can enumerate before, current, after elements.
-* *BigDecimals*:
-** `#inspect` - Allows one to inspect a big decimal with numeric representation.
-* *DateTimes*:
-** `.utc` - Answers new DateTime object for current UTC date/time.
-* *Files*:
-** `#rewrite` - When given a file path and a block, it provides the contents of the recently read
-file for manipulation and immediate writing back to the same file.
-* *Hashes*:
-** `#except` - Answers new hash with given keys removed without modifying calling hash.
-** `#except!` - Answers new hash with given keys removed while modifying calling hash.
-** `#symbolize_keys` - Converts keys to symbols without modifying itself.
-** `#symbolize_keys!` - Converts keys to symbols while modifying itself.
-** `#deep_merge` - Merges deeply nested hashes together without modifying itself.
-** `#deep_merge!` - Merges deeply nested hashes together while modifying itself.
-** `#deep_symbolize_keys` - Symbolizes keys of nested hash without modifying itself. Does not handle
-   nested arrays, though.
-** `#deep_symbolize_keys!` - Symbolizes keys of nested hash while modifying itself. Does not handle
-   nested arrays, though.
-** `#recurse` - Applies block to nested hash. Does not handle nested arrays, though.
-** `#rekey` - Transforms keys per mapping (size of mapping can vary).
-** `#reverse_merge` - Merges calling hash into passed in hash without modifying calling hash.
-** `#reverse_merge!` - Merges calling hash into passed in hash while modifying calling hash.
-** `#use` - Passes each hash value as a block argument for further processing.
-* *Pathnames*:
-** `#name` - Answers file name without extension.
-** `#copy` - Copies file from current location to new location.
-** `#directories` - Answers all or filtered directories for current path.
-** `#extensions` - Answers file extensions as an array.
-** `#files` - Answers all or filtered files for current path.
-** `#relative_parent_from` - Answers relative path from parent directory. This is a complement to
-   `#relative_path_from`.
-** `#make_ancestors` - Ensures all ancestor directories are created for a path.
-** `#rewrite` - When given a block, it provides the contents of the recently read file for
-manipulation and immediate writing back to the same file.
-** `#touch` - Updates access and modification times to current time for path.
-* *Strings*:
-** `#first` - Answers first character of a string or first set of characters if given a number.
-** `#last` - Answers last character of a string or last set of characters if given a number.
-** `#blank?` - Answers `true`/`false` based on whether string is blank or not
-(i.e. `<space>`, `\n`, `\t`, `\r`).
-** `#up` - Answers string with only first letter upcased.
-** `#down` - Answers string with only first letter downcased.
-** `#camelcase` - Answers a camelcased string.
-** `#snakecase` - Answers a snakecased string.
-** `#titleize` - Answers titleized string.
-** `#to_bool` - Answers string as a boolean.
+Enhances the following objects:
+
+* Array
+* BigDecimal
+* DateTime
+* File
+* Hash
+* Pathname
+* String
+* StringIO
 
 == Requirements
 
-. https://www.ruby-lang.org[Ruby 2.7.x].
-. A solid understanding of https://www.youtube.com/watch?v=qXC9Gk4dCEw[Ruby refinements and lexical
-scope].
+. https://www.ruby-lang.org[Ruby].
+. A solid understanding of link:https://www.alchemists.io/articles/ruby_refinements[Ruby refinements
+  and lexical scope].
 
 == Setup
 
@@ -130,6 +90,7 @@ require "refinements/files"
 require "refinements/hashes"
 require "refinements/pathnames"
 require "refinements/strings"
+require "refinements/string_ios"
 ----
 
 === Using
@@ -146,6 +107,7 @@ class Example
   using Refinements::Hashes
   using Refinements::Pathnames
   using Refinements::Strings
+  using Refinements::StringIOs
 end
 ----
 
@@ -155,19 +117,58 @@ The following sections demonstrate how each refinement enriches your objects wit
 
 ==== Array
 
+===== #compress
+
+Removes `nil` and empty values without modifying itself.
+
 [source,ruby]
 ----
 example = ["An", nil, "", "Example"]
-example.compress # => ["An", "Example"]
-example # => ["An", nil, "", "Example"]
+example.compress  # => ["An", "Example"]
+example           # => ["An", nil, "", "Example"]
+----
+
+===== #compress!
 
+Removes `nil` and empty values while modifying itself.
+
+[source,ruby]
+----
 example = ["An", nil, "", "Example"]
-example.compress! # => ["An", "Example"]
-example # => ["An", "Example"]
+example.compress!  # => ["An", "Example"]
+example            # => ["An", "Example"]
+----
+
+===== #include
+
+Adds given array or elements without modifying itself.
+
+[source,ruby]
+----
+[1, 2, 3].include [4, 5]  # => [1, 2, 3, 4, 5]
+[1, 2, 3].include 4, 5    # => [1, 2, 3, 4, 5]
+----
+
+===== #exclude
+
+Removes given array or elements without modifying itself.
+
+[source,ruby]
+----
+[1, 2, 3, 4, 5].exclude [4, 5]  # => [1, 2, 3]
+[1, 2, 3, 4, 5].exclude 4, 5    # => [1, 2, 3]
+----
+
+===== #ring
 
+Answers a circular array which can enumerate before, current, after elements.
+
+[source,ruby]
+----
 example = [1, 2, 3]
 example.ring # => #<Enumerator: ...>
 example.ring { |(before, current, after)| puts "#{before} #{current} #{after}" }
+
 # [3 1 2]
 # [1 2 3]
 # [2 3 1]
@@ -175,6 +176,10 @@ example.ring { |(before, current, after)| puts "#{before} #{current} #{after}" }
 
 ==== Big Decimal
 
+===== #inspect
+
+Allows one to inspect a big decimal with numeric representation.
+
 [source,ruby]
 ----
 BigDecimal.new("5.0E-10").inspect # => "#<BigDecimal:3fd3d458fe84 0.0000000005>"
@@ -182,6 +187,10 @@ BigDecimal.new("5.0E-10").inspect # => "#<BigDecimal:3fd3d458fe84 0.0000000005>"
 
 ==== DateTime
 
+===== .utc
+
+Answers new DateTime object for current UTC date/time.
+
 [source,ruby]
 ----
 DateTime.utc # => #<DateTime: 2019-12-31T18:17:00+00:00 ((2458849j,65820s,181867000n),+0s,2299161j)>
@@ -189,6 +198,11 @@ DateTime.utc # => #<DateTime: 2019-12-31T18:17:00+00:00 ((2458849j,65820s,181867
 
 ==== File
 
+===== .rewrite
+
+When given a file path and a block, it provides the contents of the recently read file for
+manipulation and immediate writing back to the same file.
+
 [source,ruby]
 ----
 File.rewrite("/test.txt") { |content| content.gsub "[placeholder]", "example" }
@@ -196,122 +210,432 @@ File.rewrite("/test.txt") { |content| content.gsub "[placeholder]", "example" }
 
 ==== Hash
 
+===== .infinite
+
+Answers new hash where missing keys, even deeply nested, answer an empty hash.
+
+[source,ruby]
+----
+example = Hash.infinite
+example[:a]          # => {}
+example[:a][:b][:c]  # => {}
+----
+
+===== .with_default
+
+Answers new hash where every top-level missing key has the same default value.
+
+[source,ruby]
+----
+example = Hash.with_default ""
+example[:a] # => ""
+
+example = Hash.with_default []
+example[:b] # => []
+----
+
+===== #except
+
+Answers new hash with given keys removed without modifying itself.
+
 [source,ruby]
 ----
 example = {a: 1, b: 2, c: 3}
-example.except :a, :b # => {c: 3}
-example # => {a: 1, b: 2, c: 3}
+example.except :a, :b  # => {c: 3}
+example                # => {a: 1, b: 2, c: 3}
+----
+
+===== #except!
+
+Answers new hash with given keys removed while modifying itself.
 
+[source,ruby]
+----
 example = {a: 1, b: 2, c: 3}
-example.except! :a, :b # => {c: 3}
-example # => {c: 3}
+example.except! :a, :b  # => {c: 3}
+example                 # => {c: 3}
+----
+
+===== #flatten_keys
+
+Flattens nested keys as top-level keys without modifying itself. Does not handle nested arrays,
+though.
+
+[source,ruby]
+----
+{a: {b: 1}}.flatten_keys prefix: :test  # => {test_a_b: 1}
+{a: {b: 1}}.flatten_keys delimiter: :|  # => {:"a|b" => 1}
+
+{a: {b: 1}}.flatten_keys cast: :to_s            # => {"a_b" => 1}
+{"a" => {"b" => 1}}.flatten_keys cast: :to_sym  # => {a_b: 1}
+
+example = {a: {b: 1}}
+example.flatten_keys  # => {a_b: 1}
+example               # => {a: {b: 1}}
+----
 
+===== #flatten_keys!
+
+Flattens nested keys as top-level keys while modifying itself. Does not handle nested arrays,
+though.
+
+[source,ruby]
+----
+example = {a: {b: 1}}
+example.flatten_keys!  # => {a_b: 1}
+example                # => {a_b: 1}
+----
+
+===== #symbolize_keys
+
+Converts keys to symbols without modifying itself.
+
+[source,ruby]
+----
 example = {"a" => 1, "b" => 2}
-example.symbolize_keys # => {a: 1, b: 2}
-example # => {"a" => 1, "b" => 2}
+example.symbolize_keys  # => {a: 1, b: 2}
+example                 # => {"a" => 1, "b" => 2}
+----
 
+===== #symbolize_keys!
+
+Converts keys to symbols while modifying itself.
+
+[source,ruby]
+----
 example = {"a" => 1, "b" => 2}
-example.symbolize_keys! # => {a: 1, b: 2}
-example # => {a: 1, b: 2}
+example.symbolize_keys!  # => {a: 1, b: 2}
+example                  # => {a: 1, b: 2}
+----
 
-example = {a: 1, b: 2, c: 3}
-example.slice :a, :c # => {a: 1, c: 3}
-example # => {a: 1, b: 2, c: 3}
+===== #deep_merge
 
-example = {a: 1, b: 2, c: 3}
-example.slice! :a, :c # => {a: 1, c: 3}
-example # => {a: 1, c: 3}
+Merges deeply nested hashes together without modifying itself.
 
+[source,ruby]
+----
 example = {a: "A", b: {one: "One", two: "Two"}}
-example.deep_merge b: {one: 1} # => {a: "A", b: {one: 1, two: "Two"}}
-example # => {a: "A", b: {one: "One", two: "Two"}}
+example.deep_merge b: {one: 1}  # => {a: "A", b: {one: 1, two: "Two"}}
+example                         # => {a: "A", b: {one: "One", two: "Two"}}
+----
+
+===== #deep_merge!
+
+Merges deeply nested hashes together while modifying itself.
 
+[source,ruby]
+----
 example = {a: "A", b: {one: "One", two: "Two"}}
-example.deep_merge! b: {one: 1} # => {a: "A", b: {one: 1, two: "Two"}}
-example # => {a: "A", b: {one: 1, two: "Two"}}
+example.deep_merge! b: {one: 1}  # => {a: "A", b: {one: 1, two: "Two"}}
+example                          # => {a: "A", b: {one: 1, two: "Two"}}
+----
 
+===== #deep_symbolize_keys
+
+Symbolizes keys of nested hash without modifying itself. Does not handle nested arrays, though.
+
+[source,ruby]
+----
 example = {"a" => {"b" => 2}}
-example.deep_symbolize_keys # => {a: {b: 1}}
-example # => {"a" => {"b" => 2}}
+example.deep_symbolize_keys  # => {a: {b: 1}}
+example                      # => {"a" => {"b" => 2}}
+----
+
+===== #deep_symbolize_keys!
 
+Symbolizes keys of nested hash while modifying itself. Does not handle nested arrays, though.
+
+[source,ruby]
+----
 example = {"a" => {"b" => 2}}
-example.deep_symbolize_keys! # => {a: {b: 1}}
-example # => {a: {b: 1}}
+example.deep_symbolize_keys!  # => {a: {b: 1}}
+example                       # => {a: {b: 1}}
+----
+
+===== #recurse
+
+Applies block to nested hash. Does not handle nested arrays, though.
 
+[source,ruby]
+----
 example = {"a" => {"b" => 1}}
-example.recurse(&:symbolize_keys) # => {a: {b: 1}}
-example.recurse(&:invert) # => {{"b" => 1} => "a"}
+example.recurse(&:symbolize_keys)  # => {a: {b: 1}}
+example.recurse(&:invert)          # => {{"b" => 1} => "a"}
+----
 
+===== #rekey
+
+Transforms keys per mapping (size of mapping can vary) without modifying itself.
+
+[source,ruby]
+----
+example = {a: 1, b: 2, c: 3}
+example.rekey a: :amber, b: :blue  # => {amber: 1, blue: 2, c: 3}
+example                            # => {a: 1, b: 2, c: 3}
+----
+
+===== #rekey!
+
+Transforms keys per mapping (size of mapping can vary) while modifying itself.
+
+[source,ruby]
+----
 example = {a: 1, b: 2, c: 3}
-example.rekey a: :amber, b: :blue # => {amber: 1, blue: 2, c: 3}
+example.rekey! a: :amber, b: :blue  # => {amber: 1, blue: 2, c: 3}
+example                             # => {amber: 1, blue: 2, c: 3}
+----
+
+===== #reverse_merge
+
+Merges calling hash into passed in hash without modifying itself.
 
+[source,ruby]
+----
 example = {a: 1, b: 2}
-example.reverse_merge a: 0, c: 3 # => {a: 1, b: 2, c: 3}
-example # => {a: 1, b: 2}
+example.reverse_merge a: 0, c: 3  # => {a: 1, b: 2, c: 3}
+example                           # => {a: 1, b: 2}
+----
+
+===== #reverse_merge!
 
+Merges calling hash into passed in hash while modifying itself.
+
+[source,ruby]
+----
 example = {a: 1, b: 2}
-example.reverse_merge! a: 0, c: 3 # => {a: 1, b: 2, c: 3}
-example # => {a: 1, b: 2, c: 3}
+example.reverse_merge! a: 0, c: 3  # => {a: 1, b: 2, c: 3}
+example                            # => {a: 1, b: 2, c: 3}
+----
 
+===== #use
+
+Passes each hash value as a block argument for further processing.
+
+[source,ruby]
+----
 example = {unit: "221B", street: "Baker Street", city: "London", country: "UK"}
 example.use { |unit, street| "#{unit} #{street}" } # => "221B Baker Street"
 ----
 
 ==== Pathname
 
+===== Pathname
+
+Conversion function (refined from `Kernel`) which can cast `nil` into a pathname.
+
+[source,ruby]
+----
+Pathname(nil) # => Pathname("")
+----
+
+===== #name
+
+Answers file name without extension.
+
 [source,ruby]
 ----
 Pathname("example.txt").name # => Pathname("example")
+----
+
+===== #copy
+
+Copies file from current location to new location.
 
+[source,ruby]
+----
 Pathname("input.txt").copy Pathname("output.txt")
+----
+
+===== #directories
 
-Pathname("/example").directories # => [Pathname("a"), Pathname("b")]
-Pathname("/example").directories "a*" # => [Pathname("a")]
+Answers all or filtered directories for current path.
 
+[source,ruby]
+----
+Pathname("/example").directories                           # => [Pathname("a"), Pathname("b")]
+Pathname("/example").directories "a*"                      # => [Pathname("a")]
+Pathname("/example").directories flag: File::FNM_DOTMATCH  # => [Pathname(".."), Pathname(".")]
+----
+
+===== #extensions
+
+Answers file extensions as an array.
+
+[source,ruby]
+----
 Pathname("example.txt.erb").extensions # => [".txt", ".erb"]
+----
 
-Pathname("/example").files # => [Pathname("a.txt"), Pathname("a.png")]
-Pathname("/example").files "*.png" # => [Pathname("a.png")]
+===== #files
 
-Pathname("/one/two/three").relative_parent_from("/one") # => Pathname "two"
+Answers all or filtered files for current path.
+
+[source,ruby]
+----
+Pathname("/example").files                           # => [Pathname("a.txt"), Pathname("a.png")]
+Pathname("/example").files "*.png"                   # => [Pathname("a.png")]
+Pathname("/example").files flag: File::FNM_DOTMATCH  # => [Pathname(".ruby-version")]
+----
+
+===== #gsub
+
+Same behavior as `String#gsub` but answers a path with patterns replaced with desired substitutes.
+
+[source,ruby]
+----
+Pathname("/a/path/some/path").gsub("path", "test")
+# => Pathname("/a/test/some/test")
 
+Pathname("/%placeholder%/some/%placeholder%").gsub("%placeholder%", "test")
+# => Pathname("/test/some/test")
+----
+
+===== #relative_parent
+
+Answers relative path from parent directory. This is a complement to `#relative_path_from`.
+
+[source,ruby]
+----
+Pathname("/one/two/three").relative_parent("/one") # => Pathname "two"
+----
+
+===== #make_ancestors
+
+Ensures all ancestor directories are created for a path.
+
+[source,ruby]
+----
 Pathname("/one/two").make_ancestors
-Pathname("/one").exist? # => true
-Pathname("/one/two").exist? # => false
+Pathname("/one").exist?      # => true
+Pathname("/one/two").exist?  # => false
+----
+
+===== #rewrite
 
+When given a block, it provides the contents of the recently read file for manipulation and
+immediate writing back to the same file.
+
+[source,ruby]
+----
 Pathname("/test.txt").rewrite { |content| content.sub "[placeholder]", "example" }
+----
 
+===== #touch
+
+Updates access and modification times for path. Defaults to current time.
+
+[source,ruby]
+----
 Pathname("example.txt").touch
-Pathname("example.txt").touch accessed_at: Time.now - 1, modified_at: Time.now - 1
+Pathname("example.txt").touch at: Time.now - 1
 ----
 
 ==== String
 
+===== #first
+
+Answers first character of a string or first set of characters if given a number.
+
+[source,ruby]
+----
+"example".first    # => "e"
+"example".first 4  # => "exam"
+----
+
+===== #last
+
+Answers last character of a string or last set of characters if given a number.
+
 [source,ruby]
 ----
-"example".first # => "e"
-"example".first 4 # => "exam"
+"instant".last    # => "t"
+"instant".last 3  # => "ant"
+----
 
-"instant".last # => "t"
-"instant".last 3 # => "ant"
+===== #blank?
 
+Answers `true`/`false` based on whether string is blank, `<space>`, `\n`, `\t`, and/or `\r`.
+
+[source,ruby]
+----
 " \n\t\r".blank? # => true
+----
+
+===== #up
+
+Answers string with only first letter upcased.
 
+[source,ruby]
+----
 "example".up # => "Example"
+----
+
+===== #down
 
+Answers string with only first letter downcased.
+
+[source,ruby]
+----
 "EXAMPLE".down # => "eXAMPLE"
+----
+
+===== #camelcase
 
+Answers a camelcased string.
+
+[source,ruby]
+----
 "this_is_an_example".camelcase # => "ThisIsAnExample"
+----
+
+===== #snakecase
+
+Answers a snakecased string.
 
+[source,ruby]
+----
 "ThisIsAnExample".snakecase # => "this_is_an_example"
+----
+
+===== #titleize
 
+Answers titleized string.
+
+[source,ruby]
+----
 "ThisIsAnExample".titleize # => "This Is An Example"
+----
+
+===== #to_bool
+
+Answers string as a boolean.
+
+[source,ruby]
+----
+"true".to_bool     # => true
+"yes".to_bool      # => true
+"1".to_bool        # => true
+"".to_bool         # => false
+"example".to_bool  # => false
+----
+
+==== String IO
+
+===== #reread
+
+Answers full string by rewinding to beginning of string and reading all content.
+
+[source,ruby]
+----
+io = StringIO.new
+io.write "This is a test."
+
+io.reread    # => "This is a test."
+io.reread 4  # => "This"
 
-"true".to_bool # => true
-"yes".to_bool # => true
-"1".to_bool # => true
-"".to_bool # => false
-"example".to_bool # => false
+buffer = "".dup
+io.reread(buffer: buffer)
+buffer # => "This is a test."
 ----
 
 == Tests

data/lib/refinements.rb

@@ -8,3 +8,4 @@ require "refinements/files"
 require "refinements/hashes"
 require "refinements/pathnames"
 require "refinements/strings"
+require "refinements/string_ios"

data/lib/refinements/arrays.rb

@@ -11,6 +11,14 @@ module Refinements
         replace compress
       end
 
+      def include *elements
+        self + elements.flatten
+      end
+
+      def exclude *elements
+        self - elements.flatten
+      end
+
       def ring &block
         [last, *self, first].each_cons 3, &block
       end

data/lib/refinements/files.rb

@@ -4,6 +4,7 @@ module Refinements
   module Files
     refine File.singleton_class do
       def rewrite path
+        warn "[DEPRECATION]: File.rewrite is deprecated, use Pathname#rewrite instead."
         read(path).then { |content| write path, yield(content) }
       end
     end

data/lib/refinements/hashes.rb

@@ -2,6 +2,16 @@
 
 module Refinements
   module Hashes
+    refine Hash.singleton_class do
+      def infinite
+        new { |new_hash, missing_key| new_hash[missing_key] = new(&new_hash.default_proc) }
+      end
+
+      def with_default value
+        new { |new_hash, missing_key| new_hash[missing_key] = value }
+      end
+    end
+
     refine Hash do
       def except *keys
         reject { |key, _value| keys.include? key }
@@ -11,6 +21,25 @@ module Refinements
         replace except(*keys)
       end
 
+      # :reek:TooManyStatements
+      def flatten_keys prefix: nil, delimiter: "_", cast: :to_sym
+        fail StandardError, "Unknown cast: #{cast}." unless %i[to_sym to_s].include? cast
+
+        reduce({}) do |flat, (key, value)|
+          flat_key = prefix ? "#{prefix}#{delimiter}#{key}" : key
+
+          next flat.merge flat_key.public_send(cast) => value unless value.is_a? self.class
+
+          flat.merge(
+            recurse { value.flatten_keys prefix: flat_key, delimiter: delimiter, cast: cast }
+          )
+        end
+      end
+
+      def flatten_keys! prefix: nil, delimiter: "_", cast: :to_sym
+        replace flatten_keys(prefix: prefix, delimiter: delimiter, cast: cast)
+      end
+
       def symbolize_keys
         reduce({}) { |hash, (key, value)| hash.merge key.to_sym => value }
       end
@@ -20,13 +49,9 @@ module Refinements
       end
 
       def deep_merge other
-        dup.deep_merge! other
-      end
-
-      def deep_merge! other
         clazz = self.class
 
-        merge! other do |_key, this_value, other_value|
+        merge other do |_key, this_value, other_value|
           if this_value.is_a?(clazz) && other_value.is_a?(clazz)
             this_value.deep_merge other_value
           else
@@ -35,12 +60,16 @@ module Refinements
         end
       end
 
+      def deep_merge! other
+        replace deep_merge(other)
+      end
+
       def deep_symbolize_keys
         recurse(&:symbolize_keys)
       end
 
       def deep_symbolize_keys!
-        recurse(&:symbolize_keys!)
+        replace deep_symbolize_keys
       end
 
       def recurse &block
@@ -65,12 +94,12 @@ module Refinements
 
       def reverse_merge other
         warn "[DEPRECATION]: #reverse_merge is deprecated, use #merge instead."
-        other.merge self
+        merge(other) { |_key, old_value, _new_value| old_value }
       end
 
       def reverse_merge! other
         warn "[DEPRECATION]: #reverse_merge! is deprecated, use #merge! instead."
-        merge!(other) { |_key, old_value, _new_value| old_value }
+        replace reverse_merge(other)
       end
 
       def use &block

data/lib/refinements/identity.rb

@@ -5,7 +5,7 @@ module Refinements
   module Identity
     NAME = "refinements"
     LABEL = "Refinements"
-    VERSION = "7.4.0"
+    VERSION = "7.9.0"
     VERSION_LABEL = "#{LABEL} #{VERSION}"
   end
 end

data/lib/refinements/pathnames.rb

@@ -4,6 +4,14 @@ require "pathname"
 
 module Refinements
   module Pathnames
+    refine Kernel do
+      def Pathname object
+        return super(String(object)) unless object
+
+        super
+      end
+    end
+
     refine Pathname do
       def name
         basename extname
@@ -15,20 +23,30 @@ module Refinements
         self
       end
 
-      def directories pattern = "*"
-        glob(pattern).select(&:directory?).sort
+      def directories pattern = "*", flag: File::FNM_SYSCASE
+        glob(pattern, flag).select(&:directory?).sort
       end
 
       def extensions
         basename.to_s.split(/(?=\.)+/).tap(&:shift)
       end
 
-      def files pattern = "*"
-        glob(pattern).select(&:file?).sort
+      def files pattern = "*", flag: File::FNM_SYSCASE
+        glob(pattern, flag).select(&:file?).sort
+      end
+
+      def gsub pattern, replacement
+        self.class.new to_s.gsub(pattern, replacement)
+      end
+
+      def relative_parent root_dir
+        relative_path_from(root_dir).parent
       end
 
-      def relative_parent_from root
-        relative_path_from(root).parent
+      def relative_parent_from root_dir
+        warn "[DEPRECATION]: Pathname#relative_parent_from is deprecated, " \
+             "use Pathname#relative_parent instead."
+        relative_parent root_dir
       end
 
       def make_ancestors

data/lib/refinements/string_ios.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "stringio"
+
+module Refinements
+  module StringIOs
+    refine StringIO do
+      def reread length = nil, buffer: nil
+        tap(&:rewind).read length, buffer
+      end
+    end
+  end
+end

data/lib/refinements/strings.rb

@@ -2,9 +2,12 @@
 
 module Refinements
   module Strings
+    DELIMITERS = %r([a-z][A-Z]|\s*-\s*|\s*/\s*|\s*:+\s*|\s*_\s*|\s+).freeze
+
     refine String.singleton_class do
       def delimiters
-        %r([a-z][A-Z]|\s*\-\s*|\s*\/\s*|\s*\:+\s*|\s*\_\s*|\s+)
+        warn "[DEPRECATION]: .delimiters is deprecated, use DELIMITERS instead."
+        DELIMITERS
       end
     end
 
@@ -17,20 +20,18 @@ module Refinements
         return self[0] if max.zero?
         return "" if max.negative?
 
-        self[0..(max - 1)]
+        self[..(max - 1)]
       end
 
-      # :reek:TooManyStatements
       def last number = 0
         return self if empty?
 
         min = Integer number
-        max = size - 1
 
-        return self[max] if min.zero?
+        return self[size - 1] if min.zero?
         return "" if min.negative?
 
-        self[(min + 1)..max]
+        self[(min + 1)..]
       end
 
       def blank?
@@ -50,33 +51,27 @@ module Refinements
       end
 
       def camelcase
-        if match? self.class.delimiters
-          split(%r(\s*\-\s*|\s*\/\s*|\s*\:+\s*)).then { |parts| combine parts, :up, "::" }
-                                                .then { |text| text.split(/\s*\_\s*|\s+/) }
-                                                .then { |parts| combine parts, :up }
-        else
-          up
-        end
+        return up unless match? DELIMITERS
+
+        split(%r(\s*-\s*|\s*/\s*|\s*:+\s*)).then { |parts| combine parts, :up, "::" }
+                                           .then { |text| text.split(/\s*_\s*|\s+/) }
+                                           .then { |parts| combine parts, :up }
       end
 
       def snakecase
-        if match? self.class.delimiters
-          split(%r(\s*\-\s*|\s*\/\s*|\s*\:+\s*)).then { |parts| combine parts, :down, "/" }
-                                                .then { |txt| txt.split(/(?=[A-Z])|\s*\_\s*|\s+/) }
-                                                .then { |parts| combine parts, :down, "_" }
-        else
-          downcase
-        end
+        return downcase unless match? DELIMITERS
+
+        split(%r(\s*-\s*|\s*/\s*|\s*:+\s*)).then { |parts| combine parts, :down, "/" }
+                                           .then { |text| text.split(/(?=[A-Z])|\s*_\s*|\s+/) }
+                                           .then { |parts| combine parts, :down, "_" }
       end
 
       def titleize
-        if match? self.class.delimiters
-          split(/(?=[A-Z])|\s*\_\s*|\s*\-\s*|\s+/).then { |parts| combine parts, :up, " " }
-                                                  .then { |text| text.split %r(\s*\/\s*|\s*\:+\s*) }
-                                                  .then { |parts| combine parts, :up, "/" }
-        else
-          capitalize
-        end
+        return capitalize unless match? DELIMITERS
+
+        split(/(?=[A-Z])|\s*_\s*|\s*-\s*|\s+/).then { |parts| combine parts, :up, " " }
+                                              .then { |text| text.split %r(\s*/\s*|\s*:+\s*) }
+                                              .then { |parts| combine parts, :up, "/" }
       end
 
       def to_bool

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 7.4.0
+  version: 7.9.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -28,7 +28,7 @@ cert_chain:
   2XV8FRa7/JimI07sPLC13eLY3xd/aYTi85Z782KIA4j0G8XEEWAX0ouBhlXPocZv
   QWc=
   -----END CERTIFICATE-----
-date: 2020-05-21 00:00:00.000000000 Z
+date: 2020-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -50,28 +50,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '14.0'
+        version: '14.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '14.0'
+        version: '14.2'
 - !ruby/object:Gem::Dependency
-  name: git-cop
+  name: git-lint
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
@@ -162,14 +162,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.83'
+        version: '0.89'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.83'
+        version: '0.89'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
@@ -218,15 +218,15 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.19'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
-description: 
+        version: '0.19'
+description:
 email:
 - brooke@alchemists.io
 executables: []
@@ -245,6 +245,7 @@ files:
 - lib/refinements/hashes.rb
 - lib/refinements/identity.rb
 - lib/refinements/pathnames.rb
+- lib/refinements/string_ios.rb
 - lib/refinements/strings.rb
 homepage: https://www.alchemists.io/projects/refinements
 licenses:
@@ -254,7 +255,7 @@ metadata:
   changelog_uri: https://www.alchemists.io/projects/refinements/changes.html
   documentation_uri: https://www.alchemists.io/projects/refinements
   source_code_uri: https://github.com/bkuhlmann/refinements
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -269,8 +270,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.3
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.
 test_files: []