A behavior-driven development testing library for C++ with an RSpec-inspired DSL.

C++Spec will be released as a single collated header-file that can be placed in any include path in your project. After that, all features are available via #include "cppspec.hpp".

If you want to use the git repo for development or to integrate it into your own project as a submodule, releases will also be available as tags. This project's include folder should then be added to your project's include path. Again, all functionality is exposed through #include "cppspec.hpp".

If you want to manually generate the collated cppspec.hpp yourself, you can download the ccollate tool here and then run ./ccollate.rb include/cppspec.hpp > cppspec.hpp in the toplevel directory of the C++Spec repo. A fully-featured cppspec.hpp file will then be available in the root of the project for usage.

See http://cppspec.readthedocs.org/ for full documentation and a tutorial.

C++Spec requires a compiler with support for C++11 and polymorphic lambda expressions from C++14. This includes GCC >= 4.9, MSVCC >= 14.0, or clang >= 3.4. For other compilers check this chart.

Note: Only the tests require being compiled with C++14 support (-std=c++14). No other part of an existing project's build must be modified.

If you've ever used RSpec or Jasmine, chances are you'll be familiar with C++Spec's syntax. For example, this is a C++Spec version of the first snippet on RSpec's README.

#include "cppspec.hpp"
#include "order.hpp"

describe order_spec("Order", $ {
  it("sums the prices of its line items", _ {
    Order order();

	order.add_entry(LineItem().set_item(Item()
	  .set_price(Money(1.11, Money::USD))
	));

	order.add_entry(LineItem().set_item(Item()
	  .set_price(Money(1.11, Money::USD))
	  .set_quantity(2)
	));

	expect(order.total()).to_equal(Money(5.55, Money::USD));
  });
});


int main(){
  return CppSpec::Runner(CppSpec::Formatters::verbose)
             .add_spec(order_spec)
             .exec() ? EXIT_SUCCESS : EXIT_FAILURE;
}

Heavily inspired by RSpec and Jasmine.

Copyright © 2014-2016 Katherine Whitlock

The project is licensed under the MIT License.