s-browserkit 0.0.2__tar.gz → 0.0.4__tar.gz

s_browserkit-0.0.4/CHANGELOG.md

@@ -0,0 +1,126 @@
+# Changelog — s-browserkit
+
+Формат: [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/), версии — SemVer.
+
+## [0.0.4] — 2026-08-08
+
+### Added — `browserkit.browser_guard`: запрет браузера в рабочем пути
+
+Страж канона транспорта переехал сюда из `s-librarykit` — В КИТ-ВЛАДЕЛЕЦ ДВЕРЕЙ.
+Это не перекладывание файла: раньше он был слеп ровно там, где заведён.
+
+ПО УЛИКЕ. Двери движка живут здесь — пять точек запуска
+(`browser/{launchers,nodriver,camoufox,persistent}.py` + CDP-attach) и фасад
+`capabilities.open_browser`. Пока страж лежал в оркестраторе:
+
+- навык, поставивший ТОЛЬКО `s-browserkit` (после разнесения китов это норма),
+  стража не получал вовсе;
+- `librarykit` патчил `browserkit`, **не объявляя его зависимостью**. Замерено в
+  окружении без браузерного кита: `install_browser_guard()` возвращал ручку с 5
+  перехваченными дверями и 18 «пропущенными» — все десять дверей `browserkit`
+  уходили в тишину, а прогон навыка оставался ЗЕЛЁНЫМ, ничего не охраняя.
+
+Что приехало:
+
+- перехват на ДВЕРЯХ ДВИЖКА (`DEFAULT_DOORS`), а не на именах функций навыка:
+  переименование и алиас импорта его не обходят — ссылки сверяются по ТОЖДЕСТВУ
+  объекта, поэтому под перехватом оказываются и подмодули
+  (`browserkit.browser.persistent.PersistentChromiumBackend`), и корень кита
+  (`browserkit.open_browser`);
+- разрешение как свойство КОНТЕКСТА вызова (`allow_browser` /
+  `browser_is_allowed` / `require_browser_permission`), дефолт «нельзя»;
+- подключение к прогону навыка одной строкой —
+  `from browserkit.testing import forbid_real_browser`;
+- статический AST-сканер `scan_source` / `find_browser_launches` — вторая
+  половина запрета (видит непокрытый тестами код).
+
+### Added — ★ страж не может «подключиться и ослепнуть»
+
+Главное, ради чего был переезд. Двери разделены по владельцу (`DoorKind`), и от
+владельца зависит цена их отсутствия:
+
+- **свои** (`OWN`, `browserkit.*`) — контракт: едут в одном дистрибутиве со
+  стражем. Пропажа своей двери означает разъезд списка с китом, поэтому
+  установка падает `BrowserGuardBlind` и снимает уже поставленные патчи
+  (полу-стража не остаётся). Отключающего флага нет;
+- **вендорские** (`VENDOR`) и **соседнего кита** (`FOREIGN`, `librarykit.*`) —
+  best-effort. Отсутствие ПАКЕТА (`guard.absent`) безвредно: через него браузер
+  не поднять. Отсутствие ДВЕРИ при установленном пакете (`guard.blind`) — уже
+  слепота: предупреждение `BrowserGuardWarning` и строка в отчёте;
+- `install_browser_guard(require=("librarykit",))` — потребовать чужие двери
+  явно: нет пакета или дверь переименована → `BrowserGuardBlind`;
+- `BrowserGuard.describe()` / `.absent` / `.blind` / `.is_blind` /
+  `.guarded_packages()` — отчёт «что держу, чего нет, где слеп».
+
+Двери `librarykit.*` — НЕ зависимость (импорта оркестратора в ките нет), а
+ранняя ловушка: `librarykit.factory` всё равно упирается в бэкенды этого кита,
+поэтому своих дверей достаточно.
+
+ЧЕГО СТРАЖ НЕ ДЕРЖИТ — сказано вслух, а не умолчано. Дверь, уложенная в
+контейнер (`РЕЕСТР = {"camoufox": CamoufoxBackend}`, список, атрибут класса) ДО
+`install_browser_guard()`, перехват обходит: замена уже розданных ссылок идёт по
+`__dict__` модулей, рекурсии по контейнерам нет намеренно. Прямой вызов и алиас
+импорта — держатся. Форма закреплена `xfail(strict=True)` в
+`tests/test_browser_guard.py`: как только обход закроют, XPASS уронит прогон и
+заставит переписать раздел «Граница применимости», а не оставит её протухать в
+доке.
+
+Документация — `docs/BROWSER_GUARD.md`. Старые адреса
+(`librarykit.browser_guard`, `librarykit.testing`) остались алиасами САМИХ
+модулей — одной строкой, без второй реализации.
+
+## [0.0.3] — 2026-08-04
+
+### Changed
+
+- Нижняя граница на киты основания поднята до `0.0.2` — версии,
+  в архиве которой больше нет конфигурации CI.
+
+## [0.0.2] — 2026-08-04
+
+### Fixed
+
+- Конфигурация CI больше не попадает в опубликованный архив исходников:
+  в 0.0.1 туда уезжал `.gitlab-ci.yml` с именем приватной группы GitLab.
+  Секретов там нет (публикация идёт через OIDC), но внутренней структуре
+  в публичном пакете не место.
+
+## [0.0.1] — 2026-08-03
+
+Выделение браузерного слоя из `s-librarykit`. Кода не написано
+заново — он ПЕРЕЕХАЛ; по старым путям остались алиасы на те же модули.
+
+### Добавлено
+
+* **Фасад возможностей** `browserkit.capabilities` — потребитель просит ЦЕЛЬ
+  (`Capability.STEALTH_SESSION` / `VISIBLE_LOGIN` / `PERSISTENT_WORK` /
+  `STEALTH_REQUEST` / `IN_PAGE_REQUEST` / `TRAFFIC_CAPTURE`), а не движок.
+  Соответствие «цель → движок» живёт в одной таблице `_DEFAULT_PLAN` внутри кита;
+  выбор — лестница кандидатов (первый установленный выигрывает), отсутствие всех
+  → `CapabilityUnavailable` с рецептом установки.
+* `browserkit.ports` — `Transport` / `SyncTransport` / `BrowserEngineRole`:
+  контракты, которые киту нужны снаружи. Структурно совпадают с контрактами
+  сетевого слоя (проверено тестом), поэтому транспорты взаимозаменяемы.
+* Ленивый корень (PEP 562): `import browserkit` не тянет ни подпакеты-реализации,
+  ни движки — можно спрашивать «умеешь ли ты стелс?», не платя импортом.
+
+### Переехало из librarykit (без изменения поведения)
+
+* `browser/` — `_engine`, `geometry`, `launchers`, `persistent`, `camoufox`,
+  `nodriver`, `capture_tap`, `state`, `_cdp_state`;
+* `antibot/` — `curl_cffi`, `cdp`, `page_evaluate`, `warmup_minter`, `_helpers`;
+* `profile_health.py` — предстартовая проверка профиля и карантин;
+* `proc.py` — запуск подпроцессов без всплывающих консолей.
+
+### Известный долг
+
+* `browserkit/proc.py` — ДУБЛЬ `librarykit/proc.py`. Настоящий дом слоя — основание
+  (`corekit`), перенос отложен, чтобы не драться за файл с параллельным выделением
+  `netkit`/`authkit-client`. Дрейф копий ловится тестом
+  `tests/test_layering.py::test_proc_layer_has_not_drifted_from_the_orchestrator`.
+* `browserkit/ports.py` — своя копия Protocol'ов транспорта; станет реэкспортом из
+  `netkit.contract`, когда сетевой кит будет опубликован.
+* `librarykit/ephemeral.py` (минт без дискового профиля) ОСТАЛСЯ в оркестраторе:
+  он тянет `librarykit.session_fingerprint` (инвариант «один egress + один
+  профиль»), чей дом — session-слой, а не браузерный. Браузер он поднимает лениво,
+  через этот кит, поэтому слои не нарушены.

