PyPI - DefStream-RabbitMQ - Versions diffs - 0.1.1.3__tar.gz → 0.1.2.6__tar.gz - Mend

DefStream-RabbitMQ 0.1.1.3tar.gz → 0.1.2.6tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of DefStream-RabbitMQ might be problematic. Click here for more details.

Files changed (38) hide show

{defstream_rabbitmq-0.1.1.3 → defstream_rabbitmq-0.1.2.6}/.github/workflows/ci.yml RENAMED Viewed

@@ -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_rabbitmq-0.1.1.3 → defstream_rabbitmq-0.1.2.6/DefStream_RabbitMQ.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream-RabbitMQ
-Version: 0.1.1.3
+Version: 0.1.2.6
 Summary: RabbitMQ broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
 Author: Heo Yongseon
@@ -176,12 +176,54 @@ Worker는 실행과 완료 훅이 끝난 뒤 ACK하고, 실패하면 지정한
   Worker의 공유 풀 크기와 별개입니다.
 - `error`: `declare()`가 생성하고 연결할 오류 큐 이름. 거부된 메시지의 DLQ입니다.
 - `offset`: RabbitMQ 스트림 구독에 사용할 정수 오프셋.
+- `max_priority`: classic 작업 큐의 최대 우선순위. 정수 `1..255` 또는 `None`.
+- `priority`: 기본 메시지 우선순위. 정수 `0..max_priority` 또는 `None`.
+  이 값만 지정하면 `max_priority`는 `255`로 설정됩니다.
 `Subscription` 객체 생성이나 `consumer.subs()`는 큐를 선언하지 않습니다.
 작업용 `declare()`는 일반 durable 큐와 선택적 DLQ를 준비하며,
 스트림 큐나 Exchange 바인딩을 자동 생성하지 않습니다.
 기존 큐의 선언 옵션이 다르면 실패하며 자동 삭제·재생성하지 않습니다.
+## 워커 작업 우선순위
+작업에 지정한 `Subscription`에 기본값 `priority`와 큐 최대값 `max_priority`를
+함께 설정합니다. `Run`에는 별도의 `priority` 설정을 두지 않습니다.
+```python
+class PriorityAdd(
+  Add,
+  parameters=Subscription(
+    queue='defstream.example.rabbitmq.priority.add',
+    qos=1,
+    max_priority=5,
+    priority=2,
+  ),
+):
+  pass
+```
+- 워커 API `declare(task=PriorityAdd, broker=connection)`는 큐에
+  `x-max-priority=5`를 반영합니다. 기존 DLQ 설정도 보존합니다.
+- `send(..., task=PriorityAdd, broker=connection)` 및
+  `request(..., task=PriorityAdd, broker=connection)`는 작업 기본값 `2`를 사용합니다.
+  호출에 `priority=0` 또는 다른 유효한 값을 지정하여 재정의할 수 있습니다.
+- 기본값만 정의하면 큐 최대값은 `255`, 최대값만 정의하면 기본값은 `None`입니다.
+  호출별 값도 없으면 AMQP 우선순위 속성을 생략합니다.
+- 워커 경로는 작업의 유효 최대값으로 검증합니다. 작업 설정 없이 호출에서만
+  지정하면 `0..255` 범위만 검증하며, 우선순위 큐 사전 선언은 호출자 책임입니다.
+- 기존 저수준 `Queue.send`, `Exchange.send`와 `Queue.call`도 `priority=`를 받습니다.
+  이 경로는 작업 정의를 받지 않으므로 작업별 최대값은 검증하지 않습니다.
+  정수 `0..255`만 허용하며 `bool`은 거부합니다.
+- 최대값을 늘릴수록 자원 비용이 증가하므로 필요한 수준만 지정하는 것을 권장합니다.
+- 동일 큐를 여러 작업 정의에서 선언한다면 최대값을 동일하게 맞춰야 합니다.
+  기존 일반 큐나 최대값이 다른 큐를 재선언하면 RabbitMQ 오류가 전파됩니다.
+  자동 삭제하지 않으므로, 새 큐로 전환하거나 미처리 메시지를 보존한 후 운영자가
+  안전하게 재생성하고 생산자·소비자를 함께 전환해야 합니다.
+- 높은 값이 먼저 전달되지만 이미 prefetch된 메시지나 실행 중인 작업은 선점하지
+  않습니다. 재전달, 다중 소비자에서는 완료 순서를 보장하지 않으며 낮은 우선순위
+  메시지가 오래 대기할 수 있습니다. Stream 및 Quorum 큐는 이번 지원 대상이 아닙니다.
 ## 동기 RPC
 실행 중인 Worker가 있는 큐에 `call()`을 사용하면 `Run.run()`의 반환값을 받습니다.

