facets 3.2.2 → 4.0.0

data/lib/core/facets/enumerable/hashify.rb

@@ -39,12 +39,12 @@ module Enumerable
 
   def hashify(val=nil, &block)
     if val
-      warn "The old Enumerable#hashify method has been be deprecated. Use #value_by instead."
+      warn "The old Enumerable#hashify method is deprecated. Use #value_by instead. It will be removed after 2027-09-30.", uplevel: 1
       value_by{ val }
     end
 
     if block
-      warn "The old Enumerable#hashify method has been be deprecated. Use #value_by instead."
+      warn "The old Enumerable#hashify method is deprecated. Use #value_by instead. It will be removed after 2027-09-30.", uplevel: 1
       value_by(&block)
     end
 

data/lib/core/facets/enumerable/hinge.rb

@@ -10,7 +10,7 @@ module Enumerable
   # TODO: Enumerable#hinge will get a new name.
   #
   def hinge(init={}, &block)
-    warn "Enumerable#hinge is deprecated. Use Enumerable#each_with_object instead (note: block args are reversed).", uplevel: 1
+    warn "Enumerable#hinge is deprecated. Use Enumerable#each_with_object instead (note: block args are reversed). It will be removed after 2027-09-30.", uplevel: 1
     each_with_object(init) { |e, obj| block.call(obj, e) }
   end
 

data/lib/core/facets/enumerable/map_with_index.rb

@@ -8,7 +8,7 @@ module Enumerable
   # CREDIT: Gavin Sinclair
 
   def map_with_index(&block)
-    warn "Enumerable#map_with_index is deprecated. Use Enumerable#map.with_index instead.", uplevel: 1
+    warn "Enumerable#map_with_index is deprecated. Use Enumerable#map.with_index instead. It will be removed after 2027-09-30.", uplevel: 1
     map.with_index(&block)
   end
 

data/lib/core/facets/enumerable/mash.rb

@@ -3,8 +3,9 @@ require 'facets/enumerable/graph'
 module Enumerable
 
   # @deprecated Use Enumerable#graph instead.
+  #   Scheduled for removal after 2027-09-30.
   def mash(&yld)
-    warn "Enumerable#mash is deprecated. Use Enumerable#graph instead.", uplevel: 1
+    warn "Enumerable#mash is deprecated. Use Enumerable#graph instead. It will be removed after 2027-09-30.", uplevel: 1
     graph(&yld)
   end
 

data/lib/core/facets/enumerable/uniq_by.rb

@@ -1,8 +1,10 @@
 module Enumerable
 
   # @deprecated Use Enumerable#uniq with a block instead (Ruby 1.9.2+).
+  #   Scheduled for removal after 2027-09-30.
   def uniq_by(&block)
-    warn "Enumerable#uniq_by is deprecated. Use Enumerable#uniq(&block) instead.", uplevel: 1
+    warn "Enumerable#uniq_by is deprecated. Use Enumerable#uniq(&block) instead. " \
+         "It will be removed after 2027-09-30.", uplevel: 1
     uniq(&block)
   end
 

data/lib/core/facets/essentials.rb

@@ -47,7 +47,6 @@ require_relative 'hash/delete_values'
 require_relative 'hash/except'
 require_relative 'hash/rekey'
 require_relative 'hash/revalue'
-require_relative 'hash/slice'
 
 ### Proc
 #require_relative 'proc/wrap'
@@ -63,3 +62,7 @@ require_relative 'string/trim'
 require_relative 'string/unindent'
 #require_realtive 'string/word_wrap'
 
+
+# Rails-compatible methods from lib/rails; see facets/rails_bridge.
+require_relative 'rails_bridge'
+Facets.rails_bridge(Hash, 'facets/hash/slice', :slice!)

data/lib/core/facets/exception/error_print.rb

@@ -1,14 +1,16 @@
 class Exception
 
   # @deprecated Use Exception#full_message instead (built-in since Ruby 2.5).
+  #   Scheduled for removal after 2027-09-30.
   def self.error_print(e)
