freebsd/atf
1
0
Fork 0
mirror of https://github.com/freebsd/atf synced 2026-03-24 04:12:08 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
1,817 commits 3 branches 24 tags 14 MiB
  • C 45.2%
  • C++ 27.3%
  • Shell 9.6%
  • M4 7.8%
  • Roff 5.6%
  • Other 4.5%
Find a file
Exact
Enji Cooper 2f392322fe
 Merge pull request #127 from jesuscbm/patch-1 
atf-c.3: Fix test case addition in ATF_TP_ADD_TCS synopsis example
2026-03-10 14:09:03 -07:00
.github/workflows CI workflow cleanup fixes (part 2) 2025-12-29 21:45:43 -08:00
admin Use git rev-parse to determine if in git clone 2026-01-31 12:11:00 -08:00
atf-c Fix test case addition in ATF_TP_ADD_TCS synopsis example 2026-03-10 20:16:22 +00:00
atf-c++ Remove sys/mount.h include 2026-01-30 23:03:16 -08:00
atf-sh atf-check_test: fix sflag testcases 2025-12-28 17:50:41 -08:00
bootstrap Remove package name from file headers 2014-10-13 22:13:35 -04:00
doc doc: move atf-test-case.4 to section 7 2025-08-05 19:15:14 +01:00
m4 Fix indentation in file (tab -> spaces) 2025-03-29 11:19:31 -07:00
test-programs Remove package name from file headers 2014-10-13 22:13:35 -04:00
.cirrus.yml CI workflow cleanup fixes (part 2) 2025-12-29 21:45:43 -08:00
.gitignore admin/make-release.sh: automate release creation (#74) 2025-03-29 11:18:55 -07:00
atf-c++.hpp Remove package name from file headers 2014-10-13 22:13:35 -04:00
atf-c.h Remove package name from file headers 2014-10-13 22:13:35 -04:00
AUTHORS Time the execution of test cases and test programs 2011-12-18 20:51:32 +00:00
configure.ac Bump the package version to 0.24 2025-12-29 17:31:28 -08:00
COPYING Add 2012 to the copyright notices. 2012-01-16 17:22:21 +00:00
INSTALL.md Style INSTALL.md 2024-06-29 11:51:35 -04:00
Kyuafile Remove the deprecated tools code 2014-02-06 17:45:04 -05:00
Makefile.am Support both FreeBSD/macOS and Linux 2025-12-28 08:49:42 -08:00
NEWS Add a "dummy" 0.24 version entry to NEWS 2025-12-29 20:46:39 -08:00
NEWS.md Rename NEWS.md back to NEWS to unbreak make dist 2025-03-29 11:40:29 -07:00
README.md Update the latest release in README.md 2025-03-29 13:20:22 -07:00

README.md

Welcome to the ATF project!

ATF, or Automated Testing Framework, is a collection of libraries to write test programs in C, C++ and POSIX shell.

The ATF libraries offer a simple API. The API is orthogonal through the various bindings, allowing developers to quickly learn how to write test programs in different languages.

ATF-based test programs offer a consistent end-user command-line interface to allow both humans and automation to run the tests.

ATF-based test programs rely on an execution engine to be run and this execution engine is not shipped with ATF. Kyua is the engine of choice.

Download

Formal releases for source files are available for download from GitHub:

  • atf 0.23, released on March 29th, 2025.

Installation

You are encouraged to install binary packages for your operating system wherever available:

  • FreeBSD 10.0 and above: install the atf package with pkg install atf.

  • NetBSD with pkgsrc: install the pkgsrc/devel/atf package.

  • OpenBSD: install the devel/atf package with pkg_add atf.

  • Ubuntu: install the libatf-dev and atf-sh packages with apt install libatf-dev atf-sh.

Should you want to build and install ATF from the source tree provided here, follow the instructions in the INSTALL file.

More Reading

  • AUTHORS: List of authors and contributors for this project.

  • COPYING: License information.

  • INSTALL.md: Compilation and installation instructions. These is not the standard document shipped with many packages, so be sure to read it for things that are specific to ATF's build.

  • NEWS.md: List of major changes between formal, published releases.

Other documents

  • AUTHORS: List of authors and contributors for this project.

  • COPYING: License information.

  • INSTALL.md: Compilation and installation instructions. These is not the standard document shipped with many packages, so be sure to read it for things that are specific to ATF's build.

  • NEWS.md: List of major changes between formal, published releases.

Support

Please use the FreeBSD-testing@FreeBSD.org mailing list for any support inquiries related to atf-c, atf-c++, atf-sh, or kyua.