module RSpec::Core::DSL

DSL defines methods to group examples, most notably ‘describe`, and exposes them as class methods of {RSpec}.

By default the methods ‘describe`, `context` and `example_group` are exposed. These methods define a named context for one or more examples. The given block is evaluated in the context of a generated subclass of {RSpec::Core::ExampleGroup}.

## Examples:

RSpec.describe "something" do
  context "when something is a certain way" do
    it "does something" do
      # example code goes here
    end
  end
end

@see ExampleGroup @see ExampleGroup.example_group

# File rspec-core/lib/rspec/core/dsl.rb, line 25
def self.example_group_aliases
  @example_group_aliases ||= []
end

# File rspec-core/lib/rspec/core/dsl.rb, line 30
def self.expose_example_group_alias(name)
  return if example_group_aliases.include?(name)

  example_group_aliases << name

  (class << RSpec; self; end).__send__(:define_method, name) do |*args, &example_group_block|
    group = RSpec::Core::ExampleGroup.__send__(name, *args, &example_group_block)
    RSpec.world.record(group)
    group
  end
end