refinements 7.10.0 → 7.15.0

data/lib/refinements.rb

@@ -6,6 +6,8 @@ require "refinements/big_decimals"
 require "refinements/date_times"
 require "refinements/files"
 require "refinements/hashes"
+require "refinements/ios"
 require "refinements/pathnames"
 require "refinements/strings"
 require "refinements/string_ios"
+require "refinements/structs"

data/lib/refinements/arrays.rb

@@ -11,12 +11,30 @@ module Refinements
         replace compress
       end
 
+      def exclude *elements
+        warn "[DEPRECATION]: #exclude is deprecated, use #excluding instead."
+        excluding(*elements)
+      end
+
+      def excluding *elements
+        self - elements.flatten
+      end
+
       def include *elements
+        warn "[DEPRECATION]: #include is deprecated, use #including instead."
+        including(*elements)
+      end
+
+      def including *elements
         self + elements.flatten
       end
 
-      def exclude *elements
-        self - elements.flatten
+      def intersperse *elements
+        product([elements]).tap(&:pop).flatten.push last
+      end
+
+      def mean
+        size.zero? ? 0 : sum(0) / size
       end
 
       def ring &block

data/lib/refinements/hashes.rb

@@ -13,49 +13,6 @@ module Refinements
     end
 
     refine Hash do
-      def except *keys
-        reject { |key, _value| keys.include? key }
-      end
-
-      def except! *keys
-        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 stringify_keys
-        reduce({}) { |hash, (key, value)| hash.merge key.to_s => value }
-      end
-
-      def stringify_keys!
-        replace stringify_keys
-      end
-
-      def symbolize_keys
-        reduce({}) { |hash, (key, value)| hash.merge key.to_sym => value }
-      end
-
-      def symbolize_keys!
-        replace symbolize_keys
-      end
-
       def deep_merge other
         clazz = self.class
 
@@ -88,8 +45,35 @@ module Refinements
         replace deep_symbolize_keys
       end
 
+      def except *keys
+        reject { |key, _value| keys.include? key }
+      end
+
+      def except! *keys
+        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 recurse &block
-        return self unless block_given?
+        return self unless block
 
         transform = yield self
 
@@ -118,8 +102,24 @@ module Refinements
         replace reverse_merge(other)
       end
 
+      def stringify_keys
+        reduce({}) { |hash, (key, value)| hash.merge key.to_s => value }
+      end
+
+      def stringify_keys!
+        replace stringify_keys
+      end
+
+      def symbolize_keys
+        reduce({}) { |hash, (key, value)| hash.merge key.to_sym => value }
+      end
+
+      def symbolize_keys!
+        replace symbolize_keys
+      end
+
       def use &block
-        return [] unless block_given?
+        return [] unless block
 
         block.parameters
              .map { |(_type, key)| self[key] }

data/lib/refinements/identity.rb

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

data/lib/refinements/ios.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Refinements
+  module IOs
+    refine IO.singleton_class do
+      def void
+        new(sysopen("/dev/null", "w+")).then do |io|
+          return io unless block_given?
+
+          yield io
+          io.tap(&:close)
+        end
+      end
+    end
+
+    refine IO do
+      def redirect other
+        return self unless block_given?
+
+        backup = dup
+        reopen other
+        yield self
+        reopen backup
+      end
+
+      def reread length = nil, buffer: nil
+        tap(&:rewind).read length, buffer
+      end
+
+      def squelch &block
+        self.class.void.then { |void| redirect(void, &block) }
+      end
+    end
+  end
+end

data/lib/refinements/pathnames.rb

@@ -13,8 +13,8 @@ module Refinements
     end
 
     refine Pathname do
-      def name
-        basename extname
+      def change_dir &block
+        block ? Dir.chdir(self, &block) : (Dir.chdir self and self)
       end
 
       def copy to
@@ -39,6 +39,28 @@ module Refinements
         self.class.new to_s.gsub(pattern, replacement)
       end
 
+      def make_ancestors
+        dirname.mkpath
+        self
+      end
+
+      def make_dir
+        exist? ? self : mkdir and self
+      end
+
+      def make_path
+        mkpath
+        self
+      end
+
+      def mkdir
+        exist? ? self : super and self
+      end
+
+      def name
+        basename extname
+      end
+
       def relative_parent root_dir
         relative_path_from(root_dir).parent
       end
@@ -49,20 +71,28 @@ module Refinements
         relative_parent root_dir
       end
 
-      def make_ancestors
-        dirname.mkpath
+      def remove_dir
+        exist? ? (rmdir and self) : self
+      end
+
+      def remove_tree
+        rmtree if exist?
         self
       end
 
       def rewrite
         read.then { |content| write yield(content) if block_given? }
-        self
       end
 
       def touch at: Time.now
         exist? ? utime(at, at) : write("")
         self
       end
+
+      def write content, offset: nil, **options
+        super content, offset, options
+        self
+      end
     end
   end
 end

data/lib/refinements/strings.rb

@@ -12,42 +12,33 @@ module Refinements
     end
 
     refine String do
-      def first number = 0
-        return self if empty?
-
-        max = Integer number
+      def blank?
+        match?(/\A\s*\z/)
+      end
 
-        return self[0] if max.zero?
-        return "" if max.negative?
+      def camelcase
+        return up unless match? DELIMITERS
 
-        self[..(max - 1)]
+        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 last number = 0
+      def down
         return self if empty?
 
-        min = Integer number
-
-        return self[size - 1] if min.zero?
-        return "" if min.negative?
-
-        self[(min + 1)..]
-      end
-
-      def blank?
-        match?(/\A\s*\z/)
+        first.downcase + self[1, size]
       end
 
-      def up
+      def first number = 0
         return self if empty?
 
-        first.upcase + self[1, size]
-      end
+        max = Integer number
 
-      def down
-        return self if empty?
+        return self[0] if max.zero?
+        return "" if max.negative?
 
-        first.downcase + self[1, size]
+        self[..(max - 1)]
       end
 
       def indent multiplier = 1, padding: "  "
@@ -56,12 +47,15 @@ module Refinements
         padding * multiplier + self
       end
 
-      def camelcase
-        return up unless match? DELIMITERS
+      def last number = 0
+        return self if empty?
 
-        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 }
+        min = Integer number
+
+        return self[size - 1] if min.zero?
+        return "" if min.negative?
+
+        self[(min + 1)..]
       end
 
       def snakecase
@@ -84,6 +78,12 @@ module Refinements
         %w[true yes on t y 1].include? downcase.strip
       end
 
+      def up
+        return self if empty?
+
+        first.upcase + self[1, size]
+      end
+
       private
 
       # :reek:DuplicateMethodCall

data/lib/refinements/structs.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Refinements
+  module Structs
+    refine Struct do
+      def merge **attributes
+        dup.merge! attributes
+      end
+
+      def merge! **attributes
+        to_h.merge(attributes).each { |key, value| self[key] = value }
+        self
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 7.10.0
+  version: 7.15.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   2XV8FRa7/JimI07sPLC13eLY3xd/aYTi85Z782KIA4j0G8XEEWAX0ouBhlXPocZv
   QWc=
   -----END CERTIFICATE-----
-date: 2020-09-27 00:00:00.000000000 Z
+date: 2020-11-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -36,42 +36,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: bundler-leak
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: gemsmith
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '14.2'
+        version: '14.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '14.2'
+        version: '14.8'
 - !ruby/object:Gem::Dependency
   name: git-lint
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
@@ -148,42 +162,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.89'
+        version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.89'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -204,14 +218,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.39'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.39'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -244,9 +258,11 @@ files:
 - lib/refinements/files.rb
 - lib/refinements/hashes.rb
 - lib/refinements/identity.rb
+- lib/refinements/ios.rb
 - lib/refinements/pathnames.rb
 - lib/refinements/string_ios.rb
 - lib/refinements/strings.rb
+- lib/refinements/structs.rb
 homepage: https://www.alchemists.io/projects/refinements
 licenses:
 - Apache-2.0