s-corekit 0.0.1__tar.gz

s_corekit-0.0.1/.gitignore

@@ -0,0 +1,50 @@
+# === atlas universal gitignore ===
+
+# OS / IDE
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Sensitive
+.env
+.env.local
+*.key
+*.pem
+secrets/
+private/
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+
+# Node / JS
+node_modules/
+.next/
+dist/
+build/
+
+# Temporary / large
+*.log
+*.tmp
+nul
+NUL
+*.zip
+*.rar
+*.7z
+
+# Media (selectively unignore via !path/*.ext if needed for fixtures)
+*.mp4
+*.mov
+*.avi
+*.mkv
+
+# git worktrees (агентские)
+.worktrees/

s_corekit-0.0.1/.gitlab-ci.yml

@@ -0,0 +1,32 @@
+# Автопубликация на PyPI по семвер-тегу vX.Y.Z через Trusted Publishing (OIDC).
+# Токены НИГДЕ не хранятся: GitLab выдаёт короткоживущий OIDC-токен (PYPI_ID_TOKEN),
+# он одноразово обменивается на PyPI API-токен. Издатель настраивается на pypi.org:
+#   Manage -> Publishing -> GitLab  (namespace=cifropro1/products, project=corekit,
+#   top-level pipeline file=.gitlab-ci.yml, environment — пусто).
+# Дистрибутив на PyPI: s-corekit.
+# Запускается ТОЛЬКО на тег vX.Y.Z (обычный push на main ничего не публикует).
+stages: [publish]
+
+publish-pypi:
+  stage: publish
+  image: ghcr.io/astral-sh/uv:python3.12-bookworm
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+  script:
+    - uv build
+    # обмен GitLab OIDC -> одноразовый PyPI API-токен (Trusted Publishing):
+    - |
+      export UV_PUBLISH_TOKEN=$(python3 - <<'PY'
+      import json, os, urllib.request
+      req = urllib.request.Request(
+          "https://pypi.org/_/oidc/mint-token",
+          data=json.dumps({"token": os.environ["PYPI_ID_TOKEN"]}).encode(),
+          headers={"Content-Type": "application/json"},
+      )
+      print(json.load(urllib.request.urlopen(req))["token"])
+      PY
+      )
+    - uv publish

s_corekit-0.0.1/CHANGELOG.md

@@ -0,0 +1,25 @@
+# CHANGELOG — s-corekit
+
+## 0.0.1 — выделение основания
+
+Первый выпуск. Пакет собран ПЕРЕНОСОМ, а не написанием заново: код взят из
+`librarykit` без изменения поведения, а `librarykit` переведён на тонкие
+реэкспорты, чтобы существующие импорты потребителей продолжили работать без
+единой правки.
+
+Перенесено:
+
+- `corekit.context` — `ExecutionContext` (синонимы имён обеих школ, строгий
+  отказ при конфликте значений, `evolve`, явный `__hash__`, запечатанная
+  заморозка) + `DEFAULT_TENANT`;
+- `corekit.dto` — `SessionRef`, `Creds`, `RequestBody`;
+- `corekit.limits` — `QuotaScope`, `QuotaInfo`, `LimitSpec`;
+- `corekit.enums` — `PaginationMode`, `AuthMode`, `TransportKind`
+  (+ ролевой псевдоним `RequestExecutionMode`);
+- `corekit.errors` — вся иерархия исключений и `RETRYABLE`;
+- `corekit.redaction` — маскирование секретов (нужно диагностике);
+- `corekit.diagnosis` — `verdict` (таксономия `Reason`/`Verdict` и порядок
+  разбора), `egress` (разбор текста ошибки), `access` (`AccessState`/
+  `AccessVerdict`/`classify_access`).
+
+Зависимостей нет: `dependencies = []`.

s_corekit-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dmitry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

s_corekit-0.0.1/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: s-corekit
+Version: 0.0.1
+Summary: ОСНОВАНИЕ китов: ExecutionContext, базовые DTO (SessionRef/Creds/LimitSpec/QuotaInfo), единая иерархия ошибок и чистая классификация состояния доступа (AccessState/AccessVerdict). Только stdlib.
+Author: Dmitry
+License: MIT
+License-File: LICENSE
+Keywords: diagnostics,dto,errors,execution-context,redaction,stdlib-only
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# s-corekit — основание экосистемы китов
+
+Значения и чистые правила, на которые опираются остальные пакеты семейства:
+контекст исполнения, базовые DTO, единая иерархия ошибок, маскировка секретов и
+классификация состояния доступа. **Ноль зависимостей** — только stdlib.
+
+```
+     clikit        adapterkit      ветки-оболочки (CLI, адаптеры сервисов)
+          \           /
+           librarykit             оркестратор (сеть, сессии, браузер)
+                |
+             corekit              основание (значения и правила)
+```
+
+## Установка
+
+```bash
+pip install s-corekit
+```
+
+Импортируется как `corekit`. Требуется Python 3.11+.
+
+## Быстрый старт
+
+```python
+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)
+```
+
+## Что внутри
+
+| Модуль | Что даёт |
+|---|---|
+| `corekit.context` | `ExecutionContext` — чей вызов, где его состояние, куда он ходит в сеть. Один тип на экосистему: понимает имена обеих школ (`tenant`/`tenant_id`, `profile`/`profile_name`) и отказывается угадывать при конфликте значений |
+| `corekit.dto` | `SessionRef`, `Creds`, `RequestBody` |
+| `corekit.limits` | `QuotaScope`, `QuotaInfo`, `LimitSpec` |
+| `corekit.enums` | `PaginationMode`, `AuthMode`, `TransportKind` / `RequestExecutionMode` |
+| `corekit.errors` | Единая иерархия исключений: `CliError` → `AuthRequired` / `RateLimited` / `Blocked` / `TransportError` / … + кортеж `RETRYABLE` |
+| `corekit.redaction` | Маскировка секретов в заголовках, теле и тексте (`sanitize_headers`, `sanitize_body`, `scrub_credentials`) |
+| `corekit.diagnosis` | Таксономия причин (`Reason`) и состояние доступа (`AccessState`, `AccessVerdict`, `classify_access`) — диагноз по улике, без сети |
+
+## Правило отбора
+
+В основание попадает сущность, которая **не тянет реализацию**: неизменяемое
+значение или чистая функция над текстом/статусом. Всё, у чего есть жизненный
+цикл (клиенты, сторы, браузеры, локи), живёт слоем выше — в `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` работают через любой путь импорта:
+
+```python
+from librarykit.errors import CliError as ViaLibrarykit
+from corekit.errors import CliError as ViaCorekit
+assert ViaLibrarykit is ViaCorekit
+```
+
+Существующий код, импортирующий эти имена из `librarykit`, менять не нужно.
+
+## Цена импорта (замер, а не обещание)
+
+Python 3.14, Windows, холодный интерпретатор, 3 прогона:
+
+| что | мс |
+|---|---|
+| пол stdlib (`dataclasses`+`pathlib`+`enum`+`re`+`json`+`datetime`) | 77-85 |
+| `import corekit` **поверх пола** | 24-30 |
+| `import librarykit` поверх того же пола | 151-162 |
+| полный `import corekit` / `import librarykit` | ~105 / ~246 |
+
+Тест меряет цену **над полом**: абсолютное число описывает машину, а не код, и
+абсолютный порог пришлось бы задрать так, что приехавший `httpx` (264 мс)
+прошёл бы незамеченным.
+
+## Лицензия
+
+MIT — см. [LICENSE](LICENSE).

s_corekit-0.0.1/README.md

