DefStream-RabbitMQ 0.1.4__tar.gz → 0.1.5__tar.gz

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5/DefStream_RabbitMQ.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream-RabbitMQ
-Version: 0.1.4
+Version: 0.1.5
 Summary: RabbitMQ broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
 Author: Heo Yongseon
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: DefStream>=0.1.7
+Requires-Dist: DefStream>=0.1.9
 Requires-Dist: pika>=1.3.2
 Dynamic: author
 Dynamic: classifier
@@ -101,6 +101,26 @@ finally:
 일반 연결의 heartbeat는 애플리케이션 작업·유휴 시간에 맞게 설정하고 처리되도록 관리하세요.
 연결과 그 리소스는 **소유 스레드에서만 사용**해야 하며, 스레드·프로세스 사이에 공유하지 마세요.
 
+## 로깅
+
+여섯 클래스는 `DefStream.Broker.Implements.RabbitMQ.ClassName` 이름의 클래스 멤버
+`logger`를 사용합니다(`Connection`, `Consumer`, `Queue`, `Exchange`, `Stream`, `Event`).
+하위 클래스는 같은 로거를 상속하며 필요하면 멤버를 재정의할 수 있습니다.
+라이브러리는 핸들러·`NullHandler`·레벨·필터를 설정하지 않고 루트로 전파합니다.
+미설정 시 표준 `logging.lastResort` 동작을 유지합니다.
+
+연결·자원 변경은 INFO, 메시지·RPC·정산 추적은 DEBUG, RPC 시간 초과·원격 오류·
+응답 라우팅 불가는 WARNING, 내부 I/O·코덱 오류는 ERROR입니다.
+본문·결과·헤더·인증정보와 예외 문자열·traceback은 기록하지 않으며 예외는 그대로 전파합니다.
+애플리케이션이 같은 예외를 다시 기록하면 중복될 수 있습니다.
+발행 API 반환은 소비자 처리 완료가 아니며, RPC 응답 시간 초과도 전달된 작업을 취소하지 않습니다.
+
+`sample/*.py`는 실행 진입점에서만 루트 DEBUG 콘솔 출력을 구성합니다.
+핸들러의 `Filter('Sample')` 또는 `Filter('DefStream.Broker.Implements.RabbitMQ')`
+통과 조건으로 두 이름과 점으로 구분된 하위 로거만 출력하며 Pika·코어 등은 제외합니다.
+다른 애플리케이션에서는 원하는 상위 이름(`DefStream`, `DefStream.Broker` 등)이나
+클래스 이름을 선택하고 핸들러·레벨·필터를 직접 구성하세요.
+
 ## Worker로 작업 처리하기
 
 다음은 큐와 오류 큐를 준비한 후 작업을 소비하는 실행 파일입니다.

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5}/DefStream_RabbitMQ.egg-info/SOURCES.txt

@@ -14,6 +14,9 @@ issues/feature/1/README.md
 issues/feature/1/REQUIREMENTS.md
 issues/feature/1/TASK.md
 issues/feature/1/ci.refs.json
+issues/feature/5/IMPLEMENTS.md
+issues/feature/5/README.md
+issues/feature/5/REQUIREMENTS.md
 issues/fix/3/IMPLEMENTS.md
 issues/fix/3/README.md
 issues/fix/3/REQUIREMENTS.md
@@ -32,6 +35,7 @@ src/Stream.py
 src/Subscription.py
 src/__init__.py
 test/test_broker_methods.py
+test/test_logging.py
 test/test_priorities.py
 test/test_rabbitmq_integration.py
 test/test_rabbitmq_worker.py

defstream_rabbitmq-0.1.5/DefStream_RabbitMQ.egg-info/requires.txt

@@ -0,0 +1,2 @@
+DefStream>=0.1.9
+pika>=1.3.2

