rspec Running examples with a given tag


Example

Adding tags to "describe" or "it" blocks allows you to run only those examples with a given tag. Use the --tag (or -t) option to run examples that match a specified tag. The tag can be a simple name or a name:value pair.

  • If a simple name is supplied, only examples with :name => true will run. For example, rspec <spec_file> --tag smoke would run the example tagged with "Smoke".

    describe '#Tests' do
      it 'runs the smoke test', :smoke => true do
      end
      
      it 'runs the regression tests', :regression => true do
      end
    
      it 'runs the acceptance tests', :acceptance => true do
      end
    end
    
  • If a name:value pair is given, examples with name => value will run,where value is always a string. For example, rspec <spec_file> --tag testId:101 would run the example tagged with testId "101".

    describe '#Tests' do
      it 'runs the test with id 99', :testId => 99 do
      end
    
      it 'runs the test with id 101', :testId => 101 do
      end
    end