DefStream 0.1.3.7__tar.gz → 0.1.4.12__tar.gz

{defstream-0.1.3.7 → defstream-0.1.4.12}/.github/workflows/ci.yml

@@ -19,11 +19,17 @@ concurrency:
 jobs:
   changes:
     name: Plan release version
+    permissions:
+      contents: read
+      pull-requests: read
     runs-on: ubuntu-latest
     timeout-minutes: 5
     outputs:
       release: ${{ steps.changes.outputs.release }}
       version: ${{ steps.changes.outputs.version }}
+      core_ref: ${{ steps.refs.outputs.core_ref }}
+      rabbitmq_ref: ${{ steps.refs.outputs.rabbitmq_ref }}
+      redis_ref: ${{ steps.refs.outputs.redis_ref }}
     steps:
       - uses: actions/checkout@v7
         with:
@@ -33,6 +39,96 @@ jobs:
         uses: actions/setup-python@v7
         with:
           python-version: '3.13'
+      - name: Validate PR branch changelog
+        id: changelog
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          python - <<'PY'
+          from json import loads
+          from os import environ
+          from pathlib import Path
+          from subprocess import check_output
+
+          head = environ['GITHUB_SHA']
+          if environ['GITHUB_EVENT_NAME'] == 'pull_request':
+              event = loads(Path(environ['GITHUB_EVENT_PATH']).read_text(encoding='utf-8'))
+              branch = event['pull_request']['head']['ref']
+          else:
+              repository = environ['GITHUB_REPOSITORY']
+              pages = loads(check_output([
+                  'gh', 'api', '--paginate', '--slurp',
+                  f'repos/{repository}/commits/{head}/pulls?per_page=100',
+              ]))
+              pulls = [
+                  pull for page in pages for pull in page
+                  if pull['merged_at'] is not None
+                  and pull['merge_commit_sha'] == head
+                  and pull['base']['ref'] == 'master'
+                  and pull['base']['repo']['full_name'] == repository
+              ]
+              if len(pulls) != 1:
+                  raise ValueError('Expected exactly one merged PR for the release commit')
+              branch = pulls[0]['head']['ref']
+          path = f'issues/{branch}/README.md'
+          entry = check_output(['git', 'ls-tree', head, '--', path]).decode().split()
+          if not entry or entry[0] not in ('100644', '100755'):
+              raise ValueError(f'Changelog must exist as a regular file: {path}')
+          body = check_output(['git', 'show', f'{head}:{path}'])
+          if not body.decode('utf-8').strip():
+              raise ValueError(f'Customer changelog is empty: {path}')
+          notes = Path(environ['RUNNER_TEMP'], 'release-notes', 'README.md')
+          notes.parent.mkdir(parents=True, exist_ok=True)
+          notes.write_bytes(body)
+          print(f'Customer changelog: {path}')
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'branch={branch}\n')
+          PY
+      - name: Resolve dependency refs
+        id: refs
+        env:
+          BRANCH: ${{ steps.changelog.outputs.branch }}
+        run: |
+          python - <<'PY'
+          from json import loads
+          from os import environ
+          from pathlib import Path
+          from subprocess import check_output, run
+
+          head = environ['GITHUB_SHA']
+          path = f'issues/{environ["BRANCH"]}/ci.refs.json'
+          entry = check_output(['git', 'ls-tree', head, '--', path]).decode().split()
+          refs = {}
+          if entry:
+              if entry[0] not in ('100644', '100755'):
+                  raise ValueError(f'Dependency refs must be a regular file: {path}')
+              refs = loads(check_output(['git', 'show', f'{head}:{path}']).decode('utf-8'))
+          else:
+              print(f'{path} not found: dependency refs default to master')
+          projects = {
+              'DefStream': 'core_ref',
+              'DefStream-RabbitMQ': 'rabbitmq_ref',
+              'DefStream-Redis': 'redis_ref',
+          }
+          if not isinstance(refs, dict) or refs.keys() - projects.keys():
+              raise ValueError(f'Expected an object with only supported project names: {path}')
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              for project, key in projects.items():
+                  ref = refs.get(project, 'master')
+                  if not isinstance(ref, str) or not ref or ref.startswith('-'):
+                      raise ValueError(f'Invalid dependency ref for {project}: {ref!r}')
+                  run(['git', 'check-ref-format', '--allow-onelevel', ref], check=True)
+                  output.write(f'{key}={ref}\n')
+                  print(f'{project} dependency ref: {ref}')
+          PY
+      - name: Preserve customer release notes
+        uses: actions/upload-artifact@v7
+        with:
+          name: release-notes
+          path: ${{ runner.temp }}/release-notes/README.md
+          if-no-files-found: error
+          retention-days: 14
+          overwrite: true
       - name: Check complete push range and plan version
         id: changes
         env:
