puralang-engine 1.0.0__tar.gz

puralang_engine-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SAI DARSINI S
+
+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.

puralang_engine-1.0.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: puralang_engine
+Version: 1.0.0
+Summary: An AI-driven domain-specific language engine for automated data cleaning pipelines.
+Home-page: https://github.com/SaiDarsini/puralang_engine
+Author: Sai Darsini
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lark
+Requires-Dist: rich
+Requires-Dist: pandas
+Requires-Dist: typer
+Requires-Dist: google-genai
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PuraLang Engine 🚀
+
+> **An AI-powered Domain-Specific Language for automated data cleaning pipelines.**  
+> Describe your data problem in plain English — PuraLang writes and runs the pipeline for you.
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-0.1.0-blue?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/python-3.8+-green?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/license-MIT-orange?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/status-active-brightgreen?style=for-the-badge" />
+</p>
+
+---
+
+## What is PuraLang?
+
+PuraLang is a custom programming language built specifically for **data cleaning**. Instead of writing 30–50 lines of Python/Pandas code every time you need to clean a dataset, you write a clean, human-readable `.pura` script — or better yet, just **describe what you want in English** and let the AI generate the script for you.
+
+### The Problem It Solves
+
+Every data engineer and ML practitioner spends hours writing repetitive boilerplate code like this:
+
+```python
+import pandas as pd
+df = pd.read_csv("users.csv")
+df = df.drop_duplicates(subset=["user_id"])
+df["age"] = df["age"].fillna(24)
+df["email"] = df["email"].str.strip().str.lower()
+df.to_csv("clean_users.csv", index=False)
+```
+
+With PuraLang, the same result is achieved in 5 readable lines:
+
+```
+LOAD "users.csv"
+  |> DROP_DUPLICATES "user_id"
+  |> FILL_NULLS "age" VALUE 24
+  |> FORMAT_STRINGS "email" TO LOWERCASE
+  |> EXPORT_CSV "clean_users.csv"
+```
+
+And with **AI Mode**, you don't even need to write that:
+
+```bash
+puralang ask "clean users.csv — remove duplicate user IDs, fill missing ages with 24, lowercase all emails"
+```
+
+---
+
+## Features
+
+- **Custom DSL Syntax** — Clean, readable pipeline syntax with `|>` operators
+- **AI Mode** — Describe your cleaning task in plain English; the engine generates and runs the script automatically
+- **Visual Execution Trace** — Beautiful terminal output showing row counts before and after every operation
+- **Multiple Operations** — DROP_DUPLICATES, FILL_NULLS, FORMAT_STRINGS, FILTER_ROWS, EXPORT_CSV
+- **Zero Boilerplate** — No Pandas knowledge required to use it
+
+---
+
+## Installation
+
+```bash
+pip install puralang-engine
+```
+
+Or clone and run locally:
+
+```bash
+git clone https://github.com/SaiDarsini/puralang_engine.git
+cd puralang_engine
+pip install -r requirements.txt
+```
+
+---
+
+## Quick Start
+
+### Manual Mode — Write a `.pura` script
+
+Create a file called `pipeline.pura`:
+
+```
+LOAD "dirty_data.csv"
+  |> DROP_DUPLICATES "user_id"
+  |> FILL_NULLS "age" VALUE 24
+  |> FORMAT_STRINGS "email" TO LOWERCASE
+  |> EXPORT_CSV "cleaned_output.csv"
+```
+
+Run it:
+
+```bash
+puralang run pipeline.pura
+```
+
+### AI Mode — Describe it in English
+
+```bash
+puralang ask "load sales.csv, remove duplicate order IDs, fill missing prices with 0, export to clean_sales.csv"
+```
+
+PuraLang will:
+1. Send your description to an AI model
+2. Show you the generated `.pura` script
+3. Execute it automatically
+4. Print the trace report
+
+---
+
+## Execution Output
+
+Every pipeline run produces a visual trace table in your terminal:
+
+```
+ ┌─────────────────────────── PuraLang Execution Trace ───────────────────────────┐
+ │ Operation                      │ Rows Before │ Rows After │
+ ├────────────────────────────────┼─────────────┼────────────┤
+ │ LOAD SOURCE DATA               │ -           │ 4          │
+ │ DROP DUPLICATES [user_id]      │ 4           │ 3          │
+ │ FILL NULL FIELDS [age]         │ 3           │ 3          │
+ │ STRING TRANSFORM [email]       │ 3           │ 3          │
+ │ EXPORT COMPILED FILE           │ 3           │ 3          │
+ └────────────────────────────────┴─────────────┴────────────┘
+```
+
+---
+
+## Supported Operations
+
+| Operation | Syntax | Description |
+|-----------|--------|-------------|
+| Load CSV | `LOAD "file.csv"` | Load a CSV file into the pipeline |
+| Drop Duplicates | `DROP_DUPLICATES "column"` | Remove duplicate rows based on a column |
+| Fill Nulls | `FILL_NULLS "column" VALUE 0` | Fill missing values with a default |
+| Format Strings | `FORMAT_STRINGS "column" TO LOWERCASE` | Normalize text casing |
+| Filter Rows | `FILTER_ROWS "column" GREATER_THAN 18` | Filter rows by condition |
+| Export CSV | `EXPORT_CSV "output.csv"` | Save cleaned data to a new file |
+
+---
+
+## Project Architecture
+
+```
+puralang_engine/
+│
+├── puralang/
+│   ├── __init__.py       # Package version
+│   ├── core.py           # Lark grammar, parser, and transformer engine
+│   └── cli.py            # Typer CLI — run and ask commands
+│
+├── tests/
+│   └── sample.pura       # Example PuraLang script
+│
+├── setup.py              # PyPI packaging config
+└── README.md
+```
+
+The engine works in 3 stages:
+
+```
+.pura script → [Lark Parser] → Abstract Syntax Tree → [Transformer] → Pandas execution → Clean CSV
+```
+
+For AI Mode:
+
+```
+English prompt → [LLM API] → .pura script → [Engine] → Clean CSV
+```
+
+---
+
+## Tech Stack
+
+- **Lark** — Grammar definition and parsing
+- **Pandas** — Underlying data manipulation engine
+- **Rich** — Beautiful terminal output and trace tables
+- **Typer** — CLI command interface
+- **Google Gemini API** — AI script generation (AI Mode)
+
+---
+
+## Roadmap
+
+- [x] Core DSL parser and transformer
+- [x] CLI with `run` command
+- [x] AI Mode with `ask` command
+- [x] Visual execution trace table
+- [ ] PyPI public release (`pip install puralang-engine`)
+- [ ] Support for JSON and Excel input formats
+- [ ] Web UI for non-technical users
+- [ ] VS Code extension with `.pura` syntax highlighting
+
+---
+
+## About the Author
+
+**Sai Darsini Sathuluru**  
+B.Tech Student | Mohan Babu University | Generative AI Intern @ Prodigy InfoTech  
+Founder & Core Architect of PuraLang Engine
+
+- GitHub: [@SaiDarsini](https://github.com/SaiDarsini)
+
+
+---
+
+## License
+
+This project is licensed under the **MIT License** — you are free to use, modify, and distribute it.  
+See the [LICENSE](LICENSE) file for details.
+
+---
+
+<p align="center">
+  Built with ❤️ by Sai Darsini · If this helped you, please ⭐ the repo!
+</p>

puralang_engine-1.0.0/README.md

@@ -0,0 +1,215 @@
+# PuraLang Engine 🚀
+
+> **An AI-powered Domain-Specific Language for automated data cleaning pipelines.**  
+> Describe your data problem in plain English — PuraLang writes and runs the pipeline for you.
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-0.1.0-blue?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/python-3.8+-green?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/license-MIT-orange?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/status-active-brightgreen?style=for-the-badge" />
+</p>
+
+---
+
+## What is PuraLang?
+
+PuraLang is a custom programming language built specifically for **data cleaning**. Instead of writing 30–50 lines of Python/Pandas code every time you need to clean a dataset, you write a clean, human-readable `.pura` script — or better yet, just **describe what you want in English** and let the AI generate the script for you.
+
+### The Problem It Solves
+
+Every data engineer and ML practitioner spends hours writing repetitive boilerplate code like this:
+
+```python
+import pandas as pd
+df = pd.read_csv("users.csv")
+df = df.drop_duplicates(subset=["user_id"])
+df["age"] = df["age"].fillna(24)
+df["email"] = df["email"].str.strip().str.lower()
+df.to_csv("clean_users.csv", index=False)
+```
+
+With PuraLang, the same result is achieved in 5 readable lines:
+
+```
+LOAD "users.csv"
+  |> DROP_DUPLICATES "user_id"
+  |> FILL_NULLS "age" VALUE 24
+  |> FORMAT_STRINGS "email" TO LOWERCASE
+  |> EXPORT_CSV "clean_users.csv"
+```
+
+And with **AI Mode**, you don't even need to write that:
+
+```bash
+puralang ask "clean users.csv — remove duplicate user IDs, fill missing ages with 24, lowercase all emails"
+```
+
+---
+
+## Features
+
+- **Custom DSL Syntax** — Clean, readable pipeline syntax with `|>` operators
+- **AI Mode** — Describe your cleaning task in plain English; the engine generates and runs the script automatically
+- **Visual Execution Trace** — Beautiful terminal output showing row counts before and after every operation
+- **Multiple Operations** — DROP_DUPLICATES, FILL_NULLS, FORMAT_STRINGS, FILTER_ROWS, EXPORT_CSV
+- **Zero Boilerplate** — No Pandas knowledge required to use it
+
+---
+
+## Installation
+
+```bash
+pip install puralang-engine
+```
+
+Or clone and run locally:
+
+```bash
+git clone https://github.com/SaiDarsini/puralang_engine.git
+cd puralang_engine
+pip install -r requirements.txt
+```
+
+---
+
+## Quick Start
+
+### Manual Mode — Write a `.pura` script
+
+Create a file called `pipeline.pura`:
+
+```
+LOAD "dirty_data.csv"
+  |> DROP_DUPLICATES "user_id"
+  |> FILL_NULLS "age" VALUE 24
+  |> FORMAT_STRINGS "email" TO LOWERCASE
+  |> EXPORT_CSV "cleaned_output.csv"
+```
+
+Run it:
+
+```bash
+puralang run pipeline.pura
+```
+
+### AI Mode — Describe it in English
+
+```bash
+puralang ask "load sales.csv, remove duplicate order IDs, fill missing prices with 0, export to clean_sales.csv"
+```
+
+PuraLang will:
+1. Send your description to an AI model
+2. Show you the generated `.pura` script
+3. Execute it automatically
+4. Print the trace report
+
+---
+
+## Execution Output
+
+Every pipeline run produces a visual trace table in your terminal:
+
+```
+ ┌─────────────────────────── PuraLang Execution Trace ───────────────────────────┐
+ │ Operation                      │ Rows Before │ Rows After │
+ ├────────────────────────────────┼─────────────┼────────────┤
+ │ LOAD SOURCE DATA               │ -           │ 4          │
+ │ DROP DUPLICATES [user_id]      │ 4           │ 3          │
+ │ FILL NULL FIELDS [age]         │ 3           │ 3          │
+ │ STRING TRANSFORM [email]       │ 3           │ 3          │
+ │ EXPORT COMPILED FILE           │ 3           │ 3          │
+ └────────────────────────────────┴─────────────┴────────────┘
+```
+
+---
+
+## Supported Operations
+
+| Operation | Syntax | Description |
+|-----------|--------|-------------|
+| Load CSV | `LOAD "file.csv"` | Load a CSV file into the pipeline |
+| Drop Duplicates | `DROP_DUPLICATES "column"` | Remove duplicate rows based on a column |
+| Fill Nulls | `FILL_NULLS "column" VALUE 0` | Fill missing values with a default |
+| Format Strings | `FORMAT_STRINGS "column" TO LOWERCASE` | Normalize text casing |
+| Filter Rows | `FILTER_ROWS "column" GREATER_THAN 18` | Filter rows by condition |
+| Export CSV | `EXPORT_CSV "output.csv"` | Save cleaned data to a new file |
+
+---
+
+## Project Architecture
+
+```
+puralang_engine/
+│
+├── puralang/
+│   ├── __init__.py       # Package version
+│   ├── core.py           # Lark grammar, parser, and transformer engine
+│   └── cli.py            # Typer CLI — run and ask commands
+│
+├── tests/
+│   └── sample.pura       # Example PuraLang script
+│
+├── setup.py              # PyPI packaging config
+└── README.md
+```
+
+The engine works in 3 stages:
+
+```
+.pura script → [Lark Parser] → Abstract Syntax Tree → [Transformer] → Pandas execution → Clean CSV
+```
+
+For AI Mode:
+
+```
+English prompt → [LLM API] → .pura script → [Engine] → Clean CSV
+```
+
+---
+
+## Tech Stack
+
+- **Lark** — Grammar definition and parsing
+- **Pandas** — Underlying data manipulation engine
+- **Rich** — Beautiful terminal output and trace tables
+- **Typer** — CLI command interface
+- **Google Gemini API** — AI script generation (AI Mode)
+
+---
+
+## Roadmap
+
+- [x] Core DSL parser and transformer
+- [x] CLI with `run` command
+- [x] AI Mode with `ask` command
+- [x] Visual execution trace table
+- [ ] PyPI public release (`pip install puralang-engine`)
+- [ ] Support for JSON and Excel input formats
+- [ ] Web UI for non-technical users
+- [ ] VS Code extension with `.pura` syntax highlighting
+
+---
+
+## About the Author
+
+**Sai Darsini Sathuluru**  
+B.Tech Student | Mohan Babu University | Generative AI Intern @ Prodigy InfoTech  
+Founder & Core Architect of PuraLang Engine
+
+- GitHub: [@SaiDarsini](https://github.com/SaiDarsini)
+
+
+---
+
+## License
+
+This project is licensed under the **MIT License** — you are free to use, modify, and distribute it.  
+See the [LICENSE](LICENSE) file for details.
+
+---
+
+<p align="center">
+  Built with ❤️ by Sai Darsini · If this helped you, please ⭐ the repo!
+</p>

puralang_engine-1.0.0/puralang/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

puralang_engine-1.0.0/puralang/cli.py

@@ -0,0 +1,25 @@
+import typer
+from puralang.core import run_pure_script, ask_ai_to_clean
+
+app = typer.Typer(help="PuraLang CLI Framework")
+
+@app.command()
+def run(script_path: str = typer.Argument(..., help="Path targeting your local .pura script file.")):
+    """Runs a local manual PuraLang script file."""
+    try:
+        with open(script_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        run_pure_script(content)
+    except Exception as e:
+        typer.secho(f"Compiler Error: {e}", fg=typer.colors.RED, bold=True)
+
+@app.command()
+def ask(prompt: str = typer.Argument(..., help="Describe your data cleaning goals in plain English.")):
+    """AI Mode: Describe your data cleaning goals in plain English."""
+    try:
+        ask_ai_to_clean(prompt)
+    except Exception as e:
+        typer.secho(f"AI Pipeline Execution Failure: {e}", fg=typer.colors.RED, bold=True)
+
+if __name__ == "__main__":
+    app()

puralang_engine-1.0.0/puralang/core.py

@@ -0,0 +1,154 @@
+import os
+import sys
+import pandas as pd
+from lark import Lark, Transformer
+from google import genai
+from google.genai import types
+from rich.console import Console
+from rich.table import Table
+
+puralang_grammar = """
+    start: pipeline
+    pipeline: load_stmt (pipe step_stmt)*
+    
+    load_stmt: "LOAD" ESCAPED_STRING
+    step_stmt: drop_dup | fill_null | format_str | filter_rows | rename_col | export_csv
+    
+    drop_dup: "DROP_DUPLICATES" ESCAPED_STRING
+    fill_null: "FILL_NULLS" ESCAPED_STRING "VALUE" (ESCAPED_STRING | NUMBER)
+    format_str: "FORMAT_STRINGS" ESCAPED_STRING "TO" CASE_ACTION
+    filter_rows: "FILTER_ROWS" ESCAPED_STRING OPERATOR NUMBER
+    rename_col: "RENAME_COLUMN" ESCAPED_STRING "TO" ESCAPED_STRING
+    export_csv: "EXPORT_CSV" ESCAPED_STRING
+    
+    pipe: "|>"
+    CASE_ACTION: "LOWERCASE" | "UPPERCASE"
+    OPERATOR: ">" | "<" | "==" | "!="
+    
+    %import common.ESCAPED_STRING
+    %import common.NUMBER
+    %import common.WS
+    %ignore WS
+"""
+
+class PuraTransformer(Transformer):
+    def __init__(self):
+        self.df = None
+        self.console = Console()
+        self.report = Table(title="PuraLang Execution Trace", show_header=True, header_style="bold cyan")
+        self.report.add_column("Pipeline Step", style="magenta")
+        self.report.add_column("Rows Before", style="yellow")
+        self.report.add_column("Rows After", style="green")
+
+    def load_stmt(self, items):
+        filename = items[0].strip('"')
+        if not os.path.exists(filename):
+            raise FileNotFoundError(f"Missing input dataset file: '{filename}'")
+        self.df = pd.read_csv(filename)
+        self.report.add_row("LOAD SOURCE DATA", "-", str(len(self.df)))
+        return self.df
+
+    def drop_dup(self, items):
+        col = items[0].strip('"')
+        before = len(self.df)
+        self.df = self.df.drop_duplicates(subset=[col])
+        self.report.add_row(f"DROP DUPLICATES [{col}]", str(before), str(len(self.df)))
+
+    def fill_null(self, items):
+        col = items[0].strip('"')
+        raw_val = items[1]
+        val = raw_val.strip('"') if hasattr(raw_val, 'type') and raw_val.type == "ESCAPED_STRING" else float(raw_val)
+        before = len(self.df)
+        self.df[col] = self.df[col].fillna(val)
+        self.report.add_row(f"FILL NULL FIELDS [{col}]", str(before), str(len(self.df)))
+
+    def format_str(self, items):
+        col = items[0].strip('"')
+        case_type = str(items[1]).strip()
+        before = len(self.df)
+        if "LOWERCASE" in case_type:
+            self.df[col] = self.df[col].astype(str).str.strip().str.lower()
+        else:
+            self.df[col] = self.df[col].astype(str).str.strip().str.upper()
+        self.report.add_row(f"STRING TRANSFORM [{col} -> {case_type}]", str(before), str(len(self.df)))
+
+    def filter_rows(self, items):
+        col = items[0].strip('"')
+        op = str(items[1]).strip()
+        val = float(items[2])
+        before = len(self.df)
+        
+        # Dynamic pandas evaluation bypass
+        if op == ">": self.df = self.df[self.df[col] > val]
+        elif op == "<": self.df = self.df[self.df[col] < val]
+        elif op == "==": self.df = self.df[self.df[col] == val]
+        elif op == "!=": self.df = self.df[self.df[col] != val]
+        
+        self.report.add_row(f"FILTER ROWS [{col} {op} {val}]", str(before), str(len(self.df)))
+
+    def rename_col(self, items):
+        old_col = items[0].strip('"')
+        new_col = items[1].strip('"')
+        before = len(self.df)
+        self.df = self.df.rename(columns={old_col: new_col})
+        self.report.add_row(f"RENAME COLUMN [{old_col} -> {new_col}]", str(before), str(len(self.df)))
+
+    def export_csv(self, items):
+        filename = items[0].strip('"')
+        self.df.to_csv(filename, index=False)
+        self.report.add_row(f"EXPORT COMPILED FILE", str(len(self.df)), str(len(self.df)))
+
+    def pipeline(self, items):
+        self.console.print(self.report)
+        return self.df
+
+def run_pure_script(script_content: str):
+    parser = Lark(puralang_grammar, start='start')
+    tree = parser.parse(script_content)
+    transformer = PuraTransformer()
+    transformer.transform(tree)
+
+def ask_ai_to_clean(user_prompt: str):
+    api_key = os.getenv("GEMINI_API_KEY")
+    if not api_key:
+        print("❌ Error: GEMINI_API_KEY environment variable is not set.")
+        sys.exit(1)
+
+    client = genai.Client(api_key=api_key)
+    
+    system_instruction = """
+    You are the natural language translation engine for PuraLang, a data-cleaning DSL.
+    Your sole job is to translate a user's plain English cleaning request into a valid PuraLang script.
+    
+    VALID KEYWORDS AND SYNTAX:
+    LOAD "filename.csv"
+      |> DROP_DUPLICATES "column_name"
+      |> FILL_NULLS "column_name" VALUE 20
+      |> FORMAT_STRINGS "column_name" TO LOWERCASE
+      |> FILTER_ROWS "column_name" > 50
+      |> RENAME_COLUMN "old_name" TO "new_name"
+      |> EXPORT_CSV "output.csv"
+      
+    CRITICAL INSTRUCTIONS:
+    - Respond ONLY with the raw PuraLang code script. 
+    - Do NOT include markdown code blocks like ```text or ```puralang.
+    - Do NOT write any conversational filler text.
+    """
+
+    print("🤖 Consulting PuraLang AI Agent...")
+    response = client.models.generate_content(
+        model='gemini-2.5-flash',
+        contents=f"Translate this cleaning request into PuraLang code:\n\n{user_prompt}",
+        config=types.GenerateContentConfig(
+            system_instruction=system_instruction,
+            temperature=0.1
+        )
+    )
+    
+    generated_code = response.text.strip()
+    
+    console = Console()
+    console.print("\n[bold green]✨ AI Generated PuraLang Script Layout:[/bold green]")
+    console.print(f"[dim]{generated_code}[/dim]\n")
+    
+    run_pure_script(generated_code)

puralang_engine-1.0.0/puralang_engine.egg-info/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: puralang_engine
+Version: 1.0.0
+Summary: An AI-driven domain-specific language engine for automated data cleaning pipelines.
+Home-page: https://github.com/SaiDarsini/puralang_engine
+Author: Sai Darsini
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lark
+Requires-Dist: rich
+Requires-Dist: pandas
+Requires-Dist: typer
+Requires-Dist: google-genai
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PuraLang Engine 🚀
+
+> **An AI-powered Domain-Specific Language for automated data cleaning pipelines.**  
+> Describe your data problem in plain English — PuraLang writes and runs the pipeline for you.
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-0.1.0-blue?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/python-3.8+-green?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/license-MIT-orange?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/status-active-brightgreen?style=for-the-badge" />
+</p>
+
+---
+
+## What is PuraLang?
+
+PuraLang is a custom programming language built specifically for **data cleaning**. Instead of writing 30–50 lines of Python/Pandas code every time you need to clean a dataset, you write a clean, human-readable `.pura` script — or better yet, just **describe what you want in English** and let the AI generate the script for you.
+
+### The Problem It Solves
+
+Every data engineer and ML practitioner spends hours writing repetitive boilerplate code like this:
+
+```python
+import pandas as pd
+df = pd.read_csv("users.csv")
+df = df.drop_duplicates(subset=["user_id"])
+df["age"] = df["age"].fillna(24)
+df["email"] = df["email"].str.strip().str.lower()
+df.to_csv("clean_users.csv", index=False)
+```
+
+With PuraLang, the same result is achieved in 5 readable lines:
+
+```
+LOAD "users.csv"
+  |> DROP_DUPLICATES "user_id"
+  |> FILL_NULLS "age" VALUE 24
+  |> FORMAT_STRINGS "email" TO LOWERCASE
+  |> EXPORT_CSV "clean_users.csv"
+```
+
+And with **AI Mode**, you don't even need to write that:
+
+```bash
+puralang ask "clean users.csv — remove duplicate user IDs, fill missing ages with 24, lowercase all emails"
+```
+
+---
+
+## Features
+
+- **Custom DSL Syntax** — Clean, readable pipeline syntax with `|>` operators
+- **AI Mode** — Describe your cleaning task in plain English; the engine generates and runs the script automatically
+- **Visual Execution Trace** — Beautiful terminal output showing row counts before and after every operation
+- **Multiple Operations** — DROP_DUPLICATES, FILL_NULLS, FORMAT_STRINGS, FILTER_ROWS, EXPORT_CSV
+- **Zero Boilerplate** — No Pandas knowledge required to use it
+
+---
+
+## Installation
+
+```bash
+pip install puralang-engine
+```
+
+Or clone and run locally:
+
+```bash
+git clone https://github.com/SaiDarsini/puralang_engine.git
+cd puralang_engine
+pip install -r requirements.txt
+```
+
+---
+
+## Quick Start
+
+### Manual Mode — Write a `.pura` script
+
+Create a file called `pipeline.pura`:
+
+```
+LOAD "dirty_data.csv"
+  |> DROP_DUPLICATES "user_id"
+  |> FILL_NULLS "age" VALUE 24
+  |> FORMAT_STRINGS "email" TO LOWERCASE
+  |> EXPORT_CSV "cleaned_output.csv"
+```
+
+Run it:
+
+```bash
+puralang run pipeline.pura
+```
+
+### AI Mode — Describe it in English
+
+```bash
+puralang ask "load sales.csv, remove duplicate order IDs, fill missing prices with 0, export to clean_sales.csv"
+```
+
+PuraLang will:
+1. Send your description to an AI model
+2. Show you the generated `.pura` script
+3. Execute it automatically
+4. Print the trace report
+
+---
+
+## Execution Output
+
+Every pipeline run produces a visual trace table in your terminal:
+
+```
+ ┌─────────────────────────── PuraLang Execution Trace ───────────────────────────┐
+ │ Operation                      │ Rows Before │ Rows After │
+ ├────────────────────────────────┼─────────────┼────────────┤
+ │ LOAD SOURCE DATA               │ -           │ 4          │
+ │ DROP DUPLICATES [user_id]      │ 4           │ 3          │
+ │ FILL NULL FIELDS [age]         │ 3           │ 3          │
+ │ STRING TRANSFORM [email]       │ 3           │ 3          │
+ │ EXPORT COMPILED FILE           │ 3           │ 3          │
+ └────────────────────────────────┴─────────────┴────────────┘
+```
+
+---
+
+## Supported Operations
+
+| Operation | Syntax | Description |
+|-----------|--------|-------------|
+| Load CSV | `LOAD "file.csv"` | Load a CSV file into the pipeline |
+| Drop Duplicates | `DROP_DUPLICATES "column"` | Remove duplicate rows based on a column |
+| Fill Nulls | `FILL_NULLS "column" VALUE 0` | Fill missing values with a default |
+| Format Strings | `FORMAT_STRINGS "column" TO LOWERCASE` | Normalize text casing |
+| Filter Rows | `FILTER_ROWS "column" GREATER_THAN 18` | Filter rows by condition |
+| Export CSV | `EXPORT_CSV "output.csv"` | Save cleaned data to a new file |
+
+---
+
+## Project Architecture
+
+```
+puralang_engine/
+│
+├── puralang/
+│   ├── __init__.py       # Package version
+│   ├── core.py           # Lark grammar, parser, and transformer engine
+│   └── cli.py            # Typer CLI — run and ask commands
+│
+├── tests/
+│   └── sample.pura       # Example PuraLang script
+│
+├── setup.py              # PyPI packaging config
+└── README.md
+```
+
+The engine works in 3 stages:
+
+```
+.pura script → [Lark Parser] → Abstract Syntax Tree → [Transformer] → Pandas execution → Clean CSV
+```
+
+For AI Mode:
+
+```
+English prompt → [LLM API] → .pura script → [Engine] → Clean CSV
+```
+
+---
+
+## Tech Stack
+
+- **Lark** — Grammar definition and parsing
+- **Pandas** — Underlying data manipulation engine
+- **Rich** — Beautiful terminal output and trace tables
+- **Typer** — CLI command interface
+- **Google Gemini API** — AI script generation (AI Mode)
+
+---
+
+## Roadmap
+
+- [x] Core DSL parser and transformer
+- [x] CLI with `run` command
+- [x] AI Mode with `ask` command
+- [x] Visual execution trace table
+- [ ] PyPI public release (`pip install puralang-engine`)
+- [ ] Support for JSON and Excel input formats
+- [ ] Web UI for non-technical users
+- [ ] VS Code extension with `.pura` syntax highlighting
+
+---
+
+## About the Author
+
+**Sai Darsini Sathuluru**  
+B.Tech Student | Mohan Babu University | Generative AI Intern @ Prodigy InfoTech  
+Founder & Core Architect of PuraLang Engine
+
+- GitHub: [@SaiDarsini](https://github.com/SaiDarsini)
+
+
+---
+
+## License
+
+This project is licensed under the **MIT License** — you are free to use, modify, and distribute it.  
+See the [LICENSE](LICENSE) file for details.
+
+---
+
+<p align="center">
+  Built with ❤️ by Sai Darsini · If this helped you, please ⭐ the repo!
+</p>

puralang_engine-1.0.0/puralang_engine.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+setup.py
+puralang/__init__.py
+puralang/cli.py
+puralang/core.py
+puralang_engine.egg-info/PKG-INFO
+puralang_engine.egg-info/SOURCES.txt
+puralang_engine.egg-info/dependency_links.txt
+puralang_engine.egg-info/entry_points.txt
+puralang_engine.egg-info/requires.txt
+puralang_engine.egg-info/top_level.txt

puralang_engine-1.0.0/puralang_engine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

puralang_engine-1.0.0/puralang_engine.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pura = puralang.cli:app

puralang_engine-1.0.0/puralang_engine.egg-info/requires.txt

@@ -0,0 +1,5 @@
+lark
+rich
+pandas
+typer
+google-genai

puralang_engine-1.0.0/puralang_engine.egg-info/top_level.txt

@@ -0,0 +1 @@
+puralang

puralang_engine-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

puralang_engine-1.0.0/setup.py

@@ -0,0 +1,38 @@
+import os
+from setuptools import setup, find_packages
+
+# Safely read the README file using UTF-8 encoding to avoid Windows charmap errors
+if os.path.exists("README.md"):
+    with open("README.md", "r", encoding="utf-8") as fh:
+        long_description = fh.read()
+else:
+    long_description = ""
+
+setup(
+    name="puralang_engine",
+    version="1.0.0",
+    author="Sai Darsini",
+    description="An AI-driven domain-specific language engine for automated data cleaning pipelines.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/SaiDarsini/puralang_engine",
+    packages=find_packages(),
+    install_requires=[
+        "lark",
+        "rich",
+        "pandas",
+        "typer",
+        "google-genai"
+    ],
+    entry_points={
+        "console_scripts": [
+            "pura=puralang.cli:app",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.9",
+)