Skip to content
BDD-style testing using Objective-C
Branch: master
Clone or download
Latest commit 176a091 Mar 12, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
Cedar.xcodeproj Project metadata updates & swift syntax conversion Mar 12, 2018
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
Spec Updates URLs to Cedar Mar 12, 2018
images Add a screenshot of the Cedar file template picker for the Alcatraz e… Aug 18, 2015
scripts Removed Cedar Plugin Apr 12, 2016
.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

You can’t perform that action at this time.