refinements 12.9.0 → 12.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 229ada32a4378800013462184db88be59d33109cbbd63c8c6378add52fc7b321
-  data.tar.gz: 4f0291390f858b45e2066dc9eac5e3f06ceef5c9e1051160aa7c625e734c78c4
+  metadata.gz: 56d9d8ea056f8d22d211d5d9ad964b74e5fc86eb4be0b3476a1cd15c0ef74856
+  data.tar.gz: bd3d5e64e0dfd3ae296d81a6b96212390b223f79b91d14fd3af14eab2c2dd867
 SHA512:
-  metadata.gz: dbe61e5483ff24ffe0d9852e3f1c34e613f53a48f8a96cb15b862bf2528c448df71e9357d2910068b7e41275a916a9169f99e6b5b67c355df73eaf3e6ac2d124
-  data.tar.gz: 3f77b617a157b3d9be6735a08a9340ddd945642107d5e2728e384f6496197a44e180cfcce8c5738ec5ea509df883fcc5ca3b1261ffaddeaedbcfe0764987d9d0
+  metadata.gz: 63f889fedadba076370027afce7f0e176bd7e840d6b470d99043033a39f79277a4aebe7b0573e8d6c367432c59e98cb77b26ee62b5148f420121b632d86f8dfb
+  data.tar.gz: 47712bdf7aff52e05671f7fed297bd06f54dfa1e554e529723c3ab932b2204d30630a25906b757769f314c213e004014fc887bcdfd5b6ac36edf1949bd16335d

data/README.adoc

@@ -20,6 +20,7 @@ Enhances the following objects:
 * IO
 * LogDevice
 * Logger
+* Module
 * Object
 * Pathname
 * String
@@ -87,6 +88,7 @@ require "refinements/hash"
 require "refinements/io"
 require "refinements/log_device"
 require "refinements/logger"
+require "refinements/module"
 require "refinements/object"
 require "refinements/pathname"
 require "refinements/string"
@@ -111,6 +113,7 @@ class Example
   using Refinements::IO
   using Refinements::LogDevice
   using Refinements::Logger
+  using Refinements::Module
   using Refinements::Object
   using Refinements::Pathname
   using Refinements::String
@@ -186,6 +189,8 @@ Removes given array or elements without mutating itself.
 
 ===== #filter_find
 
+⚠️ _This is deprecated and will be removed in Version 13.0.0._
+
 Answers the first element which evaluates to true from a filtered collection.
 
 [source,ruby]
@@ -969,7 +974,8 @@ logger.reread  # ""
 
 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
+[source,ruby]
+----
 logger = Logger.new STDOUT
 
 logger.any "Test."
