mola_yaml

YAML helper library common to MOLA modules. A C++ library to parse YAML files with extended syntax allowing variable replacing, recursive includes of other YAML files, etc.

Build and install

Refer to the root MOLA repository.

Docs and examples

See this package page in the documentation.

License

This package is released under the BSD-3 license.

Changelog for package mola_yaml

Forthcoming

• feat: new [$define]{.title-ref} YAML directive to bind variables for a subtree (including imported files), letting launchers tune shared pipeline settings without duplicating blocks.
• fix(mola_yaml): an outer file's [$define]{.title-ref} now correctly wins over a more deeply imported file's own [$define]{.title-ref}.
• Contributors: Jose Luis Blanco-Claraco

3.0.0 (2026-07-17)

• docs: list all debug/trace env variables
• Merge pull request #161 from MOLAorg/feat/yaml-import-override feat(mola_yaml): $import map directive for base-file + overrides
• feat(mola_yaml): add $import map directive for base-file + overrides A map with an [$import]{.title-ref} key (a path, or a sequence of paths) is replaced by the deep-merge of the imported file(s) with the map's remaining keys overlaid on top, so sibling entries OVERRIDE the imported base (nested maps merge deeply; scalars/sequences replace). This complements [$include{}]{.title-ref} (which replaces a whole node) and lets near-identical launch files share a common params block while tweaking just a few values, instead of duplicating it. - Resolved in the same first pass as [$include{}]{.title-ref}, reusing its path pre-processing, relative-path resolution and circular-reference detection. - Unit tests: single import, multi-file sequence (later file wins), sibling override including deep-nested, load_yaml_file path, and missing-file throw.
  • Docs: new section + processing-order table row in the SLAM config format.
• Contributors: Jose Luis Blanco-Claraco

2.9.0 (2026-05-11)

• Merge pull request #143 from MOLAorg/bump-cmake-version bump min req cmake version to 3.22
• bump min req cmake version to 3.22
• Contributors: Jose Luis Blanco-Claraco

2.8.0 (2026-04-29)

2.7.0 (2026-04-22)

2.6.1 (2026-04-02)

• Merge pull request #114 from MOLAorg/feat/refactor-yaml-parser Refactor mola_yaml parser (faster, less memory usage, non recursive)
• Refactor mola_yaml parser (faster, less memory usage, non recursive)
• Contributors: Jose Luis Blanco-Claraco

2.6.0 (2026-03-12)

• Merge pull request #107 from MOLAorg/fix/viz-decay-clouds Fix/viz-decay-clouds
• fix clang-tidy warning: avoid std::endl
• Update coyright notes
• Contributors: Jose Luis Blanco-Claraco

2.5.0 (2026-02-14)

• Merge pull request #100 from MOLAorg/fix/remove-mrpt-deprecated-maps Remove use of mrpt deprecated maps
• Avoid use of deprecated mrpt::maps classes
• Contributors: Jose Luis Blanco-Claraco

2.4.0 (2025-12-28)

2.3.0 (2025-12-15)

2.2.1 (2025-11-08)

• Fix embedded FindFilesystem.cmake to avoid cmake warnings
• Contributors: Jose Luis Blanco-Claraco

2.2.0 (2025-10-28)

2.1.0 (2025-10-20)

2.0.0 (2025-10-13)

• Modernize copyright notice
• Use ament linters
• Contributors: Jose Luis Blanco-Claraco

1.9.1 (2025-07-07)

1.9.0 (2025-06-06)

File truncated at 100 lines see the full file