mirror of https://github.com/opnsense/src.git synced 2026-02-18 18:20:26 -05:00

History

Dag-Erling Smørgrav 84a5cebd36 atf, kyua: Implement require.kmods. This adds a metadata variable, require.kmods, and corresponding functions or methods in C, C++, and shell, which allow a test to specify that it requires particular kernel modules to run. If the kernel modules are not present, the test is skipped. One might want to consider a kyua option which makes it attempt to load the modules instead. Differential Revision: https://reviews.freebsd.org/D47470 (cherry picked from commit 83a1ee578c9d1ab7013e997289c7cd470c0e6902)		2025-10-07 12:08:43 +02:00
..
admin
bootstrap
cli	kyua: Do not count skipped as passed in test cmd	2024-10-17 13:45:21 +00:00
doc	kyua: Support require.diskspace ATF metadata	2025-03-04 21:09:11 +00:00
drivers	kyua: Add FreeBSD Jail execution environment support	2024-10-17 13:44:34 +00:00
engine	atf, kyua: Implement require.kmods.	2025-10-07 12:08:43 +02:00
examples	kyua: Add FreeBSD Jail execution environment support	2024-10-17 13:44:34 +00:00
integration	kyua: Pass unprivileged user config prop to ATF using all known names	2025-03-16 10:46:22 +00:00
m4
misc
model	atf, kyua: Implement require.kmods.	2025-10-07 12:08:43 +02:00
os/freebsd	kyua: Add FreeBSD Jail execution environment support	2024-10-17 13:44:34 +00:00
store
utils	kyua: Stop using readdir_r()	2025-08-11 11:14:49 +02:00
.gitignore
.travis.yml
AUTHORS	kyua: Add FreeBSD Jail execution environment support	2024-10-17 13:44:34 +00:00
configure.ac
CONTRIBUTING.md
CONTRIBUTORS
Doxyfile.in
INSTALL.md
Kyuafile
LICENSE
main.cpp	kyua: Add FreeBSD Jail execution environment support	2024-10-17 13:44:34 +00:00
Makefile.am
NEWS.md
README.md

README.md

Welcome to the Kyua project!

Kyua is a testing framework for infrastructure software, originally designed to equip BSD-based operating systems with a test suite. This means that Kyua is lightweight and simple, and that Kyua integrates well with various build systems and continuous integration frameworks.

Kyua features an expressive test suite definition language, a safe runtime engine for test suites and a powerful report generation engine.

Kyua is for both developers and users, from the developer applying a simple fix to a library to the system administrator deploying a new release on a production machine.

Kyua is able to execute test programs written with a plethora of testing libraries and languages. The library of choice is ATF, for which Kyua was originally designed, but simple, framework-less test programs and TAP-compliant test programs can also be executed through Kyua.

Kyua is licensed under a liberal BSD 3-clause license. This is not an official Google product.

Download

The latest version of Kyua is 0.13 and was released on August 26th, 2016.

Download: kyua-0.13.

See the release notes for information about the changes in this and all previous releases.

Installation

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

Fedora 20 and above: install the kyua-cli package with yum install kyua-cli.
FreeBSD 10.0 and above: install the kyua package with pkg install kyua.
NetBSD with pkgsrc: install the pkgsrc/devel/kyua package.
OpenBSD with packages: install the kyua package with pkg_add kyua.
OS X (with Homebrew): install the kyua package with brew install kyua.

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

You should also install the ATF libraries to assist in the development of test programs. To that end, see the ATF project page.

Contributing

Want to contribute? Great! But please first read the guidelines provided in CONTRIBUTING.md.

If you are curious about who made this project possible, you can check out the list of copyright holders and the list of individuals.

Support

Please use the kyua-discuss mailing list for any support inquiries.

Homepage: https://github.com/jmmv/kyua/