Usage

This chapter shows you how to work with the Erbsland Configuration Parser in real-world projects.

You’ll learn how to integrate it smoothly into your own codebase, build it as a standalone library if needed, and run the included unit tests to ensure everything works as expected.

Integrate as Submodule

Learn the recommended way to include the parser as a Git submodule for seamless project integration and version control.

Integrate the Parser as Submodule
Add Validation Rules (Submodule)

Extend the recommended submodule setup to compile and link one of the validation-rules library variants.

Integrate Validation Rules as a Submodule
Tutorial: Embedded ELCL Rules

Learn how to embed a validation-rules ELCL document directly into your application and validate configuration documents.

Use Validation-Rules as Embedded ELCL Document
Tutorial: Code-Built Rules

Build validation rules with RulesBuilder in C++ code and apply them to parsed configuration documents.

Use Validation-Rules Built from Code
Install as a Static Library

Prefer a standalone library? This guide walks you through building and installing the parser as a static library.

Install the Parser as Static Library
Install Validation-Rules Libraries

Build validation-rules library variants and install their static archives for local system-wide usage.

Install Validation-Rules Static Libraries
Run Unit Tests

Validate your setup and contribute confidently by running the parser’s unit tests.

How to Run the Unit Tests