DefStream 0.1.23__tar.gz → 0.1.24__tar.gz

defstream-0.1.24/.github/scripts/run_core_tests.py

@@ -0,0 +1,26 @@
+from pathlib import Path
+from sys import (
+	exit,
+	path as module_path,
+)
+from unittest import TestLoader, TextTestRunner
+
+ROOT = Path(__file__).resolve().parents[2]
+
+
+def main() -> int:
+	module_path.insert(
+		0,
+		str(ROOT),
+	)
+	modules: list[str] = [
+		f'tests.{test_file.stem}'
+		for test_file in sorted((ROOT / 'tests').glob('test_*.py'))
+	]
+	suite = TestLoader().loadTestsFromNames(modules)
+	result = TextTestRunner(verbosity=2).run(suite)
+	return 0 if result.wasSuccessful() else 1
+
+
+if __name__ == '__main__':
+	exit(main())

{defstream-0.1.23 → defstream-0.1.24}/.github/workflows/ci.yml

@@ -182,31 +182,6 @@ jobs:
             os: ubuntu-24.04
     env:
       PROJECT: DefStream
-      DEFSTREAM_RABBITMQ_TESTS: '1'
-      DEFSTREAM_REDIS_TESTS: '1'
-    services:
-      rabbitmq:
-        image: rabbitmq:4.1
-        ports:
-          - 5672:5672
-        env:
-          RABBITMQ_DEFAULT_USER: guest
-          RABBITMQ_DEFAULT_PASS: guest
-          RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS: '-rabbit loopback_users []'
-        options: >-
-          --health-cmd "rabbitmq-diagnostics -q ping"
-          --health-interval 10s
-          --health-timeout 10s
-          --health-retries 12
-      redis:
-        image: redis:7.4
-        ports:
-          - 6379:6379
-        options: >-
-          --health-cmd "redis-cli ping"
-          --health-interval 5s
-          --health-timeout 5s
-          --health-retries 12
     steps:
       - name: Check out core
         uses: actions/checkout@v7
