jetstream-api 0.11.0__tar.gz → 0.12.0__tar.gz

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.11.0
+Version: 0.12.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,6 +60,18 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.12.0 변경 - 큐 전용 요청 코드(엔진 7.0.1.3431 이상) 자동 사용 (자바 v2.8.0 과 같음)
+
+- **앱 코드는 바꿀 것이 없습니다.** 엔진 판 줄이 7.x 이고 리비전이 3431 이상이면 클라이언트가 스스로 새 요청 코드를 씁니다.
+  그 밖의 엔진(6.3.x, 그보다 앞선 7.x, 5.x)에는 0.11.0 과 같은 요청을 보냅니다.
+- **`commit_and_get`** 은 커밋 요청과 get 요청 대신 전용 요청 하나(COMMIT_AND_GET, 3402)를 보내고 응답도 하나만 받습니다.
+  엔진이 커밋한 뒤 곧바로 get 을 돌립니다. 결과와 예외는 0.11.0 과 같습니다.
+  - 커밋이 거절되면 get 은 돌지 않았고, 롤백을 보내 커밋하려던 작업과 꺼낸 메시지를 큐에 되돌린 뒤 `ILOperationException` 을 올립니다.
+  - 응답을 받기 전에 연결이 끊기면 커밋 결과를 알 수 없습니다(재접속 / 재시도 없음). 커밋 결과가 get 결과와 한 응답으로 오므로
+    **결과를 알 수 없는 구간이 get 대기 시간까지** 늘어납니다.
+- **`commit()`** 은 쥐고 있던 트랜잭션 put 이 **하나뿐**이면 put 과 커밋 대신 전용 요청 하나(PUT_AND_COMMIT, 3403)로 보냅니다.
+  돌려주는 값과 예외는 같습니다. put 이 둘 이상이거나 `puts`, 64KiB 를 넘는 put, 쥔 것이 없을 때는 0.11.0 과 같습니다.
+
 ## 0.11.0 변경 - 큐 단건 put / get 가속, `commit_and_get` 추가
 
 - **새 API `ILQueue.commit_and_get(matchId=None, option=MatchOption.NONE)`** (camelCase 별칭 `commitAndGet`): 이 세션의

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/README.md

@@ -10,6 +10,18 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.12.0 변경 - 큐 전용 요청 코드(엔진 7.0.1.3431 이상) 자동 사용 (자바 v2.8.0 과 같음)
+
+- **앱 코드는 바꿀 것이 없습니다.** 엔진 판 줄이 7.x 이고 리비전이 3431 이상이면 클라이언트가 스스로 새 요청 코드를 씁니다.
+  그 밖의 엔진(6.3.x, 그보다 앞선 7.x, 5.x)에는 0.11.0 과 같은 요청을 보냅니다.
+- **`commit_and_get`** 은 커밋 요청과 get 요청 대신 전용 요청 하나(COMMIT_AND_GET, 3402)를 보내고 응답도 하나만 받습니다.
+  엔진이 커밋한 뒤 곧바로 get 을 돌립니다. 결과와 예외는 0.11.0 과 같습니다.
+  - 커밋이 거절되면 get 은 돌지 않았고, 롤백을 보내 커밋하려던 작업과 꺼낸 메시지를 큐에 되돌린 뒤 `ILOperationException` 을 올립니다.
+  - 응답을 받기 전에 연결이 끊기면 커밋 결과를 알 수 없습니다(재접속 / 재시도 없음). 커밋 결과가 get 결과와 한 응답으로 오므로
+    **결과를 알 수 없는 구간이 get 대기 시간까지** 늘어납니다.
+- **`commit()`** 은 쥐고 있던 트랜잭션 put 이 **하나뿐**이면 put 과 커밋 대신 전용 요청 하나(PUT_AND_COMMIT, 3403)로 보냅니다.
+  돌려주는 값과 예외는 같습니다. put 이 둘 이상이거나 `puts`, 64KiB 를 넘는 put, 쥔 것이 없을 때는 0.11.0 과 같습니다.
+
 ## 0.11.0 변경 - 큐 단건 put / get 가속, `commit_and_get` 추가
 
 - **새 API `ILQueue.commit_and_get(matchId=None, option=MatchOption.NONE)`** (camelCase 별칭 `commitAndGet`): 이 세션의

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/ilink/__init__.py

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

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/ilink/common.py

@@ -467,6 +467,13 @@ class ILC:
     #: SUBSCRIPTION_NOT_FOUND, 그 (토픽, 구독)에 read 가 걸려 있으면(태그 롱폴 / FETCH_MULTI 항목) 4157
     #: MIMQE_READ_IN_PROGRESS. 다시 read 하면 다시 든다(재배정 통지부터). r3416 이하 엔진은 모르는 요청으로 거절한다.
     MIMQ_TOPIC_LEAVE = 3401
+    #: 0.12.0(엔진 r3431, 사용자 결정 2026-09-15): 큐 전용 요청. 판 줄 major 가 7 이고 리비전이 3431 이상인 엔진에만 보낸다.
+    #: 칸은 GET 과 같다(arg2 큐 이름, arg3 대기 ms, 확장 = 선택자). 트랜잭션 세션이면 엔진이 커밋한 뒤 GET 을 돌려 GET 응답
+    #: 하나만 준다. 커밋이 실패하면 MIMQ_NOT_SUCCESSFUL_COMMIT 하나만 온다(GET 은 돌지 않았다).
+    MIMQ_COMMIT_AND_GET_REQUEST = 3402
+    #: 0.12.0(엔진 r3431): 인자 없음, 확장 = DATA 프레임 하나(put 이 보내는 프레임). 응답은 COMMIT 과 같다. commit() 이 쥔 것이
+    #: 트랜잭션 put 하나뿐일 때 [PUT + COMMIT] 대신 쓴다.
+    MIMQ_PUT_AND_COMMIT_REQUEST = 3403
 
     # 토픽 응답 코드
     MIMQ_SUCCESSFUL_TOPIC_OPERATION = 4156

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/ilink/connectivity.py

@@ -506,6 +506,8 @@ class TCPConnector:
         # 0.11.0 K2: 응답이 없는 송신(트랜잭션 세션의 put)을 쥐고 있다가 이 연결의 다음 송신과 한 번에 쓴다(send_deferred)
         self._wpend: list = []
         self._wpend_len = 0
+        #: 0.12.0: 쥔 첫 프레임이 put(DATA)인가 - _single_pending_put 이 본다(쥔 것이 하나일 때만 뜻이 있다)
+        self._wpend_put1 = False
 
     def _rx_reset(self) -> None:
         # 받아 둔 바이트와 쥔 송신을 버린다(끊기 / 새 접속). 다음 수신은 timeout 을 다시 준다
@@ -676,11 +678,20 @@ class TCPConnector:
         data = msg.toByteArray(True)
         if (self.socket is not None and self._is_connected() and len(data) <= _WPEND_FRAME_MAX
                 and self._wpend_len + len(data) <= _WPEND_TOTAL_MAX):
+            # 0.12.0: 쥔 것이 put 프레임 하나뿐인지 본다(commit 이 PUT_AND_COMMIT 로 바꿔 쓸지). 빈 자리에 처음 쥘 때 정한다
+            if not self._wpend:
+                self._wpend_put1 = msg.getType() == ILC.MIMQ_DATA_MESSAGE
             self._wpend.append(data)
             self._wpend_len += len(data)
             return
         self.send_bytes(data)
 
+    def _single_pending_put(self) -> bytes | None:
+        # 0.12.0: 쥔 것이 put(DATA) 프레임 하나뿐이면 그 프레임(전송 구분자 포함), 아니면 None. 쥔 것은 그대로 둔다(연결 잠금 안에서 부른다)
+        if len(self._wpend) == 1 and self._wpend_put1:
+            return self._wpend[0]
+        return None
+
     def _flush_wpend(self, sock) -> None:
         # 쥔 송신을 내보낸다(K2). 실패는 송신 실패와 같은 사유로 올린다 - 부르는 쪽이 연결을 닫는다
         data = b"".join(self._wpend)
@@ -692,7 +703,9 @@ class TCPConnector:
             raise ILSessionException(ILRC.MIMQE_BIO_ERROR, "write() failure.", exc) from exc
 
     def _discard_wpend(self) -> None:
-        # rollback 이 부른다 - 쥔 put 은 아직 엔진에 가지 않았으므로 버리면 보낸 뒤 롤백한 것과 같다
+        # _request_const(discard_pending=True) 가 부른다 - 지금은 그렇게 부르는 곳이 없다(rollback 도 쥔 put 을 ROLLBACK 과 함께
+        #   보내 0.10.0 과 같은 롤백 응답을 받는다). 끊기 / 새 접속 때 비우는 것은 _rx_reset 이다
+        #   쥔 put 은 아직 엔진에 가지 않았으므로 버리면 보낸 뒤 롤백한 것과 같다
         self._wpend.clear()
         self._wpend_len = 0
 
