thoth-dbmanager 0.4.13__tar.gz → 0.5.1__tar.gz

{thoth_dbmanager-0.4.13/thoth_dbmanager.egg-info → thoth_dbmanager-0.5.1}/PKG-INFO

@@ -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 → thoth_dbmanager-0.5.1}/README.md

@@ -8,12 +8,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
@@ -202,9 +273,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",
@@ -218,7 +297,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",
@@ -228,20 +363,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 → thoth_dbmanager-0.5.1}/pyproject.toml

@@ -1,20 +1,20 @@
 [build-system]
-requires = ["setuptools>=61.0"]
+requires = ["setuptools>=61.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "thoth_dbmanager"
-version = "0.4.13"
+version = "0.5.1"
 authors = [
   { name="Marco Pancotti", email="mp@tylconsulting.it" },
 ]
 description = "A Python library for managing SQL databases with support for multiple database types, LSH-based similarity search, and a modern plugin architecture."
 readme = "README.md"
 keywords = ["database", "sql", "lsh", "similarity-search", "orm"]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
+
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -36,23 +36,15 @@ dependencies = [
 ]
 [project.optional-dependencies]
 postgresql = ["psycopg2-binary>=2.9.0"]
-mysql = ["mysql-connector-python>=8.0.0"]
 mariadb = ["mariadb>=1.1.0"]
-sqlserver = ["pyodbc>=4.0.0", "pymssql>=2.3.0"]
-oracle = ["cx_Oracle>=8.3.0", "oracledb>=3.0.0"]
-supabase = ["supabase>=2.0.0", "postgrest-py>=0.10.0", "gotrue>=1.0.0"]
+sqlserver = ["pyodbc>=4.0.0"]
 sqlite = []
 
 # Convenience groups
 all = [
     "psycopg2-binary>=2.9.0",
-    "mysql-connector-python>=8.0.0", 
     "mariadb>=1.1.0",
     "pyodbc>=4.0.0",
-    "pymssql>=2.3.0",
-    "cx_Oracle>=8.3.0",
-    "oracledb>=3.0.0",
-    "supabase>=2.0.0",
 ]
 
 # Development dependencies
@@ -71,7 +63,8 @@ dev = [
 
 # Testing with specific databases
 test-postgresql = ["pytest>=7.0.0", "psycopg2-binary>=2.9.0"]
-test-mysql = ["pytest>=7.0.0", "mysql-connector-python>=8.0.0"]
+test-mariadb = ["pytest>=7.0.0", "mariadb>=1.1.0"]
+test-sqlserver = ["pytest>=7.0.0", "pyodbc>=4.0.0"]
 
 [project.urls]
 "Homepage" = "https://github.com/mptyl/thoth_dbmanager"
@@ -81,8 +74,8 @@ test-mysql = ["pytest>=7.0.0", "mysql-connector-python>=8.0.0"]
 
 [tool.setuptools.packages.find]
 where = ["."]
-include = ["dbmanager*", "thoth_dbmanager*"]
-exclude = ["tests*", "test_*", "*.tests", "*.tests.*", "data*", "lsh-test*"]
+include = ["thoth_dbmanager*"]
+exclude = ["tests*", "test_*", "*.tests", "*.tests.*", "data*"]
 
 [tool.setuptools.package-data]
 "*" = ["*.md", "*.txt", "*.yml", "*.yaml"]