PrEditor 0.8.0__py2.py3-none-any.whl → 0.10.0__py2.py3-none-any.whl

preditor/__init__.py

@@ -66,51 +66,74 @@ def init():
 
 
 def configure(name, parent_callback=None, excepthook=True, logging=True, streams=True):
-    """Global configuration of PrEditor. Nothing is done if called more than once.
+    """Global configuration of PrEditor. Safe to re-call until the instance is created.
+
+    Configures the instance of PrEditor without creating the GUI. It should be run
+    as early as possible in the applications initialization to allow PrEditor to
+    show as much stdout/err text as possible even the text printed before the
+    application's GUI is created.
+
+    Once `preditor.instance(create=True)` is called this will return without
+    making any changes. Otherwise unless noted with "First call only." each time
+    this function is called it will update any previously set values. This allows
+    you to minimally configure PrEditor and as more of the application comes
+    online enable more advanced features.
 
     Args:
         name (str): The core_name to use for the global instance of PrEditor.
             Once this has been set, you can call `launch` without passing name
-            to access the main instance.
+            to access the main instance. The core_name controls what preferences
+            are loaded and used by PrEditor including the workbox tabs.
         parent_callback (callable, optional): Callback that returns a QWidget
             to use as the parent of the LoggerWindow when its first created.
             This can be used by DCC's to set the parent to their main window.
-        excepthook (bool, optional): Replaces `sys.excepthook` with a interactive
-            exception handler that prompts the user to show PrEditor when an
-            python exception is raised.
-        logging (bool, optional): Restore the python logging configuration that
-            was recorded the last time PrEditor prefs were saved.
-        streams (bool, optional): Install the stream manager to capture any
-            stdout/stderr text written. Later when calling launch, the
+        excepthook (bool, optional): First call only. Replaces `sys.excepthook`
+            with a interactive exception handler that prompts the user to show
+            PrEditor when an python exception is raised. It is recommended that
+            you only add the excepthook once the Qt UI is initialized.
+        logging (bool, optional): Restore the python logging configuration settings
+            that were recorded the last time PrEditor prefs were saved. If called
+            multiple times with different core_name's before the instance is
+            created, this will reset the logging configuration from the previous
+            core_name if logging prefs exist.
+        streams (bool, optional): First call only. Install the stream manager to
+            capture any stdout/stderr text written. Later when calling launch, the
             LoggerWindow will show all of the captured text. This lets you only
-            create the LoggerWindow IF you need to, but when you do it will have
-            all of the std stream text written after this call.
+            create the LoggerWindow IF you need to show it, but when you do it
+            will have all of the std stream text written after this call.
     """
-    # Once this has been set, configure should not do anything
-    if 'core_name' in _global_config:
+    # Once the UI instance has been created, configure should not do anything.
+    if instance(create=False):
         return
 
-    # Store the core_name,.
+    # Store the core_name.
+    changed = _global_config.get('core_name') != name
     _global_config['core_name'] = name
     if parent_callback:
         _global_config['parent_callback'] = parent_callback
 
-    if streams:
+    if streams and not _global_config.get('streams_installed'):
         # Install the stream manager to capture output
         from preditor.stream import install_to_std
 
         install_to_std()
+        _global_config['streams_installed'] = True
 
-    if logging:
+    if logging and changed:
+        # Only update the logging config if the core name has changed.
+        # Note: When called repeatedly, this won't remove old logger's added by
+        # the previous calls so you may see some loggers added that were never
+        # actually added by code other than the LoggingConfig.
         from .logging_config import LoggingConfig
 
         cfg = LoggingConfig(core_name=name)
         cfg.load()
 
-    if excepthook:
+    if excepthook and not _global_config.get('excepthook_installed'):
         import preditor.debug
 
         preditor.debug.BlurExcepthook.install()
+        _global_config['excepthook_installed'] = True
 
 
 def get_core_name():
@@ -229,6 +252,16 @@ def root_window():
     return App.root_window()
 
 
+def parent_callback():
+    """Returns the parent_callback or None.
+
+    This is a callback that returns a QWidget to use as the parent of the
+    LoggerWindow when its first created. This can be used by DCC's to set the
+    parent to their main window.
+    """
+    return _global_config.get("parent_callback")
+
+
 def connect_preditor(
     parent, sequence='F2', text='Show PrEditor', obj_name='uiShowPreditorACT', name=None
 ):

preditor/cores/core.py

@@ -1,6 +1,6 @@
 from __future__ import absolute_import, print_function
 
-from Qt.QtCore import QObject, Signal
+from Qt.QtCore import QObject
 
 
 class Core(QObject):
@@ -9,17 +9,11 @@ class Core(QObject):
     be distributed between different pacakges.
     """
 
-    # ----------------------------------------------------------------
-    # blurdev signals
-    aboutToClearPaths = Signal()  # Emitted before environment is changed or reloaded
-
-    # ----------------------------------------------------------------
-
     def __init__(self, objectName=None):
-        QObject.__init__(self)
+        super(Core, self).__init__()
         if objectName is None:
-            objectName = 'blurdev'
-        QObject.setObjectName(self, objectName)
+            objectName = 'PrEditor'
+        self.setObjectName(objectName)
 
         # create custom properties
         self._headless = False

preditor/gui/__init__.py

@@ -3,6 +3,7 @@ from __future__ import absolute_import
 from functools import partial
 
 from Qt.QtCore import Property
+from Qt.QtWidgets import QStackedWidget
 
 from .dialog import Dialog  # noqa: F401
 from .window import Window  # noqa: F401
@@ -82,3 +83,11 @@ def loadUi(filename, widget, uiname=''):
         uiname = os.path.basename(filename).split('.')[0]
 
     QtCompat.loadUi(os.path.split(filename)[0] + '/ui/%s.ui' % uiname, widget)
