Files
colibri/c/tests/test_env_defaults.py
T
KingIcyCreamProjects 1a243cfc3e coli: measured Windows launcher defaults — OMP tuning parity + DIRECT/PIPE/PILOT_REAL
On Windows the engine self-exec OMP tuning never runs (Linux/FreeBSD-only)
and posix_fadvise readahead is a compat.h no-op, so a stock Windows run
leaves large measured wins on the table. The launcher now setdefaults, on
win32 only, each independently overridable by setting the variable:

- OMP_WAIT_POLICY=active, GOMP_SPINCOUNT=200000, OMP_DYNAMIC=FALSE,
  OMP_NUM_THREADS=<physical cores> (parity with the glm.c self-exec block;
  COLI_NO_OMP_TUNE disables exactly this block, presence-based like the
  engine). OMP_PROC_BIND/OMP_PLACES deliberately omitted and also removed
  from environment_for_plan on win32: MinGW libgomp has no affinity support
  ("Affinity not supported on this configuration").
- DIRECT=1: unbuffered expert reads. Measured on a 9950X3D + Samsung 9100
  PRO Gen5 + Win11: iobench 10.68 GB/s O_DIRECT vs 9.03 buffered (warm);
  end-to-end REPLAY 0.48 -> 1.02 tok/s. Matches #162 (1.47x same class).
- PIPE=1: load/matmul overlap, byte-identical output; +8% on top of DIRECT
  (PIPE_WORKERS untouched at 8 - 4/8/16 swept flat on Gen5).
- PILOT_REAL=1: real cross-layer prefetch, the only working prefetch on
  Windows; +11% and expert hit rate +19 points.

Full ladder methodology and numbers: 96-token greedy REPLAY, one lever per
step, medians of 3-4 runs (see the fork tuning doc referenced in the PR).
tests/test_env_defaults.py covers the defaults, explicit-override-wins,
the kill-switch scope, and the non-win32 no-op.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-15 12:06:48 -05:00

69 lines
2.5 KiB
Python

"""env_for: default Windows misurati (DIRECT/PIPE/PILOT_REAL + blocco OMP).
Carica `coli` come modulo (ha la guardia __main__) e verifica il contratto:
- win32: i tre default I/O e il blocco OMP sono setdefault
- un override esplicito dell'utente vince sempre
- COLI_NO_OMP_TUNE spegne SOLO il blocco OMP, non i default I/O
- non-win32: env_for non tocca nulla di tutto questo
"""
import importlib.machinery
import importlib.util
import os
import sys
import types
import unittest
from pathlib import Path
from unittest import mock
HERE = Path(__file__).resolve().parent.parent
sys.path.insert(0, str(HERE))
_loader = importlib.machinery.SourceFileLoader("coli_cli", str(HERE / "coli"))
_spec = importlib.util.spec_from_loader("coli_cli", _loader)
coli = importlib.util.module_from_spec(_spec)
_loader.exec_module(coli)
def args(**over):
base = dict(model="X", policy="quality", ram=0, ngen=0, topp=0, topk=0,
temp=None, repin=0, ctx=0, auto_tier=False, gpu=None, vram=0)
base.update(over)
return types.SimpleNamespace(**base)
class EnvDefaultsTest(unittest.TestCase):
def env_for_with(self, environ, platform):
with mock.patch.dict(os.environ, environ, clear=True), \
mock.patch.object(sys, "platform", platform):
return coli.env_for(args())
def test_win32_sets_measured_defaults(self):
e = self.env_for_with({}, "win32")
self.assertEqual(e["DIRECT"], "1")
self.assertEqual(e["PIPE"], "1")
self.assertEqual(e["PILOT_REAL"], "1")
self.assertEqual(e["OMP_WAIT_POLICY"], "active")
self.assertNotIn("OMP_PROC_BIND", e) # MinGW libgomp: niente affinity
def test_explicit_override_wins(self):
e = self.env_for_with({"DIRECT": "0", "PIPE": "0"}, "win32")
self.assertEqual(e["DIRECT"], "0")
self.assertEqual(e["PIPE"], "0")
self.assertEqual(e["PILOT_REAL"], "1") # non overridden -> default
def test_kill_switch_scope_is_omp_only(self):
e = self.env_for_with({"COLI_NO_OMP_TUNE": "1"}, "win32")
self.assertNotIn("OMP_WAIT_POLICY", e)
self.assertNotIn("OMP_NUM_THREADS", e)
self.assertEqual(e["DIRECT"], "1") # i default I/O restano attivi
self.assertEqual(e["PIPE"], "1")
def test_non_windows_untouched(self):
e = self.env_for_with({}, "linux")
for k in ("DIRECT", "PIPE", "PILOT_REAL", "OMP_WAIT_POLICY"):
self.assertNotIn(k, e)
if __name__ == "__main__":
unittest.main()