module RSpec::Core::Hooks

def after(*args, &block)

def after(*args, &block)
  scope, options = scope_and_options_from(*args)
  hooks[:after][scope] << AfterHook.new(options, &block)
end

def around(*args, &block)

def around(*args, &block)
  scope, options = scope_and_options_from(*args)
  hooks[:around][scope] << AroundHook.new(options, &block)
end

def before(*args, &block)

def before(*args, &block)
  scope, options = scope_and_options_from(*args)
  hooks[:before][scope] << BeforeHook.new(options, &block)
end

def find_hook(hook, scope, example_group_class, example = nil)

def find_hook(hook, scope, example_group_class, example = nil)
  found_hooks = hooks[hook][scope].find_hooks_for(example || example_group_class)
  # ensure we don't re-run :all hooks that were applied to any of the parent groups
  if scope == :all
    super_klass = example_group_class.superclass
    while super_klass != RSpec::Core::ExampleGroup
      found_hooks = found_hooks.without_hooks_for(super_klass)
      super_klass = super_klass.superclass
    end
  end
  found_hooks
end

def hooks

def hooks
  @hooks ||= {
    :around => { :each => AroundHooks.new },
    :before => { :each => BeforeHooks.new, :all => BeforeHooks.new, :suite => BeforeHooks.new },
    :after => { :each => AfterHooks.new, :all => AfterHooks.new, :suite => AfterHooks.new }
  }
end

def run_hook(hook, scope, example_group_instance=nil)

example. If no example is provided, just calls the hook directly.
Runs all of the blocks stored with the hook in the context of the
def run_hook(hook, scope, example_group_instance=nil)
  hooks[hook][scope].run_all(example_group_instance)
end

def run_hook!(hook, scope, example_group_instance)

ensuring that they will only be run once.
Just like run_hook, except it removes the blocks as it evalutes them,
def run_hook!(hook, scope, example_group_instance)
  hooks[hook][scope].run_all!(example_group_instance)
end

def run_hook_filtered(hook, scope, group, example_group_instance, example = nil)

def run_hook_filtered(hook, scope, group, example_group_instance, example = nil)
  find_hook(hook, scope, group, example).run_all(example_group_instance)
end

def scope_and_options_from(*args)

def scope_and_options_from(*args)
  scope = if [:each, :all, :suite].include?(args.first)
    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.")
  else
    :each
  end
  options = build_metadata_hash_from(args)
  return scope, options
end