ATHEIST(1) atheist User Manual ATHEIST(1)
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 ARGS, --task-args=ARGS
Colon-separated arguments for the tasks.
-b PATH, --base-dir=PATH
Change working directory.
-C, --clean-only
Execute nothing, only remove generated files.
-d, --describe
Execute nothing, only describe tasks.
--dirty
Do not remove generated files after task execution.
-e, --stderr
Print task process stderr.
-f, --out-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 LEVEL, --report-detail=LEVEL
Report verbosity (0:nothing, [1:case], 2:task, 3:condition).
-j, --skip-hooks
Skip _setup and _teardown files.
-k, --keep-going
Continue even with failed tasks.
-l, --list
Execute nothing, only list tasks names.
-r RANDOM, --random=RANDOM
Run taskcases in random order using the specified seed.
-o, --stdout
Print task stdout.
-p PATH, --plugin-dir=PATH
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.
--version
Atheist version.
-w WORKERS, --workers=WORKERS
number of simultaneous Tasks (deafult:1) 0:auto-select.
-x COMMAND, --exec=COMMAND
Exec COMMAND like in "Test(COMMAND, shell=True)".
--case-time
Print case execution time in reports.
--cols=WIDTH
Terminal width (in chars).
--config=FILE
Alternate config file.
--disable-bar
Don't show progress bar.
--ignore=PATTERN
files to ignore (glob patterns) separated with semicolon.
--log=LOG
Log to specified filename.
--plain
Avoid color codes in console output.
--save-stdout
Save stdout of all tasks.
--save-stderr
Save stderr of all tasks.
--notify-jabber=JABBER
Notify failed tasks to the given jabber account.
--notify-smtp=MAIL
notify failed taks to the given email address.
AUTHOR
Cleto Martin <cleto.martin@gmail.com>
Wrote this manpage for the Debian system.
COPYRIGHT
Copyright (C) 2009 Cleto Martin
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.
atheist 02/21/2012 ATHEIST(1)