include

include(file: str, *, when: str | dict[str, str] | None = None) → None

Include the contents of file at the point where the directive appears.

Usage

.pyt: NA

.vvt:

#VVT: include (options=..., platforms=...) : file
#VVT: insert directive file (options=..., platforms=...) : file

Parameters

• file: The file to include

• when: Restrict processing of the directive to this condition

The when expression is limited to the following conditions:

• platforms: Restrict processing of the directive to certain platform or platforms

• options: Restrict processing of the directive to command line -o options

Notes

• included files can include other files

• If file is a relative path, it is assumed relative to the file including it

• The alias insert directive file is also recognized

Examples

# VVT: include : file.txt

will include directives from file.txt into the current test.