NAME

News::Pan::Server - abstraction to a collection of pan server cache files

DESCRIPTION

There are two ways to set the abs_path of the news server cache, this is where your group files reside. Either through set_asb_path(), which returns boolean, or through argument to constructor. If you set it through argument to constructor, it will throw an exception if this is not a directory.

new()

   my $server = new News::Pan::Server({ abs_path => '/home/myself/.pan/astraweb' }); 

   my $server = new News::Pan::Server;    
   $server->set_asb_path( '/home/myself/.pan/astraweb' ) or warn('not a dir');
   

set_abs_path()

set the abs path for this news server cache dir.

abs_path

returns abs patht to server cache dir

groups_subscribed()

takes no argument returns array ref list of groups subscribed to (this is by what is read in abs_path files) cached in object instance, returns the names 'alt.binaries.group,etc' etc

groups_subscribed_binaries()

returns array ref of groups that are binaries

group()

argument is group name, returns News::Pan::Server::Group object. returns undef and warns on fail