CjSrSSKJr SSKJr SSKJrJrJrJ r J r SSK J r J r SSKJrJrJr SSKJr \(aSSKJr SS KJr SS KJr \ "S S S 9r"SS\\5r"SS\\5r"SS\\5rg)zC Descriptors to define properties on your widget, screen, or App. ) annotations)isclass) TYPE_CHECKINGCallableGenericTypeVaroverload)NoActiveAppError active_app) NoMatches QueryType WrongTypeWidgetApp)DOMNode) MessagePumpAppTyper)boundc,\rSrSrSrSSjrSSjrSrg) appaCreate a property to return the active app. All widgets have a default `app` property which returns an App instance. Type checkers will complain if you try to access attributes defined on your App class, which aren't present in the base class. To keep the type checker happy you can add this property to get your specific App subclass. Example: ```python class MyWidget(Widget): app = getters.app(MyApp) ``` Args: app_type: The App subclass, or a callable which returns an App subclass. cJ[U5(aXlgU"5UlgN)r _app_type)selfapp_types a/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/textual/getters.py__init__ app.__init__*s%,X%6%6HJc[R"5n[ X0R5(deU$![aH SSKJn Un[ XT5(d+Uc [ 5eURn[ XT5(dM+UnNof=f)Nrr) r get LookupError textual.appr isinstancer _parentr)robjobj_typerrnodes r__get__ app.__get__-s~ .."C#~~....   ''*D ++<*,,||!++C s5A BBB)rN)rz+type[AppType] | Callable[[], type[AppType]]returnNone)r)rr*ztype[MessagePump]r.r)__name__ __module__ __qualname____firstlineno____doc__r r,__static_attributes__r"rrrs"Gr"rc\rSrSr%SrS\S'S\S'\SSj5r\SSj5r\SS j5r\SS j5rSSS jjr\SS j5r\SSj5rSSjrSr g ) query_one>aCreate a query one property. A query one property calls [Widget.query_one][textual.dom.DOMNode.query_one] when accessed, and returns a widget. If the widget doesn't exist, then the property will raise the same exceptions as `Widget.query_one`. Example: ```python from textual import getters class MyScreen(screen): # Note this is at the class level output_log = getters.query_one("#output", RichLog) def compose(self) -> ComposeResult: with containers.Vertical(): yield RichLog(id="output") def on_mount(self) -> None: self.output_log.write("Screen started") # Equivalent to the following line: # self.query_one("#output", RichLog).write("Screen started") ``` Args: selector: A TCSS selector, e.g. "#mywidget". Or a widget type, i.e. `Input`. expect_type: The type of the expected widget, e.g. `Input`, if the first argument is a selector. strselectorztype['Widget'] expect_typecg)z8 Args: selector: A TCSS selector, e.g. "#mywidget" Nr6rr;s rr query_one.__init__asr"cgrr6r>s rr r?is;>r"cgrr6rr;r<s rr r?lMPr"cgrr6rBs rr r?osr"NcUc SSKJn X0lOX l[U[5(aXlgUR UlXlg)Nrr)textual.widgetrr<r'r:r;r0)rr;r<rs rr r?ts>   -% *  h $ $$M$--DM' r"cgrr6rr)r*s rr,query_one.__get__r"cgrr6rHs rr,rIs"%r"c\UcU$URURUR5nU$)1Get the widget matching the selector and/or type.)r8r;r<)rr)r* query_nodes rr,rIs. ;K]]4==$2B2BC r")r<r;)r;r:r.r/)r;type[QueryType]r.r/)r;r:r<rOr.r/)r;rOr<rOr.r/r)r;zstr | type[QueryType]r<type[QueryType] | Noner.r/)r'query_one[QueryType]'r)rr* type[DOMNode]r.r )rrQr)r/r*rRr.rQ)rrQr)DOMNode | Noner*rRr.z QueryType | Widget | 'query_one' r0r1r2r3r4__annotations__r r r,r5r6r"rr8r8>s!>M   >> PP '6E /3('(,(  ("$+2>K %$%+/%;H% %%$+9ER )r"r8c\rSrSr%SrS\S'S\S'\SSj5r\SSj5rSSS jjr\SS j5r\SS j5rSS jrSr g ) child_by_ida Create a child_by_id property, which returns the child with the given ID. This is similar using [query_one][textual.getters.query_one] with an id selector, except that only the immediate children are considered. It is also more efficient as it doesn't need to search the DOM. Example: ```python from textual import getters class MyScreen(screen): # Note this is at the class level output_log = getters.child_by_id("output", RichLog) def compose(self) -> ComposeResult: yield RichLog(id="output") def on_mount(self) -> None: self.output_log.write("Screen started") ``` Args: child_id: The `id` of the widget to get (not a selector). expect_type: The type of the expected widget, e.g. `Input`. r:child_idz type[Widget]r<cgrr6)rrYs rr child_by_id.__init__s/2r"cgrr6rrYr<s rr r[rCr"Nc:Uc [UlOX lXlgr)rr<rYr]s rr r[s  %D *  r"cgrr6rHs rr,child_by_id.__get__rJr"cgrr6rHs rr,r`s$'r"cJUcU$UR5RRUR5nUc[ SUR<35e[ X0R 5(d4[SUR<SUR R<SU35eU$)rMzNo child found with id=zChild with id=z" is the wrong type; expected type z, found ) _get_dom_base_nodes _get_by_idrYr r'r<rr0)rr)r*childs rr,r`s ;K!!#**55dmmD =5dmm5FGH H%!1!122  11STXTdTdTmTmSppxy~xA  r")rYr<)rYr:r.r/)rYr:r<rOr.r/r)rYr:r<rPr.r/)r'child_by_id[QueryType]'r)rr*rRr.r )rrgr)r/r*rRr.rg)rrgr)rSr*rRr.z"QueryType | Widget | 'child_by_id'rTr6r"rrWrWs8M 22 PP /3 ! !, !  !&-4@M '&'-1'=J' !'' & -; GT  + r"rWN)r4 __future__rinspectrtypingrrrrr textual._contextr r textual.css.queryr r rrFrr&r textual.domrtextual.message_pumprrrr8rWr6r"rrosw #FF9==!#0 )5 )#'' #LX "XvH')$Hr"