Dpkg::Conf - parse dpkg configuration files
The Dpkg::Conf object can be used to read options from a
configuration file. It can export an array that can then be parsed exactly
like @ARGV.
- $conf = Dpkg::Conf->new(%opts)
- Create a new Dpkg::Conf object.
Options:
- allow_short
- If set to true (it defaults to false), then short options are allowed in
the configuration file, they should be prepended with a single
hyphen.
- @$conf
- @options = $conf->get_options()
- Returns the list of options that can be parsed like
@ARGV.
- $conf->load($file)
- Read options from a file. Return the number of options parsed.
- $conf->load_system_config($file)
- Read options from a system configuration file.
Return the number of options parsed.
- $conf->load_user_config($file)
- Read options from a user configuration file. It will try to use the XDG
directory, either $XDG_CONFIG_HOME/dpkg/ or
$HOME/.config/dpkg/.
Return the number of options parsed.
- $conf->load_config($file)
- Read options from system and user configuration files.
Return the number of options parsed.
- $conf->parse($fh)
- Parse options from a file handle. When called multiple times, the parsed
options are accumulated.
Return the number of options parsed.
- $conf->filter(%opts)
- Filter the list of configuration options.
Options:
- remove
- A function returning a boolean, used to decide whether to remove the
configuration option, executed as
$opts{remove}->($option).
- keep
- A function returning a boolean, used to decide whether to keep the
configuration option, executed as
$opts{keep}->($option).
- $string = $conf->output([$fh])
- Write the options in the given filehandle (if defined) and return a string
representation of the content (that would be) written.
- "$conf"
- Return a string representation of the content.
- $conf->save($file)
- Save the options in a file.
Remove croak: For 'format_argv' in
$conf->filter().
Remove methods: $conf->get(),
$conf->set().
Obsolete option: 'format_argv' in
$conf->filter().
Obsolete methods: $conf->get(),
$conf->set().
New methods:
$conf->load_system_config(),
$conf->load_system_user(),
$conf->load_config().
New option: Accept new option 'format_argv' in
$conf->filter().
New methods: $conf->get(),
$conf->set().
New method: $conf->filter()
Mark the module as public.