refinements 9.5.0 → 9.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06c161de8cf1a100c8df6267ef2116368743557dac4504e9617b19dd063520aa
-  data.tar.gz: 60389a48bc41a581d835ac67c80e71a8db438ddbccf070336e1128d4d430e87a
+  metadata.gz: 5c0144180dd3a5cabe861b385cd0c766eaf54280ca6812dc6e82db4e564ce6c0
+  data.tar.gz: b339710c168c98fffbe5b1994031f033041c9f6c16b0df96555cb80fd5cd7269
 SHA512:
-  metadata.gz: 95c680f9fe5df9820d72462e40984eafe398b0cf81589b6525026978a477950723608d8d39b89b3fe0c61e888ce3a2a166d2e54ec26676a3c9621f6b712e3828
-  data.tar.gz: b3743029174a74733328346ce1264d9f7dab9876222deb4a3b3f96a38817cf8b7c0b35eabc62639b5f7e7f4f2e1572282d1f31952e6c55b90d6f65df2b190bef
+  metadata.gz: 926090205f29ac111494e00e7de37b59b8549c6f979c8a0d62d852e9d87193093073ac0f005564243fc472eacf4de68f62bea8b1d45f3f363e113805758f726d
+  data.tar.gz: 22a524d073a48922d6347119f01f4c059bbd2bba8f65a2e6573951b137b772dc3f7797a3596ccb850bb63159a9b2ab501bb334f7ac8a80f66ca93f55886bdb09

data/README.adoc

@@ -21,6 +21,8 @@ Enhances the following objects:
 * DateTime
 * Hash
 * IO
+* LogDevice
+* Logger
 * Pathname
 * String
 * StringIO
@@ -73,6 +75,8 @@ require "refinements/strings"
 require "refinements/string_ios"
 require "refinements/structs"
 require "refinements/symbols"
+require "refinements/log_devices"
+require "refinements/loggers"
 ----
 
 === Using
@@ -93,6 +97,8 @@ class Example
   using Refinements::StringIOs
   using Refinements::Structs
   using Refinements::Symbols
+  using Refinements::LogDevices
+  using Refinements::Loggers
 end
 ----
 
@@ -102,6 +108,24 @@ The following sections demonstrate how each refinement enriches your objects wit
 
 ==== Array
 
+===== #combinatorial?
+
+Answers if an array is equal to another array when the elements are equal but in any order and/or subset.
+
+[source,ruby]
+----
+example = %w[a b c]
+
+example.combinatorial? %w[a b c]    # true
+example.combinatorial? %w[c a b]    # true
+example.combinatorial? %w[c]        # true
+example.combinatorial? %w[c b]      # true
+example.combinatorial? %w[x]        # false
+example.combinatorial? %w[z b c]    # false
+example.combinatorial? %w[a b c d]  # false
+example.combinatorial? []           # false
+----
+
 ===== #compress
 
 Removes `nil` and empty objects without mutating itself.
@@ -596,6 +620,54 @@ io.squelch { io.write "Test" }  # "#<IO:fd 20>"
 io.reread                       # ""
 ----
 
+==== LogDevice
+
+===== #reread
+
+Answers previously written content by rewinding to beginning of device.
+
+[source,ruby]
+----
+# With File.
+device = Logger::LogDevice.new "test.log"
+device.write "Test."
+device.reread                                # "Test."
+
+# With StringIO.
+device = Logger::LogDevice.new StringIO.new
+device.write "Test."
+device.reread                                # "Test."
+
+# With STDOUT.
+device = Logger::LogDevice.new $stdout
+device.write "Test."
+device.reread                                # ""
+----
+
+==== Logger
+
+===== #reread
+
+Answers previously written content by rewinding to beginning of log.
+
+[source,ruby]
+----
+# With File.
+logger = Logger.new "test.log"
+logger.write "Test."
+logger.reread                     # "Test."
+
+# With StringIO.
+logger = Logger.new StringIO.new
+logger.write "Test."
+logger.reread                     # "Test."
+
+# With STDOUT.
+logger = Logger.new $stdout
+logger.write "Test."
+logger.reread                     # ""
+----
+
 ==== Pathname
 
 ===== Pathname

data/lib/refinements/arrays.rb

@@ -8,6 +8,8 @@ module Refinements
     refine Array do
       import_methods Shared::Enumerables::Many
 
+      def combinatorial?(other) = !other.empty? && size == union(other).size
+
       def compress = dup.compress!
 
       def compress!

data/lib/refinements/ios.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "refinements/shared/ios/reread"
+
 module Refinements
   # Provides additional enhancements to the IO primitive.
   module IOs
@@ -15,6 +17,8 @@ module Refinements
     end
 
     refine IO do
+      import_methods Shared::IOs::Reread
+
       def redirect other
         return self unless block_given?
 
@@ -24,8 +28,6 @@ module Refinements
         reopen backup
       end
 
-      def reread(length = nil, buffer: nil) = tap(&:rewind).read(length, buffer)
-
       def squelch(&) = self.class.void.then { |void| redirect(void, &) }
     end
   end

data/lib/refinements/log_devices.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "logger"
+require "refinements/string_ios"
+
+module Refinements
+  # Provides additional enhancements to a log device.
+  module LogDevices
+    using StringIOs
+
+    refine Logger::LogDevice do
+      def reread
+        case dev
+          when File then dev.class.new(dev).read
+          when StringIO then dev.reread
+          else ""
+        end
+      end
+    end
+  end
+end

data/lib/refinements/loggers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "refinements/log_devices"
+
+module Refinements
+  # Provides additional enhancements to a logger.
+  module Loggers
+    using LogDevices
+
+    refine Logger do
+      def reread = @logdev.reread
+    end
+  end
+end

data/lib/refinements/shared/ios/reread.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Refinements
+  module Shared
+    module IOs
+      # Provides shared functionality for I/O object rewinding.
+      module Reread
+        def reread(length = nil, buffer: nil) = tap(&:rewind).read(length, buffer)
+      end
+    end
+  end
+end

data/lib/refinements/string_ios.rb

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
 require "stringio"
+require "refinements/shared/ios/reread"
 
 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)
+      import_methods Shared::IOs::Reread
     end
   end
 end

data/lib/refinements.rb

@@ -10,3 +10,5 @@ require "refinements/strings"
 require "refinements/string_ios"
 require "refinements/structs"
 require "refinements/symbols"
+require "refinements/log_devices"
+require "refinements/loggers"

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "9.5.0"
+  spec.version = "9.6.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://www.alchemists.io/projects/refinements"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 9.5.0
+  version: 9.6.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-06-25 00:00:00.000000000 Z
+date: 2022-07-17 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -47,8 +47,11 @@ files:
 - lib/refinements/date_times.rb
 - lib/refinements/hashes.rb
 - lib/refinements/ios.rb
+- lib/refinements/log_devices.rb
+- lib/refinements/loggers.rb
 - lib/refinements/pathnames.rb
 - lib/refinements/shared/enumerables/many.rb
+- lib/refinements/shared/ios/reread.rb
 - lib/refinements/string_ios.rb
 - lib/refinements/strings.rb
 - lib/refinements/structs.rb
@@ -80,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.16
+rubygems_version: 3.3.18
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.