eda-wizard 0.1.0__tar.gz

eda_wizard-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+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.

eda_wizard-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE
+include README.md
+include pyproject.toml
+recursive-include edawizard *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.pyc
+recursive-exclude * *.pyo

eda_wizard-0.1.0/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: eda-wizard
+Version: 0.1.0
+Summary: Zero-config automated EDA: pass any folder, get charts, stats, and a full HTML report.
+Author: PyEDA 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
+
+```
+PyEDA_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

eda_wizard-0.1.0/README.md

@@ -0,0 +1,182 @@
+# ⬡ 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
+
+```
+PyEDA_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