@@ -132,7 +228,7 @@ jobs:
         uses: actions/checkout@v7
         with:
           repository: yong5eon/DefStream
-          ref: ${{ github.event.repository.name == 'DefStream' && github.sha || 'master' }}
+          ref: ${{ github.event.repository.name == 'DefStream' && github.sha || needs.changes.outputs.core_ref }}
           path: packages/DefStream
           fetch-depth: 0
           persist-credentials: false
@@ -141,7 +237,7 @@ jobs:
         uses: actions/checkout@v7
         with:
           repository: yong5eon/DefStream-RabbitMQ
-          ref: ${{ github.event.repository.name == 'DefStream-RabbitMQ' && github.sha || 'master' }}
+          ref: ${{ github.event.repository.name == 'DefStream-RabbitMQ' && github.sha || needs.changes.outputs.rabbitmq_ref }}
           path: packages/DefStream-RabbitMQ
           fetch-depth: 0
           persist-credentials: false
@@ -150,7 +246,7 @@ jobs:
         uses: actions/checkout@v7
         with:
           repository: yong5eon/DefStream-Redis
-          ref: ${{ github.event.repository.name == 'DefStream-Redis' && github.sha || 'master' }}
+          ref: ${{ github.event.repository.name == 'DefStream-Redis' && github.sha || needs.changes.outputs.redis_ref }}
           path: packages/DefStream-Redis
           fetch-depth: 0
           persist-credentials: false
@@ -267,6 +363,12 @@ jobs:
           name: distributions
           path: dist
 
+      - name: Download customer release notes
+        uses: actions/download-artifact@v8
+        with:
+          name: release-notes
+          path: release-notes
+
       - name: Set up Python
         uses: actions/setup-python@v7
         with:
@@ -371,6 +473,9 @@ jobs:
 
           repository = environ['GITHUB_REPOSITORY']
           version = environ['VERSION']
+          notes = Path('release-notes/README.md')
+          if not notes.read_text(encoding='utf-8').strip():
+              raise ValueError('Customer release notes are empty')
           request = Request(
               f'{environ["GITHUB_API_URL"]}/repos/{repository}/releases/tags/{quote(version, safe="")}',
               headers={
@@ -387,7 +492,7 @@ jobs:
                   raise
               run([
                   'gh', 'release', 'create', version, '--repo', repository,
-                  '--verify-tag', '--title', version, '--generate-notes', '--draft',
+                  '--verify-tag', '--title', version, '--notes-file', str(notes), '--draft',
               ], check=True)
           else:
               if release['tag_name'] != version:
@@ -398,6 +503,7 @@ jobs:
               '--clobber', *artifacts,
           ], check=True)
           run([
-              'gh', 'release', 'edit', version, '--repo', repository, '--draft=false',
+              'gh', 'release', 'edit', version, '--repo', repository,
+              '--notes-file', str(notes), '--draft=false',
           ], check=True)
           PY

{defstream-0.1.3.7 → defstream-0.1.4.12}/DefStream.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.3.7
+Version: 0.1.4.12
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -232,6 +232,71 @@ python client.py
 하나의 Worker에서는 같은 큐에 여러 작업을 중복 등록할 수 없습니다.
 메시지 유형을 보고 여러 `Run` 중 하나를 고르는 방식이 아니라 큐별로 작업을 선택합니다.
 
