thoth-dbmanager 0.4.13__py3-none-any.whl → 0.5.1__py3-none-any.whl

{thoth_dbmanager-0.4.13.dist-info → thoth_dbmanager-0.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoth_dbmanager
-Version: 0.4.13
+Version: 0.5.1
 Summary: A Python library for managing SQL databases with support for multiple database types, LSH-based similarity search, and a modern plugin architecture.
 Author-email: Marco Pancotti <mp@tylconsulting.it>
 Project-URL: Homepage, https://github.com/mptyl/thoth_dbmanager
@@ -9,7 +9,6 @@ Project-URL: Documentation, https://github.com/mptyl/thoth_dbmanager#readme
 Project-URL: Source Code, https://github.com/mptyl/thoth_dbmanager
 Keywords: database,sql,lsh,similarity-search,orm
 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
@@ -20,7 +19,7 @@ Classifier: Intended Audience :: Developers
 Classifier: Topic :: Database
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
 Classifier: Development Status :: 4 - Beta
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: datasketch>=1.5.0
@@ -31,30 +30,15 @@ Requires-Dist: pandas>=1.3.0
 Requires-Dist: requests>=2.25.0
 Provides-Extra: postgresql
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgresql"
-Provides-Extra: mysql
-Requires-Dist: mysql-connector-python>=8.0.0; extra == "mysql"
 Provides-Extra: mariadb
 Requires-Dist: mariadb>=1.1.0; extra == "mariadb"
 Provides-Extra: sqlserver
 Requires-Dist: pyodbc>=4.0.0; extra == "sqlserver"
-Requires-Dist: pymssql>=2.3.0; extra == "sqlserver"
-Provides-Extra: oracle
-Requires-Dist: cx_Oracle>=8.3.0; extra == "oracle"
-Requires-Dist: oracledb>=3.0.0; extra == "oracle"
-Provides-Extra: supabase
-Requires-Dist: supabase>=2.0.0; extra == "supabase"
-Requires-Dist: postgrest-py>=0.10.0; extra == "supabase"
-Requires-Dist: gotrue>=1.0.0; extra == "supabase"
 Provides-Extra: sqlite
 Provides-Extra: all
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "all"
-Requires-Dist: mysql-connector-python>=8.0.0; extra == "all"
 Requires-Dist: mariadb>=1.1.0; extra == "all"
 Requires-Dist: pyodbc>=4.0.0; extra == "all"
-Requires-Dist: pymssql>=2.3.0; extra == "all"
-Requires-Dist: cx_Oracle>=8.3.0; extra == "all"
-Requires-Dist: oracledb>=3.0.0; extra == "all"
-Requires-Dist: supabase>=2.0.0; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -69,9 +53,12 @@ Requires-Dist: docker>=6.0.0; extra == "dev"
 Provides-Extra: test-postgresql
 Requires-Dist: pytest>=7.0.0; extra == "test-postgresql"
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "test-postgresql"
-Provides-Extra: test-mysql
-Requires-Dist: pytest>=7.0.0; extra == "test-mysql"
-Requires-Dist: mysql-connector-python>=8.0.0; extra == "test-mysql"
+Provides-Extra: test-mariadb
+Requires-Dist: pytest>=7.0.0; extra == "test-mariadb"
+Requires-Dist: mariadb>=1.1.0; extra == "test-mariadb"
+Provides-Extra: test-sqlserver
+Requires-Dist: pytest>=7.0.0; extra == "test-sqlserver"
+Requires-Dist: pyodbc>=4.0.0; extra == "test-sqlserver"
 Dynamic: license-file
 
 # Thoth Database Manager
@@ -84,12 +71,83 @@ A Python library for managing SQL databases with support for multiple database t
 - **Plugin Architecture**: Extensible design for adding new database types
 - **LSH Search**: Locality-Sensitive Hashing for finding similar values across database columns
 - **Type Safety**: Pydantic-based document models for structured data
-- **Backward Compatibility**: Maintains compatibility with existing code
+- **Modern API**: Clean, plugin-based interface for all database operations
 
 ## Installation
 
+### Basic Installation
+
+```bash
+uv add thoth-dbmanager
+```
+
+### Installation with Database Support
+
+To use specific databases, you'll need to install the corresponding database drivers. You can install them individually or use our convenience extras:
+
+#### Install with All Database Support
+
+```bash
+uv add thoth-dbmanager[all]
+```
+
+#### Install with Specific Database Support
+
+**PostgreSQL:**
+
+```bash
+uv add thoth-dbmanager[postgresql]
+# or manually: uv add psycopg2-binary
+```
+
+**MySQL:**
+
+```bash
+uv add thoth-dbmanager[mysql]
+# or manually: uv add mysql-connector-python
+```
+
+**MariaDB:**
+
+```bash
+uv add thoth-dbmanager[mariadb]
+# or manually: uv add mariadb
+```
+
+**SQL Server:**
+
+```bash
+uv add thoth-dbmanager[sqlserver]
+# or manually: uv add pyodbc
+```
+
+**Oracle:**
+
+```bash
+uv add thoth-dbmanager[oracle]
+# or manually: uv add cx_Oracle
+```
+
+**Informix:**
+
+```bash
+uv add thoth-dbmanager[informix]
+# or manually: uv add IfxPy
+```
+
+**Supabase:**
+
 ```bash
-pip install thoth-dbmanager
+uv add thoth-dbmanager[supabase]
+# or manually: uv add supabase gotrue
+```
+
+**SQLite** is supported out of the box (no additional drivers needed).
+
+#### Development Installation
+
+```bash
+uv add thoth-dbmanager[dev]
 ```
 
 ## Quick Start
@@ -278,9 +336,17 @@ if hasattr(manager, 'get_columns_as_documents'):
         print(f"Primary Key: {doc.is_pk}")
 ```
 
-## Configuration Examples
+## Database Connection Examples
 
 ### PostgreSQL
+
+**Installation:**
+
+```bash
+uv add thoth-dbmanager[postgresql]
+```
+
+**Usage:**
 ```python
 manager = ThothDbManager.get_instance(
     db_type="postgresql",
@@ -294,7 +360,63 @@ manager = ThothDbManager.get_instance(
 )
 ```
 
+### MySQL
+
+**Installation:**
+
+```bash
+uv add thoth-dbmanager[mysql]
+```
+
+**Usage:**
+
+```python
+manager = ThothDbManager.get_instance(
+    db_type="mysql",
+    db_root_path="./data",
+    db_mode="production",
+    host="localhost",
+    port=3306,
+    database="myapp",
+    user="dbuser",
+    password="dbpass"
+)
+```
+
+### MariaDB
+
+**Installation:**
+
+```bash
+uv add thoth-dbmanager[mariadb]
+```
+
+**Usage:**
+
+```python
+manager = ThothDbManager.get_instance(
+    db_type="mariadb",
+    db_root_path="./data",
+    db_mode="production",
+    host="localhost",
+    port=3306,
+    database="myapp",
+    user="dbuser",
+    password="dbpass"
+)
+```
+
 ### SQLite
+
+**Installation:**
+
+```bash
+# No additional drivers needed - SQLite is included with Python
+uv add thoth-dbmanager
+```
+
+**Usage:**
+
 ```python
 manager = ThothDbManager.get_instance(
     db_type="sqlite",
@@ -304,20 +426,99 @@ manager = ThothDbManager.get_instance(
 )
 ```
 
-### MySQL/MariaDB
+### SQL Server
+
+**Installation:**
+
+```bash
+uv add thoth-dbmanager[sqlserver]
+```
+
+**Usage:**
+
+```python
+manager = ThothDbManager.get_instance(
+    db_type="sqlserver",
+    db_root_path="./data",
+    db_mode="production",
+    server="localhost",
+    database="myapp",
+    user="dbuser",
+    password="dbpass"
+)
+```
+
+### Oracle
+
+**Installation:**
+
+```bash
+uv add thoth-dbmanager[oracle]
+```
+
+**Usage:**
+
 ```python
 manager = ThothDbManager.get_instance(
-    db_type="mysql",  # or "mariadb"
+    db_type="oracle",
     db_root_path="./data",
     db_mode="production",
     host="localhost",
-    port=3306,
+    port=1521,
+    service_name="ORCL",
+    user="dbuser",
+    password="dbpass"
+)
+```
+
+### Informix
+
+**Installation:**
+
+```bash
+uv add thoth-dbmanager[informix]
+```
+
+**Usage:**
+
+```python
+manager = ThothDbManager.get_instance(
+    db_type="informix",
+    db_root_path="./data",
+    db_mode="production",
+    server="informix_server",
     database="myapp",
+    host="localhost",
     user="dbuser",
     password="dbpass"
 )
 ```
 
+### Supabase
+
+**Installation:**
+
+```bash
+uv add thoth-dbmanager[supabase]
+```
+
+**Usage:**
+
+```python
+manager = ThothDbManager.get_instance(
+    db_type="supabase",
+    db_root_path="./data",
+    db_mode="production",
+    host="db.example.supabase.co",
+    port=5432,
+    database="postgres",
+    user="postgres",
+    password="your_password",
+    project_url="https://your-project.supabase.co",
+    api_key="your_supabase_api_key"
+)
+```
+
 ## Error Handling
 
 The library provides clear error messages for common issues:

{thoth_dbmanager-0.4.13.dist-info → thoth_dbmanager-0.5.1.dist-info}/RECORD

@@ -1,21 +1,18 @@
-thoth_dbmanager/ThothDbManager.py,sha256=6Ew5Z9paTE2R8SJHW29Tf4bOGrYtKyHipSN4luwUXDI,17898
-thoth_dbmanager/__init__.py,sha256=zvs3kqKA99s9RJN6JVWTm-8asMeLc1NG5mnEpJTfzNg,3190
+thoth_dbmanager/ThothDbManager.py,sha256=q-jctgt3MJCDFzq6icQdP1oLeVy1ypg402F4ybxhG8c,8943
+thoth_dbmanager/__init__.py,sha256=Qrd9n7YYMkNKCFiIkzWbjKf5LNOkfp4TkebEpsKqt7E,1655
 thoth_dbmanager/documents.py,sha256=z-f7zo_CZHqoGM0qHT8-lSUx4NhnMNZTSajpoFtRxn4,5051
-thoth_dbmanager/dynamic_imports.py,sha256=nqMmxl2KeczAK-Bi5Fq92f3rPpPsTay-Bq553iHFbWI,7507
-thoth_dbmanager/adapters/__init__.py,sha256=tKIMlo9-gbH_cqnqZJ9yw1zQZKUzsV4hljDUNzcoZXg,486
+thoth_dbmanager/dynamic_imports.py,sha256=xDahgiqKvwSYqjPgHiQqD1XPhAbM_JqnU3OhBp2N-fc,7013
+thoth_dbmanager/adapters/__init__.py,sha256=Ua3ZjSOFlP9kVMFTiC6fyrpcv327b_mBimQ_4fnUsGY,318
 thoth_dbmanager/adapters/mariadb.py,sha256=LTsf0gORiwqZkd6WtKcOsYLHyDgysxdqNesBscbJwNs,5709
-thoth_dbmanager/adapters/mysql.py,sha256=TrFbxoMMNWbmUcgkKQYOIfsstmMUmuLlGB7R4ZFEIYI,5698
-thoth_dbmanager/adapters/oracle.py,sha256=JSrsgohjz5PbVc8nI188MZ4QGBQls4ieNmwWfAKA7II,21468
 thoth_dbmanager/adapters/postgresql.py,sha256=qxdlxOV7Nvn8U4Lhat50w87Z2S8AzBfmLfEwKfz7dis,17299
 thoth_dbmanager/adapters/sqlite.py,sha256=RTDszgnAtkE14LKFeoe9lBHgsqXqkmDk6jDCTmVpnoM,14659
 thoth_dbmanager/adapters/sqlserver.py,sha256=V555kUH54Fb1Atow0BfvbSHmoSwGnrB_RJGn718VQSI,23880
-thoth_dbmanager/adapters/supabase.py,sha256=bl2C6LpOpykPF3vIbdNRDk43aXLADzSk0wQuwTcEHZA,10348
 thoth_dbmanager/core/__init__.py,sha256=FlqNW0GZNv1rnwNgyXGzveLqaw0Z90y5AKhR_1DvHBE,269
-thoth_dbmanager/core/factory.py,sha256=sLj8tKI1ADqSlnU5F0NRtHHtpSimnATuwAqUYx5dfxI,9694
+thoth_dbmanager/core/factory.py,sha256=84EeZYRoH7y7b19EFHqN4X0CSA6dv-0yxUmlX2zHETk,8840
 thoth_dbmanager/core/interfaces.py,sha256=wZpKVQJdwMlAsHTQMB7yVviD2-N_dlOe19F-GhgEoGE,9576
 thoth_dbmanager/core/registry.py,sha256=url4qpQMoMw4rDrdAAvV6L7-NdO4z86xSJPSwTH_l5g,8624
 thoth_dbmanager/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-thoth_dbmanager/helpers/multi_db_generator.py,sha256=LOrWEqh-RTVZXPF7vrlF6BmBGh1XC09kM6XkqkFNPQ4,23232
+thoth_dbmanager/helpers/multi_db_generator.py,sha256=frN0SZtWAfeojoJFLs4XLR3ri6h9pHYc-2O4aLAOlbo,23238
 thoth_dbmanager/helpers/preprocess_values.py,sha256=sKMjD50UL2CZG7-g7KGe3TJQeXmXC7n28LGge8CaP5c,6183
 thoth_dbmanager/helpers/schema.py,sha256=PhHgUxfFe7qUPxdpWQ3YfS593VQjyKtaSKMlChCyLNo,13978
 thoth_dbmanager/helpers/search.py,sha256=k04L7clSPfeQOlq_ifsH3PZ21ZK-rujh_Qy4hWrvSso,3970
@@ -24,16 +21,13 @@ thoth_dbmanager/lsh/core.py,sha256=171FqHW7ItAqAPk6g_AoayKTE3Bs1rRZxnt55MJVzjY,6
 thoth_dbmanager/lsh/factory.py,sha256=2Bpkk-OygjaptZAw1yysxO1cxG3QTxmJ1yFGcXHqX3w,2411
 thoth_dbmanager/lsh/manager.py,sha256=LGrKbGKiBuISlNXaU4Yxfc_BqJfN27MaXapJbzEAjJQ,6513
 thoth_dbmanager/lsh/storage.py,sha256=qei6fwpmRCBSS8CRtDlnZCuWEmyuOK9gVSTkEJdX0eI,4543
-thoth_dbmanager/plugins/__init__.py,sha256=98iKwNiKnFFeJfw0qLGVOrP2Mo2wGPAolsx7R2B3emA,592
+thoth_dbmanager/plugins/__init__.py,sha256=KiamB8UgZujwLUE8Q5suYgqC2i5VEAdmC1m0KF9GgvM,430
 thoth_dbmanager/plugins/mariadb.py,sha256=ElYa4Rexwrofcjcs0UQKan8fZpbU6-n9zghYR9SgRb4,17975
-thoth_dbmanager/plugins/mysql.py,sha256=mbDsIDV2H_BWYANU4JHMsUkxLQICuGtjKTTPbig2Ngs,16546
-thoth_dbmanager/plugins/oracle.py,sha256=k4Yxvz5MdsH3Sfty9lxbhr8igSnHvGbGujz3bLpNcHo,5230
 thoth_dbmanager/plugins/postgresql.py,sha256=pI1W9oHpQty8tHMoEDcsOT-Msv6S4aoFcArOGFxLR7Q,5518
-thoth_dbmanager/plugins/sqlite.py,sha256=ATWubLiLBL04Xjk24oUcZP5rQhksDZVfCwySrLRekiY,8654
+thoth_dbmanager/plugins/sqlite.py,sha256=B-9ATDQacaBHbQTexWNeJo1_F2k1z6JrsApiYI_3FgM,8853
 thoth_dbmanager/plugins/sqlserver.py,sha256=mMb3F5FmSWV02FZwj-Ult-2TjuyeVA4Fl1iME1dbgLU,5289
-thoth_dbmanager/plugins/supabase.py,sha256=mWlaGAdpywx4-pU4Ffpmn24ze8sg0sM5kc6bFDoeYRg,8645
-thoth_dbmanager-0.4.13.dist-info/licenses/LICENSE,sha256=81-BOzGgwtY1XdYfkwMQB87AkOGXI9OMq0kjNcZA4UE,1071
-thoth_dbmanager-0.4.13.dist-info/METADATA,sha256=o6GwJni4Cm_Mt4KveZ2QlbYX6Kc4felT5wOx6Ojopso,12244
-thoth_dbmanager-0.4.13.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-thoth_dbmanager-0.4.13.dist-info/top_level.txt,sha256=b9ttxm9RUc0KUCASEKRx6FqoREYJ1-KZWSpNuaM0uQ4,16
-thoth_dbmanager-0.4.13.dist-info/RECORD,,
+thoth_dbmanager-0.5.1.dist-info/licenses/LICENSE,sha256=81-BOzGgwtY1XdYfkwMQB87AkOGXI9OMq0kjNcZA4UE,1071
+thoth_dbmanager-0.5.1.dist-info/METADATA,sha256=WwtN_HnMRIqWZBT4L9yjHLY56q6B9pRDk1PoJ24QNoQ,14781
+thoth_dbmanager-0.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+thoth_dbmanager-0.5.1.dist-info/top_level.txt,sha256=b9ttxm9RUc0KUCASEKRx6FqoREYJ1-KZWSpNuaM0uQ4,16
+thoth_dbmanager-0.5.1.dist-info/RECORD,,

thoth_dbmanager/adapters/mysql.py

@@ -1,165 +0,0 @@
-"""
-MySQL adapter for Thoth SQL Database Manager.
-"""
-
-from typing import Any, Dict, List, Optional, Union
-from sqlalchemy import create_engine, text
-from sqlalchemy.engine import Engine
-from sqlalchemy.exc import SQLAlchemyError
-
-from ..core.interfaces import DbAdapter
-
-
-class MySQLAdapter(DbAdapter):
-    """MySQL database adapter."""
-    
-    def __init__(self, connection_string: str, **kwargs: Any) -> None:
-        """
-        Initialize MySQL adapter.
-        
-        Args:
-            connection_string: MySQL connection string
-            **kwargs: Additional connection parameters
-        """
-        self.connection_string = connection_string
-        self.engine = None
-        self.connection_params = kwargs
-        
-    def connect(self) -> None:
-        """Establish database connection."""
-        try:
-            self.engine = create_engine(
-                self.connection_string,
-                pool_pre_ping=True,
-                **self.connection_params
-            )
-        except Exception as e:
-            raise ConnectionError(f"Failed to connect to MySQL: {e}")
-    
-    def disconnect(self) -> None:
-        """Close database connection."""
-        if self.engine:
-            self.engine.dispose()
-            self.engine = None
-    
-    def execute_query(self, query: str, params: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
-        """Execute a query and return results."""
-        if not self.engine:
-            self.connect()
-            
-        try:
-            with self.engine.connect() as conn:
-                result = conn.execute(text(query), params or {})
-                return [dict(row._mapping) for row in result]
-        except SQLAlchemyError as e:
-            raise RuntimeError(f"MySQL query failed: {e}")
-    
-    def execute_update(self, query: str, params: Optional[Dict[str, Any]] = None) -> int:
-        """Execute an update query and return affected row count."""
-        if not self.engine:
-            self.connect()
-            
-        try:
-            with self.engine.connect() as conn:
-                result = conn.execute(text(query), params or {})
-                conn.commit()
-                return result.rowcount
-        except SQLAlchemyError as e:
-            raise RuntimeError(f"MySQL update failed: {e}")
-    
-    def get_tables(self) -> List[str]:
-        """Get list of tables in the database."""
-        query = "SHOW TABLES"
-        result = self.execute_query(query)
-        return [list(row.values())[0] for row in result]
-    
-    def get_table_schema(self, table_name: str) -> Dict[str, Any]:
-        """Get schema information for a specific table."""
-        query = f"DESCRIBE {table_name}"
-        columns = self.execute_query(query)
-        
-        schema = {
-            'table_name': table_name,
-            'columns': []
-        }
-        
-        for col in columns:
-            schema['columns'].append({
-                'name': col['Field'],
-                'type': col['Type'],
-                'nullable': col['Null'] == 'YES',
-                'default': col['Default'],
-                'primary_key': col['Key'] == 'PRI'
-            })
-        
-        return schema
-    
-    def get_indexes(self, table_name: str) -> List[Dict[str, Any]]:
-        """Get index information for a table."""
-        query = f"SHOW INDEX FROM {table_name}"
-        indexes = self.execute_query(query)
-        
-        result = []
-        for idx in indexes:
-            result.append({
-                'name': idx['Key_name'],
-                'column': idx['Column_name'],
-                'unique': not idx['Non_unique'],
-                'type': idx['Index_type']
-            })
-        
-        return result
-    
-    def get_foreign_keys(self, table_name: str) -> List[Dict[str, Any]]:
-        """Get foreign key information for a table."""
-        query = f"""
-        SELECT 
-            CONSTRAINT_NAME as name,
-            COLUMN_NAME as column_name,
-            REFERENCED_TABLE_NAME as referenced_table,
-            REFERENCED_COLUMN_NAME as referenced_column
-        FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
-        WHERE TABLE_NAME = '{table_name}' 
-        AND REFERENCED_TABLE_NAME IS NOT NULL
-        """
-        
-        return self.execute_query(query)
-    
-    def create_table(self, table_name: str, schema: Dict[str, Any]) -> None:
-        """Create a new table with the given schema."""
-        columns = []
-        for col in schema.get('columns', []):
-            col_def = f"{col['name']} {col['type']}"
-            if not col.get('nullable', True):
-                col_def += " NOT NULL"
-            if col.get('default') is not None:
-                col_def += f" DEFAULT {col['default']}"
-            if col.get('primary_key'):
-                col_def += " PRIMARY KEY"
-            columns.append(col_def)
-        
-        query = f"CREATE TABLE {table_name} ({', '.join(columns)})"
-        self.execute_update(query)
-    
-    def drop_table(self, table_name: str) -> None:
-        """Drop a table."""
-        query = f"DROP TABLE IF EXISTS {table_name}"
-        self.execute_update(query)
-    
-    def table_exists(self, table_name: str) -> bool:
-        """Check if a table exists."""
-        query = f"""
-        SELECT COUNT(*) as count
-        FROM INFORMATION_SCHEMA.TABLES
-        WHERE TABLE_NAME = '{table_name}'
-        """
-        result = self.execute_query(query)
-        return result[0]['count'] > 0
-    
-    def get_connection_info(self) -> Dict[str, Any]:
-        """Get connection information."""
-        return {
-            'type': 'mysql',
-            'connection_string': self.connection_string,
-            'connected': self.engine is not None
-        }