@@ -1390,6 +1403,33 @@ class ILRequestHelper:
         report_msg._arrival = getattr(res_msg, "_arrival", 0)
         return report_msg
 
+    def _request_put_and_commit(self) -> ILReportMsg | None:
+        # 0.12.0: 연결이 쥔 것이 put(DATA) 프레임 하나뿐이면 [PUT + COMMIT] 대신 PUT_AND_COMMIT(3403) 하나로 보내고 응답(COMMIT 과
+        #   같은 보고)을 돌려준다. 쥔 것이 없거나 둘 이상 / 태그 계층 / 라이브러리 커넥터가 아님 / 프레임 상한을 넘음 = None - 부르는
+        #   쪽이 COMMIT 을 보낸다(쥔 것은 그 앞에 붙어 나간다). 엔진 판 확인(7.x 리비전 3431 이상)은 부르는 쪽(ILQmgr.commit)이 한다
+        conn = self.conn
+        if type(conn) is not TCPConnector or self._gate is not None:
+            return None
+        with _io_lock_of(conn):
+            put = conn._single_pending_put()
+            if put is None:
+                return None
+            # 확장 = 쥔 put 프레임에서 끝 전송 구분자를 뺀 것 = to_byte_array(False), PUTS 서브메시지와 같은 형식(엔진 확인 2026-09-15).
+            #   엔진은 확장이 DATA 프레임 하나이고 그 길이 칸 값이 확장 바이트 수와 같은지 본다(구분자가 붙으면 거절 + 롤백)
+            frame = ILMsgUtil.create_request_msg_with_ext(ILC.MIMQ_PUT_AND_COMMIT_REQUEST, bytes(put[:-1])).to_byte_array(True)
+            if len(frame) - 1 > conn.max_frame_length:
+                return None
+            conn._discard_wpend()
+            conn.send_bytes(frame)
+            res_msg = _stamp_arrival(conn.recv(self.sessionTimeoutMS), self._arrivals)
+        if ILC.MIMQ_REPORT_MESSAGE != res_msg.getType():
+            raise ILMsgTypeException(
+                res_msg.getType(), " msg type must be [MIMQ_REPORT_MESSAGE]"
+            )
+        report_msg = res_msg.getReportMsg()
+        report_msg._arrival = getattr(res_msg, "_arrival", 0)
+        return report_msg
+
     @contextlib.contextmanager
     def _exclusive(self):
         # 연결을 다시 붙이는 동안 혼자 쓴다. 진행 중인 호출(걸린 롱폴 포함)이 끝나기를 기다리고 새 호출은 그 뒤에 세운다

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/ilink/qmgr.py

@@ -88,6 +88,27 @@ def _engine_in_order(version: str) -> bool:
     return major == 6 and minor == 3 and m.group(3) is not None and int(m.group(3)) >= 3
 
 
+# 0.12.0: 큐 전용 요청 코드(COMMIT_AND_GET 3402 / PUT_AND_COMMIT 3403)를 아는 엔진인가 - 판 줄 major 가 7 이고 리비전(넷째 칸)이
+#   3431 이상(엔진 r3431, 사용자 결정 2026-09-15). 6.3.x / 옛 7.x / 판을 읽지 못함 = 0.11.0 경로(자바 v2.8.0 과 같다)
+#   네 칸 모두 숫자이고 그 뒤는 공백이나 끝이어야 한다(자바 ILQueue.isQueueFastEngine 과 같은 판정)
+_VERSION_FULL = re.compile(r"\s*([0-9]+)\.([0-9]+)\.([0-9]+)\.([0-9]+)(?:\s|$)")
+_QUEUE_FAST_REVISION = 3431
+
+
+@functools.lru_cache(maxsize=16)
+def _engine_qfast(version: str) -> bool:
+    """엔진 판 문자열이 큐 전용 요청 코드(3402 / 3403)를 아는 판인지.
+
+    Args:
+        version (str): :meth:`ILQmgr.get_version` 값(예 ``"7.0.1.3431 jetstream"``).
+
+    Returns:
+        bool: 판 줄 major 가 7 이고 리비전(넷째 칸)이 3431 이상이면 True.
+    """
+    m = _VERSION_FULL.match(version)
+    return m is not None and int(m.group(1)) == 7 and int(m.group(4)) >= _QUEUE_FAST_REVISION
+
+
 class ILQmgr:
     """큐 관리자에 붙어 메시지를 넣고 빼는 **응용 클라이언트**.
 
@@ -608,6 +629,9 @@ class ILQmgr:
             큐 하나가 아니라 **세션 전체**가 단위다. 여러 큐에 걸친 put/get 이
             한 트랜잭션으로 묶여 원자적으로 확정된다.
 
+            엔진 7.x 리비전 3431 이상이고, 아직 보내지 않고 쥐고 있던 트랜잭션 put 이 **하나뿐**이면 put 과 커밋 대신
+            전용 요청 하나(PUT_AND_COMMIT)로 보낸다(0.12.0). 뜻 · 반환값 · 예외는 같다(앞선 작업이 있으면 함께 확정된다).
+
         Example::
 
             qmgr.connect("192.168.0.10", 5000, auto_commit=False)
@@ -618,7 +642,15 @@ class ILQmgr:
         """
         try:
             self.txnPending = False
