s-corekit — основание экосистемы китов

Значения и чистые правила, на которые опираются остальные пакеты семейства: контекст исполнения, базовые DTO, единая иерархия ошибок, маскировка секретов и классификация состояния доступа. Ноль зависимостей — только stdlib.

     clikit        adapterkit      ветки-оболочки (CLI, адаптеры сервисов)
          \           /
           librarykit             оркестратор (сеть, сессии, браузер)
                |
             corekit              основание (значения и правила)

Установка

pip install s-corekit

Импортируется как corekit. Требуется Python 3.11+.

Быстрый старт

from corekit import ExecutionContext, classify_access, AccessState
from corekit import sanitize_headers, scrub_credentials, RETRYABLE

# 1. Контекст вызова: чей он и под каким профилем идёт.
ctx = ExecutionContext(tenant="acme", profile="main")
ctx.tenant_id, ctx.profile_name          # ('acme', 'main')

# 2. Диагноз по УЛИКЕ, без единого сетевого запроса:
#    200 OK, но конечный URL — страница входа => сессия мертва.
verdict = classify_access(status=200, final_url="https://accounts.google.com/ServiceLogin")
verdict.state                            # AccessState.SESSION_DEAD
verdict.why                              # "сервер оценил куки и увёл на вход (улика: ...)"
verdict.evidence                         # исходная улика, на которой стоит вердикт

# 3. Секреты не утекают в логи.
sanitize_headers({"Authorization": "Bearer ...", "X-Trace": "1"})
# {'authorization': '***', 'x-trace': '1'}
scrub_credentials("socks5://user:pass@127.0.0.1:1080 недоступен")
# 'socks5://***@127.0.0.1:1080 недоступен'

# 4. Одна иерархия ошибок на весь стек + готовый набор «можно повторить».
RETRYABLE                                # (RateLimited, ServerError, TransportError)

Что внутри

Персона: противоречие вместо отпечатка

from corekit import ClientPersona

persona = ClientPersona(
    persona_id="acc-42:gemini", version=1,
    browser="chrome", browser_version="151.0.7922.76",
    platform="Windows", platform_version="15.0.0",
    architecture="x86", bitness="64", mobile=False, model="",
    accept_language="ru-RU,ru;q=0.9", locale="ru-RU", timezone="Europe/Moscow",
    screen=(1920, 1080), viewport=(1536, 864),
    tls_target="chrome146", http_version="http/1.1",
    egress_country="FI", egress_kind="datacenter",
)

for item in persona.inconsistencies():
    print(item.severity, item.code, item.layers)
# error   tls-behind-ua           ('tls', 'user-agent')
# error   http-version-mismatch   ('http', 'user-agent')
# error   timezone-vs-egress      ('timezone', 'egress')
# warning language-vs-egress      ('accept-language', 'egress')
# warning egress-datacenter       ('egress',)

persona.is_consistent()  # False — ошибки уровня error есть

Каждый слой здесь корректен ПОРОЗНЬ, и ловят нас не они, а стыки: рукопожатие 146-го Chrome под заголовками 151-го, HTTP/1.1 под современным Chrome, московские часы при финском выходе. Согласованная персона не возвращает НИЧЕГО — ни одного предупреждения «на всякий случай».

Правило отбора

В основание попадает сущность, которая не тянет реализацию: неизменяемое значение или чистая функция над текстом/статусом. Всё, у чего есть жизненный цикл (клиенты, сторы, браузеры, локи), живёт слоем выше — в s-librarykit.

Поэтому зависимостей нет и не будет: dependencies = [] закреплено тестом tests/test_stdlib_only.py. Основание обязано ставиться и туда, где httpx, pydantic или cryptography поставить нельзя.

Совместимость с librarykit

Начиная с s-librarykit 0.7.6 модули librarykit.contract, librarykit.errors, librarykit.redaction и librarykit.diagnosis.* — тонкие реэкспорты этого пакета. Они отдают те же объекты, а не копии, поэтому isinstance, except и сравнение через is работают через любой путь импорта:

from librarykit.errors import CliError as ViaLibrarykit
from corekit.errors import CliError as ViaCorekit
assert ViaLibrarykit is ViaCorekit

Существующий код, импортирующий эти имена из librarykit, менять не нужно.

Цена импорта (замер, а не обещание)

Python 3.14, Windows, холодный интерпретатор, 3 прогона:

Тест меряет цену над полом: абсолютное число описывает машину, а не код, и абсолютный порог пришлось бы задрать так, что приехавший httpx (264 мс) прошёл бы незамеченным.

Лицензия

MIT — см. LICENSE.