AHj\UddlmZddlmZddlmZmZmZmZm Z m Z ddl Z ddl mZddlmZddlmZmZddlmZdd lmZmZdd lmZdd lmZdd lmZmZdd l m!Z!ddl"m#Z#ddl$m%Z%m&Z&er ddl'm(Z(ddl)m*Z*GddZ+e+Z,Gdde-Z.Gdde-Z/Gdde&Z0GddeZ1e deZ2 dZ3de4d < Gd!d"ee2ed#$Z5y)%) annotations) dataclass) TYPE_CHECKINGGenericHashableIterableTypeVarUnionN)RenderableType)Text)eventson)Binding) HorizontalVertical) NoMatches)Message)reactivevar)Timer)Static)Option OptionList) TypeAlias) ComposeResultceZdZdZddZy) NoSelectionzmUsed by the `Select` widget to flag the unselected state. See [`Select.BLANK`][textual.widgets.Select.BLANK].cy)Nz Select.BLANKselfs O/root/tools/cai/cai_env/lib/python3.12/site-packages/textual/widgets/_select.py__repr__zNoSelection.__repr__sN)returnstr)__name__ __module__ __qualname____doc__r#rr$r"rrs wr$rceZdZdZy)InvalidSelectValueErrorzNRaised when setting a [`Select`][textual.widgets.Select] to an unknown option.Nr'r(r)r*rr$r"r,r,$sXr$r,ceZdZdZy)EmptySelectErrorzXRaised when a [`Select`][textual.widgets.Select] has no options and `allow_blank=False`.Nr-rr$r"r/r/(sbr$r/ceZdZdZdgZeGddeZeGddeZddfd Z ddZ dfd Z dd Z ddd Z dd Zdd ZddZddZddZ ddZxZS) SelectOverlayz,The 'pop-up' overlay for the Select control.)escapedismissz Dismiss menuc eZdZUdZdZded<y)SelectOverlay.Dismissz0Inform ancestor the overlay should be dismissed.Fbool lost_focusN)r'r(r)r*r7__annotations__rr$r"Dismissr51s> D -r$r9ceZdZUdZded<y)SelectOverlay.UpdateSelectionz*Inform ancestor the selection was changed.int option_indexN)r'r(r)r*r8rr$r"UpdateSelectionr;8s8-r$r>cPt|||_ d|_ d|_y)Ngffffff?)super__init___type_to_search _search_query_search_reset_delay)r!type_to_search __class__s r"rBzSelectOverlay.__init__?s/ -r"$U*- nr$cLdfd }tj|_y)Ncd_yNr@)rDr sr" reset_queryz+SelectOverlay.on_mount..reset_queryKs !#D r$)callbackr%None)rrE_search_reset_timer)r!rKs` r"on_mountzSelectOverlay.on_mountJs$ $$) $**[$  r$cd|_|r|jjn4|jj|jj t ||yrJ)rDrO_startresetstoprAwatch_has_focus)r!valuerGs r"rUzSelectOverlay.watch_has_focusRsQ   $ $ + + -  $ $ * * ,  $ $ ) ) + &r$cxK|jsy|jj|j|jrvd|_|j |j|xj|jz c_|j|j}||j|yyyyw)Nr) rCrOrS character is_printabletimerTprevent_defaultrD_find_search_matchselect)r!eventindexs r"_on_keyzSelectOverlay._on_key[s##    &&( ?? &5+=+=EJ JJL  ! ! #   %// 1 ++D,>,>?E  E"!,> &sB8B:cJ|jxr|duxr|jS)z.Check if the widget may consume the given key.N)rC isprintable)r!keyrXs r"check_consume_keyzSelectOverlay.check_consume_keyls*  VYd%: Vy?T?T?V r$c2||_|jy)zRMove selection. Args: index: Index of new selection. N) highlightedscroll_to_highlight)r!r_s r"r]zSelectOverlay.selectrs !   "r$c`d}d}|j}t|jD]\}}|j}t |t r|j j}n"t |tr|j}n_|j|}|dk7sv|||ks~|}|}|S)aA simple substring search which favors options containing the substring earlier in the prompt. Args: query: The substring to search for. Returns: The index of the option that matches the query, or `None` if no match is found. N) lower enumerate_optionsprompt isinstancer plainr&find) r!query best_match minimum_indexr_optionrm lower_prompt match_indexs r"r\z SelectOverlay._find_search_match{s"& $(  &t}}5 ,ME6]]F&$'%||113 FC(%||~ &++E2Kb %})D" +  , r$cB|j|jy)Dismiss the overlay.N) post_messager9r s r"action_dismisszSelectOverlay.action_dismisss $,,.)r$cf|j|jd|jy)z'On blur we want to dismiss the overlay.T)r7N)ryr9suppress_clickr!_events r"_on_blurzSelectOverlay._on_blurs' $,,$,78 r$cx|j|j|j|jy)z)Inform parent when an option is selected.N)rTryr>r=r!r^s r"on_option_list_option_selectedz,SelectOverlay.on_option_list_option_selecteds*  $..u/A/ABCr$c$|jy)z.Stop option list highlighted messages leaking.N)rTrs r"!on_option_list_option_highlightedz/SelectOverlay.on_option_list_option_highlighteds   r$)T)rFr6r%rNrM)rVr6r%rN)r^z events.Keyr%rNN)rcr&rX str | Noner%r6)r_ int | Noner%rN)rqr&r%r)r~z events.Blurr%rN)r^zOptionList.OptionSelectedr%rN)r^zOptionList.OptionHighlightedr%rN)r'r(r)r*BINDINGSrrr9r>rBrPrUr`rdr]r\rzrrr __classcell__rGs@r"r1r1,s656H.'.. .'.. o '#" #@* D 1 r$r1c|eZdZUdZdZedZded< GddeZ d fd Z dd Z dd Z dd Z dd ZxZS) SelectCurrentz'Displays the currently selected option.aT SelectCurrent { border: tall $border-blurred; color: $foreground; background: $surface; width: 1fr; height: auto; padding: 0 2; &.-textual-compact { border: none !important; } &:ansi { border: tall ansi_blue; color: ansi_default; background: ansi_default; } Static#label { width: 1fr; height: auto; color: $foreground 50%; background: transparent; } &.-has-value Static#label { color: $foreground; } .arrow { box-sizing: content-box; width: 1; height: 1; padding: 0 0 0 1; color: $foreground 50%; background: transparent; } } F var[bool] has_valueceZdZdZy)SelectCurrent.TogglezRequest toggle overlay.Nr-rr$r"Togglers%r$rcZt|||_tj|_y)zInitialize the SelectCurrent. Args: placeholder: A string to display when there is nothing selected. N)rArB placeholderSelectBLANKlabel)r!rrGs r"rBzSelectCurrent.__init__s# &39<< r$c||_|tju|_|j dt j t|tr|jy|y)zUpdate the content in the widget. Args: label: A renderable to display, or `None` for the placeholder. z#labelN) rrrr query_onerupdaternrr)r!rs r"rzSelectCurrent.updatesN  fll2 x(// *5+ >D   DI r$c#zKt|jdtddtddyw) zCompose label and down arrow.r)idu▼zarrow down-arrow)classesu▲zarrow up-arrowN)rrr s r"composezSelectCurrent.composes5T%%'22U$677U$455s9;c(|j|dy)zToggle the class.z -has-valueN) set_class)r!rs r"_watch_has_valuezSelectCurrent._watch_has_values y,/r$cb|j|j|jy)z"Inform ancestor we want to toggle.N)rTryrrs r" _on_clickzSelectCurrent._on_clicks  $++-(r$)rr&r%rN)rzRenderableType | NoSelectionr%rNr%r)rr6r%rN)r^z events.Clickr%rN)r'r(r)r* DEFAULT_CSSrrr8rrrBrrrrrrs@r"rrsG1'KRu:Iy%C&&@  6 0)r$r SelectType)boundztuple[str, SelectType]r SelectOptionc eZdZUdZeZ eddddgZ dZeddZ d e d < ee dZ d e d < ee eefedZd e d< eddZ ej(j*GddeZddedddddddd d*fdZeddeddddddd d+dZed,dZ d-dZd.dZefd/dZd-dZ d0dZ!d1dZ"d2d Z#d3d!Z$d4d"Z%e&e'jPd5d#Z)e&e*jVd6d$Z,e&e*jZd7d%Z.d.d&Z/d8d'Z0d.d(Z1d9d)Z2xZ3S):rzWidget to select from a list of possible options. A Select displays the current selection. When activated with ++enter++ the widget displays an overlay with a list of all possible options. zenter,down,space,up show_overlayz Show menuF)showa Select { height: auto; color: $foreground; &.-textual-compact { & > SelectCurrent { padding: 0 1 0 0; border: none !important; } } .up-arrow { display: none; } &:focus > SelectCurrent { border: tall $border; background-tint: $foreground 5%; } & > SelectOverlay { width: 1fr; display: none; height: auto; max-height: 12; overlay: screen; constrain: none inside; color: $foreground; border: tall $border-blurred; background: $surface; &:focus { background-tint: $foreground 5%; } & > .option-list--option { padding: 0 1; } } &.-expanded { .down-arrow { display: none; } .up-arrow { display: block; } & > SelectOverlay { display: block; } } } )initrexpandedzvar[str]rmzvar[SelectType | NoSelection]rVz-textual-compact) toggle_classcJeZdZdZ dfd ZddZeddZxZS)Select.Changedz{Posted when the select value was changed. This message can be handled using a `on_select_changed` method. c@t|||_ ||_y)z9 Initialize the Changed message. N)rArBr]rV)r!r]rVrGs r"rBzSelect.Changed.__init__ps$ G   DK $DJ :r$c#DK|j|jywr)r]rVr s r" __rich_repr__zSelect.Changed.__rich_repr__|s++ ** s c|jS)z!The Select that sent the message.)r]r s r"controlzSelect.Changed.controls;; r$)r]Select[SelectType]rVSelectType | NoSelectionr%rN)r%zrich.repr.Result)r%r) r'r(r)r*rBrpropertyrrrs@r"Changedris> ;, ;5M ;  ;     r$rTN) rm allow_blankrVrFnamerrdisabledtooltipcompactc t ||||| ||_||_||_|j |||_| | |_| |_y)aInitialize the Select control. Args: options: Options to select from. If no options are provided then `allow_blank` must be set to `True`. prompt: Text to show in the control when no option is selected. allow_blank: Enables or disables the ability to have the widget in a state with no selection made, in which case its value is set to the constant [`Select.BLANK`][textual.widgets.Select.BLANK]. value: Initial value selected. Should be one of the values in `options`. If no initial value is set and `allow_blank` is `False`, the widget will auto-select the first available option. type_to_search: If `True`, typing will search for options. name: The name of the select control. id: The ID of the control in the DOM. classes: The CSS classes of the control. disabled: Whether the control is disabled or not. tooltip: Optional tooltip. compact: Enable compact select (without borders). Raises: EmptySelectError: If no options are provided and `allow_blank` is `False`. )rrrrN) rArB _allow_blankrm_value_setup_variables_for_optionsrCrr) r!optionsrmrrVrFrrrrrrrGs r"rBzSelect.__init__s\L dr7XN'   ))'2-  "DL r$ rmrrVrFrrrrrc d|Dcgc]}t||f} }|| ||||||| |  Scc}w)aInitialize the Select control with values specified by an arbitrary iterable The options shown in the control are computed by calling the built-in `str` on each value. Args: values: Values used to generate options to select from. prompt: Text to show in the control when no option is selected. allow_blank: Enables or disables the ability to have the widget in a state with no selection made, in which case its value is set to the constant [`Select.BLANK`][textual.widgets.Select.BLANK]. value: Initial value selected. Should be one of the values in `values`. If no initial value is set and `allow_blank` is `False`, the widget will auto-select the first available value. type_to_search: If `True`, typing will search for options. name: The name of the select control. id: The ID of the control in the DOM. classes: The CSS classes of the control. disabled: Whether the control is disabled or not. compact: Enable compact style? Returns: A new Select widget with the provided values as options. r)r&) clsvaluesrmrrVrFrrrrroptions_iterators r" from_valueszSelect.from_valuessTN>DDESZ/DD #)  Es-c@|j}t|try|S)zThe currently selected item. Unlike [value][textual.widgets.Select.value], this will not return Blanks. If nothing is selected, this will return `None`. N)rVrnr)r!rVs r" selectionzSelect.selections  e[ ) r$c0g|_|jr'|jjd|jf|jj ||js t d|jDchc]\}}| c}}|_ycc}}w)zSetup function for the auxiliary variables related to options. This method sets up `self._options` and `self._legal_values`. r@z;Select options cannot be empty if selection can't be blank.N)rlrappendrextendr/ _legal_values)r!r_rVs r"rz#Select._setup_variables_for_optionssPR    MM "djj!1 2 W%}}"M  #'--= aE= = s< Bc (|jDcgc]?\}}||jk(r tt|jdn t|A}}}|j t }|j|j|ycc}}w)zFSets up the `Option` renderables associated with the `Select` options.dimstyleN) rlrrr rmrr1 clear_options add_options)r!rmrVr option_lists r"_setup_options_renderablesz!Select._setup_options_renderabless"& ! DJJ&tDKKu56F^$! ! nn]3 !!#(! sABcl||jk(r|js|jdd}||_y)z1Initialises the selected option for the `Select`.rN)rrrlrV)r!hints r"_init_selected_optionzSelect._init_selected_options0 4:: d&7&7==#A&D r$cf|j||j|jy)aSet the options for the Select. This will reset the selection. The selection will be empty, if allowed, otherwise the first valid option is picked. Args: options: An iterable of tuples containing the renderable to display for each option and the corresponding internal value. Raises: EmptySelectError: If the options iterable is empty and `allow_blank` is `False`. N)rrr)r!rs r" set_optionszSelect.set_options#s* ))'2 '') ""$r$cR||jvr|dnd}td|d|z|S)aEnsure the new value is a valid option. If `allow_blank` is `True`, `None` is also a valid value and corresponds to no selection. Raises: InvalidSelectValueError: If the new value does not correspond to any known value. z$ Did you mean to use Select.clear()?r@zIllegal select value .)rr,)r!rV help_texts r"_validate_valuezSelect._validate_value5sH ** *CH->UWI)'y2Y>  r$c||_ |jt}||jk(r|j |jnTt |j D]<\}\}}||k(s|jt}||_|j |n|j|j||y#t$rYywxYw)z)Update the current value when it changes.N) rrrrrrkrlr1rfryrr)r!rVselect_currentr_rmrselect_overlays r" _watch_valuezSelect._watch_valueLs  9!^^M:N "%%djj1/8/G+E+FF)- )F5:2&--f5    dll47 8   sB?? C  C c#Kt|jt|jj t j yw)z.Compose Select with overlay and current value.)rF)rN)rrmr1rC data_bindrrr s r"rzSelect.compose_s@DKK((4+?+?@JJNNK  sAAcZ|j|j|jy)zSet initial values.N)rrrr}s r" _on_mountzSelect._on_mountfs  '') ""4;;/r$c |jt}|j|d|r|j d|j |j ur,|jdd|jt_ y|j }t|jD] \}\}}||k(s|j|nd|jt_ yy#t$rYywxYw)zDisplay or hide overlay.Nz -expandedF)scroll_visibleT) rr1rrfocusrVrr]rrrkrl)r!roverlayrVr__prompt prompt_values r"_watch_expandedzSelect._watch_expandedks nn]3G x-  MMM /zzTZZ't$:?}-7 6? 6N2E2G\ ,u-;?}-7     sC!! C-,C-cH|j|j |_y)zShow the overlay when toggled.N)rTrrs r"_select_current_togglezSelect._select_current_toggles   MM) r$cl|jd|_|js|jyy)rxFN)rTrr7rrs r"_select_overlay_dismisszSelect._select_overlay_dismisss+    JJL r$c|j|j|jd}||jk7r||_|j d|_y)zUpdate the current selection.rFN)rTrlr=rVrr)r!r^rVs r"_update_selectionzSelect._update_selectionsI   e001!4 DJJ DJ  r$c|jt}d|_d|_|jt}|j |j yy)zShow the overlay.TN)rrrrr1rf action_first)r!rrs r"action_show_overlayzSelect.action_show_overlaysJ 6#'   6  % % -  ' ' ) .r$c4|j|jk(S)zIndicates whether this `Select` is blank or not. Returns: True if the selection is blank, False otherwise. )rVrr s r"is_blankzSelect.is_blanks zzTZZ''r$cZ |j|_y#t$r tddwxYw)zClear the selection if `allow_blank` is `True`. Raises: InvalidSelectValueError: If `allow_blank` is set to `False`. z5Can't clear selection if allow_blank is set to False.N)rrVr,r s r"clearz Select.clears4  DJ& )G  s*c<|jsy|jt}||_|jsy|j |j k(r|j|j |jt}|jdt|dy)Nrrr) is_mountedrrrrrVrrr1replace_option_prompt_at_indexr )r!rmrrs r" _watch_promptzSelect._watch_promptsu  6%+"   :: #  ! !$** -nn]3 221d66OPr$)r+Iterable[tuple[RenderableType, SelectType]]rmr&rr6rVrrFr6rrrrrrrr6rzRenderableType | Nonerr6)rzIterable[SelectType]rmr&rr6rVrrFr6rrrrrrrr6rr6r%r)r%zSelectType | None)rrr%rNrM)rrr%rN)rVrr%r)rVrr%rNr)r~z events.Mountr%rN)rr6r%rN)r^rr%rN)r^r5r%rN)r^r;r%rN)r%r6)rmr&r%rN)4r'r(r)r*rrrrrrr8r&rmr rrrVrrrichreprautorrrB classmethodrrrrrrrrrrrrrrrrr1r9rr>rrrrrrrs@r"rrs E< %~{OH 5Kne%0Hi04s3x)FH)7+N3uZ5L/M+N E,E (u+=>G4 YY^^'> */#")-.<. .  . ( ... ...'..`  */#"3 $3  3  3 ( 3 3 3  3 3 3 3  3 3 j   <   , )FK %$- !.9& 0 ?* **   %%&'*(  Qr$rT) can_focus)6 __future__r dataclassesrtypingrrrrr r rich.reprr rich.consoler rich.textr textualr rtextual.bindingrtextual.containersrrtextual.css.queryrtextual.messagertextual.reactiverr textual.timerrtextual.widgetsrtextual.widgets._option_listrrtyping_extensionsr textual.apprrr Exceptionr,r/r1rrrr8rrr$r"rs"!MM'#3'#*";+)  YiYcycAJAHU)JU)p\ 2 +2 i2.uQWZ (duQr$