Metadata-Version: 2.4
Name: eda-wizard
Version: 0.1.1
Summary: Zero-config automated EDA: pass any folder, get charts, stats, and a full HTML report.
Author: eda-wizard Contributors
License: MIT License
        
        Copyright (c) 2025 SMFRafin
        
        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.
        
Project-URL: Homepage, https://github.com/SMFRafin/eda-wizard
Project-URL: Repository, https://github.com/SMFRafin/eda-wizard
Project-URL: Bug Tracker, https://github.com/SMFRafin/eda-wizard/issues
Keywords: eda,exploratory-data-analysis,data-science,automation,visualization,pandas,csv,video,audio,machine-learning
Classifier: Development Status :: 4 - Beta
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.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas>=1.5
Requires-Dist: numpy>=1.23
Requires-Dist: matplotlib>=3.6
Requires-Dist: seaborn>=0.12
Requires-Dist: openpyxl>=3.0
Requires-Dist: xlrd>=2.0
Requires-Dist: pyarrow>=10.0
Provides-Extra: video
Requires-Dist: opencv-python-headless>=4.7; extra == "video"
Provides-Extra: audio
Requires-Dist: mutagen>=1.46; extra == "audio"
Provides-Extra: image
Requires-Dist: Pillow>=9.0; extra == "image"
Provides-Extra: media
Requires-Dist: opencv-python-headless>=4.7; extra == "media"
Requires-Dist: mutagen>=1.46; extra == "media"
Requires-Dist: Pillow>=9.0; extra == "media"
Provides-Extra: full
Requires-Dist: eda-wizard[media]; extra == "full"
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# ⬡ EDA Wizard — Zero-Config Automated EDA

> Pass any folder. Get a full EDA report. No setup.

```python
import edawizard
edawizard.eda("any/folder")
```

---

## What it does

EDA Wizard recursively scans a folder, detects every supported file type, runs comprehensive exploratory data analysis on each one, and generates a **self-contained `report.html`** plus organized CSVs — all in one call.

### Supported file types

| Category | Formats |
|----------|---------|
| **Tabular** | CSV, TSV, Excel (.xlsx/.xls), JSON, Parquet, Feather, Pickle |
| **Video** | MP4, AVI, MKV, MOV, WMV, FLV, WebM, MPEG, 3GP, TS … |
| **Audio** | MP3, WAV, FLAC, AAC, OGG, M4A, WMA, OPUS, AIFF … |
| **Image** | PNG, JPG, JPEG, WebP, TIFF, BMP, GIF |

---

## Installation

### Core (tabular data only — zero extra deps):
```bash
pip install eda-wizard
```

### With full media support (video + audio + image):
```bash
pip install "eda-wizard[full]"
```

### Pick what you need:
```bash
pip install "eda-wizard[video]"   # adds opencv-python-headless
pip install "eda-wizard[audio]"   # adds mutagen
pip install "eda-wizard[image]"   # adds Pillow
```

> **Video fallback:** If `opencv-python-headless` is not installed, EDA Wizard automatically tries `ffprobe` (part of [FFmpeg](https://ffmpeg.org)) if available on your PATH.

---

## Usage

```python
import edawizard

# Scan a folder — all supported files analysed automatically
edawizard.eda("path/to/any/folder")

# Custom output folder name
edawizard.eda("my_data", output_name="eda_results")

# Disable row sampling (analyse all rows, slower on huge files)
edawizard.eda("my_data", max_rows=0)

# Silent mode
edawizard.eda("my_data", verbose=False)
```

---

## Output structure

```
EDA_Wizard_Output/
├── report.html               ← self-contained interactive report (open in browser)
├── summary.csv               ← overview of all files
│
├── sales/                    ← one folder per tabular file
│   ├── summary_stats.csv
│   ├── missing_values.csv
│   ├── correlation_matrix.csv
│   └── value_counts/
│       ├── region.csv
│       └── category.csv
│
├── media_video/
│   └── metadata.csv          ← FPS, resolution, duration, codec, bitrate per file
│
├── media_audio/
│   └── metadata.csv          ← sample rate, channels, bitrate, duration per file
│
└── media_image/
    └── metadata.csv          ← width, height, megapixels, mode, DPI per file
```

---

## What's in the report

### Tabular datasets
- Shape, memory usage, dtype breakdown
- Missing value counts + heatmap (per column)
- Duplicate row detection
- Descriptive statistics (mean, std, percentiles, skew, kurtosis)
- Outlier detection (IQR method) with fences
- Correlation matrix heatmap + top correlated pairs
- Distribution histograms + KDE per numeric column
- Box plots per numeric column
- Top-value bar charts per categorical column
- Zero / negative counts per numeric column

### Video datasets
- Duration distribution + total hours
- FPS distribution (discrete bar or continuous histogram)
- Resolution scatter plot (width × height bubble map)
- Aspect ratio breakdown
- Bitrate distribution
- Codec distribution

### Audio datasets
- Duration distribution + total hours
- Sample rate (Hz) distribution — discrete bar chart
- Channel layout (Mono / Stereo / Surround) pie chart
- Bitrate distribution
- Codec distribution

### Image datasets
- Resolution scatter map
- Megapixel distribution
- Color mode breakdown (RGB, RGBA, Grayscale …)
- Aspect ratio breakdown
- File size distribution

---

## How media extraction works

```
Video  →  opencv-python-headless  →  ffprobe (subprocess)  →  file size only
Audio  →  mutagen                 →  ffprobe (subprocess)  →  file size only
Image  →  Pillow                  →  file size only
```

EDA Wizard degrades gracefully: if a library isn't installed it tries the next option and prints a tip at startup.

---

## Requirements

| Package | Purpose | Optional? |
|---------|---------|-----------|
| `pandas` | Data loading & stats | No |
| `numpy` | Numerics | No |
| `matplotlib` | Chart rendering | No |
| `seaborn` | Chart styling | No |
| `openpyxl` | Excel .xlsx | No |
| `pyarrow` | Parquet / Feather | No |
| `opencv-python-headless` | Video metadata | Yes (`pip install "eda-wizard[video]"`) |
| `mutagen` | Audio metadata | Yes (`pip install "eda-wizard[audio]"`) |
| `Pillow` | Image metadata | Yes (`pip install "eda-wizard[image]"`) |

---

## Contributing

```bash
git clone https://github.com/SMFRafin/eda-wizard
cd eda-wizard
pip install -e ".[dev]"
pytest
```

PRs welcome! Especially for:
- Additional file type support
- LLM-generated insight summaries
- More chart types
- Performance improvements for very large datasets

---

## License

MIT
