work_queue.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/core/work_queue.py
 
# OCT-LINT: disable=tests_exist reason="Re-export shim; the module it names is covered by oc_orchestrator/tests/, and this path by test_271_queue_shims.py"
"""
The work queue's contract. — moved to :mod:`oc_orchestrator.work_queue`.
 
Purpose
-------
Plan 271 P3. This module's code now lives in the standalone
``oc_orchestrator`` package; this file keeps ``oc_chat.core.work_queue``
working for every importer that has always spelled it that way.
 
It is a REBINDING, not a wrapper: the last statement replaces this
module's entry in :data:`sys.modules` with the moved module itself, so
``oc_chat.core.work_queue`` and ``oc_orchestrator.work_queue`` are one
object. That is what keeps every private name reachable, every
``monkeypatch`` effective across the seam, and every ``isinstance`` true
— a wrapper that merely re-exported public names would break all three
quietly. ``tests/registry/test_258_queue_backend.py`` is the concrete
reason: it monkeypatches :data:`SUPPORTED_KINDS` on the module reached
through THIS path and expects the registry backend, which imports the
package path, to see the patch.
 
Responsibilities
----------------
- Bind the moved module to this path. Nothing else: no behaviour, no
  defaults, no wiring. ``scripts/work_queue_manage.py`` is the shim that
  carries oc_chat's wiring, because only it has defaults — the program
  name and the registry backend factory — that differ from the
  package's.
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - lifecycle events
    L3 - semantic details
    L4 - deep tracing (the rebinding)
 
Contracts
---------
- Retirement rule (plan 271 P3, the plan-270 rule carried forward): this
  path stays until an explicit retirement plan retargets its importers.
  Nothing new should import it — new code names
  ``oc_orchestrator.work_queue`` directly.
- Adds no behaviour of its own, so it can never drift from the module
  it names.
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- oc_orchestrator.work_queue (the moved module this path binds)
"""
 
from __future__ import annotations
 
import sys
 
from oc_diagnostics import _dbg
 
from oc_orchestrator import work_queue as _moved
 
_dbg("OC_CHAT.MAIN", "module", "work_queue shim -> oc_orchestrator.work_queue", 4)
 
sys.modules[__name__] = _moved