| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173 |
- """One summary of this machine and its OS account, for the desktop first-run onboarding.
- Hardware facts come from ``hermes_platform.host``. Account facts (full name, locale) come from OS
- user records through ``pwd`` or Win32/CoreFoundation calls, never from environment variables such
- as HOME or LANG, and never from a subprocess or the network. They describe the machine that runs
- the Hermes backend; when the desktop app drives a remote backend, that is not the user's laptop.
- """
- from __future__ import annotations
- import functools
- import os
- import platform
- import re
- import sys
- from hermes_platform.host import facts as host
- from hermes_platform.host import products, runtime
- # Generic account names that are not a person's name.
- _NON_NAMES = frozenset({
- "admin", "administrator", "default", "guest", "me", "owner", "root", "test", "user",
- })
- _HANDLE_CHARS = re.compile(r"[\d_@/\\]")
- # --- account facts -----------------------------------------------------------------
- def _posix_account() -> tuple[str, str]:
- """Return (login, full name) from the user database."""
- import pwd
- entry = pwd.getpwuid(os.getuid()) # windows-footgun: ok — only called off Windows (_account)
- return entry.pw_name, entry.pw_gecos.split(",", 1)[0].strip()
- def _windows_account() -> tuple[str, str]:
- """Return (login, display name) from Win32 account APIs."""
- import ctypes
- from ctypes import wintypes
- login_buf = ctypes.create_unicode_buffer(257)
- login_len = wintypes.DWORD(len(login_buf))
- login = login_buf.value if ctypes.windll.advapi32.GetUserNameW(login_buf, ctypes.byref(login_len)) else ""
- # EXTENDED_NAME_FORMAT NameDisplay = 3. Local accounts without a display name fail here.
- name_buf = ctypes.create_unicode_buffer(257)
- name_len = wintypes.ULONG(len(name_buf))
- full = name_buf.value if ctypes.windll.secur32.GetUserNameExW(3, name_buf, ctypes.byref(name_len)) else ""
- return login, full
- def _account() -> tuple[str, str]:
- try:
- return _windows_account() if sys.platform == "win32" else _posix_account()
- except (AttributeError, ImportError, KeyError, OSError):
- return "", ""
- def full_name_from(login: str, full: str) -> str | None:
- """A real full name only; a login handle is never offered as the user's name."""
- name = " ".join(full.split())
- if not (2 <= len(name) <= 40) or name.lower() in _NON_NAMES or name.lower() == login.lower():
- return None
- # Digits or underscores ("p14", "CD_01.05") or an all-lowercase cased name mark a handle.
- if _HANDLE_CHARS.search(name) or name == name.lower() != name.upper():
- return None
- return name
- def _darwin_locale() -> str:
- """First preferred UI language, e.g. ``de-DE``, via CoreFoundation."""
- import ctypes
- import ctypes.util
- cf = ctypes.CDLL(ctypes.util.find_library("CoreFoundation"))
- cf.CFLocaleCopyPreferredLanguages.restype = ctypes.c_void_p
- cf.CFArrayGetCount.argtypes = [ctypes.c_void_p]
- cf.CFArrayGetCount.restype = ctypes.c_long
- cf.CFArrayGetValueAtIndex.argtypes = [ctypes.c_void_p, ctypes.c_long]
- cf.CFArrayGetValueAtIndex.restype = ctypes.c_void_p
- cf.CFStringGetCString.argtypes = [ctypes.c_void_p, ctypes.c_char_p, ctypes.c_long, ctypes.c_uint32]
- cf.CFStringGetCString.restype = ctypes.c_bool
- cf.CFRelease.argtypes = [ctypes.c_void_p]
- languages = cf.CFLocaleCopyPreferredLanguages()
- if not languages:
- return ""
- try:
- if cf.CFArrayGetCount(languages) < 1:
- return ""
- buffer = ctypes.create_string_buffer(64)
- # kCFStringEncodingUTF8
- if not cf.CFStringGetCString(cf.CFArrayGetValueAtIndex(languages, 0), buffer, 64, 0x08000100):
- return ""
- return buffer.value.decode()
- finally:
- cf.CFRelease(languages)
- def _windows_locale() -> str:
- import ctypes
- buffer = ctypes.create_unicode_buffer(85)
- return buffer.value if ctypes.windll.kernel32.GetUserDefaultLocaleName(buffer, 85) else ""
- def _linux_locale() -> str:
- """System locale from its config file; the shell's LANG is deliberately not read."""
- for path in ("/etc/locale.conf", "/etc/default/locale"):
- try:
- with open(path, encoding="utf-8-sig") as handle:
- for line in handle:
- key, _, value = line.strip().partition("=")
- if key == "LANG" and value:
- return value.strip("\"'").split(".", 1)[0].replace("_", "-")
- except OSError:
- continue
- return ""
- def _locale() -> str:
- try:
- if sys.platform == "darwin":
- return _darwin_locale()
- if sys.platform == "win32":
- return _windows_locale()
- return _linux_locale()
- except (AttributeError, OSError, TypeError, ValueError):
- return ""
- # --- the summary ----------------------------------------------------------------------
- def _machine_kind(os_family: str, nvidia: str | None) -> str:
- if nvidia in ("rtx_spark", "dgx_spark"):
- return "Spark"
- return {"darwin": "Mac", "win32": "PC"}.get(os_family, "computer")
- def _os_release(os_family: str) -> str:
- # On a Mac platform.release() is the Darwin kernel version (25.x), not the macOS version (26.x).
- return (platform.mac_ver()[0] if os_family == "darwin" else "") or platform.release()
- @functools.cache
- def summary() -> dict:
- """This machine and account as measured. ``machine`` leaves out a key that was not measured;
- ``locale`` and ``full_name`` are None when the OS has none to give."""
- os_family, arch, gpu, cpu = host.os_family(), host.native_arch(), host.gpu_class(), host.cpu_model()
- ram = host.ram_total_bytes()
- nvidia = products.nvidia_platform()
- machine = {
- "os_family": os_family,
- "os_release": _os_release(os_family),
- "native_arch": arch,
- "cpu_model": cpu,
- "ram_gb": round(ram / 2**30) if ram else None,
- "gpu_class": None if gpu == "unknown" else gpu,
- "vendor": host.cpu_vendor(),
- "wsl": runtime.is_wsl(),
- "container": runtime.is_container(),
- }
- return {
- "machine": {key: value for key, value in machine.items() if value not in (None, "")},
- "machine_kind": _machine_kind(os_family, nvidia),
- "has_nvidia_gpu": gpu == "nvidia",
- "nvidia_platform": nvidia,
- "locale": _locale() or None,
- "full_name": full_name_from(*_account()),
- }
|