DefStream 0.1.13__tar.gz → 0.1.14__tar.gz

defstream-0.1.13/.github/ISSUE_TEMPLATE/feature_request.yml → defstream-0.1.14/.github/ISSUE_TEMPLATE/01.feature.yml

@@ -1,6 +1,9 @@
 name: 기능 제안
-description: DefStream에 추가하거나 개선할 기능을 제안합니다.
-title: "[기능 제안] "
+description: 추가하거나 개선할 기능을 제안합니다.
+labels:
+  - feature
+projects:
+  - yong5eon/7
 body:
   - type: markdown
     attributes:

defstream-0.1.13/.github/ISSUE_TEMPLATE/bug_report.yml → defstream-0.1.14/.github/ISSUE_TEMPLATE/02.bug.yml

@@ -1,6 +1,9 @@
 name: 버그/오류 제보
 description: 예상과 다르게 동작하거나 오류가 발생하는 문제를 제보합니다.
-title: "[버그] "
+labels:
+  - bug
+projects:
+  - yong5eon/7
 body:
   - type: markdown
     attributes:

defstream-0.1.14/.github/ISSUE_TEMPLATE/03.fix.yml

@@ -0,0 +1,57 @@
+name: 변경 제안
+description: 일반 변경이나 핫픽스의 목적과 범위를 정리합니다.
+labels:
+  - fix
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        일반 변경이나 긴급 수정이 필요한 핫픽스를 제안할 때 사용해 주세요.
+        재현 가능한 기존 결함은 버그/오류 제보 양식을 이용해 주세요.
+  - type: dropdown
+    id: change_type
+    attributes:
+      label: 변경 유형
+      description: 제안하는 변경의 성격을 선택해 주세요.
+      options:
+        - 일반 변경
+        - 핫픽스
+    validations:
+      required: true
+  - type: textarea
+    id: purpose
+    attributes:
+      label: 변경 목적
+      description: 왜 이 변경이 필요한지, 해결하려는 불편이나 상황을 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: proposed_changes
+    attributes:
+      label: 제안하는 변경 내용
+      description: 무엇을 어떻게 바꾸면 좋을지 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: 영향 범위
+      description: 영향을 받는 기능, 사용자, 호환성 또는 설정을 알고 있다면 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: hotfix_context
+    attributes:
+      label: 긴급 수정 정보
+      description: 핫픽스인 경우 긴급한 이유, 영향받는 버전 및 임시 대응 방법을 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: 완료 기준
+      description: 변경이 완료되었다고 판단할 수 있는 조건이나 검증 방법을 적어 주세요.
+    validations:
+      required: false

defstream-0.1.14/.github/ISSUE_TEMPLATE/04.task.yml

@@ -0,0 +1,40 @@
+name: 작업 제안
+description: 리소스 변경, 문서화 등 소스 코드 변경이 아닌 작업을 정리합니다.
+labels:
+  - task
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        리소스 변경, 문서 작성·정리 등 소스 코드를 변경하지 않는 작업에 사용해 주세요.
+        기능 추가, 버그 제보 또는 소스 코드 변경은 해당 이슈 양식을 이용해 주세요.
+  - type: textarea
+    id: purpose
+    attributes:
+      label: 작업 목적
+      description: 이 작업이 필요한 이유와 기대하는 효과를 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: 작업 내용 및 대상
+      description: 수행할 작업과 대상 리소스, 문서 또는 경로를 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: 완료 기준
+      description: 작업이 완료되었다고 판단할 수 있는 결과물이나 확인 방법을 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: 관련 자료 및 주의사항
+      description: 참고 링크, 관련 이슈, 사전 준비나 주의사항이 있다면 적어 주세요.
+    validations:
+      required: false

{defstream-0.1.13 → defstream-0.1.14}/.github/PULL_REQUEST_TEMPLATE.md

@@ -4,7 +4,7 @@
 
 ## 변경 유형
 
