machbaseapi 2.0.0__py3-none-any.whl

machbaseAPI/types.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+import datetime
+import ipaddress
+from dataclasses import dataclass
+from typing import Any
+
+from . import constants as _C
+
+
+@dataclass(frozen=True)
+class AppendType:
+    name: str
+    spiner_type: int
+
+
+def spiner_type_from_value(value: Any) -> int:
+    if value is None:
+        return _C.CMD_VARCHAR_TYPE
+    if isinstance(value, bool):
+        return _C.CMD_BOOL_TYPE
+    if isinstance(value, int):
+        if 0 <= value <= 0xFFFF:
+            return _C.CMD_UINT16_TYPE
+        if -(2 ** 15) <= value <= (2 ** 15) - 1:
+            return _C.CMD_INT16_TYPE
+        if 0 <= value <= 0xFFFFFFFF:
+            return _C.CMD_UINT32_TYPE
+        if -(2 ** 31) <= value <= (2 ** 31) - 1:
+            return _C.CMD_INT32_TYPE
+        if value >= 0:
+            return _C.CMD_UINT64_TYPE
+        return _C.CMD_INT64_TYPE
+    if isinstance(value, float):
+        return _C.CMD_FLT64_TYPE
+    if isinstance(value, (bytes, bytearray, memoryview)):
+        return _C.CMD_BINARY_TYPE
+    if isinstance(value, (datetime.datetime, datetime.date)):
+        return _C.CMD_DATE_TYPE
+
+    text = str(value)
+    if text:
+        try:
+            addr = ipaddress.ip_address(text)
+            return _C.CMD_IPV6_TYPE if addr.version == 6 else _C.CMD_IPV4_TYPE
+        except ValueError:
+            pass
+    return _C.CMD_VARCHAR_TYPE
+
+
+def spiner_type_from_legacy_sql(sql_type: int) -> int:
+    return _C.CMI_APPEND_TYPE_MAP.get(int(sql_type), _C.CMD_VARCHAR_TYPE)

machbaseapi-2.0.0.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.1
+Name: machbaseapi
+Version: 2.0.0
+Summary: Machbase Python API 2.0 (Pure Python, legacy compatible)
+Home-page: http://www.machbase.com
+Author: machbase
+Author-email: support@machbase.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.6
+Description-Content-Type: text/plain
+
+Copyright of this product 2013-2023,
+Machbase Corporation(or Inc.) or its subsidiaries.
+All Rights reserved.
+
+http://www.machbase.com
+
+support@machbase.com
+
+Machbase Python API 2.0 (English introduction)
+
+This package is a pure Python implementation of Machbase client protocol and provides a
+drop-in replacement API compatible with the legacy Python API.
+
+Key changes in version 2.0
+
+1. Pure Python implementation
+- Native binary libraries (`.so`, `.dylib`, `.dll`) are no longer required.
+- Wire protocol, packet framing, and marshal/unmarshal logic are implemented in Python modules
+  (`protocol.py`, `marshal.py`, `packet.py`).
+- Distribution is platform independent (`py3-none-any` wheel).
+
+2. Fully compatible with existing interfaces
+- Existing entry points are preserved (`machbase`, `machbaseAPI`, `connect`, `MachbaseConnection`, `MachbaseCursor`).
+- Legacy call patterns for common operations are maintained for migration (`open`, `close`, `openEx`,
+  `execute`, `select`, `fetch`, `append`, DB-API cursor execution/fetch).
+- Existing sample scripts and test code can be executed using the new package without adapter code.
+- Existing behavior for unsupported features is preserved as explicit errors.
+
+3. Improved append API
+- Append payload handling accepts flexible row shapes in practical usage.
+- `types` can be inferred from active append session and explicit type metadata.
+- Async-friendly append path: callers can supply callbacks and receive protocol ack handling
+  without forcing unnecessary blocking.
+- Improved row normalization and validation for mixed input forms.
+
+4. Reliability and API strictness improvements
+- Connection pooling is rejected with clear errors because pooling is intentionally not supported.
+- Unknown connection options are rejected up front (fast validation).
+- Expanded DB-API compatible exception mapping.
+- Safer close/shutdown cleanup for sockets and sessions.
+- Consistent internal encoding for bytes/binary-like values during legacy-style APIs.
+
+5. Operational and migration notes
+- Binary wheel no longer embeds platform native modules.
+- Installation is lightweight and easier to mirror in CI/build pipelines.
+- Version is updated to `2.0.0` (package revision for migration cycle).
+
+What changed for users migrating from 1.x
+
+- Connection
+  - Use the same host/port/user/password defaults as before.
+  - No `lib` copy or platform-specific package setup required.
+- Append
+  - Existing `append` usage is supported; session-based and immediate append flows remain available.
+- Compatibility boundaries
+  - Existing scripts that relied on hidden/undocumented native behaviors may need review.
+  - Pooling-related keys or unsupported options will now raise immediate errors (instead of being ignored).
+
+Known limitations and troubleshooting
+
+- Auto commit model
+  - Transactions are auto-commit by protocol design for this API.
+- High-volume append
+  - Performance gains from batching large payloads are still recommended.
+  - For ultra-high throughput scenarios, tune client-side batching strategy in your application.
+- Error handling
+  - Append/append_data and query errors are surfaced through return status and callbacks according to API layer.
+
+FAQ
+
+- Why only `py3-none-any`?
+  - The package does not load platform-specific binaries anymore.
+- Where can I check differences from old binaries?
+  - Refer to `CHANGELOG.md` and API regression test suite in `test/regress`.
+
+For full behavioral and compatibility reference, see `CHANGELOG.md` and the regression test set.
+
+
+# Changelog
+
+## 2.0.0
+
+### Changed
+- Migrated to a pure Python implementation of Machbase protocol processing.
+- Removed dependency on native dynamic libraries (`.so`, `.dll`, `.dylib`) from runtime package.
+- Kept legacy API compatibility as the primary migration strategy:
+  - `machbase` and `machbaseAPI` legacy styles
+  - `connect`, `MachbaseConnection`, `MachbaseCursor`
+  - legacy sample script behavior for connection/query/append use cases
+- Improved append handling:
+  - more flexible row normalization in session and one-shot append paths
+  - async-friendly acknowledgement callback flow
+  - stronger validation around row/type consistency
+- Strengthened connection argument validation:
+  - pooling-related options are explicitly rejected
+  - unknown keyword options are rejected with clear error messages
+
+### Fixed
+- Unified protocol implementation path to Python-only marshal/packet parsing.
+- Removed native bridge-related packaging behavior and binary cleanup assumptions.
+- Reduced hidden binary cleanup side effects in build artifacts and packaging files.
+
+### Notes
+- Package version is set to `2.0.0`.
+- Binary distribution format remains source-compatible with legacy test artifacts when using
+  `PYTHONPATH`-based execution.

