jetstream-api 0.14.0__tar.gz → 0.16.0__tar.gz

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.14.0
+Version: 0.16.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,67 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.16.0 변경 - 세그먼트 이름을 토픽과 같은 형식으로, 오타 대입 거부 (자바 v2.12.0 과 같음)
+
+- **이름 규칙이 정해졌습니다 - 개수는 맨 복수형, 목록은 `...List` 접미.** 토픽이 `partitions` 를 쓰는 형식 그대로입니다.
+  0.15.0 이 하루 쓴 이름 둘을 여기로 옮깁니다.
+
+  | 자리 | 0.15.0 | **0.16.0** |
+  |---|---|---|
+  | 세그먼트 **개수** (`ILQueueProperty`) | `numberOfSegment` | **`segments`** |
+  | 세그먼트 **목록** (`ILQueueRealTimeInfo`) | `segments` | **`segmentInfoList`** |
+
+  - ★ **0.15.0 의 두 이름은 남기지 않고 지웠습니다.** 남기면 개수에 이름이 셋이 되고, 더 나쁘게는 `segments` 가
+    클래스마다 다른 뜻(개수 vs 목록)이 됩니다. 0.15.0 은 하루짜리였고, 아래 가드 덕분에 **지운 것이 조용하지 않습니다.**
+  - **`numberOfPartition` 과 `partitions` 는 그대로 있습니다.** 예전부터 쓰던 이름이라 영구 별칭으로 남습니다.
+  - 큐에 진짜 분산 파티션이 생기면 그 수는 **토픽과 같은 이름(`partitions`)** 으로 따로 들어옵니다. 지금 있는 이름을
+    그쪽으로 돌리지 않습니다 - **재사용은 제거보다 나쁩니다.** 제거는 그 자리에서 터지지만 재사용은 조용히 다른 값을 줍니다.
+- **속성 객체가 모르는 필드 이름 대입을 거부합니다.** 지금까지는 `prop.numberOfSegmnet = 4` 같은 오타가 **예외도 없이**
+  쓰레기 속성을 만들고 실제 값은 그대로였습니다 - 읽기는 원래 `AttributeError` 였는데 **쓰기만 침묵**해서 옛 값이 그대로
+  서버로 나갔습니다.
+  - 이름이 바뀐 필드는 **무엇으로 바뀌었는지까지** 알려 줍니다:
+    `AttributeError: ILQueueProperty has no attribute numberOfSegment - 0.16.0 에서 segments 로 바뀌었다`
+  - 정말 임의 속성을 얹어야 하면 `object.__setattr__(obj, name, value)` 로 우회할 수 있습니다. 그 값은 **와이어에 실리지
+    않습니다.**
+  - 생성자가 도는 동안은 열려 있습니다(필드를 만들어야 하므로). 상속해 쓰는 응용도 `super().__init__()` 뒤에 자기 필드를
+    만들 수 있습니다.
+- **와이어는 달라지지 않습니다.** 0.15.0 과 바이트가 같습니다(큐 속성 2200 · 구엔진 4096 · 실시간정보). 이 판도 엔진 판을 가리지 않습니다.
+
+## 0.15.0 변경 - 큐의 "파티션" 이 "세그먼트" 가 됩니다 (자바 v2.11.0 과 같음)
+
+- **`ILQueueProperty.numberOfPartition` 이 `numberOfSegment` 로 바뀝니다.** 값도 자리도 그대로이고 **이름만** 바뀝니다.
+  - **옛 이름은 그대로 돕니다.** `numberOfPartition` 은 같은 값을 가리키는 별칭으로 남습니다 - 읽기도 쓰기도 되고,
+    `getNumberOfPartition()` / `setNumberOfPartition()` 도 전처럼 동작합니다. **고치지 않아도 되는 변경입니다.**
+  - `__str__` 라벨이 `NUM-PARTITION` 에서 `NUM-SEGMENT` 로 바뀝니다. 이 출력을 정규식으로 읽는 곳이 있으면 그곳만 봐 주세요.
+- **왜 바꾸는지**: 같은 "파티션" 이라는 말이 토픽과 큐에서 **정반대** 를 뜻하고 있었습니다.
+
+  | 말 | 뜻 |
+  |---|---|
+  | 파티션 | **분산 처리 단위** (토픽. 리더 · 팔로워가 붙는다) |
+  | 세그먼트 | **한 노드 안의 저장 칸** (큐. 파일 1~N, 메모리, 공유메모리) |
+
+  토픽의 `PARTITIONS` 와 큐의 `PARTITION` 이 한 글자 차이로 서로 다른 개념이었습니다. 엔진이 큐에 진짜 분산 파티션을
+  들이기 전에 옛 이름을 비워 두는 것입니다.
+- **와이어는 달라지지 않습니다.** 큐 속성 직렬화는 위치 기반 고정폭이라 **속성 이름이 실리지 않습니다.** 어느 이름으로
+  넣든 나가는 2200바이트(구엔진용 4096 레이아웃도)가 같습니다. 그래서 이 판은 **엔진 판을 가리지 않습니다.**
+- **엔진 쪽 이름도 같이 바뀝니다**(ilsc `PARTITION(n)` -> `SEGMENT(n)`, `VIEW QUEUE` 머리글, 컨피그 XML
+  `Storage/@NumberOfPartition` -> `@NumberOfSegment`). 엔진도 옛 이름을 계속 받습니다.
+  - ★ **ilsc 에서 `SEGMENT` 를 쓰려면 엔진도 같이 올려야 합니다.** 클라이언트만 올린 환경에서는 엔진이 그 키워드를
+    모릅니다 - 그때도 큐는 정상 동작하고, ilsc 에서 `PARTITION` 을 쓰면 됩니다.
+- **큐 실시간 정보의 "파티션" 목록도 같이 바뀝니다.** `getQueueRealTimeInfo()` 가 돌려주는
+  `ILQueueRealTimeInfo` 의 `partitions` 가 **`segments`** 가 되고, 항목 클래스 `PartitionItem` 은 **`SegmentItem`** 이 됩니다.
+  - 여기도 **옛 이름이 그대로 돕니다.** `partitions` 는 같은 목록을 가리키는 별칭이고(`getPartitions()` / `setPartitions()` 포함),
+    `PartitionItem` 은 `SegmentItem` 과 **같은 클래스 객체**라 `isinstance` 도 전처럼 통합니다.
+  - ★ **토픽의 `getPartitions()` 와는 뜻이 다릅니다.** 지금까지 두 클래스에서 **같은 이름이 정반대**를 뜻하고 있었습니다 -
+    토픽 쪽은 분산 처리 단위, 큐 실시간 정보 쪽은 한 노드 안의 저장 칸입니다. 이번 개명의 목적이 바로 이것입니다.
+  - `__str__` 머리글이 `Partitions ---` 에서 `Segments ---` 로 바뀝니다(엔진 `VIEW QUEUE` 가 `SEGMENTS(` 로 나가는 것과 맞춥니다).
+  - `ILC.MIMQ_VO_SEGMENT_ITEM_LEN` 이 생기고 `ILC.MIMQ_VO_PARTITION_ITEM_LEN` 은 같은 값(128)의 별칭으로 남습니다.
+- **자바 클라이언트는 클래스 이름을 바꾸지 않습니다**(`PartitionItem` 유지, `getSegments()` 추가). 자바는 제네릭이 불변이라
+  `ArrayList<PartitionItem>` 을 별칭으로 덮을 수 없고, 사본으로 옛 접근자를 만들면 목록 수정이 조용히 사라지기 때문입니다.
+  파이썬은 클래스 별칭이 완전해서 이런 제약이 없습니다.
+- **없어진 이름은 하나도 없습니다.** 이 판은 **추가와 별칭뿐**입니다.
+- **디스크 파일 이름은 그대로입니다** (`QUEUE.P001`). 저장 레이아웃 자체라 바꾸지 않습니다.
+
 ## 0.14.0 변경 - 소켓 keepalive 탐침 타이머, NIO 커넥터 수신 기한 정합 (자바 v2.10.0 과 같음)
 
 - **연결 소켓에 keepalive 탐침 타이머를 겁니다(유휴 60초 + 10초 간격 x 6회).** 엔진이 쓰는 값과 같습니다.

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/README.md

