py-flink-sql-gateway 0.1.0.dev0__tar.gz → 0.1.1.dev0__tar.gz

py_flink_sql_gateway-0.1.0.dev0/README.md → py_flink_sql_gateway-0.1.1.dev0/PKG-INFO

@@ -1,5 +1,22 @@
+Metadata-Version: 2.4
+Name: py-flink-sql-gateway
+Version: 0.1.1.dev0
+Summary: A lightweight Python driver for the Apache Flink SQL Gateway, implementing PEP 249 (DB-API 2.0).
+Author-email: Ilya Soin <ilya.soin@exness.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28.1
+Description-Content-Type: text/markdown
+
 # py-flink-sql-gateway
 
+[![CI](https://github.com/exness/py-flink-sql-gateway/actions/workflows/ci.yml/badge.svg)](https://github.com/exness/py-flink-sql-gateway/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/py-flink-sql-gateway)](https://pypi.org/project/py-flink-sql-gateway/)
+[![Python](https://img.shields.io/pypi/pyversions/py-flink-sql-gateway)](https://pypi.org/project/py-flink-sql-gateway/)
+
 A lightweight Python driver for the **Apache Flink SQL Gateway**, implementing [PEP 249 (DB-API 2.0)](https://peps.python.org/pep-0249/).
 
 ## Installation
@@ -61,6 +78,18 @@ with connect("http://localhost:8083") as conn:
 
 > **Tip:** `ROW` and `MAP` types arrive as Python `dict`, `ARRAY` arrives as `list`. Binary data is passed through as-is.
 
+### Connection options
+
+```python
+# Pass Flink session properties
+with connect("http://localhost:8083", properties={"pipeline.name": "my-job"}) as conn:
+    ...
+
+# Set a query timeout (default: 300s)
+with conn.cursor(query_timeout=60.0) as cur:
+    cur.execute("SELECT ...")
+```
+
 ### Low-level REST access
 
 If you need features beyond DB-API, use the exported client directly:
@@ -78,7 +107,7 @@ with FlinkSqlGatewayClient("http://localhost:8083") as client:
 Python uses `None` for SQL NULLs natively — no wrapper types needed.
 
 | Flink Type                | Python Type        |
-|---------------------------|--------------------|
+|---------------------------|:------------------:|
 | TINYINT / SMALLINT / INT  | `int`              |
 | BIGINT / INTERVAL         | `int`              |
 | FLOAT / DOUBLE            | `float`            |
@@ -93,21 +122,29 @@ Python uses `None` for SQL NULLs natively — no wrapper types needed.
 | MAP                       | `dict`             |
 | ARRAY                     | `list`             |
 
+Nested complex types (e.g. `MAP<STRING, ROW<..., MAP<STRING, ROW<TIMESTAMP>>>>`) are recursively decoded to the correct Python types.
+
 ---
 
 ## Development & tests
 
-Requires Python 3.13+ and [uv](https://docs.astral.sh/uv/).
+Requires Python 3.11+ and [uv](https://docs.astral.sh/uv/).
 
 ```bash
 # Install dependencies
-uv sync
+uv sync --group dev
+
+# Set up pre-commit hooks (runs on every push)
+pre-commit install --hook-type pre-push
 
 # Run unit tests (no Docker needed)
 uv run pytest tests/test_client.py tests/test_dbapi.py -v
 
-# Run all tests including integration (requires Docker)
-uv run pytest tests/ -v
+# Run integration tests (requires Docker)
+uv run pytest tests/test_integration.py -v -s -m integration
+
+# Run all pre-commit checks manually
+pre-commit run --all-files
 ```
 
 Integration tests spin up a Flink cluster (JobManager + TaskManager + SQL Gateway) via [testcontainers-python](https://testcontainers-python.readthedocs.io/).
@@ -116,4 +153,4 @@ Integration tests spin up a Flink cluster (JobManager + TaskManager + SQL Gatewa
 
 ## License
 
-MIT (see LICENSE)
+MIT

py_flink_sql_gateway-0.1.0.dev0/PKG-INFO → py_flink_sql_gateway-0.1.1.dev0/README.md

@@ -1,14 +1,9 @@
-Metadata-Version: 2.4
-Name: py-flink-sql-gateway
-Version: 0.1.0.dev0
-Summary: A Python client for the Apache Flink SQL Gateway REST API
-Author-email: Ilya Soin <ilya.soin@exness.com>
-Requires-Python: >=3.11
-Requires-Dist: httpx>=0.28.1
-Description-Content-Type: text/markdown
-
 # py-flink-sql-gateway
 
+[![CI](https://github.com/exness/py-flink-sql-gateway/actions/workflows/ci.yml/badge.svg)](https://github.com/exness/py-flink-sql-gateway/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/py-flink-sql-gateway)](https://pypi.org/project/py-flink-sql-gateway/)
+[![Python](https://img.shields.io/pypi/pyversions/py-flink-sql-gateway)](https://pypi.org/project/py-flink-sql-gateway/)
+
 A lightweight Python driver for the **Apache Flink SQL Gateway**, implementing [PEP 249 (DB-API 2.0)](https://peps.python.org/pep-0249/).
 
 ## Installation
@@ -70,6 +65,18 @@ with connect("http://localhost:8083") as conn:
 
 > **Tip:** `ROW` and `MAP` types arrive as Python `dict`, `ARRAY` arrives as `list`. Binary data is passed through as-is.
 
+### Connection options
+
+```python
+# Pass Flink session properties
+with connect("http://localhost:8083", properties={"pipeline.name": "my-job"}) as conn:
+    ...
+
+# Set a query timeout (default: 300s)
+with conn.cursor(query_timeout=60.0) as cur:
+    cur.execute("SELECT ...")
+```
+
 ### Low-level REST access
 
 If you need features beyond DB-API, use the exported client directly:
@@ -87,7 +94,7 @@ with FlinkSqlGatewayClient("http://localhost:8083") as client:
 Python uses `None` for SQL NULLs natively — no wrapper types needed.
 
 | Flink Type                | Python Type        |
-|---------------------------|--------------------|
+|---------------------------|:------------------:|
 | TINYINT / SMALLINT / INT  | `int`              |
 | BIGINT / INTERVAL         | `int`              |
 | FLOAT / DOUBLE            | `float`            |
@@ -102,21 +109,29 @@ Python uses `None` for SQL NULLs natively — no wrapper types needed.
 | MAP                       | `dict`             |
 | ARRAY                     | `list`             |
 
+Nested complex types (e.g. `MAP<STRING, ROW<..., MAP<STRING, ROW<TIMESTAMP>>>>`) are recursively decoded to the correct Python types.
+
 ---
 
 ## Development & tests
 
-Requires Python 3.13+ and [uv](https://docs.astral.sh/uv/).
+Requires Python 3.11+ and [uv](https://docs.astral.sh/uv/).
 
 ```bash
 # Install dependencies
-uv sync
+uv sync --group dev
+
+# Set up pre-commit hooks (runs on every push)
+pre-commit install --hook-type pre-push
 
 # Run unit tests (no Docker needed)
 uv run pytest tests/test_client.py tests/test_dbapi.py -v
 
-# Run all tests including integration (requires Docker)
-uv run pytest tests/ -v
+# Run integration tests (requires Docker)
+uv run pytest tests/test_integration.py -v -s -m integration
+
+# Run all pre-commit checks manually
+pre-commit run --all-files
 ```
 
 Integration tests spin up a Flink cluster (JobManager + TaskManager + SQL Gateway) via [testcontainers-python](https://testcontainers-python.readthedocs.io/).
@@ -125,4 +140,4 @@ Integration tests spin up a Flink cluster (JobManager + TaskManager + SQL Gatewa
 
 ## License
 
-MIT (see LICENSE)
+MIT

{py_flink_sql_gateway-0.1.0.dev0 → py_flink_sql_gateway-0.1.1.dev0}/pyproject.toml

@@ -1,12 +1,18 @@
 [project]
 name = "py-flink-sql-gateway"
 dynamic = ["version"]
-description = "A Python client for the Apache Flink SQL Gateway REST API"
+description = "A lightweight Python driver for the Apache Flink SQL Gateway, implementing PEP 249 (DB-API 2.0)."
 readme = "README.md"
 authors = [
     { name = "Ilya Soin", email = "ilya.soin@exness.com" }
 ]
 requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
 dependencies = [
     "httpx>=0.28.1",
 ]

{py_flink_sql_gateway-0.1.0.dev0 → py_flink_sql_gateway-0.1.1.dev0}/src/flink_gateway/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.0.dev0'
-__version_tuple__ = version_tuple = (0, 1, 0, 'dev0')
+__version__ = version = '0.1.1.dev0'
+__version_tuple__ = version_tuple = (0, 1, 1, 'dev0')
 
 __commit_id__ = commit_id = None

{py_flink_sql_gateway-0.1.0.dev0 → py_flink_sql_gateway-0.1.1.dev0}/tests/test_integration.py

@@ -342,7 +342,12 @@ def test_filesystem_row_complex_type(flink_gateway_url: str):
                     nested_map MAP<STRING, ROW<
                         ts TIMESTAMP(3)
                     >>
-                >> NOT NULL
+                >> NOT NULL,
+                price       DECIMAL(10, 2) NOT NULL,
+                birth_date  DATE NOT NULL,
+                start_time  TIME(0) NOT NULL,
+                created_at  TIMESTAMP(3) NOT NULL,
+                updated_ltz TIMESTAMP_LTZ(3) NOT NULL
             ) WITH (
                 'connector' = 'filesystem',
                 'format' = 'json',
@@ -375,7 +380,12 @@ def test_filesystem_row_complex_type(flink_gateway_url: str):
                              ROW(TIMESTAMP '2024-03-15 09:30:00.000')
                          ]
                      )
-                 ]
+                 ],
+                 CAST(99.95 AS DECIMAL(10, 2)),
+                 DATE '2024-06-15',
+                 TIME '14:30:00',
+                 TIMESTAMP '2024-06-15 14:30:00.123',
+                 TO_TIMESTAMP_LTZ(1718458200123, 3)
                 ),
                 (2, 'beta',
                  ROW(20, 'B'),
@@ -395,7 +405,12 @@ def test_filesystem_row_complex_type(flink_gateway_url: str):
                              ROW(TIMESTAMP '2025-07-04 18:45:00.000')
                          ]
                      )
-                 ]
+                 ],
+                 CAST(199.99 AS DECIMAL(10, 2)),
+                 DATE '2025-12-25',
+                 TIME '09:15:30',
+                 TIMESTAMP '2025-12-25 09:15:30.456',
+                 TO_TIMESTAMP_LTZ(1735117530456, 3)
                 )
         """,
         )
@@ -467,3 +482,34 @@ def test_filesystem_row_complex_type(flink_gateway_url: str):
     assert dm["env2"]["nested_map"]["svc3"]["ts"] == datetime.datetime(
         2025, 7, 4, 18, 45, 0
     )
+
+    # ── Type conversion assertions ────────────────────────────────
+    # Row 1
+    r = by_id[1]
+
+    # DECIMAL → Decimal
+    assert r[9] == Decimal("99.95")
+    assert isinstance(r[9], Decimal)
+
+    # DATE → datetime.date
+    assert r[10] == datetime.date(2024, 6, 15)
+    assert isinstance(r[10], datetime.date)
+
+    # TIME → datetime.time
+    assert r[11] == datetime.time(14, 30, 0)
+    assert isinstance(r[11], datetime.time)
+
+    # TIMESTAMP → datetime.datetime
+    assert r[12] == datetime.datetime(2024, 6, 15, 14, 30, 0, 123000)
+    assert isinstance(r[12], datetime.datetime)
+
+    # TIMESTAMP_LTZ → datetime.datetime
+    assert isinstance(r[13], datetime.datetime)
+
+    # Row 2
+    r = by_id[2]
+    assert r[9] == Decimal("199.99")
+    assert r[10] == datetime.date(2025, 12, 25)
+    assert r[11] == datetime.time(9, 15, 30)
+    assert r[12] == datetime.datetime(2025, 12, 25, 9, 15, 30, 456000)
+    assert isinstance(r[13], datetime.datetime)

{py_flink_sql_gateway-0.1.0.dev0 → py_flink_sql_gateway-0.1.1.dev0}/uv.lock

@@ -195,7 +195,6 @@ wheels = [
 
 [[package]]
 name = "py-flink-sql-gateway"
-version = "0.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },