Metadata-Version: 2.5
Name: darsh
Version: 0.2.2
Summary: A magically simple, yet extremely powerful Python data application engine.
Author: Satyam Rana
License: MIT
Keywords: AI Practitioner,Dashboard,Data Analytics,Data Science,Interactive,Python,Satyam Rana,UI,Web Development
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.9
Requires-Dist: fastapi>=0.100.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: uvicorn>=0.23.0
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

<div align="center">
  <h1>✨ Darsh ✨</h1>
  <p><strong>A magically simple, yet extremely powerful Python data application engine.</strong></p>
  
  [![PyPI - Version](https://img.shields.io/pypi/v/darsh.svg)](https://pypi.org/project/darsh/)
  [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
  [![Python Versions](https://img.shields.io/pypi/pyversions/darsh.svg)](https://pypi.org/project/darsh/)
</div>

<br>

## 💡 The Philosophy

> **Extremely simple on the surface. Extremely powerful underneath.**

Darsh is designed to make Data Analytics feel less like writing boilerplate code and more like creating a premium modern product. 

You should **not** feel like you are using FastAPI, Pandas, SVG, JavaScript, or CSS. Darsh absorbs all that complexity so you can focus entirely on your data and insights. 

**Three lines of code → Data → Analysis → Beautiful Interactive Web Application.**

---

## 🚀 Quickstart

### 1. Install Darsh

```bash
pip install darsh
```

### 2. Build your first Dashboard

You don't need to manually design layouts, configure charts, or write HTML. Just load your data and let Darsh do the magic.

Create a file named `app.py`:

```python
import darsh as da
import pandas as pd

# 1. Load your data (CSV, Excel, or DataFrame)
df = pd.read_csv("https://raw.githubusercontent.com/datasciencedojo/datasets/master/titanic.csv")

# 2. Let Darsh intelligently clean it and wrap it
data = da.data(df).clean()

# 3. Generate a magical interactive dashboard
da.initialize(title="Titanic Analytics")
da.dashboard(data)

# 4. Run the server!
if __name__ == "__main__":
    da.get_app().run(port=8501)
```

### 3. Run it

```bash
python app.py
```
*Visit `http://localhost:8501` in your browser to see your premium, interactive dashboard!*

---

## ✨ Features

* 🧠 **Intelligent Dashboards**: Call `da.dashboard(data)` and Darsh will automatically infer data types and generate KPI cards, Line Charts for dates, and Bar Charts for categories.
* ⚡ **Instant Cross-Filtering**: Click on any chart element (like a bar in a Bar Chart) and watch the entire dashboard instantly filter and recalculate in the browser. No server roundtrips required!
* 🎨 **Buttery Smooth Animations**: SVG elements fluidly morph and transition when data is filtered.
* 🛡️ **Zero Frontend Knowledge Required**: Darsh compiles your Python code into a secure JSON Abstract Syntax Tree (AST), which is natively rendered by our custom lightweight JavaScript engine. 
* 🧹 **Smart Data Cleaning**: `data.clean()` automatically handles duplicates, missing values, and infers datetime objects so you don't have to wrestle with Pandas.

---

## 👨‍💻 Creator

**Darsh** was created and designed by **[Satyam Rana](https://www.satyamrana.in/)**, a Full-Stack Engineer, AI Practitioner, and Educator passionate about the intersections of technology, science, and meaningful innovation.

---

## 📄 License

This project is licensed under the MIT License.