@@ -10,6 +10,67 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.16.0 변경 - 세그먼트 이름을 토픽과 같은 형식으로, 오타 대입 거부 (자바 v2.12.0 과 같음)
+
+- **이름 규칙이 정해졌습니다 - 개수는 맨 복수형, 목록은 `...List` 접미.** 토픽이 `partitions` 를 쓰는 형식 그대로입니다.
+  0.15.0 이 하루 쓴 이름 둘을 여기로 옮깁니다.
+
+  | 자리 | 0.15.0 | **0.16.0** |
+  |---|---|---|
+  | 세그먼트 **개수** (`ILQueueProperty`) | `numberOfSegment` | **`segments`** |
+  | 세그먼트 **목록** (`ILQueueRealTimeInfo`) | `segments` | **`segmentInfoList`** |
+
+  - ★ **0.15.0 의 두 이름은 남기지 않고 지웠습니다.** 남기면 개수에 이름이 셋이 되고, 더 나쁘게는 `segments` 가
+    클래스마다 다른 뜻(개수 vs 목록)이 됩니다. 0.15.0 은 하루짜리였고, 아래 가드 덕분에 **지운 것이 조용하지 않습니다.**
+  - **`numberOfPartition` 과 `partitions` 는 그대로 있습니다.** 예전부터 쓰던 이름이라 영구 별칭으로 남습니다.
+  - 큐에 진짜 분산 파티션이 생기면 그 수는 **토픽과 같은 이름(`partitions`)** 으로 따로 들어옵니다. 지금 있는 이름을
+    그쪽으로 돌리지 않습니다 - **재사용은 제거보다 나쁩니다.** 제거는 그 자리에서 터지지만 재사용은 조용히 다른 값을 줍니다.
+- **속성 객체가 모르는 필드 이름 대입을 거부합니다.** 지금까지는 `prop.numberOfSegmnet = 4` 같은 오타가 **예외도 없이**
+  쓰레기 속성을 만들고 실제 값은 그대로였습니다 - 읽기는 원래 `AttributeError` 였는데 **쓰기만 침묵**해서 옛 값이 그대로
+  서버로 나갔습니다.
+  - 이름이 바뀐 필드는 **무엇으로 바뀌었는지까지** 알려 줍니다:
+    `AttributeError: ILQueueProperty has no attribute numberOfSegment - 0.16.0 에서 segments 로 바뀌었다`
+  - 정말 임의 속성을 얹어야 하면 `object.__setattr__(obj, name, value)` 로 우회할 수 있습니다. 그 값은 **와이어에 실리지
+    않습니다.**
+  - 생성자가 도는 동안은 열려 있습니다(필드를 만들어야 하므로). 상속해 쓰는 응용도 `super().__init__()` 뒤에 자기 필드를
+    만들 수 있습니다.
+- **와이어는 달라지지 않습니다.** 0.15.0 과 바이트가 같습니다(큐 속성 2200 · 구엔진 4096 · 실시간정보). 이 판도 엔진 판을 가리지 않습니다.
+
+## 0.15.0 변경 - 큐의 "파티션" 이 "세그먼트" 가 됩니다 (자바 v2.11.0 과 같음)
+
+- **`ILQueueProperty.numberOfPartition` 이 `numberOfSegment` 로 바뀝니다.** 값도 자리도 그대로이고 **이름만** 바뀝니다.
+  - **옛 이름은 그대로 돕니다.** `numberOfPartition` 은 같은 값을 가리키는 별칭으로 남습니다 - 읽기도 쓰기도 되고,
+    `getNumberOfPartition()` / `setNumberOfPartition()` 도 전처럼 동작합니다. **고치지 않아도 되는 변경입니다.**
+  - `__str__` 라벨이 `NUM-PARTITION` 에서 `NUM-SEGMENT` 로 바뀝니다. 이 출력을 정규식으로 읽는 곳이 있으면 그곳만 봐 주세요.
+- **왜 바꾸는지**: 같은 "파티션" 이라는 말이 토픽과 큐에서 **정반대** 를 뜻하고 있었습니다.
+
+  | 말 | 뜻 |
+  |---|---|
+  | 파티션 | **분산 처리 단위** (토픽. 리더 · 팔로워가 붙는다) |
+  | 세그먼트 | **한 노드 안의 저장 칸** (큐. 파일 1~N, 메모리, 공유메모리) |
+
+  토픽의 `PARTITIONS` 와 큐의 `PARTITION` 이 한 글자 차이로 서로 다른 개념이었습니다. 엔진이 큐에 진짜 분산 파티션을
+  들이기 전에 옛 이름을 비워 두는 것입니다.
+- **와이어는 달라지지 않습니다.** 큐 속성 직렬화는 위치 기반 고정폭이라 **속성 이름이 실리지 않습니다.** 어느 이름으로
+  넣든 나가는 2200바이트(구엔진용 4096 레이아웃도)가 같습니다. 그래서 이 판은 **엔진 판을 가리지 않습니다.**
+- **엔진 쪽 이름도 같이 바뀝니다**(ilsc `PARTITION(n)` -> `SEGMENT(n)`, `VIEW QUEUE` 머리글, 컨피그 XML
+  `Storage/@NumberOfPartition` -> `@NumberOfSegment`). 엔진도 옛 이름을 계속 받습니다.
+  - ★ **ilsc 에서 `SEGMENT` 를 쓰려면 엔진도 같이 올려야 합니다.** 클라이언트만 올린 환경에서는 엔진이 그 키워드를
+    모릅니다 - 그때도 큐는 정상 동작하고, ilsc 에서 `PARTITION` 을 쓰면 됩니다.
+- **큐 실시간 정보의 "파티션" 목록도 같이 바뀝니다.** `getQueueRealTimeInfo()` 가 돌려주는
+  `ILQueueRealTimeInfo` 의 `partitions` 가 **`segments`** 가 되고, 항목 클래스 `PartitionItem` 은 **`SegmentItem`** 이 됩니다.
+  - 여기도 **옛 이름이 그대로 돕니다.** `partitions` 는 같은 목록을 가리키는 별칭이고(`getPartitions()` / `setPartitions()` 포함),
+    `PartitionItem` 은 `SegmentItem` 과 **같은 클래스 객체**라 `isinstance` 도 전처럼 통합니다.
+  - ★ **토픽의 `getPartitions()` 와는 뜻이 다릅니다.** 지금까지 두 클래스에서 **같은 이름이 정반대**를 뜻하고 있었습니다 -
+    토픽 쪽은 분산 처리 단위, 큐 실시간 정보 쪽은 한 노드 안의 저장 칸입니다. 이번 개명의 목적이 바로 이것입니다.
+  - `__str__` 머리글이 `Partitions ---` 에서 `Segments ---` 로 바뀝니다(엔진 `VIEW QUEUE` 가 `SEGMENTS(` 로 나가는 것과 맞춥니다).
+  - `ILC.MIMQ_VO_SEGMENT_ITEM_LEN` 이 생기고 `ILC.MIMQ_VO_PARTITION_ITEM_LEN` 은 같은 값(128)의 별칭으로 남습니다.
+- **자바 클라이언트는 클래스 이름을 바꾸지 않습니다**(`PartitionItem` 유지, `getSegments()` 추가). 자바는 제네릭이 불변이라
+  `ArrayList<PartitionItem>` 을 별칭으로 덮을 수 없고, 사본으로 옛 접근자를 만들면 목록 수정이 조용히 사라지기 때문입니다.
+  파이썬은 클래스 별칭이 완전해서 이런 제약이 없습니다.
+- **없어진 이름은 하나도 없습니다.** 이 판은 **추가와 별칭뿐**입니다.
+- **디스크 파일 이름은 그대로입니다** (`QUEUE.P001`). 저장 레이아웃 자체라 바꾸지 않습니다.
+
 ## 0.14.0 변경 - 소켓 keepalive 탐침 타이머, NIO 커넥터 수신 기한 정합 (자바 v2.10.0 과 같음)
 
 - **연결 소켓에 keepalive 탐침 타이머를 겁니다(유휴 60초 + 10초 간격 x 6회).** 엔진이 쓰는 값과 같습니다.

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/ilink/__init__.py

