Bodu.Financial.ExchangeRates.DependencyInjection 1.3.0

Bodu.Financial.ExchangeRates.DependencyInjection

API stability - Stable. The public API surface is committed: breaking changes are reserved for a major-version bump per SemVer, except a deliberate break that is recorded in the release notes and in the package's CompatibilitySuppressions.xml. See versioning and support.

Shared dependency-injection machinery for the Bodu.Financial web exchange-rate providers. Every per-source provider package (Boe, Ecb, Rba, Yahoo, Ofx, Xe, Oanda, Fixer, ExchangeRateHost, Fred, Imf) delegates its own Add… registration to the single generic extension defined here, so named-HttpClient configuration, resilience, options binding, and provider lifetime are wired one way across the whole family.

AddWebRateProvider

AddWebRateProvider<TProvider, TOptions> registers a WebRateProvider subclass as a singleton, exposed as both IDatedRateProvider and IRateProvider. It:

• binds and validates TOptions through Microsoft.Extensions.Options;
• configures a named HttpClient for the provider from the options (user agent, HTTP timeout) via IHttpClientFactory, so the provider never owns the client lifetime;
• layers Polly standard resilience over that client, with the attempt / total-request / circuit-breaker windows aligned to the configured timeout; and
• constructs the provider from the resolved client, options, and logger.

A provider package's public Add… method is a thin call through to this:

using Bodu.Financial;
using Bodu.Financial.ExchangeRates;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Http.Resilience;
using Microsoft.Extensions.Logging;

// Inside a provider package's own extension:
public static IFinancialServiceBuilder AddAcmeExchangeRates(
    this IFinancialServiceBuilder builder,
    IConfiguration? configuration = null,
    string sectionName = "Financial:Acme",
    Action<AcmeRateProviderOptions>? configure = null,
    Action<HttpStandardResilienceOptions>? configureResilience = null) =>
    builder.AddWebRateProvider<AcmeRateProvider, AcmeRateProviderOptions>(
        "Acme.Rates",                                   // the named HttpClient
        configuration,                                  // optional; binds sectionName when supplied
        sectionName,
        "Acme exchange-rate options are invalid.",      // the ValidateOnStart message
        configure,                                      // applied after binding
        configureResilience,
        static (client, options, loggerFactory, timeProvider) =>
            new AcmeRateProvider(client, options, loggerFactory?.CreateLogger<AcmeRateProvider>(), timeProvider));

There are two overloads, and both take the client name, an optional configuration, the section name, the validation message, the configure and configureResilience callbacks, and the provider factory. The short overload above serves an options type derived from WebRateProviderOptions, reading its validation, user agent, and timeout itself; the full overload adds explicit validateOptions, getUserAgent, and getHttpTimeout selectors for an options type that does not derive from it.

Consumers do not usually reference this package directly - they add a concrete provider package (which brings this one transitively) and call its Add… method.

Part of the Bodu utility library.