jetstream-api 0.7.0__tar.gz → 0.7.1__tar.gz

{jetstream_api-0.7.0 → jetstream_api-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.7.0
+Version: 0.7.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
@@ -54,6 +54,17 @@ Python으로 작성된 ILink 클라이언트 API입니다.
 ## 설치 방법
 pip install jetstream-api
 
+## 0.7.1 변경 - producer 기본값: 멱등 켜짐, batchSize 16384 (자바 v2.3.1 과 같음)
+
+- `enableIdempotence` 기본값이 **켜짐**입니다. 멱등을 직접 정하지 않았으면 `acks(0)` 이나 `maxInFlight` 가 5 를 넘을 때
+  멱등이 저절로 꺼집니다. `enableIdempotence(True)` 를 명시하고 그 둘과 함께 쓰면 전처럼 생성 때 `ValueError` 입니다.
+- 멱등이면 토픽을 비우거나(FLUSH) epoch 가 바뀐 순간 걸려 있던 배치를 다시 보내지 않고 실패로 올립니다
+  (`MIMQE_TOPIC_FLUSHED` / `MIMQE_TOPIC_EPOCH_MISMATCH`). 0.7.0 기본처럼 조용히 다시 보내려면 `enableIdempotence(False)` 를
+  명시하십시오.
+- `batchSize` 기본값이 **16384** 입니다(파티션 배치 하나의 상한). 0.7.0 은 262144 였습니다 - 처리량이 모자라면
+  `batchSize(262144)` 처럼 늘리십시오.
+- producer 수 안내: 한 토픽의 producer(연결)는 1~4개면 충분합니다(엔진 7.0.1.3407 실측).
+
 ## 0.7.0 변경 - 발행 v2: producer 하나 = 토픽 하나, 파티션별 배치, 봉투 겹쳐 보내기 (엔진 v2 필요)
 
 발행 경로를 엔진의 새 발행 형식(v2)으로 바꿨습니다. **엔진도 v2 판이어야 합니다** - 옛 엔진에는 발행이 되지 않고
@@ -61,7 +72,8 @@ pip install jetstream-api
 
 - **producer 하나 = 토픽 하나 = 연결 하나.** `qmgr.create_producer("ORDER.EVENT", config)` 로 만듭니다. 생성할 때 토픽의
   파티션 수를 받아 두므로 없는 토픽이면 생성 단계에서 `MIMQE_OBJECT_NOT_FOUND` 로 실패합니다. 토픽이 여러 개면 토픽마다
-  producer 를 만들고, 연결이 더 필요하면 producer 를 더 만듭니다(예: 발행 스레드마다 하나).
+  producer 를 만듭니다. 한 토픽의 producer(연결)는 1~4개면 충분합니다 - 엔진 7.0.1.3407 실측에서 8개로 늘리면 어느 크기든
+  오히려 줄었습니다. 큰 레코드(1KB 급)는 1개로도 디스크가 먼저 한계에 닿고, 작은 레코드(100B 급)는 4개 근처가 최대입니다.
 - 레코드 토픽이 producer 토픽과 다르면 `send()` 가 `MIMQE_INVALID_ARGUMENT` 로 거부합니다.
 - 옛 `create_producer(config)` / `ILTopicProducer(host, port, name, config)` 모양으로 부르면 `TypeError` 가 납니다.
 - 배치는 **파티션마다** 모입니다. `batchSize`(기본 **262144**, 자바와 같음)는 파티션 배치 하나의 상한입니다. 보낼 때는

{jetstream_api-0.7.0 → jetstream_api-0.7.1}/README.md

@@ -8,6 +8,17 @@ Python으로 작성된 ILink 클라이언트 API입니다.
 ## 설치 방법
 pip install jetstream-api
 
+## 0.7.1 변경 - producer 기본값: 멱등 켜짐, batchSize 16384 (자바 v2.3.1 과 같음)
+
+- `enableIdempotence` 기본값이 **켜짐**입니다. 멱등을 직접 정하지 않았으면 `acks(0)` 이나 `maxInFlight` 가 5 를 넘을 때
+  멱등이 저절로 꺼집니다. `enableIdempotence(True)` 를 명시하고 그 둘과 함께 쓰면 전처럼 생성 때 `ValueError` 입니다.
+- 멱등이면 토픽을 비우거나(FLUSH) epoch 가 바뀐 순간 걸려 있던 배치를 다시 보내지 않고 실패로 올립니다
+  (`MIMQE_TOPIC_FLUSHED` / `MIMQE_TOPIC_EPOCH_MISMATCH`). 0.7.0 기본처럼 조용히 다시 보내려면 `enableIdempotence(False)` 를
+  명시하십시오.
+- `batchSize` 기본값이 **16384** 입니다(파티션 배치 하나의 상한). 0.7.0 은 262144 였습니다 - 처리량이 모자라면
+  `batchSize(262144)` 처럼 늘리십시오.
+- producer 수 안내: 한 토픽의 producer(연결)는 1~4개면 충분합니다(엔진 7.0.1.3407 실측).
+
 ## 0.7.0 변경 - 발행 v2: producer 하나 = 토픽 하나, 파티션별 배치, 봉투 겹쳐 보내기 (엔진 v2 필요)
 
 발행 경로를 엔진의 새 발행 형식(v2)으로 바꿨습니다. **엔진도 v2 판이어야 합니다** - 옛 엔진에는 발행이 되지 않고
@@ -15,7 +26,8 @@ pip install jetstream-api
 
 - **producer 하나 = 토픽 하나 = 연결 하나.** `qmgr.create_producer("ORDER.EVENT", config)` 로 만듭니다. 생성할 때 토픽의
   파티션 수를 받아 두므로 없는 토픽이면 생성 단계에서 `MIMQE_OBJECT_NOT_FOUND` 로 실패합니다. 토픽이 여러 개면 토픽마다
-  producer 를 만들고, 연결이 더 필요하면 producer 를 더 만듭니다(예: 발행 스레드마다 하나).
+  producer 를 만듭니다. 한 토픽의 producer(연결)는 1~4개면 충분합니다 - 엔진 7.0.1.3407 실측에서 8개로 늘리면 어느 크기든
+  오히려 줄었습니다. 큰 레코드(1KB 급)는 1개로도 디스크가 먼저 한계에 닿고, 작은 레코드(100B 급)는 4개 근처가 최대입니다.
 - 레코드 토픽이 producer 토픽과 다르면 `send()` 가 `MIMQE_INVALID_ARGUMENT` 로 거부합니다.
 - 옛 `create_producer(config)` / `ILTopicProducer(host, port, name, config)` 모양으로 부르면 `TypeError` 가 납니다.
 - 배치는 **파티션마다** 모입니다. `batchSize`(기본 **262144**, 자바와 같음)는 파티션 배치 하나의 상한입니다. 보낼 때는

{jetstream_api-0.7.0 → jetstream_api-0.7.1}/ilink/__init__.py

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

{jetstream_api-0.7.0 → jetstream_api-0.7.1}/ilink/producer.py

@@ -58,8 +58,9 @@ class ILProducerConfig:
         self._acks = 1
         #: 배치를 모으는 시간(ms). 0 이면 모이는 대로 즉시 보낸다
         self._lingerMs = 0
-        #: 파티션 배치 하나의 크기 상한(바이트). 0.7.0 부터 자바와 같은 262144(사용자 결정)
-        self._batchSize = 262144
+        # 0.7.1: Kafka batch.size 와 같은 16384(사용자 결정 2026-09-13). 0.7.0 은 262144 였다
+        #: 파티션 배치 하나의 크기 상한(바이트). 기본 16384
+        self._batchSize = 16384
         #: 동시에 ACK 를 기다릴 봉투 수 상한
         self._maxInFlight = 5
         #: 연결 실패 시 재시도 횟수
@@ -78,14 +79,20 @@ class ILProducerConfig:
         self._maxRequestSize = 1048576
         #: 접속한 큐관리자가 받는 프레임 길이 상한(바이트) - 엔진 Runtime@MaxFrameLength 기본 128MiB
         self._maxFrameLength = ILC.MIMQ_DEFAULT_MAX_FRAME_LENGTH
-        #: 멱등 발행(PID 발급 + 시퀀스). 재전송 시 중복 적재를 막는다
-        self._enableIdempotence = False
+        # 0.7.1: Kafka 3.x 와 같은 기본 켜짐(사용자 결정 2026-09-13)
+        #: 멱등 발행(PID 발급 + 시퀀스). 재전송 시 중복 적재를 막는다. 기본 켜짐
+        self._enableIdempotence = True
+        #: 멱등을 사용자가 정했는지. 정하지 않았으면 acks=0 이나 maxInFlight > 5 에서 저절로 꺼진다
+        self._idempotenceSet = False
 
     def __setattr__(self, name: str, value) -> None:
         # 구버전 호환: cfg.acks = 0 / cfg.lingerMs = 5 같은 직접 대입을 내부 슬롯으로 돌린다.
         # (예전 이름 idempotent 도 함께 받아 준다)
         if name == "idempotent":
             name = "enableIdempotence"
+        if name == "enableIdempotence":
+            # 직접 대입도 사용자가 정한 것이다 - 기본 멱등의 저절로 끄기를 적용하지 않는다
+            object.__setattr__(self, "_idempotenceSet", True)
         if name in self._OPTIONS:
             name = "_" + name
         object.__setattr__(self, name, value)
@@ -104,7 +111,8 @@ class ILProducerConfig:
             ILProducerConfig: 체이닝을 위해 자기 자신.
 
         Note:
-            ``acks=0`` 은 멱등 발행과 함께 쓸 수 없다 (:meth:`validate` 가 거부).
+            멱등(기본 켜짐)을 정하지 않았으면 ``acks=0`` 은 멱등을 끈다. ``enableIdempotence(True)`` 를
+            명시하고 ``acks=0`` 이면 :meth:`validate` 가 거부한다.
         """
         self._acks = 0 if n == 0 else 1; return self
 
@@ -127,7 +135,7 @@ class ILProducerConfig:
         self._lingerMs = max(0, n); return self
 
     def batchSize(self, n: int) -> "ILProducerConfig":
-        """파티션 배치 하나의 크기 상한(바이트)을 정한다. (기본 262144 = 256KB)
+        """파티션 배치 하나의 크기 상한(바이트)을 정한다. (기본 16384 = 16KB)
 
         Args:
             n (int): 상한(**바이트**). 배치는 파티션마다 따로 모인다. 레코드를 붙이면 이 값을
@@ -137,7 +145,7 @@ class ILProducerConfig:
             ILProducerConfig: 체이닝을 위해 자기 자신.
 
         Note:
-            뜻과 기본값이 Java 클라이언트와 같다(0.7.0).
+            뜻과 기본값이 Java 클라이언트와 같다(0.7.1 부터 16384. 0.7.0 은 262144 였다 - 처리량이 모자라면 늘린다).
             ``lingerMs`` 가 0 이면 자르는 크기로만 쓰이고(배치는 보낼 수 있게 되는 즉시 나간다),
             ``lingerMs`` 가 0 보다 크면 전송 조건도 된다(이만큼 차거나 lingerMs 가 지나면 보낸다).
             레코드 하나가 이 값보다 크면 그 레코드 혼자 배치 하나가 된다. 보낼 때는 준비된
@@ -156,9 +164,9 @@ class ILProducerConfig:
 
         Note:
             I/O 스레드가 봉투를 이만큼 겹쳐 보낸다(0.7.0). 엔진은 한 연결의 봉투를 겹쳐
-            처리하고 응답은 요청 순서대로 온다. **enableIdempotence 를 켜면 5 이하여야 한다** -
-            엔진이 파티션마다 최근 배치 5개로 중복을 가리기 때문이다(넘으면 :meth:`validate` 가
-            ``ValueError``).
+            처리하고 응답은 요청 순서대로 온다. **멱등(기본 켜짐)은 5 이하에서만 쓰인다** -
+            엔진이 파티션마다 최근 배치 5개로 중복을 가리기 때문이다. 멱등을 정하지 않았으면 5 를 넘길 때
+            멱등이 꺼지고, ``enableIdempotence(True)`` 를 명시했으면 :meth:`validate` 가 ``ValueError``.
         """
         self._maxInFlight = max(1, n); return self
 
@@ -310,23 +318,33 @@ class ILProducerConfig:
         return self
 
     def enableIdempotence(self, b: bool) -> "ILProducerConfig":
-        """멱등 발행(중복 제거)을 켠다. (기본 False)
+        """멱등 발행(중복 제거)을 켜거나 끈다. (기본 켜짐 - 0.7.1)
 
         켜면 접속 시 서버에서 PID 를 발급받아 파티션 배치마다 (PID, baseSeq) 를 실어 보낸다.
         재시도로 같은 배치가 두 번 도착해도 서버가 시퀀스로 걸러 **한 번만 적재한다.**
         ``maxInFlight`` 는 5 이하여야 한다.
 
+        이 메서드로 정하지 않으면 ``acks=0`` 이거나 ``maxInFlight`` 가 5 를 넘을 때 멱등이 저절로 꺼진다.
+        명시적으로 켜고 그 둘과 함께 쓰면 :meth:`validate` 가 거부한다.
+
+        멱등이면 토픽 FLUSH / epoch 변경으로 거절된 배치(``MIMQE_TOPIC_FLUSHED`` /
+        ``MIMQE_TOPIC_EPOCH_MISMATCH``)를 다시 보내지 않고 실패로 올린다 - 엔진이 그 토픽의 번호 상태를
+        새로 잡으므로 다시 보낸 배치가 중복으로 가려져 사라질 수 있기 때문이다. 비멱등(False)은 메타데이터를
+        다시 받고 조용히 다시 보낸다.
+
         Args:
-            b (bool): True 면 멱등 발행.
+            b (bool): True 면 멱등 발행, False 면 비멱등.
 
         Returns:
             ILProducerConfig: 체이닝을 위해 자기 자신.
 
         Raises:
-            ValueError: (:meth:`validate` 시점) ``acks=0`` 과 함께 켰을 때.
+            ValueError: (:meth:`validate` 시점) 명시적으로 켜고 ``acks=0`` 이나 ``maxInFlight`` > 5 와 함께 썼을 때.
                 응답을 받지 않는 모드에서는 중복 제거가 성립하지 않는다.
         """
-        self._enableIdempotence = bool(b); return self
+        self._enableIdempotence = bool(b)
+        self._idempotenceSet = True
+        return self
 
     # ── 빌더 (snake 별칭) ───────────────────────────────────────────────
     #    Java 이름 빌더와 동작이 같다. 상세 설명은 각 원본 메서드를 참조.
@@ -404,18 +422,18 @@ class ILProducerConfig:
         return self._lingerMs
 
     def get_batch_size(self) -> int:
-        """한 봉투 누적 한도(바이트). 기본 16384.
+        """파티션 배치 하나의 크기 상한(바이트). 기본 16384.
 
         Returns:
-            int: 한 봉투 누적 한도(바이트). 기본 16384.
+            int: 파티션 배치 하나의 크기 상한(바이트). 기본 16384.
         """
         return self._batchSize
 
     def get_max_in_flight(self) -> int:
-        """동시 in-flight 배치 상한. 기본 5 (파이썬 구현은 실제로 항상 1).
+        """응답을 기다리는 봉투 수의 상한. 기본 5.
 
         Returns:
-            int: 동시 in-flight 배치 상한. 기본 5 (파이썬 구현은 실제로 항상 1).
+            int: 응답을 기다리는 봉투 수의 상한. 기본 5.
         """
         return self._maxInFlight
 
@@ -484,12 +502,15 @@ class ILProducerConfig:
         return self._maxFrameLength
 
     def is_idempotence_enabled(self) -> bool:
-        """멱등 발행이 켜져 있는지. 기본 False.
+        """실제로 쓰일 멱등 발행 여부. 기본 True.
 
         Returns:
-            bool: 멱등 발행이 켜져 있는지. 기본 False.
+            bool: 멱등 발행 여부. 정하지 않았으면 기본(True)이되, ``acks=0`` 이거나 ``maxInFlight`` 가
+            5 를 넘으면 False 다.
         """
-        return self._enableIdempotence
+        if self._idempotenceSet:
+            return self._enableIdempotence
+        return self._acks != 0 and self._maxInFlight <= 5
 
     getAcks = get_acks
     getLingerMs = get_linger_ms
@@ -507,12 +528,13 @@ class ILProducerConfig:
 
     def validate(self) -> None:
         """조합 검증. producer 생성 시 호출된다."""
-        if self._enableIdempotence and self._acks == 0:
+        # 0.7.1: 명시적으로 켰을 때만 막는다. 정하지 않은 기본 멱등은 is_idempotence_enabled() 에서 저절로 꺼진다
+        if self._idempotenceSet and self._enableIdempotence and self._acks == 0:
             raise ValueError(
                 "enableIdempotence requires acks=1"
             )
         # 0.7.0: 엔진은 (pid, 파티션)마다 최근 배치 5개로 중복을 가린다 - 그보다 많이 겹쳐 보내면 재전송이 중복으로 가려지지 않는다
-        if self._enableIdempotence and self._maxInFlight > 5:
+        if self._idempotenceSet and self._enableIdempotence and self._maxInFlight > 5:
             raise ValueError(
                 "enableIdempotence requires maxInFlight <= 5 (the engine remembers the last 5 batches"
                 " per partition; Kafka has the same limit)"
@@ -1001,8 +1023,9 @@ class ILTopicProducer:
     """토픽 하나에 묶인 발행자. ``ILQmgr.create_producer(topic, config)`` 로 얻는다. (0.7.0 발행 v2)
 
     producer 하나 = 토픽 하나 = 전용 연결 하나(clientName + ``"-PRD"``) + I/O 스레드 하나다. 생성할 때
-    연결을 열고 토픽의 파티션 수·epoch·세그먼트 크기를 받아 둔다. 연결이 여러 개 필요하면 producer 를
-    여러 개 만든다(예: 발행 스레드마다 하나).
+    연결을 열고 토픽의 파티션 수·epoch·세그먼트 크기를 받아 둔다. 한 토픽의 producer(연결)는 1~4개면
+    충분하다 - 엔진 7.0.1.3407 실측에서 8개로 늘리면 어느 크기든 오히려 줄었다. 큰 레코드(1KB 급)는 1개로도
+    디스크가 먼저 한계에 닿고, 작은 레코드(100B 급)는 4개 근처가 최대다.
 
     보장:
 
@@ -1041,8 +1064,8 @@ class ILTopicProducer:
         Raises:
             TypeError: ``topic`` 이 토픽 이름(str)이 아닐 때 - 0.6.x 의
                 ``ILTopicProducer(host, port, name, config)`` 모양으로 부르면 여기서 멈춘다.
-            ValueError: ``topic`` 이 비었거나 ``config`` 조합이 잘못됐을 때(멱등 + ``acks=0``,
-                멱등 + ``maxInFlight`` > 5).
+            ValueError: ``topic`` 이 비었거나 ``config`` 조합이 잘못됐을 때(명시적으로 켠 멱등 + ``acks=0``,
+                명시적으로 켠 멱등 + ``maxInFlight`` > 5).
             ILOperationException: 주소 목록이 비었거나, 접속·토픽 조회를 거절당했을 때
                 (없는 토픽이면 ``MIMQE_OBJECT_NOT_FOUND``).
             ILException: 후보 주소 어디에도 접속하지 못했을 때.

{jetstream_api-0.7.0 → jetstream_api-0.7.1}/ilink/qmgr.py

@@ -1139,7 +1139,7 @@ class ILQmgr:
         Args:
             topic (str): 발행할 토픽 이름. 이 producer 는 이 토픽에만 발행한다.
             config (ILProducerConfig | None): 발행 설정. 기본 None 이면 전 항목
-                기본값(acks=1 / linger 0 / batch 256KB / maxInFlight 5 / 멱등 꺼짐).
+                기본값(acks=1 / linger 0 / batch 16KB / maxInFlight 5 / 멱등 켜짐).
 
         Returns:
             ILTopicProducer: 발행자. 다 쓰면 ``close()`` 로 닫는다.
@@ -1149,13 +1149,16 @@ class ILQmgr:
                 부르면 여기서 멈춘다.
             ILOperationException: 아직 :meth:`connect` 하지 않았을 때, 없는 토픽일 때
                 (``MIMQE_OBJECT_NOT_FOUND``).
-            ValueError: ``config`` 조합이 잘못됐을 때(멱등 + ``acks=0``, 멱등 + ``maxInFlight`` > 5).
+            ValueError: ``config`` 조합이 잘못됐을 때(명시적으로 켠 멱등 + ``acks=0``, 명시적으로 켠 멱등 +
+                ``maxInFlight`` > 5).
             ILException: 발행 전용 연결을 맺지 못했을 때.
 
         Note:
             발행자는 **전용 연결**을 하나 연다(클라이언트 이름 뒤에 ``"-PRD"`` 가 붙는다). 생성할 때 토픽의
             파티션 수를 받아 두고, I/O 스레드가 봉투를 겹쳐 보낸다. 토픽이 여러 개면 토픽마다 producer 를
-            만들고, 연결이 더 필요하면 producer 를 더 만든다(예: 발행 스레드마다 하나).
+            만든다. 한 토픽의 producer 는 1~4개면 충분하다 - 엔진 7.0.1.3407 실측에서 8개로 늘리면 어느 크기든
+            오히려 줄었다. 큰 레코드(1KB 급)는 1개로도 디스크가 먼저 한계에 닿고, 작은 레코드(100B 급)는 4개
+            근처가 최대다.
 
         Example::
 

{jetstream_api-0.7.0 → jetstream_api-0.7.1}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.7.0
+Version: 0.7.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
@@ -54,6 +54,17 @@ Python으로 작성된 ILink 클라이언트 API입니다.
 ## 설치 방법
 pip install jetstream-api
 
+## 0.7.1 변경 - producer 기본값: 멱등 켜짐, batchSize 16384 (자바 v2.3.1 과 같음)
+
+- `enableIdempotence` 기본값이 **켜짐**입니다. 멱등을 직접 정하지 않았으면 `acks(0)` 이나 `maxInFlight` 가 5 를 넘을 때
+  멱등이 저절로 꺼집니다. `enableIdempotence(True)` 를 명시하고 그 둘과 함께 쓰면 전처럼 생성 때 `ValueError` 입니다.
+- 멱등이면 토픽을 비우거나(FLUSH) epoch 가 바뀐 순간 걸려 있던 배치를 다시 보내지 않고 실패로 올립니다
+  (`MIMQE_TOPIC_FLUSHED` / `MIMQE_TOPIC_EPOCH_MISMATCH`). 0.7.0 기본처럼 조용히 다시 보내려면 `enableIdempotence(False)` 를
+  명시하십시오.
+- `batchSize` 기본값이 **16384** 입니다(파티션 배치 하나의 상한). 0.7.0 은 262144 였습니다 - 처리량이 모자라면
+  `batchSize(262144)` 처럼 늘리십시오.
+- producer 수 안내: 한 토픽의 producer(연결)는 1~4개면 충분합니다(엔진 7.0.1.3407 실측).
+
 ## 0.7.0 변경 - 발행 v2: producer 하나 = 토픽 하나, 파티션별 배치, 봉투 겹쳐 보내기 (엔진 v2 필요)
 
 발행 경로를 엔진의 새 발행 형식(v2)으로 바꿨습니다. **엔진도 v2 판이어야 합니다** - 옛 엔진에는 발행이 되지 않고
@@ -61,7 +72,8 @@ pip install jetstream-api
 
 - **producer 하나 = 토픽 하나 = 연결 하나.** `qmgr.create_producer("ORDER.EVENT", config)` 로 만듭니다. 생성할 때 토픽의
   파티션 수를 받아 두므로 없는 토픽이면 생성 단계에서 `MIMQE_OBJECT_NOT_FOUND` 로 실패합니다. 토픽이 여러 개면 토픽마다
-  producer 를 만들고, 연결이 더 필요하면 producer 를 더 만듭니다(예: 발행 스레드마다 하나).
+  producer 를 만듭니다. 한 토픽의 producer(연결)는 1~4개면 충분합니다 - 엔진 7.0.1.3407 실측에서 8개로 늘리면 어느 크기든
+  오히려 줄었습니다. 큰 레코드(1KB 급)는 1개로도 디스크가 먼저 한계에 닿고, 작은 레코드(100B 급)는 4개 근처가 최대입니다.
 - 레코드 토픽이 producer 토픽과 다르면 `send()` 가 `MIMQE_INVALID_ARGUMENT` 로 거부합니다.
 - 옛 `create_producer(config)` / `ILTopicProducer(host, port, name, config)` 모양으로 부르면 `TypeError` 가 납니다.
 - 배치는 **파티션마다** 모입니다. `batchSize`(기본 **262144**, 자바와 같음)는 파티션 배치 하나의 상한입니다. 보낼 때는

{jetstream_api-0.7.0 → jetstream_api-0.7.1}/pyproject.toml

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