Description

pysubqt is a wrapper-library built on top of PyQt5.

pyqsubqt provides a simple declarative language to rapidly develop a simple graphical user interface application in python.

Examples

Blank Window

main.psqt

Use Controls

Def Window : Widget
    Title: "Hello, world!"
End

main.py

from pysubqt import Engine


class Bridge:
    def __init__(self):
        self.ui = None


e = Engine()
e.load_file("main.psqt")
e.run(Bridge)

result:

Showing a label

test.psqt

Use Controls
Use Layouts

Def Window : Widget
    Title: "Hello, world!"
    Size: 640 480   # set the default window size

    Def CenterLayout : VLayout
        Alignment: Center   # make the layout center aligned

        Def MyLabel : Label
            Text: "Hello, Mother!"
            Font: "JetBrains Mono" 35   # set the font and the size (in pt)
        End
    End
End

result:

Connecting a button to a python function

main.psqt

Use Controls
Use Layouts

Def Window : Widget
    Title: "Hello, world!"

    Def MainLayout : HLayout
        Def Btn : Button
            FixedSize: 300 100
            Text: "Click me!"
            Font: "Segoe UI" 25
            clicked.connect: Bridge.onClicked
        End
    End
End

main.py

from pysubqt import Engine


class Bridge:
    def __init__(self):
        self.ui = None
        self.x = 0

    def onClicked(self):
        self.x += 1
        self.ui.Btn.setText(str(self.x))


e = Engine()
e.load_file("main.psqt")
e.run(Bridge)

result:

The number on the button will increment by one everytime you click it.

Language Reference

As you can see in the previous examples that every widgets are defined with the Def keyword and then ended with the End keyword.

To define a widget, you have to use the Def keyword in the following format:

Def WidgetName : WidgetType

example:

Def MyLabel : Label

Note that the widget name doesn't have to be in PascalCase.

So far, there's only 11 pre-defined widget types in pysubqt: