refinements 12.9.0 → 12.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 229ada32a4378800013462184db88be59d33109cbbd63c8c6378add52fc7b321
-  data.tar.gz: 4f0291390f858b45e2066dc9eac5e3f06ceef5c9e1051160aa7c625e734c78c4
+  metadata.gz: d69e0e63ab3517d24dcd3bdce7e3e431e01b8d650c8cf2dab0d61eaa3cb062e1
+  data.tar.gz: 55f9613cf283a4423fb22008fa8e686d7a2d2c4d9a8d387c64fd1040e850feea
 SHA512:
-  metadata.gz: dbe61e5483ff24ffe0d9852e3f1c34e613f53a48f8a96cb15b862bf2528c448df71e9357d2910068b7e41275a916a9169f99e6b5b67c355df73eaf3e6ac2d124
-  data.tar.gz: 3f77b617a157b3d9be6735a08a9340ddd945642107d5e2728e384f6496197a44e180cfcce8c5738ec5ea509df883fcc5ca3b1261ffaddeaedbcfe0764987d9d0
+  metadata.gz: 0d98d59c37417c339097cfceda519c0099a7e4b63ef28966c769865cd64d2a174c60fc5d7f92f602e09c7dd001fd6e1cba6bc24f08bc5c8ace90b1d3e3d395ce
+  data.tar.gz: 0a8c378c45fa6a4a20f05a1bfa1786a5840761648b1e9c1f8114e9a837a3398aeac35b47820743366ccf618e3288a863e3b4a290a637e2db3c72454294e6ffeb

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.11.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.11.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-11-09 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.23
 signing_key:
 specification_version: 4
 summary: A collection of core object refinements.

metadata.gz.sig

@@ -1,4 +1 @@
-�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ڦtPefp�j,��>�ӿhR��{ƅb�y׀,˯�;���4�hʥ$Nb�q�r��ܳ8y���%�%�0�鯴NNm�o>\[[>��A�?�G.A������<	?��O�&�y�%a3�F��)��uX�_��QȆ�E��ئgѡ$�*�R�K�v��_W��yy��������� R�7\sٗTrK<:����M�:���A�8T�5F�w�3g��4>��`J��URX)��6��WJ����[-�.q�h���Դr$�Sq+��{%�������".�:&a,X���{N�I���¸AVŒ����R�lC���		��5������&Y�M����e��T�a�C����ad�9������