DefStream 0.1.18__tar.gz → 0.1.20__tar.gz

{defstream-0.1.18 → defstream-0.1.20}/DefStream.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.18
+Version: 0.1.20
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon

{defstream-0.1.18 → defstream-0.1.20}/DefStream.egg-info/SOURCES.txt

@@ -44,6 +44,19 @@ issues/feature/1/README.md
 issues/feature/1/REQUIREMENTS.md
 issues/feature/1/TASK.md
 issues/feature/1/ci.refs.json
+issues/feature/47/CHANGELOG.md
+issues/feature/47/IMPLEMENTS.md
+issues/feature/47/PLAN.md
+issues/feature/47/README.md
+issues/feature/47/REQUIREMENTS.md
+issues/feature/47/TASKS.md
+issues/feature/47/implements/1793271568985.md
+issues/feature/47/implements/1793272077065.md
+issues/feature/47/tasks/1793271236067.md
+issues/feature/47/tasks/1793271384432.md
+issues/feature/47/tasks/1793271506089.md
+issues/feature/47/tasks/1793271819682.md
+issues/feature/47/tasks/1793272077066.md
 issues/feature/8/IMPLEMENTS.md
 issues/feature/8/README.md
 issues/feature/8/REQUIREMENTS.md
@@ -90,6 +103,17 @@ issues/fix/41/tasks/1793256990072.md
 issues/fix/41/tasks/1793257216492.md
 issues/fix/41/tasks/1793257519899.md
 issues/fix/41/tasks/1793257826068.md
+issues/fix/43/CHANGELOG.md
+issues/fix/43/IMPLEMENTS.md
+issues/fix/43/PLAN.md
+issues/fix/43/README.md
+issues/fix/43/REQUIREMENTS.md
+issues/fix/43/TASKS.md
+issues/fix/43/implements/1793260818660.md
+issues/fix/43/implements/1793261447018.md
+issues/fix/43/tasks/1793260818661.md
+issues/fix/43/tasks/1793261447019.md
+issues/fix/43/tasks/1793262314955.md
 issues/fix/6/IMPLEMENTS.md
 issues/fix/6/README.md
 issues/fix/6/REQUIREMENTS.md
@@ -129,7 +153,6 @@ src/Broker/Connection.py
 src/Broker/Consumer.py
 src/Broker/Errors.py
 src/Broker/Event.py
-src/Broker/Policies.py
 src/Broker/Priority.py
 src/Broker/Protocol.py
 src/Broker/__init__.py
@@ -139,7 +162,6 @@ src/Broker/Implements/RabbitMQ/Connection.py
 src/Broker/Implements/RabbitMQ/Consumer.py
 src/Broker/Implements/RabbitMQ/Event.py
 src/Broker/Implements/RabbitMQ/Exchange.py
-src/Broker/Implements/RabbitMQ/Policies.py
 src/Broker/Implements/RabbitMQ/Queue.py
 src/Broker/Implements/RabbitMQ/Serializer.py
 src/Broker/Implements/RabbitMQ/Stream.py
@@ -161,10 +183,10 @@ src/Inspector/Extension.py
 src/Inspector/Inspector.py
 src/Inspector/Response.py
 src/Inspector/__init__.py
-src/Inspector/Extensions/Console.html
-src/Inspector/Extensions/Console.py
 src/Inspector/Extensions/Metrics.py
 src/Inspector/Extensions/Ping.py
+src/Inspector/Extensions/Play.html
+src/Inspector/Extensions/Play.py
 src/Inspector/Extensions/Specifications.py
 src/Inspector/Extensions/Status.html
 src/Inspector/Extensions/Status.py
@@ -193,11 +215,12 @@ src/Worker/Specification.py
 src/Worker/Startup.py
 src/Worker/Worker.py
 src/Worker/__init__.py
+tests/_support.py
 tests/test_broker_packaging.py
 tests/test_descriptor.py
 tests/test_inspector.py
-tests/test_inspector_console.py
 tests/test_inspector_logging.py
+tests/test_inspector_play.py
 tests/test_lifecycle_hooks.py
 tests/test_logging.py
 tests/test_pool_callbacks.py
@@ -209,6 +232,7 @@ tests/test_rabbitmq_logging.py
 tests/test_rabbitmq_priorities.py
 tests/test_rabbitmq_rpc.py
 tests/test_rabbitmq_rpc_integration.py
+tests/test_rabbitmq_timeouts.py
 tests/test_rabbitmq_worker.py
 tests/test_redis.py
 tests/test_redis_integration.py

{defstream-0.1.18 → defstream-0.1.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.18
+Version: 0.1.20
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon

{defstream-0.1.18 → defstream-0.1.20}/docs/Contracts.en.md

@@ -171,5 +171,5 @@ Validation exceptions are task failures and follow error hooks and the `on_error
 policy. The example's `Reject()` avoids endlessly retrying invalid inputs.
 To preserve failures in a DLQ, also configure `Subscription(error=...)` and
 provision it through `declare()`. Schemas and examples appear in Inspector's
-AsyncAPI and console; custom Validator patterns are not automatically
+AsyncAPI and Play; custom Validator patterns are not automatically
 reverse-engineered into JSON Schema.

{defstream-0.1.18 → defstream-0.1.20}/docs/Contracts.md

@@ -146,7 +146,7 @@ class Add(
 검증 예외는 작업 실패로 처리되어 오류 훅과 `on_error` 정책을 따릅니다.
 예제의 `Reject()`는 잘못된 입력을 무한 재시도하지 않게 합니다. DLQ에 보관하려면
 `Subscription(error=...)`도 지정하고 `declare()`로 해당 큐를 준비하세요.
-스키마·예제는 Inspector의 AsyncAPI와 콘솔에 표시되며,
+스키마·예제는 Inspector의 AsyncAPI와 Play에 표시되며,
 사용자 정의 Validator 패턴을 자동으로 JSON Schema로 역변환하지는 않습니다.
 
 ```mermaid

{defstream-0.1.18 → defstream-0.1.20}/docs/Operations.en.md

@@ -4,7 +4,7 @@
 
 Inspector tools, logging, and broker selection.
 
-## Health checks and task console
+## Health checks and Play
 
 Inspector is optional and uses a Python standard-library HTTP server.
 Configure it before starting the Worker and pass `Worker(..., inspector=inspector)`.
@@ -13,7 +13,7 @@ This snippet reuses the `Connection` and `Configuration` imports from `worker.py
 ```python
 from DefStream.Inspector import Inspector
 from DefStream.Inspector.Extensions import (
-  Console,
+  Play,
   Metrics,
   Ping,
   Specifications,
@@ -38,8 +38,8 @@ inspector = Inspector(
     Metrics('/metrics'),
     Status('/status'),
     Specifications('/asyncapi.json'),
-    Console(
-      '/console',
+    Play(
+      '/play',
       broker=create_connection,
       title='DefStream',
     ),
@@ -53,7 +53,7 @@ inspector = Inspector(
 | `/metrics` | Prometheus metrics with the `defstream_` prefix |
 | `/status` | Successes, failures, throughput, and duration; register with exactly one `Metrics` |
 | `/asyncapi.json` | Registered task request/reply contracts as AsyncAPI JSON |
-| `/console` | Browse tasks and schemas, send JSON messages, and execute RPC on supported brokers |
+| `/play` | Browse tasks and schemas, send JSON messages, and execute RPC on supported brokers |
 
 There are no default routes. Metrics describe one Worker and reset on restart.
 Execution counts include retries and hooks, not unique messages or ACKs.
@@ -67,22 +67,26 @@ flowchart LR
   I --> M[Prometheus metrics]
   I --> S[Status endpoint]
   I --> A[AsyncAPI document]
-  I --> C[Task console]
+  I --> C[Play task execution]
   C --> F[BrokerFactory]
   F --> B[New broker connection per use]
 ```
 
-**Restrict access.** The console example above publishes real tasks without
+The `Console` extension has been renamed to `Play`. Update existing imports and
+class usages to `Play`. The example above uses `/play`, but you can keep your
+configured URL path. The extension logger is now `Worker.Inspector.Play`.
+
+**Restrict access.** The Play example above publishes real tasks without
 authentication. For authentication, pass a random token of at least 16 characters
-using `Console(token=...)` and enter it in the browser. Load the token from an
+using `Play(token=...)` and enter it in the browser. Load the token from an
 environment variable or secret store. Other built-in endpoints remain
 unauthenticated: bind to loopback or a trusted management network, and use an
 HTTPS reverse proxy with additional access control for remote access.
 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,
+Play'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.
+Play'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__`.
@@ -92,14 +96,19 @@ For a class-based factory, you can inherit `BrokerFactory` and implement `__call
 
 DefStream records messages through standard `logging` without configuring handlers,
 formatters, or levels. Select the sources your application needs. The samples
-output only the `Sample` and `DefStream` logger hierarchies, replacing their
+output only the `Sample`, `Worker`, `Task`, and `Broker` logger hierarchies, replacing their
 `print()` calls with logging. The Worker's existing startup banner is still
 printed regardless of logging configuration.
 
 ```python
 from logging import DEBUG, Filter, Formatter, StreamHandler, getLogger
 
-sources = (Filter('Sample'), Filter('DefStream'))
+sources = (
+  Filter('Sample'),
+  Filter('Worker'),
+  Filter('Task'),
+  Filter('Broker'),
+)
 handler = StreamHandler()
 handler.setFormatter(Formatter(
   '%(asctime)s %(processName)s %(name)s %(levelname)s %(message)s'
@@ -113,24 +122,28 @@ logger = getLogger('Sample')
 logger.info('Application started')
 ```
 
-Apply filters to the **handler**, not the root logger. `Filter('DefStream')`
-includes `DefStream` and names below `DefStream.`, but not `DefStreamExtra`.
+Apply filters to the **handler**, not the root logger. `Filter('Worker')`
+includes `Worker` and names below `Worker.`, but not `WorkerExtra`.
+Broker loggers use the separate `Broker` hierarchy and are not included by a
+`Worker` filter.
 This configuration is an example for a standalone application; it does not change
 output from other handlers already installed. To receive only broker logs, select
-`DefStream.Broker.RabbitMQ` or `DefStream.Broker.Implements.Redis`
-instead of `DefStream`.
+`Broker.RabbitMQ` or `Broker.Redis`.
 
-- The class member `logger` uses `DefStream.Worker`, `DefStream.Run`,
-  `DefStream.Executor`, `DefStream.Pool`, `DefStream.ThreadPool`, and
-  `DefStream.ProcessPool`.
+- The `Worker` and `Run` loggers use `Worker` and `Task`, respectively.
+  `Executor`, `Pool`, `ThreadPool`, and `ProcessPool` use the `Worker` hierarchy.
 - Shared Pool methods also use the concrete pool's logger member. User subclasses
   inherit the default name and can explicitly override `logger`.
-- Inspector, Server, and RequestHandler share `DefStream.Inspector`.
+- Inspector, Server, and RequestHandler share `Worker.Inspector`.
   HTTP request receipt is DEBUG; response status and transmission results are INFO.
-  Extension-specific logs use `DefStream.Inspector.Extensions.<extension name>`.
+  Extension-specific logs use `Worker.Inspector.<extension name>`.
 - Normal per-message processing is DEBUG, lifecycle events are INFO, events
   requiring attention are WARNING, and processing failures are ERROR.
   Bodies, results, and credentials are excluded from the default log context.
+- RabbitMQ and Redis broker loggers use the `Broker.RabbitMQ` and `Broker.Redis`
+  hierarchies. Update filters and handlers that use the former `DefStream.Broker...` names.
+- Worker logs use the `Worker` and `Task` hierarchies, while Inspector logs use
+  `Worker.Inspector`. Update filters and handlers configured with former `DefStream.*` names.
 - Without any handlers, Python's `lastResort` may write WARNING and higher to
   stderr. Do not put sensitive values in user exception messages: failure
   tracebacks include those messages.

{defstream-0.1.18 → defstream-0.1.20}/docs/Operations.md

@@ -4,7 +4,7 @@
 
 Inspector, 로깅 및 브로커 선택 시 고려사항입니다.
 
-## 상태 확인과 작업 콘솔
+## 상태 확인과 Play
 
 선택 기능인 Inspector는 Python 표준 라이브러리 HTTP 서버를 사용합니다.
 다음 코드를 Worker 실행 전에 구성하고 `Worker(..., inspector=inspector)`로 전달하세요.
@@ -13,7 +13,7 @@ Inspector, 로깅 및 브로커 선택 시 고려사항입니다.
 ```python
 from DefStream.Inspector import Inspector
 from DefStream.Inspector.Extensions import (
-  Console,
+  Play,
   Metrics,
   Ping,
   Specifications,
@@ -38,8 +38,8 @@ inspector = Inspector(
     Metrics('/metrics'),
     Status('/status'),
     Specifications('/asyncapi.json'),
-    Console(
-      '/console',
+    Play(
+      '/play',
       broker=create_connection,
       title='DefStream',
     ),
@@ -53,7 +53,7 @@ inspector = Inspector(
 | `/metrics` | `defstream_` 접두사의 Prometheus 지표 |
 | `/status` | 처리 성공·실패·처리량·소요 시간. `Metrics` 하나와 함께 등록 |
 | `/asyncapi.json` | 등록 작업의 요청·응답 계약을 AsyncAPI JSON으로 제공 |
-| `/console` | 작업 목록·스키마 조회, JSON 메시지 발행, 지원 브로커의 RPC 실행 |
+| `/play` | 작업 목록·스키마 조회, JSON 메시지 발행, 지원 브로커의 RPC 실행 |
 
 기본으로 등록되는 경로는 없습니다. 지표는 한 Worker 기준이며 재시작 시 초기화됩니다.
 처리 횟수는 재시도와 훅을 포함한 실행 시도 기준이지 고유 메시지 수나 ACK 수가 아닙니다.
@@ -67,20 +67,24 @@ flowchart LR
   I --> M[Prometheus 지표]
   I --> S[상태 경로]
   I --> A[AsyncAPI 문서]
-  I --> C[작업 콘솔]
+  I --> C[Play 작업 실행]
   C --> F[BrokerFactory]
   F --> B[사용할 때마다 새 브로커 연결]
 ```
 
-**접근을 제한하세요.** 위 콘솔 예제는 인증 없이 실제 작업을 발행합니다.
-인증이 필요하면 `Console`에 `token=`으로 무작위 16자 이상 토큰을 전달하고,
+`Console` 확장은 `Play`로 이름이 변경되었습니다. 기존 import와 클래스 사용을
+`Play`로 변경하세요. 위 예제는 `/play`를 사용하지만 직접 지정한 URL 경로는 유지할 수 있습니다.
+확장 로거 이름은 `Worker.Inspector.Play`입니다.
+
+**접근을 제한하세요.** 위 Play 예제는 인증 없이 실제 작업을 발행합니다.
+인증이 필요하면 `Play`에 `token=`으로 무작위 16자 이상 토큰을 전달하고,
 브라우저에서 입력하세요. 토큰은 환경변수나 비밀 저장소에서 읽으세요.
 다른 기본 엔드포인트는 인증되지 않으므로 신뢰할 수 있는 관리망이나 루프백에만 바인딩하고,
 원격 접근은 HTTPS 역방향 프록시 및 별도 접근 제어를 사용하세요.
 Inspector 자체는 TLS를 제공하지 않으며 공개 웹 서버가 아닙니다.
-콘솔의 연결 팩터리는 호출마다 새 연결을 반환해야 하고 Worker 연결을 공유하면 안 됩니다.
+Play의 연결 팩터리는 호출마다 새 연결을 반환해야 하고 Worker 연결을 공유하면 안 됩니다.
 
-Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용합니다.
+Play의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용합니다.
 이 계약의 `__call__() -> Connection`은 인자 없이 새 연결을 반환합니다.
 위의 `create_connection` 같은 함수나 람다도 그대로 전달할 수 있으며,
 클래스로 구현할 때는 `BrokerFactory`를 상속하고 `__call__`을 구현할 수 있습니다.
@@ -89,14 +93,19 @@ Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용
 ## 로깅
 
 DefStream은 표준 `logging`으로 기록하며 핸들러·포매터·레벨을 설정하지 않습니다.
-애플리케이션에서 필요한 출처만 선택해 출력하세요. 샘플은 `Sample`과 `DefStream`
-이름 및 그 하위 로거만 출력하며, 샘플의 `print()`는 로그로 대체했습니다.
+애플리케이션에서 필요한 출처만 선택해 출력하세요. 샘플은 `Sample`, `Worker`, `Task`,
+`Broker` 이름 및 그 하위 로거만 출력하며, 샘플의 `print()`는 로그로 대체했습니다.
 Worker의 기존 시작 배너는 로깅 설정과 무관하게 그대로 출력됩니다.
 
 ```python
 from logging import DEBUG, Filter, Formatter, StreamHandler, getLogger
 
-sources = (Filter('Sample'), Filter('DefStream'))
+sources = (
+  Filter('Sample'),
+  Filter('Worker'),
+  Filter('Task'),
+  Filter('Broker'),
+)
 handler = StreamHandler()
 handler.setFormatter(Formatter(
   '%(asctime)s %(processName)s %(name)s %(levelname)s %(message)s'
@@ -110,21 +119,25 @@ logger = getLogger('Sample')
 logger.info('Application started')
 ```
 
-필터는 루트 로거가 아닌 **핸들러**에 적용합니다. `Filter('DefStream')`은
-`DefStream`과 `DefStream.` 하위 이름을 포함하지만 `DefStreamExtra`는 포함하지 않습니다.
+필터는 루트 로거가 아닌 **핸들러**에 적용합니다. `Filter('Worker')`는
+`Worker`와 `Worker.` 하위 이름을 포함하지만 `WorkerExtra`는 포함하지 않습니다.
+브로커 로그는 `Broker` 계층을 사용하므로 `Worker` 필터에 포함되지 않습니다.
 위 설정은 독립 실행 애플리케이션을 위한 예제이며, 이미 있는 다른 핸들러의 출력은 바꾸지 않습니다.
-브로커만 보고 싶으면 `DefStream` 대신 `DefStream.Broker.RabbitMQ` 또는
-`DefStream.Broker.Implements.Redis`를 선택할 수 있습니다.
+브로커만 보고 싶으면 `Broker.RabbitMQ` 또는 `Broker.Redis`를 선택할 수 있습니다.
 
-- 클래스 멤버 `logger`에 `DefStream.Worker`, `DefStream.Run`, `DefStream.Executor`,
-  `DefStream.Pool`, `DefStream.ThreadPool`, `DefStream.ProcessPool`을 사용합니다.
+- `Worker`와 `Run`의 `logger`는 각각 `Worker`와 `Task`를 사용합니다.
+  `Executor`, `Pool`, `ThreadPool`, `ProcessPool`의 로거는 `Worker` 계층을 사용합니다.
 - Pool 공통 메서드도 실제 풀의 로거 멤버를 사용합니다. 사용자 하위 클래스는 기본 이름을
   상속하며 원하면 `logger`를 명시적으로 재정의할 수 있습니다.
-- Inspector·Server·RequestHandler는 `DefStream.Inspector`를 공유합니다.
+- Inspector·Server·RequestHandler는 `Worker.Inspector`를 공유합니다.
   HTTP 요청 수신은 DEBUG, 응답 상태와 전송 결과는 INFO입니다.
-  확장 고유 로그는 `DefStream.Inspector.Extensions.<확장 이름>`을 사용합니다.
+  확장 고유 로그는 `Worker.Inspector.<확장 이름>`을 사용합니다.
 - 정상 메시지별 처리 흐름은 DEBUG, 생명주기는 INFO, 주의할 사건은 WARNING,
   처리 실패는 ERROR로 기록합니다. 본문·결과·인증정보는 기본 로그에 포함하지 않습니다.
+- RabbitMQ와 Redis 브로커 로그는 각각 `Broker.RabbitMQ`와 `Broker.Redis` 이름 계층을
+  사용합니다. 기존 `DefStream.Broker...` 이름으로 구성한 필터·핸들러는 새 이름에 맞춰야 합니다.
+- Worker 로그는 `Worker` 및 `Task` 계층을, Inspector 로그는 `Worker.Inspector` 계층을
+  사용합니다. 기존 `DefStream.*` 이름에 의존한 필터·핸들러를 새 이름에 맞춰 갱신하세요.
 - 핸들러가 전혀 없으면 Python의 `lastResort`에 의해 WARNING 이상이 stderr에 나올 수 있습니다.
   사용자 예외 메시지에는 민감한 값을 넣지 마세요. 실패 traceback에 예외 메시지가 포함됩니다.
 

{defstream-0.1.18 → defstream-0.1.20}/docs/RabbitMQ.en.md

@@ -47,18 +47,20 @@ discarded when none is configured.
 ### Logging
 
 `Connection`, `Consumer`, `Queue`, `Exchange`, `Stream`, and `Event` expose a class
-member `logger` named `DefStream.Broker.RabbitMQ.ClassName`; the logger name differs
+member `logger` named `Broker.RabbitMQ.ClassName`; the logger name differs
 from the module path `DefStream.Broker.Implements.RabbitMQ`. Subclasses
 inherit that logger unless they explicitly override it. The library adds no handlers
 (including `NullHandler`), levels, or filters; propagation and `logging.lastResort`
 keep their standard behavior.
+Update filters or handlers configured for the former `DefStream.Broker.RabbitMQ`
+names to use `Broker.RabbitMQ`.
 
 The RabbitMQ implementation does not log normal operation at INFO.
 Connection attempts, successful connects and closes, successful queue/exchange/stream
 declaration, deletion, and binding, consumer subscription, channel close, and
 consumption-loop lifecycle events, and per-message/RPC/settlement tracing all use DEBUG,
 so opening and closing a connection per task does not add INFO records.
-Worker start, readiness, and shutdown remain visible at INFO through the `DefStream.Worker` logger.
+Worker start, readiness, and shutdown remain visible at INFO through the `Worker` logger.
 Expected RPC anomalies use WARNING, and internal I/O or codec failures, including
 failed connection and resource operations, use ERROR.
 Payloads, results, headers, credentials, exception text, and tracebacks are omitted.
@@ -68,9 +70,10 @@ timeout does not cancel delivered work.
 
 The Python samples configure a root DEBUG console handler only in their main entry
 points. Its filter accepts `Filter('Sample')` **or**
-`Filter('DefStream.Broker.RabbitMQ')`, including dotted descendants only;
+`Filter('Broker.RabbitMQ')`, including dotted descendants only;
 Pika and core logs are excluded. Applications configure their own handlers, levels,
-and filters at a chosen ancestor (`DefStream`, `DefStream.Broker`, etc.) or class.
+and filters at `Broker`, `Broker.RabbitMQ`, or a class name. Broker loggers are
+outside the `DefStream` hierarchy; use `DefStream` separately for core logs.
 
 ### Connection configuration
 
@@ -167,11 +170,53 @@ the selected failure policy on error. Omitting `on_error` defaults to `Requeue()
 - `max_priority`: maximum priority for a classic task queue; an integer in `1..255` or `None`.
 - `priority`: default message priority; an integer in `0..max_priority` or `None`.
   Setting only this value sets `max_priority` to `255`.
+- `timeout`: per-queue ACK waiting limit; a positive `int` in milliseconds,
+  a positive `datetime.timedelta` with whole-millisecond precision, or `None`.
+  Omitting it leaves the broker's existing settings in effect.
 
 Constructing a `Subscription` or calling `consumer.subs()` does not declare queues.
 Task `declare()` provisions ordinary durable queues and an optional DLQ,
-not stream queues or Exchange bindings. Incompatible existing queue options
-fail explicitly; queues are not automatically deleted and recreated.
+not stream queues or Exchange bindings. Declaration errors caused by incompatible
+queue options propagate; queues are not automatically deleted and recreated.
+
+### ACK waiting limits for long-running tasks
+
+On RabbitMQ 3.12 or later, setting `Subscription.timeout` makes task `declare()`
+pass `x-consumer-timeout` to the task queue as integer milliseconds, not to the error queue.
+In the preceding Worker example, define this task and replace `worker.add(Add)`
+with `worker.add(LongRunningAdd)`. The existing `Prepare` declares the queue.
+
+```python
+from datetime import timedelta
+
+
+class LongRunningAdd(
+  Add,
+  parameters=Subscription(
+    queue='defstream.example.rabbitmq.long.add',
+    error='defstream.example.rabbitmq.long.add.error',
+    timeout=timedelta(hours=24),
+  ),
+):
+  pass
+```
+
+This setting passes `x-consumer-timeout=86400000`.
+Passing integer milliseconds as `timeout=86400000` is equivalent.
+`Subscription.timeout` is normalized to integer milliseconds during construction.
+A Mapping such as `Subscription.parse({'queue': 'tasks', 'timeout': timedelta(hours=24)})`
+is also supported. Omitting the value or passing `None` omits this queue argument.
+
+- `bool` and types other than `int` or `timedelta` raise `TypeError`. Zero, negative durations, or
+  sub-millisecond precision raise `ValueError`. Values are not silently rounded or truncated.
+- Constructing or subscribing does not apply the setting. Explicit task queue declaration is required.
+- This is not a task execution deadline. ACK after completion, failure policies, and prefetch
+  remain unchanged. The RPC response waiting timeout is separate.
+- Changing or recreating existing queues and applying policies are the operator's responsibility.
+
+According to the [RabbitMQ ACK timeout guide](https://www.rabbitmq.com/docs/3.13/consumers#acknowledgement-timeout),
+values below one minute are unsupported and values below five minutes are not recommended.
+Checks run approximately once per minute, so do not use this as a precise execution deadline.
 
 ### Worker task priorities
 

{defstream-0.1.18 → defstream-0.1.20}/docs/RabbitMQ.md

@@ -61,28 +61,31 @@ finally:
 
 ### 로깅
 
-여섯 클래스는 `DefStream.Broker.RabbitMQ.ClassName` 이름의 클래스 멤버
+여섯 클래스는 `Broker.RabbitMQ.ClassName` 이름의 클래스 멤버
 `logger`를 사용합니다(`Connection`, `Consumer`, `Queue`, `Exchange`, `Stream`, `Event`).
 로거 이름은 모듈 경로(`DefStream.Broker.Implements.RabbitMQ`)와 다릅니다.
 하위 클래스는 같은 로거를 상속하며 필요하면 멤버를 재정의할 수 있습니다.
 라이브러리는 핸들러·`NullHandler`·레벨·필터를 설정하지 않고 루트로 전파합니다.
 미설정 시 표준 `logging.lastResort` 동작을 유지합니다.
+기존 `DefStream.Broker.RabbitMQ` 이름으로 필터나 핸들러를 설정했다면
+`Broker.RabbitMQ`로 갱신하세요.
 
 RabbitMQ 구현은 정상 동작을 INFO로 기록하지 않습니다.
 연결 시도·성공·종료, 큐·Exchange·Stream 선언·삭제·바인딩 성공, Consumer의 구독 적용·채널 종료·소비 루프 생명주기,
 메시지·RPC·정산 추적은 모두 DEBUG입니다.
 작업마다 연결을 열고 닫아도 INFO 로그가 늘어나지 않습니다.
-Worker 시작·준비·종료 같은 실행 생명주기는 `DefStream.Worker` 로거의 INFO로 확인할 수 있습니다.
+Worker 시작·준비·종료 같은 실행 생명주기는 `Worker` 로거의 INFO로 확인할 수 있습니다.
 RPC 시간 초과·원격 오류·응답 라우팅 불가는 WARNING, 연결·자원 작업 실패를 포함한 내부 I/O·코덱 오류는 ERROR입니다.
 본문·결과·헤더·인증정보와 예외 문자열·traceback은 기록하지 않으며 예외는 그대로 전파합니다.
 애플리케이션이 같은 예외를 다시 기록하면 중복될 수 있습니다.
 발행 API 반환은 소비자 처리 완료가 아니며, RPC 응답 시간 초과도 전달된 작업을 취소하지 않습니다.
 
 `samples/Broker/RabbitMQ/*.py`는 실행 진입점에서만 루트 DEBUG 콘솔 출력을 구성합니다.
-핸들러의 `Filter('Sample')` 또는 `Filter('DefStream.Broker.RabbitMQ')`
+핸들러의 `Filter('Sample')` 또는 `Filter('Broker.RabbitMQ')`
 통과 조건으로 두 이름과 점으로 구분된 하위 로거만 출력하며 Pika·코어 등은 제외합니다.
-다른 애플리케이션에서는 원하는 상위 이름(`DefStream`, `DefStream.Broker` 등)이나
-클래스 이름을 선택하고 핸들러·레벨·필터를 직접 구성하세요.
+브로커 로거는 `DefStream` 계층 밖에 있으므로 다른 애플리케이션에서는 `Broker`,
+`Broker.RabbitMQ` 또는 클래스 이름으로 선택하세요. `DefStream`은 Worker 등
+코어 로거를 선택할 때 사용합니다.
 
 ### Worker로 작업 처리하기
 
@@ -162,11 +165,52 @@ Worker는 실행과 완료 훅이 끝난 뒤 ACK하고, 실패하면 지정한
 - `max_priority`: classic 작업 큐의 최대 우선순위. 정수 `1..255` 또는 `None`.
 - `priority`: 기본 메시지 우선순위. 정수 `0..max_priority` 또는 `None`.
   이 값만 지정하면 `max_priority`는 `255`로 설정됩니다.
+- `timeout`: 큐별 ACK 대기 한도. 밀리초 단위의 양수 `int`, 양수의 정수 밀리초
+  정밀도 `datetime.timedelta` 또는 `None`. 생략하면 브로커의 기존 설정을 따릅니다.
 
 `Subscription` 객체 생성이나 `consumer.subs()`는 큐를 선언하지 않습니다.
 작업용 `declare()`는 일반 durable 큐와 선택적 DLQ를 준비하며,
 스트림 큐나 Exchange 바인딩을 자동 생성하지 않습니다.
-기존 큐의 선언 옵션이 다르면 실패하며 자동 삭제·재생성하지 않습니다.
+선언 옵션이 호환되지 않아 발생한 오류는 전파하며 자동 삭제·재생성하지 않습니다.
+
+### 장시간 작업의 ACK 대기 한도
+
+RabbitMQ 3.12 이상에서 `Subscription.timeout`을 지정하면 작업용 `declare()`가
+작업 큐에 `x-consumer-timeout`을 정수 밀리초로 전달합니다. 오류 큐에는 적용하지 않습니다.
+앞의 Worker 예제에서 다음 작업을 정의하고 `worker.add(Add)` 대신
+`worker.add(LongRunningAdd)`로 등록하면 기존 `Prepare`가 큐를 선언합니다.
+
+```python
+from datetime import timedelta
+
+
+class LongRunningAdd(
+  Add,
+  parameters=Subscription(
+    queue='defstream.example.rabbitmq.long.add',
+    error='defstream.example.rabbitmq.long.add.error',
+    timeout=timedelta(hours=24),
+  ),
+):
+  pass
+```
+
+위 설정은 `x-consumer-timeout=86400000`을 전달합니다.
+`timeout=86400000`처럼 정수 밀리초로 지정해도 같습니다.
+`Subscription.timeout`은 생성 시 정수 밀리초로 정규화됩니다.
+`Subscription.parse({'queue': 'tasks', 'timeout': timedelta(hours=24)})`처럼
+Mapping으로도 지정할 수 있습니다. 생략 또는 `None`이면 해당 큐 인자를 보내지 않습니다.
+
+- `bool` 및 `int`·`timedelta` 이외의 타입은 `TypeError`, 0·음수 또는 밀리초 미만 정밀도는
+  `ValueError`로 거부합니다. 시간을 조용히 반올림하거나 절삭하지 않습니다.
+- 객체 생성이나 구독만으로 설정을 적용하지 않습니다. 명시적인 작업 큐 선언이 필요합니다.
+- 작업 실행을 강제 중단하는 기능이 아니며 완료 후 ACK·실패 정책·prefetch를 유지합니다.
+  RPC 응답 대기시간은 별도입니다.
+- 기존 큐의 설정 변경·재생성·policy 적용은 운영 측 책임입니다.
+
+[RabbitMQ의 ACK timeout 안내](https://www.rabbitmq.com/docs/3.13/consumers#acknowledgement-timeout)에
+따르면 1분 미만은 지원하지 않으며 5분 미만은 권장하지 않습니다.
+이 검사는 약 1분 간격이므로 정확한 실행 제한 시간으로 사용하지 마세요.
 
 ### 워커 작업 우선순위
 

{defstream-0.1.18 → defstream-0.1.20}/docs/Redis.en.md

@@ -67,14 +67,16 @@ Read production credentials from environment variables or a secret store.
 ### Logging
 
 `Connection`, `Consumer`, `Queue`, and `Event` each use a class-level logger named
-`DefStream.Broker.Implements.Redis.<ClassName>`. Records propagate to the parent
-`DefStream` logger and the root logger. The library does not configure handlers
-or logging levels; configure output destinations and filters in your application.
+`Broker.Redis.<ClassName>`. Records propagate to the parent `Broker` logger and
+the root logger. Update filters or handlers configured for the former
+`DefStream.Broker.Implements.Redis` names to use `Broker.Redis`. The library does
+not configure handlers or logging levels; configure output destinations and filters
+in your application.
 Records exclude message bodies and credentials, and existing exceptions still
 propagate to callers after an error is logged. Since callers may log the same
 failure again, keep traceback logging at the boundary responsible for that failure.
 The examples configure output only at their execution entry points, selecting
-the `Sample` and Redis logger hierarchies at DEBUG level.
+the `Sample` and `Broker.Redis` logger hierarchies at DEBUG level.
 
 ### Consumer groups and history
 
@@ -111,8 +113,12 @@ This executable example prepares a task stream and group, then consumes tasks.
 ```python
 from signal import SIGINT, signal
 
-from DefStream.Broker.Policies import Reject
-from DefStream.Broker.Implements.Redis import Configuration, Connection, Subscription
+from DefStream.Broker.Implements.Redis import (
+  Configuration,
+  Connection,
+  Reject,
+  Subscription,
+)
 from DefStream.Worker import Run, ThreadPool, Worker, WorkerSetup, declare
 
 
@@ -219,7 +225,7 @@ flowchart TD
 - `delete_queue()` and `delete_stream()` delete the stream key itself.
   Do not remove shared streams/groups in cleanup code without ownership.
 - Connection, decoding, and handler failures propagate; there is no automatic reconnection.
-- Exchanges and RPC are not supported. Do not use `request()` or console RPC.
+- Exchanges and RPC are not supported. Do not use `request()` or Play RPC.
 - Redis Cluster is implemented, but current integration tests cover standalone Redis.
 - The Worker's connection and pool belong to one run. `worker.stop()` waits for tasks and closes resources.
 

{defstream-0.1.18 → defstream-0.1.20}/docs/Redis.md

@@ -66,13 +66,14 @@ Cluster는 Redis Cluster를 사용하며 `database=0`이어야 합니다.
 ### 로깅
 
 `Connection`, `Consumer`, `Queue`, `Event`는 각각
-`DefStream.Broker.Implements.Redis.<클래스명>` 로거를 사용하며 상위
-`DefStream` 로거와 루트 로거로 전파합니다. 라이브러리는 핸들러나 로그 수준을
+`Broker.Redis.<클래스명>` 로거를 사용하며 상위 `Broker` 로거와 루트 로거로
+전파합니다. 기존 `DefStream.Broker.Implements.Redis` 이름으로 설정한 필터나
+핸들러는 `Broker.Redis`로 갱신하세요. 라이브러리는 핸들러나 로그 수준을
 설정하지 않으므로 애플리케이션에서 필요한 출력 대상과 필터를 구성하세요.
 기록에는 메시지 본문과 인증 정보가 포함되지 않으며, 오류 로그 후에도 기존
 예외는 호출자에게 전파됩니다. 호출자가 같은 실패를 다시 기록할 수 있으므로
 traceback은 담당 경계 한 곳에서만 남기세요. 예제는 실행 진입점에서만 `Sample`
-및 Redis 로거 계층을 DEBUG로 출력하도록 설정합니다.
+및 `Broker.Redis` 로거 계층을 DEBUG로 출력하도록 설정합니다.
 
 ### 소비자 그룹과 이력
 
@@ -109,8 +110,12 @@ for event in connection.stream('defstream.example.redis').read(
 ```python
 from signal import SIGINT, signal
 
-from DefStream.Broker.Policies import Reject
-from DefStream.Broker.Implements.Redis import Configuration, Connection, Subscription
+from DefStream.Broker.Implements.Redis import (
+  Configuration,
+  Connection,
+  Reject,
+  Subscription,
+)
 from DefStream.Worker import Run, ThreadPool, Worker, WorkerSetup, declare
 
 
@@ -215,7 +220,7 @@ flowchart TD
 - `delete_queue()`와 `delete_stream()`은 스트림 키 자체를 삭제합니다.
   공유 스트림·그룹을 정리 코드에서 무단 삭제하지 마세요.
 - 연결·디코딩·핸들러 오류는 호출자에게 전파하며 자동 재연결하지 않습니다.
-- Exchange와 RPC는 지원하지 않습니다. `request()`와 콘솔 RPC를 사용할 수 없습니다.
+- Exchange와 RPC는 지원하지 않습니다. `request()`와 Play의 RPC를 사용할 수 없습니다.
 - Redis Cluster 구성은 지원하지만 현재 통합 테스트 대상은 standalone Redis입니다.
 - Worker의 연결과 풀은 한 번의 실행 전용입니다. `worker.stop()`은 작업을 기다린 뒤 자원을 닫습니다.