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

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

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

{jetstream_api-0.5.1 → jetstream_api-0.5.2}/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.2}/ilink/properties.py

@@ -1435,14 +1435,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
 
@@ -2770,14 +2772,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,14 +2808,14 @@ 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)
 
@@ -3622,14 +3626,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 +3642,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 +3715,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,14 +3747,14 @@ 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)
 

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

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

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