Как запустить unit test

• Модуль csv - чтение и запись CSV файлов
• Создаём сайт на Django, используя хорошие практики. Часть 1: создаём проект
• Онлайн-обучение Python: сравнение популярных программ

• Книги о Python
• GUI (графический интерфейс пользователя)
• Курсы Python
• Модули
• Новости мира Python
• NumPy
• Обработка данных
• Основы программирования
• Примеры программ
• Типы данных в Python
• Видео
• Python для Web
• Работа для Python-программистов

• Сделай свой вклад в развитие сайта!
• Самоучитель Python
• Карта сайта
• Отзывы на книги по Python
• Реклама на сайте

Начало работы с модульным тестированием

Область применения:Visual Studio Visual Studio для Mac Visual Studio Code

Используйте Visual Studio, чтобы определить и запустить модульные тесты для обеспечения работоспособности кода, нужного объема протестированного кода, а также для обнаружения ошибок и сбоев, прежде чем с ними столкнутся клиенты. Выполняйте модульные тесты регулярно, чтобы обеспечить правильную работу вашего кода.

В этой статье код использует C# и C++, иллюстрации представлены на C#, однако концепции и функции применимы к языкам .NET, C++, Python, JavaScript и TypeScript.

Создание модульных тестов.

В этом разделе описывается создание проекта модульного теста.

Откройте проект, который хотите протестировать в Visual Studio. В целях демонстрации примера модульного теста в этой статье тестируется простой консольный проект C# или C++ "Hello World" с именем HelloWorld. Пример кода для такого проекта выглядит следующим образом:

namespace HelloWorld < public class Program < public static void Main() < Console.WriteLine("Hello World!"); >> > 

#include int main()

Совет Только для C#: вы можете создавать проекты модульных тестов из кода, используя более быстрый метод. Дополнительные сведения см. в разделе Создание проектов модульных тестов и методов теста. Чтобы использовать этот метод для .NET Core или .NET Standard, требуется Visual Studio 2019 или более поздней версии.

На следующем рисунке показано модульный тест MSTest, поддерживаемый в .NET.

Нажмите Далее, выберите имя для тестового проекта и нажмите Создать.

Нажмите Далее, выберите имя для тестового проекта и нажмите Создать.

Проект добавляется в решение.

• MSTest
• NUnit
• xUnit
• Платформа Microsoft Native Unit Test Framework

using Microsoft.VisualStudio.TestTools.UnitTesting; using System.IO; using System; namespace HelloWorldTests < [TestClass] public class UnitTest1 < private const string Expected = "Hello World!"; [TestMethod] public void TestMethod1() < using (var sw = new StringWriter()) < Console.SetOut(sw); HelloWorld.Program.Main(); var result = sw.ToString().Trim(); Assert.AreEqual(Expected, result); >> > > 

using NUnit.Framework; using System.IO; using System; namespace HelloWorldTests < public class Tests < private const string Expected = "Hello World!"; [SetUp] public void Setup() < >[Test] public void TestMethod1() < using (var sw = new StringWriter()) < Console.SetOut(sw); HelloWorld.Program.Main(); var result = sw.ToString().Trim(); Assert.AreEqual(Expected, result); >> > > 

using System; using Xunit; using System.IO; namespace HelloWorldTests < public class UnitTest1 < private const string Expected = "Hello World!"; [Fact] public void Test1() < using (var sw = new StringWriter()) < Console.SetOut(sw); HelloWorld.Program.Main(); var result = sw.ToString().Trim(); Assert.Equal(Expected, result); >> > > 

#include "pch.h" #include "CppUnitTest.h" #include "../HelloWorldUnitTestCPP/HelloWorldUnitTestCPP.cpp" // Update using your project name using namespace Microsoft::VisualStudio::CppUnitTestFramework; namespace HelloWorldTests < TEST_CLASS(HelloWorldTests) < public: TEST_METHOD(TestMethod) < std::string expected = "Hello World!\n"; std::stringstream buffer; std::streambuf* sbuf = std::cout.rdbuf(); // Save cout's buffer std::cout.rdbuf(buffer.rdbuf()); // Redirect cout to the stringstream buffer // Call main() in your test int result = main(); // When finished, redirect cout to the original buffer std::cout.rdbuf(sbuf); std::cout >; > 

