s-librarykit 0.1.0__tar.gz

s_librarykit-0.1.0/.gitignore

@@ -0,0 +1,47 @@
+# === 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

s_librarykit-0.1.0/AGENTS.md

@@ -0,0 +1,38 @@
+# AGENTS.md — librarykit
+
+> Контекст для AI-ассистентов (Claude Code, ChatGPT, Cursor и т.п.), работающих
+> над этим проектом.
+
+## Что это
+
+Pure-stdlib кит-дедупликатор: checkpoint/resume, error-иерархия, self-heal-классификатор, secure-store, config-утили (deep_merge/interpolate_env/atomic_write/slugify), base RetryPolicy, pagination — общий код вместо копипасты в clikit/adapterkit/reverse-factory
+
+## Atlas
+
+Проект зарегистрирован в Atlas-БД (NP-005). Карточка:
+
+```sh
+atlas projects get librarykit
+```
+
+Любые изменения метаданных (приоритет, статус, теги) — через atlas CLI:
+
+- `atlas projects update librarykit --priority P0` — поменять приоритет
+- `atlas add-tags librarykit -t domain:<slug>` — добавить тег
+- `atlas projects move librarykit --to-type <type>` — конвертировать тип
+
+## Тип / Статус (на момент создания)
+
+- type=`shared-infrastructure`, status=`experiment`, priority=`P1`
+
+## Правила работы
+
+- Все исходные тексты, документы, код проекта — в этом репо.
+- Чувствительные данные (`.env`, токены, ключи) — игнорируются `.gitignore`.
+- AI-ассистенту разрешено: читать, генерировать, редактировать в этом репо.
+
+## Канонические команды
+
+- `atlas projects get librarykit` — карточка проекта
+- `atlas pm-tasks list --project librarykit` — задачи проекта (когда W7
+  волна будет реализована)

s_librarykit-0.1.0/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_librarykit-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: s-librarykit
+Version: 0.1.0
+Summary: Жирный КОРЕНЬ китов: единая error-иерархия, config/retry/paths-утили, checkpoint/resume — общий код для clikit/adapterkit/reverse-factory.
+Author: Dmitry
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: cryptography>=43
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=25.0
+Requires-Dist: oschmod>=0.3
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: stamina>=24.3
+Requires-Dist: tomli-w>=1.0
+Provides-Extra: antibot
+Requires-Dist: curl-cffi>=0.7; extra == 'antibot'
+Provides-Extra: browser
+Requires-Dist: playwright>=1.40; extra == 'browser'
+Provides-Extra: dev
+Requires-Dist: hypothesis>=6; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Provides-Extra: oauth
+Requires-Dist: authlib>=1.3; extra == 'oauth'
+Provides-Extra: ws
+Requires-Dist: websockets>=12.0; extra == 'ws'
+Description-Content-Type: text/markdown
+
+# librarykit
+
+> Pure-stdlib кит-дедупликатор: checkpoint/resume, error-иерархия, self-heal-классификатор, secure-store, config-утили (deep_merge/interpolate_env/atomic_write/slugify), base RetryPolicy, pagination — общий код вместо копипасты в clikit/adapterkit/reverse-factory
+
+## Статус
+
+- **Type**: `shared-infrastructure`
+- **Status**: `experiment`
+- **Priority**: P1
+- **Slug**: `librarykit`
+- **Prefix**: `lib`
+- **Tags**: —
+- Создан: 2026-06-22
+
+## Atlas
+
+Карточка проекта в Atlas-БД (NP-005):
+
+```sh
+atlas projects get librarykit
+```
+
+Физический layout:
+
+- Storage: `_storage/librarykit/`
+- Junction: `Products\librarykit` → `_storage/librarykit`
+
+## Состав (lib-E1)
+
+Ядро — **только stdlib**, без runtime-зависимостей.
+
+- `librarykit.checkpoint` — `Checkpoint` (атомарный JSON-state),
+  `JsonlSink` (append-only forensic-лог), `RunMetrics` (таймер + счётчики).
+- `librarykit.errors` — базовая иерархия `ApiError` + подклассы
+  (`AuthRequired` 401/403, `NotFoundError` 404, `RateLimited` 429,
+  `ValidationError` 4xx, `ServerError` 5xx, `TransportError`) + `RETRYABLE`.
+- `librarykit.config_util` — `deep_merge`, `interpolate_env`, `load_dotenv`,
+  `atomic_write_text`, `slugify`.
+
+## Установка / тесты
+
+```sh
+uv sync --extra dev
+uv run --extra dev pytest -q
+```
+
+## Лицензия
+
+MIT, (c) 2026 Dmitry.
+
+## TODO
+
+- [ ] Подключить GitLab-репозиторий (если ещё нет): `atlas projects git init librarykit`.
+- [ ] Шаг 3+ эпика lib-E1: заменить импорты в clikit/rf на librarykit.

