dbapi-mongodb 0.1.0__tar.gz

dbapi_mongodb-0.1.0/LICENSE

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

dbapi_mongodb-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: dbapi-mongodb
+Version: 0.1.0
+Summary: DBAPI-style adapter that translates SQL (JOIN/DDL/aggregations) into MongoDB operations
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pymongo<4.0,>=3.13
+Requires-Dist: sqlglot>=25.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "dev"
+Dynamic: license-file
+
+# dbapi-mongodb
+
+DBAPI-style adapter that lets you execute a limited subset of SQL against MongoDB by translating SQL to Mongo queries. Built on `pymongo` (3.13.x for MongoDB 3.6 compatibility) and `SQLGlot`.
+
+Purpose: let existing DB-API / SQLAlchemy Core / FastAPI code treat MongoDB as “just another dialect.”
+
+- PyPI package name: `dbapi-mongodb`
+- Module import name: `mongo_dbapi`
+
+## Features
+- DBAPI-like `Connection`/`Cursor`
+- SQL → Mongo: `SELECT/INSERT/UPDATE/DELETE`, `CREATE/DROP TABLE/INDEX` (ASC/DESC, UNIQUE, composite), `WHERE` (comparisons/`AND`/`OR`/`IN`/`BETWEEN`/`LIKE`→`$regex`/`ILIKE`/regex literal), `ORDER BY`, `LIMIT/OFFSET`, INNER/LEFT JOIN (equijoin, composite keys up to 3 hops), `GROUP BY` + aggregates (COUNT/SUM/AVG/MIN/MAX) + `HAVING`, `UNION ALL`, subqueries (`WHERE IN/EXISTS`, `FROM (SELECT ...)`), `ROW_NUMBER() OVER (PARTITION BY ... ORDER BY ...)` on MongoDB 5.x+
+- `%s` positional and `%(name)s` named parameters; unsupported constructs raise Error IDs (e.g. `[mdb][E2]`)
+- Error IDs for common failures: invalid URI, unsupported SQL, unsafe DML without WHERE, parse errors, connection/auth failures
+- DBAPI fields: `rowcount`, `lastrowid`, `description` (column order: explicit order, or alpha for `SELECT *`; JOIN uses left→right)
+- Transactions: `begin/commit/rollback` wrap Mongo sessions; MongoDB 3.6 and other unsupported envs are treated as no-op success
+- Async dialect (thread-pool backed) for Core CRUD/DDL/Index with FastAPI-friendly usage; minimal ORM CRUD for single-table entities (relationships out of scope)
+
+- Use cases
+  - Swap in Mongo as “another dialect” for existing SQLAlchemy Core–based infra (Engine/Connection + Table/Column)
+  - Point existing Core-based batch/report jobs at Mongo data with minimal changes
+  - Minimal ORM CRUD for single-table entities (PK → `_id`)
+  - Async dialect for FastAPI/async stacks (thread-pool implementation; native async later)
+
+## Requirements
+- Python 3.10+
+- MongoDB 3.6 (bundled `mongodb-3.6` binary) or later (note: bundled binary is 3.6, so transactions are unsupported)
+- Virtualenv at `.venv` (already present); dependencies are managed via `pyproject.toml`
+
+## Installation
+```bash
+pip install dbapi-mongodb
+# (optional) with a virtualenv: python -m venv .venv && . .venv/bin/activate && pip install dbapi-mongodb
+```
+
+## Start local MongoDB (bundled 3.6)
+```bash
+# Default port 27017; override with PORT
+PORT=27018 ./startdb.sh
+```
+
+## Start local MongoDB 4.4 (replica set, bundled)
+```bash
+# Default port 27019; uses bundled libssl1.1. LD_LIBRARY_PATH is set inside the script for mongod.
+PORT=27019 ./start4xdb.sh
+# Run tests against 4.x
+MONGODB_URI=mongodb://127.0.0.1:27019 MONGODB_DB=mongo_dbapi_test .venv/bin/pytest -q
+```
+
+## Usage example
+```python
+from mongo_dbapi import connect
+
+conn = connect("mongodb://127.0.0.1:27018", "mongo_dbapi_test")
+cur = conn.cursor()
+cur.execute("INSERT INTO users (id, name) VALUES (%s, %s)", (1, "Alice"))
+
+cur.execute("SELECT id, name FROM users WHERE id = %s", (1,))
+print(cur.fetchall())  # [(1, 'Alice')]
+print(cur.rowcount)    # 1
+```
+
+## Supported SQL
+- Statements: `SELECT`, `INSERT`, `UPDATE`, `DELETE`, `CREATE/DROP TABLE`, `CREATE/DROP INDEX`
+- WHERE: comparisons (`=`, `<>`, `>`, `<`, `<=`, `>=`), `AND`, `OR`, `IN`, `BETWEEN`, `LIKE` (`%`/`_` → `$regex`), `ILIKE`, regex literal `/.../`
+- JOIN: INNER/LEFT equijoin (composite keys, up to 3 joins)
+- Aggregation: `GROUP BY` with COUNT/SUM/AVG/MIN/MAX and `HAVING`
+- Subqueries: `WHERE IN/EXISTS` and `FROM (SELECT ...)` (non-correlated; executed first)
+- Set ops: `UNION ALL`
+- Window: `ROW_NUMBER() OVER (PARTITION BY ... ORDER BY ...)` on MongoDB 5.x+ (`[mdb][E2]` on earlier versions)
+- ORDER/LIMIT/OFFSET
+- Unsupported: non-equi joins, FULL/RIGHT OUTER, `UNION` (distinct), window functions other than `ROW_NUMBER`, correlated subqueries, ORM relationships
+
+## SQLAlchemy
+- DBAPI module attributes: `apilevel="2.0"`, `threadsafety=1`, `paramstyle="pyformat"`.
+- Scheme: `mongodb+dbapi://...` dialect provided (sync + async/thread-pool).
+- Scope: Core text()/Table/Column CRUD/DDL/Index、ORM 最小 CRUD（単一テーブル）、JOIN/UNION ALL/HAVING/subquery/ROW_NUMBER を実通信で確認済み。async dialect は Core CRUD/DDL/Index のラップで、ネイティブ async は今後検討。
+
+## Async (FastAPI/Core) - beta
+- **Current implementation wraps the sync driver in a thread pool** (native async driver is planned). Provided via `mongo_dbapi.async_dbapi.connect_async`. API mirrors sync Core: awaitable CRUD/DDL/Index, JOIN/UNION ALL/HAVING/IN/EXISTS/FROM subquery.
+- Transactions: effective on MongoDB 4.x+ only; 3.6 is no-op. Be mindful that MongoDB transactions differ from RDBMS in locking/perf; avoid heavy transactional workloads.
+- Window: `ROW_NUMBER` is available on MongoDB 5.x+; earlier versions return `[mdb][E2] Unsupported SQL construct: WINDOW_FUNCTION`.
+- FastAPI example:
+```python
+from fastapi import FastAPI, Depends
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncConnection
+from sqlalchemy import text
+
+engine = create_async_engine("mongodb+dbapi://127.0.0.1:27019/mongo_dbapi_test")
+app = FastAPI()
+
+async def get_conn() -> AsyncConnection:
+    async with engine.connect() as conn:
+        yield conn
+
+@app.get("/users/{user_id}")
+async def get_user(user_id: str, conn: AsyncConnection = Depends(get_conn)):
+    rows = await conn.execute(text("SELECT id, name FROM users WHERE id = :id"), {"id": user_id})
+    row = rows.fetchone()
+    return dict(row) if row else {}
+```
+- Limitations: async ORM/relationship and statement cache are out of scope; heavy concurrency uses a thread pool under the hood. 
+
+## Support levels
+- Tested/stable (real Mongo runs): single-collection CRUD, WHERE/ORDER/LIMIT/OFFSET, INNER/LEFT equijoin (up to 3 hops), GROUP BY + aggregates + HAVING, subqueries (WHERE IN/EXISTS, FROM (SELECT ...)), UNION ALL, `ROW_NUMBER()` (MongoDB 5.x+).
+- Not supported / constraints: non-equi JOIN, FULL/RIGHT OUTER, distinct `UNION`, window functions other than `ROW_NUMBER`, correlated subqueries, ORM relationships; async is thread-pool based.
+
+## Running tests
+```bash
+PORT=27018 ./startdb.sh  # if 27017 is taken
+MONGODB_URI=mongodb://127.0.0.1:27018 MONGODB_DB=mongo_dbapi_test .venv/bin/pytest -q
+```
+
+## Notes
+- Transactions on MongoDB 3.6 are treated as no-op; 4.x+ (replica set) uses real sessions and the bundled 4.4 binary passes all tests.
+- Error messages are fixed strings per `docs/spec.md`. Keep logs at DEBUG only (default INFO is silent).
+
+## License
+MIT License (see `LICENSE`). Provided as-is without warranty; commercial use permitted.
+
+## GitHub Sponsors
+Maintained in personal time. If this helps you run MongoDB from DB-API/SQLAlchemy stacks, consider supporting via GitHub Sponsors to keep fixes and version updates coming.

