AHjsdZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZeGd d eZGd d eZGd deZy)zO Contains the `Suggester` class, used by the [Input](/widgets/input) widget. ) annotations)ABCabstractmethod) dataclass)Iterable)LRUCache)DOMNode)Messagec(eZdZUdZded< ded<y)SuggestionReadyz+Sent when a completion suggestion is ready.strvalue suggestionN)__name__ __module__ __qualname____doc____annotations__I/root/tools/cai/cai_env/lib/python3.12/site-packages/textual/suggester.pyr r s5 J3O rr cHeZdZUdZded< dddd dZd dZed d Zy ) 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_sensitivec:|r tdnd|_||_y)a+Create 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)selfrrs r__init__zSuggester.__init__'s(1Xd^d ,rcDK|jr|n|j}|j||jvr5|j|d{}|j||j|<n|j|}|y|j t ||y7Nw)a7Used 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)rcasefoldrget_suggestion post_messager )r requesterrnormalized_valuers r_get_suggestionzSuggester._get_suggestion3s%)$7$75U^^=M :: !1!C#223CDDJzz%/9 +,$45J   ujABEsA B BAB c Kyw)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)rrs rr"zSuggester.get_suggestionKs $ sN)rboolrr(returnNone)r$r rr r)r*rr r)z str | None) rrrrrrr&rr"rrrrrs6 ,+$,0 -C0  rrc<eZdZdZdd dfdZddZxZS)SuggestFromListaGive 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. Trct||t||_|jr|j|_y|jDcgc]}|j c}|_ycc}w)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. r.N)superrlist _suggestionsrr!_for_comparison)r suggestionsrr __class__s rrzSuggestFromList.__init__psm 7 -""    ;?:K:KLJ*%%'L MsA.cKt|jD]'\}}|j|s|j|cSyw)zGets a completion from the given possibilities. Args: value: The current value. Returns: A valid completion suggestion or `None`. N) enumerater3 startswithr2)rridxrs rr"zSuggestFromList.get_suggestionsJ ))=)=> .OC$$U+((-- .s -AA)r4z Iterable[str]rr(r)r*r+)rrrrrr" __classcell__)r5s@rr-r-`s1  EI ( =A  ( rr-N)r __future__rabcrr dataclassesrtypingr textual.cacher textual.domr textual.messager r rr-rrrrBsW ##!"# !g! !A A H0i0r