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 "pivotal/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/pivotal/cedar/master/install.sh | bash

• Or if you want to install from HEAD. Run:

    $ bash <(echo "set -- --head; $(curl -L https://raw.github.com/pivotal/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

Copyright (c) 2010-2016 Pivotal Labs. This software is licensed under the MIT License.