configuration reader and writer powered by Augeas
Config::Model::Backend::Augeas provides a way to load or store configuration data through Config::Augeas. This way, the structure and commments of the original configuration file are preserved.
With Config::Model::Backend::Augeas, Config::Model now provides a way to load and save data through RedHat's Augeas library.
Config::Model and Augeas are both configuration editing tool. Both parse configuration files in their native formats and transforms them into a tree. Configuration changes are made by manipulating this tree and saving it back into native config files.
Both Augeas and Config::Model rely on a tree to represent configuration data.
On one side, Augeas is able to load and write data while respecting the structure and comments of the original configuration file. But Augeas purpose is not to validate the semantic content of the configuration file.
On the other side, Config::Model is able to validate the semantic content of the configuration file, but it will discard all comments and will write back configuration data using a canonical order. Thus the comments and structure of the original configuration file is not preserved.
You can now have the best of both worlds by using the Augeas library to load and write data from Config::Model configuration tree. You can now instruct Config::Model to use Augeas backend in the autoread and autowrite feature. See Config::Model::Autoread for details.
Unfortunately, you must ensure that the tree representation specified in Config::Model and Augeas lens are quite close together: - Config::Model element names and Augeas lens names must be identical - Both structures must be very close. Each Config::Model node must have a corresponsing lens.
See Config::Model::Backend::Augeas documentation to use Augeas with your configuration model.
For more details on Config::Model see:
For more details on Augeas, see:
20 March 2013
This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. On Debian GNU/Linux systems, the complete text of version 2 of the GNU Lesser Public License can be found in`/usr/share/common-licenses/LGPL-2'
Leaders and contributors
|Dominique Dumont (firstname.lastname@example.org)||contact|
Resources and communication
|Debian (Ref) (R)||https://tracker.debian.org/pkg/libconfig-model-backend-augeas-perl|
This entry (in part or in whole) was last reviewed on 10 April 2018.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the page “GNU Free Documentation License”.
The copyright and license notices on this page only apply to the text on this page. Any software or copyright-licenses or other similar notices described in this text has its own copyright notice and license, which can usually be found in the distribution or license text itself.