sqlshell 0.4.4__py3-none-any.whl

sqlshell-0.4.4.dist-info/METADATA

@@ -0,0 +1,441 @@
+Metadata-Version: 2.4
+Name: sqlshell
+Version: 0.4.4
+Summary: A powerful SQL shell with GUI interface for data analysis
+Author: SQLShell Team
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/oyvinrog/SQLShell
+Keywords: sql,data analysis,gui,duckdb
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: PyQt6>=6.4.0
+Requires-Dist: duckdb>=0.9.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: fastparquet>=2023.10.1
+Requires-Dist: xlrd>=2.0.1
+Requires-Dist: deltalake
+Requires-Dist: scikit-learn
+Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: scipy>=1.15.0
+Requires-Dist: seaborn>=0.13.0
+Requires-Dist: nltk>=3.8.1
+Requires-Dist: psutil>=5.9.0
+
+# SQLShell
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/oyvinrog/SQLShell/main/assets/images/sqlshell_logo.png" alt="SQLShell Logo" width="180" height="auto">
+
+**A fast SQL interface for analyzing data files ✨**
+
+*Query CSV, Parquet, Excel files with SQL • DuckDB powered • No database setup required*
+
+[![GitHub Release](https://img.shields.io/github/v/release/oyvinrog/SQLShell)](https://github.com/oyvinrog/SQLShell/releases/latest)
+[![PyPI version](https://badge.fury.io/py/sqlshell.svg)](https://badge.fury.io/py/sqlshell)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://pepy.tech/badge/sqlshell)](https://pepy.tech/project/sqlshell)
+
+<img src="https://raw.githubusercontent.com/oyvinrog/SQLShell/main/assets/images/sqlshell_demo.png" alt="SQLShell Interface" width="80%" height="auto">
+
+[📥 Download](https://github.com/oyvinrog/SQLShell/releases/latest) • [🚀 Install](#-quick-install) • [📖 Examples](https://github.com/oyvinrog/SQLShell/wiki/Guides) • [🤝 Contribute](#-contributing)
+
+
+
+</div>
+
+---
+
+
+
+##  What SQLShell Does
+
+**SQLShell is a desktop SQL interface specifically designed for analyzing data files.** It's not a database client - instead, it lets you load CSV, Parquet, Excel, and other data files and query them with SQL using DuckDB's fast analytical engine.
+
+### 🔥 Key Features
+
+<table>
+<tr>
+<td width="33%">
+
+**⚡ Fast File Analysis**
+Load data files and search through millions of rows quickly. Built on DuckDB for analytical performance.
+
+</td>
+<td width="33%">
+
+**🎯 Smart Execution**
+`F5` runs all queries, `F9` runs current statement. Simple keyboard shortcuts for iterative analysis.
+
+</td>
+<td width="33%">
+
+**🧠 SQL Autocompletion**
+Context-aware suggestions that understand your loaded tables and column names.
+
+</td>
+</tr>
+</table>
+
+### 📁 **File-Based Data Analysis**
+
+**Important**: SQLShell works with data files, not live databases. It's designed for:
+
+- **📊 Data Files** - CSV, Parquet, Excel, TSV, JSON files
+- **🗃️ Local Analysis** - Load files from your computer for SQL analysis  
+- **⚡ Fast Queries** - DuckDB engine optimized for analytical workloads
+- **🔍 Data Exploration** - Search and filter capabilities across your datasets
+
+**Not supported**: Live database connections (MySQL, PostgreSQL, etc.). Use dedicated database clients for those.
+
+### 💫 What Makes SQLShell Useful
+
+- **🏎️ DuckDB Powered** - Fast analytical queries on data files
+- **📊 Multiple File Formats** - CSV, Parquet, Excel, Delta, TSV, JSON support
+- **🎨 Clean Interface** - Simple SQL editor with result display
+- **🔍 Search Functionality** - Find data across result sets quickly
+- **🚀 Zero Database Setup** - No server installation or configuration needed
+
+---
+
+## 🚀 Quick Install
+
+### 📥 Download (Recommended)
+
+Pre-built executables — **no Python installation required**:
+
+| Platform | Download | Install |
+|----------|----------|---------|
+| 🪟 **Windows** | [SQLShell Installer (.exe)](https://github.com/oyvinrog/SQLShell/releases/latest) | Run the installer |
+| 🐧 **Linux (Debian/Ubuntu)** | [SQLShell (.deb)](https://github.com/oyvinrog/SQLShell/releases/latest) | `sudo dpkg -i sqlshell_*.deb` |
+
+👉 [**View all releases**](https://github.com/oyvinrog/SQLShell/releases)
+
+---
+
+### 🐍 Install via pip
+
+Alternatively, install with pip if you have Python:
+
+```bash
+pip install sqlshell
+sqls
+```
+
+**That's it!** 🎉 SQLShell opens and you can start loading data files.
+
+<details>
+<summary><b>🐧 Linux Users - One-Time Setup for Better Experience</b></summary>
+
+```bash
+# Create dedicated environment (recommended)
+python3 -m venv ~/.venv/sqlshell
+source ~/.venv/sqlshell/bin/activate
+pip install sqlshell
+
+# Add convenient alias
+echo 'alias sqls="~/.venv/sqlshell/bin/sqls"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+</details>
+
+<details>
+<summary><b>💻 Alternative Launch Methods</b></summary>
+
+If `sqls` doesn't work immediately:
+```bash
+python -c "import sqlshell; sqlshell.start()"
+```
+
+</details>
+
+---
+
+## ⚡ Getting Started
+
+1. **Launch**: `sqls` 
+2. **Load Data**: Click "Load Files" to import your CSV, Parquet, or Excel files
+3. **Query**: Write SQL queries against your loaded data
+4. **Execute**: Hit `Ctrl+Enter` or `F5` to run queries
+5. **Search**: Press `Ctrl+F` to search through results
+
+<div align="center">
+<img src="https://github.com/oyvinrog/SQLShell/blob/main/assets/images/sqlshell_angle.gif?raw=true" alt="SQLShell Live Demo" width="60%" height="auto">
+</div>
+
+---
+
+## 🔍 Search and Filter Features
+
+### ⚡ **Result Search with Ctrl+F**
+
+Once you have query results, use `Ctrl+F` to search across all columns:
+
+- **Cross-column search** - Finds terms across all visible columns
+- **Case-insensitive** - Flexible text matching
+- **Instant feedback** - Filter results as you type
+- **Numeric support** - Search numbers and dates
+
+### 💪 **Practical Use Cases**
+
+| Use Case | Search Term | What It Finds |
+|----------|-------------|---------------|
+| **Error Analysis** | `"error"` | Error messages in log files |
+| **Data Quality** | `"null"` | Missing data indicators |
+| **ID Tracking** | `"CUST_12345"` | Specific customer records |
+| **Pattern Matching** | `"*.com"` | Email domains |
+
+**Workflow**: Load file → Query data → `Ctrl+F` → Search → `ESC` to clear
+
+---
+
+## 🤖 Data Analysis Features
+
+### 🔮 **Text Encoding**
+Right-click text columns to create binary indicator columns for analysis:
+
+```sql
+-- Original data
+SELECT category FROM products;
+-- "Electronics", "Books", "Clothing"
+
+-- After encoding
+SELECT 
+    category_Electronics,
+    category_Books,
+    category_Clothing
+FROM products_encoded;
+```
+
+### 📊 **Column Analysis**
+Right-click columns for quick statistical analysis and correlation insights.
+
+---
+
+## 🚀 Power User Features
+
+### ⚡ F5/F9 Quick Execution
+- **`F5`** - Execute all SQL statements in sequence
+- **`F9`** - Execute only the current statement (where cursor is positioned)
+- **Useful for**: Testing queries step by step
+
+### 🧠 SQL Autocompletion
+- Press `Ctrl+Space` for suggestions
+- **After SELECT**: Available columns from loaded tables
+- **After FROM/JOIN**: Loaded table names
+- **After WHERE**: Column names with appropriate operators
+
+### 📊 File Format Support
+SQLShell can load and query:
+- **CSV/TSV** - Comma and tab-separated files
+- **Parquet** - Column-oriented format
+- **Excel** - .xlsx and .xls files  
+- **JSON** - Structured JSON data
+- **Delta** - Delta Lake format files
+
+---
+
+## 📝 Query Examples
+
+### Basic File Analysis
+```sql
+-- Load and explore your CSV data
+SELECT * FROM my_data LIMIT 10;
+
+-- Aggregate analysis
+SELECT 
+    category,
+    AVG(price) as avg_price,
+    COUNT(*) as count
+FROM sales_data 
+GROUP BY category
+ORDER BY avg_price DESC;
+```
+
+### Multi-File Analysis
+```sql
+-- Join data from multiple loaded files
+SELECT 
+    c.customer_name,
+    SUM(o.order_total) as total_spent
+FROM customers c
+JOIN orders o ON c.customer_id = o.customer_id
+GROUP BY c.customer_name
+ORDER BY total_spent DESC
+LIMIT 10;
+```
+
+---
+
+## 🎯 Perfect For
+
+<table>
+<tr>
+<td width="50%">
+
+**📊 Data Analysts**
+- Quick file exploration
+- CSV/Excel analysis
+- Report generation from files
+- Data quality checking
+
+**🔬 Data Scientists**
+- Dataset exploration
+- Feature analysis
+- Data preparation
+- Quick prototyping
+
+</td>
+<td width="50%">
+
+**💼 Business Analysts**
+- Spreadsheet analysis with SQL
+- KPI calculations from files
+- Trend analysis
+- Data validation
+
+**🛠️ Developers**
+- Log file analysis
+- CSV processing
+- Data transformation
+- File-based testing
+
+</td>
+</tr>
+</table>
+
+---
+
+## 📋 Requirements
+
+- **Python 3.8+** 
+- **Auto-installed dependencies**: PyQt6, DuckDB, Pandas, NumPy
+
+**System Requirements**: SQLShell is a desktop application that works on Windows, macOS, and Linux.
+
+---
+
+## 💡 Tips for Better Productivity
+
+<table>
+<tr>
+<td width="50%">
+
+### ⌨️ **Keyboard Shortcuts**
+- `Ctrl+F` → Search results
+- `F5` → Run all statements  
+- `F9` → Run current statement
+- `Ctrl+Enter` → Quick execute
+- `ESC` → Clear search
+
+</td>
+<td width="50%">
+
+### 🎯 **Efficient File Loading**
+- Drag & drop files into the interface
+- Use "Load Files" button for selection
+- Load multiple related files for joins
+- Supported: CSV, Parquet, Excel, JSON, Delta
+
+</td>
+</tr>
+</table>
+
+### 🚀 **Typical Workflow**
+1. **Load files** (drag & drop or Load Files button)
+2. **Explore structure** (`SELECT * FROM table_name LIMIT 5`)
+3. **Build analysis** (use F9 to test statements)
+4. **Search results** (Ctrl+F for specific data)
+5. **Export findings** (copy results or save queries)
+
+---
+
+## 🔧 Advanced Features
+
+<details>
+<summary><b>📊 Table Analysis Tools</b></summary>
+
+Right-click loaded tables for:
+
+- **Column profiling** - Data types, null counts, unique values
+- **Quick statistics** - Min, max, average for numeric columns
+- **Sample data preview** - Quick look at table contents
+
+</details>
+
+<details>
+<summary><b>🔮 Column Operations</b></summary>
+
+Right-click column headers in results:
+
+- **Text encoding** - Create binary columns from categories
+- **Statistical summary** - Distribution and correlation info
+- **Data type conversion** - Format suggestions
+
+</details>
+
+<details>
+<summary><b>⚡ Performance Tips</b></summary>
+
+- **File format matters** - Parquet files load faster than CSV
+- **Use LIMIT** - for initial exploration of large files
+- **Column selection** - Select only needed columns for better performance
+- **Indexing** - DuckDB automatically optimizes common query patterns
+
+</details>
+
+---
+
+## 🤝 Contributing
+
+SQLShell is open source and welcomes contributions!
+
+```bash
+git clone https://github.com/oyvinrog/SQLShell.git
+cd SQLShell
+pip install -e .
+```
+
+**Ways to contribute:**
+- 🐛 Report bugs and issues
+- 💡 Suggest new features  
+- 📖 Improve documentation
+- 🔧 Submit pull requests
+- ⭐ Star the repo to show support
+
+---
+
+## 📄 License
+
+MIT License - feel free to use SQLShell in your projects!
+
+---
+
+<div align="center">
+
+**Ready to analyze your data files with SQL?**
+
+[📥 **Download for Windows/Linux**](https://github.com/oyvinrog/SQLShell/releases/latest) or install via pip:
+
+```bash
+pip install sqlshell && sqls
+```
+
+⭐ **Star us on GitHub** if SQLShell helps with your data analysis!
+
+[📥 Download](https://github.com/oyvinrog/SQLShell/releases/latest) • [🚀 Get Started](#-quick-install) • [📖 Documentation](#-getting-started) • [🐛 Report Issues](https://github.com/oyvinrog/SQLShell/issues)
+
+*A simple tool for SQL-based file analysis*
+
+</div>

sqlshell-0.4.4.dist-info/RECORD

@@ -0,0 +1,54 @@
+sqlshell/__init__.py,sha256=Iq8oHAySksHa_LRXQPTEIW4zx-ucxtLJrAs-Op96UHo,2831
+sqlshell/__main__.py,sha256=sss855aeTUxSu3_1K0-WpSXyjc-PWzxdHGtoa_OrnXk,228867
+sqlshell/ai_autocomplete.py,sha256=3Jn-vcD1dNTohzeMt1c4vqJmg4nxXHZJPjrccvX2dVk,14708
+sqlshell/ai_settings_dialog.py,sha256=JSlTbojF8Bgq2B5Ynz96DtBKEQboym4wXJREyBj5dtY,11887
+sqlshell/context_suggester.py,sha256=x_DIrsPhghdPgJPN2xQ7FGIPYVTAJHKWd_BQBSVAj6E,34131
+sqlshell/create_test_data.py,sha256=mPbuzwgDlocgFf0VHxemyRs277y9iqKDhGeseZMkQcU,6596
+sqlshell/editor.py,sha256=ICd5ajTpITQjxEAz7AakNy7bEcvJN1akq0nVxwxtinY,51357
+sqlshell/editor_integration.py,sha256=sZSSwd0vsuV2qlRG1IUlw67y7902Hm75U63YbjKvmWo,4531
+sqlshell/execution_handler.py,sha256=7IwVQz1GiMlXERmdP7CNLtH3SPcjzWon_ywi7vpecz0,15466
+sqlshell/menus.py,sha256=gjxSZrQsE1fgi2vaqf1Af_jBuDaekhd5d-Gxsxyo8Es,8809
+sqlshell/notification_manager.py,sha256=gZAARnZFV-tklOXGickpyd19T8UOxEf3howFc0DgqWs,14318
+sqlshell/query_tab.py,sha256=4JPcyBoxolDHdPCzlKJiQVowKKXrc00x2-ubvmfBlYk,41906
+sqlshell/space_invaders.py,sha256=_i1-VI6GIqZGzKkhQzMutO--7QgZZ6vZ0UBb0VuKxD8,16900
+sqlshell/splash_screen.py,sha256=K0Ku_nXJWmWSnVEh2OttIthRZcnUoY_tmjIAWIWLm7Y,17604
+sqlshell/sqlshell_demo.png,sha256=dPp9J1FVqQVfrh-gekosuha2Jw2p2--wxbOmt2kr7fg,133550
+sqlshell/styles.py,sha256=EGA_Ow-XerPEQgj82ts3fnqkEPMcjSlJPblbPu9L__s,7135
+sqlshell/suggester_integration.py,sha256=22vV_ex-7qeMx8OnVBTQ1-EH8EdUMMdLmZmtLV4gLCI,15605
+sqlshell/syntax_highlighter.py,sha256=2QwMnuuKzQZyFry8qiX3MD3KWO2-dPgIVapa5rJuqp8,6240
+sqlshell/table_list.py,sha256=0V2vQXjah8uWdRaRcB0w9WzclaFX5HulCUmmJEjUW8k,41585
+sqlshell/widgets.py,sha256=Ue9zIpDWYKhgfe5EjvDA3NVbgzW2N9z-QPsuISFGJJ4,19178
+sqlshell/data/create_test_data.py,sha256=sUTcf50V8-bVwYV2VNTLK65c-iHiU4wb99By67I10zM,5404
+sqlshell/db/__init__.py,sha256=ww-pZ0_ucFwXpR5KkkLI-heV06tU7FrO6TwuYaCuTKQ,222
+sqlshell/db/database_manager.py,sha256=MPOL4rb8zhFJyvd95WtovHcnyGP2HYAnWHM5T_lK2gg,59061
+sqlshell/db/export_manager.py,sha256=jDXzF6MSTTcXJBt2w-GlYzlDQDMN3bcctJNX1zBgFpc,7433
+sqlshell/resources/__init__.py,sha256=VLTJ_5pUHhctRiV8UZDvG-jnsjgT6JQvW-ZPzIJqBIY,44
+sqlshell/resources/icon.png,sha256=PcT469bK-GaC6Ws1MwXvN_8y2fUn9LioSnZcXPq59W8,3410
+sqlshell/resources/logo_large.png,sha256=pjLs6kXCy8gW8Iiq1gb6ZLnJEQ7_2GxtoJ_HDZ0_ERQ,31080
+sqlshell/resources/logo_medium.png,sha256=brEV-YLgKS4RSxdZBgrwq_MvMA9zpsYvvvWgchUdjK4,14087
+sqlshell/resources/logo_small.png,sha256=X4oQwj1k4OTbY785hWUIR12f1yAduV-USNzEu7aqkHs,6677
+sqlshell/resources/splash_screen.gif,sha256=H24DQBdK1EsqQTWZkgInjM5ouOzY4cMesUoza10auNg,3070484
+sqlshell/sqlshell/__init__.py,sha256=6Wp5nabfTzH5rkC-2jYo_ZjCuw8utmj21Jpy8vBuliI,100
+sqlshell/sqlshell/create_test_data.py,sha256=TFXgWeK1l3l_c4Dg38yS8Df4sBUfOZcBucXngtpThvk,4624
+sqlshell/sqlshell/create_test_databases.py,sha256=oqryFJJahqLFsAjBFM4r9Fe1ea7djDcRpT9U_aBf7PU,3573
+sqlshell/ui/__init__.py,sha256=2CsTDAvRZJ99gkjs3-rdwkxyGVAKXX6ueOhPdP1VXQc,206
+sqlshell/ui/bar_chart_delegate.py,sha256=tbtIt2ZqPIcYWNJzpONpYa0CYURkLdjkg23TI7TmOKY,1881
+sqlshell/ui/filter_header.py,sha256=qN8fkyB0gz5YCcNPnwFE-orKvFJB9DbtBEkHRdL_4R0,20212
+sqlshell/utils/__init__.py,sha256=-Fmydv-HfRNywlLudcrlyy7RIZsxSHCOLDQ2AR1TnVg,375
+sqlshell/utils/profile_cn2.py,sha256=iffsKyVJ8lVdb9sHZBDvoYqr7gySaXAJbOCKqRfW6Zk,61099
+sqlshell/utils/profile_column.py,sha256=e1pLHoZy-c1066nUgoEVXuFvi9PAPwLKdoeJDQNmevM,119043
+sqlshell/utils/profile_distributions.py,sha256=_uns_fLoA2ac3oiMIh6spG1nDqM4RFCe_UnzozPrL3A,25482
+sqlshell/utils/profile_entropy.py,sha256=pJTcXlBkSEPzL3Fvxizf5gBkw6IsUjfa9Y6MjAqF1do,13238
+sqlshell/utils/profile_foreign_keys.py,sha256=ri1UXYc4Es3u4PabM1YdSEeDt63o4SSkVX_qJwOiwFE,33949
+sqlshell/utils/profile_keys.py,sha256=-lhTqs6mHCkr-7I6JIXCzTyICmgY38BvFwiPwTbU4cE,116235
+sqlshell/utils/profile_ohe.py,sha256=pLWmNabLtXuiPp2pHd7bRoRRpLWcl62j8U-axlmxsec,37821
+sqlshell/utils/profile_ohe_advanced.py,sha256=R8aVAeMS_drOJhRhdQO-vcf6YVM818Freg6N8wQK_1U,30044
+sqlshell/utils/profile_ohe_comparison.py,sha256=MNgX7b357gFmtia1ih5Iw06s2olMyjZ0s9Kx0yeG48Y,9916
+sqlshell/utils/profile_prediction.py,sha256=hUjrYmdlySgAIiEQ8uw_uNUkEXwILSitZbxAlrZZpZ0,38233
+sqlshell/utils/profile_similarity.py,sha256=tkitvxT2au_UTkmJcUKQ-b2Ug7bKiAB7-5aSGXWmGUs,33439
+sqlshell/utils/search_in_df.py,sha256=wbfyCcnXPRfEhzv_h0YtXxvJXLvoL9QEaI2EJoxJzDI,3327
+sqlshell-0.4.4.dist-info/METADATA,sha256=7o-GP3V_r0BquyuI4bAFtM2jVsvh_XIQA_V_pABXOfU,11863
+sqlshell-0.4.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sqlshell-0.4.4.dist-info/entry_points.txt,sha256=lt4HuxPR0dapNeGxI5ZjMnFDvt3spmKsnT1G7YTpDV8,48
+sqlshell-0.4.4.dist-info/top_level.txt,sha256=ahwsMFhvAqI97ZkT2xvHL5iZCO1p13mNiUOFkdSFwms,9
+sqlshell-0.4.4.dist-info/RECORD,,

sqlshell-0.4.4.dist-info/WHEEL

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

sqlshell-0.4.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sqls = sqlshell.__main__:main

sqlshell-0.4.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+sqlshell