cut

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #android #rust #deep-learning #docker #macos #nodejs #java #cli #vue #security #pytorch

(★ 8)

C Unit Testing Framework

cut Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ![Cut](https://cdn.rawgit.com/kube/cut/master/images/cut.svg)

## C Unit Testing Framework

Cut is a simple C Unit Testing Framework composed by a bunch of macros in a single header file. Its syntax is inpired by Node testing framework Mocha.

```c
SUITE(hitchhiker, {
    DESCRIBE("Deep Thought", {
        IT("returns meaning of life", {
            ASSERT(deep_thought() == 42)
        })
    })
})

```

### Signals
Cut will catch signals thrown during execution of each *it* block.
If an unexpected signal appears, the block status will be passed to the signal name.

```
Describe Marvin
    It segfaults when asked to be happy [SIGSEGV]
```

But sometimes, you will expect this behaviour.
In this case, simply use an `EXPECT_SIGNAL` wrapper :

```c
IT("segfaults when asked to be happy", {
    EXPECT_SIGNAL(SIGSEGV, {
        marvin_be_happy()
    })
})
```

Your test will then pass succesfully, **ONLY** if block emitted the expected signal, or will fail otherwise:
```
Describe Marvin
    It segfaults when asked to be happy [OK]
```

## CutRun
**CutRun** is a simple tool that will permit you to run your tests easily without having to create a Makefile or call the compiler from the command-line. It will handle everything for you.

![CutRun](https://raw.githubusercontent.com/kube/cut/master/images/cutrun.png)

### Directives

All compilation properties are passed to CutRun through a simple set of directives, directly in the test source file:

```c
///CUTRUN:LINK_LIBRARY      ft
///CUTRUN:LIBRARY_FOLDER    ../
///CUTRUN:INCLUDE_FOLDER    ../include

SUITE(hello {
    DESCRIBE("world", {
        ...
    })
})
```

You can also pass these directives directly to `cutrun` executable:

```sh
cutrun tests/hashmap.c -I../include -L../ -lft
```

### Install
```
curl -fsSL https://rawgit.com/kube/cut/master/install.sh | sh -s remote
```

### Uninstall

```
rm -rf $(cutrun --print-install-path) $(which cutrun)
```

cut

cut Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

cut

cut Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README