Diff for /wikisrc/kyua.mdwn between versions 1.6 and 1.10

version 1.6, 2012/09/01 19:32:25 version 1.10, 2016/03/17 02:32:16
Line 1 Line 1
 [[!meta title="Kyua: An introduction for NetBSD users"]]  [[!meta title="Kyua: An introduction for NetBSD users"]]
   
   **Contents**
   
 [[!toc levels=2]]  [[!toc levels=2]]
   
 The [Automated Testing Framework](ATF), or ATF for short, is a software  The [Automated Testing Framework](ATF), or ATF for short, is a software
Line 111  results into a single report.  At the mo Line 114  results into a single report.  At the mo
   also lower the barrier of entry to writing test programs for NetBSD, as    also lower the barrier of entry to writing test programs for NetBSD, as
   using the ATF libraries will become optional.    using the ATF libraries will become optional.
   
   These interfaces are implemented as independent binaries, called testers,
   that are fully scriptable.  The testers are provided in the `kyua-testers`
   package.  The idea behind having these as independent programs is to
   restrict the OS-specific code to a small subset of Kyua written in C, and
   thus to allow the higher-level layers to be written in other languages
   (possibly Lua).
   
 ## Lua configuration files  ## Lua configuration files
   
 Kyua has two kind of configuration files: the Kyuafiles, which are the  Kyua has two kind of configuration files: the Kyuafiles, which are the
Line 166  Kyua, as a project, is made up of a vari Line 176  Kyua, as a project, is made up of a vari
 ATF, because the ATF libraries are *not* being rewritten).  All of these  ATF, because the ATF libraries are *not* being rewritten).  All of these
 components exist in pkgsrc, and are:  components exist in pkgsrc, and are:
   
 * pkgsrc/devel/atf-libs: The C, C++ and POSIX shell libraries provided by  
   ATF.  These are *NOT* meant to be replaced by Kyua.  
   
 * pkgsrc/devel/atf: The ATF tools, namely atf-run and atf-report.  These  * pkgsrc/devel/atf: The ATF tools, namely atf-run and atf-report.  These
   are deprecated and this package should eventually disappear.    are deprecated and this package should eventually disappear.
   
 * pkgsrc/devel/kyua-cli: The Kyua command-line interface, which provides a  * pkgsrc/devel/kyua: The Kyua command-line interface, which provides a
   superset of the functionality of atf-run and atf-report.    superset of the functionality of atf-run and atf-report.
   
 * pkgsrc/devel/kyua-atf-compat: Drop-in replacements for atf-run and  
   atf-report that use kyua-cli in the backend.  
   
 # Running the NetBSD test suite  # Running the NetBSD test suite
   
 There are two ways to run the NetBSD test suite with Kyua.  The easy (or  There are two ways to run the NetBSD test suite with Kyua.  The easy (or
Line 191  The easiest (but also the least "future- Line 195  The easiest (but also the least "future-
 suite with Kyua is to use the backwards compatibility ATF tools provided by  suite with Kyua is to use the backwards compatibility ATF tools provided by
 the kyua-atf-compat module.  First of all, install the package:  the kyua-atf-compat module.  First of all, install the package:
   
     $ cd /usr/pkgsrc/deve/kyua-atf-compat      $ cd /usr/pkgsrc/devel/kyua-atf-compat
     $ make install && make clean      $ make install && make clean
   
 And then, running the test suite is as easy as:  And then, running the test suite is as easy as:
Line 227  Using the native command-line interface  Line 231  Using the native command-line interface 
 the existing NetBSD test suite is not prepared for Kyua.  Let's take a look  the existing NetBSD test suite is not prepared for Kyua.  Let's take a look
 at these steps.  at these steps.
   
 To get started, install the Kyua packages:  To get started, install the Kyua package:
   
     $ cd /usr/pkgsrc/deve/kyua-cli      $ cd /usr/pkgsrc/devel/kyua
     $ make install && make clean      $ make install clean
     $ cd /usr/pkgsrc/deve/kyua-atf-compat  
     $ make install && make clean  
   
 Once this is done, configure Kyua in the same way ATF is configured "out of  Once this is done, configure Kyua in the same way ATF is configured "out of
 the box" in NetBSD.  Create the /usr/pkg/etc/kyua/kyua.conf file with these  the box" in NetBSD.  Create a /usr/pkg/etc/kyua/kyua.conf file containing:
 contents:  
   
     syntax('config', 1)      syntax('config', 1)
     unprivileged_user = '_tests'      unprivileged_user = '_tests'

Removed from v.1.6  
changed lines
  Added in v.1.10


CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb