NAME

Config::Generator::Template - Config::Generator template support

DESCRIPTION

This module eases configuration file generation by providing template support. A template is a file with markup. Given a high-level configuration, the template can be processed and transformed into a low-level configuration file.

SYNTAX

The template commands are enclosed within "<{" and "}>". If PATH represents a path in the high-level configuration:

  • "<{PATH}>" will be replaced by the value of PATH

  • "<{open()}>" will be replaced by "<{"

  • "<{close()}>" will be replaced by "}>"

  • "<{if(PATH)}>xxx<{endif(PATH)}>" will be replaced by "xxx" if PATH is true or "" otherwise (this is done using Perl's conditional testing)

  • "<{ifnot(PATH)}>xxx<{endif(PATH)}>" is the same as "if()" but negated

  • "<{if_true(PATH)}>xxx<{endif(PATH)}>" is the same as "if()" but tested using Config::Validator's is_true()

  • "<{if_false(PATH)}>xxx<{endif(PATH)}>" is the same as "if()" but tested using Config::Validator's is_false()

  • "<{ifdef(PATH)}>xxx<{endif(PATH)}>" will be replaced by "xxx" if PATH is defined (i.e. set) or "" otherwise

  • "<{ifndef(PATH)}>xxx<{endif(PATH)}>" is the same as "ifdef()" but negated

FUNCTIONS

This module provides the following functions (none of them being exported by default):

declare_template(NAME...)

declare one or more template names so that they can be customized using the /Template schema

expand_template(NAME[, HASH])

read and process the named template, using the given hash as well as the high-level configuration

process_template(TEMPLATE, HASH...)

process the given template string using the given hashes

read_template(NAME)

return the contents of the named template (unprocessed)

AUTHOR

Lionel Cons http://cern.ch/lionel.cons

Copyright (C) CERN 2013-2016