pymnemon 0.1.1__tar.gz

pymnemon-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The pymnemon contributors
+
+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.

pymnemon-0.1.1/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+recursive-exclude build *
+recursive-exclude dist *
+recursive-exclude *.egg-info *
+recursive-exclude __pycache__ *

pymnemon-0.1.1/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: pymnemon
+Version: 0.1.1
+Summary: Unified db connector system with normalized error handling across multiple databases.
+Author-email: Causum <support@causum.com>
+Maintainer-email: Causum <support@causum.com>
+License: MIT License
+        
+        Copyright (c) 2026 The pymnemon contributors
+        
+        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.
+        
+Project-URL: Repository, https://gitlab.com/causum/mnemon
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: SQLAlchemy==2.0.45
+Requires-Dist: psycopg2-binary
+Requires-Dist: sqlalchemy-bigquery
+Requires-Dist: google-cloud-bigquery
+Requires-Dist: redshift-connector
+Requires-Dist: clickhouse-driver
+Requires-Dist: clickhouse-sqlalchemy>=0.3
+Requires-Dist: duckdb
+Requires-Dist: PyMySQL
+Requires-Dist: pyodbc
+Requires-Dist: databricks-sql-connector>=3.0
+Requires-Dist: trino
+Requires-Dist: PyHive
+Requires-Dist: vertica-python
+Requires-Dist: oracledb
+Requires-Dist: teradatasql
+Requires-Dist: ibm-db
+Requires-Dist: ibm-db-sa
+Requires-Dist: snowflake-sqlalchemy
+Requires-Dist: google-cloud-bigquery-storage
+Requires-Dist: PyAthena[SQLAlchemy]
+Dynamic: license-file
+
+# pymnemon
+
+Unified SQLAlchemy connector with normalized error handling across multiple databases.
+
+Note: The PyPI package name is `pymnemon`, but the import name is `mnemon`.
+
+## Install
+
+```bash
+pip install pymnemon
+```
+
+## Quickstart
+
+```python
+from mnemon import SchemaDBConnection
+
+config = {
+    "database_type": "postgresql",
+    "auth_method": "password",
+    "connection": {
+        "user": "dbuser",
+        "password": "dbpass",
+        "host": "localhost",
+        "port": 5432,
+        "database": "analytics",
+        # optional
+        # "sslmode": "require",
+    },
+}
+
+with SchemaDBConnection(config) as db:
+    ok, engine, error = db.safe_connect()
+    if not ok:
+        print(error)
+    else:
+        rows = db.execute_query("SELECT 1 AS ok")
+        print(rows)
+```
+
+## Configuration
+
+`SchemaDBConnection` expects a config dict with this shape:
+
+```python
+{
+  "database_type": "<supported database>",
+  "auth_method": "<supported auth method>",
+  "connection": { ... database-specific fields ... }
+}
+```
+
+Supported databases and auth methods:
+
+- postgresql: password, scram, ssl_verify, ssl_cert
+- mysql: password, ssl_verify, ssl_cert
+- mariadb: password, ssl_verify, ssl_cert
+- clickhouse: password, ssl_verify, ssl_cert
+- sqlserver: password
+- trino: none, password, jwt, certificate
+- sparksql: none, password, ldap
+- vertica: password, ldap, ssl_verify
+- oracle: password, wallet
+- teradata: password, ldap
+- db2: password, ldap
+- snowflake: password, key_pair
+- bigquery: service_account
+- redshift: password, iam_role
+- duckdb: local_file, motherduck
+- databricks: token, oauth_m2m
+- athena: iam_credentials
+
+### Example configs
+
+PostgreSQL (password):
+
+```python
+{
+  "database_type": "postgresql",
+  "auth_method": "password",
+  "connection": {
+    "user": "dbuser",
+    "password": "dbpass",
+    "host": "localhost",
+    "port": 5432,
+    "database": "analytics"
+  }
+}
+```
+
+Snowflake (key pair):
+
+```python
+{
+  "database_type": "snowflake",
+  "auth_method": "key_pair",
+  "connection": {
+    "account": "xy12345.us-east-1",
+    "user": "DBUSER",
+    "warehouse": "COMPUTE_WH",
+    "database": "ANALYTICS",
+    "schema": "PUBLIC",
+    "private_key": {"content": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"},
+    "private_key_passphrase": "optional"
+  }
+}
+```
+
+BigQuery (service account):
+
+```python
+{
+  "database_type": "bigquery",
+  "auth_method": "service_account",
+  "connection": {
+    "project": "my-gcp-project",
+    "dataset": "analytics",
+    "location": "US",
+    "credentials_json": {"content": "{... service account json ...}"}
+  }
+}
+```
+
+Databricks (PAT):
+
+```python
+{
+  "database_type": "databricks",
+  "auth_method": "token",
+  "connection": {
+    "host": "adb-1234567890.12.azuredatabricks.net",
+    "http_path": "/sql/1.0/warehouses/abcd1234",
+    "access_token": "dapi..."
+  }
+}
+```
+
+## Error handling
+
+`safe_connect()` returns `(success, engine, error)` where `error` is a normalized JSON payload with:
+
+```json
+{
+  "success": false,
+  "error": {
+    "category": "auth_failed",
+    "message": "Authentication failed. Please check your credentials.",
+    "next_steps": ["Verify username and password"],
+    "field_hint": "user or password",
+    "details": "... original error ..."
+  }
+}
+```
+
+## Notes on dependencies
+
+Some drivers require system dependencies or extra setup:
+
+- `pyodbc` for SQL Server requires an ODBC driver (e.g., ODBC Driver 18).
+- `oracledb` may require Oracle client configuration depending on mode.
+- `PyAthena[SQLAlchemy]` is used for Athena SQLAlchemy dialect support.
+
+## License
+
+MIT

