AHj3epdZddlmZddlmZddlmZddlmZm Z m Z ddl Z ddl mZddlmZdd lmZdd lmZmZdd lmZdd lmZe d dZerddlmZddlmZddlm Z ddl!m"Z"e jFjHGddeZ%e jFjHGdde%ddZ&eGdde%dZ'Gdde%dZ(Gd d!e%dZ)Gd"d#e%Z*Gd$d%e%dZ+Gd&d'e%ddZ,Gd(d)e%ddZ-Gd*d+e%ddZ.Gd,d-e%dZ/Gd.d/e%dZ0Gd0d1e%dZ1e jFjHGd2d3e%dZ2e jFjHGd4d5e%dZ3Gd6d7e%Z4e jFjHGd8d9e4Z5djd:Z6e jFjHGd;de4dZ7e jFjHGd<d=e7ddZ8e jFjHGd>d?e7ddZ9e jFjHGd@dAe7ddZ:e jFjHGdBdCe7ddZ;e jFjHGdDdEe7ddZGdJdKe7dZ?e jFjHGdLdMe%ddZGdNdOe%ddZ@GdPdQe%ddZAGdRdSe%dZBGdTdUe%dZCGdVdWe%dZDGdXdYe%dZEeGdZd[e%ddZFeGd\d]e%ddZGe jFjHGd^d_e%dZHGd`dae%dZIGdbdce%dZJe jFjHGdddee%dZKeGdfdge%dZLeGdhdie%dZMy)ka: Builtin events sent by Textual. Events may be marked as "Bubbles" and "Verbose". See the [events guide](/guide/events/#bubbling) for an explanation of bubbling. Verbose events are excluded from the textual console, unless you explicitly request them with the `-v` switch as follows: ``` textual console -v ``` ) annotations) dataclass)Path) TYPE_CHECKINGTypeTypeVarN)Style)Self) CallbackType)OffsetSize)_get_key_aliases)Message MouseEventT MouseEvent)bound)DOMNode)Timer) TimerCallback)WidgetceZdZdZy)EventzThe base class for all events.N__name__ __module__ __qualname____doc__F/root/tools/cai/cai_env/lib/python3.12/site-packages/textual/events.pyrr&s(rrc,eZdZdZdfd ZddZxZS)CallbackzSent by Textual to invoke a callback (see [call_next][textual.message_pump.MessagePump.call_next] and [call_later][textual.message_pump.MessagePump.call_later]). c0||_t| yN)callbacksuper__init__)selfr% __class__s r r'zCallback.__init__2s   rc#,Kd|jfyw)Nr%)r%r(s r __rich_repr__zCallback.__rich_repr__6s$--'')r%r returnNoner.zrich.repr.Resultrrrrr'r, __classcell__r)s@r r"r"+s (rr"FT)bubbleverbosec&eZdZUdZded<ded<y)CursorPositionz?Internal event used to retrieve the terminal's cursor position.intxyN)rrrr__annotations__rrr r7r7:sI F Frr7)r4ceZdZdZy)Loadz Sent when the App is running but *before* the terminal is in application mode. Use this event to run any setup that doesn't require any visuals such as loading configuration and binding keys. - [ ] Bubbles - [ ] Verbose Nrrrr r=r=Brr=ceZdZdZy)IdlezSent when there are no more items in the message queue. This is a pseudo-event in that it is created by the Textual system and doesn't go through the usual message queue. - [ ] Bubbles - [ ] Verbose Nrrrr r@r@Nrr@c.eZdZdgZdfd ZddZxZS)Actionactionc0t|||_yr$)r&r'rD)r(rDr)s r r'zAction.__init__\s  rc#,Kd|jfyw)NrD)rDr+s r r,zAction.__rich_repr__`s ##r-)rDstrr.r/r0)rrr __slots__r'r,r2r3s@r rCrCYs I$rrCcreZdZdZgdZ d dfd Ze d dZd dZd dZ xZ S) ResizeaSent when the app or widget has been resized. - [ ] Bubbles - [ ] Verbose Args: size: The new size of the Widget. virtual_size: The virtual size (scrollable size) of the Widget. container_size: The size of the Widget's container widget. )size virtual_sizecontainer_sizecj||_ ||_ ||n||_ ||_ t|yr$)rKrLrM pixel_sizer&r')r(rKrLrMrOr)s r r'zResize.__init__rsA )(?&4&, ) in cells. pixels: tuple of (, ) in pixels if known, or `None` if not known. N)r rJ)clscellspixelsrKrOs r from_dimensionszResize.from_dimensionss.U|&,&8T6]d dD$ 33rc"t|tSr$) isinstancerJ)r(messages r can_replacezResize.can_replaces'6**rc#Kd|jfd|j|jfd|j|jfd|jdfyw)NrKrLrMrO)rKrLrMrOr+s r r,zResize.__rich_repr__sTdiid//:: 3 3TYY>>DOOT11sAA)NN) rKr rLr rM Size | NonerOrZr.r/)rRztuple[int, int]rSztuple[int, int] | Noner.rJ)rWz 'Message'r.boolr0) rrrrrHr' classmethodrTrXr,r2r3s@r rJrJds ;I '+"& $     " 4# 4-C 4  4 4+2rrJceZdZdZy)ComposezSent to a widget to request it to compose and mount children. This event is used internally by Textual. You won't typically need to explicitly handle it, - [ ] Bubbles - [X] Verbose Nrrrr r^r^rArr^ceZdZdZy)MountzcSent when a widget is *mounted* and may receive messages. - [ ] Bubbles - [ ] Verbose Nrrrr r`r`rr`ceZdZdZy)UnmountzmSent when a widget is unmounted and may no longer receive messages. - [ ] Bubbles - [ ] Verbose Nrrrr rcrcrarrcceZdZdZy)ShowzPSent when a widget is first displayed. - [ ] Bubbles - [ ] Verbose Nrrrr rererarreceZdZdZy)HideaSent when a widget has been hidden. - [ ] Bubbles - [ ] Verbose Sent when any of the following conditions apply: - The widget is removed from the DOM. - The widget is no longer displayed because it has been scrolled or clipped from the terminal or its container. - The widget has its `display` attribute set to `False`. - The widget's `display` style is set to `"none"`. Nrrrr rgrgs rrgceZdZdZy)ReadyzySent to the `App` when the DOM is ready and the first frame has been displayed. - [ ] Bubbles - [ ] Verbose Nrrrr ririrarric,eZdZdZdfd ZddZxZS) MouseCaptureaSent when the mouse has been captured. - [ ] Bubbles - [ ] Verbose When a mouse has been captured, all further mouse events will be sent to the capturing widget. Args: mouse_position: The position of the mouse when captured. c0t|||_yr$r&r'mouse_positionr(rnr)s r r'zMouseCapture.__init__ ,6rc#,Kd|jfywr$rnr+s r r,zMouseCapture.__rich_repr__D''''r-rnr r.r/r0r1r3s@r rkrks 7 (rrkc,eZdZdZdfd ZddZxZS) MouseReleasezMouse has been released. - [ ] Bubbles - [ ] Verbose Args: mouse_position: The position of the mouse when released. c0t|||_yr$rmros r r'zMouseRelease.__init__rprc#,Kd|jfywr$rrr+s r r,zMouseRelease.__rich_repr__rsr-rtr0r1r3s@r rvrvs7 (rrvceZdZdZy) InputEventzBase class for input events.Nrrrr rzrzs&rrzcjeZdZdZgdZdfd Zd dZed dZed dZ ed dZ xZ S) KeyzSent when the user hits a key on the keyboard. - [X] Bubbles - [ ] Verbose Args: key: The key that was pressed. character: A printable character or `None` if it is not printable. )key characteraliasesct|||_ |t|dk(r|ndn||_ t ||_y)N)r&r'r}lenr~rr)r(r}r~r)s r r'z Key.__init__sJ '090ACHMSty  H"23"7 @rc#Kd|jfd|jfd|jfd|jfd|j|jgfyw)Nr}r~name is_printabler)r}r~rrrr+s r r,zKey.__rich_repr__sZTXXo4>>))diid////z11sAA cHt|jjS)z6Name of a key suitable for use as a Python identifier.)_key_to_identifierr}lowerr+s r rzKey.name$s"$((+1133rcR|jDcgc] }t|c}Scc}w)z9The corresponding name for every alias in `aliases` list.)rr)r(r}s r name_aliaseszKey.name_aliases)s"48<<@C"3'@@@s$cR|jdS|jjS)zCheck if the key is printable (produces a unicode character). Returns: `True` if the key is printable. F)r~ isprintabler+s r rzKey.is_printable.s%.uPDNN4N4N4PPr)r}rGr~ str | Noner.r/r0)r.rG)r.z list[str])r.r[) rrrrrHr'r,propertyrrrr2r3s@r r|r|sZ0I A244AAQQrr|c|jdd}t|dk(r3|jr#d|vr|jddd|}nd|}|j ddj S)zIConvert the key string to a name suitable for use as a Python identifier.+rrz+upper_upper__)splitrisupper rpartitionreplacer)r}key_no_modifierss r rr8syy~b) !&6&>&>&@ #:^^C(+,G4D3EFC+,-C ;;sC & & ((rceZdZdZgdZ d dfd ZeddZeddZeddZ eddZ eddZ edd Z edd Z edd Zedd Zedd Ze ddZddZeddZed dZed dZed dZed!dZej2d"dZd#dZd$dZd%dZxZS)&raSent in response to a mouse event. - [X] Bubbles - [ ] Verbose Args: widget: The widget under the mouse. x: The relative x coordinate. y: The relative y coordinate. delta_x: Change in x since the last message. delta_y: Change in y since the last message. button: Indexed of the pressed button. shift: True if the shift key is pressed. meta: True if the meta key is pressed. ctrl: True if the ctrl key is pressed. screen_x: The absolute x coordinate. screen_y: The absolute y coordinate. style: The Rich Style under the mouse cursor. ) widget_x_y_delta_x_delta_ybuttonshiftmetactrl _screen_x _screen_y_stylec t |||_ ||_ ||_ ||_ ||_ ||_ ||_ ||_ | |_ | |n| |_ | |n| |_ | xs t|_yr$)r&r'rrrrrrrrrrrr r)r(rr9r:delta_xdelta_yrrrrscreen_xscreen_ystyler)s r r'zMouseEvent.__init__hs %+ @(( 1 1 , 1 0 0&.H(&.H(&uw rc,t|jS)z6The relative X coordinate of the cell under the mouse.)r8rr+s r r9z MouseEvent.x477|rc,t|jS)z6The relative Y coordinate of the cell under the mouse.)r8rr+s r r:z MouseEvent.yrrc|jS)z!Change in `x` since last message.)rr+s r rzMouseEvent.delta_x}}rc|jS)z%Change in `y` since the last message.)rr+s r rzMouseEvent.delta_yrrc,t|jS)z8X coordinate of the cell relative to top left of screen.)r8rr+s r rzMouseEvent.screen_x4>>""rc,t|jS)z8Y coordinate of the cell relative to top left of screen.)r8rr+s r rzMouseEvent.screen_yrrc|jS)z)The relative X coordinate of the pointer.)rr+s r pointer_xzMouseEvent.pointer_x wwrc|jS)z)The relative Y coordinate of the pointer.)rr+s r pointer_yzMouseEvent.pointer_yrrc|jS)z7The X coordinate of the pointer relative to the screen.)rr+s r pointer_screen_xzMouseEvent.pointer_screen_x~~rc|jS)z7The Y coordinate of the pointer relative to the screen.)rr+s r pointer_screen_yzMouseEvent.pointer_screen_yrrc|||j|j|j|j|j|j |j |j|j|j|j }|Sr$) rrrrrrrrrrr)rQrevent new_events r from_eventzMouseEvent.from_eventsf  HH HH NN NN LL KK JJ JJ OO OO LL  rc#RK|jd|jfd|jfd|jfd|jfd|j dfd|j df|j|jk7rd|jf|j|jk7rd |jfd |jdfd |jd fd |jd fd|jd f|jrd|jfyyw)Nr9r:rrrrrrrrrFrrr)rr9r:rrrrrrrrrrrrrr+s r r,zMouseEvent.__rich_repr__s kk466k466k4>>))4>>))q((q(( ==DFF "dnn, , ==DFF "dnn, , Q&&tzz5((dii&&dii&& ::4::% % sD%D'c|jSr$rr+s r controlzMouseEvent.controls {{rcBt|j|jS)z[The mouse coordinate as an offset. Returns: Mouse coordinate. )r r9r:r+s r offsetzMouseEvent.offsetsdffdff%%rcBt|j|jS)z(Mouse coordinate relative to the screen.)r rrr+s r screen_offsetzMouseEvent.screen_offsetsdmmT]]33rcBt|j|jS)z1Mouse coordinate delta (change since last event).)r rrr+s r deltazMouseEvent.deltasdllDLL11rc2|jxs tS)z"The (Rich) Style under the cursor.)rr r+s r rzMouseEvent.styles{{%eg%rc||_yr$)r)r(rs r rzMouseEvent.styles  rcV|j|jvry|j|S)aGet offset within a widget's content area, or None if offset is not in content (i.e. padding or border). Args: widget: Widget receiving the event. Returns: An offset where the origin is at the top left of the content area. N)rcontent_regionget_content_offset_capturer(rs r get_content_offsetzMouseEvent.get_content_offset s,   V%:%: :..v66rcH|j|jjz S)a%Get offset from a widget's content area. This method works even if the offset is outside the widget content region. Args: widget: Widget receiving the event. Returns: An offset where the origin is at the top left of the content area. )rguttertop_leftrs r rz%MouseEvent.get_content_offset_captures{{V]]3333rc8|j|j|j|z|j|z|j|j |j |j|j|j|j|j|j S)N) r9r:rrrrrrrrr) r)rrrrrrrrrrrrr(r9r:s r _apply_offsetzMouseEvent._apply_offset#st~~ KKggkggkMMMM;;**^^^^**  r)NNN)r Widget | Noner9floatr:rrr8rr8rr8rr[rr[rr[r float | Nonerrr Style | Noner.r/)r.r8)r.r)rQzType[MouseEventT]rrrrr.rr0)r.r)r.r )r.r )rr r.r/)rrr.z Offset | None)rrr.r )r9r8r:r8r.r)rrrrrHr'rr9r:rrrrrrrrr\rr,rrrrrsetterrrrr2r3s@r rrCs,( I4"&!%"&'&' &'  &'  &'  &'&'&'&'&'&'&'&' &'P#### (.7A &&&&&4422&& \\ 7 4 rceZdZdZy) MouseMovezKSent when the mouse cursor moves. - [X] Bubbles - [X] Verbose Nrrrr rr4rrceZdZdZy) MouseDownzNSent when a mouse button is pressed. - [X] Bubbles - [X] Verbose Nrrrr rr=rrrceZdZdZy)MouseUpzOSent when a mouse button is released. - [X] Bubbles - [X] Verbose Nrrrr rrFrrrceZdZdZy)MouseScrollDownzWSent when the mouse wheel is scrolled *down*. - [X] Bubbles - [X] Verbose Nrrrr rrOrrrceZdZdZy) MouseScrollUpzUSent when the mouse wheel is scrolled *up*. - [X] Bubbles - [X] Verbose Nrrrr rrXrrrceZdZdZy)MouseScrollRightzXSent when the mouse wheel is scrolled *right*. - [X] Bubbles - [X] Verbose Nrrrr rrarrrceZdZdZy)MouseScrollLeftzWSent when the mouse wheel is scrolled *left*. - [X] Bubbles - [X] Verbose Nrrrr rrjrrrceZdZdZ d dfd Ze d d dZd dZd fd ZxZ S) ClickzSent when a widget is clicked. - [X] Bubbles - [ ] Verbose Args: chain: The number of clicks in the chain. 2 is a double click, 3 is a triple click, etc. cHt|||||||||| | | | | |_yr$)r&r'chain)r(rr9r:rrrrrrrrrrr)s r r'zClick.__init__}s?             rc |||j|j|j|j|j|j |j |j|j|j|j| }|S)N)r) r9r:rrrrrrrrr)rQrrrrs r rzClick.from_eventsi  GG GG MM MM LL KK JJ JJ NN NN LL rcN|j|j|j|z|j|z|j|j |j |j|j|j|j|j|j|j S)N) r9r:rrrrrrrrrr)r)rr9r:rrrrrrrrrrrs r rzClick._apply_offsets{~~ KKffqjffqjLLLL;;**]]]]****  rc#^Kt|Ed{d|jfy7w)Nr)r&r,rr(r)s r r,zClick.__rich_repr__s,7(***tzz!! + -+-)NNNr)rrr9r8r:r8rr8rr8rr8rr[rr[rr[r int | Nonerrrrrr8r.r/)r) rQz Type[Self]rrrrrr8r.r )r9r8r:r8r.r r0) rrrrr'r\rrr,r2r3s@r rrss( $#"        @      . """rrcLeZdZdZgdZ d dfd ZddZxZS)rzFSent in response to a timer. - [ ] Bubbles - [X] Verbose )timertimecountr%cZt|||_||_||_||_yr$)r&r'rrrr%)r(rrrr%r)s r r'zTimer.__init__s,      rc#\K|jjd|jfyw)Nr)rrrr+s r r,zTimer.__rich_repr__s#jjootzz!!s*,)rN) rz 'TimerClass'rrrr8r%zTimerCallback | Noner.r/r0)rrrrrHr'r,r2r3s@r rrsQ 7I )- ! ! ! ! ' !  !"rrc<eZdZdZdgZdfd ZeddZxZS)EnteraSent when the mouse is moved over a widget. Note that this event bubbles, so a widget may receive this event when the mouse moves over a child widget. Check the `node` attribute for the widget directly under the mouse. - [X] Bubbles - [X] Verbose nodec2||_ t| yr$rr&r'r(rr)s r r'zEnter.__init__s 0 rc|jS)z%Alias for the `node` under the mouse.rr+s r rz Enter.controlyyrrrr.r/r.r rrrrrHr'rrr2r3s@r rrs*I rrc<eZdZdZdgZdfd ZeddZxZS)LeaveaVSent when the mouse is moved away from a widget, or if a widget is programmatically disabled while hovered. Note that this widget bubbles, so a widget may receive Leave events for any child widgets. Check the `node` parameter for the original widget that was previously under the mouse. - [X] Bubbles - [X] Verbose rc2||_ t| yr$rrs r r'zLeave.__init__ s D rc|jS)z9Alias for the `node` that was previously under the mouse.rr+s r rz Leave.controlrrrrr r3s@r r r s* I rr c2eZdZdZddfd Zdfd ZxZS)FocusaSent when a widget is focussed. - [ ] Bubbles - [ ] Verbose Args: from_app_focus: True if this focus event has been sent because the app itself has regained focus (via an AppFocus event). False if the focus came from within the Textual app (e.g. via the user pressing tab or a programmatic setting of the focused widget). c0||_t| yr$)from_app_focusr&r')r(rr)s r r'zFocus.__init__%s, rc#^Kt|Ed{d|jfy7w)Nr)r&r,rrs r r,zFocus.__rich_repr__)s.7(*** 3 333 +rF)rr[r.r/r0r1r3s@r rrs 44rrceZdZdZy)BlurzVSent when a widget is blurred (un-focussed). - [ ] Bubbles - [ ] Verbose Nrrrr rr.rarrceZdZdZy)AppFocuszSent when the app has focus. - [ ] Bubbles - [ ] Verbose Note: Only available when running within a terminal that supports `FocusIn`, or when running via textual-web. Nrrrr rr6r>rrceZdZdZy)AppBlurzSent when the app loses focus. - [ ] Bubbles - [ ] Verbose Note: Only available when running within a terminal that supports `FocusOut`, or when running via textual-web. Nrrrr rrBr>rrc0eZdZUdZded< eddZy)DescendantFocuszOSent when a child widget is focussed. - [X] Bubbles - [X] Verbose rrc|jS)z0The widget that was focused (alias of `widget`).rr+s r rzDescendantFocus.controlY{{rNr.rrrrrr;rrrrr rrN# N& rrc0eZdZUdZded< eddZy)DescendantBlurzNSent when a child widget is blurred. - [X] Bubbles - [X] Verbose rrc|jS)z0The widget that was blurred (alias of `widget`).rr+s r rzDescendantBlur.controljrrNrrrrr r"r"_r rr"c,eZdZdZdfd ZddZxZS)PasteawEvent containing text that was pasted into the Textual application. This event will only appear when running in a terminal emulator that supports bracketed paste mode. Textual will enable bracketed pastes when an app starts, and disable it when the app shuts down. - [X] Bubbles - [ ] Verbose Args: text: The text that has been pasted. c0t|||_yr$)r&r'text)r(r'r)s r r'zPaste.__init__s  'rc#,Kd|jfyw)Nr')r'r+s r r,zPaste.__rich_repr__sdiir-)r'rGr.r/r0r1r3s@r r%r%ps (  rr%ceZdZdZy) ScreenResumezSSent to screen that has been made active. - [ ] Bubbles - [ ] Verbose Nrrrr r*r*rarr*ceZdZdZy) ScreenSuspendzUSent to screen when it is no longer active. - [ ] Bubbles - [ ] Verbose Nrrrr r,r,rarr,c.eZdZdZddfd ZddZxZS)PrintakSent to a widget that is capturing [`print`][print]. - [ ] Bubbles - [ ] Verbose Args: text: Text that was printed. stderr: `True` if the print was to stderr, or `False` for stdout. Note: Python's [`print`][print] output can be captured with [`App.begin_capture_print`][textual.app.App.begin_capture_print]. c@t|||_ ||_yr$)r&r'r'stderr)r(r'r0r)s r r'zPrint.__init__s"  ( Grc#DK|j|jywr$)r'r0r+s r r,zPrint.__rich_repr__siikks r)r'rGr0r[r.r/r0r1r3s@r r.r.s Hrr.c<eZdZUdZded< dZded< dZded<y) DeliveryCompletez+Sent to App when a file has been delivered.rGr}Nz Path | Nonepathrr)rrrrr;r4rrrr r3r3s/5 H D+D*Err3c8eZdZUdZded< ded< dZded<y) DeliveryFailedz'Sent to App when a file delivery fails.rGr} BaseException exceptionNrr)rrrrr;rrrr r6r6s#1 H8<D*Err6)r}rGr.rG)Nr __future__r dataclassesrpathlibrtypingrrr rich.reprrich rich.styler typing_extensionsr textual._typesr textual.geometryr r textual.keysrtextual.messagerr textual.domr textual.timerr TimerClassrtextual.widgetrreprautorr"r7r=r@rCrJr^r`rcrergrirkrvrzr|rrrrrrrrrrrr rrrrrr"r%r*r,r.r3r6rrr rKss #!//"'))#m<8 #1+%)G)) (uUD ( (  U5    5 5$U$52U552peE4E%eE55 5 E%(5((*(5((&''0Q*0Q0Qf)m Dm m ` 4 4jtjtJtTz$jtU"JtU"p"E%""6E$0E$24E%4,5 uU  eE   eD$      U4     E$  .5E%E%6 FuUF F$  FU5 F  Fr