The Codebelt.Extensions.Carter.AspNetCore.Text.Yaml namespace contains types that complements the Codebelt.Extensions.Carter namespace by providing a YAML response negotiator for Carter using YamlDotNet in the context of ASP.NET Core.
Get Started
$ dotnet add package Codebelt.Extensions.Carter.AspNetCore.Text.YamlReadme
Codebelt.Extensions.Carter.AspNetCore.Text.Yaml
A YamlDotNet-powered response negotiator for Carter in ASP.NET Core minimal APIs.
About
Codebelt.Extensions.Carter.AspNetCore.Text.Yaml extends the Codebelt.Extensions.Carter package with a dedicated YAML response negotiator for Carter, capable of serializing response models to YAML format using YamlDotNet.
Use this package when your API clients require YAML responses and you want to keep Carter modules and content negotiation clean and explicit.
CSharp Example
Functional-test style sample (same bootstrapping pattern used by this repository):
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Carter;
using Codebelt.Extensions.Carter.Assets;
using Codebelt.Extensions.Carter.AspNetCore.Text.Yaml;
using Codebelt.Extensions.Xunit.Hosting.AspNetCore;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
using var response = await MinimalWebHostTestFactory.RunAsync(
services =>
{
services.AddMinimalYamlOptions();
services.AddCarter(configurator: c => c
.WithModule<WorldModule>()
.WithResponseNegotiator<YamlResponseNegotiator>());
services.AddRouting();
},
app =>
{
app.UseRouting();
app.UseEndpoints(endpoints => endpoints.MapCarter());
},
_ => { },
async client =>
{
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/yaml"));
return await client.GetAsync("/world/statistical-regions");
});
Program-style usage for production apps (remember to inherit from ICarterModule for your endpoints and add other services as needed):
using Carter;
using Codebelt.Extensions.AspNetCore.Text.Yaml.Formatters;
using Codebelt.Extensions.Carter.AspNetCore.Text.Yaml;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddMinimalYamlOptions();
builder.Services.AddCarter(c => c
.WithResponseNegotiator<YamlResponseNegotiator>());
var app = builder.Build();
app.MapCarter();
app.Run();