jetstream-api 0.5.1__tar.gz → 0.5.3__tar.gz

{jetstream_api-0.5.1 → jetstream_api-0.5.3}/PKG-INFO

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

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

{jetstream_api-0.5.1 → jetstream_api-0.5.3}/ilink/admin.py

@@ -6278,7 +6278,10 @@ class ILLogBrowser:
         self.service = service
 
     def __del__(self) -> None:
-        if self.browserId:
+        # 생성자가 중간에 실패하면 속성이 없을 수 있다. __del__ 에서 난 예외는
+        # 파이썬이 삼키고 stderr 로만 찍으므로, 동작에는 문제가 없어도 로그가
+        # 지저분해진다 - getattr 로 방어한다.
+        if getattr(self, "browserId", None) and getattr(self, "service", None):
             self.close()
 
     def close(self) -> None:
@@ -6289,10 +6292,11 @@ class ILLogBrowser:
         Note:
             닫지 않으면 서버에 커서가 남는다. ``try/finally`` 로 반드시 닫아라.
         """
-        if not self.service.isOnline():
+        service = getattr(self, "service", None)
+        if service is None or not service.isOnline():
             return
         try:
-            self.service.request(
+            service.request(
                 ILC.MIMQ_BROWSER_DELETION,
                 ILC.MIMQ_SUCCESSFUL_BROWSER_DELETION,
                 self.browserId,
@@ -6388,7 +6392,10 @@ class ILQueueBrowser:
         self.closed = False
 
     def __del__(self) -> None:
-        if self.browserId:
+        # 생성자가 중간에 실패하면 속성이 없을 수 있다. __del__ 에서 난 예외는
+        # 파이썬이 삼키고 stderr 로만 찍으므로, 동작에는 문제가 없어도 로그가
+        # 지저분해진다 - getattr 로 방어한다.
+        if getattr(self, "browserId", None) and getattr(self, "service", None):
             self.close()
 
     def close(self) -> None:
@@ -6399,10 +6406,11 @@ class ILQueueBrowser:
         Note:
             닫지 않으면 서버에 커서가 남는다. ``try/finally`` 로 반드시 닫아라.
         """
-        if not self.service.isOnline() or self.closed:
+        service = getattr(self, "service", None)
+        if service is None or not service.isOnline() or getattr(self, "closed", True):
             return
         try:
