refinements 10.0.1 → 10.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 689d81be17018cdf3ef2e6b0ac907a15c336428a1ce38cfefada918cf40ea099
-  data.tar.gz: 430b2746c975b947c263d1eafcda9ebb6687286e233e79dc12208d33b5a36c57
+  metadata.gz: 82142460f83d84a2b94bf4a1e6c07b4c6839e91f2da64192e0c64a36382fe3e5
+  data.tar.gz: d657c64e946049d4c946513329446b781880c34c76301408318a8487e0728f17
 SHA512:
-  metadata.gz: 69e153809a336d6bebd1bf5f86d2bbc4790710808d60880fa5320f4d11a3a2f0963e585e7ef3b379a85e349b9aa66796d4bed07cd9920089f4c3fb5e6c13dc2c
-  data.tar.gz: 5c82f814adbc33c2d6a814599b7fa40e3d3959bd2969db1a5d6302f879c3d0933d27b8ca4f20d9071032ce3c58c4dad7faed19f7064bf5632f2d149f29cb2e90
+  metadata.gz: 81df10e22a7fb65d5737e7a8c23114fdecd47bcdecf532bc231612d29cd9036a90444fd8d59b5d140ab7c72347a1bbbbc9dee9b1e8c3464962b146ad5dc82085
+  data.tar.gz: 4446cffdb57fe7383f891193a95edc8c0a023da2f6670fb13a00730be21113123a55f8f13ad9cf9fad39954af418142e5e17e8b6b00cac0fb815b5ed6592252d

data/README.adoc

@@ -4,11 +4,7 @@
 
 = Refinements
 
-Refinements are a collection primitive Ruby objects enhancements without needing to resort to hard
-to debug link:https://www.alchemists.io/articles/ruby_antipatterns/#_monkey_patches[monkey patches].
-These refinements give you additional syntactic sugar to develop clean and concise implementations
-while using less code. By refining our code we can acquire the functionality we wish the core
-primitives had!
+These refinements augment and enhance Ruby primitives so you can avoid link:https://alchemists.io/articles/ruby_antipatterns/#_monkey_patches[monkey patches]. They also allow you to develop clean and concise implementations while using less code. By refining your code, you can acquire the functionality you wish the core primitives had!
 
 toc::[]
 
@@ -31,8 +27,7 @@ Enhances the following objects:
 == Requirements
 
 . https://www.ruby-lang.org[Ruby].
-. A solid understanding of link:https://www.alchemists.io/articles/ruby_refinements[Ruby refinements
-  and lexical scope].
+. A solid understanding of link:https://alchemists.io/articles/ruby_refinements[refinements].
 
 == Setup
 
@@ -54,7 +49,7 @@ gem "refinements"
 
 === Requires
 
-If all refinements are not desired, add the following to your `+Gemfile+` instead:
+If no refinements are desired, then add the following to your `Gemfile` instead:
 
 [source,ruby]
 ----
@@ -195,7 +190,7 @@ Adds given array or elements without mutating itself.
 
 ===== #intersperse
 
-Inserts additional elements or array between all members of given array.
+Inserts additional elements or an array between all members of given array.
 
 [source,ruby]
 ----
@@ -371,7 +366,7 @@ example[:b]  # []
 
 ===== #compress
 
-Removes `nil` and empty objects without mutating itself. Answers itself if there is nothing to remove.
+Removes `nil` and empty objects without mutating itself. Answers itself if nothing to remove.
 
 [source,ruby]
 ----
@@ -386,7 +381,7 @@ example                # {a: 1, b: "blueberry", c: nil, d: "", e: [], f: {}, g:
 
 ===== #compress!
 
-Removes `nil` and empty objects while mutating itself. Answers `nil` if there is nothing to remove.
+Removes `nil` and empty objects while mutating itself. Answers `nil` if nothing to remove.
 
 [source,ruby]
 ----
@@ -584,9 +579,7 @@ example                  # {a: 1, b: 2}
 
 ===== #transform_with
 
-Transforms key/value pairs based on specific operations where each operation (i.e. function that responds to the `call` message). Does not mutate itself.
-
-You can transform multiple values at once:
+Transforms values of keys using specific operations (i.e. any object that responds to `#call`). Does not mutate itself and you can transform multiple values at once:
 
 [source,ruby]
 ----
@@ -605,7 +598,7 @@ example.transform_with bogus: -> value { value.tr "<>", "" }
 # {email: "<jd@example.com>"}
 ----
 
-The original object will not be mutated:
+The original object _will not_ be mutated:
 
 [source,ruby]
 ----
@@ -614,9 +607,7 @@ example  # {name: "Jayne Doe", email: "<jd@example.com>"}
 
 ===== #transform_with!
 
-Transforms key/value pairs based on specific operations where each operation (i.e. function that responds to the `call` message). Mutates itself.
-
-You can transform multiple values at once:
+Transforms values of keys using specific operations (i.e. any object that responds to `#call`). Mutates itself and you can transform multiple values at once:
 
 [source,ruby]
 ----
@@ -635,7 +626,7 @@ example.transform_with! bogus: -> value { value.tr "<>", "" }
 # {email: "<jd@example.com>"}
 ----
 
-The original object will be mutated:
+The original object _will be_ mutated:
 
 [source,ruby]
 ----
@@ -644,7 +635,7 @@ example  # {name: "Jayne", email: "jd@example.com"}
 
 ===== #use
 
-Passes each hash value as a block argument for further processing.
+Uses the hash's keys as block arguments where the value of the block argument is equal to the value of the key found within the hash. Works best with hashes that use symbols for keys but falls back to string keys when symbol keys can't be found.
 
 [source,ruby]
 ----
@@ -760,6 +751,20 @@ logger.write "Test."
 logger.reread                     # ""
 ----
 
+===== #any
+
+Allows you to log _any_ message which is identical in behavior and functionality to the `Logger#unknown` method only this requires less typing and better matches the terminology used by the `#unknown` method.
+
+``` ruby
+logger = Logger.new STDOUT
+
+logger.any "Test."
+# A, [2000-01-10T09:00:00.847428 #44925]   ANY -- : Test.
+
+logger.any { "Test." }
+A, [2000-01-10T09:00:00.330719 #44925]   ANY -- : Test.
+```
+
 ==== Pathname
 
 ===== Pathname
@@ -817,7 +822,7 @@ before being required to ensure consistent behavior. Example:
 Dir[File.join(__dir__, "support/shared_contexts/**/*.rb")].sort.each { |path| require path }
 
 # After
-Pathname.require_tree __dir__, "support/shared_contexts/**/*.rb"
+Pathname.require_tree "#{__dir__}/support/shared_contexts"
 ----
 
 The following are further examples of potential usage:
@@ -831,7 +836,7 @@ Pathname.require_tree __dir__
 Pathname.require_tree "/test"
 
 # Requires all files in RSpec shared examples directory structure.
-Pathname.require_tree SPEC_ROOT, "support/shared_examples/**/*.rb"
+Pathname.require_tree SPEC_ROOT.join("support/shared_examples")
 ----
 
 ===== .root
@@ -1133,7 +1138,7 @@ Answers first character of a string or first set of characters if given a number
 
 ===== #indent
 
-Answers string indented by two spaces by default.
+Answers indentation (string) which is the result of the multiplier times padding. By default, the multiplier is `1` and the padding is `"  "` which equates to two spaces.
 
 [source,ruby]
 ----
@@ -1439,19 +1444,19 @@ To test, run:
 bin/rake
 ----
 
-== link:https://www.alchemists.io/policies/license[License]
+== link:https://alchemists.io/policies/license[License]
 
-== link:https://www.alchemists.io/policies/security[Security]
+== link:https://alchemists.io/policies/security[Security]
 
-== link:https://www.alchemists.io/policies/code_of_conduct[Code of Conduct]
+== link:https://alchemists.io/policies/code_of_conduct[Code of Conduct]
 
-== link:https://www.alchemists.io/policies/contributions[Contributions]
+== link:https://alchemists.io/policies/contributions[Contributions]
 
-== link:https://www.alchemists.io/projects/refinements/versions[Versions]
+== link:https://alchemists.io/projects/refinements/versions[Versions]
 
-== link:https://www.alchemists.io/community[Community]
+== link:https://alchemists.io/community[Community]
 
 == Credits
 
