Home

Welcome to the cbehave wiki!

Recent News

• 2013-04-02 fork a copy to https://github.com/bigwhite/cbehave.git.
• 2012-04-16 cbehave 0.2.0 released.
• 2011-08-14 cbehave 0.1.0 version released.

Introduction

CBehave - A Behavior Driven Development Framework for C.

Main Features

• use the "feature + scenario" structure which is (inspired by Cucumber)
• use classical "given-when-then" template to describe the behavior scenario
• support mock

An Typical Example

#include <stdio.h>
#include <errno.h>
#include "cbehave.h"

FEATURE(1, "strstr")
    SCENARIO("The strstr finds the first occurrence of the substring in the source string")

        GIVEN("A source string: [Lionel Messi is a great football player]")
            char *str = "Lionel Messi is a great football player";
        GIVEN_END

        WHEN("we use strstr to find the first occurrence of [football]")
            char *p = strstr(str, "football");
        WHEN_END

        THEN("We should get the string: [football player]")
            SHOULD_STR_EQUAL(p, "football player");
        THEN_END

    SCENARIO_END

    SCENARIO("If strstr could not find the first occurrence of the substring, it will return NULL")

        GIVEN("A source string: FC Barcelona is a great football club.")
            char *str = "FC Barcelona is a great football club";
        GIVEN_END

        WHEN("we use strstr to find the first occurrence of [AC Milan]")
            char *p = strstr(buf, "AC Milan");
        WHEN_END

        THEN("We should get no string but a NULL")
            SHOULD_STR_EQUAL(p, NULL);
        THEN_END
    SCENARIO_END
FEATURE_END

int main() {
    cbehave_feature strstr_features[] = {
        {feature_idx(1)},
    };

    return cbehave_runner("Strstr Features are as belows:", strstr_features);
}

The result of the example could be seen like：

*******************************************************************
    CBEHAVE -- A Behavior Driven Development Framework for C
             By Tony Bai
*******************************************************************
Strstr Features are as belows:

Feature: strstr
    Scenario: The strstr finds the first occurrence of the substring in the source string
        Given: A source string: Lionel Messi is a great football player
        When: we use strstr to find the first occurrence of [football]
        Then: We should get the string: [football player]
    Scenario: If strstr could not find the first occurrence of the substring, it will return NULL
        Given: A source string: FC Barcelona is a great football club.
        When: we use strstr to find the first occurrence of [AC Milan]
        Then: We should get no string but a NULL

Summary:
    total features: [1]
    failed features: [0]
    total scenarios: [2]
    failed scenarios: [0]

User Guide

"CBehave User Guide" is here. And the Chinese edition is here.