django-pyqt

This is a tool to help you develop desktop applications using Python Qt bindings of your choice for the 'front end' with django ORM for the backend.

Now also available as a VScode extension

Tested with PyQt5.11 and Django 2.1 on Ubuntu 18.4 and windows 10

Note that you need PyQt5 and Django to be already installed

---

Installation

Clone the repo then run:

*nix

sudo python3 setup.py

Windows

Open a cmd or a ps as admin and run python3 setup.py

Usage

Start new project using

pyqt-admin --startproject proj_name destination

Project Structure:

├── apps  -> where django apps go
├── forms -> where Qt *.ui files go
├── resources -> where Qt *.qrc files and assets(images, fonts, ...) go
├── viewManagers -> your views controllers go here
├── views -> where pyuic5 & pyrcc5 generated *.py files go
├── __main__.py -> start point for your application
├── manage.py
├── settings.py
├── config.json

---

Edit config.json to change the binding i.e (PyQt4, PyQt4, PySide or PySide2) PyQt5 by default.

set django to false to only use qt with the same commands.

Edit hidden-imports to add imports for pyinstaller

---

Django Commands

Create a new django app inside the apps directory

python3 manage.py startapp appname appname2

Add appName to INSTALLED_APPS in settings.py

INSTALLED_APPS = ["apps.appname",]

To prepare models migrations

python3 manage.py makemigrations [app1, app2, ...]

To migrate your models

python3 manage.py migrate [appname, appname2, ...]

Note that leaving apps blank will try to migrate all apps

To use other django manage.py commands

python3 manage.py command

---

Qt Commands

Convert *.ui files to .py files using uic command

python3 manage.py uic [file1.ui, file2.ui]

Note that leaving files blank will compile all UI files inside forms directory

Convert *.qrc files to .py files using rcc

python3 manage.py rcc [file1.ui, file2.ui]

Using Pyinstaller

python3 manage.py deploy

Start coding !

Now you can start using django (models, authentication, ... ) inside your application

---

Known Issues

• PyInstaller deployment is not fully implemented yet

TODO

• fix pyinstaller issues
• create a pip package