-            self.service.request(
+            service.request(
                 self.qmgrName,
                 ILC.MIMQ_BROWSER_DELETION,
                 ILC.MIMQ_SUCCESSFUL_BROWSER_DELETION,

{jetstream_api-0.5.1 → jetstream_api-0.5.3}/ilink/properties.py

@@ -41,6 +41,55 @@ def _validate_log_level(value: int) -> None:
         )
 
 
+def _spec_range(lo, hi, extra=""):
+    """``lo <= v <= hi`` 규칙. ``extra`` 는 오류 문구에 덧붙일 단서."""
+    text = "%s~%s%s" % (lo, hi, extra)
+
+    def check(v):
+        return isinstance(v, int) and not isinstance(v, bool) and lo <= v <= hi
+
+    return check, text
+
+
+def _spec_min(lo, extra=""):
+    """``lo`` 이상 규칙."""
+    text = "%s or greater%s" % (lo, extra)
+
+    def check(v):
+        return isinstance(v, int) and not isinstance(v, bool) and v >= lo
+
+    return check, text
+
+
+def _spec_special_or_min(special, lo, label):
+    """``special`` 하나를 따로 허용하고, 그 밖에는 ``lo`` 이상만 받는다.
+
+    엔진이 ``-1``(무제한/비활성) 같은 특수값을 따로 두는 항목에 쓴다. ``0`` 처럼
+    특수값도 아니고 범위에도 없는 값을 걸러 내는 것이 목적이다.
+    """
+    text = "%s for %s, or %s or greater" % (special, label, lo)
+
+    def check(v):
+        if not isinstance(v, int) or isinstance(v, bool):
+            return False
+        return v == special or v >= lo
+
+    return check, text
+
+
+def _spec_maxlen(n):
+    """``n`` 바이트 이하 문자열 규칙."""
+    text = "%d bytes or less" % n
+
+    def check(v):
+        try:
+            return len(str(v).encode("utf-8")) <= n
+        except Exception:
+            return False
+
+    return check, text
+
+
 class _AutoAccessor:
     """필드에서 ``getX`` / ``setX`` / ``isX`` 접근자를 **자동으로** 만들어 주는 믹스인.
 
@@ -53,8 +102,18 @@ class _AutoAccessor:
     - ``obj.isFoo()``   -> ``bool(obj.foo)``
 
     즉 **필드 이름을 알면 접근자 이름도 안다.** 각 클래스 docstring 의 Attributes
-    절에 필드 목록이 있다. 필드를 직접 읽고 쓰는 것도 그대로 허용된다
-    (``obj.foo = 3`` 과 ``obj.setFoo(3)`` 은 같다).
+    절에 필드 목록이 있다.
+
+    Note:
+        **세터는 값 범위를 검사한다.** 클래스마다 ``_SPEC`` 규칙표가 있고, 엔진
+        ``Validate()`` 와 같은 규칙이다. 범위를 벗어나면
+        :class:`UnsupportedOperationException` 을 올린다 - 서버에 갔다 오기 전에
+        걸러진다. 규칙이 없는 필드는 그냥 대입된다.
+
+        **필드 직접 대입은 검사하지 않는다** (``obj.foo = 3``). 서버가 보낸
+        바이트를 푸는 경로가 같은 방식으로 필드에 넣기 때문이다 - 구엔진이 지금
+        규격을 벗어난 값을 보내도 파싱이 깨지면 안 된다. 미리 걸러 내고 싶으면
+        **세터를 쓴다.**
     """
 
     def __getattr__(self, name: str):
@@ -77,13 +136,44 @@ class _AutoAccessor:
         if name.startswith("set") and len(name) > 3:
             field = name[3].lower() + name[4:]
             if hasattr(self, field):
-                return lambda value: setattr(self, field, value)
+                return lambda value: self._set_checked(field, value)
         if name.startswith("is") and len(name) > 2:
             field = name[2].lower() + name[3:]
             if hasattr(self, field):
                 return lambda: bool(getattr(self, field))
         raise AttributeError(f"{self.__class__.__name__} has no attribute {name}")
 
+    _SPEC: dict = {}
+
+    def _set_checked(self, field: str, value):
+        """규칙표에 있으면 검사한 뒤 필드에 넣는다.
+
+        Args:
+            field (str): 대상 필드 이름.
+            value: 넣을 값.
+
+        Raises:
+            UnsupportedOperationException: 값이 규격을 벗어났을 때.
+
+        Note:
+            **역직렬화 경로는 이 검사를 타지 않는다.** ``__init__`` 이 서버 바이트를
+            풀 때는 ``self.<필드> = ...`` 로 직접 넣으므로, 구엔진이 지금 규격을
+            벗어난 값을 보내도 파싱이 깨지지 않는다. 검사는 **앱이 값을 지정하는
+            경로**에만 걸린다.
+
+            같은 이유로 ``obj.<필드> = 값`` 직접 대입도 검사하지 않는다. 규격을
+            미리 확인하려면 세터를 쓰거나 각 클래스 docstring 의 ``스펙:`` 줄을 본다.
+        """
+        rule = type(self)._SPEC.get(field)
+        if rule is not None:
+            check, text = rule
+            if not check(value):
+                raise UnsupportedOperationException(
+                    f"[{value}] is an unacceptable value."
+                    f" (acceptable value range: {text})"
+                )
+        object.__setattr__(self, field, value)
+
 
 class DestItem(_AutoAccessor):
     """분산(밸런스) 채널의 **전송 대상** 하나. 고정폭 바이트 블롭으로 오간다.
@@ -560,6 +650,24 @@ class ILQueueProperty(_AutoAccessor):
             스펙: 서버 응답 길이로 라이브러리가 판단하는 내부 표시 · 앱이 건드리지 않는다.
     """
 
+    # 엔진 QueueProperty::Validate() 와 같은 규칙.
+    _SPEC = {
+        "name": _spec_maxlen(47),
+        "triggerProcess": _spec_maxlen(999),
+        "remoteQmgrName": _spec_maxlen(47),
+        "remoteQueueName": _spec_maxlen(47),
+        "xmitQueueName": _spec_maxlen(47),
+        "expiredQueue": _spec_maxlen(47),
+        "maxDepth": _spec_range(1, 99999999),
+        "maxMsgLength": _spec_special_or_min(-1, 1, "unlimited"),
+        "incomingDelayDepth": _spec_special_or_min(-1, 1, "disabled"),
+        "incomingDelay": _spec_special_or_min(-1, 1, "disabled"),
+        "expiry": _spec_min(-1, " (-1 = by message)"),
+        "maxMemorySize": _spec_min(0, " (byte)"),
+        "sharedMemorySize": _spec_min(0, " (byte)"),
+        "numberOfPartition": _spec_range(2, 99),
+    }
+
     def __init__(
         self,
         name: str | bytes | bytearray | None = None,
@@ -1212,6 +1320,18 @@ class ILChannelProperty(_AutoAccessor):
         읽지 않는 옛 필드**라 이 클래스에 없다. 찾지 마라.
     """
 
+    # 엔진 ChannelProperty::Validate() 와 같은 규칙.
+    _SPEC = {
+        "name": _spec_maxlen(47),
+        "destManagerName": _spec_maxlen(47),
+        "destManagerIp": _spec_maxlen(127),
+        "xmitQueueName": _spec_maxlen(47),
+        "keyFileName": _spec_maxlen(511),
+        "certFileName": _spec_maxlen(511),
+        "destManagerPort": _spec_range(1025, 65535),
+        "timeout": _spec_special_or_min(-1, 1, "infinite"),
+    }
+
     def __init__(
         self,
         name: str | bytes | bytearray | None = None,
@@ -1435,14 +1555,16 @@ class ILChannelProperty(_AutoAccessor):
         """연결 타임아웃을 설정한다.
 
             Args:
-                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한.
+                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한, 그 밖에는 **1 이상**.
+                    ``0`` 은 거부된다.
 
             Raises:
-                UnsupportedOperationException: ``-1`` 미만일 때.
+                UnsupportedOperationException: ``-1`` 도 아니고 1 미만일 때.
         """
-        if sec < -1:
+        if sec != -1 and sec < 1:
             raise UnsupportedOperationException(
-                f"[{sec}] is an unacceptable value. (acceptable value range: -1~)"
+                f"[{sec}] is an unacceptable value."
+                " (acceptable value range: -1 for infinite, or 1 or greater)"
             )
         self.timeout = sec
 
@@ -2366,6 +2488,37 @@ class ILQmgrProperty(_AutoAccessor):
         서버가 채우는 읽기 전용 값이다.
     """
 
+    # 엔진 ManagerProperty::Validate() / Fix() 와 같은 규칙.
+    _SPEC = {
+        "name": _spec_maxlen(47),
+        "port": _spec_range(1025, 65535),
+        "deadLetterQueueName": _spec_maxlen(31),
+        "channelRetryTimeInterval": _spec_range(1, 86400, " (sec)"),
+        "sendTimeout": _spec_range(1, 864000, " (sec)"),
+        "recvWaitTimeout": _spec_range(1, 864000, " (sec)"),
+        "volumeMonitorInterval": _spec_range(1, 864000, " (sec)"),
+        "volumeMonitorSizeLimit": _spec_range(1, 1073741824000, " (byte)"),
+        "subExpiryMinutes": _spec_min(0, " (min)"),
+        "memberExpiryMinutes": _spec_range(0, 9999, " (min)"),
+        "deadSessionMaxCount": _spec_min(0),
+        "deadSessionKeepDuration": _spec_min(0, " (sec)"),
+        "logLevelSystem": _spec_range(0, 7),
+        "logLevelClient": _spec_range(0, 7),
+        "logLevelQueue": _spec_range(0, 7),
+        "logLevelChannel": _spec_range(0, 7),
+        "logLevelTopic": _spec_range(0, 7),
+        "logFileSizeSystem": _spec_range(1048576, 104857600, " (byte)"),
+        "logFileSizeClient": _spec_range(1048576, 104857600, " (byte)"),
+        "logFileSizeQueue": _spec_range(1048576, 104857600, " (byte)"),
+        "logFileSizeChannel": _spec_range(1048576, 104857600, " (byte)"),
+        "logFileSizeTopic": _spec_range(1048576, 104857600, " (byte)"),
+        "logFileCountSystem": _spec_range(1, 999),
+        "logFileCountClient": _spec_range(1, 999),
+        "logFileCountQueue": _spec_range(1, 999),
+        "logFileCountChannel": _spec_range(1, 999),
+        "logFileCountTopic": _spec_range(1, 999),
+    }
+
     def __init__(
         self,
         name: str | bytes | bytearray | None = None,
@@ -2770,14 +2923,16 @@ class ILQmgrProperty(_AutoAccessor):
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_QUEUE`(2) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_CHANNEL`(3).
-                value (int): 회전 크기(바이트). **1048576(1MB) 이상**이어야 한다.
+                value (int): 회전 크기(바이트). **1048576(1MB) ~ 104857600(100MB)**
+                    이어야 한다.
 
             Raises:
-                UnsupportedOperationException: 1048576 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1048576:
+        if value < 1048576 or value > 104857600:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1048576~)"
+                f"[{value}] is an unacceptable value."
+                " (acceptable value range: 1048576~104857600)"
             )
         setattr(self, "logFileSize" + self._log_suffix(logger_type), value)
 
@@ -2804,17 +2959,44 @@ class ILQmgrProperty(_AutoAccessor):
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_QUEUE`(2) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_CHANNEL`(3).
-                value (int): 보관 개수. **1 이상**이어야 한다.
+                value (int): 보관 개수. **1~999** 여야 한다.
 
             Raises:
-                UnsupportedOperationException: 1 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1:
+        if value < 1 or value > 999:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1~)"
+                f"[{value}] is an unacceptable value. (acceptable value range: 1~999)"
             )
         setattr(self, "logFileCount" + self._log_suffix(logger_type), value)
 
