inspectpd 0.2.0

Inspection, comparison and visualisation of pandas data frames

inspectpd

Overview

inspectpd is collection of utilities for columnwise summary, comparison and visualisation of pandas dataframes. The package patches in the following methods for pandas objects:

• .inspect_types() summary of column types
• .inspect_mem() summary of memory usage of columns
• .inspect_na() columnwise prevalence of missing values
• .inspect_cor() correlation coefficients of numeric columns
• .inspect_imb() feature imbalance of non-numeric
• .inspect_num() summaries of numeric columns
• .inspect_cat() summaries of non-numeric

Installation and use

You can install inspectpd using pip with

pip install inspectpd

Simply import the package and use the methods on a pandas dataframe:

import pandas as pd
import inspectpd
# example data set just for illustration
from inspectpd import starwars

# categorical features summary
starwars.inspect_cat()

You can also get a quick visualisation of the summary too:

# get a plot of the categorical features
starwars.inspect_cat().view()

Development

This project uses uv for environment management and pre-commit with ruff for linting and formatting.

# create the dev environment and install inspectpd (editable) + dev tools
uv sync

# install the git hooks
uv run pre-commit install

# run the test suite
uv run pytest

# lint and format
uv run ruff check .
uv run ruff format .

# build the sdist and wheel
uv build

Releasing to PyPI

The package version is derived from git tags via hatch-vcs. To cut a release:

git tag v0.2.0
git push origin v0.2.0

This triggers .github/workflows/release.yml, which builds the wheel and sdist, creates a GitHub Release, and publishes to PyPI via OIDC (no API token needed).

One-time PyPI setup (Trusted Publisher): go to https://pypi.org/manage/account/publishing/ and add a publisher with:

Field	Value
Owner	alastairrushworth
Repository	inspectpd
Workflow	release.yml
Environment	pypi

Then create a matching pypi environment in the repo at Settings → Environments → New environment.