{s_browserkit-0.0.2 → s_browserkit-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s-browserkit
-Version: 0.0.2
+Version: 0.0.4
 Summary: Браузерный слой для Python-автоматизации: стелс-сессии, антибот-запросы и capture трафика через единый фасад возможностей, а не имя движка.
 Author: Dmitry
 License: MIT
@@ -17,7 +17,7 @@ Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.27
-Requires-Dist: s-corekit>=0.0.1
+Requires-Dist: s-corekit>=0.0.2
 Provides-Extra: antibot
 Requires-Dist: curl-cffi>=0.7; extra == 'antibot'
 Provides-Extra: browser
@@ -120,7 +120,28 @@ browserkit.CapabilityUnavailable: Возможность 'stealth_request' не
 * `browserkit.antibot` — исполнители HTTP-запроса, ходящие «как браузер»;
 * `browserkit.profile_health` — предстартовая проверка профиля и карантин;
 * `browserkit.proc` — запуск подпроцессов без всплывающих консолей;
-* `browserkit.ports` — Protocol'ы, которых киту не хватает снаружи.
+* `browserkit.ports` — Protocol'ы, которых киту не хватает снаружи;
+* `browserkit.browser_guard` + `browserkit.testing` — **запрет браузера в рабочем
+  пути** (см. ниже).
+
+## Запрет браузера в рабочем пути
+
+Канон транспорта: браузер поднимается только чтобы сминтить сессию, работа идёт
+прямыми запросами. Кит делает это **конструкцией** — перехватом на собственных
+дверях запуска. Подключение к прогону навыка — одна строка:
+
+```python
+# tests/conftest.py навыка
+from browserkit.testing import forbid_real_browser  # noqa: F401
+```
+
+Страж живёт здесь, а не в оркестраторе, ровно потому, что двери — здесь: страж и
+двери едут в одном дистрибутиве, поэтому «импорт прошёл» = «двери на месте». Он
+обязан честно сказать, если стеречь не может: пропажа СВОЕЙ двери валит
+установку (`BrowserGuardBlind`), а «пакета нет» отделено от «пакет есть, двери
+нет» (`guard.absent` / `guard.blind` / `guard.describe()`).
+
+Подробности, боевая установка и границы применимости — `docs/BROWSER_GUARD.md`.
 
 ## Установка
 
@@ -138,9 +159,11 @@ pip install 's-browserkit[antibot]'      # + TLS/JA3-импersonate без бр
 ## Совместимость
 
 Прежние пути (`librarykit.browser.*`, `librarykit.antibot.*`,
-`librarykit.profile_health`) продолжают работать: там оставлены **алиасы на те же
-модули** (`sys.modules`), а не копии. Поэтому `monkeypatch`, `isinstance` и
-`is`-сравнения ведут себя ровно как до переноса.
+`librarykit.profile_health`, `librarykit.browser_guard`, `librarykit.testing`)
+продолжают работать: там оставлены **алиасы на те же модули** (`sys.modules`), а
+не копии. Поэтому `monkeypatch`, `isinstance` и `is`-сравнения ведут себя ровно
+как до переноса, а второй реализации стража, которая через месяц разъедется с
+первой, не существует.
 
 ## Тесты
 

