Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/daxexs/flet-easy
🔥User-friendly add-on package for Flet, offering a cleaner code structure with numerous customizable features like JWT, router, decorators, middleware and more.
https://github.com/daxexs/flet-easy
flet flet-easy flet-easy-fastapi flet-gui flet-jwt flet-middleware flet-route flet-routing flet-web flutter
Last synced: 7 days ago
JSON representation
🔥User-friendly add-on package for Flet, offering a cleaner code structure with numerous customizable features like JWT, router, decorators, middleware and more.
- Host: GitHub
- URL: https://github.com/daxexs/flet-easy
- Owner: Daxexs
- License: apache-2.0
- Created: 2024-01-10T22:00:10.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-12-21T18:08:06.000Z (15 days ago)
- Last Synced: 2024-12-29T15:06:02.699Z (7 days ago)
- Topics: flet, flet-easy, flet-easy-fastapi, flet-gui, flet-jwt, flet-middleware, flet-route, flet-routing, flet-web, flutter
- Language: Python
- Homepage: https://daxexs.github.io/flet-easy/
- Size: 18.6 MB
- Stars: 77
- Watchers: 6
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🔥Flet-Easy
[](https://github.com/Daxexs)[](https://pypi.org/project/flet-easy)
[](https://pypi.python.org/pypi/flet-easy) [](https://pypi.python.org/pypi/flet-easy) [](https://pypi.python.org/pypi/flet-easy) [](https://socket.dev/pypi/package/flet-easy) [](https://github.com/astral-sh/uv) [](https://github.com/astral-sh/ruff) [](https://pepy.tech/project/flet-easy)
`Flet-Easy` is a package built as an add-on for [`Flet`](https://github.com/flet-dev/flet), designed for beginners what it does is to make `Flet` easier when building your apps, with a tidier and simpler code.
## Features
* Easy to use (**hence the name**).
* Facilitates `flet` event handling.
* Simple page routing (There are three ways) for whichever one suits you best. ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/dynamic-routes/))
* App construction with numerous pages and custom flet configurations for desktop, mobile and web sites.
* Provides a better construction of your code, which can be scalable and easy to read (it adapts to your preferences, there are no limitations).
* Dynamic routing, customization in the routes for greater accuracy in sending data. ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/dynamic-routes/#custom-validation))
* Routing protection ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/customized-app/route-protection/))
* Custom Page 404 ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/customized-app/page-404/))
* Controlled data sharing between pages. ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/data-sharing-between-pages/))
* Asynchronous support.
* Middleware Support (in the app in general and in each of the pages). ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/middleware/))
* JWT support for authentication sessions in the data parameter. (useful to control the time of sessions) ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/basic-jwt/))
* Working with other applications. ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/data-sharing-between-pages/))
* CLI to create app structure `FletEasy` (`fs init`) ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/cli-to-create-app/))
* Easy integration of `on_keyboard_event` in each of the pages. ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/events/keyboard-event/))
* Use the percentage of the page width and height of the page with `on_resize`. ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/events/on-resize/))
* `ResponsiveControlsy` control to make the app responsive, useful for desktop applications. ([**`Docs`**](https://daxexs.github.io/flet-easy/0.2.0/responsiveControlsy/))
* Soporta Application Packaging para su distribución. ([view](https://flet.dev/docs/publish))
## 📌Flet events it handles
* `on_route_change` : Dynamic routing
* `on_view_pop`
* `on_keyboard_event`
* `on_resize`
* `on_error`
## 💻 Ways to install
## Ways to install
### Install Flet-Easy Complete
> [!NOTE]
> If you use the [`fs`](https://daxexs.github.io/flet-easy/0.2.0/cli-to-create-app/) cli, it is important to have [`git`](https://git-scm.com/downloads) installed.
Installs all the dependencies to use, you can use all the functionalities provided by FletEasy
```bash
pip install flet-easy[all]
```
---
### Install clean Flet-Easy
> [!TIP]
> [Recommended for `Flet` Packaging Application](https://flet.dev/docs/publish).
Requires installation of [Flet >= 0.25](https://github.com/flet-dev/flet).
```bash
pip install flet[all]
```
#### If you do not use: [CLI-to-create-app](https://daxexs.github.io/flet-easy/0.2.0/cli-to-create-app)
```bash
pip install flet-easy
```
---
#### Install FletEasy if you need to use [Basic-JWT](https://daxexs.github.io/flet-easy/0.2.0/basic-jwt)
```bash
pip install flet-easy[JWT]
```
---
## 💻Update
```bash
pip install flet-easy[all] --upgrade
```
## 🔥Flet-Easy app example
Here is an example of an application with 2 pages, "Home" and "Counter":
```python
import flet as ft
import flet_easy as fs
app = fs.FletEasy(route_init="/flet-easy")
# We add a page
@app.page(route="/flet-easy", title="Flet-Easy")
def index_page(data: fs.Datasy):
return ft.View(
controls=[
ft.Text("Home page"),
ft.FilledButton("Go to Counter", on_click=data.go("/counter")),
],
vertical_alignment="center",
horizontal_alignment="center",
)
# We add a second page
@app.page(route="/counter", title="Counter")
def counter_page(data: fs.Datasy):
page = data.page
txt_number = ft.TextField(value="0", text_align="right", width=100)
def minus_click(e):
txt_number.value = str(int(txt_number.value) - 1)
page.update()
def plus_click(e):
txt_number.value = str(int(txt_number.value) + 1)
page.update()
return ft.View(
controls=[
ft.Row(
[
ft.IconButton(ft.Icons.REMOVE, on_click=minus_click),
txt_number,
ft.IconButton(ft.Icons.ADD, on_click=plus_click),
],
alignment="center",
),
ft.FilledButton("Go to Home", on_click=data.go("/flet-easy")),
],
vertical_alignment="center",
horizontal_alignment="center",
)
# We run the application
app.run()
```
## 🎬 **Demo**
## 🚀 How to use `Flet-Easy`?
> [!IMPORTANT]
> 📑Documentation:
## 👀 Code examples
> [!TIP]
>
## 🔎 Contribute to this project
Read the [CONTRIBUTING.md](https://github.com/Daxexs/flet-easy/blob/main/CONTRIBUTING.md) file
## 🧾 License
[Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)