-    warn "Exception.error_print is deprecated. Use Exception#full_message instead.", uplevel: 1
+    warn "Exception.error_print is deprecated. Use Exception#full_message instead. It will be removed after 2027-09-30.", uplevel: 1
     e.full_message
   end
 
   # @deprecated Use Exception#full_message instead (built-in since Ruby 2.5).
+  #   Scheduled for removal after 2027-09-30.
   def error_print
-    warn "Exception#error_print is deprecated. Use Exception#full_message instead.", uplevel: 1
+    warn "Exception#error_print is deprecated. Use Exception#full_message instead. It will be removed after 2027-09-30.", uplevel: 1
     full_message
   end
 

data/lib/core/facets/file/null.rb

@@ -1,8 +1,9 @@
 class File
 
   # @deprecated Use File::NULL constant instead (built-in since Ruby 1.9.3).
+  #   Scheduled for removal after 2027-09-30.
   def self.null
-    warn "File.null is deprecated. Use File::NULL instead.", uplevel: 1
+    warn "File.null is deprecated. Use File::NULL instead. It will be removed after 2027-09-30.", uplevel: 1
     File::NULL
   end
 

data/lib/core/facets/file/read_binary.rb

@@ -1,8 +1,9 @@
 class File
 
   # @deprecated Use File.binread instead (built-in since Ruby 1.9.3).
+  #   Scheduled for removal after 2027-09-30.
   def self.read_binary(fname)
-    warn "File.read_binary is deprecated. Use File.binread instead.", uplevel: 1
+    warn "File.read_binary is deprecated. Use File.binread instead. It will be removed after 2027-09-30.", uplevel: 1
     binread(fname)
   end
 

data/lib/core/facets/file.rb

@@ -1,5 +1,5 @@
 require_relative 'file/append.rb'
-#require_relative 'file/atomic_write.rb'    # uncommon
+#require 'facets/file/atomic_write'    # lib/rails, uncommon
 require_relative 'file/common_path.rb'
 require_relative 'file/create.rb'
 require_relative 'file/ext.rb'

data/lib/core/facets/hash/fetch_nested.rb

@@ -1,6 +1,7 @@
 class Hash
 
   # @deprecated Use Hash#dig instead (built-in since Ruby 2.3).
+  #   Scheduled for removal after 2027-09-30.
   #
   # Similar to Hash#dig but supports a block for missing keys,
   # like Hash#fetch does. Ruby's #dig does not support a block.
@@ -8,7 +9,7 @@ class Hash
   # TODO: Consider proposing block support for Hash#dig to Ruby core.
   #
   def fetch_nested(*keys, &block)
-    warn "Hash#fetch_nested is deprecated. Use Hash#dig instead.", uplevel: 1
+    warn "Hash#fetch_nested is deprecated. Use Hash#dig instead. It will be removed after 2027-09-30.", uplevel: 1
     begin
       keys.reduce(self) { |accum, k| accum.fetch(k) }
     rescue KeyError

data/lib/core/facets/hash/update_keys.rb

@@ -1,9 +1,10 @@
 class Hash
 
   # @deprecated Use Hash#transform_keys! (Ruby 2.5+) or Hash#rekey! instead.
+  #   Scheduled for removal after 2027-09-30.
   #
   def update_keys(&block)
-    warn "Hash#update_keys is deprecated. Use Hash#transform_keys! or Hash#rekey! instead.", uplevel: 1
+    warn "Hash#update_keys is deprecated. Use Hash#transform_keys! or Hash#rekey! instead. It will be removed after 2027-09-30.", uplevel: 1
     if block_given?
       transform_keys!(&block)
     else

data/lib/core/facets/hash/update_values.rb

@@ -1,9 +1,10 @@
 class Hash
 
   # @deprecated Use Hash#transform_values! (Ruby 2.4+) or Hash#revalue! instead.
+  #   Scheduled for removal after 2027-09-30.
   #
   def update_values(&block)
-    warn "Hash#update_values is deprecated. Use Hash#transform_values! or Hash#revalue! instead.", uplevel: 1
+    warn "Hash#update_values is deprecated. Use Hash#transform_values! or Hash#revalue! instead. It will be removed after 2027-09-30.", uplevel: 1
     if block_given?
       transform_values!(&block)
     else

