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

{jetstream_api-0.22.0/jetstream_api.egg-info → jetstream_api-0.22.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.22.0
+Version: 0.22.1
 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,6 +60,13 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 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=..)``, 조회 · 목록은 팔로워도 답한다.
+
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 
 - **와이어**: 쿼터 · 디스크 가드 · 토픽 · 클러스터의 생성 · 조회 · 목록 · 변경 · 삭제가 새 요청 코드 3600~3604(본문 = UTF-8 JSON)로 간다.

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

@@ -10,6 +10,13 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 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=..)``, 조회 · 목록은 팔로워도 답한다.
+
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 
 - **와이어**: 쿼터 · 디스크 가드 · 토픽 · 클러스터의 생성 · 조회 · 목록 · 변경 · 삭제가 새 요청 코드 3600~3604(본문 = UTF-8 JSON)로 간다.

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

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

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

@@ -1516,7 +1516,8 @@ class ILAdminService:
         Returns:
             ILClusterNodeAddResult: 이 서비스가 그 자리를 **곧바로 맡았는가**. 맡았으면
             :meth:`joinCluster` 가 필요 없다. 새 자리가 이 서비스 호스트의 컨트롤러 전용 자리일 때만 맡는다 -
-            **브로커를 더하면 어디서 불러도 맡지 않은 것으로 나온다.**
+            **브로커를 더하면 어디서 불러도 맡지 않은 것으로 나온다.** ★ 맡았다고 곧 뜨는 것은 아니다 - 그 서비스의 정의
+            ``STARTMODE`` 가 ``AUTO`` 면 컨트롤러가 저절로 뜨고, ``MANUAL`` 이면 :meth:`startCluster` 를 불러야 뜬다(엔진 r3492 부터).
 
         Raises:
             ILOperationException: 엔진이 거절할 때(사유 문자열로 가른다) - 투표권(``coordinator=True``)을
@@ -1561,7 +1562,10 @@ class ILAdminService:
         r = self._alter_cluster(p).get("_RESULT") or {}
         if not r.get("CLAIMED"):
             return ILClusterNodeAddResult()
-        return ILClusterNodeAddResult("CLAIMED", str(r.get("NODE", "")), str(r.get("CTRLPORT", "")))
+        # 0.22.1: 엔진 r3602 부터 STARTED / WAIT(맡은 서비스가 컨트롤러를 띄웠는가) - 없으면(그 전 엔진) 띄운 것으로 본다
+        st = r.get("STARTED")
+        return ILClusterNodeAddResult("CLAIMED", str(r.get("NODE", "")), str(r.get("CTRLPORT", "")),
+                                      None if st is None else bool(st), str(r.get("WAIT", "") or ""))
 
     def removeNode(self, clusterName: str, nodeId: int) -> None:
         """클러스터에서 **투표권 없는 노드 하나**(컨트롤러 전용 노드 또는 브로커)를 뺀다.

{jetstream_api-0.22.0 → jetstream_api-0.22.1}/ilink/properties.py

@@ -4789,6 +4789,9 @@ class ILPropertyResult(_AutoAccessor):
     엔진이 무엇을 적용했고 무엇을 무시했는지 돌려준다 - 모르는 키를 무시하는 규칙(U4)이 **조용한 무시**가 되지 않게
     하는 장치다. 무시된 키가 있으면 라이브러리는 WARNING 로그도 남긴다(결과를 돌려주지 않는 옛 메서드도 같다).
 
+    클러스터의 팔로워 노드에 보낸 변경(CREATE / ALTER / DELETE)은 ``MIMQE_OPERATION_DENIED (STANDBY, leader=<리더>)`` 로
+    거절된다(연결 유형과 무관, 엔진 r3601). 조회(GET / LIST)는 팔로워도 답한다.
+
     Attributes:
         applied (list[tuple[str, str]]): 적용된 키와 반영 시점 ``(키, "NOW" | "RESTART")``.
         ignored (list[tuple[str, str]]): 무시된 키와 까닭 ``(키 경로, "unknown" | "retired" | "readonly" | "unsupported-by-peer")``.
@@ -5863,15 +5866,21 @@ class ILClusterNodeAddResult(_AutoAccessor):
         claimed (bool): 이 서비스가 그 자리를 맡았는가.
         nodeId (int): 맡은 노드 번호. 맡지 않았으면 0.
         ctrlPort (int): 맡은 자리의 ctrl 포트. 맡지 않았으면 0.
+        started (bool): 자리를 맡은 이 서비스가 컨트롤러(ilcc)를 **띄웠는가**(0.22.1, 엔진 r3602). 맡지 않았으면 False.
+            그 전 엔진은 이 칸을 주지 않으므로 맡았으면 True 로 본다(종전 동작).
+        wait (str): 맡았는데 띄우지 않은 까닭. ``"MANUAL"``(정의 STARTMODE 가 MANUAL - :meth:`ILAdminService.startCluster` 로
+            띄운다) · ``"STOPPED"``(사용자가 멈춰 두었다) · ``"FAILED"``(띄우다 실패 - ilsvc 로그). 띄웠거나 맡지 않았으면 ``""``.
     """
 
