Skip to main content

A lightweight data cleaning and inspection toolkit.

Project description

CleanOps

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


📌 Project Overview

CleanOps 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)
  • Running complete pipelines combining cleaning, exporting, and reporting

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


📦 Installation

Install via pip:

pip install cleanops

Or, if you're installing from source:

pip install .

🚀 Example Usage

1. Inspecting and Cleaning a Dataset

import pandas as pd
from cleanops import DataCleaner

df = pd.read_csv("test_data_150.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

from cleanops 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

from cleanops import ReportGenerator

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

print("Report:", report)

reporter.export_report("dataset_report.json")

4. Running a Full Data Pipeline

from cleanops import DataCleaner, DataOutput, DataPipeline
import pandas as pd

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

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

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

📄 License

This project is released under the MIT License.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cleanops-0.1.7.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cleanops-0.1.7-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file cleanops-0.1.7.tar.gz.

File metadata

  • Download URL: cleanops-0.1.7.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for cleanops-0.1.7.tar.gz
Algorithm Hash digest
SHA256 0bbaa8f0c37c15b670f34ad3b0079dc9743ec5746bbf69ba7385c33c7cd89f2e
MD5 05385a3f3a12a1304181f8d680fe3890
BLAKE2b-256 b17c64cd84090c0ca480a1d55ae2a4090cf996c007f77daaf29418bb1f78d4bb

See more details on using hashes here.

File details

Details for the file cleanops-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: cleanops-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 7.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for cleanops-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 f8060e154bcad03f36f7eec3fb73ab7fc61199b7b22cfff5194bc48962ccf7bd
MD5 ec08ee9289d0ee9c5b917e9a257bef44
BLAKE2b-256 bd06ef73f5287ef9fc09ebf3b0b5dee70ba1aeffbeff433dd8cc37b6e2a1f7e2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page