NAME
atheist - a general prupose test framework.
SYNOPSIS
atheist [options] {{directory | file}}
DESCRIPTION
atheist allows you to specify the behaviour of your tests in a
declarative way using many data structures (such us Tasks, Conditions,
Daemons, etc.) and provides detailed statistic results. The main idea
is that the programmer may describes the test behaviour in a .test file
and atheist runs every tests found. It is possible to check and prepare
the system by writting setup and teardown files that are executed after
and before each test.
Each test is represented by Task object which have many configuration
attributes such us execution delay, termination signal expected and
many others. Tasks have pre and post conditions that are been checked
at execution time. You may save the test output and compose Conditions
objects to assure concrete states of the system during the tests
execution.
atheist free all resources used by the user automatically at the end of
the execution. See the Atheist manual for more information about data
structures and tools provided by the framework.
This manual page was written for the Debian distribution because the
original program does not have a manual page. Instead, it has
documentation in the GNU info(1) format; see below.
OPTIONS
-a TASK_ARGS, --task-args=TASK_ARGS
Colon-separated arguments for the tasks.
-b BASE_DIR, --base-dir=BASE_DIR
Change working directory.
-C, --clean-only
Execute nothing, only remove generated files.
--cols=SCREEN_WIDTH
Terminal width (in chars).
-d, --describe
Execute nothing, only describe tasks.
--dirty
Do not remove generated files after task execution.
-e, --stderr
Print task process stderr.
-f, --stdout-on-fail
Print task output only if it fails.
-g, --gen-template
Generate a TaskCase file template with default values.
-h, --help
Show the help message.
-i REPORT_DETAIL, --report-detail=REPORT_DETAIL
Report verbosity (0:nothing, [1:case], 2:task, 3:condition).
-j, --skip-setup
Skip _setup and _teardown files.
-k, --keep-going
Continue even with failed tasks.
-l, --list
Execute nothing, only list tasks names.
--log=LOG
Log to specified filename.
--notify-jabber=JABBER
Notify failed tasks to the given jabber account.
--notify-smtp=MAIL
notify failed taks to the given email address.
-r RANDOM, --random=RANDOM
Run taskcases in random order using the specified seed.
-o, --stdout
Print task stdout.
-p PLUGINPATH, --plugin_dir=PLUGINPATH
A directory containing plugins.
-q, --quiet
Do not show result summary nor warnings, only totals.
-s INLINE, --script=INLINE
Specifies command line script.
-t, --time-tag
Include time info in the logs.
-u, --until-failure
Repeat test until it fails.
-v, --verbose
Incresse verbosity.
-w WORKERS, --workers=WORKERS
number of simultaneous Tasks (deafult:1) 0:auto-select.
-x EXT, --extension=EXT
File extension for the task files.
AUTHOR
Cleto Martin <cleto.martin@gmail.com>
Wrote this manpage for the Debian system.
COPYRIGHT
Copyright © 2009 Cleto Martin Angelina
This manual page was written for the Debian system (and may be used by
others).
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 3 or (at
your option) any later version published by the Free Software
Foundation.
On Debian systems, the complete text of the GNU General Public License
can be found in /usr/share/common-licenses/GPL-3.