FluentAzure 0.2.0-rc.5

FluentAzure

A fluent, functional, and type-safe NuGet package for Azure configuration and secrets management.

🎯 Problem This Solves

Azure developers constantly struggle with:

• Multiple configuration sources (Environment variables, Key Vault, App Configuration, JSON files)
• Complex error handling when secrets are missing or invalid
• No type safety in configuration access
• Imperative, verbose code for simple configuration scenarios
• Poor testing experience for configuration-dependent code

🚀 Solution: Functional Configuration Pipeline

Instead of this imperative mess:

// Traditional approach - verbose and error-prone
var builder = new ConfigurationBuilder();
builder.AddEnvironmentVariables();
builder.AddAzureKeyVault(vaultUrl);
var config = builder.Build();

var connectionString = config["ConnectionString"];
if (string.IsNullOrEmpty(connectionString))
{
    throw new InvalidOperationException("ConnectionString is required");
}

var timeout = int.Parse(config["Timeout"] ?? "30");
// ... more boilerplate

Write this ultra-clean pipeline:

// FluentAzure approach - ultra clean and safe
using FluentAzure; // Single using statement!

var config = await FluentConfig
    .Create()  // Ultra clean - just FluentConfig.Create()!
    .FromEnvironment()
    .FromKeyVault("https://myvault.vault.azure.net")
    .Required("ConnectionString")
    .Optional("Timeout", 30)
    .Validate(c => c.ConnectionString.StartsWith("Server="))
    .BuildAsync()
    .Match(
        success => success,
        errors => throw new ConfigurationException(errors)
    );

📦 Installation

dotnet add package FluentAzure

Or add to your .csproj:

<PackageReference Include="FluentAzure" Version="0.2.0-rc.5" />

🔢 Version Information

You can access the current version programmatically:

using FluentAzure;

// Get the current version
string version = FluentConfig.CurrentVersion; // "0.2.0-rc.5"

// Or access version details directly
int major = FluentAzure.Version.Major;     // 0
int minor = FluentAzure.Version.Minor;     // 2
int patch = FluentAzure.Version.Patch;     // 0
bool isPreRelease = FluentAzure.Version.IsPreRelease; // true

📖 Example Usage Patterns

Ultra Clean Configuration (Recommended)

using FluentAzure; // Single using statement!

var config = await FluentConfig
    .Create()  // Ultra clean - just FluentConfig.Create()!
    .FromEnvironment()
    .Required("DATABASE_URL")
    .Optional("CACHE_TTL", "300")
    .BuildAsync();

Complex Enterprise Setup

using FluentAzure; // Single using statement!

var config = await FluentConfig
    .Create()  // Ultra clean - just FluentConfig.Create()!
    .FromJsonFile("appsettings.json")
    .FromEnvironment()
    .FromKeyVault("https://company-prod-kv.vault.azure.net")
    .Transform("ConnectionString", DecryptConnectionString)
    .Validate(c => Uri.IsWellFormedUriString(c.ServiceUrl, UriKind.Absolute))
    .Bind<AppConfiguration>()
    .BuildAsync();

Dependency Injection

// Program.cs
using FluentAzure;

builder.Services.AddFluentAzure<AppSettings>(config => config
    .FromEnvironment()
    .FromKeyVault(builder.Configuration["KeyVault:Url"]) // or any other sources
);

// Controller
public class ApiController : ControllerBase
{
    private readonly AppSettings _settings;

    public ApiController(AppSettings settings)
    {
        _settings = settings;
    }
}

Web API Example

// Program.cs
using FluentAzure;

var configResult = await FluentConfig
    .Create()  // Ultra clean - just FluentConfig.Create()!
    .FromJsonFile("appsettings.json")
    .FromEnvironment()
    .FromKeyVault(builder.Configuration["KeyVault:Url"])
    .Required("ConnectionStrings:DefaultConnection")
    .Required("Jwt:SecretKey")
    .Optional("Logging:LogLevel:Default", "Information")
    .BuildAsync()
    .Bind<WebApiConfiguration>();

var config = configResult.Match(
    success => { builder.Services.AddSingleton(success); return success; },
    errors => throw new InvalidOperationException($"Configuration failed: {string.Join(", ", errors)}")
);

🚀 Getting Started

Prerequisites

• .NET 8.0 SDK
• Azure subscription (for Key Vault/App Configuration)

Quick Start

1. Install the package: dotnet add package FluentAzure
2. Add using statement: using FluentAzure; (that's it!)
3. Use the fluent API: FluentConfig.Create() (ultra clean)
4. Handle results with the Match method for type-safe error handling

Features

• Ultra Clean API: Use FluentConfig.Create() directly with just using FluentAzure;
• Fluent API: Chain configuration sources with readable syntax
• Type Safety: Compile-time validation and runtime error handling
• Multiple Sources: Environment variables, Key Vault, JSON files, and more
• Dependency Injection: Seamless integration with .NET DI container
• Performance: Intelligent caching and lazy loading

🔄 API Comparison

Ultra Clean (Recommended)

using FluentAzure;
var config = await FluentConfig.Create()...

Legacy (Deprecated)

using FluentAzure.Core;
var config = await FluentAzure.Configuration()...

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Code style and standards
• Testing requirements
• Pull request process
• Development setup

📚 Resources

• Functional Programming in C#
• Azure Key Vault Developer Guide
• Result Pattern in C#
• Monads in C#

Ready to revolutionize Azure configuration management? Let's build something awesome! 🚀