Skip to content

Commit

Permalink
Merge pull request #51 from JakeRoggenbuck/add-testing-readme
Browse files Browse the repository at this point in the history
Add testing readme
  • Loading branch information
JakeRoggenbuck authored Aug 5, 2024
2 parents 5cc672c + bd26e7c commit 1c25933
Showing 1 changed file with 51 additions and 0 deletions.
51 changes: 51 additions & 0 deletions src/testing/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# src/testing

Here is an example usage of the testing

This is from "lexer/test_lexer.c"

For each module of code, create a test_{module_name} file.
This file should include a test_{module_name} function that includes the testing_setup and the testing_cleanup functions.

```c
#include "lex.h"
#include <testing/test_utils.h>

int test_lexer() {
testing_module_setup();

test_ttype_from_string();

testing_module_cleanup();
return 0;
}
```

After this, include a call to this function in the "testing/main.c" file like how it's done for test_lexer.

```c
#include "lexer/test_lexer.h"

int main() {
test_lexer();

return 0;
}
```

Finally, here is what a test might look like. Make sure to include a call to testing_func_setup at the start.

```c
int test_ttype_from_string() {
testing_func_setup();

tassert(ttype_from_string("1") == TT_LITERAL);
tassert(ttype_from_string("1.2") == TT_LITERAL);

// ...

tassert(ttype_from_string(";") == TT_SEMI);

return 0;
}
```

0 comments on commit 1c25933

Please sign in to comment.