Adds hook scope aliases example and context

lib/rspec/core/hooks.rb

@@ -471,6 +471,11 @@ def around_each_hooks_for(example, initial_procsy=nil)
 
       SCOPES = [:each, :all, :suite]
 
+      SCOPE_ALIASES = {
+        :example => :each,
+        :context => :all,
+      }
+
       HOOK_TYPES = {
         :before => Hash.new { BeforeHook },
         :after  => Hash.new { AfterHook  },
@@ -522,14 +527,25 @@ def scope_and_options_from(*args)
       end
 
       def extract_scope_from(args)
-        if SCOPES.include?(args.first)
-          args.shift
+        if Hooks.known_scope?(args.first)
+          Hooks.normalized_scope_for(args.shift)
         elsif args.any? { |a| a.is_a?(Symbol) }
-          raise ArgumentError.new("You must explicitly give a scope (:each, :all, or :suite) when using symbols as metadata for a hook.")
+          error_message = "You must explicitly give a scope (#{SCOPES.join(", ")}) or scope alias (#{SCOPE_ALIASES.keys.join(", ")}) when using symbols as metadata for a hook."
+          raise ArgumentError.new error_message
         else
           :each
         end
       end
+
+      # @api private
+      def self.known_scope?(scope)
+        SCOPES.include?(scope) || SCOPE_ALIASES.keys.include?(scope)
+      end
+
+      # @api private
+      def self.normalized_scope_for(scope)
+        SCOPE_ALIASES[scope] || scope
+      end
     end
   end
 end

spec/rspec/core/example_group_spec.rb

@@ -562,6 +562,52 @@ def define_and_run_group(define_outer_example = false)
     end
 
     describe "#before, after, and around hooks" do
+      describe "scope aliasing" do
+        it "aliases the `:context` hook scope to `:all` for before-hooks" do
+          group = ExampleGroup.describe
+          order = []
+          group.before(:context) { order << :before_context }
+          group.example("example") { order << :example }
+          group.example("example") { order << :example }
+
+          group.run
+          expect(order).to eq([:before_context, :example, :example])
+        end
+
+        it "aliases the `:example` hook scope to `:each` for before-hooks" do
+          group = ExampleGroup.describe
+          order = []
+          group.before(:example) { order << :before_example }
+          group.example("example") { order << :example }
+          group.example("example") { order << :example }
+
+          group.run
+          expect(order).to eq([:before_example, :example, :before_example, :example])
+        end
+
+        it "aliases the `:context` hook scope to `:all` for after-hooks" do
+          group = ExampleGroup.describe
+          order = []
+          group.example("example") { order << :example }
+          group.example("example") { order << :example }
+          group.after(:context) { order << :after_context }
+
+          group.run
+          expect(order).to eq([:example, :example, :after_context])
+        end
+
+        it "aliases the `:example` hook scope to `:each` for after-hooks" do
+          group = ExampleGroup.describe
+          order = []
+          group.example("example") { order << :example }
+          group.example("example") { order << :example }
+          group.after(:example) { order << :after_example }
+
+          group.run
+          expect(order).to eq([:example, :after_example, :example, :after_example])
+        end
+      end
+
       it "runs the before alls in order" do
         group = ExampleGroup.describe
         order = []