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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.15.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,32 @@ 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` 로 바뀝니다.** 값도 자리도 그대로이고 **이름만** 바뀝니다.

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

@@ -10,6 +10,32 @@ 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` 로 바뀝니다.** 값도 자리도 그대로이고 **이름만** 바뀝니다.

{jetstream_api-0.15.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.15.0"
+__version__ = "0.16.0"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser

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

@@ -5523,7 +5523,7 @@ class ILAdminQmgr:
         Returns:
             ILQueueRealTimeInfo: 현재 깊이, 미커밋 put/get 건수, 열려 있는
             클라이언트/채널 수, 마지막 put/get 을 한 클라이언트와 시각,
-            세그먼트별 상세(``getSegments()``).
+            세그먼트별 상세(``getSegmentInfoList()``).
 
         Raises:
             ILOperationException: 그런 큐가 없을 때.
@@ -5538,7 +5538,7 @@ class ILAdminQmgr:
             그 시절 엔진은 이 요청에 **큐 속성 블롭을 통째로** 답한다. 사용 현황
             통계가 속성 안에 들어 있었기 때문이다. 클라이언트가 알아서 판별해
             같은 필드를 채우므로 호출부는 달라질 게 없다. 다만
-            :attr:`~ilink.properties.ILQueueRealTimeInfo.segments` 는 **빈
+            :attr:`~ilink.properties.ILQueueRealTimeInfo.segmentInfoList` 는 **빈
             목록**이다 - 저장 칸 나누기는 6.3.3 에서 들어온 기능이라 구엔진 큐에는
             세그먼트라는 개념 자체가 없다.
         """

{jetstream_api-0.15.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):
         """없는 속성 접근을 필드 기반 접근자로 해석한다.
 
@@ -428,6 +498,7 @@ class SegmentItem(_AutoAccessor):
 
 #: :class:`SegmentItem` 의 **옛 이름**. 같은 클래스 객체라 ``isinstance`` 도 통한다.
 #: 엔진 7.x(SVN 3448)에서 큐의 "파티션" 이 "세그먼트" 로 바뀌기 전 이름이다.
+#: **영구히 세그먼트를 가리킨다** - 다른 뜻으로 재사용하지 않는다.
 PartitionItem = SegmentItem
 
 
@@ -649,21 +720,27 @@ class ILQueueProperty(_AutoAccessor):
             스펙: 기본 10485760 · 범위 0~9223372036854775807 · 단위 byte · 변경 가능/재기동 불필요.
         sharedMemorySize (int): 공유 메모리 크기. 기본 0.
             스펙: 기본 DISABLED (0) · 범위 0~9223372036854775807 · 단위 byte · 변경 불가.
-        numberOfSegment (int): **세그먼트**(저장 칸) 개수. 기본 2.
+        segments (int): **세그먼트**(저장 칸) 개수. 기본 2.
             한 큐의 메시지를 나눠 담는 저장 칸의 수다 - 파일 1~N, 메모리,
             공유메모리가 그 칸이다. **토픽의 파티션과 달리 분산 처리 단위가
             아니다.** 생성 시에만 지정하고 이후 바꿀 수 없다.
+            **개수라 맨 복수형**이다 - 목록은 ``...List`` 접미를 쓴다
+            (:attr:`ILQueueRealTimeInfo.segmentInfoList`). 토픽의 ``partitions``
+            와 같은 형식이다.
             스펙: 기본 2 · 범위 2~99 · 단위 개 · 변경 불가.
-        numberOfPartition (int): ``numberOfSegment`` 의 **옛 이름**. 읽기·쓰기
+        numberOfPartition (int): ``segments`` 의 **옛 이름**. 읽기·쓰기
             모두 같은 값을 가리키므로 기존 코드는 그대로 돈다. 엔진 7.x(SVN 3448)
             에서 큐의 "파티션" 이 "세그먼트" 로 바뀌면서 이름이 갈렸다 - 큐의
             저장 칸과 토픽의 분산 단위가 한 글자 차이로 정반대를 뜻하던 것을
-            없앴다. **새 코드는** ``numberOfSegment`` **를 쓴다.**
+            없앴다. **새 코드는** ``segments`` **를 쓴다.**
+            **이 이름은 영구히 세그먼트 개수를 가리킨다** - 다른 뜻으로
+            재사용하지 않는다. 큐에 진짜 분산 파티션이 생겨도 그 수는
+            **토픽과 같은 이름**(``partitions``)으로 따로 들어온다.
             스펙: 별칭 · 와이어에는 이름이 실리지 않는다(위치 기반 고정폭).
         legacyBlob (bool): 이 객체가 **구버전(4096) 블롭**에서 만들어졌는지.
             엔진 rev 3155 미만이 보낸 응답이면 True 다. 그 경우 ``expiry`` /
             ``expiredQueue`` / ``deliveryMode`` / ``maxMemorySize`` /
-            ``sharedMemorySize`` / ``numberOfSegment`` 는 **서버가 준 값이 아니라
+            ``sharedMemorySize`` / ``segments`` 는 **서버가 준 값이 아니라
             기본값**이다 - 구엔진에는 그 설정이 없다.
             스펙: 서버 응답 길이로 라이브러리가 판단하는 내부 표시 · 앱이 건드리지 않는다.
     """
@@ -678,12 +755,15 @@ 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:
-        """``numberOfSegment`` 의 **옛 이름**. 읽기·쓰기 모두 같은 값이다.
+        """``segments`` 의 **옛 이름**. 읽기·쓰기 모두 같은 값이다.
 
         Returns:
-            int: ``numberOfSegment`` 와 같은 값.
+            int: ``segments`` 와 같은 값.
 
         Note:
             클래스 레벨 ``property`` 라서 대입도 받는다
@@ -693,12 +773,19 @@ class ILQueueProperty(_AutoAccessor):
 
             **와이어에는 이름이 실리지 않는다** - 큐 속성 직렬화는 위치 기반
             고정폭이라 이 개명은 이름 층만의 변경이고 엔진 판과 무관하다.
+
+            **이 별칭은 영구히 세그먼트 수를 가리킨다.** 뜻을 바꿔 재사용하지
+            않는다 - 재사용은 제거보다 나쁘기 때문이다. 제거는 ``AttributeError``
+            로 그 자리에서 터지지만, 재사용은 **옛 코드가 조용히 다른 수를
+            읽는다.** 큐의 분산 파티션 수는 ``partitions``
+            으로 들어온다 - 토픽과 같은 이름 ``partitions`` 다
+            (엔진 ilsc ``PARTITIONS(n)`` · 컨피그 XML ``Partitions``).
         """
-        return self.numberOfSegment
+        return self.segments
 
     @numberOfPartition.setter
     def numberOfPartition(self, value: int) -> None:
-        self.numberOfSegment = value
+        self.segments = value
 
     def __init__(
         self,
@@ -734,7 +821,7 @@ class ILQueueProperty(_AutoAccessor):
         self.deliveryMode = ILC.MIMQ_DELIVERY_MODE_DEPENDS_ON_MSG
         self.maxMemorySize = 10485760
         self.sharedMemorySize = 0
-        self.numberOfSegment = 2
+        self.segments = 2
         #: 구버전(4096) 블롭에서 만들어졌는지. 내부 판별용.
         self.legacyBlob = False
 
@@ -808,7 +895,7 @@ class ILQueueProperty(_AutoAccessor):
                 offset += 20
                 self.sharedMemorySize = ba_pick_long(ba, offset, 20)
                 offset += 20
-                self.numberOfSegment = ba_pick_int(ba, offset, 10)
+                self.segments = ba_pick_int(ba, offset, 10)
                 offset += 10
                 offset += 228
             # ---- 공통 접미 (2142) ----
@@ -835,7 +922,7 @@ class ILQueueProperty(_AutoAccessor):
             보고 :class:`ILAdminQmgr` 가 정한다.
 
             구버전 레이아웃에는 ``expiry`` / ``expiredQueue`` / ``deliveryMode`` /
-            ``maxMemorySize`` / ``sharedMemorySize`` / ``numberOfSegment`` 자리가
+            ``maxMemorySize`` / ``sharedMemorySize`` / ``segments`` 자리가
             **없다.** 그 값들은 실리지 않고 버려진다 - 구엔진이 모르는 설정이다.
         """
         if legacy:
@@ -879,7 +966,7 @@ class ILQueueProperty(_AutoAccessor):
         offset += 20
         ba_merge(self.sharedMemorySize, ba, offset, 20)
         offset += 20
-        ba_merge(self.numberOfSegment, ba, offset, 10)
+        ba_merge(self.segments, ba, offset, 10)
         offset += 10
         offset += 228
         ba_merge(self.incomingDelayDepth, ba, offset, 10)
@@ -1020,7 +1107,7 @@ class ILQueueProperty(_AutoAccessor):
             + str(self.sharedMemorySize)
             + "bytes)\n"
             + "\tNUM-SEGMENT ("
-            + str(self.numberOfSegment)
+            + str(self.segments)
             + ") DELAY(over "
             + str(self.incomingDelayDepth)
             + "depth, "
@@ -2014,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`` 가 그 정보를 세션
@@ -2042,33 +2137,46 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
         uncommittedGet (int): 아직 커밋되지 않은 get 건수. 기본 0.
             스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
-        segments (list[SegmentItem]): **세그먼트별** 상세. 기본 빈 목록.
+        segmentInfoList (list[SegmentItem]): **세그먼트별** 상세. 기본 빈 목록.
+            목록이라 ``...List`` 접미를 쓴다 - 개수를 뜻하는 맨 복수형
+            (:attr:`ILQueueProperty.segments`)과 구별된다.
             스펙: 기본 빈 목록 · 범위 세그먼트 수만큼 · 변경 불가(ReadOnly).
-        partitions (list[SegmentItem]): ``segments`` 의 **옛 이름**. 읽기·쓰기 모두
+        partitions (list[SegmentItem]): ``segmentInfoList`` 의 **옛 이름**. 읽기·쓰기 모두
             같은 목록을 가리킨다. 엔진 7.x(SVN 3448)에서 큐의 저장 칸이
             "세그먼트" 가 되면서 이름이 갈렸다 - 토픽의 ``getPartitions()`` 는
-            **분산 단위**라 뜻이 다르다. **새 코드는** ``segments`` **를 쓴다.**
+            **분산 단위**라 뜻이 다르다. **새 코드는** ``segmentInfoList`` **를 쓴다.**
+            **이 이름은 영구히 세그먼트 목록을 가리킨다** - 다른 뜻으로
+            재사용하지 않는다.
             스펙: 별칭 · 와이어에는 이름이 실리지 않는다.
     """
 
+    #: 0.15.0 이 잠깐 쓴 이름. 그 판에서만 살았고 0.16.0 에서 ``segmentInfoList`` 가 됐다.
+    #: 이 이름을 비워 둔 덕에 :attr:`ILQueueProperty.segments`(세그먼트 **개수**)와
+    #: 겹치지 않는다 - 같은 이름이 클래스마다 다른 뜻이 되는 것을 막는다.
+    _RENAMED = {"segments": ("segmentInfoList", "0.16.0")}
+
     @property
     def partitions(self) -> "List[SegmentItem]":
-        """``segments`` 의 **옛 이름**. 같은 목록을 가리킨다.
+        """``segmentInfoList`` 의 **옛 이름**. 같은 목록을 가리킨다.
 
         Returns:
-            list[SegmentItem]: ``segments`` 와 같은 목록 객체.
+            list[SegmentItem]: ``segmentInfoList`` 와 같은 목록 객체.
 
         Note:
             :class:`_AutoAccessor` 가 만들어 주는 ``getPartitions()`` /
             ``setPartitions()`` 도 이 별칭을 통과한다. **토픽의**
             ``ILTopic.getPartitions()`` **와 이름은 같지만 뜻이 다르다** -
             저쪽은 분산 처리 단위고 이쪽은 한 노드 안의 저장 칸이다.
+
+            **이 별칭은 영구히 세그먼트 목록을 가리킨다.** 큐에 분산 파티션이
+            생겨도 이 이름을 그쪽으로 돌리지 않는다 - 그러면 옛 코드가 조용히
+            다른 것을 읽는다.
         """
-        return self.segments
+        return self.segmentInfoList
 
     @partitions.setter
     def partitions(self, value: "List[SegmentItem]") -> None:
-        self.segments = value
+        self.segmentInfoList = value
 
     # [spec-check] 문자열 상한 = 와이어 폭 - 1 (엔진이 C 문자열로 읽는다)
     _SPEC = {
@@ -2097,7 +2205,7 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         self.numberOfChannel = 0
         self.uncommittedPut = 0
         self.uncommittedGet = 0
-        self.segments: List[SegmentItem] = []
+        self.segmentInfoList: List[SegmentItem] = []
 
         if ba is None:
             return
@@ -2137,7 +2245,7 @@ class ILQueueRealTimeInfo(_AutoAccessor):
                 item = SegmentItem(
                     ba_pick_bytes(ba, offset, ILC.MIMQ_VO_SEGMENT_ITEM_LEN)
                 )
-                self.segments.append(item)
+                self.segmentInfoList.append(item)
                 offset += ILC.MIMQ_VO_SEGMENT_ITEM_LEN
         except Exception as exc:
             raise ILException(exc) from exc
@@ -2153,8 +2261,8 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             일은 거의 없다.
         """
         buffer_length = ILC.MIMQ_VO_QUEUE_INFO_LEN + ILC.MIMQ_LIST_ITEM_COUNT_LENGTH
-        if self.segments:
-            buffer_length += len(self.segments) * ILC.MIMQ_VO_SEGMENT_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)
@@ -2177,9 +2285,9 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         offset += 10
         ba_merge(self.uncommittedGet, ba, offset, 10)
         offset += 10
-        ba_merge(len(self.segments), ba, offset, 5)
+        ba_merge(len(self.segmentInfoList), ba, offset, 5)
         offset += 5
-        for item in self.segments:
+        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)
@@ -2205,7 +2313,7 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         ret += f"ACCESS(Client {self.numberOfClient}, Channel {self.numberOfChannel})\n"
         ret += f"TRANSACTED(Put {self.uncommittedPut}, Get {self.uncommittedGet})\n"
         ret += "Segments ---------------------------------------------------------\n"
-        for segment in self.segments:
+        for segment in self.segmentInfoList:
             ret += "  " + str(segment)
         return ret
 
@@ -2225,7 +2333,7 @@ class ILQueueRealTimeInfo(_AutoAccessor):
             (6.3.3 에서 별도 조회로 분리됐다). 그래서 같은 응답으로 속성 객체와
             이 객체를 모두 채울 수 있다.
 
-            :attr:`segments` 는 **빈 목록**이 된다. 저장 칸 나누기는 6.3.3 에서
+            :attr:`segmentInfoList` 는 **빈 목록**이 된다. 저장 칸 나누기는 6.3.3 에서
             들어온 기능이라 구엔진 큐에는 세그먼트라는 개념 자체가 없다 - 누락이
             아니라 사실이다.
         """
@@ -2243,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.segments = []
+        info.segmentInfoList = []
         return info
 
 

{jetstream_api-0.15.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.15.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,32 @@ 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` 로 바뀝니다.** 값도 자리도 그대로이고 **이름만** 바뀝니다.

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

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