Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

77 lines (53 sloc) 3.327 kb


Build Status

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 | bash
  • If you wish to specify a version. Run the following command: (version_name is v0.11.0, v0.10.0 etc...)
    $ bash <(echo "set -- --version 'version_name'; $(curl -L")
  • Or if you want to install from HEAD. Run:
    $ bash <(echo "set -- --head; $(curl -L")
  • 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 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

Jump to Line
Something went wrong with that request. Please try again.