+
+    # --- camelCase 별칭 -------------------------------------------------
+    # 2인자 로거 접근자는 _AutoAccessor 가 합성하지 못한다(필드 이름이 아니라
+    # 종류를 인자로 받으므로). 자바에는 있는 형태라 명시적으로 붙여 둔다.
+    def getLogLevel(self, logger_type: int) -> int:
+        """:meth:`get_log_level` 의 camelCase 별칭."""
+        return self.get_log_level(logger_type)
+
+    def setLogLevel(self, logger_type: int, value: int) -> None:
+        """:meth:`set_log_level` 의 camelCase 별칭."""
+        self.set_log_level(logger_type, value)
+
+    def getLogFileSize(self, logger_type: int) -> int:
+        """:meth:`get_log_file_size` 의 camelCase 별칭."""
+        return self.get_log_file_size(logger_type)
+
+    def setLogFileSize(self, logger_type: int, value: int) -> None:
+        """:meth:`set_log_file_size` 의 camelCase 별칭."""
+        self.set_log_file_size(logger_type, value)
+
+    def getLogFileCount(self, logger_type: int) -> int:
+        """:meth:`get_log_file_count` 의 camelCase 별칭."""
+        return self.get_log_file_count(logger_type)
+
+    def setLogFileCount(self, logger_type: int, value: int) -> None:
+        """:meth:`set_log_file_count` 의 camelCase 별칭."""
+        self.set_log_file_count(logger_type, value)
     def get_log_level_system_string(self) -> str:
         """시스템 로그 레벨을 문자열로 돌려준다.
 
@@ -3416,6 +3598,22 @@ class ILServiceProperty(_AutoAccessor):
             스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
     """
 
