Add in-tree mspec and ruby/spec

* For easier modifications of ruby/spec by MRI developers.
* .gitignore: track changes under spec.
* spec/mspec, spec/rubyspec: add in-tree mspec and ruby/spec.
  These files can therefore be updated like any other file in MRI.
  Instructions are provided in spec/README.
  [Feature #13156] [ruby-core:79246]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@58595 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 52 insertions, 0 deletions

diff --git a/spec/rubyspec/core/module/deprecate_constant_spec.rb b/spec/rubyspec/core/module/deprecate_constant_spec.rb
new file mode 100644
index 0000000000..8c7a170f1c
--- /dev/null
+++ b/spec/rubyspec/core/module/deprecate_constant_spec.rb
@@ -0,0 +1,52 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+ruby_version_is "2.3" do
+  describe "Module#deprecate_constant" do
+    before :each do
+      @module = Module.new
+      @value = :value
+      @module::PUBLIC1 = @value
+      @module::PUBLIC2 = @value
+      @module::PRIVATE = @value
+      @module.private_constant :PRIVATE
+      @module.deprecate_constant :PRIVATE
+      @pattern = /deprecated/
+    end
+
+    describe "when accessing the deprecated module" do
+      it "passes the accessing" do
+        @module.deprecate_constant :PUBLIC1
+
+        value = nil
+        lambda {
+          value = @module::PUBLIC1
+        }.should complain(@pattern)
+        value.should equal(@value)
+
+        lambda { @module::PRIVATE }.should raise_error(NameError)
+      end
+
+      it "warns with a message" do
+        @module.deprecate_constant :PUBLIC1
+
+        lambda { @module::PUBLIC1 }.should complain(@pattern)
+        lambda { @module.const_get :PRIVATE }.should complain(@pattern)
+      end
+    end
+
+    it "accepts multiple symbols and strings as constant names" do
+      @module.deprecate_constant "PUBLIC1", :PUBLIC2
+
+      lambda { @module::PUBLIC1 }.should complain(@pattern)
+      lambda { @module::PUBLIC2 }.should complain(@pattern)
+    end
+
+    it "returns self" do
+      @module.deprecate_constant(:PUBLIC1).should equal(@module)
+    end
+
+    it "raises a NameError when given an undefined name" do
+      lambda { @module.deprecate_constant :UNDEFINED }.should raise_error(NameError)
+    end
+  end
+end