Add unit testing support and update README with testing instructions

Author: evvic

.github/workflows/build-and-release.yml

@@ -29,6 +29,10 @@ jobs:
       run: |
         make all
 
+    - name: Unit testing
+      run: |
+        make unittest
+
     - name: Create GitHub Release
       id: create_release
       uses: actions/create-release@v1

.github/workflows/pr-check-build.yml

@@ -26,4 +26,7 @@ jobs:
     - name: Build all targets
       run: |
         make all
-
+    
+    - name: Unit testing
+      run: |
+        make unittest

CMakeLists.txt

@@ -6,8 +6,10 @@ project(std2 LANGUAGES CXX)
 set(CMAKE_CXX_STANDARD 23)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 
-# Enable testing
-enable_testing()
+# Enable testing globally if TEST=true
+if(UNITTEST)
+    enable_testing()
+endif()
 
 # Include FetchContent for downloading dependencies
 include(FetchContent)

Makefile

@@ -1,23 +1,42 @@
 # Convenience Makefile for building std2 library components
 
 BUILD_DIR = build
+UNITTEST ?= false
 
-.PHONY: all clean memory vector std2
+.PHONY: all clean memory vector std2 unittest
 
 all: $(BUILD_DIR)
 	@cd $(BUILD_DIR) && cmake .. && cmake --build .
+	@if [ "$(UNITTEST)" = "true" ]; then \
+		cd $(BUILD_DIR) && ctest --output-on-failure; \
+	fi
 
 $(BUILD_DIR):
 	@mkdir -p $(BUILD_DIR)
 
+# Build targets with optional testing
 memory: $(BUILD_DIR)
-	@cd $(BUILD_DIR) && cmake .. && cmake --build . --target memory
+	@cd $(BUILD_DIR) && cmake .. -DTEST=$(UNITTEST) && cmake --build . --target memory memory_tests
+	@if [ "$(UNITTEST)" = "true" ]; then \
+		cd $(BUILD_DIR) && ctest --output-on-failure -R "UniquePointerTest"; \
+	fi
 
 vector: $(BUILD_DIR)
 	@cd $(BUILD_DIR) && cmake .. && cmake --build . --target vector
+	@if [ "$(UNITTEST)" = "true" ]; then \
+		cd $(BUILD_DIR) && ctest --output-on-failure -R "^vector"; \
+	fi
 
 std2: $(BUILD_DIR)
 	@cd $(BUILD_DIR) && cmake .. && cmake --build . --target std2
+	@if [ "$(UNITTEST)" = "true" ]; then \
+		cd $(BUILD_DIR) && ctest --output-on-failure -R "^std2"; \
+	fi
 
+# Run all tests explicitly
+unittest: $(BUILD_DIR)
+	@cd $(BUILD_DIR) && ctest --output-on-failure
+
+# Clean target
 clean:
 	@rm -rf $(BUILD_DIR)

README.md

@@ -24,11 +24,45 @@ git push origin --tags
 ```
 > Note the tag version must be higher than the current tag
 
-# Run with main to test
+# Unit testing
+This project uses Google Test framework for unit testing. Each module (memory, vector, etc.) has its own test suite in its `tests/` directory.
+
+## Running tests
+You can run tests in several ways:
+
+1. Run all tests without rebuilding:
+```bash
+make unittest
+```
+
+2. Run tests for a specific module:
 ```bash
-./test_memory
+make memory TEST=true   # Run memory module tests only
+make vector TEST=true   # Run vector module tests only
 ```
 
+3. Run all tests:
+```bash
+make all UNITTEST=true
+```
+
+## Test Structure
+Each module follows this test structure:
+- Basic functionality tests
+- Edge case tests
+- Move semantics tests (for modern C++ features)
+- Custom behavior tests (e.g., custom deleters)
+- Performance benchmarks
+
+## Adding New Tests
+1. Create test files in the module's `tests/` directory
+2. Name test files as `<component>_test.cpp`
+3. Use Google Test macros for assertions:
+   - `EXPECT_EQ()` for equality
+   - `EXPECT_NE()` for inequality
+   - `EXPECT_TRUE()` for boolean conditions
+   - `EXPECT_THROW()` for exception testing
+
 # C++23 Setup
 
 ## Update CMake: