NAME

Bot::Cobalt::Core::ContextMeta - Base class for context-related metadata

SYNOPSIS

  $cmeta->add($context, $key, $ref);
  
  $cmeta->del($context, $key);
  
  $cmeta->clear($context);
  
  $cmeta->list($context);

DESCRIPTION

This is the ContextMeta base class, providing some easy per-context hash management methods to subclasses such as Bot::Cobalt::Core::ContextMeta::Auth and Bot::Cobalt::Core::ContextMeta::Ignore.

Bot::Cobalt::Core uses ContextMeta subclasses to provide auth and ignore attributes.

add

  ->add($context, $key, $meta_ref)

Add a new item; subclasses will usually use a custom constructor to provide a custom metadata hashref as the third argument.

del

  ->del($context, $key)

Delete a specific item.

clear

  ->clear()
  
  ->clear($context)

Clear a specified context entirely.

With no arguments, clear everything we know about every context.

fetch

  ->fetch($context, $key)

Retrieve the 'meta' hash reference for a specified key.

list

In list context, returns the list of keys:

  my @contexts = $cmeta->list;
  my @ckeys    = $cmeta->list($context);

In scalar context, returns the actual hash reference (if it exists).

list_as_ref

Less-ambiguous alternative to "list" -- always get a hash reference.

list_as_array

Less-ambiguous alternative to "list" -- always get a list of keys.

AUTHOR

Jon Portnoy <avenj@cobaltirc.org>

http://www.cobaltirc.org