basicdatainfo

One-line automated EDA for pandas DataFrames.

Send it a DataFrame and it will:

• Detect each column's type (numeric, categorical, datetime, boolean, text)
• Compute summary statistics for every column
• Optionally clean the data (clean=True): drop duplicate rows, strip whitespace, auto-parse date columns, fill missing values, optionally cap outliers
• Automatically engineer date features (feature_engineer=True, default): if any column is (or becomes) a datetime column, it automatically derives year, quarter, month, month_name, week_of_year, day_of_month, day_of_week, day_name, is_weekend, is_month_start/end, is_quarter_start/end, and hour (if a time component is present) — and analyzes/visualizes all of these new columns too
• Automatically generate visualizations: histograms + boxplots for numeric columns, an extra "count by value" bar chart for low-cardinality numeric columns (e.g. the engineered month/day-of-week/quarter features), a "records over time" trend chart for datetime columns, bar charts for categorical columns, a missing-values chart, and a correlation heatmap
• Either print a summary + show the plots (default), or generate a single self-contained HTML report (html=True)

Install

pip install -e .

(or build a wheel with python -m build and pip install dist/*.whl)

Usage

import pandas as pd
import basicdatainfo

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

# 1. Just analyze + show plots inline (e.g. in Jupyter)
basicdatainfo.analyze(df)

# 2. Auto-clean the data first, then analyze
result = basicdatainfo.analyze(df, clean=True)
clean_df = result["df"]

# 3. Generate a standalone HTML report instead of inline output
basicdatainfo.analyze(df, clean=True, html=True, output_path="report.html")

analyze() parameters

Return value

analyze() returns a dict:

{
  "df": <cleaned-or-original dataframe, plus engineered date columns>,
  "analysis": {"overview": {...}, "column_types": {...}, "columns": {...}},
  "cleaning_report": {"actions": [...]} or None,
  "feature_engineering_report": {"actions": [...], "new_columns": [...]} or None,
  "report_path": "report.html",      # only if html=True
  "figures": {...},                   # only if html=False
}