Files
plm-lottery/apps/lottery/management/commands/run_worker.py
T

52 lines
1.7 KiB
Python
Raw Normal View History

"""The background worker process (ADR-55): runs the round lifecycle every few seconds and, on the
simulated ledger, settles the confirmations that a real chain would bring (roadmap A4). The chain tasks
of phase B plug into `tick` too. A step that fails is logged and retried at the next tick: the lifecycle
keeps no state outside the database.
"""
import logging
import signal
import threading
from django.core.management.base import BaseCommand
logger = logging.getLogger(__name__)
TICK_SECONDS = 5
def tick() -> None:
"""One pass over everything the worker is responsible for."""
from django.conf import settings
from apps.lottery import console, lifecycle, simulation
console.beat() # WEB-31: proof of life, before the work that might fail
if settings.LEDGER_BACKEND == "simulated":
simulation.settle()
lifecycle.tick()
class Command(BaseCommand):
help = "Run the background worker (round scheduler and chain tasks)."
def add_arguments(self, parser):
parser.add_argument("--once", action="store_true", help="Run a single tick and exit.")
def handle(self, *args, **options):
stop = threading.Event()
for signum in (signal.SIGTERM, signal.SIGINT):
signal.signal(signum, lambda *_: stop.set())
logger.info("worker started")
while not stop.is_set():
try:
tick()
except Exception: # a failed step leaves the round where it was; the next tick retries
logger.exception("worker tick failed")
if options["once"]:
raise
if options["once"]:
break
stop.wait(TICK_SECONDS)
logger.info("worker stopped")