README.md

specc

Unit testing framework for C/C++

Example test suite using specc

#include "../../src/specc.h"

module(simple, {
  
  describe("simple test",{
    
    it("this is what a passing test looks like",
      should(1 == 1));

    it("failing boolean test",
      should(1 == 0););

    it("failing char test",
      should_eq('a','b',char););

    it("failing int test",
      should_eq(1,2,int););

    it("failing float test",
      should_eq(0.9f,2.4f,float););

    it("failing pointer test", {
      int a = 5;
      int b = 5;
      should_eq(&a,&b,int*);});

    it("failing string test",
      should_str_eq("hello","bye"););});});

Output:

Current Comparison Support

• should
• should_not
• should_eq (for primitives)
• should_not_eq (for primitives)
• should_str_eq
• should_str_not_eq
• should_double_eq (with given err)
• should_double_not_eq (with given err)

You can also implement your own custom comparisons. An example of this can be found in examples/custom

Stubbing

The only support specc has for any kind of 'stubbing' is a #define SPECC to allow different behavior when tests are being run.

Building

Custom

specc's entry point is in src/specc.c so all you have to do is

gcc -c src/specc.c

and then link all of your spec files.

Makefile

# alternatively, `make spec-auto`
make spec

Right now, the Makefile is configured to run the simple example, but it isn't too hard to change it for your needs.