e3.testsuite.utils

Miscellaneous helpers.

Attributes

EnumType

Classes

`DummyColors`	Stub to replace colorama's Fore/Style when colors are disabled.
`ColorConfig`	Proxy for color management.
`CleanupMode`	Mode for working space cleanups.

Functions

`isatty`(→ bool)	Return whether stream is a TTY.
`enum_to_cmdline_args_map`(→ Dict[str, EnumType])	Turn enum alternatives into command-line arguments.
`dump_environ`(→ None)	Dump environment variables into a sourceable file.
`indent`(→ str)	Prepend `prefix` to every line in `text`.

Module Contents

e3.testsuite.utils.isatty(stream: IO[AnyStr]) → bool

Return whether stream is a TTY.

This is a safe predicate: it works if stream is None or if it does not even support TTY detection: in these cases, be conservative (consider it’s not a TTY).

class e3.testsuite.utils.DummyColors

Stub to replace colorama’s Fore/Style when colors are disabled.

__getattr__(name: str) → str

class e3.testsuite.utils.ColorConfig(colors_enabled: bool | None = None)

Proxy for color management.

This embeds colorama’s Fore/Style, or DummyColors instances when colors are disabled.

Fore

Style

class e3.testsuite.utils.CleanupMode(*args, **kwds)

Bases: enum.Enum

Mode for working space cleanups.

NONE

PASSING

ALL

classmethod default() → CleanupMode

classmethod descriptions() → Dict[CleanupMode, str]

e3.testsuite.utils.EnumType

e3.testsuite.utils.enum_to_cmdline_args_map(enum_cls: Type[EnumType]) → Dict[str, EnumType]

Turn enum alternatives into command-line arguments.

This helps exposing enums for options on the command-line. This turns alternative names into lower case and replaces underscores with dashes.

e3.testsuite.utils.dump_environ(filename: str, env: e3.env.Env) → None: Dump environment variables into a sourceable file.

e3.testsuite.utils.indent(text: str, prefix: str = ' ') → str

Prepend prefix to every line in text.

Parameters:

text – Text to transform.
prefix – String to prepend.