s_librarykit-0.1.0/README.md

@@ -0,0 +1,54 @@
+# librarykit
+
+> Pure-stdlib кит-дедупликатор: checkpoint/resume, error-иерархия, self-heal-классификатор, secure-store, config-утили (deep_merge/interpolate_env/atomic_write/slugify), base RetryPolicy, pagination — общий код вместо копипасты в clikit/adapterkit/reverse-factory
+
+## Статус
+
+- **Type**: `shared-infrastructure`
+- **Status**: `experiment`
+- **Priority**: P1
+- **Slug**: `librarykit`
+- **Prefix**: `lib`
+- **Tags**: —
+- Создан: 2026-06-22
+
+## Atlas
+
+Карточка проекта в Atlas-БД (NP-005):
+
+```sh
+atlas projects get librarykit
+```
+
+Физический layout:
+
+- Storage: `_storage/librarykit/`
+- Junction: `Products\librarykit` → `_storage/librarykit`
+
+## Состав (lib-E1)
+
+Ядро — **только stdlib**, без runtime-зависимостей.
+
+- `librarykit.checkpoint` — `Checkpoint` (атомарный JSON-state),
+  `JsonlSink` (append-only forensic-лог), `RunMetrics` (таймер + счётчики).
+- `librarykit.errors` — базовая иерархия `ApiError` + подклассы
+  (`AuthRequired` 401/403, `NotFoundError` 404, `RateLimited` 429,
+  `ValidationError` 4xx, `ServerError` 5xx, `TransportError`) + `RETRYABLE`.
+- `librarykit.config_util` — `deep_merge`, `interpolate_env`, `load_dotenv`,
+  `atomic_write_text`, `slugify`.
+
+## Установка / тесты
+
+```sh
+uv sync --extra dev
+uv run --extra dev pytest -q
+```
+
+## Лицензия
+
+MIT, (c) 2026 Dmitry.
+
+## TODO
+
+- [ ] Подключить GitLab-репозиторий (если ещё нет): `atlas projects git init librarykit`.
+- [ ] Шаг 3+ эпика lib-E1: заменить импорты в clikit/rf на librarykit.

s_librarykit-0.1.0/librarykit/__init__.py

