dotask 0.3.0__tar.gz → 0.3.2__tar.gz

dotask-0.3.2/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: dotask
+Version: 0.3.2
+Summary: 发布订阅注解方式
+Home-page: https://gitee.com/d-yz/task-manager
+Author: dyz
+Author-email: 837701454@qq.com
+Keywords: 发布订阅,注解,dotask
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+## 版本说明
+### 0.1.0
+- 在方法上添加@task就可以直接开启一个线程执行任务
+- 常用参数：
+  - 生产者: `role="producer",topic="自定义"`
+  - 消费者: `role="consumer",subscribe="自定义",publish_after="自定义"`
+- 说明:
+  - `role`: 用于区分上下游 `producer/consumer`
+  - `topic`: 发布的主题
+  - `subscribe`: 对哪些主题感兴趣
+  - `publish_after`: 消费完后继续发布新主题
+- 特别的：方法的返回值可以进行传递,若没有返回值则不会发布新主题（只针对消费者和消费者之间）
+### 0.2.x
+1. dotask暴露`topic_manager`=>可以更好的管理生产消费者 
+2. 迁移`logger`至`util`包下
+3. 添加本地调用shell工具函数->可以很好的适配@task消费者
+   1. `max_concurrent`:控制并发执行的shell数量
+   2. 引入`dotask.Shell` 调用`Shell(max_concurrent=?).local_shell_execute(cmd,callback)`来使用
+### 0.3.x
+1. 添加令牌桶,通过`from dotask.util import TokenBucket`使用,可以更好的限制生产消费速率
+   - 参数说明
+     - TokenBucket(capacity=1, rate=0),capacity:令牌桶容量,rate:每秒生成速率
+     - get_token(block=True),block:决定令牌桶无令牌时是阻塞还是返回false
+2. `topic_manager`内部维护`unfinished_tasks`队列，记录所有消费失败的数据及其异常
+3. 添加定时器`Timer`,可以配合`unfinished_tasks`再次处理未消费完成的数据
+
+## 快速开始
+### 安装
+`pip install dotask`
+### 示例
+1. 简单的生产发布模式
+
+```
+from dotask import task  
+from dotask.util import logger  
+import random  
+  
+if __name__ == '__main__':  
+  
+    @task(role="producer",topic="scan")  
+    def a():  
+        return random.randint(1,10)  
+  
+  
+    @task(role="consumer",subscribe="scan",publish_after="sayHi")  
+    def b(data):  
+        if data >5:  
+            return data  
+        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")  
+  
+    @task(role="consumer",subscribe="sayHi")  
+    def c(data):  
+        logger.debug(f"c触发")  
+        logger.info(f"消费:{data}")
+//=====================================================================
+2026-02-08 17:30:37 - INFO - 发布主题-[scan]:5
+2026-02-08 17:30:37 - WARNING - 本次生成数字:5,不会继续发布sayHi主题
+2026-02-08 17:30:38 - INFO - 发布主题-[scan]:8
+2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:8
+2026-02-08 17:30:38 - DEBUG - c触发
+2026-02-08 17:30:38 - INFO - 消费:8
+2026-02-08 17:30:38 - INFO - 发布主题-[scan]:6
+2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:6
+2026-02-08 17:30:38 - DEBUG - c触发
+2026-02-08 17:30:38 - INFO - 消费:6
+//======================================================================
+```
+
+2. 令牌桶+定时器使用
+```
+from dotask import task,topic_manager
+from dotask.util import logger,TokenBucket,Timer
+import random
+
+token_bucket = TokenBucket(capacity=1, rate=1)
+
+def error_inspect():
+    logger.warning(f"未完成任务:{topic_manager.unfinished_tasks.qsize()}")
+
+    item = topic_manager.unfinished_tasks.get()
+    logger.warning(f"其一:{item}")
+    logger.warning(f"重新发布失败数据,{item.get("unfinished_data")}")
+    topic_manager.publish(item.get("occurred"),item.get("unfinished_data"))
+
+if __name__ == '__main__':
+
+    Timer(interval=2,task=error_inspect).start()
+
+    @task(role="producer",topic="scan")
+    def a():
+        if token_bucket.get_token(block=True):
+            return random.randint(1,10)
+        else:
+            logger.warning("令牌桶无可用令牌,本次生成数据失败")
+            return -1
+
+
+    @task(role="consumer",subscribe="scan",publish_after="sayHi")
+    def b(data):
+        if data >5:
+            return data
+        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")
+
+    @task(role="consumer",subscribe="sayHi")
+    def c(data):
+        logger.debug(f"c触发,接收数据{data}")
+        raise Exception("处理失败")
+//===========================================================================
+2026-02-11 05:33:49 - INFO - Timer started,runs every 2 seconds
+2026-02-11 05:33:49 - INFO - publish topic-[scan]:1
+2026-02-11 05:33:49 - WARNING - 本次生成数字:1,不会继续发布sayHi主题
+2026-02-11 05:33:50 - INFO - publish topic-[scan]:3
+2026-02-11 05:33:50 - WARNING - 本次生成数字:3,不会继续发布sayHi主题
+2026-02-11 05:33:50 - INFO - publish topic-[scan]:1
+2026-02-11 05:33:50 - WARNING - 本次生成数字:1,不会继续发布sayHi主题
+2026-02-11 05:33:51 - WARNING - 未完成任务:0
+2026-02-11 05:33:51 - INFO - publish topic-[scan]:8
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:8
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据8
+2026-02-11 05:33:51 - ERROR - Consumer [None] failed to process message: 处理失败
+2026-02-11 05:33:51 - WARNING - 其一:{'unfinished_data': 8, 'occurred': 'sayHi', 'error': Exception('处理失败')}
+2026-02-11 05:33:51 - WARNING - 重新发布失败数据,8
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:8
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据8
+2026-02-11 05:33:51 - ERROR - Consumer [None] failed to process message: 处理失败
+2026-02-11 05:33:51 - INFO - publish topic-[scan]:7
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:7
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据7
+//==============================================================================
+```

