File: cheat-sheet.md

package info (click to toggle)
cgreen 1.6.4-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 2,576 kB
  • sloc: ansic: 12,264; sh: 555; makefile: 468; cpp: 403; python: 181; xml: 33; sed: 13
file content (98 lines) | stat: -rw-r--r-- 2,327 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
# Cgreen Cheat Sheet

## Pre-amble

    #include <cgreen/cgreen.h>
    #include <cgreen/mocks.h>

    Describe( <sut> );
    BeforeEach( <sut> ) {}
    AfterEach( <sut> ) {}

## A test

    Ensure( <sut>, <test_name> ) {
        assert_that( <expression> );
        assert_that( <expression>, <constraint> );
        assert_that_double(...);
    }

## Constraints

    is_true
    is_false
    is_null
    is_non_null
    is_equal_to( <value> )
    is_equal_to_hex( <value> )
    is_not_equal_to( <value> )
    is_greater_than( <value> )
    is_less_than( <value> )

### Structs and general data

    is_equal_to_contents_of( <pointer>, <size> )
    is_not_equal_to_contents_of( <pointer>, <size> )

### Strings

    is_equal_to_string( <value> )
    is_not_equal_to_string( <value> )
    contains_string( <value> )
    does_not_contain_string( <value> )
    begins_with_string( <value> )
    does_not_begin_with_string( <value> )
    ends_with_string( <value> )
    does_not_end_with_string( <value> )

### Floating point values (Doubles)

    is_equal_to_double( <value> )
    is_not_equal_to_double( <value> )
    is_less_than_double( <value> )
    is_greater_than_double( <value> )

    significant_figures_for_assert_double_are( <figures> )

## Mocks

    <qualifiers> <function_name> ( <parameters> ) {
        mock( <parameters> );
        mock( box_double( <parameter> ) );
        return ( <type> ) mock( <parameters> );
        return mock_double( <parameters> );
    }

    Ensure( <sut> ) {
        expect(<function> {, when(<parameter>, <constraint> ) }
                          [, <returns> ]
                          [, times( <n> ) ] );
        always_expect(...);
        never_expect(...);
    }

    cgreen_mocks_are( strict_mocks | loose_mocks | learning_mocks );

### Returns

    will_return( <value> )
    will_return_double( <value> )
    will_return_by_value( <value>, <size> )
    with_side_effect( <function>, <pointer_to_data> )
    will_set_contents_of_parameter( <parameter_name>, <value>, <size> )

## C++

    namespace cgreen;
    assert_throws( <exception>, <expression>);

## Minimal Makefile

    all: $(UNIT)_tests.so
        cgreen-runner $^

    $(UNIT)_tests.so: $(UNIT)_tests.o $(UNIT).o
        $(CC) -shared -o $@ $^ -lcgreen

    %.o: %.c
        $(CC) $(CFLAGS) -fPIC -c -o $@ $^