jetstream-api 0.6.2__tar.gz → 0.6.4__tar.gz

{jetstream_api-0.6.2 → jetstream_api-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.2
+Version: 0.6.4
 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.2 → jetstream_api-0.6.4}/ilink/__init__.py

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

{jetstream_api-0.6.2 → jetstream_api-0.6.4}/ilink/admin.py

@@ -604,6 +604,23 @@ class ILAdminService:
                 서버가 거절했을 때.
             ILException: 통신 실패.
 
+        Warning:
+            **값 검증은 엔진이 한다.** 이 API 는 문자열 길이(와이어 폭) 외의 값
+            범위를 검사하지 않는데, 엔진의 처리가 **생성과 변경에서 다르다.**
+
+            * **숫자 설정값**(타임아웃/주기/보관 수 등)이 범위를 벗어나면 엔진
+              7.1.1 이상은 거부하지 않고 **조용히 기본값으로 바꿔서 만든다.**
+              대조할 저장값이 없어 판정할 수 없기 때문이다. **오타를 내도
+              만들기는 성공하므로** 만든 뒤 :meth:`getQmgrProperty` 로 값을
+              확인한다.
+            * 반면 **이름/포트/홈경로** 같은 신원 항목은 생성 시에도 거부된다.
+              그래서 만든 뒤 봐야 할 것은 신원 항목이 아니라 숫자 설정값 쪽이다.
+            * **엔진 7.1.1 미만에는 이 검사층 자체가 없다.** 어떤 값도 걸러지지
+              않으므로 호출자가 스스로 확인해야 한다.
+
+            :meth:`setQmgrProperty` (변경)는 다르다 - 저장값과 다른 범위 밖
+            값은 거부된다.
+
         Note:
             만든 뒤 :meth:`startQmgr` 로 기동해야 접속할 수 있다.
 

{jetstream_api-0.6.2 → jetstream_api-0.6.4}/ilink/properties.py

@@ -26,8 +26,26 @@ def _format_millis(value: int, fmt: str) -> str:
 
 
 
-# 구엔진(rev 3283 미만)의 StorageVolumeMonitor ForceReloadSize 기본값.
-LEGACY_FORCE_RELOAD_SIZE = 1048576
+# 구엔진 SetVolumeMonitorForceReloadSize() 가 강제하는 **하한**.
+#
+# 기본값이 아니다. 구엔진 생성자는
+#   mVolumeMonitorForceReloadSize = mVolumeMonitorSizeLimit
+# 이고(ManagerProperty.hpp:143, 1GB 줄은 주석), 이 숫자는 세터
+# (ManagerProperty.hpp:557)가 그 아래 값을 올려 잡는 바닥일 뿐이다.
+# "엔진이 강제하는 값"과 "엔진이 의도한 값"은 다르다 - 이것을 폴백 기본값으로
+# 쓰면 sizeLimit 과의 문턱 순서가 뒤집힌다(0.6.3 에서 정정).
+LEGACY_FORCE_RELOAD_MIN = 1048576
+
+
+def _has_value(raw) -> bool:
+    """서버가 준 원본이 쓸 만한지 본다.
+
+    신엔진(7.0+)은 구엔진 전용 자리를 0 으로 채워 보낸다. 그 0 을 되돌려 쓰면
+    안 되므로 전부 0 이면 원본이 없는 것으로 본다.
+    """
+    return bool(raw) and any(raw)
+
+
 # 구엔진(6.3.x)의 TCPListener SessionPerThread 기본값.
 # 0 이면 imqlsr 가 nSessionCnt / nSessionPerThread 에서 0 나눗셈으로 죽는다.
 LEGACY_SESSION_PER_THREAD = 10
@@ -2483,6 +2501,7 @@ class ILQmgrProperty(_AutoAccessor):
         self.volumeMonitorSizeLimit = 10485760
         self._volumeTailRaw = None
         self._sessionPerThreadRaw = None
+        self._poolSizeRaw = None
         self.logLevelSystem = 4
         self.logFileSizeSystem = 4194304
         self.logFileCountSystem = 5
@@ -2582,6 +2601,9 @@ class ILQmgrProperty(_AutoAccessor):
             offset += 10
             self.recvWaitTimeout = ba_pick_int(ba, offset, 10)
             offset += 10
+            # 구엔진(6.3.x)에는 실재하는 필드다. 상수로 덮으면 현장에서 조정해 둔
+            # 값이 지워지므로 원본을 보관해 되돌려 쓴다(실측).
+            self._poolSizeRaw = bytes(ba[offset:offset + 20])
             offset += 20
             self.volumeMonitorInterval = ba_pick_int(ba, offset, 10)
             offset += 10