{defstream_rabbitmq-0.1.4/DefStream_RabbitMQ.egg-info → defstream_rabbitmq-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream-RabbitMQ
-Version: 0.1.4
+Version: 0.1.5
 Summary: RabbitMQ broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
 Author: Heo Yongseon
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: DefStream>=0.1.7
+Requires-Dist: DefStream>=0.1.9
 Requires-Dist: pika>=1.3.2
 Dynamic: author
 Dynamic: classifier
@@ -101,6 +101,26 @@ finally:
 일반 연결의 heartbeat는 애플리케이션 작업·유휴 시간에 맞게 설정하고 처리되도록 관리하세요.
 연결과 그 리소스는 **소유 스레드에서만 사용**해야 하며, 스레드·프로세스 사이에 공유하지 마세요.
 
+## 로깅
+
+여섯 클래스는 `DefStream.Broker.Implements.RabbitMQ.ClassName` 이름의 클래스 멤버
+`logger`를 사용합니다(`Connection`, `Consumer`, `Queue`, `Exchange`, `Stream`, `Event`).
+하위 클래스는 같은 로거를 상속하며 필요하면 멤버를 재정의할 수 있습니다.
+라이브러리는 핸들러·`NullHandler`·레벨·필터를 설정하지 않고 루트로 전파합니다.
+미설정 시 표준 `logging.lastResort` 동작을 유지합니다.
+
+연결·자원 변경은 INFO, 메시지·RPC·정산 추적은 DEBUG, RPC 시간 초과·원격 오류·
+응답 라우팅 불가는 WARNING, 내부 I/O·코덱 오류는 ERROR입니다.
+본문·결과·헤더·인증정보와 예외 문자열·traceback은 기록하지 않으며 예외는 그대로 전파합니다.
+애플리케이션이 같은 예외를 다시 기록하면 중복될 수 있습니다.
+발행 API 반환은 소비자 처리 완료가 아니며, RPC 응답 시간 초과도 전달된 작업을 취소하지 않습니다.
+
+`sample/*.py`는 실행 진입점에서만 루트 DEBUG 콘솔 출력을 구성합니다.
+핸들러의 `Filter('Sample')` 또는 `Filter('DefStream.Broker.Implements.RabbitMQ')`
+통과 조건으로 두 이름과 점으로 구분된 하위 로거만 출력하며 Pika·코어 등은 제외합니다.
+다른 애플리케이션에서는 원하는 상위 이름(`DefStream`, `DefStream.Broker` 등)이나
+클래스 이름을 선택하고 핸들러·레벨·필터를 직접 구성하세요.
+
 ## Worker로 작업 처리하기
 
 다음은 큐와 오류 큐를 준비한 후 작업을 소비하는 실행 파일입니다.

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5}/README.en.md

@@ -54,6 +54,27 @@ Call `ack()` on success, `nack()` for redelivery, or `reject()` to reject.
 Rejected messages go to the broker-configured dead-letter destination or are
 discarded when none is configured.
 
+## Logging
+
+`Connection`, `Consumer`, `Queue`, `Exchange`, `Stream`, and `Event` expose a class
+member `logger` named `DefStream.Broker.Implements.RabbitMQ.ClassName`. 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.
+
+Lifecycle and resource changes use INFO, per-message/RPC/settlement tracing uses DEBUG,
+expected RPC anomalies use WARNING, and internal I/O or codec failures use ERROR.
+Payloads, results, headers, credentials, exception text, and tracebacks are omitted.
+Exceptions still propagate; application-side logging may duplicate a library record.
+A publish return does not mean consumer processing completed, and an RPC response
+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.Implements.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.
+
 ## Connection configuration
 
 | Option | Meaning |

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5}/README.md

@@ -70,6 +70,26 @@ finally:
 일반 연결의 heartbeat는 애플리케이션 작업·유휴 시간에 맞게 설정하고 처리되도록 관리하세요.
 연결과 그 리소스는 **소유 스레드에서만 사용**해야 하며, 스레드·프로세스 사이에 공유하지 마세요.
 
+## 로깅
+
+여섯 클래스는 `DefStream.Broker.Implements.RabbitMQ.ClassName` 이름의 클래스 멤버
+`logger`를 사용합니다(`Connection`, `Consumer`, `Queue`, `Exchange`, `Stream`, `Event`).
+하위 클래스는 같은 로거를 상속하며 필요하면 멤버를 재정의할 수 있습니다.
+라이브러리는 핸들러·`NullHandler`·레벨·필터를 설정하지 않고 루트로 전파합니다.
+미설정 시 표준 `logging.lastResort` 동작을 유지합니다.
+
+연결·자원 변경은 INFO, 메시지·RPC·정산 추적은 DEBUG, RPC 시간 초과·원격 오류·
+응답 라우팅 불가는 WARNING, 내부 I/O·코덱 오류는 ERROR입니다.
+본문·결과·헤더·인증정보와 예외 문자열·traceback은 기록하지 않으며 예외는 그대로 전파합니다.
+애플리케이션이 같은 예외를 다시 기록하면 중복될 수 있습니다.
+발행 API 반환은 소비자 처리 완료가 아니며, RPC 응답 시간 초과도 전달된 작업을 취소하지 않습니다.
+
+`sample/*.py`는 실행 진입점에서만 루트 DEBUG 콘솔 출력을 구성합니다.
+핸들러의 `Filter('Sample')` 또는 `Filter('DefStream.Broker.Implements.RabbitMQ')`
+통과 조건으로 두 이름과 점으로 구분된 하위 로거만 출력하며 Pika·코어 등은 제외합니다.
+다른 애플리케이션에서는 원하는 상위 이름(`DefStream`, `DefStream.Broker` 등)이나
+클래스 이름을 선택하고 핸들러·레벨·필터를 직접 구성하세요.
+
 ## Worker로 작업 처리하기
 
 다음은 큐와 오류 큐를 준비한 후 작업을 소비하는 실행 파일입니다.

defstream_rabbitmq-0.1.5/issues/feature/5/IMPLEMENTS.md

