xcfit 0.2.0

data/XCFitDemo/XCFitDemo.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:XCFitDemo.xcodeproj">
+   </FileRef>
+</Workspace>

data/XCFitDemo/XCFitDemo.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "group:XCFitDemo.xcodeproj">
+   </FileRef>
+   <FileRef
+      location = "group:Pods/Pods.xcodeproj">
+   </FileRef>
+</Workspace>

data/XCFitDemo/XCFitDemo/AppDelegate.swift

@@ -0,0 +1,46 @@
+//
+//  AppDelegate.swift
+//  XCFitDemo
+//
+//  Created by Shashikant Jagtap on 15/07/2016.
+//  Copyright © 2016 Shashikant Jagtap. All rights reserved.
+//
+
+import UIKit
+
+@UIApplicationMain
+class AppDelegate: UIResponder, UIApplicationDelegate {
+
+    var window: UIWindow?
+
+
+    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
+        // Override point for customization after application launch.
+        return true
+    }
+
+    func applicationWillResignActive(application: UIApplication) {
+        // Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
+        // Use this method to pause ongoing tasks, disable timers, and throttle down OpenGL ES frame rates. Games should use this method to pause the game.
+    }
+
+    func applicationDidEnterBackground(application: UIApplication) {
+        // Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
+        // If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
+    }
+
+    func applicationWillEnterForeground(application: UIApplication) {
+        // Called as part of the transition from the background to the inactive state; here you can undo many of the changes made on entering the background.
+    }
+
+    func applicationDidBecomeActive(application: UIApplication) {
+        // Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
+    }
+
+    func applicationWillTerminate(application: UIApplication) {
+        // Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
+    }
+
+
+}
+

