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

defstream_rabbitmq-0.1.3/.github/workflows/ci.yml

@@ -0,0 +1,612 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [master]
+  push:
+    branches: [master]
+
+permissions:
+  contents: read
+
+env:
+  RELEASE_SERIES: '0.1'
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: false
+
+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 }}
+      build: ${{ steps.changes.outputs.build }}
+      new_version: ${{ steps.changes.outputs.new_version }}
+      tag: ${{ steps.changes.outputs.tag }}
+      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:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Set up release planner Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: '3.13'
+      - name: Check complete push range and plan version
+        id: changes
+        env:
+          BEFORE: ${{ github.event.before }}
+          RELEASE_PUSH: ${{ github.event_name == 'push' && github.ref == 'refs/heads/master' }}
+        run: |
+          python - <<'PY'
+          from json import loads
+          from os import environ
+          from pathlib import Path
+          from re import fullmatch
+          from subprocess import check_output
+
+          release_push = environ['RELEASE_PUSH'] == 'true'
+          series = environ['RELEASE_SERIES']
+          if fullmatch(r'(0|[1-9]\d*)\.(0|[1-9]\d*)', series) is None:
+              raise ValueError(f'Invalid RELEASE_SERIES: {series!r}')
+          before = environ['BEFORE']
+          if not release_push:
+              event = loads(Path(environ['GITHUB_EVENT_PATH']).read_text(encoding='utf-8'))
+              before = event['pull_request']['base']['sha']
+          if not before:
+              raise ValueError('Missing push base commit')
+          first_push = set(before) == {'0'}
+          base = check_output(['git', 'hash-object', '-t', 'tree', '--stdin'], input='', text=True).strip() if first_push else before
+          # 재실행 시 이번 실행에서 만든 태그는 제외한다.
+          tags = [] if first_push else check_output(['git', 'tag', '--merged', before], text=True).splitlines()
+          releases = []
+          release_tags = {}
+          for tag in tags:
+              match = fullmatch(r'v?(\d+)\.(\d+)\.(\d+)(?:\.(\d+))?(?:\.post(\d+))?', tag)
+              if match and f'{int(match[1])}.{int(match[2])}' == series:
+                  release = tuple(map(int, match.groups()[:3])) + (
+                      int(match[4] or 0), int(match[5] or 0), match[4] is not None or match[5] is not None,
+                  )
+                  releases.append(release)
+                  release_tags[release] = tag
+          latest = max(releases) if releases else None
+          if latest is not None:
+              base = release_tags[latest]
+          changed = check_output(
+              [
+                  'git', 'diff', '--name-only', '--no-renames', base, environ['GITHUB_SHA'],
+                  '--', ':(glob)src/**/*.py', 'setup.py', 'setup.cfg', 'pyproject.toml', 'MANIFEST.in',
+              ],
+              text=True,
+          ).strip()
+          number = int(environ['GITHUB_RUN_NUMBER'])
+          if number < 1:
+              raise ValueError('Build number must be positive')
+          if latest is None and not changed:
+              raise ValueError('No release tag or source/packaging changes; tag the existing release before rebuilding')
+          migrate = latest is not None and latest[5]
+          new_version = bool(changed) or latest is None or migrate
+          if new_version:
+              patch = latest[2] + 1 if latest is not None else 0
+              print(f'New public version: source/packaging changes or initial/migration release\n{changed}')
+          else:
+              patch = latest[2]
+              print('Keeping MAJOR.MINOR.PATCH; publishing a new wheel build')
+          version = f'{series}.{patch}'
+          print(f'Planned version: {version}, wheel build: {number}')
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'release={str(release_push).lower()}\nversion={version}\n')
+              output.write(f'build={number}\nnew_version={str(new_version).lower()}\n')
+              output.write(f'tag={version if new_version else release_tags[latest]}\n')
+          PY
+      - name: Validate PR branch changelog
+        id: changelog
+        env:
+          GH_TOKEN: ${{ github.token }}
+          BEFORE: ${{ github.event.before }}
+          NEW_VERSION: ${{ steps.changes.outputs.new_version }}
+          RELEASE_TAG: ${{ steps.changes.outputs.tag }}
+        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('Multiple merged PRs found for the release commit')
+              branch = pulls[0]['head']['ref'] if pulls else 'master'
+          if environ['NEW_VERSION'] == 'false':
+              tag = environ['RELEASE_TAG']
+              release = loads(check_output([
+                  'gh', 'api', f'repos/{environ["GITHUB_REPOSITORY"]}/releases/tags/{tag}',
+              ]))
+              if release['tag_name'] != tag or not release.get('body', '').strip():
+                  raise ValueError(f'Existing release notes are missing or empty: {tag}')
+              body = release['body'].encode('utf-8')
+              print(f'Reusing release notes unchanged: {tag}')
+          elif environ['GITHUB_EVENT_NAME'] == 'push' and not pulls:
+              before = environ['BEFORE']
+              if not before:
+                  raise ValueError('Missing push base commit')
+              revision = head if set(before) == {'0'} else f'{before}..{head}'
+              commits = check_output(['git', 'log', '--reverse', '--format=- %s (%h)', revision])
+              body = '## master 직접 push\n\n'.encode('utf-8') + commits
+              print('Direct master push: generating release notes from commits')
+          else:
+              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}')
+              print(f'Customer changelog: {path}')
+          notes = Path(environ['RUNNER_TEMP'], 'release-notes', 'README.md')
+          notes.parent.mkdir(parents=True, exist_ok=True)
+          notes.write_bytes(body)
+          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
+
+  test:
+    name: Test Python ${{ matrix.python }}
+    needs: changes
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+    env:
+      PROJECT: ${{ github.event.repository.name }}
+      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
+        with:
+          repository: yong5eon/DefStream
+          ref: ${{ github.event.repository.name == 'DefStream' && github.sha || needs.changes.outputs.core_ref }}
+          path: packages/DefStream
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Check out RabbitMQ adapter
+        uses: actions/checkout@v7
+        with:
+          repository: yong5eon/DefStream-RabbitMQ
+          ref: ${{ github.event.repository.name == 'DefStream-RabbitMQ' && github.sha || needs.changes.outputs.rabbitmq_ref }}
+          path: packages/DefStream-RabbitMQ
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Check out Redis adapter
+        uses: actions/checkout@v7
+        with:
+          repository: yong5eon/DefStream-Redis
+          ref: ${{ github.event.repository.name == 'DefStream-Redis' && github.sha || needs.changes.outputs.redis_ref }}
+          path: packages/DefStream-Redis
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Record source commits and configure candidate version
+        env:
+          RELEASE_BUILD: ${{ needs.changes.outputs.release }}
+          RELEASE_VERSION: ${{ needs.changes.outputs.version }}
+        run: |
+          for package in packages/*; do
+            echo "$package: $(git -C "$package" rev-parse HEAD)"
+          done
+          echo "SOURCE_DATE_EPOCH=$(git -C "packages/$PROJECT" show -s --format=%ct HEAD)" >> "$GITHUB_ENV"
+          python - <<'PY'
+          from os import environ
+          from pathlib import Path
+          from re import fullmatch
+
+          project = environ['PROJECT']
+          if project not in ('DefStream', 'DefStream-RabbitMQ', 'DefStream-Redis'):
+              raise ValueError(f'Unexpected project: {project}')
+          if environ['RELEASE_BUILD'] != 'true':
+              print('Test-only build: using the existing Git-derived development version.')
+              raise SystemExit(0)
+          version = environ['RELEASE_VERSION']
+          if fullmatch(r'(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)', version) is None:
+              raise ValueError(f'Invalid planned version: {version!r}')
+          with Path(environ['GITHUB_ENV']).open('a', encoding='utf-8') as output:
+              output.write(f'RELEASE_VERSION={version}\n')
+          print(f'{project}: candidate {version}')
+          with Path(environ['GITHUB_STEP_SUMMARY']).open('a', encoding='utf-8') as summary:
+              summary.write(f'## {project} {version}\n\nSource: `{environ["GITHUB_SHA"]}`\n')
+          PY
+
+      - name: Install build tools
+        run: python -m pip install --upgrade build twine wheel
+
+      - name: Build source distributions and wheels
+        env:
+          RELEASE_BUILD: ${{ needs.changes.outputs.release }}
+          NEW_VERSION: ${{ needs.changes.outputs.new_version }}
+          WHEEL_BUILD: ${{ needs.changes.outputs.build }}
+        run: |
+          mkdir -p dist dependency-wheels
+          for name in DefStream DefStream-RabbitMQ DefStream-Redis; do
+            if [ "$name" = "$PROJECT" ]; then
+              if [ "$RELEASE_BUILD" = "true" ]; then
+                if [ "$NEW_VERSION" = "true" ]; then
+                  SETUPTOOLS_SCM_PRETEND_VERSION="$RELEASE_VERSION" python -m build --outdir "$GITHUB_WORKSPACE/dist" "packages/$name"
+                else
+                  SETUPTOOLS_SCM_PRETEND_VERSION="$RELEASE_VERSION" python -m build --wheel --outdir "$GITHUB_WORKSPACE/dist" "packages/$name"
+                fi
+                python -m wheel tags --build "$WHEEL_BUILD" --remove dist/*.whl
+              else
+                python -m build --outdir "$GITHUB_WORKSPACE/dist" "packages/$name"
+              fi
+            else
+              python -m build --outdir "$GITHUB_WORKSPACE/dependency-wheels" "packages/$name"
+            fi
+          done
+          python -m twine check --strict dist/*
+
+      - name: Normalize source archive timestamps
+        run: |
+          python - <<'PY'
+          from gzip import GzipFile
+          from io import BytesIO
+          from os import environ
+          from pathlib import Path
+          from tarfile import open as open_tar
+
+          epoch = int(environ['SOURCE_DATE_EPOCH'])
+          for path in Path('dist').glob('*.tar.gz'):
+              with BytesIO() as buffer:
+                  with open_tar(path, 'r:gz') as source:
+                      with GzipFile(fileobj=buffer, mode='wb', filename='', mtime=epoch) as compressed:
+                          with open_tar(fileobj=compressed, mode='w') as target:
+                              for member in sorted(source.getmembers(), key=lambda item: item.name):
+                                  member.mtime = epoch
+                                  member.uid = member.gid = 0
+                                  member.uname = member.gname = ''
+                                  member.pax_headers = {
+                                      key: value for key, value in member.pax_headers.items()
+                                      if key not in ('mtime', 'atime', 'ctime')
+                                  }
+                                  target.addfile(member, source.extractfile(member) if member.isfile() else None)
+                  path.write_bytes(buffer.getvalue())
+          PY
+
+      - name: Install built wheels into a clean environment
+        run: |
+          python -m venv "$RUNNER_TEMP/installed"
+          "$RUNNER_TEMP/installed/bin/python" -m pip install dist/*.whl dependency-wheels/*.whl
+          "$RUNNER_TEMP/installed/bin/python" -m pip check
+
+      - name: Test installed package
+        run: |
+          cd "$RUNNER_TEMP"
+          "$RUNNER_TEMP/installed/bin/python" -m unittest discover \
+            -s "$GITHUB_WORKSPACE/packages/$PROJECT/test" -p 'test_*.py' -v
+
+      - name: Set up Node for core UI tests
+        if: env.PROJECT == 'DefStream'
+        uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+
+      - name: Test core UI
+        if: env.PROJECT == 'DefStream'
+        run: node --test packages/DefStream/test/test_dashboard_ui.cjs
+
+      - name: Preserve verified release distributions
+        if: needs.changes.outputs.release == 'true' && matrix.python == '3.13'
+        uses: actions/upload-artifact@v7
+        with:
+          name: distributions
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 14
+
+  publish:
+    name: Publish PyPI
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master' && needs.changes.outputs.release == 'true'
+    needs: [changes, test]
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment: pypi
+    permissions:
+      contents: write
+    steps:
+      - name: Check out release source for tagging
+        uses: actions/checkout@v7
+        with:
+          ref: ${{ github.sha }}
+          path: release-source
+          fetch-depth: 0
+
+      - name: Download verified distributions
+        uses: actions/download-artifact@v8
+        with:
+          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:
+          python-version: '3.13'
+
+      - name: Check release status
+        id: release
+        env:
+          PROJECT: ${{ github.event.repository.name }}
+          RELEASE_VERSION: ${{ needs.changes.outputs.version }}
+          WHEEL_BUILD: ${{ needs.changes.outputs.build }}
+          NEW_VERSION: ${{ needs.changes.outputs.new_version }}
+        run: |
+          python - <<'PY'
+          from email.parser import BytesParser
+          from hashlib import sha256
+          from json import load
+          from os import environ
+          from pathlib import Path
+          from shutil import copy2
+          from urllib.error import HTTPError
+          from urllib.request import urlopen
+          from zipfile import ZipFile
+
+          wheels = list(Path('dist').glob('*.whl'))
+          sources = list(Path('dist').glob('*.tar.gz'))
+          expected_sources = 1 if environ['NEW_VERSION'] == 'true' else 0
+          if len(wheels) != 1 or len(sources) != expected_sources:
+              raise ValueError('Unexpected wheel/source distribution count for the release plan')
+          if wheels[0].name.split('-')[2] != environ['WHEEL_BUILD']:
+              raise ValueError('Wheel build tag does not match the release plan')
+          with ZipFile(wheels[0]) as archive:
+              metadata_path, = (name for name in archive.namelist() if name.endswith('.dist-info/METADATA'))
+              metadata = BytesParser().parsebytes(archive.read(metadata_path))
+          project = environ['PROJECT']
+          if metadata['Name'] != project:
+              raise ValueError(f'Unexpected distribution: {metadata["Name"]}')
+          version = metadata['Version']
+          expected_version = environ['RELEASE_VERSION']
+          if version != expected_version:
+              raise ValueError(f'Expected {expected_version}, got {version}')
+          try:
+              with urlopen(f'https://pypi.org/pypi/{project}/{version}/json', timeout=30) as response:
+                  release = load(response)
+          except HTTPError as error:
+              if error.code != 404:
+                  raise
+              published = {}
+          else:
+              published = {file['filename']: file['digests']['sha256'] for file in release['urls']}
+          if environ['NEW_VERSION'] != 'true' and not published:
+              raise RuntimeError('Cannot rebuild a version that has not been published on PyPI')
+          upload = Path('upload')
+          upload.mkdir()
+          for path in [*wheels, *sources]:
+              if path.name in published:
+                  if sha256(path.read_bytes()).hexdigest() != published[path.name]:
+                      raise RuntimeError(f'Published file differs; refusing to overwrite {path.name}')
+                  print(f'Already published: {path.name}')
+              else:
+                  copy2(path, upload / path.name)
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'publish={str(any(upload.iterdir())).lower()}\n')
+              output.write(f'version={version}\n')
+          PY
+
+      - name: Record verified release tag
+        env:
+          VERSION: ${{ needs.changes.outputs.tag }}
+          NEW_VERSION: ${{ needs.changes.outputs.new_version }}
+        run: |
+          tag="$VERSION"
+          cd release-source
+          if git show-ref --verify --quiet "refs/tags/$tag"; then
+            if [ "$NEW_VERSION" = "true" ] && [ "$(git rev-parse "$tag^{commit}")" != "$GITHUB_SHA" ]; then
+              echo "::error::$tag already points at another commit."
+              exit 1
+            fi
+          else
+            if [ "$NEW_VERSION" != "true" ]; then
+              echo "::error::Existing release tag is missing: $tag"
+              exit 1
+            fi
+            git tag "$tag" "$GITHUB_SHA"
+          fi
+          git push origin "refs/tags/$tag"
+
+      - name: Install upload tool
+        if: steps.release.outputs.publish == 'true'
+        run: python -m pip install --upgrade twine
+
+      - name: Upload to PyPI
+        if: steps.release.outputs.publish == 'true'
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          if [ -z "$TWINE_PASSWORD" ]; then
+            echo "::error::Configure PYPI_API_TOKEN in the pypi environment or repository Actions secrets."
+            exit 1
+          fi
+          python -m twine upload --non-interactive upload/*
+
+      - name: Publish GitHub Release with verified distributions
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION: ${{ steps.release.outputs.version }}
+          RELEASE_TAG: ${{ needs.changes.outputs.tag }}
+          WHEEL_BUILD: ${{ needs.changes.outputs.build }}
+          NEW_VERSION: ${{ needs.changes.outputs.new_version }}
+        run: |
+          python - <<'PY'
+          from json import load
+          from hashlib import sha256
+          from os import environ
+          from pathlib import Path
+          from subprocess import run
+          from tempfile import TemporaryDirectory
+          from urllib.error import HTTPError
+          from urllib.parse import quote
+          from urllib.request import Request, urlopen
+
+          repository = environ['GITHUB_REPOSITORY']
+          version = environ['VERSION']
+          tag = environ['RELEASE_TAG']
+          release = None
+          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(tag, safe="")}',
+              headers={
+                  'Authorization': f'Bearer {environ["GH_TOKEN"]}',
+                  'Accept': 'application/vnd.github+json',
+                  'X-GitHub-Api-Version': '2022-11-28',
+              },
+          )
+          try:
+              with urlopen(request, timeout=30) as response:
+                  release = load(response)
+          except HTTPError as error:
+              if error.code != 404:
+                  raise
+              if environ['NEW_VERSION'] != 'true':
+                  raise RuntimeError('Existing GitHub Release is missing') from error
+              run([
+                  'gh', 'release', 'create', tag, '--repo', repository,
+                  '--verify-tag', '--title', version, '--notes-file', str(notes), '--draft',
+              ], check=True)
+          else:
+              if release['tag_name'] != tag:
+                  raise ValueError('GitHub Release does not match the verified version')
+              if environ['NEW_VERSION'] != 'true':
+                  if not (release['body'] or '').strip():
+                      raise ValueError('Existing release notes are empty')
+                  notes.write_text(release['body'], encoding='utf-8')
+          artifacts = sorted(str(path) for path in Path('dist').iterdir() if path.is_file())
+          existing = {asset['name'] for asset in release['assets']} if release is not None else set()
+          for artifact in artifacts:
+              path = Path(artifact)
+              if path.name in existing:
+                  with TemporaryDirectory() as directory:
+                      run([
+                          'gh', 'release', 'download', tag, '--repo', repository,
+                          '--pattern', path.name, '--dir', directory,
+                      ], check=True)
+                      if sha256((Path(directory) / path.name).read_bytes()).digest() != sha256(path.read_bytes()).digest():
+                          raise RuntimeError(f'GitHub asset differs; refusing to overwrite {path.name}')
+              else:
+                  run(['gh', 'release', 'upload', tag, '--repo', repository, artifact], check=True)
+          run([
+              'gh', 'release', 'edit', tag, '--repo', repository,
+              '--notes-file', str(notes), '--draft=false',
+          ], check=True)
+          PY

{defstream_rabbitmq-0.1.1.3 → defstream_rabbitmq-0.1.3/DefStream_RabbitMQ.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream-RabbitMQ
-Version: 0.1.1.3
+Version: 0.1.3
 Summary: RabbitMQ broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
 Author: Heo Yongseon
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: DefStream>=0.1.0
+Requires-Dist: DefStream>=0.1.5
 Requires-Dist: pika>=1.3.2
 Dynamic: author
 Dynamic: classifier
@@ -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()`의 반환값을 받습니다.