vs-queue 0.1.1__tar.gz → 0.1.2__tar.gz

{vs_queue-0.1.1 → vs_queue-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vs-queue
-Version: 0.1.1
+Version: 0.1.2
 Summary: Pluggable async message queue library for Viveka Sutra — Redis Streams, RabbitMQ, retry, dead letter, and annotation-based consumers
 Project-URL: Homepage, https://vivekasutra.com/
 Project-URL: Source, https://github.com/vivekasutra/viveka-mula
@@ -315,13 +315,13 @@ Abstract base class for all consumers. Extend this and implement `handle` to pro
 | Method | Description |
 |---|---|
 | `handle(message)` | Called for every message received. Raise any exception to trigger retry. |
-| `start()` | Called once when the consumer begins. Use for setup. |
-| `stop()` | Called once on graceful shutdown. Use for cleanup. |
 
-**Optional override:**
+**Optional overrides** (concrete no-ops by default — override only if you need them):
 
 | Method | Description |
 |---|---|
+| `start()` | Called once when the consumer begins. Use for setup. |
+| `stop()` | Called once on graceful shutdown. Use for cleanup. |
 | `on_error(message, error)` | Called when `handle` raises an exception, before retry logic runs. Use for logging or alerting. |
 
 **Example with error hook:**
@@ -374,9 +374,6 @@ Decorator that registers a `VsBaseConsumer` subclass as a listener. `VsQueueMana
 class SimpleConsumer(VsBaseConsumer):
     async def handle(self, message: VsMessage) -> None:
         print(message.payload)
-
-    async def start(self) -> None: pass
-    async def stop(self) -> None: pass
 ```
 
 **Example — full configuration:**
@@ -543,9 +540,6 @@ class DlqConsumer(VsBaseConsumer):
             f"Message permanently failed | id={message.id} retries={message.retry_count}",
             payload=message.payload,
         )
-
-    async def start(self) -> None: pass
-    async def stop(self) -> None: pass
 ```
 
 **Example — replaying a DLQ message:**
@@ -938,9 +932,9 @@ Abstract base. Extend and implement `handle` to process messages.
 | Method | Required | Description |
 |---|---|---|
 | `handle(message)` | Yes | Process a message. Raise to trigger retry. |
-| `start()` | Yes | Setup before consuming begins |
-| `stop()` | Yes | Cleanup on shutdown — called on graceful cancel |
-| `on_error(message, error)` | No | Called on `handle` failure before retry |
+| `start()` | No — no-op by default | Setup before consuming begins |
+| `stop()` | No — no-op by default | Cleanup on shutdown — called on graceful cancel |
+| `on_error(message, error)` | No — no-op by default | Called on `handle` failure before retry |
 
 ---
 

{vs_queue-0.1.1 → vs_queue-0.1.2}/README.md

@@ -284,13 +284,13 @@ Abstract base class for all consumers. Extend this and implement `handle` to pro
 | Method | Description |
 |---|---|
 | `handle(message)` | Called for every message received. Raise any exception to trigger retry. |
-| `start()` | Called once when the consumer begins. Use for setup. |
-| `stop()` | Called once on graceful shutdown. Use for cleanup. |
 
-**Optional override:**
+**Optional overrides** (concrete no-ops by default — override only if you need them):
 
 | Method | Description |
 |---|---|
+| `start()` | Called once when the consumer begins. Use for setup. |
+| `stop()` | Called once on graceful shutdown. Use for cleanup. |
 | `on_error(message, error)` | Called when `handle` raises an exception, before retry logic runs. Use for logging or alerting. |
 
 **Example with error hook:**
@@ -343,9 +343,6 @@ Decorator that registers a `VsBaseConsumer` subclass as a listener. `VsQueueMana
 class SimpleConsumer(VsBaseConsumer):
     async def handle(self, message: VsMessage) -> None:
         print(message.payload)
-
-    async def start(self) -> None: pass
-    async def stop(self) -> None: pass
 ```
 
 **Example — full configuration:**
@@ -512,9 +509,6 @@ class DlqConsumer(VsBaseConsumer):
             f"Message permanently failed | id={message.id} retries={message.retry_count}",
             payload=message.payload,
         )
-
-    async def start(self) -> None: pass
-    async def stop(self) -> None: pass
 ```
 
 **Example — replaying a DLQ message:**
