BDD-style testing using Objective-C
Objective-C++ Objective-C Ruby C++ Swift Shell C

README.markdown

Cedar

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 https://raw.github.com/pivotal/cedar/master/install.sh | bash
  • Or if you want to install from HEAD. Run:
    $ bash <(echo "set -- --head; $(curl -L https://raw.github.com/pivotal/cedar/master/install.sh)")
  • Restart Xcode
  • Add new spec files to your project's Test Bundle using the Xcode templates
  • Start writing specs!

Documentation

Documentation can be found on the Cedar Wiki.

Support and feedback

Contributing

Please read the Contributor Guide on the wiki.

Maintainers

Copyright (c) 2010-2016 Pivotal Labs. This software is licensed under the MIT License. Mixpanel