python-pq 0.5.1__tar.gz → 0.5.2__tar.gz

{python_pq-0.5.1 → python_pq-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-pq
-Version: 0.5.1
+Version: 0.5.2
 Summary: Postgres-backed job queue for Python
 Author: ricwo
 Author-email: ricwo <r@cogram.com>
@@ -166,6 +166,20 @@ pq.schedule(fast_idempotent_task, run_every=timedelta(seconds=30), max_concurren
 
 The lock auto-expires after `max_runtime` seconds (or 1 hour by default) for crash safety.
 
+### Pausing & Resuming
+
+Disable a periodic task without removing it:
+
+```python
+# Pause - task stays in the database but won't run
+pq.schedule(sync_inventory, run_every=timedelta(minutes=5), active=False)
+
+# Resume
+pq.schedule(sync_inventory, run_every=timedelta(minutes=5), active=True)
+```
+
+New schedules are active by default.
+
 ### Multiple Schedules (Key)
 
 Use `key` to register the same function multiple times with different configurations:

{python_pq-0.5.1 → python_pq-0.5.2}/README.md

@@ -145,6 +145,20 @@ pq.schedule(fast_idempotent_task, run_every=timedelta(seconds=30), max_concurren
 
 The lock auto-expires after `max_runtime` seconds (or 1 hour by default) for crash safety.
 
+### Pausing & Resuming
+
+Disable a periodic task without removing it:
+
+```python
+# Pause - task stays in the database but won't run
+pq.schedule(sync_inventory, run_every=timedelta(minutes=5), active=False)
+
+# Resume
+pq.schedule(sync_inventory, run_every=timedelta(minutes=5), active=True)
+```
+
+New schedules are active by default.
+
 ### Multiple Schedules (Key)
 
 Use `key` to register the same function multiple times with different configurations:

{python_pq-0.5.1 → python_pq-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-pq"
-version = "0.5.1"
+version = "0.5.2"
 description = "Postgres-backed job queue for Python"
 readme = "README.md"
 authors = [

{python_pq-0.5.1 → python_pq-0.5.2}/src/pq/__init__.py

@@ -7,7 +7,7 @@ from pq.models import Periodic, Task, TaskStatus
 from pq.priority import Priority
 from pq.worker import PostExecuteHook, PreExecuteHook, TaskTimeoutError
 
-__version__ = "0.5.1"
+__version__ = "0.5.2"
 
 __all__ = [
     "PQ",

{python_pq-0.5.1 → python_pq-0.5.2}/src/pq/client.py

@@ -237,6 +237,7 @@ class PQ:
         client_id: str | None = None,
         max_concurrent: int | None = 1,
         key: str = "",
+        active: bool = True,
         **kwargs: Any,
     ) -> int:
         """Schedule a periodic task.
@@ -256,6 +257,8 @@ class PQ:
                 for future use and raise ValueError.
             key: Discriminator for multiple schedules of the same function.
                 Defaults to "" (empty string).
+            active: Whether the task is active. Inactive tasks are not executed.
+                Defaults to True.
             **kwargs: Keyword arguments to pass to the handler.
 
         Returns:
@@ -316,6 +319,7 @@ class PQ:
                     next_run=next_run,
                     client_id=client_id,
                     max_concurrent=max_concurrent,
+                    active=active,
                 )
                 .on_conflict_do_update(
                     index_elements=["name", "key"],
@@ -326,6 +330,7 @@ class PQ:
                         "cron": cron_expr,
                         "next_run": next_run,
                         "max_concurrent": max_concurrent,
+                        "active": active,
                     },
                 )
                 .returning(Periodic.id)

python_pq-0.5.2/src/pq/migrations/versions/20260217T120000Z_c3d4e5f6a7b8_add_periodic_active.py

@@ -0,0 +1,32 @@
+"""add periodic active
+
+Revision ID: c3d4e5f6a7b8
+Revises: b7c8d9e0f1a2
+Create Date: 2026-02-17 12:00:00 Z
+
+"""
+
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = "c3d4e5f6a7b8"
+down_revision: Union[str, Sequence[str], None] = "b7c8d9e0f1a2"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Add active column to pq_periodic."""
+    op.add_column(
+        "pq_periodic",
+        sa.Column("active", sa.Boolean(), nullable=False, server_default="true"),
+    )
+
+
+def downgrade() -> None:
+    """Remove active column from pq_periodic."""
+    op.drop_column("pq_periodic", "active")

{python_pq-0.5.1 → python_pq-0.5.2}/src/pq/models.py

@@ -6,6 +6,7 @@ from typing import Any
 
 from sqlalchemy import (
     BigInteger,
+    Boolean,
     DateTime,
     Enum,
     Identity,
@@ -92,6 +93,7 @@ class Periodic(Base):
     cron: Mapped[str | None] = mapped_column(String(100), nullable=True)
     next_run: Mapped[datetime] = mapped_column(DateTime(timezone=True), nullable=False)
     max_concurrent: Mapped[int | None] = mapped_column(SmallInteger, nullable=True)
+    active: Mapped[bool] = mapped_column(Boolean, nullable=False, server_default="true")
     last_run: Mapped[datetime | None] = mapped_column(
         DateTime(timezone=True), nullable=True
     )

{python_pq-0.5.1 → python_pq-0.5.2}/src/pq/worker.py

@@ -560,6 +560,7 @@ def _process_periodic_task(
             # Claim highest priority due periodic task with FOR UPDATE SKIP LOCKED
             # Filter out tasks that are locked (max_concurrent=1 and locked_until in future)
             stmt = select(Periodic).where(
+                Periodic.active.is_(True),
                 Periodic.next_run <= func.now(),
                 or_(
                     Periodic.max_concurrent.is_(None),