+    # 엔진 ServiceProperty::Validate() 와 같은 규칙.
+    _SPEC = {
+        "name": _spec_maxlen(47),
+        "port": _spec_range(1025, 65535),
+        "hubIp": _spec_maxlen(127),
+        "hubPort": _spec_range(1025, 65535),
+        "timeoutSocketSend": _spec_range(1, 864000, " (sec)"),
+        "timeoutSocketRecv": _spec_range(1, 864000, " (sec)"),
+        "logLevelSystem": _spec_range(0, 7),
+        "logLevelClient": _spec_range(0, 7),
+        "logFileSizeSystem": _spec_range(1048576, 104857600, " (byte)"),
+        "logFileSizeClient": _spec_range(1048576, 104857600, " (byte)"),
+        "logFileCountSystem": _spec_range(1, 999),
+        "logFileCountClient": _spec_range(1, 999),
+    }
+
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
         """서비스 속성 객체를 만든다.
 
@@ -3622,14 +3820,15 @@ class ILServiceProperty(_AutoAccessor):
         """소켓 송신 타임아웃을 설정한다.
 
             Args:
-                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한.
+                sec (int): 타임아웃(**초**). **1~864000**.
+                    엔진 rev 3283(TMOGUARD-1) 부터 ``-1``(무제한)과 ``0`` 은 거부된다.
 
             Raises:
-                UnsupportedOperationException: ``-1`` 미만일 때.
+                UnsupportedOperationException: 1~864000 을 벗어날 때.
         """
-        if sec < -1:
+        if sec < 1 or sec > 864000:
             raise UnsupportedOperationException(
-                f"[{sec}] is an unacceptable value. (acceptable value range: -1~)"
+                f"[{sec}] is an unacceptable value. (acceptable value range: 1~864000)"
             )
         self.timeoutSocketSend = sec
 
@@ -3637,14 +3836,15 @@ class ILServiceProperty(_AutoAccessor):
         """소켓 수신 타임아웃을 설정한다.
 
             Args:
-                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한.
+                sec (int): 타임아웃(**초**). **1~864000**.
+                    엔진 rev 3283(TMOGUARD-1) 부터 ``-1``(무제한)과 ``0`` 은 거부된다.
 
             Raises:
-                UnsupportedOperationException: ``-1`` 미만일 때.
+                UnsupportedOperationException: 1~864000 을 벗어날 때.
         """
-        if sec < -1:
+        if sec < 1 or sec > 864000:
             raise UnsupportedOperationException(
-                f"[{sec}] is an unacceptable value. (acceptable value range: -1~)"
+                f"[{sec}] is an unacceptable value. (acceptable value range: 1~864000)"
             )
         self.timeoutSocketRecv = sec
 
@@ -3709,14 +3909,16 @@ class ILServiceProperty(_AutoAccessor):
             Args:
                 logger_type (int): 로거 종류. :data:`ILC.MIMQ_LOGGER_TYPE_SYSTEM`(0) 또는
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1). 서비스는 이 둘뿐이다.
-                value (int): 회전 크기(바이트). **1048576(1MB) 이상**이어야 한다.
+                value (int): 회전 크기(바이트). **1048576(1MB) ~ 104857600(100MB)**
+                    이어야 한다.
 
             Raises:
-                UnsupportedOperationException: 1048576 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1048576:
+        if value < 1048576 or value > 104857600:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1048576~)"
+                f"[{value}] is an unacceptable value."
+                " (acceptable value range: 1048576~104857600)"
             )
         setattr(self, "logFileSize" + self._log_suffix(logger_type), value)
 
@@ -3739,17 +3941,44 @@ class ILServiceProperty(_AutoAccessor):
             Args:
                 logger_type (int): 로거 종류. :data:`ILC.MIMQ_LOGGER_TYPE_SYSTEM`(0) 또는
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1). 서비스는 이 둘뿐이다.
-                value (int): 보관 개수. **1 이상**이어야 한다.
+                value (int): 보관 개수. **1~999** 여야 한다.
 
             Raises:
-                UnsupportedOperationException: 1 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1:
+        if value < 1 or value > 999:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1~)"
+                f"[{value}] is an unacceptable value. (acceptable value range: 1~999)"
             )
         setattr(self, "logFileCount" + self._log_suffix(logger_type), value)
 
+
+    # --- camelCase 별칭 -------------------------------------------------
+    # 2인자 로거 접근자는 _AutoAccessor 가 합성하지 못한다(필드 이름이 아니라
+    # 종류를 인자로 받으므로). 자바에는 있는 형태라 명시적으로 붙여 둔다.
+    def getLogLevel(self, logger_type: int) -> int:
+        """:meth:`get_log_level` 의 camelCase 별칭."""
+        return self.get_log_level(logger_type)
+
+    def setLogLevel(self, logger_type: int, value: int) -> None:
+        """:meth:`set_log_level` 의 camelCase 별칭."""
+        self.set_log_level(logger_type, value)
+
+    def getLogFileSize(self, logger_type: int) -> int:
+        """:meth:`get_log_file_size` 의 camelCase 별칭."""
+        return self.get_log_file_size(logger_type)
+
+    def setLogFileSize(self, logger_type: int, value: int) -> None:
+        """:meth:`set_log_file_size` 의 camelCase 별칭."""
+        self.set_log_file_size(logger_type, value)
+
+    def getLogFileCount(self, logger_type: int) -> int:
+        """:meth:`get_log_file_count` 의 camelCase 별칭."""
+        return self.get_log_file_count(logger_type)
+
+    def setLogFileCount(self, logger_type: int, value: int) -> None:
+        """:meth:`set_log_file_count` 의 camelCase 별칭."""
+        self.set_log_file_count(logger_type, value)
     def get_log_level_system_string(self) -> str:
         """시스템 로그 레벨을 문자열로 돌려준다.
 
