DefStream 0.1.18__tar.gz → 0.1.19__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.18
+Version: 0.1.19
 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.19}/DefStream.egg-info/SOURCES.txt

@@ -90,6 +90,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 +140,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 +149,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 +170,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 +202,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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.18
+Version: 0.1.19
 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.19}/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.19}/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.19}/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.19}/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.19}/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
 

{defstream-0.1.18 → defstream-0.1.19}/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로 작업 처리하기
 

{defstream-0.1.18 → defstream-0.1.19}/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.19}/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()`은 작업을 기다린 뒤 자원을 닫습니다.
 

{defstream-0.1.18 → defstream-0.1.19}/docs/Tasks.en.md

@@ -121,8 +121,8 @@ result = request(
 ### Success, failures, and retries
 
 - ACK follows successful execution and completion hooks. RabbitMQ RPC also publishes the reply before ACK.
-- Failures use the task's `on_error` policy. The default is `Requeue()`; choose `Reject()` explicitly if needed.
-- Both policies can be imported from `DefStream.Broker.Policies`.
+- Failures use the task's `on_error` policy. If omitted, the broker's default behavior applies; choose a policy provided by that broker, such as `Reject()`, when needed.
+- `Policy` is the shared broker contract. Import `Requeue` and `Reject` from the selected broker package; behavior can differ by broker.
 - Rejection is broker-specific: RabbitMQ dead-letters to a configured DLQ or discards the message;
   Redis acknowledges it for the group while preserving stream history.
 - There is no automatic retry-count limit. Choose a policy that avoids endless redelivery of permanently invalid messages.

{defstream-0.1.18 → defstream-0.1.19}/docs/Tasks.md

@@ -119,8 +119,9 @@ result = request(
 ### 성공, 실패와 재시도
 
 - 작업 실행과 완료 훅이 성공한 뒤 ACK합니다. RabbitMQ RPC는 응답 발행도 ACK보다 먼저 수행합니다.
-- 실패 시 `on_error` 정책을 적용합니다. 기본값은 `Requeue()`이며, `Reject()`를 명시할 수 있습니다.
-- `Requeue`와 `Reject`는 공통으로 `DefStream.Broker.Policies`에서 가져올 수 있습니다.
+- 실패 시 `on_error` 정책을 적용합니다. 생략하면 브로커 기본 동작을 따르며, `Reject()` 등 브로커가 제공하는 정책을 명시할 수 있습니다.
+- `Policy`는 브로커 공통 계약입니다. `Requeue`와 `Reject` 구현은 사용 중인 브로커
+  패키지에서 가져오며, 같은 이름의 정책도 동작은 브로커마다 다를 수 있습니다.
 - `Reject()`의 실제 효과는 브로커에 따라 다릅니다. RabbitMQ는 설정된 DLQ로 보내거나 폐기하며,
   Redis는 해당 그룹에서 ACK하고 스트림 이력은 유지합니다.
 - 재시도 횟수의 자동 제한은 없습니다. 영구적인 오류가 무한 재전달되지 않도록 정책을 선택하세요.

defstream-0.1.19/issues/fix/43/CHANGELOG.md

@@ -0,0 +1,5 @@
+# 로그 이름 계층 정리
+
+RabbitMQ와 Redis 로그 이름은 각각 `Broker.RabbitMQ.<클래스명>`과 `Broker.Redis.<클래스명>`으로 변경했습니다. Worker 로거는 `Worker`, 작업 실행 로그는 `Task`, 풀·실행기 로거는 `Worker` 계층을 사용합니다. Inspector 확장 로그는 `Worker.Inspector.<확장 이름>`으로 구분됩니다.
+
+기존 `DefStream.*` 이름으로 구성한 Broker·Worker·Inspector 로그 필터·핸들러는 새 이름 계층에 맞춰 갱신해야 합니다. 제품 모듈 import 경로와 공개 API는 변경되지 않았습니다.

defstream-0.1.19/issues/fix/43/IMPLEMENTS.md

@@ -0,0 +1,16 @@
+# 구현 결과
+
+RabbitMQ의 여섯 클래스와 Redis의 네 클래스 로거 이름은 각각 `Broker.RabbitMQ.<클래스명>`과 `Broker.Redis.<클래스명>`입니다. Worker 로거는 `Worker`, Run 로거는 `Task`, Executor·Pool 계열은 `Worker.<클래스명>`을 사용합니다. Inspector·Server·RequestHandler 로거는 `Worker.Inspector`, Inspector 확장 로거는 `Worker.Inspector.<클래스명>`을 사용합니다. Descriptor와 Validator는 로거를 사용하지 않아 변경하지 않았습니다. 기존 모듈·import 경로와 공개 API는 유지했습니다.
+
+새 로그 계층에 맞춰 샘플의 Worker·Broker 필터를 갱신했습니다. 한국어·영어 Operations, RabbitMQ, Redis 매뉴얼은 새 계층과 기존 이름으로 필터·핸들러를 구성한 애플리케이션의 설정 변경을 안내합니다.
+
+| 검증 항목 | 결과 |
+| --- | --- |
+| Broker·Worker·Task·Inspector 클래스별 이름 및 계층 전파 | 통과 |
+| 기존 import 경로·공개 API, Descriptor·Validator 비대상 유지 | 통과 |
+| 한국어·영어 매뉴얼과 샘플 필터의 새 이름 일치 | 반영 |
+| 확장 범위 검증: 65개 테스트 통과 | [이전 검증 기록](./tasks/1793261447019.md) |
+| 추가 이름 변경 후 126개 테스트 통과, 6개 건너뜀 | [최신 검증 기록](./tasks/1793262314955.md) |
+| 초기 브로커 변경 검증과 패키징 환경 제한 | [이전 검증 기록](./tasks/1793260818661.md) |
+
+단계별 구현 내역은 [브로커 구현 기록](./implements/1793260818660.md)과 [Worker·Inspector 구현 기록](./implements/1793261447018.md)을 참고하세요.

defstream-0.1.19/issues/fix/43/PLAN.md

@@ -0,0 +1,67 @@
+# 로거 이름 변경 작업 계획
+
+## 작업 정보
+
+| 항목 | 내용 |
+| --- | --- |
+| 원본 이슈 | [#43](https://github.com/yong5eon/DefStream/issues/43) |
+| 요구사항 | [REQUIREMENTS.md](./REQUIREMENTS.md) |
+| 작업 대상 | `yong5eon/DefStream` |
+| 작업 브랜치 | `fix/43` |
+| 분기 기준 | 로컬 `master`의 `23df707` |
+| 병합 대상 브랜치 | 미지정 |
+| 진행 상태 | 완료 |
+
+## 진행 원칙
+
+- 변경 범위와 인수 기준은 요구사항 명세를 따른다.
+- RabbitMQ·Redis, Worker, Inspector 로거 이름과 계층만 요구된 형식으로 변경하고 로그 메시지·레벨·전파 정책은 유지한다.
+- 모듈·import 경로와 공개 API는 유지하고, 로거를 사용하지 않는 Descriptor·Validator는 변경하지 않는다.
+- 저장소 전체의 로거 이름 사용 테스트·문서·샘플을 새 계층과 일치시키되 API import 경로는 유지한다.
+- 구현 중 영향 범위나 요구사항이 달라지면 이 계획과 요구사항 명세를 함께 갱신한다.
+- 병합 대상이 지정되지 않았으므로 임의로 정하거나 병합하지 않는다.
+
+## 작업 순서
+
+| 단계 | 작업 | 관련 기준 | 상태 |
+| --- | --- | --- | --- |
+| 1 | RabbitMQ·Redis 구현체의 클래스별 로거 선언과 저장소 내 기존 로거 이름 참조를 확인해 변경 대상을 확정한다. | AC-01, AC-02, AC-04 | 완료 |
+| 2 | RabbitMQ 클래스 로거 이름을 `Broker.RabbitMQ.<클래스명>`으로, Redis 클래스 로거 이름을 `Broker.Redis.<클래스명>`으로 변경한다. | AC-01, AC-02 | 완료 |
+| 3 | 로거 이름, 계층 전파·루트 전파와 로그 캡처를 확인하는 기존 테스트를 새 이름에 맞게 갱신하고, Worker·Inspector 이름 및 import 경로 불변을 확인한다. | AC-03, AC-04 | 완료 |
+| 4 | Operations, RabbitMQ, Redis의 한국어·영어 매뉴얼에서 브로커 로거 이름과 사용 예시를 갱신하고, 기존 이름으로 설정한 애플리케이션은 새 이름에 맞춰야 함을 안내한다. | AC-05 | 완료 |
+| 5 | 관련 로깅 테스트와 필요한 회귀 테스트를 실행하고, 검색 결과·내부 링크·변경 범위를 확인한다. 발견한 이번 변경의 문제를 수정하고 검증을 반복한다. | AC-01–AC-05 | 완료 |
+| 6 | Worker 로거는 `Worker`, Run 로거는 `Task`, Executor·Pool 계열은 `Worker.<클래스명>`으로, Inspector 확장 로거는 `Worker.Inspector.<클래스명>`으로 변경한다. | AC-04, AC-05 | 완료 |
+| 7 | Worker·Inspector 이름과 로그 계층을 검증하도록 테스트를 갱신하고, 기존 공개 import 및 비대상 Descriptor·Validator 동작이 유지되는지 확인한다. | AC-04–AC-06 | 완료 |
+| 8 | Worker 샘플 필터에 `Task` 계층을 반영하고, Operations·RabbitMQ 한국어·영어 로깅 설명 및 기존 logger 설정 변경 안내를 갱신한다. | AC-07 | 완료 |
+| 9 | 브로커·Worker·Inspector 로깅 테스트, 관련 회귀 테스트, 검색 및 문서 링크를 검증하고 결과를 기록한다. | AC-01–AC-07 | 완료 |
+
+## 인수 기준별 검증
+
+| 인수 기준 | 검증 방법 |
+| --- | --- |
+| AC-01 | RabbitMQ 클래스별 로거 이름 테스트에서 새 형식을 확인하고 `DefStream.`이 없는지 검사한다. |
+| AC-02 | Redis 클래스별 로거 이름 테스트에서 새 형식을 확인하고 `DefStream.` 및 `Implements.`가 없는지 검사한다. |
+| AC-03 | 새 어댑터 상위 이름과 루트 이름으로 로그를 캡처하여 전파가 유지되고, 기록의 이름으로 필터링할 수 있는지 확인한다. |
+| AC-04 | Worker 클래스별 새 이름, Pool 하위 클래스의 기본 이름 상속 및 로그 캡처 테스트를 실행한다. |
+| AC-05 | Inspector 공용·확장 로거 이름과 `Worker.Inspector` 계층·루트 전파 테스트를 실행한다. |
+| AC-06 | import·공개 API 테스트를 실행하고 Descriptor·Validator에서 로거 변경이 발생하지 않았는지 검색한다. |
+| AC-07 | 브로커·Worker·Inspector 로깅 테스트를 실행하고 샘플 및 한국어·영어 매뉴얼의 새 이름과 설정 안내를 대조한다. |
+
+## 검증 범위와 주의사항
+
+- 우선 `tests/test_rabbitmq_logging.py`, `tests/test_redis_logging.py`, `tests/test_logging.py` 및 브로커 패키징·공개 API 관련 테스트에서 새 이름과 유지 계약을 확인한다.
+- 저장소 검색으로 기존 브로커 로거 이름을 참조하는 문서·샘플·테스트가 남아 있지 않은지 확인한다. import 경로의 `DefStream.Broker.Implements.*`는 제거 대상이 아니다.
+- `DefStream.Worker`·`DefStream.Inspector` import 경로는 유지하고 logger 설정·검증 문자열만 새 이름으로 갱신한다.
+- Worker 로그 이름은 `Worker`와 `Task`로 구분되므로 Worker 로그 필터 예제에는 두 계층을 모두 포함한다.
+- Descriptor·Validator에는 로거가 없으므로 변경하지 않는다.
+- 전체 테스트 실행 여부는 관련 테스트 결과와 환경 의존성을 확인한 뒤 결정하고, 실행하지 않은 검증은 완료로 기록하지 않는다.
+- 구현 후 매뉴얼 영향 검토 및 변경 로그 작성은 실제 변경과 결과를 확인한 뒤 진행한다.
+- 커밋·푸시·PR 생성은 별도 요청이 있을 때만 수행한다.
+
+## 완료 결과
+
+- 브로커 로거 이름·테스트·샘플·한국어·영어 매뉴얼 변경과 인수 기준 검증을 완료했다.
+- 테스트 상세 결과와 패키징 검증 환경 제한은 [작업 기록](./tasks/1793260818661.md)에 기록했다.
+- 일반 배포 패키지 메타데이터를 사용하는 `test_broker_packaging.py` 검증은 현재 editable 설치 환경 때문에 완료하지 못했다.
+
+Worker·Inspector 로거 변경 범위까지 확장해 구현과 요구사항 검증을 완료했다. 확장 구현 결과는 [구현 기록](./implements/1793261447018.md), 추가 이름 변경에 맞춘 테스트·샘플·문서 정합성 확인은 최신 [작업 기록](./tasks/1793262314955.md)에 정리했다.