{s_browserkit-0.0.2 → s_browserkit-0.0.4}/README.md

@@ -86,7 +86,28 @@ browserkit.CapabilityUnavailable: Возможность 'stealth_request' не
 * `browserkit.antibot` — исполнители HTTP-запроса, ходящие «как браузер»;
 * `browserkit.profile_health` — предстартовая проверка профиля и карантин;
 * `browserkit.proc` — запуск подпроцессов без всплывающих консолей;
-* `browserkit.ports` — Protocol'ы, которых киту не хватает снаружи.
+* `browserkit.ports` — Protocol'ы, которых киту не хватает снаружи;
+* `browserkit.browser_guard` + `browserkit.testing` — **запрет браузера в рабочем
+  пути** (см. ниже).
+
+## Запрет браузера в рабочем пути
+
+Канон транспорта: браузер поднимается только чтобы сминтить сессию, работа идёт
+прямыми запросами. Кит делает это **конструкцией** — перехватом на собственных
+дверях запуска. Подключение к прогону навыка — одна строка:
+
+```python
+# tests/conftest.py навыка
+from browserkit.testing import forbid_real_browser  # noqa: F401
+```
+
+Страж живёт здесь, а не в оркестраторе, ровно потому, что двери — здесь: страж и
+двери едут в одном дистрибутиве, поэтому «импорт прошёл» = «двери на месте». Он
+обязан честно сказать, если стеречь не может: пропажа СВОЕЙ двери валит
+установку (`BrowserGuardBlind`), а «пакета нет» отделено от «пакет есть, двери
+нет» (`guard.absent` / `guard.blind` / `guard.describe()`).
+
+Подробности, боевая установка и границы применимости — `docs/BROWSER_GUARD.md`.
 
 ## Установка
 
@@ -104,9 +125,11 @@ pip install 's-browserkit[antibot]'      # + TLS/JA3-импersonate без бр
 ## Совместимость
 
 Прежние пути (`librarykit.browser.*`, `librarykit.antibot.*`,
-`librarykit.profile_health`) продолжают работать: там оставлены **алиасы на те же
-модули** (`sys.modules`), а не копии. Поэтому `monkeypatch`, `isinstance` и
-`is`-сравнения ведут себя ровно как до переноса.
+`librarykit.profile_health`, `librarykit.browser_guard`, `librarykit.testing`)
+продолжают работать: там оставлены **алиасы на те же модули** (`sys.modules`), а
+не копии. Поэтому `monkeypatch`, `isinstance` и `is`-сравнения ведут себя ровно
+как до переноса, а второй реализации стража, которая через месяц разъедется с
+первой, не существует.
 
 ## Тесты
 

{s_browserkit-0.0.2 → s_browserkit-0.0.4}/browserkit/__init__.py

@@ -71,7 +71,7 @@ from browserkit.ports import (
     Transport,
 )
 
-__version__ = "0.0.2"
+__version__ = "0.0.4"
 
 if TYPE_CHECKING:  # pragma: no cover - только статическая видимость для IDE/mypy
     from typing import Any