data/lib/core/facets/hash.rb

@@ -33,13 +33,9 @@ require_relative 'hash/recursively.rb'
 require_relative 'hash/rekey.rb'
 require_relative 'hash/replace_each.rb'
 require_relative 'hash/reverse_merge.rb'
-require_relative 'hash/slice.rb'
-require_relative 'hash/stringify_keys.rb'
 require_relative 'hash/subset.rb'
 require_relative 'hash/swap.rb'
-require_relative 'hash/symbolize_keys.rb'
 require_relative 'hash/to_mod.rb'
-require_relative 'hash/to_options.rb'
 require_relative 'hash/setter.rb'
 require_relative 'hash/to_struct.rb'
 require_relative 'hash/traverse.rb'
@@ -51,3 +47,9 @@ require_relative 'hash/update_values.rb'
 require_relative 'hash/weave.rb'
 require_relative 'hash/zip.rb'
 
+
+# Rails-compatible methods from lib/rails; see facets/rails_bridge.
+require_relative 'rails_bridge.rb'
+Facets.rails_bridge(Hash, 'facets/hash/slice', :slice!)
+Facets.rails_bridge(Hash, 'facets/hash/symbolize_keys', :symbolize_keys, :symbolize_keys!, :stringify_keys, :stringify_keys!)
+Facets.rails_bridge(Hash, 'facets/hash/to_options', :to_options, :to_options!)

data/lib/core/facets/kernel/eigenclass.rb

@@ -10,6 +10,7 @@ module Kernel
   #
   # @deprecated Use singleton_class or meta_class instead.
   #   Kept in tribute to WhyTheLuckyStiff who coined the term.
+  #   Scheduled for removal after 2027-09-30.
   #
   # CREDIT: WhyTheLuckyStiff
   #
@@ -17,7 +18,7 @@ module Kernel
   #   require 'facets/kernel/eigenclass'
   #
   def eigenclass
-    warn "Kernel#eigenclass is deprecated. Use singleton_class or meta_class instead.", uplevel: 1
+    warn "Kernel#eigenclass is deprecated. Use singleton_class or meta_class instead. It will be removed after 2027-09-30.", uplevel: 1
     singleton_class
   end
 

data/lib/core/facets/kernel/extension.rb

@@ -1,8 +1,9 @@
 module Kernel
 
   # @deprecated Use singleton_class or meta_class instead.
+  #   Scheduled for removal after 2027-09-30.
   def extension
-    warn "Kernel#extension is deprecated. Use singleton_class or meta_class instead.", uplevel: 1
+    warn "Kernel#extension is deprecated. Use singleton_class or meta_class instead. It will be removed after 2027-09-30.", uplevel: 1
     singleton_class
   end
 

data/lib/core/facets/kernel/instance_class.rb

@@ -1,8 +1,9 @@
 module Kernel
 
   # @deprecated Use singleton_class or meta_class instead.
+  #   Scheduled for removal after 2027-09-30.
   def instance_class(&block)
-    warn "Kernel#instance_class is deprecated. Use singleton_class or meta_class instead.", uplevel: 1
+    warn "Kernel#instance_class is deprecated. Use singleton_class or meta_class instead. It will be removed after 2027-09-30.", uplevel: 1
     singleton_class.module_eval(&block) if block
     singleton_class
   end

data/lib/core/facets/kernel/instance_send.rb

@@ -1,8 +1,9 @@
 module Kernel
 
   # @deprecated Use __send__ instead.
+  #   Scheduled for removal after 2027-09-30.
   def instance_send(name, *args, &blk)
-    warn "Kernel#instance_send is deprecated. Use __send__ instead.", uplevel: 1
+    warn "Kernel#instance_send is deprecated. Use __send__ instead. It will be removed after 2027-09-30.", uplevel: 1
     __send__(name, *args, &blk)
   end
 

data/lib/core/facets/kernel/like.rb

@@ -12,8 +12,13 @@ module Kernel
     equal?(x) || eql?(x) || self == x || self === x
   end
 
