db-connector-tool 0.0.3__tar.gz

db_connector_tool-0.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 wangquanqing
+
+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.

db_connector_tool-0.0.3/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: db-connector-tool
+Version: 0.0.3
+Summary: 跨平台数据库连接管理工具
+Author-email: wangquanqing <wangquanqing1636@sina.com>
+License: MIT
+Project-URL: Homepage, https://github.com/wangquanqing/db-connector-project
+Project-URL: Repository, https://github.com/wangquanqing/db-connector-project
+Project-URL: Documentation, https://db-connector-tool.readthedocs.io
+Project-URL: Issue Tracker, https://github.com/wangquanqing/db-connector-project/issues
+Keywords: database,connection,manager,orm,sqlalchemy,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: oracledb>=2.0.0
+Requires-Dist: psycopg>=3.0.0
+Requires-Dist: pymysql>=1.1.0
+Requires-Dist: pymssql>=2.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
+Provides-Extra: cli
+Requires-Dist: click>=8.0.0; extra == "cli"
+Requires-Dist: rich>=13.0.0; extra == "cli"
+Dynamic: license-file
+
+# DB Connector - 跨平台数据库连接管理模块
+
+一个安全、跨平台的Python数据库连接管理模块，支持主流数据库并提供加密存储功能。
+
+## 特性
+
+- 🔐 **安全加密**: 使用 `cryptography.fernet` 加密敏感连接信息
+- 📁 **配置管理**: 基于 TOML 的配置文件（读取：`tomllib`，写入：`tomli-w`）
+- 🗄️ **多数据库支持**: 
+  - Oracle (oracledb)
+  - PostgreSQL (psycopg2/psycopg3)
+  - SQL Server (pymssql)
+  - MySQL (pymysql)
+  - SQLite (sqlite3)
+- 🏗️ **ORM 集成**: 基于 SQLAlchemy 2.0+
+- 📊 **完整日志**: 使用 logging 模块记录操作日志
+- 🌐 **跨平台**: 支持 Windows、Linux、macOS
+- 🧪 **完整测试**: 包含单元测试和集成测试
+
+## 安装
+
+### 要求
+
+- Python >= 3.8
+- 参见 `requirements.txt` 了解依赖详情
+
+### 从源码安装
+
+```bash
+git clone https://github.com/yourusername/db-connector.git
+cd db-connector
+pip install -e .
+```
+
+### 从 PyPI 安装（未来计划）
+
+```bash
+pip install db-connector
+```
+
+## 快速开始
+
+### 基础用法
+
+```python
+from db_connector import DatabaseManager
+
+# 创建数据库管理器
+db_manager = DatabaseManager()
+
+# 添加数据库连接
+mysql_config = {
+    'type': 'mysql',
+    'host': 'localhost',
+    'port': '3306',
+    'username': 'your_username',
+    'password': 'your_password',
+    'database': 'your_database'
+}
+
+db_manager.create_connection('my_mysql', mysql_config)
+
+# 执行查询
+results = db_manager.execute_query('my_mysql', 'SELECT * FROM users LIMIT 10')
+print(results)
+
+# 关闭连接
+db_manager.close_all_connections()
+```
+
+### 多数据库操作
+
+```python
+from db_connector import DatabaseManager
+
+db_manager = DatabaseManager()
+
+# 配置多个数据库
+databases = {
+    'app_db': {
+        'type': 'postgresql',
+        'host': 'db.server.com',
+        'username': 'user',
+        'password': 'pass',
+        'database': 'application'
+    },
+    'log_db': {
+        'type': 'sqlite',
+        'database': '/path/to/logs.db'
+    }
+}
+
+for name, config in databases.items():
+    db_manager.create_connection(name, config)
+
+# 跨数据库操作
+users = db_manager.execute_query('app_db', 'SELECT * FROM users')
+db_manager.execute_command('log_db', 'INSERT INTO access_log VALUES (?, ?)', (user_id, 'login'))
+
+db_manager.close_all_connections()
+```
+
+## 配置说明
+
+### 连接配置格式
+
+每个数据库连接支持以下配置：
+
+**MySQL/PostgreSQL/SQL Server/Oracle:**
+```python
+{
+    'type': 'mysql',  # mysql, postgresql, mssql, oracle
+    'host': 'localhost',
+    'port': '3306',
+    'username': 'your_username',
+    'password': 'your_password',
+    'database': 'your_database'
+}
+```
+
+**SQLite:**
+```python
+{
+    'type': 'sqlite',
+    'database': '/path/to/database.db'  # 或 ':memory:' 用于内存数据库
+}
+```
+
+### 配置文件位置
+
+- **配置文件**: `~/.config/db_connector/connections.toml`
+- **日志文件**: `~/.config/db_connector/logs/db_connector.log`
+- **加密密钥**: `~/.config/db_connector/encryption.key`
+
+## API 参考
+
+### DatabaseManager
+
+主要管理类，提供以下方法：
+
+- `create_connection(name, config)`: 创建连接配置
+- `get_connection(name)`: 获取数据库连接
+- `execute_query(connection_name, query, params)`: 执行查询
+- `execute_command(connection_name, command, params)`: 执行命令
+- `test_connection(name)`: 测试连接
+- `list_connections()`: 列出所有连接
+- `remove_connection(name)`: 删除连接
+- `close_connection(name)`: 关闭连接
+- `close_all_connections()`: 关闭所有连接
+
+## 开发
+
+### 运行测试
+
+```bash
+# 运行所有测试
+pytest
+
+# 运行特定测试模块
+pytest tests/test_database.py
+
+# 带覆盖率的测试
+pytest --cov=db_connector tests/
+```
+
+### 代码风格
+
+本项目使用 Black 代码格式化工具：
+
+```bash
+black db_connector/ tests/ examples/
+```
+
+## 许可证
+
+MIT License - 详见 LICENSE 文件
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 支持
+
+如有问题请：
+1. 查看文档和示例
+2. 提交 GitHub Issue
+3. 联系维护者

