ltq 0.2.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

ltq/scheduler.py

@@ -4,21 +4,17 @@ import asyncio
 import time
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 from .message import Message
-
-try:
-    from croniter import croniter  # type: ignore[import-not-found]
-except ModuleNotFoundError as exc:
-    raise ModuleNotFoundError(
-        "Scheduler requires optional dependency 'croniter'. "
-        "Install with 'ltq[scheduler]'."
-    ) from exc
-
 from .utils import dispatch
 from .logger import get_logger
 
+try:
+    from croniter import croniter
+except ImportError:
+    croniter = None
+
 if TYPE_CHECKING:
     from .task import Task
 
@@ -28,11 +24,11 @@ class ScheduledJob:
     task: Task
     msg: Message
     expr: str
-    _cron: croniter = field(init=False, repr=False)
+    _cron: Any = field(init=False, repr=False)  # croniter instance
     next_run: datetime = field(init=False)
 
     def __post_init__(self):
-        self._cron = croniter(self.expr, datetime.now())
+        self._cron = croniter(self.expr, datetime.now())  # type: ignore[misc]
         self.advance()
 
     def advance(self) -> None:
@@ -47,6 +43,11 @@ class Scheduler:
         self._running = False
 
     def cron(self, expr: str, msg: Message) -> None:
+        if croniter is None:
+            raise ModuleNotFoundError(
+                "Scheduler requires optional dependency 'croniter'. "
+                "Install with 'ltq[scheduler]'."
+            )
         if msg.task is None:
             raise ValueError("Message must have a task assigned to use with scheduler")
         self.jobs.append(ScheduledJob(msg.task, msg, expr))

ltq/worker.py

@@ -2,7 +2,6 @@ from __future__ import annotations
 
 import asyncio
 from functools import partial
-from pathlib import Path
 from typing import TYPE_CHECKING, Any, Awaitable, Callable, ParamSpec, TypeVar
 
 import redis.asyncio as redis
@@ -38,15 +37,13 @@ class Worker:
         self.concurrency: int = concurrency
         self.poll_sleep: float = poll_sleep
 
-
     def task(
         self,
         queue_name: str | None = None,
         ttl: int | None = None,
     ) -> Callable[[Callable[P, Awaitable[R]]], Task[P, R]]:
         def decorator(fn: Callable[P, Awaitable[R]]) -> Task[P, R]:
-            filename = Path(fn.__code__.co_filename).stem
-            task_name = f"{filename}:{fn.__qualname__}"
+            task_name = f"{fn.__module__}:{fn.__qualname__}"
             queue = Queue(self.client, queue_name or task_name)
             task = Task(
                 name=task_name,

{ltq-0.2.0.dist-info → ltq-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ltq
-Version: 0.2.0
+Version: 0.3.1
 Summary: Add your description here
 Author: Tom Clesius
 Author-email: Tom Clesius <tomclesius@gmail.com>
@@ -45,12 +45,12 @@ async def main():
     # Enqueue a task
     await send_email.send("user@example.com", "Hello", "World")
 
-    # Or enqueue in bulk
+    # Or dispatch in bulk
     messages = [
         send_email.message("a@example.com", "Hi", "A"),
         send_email.message("b@example.com", "Hi", "B"),
     ]
-    await send_email.send_bulk(messages)
+    await ltq.dispatch(messages)
 
 asyncio.run(main())
 ```
@@ -68,13 +68,41 @@ async def send_newsletter(...): ...
 ## Running Workers
 
 ```bash
-# Run a worker
+# Run a single worker
 ltq myapp:worker
 
 # With options
 ltq myapp:worker --concurrency 100 --log-level DEBUG
 ```
 
+## Running an App
+
+Register multiple workers into an `App` to run them together:
+
+```python
+import ltq
+
+app = ltq.App()
+app.register_worker(emails_worker)
+app.register_worker(notifications_worker)
+```
+
+```bash
+ltq --app myapp:app
+```
+
+## Scheduler
+
+Run tasks on a cron schedule (requires `ltq[scheduler]`):
+
+```python
+import ltq
+
+scheduler = ltq.Scheduler()
+scheduler.cron("*/5 * * * *", send_email.message("admin@example.com", "Report", "..."))
+scheduler.run()
+```
+
 ## Middleware
 
 Add middleware to handle cross-cutting concerns:

{ltq-0.2.0.dist-info → ltq-0.3.1.dist-info}/RECORD

@@ -6,11 +6,11 @@ ltq/logger.py,sha256=HPClhDt3ecwZqE0Vq2oYF8Nr9jj-xrsSX9tM6enVgkA,1791
 ltq/message.py,sha256=hY_oPNMicSICV9-_o8Rma_kJO3DGJu_PFxyt1xZKMJE,871
 ltq/middleware.py,sha256=xy4VXy8uXp0vBMhdD6aSOQdzwCdbUkcuFw7FwPsqabU,3641
 ltq/q.py,sha256=3jRlPZKO4Zd5IYnb24jO_oRHtHBbG1la5SCZPI6QLI4,2537
-ltq/scheduler.py,sha256=EjXmmcyDv9Bp473Y40cTZAW6UVvkwZ_0MDE1XOjm5nI,2451
+ltq/scheduler.py,sha256=6l53-Hf-2sURxTEpY1MOM5z18slQTl4450f-aLHF1sY,2516
 ltq/task.py,sha256=ZKKag4u9k9hQ-lNdIWZygmGCc01DRt8a6kMQlQr_yaw,1000
 ltq/utils.py,sha256=M7EWJ-n9J3MMwofWwtxVkwgHmGeP66eoWuWDhjbx67k,536
-ltq/worker.py,sha256=gHA9xfDx1plhrC53nfO2mmapWex1JbFVNxGGSIV_ow8,3423
-ltq-0.2.0.dist-info/WHEEL,sha256=e_m4S054HL0hyR3CpOk-b7Q7fDX6BuFkgL5OjAExXas,80
-ltq-0.2.0.dist-info/entry_points.txt,sha256=OogYaOJ_RORrWtrLlEL_gTN9Vx5tkgawl8BO7G9FKcg,38
-ltq-0.2.0.dist-info/METADATA,sha256=mf5XFhk1D41Oimz_f34fiNh7quyOhXBRQu5qwEt2tnE,2396
-ltq-0.2.0.dist-info/RECORD,,
+ltq/worker.py,sha256=WIxLBCZYaVH_KVdexx77J607EEfQm1OKdtjmzCirvPM,3344
+ltq-0.3.1.dist-info/WHEEL,sha256=e_m4S054HL0hyR3CpOk-b7Q7fDX6BuFkgL5OjAExXas,80
+ltq-0.3.1.dist-info/entry_points.txt,sha256=OogYaOJ_RORrWtrLlEL_gTN9Vx5tkgawl8BO7G9FKcg,38
+ltq-0.3.1.dist-info/METADATA,sha256=WJzVlmvsEHVuUl4HovJ9Ip1EU2HERuarIcGpfcpOKAc,2863
+ltq-0.3.1.dist-info/RECORD,,