-  # @deprecated
-  alias :equate? :like?
+  # @deprecated Use #like? instead.
+  #   Scheduled for removal after 2027-09-30.
+  def equate?(x)
+    warn "Kernel#equate? is deprecated. Use Kernel#like? instead. " \
+         "It will be removed after 2027-09-30.", uplevel: 1
+    like?(x)
+  end
 
 end
 

data/lib/core/facets/kernel/load_relative.rb

@@ -2,8 +2,9 @@ module Kernel
 
   # @deprecated Use require_relative for requires; for load, use
   #   an absolute path via File.expand_path.
+  #   Scheduled for removal after 2027-09-30.
   def load_relative(relative_feature, safe=nil)
-    warn "Kernel#load_relative is deprecated.", uplevel: 1
+    warn "Kernel#load_relative is deprecated. It will be removed after 2027-09-30.", uplevel: 1
     loc = caller_locations(1, 1).first
     file = loc.absolute_path || loc.path
     absolute = File.expand_path(relative_feature, File.dirname(file))

data/lib/core/facets/kernel/memo.rb

@@ -2,12 +2,13 @@ module Kernel
 
   # @deprecated Use Module#memoize instead, which provides proper
   #   per-object memoization without a global variable.
+  #   Scheduled for removal after 2027-09-30.
   #
   # @uncommon
   #   require 'facets/kernel/memo'
   #
   def memo(*args, &block)
-    warn "Kernel#memo is deprecated. Use Module#memoize instead.", uplevel: 1
+    warn "Kernel#memo is deprecated. Use Module#memoize instead. It will be removed after 2027-09-30.", uplevel: 1
     $MEMO ||= {}
     if args.empty?
       args = block.binding.eval('[self, __method__]')

data/lib/core/facets/kernel/meta.rb

@@ -28,7 +28,7 @@ module Kernel
   end
 
   def eigen
-    warn "The `eigen' method is deprecated. Please use `meta' instead."
+    warn "The `eigen' method is deprecated. Please use `meta' instead. It will be removed after 2027-09-30.", uplevel: 1
     meta
   end
 

data/lib/core/facets/kernel/object_class.rb

@@ -1,8 +1,9 @@
 module Kernel
 
   # @deprecated Use __class__ instead.
+  #   Scheduled for removal after 2027-09-30.
   def object_class
-    warn "Kernel#object_class is deprecated. Use __class__ instead.", uplevel: 1
+    warn "Kernel#object_class is deprecated. Use __class__ instead. It will be removed after 2027-09-30.", uplevel: 1
     self.class
   end
 

data/lib/core/facets/kernel/object_send.rb

@@ -1,8 +1,9 @@
 module Kernel
 
   # @deprecated Use public_send instead (built-in since Ruby 1.9.2).
+  #   Scheduled for removal after 2027-09-30.
   def object_send(name, *args, &blk)
-    warn "Kernel#object_send is deprecated. Use public_send instead.", uplevel: 1
+    warn "Kernel#object_send is deprecated. Use public_send instead. It will be removed after 2027-09-30.", uplevel: 1
     public_send(name, *args, &blk)
   end
 

data/lib/core/facets/kernel/qua_class.rb

@@ -1,8 +1,9 @@
 module Kernel
 
   # @deprecated Use singleton_class or meta_class instead.
+  #   Scheduled for removal after 2027-09-30.
   def qua_class(&block)
-    warn "Kernel#qua_class is deprecated. Use singleton_class or meta_class instead.", uplevel: 1
+    warn "Kernel#qua_class is deprecated. Use singleton_class or meta_class instead. It will be removed after 2027-09-30.", uplevel: 1
     if block_given?
       singleton_class.class_eval(&block)
     else

data/lib/core/facets/kernel/returning.rb

@@ -1,9 +1,11 @@
 module Kernel
 
   # @deprecated Use Kernel#tap instead (built-in since Ruby 1.9).
+  #   Scheduled for removal after 2027-09-30.
   #
   def returning(obj=self)
