[ruby/ostruct] Emit a performance warning when OpenStruct is used

(https://github.com/ruby/ostruct/pull/56)

The OpenStruct documentation clearly state that it shouldn't
be used when performance is expected.

Ruby 3.3 introduce a new category of warnings that is silenced
by default: performance.

The expected use case is to enable this warning when looking
for potential performance issues within an application.

As such I think it would make sense to emit a performance warning
when OpenStruct is used, as it may help pinpoint that a dependency
rely on it, etc.

https://github.com/ruby/ostruct/commit/5826e12db8

Co-authored-by: Jean Boussier <[email protected]>

3 files changed, 32 insertions, 0 deletions

diff --git a/lib/ostruct.gemspec b/lib/ostruct.gemspec
index 21cce18226..61bf6e7dee 100644
--- a/lib/ostruct.gemspec
+++ b/lib/ostruct.gemspec
@@ -24,4 +24,5 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "rake"
+  spec.add_development_dependency "test-unit"
 end
diff --git a/lib/ostruct.rb b/lib/ostruct.rb
index a08561d6c9..7311138fbf 100644
--- a/lib/ostruct.rb
+++ b/lib/ostruct.rb
@@ -109,6 +109,14 @@
 class OpenStruct
   VERSION = "0.5.5"
 
+  HAS_PERFORMANCE_WARNINGS = begin
+    Warning[:performance]
+    true
+  rescue NoMethodError, ArgumentError
+    false
+  end
+  private_constant :HAS_PERFORMANCE_WARNINGS
+
   #
   # Creates a new OpenStruct object.  By default, the resulting OpenStruct
   # object will have no attributes.
@@ -124,6 +132,10 @@ class OpenStruct
   #   data   # => #<OpenStruct country="Australia", capital="Canberra">
   #
   def initialize(hash=nil)
+    if HAS_PERFORMANCE_WARNINGS && Warning[:performance]
+       warn "OpenStruct use is discouraged for performance reasons", uplevel: 1, category: :performance
+    end
+
     if hash
       update_to_values!(hash)
     else
diff --git a/test/ostruct/test_ostruct.rb b/test/ostruct/test_ostruct.rb
index 256db7a0c7..19bb606145 100644
--- a/test/ostruct/test_ostruct.rb
+++ b/test/ostruct/test_ostruct.rb
@@ -412,4 +412,23 @@ class TC_OpenStruct < Test::Unit::TestCase
     assert_equal('my-class', os.class)
     assert_equal(OpenStruct, os.class!)
   end
+
+  has_performance_warnings = begin
+    Warning[:performance]
+    true
+  rescue NoMethodError, ArgumentError
+    false
+  end
+
+  if has_performance_warnings
+    def test_performance_warning
+      assert_in_out_err(
+        %w(-Ilib -rostruct -w -W:performance -e) + ['OpenStruct.new(a: 1)'],
+        "",
+        [],
+        ["-e:1: warning: OpenStruct use is discouraged for performance reasons"],
+        success: true,
+      )
+    end
+  end
 end