-            report_msg = self._request_const(_COMMIT)
+            report_msg = None
+            # 0.12.0: 쥔 것이 트랜잭션 put 하나뿐이고 엔진이 PUT_AND_COMMIT 를 알면(7.x 리비전 3431 이상) [PUT + COMMIT] 대신 그
+            #   요청 하나로 보낸다. 뜻과 응답은 put() + commit() 과 같다(앞선 작업이 있으면 함께 커밋된다, 자바 v2.8.0 과 같다)
+            if _engine_qfast(self.get_version() or ""):
+                fast = getattr(self.service, "_request_put_and_commit", None)
+                if fast is not None:
+                    report_msg = fast()
+            if report_msg is None:
+                report_msg = self._request_const(_COMMIT)
             if report_msg is None:
                 raise ILOperationException("MIMQE_INTERNAL_ERROR")
             if report_msg.getCode() != ILC.MIMQ_SUCCESSFUL_COMMIT:
@@ -1627,6 +1659,8 @@ class ILQueue:
         self.isInfiniteWaiting = False
         # 0.11.0 K7: 마지막으로 짠 GET 요청 (대기 시간 문자열, 선택자, 큐 이름, ILMsg, 프레임 바이트)
         self._getCache = None
+        # 0.12.0: 마지막으로 짠 COMMIT_AND_GET 프레임 (대기 시간 문자열, 선택자, 큐 이름, 프레임 바이트)
+        self._cagCache = None
 
         if not existCheck:
             return
@@ -2041,17 +2075,19 @@ class ILQueue:
             ILNoMsgException: 대기 시간(:meth:`set_wait_msg_timeout_ms`, 기본 60초) 안에 메시지가 없을 때.
                 **이때도 커밋은 이미 성공했다.**
             ILOperationException: 커밋이 실패했을 때(:meth:`ILQmgr.commit` 과 같은 예외, 사유는 엔진이 준 값). 이때는
-                커밋 뒤에 보낸 get 이 꺼낸 메시지를 롤백으로 큐에 되돌린 뒤 올린다. 또는 커밋은 성공했는데 get 을
+                롤백을 보내 커밋하려던 작업과 꺼낸 메시지를 큐에 되돌린 뒤 올린다. 또는 커밋은 성공했는데 get 을
                 엔진이 거절했을 때(:meth:`get` 과 같은 예외).
-            ILSessionException: 커밋 요청을 보낸 뒤 커밋 응답을 받기 전에 연결이 끊겼을 때. **커밋 결과를 알 수 없으므로
+            ILSessionException: 커밋 요청을 보낸 뒤 커밋 결과를 받기 전에 연결이 끊겼을 때. **커밋 결과를 알 수 없으므로
                 자동 재접속 / 재시도를 하지 않는다**(:meth:`ILQmgr.commit` 과 같다) - 다시 붙어 트랜잭션을 처음부터 수행한다.
+                전용 요청(아래 Note)이면 커밋 결과가 get 결과와 한 응답으로 오므로 이 구간이 **get 대기 시간까지** 늘어난다.
             ILException: 그 밖의 통신 실패.
 
         Note:
             * 자동 커밋 세션(``auto_commit=True``)이면 커밋 요청 없이 :meth:`get` 과 똑같이 동작한다.
