# -*- coding: utf-8 -*-
# -----------------------------------------------------------------------------
# Copyright (c) 2009- Spyder Project Contributors
#
# Distributed under the terms of the MIT License
# (see spyder/__init__.py for details)
# -----------------------------------------------------------------------------

"""
Run Plugin.
"""

# Standard library imports
from __future__ import annotations
from threading import Lock
from typing import List, Optional

# Third-party imports
from qtpy.QtCore import Qt, Signal
from qtpy.QtGui import QIcon
from qtpy.QtWidgets import QAction

# Local imports
from spyder.api.plugins import Plugins, SpyderPluginV2
from spyder.api.plugin_registration.decorators import (
    on_plugin_available, on_plugin_teardown)
from spyder.api.translations import _
from spyder.plugins.run.api import (
    RunConfigurationProvider, SupportedExtensionContexts, RunExecutor,
    SupportedExecutionRunConfiguration, RunResultViewer, OutputFormat,
    RunConfigurationMetadata, RunActions, StoredRunConfigurationExecutor,
    StoredRunExecutorParameters)
from spyder.plugins.run.confpage import RunConfigPage
from spyder.plugins.run.container import RunContainer
from spyder.plugins.toolbar.api import ApplicationToolbars
from spyder.plugins.mainmenu.api import ApplicationMenus, RunMenuSections