@@ -977,7 +983,33 @@ logger.any "Test."
 
 logger.any { "Test." }
 A, [2000-01-10T09:00:00.330719 #44925]   ANY -- : Test.
-```
+----
+
+==== Module
+
+===== #pseudonym
+
+Allows you to set a temporary name for your anonymous `Module` (or `Class` since `Class` inherits from `Module`) with a better default than what `+#set_temporary_name+` provides.
+
+[source,ruby]
+----
+Module.new.pseudonym "demo"                       # demo-44600
+Module.new.pseudonym "demo", delimiter: "_"       # demo_60900
+Module.new.pseudonym "demo", nil                  # demo-
+Module.new.pseudonym "demo", nil, delimiter: nil  # demo
+----
+
+The same applies for anonymous classes since classes inherit from modules:
+
+[source,ruby]
+----
+Class.new.pseudonym "demo"                       # demo-44600 < Object
+Class.new.pseudonym "demo", delimiter: "_"       # demo_60900 < Object
+Class.new.pseudonym "demo", nil                  # demo- < Object
+Class.new.pseudonym "demo", nil, delimiter: nil  # demo < Object
+----
+
+💡 While convenient, if you find yourself nullifying the suffix and/or delimiter, you're better off using `+#set_temporary_name+`.
 
 ==== Object
 
@@ -1598,6 +1630,8 @@ io.to_str # "One, Two."
 
 ===== .with_positions
 
+⚠️ _This is deprecated and will be removed in Version 13.0.0._
+
 Answers a struct instance with given positional arguments regardless of
 whether the struct was constructed with positional or keyword arguments.
 

data/lib/refinements/array.rb

@@ -19,7 +19,12 @@ module Refinements
 
       def excluding(*elements) = self - elements.flatten
 
-      def filter_find(&) = block_given? ? lazy.map(&).find(&:itself) : lazy
+      def filter_find(&)
+        warn "`#{self.class}##{__method__}` is deprecated and will be removed in Version 13.0.0.",
+             category: :deprecated
+
+        block_given? ? lazy.map(&).find(&:itself) : lazy
+      end
 
       def including(*elements) = self + elements.flatten
 

data/lib/refinements/module.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Refinements
+  # Provides additional enhancements to the Symbol primitive.
+  module Module
+    refine ::Module do
+      def pseudonym prefix, suffix = object_id, delimiter: "-"
+        set_temporary_name "#{prefix}#{delimiter}#{suffix}"
+      end
+    end
+  end
+end

data/lib/refinements/struct.rb

@@ -6,7 +6,12 @@ module Refinements
   # Provides additional enhancements to the Struct primitive.
   module Struct
     refine ::Struct.singleton_class do
-      def with_positions(*values) = keyword_init? ? new(**members.zip(values).to_h) : new(*values)
+      def with_positions(*values)
+        warn "`#{self.class}##{__method__}` is deprecated and will be removed in Version 13.0.0.",
+             category: :deprecated
+
+        keyword_init? ? new(**members.zip(values).to_h) : new(*values)
+      end
     end
 
     refine ::Struct do

data/lib/refinements.rb

@@ -8,6 +8,7 @@ require "refinements/hash"
 require "refinements/io"
 require "refinements/log_device"
 require "refinements/logger"
+require "refinements/module"
 require "refinements/object"
 require "refinements/pathname"
 require "refinements/string"

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "12.9.0"
+  spec.version = "12.10.0"
   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: 12.9.0
+  version: 12.10.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-10-01 00:00:00.000000000 Z
+date: 2024-10-22 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -57,6 +57,7 @@ files:
 - lib/refinements/io.rb
 - lib/refinements/log_device.rb
 - lib/refinements/logger.rb
+- lib/refinements/module.rb
 - lib/refinements/object.rb
 - lib/refinements/pathname.rb
 - lib/refinements/shared/diff.rb
@@ -96,7 +97,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.20
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: A collection of core object refinements.

metadata.gz.sig

@@ -1,4 +1,2 @@
-�0��9�����$.��zY�J�U���`����N�Y꿧�y�P��6���b���e�4�-����$��Wc(������ ��������#=GLU��Tܭ��J��� ���JA�]��6
�� ��c�勻Z ���#���F�M���S�t�����ӊU5��<_��
-b��^�-�9��Pea�(�t��K�<	^�fI�'�F�D^�o� ���ϐNh�Di����]���πߢ�		��5Rr�H����DM��큸���jB��ӴҸU�ЅY���u+��_p@���
-����+(�M8V��'d��� ɋ����>�ow�}xTHc'9��ׇg%��[��Yd2`�>h�i
--yE*���s1z�
+>A��T������}���_��/؄�7n��("s��h^�@p2��|o0N�E{_�wfJ����6����ّ�U,���c�s$��`8���h
+�v%&��։{��K��Y�� ��n�Rw�1�����iD��"⼽Xぶrc+�S���nQ���^��*�\��C|b��Z�|�l��u"�v��'���y;�I���I���j�/H.�g7�k���m���Kw�D����W0g 9�-�@/�C{r����N�V�j�l����d���B��?]�ҴsAh6?��&�,�˽���?bS�ś`u���OXӟ˻�u����_���)�m�Xn1,