persona-dsl 26.1.21.32__tar.gz

persona_dsl-26.1.21.32/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include src/persona_dsl/runtime/dist *.js

persona_dsl-26.1.21.32/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: persona-dsl
+Version: 26.1.21.32
+Summary: Persona DSL - Framework for implementing Screenplay pattern in Python tests
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: playwright==1.55.0
+Requires-Dist: pytest
+Requires-Dist: pytest-cov
+Requires-Dist: allure-pytest
+Requires-Dist: python-dotenv
+Requires-Dist: pyyaml
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: requests
+Requires-Dist: pyhamcrest
+Requires-Dist: redis
+Requires-Dist: Faker
+Requires-Dist: pillow
+Requires-Dist: zeep
+Requires-Dist: pg8000
+Requires-Dist: oracledb
+Requires-Dist: kafka-python
+Requires-Dist: Unidecode>=1.3
+Requires-Dist: black
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Requires-Dist: types-redis; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-timeout; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+
+# persona-dsl: Фреймворк для автотестов на Python
+
+`persona-dsl` — это современная библиотека для написания **E2E** и **API** автотестов, реализующая паттерн **Screenplay**.
+Она предоставляет выразительный язык для описания сценариев, управляет браузером (через Playwright) и автоматически генерирует детальные отчеты Allure.
+
+## 📦 Установка
+
+```bash
+pip install persona-dsl
+python -m playwright install --with-deps
+```
+
+---
+
+## 🚀 Быстрый старт
+
+### 1. Описание страницы (Page Object)
+
+В `persona-dsl` используется **Универсальная Архитектура Элементов**.
+Основной класс `Page` сам является элементом-контейнером. Вложенные элементы добавляются через `add_element`.
+
+```python
+# pages/login_page.py
+from persona_dsl.pages import Page
+from persona_dsl.pages.elements import Input, Button
+
+class LoginPage(Page):
+    def __init__(self):
+        super().__init__()
+        # Имя атрибута (self.username) будет использовано как имя элемента в отчетах
+        self.username = self.add_element(Input(xpath="//input[@id='user']", name="Логин"))
+        self.password = self.add_element(Input(xpath="//input[@id='pass']", name="Пароль"))
+        self.submit   = self.add_element(Button(xpath="//button[@type='submit']", name="Вход"))
+```
+
+### 2. Написание теста
+
+Тесты пишутся в стиле "Persona делает действия":
+
+```python
+# tests/test_login.py
+import pytest
+from persona_dsl.ops.web import NavigateTo, Fill, Click
+from persona_dsl.facts.web import CurrentPath
+from persona_dsl.expectations.web import IsEqualTo
+from pages.login_page import LoginPage
+
+def test_login_flow(persona):
+    login_page = LoginPage()
+
+    # 1. Действия (Actions)
+    persona.make(
+        NavigateTo("/login"),
+        Fill(login_page.username, "admin"),
+        Fill(login_page.password, "secret"),
+        Click(login_page.submit)
+    )
+
+    # 2. Проверка (Verification)
+    # Получаем Факт (CurrentPath) и проверяем Ожидание (IsEqualTo)
+    current_path = persona.get(CurrentPath())
+    persona.check(current_path, IsEqualTo("/dashboard"))
+```
+
+---
+
+## 🏗 Архитектура
+
+### 1. Ключевые компоненты (Persona Core)
+
+| Компонент | Назначение | Пример |
+|-----------|------------|--------|
+| **Persona** | Исполнитель. Хранит состояние и навыки. | `persona.make(...)` |
+| **Skill** | "Навык". Дает доступ к инструментам. | `UseBrowser`, `UseAPI`, `UseDB` |
+| **Ops** | Атомарная операция. Работает со Skill. | `Click`, `HttpRequest`, `ExecuteSQL` |
+| **Step** | Бизнес-шаг. Группирует Ops. | `LoginStep`, `CreateOrder` |
+| **Fact** | Запрос состояния (без изменений). | `CurrentPath`, `ElementText` |
+| **Expectation** | Проверка значения. | `IsEqualTo`, `ContainsText` |
+
+### 2. Универсальные Элементы (New!)
+
+Больше нет разделения на `Element` и `ElementContainer`. Любой элемент может содержать другие элементы.
+
+*   **`element.add_element(...)`**: Регистрирует дочерний элемент.
+*   **Иерархия**: `Page -> Container -> Element`.
+*   **Локаторы**: Строятся автоматически по цепочке родителей.
+
+### 3. Генераторный подход
+Все шаги (`Step`, `CombinedStep`) — это генераторы, которые "выдают" (`yield`) операции для исполнения Персоной. Это позволяет `persona-dsl` перехватывать каждый шаг, логировать его в Allure и обрабатывать ошибки.
+
+---
+
+## 🛠 Инструменты и Утилиты
+
+### Генерация Page Objects
+Не пишите селекторы вручную. Используйте генератор:
+
+```bash
+# Снять ARIA-снапшот и сгенерировать класс страницы
+persona-page-gen --url http://localhost:8080 --output pages/home.py
+```
+
+### Генерация API клиентов
+```bash
+# Генерация из OpenAPI/Swagger
+persona-api-gen --url http://api.example.com/openapi.json --output skills/my_api.py
+```
+
+### Запуск тестов
+
+Тесты запускаются стандартной командой pytest:
+
+```bash
+pytest --env=dev tests/
+```
+
+---
+
+## ⚙️ Конфигурация
+
+### `conftest.py`
+Декларативное описание навыков и ролей:
+```python
+PERSONA_SKILLS = [BaseSkill.BROWSER, BaseSkill.API]
+```
+
+### `config/{env}.yaml`
+Параметры окружения (dev, test, prod). Выбирается через `--env=test`.
+
+### Примеры конфигурации
+
+Ниже представлен **полный справочник** всех возможных настроек.
+Большинство параметров унифицированы и работают идентично для **Локального** запуска и **Selenoid**.
+
+#### Полный справочник (Global Reference)
+
+Этот конфиг покрывает все возможности фреймворка. Неиспользуемые параметры можно опускать.
+
+```yaml
+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)
+
+Фреймворк автоматически:
+1. Создает вложенные **Allure Steps** для каждого действия.
+2. Прикрепляет **Скриншоты** и **Page Source** при падении.
+3. Логирует **HTTP запросы/ответы** (если включено).
+4. Интегрируется с платформой **TaaS** (Test as a Service) для аналитики.
+

persona_dsl-26.1.21.32/README.md

@@ -0,0 +1,196 @@
+# persona-dsl: Фреймворк для автотестов на Python
+
+`persona-dsl` — это современная библиотека для написания **E2E** и **API** автотестов, реализующая паттерн **Screenplay**.
+Она предоставляет выразительный язык для описания сценариев, управляет браузером (через Playwright) и автоматически генерирует детальные отчеты Allure.
+
+## 📦 Установка
+
+```bash
+pip install persona-dsl
+python -m playwright install --with-deps
+```
+
+---
+
+## 🚀 Быстрый старт
+
+### 1. Описание страницы (Page Object)
+
+В `persona-dsl` используется **Универсальная Архитектура Элементов**.
+Основной класс `Page` сам является элементом-контейнером. Вложенные элементы добавляются через `add_element`.
+
+```python
+# pages/login_page.py
+from persona_dsl.pages import Page
+from persona_dsl.pages.elements import Input, Button
+
+class LoginPage(Page):
+    def __init__(self):
+        super().__init__()
+        # Имя атрибута (self.username) будет использовано как имя элемента в отчетах
+        self.username = self.add_element(Input(xpath="//input[@id='user']", name="Логин"))
+        self.password = self.add_element(Input(xpath="//input[@id='pass']", name="Пароль"))
+        self.submit   = self.add_element(Button(xpath="//button[@type='submit']", name="Вход"))
+```
+
+### 2. Написание теста
+
+Тесты пишутся в стиле "Persona делает действия":
+
+```python
+# tests/test_login.py
+import pytest
+from persona_dsl.ops.web import NavigateTo, Fill, Click
+from persona_dsl.facts.web import CurrentPath
+from persona_dsl.expectations.web import IsEqualTo
+from pages.login_page import LoginPage
+
+def test_login_flow(persona):
+    login_page = LoginPage()
+
+    # 1. Действия (Actions)
+    persona.make(
+        NavigateTo("/login"),
+        Fill(login_page.username, "admin"),
+        Fill(login_page.password, "secret"),
+        Click(login_page.submit)
+    )
+
+    # 2. Проверка (Verification)
+    # Получаем Факт (CurrentPath) и проверяем Ожидание (IsEqualTo)
+    current_path = persona.get(CurrentPath())
+    persona.check(current_path, IsEqualTo("/dashboard"))
+```
+
+---
+
+## 🏗 Архитектура
+
+### 1. Ключевые компоненты (Persona Core)
+
+| Компонент | Назначение | Пример |
+|-----------|------------|--------|
+| **Persona** | Исполнитель. Хранит состояние и навыки. | `persona.make(...)` |
+| **Skill** | "Навык". Дает доступ к инструментам. | `UseBrowser`, `UseAPI`, `UseDB` |
+| **Ops** | Атомарная операция. Работает со Skill. | `Click`, `HttpRequest`, `ExecuteSQL` |
+| **Step** | Бизнес-шаг. Группирует Ops. | `LoginStep`, `CreateOrder` |
+| **Fact** | Запрос состояния (без изменений). | `CurrentPath`, `ElementText` |
+| **Expectation** | Проверка значения. | `IsEqualTo`, `ContainsText` |
+
+### 2. Универсальные Элементы (New!)
+
+Больше нет разделения на `Element` и `ElementContainer`. Любой элемент может содержать другие элементы.
+
+*   **`element.add_element(...)`**: Регистрирует дочерний элемент.
+*   **Иерархия**: `Page -> Container -> Element`.
+*   **Локаторы**: Строятся автоматически по цепочке родителей.
+
+### 3. Генераторный подход
+Все шаги (`Step`, `CombinedStep`) — это генераторы, которые "выдают" (`yield`) операции для исполнения Персоной. Это позволяет `persona-dsl` перехватывать каждый шаг, логировать его в Allure и обрабатывать ошибки.
+
+---
+
+## 🛠 Инструменты и Утилиты
+
+### Генерация Page Objects
+Не пишите селекторы вручную. Используйте генератор:
+
+```bash
+# Снять ARIA-снапшот и сгенерировать класс страницы
+persona-page-gen --url http://localhost:8080 --output pages/home.py
+```
+
+### Генерация API клиентов
+```bash
+# Генерация из OpenAPI/Swagger
+persona-api-gen --url http://api.example.com/openapi.json --output skills/my_api.py
+```
+
+### Запуск тестов
+
+Тесты запускаются стандартной командой pytest:
+
+```bash
+pytest --env=dev tests/
+```
+
+---
+
+## ⚙️ Конфигурация
+
+### `conftest.py`
+Декларативное описание навыков и ролей:
+```python
+PERSONA_SKILLS = [BaseSkill.BROWSER, BaseSkill.API]
+```
+
+### `config/{env}.yaml`
+Параметры окружения (dev, test, prod). Выбирается через `--env=test`.
+
+### Примеры конфигурации
+
+Ниже представлен **полный справочник** всех возможных настроек.
+Большинство параметров унифицированы и работают идентично для **Локального** запуска и **Selenoid**.
+
+#### Полный справочник (Global Reference)
+
+Этот конфиг покрывает все возможности фреймворка. Неиспользуемые параметры можно опускать.
+
+```yaml
+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)
+
+Фреймворк автоматически:
+1. Создает вложенные **Allure Steps** для каждого действия.
+2. Прикрепляет **Скриншоты** и **Page Source** при падении.
+3. Логирует **HTTP запросы/ответы** (если включено).
+4. Интегрируется с платформой **TaaS** (Test as a Service) для аналитики.
+

