datapilot-kit 0.3.0rc1__py3-none-any.whl

datapilot/ui/dashboard.py

@@ -0,0 +1,90 @@
+"""
+Dashboard layout for Datapilot.
+"""
+
+from rich.columns import Columns
+from rich.console import Group
+
+from datapilot.core.report import Report
+
+from .cards import hero_card, metric_card
+
+
+def _health_color(score: int) -> str:
+    """
+    Return a border color based on dataset health.
+    """
+
+    if score >= 90:
+        return "green"
+
+    if score >= 75:
+        return "yellow"
+
+    return "red"
+
+
+def render_dashboard(report: Report) -> Group:
+    """
+    Render the Datapilot dashboard.
+    """
+
+    health = report.dataset_health()
+    missing = report.missing_values()
+    duplicates = report.duplicates()
+
+    hero = hero_card(
+        title="DATASET HEALTH",
+        value=f"{health.score}/100",
+        subtitle=f"Grade {health.grade} • {health.status}",
+        score=health.score,
+        border_style=_health_color(health.score),
+    )
+
+    cards = [
+        metric_card(
+            title="Missing",
+            value=f"{missing.missing_percentage:.1f}%",
+            subtitle=f"{missing.total_missing} values",
+            border_style=(
+                "green"
+                if missing.missing_percentage == 0
+                else "yellow"
+                if missing.missing_percentage <= 10
+                else "red"
+            ),
+        ),
+        metric_card(
+            title="Duplicates",
+            value=f"{duplicates.duplicate_percentage:.1f}%",
+            subtitle=f"{duplicates.total_duplicates} rows",
+            border_style=(
+                "green"
+                if duplicates.total_duplicates == 0
+                else "yellow"
+                if duplicates.duplicate_percentage <= 5
+                else "red"
+            ),
+        ),
+        metric_card(
+            title="ML Ready",
+            value="YES" if health.ml_ready else "NO",
+            subtitle="Training Status",
+            border_style=(
+                "green"
+                if health.ml_ready
+                else "red"
+            ),
+        ),
+    ]
+
+    metrics = Columns(
+        cards,
+        equal=True,
+        expand=True,
+    )
+
+    return Group(
+        hero,
+        metrics,
+    )

datapilot/ui/panels.py

@@ -0,0 +1,16 @@
+from rich.console import RenderableType
+from rich.panel import Panel
+
+
+def title_panel(
+    content: RenderableType,
+) -> Panel:
+    """
+    Create the standard Datapilot title panel.
+    """
+
+    return Panel(
+        content,
+        expand=True,
+        border_style="accent",
+    )

datapilot/ui/renderer.py

@@ -0,0 +1,21 @@
+"""
+Rich renderer for Datapilot reports.
+"""
+
+from datapilot.core.report import Report
+
+from .sections import (
+    render_header,
+    render_health,
+    render_summary,
+)
+
+
+def render_report(report: Report) -> None:
+    """
+    Render a complete Datapilot report.
+    """
+
+    render_header()
+    render_health(report)
+    render_summary(report)

datapilot/ui/sections.py

@@ -0,0 +1,89 @@
+"""
+Reusable rendering sections for Datapilot.
+"""
+
+from rich.align import Align
+from rich.table import Table
+from rich.text import Text
+
+from datapilot.core.report import Report
+
+from .console import console
+from .dashboard import render_dashboard
+from .panels import title_panel
+
+
+def render_header() -> None:
+    """
+    Render the Datapilot header.
+    """
+
+    header = Text(justify="center")
+
+    header.append(
+        "DATAPILOT\n",
+        style="title",
+    )
+
+    header.append(
+        "Data Quality Assessment & EDA\n",
+        style="info",
+    )
+
+    header.append(
+        "v0.1.0-alpha",
+        style="accent",
+    )
+
+    console.print(
+        title_panel(
+            Align.center(header)
+        )
+    )
+
+    console.print()
+
+
+def render_summary(report: Report) -> None:
+    """
+    Render dataset summary.
+    """
+
+    summary = report.summary()
+
+    table = Table(
+        title="Dataset Overview",
+        show_header=False,
+        border_style="accent",
+        expand=True,
+    )
+
+    table.add_column(style="label", width=20)
+    table.add_column(style="value")
+
+    table.add_row("Rows", str(summary.rows))
+    table.add_row("Columns", str(summary.columns))
+    table.add_row(
+        "Memory",
+        f"{summary.memory_usage_mb:.2f} MB",
+    )
+    table.add_row(
+        "Column Names",
+        ", ".join(summary.column_names),
+    )
+
+    console.print(table)
+
+
+def render_health(report: Report) -> None:
+    """
+    Render the Datapilot dashboard.
+    """
+
+    console.print()
+
+    console.print(
+        render_dashboard(report)
+    )
+
+    console.print()

datapilot/ui/tables.py

