NAME

Colloquy::Data - Read Colloquy 1.3 and 1.4 data files

SYNOPSIS

use Data::Dumper;
use Colloquy::Data qw(:all);

my $colloquy_datadir = "/home/system/colloquy/data";

#my ($users_hashref,$lists_hashref) = users($colloquy_datadir);
my ($lists_hashref,$users_hashref) = lists($colloquy_datadir);

print "Users: ".Dumper($users);
print "Lists: ".Dumper($lists);

DESCRIPTION

This module munges the users.lua and lists.lua (Colloquy 1.3x) files in to executable perl code which is then evaluated. Colloquy 1.4 uses a seperate LUA file for each user and list, which are located in the users and lists directories in the Colloquy data directory. These files are read one by one and evaluated in the same way.

This module compiles and execute the Colloquy data files in restricted compartments using the Safe module. Even so, this module should be used with caution if you cannot gaurentee the integrity of the user and list LUA files. The module will issue a warning complaining about world writable permissions if $^W warnings.

EXPORTS

users

my ($users_hashref,$lists_hashref) = users($colloquy_datadir);

Returns users and lists hash references, in that order.

lists

my ($lists_hashref,$users_hashref) = lists($colloquy_datadir);

Returns lists and users hash references, in that order.

SEE ALSO

http://freshmeat.net/projects/colloquy-talker/, Apache2::AuthColloquy

VERSION

$Id: Data.pm 526 2006-05-29 12:27:43Z nicolaw $

AUTHOR

Nicola Worthington <nicolaw@cpan.org>

http://perlgirl.org.uk

COPYRIGHT

Copyright 2005,2006 Nicola Worthington.

This software is licensed under The Apache Software License, Version 2.0.

http://www.apache.org/licenses/LICENSE-2.0