quality-loop 0.3.0__tar.gz → 0.4.1__tar.gz

{quality_loop-0.3.0/quality_loop.egg-info → quality_loop-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quality-loop
-Version: 0.3.0
+Version: 0.4.1
 Summary: Measure what a product teaches - its skill, tools or manual - with isolated agent runs of real tasks, reported by an operator agent
 Author: craftware
 License-Expression: MIT
@@ -110,6 +110,8 @@ under a policy the person sets. See [Running the loop](https://github.com/crftwr
   launch command and a redirected home up to evidence tools of its own.
 - [Reports](https://github.com/crftwr/quality-loop/blob/main/docs/reports.md): problems, severities, kinds and ids, the
   reproduction record, and `FINDINGS.md` / `findings.json`.
+- [Running the app in a VM](https://github.com/crftwr/quality-loop/blob/main/docs/guests.md): one image per OS,
+  the guest over SSH, a clean machine every run, screens in the guest.
 - [Isolation and permissions](https://github.com/crftwr/quality-loop/blob/main/docs/isolation.md): what keeps the room, the
   operator and the conductor in bounds, why each rule exists, and the known limits.
 - [Development](https://github.com/crftwr/quality-loop/blob/main/docs/development.md): tests, live tests, releasing.

{quality_loop-0.3.0 → quality_loop-0.4.1}/README.md

@@ -79,6 +79,8 @@ under a policy the person sets. See [Running the loop](https://github.com/crftwr
   launch command and a redirected home up to evidence tools of its own.
 - [Reports](https://github.com/crftwr/quality-loop/blob/main/docs/reports.md): problems, severities, kinds and ids, the
   reproduction record, and `FINDINGS.md` / `findings.json`.
+- [Running the app in a VM](https://github.com/crftwr/quality-loop/blob/main/docs/guests.md): one image per OS,
+  the guest over SSH, a clean machine every run, screens in the guest.
 - [Isolation and permissions](https://github.com/crftwr/quality-loop/blob/main/docs/isolation.md): what keeps the room, the
   operator and the conductor in bounds, why each rule exists, and the known limits.
 - [Development](https://github.com/crftwr/quality-loop/blob/main/docs/development.md): tests, live tests, releasing.

{quality_loop-0.3.0 → quality_loop-0.4.1}/quality_loop/__init__.py

@@ -12,4 +12,4 @@ room is handed, putting the user's machine back - is code here, not an
 agent's discretion.
 """
 
-__version__ = "0.3.0"
+__version__ = "0.4.1"

quality_loop-0.4.1/quality_loop/awake.py

@@ -0,0 +1,85 @@
+"""This machine kept from idle sleep while a run is going (issue #16).
+
+A run is mostly waiting - on a session, on a VM - and a machine left alone
+for it goes to sleep: a Mac on battery within minutes. Nothing fails; the
+run just stops while it sleeps, and a VM guest stops with it. One run of
+43 minutes had spent 40 of them asleep.
+
+So the runner holds the platform's "the system is busy" assertion for the
+length of the run, and lets go when it ends. The display may still sleep,
+and closing a laptop's lid still sleeps it: those are the person's to choose.
+
+- macOS: ``caffeinate -i -w <this pid>``, which also ends with this process
+  if it dies without letting go.
+- Windows: ``SetThreadExecutionState(ES_CONTINUOUS | ES_SYSTEM_REQUIRED)``
+  from the runner's thread, cleared at the end (and by Windows when the
+  process exits).
+- Elsewhere nothing is held.
+"""
+
+from __future__ import annotations
+
+import contextlib
+import os
+import shutil
+import subprocess
+import sys
+
+ES_CONTINUOUS = 0x80000000
+ES_SYSTEM_REQUIRED = 0x00000001
+
+
+@contextlib.contextmanager
+def held(say=print):
+    """Idle sleep held off for the ``with`` block, where the platform allows."""
+    release = _hold()
+    if release is None:
+        yield False
+        return
+    say("awake:   idle sleep is held off for the run (closing the lid still sleeps it)")
+    try:
+        yield True
+    finally:
+        release()
+
+
+def _hold():
+    if sys.platform == "darwin":
+        return _hold_mac()
+    if os.name == "nt":
+        return _hold_windows()
+    return None
+
+
+def _hold_mac():
+    caffeinate = shutil.which("caffeinate")
+    if caffeinate is None:
+        return None
+    try:
+        process = subprocess.Popen([caffeinate, "-i", "-w", str(os.getpid())],
+                                   stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL,
+                                   stderr=subprocess.DEVNULL)
+    except OSError:
+        return None
+
+    def release():
+        process.terminate()
+        try:
+            process.wait(5)
+        except subprocess.TimeoutExpired:
+            process.kill()
+
+    return release
+
+
+def _hold_windows():
+    import ctypes
+    try:
+        kernel32 = ctypes.WinDLL("kernel32")
+    except OSError:
+        return None
+    kernel32.SetThreadExecutionState.restype = ctypes.c_uint
+    kernel32.SetThreadExecutionState.argtypes = [ctypes.c_uint]
+    if not kernel32.SetThreadExecutionState(ES_CONTINUOUS | ES_SYSTEM_REQUIRED):
+        return None
+    return lambda: kernel32.SetThreadExecutionState(ES_CONTINUOUS)