atheist

Langue: en

Version: 05/13/2010 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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 © 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.