GoogleTest

Анонсы

Live at Head

GoogleTest теперь следует философии Abseil Live at Head. Мы рекомендуем как можно чаще обновлять код до последнего коммита в ветке main. Время от времени мы публикуем семантические версии, помеченные как v${major}.${minor}.${patch} (например, v1.14.0).

Обновления документации

Наша документация теперь доступна на GitHub Pages по адресу https://google.github.io/googletest/. Рекомендуется просматривать документацию на GitHub Pages, а не непосредственно в репозитории.

Версия 1.14.0

Версия 1.14.0 теперь доступна. Для ветки 1.14.x требуется как минимум C++14.

Непрерывная интеграция

Мы используем внутренние системы Google для непрерывной интеграции. Были добавлены GitHub Actions для удобства участников с открытым исходным кодом. Они исключительно поддерживаются сообществом с открытым исходным кодом и не используются командой GoogleTest.

Скоро появится

• Мы планируем сделать зависимость от Abseil.
• Запланированы дополнительные улучшения документации.

Добро пожаловать в GoogleTest, фреймворк для тестирования C++ от Google!

Этот репозиторий представляет собой объединение ранее отдельных проектов GoogleTest и GoogleMock. Эти проекты были настолько тесно связаны, что имеет смысл поддерживать и выпускать их вместе.

Начало работы

См. Руководство пользователя GoogleTest для получения документации. Рекомендуется начать с GoogleTest Primer.

Более подробную информацию о сборке GoogleTest можно найти в googletest/README.md.

Особенности

• xUnit-фреймворк: GoogleTest основан на популярной архитектуре xUnit для модульного тестирования.
• Обнаружение тестов: GoogleTest автоматически обнаруживает и запускает ваши тесты, избавляя от необходимости вручную регистрировать тесты.
• Богатый набор утверждений: GoogleTest предоставляет множество утверждений, таких как равенство, неравенство, исключения и многое другое, упрощая тестирование вашего кода.
• Пользовательские утверждения: вы можете определять свои собственные утверждения с помощью GoogleTest, делая написание тестов, специфичных для вашего кода, простым.
• Тесты на смерть: GoogleTest поддерживает тесты на смерть, которые проверяют, что ваш код завершается определённым образом, что полезно для тестирования кода обработки ошибок.
• Фатальные и нефатальные сбои: с помощью GoogleTest вы можете указать, должен ли сбой теста рассматриваться как фатальный или нефатальный, позволяя тестам продолжать выполняться даже при возникновении сбоя.
• Тестирование с параметризацией значений: GoogleTest поддерживает тестирование с параметризацией значений, которое выполняется несколько раз с разными входными значениями, что полезно при тестировании функций, принимающих разные входные данные.
• Типизированное тестирование: GoogleTest также поддерживает типизированное тестирование, которое выполняется с различными типами данных, что полезно при тестировании функций, работающих с разными типами данных.
• Различные варианты запуска тестов: GoogleTest предлагает множество вариантов запуска тестов, включая запуск отдельных тестов, запуск тестов в определённом порядке и запуск тестов параллельно.

Поддерживаемые платформы

GoogleTest следует политике поддержки фундаментального C++ Google. См. эту таблицу для списка поддерживаемых версий компиляторов, платформ и инструментов сборки.

Кто использует GoogleTest?

Помимо многих внутренних проектов Google, GoogleTest также используется следующими известными проектами:

• Проекты Chromium (за браузером Chrome и операционной системой Chrome OS).
• Компилятор LLVM. Буферы — формат обмена данными от Google, который позволяет передавать данные между различными системами.

OpenCV — библиотека компьютерного зрения.

Связанные проекты с открытым исходным кодом

GTest Runner — это автоматизированный тестовый раннер и графический интерфейс пользователя на основе Qt5 с мощными функциями для платформ Windows и Linux.

GoogleTest UI — это тестовый раннер, который запускает ваш тестовый бинарный файл, позволяет отслеживать его прогресс через индикатор выполнения и отображает список неудачных тестов. При нажатии на один из них отображается текст ошибки. GoogleTest UI написан на C#.

GTest TAP Listener — это слушатель событий для GoogleTest, который реализует протокол TAP (Test Anything Protocol) для вывода результатов теста. Если ваш тестовый раннер понимает TAP, вы можете найти его полезным.

gtest-parallel — это раннер тестов, который выполняет тесты из вашего бинарного файла параллельно, что обеспечивает значительное ускорение.

Адаптер GoogleTest — это расширение VS Code, которое позволяет просматривать GoogleTest в виде дерева и запускать/отлаживать ваши тесты.

C++ TestMate — это расширение VS Code, позволяющее просматривать GoogleTest в виде дерева и запускать/отлаживать тесты.

Cornichon — небольшой парсер Gherkin DSL, который генерирует код-заглушку для GoogleTest.

Внесение изменений

Пожалуйста, ознакомьтесь с CONTRIBUTING.md для получения подробной информации о том, как внести свой вклад в этот проект.

Счастливого тестирования!