ullr-data-cli 1.0.0__tar.gz → 1.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,8 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ullr-data-cli
3
- Version: 1.0.0
3
+ Version: 1.0.1
4
4
  Summary: An offline, AI-free Data Analytics and Dashboard Auditing CLI
5
- Home-page: https://github.com/yourusername/ullr-data-cli
5
+ Home-page: https://github.com/jshlydnzl/ullr-data-cli
6
6
  Author: jshlydnzl
7
7
  Author-email: jshlydnzl@users.noreply.github.com
8
8
  Classifier: Programming Language :: Python :: 3
@@ -0,0 +1,55 @@
1
+ # ⚡ Ullr: The Offline Data Auditor
2
+
3
+ > *An ultra-fast, 100% offline Data Quality and Dashboard Blueprint CLI.*
4
+
5
+ [![PyPI version](https://img.shields.io/pypi/v/ullr-data-cli.svg)](https://pypi.org/project/ullr-data-cli/)
6
+ [![Vibe Coded](https://img.shields.io/badge/Vibe%20Coded-AI%20Assisted-purple)](https://github.com/jshlydnzl)
7
+
8
+ **Ullr** is a pure Python Data Engine designed for Data Analysts and Engineers who need to audit massive Excel/CSV files instantly without relying on cloud APIs, ensuring 100% data privacy.
9
+
10
+ This project was intentionally **Vibe Coded** (AI-assisted engineered) to demonstrate modern, high-velocity software development using Large Language Models alongside core Data Engineering principles.
11
+
12
+ ---
13
+
14
+ ## 🚀 Installation
15
+
16
+ Install globally via PyPI:
17
+ ```bash
18
+ pip install ullr-data-cli
19
+ ```
20
+
21
+ ---
22
+
23
+ ## 🛠️ Features
24
+
25
+ ### 1. 🩺 Data Health Check (`ullr audit`)
26
+ Stop blindly trusting raw data. Ullr acts as an automated forensic auditor that scans your datasets for structural flaws before you build pipelines.
27
+ * **Duplicate Detection:** Identifies exact copy-paste errors.
28
+ * **Missing Value Scans:** Pinpoints exactly which columns have blank cells.
29
+ * **Messy Text Detection:** Scans text columns for invisible leading/trailing spaces requiring `TRIM()`.
30
+ * **Data Type Enforcement:** Catches numbers trapped as text (e.g., currency symbols or commas breaking math formulas).
31
+ * **Ghost Data Warning:** Detects completely empty structural columns caused by floating side-tables in Excel.
32
+
33
+ ### 2. 📊 Dashboard Blueprint Generator (`ullr analyze`)
34
+ Turn raw numbers into a full dashboard layout in seconds. Ullr calculates your key metrics and recommends an exact dashboard architecture based on your specific column data types.
35
+ * **Automated Executive Summary:** Calculates row counts, total sums, and dominant category percentages in plain English.
36
+ * **Dynamic Chart Logic:** Automatically recommends Line Charts for dates, Bar Charts for categories, and Donut Charts for binary metrics.
37
+ * **Multi-Platform Mentor:** Generates step-by-step click instructions on how to build the recommended dashboard in **Microsoft Excel, Power BI, Google Looker Studio, and Tableau**.
38
+
39
+ ---
40
+
41
+ ## 📖 Quick Start
42
+
43
+ Run the interactive engine from your terminal:
44
+ ```bash
45
+ ullr
46
+ ```
47
+
48
+ Or pass a file directly (Ullr will automatically scan your computer to find it if it's not in the current folder):
49
+ ```bash
50
+ ullr audit my_raw_data.csv
51
+ ullr analyze cleaned_data.xlsx
52
+ ```
53
+
54
+ ---
55
+ *Built by jshlydnzl.*
@@ -2,13 +2,13 @@ from setuptools import setup, find_packages
2
2
 
3
3
  setup(
4
4
  name='ullr-data-cli',
5
- version='1.0.0',
5
+ version='1.0.1',
6
6
  author='jshlydnzl',
7
7
  author_email='jshlydnzl@users.noreply.github.com',
8
8
  description='An offline, AI-free Data Analytics and Dashboard Auditing CLI',
9
9
  long_description='Ullr is a pure Python Data Engine that automatically audits CSV/Excel files for data quality (ghost data, invisible spaces, duplicates) and generates Dynamic Dashboard Blueprints for Excel, Power BI, Tableau, and Looker Studio.',
10
10
  long_description_content_type='text/markdown',
11
- url='https://github.com/yourusername/ullr-data-cli',
11
+ url='https://github.com/jshlydnzl/ullr-data-cli',
12
12
  packages=find_packages(),
13
13
  install_requires=[
14
14
  'rich',
@@ -1,8 +1,8 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ullr-data-cli
3
- Version: 1.0.0
3
+ Version: 1.0.1
4
4
  Summary: An offline, AI-free Data Analytics and Dashboard Auditing CLI
5
- Home-page: https://github.com/yourusername/ullr-data-cli
5
+ Home-page: https://github.com/jshlydnzl/ullr-data-cli
6
6
  Author: jshlydnzl
7
7
  Author-email: jshlydnzl@users.noreply.github.com
8
8
  Classifier: Programming Language :: Python :: 3
@@ -1,3 +1,4 @@
1
+ README.md
1
2
  setup.py
2
3
  ullr/__init__.py
3
4
  ullr/main.py
File without changes