joythief.strings module

Matchers for the text sequence type (str).

class joythief.strings.JsonString(expected=<object object>)

Bases: Matcher[str]

Matches any str instance representing JSON.

Parameters:

expected (Any) – What the result of parsing the JSON should be. If omitted, any valid JSON string is matched.

class joythief.strings.StringMatching(pattern: Pattern[str])

class joythief.strings.StringMatching(pattern: str, *, flags: int = 0)

Bases: Matcher[str]

Matches any str instance matching a regular expression.

Parameters:

• pattern (str | Pattern[str]) – Regex pattern to match, as a string or compiled pattern.

• flags (int) – Any flags to compile a str pattern with

Raises:

ValueError – if flags are provided with a pre-compiled pattern.

class joythief.strings.UrlString(*, scheme=None, hostname=None, path=None, query=None)

Bases: Matcher[str]

Matches any str instance representing a URL.

The string is parsed with urlparse() and compared attribute-by-attribute. Any attributes not provided are ignored.

Parameters:

• scheme (str | Matcher[str] | None) – the scheme (e.g. "https")

• hostname (str | Matcher[str] | None) – the hostname (e.g. "example.com")

• path (str | Matcher[str] | None) – the path (e.g. "/some/path")

• query (Mapping[str, Sequence[str]] | None) – the result of parsing the query string with parse_qs()

Raises:

TypeError – if no arguments are provided.