@@ -0,0 +1,104 @@
+# s-corekit — основание экосистемы китов
+
+Значения и чистые правила, на которые опираются остальные пакеты семейства:
+контекст исполнения, базовые DTO, единая иерархия ошибок, маскировка секретов и
+классификация состояния доступа. **Ноль зависимостей** — только stdlib.
+
+```
+     clikit        adapterkit      ветки-оболочки (CLI, адаптеры сервисов)
+          \           /
+           librarykit             оркестратор (сеть, сессии, браузер)
+                |
+             corekit              основание (значения и правила)
+```
+
+## Установка
+
+```bash
+pip install s-corekit
+```
+
+Импортируется как `corekit`. Требуется Python 3.11+.
+
+## Быстрый старт
+
+```python
+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)
+```
+
+## Что внутри
+
+| Модуль | Что даёт |
+|---|---|
+| `corekit.context` | `ExecutionContext` — чей вызов, где его состояние, куда он ходит в сеть. Один тип на экосистему: понимает имена обеих школ (`tenant`/`tenant_id`, `profile`/`profile_name`) и отказывается угадывать при конфликте значений |
+| `corekit.dto` | `SessionRef`, `Creds`, `RequestBody` |
+| `corekit.limits` | `QuotaScope`, `QuotaInfo`, `LimitSpec` |
+| `corekit.enums` | `PaginationMode`, `AuthMode`, `TransportKind` / `RequestExecutionMode` |
+| `corekit.errors` | Единая иерархия исключений: `CliError` → `AuthRequired` / `RateLimited` / `Blocked` / `TransportError` / … + кортеж `RETRYABLE` |
+| `corekit.redaction` | Маскировка секретов в заголовках, теле и тексте (`sanitize_headers`, `sanitize_body`, `scrub_credentials`) |
+| `corekit.diagnosis` | Таксономия причин (`Reason`) и состояние доступа (`AccessState`, `AccessVerdict`, `classify_access`) — диагноз по улике, без сети |
+
+## Правило отбора
+
+В основание попадает сущность, которая **не тянет реализацию**: неизменяемое
+значение или чистая функция над текстом/статусом. Всё, у чего есть жизненный
+цикл (клиенты, сторы, браузеры, локи), живёт слоем выше — в `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` работают через любой путь импорта:
+
+```python
+from librarykit.errors import CliError as ViaLibrarykit
+from corekit.errors import CliError as ViaCorekit
+assert ViaLibrarykit is ViaCorekit
+```
+
+Существующий код, импортирующий эти имена из `librarykit`, менять не нужно.
+
+## Цена импорта (замер, а не обещание)
+
+Python 3.14, Windows, холодный интерпретатор, 3 прогона:
+
+| что | мс |
+|---|---|
+| пол stdlib (`dataclasses`+`pathlib`+`enum`+`re`+`json`+`datetime`) | 77-85 |
+| `import corekit` **поверх пола** | 24-30 |
+| `import librarykit` поверх того же пола | 151-162 |
+| полный `import corekit` / `import librarykit` | ~105 / ~246 |
+
+Тест меряет цену **над полом**: абсолютное число описывает машину, а не код, и
+абсолютный порог пришлось бы задрать так, что приехавший `httpx` (264 мс)
+прошёл бы незамеченным.
+
+## Лицензия
+
+MIT — см. [LICENSE](LICENSE).

s_corekit-0.0.1/corekit/__init__.py

