Metadata-Version: 2.4
Name: sqlite3-prompt
Version: 0.0.2
Summary: 一个功能强大的、支持自动补全和语法高亮的SQLite3命令行终端。
Author-email: "jk.zhou" <1406584456@qq.com>
License: Copyright © 2025 jk.zhou
        
        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.
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Database
Classifier: Topic :: Terminals
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: prompt-toolkit
Requires-Dist: Pygments
Requires-Dist: tabulate
Dynamic: license-file

# SQLite3-Prompt

一个功能强大的、支持自动补全和语法高亮的交互式 SQLite3 命令行终端。目的是提供一个友好的交互式环境，方便用户能便捷地进行数据库操作。


## 🔥 最新动态

- 初始版本已发布，已可用。
- 获取最新动态或要与我取得联系，可关注：https://publish.obsidian.md/xm


## ✨ 功能特性

- **智能自动补全**: 自动补全 SQL 关键字、表名、字段名
- **语法高亮**: 在您输入时实时高亮 SQL 语句，提升可读性
- **多行输入**: 支持将复杂的 SQL 语句分多行输入，直到以分号结尾
- **历史记录**: 自动保存命令历史，方便回溯和重复执行
- **跨平台**: 在 Windows, macOS 和 Linux 上均可良好运行
- **易于使用**: 直观的命令行界面，与标准 sqlite3 命令行工具类似

## 🚀 安装

通过 `pip` 即可轻松安装：

```bash
pip install sqlite3-prompt
```

## 🖥️ 如何使用

安装完成后，即可在您的终端中使用 `sqlite3-prompt` 命令，也可使用 `sqlite-prompt` 命令。

### 基本用法

**1. 连接到（或创建）一个数据库文件：**

```bash
sqlite-prompt my_database.db 或 sqlite3-prompt my_database.db
```

**2. 直接启动，然后输入数据库路径：**

```bash
sqlite-prompt 或 sqlite3-prompt
```
程序会提示您输入数据库文件的路径。

### 在 IPython 中使用

`sqlite3-prompt` 也可以在 IPython 等交互式环境中使用：

```ipython
In [1]: sqlite3-prompt my_data.db
已成功连接到数据库: my_data.db
欢迎使用Python版SQLite3工作台 V1.0 (稳定版)。
当前配色: monokai (自定义)。
提示: SQL语句必须以分号 (;) 结尾才能执行，支持多行输入。
输入 .help 获取帮助。
sqlite>
```

### 支持的元命令

进入终端后，您可以像使用标准 `sqlite3` 终端一样输入 SQL 命令。所有 SQL 语句必须以分号 (`;`) 结尾才能执行。

- `.tables`: 显示数据库中所有的表
- `.help`: 显示帮助信息
- `.exit` 或 `.quit`: 退出终端

### 示例会话

```sql
sqlite> CREATE TABLE users (
   ...>   id INTEGER PRIMARY KEY,
   ...>   name TEXT NOT NULL,
   ...>   email TEXT UNIQUE
   ...> );
命令执行成功。
(操作耗时: 0.0023 秒)

sqlite> INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');
命令执行成功。
(操作耗时: 0.0012 秒)

sqlite> SELECT * FROM users;
+----+-------+-------------------+
| id | name  | email             |
+====+=======+===================+
|  1 | Alice | alice@example.com |
+----+-------+-------------------+

查询到 1 行。
(操作耗时: 0.0008 秒)

sqlite> .exit
数据库连接已关闭。
```


## 📋 系统要求

- Python 3.8 或更高版本
- 依赖库：`prompt-toolkit`, `Pygments`, `tabulate`

## 📜 许可证

本项目基于 [MIT License](LICENSE) 开源。 
