Skip to content

utils

diapason.core.utils

Small cross-platform utilities used by the CLI, OAuth flow, and evals.

Kept dependency-free so importing this module is cheap (the public re-export from diapason.core must not pull in heavy modules at package init).

get_python_executable()

Return the best python interpreter name on PATH.

Prefers python3 (Linux/macOS convention); falls back to python (Windows / some minimal Linux distros that ship only python). Returns the literal string "python3" when neither is found, so callers still get a usable command that will fail with a clear "command not found" rather than an empty string.

The result is a command name or absolute path that callers can hand to :mod:subprocess directly when shell=False, and must be shell-quoted (:func:shlex.quote) before being interpolated into a shell=True command string — paths on Windows often contain spaces.

now_in(timezone_name='')

L'heure courante DANS le fuseau nommé, ou celle de cette machine.

Trois agents ont besoin de la même chose, et s'étaient trompés de la même façon : afficher l'heure de la MACHINE sous le nom du fuseau CONFIGURÉ. Quand les deux diffèrent, c'est pire qu'une heure fausse — l'heure est juste et l'étiquette ment, donc rien ne permet de s'en apercevoir. Le résultat est toujours aware, et il porte son vrai fuseau : de quoi étiqueter honnêtement ce qu'on affiche.

timezone_name vide signifie « cette machine », qui est le bon défaut pour un assistant local-first : il ne sait pas où vit la personne, et supposer une ville produit une heure fausse énoncée avec assurance.

Le repli est explicite : un fuseau mal orthographié dans la configuration ne doit pas faire échouer un briefing du matin.

open_browser(url)

Open url in the user's default browser, with a Windows fast-path.

:func:webbrowser.open is the cross-platform default, but on Windows it sometimes blocks or fails inside a console host. cmd /c start "" "URL" is the canonical Windows incantation that hands the URL to the OS shell and returns immediately. We try that first on Windows and fall back to :func:webbrowser.open if the subprocess spawn fails.