persona-dsl 26.1.20.8__tar.gz → 26.1.20.10__tar.gz

persona_dsl-26.1.20.10/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: persona-dsl
+Version: 26.1.20.10
+Summary: DSL для реализации паттерна Screenplay в Python-тестах.
+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`.
+
+```yaml
+base_url: "https://my-app.test"
+browser:
+  headless: true
+  viewport: { width: 1920, height: 1080 }
+reporting:
+  screenshot_on_fail: true
+```
+
+---
+
+## 📊 Отчетность (Allure + TaaS)
+
+Фреймворк автоматически:
+1. Создает вложенные **Allure Steps** для каждого действия.
+2. Прикрепляет **Скриншоты** и **Page Source** при падении.
+3. Логирует **HTTP запросы/ответы** (если включено).
+4. Интегрируется с платформой **TaaS** (Test as a Service) для аналитики.
+

persona_dsl-26.1.20.10/README.md

@@ -0,0 +1,148 @@
+# 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`.
+
+```yaml
+base_url: "https://my-app.test"
+browser:
+  headless: true
+  viewport: { width: 1920, height: 1080 }
+reporting:
+  screenshot_on_fail: true
+```
+
+---
+
+## 📊 Отчетность (Allure + TaaS)
+
+Фреймворк автоматически:
+1. Создает вложенные **Allure Steps** для каждого действия.
+2. Прикрепляет **Скриншоты** и **Page Source** при падении.
+3. Логирует **HTTP запросы/ответы** (если включено).
+4. Интегрируется с платформой **TaaS** (Test as a Service) для аналитики.
+

{persona_dsl-26.1.20.8 → persona_dsl-26.1.20.10}/pyproject.toml

@@ -4,8 +4,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "persona-dsl"
-version = "26.01.20.008"
+version = "26.01.20.010"
 description = "DSL для реализации паттерна Screenplay в Python-тестах."
+readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [
     "playwright==1.55.0",

persona_dsl-26.1.20.10/src/persona_dsl.egg-info/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: persona-dsl
+Version: 26.1.20.10
+Summary: DSL для реализации паттерна Screenplay в Python-тестах.
+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`.
+
+```yaml
+base_url: "https://my-app.test"
+browser:
+  headless: true
+  viewport: { width: 1920, height: 1080 }
+reporting:
+  screenshot_on_fail: true
+```
+
+---
+
+## 📊 Отчетность (Allure + TaaS)
+
+Фреймворк автоматически:
+1. Создает вложенные **Allure Steps** для каждого действия.
+2. Прикрепляет **Скриншоты** и **Page Source** при падении.
+3. Логирует **HTTP запросы/ответы** (если включено).
+4. Интегрируется с платформой **TaaS** (Test as a Service) для аналитики.
+

persona_dsl-26.1.20.8/PKG-INFO

@@ -1,35 +0,0 @@
-Metadata-Version: 2.4
-Name: persona-dsl
-Version: 26.1.20.8
-Summary: DSL для реализации паттерна Screenplay в Python-тестах.
-Requires-Python: >=3.9
-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-26.1.20.8/README.md

@@ -1,185 +0,0 @@
-# persona-dsl: Руководство пользователя
-
-`persona-dsl` — это ядро фреймворка, реализующее легковесную версию паттерна **Screenplay** для написания автотестов на Python. Оно спроектировано так, чтобы дать вам полный контроль над базовыми инструментами (`Playwright`, `Allure`), предоставляя при этом выразительный и читаемый DSL для описания тестов.
-
-## 1. Основные концепции
-
-В основе фреймворка лежат шесть ключевых компонентов, которые вместе описывают любое взаимодействие с системой.
-
--   **Persona**: "Действующее лицо" или актор, который выполняет действия в тесте. Это главный объект, через который вы будете работать.
--   **Skill**: "Навык" или способность Персоны взаимодействовать с системой. Например, `UseBrowser` для работы с веб-интерфейсом или `UseAPI` для запросов к API.
--   **Ops**: Низкоуровневая, техническая операция (клик, HTTP-запрос). Единственный компонент, который может напрямую использовать `Skill`.
--   **Action**: "Действие", атомарная бизнес-операция, которая может изменять состояние системы. Состоит из последовательности `Ops`.
--   **Fact**: "Факт" о состоянии системы. Действие, которое *не изменяет* состояние, а только запрашивает данные. Также состоит из `Ops`.
--   **Expectation**: "Ожидание", которое проверяет, соответствует ли `Fact` определенному условию (например, `IsEqualTo("some text")`).
--   **Goal**: "Цель", высокоуровневый бизнес-сценарий, объединяющий несколько `Action` и `Fact`.
-
-## 2. Стиль написания тестов
-
-Фреймворк предлагает единый, пошаговый стиль написания тестов, который легко читать и поддерживать.
-
-- **Выполнение действий**: `persona.make(Action(...), Goal(...))`
-- **Получение данных**: `data = persona.get(Fact(...))`
-- **Проверки**: `persona.check(data, Expectation(...))`
-
-```python
-# test_login.py
-from persona_dsl.ops.web import NavigateTo, Fill, Click
-from persona_dsl.facts.web import CurrentPath
-from persona_dsl.expectations.generic import IsEqualTo
-from tests.pages.login_page import LoginPage # Пример объекта страницы
-
-def test_login_flow(persona):
-    login_page = LoginPage()
-
-    # Действия
-    persona.make(
-        NavigateTo("/login"),
-        Fill(login_page.username_field, "testuser"),
-        Fill(login_page.password_field, "password"),
-        Click(login_page.submit_button)
-    )
-
-    # Получение факта
-    current_path = persona.get(CurrentPath())
-
-    # Проверка
-    persona.check(current_path, IsEqualTo("/dashboard"))
-```
-
-## 3. Встроенная функциональность ("Батарейки в комплекте")
-
-Ядро поставляется с `pytest-плагином`, который предоставляет полезные фикстуры и автоматизирует рутинные задачи.
-
-### 3.1. Фикстуры
-
--   `persona`: Главная фикстура. Создает экземпляр `Persona` для теста и автоматически наделяет её нужными навыками.
--   `config`: Загружает конфигурацию из файлов `config/*.yaml` и секреты из `.env.*` в зависимости от окружения (`--env=...`).
--   `testdata`: Удобная фабрика для загрузки тестовых данных из `tests/data/*.{yaml,yml,json}`.
-
-### 3.2. Автоматическая интеграция с Allure
-
-Вам не нужно вручную создавать шаги в отчете, фреймворк делает это за вас:
--   Каждый вызов `persona.make()`, `persona.get()` и `persona.check()` **автоматически** оборачивается в `allure.step()`.
--   Текст шага генерируется из метода `_get_step_description()`, который вы реализуете в своих компонентах.
--   Результат, полученный `Фактом` (`Fact`), автоматически логируется во вложенном шаге.
--   Навык `UseAPI` по явной настройке (`log_bodies=True`) прикрепляет к отчёту полные тела запросов и ответов.
-
-### 3.3. Автоматические артефакты при падении теста
-
-При падении любого теста, который использовал браузер, фреймворк автоматически собирает артефакты для отладки и прикладывает их к Allure-отчету:
-- **Скриншот** последней активной страницы.
-- **HTML-код** страницы (`page source`).
-
-Оба этих параметра включены по умолчанию. Их можно отключить в файле `config/{env}.yaml` в секции `reporting`:
-
-```yaml
-# config/dev.yaml
-reporting:
-  screenshot_on_fail: false
-  pagesource_on_fail: false
-```
-
-### 3.4. Декораторы для тестов
-
-Ядро предоставляет удобные декораторы для работы с `pytest`:
-
--   `@tag("smoke", "regression")`: Позволяет назначать тестам теги (`pytest-маркеры`).
--   `@data_driven(...)`: Упрощает параметризацию тестов, позволяя загружать тестовые данные из списков или файлов в `tests/data/*.{yaml,yml,json}`.
--   `@parametrize_simple(...)`: Обёртка над `pytest.mark.parametrize` для простых наборов данных.
-
-#### Динамические данные в `@data_driven` (SystemVar)
-Вы можете использовать генераторы данных (`SystemVar`) прямо в ваших YAML/JSON файлах для параметризации.
-
-Для этого используется специальная JSON-структура:
-```json
-{
-  "kind": "system",
-  "name": "имя_провайдера",
-  "args": { "аргумент": "значение" }
-}
-```
-
-**Доступные провайдеры (`name`):**
-- `uuid()`: Детерминированный UUID v4.
-- `randomInt(min, max)`: Случайное целое число.
-- `randomFloat(min, max, precision)`: Случайное число с плавающей точкой.
-- `randomString(length, alphabet?)`: Случайная строка.
-- `now(fmt?, tz?)`: Текущая дата/время.
-- `dateShift(days, fmt?, tz?)`: Дата со сдвигом.
-- `fromEnv(name, default?)`: Значение из переменной окружения.
-- `faker(provider, locale?, ...)`: Данные из библиотеки Faker.
-- `sequence(name, seed?)`: Детерминированная числовая последовательность.
-- `concat(parts: list)`: Склеивает строки.
-- `template(pattern, variables)`: Форматирует строку по шаблону.
-
-**Пример (`tests/data/dynamic_users.yaml`):**
-```yaml
-- test_id: "user-1"
-  payload:
-    username:
-      kind: system
-      name: randomString
-      args: { length: 8 }
-    email:
-      kind: system
-      name: faker
-      args: { provider: "email" }
-```
-
-Все значения генерируются детерминированно на основе `run_id`, `env` и `variant_id` (`test_id`), что обеспечивает воспроизводимость тестов.
-
-## 4. Конфигурация и Декларация (`conftest.py`)
-
-Вся настройка фреймворка — декларативная и сосредоточена в `tests/conftest.py`.
-
-### 4.1. Декларация в `conftest.py`
-
-1.  **`class Roles(BaseRole)`**: Enum-класс для объявления всех кастомных ролей (например, `ADMIN`).
-2.  **`class Skills(BaseSkill)`**: Класс для объявления всех именованных навыков (например, `REPORTING_API`).
-3.  **`PERSONA_SKILLS = [...]`**: Список всех навыков, используемых в проекте, для строгой валидации конфигурации.
-4.  **`PERSONA_ROLES = Roles`**: Регистрация ролей для валидации.
-
-```python
-# tests/conftest.py
-from persona_dsl import BaseRole, BaseSkill, SkillId
-
-class Roles(BaseRole):
-    ADMIN = "admin"
-
-class Skills(BaseSkill):
-    REPORTING_API = (SkillId.API, "reporting")
-
-PERSONA_ROLES = Roles
-PERSONA_SKILLS = [
-    BaseSkill.BROWSER,
-    BaseSkill.API,
-    Skills.REPORTING_API,
-]
-```
-
-### 4.2. Структура конфигурации
-
-- **`config/{env}.yaml`**: Параметры для окружения (URL, настройки headless и т.д.).
-- **`config/auth.yaml`**: Секреты и учетные данные.
-
-При запуске плагин автоматически проверяет, что для каждой роли и навыка из `conftest.py` есть соответствующая конфигурация в YAML.
-
-## 5. Готовые компоненты (Ops)
-
-Ядро `persona-dsl` поставляется с набором готовых `Ops` для всех поддерживаемых `Skill`'ов.
-
-- **`persona_dsl.ops.web`**: `NavigateTo`, `Click`, `Fill`, `PressKey`, `ElementText`, `ElementIsVisible`, `PageScreenshot`, `PageAriaSnapshot` и др.
-- **`persona_dsl.ops.api`**: `JsonAs` (для отправки запросов и валидации ответа по Pydantic модели), `SendRequest`.
-- **`persona_dsl.ops.db`**: `FetchOne`, `FetchAll`, `ExecuteSQL`.
-- **`persona_dsl.ops.kafka`**: `SendMessage`, `MessageInTopic`.
-- **`persona_dsl.ops.soap`**: `CallOperation`, `OperationResult`.
-
-## 6. Генераторы кода
-
-Для ускорения разработки `persona-dsl` включает два генератора:
-
--   **`persona-page-gen`**: Интерактивно создает классы `Page` из ARIA-снимка веб-страницы.
--   **`persona-api-gen`**: Генерирует Pydantic-модели и классы `Action`/`Fact` из спецификации OpenAPI.
-
-Это позволяет быстро создавать основу для PageObjects и API-клиентов, сокращая рутинную работу.

persona_dsl-26.1.20.8/src/persona_dsl.egg-info/PKG-INFO

@@ -1,35 +0,0 @@
-Metadata-Version: 2.4
-Name: persona-dsl
-Version: 26.1.20.8
-Summary: DSL для реализации паттерна Screenplay в Python-тестах.
-Requires-Python: >=3.9
-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"