+### 작업 우선순위
+
+RabbitMQ classic 큐에서는 작업 `parameters`의 RabbitMQ `Subscription`에
+`priority`로 기본 메시지 우선순위, `max_priority`로 큐 최대값을 함께 정의합니다.
+`Run`에 별도의 `priority` 설정을 두지 않습니다.
+`declare()`가 이 설정을 읽어 우선순위 큐를 준비합니다.
+
+```python
+from DefStream.Broker.Implements.RabbitMQ import Subscription
+from DefStream.Worker import (
+  Run,
+  declare,
+  request,
+  send,
+)
+
+
+class Add(
+  Run,
+  parameters=Subscription(
+    queue='defstream.example.priority.add',
+    max_priority=5,
+    priority=2,
+  ),
+):
+  def run(
+    self,
+    a: int,
+    b: int,
+  ):
+    return a + b
+
+
+# broker는 호출자가 연결한 RabbitMQ Connection입니다.
+declare(
+  task=Add,
+  broker=broker,
+)
+send(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+)
+# RPC에는 별도로 실행 중인 Worker가 필요합니다.
+result = request(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+  priority=5,
+)
+```
+
+- 호출의 `priority`가 생략되거나 `None`이면 작업 기본값을 사용합니다.
+  명시적 `0`은 가장 낮은 우선순위이며 기본값을 덮어씁니다.
+- 작업 기본값만 지정하면 큐 최대값은 RabbitMQ 상한 `255`입니다.
+  최대값만 지정하면 기본값은 `None`이며, 호출값도 없으면 메시지 속성을 생략합니다.
+- 작업 최대값을 초과하는 값, 음수, 정수가 아닌 값과 `bool`은 거부합니다.
+- 작업 설정 없이 호출에서만 지정하면 브로커 범위 `0..255`만 검증합니다.
+  우선순위 큐의 사전 선언과 실제 큐 최대값 준수는 호출자 책임입니다.
+- 자식 작업은 설정을 상속하고 유효한 값으로 재정의할 수 있지만 해제할 수는 없습니다.
+- Redis에 우선순위를 요청하면 `NotImplementedError`가 발생합니다.
+  우선순위 미지정 시 기존 Redis 동작은 유지합니다.
+- 우선순위는 같은 큐의 대기 메시지 전달에 적용됩니다. 이미 전달·실행 중인
+  작업을 선점하거나 여러 작업의 실행·완료 순서를 보장하지 않습니다.
+
 ### 성공, 실패와 재시도
 
 - 작업 실행과 완료 훅이 성공한 뒤 ACK합니다. RabbitMQ RPC는 응답 발행도 ACK보다 먼저 수행합니다.

{defstream-0.1.3.7 → defstream-0.1.4.12}/DefStream.egg-info/SOURCES.txt

@@ -9,6 +9,11 @@ DefStream.egg-info/SOURCES.txt
 DefStream.egg-info/dependency_links.txt
 DefStream.egg-info/requires.txt
 DefStream.egg-info/top_level.txt
+issues/feature/1/IMPLEMENTS.md
+issues/feature/1/README.md
+issues/feature/1/REQUIREMENTS.md
+issues/feature/1/TASK.md
+issues/feature/1/ci.refs.json
 sample/Broker/Sample.py
 sample/Worker/Sample.py
 sample/Worker/RabbitMQ/Client.py
@@ -22,6 +27,7 @@ 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
 src/Broker/Implements/__init__.py
@@ -76,5 +82,6 @@ test/test_protocol_contracts.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

