sql-assistant 1.0.0__tar.gz → 1.0.2__tar.gz

sql_assistant-1.0.2/.gitignore

@@ -0,0 +1,123 @@
+# ==============================================================================
+# SQL Assistant - .gitignore
+# ==============================================================================
+
+# ----------------------------
+# Virtual Environment
+# ----------------------------
+.venv/
+.env/
+env/
+venv/
+ENV/
+.env.local
+.env.*.local
+
+# ----------------------------
+# Python
+# ----------------------------
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+uv.lock
+pip-selfcheck.json
+.hypothesis/
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.tox/
+
+# ----------------------------
+# Build Artifacts
+# ----------------------------
+dist/
+build/
+*.whl
+*.egg
+.installed.cfg
+
+# ----------------------------
+# IDE & Editor
+# ----------------------------
+.vscode/
+.idea/
+.project
+.pydevproject
+.settings/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# ----------------------------
+# Logs
+# ----------------------------
+*.log
+logs/
+*.log.*
+.logs/
+
+# ----------------------------
+# Configuration & Data
+# ----------------------------
+# 项目数据目录（配置、数据库、运行时数据）
+.data/
+# 旧版配置路径
+~/.sql-assistant/
+.sql-assistant/
+# SQLite数据库文件
+*.db
+*.sqlite
+*.sqlite3
+*.db-journal
+
+# ----------------------------
+# Backup
+# ----------------------------
+# 数据库备份目录
+backups/
+
+# ----------------------------
+# Security
+# ----------------------------
+*.pem
+*.key
+*.cert
+*.crt
+secrets/
+.vault/
+
+# ----------------------------
+# Node.js (if used)
+# ----------------------------
+node_modules/
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# ----------------------------
+# Trae IDE
+# ----------------------------
+.codegraph/
+
+# ----------------------------
+# DeepSeek
+# ----------------------------
+.deepseek/
+
+# ----------------------------
+# Trae IDE Rules
+# ----------------------------
+.trae/
+
+# ----------------------------
+# Cache
+# ----------------------------
+.cache/
+*.egg

{sql_assistant-1.0.0 → sql_assistant-1.0.2}/PKG-INFO

@@ -1,8 +1,20 @@
 Metadata-Version: 2.4
 Name: sql-assistant
-Version: 1.0.0
-Summary: SQL 智能助手 - 自然语言转 SQL 查询工具，支持主流数据库和 LLM
+Version: 1.0.2
+Summary: SQL Smart Assistant - Natural Language to SQL query tool supporting major databases and LLMs
+Author-email: fjz-hosts <2931742378@qq.com>
+Maintainer-email: fjz-hosts <2931742378@qq.com>
 License-File: LICENSE
+Keywords: assistant,database,llm,natural-language,query,sql
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.10
 Requires-Dist: aiosqlite>=0.20.0
 Requires-Dist: fastapi>=0.110.0

{sql_assistant-1.0.0 → sql_assistant-1.0.2}/README.md

@@ -23,6 +23,9 @@
 
 ## 🗞️ News
 
+- **2026-05-14** — 🎉 SQL Smart Assistant v1.0.1 released!
+  - Added SQL Template/Favorite functionality
+  - Added Execution Plan Analysis feature
 - **2026-05-10** — 🎉 SQL Smart Assistant v1.0.0 released!
 
 
@@ -54,7 +57,7 @@ Download and install directly from the Release page:
 
 ```bash
 # Install latest version (replace with your Release URL)
-pip install https://github.com/fjz-hosts/sql-assistant/releases/download/sql-assistant-v1.0.0/sql_assistant-1.0.0-py3-none-any.whl
+pip install sql-assistant
 
 # Install with optional dependencies
 pip install "sql-assistant[sqlserver,gemini,claude]"
@@ -143,6 +146,20 @@ Visit **http://localhost:5010** to start using!
 - **Backup Management**: View backup list, get backup details, delete backup files
 - **Data Recovery**: Restore table structure and data from backup files to current database
 
+### 8. SQL Template/Favorite
+
+- **Template Management**: Create, edit, delete SQL templates for frequently used queries
+- **Tag-based Filtering**: Organize templates with tags for easy categorization
+- **Quick Insert**: Insert templates directly into the query input box
+- **Favorite Marking**: Mark frequently used SQL statements as favorites
+
+### 9. Execution Plan Analysis
+
+- **Visual Execution Plan**: View graphical execution plan for SELECT statements
+- **Cost Analysis**: Analyze query cost and performance metrics
+- **Optimization Suggestions**: Get AI-powered optimization recommendations
+- **Index Utilization**: Check index usage and identify missing indexes
+
 
 ## <a id="system-architecture"></a> 🏗️ System Architecture
 
@@ -418,6 +435,9 @@ Visit **http://localhost:5010/docs** after starting the service to view Swagger
 | `/api/backup/list` | GET | Get backup list |
 | `/api/backup/{backup_id}` | GET/DELETE | Get backup details / Delete backup |
 | `/api/backup/restore` | POST | Restore database from backup |
+| `/api/templates` | GET/POST | Get template list / Create new template |
+| `/api/templates/{id}` | GET/PUT/DELETE | Get/update/delete template |
+| `/api/explain` | POST | Analyze SQL execution plan |
 
 
 ## ⚠️ Notes

sql_assistant-1.0.2/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "sql-assistant"
+version = "1.0.2"
+description = "SQL Smart Assistant - Natural Language to SQL query tool supporting major databases and LLMs"
+requires-python = ">=3.10"
+authors = [
+    { name = "fjz-hosts", email = "2931742378@qq.com" }
+]
+maintainers = [
+    { name = "fjz-hosts", email = "2931742378@qq.com" }
+]
+keywords = ["sql", "llm", "natural-language", "database", "query", "assistant"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Database",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "fastapi>=0.110.0",
+    "uvicorn[standard]>=0.29.0",
+    "jinja2>=3.1.0",
+    "pydantic>=2.0.0",
+    "python-multipart>=0.0.9",
+    "pyyaml>=6.0",
+    "httpx>=0.27.0",
+    "pymysql>=1.1.0",
+    "psycopg2-binary>=2.9.0",
+    "redis>=5.0.0",
+    "pymongo>=4.6.0",
+    "aiosqlite>=0.20.0",
+]
+
+[project.optional-dependencies]
+sqlserver = ["pymssql>=2.3.0"]
+gemini = ["google-generativeai>=0.8.0"]
+claude = ["anthropic>=0.30.0"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.metadata]
+readme = "README.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sql_assistant"]
+
+[project.scripts]
+sql-assistant = "sql_assistant.main:main"

sql_assistant-1.0.2/pytest.ini

@@ -0,0 +1,4 @@
+[pytest]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = -v --tb=short

{sql_assistant-1.0.0 → sql_assistant-1.0.2}/src/sql_assistant/api/dependencies.py

@@ -4,6 +4,7 @@ from ..config import get_config_manager
 from ..llm.manager import get_llm_manager
 from ..database.manager import get_db_manager
 from ..database.history import get_history_manager
+from ..database.templates import get_template_manager as get_db_template_manager
 
 
 def get_config():
@@ -20,3 +21,7 @@ def get_db():
 
 def get_history():
     return get_history_manager()
+
+
+def get_template_manager():
+    return get_db_template_manager()