Project: RSpec Core 3.12

Publisher: RSpec

basic structure (`describe`/`it`)

RSpec is a DSL for creating executable examples of how code is expected to
behave, organized in groups. It uses the words "describe" and "it" so we can
express concepts like a conversation:

"Describe an account when it is first opened."
"It has a balance of zero."

The describe method creates an example group. Within the block passed to
describe you can declare nested groups using the describe or context
methods, or you can declare examples using the it or specify methods.

Under the hood, an example group is a class in which the block passed to
describe or context is evaluated. The blocks passed to it are evaluated
in the context of an instance of that class.

Scenarios

One group, one example

Given

a file named "sample_spec.rb" with:

RSpec.describe "something" do
  it "does something" do
  end
end

When

I run rspec sample_spec.rb -fdoc

Then

the output should contain:

something
  does something

Nested example groups (using `context`)

Given

a file named "nested_example_groups_spec.rb" with:

RSpec.describe "something" do
  context "in one context" do
    it "does one thing" do
    end
  end

  context "in another context" do
    it "does another thing" do
    end
  end
end

When

I run rspec nested_example_groups_spec.rb -fdoc

Then

the output should contain:

something
  in one context
    does one thing
  in another context
    does another thing

Last published 3 months ago by Jon Rowe.

basic structure (`describe`/`it`)

RSpec Core settings