machbaseapi-2.0.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+machbaseAPI/__init__.py,sha256=5HbjuttKoIlTOi8JGMhalhy06FbV0kYpgg3ITFT-orw,592
+machbaseAPI/connector.py,sha256=GJriAl0EUrY4_lxNAdZRx8tVJo3Qs0kGr7-PSaZFL5Y,8089
+machbaseAPI/conntest.py,sha256=zqzeq59hkg9ucIkejPwep-G0hMt5ISdByJkQJmO6uPg,732
+machbaseAPI/constants.py,sha256=M4g-yX_u5rus0hO-hmTkutK9fw4IteNi6mF7fy2qLXs,5404
+machbaseAPI/errors.py,sha256=WCKQj3LXM1H34xlM2orm1tlK7a4xpy1xZtxXJazP2Nc,795
+machbaseAPI/machbaseAPI.py,sha256=mlrpUFB00FA0y4B26tdb8AfYSZCT_tQML4ZO7EljwQ8,11056
+machbaseAPI/marshal.py,sha256=sXrdNxe4WEhz8QePlxe2nfasD7r4FEGpmqo7nbURw6g,8124
+machbaseAPI/packet.py,sha256=TLb2oKflSVuLQK03o69fxQCoglbErCjC5LBg66z5rAE,2753
+machbaseAPI/protocol.py,sha256=hteGEXKD7iRstZT_xnpKt0hOixUEWpuCos3C005VBLU,26540
+machbaseAPI/types.py,sha256=LJWeBj5HTTHPq9UFJDaCQqToQQvsK3Ce7iKU5R5TnDw,1481
+machbaseAPI/sample/ConnTest.py,sha256=cQKmxXexlqOC7b4ERD59pws3EYEkEE-C_yy3VZnZp3Y,1520
+machbaseAPI/sample/MakeData.py,sha256=7oJ4wSX0MZ399rQfabmnmKhrWWa9mw1oBgf3MvXBYI8,752
+machbaseAPI/sample/Sample1Connect.py,sha256=HCM1LL7zSra_fpdM8O1eHsQTzQj3YDQDKdvX0MD1UM8,728
+machbaseAPI/sample/Sample2Simple.py,sha256=IUFF0Z9-EMf3onF2_lzPnOILiazBvD1tCIng6TXPmr0,2545
+machbaseAPI/sample/Sample3Append.py,sha256=p2dbj5bIvyDAnEM2Ef90PcMN0jyzonL9Ib3AgmYa73U,2097
+machbaseAPI/sample/Sample4Fetch.py,sha256=0xAUCQ2OZ9KJxu7D4LybmSLKoUVQseMqyCxNnoszQy8,4009
+machbaseAPI/sample/Sample5Append2.py,sha256=QcpKILfsHvHLZ2x8VEsu9Pf2B2bgvWAlO20kHIrv7K0,2371
+machbaseAPI/sample/Sample5ConnectEx.py,sha256=0xF384u0EqXkVCIzT1Z2ld-SdjuD32GYRBS2rWMA8cY,1555
+machbaseAPI/sample/__init__.py,sha256=Zu6q0k0Mqi4mN48_j7BMHCXEwTCpqdo0OXh2dnXixg0,57
+machbaseAPI/sample/data.txt,sha256=QMHDO82-WFE_eKDk6oiBRvX7-i07RfjwOXwQkqVf73s,15653
+machbaseapi-2.0.0.dist-info/METADATA,sha256=ot8gZOG3vOJQQqeh3bDS-gm2FPMZ2W8KDSBDZvunXB8,5293
+machbaseapi-2.0.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+machbaseapi-2.0.0.dist-info/top_level.txt,sha256=-9HwUvafn-uTM9ckDWa2sxP4AZE7YNdhjVWRgOAhhH0,12
+machbaseapi-2.0.0.dist-info/RECORD,,

machbaseapi-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

machbaseapi-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+machbaseAPI