refinements 10.1.0 → 10.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: acd50ef5bb4db84f4db8c509c2deab9203e0e7c036e880d43ed047d540c961cf
-  data.tar.gz: df6ebf181b200aeb38f14f3f691f844735e1e352741bc6e7cd667970c5b81b6a
+  metadata.gz: 82142460f83d84a2b94bf4a1e6c07b4c6839e91f2da64192e0c64a36382fe3e5
+  data.tar.gz: d657c64e946049d4c946513329446b781880c34c76301408318a8487e0728f17
 SHA512:
-  metadata.gz: 53703faa9a8b2941e562561a1f9edf22920fdd3934e7d6b55ec3e4290ad18d3e6282e96733c658accf58d475e6f0f78a6687c4777cb7fe2bc49edfdb9707b17b
-  data.tar.gz: 0ddb2f12bb1fcd7aefc06f6c9f2ce891c9929828a79162610824a8a5cf3ffa991d476118f9c5a106fb681c9603a6b8c1ba0dbeaf80004317c990b4673152f8ff
+  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://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://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]
 ----
@@ -1147,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]
 ----

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/refinements.gemspec

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 10.1.0
+  version: 10.1.1
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -10,32 +10,32 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIEZDCCAsygAwIBAgIBATANBgkqhkiG9w0BAQsFADA8MQwwCgYDVQQDDAN5b3Ux
-  FzAVBgoJkiaJk/IsZAEZFgdleGFtcGxlMRMwEQYKCZImiZPyLGQBGRYDY29tMB4X
-  DTIzMDMyMjE1NTAzNloXDTI1MDMyMTE1NTAzNlowPDEMMAoGA1UEAwwDeW91MRcw
-  FQYKCZImiZPyLGQBGRYHZXhhbXBsZTETMBEGCgmSJomT8ixkARkWA2NvbTCCAaIw
-  DQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAMD1xmCyBRDIgMr9h+bXYgckAJwj
-  EE8d49cWc4IgxXLEz7E/r3+DVWfbviErgQEjqZztso/5jormLpS2LC3VNjRXWdSN
-  3QoD51J3/OnAsW340sXTVvj5M9KD5ZkDo+QIoQO1Dp8QZKI5Ney8gTUxCj5857sX
-  XqWmBjgOK3lFnPOMWRtbVaBh7059eiCu3+LYhVgBgMgcTtYSCluHffzAVt9j8lAE
-  NwCxK8TSZqIQVBQOZgvCqiciKa1cwBGrKgCSdpZdt9gj9WmawQXMmeep2fFOQ8Fi
-  7Y6LWtUfVVvzIKL1BqEyCGH5/Gh0ll/ONPMc4YTXsDs+dQEL+FanoqlUmtH7cpvB
-  VGeXQZu6SeDx/QqvjXYUcrWC34tsiyZS2iC4zsTdtLsi2fwjtvvsO/6Mx9l9BoQ2
-  yM2jWGB/dMijDEmrvIWDDd5+pDCpZwOwp+6OuhSBIyT780z8hwSpQUH8C89AJAK0
-  k0HK4ULXbJOQEQz0RVfvwcJXBxR9g2J0u/VAGQIDAQABo3EwbzAJBgNVHRMEAjAA
-  MAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUynDeWx+yghZzQ73QtK3reacuXSEwGgYD
-  VR0RBBMwEYEPeW91QGV4YW1wbGUuY29tMBoGA1UdEgQTMBGBD3lvdUBleGFtcGxl
-  LmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAPJeQGa0T03CxyhFLeBLeKNRA3JMCJWwS
-  4EHmMNOkVFyCo4FCGFunKFUE0HucA8NEaolQ1t+8SSfvfXE5+7kpxdPDHjAr2zFy
-  3+I33zGhRhhFlcJRQ6QH7WFYJvMrjMDhSbU3JDHLIrL2kmzkmRJ2GST+E1ztAbaO
-  OvrW8J5Eab5nJdADcZZaEc7RfGfyl1eGoJt6cho71GMyTfXk2aGfk2XZAJ5JI1G/
-  rbfQGPsune5CPTnY3a0VPK7f6s07WvZ9XWfJ7MgRcAcXCIg6xC1SYk9B6hi3swIQ
-  Pp4POByvlvVl9HbcmCaEO1IGE1cQLLz6gxDFyFIrDwbimNibwb3JW4x8X0wIQMf+
-  W3TjRZkQUZvoB8gKv8Y/CtDZvBjB5joEgEq5JxbOS4v1AKt0EydIB78S5cGNlgml
-  2rAoRKxft/8MhVs5yHlkqOf+JFFGYnvXVMtXfAKw8Sp4CamkVQmlULd2d2GKQHap
-  9xhcE6ZO5JU1gPGPIxJ383ce1NoNTP7e
+  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-03-22 00:00:00.000000000 Z
+date: 2023-04-08 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -90,7 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.9
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: A collection of refinements to core Ruby objects.