tsurugi-dbapi 0.9.0__tar.gz

tsurugi_dbapi-0.9.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: tsurugi-dbapi
+Version: 0.9.0
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Database
+Classifier: Topic :: Database :: Front-Ends
+Summary: Python DB API 2.0 (PEP 249) driver for Tsurugi
+Keywords: database,db-api,dbapi,dbapi2,pep249,sql,tsurugidb,tsurugi
+Home-Page: https://github.com/project-tsurugi/tsubakuro-rust/tree/master/tsubakuro-rust-python
+Author: Project Tsurugi
+License-Expression: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://tsurugi-dbapi.readthedocs.io/
+Project-URL: Homepage, https://github.com/project-tsurugi/tsubakuro-rust/tree/master/tsubakuro-rust-python
+Project-URL: Repository, https://github.com/project-tsurugi/tsubakuro-rust.git
+
+# Tsurugi Python DB-API
+
+Tsurugi Python DB-API (tsurugi-dbapi) is a Python DB API 2.0 driver for accessing [Tsurugi](https://github.com/project-tsurugi/tsurugidb).
+
+## Target
+
+- Tsurugi 1.10.0 or later
+- Python 3.10 or later
+- Python DB API 2.0 (PEP 249)
+
+## Limitation
+
+- Only TCP connection is available.
+- The default transaction_type is `OCC`.
+- The default commit_type is `DEFAULT`.
+- The default shutdown_type is `GRACEFUL`.
+- BLOB/CLOB is not supported.
+
+## Installation
+
+```bash
+uv add tsurugi-dbapi
+```
+
+## Example
+
+```python
+import tsurugi_dbapi as tsurugi
+
+def example():
+    with tsurugi.connect(
+        endpoint="tcp://localhost:12345",
+        user="tsurugi",
+        password="password",
+        default_timeout=30,  # seconds
+    ) as connection:
+        with connection.cursor() as cursor:
+            cursor.execute("insert into example values (1, 100, 'abc')")
+            print("insert rowcount:", cursor.rowcount)
+            connection.commit()
+
+            cursor.execute("select * from example")
+            for row in cursor:
+                print("row:", row)
+            connection.commit()
+```
+
+See [examples](https://github.com/project-tsurugi/tsubakuro-rust/tree/master/tsubakuro-rust-python/examples) for more examples.
+
+## License
+
+[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)

tsurugi_dbapi-0.9.0/docs/README.md

@@ -0,0 +1,52 @@
+# Tsurugi Python DB-API
+
+Tsurugi Python DB-API (tsurugi-dbapi) is a Python DB API 2.0 driver for accessing [Tsurugi](https://github.com/project-tsurugi/tsurugidb).
+
+## Target
+
+- Tsurugi 1.10.0 or later
+- Python 3.10 or later
+- Python DB API 2.0 (PEP 249)
+
+## Limitation
+
+- Only TCP connection is available.
+- The default transaction_type is `OCC`.
+- The default commit_type is `DEFAULT`.
+- The default shutdown_type is `GRACEFUL`.
+- BLOB/CLOB is not supported.
+
+## Installation
+
+```bash
+uv add tsurugi-dbapi
+```
+
+## Example
+
+```python
+import tsurugi_dbapi as tsurugi
+
+def example():
+    with tsurugi.connect(
+        endpoint="tcp://localhost:12345",
+        user="tsurugi",
+        password="password",
+        default_timeout=30,  # seconds
+    ) as connection:
+        with connection.cursor() as cursor:
+            cursor.execute("insert into example values (1, 100, 'abc')")
+            print("insert rowcount:", cursor.rowcount)
+            connection.commit()
+
+            cursor.execute("select * from example")
+            for row in cursor:
+                print("row:", row)
+            connection.commit()
+```
+
+See [examples](https://github.com/project-tsurugi/tsubakuro-rust/tree/master/tsubakuro-rust-python/examples) for more examples.
+
+## License
+
+[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)

tsurugi_dbapi-0.9.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["maturin>=1.7,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "tsurugi-dbapi"
+requires-python = ">=3.10"
+authors = [
+  {name = "Project Tsurugi"},
+]
+description = "Python DB API 2.0 (PEP 249) driver for Tsurugi"
+readme = "docs/README.md"
+license = "Apache-2.0"
+keywords = ["database", "db-api", "dbapi", "dbapi2", "pep249", "sql", "tsurugidb", "tsurugi"]
+classifiers = [
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: 3",
+    "Topic :: Database",
+    "Topic :: Database :: Front-Ends",
+]
+dynamic = ["version"]
+
+[tool.maturin]
+module-name = "tsurugi_dbapi._tsubakuro_rust_python"
+exclude = ["**/__pycache__", "**/*.pyc"]
+manifest-path = "tsubakuro-rust-python/Cargo.toml"
+python-source = "python"
+
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { file = "src/**/*.rs" }, { file = "Cargo.toml" }, { file = "Cargo.lock" }, { file = "python/**/*.py" }]
+
+[dependency-groups]
+dev = [
+  "mkdocs>=1.6.1",
+  "mkdocs-material>=9.6.20",
+    "pdoc3>=0.11.6",
+  "pymdown-extensions>=10.15",
+    "pytest>=9.0.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/project-tsurugi/tsubakuro-rust/tree/master/tsubakuro-rust-python"
+Documentation = "https://tsurugi-dbapi.readthedocs.io/"
+Repository = "https://github.com/project-tsurugi/tsubakuro-rust.git"

tsurugi_dbapi-0.9.0/python/tsurugi_dbapi/__init__.py

@@ -0,0 +1,32 @@
+"""
+Tsurugi Python DB-API.
+
+Examples:
+
+    ```python
+    import tsurugi_dbapi as tsurugi
+
+    with tsurugi.connect(
+        endpoint="tcp://localhost:12345",
+        user="tsurugi",
+        password="password",
+        default_timeout=30,  # seconds
+    ) as connection:
+        with connection.cursor() as cursor:
+            cursor.execute("insert into example values (1, 100, 'abc')")
+            print("insert rowcount:", cursor.rowcount)
+            connection.commit()
+
+            cursor.execute("select * from example")
+            for row in cursor:
+                print("row:", row)
+            connection.commit()
+    ```
+
+Note:
+    See `Config`, `connect()`, `Connection`, and `Cursor` for more details.
+"""
+
+from ._tsubakuro_rust_python import *
+
+__all__ = [name for name in globals() if not name.startswith("_")]