uj]%SSKJr SSKJr SSKJrJrJrJrJ r SSK r SSK J r SSKJr SSKJrJr SSKJr SS KJrJr SS KJr SS KJr SS KJrJr SS KJ r SSK!J"r" SSK#J$r$J%r% \(a SSK&J'r' SSK(J)r) "SS\"5r*"SS5r+\+"5r,"SS\-5r."SS\-5r/"SS\%5r0"SS\5r1\ "S\S9r2S r3S!\4S"'"S#S$\\2\S%S&9r5g)') annotations) dataclass) TYPE_CHECKINGGenericHashableIterableTypeVarN)RenderableType)Text)eventson)Binding) HorizontalVertical) NoMatches)Message)reactivevar)Timer)Static)Option OptionList) TypeAlias) ComposeResultc\rSrSrSrSrg)NonSelectableStaticFN)__name__ __module__ __qualname____firstlineno__ ALLOW_SELECT__static_attributes__rڥC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\textual/widgets/_select.pyrrsLr%rc"\rSrSrSrSSjrSrg) NoSelectionzkUsed by the `Select` widget to flag the unselected state. See [`Select.NULL`][textual.widgets.Select.NULL].cg)Nz Select.NULLrselfs r&__repr__NoSelection.__repr__!sr%rN)returnstr)rr r!r"__doc__r-r$rr%r&r(r(s ur%r(c\rSrSrSrSrg)InvalidSelectValueError(zNRaised when setting a [`Select`][textual.widgets.Select] to an unknown option.rNrr r!r"r1r$rr%r&r3r3(sXr%r3c\rSrSrSrSrg)EmptySelectError,zXRaised when a [`Select`][textual.widgets.Select] has no options and `allow_blank=False`.rNr5rr%r&r7r7,sbr%r7c^\rSrSrSrS/rSr\"SS\55r \"SS\55r SSU4S jjjr SS jr SU4S jjr SS jrSSS jjrSSjrSSjrSSjrSSjrSSjrS SjrSrU=r$)! SelectOverlay0z,The 'pop-up' overlay for the Select control.)escapedismissz Dismiss menuFc(\rSrSr%SrSrS\S'Srg)SelectOverlay.Dismiss7z0Inform ancestor the overlay should be dismissed.Fbool lost_focusrN)rr r!r"r1rB__annotations__r$rr%r&Dismissr?7s> D -r%rDc$\rSrSr%SrS\S'Srg)SelectOverlay.UpdateSelection>z*Inform ancestor the selection was changed.int option_indexrN)rr r!r"r1rCr$rr%r&UpdateSelectionrF>s8-r%rJcN>[TU]5 XlSUlSUlg)Ngffffff?)super__init___type_to_search _search_query_search_reset_delay)r,type_to_search __class__s r&rNSelectOverlay.__init__Es- -r"$U*- nr%cJ^SU4Sjjn[TTRUS9Tlg)Nc>STlgNrL)rPr+sr& reset_query+SelectOverlay.on_mount..reset_queryQs !#D r%)callbackr/None)rrQ_search_reset_timer)r,rXs` r&on_mountSelectOverlay.on_mountPs$ $$) $**[$  r%c>SUlU(aURR5 O4URR5 URR 5 [ TU]U5 grW)rPr]_startresetstoprMwatch_has_focus)r,valuerSs r&rdSelectOverlay.watch_has_focusXsQ   $ $ + + -  $ $ * * ,  $ $ ) ) + &r%c# UR(dgURR5 URbUR(awSUlUR 5 UR5 U=RUR- slURUR5nUbURU5 gggg7f)Nr) rOr]rb character is_printabletimercprevent_defaultrP_find_search_matchselect)r,eventindexs r&_on_keySelectOverlay._on_keyas##    &&( ?? &5+=+=EJ JJL  ! ! #   %// 1 ++D,>,>?E  E"!,> &sCCc^UR=(a USL=(a UR5$)z.Check if the widget may consume the given key.N)rO isprintable)r,keyrhs r&check_consume_keySelectOverlay.check_consume_keyrs*  VYd%: Vy?T?T?V r%c0XlUR5 g)z:Move selection. Args: index: Index of new selection. N) highlightedscroll_to_highlight)r,ros r&rmSelectOverlay.selectxs !   "r%cSnSnUR5n[UR5HupEURn[ U[ 5(aUR R5nO([ U[5(aUR5nOMiURU5nUS:wdMUbX:dMUnUnM U$)zA 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 plainr0find) r,query best_match minimum_indexrooptionr lower_prompt match_indexs r&rl SelectOverlay._find_search_matchs"& $(  &t}}5ME]]F&$''%||113 FC((%||~ &++E2Kb %)D" + 6 r%cBURUR55 g)Dismiss the overlay.N) post_messagerDr+s r&action_dismissSelectOverlay.action_dismisss $,,.)r%c`URURSS95 UR5 g)z'On blur we want to dismiss the overlay.T)rBN)rrDsuppress_clickr,_events r&_on_blurSelectOverlay._on_blurs' $,,$,78 r%cxUR5 URURUR55 g)z)Inform parent when an option is selected.N)rcrrJrIr,rns r&on_option_list_option_selected,SelectOverlay.on_option_list_option_selecteds*  $..u/A/ABCr%c$UR5 g)z.Stop option list highlighted messages leaking.N)rcrs r&!on_option_list_option_highlighted/SelectOverlay.on_option_list_option_highlighteds   r%)rPrQr]rOrx)T)rRrAr/r\r[)rerAr/r\)rnz events.Keyr/r\N)rtr0rh str | Noner/rA)ro int | Noner/r\)rr0r/r)rz events.Blurr/r\)rnzOptionList.OptionSelectedr/r\)rnzOptionList.OptionHighlightedr/r\)rr r!r"r1BINDINGSr#rrrDrJrNr^rdrprurmrlrrrrr$ __classcell__rSs@r&r:r:0s656HL.'.. .'.. o o '#" #@* D 1 r%r:c^\rSrSr%SrSrSr\"S5rS\ S'"SS\ 5r SU4S jjr SS jr SS jrSS jrSS jrSrU=r$) SelectCurrentz'Displays the currently selected option.a SelectCurrent { border: tall $border-blurred; color: $foreground; background: $surface; width: 1fr; height: auto; padding: 0 2; pointer: pointer; &.-textual-compact { border: none !important; } &:ansi { border: tall $border-blurred; color: ansi_default; background: ansi_default; &:focus { border: tall $border; } } 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_valuec\rSrSrSrSrg)SelectCurrent.TogglezRequest toggle overlay.rNr5rr%r&Togglers%r%rcX>[TU]5 Xl[RUlg)zjInitialize the SelectCurrent. Args: placeholder: A string to display when there is nothing selected. N)rMrN placeholderSelectNULLlabel)r,rrSs r&rNSelectCurrent.__init__s! &39;; r%cXlU[RLUlUR S[ 5R [U[5(aUR5 gU5 g)zlUpdate the content in the widget. Args: label: A renderable to display, or `None` for the placeholder. z#labelN) rrrr query_onerupdaterr(r)r,rs r&rSelectCurrent.updatesO  fkk1 x(// *5+ > >D   DI r%c#h# [URSS9v [SSS9v [SSS9v g7f) zCompose label and down arrow.r)idu▼zarrow down-arrow)classesu▲zarrow up-arrowN)rrr+s r&composeSelectCurrent.composes4!$"2"2w??!%1CDD!%1ABBs02c(URUS5 g)zToggle the class.z -has-valueN) set_class)r,rs r&_watch_has_valueSelectCurrent._watch_has_value s y,/r%cbUR5 URUR55 g)z"Inform ancestor we want to toggle.N)rcrrrs r& _on_clickSelectCurrent._on_clicks  $++-(r%)rrr)rr0r/r\)rzRenderableType | NoSelectionr/r\r/r)rrAr/r\)rnz events.Clickr/r\)rr r!r"r1 DEFAULT_CSSr#rrrCrrrNrrrrr$rrs@r&rrsQ1+KZLu:Iy%C&&?  C 0))r%r SelectType)boundztuple[str, SelectType]r SelectOptionc ^\rSrSr%Sr\r\"SSSSS9/rSrSr \ "SSS 9r S \ S '\ \ "S5rS \ S '\ "\SS 9rS\ S'\"SSS9r\R&R("SS\55rSS\SSSSSSSS. S,U4Sjjjr\SS\SSSSSSS. S-Sjj5r\S.Sj5rS/SjrS0Sjr\4S1SjjrS/SjrS2Sjr S3S jr!S4S!jr"S5S"jr#S6S#jr$\%"\&RN5S7S$j5r(\%"\)RT5S8S%j5r+\%"\)RX5S9S&j5r-S0S'jr.S:S(jr/S0S)jr0S;S*jr1S+r2U=r3$) 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]rzvar[SelectType | NoSelection]rez-textual-compact) toggle_classcZ^\rSrSrSrSU4SjjrSSjr\S Sj5rSr U=r $) Select.ChangediuzkPosted when the select value was changed. This message can be handled using a `on_select_changed` method. c<>[TU]5 XlX lg)z! Initialize the Changed message. N)rMrNrmre)r,rmrerSs r&rNSelect.Changed.__init__|s G   K $J :r%c#D# URv URv g7frrmrer+s r& __rich_repr__Select.Changed.__rich_repr__s++ ** s cUR$)z!The Select that sent the message.)rmr+s r&controlSelect.Changed.controls;; r%r)rmSelect[SelectType]reSelectType | NoSelectionr/r\)r/zrich.repr.Result)r/r) rr r!r"r1rNrpropertyrr$rrs@r&Changedrus> ;, ;5M ;  ;     r%rTN) r allow_blankrerRnamerrdisabledtooltipcompactc >[T U]XgXS9 X0lX lX@lUR U5 XPlU bXlXlg)a!Initialize 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.NULL`][textual.widgets.Select.NULL]. 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) rMrN _allow_blankr_value_setup_variables_for_optionsrOrr) r,optionsrrrerRrrrrrrrSs r&rNSelect.__init__sLL d7N'   ))'2-  "L r% rrrerRrrrrrc dUVs/sHn[U5U4PM n nU"U UUWUUUUU U S9 $s snf)a0Initialize 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.NULL`][textual.widgets.Select.NULL]. 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)r0) clsvaluesrrrerRrrrrroptions_iterators r& from_valuesSelect.from_valuessUN>DDVESZ/VD #)  Es-cJURn[U[5(agU$)zThe currently selected item. Unlike [value][textual.widgets.Select.value], this will not return Blanks. If nothing is selected, this will return `None`. N)rerr()r,res r& selectionSelect.selections"  e[ ) ) r%cH/UlUR(a'URRSUR45 URR U5 UR(d [ S5eURVVs1sHup#UiM snnUlgs snnf)z~Setup function for the auxiliary variables related to options. This method sets up `self._options` and `self._legal_values`. rLz;Select options cannot be empty if selection can't be blank.N)rrappendrextendr7 _legal_values)r,r_res r&r#Select._setup_variables_for_optionssPR    MM "dii 1 W%}}"M  #'--= "/haE-= = sBc &URVVs/sH<upX R:Xa[[URSS95O [U5PM> nnnUR [ 5nUR5 URU5 gs snnf)zFSets up the `Option` renderables associated with the `Select` options.dimstyleN) rrrr rrr: clear_options add_options)r,rrer option_lists r&_setup_options_renderables!Select._setup_options_renderabless"& ! "/ II%tDKKu56F^$"/ ! nn]3 !!#(! sAB ctXR:Xa#UR(dURSSnXlg)z1Initialises the selected option for the `Select`.rN)rrrre)r,hints r&_init_selected_optionSelect._init_selected_option)s, 99 T%6%6==#A&D r%cfURU5 UR5 UR5 g)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_optionsSelect.set_options/s* ))'2 '') ""$r%cXXR;aUcSOSn[SU<S3U-5eU$)zEnsure 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()?rLzIllegal select value .)rr3)r,re help_texts r&_validate_valueSelect._validate_valueAsF ** *CH->UWI)'y2Y>  r%cXlUR[5nXR:XaUR UR5 OT[ UR 5H;unupEXQ:XdMUR[5nX6lUR U5 O URURX55 g![a gf=f)z)Update the current value when it changes.N) rrrrrr~rr:rxrrr)r,reselect_currentrorrselect_overlays r& _watch_valueSelect._watch_valueXs  9!^^M:N !%%dii0/8/G+E+F)- )F5:2&--f5 0H   dll47 8   sB== C  C c## [UR5v [URS9R [ R S9v g7f)z.Compose Select with overlay and current value.)rR)rN)rrr:rO data_bindrrr+s r&rSelect.composeks?DKK((4+?+?@JJNNK  sA A cZUR5 URUR5 g)zSet initial values.N)rrrrs r& _on_mountSelect._on_mountrs  '') ""4;;/r%cUR[5nURUS5 U(aUR SS9 UR UR La,URS5 SUR[5l gUR n[UR5H unupVX6:XdMURU5 O SUR[5l gg![a gf=f)zDisplay or hide overlay.Nz -expandedF)scroll_visibleT) rr:rrfocusrerrmrrr~r)r,roverlayrero_prompt prompt_values r&_watch_expandedSelect._watch_expandedws nn]3G x-  MMM /zzTYY&t$:?}-7 6? 6N2E2G,u-7O;?}-7     sC%% C21C2cPUR5 UR(+Ulg)zShow the overlay when toggled.N)rcrrs r&_select_current_toggleSelect._select_current_toggles   MM) r%cvUR5 SUlUR(dUR5 gg)rFN)rcrrBrrs r&_select_overlay_dismissSelect._select_overlay_dismisss+    JJL r%cUR5 URURSnX R:waX lUR 5 SUlg)zUpdate the current selection.rFN)rcrrIrerr)r,rnres r&_update_selectionSelect._update_selectionsE   e001!4 JJ J  r%cUR[5nSUlSUlUR[5nUR cUR 5 gg)zShow the overlay.TN)rrrrr:rx action_first)r,rrs r&action_show_overlaySelect.action_show_overlaysJ 6#'   6  % % -  ' ' ) .r%c4URUR:H$)zpIndicates whether this `Select` is blank or not. Returns: True if the selection is blank, False otherwise. )rerr+s r&is_blankSelect.is_blanks zzTYY&&r%c\URUlg![a [S5Sef=f)zzClear 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)rrer3r+s r&clear Select.clears4  DJ& )G  s+cJUR(dgUR[5nXlUR(dgUR UR :XaURUR 5 UR[5nURS[USS95 g)Nrrr) is_mountedrrrrrerrr:replace_option_prompt_at_indexr )r,rrrs r& _watch_promptSelect._watch_promptss  6%+"   :: "  ! !$)) ,nn]3 221d66OPr%) rrrrOrrrrrre)r+Iterable[tuple[RenderableType, SelectType]]rr0rrArerrRrArrrrrrrrArzRenderableType | NonerrA)rzIterable[SelectType]rr0rrArerrRrArrrrrrrrArrAr/r)r/zSelectType | None)rr8r/r\r[)rrr/r\)rerr/r)rerr/r\r)rz events.Mountr/r\)rrAr/r\)rnrr/r\)rnr?r/r\)rnrFr/r\)r/rA)rr0r/r\)4rr r!r"r1rrrr#rrrrCr0rrerrrichreprautorrrN classmethodrrrrrrrr rrrrr rrr!r:rDr$rJr'r+r.r1r6r$rrs@r&rrs D< %~{OH L5Kne%0Hi043x)FH)7+.t%+@E (@u+=>G4 YY^^'> *.#")-.<. .  . ( ... ...'...`  *.#"3 $3  3  3 ( 3 3 3  3 3 3 3  3 3 j   <   , )FJ %$- !.9& 0 ?* **   %%&'*'  Q Qr%rT) can_focus)6 __future__r dataclassesrtypingrrrrr rich.reprr9 rich.consoler rich.textr textualr r textual.bindingrtextual.containersrrtextual.css.queryrtextual.messagertextual.reactiverr textual.timerrtextual.widgetsrtextual.widgets._option_listrrtyping_extensionsr textual.apprrr(r Exceptionr3r7r:rrrrCrrr%r&rPs"!FF'#3'#*";+)&}YiYcycCJCL[)J[)|\ 2 +2 i2.uQWZ (duQr%