pydataui 0.2.1__tar.gz

pydataui-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Boopathi Raj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pydataui-0.2.1/PKG-INFO

@@ -0,0 +1,390 @@
+Metadata-Version: 2.4
+Name: pydataui
+Version: 0.2.1
+Summary: A full-stack Python framework for data and AI applications.
+Author-email: Boopathi Raj <rajboopathiking@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyrustapi<2,>=1.8.9
+Requires-Dist: PyJWT<3,>=2.8.0
+Requires-Dist: pydantic<3,>=2.0.0
+Provides-Extra: browser
+Requires-Dist: playwright<2,>=1.49; extra == "browser"
+Provides-Extra: data
+Requires-Dist: pandas>=1.5.0; extra == "data"
+Requires-Dist: plotly>=5.0.0; extra == "data"
+Requires-Dist: pyarrow; extra == "data"
+Provides-Extra: tunnel
+Requires-Dist: pyngrok>=7.0.0; extra == "tunnel"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: anyio>=4.0.0; extra == "dev"
+Requires-Dist: pandas>=1.5.0; extra == "dev"
+Requires-Dist: plotly>=5.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: pandas>=1.5.0; extra == "all"
+Requires-Dist: plotly>=5.0.0; extra == "all"
+Requires-Dist: pyarrow; extra == "all"
+Requires-Dist: pyngrok>=7.0.0; extra == "all"
+Dynamic: license-file
+
+# ⚡ PyDataUI
+
+<div align="center">
+
+![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Rust Core](https://img.shields.io/badge/backend-pyrustapi%20(Rust%2FTokio)-orange.svg)
+![UI Engine](https://img.shields.io/badge/styling-Tailwind%20CSS%20%2B%20shadcn%2Fui-38bdf8.svg)
+![Reactivity](https://img.shields.io/badge/reactivity-HTMX-3b82f6.svg)
+
+
+**A Full-Stack Python Framework for Data and AI Applications.**
+*Data Engineers • Data Analysts • AI/ML Engineers • Python Developers*
+
+Write pure Python → get reactive web applications, automatic REST APIs, and a Rust HTTP backend.
+**Zero JavaScript required.**
+
+[Quick Start](#-quick-start) • [Why PyDataUI?](#-why-pydataui) • [Components](#-components) • [Authentication](#-authentication--api-keys) • [Port Forwarding](#-port-forwarding-sharetrue) • [Benchmarks](#-performance-benchmarks) • [Documentation](docs/README.md)
+
+</div>
+
+---
+
+## 🎯 Built Specifically for Data Roles
+
+Build dashboards, dataset explorers, model evaluation interfaces, and data
+workflows using Python UI components and server-side logic.
+
+**0.2.1 security source update:** see [the migration guide](docs/MIGRATION_0_2_1.md)
+for protected routes, API permissions, CSRF, and session behavior. This checkout
+has not been published to PyPI by this change.
+
+**PyDataUI solves this:**
+- 🐍 **100% Python Code**: Build UI, reactive state, and server logic in clean, typed Python.
+- 🦀 **Rust-Powered HTTP Core (`pyrustapi`)**: Tokio/Hyper HTTP backend; application performance needs workload-specific measurement.
+- 🎨 **Tailwind CSS + shadcn/ui**: Modern, accessible UI design system with built-in dark mode and CSS variables.
+- ⚡ **Reactive SSR via HTMX**: Server re-renders the current page fragment on state mutation — seamless browser updates with no user-authored JavaScript for common interactions.
+- 🔌 **Automatic REST API**: Eligible `State` classes expose OpenAPI documentation and CRUD endpoints at `/api/{State}`.
+- 🔒 **Auth & API Keys**: JWT authentication, role-based access control (RBAC), and `pdu_live_...` API keys for ETL automation.
+- 🌐 **One-Click Sharing (`share=True`)**: Create public internet tunnels for demos and stakeholders instantly, like Gradio.
+
+---
+
+## ⚡ Quick Start
+
+### Installation
+
+```bash
+pip install pydataui
+```
+
+Optional dependencies for data science and port forwarding:
+```bash
+pip install "pydataui[all]"   # includes pandas, plotly, pyngrok, pyarrow
+```
+
+### 1. Minimal Reactive Counter (30 seconds)
+
+```python
+from pydataui import App, State
+from pydataui.components import Container, Card, Flex, Button, Heading, Divider
+
+class CounterState(State):
+    count: int = 0
+    def increment(self): self.count += 1
+    def decrement(self): self.count -= 1
+    def reset(self): self.count = 0
+
+app = App(title="PyDataUI Counter")
+
+@app.page("/")
+def home():
+    return Container(
+        Card(
+            title="Reactive Counter",
+            children=[
+                Flex(
+                    Button("-", on_click=CounterState.decrement, variant="danger"),
+                    Heading(CounterState.count, level=2),
+                    Button("+", on_click=CounterState.increment, variant="success"),
+                    align="center", justify="center", gap="lg",
+                ),
+                Divider(),
+                Button("Reset", on_click=CounterState.reset, variant="outline", full_width=True),
+            ]
+        ),
+        max_width="md",
+        padding="lg",
+    )
+
+if __name__ == "__main__":
+    app.run()
+```
+
+Run it:
+```bash
+python app.py
+```
+- 🌐 **Web UI:** `http://127.0.0.1:8000`
+- 📖 **Swagger UI:** `http://127.0.0.1:8000/docs`
+- 📡 **REST API Catalog:** `http://127.0.0.1:8000/api`
+
+---
+
+## 🤖 Machine Learning Dashboard Example
+
+PyDataUI includes native components for model evaluation:
+
+```python
+from pydataui import App
+from pydataui.components import Container, Heading, Grid
+from pydataui.components.data_science import ModelMetrics, ConfusionMatrix, FeatureImportance
+
+app = App(title="Fraud Detection Model v3")
+
+@app.page("/")
+def dashboard():
+    return Container(
+        Heading("Production XGBoost Model Evaluation", level=1, margin_bottom="lg"),
+        ModelMetrics(
+            metrics={
+                "Accuracy": 0.9642,
+                "Precision": 0.9410,
+                "Recall": 0.9780,
+                "ROC-AUC": 0.9891
+            }
+        ),
+        Grid(
+            ConfusionMatrix(
+                matrix=[[1450, 42], [28, 1380]],
+                labels=["Legitimate", "Fraud"]
+            ),
+            FeatureImportance(
+                features={
+                    "velocity_1h": 0.34,
+                    "avg_amount_ratio": 0.28,
+                    "device_fingerprint_entropy": 0.18,
+                    "geo_distance_anomaly": 0.12,
+                    "is_international": 0.08
+                },
+                title="Top Predictive Features"
+            ),
+            columns=2, gap="lg", margin_top="lg"
+        ),
+        padding="lg"
+    )
+
+if __name__ == "__main__":
+    app.run()
+```
+
+---
+
+## 🔒 Authentication, Roles & API Keys
+
+Secure your application for enterprise data workflows:
+
+```python
+from pydataui import App
+from pydataui.components import Container, Heading, Flex
+from pydataui.auth import (
+    AuthManager, LoginPage, UserMenu, APIKeyManager,
+    require_auth, require_role, Role, current_user
+)
+
+app = App(title="Secure Analytics Portal")
+auth = AuthManager()  # Configure PYDATAUI_AUTH_SECRET for deployment
+
+# Register users with roles
+admin = auth.add_user("lead_eng", "password123", roles=[Role.ADMIN, Role.DATA_ENGINEER])
+analyst = auth.add_user("analyst_jane", "password456", roles=[Role.DATA_ANALYST])
+
+# Wire up auth routes (/api/auth/login, /api/auth/me, /api/auth/keys)
+app.setup_auth(auth)
+
+@app.page("/login")
+def login_route():
+    return LoginPage(title="Analytics Portal", subtitle="Sign in with your corporate credentials")
+
+@app.page("/")
+def dashboard():
+    user = current_user.get()
+    return Container(
+        Flex(
+            Heading("Data Warehouse Control Center", level=1),
+            UserMenu(user),
+            justify="space-between", align="center"
+        ),
+        APIKeyManager(keys=auth.list_api_keys(user.id) if user else []),
+        padding="lg"
+    )
+
+# Protected API endpoint with API key requirement
+@app.api("/data/export", method="GET")
+def export_data(request):
+    user = auth.require_auth_middleware(request)
+    if not user:
+        return {"error": "Unauthorized"}
+    return {"status": "ok", "records": 100000}
+
+if __name__ == "__main__":
+    app.run()
+```
+
+### Automated API Key Authentication (ETL & Airflow)
+Automate ingestion pipelines by passing the generated key:
+```bash
+curl -H "Authorization: Bearer pdu_live_819dd41a93870327fdc57311d0080755" \
+     http://localhost:8000/data/export
+```
+
+---
+
+## 🌐 Port Forwarding (`share=True`)
+
+Share your application with remote stakeholders, clients, or team members with a single flag:
+
+```python
+# In your Python code:
+app.run(share=True)
+```
+Or via CLI:
+```bash
+pydataui run app.py --share
+```
+Output:
+```
+  PyDataUI v0.2.0
+  Running on http://127.0.0.1:8000
+  Public URL: https://abc123.ngrok.app
+  API docs at http://127.0.0.1:8000/docs
+  REST API root at http://127.0.0.1:8000/api
+```
+
+---
+
+## 📊 Performance
+
+The backend uses pyrustapi. This repository does not yet contain a reproducible
+benchmark suite establishing throughput, P99 latency, or memory superiority over
+other frameworks. Evaluate equivalent real applications on the same hardware;
+HTTP hello-world throughput does not establish data-application performance.
+
+---
+
+## 🧩 Comprehensive Component Library (80+ Components)
+
+PyDataUI includes modern Tailwind and shadcn/ui components:
+
+### 🔬 Data & Machine Learning
+- `DataFrameTable`: Interactive table with automatic pandas integration
+- `PlotlyChart`: Native Plotly figure embedding
+- `MetricCard`: KPI card with delta percentage and trend indicators
+- `ModelMetrics`: Evaluation grid (Accuracy, Precision, Recall, AUC, F1)
+- `ConfusionMatrix`: Heat-mapped confusion matrix
+- `FeatureImportance`: Horizontal bar chart for predictive features
+- `PipelineStatus`: Step-by-step DAG execution tracker
+- `DataTimeline`: Run history and audit event timeline
+- `SchemaViewer`: Inspect table schemas, dtypes, nulls, and uniques
+- `SQLEditor`: SQL query editor with inline Run button
+- `JSONViewer`: Pretty-printed, collapsible JSON display
+- `FileDownload`: In-browser data export to CSV/JSON
+
+### 🎨 shadcn/ui Styled Components
+- `ShadButton`, `ShadCard`, `ShadBadge`, `ShadAlert`, `ShadSeparator`
+- `ShadProgress`, `ShadSkeleton`, `ShadSwitch`, `ShadTable`, `ShadSelect`
+- `ShadTextarea`, `ShadLabel`, `ShadDialog` (Modal), `ShadScrollArea`
+- `ShadTabs`, `ShadToast`, `ShadAvatar`, `ShadHoverCard`, `ShadAccordion`, `ShadSheet` (Drawer)
+
+### 📐 Classic Layout & Forms
+- `Container`, `Flex`, `Grid`, `Stack`, `HStack`, `VStack`, `Box`, `Center`, `Divider`
+- `Heading`, `Text`, `Paragraph`, `Link`, `Code`, `Blockquote`
+- `Button`, `Input`, `TextArea`, `Select`, `Checkbox`, `Radio`, `Switch`, `Slider`, `FileUpload`
+- `Table`, `DataTable`, `Badge`, `Stat`, `Progress`, `Spinner`, `Modal`, `Drawer`
+- `BarChart`, `LineChart`, `PieChart`, `DoughnutChart`, `Sparkline`
+
+---
+
+### 💼 Commercial SaaS Application Example
+
+Experience an enterprise-grade AI gateway and subscription billing platform built entirely with PyDataUI:
+
+```bash
+python examples/commercial_saas_app.py
+```
+
+* **Executive Observability**: Live KPI cards (MRR, Token Volume, P99 Latency), time-window filters (`24h`, `7d`, `30d`), and pipeline step tracking.
+* **Model Observatory**: Multi-model routing matrix (Claude 3.5 Sonnet, GPT-4o, Gemini 1.5 Pro, Llama 3 70B) with pricing and quality benchmarks.
+* **Tiered Subscription Billing**: Interactive plan cards (Starter, Growth, Enterprise Scale) with usage quota progress and automated invoice history.
+* **API Key Gateway**: Provision scoped production tokens (`pdu_live_...`) for automated pipelines.
+* **Production Persistence**: Backed by SQLite WAL cross-process storage supporting multi-worker execution out of the box.
+
+## 🛠️ Powerful CLI
+
+Create, run, and containerize PyDataUI projects with zero boilerplate:
+
+```bash
+# 1. Create a project from starter templates
+pydataui new analytics_hub --template dashboard
+# Available templates: basic, dashboard, crud, ml-dashboard, data-pipeline, auth
+
+# 2. Run local development with hot reload
+pydataui dev app.py --port 8000 --reload
+
+# 3. Run production server with public tunnel
+pydataui run app.py --workers 1 --share
+
+# 4. Check syntax and route definitions
+pydataui check app.py
+
+# 5. Generate secure API key for scripts
+pydataui generate key --name "AirflowSync"
+
+# 6. One-command containerization build
+pydataui build app.py --output dist/
+# Generates Dockerfile, docker-compose.yml, bundled static assets, and app.py
+```
+
+---
+
+## 📚 In-Depth Guides
+
+- 📘 [Full Documentation](docs/README.md)
+- 🎨 [UI Customization Guide (Tailwind, shadcn & HTML)](docs/CUSTOMIZATION.md)
+- 🛠️ [Troubleshooting & Architecture Guide](docs/TROUBLESHOOTING.md)
+- 🔒 [Authentication & Security Guide](docs/AUTHENTICATION.md)
+- 📊 [Data Science & Engineering Components](docs/DATA_COMPONENTS.md)
+- 📖 [Complete API Reference](docs/API_REFERENCE.md)
+- 🚀 [Production & Cloud Deployment](docs/DEPLOYMENT.md)
+- 🛡️ [Production Readiness Assessment](docs/PRODUCTION_READINESS.md)
+- ⚡ [Quick Reference Card](docs/QUICKREF.md)
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions from the data science, AI/ML, and Python web development communities!
+Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for local environment setup, testing, and pull request guidelines.
+
+---
+
+## 📄 License
+
+PyDataUI is licensed under the [MIT License](LICENSE).
+Copyright (c) 2024 Boopathi Raj.