violit 0.0.2__py3-none-any.whl → 0.0.3__py3-none-any.whl

violit-0.0.3.dist-info/METADATA

@@ -0,0 +1,397 @@
+Metadata-Version: 2.4
+Name: violit
+Version: 0.0.3
+Summary: Violit: Faster than Light, Beautiful as Violet. The High-Performance Python Web Framework (Streamlit Alternative with Zero Rerun).
+Author-email: Violit Team <violit.company@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/violit-dev/violit
+Project-URL: Documentation, https://github.com/violit-dev/violit
+Project-URL: Repository, https://github.com/violit-dev/violit
+Project-URL: Issues, https://github.com/violit-dev/violit/issues
+Keywords: web,framework,streamlit,dashboard,ui,fastapi,reactive,zero-rerun,shoelace,websocket,data-science
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Framework :: FastAPI
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.68.0
+Requires-Dist: uvicorn>=0.15.0
+Requires-Dist: python-multipart>=0.0.5
+Requires-Dist: pywebview>=4.0.0
+Requires-Dist: cachetools>=4.2.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: plotly>=5.0.0
+Requires-Dist: matplotlib>=3.4.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: websockets>=10.0
+Requires-Dist: bcrypt>=4.0.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="./assets/violit_glare_small.png" alt="Violit™ Logo" width=80%>
+</p>
+
+
+# 💜 Violit
+
+> **"Faster than Light, Beautiful as Violet."**
+> **Structure of Streamlit × Performance of React**
+
+**Violit** is a next-generation Python web framework that adopts an **O(1) State Architecture** for instant reactivity, unlike Streamlit's **Full Script Rerun** structure.
+
+Build applications that react at the speed of light with the most elegant syntax.
+
+<p align="center">
+<img src="https://img.shields.io/pypi/v/violit?color=blueviolet&style=flat-square&ignore=cache" alt="PyPI">
+<img src="https://img.shields.io/badge/Python-3.10+-blue.svg?style=flat-square" alt="Python 3.10+">
+<img src="https://img.shields.io/badge/License-MIT-green.svg?style=flat-square" alt="MIT License">
+<img src="https://img.shields.io/badge/Framework-FastAPI-009688.svg?style=flat-square" alt="FastAPI">
+<img src="https://img.shields.io/badge/UI-Shoelace-7C4DFF.svg?style=flat-square" alt="Shoelace">
+</p>
+
+---
+
+## 📸 Demo
+
+*A dashboard built with Violit running in real-time.*
+
+<p align="center">
+  <img src="./assets/demo_show_main_small.gif" alt="Violit Showcase Demo" width=60%>
+</p>
+
+
+---
+
+## ⚡ Why Violit?
+
+### Architectural Differences
+
+Violit and Streamlit are similar in that they build UIs with Python code, but their internal mechanisms are fundamentally different.
+
+| Feature | Streamlit (Traditional) | **Violit (Reactive)** |
+| --- | --- | --- |
+| **Execution Model** | **Full Rerun (O(N))**<br>Reruns the entire script on every user interaction. | **Zero Rerun (O(1))**<br>Updates only the components connected to the modified State. |
+| **Performance** | Response speed may degrade as data size increases. | Maintains consistent reactivity regardless of data scale. |
+| **Optimization** | Requires optimization decorators like `@cache`, `@fragment`. | Optimized by design without extra optimization code. |
+| **Deployment** | Optimized for web browser execution. | Supports both Web Browser and **Desktop Native App** modes. |
+| **Design** | Focuses on providing basic UI. | Provides ready-to-use designs with **30+ professional themes**. |
+
+### Key Features
+
+1.  **Optimization by Design (Streamlit-Like Syntax, No Complexity)**:
+    Streamlit's intuitive syntax is maintained, but complex optimization tools are removed at the architecture level.
+    *   ❌ **No `@cache_data`, `@fragment`, `st.rerun`**: Thanks to the O(1) structure, manual optimization is unnecessary.
+    *   ❌ **No `key` Management**: No need to manually specify unique keys for widget state management.
+    *   ❌ **No Complex Callbacks**: No need to define complex callbacks/classes like Dash or Panel.
+
+2.  **Ultra-Fast Speed**: Even if you move the slider in 0.1s increments, the chart reacts in real-time without stuttering.
+
+3.  **Hybrid Runtime**:
+    *   **WebSocket Mode**: Ultra-low latency bidirectional communication (Default)
+    *   **Lite Mode**: HTTP-based, advantageous for handling large-scale concurrent connections
+
+4.  **Desktop Mode**: Can run as a perfect desktop application without Electron using the `--native` option.
+
+---
+
+## 🎨 Theme Gallery
+
+You don't need to know CSS at all. Violit provides over 30 themes. (Soon, users will be able to easily add Custom Themes.)
+
+*Theme demo will be updated soon.*
+
+![Theme Gallery Grid](PLACEHOLDER_FOR_THEME_GALLERY_GRID)
+
+```python
+# Configuration at initialization
+app = vl.App(theme='cyberpunk')
+
+# Runtime change
+app.set_theme('ocean')
+```
+
+| Theme Family | Examples |
+| --- | --- |
+| **Dark 🌑** | `dark`, `dracula`, `monokai`, `ocean`, `forest`, `sunset` |
+| **Light ☀️** | `light`, `pastel`, `retro`, `nord`, `soft_neu` |
+| **Tech 🤖** | `cyberpunk`, `terminal`, `cyber_hud`, `blueprint` |
+| **Professional 💼** | `editorial`, `bootstrap`, `ant`, `material`, `lg_innotek` |
+
+---
+
+## 📈 Benchmarks & Performance
+
+Benchmark results showing how efficient Violit's O(1) update method is compared to the existing O(N) method.
+
+
+
+*Detailed benchmark data will be updated soon.*
+
+![Benchmark Chart](PLACEHOLDER_FOR_BENCHMARK_CHART)
+
+
+---
+
+## 🚀 Comparison
+
+### Python UI Frameworks
+
+| Framework | Architecture | Learning Curve | Performance | Desktop App | Real-time |
+|-----------|---------|----------|---------|------------|------------|
+| **Streamlit** | Full Rerun | Very Easy | Slow | ❌ | △ |
+| **Dash** | Callback | Medium | Fast | ❌ | △ |
+| **Panel** | Param | Hard | Fast | ❌ | ✅ |
+| **Reflex** | React (Compile) | Hard | Fast | ❌ | ✅ |
+| **NiceGUI** | Vue | Easy | Fast | ✅ | ✅ |
+| **Violit** | **Signal** | **Very Easy** | **Fast** | **✅** | **✅** |
+
+### Code Comparison
+
+#### **1. vs Streamlit** (Rerun vs Signal)
+*Streamlit re-executes the **entire script** on button click, but Violit executes only **that function**.*
+
+```python
+# Streamlit
+import streamlit as st
+
+if "count" not in st.session_state:
+    st.session_state.count = 0
+
+if st.button("Click"):
+    st.session_state.count += 1 # Rerun triggers here
+
+st.write(st.session_state.count)
+```
+
+```python
+# Violit
+import violit as vl
+app = vl.App()
+
+count = app.state(0)
+
+# Update only count on click (No Rerun)
+app.button("Click", on_click=lambda: count.set(count.value + 1))
+app.write(count) 
+```
+
+#### **2. vs Dash** (Callback Hell vs Auto-Reactivity)
+*Dash requires complex **Callbacks** connecting Input/Output, but Violit only needs a single **State**.*
+
+```python
+# Dash
+from dash import Dash, html, Input, Output, callback
+
+app = Dash(__name__)
+app.layout = html.Div([
+    html.Button("Click", id="btn"),
+    html.Div(id="out")
+])
+
+@callback(Output("out", "children"), Input("btn", "n_clicks"))
+def update(n):
+    return f"Value: {n}" if n else "Value: 0"
+```
+
+```python
+# Violit
+count = app.state(0)
+
+app.button("Click", on_click=lambda: count.set(count.value + 1))
+# Automatic state dependency tracking -> No Callback needed
+app.write(lambda: f"Value: {count.value}")
+```
+
+#### **3. vs NiceGUI** (Binding vs Direct State)
+*NiceGUI is also great, but Violit offers a **more concise syntax** in the style of Streamlit.*
+
+```python
+# NiceGUI
+from nicegui import ui
+
+count = {'val': 0}
+ui.button('Click', on_click=lambda: count.update(val=count['val'] + 1))
+ui.label().bind_text_from(count, 'val', backward=lambda x: f'Value: {x}')
+```
+
+```python
+# Violit
+count = app.state(0)
+app.button('Click', on_click=lambda: count.set(count.value + 1))
+app.write(count) # No need for complex connections like .bind_text
+```
+
+#### **4. vs Reflex** (Class & Compile vs Pure Python)
+*Reflex requires State **class definition** and **compilation**, but Violit is a **pure Python** script.*
+
+```python
+# Reflex
+import reflex as rx
+
+class State(rx.State):
+    count: int = 0
+    def increment(self):
+        self.count += 1
+
+def index():
+    return rx.vstack(
+        rx.button("Click", on_click=State.increment),
+        rx.text(State.count)
+    )
+```
+
+```python
+# Violit
+# No class definition needed, no compilation needed
+count = app.state(0)
+app.button("Click", on_click=lambda: count.set(count.value + 1))
+app.write(count)
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Installation
+
+Can be installed in Python 3.10+ environments.
+
+```bash
+pip install violit
+
+# Or development version
+pip install git+https://github.com/violit-dev/violit.git
+```
+
+
+### 2. Hello, Violit!
+
+Create a `hello.py` file.
+
+```python
+import violit as vl
+
+app = vl.App(title="Hello Violit", theme='ocean')
+
+app.title("💜 Hello, Violit!")
+app.markdown("Experience the speed of **Zero Rerun**.")
+
+count = app.state(0)
+
+col1, col2 = app.columns(2)
+with col1:
+    app.button("➕ Plus", on_click=lambda: count.set(count.value + 1))
+with col2:
+    app.button("➖ Minus", on_click=lambda: count.set(count.value - 1))
+
+app.metric("Current Count", count)
+
+app.run()
+```
+
+### 3. Execution
+
+```bash
+# Basic run (WebSocket Mode)
+python hello.py
+
+# Desktop App Mode (Recommended)
+python hello.py --native
+
+# Port configuration
+python hello.py --port 8020
+```
+
+---
+
+## 📚 Widget Support
+
+Violit supports core Streamlit widgets, and some features have been redesigned for greater efficiency.
+
+For a detailed compatibility list and information on unsupported widgets, please refer to the [Streamlit API Support Matrix](./doc/Streamlit%20API%20Support%20Matrix.md) document.
+
+---
+
+## 🛠️ Tech Stack
+
+*   **Backend**: FastAPI (Async Python)
+*   **Frontend**: Web Components (Shoelace), Plotly.js, AG-Grid
+*   **Protocol**: WebSocket & HTTP/HTMX Hybrid
+*   **State**: Signal-based Reactivity
+
+---
+
+## 🗺️ Roadmap
+
+Violit is continuously evolving.
+
+*   ✅ **Core**: Signal State Engine, Theme System
+*   ✅ **Widgets**: Plotly, Dataframe, Input Widgets
+*   ⏳ **Homepage**: Official Homepage Open 
+*   ⏳ **Documentation**: Official Technical Documentation and API Reference Update 
+*   ⏳ **Custom Components**: User-defined Custom Component Support 
+*   ⏳ **Custom Theme**: User-defined Custom Theme Support 
+*   ⏳ **async**: Async processing support 
+*   ⏳ **More examples**: Provide more real-world usable example code 
+*   ⏳ **Violit.Cloud**: Cloud deployment service
+*   ⏳ **Expansion**: Integration of more third-party libraries
+
+---
+
+## 📂 Project Structure
+
+```bash
+.
+├── violit/            # Framework source code
+│   ├── app.py         # Main App class and entry point
+│   ├── broadcast.py   # Real-time WebSocket broadcasting
+│   ├── state.py       # Reactive State Engine
+│   ├── theme.py       # Theme management
+│   ├── assets/        # Built-in static files
+│   └── widgets/       # Widget implementations
+│       ├── input_widgets.py
+│       ├── data_widgets.py
+│       ├── layout_widgets.py
+│       └── ...
+└── requirements.txt   # Dependency list
+```
+
+---
+
+## 🤝 Contributing
+
+**Violit** is an open-source project. Let's build the future of faster and more beautiful Python UIs together.
+
+1.  Fork this repository
+2.  Create your feature branch
+3.  Commit your changes
+4.  Push to the branch
+5.  Open a Pull Request
+
+---
+
+## 📝 License
+
+MIT License
+
+**Violit™ is a trademark of The Violit Team.**
+
+---
+
+<p align="center">
+<strong>Made with 💜 by the Violit Team</strong>
+<br>
+<em>Faster than Light, Beautiful as Violet.</em>
+</p>

{violit-0.0.2.dist-info → violit-0.0.3.dist-info}/RECORD

@@ -1,16 +1,16 @@
 violit/__init__.py,sha256=mD8FeVW-LQ8yLpW2Unc-K885T507BgRfSI7mmObpPK0,88
-violit/app.py,sha256=ZId09ksikFNYO54-l88bQF2Q5WxkB-QmG9rWxIvdpY4,88313
+violit/app.py,sha256=B9lF_3RNxJeT1ROAiGFgHLL09oLRW8Qt3gCY67Vlhwo,89183
 violit/broadcast.py,sha256=IIRQR15Wr7cqHh0nSH86QdWN_Wd_GHNfVrtWCATGElc,24293
 violit/broadcast_primitives.py,sha256=G4Nx9BZscidPAjUc9janwIJ0zUi6DAnNFeJS67Uvs9I,5739
 violit/component.py,sha256=zH-ln8CVrkqfgB-_SPUmCL8dqQv-8RbKb2p9gtYqlqI,1445
 violit/context.py,sha256=EoshSMZ1kwHp81LU1kjUJXr4PJkFauTLwDcVwTZAxwk,443
-violit/engine.py,sha256=R-L09Y3u7_cjcX0xOEfhrUUm69kBL1Dl7bnnaPww6tw,1330
+violit/engine.py,sha256=oH3C04vhVgZFgy0HSaI9vPOkBEZBQBz40zs1Y1my9vw,1829
 violit/state.py,sha256=qBHZPv00OqopISBH5TN8GJBKZoT8klBX0S0P1FWF_kQ,2487
 violit/theme.py,sha256=1Ht2DariRADxGU1GTtUFJaIXZXi9XuhnucT2d04cwhs,30781
 violit/widgets/__init__.py,sha256=YiIqTOmGMWmmHmnZhfC9o0ZIYgjGqKrgAW2f87DiTP8,847
 violit/widgets/card_widgets.py,sha256=U-5iArs5eFxnzH6sh7YlF_5GHdwnIPhujJfdojBeViU,22517
 violit/widgets/chart_widgets.py,sha256=swFvpfQ4A6ObXcBs90Pe5pIlIUzsZ4x97veWsMR4UFs,10428
-violit/widgets/chat_widgets.py,sha256=uBViFy3aOIQ7IuffJvIunjf5uly13Cx4_6UlZrIbguA,10850
+violit/widgets/chat_widgets.py,sha256=YHNY4SDqHJhTi3Lq_5lGl01y9jsJAfbPlH4Ar0UqYC8,10899
 violit/widgets/data_widgets.py,sha256=p1TdhPYtvukZkQ8Z2nOBw8hLoNrpqx3Bj5iexhpl4Ok,22183
 violit/widgets/form_widgets.py,sha256=QVj-MRVpYzIM3hE8ISS5xZcX3jlTTzjRYSdzhw-K5OY,18327
 violit/widgets/input_widgets.py,sha256=tiLpfaKBwGhE2CdOL9s950bLVz2WhMP4Y-1yRM0qIAY,32023
@@ -19,8 +19,8 @@ violit/widgets/list_widgets.py,sha256=2-FWluNGfdBBN24ZyHOC2a8O93-NzGYHZlVYARX4Fp
 violit/widgets/media_widgets.py,sha256=FIMjaE1CIfqnsdMHbbCromjwxoWPfvFKmL0_qd6nDL4,7386
 violit/widgets/status_widgets.py,sha256=HXfS2F_PhEnwHrKNEMFv9JTgmeXgpfspoqq_jJZRPEQ,11140
 violit/widgets/text_widgets.py,sha256=xL0pqpQnt5M-BJJ0dzcaPqk6FizwN6HRAR2uOVN0zOw,17009
-violit-0.0.2.dist-info/licenses/LICENSE,sha256=tOk4v2bF2ohXIQ0ESylY80St38iDOWp5p5WKW2tUAP8,1088
-violit-0.0.2.dist-info/METADATA,sha256=Z8vRdPEvFh6FK10C8HJOJxeVjRo2l5I0af7laPD21X0,18874
-violit-0.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-violit-0.0.2.dist-info/top_level.txt,sha256=VormCSpHvTyMyZQ17MwgiPegDJev8HQCN5HUUcxUcE0,7
-violit-0.0.2.dist-info/RECORD,,
+violit-0.0.3.dist-info/licenses/LICENSE,sha256=dMxDVLF-GU5ZhQ-GmpL_eY4j7Wn1c4CtmRU8cOnR7Hw,1093
+violit-0.0.3.dist-info/METADATA,sha256=sOpdfpLINVVSkcPujhqZ_UkUztK77xhVb_hNM6YtmAE,12465
+violit-0.0.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+violit-0.0.3.dist-info/top_level.txt,sha256=VormCSpHvTyMyZQ17MwgiPegDJev8HQCN5HUUcxUcE0,7
+violit-0.0.3.dist-info/RECORD,,

{violit-0.0.2.dist-info → violit-0.0.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{violit-0.0.2.dist-info → violit-0.0.3.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 violit-dev
+Copyright (c) 2026 The Violit Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal