.. index::
    !single: usage

*****
Usage
*****

.. toctree::
    :maxdepth: 3
    :hidden:

    integration-submodule
    build-as-library
    run-unit-tests

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.

.. grid:: 3
    :margin: 4 4 0 0
    :gutter: 1

    .. grid-item-card:: :fas:`code-branch;sd-text-success` Integrate as Submodule
        :link: integration-submodule
        :link-type: doc

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

    .. grid-item-card:: :fas:`cogs;sd-text-success` Build as a Library
        :link: build-as-library
        :link-type: doc

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

    .. grid-item-card:: :fas:`vial;sd-text-success` Run Unit Tests
        :link: run-unit-tests
        :link-type: doc

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