init: raw cpuid/rdtsc access via ctypes

docs/api.md

@@ -0,0 +1,25 @@
+# api
+
+## `cpuid(leaf: int, subleaf: int = 0) -> tuple[int, int, int, int]`
+
+сырой вызов инструкции `CPUID`, возвращает `(eax, ebx, ecx, edx)`.
+
+## `rdtsc() -> int`
+
+сырое значение счётчика тактов процессора (инструкция `RDTSC`), монотонно растёт.
+
+## `vendor() -> str`
+
+строка вендора CPU, например `GenuineIntel` или `AuthenticAMD`.
+
+## `brand() -> str`
+
+полная строка модели процессора из расширенных leaf'ов CPUID.
+
+## `has_feature(name: str) -> bool`
+
+проверка бита фичи в CPUID без риска упасть на CPU без её поддержки. кидает `ValueError` если имя не из `FEATURES`.
+
+## `FEATURES: dict[str, tuple[int, str, int]]`
+
+словарь `имя -> (leaf, регистр, номер бита)`. поддерживаются: `sse`, `sse2`, `sse3`, `ssse3`, `fma`, `sse4_1`, `sse4_2`, `popcnt`, `aes`, `avx`, `rdrnd`, `avx2`, `avx512f`.