refinements 12.7.0 → 12.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d95a713a69dbbeaec7c6c2f76c634f576d763e86d32b1f46bad9817ac6eacd70
-  data.tar.gz: 5d972fa9193dab8743c5ed1aa7980a9b11be3b34e951f885377d25742d791eb1
+  metadata.gz: 81ecb80884f2fcc3c01f67b069fc4d8e46bf6c0dec1a03013a0f4183800c971e
+  data.tar.gz: 85ced417ccf67b5940b1441df1cacc2d9ca32812e4bc9f89d775e17574cce1e9
 SHA512:
-  metadata.gz: cec359f8d82a7e98889f2913e8330857d15f9d7a99ae0024e3895b6b4ec61c7a6c6a17897fb19b3ae1f10224d02be2affca6c81093d7965c6acfdb58d0b5c535
-  data.tar.gz: b967aed2a285c8ca49b5ef6a54f830721a19ccdc7521ac7857bedcec849b781e7b6a357b770c4f99cd47fe4197f2f0b2cbecd149e89096cd4193c841a64dc623
+  metadata.gz: a9d24dfcb5491cda43127501056b1cbb74fa13286964bcfca60107e42ca2bb67c56e22e35fd8773f83e91c16122c97d2723ac6ca0fc1094c6bd746bee7c5bff6
+  data.tar.gz: c8bbde575d08783fbf64d303fac8cb8cc0b0215b7bdc8e532ce1180f8451bc12e02391c9e22300edaba464ee50a1d2b1eb31b4081e8a234350e174ddc8cc7c08

data/README.adoc

@@ -1524,6 +1524,32 @@ io.reread(buffer:)  # "This is a test."
 buffer              # "This is a test."
 ----
 
+===== #to_s
+
+Answers underlying string representation for _explicit_ conversion.
+
+[source,ruby]
+----
+io = StringIO.new
+io.write "One"
+io.write ", "
+io.write "Two."
+io.to_s # "One, Two."
+----
+
+===== #to_str
+
+Answers underlying string representation for _implicit_ conversion.
+
+[source,ruby]
+----
+io = StringIO.new
+io.write "One"
+io.write ", "
+io.write "Two."
+io.to_str # "One, Two."
+----
+
 ==== Struct
 
 ===== .with_positions
@@ -1681,19 +1707,19 @@ An alias of `#merge` and identical in behavior (see `#merge` documentation for d
 
 ===== #call
 
-Enhances symbol-to-proc by allowing you to send additional arguments and/or a block. This only works
-with public methods in order to not break encapsulation.
+Enhances symbol-to-proc functionality by allowing you to send positional, keyword, and/or a block arguments. This only works with public methods in order to not break encapsulation.
 
 [source,ruby]
 ----
+
 %w[clue crow cow].map(&:tr.call("c", "b"))                              # ["blue", "brow", "bow"]
+[1.3, 1.5, 1.9].map(&:round.call(half: :up))                            # [1, 2, 2]
 [%w[a b c], %w[c a b]].map(&:index.call { |element| element == "b" })   # [1, 2]
-%w[1.outside 2.inside].map(&:sub.call(/\./) { |bullet| bullet + " " })  # ["1. outside", "2. inside"]
+%w[1.out 2.in].map(&:sub.call(/\./) { |bullet| bullet + " " })          # ["1. out", "2. in"]
 [1, 2, 3].map(&:to_s.call)                                              # ["1", "2", "3"]
 ----
 
-⚠️ Use of `#call` without any arguments or block should be avoided in order to not incur extra
-processing costs since the original symbol-to-proc call can be used instead.
+⚠️ Use of `#call` without any arguments should be avoided in order to not incur extra processing costs since the original symbol-to-proc call can be used instead.
 
 == Development
 
@@ -1730,6 +1756,8 @@ bin/rake
 
 == link:https://alchemists.io/policies/contributions[Contributions]
 
+== link:https://alchemists.io/policies/developer_certificate_of_origin[Developer Certificate of Origin]
+
 == link:https://alchemists.io/projects/refinements/versions[Versions]
 
 == link:https://alchemists.io/community[Community]

data/lib/refinements/string_io.rb

@@ -8,6 +8,9 @@ module Refinements
   module StringIO
     refine ::StringIO do
       import_methods Shared::Reread
+
+      alias_method :to_s, :string
+      alias_method :to_str, :string
     end
   end
 end

data/lib/refinements/symbol.rb

@@ -4,8 +4,8 @@ module Refinements
   # Provides additional enhancements to the Symbol primitive.
   module Symbol
     refine ::Symbol do
-      def call(*arguments, &block)
-        proc { |receiver| receiver.public_send self, *arguments, &block }
+      def call(*positionals, **keywords, &block)
+        proc { |receiver| receiver.public_send self, *positionals, **keywords, &block }
       end
     end
   end

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "12.7.0"
+  spec.version = "12.8.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/refinements"
@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.metadata = {
     "bug_tracker_uri" => "https://github.com/bkuhlmann/refinements/issues",
     "changelog_uri" => "https://alchemists.io/projects/refinements/versions",
-    "documentation_uri" => "https://alchemists.io/projects/refinements",
+    "homepage_uri" => "https://alchemists.io/projects/refinements",
     "funding_uri" => "https://github.com/sponsors/bkuhlmann",
     "label" => "Refinements",
     "rubygems_mfa_required" => "true",
@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.signing_key = Gem.default_key_path
   spec.cert_chain = [Gem.default_cert_path]
 
-  spec.required_ruby_version = "~> 3.3"
+  spec.required_ruby_version = ">= 3.3", "<= 3.4"
 
   spec.files = Dir["*.gemspec", "lib/**/*"]
   spec.extra_rdoc_files = Dir["README*", "LICENSE*"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 12.7.0
+  version: 12.8.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-07-15 00:00:00.000000000 Z
+date: 2024-09-01 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -73,7 +73,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/bkuhlmann/refinements/issues
   changelog_uri: https://alchemists.io/projects/refinements/versions
-  documentation_uri: https://alchemists.io/projects/refinements
+  homepage_uri: https://alchemists.io/projects/refinements
   funding_uri: https://github.com/sponsors/bkuhlmann
   label: Refinements
   rubygems_mfa_required: 'true'
@@ -84,16 +84,19 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '3.3'
+  - - "<="
+    - !ruby/object:Gem::Version
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.15
+rubygems_version: 3.5.18
 signing_key:
 specification_version: 4
 summary: A collection of core object refinements.