Universal.CodeGeneration.CSharp 1.0.0

Universal.CodeGeneration.CSharp

A library for generating C# source code from various specifications, specializing in strongly-typed HTTP clients and URI builders.

Classes

HttpServiceClientGenerator

Generates complete, strongly-typed HTTP service client code from API specifications (such as OpenAPI/Swagger). It handles the generation of methods, request/response models, enums, and hierarchical resource navigation.

// Parse the OpenAPI JSON
string json = File.ReadAllText("openapi.json");
var spec = HttpServiceClientGenerator.ApiSpecification.FromOpenApi(json);

// Configure generation options
var options = new HttpServiceClientGenerator.Options
{
    BaseClass = HttpServiceClientGenerator.BaseClientType.JsonHttpServiceClient,
    GenerateModelClasses = true,
    UseHierarchicalResources = true,
    JsonSerializer = HttpServiceClientGenerator.JsonSerializerType.SystemTextJson
};

// Generate the code
var generator = new HttpServiceClientGenerator("MyApi.Client", "ApiClient", options);
string sourceCode = generator.Generate(spec);

UriBuilderGenerator

Generates strongly-typed UriBuilder code from route definitions. This allows for type-safe URL construction based on defined API paths, supporting both fluent and flat API styles.

// Define routes manually or parse from OpenAPI
var routes = new List<UriBuilderGenerator.ApiRoute>
{
    new UriBuilderGenerator.ApiRoute { Path = "users/{userId:int}/orders" },
    new UriBuilderGenerator.ApiRoute { Path = "products/{category}/{id}" }
};

var options = new UriBuilderGenerator.Options
{
    UseFluentGeneration = true,
    FluentOptions = new UriBuilderGenerator.FluentGenerationOptions
    {
        UseNestedNamespaces = true,
        CollapseIdMethods = true
    }
};

var generator = new UriBuilderGenerator("MyNamespace", "MyApiRoutes", options);
string sourceCode = generator.Generate(routes);

ObjectExtensions

Extensions for converting runtime objects into their C# code initialization string representation. Useful for meta-programming and generating code that initializes objects with specific states.

// Simple types
int number = 42;
string numberCode = number.ToInitializerString(); // "42"

// Collections
var list = new List<string> { "A", "B" };
string listCode = list.ToInitializerString(); 
// "new List<string>() { "A", "B" }"

// Complex objects
var data = new { Id = 1, CreatedAt = DateTime.Now };
string objectCode = data.ToInitializerString();
// Generates object initialization syntax recursively