dotask-0.3.2/README.md

@@ -0,0 +1,130 @@
+## 版本说明
+### 0.1.0
+- 在方法上添加@task就可以直接开启一个线程执行任务
+- 常用参数：
+  - 生产者: `role="producer",topic="自定义"`
+  - 消费者: `role="consumer",subscribe="自定义",publish_after="自定义"`
+- 说明:
+  - `role`: 用于区分上下游 `producer/consumer`
+  - `topic`: 发布的主题
+  - `subscribe`: 对哪些主题感兴趣
+  - `publish_after`: 消费完后继续发布新主题
+- 特别的：方法的返回值可以进行传递,若没有返回值则不会发布新主题（只针对消费者和消费者之间）
+### 0.2.x
+1. dotask暴露`topic_manager`=>可以更好的管理生产消费者 
+2. 迁移`logger`至`util`包下
+3. 添加本地调用shell工具函数->可以很好的适配@task消费者
+   1. `max_concurrent`:控制并发执行的shell数量
+   2. 引入`dotask.Shell` 调用`Shell(max_concurrent=?).local_shell_execute(cmd,callback)`来使用
+### 0.3.x
+1. 添加令牌桶,通过`from dotask.util import TokenBucket`使用,可以更好的限制生产消费速率
+   - 参数说明
+     - TokenBucket(capacity=1, rate=0),capacity:令牌桶容量,rate:每秒生成速率
+     - get_token(block=True),block:决定令牌桶无令牌时是阻塞还是返回false
+2. `topic_manager`内部维护`unfinished_tasks`队列，记录所有消费失败的数据及其异常
+3. 添加定时器`Timer`,可以配合`unfinished_tasks`再次处理未消费完成的数据
+
+## 快速开始
+### 安装
+`pip install dotask`
+### 示例
+1. 简单的生产发布模式
+
+```
+from dotask import task  
+from dotask.util import logger  
+import random  
+  
+if __name__ == '__main__':  
+  
+    @task(role="producer",topic="scan")  
+    def a():  
+        return random.randint(1,10)  
+  
+  
+    @task(role="consumer",subscribe="scan",publish_after="sayHi")  
+    def b(data):  
+        if data >5:  
+            return data  
+        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")  
+  
+    @task(role="consumer",subscribe="sayHi")  
+    def c(data):  
+        logger.debug(f"c触发")  
+        logger.info(f"消费:{data}")
+//=====================================================================
+2026-02-08 17:30:37 - INFO - 发布主题-[scan]:5
+2026-02-08 17:30:37 - WARNING - 本次生成数字:5,不会继续发布sayHi主题
+2026-02-08 17:30:38 - INFO - 发布主题-[scan]:8
+2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:8
+2026-02-08 17:30:38 - DEBUG - c触发
+2026-02-08 17:30:38 - INFO - 消费:8
+2026-02-08 17:30:38 - INFO - 发布主题-[scan]:6
+2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:6
+2026-02-08 17:30:38 - DEBUG - c触发
+2026-02-08 17:30:38 - INFO - 消费:6
+//======================================================================
+```
+
+2. 令牌桶+定时器使用
+```
+from dotask import task,topic_manager
+from dotask.util import logger,TokenBucket,Timer
+import random
+
+token_bucket = TokenBucket(capacity=1, rate=1)
+
+def error_inspect():
+    logger.warning(f"未完成任务:{topic_manager.unfinished_tasks.qsize()}")
+
+    item = topic_manager.unfinished_tasks.get()
+    logger.warning(f"其一:{item}")
+    logger.warning(f"重新发布失败数据,{item.get("unfinished_data")}")
+    topic_manager.publish(item.get("occurred"),item.get("unfinished_data"))
+
+if __name__ == '__main__':
+
+    Timer(interval=2,task=error_inspect).start()
+
+    @task(role="producer",topic="scan")
+    def a():
+        if token_bucket.get_token(block=True):
+            return random.randint(1,10)
+        else:
+            logger.warning("令牌桶无可用令牌,本次生成数据失败")
+            return -1
+
+
+    @task(role="consumer",subscribe="scan",publish_after="sayHi")
+    def b(data):
+        if data >5:
+            return data
+        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")
+
+    @task(role="consumer",subscribe="sayHi")
+    def c(data):
+        logger.debug(f"c触发,接收数据{data}")
+        raise Exception("处理失败")
+//===========================================================================
+2026-02-11 05:33:49 - INFO - Timer started,runs every 2 seconds
+2026-02-11 05:33:49 - INFO - publish topic-[scan]:1
+2026-02-11 05:33:49 - WARNING - 本次生成数字:1,不会继续发布sayHi主题
+2026-02-11 05:33:50 - INFO - publish topic-[scan]:3
+2026-02-11 05:33:50 - WARNING - 本次生成数字:3,不会继续发布sayHi主题
+2026-02-11 05:33:50 - INFO - publish topic-[scan]:1
+2026-02-11 05:33:50 - WARNING - 本次生成数字:1,不会继续发布sayHi主题
+2026-02-11 05:33:51 - WARNING - 未完成任务:0
+2026-02-11 05:33:51 - INFO - publish topic-[scan]:8
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:8
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据8
+2026-02-11 05:33:51 - ERROR - Consumer [None] failed to process message: 处理失败
+2026-02-11 05:33:51 - WARNING - 其一:{'unfinished_data': 8, 'occurred': 'sayHi', 'error': Exception('处理失败')}
+2026-02-11 05:33:51 - WARNING - 重新发布失败数据,8
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:8
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据8
+2026-02-11 05:33:51 - ERROR - Consumer [None] failed to process message: 处理失败
+2026-02-11 05:33:51 - INFO - publish topic-[scan]:7
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:7
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据7
+//==============================================================================
+```

