Configuration

These topics explain how to parse, validate, and navigate ELCL documents, and how to extend text parsing with application values and safe transformations.

• Configuration Overview
  • Parsing and Validation
  • Value-Tree Navigation
  • Typed Value Access
  • Validation Rules
  • Validated Values
  • Source Resolving
  • Source Access Control
  • Placeholder Expansion
  • Document Signatures
  • Signature Validation
  • Signing Configuration Files
• Parsing Configuration Documents
  • Parse and Access a Document
  • Understand Error Locations and Source Excerpts
  • Choose the Document Lifetime
  • Validate Small Documents Directly
  • Load Validation Rules from a Document
  • Build Validation Rules in C++
  • Continue with the Value API
• Working with Configuration Trees
  • How ELCL Becomes a Tree
  • Address Values with Name Paths
  • Identify a Value in the Document
  • Navigate Between Parents and Children
  • Iterate over Lists and Sections
  • Continue with Individual Values
• Accessing Configuration Values
  • Convert the Current Value
  • Choose a Structural View for Lists
  • Read Settings with Typed Getters
  • Require Uniform Lists and Matrices
  • Inspect Types Before Choosing a Representation
  • Validate Before Access
• Validating Documents with Rule Schemas
  • Embed a Rules Document
  • Build Rules into C++
  • Choose the Rule Source
  • Continue with Validated Values
• Using Values after Validation
  • Use Rule Metadata in User Interfaces
  • Secret Configuration Values and Sensitive Storage
  • Recognize Values Supplied by Defaults
  • Validation Metadata Lifetime and Configuration-Tree Ownership
• Resolving Configuration Sources
  • From Include Text to Parsed Content
  • Use the Default File Resolver
  • Restrict Accepted File Syntax
  • Write an Application-Specific Resolver
  • Extend or Replace File Resolving
• Controlling Access to Configuration Sources
  • Access Checks for Root and Included Sources
  • Default File Include Access Restrictions
  • Configuring File Access
  • Extending the File Policy
  • Writing a Complete Access Policy
  • Disabling Includes
• Using Placeholders in Configuration Text
  • Reading Placeholder Expressions
  • Where Expansion Applies
  • Enabling Built-in Sources and Filters
  • Providing Application Values
  • Transforming Values with Filters
  • Reporting Lookup and Transformation Errors
  • Restricting Placeholder Sources and Filters
• Trusting Signed Configuration Files
  • Why Sign Configuration Files?
  • Trust Anchors and Signing-Key Trust
  • How ELCL Carries a Signature
  • Parser Responsibilities and Application Trust Policy
• Validating Configuration Signatures
  • SignatureValidator Inputs and Trust Decisions
  • A Compact Shared-Secret Validator
  • Enforcing Validation During Parsing
  • Strict and Development Policies
  • Signature Rejection and Trusted-Key Rotation
• Signing Configuration Documents
  • What the Signing Tool Does
  • Implementing a Signing Backend
  • A Complete Parse, Sign, and Verify Workflow
  • Signing the Exact Reviewed Document Bytes
  • Choosing Where Signing Happens