README.md

config_utilities Tutorials

We provide detailed introductions about everything you need to know about config_utilities in the following tutorials and some verbose example demos that you can run.

Tutorials

The following tutorials will guide you through functionalities of config_utilities, from beginner to expert:

1. Overview of functionalities and headers

2. Config essentials

   • Declaring a struct a config
   • Checking for valid configurations
   • Printing configs

3. Parsing configs from data sources

   • Parse from yaml
   • Parse from ROS

4. Handling complex configs or types

   • Sub-configs
   • Inheritance
   • Virtual configs
   • Type conversions
   • Namespaces

5. Automatic object creation via factories

   • Automatic object creation
   • Creating objects with individual configs
   • Delayed object creation with virtual configs

6. Advanced features

   • Adding custom types
   • Adding custom conversions
   • Adding custom checks
   • Adding custom loggers
   • Adding custom formatters
   • Adding custom parsers

7. External Plugins

   • Loading an external library
   • Managed instances
   • Debugging

8. Varia

   • Settings
   • Globals

Demos

The (non-ros) demos can be run via the run_demo.py utility in the scripts directory. If you are building this library via catkin, you can run one of the following to see the results of one of the corresponding demo files:

python3 scripts/run_demo.py config
python3 scripts/run_demo.py inheritance
python3 scripts/run_demo.py factory

ℹ️ Note
If you're building via cmake, you can point run_demo.py to the build directory with -b/--build_path.

The ros demo can be run via:

roslaunch config_utilities demo_ros.launch

If you are looking for a specific use case that is not in the tutorials or demos, chances are you can find a good example in the tests/ directory!