link#

link(*files: str, src: str | None = None, dst: str | None = None, when: str | dict[str, str] | None = None) → None#

Link files from the source directory into the execution directory.

Usage#

.pyt:

import canary
canary.directives.link(*files, when=...)
canary.directives.link(src=..., dst=..., when=...)

.vvt:

#VVT: link (rename, options=..., platforms=..., parameters=..., testname=...) : files ...

The when expression is limited to the following conditions:

testname: Restrict processing of the directive to this test name
platforms: Restrict processing of the directive to certain platform or platforms
options: Restrict processing of the directive to command line -o options
parameters: Restrict processing of the directive to certain parameter names and values

Note

The files positional arguments and src,dst keyword arguments are mutually exclusive.

Link files input.txt and helper.py from the source directory to the execution directory

import canary
canary.directives.link("input.txt", "helper.py")

#VVT: link : input.txt helper.py

Link files file1.txt and file2.txt from the source directory to the execution directory and rename them

import canary
canary.directives.link(src="file1.txt", dst="file1_link.txt")
canary.directives.link(src="file2.txt", dst="file2_link.txt")

#VVT: link (rename) : file1.txt,file1_link.txt file2.txt,file2_link.txt