dbapi_mongodb-0.1.0/README.md

@@ -0,0 +1,122 @@
+# dbapi-mongodb
+
+DBAPI-style adapter that lets you execute a limited subset of SQL against MongoDB by translating SQL to Mongo queries. Built on `pymongo` (3.13.x for MongoDB 3.6 compatibility) and `SQLGlot`.
+
+Purpose: let existing DB-API / SQLAlchemy Core / FastAPI code treat MongoDB as “just another dialect.”
+
+- PyPI package name: `dbapi-mongodb`
+- Module import name: `mongo_dbapi`
+
+## Features
+- DBAPI-like `Connection`/`Cursor`
+- SQL → Mongo: `SELECT/INSERT/UPDATE/DELETE`, `CREATE/DROP TABLE/INDEX` (ASC/DESC, UNIQUE, composite), `WHERE` (comparisons/`AND`/`OR`/`IN`/`BETWEEN`/`LIKE`→`$regex`/`ILIKE`/regex literal), `ORDER BY`, `LIMIT/OFFSET`, INNER/LEFT JOIN (equijoin, composite keys up to 3 hops), `GROUP BY` + aggregates (COUNT/SUM/AVG/MIN/MAX) + `HAVING`, `UNION ALL`, subqueries (`WHERE IN/EXISTS`, `FROM (SELECT ...)`), `ROW_NUMBER() OVER (PARTITION BY ... ORDER BY ...)` on MongoDB 5.x+
+- `%s` positional and `%(name)s` named parameters; unsupported constructs raise Error IDs (e.g. `[mdb][E2]`)
+- Error IDs for common failures: invalid URI, unsupported SQL, unsafe DML without WHERE, parse errors, connection/auth failures
+- DBAPI fields: `rowcount`, `lastrowid`, `description` (column order: explicit order, or alpha for `SELECT *`; JOIN uses left→right)
+- Transactions: `begin/commit/rollback` wrap Mongo sessions; MongoDB 3.6 and other unsupported envs are treated as no-op success
+- Async dialect (thread-pool backed) for Core CRUD/DDL/Index with FastAPI-friendly usage; minimal ORM CRUD for single-table entities (relationships out of scope)
+
+- Use cases
+  - Swap in Mongo as “another dialect” for existing SQLAlchemy Core–based infra (Engine/Connection + Table/Column)
+  - Point existing Core-based batch/report jobs at Mongo data with minimal changes
+  - Minimal ORM CRUD for single-table entities (PK → `_id`)
+  - Async dialect for FastAPI/async stacks (thread-pool implementation; native async later)
+
+## Requirements
+- Python 3.10+
+- MongoDB 3.6 (bundled `mongodb-3.6` binary) or later (note: bundled binary is 3.6, so transactions are unsupported)
+- Virtualenv at `.venv` (already present); dependencies are managed via `pyproject.toml`
+
+## Installation
+```bash
+pip install dbapi-mongodb
+# (optional) with a virtualenv: python -m venv .venv && . .venv/bin/activate && pip install dbapi-mongodb
+```
+
+## Start local MongoDB (bundled 3.6)
+```bash
+# Default port 27017; override with PORT
+PORT=27018 ./startdb.sh
+```
+
+## Start local MongoDB 4.4 (replica set, bundled)
+```bash
+# Default port 27019; uses bundled libssl1.1. LD_LIBRARY_PATH is set inside the script for mongod.
+PORT=27019 ./start4xdb.sh
+# Run tests against 4.x
+MONGODB_URI=mongodb://127.0.0.1:27019 MONGODB_DB=mongo_dbapi_test .venv/bin/pytest -q
+```
+
+## Usage example
+```python
+from mongo_dbapi import connect
+
+conn = connect("mongodb://127.0.0.1:27018", "mongo_dbapi_test")
+cur = conn.cursor()
+cur.execute("INSERT INTO users (id, name) VALUES (%s, %s)", (1, "Alice"))
+
+cur.execute("SELECT id, name FROM users WHERE id = %s", (1,))
+print(cur.fetchall())  # [(1, 'Alice')]
+print(cur.rowcount)    # 1
+```
+
+## Supported SQL
+- Statements: `SELECT`, `INSERT`, `UPDATE`, `DELETE`, `CREATE/DROP TABLE`, `CREATE/DROP INDEX`
+- WHERE: comparisons (`=`, `<>`, `>`, `<`, `<=`, `>=`), `AND`, `OR`, `IN`, `BETWEEN`, `LIKE` (`%`/`_` → `$regex`), `ILIKE`, regex literal `/.../`
+- JOIN: INNER/LEFT equijoin (composite keys, up to 3 joins)
+- Aggregation: `GROUP BY` with COUNT/SUM/AVG/MIN/MAX and `HAVING`
+- Subqueries: `WHERE IN/EXISTS` and `FROM (SELECT ...)` (non-correlated; executed first)
+- Set ops: `UNION ALL`
+- Window: `ROW_NUMBER() OVER (PARTITION BY ... ORDER BY ...)` on MongoDB 5.x+ (`[mdb][E2]` on earlier versions)
+- ORDER/LIMIT/OFFSET
+- Unsupported: non-equi joins, FULL/RIGHT OUTER, `UNION` (distinct), window functions other than `ROW_NUMBER`, correlated subqueries, ORM relationships
+
+## SQLAlchemy
+- DBAPI module attributes: `apilevel="2.0"`, `threadsafety=1`, `paramstyle="pyformat"`.
+- Scheme: `mongodb+dbapi://...` dialect provided (sync + async/thread-pool).
+- Scope: Core text()/Table/Column CRUD/DDL/Index、ORM 最小 CRUD（単一テーブル）、JOIN/UNION ALL/HAVING/subquery/ROW_NUMBER を実通信で確認済み。async dialect は Core CRUD/DDL/Index のラップで、ネイティブ async は今後検討。
+
+## Async (FastAPI/Core) - beta
+- **Current implementation wraps the sync driver in a thread pool** (native async driver is planned). Provided via `mongo_dbapi.async_dbapi.connect_async`. API mirrors sync Core: awaitable CRUD/DDL/Index, JOIN/UNION ALL/HAVING/IN/EXISTS/FROM subquery.
+- Transactions: effective on MongoDB 4.x+ only; 3.6 is no-op. Be mindful that MongoDB transactions differ from RDBMS in locking/perf; avoid heavy transactional workloads.
+- Window: `ROW_NUMBER` is available on MongoDB 5.x+; earlier versions return `[mdb][E2] Unsupported SQL construct: WINDOW_FUNCTION`.
+- FastAPI example:
+```python
+from fastapi import FastAPI, Depends
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncConnection
+from sqlalchemy import text
+
+engine = create_async_engine("mongodb+dbapi://127.0.0.1:27019/mongo_dbapi_test")
+app = FastAPI()
+
+async def get_conn() -> AsyncConnection:
+    async with engine.connect() as conn:
+        yield conn
+
+@app.get("/users/{user_id}")
+async def get_user(user_id: str, conn: AsyncConnection = Depends(get_conn)):
+    rows = await conn.execute(text("SELECT id, name FROM users WHERE id = :id"), {"id": user_id})
+    row = rows.fetchone()
+    return dict(row) if row else {}
+```
+- Limitations: async ORM/relationship and statement cache are out of scope; heavy concurrency uses a thread pool under the hood. 
+
+## Support levels
+- Tested/stable (real Mongo runs): single-collection CRUD, WHERE/ORDER/LIMIT/OFFSET, INNER/LEFT equijoin (up to 3 hops), GROUP BY + aggregates + HAVING, subqueries (WHERE IN/EXISTS, FROM (SELECT ...)), UNION ALL, `ROW_NUMBER()` (MongoDB 5.x+).
+- Not supported / constraints: non-equi JOIN, FULL/RIGHT OUTER, distinct `UNION`, window functions other than `ROW_NUMBER`, correlated subqueries, ORM relationships; async is thread-pool based.
+
+## Running tests
+```bash
+PORT=27018 ./startdb.sh  # if 27017 is taken
+MONGODB_URI=mongodb://127.0.0.1:27018 MONGODB_DB=mongo_dbapi_test .venv/bin/pytest -q
+```
+
+## Notes
+- Transactions on MongoDB 3.6 are treated as no-op; 4.x+ (replica set) uses real sessions and the bundled 4.4 binary passes all tests.
+- Error messages are fixed strings per `docs/spec.md`. Keep logs at DEBUG only (default INFO is silent).
+
+## License
+MIT License (see `LICENSE`). Provided as-is without warranty; commercial use permitted.
+
+## GitHub Sponsors
+Maintained in personal time. If this helps you run MongoDB from DB-API/SQLAlchemy stacks, consider supporting via GitHub Sponsors to keep fixes and version updates coming.

