tinybot-eth 0.5.0__tar.gz → 0.6.0__tar.gz

{tinybot_eth-0.5.0/tinybot_eth.egg-info → tinybot_eth-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinybot-eth
-Version: 0.5.0
+Version: 0.6.0
 Summary: Minimal Python framework for building crypto bots
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -8,6 +8,7 @@ Requires-Dist: web3==7.14.1
 Requires-Dist: eth-abi==5.2.0
 Requires-Dist: eth-account==0.13.7
 Requires-Dist: python-telegram-bot==22.7
+Requires-Dist: croniter==6.2.2
 
 # tinybot
 
@@ -34,6 +35,7 @@ bot = TinyBot(rpc_url, name="my bot")
 
 bot.listen(event="AuctionKicked", handler=on_kick, ...)
 bot.every(180, check_expired)
+bot.cron("0 * * * *", hourly_check)
 
 await bot.run()
 ```
@@ -132,6 +134,19 @@ Handler signature: `async fn(bot)`
 
 ---
 
+### `bot.cron(expression, handler, name="", notify_errors=True) -> CronTask`
+
+Register a cron-scheduled task. Uses standard cron expressions.
+
+```python
+bot.cron("0 * * * *", notify_ending_soon)      # every hour at :00
+bot.cron("*/30 * * * *", check_something)       # every 30 minutes
+```
+
+Handler signature: `async fn(bot)`
+
+---
+
 ### `bot.get_listener(name) -> EventListener`
 
 Get a registered listener by name. Raises `ValueError` if not found.

tinybot_eth-0.5.0/PKG-INFO → tinybot_eth-0.6.0/README.md

@@ -1,14 +1,3 @@
-Metadata-Version: 2.4
-Name: tinybot-eth
-Version: 0.5.0
-Summary: Minimal Python framework for building crypto bots
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Requires-Dist: web3==7.14.1
-Requires-Dist: eth-abi==5.2.0
-Requires-Dist: eth-account==0.13.7
-Requires-Dist: python-telegram-bot==22.7
-
 # tinybot
 
 Minimal Python framework for building crypto bots.
@@ -34,6 +23,7 @@ bot = TinyBot(rpc_url, name="my bot")
 
 bot.listen(event="AuctionKicked", handler=on_kick, ...)
 bot.every(180, check_expired)
+bot.cron("0 * * * *", hourly_check)
 
 await bot.run()
 ```
@@ -132,6 +122,19 @@ Handler signature: `async fn(bot)`
 
 ---
 
+### `bot.cron(expression, handler, name="", notify_errors=True) -> CronTask`
+
+Register a cron-scheduled task. Uses standard cron expressions.
+
+```python
+bot.cron("0 * * * *", notify_ending_soon)      # every hour at :00
+bot.cron("*/30 * * * *", check_something)       # every 30 minutes
+```
+
+Handler signature: `async fn(bot)`
+
+---
+
 ### `bot.get_listener(name) -> EventListener`
 
 Get a registered listener by name. Raises `ValueError` if not found.

{tinybot_eth-0.5.0 → tinybot_eth-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tinybot-eth"
-version = "0.5.0"
+version = "0.6.0"
 description = "Minimal Python framework for building crypto bots"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -9,6 +9,7 @@ dependencies = [
     "eth-abi==5.2.0",
     "eth-account==0.13.7",
     "python-telegram-bot==22.7",
+    "croniter==6.2.2",
 ]
 
 [tool.setuptools.packages.find]

{tinybot_eth-0.5.0 → tinybot_eth-0.6.0}/tinybot/bot.py

@@ -8,7 +8,9 @@ from web3 import Web3
 from tinybot.executor import Executor
 from tinybot.state import State
 from tinybot.tg import DEV_GROUP_CHAT_ID, notify_group_chat
-from tinybot.types import EventHandler, EventListener, PeriodicTask, TaskHandler
+from croniter import croniter
+
+from tinybot.types import CronTask, EventHandler, EventListener, PeriodicTask, TaskHandler
 from tinybot.utils import event_id, event_signature
 
 
@@ -20,6 +22,7 @@ class TinyBot:
         self.executor = Executor(self.w3, private_key) if private_key else None
         self._listeners: list[EventListener] = []
         self._tasks: list[PeriodicTask] = []
+        self._crons: list[tuple[CronTask, croniter]] = []
 
     # -------------------------------------------------------------------------
     # Registration
@@ -77,6 +80,26 @@ class TinyBot:
         self._tasks.append(task)
         return task
 
+    def cron(
+        self,
+        expression: str,
+        handler: TaskHandler,
+        name: str = "",
+        notify_errors: bool = True,
+    ) -> CronTask:
+        name = name or handler.__name__
+        if any(task.name == name for task, _ in self._crons):
+            raise ValueError(f"cron '{name}' already registered")
+        task = CronTask(
+            name=name,
+            expression=expression,
+            handler=handler,
+            notify_errors=notify_errors,
+        )
+        cron = croniter(expression, datetime.now())
+        self._crons.append((task, cron))
+        return task
+
     # -------------------------------------------------------------------------
     # Getters
     # -------------------------------------------------------------------------
@@ -149,7 +172,7 @@ class TinyBot:
         except Exception as e:
             await self._handle_error(e, listener.name, listener.notify_errors)
 
-    async def _poll_task(self, task: PeriodicTask) -> None:
+    async def _poll_periodic(self, task: PeriodicTask) -> None:
         now = time.time()
         if now - task._last_run < task.interval:
             return
@@ -160,6 +183,16 @@ class TinyBot:
         except Exception as e:
             await self._handle_error(e, task.name, task.notify_errors)
 
+    async def _poll_cron(self, task: CronTask, cron: croniter) -> None:
+        now = datetime.now()
+        next_run = cron.get_current(datetime)
+        if now >= next_run:
+            try:
+                await task.handler(self)
+            except Exception as e:
+                await self._handle_error(e, task.name, task.notify_errors)
+            cron.get_next(datetime)
+
     # -------------------------------------------------------------------------
     # Run
     # -------------------------------------------------------------------------
@@ -175,5 +208,7 @@ class TinyBot:
             for listener in self._listeners:
                 await self._poll_listener(listener)
             for task in self._tasks:
-                await self._poll_task(task)
+                await self._poll_periodic(task)
+            for task, cron in self._crons:
+                await self._poll_cron(task, cron)
             await asyncio.sleep(tick)

{tinybot_eth-0.5.0 → tinybot_eth-0.6.0}/tinybot/types.py

@@ -44,3 +44,11 @@ class PeriodicTask:
     handler: TaskHandler
     notify_errors: bool = True
     _last_run: float = 0
+
+
+@dataclass
+class CronTask:
+    name: str
+    expression: str
+    handler: TaskHandler
+    notify_errors: bool = True

tinybot_eth-0.5.0/README.md → tinybot_eth-0.6.0/tinybot_eth.egg-info/PKG-INFO

@@ -1,3 +1,15 @@
+Metadata-Version: 2.4
+Name: tinybot-eth
+Version: 0.6.0
+Summary: Minimal Python framework for building crypto bots
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: web3==7.14.1
+Requires-Dist: eth-abi==5.2.0
+Requires-Dist: eth-account==0.13.7
+Requires-Dist: python-telegram-bot==22.7
+Requires-Dist: croniter==6.2.2
+
 # tinybot
 
 Minimal Python framework for building crypto bots.
@@ -23,6 +35,7 @@ bot = TinyBot(rpc_url, name="my bot")
 
 bot.listen(event="AuctionKicked", handler=on_kick, ...)
 bot.every(180, check_expired)
+bot.cron("0 * * * *", hourly_check)
 
 await bot.run()
 ```
@@ -121,6 +134,19 @@ Handler signature: `async fn(bot)`
 
 ---
 
+### `bot.cron(expression, handler, name="", notify_errors=True) -> CronTask`
+
+Register a cron-scheduled task. Uses standard cron expressions.
+
+```python
+bot.cron("0 * * * *", notify_ending_soon)      # every hour at :00
+bot.cron("*/30 * * * *", check_something)       # every 30 minutes
+```
+
+Handler signature: `async fn(bot)`
+
+---
+
 ### `bot.get_listener(name) -> EventListener`
 
 Get a registered listener by name. Raises `ValueError` if not found.

{tinybot_eth-0.5.0 → tinybot_eth-0.6.0}/tinybot_eth.egg-info/requires.txt

@@ -2,3 +2,4 @@ web3==7.14.1
 eth-abi==5.2.0
 eth-account==0.13.7
 python-telegram-bot==22.7
+croniter==6.2.2