Skip to content

wake_phrases

wake_phrases

Wake-word phrase matching (Diapason-style text gate for « Diapason »).

Functions:

build_wake_pattern 

build_wake_pattern(
    variants: Sequence[str] | None = None,
    prefixes: Sequence[str] | None = None,
) -> Pattern[str]

Match wake phrase at the start of an utterance.

Source code in src/diapason/speech/wake_phrases.py 
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
def build_wake_pattern(
    variants: Sequence[str] | None = None,
    prefixes: Sequence[str] | None = None,
) -> re.Pattern[str]:
    """Match wake phrase at the start of an utterance."""
    vars_ = tuple(variants) if variants else DEFAULT_WAKE_VARIANTS
    prefs = tuple(prefixes) if prefixes else DEFAULT_WAKE_PREFIXES
    # Sort longer first
    vars_sorted = sorted(
        {v.strip().lower() for v in vars_ if v.strip()}, key=len, reverse=True
    )
    prefs_sorted = sorted(
        {p.strip().lower() for p in prefs if p.strip()}, key=len, reverse=True
    )
    variant_group = "|".join(_escape(v) for v in vars_sorted)
    prefix_group = "|".join(_escape(p) for p in prefs_sorted)
    # Name alone OR prefix + name; require separator or end after name.
    # If variant already includes prefix (hey diapason), still OK.
    pattern = rf"^(?:(?:{prefix_group}){_SEP}*)?(?:{variant_group})(?:{_SEP}+|$)"
    return re.compile(pattern, re.IGNORECASE)

has_wake_word 

has_wake_word(
    text: str, *, pattern: Pattern[str] | None = None
) -> bool

True if text opens with an address to Diapason.

Source code in src/diapason/speech/wake_phrases.py 
69
70
71
72
73
74
75
76
77
78
def has_wake_word(
    text: str,
    *,
    pattern: re.Pattern[str] | None = None,
) -> bool:
    """True if text opens with an address to Diapason."""
    t = (text or "").strip()
    if not t:
        return False
    return bool((pattern or _DEFAULT_PATTERN).search(t))

strip_wake_word 

strip_wake_word(
    text: str, *, pattern: Pattern[str] | None = None
) -> str

Remove leading wake address. « Diapason, ouvre YouTube » → « ouvre YouTube ».

Source code in src/diapason/speech/wake_phrases.py 
81
82
83
84
85
86
87
88
89
90
def strip_wake_word(
    text: str,
    *,
    pattern: re.Pattern[str] | None = None,
) -> str:
    """Remove leading wake address. « Diapason, ouvre YouTube » → « ouvre YouTube »."""
    t = (text or "").strip()
    if not t:
        return ""
    return (pattern or _DEFAULT_PATTERN).sub("", t, count=1).strip(" ,.-")