Beaker provides a few convenience methods to help you use the HOCON configuration file format in your testing. This doc will give you an overview of what each method does, but if you'd like more in-depth information, please checkout our Hocon Helpers Rubydocs.
If you'd just like to read the contents of a HOCON file from a System Under Test (SUT), this is the method for you. Note that you will get back a ConfigValueFactory object like in the other helper methods here.
This method is specifically for editing a file on a SUT and saving it in-place, meaning it'll save your changes in the place of the original file you read from.
The special thing to take note of here is that the Proc you pass to this method will need to return the doc that you'd like saved in order for saving to work as specified.
This method is our generic open-ended method for editing a file from a SUT. This is the most flexible method, doing nothing but providing you with the contents of the file to edit yourself.
This does not save the file edited. Our recommendation is to use the create_remote_file method, as shown in the Rubydocs example if you'd like to save. This allows us to have more flexibility to do things such as moving the edited file to back up or version your changes.