Cjn%SrSSKJr SSKrSSKrSSKJrJr SSKJ r SSK J r J r J r JrJrJrJrJrJrJrJr SSKrSSKJr SSKJr SS KJr SS KJr SS K J!r! SS K"J#r#J$r$ SS K%J&r& SSK'J(r( SSK)J*r*J+r+J,r, SSK-J.r. SSK/J0r0J1r1J2r2 SSK3J4r4 SSK5J6r6J7r7 SSK8J9r9J:r: SSK;Jr>J?r?J@r@ SSKAJBrBJCrCJDrDJErE SSKFJGrGJHrH SSKIJJrJ SSKKJLrL SSKMJNrN SSKOJPrPJQrQJRrRJSrS SS KTJrU SSKVJWrW SSKXJYrYJZrZJ[r[ SSK\J]r] \ (aDSS K^J_r_J`r` SS!KaJbrb SS"KcJdrd SS#KeJfrf SS$KAJgrgJhrh SS%KiJjrj SS&KkJlrl SS'KmJnrn SS(KoJprp SS)KqJrrrJsrsJtrt SS*K^Juru \R"\J5rw\uS+rxS,\yS-'\"S.5rzS/r{S,\yS0'"S1S2\|5r}S WalkMethod ReactiveTypez$tuple[int, str, Type[Widget] | None]QueryOneCacheKeyc\rSrSrSrSrg) BadIdentifierUzRException raised if you supply a `id` attribute or class name in the wrong format.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__rW]/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/textual/dom.pyrUrUUs\r_rUcl[RnUHnU"U5bM[U<SUS35e g)zValidate identifier and raise an error if it fails. Args: description: Description of where identifier is used for error message. *names: Identifiers to check. Nz is an invalid zl; identifiers must contain only letters, numbers, underscores, or hyphens, and must not begin with a number.)_re_identifier fullmatchrU) descriptionnamesr'names r`check_identifiersrgYsG  $ $E ; (/+7}} r_c\rSrSrSrSrg)DOMErroriz4Base exception class for errors relating to the DOM.rWNrXrWr_r`ririis>r_ric\rSrSrSrSrg)NoScreenmz.Raised when the node has no associated screen.rWNrXrWr_r`rlrlms8r_rlc<\rSrSrSrSSSjjrS SjrSrg) _ClassesDescriptorqz.A descriptor to manage the `classes` property.Nc,[UR5$)z1A frozenset of the current classes on the widget.) frozenset_classes)selfobjobjtypes r`__get___ClassesDescriptor.__get__ts&&r_c[U[5(a[UR55nO [U5n[ S/UQ76 UR U:waX1lUR 5 gg)zReplaces classes entirely. class nameN) isinstancestrsetsplitrgrsupdate_node_styles)rtruclasses class_namess r`__set___ClassesDescriptor.__set__zsW gs # #gmmo.Kg,K,55 <<; &&L  " " $ 'r_rWN)ruDOMNodervztype[DOMNode] | Nonereturnfrozenset[str])rurrstr | Iterable[str]rNone)rYrZr[r\r]rwrr^rWr_r`roroqs-8=A''%9' ' %r_rocH ^\rSrSr%SrSrS\S'SrS\S'\"5r S\S'S r S \S '/r S \S 'Sr S\S'S r S\S'SrS\S'SrS\S'SrS\S'\"5rS\S'SrS\S'S rS\S'S\S'S\S'S\S '0rS!\S"'S S S S#.SU4S$jjjrSS%jrSS&jrSS'jrSS(jrSS)jrSS*jr\SS+j5r\SS,j5r\SS-j5r \SS.j5r!S S/S0.SS1jjr"\SS2j5r#\#RHSS3j5r#\SS4j5r%SSS5jjr&SSS6jjr'\SS7j5r(\SS8j5r)SS9jr*SSU4S:jjjr+SS;jr,S<r-SS=jr.\SS>j5r/\0\1"S S?9SS@j55r2\0SSAj5r3SSBjr4SSCjr5SSDjr6\0\1"S S?9SSEj55r7\SSFj5r8\SSGj5r9\SSHj5r:\:RHSSIj5r:\SSJj5r;\SSKj5r<\SSLj5r=\>"5r?\SSMj5r@\SSNj5rA\SSOj5rB\SSPj5rC\CRHSSQj5rC\SSRj5rD\DRHSSSj5rD\SSTj5rE\SSUj5rF\SSVj5rG\SSWj5rH\SSXj5rISSYjrJSSZjrKSS[jrL\SS\j5rM\SS]j5rN\SS^j5rO\SS_j5rPSSS`jjrQSSajrRSSbjrSSScjrTSSdjrU\V"SeSSf9rW\X(a0\YS/SgS/Sh.SSijj5rZ\YS/SgS/Sh.SSjjj5rZSS/SgS/Sh.SSkjjjrZ\X(a\YSSSljj5r[\YSSmj5r[SSSnjjr[\X(a\YSSSojj5r\\YSSpj5r\SSSqjjr\\X(a$\YSSrj5r]\YSSsj5r]\YSStj5r]SSSujjr]\X(a$\YSSvj5r^\YSSwj5r^\YSSxj5r^SSSyjjr^\X(a$\YSSzj5r_\YSS{j5r_\YSS|j5r_SSS}jjr_\X(a$\YSS~j5r`\YSSj5r`\YSSj5r`SSSjjr`SSSjjraSSjrbSS.SSjjrcSSSjjrdSSjreSSSjjrfSS.SSjjrgSS.SSjjrhSSjriSSjrjSSjrk\SSj5rlSS/S/S.SSjjrmSSjrnSSjroSSjrpSrqU=rr$)rzIThe base class for object that can be in the Textual DOM (App and Widget)z ClassVar[str] DEFAULT_CSSDEFAULT_CLASSESzClassVar[set[str]]COMPONENT_CLASSESN str | NoneBINDING_GROUP_TITLEzClassVar[list[BindingType]]BINDINGSTzClassVar[bool] SCOPED_CSSzClassVar[str | None]HELP _inherit_css_inherit_component_classes_inherit_bindingszClassVar[frozenset[str]]_css_type_namesr|_css_type_namezClassVar[BindingsMap | None]_merged_bindingszClassVar[dict[str, Reactive]] _reactivesz6dict[type[Message], list[tuple[Callable, str | None]]]_decorated_handlers _computesz/ClassVar[dict[str, Callable[[App[Any]], bool]]]_PSEUDO_CLASSES)rfidrcH>[5UlXlSUlUb[ SU5 X lU(aUR 5O/n[ S/UQ76 URR U5 [U5Ul[U5Ul [U5Ul [XRUR5Ul 0UlSUlSUlUR#UR$5Vs1sHoUR&iM snUlUR*c [-5OUR*R/5UlSUlSUlSUlSUlSUlSUl[?S5Ul SUl![DTU]5 gs snf)NrrzFi)$r}rs_name_idrgr~updater_nodesr0 _css_styles_inline_stylesr/styles_component_styles _auto_refresh_auto_refresh_timer _css_bases __class__rY _css_typesrrcopy _bindings_has_hover_style_has_focus_within_has_order_style_has_odd_or_even_reactive_connect_pruningr_query_one_cache _trap_focussuper__init__)rtrfrrrsclsrs r`rDOMNode.__init__sq#&%   > dB 'H&-7==?2,22 X& ( #)$<&,Tl$0 ""D$7$7%  ;=+/15 37??4>>3RS3RC<<3RS$$, M&&++-  ',',&+ Q&+<   EMd^  'Ts:FcU$)zGet the DOM base node (typically self). All DOM queries on this node will use the return value as the root node. This method allows the App to query the default screen, and not the active screen. Returns: DOMNode. rWrts r` _get_dom_baseDOMNode._get_dom_bases  r_cURn[U[5(d [S5eX0R;a'[ SU<SUR RS35e[USU3U5 g)a^Sets a reactive value *without* invoking validators or watchers. Example: ```python self.set_reactive(App.theme, "textual-light") ``` Args: reactive: A reactive property (use the class scope syntax, i.e. `MyClass.my_reactive`). value: New value of reactive. Raises: AttributeError: If the first argument is not a reactive. z6A Reactive class is required; for example: MyApp.themezNo reactive called z/; Have you called super().__init__(...) in the z constructor? _reactive_N) rfr{r4 TypeErrorrAttributeErrorrrYsetattr)rtreactivevaluerfs r` set_reactiveDOMNode.set_reactives{"}}(H--TU U  & %dX-\]a]k]k]t]t\uvCD   4&)51r_cXSUR3n[X5nURXSS9 g)aForce an update to a mutable reactive. Example: ```python self.reactive_name_list.append("Jessica") self.mutate_reactive(MyClass.reactive_name_list) ``` Textual will automatically detect when a reactive is set to a new value, but it is unable to detect if a value is _mutated_ (such as updating a list, dict, or attribute of an object). If you do wish to use a collection or other mutable object in a reactive, then you can call this method after your reactive is updated. This will ensure that all the reactive _superpowers_ work. !!! note This method will cause watchers to be called, even if the value hasn't changed. Args: reactive: A reactive property (use the class scope syntax, i.e. `MyClass.my_reactive`). rT)alwaysN)rfgetattr_set)rtr internal_namers r`mutate_reactiveDOMNode.mutate_reactives..%X]]O4 , d$ /r_cSn[R"5nURc0Ul0UVs0sHoURU_M snEUEnUR 5HupeX`R ;a[ SU<SU35e[U[5(aT[XER5(d:[ SURRSURRS35eXE4URU'M UR(aUR5 U$URUR5 U$s snf)aSBind reactive data so that changes to a reactive automatically change the reactive on another widget. Reactives may be given as positional arguments or keyword arguments. See the [guide on data binding](/guide/reactivity#data-binding). Example: ```python def compose(self) -> ComposeResult: yield WorldClock("Europe/London").data_bind(WorldClockApp.time) yield WorldClock("Europe/Paris").data_bind(WorldClockApp.time) yield WorldClock("Asia/Tokyo").data_bind(WorldClockApp.time) ``` Raises: ReactiveError: If the data wasn't bound. Returns: Self. Tz&Unable to bind non-reactive attribute  on zUnable to bind data; z is not defined on .)rgetrrfitemsrr5r{r4ownerrYr _is_mounted_initialize_data_bind call_later)rt reactives bind_vars_rich_traceback_omitparentrrfs r` data_bindDOMNode.data_bind.s;0 $$((*  ! ! )%'D "X J H x/ JXiX 'oo/ND??*#^SUU4SjjnU$)zMake a setter for the given variable name. Args: variable_name: Name of variable being set. Returns: A callable which takes the value to set. cb>Sn[R"T5 [TT[U55 g)zSet bound data.TN)r4_initialize_objectrr6)rrrt variable_names r`setterBDOMNode._initialize_data_bind..make_setter..setterss'+/(//5D-%Ar_)robjectrrrW)rrrts` r` make_setter2DOMNode._initialize_data_bind..make_setterisBB r_Tinit)rr|rzCallable[[object], None]) rrr{rr4watchrfrr)rtrcompose_parentrrrs` r`rDOMNode._initialize_data_bind_s %% 9=9O9O9U9U9W 5M5N &ng66 66 /F(H-- "MM  9:?:X@"&r_c:URRU5 g)aAdd a node to children. This is used by the compose process when it adds children. There is no need to use it directly, but you may want to override it in a subclass if you want children to be attached to a different node. Args: widget: A Widget to add. N)r_append)rtwidgets r`compose_add_childDOMNode.compose_add_childs F#r_cUR$)z>A view on to the children. Returns: The node's children. )rrs r`childrenDOMNode.childrens{{r_c.URR$)zZThe displayed children (where `node.display==True`). Returns: A sequence of widgets. )r displayedrs r`displayed_childrenDOMNode.displayed_childrens{{$$$r_c.URR$)zsThe displayed children (where `node.display==True` and `node.visible==True`). Returns: A sequence of widgets. )rdisplayed_and_visiblers r`displayed_and_visible_children&DOMNode.displayed_and_visible_childrens{{000r_cD[SUR55(+$)z Are there no displayed children?c38# UHoRv M g7fr)display).0childs r` #DOMNode.is_empty..s>+}}+)anyrrs r`is_emptyDOMNode.is_emptys>$++>>>>r_FkeyreversecTURRXS9 URSS9 g)aSort child widgets with an optional key function. If `key` is not provided then widgets will be sorted in the order they are constructed. Example: ```python # Sort widgets by name screen.sort_children(key=lambda widget: widget.name or "") ``` Args: key: A callable which accepts a widget and returns something that can be sorted, or `None` to sort without a key function. reverse: Sort in descending order. r TlayoutN)r_sortrefresh)rtr r s r` sort_childrenDOMNode.sort_childrens'* c3 D !r_cUR$)zPNumber of seconds between automatic refresh, or `None` for no automatic refresh.)rrs r` auto_refreshDOMNode.auto_refreshs!!!r_cURb!URR5 SUlUb#URXRSU<3S9UlXlg)Nz auto refresh )rf)rstop set_intervalautomatic_refreshr)rtintervals r`rrs`  # # /  $ $ ) ) +'+D $  '+'8'800th7O(9(D $&r_c.URR$)z:The app's worker manager. Shortcut for `self.app.workers`.)appworkersrs r`rDOMNode.workerssxxr_cXlg)ajTrap the focus. When applied to a container, this will limit tab-to-focus to the children of that container (once focus is within that container). This can be useful for widgets that act like modal dialogs, where you want to restrict the user to the controls within the dialog. Args: trap_focus: `True` to trap focus. `False` to restore default behavior. N)r)rt trap_focuss r`r DOMNode.trap_focuss &r_c URR[R"5:wa5[ URR UR R5n OUR Rn U "UUUUUUUUUS9 n U $)aRun work in a worker. A worker runs a function, coroutine, or awaitable, in the *background* as an async task or as a thread. Args: work: A function, async function, or an awaitable object to run in a worker. name: A short string to identify the worker (in logs and debugging). group: A short string to identify a group of workers. description: A longer string to store longer information on the worker. exit_on_error: Exit the app if the worker raises an error. Set to `False` to suppress exceptions. start: Start the worker immediately. exclusive: Cancel all workers in the same group. thread: Mark the worker as a thread worker. Returns: New Worker instance. )rfgrouprd exit_on_errorstart exclusivethread)r _thread_id threading get_identrcall_from_threadr _new_worker) rtworkrfr#rdr$r%r&r'creatorworkers r` run_workerDOMNode.run_workersz> 88  )"5"5"7 7dhh779Q9QRGll..G%,  #' &  r_cg)zIs the node a modal?FrWrs r`is_modalDOMNode.is_modal r_cg)z:Check if the node was displayed in the last screen update.FrWrs r` is_on_screenDOMNode.is_on_screen%r5r_cHUR(aUR5 gg)zPerform an automatic refresh. This method is called when you set the `auto_refresh` attribute. You could implement this method if you want to perform additional work during an automatic refresh. N)r7rrs r`rDOMNode.automatic_refresh*s    LLN r_c >[T U]5 0=o@l[UR5HXnUR UR R5VVs0sHupg[U[5(dMXg_M snn5 MZ Xl X l X0l [5nURU5n U SRUlU HnUR#UR5 M UR%5Ul[)U5Ul[)[-U5Vs/sH/nUR/S5(dMUR1S5SSPM1 sn5Ulgs snnfs snf)Nr) _compute_compute__)r__init_subclass__rreversed__mro__r__dict__rr{r4rrrr}rrYradd_merge_bindingsrrrrdir startswithlstripr) r inherit_cssinherit_bindingsinherit_component_classesrbaserfrcss_type_namesbasesrs r`r@DOMNode.__init_subclass__5s@ !#%'' NS[[)D   +/--*=*=*?*?!(H5#DN*? *' 0)B&#&5s#"1X..D   t}} -"224'7! H $D??#<=% C $$   #$ sE( 7E( %E.E.c[U[5[55nUHnX0R;a[SU<S35eURUnURceUR UR5 UR RUR 5 URRUR5 U=RS- sl M U$)zGet a "component" styles object (must be defined in COMPONENT_CLASSES classvar). Args: names: Names of the components. Raises: KeyError: If the component class doesn't exist. Returns: A Styles object. zNo z key in COMPONENT_CLASSES) r/r0rKeyErrornode _update_noderLmergeinline_updates)rtrerrfcomponent_styless r`get_component_stylesDOMNode.get_component_stylesYsdFHfh7D111TH,EFGG#55d; #((4 44    0 5 5 6 KK  .33 4 MM   0 7 7 8 OOq O r_c4Sn[R"U5 g)z)Called after the object has been mounted.TN)r4r)rtrs r` _post_mountDOMNode._post_mountts###D)r_cg)z~Called after styles are updated. Implement this in a subclass if you want to clear any cached data when the CSS is reloaded. NrWrs r`notify_style_updateDOMNode.notify_style_updateyr_c8URUR5$)z4The DOMNode bases classes (including self.__class__))rrrs r` _node_basesDOMNode._node_basesst~~..r_)maxsizec/nUnURU5 UR(dU$URHn[U[5(dMUn O U$MV)zGet the DOMNode base classes, which inherit CSS. Args: base: A DOMNode class Returns: An iterable of DOMNode classes. )appendr __bases__ issubclassr)rrLr_class_bases r`rDOMNode._css_basessf(* NN6 "&&  ))eW--"F* r_c /n[UR5Hon[U[5(dMUR(dUR 5 UR [URRS/555 Mq 0nUH*nURR5H upVXcU'M M, [R"U5nU$)zAMerge bindings from base classes. Returns: Merged bindings. r) rArBrirrclearrgrrCrkey_to_bindingsr from_keys)rbindingsrLkeys bindings_r  key_bindings new_bindingss r`rEDOMNode._merge_bindingss')S[[)D$((--NN$ ))*b9 **,!I%.%>%>%D%D%F!(S &G"#,,T2 r_cg)zICalled when the widget is registered Args: app: Parent application. NrW)rtrs r`_post_registerDOMNode._post_registerrar_c## [US5(aSURS4v [US5(aSURS4v [US5(a2UR(a SSR UR54v ggg7f)Nrrfrrrsr )hasattrrrrsjoinrs r` __rich_repr__DOMNode.__rich_repr__st 4 ! !$**d* * 4  $& & 4 $ $SXXdmm44 4*7 $sB B c0/nSSjn[UR5Huup4URRSS5nU(dM*URRSS5nUR U"U5UU*U(a UR OS45 Mw U$)a%Gets the CSS for this class and inherited from bases. Default CSS is inherited from base classes, unless `inherit_css` is set to `False` when subclassing. Returns: A list of tuples containing (LOCATION, SOURCE, SPECIFICITY, SCOPE) for this class and inherited from base classes. c[U5URS34$![[4a SURS34s$f=f)zGet the original location of this DEFAULT_CSS. Args: base: The class from which the default css was extracted. Returns: The filename where the class was defined (if possible) and the class variable the CSS was extracted from. z .DEFAULT_CSSr)rrYrOSError)rLs r` get_location.DOMNode._get_default_css..get_locationsK < $-- 'EFFw' <t}}o\:;; @  <"+4+;+;!< K}}((;Cs#}}00tD  $T*$ /5++2  "=r_c[5nURU5HYnURURR S[555 URR SS5(aMY O [ U5$)zGets the component classes for this class and inherited from bases. Component classes are inherited from base classes, unless `inherit_component_classes` is set to `False` when subclassing. Returns: A set with all the component classes available. rrT)r}rrrCrrr)rcomponent_classesrLs r`_get_component_classesDOMNode._get_component_classessj'*eNN3'D  $ $T]]%6%67JCE%R S==$$%A4HH( *++r_c.[SUR5$)zwThe parent node. All nodes have parent once added to the DOM, with the exception of the App which is the *root* node. DOMNode | None)r_parentrs r`rDOMNode.parents $dll33r_cSSKJn UnUb1[X!5(d!URnUb[X!5(dM![X!5(d [ S5eU$![a [ S5Sef=f)zThe screen containing this node. Returns: A screen object. Raises: NoScreen: If this node isn't mounted (and has no screen). rrGNzSWidget is missing attributes; have you called the constructor in your widget class?znode has no screen)textual.screenrHr{rr RuntimeErrorrl)rtrHrSs r`screenDOMNode.screens~ *#' ":d+C+C||":d+C+C $''/0 0  e  s 2AA2cUR$)z3The ID of this node, or None if the node has no ID.)rrs r`r DOMNode.id)s xxr_c[SU5 URR5 URb[ SUR<S35eXlU$)zSets the ID (may only be done once). Args: new_id: ID for this node. Raises: ValueError: If the ID has already been set. rz.Zs"M *: sitalicz[name=] underline) rstyledrrYrrgrr}rfrs r`css_identifier_styledDOMNode.css_identifier_styledNsT^^445 77  MMAdggY-vM 6 << MM#  MM#(("M "MMx X 99 MMF499+Q/{M C r_c4[UR55$)z%A (frozen) set of all pseudo classes.)rrget_pseudo_classesrs r`pseudo_classesDOMNode.pseudo_classesbs00233r_cU/nURnUn[UR=n[5(a+U"U5 [UR=n[5(aM+USSS2$)zA list of nodes from the App to this node, forming a "path". Returns: A list of nodes, where the first item is the App, and the last is this node. N)rgr{rr)rtresultrgrSs r`css_path_nodesDOMNode.css_path_nodesgs\"&$,,.$99 4L$,,.$99dd|r_cS1SUR5kURknURbURSUR35 U$)zWGet a set of selectors applicable to this widget. Returns: Set of selector names. *c3,# UH nSU3v M g7f)rNrWrs r`r*DOMNode._selector_names..s ?:*sr)rsrrrD)rt selectorss r`_selector_namesDOMNode._selector_namesvsU  ? ? __ 88  MMAdhhZ. )r_cURRS:g=(a7 UR=(d UR=(d UR(+$)zShould the DOM node be displayed? May be set to a boolean to show or hide the node, or to any valid value for the `display` rule. Example: ```python my_widget.display = False # Hide my_widget ``` none)rr_closing_closedrrs r`rDOMNode.displays>{{""f, MM :T\\ :T]]2  r_c[U[5(aU(aSOSURlgU[;aXRlg[ SU<S[ [5S35e)z Args: new_val: Shortcut to set the ``display`` CSS property. ``False`` will set ``display: none``. ``True`` will set ``display: block``. A ``False`` value will prevent the DOMNode from consuming space in the layout. blockrz$invalid value for display (received , expected rN)r{boolrrr#r&r")rtnew_vals r`rrs_ gt $ $-4'&DKK   %")KK !6wkB)-89< r_cURRS5nUbUS:g$UR(aURR$S$)aIs this widget visible in the DOM? If a widget hasn't had its visibility set explicitly, then it inherits it from its DOM ancestors. This may be set explicitly to override inherited values. The valid values include the valid values for the `visibility` rule and the booleans `True` or `False`, to set the widget to be visible or invisible, respectively. When a node is invisible, Textual will reserve space for it, but won't display anything. visibilityhiddenT)rget_rulervisible)rt own_values r`rDOMNode.visiblesDKK((6  ( (&*kkt{{"";t;r_c[U[5(aU(aSOSURlgU[;aXRlg[ SU<S[ [5S35e)Nrrz'invalid value for visibility (received rr)r{rrrr$r&r")rt new_values r`rrs_ i & &2;YDKK " * *%.KK "!9)G)*:;T"U5$)Render a node for the tree.rW)rSrs r` render_info!DOMNode.tree..render_infos $< r_c>URH7nT"U5nURU5nUR(dM/T"XB5 M9 gr)rrD)treerSrinfobranch add_childrenrs r`r"DOMNode.tree..add_childrens9"5)$=== / 'r_)rSrrr) rich.prettyrr)rtrrrrs @@@r`r DOMNode.trees2 ' K%& 0 T  r_c^^^^^^^^ SSKJm SSKJm SSKJm SSKJm SSKJ m S UUUU4Sjjm [5m[T "U55nS UUUU 4SjjmT"X5 U$) zA Rich tree to display the DOM, annotated with the node's CSS. Log this to visualize your app in the textual console. Example: ```python self.log(self.css_tree) ``` Returns: A Tree renderable. r)Columns)Group)PanelrrIc>[UT5(a;T"T"U5T"SUR<35T"SUR<35/5nU$T"T"U5/5nU$)rzregion=z virtual_size=)r{region virtual_size)rSrrrrJ highlighters r`r%DOMNode.css_tree..render_infosp$''t #gdkk_$=>#+D,=,=+@AKt ~.Kr_c :>URHnT "U5nURRnU(a6T"UTR[ URR5SSSS95nUR U5nUR(dMT"XR5 M g)zAdd children to the tree.dimrleft) border_styletitle title_alignN)rrrfitrrD) rrSrrrrrrrrs r`r&DOMNode.css_tree..add_childrens'25'9ll&&   !1!12)."'(. "D$=== /'r_)rSrrr)rrrSrrr) rich.columnsr rich.consoler rich.panelrrrtextual.widgetrJrr) rtrrrrrrJrrrs @@@@@@@@r`css_treeDOMNode.css_treesP )&$&)   &' K%& 0 0& T  r_cb[R"S[UR555$)zGet the text style object. A widget's style is influenced by its parent. for instance if a parent is bold, then the child will also be bold. Returns: A Rich Style. c3L# UHoRRv M g7fr)r text_style)rrSs r`r%DOMNode.text_style..0s /QtKK " "/Qs"$)rcombinerAancestors_with_selfrs r`rDOMNode.text_style&s-}} /78P8P/Q   r_cBURRS[S9nU$)zThe style of selected text.zscreen--selection)default)rget_component_rich_styleRICH_NULL_STYLE)rtrs r`selection_styleDOMNode.selection_style4s) 44 5  r_cL[SSSS5n[SSSS5n[5nSn[UR5HnURnUR nXFR -nU"S5(a_XRRUR5-nUURRUR5RU5- nOUnU"S5(a URnX6R- nU"S5(dMUR(dMURUR5nM U[R "UR(dUR(aX-R"OSUR(a UR"OS5- nU$)zFGet a Rich Style object for this DOMNode. Returns: A Rich style. r? backgroundcolor auto_colorN)r!rrArrhas_ruleopacityrtintbackground_tintmultiply_alpharrrget_contrast_texta from_color rich_color) rtrrrrrSrrtext_backgrounds r` rich_styleDOMNode.rich_style<s`1aA& c3Q'T556D[[FH ~~ %G %%",/@/@/E/E**0#%%**6+A+AB .)* #-    && &E %%&*;*;*;'99%''B#7& !!0: Z  + +d%/\\J ! !t   r_cg)aCheck if the widget may consume the given key. This should be implemented in widgets that handle [`Key`][textual.events.Key] events and stop propagation (such as Input and TextArea). Implementing this method will hide key bindings from the footer and key panel that would be *consumed* by the focused widget. Args: key: A key identifier. character: A character associated with the key, or `None` if there isn't one. Returns: `True` if the widget may capture the key in its `Key` event handler, or `False` if it won't. FrW)rtr  characters r`check_consume_keyDOMNode.check_consume_keybs r_cURnUR(a&URURR5nO URnUUR [ R"UR54$)zoGet a Visual Style object for titles. Args: background: The background color. Returns: A Rich style. ) rauto_border_title_colorrborder_title_colorrborder_title_background VisualStylefrom_rich_styleborder_title_stylertrrrs r`_get_title_style_information$DOMNode._get_title_style_informationtsg  ) )001J1J1L1LME--E   * *  ' '(A(A B  r_cURnUR(a&URURR5nO URnUUR [ R"UR54$)zpGet a Rich Style object for subtitles. Args: background: The background color. Returns: A Rich style. ) rauto_border_subtitle_colorrborder_subtitle_colorrborder_subtitle_backgroundr&r'border_subtitle_styler)s r`_get_subtitle_style_information'DOMNode._get_subtitle_style_informationsg  , ,001M1M1O1OPE00E   - -  ' '(D(D E  r_c[SSSS5=pSn[UR5HUnURnUnX5R-nX%R R UR5RU5- nMW X4$)zVBackground colors adjusted for opacity. Returns: `(, )` rr) r!rArrrrrrr)rtbase_backgroundrrrSrs r`background_colorsDOMNode.background_colorss(-Q1a'88T556D[[F(O ~~ %G ++001G1GHWW J 7 ,,r_cp[=p[=p4[UR5HnURnUnX&R R UR5- nURS5(dMPUnUR(aURUR5nMURnM XX$4$)zThe widget's background and foreground colors, and the parent's background and foreground colors. Returns: `(, , , )` r) r rrArrrrrrrrrr)rtr4r base_colorrrSrs r`colorsDOMNode.colorss(-,"" T556D[[F(O ++001G1GH HJw''" $$&88AE"LLE7 Z??r_cU/nURnUnUR=nbU"U5 UR=nbM[SU5$)zA list of ancestor nodes found by tracing a path all the way back to App. Note: This is inclusive of ``self``. Returns: A list of nodes. list[DOMNode]rgrrrtnodesadd_noderSs r`rDOMNode.ancestors_with_selfsM,0&<<#'||#t0 TN||#t0OU++r_c/nURnUnUR=nbU"U5 UR=nbM[SU5$)ziA list of ancestor nodes found by tracing a path all the way back to App. Returns: A list of nodes. r<r=r>s r` ancestorsDOMNode.ancestorssK+-<<#'||#t0 TN||#t0OU++r_c[XX#US9 g)aWatches for modifications to reactive attributes on another object. Example: ```python def on_theme_change(old_value:str, new_value:str) -> None: # Called when app.theme changes. print(f"App.theme went from {old_value} to {new_value}") self.watch(self.app, "theme", self.on_theme_change, init=False) ``` Args: obj: Object containing attribute to watch. attribute_name: Attribute to watch. callback: A callback to run when attribute changes. init: Check watchers on first call. rN)r7)rtruattribute_namecallbackrs r`r DOMNode.watchs0 t.>r_cURR5VVs1sHupU"U5(dMUiM snn$s snnf)zHPseudo classes for a widget. Returns: Names of the pseudo classes. )rr)rtrf check_classs r`rDOMNode.get_pseudo_classessC&*%9%9%?%?%A %A!4  %A   s??cSSKJn URSS9HFnURR 5 [ X!5(dM/UR 5 SUlMH g)z)Reset styles back to their initial state.rrIT) with_selfN)rrJ walk_childrenrresetr{ _set_dirty_layout_required)rtrJrSs r` reset_stylesDOMNode.reset_stylessL)&&&6D    " " $$''!(,% 7r_c\URRU5 URU5 g)zQAdd a new child node. !!! note For tests only. Args: node: A DOM node. N)rr_attach)rtrSs r` _add_childDOMNode._add_childs" D! Tr_cURRnUH5nURU5 U"U5 UR"UR6 M7 g)z~Add multiple children to this node. !!! note For tests only. Args: *nodes: Positional args should be new DOM nodes. N)rrrU _add_children_pending_children)rtr?rrSs r`rYDOMNode._add_children%sD++%%D LL  DM    6 6 7r_WalkType)boundrO)rMmethodr cgrrW)rt filter_typerMr^r s r`rNDOMNode.walk_children8s!r_cgrrW)rtrMr^r s r`rNraBs r_cU=(d [nUS:Xa [XUS9O [XUS9n[U5nU(aUR 5 [ SU5$)aNWalk the subtree rooted at this node, and return every descendant encountered in a list. Args: filter_type: Filter only this type, or None for no filter. with_self: Also yield self in addition to descendants. method: One of "depth" or "breadth". reverse: Reverse the order (bottom up). Returns: A list of nodes. rO with_rootr<)rr;r9listr r)rtr`rMr^r  check_typenode_generatorr?s r`rNraKsX&!+G   T C#D J ^$  MMOOU++r_cgrrWrtselectors r`query DOMNode.queryoJMr_cgrrWrjs r`rlrmrsKNr_cSSKJnJn SSKJn UR 5n[ U[5(dUcX$"XQS9$X#"XQRS9$)zQuery the DOM for children that match a selector or widget type. Args: selector: A CSS selector, widget type, or `None` for all nodes. Returns: A query object. rrBrI)filter textual.css.queryrCrDrrJrr{r|rYrtrkrCrDrJrSs r`rlrmusL :)!!# h $ $(8#D: :&t4E4EF Fr_cgrrWrjs r`query_childrenDOMNode.query_childrensSVr_cgrrWrjs r`rvrwsTWr_cSSKJnJn SSKJn UR 5n[ U[5(dUc X$"USUS9$X#"USURS9$)azQuery the DOM for the immediate children that match a selector or widget type. Note that this will not return child widgets more than a single level deep. If you want to a query to potentially match all children in the widget tree, see [query][textual.dom.DOMNode.query]. Args: selector: A CSS selector, widget type, or `None` for all nodes. Returns: A query object. rrBrIF)deeprqrrrts r`rvrwsT :)!!# h $ $(8#DuXF F&t%@Q@QR Rr_cgrrWrjs r` query_oneDOMNode.query_ones69r_cgrrWrjs r`r|r}sEHr_cgrrWrtrk expect_types r`r|r}r_c SnUR5n[U[5(aUnO URn[ U5(aUR R XR4nURRU5nUbU$[XESSSS9=nbCUb0[X5(d [SU<SUR<SU35eXRU'U$[S U<S U<35e[U5n [S U 55(a9UR R XR4nURRU5nUbU$OSn[!USS9H[n[#X5(dMUb0[X5(d [SU<SUR<SU35eUbXRU'Us $ [S U<S U<35e![a [S U<S 35Sef=f)adGet a widget from this widget's children that matches a selector or widget type. Args: selector: A selector or widget type. expect_type: Require the object be of the supplied type, or None for any type. Raises: WrongType: If the wrong type was found. NoMatches: If no node matches the query. Returns: A widget matching the selector. TNrQFrdNode matching " is the wrong type; expected type , found No nodes match rUnable to parse $ as a query; check for syntax errorsc38# UHoRv M g7fr is_simplerrs r`r$DOMNode.query_one..ALy""Lr)rr{r|rYr(rrWrrr:r.r,r*r2r+allr9r') rtrkrr base_nodequery_selector cache_key cached_resultrS selector_sets r`r|r}sC$ $&&( h $ $%N%..N . ) )"))22NPI%66::9EM($$.ab1U  *:d3P3P#((::\]h]q]q\tt|~B}CD9=**95 on-?tI=QR R *>:L ALA A A"))22NPI%66::9EM($$)I&yEBD,,&z$/L/L$^$66XYdYmYmXppxy}x~$8<**95KC/.);4 }MNN1 $">"44XY  s ' GGcgrrWrjs r`query_one_optionalDOMNode.query_one_optionalsFIr_cgrrWrjs r`rrsUXr_cgrrWrs r`rrs #r_cJURX5nU$![a gf=f)abGet a widget from this widget's children that matches a selector or widget type, or `None` if there is no match. Args: selector: A selector or widget type. expect_type: Require the object be of the supplied type, or None for any type. Raises: WrongType: If the wrong type was found. Returns: A widget matching the selector, or `None`. N)r|r,)rtrkrrs r`rr s0$ ^^H:F   s  ""cgrrWrjs r`query_exactly_oneDOMNode.query_exactly_one&s>Ar_cgrrWrjs r`rr)sMPr_cgrrWrs r`rr,rr_c SnUR5n[U[5(aUnO URn[ U5n[SU55(a9URRXR4nURRU5nUbU$OSn[USS9n [U 5n U Hn [Xk5(dMUb0[X5(d [SU<S UR<S U 35eU Hn [Xl5(dM[!S 5e UbXRU'U s $ [#S U<S U<35e![ a [ SU<S35Sef=f)aGet a widget from this widget's children that matches a selector or widget type. !!! Note This method is similar to [query_one][textual.dom.DOMNode.query_one]. The only difference is that it will raise `TooManyMatches` if there is more than a single match. Args: selector: A selector or widget type. expect_type: Require the object be of the supplied type, or None for any type. Raises: WrongType: If the wrong type was found. NoMatches: If no node matches the query. TooManyMatches: If there is more than one matching node in the query (and `exactly_one==True`). Returns: A widget matching the selector. TrrNc38# UHoRv M g7frrrs r`r,DOMNode.query_exactly_one..XrrFrdrrrz8Call to query_one resulted in more than one matched noderr)rr{r|rYr*r2r+rrrWrrr9iterr'r.r-r,) rtrkrrrrrrrr iter_childrenrS later_nodes r`rr1s. $&&( h $ $%N%..N *>:L ALA A A"))22NPI%66::9EM($$)I%i5AX !D,,&z$/L/L$^$66XYdYmYmXppxy}x~, 22(R, $8<**95K" /.);4 }MNN? $">"44XY  s EEcgrrWrjs r`query_ancestorDOMNode.query_ancestorvs:L    '!((<<\00*:d3P3P = .xl$thGHH $">"44XY  s B''Cc TUb5[USS9nUR R U5 URSS9 URnUR5Hupg[XVU5 M U$![a1n[URURUR5SeSnAff=f)zSet custom styles on this object. Args: css: Styles in CSS format. update_styles: Keyword arguments map style names onto style values. Returns: Self. N) set_stylesr) read_fromTr ) r)r%rftokenmessagerrUrrrr)rtr update_styles new_styleserrorrr rs r`rDOMNode.set_styless ? Y/?QR     % %j 1 LLL %'--/JC F '0 $ Y&uzz5;; NTXX Ys A,, B'6,B""B'c8URRU5$)zCheck if the Node has all the given class names. Args: *class_names: CSS class names to check. Returns: ``True`` if the node has all the given class names, otherwise ``False``. )rs issuperset)rtrs r` has_classDOMNode.has_classs}}'' 44r_)rc`U(aUR"USU06 U$UR"USU06 U$)aAdd or remove class(es) based on a condition. This can condense the four lines required to implement the equivalent branch into a single line. Example: ```python #if foo: # self.add_class("-foo") #else: # self.remove_class("-foo") self.set_class(foo, "-foo") ``` Args: add: Add the classes if True, otherwise remove them. update: Also update styles. Returns: Self. r) add_class remove_class)rtrDrrs r` set_classDOMNode.set_classs9*  NNK 7 7    { :6 : r_c [5n[5nURUR4nUR5HupxXh"U5 M URU-U- n URU :waXlU(aUR US9 U$)aUpdate classes in an atomic batch. Args: classes: A mapping of class name on to a boolean where `True` adds to the current classes, and `False` removes. update: Also update styles. animate: Enable any CSS animation? Returns: Self animate)r}rDrrsr) rtrrr add_classesremove_classesaddsrrD new_classess r`update_classesDOMNode.update_classess!$ #&5""KOO4&}}OJ Ij ! /}}{2nD ==K ''M'''8 r_cXlU$)zReplace all classes. Args: classes: A string containing space separated classes, or an iterable of class names. Returns: Self. )r)rtrs r` set_classesDOMNode.set_classess  r_cXURRXS9 g![a gf=f)zjRequest an update of this node's styles. Called by Textual whenever CSS classes / pseudo classes change. rN)rrr)rtrs r`rDOMNode.update_node_styless.   HH " "4 " 9   s  ))c[S/UQ76 URRU5(aU$URRU5 U(aUR 5 U$)zAdd class names to this Node. Args: *class_names: CSS class names to add. update: Also update styles. Returns: Self. rz)rgrsrrrrtrrs r`rDOMNode.add_classsQ ,55 == # #K 0 0K [)   # # % r_c[S/UQ76 URRU5(aU$URRU5 U(aUR 5 U$)zRemove class names from this Node. Args: *class_names: CSS class names to remove. update: Also update styles. Returns: Self. rz)rgrs isdisjointdifference_updaterrs r`rDOMNode.remove_class+sQ ,55 == # #K 0 0K '' 4   # # % r_c[S/UQ76 URR5nURRU5 X R:XaU$UR 5 U$)ziToggle class names on this Node. Args: *class_names: CSS class names to toggle. Returns: Self. rz)rgrsrsymmetric_difference_updater)rtr old_classess r` toggle_classDOMNode.toggle_class=sU ,55mm((*  11+> -- 'K ! r_cNURU"U5$![a gf=f)zCheck the node has the given pseudo class. Args: class_name: The pseudo class to check for. Returns: `True` if the DOM node has the pseudo class, `False` if not. F)rrR)rtrs r`has_pseudo_classDOMNode.has_pseudo_classNs/ '' 3D9 9  s  $$cl^^TRm[UU4SjU55$![a gf=f)zCheck the node has all the given pseudo classes. Args: class_names: Set of class names to check for. Returns: `True` if all pseudo class names are present. c3:># UHnTU"T5v M g7frrW)rrfPSEUDO_CLASSESrts r`r-DOMNode.has_pseudo_classes..gsJkd~d+D11ksF)rrrR)rtrrs` @r`has_pseudo_classesDOMNode.has_pseudo_classes\s8-- JkJJ J  s & 33cg)zEA cache key used when updating a number of nodes from the stylesheet.rWrWrs r`_pseudo_classes_cache_key!DOMNode._pseudo_classes_cache_keyksr_)repaintr recomposecU$rrW)rtrrrs r`rDOMNode.refreshps  r_cg)aCheck whether an action is enabled. Implement this method to add logic for [dynamic actions](/guide/actions#dynamic-actions) / bindings. Args: action: The name of an action. parameters: A tuple of any action parameters. Returns: `True` if the action is enabled+visible, `False` if the action is disabled+hidden, `None` if the action is disabled+visible (grayed out in footer) TrW)rtaction parameterss r` check_actionDOMNode.check_actionusr_c\UR(aURR5 gg)zCall to prompt widgets such as the [Footer][textual.widgets.Footer] to update the display of key bindings. See [actions](/guide/actions#dynamic-actions) for how to use this method. N)rrrefresh_bindingsrs r`rDOMNode.refresh_bindingss"    KK ( ( * r_cD# [X5n[XU(+5 g7f)zuToggle an attribute on the node. Assumes the attribute is a bool. Args: attribute_name: Name of the attribute. N)rr)rtrFrs r` action_toggleDOMNode.action_toggles-%i0s )rrrrsrrrrrrrrrrrrrrrrr)rfrrrrrrr)rr)rReactive[ReactiveType]rrRrr)rrrr)rz Reactive[Any]rzReactive[Any] | objectrr=)rr)rrJrr)rzSequence['Widget'])rzSequence[Widget])rr)r z1Callable[[Widget], SupportsRichComparison] | Noner rrr)r float | None)rrrr)rr<)T)r rrr)rrrTTFF)r-zWorkType[ResultType]rfrr#r|rdr|r$rr%rr&rr'rrzWorker[ResultType])TTT)rIrrJrrKrrr)rer|rr/)rSequence[Type[DOMNode]])rLrrr)rr)rrArr)rzrich.repr.Result)rz'list[tuple[CSSLocation, str, int, str]])rr)rr)rz'Screen[object]')rr)rr|rr|)rr|)rr)rr<)rset[str])r bool | strrr)rrrr)rr)rr)r r|rrrr)rr!rz tuple[Color, Color, VisualStyle])rztuple[Color, Color])rz!tuple[Color, Color, Color, Color]) rurrFr|rGrrrrr)rSrJrr)r?rJrr) r`ztype[WalkType]rMrr^rQr rrzlist[WalkType])rMrr^rQr rrr<r) r`ztype[WalkType] | NonerMrr^rQr rrzlist[DOMNode] | list[WalkType])rkrrzDOMQuery[Widget])rktype[QueryType]rzDOMQuery[QueryType])rkzstr | type[QueryType] | Nonerz&DOMQuery[Widget] | DOMQuery[QueryType])rkr|rrJ)rkrrrD)rkr|rrrrD)rkstr | type[QueryType]rtype[QueryType] | NonerzQueryType | Widget)rkr|rz Widget | None)rkrrQueryType | None)rkr|rrrr)rkrrrrzQueryType | Widget | None)rkr|rr)rkrrrrr)rrrrrr=)rr|rr)rDrrr|rrrr=)TT)rzMapping[str, bool]rrrrrr=)rrrr=)rrrr)rr|rrrr=)rr|rr=)rr|rr)rrrr)rztuple[int, ...])rrrrrrrr=)rr|rztuple[object, ...]rz bool | None)rFr|rr)srYrZr[r\r]r__annotations__rr}rrrrrrrrrrrrrrrrrrrrrpropertyrrrrrrrrr r0r3r7rr@rYr\r_rc classmethodrrrErxr~rrrrrrfrrrorrrrrrrrrr rr r*r1r5r9rrCrrrRrVrYrr\rrrNrlrvr|rrrrrrrrrrrrrrrrrrrr^ __classcell__)rs@r`rrs S!#K#%'O]'3,/E)1G&**W,.H).!"&J%;!%D %C$(L.'265)-~,1: O-;NC6:29--OO('GIODI  " 00  0  0  00d 2.27C2 2406/!/,/  /b(&T $%%11??BF "?" "  "0""&&   &"".".. .  .  .... .` !!%*. " " " $( "  " " H6*  // t.4 5(Tt,,$442YY$ !"G( 44         ^^(<<" ^^  >;;z    ##J$  ) .  ) ,--"@@*,,  , ,$ ? ??$ ?  ?  ?4  -  8z3H  $!(!  !' !  !   !   ! !  ! $!(!           .2 , $ ,* , ,  ,  , ( ,D M M N N8<G4G /G( V V W W8<S4S /S0 9 9 H H   .=     /3GO'GO,GO  GOR I I X X  # #.= #  #  #/3', # 0 A A P P   .=     /3AO'AO,AO  AOF ? ? M M   .=     /3%I'%I,%I  %IN0 5FJ8QU)37IM 8 ;?$>B$"   "&eu/3HL   + 1 1r_r)rdr|rer|rr)r] __future__rrer) functoolsrrinspectrtypingrrr r r r r rrrr rich.reprrichrich.highlighterr rich.stylerr r rich.textr rich.treertextual._contextrrtextual._node_listrtextual._typesrtextual.bindingrrr textual.cacher textual.colorrr r!textual.css._error_toolsr"textual.css.constantsr#r$textual.css.errorsr%r&textual.css.matchr'textual.css.parser(r)r*rsr+r,r-r.textual.css.stylesr/r0textual.css.tokenizer1textual.css.tokenizerr2textual.message_pumpr3textual.reactiver4r5r6r7 textual.styler& textual.timerr8 textual.walkr9r:r;textual.worker_managerr<typing_extensionsr=r> _typeshedr?rr@ textual.apprArCrDtextual.css.typesrEtextual.messagerFrrHrrJtextual.workerrKrLrMrNcompilerbrQrrRrS ExceptionrUrgrirlroreprautorrWr_r`r*sV # (    ,4B',=="--2A@#QQVV3+,,FF.UU010+5-'%%;;%J' 23 I3h~& E)D.]I]  ?y?9x9%%*Q1kQ1Q1r_