95 lines
3.9 KiB
Markdown
95 lines
3.9 KiB
Markdown
# OTUS Selenium Homework 1
|
|
|
|
## Цель проекта
|
|
Автоматизировать 3 UI-сценария на `https://otus.ru` с использованием Selenium WebDriver 4+, JUnit 5, Guice DI, listeners, Stream API, Jsoup и обязательных проверок качества (Checkstyle + SpotBugs).
|
|
|
|
## Стек технологий
|
|
- Java 21
|
|
- Maven
|
|
- Selenium `4.38.0`
|
|
- WebDriverManager `6.3.3`
|
|
- JUnit 5
|
|
- Guice
|
|
- Jsoup
|
|
- Checkstyle
|
|
- SpotBugs
|
|
|
|
## Реализованные сценарии
|
|
1. Поиск курса по имени.
|
|
- Открытие каталога `https://otus.ru/catalog/courses`
|
|
- Поиск курса по имени через Stream API
|
|
- Клик по плитке курса
|
|
- Проверка заголовка открытого курса
|
|
|
|
2. Самые ранние/поздние курсы по дате старта.
|
|
- Открытие каталога `https://otus.ru/catalog/courses`
|
|
- Поиск ранних и поздних курсов через Stream API + `reduce`
|
|
- При совпадении дат проверяются все курсы с этой датой
|
|
- Проверка названия и даты старта на странице курса через Jsoup
|
|
|
|
3. Случайная категория с главной страницы.
|
|
- Открытие `https://otus.ru`
|
|
- Открытие меню «Обучение»
|
|
- Выбор случайной категории
|
|
- Проверка, что открыта корректная категория
|
|
|
|
## Архитектура
|
|
- 2-уровневый тест-дизайн: `tests` + `page objects`
|
|
- DI через Guice для тестов и страниц
|
|
- JUnit 5 Extension (`GuiceExtension`), без базового класса-теста
|
|
- Фабрика драйвера:
|
|
- `DriverFactory` (интерфейс)
|
|
- `ChromeDriverFactory` (реализация)
|
|
- `WebDriverProvider` (жизненный цикл драйвера + декоратор listener)
|
|
- Подсветка через listener:
|
|
- Подсветка ставится в `beforeClick`
|
|
- Снимается в `afterClick`
|
|
- Стиль элемента возвращается в исходное состояние
|
|
|
|
## Структура проекта
|
|
- `src/main/java/ru/kovbasa/config` — DI-конфигурация
|
|
- `src/main/java/ru/kovbasa/driver` — фабрика и провайдер WebDriver
|
|
- `src/main/java/ru/kovbasa/listeners` — listener подсветки
|
|
- `src/main/java/ru/kovbasa/pages` — Page Object классы
|
|
- `src/main/java/ru/kovbasa/elements` — типизированные UI-элементы
|
|
- `src/test/java/ru/kovbasa/config` — JUnit extension для DI
|
|
- `src/test/java/ru/kovbasa/tests` — автотесты
|
|
|
|
## Требования к окружению
|
|
1. Установлен JDK 21 (доступен в `PATH`)
|
|
2. Установлен Google Chrome
|
|
3. Установлен Maven 3.9+
|
|
4. Есть доступ в интернет и к `otus.ru` (тесты запускаются на живом сайте)
|
|
|
|
## Запуск
|
|
### 1. Запуск только тестов
|
|
```bash
|
|
mvn test
|
|
```
|
|
|
|
### 2. Полная проверка (тесты + Checkstyle + SpotBugs)
|
|
```bash
|
|
mvn verify
|
|
```
|
|
|
|
### 3. Запуск отдельного тестового класса
|
|
```bash
|
|
mvn "-Dtest=ru.kovbasa.tests.CourseSearchTest" test
|
|
```
|
|
|
|
## Параметры запуска
|
|
Пробрасываются через Maven Surefire:
|
|
- `base.url` (по умолчанию `https://otus.ru`)
|
|
- `course.name` (по умолчанию `Python Developer`)
|
|
|
|
Пример переопределения:
|
|
```bash
|
|
mvn "-Dcourse.name=Python Developer" test
|
|
```
|
|
|
|
## Quality Gates
|
|
- Checkstyle и SpotBugs выполняется в фазе `verify`
|
|
|
|
## Примечания
|
|
- Тесты зависят от текущей верстки/контента `otus.ru`.
|