blob: 3a62c2b0f33d9f4b5ddc96ab658514e766c5fde9 (
plain)
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
|
# keldu's minimal testing framework
I jokingly suggested using my mini framework which is baked in a private repo for a project.
Though I didn't want to seriously suggest it, a miniscule percentage suggested to at least make it
available.
So here we are.
This works similarly to other test frameworks.
# Building
## The project itself
### Dependencies
* c++ compiler (c++17) (Usually clang)
* gnumake (or any other flavor)
Also at `.nix/derivation.nix` the nix build env is specified.
If any other questions arise you can check the supplied dependencies and install process there.
### Install into your env
`PREFIX` env variable decides where the install directory lives. Default is `/usr/local`
* `make install`
## If keltest is available in env
This really is the recommended case. Put things in your env. That's why it exists. Drop in your build container if you must, but just put it in your env.
Currently just compile each test file with a compiler of your choice with
`c++ -std=c++17 test_file_a.cpp -c -o test_file_a.o`
`c++ -std=c++17 test_file_b.cpp -c -o test_file_b.o`
and generate a test binary with
`c++ -std=c++17 libkeltest.a test_file_a.o test_file_b.o -o tests`
## Modified commands if not available in env
`c++ -std=c++17 test_file_a.cpp -I${keltest_src} -c -o test_file_a.o`
`c++ -std=c++17 test_file_b.cpp -I${keltest_src} -c -o test_file_b.o`
`c++ -std=c++17 -DKELTEST_COMPILE_TEST_BINARY ${keltest_src}/keltest/test.cpp test_file_a.o test_file_b.o -o tests`
# Writing tests
It is necessary to wrap the tests in an anonymous namespace due to how the test case names are generated. An example test file would be
```
// test_file_hello.cpp
#include <keltest/test.h>
#include <string>
std::string greet(const std::string& val){
return val;
}
namespace {
KEL_TEST("Greeting"){
std::string hello = "hello";
std::string answer = greet(hello);
KEL_EXPECT(answer == "hello", "Person did not reply with a hello");
}
KEL_TEST("Weird Greeting"){
std::string hello = "How are you?";
std::string answer = greet(hello);
KEL_EXPECT(answer == "Fine. How are you?", "Person did not reply with an expected answer");
}
}
```
|