@@ -2704,11 +2726,15 @@ class ILQmgrProperty(_AutoAccessor):
         # v6.3.4 에서 async 를 없애며 acceptPoolSize/eventPoolSize 를 뺐지만
         # 구엔진(6.3.x)은 이 두 필드를 읽고 1~9 로 검증한다. 0 을 보내면
         # MIMQE_INVALID_ARGUMENT (AcceptPoolSize : 0) 로 거부된다(6.3.1 실측).
-        # 자바는 v1.5.2 에서 같은 이유로 기본값 1 을 되살렸다 - 그것과 맞춘다.
-        ba_merge(1, ba, offset)
-        offset += 10
-        ba_merge(1, ba, offset)
-        offset += 10
+        # 다만 기본값으로 덮으면 현장에서 조정해 둔 값이 지워지므로,
+        # 서버가 준 원본이 있으면 그대로 되돌려 준다(없을 때만 1/1).
+        raw_pool = getattr(self, "_poolSizeRaw", None)
+        if _has_value(raw_pool):
+            ba[offset:offset + 20] = raw_pool
+        else:
+            ba_merge(1, ba, offset)
+            ba_merge(1, ba, offset + 10)
+        offset += 20
         ba_merge(self.volumeMonitorInterval, ba, offset)
         offset += 10
         ba_merge(self.volumeMonitorSizeLimit, ba, offset)
@@ -2771,8 +2797,11 @@ class ILQmgrProperty(_AutoAccessor):
                 # 서버가 준 값을 그대로 되돌려 준다
                 ba[topic_offset:topic_offset + 20] = raw
             else:
-                # 새로 만든 객체라 받은 값이 없다 - 엔진 기본값을 쓴다
-                ba_merge(LEGACY_FORCE_RELOAD_SIZE, ba, topic_offset)
+                # 받은 값이 없다 - 엔진 생성자와 같이 sizeLimit 을 따라간다
+                # (6.3 ManagerProperty.hpp:143 이 mForceReloadSize = mSizeLimit).
+                # 엔진 세터가 1048576 미만을 올려 잡으므로 그 아래로 내리지 않는다.
+                ba_merge(max(self.volumeMonitorSizeLimit, LEGACY_FORCE_RELOAD_MIN),
+                         ba, topic_offset)
             # 구엔진에만 있는 sessionPerThread 도 되돌려 준다
             raw2 = getattr(self, "_sessionPerThreadRaw", None)
             if raw2:
@@ -3578,6 +3607,7 @@ class ILServiceProperty(_AutoAccessor):
             ILException: 그 밖의 파싱 실패.
         """
         self.ip = "127.0.0.1"
+        self._poolSizeRaw = None
         self.port = 9998
         self.version = ""
         self.timeoutSocketSend = 60
@@ -3619,6 +3649,8 @@ class ILServiceProperty(_AutoAccessor):
         offset += 10
         self.timeoutSocketRecv = ba_pick_int(ba, offset, 10)
         offset += 10
+        # 구엔진 ilsvc 는 이 값으로 스레드 풀을 만든다 - 원본을 보관해 되돌려 쓴다
+        self._poolSizeRaw = bytes(ba[offset:offset + 20])
         offset += 20
         self.logLevelSystem = ba_pick_int(ba, offset, 2)
         offset += 2
@@ -3676,11 +3708,15 @@ class ILServiceProperty(_AutoAccessor):
         # v6.3.4 에서 async 를 없애며 acceptPoolSize/eventPoolSize 를 뺐지만
         # 구엔진(6.3.x) ilsvc 는 이 값으로 스레드 풀을 만든다
         # (ILinkServerMainClass.cpp:151, ServerListener.cpp:17). 0 이면 풀이 0개다.
-        # 자바는 v1.5.2 에서 기본값 1 을 되살렸다 - 그것과 맞춘다.
-        ba_merge(1, ba, offset)
-        offset += 10
-        ba_merge(1, ba, offset)
-        offset += 10
+        # 다만 기본값으로 덮으면 현장에서 조정해 둔 값이 지워지므로,
+        # 서버가 준 원본이 있으면 그대로 되돌려 준다(없을 때만 1/1).
+        raw_pool = getattr(self, "_poolSizeRaw", None)
+        if _has_value(raw_pool):
+            ba[offset:offset + 20] = raw_pool
+        else:
+            ba_merge(1, ba, offset)
+            ba_merge(1, ba, offset + 10)
+        offset += 20
         ba_merge(self.logLevelSystem, ba, offset)
         offset += 2
         ba_merge(self.logFileSizeSystem, ba, offset)

{jetstream_api-0.6.2 → jetstream_api-0.6.4}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.2
+Version: 0.6.4
 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.2 → jetstream_api-0.6.4}/pyproject.toml

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