jetstream-api 0.22.1__tar.gz → 0.23.0__tar.gz

{jetstream_api-0.22.1 → jetstream_api-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.22.1
+Version: 0.23.0
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003
@@ -60,12 +60,50 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.23.0 변경 - 큐 속성 Property v2(JSON) · 채널 STANDBY (자바 v2.19.0 와 같음, 짝 엔진 = Property v2 P3 판 이상)
+
+- **큐 관리가 엔진 7 과 JSON(Property v2) 으로 오간다**(엔진 P3). 함수 이름은 그대로 - ``createQueue`` · ``setQueueProperty`` ·
+  ``getQueueProperty`` (종류별 포함) · ``getQueueList`` (종류별 · 요약 포함) · ``removeQueue`` 가 상대가 7 이면 JSON, 6.x 면 기존 고정폭 블롭이다.
+  ☠ **P3 전 7.x 엔진(7.0.1.3604 이하)에는 큐 관리가 거절된다** - 판 혼재는 지원하지 않는다(엔진 · 클라 · 하네스를 함께 올린다).
+- ``setQueueProperty`` 는 엔진 7 에 **세터 · 대입으로 바꾼 칸만** 보낸다. 새로 만든 객체로 일부만 바꿔도 다른 칸을 덮지 않는다
+  (옛 블롭은 전체 교체였다). 바꾼 것이 없으면 보내지 않는다.
+- 더함: ``createQueueWithResult`` · ``setQueuePropertyWithResult`` · ``removeQueueWithResult`` (``ILPropertyResult``, 6.x 엔진이면 빈 결과),
+  ``ILQueueProperty.description`` (큐 설명, 200바이트, 생성 전용, 엔진 7 에서만).
+- ``leaderGroup`` 은 JSON 으로만 오간다 - 고정폭 블롭은 6.3.4 레이아웃으로 되돌아갔다(LG 칸 없음).
+- ``incomingDelayDepth`` · ``incomingDelay`` 의 ``0`` 은 유효한 값이다(문서 범위 고침). 세그먼트 수 · 공유 메모리 크기는 생성 전용 -
+  바꿔 보내면 ``MIMQE_IMMUTABLE_PROPERTY (SEGMENTS fixed at <n>)`` 로 거절된다.
+- 종류별 조회(``getLocalQueueProperty`` 등)는 종류가 다르면 ``MIMQE_OBJECT_NOT_FOUND (<큐> : TYPE_NOT_MATCHED)`` (옛 엔진과 같은 사유).
+- 채널: ``ILChannelStatus.STANDBY = 5`` (리더에서만 일하는 채널이 팔로워에서 대기). 이 값을 모르는 옛 클라는 STANDBY 채널이 섞인
+  채널 조회 · 목록이 실패한다. ``startChannelWithStatus`` 는 STANDBY · 오류(``"EXCEPTION"``)에서 기다리지 않고 곧바로 돌아온다
+  (전에는 오류에서 시한까지 기다렸다).
+- 없앰: ``ILC.MIMQ_COORD_OBSERVER`` ("O") - ``getReplicationStatus`` 의 3370 arg1 은 빈칸이다(엔진이 r3486 부터 읽지 않는다).
+- 예외 문구에 Property v2 본문 규칙 위반의 원인을 붙인다(전에는 ``MIMQE_INTERNAL_ERROR`` 만 보였다).
+- 알려진 엔진 결함(P3 이전부터, 엔진에서 별건): 큐를 한 번 변경하면 그 뒤 ``setQueueTrace`` 결과가 조회에 안 보인다 -
+  트레이스는 ``setQueueProperty`` 로 바꾼다.
+
+## 0.22.3 변경 - 옛 클러스터 블롭 코덱 · actingCoordinator 제거, servicePorts (자바 v2.18.3 와 같음, 짝 엔진 7.0.1.3603 이상 권장)
+
+0.22.2 는 시험 판(test.pypi)만 내고 버렸다 - actingCoordinator 제거를 묶어 0.22.3 으로 나간다.
+
+- **없앰**(호환 깨짐): 옛 고정폭 클러스터 블롭 코덱 - ``ILClusterProperty(bytes)`` · ``ba=`` · ``get_serialized`` · ``get_serialized_length`` ·
+  ``LAYOUT_MARK``, ``ILClusterNode(bytes)`` · ``ba=`` · ``base=`` · ``get_serialized``, 모듈 ``CLUSTER_LAYOUT_MARK``,
+  ``ILC.MIMQ_VO_CLUSTER_LEN`` / ``MIMQ_VO_CLUSTER_NODE_LEN``. 바이트를 주면 ``TypeError``. 엔진 r3601 이 그 형식을 지웠고 0.22.0 부터
+  JSON(Property v2)으로만 주고받아 쓰는 경로가 없었다. 능력 선언 ``clsblob=2`` 는 그대로.
+- **없앰**(호환 깨짐): ``ILClusterProperty.actingCoordinator`` · ``get_acting_coordinator`` / ``getActingCoordinator`` - 0.18.1 부터 폐기 예정,
+  엔진 7.0.1.3484 부터 늘 ``None`` 이던 관측 칸이다(엔진 r3604 도 걷음). ``controllerLeader`` 를 읽는다 - 옛 이름으로 부르면 그렇게 안내한다.
+- **더함**: ``ILClusterProperty.servicePorts`` / ``getServicePorts()`` (읽기 전용) - 응답한 서비스가 맡은 컨트롤러(ilcc) 자리의 포트 전부
+  (엔진 ``PORT`` "a,b", 맡은 자리가 없으면 빈 목록). 컨트롤러가 멈춰 있어도 나온다 - 지금 듣는 포트는 ``localCtrlPort``.
+- 노드 ``status`` · ``nodeUuid`` · ``defTerm`` · ``defVersion`` 은 이름만 남는다(엔진 r3601 부터 와이어에 없어 늘 빈 값) - 문서를 고침.
+- 문서 정정: 팔로워 거절 ``MIMQE_OPERATION_DENIED (STANDBY)`` 는 **토픽**의 생성 · 변경 · 삭제만이다(쿼터 · 디스크 가드 · 클러스터에는 없다).
+- 엔진 r3603: 클러스터 서명(``signature``) 값의 재료가 정의의 공유 칸 전부로 넓어져 값이 바뀐다(키 · 형식 그대로, 클라 변경 없음).
+
 ## 0.22.1 변경 - 노드 추가 결과에 컨트롤러 기동 여부 (자바 v2.18.1 와 같음, started · wait 는 짝 엔진 7.0.1.3602 이상)
 
 - ``addNode`` 결과(``ILClusterNodeAddResult``)에 ``started`` · ``wait``(``is_started()``): 자리를 맡은 서비스가 컨트롤러를 **띄웠는가**와
   안 띄운 까닭(``MANUAL`` - 정의 STARTMODE 가 MANUAL 이라 :meth:`startCluster` 로 띄운다 · ``STOPPED`` - 사용자가 멈춰 둠 · ``FAILED`` -
   띄우다 실패, ilsvc 로그). 그 전 엔진은 이 칸을 주지 않아 맡았으면 띄운 것으로 본다(종전 동작).
-- 문서: 클러스터 팔로워 노드에 보낸 생성 · 변경 · 삭제는 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은 팔로워도 답한다.
+- 문서: **토픽**의 생성 · 변경 · 삭제를 클러스터 팔로워 노드에 보내면 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은
+  팔로워도 답한다. 쿼터 · 디스크 가드 · 클러스터(서비스가 받는 설정)에는 이 거절이 없다(배포 뒤 정정 - 처음에는 네 오브젝트 모두로 잘못 적었다).
 
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 

{jetstream_api-0.22.1 → jetstream_api-0.23.0}/README.md

@@ -10,12 +10,50 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.23.0 변경 - 큐 속성 Property v2(JSON) · 채널 STANDBY (자바 v2.19.0 와 같음, 짝 엔진 = Property v2 P3 판 이상)
+
+- **큐 관리가 엔진 7 과 JSON(Property v2) 으로 오간다**(엔진 P3). 함수 이름은 그대로 - ``createQueue`` · ``setQueueProperty`` ·
+  ``getQueueProperty`` (종류별 포함) · ``getQueueList`` (종류별 · 요약 포함) · ``removeQueue`` 가 상대가 7 이면 JSON, 6.x 면 기존 고정폭 블롭이다.
+  ☠ **P3 전 7.x 엔진(7.0.1.3604 이하)에는 큐 관리가 거절된다** - 판 혼재는 지원하지 않는다(엔진 · 클라 · 하네스를 함께 올린다).
+- ``setQueueProperty`` 는 엔진 7 에 **세터 · 대입으로 바꾼 칸만** 보낸다. 새로 만든 객체로 일부만 바꿔도 다른 칸을 덮지 않는다
+  (옛 블롭은 전체 교체였다). 바꾼 것이 없으면 보내지 않는다.
+- 더함: ``createQueueWithResult`` · ``setQueuePropertyWithResult`` · ``removeQueueWithResult`` (``ILPropertyResult``, 6.x 엔진이면 빈 결과),
+  ``ILQueueProperty.description`` (큐 설명, 200바이트, 생성 전용, 엔진 7 에서만).
+- ``leaderGroup`` 은 JSON 으로만 오간다 - 고정폭 블롭은 6.3.4 레이아웃으로 되돌아갔다(LG 칸 없음).
+- ``incomingDelayDepth`` · ``incomingDelay`` 의 ``0`` 은 유효한 값이다(문서 범위 고침). 세그먼트 수 · 공유 메모리 크기는 생성 전용 -
+  바꿔 보내면 ``MIMQE_IMMUTABLE_PROPERTY (SEGMENTS fixed at <n>)`` 로 거절된다.
+- 종류별 조회(``getLocalQueueProperty`` 등)는 종류가 다르면 ``MIMQE_OBJECT_NOT_FOUND (<큐> : TYPE_NOT_MATCHED)`` (옛 엔진과 같은 사유).
+- 채널: ``ILChannelStatus.STANDBY = 5`` (리더에서만 일하는 채널이 팔로워에서 대기). 이 값을 모르는 옛 클라는 STANDBY 채널이 섞인
+  채널 조회 · 목록이 실패한다. ``startChannelWithStatus`` 는 STANDBY · 오류(``"EXCEPTION"``)에서 기다리지 않고 곧바로 돌아온다
+  (전에는 오류에서 시한까지 기다렸다).
+- 없앰: ``ILC.MIMQ_COORD_OBSERVER`` ("O") - ``getReplicationStatus`` 의 3370 arg1 은 빈칸이다(엔진이 r3486 부터 읽지 않는다).
+- 예외 문구에 Property v2 본문 규칙 위반의 원인을 붙인다(전에는 ``MIMQE_INTERNAL_ERROR`` 만 보였다).
+- 알려진 엔진 결함(P3 이전부터, 엔진에서 별건): 큐를 한 번 변경하면 그 뒤 ``setQueueTrace`` 결과가 조회에 안 보인다 -
+  트레이스는 ``setQueueProperty`` 로 바꾼다.
+
+## 0.22.3 변경 - 옛 클러스터 블롭 코덱 · actingCoordinator 제거, servicePorts (자바 v2.18.3 와 같음, 짝 엔진 7.0.1.3603 이상 권장)
+
+0.22.2 는 시험 판(test.pypi)만 내고 버렸다 - actingCoordinator 제거를 묶어 0.22.3 으로 나간다.
+
+- **없앰**(호환 깨짐): 옛 고정폭 클러스터 블롭 코덱 - ``ILClusterProperty(bytes)`` · ``ba=`` · ``get_serialized`` · ``get_serialized_length`` ·
+  ``LAYOUT_MARK``, ``ILClusterNode(bytes)`` · ``ba=`` · ``base=`` · ``get_serialized``, 모듈 ``CLUSTER_LAYOUT_MARK``,
+  ``ILC.MIMQ_VO_CLUSTER_LEN`` / ``MIMQ_VO_CLUSTER_NODE_LEN``. 바이트를 주면 ``TypeError``. 엔진 r3601 이 그 형식을 지웠고 0.22.0 부터
+  JSON(Property v2)으로만 주고받아 쓰는 경로가 없었다. 능력 선언 ``clsblob=2`` 는 그대로.
+- **없앰**(호환 깨짐): ``ILClusterProperty.actingCoordinator`` · ``get_acting_coordinator`` / ``getActingCoordinator`` - 0.18.1 부터 폐기 예정,
+  엔진 7.0.1.3484 부터 늘 ``None`` 이던 관측 칸이다(엔진 r3604 도 걷음). ``controllerLeader`` 를 읽는다 - 옛 이름으로 부르면 그렇게 안내한다.
+- **더함**: ``ILClusterProperty.servicePorts`` / ``getServicePorts()`` (읽기 전용) - 응답한 서비스가 맡은 컨트롤러(ilcc) 자리의 포트 전부
+  (엔진 ``PORT`` "a,b", 맡은 자리가 없으면 빈 목록). 컨트롤러가 멈춰 있어도 나온다 - 지금 듣는 포트는 ``localCtrlPort``.
+- 노드 ``status`` · ``nodeUuid`` · ``defTerm`` · ``defVersion`` 은 이름만 남는다(엔진 r3601 부터 와이어에 없어 늘 빈 값) - 문서를 고침.
+- 문서 정정: 팔로워 거절 ``MIMQE_OPERATION_DENIED (STANDBY)`` 는 **토픽**의 생성 · 변경 · 삭제만이다(쿼터 · 디스크 가드 · 클러스터에는 없다).
+- 엔진 r3603: 클러스터 서명(``signature``) 값의 재료가 정의의 공유 칸 전부로 넓어져 값이 바뀐다(키 · 형식 그대로, 클라 변경 없음).
+
 ## 0.22.1 변경 - 노드 추가 결과에 컨트롤러 기동 여부 (자바 v2.18.1 와 같음, started · wait 는 짝 엔진 7.0.1.3602 이상)
 
 - ``addNode`` 결과(``ILClusterNodeAddResult``)에 ``started`` · ``wait``(``is_started()``): 자리를 맡은 서비스가 컨트롤러를 **띄웠는가**와
   안 띄운 까닭(``MANUAL`` - 정의 STARTMODE 가 MANUAL 이라 :meth:`startCluster` 로 띄운다 · ``STOPPED`` - 사용자가 멈춰 둠 · ``FAILED`` -
   띄우다 실패, ilsvc 로그). 그 전 엔진은 이 칸을 주지 않아 맡았으면 띄운 것으로 본다(종전 동작).
-- 문서: 클러스터 팔로워 노드에 보낸 생성 · 변경 · 삭제는 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은 팔로워도 답한다.
+- 문서: **토픽**의 생성 · 변경 · 삭제를 클러스터 팔로워 노드에 보내면 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은
+  팔로워도 답한다. 쿼터 · 디스크 가드 · 클러스터(서비스가 받는 설정)에는 이 거절이 없다(배포 뒤 정정 - 처음에는 네 오브젝트 모두로 잘못 적었다).
 
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 

{jetstream_api-0.22.1 → jetstream_api-0.23.0}/ilink/__init__.py

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

{jetstream_api-0.22.1 → jetstream_api-0.23.0}/ilink/admin.py

@@ -4005,6 +4005,8 @@ class ILAdminQmgr:
                 print(q.getName(), q.get_type_string(), q.getDepth())
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueListV2()
             res_msg = self.service.inquire(self.qmgrName, ILC.MIMQ_GET_QUEUE_LIST)
             if res_msg.getType() == ILC.MIMQ_REPORT_MESSAGE:
                 raise ILOperationException(res_msg.getReportMsg().getArg2())
@@ -4028,6 +4030,8 @@ class ILAdminQmgr:
             목록 화면을 주기적으로 갱신할 때처럼 자주 부르는 경우에 쓴다.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueMinorListV2(ILQueueMinorProperty)
             if self.revision < 2762:
                 props = self.getQueueList()
                 return [prop.get_minor_property() for prop in props]
@@ -4053,6 +4057,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueListV2(ILC.MIMQ_LOCAL_PERSISTENT)
             res_msg = self.service.inquire(
                 self.qmgrName, ILC.MIMQ_GET_QUEUE_LIST, str(ILC.MIMQ_LOCAL_PERSISTENT)
             )
@@ -4075,6 +4081,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueMinorListV2(ILLocalQueueMinorProperty, ILC.MIMQ_LOCAL_PERSISTENT)
             if self.revision < 2762:
                 props = self.getLocalQueueList()
                 return [prop.get_minor_property() for prop in props]
@@ -4106,6 +4114,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueListV2(ILC.MIMQ_REMOTE_QUEUE)
             res_msg = self.service.inquire(
                 self.qmgrName, ILC.MIMQ_GET_QUEUE_LIST, str(ILC.MIMQ_REMOTE_QUEUE)
             )
@@ -4128,6 +4138,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueMinorListV2(ILRemoteQueueMinorProperty, ILC.MIMQ_REMOTE_QUEUE)
             if self.revision < 2762:
                 props = self.getRemoteQueueList()
                 return [prop.get_minor_property() for prop in props]
@@ -4158,6 +4170,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueListV2(ILC.MIMQ_CHANNEL_TRANSMISSION_QUEUE)
             res_msg = self.service.inquire(
                 self.qmgrName,
                 ILC.MIMQ_GET_QUEUE_LIST,
@@ -4185,6 +4199,8 @@ class ILAdminQmgr:
             깊이만 주기적으로 보며 **전송 적체**를 감시할 때 적합하다.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueMinorListV2(ILXmitQueueMinorProperty, ILC.MIMQ_CHANNEL_TRANSMISSION_QUEUE)
             if self.revision < 2762:
                 props = self.getXmitQueueList()
                 return [prop.get_minor_property() for prop in props]
@@ -4284,6 +4300,9 @@ class ILAdminQmgr:
             **그 값들은 무시된다** - 설정해도 반영되지 않는다.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                self.createQueueWithResult(prop)
+                return
             self.service.apply(
                 self.qmgrName,
                 ILC.MIMQ_CREATE_QUEUE_REQUEST,
@@ -4349,6 +4368,9 @@ class ILAdminQmgr:
 
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                self.removeQueueWithResult(queueName)
+                return
             self.service.request(
                 self.qmgrName,
                 ILC.MIMQ_REMOVE_QUEUE,
@@ -4571,6 +4593,123 @@ class ILAdminQmgr:
         except Exception as exc:
             raise ILException(exc) from exc
 
+    # ── 다음 판 Property v2 (B) Queue(엔진 P3, 설계 §14) ── 상대가 7 이면 JSON, 6.x 면 기존 블롭(구버전 호환 용도로만, U7)
+
+    #: LIST 로 전체 속성을 받을 때의 _KEYS(설정 키 전부 + CURDEPTH). 없으면 엔진은 NAME · TYPE · CURDEPTH · MAXDEPTH 만 준다
+    _QUEUE_LIST_KEYS = [k for k, _ in ILQueueProperty._PV2_KEYS.values()] + ["CURDEPTH"]
+
+    def _queueV2(self) -> bool:
+        return _propv2.peer_speaks_v2(self.version)
+
+    def _queueReq(self, code: int, body: dict) -> dict:
+        # 관리 연결이라 대상 큐 관리자 이름을 실어 ilsvc 가 중계한다(토픽과 같다)
+        return _propv2.request(self.service, self.qmgrName, code, dict({"_TYPE": "QUEUE"}, **body))
+
+    def _queueItems(self, obj: dict) -> list:
+        items = obj.get("_ITEMS", []) or []
+        if not isinstance(items, list) or any(not isinstance(e, dict) for e in items):
+            raise _propv2.PropV2Error("_ITEMS must be ARRAY of OBJ")
+        return [ILQueueProperty()._pv2_from_body(e) for e in items]
+
+    def _queueListV2(self, qtype: int | None = None) -> list:
+        # 종류 거르기는 클라가 한다(옛 3016 arg 의 엔진 거르기와 같은 결과)
+        qs = self._queueItems(self._queueReq(_propv2.PROP_LIST, {"_KEYS": ILAdminQmgr._QUEUE_LIST_KEYS}))
+        return [q for q in qs if qtype is None or q.type == qtype]
+
+    def _queueMinorListV2(self, cls, qtype: int | None = None) -> list:
+        out = []
+        for q in self._queueItems(self._queueReq(_propv2.PROP_LIST, {})):
+            if qtype is None or q.type == qtype:
+                m = cls()
+                m.name, m.type, m.depth = q.name, q.type, q.depth
+                out.append(m)
+        return out
+
+    def _queueGetV2(self, queueName: str, qtype: int | None = None) -> ILQueueProperty:
+        q = ILQueueProperty()._pv2_from_body(self._queueReq(_propv2.PROP_GET, {"NAME": queueName}))
+        if qtype is not None and q.type != qtype:
+            # 옛 3018 종류 거르기와 같은 사유(엔진 ConfigHelper GetQueueProperty)
+            raise ILOperationException("MIMQE_OBJECT_NOT_FOUND (%s : TYPE_NOT_MATCHED)" % queueName)
+        return q
+
+    def createQueueWithResult(self, prop: ILQueueProperty) -> ILPropertyResult:
+        """:meth:`createQueue` 와 같고, 엔진이 무엇을 적용 · 무시했는지 돌려준다(다음 판).
+
+        Args:
+            prop (ILQueueProperty): 만들 큐.
+
+        Returns:
+            ILPropertyResult: 적용(``applied``) · 무시(``ignored``) 목록. **6.x 엔진이면 빈 결과**다(옛 와이어에는 결과가 없다).
+
+        Raises:
+            ILOperationException: 엔진이 거절했을 때(사유 그대로).
+            ILException: 통신 실패.
+        """
+        try:
+            if not self._queueV2():
+                self.createQueue(prop)
+                return ILPropertyResult({})
+            res = ILPropertyResult(self._queueReq(_propv2.PROP_CREATE, prop._pv2_create_body()))
+            prop._pv2_clear()
+            return res
+        except _PASSTHROUGH_EXCEPTIONS:
+            raise
+        except Exception as exc:
+            raise ILException(exc) from exc
+
+    def setQueuePropertyWithResult(self, prop: ILQueueProperty) -> ILPropertyResult:
+        """:meth:`setQueueProperty` 와 같고, 엔진이 무엇을 적용 · 무시했는지 돌려준다(다음 판).
+
+        엔진 7 에는 **세터 · 대입으로 바꾼 칸만** 보낸다(ALTER patch). 바꾼 것이 없으면 보내지 않고 빈 결과를 돌려준다.
+
+        Args:
+            prop (ILQueueProperty): 바꿀 큐(이름으로 찾는다).
+
+        Returns:
+            ILPropertyResult: 적용 · 무시 목록. **6.x 엔진이면 빈 결과**다.
+
+        Raises:
+            ILOperationException: 엔진이 거절했을 때(사유 그대로).
+            ILException: 통신 실패.
+        """
+        try:
+            if not self._queueV2():
+                self.setQueueProperty(prop)
+                return ILPropertyResult({})
+            body = prop._pv2_patch_body()
+            if not body:
+                return ILPropertyResult({})
+            res = ILPropertyResult(self._queueReq(_propv2.PROP_ALTER, body))
+            prop._pv2_clear()
+            return res
+        except _PASSTHROUGH_EXCEPTIONS:
+            raise
+        except Exception as exc:
+            raise ILException(exc) from exc
+
+    def removeQueueWithResult(self, queueName: str) -> ILPropertyResult:
+        """:meth:`removeQueue` 와 같고 엔진 결과를 돌려준다(다음 판). **6.x 엔진이면 빈 결과**다.
+
+        Args:
+            queueName (str): 지울 큐 이름.
+
+        Returns:
+            ILPropertyResult: 엔진 결과.
+
+        Raises:
+            ILOperationException: 엔진이 거절했을 때(비어 있지 않은 큐 등, 사유 그대로).
+            ILException: 통신 실패.
+        """
+        try:
+            if not self._queueV2():
+                self.removeQueue(queueName)
+                return ILPropertyResult({})
+            return ILPropertyResult(self._queueReq(_propv2.PROP_DELETE, {"NAME": queueName}))
+        except _PASSTHROUGH_EXCEPTIONS:
+            raise
+        except Exception as exc:
+            raise ILException(exc) from exc
+
     def _queueBlob(self, prop: ILQueueProperty) -> bytes:
         """큐 속성을 **붙어 있는 엔진이 이해하는 레이아웃**으로 직렬화한다.
 
@@ -4638,6 +4777,8 @@ class ILAdminQmgr:
                 print(q.getDepth(), "/", q.getMaxDepth())
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueGetV2(queueName)
             res_msg = self.service.inquire(
                 self.qmgrName, ILC.MIMQ_GET_QUEUE_PROPERTY, queueName
             )
@@ -4663,6 +4804,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueGetV2(queueName, ILC.MIMQ_LOCAL_PERSISTENT)
             res_msg = self.service.inquire(
                 self.qmgrName,
                 ILC.MIMQ_GET_QUEUE_PROPERTY,
@@ -4693,6 +4836,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueGetV2(queueName, ILC.MIMQ_REMOTE_QUEUE)
             res_msg = self.service.inquire(
                 self.qmgrName,
                 ILC.MIMQ_GET_QUEUE_PROPERTY,
@@ -4722,6 +4867,8 @@ class ILAdminQmgr:
             ILException: 통신 실패.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                return self._queueGetV2(queueName, ILC.MIMQ_CHANNEL_TRANSMISSION_QUEUE)
             res_msg = self.service.inquire(
                 self.qmgrName,
                 ILC.MIMQ_GET_QUEUE_PROPERTY,
@@ -4781,6 +4928,9 @@ class ILAdminQmgr:
             **그 값들은 무시된다** - 설정해도 반영되지 않는다.
         """
         try:
+            if self._queueV2():   # 다음 판(엔진 P3): 7 이면 JSON, 6.x 면 아래 블롭
+                self.setQueuePropertyWithResult(prop)
+                return
             self.service.apply(
                 self.qmgrName,
                 ILC.MIMQ_SET_QUEUE_PROPERTY,
@@ -5831,8 +5981,9 @@ class ILAdminQmgr:
             timeout (int): 최대 대기 **초**.
 
         Returns:
-            str: 최종 상태 문자열(``"RUNNING"`` / ``"EXCEPTION"`` 등, 시간이
-            다하면 그 시점의 상태). **예외가 아니라 문자열로 결과를 알리므로**
+            str: 최종 상태 문자열(``"RUNNING"`` / ``"EXCEPTION"`` / ``"STANDBY"`` 등, 시간이
+            다하면 그 시점의 상태). ``"STANDBY"`` 는 리더에서만 일하는 채널이 팔로워에서 대기에 든 것이라
+            기다리지 않고 곧바로 돌려준다. **예외가 아니라 문자열로 결과를 알리므로**
             값을 반드시 확인하라.
 
         Raises:
@@ -5856,7 +6007,9 @@ class ILAdminQmgr:
             status_str = ""
             for _ in range(timeout):
                 status_str = self.getChannelProperty(channelName).get_status_string()
-                if status_str in (ILC.MIMQ_RUNNING_STR, ILC.MIMQ_ERROR_STR):
+                # 채널 상태 문자열은 오류를 "EXCEPTION" 으로 낸다(자바 · ilsc 는 "ERROR") - 둘 다 끝으로 본다.
+                #   전에는 "ERROR" 만 봐서 채널 오류에서 시한까지 기다렸다
+                if status_str in (ILC.MIMQ_RUNNING_STR, ILC.MIMQ_ERROR_STR, "EXCEPTION", "STANDBY"):
                     break
                 time.sleep(1)
             return status_str
@@ -5912,7 +6065,7 @@ class ILAdminQmgr:
             status_str = ""
             for _ in range(timeout):
                 status_str = self.getChannelProperty(channelName).get_status_string()
-                if status_str in (ILC.MIMQ_STOPPED_STR, ILC.MIMQ_ERROR_STR):
+                if status_str in (ILC.MIMQ_STOPPED_STR, ILC.MIMQ_ERROR_STR, "EXCEPTION"):
                     break
                 time.sleep(1)
             return status_str
@@ -5929,7 +6082,7 @@ class ILAdminQmgr:
         Args:
             channelName (str): 채널 이름.
             status (ILChannelStatus): 기다릴 목표 상태
-                (``RUNNING`` / ``STOPPED`` / ``STARTING`` / ``STOPPING`` / ``EXCEPTION``).
+                (``RUNNING`` / ``STOPPED`` / ``STARTING`` / ``STOPPING`` / ``EXCEPTION`` / ``STANDBY``).
             timeout (int): 최대 대기 **초**.
 
         Returns:
@@ -7117,7 +7270,7 @@ class ILAdminQmgr:
             #   (CSV / epoch / 노드 / 확장 - 줄바꿈 구분)로, 옛 엔진은 arg2 를 안 읽고 종전 REPORT 로 답한다 - 둘 다 받는다.
             res = self.service.inquire_data_or_report(
                 self.qmgrName, ILC.MIMQ_CLUSTER_NODE_STATUS, None,
-                ILC.MIMQ_COORD_OBSERVER, ILC.MIMQ_CLUSTER_STATUS_EXT_MARK, "")
+                "", ILC.MIMQ_CLUSTER_STATUS_EXT_MARK, "")
             if res.getType() == ILC.MIMQ_LONG_REPORT_MESSAGE:
                 body = res.getDataMsg().getData().decode("utf-8", "replace")
                 lines = body.split("\n", 3)

{jetstream_api-0.22.1 → jetstream_api-0.23.0}/ilink/common.py

@@ -409,8 +409,8 @@ class ILC:
 
     # 클러스터(HA) - 클라이언트 페일오버 지원
     MIMQ_CLUSTER_NODE_STATUS = 3370
-    #: 3370 요청 arg1 = 관측 표시(엔진 r3500 부터는 읽지 않는다 - 옛 엔진에 리스를 건드리지 않는 값).
-    MIMQ_COORD_OBSERVER = "O"
+    # 다음 판: 3370 요청 arg1 관측 표시 MIMQ_COORD_OBSERVER("O", 판사 시절)를 없앴다 - arg1 은 빈칸이다.
+    #   엔진 r3486 부터 이 칸을 읽지 않고 r3603 부터 엔진 C++ API 도 빈칸으로 보낸다(getClusterRole 은 원래 빈칸).
     #: 3370 요청 arg2 = 확장 응답 요청. 엔진 r3500 부터 LONG_REPORT 4줄로 답한다(옛 엔진은 무시하고 REPORT).
     MIMQ_CLUSTER_STATUS_EXT_MARK = "X"
     MIMQ_CLUSTER_CLIENT_INFO = 3373
@@ -484,14 +484,8 @@ class ILC:
     # 노드(큐관리자)에게 묻는 런타임 관측 리포트 (OBS-1). TEXT | JSON
     MIMQ_GET_CLUSTER_RUNTIME = 3381
 
-    # 클러스터 속성 블롭 레이아웃 (C++ ClusterProperty.hpp 정본)
-    #   고정부(768) + 노드수(5) + 노드 x 384  - **가변 길이**라 고정폭 리스트 파서를 쓸 수 없다.
-    # 판 이력: 256 -> 512(CLSTOPO-1, 3-서비스 토폴로지) -> 768(컴트롤러 정족수).
-    #   ★ 768 판부터는 블롭 앞머리에 판 표시가 있다(:data:`ilink.properties.CLUSTER_LAYOUT_MARK`).
-    #   그 전 판은 표시가 없어 **레거시로 보고 거절**한다 - 길이로는 못 가른다
-    #   (512+5+256 과 768+5+0 이 둘 다 773 이다).
-    MIMQ_VO_CLUSTER_LEN = 768
-    MIMQ_VO_CLUSTER_NODE_LEN = 384
+    # 0.22.3: 클러스터 속성의 옛 고정폭 블롭(768 + 5 + 384 x N) 상수 MIMQ_VO_CLUSTER_LEN / MIMQ_VO_CLUSTER_NODE_LEN 을 없앴다 -
+    #   엔진 r3601 이 클러스터를 Property v2(JSON) 전용으로 바꾸며 그 형식을 지웠다.
     MIMQ_LIST_SIZE_LENGTH = 5
 
     # ------------------------------------------------------------------
@@ -983,8 +977,8 @@ class ILC:
     #: 능력 선언의 최대 길이(접두 포함). 넘으면 **자르지 않고 통째로 버린다** -
     #: 자르면 ``clsblob=2`` 가 ``clsblob=`` 가 되어 **읽히는데 뜻이 다른** 값이 된다.
     MIMQ_CLIENT_CAPS_MAX = 63
-    #: 이 클라가 읽고 쓰는 클러스터 블롭 판. :data:`ilink.properties.CLUSTER_LAYOUT_MARK`
-    #: 와 능력 선언이 **모두 이 값에서 나온다** - 판 번호를 두 곳에 적지 않는다.
+    #: 능력 선언(``CAP=clsblob=2``)의 클러스터 블롭 판. 0.22.3 부터 클라는 클러스터를 JSON 으로만 주고받지만(옛 블롭 코덱 제거)
+    #: 접속 능력 선언 토큰은 바꾸지 않는다 - 엔진이 핸드셰이크에서 읽는 값이다.
     MIMQ_CLUSTER_BLOB_VERSION = 2
     MIMQ_SESSION_STATUS_DEAD = 0
     MIMQ_SESSION_STATUS_IDLE = 1

{jetstream_api-0.22.1 → jetstream_api-0.23.0}/ilink/exception.py

@@ -82,7 +82,10 @@ class ILException(Exception):
         cause = self.__cause__ or (self.args[0] if self.args else None)
         # 0.18.1: 시간 초과도 코드만으로는 **무엇이 얼마나 걸렸고 마지막에 무슨 답을 받았나**가 안 보인다 -
         #   발행 시간 초과를 "내부 오류" 로 오독한 일이 있었다(회귀 · 엔진). 원인 문구를 붙인다
-        if isinstance(cause, (ILDeserializeException, ILTimeoutException)):
+        # 다음 판: Property v2 본문 규칙 위반(모르는 열거 문자열 · 값 종류 · 깨진 JSON)도 원인이 코드로 안 담긴다 - 전에는
+        #   "MIMQE_INTERNAL_ERROR" 만 보였다
+        from ._propv2 import PropV2Error
+        if isinstance(cause, (ILDeserializeException, ILTimeoutException, PropV2Error)):
             detail = str(cause).strip()
             if detail and detail not in base:
                 return f"{base} {detail}"