PrEditor 0.9.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:
-        set_parent_callback(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():
@@ -239,29 +262,6 @@ def parent_callback():
     return _global_config.get("parent_callback")
 
 
-def set_parent_callback(parent_callback, if_unset=True):
-    """Update the parent_callback even if it was already set.
-
-    This is useful for cases where `configure` is called before it's possible to
-    provide the parent_callback.
-
-    Note: Changing this does not re-parent an existing instance of LoggerWindows.
-    If you change this after the LoggerWindow instance has been created you will
-    need to manually re-parent it.
-
-    Args:
-        if_unset(bool): If True then only set this value if the parent_callback
-            hasn't already been set.
-
-    Returns:
-        bool: Returns False if if_unset is True and it was already set.
-    """
-    if "parent_callback" in _global_config and not if_unset:
-        return False
-    _global_config["parent_callback"] = parent_callback
-    return True
-
-
 def connect_preditor(
     parent, sequence='F2', text='Show PrEditor', obj_name='uiShowPreditorACT', name=None
 ):

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.9.0'
-version_tuple = (0, 9, 0)
+version = '0.10.0'
+version_tuple = (0, 10, 0)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PrEditor
-Version: 0.9.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

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

@@ -1,4 +1,4 @@
-preditor/__init__.py,sha256=LGEa5WqdedxVmOm_MeQ2kFDs3xodaWnOMGA8hLubg5E,11843
+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
@@ -11,7 +11,7 @@ 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=OFbGax8ko2nIQ9RQvu77D8Lj3CgldGEFB97k9nRq6WA,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=JNcW4Xx9OM-fuAhCLIunu3v501yM9rniia7P7SUyCfM,2127
@@ -150,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.9.0.dist-info/licenses/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
-preditor-0.9.0.dist-info/METADATA,sha256=41tycEwN8Wb8SG1zchMUX81zQIRchAoLgO7Un2OIKF4,9590
-preditor-0.9.0.dist-info/WHEEL,sha256=JNWh1Fm1UdwIQV075glCn4MVuCRs0sotJIq-J6rbxCU,109
-preditor-0.9.0.dist-info/entry_points.txt,sha256=mpe0HFD_oIEBNPTJNyUEbmMV6Ivrp4EuYyZ34C5d_PU,519
-preditor-0.9.0.dist-info/top_level.txt,sha256=iX1_mrUOky_BQr2oG0l_MbEUYF6idyjiWSzu9z3irIw,9
-preditor-0.9.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,,