@@ -907,9 +901,9 @@ Abstract base. Extend and implement `handle` to process messages.
 | Method | Required | Description |
 |---|---|---|
 | `handle(message)` | Yes | Process a message. Raise to trigger retry. |
-| `start()` | Yes | Setup before consuming begins |
-| `stop()` | Yes | Cleanup on shutdown — called on graceful cancel |
-| `on_error(message, error)` | No | Called on `handle` failure before retry |
+| `start()` | No — no-op by default | Setup before consuming begins |
+| `stop()` | No — no-op by default | Cleanup on shutdown — called on graceful cancel |
+| `on_error(message, error)` | No — no-op by default | Called on `handle` failure before retry |
 
 ---
 

{vs_queue-0.1.1 → vs_queue-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "vs-queue"
-version = "0.1.1"
+version = "0.1.2"
 description = "Pluggable async message queue library for Viveka Sutra — Redis Streams, RabbitMQ, retry, dead letter, and annotation-based consumers"
 readme = "README.md"
 requires-python = ">=3.11"

{vs_queue-0.1.1 → vs_queue-0.1.2}/vs_queue/base/vs_base_consumer.py

@@ -13,12 +13,12 @@ class VsBaseConsumer(ABC):
     async def handle(self, message: VsMessage) -> None:
         pass
 
-    @abstractmethod
     async def start(self) -> None:
+        """Called once before consuming begins. Override for setup."""
         pass
 
-    @abstractmethod
     async def stop(self) -> None:
+        """Called once on graceful shutdown. Override for cleanup."""
         pass
 
     async def on_error(self, message: VsMessage, error: Exception) -> None:

{vs_queue-0.1.1 → vs_queue-0.1.2}/vs_queue.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vs-queue
-Version: 0.1.1
+Version: 0.1.2
 Summary: Pluggable async message queue library for Viveka Sutra — Redis Streams, RabbitMQ, retry, dead letter, and annotation-based consumers
 Project-URL: Homepage, https://vivekasutra.com/
 Project-URL: Source, https://github.com/vivekasutra/viveka-mula
@@ -315,13 +315,13 @@ Abstract base class for all consumers. Extend this and implement `handle` to pro
 | Method | Description |
 |---|---|
 | `handle(message)` | Called for every message received. Raise any exception to trigger retry. |
-| `start()` | Called once when the consumer begins. Use for setup. |
-| `stop()` | Called once on graceful shutdown. Use for cleanup. |
 
-**Optional override:**
+**Optional overrides** (concrete no-ops by default — override only if you need them):
 
 | Method | Description |
 |---|---|
+| `start()` | Called once when the consumer begins. Use for setup. |
+| `stop()` | Called once on graceful shutdown. Use for cleanup. |
 | `on_error(message, error)` | Called when `handle` raises an exception, before retry logic runs. Use for logging or alerting. |
 
 **Example with error hook:**
@@ -374,9 +374,6 @@ Decorator that registers a `VsBaseConsumer` subclass as a listener. `VsQueueMana
 class SimpleConsumer(VsBaseConsumer):
     async def handle(self, message: VsMessage) -> None:
         print(message.payload)
-
-    async def start(self) -> None: pass
-    async def stop(self) -> None: pass
 ```
 
 **Example — full configuration:**
@@ -543,9 +540,6 @@ class DlqConsumer(VsBaseConsumer):
             f"Message permanently failed | id={message.id} retries={message.retry_count}",
             payload=message.payload,
         )
-
-    async def start(self) -> None: pass
-    async def stop(self) -> None: pass
 ```
 
 **Example — replaying a DLQ message:**
@@ -938,9 +932,9 @@ Abstract base. Extend and implement `handle` to process messages.
 | Method | Required | Description |
 |---|---|---|
 | `handle(message)` | Yes | Process a message. Raise to trigger retry. |
-| `start()` | Yes | Setup before consuming begins |
-| `stop()` | Yes | Cleanup on shutdown — called on graceful cancel |
-| `on_error(message, error)` | No | Called on `handle` failure before retry |
+| `start()` | No — no-op by default | Setup before consuming begins |
+| `stop()` | No — no-op by default | Cleanup on shutdown — called on graceful cancel |
+| `on_error(message, error)` | No — no-op by default | Called on `handle` failure before retry |
 
 ---