Metadata-Version: 2.1
Name: pyqtconsole
Version: 1.1.3
Summary: Light weight python interpreter, easy to embed into Qt applications
Home-page: https://github.com/marcus-oscarsson/pyqtconsole
Author: Marcus Oskarsson
Author-email: marcus.oscarsson@esrf.fr
License: MIT
Description: pyqtconsole
        ===========
        
        pyqtconsole is a light weight python console for Qt applications. Its made to
        be easy to embed in other Qt applications and comes with some examples that
        shows how this can be done. The interpreter can run in a separate thread, in
        the UI main thread or in a gevent task. There is also support for asyncio
        using trollius, however this is still in the experimental stage.
        
        Installing
        ~~~~~~~~~~
        
        Simply type::
        
            pip install pyqtconsole
        
        Or to install a development version from local checkout, type::
        
            pip install -e .
        
        Simple usage
        ~~~~~~~~~~~~
        
        See the ``examples`` directory for more examples:
        
        .. code-block:: python
        
            import sys
            from threading import Thread
            from PyQt5.QtWidgets import QApplication
        
            from pyqtconsole.console import PythonConsole
        
            app = QApplication([])
            console = PythonConsole()
            console.show()
            console.eval_in_thread()
        
            sys.exit(app.exec_())
        
        Embedding
        ~~~~~~~~~
        
        * *Separate thread* - Runs the interpreter in a separate thread, see the
          example threaded.py_. Running the interpreter in a separate thread obviously
          limits the interaction with the Qt application. The parts of Qt that needs
          to be called from the main thread will not work properly, but is excellent
          way for having a 'plain' python console in your Qt app.
        
        * *main thread* - Runs the interpreter in the main thread, see the example
          inuithread.py_. Makes full interaction with Qt possible, lenghty operations
          will of course freeze the UI (as any lenghty operation that is called from
          the main thread). This is a great alternative for people who does not want
          to use the gevent based approach but still wants full interactivity with Qt.
        
        * *gevent* - Runs the interpreter in a gevent task, see the example
          `_gevent.py`_. Allows for full interactivity with Qt without special
          consideration (at least to some extent) for longer running processes. The
          best method if you want to use pyQtgraph, Matplotlib, PyMca or similar.
        
        * *trollius (asyncio)* - Runs the interpreter in a asyncio coroutine
          `_trollius.py`_. Still experimental
        
        Credits
        ~~~~~~~
        
        The .qt sub module was taken from the pyQode_. And provides Qt4 and Qt5
        compatibility, the console is tested under both Qt4 and Qt5. The .qt sub
        module is included for easy distribution and to provide working examples for
        both versions 4 and 5 of Qt.
        
        
        .. _threaded.py: https://github.com/marcus-oscarsson/pyqtconsole/blob/master/examples/threaded.py
        .. _inuithread.py: https://github.com/marcus-oscarsson/pyqtconsole/blob/master/examples/inuithread.py
        .. _`_gevent.py`: https://github.com/marcus-oscarsson/pyqtconsole/blob/master/examples/_gevent.py
        .. _`_trollius.py`: https://github.com/marcus-oscarsson/pyqtconsole/blob/master/examples/_trollius.py
        .. _pyQode: https://github.com/pyQode/pyqode.qt
        
Keywords: interactive interpreter console shell autocompletion jedi qt
Platform: UNKNOWN
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Interpreters
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=2.7
Description-Content-Type: text/x-rst
Provides-Extra: autocomplete
