/usr/share/doc/ruby-rspec-core/features/hooks/when_first_matching_example_defined.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 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 | Feature: `when_first_matching_example_defined` hook
In large projects that use RSpec, it's common to have some expensive setup logic
that is only needed when certain kinds of specs have been loaded. If that kind of
spec has not been loaded, you'd prefer to avoid the cost of doing the setup.
The `when_first_matching_example_defined` hook makes it easy to conditionally
perform some logic when the first example is defined with matching metadata,
allowing you to ensure the necessary setup is performed only when needed.
Background:
Given a file named "spec/spec_helper.rb" with:
"""ruby
RSpec.configure do |config|
config.when_first_matching_example_defined(:db) do
require "support/db"
end
end
"""
And a file named "spec/support/db.rb" with:
"""ruby
RSpec.configure do |config|
config.before(:suite) do
puts "Bootstrapped the DB."
end
config.around(:example, :db) do |example|
puts "Starting a DB transaction."
example.run
puts "Rolling back a DB transaction."
end
end
"""
And a file named ".rspec" with:
"""
--require spec_helper
"""
And a file named "spec/unit_spec.rb" with:
"""
RSpec.describe "A unit spec" do
it "does not require a database" do
puts "in unit example"
end
end
"""
And a file named "spec/integration_spec.rb" with:
"""
RSpec.describe "An integration spec", :db do
it "requires a database" do
puts "in integration example"
end
end
"""
Scenario: Running the entire suite loads the DB setup
When I run `rspec`
Then it should pass with:
"""
Bootstrapped the DB.
Starting a DB transaction.
in integration example
Rolling back a DB transaction.
.in unit example
.
"""
Scenario: Running just the unit spec does not load the DB setup
When I run `rspec spec/unit_spec.rb`
Then the examples should all pass
And the output should not contain "DB"
|