persona_dsl-26.1.21.32/pyproject.toml

@@ -0,0 +1,91 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "persona-dsl"
+version = "26.01.21.032"
+description = "Persona DSL - Framework for implementing Screenplay pattern in Python tests"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "playwright==1.55.0",
+    "pytest",
+    "pytest-cov",
+    "allure-pytest",
+    "python-dotenv",
+    "pyyaml",
+    "pydantic>=2,<3",
+    "requests",
+    "pyhamcrest",
+    "redis",
+    "Faker",
+    "pillow",
+    "zeep",
+    "pg8000",
+    "oracledb",
+    "kafka-python",
+    "Unidecode>=1.3",
+    "black",
+]
+[project.optional-dependencies]
+dev = [
+    "black",
+    "ruff",
+    "mypy",
+    "pytest-cov",
+    "pre-commit",
+    "types-requests",
+    "types-PyYAML",
+    "types-redis",
+    "pytest-asyncio",
+    "pytest-timeout",
+    "pytest-xdist",
+]
+
+[project.entry-points.pytest11]
+persona_dsl = "persona_dsl.pytest_plugin"
+
+[project.scripts]
+persona-page-gen = "persona_dsl.generators.cli:page_main"
+persona-api-gen = "persona_dsl.generators.cli:api_main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.coverage.run]
+source = ["src/persona_dsl"]
+omit = [
+    # --- Компоненты, сложные для юнит-тестирования (снапшоты) ---
+    "src/persona_dsl/expectations/web/matches_screenshot.py",
+    "src/persona_dsl/expectations/web/matches_aria_snapshot.py",
+    # --- Файлы без исполняемой логики (базовые классы, Enum'ы, импорты) ---
+    "src/persona_dsl/__init__.py",
+    "src/persona_dsl/skills/__init__.py",
+    "src/persona_dsl/enums.py",
+    "src/persona_dsl/skill_id.py",
+    "src/persona_dsl/expectation.py",
+]
+parallel = true
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.mypy]
+python_version = "3.12"
+warn_unused_ignores = true
+warn_redundant_casts = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+no_implicit_optional = true
+strict_equality = true
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "persona_dsl.*"
+check_untyped_defs = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+ignore_errors = true
+