@@ -0,0 +1,238 @@
+"""librarykit — жирный КОРЕНЬ китов (граф librarykit <- adapterkit <- clikit).
+
+Общий код вместо дублирования в clikit/adapterkit/reverse-factory: единая
+error-иерархия (ERROR-HUB), config/paths-утили, политики повторов, checkpoint.
+Почти-stdlib (единственная не-stdlib зависимость — platformdirs для AppPaths).
+"""
+
+from __future__ import annotations
+
+from librarykit.auth import (
+    BrowserLoginAuth,
+    CookieSessionAuth,
+    OAuth2Auth,
+    TokenAuth,
+    decrypt_settings,
+    dump_settings,
+    encrypt_settings,
+    load_settings,
+)
+from librarykit.checkpoint import Checkpoint, JsonlSink, RunMetrics
+from librarykit.config_util import (
+    AppPaths,
+    atomic_write_text,
+    chmod_600,
+    deep_merge,
+    interpolate_env,
+    load_dotenv,
+    normalize_account_id,
+    slugify,
+)
+from librarykit.contract import (
+    Auth,
+    AuthMode,
+    Codec,
+    Creds,
+    ErrorMapper,
+    PaginationMode,
+    Paginator,
+    Refreshable,
+    RequestBody,
+    ResponseLike,
+    SessionRef,
+    SessionStoreProtocol,
+    StreamTransport,
+    Transport,
+    TransportKind,
+)
+from librarykit.entities import (
+    HealthReport,
+    Session,
+    SessionChanges,
+    SessionContext,
+)
+from librarykit.errmap import (
+    DEFAULT_ERROR_MAP,
+    AuthExpired,
+    BodyRule,
+    ErrorMap,
+    ErrorMapBuilder,
+    ExcFactory,
+    build_error_map,
+)
+from librarykit.errors import (
+    RETRYABLE,
+    AdapterError,
+    ApiError,
+    AuthRequired,
+    Blocked,
+    CliError,
+    NotFound,
+    NotFoundError,
+    NotImplementedYet,
+    RateLimited,
+    ServerError,
+    SessionExpired,
+    TransportError,
+    ValidationError,
+)
+from librarykit.pagination import (
+    DEFAULT_PAGE_PARAMS,
+    CursorExtractor,
+    CursorPaginator,
+    ItemsExtractor,
+    PageParams,
+    default_extract_cursor,
+    default_extract_items,
+    with_page_params,
+)
+from librarykit.protocols import (
+    HealthProtocol,
+    HealthState,
+    HealthStatus,
+    InteractiveFlow,
+    LoginMode,
+    LoginRequirements,
+    OnboardingProtocol,
+)
+from librarykit.retry import (
+    DEFAULT_RETRY,
+    DEFAULT_SIMPLE_RETRY,
+    RetryPolicy,
+    SimpleRetryPolicy,
+)
+
+# Мультипротокол (E1): RPC codec-слой (rpc) + stream-транспорты (stream). WS-
+# reference (`WebSocketsStreamTransport`) тянет extra [ws] lazy ВНУТРИ конструктора,
+# поэтому реэкспорт безопасен — `import librarykit` без extra не падает.
+from librarykit.rpc import JsonCodec, PrefixedJsonCodec, RpcClient
+from librarykit.secret_store import SecretStore
+from librarykit.sessions import (
+    KekUnavailableError,
+    SessionStore,
+    SessionStoreError,
+    resolve_kek,
+)
+from librarykit.stream import (
+    StreamClosedError,
+    StubStreamTransport,
+    WebSocketsStreamTransport,
+)
+
+# Транспортный слой (W4): choke-point `HttpClient` + конкретный `HttpxTransport`.
+# `RestHttpClient`/`ApiError`/`RefreshCallback` НЕ ре-экспортируются на верхний
+# уровень — у librarykit.errors уже есть свой `ApiError` (алиас CliError), и REST-
+# клиент берётся адресно из `librarykit.transport` (его тянет shim clikit.transport).
+from librarykit.transport import HttpClient, HttpxTransport
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    # checkpoint
+    "Checkpoint",
+    "JsonlSink",
+    "RunMetrics",
+    # errors (единая иерархия ERROR-HUB)
+    "CliError",
+    "ApiError",
+    "AuthRequired",
+    "SessionExpired",
+    "RateLimited",
+    "ValidationError",
+    "NotImplementedYet",
+    "NotFoundError",
+    "ServerError",
+    "TransportError",
+    "Blocked",
+    "RETRYABLE",
+    "AdapterError",
+    "NotFound",
+    # config_util / paths
+    "deep_merge",
+    "interpolate_env",
+    "load_dotenv",
+    "slugify",
+    "normalize_account_id",
+    "atomic_write_text",
+    "chmod_600",
+    "AppPaths",
+    # contract — generic «талия» (Protocol + enums + DTO координат сессии/кредов)
+    "PaginationMode",
+    "AuthMode",
+    "TransportKind",
+    "SessionRef",
+    "Creds",
+    "RequestBody",
+    "ResponseLike",
+    "Transport",
+    "StreamTransport",
+    "Codec",
+    "Auth",
+    "Refreshable",
+    "ErrorMapper",
+    "Paginator",
+    "SessionStoreProtocol",
+    # protocols — онбординг/health контракты (опциональные)
+    "LoginMode",
+    "LoginRequirements",
+    "InteractiveFlow",
+    "OnboardingProtocol",
+    "HealthState",
+    "HealthStatus",
+    "HealthProtocol",
+    # entities (W6) — нейтральные data-классы оркестраторов (почва под W7)
+    "Session",
+    "SessionChanges",
+    "SessionContext",
+    "HealthReport",
+    # secret_store — keyring + file-fallback
+    "SecretStore",
+    # sessions (W4): envelope-шифрованное хранилище сессий (spec §4)
+    "SessionStore",
+    "SessionStoreError",
+    "KekUnavailableError",
+    "resolve_kek",
+    # transport (W4): конкретный httpx-транспорт + choke-point клиент
+    "HttpxTransport",
+    "HttpClient",
+    # rpc (E1): codec-слой + RPC choke-point поверх HttpClient
+    "JsonCodec",
+    "PrefixedJsonCodec",
+    "RpcClient",
+    # stream (E1): WS-подобные persistent-транспорты (Stub + websockets reference)
+    "StubStreamTransport",
+    "WebSocketsStreamTransport",
+    "StreamClosedError",
+    # errmap (W4): декларативная карта HTTP-ответ → доменная ошибка
+    "ErrorMap",
+    "ErrorMapBuilder",
+    "BodyRule",
+    "ExcFactory",
+    "AuthExpired",
+    "build_error_map",
+    "DEFAULT_ERROR_MAP",
+    # pagination (W4): листатель ресурса (offset/cursor/page) tweepy-стиля
+    "CursorPaginator",
+    "PageParams",
+    "DEFAULT_PAGE_PARAMS",
+    "ItemsExtractor",
+    "CursorExtractor",
+    "default_extract_items",
+    "default_extract_cursor",
+    "with_page_params",
+    # auth (W4): стратегии авторизации + персистентность сессии
+    "TokenAuth",
+    "CookieSessionAuth",
+    "OAuth2Auth",
+    "BrowserLoginAuth",
+    "dump_settings",
+    "load_settings",
+    "encrypt_settings",
+    "decrypt_settings",
+    # retry
+    "RetryPolicy",
+    "DEFAULT_RETRY",
+    "SimpleRetryPolicy",
+    "DEFAULT_SIMPLE_RETRY",
+]