librarykit

Жирное ядро экосистемы китов — переиспользуемый фундамент, на котором строятся тонкие надстройки (adapterkit, clikit) и любые доменные пакеты. Вся общая логика живёт здесь один раз, вместо копипасты по проектам: единая иерархия ошибок, config/paths-утили, политики повторов, HTTP-транспорт, авторизация, шифрованное хранилище сессий, antibot/браузер, пагинация, RPC/stream и оркестраторы онбординга/health.

librarykit   ← КОРЕНЬ: errors · config · retry · transport · auth · sessions ·
                        errmap · pagination · antibot · browser · rpc · stream ·
                        orchestration.  Зависит НИ ОТ ЧЕГО из китов.
   ▲
clikit       ← CLI-обёртка (поверх librarykit)
   ▲
adapterkit   ← SDK сетевых адаптеров (поверх librarykit + clikit)
   ▲
домен        ← конкретный продукт (поверх всех трёх)

Зависимости направлены только внутрь, к корню. librarykit не импортирует ни один другой кит и ничего не знает о потребителях.

Установка

uv add s-librarykit

Имя дистрибутива — s-librarykit, имя для импорта — librarykit.

Опциональные extra (тяжёлые зависимости ставятся по требованию):

uv add "s-librarykit[browser]"   # Playwright — warm/cold-login, snapshot сессий
uv add "s-librarykit[antibot]"   # curl-cffi — JA3-impersonate транспорт
uv add "s-librarykit[ws]"        # websockets — persistent stream-транспорт

Ядро (errors/config_util/retry/checkpoint/contract) почти-stdlib — единственная не-stdlib зависимость ядра platformdirs (нативные пути ОС для AppPaths). Сетевые модули тянут httpx/stamina, шифрование сессий — cryptography/keyring.

Состав

Слой Модуль Что даёт
Ошибки librarykit.errors единая иерархия CliError/ApiError + сетевые подклассы (AuthRequired/RateLimited/NotFound/ServerError/TransportError/Blocked) + множество RETRYABLE
Конфиг/пути librarykit.config_util deep_merge, interpolate_env, load_dotenv, slugify, normalize_account_id, atomic_write_text, chmod_600, AppPaths
Контракт librarykit.contract граничные Protocol (Transport/Auth/Refreshable/ErrorMapper/Paginator/SessionStoreProtocol/StreamTransport/Codec) + DTO/enum (SessionRef/Creds/PaginationMode/AuthMode/TransportKind)
Протоколы librarykit.protocols опциональные онбординг/health-контракты (LoginMode/OnboardingProtocol/HealthProtocol/HealthState/InteractiveFlow)
Повторы librarykit.retry RetryPolicy (header-driven: Retry-After/rate-limit) поверх stamina + SimpleRetryPolicy
Транспорт librarykit.transport HttpxTransport + HttpClient — единый choke-point HTTP-вызовов
Ошибки→исключения librarykit.errmap декларативная карта {status|code|body-predicate → ErrorSubclass} (build_error_map)
Пагинация librarykit.pagination CursorPaginator (offset/cursor/page) + tweepy-стиль обёртки
Авторизация librarykit.auth TokenAuth/CookieSessionAuth/OAuth2Auth/BrowserLoginAuth + dump/load/encrypt настроек
Сессии librarykit.sessions SessionStore — envelope-шифрованное файловое хранилище сессий (DEK под KEK), resolve_kek
Секреты librarykit.secret_store SecretStore — keyring + file-fallback
Antibot librarykit.antibot выбор транспорта Tier 0-4 (curl-cffi JA3 / реальный браузер по CDP)
Браузер librarykit.browser warm/cold-login, snapshot/restore storage-state
RPC librarykit.rpc RpcClient + codec-слой (JsonCodec/PrefixedJsonCodec) поверх HttpClient
Stream librarykit.stream persistent-транспорты (StubStreamTransport + WebSocketsStreamTransport)
Checkpoint librarykit.checkpoint Checkpoint (атомарный JSON-state), JsonlSink (forensic-лог), RunMetrics
Сущности librarykit.entities нейтральные data-классы (Session/SessionContext/HealthReport)
Оркестрация librarykit.orchestration OnboardingService, HealthMonitor, SessionLoader — переиспользуемые сценарии онбординга/health
Диагностика доступа librarykit.diagnosis ПОЧЕМУ не работает: Reason/Verdict + порядок разбора (REASON_ORDER), гео-блок сервиса (classify_geo), «лёг выход» vs авторизация (classify_failure), passive-разлогин по цепочке (classify_landing_chain), сведение улик (diagnose)

Топ-уровневый import librarykit ре-экспортирует публичный API (см. librarykit.__all__).

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

import librarykit as lk

# единая иерархия ошибок
try:
    ...
except lk.RateLimited as e:
    ...

# header-driven повторы + choke-point HTTP-клиент
client = lk.HttpClient(base_url="https://api.example.com", retry=lk.DEFAULT_RETRY)

# декларативная карта ответ → доменная ошибка
err_map = lk.build_error_map()

# envelope-шифрованное хранилище сессий
store = lk.SessionStore(root=..., kek=lk.resolve_kek())

Разработка

uv sync --extra dev
uv run --extra dev pytest -q
uv run --extra dev ruff check librarykit

Лицензия

MIT © 2026 Dmitry.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.7.34)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for TeJleTTy3uK from gravatar.com TeJleTTy3uK

Credits

Author: Dmitry

License

MIT

Requires

Python >=3.11

Provides Extra

antibot browser camoufox dev nodriver oauth ws

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

s_librarykit-0.7.0.tar.gz (470.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

s_librarykit-0.7.0-py3-none-any.whl (303.6 kB view details)

Uploaded Python 3

File details

Details for the file s_librarykit-0.7.0.tar.gz.

File metadata

  • Download URL: s_librarykit-0.7.0.tar.gz
  • Upload date:
  • Size: 470.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for s_librarykit-0.7.0.tar.gz
Algorithm Hash digest
SHA256 8ee895ccfd5d70b8d06d65e2e2843d5e8dc8ca3335dc01e5b89cc0ffd901b93a
MD5 3c9025530c19b5d58dff2b308ac3674f
BLAKE2b-256 0b375781fd725469cd23a50819fe8c4d75d670dc8d9cc504ce70e92dcf962616

See more details on using hashes here.

File details

Details for the file s_librarykit-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: s_librarykit-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 303.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for s_librarykit-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9b5b212a9f4fc779feaab26c301226fa2b821bdb9a623c3714d74f4ff57e7b75
MD5 02c38969c9608611e9acf95379044515
BLAKE2b-256 4743c546d4646d7921230e110d4fb7f2571a34109f6c2ade73cfe217307167b9

See more details on using hashes here.

Release history Release notifications | RSS feed

0.7.34

2 files

0.7.33

2 files

0.7.32

2 files

0.7.31

2 files

0.7.30

2 files

0.7.28

2 files

0.7.27

2 files

0.7.26

2 files

0.7.25

2 files

0.7.24

2 files

0.7.21

2 files

0.7.20

2 files

0.7.19

2 files

0.7.18

2 files

0.7.17

2 files

0.7.16

2 files

0.7.15

2 files

0.7.14

2 files

0.7.13

2 files

0.7.12

2 files

0.7.11

2 files

0.7.10

2 files

0.7.9

2 files

0.7.8

2 files

0.7.7

2 files

0.7.6

2 files

0.7.5

2 files

0.7.4

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

This release

0.7.0 This release

2 files

0.5.6

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page