DefStream-Redis 0.1.2.4__tar.gz → 0.1.3__tar.gz

defstream_redis-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_redis-0.1.2.4 → defstream_redis-0.1.3/DefStream_Redis.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream-Redis
-Version: 0.1.2.4
+Version: 0.1.3
 Summary: Redis Streams broker adapter for DefStream
 Home-page: https://github.com/yong5eon/DefStream-Redis
 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: redis>=5.1.1
 Dynamic: author
 Dynamic: classifier
@@ -38,6 +38,16 @@ DefStream에서 Redis Streams를 사용할 수 있게 해주는 브로커 어댑
 DefStream Worker에 연결해 작업을 병렬 처리할 수 있습니다.
 Redis Pub/Sub이나 List 기반 큐가 아니며, redis-py를 사용합니다.
 
+## 릴리즈 버전과 재빌드
+
+- 공개 버전은 `MAJOR.MINOR.PATCH`이며, Python 소스(`src/**/*.py`) 또는 패키징 설정(`setup.py`, `setup.cfg`, `pyproject.toml`, `MANIFEST.in`) 변경 시 PATCH가 증가합니다.
+- CI·문서·비 Python 리소스만 변경되면 공개 버전을 유지하고 wheel의 빌드 번호만 증가합니다. 예: `defstream_redis-0.1.5-42-py3-none-any.whl`의 패키지 버전은 `0.1.5`입니다.
+- 기존 4자리 버전 또는 post 릴리즈에서 전환할 때는 버전 역행을 막기 위해 PATCH를 한 번 증가시킵니다.
+- master 직접 push도 테스트 후 배포하며, 커밋 목록을 릴리즈 노트로 사용합니다. PR은 기존 `issues/<브랜치>/README.md` 검증을 유지합니다.
+- 새 공개 버전은 wheel과 소스 배포본을 게시합니다. 동일 버전 재빌드는 새 wheel만 추가하고, 기존 PyPI 파일·Git 태그는 변경하지 않으며 GitHub Release에 빌드 기록을 추가합니다.
+- 이미 설치된 동일 버전은 `pip install --upgrade`만으로 새 빌드로 교체되지 않을 수 있습니다. 필요한 경우 새 wheel을 지정해 `--force-reinstall`로 설치하세요.
+- 실행 리소스 변경도 같은 버전으로 재빌드되므로, 소스 배포본에는 이전 리소스가 남습니다. 사용자에게 구분 가능한 업데이트나 새 소스 배포본이 필요하면 공개 버전 증가가 필요합니다.
+
 ## 설치
 
 Python **3.9 이상**, Redis **6.2 이상**이 필요합니다.

{defstream_redis-0.1.2.4 → defstream_redis-0.1.3}/DefStream_Redis.egg-info/SOURCES.txt

@@ -9,6 +9,9 @@ DefStream_Redis.egg-info/SOURCES.txt
 DefStream_Redis.egg-info/dependency_links.txt
 DefStream_Redis.egg-info/requires.txt
 DefStream_Redis.egg-info/top_level.txt
+issues/fix/1/IMPLEMENTS.md
+issues/fix/1/README.md
+issues/fix/1/REQUIREMENTS.md
 sample/Sample.Stream.py
 sample/Sample.py
 src/Configuration.py
@@ -20,4 +23,5 @@ src/Serializer.py
 src/Subscription.py
 src/__init__.py
 test/test_redis.py
-test/test_redis_integration.py
+test/test_redis_integration.py
+test/test_release_workflow.py

defstream_redis-0.1.3/DefStream_Redis.egg-info/requires.txt

@@ -0,0 +1,2 @@
+DefStream>=0.1.5
+redis>=5.1.1