dotask-0.3.2/dotask/__init__.py

@@ -0,0 +1,4 @@
+from .task import task
+from .task import topic_manager
+
+__all__ = ["task", "topic_manager"]

{dotask-0.3.0 → dotask-0.3.2}/dotask/task.py

@@ -2,10 +2,10 @@ import threading
 import functools
 import time
 import queue
+from queue import Queue
 from typing import Optional, Callable, Any, List, Set, Dict
 from dotask.util import logger
 
-
 # ------------------------------
 # 主题管理器： 发布接口适配
 # ------------------------------
@@ -15,6 +15,7 @@ class TopicManager:
         self.topic_locks: Dict[str, threading.Lock] = {}
         self.stop_flag = False
         self.global_lock = threading.Lock()
+        self.unfinished_tasks:Queue[Dict[str,Any]] = queue.Queue()
 
     def get_topic_queue(self, topic: str) -> queue.Queue:
         with self.global_lock:
@@ -69,7 +70,8 @@ topic_manager = TopicManager()
 # ------------------------------
 def task(
     func: Optional[Callable] = None,
-    role: str = "producer",
+    role: str = ""
+                "",
     topic: Optional[str] = None,
     subscribe: Optional[str] = None,
     publish_after: Optional[str] = None,  # 新增：消费后发布的主题（多个用,分隔）
@@ -151,6 +153,7 @@ def task(
 
                     except Exception as e:
                         logger.error(f"Consumer [{thread_name}] failed to process message: {e}")
+                        topic_manager.unfinished_tasks.put({"unfinished_data":data,"occurred":subscribe,"error":e})
 
                 # 开始消费
                 topic_manager.consume(subscribe_topics, handler)

dotask-0.3.2/dotask/util/__init__.py

@@ -0,0 +1,6 @@
+from .logger import logger
+from .shell import Shell
+from .limit import TokenBucket
+from .timer import Timer
+
+__all__ = ["logger", "TokenBucket", "Shell", "Timer"]

dotask-0.3.2/dotask/util/timer.py

@@ -0,0 +1,32 @@
+import threading
+from dotask.util import logger
+
+class Timer:
+    def __init__(self,interval:float,task):
+        self.interval = interval
+        self.task = task
+        # 存储定时对象
+        self.timer = None
+        # 标记定时器是否运行
+        self.is_running = False
+    def _run_task(self):
+        """
+        内部方法:执行任务并重启定时器
+        """
+        self.is_running = True
+        try:
+            self.task()
+        finally:
+            # 任务完毕后，重新创建定时器
+            self.timer = threading.Timer(self.interval, self._run_task)
+            self.timer.start()
+    def start(self):
+        if not self.is_running:
+            self.timer = threading.Timer(self.interval, self._run_task)
+            self.timer.start()
+            logger.info(f"Timer started,runs every {self.interval} seconds")
+    def stop(self):
+        if self.timer and self.is_running:
+            self.timer.cancel()
+            self.is_running = False
+            logger.info(f"Timer stopped")

dotask-0.3.2/dotask.egg-info/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: dotask
+Version: 0.3.2
+Summary: 发布订阅注解方式
+Home-page: https://gitee.com/d-yz/task-manager
+Author: dyz
+Author-email: 837701454@qq.com
+Keywords: 发布订阅,注解,dotask
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+## 版本说明
+### 0.1.0
+- 在方法上添加@task就可以直接开启一个线程执行任务
+- 常用参数：
+  - 生产者: `role="producer",topic="自定义"`
+  - 消费者: `role="consumer",subscribe="自定义",publish_after="自定义"`
+- 说明:
+  - `role`: 用于区分上下游 `producer/consumer`
+  - `topic`: 发布的主题
+  - `subscribe`: 对哪些主题感兴趣
+  - `publish_after`: 消费完后继续发布新主题
+- 特别的：方法的返回值可以进行传递,若没有返回值则不会发布新主题（只针对消费者和消费者之间）
+### 0.2.x
+1. dotask暴露`topic_manager`=>可以更好的管理生产消费者 
+2. 迁移`logger`至`util`包下
+3. 添加本地调用shell工具函数->可以很好的适配@task消费者
+   1. `max_concurrent`:控制并发执行的shell数量
+   2. 引入`dotask.Shell` 调用`Shell(max_concurrent=?).local_shell_execute(cmd,callback)`来使用
+### 0.3.x
+1. 添加令牌桶,通过`from dotask.util import TokenBucket`使用,可以更好的限制生产消费速率
+   - 参数说明
+     - TokenBucket(capacity=1, rate=0),capacity:令牌桶容量,rate:每秒生成速率
+     - get_token(block=True),block:决定令牌桶无令牌时是阻塞还是返回false
+2. `topic_manager`内部维护`unfinished_tasks`队列，记录所有消费失败的数据及其异常
+3. 添加定时器`Timer`,可以配合`unfinished_tasks`再次处理未消费完成的数据
+
+## 快速开始
+### 安装
+`pip install dotask`
+### 示例
+1. 简单的生产发布模式
+
+```
+from dotask import task  
+from dotask.util import logger  
+import random  
+  
+if __name__ == '__main__':  
+  
+    @task(role="producer",topic="scan")  
+    def a():  
+        return random.randint(1,10)  
+  
+  
+    @task(role="consumer",subscribe="scan",publish_after="sayHi")  
+    def b(data):  
+        if data >5:  
+            return data  
+        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")  
+  
+    @task(role="consumer",subscribe="sayHi")  
+    def c(data):  
+        logger.debug(f"c触发")  
+        logger.info(f"消费:{data}")
+//=====================================================================
+2026-02-08 17:30:37 - INFO - 发布主题-[scan]:5
+2026-02-08 17:30:37 - WARNING - 本次生成数字:5,不会继续发布sayHi主题
+2026-02-08 17:30:38 - INFO - 发布主题-[scan]:8
+2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:8
+2026-02-08 17:30:38 - DEBUG - c触发
+2026-02-08 17:30:38 - INFO - 消费:8
+2026-02-08 17:30:38 - INFO - 发布主题-[scan]:6
+2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:6
+2026-02-08 17:30:38 - DEBUG - c触发
+2026-02-08 17:30:38 - INFO - 消费:6
+//======================================================================
+```
+
+2. 令牌桶+定时器使用
+```
+from dotask import task,topic_manager
+from dotask.util import logger,TokenBucket,Timer
+import random
+
+token_bucket = TokenBucket(capacity=1, rate=1)
+
+def error_inspect():
+    logger.warning(f"未完成任务:{topic_manager.unfinished_tasks.qsize()}")
+
+    item = topic_manager.unfinished_tasks.get()
+    logger.warning(f"其一:{item}")
+    logger.warning(f"重新发布失败数据,{item.get("unfinished_data")}")
+    topic_manager.publish(item.get("occurred"),item.get("unfinished_data"))
+
+if __name__ == '__main__':
+
+    Timer(interval=2,task=error_inspect).start()
+
+    @task(role="producer",topic="scan")
+    def a():
+        if token_bucket.get_token(block=True):
+            return random.randint(1,10)
+        else:
+            logger.warning("令牌桶无可用令牌,本次生成数据失败")
+            return -1
+
+
+    @task(role="consumer",subscribe="scan",publish_after="sayHi")
+    def b(data):
+        if data >5:
+            return data
+        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")
+
+    @task(role="consumer",subscribe="sayHi")
+    def c(data):
+        logger.debug(f"c触发,接收数据{data}")
+        raise Exception("处理失败")
+//===========================================================================
+2026-02-11 05:33:49 - INFO - Timer started,runs every 2 seconds
+2026-02-11 05:33:49 - INFO - publish topic-[scan]:1
+2026-02-11 05:33:49 - WARNING - 本次生成数字:1,不会继续发布sayHi主题
+2026-02-11 05:33:50 - INFO - publish topic-[scan]:3
+2026-02-11 05:33:50 - WARNING - 本次生成数字:3,不会继续发布sayHi主题
+2026-02-11 05:33:50 - INFO - publish topic-[scan]:1
+2026-02-11 05:33:50 - WARNING - 本次生成数字:1,不会继续发布sayHi主题
+2026-02-11 05:33:51 - WARNING - 未完成任务:0
+2026-02-11 05:33:51 - INFO - publish topic-[scan]:8
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:8
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据8
+2026-02-11 05:33:51 - ERROR - Consumer [None] failed to process message: 处理失败
+2026-02-11 05:33:51 - WARNING - 其一:{'unfinished_data': 8, 'occurred': 'sayHi', 'error': Exception('处理失败')}
+2026-02-11 05:33:51 - WARNING - 重新发布失败数据,8
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:8
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据8
+2026-02-11 05:33:51 - ERROR - Consumer [None] failed to process message: 处理失败
+2026-02-11 05:33:51 - INFO - publish topic-[scan]:7
+2026-02-11 05:33:51 - INFO - publish topic-[sayHi]:7
+2026-02-11 05:33:51 - DEBUG - c触发,接收数据7
+//==============================================================================
+```

{dotask-0.3.0 → dotask-0.3.2}/dotask.egg-info/SOURCES.txt

@@ -11,4 +11,5 @@ dotask.egg-info/top_level.txt
 dotask/util/__init__.py
 dotask/util/limit.py
 dotask/util/logger.py
-dotask/util/shell.py
+dotask/util/shell.py
+dotask/util/timer.py

{dotask-0.3.0 → dotask-0.3.2}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = dotask
-version = 0.3.0
+version = 0.3.2
 author = dyz
 author_email = 837701454@qq.com
 description = 发布订阅注解方式

dotask-0.3.0/PKG-INFO

@@ -1,83 +0,0 @@
-Metadata-Version: 2.4
-Name: dotask
-Version: 0.3.0
-Summary: 发布订阅注解方式
-Home-page: https://gitee.com/d-yz/task-manager
-Author: dyz
-Author-email: 837701454@qq.com
-Keywords: 发布订阅,注解,dotask
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-## 版本说明
-### 0.1.0
-- 在方法上添加@task就可以直接开启一个线程执行任务
-- 常用参数：
-  - 生产者: role="producer",topic="自定义"
-  - 消费者: role="consumer",subscribe="自定义",publish_after="自定义"
-- 说明:
-  - role: 用于区分上下游 producer/consumer
-  - topic: 发布的主题
-  - subscribe: 对哪些主题感兴趣
-  - publish_after: 消费完后继续发布新主题
-- 特别的：方法的返回值可以进行传递,若没有返回值则不会发布新主题（只针对消费者和消费者之间）
-### 0.2.x
-1. dotask暴露topic_manager=>可以更好的管理生产消费者 
-2. 迁移logger至util包下
-3. 添加本地调用shell工具函数->可以很好的适配@task消费者
-   1. max_concurrent:控制并发执行的shell数量
-   2. 引入dotask.Shell 调用Shell(max_concurrent=?).local_shell_execute(cmd,callback)来使用
-### 0.3.x
-1. 添加令牌桶,通过`from dotask.util import TokenBucket`使用,可以更好的限制生产消费速率
-- 参数说明
-  - TokenBucket(capacity=1, rate=0),capacity:令牌桶容量,rate:每秒生成速率
-  - get_token(block=True),block:决定令牌桶无令牌时是阻塞还是返回false
-## 快速开始
-### 安装
-`pip install dotask`
-### 示例
-1. 简单的生产发布模式
-
-```
-from dotask import task  
-from dotask.util import logger  
-import random  
-  
-if __name__ == '__main__':  
-  
-    @task(role="producer",topic="scan")  
-    def a():  
-        return random.randint(1,10)  
-  
-  
-    @task(role="consumer",subscribe="scan",publish_after="sayHi")  
-    def b(data):  
-        if data >5:  
-            return data  
-        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")  
-  
-    @task(role="consumer",subscribe="sayHi")  
-    def c(data):  
-        logger.debug(f"c触发")  
-        logger.info(f"消费:{data}")
-//=====================================================================
-2026-02-08 17:30:37 - INFO - 发布主题-[scan]:5
-2026-02-08 17:30:37 - WARNING - 本次生成数字:5,不会继续发布sayHi主题
-2026-02-08 17:30:38 - INFO - 发布主题-[scan]:8
-2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:8
-2026-02-08 17:30:38 - DEBUG - c触发
-2026-02-08 17:30:38 - INFO - 消费:8
-2026-02-08 17:30:38 - INFO - 发布主题-[scan]:6
-2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:6
-2026-02-08 17:30:38 - DEBUG - c触发
-2026-02-08 17:30:38 - INFO - 消费:6
-//======================================================================
-```

dotask-0.3.0/README.md

@@ -1,64 +0,0 @@
-## 版本说明
-### 0.1.0
-- 在方法上添加@task就可以直接开启一个线程执行任务
-- 常用参数：
-  - 生产者: role="producer",topic="自定义"
-  - 消费者: role="consumer",subscribe="自定义",publish_after="自定义"
-- 说明:
-  - role: 用于区分上下游 producer/consumer
-  - topic: 发布的主题
-  - subscribe: 对哪些主题感兴趣
-  - publish_after: 消费完后继续发布新主题
-- 特别的：方法的返回值可以进行传递,若没有返回值则不会发布新主题（只针对消费者和消费者之间）
-### 0.2.x
-1. dotask暴露topic_manager=>可以更好的管理生产消费者 
-2. 迁移logger至util包下
-3. 添加本地调用shell工具函数->可以很好的适配@task消费者
-   1. max_concurrent:控制并发执行的shell数量
-   2. 引入dotask.Shell 调用Shell(max_concurrent=?).local_shell_execute(cmd,callback)来使用
-### 0.3.x
-1. 添加令牌桶,通过`from dotask.util import TokenBucket`使用,可以更好的限制生产消费速率
-- 参数说明
-  - TokenBucket(capacity=1, rate=0),capacity:令牌桶容量,rate:每秒生成速率
-  - get_token(block=True),block:决定令牌桶无令牌时是阻塞还是返回false
-## 快速开始
-### 安装
-`pip install dotask`
-### 示例
-1. 简单的生产发布模式
-
-```
-from dotask import task  
-from dotask.util import logger  
-import random  
-  
-if __name__ == '__main__':  
-  
-    @task(role="producer",topic="scan")  
-    def a():  
-        return random.randint(1,10)  
-  
-  
-    @task(role="consumer",subscribe="scan",publish_after="sayHi")  
-    def b(data):  
-        if data >5:  
-            return data  
-        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")  
-  
-    @task(role="consumer",subscribe="sayHi")  
-    def c(data):  
-        logger.debug(f"c触发")  
-        logger.info(f"消费:{data}")
-//=====================================================================
-2026-02-08 17:30:37 - INFO - 发布主题-[scan]:5
-2026-02-08 17:30:37 - WARNING - 本次生成数字:5,不会继续发布sayHi主题
-2026-02-08 17:30:38 - INFO - 发布主题-[scan]:8
-2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:8
-2026-02-08 17:30:38 - DEBUG - c触发
-2026-02-08 17:30:38 - INFO - 消费:8
-2026-02-08 17:30:38 - INFO - 发布主题-[scan]:6
-2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:6
-2026-02-08 17:30:38 - DEBUG - c触发
-2026-02-08 17:30:38 - INFO - 消费:6
-//======================================================================
-```

dotask-0.3.0/dotask/__init__.py

@@ -1,2 +0,0 @@
-from .task import task,topic_manager
-

dotask-0.3.0/dotask/util/__init__.py

@@ -1,3 +0,0 @@
-from .logger import logger
-from .shell import Shell
-from .limit import TokenBucket

dotask-0.3.0/dotask.egg-info/PKG-INFO

@@ -1,83 +0,0 @@
-Metadata-Version: 2.4
-Name: dotask
-Version: 0.3.0
-Summary: 发布订阅注解方式
-Home-page: https://gitee.com/d-yz/task-manager
-Author: dyz
-Author-email: 837701454@qq.com
-Keywords: 发布订阅,注解,dotask
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-## 版本说明
-### 0.1.0
-- 在方法上添加@task就可以直接开启一个线程执行任务
-- 常用参数：
-  - 生产者: role="producer",topic="自定义"
-  - 消费者: role="consumer",subscribe="自定义",publish_after="自定义"
-- 说明:
-  - role: 用于区分上下游 producer/consumer
-  - topic: 发布的主题
-  - subscribe: 对哪些主题感兴趣
-  - publish_after: 消费完后继续发布新主题
-- 特别的：方法的返回值可以进行传递,若没有返回值则不会发布新主题（只针对消费者和消费者之间）
-### 0.2.x
-1. dotask暴露topic_manager=>可以更好的管理生产消费者 
-2. 迁移logger至util包下
-3. 添加本地调用shell工具函数->可以很好的适配@task消费者
-   1. max_concurrent:控制并发执行的shell数量
-   2. 引入dotask.Shell 调用Shell(max_concurrent=?).local_shell_execute(cmd,callback)来使用
-### 0.3.x
-1. 添加令牌桶,通过`from dotask.util import TokenBucket`使用,可以更好的限制生产消费速率
-- 参数说明
-  - TokenBucket(capacity=1, rate=0),capacity:令牌桶容量,rate:每秒生成速率
-  - get_token(block=True),block:决定令牌桶无令牌时是阻塞还是返回false
-## 快速开始
-### 安装
-`pip install dotask`
-### 示例
-1. 简单的生产发布模式
-
-```
-from dotask import task  
-from dotask.util import logger  
-import random  
-  
-if __name__ == '__main__':  
-  
-    @task(role="producer",topic="scan")  
-    def a():  
-        return random.randint(1,10)  
-  
-  
-    @task(role="consumer",subscribe="scan",publish_after="sayHi")  
-    def b(data):  
-        if data >5:  
-            return data  
-        logger.warning(f"本次生成数字:{data},不会继续发布sayHi主题")  
-  
-    @task(role="consumer",subscribe="sayHi")  
-    def c(data):  
-        logger.debug(f"c触发")  
-        logger.info(f"消费:{data}")
-//=====================================================================
-2026-02-08 17:30:37 - INFO - 发布主题-[scan]:5
-2026-02-08 17:30:37 - WARNING - 本次生成数字:5,不会继续发布sayHi主题
-2026-02-08 17:30:38 - INFO - 发布主题-[scan]:8
-2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:8
-2026-02-08 17:30:38 - DEBUG - c触发
-2026-02-08 17:30:38 - INFO - 消费:8
-2026-02-08 17:30:38 - INFO - 发布主题-[scan]:6
-2026-02-08 17:30:38 - INFO - 发布主题-[sayHi]:6
-2026-02-08 17:30:38 - DEBUG - c触发
-2026-02-08 17:30:38 - INFO - 消费:6
-//======================================================================
-```