{defstream_rabbitmq-0.1.1.3 → defstream_rabbitmq-0.1.2.6}/DefStream_RabbitMQ.egg-info/SOURCES.txt RENAMED Viewed

@@ -9,6 +9,11 @@ DefStream_RabbitMQ.egg-info/SOURCES.txt
 DefStream_RabbitMQ.egg-info/dependency_links.txt
 DefStream_RabbitMQ.egg-info/requires.txt
 DefStream_RabbitMQ.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/Sample.RPC.py
 sample/Sample.Stream.py
 sample/Sample.py
@@ -24,6 +29,7 @@ src/Stream.py
 src/Subscription.py
 src/__init__.py
 test/test_broker_methods.py
+test/test_priorities.py
 test/test_rabbitmq_integration.py
 test/test_rabbitmq_worker.py
 test/test_rpc.py

{defstream_rabbitmq-0.1.1.3/DefStream_RabbitMQ.egg-info → defstream_rabbitmq-0.1.2.6}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream-RabbitMQ
-Version: 0.1.1.3
+Version: 0.1.2.6
 Summary: RabbitMQ broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
 Author: Heo Yongseon
@@ -176,12 +176,54 @@ Worker는 실행과 완료 훅이 끝난 뒤 ACK하고, 실패하면 지정한
   Worker의 공유 풀 크기와 별개입니다.
 - `error`: `declare()`가 생성하고 연결할 오류 큐 이름. 거부된 메시지의 DLQ입니다.
 - `offset`: RabbitMQ 스트림 구독에 사용할 정수 오프셋.
+- `max_priority`: classic 작업 큐의 최대 우선순위. 정수 `1..255` 또는 `None`.
+- `priority`: 기본 메시지 우선순위. 정수 `0..max_priority` 또는 `None`.
+  이 값만 지정하면 `max_priority`는 `255`로 설정됩니다.
 `Subscription` 객체 생성이나 `consumer.subs()`는 큐를 선언하지 않습니다.
 작업용 `declare()`는 일반 durable 큐와 선택적 DLQ를 준비하며,
 스트림 큐나 Exchange 바인딩을 자동 생성하지 않습니다.
 기존 큐의 선언 옵션이 다르면 실패하며 자동 삭제·재생성하지 않습니다.
+## 워커 작업 우선순위
+작업에 지정한 `Subscription`에 기본값 `priority`와 큐 최대값 `max_priority`를
+함께 설정합니다. `Run`에는 별도의 `priority` 설정을 두지 않습니다.
+```python
+class PriorityAdd(
+  Add,
+  parameters=Subscription(
+    queue='defstream.example.rabbitmq.priority.add',
+    qos=1,
+    max_priority=5,
+    priority=2,
+  ),
+):
+  pass
+```
+- 워커 API `declare(task=PriorityAdd, broker=connection)`는 큐에
+  `x-max-priority=5`를 반영합니다. 기존 DLQ 설정도 보존합니다.
+- `send(..., task=PriorityAdd, broker=connection)` 및
+  `request(..., task=PriorityAdd, broker=connection)`는 작업 기본값 `2`를 사용합니다.
+  호출에 `priority=0` 또는 다른 유효한 값을 지정하여 재정의할 수 있습니다.
+- 기본값만 정의하면 큐 최대값은 `255`, 최대값만 정의하면 기본값은 `None`입니다.
+  호출별 값도 없으면 AMQP 우선순위 속성을 생략합니다.
+- 워커 경로는 작업의 유효 최대값으로 검증합니다. 작업 설정 없이 호출에서만
+  지정하면 `0..255` 범위만 검증하며, 우선순위 큐 사전 선언은 호출자 책임입니다.
+- 기존 저수준 `Queue.send`, `Exchange.send`와 `Queue.call`도 `priority=`를 받습니다.
+  이 경로는 작업 정의를 받지 않으므로 작업별 최대값은 검증하지 않습니다.
+  정수 `0..255`만 허용하며 `bool`은 거부합니다.
+- 최대값을 늘릴수록 자원 비용이 증가하므로 필요한 수준만 지정하는 것을 권장합니다.
+- 동일 큐를 여러 작업 정의에서 선언한다면 최대값을 동일하게 맞춰야 합니다.
+  기존 일반 큐나 최대값이 다른 큐를 재선언하면 RabbitMQ 오류가 전파됩니다.
+  자동 삭제하지 않으므로, 새 큐로 전환하거나 미처리 메시지를 보존한 후 운영자가
+  안전하게 재생성하고 생산자·소비자를 함께 전환해야 합니다.
+- 높은 값이 먼저 전달되지만 이미 prefetch된 메시지나 실행 중인 작업은 선점하지
+  않습니다. 재전달, 다중 소비자에서는 완료 순서를 보장하지 않으며 낮은 우선순위
+  메시지가 오래 대기할 수 있습니다. Stream 및 Quorum 큐는 이번 지원 대상이 아닙니다.
 ## 동기 RPC
 실행 중인 Worker가 있는 큐에 `call()`을 사용하면 `Run.run()`의 반환값을 받습니다.

