persona-dsl 26.1.20.8__py3-none-any.whl → 26.1.20.10__py3-none-any.whl

persona_dsl-26.1.20.10.dist-info/METADATA

@@ -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.dist-info → persona_dsl-26.1.20.10.dist-info}/RECORD

@@ -79,8 +79,8 @@ persona_dsl/utils/path.py,sha256=wwYUS3euYqwKQdxWHD8Lq93Ln1G0M5LIJ6AMqiwpmDI,725
 persona_dsl/utils/retry.py,sha256=kBbu6rpySdeaqRzUkgdrsEWrc9PwkvRhYtRzyhrYj9g,2215
 persona_dsl/utils/taas_integration.py,sha256=OZzSjgC1_90eTYXo3WPsCgCtYc35U216SBnxClpdIkw,5046
 persona_dsl/utils/waits.py,sha256=I9e_9rs_0Rju61yx_hS-qwcXd4zNWfVNyfhY0mOHrj0,4386
-persona_dsl-26.1.20.8.dist-info/METADATA,sha256=KNXOfE_w4lSVK1mrUNKwWpgicoj5K6c_rb9EAt7UtbM,1108
-persona_dsl-26.1.20.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-persona_dsl-26.1.20.8.dist-info/entry_points.txt,sha256=8lYko6uS1gGeYX9_FYbbeO5XV_BP62T7RngyKuKDD7k,180
-persona_dsl-26.1.20.8.dist-info/top_level.txt,sha256=N1YAJab5h4iPt-srbrjzDk6bY40bwR1AHZS5Z0eOzvM,12
-persona_dsl-26.1.20.8.dist-info/RECORD,,
+persona_dsl-26.1.20.10.dist-info/METADATA,sha256=qg4_AVi6LQ2iWAqxoGenj6ajYDoixOsi8pfh7F0onDM,7057
+persona_dsl-26.1.20.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+persona_dsl-26.1.20.10.dist-info/entry_points.txt,sha256=8lYko6uS1gGeYX9_FYbbeO5XV_BP62T7RngyKuKDD7k,180
+persona_dsl-26.1.20.10.dist-info/top_level.txt,sha256=N1YAJab5h4iPt-srbrjzDk6bY40bwR1AHZS5Z0eOzvM,12
+persona_dsl-26.1.20.10.dist-info/RECORD,,

persona_dsl-26.1.20.8.dist-info/METADATA

@@ -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"