Dazzler
Dazzler is a Python async UI/Web framework built with aiohttp and react. Create dazzling fast pages with a layout of Python components and bindings to update from the backend.
Install
Install with pip: $ pip install dazzler
Features
- Fast WebSocket based communication, deliver updates in realtime to thousands of connected clients at once.
- Lightweight bundles for fast initial page load.
- Support for third party integrations via middlewares.
- Session & authentication systems.
- No HTML/CSS/JS knowledge required, write everything with Python.
- Multi-page based.
- Hot reload.
- Tons of components.
- Tie & Transform API to perform updates on the client side.
- Build desktop applications with Electron.
Quickstart
Quickstart with a GitHub template
Basic example
Create a page with a layout and assign bindings to save & load a visitor name with the session system. The button to save the visitor name is disabled if no input value via tie & transform.
from dazzler import Dazzler
from dazzler.system import Page, BindingContext, transforms as t
from dazzler.components import core
app = Dazzler(__name__)
page = Page(
__name__,
core.Container([
core.Html('H2', 'My dazzler page'),
core.Container('Please enter a name', identity='visitor-name'),
core.Input(value='', identity='input'),
core.Button('Save name', identity='save-btn', disabled=True),
], identity='layout', id='layout'),
title='My Page',
url='/'
)
# UI updates via tie & transforms
page.tie('[email protected]', '[email protected]').transform(
t.Length().t(t.Lesser(1))
)
# Bindings executes on the server via websockets.
@page.bind('[email protected]')
async def on_click(context: BindingContext):
# Save the visitor name via session system
name = await context.get_aspect('input', 'value')
await context.session.set('visitor', name)
await context.set_aspect(
'visitor-name', children=f'Saved {name}'
)
# Aspects defined on the layout trigger on initial render and
# allows to insert initial data.
@page.bind('[email protected]')
async def on_layout(context: BindingContext):
visitor = await context.session.get('visitor')
if visitor:
await context.set_aspect(
'visitor-name', children=f'Welcome back {visitor}!'
)
app.add_page(page)
if __name__ == '__main__':
app.start()
Documentation
Full documentation hosted on readthedocs.
Get help for the command line tools: $ dazzler --help
796 Dec 26, 2022
1.9k Jan 04, 2023
64 Jul 21, 2022
19 Dec 02, 2022
24.7k Jan 03, 2023
8 Dec 07, 2021
4.3k Dec 30, 2022
1 Jan 04, 2022
16 Dec 15, 2022
119 Dec 27, 2022
526 Jan 02, 2023
4.3k Dec 31, 2022
4k Jan 08, 2023
13 Aug 31, 2022
3 Jun 13, 2022
30 Mar 05, 2022
980 Nov 28, 2022
78 Apr 15, 2022
32 Dec 24, 2022
32 Dec 14, 2022