Stephan Jauernick > Atheme-0.0001 > Atheme

Download:
Atheme-0.0001.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.0001   Source  

NAME ^

Atheme - Perl interface to Atheme's XML-RPC methods

VERSION ^

version 0.0001

DESCRIPTION ^

This class provides an interface to the XML-RPC methods of the Atheme IRC Services.

METHODS ^

These are all either virtual or helper methods. They are being implemented in service-specific classes.

new

Services constructor. Takes a hash as argument: my $svs = new Atheme(url => "http://localhost:8000");

url<string>: URL to Atheme's XML-RPC server.

lang<string>: Language for result strings (en, ...).

validate<boolean>: If 1 then validation should be done in perl already, if 0 then validation is only done in atheme itself. In both cases, atheme validates. If you choose to use the perl validation, you will get more verbose fault messages containing an additional key 'subtype'.

return_dispatch

Handles results from RPC Calls!

Here is the list of fault types and default strings (these are likely to be at least partially overridden by Atheme::*Serv classes.

    fault_needmoreparams = "Insufficient parameters."
    fault_badparams      = "Invalid parameters."
    fault_nosuch_source  = "No such source."
    fault_nosuch_target  = "No such target."
    fault_authfail       = "Authentication failed."
    fault_noprivs        = "Insufficient privileges."
    fault_nosuch_key     = "No such key."
    fault_alreadyexists  = "Item already exists."
    fault_toomany        = "Too many items."
    fault_emailfail      = "Email verification failed."
    fault_notverified    = "Action not verified."
    fault_nochange       = "No change."
    fault_already_authed = "You are already authenticated."
    fault_unimplemented  = "Method not implemented."

call_svs

Method call

login

A common method used to log into the services in order to execute other methods. Every service inherits this, so you can load just Atheme::MemoServ and log in through that.

logout

A common method used to log out and clean up your authcookie. This should be done, but does not have to be done. This method is also inherited and therefore usable in every *Serv.

AUTHORS ^

Pippijn van Steenhoven <pip88nl@gmail.com> Stephan Jauernick <stephan@stejau.de>

syntax highlighting: