/usr/share/doc/ruby-rspec-core/features/example_groups/basic_structure.feature is in ruby-rspec-core 3.5.0c3e0m0s0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 | Feature: 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.
Scenario: One group, one example
Given a file named "sample_spec.rb" with:
"""ruby
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
"""
Scenario: Nested example groups (using `context`)
Given a file named "nested_example_groups_spec.rb" with:
"""ruby
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
"""
|