Bdd for ios with kiwi
0 likes2,482 views
Kiwi is a BDD testing library for iOS that is similar to RSpec. It provides a nicer structure and better assertions than the built-in OCUnit framework. Kiwi builds on top of OCUnit and integrates tightly with Xcode. It can be easily installed with CocoaPods and provides macros and methods for setting up describe, context, before/after hooks, and expectations in a readable manner.
![Why BDD? Why Kiwi?
TDD - OCUnit : BDD - Kiwi :
@implementation testTests
describe(@"Team", ^{
context(@"when newly created", ^{
- (void)testThatTeamShouldHaveName
it(@"should have a name", ^{
{
id team = [Team team];
id team = [Team team];
[[team.name should] equal:@"Black Hawks"];
STAssertEqualObjects(team.name, @"Black
});
Hawks", @"Team shuld have a name");
});
});
}
1. Design 1. Nice structure
+
2. Test Logic 2. Better Assertions](https://image.slidesharecdn.com/bddforioswithkiwi-130321102621-phpapp01/85/Bdd-for-ios-with-kiwi-3-320.jpg)
![Basic usage
• SPEC_BEGIN(ClassName) and SPEC_END -
SPEC_BEGIN(SpecName)
macros that expand to begin and end a KWSpec class
describe(@"ClassName", ^{ and group declaration.
context(@"a state the component is in", ^{
__block id variable = nil;
beforeAll(^{ // Occurs once
});
afterAll(^{ // Occurs once
});
beforeEach(^{ // Occurs before each enclosed "it"
variable = [MyClass instance];
});
afterEach(^{ // Occurs after each enclosed "it"
});
it(@"should do something", ^{
[[variable should] meetSomeExpectation];
});
context(@"inner context", ^{
xit(@"does another thing", ^{
});
pending(@"something unimplemented", ^{
});
})
});
});
SPEC_END](https://image.slidesharecdn.com/bddforioswithkiwi-130321102621-phpapp01/85/Bdd-for-ios-with-kiwi-5-320.jpg)
![Basic usage
• SPEC_BEGIN(ClassName) and SPEC_END -
SPEC_BEGIN(SpecName)
macros that expand to begin and end a KWSpec class
describe(@"ClassName", ^{ and group declaration.
context(@"a state the component is in", ^{ • describe(aString, aBlock) - starts a context that can
__block id variable = nil; contain tests and nested contexts.
beforeAll(^{ // Occurs once
}); • context(aString, aBlock) - synonym for describe.
afterAll(^{ // Occurs once
});
beforeEach(^{ // Occurs before each enclosed "it"
variable = [MyClass instance];
});
afterEach(^{ // Occurs after each enclosed "it"
});
it(@"should do something", ^{
[[variable should] meetSomeExpectation];
});
context(@"inner context", ^{
xit(@"does another thing", ^{
});
pending(@"something unimplemented", ^{
});
})
});
});
SPEC_END](https://image.slidesharecdn.com/bddforioswithkiwi-130321102621-phpapp01/85/Bdd-for-ios-with-kiwi-6-320.jpg)
![Basic usage
• SPEC_BEGIN(ClassName) and SPEC_END -
SPEC_BEGIN(SpecName)
macros that expand to begin and end a KWSpec class
describe(@"ClassName", ^{ and group declaration.
context(@"a state the component is in", ^{ • describe(aString, aBlock) - starts a context that can
__block id variable = nil; contain tests and nested contexts.
beforeAll(^{ // Occurs once
}); • context(aString, aBlock) - synonym for describe.
afterAll(^{ // Occurs once
}); • beforeAll(aBlock), afterAll(aBlock) - run once
beforeEach(^{ // Occurs before each enclosed "it"
before and after all the inner contexts and it blocks of
variable = [MyClass instance]; the context it is in.
});
afterEach(^{ // Occurs after each enclosed "it" • beforeEach(aBlock), afterEach(aBlock) - run before
}); and after every it block in all enclosed contexts.
it(@"should do something", ^{
[[variable should] meetSomeExpectation]; • it(aString, aBlock) - This is where actual actual
});
expectations on objects should go
context(@"inner context", ^{
xit(@"does another thing", ^{
});
pending(@"something unimplemented", ^{
});
})
});
});
SPEC_END](https://image.slidesharecdn.com/bddforioswithkiwi-130321102621-phpapp01/85/Bdd-for-ios-with-kiwi-7-320.jpg)
![Basic usage
• SPEC_BEGIN(ClassName) and SPEC_END -
SPEC_BEGIN(SpecName)
macros that expand to begin and end a KWSpec class
describe(@"ClassName", ^{ and group declaration.
context(@"a state the component is in", ^{ • describe(aString, aBlock) - starts a context that can
__block id variable = nil; contain tests and nested contexts.
beforeAll(^{ // Occurs once
}); • context(aString, aBlock) - synonym for describe.
afterAll(^{ // Occurs once
}); • beforeAll(aBlock), afterAll(aBlock) - run once
beforeEach(^{ // Occurs before each enclosed "it"
before and after all the inner contexts and it blocks of
variable = [MyClass instance]; the context it is in.
});
afterEach(^{ // Occurs after each enclosed "it" • beforeEach(aBlock), afterEach(aBlock) - run before
}); and after every it block in all enclosed contexts.
it(@"should do something", ^{
[[variable should] meetSomeExpectation]; • it(aString, aBlock) - This is where actual actual
});
expectations on objects should go
context(@"inner context", ^{
xit(@"does another thing", ^{
});
• pending(aString, aBlock), xit(aString, aBlock) -
doesn't do anything other than log a pending message
pending(@"something unimplemented", ^{ to the output when run.
});
})
});
});
SPEC_END](https://image.slidesharecdn.com/bddforioswithkiwi-130321102621-phpapp01/85/Bdd-for-ios-with-kiwi-8-320.jpg)
Bdd for ios with kiwi
- 1. BDD for iOS with Kiwi Oleksandr Gnatyshyn
- 2. Why BDD? Why Kiwi? Kiwi is BDD library for iOS, «RSpec» like, easy to setup and use. Kiwi Kiwi built on top of OCUnit and tightly integrated with Xcode! OCUnit
- 3. Why BDD? Why Kiwi? TDD - OCUnit : BDD - Kiwi : @implementation testTests describe(@"Team", ^{ context(@"when newly created", ^{ - (void)testThatTeamShouldHaveName it(@"should have a name", ^{ { id team = [Team team]; id team = [Team team]; [[team.name should] equal:@"Black Hawks"]; STAssertEqualObjects(team.name, @"Black }); Hawks", @"Team shuld have a name"); }); }); } 1. Design 1. Nice structure + 2. Test Logic 2. Better Assertions
- 4. Kiwi installation • Old School way - https://github.com/allending/Kiwi/wiki/Guide:-Up-and-Running-with-Kiwi • Easy way - CocoaPods!! //Podfile platform :ios target :KiwiUnitTest, :exclusive => true do pod 'Kiwi' end
- 5. Basic usage • SPEC_BEGIN(ClassName) and SPEC_END - SPEC_BEGIN(SpecName) macros that expand to begin and end a KWSpec class describe(@"ClassName", ^{ and group declaration. context(@"a state the component is in", ^{ __block id variable = nil; beforeAll(^{ // Occurs once }); afterAll(^{ // Occurs once }); beforeEach(^{ // Occurs before each enclosed "it" variable = [MyClass instance]; }); afterEach(^{ // Occurs after each enclosed "it" }); it(@"should do something", ^{ [[variable should] meetSomeExpectation]; }); context(@"inner context", ^{ xit(@"does another thing", ^{ }); pending(@"something unimplemented", ^{ }); }) }); }); SPEC_END
- 6. Basic usage • SPEC_BEGIN(ClassName) and SPEC_END - SPEC_BEGIN(SpecName) macros that expand to begin and end a KWSpec class describe(@"ClassName", ^{ and group declaration. context(@"a state the component is in", ^{ • describe(aString, aBlock) - starts a context that can __block id variable = nil; contain tests and nested contexts. beforeAll(^{ // Occurs once }); • context(aString, aBlock) - synonym for describe. afterAll(^{ // Occurs once }); beforeEach(^{ // Occurs before each enclosed "it" variable = [MyClass instance]; }); afterEach(^{ // Occurs after each enclosed "it" }); it(@"should do something", ^{ [[variable should] meetSomeExpectation]; }); context(@"inner context", ^{ xit(@"does another thing", ^{ }); pending(@"something unimplemented", ^{ }); }) }); }); SPEC_END
- 7. Basic usage • SPEC_BEGIN(ClassName) and SPEC_END - SPEC_BEGIN(SpecName) macros that expand to begin and end a KWSpec class describe(@"ClassName", ^{ and group declaration. context(@"a state the component is in", ^{ • describe(aString, aBlock) - starts a context that can __block id variable = nil; contain tests and nested contexts. beforeAll(^{ // Occurs once }); • context(aString, aBlock) - synonym for describe. afterAll(^{ // Occurs once }); • beforeAll(aBlock), afterAll(aBlock) - run once beforeEach(^{ // Occurs before each enclosed "it" before and after all the inner contexts and it blocks of variable = [MyClass instance]; the context it is in. }); afterEach(^{ // Occurs after each enclosed "it" • beforeEach(aBlock), afterEach(aBlock) - run before }); and after every it block in all enclosed contexts. it(@"should do something", ^{ [[variable should] meetSomeExpectation]; • it(aString, aBlock) - This is where actual actual }); expectations on objects should go context(@"inner context", ^{ xit(@"does another thing", ^{ }); pending(@"something unimplemented", ^{ }); }) }); }); SPEC_END
- 8. Basic usage • SPEC_BEGIN(ClassName) and SPEC_END - SPEC_BEGIN(SpecName) macros that expand to begin and end a KWSpec class describe(@"ClassName", ^{ and group declaration. context(@"a state the component is in", ^{ • describe(aString, aBlock) - starts a context that can __block id variable = nil; contain tests and nested contexts. beforeAll(^{ // Occurs once }); • context(aString, aBlock) - synonym for describe. afterAll(^{ // Occurs once }); • beforeAll(aBlock), afterAll(aBlock) - run once beforeEach(^{ // Occurs before each enclosed "it" before and after all the inner contexts and it blocks of variable = [MyClass instance]; the context it is in. }); afterEach(^{ // Occurs after each enclosed "it" • beforeEach(aBlock), afterEach(aBlock) - run before }); and after every it block in all enclosed contexts. it(@"should do something", ^{ [[variable should] meetSomeExpectation]; • it(aString, aBlock) - This is where actual actual }); expectations on objects should go context(@"inner context", ^{ xit(@"does another thing", ^{ }); • pending(aString, aBlock), xit(aString, aBlock) - doesn't do anything other than log a pending message pending(@"something unimplemented", ^{ to the output when run. }); }) }); }); SPEC_END
- 9. DEMO
- 10. Thanks! • Kiwi repo - https://github.com/allending/Kiwi • NSScreencast(episode about kiwi) - http://nsscreencast.com/ episodes/4-automated-testing-with-kiwi • Test Driving iOS Development with Kiwi by Daniel H Steinberg - iBooks Store Link