Random

Random string generation utilities for test names.

Random helpers for libtmux and downstream libtmux libraries.

class libtmux.test.random.RandomStrSequence

Bases: object

Factory to generate random string.

Create a random letter / number generator. 8 chars in length.

>>> rng = RandomStrSequence()  # pragma: no cover
>>> next(rng)  # pragma: no cover
'...'
>>> len(next(rng))  # pragma: no cover
8
>>> type(next(rng))  # pragma: no cover
<class 'str'>

__init__(characters='abcdefghijklmnopqrstuvwxyz0123456789_')

Create a random letter / number generator. 8 chars in length.

>>> rng = RandomStrSequence()  # pragma: no cover
>>> next(rng)  # pragma: no cover
'...'
>>> len(next(rng))  # pragma: no cover
8
>>> type(next(rng))  # pragma: no cover
<class 'str'>

Parameters:

characters (str)

Return type:

None

libtmux.test.random.get_test_session_name(server, prefix='libtmux_')

Faker to create a session name that doesn’t exist.

Return type:

str

Parameters:

• server (libtmux.Server) – libtmux server

• prefix (str) – prefix for sessions (e.g. libtmux_). Defaults to TEST_SESSION_PREFIX.

Returns:

Random session name guaranteed to not collide with current ones.

Return type:

str

Examples

>>> get_test_session_name(server=server)  # pragma: no cover
'libtmux_...'

Never the same twice: >>> name1 = get_test_session_name(server=server) # pragma: no cover >>> name2 = get_test_session_name(server=server) # pragma: no cover >>> name1 != name2 # pragma: no cover True

libtmux.test.random.get_test_window_name(session, prefix='libtmux_')

Faker to create a window name that doesn’t exist.

Return type:

str

Parameters:

• session (libtmux.Session) – libtmux session

• prefix (str) –

  prefix for windows (e.g. libtmux_). Defaults to TEST_SESSION_PREFIX.

  ATM we reuse the test session prefix here.

Returns:

Random window name guaranteed to not collide with current ones.

Return type:

str

Examples

>>> get_test_window_name(session=session)  # pragma: no cover
'libtmux_...'

Never the same twice: >>> name1 = get_test_window_name(session=session) # pragma: no cover >>> name2 = get_test_window_name(session=session) # pragma: no cover >>> name1 != name2 # pragma: no cover True