Name
Date
Size
#Lines
LOC

..--

atf-c/H--17,76112,766

atf-c++/H--9,7736,632

atf-sh/H--4,0323,285

doc/H--552548

test-programs/H--1,8551,311

.cirrus.ymlH A D04-Feb-2021754 2725

.gitignoreH A D04-Feb-2021232 2624

.travis.ymlH A D04-Feb-2021376 2619

AUTHORSH A D19-Jun-20131.1 KiB3119

COPYINGH A D19-Jun-20134.4 KiB10173

FREEBSD-XlistH A D13-Jan-2015117 1312

FREEBSD-upgradeH A D31-May-20241.6 KiB4633

KyuafileH A D03-Jun-2014157 96

NEWSH A D04-Feb-202129.6 KiB745522

READMEH A D03-Jun-20141.4 KiB3825

README.mdH A D04-Feb-20211.6 KiB4830

atf-c++.hppH A D13-Jan-20151.5 KiB335

atf-c.hH A D13-Jan-20151.5 KiB346

config.hH A D08-Jun-20162.7 KiB9326

README

1Introductory information                        Automated Testing Framework
2===========================================================================
3
4
5Introduction
6************
7
8The Automated Testing Framework (ATF) is a collection of libraries to
9implement test programs in a variety of languages.  At the moment, ATF
10offers C, C++ and POSIX shell bindings with which to implement tests.
11These bindings all offer a similar set of functionality and any test
12program written with them exposes a consistent user interface.
13
14ATF-based test programs rely on a separate runtime engine to execute them.
15The runtime engine is in charge of isolating the test programs from the
16rest of the system to ensure that their results are deterministic and that
17they cannot affect the running system.  The runtime engine is also
18responsible for gathering the results of all tests and composing reports.
19The current runtime of choice is Kyua.
20
21
22Other documents
23***************
24
25* AUTHORS: List of authors and contributors for this project.
26
27* COPYING: License information.
28
29* INSTALL: Compilation and installation instructions.  These is not the
30  standard document shipped with many packages, so be sure to read it for
31  things that are specific to ATF's build.
32
33* NEWS: List of major changes between formal, published releases.
34
35
36===========================================================================
37vim: filetype=text:textwidth=75:expandtab:shiftwidth=2:softtabstop=2
38

README.md

1# Welcome to the ATF project!
2
3ATF, or Automated Testing Framework, is a **collection of libraries** to
4write test programs in **C, C++ and POSIX shell**.
5
6The ATF libraries offer a simple API.  The API is orthogonal through the
7various bindings, allowing developers to quickly learn how to write test
8programs in different languages.
9
10ATF-based test programs offer a **consistent end-user command-line
11interface** to allow both humans and automation to run the tests.
12
13ATF-based test programs **rely on an execution engine** to be run and
14this execution engine is *not* shipped with ATF.
15**[Kyua](https://github.com/jmmv/kyua/) is the engine of choice.**
16
17## Download
18
19Formal releases for source files are available for download from GitHub:
20
21* [atf 0.20](../../releases/tag/atf-0.20), released on February 7th, 2014.
22
23## Installation
24
25You are encouraged to install binary packages for your operating system
26wherever available:
27
28* Fedora 20 and above: install the `atf` package with `yum install atf`.
29
30* FreeBSD 10.0 and above: install the `atf` package with `pkg install atf`.
31
32* NetBSD with pkgsrc: install the `pkgsrc/devel/atf` package.
33
34* OpenBSD: install the `devel/atf` package with `pkg_add atf`.
35
36Should you want to build and install ATF from the source tree provided
37here, follow the instructions in the [INSTALL file](INSTALL).
38
39## Support
40
41Please use the
42[atf-discuss mailing list](https://groups.google.com/forum/#!forum/atf-discuss)
43for any support inquiries related to `atf-c`, `atf-c++` or `atf-sh`.
44
45If you have any questions on Kyua proper, please use the
46[kyua-discuss mailing list](https://groups.google.com/forum/#!forum/kyua-discuss)
47instead.
48