@@ -1,6 +1,6 @@
 """iLink - Python client API for iLink M.O.M. (Message Oriented Middleware)."""
 
-__version__ = "0.14.0"
+__version__ = "0.16.0"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser
@@ -18,6 +18,7 @@ from .common import ILC, ILCC, ILRC, MatchOption
 from .properties import (
     DestItem,
     PartitionItem,
+    SegmentItem,
     ILQueueProperty,
     ILChannelProperty,
     ILChannelType,
@@ -71,6 +72,7 @@ __all__ = [
     # Properties
     "DestItem",
     "PartitionItem",
+    "SegmentItem",
     "ILQueueProperty",
     "ILChannelProperty",
     "ILChannelType",

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/ilink/admin.py

@@ -629,7 +629,7 @@ class ILAdminService:
 
         Note:
             **값 범위를 검사하는 항목은 넷뿐이다.** 나머지(큐 깊이, 메시지 길이,
-            만료, 파티션 수 등)는 무엇을 넣어도 그대로 저장되므로 **부르는 쪽이
+            만료, 세그먼트 수 등)는 무엇을 넣어도 그대로 저장되므로 **부르는 쪽이
             지켜야 한다.** 서버가 막아 줄 것이라 기대하지 마라.
 
             ======================  ================  ==========  ===================
@@ -3545,7 +3545,7 @@ class ILAdminQmgr:
             큐 속성은 엔진 6.3.3 에서 전송 레이아웃이 한 번 바뀐 **유일한**
             속성이다(4096 -> 2200). 붙어 있는 엔진의 리비전을 보고 알아서 옛
             레이아웃으로 보내므로 호출부는 달라질 게 없다. 다만 구엔진에는
-            만료(``expiry``)/영속성(``deliveryMode``)/파티션 설정이 아예 없어
+            만료(``expiry``)/영속성(``deliveryMode``)/세그먼트 설정이 아예 없어
             **그 값들은 무시된다** - 설정해도 반영되지 않는다.
         """
         try:
@@ -3861,7 +3861,7 @@ class ILAdminQmgr:
             큐 속성은 엔진 6.3.3 에서 전송 레이아웃이 한 번 바뀐 **유일한**
             속성이다(4096 -> 2200). 붙어 있는 엔진의 리비전을 보고 알아서 옛
             레이아웃으로 보내므로 호출부는 달라질 게 없다. 다만 구엔진에는
-            만료(``expiry``)/영속성(``deliveryMode``)/파티션 설정이 아예 없어
+            만료(``expiry``)/영속성(``deliveryMode``)/세그먼트 설정이 아예 없어
             **그 값들은 무시된다** - 설정해도 반영되지 않는다.
         """
         try:
@@ -5523,7 +5523,7 @@ class ILAdminQmgr:
         Returns:
             ILQueueRealTimeInfo: 현재 깊이, 미커밋 put/get 건수, 열려 있는
             클라이언트/채널 수, 마지막 put/get 을 한 클라이언트와 시각,
-            파티션별 상세(``getPartitions()``).
+            세그먼트별 상세(``getSegmentInfoList()``).
 
         Raises:
             ILOperationException: 그런 큐가 없을 때.
@@ -5538,9 +5538,9 @@ class ILAdminQmgr:
             그 시절 엔진은 이 요청에 **큐 속성 블롭을 통째로** 답한다. 사용 현황
             통계가 속성 안에 들어 있었기 때문이다. 클라이언트가 알아서 판별해
             같은 필드를 채우므로 호출부는 달라질 게 없다. 다만
-            :attr:`~ilink.properties.ILQueueRealTimeInfo.partitions` 는 **빈
-            목록**이다 - 파티셔닝은 6.3.3 에서 들어온 기능이라 구엔진 큐에는
-            파티션이라는 개념 자체가 없다.
+            :attr:`~ilink.properties.ILQueueRealTimeInfo.segmentInfoList` 는 **빈
+            목록**이다 - 저장 칸 나누기는 6.3.3 에서 들어온 기능이라 구엔진 큐에는
+            세그먼트라는 개념 자체가 없다.
         """
         try:
             res_msg = self.service.inquire(

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/ilink/common.py

@@ -858,7 +858,10 @@ class ILC:
     MIMQ_VO_CHANNEL_LEN = 2048
     MIMQ_VO_DEST_ITEM_LEN = 1024
     MIMQ_VO_QUEUE_INFO_LEN = 512
-    MIMQ_VO_PARTITION_ITEM_LEN = 128
+    #: 세그먼트 적재 항목 하나의 고정폭(엔진 ``SEGMENT_INFO_C_LENGTH``).
+    MIMQ_VO_SEGMENT_ITEM_LEN = 128
+    #: ``MIMQ_VO_SEGMENT_ITEM_LEN`` 의 **옛 이름**. 엔진 7.x(SVN 3448) 개명 전 이름이다.
+    MIMQ_VO_PARTITION_ITEM_LEN = MIMQ_VO_SEGMENT_ITEM_LEN
     MIMQ_VO_ACCESSRULE_LEN = 94
     MIMQ_VO_CERTFILE_LEN = 512
     MIMQ_VO_SPOKEINFO_LEN = 128

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/ilink/properties.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import datetime
+import functools
 from enum import IntEnum
 from typing import List
 
@@ -94,6 +95,75 @@ class _AutoAccessor:
         **세터를 쓴다.**
     """
 
+    #: 이 인스턴스의 필드 생성이 끝났는지. 생성자가 도는 동안은 False 다.
+    _il_sealed = False
+    #: 생성자 중첩 깊이. 하위 클래스가 ``super().__init__()`` 을 부를 때를 센다.
+    _il_init_depth = 0
+    #: 이름이 바뀐 필드. ``{옛 이름: (새 이름, 바뀐 판)}``. 오타 거부 문구에 실어
+    #: **무엇으로 바뀌었는지**까지 알려 준다 - 거부만 하면 부르는 쪽이 헤맨다.
+    _RENAMED: dict = {}
+
+    def __init_subclass__(cls, **kwargs) -> None:
+        """하위 클래스의 ``__init__`` 을 감싸 **끝나는 순간 봉인**한다.
+
+        Note:
+            봉인 뒤에는 :meth:`__setattr__` 이 모르는 이름을 거부한다. 생성자가
+            도는 동안은 필드를 만들어야 하므로 열어 둔다. ``super().__init__()``
+            을 부르는 하위 클래스가 있으므로 **깊이를 세어 제일 바깥 생성자가
+            끝날 때** 봉인한다 - 안쪽에서 봉인하면 하위 클래스가 자기 필드를
+            만들지 못한다.
+        """
+        super().__init_subclass__(**kwargs)
+        init = cls.__dict__.get("__init__")
+        if init is None:
+            return
+
+        @functools.wraps(init)
+        def _wrapped(self, *args, **kw):
+            object.__setattr__(self, "_il_init_depth", self._il_init_depth + 1)
+            try:
+                init(self, *args, **kw)
+            finally:
+                depth = self._il_init_depth - 1
+                object.__setattr__(self, "_il_init_depth", depth)
+                if depth == 0:
+                    object.__setattr__(self, "_il_sealed", True)
+
+        cls.__init__ = _wrapped
+
+    def __setattr__(self, name: str, value) -> None:
+        """**모르는 필드 이름 대입을 거부한다.**
+
+        Args:
+            name (str): 필드 이름.
+            value: 넣을 값.
+
+        Raises:
+            AttributeError: 그런 필드가 없을 때.
+
+        Note:
+            전에는 오타가 **조용했다** - ``prop.numberOfSegmnet = 4`` 가 예외도
+            없이 쓰레기 속성을 만들고 실제 값은 그대로였다. 읽기는 원래
+            ``AttributeError`` 였는데 **쓰기만 침묵해서** 와이어에 옛 값이 나갔다.
+
+            정말 임의 속성을 얹어야 하면 ``object.__setattr__(obj, name, value)``
+            로 우회할 수 있다. 그때는 **와이어에 실리지 않는다**는 것을 부르는
+            쪽이 안다는 뜻이다.
+        """
+        if not self._il_sealed or name in self.__dict__ or hasattr(type(self), name):
+            object.__setattr__(self, name, value)
+            return
+        moved = type(self)._RENAMED.get(name)
+        if moved is not None:
+            raise AttributeError(
+                f"{self.__class__.__name__} has no attribute {name}"
+                f" - {moved[1]} 에서 {moved[0]} 로 바뀌었다"
+            )
+        raise AttributeError(
+            f"{self.__class__.__name__} has no attribute {name}"
+            f" - 필드 이름을 확인하라 (임의 속성을 얹으려면 object.__setattr__ 을 쓴다)"
+        )
+
     def __getattr__(self, name: str):
         """없는 속성 접근을 필드 기반 접근자로 해석한다.
 
@@ -324,11 +394,17 @@ class DestItem(_AutoAccessor):
         return ILC.MIMQ_ERROR_STR
 
 
-class PartitionItem(_AutoAccessor):
-    """큐 파티션 하나의 적재 현황. :class:`ILQueueRealTimeInfo` 안에 목록으로 들어간다.
+class SegmentItem(_AutoAccessor):
+    """큐 **세그먼트**(저장 칸) 하나의 적재 현황. :class:`ILQueueRealTimeInfo` 안에
+    목록으로 들어간다.
+
+    세그먼트는 한 큐의 메시지를 나눠 담는 저장 칸이다(파일 1~N, 메모리, 공유메모리).
+    **토픽의 파티션과 달리 분산 처리 단위가 아니다.** 엔진 7.x(SVN 3448)에서 이름이
+    갈리기 전에는 이 클래스가 ``PartitionItem`` 이었다 - 그 이름은 **별칭으로 남아
+    있다**(``PartitionItem is SegmentItem`` 이라 ``isinstance`` 도 그대로 통한다).
 
     Attributes:
-        size (int): 이 파티션이 쓰는 총 바이트. 기본 0.
+        size (int): 이 세그먼트가 쓰는 총 바이트. 기본 0.
             스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly).
         msgCnt (int): 적재된 메시지 수(확정분). 기본 0.
             스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
@@ -341,7 +417,7 @@ class PartitionItem(_AutoAccessor):
     """
 
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
-        """파티션 항목을 만든다.
+        """세그먼트 항목을 만든다.
 
         Args:
             ba (bytes | bytearray | None): 서버가 보낸 고정폭 바이트. None(기본)이면
@@ -361,10 +437,10 @@ class PartitionItem(_AutoAccessor):
             return
 
         try:
-            if len(ba) < ILC.MIMQ_VO_PARTITION_ITEM_LEN:
+            if len(ba) < ILC.MIMQ_VO_SEGMENT_ITEM_LEN:
                 raise ILDeserializeException(
                     "invalid byte array length. fixed : ["
-                    + str(ILC.MIMQ_VO_PARTITION_ITEM_LEN)
+                    + str(ILC.MIMQ_VO_SEGMENT_ITEM_LEN)
                     + "] / actual : ["
                     + str(len(ba))
                     + "]"
@@ -393,7 +469,7 @@ class PartitionItem(_AutoAccessor):
             라이브러리가 요청을 보낼 때 내부적으로 부른다. 응용이 직접 부를
             일은 거의 없다.
         """
-        ba = bytearray(ILC.MIMQ_VO_PARTITION_ITEM_LEN)
+        ba = bytearray(ILC.MIMQ_VO_SEGMENT_ITEM_LEN)
         offset = 0
         ba_merge(self.size, ba, offset, 20)
         offset += 20
@@ -411,7 +487,7 @@ class PartitionItem(_AutoAccessor):
         """사람이 읽는 여러 줄 요약을 돌려준다(운영 화면 출력용).
 
         Returns:
-            str: 파티션 항목 를 보기 좋게 정리한 문자열. **형식이 고정되어 있지
+            str: 세그먼트 항목 를 보기 좋게 정리한 문자열. **형식이 고정되어 있지
             않으므로 파싱해 쓰지 말 것.**
         """
         return (
@@ -420,6 +496,12 @@ class PartitionItem(_AutoAccessor):
         )
 
 
+#: :class:`SegmentItem` 의 **옛 이름**. 같은 클래스 객체라 ``isinstance`` 도 통한다.
+#: 엔진 7.x(SVN 3448)에서 큐의 "파티션" 이 "세그먼트" 로 바뀌기 전 이름이다.
+#: **영구히 세그먼트를 가리킨다** - 다른 뜻으로 재사용하지 않는다.
+PartitionItem = SegmentItem
+
+
 class ILQueueMinorProperty(_AutoAccessor):
     """큐 **요약** 정보. 목록 조회(``getQueueMinorList``)가 돌려주는 가벼운 형태.
 
@@ -638,12 +720,27 @@ class ILQueueProperty(_AutoAccessor):
             스펙: 기본 10485760 · 범위 0~9223372036854775807 · 단위 byte · 변경 가능/재기동 불필요.
         sharedMemorySize (int): 공유 메모리 크기. 기본 0.
             스펙: 기본 DISABLED (0) · 범위 0~9223372036854775807 · 단위 byte · 변경 불가.
-        numberOfPartition (int): 파일 파티션 개수. 기본 2.
+        segments (int): **세그먼트**(저장 칸) 개수. 기본 2.
+            한 큐의 메시지를 나눠 담는 저장 칸의 수다 - 파일 1~N, 메모리,
+            공유메모리가 그 칸이다. **토픽의 파티션과 달리 분산 처리 단위가
+            아니다.** 생성 시에만 지정하고 이후 바꿀 수 없다.
+            **개수라 맨 복수형**이다 - 목록은 ``...List`` 접미를 쓴다
+            (:attr:`ILQueueRealTimeInfo.segmentInfoList`). 토픽의 ``partitions``
+            와 같은 형식이다.
             스펙: 기본 2 · 범위 2~99 · 단위 개 · 변경 불가.
+        numberOfPartition (int): ``segments`` 의 **옛 이름**. 읽기·쓰기
+            모두 같은 값을 가리키므로 기존 코드는 그대로 돈다. 엔진 7.x(SVN 3448)
+            에서 큐의 "파티션" 이 "세그먼트" 로 바뀌면서 이름이 갈렸다 - 큐의
+            저장 칸과 토픽의 분산 단위가 한 글자 차이로 정반대를 뜻하던 것을
+            없앴다. **새 코드는** ``segments`` **를 쓴다.**
+            **이 이름은 영구히 세그먼트 개수를 가리킨다** - 다른 뜻으로
+            재사용하지 않는다. 큐에 진짜 분산 파티션이 생겨도 그 수는
+            **토픽과 같은 이름**(``partitions``)으로 따로 들어온다.
+            스펙: 별칭 · 와이어에는 이름이 실리지 않는다(위치 기반 고정폭).
         legacyBlob (bool): 이 객체가 **구버전(4096) 블롭**에서 만들어졌는지.
             엔진 rev 3155 미만이 보낸 응답이면 True 다. 그 경우 ``expiry`` /
             ``expiredQueue`` / ``deliveryMode`` / ``maxMemorySize`` /
-            ``sharedMemorySize`` / ``numberOfPartition`` 은 **서버가 준 값이 아니라
+            ``sharedMemorySize`` / ``segments`` 는 **서버가 준 값이 아니라
             기본값**이다 - 구엔진에는 그 설정이 없다.
             스펙: 서버 응답 길이로 라이브러리가 판단하는 내부 표시 · 앱이 건드리지 않는다.
     """
@@ -658,6 +755,38 @@ class ILQueueProperty(_AutoAccessor):
         "expiredQueue": _spec_maxlen(47),
     }
 
+    #: 0.15.0 이 잠깐 쓴 이름. 그 판에서만 살았고 0.16.0 에서 ``segments`` 가 됐다.
+    _RENAMED = {"numberOfSegment": ("segments", "0.16.0")}
+
+    @property
+    def numberOfPartition(self) -> int:
+        """``segments`` 의 **옛 이름**. 읽기·쓰기 모두 같은 값이다.
+
+        Returns:
+            int: ``segments`` 와 같은 값.
+
+        Note:
+            클래스 레벨 ``property`` 라서 대입도 받는다
+            (``prop.numberOfPartition = 4``). :class:`_AutoAccessor` 가 이름을
+            보고 만들어 주는 ``getNumberOfPartition()`` /
+            ``setNumberOfPartition()`` 도 이 별칭을 통과한다.
+
+            **와이어에는 이름이 실리지 않는다** - 큐 속성 직렬화는 위치 기반
+            고정폭이라 이 개명은 이름 층만의 변경이고 엔진 판과 무관하다.
+
+            **이 별칭은 영구히 세그먼트 수를 가리킨다.** 뜻을 바꿔 재사용하지
+            않는다 - 재사용은 제거보다 나쁘기 때문이다. 제거는 ``AttributeError``
+            로 그 자리에서 터지지만, 재사용은 **옛 코드가 조용히 다른 수를
+            읽는다.** 큐의 분산 파티션 수는 ``partitions``
+            으로 들어온다 - 토픽과 같은 이름 ``partitions`` 다
+            (엔진 ilsc ``PARTITIONS(n)`` · 컨피그 XML ``Partitions``).
+        """
+        return self.segments
+
+    @numberOfPartition.setter
+    def numberOfPartition(self, value: int) -> None:
+        self.segments = value
+
     def __init__(
         self,
         name: str | bytes | bytearray | None = None,
@@ -692,7 +821,7 @@ class ILQueueProperty(_AutoAccessor):
         self.deliveryMode = ILC.MIMQ_DELIVERY_MODE_DEPENDS_ON_MSG
         self.maxMemorySize = 10485760
         self.sharedMemorySize = 0
-        self.numberOfPartition = 2
+        self.segments = 2
         #: 구버전(4096) 블롭에서 만들어졌는지. 내부 판별용.
         self.legacyBlob = False
 
@@ -766,7 +895,7 @@ class ILQueueProperty(_AutoAccessor):
                 offset += 20
                 self.sharedMemorySize = ba_pick_long(ba, offset, 20)
                 offset += 20
-                self.numberOfPartition = ba_pick_int(ba, offset, 10)
+                self.segments = ba_pick_int(ba, offset, 10)
                 offset += 10
                 offset += 228
             # ---- 공통 접미 (2142) ----
@@ -793,7 +922,7 @@ class ILQueueProperty(_AutoAccessor):
             보고 :class:`ILAdminQmgr` 가 정한다.
 
             구버전 레이아웃에는 ``expiry`` / ``expiredQueue`` / ``deliveryMode`` /
-            ``maxMemorySize`` / ``sharedMemorySize`` / ``numberOfPartition`` 자리가
+            ``maxMemorySize`` / ``sharedMemorySize`` / ``segments`` 자리가
             **없다.** 그 값들은 실리지 않고 버려진다 - 구엔진이 모르는 설정이다.
         """
         if legacy:
@@ -837,7 +966,7 @@ class ILQueueProperty(_AutoAccessor):
         offset += 20
         ba_merge(self.sharedMemorySize, ba, offset, 20)
         offset += 20
-        ba_merge(self.numberOfPartition, ba, offset, 10)
+        ba_merge(self.segments, ba, offset, 10)
         offset += 10
         offset += 228
         ba_merge(self.incomingDelayDepth, ba, offset, 10)
@@ -977,8 +1106,8 @@ class ILQueueProperty(_AutoAccessor):
             + "bytes) SHARED-MEMORY-SIZE("
             + str(self.sharedMemorySize)
             + "bytes)\n"
-            + "\tNUM-PARTITION ("
-            + str(self.numberOfPartition)
+            + "\tNUM-SEGMENT ("
+            + str(self.segments)
             + ") DELAY(over "
             + str(self.incomingDelayDepth)
             + "depth, "
@@ -1972,6 +2101,14 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         채우지 않는다(직렬화에서 그 180바이트를 건너뛴다). 그래서 구엔진에
         붙었을 때만 값이 온다.
 
+        ★ **그 180바이트는 빈 자리가 아니다.** 오프셋 30~210 이고, 이 네 필드가
+        정확히 그 폭을 채운다(20+20+70+70). 엔진이 건너뛰는 구간과 같은 자리이니
+        **예약 공간으로 보이지만 임자가 있다** - 이 클라는 지금도 그 자리를
+        파싱한다. 여기에 새 필드를 실으면 옛 클라는 0 이 아니라 **쓰레기를 값으로**
+        읽고(문자열 칸이라 예외도 안 난다), 그 값이 :meth:`__str__` 의 ``LASTPUT``
+        줄로 그대로 나간다. 재사용하려면 **수신자가 새 뜻을 안다고 말한 뒤**
+        여야 한다(엔진 능력 선언).
+
         6.3.3+ 에서 "누가 마지막으로 이 큐를 건드렸는지" 를 보려면 세션 쪽을
         보라 - :meth:`ILAdminQmgr.getSessionList` 가 주는
         :class:`ILSessionProperty` 의 ``lastAccessObject`` 가 그 정보를 세션
@@ -2000,10 +2137,47 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
         uncommittedGet (int): 아직 커밋되지 않은 get 건수. 기본 0.
             스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
-        partitions (list[PartitionItem]): 파티션별 상세. 기본 빈 목록.
-            스펙: 기본 빈 목록 · 범위 파티션 수만큼 · 변경 불가(ReadOnly).
+        segmentInfoList (list[SegmentItem]): **세그먼트별** 상세. 기본 빈 목록.
+            목록이라 ``...List`` 접미를 쓴다 - 개수를 뜻하는 맨 복수형
+            (:attr:`ILQueueProperty.segments`)과 구별된다.
+            스펙: 기본 빈 목록 · 범위 세그먼트 수만큼 · 변경 불가(ReadOnly).
+        partitions (list[SegmentItem]): ``segmentInfoList`` 의 **옛 이름**. 읽기·쓰기 모두
+            같은 목록을 가리킨다. 엔진 7.x(SVN 3448)에서 큐의 저장 칸이
+            "세그먼트" 가 되면서 이름이 갈렸다 - 토픽의 ``getPartitions()`` 는
+            **분산 단위**라 뜻이 다르다. **새 코드는** ``segmentInfoList`` **를 쓴다.**
+            **이 이름은 영구히 세그먼트 목록을 가리킨다** - 다른 뜻으로
+            재사용하지 않는다.
+            스펙: 별칭 · 와이어에는 이름이 실리지 않는다.
     """
 
+    #: 0.15.0 이 잠깐 쓴 이름. 그 판에서만 살았고 0.16.0 에서 ``segmentInfoList`` 가 됐다.
+    #: 이 이름을 비워 둔 덕에 :attr:`ILQueueProperty.segments`(세그먼트 **개수**)와
+    #: 겹치지 않는다 - 같은 이름이 클래스마다 다른 뜻이 되는 것을 막는다.
+    _RENAMED = {"segments": ("segmentInfoList", "0.16.0")}
+
+    @property
+    def partitions(self) -> "List[SegmentItem]":
+        """``segmentInfoList`` 의 **옛 이름**. 같은 목록을 가리킨다.
+
+        Returns:
+            list[SegmentItem]: ``segmentInfoList`` 와 같은 목록 객체.
+
+        Note:
+            :class:`_AutoAccessor` 가 만들어 주는 ``getPartitions()`` /
+            ``setPartitions()`` 도 이 별칭을 통과한다. **토픽의**
+            ``ILTopic.getPartitions()`` **와 이름은 같지만 뜻이 다르다** -
+            저쪽은 분산 처리 단위고 이쪽은 한 노드 안의 저장 칸이다.
+
+            **이 별칭은 영구히 세그먼트 목록을 가리킨다.** 큐에 분산 파티션이
+            생겨도 이 이름을 그쪽으로 돌리지 않는다 - 그러면 옛 코드가 조용히
+            다른 것을 읽는다.
+        """
+        return self.segmentInfoList
+
+    @partitions.setter
+    def partitions(self, value: "List[SegmentItem]") -> None:
+        self.segmentInfoList = value
+
     # [spec-check] 문자열 상한 = 와이어 폭 - 1 (엔진이 C 문자열로 읽는다)
     _SPEC = {
         "lastPutClient": _spec_maxlen(69),
@@ -2031,7 +2205,7 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         self.numberOfChannel = 0
         self.uncommittedPut = 0
         self.uncommittedGet = 0
-        self.partitions: List[PartitionItem] = []
+        self.segmentInfoList: List[SegmentItem] = []
 
         if ba is None:
             return
@@ -2068,11 +2242,11 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             count = ba_pick_int(ba, offset, 5)
             offset += 5
             for _ in range(count):
-                item = PartitionItem(
-                    ba_pick_bytes(ba, offset, ILC.MIMQ_VO_PARTITION_ITEM_LEN)
+                item = SegmentItem(
+                    ba_pick_bytes(ba, offset, ILC.MIMQ_VO_SEGMENT_ITEM_LEN)
                 )
-                self.partitions.append(item)
-                offset += ILC.MIMQ_VO_PARTITION_ITEM_LEN
+                self.segmentInfoList.append(item)
+                offset += ILC.MIMQ_VO_SEGMENT_ITEM_LEN
         except Exception as exc:
             raise ILException(exc) from exc
 
@@ -2087,8 +2261,8 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             일은 거의 없다.
         """
         buffer_length = ILC.MIMQ_VO_QUEUE_INFO_LEN + ILC.MIMQ_LIST_ITEM_COUNT_LENGTH
-        if self.partitions:
-            buffer_length += len(self.partitions) * ILC.MIMQ_VO_PARTITION_ITEM_LEN
+        if self.segmentInfoList:
+            buffer_length += len(self.segmentInfoList) * ILC.MIMQ_VO_SEGMENT_ITEM_LEN
         ba = bytearray(buffer_length)
         offset = 0
         ba_merge(self.curDepth, ba, offset, 10)
@@ -2111,11 +2285,11 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         offset += 10
         ba_merge(self.uncommittedGet, ba, offset, 10)
         offset += 10
-        ba_merge(len(self.partitions), ba, offset, 5)
+        ba_merge(len(self.segmentInfoList), ba, offset, 5)
         offset += 5
-        for item in self.partitions:
-            ba_merge(item.get_serialized(), ba, offset, ILC.MIMQ_VO_PARTITION_ITEM_LEN)
-            offset += ILC.MIMQ_VO_PARTITION_ITEM_LEN
+        for item in self.segmentInfoList:
+            ba_merge(item.get_serialized(), ba, offset, ILC.MIMQ_VO_SEGMENT_ITEM_LEN)
+            offset += ILC.MIMQ_VO_SEGMENT_ITEM_LEN
         return bytes(ba)
 
     def __str__(self) -> str:
@@ -2138,9 +2312,9 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             ret += f"LASTGET(By {self.lastGetClient}, {self.lastGetTime})\n"
         ret += f"ACCESS(Client {self.numberOfClient}, Channel {self.numberOfChannel})\n"
         ret += f"TRANSACTED(Put {self.uncommittedPut}, Get {self.uncommittedGet})\n"
-        ret += "Partitions -------------------------------------------------------\n"
-        for partition in self.partitions:
-            ret += "  " + str(partition)
+        ret += "Segments ---------------------------------------------------------\n"
+        for segment in self.segmentInfoList:
+            ret += "  " + str(segment)
         return ret
 
     @classmethod
@@ -2159,9 +2333,9 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             (6.3.3 에서 별도 조회로 분리됐다). 그래서 같은 응답으로 속성 객체와
             이 객체를 모두 채울 수 있다.
 
-            :attr:`partitions` 는 **빈 목록**이 된다. 파티셔닝은 6.3.3 에서 들어온
-            기능이라 구엔진 큐에는 파티션이라는 개념 자체가 없다 - 누락이 아니라
-            사실이다.
+            :attr:`segmentInfoList` 는 **빈 목록**이 된다. 저장 칸 나누기는 6.3.3 에서
+            들어온 기능이라 구엔진 큐에는 세그먼트라는 개념 자체가 없다 - 누락이
+            아니라 사실이다.
         """
         o = ILC.QUEUE_LEGACY_DIVERGE_OFFSET
         info = cls()
@@ -2177,7 +2351,7 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         #   현행 유량 조회(ILQueueFlow)는 **구간별** 값이라 의미가 달라 쓰지 않는다.
         info.uncommittedPut = ba_pick_int(ba, o + 300, 10)
         info.uncommittedGet = ba_pick_int(ba, o + 310, 10)
-        info.partitions = []
+        info.segmentInfoList = []
         return info
 
 

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.14.0
+Version: 0.16.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,67 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.16.0 변경 - 세그먼트 이름을 토픽과 같은 형식으로, 오타 대입 거부 (자바 v2.12.0 과 같음)
+
+- **이름 규칙이 정해졌습니다 - 개수는 맨 복수형, 목록은 `...List` 접미.** 토픽이 `partitions` 를 쓰는 형식 그대로입니다.
+  0.15.0 이 하루 쓴 이름 둘을 여기로 옮깁니다.
+
+  | 자리 | 0.15.0 | **0.16.0** |
+  |---|---|---|
+  | 세그먼트 **개수** (`ILQueueProperty`) | `numberOfSegment` | **`segments`** |
+  | 세그먼트 **목록** (`ILQueueRealTimeInfo`) | `segments` | **`segmentInfoList`** |
+
+  - ★ **0.15.0 의 두 이름은 남기지 않고 지웠습니다.** 남기면 개수에 이름이 셋이 되고, 더 나쁘게는 `segments` 가
+    클래스마다 다른 뜻(개수 vs 목록)이 됩니다. 0.15.0 은 하루짜리였고, 아래 가드 덕분에 **지운 것이 조용하지 않습니다.**
+  - **`numberOfPartition` 과 `partitions` 는 그대로 있습니다.** 예전부터 쓰던 이름이라 영구 별칭으로 남습니다.
+  - 큐에 진짜 분산 파티션이 생기면 그 수는 **토픽과 같은 이름(`partitions`)** 으로 따로 들어옵니다. 지금 있는 이름을
+    그쪽으로 돌리지 않습니다 - **재사용은 제거보다 나쁩니다.** 제거는 그 자리에서 터지지만 재사용은 조용히 다른 값을 줍니다.
+- **속성 객체가 모르는 필드 이름 대입을 거부합니다.** 지금까지는 `prop.numberOfSegmnet = 4` 같은 오타가 **예외도 없이**
+  쓰레기 속성을 만들고 실제 값은 그대로였습니다 - 읽기는 원래 `AttributeError` 였는데 **쓰기만 침묵**해서 옛 값이 그대로
+  서버로 나갔습니다.
+  - 이름이 바뀐 필드는 **무엇으로 바뀌었는지까지** 알려 줍니다:
+    `AttributeError: ILQueueProperty has no attribute numberOfSegment - 0.16.0 에서 segments 로 바뀌었다`
+  - 정말 임의 속성을 얹어야 하면 `object.__setattr__(obj, name, value)` 로 우회할 수 있습니다. 그 값은 **와이어에 실리지
+    않습니다.**
+  - 생성자가 도는 동안은 열려 있습니다(필드를 만들어야 하므로). 상속해 쓰는 응용도 `super().__init__()` 뒤에 자기 필드를
+    만들 수 있습니다.
+- **와이어는 달라지지 않습니다.** 0.15.0 과 바이트가 같습니다(큐 속성 2200 · 구엔진 4096 · 실시간정보). 이 판도 엔진 판을 가리지 않습니다.
+
+## 0.15.0 변경 - 큐의 "파티션" 이 "세그먼트" 가 됩니다 (자바 v2.11.0 과 같음)
+
+- **`ILQueueProperty.numberOfPartition` 이 `numberOfSegment` 로 바뀝니다.** 값도 자리도 그대로이고 **이름만** 바뀝니다.
+  - **옛 이름은 그대로 돕니다.** `numberOfPartition` 은 같은 값을 가리키는 별칭으로 남습니다 - 읽기도 쓰기도 되고,
+    `getNumberOfPartition()` / `setNumberOfPartition()` 도 전처럼 동작합니다. **고치지 않아도 되는 변경입니다.**
+  - `__str__` 라벨이 `NUM-PARTITION` 에서 `NUM-SEGMENT` 로 바뀝니다. 이 출력을 정규식으로 읽는 곳이 있으면 그곳만 봐 주세요.
+- **왜 바꾸는지**: 같은 "파티션" 이라는 말이 토픽과 큐에서 **정반대** 를 뜻하고 있었습니다.
+
+  | 말 | 뜻 |
+  |---|---|
+  | 파티션 | **분산 처리 단위** (토픽. 리더 · 팔로워가 붙는다) |
+  | 세그먼트 | **한 노드 안의 저장 칸** (큐. 파일 1~N, 메모리, 공유메모리) |
+
+  토픽의 `PARTITIONS` 와 큐의 `PARTITION` 이 한 글자 차이로 서로 다른 개념이었습니다. 엔진이 큐에 진짜 분산 파티션을
+  들이기 전에 옛 이름을 비워 두는 것입니다.
+- **와이어는 달라지지 않습니다.** 큐 속성 직렬화는 위치 기반 고정폭이라 **속성 이름이 실리지 않습니다.** 어느 이름으로
+  넣든 나가는 2200바이트(구엔진용 4096 레이아웃도)가 같습니다. 그래서 이 판은 **엔진 판을 가리지 않습니다.**
+- **엔진 쪽 이름도 같이 바뀝니다**(ilsc `PARTITION(n)` -> `SEGMENT(n)`, `VIEW QUEUE` 머리글, 컨피그 XML
+  `Storage/@NumberOfPartition` -> `@NumberOfSegment`). 엔진도 옛 이름을 계속 받습니다.
+  - ★ **ilsc 에서 `SEGMENT` 를 쓰려면 엔진도 같이 올려야 합니다.** 클라이언트만 올린 환경에서는 엔진이 그 키워드를
+    모릅니다 - 그때도 큐는 정상 동작하고, ilsc 에서 `PARTITION` 을 쓰면 됩니다.
+- **큐 실시간 정보의 "파티션" 목록도 같이 바뀝니다.** `getQueueRealTimeInfo()` 가 돌려주는
+  `ILQueueRealTimeInfo` 의 `partitions` 가 **`segments`** 가 되고, 항목 클래스 `PartitionItem` 은 **`SegmentItem`** 이 됩니다.
+  - 여기도 **옛 이름이 그대로 돕니다.** `partitions` 는 같은 목록을 가리키는 별칭이고(`getPartitions()` / `setPartitions()` 포함),
+    `PartitionItem` 은 `SegmentItem` 과 **같은 클래스 객체**라 `isinstance` 도 전처럼 통합니다.
+  - ★ **토픽의 `getPartitions()` 와는 뜻이 다릅니다.** 지금까지 두 클래스에서 **같은 이름이 정반대**를 뜻하고 있었습니다 -
+    토픽 쪽은 분산 처리 단위, 큐 실시간 정보 쪽은 한 노드 안의 저장 칸입니다. 이번 개명의 목적이 바로 이것입니다.
+  - `__str__` 머리글이 `Partitions ---` 에서 `Segments ---` 로 바뀝니다(엔진 `VIEW QUEUE` 가 `SEGMENTS(` 로 나가는 것과 맞춥니다).
+  - `ILC.MIMQ_VO_SEGMENT_ITEM_LEN` 이 생기고 `ILC.MIMQ_VO_PARTITION_ITEM_LEN` 은 같은 값(128)의 별칭으로 남습니다.
+- **자바 클라이언트는 클래스 이름을 바꾸지 않습니다**(`PartitionItem` 유지, `getSegments()` 추가). 자바는 제네릭이 불변이라
+  `ArrayList<PartitionItem>` 을 별칭으로 덮을 수 없고, 사본으로 옛 접근자를 만들면 목록 수정이 조용히 사라지기 때문입니다.
+  파이썬은 클래스 별칭이 완전해서 이런 제약이 없습니다.
+- **없어진 이름은 하나도 없습니다.** 이 판은 **추가와 별칭뿐**입니다.
+- **디스크 파일 이름은 그대로입니다** (`QUEUE.P001`). 저장 레이아웃 자체라 바꾸지 않습니다.
+
 ## 0.14.0 변경 - 소켓 keepalive 탐침 타이머, NIO 커넥터 수신 기한 정합 (자바 v2.10.0 과 같음)
 
 - **연결 소켓에 keepalive 탐침 타이머를 겁니다(유휴 60초 + 10초 간격 x 6회).** 엔진이 쓰는 값과 같습니다.

{jetstream_api-0.14.0 → jetstream_api-0.16.0}/pyproject.toml

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