@@ -0,0 +1,168 @@
+"""corekit — ОСНОВАНИЕ экосистемы китов. Ноль зависимостей, дешёвый импорт.
+
+ФОРМА ГРАФА::
+
+        clikit          adapterkit          <- ветки-оболочки
+             \\             /
+              \\           /
+               librarykit                   <- ОРКЕСТРАТОР (сеть, сессии, браузер)
+                    |
+                 corekit                    <- ОСНОВАНИЕ (значения и правила)
+
+Что попало в основание и по какому признаку. Ровно одно: **сущность не тянет
+реализацию**. Здесь живут ЗНАЧЕНИЯ и ЧИСТЫЕ ПРАВИЛА — то, что нужно и тому, кто
+поднимает браузер, и тому, кто просто читает конфиг:
+
+* :mod:`corekit.context` — `ExecutionContext`: чей вызов, где его состояние,
+  куда он ходит в сеть. ОДИН на экосистему, с синонимами имён обеих школ
+  (``tenant``/``tenant_id``, ``profile``/``profile_name``);
+* :mod:`corekit.dto` — `SessionRef` / `Creds` / `RequestBody`;
+* :mod:`corekit.limits` — `QuotaScope` / `QuotaInfo` / `LimitSpec`;
+* :mod:`corekit.enums` — `PaginationMode` / `AuthMode` / `TransportKind`;
+* :mod:`corekit.errors` — ЕДИНАЯ иерархия исключений (`CliError` и потомки);
+* :mod:`corekit.redaction` — маскировка секретов в тексте/заголовках/теле;
+* :mod:`corekit.diagnosis` — таксономия причин (`Reason`) и состояние доступа
+  (`AccessState`/`AccessVerdict`) — классификация по УЛИКЕ, без сети.
+
+ЧЕГО ЗДЕСЬ НЕТ И НЕ БУДЕТ: httpx, pydantic, cryptography, keyring, playwright —
+никаких зависимостей вообще (``dependencies = []`` в pyproject, проверено
+тестом). Это не аскеза, а условие: основание ставится туда, где чужие колёса
+поставить нельзя.
+
+ЦЕНА ИМПОРТА (замер, а не обещание; Python 3.14, Windows, холодный
+интерпретатор, 3 прогона). Пол stdlib, который основание тянет законно
+(``dataclasses``/``pathlib``/``enum``/``re``/``json``/``datetime``) — 77-85 мс на
+этой машине. СОБСТВЕННАЯ цена ``import corekit`` поверх этого пола — 24-30 мс;
+для сравнения ``import librarykit`` поверх того же пола — 151-162 мс. Полный
+импорт: corekit ~105 мс против librarykit ~246 мс. Порог зафиксирован тестом
+``tests/test_stdlib_only.py`` и меряется ИМЕННО над полом — абсолютное число
+здесь описывает машину, а не код.
+
+СОВМЕСТИМОСТЬ. Ни одно имя отсюда не «переехало» для потребителя:
+`librarykit.contract`, `librarykit.errors`, `librarykit.redaction` и
+`librarykit.diagnosis.*` реэкспортируют ТЕ ЖЕ объекты (не копии), поэтому
+``isinstance``/``except``/``is``-сравнения работают через любой из путей.
+"""
+from __future__ import annotations
+
+from corekit.context import DEFAULT_TENANT, ExecutionContext
+from corekit.diagnosis import (
+    ACCESS_STATE_MESSAGES,
+    REASON_MESSAGES,
+    REASON_ORDER,
+    REASON_RANK,
+    AccessState,
+    AccessVerdict,
+    Reason,
+    Verdict,
+    classify_access,
+    classify_failure,
+    describe_egress,
+    is_egress_failure,
+    is_launch_failure,
+    resolve,
+    state_from_reason,
+    stronger,
+    verdict_from_error,
+)
+from corekit.dto import Creds, RequestBody, SessionRef
+from corekit.enums import AuthMode, PaginationMode, RequestExecutionMode, TransportKind
+from corekit.errors import (
+    RETRYABLE,
+    AdapterError,
+    ApiError,
+    AuthRequired,
+    Blocked,
+    CliError,
+    GraphQLError,
+    NotFound,
+    NotFoundError,
+    NotImplementedYet,
+    ProcessError,
+    ProfileBroken,
+    RateLimited,
+    ServerError,
+    SessionEgressMismatch,
+    SessionExpired,
+    TransportError,
+    ValidationError,
+)
+from corekit.limits import LimitSpec, QuotaInfo, QuotaScope
+from corekit.redaction import (
+    BODY_FIELD_PATTERNS,
+    HEADER_BLACKLIST,
+    SECRET_MASK,
+    excerpt_response_body,
+    sanitize_body,
+    sanitize_headers,
+    scrub_credentials,
+    truncate_body,
+)
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "__version__",
+    # контекст исполнения
+    "ExecutionContext",
+    "DEFAULT_TENANT",
+    # базовые DTO
+    "SessionRef",
+    "Creds",
+    "RequestBody",
+    # квоты / лимиты
+    "QuotaScope",
+    "QuotaInfo",
+    "LimitSpec",
+    # перечисления «талии»
+    "PaginationMode",
+    "AuthMode",
+    "TransportKind",
+    "RequestExecutionMode",
+    # единая иерархия ошибок
+    "CliError",
+    "ApiError",
+    "AuthRequired",
+    "SessionExpired",
+    "SessionEgressMismatch",
+    "ProfileBroken",
+    "RateLimited",
+    "ValidationError",
+    "NotImplementedYet",
+    "ProcessError",
+    "AdapterError",
+    "TransportError",
+    "NotFound",
+    "NotFoundError",
+    "Blocked",
+    "ServerError",
+    "GraphQLError",
+    "RETRYABLE",
+    # диагностика: причина захода + состояние доступа
+    "Reason",
+    "Verdict",
+    "REASON_ORDER",
+    "REASON_RANK",
+    "REASON_MESSAGES",
+    "resolve",
+    "stronger",
+    "AccessState",
+    "AccessVerdict",
+    "ACCESS_STATE_MESSAGES",
+    "classify_access",
+    "state_from_reason",
+    "classify_failure",
+    "describe_egress",
+    "is_egress_failure",
+    "is_launch_failure",
+    "verdict_from_error",
+    # редакция секретов
+    "SECRET_MASK",
+    "HEADER_BLACKLIST",
+    "BODY_FIELD_PATTERNS",
+    "sanitize_headers",
+    "sanitize_body",
+    "truncate_body",
+    "excerpt_response_body",
+    "scrub_credentials",
+]