Name Date Size #Lines LOC

..--

admin/H--1,107605

bootstrap/H--517332

cli/H--6,8493,920

doc/H--3,1252,748

drivers/H--2,5201,428

engine/H--14,6148,665

examples/H--389294

integration/H--5,4043,671

m4/H--2,0411,733

misc/H--433286

model/H--5,1652,792

os/freebsd/H--809336

store/H--8,8784,796

utils/H--45,68925,597

.cirrus.ymlH A D18-Jan-2024707 2624

.gitignoreH A D23-Mar-2020201 2422

.travis.ymlH A D23-Mar-20201.3 KiB5035

AUTHORSH A D16-Jul-2024382 1412

CONTRIBUTING.mdH A D23-Mar-20207.4 KiB174127

CONTRIBUTORSH A D23-Mar-2020716 2119

Doxyfile.inH A D23-Mar-20202.3 KiB6058

INSTALL.mdH A D23-Mar-20208.8 KiB269191

KyuafileH A D23-Mar-2020468 1916

LICENSEH A D23-Mar-20201.4 KiB2824

Makefile.amH A D23-Mar-20206.2 KiB187128

NEWS.mdH A D23-Mar-202025.7 KiB623448

README.mdH A D23-Mar-20202.6 KiB8555

configure.acH A D23-Mar-20205.4 KiB174146

main.cppH A D16-Jul-20242.3 KiB548

README.md

1Welcome to the Kyua project!
2============================
3
4Kyua is a **testing framework** for infrastructure software, originally
5designed to equip BSD-based operating systems with a test suite.  This
6means that Kyua is lightweight and simple, and that Kyua integrates well
7with various build systems and continuous integration frameworks.
8
9Kyua features an **expressive test suite definition language**, a **safe
10runtime engine** for test suites and a **powerful report generation
11engine**.
12
13Kyua is for **both developers *and* users**, from the developer applying a
14simple fix to a library to the system administrator deploying a new release
15on a production machine.
16
17Kyua is **able to execute test programs written with a plethora of testing
18libraries and languages**.  The library of choice is
19[ATF](https://github.com/jmmv/atf/), for which Kyua was originally
20designed, but simple, framework-less test programs and TAP-compliant test
21programs can also be executed through Kyua.
22
23Kyua is licensed under a **[liberal BSD 3-clause license](LICENSE)**.
24This is not an official Google product.
25
26[Read more about Kyua in the About wiki page.](../../wiki/About)
27
28
29Download
30--------
31
32The latest version of Kyua is 0.13 and was released on August 26th, 2016.
33
34Download: [kyua-0.13](../../releases/tag/kyua-0.13).
35
36See the [release notes](NEWS.md) for information about the changes in this
37and all previous releases.
38
39
40Installation
41------------
42
43You are encouraged to install binary packages for your operating system
44wherever available:
45
46* Fedora 20 and above: install the `kyua-cli` package with `yum install
47  kyua-cli`.
48
49* FreeBSD 10.0 and above: install the `kyua` package with `pkg install kyua`.
50
51* NetBSD with pkgsrc: install the `pkgsrc/devel/kyua` package.
52
53* OpenBSD with packages: install the `kyua` package with `pkg_add kyua`.
54
55* OS X (with Homebrew): install the `kyua` package with `brew install kyua`.
56
57Should you want to build and install Kyua from the source tree provided
58here, follow the instructions in the
59[INSTALL.md file](INSTALL.md).
60
61You should also install the ATF libraries to assist in the development of
62test programs.  To that end, see the
63[ATF project page](https://github.com/jmmv/atf/).
64
65
66Contributing
67------------
68
69Want to contribute?  Great!  But please first read the guidelines provided
70in [CONTRIBUTING.md](CONTRIBUTING.md).
71
72If you are curious about who made this project possible, you can check out
73the [list of copyright holders](AUTHORS) and the [list of
74individuals](CONTRIBUTORS).
75
76
77Support
78-------
79
80Please use the [kyua-discuss mailing
81list](https://groups.google.com/forum/#!forum/kyua-discuss) for any support
82inquiries.
83
84*Homepage:* https://github.com/jmmv/kyua/
85