joythief.objects module

Matchers for general object types.

class joythief.objects.Anything(*args, **kwargs)

Bases: Matcher[Any]

Matches anything at all.

Added in version 0.5.0.

The JoyThief version of unittest.mock.ANY.

Parameters:

• args (tp.Any)

• kwargs (tp.Any)

class joythief.objects.InstanceOf(type_, *, nullable=False)

Bases: Generic[T], Matcher[T]

Matches any instance of the specified type(s).

This matcher compares the received value using isinstance(), so accepts either a single type or a tuple of types. With nullable set to True, the received value can also be None.

Originally formulated for this answer.

Parameters:

• type_ (type[T] | tuple[type[T], ...])

• nullable (bool)

class joythief.objects.Nothing(*args, **kwargs)

Bases: Matcher[Any]

Matches nothing at all.

Added in version 0.8.0.

Parameters:

• args (tp.Any)

• kwargs (tp.Any)

class joythief.objects.Nullable(value)

Bases: Generic[T], Matcher[T | None]

Adds None to the supplied value or matcher.

Matcher equivalent of typing.Optional.

Added in version 0.8.0.

Parameters:

value (T | Matcher[T])