Automated testing is an important part of software development, helping ensure that bugs are caught early and regression issues are prevented. In this blog post, we will explore how to get started with testing in .NET Aspire, allowing us to test scenarios across our distributed applications.<\/p>\n
Distributed applications are inherently complex, you need to ensure components such as databases, caches, etc. are available and in the correct state. Then your application may have multiple services that need to be tested together. .NET Aspire is a great tool to help us define the environment for our application, connecting together all the services and resources, making it easy to launch our environment.<\/p>\n
And this is equally true when it comes to end-to-end, or integration, testing of an application. We need to ensure that the database is in an expected state for a test, avoid having other tests interfere with our test, and ensure that the application is running in the correct configuration. This is something that .NET Aspire can help us with.<\/p>\n
Thankfully, we have the .NET Aspire Aspire.Hosting.Testing NuGet package<\/a> which can help us with this. Let\u2019s take a look at how we can use this package to write tests.<\/p>\n To get started, we\u2019re going to create a new .NET Aspire Starter App project. This will create a new .NET Aspire application with the AppHost, Service Defaults, an API backend and a Blazor web frontend.<\/p>\n Ensure you have the .NET Aspire workload installed:<\/p>\n dotnet workload update Then create a new project using the aspire-starter template:<\/p>\n dotnet new aspire-starter –name AspireWithTesting<\/p>\n Next, we need to add a test project, and we can choose from one of three testing frameworks, MSTest, xUnit or Nunit. For this example, we\u2019ll use MSTest. This can be created using the aspire-mstest template:<\/p>\n dotnet new aspire-mstest –name AspireWithTesting.Tests Note<\/strong><\/p>\n You can have the test project included when creating with the aspire-starter template by adding the –test-framework MSTest (or other framework) flag.<\/p><\/div>\n The template already references the Aspire.Hosting.Testing NuGet package, as well as the chosen testing framework (MSTest in this case), so the last thing we need to do is add a reference to the AppHost<\/strong> project in our Test project: We\u2019ll find there is already a stub test file, IntegrationTest1.cs in our test project that describes the steps above and provides an example of tests that can be written, but let\u2019s start from scratch so we can understand what\u2019s going on. Create a new file called FrontEndTests.cs and add the following code:<\/p>\n namespace AspireWithTesting.Tests;<\/p>\n [TestClass] await using var app = await appHost.BuildAsync(); var resourceNotificationService = var httpClient = app.CreateHttpClient(“webfrontend”); Assert.AreEqual(HttpStatusCode.OK, response.StatusCode); Awesome, the test is written, let\u2019s run it:<\/p>\n dotnet test<\/p>\n And if everything goes to plan, we should see output such as:<\/p>\n Test summary: total: 1, failed: 0, succeeded: 1, skipped: 0, duration: 0.9s<\/p>\n Let\u2019s break down what\u2019s happening in the test:<\/p>\n var appHost = await using var app = await appHost.BuildAsync(); This first section of the test is using the AppHost<\/strong> project that defines all our resources, services, and their relationships, and then starts it up, as if we did a dotnet run against the project, but in a test environment which we can control some additional aspects. For example, we\u2019re injecting the StandardResilienceHandler into the HttpClient that the tests are going to use to interact with the services in the AppHost. Once the testing AppHost is configured, we can build the application, ready to be started.<\/p>\n var resourceNotificationService = Because the AppHost will be starting several different resources and services, we need to ensure that they are available to us before we try to run tests against them. After all, if the web application hasn\u2019t started and we try to resolve it, we\u2019re going to get an error. The ResourceNotificationService is a service that allows us to wait for a resource to be in a particular state, in this case, we\u2019re waiting for the webfrontend (the name we set in the AppHost) to be in the Running state, and we\u2019re giving it 30 seconds to do so. This pattern would need to be repeated for any other services that we\u2019re going to interact with, whether directly or indirectly.<\/p>\n var httpClient = app.CreateHttpClient(“webfrontend”); Assert.AreEqual(HttpStatusCode.OK, response.StatusCode);<\/p>\n Finally, we can request an instance of HttpClient from the app that has been started and provide the name of the service we want to interact with. This uses the same service discovery as the rest of the application, so we don\u2019t need to worry about the URL or port that the service is running on. We can then make a request to the service, in this case, the root of the web frontend, and check that we get a 200 OK response, confirming that the service is running and responding as expected.<\/p>\n Testing the API service is a very similar approach to the frontend service, but since it\u2019s returning data, we can take it a step further and assert against the data that is returned:<\/p>\n using System.Net.Http.Json;<\/p>\n namespace AspireWithTesting.Tests;<\/p>\n [TestClass] await using var app = await appHost.BuildAsync(); var resourceNotificationService = var httpClient = app.CreateHttpClient(“apiservice”); Assert.AreEqual(HttpStatusCode.OK, response.StatusCode);<\/p>\n var forecasts = await response.Content.ReadFromJsonAsync<IEnumerable<WeatherForecast>>(); record WeatherForecast(DateOnly Date, int TemperatureC, string? Summary); Note<\/strong><\/p>\n Since the WeatherForecast record is private in the API project, we need to define it in the test project to be able to deserialize the JSON response.<\/p><\/div>\n Once we\u2019ve asserts that the API endpoint returned a 200 OK response, we can then deserialize the JSON response into a collection of WeatherForecast objects and assert against the data. In this case, the data we have for our API is randomly generated so we\u2019re only asserting on the number of records returned, but if we had a database that the data came from, the test could assert against the expected data.<\/p>\n In this blog post, we\u2019ve explored how to get started with testing in .NET Aspire, allowing us to test scenarios across our distributed applications. We\u2019ve seen how to write tests for the frontend and API services, ensuring that they are running and responding as expected.<\/p>\n .NET Aspire Testing Documentation<\/a><\/p>\n The post Getting started with testing and .NET Aspire<\/a> appeared first on .NET Blog<\/a>.<\/p>","protected":false},"excerpt":{"rendered":" Automated testing is an important part of software development, helping ensure that bugs are caught early and regression issues are […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[7],"tags":[],"class_list":["post-1264","post","type-post","status-publish","format-standard","hentry","category-dotnet"],"_links":{"self":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/1264","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/comments?post=1264"}],"version-history":[{"count":0,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/1264\/revisions"}],"wp:attachment":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/media?parent=1264"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/categories?post=1264"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/tags?post=1264"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Getting Started<\/h2>\n
\ndotnet workload install aspire<\/p>\n
\ndotnet sln add AspireWithTesting.Tests<\/p>\n
\ndotnet add AspireWithTesting.Tests reference AspireWithTesting.AppHost<\/p>\nWriting Tests<\/h2>\n
\npublic class FrontEndTests
\n{
\n [TestMethod]
\n public async Task CanGetIndexPage()
\n {
\n var appHost =
\n await DistributedApplicationTestingBuilder
\n .CreateAsync<Projects.AspireWithTesting_AppHost>();
\n appHost.Services.ConfigureHttpClientDefaults(clientBuilder =>
\n {
\n clientBuilder.AddStandardResilienceHandler();
\n });<\/p>\n
\n await app.StartAsync();<\/p>\n
\n app.Services.GetRequiredService<ResourceNotificationService>();
\n await resourceNotificationService
\n .WaitForResourceAsync(“webfrontend”, KnownResourceStates.Running)
\n .WaitAsync(TimeSpan.FromSeconds(30));<\/p>\n
\n var response = await httpClient.GetAsync(“\/”);<\/p>\n
\n }
\n}<\/p>\nUnderstanding the Test<\/h2>\n
\n await DistributedApplicationTestingBuilder
\n .CreateAsync<Projects.AspireWithTesting_AppHost>();
\nappHost.Services.ConfigureHttpClientDefaults(clientBuilder =>
\n{
\n clientBuilder.AddStandardResilienceHandler();
\n});<\/p>\n
\nawait app.StartAsync();<\/p>\n
\n app.Services.GetRequiredService<ResourceNotificationService>();
\nawait resourceNotificationService
\n .WaitForResourceAsync(“webfrontend”, KnownResourceStates.Running)
\n .WaitAsync(TimeSpan.FromSeconds(30));<\/p>\n
\nvar response = await httpClient.GetAsync(“\/”);<\/p>\nTesting the API<\/h2>\n
\npublic class ApiTests
\n{
\n [TestMethod]
\n public async Task CanGetWeatherForecast()
\n {
\n var appHost =
\n await DistributedApplicationTestingBuilder.CreateAsync<Projects.AspireWithTesting_AppHost>();
\n appHost.Services.ConfigureHttpClientDefaults(clientBuilder =>
\n {
\n clientBuilder.AddStandardResilienceHandler();
\n });<\/p>\n
\n await app.StartAsync();<\/p>\n
\n app.Services.GetRequiredService<ResourceNotificationService>();
\n await resourceNotificationService
\n .WaitForResourceAsync(“apiservice”, KnownResourceStates.Running)
\n .WaitAsync(TimeSpan.FromSeconds(30));<\/p>\n
\n var response = await httpClient.GetAsync(“\/weatherforecast”);<\/p>\n
\n Assert.IsNotNull(forecasts);
\n Assert.AreEqual(5, forecasts.Count());
\n }<\/p>\n
\n}<\/p>\nVideo<\/h2>\n\n
Summary<\/h2>\n