Scroll to navigation

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 Martín <cleto.martin@gmail.com>

Wrote this manpage for the Debian system.

COPYRIGHT

Copyright © 2009 Cleto Martín

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.

02/24/2019 atheist