DefStream-RabbitMQ 0.1.1__tar.gz → 0.1.1.2__tar.gz

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

@@ -0,0 +1,403 @@
+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
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    outputs:
+      release: ${{ steps.changes.outputs.release }}
+      version: ${{ steps.changes.outputs.version }}
+    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 os import environ
+          from pathlib import Path
+          from re import fullmatch
+          from subprocess import check_output
+
+          if environ['RELEASE_PUSH'] != 'true':
+              with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+                  output.write('release=false\n')
+              raise SystemExit(0)
+          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 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
+          changed = check_output(
+              ['git', 'diff', '--name-only', '--no-renames', base, environ['GITHUB_SHA'], '--', 'src/'],
+              text=True,
+          ).strip()
+          # Anchor to the pre-push history so a rerun ignores its own release tag.
+          tags = [] if first_push else check_output(['git', 'tag', '--merged', before], text=True).splitlines()
+          releases = []
+          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:
+                  releases.append(tuple(map(int, match.groups()[:3])) + (int(match[4] or 0),))
+          latest = max(releases) if releases else None
+          number = int(environ['GITHUB_RUN_NUMBER'])
+          if number < 1:
+              raise ValueError('Build number must be positive')
+          if latest is not None and number <= latest[3]:
+              raise ValueError('Build number must exceed the previous build; do not reset the workflow counter')
+          if changed:
+              patch = latest[2] + 1 if latest is not None else 0
+              print(f'Source changes:\n{changed}')
+          else:
+              if latest is None:
+                  raise ValueError(
+                      'No release tag in pre-push history for this series. '
+                      'Tag the exact source commit of the existing PyPI release before retrying.'
+                  )
+              patch = latest[2]
+              print('No src changes: keeping MAJOR.MINOR.PATCH and increasing BUILD')
+          version = f'{series}.{patch}.{number}'
+          print(f'Planned version: {version}')
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'release=true\nversion={version}\n')
+          PY
+
+  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 || 'master' }}
+          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 || 'master' }}
+          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 || 'master' }}
+          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 tag candidate locally
+        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
+          from subprocess import check_output, run
+
+          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*)\.[1-9]\d*', version) is None:
+              raise ValueError(f'Invalid planned version: {version!r}')
+          path = Path('packages') / project
+          tag = version
+          tags = check_output(['git', '-C', str(path), 'tag', '--list', tag], text=True).strip()
+          if tags:
+              tagged = check_output(['git', '-C', str(path), 'rev-parse', f'{tag}^{{commit}}'], text=True).strip()
+              if tagged != environ['GITHUB_SHA']:
+                  raise RuntimeError(f'{tag} already points at another commit')
+          else:
+              run(['git', '-C', str(path), 'tag', tag, environ['GITHUB_SHA']], check=True)
+          print(f'{project}: local candidate {tag}')
+          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
+
+      - name: Build source distributions and wheels
+        run: |
+          mkdir -p dist dependency-wheels
+          for name in DefStream DefStream-RabbitMQ DefStream-Redis; do
+            if [ "$name" = "$PROJECT" ]; then
+              python -m build --outdir "$GITHUB_WORKSPACE/dist" "packages/$name"
+            else
+              python -m build --outdir "$GITHUB_WORKSPACE/dependency-wheels" "packages/$name"
+            fi
+          done
+          python -m twine check --strict dist/*
+
+      - 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: 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 }}
+        run: |
+          python - <<'PY'
+          from email.parser import BytesParser
+          from json import load
+          from os import environ
+          from pathlib import Path
+          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'))
+          if len(wheels) != 1 or len(sources) != 1:
+              raise ValueError('Expected exactly one wheel and one source distribution')
+          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
+              exists = False
+          else:
+              expected = {wheels[0].name, sources[0].name}
+              published = {file['filename'] for file in release['urls']}
+              if int(environ['GITHUB_RUN_ATTEMPT']) == 1 or not expected.issubset(published):
+                  raise RuntimeError(
+                      f'{project} {version} already exists or is partially published. '
+                      'Do not overwrite it; use a new run/version or repair the release manually.'
+                  )
+              print(f'{project} {version}: already published; skipping this rerun')
+              exists = True
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'publish={str(not exists).lower()}\n')
+              output.write(f'version={version}\n')
+          PY
+
+      - name: Record verified release tag
+        env:
+          VERSION: ${{ steps.release.outputs.version }}
+        run: |
+          tag="$VERSION"
+          cd release-source
+          if git show-ref --verify --quiet "refs/tags/$tag"; then
+            if [ "$(git rev-parse "$tag^{commit}")" != "$GITHUB_SHA" ]; then
+              echo "::error::$tag already points at another commit."
+              exit 1
+            fi
+          else
+            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 dist/*
+
+      - name: Publish GitHub Release with verified distributions
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION: ${{ steps.release.outputs.version }}
+        run: |
+          python - <<'PY'
+          from json import load
+          from os import environ
+          from pathlib import Path
+          from subprocess import run
+          from urllib.error import HTTPError
+          from urllib.parse import quote
+          from urllib.request import Request, urlopen
+
+          repository = environ['GITHUB_REPOSITORY']
+          version = environ['VERSION']
+          request = Request(
+              f'{environ["GITHUB_API_URL"]}/repos/{repository}/releases/tags/{quote(version, 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
+              run([
+                  'gh', 'release', 'create', version, '--repo', repository,
+                  '--verify-tag', '--title', version, '--generate-notes', '--draft',
+              ], check=True)
+          else:
+              if release['tag_name'] != version:
+                  raise ValueError('GitHub Release does not match the verified version')
+          artifacts = sorted(str(path) for path in Path('dist').iterdir() if path.is_file())
+          run([
+              'gh', 'release', 'upload', version, '--repo', repository,
+              '--clobber', *artifacts,
+          ], check=True)
+          run([
+              'gh', 'release', 'edit', version, '--repo', repository, '--draft=false',
+          ], check=True)
+          PY

defstream_rabbitmq-0.1.1.2/.gitignore

@@ -0,0 +1,58 @@
+# Python bytecode and caches
+__pycache__/
+*.py[codz]
+*$py.class
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+.nox/
+.coverage
+.coverage.*
+
+# Virtual environments and local environment files
+.venv/
+venv/
+env/
+.env
+.env.*
+
+# Python packaging and build artifacts
+build/
+dist/
+*.egg-info/
+*.egg
+.Python
+
+# Operating system files
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Miscellaneous files
+*.log
+*.tmp
+*.bak
+*.swp
+*.swo
+
+# Temporary files
+tmp/
+*.tmp
+*.temp
+
+# IDE and editor specific files
+.vscode/
+.idea/
+
+# Git
+.git/
+
+# GitHub specific files
+.github/
+!/.github/
+/.github/*
+!/.github/workflows/
+
+# GitLab specific files
+.gitlab/

{defstream_rabbitmq-0.1.1 → defstream_rabbitmq-0.1.1.2}/DefStream_RabbitMQ.egg-info/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: DefStream-RabbitMQ
-Version: 0.1.1
+Version: 0.1.1.2
 Summary: RabbitMQ broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
 Author: Heo Yongseon
 Project-URL: Source, https://github.com/yong5eon/DefStream-RabbitMQ
 Project-URL: Issues, https://github.com/yong5eon/DefStream-RabbitMQ/issues
+Project-URL: Releases, https://github.com/yong5eon/DefStream-RabbitMQ/releases
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -41,11 +42,58 @@ commit IDs recorded in the log. All three GitHub repositories must be accessible
 This bootstrap setup does not require existing PyPI releases and does not
 certify compatibility with previously published dependencies.
 
-On a `master` push, the build uses `major.minor.<github.run_number>` from the
-checked-in `VERSION` (for example, `0.1.42`). PR builds retain `VERSION`. No
-version commit, PR, or tag is created. Change major/minor to start a new series;
-run numbers can have gaps. Check for PyPI version collisions before replacing
-or renaming the workflow.
+There is no `VERSION` or `pyproject.toml` file. `setup.py` configures
+`setuptools-scm` via `setup_requires`; `python -m build` resolves the build
+dependency in isolation. This legacy declaration may emit a deprecation warning.
+`setuptools-scm` derives versions from Git tags.
+CI fetches full history and creates a local candidate tag
+`<RELEASE_SERIES>.<PATCH>.<github.run_number>` (for example, `0.1.3.123`) on
+every `master` push. Source changes increment PATCH by one; all other changes
+keep MAJOR.MINOR.PATCH. BUILD is always the Actions run number:
+`0.1.3.123` -> `0.1.3.124` (docs) -> `0.1.4.125` (source).
+The highest matching version in pre-push history supplies the base, keeping
+reruns stable. The four-part value is the full public PyPI version.
+New tags have no `v` prefix; existing `v` tags remain readable.
+PRs only run tests using their Git-derived development version without a tag.
+The complete push range is compared, including additions, deletions, and
+renames. Changes only to tests, docs, samples, workflows, or `setup.py` increase
+only BUILD. PyPI files cannot be overwritten; every upload has a distinct
+version identifier. Change
+`RELEASE_SERIES` in the workflow to start a new major/minor series. No version
+commit or version-update PR is created; run numbers can have gaps.
+
+After all tests pass, the publish job pushes the release tag to the tested
+commit before uploading the verified artifacts. A tag may exist if uploading
+subsequently fails; retry the run and check PyPI for publication status.
+Existing tags on other commits are never overwritten. Allow the workflow's
+`GITHUB_TOKEN` to write contents and permit numeric four-part tags
+in any tag rulesets.
+
+After PyPI upload succeeds (or a rerun confirms the version is fully
+published), CI creates a GitHub Release titled and tagged with the same
+version, with automatically generated notes and the verified wheel and sdist
+attached. New releases remain drafts until both assets are uploaded. A retry
+reuses the release, replaces matching assets with the verified files, and
+publishes it. PyPI upload failures prevent this step. The existing write-enabled
+`GITHUB_TOKEN` is sufficient; no extra token secret is required. PyPI's project
+links include the GitHub Releases page for change history.
+
+Fetch tags with `git fetch --tags` for local builds. Tagged commits produce
+release versions; later commits produce development versions, with local
+suffixes for dirty trees. Build from a Git checkout or a published sdist, not
+a GitHub source ZIP without Git metadata. Installed versions are available via
+`importlib.metadata.version('DefStream-RabbitMQ')`. Before migration, tag the
+exact source commits of existing PyPI releases in all three repositories,
+using their version numbers as tags.
+Untagged SCM dependencies may resolve below their required minimum version;
+initial release tags also provide the starting PATCH for numeric builds.
+A tag such as `0.1.3` must name the commit used to publish that version, not
+an arbitrary current commit. Adding that tag does not edit sources or upload
+anything to PyPI.
+A new release series needs a source change or an existing matching release tag
+before it can produce builds. Its first source release starts at PATCH 0.
+Build counter regressions fail explicitly. Legacy `.postN` tags remain
+readable; numeric builds sort above post releases of a three-part base.
 
 Only after all six Python checks pass does a separate publish job upload the
 exact Python 3.13 build artifacts. A fully published version is skipped on a

{defstream_rabbitmq-0.1.1 → defstream_rabbitmq-0.1.1.2}/DefStream_RabbitMQ.egg-info/SOURCES.txt

@@ -1,13 +1,16 @@
+.gitignore
 LICENSE
-MANIFEST.in
 README.md
-VERSION
 setup.py
+.github/workflows/ci.yml
 DefStream_RabbitMQ.egg-info/PKG-INFO
 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
+sample/Sample.RPC.py
+sample/Sample.Stream.py
+sample/Sample.py
 src/Configuration.py
 src/Connection.py
 src/Consumer.py

{defstream_rabbitmq-0.1.1 → defstream_rabbitmq-0.1.1.2}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: DefStream-RabbitMQ
-Version: 0.1.1
+Version: 0.1.1.2
 Summary: RabbitMQ broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
 Author: Heo Yongseon
 Project-URL: Source, https://github.com/yong5eon/DefStream-RabbitMQ
 Project-URL: Issues, https://github.com/yong5eon/DefStream-RabbitMQ/issues
+Project-URL: Releases, https://github.com/yong5eon/DefStream-RabbitMQ/releases
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -41,11 +42,58 @@ commit IDs recorded in the log. All three GitHub repositories must be accessible
 This bootstrap setup does not require existing PyPI releases and does not
 certify compatibility with previously published dependencies.
 
-On a `master` push, the build uses `major.minor.<github.run_number>` from the
-checked-in `VERSION` (for example, `0.1.42`). PR builds retain `VERSION`. No
-version commit, PR, or tag is created. Change major/minor to start a new series;
-run numbers can have gaps. Check for PyPI version collisions before replacing
-or renaming the workflow.
+There is no `VERSION` or `pyproject.toml` file. `setup.py` configures
+`setuptools-scm` via `setup_requires`; `python -m build` resolves the build
+dependency in isolation. This legacy declaration may emit a deprecation warning.
+`setuptools-scm` derives versions from Git tags.
+CI fetches full history and creates a local candidate tag
+`<RELEASE_SERIES>.<PATCH>.<github.run_number>` (for example, `0.1.3.123`) on
+every `master` push. Source changes increment PATCH by one; all other changes
+keep MAJOR.MINOR.PATCH. BUILD is always the Actions run number:
+`0.1.3.123` -> `0.1.3.124` (docs) -> `0.1.4.125` (source).
+The highest matching version in pre-push history supplies the base, keeping
+reruns stable. The four-part value is the full public PyPI version.
+New tags have no `v` prefix; existing `v` tags remain readable.
+PRs only run tests using their Git-derived development version without a tag.
+The complete push range is compared, including additions, deletions, and
+renames. Changes only to tests, docs, samples, workflows, or `setup.py` increase
+only BUILD. PyPI files cannot be overwritten; every upload has a distinct
+version identifier. Change
+`RELEASE_SERIES` in the workflow to start a new major/minor series. No version
+commit or version-update PR is created; run numbers can have gaps.
+
+After all tests pass, the publish job pushes the release tag to the tested
+commit before uploading the verified artifacts. A tag may exist if uploading
+subsequently fails; retry the run and check PyPI for publication status.
+Existing tags on other commits are never overwritten. Allow the workflow's
+`GITHUB_TOKEN` to write contents and permit numeric four-part tags
+in any tag rulesets.
+
+After PyPI upload succeeds (or a rerun confirms the version is fully
+published), CI creates a GitHub Release titled and tagged with the same
+version, with automatically generated notes and the verified wheel and sdist
+attached. New releases remain drafts until both assets are uploaded. A retry
+reuses the release, replaces matching assets with the verified files, and
+publishes it. PyPI upload failures prevent this step. The existing write-enabled
+`GITHUB_TOKEN` is sufficient; no extra token secret is required. PyPI's project
+links include the GitHub Releases page for change history.
+
+Fetch tags with `git fetch --tags` for local builds. Tagged commits produce
+release versions; later commits produce development versions, with local
+suffixes for dirty trees. Build from a Git checkout or a published sdist, not
+a GitHub source ZIP without Git metadata. Installed versions are available via
+`importlib.metadata.version('DefStream-RabbitMQ')`. Before migration, tag the
+exact source commits of existing PyPI releases in all three repositories,
+using their version numbers as tags.
+Untagged SCM dependencies may resolve below their required minimum version;
+initial release tags also provide the starting PATCH for numeric builds.
+A tag such as `0.1.3` must name the commit used to publish that version, not
+an arbitrary current commit. Adding that tag does not edit sources or upload
+anything to PyPI.
+A new release series needs a source change or an existing matching release tag
+before it can produce builds. Its first source release starts at PATCH 0.
+Build counter regressions fail explicitly. Legacy `.postN` tags remain
+readable; numeric builds sort above post releases of a three-part base.
 
 Only after all six Python checks pass does a separate publish job upload the
 exact Python 3.13 build artifacts. A fully published version is skipped on a

{defstream_rabbitmq-0.1.1 → defstream_rabbitmq-0.1.1.2}/README.md

@@ -11,11 +11,58 @@ commit IDs recorded in the log. All three GitHub repositories must be accessible
 This bootstrap setup does not require existing PyPI releases and does not
 certify compatibility with previously published dependencies.
 
-On a `master` push, the build uses `major.minor.<github.run_number>` from the
-checked-in `VERSION` (for example, `0.1.42`). PR builds retain `VERSION`. No
-version commit, PR, or tag is created. Change major/minor to start a new series;
-run numbers can have gaps. Check for PyPI version collisions before replacing
-or renaming the workflow.
+There is no `VERSION` or `pyproject.toml` file. `setup.py` configures
+`setuptools-scm` via `setup_requires`; `python -m build` resolves the build
+dependency in isolation. This legacy declaration may emit a deprecation warning.
+`setuptools-scm` derives versions from Git tags.
+CI fetches full history and creates a local candidate tag
+`<RELEASE_SERIES>.<PATCH>.<github.run_number>` (for example, `0.1.3.123`) on
+every `master` push. Source changes increment PATCH by one; all other changes
+keep MAJOR.MINOR.PATCH. BUILD is always the Actions run number:
+`0.1.3.123` -> `0.1.3.124` (docs) -> `0.1.4.125` (source).
+The highest matching version in pre-push history supplies the base, keeping
+reruns stable. The four-part value is the full public PyPI version.
+New tags have no `v` prefix; existing `v` tags remain readable.
+PRs only run tests using their Git-derived development version without a tag.
+The complete push range is compared, including additions, deletions, and
+renames. Changes only to tests, docs, samples, workflows, or `setup.py` increase
+only BUILD. PyPI files cannot be overwritten; every upload has a distinct
+version identifier. Change
+`RELEASE_SERIES` in the workflow to start a new major/minor series. No version
+commit or version-update PR is created; run numbers can have gaps.
+
+After all tests pass, the publish job pushes the release tag to the tested
+commit before uploading the verified artifacts. A tag may exist if uploading
+subsequently fails; retry the run and check PyPI for publication status.
+Existing tags on other commits are never overwritten. Allow the workflow's
+`GITHUB_TOKEN` to write contents and permit numeric four-part tags
+in any tag rulesets.
+
+After PyPI upload succeeds (or a rerun confirms the version is fully
+published), CI creates a GitHub Release titled and tagged with the same
+version, with automatically generated notes and the verified wheel and sdist
+attached. New releases remain drafts until both assets are uploaded. A retry
+reuses the release, replaces matching assets with the verified files, and
+publishes it. PyPI upload failures prevent this step. The existing write-enabled
+`GITHUB_TOKEN` is sufficient; no extra token secret is required. PyPI's project
+links include the GitHub Releases page for change history.
+
+Fetch tags with `git fetch --tags` for local builds. Tagged commits produce
+release versions; later commits produce development versions, with local
+suffixes for dirty trees. Build from a Git checkout or a published sdist, not
+a GitHub source ZIP without Git metadata. Installed versions are available via
+`importlib.metadata.version('DefStream-RabbitMQ')`. Before migration, tag the
+exact source commits of existing PyPI releases in all three repositories,
+using their version numbers as tags.
+Untagged SCM dependencies may resolve below their required minimum version;
+initial release tags also provide the starting PATCH for numeric builds.
+A tag such as `0.1.3` must name the commit used to publish that version, not
+an arbitrary current commit. Adding that tag does not edit sources or upload
+anything to PyPI.
+A new release series needs a source change or an existing matching release tag
+before it can produce builds. Its first source release starts at PATCH 0.
+Build counter regressions fail explicitly. Legacy `.postN` tags remain
+readable; numeric builds sort above post releases of a three-part base.
 
 Only after all six Python checks pass does a separate publish job upload the
 exact Python 3.13 build artifacts. A fully published version is skipped on a

defstream_rabbitmq-0.1.1.2/sample/Sample.RPC.py

@@ -0,0 +1,168 @@
+from concurrent.futures import ThreadPoolExecutor
+from sys import stderr
+from threading import Event as PyEvent
+from uuid import uuid4
+
+from DefStream.Broker import RemoteError
+from DefStream.Broker.Implements.RabbitMQ import (
+	Connection,
+	Configuration,
+	Consumer,
+	Event,
+	EventHandler,
+	ExchangeType,
+	Reject,
+)
+
+
+class Calculate(EventHandler):
+	def __init__(
+		self,
+		consumer: Consumer,
+	):
+		self.consumer = consumer
+
+	def __call__(
+		self,
+		event: Event,
+	) -> None:
+		try:
+			result = event.body['a'] / event.body['b']
+		except ZeroDivisionError:
+			self.consumer.fail(
+				event,
+				Reject(),
+			)
+		else:
+			self.consumer.complete(
+				event,
+				result,
+			)
+
+
+def serve(
+	configuration: Configuration,
+	queue: str,
+	ready: PyEvent,
+	stopping: PyEvent,
+) -> None:
+	broker = Connection(configuration)
+	try:
+		broker.connect()
+		consumer = broker.consumer()
+		try:
+			consumer.subs(
+				queue,
+				Calculate(consumer),
+			)
+			ready.set()
+
+			def check_stop() -> None:
+				if stopping.is_set():
+					consumer.stop()
+				else:
+					broker.connection.call_later(
+						0.1,
+						check_stop,
+					)
+
+			broker.connection.call_later(
+				0.1,
+				check_stop,
+			)
+			consumer.run()
+		finally:
+			consumer.close()
+	finally:
+		broker.close()
+		ready.set()
+
+
+if __name__ == '__main__':
+	configuration = Configuration(
+		host='127.0.0.1',
+		port=5672,
+		username='guest',
+		password='guest',
+	)
+	broker = Connection(configuration)
+	name = 'defstream-rpc-sample-' + uuid4().hex
+	ready = PyEvent()
+	stopping = PyEvent()
+	created_queue = False
+	created_exchange = False
+	try:
+		broker.connect()
+		broker.create_exchange(
+			name,
+			ExchangeType.Direct,
+			durable=False,
+		)
+		created_exchange = True
+		broker.create_queue(
+			name,
+			durable=False,
+		)
+		created_queue = True
+		broker.bind_exchange_to_queue(
+			name,
+			name,
+			event='divide',
+		)
+		with ThreadPoolExecutor(1) as executor:
+			server = executor.submit(
+				serve,
+				configuration,
+				name,
+				ready,
+				stopping,
+			)
+			try:
+				if not ready.wait(10):
+					raise TimeoutError('RPC server did not start')
+				if server.done():
+					server.result()
+					raise RuntimeError('RPC server exited before handling requests')
+				result = broker.queue(name).call(
+					{
+						'a': 20,
+						'b': 4,
+					},
+					timeout=5,
+				)
+				print(f'Queue RPC: 20 / 4 = {result}')
+				result = broker.exchange(name).call(
+					{
+						'a': 30,
+						'b': 5,
+					},
+					timeout=5,
+					event='divide',
+				)
+				print(f'Exchange RPC: 30 / 5 = {result}')
+				try:
+					broker.queue(name).call(
+						{
+							'a': 10,
+							'b': 0,
+						},
+						timeout=5,
+					)
+				except RemoteError as error:
+					print(
+						f'RPC rejected: {error}',
+						file=stderr,
+					)
+			finally:
+				stopping.set()
+				server.result(timeout=10)
+	finally:
+		try:
+			if created_queue:
+				broker.delete_queue(name)
+		finally:
+			try:
+				if created_exchange:
+					broker.delete_exchange(name)
+			finally:
+				broker.close()

defstream_rabbitmq-0.1.1.2/sample/Sample.Stream.py

@@ -0,0 +1,84 @@
+# Sample for DefStream.Broker.Implements.RabbitMQ
+
+from DefStream.Broker.Implements.RabbitMQ import (
+	Connection as RabbitConnection,
+	Configuration,
+	Event,
+	EventHandler,
+)
+from threading import Timer
+from random import randint
+
+if __name__ == '__main__':
+
+	con = RabbitConnection(
+		Configuration(
+			host='127.0.0.1',
+			port=5672,
+			username='guest',
+			password='guest',
+		),
+	)
+
+	con.connect()
+	con.create_stream('stream')
+
+	stream = con.stream('stream')
+	for i in range(randint(
+		5,
+		10,
+	)):
+		stream.send(randint(
+			0,
+			10,
+		))
+
+	class SampleEventHandler(EventHandler):
+		def __call__(
+			self,
+			event: Event,
+		):
+			try:
+				print(event.body)
+				event.ack()
+			except RuntimeError:
+				event.nack()  # if you want requeue message
+				# event.reject()  # if you want drop message or move to DLQ or DLE
+				pass
+			return
+
+	for i in range(randint(
+		2,
+		5,
+	)):
+		print('Consuming Events from Stream Queue: {}'.format(i + 1))	
+		print('-' * 20)
+		consumer = con.consumer(
+			handler=SampleEventHandler(),
+			qos=1,
+			offset=0,
+		)
+	
+		def stop(timer):
+			consumer.stop()
+			return
+		
+		Timer(
+			1,
+			lambda: stop(None),
+		).start()
+	
+		consumer.subs('stream')
+		consumer.run()
+
+	print('Read Events from Stream Queue:')	
+	print('-' * 20)	
+	stream = con.stream('stream')
+	try:
+		for event in stream.read(timeout=1000):
+			print(event.body)
+	except KeyboardInterrupt:
+		pass
+
+	con.delete_stream('stream')
+	con.close()

defstream_rabbitmq-0.1.1.2/sample/Sample.py

@@ -0,0 +1,127 @@
+# Sample for DefStream.Broker.Implements.RabbitMQ
+
+from DefStream.Broker.Implements.RabbitMQ import (
+	Connection as RabbitConnection,
+	Configuration,
+	ExchangeType,
+	Event,
+	EventHandler,
+)
+from threading import Timer
+
+if __name__ == '__main__':
+
+	con = RabbitConnection(
+		Configuration(
+			host='127.0.0.1',
+			port=5672,
+			username='guest',
+			password='guest',
+		),
+	)
+
+	con.connect()
+	con.create_exchange(
+		'topic',
+		ExchangeType.Topic,
+	)
+	con.create_queue(
+		'queue',
+		maxPriority=255,
+	)
+	con.bind_exchange_to_queue(
+		'topic',
+		'queue',
+	)
+
+	exchange = con.exchange('topic')
+	exchange.send(
+		{
+			'a': True,
+			'b': 1,
+			'c': 1.0,
+			'd': 'abc',
+		},
+		priority=1,
+	)
+	queue = con.queue('queue')
+	queue.send({
+		'a': False,
+		'b': 2,
+		'c': 2.0,
+		'd': 'def',
+	})
+
+	reader = con.queue('queue')
+	e = reader.pop()
+	print(e)
+	e.ack()
+	e = reader.pop()
+	print(e)
+	e.ack()
+
+	exchange.send(
+		{
+			'a': True,
+			'b': 1,
+			'c': 1.0,
+			'd': 'abc',
+		},
+		priority=0,
+	)
+	queue.send(
+		{
+			'a': False,
+			'b': 2,
+			'c': 2.0,
+			'd': 'def',
+		},
+		priority=255,
+	)
+	exchange.send({
+		'a': True,
+		'b': 1,
+		'c': 1.0,
+		'd': 'abc',
+	})
+	queue.send({
+		'a': False,
+		'b': 1,
+		'c': 3.0,
+		'd': 'def',
+	})
+
+	class SampleEventHandler(EventHandler):
+		def __call__(
+			self,
+			event: Event,
+		):
+			try:
+				print(event.body)
+				print(event.priority)
+				event.ack()
+			except RuntimeError:
+				event.nack()  # if you want requeue message
+				# event.reject()  # if you want drop message or move to DLQ or DLE
+			return
+		
+	consumer = con.consumer(
+		handler=SampleEventHandler(),
+		qos=1,
+	)
+
+	def stop(timer):
+		consumer.stop()
+		return
+	
+	Timer(
+		1,
+		lambda: stop(None),
+	).start()
+
+	consumer.subs('queue')
+	consumer.run()
+
+	con.delete_queue('queue')
+	con.delete_exchange('topic')
+	con.close()

{defstream_rabbitmq-0.1.1 → defstream_rabbitmq-0.1.1.2}/setup.py

@@ -38,8 +38,14 @@ setup(
 	project_urls={
 		'Source': 'https://github.com/yong5eon/DefStream-RabbitMQ',
 		'Issues': 'https://github.com/yong5eon/DefStream-RabbitMQ/issues',
+		'Releases': 'https://github.com/yong5eon/DefStream-RabbitMQ/releases',
 	},
-	version=Path('VERSION').read_text(encoding='utf-8').strip(),
+	use_scm_version={
+		'tag_regex': r'^v?(?P<version>[0-9]+\.[0-9]+\.[0-9]+(?:\.[0-9]+)?(?:(?:rc|\.post)[0-9]+)?)$',
+	},
+	setup_requires=[
+		'setuptools-scm>=8,<10',
+	],
 	packages=PACKAGES,
 	package_dir=PACKAGE_DIR,
 	include_package_data=False,

defstream_rabbitmq-0.1.1/MANIFEST.in

@@ -1 +0,0 @@
-include VERSION

defstream_rabbitmq-0.1.1/VERSION

@@ -1 +0,0 @@
-0.1.1