example/file - example of a beakerlib library
This is a trivial example of a BeakerLib library. It's main goal is to provide a minimal template which can be used as a skeleton when creating a new library. It implements function fileCreate(). Please note, that all library functions must begin with the same prefix which is defined at the beginning of the library.
Below is the list of global variables. When writing a new library, please make sure that all global variables start with the library prefix to prevent collisions with other libraries.
fileFILENAME
Default file name to be used when no provided ('foo').
Create a new file, name it accordingly and make sure (assert) that the file is successfully created.
fileCreate [filename]filename
Name for the newly created file. Optionally the filename can be provided in the FILENAME environment variable. When no file name is given 'foo' is used by default.
Returns 0 when the file is successfully created, non-zero otherwise.
This library supports direct execution. When run as a task, phases provided in the PHASE environment variable will be executed. Supported phases are:
Create
Create a new empty file. Use FILENAME to provide the desired file name. By default 'foo' is created in the current directory.
Test
Run the self test suite.