@@ -0,0 +1,83 @@
+# 로깅 지원 구현 기록
+
+## 1. 구현 개요
+
+[요구사항](./REQUIREMENTS.md)에 따라 RabbitMQ I/O와 메시지 처리 경계에
+클래스별 표준 로깅을 추가했다.
+
+- 구현·검증일: 2026-10-20
+- 사용자용 안내: [변경 로그](./README.md)
+- 연계 구현: [코어 로깅](../../../../DefStream/issues/feature/8/IMPLEMENTS.md)
+
+## 2. 로거와 기록 범위
+
+각 클래스에 `DefStream.Broker.Implements.RabbitMQ.<클래스 이름>`의
+클래스 멤버 `logger`를 정의했다.
+
+| 클래스 | 구현한 관찰 지점 |
+| --- | --- |
+| [Connection](../../../src/Connection.py) | 연결·재사용·종료, 자원 선언·삭제·바인딩, publisher 생성, emit·RPC 위임 |
+| [Consumer](../../../src/Consumer.py) | 구독·QoS·offset, 루프 시작·중지, 수신·디코딩·전달, 콜백 예약, 정책·RPC 응답 |
+| [Queue](../../../src/Queue.py) | 발행·단건 수신·대기 종료, RPC 연결·응답 큐·correlation ID·시간 초과·정리 |
+| [Exchange](../../../src/Exchange.py) | exchange·routing key별 발행과 RPC |
+| [Stream](../../../src/Stream.py) | 발행·offset 읽기, 반복 읽기의 ack/nack·소비 취소·정리 |
+| [Event](../../../src/Event.py) | ack/nack/reject 요청, 브로커 API 호출 완료와 실패 |
+
+Connection의 `observe()`에서 해당 클래스가 소유한 I/O 작업의 성공·실패를
+기록하고 실패는 다시 전파한다. Consumer→Event 정산, Connection→Queue RPC 등
+위임 경계에서는 같은 오류를 반복 기록하지 않도록 책임을 나눴다.
+Worker가 처리하는 사용자 작업 예외를 어댑터에서 다시 traceback으로 기록하지 않는다.
+
+## 3. 레벨과 의미 구분
+
+- INFO: 연결·Consumer 생명주기, 자원 변경 성공.
+- DEBUG: 메시지 발행·수신·정산, 설정의 안전한 항목, 정상 대기 종료·재큐잉.
+- WARNING: RPC 발행 전 시간 초과, 발행 후 응답 시간 초과, 원격 작업 오류,
+  응답 라우팅 불가.
+- ERROR: 연결·채널·디코딩·발행·정산·응답 형식 등 담당 경계의 내부 실패.
+
+발행 후 RPC 응답 시간 초과는 이미 전달한 작업의 취소를 의미하지 않는다.
+응답 라우팅 불가 이후 요청을 정산하는 기존 동작도 유지했다.
+정산 완료 로그는 브로커 API 호출 반환을 뜻하며 영속화나 후속 소비 완료를 보장하지 않는다.
+빈 큐의 반복 조회는 매번 기록하지 않고 정상 `pop()` 대기 종료는 DEBUG로 처리한다.
+
+## 4. 출력·보안·샘플
+
+- 라이브러리는 핸들러·NullHandler·포매터·필터·레벨을 설정하지 않고 기본 전파를 유지한다.
+- 영어 메시지에 큐·exchange·routing key·message ID·correlation ID·delivery tag 등
+  필요한 메타데이터만 기록한다.
+- 본문·결과·헤더 전체·인증정보·설정 객체 전체·예외 문자열·traceback은 기록하지 않는다.
+- [샘플](../../../sample)은 `Sample`과 `DefStream.Broker.Implements.RabbitMQ` 계층만
+  출력하도록 진입점에서 핸들러를 구성한다. 단순 import로 루트 설정을 바꾸지 않는다.
+- 공개 송수신 API, publisher confirm, mandatory, RPC 제한 시간·정리와
+  ack/nack/reject 정책을 유지했다. 자동 재연결·재시도 API는 추가하지 않았다.
+
+## 5. 검증
+
+Python 3.13.16과 실제 RabbitMQ에서 관련 테스트 **52개가 건너뜀 없이 통과**했다.
+[로깅 테스트](../../../test/test_logging.py) 14개는 다음을 검증한다.
+
+- 클래스 이름·상속, 상위 계층 선택 수신·루트 전파와 라이브러리 설정 비개입.
+- 모든 발행 클래스의 메타데이터·실패와 본문·헤더·인증정보 제외.
+- 연결·자원·confirm·RPC 위임, 단건 대기 종료와 DEBUG 비활성.
+- Consumer 실패 기록 책임, 응답 라우팅 불가 후 정산, Event 실패의 중복 기록 방지.
+- RPC 성공·불일치 응답·원격 오류·형식 오류·전송 실패·발행 전후 시간 초과.
+- Stream ack/nack·취소 및 실패 시 잘못된 성공 로그 방지.
+- 샘플 import 비개입과 계층 경계 필터.
+
+기존 브로커·Worker·RPC·우선순위·실서버 통합 테스트도 함께 실행했다.
+RPC 샘플도 실제 브로커로 실행했다. 영어 전환 후 소스·샘플 `compileall`과
+`git diff --check`를 통과했다. 전체 정적 타입 검사와 다른 Python 버전 검증을
+완료한 것은 아니다.
+
+### 재검증
+
+개발 가상환경과 로컬 테스트 브로커를 준비한 작업공간 루트에서 실행한다.
+통합 테스트가 자원을 생성·정리하므로 운영 브로커를 사용하지 않는다.
+
+```powershell
+$env:PYTHONIOENCODING = 'utf-8'
+$env:DEFSTREAM_RABBITMQ_TESTS = '1'
+Set-Location .\DefStream-RabbitMQ\test
+& ..\..\.venv\Scripts\python.exe -m unittest test_logging test_broker_methods test_rabbitmq_worker test_rpc test_rabbitmq_integration test_rpc_integration test_priorities
+```

defstream_rabbitmq-0.1.5/issues/feature/5/README.md

@@ -0,0 +1,43 @@
+# 로깅 지원
+
+## 변경 요약
+
+RabbitMQ의 연결·자원 관리·발행·소비·RPC·정산을 클래스별 표준 로거로
+추적할 수 있습니다. 런타임 메시지는 영어이며 출력 정책은 애플리케이션이 정합니다.
+
+## 로거 이름
+
+공통 접두사는 `DefStream.Broker.Implements.RabbitMQ`입니다.
+다음 여섯 클래스가 각자의 클래스 멤버 `logger`를 사용합니다.
+
+- `Connection`
+- `Consumer`
+- `Queue`
+- `Exchange`
+- `Stream`
+- `Event`
+
+예를 들어 `DefStream.Broker.Implements.RabbitMQ.Consumer`만 선택하거나
+RabbitMQ·Broker·DefStream 상위 계층에서 함께 수신할 수 있습니다.
+기존 Consumer 모듈 경로 기반 필터는 새 이름에 맞춰 갱신하세요.
+
+## 레벨과 주의사항
+
+- INFO: 연결·소비 생명주기와 자원 변경.
+- DEBUG: 메시지별 발행·수신·RPC·정산과 정상 대기 종료.
+- WARNING: RPC 시간 초과·원격 오류·응답 라우팅 불가.
+- ERROR: 연결·전송·디코딩·정산 등 내부 실패.
+
+발행 후 응답 시간 초과는 작업 취소를 뜻하지 않습니다.
+발행·정산 API 호출 완료를 후속 소비나 영속화 보장으로 해석하지 마세요.
+본문·결과·헤더·인증정보·예외 문자열·traceback은 어댑터 로그에서 제외합니다.
+예외는 기존대로 전파되므로 애플리케이션에서 같은 오류를 재기록하면 중복될 수 있습니다.
+
+## 사용자 설정과 샘플
+
+라이브러리는 핸들러·NullHandler·레벨을 자동 설정하지 않습니다.
+설정이 없으면 표준 `logging.lastResort` 동작을 유지합니다.
+[샘플](../../../sample)은 `print()` 대신 `Sample` 로거를 사용하며
+`Sample`과 RabbitMQ 계층만 출력합니다.
+실제 설정은 [사용 설명서](../../../README.md#로깅)를 참고하세요.
+기존 공개 API와 메시지 정산·RPC 동작은 유지됩니다.

defstream_rabbitmq-0.1.5/issues/feature/5/REQUIREMENTS.md

@@ -0,0 +1,122 @@
+# 로깅 지원
+
+## 1. 목적과 범위
+
+- RabbitMQ 연결, 자원 선언·바인딩, 발행·수신, RPC, 메시지 확인 처리의 흐름을 풍부하게 관찰할 수 있도록 한다.
+- Python 표준 `logging`을 사용하며 출력 대상·형식·레벨·필터는 사용자 애플리케이션이 결정한다.
+- 로깅 대상은 Connection·Consumer·Queue·Exchange·Stream·Event 여섯 클래스로 한정한다.
+- 이 요구사항에 따라 소스와 샘플의 로깅을 구현하며, 기존 공개 API의 메시지 처리 계약을 유지한다.
+- 코어 Worker·Inspector의 기록 책임은 [DefStream 로깅 지원](../../../../DefStream/issues/feature/8/REQUIREMENTS.md)을 따른다.
+
+## 2. 로거 이름과 사용자 설정
+
+- 로거는 모듈 경로나 사용자 하위 클래스에서 자동 생성하지 않고 클래스별로 명시적 이름을 지정한다.
+- 이름의 공통 형식은 `DefStream.Broker.Implements.RabbitMQ.ClassName`이다.
+- DefStream과 동일하게 로거를 클래스 멤버로 보관한다. 사용자 하위 클래스는 기반 이름을 상속하며 필요하면 로거 멤버를 명시적으로 재정의할 수 있다.
+- 사용자 애플리케이션은 `DefStream`, `DefStream.Broker`, `DefStream.Broker.Implements.RabbitMQ` 또는 클래스별 로거에서 선택적으로 수신할 수 있어야 한다.
+- 라이브러리는 `basicConfig()`, 출력 핸들러·포매터·필터, 로그 레벨을 임의로 설정하거나 기존 설정을 제거하지 않는다. 루트까지의 기본 전파도 막지 않는다.
+- 코어와 동일하게 출력 핸들러와 `NullHandler`를 추가하지 않는다. 미설정 시 Python의 `logging.lastResort` 기본 동작을 유지한다.
+- 샘플은 `Sample` 로거를 사용하고 출력 핸들러를 직접 설정한다. 수신 범위는 `Sample`과 `DefStream.Broker.Implements.RabbitMQ` 계층이며, 샘플의 `print()`는 DEBUG·INFO 로그로 대체한다.
+
+## 3. 현재 상태
+
+- [Consumer.respond()](../../../src/Consumer.py)는 RPC 응답의 `UnroutableError`를 WARNING으로 기록한 뒤 요청 메시지 정산을 계속한다.
+- 현재 로거는 클래스별 고정 이름이 아니라 Consumer 모듈의 `getLogger(__name__)`이다.
+- 나머지 클래스에는 직접적인 로깅 호출이 없다.
+- Worker가 처리하는 작업 실패와 RabbitMQ I/O 실패는 구분한다. 같은 작업 예외를 어댑터에서 반복 ERROR로 기록하지 않는다.
+
+## 4. 클래스별 로거 이름
+
+다음 여섯 클래스만 독립 로거를 갖는다.
+
+| 구분 | 클래스와 소스 | 로거 이름 | 필요한 관찰 범위 |
+| --- | --- | --- | --- |
+| 우선 대상 | [Connection](../../../src/Connection.py) | `DefStream.Broker.Implements.RabbitMQ.Connection` | 연결·종료, 선언·삭제·바인딩, publisher 생성, 직접 발행·RPC 위임 |
+| 우선 대상 | [Consumer](../../../src/Consumer.py) | `DefStream.Broker.Implements.RabbitMQ.Consumer` | 구독·QoS·offset, 수신 루프, 콜백 예약, 완료·실패 정책, RPC 응답 |
+| 우선 대상 | [Queue](../../../src/Queue.py) | `DefStream.Broker.Implements.RabbitMQ.Queue` | 발행, 단건 수신·대기, 전용 연결을 사용하는 RPC |
+| 우선 대상 | [Exchange](../../../src/Exchange.py) | `DefStream.Broker.Implements.RabbitMQ.Exchange` | routing key 기반 발행과 RPC |
+| 우선 대상 | [Stream](../../../src/Stream.py) | `DefStream.Broker.Implements.RabbitMQ.Stream` | offset 기반 읽기, 발행, 반복 읽기의 확인·재큐잉·정리 |
+| 우선 대상 | [Event](../../../src/Event.py) | `DefStream.Broker.Implements.RabbitMQ.Event` | 개별 메시지의 ack/nack/reject 요청·완료 |
+
+### 4.1. 독립 로거를 추가하지 않을 대상
+
+| 대상 | 판단 근거와 기록 책임 |
+| --- | --- |
+| [Callback·FailedRequest](../../../src/Consumer.py) | 독립 로거를 추가하지 않는다. 필요한 수신·실패 응답 문맥은 Consumer 로거에 귀속하고 실제 정산은 Event에서 기록한다. |
+| [JavaScriptObjectNotationEncoder·JavaScriptObjectNotationDecoder](../../../src/Serializer.py) | 독립 로깅에서 제외한다. 직렬화·역직렬화 실패는 송수신 호출 경계에서 관찰한다. |
+| [Configuration](../../../src/Configuration.py) | 설정·TLS 옵션 보관 객체이다. Connection에서 허용한 항목만 요약하며 설정 객체 전체를 출력하지 않는다. |
+| [Subscription](../../../src/Subscription.py) | 파싱·검증 데이터 클래스이다. 검증 결과와 적용 설정은 Connection·Consumer에서 기록한다. |
+| [ExchangeType·Parameters·All·Any](../../../src/Connection.py) | 열거형과 바인딩 인자 객체이다. 실제 자원 변경은 Connection에서 기록한다. |
+| [Encoder·Decoder](../../../src/Serializer.py), [EventHandler](../../../src/Event.py) | 사용자 구현용 추상 계약이다. 구체 구현 또는 호출 경계의 로그로 관찰한다. |
+| [Policies](../../../src/Policies.py)의 Requeue·Reject | 코어 정책을 재노출하며 RabbitMQ 전용 구현 클래스가 아니다. 정책 선택은 Consumer, 실제 처리는 Event에서 기록한다. |
+
+- 보조 클래스에서 필요한 사건을 기록하더라도 Consumer 로거를 사용하며 새로운 이름을 만들지 않는다.
+
+## 5. 레벨별 기록 요구사항
+
+### 5.1. Connection
+
+- INFO: 연결 시도·성공·종료, 자원 선언·삭제·바인딩·해제의 성공.
+- DEBUG: 이미 열린 연결의 재사용, publisher 채널 생성·재사용, QoS 등 객체 생성 인자 중 안전한 항목, 선언 옵션의 허용 목록.
+- DEBUG: 직접 `emit()`한 작업의 발행 시작·완료, 대상 큐·message ID·priority, `request()`의 Queue 위임 경계.
+- ERROR: 연결·채널·자원 변경·발행 실패 중 어댑터가 최종 기록 책임을 갖는 경계. 예외는 기존대로 호출자에게 전파한다.
+- `emit()`의 publisher confirm 사용 여부를 다른 발행 API와 구분하여 기록한다.
+
+### 5.2. Consumer
+
+- INFO: 구독 적용, 수신 루프 시작·중지·채널 종료.
+- DEBUG: 큐·consumer tag·delivery tag, 적용 QoS·offset, 수신·디코딩·핸들러 전달, 연결 소유 스레드 콜백 예약.
+- DEBUG: 완료·실패 정책 선택, RPC 성공·실패 응답 시도, 응답 채널 생성·재사용, correlation ID.
+- WARNING: 라우팅 불가능한 RPC 응답. 기존처럼 요청을 정산하는 동작과 응답 전달 실패를 명확히 구분한다.
+- ERROR: 수신 루프·채널·콜백 예약·디코딩·응답 발행의 내부 실패 중 해당 경계가 담당하는 오류.
+- FailedRequest는 오류 응답이 Consumer에서 생성되고 실제 정산은 Event에서 수행되는 흐름을 구분한다. 같은 결과를 세 클래스에서 반복 출력하지 않는다.
+- Worker가 처리한 사용자 작업 예외는 Consumer에서 다시 ERROR·traceback으로 출력하지 않는다.
+
+### 5.3. Queue·Exchange
+
+- DEBUG: 발행 시작·완료, 큐 또는 exchange·routing key, message ID, priority·지속성 옵션.
+- DEBUG: Queue의 단건 수신 시작·성공·대기 종료. 빈 큐의 매 조회를 출력하지 않는다.
+- DEBUG: RPC 전용 연결·응답 큐 생성·정리, 요청 발행, correlation ID, 응답 수신·검증, 소요 시간.
+- DEBUG: correlation ID가 일치하지 않아 무시한 응답. 응답 본문은 출력하지 않는다.
+- WARNING: RPC 시간 초과와 원격 작업 오류. 발행 전 시간 초과와 발행 후 응답 시간 초과를 구분하며 이미 전달된 작업이 취소된 것으로 표현하지 않는다.
+- ERROR: RPC 응답 형식 오류, 전송·연결·역직렬화 실패 중 이 경계가 최종 기록하는 오류.
+- 정상적인 `pop()` 대기 종료는 DEBUG이며 WARNING으로 처리하지 않는다.
+- `send()` 호출 반환만으로 publisher confirm 또는 소비자 처리가 완료됐다고 기록하지 않는다.
+
+### 5.4. Stream·Event
+
+- DEBUG: Stream 발행, 읽기 시작·offset·대기 조건, 수신 메타데이터, 반복 읽기 종료와 Consumer 취소.
+- DEBUG: Event의 ack/nack/reject 요청과 브로커 API 호출 완료. 큐·delivery tag·안전한 메시지 식별자를 함께 남긴다.
+- DEBUG: Stream 읽기 루프에서 직접 수행하는 ack/nack도 Stream 로거에서 관찰 가능해야 한다.
+- WARNING: Stream 처리 예외로 재큐잉하는 사건은 원인 로그와 중복되지 않게 기록한다. 정상 재큐잉 정책의 모든 호출을 경고로 취급하지 않는다.
+- ERROR: 확인 처리·재큐잉·취소·채널 정리의 실패. 실패했는데 성공 로그를 먼저 남기지 않는다.
+- 로깅을 추가하면서 Stream의 기존 자동 ack/nack 동작이나 Event 확인 처리 횟수를 바꾸지 않는다.
+
+## 6. 기록 품질과 호환성
+
+- 공개 라이브러리와 샘플의 런타임 로그 메시지는 영어로 작성한다. 한국어 문서·주석은 유지하고 클래스·API·메시지 식별자는 원문을 유지한다.
+- 사용자 인증정보, 전체 ConnectionParameters·Configuration, 연결 URI의 자격 증명, 메시지 본문·결과, 헤더 전체를 기록하지 않는다.
+- Event의 `repr()`에는 본문과 헤더가 포함되므로 로그 인자로 그대로 사용하지 않는다.
+- 허용 문맥은 사건·단계, 안전한 접속 주소·vhost, 큐·exchange·routing key, 메시지·correlation·delivery 식별자, QoS·offset·priority 등으로 제한한다.
+- 예외 문자열에도 접속 정보나 메시지 값이 들어갈 수 있으므로 traceback의 민감정보 노출을 검토한다.
+- 어댑터 내 동일 예외의 ERROR·traceback은 한 경계에서 기록한다. Connection→Queue RPC 위임과 Consumer→Event 정산에서 중복을 피한다.
+- DEBUG 비활성 시 로그용 추가 I/O·직렬화·헤더 순회를 하지 않고 지연 메시지 치환을 활용한다.
+- 기존 예외 전파, 연결·채널 소유권, RPC 제한 시간, 라우팅 불가 응답 처리, ack/nack/reject 정책을 보존한다.
+- 자동 재연결·재시도·새 핸들러 주입 API는 이번 로깅 요구사항에 포함하지 않는다.
+
+## 7. 확정 사항과 구현 원칙
+
+1. 독립 로깅 대상과 이름은 4장의 여섯 클래스로 한정하고 로거는 클래스 멤버로 보관한다.
+2. 핸들러 설정은 사용자 책임이며 라이브러리는 출력 핸들러·NullHandler를 추가하지 않는다.
+3. 연결·생명주기·자원 변경은 INFO, 메시지별 정상 흐름은 DEBUG, 예상 가능한 RPC 이상은 WARNING, 내부 장애는 ERROR로 구분한다.
+4. 반복 호출의 출력량과 상세 문맥 필드는 5·6장의 원칙에 따라 구현 시 구체화한다. 별도 설정 API를 미리 추가하지 않는다.
+5. 사용자 애플리케이션이 상위 경계에서도 같은 예외를 기록할 수 있다는 점을 안내한다. 사용자의 로깅을 억제하거나 예외 전파를 변경하지 않는다.
+
+## 8. 구현 후 수용 기준
+
+- 확정한 클래스별 로거와 상위 RabbitMQ·Broker·DefStream 로거에서 선택 수신 및 루트 전파가 가능하다.
+- 연결·발행·구독·단건 수신·Stream 읽기·RPC·정산의 정상·실패 로그를 검증한다.
+- RPC 발행 전·후 시간 초과, 원격 오류, 응답 라우팅 불가, 정산 실패의 레벨과 문맥이 구분된다.
+- DEBUG 비활성 시 메시지별 추적이 출력되지 않고 빈 큐·정상 대기·재큐잉으로 경고가 반복되지 않는다.
+- 본문·자격 증명·헤더가 노출되지 않고, 동일 실패의 traceback이 어댑터 내부에서 중복되지 않는다.
+- 기존 브로커·Worker 연동·RPC·통합 테스트가 보장하는 예외와 메시지 처리 동작을 유지한다.

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5}/sample/Sample.RPC.py

