refinements 7.4.0 → 7.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa83a3ce542b62b6d89204aea8ac2411565a401f26150bfcdc64a2d4334d0313
-  data.tar.gz: c34503ce9aa7b522eac87ff66384fc8c1815c5907e4048a6023208f948a33cd1
+  metadata.gz: 0ccd018fc5d5ae2bfa0b6fc1b9f090bc3638ac4053ea5790d7826e2c291bc378
+  data.tar.gz: 43cd2a8603f9e8667eab9c18aa24ccf5b1f7860054d88b7bc39e22df1bfad573
 SHA512:
-  metadata.gz: 8bc6f8633db7a9caed51998e190aeccb77b74a755d83a8a982e93d7c4c9576044598e626b9457fb40da667aff76c9d87314ad42f4e2815d8287435eee5d71e2a
-  data.tar.gz: c23828f5179b57747cd0a173baa7deeee2fc1513791ecf1042612a23addf8443c7c012c6f316596b197a8765904e66d93f31141037271673e50bf2a6b9b56da8
+  metadata.gz: b5dd7fb29e0de7fe1e51209d427889331d8179c5e92868167e818e25dd792509d4221cdf07448a86bea13820cb13ccf0c680cb4b459c7c57ebb0dc0017255aba
+  data.tar.gz: 94a069d63f4c565fd0c189d489887d23e7420bb63b8a9ec3cb5defc3626a87158037eb7cefdafdaa1b43e5b66764fda59dcf9007279cdcc3d8d53eadbf078bb7

data/README.adoc

@@ -27,8 +27,8 @@ toc::[]
 ** `#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.
+** `#except` - Answers new hash with given keys removed without modifying itself.
+** `#except!` - Answers new hash with given keys removed while modifying itself.
 ** `#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.
@@ -38,11 +38,13 @@ file for manipulation and immediate writing back to the same file.
 ** `#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.
+** `#rekey` - Transforms keys per mapping (size of mapping can vary) without modifying itself.
+** `#rekey!` - Transforms keys per mapping (size of mapping can vary) while modifying itself.
+** `#reverse_merge` - Merges calling hash into passed in hash without modifying itself.
+** `#reverse_merge!` - Merges calling hash into passed in hash while modifying itself.
 ** `#use` - Passes each hash value as a block argument for further processing.
 * *Pathnames*:
+** `Pathname` - Conversion function (refined from `Kernel`) which can cast `nil` into a pathname.
 ** `#name` - Answers file name without extension.
 ** `#copy` - Copies file from current location to new location.
 ** `#directories` - Answers all or filtered directories for current path.
@@ -53,7 +55,7 @@ file for manipulation and immediate writing back to the same file.
 ** `#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.
+** `#touch` - Updates access and modification times for path. Defaults to current time.
 * *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.
@@ -69,8 +71,8 @@ manipulation and immediate writing back to the same file.
 == 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].
+. A solid understanding of link:https://www.alchemists.io/articles/ruby_refinements[Ruby refinements
+  and lexical scope].
 
 == Setup
 
@@ -244,6 +246,11 @@ example.recurse(&:invert) # => {{"b" => 1} => "a"}
 
 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}
+
+example = {a: 1, b: 2, c: 3}
+example.rekey! a: :amber, b: :blue # => {amber: 1, blue: 2, c: 3}
+example # => {amber: 1, blue: 2, c: 3}
 
 example = {a: 1, b: 2}
 example.reverse_merge a: 0, c: 3 # => {a: 1, b: 2, c: 3}
@@ -261,6 +268,8 @@ example.use { |unit, street| "#{unit} #{street}" } # => "221B Baker Street"
 
 [source,ruby]
 ----
+Pathname(nil) # => Pathname("")
+
 Pathname("example.txt").name # => Pathname("example")
 
 Pathname("input.txt").copy Pathname("output.txt")
@@ -282,7 +291,7 @@ Pathname("/one/two").exist? # => false
 Pathname("/test.txt").rewrite { |content| content.sub "[placeholder]", "example" }
 
 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

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/identity.rb

@@ -5,7 +5,7 @@ module Refinements
   module Identity
     NAME = "refinements"
     LABEL = "Refinements"
-    VERSION = "7.4.0"
+    VERSION = "7.5.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

data/lib/refinements/strings.rb

@@ -4,7 +4,7 @@ module Refinements
   module Strings
     refine String.singleton_class do
       def delimiters
-        %r([a-z][A-Z]|\s*\-\s*|\s*\/\s*|\s*\:+\s*|\s*\_\s*|\s+)
+        %r([a-z][A-Z]|\s*-\s*|\s*/\s*|\s*:+\s*|\s*_\s*|\s+)
       end
     end
 
@@ -17,20 +17,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 +48,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? 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 }
       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? self.class.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? 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, "/" }
       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.5.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-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -226,7 +226,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.18'
-description: 
+description:
 email:
 - brooke@alchemists.io
 executables: []
@@ -254,7 +254,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 +269,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: []