NSBelfast: Kiwi and KIF

Maurice Kelly presents two popular test frameworks that serve as alternatives to Apple's XCUnit. As part of his role in ShopKeep, Maurice uses the frameworks extensively and shows how they can enhance your code quality.

Transcript

1. Kiwi and KIF Maurice Kelly (@mauricerkelly) Senior iOS Engineer at
2. Unit Testing
3. Why Use Unit Tests? • Test components in isolation • Detect regressions • Drive your Development
4. TDD Red Green Refactor Smug Smug Re-smug
5. Existing Options • OCUnit (SenTest) • XCTest
6. BDD and Specs Given a system state When an action is taken Then a result occurs Given a system state When a second action is taken Then a second result occurs
7. BDD and Specs Setup a system state Given the system When an action is taken Then a result occurs Given the same system When a second action is taken Then a second result occurs
8. BDD and Specs Setup a system state Given the system When an action is taken Then a result occurs Given the same system When a second action is taken Then a second result occurs Given the same system With a subtle adjustment When a third action is taken Then a third result occurs
9. BDD and Specs • context - defines the state of the system • describe - defines the actions being taken • it - defines the results that should occur
10. BDD and Specs context - a system state describe - an action is taken it - causes a result to occur describe - a second action is taken it - causes a second result to occur context - the system is adjusted describe - a third action is taken it - causes a third result to occur
11. Kiwi
12. context, describe and it blocks context(@"When the system has a state", ^{ /*your context*/ }); describe(@"an action is taken", ^{ /* your actions*/ }); it(@"causes a result to occur", ^{ /*your expectations */ });
13. context, describe and it blocks context(@"When the system has a state", ^{ describe(@"an action is taken", ^{ it(@"causes a result to occur", ^{ }); }); describe(@"a second action is taken", ^{ it(@"causes a second result", ^{ }); }); context(@"and the system is adjusted", ^{ describe(@"a third action is taken", ^{ it(@"causes a third result", ^{ }); }); }); });
14. Expectations and Matchers • With this data NSNumber numericalYes = @YES; NSNumber numericalNo = @NO; • In XCTest: XCTAssertEqualObjects(numericalYes, numericalYes); • In Kiwi: [numericalYes should] equal:numericalNo];
15. Expectations • should • shouldNot • shouldEventually
16. Matchers • equal: • beNil: • beLessThan:
 beLessThanOrEqualTo: • beGreaterThan:
 beGreaterThanOrEqualTo: • beYes • beNo • containString: • matchPattern: • beEmpty: • contain:
17. Mocks and Stubs • Mocks • Can mock both classes and protocols • Null mocks can receive any message without complaining • Plain mocks throw exceptions when receiving a message that isn't stubbed • Stubs • Adds ability to receive and handle specific messages • Can parse the message parameters • Can return values
18. before and after +setUp -setUp -tearDown +tearDown beforeAll beforeEach afterEach afterAll 㱺
19. before and after context(@"When the numberOne is set to YES", ^{ __block NSNumber *numberOne; __block NSNumber *numberTwo; beforeEach(^{ numberOne = @YES; numberTwo = @NO; }); describe(@"and no change is made", ^{ it(@"should not equal the numberTwo", ^{ [[numberOne shouldNot] equal:numberTwo]; }); }); describe(@"and numberTwo is changed to YES", ^{ beforeEach(^{ numberTwo = @YES; }); it(@"should equal the numberTwo", ^{ [[numberOne should] equal:numberTwo]; }); }); });
20. How To Use Kiwi • Install your pods • Create a Podfile platform :ios, ‘8.1' target :KiwiAndKifTests, :exclusive => true do pod 'Kiwi' end $ pod install
21. How To Use Kiwi #import <Kiwi/Kiwi.h> SPEC_BEGIN(FeltSpec) context(@"When the system has a specific state", ^{ describe(@"an action is taken", ^{ it(@"causes a result to occur", ^{ }); }); }); SPEC_END • Create a test class and enter a spec
22. How To Use Kiwi • Run your tests as normal
23. How Does It Work? MACROS
24. AppCode Support
25. KIF (Keep It Functional)
26. DEMO
27. How Does It Do It’s Magic UITouch UIEvent CGPoint KIF App Logic UIApplication APP
28. How Does It Do It’s Magic UIAccessibilityElement UIView Accessibility Label KIF CGPoint
29. Actors tapViewWithAccessibilityLabel: tapViewWithAccessibilityLabel:
 traits: tapViewWithAccessibilityLabel:
 value:
 traits:
30. Inspect Views waitForViewWithAccessibilityLabel: waitForViewWithAccessibilityLabel:
 traits: waitForViewWithAccessibilityLabel:
 value:
 traits:
31. Inter- acting Entering text enterTextIntoCurrentFirstResponder: enterText:intoViewWithAccessibilityLabel: clearTextFromViewWithAccessibilityLabel: clearTextFromAndThenEnterText:intoViewWith AccessibilityLabel: Scrolling scrollViewWithAccessibilityIdentifier: byFractionOfSizeHorizontal:vertical: Swiping swipeViewWithAccessibilityLabel: inDirection:
32. Inter- acting Long press longPressViewWithAccessibilityLabel:
 duration: Interact with UI elements setOn:forSwitchWithAccessibilityLabel: setValue:forSliderWithAccessibilityLabel: selectPickerViewRowWithTitle: selectDatePickerValue:
33. How To Use KIF • Install your pods • Create a Podfile platform :ios, '8.1' target :KiwiAndKifTests, :exclusive => true do pod 'Kiwi' pod 'KIF' pod ‘KIF-Kiwi’ end $ pod install
34. How To Use KIF #import <Kiwi/Kiwi.h> #import <KIF-Kiwi.h> SPEC_BEGIN(KifSpec) context(@"When the app is launched", ^{ it(@"displays a welcome message", ^{ [tester waitForViewWithAccessibilityLabel:@"Welcome to Kiwi and KIF"]; }); it(@"shows a switcheroo button", ^{ [tester waitForViewWithAccessibilityLabel:@"Switcheroo" traits:UIAccessibilityTraitButton]; }); describe(@"the button is pressed", ^{ beforeEach(^{ [tester tapViewWithAccessibilityLabel:@"Switcheroo" traits:UIAccessibilityTraitButton]; }); it(@"updates the welcome label", ^{ [tester waitForViewWithAccessibilityLabel:@"Or is it KIF and Kiwi?"]; }); }); }); SPEC_END
35. How To Use Kiwi
36. A WWDC Tale •
37. References
38. References • Kiwi • KIF Framework