Desktop and Web GUI framework based on WebSockets
sofi is an OS agnostic UI module for Python.
The main idea is to allow rapid, pythonic GUI development using standard web-based widgets from
other common HTML5 libraries and package them in such a way that all event processing is done within python using
This was developed as an exercise in poking at the underlying technologies and to see what comes out of merging them together. For a better overview of why it came to be, feel free to take a look at this post: A Python Ate My GUI - Part 3: Implementation
We're in a beta stage for now, feedback appreciated.
sofi.app.Sofi object runs the main event thread with
.start() and provides a number of functions to help manipulate the state of the user interface, which is actually a webpage opened in a browser. The
unregister methods provide the mechanism for subscribing to events through callbacks, while the remaining functions (
style, etc.) wrap the commands intended to dynamically update the widgets (which are actual HTML elements).
The commands map directly to
jQuery methods present in the
sofi.js library that's loaded during initialization and is responsible for performing the requested operations.
Following basic practices from bootstrap, the widgets should be within a
Container. The base page itself is represented with the
View class, which wraps the necessary head, body and style tags that will contain the widgets.
Below is a quick idea of how to get things going, but check out
sample.py for a more complicated hello world which instantiates a navbar item, adds a few links, creates some buttons, registers events and performs some timed updates.
from sofi.app import Sofi from sofi.ui import Container, Paragraph, Heading, View import json import asyncio async def onload(event): # Every page is built on top of a View object, which contains the <head> and <body> tags that are filled in by the other objects v = View() # Make a bootstrap container in which to put all your widgets c = Container() # Add a heading and paragraph to the container c.addelement(Heading(2, "Dude!")) c.addelement(Paragraph("Where's My Car?")) # Add the container to the view v.addelement(c) # Tell the UI to load the HTML generated by the view app.load(str(v)) # Instantiate the application app = Sofi() # Register the event handler that runs when the UI is ready to receive commands app.register('init', onload) # Start the app (opens the default browser) and listen for events app.start()
What do the widgets look like?
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.