ltq 0.2.0__tar.gz → 0.3.0__tar.gz

{ltq-0.2.0 → ltq-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ltq
-Version: 0.2.0
+Version: 0.3.0
 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 → ltq-0.3.0}/README.md

@@ -31,12 +31,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())
 ```
@@ -54,13 +54,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 → ltq-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ltq"
-version = "0.2.0"
+version = "0.3.0"
 description = "Add your description here"
 readme = "README.md"
 authors = [{ name = "Tom Clesius", email = "tomclesius@gmail.com" }]
@@ -19,7 +19,7 @@ requires = ["uv_build>=0.9.26,<0.10.0"]
 build-backend = "uv_build"
 
 [tool.bumpversion]
-current_version = "0.2.0"
+current_version = "0.3.0"
 commit = true
 tag = true
 message = "v{new_version}"

{ltq-0.2.0 → ltq-0.3.0}/src/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))