@@ -1,5 +1,11 @@
 from concurrent.futures import ThreadPoolExecutor
-from sys import stderr
+from logging import (
+	DEBUG,
+	Filter,
+	Formatter,
+	StreamHandler,
+	getLogger,
+)
 from threading import Event as PyEvent
 from uuid import uuid4
 
@@ -14,6 +20,8 @@ from DefStream.Broker.Implements.RabbitMQ import (
 	Reject,
 )
 
+logger = getLogger('Sample')
+
 
 class Calculate(EventHandler):
 	def __init__(
@@ -21,6 +29,7 @@ class Calculate(EventHandler):
 		consumer: Consumer,
 	):
 		self.consumer = consumer
+		return
 
 	def __call__(
 		self,
@@ -38,6 +47,7 @@ class Calculate(EventHandler):
 				event,
 				result,
 			)
+		return
 
 
 def serve(
@@ -65,6 +75,7 @@ def serve(
 						0.1,
 						check_stop,
 					)
+				return
 
 			broker.connection.call_later(
 				0.1,
@@ -76,9 +87,20 @@ def serve(
 	finally:
 		broker.close()
 		ready.set()
+	return
 
 
 if __name__ == '__main__':
+	root = getLogger()
+	root.setLevel(DEBUG)
+	console = StreamHandler()
+	console.setLevel(DEBUG)
+	sample_filter = Filter('Sample')
+	rabbitmq_filter = Filter('DefStream.Broker.Implements.RabbitMQ')
+	console.addFilter(lambda record: sample_filter.filter(record) or rabbitmq_filter.filter(record))
+	console.setFormatter(Formatter('%(asctime)s %(levelname)s %(name)s %(message)s'))
+	root.addHandler(console)
+	logger.info('Starting RabbitMQ RPC sample')
 	configuration = Configuration(
 		host='127.0.0.1',
 		port=5672,
@@ -130,7 +152,7 @@ if __name__ == '__main__':
 					},
 					timeout=5,
 				)
-				print(f'Queue RPC: 20 / 4 = {result}')
+				logger.info('Queue RPC calculation completed')
 				result = broker.exchange(name).call(
 					{
 						'a': 30,
@@ -139,7 +161,7 @@ if __name__ == '__main__':
 					timeout=5,
 					event='divide',
 				)
-				print(f'Exchange RPC: 30 / 5 = {result}')
+				logger.info('Exchange RPC calculation completed')
 				try:
 					broker.queue(name).call(
 						{
@@ -148,11 +170,8 @@ if __name__ == '__main__':
 						},
 						timeout=5,
 					)
-				except RemoteError as error:
-					print(
-						f'RPC rejected: {error}',
-						file=stderr,
-					)
+				except RemoteError:
+					logger.warning('RPC remote calculation rejection confirmed')
 			finally:
 				stopping.set()
 				server.result(timeout=10)
@@ -166,3 +185,4 @@ if __name__ == '__main__':
 					broker.delete_exchange(name)
 			finally:
 				broker.close()
+	logger.info('RabbitMQ RPC sample finished')

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5}/sample/Sample.Stream.py

@@ -8,8 +8,27 @@ from DefStream.Broker.Implements.RabbitMQ import (
 )
 from threading import Timer
 from random import randint
+from logging import (
+	DEBUG,
+	Filter,
+	Formatter,
+	StreamHandler,
+	getLogger,
+)
+
+logger = getLogger('Sample')
 
 if __name__ == '__main__':
+	root = getLogger()
+	root.setLevel(DEBUG)
+	console = StreamHandler()
+	console.setLevel(DEBUG)
+	sample_filter = Filter('Sample')
+	rabbitmq_filter = Filter('DefStream.Broker.Implements.RabbitMQ')
+	console.addFilter(lambda record: sample_filter.filter(record) or rabbitmq_filter.filter(record))
+	console.setFormatter(Formatter('%(asctime)s %(levelname)s %(name)s %(message)s'))
+	root.addHandler(console)
+	logger.info('Starting RabbitMQ Stream sample')
 
 	con = RabbitConnection(
 		Configuration(
@@ -39,7 +58,7 @@ if __name__ == '__main__':
 			event: Event,
 		):
 			try:
-				print(event.body)
+				logger.debug('Processing Stream message: message_id=%s', event.id)
 				event.ack()
 			except RuntimeError:
 				event.nack()  # if you want requeue message
@@ -51,8 +70,7 @@ if __name__ == '__main__':
 		2,
 		5,
 	)):
-		print('Consuming Events from Stream Queue: {}'.format(i + 1))	
-		print('-' * 20)
+		logger.info('Starting Stream subscription: iteration=%s', i + 1)
 		consumer = con.consumer(
 			handler=SampleEventHandler(),
 			qos=1,
@@ -71,14 +89,14 @@ if __name__ == '__main__':
 		consumer.subs('stream')
 		consumer.run()
 
-	print('Read Events from Stream Queue:')	
-	print('-' * 20)	
+	logger.info('Starting Stream read loop')
 	stream = con.stream('stream')
 	try:
 		for event in stream.read(timeout=1000):
-			print(event.body)
+			logger.debug('Reading Stream message: message_id=%s', event.id)
 	except KeyboardInterrupt:
 		pass
 
 	con.delete_stream('stream')
 	con.close()
+	logger.info('RabbitMQ Stream sample finished')

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5}/sample/Sample.py

@@ -8,8 +8,27 @@ from DefStream.Broker.Implements.RabbitMQ import (
 	EventHandler,
 )
 from threading import Timer
+from logging import (
+	DEBUG,
+	Filter,
+	Formatter,
+	StreamHandler,
+	getLogger,
+)
+
+logger = getLogger('Sample')
 
 if __name__ == '__main__':
+	root = getLogger()
+	root.setLevel(DEBUG)
+	console = StreamHandler()
+	console.setLevel(DEBUG)
+	sample_filter = Filter('Sample')
+	rabbitmq_filter = Filter('DefStream.Broker.Implements.RabbitMQ')
+	console.addFilter(lambda record: sample_filter.filter(record) or rabbitmq_filter.filter(record))
+	console.setFormatter(Formatter('%(asctime)s %(levelname)s %(name)s %(message)s'))
+	root.addHandler(console)
+	logger.info('Starting RabbitMQ queue and exchange sample')
 
 	con = RabbitConnection(
 		Configuration(
@@ -54,10 +73,10 @@ if __name__ == '__main__':
 
 	reader = con.queue('queue')
 	e = reader.pop()
-	print(e)
+	logger.debug('Single message received: queue=%s message_id=%s', e.src, e.id)
 	e.ack()
 	e = reader.pop()
-	print(e)
+	logger.debug('Single message received: queue=%s message_id=%s', e.src, e.id)
 	e.ack()
 
 	exchange.send(
@@ -97,8 +116,7 @@ if __name__ == '__main__':
 			event: Event,
 		):
 			try:
-				print(event.body)
-				print(event.priority)
+				logger.debug('Processing message: message_id=%s priority=%s', event.id, event.priority)
 				event.ack()
 			except RuntimeError:
 				event.nack()  # if you want requeue message
@@ -125,3 +143,4 @@ if __name__ == '__main__':
 	con.delete_queue('queue')
 	con.delete_exchange('topic')
 	con.close()
+	logger.info('RabbitMQ queue and exchange sample finished')

{defstream_rabbitmq-0.1.4 → defstream_rabbitmq-0.1.5}/setup.py

@@ -50,7 +50,7 @@ setup(
 	package_dir=PACKAGE_DIR,
 	include_package_data=False,
 	install_requires=[
-		'DefStream>=0.1.7',
+		'DefStream>=0.1.9',
 		'pika>=1.3.2',
 	],
 	classifiers=[