@@ -3860,6 +4089,15 @@ class ILProxyProperty(_AutoAccessor):
             스펙: 기본 F · 범위 T | F · 변경 불가.
     """
 
+    # 엔진 ProxyProperty::Validate() 와 같은 규칙.
+    _SPEC = {
+        "name": _spec_maxlen(47),
+        "port": _spec_range(1025, 65535),
+        "destIp": _spec_maxlen(127),
+        "destPort": _spec_range(1025, 65535),
+        "timeout": _spec_min(1, " (sec)"),
+    }
+
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
         """프록시 속성 객체를 만든다.
 
@@ -4026,6 +4264,16 @@ class ILDiskGuardProperty(_AutoAccessor):
             스펙: 기본 10 · 범위 1~3600 · 단위 초 · 변경 가능/재기동 불필요.
     """
 
+    # 엔진 DiskGuardProperty::Validate() 와 같은 규칙(상호 제약은 validate() 가 본다).
+    _SPEC = {
+        "warnPercent": _spec_range(1, 100, " (%)"),
+        "suspendPercent": _spec_range(1, 100, " (%)"),
+        "resumePercent": _spec_range(1, 100, " (%)"),
+        "minFreeMB": _spec_min(0, " (MB)"),
+        "resumeMinFreeMB": _spec_min(0, " (MB)"),
+        "intervalSec": _spec_range(1, 3600, " (sec)"),
+    }
+
     def __init__(self, csv: str | None = None) -> None:
         """디스크 가드 설정 객체를 만든다.
 
@@ -4257,6 +4505,14 @@ class ILClusterNode(_AutoAccessor):
             스펙: 기본 "" · 범위 47바이트 이하 문자열 (빈 값 금지, rev 3319+) · 변경 가능/클러스터 정지 필요.
     """
 
+    # 엔진 ClusterProperty::Validate() 의 노드 검사와 같은 규칙.
+    _SPEC = {
+        "nodeId": _spec_min(1),
+        "host": _spec_maxlen(127),
+        "port": _spec_range(1025, 65535),
+        "qmgrName": _spec_maxlen(47),
+    }
+
     def __init__(self, ba: bytes | bytearray | None = None,
                  qmgr_name: str = "", host: str = "", port: int = 0) -> None:
         """클러스터 노드 객체를 만든다.
@@ -4471,6 +4727,18 @@ class ILClusterProperty(_AutoAccessor):
     항목마다 자기 길이만큼 커서를 전진시켜 파싱한다.
     """
 
+    # 엔진 ClusterProperty::Validate() 와 같은 규칙.
+    _SPEC = {
+        "name": _spec_maxlen(47),
+        "ilccPort": _spec_range(1025, 65535),
+        "priPort": _spec_range(1025, 65535),
+        "secPort": _spec_range(1025, 65535),
+        "witPort": _spec_range(1025, 65535),
+        "heartbeatIntervalMs": _spec_min(100, " (ms)"),
+        "heartbeatMissCount": _spec_range(1, 99),
+        "electionDelayMs": _spec_min(0, " (ms)"),
+    }
+
     def __init__(self, ba: bytes | bytearray | None = None,
                  name: str = "", ilcc_port: int = 0,
                  is_auto_start: bool = True,

{jetstream_api-0.5.1 → jetstream_api-0.5.3}/jetstream_api.egg-info/PKG-INFO

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

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