Metadata-Version: 2.5
Name: extended_stats
Version: 0.1.1
Summary: Extended Statistics is a lightweight toolkit for comparing, profiling, and cleaning pandas DataFrames. It combines dataset diffing, an extended summary, and a handful of common cleaning transformations into a single, subpackage-organized API.
Project-URL: bugs, https://github.com/dreireyez/extended_stats/issues
Project-URL: changelog, https://github.com/dreireyez/extended_stats/releases
Project-URL: documentation, https://dreireyez.github.io/extended_stats/
Project-URL: homepage, https://github.com/dreireyez/extended_stats
Author-email: Djem Andreif Reyes <contact.dafreyes@gmail.com>
Maintainer-email: Djem Andreif Reyes <contact.dafreyes@gmail.com>
License: MIT
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: numpy>=1.24.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: rich
Requires-Dist: typer
Description-Content-Type: text/markdown

# Extended Statistics

[![PyPI version](https://img.shields.io/pypi/v/extended_stats.svg)](https://pypi.org/project/extended_stats/)
[![PyPI downloads](https://static.pepy.tech/badge/extended_stats/month)](https://pepy.tech/projects/extended_stats)

**Extended Statistics** is a lightweight toolkit for comparing, profiling, and cleaning pandas DataFrames. It combines dataset diffing, an extended summary, and a handful of common cleaning transformations into a single, subpackage-organized API — built as a proof of concept for practicing Python package development fundamentals (structure, subpackages, testing, and packaging).

* [GitHub](https://github.com/dreireyez/extended_stats/) | [PyPI](https://pypi.org/project/extended_stats/) | [Documentation](https://dreireyez.github.io/extended_stats/)
* Created by **Djem Andreif Reyes**
* MIT License

## Features

* **Dataset diffing:** Compare two versions of a DataFrame and get a structured report of what changed: rows added/removed, columns added/removed, dtype changes, per-cell value changes (when a key column is provided), and shifts in summary statistics (mean/median/nulls) for numeric columns.
* **Human-readable diff summaries:** Turn a diff report into a plain-language sentence summary, no manual interpretation required.
* **Dataset profiling:** A single function that merges the useful parts of .describe() and .info() into one report: shape, memory usage, duplicate row count, and per-column stats (nulls, uniques, mean/median/std for numeric columns, top value/frequency for categorical columns).
* **Basic cleaning utilities:** Drop fully duplicate rows and standardize column names (lowercase, trimmed, underscore-separated) in one call each.
* **Subpackage-organized API:** Diffing, profiling, and cleaning each live in their own subpackage, with a top-level re-export layer so functions are accessible.

## Installation

### Stable Release

To install **Extended Statistics**, run this command in your terminal:

```sh
uv add extended_stats
```

Or if you prefer to use `pip`:

```sh
pip install extended_stats
```

## From Source

The source files for Extended Statistics can be downloaded from the [Github repo](https://github.com/dreireyez/extended_stats).

You can either clone the public repository:

```sh
git clone https://github.com/dreireyez/extended_stats
```

Or download the [tarball](https://github.com/dreireyez/extended_stats/tarball/main):

```sh
curl -OJL https://github.com/dreireyez/extended_stats/tarball/main
```

Once you have a copy of the source, you can install it with:

```sh
cd extended_stats
uv sync
```

## Usage

To use **Extended Statistics** in a project:

```python
import extended_stats
```

## Documentation

Full documentation is available on
[GitHub Pages](https://dreireyez.github.io/extended_stats/).

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and
documentation instructions.

## Author

**Extended Statistics** was created in **2026** by **Djem Andreif Reyes**.

GitHub [@dreireyez](https://github.com/dreireyez) | PyPI [@dreireyez](https://pypi.org/user/dreireyez/)
