refinements 8.4.1 → 9.0.0

data/lib/refinements/arrays.rb

@@ -27,7 +27,7 @@ module Refinements
 
       def pad(value, max: size) = dup.fill(value, size..(max - 1))
 
-      def ring(&block) = [last, *self, first].each_cons(3, &block)
+      def ring(&) = [last, *self, first].each_cons(3, &)
     end
   end
 end

data/lib/refinements/hashes.rb

@@ -42,6 +42,12 @@ 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
         fail StandardError, "Unknown cast: #{cast}." unless %i[to_sym to_s].include? cast
@@ -52,13 +58,13 @@ module Refinements
           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 }
+            recurse { value.flatten_keys prefix: flat_key, delimiter:, cast: }
           )
         end
       end
 
       def flatten_keys! prefix: nil, delimiter: "_", cast: :to_sym
-        replace flatten_keys(prefix: prefix, delimiter: delimiter, cast: cast)
+        replace flatten_keys(prefix:, delimiter:, cast:)
       end
 
       def recurse &block

data/lib/refinements/identity.rb

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

data/lib/refinements/ios.rb

@@ -26,7 +26,7 @@ module Refinements
 
       def reread(length = nil, buffer: nil) = tap(&:rewind).read(length, buffer)
 
-      def squelch(&block) = self.class.void.then { |void| redirect(void, &block) }
+      def squelch(&) = self.class.void.then { |void| redirect(void, &) }
     end
   end
 end

data/lib/refinements/pathnames.rb

@@ -28,8 +28,12 @@ module Refinements
     end
 
     refine Pathname do
-      def change_dir &block
-        block ? Dir.chdir(self, &block) : (Dir.chdir self and self)
+      def change_dir
+        if block_given?
+          Dir.chdir(self) { |path| yield Pathname(path) }
+        else
+          Dir.chdir self and self
+        end
       end
 
       def copy to
@@ -38,12 +42,16 @@ module Refinements
         self
       end
 
+      def deep_touch(...) = make_ancestors.touch(...)
+
       def delete = super && self
 
       def directories pattern = "*", flag: File::FNM_SYSCASE
         glob(pattern, flag).select(&:directory?).sort
       end
 
+      def empty = file? ? (truncate(0) and self) : remove_tree.make_dir
+
       def extensions = basename.to_s.split(/(?=\.)+/).tap(&:shift)
 
       def files(pattern = "*", flag: File::FNM_SYSCASE) = glob(pattern, flag).select(&:file?).sort

data/lib/refinements/strings.rb

@@ -16,39 +16,31 @@ module Refinements
                                            .then { |parts| combine parts, :up }
       end
 
-      def down
-        return self if empty?
-
-        first.downcase + self[1, size]
-      end
+      def down = empty? ? self : first.downcase + self[1, size]
 
-      def first number = 0
+      def first maximum = 0
         return self if empty?
+        return self[0] if maximum.zero?
+        return "" if maximum.negative?
 
-        max = Integer number
-
-        return self[0] if max.zero?
-        return "" if max.negative?
-
-        self[..(max - 1)]
+        self[..(maximum - 1)]
       end
 
       def indent multiplier = 1, padding: "  "
-        return self if multiplier.negative?
-
-        (padding * multiplier) + self
+        multiplier.negative? ? self : (padding * multiplier) + self
       end
 
-      def last number = 0
+      def last minimum = 0
         return self if empty?
+        return self[size - 1] if minimum.zero?
+        return "" if minimum.negative?
 
-        min = Integer number
+        self[(minimum + 1)..]
+      end
 
-        return self[size - 1] if min.zero?
-        return "" if min.negative?
+      def pluralize(suffix, replace: /$/, count: 0) = count.abs == 1 ? self : sub(replace, suffix)
 
-        self[(min + 1)..]
-      end
+      def singularize(suffix, replace: "", count: 1) = count.abs == 1 ? sub(suffix, replace) : self
 
       def snakecase
         return downcase unless match? DELIMITERS
@@ -68,11 +60,7 @@ module Refinements
 
       def to_bool = %w[true yes on t y 1].include?(downcase.strip)
 
-      def up
-        return self if empty?
-
-        first.upcase + self[1, size]
-      end
+      def up = empty? ? self : first.upcase + self[1, size]
 
       private
 

data/lib/refinements/structs.rb

@@ -12,10 +12,10 @@ module Refinements
     end
 
     refine Struct do
-      def merge(**attributes) = dup.merge!(**attributes)
+      def merge(object = nil) = dup.merge!(object)
 
-      def merge! **attributes
-        to_h.merge(**attributes).each { |key, value| self[key] = value }
+      def merge! object = nil
+        to_h.merge(**object.to_h).each { |key, value| self[key] = value }
         self
       end
 

data/lib/refinements/symbols.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+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

@@ -10,3 +10,4 @@ require "refinements/pathnames"
 require "refinements/strings"
 require "refinements/string_ios"
 require "refinements/structs"
+require "refinements/symbols"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 8.4.1
+  version: 9.0.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   lkHilIrX69jq8wMPpBhlaw2mRmeSL50Wv5u6xVBvOHhXFSP1crXM95vfLhLyRYod
   W2A=
   -----END CERTIFICATE-----
-date: 2021-10-03 00:00:00.000000000 Z
+date: 2021-12-26 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -52,13 +52,15 @@ files:
 - lib/refinements/string_ios.rb
 - lib/refinements/strings.rb
 - lib/refinements/structs.rb
+- lib/refinements/symbols.rb
 homepage: https://www.alchemists.io/projects/refinements
 licenses:
-- Apache-2.0
+- Hippocratic-3.0
 metadata:
   bug_tracker_uri: https://github.com/bkuhlmann/refinements/issues
   changelog_uri: https://www.alchemists.io/projects/refinements/changes.html
   documentation_uri: https://www.alchemists.io/projects/refinements
+  rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/bkuhlmann/refinements
 post_install_message:
 rdoc_options: []
@@ -68,14 +70,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.28
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.