-- [ ] 버그 수정
+- [ ] 버그 수정 및 일반 변경, 핫픽스 처리
 - [ ] 기능 추가
 - [ ] 호환성에 영향을 주는 변경
 - [ ] 문서 또는 예제 변경

{defstream-0.1.13 → defstream-0.1.14}/.github/workflows/ci.yml

@@ -33,6 +33,7 @@ jobs:
       core_ref: ${{ steps.refs.outputs.core_ref }}
       rabbitmq_ref: ${{ steps.refs.outputs.rabbitmq_ref }}
       redis_ref: ${{ steps.refs.outputs.redis_ref }}
+      test_required: ${{ steps.test_paths.outputs.required }}
     steps:
       - uses: actions/checkout@v7
         with:
@@ -42,6 +43,28 @@ jobs:
         uses: actions/setup-python@v7
         with:
           python-version: '3.13'
+      - name: Detect test-relevant changes
+        id: test_paths
+        run: |
+          python - <<'PY'
+          from json import loads
+          from os import environ
+          from pathlib import Path
+          from subprocess import check_output
+
+          required = True
+          if environ['GITHUB_EVENT_NAME'] == 'pull_request':
+              event = loads(Path(environ['GITHUB_EVENT_PATH']).read_text(encoding='utf-8'))
+              base = event['pull_request']['base']['sha']
+              changed = check_output([
+                  'git', 'diff', '--name-only', '--no-renames', '-z',
+                  f'{base}...{environ["GITHUB_SHA"]}', '--', 'samples/', 'src/', 'tests/', 'setup.py',
+              ])
+              required = bool(changed)
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'required={str(required).lower()}\n')
+          print(f'Test-relevant changes: {required}')
+          PY
       - name: Check complete push range and plan version
         id: changes
         env:
@@ -224,6 +247,7 @@ jobs:
   test:
     name: Test Python ${{ matrix.python }}
     needs: changes
+    if: needs.changes.outputs.test_required == 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 25
     strategy:
@@ -384,8 +408,12 @@ jobs:
       - name: Test installed package
         run: |
           cd "$RUNNER_TEMP"
+          test_directory=test
+          if [ "$PROJECT" = "DefStream" ]; then
+            test_directory=tests
+          fi
           "$RUNNER_TEMP/installed/bin/python" -m unittest discover \
-            -s "$GITHUB_WORKSPACE/packages/$PROJECT/test" -p 'test_*.py' -v
+            -s "$GITHUB_WORKSPACE/packages/$PROJECT/$test_directory" -p 'test_*.py' -v
 
       - name: Set up Node for core UI tests
         if: env.PROJECT == 'DefStream'
@@ -395,7 +423,7 @@ jobs:
 
       - name: Test core UI
         if: env.PROJECT == 'DefStream'
-        run: node --test packages/DefStream/test/test_dashboard_ui.cjs
+        run: node --test packages/DefStream/tests/test_dashboard_ui.cjs
 
       - name: Preserve verified release distributions
         if: needs.changes.outputs.release == 'true' && matrix.python == '3.13'

{defstream-0.1.13 → defstream-0.1.14}/DefStream.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.13
+Version: 0.1.14
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -109,8 +109,8 @@ ProcessPool은 `spawn` 자식 프로세스를 사용하므로 부모의 핸들
 자식도 로그를 출력하려면 import 가능한 `PoolSetup` 구현에서 같은 설정을 적용하고
 `ProcessPool(..., setups=...)`로 전달하세요. 자식 초기화 훅이 실행되기 전의 DEBUG·INFO는
 그 설정으로 수신할 수 없습니다.
-[RabbitMQ 작업 예제의 LoggingSetup](./sample/Worker/RabbitMQ/Tasks.py)과
-[부모·자식 설정 예제](./sample/Worker/RabbitMQ/Worker.py)를 참고하세요.
+[RabbitMQ 작업 예제의 LoggingSetup](./samples/Worker/RabbitMQ/Tasks.py)과
+[부모·자식 설정 예제](./samples/Worker/RabbitMQ/Worker.py)를 참고하세요.
 기존 애플리케이션에서는 이미 설정한 핸들러를 반복 추가하지 않도록 초기화 위치를 관리해야 합니다.
 
 ## 설치
