DefStream 0.1.5__tar.gz → 0.1.7__tar.gz

{defstream-0.1.5 → defstream-0.1.7}/DefStream.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.5
+Version: 0.1.7
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -124,6 +124,11 @@ class Add(
 
 ### 2. Worker 실행: `worker.py`
 
+`Worker`는 `DefStream.Broker.Connection`을 직접 받습니다.
+연결 계약은 `connect()`, `close()`만 요구하며, 워커 실행 시 내부에서
+`GetConsumer` 지원 여부를 검사합니다. 컨슈머를 생성할 수 없는 브로커는 `TypeError`를 발생시키며,
+워커 전용 연결 타입은 필요하지 않습니다.
+
 ```python
 from signal import SIGINT, signal
 
@@ -176,7 +181,7 @@ Worker가 실행 중인 상태에서 다른 터미널에서 실행하세요.
 
 ```python
 from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection
-from DefStream.Worker import request, send
+from DefStream.Worker import emit, request
 from tasks import Add
 
 
@@ -188,7 +193,7 @@ connection = Connection(Configuration(
 ))
 try:
   connection.connect()
-  message_id = send(
+  message_id = emit(
     {'a': 10, 'b': 20},
     task=Add,
     broker=connection,
@@ -209,7 +214,7 @@ finally:
 python client.py
 ```
 
-`send()`와 `request()`는 **각각 별도의 작업을 발행**합니다. 위 예제는 덧셈을 두 번 실행하며,
+`emit()`와 `request()`는 **각각 별도의 작업을 발행**합니다. 위 예제는 덧셈을 두 번 실행하며,
 `request()`의 결과는 `30`입니다. `request()`의 제한 시간은 초 단위이고,
 시간이 초과되어도 이미 전달된 작업은 취소되지 않습니다.
 
@@ -220,14 +225,20 @@ python client.py
 | 함수 | 역할 | 연결 관리 |
 | --- | --- | --- |
 | `declare(task=..., broker=...)` | 작업의 큐·구독 리소스 선언 | 호출자가 연결·종료 |
-| `send(body, task=..., broker=...)` | 작업 목적지로 단방향 메시지 발행 | 호출자가 연결·종료 |
+| `emit(body, task=..., broker=...)` | 작업 목적지로 단방향 메시지 발행 | 호출자가 연결·종료 |
 | `request(body, task=..., broker=..., timeout=5)` | 작업 결과를 동기 RPC로 요청 | 호출자가 연결·종료; RabbitMQ만 지원 |
 
 세 함수는 `DefStream.Worker`에서 가져옵니다. 전달된 연결을 자동으로 열거나 닫지 않으며,
-`send()`와 `request()`는 목적지를 자동 선언하지 않습니다.
+`emit()`와 `request()`는 목적지를 자동 선언하지 않습니다.
 수신 Worker 또는 별도의 준비 단계에서 먼저 `declare()`를 호출하세요.
 하나의 연결을 같은 소유 스레드에서 여러 발행에 재사용할 수 있습니다.
 
+세 함수 모두 공통 `Connection`을 받고, 내부에서 선언·발행·RPC 지원 여부를 확인합니다.
+지원하지 않는 기능은 `NotImplementedError`로 실패합니다.
+기존 작업 발행 함수와 연결의 `send`는 `emit`으로 이름이 바뀌었습니다.
+사용자 정의 브로커의 작업 발행 계약도 `TaskSender.send` 대신 `Emittable.emit`을 사용하세요.
+큐·Exchange·Stream의 저수준 `Sendable.send()`와 RPC `Callable.call()`은 그대로입니다.
+
 작업 본문은 **문자열 키를 가진 매핑**이어야 하며, 반환값은 어댑터가 직렬화할 수 있어야 합니다.
 하나의 Worker에서는 같은 큐에 여러 작업을 중복 등록할 수 없습니다.
 메시지 유형을 보고 여러 `Run` 중 하나를 고르는 방식이 아니라 큐별로 작업을 선택합니다.
@@ -245,7 +256,7 @@ from DefStream.Worker import (
   Run,
   declare,
   request,
-  send,
+  emit,
 )
 
 
@@ -270,7 +281,7 @@ declare(
   task=Add,
   broker=broker,
 )
-send(
+emit(
   {'a': 10, 'b': 20},
   task=Add,
   broker=broker,
@@ -310,6 +321,10 @@ result = request(
 브로커 리소스를 직접 사용할 때의 공통 메서드는 다음과 같습니다.
 모든 리소스가 모든 메서드를 지원하는 것은 아닙니다.
 
+연결의 `exchange()`·`queue()`·`stream()`·`consumer()` 지원 여부는 각각
+`GetExchange`·`GetQueue`·`GetStream`·`GetConsumer`로 `isinstance` 또는 `issubclass`
+검사할 수 있습니다. 이 계약들은 `DefStream.Broker`에서 가져옵니다.
+
 | 메서드 | 의미 | 제한 시간 단위 |
 | --- | --- | --- |
 | `send(body)` | 메시지 발행 | 어댑터별 설정 |
@@ -574,6 +589,11 @@ inspector = Inspector(
 Inspector 자체는 TLS를 제공하지 않으며 공개 웹 서버가 아닙니다.
 콘솔의 연결 팩터리는 호출마다 새 연결을 반환해야 하고 Worker 연결을 공유하면 안 됩니다.
 
+Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용합니다.
+이 계약의 `__call__() -> Connection`은 인자 없이 새 연결을 반환합니다.
+위의 `create_connection` 같은 함수나 람다도 그대로 전달할 수 있으며,
+클래스로 구현할 때는 `BrokerFactory`를 상속하고 `__call__`을 구현할 수 있습니다.
+
 ## 브로커 선택과 운영 주의사항
 
 | 기능 | RabbitMQ | Redis Streams |

{defstream-0.1.5 → defstream-0.1.7}/DefStream.egg-info/SOURCES.txt

@@ -14,6 +14,10 @@ issues/feature/1/README.md
 issues/feature/1/REQUIREMENTS.md
 issues/feature/1/TASK.md
 issues/feature/1/ci.refs.json
+issues/fix/3/IMPLEMENTS.md
+issues/fix/3/README.md
+issues/fix/3/REQUIREMENTS.md
+issues/fix/3/ci.refs.json
 sample/Broker/Sample.py
 sample/Worker/Sample.py
 sample/Worker/RabbitMQ/Client.py

{defstream-0.1.5 → defstream-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.5
+Version: 0.1.7
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -124,6 +124,11 @@ class Add(
 
 ### 2. Worker 실행: `worker.py`
 
+`Worker`는 `DefStream.Broker.Connection`을 직접 받습니다.
+연결 계약은 `connect()`, `close()`만 요구하며, 워커 실행 시 내부에서
+`GetConsumer` 지원 여부를 검사합니다. 컨슈머를 생성할 수 없는 브로커는 `TypeError`를 발생시키며,
+워커 전용 연결 타입은 필요하지 않습니다.
+
 ```python
 from signal import SIGINT, signal
 
@@ -176,7 +181,7 @@ Worker가 실행 중인 상태에서 다른 터미널에서 실행하세요.
 
 ```python
 from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection
-from DefStream.Worker import request, send
+from DefStream.Worker import emit, request
 from tasks import Add
 
 
@@ -188,7 +193,7 @@ connection = Connection(Configuration(
 ))
 try:
   connection.connect()
-  message_id = send(
+  message_id = emit(
     {'a': 10, 'b': 20},
     task=Add,
     broker=connection,
@@ -209,7 +214,7 @@ finally:
 python client.py
 ```
 
-`send()`와 `request()`는 **각각 별도의 작업을 발행**합니다. 위 예제는 덧셈을 두 번 실행하며,
+`emit()`와 `request()`는 **각각 별도의 작업을 발행**합니다. 위 예제는 덧셈을 두 번 실행하며,
 `request()`의 결과는 `30`입니다. `request()`의 제한 시간은 초 단위이고,
 시간이 초과되어도 이미 전달된 작업은 취소되지 않습니다.
 
@@ -220,14 +225,20 @@ python client.py
 | 함수 | 역할 | 연결 관리 |
 | --- | --- | --- |
 | `declare(task=..., broker=...)` | 작업의 큐·구독 리소스 선언 | 호출자가 연결·종료 |
-| `send(body, task=..., broker=...)` | 작업 목적지로 단방향 메시지 발행 | 호출자가 연결·종료 |
+| `emit(body, task=..., broker=...)` | 작업 목적지로 단방향 메시지 발행 | 호출자가 연결·종료 |
 | `request(body, task=..., broker=..., timeout=5)` | 작업 결과를 동기 RPC로 요청 | 호출자가 연결·종료; RabbitMQ만 지원 |
 
 세 함수는 `DefStream.Worker`에서 가져옵니다. 전달된 연결을 자동으로 열거나 닫지 않으며,
-`send()`와 `request()`는 목적지를 자동 선언하지 않습니다.
+`emit()`와 `request()`는 목적지를 자동 선언하지 않습니다.
 수신 Worker 또는 별도의 준비 단계에서 먼저 `declare()`를 호출하세요.
 하나의 연결을 같은 소유 스레드에서 여러 발행에 재사용할 수 있습니다.
 
+세 함수 모두 공통 `Connection`을 받고, 내부에서 선언·발행·RPC 지원 여부를 확인합니다.
+지원하지 않는 기능은 `NotImplementedError`로 실패합니다.
+기존 작업 발행 함수와 연결의 `send`는 `emit`으로 이름이 바뀌었습니다.
+사용자 정의 브로커의 작업 발행 계약도 `TaskSender.send` 대신 `Emittable.emit`을 사용하세요.
+큐·Exchange·Stream의 저수준 `Sendable.send()`와 RPC `Callable.call()`은 그대로입니다.
+
 작업 본문은 **문자열 키를 가진 매핑**이어야 하며, 반환값은 어댑터가 직렬화할 수 있어야 합니다.
 하나의 Worker에서는 같은 큐에 여러 작업을 중복 등록할 수 없습니다.
 메시지 유형을 보고 여러 `Run` 중 하나를 고르는 방식이 아니라 큐별로 작업을 선택합니다.
@@ -245,7 +256,7 @@ from DefStream.Worker import (
   Run,
   declare,
   request,
-  send,
+  emit,
 )
 
 
@@ -270,7 +281,7 @@ declare(
   task=Add,
   broker=broker,
 )
-send(
+emit(
   {'a': 10, 'b': 20},
   task=Add,
   broker=broker,
@@ -310,6 +321,10 @@ result = request(
 브로커 리소스를 직접 사용할 때의 공통 메서드는 다음과 같습니다.
 모든 리소스가 모든 메서드를 지원하는 것은 아닙니다.
 
+연결의 `exchange()`·`queue()`·`stream()`·`consumer()` 지원 여부는 각각
+`GetExchange`·`GetQueue`·`GetStream`·`GetConsumer`로 `isinstance` 또는 `issubclass`
+검사할 수 있습니다. 이 계약들은 `DefStream.Broker`에서 가져옵니다.
+
 | 메서드 | 의미 | 제한 시간 단위 |
 | --- | --- | --- |
 | `send(body)` | 메시지 발행 | 어댑터별 설정 |
@@ -574,6 +589,11 @@ inspector = Inspector(
 Inspector 자체는 TLS를 제공하지 않으며 공개 웹 서버가 아닙니다.
 콘솔의 연결 팩터리는 호출마다 새 연결을 반환해야 하고 Worker 연결을 공유하면 안 됩니다.
 
+Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용합니다.
+이 계약의 `__call__() -> Connection`은 인자 없이 새 연결을 반환합니다.
+위의 `create_connection` 같은 함수나 람다도 그대로 전달할 수 있으며,
+클래스로 구현할 때는 `BrokerFactory`를 상속하고 `__call__`을 구현할 수 있습니다.
+
 ## 브로커 선택과 운영 주의사항
 
 | 기능 | RabbitMQ | Redis Streams |

{defstream-0.1.5 → defstream-0.1.7}/README.en.md

@@ -93,6 +93,11 @@ declares an error queue to receive rejected messages.
 
 ### 2. Run the Worker: `worker.py`
 
+`Worker` accepts `DefStream.Broker.Connection` directly.
+The connection contract only requires `connect()` and `close()`. The worker checks
+for `GetConsumer` support internally when it runs. A broker that cannot create
+a consumer raises `TypeError`; no worker-specific connection type is needed.
+
 ```python
 from signal import SIGINT, signal
 
@@ -146,7 +151,7 @@ Run this in another terminal while the Worker is running.
 
 ```python
 from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection
-from DefStream.Worker import request, send
+from DefStream.Worker import emit, request
 from tasks import Add
 
 
@@ -158,7 +163,7 @@ connection = Connection(Configuration(
 ))
 try:
   connection.connect()
-  message_id = send(
+  message_id = emit(
     {'a': 10, 'b': 20},
     task=Add,
     broker=connection,
@@ -179,7 +184,7 @@ finally:
 python client.py
 ```
 
-`send()` and `request()` **each publish a separate task**. This example performs
+`emit()` and `request()` **each publish a separate task**. This example performs
 the addition twice; `request()` returns `30`. The request timeout is in seconds
 and does not cancel work that has already been delivered.
 
@@ -190,14 +195,21 @@ and does not cancel work that has already been delivered.
 | Function | Purpose | Connection ownership |
 | --- | --- | --- |
 | `declare(task=..., broker=...)` | Declare task queues and subscription resources | Caller connects and closes |
-| `send(body, task=..., broker=...)` | Publish a one-way message to a task | Caller connects and closes |
+| `emit(body, task=..., broker=...)` | Publish a one-way message to a task | Caller connects and closes |
 | `request(body, task=..., broker=..., timeout=5)` | Request a task result synchronously | Caller connects and closes; RabbitMQ only |
 
 Import these functions from `DefStream.Worker`. They do not connect or close
-the supplied connection. Neither `send()` nor `request()` declares destinations.
+the supplied connection. Neither `emit()` nor `request()` declares destinations.
 Call `declare()` in the receiving Worker's setup or a separate provisioning step.
 Reuse a connection for multiple publications on its owning thread.
 
+All three helpers accept the common `Connection` type and check declaration,
+emission, or RPC support internally. Unsupported operations raise `NotImplementedError`.
+The task helper and connection method previously named `send` are now named `emit`.
+Custom brokers should use `Emittable.emit` instead of `TaskSender.send` for task emission.
+Low-level `Sendable.send()` and RPC `Callable.call()` on queues, exchanges, and streams
+remain unchanged.
+
 Task bodies must be **mappings with string keys**. Return values must be
 serializable by the adapter. A Worker cannot register multiple tasks for the
 same queue: routing selects tasks by queue, not by a type field in the message.
@@ -215,7 +227,7 @@ from DefStream.Worker import (
   Run,
   declare,
   request,
-  send,
+  emit,
 )
 
 
@@ -240,7 +252,7 @@ declare(
   task=Add,
   broker=broker,
 )
-send(
+emit(
   {'a': 10, 'b': 20},
   task=Add,
   broker=broker,
@@ -282,6 +294,10 @@ result = request(
 The common resource operations below apply when accessing a broker directly.
 Not every resource supports every operation.
 
+Use `isinstance` or `issubclass` with `GetExchange`, `GetQueue`, `GetStream`,
+or `GetConsumer` to check whether a connection provides `exchange()`, `queue()`,
+`stream()`, or `consumer()`, respectively. Import these contracts from `DefStream.Broker`.
+
 | Method | Purpose | Timeout unit |
 | --- | --- | --- |
 | `send(body)` | Publish a message | Adapter configuration |
@@ -556,6 +572,11 @@ Inspector has no built-in TLS and is not a public web server.
 The console's connection factory must return a new connection on every call,
 never the Worker's connection.
 
+Console's `broker` parameter uses the `DefStream.Broker.BrokerFactory` contract.
+Its `__call__() -> Connection` takes no arguments and returns a new connection.
+Functions such as `create_connection` above and lambdas remain valid without changes.
+For a class-based factory, you can inherit `BrokerFactory` and implement `__call__`.
+
 ## Broker selection and operational considerations
 
 | Feature | RabbitMQ | Redis Streams |

{defstream-0.1.5 → defstream-0.1.7}/README.md

@@ -91,6 +91,11 @@ class Add(
 
 ### 2. Worker 실행: `worker.py`
 
+`Worker`는 `DefStream.Broker.Connection`을 직접 받습니다.
+연결 계약은 `connect()`, `close()`만 요구하며, 워커 실행 시 내부에서
+`GetConsumer` 지원 여부를 검사합니다. 컨슈머를 생성할 수 없는 브로커는 `TypeError`를 발생시키며,
+워커 전용 연결 타입은 필요하지 않습니다.
+
 ```python
 from signal import SIGINT, signal
 
@@ -143,7 +148,7 @@ Worker가 실행 중인 상태에서 다른 터미널에서 실행하세요.
 
 ```python
 from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection
-from DefStream.Worker import request, send
+from DefStream.Worker import emit, request
 from tasks import Add
 
 
@@ -155,7 +160,7 @@ connection = Connection(Configuration(
 ))
 try:
   connection.connect()
-  message_id = send(
+  message_id = emit(
     {'a': 10, 'b': 20},
     task=Add,
     broker=connection,
@@ -176,7 +181,7 @@ finally:
 python client.py
 ```
 
-`send()`와 `request()`는 **각각 별도의 작업을 발행**합니다. 위 예제는 덧셈을 두 번 실행하며,
+`emit()`와 `request()`는 **각각 별도의 작업을 발행**합니다. 위 예제는 덧셈을 두 번 실행하며,
 `request()`의 결과는 `30`입니다. `request()`의 제한 시간은 초 단위이고,
 시간이 초과되어도 이미 전달된 작업은 취소되지 않습니다.
 
@@ -187,14 +192,20 @@ python client.py
 | 함수 | 역할 | 연결 관리 |
 | --- | --- | --- |
 | `declare(task=..., broker=...)` | 작업의 큐·구독 리소스 선언 | 호출자가 연결·종료 |
-| `send(body, task=..., broker=...)` | 작업 목적지로 단방향 메시지 발행 | 호출자가 연결·종료 |
+| `emit(body, task=..., broker=...)` | 작업 목적지로 단방향 메시지 발행 | 호출자가 연결·종료 |
 | `request(body, task=..., broker=..., timeout=5)` | 작업 결과를 동기 RPC로 요청 | 호출자가 연결·종료; RabbitMQ만 지원 |
 
 세 함수는 `DefStream.Worker`에서 가져옵니다. 전달된 연결을 자동으로 열거나 닫지 않으며,
-`send()`와 `request()`는 목적지를 자동 선언하지 않습니다.
+`emit()`와 `request()`는 목적지를 자동 선언하지 않습니다.
 수신 Worker 또는 별도의 준비 단계에서 먼저 `declare()`를 호출하세요.
 하나의 연결을 같은 소유 스레드에서 여러 발행에 재사용할 수 있습니다.
 
+세 함수 모두 공통 `Connection`을 받고, 내부에서 선언·발행·RPC 지원 여부를 확인합니다.
+지원하지 않는 기능은 `NotImplementedError`로 실패합니다.
+기존 작업 발행 함수와 연결의 `send`는 `emit`으로 이름이 바뀌었습니다.
+사용자 정의 브로커의 작업 발행 계약도 `TaskSender.send` 대신 `Emittable.emit`을 사용하세요.
+큐·Exchange·Stream의 저수준 `Sendable.send()`와 RPC `Callable.call()`은 그대로입니다.
+
 작업 본문은 **문자열 키를 가진 매핑**이어야 하며, 반환값은 어댑터가 직렬화할 수 있어야 합니다.
 하나의 Worker에서는 같은 큐에 여러 작업을 중복 등록할 수 없습니다.
 메시지 유형을 보고 여러 `Run` 중 하나를 고르는 방식이 아니라 큐별로 작업을 선택합니다.
@@ -212,7 +223,7 @@ from DefStream.Worker import (
   Run,
   declare,
   request,
-  send,
+  emit,
 )
 
 
@@ -237,7 +248,7 @@ declare(
   task=Add,
   broker=broker,
 )
-send(
+emit(
   {'a': 10, 'b': 20},
   task=Add,
   broker=broker,
@@ -277,6 +288,10 @@ result = request(
 브로커 리소스를 직접 사용할 때의 공통 메서드는 다음과 같습니다.
 모든 리소스가 모든 메서드를 지원하는 것은 아닙니다.
 
+연결의 `exchange()`·`queue()`·`stream()`·`consumer()` 지원 여부는 각각
+`GetExchange`·`GetQueue`·`GetStream`·`GetConsumer`로 `isinstance` 또는 `issubclass`
+검사할 수 있습니다. 이 계약들은 `DefStream.Broker`에서 가져옵니다.
+
 | 메서드 | 의미 | 제한 시간 단위 |
 | --- | --- | --- |
 | `send(body)` | 메시지 발행 | 어댑터별 설정 |
@@ -541,6 +556,11 @@ inspector = Inspector(
 Inspector 자체는 TLS를 제공하지 않으며 공개 웹 서버가 아닙니다.
 콘솔의 연결 팩터리는 호출마다 새 연결을 반환해야 하고 Worker 연결을 공유하면 안 됩니다.
 
+Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용합니다.
+이 계약의 `__call__() -> Connection`은 인자 없이 새 연결을 반환합니다.
+위의 `create_connection` 같은 함수나 람다도 그대로 전달할 수 있으며,
+클래스로 구현할 때는 `BrokerFactory`를 상속하고 `__call__`을 구현할 수 있습니다.
+
 ## 브로커 선택과 운영 주의사항
 
 | 기능 | RabbitMQ | Redis Streams |

{defstream-0.1.5 → defstream-0.1.7}/issues/feature/1/README.md

@@ -7,7 +7,7 @@
 
 ## 변경 후 (TO-BE)
 
-지원 브로커의 작업 구독 설정에 기본·최대 우선순위를 정의하고, `send`와 `request`에서
+지원 브로커의 작업 구독 설정에 기본·최대 우선순위를 정의하고, `emit`과 `request`에서
 메시지별 우선순위를 재정의할 수 있습니다. 현재 지원 브로커는 RabbitMQ입니다.
 
 ## 사용 방법
@@ -20,7 +20,7 @@ RabbitMQ 작업의 `parameters`에 `Subscription(priority=2, max_priority=5, ...
 from DefStream.Worker import (
   declare,
   request,
-  send,
+  emit,
 )
 
 
@@ -31,7 +31,7 @@ declare(
 )
 
 # 호출값을 생략하면 작업 구독의 기본 우선순위를 사용합니다.
-send(
+emit(
   {'a': 1, 'b': 2},
   task=Add,
   broker=broker,