Выполнение модульных тестов

1. Откройте обозреватель тестов. Откройте обозреватель тестов, выбрав Тест>Обозреватель тестов в верхней строке меню (или нажмите клавиши CTRL + E, T).
2. Запустите модульные тесты, нажав Запустить все (или нажмите клавиши CTRL + R, V).

После завершения зеленый флажок указывает, что тест пройден. Красный значок "x" указывает на сбой теста.

Используйте обозреватель тестов для запуска модульных тестов из встроенной платформы тестирования (MSTest) или сторонней платформы тестирования. Вы можете группировать тесты по категориям, фильтровать список тестов, а также создавать, сохранять и запускать списки воспроизведения тестов. Кроме того, с его помощью можно выполнять отладку тестов и анализировать производительность тестов и покрытие кода.

Просмотр результатов динамического модульного тестирования (Visual Studio Enterprise)

Если вы используете платформу тестирования MSTest, xUnit или NUnit в Visual Studio 2017 или более поздней версии, можно просмотреть динамические результаты модульных тестов.

Для выполнения этих шагов требуется Visual Studio Enterprise вместе с кодом .NET и одной из следующих платформ тестирования: MSTest, xUnit или NUnit.

1. Включите Live Unit Testing в меню Тест, выбрав Тест>Live Unit Testing>Запустить.

Дополнительные сведения о Live Unit Testing см. в разделе Live Unit Testing.

Использование сторонней платформы тестирования

Вы можете запускать модульные тесты в Visual Studio с помощью сторонних тестовых платформ, таких как NUnit, Boost или Google C++ Testing Framework, в зависимости от вашего языка программирования. Чтобы использовать стороннюю платформу тестирования, выполните следующие действия.

• Используйте диспетчер пакетов NuGet, чтобы установить пакет NuGet для выбранной платформы.
• (.NET) Начиная с Visual Studio 2017 версии 14.6, Visual Studio включает в себя предварительно настроенные шаблоны тестовых проектов для платформ тестирования NUnit и xUnit. Шаблоны также содержат необходимые пакеты NuGet, чтобы обеспечить поддержку.
• (C++) В Visual Studio 2017 и более поздних версиях уже включены некоторые платформы, такие как Google C++ Testing Framework. Дополнительные сведения см. в статье Написание модульных тестов для C/C++ в Visual Studio.

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

1. Откройте решение, содержащее код, который нужно протестировать.
2. В обозревателе решений щелкните решение правой кнопкой мыши и выберите Добавить>Создать проект.
3. Выберите шаблон проекта модульного теста. Для того примера — NUnit

Щелкните Далее, назовите проект и нажмите кнопку Создать.

Пошаговое руководство. Создание и запуск модульных тестов для управляемого кода

Область применения:Visual Studio Visual Studio для Mac Visual Studio Code

В этой статье приводится подробное описание процесса создания, запуска и настройки набора модульных тестов с помощью платформы модульных тестов Майкрософт для управляемого кода и обозревателя тестов Visual Studio. В руководстве производится создание проекта C#, находящегося в стадии разработки, создание тестов для проверки его кода, запуск тестов и изучение результатов. После этого производится изменение кода проекта и повторный запуск тестов. Если вы хотите получить концептуальный обзор этих задач перед выполнением этих шагов, см. Основы модульного тестирования.

Создайте проект для тестирования

1. Откройте Visual Studio.
2. На начальном экране выберите Создать проект.
3. Найдите и выберите шаблон проекта консольного приложения C# для .NET и нажмите кнопку "Далее".

Примечание. Если шаблон Консольное приложение отсутствует, его можно установить из окна Создание проекта. В сообщении Не нашли то, что искали? выберите ссылку Установка других средств и компонентов. После этого в Visual Studio Installer выберите рабочую нагрузку Разработка классических приложений .NET.

Примечание. Если файл Program.cs не откроется в редакторе, дважды щелкните Program.cs в обозревателе решений, чтобы открыть его.

using System; namespace BankAccountNS < /// 
/// Bank account demo class. ///
 public class BankAccount < private readonly string m_customerName; private double m_balance; private BankAccount() < >public BankAccount(string customerName, double balance) < m_customerName = customerName; m_balance = balance; >public string CustomerName < get < return m_customerName; >> public double Balance < get < return m_balance; >> public void Debit(double amount) < if (amount >m_balance) < throw new ArgumentOutOfRangeException("amount"); >if (amount < 0) < throw new ArgumentOutOfRangeException("amount"); >m_balance += amount; // intentionally incorrect code > public void Credit(double amount) < if (amount < 0) < throw new ArgumentOutOfRangeException("amount"); >m_balance += amount; > public static void Main() < BankAccount ba = new BankAccount("Mr. Bryan Walton", 11.99); ba.Credit(5.77); ba.Debit(11.22); Console.WriteLine("Current balance is $", ba.Balance); > > > 

Теперь у вас есть проект с методами, которые можно протестировать. В этой статье тестирование проводится на примере метода Debit . Метод Debit вызывается, когда денежные средства снимаются со счета.

Создание проекта модульного теста

Совет В обозревателе решений щелкните решение правой кнопкой мыши и выберите пункты Добавить>Создать проект.

Примечание. в Visual Studio 2019 версии 16.9 шаблон проекта MSTest имеет формат проекта модульного теста.

Создание тестового класса

Создание тестового класса, чтобы проверить класс BankAccount . Можно использовать UnitTest1.cs, созданный в шаблоне проекта, но лучше дать файлу и классу более описательные имена.

Переименуйте файл и класс

1. Чтобы переименовать файл, в обозревателе решений выберите файл UnitTest1.cs в проекте BankTests. В контекстном меню выберите команду Переименовать (или нажмите клавишу F2), а затем переименуйте файл в BankAccountTests.cs.
2. Чтобы переименовать класс, поместите курсор в UnitTest1 в редакторе кода, щелкните правой кнопкой мыши и выберите команду Переименовать (или нажмите клавиши F2). Введите название BankAccountTests и нажмите клавишу ВВОД.

Файл BankAccountTests.cs теперь содержит следующий код:

// The 'using' statement for Test Tools is in GlobalUsings.cs // using Microsoft.VisualStudio.TestTools.UnitTesting; namespace BankTests < [TestClass] public class BankAccountTests < [TestMethod] public void TestMethod1() < >> > 

Добавьте оператор using

Можно также добавить оператор using в класс, чтобы тестируемый проект можно было вызывать без использования полных имен. Вверху файла класса добавьте:

using BankAccountNS; 

Требования к тестовому классу

Минимальные требования к тестовому классу следующие:

• Атрибут [TestClass] является обязательным в любом классе, содержащем методы модульных тестов, которые необходимо выполнить в обозревателе тестов.
• Каждый метод теста, предназначенный для запуска в обозревателе тестов, должен иметь атрибут [TestMethod] .

Можно иметь другие классы в проекте модульного теста, которые не содержат атрибута [TestClass] , а также иметь другие методы в тестовых классах, у которых атрибут — [TestMethod] . Можно вызывать эти другие классы и методы в методах теста.

Создание первого тестового метода

В этой процедуре необходимо написать методы модульного теста, чтобы проверить поведение Debit метода BankAccount класса.

Существует по крайней мере три поведения, которые требуется проверить:

• Метод создает исключение ArgumentOutOfRangeException , если сумма по дебету превышает баланс.
• Метод создает исключение ArgumentOutOfRangeException, если сумма по дебету меньше нуля.
• Если значение дебета допустимо, то метод вычитает сумму дебета из баланса счета.

Метод по умолчанию TestMethod1 можно удалять, так как он не используется в этом руководстве.

Создание метода теста

Первый тест проверяет, снимается ли со счета нужная сумма при допустимом размере кредита (со значением меньшим, чем баланс счета, и большим, чем ноль). Добавьте следующий метод в этот класс BankAccountTests :

[TestMethod] public void Debit_WithValidAmount_UpdatesBalance() < // Arrange double beginningBalance = 11.99; double debitAmount = 4.55; double expected = 7.44; BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance); // Act account.Debit(debitAmount); // Assert double actual = account.Balance; Assert.AreEqual(expected, actual, 0.001, "Account not debited correctly"); >

Метод очень прост: он создает новый объект BankAccount с начальным балансом, а затем снимает допустимое значение. Он использует метод Assert.AreEqual, чтобы проверить, что конечный баланс соответствует ожидаемому. Такие методы, как Assert.AreEqual , Assert.IsTrue и другие, зачастую используются в модульном тестировании. Дополнительную концептуальную информацию о написании модульного теста см. в разделе Написание тестов.

Требования к методу теста

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

• Он декорируется атрибутом [TestMethod] .
• Он возвращает void .
• Он не должен иметь параметров.

Сборка и запуск теста

1. В меню Сборка нажмите Построить решение (или нажмите клавиши CTRL + SHIFT + B).
2. Если тест Обозреватель не открыт, откройте его, выбрав> тестовый тест Обозреватель (или тестовый>тест Windows> Test Обозреватель) в верхней строке меню (или нажмите клавиши CTRL + E, T).
3. Выберите Запустить все, чтобы выполнить тест (или нажмите клавиши CTRL + R, V). Во время выполнения теста в верхней части окна Обозреватель тестов отображается анимированная строка состояния. По завершении тестового запуска строка состояния становится зеленой, если все методы теста успешно пройдены, или красной, если какие-либо из тестов не пройдены. В данном случае тест пройден не будет.
4. Выберите этот метод в обозревателе тестов для просмотра сведений в нижней части окна.

Исправление кода и повторный запуск тестов

Результат теста содержит сообщение, описывающее возникшую ошибку. Чтобы увидеть это сообщение, может потребоваться выполнить детализацию. Для метода AreEqual выводится сообщение о том, что ожидалось и что было фактически получено. Ожидалось, что баланс уменьшится, а вместо этого он увеличился на сумму списания.

Модульный тест обнаружил ошибку: сумма списания добавляется на баланс счета, вместо того чтобы вычитаться.

Исправление ошибки

Чтобы исправить эту ошибку, в файле BankAccount.cs замените строку:

m_balance += amount; 

m_balance -= amount; 

Повторный запуск теста

В обозревателе тестов выберите Запустить все, чтобы запустить тест повторно (или нажмите клавиши CTRL + R, V). Красно-зеленая строка становится зеленой, чтобы указать, что тест был пройден.

Использование модульных тестов для улучшения кода

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

Анализ проблем

Мы создали тестовый метод для подтверждения того, что допустимая сумма правильно вычитается в методе Debit . Теперь проверим, что метод создает исключение ArgumentOutOfRangeException, если сумма по дебету:

• больше баланса или
• меньше нуля.

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

Создадим метод теста для проверки правильного поведения в случае, когда сумма по дебету меньше нуля:

[TestMethod] public void Debit_WhenAmountIsLessThanZero_ShouldThrowArgumentOutOfRange() < // Arrange double beginningBalance = 11.99; double debitAmount = -100.00; BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance); // Act and assert Assert.ThrowsException(() => account.Debit(debitAmount)); > 

Мы используем метод ThrowsException для подтверждения правильности созданного исключения. Этот метод приводит к тому, что тест не будет пройден, если не возникнет исключения ArgumentOutOfRangeException. Если временно изменить тестируемый метод для вызова более общего исключения ApplicationException при значении суммы по дебету меньше нуля, то тест работает правильно, т. е. завершается сбоем.

Чтобы проверить случай, когда размер списания превышает баланс, выполните следующие действия:

1. Создать новый метод теста с именем Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange .
2. Скопировать тело метода из Debit_WhenAmountIsLessThanZero_ShouldThrowArgumentOutOfRange в новый метод.
3. Присвоить debitAmount значение, превышающее баланс.

Выполните два теста и убедитесь, что они пройдены.

Продолжение анализа

