beakerlib-libraries man page

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@redhat.com>
·
Dalibor Pospisil <dapospis@redhat.com>

Info

2016-12-23 perl v5.24.0 User Contributed Perl Documentation