persona-dsl 26.1.20.9__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.9 → persona_dsl-26.1.20.10}/pyproject.toml

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

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) для аналитики.
+