db_connector_tool-0.0.3/README.md

@@ -0,0 +1,187 @@
+# DB Connector - 跨平台数据库连接管理模块
+
+一个安全、跨平台的Python数据库连接管理模块，支持主流数据库并提供加密存储功能。
+
+## 特性
+
+- 🔐 **安全加密**: 使用 `cryptography.fernet` 加密敏感连接信息
+- 📁 **配置管理**: 基于 TOML 的配置文件（读取：`tomllib`，写入：`tomli-w`）
+- 🗄️ **多数据库支持**: 
+  - Oracle (oracledb)
+  - PostgreSQL (psycopg2/psycopg3)
+  - SQL Server (pymssql)
+  - MySQL (pymysql)
+  - SQLite (sqlite3)
+- 🏗️ **ORM 集成**: 基于 SQLAlchemy 2.0+
+- 📊 **完整日志**: 使用 logging 模块记录操作日志
+- 🌐 **跨平台**: 支持 Windows、Linux、macOS
+- 🧪 **完整测试**: 包含单元测试和集成测试
+
+## 安装
+
+### 要求
+
+- Python >= 3.8
+- 参见 `requirements.txt` 了解依赖详情
+
+### 从源码安装
+
+```bash
+git clone https://github.com/yourusername/db-connector.git
+cd db-connector
+pip install -e .
+```
+
+### 从 PyPI 安装（未来计划）
+
+```bash
+pip install db-connector
+```
+
+## 快速开始
+
+### 基础用法
+
+```python
+from db_connector import DatabaseManager
+
+# 创建数据库管理器
+db_manager = DatabaseManager()
+
+# 添加数据库连接
+mysql_config = {
+    'type': 'mysql',
+    'host': 'localhost',
+    'port': '3306',
+    'username': 'your_username',
+    'password': 'your_password',
+    'database': 'your_database'
+}
+
+db_manager.create_connection('my_mysql', mysql_config)
+
+# 执行查询
+results = db_manager.execute_query('my_mysql', 'SELECT * FROM users LIMIT 10')
+print(results)
+
+# 关闭连接
+db_manager.close_all_connections()
+```
+
+### 多数据库操作
+
+```python
+from db_connector import DatabaseManager
+
+db_manager = DatabaseManager()
+
+# 配置多个数据库
+databases = {
+    'app_db': {
+        'type': 'postgresql',
+        'host': 'db.server.com',
+        'username': 'user',
+        'password': 'pass',
+        'database': 'application'
+    },
+    'log_db': {
+        'type': 'sqlite',
+        'database': '/path/to/logs.db'
+    }
+}
+
+for name, config in databases.items():
+    db_manager.create_connection(name, config)
+
+# 跨数据库操作
+users = db_manager.execute_query('app_db', 'SELECT * FROM users')
+db_manager.execute_command('log_db', 'INSERT INTO access_log VALUES (?, ?)', (user_id, 'login'))
+
+db_manager.close_all_connections()
+```
+
+## 配置说明
+
+### 连接配置格式
+
+每个数据库连接支持以下配置：
+
+**MySQL/PostgreSQL/SQL Server/Oracle:**
+```python
+{
+    'type': 'mysql',  # mysql, postgresql, mssql, oracle
+    'host': 'localhost',
+    'port': '3306',
+    'username': 'your_username',
+    'password': 'your_password',
+    'database': 'your_database'
+}
+```
+
+**SQLite:**
+```python
+{
+    'type': 'sqlite',
+    'database': '/path/to/database.db'  # 或 ':memory:' 用于内存数据库
+}
+```
+
+### 配置文件位置
+
+- **配置文件**: `~/.config/db_connector/connections.toml`
+- **日志文件**: `~/.config/db_connector/logs/db_connector.log`
+- **加密密钥**: `~/.config/db_connector/encryption.key`
+
+## API 参考
+
+### DatabaseManager
+
+主要管理类，提供以下方法：
+
+- `create_connection(name, config)`: 创建连接配置
+- `get_connection(name)`: 获取数据库连接
+- `execute_query(connection_name, query, params)`: 执行查询
+- `execute_command(connection_name, command, params)`: 执行命令
+- `test_connection(name)`: 测试连接
+- `list_connections()`: 列出所有连接
+- `remove_connection(name)`: 删除连接
+- `close_connection(name)`: 关闭连接
+- `close_all_connections()`: 关闭所有连接
+
+## 开发
+
+### 运行测试
+
+```bash
+# 运行所有测试
+pytest
+
+# 运行特定测试模块
+pytest tests/test_database.py
+
+# 带覆盖率的测试
+pytest --cov=db_connector tests/
+```
+
+### 代码风格
+
+本项目使用 Black 代码格式化工具：
+
+```bash
+black db_connector/ tests/ examples/
+```
+
+## 许可证
+
+MIT License - 详见 LICENSE 文件
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 支持
+
+如有问题请：
+1. 查看文档和示例
+2. 提交 GitHub Issue
+3. 联系维护者

