Add running by tag & ignoring based on tag

Example/Tests/Features/NativeFeatures/native_example.feature

@@ -23,7 +23,7 @@ Feature: Feature file parsing
         Given I have a working Gherkin environment
         Then This test should not fail
 
-    @iOS1
+    @iOS1 @iOS6 @iOS7
     Scenario: Nested steps
         Given This step should call another step
         Then This test should not fail

Pod/Native/NativeFeature.swift

@@ -11,7 +11,7 @@ import Foundation
 class NativeFeature: CustomStringConvertible {
     let name: String
     let featureDescription: String
-    let scenarios: [NativeScenario]
+    var scenarios: [NativeScenario]
     let background: NativeBackground?
 
     required init(name: String, description: String, scenarios: [NativeScenario], background: NativeBackground?) {
@@ -62,6 +62,7 @@ extension NativeFeature {
         var background: NativeBackground?
         var featureDescription: [String]?
         var scenarioTags: [String] = []
+        var featureTags: [String] = []
 
         func saveBackgroundOrScenarioAndUpdateParseState(_ lineSuffix: String){
             let description = state.description.joined(separator: "\n")
@@ -83,10 +84,20 @@ extension NativeFeature {
 
             // Filter comments (#) and tags (@), also filter white lines
             guard line.first != "#" && !line.isEmpty else { continue }
+
+            // Adds Feature tags to each Scenario within the Feature
+            if !featureTags.isEmpty && !scenarioTags.contains(where: featureTags.contains) {
+                scenarioTags.append(contentsOf: featureTags)
+            }
+
             if line.first == "@" {
-                scenarioTags.append(String(line.dropFirst()))
+                let tags = String(line).replacingOccurrences(of: "@", with: "")
+                                       .components(separatedBy: " ")
+                                       .filter{ !$0.isEmpty }
+                scenarioTags.append(contentsOf: tags)
                 continue
             }
+
             if let (linePrefix, lineSuffix) = line.lineComponents() {
                 switch linePrefix {
                 case Language.current.keywords.Background:
@@ -107,6 +118,10 @@ extension NativeFeature {
                 case Language.current.keywords.ExampleLine:
                     state.exampleLines.append((lineIndex+1, lineSuffix))
                 case Language.current.keywords.Feature:
+                    // Gets all Feature tags
+                    if !scenarioTags.isEmpty {
+                        featureTags = scenarioTags
+                    }
                     scenarioTags = []
                 default:
                     break

Pod/Native/NativeTestCase.swift

@@ -60,7 +60,40 @@ open class NativeTestCase: XCGNativeInitializer {
             assertionFailure("Could not retrieve features from the path '\(path)'")
             return []
         }
-
+
+        var userIgnoreTags: [String] = []
+        if let userIgnoreTagsArgumentIndex = CommandLine.arguments.firstIndex(where: { $0.hasPrefix("IgnoreTags=") }) {
+            userIgnoreTags = CommandLine.arguments[userIgnoreTagsArgumentIndex].replacingOccurrences(of: "IgnoreTags=", with: "")
+                                                                                .replacingOccurrences(of: "@", with: "")
+                                                                                .components(separatedBy: ",")
+                                                                                .filter{ !$0.isEmpty }
+        }
+        userIgnoreTags.append("ignore")
+
+        var userTags: [String] = []  
+        if let userTagsArgumentIndex = CommandLine.arguments.firstIndex(where: { $0.hasPrefix("Tags=") }) {
+            userTags = CommandLine.arguments[userTagsArgumentIndex].replacingOccurrences(of: "Tags=", with: "")
+                                                                    .replacingOccurrences(of: "@", with: "")
+                                                                    .components(separatedBy: ",")
+                                                                    .filter{ !$0.isEmpty }
+        }
+
+        var remainingScenarioCount = 0
+        for feature in features {   
+            for index in (0...feature.scenarios.count-1).reversed() {
+                if  (feature.scenarios[index].tags.contains(where: userIgnoreTags.contains)) ||
+                    (!userTags.isEmpty && !feature.scenarios[index].tags.contains(where: userTags.contains)) {
+                    feature.scenarios.remove(at: index)
+                } else {
+                    remainingScenarioCount+=1
+                }
+            }
+        }
+
+        if remainingScenarioCount == 0 {
+            print("There aren't any scenarios to run. Maybe you need to check the tags you're using?")
+        }
+
         return features
     }
 

README.md

@@ -326,6 +326,26 @@ There is an example of this in the Example/ project as part of this pod. Look at
 
 The advantages of this are obvious; you get to quickly run your existing feature files and can get up and running quickly. The disadvanages are beacuse the tests are generated at runtime they can't be run individually from inside Xcode so debugging is tricker. I would use this to start testing inside Xcode but if it gets hairy, convert that feature file into a native Swift test and debug from there.
 
+### Running using tags
+
+You can use tags to run or ignore a subsection of your tests. These can be at Feature level, or on individual Scenarios. Tags must start with "@" and must not contain any spaces.
+
+For Feature level tags, ensure these are before your Feature name declaration in your feature file.
+For Scenario level tags, ensure these are before your Scenario name declaration in your feature file.
+There can be multiple on a single line, or individual tags on individual lines.
+
+To run using the tags:
+#### CLI:
+For tag ignoring, append `-IgnoreTags=@tagName1,@tagName2` to your CLI command, swapping out @tagName1/2 for your tag names.
+For tag inclusion, append `-Tags=@tagName1,@tagName2` to your CLI command, swapping out @tagName1/2 for your tag names.
+
+#### Test Plan:
+Within Xcode
+1. Go to edit your test plan
+1. Select the 'Configurations' tab
+1. Open the 'Arguments' section
+1. For the 'Arguments Passed On Launch' field, enter the value 'Tags=@tagName1,@tagName2', replacing '@tagName1,@tagName2' with your tag names, or '-IgnoreTags=@tagName1,@tagName2' for tag ignoring
+1. Now run your tests in the UI using your Test Plan
 
 ### Localisation of feature files