Cedar

Cedar is a BDD-style Objective-C testing framework with an expressive matcher DSL and convenient test doubles.

describe(@"Example specs on NSString", ^{
    it(@"lowercaseString returns a new string with everything in lower case", ^{
        [@"FOOBar" lowercaseString] should equal(@"foobar");
    });

    it(@"length returns the number of characters in the string", ^{
        [@"internationalization" length] should equal(20);
    });

    describe(@"isEqualToString:", ^{
        it(@"should return true if the strings are the same", ^{
            [@"someString" isEqualToString:@"someString"] should be_truthy;
        });

        it(@"should return false if the strings are not the same", ^{
            [@"someString" isEqualToString:@"anotherString"] should be_falsy;
        });
    });
});

Quick start

Add Cedar to your project via CocoaPods (pod 'Cedar'), Carthage (github "cedarbdd/cedar"), or another method
Install the Cedar Xcode file templates using the Alcatraz package manager or by running this command in a terminal:

    $ curl -L https://raw.github.com/cedarbdd/cedar/master/install.sh | bash

Or if you want to install from HEAD. Run:

    $ bash <(echo "set -- --head; $(curl -L https://raw.github.com/cedarbdd/cedar/master/install.sh)")

Restart Xcode
Add new spec files to your project's Test Bundle using the Xcode templates
Start writing specs!

Documentation

Documentation can be found on the Cedar Wiki.

Support and feedback

Search past discussions: http://groups.google.com/group/cedar-discuss
Send an e-mail to the discussion list: mailto:cedar-discuss@googlegroups.com
View the project backlog on Pivotal Tracker: http://www.pivotaltracker.com/projects/77775.
Follow us on twitter: @cedarbdd

Contributing

Please read the Contributor Guide on the wiki.

Maintainers

Andrew Kitchen (akitchen), Pivotal Labs, San Francisco
Brian Croom (briancroom), Pivotal Labs, Toronto
Jeff Hui (jeffh), Pivotal Labs, San Francisco
Sam Coward (idoru), Pivotal Labs, New York
Tim Jarratt (tjarratt), Pivotal Labs, San Francisco