pymnemon-0.1.1/README.md

@@ -0,0 +1,165 @@
+# pymnemon
+
+Unified SQLAlchemy connector with normalized error handling across multiple databases.
+
+Note: The PyPI package name is `pymnemon`, but the import name is `mnemon`.
+
+## Install
+
+```bash
+pip install pymnemon
+```
+
+## Quickstart
+
+```python
+from mnemon import SchemaDBConnection
+
+config = {
+    "database_type": "postgresql",
+    "auth_method": "password",
+    "connection": {
+        "user": "dbuser",
+        "password": "dbpass",
+        "host": "localhost",
+        "port": 5432,
+        "database": "analytics",
+        # optional
+        # "sslmode": "require",
+    },
+}
+
+with SchemaDBConnection(config) as db:
+    ok, engine, error = db.safe_connect()
+    if not ok:
+        print(error)
+    else:
+        rows = db.execute_query("SELECT 1 AS ok")
+        print(rows)
+```
+
+## Configuration
+
+`SchemaDBConnection` expects a config dict with this shape:
+
+```python
+{
+  "database_type": "<supported database>",
+  "auth_method": "<supported auth method>",
+  "connection": { ... database-specific fields ... }
+}
+```
+
+Supported databases and auth methods:
+
+- postgresql: password, scram, ssl_verify, ssl_cert
+- mysql: password, ssl_verify, ssl_cert
+- mariadb: password, ssl_verify, ssl_cert
+- clickhouse: password, ssl_verify, ssl_cert
+- sqlserver: password
+- trino: none, password, jwt, certificate
+- sparksql: none, password, ldap
+- vertica: password, ldap, ssl_verify
+- oracle: password, wallet
+- teradata: password, ldap
+- db2: password, ldap
+- snowflake: password, key_pair
+- bigquery: service_account
+- redshift: password, iam_role
+- duckdb: local_file, motherduck
+- databricks: token, oauth_m2m
+- athena: iam_credentials
+
+### Example configs
+
+PostgreSQL (password):
+
+```python
+{
+  "database_type": "postgresql",
+  "auth_method": "password",
+  "connection": {
+    "user": "dbuser",
+    "password": "dbpass",
+    "host": "localhost",
+    "port": 5432,
+    "database": "analytics"
+  }
+}
+```
+
+Snowflake (key pair):
+
+```python
+{
+  "database_type": "snowflake",
+  "auth_method": "key_pair",
+  "connection": {
+    "account": "xy12345.us-east-1",
+    "user": "DBUSER",
+    "warehouse": "COMPUTE_WH",
+    "database": "ANALYTICS",
+    "schema": "PUBLIC",
+    "private_key": {"content": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"},
+    "private_key_passphrase": "optional"
+  }
+}
+```
+
+BigQuery (service account):
+
+```python
+{
+  "database_type": "bigquery",
+  "auth_method": "service_account",
+  "connection": {
+    "project": "my-gcp-project",
+    "dataset": "analytics",
+    "location": "US",
+    "credentials_json": {"content": "{... service account json ...}"}
+  }
+}
+```
+
+Databricks (PAT):
+
+```python
+{
+  "database_type": "databricks",
+  "auth_method": "token",
+  "connection": {
+    "host": "adb-1234567890.12.azuredatabricks.net",
+    "http_path": "/sql/1.0/warehouses/abcd1234",
+    "access_token": "dapi..."
+  }
+}
+```
+
+## Error handling
+
+`safe_connect()` returns `(success, engine, error)` where `error` is a normalized JSON payload with:
+
+```json
+{
+  "success": false,
+  "error": {
+    "category": "auth_failed",
+    "message": "Authentication failed. Please check your credentials.",
+    "next_steps": ["Verify username and password"],
+    "field_hint": "user or password",
+    "details": "... original error ..."
+  }
+}
+```
+
+## Notes on dependencies
+
+Some drivers require system dependencies or extra setup:
+
+- `pyodbc` for SQL Server requires an ODBC driver (e.g., ODBC Driver 18).
+- `oracledb` may require Oracle client configuration depending on mode.
+- `PyAthena[SQLAlchemy]` is used for Athena SQLAlchemy dialect support.
+
+## License
+
+MIT