@@ -310,11 +285,10 @@ jobs:
           "$RUNNER_TEMP/installed/bin/python" -m pip install dist/*.whl
           "$RUNNER_TEMP/installed/bin/python" -m pip check
 
-      - name: Test installed package
+      - name: Test core installed package
         run: |
           cd "$RUNNER_TEMP"
-          "$RUNNER_TEMP/installed/bin/python" -m unittest discover \
-            -s "$GITHUB_WORKSPACE/tests" -p 'test_*.py' -v
+          "$RUNNER_TEMP/installed/bin/python" "$GITHUB_WORKSPACE/.github/scripts/run_core_tests.py"
 
       - name: Set up Node for core UI tests
         uses: actions/setup-node@v7
@@ -333,10 +307,124 @@ jobs:
           if-no-files-found: error
           retention-days: 14
 
+  test-rabbitmq:
+    name: Test RabbitMQ ${{ matrix.broker.version }} / Python ${{ matrix.python }}
+    needs: changes
+    runs-on: ${{ matrix.os || 'ubuntu-latest' }}
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+        broker:
+          - version: '3.13'
+            compose_file: res/docker/rabbitmq/rabbitmq-3.yml
+            port: '55630'
+          - version: '4.4'
+            compose_file: res/docker/rabbitmq/rabbitmq-4.yml
+            port: '55640'
+        include:
+          - python: '3.9'
+            os: ubuntu-24.04
+    env:
+      RABBITMQ_TESTS: '1'
+      RABBITMQ_PORT: ${{ matrix.broker.port }}
+      BROKER_COMPOSE_FILE: ${{ matrix.broker.compose_file }}
+    steps:
+      - name: Check out core
+        uses: actions/checkout@v7
+        with:
+          ref: ${{ github.sha }}
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install source and RabbitMQ client
+        run: |
+          python -m pip install --upgrade "pip>=23" "setuptools>=77" "setuptools-scm>=8,<10" wheel
+          python -m pip install --editable . --config-settings EXTRAS=RabbitMQ
+
+      - name: Start RabbitMQ ${{ matrix.broker.version }}
+        run: docker compose -f "$BROKER_COMPOSE_FILE" up -d --wait
+
+      - name: Verify RabbitMQ plugins
+        run: |
+          enabled_plugins="$(
+            docker compose -f "$BROKER_COMPOSE_FILE" exec -T rabbitmq rabbitmq-plugins list --enabled --minimal
+          )"
+          for plugin in rabbitmq_management rabbitmq_prometheus rabbitmq_shovel rabbitmq_shovel_management; do
+            if ! grep -Fxq "$plugin" <<< "$enabled_plugins"; then
+              echo "RabbitMQ plugin is not enabled: $plugin" >&2
+              exit 1
+            fi
+          done
+
+      - name: Test RabbitMQ broker and worker compatibility
+        run: python -m unittest discover -s tests/rabbitmq -t . -p 'test_*.py' -v
+
+      - name: Stop broker containers
+        if: always()
+        run: docker compose -f "$BROKER_COMPOSE_FILE" down --remove-orphans
+
+  test-redis:
+    name: Test Redis ${{ matrix.broker.version }} / Python ${{ matrix.python }}
+    needs: changes
+    runs-on: ${{ matrix.os || 'ubuntu-latest' }}
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+        broker:
+          - version: '6.2'
+            compose_file: res/docker/redis/redis-6.yml
+            port: '56376'
+          - version: '7.4'
+            compose_file: res/docker/redis/redis-7.yml
+            port: '56377'
+        include:
+          - python: '3.9'
+            os: ubuntu-24.04
+    env:
+      REDIS_TESTS: '1'
+      REDIS_PORT: ${{ matrix.broker.port }}
+      BROKER_COMPOSE_FILE: ${{ matrix.broker.compose_file }}
+    steps:
+      - name: Check out core
+        uses: actions/checkout@v7
+        with:
+          ref: ${{ github.sha }}
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install source and Redis client
+        run: |
+          python -m pip install --upgrade "pip>=23" "setuptools>=77" "setuptools-scm>=8,<10" wheel
+          python -m pip install --editable . --config-settings EXTRAS=Redis
+
+      - name: Start Redis ${{ matrix.broker.version }}
+        run: docker compose -f "$BROKER_COMPOSE_FILE" up -d --wait
+
+      - name: Test Redis broker and worker compatibility
+        run: python -m unittest discover -s tests/redis -t . -p 'test_*.py' -v
+
+      - name: Stop broker container
+        if: always()
+        run: docker compose -f "$BROKER_COMPOSE_FILE" down --remove-orphans
+
   publish:
     name: Publish PyPI
     if: github.event_name == 'push' && github.ref == 'refs/heads/master' && needs.changes.outputs.release == 'true'
-    needs: [changes, test]
+    needs: [changes, test, test-rabbitmq, test-redis]
     runs-on: ubuntu-latest
     timeout-minutes: 10
     environment: pypi

{defstream-0.1.23 → defstream-0.1.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.23
+Version: 0.1.24
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -17,9 +17,9 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: rabbitmq
-Requires-Dist: DefStream-RabbitMQ==0.1.23; extra == "rabbitmq"
+Requires-Dist: DefStream-RabbitMQ==0.1.24; extra == "rabbitmq"
 Provides-Extra: redis
-Requires-Dist: DefStream-Redis==0.1.23; extra == "redis"
+Requires-Dist: DefStream-Redis==0.1.24; extra == "redis"
 Dynamic: author
 Dynamic: classifier
 Dynamic: description

{defstream-0.1.23 → defstream-0.1.24}/build/core/DefStream.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ setup.py
 .github/scripts/create-issues-from-reviews.mjs
 .github/scripts/create-pr-from-issue.mjs
 .github/scripts/prepare_upload.py
+.github/scripts/run_core_tests.py
 .github/scripts/tests/__init__.py
 .github/scripts/tests/create-issues-from-reviews.test.mjs
 .github/scripts/tests/create-pr-from-issue.test.mjs
@@ -233,6 +234,33 @@ issues/task/38/docs/CopilotReviewIssuesSetup.md
 issues/task/38/implements/1793291844133.md
 issues/task/38/tasks/1793291844134.md
 issues/task/38/tasks/1793292234123.md
+issues/task/39/CHANGELOG.md
+issues/task/39/IMPLEMENTS.md
+issues/task/39/PLAN.md
+issues/task/39/README.md
+issues/task/39/REQUIREMENTS.md
+issues/task/39/TASKS.md
+issues/task/39/implements/1793623390266.md
+issues/task/39/implements/1793625464717.md
+issues/task/39/implements/1793626388737.md
+issues/task/39/implements/1793626820522.md
+issues/task/39/implements/1793627348502.md
+issues/task/39/implements/1793628366252.md
+issues/task/39/implements/1793629199999.md
+issues/task/39/implements/1793631035346.md
+issues/task/39/tasks/1793620359610.md
+issues/task/39/tasks/1793621161604.md
+issues/task/39/tasks/1793621502459.md
+issues/task/39/tasks/1793621903677.md
+issues/task/39/tasks/1793623390265.md
+issues/task/39/tasks/1793625269565.md
+issues/task/39/tasks/1793626388737.md
+issues/task/39/tasks/1793626820522.md
+issues/task/39/tasks/1793627348502.md
+issues/task/39/tasks/1793627590185.md
+issues/task/39/tasks/1793628366252.md
+issues/task/39/tasks/1793629199998.md
+issues/task/39/tasks/1793631035345.md
 issues/task/57/CHANGELOG.md
 issues/task/57/IMPLEMENTS.md
 issues/task/57/PLAN.md
@@ -242,6 +270,13 @@ issues/task/57/TASKS.md
 issues/task/57/implements/1793395003714.md
 issues/task/57/tasks/1793395003713.md
 issues/task/57/tasks/1793395058100.md
+res/docker/rabbitmq/README.md
+res/docker/rabbitmq/enabled_plugins
+res/docker/rabbitmq/rabbitmq-3.yml
+res/docker/rabbitmq/rabbitmq-4.yml
+res/docker/redis/README.md
+res/docker/redis/redis-6.yml
+res/docker/redis/redis-7.yml
 samples/Broker/Sample.py
 samples/Broker/RabbitMQ/Sample.RPC.py
 samples/Broker/RabbitMQ/Sample.Stream.py
@@ -321,7 +356,11 @@ src/Worker/Specification.py
 src/Worker/Startup.py
 src/Worker/Worker.py
 src/Worker/__init__.py
+tests/__init__.py
 tests/_support.py
+tests/_support_inspector.py
+tests/_support_inspector_play.py
+tests/_support_task_messages.py
 tests/test_broker_packaging.py
 tests/test_descriptor.py
 tests/test_inspector.py
@@ -332,24 +371,34 @@ tests/test_logging.py
 tests/test_pool_callbacks.py
 tests/test_process_signals.py
 tests/test_protocol_contracts.py
-tests/test_rabbitmq_broker_methods.py
-tests/test_rabbitmq_integration.py
-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
-tests/test_redis_logging.py
 tests/test_runner_hooks.py
 tests/test_specifications.py
 tests/test_status.py
 tests/test_status_ui.cjs
 tests/test_task_messages.py
-tests/test_task_priorities.py
 tests/test_validator_patterns.py
 tests/test_worker.py
 tests/test_worker_recovery.py
 tests/test_worker_startup.py
+tests/rabbitmq/__init__.py
+tests/rabbitmq/test_inspector.py
+tests/rabbitmq/test_inspector_play.py
+tests/rabbitmq/test_rabbitmq_broker_methods.py
+tests/rabbitmq/test_rabbitmq_integration.py
+tests/rabbitmq/test_rabbitmq_logging.py
+tests/rabbitmq/test_rabbitmq_priorities.py
+tests/rabbitmq/test_rabbitmq_rpc.py
+tests/rabbitmq/test_rabbitmq_rpc_integration.py
+tests/rabbitmq/test_rabbitmq_timeouts.py
+tests/rabbitmq/test_rabbitmq_worker.py
+tests/rabbitmq/test_specifications.py
+tests/rabbitmq/test_task_messages.py
+tests/rabbitmq/test_task_priorities.py
+tests/redis/__init__.py
+tests/redis/test_inspector.py
+tests/redis/test_inspector_play.py
+tests/redis/test_redis.py
+tests/redis/test_redis_integration.py
+tests/redis/test_redis_logging.py
+tests/redis/test_task_messages.py
+tests/redis/test_task_priorities.py

defstream-0.1.24/issues/task/39/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 고객 영향 없음
+
+이번 변경은 DefStream의 공개 API나 고객 실행 동작을 변경하지 않습니다. RabbitMQ·Redis용 Docker Compose 구성과 테스트 연결 설정만 추가하여 개발 환경과 GitHub Actions의 브로커 통합 테스트를 지원합니다.

defstream-0.1.24/issues/task/39/IMPLEMENTS.md

@@ -0,0 +1,33 @@
+# 구현 결과
+
+RabbitMQ 3.13·4.4와 Redis 6.2·7.4의 버전별 테스트용 Compose 환경을 추가하고, 로컬 테스트와 GitHub Actions가 각 버전의 포트에 연결하도록 구성했다. RabbitMQ 네 플러그인, 브로커 health check, 별도 컨테이너 이름 및 loopback 한정 포트 공개를 포함한다.
+
+통합 테스트의 환경변수 포트 지정은 기존 기본 포트를 보존한다. CI는 `test`에서 코어 테스트만 실행하고, `test-rabbitmq`와 `test-redis`에서 해당 브로커 전용 테스트와 Worker 호환성 테스트를 각각 실행한다. 브로커 job은 브로커 버전과 Python 3.9~3.14의 전체 조합을 매트릭스로 사용하고 해당 Compose project만 정리한다. 로컬 실행 절차는 [RabbitMQ 안내](../../../res/docker/rabbitmq/README.md)와 [Redis 안내](../../../res/docker/redis/README.md)에 각각 정리했다.
+
+코어 테스트는 `tests/` 루트에, RabbitMQ와 Redis 전용 테스트는 각각 `tests/rabbitmq/`, `tests/redis/`에 분리했다. `tests`를 패키지로 탐색하고 지원 모듈을 `tests.*`로 가져와 `redis` 테스트 디렉터리가 외부 Redis 클라이언트 import를 가리지 않게 했다. 이동한 로그 테스트의 샘플 경로도 프로젝트 루트를 기준으로 조정했다.
+
+`tests/test_broker_packaging.py`는 저장소 루트의 무시된 `DefStream.egg-info` 대신 실제 설치된 distribution 메타데이터를 선택하도록 수정했다. 전체 310개 테스트가 통과하고 15개가 건너뛰어졌으며, 브로커별 테스트도 각각 통과했다. 상세 내용은 [패키징 테스트 수정 구현 기록](./implements/1793626388737.md)과 [전체 테스트 검증 기록](./tasks/1793626388737.md)에 정리했다.
+
+브로커 통합 테스트 활성화·포트 변수에서 `DEFSTREAM_` 접두사를 제거하고 CI, 테스트 지원 코드와 로컬 실행 안내를 함께 갱신했다. 새 환경 변수 이름을 사용하는 전체 테스트 310개가 통과하고 15개가 건너뛰어졌다. 자세한 내용은 [환경 변수 이름 변경 구현 기록](./implements/1793626820522.md)과 [검증 기록](./tasks/1793626820522.md)을 참고한다.
+
+CI 테스트를 코어·RabbitMQ·Redis job으로 나누고 RabbitMQ 3.13·4.4, Redis 6.2·7.4 각각을 Python 3.9~3.14 전체 조합으로 검증하도록 매트릭스를 확장했다. 코어 전용 테스트 러너로 저장소 루트 테스트 207개 통과를 확인했다. 상세 변경과 제한은 [CI job 분리 구현 기록](./implements/1793627348502.md) 및 [검증 기록](./tasks/1793627348502.md)에 정리했다.
+
+브로커 job ID는 `test-rabbitmq`, `test-redis`로 단순화했다. 별도 job의 기능과 매트릭스 구성은 그대로 유지했다.
+
+실제 RabbitMQ 4.4 테스트에서 transient non-exclusive queue 선언 실패를 확인했다. 통합 테스트가 제품 기본 설정(`durable=True`)과 동일한 큐를 만들도록 수정했고, RabbitMQ 4.4 suite 전체가 통과했다. 자세한 내용은 [RabbitMQ 4 테스트 큐 호환성 수정](./implements/1793628366252.md)을 참고한다.
+
+브로커별 CI job이 선택한 adapter만 설치하는 점에 맞춰 공통 메시지 fixture에서 RabbitMQ 전용 `Reject`와 Redis 연결 import를 제거했다. RabbitMQ와 Redis connection API 검증도 각 전용 suite로 옮겨 다른 adapter가 설치되지 않은 환경에서 테스트를 import할 수 있게 했다. 상세 변경은 [브로커별 메시지 테스트 의존성 분리](./implements/1793629199999.md)에 기록했다.
+
+로컬 Docker에서 네 브로커의 health check와 RabbitMQ 플러그인 상태를 확인하고 Python 3.9·3.10·3.12·3.14 조합 16개를 통과했다. Actions 실행 #41459408504에서는 브로커 24개 job이 교차 import로 실패했으나 이를 분리한 뒤 실행 #41461742854에서 코어와 브로커 24개 job이 모두 통과했다. 이후 PR 리뷰에서 발견한 플러그인 이름의 부분 문자열 검사와 미사용 import를 수정했으며, 수정 내용은 [PR 리뷰 지적 수정](./implements/1793631035346.md)에 기록했다. 후속 CI 실행은 대기 중이다.
+
+Compose 설정과 이전 정적 검증은 [기존 작업 기록](./tasks/1793623390265.md)에, 테스트 분리와 검증은 [테스트 분리 작업 기록](./tasks/1793625269565.md)에 정리했다.
+
+## 단계별 구현 기록
+
+- [버전별 RabbitMQ·Redis 테스트 환경 추가](./implements/1793623390266.md)
+- [코어·브로커 테스트 분리](./implements/1793625464717.md)
+- [패키징 테스트 메타데이터 선택 수정](./implements/1793626388737.md)
+- [브로커 테스트 환경 변수 이름 변경](./implements/1793626820522.md)
+- [CI 테스트 job 분리와 버전 매트릭스](./implements/1793627348502.md)
+- [브로커별 메시지 테스트 의존성 분리](./implements/1793629199999.md)
+- [PR 리뷰 지적 수정](./implements/1793631035346.md)

defstream-0.1.24/issues/task/39/PLAN.md

@@ -0,0 +1,52 @@
+# 작업 계획
+
+## 대상 요구사항
+
+- RabbitMQ `3.13.x`·`4.4.x` 및 지정된 네 플러그인
+- Redis `6.2`·`7.4` 경계 버전 검증
+- 브로커별·버전별 Compose 파일, 컨테이너 이름, loopback 포트와 health check
+- `tests/`의 코어 테스트와 `tests/rabbitmq/`, `tests/redis/`의 브로커 전용 테스트 분리
+- 로컬 및 GitHub Actions 통합 테스트 실행
+
+## 수행 순서
+
+1. `res/docker/rabbitmq/`와 `res/docker/redis/`에 버전별 Compose 파일을 작성하고 RabbitMQ의 활성 플러그인 설정을 추가한다.
+2. 구성 파일의 이미지, 고정 컨테이너 이름, 포트, health check와 플러그인 설정을 정적으로 검증한다.
+3. 테스트가 Compose가 게시하는 RabbitMQ 포트 `55630`·`55640`, Redis 포트 `56376`·`56377`에 연결할 수 있도록 기존 통합 테스트 설정을 확인하고 필요한 부분만 조정한다.
+4. 코어 테스트를 `tests/` 루트에 두고 RabbitMQ·Redis 전용 테스트를 각각 하위 디렉터리에 분리한다. 전체 discovery에서 외부 `redis` 클라이언트 패키지가 테스트 디렉터리에 가려지지 않도록 패키지 경로를 설정한다.
+5. GitHub Actions에서 `test` job은 코어 테스트만 실행하고, `test-rabbitmq`·`test-redis` job은 각 브로커의 전용 테스트와 Worker 호환성 테스트를 수행하도록 분리한다. 각 브로커 job은 해당 브로커의 지원 버전과 Python `3.9`~`3.14`의 전체 조합을 매트릭스로 실행한다.
+6. Docker 엔진이 사용 가능하면 각 Compose 리소스를 기동하여 health check, RabbitMQ 플러그인 활성화와 통합 테스트를 검증한다. 사용할 수 없으면 실행하지 못한 범위를 기록한다.
+7. 로컬 실행·종료 방법과 포트·플러그인 정보를 작업 기록 및 필요한 문서에 반영하고 상대 링크를 검증한다.
+
+## 진행 상태
+
+- [x] 버전별 Compose 파일, 컨테이너 이름, 포트, health check와 RabbitMQ 플러그인 설정 추가
+- [x] 네 Compose 파일의 구문·이미지·컨테이너 이름·포트 검증
+- [x] 통합 테스트 포트 환경변수 연결
+- [x] 코어·RabbitMQ·Redis 테스트 디렉터리 분리 및 전체 discovery 연결
+- [x] 코어·RabbitMQ·Redis CI job 분리, 브로커 버전 × Python 버전 전체 매트릭스와 플러그인 검사·정리 절차 추가
+- [x] 교차 import 수정 후 GitHub Actions 브로커 매트릭스 24개 job 재실행 및 통과 확인
+- [ ] PR 리뷰의 플러그인 정확 일치 검사·미사용 import 수정 후 CI 재실행
+- [x] 실제 컨테이너 기동·health check·플러그인 및 브로커 통합 테스트: 네 브로커와 16개 로컬 브로커 × Python 조합 검증
+- [x] 로컬 실행 문서와 작업 기록 갱신
+
+## 검증 방법
+
+- Docker Compose 설정 검증 명령으로 네 Compose 파일을 각각 확인한다.
+- 통합 테스트를 RabbitMQ `3.13.x`와 `4.4.x`, Redis `6.2`와 `7.4`에 연결하여 실행한다.
+- RabbitMQ `rabbitmq-plugins list --enabled` 결과에서 네 플러그인을 확인한다.
+- 저장소의 기존 CI 테스트 범위와 패키지 검증이 유지되는지 확인한다.
+
+## 실행 결과
+
+- `docker compose config --format json`으로 네 Compose 파일의 구문을 검사하고 각 이미지, Compose project 이름, 컨테이너 이름과 포트 매핑을 확인했다.
+- 코어 테스트를 `tests/`, RabbitMQ 테스트를 `tests/rabbitmq/`, Redis 테스트를 `tests/redis/`에 분리했다. 패키지 경로 기반 unittest discovery와 `tests/redis` 이름 충돌 방지 설정을 적용했다.
+- 브로커별 discovery는 RabbitMQ 71개(7개 건너뜀), Redis 32개(8개 건너뜀)로 통과했다. 변경된 코어 Inspector·Play·runner hook 테스트 40개, 명세 테스트 28개, 메시지 테스트 11개(3개 건너뜀)도 통과했다.
+- 저장소 루트의 로컬 egg-info가 설치된 distribution보다 우선 선택되는 문제를 패키징 테스트에서 해결했다. CI와 같은 외부 작업 디렉터리에서 전체 discovery를 실행해 310개 테스트 통과와 15개 건너뜀을 확인했다.
+- RabbitMQ 71개(7개 건너뜀), Redis 32개(8개 건너뜀) 테스트와 GitHub Actions YAML 파싱, `git diff --check`도 통과했다. 상세 결과는 [패키징 테스트 수정 및 전체 테스트 검증 기록](./tasks/1793626388737.md)을 참고한다.
+- 브로커 테스트 환경 변수 이름에서 `DEFSTREAM_` 접두사를 제거하고 CI, 테스트, 로컬 실행 안내와 요구사항 명세를 갱신했다. 새 포트 변수 조회 및 전체 310개 테스트(15개 건너뜀)를 통과했다. 자세한 내용은 [브로커 테스트 환경 변수 이름 변경 검증](./tasks/1793626820522.md)에 기록했다.
+- CI에서 코어 테스트를 루트 테스트 모듈로 제한하고 RabbitMQ·Redis job을 각각 분리했다. 각 브로커 job은 두 지원 버전과 Python 3.9~3.14의 12개 조합을 실행하도록 구성했다. 전용 core runner에서 코어 테스트 207개가 통과했으며 YAML 구조상 총 6개 코어 조합과 브로커별 12개 조합이 확인됐다. Docker 엔진이 없어 매트릭스의 실제 브로커 실행은 검증하지 못했다. 자세한 내용은 [CI 테스트 매트릭스 분리 기록](./tasks/1793627348502.md)을 참고한다.
+- 브로커 job ID를 `test-rabbitmq`, `test-redis`로 단순화하고 publish 의존 관계와 이슈 기록을 갱신했다. 변경 내용은 [CI 브로커 job 이름 단순화 기록](./tasks/1793627590185.md)에 기록했다.
+- RabbitMQ 3.13·4.4와 Redis 6.2·7.4를 기동해 health check를 통과시켰고 RabbitMQ 필수 플러그인을 확인했다. 설치된 Python 3.9·3.10·3.12·3.14 각 버전에서 네 브로커 테스트를 실행해 16개 조합을 통과했다. 최초 RabbitMQ 4.4 실행에서 확인된 transient non-exclusive queue 호환성 문제는 테스트 큐를 제품 기본 계약과 일치하도록 durable하게 선언해 해결했다. 상세 결과는 [Docker 기반 통합 테스트 기록](./tasks/1793628366252.md), 수정 내용은 [구현 기록](./implements/1793628366252.md)을 참고한다.
+- GitHub Actions 실행 #41459408504에서 코어 테스트는 통과했지만 24개 브로커 job은 공통 테스트 모듈의 RabbitMQ·Redis 교차 import로 실패했다. 공통 fixture와 브로커별 API 검증을 분리한 뒤 실행 #41461742854에서 코어 및 브로커 24개 job 전체가 통과했다. 원인과 로컬 import 격리 결과는 [작업 기록](./tasks/1793629199998.md)을 참고한다.
+- PR 리뷰에서 지적한 플러그인 이름 부분 문자열 비교와 미사용 import를 수정했다. `tests.test_inspector_play` 21개가 통과했고, 수정 후 CI 재실행 결과는 대기 중이다. [리뷰 수정 작업 기록](./tasks/1793631035345.md)을 참고한다.

defstream-0.1.24/issues/task/39/README.md

@@ -0,0 +1,85 @@
+# RabbitMQ·Redis 지원 범위에 맞는 테스트·워크플로용 Docker 설정 리소스 제공
+
+## 이슈 정보
+
+| 항목 | 내용 |
+| --- | --- |
+| 출처 | GitHub Issues |
+| 저장소 | `yong5eon/DefStream` |
+| 원본 이슈 | [#39](https://github.com/yong5eon/DefStream/issues/39) |
+| 상태 | Open |
+| 유형·레이블 | 작업 (`task`, 원본 이슈에 적용됨) |
+| 로컬 진행 상태 | 네 브로커 버전과 Python 3.9·3.10·3.12·3.14의 16개 조합 통과; import 분리 후 Actions 실행 #41461742854에서 코어와 브로커 24개 job 통과; PR 리뷰 지적 2건을 수정해 후속 CI 대기 |
+| 작업 브랜치 | `task/39` |
+| 분기 기준 | `master` |
+| 병합 대상 브랜치 | 미지정 |
+
+## 원본 이슈
+
+## 목적
+
+DefStream의 RabbitMQ와 Redis 지원 범위에 맞는 Docker 설정 리소스를 제공하여, 로컬 테스트와 GitHub Actions 워크플로에서 재현 가능한 브로커 환경을 사용할 수 있도록 합니다. 이 이슈는 추후 수행할 작업을 등록하는 것이며 현재 구성이 제공되었다는 의미는 아닙니다.
+
+## 작업 범위
+
+- 프로젝트의 RabbitMQ와 Redis 지원 버전 및 필요한 구성 범위를 확인하고, 그 범위에 맞는 Docker 설정 리소스를 제공합니다. 지원 범위가 불명확하면 구현 전에 확정하며 임의로 버전을 확대하거나 축소하지 않습니다.
+- 테스트에 필요한 브로커 설정, 연결 정보, 준비 상태 확인 방법을 포함하여 일관된 테스트 환경을 구성합니다.
+- 로컬 테스트와 GitHub Actions 워크플로에서 해당 리소스를 활용할 수 있도록 연결합니다. 지원 버전별 검증이 필요한 경우 확인된 지원 범위에 맞춰 테스트 구성을 마련합니다.
+- 브로커가 준비된 뒤 테스트를 실행하고, 기동 실패·연결 실패·테스트 실패가 성공으로 처리되지 않도록 합니다.
+- 테스트 환경의 기동·종료·정리 절차와 실행 방법을 한국어로 문서화하고, 관련 영문 문서는 프로젝트 지침에 따라 동기화합니다.
+- 운영 자격 증명을 포함하지 않고, 테스트용 설정과 운영용 설정의 차이를 명확히 합니다. 로컬 사용자 데이터나 다른 컨테이너에 영향을 주지 않도록 테스트 자원을 구분합니다.
+
+## 완료 기준
+
+- [ ] RabbitMQ와 Redis의 지원 버전·구성 범위가 확인되고 Docker 리소스와 대응됨
+- [ ] 제공된 리소스로 로컬 브로커 환경을 기동하여 관련 통합 테스트를 실행할 수 있음
+- [ ] GitHub Actions에서 같은 지원 범위에 대한 브로커 테스트가 실행됨
+- [ ] 브로커 준비 상태 확인, 실패 전파 및 테스트 자원 정리 동작이 검증됨
+- [ ] 실행에 필요한 환경·명령·연결 설정·종료 및 정리 방법이 문서화됨
+- [ ] 실제 검증한 버전과 테스트 범위, 검증하지 못한 범위가 기록됨
+
+## 추가 요청사항
+
+- RabbitMQ 컨테이너는 다음 플러그인을 활성화하여 생성합니다.
+  - `rabbitmq_management`
+  - `rabbitmq_prometheus`
+  - `rabbitmq_shovel`
+  - `rabbitmq_shovel_management`
+- RabbitMQ는 각 메이저의 최신 마이너 계열인 `3.13.x`와 `4.4.x`를 지원 대상으로 조사·검증합니다. `3.13.x`는 RabbitMQ 자체의 커뮤니티 지원이 종료된 계열이므로, 이는 DefStream이 별도로 유지할 호환성 범위입니다.
+- Redis Streams는 Redis 5.0에서 도입되었지만, DefStream은 기본 소비 복구에 Redis 6.2에서 도입된 `XAUTOCLAIM`을 사용하므로 지원 하한은 `6.2`입니다. Redis CI는 최소 버전인 `6.2`와 현재 CI 검증 버전인 `7.4`를 대상으로 합니다.
+- Compose 파일은 `res/docker/rabbitmq/`와 `res/docker/redis/`에 두고, 컨테이너 이름은 각각 `RabbitMQ-3`, `RabbitMQ-4`, `Redis-6`, `Redis-7`로 지정합니다.
+
+## 현재 진행 상태
+
+- 네 Compose 파일, RabbitMQ 플러그인 설정, 통합 테스트 포트 연결과 CI 검증 job을 추가했습니다.
+- 코어 테스트는 `tests/`, RabbitMQ 전용 테스트는 `tests/rabbitmq/`, Redis 전용 테스트는 `tests/redis/`로 분리하고 전체 discovery가 하위 테스트를 포함하도록 구성했습니다.
+- CI가 저장소 외부에서 테스트를 실행할 때도 동일하게 탐색하도록 top-level 경로를 지정했습니다.
+- 저장소 루트의 로컬 egg-info가 설치된 distribution 메타데이터를 가리는 문제를 패키징 테스트에서 해결했습니다. CI와 같은 외부 작업 디렉터리 기준 전체 310개 테스트가 통과했고 15개는 건너뛰었습니다.
+- 로컬 Docker에서 네 브로커의 health check와 RabbitMQ 플러그인을 확인하고 16개 브로커 × Python 조합을 통과했습니다. 공통 fixture의 교차 import를 분리한 뒤 Actions 실행 #41461742854에서 코어 테스트와 RabbitMQ·Redis 24개 job이 모두 통과했습니다. 이후 PR 리뷰에서 지적한 RabbitMQ 플러그인 이름의 정확 일치 검사와 미사용 import를 수정했으며, 이 변경을 포함한 CI 재실행은 대기 중입니다.
+
+## 작업 기록
+
+- [요구사항 명세서](./REQUIREMENTS.md)
+- [작업 계획서](./PLAN.md)
+- [RabbitMQ 로컬 테스트 환경](../../../res/docker/rabbitmq/README.md)
+- [Redis 로컬 테스트 환경](../../../res/docker/redis/README.md)
+- [구현 종합 기록](./IMPLEMENTS.md)
+- [고객용 변경 로그](./CHANGELOG.md)
+- [패키징 테스트 수정·전체 테스트 검증 기록](./tasks/1793626388737.md)
+- [패키징 테스트 메타데이터 선택 수정](./implements/1793626388737.md)
+- [브로커 환경 변수 이름 변경 작업 기록](./tasks/1793626820522.md)
+- [브로커 테스트 환경 변수 이름 변경 구현 기록](./implements/1793626820522.md)
+- [CI 매트릭스 분리 작업 기록](./tasks/1793627348502.md)
+- [CI 테스트 job 분리 구현 기록](./implements/1793627348502.md)
+- [CI 브로커 job 이름 단순화 기록](./tasks/1793627590185.md)
+- [Docker 기반 브로커 × Python 통합 테스트 기록](./tasks/1793628366252.md)
+- [RabbitMQ 4 테스트 큐 호환성 수정 기록](./implements/1793628366252.md)
+- [브로커별 메시지 테스트 import 격리 검증](./tasks/1793629199998.md)
+- [브로커별 메시지 테스트 의존성 분리](./implements/1793629199999.md)
+- [PR 리뷰 수정 검증](./tasks/1793631035345.md)
+- [PR 리뷰 지적 수정](./implements/1793631035346.md)
+- [테스트 분리·검증 작업 기록](./tasks/1793625269565.md)
+- [테스트 분리 구현 기록](./implements/1793625464717.md)
+- RabbitMQ 지원 버전 조사: [조사 결과](./TASKS.md), [단계별 기록](./tasks/1793620359610.md), [버전 범위 결정](./tasks/1793621161604.md)
+- Redis Streams 최소 버전 조사: [조사 결과](./TASKS.md), [단계별 기록](./tasks/1793621502459.md)
+- Redis 최소 버전 및 CI 검증 대상 결정: [단계별 기록](./tasks/1793621903677.md)

defstream-0.1.24/issues/task/39/REQUIREMENTS.md

@@ -0,0 +1,54 @@
+# 요구사항 명세
+
+## 목적
+
+RabbitMQ와 Redis 지원 범위의 경계 버전에서 통합 테스트를 실행할 수 있도록 버전별 Docker Compose 리소스를 제공한다.
+
+## 확정 요구사항
+
+- RabbitMQ는 `3.13.x`와 `4.4.x`, Redis는 `6.2` 이상을 지원 대상으로 한다.
+- 버전별 Compose 파일을 다음 위치에 분리한다.
+  - `res/docker/rabbitmq/rabbitmq-3.yml`
+  - `res/docker/rabbitmq/rabbitmq-4.yml`
+  - `res/docker/redis/redis-6.yml`
+  - `res/docker/redis/redis-7.yml`
+- RabbitMQ 컨테이너는 각각 `RabbitMQ-3`, `RabbitMQ-4`로 생성하고 다음 플러그인을 활성화한다.
+  - `rabbitmq_management`
+  - `rabbitmq_prometheus`
+  - `rabbitmq_shovel`
+  - `rabbitmq_shovel_management`
+- RabbitMQ 포트는 다음처럼 호스트 loopback에 게시한다.
+
+  | 컨테이너 | AMQP | Management | Prometheus |
+  | --- | --- | --- | --- |
+  | `RabbitMQ-3` | `55630:5672` | `55631:15672` | `55632:15692` |
+  | `RabbitMQ-4` | `55640:5672` | `55641:15672` | `55642:15692` |
+
+- Redis 컨테이너는 `Redis-6`, `Redis-7`로 생성하고 다음 포트를 호스트 loopback에 게시한다.
+  - `Redis-6`: `56376:6379`
+  - `Redis-7`: `56377:6379`
+- 모든 컨테이너는 시작 준비 상태를 확인하는 health check를 제공한다.
+- Docker Compose 리소스는 테스트용이며 운영 자격 증명이나 호스트 전체 인터페이스에 대한 포트 공개를 포함하지 않는다.
+- GitHub Actions에서 `test`는 `tests/` 루트의 코어 테스트만 실행한다. `test-rabbitmq`와 `test-redis`는 각각 해당 브로커 전용 테스트와 Worker 호환성 테스트를 실행한다.
+- RabbitMQ `3.13.x`·`4.4.x`, Redis `6.2`·`7.4` 각각에 대해 지원 Python 버전 `3.9`~`3.14`를 조합해 검증한다. 브로커별 검증은 브로커 버전과 Python 버전의 전체 조합으로 실행한다.
+- 코어 테스트는 `tests/` 루트에 두고, RabbitMQ 전용 테스트와 Redis 전용 테스트는 각각 `tests/rabbitmq/`, `tests/redis/`에 분리한다. 전체 테스트 discovery는 세 위치의 테스트를 모두 포함해야 한다.
+
+## 완료 기준
+
+- 각 Compose 파일이 해당 컨테이너 이름, 이미지 계열, 호스트 포트와 health check를 선언한다.
+- RabbitMQ 컨테이너 시작 시 네 플러그인이 모두 활성화된다.
+- 동일 브로커의 버전별 컨테이너를 겹치지 않는 포트로 실행할 수 있다.
+- Docker Compose 설정 검증이 성공하고, Docker 엔진이 사용 가능한 환경에서 컨테이너 기동·health check와 플러그인 활성화를 확인한다.
+- GitHub Actions가 코어 테스트와 브로커별 테스트를 분리하고, 브로커마다 지원 버전과 Python 버전의 모든 조합을 검증한다.
+- `tests/` 루트에는 코어 테스트만 남고, 브로커 전용 테스트는 각 브로커 디렉터리에서 독립적으로 발견·실행된다.
+
+## 통합 테스트 연결 설정
+
+- RabbitMQ 통합 테스트는 `RABBITMQ_PORT`를 사용하고, 미설정 시 기존 기본 포트 `5672`를 사용한다.
+- Redis 통합 테스트는 `REDIS_PORT`를 사용하고, 미설정 시 기존 기본 포트 `6379`를 사용한다.
+- RabbitMQ·Redis 통합 테스트는 각각 `RABBITMQ_TESTS`, `REDIS_TESTS`가 `'1'`일 때 활성화한다.
+- Compose 컨테이너 이름은 `RabbitMQ-3`, `RabbitMQ-4`, `Redis-6`, `Redis-7`이며, 컨테이너를 동시에 실행할 수 있도록 호스트 포트 매핑을 구분한다.
+
+## 확인된 제한사항
+
+- 로컬 환경의 Docker 엔진이 실행되지 않으면 실제 이미지 pull, 컨테이너 기동과 플러그인 상태를 검증할 수 없다. 이 경우 Compose 정적 설정 검증과 미실행 사유를 구분해 기록한다.