Metadata-Version: 2.4
Name: cleanops
Version: 0.1.0
Summary: A lightweight data cleaning and inspection toolkit.
Author: Odchigue, Jave Melchor P., Angni, Sodais M., Ruiz, Rynzo Rapheal R., Padillo, Reymart, Magtrayo, Harold Hope
License-Expression: MIT
Project-URL: Homepage, https://github.com/odchigue25206/DataMedic
Project-URL: Repository, https://github.com/odchigue25206/DataMedic
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas
Dynamic: license-file

# DataMedic

A lightweight toolkit for inspecting, cleaning, organizing, and exporting datasets.  
Designed for quick data quality checks, automated cleaning, and report generation.

---

## 📌 Project Overview

DataMedic provides a simple workflow for handling messy datasets.  
It includes tools for:

- Detecting missing values  
- Identifying duplicate rows  
- Detecting outliers (IQR-based or statistical)  
- Cleaning + automatic fixing  
- Organizing dataset columns and rows  
- Exporting cleaned data (CSV / Excel / JSON)  
- Generating dataset health reports  
- Running complete pipelines combining cleaning, exporting, and reporting  

The goal is to make data preprocessing easier and more consistent.

---

## 📦 Installation

Install via pip:

```bash
pip install datamedic
```

Or, if you're installing from source:

```bash
pip install .
```

---

## 🚀 Example Usage

### **1. Inspecting and Cleaning a Dataset**

```python
import pandas as pd
from datamedic import DataCleaner

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

cleaner = DataCleaner(df)

# Diagnose issues
issues = cleaner.diagnose()
print("Issues found:", issues)

# Apply cleaning (missing, duplicates, outliers)
cleaned_df = cleaner.treat()

print(cleaned_df.head())
```

---

### **2. Exporting Cleaned Data**

```python
from datamedic import DataExporter

exporter = DataExporter(cleaned_df)

exporter.to_csv("output.csv")
exporter.to_excel("output.xlsx")
exporter.to_json("output.json")
```

---

### **3. Generating a Data Report**

```python
from datamedic import ReportGenerator

reporter = ReportGenerator(cleaned_df)
report = reporter.report()
score = reporter.health_score()

print("Report:", report)
print("Health Score:", score)

reporter.export_report("dataset_report.txt")
```

---

### **4. Running a Full Data Pipeline**

```python
from datamedic import DataCleaner, DataOutput, DataPipeline
import pandas as pd

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

cleaner = DataCleaner(df)
output = DataOutput(df)

pipeline = DataPipeline(doctor=cleaner, exporter=output.exporter, reporter=output.reporter)
pipeline.run()
```

---

## 📄 License

This project is released under the MIT License.

---

If ganahan ka Jave, pwede tika himuan og **logo**, **PyPI description**, or **badge-style header** para mas professional tan-awon sa PyPI.