dbapi_mongodb-0.1.0/dbapi_mongodb.egg-info/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: dbapi-mongodb
+Version: 0.1.0
+Summary: DBAPI-style adapter that translates SQL (JOIN/DDL/aggregations) into MongoDB operations
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pymongo<4.0,>=3.13
+Requires-Dist: sqlglot>=25.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "dev"
+Dynamic: license-file
+
+# dbapi-mongodb
+
+DBAPI-style adapter that lets you execute a limited subset of SQL against MongoDB by translating SQL to Mongo queries. Built on `pymongo` (3.13.x for MongoDB 3.6 compatibility) and `SQLGlot`.
+
+Purpose: let existing DB-API / SQLAlchemy Core / FastAPI code treat MongoDB as “just another dialect.”
+
+- PyPI package name: `dbapi-mongodb`
+- Module import name: `mongo_dbapi`
+
+## Features
+- DBAPI-like `Connection`/`Cursor`
+- SQL → Mongo: `SELECT/INSERT/UPDATE/DELETE`, `CREATE/DROP TABLE/INDEX` (ASC/DESC, UNIQUE, composite), `WHERE` (comparisons/`AND`/`OR`/`IN`/`BETWEEN`/`LIKE`→`$regex`/`ILIKE`/regex literal), `ORDER BY`, `LIMIT/OFFSET`, INNER/LEFT JOIN (equijoin, composite keys up to 3 hops), `GROUP BY` + aggregates (COUNT/SUM/AVG/MIN/MAX) + `HAVING`, `UNION ALL`, subqueries (`WHERE IN/EXISTS`, `FROM (SELECT ...)`), `ROW_NUMBER() OVER (PARTITION BY ... ORDER BY ...)` on MongoDB 5.x+
+- `%s` positional and `%(name)s` named parameters; unsupported constructs raise Error IDs (e.g. `[mdb][E2]`)
+- Error IDs for common failures: invalid URI, unsupported SQL, unsafe DML without WHERE, parse errors, connection/auth failures
+- DBAPI fields: `rowcount`, `lastrowid`, `description` (column order: explicit order, or alpha for `SELECT *`; JOIN uses left→right)
+- Transactions: `begin/commit/rollback` wrap Mongo sessions; MongoDB 3.6 and other unsupported envs are treated as no-op success
+- Async dialect (thread-pool backed) for Core CRUD/DDL/Index with FastAPI-friendly usage; minimal ORM CRUD for single-table entities (relationships out of scope)
+
+- Use cases
+  - Swap in Mongo as “another dialect” for existing SQLAlchemy Core–based infra (Engine/Connection + Table/Column)
+  - Point existing Core-based batch/report jobs at Mongo data with minimal changes
+  - Minimal ORM CRUD for single-table entities (PK → `_id`)
+  - Async dialect for FastAPI/async stacks (thread-pool implementation; native async later)
+
+## Requirements
+- Python 3.10+
+- MongoDB 3.6 (bundled `mongodb-3.6` binary) or later (note: bundled binary is 3.6, so transactions are unsupported)
+- Virtualenv at `.venv` (already present); dependencies are managed via `pyproject.toml`
+
+## Installation
+```bash
+pip install dbapi-mongodb
+# (optional) with a virtualenv: python -m venv .venv && . .venv/bin/activate && pip install dbapi-mongodb
+```
+
+## Start local MongoDB (bundled 3.6)
+```bash
+# Default port 27017; override with PORT
+PORT=27018 ./startdb.sh
+```
+
+## Start local MongoDB 4.4 (replica set, bundled)
+```bash
+# Default port 27019; uses bundled libssl1.1. LD_LIBRARY_PATH is set inside the script for mongod.
+PORT=27019 ./start4xdb.sh
+# Run tests against 4.x
+MONGODB_URI=mongodb://127.0.0.1:27019 MONGODB_DB=mongo_dbapi_test .venv/bin/pytest -q
+```
+
+## Usage example
+```python
+from mongo_dbapi import connect
+
+conn = connect("mongodb://127.0.0.1:27018", "mongo_dbapi_test")
+cur = conn.cursor()
+cur.execute("INSERT INTO users (id, name) VALUES (%s, %s)", (1, "Alice"))
+
+cur.execute("SELECT id, name FROM users WHERE id = %s", (1,))
+print(cur.fetchall())  # [(1, 'Alice')]
+print(cur.rowcount)    # 1
+```
+
+## Supported SQL
+- Statements: `SELECT`, `INSERT`, `UPDATE`, `DELETE`, `CREATE/DROP TABLE`, `CREATE/DROP INDEX`
+- WHERE: comparisons (`=`, `<>`, `>`, `<`, `<=`, `>=`), `AND`, `OR`, `IN`, `BETWEEN`, `LIKE` (`%`/`_` → `$regex`), `ILIKE`, regex literal `/.../`
+- JOIN: INNER/LEFT equijoin (composite keys, up to 3 joins)
+- Aggregation: `GROUP BY` with COUNT/SUM/AVG/MIN/MAX and `HAVING`
+- Subqueries: `WHERE IN/EXISTS` and `FROM (SELECT ...)` (non-correlated; executed first)
+- Set ops: `UNION ALL`
+- Window: `ROW_NUMBER() OVER (PARTITION BY ... ORDER BY ...)` on MongoDB 5.x+ (`[mdb][E2]` on earlier versions)
+- ORDER/LIMIT/OFFSET
+- Unsupported: non-equi joins, FULL/RIGHT OUTER, `UNION` (distinct), window functions other than `ROW_NUMBER`, correlated subqueries, ORM relationships
+
+## SQLAlchemy
+- DBAPI module attributes: `apilevel="2.0"`, `threadsafety=1`, `paramstyle="pyformat"`.
+- Scheme: `mongodb+dbapi://...` dialect provided (sync + async/thread-pool).
+- Scope: Core text()/Table/Column CRUD/DDL/Index、ORM 最小 CRUD（単一テーブル）、JOIN/UNION ALL/HAVING/subquery/ROW_NUMBER を実通信で確認済み。async dialect は Core CRUD/DDL/Index のラップで、ネイティブ async は今後検討。
+
+## Async (FastAPI/Core) - beta
+- **Current implementation wraps the sync driver in a thread pool** (native async driver is planned). Provided via `mongo_dbapi.async_dbapi.connect_async`. API mirrors sync Core: awaitable CRUD/DDL/Index, JOIN/UNION ALL/HAVING/IN/EXISTS/FROM subquery.
+- Transactions: effective on MongoDB 4.x+ only; 3.6 is no-op. Be mindful that MongoDB transactions differ from RDBMS in locking/perf; avoid heavy transactional workloads.
+- Window: `ROW_NUMBER` is available on MongoDB 5.x+; earlier versions return `[mdb][E2] Unsupported SQL construct: WINDOW_FUNCTION`.
+- FastAPI example:
+```python
+from fastapi import FastAPI, Depends
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncConnection
+from sqlalchemy import text
+
+engine = create_async_engine("mongodb+dbapi://127.0.0.1:27019/mongo_dbapi_test")
+app = FastAPI()
+
+async def get_conn() -> AsyncConnection:
+    async with engine.connect() as conn:
+        yield conn
+
+@app.get("/users/{user_id}")
+async def get_user(user_id: str, conn: AsyncConnection = Depends(get_conn)):
+    rows = await conn.execute(text("SELECT id, name FROM users WHERE id = :id"), {"id": user_id})
+    row = rows.fetchone()
+    return dict(row) if row else {}
+```
+- Limitations: async ORM/relationship and statement cache are out of scope; heavy concurrency uses a thread pool under the hood. 
+
+## Support levels
+- Tested/stable (real Mongo runs): single-collection CRUD, WHERE/ORDER/LIMIT/OFFSET, INNER/LEFT equijoin (up to 3 hops), GROUP BY + aggregates + HAVING, subqueries (WHERE IN/EXISTS, FROM (SELECT ...)), UNION ALL, `ROW_NUMBER()` (MongoDB 5.x+).
+- Not supported / constraints: non-equi JOIN, FULL/RIGHT OUTER, distinct `UNION`, window functions other than `ROW_NUMBER`, correlated subqueries, ORM relationships; async is thread-pool based.
+
+## Running tests
+```bash
+PORT=27018 ./startdb.sh  # if 27017 is taken
+MONGODB_URI=mongodb://127.0.0.1:27018 MONGODB_DB=mongo_dbapi_test .venv/bin/pytest -q
+```
+
+## Notes
+- Transactions on MongoDB 3.6 are treated as no-op; 4.x+ (replica set) uses real sessions and the bundled 4.4 binary passes all tests.
+- Error messages are fixed strings per `docs/spec.md`. Keep logs at DEBUG only (default INFO is silent).
+
+## License
+MIT License (see `LICENSE`). Provided as-is without warranty; commercial use permitted.
+
+## GitHub Sponsors
+Maintained in personal time. If this helps you run MongoDB from DB-API/SQLAlchemy stacks, consider supporting via GitHub Sponsors to keep fixes and version updates coming.

