jetstream-api 0.20.2__tar.gz → 0.20.3__tar.gz

{jetstream_api-0.20.2 → jetstream_api-0.20.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.20.2
+Version: 0.20.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
@@ -60,6 +60,12 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.20.3 변경 - 토픽 파티션 격리본 재주입 (자바 v2.16.3 과 같음, 짝 엔진 7.0.1.3512 이상 - 토픽 격리본은 7.0.1.3553 이상)
+
+- 격리본 토픽 파티션(엔진 7.0.1.3553 QUARTOOL-2): `reinjectQuarantine` 의 큐 인자를 선택으로 바꿨다 - 토픽 파티션 격리본은 큐를 비우고
+  부른다(큐 격리본에 비우면 엔진이 `MIMQE_INVALID_ARGUMENT (QUEUE required)`). 0.20.2 는 빈 큐를 보내기 전에 막았다. 토픽 격리본의
+  SINCE 는 **오프셋**이고(빈 값 = 격리 때 잘라 낸 시작, `"ALL"` = 전부), 목록 · 검사 원문에 `P` · `T` 줄과 `offset <시작>` 머리가 온다.
+
 ## 0.20.2 변경 - 관제 명령 관리 API · 강제 선출 · 리더십 표 · 격리본 (자바 v2.16.2 와 같음, 짝 엔진 7.0.1.3512 이상 - 리더십 표 · 격리본 · 키 단위 강제 선출은 7.0.1.3552 이상)
 
 - **리더십 표 · 격리본**(엔진 7.0.1.3552 이상, 그 전 엔진은 `MIMQE_INVALID_REQ_CODE`):

{jetstream_api-0.20.2 → jetstream_api-0.20.3}/README.md

@@ -10,6 +10,12 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.20.3 변경 - 토픽 파티션 격리본 재주입 (자바 v2.16.3 과 같음, 짝 엔진 7.0.1.3512 이상 - 토픽 격리본은 7.0.1.3553 이상)
+
+- 격리본 토픽 파티션(엔진 7.0.1.3553 QUARTOOL-2): `reinjectQuarantine` 의 큐 인자를 선택으로 바꿨다 - 토픽 파티션 격리본은 큐를 비우고
+  부른다(큐 격리본에 비우면 엔진이 `MIMQE_INVALID_ARGUMENT (QUEUE required)`). 0.20.2 는 빈 큐를 보내기 전에 막았다. 토픽 격리본의
+  SINCE 는 **오프셋**이고(빈 값 = 격리 때 잘라 낸 시작, `"ALL"` = 전부), 목록 · 검사 원문에 `P` · `T` 줄과 `offset <시작>` 머리가 온다.
+
 ## 0.20.2 변경 - 관제 명령 관리 API · 강제 선출 · 리더십 표 · 격리본 (자바 v2.16.2 와 같음, 짝 엔진 7.0.1.3512 이상 - 리더십 표 · 격리본 · 키 단위 강제 선출은 7.0.1.3552 이상)
 
 - **리더십 표 · 격리본**(엔진 7.0.1.3552 이상, 그 전 엔진은 `MIMQE_INVALID_REQ_CODE`):

{jetstream_api-0.20.2 → jetstream_api-0.20.3}/ilink/__init__.py

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

{jetstream_api-0.20.2 → jetstream_api-0.20.3}/ilink/admin.py

@@ -4236,7 +4236,8 @@ class ILAdminQmgr:
         Returns:
             str: 엔진이 준 텍스트 그대로. 첫 줄 ``QL1|<격리 루트>``, 그다음
             ``D|<디렉터리>|<NODE|GROUP|TOPIC|?>|<파일 수>|<바이트>|<기준 시각 또는 ->|<FORK.txt 첫 줄 또는 ->`` 와
-            ``Q|<디렉터리>|<큐>|<세그먼트 수>|<재주입 건수>`` 줄.
+            ``Q|<디렉터리>|<큐>|<세그먼트 수>|<재주입 건수>`` 줄. 엔진 7.0.1.3553 부터 토픽 파티션 격리본 줄
+            ``P|<디렉터리>|<토픽>/<파티션>|<잘라 낸 시작 오프셋 또는 ->|<재주입 건수>`` 도 온다.
 
         Raises:
             ILOperationException: 엔진이 거절했을 때(7.0.1.3552 전 엔진은 ``MIMQE_INVALID_REQ_CODE``).
@@ -4254,15 +4255,19 @@ class ILAdminQmgr:
 
         Args:
             directory (str): 격리 디렉터리 이름(한 단계 - ``/`` ``\\`` ``:`` 금지).
-            queueName (str | None): 큐. ``None`` 이면 그 디렉터리의 모든 큐 요약.
-            since (str | int | None): 기준. ``None`` 이면 디렉터리 기준 시각, ``"ALL"`` 이면 전부,
-                ``"yyyymmddhhmmss"`` 문자열이나 epoch 밀리초 숫자.
+            queueName (str | None): 큐. ``None`` 이면 그 디렉터리의 모든 큐 요약. 토픽 파티션 격리본(엔진 7.0.1.3553 이상)은
+                디렉터리 종류로 엔진이 가르므로 비워 둔다.
+            since (str | int | None): 기준. 큐 격리본은 ``None`` 이면 디렉터리 기준 시각, ``"ALL"`` 이면 전부,
+                ``"yyyymmddhhmmss"`` 문자열이나 epoch 밀리초 숫자. ☠ **토픽 격리본은 뜻이 다르다** - ``None`` 이면 격리 때 기록한
+                잘라 낸 시작 오프셋(CUT.txt, 없는 옛 격리본은 거절), ``"ALL"`` 이면 사본 전부, 숫자는 그 **오프셋**부터.
 
         Returns:
             str: 엔진이 준 텍스트 그대로. 첫 줄 ``QS1|<디렉터리>|<큐 또는 *>|<기준>``, 큐마다
             ``S|<큐>|<전체>|<LIVE>|<CANDIDATE>|<OLD>|<DONE>``, 큐를 줬으면 재주입 대상 앞 500건
             ``M|C|<IndexId>|<PUT 시각>|<바이트>|<MsgId>``. LIVE = 지금 큐에 있음, CANDIDATE = 재주입 대상, OLD = 기준 전(소비됐을
-            가능성), DONE = 이미 재주입.
+            가능성), DONE = 이미 재주입. 토픽 격리본(엔진 7.0.1.3553 이상)이면 첫 줄 넷째 칸이 ``offset <시작>`` 이고,
+            ``S|<토픽>/<파티션>|<사본 전체>|<KEPT = 시작 앞>|<CANDIDATE>|0|<DONE>``, 앞 500건은 M 줄 대신
+            ``T|C|<오프셋>|<배치 시각>|<값 바이트>|<키 또는 ->`` 줄이다.
 
         Raises:
             ILOperationException: 엔진이 거절했을 때(디렉터리 · 큐가 없으면 ``MIMQE_OBJECT_NOT_FOUND`` 등).
@@ -4276,7 +4281,7 @@ class ILAdminQmgr:
         except Exception as exc:
             raise ILException(exc) from exc
 
-    def reinjectQuarantine(self, directory: str, queueName: str, since=None) -> "ILQuarantineReinjectResult":
+    def reinjectQuarantine(self, directory: str, queueName: str | None = None, since=None) -> "ILQuarantineReinjectResult":
         """격리본의 재주입 대상(CANDIDATE)을 **그 큐의 지금 리더에 다시 넣는다** - ilsc ``REINJECT`` (0.20.2, 엔진 7.0.1.3552).
 
         원래 MsgId · CorrelId 로 PUT 하고 100건마다 커밋한다. 넣은 것은 기록되어 다시 넣지 않는다. **먼저**
@@ -4284,28 +4289,28 @@ class ILAdminQmgr:
 
         Args:
             directory (str): 격리 디렉터리 이름.
-            queueName (str): 큐(필수).
-            since (str | int | None): 기준(:meth:`scanQuarantine` 과 같다).
+            queueName (str | None): 큐. 큐 격리본에는 필수다(비우면 엔진이 ``MIMQE_INVALID_ARGUMENT (QUEUE required)``).
+                토픽 파티션 격리본(엔진 7.0.1.3553 이상)은 비운다 - 그 파티션에 다시 발행한다.
+            since (str | int | None): 기준(:meth:`scanQuarantine` 과 같다 - 토픽 격리본은 오프셋).
 
         Returns:
             ILQuarantineReinjectResult: 넣은 건수 · 넣은 리더 · 메모. 메모가 ``stopped: ...`` 면 중간에 멈춘 것이다 - 넣은 만큼은
             커밋됐고 다시 부르면 나머지만 넣는다.
 
         Raises:
-            UnsupportedOperationException: 큐를 주지 않았을 때(보내기 전에 막는다).
-            ILOperationException: 엔진이 거절했을 때 - ``MIMQE_OBJECT_NOT_FOUND``, 토픽 격리본이면
+            ILOperationException: 엔진이 거절했을 때 - ``MIMQE_OBJECT_NOT_FOUND``, 큐 격리본에 큐가 없으면
+                ``MIMQE_INVALID_ARGUMENT (QUEUE required)``, 7.0.1.3553 전 엔진에 토픽 격리본이면
                 ``MIMQE_UNSUPPORTED_OPERATION``, 리더가 없으면 ``MIMQE_CLUSTER_NO_LEADER``, 리더 접속 실패 사유.
             ILException: 통신 실패.
 
         Warning:
             ☠ **중복이 생길 수 있다** - ``since="ALL"`` 로 OLD(이미 소비됐을 수 있는 것)까지 넣으면 같은 메시지가 두 번 처리될 수
             있다. 넣은 메시지는 **큐 맨 뒤에** 붙는다(원래 순서 자리로 가지 않는다). 건수에 비례해 오래 걸릴 수 있으니 관리 연결의
-            세션 타임아웃을 넉넉히 둔다(ilsc 는 120초).
+            세션 타임아웃을 넉넉히 둔다(ilsc 는 120초). 토픽 격리본을 다시 발행한 레코드는 **새 오프셋 · 새 시각**을 받는다
+            (키 · 헤더 · 값은 그대로).
         """