-    warn "Kernel#returning is deprecated. Use Kernel#tap instead.", uplevel: 1
+    warn "Kernel#returning is deprecated. Use Kernel#tap instead. " \
+         "It will be removed after 2027-09-30.", uplevel: 1
     yield obj
     obj
   end

data/lib/core/facets/kernel/silence.rb

@@ -9,31 +9,44 @@ module Kernel
   # Supported +streams+ are +stderr+, +stdout+, +verbose+, +debug+,
   # and +warnings+, which is the same as +verbose+. You can also
   # use the actual streams, STDERR and STDOUT.
+  #
+  #   silence(:verbose) do
+  #     warn "won't see me either"
+  #   end
+  #
+  # +verbose+ sets $VERBOSE to nil and +debug+ sets $DEBUG to false
+  # for the duration of the block.
+  #
+  # Silencing a stream works by reopening it on the null device, so it
+  # affects the whole process, not just the current thread.
   def silence(*streams) #:yield:
-    streams = streams.map do |stream|
-      case stream
-      when :stderr
-        STDERR
-      when :stdout
-        STDOUT
-      else
-        stream
-      end
+    verbose, debug = $VERBOSE, $DEBUG
+    $VERBOSE = nil   if (streams & [:verbose, :warnings]).any?
+    $DEBUG   = false if streams.include?(:debug)
+
+    streams = (streams - [:verbose, :warnings, :debug]).map do |stream|
+      {stderr: STDERR, stdout: STDOUT}.fetch(stream, stream)
     end
 
-    if streams.empty?
-      yield
-    else
-      silence_stream(*streams){ yield }
+    on_hold = streams.collect{ |stream| stream.dup }
+    streams.each do |stream|
+      stream.reopen(File::NULL)
+      stream.sync = true
     end
+    yield
+  ensure
+    streams.each_with_index do |stream, i|
+      stream.reopen(on_hold[i])
+    end if on_hold
+    $VERBOSE, $DEBUG = verbose, debug
   end
 
-  # Just like silence_stream, but will default to
+  # Just like #silence, but will default to
   # STDOUT, STDERR if no streams are given.
 
   def silently(*streams) #:yeild:
     streams = [STDOUT, STDERR] if streams.empty?
-    silence_stream(*streams){ yield }
+    silence(*streams){ yield }
   end
 
   # Silences any stream for the duration of the block...
@@ -45,29 +58,24 @@ module Kernel
   #   puts 'But this will'
   #
   # CREDIT: David Heinemeier Hansson
+  #
+  # @deprecated Use #silence instead, which takes the same arguments.
+  #   Scheduled for removal after 2027-09-30.
 
   def silence_stream(*streams) #:yeild:
-    on_hold = streams.collect{ |stream| stream.dup }
-    streams.each do |stream|
-      stream.reopen(RUBY_PLATFORM =~ /mswin/ ? 'NUL:' : '/dev/null')
-      stream.sync = true
-    end
-    yield
-  ensure
-    streams.each_with_index do |stream, i|
-      stream.reopen(on_hold[i])
-    end
+    warn "Kernel#silence_stream is deprecated. Use Kernel#silence instead. " \
+         "It will be removed after 2027-09-30.", uplevel: 1
+    silence(*streams){ yield }
   end
 
-  # Equivalent to `silence_stream(STDERR)`.
+  # Equivalent to `silence(STDERR)`.
   def silence_stderr #:yeild:
-    silence_stream(STDERR) { yield }
+    silence(STDERR) { yield }
   end
 
-  # Equivalent to `silence_stream(STDOUT)`.
+  # Equivalent to `silence(STDOUT)`.
   def silence_stdout #:yeild:
-    silence_stream(STDOUT) { yield }
+    silence(STDOUT) { yield }
   end
 
 end
-

data/lib/core/facets/kernel/tee.rb

@@ -1,2 +1,5 @@
 # @deprecated Use Kernel#functor instead.
+#   Scheduled for removal after 2027-09-30.
+warn "facets/kernel/tee is deprecated. Use facets/kernel/functor instead. " \
+     "It will be removed after 2027-09-30.", uplevel: 1
 require 'facets/kernel/functor'

