uitk 0.6.8

uitk is a versatile package for managing user interfaces, widgets, and event handling in Python using PySide2. Using naming convention, the switchboard module provides a convenient way to load UI files, register custom widgets, manage slots and styles, and interact with widgets. It aims to simplify the development and management of complex user interfaces.

UITK

uitk is a versatile package for managing user interfaces, widgets, and event handling in Python using PySide2. Using naming convention, the switchboard module provides a convenient way to load UI files, register custom widgets, manage slots and styles, and interact with widgets. It aims to simplify the development and management of complex user interfaces.

Features

• Dynamically load UI files
• Register and use custom widgets
• Subclass the MainWindows with utility properties
• Initialize child widgets with utility properties
• Manages slot connections and event handling
• Supports UI heirarchy navigation and submenus
• Supports UI tags for custom event behavior.
• Store and retrieve UI and slot history
• Garbage collection protection for widgets

Design:

---

Module	Description
switchboard	Load dynamic UI, assign convenience properties, and handle slot connections.
events	Event handling for dynamic UI widgets.
stylesheet	Define stylesheet presets and have them auto applied to your UI on initialization.
widgets	A source directory for custom widgets.

---

Installation:

To install: Add the uitk folder to a directory on your python path, or install via pip in a command line window using:

python -m pip install uitk

Basic Example:

Create an instance of Switchboard to load and connect your dynamic ui.

from uitk import Switchboard

class MyProject():
    ...

class MySlots(MyProject):
    def __init__(self):
        self.sb = self.switchboard() #returns the switchboard instance.

    def MyButtonsObjectName(self):
        print("Button clicked!")


sb = Switchboard(slots_location=MySlots)
ui = sb.example #Get the UI using it's name (or sb.get_ui(<name>))

# Some of the UI properties:
print ('ui:'.ljust(20), sb.ui) #The current UI
print ('ui name:'.ljust(20), ui.name) #The UI's filename.
print ('ui path:'.ljust(20), ui.path) #The directory path containing the UI file
print ('ui tags:'.ljust(20), ui.tags) #Any UI tags as a list
print ('ui level:'.ljust(20), ui.level) #The UI level
print ('is current ui:'.ljust(20), ui.is_current) #True if the UI is set as current
print ('is submenu:'.ljust(20), ui.isSubmenu) #True if the UI is a submenu
print ('is connected:'.ljust(20), ui.is_connected) #True if the UI is connected to its slots
print ('is initialized:'.ljust(20), ui.is_initialized) #True after the UI is first shown
print ('slot:'.ljust(20), ui.MyButtonsObjectName.get_slot()) #The associated slot
print ('slots:'.ljust(20), ui.slots) #The associated slots class instance
print ('widget:'.ljust(20), ui.MyButtonsObjectName) #Get a widget from the UI by it's name
print ('widgets:'.ljust(20), [(w.name or w.type) for w in ui.widgets]) #All widgets of the UI

# There are also many helper methods that you can access through your switchboard instance:
print ('widget from slot:'.ljust(20), sb.get_widget_from_method(ui.MyButtonsObjectName.get_slot()))

ui.show(app_exec=True)

Advanced Example:

https://github.com/m3trik/tentacle