sqlshell 0.1.9__py3-none-any.whl → 0.2.1__py3-none-any.whl

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.

Potentially problematic release.


This version of sqlshell might be problematic. Click here for more details.

@@ -1,122 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: sqlshell
3
- Version: 0.1.9
4
- Summary: A powerful SQL shell with GUI interface for data analysis
5
- Home-page: https://github.com/yourusername/sqlshell
6
- Author: SQLShell Team
7
- License: MIT
8
- Project-URL: Homepage, https://github.com/oyvinrog/SQLShell
9
- Keywords: sql,data analysis,gui,duckdb
10
- Classifier: Development Status :: 3 - Alpha
11
- Classifier: Intended Audience :: Developers
12
- Classifier: Programming Language :: Python :: 3
13
- Classifier: Programming Language :: Python :: 3.8
14
- Classifier: Programming Language :: Python :: 3.9
15
- Classifier: Programming Language :: Python :: 3.10
16
- Classifier: Programming Language :: Python :: 3.11
17
- Requires-Python: >=3.8
18
- Description-Content-Type: text/markdown
19
- Requires-Dist: pandas>=2.0.0
20
- Requires-Dist: numpy>=1.24.0
21
- Requires-Dist: PyQt6>=6.4.0
22
- Requires-Dist: duckdb>=0.9.0
23
- Requires-Dist: openpyxl>=3.1.0
24
- Requires-Dist: pyarrow>=14.0.1
25
- Requires-Dist: fastparquet>=2023.10.1
26
- Requires-Dist: xlrd>=2.0.1
27
- Dynamic: home-page
28
- Dynamic: requires-python
29
-
30
- # SQLShell
31
-
32
- <div align="center">
33
-
34
- <img src="sqlshell_logo.png" alt="SQLShell Logo" width="256" height="256">
35
-
36
- **A modern SQL REPL interface for seamless querying of Excel, Parquet, and SQLite databases**
37
-
38
- ![SQLShell Interface](sqlshell_demo.png)
39
-
40
- </div>
41
-
42
- ## 🚀 Key Features
43
-
44
- - **Interactive SQL Interface** - Rich syntax highlighting for enhanced query writing
45
- - **DuckDB Integration** - Built-in support for local DuckDB database (pool.db)
46
- - **Multi-Format Support** - Import and query Excel (.xlsx, .xls), CSV, and Parquet files effortlessly
47
- - **Modern UI** - Clean, tabular results display with intuitive controls
48
- - **Productivity Tools** - Streamlined workflow with keyboard shortcuts (e.g., Ctrl+Enter for query execution)
49
- - **Professional Design** - Human-readable interface with optimized graphics
50
-
51
- ## 📦 Installation
52
-
53
- ### Linux Setup with Virtual Environment
54
-
55
- ```bash
56
- # Create and activate virtual environment
57
- python3 -m venv ~/.venv/sqlshell
58
- source ~/.venv/sqlshell/bin/activate
59
-
60
- # Install SQLShell
61
- pip install sqlshell
62
-
63
- # Configure shell alias
64
- echo 'alias sqls="~/.venv/sqlshell/bin/sqls"' >> ~/.bashrc # or ~/.zshrc for Zsh
65
- source ~/.bashrc # or source ~/.zshrc
66
- ```
67
-
68
- ### Windows Quick Start
69
- SQLShell is immediately available via the `sqls` command after installation:
70
- ```bash
71
- pip install sqlshell
72
- ```
73
-
74
- ## 🎯 Getting Started
75
-
76
- 1. **Launch the Application**
77
- ```bash
78
- sqls
79
- ```
80
-
81
- 2. **Database Connection**
82
- - SQLShell automatically connects to a local DuckDB database named 'pool.db'
83
-
84
- 3. **Working with Data Files**
85
- - Click "Load Files" to select your Excel, CSV, or Parquet files
86
- - File contents are loaded as queryable SQL tables
87
- - Query using standard SQL syntax
88
-
89
- 4. **Query Execution**
90
- - Enter SQL in the editor
91
- - Execute using Ctrl+Enter or the "Execute" button
92
- - View results in the structured output panel
93
-
94
- ## 📝 Query Examples
95
-
96
- ### Basic Join Operation
97
- ```sql
98
- SELECT *
99
- FROM sample_sales_data cd
100
- INNER JOIN product_catalog pc ON pc.productid = cd.productid
101
- LIMIT 3;
102
- ```
103
-
104
- ### Multi-Statement Queries
105
- ```sql
106
- -- Create a temporary view
107
- CREATE OR REPLACE TEMPORARY VIEW test_v AS
108
- SELECT *
109
- FROM sample_sales_data cd
110
- INNER JOIN product_catalog pc ON pc.productid = cd.productid;
111
-
112
- -- Query the view
113
- SELECT DISTINCT productid
114
- FROM test_v;
115
- ```
116
-
117
- ## 💡 Pro Tips
118
-
119
- - Use temporary views for complex query organization
120
- - Leverage keyboard shortcuts for efficient workflow
121
- - Explore the multi-format support for various data sources
122
- - Create multiple tabs for parallel query development