jetstream-api 0.6.3__tar.gz → 0.6.5__tar.gz

{jetstream_api-0.6.3 → jetstream_api-0.6.5}/PKG-INFO

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

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

{jetstream_api-0.6.3 → jetstream_api-0.6.5}/ilink/admin.py

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

{jetstream_api-0.6.3 → jetstream_api-0.6.5}/ilink/properties.py

@@ -26,7 +26,14 @@ def _format_millis(value: int, fmt: str) -> str:
 
 
 
-# 구엔진 SetVolumeMonitorForceReloadSize() 가 강제하는 하한.
+# 구엔진 SetVolumeMonitorForceReloadSize() 가 강제하는 **하한**.
+#
+# 기본값이 아니다. 구엔진 생성자는
+#   mVolumeMonitorForceReloadSize = mVolumeMonitorSizeLimit
+# 이고(ManagerProperty.hpp:143, 1GB 줄은 주석), 이 숫자는 세터
+# (ManagerProperty.hpp:557)가 그 아래 값을 올려 잡는 바닥일 뿐이다.
+# "엔진이 강제하는 값"과 "엔진이 의도한 값"은 다르다 - 이것을 폴백 기본값으로
+# 쓰면 sizeLimit 과의 문턱 순서가 뒤집힌다(0.6.3 에서 정정).
 LEGACY_FORCE_RELOAD_MIN = 1048576
 
 

{jetstream_api-0.6.3 → jetstream_api-0.6.5}/jetstream_api.egg-info/PKG-INFO

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

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