-* Built with link:https://www.alchemists.io/projects/gemsmith[Gemsmith].
-* Engineered by link:https://www.alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].
+* Built with link:https://alchemists.io/projects/gemsmith[Gemsmith].
+* Engineered by link:https://alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].

data/lib/refinements/big_decimals.rb

@@ -6,7 +6,7 @@ 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"))
+      def inspect = format("#<BigDecimal:%<id>s %<string>s>", id: object_id, string: to_s("F"))
     end
   end
 end

data/lib/refinements/hashes.rb

@@ -85,7 +85,7 @@ module Refinements
         return [] unless block
 
         block.parameters
-             .map { |(_type, key)| self[key] }
+             .map { |(_type, key)| self[key] || self[key.to_s] }
              .then { |values| yield values }
       end
     end

data/lib/refinements/loggers.rb

@@ -9,6 +9,8 @@ module Refinements
 
     refine Logger do
       def reread = @logdev.reread
+
+      alias_method :any, :unknown
     end
   end
 end

data/refinements.gemspec

@@ -2,17 +2,17 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "10.0.1"
+  spec.version = "10.1.1"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
-  spec.homepage = "https://www.alchemists.io/projects/refinements"
+  spec.homepage = "https://alchemists.io/projects/refinements"
   spec.summary = "A collection of refinements to core Ruby objects."
   spec.license = "Hippocratic-2.1"
 
   spec.metadata = {
     "bug_tracker_uri" => "https://github.com/bkuhlmann/refinements/issues",
-    "changelog_uri" => "https://www.alchemists.io/projects/refinements/versions",
-    "documentation_uri" => "https://www.alchemists.io/projects/refinements",
+    "changelog_uri" => "https://alchemists.io/projects/refinements/versions",
+    "documentation_uri" => "https://alchemists.io/projects/refinements",
     "funding_uri" => "https://github.com/sponsors/bkuhlmann",
     "label" => "Refinements",
     "rubygems_mfa_required" => "true",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 10.0.1
+  version: 10.1.1
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -10,25 +10,32 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIC/jCCAeagAwIBAgIBBTANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpicm9v
-  a2UvREM9YWxjaGVtaXN0cy9EQz1pbzAeFw0yMjAzMTkxNzI0MzJaFw0yMzAzMTkx
-  NzI0MzJaMCUxIzAhBgNVBAMMGmJyb29rZS9EQz1hbGNoZW1pc3RzL0RDPWlvMIIB
-  IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6l1qpXTiomH1RfMRloyw7MiE
-  xyVx/x8Yc3EupdH7uhNaTXQGyORN6aOY//1QXXMHIZ9tW74nZLhesWMSUMYy0XhB
-  brs+KkurHnc9FnEJAbG7ebGvl/ncqZt72nQvaxpDxvuCBHgJAz+8i5wl6FhLw+oT
-  9z0A8KcGhz67SdcoQiD7qiCjL/2NTeWHOzkpPrdGlt088+VerEEGf5I13QCvaftP
-  D5vkU0YlAm1r98BymuJlcQ1qdkVEI1d48ph4kcS0S0nv1RiuyVb6TCAR3Nu3VaVq
-  3fPzZKJLZBx67UvXdbdicWPiUR75elI4PXpLIic3xytaF52ZJYyKZCNZJhNwfQID
-  AQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU0nzow9vc
-  2CdikiiE3fJhP/gY4ggwDQYJKoZIhvcNAQELBQADggEBAJbbNyWzFjqUNVPPCUCo
-  IMrhDa9xf1xkORXNYYbmXgoxRy/KyNbUr+jgEEoWJAm9GXlcqxxWAUI6pK/i4/Qi
-  X6rPFEFmeObDOHNvuqy8Hd6AYsu+kP94U/KJhe9wnWGMmGoNKJNU3EkW3jM/osSl
-  +JRxiH5t4WtnDiVyoYl5nYC02rYdjJkG6VMxDymXTqn7u6HhYgZkGujq1UPar8x2
-  hNIWJblDKKSu7hA2d6+kUthuYo13o1sg1Da/AEDg0hoZSUvhqDEF5Hy232qb3pDt
-  CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
-  RFE=
+  MIIEeDCCAuCgAwIBAgIBATANBgkqhkiG9w0BAQsFADBBMQ8wDQYDVQQDDAZicm9v
+  a2UxGjAYBgoJkiaJk/IsZAEZFgphbGNoZW1pc3RzMRIwEAYKCZImiZPyLGQBGRYC
+  aW8wHhcNMjMwMzIyMTYxNDQxWhcNMjUwMzIxMTYxNDQxWjBBMQ8wDQYDVQQDDAZi
+  cm9va2UxGjAYBgoJkiaJk/IsZAEZFgphbGNoZW1pc3RzMRIwEAYKCZImiZPyLGQB
+  GRYCaW8wggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQCro8tj5/E1Hg88
+  f4qfiwPVd2zJQHvdYt4GHVvuHRRgx4HGhJuNp+4BId08RBn7V6V1MW6MY3kezRBs
+  M+7QOQ4b1xNLTvY7FYQB1wGK5a4x7TTokDrPYQxDB2jmsdDYCzVbIMrAvUfcecRi
+  khyGZCdByiiCl4fKv77P12tTT+NfsvXkLt/AYCGwjOUyGKTQ01Z6eC09T27GayPH
+  QQvIkakyFgcJtzSyGzs8bzK5q9u7wQ12MNTjJoXzW69lqp0oNvDylu81EiSUb5S6
+  QzzPxZBiRB1sgtbt1gUbVI262ZDq1gR+HxPFmp+Cgt7ZLIJZAtesQvtcMzseXpfn
+  hpmm0Sw22KGhRAy/mqHBRhDl5HqS1SJp2Ko3lcnpXeFResp0HNlt8NSu13vhC08j
+  GUHU9MyIXbFOsnp3K3ADrAVjPWop8EZkmUR3MV/CUm00w2cZHCSGiXl1KMpiVKvk
+  Ywr1gd2ZME4QLSo+EXUtLxDUa/W3xnBS8dBOuMMz02FPWYr3PN8CAwEAAaN7MHkw
+  CQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFAFgmv0tYMZnItuPycSM
+  F5wykJEVMB8GA1UdEQQYMBaBFGJyb29rZUBhbGNoZW1pc3RzLmlvMB8GA1UdEgQY
+  MBaBFGJyb29rZUBhbGNoZW1pc3RzLmlvMA0GCSqGSIb3DQEBCwUAA4IBgQAX+EGY
+  9RLYGxF1VLZz+G1ACQc4uyrCB6kXwI06kzUa5dF9tPXqTX9ffnz3/W8ck2IQhKzu
+  MKO2FVijzbDWTsZeZGglS4E+4Jxpau1lU9HhOIcKolv6LeC6UdALTFudY+GLb8Xw
+  REXgaJkjzzhkUSILmEnRwEbY08dVSl7ZAaxVI679vfI2yapLlIwpbBgmQTiTvPr3
+  qyyLUno9flYEOv9fmGHunSrM+gE0/0niGTXa5GgXBXYGS2he4LQGgSBfGp/cTwMU
+  rDKJRcusZ12lNBeDfgqACz/BBJF8FLodgk6rGMRZz7+ZmjjHEmpG5bQpR6Q2BuWL
+  XMtYk/QzaWuhiR7pWjiF8jbdd7RO6or0ohq7iFkokz/5xrtQ/vPzU2RQ3Qc6YaKw
+  3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
+  gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2023-01-22 00:00:00.000000000 Z
+date: 2023-04-08 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -57,13 +64,13 @@ files:
 - lib/refinements/structs.rb
 - lib/refinements/symbols.rb
 - refinements.gemspec
-homepage: https://www.alchemists.io/projects/refinements
+homepage: https://alchemists.io/projects/refinements
 licenses:
 - Hippocratic-2.1
 metadata:
   bug_tracker_uri: https://github.com/bkuhlmann/refinements/issues
-  changelog_uri: https://www.alchemists.io/projects/refinements/versions
-  documentation_uri: https://www.alchemists.io/projects/refinements
+  changelog_uri: https://alchemists.io/projects/refinements/versions
+  documentation_uri: https://alchemists.io/projects/refinements
   funding_uri: https://github.com/sponsors/bkuhlmann
   label: Refinements
   rubygems_mfa_required: 'true'
@@ -83,7 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.4
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.