refinements 8.2.2 → 8.5.1

data/lib/refinements/arrays.rb

@@ -1,11 +1,15 @@
 # frozen_string_literal: true
 
 module Refinements
+  # Provides additional enhancements to the Array primitive.
   module Arrays
     refine Array do
-      def compress = compact.reject(&:empty?)
+      def compress = dup.compress!
 
-      def compress! = replace(compress)
+      def compress!
+        compact!
+        delete_if { |element| element.respond_to?(:empty?) && element.empty? }
+      end
 
       def excluding(*elements) = self - elements.flatten
 

data/lib/refinements/big_decimals.rb

@@ -3,6 +3,7 @@
 require "bigdecimal"
 
 module Refinements
+  # Provides additional enhancements to the BigDecimal primitive.
   module BigDecimals
     refine BigDecimal do
       def inspect = format("#<BigDecimal:%{id} %{string}>", id: object_id, string: to_s("F"))

data/lib/refinements/classes.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Refinements
+  # Provides additional enhancements to Class objects.
+  module Classes
+    refine Class do
+      def descendants
+        ObjectSpace.each_object(singleton_class)
+                   .reject { |klass| klass.singleton_class? || klass == self }
+      end
+    end
+  end
+end

data/lib/refinements/date_times.rb

@@ -3,6 +3,7 @@
 require "date"
 
 module Refinements
+  # Provides additional enhancements to the DateTime primitive.
   module DateTimes
     refine DateTime.singleton_class do
       def utc = now.new_offset(0)

data/lib/refinements/hashes.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Refinements
+  # Provides additional enhancements to the Hash primitive.
   module Hashes
     refine Hash.singleton_class do
       def infinite
@@ -11,6 +12,14 @@ module Refinements
     end
 
     refine Hash do
+      def compress = dup.compress!
+
+      def compress!
+        return self if empty?
+
+        compact!.delete_if { |_key, value| value.respond_to?(:empty?) && value.empty? }
+      end
+
       def deep_merge other
         clazz = self.class
 
@@ -33,6 +42,10 @@ module Refinements
 
       def deep_symbolize_keys! = replace(deep_symbolize_keys)
 
+      def fetch_value key, *default_value, &block
+        fetch(key, *default_value, &block) || default_value.first
+      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
@@ -62,13 +75,13 @@ module Refinements
         end
       end
 
-      def stringify_keys = reduce({}) { |hash, (key, value)| hash.merge key.to_s => value }
+      def stringify_keys = transform_keys(&:to_s)
 
-      def stringify_keys! = replace(stringify_keys)
+      def stringify_keys! = transform_keys!(&:to_s)
 
-      def symbolize_keys = reduce({}) { |hash, (key, value)| hash.merge key.to_sym => value }
+      def symbolize_keys = transform_keys(&:to_sym)
 
-      def symbolize_keys! = replace(symbolize_keys)
+      def symbolize_keys! = transform_keys!(&:to_sym)
 
       def use &block
         return [] unless block

data/lib/refinements/identity.rb

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

data/lib/refinements/ios.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Refinements
+  # Provides additional enhancements to the IO primitive.
   module IOs
     refine IO.singleton_class do
       def void

data/lib/refinements/pathnames.rb

@@ -3,9 +3,9 @@
 require "pathname"
 
 module Refinements
+  # Provides additional enhancements to the Pathname primitive.
   module Pathnames
     refine Kernel do
-      # :reek:UncommunicativeMethodName
       def Pathname object
         return super(String(object)) unless object
 
@@ -24,12 +24,16 @@ module Refinements
         new(root).files(pattern).each { |path| require path.to_s }
       end
 
-      def root = new("/")
+      def root = new(File::SEPARATOR)
     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,10 +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/string_ios.rb

@@ -3,6 +3,7 @@
 require "stringio"
 
 module Refinements
+  # Provides additional enhancements to the StringIO primitive.
   module StringIOs
     refine StringIO do
       def reread(length = nil, buffer: nil) = tap(&:rewind).read(length, buffer)

data/lib/refinements/strings.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
 module Refinements
+  # Provides additional enhancements to the String primitive.
   module Strings
     DELIMITERS = %r([a-z][A-Z]|\s*-\s*|\s*/\s*|\s*:+\s*|\s*_\s*|\s+)
 
     refine String do
-      def blank? = match?(/\A\s*\z/)
+      def blank? = empty? || match?(/\A[[:space:]]*\z/)
 
       def camelcase
         return up unless match? DELIMITERS
@@ -15,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
@@ -67,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

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Refinements
+  # Provides additional enhancements to the Struct primitive.
   module Structs
     refine Struct.singleton_class do
       def keyworded? = inspect.include?("keyword_init: true")

data/lib/refinements/symbols.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Refinements
+  # Provides additional enhancements to the Symbol primitive.
+  module Symbols
+    refine Symbol do
+      def call *arguments, &block
+        proc { |receiver| receiver.public_send self, *arguments, &block }
+      end
+    end
+  end
+end

data/lib/refinements.rb

@@ -2,6 +2,7 @@
 
 require "refinements/identity"
 require "refinements/arrays"
+require "refinements/classes"
 require "refinements/big_decimals"
 require "refinements/date_times"
 require "refinements/hashes"
@@ -10,3 +11,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.2.2
+  version: 8.5.1
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   lkHilIrX69jq8wMPpBhlaw2mRmeSL50Wv5u6xVBvOHhXFSP1crXM95vfLhLyRYod
   W2A=
   -----END CERTIFICATE-----
-date: 2021-09-06 00:00:00.000000000 Z
+date: 2021-10-21 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -44,6 +44,7 @@ files:
 - lib/refinements.rb
 - lib/refinements/arrays.rb
 - lib/refinements/big_decimals.rb
+- lib/refinements/classes.rb
 - lib/refinements/date_times.rb
 - lib/refinements/hashes.rb
 - lib/refinements/identity.rb
@@ -52,6 +53,7 @@ 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
@@ -75,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.27
+rubygems_version: 3.2.29
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.