🔇 Add silence_thread_safety_deprecation_warnings

This is provided as a temporary workaround, until dependant projects can
update their usage.

Author: nevans

lib/net/imap.rb

@@ -750,8 +750,18 @@ class << self
       alias default_imap_port default_port
       alias default_imaps_port default_tls_port
       alias default_ssl_port default_tls_port
+
+      # Set to true to silence deprecation warnings, e.g. from #responses.
+      # Defaults to false.
+      #
+      # These warnings are concerning thread-safety issues, so it is recommended
+      # to update other code and leave this value.  Deprecated usage will
+      # become errors regardless of this setting, so use this only temporarily.
+      attr_accessor :silence_thread_safety_deprecation_warnings
     end
 
+    self.silence_thread_safety_deprecation_warnings = false
+
     def client_thread # :nodoc:
       warn "Net::IMAP#client_thread is deprecated and will be removed soon."
       @client_thread
@@ -1995,7 +2005,9 @@ def responses(type = nil)
       elsif type
         raise ArgumentError, "Pass a block or use #clear_responses"
       else
-        warn("DEPRECATED: pass a block or use #clear_responses", uplevel: 1)
+        unless IMAP.silence_thread_safety_deprecation_warnings
+          warn("DEPRECATED: pass a block or use #clear_responses", uplevel: 1)
+        end
         @responses
       end
     end

test/net/imap/test_imap.rb

@@ -926,6 +926,8 @@ def test_responses
       end
       sock.getcmd # waits for logout command
     end
+    original_silence = Net::IMAP.silence_thread_safety_deprecation_warnings
+    Net::IMAP.silence_thread_safety_deprecation_warnings = false
     begin
       imap = Net::IMAP.new(server_addr, port: port)
       resp = imap.select "INBOX"
@@ -940,8 +942,16 @@ def test_responses
         assert_equal(%i[Answered Flagged Deleted Seen Draft],
                      imap.responses["FLAGS"]&.last)
       end
+      Net::IMAP.silence_thread_safety_deprecation_warnings = true
+      # TODO: assert_no_warn?
+      stderr = EnvUtil.verbose_warning {
+        assert_equal(%i[Answered Flagged Deleted Seen Draft],
+                     imap.responses["FLAGS"]&.last)
+      }
+      assert_empty stderr
       imap.logout
     ensure
+      Net::IMAP.silence_thread_safety_deprecation_warnings = original_silence
       imap.disconnect if imap
     end
   end