Anarchy.Toolkit.Testing.Aws
2.0.1
dotnet add package Anarchy.Toolkit.Testing.Aws --version 2.0.1
NuGet\Install-Package Anarchy.Toolkit.Testing.Aws -Version 2.0.1
<PackageReference Include="Anarchy.Toolkit.Testing.Aws" Version="2.0.1" />
<PackageVersion Include="Anarchy.Toolkit.Testing.Aws" Version="2.0.1" />
<PackageReference Include="Anarchy.Toolkit.Testing.Aws" />
paket add Anarchy.Toolkit.Testing.Aws --version 2.0.1
#r "nuget: Anarchy.Toolkit.Testing.Aws, 2.0.1"
#:package Anarchy.Toolkit.Testing.Aws@2.0.1
#addin nuget:?package=Anarchy.Toolkit.Testing.Aws&version=2.0.1
#tool nuget:?package=Anarchy.Toolkit.Testing.Aws&version=2.0.1
Anarchy.Toolkit.Testing.Aws
Part of Anarchy I/O Toolkit, a .NET developer platform · Pillar: Infrastructure · Layer: Testing kit · Package catalog
AWS messaging helpers for SNS/SQS integration tests, typically against LocalStack.
dotnet add package Anarchy.Toolkit.Testing.Aws
- Use
SqsHelperandAwsMessageBrokerHelperto work with test queues and messaging resources. SqsMessageFixturebuilds SQS messages, including gzip/zlib-compressed payloads.- Supply a suitable AWS or LocalStack endpoint and resources for your integration tests.
When to use it
Use this test-only package to exercise SNS/SQS publishing or message processing against a controlled AWS-compatible environment, or to construct SQS event fixtures without a live broker. It does not start LocalStack or provision infrastructure automatically for the whole test suite.
How to use it
- Start a dedicated LocalStack instance or configure a separate test AWS account and supply an application settings object implementing
IAwsAppSettings. - Construct
AwsMessageBrokerHelperwith those settings, and optionally anAppTelemetry(for exampleFixtureTelemetry.Telemetry) to receive its progress logs. Use its queue/topic preparation methods and, when needed, subscribe a queue to a topic before exercising the code under test. - Receive and assert messages with the helper; use
SqsMessageFixturewhen testing a Lambda handler with a constructedSQSEvent, including compressed bodies. - Dispose the helper and clean up test resources. Use unique names or isolate tests that purge queues, and never point destructive cleanup at production resources.
The generic SqsHelper<TAppSettings> can use the test settings of your settings type; see the testing guide for details. PrepareTopicAsync deletes and recreates an existing topic, so isolate resource names carefully.
See Infrastructure.Messaging.Aws, the testing conventions and the toolkit overview.
Releases
See the release notes for the complete release history.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Amazon.Extensions.Configuration.SystemsManager (>= 7.1.1)
- Amazon.Lambda.APIGatewayEvents (>= 3.0.1)
- Amazon.Lambda.Core (>= 3.4.0)
- Amazon.Lambda.SQSEvents (>= 3.0.1)
- Amazon.Lambda.TestUtilities (>= 4.3.0)
- Anarchy.Toolkit.Infrastructure.Messaging.Aws (>= 2.0.1)
- Anarchy.Toolkit.Testing (>= 2.0.1)
- AwesomeAssertions (>= 9.6.0)
- AWSSDK.Core (>= 4.1.1.2)
- AWSSDK.KeyManagementService (>= 4.1.1.1)
- AWSSDK.SecretsManager (>= 4.1.1.2)
- AWSSDK.SimpleNotificationService (>= 4.1.0.2)
- AWSSDK.SQS (>= 4.1.0.2)
- Humanizer (>= 3.0.10)
- Microsoft.AspNetCore.WebUtilities (>= 10.0.15)
- Microsoft.Extensions.Caching.Memory (>= 10.0.15)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.15)
- Microsoft.Extensions.Configuration.Json (>= 10.0.15)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.15)
- Microsoft.Extensions.Diagnostics (>= 10.0.15)
- Microsoft.Extensions.Hosting (>= 10.0.15)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.15)
- Microsoft.Extensions.Logging (>= 10.0.15)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.15)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.15)
- Microsoft.Identity.Client (>= 4.92.0)
- Microsoft.NET.Test.Sdk (>= 18.12.0)
- Moq (>= 4.21.0)
- Newtonsoft.Json (>= 13.0.4)
- Spectre.Console (>= 0.57.2)
- xunit.v3.extensibility.core (>= 4.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
## Releases
### 2.0.1
- chore(build): Format package release notes property
### 2.0.0
- feat(automation): establish onboarding and layering conventions
- feat(telemetry)!: introduce provider-neutral application telemetry
- refactor(packages)!: restructure persistence and automation packages
- refactor(infrastructure.correlationid)!: decouple correlation scopes from Serilog
- refactor(core)!: reshape telemetry, event and health contracts
- refactor(telemetry)!: remove legacy APIs and simplify namespaces
### 1.1.1
- docs(packages): identify each package's pillar and layer
- build(packages): attribute the copyright to Leandro Melão Medeiros
- build: relicense under Apache-2.0 and update the package metadata
### 1.1.0
- build(deps): upgrade Swashbuckle.AspNetCore to 11.0.1 and Microsoft.OpenApi to 3.11.1
### 1.0.7
- docs: expand XML docblocks across all projects for the DocFX API reference
### 1.0.6
- refactor(src): clean up code style across library packages
- chore(deps): update AWS SDK, Lambda ASP.NET Core server and MySqlConnector packages
### 1.0.5
- chore(deps): update AWS SDK packages
### 1.0.3
- build: migrate local automation to build tooling
### 1.0.2
- docs: expand package guides and release histories
- chore(deps): update AWS, Polly, and xUnit packages
### 1.0.1
- Added a package-specific NuGet README.
### 1.0.0
- Introduced AWS messaging test helpers, SQS helpers and an SQS message fixture.