data/lib/core/facets/kernel/try.rb

@@ -3,21 +3,26 @@ require 'facets/functor'
 module Kernel
 
   # Invokes the method identified by the symbol +method+, passing it any
-  # arguments and/or the block specified.
-  #
-  # Unlike regular send, a +NoMethodError+ exception will *not* be raised
-  # if the receiving object is +nil+ (see NilClass#try below).
-  #
-  # Compatible with ActiveSupport's #try, plus an additional Functor
-  # form when called with no arguments and no block.
+  # arguments and/or the block specified. If the receiver is +nil+, it
+  # returns +nil+ instead (see NilClass#try below). Otherwise it behaves
+  # exactly like a normal call (or &.): a method the receiver doesn't have,
+  # or a private one, raises NoMethodError.
   #
   #   @example.try(:name)              #=> "bob"
-  #   @example.try { |o| o.name }     #=> "bob"  (ActiveSupport block form)
-  #   @example.try.name               #=> "bob"  (Facets Functor form)
+  #   @example.try { |o| o.name }     #=> "bob"
+  #   @example.try.name               #=> "bob"  (Functor form)
+  #   nil.try.name                    #=> nil
+  #
+  # NOTE: THIS IS NOT ACTIVESUPPORT'S #try. SINCE RAILS 4.0, ACTIVESUPPORT'S
+  # #try RETURNS NIL FOR A METHOD THE RECEIVER DOESN'T HAVE, SO A TYPO LIKE
+  # user.try(:nmae) QUIETLY BECOMES NIL AND HIDES THE BUG. FACETS KEEPS #try
+  # STRICT AND PUTS THE LENIENT BEHAVIOR IN #try!, WHERE IT BELONGS: IN RUBY,
+  # THE BANG MARKS THE MORE DANGEROUS VERSION OF A METHOD, AND SWALLOWING A
+  # MISSING METHOD IS THE DANGEROUS ONE. RAILS HAS THE TWO BACKWARD.
   #
   def try(method=nil, *args, &block)
     if method
-      __send__(method, *args, &block)
+      public_send(method, *args, &block)
     elsif block_given?
       yield self
     else
@@ -25,12 +30,19 @@ module Kernel
     end
   end
 
-  # Like #try, but raises NoMethodError if the method doesn't exist
-  # (unless receiver is nil). Compatible with ActiveSupport's #try!.
+  # Like #try, but also returns +nil+ if the receiver doesn't respond to
+  # +method+ (or it is private), instead of raising NoMethodError.
+  #
+  #   @example.try!(:name)             #=> "bob"
+  #   @example.try!(:nmae)             #=> nil
+  #
+  # NOTE: THIS IS THE OPPOSITE OF ACTIVESUPPORT'S #try!, WHICH RAISES. THE
+  # BANG IS HERE BECAUSE QUIETLY IGNORING A MISSING METHOD IS THE DANGEROUS
+  # BEHAVIOR; SEE #try ABOVE.
   #
   def try!(method=nil, *args, &block)
     if method
-      public_send(method, *args, &block)
+      public_send(method, *args, &block) if respond_to?(method)
     elsif block_given?
       yield self
     else
@@ -40,7 +52,6 @@ module Kernel
 
 end
 
-
 class NilClass
 
   # See Kernel#try.

data/lib/core/facets/kernel/with.rb

@@ -1,20 +1,26 @@
 module Kernel
 
-  # Like returning but exectues the block
-  # via instance_eval.
+  # Evaluate the block with +obj+ as self and return the block's value.
+  # It is simply a more readable spelling of #instance_eval.
   #
-  #   def foo
-  #     with values = [] do
-  #       self << 'bar'
-  #       self << 'baz'
-  #     end
+  #   values = []
+  #   with values do
+  #     self << 'bar'
+  #     self << 'baz'
   #   end
+  #   values # => ['bar', 'baz']
   #
-  #   foo # => ['bar', 'baz']
+  # @deprecated Use obj.instance_eval { ... } instead. Rails 7.1 defines an
+  #   unrelated Object#with that temporarily sets attributes, and this one
+  #   silently replaces it. Scheduled for removal after 2027-09-30.
+  #
+  # @uncommon
+  #   require 'facets/kernel/with'
   #
   def with(obj=self, &block)
