A high-performance, low-allocation capability composition library for .NET that implements the Capability Composition pattern for building extensible, type-safe systems.
dotnet add package Cocoar.CapabilitiesusingCocoar.Capabilities;// Create a scope and compose capabilities onto a subjectvarscope=newCapabilityScope();scope.Compose("user-service").Add(newLoggingCapability{Level=LogLevel.Debug}).Add(newRetryCapability{MaxAttempts=3}).Build();// Query the compositionvarcomposition=scope.Compositions.GetRequired<string>("user-service");varlogging=composition.GetFirstOrDefault<LoggingCapability>();Console.WriteLine(composition.Has<LoggingCapability>());// TrueFull documentation with guides, API reference, and examples:
- Getting Started — Install, compose, query
- Why Capabilities? — The problem this solves
- API Reference — Complete method reference
- Examples — Real-world patterns
| Type | Role |
|---|---|
CapabilityScope | Container that manages composers and compositions |
Composer | Fluent builder for attaching capabilities to a subject |
IComposition | Immutable, thread-safe result of a composition |
IPrimaryCapability | Marker interface for the "identity" capability |
CapabilityScope<TOwner> | Strongly-typed scope with immutable owner |
- SemVer (additive MINOR, breaking MAJOR)
- PRs & issues welcome
- Licensed under Apache License 2.0 (explicit patent grant & attribution via NOTICE)
This project is licensed under the Apache License, Version 2.0. See NOTICE for attribution.
"Cocoar" and related marks are trademarks of COCOAR e.U. Use of the name in forks or derivatives should preserve attribution and avoid implying official endorsement. See TRADEMARKS for permitted and restricted uses.