plainbox - Online in the Cloud

PROGRAM:

NAME

plainbox - toolkit for software and hardware integration testing

SYNOPSIS

plainbox [--help] [--version] | [options] <command> ...

DESCRIPTION

Undocumented

Plainbox is a toolkit consisting of python3 library, development tools, documentation and
examples. It is targeted at developers working on testing or certification applications
and authors creating tests for such applications.

OPTIONS

Optional arguments:

--version
show program's version number and exit

-v, --verbose
be more verbose (same as --log-level=INFO)

-D, --debug
enable DEBUG messages on the root logger

-C, --debug-console
display DEBUG messages in the console

-T, --trace
enable DEBUG messages on the specified logger (can be used multiple times)

-P, --pdb
jump into pdb (python debugger) when a command crashes

-I, --debug-interrupt
crash on SIGINT/KeyboardInterrupt, useful with --pdb

PLAINBOX SUB-COMMANDS

Plainbox uses a number of sub-commands for performing specific operations. Since it
targets several different audiences commands are arranged into three parts: test authors,
test users and core developers

Test Users
plainbox run
Run a test job. This is the swiss army knife of a swiss army knife. Has lots of
options that affect job selection, execution and handling results.

plainbox check-config
check and display plainbox configuration. While this command doesn't allow to
edit any settings it is very useful for figuring out what variables are
available and which configuration files are consulted.

Test Authors
plainbox startprovider
Create a new provider (directory). This command allows test authors to create a
new collection (provider) of test definitions for Plainbox.

plainbox dev script
Run the command from a job in a way it would run as a part of normal run,
ignoring all dependencies / requirements and providing additional diagnostic
messages.

plainbox dev analyze
Analyze how selected jobs would be executed. Takes almost the same arguments as
plainbox run does. Additional optional arguments control the type of analysis
performed.

plainbox dev parse
Parse stdin with the specified parser. Plainbox comes with a system for plugging
parser definitions so that shell programs (and developers) get access to
structured data exported from otherwise hard-to-parse output.

plainbox dev list
List and describe various objects. Run without arguments to see all the
high-level objects Plainbox knows about. Optional argument can restrict the list
to objects of one kind.

Core Developers
plainbox self-test
Run unit and integration tests. Unit tests work also after installation so this
command can verify a local installation at any time.

plainbox dev special
Access to special/internal commands.

plainbox dev crash
Crash the application. Useful for testing the crash handler and crash log files.

plainbox dev logtest
Log messages at various levels. Useful for testing the logging system.

Use plainbox online using onworks.net services