CjsSrSSKJr SSKJrJr SSKJr SSKJ r SSK J r SSK J r SSKJr \"S S \55r"S S \5r"S S\5rg)zO Contains the `Suggester` class, used by the [Input](/widgets/input) widget. ) annotations)ABCabstractmethod) dataclass)Iterable)LRUCache)DOMNode)Messagec0\rSrSr%SrS\S'S\S'Srg)SuggestionReadyz+Sent when a completion suggestion is ready.strvalue suggestionN)__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__rc/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/textual/suggester.pyr r s5 J3O rr cX\rSrSr%SrS\S'SSS.S SjjrSS jr\SS j5r S r g ) SuggesterzDefines how widgets generate completion suggestions. To define a custom suggester, subclass `Suggester` and implement the async method `get_suggestion`. See [`SuggestFromList`][textual.suggester.SuggestFromList] for an example. z LRUCache[str, str | None] | NonecacheTF) use_cachecase_sensitivecBU(a [S5OSUlX lg)zCreate a suggester object. Args: use_cache: Whether to cache suggestion results. case_sensitive: Whether suggestions are case sensitive or not. If they are not, incoming values are casefolded before generating the suggestion. iN)rrr )selfrr s r__init__Suggester.__init__'s(1Xd^d ,rcR# UR(aUOUR5nURbX0R;a5URU5IShvN nURbX@RU'OURUnUcgUR [ X$55 gNN7f)zUsed by widgets to get completion suggestions. Note: When implementing custom suggesters, this method does not need to be overridden. Args: requester: The message target that requested a suggestion. value: The current value to complete. N)r casefoldrget_suggestion post_messager )r" requesterrnormalized_valuers r_get_suggestionSuggester._get_suggestion3s%)$7$75U^^=M :: !1!C#223CDDJzz%/9 +,$45J   uABEsAB'B%AB'c # g7f)aTry to get a completion suggestion for the given input value. Custom suggesters should implement this method. Note: The value argument will be casefolded if `self.case_sensitive` is `False`. Note: If your implementation is not deterministic, you may need to disable caching. Args: value: The current value of the requester widget. Returns: A valid suggestion or `None`. Nr)r"rs rr'Suggester.get_suggestionKs $ s)rr N)rboolr r/returnNone)r)r rrr0r1rrr0z str | None) rrrrrrr#r+rr'rrrrrrs6 ,+$,0 -C0  rrcL^\rSrSrSrSS.SU4SjjjrS SjrSrU=r$) SuggestFromList`aGive completion suggestions based on a fixed list of options. Example: ```py countries = ["England", "Scotland", "Portugal", "Spain", "France"] class MyApp(App[None]): def compose(self) -> ComposeResult: yield Input(suggester=SuggestFromList(countries, case_sensitive=False)) ``` If the user types ++p++ inside the input widget, a completion suggestion for `"Portugal"` appears. Tr c>[TU]US9 [U5UlUR(aURUlgURVs/sHo3R 5PM snUlgs snf)aCreates a suggester based off of a given iterable of possibilities. Args: suggestions: Valid suggestions sorted by decreasing priority. case_sensitive: Whether suggestions are computed in a case sensitive manner or not. The values provided in the argument `suggestions` represent the canonical representation of the completions and they will be suggested with that same casing. r6N)superr#list _suggestionsr r&_for_comparison)r" suggestionsr r __class__s rr#SuggestFromList.__init__psq 7 -""    ;?:K:KL:KJ%%':KL MsA2c# [UR5H,up#URU5(dMURUs $ g7f)zGets a completion from the given possibilities. Args: value: The current value. Returns: A valid completion suggestion or `None`. N) enumerater; startswithr:)r"ridxrs rr'SuggestFromList.get_suggestionsE ))=)=>OC$$U++((-- ?s /A A )r;r:)r<z Iterable[str]r r/r0r1r2) rrrrrr#r'r __classcell__)r=s@rr4r4`s;  EI ( =A   (  rr4N)r __future__rabcrr dataclassesrtypingr textual.cacher textual.domr textual.messager r rr4rrrrLsW ##!"# !g! !A A H0i0r