Skip to content


Subversion checkout URL

You can clone with
Download ZIP
BDD-style testing using Objective-C
Objective-C++ Objective-C C++ Ruby Other

Properly send stdout AND stderr to dev null

The order of this always trips me up. Pretty sure I was to blame for
introducing this originally anyway, so it is only fair that I clean it
up now
latest commit 9ac020e7ee
@tjarratt tjarratt authored Tim Jarratt committed
Failed to load latest commit information.
Cedar-iOS-Framework Spec Remove unused xib files
Cedar-iOS-Framework Add Framework test suite
Cedar.xcodeproj Xcode 7 metadata changes
CedarPlugin.xcplugin/Contents Adds DVTPlugInCompatibilityUUID for Xcode 6.3.2
CodeSnippetsAndTemplates Update templates to work with Xcode 6.3
English.lproj Initial commit
OCUnitApp Bumps version to 0.11.1
OCUnitAppLogicTests Suppressed SenTestingKit warning.
OCUnitAppTests Fail tests correctly under SenTestingKit
OS X Failing Test Bundle Usability for Cedar Test Bundle + Testing script tweaks.
OS X Host App Remove unused xib files
OS X Host AppTests Usability for Cedar Test Bundle + Testing script tweaks.
OS X XCTest Bundle Usability for Cedar Test Bundle + Testing script tweaks.
Source Don't expose CedarDoubleImpl in Cedar.h
Spec Fixes compilation issues in latest toolchain
XCUnitAppTests Fix for running specs under SenTestingKit or XCTest.
.gitignore RaiseException matcher extended to handle NSException' name
.travis.yml Updated travis.yml file to use iOS 8.1.
Cedar-Info.plist Version 0.11.3
Cedar.podspec Version 0.11.3
Gemfile Adds feature for failure to link AppDelegate
Gemfile.lock Upgrade gems
MIT.LICENSE.txt Renamed LICENSE file for cocoapod's linting.
README.markdown Merge pull request #340 from pivotal-brian-croom/mention-xcode7
Rakefile Properly send stdout AND stderr to dev null
iOSSpecs-Info.plist Bumps version to 0.11.1 Added space between arguments in usage of the install script.
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;

Note for Xcode 7 users

With Xcode 7, Apple has introduced changes to XCTest.framework which are incompatible with Cedar's test bundle runner. (See #333 for more details.) Support for Xcode 7 is being actively developed on the Xcode7 branch which should be used until we feel that the Xcode 7 betas have stabilized and we are ready to merge this work into the master branch.

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

Something went wrong with that request. Please try again.