1.📎Полезное

➣ Ручное тестирование проводим на проде

➣ Автотесты проходят на тесте

➣ Баги оставляем в таблице

➣ Общая инструкция по работе с доской

2.📋Требования

Для запуска проекта вам нужно установить следующие библиотеки:

• pytest — тестовый фреймворк.
• pytest-playwright — интеграция Playwright с Pytest.
• playwright — для автоматизации браузера.
• allure - для сбора отчетов.
• Faker — для генерации поддельных данных.
• pydantic — для валидации данных.
• Ruff - инструмент для анализа Python-кода
  • Если вы хотите увидеть список доступных подкоманд и опций, используйте:

  ruff --help

  • Если вы хотите проверить весь проект на ошибки форматирования, выполните:

  ruff check .

  • Для форматирования кода:

  ruff format .

3.🔁 Как работаем с репозиторием

1. Клонируем
2. Создаем ветку для своих тестов
3. Пушим ветку в Github
4. Открываем запрос на слияние с main
5. Отправляем запрос в slack чат #qa_python_project или #team_python_project_2024_fall
6. Обязательно удаляем свою ветку после слияния с main

4.⚙️ Установка

1. Клонируйте репозиторий:

   git clone https:https://github.com/RedRoverSchool/BookClubQA_Python_2024_fall.git
   cd BookClubQA_Python_2024_fall

2. Создайте виртуальное окружение:

   python -m venv venv
   source venv/bin/activate  # Для macOS/Linux
   venv\Scripts\activate  # Для Windows

3. Установите зависимости:

   pip install -r requirements.txt

4. Для запуска тестов, убедитесь, что у вас установлен Playwright:

   playwright install

   playwright --version

После этого ваш проект будет готов к запуску.

---

5. 📊 Отчеты

Чтобы получить отчет о тестах в формате Allure, выполните команду:

pytest --alluredir=allure-results

allure serve allure-results

После этого Allure откроет отчет в браузере.

---

6.✍ Как пишем тесты

1. Тесты пишем в соответствии с шаблоном

• Локаторы храним в components
• Тест должен начинаться с авторизации

2. Соблюдаем правила кода PEP8
3. Тесты НЕ должны повторяться
4. Перед пушем в репозиторий тесты необходимо проверить на работоспособность
5. Не работаем в одной ветке долго, чтобы уменьшить количество конфликтов
6. Не самые важные тесты стоит помечать маркером slow (@pytest.mark.slow)

7. Swagger доступен только на тестовом окружении.

Открыть http://testing.misleplav.ru/api/swagger/

---

8. Замечания

• Проект развивается, и функциональность может изменяться, что может приводить к неактуальности некоторых тестов.
• В некоторых случаях тесты могут ломаться из-за изменений в тестируемом веб-приложении или обновлений зависимостей.
• Если тесты не проходят, пожалуйста, проверьте последние изменения в коде, а также убедитесь, что все зависимости актуальны и правильно настроены.
• В случае возникновения ошибок, связанных с Playwright или другими инструментами, обновление библиотек или повторная настройка окружения может помочь.

playwright codegen http://tester:dslfjsdfblkhew%40122b1klbfw@testing.misleplav.ru/