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