{defstream-0.1.3.7 → defstream-0.1.4.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.3.7
+Version: 0.1.4.12
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -232,6 +232,71 @@ python client.py
 하나의 Worker에서는 같은 큐에 여러 작업을 중복 등록할 수 없습니다.
 메시지 유형을 보고 여러 `Run` 중 하나를 고르는 방식이 아니라 큐별로 작업을 선택합니다.
 
+### 작업 우선순위
+
+RabbitMQ classic 큐에서는 작업 `parameters`의 RabbitMQ `Subscription`에
+`priority`로 기본 메시지 우선순위, `max_priority`로 큐 최대값을 함께 정의합니다.
+`Run`에 별도의 `priority` 설정을 두지 않습니다.
+`declare()`가 이 설정을 읽어 우선순위 큐를 준비합니다.
+
+```python
+from DefStream.Broker.Implements.RabbitMQ import Subscription
+from DefStream.Worker import (
+  Run,
+  declare,
+  request,
+  send,
+)
+
+
+class Add(
+  Run,
+  parameters=Subscription(
+    queue='defstream.example.priority.add',
+    max_priority=5,
+    priority=2,
+  ),
+):
+  def run(
+    self,
+    a: int,
+    b: int,
+  ):
+    return a + b
+
+
+# broker는 호출자가 연결한 RabbitMQ Connection입니다.
+declare(
+  task=Add,
+  broker=broker,
+)
+send(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+)
+# RPC에는 별도로 실행 중인 Worker가 필요합니다.
+result = request(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+  priority=5,
+)
+```
+
+- 호출의 `priority`가 생략되거나 `None`이면 작업 기본값을 사용합니다.
+  명시적 `0`은 가장 낮은 우선순위이며 기본값을 덮어씁니다.
+- 작업 기본값만 지정하면 큐 최대값은 RabbitMQ 상한 `255`입니다.
+  최대값만 지정하면 기본값은 `None`이며, 호출값도 없으면 메시지 속성을 생략합니다.
+- 작업 최대값을 초과하는 값, 음수, 정수가 아닌 값과 `bool`은 거부합니다.
+- 작업 설정 없이 호출에서만 지정하면 브로커 범위 `0..255`만 검증합니다.
+  우선순위 큐의 사전 선언과 실제 큐 최대값 준수는 호출자 책임입니다.
+- 자식 작업은 설정을 상속하고 유효한 값으로 재정의할 수 있지만 해제할 수는 없습니다.
+- Redis에 우선순위를 요청하면 `NotImplementedError`가 발생합니다.
+  우선순위 미지정 시 기존 Redis 동작은 유지합니다.
+- 우선순위는 같은 큐의 대기 메시지 전달에 적용됩니다. 이미 전달·실행 중인
+  작업을 선점하거나 여러 작업의 실행·완료 순서를 보장하지 않습니다.
+
 ### 성공, 실패와 재시도
 
 - 작업 실행과 완료 훅이 성공한 뒤 ACK합니다. RabbitMQ RPC는 응답 발행도 ACK보다 먼저 수행합니다.

{defstream-0.1.3.7 → defstream-0.1.4.12}/README.en.md

@@ -202,6 +202,73 @@ Task bodies must be **mappings with string keys**. Return values must be
 serializable by the adapter. A Worker cannot register multiple tasks for the
 same queue: routing selects tasks by queue, not by a type field in the message.
 
+### Task priorities
+
+For RabbitMQ classic queues, define both the default message `priority` and queue
+`max_priority` in the RabbitMQ `Subscription` supplied as the task's `parameters`.
+There is no separate `priority` setting on `Run`.
+`declare()` reads these settings to provision the priority queue.
+
+```python
+from DefStream.Broker.Implements.RabbitMQ import Subscription
+from DefStream.Worker import (
+  Run,
+  declare,
+  request,
+  send,
+)
+
+
+class Add(
+  Run,
+  parameters=Subscription(
+    queue='defstream.example.priority.add',
+    max_priority=5,
+    priority=2,
+  ),
+):
+  def run(
+    self,
+    a: int,
+    b: int,
+  ):
+    return a + b
+
+
+# broker is a RabbitMQ Connection connected by the caller.
+declare(
+  task=Add,
+  broker=broker,
+)
+send(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+)
+# RPC requires a separately running Worker.
+result = request(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+  priority=5,
+)
+```
+
+- Omitting the call's `priority` or passing `None` uses the task default.
+  An explicit `0` overrides the default with the lowest priority.
+- Setting only the task default sets the queue maximum to RabbitMQ's limit of
+  `255`. Setting only the maximum leaves the default as `None`; without a
+  per-call value either, the message priority property is omitted.
+- Values above the task maximum, negative values, non-integers, and `bool` are rejected.
+- Specifying priority only at call time validates only the broker range `0..255`.
+  The caller must provision a priority queue and respect its actual maximum.
+- Child tasks inherit settings and may override them with valid values, but cannot
+  clear them.
+- Requesting priorities with Redis raises `NotImplementedError`.
+  Calls without priorities retain existing Redis behavior.
+- Priority affects delivery of waiting messages within the same queue. It does not
+  preempt delivered or running tasks or guarantee execution and completion order.
+
 ### Success, failures, and retries
 
 - ACK follows successful execution and completion hooks. RabbitMQ RPC also publishes the reply before ACK.

{defstream-0.1.3.7 → defstream-0.1.4.12}/README.md

@@ -199,6 +199,71 @@ python client.py
 하나의 Worker에서는 같은 큐에 여러 작업을 중복 등록할 수 없습니다.
 메시지 유형을 보고 여러 `Run` 중 하나를 고르는 방식이 아니라 큐별로 작업을 선택합니다.
 
+### 작업 우선순위
+
+RabbitMQ classic 큐에서는 작업 `parameters`의 RabbitMQ `Subscription`에
+`priority`로 기본 메시지 우선순위, `max_priority`로 큐 최대값을 함께 정의합니다.
+`Run`에 별도의 `priority` 설정을 두지 않습니다.
+`declare()`가 이 설정을 읽어 우선순위 큐를 준비합니다.
+
+```python
+from DefStream.Broker.Implements.RabbitMQ import Subscription
+from DefStream.Worker import (
+  Run,
+  declare,
+  request,
+  send,
+)
+
+
+class Add(
+  Run,
+  parameters=Subscription(
+    queue='defstream.example.priority.add',
+    max_priority=5,
+    priority=2,
+  ),
+):
+  def run(
+    self,
+    a: int,
+    b: int,
+  ):
+    return a + b
+
+
+# broker는 호출자가 연결한 RabbitMQ Connection입니다.
+declare(
+  task=Add,
+  broker=broker,
+)
+send(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+)
+# RPC에는 별도로 실행 중인 Worker가 필요합니다.
+result = request(
+  {'a': 10, 'b': 20},
+  task=Add,
+  broker=broker,
+  priority=5,
+)
+```
+
+- 호출의 `priority`가 생략되거나 `None`이면 작업 기본값을 사용합니다.
+  명시적 `0`은 가장 낮은 우선순위이며 기본값을 덮어씁니다.
+- 작업 기본값만 지정하면 큐 최대값은 RabbitMQ 상한 `255`입니다.
+  최대값만 지정하면 기본값은 `None`이며, 호출값도 없으면 메시지 속성을 생략합니다.
+- 작업 최대값을 초과하는 값, 음수, 정수가 아닌 값과 `bool`은 거부합니다.
+- 작업 설정 없이 호출에서만 지정하면 브로커 범위 `0..255`만 검증합니다.
+  우선순위 큐의 사전 선언과 실제 큐 최대값 준수는 호출자 책임입니다.
+- 자식 작업은 설정을 상속하고 유효한 값으로 재정의할 수 있지만 해제할 수는 없습니다.
+- Redis에 우선순위를 요청하면 `NotImplementedError`가 발생합니다.
+  우선순위 미지정 시 기존 Redis 동작은 유지합니다.
+- 우선순위는 같은 큐의 대기 메시지 전달에 적용됩니다. 이미 전달·실행 중인
+  작업을 선점하거나 여러 작업의 실행·완료 순서를 보장하지 않습니다.
+
 ### 성공, 실패와 재시도
 
 - 작업 실행과 완료 훅이 성공한 뒤 ACK합니다. RabbitMQ RPC는 응답 발행도 ACK보다 먼저 수행합니다.

defstream-0.1.4.12/issues/feature/1/IMPLEMENTS.md

@@ -0,0 +1,73 @@
+# 워커 작업 우선순위 구현 기록
+
+## 1. 구현 범위
+
+[요구사항](./REQUIREMENTS.md)에 따라 작업 정의, 선언, 전송, RPC 요청에 우선순위를 연결했다.
+Redis 구현, 실행 풀 스케줄링, 작업 선점은 변경하지 않았다.
+
+## 2. 주요 변경
+
+- [Run](../../../src/Worker/Run.py)은 기존 `parameters`의 구독 설정에서
+  `priority`와 `max_priority`를 읽는다. 별도의 `Run.priority` 속성이나
+  클래스 선언 키워드는 제공하지 않는다. 구독 객체와 매핑을
+  모두 지원하며, 기본값과 최대값의 타입·하한 및 상호 범위를 검증한다.
+- 자식 작업은 부모 구독 설정을 상속한다. 구독 설정을 재정의할 때 상속된 기본값이나
+  최대값을 제거하면 오류로 거부한다. 변경하려면 유지할 값도 새 구독 설정에 명시한다.
+- [메시지 API](../../../src/Worker/Message.py)의 `send`, `request`에 키워드 전용
+  `priority`를 추가했다. 호출값이 `None`이면 작업 기본값을 사용하며 `0`을 보존한다.
+- [PrioritySupport](../../../src/Broker/Connection.py) 계약으로 지원 브로커의
+  구독 정규화와 우선순위 발행을 구분한다. 기존 브로커 계약은 유지한다.
+- 우선순위를 전혀 사용하지 않는 경로는 기존 인자 형태로 호출한다.
+  미지원 브로커에 우선순위를 요청하면 선언·발행 전에 `NotImplementedError`를 발생시킨다.
+- [공유 검증 함수](../../../src/Broker/Priority.py)를 작업 및 RabbitMQ 경로에서
+  재사용한다. 정수가 아닌 값과 `bool`은 `TypeError`, 범위 오류는 `ValueError`로 처리한다.
+
+## 3. 브로커 연계
+
+- RabbitMQ `Subscription` 생성·파싱 시 기본값만 있으면 최대값을 `255`로
+  정규화한다. 원본 매핑은 변경하지 않으며 기존 구독 객체는 그대로 재사용한다.
+- 작업 최대값이 있으면 이를 우선 사용한다. 호출에서만 지정하면 브로커 허용 범위만
+  검증하고 큐 선언·변경·조회는 수행하지 않는다.
+- 작업 본문, 스키마, ACK 및 실행 풀의 처리 흐름은 변경하지 않았다.
+
+## 4. 검증 결과
+
+- 가상 환경의 Python과 기존 `unittest` 러너로 전체 코어 테스트 137개를 실행했다.
+  129개 통과, 선택적 통합 테스트 등 8개 건너뜀.
+- 새 우선순위 테스트 7개로 기본값, 최대값, `0`, 호출 재정의, RPC 전달,
+  Redis 거부·기존 전송, 상속 및 잘못된 설정을 검증했다.
+- Windows 기본 CP949 출력에서는 기존 시작 배너가 인코딩 오류를 발생시켜,
+  `PYTHONIOENCODING=utf-8`, `PYTHONUTF8=1`로 실행하여 통과했다.
+  관련 없는 시작 배너 코드는 수정하지 않았다.
+- 변경한 코어 소스의 Pylance 진단에 오류가 없음을 확인했다.
+- Redis 회귀 테스트도 14개 중 10개 통과, 선택적 통합 테스트 4개 건너뜀으로 확인했다.
+- 테스트 도구에서 테스트를 발견하지 못하여 저장소의 `unittest discover`로 검증했다.
+- 후속 Docker RabbitMQ 3.13.7 검증에서 어댑터 전체 35개 테스트가 모두 통과했다.
+  코어 메시지·우선순위 테스트도 실제 RabbitMQ 옵션을 활성화하여 18개 중
+  16개 통과, Redis 전용 통합 테스트 2개 건너뜀을 확인했다.
+- 기본값을 `Subscription.priority`로 통합한 뒤 전체 코어 테스트를 재실행했다.
+  RabbitMQ 실서버 옵션을 활성화하여 137개 중 133개 통과, 4개 건너뜀을 확인했다.
+  Redis 회귀 테스트는 14개 중 10개 통과, 4개 건너뜀이다.
+- 코어의 수정된 소스는 Pylance 오류가 없었다. RabbitMQ 원본 경로는 기존 상대
+  import 해석 문제 등이 남아 있어 전체 정적 분석 통과로 간주하지 않는다.
+
+실행 명령은 작업 폴더 루트 기준이다.
+
+```powershell
+$env:PYTHONIOENCODING = 'utf-8'
+$env:PYTHONUTF8 = '1'
+.\.venv\Scripts\python.exe -m unittest discover -s .\DefStream\test
+```
+
+## 5. 공통 브로커 참조 경로 통일
+
+- 구현체가 공통 인터페이스와 요소를 `from DefStream.Broker import ...`로 참조하도록 공개 경로를 통일했다.
+- 공통 패키지에서 `Requeue`, `Reject`, `validate_priority`를 추가로 공개했다.
+- RabbitMQ와 Redis 구현체의 상위 상대 import를 제거했다. 구현체 내부 import는 유지했다.
+- RabbitMQ 실서버 테스트 38개 통과, Redis 테스트 10개 통과·4개 건너뜀,
+  코어 메시지 테스트 16개 통과·2개 건너뜀을 확인했다.
+
+## 6. 관련 문서
+
+- [사용 설명서](../../../README.md)
+- [RabbitMQ 구현 기록](../../../../DefStream-RabbitMQ/issues/feature/1/IMPLEMENTS.md)

defstream-0.1.4.12/issues/feature/1/README.md

@@ -0,0 +1,74 @@
+# 워커 작업 우선순위 지원
+
+## 변경 전 (AS-IS)
+
+작업을 대상으로 하는 `declare`, `send`, `request`에서는 큐의 우선순위 설정과
+메시지 우선순위를 지정할 수 없었습니다.
+
+## 변경 후 (TO-BE)
+
+지원 브로커의 작업 구독 설정에 기본·최대 우선순위를 정의하고, `send`와 `request`에서
+메시지별 우선순위를 재정의할 수 있습니다. 현재 지원 브로커는 RabbitMQ입니다.
+
+## 사용 방법
+
+RabbitMQ 작업의 `parameters`에 `Subscription(priority=2, max_priority=5, ...)`를
+지정하세요. 기본값은 `Run`의 별도 속성이 아니라 구독 설정에 정의합니다.
+호출자가 연결한 `broker`와 구체적인 작업 클래스 `Add`를 사용해 다음처럼 호출합니다.
+
+```python
+from DefStream.Worker import (
+  declare,
+  request,
+  send,
+)
+
+
+# 작업 구독 설정을 읽어 큐를 준비합니다.
+declare(
+  task=Add,
+  broker=broker,
+)
+
+# 호출값을 생략하면 작업 구독의 기본 우선순위를 사용합니다.
+send(
+  {'a': 1, 'b': 2},
+  task=Add,
+  broker=broker,
+)
+
+# RPC 요청도 호출별 우선순위를 지정할 수 있습니다.
+result = request(
+  {'a': 1, 'b': 2},
+  task=Add,
+  broker=broker,
+  priority=5,
+)
+```
+
+RPC 결과를 받으려면 해당 작업을 처리하는 Worker가 실행 중이어야 합니다.
+전체 작업 정의와 큐 전환 방법은
+[RabbitMQ 우선순위 사용 안내](https://github.com/yong5eon/DefStream-RabbitMQ/blob/master/issues/feature/1/README.md)를 참고하세요.
+
+## 기존 코드에 미치는 영향
+
+- 우선순위를 지정하지 않은 기존 호출은 그대로 사용할 수 있습니다.
+- 호출값 생략 또는 `None`은 작업 기본값을 사용하며, `0`은 명시적인 재정의입니다.
+- 기본값만 지정하면 RabbitMQ 큐 최대값은 `255`입니다. 최대값만 지정하고
+  호출값도 없으면 메시지 우선순위 속성을 생략합니다.
+- 잘못된 타입이나 범위는 선언·발행 전에 오류로 처리합니다.
+  작업 설정 없이 호출에서만 지정하는 경우에는 브로커 허용 범위만 검증하므로,
+  실제 우선순위 큐의 사전 선언은 호출자가 보장해야 합니다.
+- 자식 작업에서 구독 설정을 교체한다면 부모의 기본·최대 우선순위도 새 설정에
+  명시해야 합니다. 유효한 값으로 재정의할 수 있지만 해제할 수는 없습니다.
+- Redis는 우선순위를 지원하지 않습니다. Redis에 우선순위를 요청하면
+  `NotImplementedError`가 발생하며, 미지정 시에는 기존 동작을 유지합니다.
+- 우선순위는 같은 큐의 대기 메시지 전달에만 적용되며, 실행 중 작업의 선점이나
+  전역 실행·완료 순서를 보장하지 않습니다.
+
+## 브로커 확장 개발자를 위한 공개 요소
+
+공통 패키지에서 기존 인터페이스와 함께 `PrioritySupport`, `Requeue`, `Reject`,
+`validate_priority`를 가져올 수 있습니다. 브로커 구현 시 공통 요소는
+`from DefStream.Broker import ...`로 참조하세요.
+기존 우선순위 미지원 브로커에 새 인자 구현을 강제하지 않습니다.