dbapi_mongodb-0.1.0/dbapi_mongodb.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+dbapi_mongodb.egg-info/PKG-INFO
+dbapi_mongodb.egg-info/SOURCES.txt
+dbapi_mongodb.egg-info/dependency_links.txt
+dbapi_mongodb.egg-info/requires.txt
+dbapi_mongodb.egg-info/top_level.txt
+mongo_dbapi/__init__.py
+mongo_dbapi/async_dbapi.py
+mongo_dbapi/dbapi.py
+mongo_dbapi/errors.py
+mongo_dbapi/sqlalchemy_dialect.py
+mongo_dbapi/translation.py
+tests/test_async_dbapi.py
+tests/test_dbapi.py
+tests/test_transactions.py
+tests/test_translation.py

dbapi_mongodb-0.1.0/dbapi_mongodb.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dbapi_mongodb-0.1.0/dbapi_mongodb.egg-info/requires.txt

@@ -0,0 +1,6 @@
+pymongo<4.0,>=3.13
+sqlglot>=25.7.0
+
+[dev]
+pytest>=8.3.0
+sqlalchemy>=2.0.0

dbapi_mongodb-0.1.0/dbapi_mongodb.egg-info/top_level.txt

@@ -0,0 +1 @@
+mongo_dbapi

dbapi_mongodb-0.1.0/mongo_dbapi/__init__.py

