Skip to content

RedRoverSchool/BookClubQA_Python_2024_fall

Repository files navigation

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
  • Тест должен начинаться с авторизации
  1. Соблюдаем правила кода PEP8
  2. Тесты НЕ должны повторяться
  3. Перед пушем в репозиторий тесты необходимо проверить на работоспособность
  4. Не работаем в одной ветке долго, чтобы уменьшить количество конфликтов
  5. Не самые важные тесты стоит помечать маркером slow (@pytest.mark.slow)

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

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


8. Замечания

  • Проект развивается, и функциональность может изменяться, что может приводить к неактуальности некоторых тестов.
  • В некоторых случаях тесты могут ломаться из-за изменений в тестируемом веб-приложении или обновлений зависимостей.
  • Если тесты не проходят, пожалуйста, проверьте последние изменения в коде, а также убедитесь, что все зависимости актуальны и правильно настроены.
  • В случае возникновения ошибок, связанных с Playwright или другими инструментами, обновление библиотек или повторная настройка окружения может помочь.
playwright codegen http://tester:dslfjsdfblkhew%[email protected]/