# --- Plugin
# ----------------------------------------------------------------------------
class Run(SpyderPluginV2):
    """
    Run Plugin.
    """

    NAME = "run"
    REQUIRES = [Plugins.Preferences, Plugins.WorkingDirectory]
    OPTIONAL = [Plugins.MainMenu, Plugins.Toolbar, Plugins.Shortcuts]
    CONTAINER_CLASS = RunContainer
    CONF_SECTION = NAME
    CONF_WIDGET_CLASS = RunConfigPage
    CONF_FILE = False

    sig_run_input = Signal(str)
    """
    Request to run an input.

    Arguments
    ---------
    context: str
        Context used to request the run input information from the currently
        focused `RunConfigurationProvider`
    """

    # ---- SpyderPluginV2 API
    # -------------------------------------------------------------------------
    @staticmethod
    def get_name():
        return _("Run")

    @staticmethod
    def get_description():
        return _("Manage run configuration for executing files.")

    @classmethod
    def get_icon(cls):
        return cls.create_icon('run')

    def on_initialize(self):
        self.pending_toolbar_actions = []
        self.pending_menu_actions = []
        self.main_menu_ready = False
        self.pending_shortcut_actions = []
        self.all_run_actions = {}
        self.menu_actions = set({})
        self.toolbar_actions = set({})
        self.shortcut_actions = {}
        self.action_lock = Lock()

        container = self.get_container()
        container.sig_run_action_created.connect(
            self._register_action_shortcuts
        )
        container.sig_open_preferences_requested.connect(
            self._open_run_preferences
        )

    @on_plugin_available(plugin=Plugins.WorkingDirectory)
    def on_working_directory_available(self):
        working_dir = self.get_plugin(Plugins.WorkingDirectory)
        working_dir.sig_current_directory_changed.connect(
            self._switch_working_dir
        )
        self._switch_working_dir(working_dir.get_workdir())

    @on_plugin_available(plugin=Plugins.MainMenu)
    def on_main_menu_available(self):
        main_menu = self.get_plugin(Plugins.MainMenu)

        for action in [
            RunActions.Run,
            RunActions.ReRun,
            RunActions.Configure,
            RunActions.GlobalConfigurations,
        ]:
            main_menu.add_item_to_application_menu(
                self.get_action(action),
                ApplicationMenus.Run,
                RunMenuSections.Run,
                before_section=RunMenuSections.RunExtras
            )

        self.main_menu_ready = True

        while self.pending_menu_actions != []:
            action, menu_id, menu_section, before_section = (
                self.pending_menu_actions.pop(0))
            main_menu.add_item_to_application_menu(
                action,
                menu_id,
                menu_section,
                before_section=before_section
            )

    @on_plugin_available(plugin=Plugins.Preferences)
    def on_preferences_available(self):
        preferences = self.get_plugin(Plugins.Preferences)
        preferences.register_plugin_preferences(self)

    @on_plugin_available(plugin=Plugins.Toolbar)
    def on_toolbar_available(self):
        toolbar = self.get_plugin(Plugins.Toolbar)
        toolbar.create_application_toolbar(
            ApplicationToolbars.Run, _("Run toolbar")
        )
        toolbar.add_item_to_application_toolbar(
            self.get_action(RunActions.Run), ApplicationToolbars.Run
        )

        while self.pending_toolbar_actions != []:
            (
                action,
                toolbar_id,
                section,
                before,
                before_section,
            ) = self.pending_toolbar_actions.pop(0)

            toolbar.add_item_to_application_toolbar(
                action,
                toolbar_id,
                section,
                before,
                before_section,
            )

    @on_plugin_available(plugin=Plugins.Shortcuts)
    def on_shortcuts_available(self):
        shortcuts = self.get_plugin(Plugins.Shortcuts)
        while self.pending_shortcut_actions != []:
            args = self.pending_shortcut_actions.pop(0)
            shortcuts.register_shortcut(*args)

    @on_plugin_teardown(plugin=Plugins.WorkingDirectory)
    def on_working_directory_teardown(self):
        working_dir = self.get_plugin(Plugins.WorkingDirectory)
        working_dir.sig_current_directory_changed.disconnect(
            self._switch_working_dir
        )
        self._switch_working_dir(None)

    @on_plugin_teardown(plugin=Plugins.MainMenu)
    def on_main_menu_teardown(self):
        main_menu = self.get_plugin(Plugins.MainMenu)

        for action in [
            RunActions.Run,
            RunActions.ReRun,
            RunActions.Configure,
            RunActions.GlobalConfigurations,
        ]:
            main_menu.remove_item_from_application_menu(
                action,
                ApplicationMenus.Run
            )

        for key in self.menu_actions:
            (_, count, action_id) = self.all_run_actions[key]
            if count > 0:
                main_menu.remove_item_from_application_menu(
                    action_id, ApplicationMenus.Run
                )

    @on_plugin_teardown(plugin=Plugins.Preferences)
    def on_preferences_teardown(self):
        preferences = self.get_plugin(Plugins.Preferences)
        preferences.deregister_plugin_preferences(self)

    @on_plugin_teardown(plugin=Plugins.Toolbar)
    def on_toolbar_teardown(self):
        toolbar = self.get_plugin(Plugins.Toolbar)
        toolbar.remove_item_from_application_toolbar(
            RunActions.Run, ApplicationToolbars.Run
        )

        for key in self.toolbar_actions:
            (_, count, action_id) = self.all_run_actions[key]
            if count > 0:
                toolbar.remove_item_from_application_toolbar(
                    action_id, ApplicationToolbars.Run
                )

        toolbar.remove_application_toolbar(ApplicationToolbars.Run)

    @on_plugin_teardown(plugin=Plugins.Shortcuts)
    def on_shortcuts_teardown(self):
        shortcuts = self.get_plugin(Plugins.Shortcuts)
        for key in self.shortcut_actions:
            (action, count, action_id) = self.all_run_actions[key]
            if count > 0:
                shortcut_context = self.shortcut_actions[key]
                shortcuts.unregister_shortcut(
                    action, shortcut_context, action_id
                )

    # ---- Public API
    # -------------------------------------------------------------------------
    def register_run_configuration_provider(
        self,
        provider_name: str,
        supported_extensions_contexts: List[SupportedExtensionContexts]
    ):
        """
        Register the extensions and contexts that a `RunConfigurationProvider`
        supports.

        Parameters
        ----------
        provider_name: str
            The identifier of the :class:`RunConfigurationProvider` instance
            that is registering the set of supported contexts per extension.
        supported_extensions_contexts: List[SupportedExtensionContexts]
            A list containing the supported contexts per file extension.
        """
        self.get_container().register_run_configuration_provider(
            provider_name, supported_extensions_contexts)

    def deregister_run_configuration_provider(
        self,
        provider_name: str,
        unsupported_extensions_contexts: List[SupportedExtensionContexts]
    ):
        """
        Deregister the extensions and contexts that a
        `RunConfigurationProvider` no longer supports.

        Parameters
        ----------
        provider_name: str
            The identifier of the :class:`RunConfigurationProvider` instance
            that is registering the set of formerly supported contexts
            per extension.
        unsupported_extensions_contexts: List[SupportedExtensionContexts]
            A list containing the formerly supported contexts per
            file extension.
        """
        self.get_container().deregister_run_configuration_provider(
            provider_name, unsupported_extensions_contexts)

    def register_run_configuration_metadata(
        self,
        provider: RunConfigurationProvider,
        metadata: RunConfigurationMetadata
    ):
        """
        Register the metadata for a run configuration.

        Parameters
        ----------
        provider: RunConfigurationProvider
            A :class:`SpyderPluginV2` instance that implements the
            :class:`RunConfigurationProvider` interface and will register
            and own a run configuration.
        metadata: RunConfigurationMetadata
            The metadata for a run configuration that the provider is able to
            produce.

        Notes
        -----
        The unique identifier for the metadata dictionary is produced and
        managed by the provider and the Run plugin will only refer to the
        run configuration by using such id.
        """
        self.get_container().register_run_configuration_metadata(
            provider, metadata)

    def get_currently_selected_configuration(self):
        """
        Get currently selected configuration
        """
        return self.get_container().currently_selected_configuration

    def deregister_run_configuration_metadata(self, uuid: str):
        """
        Deregister a given run configuration by its unique identifier.

        Parameters
        ----------
        uuid: str
            Unique identifier for a run configuration metadata that will not
            longer exist. This id should have been registered using
            `register_run_configuration_metadata`.
        """
        self.get_container().deregister_run_configuration_metadata(uuid)

    def register_executor_configuration(
        self,
        provider: RunExecutor,
        configuration: List[SupportedExecutionRunConfiguration]
    ):
        """
        Register a :class:`RunExecutor` instance to indicate its support
        for a given set of run configurations. This method can be called
        whenever an executor can extend its support for a given run input
        configuration.

        Parameters
        ----------
        provider: RunExecutor
            A :class:`SpyderPluginV2` instance that implements the
            :class:`RunExecutor` interface and will register execution
            input type information.
        configuration: List[SupportedExecutionRunConfiguration]
            A list of input configurations that the provider is able to
            process. Each configuration specifies the input extension
            identifier, the available execution context and the output formats
            for that type.
        """
        self.get_container().register_executor_configuration(
            provider, configuration)

    def deregister_executor_configuration(
        self,
        provider: RunExecutor,
        configuration: List[SupportedExecutionRunConfiguration]
    ):
        """
        Deregister a :class:`RunConfigurationProvider` instance from providing
        a set of run configurations that are no longer supported by it.
        This method can be called whenever an input provider wants to remove
        its support for a given run input configuration.

        Parameters
        ----------
        provider: RunConfigurationProvider
            A :class:`SpyderPluginV2` instance that implements the
            :class:`RunConfigurationProvider` interface and will deregister
            execution input type information.
        configuration: List[SupportedExecutionRunConfiguration]
            A list of input configurations that the provider is able to
            process. Each configuration specifies the input extension
            identifier, the available execution context and the output formats
            for that type.
        """
        self.get_container().deregister_executor_configuration(
            provider, configuration)

    def register_viewer_configuration(
        self,
        viewer: RunResultViewer,
        formats: List[OutputFormat]
    ):
        """
        Register a :class:`RunExecutorProvider` instance to indicate its
        support for a given set of output run result formats. This method can
        be called whenever a viewer can extend its support for a given output
        format.

        Parameters
        ----------
        provider: RunResultViewer
            A :class:`SpyderPluginV2` instance that implements the
            :class:`RunResultViewer` interface and will register
            supported output formats.
        formats: List[OutputFormat]
            A list of output formats that the viewer is able to display.
        """
        self.get_container().register_viewer_configuration(viewer, formats)

    def deregister_viewer_configuration(
        self,
        viewer: RunResultViewer,
        formats: List[OutputFormat]
    ):
        """
        Deregister a :class:`RunResultViewer` instance from supporting a set of
        output formats that are no longer supported by it. This method
        can be called whenever a viewer wants to remove its support
        for a given output format.

        Parameters
        ----------
        provider: RunResultViewer
            A :class:`SpyderPluginV2` instance that implements the
            :class:`RunResultViewer` interface and will deregister
            output format support.
        formats: List[OutputFormat]
            A list of output formats that the viewer wants to deregister.
        """
        self.get_container().deregister_viewer_configuration(viewer, formats)

    def create_run_button(
        self,
        context_name: str,
        text: str,
        icon: Optional[QIcon] = None,
        tip: Optional[str] = None,
        shortcut_context: Optional[str] = None,
        register_shortcut: bool = False,
        extra_action_name: Optional[str] = None,
        context_modificator: Optional[str] = None,
        add_to_toolbar: bool | str | dict = False,
        add_to_menu: bool | dict = False,
        re_run: bool = False
    ) -> QAction:
        """
        Create a run or a "run and do something" (optionally re-run) button
        for a specific run context.

        Parameters
        ----------
        context_name: str
            The identifier of the run context.
        text: str
           Localized text for the action
        icon: Optional[QIcon]
            Icon for the action when used in menu or toolbar.
        tip: Optional[str]
            Tooltip to define for action on menu or toolbar.
        shortcut_context: Optional[str]
            Set the `str` context of the shortcut.
        register_shortcut: bool
            If True, main window will expose the shortcut in Preferences.
            The default value is `False`.
        extra_action_name: Optional[str]
            The name of the action to execute on the run input provider
            after requesting the run input.
        context_modificator: Optional[str]
            The name of the modification to apply to the action, e.g. run
            selection <up to line>.
        add_to_toolbar: bool or str
            If True, then the action will be added to the Run section of the
            main toolbar. If a string, it must be a toolbar_id. If dictionary,
            it corresponds to
            {'toolbar': ..., 'section': ..., 'before': ...,
             'before_section': ...}
        add_to_menu: bool or dict
            If True, then the action will be added to the Run menu.
            If a dictionnary, it corresponds to
            {'menu': ..., 'section': ..., 'before_section': ...}
        re_run: bool
            If True, then the button will act as a re-run button instead of
            a run one.

        Returns
        -------
        action: SpyderAction
            The corresponding action that was created.

        Notes
        -----
        1. The context passed as a parameter must be a subordinate of the
        context of the current focused run configuration that was
        registered via `register_run_configuration_metadata`. For instance,
        Cell can be used if and only if the file was registered.

        2. The button will be registered as `run <context>` or
        `run <context> <context_modificator> and <extra_action_name>`
        on the action registry.

        3. The created button will operate over the last focused run input
        provider.

        4. If the requested button already exists, this method will not do
        anything, which implies that the first registered shortcut will be the
        one to be used. For the built-in run contexts (file, cell and
        selection), the editor will register their corresponding icons and
        shortcuts.
        """
        key = (context_name, extra_action_name, context_modificator,
               re_run)

        action = self.get_container().create_run_button(
            context_name,
            text,
            icon=icon,
            tip=tip,
            shortcut_context=shortcut_context,
            register_shortcut=register_shortcut,
            extra_action_name=extra_action_name,
            context_modificator=context_modificator,
            re_run=re_run
        )

        if add_to_toolbar:
            toolbar_id, section, before, before_section = (
                ApplicationToolbars.Run,
                None,
                None,
                None
            )
            if isinstance(add_to_toolbar, str):
                toolbar_id = add_to_toolbar
            if isinstance(add_to_toolbar, dict):
                toolbar_id = add_to_toolbar['toolbar']
                section = add_to_toolbar.get('section')
                before = add_to_toolbar.get('before')
                before_section = add_to_toolbar.get('before_section')

            toolbar = self.get_plugin(Plugins.Toolbar)
            if toolbar:
                toolbar.add_item_to_application_toolbar(
                    action,
                    toolbar_id,
                    section,
                    before,
                    before_section,
                )
            else:
                self.pending_toolbar_actions.append(
                    (
                        action,
                        toolbar_id,
                        section,
                        before,
                        before_section,
                    )
                )

            self.toolbar_actions |= {key}

        if add_to_menu:
            menu_id, menu_section, before_section = (
                ApplicationMenus.Run, RunMenuSections.RunExtras,
                RunMenuSections.RunInExecutors
            )
            if isinstance(add_to_menu, dict):
                menu_id = add_to_menu['menu']
                menu_section = add_to_menu['section']
                before_section = add_to_menu.get('before_section', None)

            main_menu = self.get_plugin(Plugins.MainMenu)
            if self.main_menu_ready and main_menu:
                main_menu.add_item_to_application_menu(
                    action, menu_id, menu_section,
                    before_section=before_section
                )
            else:
                self.pending_menu_actions.append((
                    action,
                    menu_id,
                    menu_section,
                    before_section
                ))

            self.menu_actions |= {key}

        if register_shortcut:
            self.shortcut_actions[key] = shortcut_context

        with self.action_lock:
            (_, count, _) = self.all_run_actions.get(key, (None, 0, None))
            count += 1
            self.all_run_actions[key] = (action, count, action.action_id)

        return action

    def destroy_run_button(
        self,
        context_name: str,
        extra_action_name: Optional[str] = None,
        context_modificator: Optional[str] = None,
        re_run: bool = False
    ):
        """
        Destroy a run or a "run and do something" (optionally re-run) button
        for a specific run context.

        Parameters
        ----------
        context_name: str
            The identifier of the run context.
        extra_action_name: Optional[str]
            The name of the action to execute on the run input provider
            after requesting the run input.
        context_modificator: Optional[str]
            The name of the modification to apply to the action, e.g. run
            run selection <up to line>.
        re_run: bool
            If True, then the button was registered as a re-run button
            instead of a run one.

        Notes
        -----
        1. The action will be removed from the main menu and toolbar if and
        only if there is no longer a RunInputProvider that registered the same
        action and has not called this method.
        """
        main_menu = self.get_plugin(Plugins.MainMenu)
        toolbar = self.get_plugin(Plugins.Toolbar)
        shortcuts = self.get_plugin(Plugins.Shortcuts)

        key = (context_name, extra_action_name, context_modificator,
               re_run)

        with self.action_lock:
            action, count, action_id = self.all_run_actions[key]

            if count == 0:
                self.all_run_actions.pop(key)
                if key in self.menu_actions:
                    self.menu_actions.pop(key)
                    if main_menu:
                        main_menu.remove_item_from_application_menu(
                            action_id, menu_id=ApplicationMenus.Run
                        )

                if key in self.toolbar_actions:
                    self.toolbar_actions.pop(key)
                    if toolbar:
                        toolbar.remove_item_from_application_toolbar(
                            action_id, toolbar_id=ApplicationToolbars.Run
                        )

                if key in self.shortcut_actions:
                    shortcut_context = self.shortcut_actions.pop(key)
                    if shortcuts:
                        shortcuts.unregister_shortcut(
                            action, shortcut_context, action_id
                        )
                        shortcuts.apply_shortcuts()
            else:
                count -= 1
                self.all_run_actions[key] = (action, count, action_id)

    def create_run_in_executor_button(
        self,
        context_name: str,
        executor_name: str,
        text: str,
        icon: Optional[QIcon] = None,
        tip: Optional[str] = None,
        shortcut_context: Optional[str] = None,
        register_shortcut: bool = False,
        add_to_toolbar: bool | str | dict = False,
        add_to_menu: bool | dict = False,
        shortcut_widget_context: Qt.ShortcutContext = Qt.WidgetShortcut,
    ) -> QAction:
        """
        Create a "run <context> in <provider>" button for a given run context
        and executor.

        Parameters
        ----------
        context_name: str
            The identifier of the run context.
        executor_name: str
            The identifier of the run executor.
        text: str
           Localized text for the action
        icon: Optional[QIcon]
            Icon for the action when used in menu or toolbar.
        tip: Optional[str]
            Tooltip to define for action on menu or toolbar.
        shortcut_context: Optional[str]
            Set the `str` context of the shortcut.
        register_shortcut: bool
            If True, main window will expose the shortcut in Preferences.
            The default value is `False`.
        add_to_toolbar: bool or str or dict
            If True, then the action will be added to the Run section of the
            main toolbar. If a string, it must be a toolbar_id. If dictionary,
            it corresponds to
            {'toolbar': ..., 'section': ..., 'before': ...,
             'before_section': ...}
        add_to_menu: bool or dict
            If True, then the action will be added to the Run menu.
            If a dictionnary, it corresponds to
            {'menu': ..., 'section': ..., 'before_section': ...}
        shortcut_widget_context: Qt.ShortcutContext
            Qt context for the shorctut set for this button.

        Returns
        -------
        action: SpyderAction
            The corresponding action that was created.

        Notes
        -----
        1. The context passed as a parameter must be a subordinate of the
        context of the current focused run configuration that was
        registered via `register_run_configuration_metadata`. For instance,
        Cell can be used if and only if the file was registered.

        2. The button will be registered as `run <context> in <provider>` on
        the action registry.

        3. The created button will operate over the last focused run input
        provider.

        4. If the requested button already exists, this method will not do
        anything, which implies that the first registered shortcut will be the
        one to be used.
        """
        key = (context_name, executor_name, None, False)

        action = self.get_container().create_run_in_executor_button(
            context_name,
            executor_name,
            text,
            icon=icon,
            tip=tip,
            shortcut_context=shortcut_context,
            register_shortcut=register_shortcut,
            shortcut_widget_context=shortcut_widget_context,
        )

        if add_to_toolbar:
            toolbar_id, section, before, before_section = (
                ApplicationToolbars.Run,
                None,
                None,
                None
            )
            if isinstance(add_to_toolbar, str):
                toolbar_id = add_to_toolbar
            if isinstance(add_to_toolbar, dict):
                toolbar_id = add_to_toolbar['toolbar']
                section = add_to_toolbar.get('section')
                before = add_to_toolbar.get('before')
                before_section = add_to_toolbar.get('before_section')

            toolbar = self.get_plugin(Plugins.Toolbar)
            if toolbar:
                toolbar.add_item_to_application_toolbar(
                    action,
                    toolbar_id,
                    section,
                    before,
                    before_section,
                )
            else:
                self.pending_toolbar_actions.append(
                    (
                        action,
                        toolbar_id,
                        section,
                        before,
                        before_section,
                    )
                )

            self.toolbar_actions |= {key}

        if add_to_menu:
            menu_id, menu_section, before_section = (
                ApplicationMenus.Run, RunMenuSections.RunExtras,
                RunMenuSections.RunInExecutors
            )
            if isinstance(add_to_menu, dict):
                menu_id = add_to_menu['menu']
                menu_section = add_to_menu['section']
                before_section = add_to_menu.get('before_section', None)

            main_menu = self.get_plugin(Plugins.MainMenu)
            if self.main_menu_ready and main_menu:
                main_menu.add_item_to_application_menu(
                    action, menu_id, menu_section,
                    before_section=before_section
                )
            else:
                self.pending_menu_actions.append((
                    action,
                    menu_id,
                    menu_section,
                    before_section
                ))

            self.menu_actions |= {key}

        if register_shortcut:
            self.shortcut_actions[key] = shortcut_context

        self.all_run_actions[key] = (action, 1, action.action_id)
        return action

    def destroy_run_in_executor_button(
        self,
        context_name: str,
        executor_name: str
    ):
        """
        Destroy a "run <context> in <provider>" button for a given run context
        and executor.

        Parameters
        ----------
        context_name: str
            The identifier of the run context.
        executor_name: str
            The identifier of the run executor.
        """
        self.destroy_run_button(context_name, executor_name, None)

    def get_last_used_executor_parameters(
        self,
        uuid: str
    ) -> StoredRunConfigurationExecutor:
        """
        Retrieve the last used execution parameters for a given
        run configuration.

        Parameters
        ----------
        uuid: str
            The run configuration identifier.

        Returns
        -------
        last_used_params: StoredRunConfigurationExecutor
            A dictionary containing the last used executor and parameters
            for the given run configuration.
        """
        return self.get_container().get_last_used_executor_parameters(uuid)

    def get_executor_configuration_parameters(
        self,
        executor_name: str,
        extension: str, context_id: str
    ) -> StoredRunExecutorParameters:
        """
        Retrieve the stored parameters for a given executor `executor_name`
        using context `context_id` with file extension `extension`.

        Parameters
        ----------
        executor_name: str
            The identifier of the run executor.
        extension: str
            The file extension to register the configuration parameters for.
        context_id: str
            The context to register the configuration parameters for.

        Returns
        -------
        config: StoredRunExecutorParameters
            A dictionary containing the run executor parameters for the given
            run configuration.
        """
        return self.get_container().get_executor_configuration_parameters(
            executor_name, extension, context_id)

    def switch_focused_run_configuration(self, uuid: str):
        """
        Switch to the last selected run configuration.

        Parameters
        ----------
        uuid: str
            The run configuration identifier.
        """
        self.get_container().switch_focused_run_configuration(uuid)

    # ---- Private API
    # -------------------------------------------------------------------------
    def _switch_working_dir(self, path: str):
        self.get_container().set_current_working_dir(path)

    def _register_action_shortcuts(
        self,
        action_name: str,
        register_shortcut: bool,
        shortcut_context: str
    ):
        if register_shortcut:
            action = self.get_action(action_name)
            shortcuts = self.get_plugin(Plugins.Shortcuts)
            if shortcuts:
                shortcuts.register_shortcut(action, shortcut_context,
                                            action_name)
            else:
                self.pending_shortcut_actions.append(
                    (action, shortcut_context, action_name))

    def _open_run_preferences(self):
        preferences = self.get_plugin(Plugins.Preferences)
        preferences.open_dialog()

        container = preferences.get_container()
        dlg = container.dialog
        index = dlg.get_index_by_name("run")
        dlg.set_current_index(index)
