Release Notes

Version 9.0.3

New Features

FromHeader Parameter Support

Added [FromHeader] parameter support in WebClient models for C#, TypeScript, and Python code generation

Route Constraint Parsing

Improved route segment parsing to handle type-constrained route templates (e.g., {value:int}, {text:string})

Python Indentation

Changed Python code generation to use spaces instead of tabs for PEP 8 compliance

Unit Tests

Added dedicated unit test projects for each language target:
- Albatross.CodeGen.WebClient.CSharp.UnitTest - C# web client generation tests
- Albatross.CodeGen.WebClient.Python.UnitTest - Python web client generation tests
- Albatross.CodeGen.CSharp.UnitTest - Core C# code generation tests
- Albatross.CodeGen.Python.UnitTest - Core Python code generation tests
- Albatross.CodeGen.TypeScript.UnitTest - Core TypeScript code generation tests

Documentation

Added documentation articles for C# and Python web client settings
Added build-vs-buy codegen decision checklist

Project Structure

Migrated solution to new .slnx format
Removed legacy Slack sink options from CLI entry point
Updated project files with Albatross.Testing dependency for unit tests

Version 9.0.2

Current release with full support for .NET 10.0.

Breaking Changes - C# Web Client Generation

The C# web client code generation has been completely redesigned with the following changes:

Class Naming

Generated client classes are now named *Client instead of *ProxyService (e.g., HttpMethodTestClient instead of HttpMethodTestProxyService)

Base Class and Dependencies

Generated clients no longer inherit from ClientBase
Dependency changed from Albatross.WebClient to Albatross.Http
Constructor no longer requires an ILogger parameter - only HttpClient is needed
Each client now manages its own HttpClient and JsonSerializerOptions fields

Method Signatures

All async methods now include a CancellationToken parameter as the last argument

Request Building

Replaced the old CreateRequest/CreateJsonRequest pattern with a new fluent RequestBuilder API:

var builder = new RequestBuilder()
    .WithMethod(HttpMethod.Get)
    .WithRelativeUrl($"{ControllerPath}/{id}");

Query string handling uses builder.AddQueryString() and builder.AddQueryStringIfSet() instead of NameValueCollection

Response Handling

Uses new HttpClient extension methods: client.Send<T>(), client.Execute<T>(), client.ExecuteOrThrow<T>(), client.ExecuteOrThrowStruct<T>()
Methods accept jsonSerializerOptions and cancellationToken parameters

Date/Time Formatting

Date formatting extension changed from ISO8601String() to ISO8601()

Legacy Support

The previous C# web client generators have been preserved for backward compatibility:

LegacyConvertWebApiToCSharpFile and LegacyCreateHttpClientRegistrations (marked as [Obsolete])
Use codegen csharp legacy-web-client command to generate clients using the previous pattern that depends on Albatross.WebClient

Table of Contents