NAME

Bot::Cobalt::Core::ContextMeta::Auth - Auth list management

SYNOPSIS

  my $auth_lev = $core->auth->level($context, $nickname);
  my $auth_usr = $core->auth->username($context, $nickname);

See below for a complete description of available methods.

DESCRIPTION

A ContextMeta subclass providing context-specific authorization state information.

This is used by plugins to manage or retrieve authorized user details.

add

  ->add(
    Alias    => $alias,
    Context  => $context,
    Nickname => $nickname,
    Username => $username,
    Host     => $host,
    Level    => $lev,
    Flags    => \%flags,
  );

Add a newly-authorized user.

Alias should generally be the result of a Core get_plugin_alias method call.

level

  ->level($context, $nickname)

Return recognized level for specified nickname, or 0 for unknown nicknames.

username

  ->username($context, $nickname)

Return authorized username for a specified nickname, or empty list for unknown.

host

  ->host($context, $nickname)

Return recognized hostname for a specified nickname, or empty list for unknown.

flags

  ->flags($context, $nickname)

Return flags HASH for a specified nickname, or empty hashref for unknown.

has_flag

  ->has_flag($context, $nickname, $flag)

Return boolean value indicating whether a flag is named flag is enabled.

set_flag

  ->set_flag($context, $nickname, $flag)

Turn a named flag on for the specified nickname.

drop_flag

  ->drop_flag($context, $nickname, $flag)

Remove a named flag from the specified nickname.

move

  ->move($context, $old, $new)

Move an authorized state, such as when a user changes nicknames.

AUTHOR

Jon Portnoy <avenj@cobaltirc.org>

http://www.cobaltirc.org