Package Overview

Packages

Cocoar.Configuration.Abstractions

Lightweight interfaces for decoupled architecture. Reference this from libraries that need to accept configuration without depending on the full implementation.

• Target: .NET 8.0 / .NET 9.0
• Dependencies: None
• Key types: IConfigurationAccessor, IReactiveConfig<T>, ISecret<T>, SecretLease<T>

<PackageReference Include="Cocoar.Configuration.Abstractions" Version="5.*" />

Cocoar.Configuration

The core library. Includes providers, reactive engine, secrets, feature flags, and entitlements.

• Target: .NET 8.0 / .NET 9.0
• Dependencies: Cocoar.Configuration.Abstractions, Cocoar.Configuration.Analyzers (build-time), Cocoar.Capabilities, Cocoar.FileSystem, Cocoar.Json.Mutable, Microsoft.Extensions.Logging.Abstractions
• Key types: ConfigManager, Secret<T>, IFeatureFlags<TConfig>, IEntitlements<TConfig>, FeatureFlags, Entitlements, FeatureFlag<T>, Entitlement<T>

<PackageReference Include="Cocoar.Configuration" Version="5.*" />

Cocoar.Configuration.DI

Microsoft.Extensions.DependencyInjection integration.

• Target: .NET 8.0 / .NET 9.0
• Dependencies: Cocoar.Configuration, Cocoar.Capabilities
• Key types: AddCocoarConfiguration() extension method

<PackageReference Include="Cocoar.Configuration.DI" Version="5.*" />

Cocoar.Configuration.AspNetCore

ASP.NET Core integration — includes DI and adds health checks, feature flag/entitlement REST endpoints.

• Target: .NET 8.0 / .NET 9.0
• Dependencies: Cocoar.Configuration, Cocoar.Configuration.DI, Microsoft.AspNetCore.App (FrameworkReference)
• Key types: AddCocoarConfigurationHealthCheck(), MapFeatureFlagEndpoints(), MapEntitlementEndpoints()

<PackageReference Include="Cocoar.Configuration.AspNetCore" Version="5.*" />

TIP

AspNetCore includes DI, which includes Core — you only need one PackageReference.

Cocoar.Configuration.Http

Remote configuration provider with support for one-time fetch, polling, and Server-Sent Events (SSE). Separate package to avoid forcing an HTTP dependency on all consumers.

• Target: .NET 8.0 / .NET 9.0
• Dependencies: Cocoar.Configuration
• Key types: FromHttp() extension method, HttpRuleOptions

<PackageReference Include="Cocoar.Configuration.Http" Version="5.*" />

Cocoar.Configuration.MicrosoftAdapter

Bridge from Microsoft.Extensions.Configuration sources (Azure Key Vault, custom providers, etc.) into Cocoar.Configuration.

• Target: .NET 8.0 / .NET 9.0
• Dependencies: Cocoar.Configuration, Microsoft.Extensions.Configuration.*
• Key types: FromIConfiguration() extension method

<PackageReference Include="Cocoar.Configuration.MicrosoftAdapter" Version="5.*" />

Cocoar.Configuration.Analyzers

Roslyn analyzers (COCFG001–006) and source generator (COCFLAG001–003). Ships as a build-time dependency of the core package — you don't need to install it separately.

• Target: .NET Standard 2.0 (Roslyn requirement)
• Dependencies: Microsoft.CodeAnalysis.CSharp (build-time only)
• Key types: 5 configuration analyzers, 3 flags diagnostics, 1 incremental source generator

Cocoar.Configuration.Secrets.Cli

Global .NET tool for encrypting and decrypting secrets in JSON configuration files.

dotnet tool install -g Cocoar.Configuration.Secrets.Cli

• Target: .NET 9.0
• Commands: encrypt, decrypt, generate-cert, convert-cert, cert-info

Dependency Graph

Abstractions (no deps)
    │
    ▼
  Core ◄──── Analyzers (build-time)
    │
    ├──► Http
    ├──► MicrosoftAdapter
    │
    ▼
   DI
    │
    ▼
 AspNetCore

Each arrow means "depends on". Installing a downstream package brings all upstream packages transitively.

Which Package Do I Need?

Scenario	Package
ASP.NET Core application	Cocoar.Configuration.AspNetCore
Console app or library with DI	Cocoar.Configuration.DI
Library without DI	Cocoar.Configuration
Interface-only dependency	Cocoar.Configuration.Abstractions
Remote config (polling / SSE)	Add Cocoar.Configuration.Http
Existing IConfiguration sources	Add Cocoar.Configuration.MicrosoftAdapter

External Dependencies

All shipped packages have zero non-Microsoft external dependencies. The only third-party packages are Cocoar ecosystem libraries (Cocoar.Capabilities, Cocoar.FileSystem, Cocoar.Json.Mutable).

System.Reactive is not a dependency — the library uses lightweight internal reactive primitives. Consumers are free to use System.Reactive on their side (the public API is IObservable<T>, which is BCL).

License

All packages are licensed under Apache-2.0.