-        if not queueName:
-            raise UnsupportedOperationException("queueName is required for reinject")
         try:
-            res = self.service.request(self.qmgrName, ILC.MIMQ_QUARANTINE_REINJECT, directory or "", queueName,
+            res = self.service.request(self.qmgrName, ILC.MIMQ_QUARANTINE_REINJECT, directory or "", queueName or "",
                                        self._quarantineSince(since))
             if res is None or res.getCode() != ILC.MIMQ_SUCCESSFUL_CLUSTER_OPERATION:
                 raise ILOperationException(res.getArg2() if res is not None else "no response")

{jetstream_api-0.20.2 → jetstream_api-0.20.3}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.20.2
+Version: 0.20.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
@@ -60,6 +60,12 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.20.3 변경 - 토픽 파티션 격리본 재주입 (자바 v2.16.3 과 같음, 짝 엔진 7.0.1.3512 이상 - 토픽 격리본은 7.0.1.3553 이상)
+
+- 격리본 토픽 파티션(엔진 7.0.1.3553 QUARTOOL-2): `reinjectQuarantine` 의 큐 인자를 선택으로 바꿨다 - 토픽 파티션 격리본은 큐를 비우고
+  부른다(큐 격리본에 비우면 엔진이 `MIMQE_INVALID_ARGUMENT (QUEUE required)`). 0.20.2 는 빈 큐를 보내기 전에 막았다. 토픽 격리본의
+  SINCE 는 **오프셋**이고(빈 값 = 격리 때 잘라 낸 시작, `"ALL"` = 전부), 목록 · 검사 원문에 `P` · `T` 줄과 `offset <시작>` 머리가 온다.
+
 ## 0.20.2 변경 - 관제 명령 관리 API · 강제 선출 · 리더십 표 · 격리본 (자바 v2.16.2 와 같음, 짝 엔진 7.0.1.3512 이상 - 리더십 표 · 격리본 · 키 단위 강제 선출은 7.0.1.3552 이상)
 
 - **리더십 표 · 격리본**(엔진 7.0.1.3552 이상, 그 전 엔진은 `MIMQE_INVALID_REQ_CODE`):

{jetstream_api-0.20.2 → jetstream_api-0.20.3}/pyproject.toml

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