A Python package for creating and manipulating HTML components. It is working similar to React.js, but in Python
Project description
Seamless
Seamless is a Python package for creating and manipulating HTML components. It is working similar to React.js, but in Python.
Installation
pip install python-seamless
Usage
from seamless import Div, H1, P, Component, Style
class MyComponent(Component):
def render(self):
return Div(
H1(
"Hello, World!",
style=Style(
color="#33343c"
),
),
P(
"Welcome to Seamless!"
),
style=Style(
text_align="center"
)
)
from .components import MyComponent
from seamless.renderer import render
@app.get("/")
def hello_world():
return render(MyComponent())
Server actions
It's possible to pass a python function as component props.
The current version works with ASGIApp
.
class Person(Component):
def __init__(self, name: str, age: float):
self.age = age
self.name = name
def render(self):
return Form(
Div(f"Update the age for {name}"),
Label(
"Age: ",
html_for="age"
),
Input(
type="text",
on_change=self.set_age
),
Button(
"Submit Age",
type="submit"
),
on_submit=self.save_age
)
def set_age(self, event_data: ChangeEvent):
self.age = event_data.value
def save_age(self, event_data: SubmitEvent):
user = get_user()
user.age = self.age
save(user)
To call a function on the server include this script in your file
<script src="/socket.io/static/main.js"></script>
Import the middleware and mount it to your app
from fastapi import FastAPI
from seamless.middlewares import ASGIMiddleware as SeamlessMiddleware
app = FastAPI()
app.add_middleware(SeamlessMiddleware)
You can pass the following config to the middleware to change the socket path of all seamless endpoints.
app.add_middleware(
SeamlessMiddleware,
socket_path="/my/custom/path"
)
Actions use socket.io to communicate between server and client.
TODO
- Add detailed documentation
- Add more tests
- Add support for http actions
Contributing
Feel free to open an issue or a pull request.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for python_seamless-0.8.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91612405ee00ad98d04952eae6c042dd6653c31b4ab3676bb3d1dd813afb00f1 |
|
MD5 | a17ce20e86bb1a78343de807323fdeb4 |
|
BLAKE2b-256 | 74ac9f2e53b5171b9595dec37c5d4fe225121f60c60372353584c38a8831c534 |