Skip to content
BDD-style testing using Objective-C
Objective-C++ Objective-C Ruby C++ Swift Shell C
Latest commit 3d0d8e3 @tjarratt tjarratt Merge pull request #374 from wileykestner/master
Expose failing test in CI and then fix the failing test
Failed to load latest commit information.
Cedar.xcodeproj Set optimization level build setting to 'None -O0' in Release configu…
CedarPlugin.xcplugin/Contents Update cedar plugin for Xcode 7.0
CodeSnippetsAndTemplates Use a modernized style for the spec template icon, and remove ".mm"
English.lproj Initial commit
Source Merge pull request #357 from pivotal/kvc_improvements
Spec Merge pull request #357 from pivotal/kvc_improvements
images Add a screenshot of the Cedar file template picker for the Alcatraz e…
scripts Change `rake ci` task to detect previously undetected test failures
.gitignore RaiseException matcher extended to handle NSException' name
.travis.yml Travis to attempt running the install scripts. Remove installing subm…
Cedar-Info.plist Bump version to 0.12.0
Cedar.podspec Remove conditional from the tvOS declaration in the podspec
Gemfile Adds feature for failure to link AppDelegate
Gemfile.lock Upgrade gems
MIT.LICENSE.txt Renamed LICENSE file for cocoapod's linting.
README.markdown Update copyright year to 2016
Rakefile Extract remaining rake tasks Travis to attempt running the install scripts. Remove installing subm…
installCodeSnippetsAndTemplates Allow any rake version during install
upgradeCedarFramework Made upgradeCedarFramework work with paths containing spaces



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

Something went wrong with that request. Please try again.