Metadata-Version: 2.4
Name: speedyeda
Version: 0.1.0
Summary: 🚀 One-line data exploration for developers & data scientists
Project-URL: Homepage, https://github.com/Dawaman43/fasteda
Project-URL: Documentation, https://github.com/Dawaman43/fasteda#readme
Project-URL: Repository, https://github.com/Dawaman43/fasteda
Project-URL: Issues, https://github.com/Dawaman43/fasteda/issues
Author-email: Dawit Worku <dawitworkujima@gmail.com>
License: MIT
License-File: LICENSE
Keywords: analysis,cli,data,eda,exploratory,visualization
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
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 :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.10
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: seaborn>=0.12.0
Requires-Dist: tabulate>=0.9.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🚀 FastEDA - One-Line Data Exploration

**Instant insights, beautiful visualizations, and comprehensive summaries** from datasets with just one command.

## ✨ Features

- 📊 **Automatic Statistics** - Mean, median, mode, min/max, std, unique counts, missing values
- 🔍 **Missing Value Analysis** - Highlights and suggestions for handling missing data
- 📈 **Auto Visualizations** - Histograms, boxplots, correlation heatmaps, and more
- 🎨 **Beautiful Terminal Output** - Colorful, emoji-rich displays using `rich`
- 🎭 **Fun Mode** - ASCII charts and emojis for screenshot-worthy results
- 📄 **Export Reports** - Save as PDF, HTML, or interactive dashboards
- 🔧 **Presets** - Pre-configured analysis for common use cases (ecommerce, surveys, finance)
- 🔌 **Plugin System** - Extend with custom visualizations and metrics
- 🤝 **Interactive Mode** - Guided column and plot selection
- 📦 **Batch Processing** - Analyze multiple datasets at once

## 🚀 Quick Start

### Installation

```bash
pip install fasteda
```

### Basic Usage

```bash
# Quick exploration
fasteda sales.csv

# Fun mode with emojis and colors
fasteda survey.xlsx --fun

# Use a preset for common tasks
fasteda products.csv --preset ecommerce

# Interactive mode
fasteda data.csv --interactive

# Batch processing
fasteda file1.csv file2.csv file3.csv
```

### Python API

```python
import pandas as pd
from fasteda import analyze, save_report

df = pd.read_csv("sales.csv")

# Generate EDA
results = analyze(df, fun=True)

# Save report
save_report(results, "sales_report.pdf")
```

## 📋 CLI Options

| Flag | Description |
|------|-------------|
| `--fun` | Adds emojis and colorful output |
| `--summary` | Plain text summary with insights |
| `--plots` | Generate and save visualizations |
| `--save <file>` | Export report (PDF/HTML) |
| `--interactive` | Interactive column/plot selection |
| `--preset <name>` | Use preset (ecommerce, survey, finance) |
| `--columns <cols>` | Analyze specific columns only |
| `--batch` | Process multiple files |
| `--quiet` | Suppress terminal output |

## 🎯 Presets

FastEDA includes built-in presets for common scenarios:

- **ecommerce** - Product analysis, sales trends, customer behavior
- **survey** - Response distributions, sentiment analysis, demographics
- **finance** - Time series, correlations, risk metrics

## 🔌 Plugins

Extend FastEDA with custom plugins:

```python
from fasteda.plugins import register_plugin

@register_plugin("custom_viz")
def my_visualization(df):
    # Your custom analysis
    pass
```

## 📦 Supported Formats

- CSV (`.csv`)
- Excel (`.xlsx`, `.xls`)
- JSON (`.json`)
- Parquet (`.parquet`)

## 🤝 Contributing

Contributions welcome! Share your presets and plugins with the community.

## 📄 License

MIT License - see LICENSE file for details.
