Environment Contract

Defines the core abstraction for accessing environment configuration and managing active profiles. This interface extends both:

• PropertyResolver: for resolving configuration properties (e.g., values defined in environment variables, property files, or injected maps).
• PackageIdentifier: for uniquely identifying the runtime context or configuration package.

Profiles

Profiles are logical groupings of configuration settings that allow an application to adapt to different runtime contexts such as:

• dev (development)
• test (testing/CI)
• staging (pre-production verification)
• prod (production)

Profiles can be explicitly activated or fall back to defaults when none are provided. They are commonly used in conditional configuration, e.g., loading different data sources, enabling debugging, or disabling experimental features.

Example

void configure(Environment env) {
  if (env.matchesProfiles(['dev & !prod'])) {
    // Apply development-only settings
  }
}