DefStream 0.1.13__tar.gz → 0.1.15__tar.gz

defstream-0.1.13/.github/ISSUE_TEMPLATE/feature_request.yml → defstream-0.1.15/.github/ISSUE_TEMPLATE/01.feature.yml

@@ -1,6 +1,9 @@
 name: 기능 제안
-description: DefStream에 추가하거나 개선할 기능을 제안합니다.
-title: "[기능 제안] "
+description: 추가하거나 개선할 기능을 제안합니다.
+labels:
+  - feature
+projects:
+  - yong5eon/7
 body:
   - type: markdown
     attributes:

defstream-0.1.13/.github/ISSUE_TEMPLATE/bug_report.yml → defstream-0.1.15/.github/ISSUE_TEMPLATE/02.bug.yml

@@ -1,6 +1,9 @@
 name: 버그/오류 제보
 description: 예상과 다르게 동작하거나 오류가 발생하는 문제를 제보합니다.
-title: "[버그] "
+labels:
+  - bug
+projects:
+  - yong5eon/7
 body:
   - type: markdown
     attributes:

defstream-0.1.15/.github/ISSUE_TEMPLATE/03.fix.yml

@@ -0,0 +1,57 @@
+name: 변경 제안
+description: 일반 변경이나 핫픽스의 목적과 범위를 정리합니다.
+labels:
+  - fix
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        일반 변경이나 긴급 수정이 필요한 핫픽스를 제안할 때 사용해 주세요.
+        재현 가능한 기존 결함은 버그/오류 제보 양식을 이용해 주세요.
+  - type: dropdown
+    id: change_type
+    attributes:
+      label: 변경 유형
+      description: 제안하는 변경의 성격을 선택해 주세요.
+      options:
+        - 일반 변경
+        - 핫픽스
+    validations:
+      required: true
+  - type: textarea
+    id: purpose
+    attributes:
+      label: 변경 목적
+      description: 왜 이 변경이 필요한지, 해결하려는 불편이나 상황을 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: proposed_changes
+    attributes:
+      label: 제안하는 변경 내용
+      description: 무엇을 어떻게 바꾸면 좋을지 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: 영향 범위
+      description: 영향을 받는 기능, 사용자, 호환성 또는 설정을 알고 있다면 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: hotfix_context
+    attributes:
+      label: 긴급 수정 정보
+      description: 핫픽스인 경우 긴급한 이유, 영향받는 버전 및 임시 대응 방법을 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: 완료 기준
+      description: 변경이 완료되었다고 판단할 수 있는 조건이나 검증 방법을 적어 주세요.
+    validations:
+      required: false

defstream-0.1.15/.github/ISSUE_TEMPLATE/04.task.yml

@@ -0,0 +1,40 @@
+name: 작업 제안
+description: 리소스 변경, 문서화 등 소스 코드 변경이 아닌 작업을 정리합니다.
+labels:
+  - task
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        리소스 변경, 문서 작성·정리 등 소스 코드를 변경하지 않는 작업에 사용해 주세요.
+        기능 추가, 버그 제보 또는 소스 코드 변경은 해당 이슈 양식을 이용해 주세요.
+  - type: textarea
+    id: purpose
+    attributes:
+      label: 작업 목적
+      description: 이 작업이 필요한 이유와 기대하는 효과를 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: 작업 내용 및 대상
+      description: 수행할 작업과 대상 리소스, 문서 또는 경로를 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: 완료 기준
+      description: 작업이 완료되었다고 판단할 수 있는 결과물이나 확인 방법을 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: 관련 자료 및 주의사항
+      description: 참고 링크, 관련 이슈, 사전 준비나 주의사항이 있다면 적어 주세요.
+    validations:
+      required: false

{defstream-0.1.13 → defstream-0.1.15}/.github/PULL_REQUEST_TEMPLATE.md

@@ -4,7 +4,7 @@
 
 ## 변경 유형
 
-- [ ] 버그 수정
+- [ ] 버그 수정 및 일반 변경, 핫픽스 처리
 - [ ] 기능 추가
 - [ ] 호환성에 영향을 주는 변경
 - [ ] 문서 또는 예제 변경

{defstream-0.1.13 → defstream-0.1.15}/.github/workflows/ci.yml

@@ -30,9 +30,7 @@ jobs:
       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 }}
+      test_required: ${{ steps.test_paths.outputs.required }}
     steps:
       - uses: actions/checkout@v7
         with:
@@ -42,6 +40,28 @@ jobs:
         uses: actions/setup-python@v7
         with:
           python-version: '3.13'