+    warn "Kernel#with is deprecated. Use obj.instance_eval { ... } instead. " \
+         "It will be removed after 2027-09-30.", uplevel: 1
     obj.instance_eval(&block)
   end
 
 end
-

data/lib/core/facets/kernel.rb

@@ -63,7 +63,7 @@ require_relative 'kernel/temporarily.rb'
 require_relative 'kernel/true.rb'
 require_relative 'kernel/try.rb'
 require_relative 'kernel/val.rb'
-require_relative 'kernel/with.rb'
+#require_relative 'kernel/with.rb'             # uncommon
 require_relative 'kernel/writers.rb'
 #require_relative 'kernel/y.rb'                 # uncommon
 require_relative 'kernel/yes.rb'

data/lib/core/facets/module/alias_method_chain.rb

@@ -1,12 +1,14 @@
 class Module
 
   # @deprecated Use Module#prepend instead (built-in since Ruby 2.0).
+  #   Scheduled for removal after 2027-09-30.
   #
   # The alias_method_chain pattern has been superseded by Module#prepend,
   # which provides a cleaner way to wrap methods.
   #
   def alias_method_chain(target, feature)
-    warn "Module#alias_method_chain is deprecated. Use Module#prepend instead.", uplevel: 1
+    warn "Module#alias_method_chain is deprecated. Use Module#prepend instead. " \
+         "It will be removed after 2027-09-30.", uplevel: 1
     aliased_target, punctuation = target.to_s.sub(/([?!=])$/, ''), $1
     yield(aliased_target, punctuation) if block_given?
 

data/lib/core/facets/module/alias_module_function.rb

@@ -23,7 +23,10 @@ class Module
   #
   def alias_module_function(new, old)
     alias_method(new, old)
-    module_function(new)
+    return module_function(new) unless singleton_class.method_defined?(old)
+    # Alias the singleton method directly. On JRuby, a singleton method made
+    # by #module_function turns private when it is itself aliased later.
+    singleton_class.send(:alias_method, new, old)
   end
 
 end

data/lib/core/facets/module/can.rb

@@ -1,8 +1,9 @@
 class Module
 
   # @deprecated Use Module#extend instead.
+  #   Scheduled for removal after 2027-09-30.
   def can(*mods)
-    warn "Module#can is deprecated. Use Module#extend instead.", uplevel: 1
+    warn "Module#can is deprecated. Use Module#extend instead. It will be removed after 2027-09-30.", uplevel: 1
     extend(*mods)
   end
 

data/lib/core/facets/objectspace/op_fetch.rb

@@ -1,3 +1,4 @@
 class << ObjectSpace
-  alias_method :[], :_id2ref
+  # Ruby 4.1 removed ObjectSpace._id2ref, so there is nothing to alias there.
+  alias_method :[], :_id2ref if method_defined?(:_id2ref)
 end

data/lib/core/facets/proc/compose.rb

@@ -1,14 +1,16 @@
 class Proc
 
   # @deprecated Use Proc#>> or Proc#<< instead (built-in since Ruby 2.6).
+  #   Scheduled for removal after 2027-09-30.
   def compose(g)
-    warn "Proc#compose is deprecated. Use Proc#<< instead (right-to-left composition).", uplevel: 1
+    warn "Proc#compose is deprecated. Use Proc#<< instead (right-to-left composition). It will be removed after 2027-09-30.", uplevel: 1
     self << g
   end
 
   # @deprecated Use Proc#>> or Proc#<< for composition (built-in since Ruby 2.6).
+  #   Scheduled for removal after 2027-09-30.
   def *(x)
-    warn "Proc#* is deprecated. Use Proc#<< for composition (right-to-left).", uplevel: 1
+    warn "Proc#* is deprecated. Use Proc#<< for composition (right-to-left). It will be removed after 2027-09-30.", uplevel: 1
     if Integer === x
       c = []
       x.times{|i| c << call(i)}