Release notes
Compiled from the AceUnit git history. Tags: v3.1.0, v3.0.0.
Unreleased
Section titled “Unreleased”Changes on trunk after 3.1.0 (version 3.1.1-SNAPSHOT).
Features
Section titled “Features”aceunit: new option-o SUFFIXto set the object file suffix (default.o). (32c2534)- The global jump buffer is only initialized once
setjmp()has returned successfully. (9fbf8ed) - Build: support a git-ignored
.User.mkin the repository root for local Makefile overrides such asCCorCFLAGS. (95a8fd6)
aceunitnow fails if an object file is not found or another tool error occurs, instead of continuing silently. (41d29d4)AceUnit_AbortRunnercompiles again with pre-C99 compilers. (6460a64)- Examples README: corrected an
objcopytypo. (8a6e668)
Refactoring
Section titled “Refactoring”runCatching()renamed toAceUnit_runCatching(); it now acceptsNULLand short-circuits, replacing the formernop()function. (4894923, ba68fb9)- The jump buffer and signal handler are now
static, internal to the AceUnit library. (c4e9d9e) bin/aceunitlint fixes reported by shellcheck. (482d997)
Documentation
Section titled “Documentation”- README: documented
.User.mk,AceUnit_runCatching()NULL-tolerance for custom runners, the Test Fixtures section, and a link from Workflow to the examples. - CONTRIBUTING: test-run instructions and
.User.mk. - AUTHORS: added Ashish Vaghela.
Build and tests
Section titled “Build and tests”- Lint step and GitHub workflow running shellcheck on
bin/aceunit. (c8b4d03, fb30bad) - Compiler test uses
c23/gnu23instead ofc2x/gnu2xand adds the upcoming C2y (c2y/gnu2y). (7e92e4f, 7f002f3) actions/checkoutbumped to 7.0.0. (9454344)
Released 2026-06-20.
Features
Section titled “Features”- Linker wrapping: every AceUnit library now also provides
__wrap_main(), so a program with its ownmain()can be linked with-Wl,--wrap=main. See Link-time wrap. (bbe9994) afterEachruns even when the test case failed. (12db6f6)AceUnit_ForkRunnerforks for fixtures and test cases instead of individual test methods. (97fa3b0)aceunitscript portability:whichreplaced withcommand -v. (5772a4b)- Examples detect
USER_LABEL_PREFIXautomatically forobjcopycalls. (7801809) - Examples are installed to
share/doc/aceunit/examplesas part of an AceUnit installation unless excluded. (e0fefb2) - Installation supports
BSD_INSTALL_SCRIPTandBSD_INSTALL_DATA;make installno longer runs the tests (request from package maintainers). (d5ba2a9, e60215d)
- Prevent use-after-free of the
AceUnit_envjump buffer pointer. (acc3c33) AceUnit_envis set toNULLafterwards to prevent stack leakage by bogus code. (0d52f39)- Compiler test failed on C23 compilers with pedantic settings. (285b686)
- Compiler warning about a prototype. (560bc08)
- Remove the path from the basename (#33). (f97f4b0)
- Fixed the test build directory rule, example Makefiles, and the fixture structure generator typo.
Refactoring
Section titled “Refactoring”sprintf()replaced withsnprintf(). (c4c5fa7)beforeEach, test case, andafterEachare called explicitly and separately. (b0c28be)argvisconst.
Documentation
Section titled “Documentation”- New “Hello, world!” examples showing how to mock with a macro, the linker, object-file manipulation, interposing, and stdout/stderr interception. (e7fea53, 9934a2f)
- Documented when to use
AceUnit_run(), and how to configurellvm-objcopyon macOS. - License: the LICENSE no longer restricts redistribution through AI/LLMs or use for AI training; copyright extended to 2026. (88a583e)
- README updated to the latest changes and versions.
- Coverage report fixed for GCC and re-enabled; LLVM tools discovered automatically.
actions/checkoutbumped up to 6.0.2.
Released 2024-05-04. AceUnit 3 is a complete rewrite of AceUnit (the new version replaced the old code base in February 2023). See the Migration guide for moving from earlier versions.
Features
Section titled “Features”- New
aceunitgenerator script that finds test functions in compiled object files, usingobjdump,nm, orreadelf(#12), with a plugin/strategy design (#13). - Generator options include
-nfor the fixture name (#19), a strip prefix, and overriding the tool binary (for example-b m68k-amigaos-objdump). - Runners:
SimpleRunner,AbortRunner,ForkRunner, andSetJmpRunner, shipped aslibaceunit-*.alibraries. - Individual test execution.
- Portability: C89/C90 support (no
//comments, no__func__pre-C99, #8),aceunit_func_tfor pre-ANSI compilers, Bruce’s C Compiler (bcc), freestanding environments (stdio.h/fprintfonly in hosted environments, #11), and cross-compilation tests including m68k-amigaos. - Hosted platforms tested include Linux, macOS, FreeBSD, NetBSD, OpenBSD, and Haiku; the generator runs on bash, zsh, and ksh, with a
configure.shto choose the shell. - Installation: staged installs via
DESTDIR, configurable man page location,aceunit.mkinclude for Makefiles, and source/binary distribution archives.
- NetBSD AArch64: optimizer disabled for
runCatching()(#24). LC_ALL=Cforced when the self-test expects an error message (#7).- Wrong install permissions, wrong variable type, and
x86-dosissues fixed.
Documentation
Section titled “Documentation”- README, man pages, Migration Guide, Code of Conduct, Contributing guidelines, and Security policy added.