G@d7:dZddlmZddlZddlmZmZmZmZm Z ddl m Z ddl m Z ddlmZddlmZmZmZdd lmZdd lmZmZdd lmZmZdd lmZmZe eefZeeee ee ee fZ!ee ee!fZ"Gd deZ#dS)z Main menu Plugin. ) OrderedDictN)DictListTupleOptionalUnion) QKeySequence)SpyderAPIError)PLUGIN_REGISTRY)SpyderPluginV2SpyderDockablePluginPlugins_)MENU_SEPARATOR SpyderMenu)ApplicationMenuApplicationMenus)set_menu_icons SpyderActionc eZdZdZeZdZdZedZdZ dZ dZ dZ dZ d Zd Zd Z dd ededefdZ dded eedeedeedeedef dZd efdZ dded eefdZd edefdZdS) MainMenumainmenuFc tdS)Nz Main menusr>lib/python3.11/site-packages/spyder/plugins/mainmenu/plugin.pyget_namezMainMenu.get_name*src,|dS)Ngenprefs) create_iconselfs rget_iconzMainMenu.get_icon.s +++rc tdS)Nz)Provide main application menu management.rr"s rget_descriptionzMainMenu.get_description1s<===rct|_i|_|j}|tjt d|tjt dd|tjt dd|tj t dd|tj t dd|tj t dd| tjr#|tjt d | tjr#|tjt d |tjt d |tjt d |tjt d dS)Nz&Filez&EditFdynamicz&SearchzSour&cez&Runz&Debugz C&onsolesz &Projectsz&Toolsz&Viewz&Help)r_APPLICATION_MENUS _ITEM_QUEUEcreate_application_menurFilerEditSearchSourceRunDebugis_plugin_enabledrIPythonConsoleConsolesProjectsToolsViewHelp)r#create_app_menus r on_initializezMainMenu.on_initialize4s"--- 6(-qzz:::(-qzz5IIII(/9uMMMM(/9uMMMM(,aiiGGGG(.( UKKKK  ! !'"8 9 9 G O,5q~~ F F F  ! !'"2 3 3 G O,5q~~ F F F(.( <<<(-qzz:::(-qzz:::::rcf|jD]}|dSN)r*values_render)r#menus ron_mainwindow_visiblezMainMenu.on_mainwindow_visibleNs;+2244  D LLNNNN  rc|}|D]q}t|ddr"|j||j5|(||qrdS)z Show action shortcuts in menu. Parameters ---------- menu: SpyderMenu Instance of a spyder menu. _shown_shortcutFN)actionsgetattrrC setShortcutr@_show_shortcutsr#r@ menu_actionsactions rrGzMainMenu._show_shortcutsZs||~~ "  Fv0%88 )5&&v'=>>>*$$V[[]]3333  rc$|}|D]x}t|ddr)|j!|t <|(||xydS)z Hide action shortcuts in menu. Parameters ---------- menu: SpyderMenu Instance of a spyder menu. rCFN)rDrErCrFr r@_hide_shortcutsrHs rrLzMainMenu._hide_shortcutsps||~~ "  Fv0%88 )5&&|~~666*$$V[[]]3333  rcptD]}tj|}t|tr|jdkr3|j}|ji |j #t$r|j YwxYwdS)z3Hide options menu when menubar is pressed in macOS.editorN) r get_plugin isinstancer CONF_SECTIONrNget_current_editorstackr@hide options_menuAttributeError _options_menu)r# plugin_nameplugin_instance editorstacks r_hide_options_menuszMainMenu._hide_options_menuss* = =K-8EEO/+?@@ ="/8;;"&+"E"E"G"GK$))++++='499;;;;)==='5::<<<<<= = = =s2B  #B21B2cRtjdkrjD]}j|}|z|j|ffd |j|ffd |j|fd|jjdSdS)z Setup menus.darwinNc.|Sr=rGr@r#s rz'MainMenu._setup_menus..$*>*>t*D*Drc.|Sr=rLr_s rr`z'MainMenu._setup_menus..rarc"t|dSNFrr@s rr`z'MainMenu._setup_menus..s.u*E*Er)sysplatformr* aboutToShowconnect aboutToHiderZr#menu_idr@s` r _setup_menuszMainMenu._setup_menuss <8 # #2 G G.w7#$,,$(DDDDDFFF$,,$(DDDDDFFF$,,$(EEEGGG$,,T-EFFF $ # G GrTrntitler)c|jvr"td|tj||}||_|j|<j|tj dkrz|j |ffd |j |ffd |j |fd|j j |jvr@j|}|D]#}|\}}} } |||| | $|S)z Create a Spyder application menu. Parameters ---------- menu_id: str The menu unique identifier string. title: str The localized menu title to be displayed. z Menu with id "{}" already added!r(r\c.|Sr=r^r_s rr`z2MainMenu.create_application_menu..$"6"6t"<"<rc.|Sr=rcr_s rr`z2MainMenu.create_application_menu..rsrc"t|dSrerfrgs rr`z2MainMenu.create_application_menu..s.u"="=r)rnsectionbeforebefore_section)r*r formatrmainrnmenuBaraddMenurhrirjrkrlrZr+popadd_item_to_application_menu) r#rnrpr)r@ pending_itemspendingitemrv before_itemrxs ` rr,z MainMenu.create_application_menus d- - - 299'BBDD Dty%AAA +/( ##D))) <8 # #   $ $ <<<<< > > >   $ $ <<<<< > > >   $ $ === ? ? ?   $ $T%= > > > d& & & ,0099M( G G07.wn11'7&~2GGGG rNrrvrwrxomit_idc t|ttfs|stdtj|jjtj|jj tj |jj tj |jj tj|jji}||vr9||}|t"||dS||jvr@|j|g} | ||||f| |j|<dS||} | |||||dS)a Add action or widget `item` to given application menu `section`. Parameters ---------- item: SpyderAction or SpyderMenu The item to add to the `menu`. menu_id: str or None The application menu unique string identifier. section: str or None The section id in which to insert the `item` on the `menu`. before: str Make the item appear before the given object identifier. before_section: Section or None Make the item section (if provided) appear before another given section. omit_id: bool If True, then the menu will check if the item to add declares an id, False otherwise. This flag exists only for items added on Spyder 4 plugins. Default: False Notes ----- Must provide a `menu` or a `menu_id`. zDA menu only accepts items objects of type SpyderAction or SpyderMenu)rvrwrxrN)rPrrr rr._mainedit_menu_actionsr/search_menu_actionsr0source_menu_actionsr1run_menu_actionsr2debug_menu_actionsappendrr*r+getget_application_menu add_action) r#rrnrvrwrxrapp_menu_actionsrDpending_menu_itemsr@s rr~z%MainMenu.add_item_to_application_menusn>$z :;; ?G ? ">?? ?  !4:#?  #TZ%C  #TZ%C  $*"=  "DJ$A   & & &&w/G NN> * * * NN4 d555%)%5%9%9'2%F%F""))4&+9+;<<<,> )))0099gf/=w PPPPPrc||jvrZ|j|}|j|dSdS)z Remove a Spyder application menu. Parameters ---------- menu_id: str The menu unique identifier string. N)r*r}rzr{ removeAction menuActionrms rremove_application_menuz MainMenu.remove_application_menusb d- - -*..w77D I     , ,T__->-> ? ? ? ? ? . -ritem_idc l||jvr"td|tj|jj|jjftj|jj |jj ftj |jj |jj ftj|jj|jjftj|jj|jjfi}tj|jjtj|jj tj |jj tj|jjtj|jji}||}||vr||}||}d}t+|D]l\}} d} t-| t.st1| dr| j} n,t-| t4st1| dr| j} | | |kr|}nm|,||||dSdS||dS)a Remove action or widget from given application menu by id. Parameters ---------- item_id: str The item identifier to remove from the given menu. menu_id: str or None The application menu unique string identifier. z{} is not a valid menu_idN action_idrn)r*r ryrr.rr edit_menur/r search_menur0r source_menur1rrun_menur2r debug_menur enumeraterPrhasattrrrrnr} remove_action) r#rrnr app_menusr@rDpositionirJ this_item_ids r!remove_item_from_application_menuz*MainMenu.remove_item_from_application_menus. $1 1 1 !L+ 0G0G HE# H%%%""7+++++$#   w ' ' ' ' 'rreturnc ||jvrGtd|t|j|j|S)z Return an application menu by menu unique id. Parameters ---------- menu_id: ApplicationMenu The menu unique identifier string. z:Application menu "{0}" not found! Available menus are: {1})r*r rylistkeys)r#rns rrzMainMenu.get_application_menuXsf $1 1 1 !!'T$"9">">"@"@AA"C"C  &w//r)T)NNNNFr=)__name__ __module__ __qualname__NAMErQ CONF_FILECAN_BE_DISABLED staticmethodrr$r&r;rArGrLrZrostrboolr,ItemTyperr~rrrrrrrrr$s DLIO\,,,>>>;;;4,,=== G G G$15))s)3))-))))X?C>B=AEI5: :P:P:P.6sm:P.6sm:P.6c]:P6>c] :P /3 :P:P:P:Px @s @ @ @ @DH;(;(;(3;C=;(;(;(;(z0C0J000000rr)$__doc__ collectionsrrhtypingrrrrr qtpy.QtGuir spyder.api.exceptionsr 'spyder.api.plugin_registration.registryr spyder.api.pluginsr r rspyder.api.translationsrspyder.api.widgets.menusrrspyder.plugins.mainmenu.apirrspyder.utils.qthelpersrrrrItemSectionBefore ItemQueuerrrrrs $##### 55555555555555$#####100000CCCCCCLLLLLLLLLL%%%%%%????????IIIIIIII???????? z) * hsmXc]HSM9; d,-- . D0D0D0D0D0~D0D0D0D0D0r