ringo-task-queue 0.1.0.dev2__py3-none-win_amd64.whl → 0.1.0.dev4__py3-none-win_amd64.whl

{ringo_task_queue-0.1.0.dev2.dist-info → ringo_task_queue-0.1.0.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ringo-task-queue
-Version: 0.1.0.dev2
+Version: 0.1.0.dev4
 Summary: Python asyncio SDK for Ringo Task Queue with a bundled offline Go daemon
 Author: Ringo Task Queue contributors
 License-Expression: MIT
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
-Requires-Dist: grpcio-health-checking<2,>=1.71.0
+Requires-Dist: grpcio-health-checking!=1.82.*,<2,>=1.71.0
 Requires-Dist: grpcio-status<2,>=1.71.0
 Requires-Dist: grpcio<2,>=1.71.0
 Requires-Dist: protobuf<7,>=5.29.5
@@ -264,13 +264,62 @@ await worker.run()
 
 `run()` 一直运行到其他协程调用 `await worker.close()`，并且只能调用一次。常驻消费时用 `asyncio.create_task(worker.run())` 启动；已知有限批次（见下）直接 `await worker.run()`。
 
+### 三种并发模式、共享代理池和 pause/resume
+
+整数是固定并发，创建时至少为 1；运行后可以把目标改成 `0..2**31-1`：
+
+```python
+worker = queue.worker(handle, concurrency=8)
+run_task = asyncio.create_task(worker.run())
+await worker.set_concurrency(0)  # pause：不再派发，已有 handler 不取消
+await worker.set_concurrency(8)  # resume/resize
+```
+
+`ResourceConcurrency` 是同一进程/事件循环可由多个 queue/client 共享的总容量。容量是 admission permit，不是每个 Worker 的副本；缩容不会抢占已运行的 handler。
+
+```python
+from ringo_task_queue import ResourceConcurrency
+
+proxies = ResourceConcurrency(capacity=12)
+west = client.queue("west").worker(handle, concurrency=proxies, weight=1)
+east = client.queue("east").worker(handle, concurrency=proxies, weight=3)
+runs = [asyncio.create_task(w.run()) for w in (west, east)]
+
+await proxies.set_capacity(20)  # 例如健康代理数变化
+# 共享 controller 时不能调用 west.set_concurrency(...)
+
+await west.close()
+await east.close()
+await asyncio.gather(*runs)
+```
+
+持续有任务时，权重按平滑加权轮转长期接近 1:3；空闲成员的临时 probe 会在 250 ms 后撤回，因此容量会给活跃成员 work-conserving 使用。可手动暂停整组：`await proxies.set_capacity(0)`，恢复时再设置非零容量。
+
+`AdaptiveConcurrency` 使用 AIMD：当前容量个成功 ACK（且当时已饱和）后 `+1`，只有成功 NACK 且 `RetryTaskError(congestion=True)` 才按 `*0.5` 降低，始终限制在 `minimum..maximum`；普通异常、永久失败和 lease/传输丢失不改变它：
+
+```python
+from ringo_task_queue import AdaptiveConcurrency, RetryTaskError
+
+limits = AdaptiveConcurrency(initial=4, minimum=1, maximum=32)
+
+async def handle(task, ctx):
+    try:
+        await call_upstream(task.payload)
+    except RateLimitError as exc:
+        raise RetryTaskError(str(exc), delay=2, congestion=True) from exc
+
+worker = queue.worker(handle, concurrency=limits)
+```
+
+动态 controller 和运行中的 fixed resize 需要协议 minor 2；不改变 fixed 并发的 Worker 仍兼容旧 minor。controller 可以跨 queue/client 共享，但不能跨进程共享。
+
 Handler 映射：
 
 | 结果 | 动作 |
 |---|---|
 | 正常返回 | ACK / `SUCCEEDED` |
 | 普通异常 | NACK / 按策略重试 |
-| `RetryTaskError` | NACK，可覆盖本次延迟 |
+| `RetryTaskError` | NACK，可覆盖本次延迟；仅 `congestion=True` 且 NACK 被服务端接受时触发 Adaptive 的降速 |
 | `PermanentTaskError` | Reject / `DEAD` |
 | 取消 | 不发送终态，等待 lease 到期重投 |
 
@@ -421,7 +470,7 @@ except RingoError as exc:
 
 | 项目 | 默认值或限制 |
 |---|---|
-| 协议 | 1.1 |
+| 协议 | 1.2 |
 | schema | 3 |
 | lease | 60 秒 |
 | worker concurrency | 1 |
@@ -448,7 +497,7 @@ except RingoError as exc:
 
 ### `No matching distribution found`
 
-确认 Python 为 3.11+，对应平台 wheel 已上传；安装 `.dev0` 时使用 `--pre`。
+确认 Python 为 3.11+，对应平台 wheel 已上传；安装开发版本时使用 `--pre`。
 
 ### 找不到 daemon
 
@@ -466,34 +515,6 @@ except RingoError as exc:
 
 默认允许 handler 在 30 秒内完成。可以调整 `grace_period`，并让 handler 响应 cancellation 或 `ctx.cancelled`。
 
-## 维护者构建平台 wheel
-
-真实 daemon 不提交到源码树。必须先从同一源码版本生成并验证五平台 release manifest，再逐个平台构建 wheel：
-
-```shell
-go run ./tools/release build --out dist --version 0.1.0-dev --commit <revision> --date <RFC3339-UTC>
-go run ./tools/release verify --manifest dist/manifest.json
-```
-
-然后从 `sdk/python` 运行：
-
-```shell
-python tools/build_platform_wheel.py \
-  --binary ../../dist/ringo-task-queue-linux-amd64 \
-  --release-manifest ../../dist/manifest.json \
-  --platform linux-amd64 \
-  --output-dir ../../package-dist/python
-```
-
-分别构建 `windows-amd64`、`linux-amd64`、`linux-arm64`、`macos-amd64`、`macos-arm64`。构建会记录根 manifest 的 SHA-256 来源，完成后清理暂存二进制。上传前运行：
-
-```shell
-python tools/verify_wheel_set.py ../../package-dist/python
-python -m twine check ../../package-dist/python/*
-```
-
-没有经过完整五目标 manifest 暂存的 wheel 和 sdist 会被主动拒绝，避免发布不含 daemon 或平台集合不完整的包。
-
 ## 许可证
 
 MIT License。

ringo_task_queue-0.1.0.dev4.dist-info/RECORD

@@ -0,0 +1,19 @@
+ringo_task_queue/__init__.py,sha256=zihlmp-o3e9VemeH0TKw_ahdmjgm-ykv-dZ1YkOODF8,1501
+ringo_task_queue/_pb.py,sha256=gA8HMCx9ZXEMB-ca6me8CYXdRLLPzUXVIz63Q4bz75I,5683
+ringo_task_queue/_version.py,sha256=vf_6CBVg0fZ61HTF04mxqE3ZyIrcJDIY9rgVAf9N9Qs,642
+ringo_task_queue/binary.py,sha256=lJtFz_t5BuxDV4dMAqQDpP3mhTvJlnPBGnaiB0Z9D04,9526
+ringo_task_queue/client.py,sha256=1SM_DSJvVlfYm7Yrqmtyo0DMvE2qRGNXptRNLuJ4OPI,36071
+ringo_task_queue/concurrency.py,sha256=AxmtDa39xoda0TnvxNlLmZri1TTWCkS7VaRomAONwLU,19151
+ringo_task_queue/daemon.py,sha256=YS8otZpD9hqKeASb2S8ZWLCWzQj6-FYUb-grmYSnrIs,19849
+ringo_task_queue/errors.py,sha256=FQXkfz0SS-mFtY61b6f9HamPZUPWcuf-33AfB7B0rmo,4829
+ringo_task_queue/models.py,sha256=MEXh2JKgCbf3vo0EmnjJ_TscwabaW5Yd9i98LSPIrnk,11691
+ringo_task_queue/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ringo_task_queue/worker.py,sha256=Bv7vknxThqWAzsLjQeJyzjn6Qiw8yKNRq6rCIgvEXjQ,53618
+ringo_task_queue/_proto/ringo/v1/queue_pb2.py,sha256=knhuzUL_fMA12UstjDXXls0PvX9nJChdOKjYq3ro2yw,18598
+ringo_task_queue/_proto/ringo/v1/queue_pb2_grpc.py,sha256=WHG2a2EA18tMYkC_NNFTuac8E72mKk7IaV0BIQwa2gw,27617
+ringo_task_queue/bin/manifest.json,sha256=qENvp1ZOLJedA21x6UNIg-rFdllfLMxpz0Mg6V1bR4k,576
+ringo_task_queue/bin/ringo-task-queue-windows-amd64.exe,sha256=Ty1b7P6jdHKt6r40QGXdumuliLeuQtc7TwFML4HYC9E,22876672
+ringo_task_queue-0.1.0.dev4.dist-info/METADATA,sha256=ndIiIeTK48Eknt0D749Z16LkfjaFQ2Ve7OmMvbLlcUY,18204
+ringo_task_queue-0.1.0.dev4.dist-info/WHEEL,sha256=A7YmR1UrJozxyeLCzQFwQUdR7CRUwkFKasEDmnrjVxY,94
+ringo_task_queue-0.1.0.dev4.dist-info/licenses/LICENSE,sha256=yK3nnJz_bbOAPlcJqAooYcvecNJnBH9miT_X8Qrerv4,1086
+ringo_task_queue-0.1.0.dev4.dist-info/RECORD,,

{ringo_task_queue-0.1.0.dev2.dist-info → ringo_task_queue-0.1.0.dev4.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.32.3
+Generator: hatchling 1.32.4
 Root-Is-Purelib: false
 Tag: py3-none-win_amd64

ringo_task_queue-0.1.0.dev2.dist-info/RECORD

@@ -1,18 +0,0 @@
-ringo_task_queue/__init__.py,sha256=MUeo1atWuaoNITczk6hDs4zYLI18IEpkVBHOE3wGhFc,1381
-ringo_task_queue/_pb.py,sha256=gA8HMCx9ZXEMB-ca6me8CYXdRLLPzUXVIz63Q4bz75I,5683
-ringo_task_queue/_version.py,sha256=ZzMLs6sHjRJhsqQlzaUywRpm7l_Fnt6prJ6UH1e1vAY,446
-ringo_task_queue/binary.py,sha256=lJtFz_t5BuxDV4dMAqQDpP3mhTvJlnPBGnaiB0Z9D04,9526
-ringo_task_queue/client.py,sha256=c7tCI5q2P0EQc_7RZcofHQHewBPVXGwtiLmKk_KUCsI,35380
-ringo_task_queue/daemon.py,sha256=YS8otZpD9hqKeASb2S8ZWLCWzQj6-FYUb-grmYSnrIs,19849
-ringo_task_queue/errors.py,sha256=UCPl1GJSlHzvGPO5WOmkYwLBqZj8Aozlz7sChAXR8pw,4719
-ringo_task_queue/models.py,sha256=MEXh2JKgCbf3vo0EmnjJ_TscwabaW5Yd9i98LSPIrnk,11691
-ringo_task_queue/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ringo_task_queue/worker.py,sha256=lminZk8MQgOE2Gf6-8cNymaNb4iXpmtLERSaMxgMDqg,40317
-ringo_task_queue/_proto/ringo/v1/queue_pb2.py,sha256=EyddzrHyXbndhxHm_EMlzLXFVMJGQNZEWgV665NM6IQ,18691
-ringo_task_queue/_proto/ringo/v1/queue_pb2_grpc.py,sha256=b_F-9z6npDpHs3VdIJAhYfPKF6e3pJYSQTonripfWLA,28290
-ringo_task_queue/bin/manifest.json,sha256=VXBi2vZJbqz6Cn-nl8Tp0DO402tHIEjwCR5qm-WlNsc,576
-ringo_task_queue/bin/ringo-task-queue-windows-amd64.exe,sha256=rTg5fY_nD7RxL0OzLTNubruFUKVSyas3baXzeFaGVxo,22874624
-ringo_task_queue-0.1.0.dev2.dist-info/METADATA,sha256=jrL95c9BbnhlnFYpq682KHt2DQ76xGF7nCNo1FIxXhY,16957
-ringo_task_queue-0.1.0.dev2.dist-info/WHEEL,sha256=0nQjyt02uAQbhbYKWZzlDb_ZXUmJUwgypQJ-m16yWKo,94
-ringo_task_queue-0.1.0.dev2.dist-info/licenses/LICENSE,sha256=yK3nnJz_bbOAPlcJqAooYcvecNJnBH9miT_X8Qrerv4,1086
-ringo_task_queue-0.1.0.dev2.dist-info/RECORD,,