Nicola Worthington > Colloquy-Data > Colloquy::Data

Download:
Colloquy-Data-1.15.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.15   Source  

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

syntax highlighting: