AHj ddlmZddlmZmZddlmZddlmZddl m Z ddl m Z edZ Gdd eZGd d eZ d dd Zy )) annotations)CallableTypeVar) SelectorSet)parse_selectors) TokenError)Message DecoratedTypeceZdZdZy)OnDecoratorErrorzkErrors related to the `on` decorator. Typically raised at import time as an early warning system. N__name__ __module__ __qualname____doc__C/root/tools/cai/cai_env/lib/python3.12/site-packages/textual/_on.pyr r srr ceZdZdZy) OnNoWidgetz;A selector was applied to an attribute that isn't a widget.Nr rrrrrsErrNc i}|||d<|r|j|i|jD]n\}}|dk(r(jtjk(r8t d|j vrt d|dj dz t||<pd fd }|S#t$rt d|d|d dwxYw) aDecorator to declare that the method is a message handler. The decorator accepts an optional CSS selector that will be matched against a widget exposed by a `control` property on the message. Example: ```python # Handle the press of buttons with ID "#quit". @on(Button.Pressed, "#quit") def quit_button(self) -> None: self.app.quit() ``` Keyword arguments can be used to match additional selectors for attributes listed in [`ALLOW_SELECTOR_MATCH`][textual.message.Message.ALLOW_SELECTOR_MATCH]. Example: ```python # Handle the activation of the tab "#home" within the `TabbedContent` "#tabs". @on(TabbedContent.TabActivated, "#tabs", pane="#home") def switch_to_home(self) -> None: self.log("Switching back to the home tab.") ... ``` Args: message_type: The message type (i.e. the class). selector: An optional [selector](/guide/CSS#selectors). If supplied, the handler will only be called if `selector` matches the widget from the `control` attribute of the message. **kwargs: Additional selectors for other attributes of the message. NcontrolzFThe message class must have a 'control' to match with the on decoratorzThe attribute z( can't be matched; have you added it to z.ALLOW_SELECTOR_MATCH?zUnable to parse selector z for z; check for syntax errorsctt|ds t|dgt|djf|S)zLStore message and selector in function attribute, return callable unaltered. _textual_on)hasattrsetattrgetattrappend)method message_typeparsed_selectorss r decoratorzon..decoratorTs;v}- FM2 . &--|=M.NO r)rr returnr ) updateitemsrr r ALLOW_SELECTOR_MATCHrrr)r selectorkwargs selectors attribute css_selectorr"r!s` @ronr,sF!#I' )  ;=#,??#4 <  !##w6&\l?? ?"  -UV!**++ABC  *9,*G Y '$  "+L+;5 Kde  s B++C)N)r z type[Message]r'z str | Noner(strr#z(Callable[[DecoratedType], DecoratedType]) __future__rtypingrrtextual.css.modelrtextual.css.parsertextual.css.tokenizerrtextual.messager r Exceptionr rr,rrrr5sj"$)-,#( yFF 9=EE+5EHKE-Er