@@ -0,0 +1,21 @@
+"""
+Reusable Rich tables for Datapilot.
+"""
+
+from rich.table import Table
+
+
+def create_table(title: str | None = None) -> Table:
+    """
+    Create a standard Datapilot table.
+    """
+
+    table = Table(
+        title=title,
+        show_header=True,
+        header_style="heading",
+        border_style="accent",
+        expand=True,
+    )
+
+    return table

datapilot/ui/theme.py

@@ -0,0 +1,20 @@
+"""
+Datapilot Rich theme.
+"""
+
+from rich.theme import Theme
+
+DATAPILOT_THEME = Theme(
+    {
+        "title": "bold cyan",
+        "heading": "bold bright_blue",
+        "success": "bold green",
+        "warning": "bold yellow",
+        "error": "bold red",
+        "info": "cyan",
+        "score": "bold magenta",
+        "label": "bold white",
+        "value": "bright_white",
+        "accent": "bright_cyan",
+    }
+)

datapilot/utils/__init__.py

@@ -0,0 +1,3 @@
+"""
+Utility modules for Datapilot.
+"""

datapilot_kit-0.3.0rc1.dist-info/METADATA

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: datapilot-kit
+Version: 0.3.0rc1
+Summary: An open-source Python library for deterministic exploratory data analysis and dataset understanding.
+Author: Avishkar D. Gopale
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Aviii-3085/datapilot
+Project-URL: Repository, https://github.com/Aviii-3085/datapilot
+Project-URL: Issues, https://github.com/Aviii-3085/datapilot/issues
+Project-URL: Documentation, https://github.com/Aviii-3085/datapilot/tree/main/docs
+Keywords: eda,exploratory-data-analysis,data-analysis,data-science,dataset-profiling,machine-learning,analytics,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.2
+Requires-Dist: numpy>=2.0
+Requires-Dist: scipy>=1.14
+Requires-Dist: matplotlib>=3.9
+Requires-Dist: plotly>=6.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: rich>=14.0
+Requires-Dist: typer>=0.16
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# Datapilot
+
+> **The first step after loading your dataset.**
+
+Datapilot is an open-source Python library that automates exploratory data analysis by generating deterministic dataset insights, health assessments, statistical summaries, and professional HTML reports.
+
+Every data project begins with understanding the data. Datapilot helps you understand your dataset before building machine learning models, dashboards, or AI-powered applications.
+
+---
+
+## Installation
+
+```bash
+pip install datapilot-kit
+```
+
+---
+
+## Quick Start
+
+```python
+import pandas as pd
+
+from datapilot import analyze
+
+df = pd.read_csv("dataset.csv")
+
+report = analyze(df)
+```
+
+---
+
+## Features
+
+- Dataset Summary
+- Dataset Health Score
+- Missing Value Analysis
+- Duplicate Detection
+- Data Type Analysis
+- Statistical Summaries
+- Outlier Detection
+- Correlation Analysis
+- Actionable Insights
+- Professional HTML Reports
+
+---
+
+## Documentation
+
+Project documentation is available in the `docs/` directory.
+
+- Vision
+- User Journey
+- API Philosophy
+- API Review
+- Roadmap
+
+---
+
+## Status
+
+🚧 Datapilot v0.3 — Public Preview (In Development)
+
+The project is currently being prepared for its first public release.

datapilot_kit-0.3.0rc1.dist-info/RECORD

