Scroll to navigation

Sympa::CLI(3Sympa) sympa 6.2.72 Sympa::CLI(3Sympa)

NAME

Sympa::CLI - Base class of Sympa CLI modules

SYNOPSIS

  package Sympa::CLI::mycommand;
  use parent qw(Sympa::CLI);
  
  use constant _options   => qw(...);
  use constant _args      => qw(...);
  use constant _need_priv => 0;
  
  sub _run {
      my $class   = shift;
      my $options = shift;
      my @argv    = @_;
  
      #... Do the job...
      exit 0;
  }

This will implement the function of sympa mycommand.

DESCRIPTION

Sympa::CLI is the base class of the classes which defines particular command of command line utility. TBD.

Methods subclass should implement

_options ( )
Class method, overridable. Returns an array to define command line options. About the format see "Summary of Option Specifications" in Getopt::Long.

By default general options are defined and they always take precedence over the definition in subclass.

_args ( )
Class method, overridable. Returns an array to define mandatory arguments. TBD.

By default no mandatory arguments are defined.

_need_priv ( )
Class method, overridable. If this returns true value (the default), the program tries getting privileges of Sympa user, prepare database connection, loading main configuration and then setting language according to configuration. Otherwise, it sets language according to locale setting of console.
_log_to_stderr ( )
Class method, overridable. If this returns true value, output by logging facility will be redirected to standard error output (stderr).

By default redirection is disabled.

_run ( \$options, @argv )
Class method, mandatory. If the program is invoked, command line options are parsed as _options() defines, arguments are checked as _args() defines and this method is called.

Subcommands

To implement a subcommand, simply create a submodule inheriting the module for parent command:

  package Sympa::CLI::mycommand::subcommand;
  use parent qw(Sympa::CLI::mycommand);
  ...

Then this will implement the function of sympa mycommand subcommand.

SEE ALSO

sympa(1).

HISTORY

Sympa::CLI appeared on Sympa 6.2.68.

2024-07-15 6.2.72