Skip to content

Release notes

Compiled from the AceUnit git history. Tags: v3.1.0, v3.0.0.

Changes on trunk after 3.1.0 (version 3.1.1-SNAPSHOT).

  • aceunit: new option -o SUFFIX to 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.mk in the repository root for local Makefile overrides such as CC or CFLAGS. (95a8fd6)
  • aceunit now fails if an object file is not found or another tool error occurs, instead of continuing silently. (41d29d4)
  • AceUnit_AbortRunner compiles again with pre-C99 compilers. (6460a64)
  • Examples README: corrected an objcopy typo. (8a6e668)
  • runCatching() renamed to AceUnit_runCatching(); it now accepts NULL and short-circuits, replacing the former nop() function. (4894923, ba68fb9)
  • The jump buffer and signal handler are now static, internal to the AceUnit library. (c4e9d9e)
  • bin/aceunit lint fixes reported by shellcheck. (482d997)
  • 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.
  • Lint step and GitHub workflow running shellcheck on bin/aceunit. (c8b4d03, fb30bad)
  • Compiler test uses c23/gnu23 instead of c2x/gnu2x and adds the upcoming C2y (c2y/gnu2y). (7e92e4f, 7f002f3)
  • actions/checkout bumped to 7.0.0. (9454344)

Released 2026-06-20.

  • Linker wrapping: every AceUnit library now also provides __wrap_main(), so a program with its own main() can be linked with -Wl,--wrap=main. See Link-time wrap. (bbe9994)
  • afterEach runs even when the test case failed. (12db6f6)
  • AceUnit_ForkRunner forks for fixtures and test cases instead of individual test methods. (97fa3b0)
  • aceunit script portability: which replaced with command -v. (5772a4b)
  • Examples detect USER_LABEL_PREFIX automatically for objcopy calls. (7801809)
  • Examples are installed to share/doc/aceunit/examples as part of an AceUnit installation unless excluded. (e0fefb2)
  • Installation supports BSD_INSTALL_SCRIPT and BSD_INSTALL_DATA; make install no longer runs the tests (request from package maintainers). (d5ba2a9, e60215d)
  • Prevent use-after-free of the AceUnit_env jump buffer pointer. (acc3c33)
  • AceUnit_env is set to NULL afterwards 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.
  • sprintf() replaced with snprintf(). (c4c5fa7)
  • beforeEach, test case, and afterEach are called explicitly and separately. (b0c28be)
  • argv is const.
  • 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 configure llvm-objcopy on 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/checkout bumped 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.

  • New aceunit generator script that finds test functions in compiled object files, using objdump, nm, or readelf (#12), with a plugin/strategy design (#13).
  • Generator options include -n for the fixture name (#19), a strip prefix, and overriding the tool binary (for example -b m68k-amigaos-objdump).
  • Runners: SimpleRunner, AbortRunner, ForkRunner, and SetJmpRunner, shipped as libaceunit-*.a libraries.
  • Individual test execution.
  • Portability: C89/C90 support (no // comments, no __func__ pre-C99, #8), aceunit_func_t for pre-ANSI compilers, Bruce’s C Compiler (bcc), freestanding environments (stdio.h/fprintf only 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.sh to choose the shell.
  • Installation: staged installs via DESTDIR, configurable man page location, aceunit.mk include for Makefiles, and source/binary distribution archives.
  • NetBSD AArch64: optimizer disabled for runCatching() (#24).
  • LC_ALL=C forced when the self-test expects an error message (#7).
  • Wrong install permissions, wrong variable type, and x86-dos issues fixed.
  • README, man pages, Migration Guide, Code of Conduct, Contributing guidelines, and Security policy added.