exlsql 0.1.0__tar.gz

exlsql-0.1.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: exlsql
+Version: 0.1.0
+Summary: SQL-like queries for Excel files
+Author: royal-egoh
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# exlsql
+
+Query Excel files using SQL syntax. Pass a SQL string and an `.xlsx` file — get a filtered, queried Excel file back.
+
+---
+
+## Installation
+
+```bash
+pip install exlsql
+```
+
+---
+
+## Usage
+
+```python
+from exlsql import Query
+
+q = Query("SELECT name, age FROM Sheet1 WHERE age > 30", excel_file="data.xlsx")
+parsed = q.parse()
+output = q.to_excel(parsed)
+
+print(output)  # data_output.xlsx
+```
+
+---
+
+## Supported Syntax
+
+| Feature | Example |
+|---|---|
+| Select columns | `SELECT name, age FROM Sheet1` |
+| Select all | `SELECT * FROM Sheet1` |
+| Filter rows | `WHERE age > 30` |
+| Multiple conditions | `WHERE age > 30 AND city = 'Lagos'` |
+| Column names with spaces | `SELECT "first name" FROM Sheet1` |
+
+---
+
+## Notes
+
+- `FROM` refers to the **sheet name** inside the Excel file
+- Only `.xlsx` files are supported
+- The output is written to a new file — e.g. `data.xlsx` → `data_output.xlsx`
+- String values in `WHERE` must be wrapped in single quotes: `city = 'New York'`
+
+---
+
+## Requirements
+
+- pandas
+- openpyxl

exlsql-0.1.0/README.md

@@ -0,0 +1,53 @@
+# exlsql
+
+Query Excel files using SQL syntax. Pass a SQL string and an `.xlsx` file — get a filtered, queried Excel file back.
+
+---
+
+## Installation
+
+```bash
+pip install exlsql
+```
+
+---
+
+## Usage
+
+```python
+from exlsql import Query
+
+q = Query("SELECT name, age FROM Sheet1 WHERE age > 30", excel_file="data.xlsx")
+parsed = q.parse()
+output = q.to_excel(parsed)
+
+print(output)  # data_output.xlsx
+```
+
+---
+
+## Supported Syntax
+
+| Feature | Example |
+|---|---|
+| Select columns | `SELECT name, age FROM Sheet1` |
+| Select all | `SELECT * FROM Sheet1` |
+| Filter rows | `WHERE age > 30` |
+| Multiple conditions | `WHERE age > 30 AND city = 'Lagos'` |
+| Column names with spaces | `SELECT "first name" FROM Sheet1` |
+
+---
+
+## Notes
+
+- `FROM` refers to the **sheet name** inside the Excel file
+- Only `.xlsx` files are supported
+- The output is written to a new file — e.g. `data.xlsx` → `data_output.xlsx`
+- String values in `WHERE` must be wrapped in single quotes: `city = 'New York'`
+
+---
+
+## Requirements
+
+- pandas
+- openpyxl

exlsql-0.1.0/exlsql/__init__.py

@@ -0,0 +1 @@
+from app import Query

exlsql-0.1.0/exlsql/app.py

