https://github.com/bigwhite/cbehave
  
  
    A Behavior Driven Development Framework for C 
    https://github.com/bigwhite/cbehave
  
bdd c unit-testing
        Last synced: 6 months ago 
        JSON representation
    
A Behavior Driven Development Framework for C
- Host: GitHub
- URL: https://github.com/bigwhite/cbehave
- Owner: bigwhite
- License: other
- Created: 2013-04-01T14:30:11.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2013-07-12T02:14:11.000Z (over 12 years ago)
- Last Synced: 2025-04-18T08:39:40.815Z (7 months ago)
- Topics: bdd, c, unit-testing
- Language: Shell
- Size: 553 KB
- Stars: 26
- Watchers: 3
- Forks: 7
- Open Issues: 0
- 
            Metadata Files:
            - Readme: README.md
- Changelog: ChangeLog
- License: LICENSE
 
Awesome Lists containing this project
README
          cbehave - A Behavior Driven Development Framework for C
=======
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
A Typical Example
-------------
An example:
    #include 
    #include 
    #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]
Build
------
 - Download the source code package
 - unzip the package
 - configure->make->make install
 
if you want to compile in 64-bit mode, pass "CPPFLAGS=-m64 LDFLAGS=-m64" to configure.
sometimes, you may encounter such error:
     mv: cannot stat `.deps/cbehave.Tpo': No such file or directory
     make[1]: *** [cbehave.lo] Error 1
	
a solution for this is execute "libtoolize -f" before "configure".
User Guide
-------------
For more information, please open and read the project wiki. cbehave user guide is ready for you.