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`.

docs/quickstart.md

@@ -0,0 +1,48 @@
+# quickstart
+
+## установка
+
+```
+pip install rawcpu
+```
+
+## узнать процессор
+
+```python
+import rawcpu
+
+print(rawcpu.vendor())  # GenuineIntel / AuthenticAMD
+print(rawcpu.brand())   # полная строка модели
+```
+
+## проверить фичи перед SIMD-кодом
+
+```python
+if rawcpu.has_feature("avx2"):
+    # можно грузить AVX2-путь
+    ...
+else:
+    # fallback
+    ...
+```
+
+список доступных имён — `rawcpu.FEATURES`.
+
+## точный замер тактов
+
+`time.perf_counter()` меряет время через ОС, `rdtsc()` — реальные такты процессора напрямую:
+
+```python
+start = rawcpu.rdtsc()
+do_something()
+end = rawcpu.rdtsc()
+print(end - start, "cycles")
+```
+
+## сырой cpuid
+
+```python
+eax, ebx, ecx, edx = rawcpu.cpuid(leaf=7, subleaf=0)
+```
+
+leaf/subleaf — как в интеловской документации по CPUID.