ecru-config

Roman Bogorodskiy

08 November 2008

Version 0.1.0

ecru-config is a tool for managing ecru configuration.

Table of Contents

Synopsis

ecru-config config_variable

ecru-config [-l] [-sprofile]

ecru-config -v

ecru-config -hhook

Description

Common

ecru-config is a tool for managing ecru configuration. Actually, since all conifguration files are plain text, it's possible to modify them directly without using ecru-config, however ecru-config can save your time.

By default ecru-config prints value of the config variable given by config_variable argument. config_variable is an XPath-like expression of the configuration varible name.

For example, if the configuration file looks this way:

config: {
        account:
        {
                login = "somelogin";
                password = "somepass";
        };
};

you can do the following:

ecru-config config.account.login

and it will print out "somelogin".

Profiles

Ecru supports having several configuration profiles. Configuration profile is basically a plain text file with .conf extension which is located inside $HOME/.ecru directory. When executed with -l option, ecru-config prints out a list of found configuration profiles marking the current one with asterisk.

You can switch configuration profiles using -s option. It changes current configuration to the value given in profile. profile can be either full path like $HOME/.ecru/someprof.conf or just a filename like someprof.conf, ecru-config cuts down the path and leaves only filename. It's done that way so it were handy to use shell path completion.

Hooks

You can use -h to list hooks. Check out the options section to know more details on this option.

Options

-l
List configuration profiles. [-spath Switch current configuration profile to path.
-v
Show ecru version.
-hhook
List hooks of type hook. Currently the following values of hook are supported:

Files

$HOME/.ecru
Configuration directory root.
$HOME/.ecru/default.conf
Default configuration profile.
$HOME/.ecru/current
Pointer to the default configuration profile, points to default.conf by default.
$HOME/.ecru/hooks
Hooks directory.
$HOME/.ecru/hooks/pre
Pre-hooks directory.
$HOME/.ecru/hooks/post
Post-hooks directory.
$HOME/.ecru/templates
Templates directory.

See Also

ecru-post(1), ecru-edit(1), ecru-list(1), ecru-info(1)