toolrack.testing¶

Unit-test features.

class toolrack.testing.Dir(path: pathlib.Path)¶

A helper for creating files and directories under a base directory.

This is meant to be used for test fixtures.

mkdir(path=None)¶

Create a temporary directory and return the pathlib.Path.

By default, a random name is chosen.

Parameters:	path – if specified, it’s appended to the base directory and all intermiediate directories are created too. A relative path must be specified. A tuple of strings can be also passed, in which case elements are joined using `os.path.sep()`.

mkfile(path=None, content='', mode=None)¶

Create a temporary file and return the pathlib.Path.

By default, a random name is chosen.

Parameters:	path – if specified, it’s appended to the base directory and all intermiediate directories are created too. A relative path must be specified. A tuple of strings can be also passed, in which case elements are joined using `os.path.sep()`. content (str) – the content of the file. mode (int) – Unix permissions for the file.

mksymlink(target, path=None)¶

Create a symbolic link and return the pathlib.Path.

By default, a random name is chosen.

Parameters:	target – path of the symlink target. path – if specified, it’s appended to the base directory and all intermiediate directories are created too. A relative path must be specified. A tuple of strings can be also passed, in which case elements are joined using `os.path.sep()`.