pymnemon-0.1.1/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=67", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pymnemon"
+version = "0.1.1"
+description = "Unified db connector system with normalized error handling across multiple databases."
+readme = "README.md"
+license = {file = "LICENSE"}
+requires-python = ">=3.9"
+authors = [
+  {name = "Causum", email = "support@causum.com"},
+]
+maintainers = [
+  {name = "Causum", email = "support@causum.com"},
+]
+urls = {Repository = "https://gitlab.com/causum/mnemon"}
+dependencies = [
+	"SQLAlchemy==2.0.45",
+
+	# postgres
+	"psycopg2-binary",
+	# bigquery
+	"sqlalchemy-bigquery",
+	"google-cloud-bigquery",
+	# redshift
+	"redshift-connector",
+	# clickhouse
+	"clickhouse-driver",
+	"clickhouse-sqlalchemy>=0.3",
+	# duckdb
+	"duckdb",
+	# mysql
+	"PyMySQL",
+	# sqlserver
+	"pyodbc",
+	# databricks (NO sqlalchemy wrapper)
+	"databricks-sql-connector>=3.0",
+	# trino
+	"trino",
+	# hive
+	"PyHive",
+	# vertica
+	"vertica-python",
+	# oracle
+	"oracledb",
+	# teradata
+	"teradatasql",
+	# db2
+	"ibm-db",
+	"ibm-db-sa",
+	# snowflake
+	"snowflake-sqlalchemy",
+	# bigquery
+	"google-cloud-bigquery-storage",
+	# athena
+	"PyAthena[SQLAlchemy]",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["mnemon*"]

pymnemon-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pymnemon-0.1.1/src/mnemon/__init__.py

@@ -0,0 +1,10 @@
+"""
+mnemon
+------
+
+Public entrypoint for the SchemaDBConnection helper.
+"""
+
+from .db_connect import SchemaDBConnection
+
+__all__ = ["SchemaDBConnection"]