jetstream-api 0.3.0__tar.gz → 0.4.1__tar.gz

{jetstream_api-0.3.0/jetstream_api.egg-info → jetstream_api-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.3.0
+Version: 0.4.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
@@ -147,6 +147,53 @@ qmgr.reconnect()                  # 새 리더를 찾아 재접속
 > (`reconnect()` 직접 호출은 가능합니다). auto-commit 세션도 응답 유실 시점의 재시도로
 > **중복 put이 발생할 수 있습니다.**
 
+## 0.4.0 신규 - 관리 연결 하나로 pub/sub
+
+`ILAdminService`(관리 포트, 보통 9998) 연결만으로 토픽 발행·구독이 가능합니다.
+큐 관리자 리스너 포트에 따로 붙지 않아도 되므로, **방화벽이 관리 포트만 열린 환경**에서
+쓸 수 있습니다.
+
+> 엔진 v7.0.1 rev 3295 이상이 필요합니다.
+
+```python
+from ilink.admin import ILAdminService
+from ilink.exception import ILNoMsgException
+from ilink.topic import ILSubscribeOptions, ILTopic
+
+svc = ILAdminService()
+svc.connect("127.0.0.1", 9998, "admin-app")
+aq = svc.accessAdminQmgr("QM1")
+
+# 발행 - (offset, timestamp, partition)
+off, ts, part = aq.publish("ORDER.EVENT", b"payload", key="order-1")
+
+# 구독
+topic = aq.accessTopic("ORDER.EVENT")
+sub = topic.subscribe("audit", ILSubscribeOptions()
+                      .startMode(ILTopic.START_EARLIEST)
+                      .commitMode(ILTopic.COMMIT_MANUAL))
+try:
+    while True:
+        try:
+            msg = sub.read(3000)
+        except ILNoMsgException:
+            break
+        print(msg.get_offset(), msg.get_key(), msg.get_data_string())
+        sub.commit(msg)
+finally:
+    sub.close()
+```
+
+패턴(와일드카드) 구독도 같은 연결로 됩니다.
+
+```python
+ps = aq.accessPattern("ORDER.*").subscribe("audit")
+```
+
+> **제약**: 관리 연결에는 배치가 없어 **레코드 한 건에 한 번 왕복**합니다. 멱등 발행도
+> 지원되지 않습니다(acks=1 고정). 대량 처리나 중복 제거가 필요하면 리스너 포트에
+> `ILQmgr` 로 붙어 `ILTopicProducer` 를 쓰세요.
+
 ## 0.3.0 신규 - 허브-스포크 연결 전환 헬퍼
 
 허브에 접속해 스포크를 찾고 연결을 전환하는 세 단계를 한 번에 처리하는
@@ -218,7 +265,7 @@ sub = topic.assign("app1", [0, 2], ILTopic.START_EARLIEST)   # 수동 파티션
 
 ## 개발자 가이드 문서
 
-**공개 API 756개 전부에 한국어 docstring이 붙어 있습니다.** 편집기에서 함수 위에
+**공개 API 779개 전부에 한국어 docstring이 붙어 있습니다.** 편집기에서 함수 위에
 마우스를 올리거나 `help()`로 파라미터 타입·기본값·허용값·예외를 바로 확인할 수 있습니다.
 
 ```python

{jetstream_api-0.3.0 → jetstream_api-0.4.1}/README.md

@@ -101,6 +101,53 @@ qmgr.reconnect()                  # 새 리더를 찾아 재접속
 > (`reconnect()` 직접 호출은 가능합니다). auto-commit 세션도 응답 유실 시점의 재시도로
 > **중복 put이 발생할 수 있습니다.**
 
+## 0.4.0 신규 - 관리 연결 하나로 pub/sub
+
+`ILAdminService`(관리 포트, 보통 9998) 연결만으로 토픽 발행·구독이 가능합니다.
+큐 관리자 리스너 포트에 따로 붙지 않아도 되므로, **방화벽이 관리 포트만 열린 환경**에서
+쓸 수 있습니다.
+
+> 엔진 v7.0.1 rev 3295 이상이 필요합니다.
+
+```python
+from ilink.admin import ILAdminService
+from ilink.exception import ILNoMsgException
+from ilink.topic import ILSubscribeOptions, ILTopic
+
+svc = ILAdminService()
+svc.connect("127.0.0.1", 9998, "admin-app")
+aq = svc.accessAdminQmgr("QM1")
+
+# 발행 - (offset, timestamp, partition)
+off, ts, part = aq.publish("ORDER.EVENT", b"payload", key="order-1")
+
+# 구독
+topic = aq.accessTopic("ORDER.EVENT")
+sub = topic.subscribe("audit", ILSubscribeOptions()
+                      .startMode(ILTopic.START_EARLIEST)
+                      .commitMode(ILTopic.COMMIT_MANUAL))
+try:
+    while True:
+        try:
+            msg = sub.read(3000)
+        except ILNoMsgException:
+            break
+        print(msg.get_offset(), msg.get_key(), msg.get_data_string())
+        sub.commit(msg)
+finally:
+    sub.close()
+```
+
+패턴(와일드카드) 구독도 같은 연결로 됩니다.
+
+```python
+ps = aq.accessPattern("ORDER.*").subscribe("audit")
+```
+
+> **제약**: 관리 연결에는 배치가 없어 **레코드 한 건에 한 번 왕복**합니다. 멱등 발행도
+> 지원되지 않습니다(acks=1 고정). 대량 처리나 중복 제거가 필요하면 리스너 포트에
+> `ILQmgr` 로 붙어 `ILTopicProducer` 를 쓰세요.
+
 ## 0.3.0 신규 - 허브-스포크 연결 전환 헬퍼
 
 허브에 접속해 스포크를 찾고 연결을 전환하는 세 단계를 한 번에 처리하는
@@ -172,7 +219,7 @@ sub = topic.assign("app1", [0, 2], ILTopic.START_EARLIEST)   # 수동 파티션
 
 ## 개발자 가이드 문서
 
-**공개 API 756개 전부에 한국어 docstring이 붙어 있습니다.** 편집기에서 함수 위에
+**공개 API 779개 전부에 한국어 docstring이 붙어 있습니다.** 편집기에서 함수 위에
 마우스를 올리거나 `help()`로 파라미터 타입·기본값·허용값·예외를 바로 확인할 수 있습니다.
 
 ```python

{jetstream_api-0.3.0 → jetstream_api-0.4.1}/ilink/__init__.py

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