persona_dsl-26.1.21.32/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

persona_dsl-26.1.21.32/src/persona_dsl/__init__.py

@@ -0,0 +1,35 @@
+from .components.action import Action
+from .utils.decorators import data_driven, tag, parametrize_simple
+from .persona import BaseRole
+from .skills.core.skill_definition import BaseSkill
+from .components.expectation import Expectation
+from .components.fact import Fact
+from .components.goal import Goal
+from .persona import Persona
+from .skills.core.skill_definition import SkillId
+from .utils.waits import wait_until
+from .skills.core.base import Skill
+from .skills import UseAPI, UseBrowser, UseDatabase, UseKafka, UseSOAP
+from .components.step import Step
+
+__all__ = [
+    "Action",
+    "Expectation",
+    "Goal",
+    "Persona",
+    "Fact",
+    "SkillId",
+    "Step",
+    "data_driven",
+    "tag",
+    "parametrize_simple",
+    "BaseRole",
+    "BaseSkill",
+    "Skill",
+    "wait_until",
+    "UseAPI",
+    "UseBrowser",
+    "UseDatabase",
+    "UseKafka",
+    "UseSOAP",
+]

persona_dsl-26.1.21.32/src/persona_dsl/components/action.py

@@ -0,0 +1,10 @@
+from .step import Step
+
+
+class Action(Step):
+    """
+    Алиас для Step, предназначенный для story-стиля.
+    Не содержит собственной логики.
+    """
+
+    pass