Source code for phantom.predicates.re

from typing import Pattern

from . import Predicate
from ._utils import bind_name


def is_match(pattern: Pattern[str]) -> Predicate[str]:
    """
    Create a new predicate that succeeds when the start of its argument matches the
    given ``pattern``.
    """

    @bind_name(is_match, pattern.pattern)
    def match(instance: str) -> bool:
        return pattern.match(instance) is not None

    return match


def is_full_match(pattern: Pattern[str]) -> Predicate[str]:
    """
    Create a new predicate that succeeds when its whole argument matches the given
    ``pattern``.
    """

    @bind_name(is_full_match, pattern.pattern)
    def full_match(instance: str) -> bool:
        return pattern.fullmatch(instance) is not None

    return full_match