BDD-style testing using Objective-C
Clone or download
Latest commit 176a091 Mar 12, 2018
Failed to load latest commit information.
CodeSnippetsAndTemplates Use a modernized style for the spec template icon, and remove ".mm" Jan 13, 2016
English.lproj Initial commit May 1, 2010
Source Raise when it, describe, context are called before/after tests run Jul 28, 2016
images Add a screenshot of the Cedar file template picker for the Alcatraz e… Aug 18, 2015
scripts Removed Cedar Plugin Apr 12, 2016
.gitignore RaiseException matcher extended to handle NSException' name Sep 27, 2013
.travis.yml Travis to attempt running the install scripts. Remove installing subm… Jul 23, 2015
Cedar-Info.plist Bump version to 1.0 Apr 25, 2016
Cedar.podspec Updates URLs to Cedar Mar 12, 2018
Gemfile Adds feature for failure to link AppDelegate Jul 23, 2013
Gemfile.lock Upgrade gems Oct 1, 2014
MIT.LICENSE.txt Renamed LICENSE file for cocoapod's linting. Oct 3, 2014
README.markdown Updates URLs to Cedar Mar 12, 2018
Rakefile Removed Cedar Plugin Apr 12, 2016 Updates URLs to Cedar Mar 12, 2018
installCodeSnippetsAndTemplates Allow any rake version during install May 13, 2014
upgradeCedarFramework Made upgradeCedarFramework work with paths containing spaces Sep 28, 2014



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-2016 Pivotal Labs. This software is licensed under the MIT License. Mixpanel