+      - name: Detect test-relevant changes
+        id: test_paths
+        run: |
+          python - <<'PY'
+          from json import loads
+          from os import environ
+          from pathlib import Path
+          from subprocess import check_output
+
+          required = True
+          if environ['GITHUB_EVENT_NAME'] == 'pull_request':
+              event = loads(Path(environ['GITHUB_EVENT_PATH']).read_text(encoding='utf-8'))
+              base = event['pull_request']['base']['sha']
+              changed = check_output([
+                  'git', 'diff', '--name-only', '--no-renames', '-z',
+                  f'{base}...{environ["GITHUB_SHA"]}', '--', 'samples/', 'src/', 'tests/', 'setup.py', '.github/workflows/ci.yml',
+              ])
+              required = bool(changed)
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'required={str(required).lower()}\n')
+          print(f'Test-relevant changes: {required}')
+          PY
       - name: Check complete push range and plan version
         id: changes
         env:
@@ -175,43 +195,6 @@ jobs:
           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:
@@ -224,6 +207,7 @@ jobs:
   test:
     name: Test Python ${{ matrix.python }}
     needs: changes
+    if: needs.changes.outputs.test_required == 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 25
     strategy:
@@ -231,7 +215,7 @@ jobs:
       matrix:
         python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
     env:
-      PROJECT: ${{ github.event.repository.name }}
+      PROJECT: DefStream
       DEFSTREAM_RABBITMQ_TESTS: '1'
       DEFSTREAM_REDIS_TESTS: '1'
     services:
@@ -261,30 +245,11 @@ jobs:
       - 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 }}
+          ref: ${{ github.sha }}
           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:
@@ -305,7 +270,7 @@ jobs:
           from re import fullmatch
 
           project = environ['PROJECT']
-          if project not in ('DefStream', 'DefStream-RabbitMQ', 'DefStream-Redis'):
+          if project != 'DefStream':
               raise ValueError(f'Unexpected project: {project}')
           if environ['RELEASE_BUILD'] != 'true':
               print('Test-only build: using the existing Git-derived development version.')
@@ -329,23 +294,17 @@ jobs:
           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
+          mkdir -p dist
+          if [ "$RELEASE_BUILD" = "true" ]; then
+            if [ "$NEW_VERSION" = "true" ]; then
+              SETUPTOOLS_SCM_PRETEND_VERSION="$RELEASE_VERSION" python -m build --outdir "$GITHUB_WORKSPACE/dist" packages/DefStream
             else
-              python -m build --outdir "$GITHUB_WORKSPACE/dependency-wheels" "packages/$name"
+              SETUPTOOLS_SCM_PRETEND_VERSION="$RELEASE_VERSION" python -m build --wheel --outdir "$GITHUB_WORKSPACE/dist" packages/DefStream
             fi
-          done
+            python -m wheel tags --build "$WHEEL_BUILD" --remove dist/*.whl
+          else
+            python -m build --outdir "$GITHUB_WORKSPACE/dist" packages/DefStream
+          fi
           python -m twine check --strict dist/*
 
       - name: Normalize source archive timestamps
@@ -375,27 +334,54 @@ jobs:
                   path.write_bytes(buffer.getvalue())
           PY
 
+      - name: Verify optional client installations
+        run: |
+          python - <<'PY'
+          from os import environ
+          from pathlib import Path
+          from subprocess import run
+          from venv import EnvBuilder
+
+          wheel, = Path('dist').glob('*.whl')
+          for extra, modules in (
+              ('', ('DefStream', 'DefStream.Worker', 'DefStream.Inspector')),
+              ('RabbitMQ', ('DefStream.Broker.Implements.RabbitMQ',)),
+              ('Redis', ('DefStream.Broker.Implements.Redis',)),
+          ):
+              environment = Path(environ['RUNNER_TEMP'], 'optional-' + (extra or 'core'))
+              EnvBuilder(with_pip=True).create(environment)
+              python = environment / 'bin' / 'python'
+              package = str(wheel.resolve()) + (f'[{extra}]' if extra else '')
+              run([str(python), '-m', 'pip', 'install', package], check=True)
+              code = (
+                  'from importlib import import_module; from importlib.util import find_spec; '
+                  f'assert (find_spec("pika") is not None) == {extra == "RabbitMQ"}; '
+                  f'assert (find_spec("redis") is not None) == {extra == "Redis"}; '
+                  f'[import_module(name) for name in {modules!r}]'
+              )
+              run([str(python), '-I', '-c', code], check=True)
+              run([str(python), '-m', 'pip', 'check'], check=True)
+          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 install "$(echo dist/*.whl)[RabbitMQ,Redis]"
           "$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
+            -s "$GITHUB_WORKSPACE/packages/DefStream/tests" -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
+        run: node --test packages/DefStream/tests/test_dashboard_ui.cjs
 
       - name: Preserve verified release distributions
         if: needs.changes.outputs.release == 'true' && matrix.python == '3.13'

{defstream-0.1.13 → defstream-0.1.15}/.gitignore

@@ -24,10 +24,6 @@ dist/
 *.egg
 .Python
 
-# Local broker adapter links
-/src/Broker/Implements/*
-!/src/Broker/Implements/__init__.py
-
 # Operating system files
 .DS_Store
 Thumbs.db