DefStream 0.1.16__tar.gz → 0.1.18__tar.gz

{defstream-0.1.16 → defstream-0.1.18}/.github/ISSUE_TEMPLATE/01.feature.yml

@@ -2,8 +2,6 @@ name: 기능 제안
 description: 추가하거나 개선할 기능을 제안합니다.
 labels:
   - feature
-projects:
-  - yong5eon/7
 body:
   - type: markdown
     attributes:

{defstream-0.1.16 → defstream-0.1.18}/.github/ISSUE_TEMPLATE/02.bug.yml

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

{defstream-0.1.16 → defstream-0.1.18}/.github/ISSUE_TEMPLATE/03.fix.yml

@@ -2,8 +2,6 @@ name: 변경 제안
 description: 일반 변경이나 핫픽스의 목적과 범위를 정리합니다.
 labels:
   - fix
-projects:
-  - yong5eon/7
 body:
   - type: markdown
     attributes:

{defstream-0.1.16 → defstream-0.1.18}/.github/ISSUE_TEMPLATE/04.task.yml

@@ -2,8 +2,6 @@ name: 작업 제안
 description: 리소스 변경, 문서화 등 소스 코드 변경이 아닌 작업을 정리합니다.
 labels:
   - task
-projects:
-  - yong5eon/7
 body:
   - type: markdown
     attributes:

{defstream-0.1.16 → defstream-0.1.18}/.github/workflows/ci.yml

@@ -2,7 +2,6 @@ name: CI
 
 on:
   pull_request:
-    branches: [master]
   push:
     branches: [master]
 
@@ -18,7 +17,7 @@ concurrency:
 
 jobs:
   changes:
-    name: Plan release version
+    name: Prepare CI and master release metadata
     permissions:
       contents: read
       pull-requests: read
@@ -30,7 +29,6 @@ jobs:
       build: ${{ steps.changes.outputs.build }}
       new_version: ${{ steps.changes.outputs.new_version }}
       tag: ${{ steps.changes.outputs.tag }}
-      test_required: ${{ steps.test_paths.outputs.required }}
     steps:
       - uses: actions/checkout@v7
         with:
@@ -40,49 +38,22 @@ 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
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master'
         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'}
@@ -112,8 +83,6 @@ jobs:
           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:
@@ -125,12 +94,12 @@ jobs:
           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'release=true\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
+      - name: Collect branch changelog for release
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master'
         env:
           GH_TOKEN: ${{ github.token }}
           BEFORE: ${{ github.event.before }}
@@ -144,25 +113,20 @@ jobs:
           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'
