ThrowTheSwitch/Unity
Unity
Unity is a lightweight unit testing framework for C, providing the assertion library, test runner, and reporting mechanisms required to verify code correctness. It functions as core testing infrastructure for organizing and executing unit tests in C environments.
The framework is designed for system-level and embedded software validation, with specific capabilities for verifying firmware and hardware drivers. It focuses on memory integrity and pointer validity, allowing for the validation of pointer states and the inspection of raw memory blocks.
The toolset covers a broad range of comparison types, including numerical verification for integers, bit patterns, and floating-point values. It also provides utilities for validating null-terminated strings, array contents, and boolean logic, while supporting custom failure messages to provide context during debugging.
Features
- C++ Unit Testing - Provides a lightweight framework for writing and running unit tests for C functions.
- Assertion Macros - Uses assertion macros to capture file and line metadata during test failures.
- C Assertion Libraries - Ships a collection of macros for comparing integers, strings, and memory blocks with descriptive failure messages.
- Embedded Software Validation - Verifies the correctness of firmware and hardware drivers by testing memory blocks and bit patterns.
- Embedded Test Runners - Provides a minimal test runner that can be integrated into C binaries to execute unit tests.
- Unit Testing Frameworks - Provides a lightweight library for verifying C code correctness through assertion macros and failure reports.
- Data Comparison - Performs raw byte-by-byte comparisons of memory segments for non-convertible data types.
- Epsilon-Based Type Comparators - Provides epsilon-based comparisons to handle floating-point precision errors during test assertions.
- Memory Integrity Testing - Checks for null pointers and compares raw memory segments to ensure data integrity.
- Bit Status Checkers - Checks if specific bits or masked ranges in an integer are set to verify hardware flags.
- Null Value Validation - Verifies whether a memory pointer is null or non-null to ensure reference validity.
- Array Content Verifications - Compares multiple array elements against another array or a single expected value.
- Binary Memory Comparisons - Performs raw binary equality checks between memory blocks to validate complex data structures.
- Bit Pattern Verifications - Provides macros to verify the state of hardware flags or packed integers using bitmask-based inspections.
- Conditional Logic Evaluation - Evaluates boolean conditions and marks tests as failures if results differ from expected truth values.
- Boolean Logic Assertions - Implements logic to evaluate expressions and trigger test failures when actual boolean results deviate from expectations.
- Floating Point Comparisons - Provides epsilon-based floating point comparisons to verify numerical correctness in unit tests.
- Assertion Message Customizers - Allows users to append descriptive context to assertion failures for improved debugging.
- Integer Comparisons - Provides assertion macros to check equality and threshold requirements for integer values.
- Null-Terminated String Verifications - Compares character sequences by iterating through memory until a null terminator or length limit is reached.
- String Comparisons - Verifies that null-terminated strings are identical or match for a specific character count.
- बिल्ड सिस्टम - A simple unit testing framework for C.
- Embedded Software Libraries - Lightweight unit testing framework for embedded systems.
- Embedded Utility Libraries - Lightweight unit testing framework for embedded systems.
- Testing and Debugging - Simple unit testing for C.
