Live coding environment for Python, Qt and QML.
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin codestyle black Oct 31, 2018
docs add images Jun 10, 2018
example add support for PySide2 Sep 16, 2018
misc add raw icon Jun 10, 2018
src/livecoding codestyle black Oct 31, 2018
.gitignore implement module loading, better file handling, ... Jun 5, 2018
.travis.yml use correct version number Sep 16, 2018
MANIFEST.in fix install of non-Python-files Jun 10, 2018
README.md codestyle black Oct 31, 2018
setup.py push version number Oct 31, 2018

README.md

Live Coding Environment for Python, Qt and QML

PyPI version Build Status License: MIT Code style: black

Logo

This project provides a live coding environment for Python and Qt. It supports both PyQt and Qt for Python (PySide2) via the python_qt_binding.

Install

To install the live coding environment run:

python setup.py install

or install it via pip

pip install python-qt-live-coding

You also need to install PyQt or PySide2 for this application to work. The quickest way to achieve this is to use pip.

pip install PyQt5

or

pip install pyside2

Use

The live coding environment comes with a live runner which enables your to live code Qt GUIs quickly.

Run following to test drive the example:

python_qt_live_coding examples

Your will instantly see the example project in the live runner.

Live Runner Example

Now you can either select the MainScreen.qml file or type MainScreen in the filter.

When you type, the file will be automatically selected.

When loaded you will see following.

Live Runner Example

This is the example GUI inside the live runner.

Now press the Edit button. Your favorite text editor should open promptly.

Edit the code inside the editor und you will see the GUI updates instantly when you save the document.

Python QML module support

The live coding environment has built in support for Python QML modules.

The idea is to place QML and Python code in the same directory, similar to how you would create a Qt/C++ application. Additionally, with Python we have the advantage of being able to discover modules automatically.

For this purpose add register_qml_types function to the __init__.py of your Python QML module. See the example in example/module/__init__.py.

However, so far automatic reloading of Python code is not support. When you work on a Python module please use the Restart button which restarts the live coding application instead.

Forcing PyQt or Python for Qt (PySide2) usage

In some cases you might want to force which Python Qt binding python_qt_live_coding is using. This can be done by passing the optional --binding argument via the command line.

python_qt_live_coding -b pyside .

PyCharm Support

For this application to work with PyCharm and other IntelliJ IDEs please disable the "safe write" feature. The feature writes a temporary file before saving any file, which can confuse the file change watcher.