Fuego wiki

Login or create account

Test Script APIs

This page documents the Fuego core scripts functions.

The following functions are available to test scripts.

FIXTHIS - core functions: should document which of the functions are internal, and which are intended for test script use

list of routines (by providing script) [edit section]

from functions.sh

from common.sh

  • abort_job - abort the current test, emitting a reason string to output
  • assert_define - to be used externally - check that an environment variable is defined
  • run_python
  • dprint - print a 'debug' message
  • vprint - print a 'verbose' message
  • iprint - print an 'info' message
  • wprint - print a 'warning' message
  • eprint - print an 'error' message

from reports.sh

from overlays.sh

  • set_overlay_vars - internal - process overlays and set variables for board, platform, test plan and test specs

FIXTHIS - need to document the ov_* functions as well, from the scripts in the engine/overlays/base directory.

From base-distrib.fuegoclass:

From base-board.fuegoclass:

From base-funcs.fuegoclass:

From fuego_test.sh (in alphabetical order):

NOTE: phases are: pre_check, build, deploy, run, fetch_results, post_test, processing

Here are some known problems:

  • references to /home/jenkins
  • reference to OF_ROOT (not used anywhere)
  • some functions have been removed during refactoring
    • bench_processing
  • some functions have been added
    • (need to scan functions.sh, common.sh, etc.)
  • need to add functions that have pages, but are not linked to here
  • need to check on what replaced a function:
    • build_error - to be used externally - report an error and abort the test
      • was used 44 times in fuego 1.0
        • all but 4 were from "| && touch ../test_suite_ready || build_error ..."
      • still called by Functional.ft2demos/fuego_test.sh

TBWiki engine 1.8.2 by Tim Bird