News::Pan::Server

News::Pan::Server is a software that provides an abstraction to a collection of pan server cache files. With News::Pan::Server, you can set the abs_path of the news server cache in two different ways.

The first way is by using set_abs_path(), which returns boolean. The second way is by using an argument to the constructor. However, if you choose the second option, it will throw an exception if the specified path is not a directory.

To use the constructor, you can use the following syntax:

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

Alternatively, you can use the following syntax and set the abs path using set_abs_path():

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

Once you have set the abs path for the news server cache dir, you can use the following methods:

- abs_path: returns the abs path to the server cache dir.
- groups_subscribed(): takes no argument and returns an array ref list of groups subscribed to (based on what is read in the abs_path files) cached in the object instance. This method returns the names 'alt.binaries.group, etc.' etc.
- groups_subscribed_binaries(): returns an array ref of groups that are binaries.
- group(): the argument is the group name and this method returns a News::Pan::Server::Group object. If the method fails, it returns undef and issues a warning.