RSpec - Metadati
RSpec è uno strumento flessibile e potente. La funzionalità dei metadati in RSpec non fa eccezione. I metadati si riferiscono generalmente a "dati sui dati". In RSpec, questo significa che i dati sul tuodescribe, context e it blocks.
Diamo un'occhiata a un esempio:
RSpec.describe "An Example Group with a metadata variable", :foo => 17 do
context 'and a context with another variable', :bar => 12 do
it 'can access the metadata variable of the outer Example Group' do |example|
expect(example.metadata[:foo]).to eq(17)
end
it 'can access the metadata variable in the context block' do |example|
expect(example.metadata[:bar]).to eq(12)
end
end
end
Quando esegui il codice sopra, vedrai questo output:
..
Finished in 0.002 seconds (files took 0.11301 seconds to load)
2 examples, 0 failures
I metadati forniscono un modo per assegnare variabili in vari ambiti all'interno dei file RSpec. La variabile example.metadata è un hash Ruby che contiene altre informazioni sui tuoi gruppi di esempi e di esempi.
Ad esempio, riscriviamo il codice sopra in questo modo:
RSpec.describe "An Example Group with a metadata variable", :foo => 17 do
context 'and a context with another variable', :bar => 12 do
it 'can access the metadata variable in the context block' do |example|
expect(example.metadata[:foo]).to eq(17)
expect(example.metadata[:bar]).to eq(12)
example.metadata.each do |k,v|
puts "#{k}: #{v}"
end
end
end
Quando eseguiamo questo codice, vediamo tutti i valori nell'hash example.metadata -
.execution_result: #<RSpec::Core::Example::ExecutionResult:0x00000002befd50>
block: #<Proc:0x00000002bf81a8@C:/rspec_tutorial/spec/metadata_spec.rb:7>
description_args: ["can access the metadata variable in the context block"]
description: can access the metadata variable in the context block
full_description: An Example Group with a metadata variable and a context
with another variable can access the metadata variable in the context block
described_class:
file_path: ./metadata_spec.rb
line_number: 7
location: ./metadata_spec.rb:7
absolute_file_path: C:/rspec_tutorial/spec/metadata_spec.rb
rerun_file_path: ./metadata_spec.rb
scoped_id: 1:1:2
foo: 17
bar: 12
example_group:
{:execution_result=>#<RSpec::Core::Example::ExecutionResult:
0x00000002bfa0e8>, :block=>#<
Proc:0x00000002bfac00@C:/rspec_tutorial/spec/metadata_spec.rb:2>,
:description_args=>["and a context with another variable"],
:description=>"and a context with another variable",
:full_description=>"An Example Group with a metadata variable
and a context with another variable", :described_class=>nil,
:file_path=>"./metadata_spec.rb",
:line_number=>2, :location=>"./metadata_spec.rb:2",
:absolute_file_path=>"C:/rspec_tutorial/spec/metadata_spec.rb",
:rerun_file_path=>"./metadata_spec.rb",
:scoped_id=>"1:1", :foo=>17, :parent_example_group=>
{:execution_result=>#<
RSpec::Core::Example::ExecutionResult:0x00000002c1f690>,
:block=>#<Proc:0x00000002baff70@C:/rspec_tutorial/spec/metadata_spec.rb:1>
, :description_args=>["An Example Group with a metadata variable"],
:description=>"An Example Group with a metadata variable",
:full_description=>"An Example Group with a metadata variable",
:described_class=>nil, :file_path=>"./metadata_spec.rb",
:line_number=>1, :location=>"./metadata_spec.rb:1",
:absolute_file_path=>
"C:/rspec_tutorial/spec/metadata_spec.rb",
:rerun_file_path=>"./metadata_spec.rb",
:scoped_id=>"1", :foo=>17},
:bar=>12}shared_group_inclusion_backtrace: []
last_run_status: unknown .
.
Finished in 0.004 seconds (files took 0.11101 seconds to load)
2 examples, 0 failures
Molto probabilmente, non sarà necessario utilizzare tutti questi metadati, ma guarda il valore della descrizione completa:
Un gruppo di esempio con una variabile di metadati e un contesto con un'altra variabile possono accedere alla variabile di metadati nel blocco di contesto.
Questa è una frase creata dalla descrizione del blocco di descrizione + la descrizione del blocco di contesto contenuto + la descrizione per il it block.
Ciò che è interessante notare qui è che queste tre stringhe insieme si leggono come una normale frase inglese. . . che è una delle idee alla base di RSpec, con test che suonano come descrizioni del comportamento in inglese.