Class Methods

"options"

  my @opts = App::Sqitch::Command::config->options;

Returns a list of Getopt::Long option specifications for the command-line options for the "config" command.

"configure"

  my $params = App::Sqitch::Command::config->configure(
      $config,
      $options,
  );

Processes the configuration and command options and returns a hash suitable for the constructor. Exits with an error on option specification errors.

Constructor

"new"

  my $config = App::Sqitch::Command::config->new($params);

Creates and returns a new "config" command object. The supported parameters include:

"sqitch"

The core Sqitch object.

"file"

Configuration file to read from and write to.

"action"

The action to be executed. May be one of:

"context"

The configuration file context. Must be one of:

"type"

The type to cast a value to be set to or fetched as. May be one of:

Instance Methods

These methods are mainly provided as utilities for the command subclasses to use.

"execute"

  $config->execute($property, $value);

Executes the config command. Pass the name of the property and the value to be assigned to it, if applicable.

"get"

  $config->get($key);
  $config->get($key, $regex);

Emits the value for the specified key. The optional second argument is a regular expression that the value to be returned must match. Exits with an error if the is more than one value for the specified key, or if the key does not exist.

"get_all"

  $config->get_all($key);
  $config->get_all($key, $regex);

Like "get()", but emits all of the values for the given key, rather then exiting with an error when there is more than one value.

"get_regex"

  $config->get_regex($key);
  $config->get_regex($key, $regex);

Like "get_all()", but the first parameter is a regular expression that will be matched against all keys.

"set"

  $config->set($key, $value);
  $config->set($key, $value, $regex);

Sets the value for a key. Exits with an error if the key already exists and has multiple values.

"add"

  $config->add($key, $value);

Adds a value for a key. If the key already exists, the value will be added as an additional value.

"replace_all"

  $config->replace_all($key, $value);
  $config->replace_all($key, $value, $regex);

Replace all matching values.

"unset"

  $config->unset($key);
  $config->unset($key, $regex);

Unsets a key. If the optional second argument is passed, the key will be unset only if the value matches the regular expression. If the key has multiple values, "unset()" will exit with an error.

"unset_all"

  $config->unset_all($key);
  $config->unset_all($key, $regex);

Like "unset()", but will not exit with an error if the key has multiple values.

"rename_section"

  $config->rename_section($old_name, $new_name);

Renames a section. Exits with an error if the section does not exist or if either name is not a valid section name.

"remove_section"

  $config->remove_section($section);

Removes a section. Exits with an error if the section does not exist.

"list"

  $config->list;

Lists all of the values in the configuration. If the context is "local", "user", or "system", only the settings set for that context will be emitted. Otherwise, all settings will be listed.

"edit"

  $config->edit;

Opens the context-specific configuration file in a text editor for direct editing. If no context is specified, the local config file will be opened. The editor is determined by "editor" in Sqitch.

Instance Accessors

"file"

  my $file_name = $config->file;

Returns the path to the configuration file to be acted upon. If the context is "system", then the value returned is "$($etc_prefix)/sqitch.conf". If the context is "user", then the value returned is "~/.sqitch/sqitch.conf". Otherwise, the default is ./sqitch.conf.