-            * 연달아 보내기는 한 세션의 요청을 받은 순서대로 처리하고 그 순서로 답하는 것이 확인된 엔진(7.x, 6.3.3 이상의
-              6.3.x)에서만 한다. 그 밖의 엔진(5.x 등, 판을 읽지 못한 경우 포함)에서는 커밋 응답을 받은 뒤 get 을 보낸다 -
-              결과는 같고 2 왕복이다. 어느 쪽이든 와이어 형식은 그대로다.
+            * 엔진 7.x 리비전 3431 이상에는 **전용 요청 하나(COMMIT_AND_GET)** 를 보내고 응답도 하나만 받는다(0.12.0 - 엔진이
+              커밋한 뒤 곧바로 get 을 돌린다). 한 세션의 요청을 받은 순서대로 처리하고 그 순서로 답하는 것이 확인된 그 밖의
+              엔진(그보다 앞선 7.x, 6.3.3 이상의 6.3.x)에는 커밋과 get 요청을 연달아 보낸다(와이어 형식은 0.10.0 과 같다). 그 밖의
+              엔진(5.x 등, 판을 읽지 못한 경우 포함)에서는 커밋 응답을 받은 뒤 get 을 보낸다 - 결과는 같고 2 왕복이다.
             * 커밋이 성공한 뒤 get 이 통신 장애로 실패하면 :meth:`get` 과 같이 자동 재접속 후 1회 재시도한다(커밋할 것이
               이제 없다).
             * 무한 대기(``set_wait_msg_timeout_ms(-1)``)면 첫 get 이 비었을 때 :meth:`get` 과 같이 계속 기다린다.
@@ -2088,12 +2124,64 @@ class ILQueue:
             # 순서 처리가 확인되지 않은 엔진 / 커밋과 큐가 다른 연결 / 가짜 커넥터: 커밋 응답을 받은 뒤 get(2 왕복, 뜻은 같다)
             qm.commit()
             return self.get(matchId, option)
+        if _engine_qfast(version):
+            # 0.12.0: 큐 전용 요청 코드를 아는 엔진(7.x, 리비전 3431 이상) - COMMIT_AND_GET 하나를 보내고 응답도 하나를 받는다
+            return self._commit_and_get_code(matchId, option, send_raw)
         return self._commit_and_get_pipelined(matchId, option, send_raw, req[1])
 
     def commitAndGet(self, matchId: str | None = None, option: MatchOption = MatchOption.NONE) -> ILDataMsg:
         """:meth:`commit_and_get` 의 camelCase 별칭."""
         return self.commit_and_get(matchId, option)
 
