AHjεhUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZmZmZddlmZddlmZmZmZmZddlmZddlmZdd lmZdd lmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0dd l1m2Z2m3Z3ddl4Z4ddl5Z4dd l6m7Z7dd l8m9Z9m:Z:m;Z;mZ>ddl?m@Z@ddlAmBZBmCZCddlDmEZEddlFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOddlPmQZQmRZRmSZSmTZTddlUmVZVmWZWddlXmYZYmZZZddl[m\Z\ddl]m^Z^ddl_m`Z`ddlambZbmcZcddlamdZeddlfmgZgddlhmiZimjZjddlkmlZlddlmmnZnmoZompZpddlqmrZrdd lsmtZtdd!lumvZvmwZwdd"lxmyZydd#lzm{Z{dd$l|m}Z}m~Z~mZmZdd%lmZmZmZmZdd&lmZdd'lmZdd(lmZdd)lmZdd*lmZmZdd+lmZmZdd,lmZdd-lmZdd.lmZmZdd/lmZdd0lmZmZmZmZdd1lmZmZmZdd2lmZmZmZmZmZdd3lmZmZdd4lmZmZmZmZdd5lmZdd6lmZdd7lmZmZmZmZmZdd8lmZdd9lmZmZmZdd:lmZdd;lmZmZddlmZmZdd?lmZerRaised when trying to manipulate the screen stack incorrectly.NrrrrrrsHrrceZdZdZy) ModeErrorz+Base class for exceptions related to modes.Nrrrrrrs5rrceZdZdZy)InvalidModeErrorz-Raised if there is an issue with a mode name.Nrrrrrrs7rrceZdZdZy)UnknownModeErrorz7Raised when attempting to use a mode that is not known.NrrrrrrsArrceZdZdZy)ActiveModeErrorz;Raised when attempting to remove the currently active mode.NrrrrrrsErrceZdZdZy)SuspendNotSupportedzRaised if suspending the application is not supported. This exception is raised if [`App.suspend`][textual.app.App.suspend] is called while the application is running in an environment where this isn't supported. NrrrrrrsrrceZdZdZy)InvalidThemeErrorz$Raised when an invalid theme is set.Nrrrrrrs.rr ReturnTypeCallThreadReturnTypec(eZdZdZddZddZddZy) _NullFilez$A file-like where writes go nowhere.cyNrselftexts rwritez_NullFile.write rcyrrrs rflushz_NullFile.flushrrcyNTrrs risattyz_NullFile.isattysrNrrreturnNonerrrr)rrrrrrrrrrrrs.  rrc:eZdZdZdd dZd dZd dZd dZd dZy) _PrintCapturez"A file-like which captures output.c ||_||_y)z^ Args: app: App instance. stderr: Write from stderr. N)appstderr)rrrs r__init__z_PrintCapture.__init__s rcR|jj||jy)zkCalled when writing to stdout or stderr. Args: text: Text that was "printed". rN)r_printrrs rrz_PrintCapture.writes T[[1rcP|jj|jy)z)Called when stdout or stderr was flushed.rN)r_flushrrs rrz_PrintCapture.flushs t{{+rcy)zPretend we're a terminal.Trrs rrz_PrintCapture.isattyrcy)zReturn invalid fileno.rrs rfilenoz_PrintCapture.fileno"srNF)rApprrrrrrrrint) rrrrrrrrrrrrrrs,2, rrceZdZUdZdZded< ded<dZiZded< d Zded < iZ d ed < d Z ded< dZ ded< dZ ded<dZ ded< dZded< dZded< dZded< dZded< ehZded< d Zded!< dZded"< d#Zded$< d%Zded&< ed'd(d)d*d+d,ed-d.d+d/gZd0ed1< d2Zd3ed4< d%Zd5ed6< dZded7< dZded8< d9Zd:ed;< dZded<< gZ d=ed>< gZ!d=ed?< d@dAdBdCdDdEdFdGZ"dHedI<e#dd+JZ$dKedL< e#dd+JZ%dKedM< e#dd+JZ& e#e'jPZ)dKedN< e#e*d+OZ+ e#e,d+OZ- e#d+Z. d= d>fdP Z/d?dQZ0e1d@dRZ2e3dAdSZ4dBfdT Z5dUZ6dCdVZ7dDdWZ8dEdXZ9e1dFdYZ:e1dGdZZ;e1dHd[Ze1dKd^Z?dLd_Z@eAdMd`ZBdBdaZCdBdbZDdNdOdcZEeAdMddZFdPdeZGdfdddgeHddhdi dQdjZIdRdSdkZJe1d@dlZKe1d@dmZLe1d@dnZMe1d@doZNe1d@dpZOe1d@dqZPe1dTdrZQe1dTdsZRe1dKdtZSe1dUduZT dV dWdvZUe1dXdwZVe1dYdxZWdZdyZXdFdzZYd[d{ZZd\d|Z[d\d}Z\d]d~Z]d^dZ^d_dZ_e1d`dZ`e1dadZadbdZbd_dZcdBdZddcdZedcdZfe1dddZgdcdZhdedZidfdZje1dgdZke1dhdZle1didZme1djdZne1djdZodkdZpe1dldZq dmdZrdndZsdodZt dpdZudBdZv dq drdZwdd+d dsdZx dt dudZy dt dvdZz dw dxdZ{dBdZ|dddd dydZ}dzdZ~d{dZd|d}dZd|d~dZ d ddZddZeddd+d+dd ddZd+d+d+dddd ddZd+d+d+ddddd ddZdBdZddZedeZereddZe ddZ d ddZereddZe ddZ d ddZddZddZddd ddZddd ddZddZddZddZddZddZedd„ZeddÄZe d ddĄZe d ddńZ d ddƄZddDŽZddȄZddɄZer*e d ddʄZe d dd˄Z d dd̄Zere dd̈́Zedd΄Z ddτZddЄZddфZdd҄ZddӄZddԄZdRddՄZ ddքZddׄZdd؄ZddلZddڄZdBdۄZdBd܄Z dd݄ZdބZ d dd߄Zd@dZdBdZdBdZdBdZdBdZ ddZdddd ddZddZdZddZddZdBdZdBdZdBdZdd+d+d ddZdRddZddZdBdZddZdBdZe1ddZĐddZŐd|ddZƐdBdZeȐddZɐddZʐddZ ddZ̐dfd Ze1d@dZ d ddZ ddZ dq ddZ ddZ dÐdZӐdĐdZԐdŐdZՐdƐdZ֐dǐdZאdȐd Zؐdɐd Zdd dʐd Zڐdːd ZېddZܐdBdZݐdBdZސd̐dZߐd͐dZd͐dZdBdZdΐdZdBdZdϐdZdϐdZdϐdZdBdZdBdZdBdZdBdZdBdZ d dѐd Z dҐd!ZdBd"ZdBd#ZdBd$ZdBd%Zddddd& dӐd'ZdԐd(ZdRdՐd)ZdBd*ZdBd+ZdBd,ZeejdBd-ZeAd֐d.ZdBd/Zdd0dאd1Zddd2dddd3 dؐd4Zddd2ddd5 dِd6Zdddd7 dڐd8Zeejdېd9Zeej dېd:Zeejdܐd;Z dBd<Z xZ S(rz(The base class for Textual Applications.z ClassVar[str]CSS DEFAULT_CSSa% App { background: $background; color: $foreground; &:ansi { background: ansi_default; color: ansi_default; .-ansi-scrollbar { scrollbar-background: ansi_default; scrollbar-background-hover: ansi_default; scrollbar-background-active: ansi_default; scrollbar-color: ansi_blue; scrollbar-color-active: ansi_bright_blue; scrollbar-color-hover: ansi_bright_blue; scrollbar-corner-color: ansi_default; } .bindings-table--key { color: ansi_magenta; } .bindings-table--description { color: ansi_default; } .bindings-table--header { color: ansi_default; } .bindings-table--divider { color: transparent; text-style: dim; } } /* When a widget is maximized */ Screen.-maximized-view { layout: vertical !important; hatch: right $panel; overflow-y: auto !important; align: center middle; .-maximized { dock: initial !important; } } /* Fade the header title when app is blurred */ &:blur HeaderTitle { text-opacity: 50%; } } *:disabled:can-focus { opacity: 0.7; } z/ClassVar[dict[str, str | Callable[[], Screen]]]MODES_default DEFAULT_MODEz.ClassVar[dict[str, Callable[[], Screen[Any]]]]SCREENS*zClassVar[str | None] AUTO_FOCUSTzClassVar[bool] ALLOW_SELECTN str | None _BASE_PATHzClassVar[CSSPathType | None]CSS_PATHTITLE SUB_TITLEENABLE_COMMAND_PALETTEzClassVar[float]NOTIFICATION_TIMEOUTzz App.s S]]rc|j Srr&r(s rr)z App.s  -rc.|jjSr current_themedarkr(s rr)z App.sC--22rc0|jj Srr,r(s rr)z App.s!2!2!7!77rc|jSr) is_inliner(s rr)z App.s cmmrc|jSr) ansi_colorr(s rr)z App.s CNNrc|jSr)no_colorr(s rr)z App.s s||r)focusblurr.lightinlineansinocolorz/ClassVar[dict[str, Callable[[App[Any]], bool]]]_PSEUDO_CLASSES)computez Reactive[str]r sub_titletheme)initc t|_t| |jt t jdd|_i|_ tjD]}|j||jjr |jn |j }|j#t$j&|t)|| g|_t-t j.}|j1dddu|_|j2r9|j*j5|j&r t7n t9t:j<j?dD]I}|jAjC} | dk(s'|j*j5tEKtGt:jHtKd d d d |d d d |_&tO||_(tGd d d |_)|xs|jU|_+|jXgi|_- |jX|_. d |_/d|_0 d|_1 d|_2d|_3g|_4hd |_5tm||_7|jnjq||_9tudd|_;d|_< d|_= d|_> d|_? tudd|_@ tudd|_A d|_B |j |jn|jj|_F |j |jnd|_H |j|_J t|j||_Md |_Ni|_O t|j|_R|xs |j}| t|ngDcgc]}t||} }| |_Vt|_Xi|_Yd|_Z d|_[ i|_\|jjd#i|j|jj|_a g|_bg|_cd |_dd|_ed|_fd|jvr? ddlgmh} ddlimj} | t:j|_e| |j|_fd|_md|_n d|_o d |_pd |_qd |_r|s |jr t|j|jnd|_vd|_wd |_xd|_yt|_{t|_} t|d |_ t|d |_ tj|_ tj|_ t |d|_ t |d|_ t |d|_ |j|jjdd |j|jj dd t:j|_ d|_ d|_ d|_ d|_d|_ d|_ d |_ d|_ |jrk|j*D]\} }|j,dvsy|j*j/t1|j2dd d |j4d d!"yycc}w#t$rYVwxYw)$aCreate an instance of an app. Args: driver_class: Driver class or `None` to auto-detect. This will be used by some Textual tools. css_path: Path to CSS or `None` to use the `CSS_PATH` class variable. To load multiple CSS files, pass a list of strings or paths which will be loaded in order. watch_css: Reload CSS if the files changed. This is set automatically if you are using `textual run` with the `dev` switch. ansi_color: Allow ANSI colors if `True`, or convert ANSI colors to to RGB if `False`. Raises: CssPathError: When the supplied CSS path(s) are an unexpected type. )classesTEXTUALrenabledNO_COLORN,dimTF) color_systemfilemarkup highlightemojilegacy_windows_environforce_terminalsafe_box soft_wrap)rKrLr>rscreenfocusedrr r() variablesg@g@devtoolsr)StdoutRedirectorrz theme-changedz app-suspendz app-resume -dark-modeupdate -light-mode>app.command_palettecommand_paletter]palettezOpen the command palette)r key_displayrrr)r _start_timesuperrDEFAULT_CLASSESreosgetenvfeatures_registered_themesrvaluesregister_themer-r.ansi_theme_darkansi_theme_light set_reactiverr3rg_filtersdictenvironpopr5appendrjrir2FILTERSsplitlowerstriprhr$ COLOR_SYSTEMrconsoler_workers error_consoleget_driver_class driver_classr_screen_stacks _current_mode_sync_available mouse_over hover_overmouse_captured_driver_exit_renderables_action_targetsr9 _animatorbind_animaterkmouse_position_mouse_down_widget_click_chain_last_offset_click_chain_last_time_chained_clicks_previous_cursor_positioncursor_position _exceptionr __class__rrrr>r use_command_paletter._log_logger_css_has_errorstheme_variablesr_get_css_variables stylesheetrrJrKcss_pathr" _registry_keymapscroll_sensitivity_xscroll_sensitivity_y_installed_screensrZrrcopy_modes_compose_stacks _composed_recompose_requiredrV_devtools_redirectortextual_dev.clientrtextual_dev.redirect_outputrW DEVTOOLS_HOST ImportError_loop _return_value _return_code_exit_disable_tooltips_disable_notificationsdebugrf_on_css_change css_monitor _screenshot _dom_ready _batch_countrv_notificationsr!_capture_printr_capture_stdout_capture_stderrsys __stdout___original_stdout __stderr___original_stderrrtheme_changed_signalapp_suspend_signalapp_resume_signal set_classTEXTUAL_ANIMATIONSanimation_level_last_focused_on_app_blur_previous_inline_height _resize_event_size_css_update_count _clipboardsupports_smooth_scrolling_compose_screen _bindingsaction _add_bindingrRr r)rrzr watch_cssr3r? ansi_themern filter_namefilter css_pathsrrW_keybindingrs rrz App.__init__#s,(> !5!560>ryyTV?W0X 46 .$**, 'E    & '%)$6$6$;$;D AVAV  #..*5 JJ ?+  rzz" J5TA == MM doo:< P$,,2237 2K &&(..0F $$Y[1 2 "//    &d+ $EU4P(CD,A,A,C=A=N=NPR>+E2 *.)D)D  diiT2 $/19%t/E/E/GH,t}}5=4H&x0b  'x 6  " +29! ,/!T+.!RLN&&&66=AZZ__=N I35-/#( /3 =A!  & L=H !/y/F/F G ,>%OO ++44)!"$($@$@!% :  'K D  s+\/, \44 ]]cZ|jDcgc]}|js|c}Scc}w)zGet currently enabled line filters. Returns: A list of [LineFilter][textual.filters.LineFilter] instances. )rlrE)rrs rget_line_filterszApp.get_line_filtersTs" &*]]E6fnnEEEs((cN|jduxr|jjS)z%Is the app connected to the devtools?N)rV is_connectedrs r_is_devtools_connectedzApp._is_devtools_connected\s"}}D(GT]]-G-GGrc*tjS)zBAn event that will be set when the first exception is encountered.)asyncioEventrs r_exception_eventzApp._exception_eventas}}rc \d|jfd|jffD]~\}}|jD]f\}}t|trt |r#t|t r't|dt|jd|dtd|t|0|i|S)NrrzL should contain a Screen type or callable, not an instance (got instance of  for )z#expected a callable or string, got ) rritems isinstancercallabler| ValueErrortyper TypeErrorra__init_subclass__)clsargskwargs variable_namescreen_collection screen_name screen_objectrs rrzApp.__init_subclass__fs  $ cii 1  ,M,/@.E.E.G * ]"=#6(=:Q!-8(,o.115m1D1M1M0NeT_Sbbce$=m=NO  w($9&99rc~|j|j|jtj|_y)z|Initialize threading primitives for the current thread. https://github.com/Textualize/textual/issues/5845 N)_message_queue_mounted_eventr threading get_ident _thread_idrs r _thread_initzApp._thread_initxs/   #--/rc|jS)z@When querying from the app, we want to query the default screen.)default_screenrs r _get_dom_basezApp._get_dom_bases"""rct|S)z'Make sure the title is set to a string.r)rrs rvalidate_titlezApp.validate_titles 5zrct|S)z*Make sure the subtitle is set to a string.r)rr>s rvalidate_sub_titlezApp.validate_sub_titles 9~rcJ|j |jS|jS)zThe default screen instance.)rrSrs rrzApp.default_screens$#22:t{{T@T@TTrc|jS)zjThe [worker](/guide/workers/) manager. Returns: An object to manage workers. )rwrs rworkersz App.workerss}}rc|jS)zThe return value of the app, or `None` if it has not yet been set. The return value is set when calling [exit][textual.app.App.exit]. )rrs r return_valuezApp.return_values !!!rc|jS)aThe return code with which the app exited. Non-zero codes indicate errors. A value of 1 means the app exited with a fatal error. If the app hasn't exited yet, this will be `None`. Example: The return code can be used to exit the process via `sys.exit`. ```py my_app.run() sys.exit(my_app.return_code) ``` )rrs r return_codezApp.return_codes   rcn tdt|jDfS#t$rYywxYw)aA view onto the app's immediate children. This attribute exists on all widgets. In the case of the App, it will only ever contain a single child, which will be the currently active screen. Returns: A sequence of widgets. c3@K|]}t|ts|ywr)rr).0rSs r zApp.children..s#%f.?@sr)nextreversed _screen_stack StopIterationrs rchildrenz App.childrensE "*4+=+=">   s %( 44c|jS)zThe value of the local clipboard. Note, that this only contains text copied in the app, and not text copied from elsewhere in the OS. )rrs r clipboardz App.clipboardsrct|}t|}|r&tj|d|jdS|S)zFormat the title for display. Args: title: The title. sub_title: The sub title. Returns: Content instance with title and subtitle. )u — rHrH)r[assemblestylize)rrr> title_contentsub_title_contents r format_titlezApp.format_titlesJ  #I. ## !))%0  ! rc#K|j d|jy#|jwxYww)zEA context manager to suspend all repaints until the end of the batch.N) _begin_batch _end_batchrs r batch_updatezApp.batch_updates0    OO DOO s>)>;>c.|xjdz c_y)zBegin a batch update.r N)rrs rrzApp._begin_batchs Qrc|xjdzc_|jdk\sJd|js|jyy)zEnd a batch update.r rz+This won't happen if you use `batch_update`N)r check_idlers rrzApp._end_batchsE Q  A%T'TT%  OO !rcZjdfd }j||dy)zDelay updates for a short period of time. May be used to mask a brief transition. Consider this method only if you aren't able to use `App.batch_update`. Args: delay: Delay before updating. ctjjsjjyy)z&Re-enable updates, and refresh screen.N)rrrSrefreshrsr end_batchz#App.delay_update..end_batch s+ OO $$ ##%%r delay_updatenameNr)r set_timer)rdelayrs` rr zApp.delay_updates*  & uin=rc#Ktj|}tj|} dtj|tj|y#tj|tj|wxYww)z#Context manager to set ContextVars.N)rBsetrCreset)rapp_reset_tokenmessage_pump_reset_tokens r_contextz App._contextsl%...#6#:#:4#@  .   % %&> ?   _ - % %&> ?   _ -s+B A+B ,B  B cX|jD]}t|ts| |_y)z@Enable or disable the truecolor filter when the reactive changesN)rlrrgrE)rr3rs r_watch_ansi_colorzApp._watch_ansi_colors(mm 0F&/2%/ 0r.gfull final_valuedurationspeedr$easing on_completelevelc 8|j|||||||||  y)aAnimate an attribute. See the guide for how to use the [animation](/guide/animation) system. Args: attribute: Name of the attribute to animate. value: The value to animate to. final_value: The final value of the animation. duration: The duration (in seconds) of the animation. speed: The speed of the animation. delay: A delay (in seconds) before the animation starts. easing: An easing method. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). r.N)r) r attributevaluer/r0r1r$r2r3r4s ranimatez App.animate"s08  ##  rcZK|jj|||d{y7w)a+Stop an animation on an attribute. Args: attribute: Name of the attribute whose animation should be stopped. complete: Should the animation be set to its final value? Note: If there is no animation scheduled or running, this is a no-op. N)rstop_animation)rr6completes rr:zApp.stop_animationJs$nn++D)XFFFs !+)+cy)z#Is this a root node (i.e. the App)?Trrs r is_dom_rootzApp.is_dom_rootVrrcy)z/Is this node linked to the app through the DOM?Trrs r is_attachedzApp.is_attached[rrcBd|jvxstjS)zIs debug mode enabled?r)rer2DEBUGrs rrz App.debug`s$--':9??:rcJ|jdS|jjS)zIs the app running in 'headless' mode? Headless mode is used when running tests with [run_test][textual.app.App.run_test]. F)r is_headlessrs rrCzApp.is_headlesses"  ,uJ$,,2J2JJrcJ|jdS|jjS)z$Is the app running in 'inline' mode?F)rr1rs rr1z App.is_inlinems" ,uH$,,2H2HHrcJ|jdS|jjS)z/Is the app running in 'web' mode via a browser?F)ris_webrs rrFz App.is_webrs" ,uE$,,2E2EErcP|j|jjS)zA snapshot of the current screen stack. Returns: A snapshot of the current state of the screen stack. )r{r|rrs r screen_stackzApp.screen_stackws$""4#5#56;;==rc4|j|jS)zA reference to the current screen stack. Note: Consider using [`screen_stack`][textual.app.App.screen_stack] instead. Returns: A reference to the current screen stack. )r{r|rs rr zApp._screen_stacks""4#5#566rc|jS)z&The name of the currently active mode.)r|rs r current_modezApp.current_modes!!!rc t|j}|j}t|j||j d|j |j|jS)zGet options for the Rich console. Returns: Console options (same object returned from `console.options`). r ) max_heightsizerN min_width max_widthencoding is_terminal) r%rNrvr&heightrNwidthrQrR)rrNrvs rconsole_optionszApp.console_optionssW!$)),,,{{"11jj%%++  rcd|_||_||_|jt j |r|j j|yy)zExit the app, and return the supplied result. Args: result: Return value. return_code: The return code. Use non-zero values for error codes. message: Optional message to display on exit. TN)rrr post_messager5ExitApprrp)rresultrmessages rexitzApp.exitsN #' (**,-   " " ) )' 2 rcP|jj}| |jry|S)zThe widget that is focused on the currently active screen, or `None`. Focused widgets receive keyboard input. Returns: The currently focused widget, or `None` if nothing is focused. N)rSrTloading)rrTs rrTz App.focuseds'++%%  7??rc.|jjS)anGet currently active bindings. If no widget is focused, then app-level bindings are returned. If a widget is focused, then any bindings present in the active screen and app are merged and returned. This property may be used to inspect current bindings. Returns: A dict that maps keys on to binding information. )rSactive_bindingsrs rr_zApp.active_bindingss{{***rc#Kjstddjtddj|j drtddj ntdd j |jtd d |jn;|j/|jjrtd d|jtddfdy w)aA generator of system commands used in the command palette. Args: screen: The screen where the command palette was invoked from. Implement this method in your App subclass if you want to add custom commands. Here is an example: ```python def get_system_commands(self, screen: Screen) -> Iterable[SystemCommand]: yield from super().get_system_commands(screen) yield SystemCommand("Bell", "Ring the bell", self.bell) ``` !!! note Requires that [`SystemCommandsProvider`][textual.system_commands.SystemCommandsProvider] is in `App.COMMANDS` class variable. Yields: [SystemCommand][textual.app.SystemCommand] instances. z Change themezChange the current themezQuit the applicationz(Quit the application as soon as possible HelpPanelzHide keys and help panelz#Hide the keys and widget help panelzShow keys and help panelz@Show help for the focused widget and a summary of available keysNMinimizez.Minimize the widget and restore to normal sizeMaximizezMaximize the focused widgetzSave screenshotz.Save an SVG 'screenshot' of the current screenc<jdjS)Ng?)r#deliver_screenshotrsrr)z)App.get_system_commands..sDNN3(?(?@r) r3raction_change_theme action_quitqueryaction_hide_help_panelaction_show_help_panel maximizedaction_minimizerTallow_maximizeaction_maximizerrSs` rget_system_commandszApp.get_system_commandss**((   " 6     << $*5++   *R++     '@&&  ^^ 'FNN,I,I96;Q;Q   < @  sC7C:ctdS)a4Get the default screen. This is called when the App is first composed. The returned screen instance will be the first screen on the stack. Implement this method if you would like to use a custom Screen as the default screen. Returns: A screen instance. rid)r|rs rget_default_screenzApp.get_default_screens$$rc#$KdEd{y7w)zgYield child widgets for a container. This method should be implemented in a subclass. rNrrs rrZz App.compose s  s ciS)aGet the default values for the `variables` used in a theme. If the currently specified theme doesn't define a value for a variable, the value specified here will be used as a fallback. If a variable is referenced in CSS but does not appear either here or in the theme, the CSS will fail to parse on startup. This method allows applications to define their own variables, beyond those offered by Textual, which can then be overridden by a Theme. Returns: A mapping of variable name (e.g. "my-button-background-color") to value. Values can be any valid CSS value, e.g. "red 50%", "auto 90%", "#ff0000", "rgb(255, 0, 0)", etc. rrs rget_theme_variable_defaultszApp.get_theme_variable_defaults's " rc|j}|jj}i||j}|j }i||}||_|S)zGet a mapping of variables used to pre-populate CSS. May be implemented in a subclass to add new CSS variables. Returns: A mapping of variable name to value. )r-to_color_systemgeneraterUrwr)rr?rUrcombined_variabless rrzApp.get_css_variables:sg""))+446 6y6U__6 ::<==9=1!!rc|jdDcgc]}|j}}|D]!}||jvs|j|cSycc}w)aGet a theme by name. Args: theme_name: The name of the theme to get. May also be a comma separated list of names, to pick the first available theme. Returns: A Theme instance and None if the theme doesn't exist. rGN)rrrtavailable_themes)r theme_nametoken theme_namess r get_themez App.get_themeNsa3=2B2B32GHu{{}H H% 9JT222,,Z88 9 IsAc6||j|j<y)aKRegister a theme with the app. If the theme already exists, it will be overridden. After registering a theme, you can activate it by setting the `App.theme` attribute. To retrieve a registered theme, use the `App.get_theme` method. Args: theme: The theme to register. N)rfr"rr?s rrhzApp.register_theme^s/4 +rc<||jvr|j|=yy)zuUnregister a theme with the app. Args: theme_name: The name of the theme to unregister. Nrf)rr~s runregister_themezApp.unregister_themels% 00 0'' 3 1rci|jS)zAll available themes (all built-in themes plus any that have been registered). A dictionary mapping theme names to Theme instances. rrs rr}zApp.available_themesus +$))**rcj|j|j}||jd}|J|S)N textual-dark)rr?rs rr-zApp.current_theme}s8tzz* =NN>2E    rcD||jvrd|d}t||S)NzTheme z] has not been registered. Call 'App.register_theme' before setting the 'App.theme' attribute.)r}r)rr~rZs r_validate_themezApp._validate_themes; T22 2'VV $G, ,rc|j}|j}|dk(|_|j|dd|j| dd|j |j |j |jt|jd|j|jj|y)zsApply a theme to the application. This method is called when the theme reactive attribute is set. z textual-ansirXFrYr[r8N) r-r.r3r_refresh_truecolor_filterr_invalidate_css call_nextr refresh_cssrpublish)rr~r?r.s r _watch_themezApp._watch_themes ""zz$6 t\%8 4xu= &&t7  wt//?@ t0088%@rc.|xjdz c_y)z(Invalidate CSS, so it will be refreshed.r N)rrs rrzApp._invalidate_csss !#rc|jjr=|j||j|j |j yyrr-r.rrrrrs rwatch_ansi_theme_darkzApp.watch_ansi_theme_darksB    " "  * *5 1  " NN4++ , #rc|jjs=|j||j|j |j yyrrrs rwatch_ansi_theme_lightzApp.watch_ansi_theme_lightsB!!&&  * *5 1  " NN4++ ,'rc^|jjr |jS|jS)zThe ANSI TerminalTheme currently being used. Defines how colors defined as ANSI (e.g. `magenta`) inside Rich renderables are mapped to hex codes. )r-r.rirjrs rrzApp.ansi_themes.%)$6$6$;$;D  AEAVAV rc|j}t|D]2\}}t|tst||j ||<yy)zUpdate the ANSI to Truecolor filter, if available, with a new theme mapping. Args: theme: The new terminal theme to use for mapping ANSI to truecolor. rDN)rl enumeraterrgr3)rr?filtersindexrs rrzApp._refresh_truecolor_filtersI --&w/ ME6&/2!0DOO@S!T rc8tj}|o|jd\}}}tj|}t ||}t j|rt|tstd|d|d|Str ddl m }|}|Sddlm}|}|S)zGet a driver class for this platform. This method is called by the constructor, and unlikely to be required when building a Textual app. Returns: A Driver class which manages input and display. :zUnable to import z; z is not a Driver class r) WindowsDriver) LinuxDriver)r2DRIVER partition importlib import_modulegetattrinspectisclass issubclassrb RuntimeErrorWINDOWStextual.drivers.windows_driverrtextual.drivers.linux_driverr) r driver_import module_import_ driver_symbol driver_modulerzrrs rryzApp.get_driver_classs"((  $/<.E.Ec.J +M1m%33MBM"=-@L??<0 f9#' '8<:JJab   D(L  A&Lrc# Kd|jfd|jdf|jrd|jf|jrdt |jf|j }|rdt |fyyw)Nrrsr"rBpseudo_classes)rrsr"rBr&r)rrs r __rich_repr__zApp.__rich_repr__sztzz!!DGGT!! 99$))# # <<S.. .,, "C$77 7 sBBc|jS)zThe animator object.)rrs ranimatorz App.animators~~rc |jdS#t$rtd|jdt$r t ddwxYw)zThe current active screen. Returns: The currently active (visible) screen. Raises: ScreenStackError: If there are no screens on the stack. rNo known mode NzNo screens on stack)r KeyErrorrr| IndexErrorrrs rrSz App.screens] D%%b) ) V"^D4F4F3I#JKQU U D"#89t C Ds 7Acg}t|jddD]8}|j||jjj dk(s8n|ddd}|S)zoA list of screens that may be visible due to background opacity (top-most first, not including current screen).Nrr )r r rpstyles backgrounda)rscreensrSbackground_screenss r_background_screenszApp._background_screens sg!#t11#267 F NN6 "}}''))Q. %TrT]!!rc|j |jS|j0|jj|jj\}}n|jj\}}t ||S)zVThe size of the terminal. Returns: Size of the terminal. )rrrvrNrm)rrTrSs rrNzApp.sizesd :: !::  << # (:(:(F LL..ME6 LL--ME6E6""rcr |jjS#ttf$r|jcYSwxYw)z+Get the viewport size (size of the screen).)rSrNrrars r viewport_sizezApp.viewport_size$s5 ;;## # (+ 99  s 66cX|jtfd|jDS)zkGet the inline height (height when in inline mode). Returns: Height in lines. c3@K|]}|jywr)_get_inline_height)rrSrNs rrz)App._get_inline_height..3sTv6,,T2Ts)rNmaxr )rrNs @rrzApp._get_inline_height,s% yyTASASTTTrc|jS)zThe textual logger. Example: ```python self.log("Hello, World!") self.log(self.tree) ``` Returns: A Textual logger. )rrs rr4zApp.log5s||rc"|j}| |jsy|jtjjkDr |j sy ddlm}t|dk(r|s|j|||||ydjd|D}|r1djd|jD} |r|d| n| }|j|||||y#t$r} |j| Yd} ~ yd} ~ wwxYw) avWrite to logs or devtools. Positional args will be logged. Keyword args will be prefixed with the key. Example: ```python data = [1,2,3] self.log("Hello, World", state=data) self.log(self.tree) self.log(locals()) ``` Args: verbosity: Verbosity level 0-3. Nr) DevtoolsLogr )caller c32K|]}t|ywrr)rargs rrzApp._log..ms!>s#c(!>c30K|]\}}|d|yw)=Nr)rkeyr7s rrzApp._log..os$*/9sE3%q **s)rVrr7r0NORMALverboserrlenr4joinr Exception_handle_exception) rgroup verbosity_textual_calling_frameobjectsrrVroutput key_valueserrors rrzApp._logDs0==  8#8#8  ??\0066 6x?O?O  * 67|q  0FG !>g!>>!$*=C\\^*"J:@xq 5ZF /EF  *  " "5 ) ) *s1C*A&C** D3D  Dcddlm}|S)zGet a widget to be used as a loading indicator. Extend this method if you want to display the loading state a little differently. Returns: A widget to display a loading state. r)LoadingIndicator)textual.widgetsr)rrs rget_loading_widgetzApp.get_loading_widget{s 5!!rc||_|jyddl}|j|j dj d}|jj d|dy)zCopy text to the clipboard. !!! note This does not work on macOS Terminal, but will work on most other terminals. Args: text: Text you wish to copy to the clipboard. Nrutf-8z]52;c;)rrbase64 b64encodeencodedecoder)rrr base64_texts rcopy_to_clipboardzApp.copy_to_clipboardsZ <<  &&t{{7';<CCGL  Z }B78rc(j tdjtjk(r tdt |g|i|dfd }t j|j}|j}|S)aORun a callable from another thread, and return the result. Like asyncio apps in general, Textual apps are not thread-safe. If you call methods or set attributes on Textual objects from a thread, you may get unpredictable results. This method will ensure that your code runs within the correct context. !!! tip Consider using [post_message][textual.message_pump.MessagePump.post_message] which is also thread-safe. Args: callback: A callable to run. *args: Arguments to the callback. **kwargs: Keyword arguments for the callback. Raises: RuntimeError: If the app isn't running or if this method is called from the same thread where the app is running. Returns: The result of the callback. zApp is not runningzIThe `call_from_thread` method must run in a different thread from the appcKj5td{cdddS7 #1swYyxYww)z8Run the callback, set the result or error on the future.N)r*r?)callback_with_argsrsr run_callbackz*App.call_from_thread..run_callbacks9 8#$677 8 87 8 8s ?313 ?3<?loop)rr) rrrrrr rrun_coroutine_threadsaferY)rrrrrfuturerYrs` @rcall_from_threadzApp.call_from_threads< :: 34 4 ??i113 3[ %X??? 8 07/O/O N0  rc$|jy)z8An [action](/guide/actions) to change the current theme.N) search_themesrs rrfzApp.action_change_themes rc(|j||y)aThis [action](/guide/actions) will save an SVG file containing the current contents of the screen. Args: filename: Filename of screenshot, or None to auto-generate. path: Path to directory. Defaults to the user's Downloads directory. N)re)rfilenamepaths raction_screenshotzApp.action_screenshots $/r)rsimplifyc j|jJd|j\}}t||tjddddd}|j j jd|jj|}|j||j|xs |jS)awExport an SVG screenshot of the current screen. See also [save_screenshot][textual.app.App.save_screenshot] which writes the screenshot to a file. Args: title: The title of the exported screenshot or None to use app title. simplify: Simplify the segments by combining contiguous segments with the same style. zApp must be runningT truecolorF)rTrSrJrPrIrecordrNrQ)r-rHrr) rrNr$ioStringIOrS _compositor render_updaterrprint export_svgr)rrrrTrSrv screen_renders rexport_screenshotzApp.export_screenshots||'>)>>' v$    //==DHH$@$@8>   m$!!(;!< * + +s >BB$c|st|jd|}n|}|j}|jt j |||dddS)aDeliver a screenshot of the app. This with save the screenshot when running locally, or serve it when the app is running in a web browser. Args: filename: Filename of SVG screenshot, or None to auto-generate a filename with the date and time. path: Path to directory for output when saving locally (not used when app is running in the browser). Defaults to current working directory. time_format: Date and time format to use if filename is None. Defaults to a format like ISO 8601 with some reserved characters replaced with underscores. Returns: The delivery key that uniquely identifies the file delivery. r browserz image/svg+xml screenshotsave_directory save_filename open_method mime_typer")rHrr  deliver_textrr)rrrrrrs rrezApp.deliver_screenshots_,5djj&+VL#L//1  KK '&!% !  rcd|jtt|j|g|S)aShow a list of commands in the app. Args: commands: A list of SimpleCommand instances. placeholder: Placeholder text for the search field. Returns: AwaitMount: An awaitable that resolves when the commands are shown.  providers placeholder) push_screenrWrYrS)rcommandsr#s rsearch_commandszApp.search_commands?s3 )$++x@A'   rcF|jttgdy)zShow a fuzzy search command palette containing all registered themes. Selecting a theme in the list will change the app's theme. uSearch for themes…r!N)r$rWrrs rrzApp.search_themesTs"  (/2  r) descriptionrr_cD|jj|||||y)aBind a key to an action. !!! warning This method may be private or removed in a future version of Textual. See [dynamic actions](/guide/actions#dynamic-actions) for a more flexible alternative to updating bindings. Args: keys: A comma separated list of keys, i.e. action: Action to bind to. description: Short description of action. show: Show key in UI. key_display: Replacement text for key, or None to use default. )rr_N)rr)rkeysrr(rr_s rrzApp.bind`s&,  &+Dk  rc|jr |jS|j\}}t|}d|vr%|j|j dd|}||gz}dj |S)a0Format a bound key for display in footer / key panel etc. !!! note You can implement this in a subclass if you want to change how keys are displayed in your app. Args: binding: A Binding. Returns: A string used to represent the key. ctrl^+)r_ parse_keyrrrorr)rr modifiersr key_tokenss rget_key_displayzApp.get_key_displayzs}   && &!**, 3o Y  MM)//&1 2cU)C#& xx ##rc8Kddl}|}|j}|J|D]N}|jdr`|jd\}}t j t |dz d{|jjd{ut|dk(r|js t|}tj||} |jt|} t#j$|| } | j'||j)| t+dd{|jjd{t+dd{Qy77#t $rt|dk(r|nd} YwxYw7c7C72w)zA task to send key events.rNzwait:rr ) unicodedatar startswithrrrsleeprrwait_until_completerisalnumrorngetlookuprprr3Key set_sender send_messagerM) rr*r5rdriverrrwait_ms original_keychar key_events r _press_keyszApp._press_keyssb!!! 'C~~g& YYs^ 7mmE'NT$9:::mm77999s8q=+C0C,00c: :&--.H.VWD#JJsD1 $$S)##I.#A&&&mm77999#A&&&' ';9 :"%c(a-3TD: '9&szA&F(E.)!F E1 AFE3*AF0F1!FFF%F& F1F3FFFFFFcR|j|jjyy)zCalled when stdout or stderr is flushed. Args: stderr: True if the print was to stderr, or False for stdout. N)rr)rrs rrz App._flushs'  $ $ 0  % % + + - 1rc|j>tj}|jj|| |jnd|j r+|r |j n |j}|j||jjD]8\}\}}|r|s|s|r|jtj||:y)a1Called with captured print. Dispatches printed content to appropriate destinations: devtools, widgets currently capturing output, stdout/stderr. Args: text: Text that has been printed. stderr: True if the print was to stderr, or False for stdout. Nr) rr currentframerf_backrCrrrrrWr3Print)rrr current_frame target_streamtarget_stdout_stderrs rrz App._prints  $ $ 0#002M  % % + +m.Gm**T    5;D11AVAVM    %+/*=*=*C*C*E G &F&WgF##FLLf$EF GrcR|s|s|j|y||f|j|<y)aNCapture content that is printed (or written to stdout / stderr). If printing is captured, the `target` will be sent an [events.Print][textual.events.Print] message. Args: target: The widget where print content will be sent. stdout: Capture stdout. stderr: Capture stderr. N)end_capture_printr)rrLstdoutrs rbegin_capture_printzApp.begin_capture_prints,f  " "6 *+16*:D   'rc:|jj|y)zjEnd capturing of prints. Args: target: The widget that was capturing prints. N)rro)rrLs rrPzApp.end_capture_prints 'r)P)headlessrNtooltips notificationsrDc Kddlm}|}| |_| |_t j d fd d  fd }t ||d|x|_} jd{|j5 ||} | jd{| t jdd{|jd{| d{|jr |j dddy77l7L767.#t jdd{7|jd{7| d{7|jr |jwxYw#1swYyxYww) a{An asynchronous context manager for testing apps. !!! tip See the guide for [testing](/guide/testing) Textual apps. Use this to run your app in "headless" mode (no output) and drive the app via a [Pilot][textual.pilot.Pilot] object. Example: ```python async with app.run_test() as pilot: await pilot.click("#Button.ok") assert ... ``` Args: headless: Run in headless mode (no output or input). size: Force terminal size to `(WIDTH, HEIGHT)`, or None to auto-detect. tooltips: Enable tooltips when testing. notifications: Enable notifications when testing. message_hook: An optional callback that will be called each time any message arrives at any message pump in the app. rrc&jy)z+Called when app is ready to process events.N)r&)app_ready_eventsr on_app_readyz"App.run_test..on_app_readys    !rctK|j5 tjtj|_t j|_|jd{j dddy7#jwxYw#1swYyxYww)z[Run the apps message loop. Args: app: App to run. N)ready_callbackrV terminal_size) r*message_hook_context_varr&rget_running_looprrrr_process_messages)rr[rVrDr\rNs rrun_appzApp.run_test..run_apps * *#/044\B ' 8 8 :CI%.%8%8%:CN//'3!)&*0 $'') * *  $'') * *sFB8B,A B6B7B;B, B8BB))B,,B51B8z run_test r!Nr)rzApp[ReturnType]rr) textual.pilotrrrrrr_taskwaitr*_wait_for_screenr7 _shutdownr) rrVrNrWrXrDrrrcapp_taskpilotr[r\s `` ` @@rrun_testz App.run_testsUF ($, )6%6"!--/ " * *.!,GCL3%?P QQ X""$$$ \\^ * *c ,,... mmA&&&mmo%%??//)# * * % /'%mmA&&&mmo%%??//)# * *sA-F4D5F E: D&D' D0E:D E: D! E:*D+E: FDE:E:E:E74D7 5E7 E  E7E E77E::F?FrVr9inline_no_clearmouserN auto_pilotc  Kddlm  d 7tjr'tjj d d fd }|d  fd }j t jx} _tt dr| jt j j5 jdn||||||d{ d{ t j jd{d _d _ ddd j$S7`7U7+#t j $rY>wxYw# t j jd{7w#t j $rYwwxYwxYw# d{7 t j jd{7nd#t j $rYnOwxYw# t j jd{7w#t j $rYwwxYwxYwd _d _wxYw#1swY j$SxYww) aRun the app asynchronously. Args: headless: Run in headless mode (no output). inline: Run the app inline (under the prompt). inline_no_clear: Don't clear the app output when exiting an inline app. mouse: Enable mouse support. size: Force terminal size to `(WIDTH, HEIGHT)`, or None to auto-detect. auto_pilot: An autopilot coroutine. Returns: App return value. rrNrGc@K|jd{y7w)zAuto press keys.N)press)rjr*s r press_keysz!App.run_async..press_keysis!ekk4(((s cxK3 dfd }}t||t|yyw)z1Called by the message loop when the app is ready.NcKj5 ||d{ dddy7#t$rjwxYw#1swYyxYwwr)r*rr[)rorjrrs rrun_auto_pilotz8App.run_async..app_ready..run_auto_pilotus\""",U"333""3("HHJ!"""s6AA 202 A2A  AAAr!)rorrjrrr)rrepr)rvrjrrroauto_pilot_taskrs r app_readyz App.run_async..app_readyosV%" 5">C""c "-":u5DK#&s7:eager_task_factory)r^rVr9rmrnr_)rjzPilot[ReturnType]rrr)rdrr2PRESSrrrrrarhasattrset_task_factoryrzr*rbshieldrhCancelledErrorrr)rrVr9rmrnrNrorsryrrrrxr*s` ` @@@@r run_asyncz App.run_asyncIs)0 ('+  )//??((-D )$J  * "3355sy 70 1  ! !'"<"< = \\^ # #+++5+=49%!$3"& ,&2---%nnS]]_===! !") #,).>"11%nnS]]_==="11 &2---%nnS]]_==="11%nnS]]_==="11  !") #,sJB8I5IF+ E!F+&E -E.E 3&EEEI-I5F+E EEIEI F("&FF FF(F% "F($F% %F((I+I-H4F7 5H;&G(!G$ "G('I(G> ;I=G> >II &H0 )H,*H0 /I 0I I I I III2#I5)rVr9rmrnrNrorc@dfd }|Ktrtj|S tj} | j |S|j |S#t $rYnwxYwtj|S)aRun the app. Args: headless: Run in headless mode (no output). inline: Run the app inline (under the prompt). inline_no_clear: Don't clear the app output when exiting an inline app. mouse: Enable mouse support. size: Force terminal size to `(WIDTH, HEIGHT)`, or None to auto-detect. auto_pilot: An auto pilot coroutine. loop: Asyncio loop instance, or `None` to use default. Returns: App return value. cNKjd{S7w)z Run the app.rlN)r)rorVr9rmrnrrNsrrczApp.run..run_apps9! /% ( s %#%rReturnType | None)%_ASYNCIO_GET_EVENT_LOOP_IS_DEPRECATEDrrunget_event_looprun_until_completer) rrVr9rmrnrNrorrc global_loops ``````` rrzApp.runs4   <4{{79-- A%446 #55gi@@&&wy11     ;;wy) )sA77 BBc K|j|jjn |j}|r( t}|jj } |j ||jt|z dz}|jrCddl m}|jj|ddj!d|Dzdd |jjd t#|d |d d d|_ ||_|jj%||j&D]}|jj%|yy#t$r.}|jjt|Yd}~yd}~wwxYw#t($r<}d|_ |jj+||j-Yd}~yd}~wwxYww)z.s)J#d))Jrgreen)style border_stylez loaded z CSS files in z.0fz msFT)r_pathsrrrrread_allr\r4warningrparser rich.panelrrrrrZrHrrbell)rrtimerrelapsedrrSs rrzApp._on_css_changes(,'7'7'CD   # #  & 3#~!__113 '' 2  "'>D0D8''0HHOOW$kk)J )JJK"))0 *3y>*:.QT UXY(-$",&&t,"//3FOO**623M  ' HH$$SZ0 . '+$u%  s`2G$FE+BFAG F&$F FGFF G 2GGGGc@t|jjS)zRender method, inherited from widget, to render the screen's background. May be overridden to customize background visuals. )rzrrrs rrenderz App.render s T[[++,,r ExpectTypercyrrrrss rget_child_by_idzApp.get_child_by_id s69rcyrrrrs expect_types rrzApp.get_child_by_id rct||jj|S|jj||S)aGet the first child (immediate descendant) of this DOMNode with the given ID. Args: id: The ID of the node to search for. expect_type: Require the object be of the supplied type, or use `None` to apply no type restriction. Returns: The first child of this node with the specified ID. Raises: NoMatches: If no children could be found for this ID. WrongType: If the wrong type was found. )rSrrs rrzApp.get_child_by_id s>&" KK ' ' + ,,R= rcyrrrs rget_widget_by_idzApp.get_widget_by_id4 s7:rcyrrrs rrzApp.get_widget_by_id7 rrct||jj|S|jj||S)aGet the first descendant widget with the given ID. Performs a breadth-first search rooted at the current screen. It will not return the Screen if that matches the ID. To get the screen, use `self.screen`. Args: id: The ID to search for in the subtree expect_type: Require the object be of the supplied type, or None for any type. Defaults to None. Returns: The first descendant encountered with this ID. Raises: NoMatches: if no children could be found for this ID WrongType: if the wrong type was found. )rSrrs rrzApp.get_widget_by_id< s>." KK ( ( , --b+> rc8|jj|S)zGet a child of a give type. Args: expect_type: The type of the expected child. Raises: NoMatches: If no valid child is found. Returns: A widget. )rSget_child_by_type)rrs rrzApp.get_child_by_typeW s{{,,[99rcb|jd}|jj|dy)aCImmediately update the styles of this node and all descendant nodes. Should be called whenever CSS classes / pseudo classes change. For example, when you hover over a button, the :hover pseudo class will be added, and this method is called to apply the corresponding :hover styles. T with_selfrN) walk_childrenr update_nodes)rnode descendantss r update_styleszApp.update_stylese s.((4(8  $$[$$?rbeforeafterc<|jj|||dS)aTMount the given widgets relative to the app's screen. Args: *widgets: The widget(s) to mount. before: Optional location to mount before. An `int` is the index of the child to mount before, a `str` is a `query_one` query to find the widget to mount before. after: Optional location to mount after. An `int` is the index of the child to mount after, a `str` is a `query_one` query to find the widget to mount after. Returns: An awaitable object that waits for widgets to be mounted. Raises: MountError: If there is a problem with the mount request. Note: Only one of ``before`` or ``after`` can be provided. If both are provided a ``MountError`` will be raised. r)rSmount)rrrwidgetss rrz App.mountp s6!t{{  '&FFrc(|j|||dS)a=Mount widgets from an iterable. Args: widgets: An iterable of widgets. before: Optional location to mount before. An `int` is the index of the child to mount before, a `str` is a `query_one` query to find the widget to mount before. after: Optional location to mount after. An `int` is the index of the child to mount after, a `str` is a `query_one` query to find the widget to mount after. Returns: An awaitable object that waits for widgets to be mounted. Raises: MountError: If there is a problem with the mount request. Note: Only one of ``before`` or ``after`` can be provided. If both are provided a ``MountError`` will be raised. r)r)rrrrs r mount_allz App.mount_all s8tzz76??rcP|jj|g}|rt|dgS||jvr|j|}t |t r%t dt|jd|dt|r|n|}|j|\}}|j||j||j|jk7r|j|jt!j"ne|j%}|j||j'|||jt!j"t|dg}|j)|j*||j|<|S)a Do internal initialization of a new screen stack mode. Args: mode: Name of the mode. Returns: An optionally awaitable object which can be awaited until the screen associated with the mode has been mounted. rzDMODES cannot contain instances, use a type instead (got instance of rr)r{r:rrrr|rrrr _get_screenrp_load_screen_cssrrrWr3 ScreenResumert _register_screen_resizedrN)rmodestack_screen new_screenrS await_mounts r _init_modezApp._init_mode sw##''b1 eAh+ + 4;; kk$'G'6*((,W (>(>'?uTHAO5=W4Ewy7J"&"2"2:"> FK LL  ! !& )''4+A+AA  "    3 3 5 6,,.F LL NN4 (    3 3 5 6$U1Xr2Ktyy)$)D!rc:||jk(rt|jgS||jvrt d||jj t j|jj||jvr|j|}nt|jg}||_|jj|jk7r|j|jj|j|jj t j|j j#|jd|j j#|jd|S)a@Switch to a given mode. Args: mode: The mode to switch to. Returns: An optionally awaitable object which waits for the screen associated with the mode to be mounted. Raises: UnknownModeError: If trying to switch to an unknown mode. rz is the current mode is active)r|rrSrrrWr3 ScreenSuspendrr{rrrrrNrr4r)rrrs r switch_modezApp.switch_mode s5 4%% %dkk2. . t{{ ""^D8#<= =   !5!5!78  t** *//$/K$T[["5K! ;; ( (D,B,B B     ##DII.   !4!4!67 4--00DEF 4;;-z23rc|dk(r td||jvrtd|dt|tr"t dt |j d||j|<y)aAdds a mode and its corresponding base screen to the app. Args: mode: The new mode. base_screen: The base screen associated with the given mode. Raises: InvalidModeError: If the name of the mode is not valid/duplicated. rz'Cannot use '_default' as a custom mode.zDuplicated mode name .zOadd_mode() must be called with a Screen type, not an instance (got instance of rN)rrrr|rrr)rr base_screens radd_modez App.add_mode s~ : "#LM M T[[ "%:4(!#DE E k6 *%%)+%6%?%?$@C ( DrcZ|jk(rtd||jvrtd|j|=|jvrt j Sj|j|=dfd }t |jS)adRemoves a mode from the app. Screens that are running in the stack of that mode are scheduled for pruning. Args: mode: The mode to remove. It can't be the active mode. Raises: ActiveModeError: If trying to remove the active mode. UnknownModeError: If trying to remove an unknown mode. zCan't remove active mode z Unknown mode cdKtD]}j|d{y7w)zRemove screens.N)r _replace_screen)rSrrs rremove_screensz'App.remove_mode..remove_screens0 s1"5/ 3**6222 32s #0.0r)r|rrrr{rPnothingr)rrrrs` @r remove_modezApp.remove_mode s 4%% %!$=dX"FG G  $"]4(#;< < D! t** * ((* *##D)    % 3 ^-.88>>rcvt|tr||jvS||jjvS)zCheck if a given screen has been installed. Args: screen: Either a Screen object or screen name (the `name` argument when installed). Returns: True if the screen is currently installed, )rrrrgros ris_screen_installedzApp.is_screen_installed7 s9 fc "T444 4T44;;== =rcyrrros r get_screenzApp.get_screenE s.>? #)"2"2";";!. s8 $)F% 8 Nz REMOVED)r rSrrWr3rr4rrallr{rg capture_mouseremoveros `rrzApp._replace_screen s    KK   !F0023 6(*-.''/C8 -1-@-@-G-G-I8 5    t $--/ ! ! HHOOvhh/ 0  "sC C3 C1 %C3cyrrrrSrwait_for_dismisss rr$zApp.push_screen s rcyrrrs rr$zApp.push_screen s 03rct|ttfstd| t j }|j }|jjd|jrG|jjtj|jj!|j#|\}} t%j&}|j+||||j-||j/|jj1||jtj2|j4j7|jd|r t9|S|S#t$rt j}YbwxYw#t($r|j}YwxYw#t:$r t;ddwxYw)aPush a new [screen](/guide/screens) on the screen stack, making it the current screen. Args: screen: A Screen instance or the name of an installed screen. callback: An optional callback function that will be called if the screen is [dismissed][textual.screen.Screen.dismiss] with a result. wait_for_dismiss: If `True`, awaiting this method will return the dismiss value from the screen. When set to `False`, awaiting this method will wait for the screen to be mounted. Note that `wait_for_dismiss` should only be set to `True` when running in a worker. Raises: NoActiveWorker: If using `wait_for_dismiss` outside of a worker. Returns: An optional awaitable that awaits the mounting of the screen and its children, or an asyncio Future to await the result of the screen. z3push_screen requires a Screen instance or str; not Nz is current (PUSHED)zEpush_screen must be run from a worker when `wait_for_dismiss` is True)rr|rrrra create_futurerrrrr rSrWr3rrrrCr: LookupError_push_result_callbackr_update_auto_focusrprr4rrr) rrSrrrrrr message_pumps rr$zApp.push_screen s*&63-0EfZP  *++-D '')F t$    KK $ $V%9%9%; < KK   !#'#3#3F#; [ $.224L )),&I k*&&( !!+.  !4!4!67 4;;-';<=  "$ M ? H7>~~7GF H $88L $" $[ s/F F0> G F-,F-0GG G!c Kywrrros rpush_screen_waitzApp.push_screen_wait s  #c Kywrrros rrzApp.push_screen_wait s >ArcK|jd{tj|j|dd{S727w)a@Push a screen and wait for the result (received from [`Screen.dismiss`][textual.screen.Screen.dismiss]). Note that this method may only be called when running in a worker. Args: screen: A screen or the name of an installed screen. Returns: The screen's result. NT)r)_flush_next_callbacksrr~r$ros rrzApp.push_screen_wait sE((***^^D$4$4Vd$4$STTT +Ts!A A -A A A  A c<t|ttfstd|j |\}|j us|j ur3j jd|dtjSjjdjjjj|jj!|j j#t%j&j j)j dj jj ddfd }t|j+S)zSwitch to another [screen](/guide/screens) by replacing the top of the screen stack with a new screen. Args: screen: Either a Screen object or screen name (the `name` argument when installed). z5switch_screen requires a Screen instance or str; not Screen z is already current.Nz is current (SWITCHED)cfKd{jd{y77w)zTask to perform switch.Nr)rr top_screensr do_switchz$App.switch_screen..do_switchI s1-  &&z2 2 2 2s 1-1/11r)rr|rrrrSr4rrPrrrr ro_pop_result_callbackrrprWr3rrr)rrSrr rr s` @@r switch_screenzApp.switch_screen/ sC &63-0GzR $(#3#3F#; [ T[[ K4;;$> HHOOgfX-AB C ((* * t$''++- '') k* !!+.   !4!4!67 ))$++t< 4;;-'=>? 3 Y[)33D99rc||jvrtd|d||jjvrtd|d||j|<|jj |d|y)ahInstall a screen. Installing a screen prevents Textual from destroying it when it is no longer on the screen stack. Note that you don't need to install a screen to use it. See [push_screen][textual.app.App.push_screen] or [switch_screen][textual.app.App.switch_screen] to make a new screen current. Args: screen: Screen to install. name: Unique name to identify the screen. Raises: ScreenError: If the screen can't be installed. Returns: An awaitable that awaits the mounting of the screen and its children. zCan't install screen; z is already installedz has already been installedz INSTALLED name=N)rrrgr4r)rrSr"s rinstall_screenzApp.install_screenQ s" 4** * 6th>STU U T,,335 5( 2MN )/% 6("24(;.~ sW#u,Wrz&Can't uninstall screen in screen stackz UNINSTALLED name=c3&K|]}|v ywrrrs rrz'App.uninstall_screen.. sMu6U?Mr) rrranyr{rgrr4rrro)rrSr"installed_screenrs ` @rrzApp.uninstall_screenk s fc "T444#66v> W$:M:M:T:T:VWW&'OPP''/ HHOO/00B6*M NMM0C0C0J0J0LMM&'OPP*.*A*A*G*G*I &&#v-++//5HHOOvh.@$IJK  rcj}t|dkr td|jj j j tjjjj ddfd }t|jS)zPop the current [screen](/guide/screens) from the stack, and switch to the previous screen. Returns: The screen that was replaced. r z@Can't pop screen; there must be at least one screen on the stackrcDKjd{y7w)zTask to pop the screen.Nr )previous_screenrsrdo_popzApp.pop_screen..do_pop s&&7 7 7s   r) r rrrorrSrWr3rr4rrPr)rrHrrs` @r pop_screenzApp.pop_screen s)) |  !"R '**,,,.   !4!4!67 4;;-z23 8VX&0066rcgtjD]}||urj|ntd|ddfd }rj |yy)zPop screens until the given screen is active. Args: screen: desired active screen Raises: ScreenError: If the screen doesn't exist in the stack. r z not in screen stackcKj5D]}|jd{ dddy7#1swYyxYww)z$Pop any screens in `screens_to_pop`.N)rdismiss)rSscreens_to_poprs r pop_screensz'App._pop_to_screen..pop_screens sO""$ +,+F ..***+ + +* + +s)A A>A A AA A Nr)r rHrpr call_later)rrSrr!r s` @r_pop_to_screenzApp._pop_to_screen sq(*"4#4#45 HJ'%%j1  H z1EFG G +  OOK ( rc<|jj||y)zFocus (or unfocus) a widget. A focused widget will receive key events first. Args: widget: Widget to focus. scroll_visible: Scroll widget into view. N)rS set_focus)rwidgetscroll_visibles rr%z App.set_focus s fn5rc,|M|j |jjtj|jd|_n|j|urr |j8|jjtj|j|$|jtj|||_|j d|j _|d|_||_y#d|_wxYw#||_wxYw)zCalled when the mouse is over another widget. Args: widget: Widget under mouse, or None for no widgets. NFT)r~rWr3LeaveEnterr mouse_hover)rr& hover_widgets r_set_mouse_overzApp._set_mouse_over s >*+OO00doo1NO&*DOf,-244V\\$//5RS)++FLL,@A&,DO ?? &*/DOO '  #'+L $&'+DO'-DOs8C>A*D > D Dcjj jsydfd }j|y)zUpdates the mouse over after the next refresh. This method is called whenever a widget is added or removed, which may change the widget under the mouse. NcK jj}|j\}}|jus|jurj ||yy#t $rYywxYww)z+Check if the mouse over widget has changed.N)get_hover_widgets_atrrr~rr-rc) hover_widgetsr~rrSrs r check_mousez+App._update_mouse_over..check_mouse sw A ; ; ;T=P=P Q *7)>)>& Jdoo5!8((Z@9   s'A,A?A, A)&A,(A))A,r)r~ is_activecall_after_refresh)rrSr2s`` r_update_mouse_overzApp._update_mouse_over s0 ?? "&*:*:  A  ,rc||jk(ry|j8|jjtj|j||_|/|jtj |jyy)asSend all mouse events to the given widget or disable mouse capture. Normally mouse events are sent to the widget directly under the pointer. Capturing the mouse allows a widget to receive mouse events even when the pointer is over another widget. Args: widget: Widget to capture mouse events, or `None` to end mouse capture. N)rrWr3 MouseReleaser MouseCapturerr&s rrzApp.capture_mouse sx T(( (     *    , ,V-@-@ATAT-U V$      3 3D4G4G H I rctd|DsJddfd }|Dcgc]}t||}}jj|j ycc}w)a Exits the app and display error message(s). Used in response to unexpected errors. For a more graceful exit, see the [exit][textual.app.App.exit] method. Args: *renderables: Text or Rich renderable(s) to display on exit. c32K|]}t|ywrr))r renderables rrzApp.panic.. s *4M* % rz4Can only call panic with strings or Rich renderablescztjj|jj}|S)zRender a panic renderables.)listrvroptions)r<segmentsrs rrzApp.panic..render s-DLL// DLL ?Q""((*;-7yz) $$&rc|r ddlm}|}n|rts ddlm}|}n |j }||t j||x}|_|S)aConstruct a driver instance. Args: headless: Request headless driver. inline: Request inline driver. mouse: Request mouse support. size: Initial size. Returns: Driver instance. r)HeadlessDriver)LinuxInlineDriver)rrnrN) textual.drivers.headless_driverrWr#textual.drivers.linux_inline_driverrXrzr2rAr) rrVr9rnrNrWrzrXr?s r _build_driverzApp._build_drivera sQ  F)L G M,L,,L , // !    rc^K|j]ddlm} |jjd{|jj d|jj dyy79#|$r6|jj d|jj dYywxYww)zInitialize developer tools.Nr)DevtoolsConnectionErrorzConnected to devtools ( z )zCouldn't connect to devtools ( )rVrr]connectr4rurl)rr]s r_init_devtoolszApp._init_devtools s == $ B Ymm++---":4==;L;L:MR PQ %.* Y"A$--BSBSATTV WX Ys8B-A/A-7A/+B--A//8B*'B-)B**B-c |Kjdfd }fd} j5|d{s dddyd_ tj} j | d{j ||||x} _j| js| j tj5tj5| d{ddddddtj jj"rj$\} } jj't)j*| | j,j.jj1|rGj2j4s1t7} |j9j:j<nNjj't)j*dj@ j,j.| jCdddy7%77e#1swYexYw#1swYjxYw#t>$r|j9YWwxYw#tj jj"r$j$\} } jj't)j*| | j,j.jj1|rfj2j4sPt7} |j9j:j<nm#t>$r|j9YnRwxYwjj't)j*dj@ j,j.| jCwxYw#tD$r}jG|Yd}~d}~wwxYw#1swYyxYww)NcKjd{jjdjjtjjjj t jKtjjt j}jjd| jr%jjjjD]'\}}}}jj||d||)j rc t#j$j&}|j&j,d f}jjj |d j4rDj7d j4d jjdj4y7#t(t*f$rd}YwxYw#t.$r+}j1|j3Yd}~y d}~wwxYww)zWork required before running the app. Returns: `True` if the app should continue, or `False` if there was a problem starting. Nz---r)rezWriting logs to T)rr tie_breakerrrrF)rrg?z css monitorr!STARTED)r`r4rrrarer2LOG_FILErcrabspathrrr_get_default_cssrrrrrrrrrrrUr set_interval) _log_pathrcssrcrapp_pathrrs r app_preludez*App._process_messages..app_prelude s %%' ' ' HHOOE " HHOO!9!9!;O < HHOOT]]O 3!!-GGOOI,>,>? "29- @A ==OO,,T]];:>:O:O:Q6IsKOO.."+'+$/# /88&#*??4>>#B"*dnn.E.E-Fd+K LIOO..Ie/!!$(8(8}!M 4+;+;<I (,&w/&#%&  &&u---/ saI#HCI#'A7H,H>AH,AI#H)&H,(H))H,, I 5!II#I  I#cKdfd }j5 jtjd{jtjj j dd{j}jjjtjd{jjjd_tj j|urjj|j"j%d{ d_j-d{|d{ ddd j/d{j4j7d_ j"j)d{t9j:j<d{y777Y#jjd_wxYw7#t&$r%j"j)d{7wxYw77#d_j-d{7|d{7wxYw#1swY+xYw7#t0j2$rY.wxYw77#t9j:j<d{7wxYw#j4j7d_ j"j)d{7t9j:j<d{7w#t9j:j<d{7wxYwxYww)z$The main message loop, invoke below.cfK(}tj|r |d{yyy7wr)r isawaitable) ready_resultr^s rinvoke_ready_callbackzRApp._process_messages..run_process_messages..invoke_ready_callback s;!-#1#3L**<8***9.+s $1/1NTFr)r_dispatch_messager3ComposeResizefrom_dimensionsrNrSrapplyMountrrr& _is_mountedry_initialize_objectrstartrstop_running_ready_process_messages_looprrr cancel_allr _stop_all_timers)rqrr^rs rrun_process_messagesz3App._process_messages..run_process_messages s + ""$ 22 0"44V^^5EFFF"44"MM99$))TJ*.--d3"44V\\^DDD)++//1+/(//5{{.8--n=----///%)DM++-''/111; 2> 811333 '') % 8--,,...//$,,777MG E++//1+/(0 --,,... (1%)DM++-''/111; 2 2@4))   /7%//$,,777  '') % 8--,,...//$,,777%//$,,777sN?K&H2H)AH2H,AH2H/H2+A <KKK N?KK,(L +K,,L /K31N?3#LLLN? "N<N M#!N&"N<N  N<#N92N5 3N99N<<N?T)rVr9rnrN)r?rr)$rr*r|r3Loadrrr[rr4rstart_application_moder rr rry_clear_watchersr1rrr(movesegmentrrrrr$rrSrrr!stop_application_moderr)rr^rVr9rmrnr_rDrlr load_eventr?cursor_xcursor_yrvrs`` rrbzApp._process_messages s\ * X2 8h]]_, .$&&, ., .!DM( .#[[] ,,Z888(,(:(:%!& );) 'zz1137,T-A-AB=!01E1E!F=&:&< < <== !006<<11151O1O.Hh LL.. ' hY B J J O O!LL..0.txx7Q7Q*1)!4$+MM$++2I2I$J!% 2 2$+LLT5H5H4H$I$Q$Q$V$V!"446U, ., .& 9!===== (8!4$+MMO!4!006<<11151O1O.Hh LL.. ' hY B J J O O!LL..0.txx7Q7Q*1)!4$+MM$++2I2I$J'7!4$+MMO!4!% 2 2$+LLT5H5H4H$I$Q$Q$V$V!"446 .&&u-- .W, ., .s-P< P0I!P0 P< P0(P;I$.take_screenshot6 s7  22"66 !  IIKsAArzscreenshot timerr!Nr)rr`r4rr2SCREENSHOT_DELAYr#)r ready_timers` rr}z App._ready- su #nt'7'774?  )Jt#4MBC   % % * NN**OBT   +sA8A;cKd}|j|_ g|jjt|}|j |d{y#t$r}t |d||d}~wwxYw7'w)NTz. compose() method returned an invalid result; )rSr_nodesrZrr)r_rich_traceback_omitrrs r _on_composezApp._on_composeC s##{{ ; **;WT];G nnW%%%  (HP   &s3A8#AA8A6A8 A3A..A33A8chK|jr d|_|jd{yy7w)z!Check if a recompose is required.FN)r recomposers r_check_recomposezApp._check_recomposeO s/  # #',D $.." " " $ "s '202cK|jry |jj4d{|jjdj dj d{|jj t|d{dddd{y77C77 #1d{7swYyxYw#t$rYywxYww)zrRecompose the widget. Recomposing will remove children and call `self.compose` again to remount. Nrz.-textual-system) rrSbatchrhexcluderrrZrrs rrz App.recomposeU s ::  {{((* ; ;kk'',445GHOOQQQkk++GDM::: ; ; ;Q: ; ; ; ;    sCCB1C) rrrrrr widget_listapply_stylesheet new_widgetsadd_new_widgetr&s rrz App._register s!*I =E  !2#7+K!K??00$& $++! HF#FO"FN#FOff- :VWXXT^^+v&$$VVVUC=="DNN6GFMMGG H" %F V5 1  " " $ %}}IG}rc|jt|jtr5|jjj ||j |jj|y)zWUnregister a widget. Args: widget: A Widget to unregister N) r7r_parentrr_remove_detachrdiscardr9s r _unregisterzApp._unregister sO  fnnf - NN ! ! ) )& 1 NN  v&rcnK|j#|jjd{yy7wr)rV disconnectrs r_disconnect_devtoolszApp._disconnect_devtools s. == $--**, , , % ,s *535c|j||j|jjj |y)zStart a widget (run its task) so that it can receive messages. Args: parent: The parent of the Widget. widget: The Widget to start. N)rrrrr)rrr&s r _start_widgetzApp._start_widget s4 v  v&rc||jvS)zCheck if a widget is mounted. Args: widget: A widget. Returns: True of the widget is mounted. )rr9s r is_mountedzApp.is_mounted s''rcK|jjD]H}t|D](}|js|j |d{*|j J|j j |jj t|j}|D]}|jd{y77 w)zClose all message pumps.N) r{rgr r|_prunerSrrr>r_close_messages)rr stack_screenremaining_nodesrs r _close_allzApp._close_all s((//1 E ( 4 ((++l333 4 KKM   %%' t~~.$ *E'') ) ) *4 *s)8CCCA9C C CCcK|j|j}d|_||j|j d{|j d{|j tjd{|j|jj|jj|j.|jjr|jd{|jt j"rFddlm}ddlm}|}|j-d|j-||j.yy7)777sw)NFr)r$)Prettyz[b]The app returned:)rrr| disable_inputrrrrr3Unmountcloser_clearrVrrrUr2 SHOW_RETURN rich.consoler$ rich.prettyrrr)rr?r$rrvs rrhz App._shutdowns!     "oo""$$$$$V^^%5666 << # LL     == $)C)C++- - - %%'  , *iG MM0 1 MM&!3!34 5 ! $6 .sJA E> E4 E>#E7$*E>E:A9E>E< A,E>7E>:E><E>cbK|j|jjdywr)rr put_nowaitrs r _on_exit_appzApp._on_exit_app"s&  &&t,s-/)repaintlayoutrc|r$||_|j|j|S|jr|jj |||j |S)a/Refresh the entire screen. Args: repaint: Repaint the widget (will call render() again). layout: Also layout widgets in the view. recompose: Re-compose the widget (will remove and re-mount children). Returns: The `App` instance. )rr)rrrr rSrr)rrrrs rrz App.refresh&sU" '0D $ NN400 1K    KK    ?  rc|jj}|j|j|j |j |j| |j jr@|j j|j|j|j _ |jD]6}||j k7s|j |||j|_ 8y#t$rYQwxYw)zVRefresh CSS. Args: animate: Also execute CSS animations. rN) rr set_variablesrrrZrSr_refresh_layoutrNrrrH)rr8rrSs rrzApp.refresh_cssAs XX((   !7!7!9:$((G4 {{%% ++DII6040F0F - '' BF$!!&'!:+/+A+A( B    s$AD D  D cH | |jy|jr |jy|jr|js|js|j |j }|j t|tr|jjj|j}|j jrotj |j" j$j& |j)|z tj |j$j&z n:|j)| tj*|j$j&z ||_n"|j-|}|j/| t0rFd |j j2} fdt5dt7  DD] }|| n|j j3  |j=|j j?|jy#t8$r}|j;|Yd}~Zd}~wwxYw#|j=wxYw#|jwxYw)zDisplay a renderable within a sync. Args: screen: Screen instance renderable: A Rich renderable. Ni c3.K|] }||zywrr)roffset CHUNK_SIZEterminal_sequences rrzApp._display..s%*$*!2&6J;N O*sr) post_display_hookrr|rrCrrv _begin_updaterrArS outer_size clamp_offsetrr1r(rrrrrender_segmentsmove_tor_render_bufferrrrangerrr _end_updater) rrSr<rvrr@rchunkrrrs @@r_displayz App._displayYsN= %!v  " " $u  r  " " $o  ((LL,,,""$+'(B%j2BC.2kk.D.D.Q.Q $ 4 4/O $||554;LL'+'E'E&E5"")'$$!2!2Z5O5OPW5X X 1 1W\\%46"")'$$!/ 15?4N4Nw4W 1 1W__%46"")'$$!/ 1>MD:'.~~j'AH070F0Fx0P-# *.J$(LL$6$6E*.3$%s+<'=z/"*- !&e -!LL../@A$$& ""$  " " $3%6..u556($$&  " " $sTJ JAJD(I0A(I:*J I7I2-I:2I77I::J  JJ!cy)z:Called immediately after a display is done. Used in tests.Nrrs rrzApp.post_display_hooksrc:|jj||S)zGet the widget under the given coordinates. Args: x: X coordinate. y: Y coordinate. Returns: The widget and the widget's screen region. )rS get_widget_at)rxys rrzApp.get_widget_ats{{((A..rcn|js)|j|jjdyyy)zPlay the console 'bell'. For terminals that support a bell, this typically makes a notification or error sound. Some terminals may make no sound or display a visual bell indicator, depending on configuration. Nr)rCrrrs rrzApp.bells0 DLL$< LL  u %%=rc|j}|2|j|jjf||jfg}|S|jDcgc]}||jf}}|Scc}w)aGet a chain of nodes and bindings to consider. If no widget is focused, returns the bindings from both the screen and the app level bindings. Otherwise, combines all the bindings from the currently focused node up the DOM to the root App. )rTrSrancestors_with_self)rrTnamespace_bindingsrs r_binding_chainzApp._binding_chains,, ?dkk334t~~&" "!4;3N3N"+/t~~&" ""! "sA(cN|jtj|dy)zSimulate a key press. This will perform the same action as if the user had pressed the key. Args: key: Key to simulate. May also be the name of a key, e.g. "space". N)rWr3r<rrs r simulate_keyzApp.simulate_keys &**S$/0rcBK|rt|jjn|jjD]_\}}|jj |d}|D]9}|j |k(s|j|j|d{s8yay7 w)a-Handle a key press. This method is used internally by the bindings system. Args: key: A key. priority: If `True` check from `App` down, otherwise from focused up. Returns: True if the key was handled by a binding, otherwise False rNTF) r rSr_modal_binding_chainkey_to_bindingsr:r run_actionr)rrr namespacebindings key_bindingsrs r_check_bindingszApp._check_bindingss T[[// 011 $ Ix $3377R@L' $##x/!__W^^YGGG# $ $HsA.B1BBBBc|jjD]6\}}|jjdvs|j d|ddyy)z:Bound to ctrl+C to alert the user that it no longer quits.)rzapp.quitz Press [b]z[/b] to quit the appzDo you want to quit?rN)r_rrrnotify)rractive_bindings raction_help_quitzApp.action_help_quitsb$(#7#7#=#=#?  C%%,,0DD u$89AW  rch|jDcic]\}}|t|c}}Scc}}w)z]Normalizes the keys in a keymap, so they use long form, i.e. "question_mark" rather than "?".)rrq)rkeymap binding_idr*s r_normalize_keymapzApp._normalize_keymaps8KQ,,. 6Fj$J+D1 1   s.cP|j||_|jy)aSet the keymap, a mapping of binding IDs to key strings. Bindings in the keymap are used to override default key bindings, i.e. those defined in `BINDINGS` class variables. Bindings with IDs that are present in the keymap will have their key string replaced with the value from the keymap. Args: keymap: A mapping of binding IDs to key strings. N)rrrefresh_bindingsrrs r set_keymapzApp.set_keymaps"--f5  rcli|j|j||_|jy)aUpdate the App's keymap, merging with `keymap`. If a Binding ID exists in both the App's keymap and the `keymap` argument, the `keymap` argument takes precedence. Args: keymap: A mapping of binding IDs to key strings. N)rrrrs r update_keymapzApp.update_keymaps1J$,,I$*@*@*HI  rcy)aHandle a clash between bindings. Bindings clashes are likely due to users setting conflicting keys via their keymap. This method is intended to be overridden by subclasses. Textual will call this each time a clash is encountered - which may be on each keypress if a clashing widget is focused or is in the bindings chain. Args: clashed_bindings: The bindings that are clashing. node: The node that has the clashing bindings. Nr)rclashed_bindingsrs rhandle_bindings_clashzApp.handle_bindings_clash"s$ rcKt|tjr;|j|jd{t ||d{yt|tjr|js |js1t|tjtjfrd|_ t|tjrt|j|j|_t|tjr/ |j#|j|j\|_}|j(j+|t|tj,r|j$ |j.}|j$}|j"|\}}||ur|j0duxr|j0|k(}|j2duxr&|j4|j2z |j6k}|r|r|xj8dz c_nd|_tj:j=|||j8}|j4|_||_|j(j+|yyt|tjr|j(j>6|j@dk(r'|jBr|j(jEy|jFr |j(jI|jM|j@dd{sH|jFxs |j(} | j+|y|j(j+|yyyyt|tjNrP|jsD|jF|jFj+|y|j(j+|yt ||d{y77#t&$r d|_YwxYw#t&$rYywxYw#tJ$rY*wxYw77Dw)NTr )chainescape)r)(rr3rsrr|raon_event InputEvent is_forwardedr'r< MouseDown MouseEventrkrrrrrrcrS_forward_eventMouseUp screen_offsetrrrrrClick from_eventrkrescape_to_minimizeminimizerT_clear_tooltiprarPaste) reventrrmouse_down_widgetmouse_up_widget same_offsetwithin_time_threshold click_eventforward_targetrs rrz App.on_event6s eV^^ ,//$"4"45 5 5'"5) ) ) v00 1%:L:L>>jVEUEU8V&W!%%!2!23&,UWWegg&>#eV%5%567595G5G!GGUWW62/ **51 ufnn5//;(-(;(; ,0,C,C)-?T-?-?-O**.?? $ = =T I!S$($A$A]$R( !% ; ;4 G!C$)JJ1L1L$L#'#B#B%C2 +/D $ 4 4 9 478 4*0,,*A*A 15@T@T+B+K;@**D7C Q Q QQP)%Q(P))Q, P85Q7P88Q; QQQQQct|jj|jS|jjS)aUse the escape key to minimize? When a widget is [maximized][textual.screen.Screen.maximize], this boolean determines if the `escape` key will minimize the widget (potentially overriding any bindings). The default logic is to use the screen's `ESCAPE_TO_MINIMIZE` classvar if it is set to `True` or `False`. If the classvar on the screen is *not* set (and left as `None`), then the app's `ESCAPE_TO_MINIMIZE` is used. )rrSrrs rrzApp.escape_to_minimizesE{{--5  # #  //  rc"t|tr|\}}}ntj|\}}}|dn|j |}|r=|;||j vrt d|dt||d}|t d|d||||fS|||fS)aParse an action. Args: action: An action string. default_namespace: Namespace to user when none is supplied in the action. namespaces: Mapping of namespaces. Raises: ActionError: If there are any errors parsing the action string. Returns: A tuple of (node or None, action name, tuple of parameters). NzAction namespace z is not knownzAction target z not available)rtupler1rr:rrr)rrdefault_namespace namespaces destination action_nameparams action_targets r _parse_actionzApp._parse_actions& fe $/5 ,Kf/6}}V/D ,Kf&DJNN;,G  =0$"6"66!$5k]-"PQQ#D+t)rr+r,_action_Naction_z z0 has no target. Could not find methods '_action_z ' or 'action_'z skipped.F)r4rrrr?rO)rrr+r,_rich_traceback_guardprivate_method public_methods rr4zApp._dispatch_actions!% #   =$Y(;-0H$ON'^5f555#I /FMM &]4V444 JJK?+44?= k]Z[] 65  = JJ;/; <  =sdC *B# B B#C *B#9B!:B#>C ?B#C B#!B##"CC CC c2K t|d} t||j\}}|j t |tr|j||d{yt |trJt|dk(r<|\}}tj|\} } } |j| | |f|d{yt |tr%|jrtjd|dy#t$rYywxYw#t $rYywxYw77[w)a2Allow the app an opportunity to dispatch events to action system. Args: event_name: _description_ event: An event object. default_namespace: The default namespace, where one isn't supplied. Returns: True if an action was processed. rFNz Can't parse @z9 action from style meta; check your console markup syntaxT)rAttributeErrorrGmetar{rFrrrr'rr1rrr4r) r event_namerr(r _modifiersrr+ action_paramsr parsed_actionrs r _broker_eventzApp._broker_events" E7+E !8UZZ!P J JJL fc "//&*;< < <"! &3v;!+;)/ &K*1-- *D 'I}a//M=9!  &%(TZZ #JDDD D DDDDc,K|jywrr{rrZs r _on_updatezApp._on_updateH c,K|jywrrFrGs r _on_layoutzApp._on_layoutKrIrJcK|j|jd{st||d{yy77wr)rrrErrs r_on_keyz App._on_keyNs7**599555tU+ + +6 +sA<A>AAc\K|j|j|_||_ywr)r{rNrrrNs r _on_resizezApp._on_resizeRs" ZZ "s*,cNKd|_|jjyw)zApp has focus.TNr'rSrrNs r _on_app_focuszApp._on_app_focusWs $$&#%cNKd|_|jjyw)zApp has lost focus.FNrSrNs r _on_app_blurzApp._on_app_blur]s $$&rU)rc |s tgSh|}|D]<}|jt|j|j d> |dj }|j r4|j |vr&|j|j t| |D] }d|_ dfd }t|Dcgc]}|jx}|c}|}j||S#ttf$rYbwxYwcc}w)zPrune nodes from DOM. Args: parent: Parent node. Returns: Optional awaitable. Trrc> j}|jrj| j dyy#ttf$rY%wxYw#j dwxYw)zCalled after removing children.NTr)rSr|r5rrar)rSrrs r post_mountzApp._prune..post_mount~sm!0#]]F//7NN$N/")(3 NN$N/s( AAAAAAA,r)rQrWrtrZrrSrT _reset_focusr>rrarrer) rrnodes pruning_nodesrrSr[taskawait_completes `` rrz App._prunecsr? "%-uX  ED   eg &  !3!3d!3!C D E I1X__F~~&..M"A##FNND4GH! !D DM ! 0%# Hd (:'GT H   ~&9!(+   0 IsC6D D 6DDc|jj|ru |j`|jj|jur>|jj(|jj |jddd|_y|jj|_|jj dy#t $r Yd|_ywxYw)z Respond to changes in app focus.NFT)r'from_app_focus)rS_update_stylesrrTr%ra)rr6s r_watch_app_focuszApp._watch_app_focuss ""$  22>66==L ++3KK))66','+*.2D *.2[[-@-@D * KK ! !$ ' .2D *  sA,C CCc.K|j|yw)zAn [action](/guide/actions) to simulate a key press. This will invoke the same actions as if the user had pressed the key. Args: key: The key to process. N)rrs raction_simulate_keyzApp.action_simulate_keys #c,K|jyw)z@An [action](/guide/actions) to quit the app as soon as possible.N)r[rs rrgzApp.action_quit rJc,K|jyw)z8An [action](/guide/actions) to play the terminal 'bell'.N)rrs r action_bellzApp.action_bellrirJcK |jd|j}t|tr|j |yy#t $rYywxYww)z|An [action](/guide/actions) to focus the given widget. Args: widget_id: ID of widget to focus. #N)rhfirstrrr%r])r widget_idrs r action_focuszApp.action_focussX  %::)o.446D$'t$(   s'A"A #A AAAAc.K|j|yw)znAn [action](/guide/actions) to switch screens. Args: screen: Name of the screen. N)rros raction_switch_screenzApp.action_switch_screens 6"rgc.K|j|yw)zAn [action](/guide/actions) to push a new screen on to the stack and make it active. Args: screen: Name of the screen. N)r$ros raction_push_screenzApp.action_push_screens  rgc,K|jyw)zaAn [action](/guide/actions) to remove the topmost screen and makes the new topmost screen active.N)rrs raction_pop_screenzApp.action_pop_screens rJc.K|j|yw)zrrr)rr|)rrr)r int | None)rzSequence['Widget'])rr)rrr>rrr[)rzGenerator[None, None, None])g?)r$rrr)r3rrr)r6rr7zfloat | Animatabler/objectr0rr1rr$rr2zEasingFunction | strr3CallbackType | Noner4rLrr)T)r6rr;rrr)rzlist[Screen[Any]])rr&)NrN)rYrrrrZRenderableType | Nonerr)r Widget | None)rzdict[str, ActiveBinding])rSr|rzIterable[SystemCommand])r ComposeResult)rzdict[str, str])r~rrz Theme | None)r?rrr)r~rrr)rzdict[str, Theme])rr)r~rrr)r?r-rr)rr-)rz Type[Driver])rzrich.repr.Result)rr9)rzScreen[object])rz list[Screen])rrmr)rr.) rr/rr0rzinspect.Tracebackrrrr)rrr)rzECallable[..., CallThreadReturnType | Awaitable[CallThreadReturnType]]rrrrrr)NN)rrrrrr)rrrrrr)NNN)rrrrrrrr)rrrrrrrr)uSearch for commands…)r%zSequence[CommandListItem]r#rrr) r*rrrr(rrrr_rrr)rrRrr)r*z Iterable[str]rrr)rrrr)rrrrrr)TT)rLrrQrrrrr)rLrrr) rVrrNtuple[int, int] | NonerWrrXrrD Callable[[Message], None] | Nonerz'AsyncGenerator[Pilot[ReturnType], None])rVrr9rrmrrnrrNrroAutopilotCallbackType | Nonerr)rVrr9rrmrrnrrNrrorrzAbstractEventLoop | Nonerr)rr)rsrrr)rsrrtype[ExpectType]rrr)rsrrztype[ExpectType] | NonerzExpectType | Widget)rrrr)rr`rr)rrrint | str | Widget | Nonerrrr)rzIterable[Widget]rrrrrr)rrrr)rrrzstr | Callable[[], Screen]rr)rrrrP)rS Screen | strrr)rSrrr)rSrrr|)rSrrType[ScreenType] | Nonerr)rSrrrrr)rSrrzType[Screen] | Nonerr|)rSrrztuple[Screen, AwaitMount])rSr|)rSr|rr|)NF)rSScreen[ScreenResultType] | strr1ScreenResultCallbackType[ScreenResultType] | NonerzLiteral[False]rrr)rSrrrrz Literal[True]rz asyncio.Future[ScreenResultType])rSrrrrrrz-AwaitMount | asyncio.Future[ScreenResultType])rSzScreen[ScreenResultType]rr~)rSrrr)rSrrzScreenResultType | Any)rSrrrP)rSr|r"rrr)rSrrr)rrP)rSr|rr)r&rr'rrr)r&rr,rrr)r&rrr)rCr'rr)rrrr) rVrr9rrnrrNrrrb)NFFFTNN)r^rrVrr9rrmrrnrr_rrDrrr) rr`rrrrrrrr) rr`rrrrrrrzdict[tuple, RulesMap] | Nonerz list[Widget])r&rrr)rrr&rrr)r&rrr)rrrrrrrr)r8rrr)rSr|r<rrr)rrrrrztuple[Widget, Region])rz!list[tuple[DOMNode, BindingsMap]])rrrr)rrrrrr)rrUrrU)rrUrr)r z set[Binding]rr`rr)r events.Eventrr)rstr | ActionParseResultr(r`r)Mapping[str, DOMNode] | Nonerz'tuple[DOMNode, str, tuple[object, ...]])rrr(r`rz bool | None)rrr(DOMNode | Noner)rrr)rr`r+rr,rrr)r@rrrr(r`rr)rZzmessages.Updaterr)rZzmessages.Layoutrr)rz events.Keyrr)rz events.Resizerr)rzevents.AppFocusrr)rzevents.AppBlurrr)r]rrrrrQ)r6rrr)rorrr)rSrrr)rrrr)r~rrrrr)rr)rZrrrrrrr)rZz+messages.TerminalSupportsSynchronizedOutputrr) rZrrrrrxrrrKrrr)rrwrr)rrurrrr)rzIterator[None])r_rrrrr)rzstr | Path | TextIOrstr | Path | NonerrrLiteral['browser', 'download']rQrrrr"rrr)rzstr | Path | BinaryIOrrrrrrrrr"rrr)rzBinaryIO | TextIOrrrrrrrQrrrr"rrr)rzevents.DeliveryCompleterr)rZzmessages.InBandWindowResizerr( rrrrrrrrrrrrrrrrr r rr r rrrrRrrrrrr!r"r#r$r<ryrr>r'r2 DEFAULT_THEMEr?r>rir=rjr3rrpropertyrr@rrrrrrrrrrr rrr rrrr r*r,r7r8r:r=r?rrCr1rFrHr rKrUr[rTr_rprtrZrwrrrhrr}r-rrrrrrrryrrrSrrNrrr4rrrrrfrr rrer&rrr2rDrrrRrPrrkrrrrrrrrr rrrrrrrrrrrrrrrr$rrrrrr#r%r-r5rrErrHrUr[r`rbrr}rrrrrrrrrrrhrrrrrrrrrrr classmethodrrr r rrr.r2rr4rDrHrLrOrQrTrWrrdrfrgrkrprrrtrvrxrzrrrrrrrirjrrrrrrrrrrrrr6rb SignalResumerrrrrrrr3DeliveryCompleterDeliveryFailedrr5InBandWindowResizerr __classcell__)rs@rrr'sf2CI6Kp>@E :?8#-L-,#>@G ;@F'*J$* $(L.' "J !-1H*1&E: !Iz  .2N1f,-/-O %NHJ .6]5L4818`-5]5o255.    D   +E$? -H) $"%M<%JM5C&**/)-- %&NM%4,.M.LEGBG$DF@E +-27+*+HOD$B6E=68'E:I}:\u-I $I$;$;&..0"!%"'5+/ && & "&  &  & & & %& )& &  & P G;;KKIIFF>> 7 7""  (%))- 3!33' 3  3(   + += ~ %&"( 44++ A$- -    #J 8DD "" # #U  5*5* 5*!2 5*  5* 5*n "9$2W22 2  2h ?C 0" 01; 0  0! = = = =H $"&   > $"& " " "  "  " N4 +     *  ""&           4$<'8.G6JN;#;-1;BF; ;"('/#9=U*U*% U*  U*  U*7U* 1U*U*t %'+37V V  V  V  V %V 1V  V v %'+37)-6262 62  62  62%62162'62 62p,3\-V4J 9 9   (8      ?C  $;  . : :   (8      ?C  $;  6 : @-1+/ GG*G) G  GB-1+/ @!@* @ ) @  @<,\&P(,?@ >?? 44 CG)@ JN 0G  IM"""2E" "H*2)<* KO/4  2 H -        KO.2  32 3H 3,  3 .  3  3GK!& ;.;D; ; 7 ;z  #2 #  #  # A AU4U U" :D=4 D70)66'#'3@' '<-6J"'. , ''(!!&*!37!?U! !F Y/3 %049=X.+X.X. X.  X.  X..X.7X. X.t, &# ,','&,,'6@,'IS,' ,'d" .2 999 9  9 , 9 9v '- ' (*$6:-      6B0E%NI /&""*10      , 4;  (W*r  (48 % '% #% 1 % 1 % NCC.5C C(-137 '*1   6' '/2'K==#&=7:= = (B( (+)B$"/ $;0;0 ;0  ;0  ;0;0 ;0z& *& E .--00d1(5900-1$(6@# $H )H * H " H 4 H H H H  H \-1$(6@ $N +N * N " N 4 N N N  N n $ $(!(* ( " ( 4 (((( (T  ! ##$ % ++rr)rztype[SystemCommandsProvider](r __future__rrrrrrrcrrrrwarningsrrrconcurrent.futuresr contextlibrr r r functoolsr pathlibr rrtypingrrrrrrrrrrrrrrrrrr weakrefr!r"rO rich.repr platformdirsr#rr$r%r&r' rich.controlr( rich.protocolr* rich.segmentr+r,rich.terminal_themer-textualr.r/r0r1r2r3r4r5r6textual._animatorr7r8r9r:textual._ansi_sequencesr;r<textual._ansi_themer=r>textual._callbackr?textual._compatr@textual._compositorrAtextual._contextrBrCrDr`textual._dispatch_keyrEtextual._event_brokerrFrGtextual._filesrH textual._pathrIrJrKtextual._typesrL textual._waitrMtextual.actionsrNrOtextual.await_completerPtextual.await_removerQtextual.bindingrRrSrTrUtextual.commandrVrWrXrYtextual.composerZtextual.contentr[textual.css.errorsr\textual.css.queryr]textual.css.stylesheetr^r_ textual.domr`ratextual.driverrbtextual.errorsrctextual.featuresrdretextual.file_monitorrftextual.filterrgrhrirjtextual.geometryrkrlrm textual.keysrnrorprqrrtextual.messagesrsrttextual.notificationsrurvrwrxtextual.reactiverytextual.renderables.blankrztextual.screenr{r|r}r~rtextual.signalr textual.themerrr textual.timerrtextual.visualrrtextual.widgetrrtextual.widgets._toastrtextual.workerrrtextual.worker_managerrrrtyping_extensionsrrrrrrrtextual.messagerrdrrrrplatformrrA simplefilterResourceWarning version_inforrrrrrrrrrrrrrrrrrrrrrrrrwautorrrrr<s#   88% (/ ,SS '*-   SR82$+0<E.D5 *'90,EEUU##.'7)!#8,JJ111TT%+">>1-,=01EE,,)'#>) ,,' ! ??H(O4),(8(8J(F% D iD;yFOOb \ 0 P