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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.12.0
+Version: 0.13.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,27 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.13.0 변경 - 세션 타임아웃 기본값 30초, acks 값 검사, 수신 기한 수정 (자바 v2.9.0 과 같음)
+
+- **세션 타임아웃 기본값이 경로마다 달라집니다.** 리더가 얼어붙어 응답이 오지 않으면 0.12.0 까지는 최대 10분을 매달렸습니다.
+  - 데이터 경로(`ILQmgr` / 큐 / 토픽): **600000 -> 30000**. 접속 대기 시간도 같은 값이라 페일오버 재접속이 빨라집니다.
+  - 관리 경로(`ILAdminService`): **600000 유지**. 엔진이 큐 관리자 정지 · 삭제 응답을 실제로 내려갈 때까지 붙들고, 토픽을 닫으며
+    파티션마다 fsync 하느라 수 분이 걸릴 수 있습니다.
+  - 큐 `get(wait)` 은 전처럼 알아서 늘어납니다(대기 시간의 2배). 기본 대기 60초면 수신 상한이 120초라 **기본 동작은 그대로입니다**.
+    **무한 대기(`set_wait_msg_timeout_ms(-1)`)도 이제 같이 늘어납니다.** 무한 대기는 엔진에 60초를 주고 루프를 도는 것이라
+    엔진이 쥐는 시간은 유한 대기와 같은데 전에는 예외로 두고 있었습니다. 기본값이 600000 일 때는 드러나지 않던 자리입니다.
+  - 전처럼 오래 기다리려면 `qmgr.set_session_timeout(600000)` 을 부르면 됩니다.
+- **`spokeSwitchTo(key, timeoutSec)`** 는 엔진이 그 시간만큼 응답을 붙들기에, 그 호출 동안만 수신 상한을 `timeoutSec` 의 2배로
+  올리고 되돌립니다.
+- **수신 기한이 소켓 읽기 하나마다 걸립니다.** 프레임 전체의 기한이 아닙니다 - 응답이 조각으로 나뉘어 와도 다음 조각이 그 시간 안에
+  오면 계속 받습니다(자바와 같은 규칙). 느린 회선의 큰 메시지가 파이썬에서만 끊기던 것이 사라집니다.
+  - 기한이 지나면 `MIMQE_WAIT_TIMEOUT` 입니다. 전에는 `MIMQE_INTERNAL_ERROR`("unhandled exception")로 나왔습니다.
+  - 세션 타임아웃 `0` 은 **끝없이 기다립니다**(자바와 같습니다). 전에는 곧바로 기한 초과였습니다.
+- **`ILProducerConfig.acks` 는 0 과 1 만 받습니다.** 그 밖의 값은 `ValueError` 입니다(자바 `IllegalArgumentException` 과 짝).
+  0.12.0 까지는 0 이 아닌 값을 모두 1 로 보정해 `acks=2` 같은 오타가 조용히 통과했습니다.
+- 문서: 클러스터에서 `acks(1)` 은 팔로워 확인(HW)까지라는 것(= Kafka `acks=all`), 파티션이 많은 토픽에서는 그 대기가 봉투 안
+  파티션마다 겹쳐 `requestTimeoutMs` 가 먼저 끝날 수 있다는 것, `removeSession` 이 반쯤 열린 연결을 푸는 수단이라는 것을 적었습니다.
+
 ## 0.12.0 변경 - 큐 전용 요청 코드(엔진 7.0.1.3431 이상) 자동 사용 (자바 v2.8.0 과 같음)
 
 - **앱 코드는 바꿀 것이 없습니다.** 엔진 판 줄이 7.x 이고 리비전이 3431 이상이면 클라이언트가 스스로 새 요청 코드를 씁니다.

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

@@ -10,6 +10,27 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.13.0 변경 - 세션 타임아웃 기본값 30초, acks 값 검사, 수신 기한 수정 (자바 v2.9.0 과 같음)
+
+- **세션 타임아웃 기본값이 경로마다 달라집니다.** 리더가 얼어붙어 응답이 오지 않으면 0.12.0 까지는 최대 10분을 매달렸습니다.
+  - 데이터 경로(`ILQmgr` / 큐 / 토픽): **600000 -> 30000**. 접속 대기 시간도 같은 값이라 페일오버 재접속이 빨라집니다.
+  - 관리 경로(`ILAdminService`): **600000 유지**. 엔진이 큐 관리자 정지 · 삭제 응답을 실제로 내려갈 때까지 붙들고, 토픽을 닫으며
+    파티션마다 fsync 하느라 수 분이 걸릴 수 있습니다.
+  - 큐 `get(wait)` 은 전처럼 알아서 늘어납니다(대기 시간의 2배). 기본 대기 60초면 수신 상한이 120초라 **기본 동작은 그대로입니다**.
+    **무한 대기(`set_wait_msg_timeout_ms(-1)`)도 이제 같이 늘어납니다.** 무한 대기는 엔진에 60초를 주고 루프를 도는 것이라
+    엔진이 쥐는 시간은 유한 대기와 같은데 전에는 예외로 두고 있었습니다. 기본값이 600000 일 때는 드러나지 않던 자리입니다.
+  - 전처럼 오래 기다리려면 `qmgr.set_session_timeout(600000)` 을 부르면 됩니다.
+- **`spokeSwitchTo(key, timeoutSec)`** 는 엔진이 그 시간만큼 응답을 붙들기에, 그 호출 동안만 수신 상한을 `timeoutSec` 의 2배로
+  올리고 되돌립니다.
+- **수신 기한이 소켓 읽기 하나마다 걸립니다.** 프레임 전체의 기한이 아닙니다 - 응답이 조각으로 나뉘어 와도 다음 조각이 그 시간 안에
+  오면 계속 받습니다(자바와 같은 규칙). 느린 회선의 큰 메시지가 파이썬에서만 끊기던 것이 사라집니다.
+  - 기한이 지나면 `MIMQE_WAIT_TIMEOUT` 입니다. 전에는 `MIMQE_INTERNAL_ERROR`("unhandled exception")로 나왔습니다.
+  - 세션 타임아웃 `0` 은 **끝없이 기다립니다**(자바와 같습니다). 전에는 곧바로 기한 초과였습니다.
+- **`ILProducerConfig.acks` 는 0 과 1 만 받습니다.** 그 밖의 값은 `ValueError` 입니다(자바 `IllegalArgumentException` 과 짝).
+  0.12.0 까지는 0 이 아닌 값을 모두 1 로 보정해 `acks=2` 같은 오타가 조용히 통과했습니다.
+- 문서: 클러스터에서 `acks(1)` 은 팔로워 확인(HW)까지라는 것(= Kafka `acks=all`), 파티션이 많은 토픽에서는 그 대기가 봉투 안
+  파티션마다 겹쳐 `requestTimeoutMs` 가 먼저 끝날 수 있다는 것, `removeSession` 이 반쯤 열린 연결을 푸는 수단이라는 것을 적었습니다.
+
 ## 0.12.0 변경 - 큐 전용 요청 코드(엔진 7.0.1.3431 이상) 자동 사용 (자바 v2.8.0 과 같음)
 
 - **앱 코드는 바꿀 것이 없습니다.** 엔진 판 줄이 7.x 이고 리비전이 3431 이상이면 클라이언트가 스스로 새 요청 코드를 씁니다.

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

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