data/XCFitDemo/XCFitDemo/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -0,0 +1,38 @@
+{
+  "images" : [
+    {
+      "idiom" : "iphone",
+      "size" : "29x29",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "iphone",
+      "size" : "29x29",
+      "scale" : "3x"
+    },
+    {
+      "idiom" : "iphone",
+      "size" : "40x40",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "iphone",
+      "size" : "40x40",
+      "scale" : "3x"
+    },
+    {
+      "idiom" : "iphone",
+      "size" : "60x60",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "iphone",
+      "size" : "60x60",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}

data/XCFitDemo/XCFitDemo/Base.lproj/LaunchScreen.storyboard

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="8150" systemVersion="15A204g" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" initialViewController="01J-lp-oVM">
+    <dependencies>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="8122"/>
+    </dependencies>
+    <scenes>
+        <!--View Controller-->
+        <scene sceneID="EHf-IW-A2E">
+            <objects>
+                <viewController id="01J-lp-oVM" sceneMemberID="viewController">
+                    <layoutGuides>
+                        <viewControllerLayoutGuide type="top" id="Llm-lL-Icb"/>
+                        <viewControllerLayoutGuide type="bottom" id="xb3-aO-Qok"/>
+                    </layoutGuides>
+                    <view key="view" contentMode="scaleToFill" id="Ze5-6b-2t3">
+                        <rect key="frame" x="0.0" y="0.0" width="600" height="600"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <animations/>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
+                    </view>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="53" y="375"/>
+        </scene>
+    </scenes>
+</document>

data/XCFitDemo/XCFitDemo/Base.lproj/Main.storyboard

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="9531" systemVersion="15C50" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" initialViewController="BYZ-38-t0r">
+    <dependencies>
+        <deployment identifier="iOS"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="9529"/>
+    </dependencies>
+    <scenes>
+        <!--View Controller-->
+        <scene sceneID="tne-QT-ifu">
+            <objects>
+                <viewController id="BYZ-38-t0r" customClass="ViewController" customModule="XCFitDemo" customModuleProvider="target" sceneMemberID="viewController">
+                    <layoutGuides>
+                        <viewControllerLayoutGuide type="top" id="y3c-jy-aDJ"/>
+                        <viewControllerLayoutGuide type="bottom" id="wfy-db-euE"/>
+                    </layoutGuides>
+                    <view key="view" contentMode="scaleToFill" id="8bC-Xf-vdC">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <button opaque="NO" contentMode="scaleToFill" fixedFrame="YES" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="oNT-1R-4qm">
+                                <rect key="frame" x="146" y="123" width="46" height="30"/>
+                                <accessibility key="accessibilityConfiguration" identifier="ClickMe" label="ClickMe"/>
+                                <state key="normal" title="ClickMe"/>
+                                <connections>
+                                    <action selector="ClickMe:" destination="BYZ-38-t0r" eventType="touchUpInside" id="EFe-RT-V96"/>
+                                </connections>
+                            </button>
+                            <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" fixedFrame="YES" text="Label" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="ZlX-tN-MM1">
+                                <rect key="frame" x="148" y="231" width="42" height="21"/>
+                                <accessibility key="accessibilityConfiguration" identifier="WelCome" label="WelCome"/>
+                                <fontDescription key="fontDescription" type="system" pointSize="17"/>
+                                <color key="textColor" cocoaTouchSystemColor="darkTextColor"/>
+                                <nil key="highlightedColor"/>
+                            </label>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
+                    </view>
+                    <simulatedScreenMetrics key="simulatedDestinationMetrics" type="retina47"/>
+                    <connections>
+                        <outlet property="Hello" destination="ZlX-tN-MM1" id="PX0-3K-aog"/>
+                    </connections>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
+            </objects>
+        </scene>
+    </scenes>
+</document>

data/XCFitDemo/XCFitDemo/Info.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+	<key>LSRequiresIPhoneOS</key>
+	<true/>
+	<key>UILaunchStoryboardName</key>
+	<string>LaunchScreen</string>
+	<key>UIMainStoryboardFile</key>
+	<string>Main</string>
+	<key>UIRequiredDeviceCapabilities</key>
+	<array>
+		<string>armv7</string>
+	</array>
+	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+</dict>
+</plist>

data/XCFitDemo/XCFitDemo/ViewController.swift

@@ -0,0 +1,33 @@
+//
+//  ViewController.swift
+//  XCFitDemo
+//
+//  Created by Shashikant Jagtap on 15/07/2016.
+//  Copyright © 2016 Shashikant Jagtap. All rights reserved.
+//
+
+import UIKit
+
+class ViewController: UIViewController {
+
+    @IBOutlet weak var Hello: UILabel!
+    @IBAction func ClickMe(sender: AnyObject) {
+        
+        
+        Hello.text = "WelCome"
+        
+        
+    }
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        
+    }
+
+    override func didReceiveMemoryWarning() {
+        super.didReceiveMemoryWarning()
+        // Dispose of any resources that can be recreated.
+    }
+
+
+}
+

data/XCFitDemo/XCFitDemoCucumberishTests/Cucumberish/Core/CCIBlockDefinitions.h

@@ -0,0 +1,393 @@
+//
+//  CCIBlockDefinitions.h
+//  Pods
+//
+//  Created by Ahmed Ali on 23/01/16.
+//
+//
+
+#import <Foundation/Foundation.h>
+@class CCIScenarioDefinition;
+
+#pragma mark - Block types
+/**
+ You pass this block when ever you define an implementation for a step.
+ 
+ @param args strings array which corresponds to your regular express capturing groups.
+ @param userInfo is a dictionary that currently can only have one of two keys "DataTable" and "DocString". If your step definition is expected to match a data table or a doc string, then you can expect this user info to contain DataTable or DocString key respectively.
+ */
+typedef void(^CCIStepBody)(NSArray <NSString *>* args, NSDictionary * userInfo);
+
+/**
+ This block is passed to all the hocks (except around hock).
+ @param scenario the scenario the current scenario
+ */
+typedef void (^CCIScenarioHockBlock)(CCIScenarioDefinition * scenario);
+
+/**
+ This block is passed to around hocks.
+ @param scenario the scenario the current scenario.
+ @param scenarioExectionBlock the block that will execute the scenario. If you did not call it, the scenario will never bee executed.
+ */
+typedef void (^CCIScenarioExecutionHockBlock)(CCIScenarioDefinition * scenario, void (^scenarioExectionBlock)(void) );
+
+
+#pragma mark - Step definitions and prepositions
+
+@class CCIStep;
+@class CCIStepDefinition;
+
+/**
+ Defines a Given implementations.
+ 
+ @code
+ Given(@"the app is running" ,  ^void(NSArray *args, id userInfo) {
+     //Your step implementation goes here
+     //The definition string in this case will match only the following step
+     //Given the app is running
+ });
+ @endcode
+ 
+ @Note
+ Step definitions are checked in a "Last In First Out" order. If it happens that there are more than one definition matches a step, the last registered definition will be used.
+ 
+ @param definitionString the regular expression that will checked against each Given step line.
+ @param body the code block that will be executed if match is occured.
+ */
+OBJC_EXTERN void Given(NSString * definitionString, CCIStepBody body);
+
+/**
+ Defines a When step implementations.
+ 
+ @b Example:
+ @code
+ When(@"^I tap (?:the )?\"([^\\\"]*)\" (?:button|view|label)$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+     //The definition string in this case can match all the following steps
+     //When I tap the "MyButton" button
+     //When I tap "MyButton" button
+     //When I tap "Header" view
+     //When I tap "FAQ" label
+ });
+ @endcode
+ 
+ @Note
+ Step definitions are checked in a "Last In First Out" order. If it happens that there are more than one definition matches a step, the last registered definition will be used.
+ 
+ @param definitionString the regular expression that will checked against each Given step line.
+ @param body the code block that will be executed if match is occured.
+ */
+OBJC_EXTERN void When(NSString * definitionString, CCIStepBody body);
+
+/**
+ Defines a Then step implementations.
+ 
+ @b Example:
+ @code
+ Then(@"^I should see \"([^\\\"]*)\" in (?:the )?\"([^\\\"]*)\" (?:button|view|label)$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+     //The definition string in this case can match all the following steps
+     //Then I should see "Button Title" in "MyButton" button
+     //Then I should see "Button Title" in the "MyButton" Button
+     //Then I should see "The Screen Title" in "Header" view
+     //Then I should see "FAQ" in "FAQ" label
+ });
+ @endcode
+ 
+ @Note
+ Step definitions are checked in a "Last In First Out" order. If it happens that there are more than one definition matches a step, the last registered definition will be used.
+ 
+ @param definitionString the regular expression that will checked against each Given step line.
+ @param body the code block that will be executed if match is occured.
+ */
+OBJC_EXTERN void Then(NSString * definitionString, CCIStepBody body);
+
+/**
+ Defines an And step implementations.
+ 
+ @b Example:
+ @code
+ And(@"^I should see \"([^\\\"]*)\" in (?:the )?\"([^\\\"]*)\" (?:button|view|label)$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+     //The definition string in this case can match all the following steps
+     //And I should see "Button Title" in "MyButton" button
+     //And I should see "Button Title" in the "MyButton" Button
+     //And I should see "The Screen Title" in "Header" view
+     //And I should see "FAQ" in "FAQ" label
+ });
+ @endcode
+ 
+ @Note
+ Step definitions are checked in a "Last In First Out" order. If it happens that there are more than one definition matches a step, the last registered definition will be used.
+ 
+ @param definitionString the regular expression that will checked against each Given step line.
+ @param body the code block that will be executed if match is occured.
+ */
+OBJC_EXTERN void And(NSString * definitionString, CCIStepBody body);
+
+/**
+ Defines a But step implementations.
+ 
+ @code
+ But(@"^I should see \"([^\\\"]*)\" in (?:the )?\"([^\\\"]*)\" (?:button|view|label)$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+     //The definition string in this case can match all the following steps
+     //But I should see "Button Title" in "MyButton" button
+     //But I should see "Button Title" in the "MyButton" Button
+     //But I should see "The Screen Title" in "Header" view
+     //But I should see "FAQ" in "FAQ" label
+ });
+ @endcode
+ 
+ @Note
+ Step definitions are checked in a "Last In First Out" order. If it happens that there are more than one definition matches a step, the last registered definition will be used.
+ 
+ @param definitionString the regular expression that will checked against each Given step line.
+ @param body the code block that will be executed if match is occured.
+ */
+OBJC_EXTERN void But(NSString * definitionString, CCIStepBody body);
+
+/**
+ Defines a step implementations that will be registered with When, Then, And, and But.
+ The implementation of this function simply calls:
+ @code
+ When(definitionString, body);
+ Then(definitionString, body);
+ And(definitionString, body);
+ But(definitionString, body);
+ @endcode
+ Which concluds that the registered definitions will be checked with any of these four prepositions.
+ 
+ @b Example:
+ @code
+ MatchAll(@"^I should see \"([^\\\"]*)\" in (?:the )?\"([^\\\"]*)\" (?:button|view|label)$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+     //The definition string in this case can match all the following steps
+     //When I should see "Button Title" in "MyButton" button
+     //Then I should see "Button Title" in "MyButton" button
+     //And I should see "Button Title" in "MyButton" button
+     //But I should see "Button Title" in "MyButton" button
+ });
+ @endcode
+ 
+ @Note
+ Step definitions are checked in a "Last In First Out" order. If it happens that there are more than one definition matches a step, the last registered definition will be used.
+ 
+ @param definitionString the regular expression that will checked against each Given step line.
+ @param body the code block that will be executed if match is occured.
+ */
+OBJC_EXTERN void MatchAll(NSString * definitionString, CCIStepBody body);
+
+/**
+ Defines a step implementations that will be registered with specified prepositions.
+ 
+ @b Example:
+ @code
+ Match(@[@"When", @"And", @"Then"], @"^I should see \"([^\\\"]*)\" in (?:the )?\"([^\\\"]*)\" (?:button|view|label)$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+     //The definition string in this case can match all the following steps
+     //When I should see "Button Title" in "MyButton" button
+     //And I should see "Button Title" in "MyButton" button
+     //Then I should see "Button Title" in "MyButton" button
+ });
+ @endcode
+ 
+ @Note
+ Step definitions are checked in a "Last In First Out" order. If it happens that there are more than one definition matches a step, the last registered definition will be used.
+ 
+ @param prepositions array of strings to be used as the preposition of the step definiton
+ @param definitionString the regular expression that will checked against each Given step line.
+ @param body the code block that will be executed if match is occured.
+ */
+OBJC_EXTERN void Match(NSArray *prepositions, NSString * definitionString, CCIStepBody body);
+
+/**
+ Step implementation can be also a useable code.
+ If it the case that you want to call a previously defined step implementation, you can call this definition using this special step function.
+ 
+ @Note
+ Using this function, you do not need to worry about the preposition of the step; you just pass in the step line without defining the preposition.
+ 
+ @b Example:
+ @code
+     //The first step definiton
+ Match(@[@"When", @"And", @"Then"], @"^I should see \"([^\\\"]*)\" in (?:the )?\"([^\\\"]*)\" (?:button|view|label)$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+ });
+ 
+     //The another step definiton that will make use of the previousely defined step
+ When(@"^I write \"([^\\\"]*)\" (?:in|into) \"([^\\\"]*)\" field$" ,  ^void(NSArray *args, id userInfo) {
+     //Step implementation goes here
+     //Here you can call the previously defined step.
+ step(@"I should see \"%@\" in the \"%@\" label", args[0], args[1]);
+ });
+ @endcode
+ 
+ @param stepLine the step line string to be executed
+ */
+OBJC_EXPORT void step(NSString * stepLine, ...);
+
+/**
+ Swift alias for step(stepLine) function.
+ */
+OBJC_EXTERN void SStep(NSString * stepLine);
+
+
+#pragma mark - Hocks
+/**
+ C function that registers a code block to be called only once before executing any test case.
+ You can call this function as much as you want, but only the last registerd code block will be used.
+ 
+ @Note
+ This function should not be called after calling @a beginExecution.
+ 
+ @param beforeStartBlock code block that will be executed once before any test cases.
+ */
+OBJC_EXTERN void beforeStart(void(^beforeStartBlock)(void));
+
+
+/**
+ C function that registers a code block to be called only once after executing all test cases.
+ You can call this function as much as you want, but only the last registerd code block will be used.
+ 
+ @Note
+ This function should not be called after calling @a beginExecution.
+ 
+ @param afterFinishBlock code block that will be executed once after all test cases finish execution.
+ */
+OBJC_EXTERN void afterFinish(void(^afterFinishBlock)(void));
+
+
+/**
+ C function that registers a code block to be called before each scenario.
+ Code blocks registerd with this function will run before each scenario in the same order they were orignally registered; that's it, FIFO (First In First Out).
+ 
+ @Note
+ This function should not be called after calling @a beginExecution.
+ 
+ @param beforeEachBlock code block that will be executed before executing the scenario, this block receives an instance of the scenario that will be executed.
+ */
+OBJC_EXTERN void before(CCIScenarioHockBlock beforeEachBlock);
+
+
+/**
+ C function that registers a code block to be called after each scenario.
+ Code blocks registerd with this function will run after each scenario in reversed order compared to the order they were orignally registered; that's it, LIFO (Last In First Out)
+ 
+ @Note
+ All code blocks registerd with this function, will run regardless the scenario has been passed or not
+ 
+ @Note
+ This function should not be called after calling @a beginExecution.
+ 
+ @param afterEachBlock code block that will be executed after executing the scenario, this block receives an instance of the scenario that has been executed.
+ */
+OBJC_EXTERN void after(CCIScenarioHockBlock afterEachBlock);
+
+
+/**
+ C function that registers a code block to be called before each scenario that has one or more tag that matches one or more tags passed to this function.
+ Code blocks registerd with this function will run before each matching scenario in the same order they were orignally registered; that's it, FIFO (First In First Out)
+ 
+ @Note
+ Do not prefix any tag you pass with @ symbol
+ 
+ @Note
+ This function should not be called after calling @a beginExecution.
+ 
+ @param tags array of strings that will be used to match specific scenarios
+ @param beforeTaggedBlock code block that will be executed before executing the scenario, this block receives an instance of the scenario that will be executed.
+ */
+OBJC_EXTERN void beforeTagged(NSArray * tags, CCIScenarioHockBlock beforeTaggedBlock);
+
+
+/**
+ C function that registers a code block to be called after each scenario that has one or more tag that matches one or more tags passed to this function.
+ Code blocks registerd with this function will run after each matching scenario in reversed order compared to the order they were orignally registered; that's it, LIFO (Last In First Out)
+ 
+ @Note
+ This function should not be called after calling @a beginExecution.
+ 
+ @Note
+ All code blocks registerd with this function, will run regardless the matching scenario has been passed or not
+ 
+ @Note
+ Do not prefix any tag you pass with @ symbol
+ 
+ @param tags array of strings that will be used to match specific scenarios
+ @param afterTaggedBlock code block that will be executed after executing the scenario, this block receives an instance of the scenario that has been executed.
+ */
+OBJC_EXTERN void afterTagged(NSArray * tags, CCIScenarioHockBlock afterTaggedBlock);
+
+
+/**
+ C function that registers a code block to be used to call the scenario execution block.
+ Code blocks registerd with this function will receive two parameters: scenario instance and scenario execution block as a parameter.
+ 
+ If more than one code block matches the scenario, you are still required to call the scenario execution from each registered code block. However, your scenario will be executed once as it is supposed to be.
+ 
+ Matching against around blocks happens in FIFO (First In First Out) order; in case more than one block has matched the same scenario, then they are nested.
+ 
+ @Note
+ Failing to call the scenario execution block, will prevent the scenario from being executed.
+ 
+ @b Example of more than one match
+ 
+ There are three registerd blocks with tags that matches the same scenario, the followin nesting calls will happen:
+ 
+ @code
+ Third Around Match
+ Block = contains code block that executes the Second Around Match
+ Second Around Match
+ Block = contains code block that executes the First Around Match
+ First Around Match
+ Block = A call Scenario Exection Block@endcode
+ 
+ 
+ @Note
+ Do not prefix any tag you pass with @@ symbol
+ 
+ @Note
+ This function should not be called after calling @a beginExecution.
+ 
+ 
+ @param tags array of strings that will be used to match specific scenarios
+ @param aroundScenarioBlock code block that will be executed for each scneario, this block receives an instance of the scenario and the scenario execution block.
+ */
+OBJC_EXTERN void around(NSArray * tags, CCIScenarioExecutionHockBlock aroundScenarioBlock);
+
+#pragma mark - Assertion and Errors
+/**
+ Boolean assertion function. Use it where you usually use NSAssert or assert.
+ 
+ Using this assertion function in your step implementations, guarantees proper error reporting
+ 
+ @param expression boolean expression
+ @param failureMessage formatted a string describe what went wrong in case expression is evaluated to false
+ */
+OBJC_EXTERN void CCIAssert(BOOL expression, NSString * failureMessage, ...);
+
+/**
+ Swift alias for CCIAssert
+ @param expression boolean expression
+ @param failureMessage a string describe what went wrong in case expression is evaluated to false
+ */
+OBJC_EXTERN void CCISAssert(BOOL expression, NSString * failureMessage);
+
+
+/**
+ Throws an exception with the specified reason.
+ Cucumberish will handle this exception and show it as an issue with executing the current step
+ 
+ @param reason the failure reason
+ */
+
+OBJC_EXTERN void throwCucumberishException(NSString *reason, ...);
+
+
+/**
+ Swift alias for throwCucumberishException;
+ @param reason the failure reason
+ */
+OBJC_EXTERN void SThrowCucumberishException(NSString *reason);
+