@@ -0,0 +1,92 @@
+import pandas as pd
+import re
+import os
+
+
+class Query:
+    def __init__(self, sql, excel_file=None):
+        if not excel_file or not excel_file.endswith(".xlsx") :
+            raise ValueError("Wrong file type, must be .xlsx")
+        self.sql = sql
+        self.excel_file = excel_file
+
+    def parse(self):
+        try:
+            output = {'select': [], 'from': '', 'where': ''}
+            sql_string = self.sql
+            # words = sql_string.split()
+            words = words = re.findall(r'"[^"]*"|\'[^\']*\'|\S+', sql_string)
+            i = 0
+            while i < len(words):
+                if words[i].upper() == "SELECT":
+                    i += 1
+                    if i >= len(words):
+                        raise ValueError("Invalid SQL: incomplete SELECT clause")
+                    if words[i] == "FROM":
+                        output['select'].append("*")
+                        break
+                    while i < len(words) and words[i].upper() != "FROM":
+                        if words[i] == "*":
+                            output['select'].append(words[i])
+                            break
+                        clean_word = words[i].strip(",").strip('"').strip("'")
+                        output['select'].append(clean_word)
+                        i += 1
+
+                elif words[i].upper() == "FROM":
+                    i += 1
+                    if i < len(words):
+                        output['from'] = words[i]
+                        i += 1
+
+                elif words[i].upper() == "WHERE":
+                    i += 1
+                    condition = []
+                    while i < len(words):
+                        if words[i] in ("AND", "OR"):
+                            output['where'] += ' '.join(condition) + \
+                                ' ' + words[i] + ' '
+                            condition = []
+                        else:
+                            condition.append(words[i])
+                        i += 1
+                    if condition:
+                        output['where'] += ' '.join(condition)
+                    break
+                # elif words[i] == "ORDER":
+                #     while []
+                #     i+=1
+
+                else:
+                    i += 1
+            return output
+        except Exception as e:
+            raise ValueError(e)
+
+    # {'select': ['name', 'age'], 'from': 'users', 'where': "age > 30 AND city = 'New York'"}
+    def to_excel(self, parsed):
+        if not parsed['from']:
+            raise ValueError("Invalid sql syntax")
+        else:
+            file = pd.read_excel(self.excel_file, sheet_name=parsed['from'])
+        select_quer = []
+        # SELECT QUERY
+        if parsed['select'] == ['*'] or not parsed['select']:
+            pass
+        else:
+            for i in parsed['select']:
+                select_quer.append(f"{i}")
+            file = file[select_quer]
+
+        # WHERE QUERY
+        if parsed['where']:
+            parsed['where'] = re.sub(
+                r'(?<![<>!])=(?!=)', '==', parsed['where'])
+
+            file = file.query(parsed['where'])
+        # new file
+        name, ext = os.path.splitext(self.excel_file)
+        output_path = f"{name}_output{ext}"
+        file.to_excel(output_path, index=False)
+        
+        return output_path

exlsql-0.1.0/exlsql.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: exlsql
+Version: 0.1.0
+Summary: SQL-like queries for Excel files
+Author: royal-egoh
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# exlsql
+
+Query Excel files using SQL syntax. Pass a SQL string and an `.xlsx` file — get a filtered, queried Excel file back.
+
+---
+
+## Installation
+
+```bash
+pip install exlsql
+```
+
+---
+
+## Usage
+
+```python
+from exlsql import Query
+
+q = Query("SELECT name, age FROM Sheet1 WHERE age > 30", excel_file="data.xlsx")
+parsed = q.parse()
+output = q.to_excel(parsed)
+
+print(output)  # data_output.xlsx
+```
+
+---
+
+## Supported Syntax
+
+| Feature | Example |
+|---|---|
+| Select columns | `SELECT name, age FROM Sheet1` |
+| Select all | `SELECT * FROM Sheet1` |
+| Filter rows | `WHERE age > 30` |
+| Multiple conditions | `WHERE age > 30 AND city = 'Lagos'` |
+| Column names with spaces | `SELECT "first name" FROM Sheet1` |
+
+---
+
+## Notes
+
+- `FROM` refers to the **sheet name** inside the Excel file
+- Only `.xlsx` files are supported
+- The output is written to a new file — e.g. `data.xlsx` → `data_output.xlsx`
+- String values in `WHERE` must be wrapped in single quotes: `city = 'New York'`
+
+---
+
+## Requirements
+
+- pandas
+- openpyxl

exlsql-0.1.0/exlsql.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+exlsql/__init__.py
+exlsql/app.py
+exlsql.egg-info/PKG-INFO
+exlsql.egg-info/SOURCES.txt
+exlsql.egg-info/dependency_links.txt
+exlsql.egg-info/requires.txt
+exlsql.egg-info/top_level.txt

exlsql-0.1.0/exlsql.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

exlsql-0.1.0/exlsql.egg-info/requires.txt

@@ -0,0 +1 @@
+pandas

exlsql-0.1.0/exlsql.egg-info/top_level.txt

@@ -0,0 +1 @@
+exlsql

exlsql-0.1.0/setup.cfg

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

exlsql-0.1.0/setup.py

@@ -0,0 +1,13 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="exlsql",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=["pandas"],
+    author="royal-egoh",
+    description="SQL-like queries for Excel files",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    python_requires=">=3.8",
+)