sqlshell 0.1.8__py3-none-any.whl → 0.2.0__py3-none-any.whl

sqlshell-0.2.0.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: sqlshell
+Version: 0.2.0
+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: pyarrow>=14.0.1
+Requires-Dist: fastparquet>=2023.10.1
+Requires-Dist: xlrd>=2.0.1
+Requires-Dist: deltalake
+Requires-Dist: Pillow>=10.0.0
+
+# SQLShell
+
+<div align="center">
+
+<img src="sqlshell_logo.png" alt="SQLShell Logo" width="180" height="auto">
+
+**A powerful SQL shell with GUI interface for data analysis**
+
+<img src="sqlshell_demo.png" alt="SQLShell Interface" width="80%" height="auto">
+
+</div>
+
+## 🚀 Key Features
+
+- **Interactive SQL Interface** - Rich syntax highlighting for enhanced query writing
+- **Context-Aware Suggestions** - Intelligent SQL autocompletion based on query context and schema
+- **DuckDB Integration** - Powerful analytical queries powered by DuckDB
+- **Multi-Format Support** - Import and query Excel (.xlsx, .xls), CSV, and Parquet files effortlessly
+- **Modern UI** - Clean, tabular results display with intuitive controls
+- **Table Preview** - Quick view of imported data tables
+- **Test Data Generation** - Built-in sample data for testing and learning
+- **Multiple Views** - Support for multiple concurrent table views
+- **Productivity Tools** - Streamlined workflow with keyboard shortcuts (e.g., Ctrl+Enter for query execution)
+
+## 📦 Installation
+
+### Using pip (Recommended)
+
+```bash
+pip install sqlshell
+```
+
+### Linux Setup with Virtual Environment
+
+```bash
+# Create and activate virtual environment
+python3 -m venv ~/.venv/sqlshell
+source ~/.venv/sqlshell/bin/activate
+
+# Install SQLShell
+pip install sqlshell
+
+# Configure shell alias
+echo 'alias sqls="~/.venv/sqlshell/bin/sqls"' >> ~/.bashrc  # or ~/.zshrc for Zsh
+source ~/.bashrc  # or source ~/.zshrc
+```
+
+### Development Installation
+
+```bash
+git clone https://github.com/oyvinrog/SQLShell.git
+cd SQLShell
+pip install -e .
+```
+
+## 🎯 Getting Started
+
+1. **Launch the Application**
+   ```bash
+   sqls
+   ```
+   
+   If the `sqls` command doesn't work (e.g., "access denied" on Windows), you can use this alternative:
+   ```bash
+   python -c "import sqlshell; sqlshell.start()"
+   ```
+
+2. **Database Connection**
+   - SQLShell automatically connects to a local DuckDB database named 'pool.db'
+
+3. **Working with Data Files**
+   - Click "Load Files" to select your Excel, CSV, or Parquet files
+   - File contents are loaded as queryable SQL tables
+   - Query using standard SQL syntax
+
+4. **Query Execution**
+   - Enter SQL in the editor
+   - Execute using Ctrl+Enter or the "Execute" button
+   - View results in the structured output panel
+
+5. **Test Data**
+   - Load sample test data using the "Test" button for quick experimentation
+   
+6. **Using Context-Aware Suggestions**
+   - Press Ctrl+Space to manually trigger suggestions
+   - Suggestions appear automatically as you type
+   - Context-specific suggestions based on your query position:
+     - After SELECT: columns and functions
+     - After FROM/JOIN: tables with join conditions
+     - After WHERE: columns with appropriate operators
+     - Inside functions: relevant column suggestions
+
+## 📝 Query Examples
+
+### Basic Join Operation
+```sql
+SELECT *
+FROM sample_sales_data cd
+INNER JOIN product_catalog pc ON pc.productid = cd.productid
+LIMIT 3;
+```
+
+### Multi-Statement Queries
+```sql
+-- Create a temporary view
+CREATE OR REPLACE TEMPORARY VIEW test_v AS
+SELECT *
+FROM sample_sales_data cd
+INNER JOIN product_catalog pc ON pc.productid = cd.productid;
+
+-- Query the view
+SELECT DISTINCT productid
+FROM test_v;
+```
+
+## 💡 Pro Tips
+
+- Use temporary views for complex query organization
+- Leverage keyboard shortcuts for efficient workflow
+- Explore the multi-format support for various data sources
+- Create multiple tabs for parallel query development
+- The context-aware suggestions learn from your query patterns
+- Type `table_name.` to see all columns for a specific table
+- After JOIN keyword, the system suggests relevant tables and join conditions
+
+## 📊 Column Profiler
+
+The Column Profiler provides quick statistical insights into your table columns:
+
+<img src="column_profiler.png" alt="Column Profiler" width="80%" height="auto">
+
+### Using the Column Profiler
+
+1. **Access the Profiler**
+   - Right-click on any table in the schema browser
+   - Select "Profile Table" from the context menu
+
+2. **View Column Statistics**
+   - Instantly see key metrics for each column:
+     - Data type
+     - Non-null count and percentage
+     - Unique values count
+     - Mean, median, min, and max values (for numeric columns)
+     - Most frequent values and their counts
+     - Distribution visualization
+
+3. **Benefits**
+   - Quickly understand data distribution
+   - Identify outliers and data quality issues
+   - Make informed decisions about query conditions
+   - Assess column cardinality for join operations
+
+The Column Profiler is an invaluable tool for exploratory data analysis, helping you gain insights before writing complex queries.
+
+## 📋 Requirements
+
+- Python 3.8 or higher
+- Dependencies (automatically installed):
+  - PyQt6 ≥ 6.4.0
+  - DuckDB ≥ 0.9.0
+  - Pandas ≥ 2.0.0
+  - NumPy ≥ 1.24.0
+  - openpyxl ≥ 3.1.0 (Excel support)
+  - pyarrow ≥ 14.0.1 (Parquet support)
+  - fastparquet ≥ 2023.10.1 (Alternative parquet engine)
+  - xlrd ≥ 2.0.1 (Support for older .xls files)
+
+## 📄 License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

sqlshell-0.2.0.dist-info/RECORD

@@ -0,0 +1,41 @@
+sqlshell/LICENSE,sha256=YFVzvqHDVzBVtEZoKwcHhashVdNy4P7tDEQ561jAdyo,1070
+sqlshell/MANIFEST.in,sha256=UautKSW4Kzjsy1Ti05-P58qRgM4ct4mmG3aserBGaX0,144
+sqlshell/README.md,sha256=UoWQzdsYThrOoajT40iOtpI73g5ANB7w12vll0eH0Ck,1357
+sqlshell/__init__.py,sha256=GAZ3g4YsExb-aFyN0a77whBxRRk4XMGJYakvpeKbxdg,164
+sqlshell/context_suggester.py,sha256=OdfSBqwKWtf6yGj-_cNjf9RZG9cc70TWZ_7ieAVKJqk,33970
+sqlshell/create_test_data.py,sha256=uJSFyqm8zYWpyERPd29iMu-EbtvKiwK5WV0N-LibNOc,5385
+sqlshell/editor.py,sha256=iWSYUtsNCud7HWZrcqD9Ef7FEa0nt7ekeUHV6CmCgao,39635
+sqlshell/main.py,sha256=vt7s6dXmY6iw-Y3jr2YtPNMwwvdqPu1zqNRNidtIRN0,150575
+sqlshell/menus.py,sha256=hiT1CXXnsRKkai7oJlPi94du_GKtIhl5X5LOGvqcOqs,5684
+sqlshell/query_tab.py,sha256=9Yu_7MRikZXrQ003N2HOvjFEBdiz_J9ZLWgTzXPiumc,8404
+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=w3fKuSq5ex5OHxSBzZunyq3mbGvX06-7nxgLClnK5Kw,13232
+sqlshell/syntax_highlighter.py,sha256=mPwsD8N4XzAUx0IgwlelyfjUhe0xmH0Ug3UI9hTcHz0,5861
+sqlshell/table_list.py,sha256=ET9UGxhRL2j42GC6WqocotvQIOUzRskH9BnmciVX_As,37670
+sqlshell/data/create_test_data.py,sha256=sUTcf50V8-bVwYV2VNTLK65c-iHiU4wb99By67I10zM,5404
+sqlshell/db/__init__.py,sha256=AJGRkywFCnJliwfOBvtE_ISXjdESkRea7lBFM5KjuTU,152
+sqlshell/db/database_manager.py,sha256=DRPoRYgY9DthD1YvLuMeo-aRfaAAcdAKZKXMPDmAcsg,35722
+sqlshell/resources/__init__.py,sha256=VLTJ_5pUHhctRiV8UZDvG-jnsjgT6JQvW-ZPzIJqBIY,44
+sqlshell/resources/create_icon.py,sha256=O7idVEKwmSXxLUsbeRn6zcYVQLPSdJi98nGamTgXiM4,4905
+sqlshell/resources/create_splash.py,sha256=t1KK43Y0pHKGcdRkbnZgV6_y1c1C0THHQl5_fmpC2gQ,3347
+sqlshell/resources/icon.png,sha256=l7MI1PWCED1XzsRgUjPR3A9pmbZ253tghd5s_0lJBMs,3173
+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=c4Mg1J1yTUfrnT9C-xDWHhcauRsgU3WNfvVInv1J814,16074
+sqlshell/utils/__init__.py,sha256=iPKvOsKcfnV7xvhQVOz8BiQ4kbFZ7PGUW8vg0vyMqvk,225
+sqlshell/utils/profile_entropy.py,sha256=pJTcXlBkSEPzL3Fvxizf5gBkw6IsUjfa9Y6MjAqF1do,13238
+sqlshell/utils/profile_keys.py,sha256=ajdBTqvZVmAlVaY-kDmv_D8D3sKASG75PLTzf8Y8nX4,14170
+sqlshell-0.2.0.dist-info/METADATA,sha256=EihrTD_KfJTWcYr24WnHEpMBfbYNK6NRJHVhCeU8vQQ,6101
+sqlshell-0.2.0.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
+sqlshell-0.2.0.dist-info/entry_points.txt,sha256=Kd0fOvyOW7UiTgTVY7abVOmDIH2Y2nawGTp5kVadac4,44
+sqlshell-0.2.0.dist-info/top_level.txt,sha256=ahwsMFhvAqI97ZkT2xvHL5iZCO1p13mNiUOFkdSFwms,9
+sqlshell-0.2.0.dist-info/RECORD,,

{sqlshell-0.1.8.dist-info → sqlshell-0.2.0.dist-info}/WHEEL

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

sqlshell/setup.py

@@ -1,42 +0,0 @@
-from setuptools import setup, find_packages
-
-setup(
-    name="sqlshell",
-    version="0.1.1",
-    packages=find_packages(),
-    install_requires=[
-        'pandas>=2.0.0',
-        'numpy>=1.24.0',
-        'PyQt6>=6.4.0',
-        'duckdb>=0.9.0',
-        'openpyxl>=3.1.0',
-        'pyarrow>=14.0.1',
-        'fastparquet>=2023.10.1',
-        'xlrd>=2.0.1'
-    ],
-    entry_points={
-        'console_scripts': [
-            'sqls=sqlshell.main:main',
-        ],
-    },
-    author="SQLShell Team",
-    description="A powerful SQL shell with GUI interface for data analysis",
-    long_description=open('README.md').read(),
-    long_description_content_type="text/markdown",
-    keywords="sql, data analysis, gui, duckdb",
-    url="https://github.com/yourusername/sqlshell",
-    classifiers=[
-        "Development Status :: 3 - Alpha",
-        "Intended Audience :: Developers",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-    ],
-    python_requires=">=3.8",
-    include_package_data=True,
-    package_data={
-        'sqlshell': ['*.db'],
-    },
-) 

sqlshell-0.1.8.dist-info/METADATA

@@ -1,120 +0,0 @@
-Metadata-Version: 2.4
-Name: sqlshell
-Version: 0.1.8
-Summary: A powerful SQL shell with GUI interface for data analysis
-Home-page: https://github.com/yourusername/sqlshell
-Author: SQLShell Team
-License: 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: pyarrow>=14.0.1
-Requires-Dist: fastparquet>=2023.10.1
-Requires-Dist: xlrd>=2.0.1
-Dynamic: home-page
-Dynamic: requires-python
-
-# SQLShell
-
-<div align="center">
-
-![SQLShell Interface](sqlshell_logo.png)
-
-**A modern SQL REPL interface for seamless querying of Excel, Parquet, and SQLite databases**
-
-![SQLShell Interface](sqlshell_demo.png)
-
-</div>
-
-## 🚀 Key Features
-
-- **Interactive SQL Interface** - Rich syntax highlighting for enhanced query writing
-- **DuckDB Integration** - Built-in support for local DuckDB database (pool.db)
-- **Multi-Format Support** - Import and query Excel (.xlsx, .xls) and CSV files effortlessly
-- **Modern UI** - Clean, tabular results display with intuitive controls
-- **Productivity Tools** - Streamlined workflow with keyboard shortcuts (e.g., Ctrl+Enter for query execution)
-
-## 📦 Installation
-
-### Linux Setup with Virtual Environment
-
-```bash
-# Create and activate virtual environment
-python3 -m venv ~/.venv/sqlshell
-source ~/.venv/sqlshell/bin/activate
-
-# Install SQLShell
-pip install sqlshell
-
-# Configure shell alias
-echo 'alias sqls="~/.venv/sqlshell/bin/sqls"' >> ~/.bashrc  # or ~/.zshrc for Zsh
-source ~/.bashrc  # or source ~/.zshrc
-```
-
-### Windows Quick Start
-SQLShell is immediately available via the `sqls` command after installation:
-```bash
-pip install sqlshell
-```
-
-## 🎯 Getting Started
-
-1. **Launch the Application**
-   ```bash
-   sqls
-   ```
-
-2. **Database Connection**
-   - SQLShell automatically connects to a local DuckDB database named 'pool.db'
-
-3. **Working with Excel Files**
-   - Click "Browse Excel" to select your file
-   - File contents are loaded as 'imported_data' table
-   - Query using standard SQL syntax
-
-4. **Query Execution**
-   - Enter SQL in the editor
-   - Execute using Ctrl+Enter or the "Execute" button
-   - View results in the structured output panel
-
-## 📝 Query Examples
-
-### Basic Join Operation
-```sql
-SELECT *
-FROM sample_sales_data cd
-INNER JOIN product_catalog pc ON pc.productid = cd.productid
-LIMIT 3;
-```
-
-### Multi-Statement Queries
-```sql
--- Create a temporary view
-CREATE OR REPLACE TEMPORARY VIEW test_v AS
-SELECT *
-FROM sample_sales_data cd
-INNER JOIN product_catalog pc ON pc.productid = cd.productid;
-
--- Query the view
-SELECT DISTINCT productid
-FROM test_v;
-```
-
-## 💡 Pro Tips
-
-- Use temporary views for complex query organization
-- Leverage keyboard shortcuts for efficient workflow
-- Explore the multi-format support for various data sources

sqlshell-0.1.8.dist-info/RECORD

@@ -1,21 +0,0 @@
-sqlshell/__init__.py,sha256=DqhqqdKdvfwO2iUG1Yd7WPmInpG-OcGhqP8LgblopgI,164
-sqlshell/create_test_data.py,sha256=AzrEsKlZsR1H1Xlp7IKOzWQ2N6FsVISJbc6CerI8IJ0,1954
-sqlshell/editor.py,sha256=4252dxINzJd1jr7CqgSI6IxUYHdkZ1OGZ1qBYN5-MKM,14396
-sqlshell/main.py,sha256=0eQlAQnRkFV14Ot8vJikG7Vq_zkSAqqohu50Y8UREyQ,75480
-sqlshell/setup.py,sha256=bAIXTpgAHhBRmPdT13Klzq16cjd4w4NOYSbyV_rxjlQ,1245
-sqlshell/splash_screen.py,sha256=XkXvSURgQzZfxJvP231Ue4J2E49ph21tWbvfGU03Ogk,6914
-sqlshell/sqlshell_demo.png,sha256=dPp9J1FVqQVfrh-gekosuha2Jw2p2--wxbOmt2kr7fg,133550
-sqlshell/syntax_highlighter.py,sha256=mPwsD8N4XzAUx0IgwlelyfjUhe0xmH0Ug3UI9hTcHz0,5861
-sqlshell/data/create_test_data.py,sha256=sUTcf50V8-bVwYV2VNTLK65c-iHiU4wb99By67I10zM,5404
-sqlshell/resources/__init__.py,sha256=VLTJ_5pUHhctRiV8UZDvG-jnsjgT6JQvW-ZPzIJqBIY,44
-sqlshell/resources/create_icon.py,sha256=ubNYyBYx5HtYpV8eiGY8Fb1VWUoQt-npaqUckiCimnQ,2030
-sqlshell/resources/create_splash.py,sha256=cj6BpMtD1crBkcSxt-ssJIFIZv43UDqLME8FF0fgkoA,2104
-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-0.1.8.dist-info/METADATA,sha256=bIt-ocCENwgCT7ZxBMOUOaABM0PWonDQ7x2rYy2j2fU,3323
-sqlshell-0.1.8.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-sqlshell-0.1.8.dist-info/entry_points.txt,sha256=Kd0fOvyOW7UiTgTVY7abVOmDIH2Y2nawGTp5kVadac4,44
-sqlshell-0.1.8.dist-info/top_level.txt,sha256=ahwsMFhvAqI97ZkT2xvHL5iZCO1p13mNiUOFkdSFwms,9
-sqlshell-0.1.8.dist-info/RECORD,,