Еще раз проанализировав тестируемый метод BankAccount.Debit , можно заметить, что оба условных оператора используют конструктор ArgumentOutOfRangeException , который просто получает имя аргумента в качестве параметра:

throw new ArgumentOutOfRangeException("amount"); 

Существует конструктор, который можно использовать, чтобы отчеты гораздо более подробные сведения: ArgumentOutOfRangeException(String, Object, String) включает имя аргумента, значение аргумента и определяемое пользователем сообщение. Мы можем выполнить рефакторинг тестируемого метода для использования данного конструктора. Более того, можно использовать открытые для общего доступа члены типа для указания ошибок.

Рефакторинг тестируемого кода

Сначала определим две константы для сообщений об ошибках в области видимости класса. Поместите определения в тестируемый класс: BankAccount

public const string DebitAmountExceedsBalanceMessage = "Debit amount exceeds balance"; public const string DebitAmountLessThanZeroMessage = "Debit amount is less than zero"; 

Затем изменим два условных оператора в методе Debit :

if (amount > m_balance) < throw new System.ArgumentOutOfRangeException("amount", amount, DebitAmountExceedsBalanceMessage); >if (amount

Рефакторинг тестовых методов

Выполните рефакторинг методов теста, удалив вызов Assert.ThrowsException. Заключите вызов Debit() в блок try/catch , перехватите конкретное ожидаемое исключение и проверьте соответствующее ему сообщение. Метод Microsoft.VisualStudio.TestTools.UnitTesting.StringAssert.Contains обеспечивает возможность сравнения двух строк.

В этом случае метод Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange может выглядеть следующим образом:

[TestMethod] public void Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange() < // Arrange double beginningBalance = 11.99; double debitAmount = 20.0; BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance); // Act try < account.Debit(debitAmount); >catch (System.ArgumentOutOfRangeException e) < // Assert StringAssert.Contains(e.Message, BankAccount.DebitAmountExceedsBalanceMessage); >> 

Повторное тестирование, переписывание и анализ

Метод теста сейчас обрабатывает не все требуемые случаи. Если тестируемый метод Debit не смог выдать исключение ArgumentOutOfRangeException, когда значение debitAmount было больше остатка (или меньше нуля), метод теста выдает успешное прохождение. Этот сценарий не подходит, так как требуется, чтобы метод теста не завершился ошибкой, если исключение не возникает.

Этот результат является ошибкой в методе тестирования. Для решения этой проблемы добавим утверждение Assert.Fail в конце тестового метода для обработки случая, когда исключение не создается.

Однако повторный запуск теста показывает, что тест теперь оказывается непройденным при перехватывании верного исключения. Блок catch перехватывает исключение, но метод продолжает выполняться, и в нем происходит сбой на новом утверждении Assert.Fail. Чтобы разрешить эту проблему, добавим оператор return после StringAssert в блоке catch . Повторный запуск теста подтверждает, что проблема устранена. Окончательная версия метода Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange выглядит следующим образом:

[TestMethod] public void Debit_WhenAmountIsMoreThanBalance_ShouldThrowArgumentOutOfRange() < // Arrange double beginningBalance = 11.99; double debitAmount = 20.0; BankAccount account = new BankAccount("Mr. Bryan Walton", beginningBalance); // Act try < account.Debit(debitAmount); >catch (System.ArgumentOutOfRangeException e) < // Assert StringAssert.Contains(e.Message, BankAccount.DebitAmountExceedsBalanceMessage); return; >Assert.Fail("The expected exception was not thrown."); > 

Заключение

Усовершенствования тестового кода привели к созданию более надежных и информативных методов теста. Но что более важно, в результате был также улучшен тестируемый код.

В этом пошаговом руководстве используется платформа модульных тестов Microsoft для управляемого кода. Обозреватель тестов также может запускать тесты c платформ модульных тестов стороннего производителя, которые имеют адаптеры для обозревателя тестов. Дополнительные сведения см. в разделе Установка платформ модульного тестирования сторонних поставщиков.

Связанный контент

Сведения о запуске тестов из командной строки см. в разделе Параметры командной строки VSTest.Console.exe.