beakerlib-libraries (1) - Linux Manuals

beakerlib-libraries: libraries - mechanism for loading shared test code from libraries

Command to display beakerlib-libraries manual in Linux: $ man 1 beakerlib-libraries

NAME

BeakerLib - libraries - mechanism for loading shared test code from libraries

DESCRIPTION

This file contains functions for bringing external code into the test namespace.

FUNCTIONS

rlImport

Imports code provided by one or more libraries into the test namespace. The library search mechanism is based on Beaker test hierarchy system, i.e.:

/component/type/test-name/test-file

When test-file calls rlImport with 'foo/bar' parameter, the directory path is traversed upwards, and a check for presence of the test /foo/Library/bar/ will be performed. This means this function needs to be called from the test hierarchy, not e.g. the /tmp directory.

Once library is found, it is sourced and a verifier function is called. The verifier function is cunstructed by composing the library prefix and LibraryLoaded. Library prefix can be defined in the library itself. If the verifier passes the library is ready to use. Also variable <PREFIX>LibraryDir is created and it points to the library folder.

Usage:

    rlImport --all
    rlImport LIBRARY [LIBRARY2...]

--all: Read Makefile in current/original directory, pick library requirements up and import them all.
LIBRARY: Must have 'component/library' format. Identifies the library to import.

Returns 0 if the import of all libraries was successful. Returns non-zero if one or more library failed to import.

AUTHORS

•: Petr Muller <muller [at] redhat.com>
•: Dalibor Pospisil <dapospis [at] redhat.com>