-    def __init__(self, arg1: str = "", arg2: str = "", arg3: str = "") -> None:
-        """응답 arg 세 개를 파싱한다. **응용이 직접 만들 일은 없다.**
+    def __init__(self, arg1: str = "", arg2: str = "", arg3: str = "", started: bool | None = None, not_started_reason: str = "") -> None:
+        """응답 칸을 파싱한다. **응용이 직접 만들 일은 없다.**
 
         Args:
             arg1 (str): ``"CLAIMED"`` 면 맡았다. 비면 맡지 않았다.
             arg2 (str): 노드 번호.
             arg3 (str): ctrl 포트.
+            started (bool | None): 엔진의 ``STARTED``. None(그 전 엔진)이면 맡았을 때 True.
+            not_started_reason (str): 엔진의 ``WAIT`` - ``"MANUAL"`` · ``"STOPPED"`` · ``"FAILED"`` 중 하나 또는 ``""``.
         """
         def _int(v):
             try:
@@ -5881,6 +5890,8 @@ class ILClusterNodeAddResult(_AutoAccessor):
         self.claimed = str(arg1 or "").strip() == "CLAIMED"
         self.nodeId = _int(arg2) if self.claimed else 0
         self.ctrlPort = _int(arg3) if self.claimed else 0
+        self.started = self.claimed and (True if started is None else bool(started))
+        self.wait = "" if (not self.claimed or self.started) else str(not_started_reason or "")
 
     def is_claimed(self) -> bool:
         """이 서비스가 그 자리를 맡았는가.
@@ -5892,14 +5903,33 @@ class ILClusterNodeAddResult(_AutoAccessor):
 
     isClaimed = is_claimed
 
+    def is_started(self) -> bool:
+        """자리를 맡은 이 서비스가 컨트롤러를 띄웠는가(0.22.1).
+
+        Returns:
+            bool: 띄웠으면 True. 맡지 않았으면 False.
+        """
+        return self.started
+
+    isStarted = is_started
+
+    _WAIT_TEXT = {
+        "MANUAL": "STARTMODE is MANUAL - run startCluster",
+        "STOPPED": "the cluster was stopped here - run startCluster",
+        "FAILED": "starting it failed - see the ilsvc log",
+    }
+
     def __str__(self) -> str:
         """사람이 읽는 한 줄 요약을 돌려준다.
 
         Returns:
-            str: 맡았는지와 자리. 형식은 고정이 아니므로 파싱하지 말 것.
+            str: 맡았는지 · 띄웠는지와 자리. 형식은 고정이 아니므로 파싱하지 말 것.
         """
+        if self.claimed and self.started:
+            return "node added: claimed node[%d] ctrl port %d here and started its controller" % (self.nodeId, self.ctrlPort)
         if self.claimed:
-            return "node added: claimed node[%d] ctrl port %d here" % (self.nodeId, self.ctrlPort)
+            return "node added: claimed node[%d] ctrl port %d here but did not start it: %s" % (
+                self.nodeId, self.ctrlPort, self._WAIT_TEXT.get(self.wait, self.wait or "unknown"))
         return "node added: not claimed here (joinCluster on the service that should host it)"
 
 

{jetstream_api-0.22.0 → jetstream_api-0.22.1/jetstream_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.22.0
+Version: 0.22.1
 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,6 +60,13 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 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=..)``, 조회 · 목록은 팔로워도 답한다.
+
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 
 - **와이어**: 쿼터 · 디스크 가드 · 토픽 · 클러스터의 생성 · 조회 · 목록 · 변경 · 삭제가 새 요청 코드 3600~3604(본문 = UTF-8 JSON)로 간다.

{jetstream_api-0.22.0 → jetstream_api-0.22.1}/pyproject.toml

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