jetstream-api 0.6.0__tar.gz → 0.6.1__tar.gz

{jetstream_api-0.6.0 → jetstream_api-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.0
+Version: 0.6.1
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.6.0 → jetstream_api-0.6.1}/ilink/__init__.py

@@ -1,6 +1,6 @@
 """iLink - Python client API for iLink M.O.M. (Message Oriented Middleware)."""
 
-__version__ = "0.6.0"
+__version__ = "0.6.1"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser

{jetstream_api-0.6.0 → jetstream_api-0.6.1}/ilink/admin.py

@@ -3430,9 +3430,13 @@ class ILAdminQmgr:
             ILOperationException: 엔진이 6.3.3(rev 3067) 미만일 때.
 
         Note:
-            유량 통계는 6.3.4 에서 들어왔다. 구엔진은 요청 코드 자체를 모르므로
-            응답이 없거나 엉뚱한 리포트가 온다. 무엇이 잘못됐는지 알 수 없는
-            타임아웃 대신 **왜 안 되는지 적힌 예외**로 끊는다.
+            배열 요청(3344)은 엔진 6.3.3.3067 에서 들어왔다. 그 미만 엔진은 이
+            코드를 모르고 ``MIMQE_INVALID_REQ_CODE`` 를 돌려준다 - 즉시 응답이라
+            행이 나지는 않지만(6.3.1 에서 7ms, 실측), 호출자에게는 **왜 안 되는지
+            적힌 예외**가 더 쓸모가 있다.
+
+            **단건 조회에는 이 게이트를 걸지 않는다.** 요청 코드 3201 은 훨씬
+            오래된 코드라 6.3.1.2813 에서도 정상 응답한다(실측).
         """
         if 0 < self.revision < ILC.QUEUE_FLOW_ARRAY_MIN_REVISION:
             raise ILOperationException(
@@ -3793,14 +3797,19 @@ class ILAdminQmgr:
             ``getIncomingDataSize()`` / ``getOutgoingDataSize()`` / ``getDepth()``).
 
         Raises:
-            ILOperationException: 그런 큐가 없을 때. 또는 엔진이 6.3.4(rev 3299)
-                미만이라 유량 통계 자체를 지원하지 않을 때.
+            ILOperationException: 그런 큐가 없을 때.
             ILException: 통신 실패.
 
         Note:
             **한 시점의 스냅샷**이다. 시간에 따른 추이를 보려면
             :meth:`getQueueFlowInfoArray` 를 쓴다.
 
+            **구엔진에서도 동작한다.** 요청 코드 3201 은 오래된 코드라
+            6.3.1.2813 / 6.3.2.2856 / 6.3.3.3155 / 7.0.1.3366 네 엔진 모두에서
+            유입/유출 건수와 깊이를 정상으로 받았다(실측: put 5건 후
+            in=5 out=0 depth=5). 여러 구간을 한 번에 보는
+            :meth:`getQueueFlowInfoArray` 만 6.3.3(rev 3067) 이상이 필요하다.
+
         .. note:: 값은 **1초 주기**로 채워진다
 
             유량 스냅샷은 서버가 1초마다 적재한다. 그래서 갓 만든 큐도 **조회
@@ -3861,8 +3870,11 @@ class ILAdminQmgr:
             실제 기록이 그보다 적으면 0 으로 채운 항목이 들어간다.
 
         Raises:
-            ILOperationException: 그런 큐가 없을 때. 또는 엔진이 6.3.4(rev 3299)
-                미만이라 유량 통계 자체를 지원하지 않을 때.
+            ILOperationException: 그런 큐가 없을 때. 또는 엔진이 6.3.3(rev 3067)
+                미만이라 **배열** 조회(요청 코드 3344)를 지원하지 않을 때.
+                단건 :meth:`getQueueFlowInfo` 는 그보다 오래된 엔진에서도
+                동작하므로, 구엔진까지 지원해야 하면
+                ``ILRC.MIMQE_NOT_SUPPORTED`` 를 받았을 때 단건으로 폴백하라.
             ILException: 통신 실패.
 
         Note:

{jetstream_api-0.6.0 → jetstream_api-0.6.1}/ilink/common.py

@@ -734,15 +734,15 @@ class ILC:
     #: 큐 속성이 2200 레이아웃으로 바뀐 **첫 엔진 리비전**(6.3.3.3155).
     #: 이 값보다 낮으면 4096 레이아웃으로 주고받아야 한다.
     QUEUE_LAYOUT_MIN_REVISION = 3155
-    #: 구버전(4096) 블롭에서 공통 접두가 끝나고 레이아웃이 갈리는 지점.
-    #: 큐 **유량 통계** 조회가 들어온 첫 엔진 리비전(6.3.4.3299).
-    # 큐 유량 통계 **배열** 조회(요청 3344)가 들어온 첫 리비전(6.3.3.3067).
-    # 단건 조회(3201)는 훨씬 오래된 코드라 6.3.1.2813 에서도 응답한다(실측).
+    #: 큐 유량 통계 **배열** 조회(요청 코드 3344)가 들어온 첫 엔진 리비전(6.3.3.3067).
+    #: 단건 조회(3201)는 훨씬 오래된 코드라 6.3.1.2813 에서도 정상 응답한다(실측) -
+    #: 이 기준은 **배열에만** 적용된다.
     QUEUE_FLOW_ARRAY_MIN_REVISION = 3067
-    # 큐관리자 속성의 토픽 로거 구간(20바이트)이 들어온 첫 리비전(7.1.1.3283).
-    # 그 자리는 구엔진의 volumeMonitorForceReloadSize 다 - 값을 실어 보내면
-    # 구엔진 imqlsr 가 SIGFPE 로 죽는다(6.3.1.2813 실측).
+    #: 큐관리자 속성의 **토픽 로거** 구간(20바이트)이 들어온 첫 엔진 리비전(7.1.1.3283).
+    #: 그 자리는 구엔진의 ``volumeMonitorForceReloadSize`` 다 - 값을 실어 보내면
+    #: 구엔진 imqlsr 가 SIGFPE 로 죽는다(6.3.1.2813 실측).
     TOPIC_LOGGER_MIN_REVISION = 3283
+    #: 구버전(4096) 블롭에서 공통 접두가 끝나고 레이아웃이 갈리는 지점.
     QUEUE_LEGACY_DIVERGE_OFFSET = 1772
     #: 구버전(4096) 블롭에서 incomingDelayDepth 가 있는 위치. 현행과 같다.
     QUEUE_LEGACY_TAIL_OFFSET = 2142

{jetstream_api-0.6.0 → jetstream_api-0.6.1}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.0
+Version: 0.6.1
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.6.0 → jetstream_api-0.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jetstream-api"
-version = "0.6.0"
+version = "0.6.1"
 description = "Python client API for iLink M.O.M. (Message Oriented Middleware)"
 authors = [{name = "snowjeans"}]
 readme = "README.md"