db_connector_tool-0.0.3/db_connector/__init__.py

@@ -0,0 +1,122 @@
+"""
+DB Connector - 跨平台数据库连接管理模块
+======================================
+
+一个功能强大的数据库连接管理工具，支持多种数据库类型。
+
+特性:
+- 支持 Oracle, PostgreSQL, SQL Server, MySQL, SQLite
+- 统一的连接配置管理
+- 安全的密码加密存储
+- 命令行界面和API接口
+- 跨平台兼容
+
+版本: 1.0.0
+作者: wangquanqing <wangquanqing1636@sina.com>
+许可证: MIT
+"""
+
+__version__ = "0.0.3"
+__author__ = "wangquanqing <wangquanqing1636@sina.com>"
+__license__ = "MIT"
+
+# 核心模块导入
+from .core.config import ConfigManager
+from .core.connections import DatabaseManager
+from .core.exceptions import (
+    ConfigError,
+    ConnectionError,
+    CryptoError,
+    DatabaseError,
+    DBConnectorError,
+)
+
+# CLI模块导入（可选，安装时可能不可用）
+try:
+    from .cli import DBConnectorCLI
+    from .cli import main as cli_main
+except ImportError as e:
+    # 在安装过程中或缺少依赖时，CLI模块可能不可用。这不会影响核心功能的使用
+    DBConnectorCLI = None
+    cli = None
+
+# 公共API导出列表
+__all__ = [
+    # 核心管理器
+    "ConfigManager",
+    "DatabaseManager",
+    # 异常类
+    "DBConnectorError",
+    "ConfigError",
+    "CryptoError",
+    "DatabaseError",
+    "ConnectionError",
+    # CLI相关（可选）
+    "DBConnectorCLI",
+    "cli",
+]
+
+
+# 包级别便捷函数
+def get_version() -> str:
+    """
+    获取当前模块版本号
+
+    Returns:
+        str: 版本号字符串，格式为 'x.y.z'
+
+    Example:
+        >>> from db_connector import get_version
+        >>> print(get_version())
+        '1.0.0'
+    """
+    return __version__
+
+
+def get_supported_databases() -> list:
+    """
+    获取支持的数据库类型列表
+
+    Returns:
+        list: 支持的数据库类型名称列表
+
+    Example:
+        >>> from db_connector import get_supported_databases
+        >>> print(get_supported_databases())
+        ['oracle', 'postgresql', 'sqlserver', 'mysql', 'sqlite']
+    """
+    return ["oracle", "postgresql", "sqlserver", "mysql", "sqlite"]
+
+
+# 包初始化检查
+def _check_dependencies() -> None:
+    """
+    检查必要的依赖是否可用
+
+    Raises:
+        ImportError: 如果核心依赖不可用
+    """
+    try:
+        import sqlalchemy
+    except ImportError:
+        raise ImportError("SQLAlchemy是必需的依赖，请安装: pip install sqlalchemy")
+
+
+# 在导入时执行依赖检查
+try:
+    _check_dependencies()
+except ImportError as e:
+    # 记录警告但不阻止导入
+    import warnings
+
+    warnings.warn(f"依赖检查警告: {e}", ImportWarning)
+
+# 包信息
+__package_info__ = {
+    "name": "db_connector",
+    "version": __version__,
+    "author": __author__,
+    "license": __license__,
+    "description": "跨平台数据库连接管理工具",
+    "supported_databases": get_supported_databases(),
+}