{defstream_rabbitmq-0.1.1.3 → defstream_rabbitmq-0.1.2.6}/README.en.md RENAMED Viewed

@@ -146,12 +146,59 @@ the selected failure policy on error. Omitting `on_error` defaults to `Requeue()
   is 1; 0 means unlimited. This is separate from shared Worker pool capacity.
 - `error`: error queue to create and bind through `declare()`; a DLQ for rejected messages.
 - `offset`: integer offset for RabbitMQ stream subscriptions.
+- `max_priority`: maximum priority for a classic task queue; an integer in `1..255` or `None`.
+- `priority`: default message priority; an integer in `0..max_priority` or `None`.
+  Setting only this value sets `max_priority` to `255`.
 Constructing a `Subscription` or calling `consumer.subs()` does not declare queues.
 Task `declare()` provisions ordinary durable queues and an optional DLQ,
 not stream queues or Exchange bindings. Incompatible existing queue options
 fail explicitly; queues are not automatically deleted and recreated.
+## Worker task priorities
+Set the default `priority` and queue `max_priority` together in the task's
+`Subscription`. There is no separate `priority` setting on `Run`.
+```python
+class PriorityAdd(
+  Add,
+  parameters=Subscription(
+    queue='defstream.example.rabbitmq.priority.add',
+    qos=1,
+    max_priority=5,
+    priority=2,
+  ),
+):
+  pass
+```
+- The Worker API `declare(task=PriorityAdd, broker=connection)` declares the queue
+  with `x-max-priority=5` while preserving existing DLQ settings.
+- `send(..., task=PriorityAdd, broker=connection)` and
+  `request(..., task=PriorityAdd, broker=connection)` use the task default of `2`.
+  Pass `priority=0` or another valid value to override it for an individual call.
+- Setting only the default sets the queue maximum to `255`. Setting only the
+  maximum leaves the default as `None`. Without a per-call value either, the AMQP
+  priority property is omitted.
+- Worker calls validate against the task's effective maximum. If priority is
+  specified only at call time, only the `0..255` range is validated; the caller
+  must provision a priority queue beforehand.
+- The existing low-level `Queue.send`, `Exchange.send`, and `Queue.call` also
+  accept `priority=`. These APIs do not receive a task definition and therefore
+  do not validate against a task-specific maximum. They accept integers in
+  `0..255` and reject `bool`.
+- Larger maximum values increase resource costs; configure only the levels you need.
+- Task definitions declaring the same queue must use the same maximum.
+  Redeclaring an ordinary queue or a queue with a different maximum propagates
+  a RabbitMQ error. Queues are not automatically deleted. Switch to a new queue,
+  or preserve pending messages before safely recreating the queue and migrating
+  producers and consumers together.
+- Higher values are delivered first, but prefetched messages and running tasks
+  are not preempted. Redelivery and multiple consumers prevent guarantees about
+  completion order, and lower-priority messages can wait indefinitely.
+  Streams and quorum queues are outside the scope of this feature.
 ## Synchronous RPC
 Call a queue served by a running Worker to receive the result of `Run.run()`.

{defstream_rabbitmq-0.1.1.3 → defstream_rabbitmq-0.1.2.6}/README.md RENAMED Viewed

@@ -145,12 +145,54 @@ Worker는 실행과 완료 훅이 끝난 뒤 ACK하고, 실패하면 지정한
   Worker의 공유 풀 크기와 별개입니다.
 - `error`: `declare()`가 생성하고 연결할 오류 큐 이름. 거부된 메시지의 DLQ입니다.
 - `offset`: RabbitMQ 스트림 구독에 사용할 정수 오프셋.
+- `max_priority`: classic 작업 큐의 최대 우선순위. 정수 `1..255` 또는 `None`.
+- `priority`: 기본 메시지 우선순위. 정수 `0..max_priority` 또는 `None`.
+  이 값만 지정하면 `max_priority`는 `255`로 설정됩니다.
 `Subscription` 객체 생성이나 `consumer.subs()`는 큐를 선언하지 않습니다.
 작업용 `declare()`는 일반 durable 큐와 선택적 DLQ를 준비하며,
 스트림 큐나 Exchange 바인딩을 자동 생성하지 않습니다.
 기존 큐의 선언 옵션이 다르면 실패하며 자동 삭제·재생성하지 않습니다.
+## 워커 작업 우선순위
+작업에 지정한 `Subscription`에 기본값 `priority`와 큐 최대값 `max_priority`를
+함께 설정합니다. `Run`에는 별도의 `priority` 설정을 두지 않습니다.
+```python
+class PriorityAdd(
+  Add,
+  parameters=Subscription(
+    queue='defstream.example.rabbitmq.priority.add',
+    qos=1,
+    max_priority=5,
+    priority=2,
+  ),
+):
+  pass
+```
+- 워커 API `declare(task=PriorityAdd, broker=connection)`는 큐에
+  `x-max-priority=5`를 반영합니다. 기존 DLQ 설정도 보존합니다.
+- `send(..., task=PriorityAdd, broker=connection)` 및
+  `request(..., task=PriorityAdd, broker=connection)`는 작업 기본값 `2`를 사용합니다.
+  호출에 `priority=0` 또는 다른 유효한 값을 지정하여 재정의할 수 있습니다.
+- 기본값만 정의하면 큐 최대값은 `255`, 최대값만 정의하면 기본값은 `None`입니다.
+  호출별 값도 없으면 AMQP 우선순위 속성을 생략합니다.
+- 워커 경로는 작업의 유효 최대값으로 검증합니다. 작업 설정 없이 호출에서만
+  지정하면 `0..255` 범위만 검증하며, 우선순위 큐 사전 선언은 호출자 책임입니다.
+- 기존 저수준 `Queue.send`, `Exchange.send`와 `Queue.call`도 `priority=`를 받습니다.
+  이 경로는 작업 정의를 받지 않으므로 작업별 최대값은 검증하지 않습니다.
+  정수 `0..255`만 허용하며 `bool`은 거부합니다.
+- 최대값을 늘릴수록 자원 비용이 증가하므로 필요한 수준만 지정하는 것을 권장합니다.
+- 동일 큐를 여러 작업 정의에서 선언한다면 최대값을 동일하게 맞춰야 합니다.
+  기존 일반 큐나 최대값이 다른 큐를 재선언하면 RabbitMQ 오류가 전파됩니다.
+  자동 삭제하지 않으므로, 새 큐로 전환하거나 미처리 메시지를 보존한 후 운영자가
+  안전하게 재생성하고 생산자·소비자를 함께 전환해야 합니다.
+- 높은 값이 먼저 전달되지만 이미 prefetch된 메시지나 실행 중인 작업은 선점하지
+  않습니다. 재전달, 다중 소비자에서는 완료 순서를 보장하지 않으며 낮은 우선순위
+  메시지가 오래 대기할 수 있습니다. Stream 및 Quorum 큐는 이번 지원 대상이 아닙니다.
 ## 동기 RPC
 실행 중인 Worker가 있는 큐에 `call()`을 사용하면 `Run.run()`의 반환값을 받습니다.

defstream_rabbitmq-0.1.2.6/issues/feature/1/IMPLEMENTS.md ADDED Viewed

@@ -0,0 +1,93 @@
+# RabbitMQ 작업 우선순위 구현 기록
+## 1. 구현 범위
+[요구사항](./REQUIREMENTS.md)에 따라 classic 작업 큐의 선언, 일반 전송 및 RPC
+요청에 우선순위를 연결했다. 기존 큐 종류를 변경하거나 Redis 기능을 추가하지 않았다.
+## 2. 주요 변경
+- [Subscription](../../../src/Subscription.py)의 기존 필드 뒤에 `max_priority`와
+  `priority`를 추가하여 기존 위치 인자의 의미를 보존했다. 매핑 입력에도 동일하게 적용한다.
+- 최대값은 `1..255` 정수로 검증한다. 메시지 값은 최대값이 있으면 그 범위,
+  없으면 `0..255`로 검증한다. `bool`은 거부한다.
+- 구독 생성·파싱 시 `priority`가 있고 최대값이 없으면 `max_priority=255`로
+  정규화하고 두 값의 범위를 함께 검증한다. 최대값만 있으면 기본값은 `None`이다.
+- [Connection](../../../src/Connection.py)의 `priority_parameters`는
+  `Subscription.parse`에 위임한다. 기본값을 별도 인자로 받거나 `Run`에서 가져오지 않는다.
+- `declare`는 최대값을 `x-max-priority`에 반영하고 기존 DLQ 인자를 보존한다.
+  오류 큐에는 작업 우선순위를 자동 적용하지 않는다. 선언 충돌은 그대로 전파한다.
+- `send`는 메시지 우선순위를 AMQP 속성에 반영한다.
+  `request`는 `Queue.call`까지 우선순위를 전달한다. 두 메서드는 호출값이
+  `None`이면 `Subscription.priority`를 사용하며 명시적 `0`을 보존한다.
+- [Queue.call](../../../src/Queue.py)은 기존 타임아웃 위치 인자를 보존하면서
+  키워드 전용 `priority`를 추가했다. 임시 응답 큐와 응답 메시지에는 적용하지 않는다.
+- 기존 `Queue.send`, [Exchange.send](../../../src/Exchange.py)도 공유 검증 함수를
+  사용하여 브로커 범위를 검증한다. 작업 정의를 받지 않는 저수준 API는 작업별
+  최대값을 강제하지 않는다.
+- 기존 publisher confirm, mandatory, RPC correlation ID, 만료, 원격 오류,
+  연결 정리 및 브로커 NACK 재전달 방식은 유지했다.
+- 공개 바인딩 클래스 `Any`와 충돌하지 않도록 타입 주석용 `typing.Any`는
+  `AnyValue`로 임포트했다. 공개 바인딩 클래스 이름과 런타임 동작은 유지했다.
+## 3. 검증 결과
+- 전체 어댑터 테스트 35개 중 32개 통과, 선택적 통합 테스트 3개 건너뜀.
+- 새 단위 테스트 5개로 구독 파싱과 범위, DLQ 인자 병합, 선언 오류 전파,
+  큐·exchange 전송 및 실제 RPC 발행 속성을 모의 연결로 검증했다.
+- 실제 classic 큐의 우선순위·동순위 FIFO 전달, 재전달 속성 보존 및 선언 충돌을
+  검증하는 선택적 통합 테스트 1개를 추가했다.
+- 로컬 AMQP 포트에는 접속할 수 있었지만 기본 계정은 인증 거부를 받았다.
+  사용자가 제공한 별도 계정으로 재시도한 결과 인증 후 `/` vhost 접근이
+  `530 NOT_ALLOWED`로 거부되어 실제 전달 검증은 완료하지 못했다.
+- 서버의 계정, 권한, vhost 및 기존 큐는 변경하지 않았다.
+  인증 정보는 소스나 문서에 저장하지 않고 해당 테스트 프로세스의 환경변수로만 전달했다.
+- 후속 검증에서는 작업 폴더의 Docker 설정으로 RabbitMQ 3.13.7을 새로 기동했다.
+  기본 `guest` 계정과 `/` vhost, classic 큐에서 전체 35개 테스트가
+  건너뜀 없이 통과했다. 앞선 인증·권한 문제로 인한 통합 검증 제한은 해소됐다.
+- 높은 우선순위 우선 전달, 동순위 FIFO, 재전달 속성 보존, 선언 충돌 전파와
+  기존 워커·RPC 성공·실패·타임아웃 경로를 실제 브로커에서 검증했다.
+- 어댑터 원본 경로의 Pylance 진단은 오류가 없었지만, 코어 내부 정션 경로와
+  테스트의 import 분석에는 이전 시그니처 및 타입 진단이 남아 있었다.
+  실제 파일·런타임 시그니처와 분석 결과가 달라 전체 정적 타입 검증을
+  통과한 것으로 간주하지 않는다. 큐의 `auto_decode`, 기존 nullable 주석 등
+  이번 기능과 무관한 진단도 있어 일괄 수정하지 않았다.
+- 기본값을 `Subscription.priority`로 통합한 뒤 Docker RabbitMQ 3.13.7에서
+  전체 38개 테스트가 건너뜀 없이 통과했다. 구독 기본값의 정규화·입력 불변성,
+  잘못된 기본값과 최대값 조합, 직접 브로커 전송·RPC의 기본값 사용을 추가로 검증했다.
+- 최신 Pylance 진단에서는 어댑터 원본 경로의 상대 import 해석 문제와 기존
+  타입 진단도 확인되어 전체 정적 분석 통과 상태는 아니다.
+## 4. 재검증 방법
+작업 폴더 루트에서 단위 테스트를 실행한다.
+```powershell
+$env:PYTHONIOENCODING = 'utf-8'
+$env:PYTHONUTF8 = '1'
+.\.venv\Scripts\python.exe -m unittest discover -s .\DefStream-RabbitMQ\test
+```
+실제 브로커 테스트는 로컬 `127.0.0.1:5672`의 `/` vhost에 큐 생성·발행·소비·삭제
+권한이 있는 계정이 필요하다. `DEFSTREAM_RABBITMQ_USERNAME`과
+`DEFSTREAM_RABBITMQ_PASSWORD` 환경변수에 테스트 인증 정보를 설정한 후 실행한다.
+미설정 시 기존 테스트 관례대로 `guest`를 사용한다.
+```powershell
+$env:DEFSTREAM_RABBITMQ_TESTS = '1'
+.\.venv\Scripts\python.exe -m unittest discover -s .\DefStream-RabbitMQ\test -p test_priorities.py
+```
+통합 테스트는 고유한 이름의 큐만 생성하고 종료 시 해당 큐를 삭제한다.
+## 5. 공통 브로커 참조 경로 통일
+- 모든 공통 인터페이스·예외·검증 함수·정책 참조를
+  `from DefStream.Broker import ...`로 변경했다.
+- 구현체 내부 상대 import와 기존 공개 정책 재노출은 유지했다.
+- RabbitMQ 3.13.7 실서버 통합 테스트를 포함한 전체 38개 테스트가 통과했다.
+## 6. 관련 문서
+- [사용 설명서](../../../README.md)
+- [공통 워커 구현 기록](../../../../DefStream/issues/feature/1/IMPLEMENTS.md)

defstream_rabbitmq-0.1.2.6/issues/feature/1/README.md ADDED Viewed

@@ -0,0 +1,103 @@
+# RabbitMQ 워커 작업 우선순위 지원
+## 변경 전 (AS-IS)
+저수준 `create_queue(maxPriority=...)`, `Queue.send(priority=...)`에서는
+우선순위를 지정할 수 있었지만, 워커의 작업 정의와 `declare`, `send`, `request`
+경로에서는 이를 설정할 수 없었습니다. `Queue.call`도 요청 우선순위를 받지 않았습니다.
+## 변경 후 (TO-BE)
+작업에 지정하는 `Subscription`에서 큐 최대 우선순위와 기본 메시지 우선순위를
+함께 정의할 수 있습니다. `declare`가 이 설정으로 classic 우선순위 큐를 생성하고,
+`send`와 `request`는 작업 기본값 또는 호출별 우선순위로 요청을 발행합니다.
+저수준 `Queue.call`에도 `priority=`를 사용할 수 있습니다.
+## 사용 방법
+작업 정의의 구독 설정에 `max_priority`와 `priority`를 추가하세요.
+```python
+from DefStream.Broker.Implements.RabbitMQ import Subscription
+from DefStream.Worker import (
+  Run,
+  declare,
+  request,
+  send,
+)
+class Add(
+  Run,
+  parameters=Subscription(
+    queue='tasks.add.priority',
+    qos=1,
+    max_priority=5,
+    priority=2,
+  ),
+):
+  def run(
+    self,
+    a,
+    b,
+  ):
+    return a + b
+```
+아래 코드는 호출자가 연결한 RabbitMQ `Connection`인 `broker`를 사용합니다.
+생산자와 소비자가 같은 작업 정의를 사용하고, 전송 전에 큐를 준비하세요.
+```python
+declare(
+  task=Add,
+  broker=broker,
+)
+# 작업 기본 우선순위 2로 전송합니다.
+send(
+  {'a': 1, 'b': 2},
+  task=Add,
+  broker=broker,
+)
+# 실행 중인 Worker에 우선순위 5로 RPC 요청을 보냅니다.
+result = request(
+  {'a': 1, 'b': 2},
+  task=Add,
+  broker=broker,
+  priority=5,
+)
+```
+| 설정 | 적용 결과 |
+|---|---|
+| `priority`만 지정 | 큐 최대값은 `255` |
+| `max_priority`만 지정 | 기본 메시지 우선순위는 `None` |
+| 호출값 생략 또는 `None` | 구독의 기본 `priority` 사용 |
+| 호출값 `0` | 기본값을 덮어쓰는 가장 낮은 우선순위 |
+| 작업·호출 모두 미지정 | 기존 동작 유지 |
+## 기존 코드에 미치는 영향과 전환
+- 우선순위를 사용하지 않는 기존 작업은 수정할 필요가 없습니다.
+- 기존 일반 큐에 우선순위를 추가하거나 큐 최대값을 변경하면 재선언이 실패합니다.
+  새 큐 이름으로 선언하고 생산자·소비자를 함께 전환하세요. 같은 이름을 유지해야
+  한다면 미처리 메시지를 보존한 뒤 운영 절차에 따라 큐를 재생성해야 합니다.
+  라이브러리는 기존 큐를 자동 삭제하지 않습니다.
+- 우선순위는 정수여야 하며 `bool`은 허용하지 않습니다. 최대값은 `1..255`,
+  메시지 값은 `0..큐 최대값`이어야 합니다. 타입 오류는 `TypeError`,
+  범위 오류는 `ValueError`가 발생합니다.
+- 작업 설정 없이 호출에서만 지정하면 `0..255` 범위만 검증합니다.
+  이 경우 우선순위 큐의 사전 선언과 실제 큐 최대값 준수는 호출자 책임입니다.
+- 기존 저수준 `Queue.send`, `Exchange.send`도 이제 우선순위의 타입과
+  `0..255` 범위를 명시적으로 검증합니다. 문자열·실수 등의 입력은 정수로 수정하세요.
+- 자식 작업에서 구독 설정을 교체할 때 부모의 기본·최대 우선순위를 제거할 수
+  없습니다. 유지할 값이나 재정의할 유효한 값을 새 `Subscription`에도 명시하세요.
+## 전달 순서 주의사항
+숫자가 클수록 같은 큐에 대기 중인 메시지를 먼저 전달합니다. 이미 prefetch되거나
+실행 중인 작업은 선점하지 않으며, 여러 소비자의 실행·완료 순서는 보장하지 않습니다.
+높은 우선순위가 계속 들어오면 낮은 우선순위가 오래 대기할 수 있습니다.
+큐 최대값이 클수록 자원 비용이 증가하므로 필요한 수준만 지정하세요.
+이번 기능은 classic 큐를 대상으로 하며 Stream·Quorum 큐는 대상이 아닙니다.

DefStream-RabbitMQ 0.1.1.3__tar.gz → 0.1.2.6__tar.gz

Potentially problematic release.

DefStream-RabbitMQ 0.1.1.3tar.gz → 0.1.2.6tar.gz