+
+
+def tab_widget_for_tab(tab_widget):
+    """Returns the `QTabWidget` `tab_widget` is parented to or `None`."""
+    tab_parent = tab_widget.parent()
+    if not isinstance(tab_parent, QStackedWidget):
+        return None
+    return tab_parent.parent()

preditor/gui/dialog.py

@@ -3,7 +3,7 @@ from __future__ import absolute_import
 from Qt.QtCore import Qt
 from Qt.QtWidgets import QDialog
 
-from .. import core, relativePath, root_window
+from .. import relativePath, root_window
 
 
 class Dialog(QDialog):
@@ -25,9 +25,6 @@ class Dialog(QDialog):
             cls._instance = cls(parent=parent)
             # protect the memory
             cls._instance.setAttribute(Qt.WA_DeleteOnClose, False)
-            # but make sure that if we reload the environment, everything gets deleted
-            # properly
-            core.aboutToClearPaths.connect(cls._instance.shutdown)
         return cls._instance
 
     def __init__(
@@ -80,9 +77,6 @@ class Dialog(QDialog):
         # If this value is set to False calling setGeometry on this dialog will not
         # adjust the geometry to ensure the dialog is on a valid screen.
         self.checkScreenGeo = True
-        # If this value is set to True the dialog will listen for
-        # core.aboutToClearPaths and call shutdown on the dialog.
-        self.aboutToClearPathsEnabled = True
         # attempt to set the dialog icon
         import os
         import sys
@@ -128,13 +122,6 @@ class Dialog(QDialog):
 
             WinWidget.uncache(wwidget)
 
-        # only disconnect here if deleting on close
-        if self.aboutToClearPathsEnabled and self.testAttribute(Qt.WA_DeleteOnClose):
-            try:
-                core.aboutToClearPaths.disconnect(self.shutdown)
-            except TypeError:
-                pass
-
     def exec_(self):
         # do not use the DeleteOnClose attribute when executing a dialog as often times
         # a user will be accessing information from the dialog instance after it closes.
@@ -158,13 +145,6 @@ class Dialog(QDialog):
 
             ensureWindowIsVisible(self)
 
-    def showEvent(self, event):
-        # listen for aboutToClearPaths signal if requested
-        # but only connect here if deleting on close
-        if self.aboutToClearPathsEnabled and self.testAttribute(Qt.WA_DeleteOnClose):
-            core.aboutToClearPaths.connect(self.shutdown)
-        super(Dialog, self).showEvent(event)
-
     def shutdown(self):
         # use a @classmethod to make inheritance magically work
         self._shutdown(self)
@@ -178,8 +158,6 @@ class Dialog(QDialog):
         # allow the global instance to be cleared
         if this == cls._instance:
             cls._instance = None
-            if this.aboutToClearPathsEnabled:
-                core.aboutToClearPaths.disconnect(this.shutdown)
             this.setAttribute(Qt.WA_DeleteOnClose, True)
         try:
             this.close()

preditor/gui/group_tab_widget/__init__.py

@@ -70,7 +70,7 @@ class GroupTabWidget(OneTabWidget):
         self.uiCornerBTN = corner
         self.setCornerWidget(self.uiCornerBTN, Qt.TopRightCorner)
 
-    def add_new_tab(self, group, title="Workbox"):
+    def add_new_tab(self, group, title="Workbox", group_fmt=None):
         """Adds a new tab to the requested group, creating the group if the group
         doesn't exist.
 
@@ -79,6 +79,11 @@ class GroupTabWidget(OneTabWidget):
                 existing tab, or the name of the group and it will create the group
                 if needed. If None is passed it will add a new tab `Group {last+1}`.
                 If True is passed, then the current group tab is used.
+            title (str, optional): The name to give the newly created tab inside
+                the group.
+            group_fmt(str, optional): If None is passed to group, this string is
+                used to search for existing tabs to calculate the last number
+                and generate the new group tab name.
 
         Returns:
             GroupedTabWidget: The tab group for this group.
@@ -86,12 +91,14 @@ class GroupTabWidget(OneTabWidget):
         """
         parent = None
         if not group:
+            if group_fmt is None:
+                group_fmt = r'Group {}'
             last = 0
             for i in range(self.count()):
-                match = re.match(r'Group (\d+)', self.tabText(i))
+                match = re.match(group_fmt.format(r'(\d+)'), self.tabText(i))
                 if match:
                     last = max(last, int(match.group(1)))
-            group = "Group {}".format(last + 1)
+            group = group_fmt.format(last + 1)
         elif group is True:
             group = self.currentIndex()
         if isinstance(group, int):

preditor/gui/level_buttons.py

@@ -212,9 +212,7 @@ class HandlerMenu(LazyMenu):
         self.logger = logger
 
     def install_handler(self, name):
-        for _, cls in plugins.logging_handlers(name):
-            handler = cls()
-            self.logger.addHandler(handler)
+        plugins.add_logging_handler(self.logger, name)
 
     def refresh(self):
         self.clear()
@@ -224,7 +222,7 @@ class HandlerMenu(LazyMenu):
             act = handler_install.addAction(name)
             act.triggered.connect(partial(self.install_handler, name))
             for h in self.logger.handlers:
-                if isinstance(h, cls):
+                if type(h) is cls:
                     act.setEnabled(False)
                     act.setToolTip('Already installed for this logger.')
                     break

preditor/gui/logger_window_handler.py

@@ -1,13 +1,12 @@
 from __future__ import absolute_import
 
 import logging
-import weakref
 
 from .. import instance
 
 
 class LoggerWindowHandler(logging.Handler):
-    """A logging handler that writes directly to the Python Logger.
+    """A logging handler that writes directly to the PrEditor instance.
 
     Args:
         error (bool, optional): Write the output as if it were written
@@ -22,7 +21,6 @@ class LoggerWindowHandler(logging.Handler):
 
     def __init__(self, error=True, formatter=default_format):
         super(LoggerWindowHandler, self).__init__()
-        self.console = weakref.ref(instance().console())
         self.error = error
         if formatter is not None:
             if not isinstance(formatter, logging.Formatter):
@@ -30,10 +28,14 @@ class LoggerWindowHandler(logging.Handler):
             self.setFormatter(formatter)
 
     def emit(self, record):
+        _instance = instance(create=False)
+        if _instance is None:
+            # No gui has been created yet, so nothing to do
+            return
         try:
             # If the python logger was closed and garbage collected,
             # there is nothing to do, simply exit the call
-            console = self.console()
+            console = _instance.console()
             if not console:
                 return
 

preditor/gui/logger_window_plugin.py

@@ -0,0 +1,32 @@
+class LoggerWindowPlugin:
+    """Base class for LoggerWindow plugins.
+
+    These plugins are loaded using the `preditor.plug.loggerwindow` entry point.
+    This entry point is loaded when `LoggerWindow` is initialized. For each entry
+    point defined a single instance of the plugin is created per instance of
+    a LoggerWindow.
+
+    To save preferences override `record_prefs` and `restore_prefs` methods. These
+    are used to save and load preferences any time the PrEditor save/loads prefs.
+    """
+
+    def __init__(self, parent):
+        self.parent = parent
+
+    def record_prefs(self, name):
+        """Returns any prefs to save with the PrEditor's preferences.
+
+        Returns:
+            dict: A dictionary that will be saved using json or None.
+        """
+
+    def restore_prefs(self, name, prefs):
+        """Restore the preferences saved from a previous launch.
+
+        Args:
+            name(str): The name specified by the `preditor.plug.loggerwindow`
+                entry point.
+            prefs(dict or None): The prefs returned by a previous call to
+                `record_prefs()` from the last preference save. None is passed
+                if no prefs were recorded.
+        """

preditor/gui/loggerwindow.py

@@ -37,7 +37,7 @@ from .. import (
     resourcePath,
 )
 from ..delayable_engine import DelayableEngine
-from ..gui import Dialog, Window, loadUi
+from ..gui import Dialog, Window, loadUi, tab_widget_for_tab
 from ..gui.fuzzy_search.fuzzy_search import FuzzySearch
 from ..gui.group_tab_widget.grouped_tab_models import GroupTabListItemModel
 from ..logging_config import LoggingConfig
@@ -55,6 +55,31 @@ class WorkboxPages:
     Workboxes = 1
 
 
+class WorkboxName(str):
+    """The joined name of a workbox `group/workbox` with access to its parts.
+
+    This subclass provides properties for the group and workbox values separately.
+    """
+
+    def __new__(cls, group, workbox):
+        txt = "/".join((group, workbox))
+        ret = super().__new__(cls, txt)
+        # Preserve the imitable nature of str's by using properties without setters.
+        ret._group = group
+        ret._workbox = workbox
+        return ret
+
+    @property
+    def group(self):
+        """The tab name of the group tab that contains the workbox."""
+        return self._group
+
+    @property
+    def workbox(self):
+        """The workbox of the tab for this workbox inside of the group."""
+        return self._workbox
+
+
 class LoggerWindow(Window):
     _instance = None
     styleSheetChanged = Signal(str)
@@ -62,7 +87,6 @@ class LoggerWindow(Window):
     def __init__(self, parent, name=None, run_workbox=False, standalone=False):
         super(LoggerWindow, self).__init__(parent=parent)
         self.name = name if name else get_core_name()
-        self.aboutToClearPathsEnabled = False
         self._stylesheet = 'Bright'
 
         # Create timer to autohide status messages
@@ -237,7 +261,6 @@ class LoggerWindow(Window):
         self.uiBackupPreferencesACT.triggered.connect(self.backupPreferences)
         self.uiBrowsePreferencesACT.triggered.connect(self.browsePreferences)
         self.uiAboutPreditorACT.triggered.connect(self.show_about)
-        core.aboutToClearPaths.connect(self.pathsAboutToBeCleared)
         self.uiSetFlashWindowIntervalACT.triggered.connect(self.setFlashWindowInterval)
 
         self.uiSetPreferredTextEditorPathACT.triggered.connect(
@@ -264,6 +287,12 @@ class LoggerWindow(Window):
         self.addAction(self.uiClearLogACT)
 
         self.dont_ask_again = []
+
+        # Load any plugins that modify the LoggerWindow
+        self.plugins = {}
+        for name, plugin in plugins.loggerwindow():
+            self.plugins[name] = plugin(self)
+
         self.restorePrefs()
 
         # add stylesheet menu options.
@@ -335,16 +364,48 @@ class LoggerWindow(Window):
 
     @classmethod
     def name_for_workbox(cls, workbox):
-        """Returns the name for a given workbox.
-        The name is the group tab text and the workbox tab text joined by a `/`"""
-        ret = []
-        logger = cls.instance()
-        index = logger.uiWorkboxTAB.currentIndex()
-        ret.append(logger.uiWorkboxTAB.tabText(index))
-        group_widget = logger.uiWorkboxTAB.currentWidget()
-        index = group_widget.currentIndex()
-        ret.append(group_widget.tabText(index))
-        return "/".join(ret)
+        """Returns the name for a given workbox or None if not valid.
+
+        The name is a `WorkboxName` object showing the group and name joined by
+        a `/`.
+
+        Args:
+            workbox: The workbox to get the name of. If None is passed then it
+                will return the name of the current workbox.
+
+        Returns:
+            The name of the widget as a `WorkboxName` object showing the group
+            and name joined by a `/`. If workbox is not valid for the LoggerWindow
+            instance then None is returned.
+        """
+
+        if workbox is None:
+            # if the workbox was not provided use the current workbox
+            logger = cls.instance()
+            index = logger.uiWorkboxTAB.currentIndex()
+            group = logger.uiWorkboxTAB.tabText(index)
+            group_widget = logger.uiWorkboxTAB.currentWidget()
+            index = group_widget.currentIndex()
+            name = group_widget.tabText(index)
+            return WorkboxName(group, name)
+
+        # Otherwise resolve from the parent widgets.
+        # Get the parent QTabWidget of the workbox
+        workbox_tab_widget = tab_widget_for_tab(workbox)
+        if not workbox_tab_widget:
+            return None
+        # Get the group QTabWidget of the parent QTabWidget of the workbox
+        group_widget = tab_widget_for_tab(workbox_tab_widget)
+        if not group_widget:
+            return None
+
+        # Get the group name
+        index = group_widget.indexOf(workbox_tab_widget)
+        group = group_widget.tabText(index)
+
+        index = workbox_tab_widget.indexOf(workbox)
+        name = workbox_tab_widget.tabText(index)
+        return WorkboxName(group, name)
 
     @classmethod
     def workbox_for_name(cls, name, show=False, visible=False):
@@ -699,10 +760,6 @@ class LoggerWindow(Window):
         else:
             super(LoggerWindow, self).keyPressEvent(event)
 
-    def pathsAboutToBeCleared(self):
-        if self.uiClearLogOnRefreshACT.isChecked():
-            self.clearLog()
-
     def clearExecutionTime(self):
         """Update status text with hyphens to indicate execution has begun."""
         self.setStatusText('Exec: -.- Seconds')
@@ -734,7 +791,6 @@ class LoggerWindow(Window):
                 'spellCheckEnabled': self.uiSpellCheckEnabledACT.isChecked(),
                 'wordWrap': self.uiWordWrapACT.isChecked(),
                 'clearBeforeRunning': self.uiClearBeforeRunningACT.isChecked(),
-                'clearBeforeEnvRefresh': self.uiClearLogOnRefreshACT.isChecked(),
                 'uiSelectTextACT': self.uiSelectTextACT.isChecked(),
                 'toolbarStates': six.text_type(self.saveState().toHex(), 'utf-8'),
                 'consoleFont': self.console().font().toString(),
@@ -773,6 +829,13 @@ class LoggerWindow(Window):
 
         pref['editor_cls'] = self.editor_cls_name
 
+        # Allow any plugins to add their own preferences dictionary
+        pref["plugins"] = {}
+        for name, plugin in self.plugins.items():
+            plugin_pref = plugin.record_prefs(name)
+            if plugin_pref:
+                pref["plugins"][name] = plugin_pref
+
         self.save_prefs(pref)
 
     def load_prefs(self):
@@ -893,7 +956,6 @@ class LoggerWindow(Window):
         self.uiWordWrapACT.setChecked(pref.get('wordWrap', True))
         self.setWordWrap(self.uiWordWrapACT.isChecked())
         self.uiClearBeforeRunningACT.setChecked(pref.get('clearBeforeRunning', False))
-        self.uiClearLogOnRefreshACT.setChecked(pref.get('clearBeforeEnvRefresh', False))
         self.setClearBeforeRunning(self.uiClearBeforeRunningACT.isChecked())
         self.uiSelectTextACT.setChecked(pref.get('uiSelectTextACT', True))
 
@@ -924,6 +986,10 @@ class LoggerWindow(Window):
 
         self.dont_ask_again = pref.get('dont_ask_again', [])
 
+        # Allow any plugins to restore their own preferences
+        for name, plugin in self.plugins.items():
+            plugin.restore_prefs(name, pref.get("plugins", {}).get(name))
+
     def restoreToolbars(self, pref=None):
         if pref is None:
             pref = self.load_prefs()

preditor/gui/ui/loggerwindow.ui

@@ -92,7 +92,7 @@
      <x>0</x>
      <y>0</y>
      <width>796</width>
-     <height>29</height>
+     <height>21</height>
     </rect>
    </property>
    <widget class="QMenu" name="uiDebugMENU">
@@ -105,7 +105,7 @@
     <addaction name="uiLogToFileACT"/>
     <addaction name="uiLogToFileClearACT"/>
    </widget>
-   <widget class="QMenu" name="uiScriptingMENU">
+   <widget class="QMenu" name="uiFileMENU">
     <property name="title">
      <string comment="File Menu">&amp;File</string>
     </property>
@@ -120,19 +120,19 @@
     <property name="title">
      <string>Help</string>
     </property>
-    <widget class="QMenu" name="menuPreferences">
+    <widget class="QMenu" name="uiPreferencesMENU">
      <property name="title">
       <string>Preferences</string>
      </property>
      <addaction name="uiBrowsePreferencesACT"/>
      <addaction name="uiBackupPreferencesACT"/>
     </widget>
-    <addaction name="menuPreferences"/>
+    <addaction name="uiPreferencesMENU"/>
     <addaction name="uiEnvironmentVarsACT"/>
     <addaction name="separator"/>
     <addaction name="uiAboutPreditorACT"/>
    </widget>
-   <widget class="QMenu" name="menu_Run">
+   <widget class="QMenu" name="uiRunMENU">
     <property name="title">
      <string>Run</string>
     </property>
@@ -144,7 +144,7 @@
     <addaction name="uiClearToLastPromptACT"/>
     <addaction name="uiSelectTextACT"/>
    </widget>
-   <widget class="QMenu" name="uiFileMENU">
+   <widget class="QMenu" name="uiOptionsMENU">
     <property name="title">
      <string>&amp;Options</string>
     </property>
@@ -178,7 +178,6 @@
     <addaction name="uiHighlightExactCompletionACT"/>
     <addaction name="separator"/>
     <addaction name="uiClearLogACT"/>
-    <addaction name="uiClearLogOnRefreshACT"/>
     <addaction name="separator"/>
     <addaction name="uiSelectFontsMENU"/>
     <addaction name="uiStyleMENU"/>
@@ -197,11 +196,11 @@
     <addaction name="uiSetPreferredTextEditorPathACT"/>
     <addaction name="uiSetWorkboxEditorACT"/>
    </widget>
-   <widget class="QMenu" name="menuEdit">
+   <widget class="QMenu" name="uiEditMENU">
     <property name="title">
      <string>Edit</string>
     </property>
-    <widget class="QMenu" name="menuFocus_to_Group">
+    <widget class="QMenu" name="uiFocus_to_GroupMENU">
      <property name="title">
       <string>Focus to Group</string>
      </property>
@@ -216,7 +215,7 @@
      <addaction name="separator"/>
      <addaction name="uiGroupLastACT"/>
     </widget>
-    <widget class="QMenu" name="menuFocus_to_Tab">
+    <widget class="QMenu" name="uiFocus_to_TabMENU">
      <property name="title">
       <string>Focus to Tab</string>
      </property>
@@ -316,17 +315,17 @@
     <addaction name="uiNextTabACT"/>
     <addaction name="uiPrevTabACT"/>
     <addaction name="separator"/>
-    <addaction name="menuFocus_to_Group"/>
-    <addaction name="menuFocus_to_Tab"/>
+    <addaction name="uiFocus_to_GroupMENU"/>
+    <addaction name="uiFocus_to_TabMENU"/>
     <addaction name="separator"/>
     <addaction name="uiFindInWorkboxesACT"/>
     <addaction name="uiFocusNameACT"/>
    </widget>
-   <addaction name="uiScriptingMENU"/>
-   <addaction name="menuEdit"/>
-   <addaction name="uiDebugMENU"/>
-   <addaction name="menu_Run"/>
    <addaction name="uiFileMENU"/>
+   <addaction name="uiEditMENU"/>
+   <addaction name="uiDebugMENU"/>
+   <addaction name="uiRunMENU"/>
+   <addaction name="uiOptionsMENU"/>
    <addaction name="uiHelpMENU"/>
   </widget>
   <widget class="QToolBar" name="uiConsoleTOOLBAR">
@@ -507,14 +506,6 @@
     <string>Editor Vertical</string>
    </property>
   </action>
-  <action name="uiClearLogOnRefreshACT">
-   <property name="checkable">
-    <bool>true</bool>
-   </property>
-   <property name="text">
-    <string>Clear Log on Environment Refresh</string>
-   </property>
-  </action>
   <action name="uiClearToLastPromptACT">
    <property name="text">
     <string>Clear to Last Prompt</string>

preditor/gui/window.py

@@ -3,7 +3,7 @@ from __future__ import absolute_import
 from Qt.QtCore import Qt
 from Qt.QtWidgets import QMainWindow
 
-from .. import core, relativePath, root_window
+from .. import relativePath, root_window
 
 
 class Window(QMainWindow):
@@ -26,9 +26,6 @@ class Window(QMainWindow):
             cls._instance = cls(parent=parent)
             # protect the memory
             cls._instance.setAttribute(Qt.WA_DeleteOnClose, False)
-            # but make sure that if we reload the environment, everything gets deleted
-            # properly
-            core.aboutToClearPaths.connect(cls._instance.shutdown)
         return cls._instance
 
     def __init__(self, parent=None, flags=0):
@@ -74,9 +71,6 @@ class Window(QMainWindow):
         # If this value is set to False calling setGeometry on this window will not
         # adjust the geometry to ensure the window is on a valid screen.
         self.checkScreenGeo = True
-        # If this value is set to True the window will listen for
-        # preditor.core.aboutToClearPaths and call shutdown on the window.
-        self.aboutToClearPathsEnabled = True
         # attempt to set the dialog icon
         import os
         import sys
@@ -122,13 +116,6 @@ class Window(QMainWindow):
 
             WinWidget.uncache(wwidget)
 
-        # only disconnect here if deleting on close
-        if self.aboutToClearPathsEnabled and self.testAttribute(Qt.WA_DeleteOnClose):
-            try:
-                core.aboutToClearPaths.disconnect(self.shutdown)
-            except TypeError:
-                pass
-
     def setGeometry(self, *args):
         """
         Sets the window's geometry, It will also check if the geometry is visible on any
@@ -141,13 +128,6 @@ class Window(QMainWindow):
 
             ensureWindowIsVisible(self)
 
-    def showEvent(self, event):
-        # listen for aboutToClearPaths signal if requested
-        # but only connect here if deleting on close
-        if self.aboutToClearPathsEnabled and self.testAttribute(Qt.WA_DeleteOnClose):
-            core.aboutToClearPaths.connect(self.shutdown)
-        super(Window, self).showEvent(event)
-
     def shutdown(self):
         # use a @classmethod to make inheritance magically work
         self._shutdown(self)
@@ -161,8 +141,6 @@ class Window(QMainWindow):
         # allow the global instance to be cleared
         if this == cls._instance:
             cls._instance = None
-            if this.aboutToClearPathsEnabled:
-                core.aboutToClearPaths.disconnect(this.shutdown)
             this.setAttribute(Qt.WA_DeleteOnClose, True)
         try:
             this.close()

preditor/plugins.py

@@ -9,7 +9,7 @@ if six.PY3:
 else:
     import pkg_resources
 
-logger = logging.getLogger(__name__)
+_logger = logging.getLogger(__name__)
 
 
 class Plugins(object):
@@ -18,7 +18,7 @@ class Plugins(object):
         for ep in self.iterator("preditor.plug.about_module"):
             name = ep.name
             if name in plugs:
-                logger.warning(
+                _logger.warning(
                     'Duplicate "preditor.plug.about_module" plugin found with '
                     'name "{}"'.format(name)
                 )
@@ -35,6 +35,44 @@ class Plugins(object):
 
             yield name, result
 
+    def add_logging_handler(self, logger, handler_cls, *args, **kwargs):
+        """Add a logging handler to a logger if not already installed.
+
+        Checks for an existing handler on logger for the specific class(does not
+        use isinstance). If not then it will create an instance of the handler
+        and add it to the logger.
+
+        Args:
+            logger (logging.RootLogger): The logger instance to add the handler.
+            handler_cls (logging.Handler or str): If a string is passed it will
+                use `self.logging_handlers` to get the class. If not found then
+                exits with success marked as False. Other values are treated as
+                the handler class to add to the logger.
+            *args: Passed to the handler_cls if a new instance is created.
+            **kargs: Passed to the handler_cls if a new instance is created.
+
+        Returns:
+            logging.Handler or None: The handler instance that was added, already
+                has been added, or None if the handler name isn't a valid plugin.
+            bool: True only if the handler_cls was not already added to this logger.
+        """
+        if isinstance(handler_cls, str):
+            handlers = dict(self.logging_handlers(handler_cls))
+            if not handlers:
+                # No handler to add for this name
+                return None, False
+            handler_cls = handlers[handler_cls]
+
+        # Attempt to find an existing handler instance and return it
+        for h in logger.handlers:
+            if type(h) is handler_cls:
+                return h, False
+
+        # No handler installed create and install it
+        handler = handler_cls(*args, **kwargs)
+        logger.addHandler(handler)
+        return handler, True
+
     def editor(self, name):
         for plug_name, ep in self.editors(name):
             return plug_name, ep.load()
@@ -50,6 +88,20 @@ class Plugins(object):
         for ep in self.iterator(group="preditor.plug.initialize"):
             yield ep.load()
 
+    def loggerwindow(self, name=None):
+        """Returns instances of "preditor.plug.loggerwindow" plugins.
+
+        These plugins are used by the LoggerWindow to extend its interface. For
+        example it can be used to add a toolbar or update the menus.
+
+        When using this plugin, make sure the returned class is a subclass of
+        `preditor.gui.logger_window_plugin.LoggerWindowPlugin`.
+        """
+        for ep in self.iterator(group="preditor.plug.loggerwindow"):
+            if name and ep.name != name:
+                continue
+            yield ep.name, ep.load()
+
     def logging_handlers(self, name=None):
         for ep in self.iterator(group="preditor.plug.logging_handlers"):
             yield ep.name, ep.load()

preditor/version.py

@@ -1,5 +1,5 @@
 # coding: utf-8
 # file generated by setuptools_scm
 # don't change, don't track in version control
-version = '0.8.0'
-version_tuple = (0, 8, 0)
+version = '0.10.0'
+version_tuple = (0, 10, 0)

{preditor-0.8.0.dist-info → preditor-0.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PrEditor
-Version: 0.8.0
+Version: 0.10.0
 Summary: A python REPL and Editor and console based on Qt.
 Home-page: https://github.com/blurstudio/PrEditor.git
 Author: Blur Studio
@@ -208,6 +208,11 @@ added in [setup.cfg](setup.cfg).
 implementing a workbox. See [workbox_mixin.py](preditor/gui/workbox_mixin.py)
 for the full interface to implement all features of an editor.
 
+* `preditor.plug.loggerwindow`: Used to customize the LoggerWindow instance when
+the LoggerWindow is created. For example, this can be used to create extra Toolbars
+or add menu items. When using this plugin, make sure to use the
+`preditor.gui.logger_window_plugin.LoggerWindowPlugin` class for your base class.
+
 * `preditor.plug.logging_handlers`: Used to add custom python logging handlers
 to the LoggingLevelButton's handlers sub-menus. This allows you to install a
 handler instance on a specific logging object.

{preditor-0.8.0.dist-info → preditor-0.10.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-preditor/__init__.py,sha256=MDcjs6rNu92NDVu-fH3sZWgLtVKnWqDojREeIFU6fII,10735
+preditor/__init__.py,sha256=KYyR_3eeQBYqbl4pq6H0u7MnRquGJYfAXV5cSBOEufI,12732
 preditor/__main__.py,sha256=boRVSmxX6eF8EkzbePtCZbzdcaPseqVae4RPPLp3U1A,449
 preditor/about_module.py,sha256=KIvCxZrMLhm5TR6lYskM4Y9VctJ0QtSQD5Nu8Ip1CGY,5267
 preditor/cli.py,sha256=kyVr0V43KYSMLIEWXH54CA0ByFmPcpbFF-8cli6PVow,5300
@@ -7,43 +7,44 @@ preditor/debug.py,sha256=xcOslCByK7nSebh5DR6m-uC6uV9tuJBZu-JAAPBl8aA,9515
 preditor/enum.py,sha256=snG5V259dH9SI1kwBqZeZdhat36F1iAmIjYErosnDUg,23489
 preditor/logging_config.py,sha256=aCqBhnHhcTigpR7neVEPbx4Vc_3ADpiqaBQ7uOd4qRQ,1462
 preditor/osystem.py,sha256=vRr-WaIzYEO38tJeyHMOlAyrvGaWGBuiyaPx0X9JfZ4,13682
-preditor/plugins.py,sha256=W3DfdDEE5DtEXOXioEyIe4tuIVV1V-RLcV8LoZJWpWU,1916
+preditor/plugins.py,sha256=ELajZq_ArzZPMvURpwZuLpsURF5vWrL22dLwx0rO3nA,4275
 preditor/prefs.py,sha256=BPtSsdv2yuiRpIaqEml9fxlVYKHNfqQ77hp5YIQRDBg,2172
 preditor/settings.py,sha256=DV9_DbJorEnhdIvW15E7h7PswlQUsy0UlA8bXUYN0og,2206
 preditor/streamhandler_helper.py,sha256=kiU6T9WqJ3JKTTKCa7IUU8brwK7zO5UUpEzLhEfKe44,1788
-preditor/version.py,sha256=34zfsmFU3IpCforo9xUCL1BD7vTjh-viyz-BJYB3xL0,142
+preditor/version.py,sha256=rzq_luIbsfGvc5ytSRmGNkTTF5-zasKa-TxMl3t2XTg,144
 preditor/weakref.py,sha256=b--KomFAHcMWr3DEAIN2j3XxRhjDWKw0WABXyn1nxDg,12177
 preditor/cores/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-preditor/cores/core.py,sha256=ZXB4bts05DMQtc-dtkk81chIWNqYXImMuWCYuUHwLdA,2389
+preditor/cores/core.py,sha256=JNcW4Xx9OM-fuAhCLIunu3v501yM9rniia7P7SUyCfM,2127
 preditor/dccs/maya/PrEditor_maya.mod,sha256=XTZsiqpSj7AjiB0SOZJct06mk1cLivV7sWIZmg1HoFo,46
 preditor/dccs/maya/plug-ins/PrEditor_maya.py,sha256=7D5MZb9c0-5Nfz4JVG4X2GecQJWUHE7XEtVZuKH_kWM,3855
 preditor/delayable_engine/__init__.py,sha256=7GNnc2996zCzBtkB3U9Ic0EcXToVYrlewSMq8hlWNl0,11491
 preditor/delayable_engine/delayables.py,sha256=GWxv4iTcqFeo7703SMrtotKx4cfq1ujJMNdpmtawPqc,2708
-preditor/gui/__init__.py,sha256=vie2aDVpGjrDYxK1H2pTVIgFjIk6B8nNf6rWNwCVJ3Y,3132
+preditor/gui/__init__.py,sha256=DeOH5K4_M0YLNx1i7NRvwCgwjyjkre4vVwlr5OEMx9Q,3423
 preditor/gui/app.py,sha256=RRiaDpUdWYoVkCFThMfsSSFG63jRt7LKx2QOx8lSdK4,5810
 preditor/gui/codehighlighter.py,sha256=3JxXZpZqN3KVZbQgSmO-JldSlf4zFQ0PojWwucTsy5U,7171
 preditor/gui/completer.py,sha256=T6fl_4xGVjVtGNuR6ajD1ngjEhrKR6tZ9zPJDYoKn8E,7379
 preditor/gui/console.py,sha256=qjr1OtAQ0dAUv4_u_j3Tz8XGRMwkdBAw3JYt46FzlwI,34876
-preditor/gui/dialog.py,sha256=Vw8Wflb2P3TngO8b-2suWP6JKHBVHdbGgYiRDKzYRlQ,7488
+preditor/gui/dialog.py,sha256=dsB0wdrb8i5OuAMh19QvDajuJqUDmQADR1JFrxfivug,6411
 preditor/gui/drag_tab_bar.py,sha256=5J-BSKQzS6_WuYxxGqmnUJr6AriTAvwfVK7Q3p7knrM,7933
 preditor/gui/editor_chooser.py,sha256=lv1eY0UJOulX1l-P-ZQEoneYz6BNX2VkXEbg3GUu1ag,1991
 preditor/gui/errordialog.py,sha256=Re-rc4r24bwfUL3YkZGELNhAJD9B220xznbDcXC6EEg,3234
 preditor/gui/find_files.py,sha256=8_b0oQgL6u8U2FqpR2RzMChME9eYdJq3c3bgXXDeceY,4241
-preditor/gui/level_buttons.py,sha256=yPFIWKc0bgKLrP2XHyBqNuvvTnXZqGdtN_p27jSb1Og,11925
-preditor/gui/logger_window_handler.py,sha256=VTNhaoFUnConE3NHj9KaDZlVoifix8xCbCuN5Ozjz0M,1482
-preditor/gui/loggerwindow.py,sha256=zOIzq12ffLF0xp3oChP0bc7KB_4BJ8kK5Oy0gQSGRuI,51303
+preditor/gui/level_buttons.py,sha256=S7JLsK1-Nu9PLOg7WACOU-Ch41PSCiZ2r-xcnajlPwY,11850
+preditor/gui/logger_window_handler.py,sha256=43-DxzuNJq6UV6Ofc4TKRt179Sf5AxDkVDGrtq_Knok,1571
+preditor/gui/logger_window_plugin.py,sha256=x6mTuS6gmeMZtV0UIXHXIif1_B5oKVbJhuIBaW0BFVs,1210
+preditor/gui/loggerwindow.py,sha256=9ziaO1RrekKh8wVt6jkax29ehbFesaO9OJBI2JkkGGU,53544
 preditor/gui/newtabwidget.py,sha256=5aCWn9xAl5h1oZACqVuEsOAbzKTS2RegrLI41gROC8A,1971
 preditor/gui/redmine_login_dialog.py,sha256=cMPBuecSZD5yjycNkMwHa1AbdwgGoyHvX8anIvWjEFo,1893
 preditor/gui/set_text_editor_path_dialog.py,sha256=bTrYM0nU-pE2m8LIpeAUlmvP257wrcAvEdaoOURw9p8,2264
 preditor/gui/status_label.py,sha256=SlNRmPc28S4E2OFVmErv0DmZstk4011Q_7uLp43SF0A,3320
 preditor/gui/suggest_path_quotes_dialog.py,sha256=QUJf_9hs8wOO6bFOr8_Z2xnNhSA8TfKFMOzheUqUDnY,1822
-preditor/gui/window.py,sha256=bZAEKQDM6V4aew1nlSTPyq_tG-_IoSvyXHcZxrdFMaE,6924
+preditor/gui/window.py,sha256=IrOAuxRiZcrOdUT4kcVa9s6ES-jpPw-RmG09nZS_56k,5838
 preditor/gui/workbox_mixin.py,sha256=kUVHtK-flyux3PZ9GkOYnjCJMLRcZESFJXipsgNgI0U,13851
 preditor/gui/workbox_text_edit.py,sha256=B_xObwwobKzpMuTmwkczTGW9cOem2oF8pZDezCqwPCo,4385
 preditor/gui/workboxwidget.py,sha256=BDmV3tu5HaZPTpc_h8UtiAag-w7pEKUBNSkqAIz_7IU,10056
 preditor/gui/fuzzy_search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 preditor/gui/fuzzy_search/fuzzy_search.py,sha256=6npanW6aLmG_ezdHmpsKN7p2zwck_Qq6YUy9duCNN8Q,3595
-preditor/gui/group_tab_widget/__init__.py,sha256=rUvlURDiq2nncgEcGv5LvUNUVl3uLqJ_j4lQtZ8fMQE,12568
+preditor/gui/group_tab_widget/__init__.py,sha256=H1Bzfb6eQpcjYr72zQxWC371-tPeAcK6vSvQpregPWQ,12989
 preditor/gui/group_tab_widget/grouped_tab_menu.py,sha256=lopd3mjHJIE_5xLdlZL0ghuBzsYo36vO1OZE6L6tqbI,1288
 preditor/gui/group_tab_widget/grouped_tab_models.py,sha256=zlmbcv3JAC5BzjKpm4CM7Hobibm1T_3GjaPoWIQbXiQ,3970
 preditor/gui/group_tab_widget/grouped_tab_widget.py,sha256=Z08LE8-ABakpM5Lk8cnntfjtdsmoR_T2ycgSEor7iY0,2928
@@ -51,7 +52,7 @@ preditor/gui/group_tab_widget/one_tab_widget.py,sha256=PdZAXjmV9oTHakh8aFYRlLnfw
 preditor/gui/ui/editor_chooser.ui,sha256=cYSVHK0A4-zst6JyDkrBZK9qcAontbhV4Mmnw5ps72E,2736
 preditor/gui/ui/errordialog.ui,sha256=H1wJJVU1t7kbnYkzGtGa8SBVpKjesJG_0imdBkJaEUY,2034
 preditor/gui/ui/find_files.ui,sha256=8mdD3Vg3ofRMChdKntxiDHO3JXHQSKjjY6OLY_1W5lc,3328
-preditor/gui/ui/loggerwindow.ui,sha256=IGoeWPDI4Qym01mTkUR49MDhxpZBWYRHr7s746WfYkw,31528
+preditor/gui/ui/loggerwindow.ui,sha256=r3L46h3YNLiQ1dPvWY24D5Zqrd2X2x5Zs6jMjDTDDyg,31279
 preditor/gui/ui/redmine_login_dialog.ui,sha256=PmGuJWvBcSDLya5UblFj5brwDH9VL2fJEveH-r5-nJ8,2911
 preditor/gui/ui/set_text_editor_path_dialog.ui,sha256=VLBpTvGneXAi9RX1dRd6oPwKoZhQ_m5HO1j1qXPhTxc,5201
 preditor/gui/ui/suggest_path_quotes_dialog.ui,sha256=0hcr7kEFmmMVEp7vv18mDpvWZ0zOrojlkTLhIWCFKww,5923
@@ -149,9 +150,9 @@ preditor/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 preditor/utils/cute.py,sha256=LfF8gXMAkkQAdo4mm6J9aVkDLwWZbE6prQ0moDbtCys,1045
 preditor/utils/stylesheets.py,sha256=EVWZNq3WnaRiyUPoYMKQo_dLEwbRyKu26b03I1JDA-s,1622
 preditor/utils/text_search.py,sha256=21kuSDTpLIPUcriB81WP1kWfzuDBuP13ZtHUtypP5jE,14218
-preditor-0.8.0.dist-info/licenses/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
-preditor-0.8.0.dist-info/METADATA,sha256=o2K-bjOLQeGKMgba1b9UzwiUOIHVoA5JAdVdrwlMuNk,9278
-preditor-0.8.0.dist-info/WHEEL,sha256=egKm5cKfE6OqlHwodY8Jjp4yqZDBXgsj09UsV5ojd_U,109
-preditor-0.8.0.dist-info/entry_points.txt,sha256=mpe0HFD_oIEBNPTJNyUEbmMV6Ivrp4EuYyZ34C5d_PU,519
-preditor-0.8.0.dist-info/top_level.txt,sha256=iX1_mrUOky_BQr2oG0l_MbEUYF6idyjiWSzu9z3irIw,9
-preditor-0.8.0.dist-info/RECORD,,
+preditor-0.10.0.dist-info/licenses/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
+preditor-0.10.0.dist-info/METADATA,sha256=aHAm056AxKt_YCBxaBGQBj56-UNN5mAD2zpX--hu_5E,9591
+preditor-0.10.0.dist-info/WHEEL,sha256=JNWh1Fm1UdwIQV075glCn4MVuCRs0sotJIq-J6rbxCU,109
+preditor-0.10.0.dist-info/entry_points.txt,sha256=mpe0HFD_oIEBNPTJNyUEbmMV6Ivrp4EuYyZ34C5d_PU,519
+preditor-0.10.0.dist-info/top_level.txt,sha256=iX1_mrUOky_BQr2oG0l_MbEUYF6idyjiWSzu9z3irIw,9
+preditor-0.10.0.dist-info/RECORD,,

{preditor-0.8.0.dist-info → preditor-0.10.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py2-none-any
 Tag: py3-none-any