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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.5.2
+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.2 → 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.2"
+__version__ = "0.5.3"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser

{jetstream_api-0.5.2 → 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,
@@ -2368,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,
@@ -2819,6 +2970,33 @@ class ILQmgrProperty(_AutoAccessor):
             )
         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:
         """시스템 로그 레벨을 문자열로 돌려준다.
 
@@ -3420,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:
         """서비스 속성 객체를 만든다.
 
@@ -3758,6 +3952,33 @@ class ILServiceProperty(_AutoAccessor):
             )
         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:
         """시스템 로그 레벨을 문자열로 돌려준다.
 
@@ -3868,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:
         """프록시 속성 객체를 만든다.
 
@@ -4034,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:
         """디스크 가드 설정 객체를 만든다.
 
@@ -4265,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:
         """클러스터 노드 객체를 만든다.
@@ -4479,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.2 → 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.2
+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.2 → jetstream_api-0.5.3}/pyproject.toml

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