Skip to content


Subversion checkout URL

You can clone with
Download ZIP
BDD-style testing using Objective-C
Objective-C++ Objective-C Ruby C++ Other
Latest commit 162ce09 @briancroom briancroom Merge pull request #351 from pivotal/contain_subset_matcher
Add contain_subset matcher



Build Status Carthage compatible

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

    $ curl -L | bash
  • Or if you want to install from HEAD. Run:
    $ bash <(echo "set -- --head; $(curl -L")
  • Restart Xcode
  • Add new spec files to your project's Test Bundle using the Xcode templates
  • Start writing specs!


Documentation can be found on the Cedar Wiki.

Support and feedback


Please read the Contributor Guide on the wiki.


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

Something went wrong with that request. Please try again.