cedar's Introduction

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

Install the Xcode command line tools package (Under the Preferences tab 'Downloads') if you haven't already done so
Run the following in a terminal to install Xcode templates for ease of use:

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

Restart Xcode
Add new targets or files to your project using the Xcode templates, or create a new project to test-drive from scratch
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:[email protected]
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](mailto: [email protected]) (pivotal-brian-croom), Pivotal Labs, Toronto
Jeff Hui (jeffh), Pivotal Labs, San Francisco
Sam Coward (idoru), Pivotal Labs, New York