From cac4a8dd2ac6670c5db8d2370cdd12451f9f50cf Mon Sep 17 00:00:00 2001
From: Claudius Holeksa <mail@keldu.de>
Date: Tue, 9 May 2023 17:24:41 +0200
Subject: Added readme and moved src files

---
 README.md | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7f9c1b9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,60 @@
+# 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
+## 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 -DKEL_COMPILE_TEST_BINARY keltest.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 -DKEL_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");
+}
+}
+```
-- 
cgit v1.2.3