@@ -671,9 +671,9 @@ Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용
 
 ## 예제와 라이선스
 
-- [브로커 없이 실행하는 Worker 예제](./sample/Worker/Sample.py)
-- [RabbitMQ Worker·RPC 클라이언트 예제](./sample/Worker/RabbitMQ)
-- [Redis Worker 예제](./sample/Worker/Redis/Sample.py)
+- [브로커 없이 실행하는 Worker 예제](./samples/Worker/Sample.py)
+- [RabbitMQ Worker·RPC 클라이언트 예제](./samples/Worker/RabbitMQ)
+- [Redis Worker 예제](./samples/Worker/Redis/Sample.py)
 - [릴리즈와 변경 내역](https://github.com/yong5eon/DefStream/releases)
 
 GNU GPL v3 라이선스를 사용합니다. 자세한 조건은 [LICENSE](./LICENSE)를 확인하세요.

{defstream-0.1.13 → defstream-0.1.14}/DefStream.egg-info/SOURCES.txt

@@ -4,10 +4,11 @@ README.en.md
 README.md
 setup.py
 .github/PULL_REQUEST_TEMPLATE.md
-.github/ISSUE_TEMPLATE/bug_report.yml
+.github/ISSUE_TEMPLATE/01.feature.yml
+.github/ISSUE_TEMPLATE/02.bug.yml
+.github/ISSUE_TEMPLATE/03.fix.yml
+.github/ISSUE_TEMPLATE/04.task.yml
 .github/ISSUE_TEMPLATE/config.yml
-.github/ISSUE_TEMPLATE/feature_request.yml
-.github/PULL_REQUEST_TEMPLATE/hotfix.md
 .github/workflows/ci.yml
 DefStream.egg-info/PKG-INFO
 DefStream.egg-info/SOURCES.txt
@@ -31,6 +32,10 @@ issues/fix/10/IMPLEMENTS.md
 issues/fix/10/README.md
 issues/fix/10/REQUIREMENTS.md
 issues/fix/13/README.md
+issues/fix/21/IMPLEMENTS.md
+issues/fix/21/ISSUE.md
+issues/fix/21/README.md
+issues/fix/21/REQUIREMENTS.md
 issues/fix/3/IMPLEMENTS.md
 issues/fix/3/README.md
 issues/fix/3/REQUIREMENTS.md
@@ -38,12 +43,15 @@ issues/fix/3/ci.refs.json
 issues/fix/6/IMPLEMENTS.md
 issues/fix/6/README.md
 issues/fix/6/REQUIREMENTS.md
-sample/Broker/Sample.py
-sample/Worker/Sample.py
-sample/Worker/RabbitMQ/Client.py
-sample/Worker/RabbitMQ/Tasks.py
-sample/Worker/RabbitMQ/Worker.py
-sample/Worker/Redis/Sample.py
+issues/task/18/IMPLEMENTS.md
+issues/task/18/README.md
+issues/task/18/REQUIREMENTS.md
+samples/Broker/Sample.py
+samples/Worker/Sample.py
+samples/Worker/RabbitMQ/Client.py
+samples/Worker/RabbitMQ/Tasks.py
+samples/Worker/RabbitMQ/Worker.py
+samples/Worker/Redis/Sample.py
 src/__init__.py
 src/Broker/Configuration.py
 src/Broker/Connection.py
@@ -95,21 +103,22 @@ src/Worker/Specification.py
 src/Worker/Startup.py
 src/Worker/Worker.py
 src/Worker/__init__.py
-test/test_dashboard.py
-test/test_dashboard_ui.cjs
-test/test_descriptor.py
-test/test_inspector.py
-test/test_inspector_console.py
-test/test_inspector_logging.py
-test/test_lifecycle_hooks.py
-test/test_logging.py
-test/test_pool_callbacks.py
-test/test_process_signals.py
-test/test_protocol_contracts.py
-test/test_release_workflow.py
-test/test_runner_hooks.py
-test/test_specifications.py
-test/test_task_messages.py
-test/test_task_priorities.py
-test/test_worker.py
-test/test_worker_startup.py
+tests/test_dashboard.py
+tests/test_dashboard_ui.cjs
+tests/test_descriptor.py
+tests/test_inspector.py
+tests/test_inspector_console.py
+tests/test_inspector_logging.py
+tests/test_lifecycle_hooks.py
+tests/test_logging.py
+tests/test_pool_callbacks.py
+tests/test_process_signals.py
+tests/test_protocol_contracts.py
+tests/test_release_workflow.py
+tests/test_runner_hooks.py
+tests/test_specifications.py
+tests/test_task_messages.py
+tests/test_task_priorities.py
+tests/test_validator_patterns.py
+tests/test_worker.py
+tests/test_worker_startup.py

{defstream-0.1.13 → defstream-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.13
+Version: 0.1.14
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -109,8 +109,8 @@ ProcessPool은 `spawn` 자식 프로세스를 사용하므로 부모의 핸들
 자식도 로그를 출력하려면 import 가능한 `PoolSetup` 구현에서 같은 설정을 적용하고
 `ProcessPool(..., setups=...)`로 전달하세요. 자식 초기화 훅이 실행되기 전의 DEBUG·INFO는
 그 설정으로 수신할 수 없습니다.
-[RabbitMQ 작업 예제의 LoggingSetup](./sample/Worker/RabbitMQ/Tasks.py)과
-[부모·자식 설정 예제](./sample/Worker/RabbitMQ/Worker.py)를 참고하세요.
+[RabbitMQ 작업 예제의 LoggingSetup](./samples/Worker/RabbitMQ/Tasks.py)과
+[부모·자식 설정 예제](./samples/Worker/RabbitMQ/Worker.py)를 참고하세요.
 기존 애플리케이션에서는 이미 설정한 핸들러를 반복 추가하지 않도록 초기화 위치를 관리해야 합니다.
 
 ## 설치
@@ -671,9 +671,9 @@ Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용
 
 ## 예제와 라이선스
 
-- [브로커 없이 실행하는 Worker 예제](./sample/Worker/Sample.py)
-- [RabbitMQ Worker·RPC 클라이언트 예제](./sample/Worker/RabbitMQ)
-- [Redis Worker 예제](./sample/Worker/Redis/Sample.py)
+- [브로커 없이 실행하는 Worker 예제](./samples/Worker/Sample.py)
+- [RabbitMQ Worker·RPC 클라이언트 예제](./samples/Worker/RabbitMQ)
+- [Redis Worker 예제](./samples/Worker/Redis/Sample.py)
 - [릴리즈와 변경 내역](https://github.com/yong5eon/DefStream/releases)
 
 GNU GPL v3 라이선스를 사용합니다. 자세한 조건은 [LICENSE](./LICENSE)를 확인하세요.

{defstream-0.1.13 → defstream-0.1.14}/README.en.md

@@ -27,15 +27,66 @@ Configure execution, acknowledgements, failure policies, and monitoring without
 - [Lifecycle hooks](#lifecycle-hooks)
 - [Request/reply contracts and validation](#requestreply-contracts-and-validation)
 - [Health checks and task console](#health-checks-and-task-console)
+- [Logging](#logging)
 - [Broker selection and operational considerations](#broker-selection-and-operational-considerations)
 - [Examples and license](#examples-and-license)
 
-## 로깅 지원
+## Logging
 
-클래스별 표준 로거와 사용자 주도 핸들러 설정을 지원합니다.
-샘플은 `Sample` 및 `DefStream` 계층만 출력하며, ProcessPool 자식은 별도 setup 훅으로
-출력을 설정합니다. Worker의 시작 배너는 유지됩니다.
-로거 이름, 선택 수신, 예외 메시지 주의사항과 프로세스 설정은 [로깅 안내](./README.md#로깅)를 참고하세요.
+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
+`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'))
+handler = StreamHandler()
+handler.setFormatter(Formatter(
+  '%(asctime)s %(processName)s %(name)s %(levelname)s %(message)s'
+))
+handler.addFilter(lambda record: any(source.filter(record) for source in sources))
+root = getLogger()
+root.setLevel(DEBUG)
+root.addHandler(handler)
+
+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`.
+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.Implements.RabbitMQ` or `DefStream.Broker.Implements.Redis`
+instead of `DefStream`.
+
+- The class member `logger` uses `DefStream.Worker`, `DefStream.Run`,
+  `DefStream.Executor`, `DefStream.Pool`, `DefStream.ThreadPool`, and
+  `DefStream.ProcessPool`.
+- 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`.
+  HTTP request receipt is DEBUG; response status and transmission results are INFO.
+  Extension-specific logs use `DefStream.Inspector.Extensions.<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.
+- 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.
+
+ProcessPool uses `spawn` child processes, so parent handlers are not automatically
+inherited. To receive child logs, apply the same configuration in an importable
+`PoolSetup` implementation and pass it through `ProcessPool(..., setups=...)`.
+That configuration cannot capture DEBUG and INFO logs emitted before the child
+setup hook runs. See
+[LoggingSetup in the RabbitMQ task example](./samples/Worker/RabbitMQ/Tasks.py)
+and the [parent/child configuration example](./samples/Worker/RabbitMQ/Worker.py).
+In existing applications, choose the initialization location carefully to avoid
+adding the same handlers repeatedly.
 
 ## Installation
 
@@ -610,9 +661,9 @@ For a class-based factory, you can inherit `BrokerFactory` and implement `__call
 
 ## Examples and license
 
-- [Worker without an external broker](./sample/Worker/Sample.py)
-- [RabbitMQ Worker and RPC client](./sample/Worker/RabbitMQ)
-- [Redis Worker](./sample/Worker/Redis/Sample.py)
+- [Worker without an external broker](./samples/Worker/Sample.py)
+- [RabbitMQ Worker and RPC client](./samples/Worker/RabbitMQ)
+- [Redis Worker](./samples/Worker/Redis/Sample.py)
 - [Releases and change history](https://github.com/yong5eon/DefStream/releases)
 
 Licensed under GNU GPL v3. See [LICENSE](./LICENSE) for the terms.

{defstream-0.1.13 → defstream-0.1.14}/README.md

@@ -76,8 +76,8 @@ ProcessPool은 `spawn` 자식 프로세스를 사용하므로 부모의 핸들
 자식도 로그를 출력하려면 import 가능한 `PoolSetup` 구현에서 같은 설정을 적용하고
 `ProcessPool(..., setups=...)`로 전달하세요. 자식 초기화 훅이 실행되기 전의 DEBUG·INFO는
 그 설정으로 수신할 수 없습니다.
-[RabbitMQ 작업 예제의 LoggingSetup](./sample/Worker/RabbitMQ/Tasks.py)과
-[부모·자식 설정 예제](./sample/Worker/RabbitMQ/Worker.py)를 참고하세요.
+[RabbitMQ 작업 예제의 LoggingSetup](./samples/Worker/RabbitMQ/Tasks.py)과
+[부모·자식 설정 예제](./samples/Worker/RabbitMQ/Worker.py)를 참고하세요.
 기존 애플리케이션에서는 이미 설정한 핸들러를 반복 추가하지 않도록 초기화 위치를 관리해야 합니다.
 
 ## 설치
@@ -638,9 +638,9 @@ Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용
 
 ## 예제와 라이선스
 
-- [브로커 없이 실행하는 Worker 예제](./sample/Worker/Sample.py)
-- [RabbitMQ Worker·RPC 클라이언트 예제](./sample/Worker/RabbitMQ)
-- [Redis Worker 예제](./sample/Worker/Redis/Sample.py)
+- [브로커 없이 실행하는 Worker 예제](./samples/Worker/Sample.py)
+- [RabbitMQ Worker·RPC 클라이언트 예제](./samples/Worker/RabbitMQ)
+- [Redis Worker 예제](./samples/Worker/Redis/Sample.py)
 - [릴리즈와 변경 내역](https://github.com/yong5eon/DefStream/releases)
 
 GNU GPL v3 라이선스를 사용합니다. 자세한 조건은 [LICENSE](./LICENSE)를 확인하세요.

{defstream-0.1.13 → defstream-0.1.14}/issues/feature/8/IMPLEMENTS.md

@@ -62,11 +62,11 @@ HealthCheck는 probe 예약·응답·판정과 응답 생성을 DEBUG로 기록
 - 런타임 로그 메시지는 영어로 작성하고 한국어 문서·주석은 유지한다.
 - 본문·결과·인증정보를 기본 문맥에 넣지 않는다. 단, Worker의 작업 실패
   traceback에는 사용자 예외 메시지가 포함될 수 있으므로 사용자가 주의해야 한다.
-- [Worker 샘플](../../../sample/Worker)과 [Broker 샘플](../../../sample/Broker)은
+- [Worker 샘플](../../../samples/Worker)과 [Broker 샘플](../../../samples/Broker)은
   `Sample`과 `DefStream` 계층만 핸들러 필터로 선택한다.
 - 샘플의 `print()`는 로그로 전환하고 라이브러리 시작 배너는 유지했다.
-- [RabbitMQ Worker 샘플](../../../sample/Worker/RabbitMQ/Worker.py)은 부모 진입점과
-  ProcessPool의 `setups`에 [LoggingSetup](../../../sample/Worker/RabbitMQ/Tasks.py)을
+- [RabbitMQ Worker 샘플](../../../samples/Worker/RabbitMQ/Worker.py)은 부모 진입점과
+  ProcessPool의 `setups`에 [LoggingSetup](../../../samples/Worker/RabbitMQ/Tasks.py)을
   적용한다. `spawn` 자식이 부모의 핸들러를 자동 상속한다고 가정하지 않는다.
 
 ## 6. 검증 결과
@@ -81,9 +81,9 @@ Python 3.13.16에서 실제 RabbitMQ·Redis가 실행 중인 환경으로 검증
 | 세 프로젝트 소스·샘플의 로그 및 observe 호출 문자열 | 376곳 점검, 한국어 문자열 없음 |
 | 세 프로젝트 소스·샘플 `compileall` 및 `git diff --check` | 통과 |
 
-[로깅 테스트](../../../test/test_logging.py)는 클래스 멤버·상속·사용자 재정의,
+[로깅 테스트](../../../tests/test_logging.py)는 클래스 멤버·상속·사용자 재정의,
 레벨·본문 제외·작업 실패 traceback 중복 방지·배너 유지·샘플 필터·spawn 설정을
-검증한다. [Inspector 로깅 테스트](../../../test/test_inspector_logging.py)는 실제 HTTP
+검증한다. [Inspector 로깅 테스트](../../../tests/test_inspector_logging.py)는 실제 HTTP
 요청에서 수신·응답 각 1회 기록, 쿼리·본문 제외, WSGI 500과 전송 중단을 검증한다.
 기존 테스트의 이전 모듈 로거 기대값도 새 이름과 레벨에 맞췄다.
 

{defstream-0.1.13 → defstream-0.1.14}/issues/feature/8/README.md

@@ -34,7 +34,7 @@ Pool 공통 동작도 실제 ThreadPool·ProcessPool의 로거 이름으로 기
 ## 샘플 변경
 
 샘플은 `print()` 대신 `Sample` 로거를 사용하며 `Sample`과 `DefStream` 계층만
-출력합니다. [RabbitMQ Worker 샘플](../../../sample/Worker/RabbitMQ/Worker.py)은
-부모와 spawn 자식에 [LoggingSetup](../../../sample/Worker/RabbitMQ/Tasks.py)을 적용합니다.
+출력합니다. [RabbitMQ Worker 샘플](../../../samples/Worker/RabbitMQ/Worker.py)은
+부모와 spawn 자식에 [LoggingSetup](../../../samples/Worker/RabbitMQ/Tasks.py)을 적용합니다.
 실제 애플리케이션도 ProcessPool 자식의 로깅을 별도로 설정해야 합니다.
 설정 예제는 [사용 설명서](../../../README.md#로깅)를 참고하세요.

{defstream-0.1.13 → defstream-0.1.14}/issues/fix/10/IMPLEMENTS.md

@@ -29,8 +29,8 @@
 - [Specification](../../../src/Worker/Specification.py)에서 `description` 인자와
   AsyncAPI 메시지 설명 생성을 제거했다. schema, validator, example, format은
   유지한다.
-- [RabbitMQ Worker 샘플](../../../sample/Worker/RabbitMQ/Tasks.py)과
-  [Redis Worker 샘플](../../../sample/Worker/Redis/Sample.py)에 `add`, `divide`
+- [RabbitMQ Worker 샘플](../../../samples/Worker/RabbitMQ/Tasks.py)과
+  [Redis Worker 샘플](../../../samples/Worker/Redis/Sample.py)에 `add`, `divide`
   이름 및 작업 설명을 지정했다. RabbitMQ 샘플의 request·response
   Specification 설명은 Run의 메타데이터로 옮겼다.
 - [한국어 사용 설명서](../../../README.md)와
@@ -117,7 +117,7 @@ Python 3.9.13과 3.10.11에서 클래스 정의의 `name=` 키워드가
 처리는 계속 `Run.__init_subclass__`가 담당한다. 사용자 클래스 정의 문법은
 변경하지 않으며 `ABCMeta`의 추상 메서드 검사도 유지한다.
 
-[Worker 테스트](../../../test/test_worker.py)에 이름을 지정한 추상 Run의 생성 거부,
+[Worker 테스트](../../../tests/test_worker.py)에 이름을 지정한 추상 Run의 생성 거부,
 구체 하위 Run의 이름 재정의 및 실행을 검증하는 회귀 테스트를 추가했다.
 
 | Python | 전체 코어 테스트 결과 |

{defstream-0.1.13 → defstream-0.1.14}/issues/fix/13/README.md

@@ -8,7 +8,7 @@ Worker 시작 배너를 로깅 설정 여부와 관계없이 먼저 확인할
 
 ## 변경 내용
 
-- [Worker 샘플](../../../sample/Worker/Sample.py)은 `configure_logging()`을
+- [Worker 샘플](../../../samples/Worker/Sample.py)은 `configure_logging()`을
   실행 진입점에서 호출하는 대신 `SetupLogger` setup 훅에서 수행합니다.
   Worker 생성·작업 등록 시점의 로그는 아직 설정되지 않은 핸들러에 의해 출력되지
   않으며, 시작 배너가 샘플의 첫 화면 출력이 됩니다.

defstream-0.1.14/issues/fix/21/IMPLEMENTS.md

@@ -0,0 +1,38 @@
+# Validator `IsOptional` 변경 구현 기록
+
+## 1. 구현 개요
+
+[요구사항 명세서](./REQUIREMENTS.md)에 따라 Validator 패턴의 공개 이름을
+`IsToNone`에서 `IsOptional`로 변경했다. 패턴의 입력 처리와 후속 패턴 실행
+동작은 유지하고 기존 이름은 제거했다.
+
+- 구현·검증일: 2026-10-21
+- 사용자 관점의 변경 요약: 선택적 값을 처리하는 Validator 패턴 이름을 `IsOptional`로 통일
+
+## 2. 변경 내용
+
+- [Common.py](../../../src/Validator/Patterns/Common.py)에서 클래스를
+  `IsToNone`에서 `IsOptional`로 변경하고 모듈의 `__all__`을 갱신했다.
+- [Patterns/__init__.py](../../../src/Validator/Patterns/__init__.py)에서
+  `IsOptional`을 가져오고 패키지 `__all__`에 공개했다.
+- 기존 클래스명과 호환 별칭은 제공하지 않는다. 기존 `IsToNone`을 import하는
+  코드는 `IsOptional`로 변경해야 한다.
+- `None`이면 후속 패턴을 실행하지 않고 그대로 반환하며, 그 외 값에는 전달된
+  패턴을 순서대로 적용한다. `repr`은 새 클래스명을 표시한다.
+- [test_validator_patterns.py](../../../tests/test_validator_patterns.py)에
+  `None` 처리, 패턴 적용 순서, 예외 전파, 공개 export 및 표현 결과를 확인하는
+  테스트 5개를 추가했다.
+
+## 3. 검증 결과
+
+| 검증 항목 | 결과 |
+|---|---|
+| 신규 Validator 패턴 단위 테스트 | 5개 통과 |
+| 테스트 파일 직접 실행 도구 | 테스트를 찾지 못함 |
+| Python unittest 직접 실행 | 통과. 저장소의 `src` 패키지를 `DefStream` 이름으로 등록해 테스트 실행 |
+| 기존 이름 검색 | 소스의 구현 및 공개 export에서 제거 확인. 테스트는 미노출을 검증하기 위해 이름을 참조 |
+
+테스트는 `python -m unittest discover`의 기본 import 방식으로는 저장소 패키지
+이름을 찾지 못해 실행되지 않았다. 테스트 코드에서 현재 소스 패키지를
+`DefStream`으로 등록한 뒤 unittest discovery를 실행하여 검증했다. 다른 테스트
+파일이나 전체 테스트 스위트는 실행하지 않았다.

defstream-0.1.14/issues/fix/21/ISSUE.md

@@ -0,0 +1,17 @@
+### 변경 유형
+
+일반 변경
+
+### 변경 목적
+
+Validator 패턴 중 IsToNone 의 이름이 파이썬에서 사용하는 Optional 처럼 동작해야 해서, 좀더 친숙한 이름으로 변경을 제안
+
+### 제안하는 변경 내용
+
+이름 변경 후보:
+
+- Optional: Python 에서 Optional 을 많이 사용하여 사용 시 알리아스가 필요
+- IsOptional
+- ToOptional
+- AsOptional
+- OfOptional

defstream-0.1.14/issues/fix/21/README.md

@@ -0,0 +1,44 @@
+# Validator 패턴 이름을 `IsOptional`로 변경
+
+## 변경 요약
+
+Validator 패턴의 이름을 `IsToNone`에서 `IsOptional`로 변경했습니다.
+`None` 입력은 그대로 반환하고, 그 외 입력에는 지정한 패턴을 순서대로 적용합니다.
+처리 동작은 달라지지 않았으며 이름만 더 알아보기 쉽게 바뀌었습니다.
+
+## 기존 코드에서 바꿀 부분
+
+기존 `IsToNone` import와 사용 코드를 `IsOptional`로 변경하세요.
+`IsToNone`은 호환 별칭으로 제공되지 않습니다.
+
+변경 전:
+
+```python
+from DefStream.Validator.Patterns import IsToNone
+
+validator = IsToNone(pattern)
+```
+
+변경 후:
+
+```python
+from DefStream.Validator.Patterns import IsOptional
+
+validator = IsOptional(pattern)
+```
+
+`IsOptional`은 Python의 `typing.Optional`이 아니라 런타임 입력값을 처리하는
+Validator 패턴입니다.
+
+## 검증
+
+- `None` 입력 시 후속 패턴을 실행하지 않고 `None` 반환
+- 비`None` 입력 시 후속 패턴을 순서대로 실행
+- 후속 패턴의 예외 전파 및 `repr` 결과 확인
+- 패키지 공개 export와 기존 이름 미노출 확인
+- 신규 단위 테스트 5개 통과
+
+## 상세 기록
+
+- [요구사항 명세서](./REQUIREMENTS.md)
+- [구현 및 검증 기록](./IMPLEMENTS.md)