+    def _commit_and_get_frame(self, matchId: str | None, option: MatchOption) -> bytes:
+        # 0.12.0: COMMIT_AND_GET 프레임. 칸은 GET 과 같고 코드만 다르다 - GET 캐시와 같은 열쇠(대기 시간 / 선택자 / 큐 이름)로 캐시한다
+        ext = ILC.make_selector(matchId, option).encode("utf-8") if matchId else None
+        wait = str(self.waitMsgTimeoutMS)
+        c = self._cagCache
+        if c is not None and c[0] == wait and c[1] == ext and c[2] == self.name:
+            return c[3]
+        frame = ILMsgUtil.create_request_msg_with_ext(
+            ILC.MIMQ_COMMIT_AND_GET_REQUEST, ext, "", self.name, wait
+        ).to_byte_array(True)
+        self._cagCache = (wait, ext, self.name, frame)
+        return frame
+
+    def _commit_and_get_code(self, matchId: str | None, option: MatchOption, send_raw) -> ILDataMsg:
+        # 0.12.0: COMMIT_AND_GET(3402) 하나를 보내고 응답 하나를 읽는다(쥔 put 이 있으면 그 앞에 붙는다). 엔진이 커밋한 뒤 GET 을 돌린다.
+        #   커밋이 실패하면 NOT_SUCCESSFUL_COMMIT 하나만 오고 GET 은 돌지 않았다 - ROLLBACK 을 보내 0.11.0 과 같은 상태로 끝내고 commit() 과
+        #   같은 예외를 낸다. 응답 전에 끊기면 커밋 여부를 모른다 - commit() 처럼 올리고 재시도하지 않는다(모르는 구간이 GET 대기까지
+        #   늘어난다, 자바 v2.8.0 과 같다)
+        qm = self.qmgr
+        conn = self.conn
+        frame = self._commit_and_get_frame(matchId, option)
+        try:
+            with _io_lock_of(conn):
+                qm.txnPending = False
+                qm.set_last_access_time()
+                send_raw(frame)
+                res = conn.recv(self._get_recv_timeout())
+        except _PASSTHROUGH_EXCEPTIONS:
+            raise
+        except Exception as exc:
+            raise ILException(exc) from exc
+        if res.getType() == ILC.MIMQ_REPORT_MESSAGE and res.getReportMsg().getCode() == ILC.MIMQ_NOT_SUCCESSFUL_COMMIT:
+            # 커밋 거절. 엔진은 트랜잭션 오류면 롤백을 마쳤고 클러스터 정지면 트랜잭션을 남긴다 - 0.11.0 과 같은 끝 상태(커밋하려던 작업이
+            #   모두 되돌아감)가 되도록 ROLLBACK 을 보낸다(거절 때만의 왕복 1 번, rollback() 은 예외를 올리지 않는다)
+            qm.rollback()
+            raise ILOperationException(res.getReportMsg().getArg2())
+        # 커밋 확정. 여기부터는 get() 과 같다
+        try:
+            got = self._take_get_reply(res)
+        except _PASSTHROUGH_EXCEPTIONS:
+            raise
+        except Exception as exc:
+            raise ILException(exc) from exc
+        if got is not None:
+            return got
+        if self.isInfiniteWaiting:
+            return self.get(matchId, option)        # 무한 대기 - get() 의 반복을 이어 간다
+        raise ILNoMsgException(qm.get_name(), self.name)
+
     def _commit_and_get_pipelined(self, matchId: str | None, option: MatchOption, send_raw, frame: bytes) -> ILDataMsg:
         # COMMIT + GET 을 sendall 한 번으로 보내고(쥔 put 이 있으면 그 앞에 붙는다) 응답 둘을 차례로 읽는다. 연결 잠금은 교환
         #   전체(실패 때의 ROLLBACK 포함) 동안 쥔다. 기록은 commit() + _get_once() 와 같게 - 보낼 때 txnPending 을 끄고,

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.11.0
+Version: 0.12.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,6 +60,18 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.12.0 변경 - 큐 전용 요청 코드(엔진 7.0.1.3431 이상) 자동 사용 (자바 v2.8.0 과 같음)
+
+- **앱 코드는 바꿀 것이 없습니다.** 엔진 판 줄이 7.x 이고 리비전이 3431 이상이면 클라이언트가 스스로 새 요청 코드를 씁니다.
+  그 밖의 엔진(6.3.x, 그보다 앞선 7.x, 5.x)에는 0.11.0 과 같은 요청을 보냅니다.
+- **`commit_and_get`** 은 커밋 요청과 get 요청 대신 전용 요청 하나(COMMIT_AND_GET, 3402)를 보내고 응답도 하나만 받습니다.
+  엔진이 커밋한 뒤 곧바로 get 을 돌립니다. 결과와 예외는 0.11.0 과 같습니다.
+  - 커밋이 거절되면 get 은 돌지 않았고, 롤백을 보내 커밋하려던 작업과 꺼낸 메시지를 큐에 되돌린 뒤 `ILOperationException` 을 올립니다.
+  - 응답을 받기 전에 연결이 끊기면 커밋 결과를 알 수 없습니다(재접속 / 재시도 없음). 커밋 결과가 get 결과와 한 응답으로 오므로
+    **결과를 알 수 없는 구간이 get 대기 시간까지** 늘어납니다.
+- **`commit()`** 은 쥐고 있던 트랜잭션 put 이 **하나뿐**이면 put 과 커밋 대신 전용 요청 하나(PUT_AND_COMMIT, 3403)로 보냅니다.
+  돌려주는 값과 예외는 같습니다. put 이 둘 이상이거나 `puts`, 64KiB 를 넘는 put, 쥔 것이 없을 때는 0.11.0 과 같습니다.
+
 ## 0.11.0 변경 - 큐 단건 put / get 가속, `commit_and_get` 추가
 
 - **새 API `ILQueue.commit_and_get(matchId=None, option=MatchOption.NONE)`** (camelCase 별칭 `commitAndGet`): 이 세션의

{jetstream_api-0.11.0 → jetstream_api-0.12.0}/pyproject.toml

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