@@ -0,0 +1,44 @@
+datapilot/__init__.py,sha256=1iKfhsQUiUf6KyhYxvxC37XQ6f8H6GojYr5q78xV8Pw,164
+datapilot/analysis/__init__.py,sha256=9EbR5fqNuGfQxiJk16EX5vUn9Zek51q82Dm-5GQAb3U,41
+datapilot/analysis/correlation.py,sha256=nKkdbncyxZMs1Ki1-o6xK9djpeOLofI3qa5OHe-fDcI,1439
+datapilot/analysis/datatype.py,sha256=9uBkx50POu_ORVR_dWmGYagwk8AtwWahJROJJeNDEQY,1112
+datapilot/analysis/duplicate.py,sha256=jNK6IT7Ylcywht1ncZpTmm5HCPvOE_RQZh_oJgpnal8,842
+datapilot/analysis/health.py,sha256=09ZQuevCpw9OZItvxDJ1MbWRABSk9yo1qhb1QX7tfo8,4193
+datapilot/analysis/insights.py,sha256=N0EfQ2jpQQowj5OGBFLG6Z37YflpXEKuDAnwyY-BMig,2302
+datapilot/analysis/missing.py,sha256=Iry3ezChgsvspEPHplsdaNNwNVZidbqujveQtPvSS7U,1323
+datapilot/analysis/models.py,sha256=vUkA4K70mYE0rfZTef9uo6J2swgqDpVPBclGsqiVgDM,2143
+datapilot/analysis/outliers.py,sha256=zYp7wQH2Ey4FpMi3vrkOTiCDe0PgT2POXDjBgYa2C_Q,1863
+datapilot/analysis/statistics.py,sha256=A67ASq9KMVuX7tKlJC1jDtYdSiz2DGMp-7g3kijCptU,1477
+datapilot/analysis/summary.py,sha256=9ipuvUnDTodSFLCJ_Kh5V7uF2OJlmcmPow1GOe1Q7m4,754
+datapilot/api/__init__.py,sha256=b5VKEwfbHuew4bpYVXrF1NEaLiJZW2JH8kZgRBGPmA8,92
+datapilot/api/analyze.py,sha256=QLRtHfq5ZDE618jd_v0PX_ViZMGxYiLHBIgGMbUlHIc,311
+datapilot/assets/style.css,sha256=hsZTFort0p9XNf1PdSos0dRmAaGNtlkHGcJVJqecuS8,27381
+datapilot/cli/__init__.py,sha256=xevHiFgVAsWkTrnwCQBQa04UUx0R2EyQl8BBTz4b6VQ,47
+datapilot/core/__init__.py,sha256=x1qYdHlerjMZsgaGTyfy0taPaso1a8Z_TmkA36m9fQo,37
+datapilot/core/loader.py,sha256=Mdr9IhvY0xVYLa8hsySrmeHIUDJps6zeiGV-qo5nCkg,1462
+datapilot/core/report.py,sha256=saqSffuXzF5F8i-_67Pq_Wku_gJo1XhfSdpuTmaEFSE,2870
+datapilot/interpretation/__init__.py,sha256=M-EtGXnJzBU2zn0DOYE9bEdH7uqb9n6xK8ahdkS-odE,47
+datapilot/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+datapilot/recommendation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+datapilot/reporting/__init__.py,sha256=_oqlarqmgpkSYlyUUzME1-bwBaWy-1zRXDVe1NP2olo,44
+datapilot/reporting/fragments.py,sha256=7VScGkdWxCGIGjAshwBNP5-YvA0xrvN31cZ7qRaP6Zk,5799
+datapilot/reporting/html.py,sha256=kFwjXTISWv1U4vl-OHpuptXj0I3YzswgPlCN7P7xHgk,875
+datapilot/reporting/placeholders.py,sha256=iNFbs1CrZkmtUbBGs3SqDp0OkNOxx14dQJlHX80BRk8,3342
+datapilot/reporting/renderer.py,sha256=CYBcXBHVd35v4SsEulGGYGkTmeGI0w6FJeapn4LA1vo,1119
+datapilot/templates/report.html,sha256=jZ521w2I_GTJV3DGJo1icpSEYCZKT-jmm4Dd36uA1DI,22496
+datapilot/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+datapilot/ui/cards.py,sha256=3JI6MWFyg41dj-tGRSPH4ovGFPmEWFD2Jr-jKVXudqA,1416
+datapilot/ui/console.py,sha256=JvEKX4CD-bIshbNj5KkM41RTfy70iBpBZpE0bq9h08M,193
+datapilot/ui/dashboard.py,sha256=Qt133v0Ls7pk1Hc5T9ZEg27rYW5JvJlWivakDBk1uVQ,2206
+datapilot/ui/panels.py,sha256=_w4wbffo8Xqgiqt27I2SrtJ_Z1CcRJj3oK6WRo8Dc3Y,300
+datapilot/ui/renderer.py,sha256=ZgBYsXPuEBPXCJUAJK7NnVKoHfdHlR0y6yL-re3pthw,366
+datapilot/ui/sections.py,sha256=xG_QWWsB_wwMW-eAA9K73PUVJ0ZIvsCxZROvdC9khd0,1676
+datapilot/ui/tables.py,sha256=jKOjxDBizFbC6TKxf26bQDOV1cuyPFCN-E_ycg_kcI8,378
+datapilot/ui/theme.py,sha256=yAvJRsyjqaryd0_xBrR9hS6b4WPCCt77D3zMQleH_Gc,437
+datapilot/utils/__init__.py,sha256=lxtSihEb0zCIIxC--B3hBLjJo1m643peP-CWCqNZql0,40
+datapilot/visualization/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+datapilot_kit-0.3.0rc1.dist-info/licenses/LICENSE,sha256=DZWFtv_Z13xjXjMR463oHoHV6U-pbBEvzReSk2Gtu5Q,1091
+datapilot_kit-0.3.0rc1.dist-info/METADATA,sha256=WwpoSocH8eevaeC0Fs3bIrWnX_ebztXEm6Aa4l3iSIU,2902
+datapilot_kit-0.3.0rc1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+datapilot_kit-0.3.0rc1.dist-info/top_level.txt,sha256=gAOFOdwB00vcxv74y4M1J-nQtPvEatU8-mYViEBcToo,10
+datapilot_kit-0.3.0rc1.dist-info/RECORD,,

datapilot_kit-0.3.0rc1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

datapilot_kit-0.3.0rc1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Avishkar Gopale
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

datapilot_kit-0.3.0rc1.dist-info/top_level.txt

@@ -0,0 +1 @@
+datapilot