+          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')
           if environ['NEW_VERSION'] == 'false':
               tag = environ['RELEASE_TAG']
               release = loads(check_output([
@@ -172,7 +136,7 @@ jobs:
                   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:
+          elif not pulls:
               before = environ['BEFORE']
               if not before:
                   raise ValueError('Missing push base commit')
@@ -181,7 +145,8 @@ jobs:
               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'
+              branch = pulls[0]['head']['ref']
+              path = f'issues/{branch}/CHANGELOG.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}')
@@ -192,10 +157,9 @@ jobs:
           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: Preserve customer release notes
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master'
         uses: actions/upload-artifact@v7
         with:
           name: release-notes
@@ -207,7 +171,6 @@ jobs:
   test:
     name: Test Python ${{ matrix.python }}
     needs: changes
-    if: needs.changes.outputs.test_required == 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 25
     strategy:
@@ -384,7 +347,7 @@ jobs:
         run: node --test packages/DefStream/tests/test_status_ui.cjs
 
       - name: Preserve verified release distributions
-        if: needs.changes.outputs.release == 'true' && matrix.python == '3.13'
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master' && needs.changes.outputs.release == 'true' && matrix.python == '3.13'
         uses: actions/upload-artifact@v7
         with:
           name: distributions

defstream-0.1.18/DefStream.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: DefStream
+Version: 0.1.18
+Summary: Synchronous message processing with pluggable broker adapters
+Home-page: https://github.com/yong5eon/DefStream
+Author: Heo Yongseon
+Project-URL: Source, https://github.com/yong5eon/DefStream
+Project-URL: Issues, https://github.com/yong5eon/DefStream/issues
+Project-URL: Releases, https://github.com/yong5eon/DefStream/releases
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: rabbitmq
+Requires-Dist: pika>=1.3.2; extra == "rabbitmq"
+Provides-Extra: redis
+Requires-Dist: redis>=5.1.1; extra == "redis"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-python
+Dynamic: summary
+
+# DefStream
+
+Synchronous event/message processing with pluggable broker adapters
+
+DefStream processes broker messages with ordinary Python task methods and can run them in thread or process pools. It requires Python 3.9 or later.
+
+## Installation
+
+Install the client extra for the broker you use. A broker server must be available separately.
+
+```shell
+python -m pip install "DefStream[RabbitMQ]"
+```
+
+For Redis Streams, install `DefStream[Redis]`. To install both clients, use `DefStream[RabbitMQ,Redis]`. The plain `DefStream` installation includes neither broker client.
+
+## Quick start
+
+The following worker listens to a local RabbitMQ server at `127.0.0.1:5672`. The example credentials are for local development only.
+
+```python
+from signal import SIGINT, signal
+
+from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection, Reject, Subscription
+from DefStream.Worker import Run, ThreadPool, Worker, WorkerSetup, declare
+
+
+class Add(
+  Run,
+  parameters=Subscription(queue='example.add', error='example.add.error'),
+  on_error=Reject(),
+):
+  def run(self, a: int, b: int):
+    print(a + b)
+    return a + b
+
+
+class Prepare(WorkerSetup):
+  def __call__(self, worker: Worker) -> None:
+    for task in worker.tasks:
+      declare(task=task, broker=worker.broker)
+
+
+if __name__ == '__main__':
+  worker = Worker(
+    Connection(Configuration(host='127.0.0.1', port=5672, username='guest', password='guest')),
+    ThreadPool(4),
+    setups=Prepare(),
+  )
+  worker.add(Add)
+  signal(SIGINT, lambda *_: worker.stop())
+  worker.run()
+```
+
+Run the script after starting RabbitMQ. The worker declares its task queue and waits for messages. Store production credentials outside source code.
+
+## License
+
+See the `LICENSE` file included with the source distribution for the license terms.

{defstream-0.1.16 → defstream-0.1.18}/DefStream.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@
 LICENSE
 README.en.md
 README.md
+README.setup.md
 setup.py
 .github/PULL_REQUEST_TEMPLATE.md
 .github/ISSUE_TEMPLATE/01.feature.yml
@@ -15,6 +16,25 @@ DefStream.egg-info/SOURCES.txt
 DefStream.egg-info/dependency_links.txt
 DefStream.egg-info/requires.txt
 DefStream.egg-info/top_level.txt
+docs/Contracts.en.md
+docs/Contracts.md
+docs/GettingStarted.en.md
+docs/GettingStarted.md
+docs/LifecycleHooks.en.md
+docs/LifecycleHooks.md
+docs/Operations.en.md
+docs/Operations.md
+docs/README.en.md
+docs/README.md
+docs/RabbitMQ.en.md
+docs/RabbitMQ.md
+docs/Redis.en.md
+docs/Redis.md
+docs/Tasks.en.md
+docs/Tasks.md
+instructions/CODE.instructions.md
+instructions/DOCS.instructions.md
+instructions/README.instructions.md
 issues/bug/16/IMPLEMENTS.md
 issues/bug/16/ISSUE.md
 issues/bug/16/README.md
@@ -45,16 +65,53 @@ issues/fix/25/ISSUE.md
 issues/fix/25/README.md
 issues/fix/25/REQUIREMENTS.md
 issues/fix/25/TASK.md
+issues/fix/26/IMPLEMENTS.md
+issues/fix/26/ISSUE.md
+issues/fix/26/README.md
+issues/fix/26/REQUIREMENTS.md
+issues/fix/29/ISSUE.md
+issues/fix/29/README.md
+issues/fix/29/REQUIREMENTS.md
+issues/fix/29/TASK.md
 issues/fix/3/IMPLEMENTS.md
 issues/fix/3/README.md
 issues/fix/3/REQUIREMENTS.md
 issues/fix/3/ci.refs.json
+issues/fix/41/CHANGELOG.md
+issues/fix/41/IMPLEMENTS.md
+issues/fix/41/PLAN.md
+issues/fix/41/README.md
+issues/fix/41/REQUIREMENTS.md
+issues/fix/41/TASKS.md
+issues/fix/41/implements/1793257519898.md
+issues/fix/41/implements/1793257826069.md
+issues/fix/41/tasks/1793256929057.md
+issues/fix/41/tasks/1793256990072.md
+issues/fix/41/tasks/1793257216492.md
+issues/fix/41/tasks/1793257519899.md
+issues/fix/41/tasks/1793257826068.md
 issues/fix/6/IMPLEMENTS.md
 issues/fix/6/README.md
 issues/fix/6/REQUIREMENTS.md
 issues/task/18/IMPLEMENTS.md
 issues/task/18/README.md
 issues/task/18/REQUIREMENTS.md
+issues/task/32/IMPLEMENTS.md
+issues/task/32/ISSUE.md
+issues/task/32/PLAN.md
+issues/task/32/README.md
+issues/task/32/REQUIREMENTS.md
+issues/task/32/TASK.md
+issues/task/34/CHANGELOG.md
+issues/task/34/IMPLEMENTS.md
+issues/task/34/PLAN.md
+issues/task/34/README.md
+issues/task/34/REQUIREMENTS.md
+issues/task/36/CHANGELOG.md
+issues/task/36/IMPLEMENTS.md
+issues/task/36/PLAN.md
+issues/task/36/README.md
+issues/task/36/REQUIREMENTS.md
 samples/Broker/Sample.py
 samples/Broker/RabbitMQ/Sample.RPC.py
 samples/Broker/RabbitMQ/Sample.Stream.py
@@ -150,15 +207,12 @@ tests/test_rabbitmq_broker_methods.py
 tests/test_rabbitmq_integration.py
 tests/test_rabbitmq_logging.py
 tests/test_rabbitmq_priorities.py
-tests/test_rabbitmq_release_workflow.py
 tests/test_rabbitmq_rpc.py
 tests/test_rabbitmq_rpc_integration.py
 tests/test_rabbitmq_worker.py
 tests/test_redis.py
 tests/test_redis_integration.py
 tests/test_redis_logging.py
-tests/test_redis_release_workflow.py
-tests/test_release_workflow.py
 tests/test_runner_hooks.py
 tests/test_specifications.py
 tests/test_status.py

defstream-0.1.18/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: DefStream
+Version: 0.1.18
+Summary: Synchronous message processing with pluggable broker adapters
+Home-page: https://github.com/yong5eon/DefStream
+Author: Heo Yongseon
+Project-URL: Source, https://github.com/yong5eon/DefStream
+Project-URL: Issues, https://github.com/yong5eon/DefStream/issues
+Project-URL: Releases, https://github.com/yong5eon/DefStream/releases
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: rabbitmq
+Requires-Dist: pika>=1.3.2; extra == "rabbitmq"
+Provides-Extra: redis
+Requires-Dist: redis>=5.1.1; extra == "redis"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-python
+Dynamic: summary
+
+# DefStream
+
+Synchronous event/message processing with pluggable broker adapters
+
+DefStream processes broker messages with ordinary Python task methods and can run them in thread or process pools. It requires Python 3.9 or later.
+
+## Installation
+
+Install the client extra for the broker you use. A broker server must be available separately.
+
+```shell
+python -m pip install "DefStream[RabbitMQ]"
+```
+
+For Redis Streams, install `DefStream[Redis]`. To install both clients, use `DefStream[RabbitMQ,Redis]`. The plain `DefStream` installation includes neither broker client.
+
+## Quick start
+
+The following worker listens to a local RabbitMQ server at `127.0.0.1:5672`. The example credentials are for local development only.
+
+```python
+from signal import SIGINT, signal
+
+from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection, Reject, Subscription
+from DefStream.Worker import Run, ThreadPool, Worker, WorkerSetup, declare
+
+
+class Add(
+  Run,
+  parameters=Subscription(queue='example.add', error='example.add.error'),
+  on_error=Reject(),
+):
+  def run(self, a: int, b: int):
+    print(a + b)
+    return a + b
+
+
+class Prepare(WorkerSetup):
+  def __call__(self, worker: Worker) -> None:
+    for task in worker.tasks:
+      declare(task=task, broker=worker.broker)
+
+
+if __name__ == '__main__':
+  worker = Worker(
+    Connection(Configuration(host='127.0.0.1', port=5672, username='guest', password='guest')),
+    ThreadPool(4),
+    setups=Prepare(),
+  )
+  worker.add(Add)
+  signal(SIGINT, lambda *_: worker.stop())
+  worker.run()
+```
+
+Run the script after starting RabbitMQ. The worker declares its task queue and waits for messages. Store production credentials outside source code.
+
+## License
+
+See the `LICENSE` file included with the source distribution for the license terms.

defstream-0.1.18/README.en.md

@@ -0,0 +1,73 @@
+# DefStream
+
+Synchronous event/message processing with pluggable broker adapters
+
+**Just def.**<br>
+**Let workers do the work.**<br>
+**You don't need to await this.**
+
+[한국어](./README.md) | **English**
+
+DefStream is a synchronous library for processing broker messages with ordinary Python methods. Configure task execution, acknowledgements, failure policies, and thread or process pools without `async` / `await`.
+
+- RabbitMQ and Redis Streams broker adapters
+- One-way task publishing and synchronous RabbitMQ RPC
+- Request/reply contract validation, health checks, and operational Inspector tools
+
+## Requirements and installation
+
+Requires Python 3.9 or later. Install the client extra for the broker you use, and provide the broker server separately.
+
+```shell
+python -m pip install "DefStream[RabbitMQ]"
+python -m pip install "DefStream[Redis]"
+```
+
+To install both adapters, use `python -m pip install "DefStream[RabbitMQ,Redis]"`. To install the core without broker clients, use `python -m pip install DefStream`.
+
+## Quick start
+
+This example uses a local RabbitMQ server at `127.0.0.1:5672`. The credentials are for local development only; use dedicated credentials in production.
+
+```python
+from signal import SIGINT, signal
+
+from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection, Reject, Subscription
+from DefStream.Worker import Run, ThreadPool, Worker, WorkerSetup, declare
+
+
+class Add(
+  Run,
+  parameters=Subscription(queue='example.add', error='example.add.error'),
+  on_error=Reject(),
+):
+  def run(self, a: int, b: int):
+    print(a + b)
+    return a + b
+
+
+class Prepare(WorkerSetup):
+  def __call__(self, worker: Worker) -> None:
+    for task in worker.tasks:
+      declare(task=task, broker=worker.broker)
+
+
+if __name__ == '__main__':
+  worker = Worker(
+    Connection(Configuration(host='127.0.0.1', port=5672, username='guest', password='guest')),
+    ThreadPool(4),
+    setups=Prepare(),
+  )
+  worker.add(Add)
+  signal(SIGINT, lambda *_: worker.stop())
+  worker.run()
+```
+
+The Worker waits for tasks on the `example.add` queue. See the [detailed guide](./docs/README.en.md) for publishing tasks, declaring queues, RPC, and broker-specific configuration.
+
+## Documentation and releases
+
+- [Detailed guide (English)](./docs/README.en.md)
+- [Releases and change history](https://github.com/yong5eon/DefStream/releases)
+
+DefStream is licensed under GNU GPL v3. See the repository's `LICENSE` file for the terms.

defstream-0.1.18/README.md

@@ -0,0 +1,73 @@
+# DefStream
+
+Synchronous event/message processing with pluggable broker adapters
+
+**Just def.**<br>
+**Let workers do the work.**<br>
+**You don't need to await this.**
+
+**한국어** | [English](./README.en.md)
+
+DefStream은 메시지 브로커에서 받은 작업을 일반 Python 메서드로 처리하는 동기식 라이브러리입니다. `async` / `await` 없이 작업 실행, ACK와 실패 정책, 스레드·프로세스 풀을 구성할 수 있습니다.
+
+- RabbitMQ와 Redis Streams 브로커 어댑터
+- 단방향 작업 발행과 RabbitMQ 동기 RPC
+- 요청·응답 계약 검증, 상태 확인과 운영용 Inspector
+
+## 요구 사항 및 설치
+
+Python 3.9 이상이 필요합니다. 사용할 브로커의 클라이언트 extra를 설치하고, 별도로 브로커 서버를 준비하세요.
+
+```shell
+python -m pip install "DefStream[RabbitMQ]"
+python -m pip install "DefStream[Redis]"
+```
+
+두 어댑터가 모두 필요하면 `python -m pip install "DefStream[RabbitMQ,Redis]"`를 사용하세요. 브로커 클라이언트 없이 코어만 설치하려면 `python -m pip install DefStream`을 사용합니다.
+
+## 빠르게 시작하기
+
+다음 예제는 로컬 RabbitMQ(`127.0.0.1:5672`)를 사용합니다. 사용자 이름과 암호는 로컬 개발용 예시이며 운영 환경에서는 전용 자격 증명을 사용하세요.
+
+```python
+from signal import SIGINT, signal
+
+from DefStream.Broker.Implements.RabbitMQ import Configuration, Connection, Reject, Subscription
+from DefStream.Worker import Run, ThreadPool, Worker, WorkerSetup, declare
+
+
+class Add(
+  Run,
+  parameters=Subscription(queue='example.add', error='example.add.error'),
+  on_error=Reject(),
+):
+  def run(self, a: int, b: int):
+    print(a + b)
+    return a + b
+
+
+class Prepare(WorkerSetup):
+  def __call__(self, worker: Worker) -> None:
+    for task in worker.tasks:
+      declare(task=task, broker=worker.broker)
+
+
+if __name__ == '__main__':
+  worker = Worker(
+    Connection(Configuration(host='127.0.0.1', port=5672, username='guest', password='guest')),
+    ThreadPool(4),
+    setups=Prepare(),
+  )
+  worker.add(Add)
+  signal(SIGINT, lambda *_: worker.stop())
+  worker.run()
+```
+
+Worker는 `example.add` 큐에서 작업을 기다립니다. 작업 발행, 큐 선언, RPC 및 브로커별 설정은 [상세 매뉴얼](./docs/README.md)에서 확인하세요.
+
+## 문서와 릴리즈
+
+- [상세 매뉴얼 (한국어)](./docs/README.md)
+- [릴리즈와 변경 내역](https://github.com/yong5eon/DefStream/releases)
+
+DefStream은 GNU GPL v3 라이선스를 사용합니다. 자세한 조건은 저장소의 `LICENSE` 파일을 확인하세요.