@@ -0,0 +1,13 @@
+from .dbapi import Connection, Cursor, connect
+from .errors import MongoDbApiError
+
+# DB-API style exception hook for SQLAlchemy / DB-API 仕様の Error エイリアス
+Error = MongoDbApiError
+
+apilevel = "2.0"
+threadsafety = 1
+paramstyle = "pyformat"
+
+from . import sqlalchemy_dialect  # noqa: E402,F401 register dialect
+
+__all__ = ["connect", "Connection", "Cursor", "MongoDbApiError", "Error", "apilevel", "threadsafety", "paramstyle"]

dbapi_mongodb-0.1.0/mongo_dbapi/async_dbapi.py

@@ -0,0 +1,74 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Any, Mapping, Sequence
+
+from .dbapi import Connection, Cursor, connect
+
+
+class AsyncCursor:
+    """Async wrapper for Cursor / Cursor の非同期ラッパー"""
+
+    def __init__(self, sync_cursor: Cursor):
+        self._sync_cursor = sync_cursor
+
+    async def execute(self, sql: str, params: Sequence | Mapping | None = None) -> "AsyncCursor":
+        await asyncio.to_thread(self._sync_cursor.execute, sql, params)
+        return self
+
+    async def executemany(self, sql: str, seq_of_params: Sequence[Sequence | Mapping]) -> "AsyncCursor":
+        await asyncio.to_thread(self._sync_cursor.executemany, sql, seq_of_params)
+        return self
+
+    async def fetchone(self) -> tuple | None:
+        return await asyncio.to_thread(self._sync_cursor.fetchone)
+
+    async def fetchall(self) -> list[tuple]:
+        return await asyncio.to_thread(self._sync_cursor.fetchall)
+
+    @property
+    def rowcount(self) -> int:
+        return self._sync_cursor.rowcount
+
+    @property
+    def lastrowid(self) -> Any:
+        return self._sync_cursor.lastrowid
+
+    @property
+    def description(self):
+        return self._sync_cursor.description
+
+    async def close(self) -> None:
+        await asyncio.to_thread(self._sync_cursor.close)
+
+
+class AsyncConnection:
+    """Async wrapper for Connection / Connection の非同期ラッパー"""
+
+    def __init__(self, sync_conn: Connection):
+        self._sync_conn = sync_conn
+
+    async def cursor(self) -> AsyncCursor:
+        cur = await asyncio.to_thread(self._sync_conn.cursor)
+        return AsyncCursor(cur)
+
+    async def begin(self) -> None:
+        await asyncio.to_thread(self._sync_conn.begin)
+
+    async def commit(self) -> None:
+        await asyncio.to_thread(self._sync_conn.commit)
+
+    async def rollback(self) -> None:
+        await asyncio.to_thread(self._sync_conn.rollback)
+
+    async def list_tables(self) -> list[str]:
+        return await asyncio.to_thread(self._sync_conn.list_tables)
+
+    async def close(self) -> None:
+        await asyncio.to_thread(self._sync_conn.close)
+
+
+async def connect_async(uri: str, db_name: str) -> AsyncConnection:
+    """Async factory for Connection / Connection の非同期ファクトリ"""
+    sync_conn = await asyncio.to_thread(connect, uri, db_name)
+    return AsyncConnection(sync_conn)