persona-dsl 26.1.21.30__tar.gz → 26.1.21.34__tar.gz

{persona_dsl-26.1.21.30/src/persona_dsl.egg-info → persona_dsl-26.1.21.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: persona-dsl
-Version: 26.1.21.30
+Version: 26.1.21.34
 Summary: Persona DSL - Framework for implementing Screenplay pattern in Python tests
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -164,15 +164,63 @@ PERSONA_SKILLS = [BaseSkill.BROWSER, BaseSkill.API]
 ### `config/{env}.yaml`
 Параметры окружения (dev, test, prod). Выбирается через `--env=test`.
 
+### Примеры конфигурации
+
+Ниже представлен **полный справочник** всех возможных настроек.
+Большинство параметров унифицированы и работают идентично для **Локального** запуска и **Selenoid**.
+
+#### Полный справочник (Global Reference)
+
+Этот конфиг покрывает все возможности фреймворка. Неиспользуемые параметры можно опускать.
+
 ```yaml
-base_url: "https://my-app.test"
-browser:
-  headless: true
-  viewport: { width: 1920, height: 1080 }
-reporting:
-  screenshot_on_fail: true
+skills:
+  browser:
+    default:
+      base_url: "https://my-app.test" # URL должен быть внутри навыка
+      
+      # --- Базовые настройки (Basic) ---
+      type: chromium           # Тип: chromium, firefox, webkit, sberbrowser, msedge
+      headless: true           # true = без UI (в контейнере тоже работает)
+      channel: chrome          # (Optional) Канал: chrome, msedge, chrome-beta
+      executable_path: ""      # (Optional) Кастомный путь к бинарнику
+      version: "128.0"         # (Optional) Версия (для Selenoid или скачивания)
+      
+      # --- Размеры и Тайминги (Dimensions & Timings) ---
+      viewport:
+        width: 1920
+        height: 1080           # Всегда используйте многострочный формат для читаемости
+      slow_mo: 50.0            # Задержка между действиями (мс)
+      default_timeout: 30000.0 # Таймаут поиска элементов (мс)
+      default_navigation_timeout: 30000.0 # Таймаут загрузки (мс)
+
+      # --- Аргументы и Флаги (Arguments) ---
+      # Применяются и локально, и удаленно (через goog:chromeOptions)
+      no_sandbox: true         # --no-sandbox
+      ignore_https_errors: true # --ignore-certificate-errors
+      disable_features:        # --disable-features=...
+        - SidePanel
+        - SberWhatsNew
+      args:                    # Дополнительные аргументы
+        - "--start-maximized"
+        - "--disable-notifications"
+        - "--disable-gpu"
+
+      # --- Удаленный запуск (Remote / Selenoid) ---
+      # Если URL задан, тесты пойдут в облако/контейнер
+      selenoid_url: "http://selenoid.company.com:4444"
+      
+      session_retries: 3       # Повторные попытки при ошибке создания сессии
+      session_timeout: 60.0    # Таймаут ожидания слота (сек)
+      
+      selenoid_options:
+        enableVNC: true        # Включить Live-просмотр
+        enableVideo: false     # Включить запись видео
+        # name/videoName проставляются автоматически
 ```
 
+
+
 ---
 
 ## 📊 Отчетность (Allure + TaaS)

{persona_dsl-26.1.21.30 → persona_dsl-26.1.21.34}/README.md

@@ -127,15 +127,63 @@ PERSONA_SKILLS = [BaseSkill.BROWSER, BaseSkill.API]
 ### `config/{env}.yaml`
 Параметры окружения (dev, test, prod). Выбирается через `--env=test`.
 
+### Примеры конфигурации
+
+Ниже представлен **полный справочник** всех возможных настроек.
+Большинство параметров унифицированы и работают идентично для **Локального** запуска и **Selenoid**.
+
+#### Полный справочник (Global Reference)
+
+Этот конфиг покрывает все возможности фреймворка. Неиспользуемые параметры можно опускать.
+
 ```yaml
-base_url: "https://my-app.test"
-browser:
-  headless: true
-  viewport: { width: 1920, height: 1080 }
-reporting:
-  screenshot_on_fail: true
+skills:
+  browser:
+    default:
+      base_url: "https://my-app.test" # URL должен быть внутри навыка
+      
+      # --- Базовые настройки (Basic) ---
+      type: chromium           # Тип: chromium, firefox, webkit, sberbrowser, msedge
+      headless: true           # true = без UI (в контейнере тоже работает)
+      channel: chrome          # (Optional) Канал: chrome, msedge, chrome-beta
+      executable_path: ""      # (Optional) Кастомный путь к бинарнику
+      version: "128.0"         # (Optional) Версия (для Selenoid или скачивания)
+      
+      # --- Размеры и Тайминги (Dimensions & Timings) ---
+      viewport:
+        width: 1920
+        height: 1080           # Всегда используйте многострочный формат для читаемости
+      slow_mo: 50.0            # Задержка между действиями (мс)
+      default_timeout: 30000.0 # Таймаут поиска элементов (мс)
+      default_navigation_timeout: 30000.0 # Таймаут загрузки (мс)
+
+      # --- Аргументы и Флаги (Arguments) ---
+      # Применяются и локально, и удаленно (через goog:chromeOptions)
+      no_sandbox: true         # --no-sandbox
+      ignore_https_errors: true # --ignore-certificate-errors
+      disable_features:        # --disable-features=...
+        - SidePanel
+        - SberWhatsNew
+      args:                    # Дополнительные аргументы
+        - "--start-maximized"
+        - "--disable-notifications"
+        - "--disable-gpu"
+
+      # --- Удаленный запуск (Remote / Selenoid) ---
+      # Если URL задан, тесты пойдут в облако/контейнер
+      selenoid_url: "http://selenoid.company.com:4444"
+      
+      session_retries: 3       # Повторные попытки при ошибке создания сессии
+      session_timeout: 60.0    # Таймаут ожидания слота (сек)
+      
+      selenoid_options:
+        enableVNC: true        # Включить Live-просмотр
+        enableVideo: false     # Включить запись видео
+        # name/videoName проставляются автоматически
 ```
 
+
+
 ---
 
 ## 📊 Отчетность (Allure + TaaS)

{persona_dsl-26.1.21.30 → persona_dsl-26.1.21.34}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "persona-dsl"
-version = "26.01.21.030"
+version = "26.01.21.034"
 description = "Persona DSL - Framework for implementing Screenplay pattern in Python tests"
 readme = "README.md"
 requires-python = ">=3.9"

{persona_dsl-26.1.21.30 → persona_dsl-26.1.21.34}/src/persona_dsl/pytest_plugin.py

@@ -14,6 +14,7 @@ from urllib.parse import urlparse
 import allure
 import pytest
 import yaml
+import requests
 
 if TYPE_CHECKING:
     from persona_dsl.components.expectation import Expectation
@@ -116,6 +117,57 @@ def _get_skill_config(
     return named_config if isinstance(named_config, dict) else None
 
 
+def _create_selenoid_session(
+    hub_url: str, capabilities: Dict[str, Any], retries: int = 3, timeout: float = 10.0
+) -> Tuple[str, str]:
+    """
+    Создает сессию в Selenoid через WebDriver API с повторными попытками.
+    Возвращает кортеж (ws_endpoint, session_id).
+    """
+    session_url = f"{hub_url.rstrip('/')}/wd/hub/session"
+    last_error: Optional[Exception] = None
+
+    for attempt in range(retries + 1):
+        try:
+            logger.info(
+                f"Попытка создания сессии Selenoid ({attempt + 1}/{retries + 1})..."
+            )
+            # requests imported at module level
+            resp = requests.post(
+                session_url, json={"capabilities": capabilities}, timeout=timeout
+            )
+            if resp.status_code == 200:
+                data = resp.json()
+                # Формат ответа WebDriver: { "value": { "sessionId": "...", "capabilities": ... } }
+                value = data.get("value", {})
+                session_id = value.get("sessionId") or data.get("sessionId")
+
+                if not session_id:
+                    raise RuntimeError(f"Selenoid не вернул sessionId: {data}")
+
+                # Формируем WS URL для CDP
+                parsed = urlparse(hub_url)
+                ws_scheme = "wss" if parsed.scheme == "https" else "ws"
+                ws_endpoint = f"{ws_scheme}://{parsed.netloc}/devtools/{session_id}"
+
+                logger.info(f"Сессия Selenoid создана: {session_id}")
+                return ws_endpoint, session_id
+            else:
+                logger.warning(
+                    f"Ошибка создания сессии Selenoid (Code {resp.status_code}): {resp.text}"
+                )
+        except Exception as e:
+            last_error = e
+            logger.warning(f"Ошибка подключения к Selenoid: {e}")
+
+        if attempt < retries:
+            time.sleep(2.0)
+
+    raise RuntimeError(
+        f"Не удалось создать сессию Selenoid после {retries + 1} попыток. Последняя ошибка: {last_error}"
+    )
+
+
 def _get_persona_config(config: Config, role: str) -> Optional[Dict[str, Any]]:
     personas_config = config.personas
     if role == "default":
@@ -131,6 +183,38 @@ def _get_persona_config(config: Config, role: str) -> Optional[Dict[str, Any]]:
     return named_config if isinstance(named_config, dict) else None
 
 
+def _build_chromium_args(cfg: Dict[str, Any]) -> List[str]:
+    """Строит список аргументов командной строки для Chromium-based браузеров."""
+    args = list(cfg.get("args") or [])
+
+    if cfg.get("no_sandbox", False):
+        args.append("--no-sandbox")
+
+    disable_features = list(cfg.get("disable_features") or [])
+
+    if cfg.get("ignore_https_errors", False):
+        args.append("--ignore-certificate-errors")
+        # Отключаем принудительное обновление до HTTPS и связанные с ним предупреждения
+        if "HttpsUpgrades" not in disable_features:
+            disable_features.append("HttpsUpgrades")
+        if "EnforceHttps" not in disable_features:
+            disable_features.append("EnforceHttps")
+
+        # Для HTTP сайтов отключаем предупреждения о небезопасности
+        base_url = cfg.get("base_url")
+        if base_url:
+            parsed_url = urlparse(base_url)
+            if parsed_url.scheme == "http":
+                origin = f"{parsed_url.scheme}://{parsed_url.netloc}"
+                args.append(f"--unsafely-treat-insecure-origin-as-secure={origin}")
+
+    if disable_features:
+        features_str = ",".join(disable_features)
+        args.append(f"--disable-features={features_str}")
+
+    return args
+
+
 class PersonaDispatcher:
     def __init__(
         self,
@@ -234,49 +318,116 @@ class PersonaDispatcher:
                 pw = self._resources["playwright"]
                 browser_type = getattr(pw, cfg.get("type", "chromium"))
 
+                selenoid_url = cfg.get("selenoid_url")
                 ws_endpoint = cfg.get("ws_endpoint")
 
-                if ws_endpoint:
+                if selenoid_url:
+                    # Создание сессии в Selenoid
+                    selenoid_opts = cfg.get("selenoid_options", {})
+
+                    # Определяем browserName для Selenoid
+                    requested_type = cfg.get("type", "chromium")
+                    if requested_type == "sberbrowser":
+                        browser_name = "sberbrowser"
+                        # Playwright не знает про sberbrowser, используем chromium
+                        browser_type = getattr(pw, "chromium")
+                    elif requested_type == "chromium":
+                        browser_name = "chrome"  # Selenoid обычно использует "chrome" или "chromium"
+                    else:
+                        browser_name = requested_type
+
+                    # Базовые capabilities
+                    caps = {
+                        "browserName": browser_name,
+                        "version": cfg.get("version", ""),
+                        "enableVNC": selenoid_opts.get("enableVNC", True),
+                        "enableVideo": selenoid_opts.get("enableVideo", False),
+                    }
+                    # Добавляем специфичные опции
+                    if "goog:chromeOptions" in selenoid_opts:
+                        caps["goog:chromeOptions"] = selenoid_opts["goog:chromeOptions"]
+
+                    # Другие опции первого уровня
+                    for k, v in selenoid_opts.items():
+                        if k not in caps:
+                            caps[k] = v
+
+                    # --- UNIFICATION: Inject config args into capabilities ---
+                    common_args = _build_chromium_args(cfg)
+
+                    opts_key = "goog:chromeOptions"
+                    if "browserName" in caps and "firefox" in caps["browserName"]:
+                        opts_key = "moz:firefoxOptions"
+
+                    if opts_key not in caps:
+                        caps[opts_key] = {}
+                    if "args" not in caps[opts_key]:
+                        caps[opts_key]["args"] = []
+
+                    # 1. Headless (from config)
+                    if cfg.get("headless", False):
+                        if "--headless" not in caps[opts_key]["args"]:
+                            caps[opts_key]["args"].append("--headless")
+
+                    # 2. Common Args (no_sandbox, disable_features, etc)
+                    # Avoid duplicates
+                    existing_args = set(caps[opts_key]["args"])
+                    for arg in common_args:
+                        if arg not in existing_args:
+                            caps[opts_key]["args"].append(arg)
+
+                    # 3. Добавление имени теста
+                    if self.request and self.request.node:
+                        caps["name"] = self.request.node.name
+                        if caps.get("enableVideo"):
+                            caps["videoName"] = f"{self.request.node.name}.mp4"
+
+                    # Все capabilities оборачиваем в alwaysMatch для W3C
+                    w3c_caps = {"alwaysMatch": caps}
+
+                    retries = cfg.get("session_retries", 3)
+                    timeout = cfg.get("session_timeout", 30.0)
+
+                    ws_url, session_id = _create_selenoid_session(
+                        selenoid_url, w3c_caps, retries=retries, timeout=timeout
+                    )
+
+                    # Сохраняем для очистки
+                    if "selenoid_sessions" not in self._resources:
+                        self._resources["selenoid_sessions"] = []
+                    self._resources["selenoid_sessions"].append(
+                        {"url": selenoid_url, "id": session_id}
+                    )
+
+                    self._resources["browser"] = browser_type.connect_over_cdp(
+                        ws_url,
+                        slow_mo=float(cfg.get("slow_mo", 0.0)),
+                        timeout=float(cfg.get("timeout", 30000.0)),
+                    )
+
+                elif ws_endpoint:
                     # Подключение к удалённому браузеру по WebSocket
                     self._resources["browser"] = browser_type.connect_over_cdp(
-                        ws_endpoint
+                        ws_endpoint,
+                        slow_mo=float(cfg.get("slow_mo", 0.0)),
+                        timeout=float(cfg.get("timeout", 30000.0)),
                     )
                 else:
                     # Локальный запуск
-                    args = cfg.get("args") or []
-                    if cfg.get("no_sandbox", False):
-                        args.append("--no-sandbox")
-
-                    disable_features = cfg.get("disable_features") or []
-
-                    if cfg.get("ignore_https_errors", False):
-                        args.append("--ignore-certificate-errors")
-                        # Отключаем принудительное обновление до HTTPS и связанные с ним предупреждения
-                        if "HttpsUpgrades" not in disable_features:
-                            disable_features.append("HttpsUpgrades")
-                        if "EnforceHttps" not in disable_features:
-                            disable_features.append("EnforceHttps")
-
-                        # Для HTTP сайтов отключаем предупреждения о небезопасности
-                        base_url = cfg.get("base_url")
-                        if base_url:
-                            parsed_url = urlparse(base_url)
-                            if parsed_url.scheme == "http":
-                                origin = f"{parsed_url.scheme}://{parsed_url.netloc}"
-                                args.append(
-                                    f"--unsafely-treat-insecure-origin-as-secure={origin}"
-                                )
-
-                    if disable_features:
-                        features_str = ",".join(disable_features)
-                        args.append(f"--disable-features={features_str}")
+                    args = _build_chromium_args(cfg)
 
                     executable_path = cfg.get("executable_path")
+                    channel = cfg.get("channel")
+                    slow_mo = float(cfg.get("slow_mo", 0.0))
+                    timeout = float(cfg.get("timeout", 30000.0))
 
                     launch_opts = {
                         "headless": cfg.get("headless", True),
                         "executable_path": executable_path,
                         "args": args if args else None,
+                        "channel": channel,
+                        "slow_mo": slow_mo,
+                        "timeout": timeout,
                     }
                     launch_opts = {
                         k: v for k, v in launch_opts.items() if v is not None
@@ -507,7 +658,22 @@ class PersonaDispatcher:
             for context in self._resources["browser_contexts"].values():
                 context.close()
         if "browser" in self._resources:
-            self._resources["browser"].close()
+            try:
+                self._resources["browser"].close()
+            except Exception as e:
+                logger.warning(f"Ошибка при закрытии браузера: {e}")
+
+        # Удаление сессий Selenoid
+        if "selenoid_sessions" in self._resources:
+            for session in self._resources["selenoid_sessions"]:
+                s_url = session["url"]
+                s_id = session["id"]
+                try:
+                    del_url = f"{s_url.rstrip('/')}/wd/hub/session/{s_id}"
+                    logger.info(f"Удаление сессии Selenoid: {s_id}")
+                    requests.delete(del_url, timeout=5.0)
+                except Exception as e:
+                    logger.warning(f"Ошибка удаления сессии Selenoid {s_id}: {e}")
         if "playwright" in self._resources:
             pw = self._resources["playwright"]
             if not hasattr(pw, "stop") or not callable(pw.stop):

{persona_dsl-26.1.21.30 → persona_dsl-26.1.21.34/src/persona_dsl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: persona-dsl
-Version: 26.1.21.30
+Version: 26.1.21.34
 Summary: Persona DSL - Framework for implementing Screenplay pattern in Python tests
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -164,15 +164,63 @@ PERSONA_SKILLS = [BaseSkill.BROWSER, BaseSkill.API]
 ### `config/{env}.yaml`
 Параметры окружения (dev, test, prod). Выбирается через `--env=test`.
 
+### Примеры конфигурации
+
+Ниже представлен **полный справочник** всех возможных настроек.
+Большинство параметров унифицированы и работают идентично для **Локального** запуска и **Selenoid**.
+
+#### Полный справочник (Global Reference)
+
+Этот конфиг покрывает все возможности фреймворка. Неиспользуемые параметры можно опускать.
+
 ```yaml
-base_url: "https://my-app.test"
-browser:
-  headless: true
-  viewport: { width: 1920, height: 1080 }
-reporting:
-  screenshot_on_fail: true
+skills:
+  browser:
+    default:
+      base_url: "https://my-app.test" # URL должен быть внутри навыка
+      
+      # --- Базовые настройки (Basic) ---
+      type: chromium           # Тип: chromium, firefox, webkit, sberbrowser, msedge
+      headless: true           # true = без UI (в контейнере тоже работает)
+      channel: chrome          # (Optional) Канал: chrome, msedge, chrome-beta
+      executable_path: ""      # (Optional) Кастомный путь к бинарнику
+      version: "128.0"         # (Optional) Версия (для Selenoid или скачивания)
+      
+      # --- Размеры и Тайминги (Dimensions & Timings) ---
+      viewport:
+        width: 1920
+        height: 1080           # Всегда используйте многострочный формат для читаемости
+      slow_mo: 50.0            # Задержка между действиями (мс)
+      default_timeout: 30000.0 # Таймаут поиска элементов (мс)
+      default_navigation_timeout: 30000.0 # Таймаут загрузки (мс)
+
+      # --- Аргументы и Флаги (Arguments) ---
+      # Применяются и локально, и удаленно (через goog:chromeOptions)
+      no_sandbox: true         # --no-sandbox
+      ignore_https_errors: true # --ignore-certificate-errors
+      disable_features:        # --disable-features=...
+        - SidePanel
+        - SberWhatsNew
+      args:                    # Дополнительные аргументы
+        - "--start-maximized"
+        - "--disable-notifications"
+        - "--disable-gpu"
+
+      # --- Удаленный запуск (Remote / Selenoid) ---
+      # Если URL задан, тесты пойдут в облако/контейнер
+      selenoid_url: "http://selenoid.company.com:4444"
+      
+      session_retries: 3       # Повторные попытки при ошибке создания сессии
+      session_timeout: 60.0    # Таймаут ожидания слота (сек)
+      
+      selenoid_options:
+        enableVNC: true        # Включить Live-просмотр
+        enableVideo: false     # Включить запись видео
+        # name/videoName проставляются автоматически
 ```
 
+
+
 ---
 
 ## 📊 Отчетность (Allure + TaaS)