2.3. hook module

class hook.Hook(logger)

Bases: object

Generic hooks before/after API/CLI calls

after_api(api_name, api_args)

Function called after API call

@param api_name: name of the API @param api_args: tuple containing the API arguments

after_cli(cli)

Function called after CLI call

before_api(api_name, api_args)

Function called before API call Emit a debug message describing the API name and arguments

@param api_name: name of the API @param api_args: tuple containing the API arguments

before_cli(cli)

Function called before CLI call Emit a debug message describing the CLI

@param cli: CLI string

class hook.PollHook(testcase)

Bases: hook.Hook

Hook which checks if the vpp subprocess is alive

before_api(api_name, api_args)

Check if VPP died before executing an API

Parameters:

• api_name – name of the API
• api_args – tuple containing the API arguments

Raises:

VppDiedError – exception if VPP is not running anymore

before_cli(cli)

Check if VPP died before executing a CLI

Parameters:cli – CLI string Raises:Exception – exception if VPP is not running anymore

on_crash(core_path)

poll_vpp()

Poll the vpp status and throw an exception if it’s not running :raises VppDiedError: exception if VPP is not running anymore

spawn_gdb(gdb_path, core_path)

class hook.StepHook(testcase)

Bases: hook.PollHook

Hook which requires user to press ENTER before doing any API/CLI

before_api(api_name, api_args)

Wait for ENTER before executing API

before_cli(cli)

Wait for ENTER before executing CLI

skip()

user_input()

exception hook.VppDiedError

Bases: exceptions.Exception