NAME

Spoon::Base - Generic Spoon Base Class

SYNOPSIS

    use Spoon::Base '-Base';

DESCRIPTION

Base class for application plugins. Provides basic functionality to all modules inheriting from this class.

SUBROUTINES

These subroutines are meant to be called bare, not as an object-method call.

trace

See Spoon::Trace::trace().

conf(name, default)

Returns the configuration value for "name", if it can be found in the config ($self->hub->config). Returns $default, otherwise.

METHODS

hub

Return the application's hub object. See Spoon::Hub.

init

Inherited by all subclasses. Put your class initialization stuff here.

assert(boolean)

Die if the supplied argument is false.

t([label])

Calls Spoon::Trace::mark(). See Spoon::Trace.

clone

Copies a class instance. The copy is only a shallow one.

is_in_cgi

Returns a boolean, indicating whether we were called from a CGI interface.

is_in_test

Returns a boolean, indicating whether we were called from a test suite.

have_plugin(class_id)

Tries to load a plugin. See Spoon::Hub::load_class().

plugin_directory

Returns your plugin's directory. You can use this directory to store state.

env_check(variable_name)

Sanity check: ensure the specified variable exists in %ENV. If the variable is not found, dies with a useful error message.

dumper_to_file(filepath, variable1 [, variable2...])

Uses Data::Dumper to save a dump of one or more variables to the specified file.

has_utf8

Returns a boolean, indicating whether utf8 is available on this platform and version of perl.

utf8_encode(string)

Encodes the string in utf8, if utf8 is available. Otherwise, returns $string unmodified. See Encode::encode().

utf8_decode(string)

Decodes the string from utf8, if utf8 is available. Otherwise, returns $string unmodified. See Encode::decode().

uri_escape(string)

Escapes all invalid URI characters. See CGI::Util::escape().

uri_unescape(string)

Unescapes all invalid URI characters. See CGI::Util::unescape().

html_escape(string)

Escapes all reserved characters. The result is suitable for including verbatim in an HTML document. See CGI::escapeHTML().

html_unescape(string)

Escapes all reserved characters. The result is suitable for including verbatim in an HTML document. See CGI::unescapeHTML().

base64_encode(string)

Encodes the specified string into Base64. See MIME::Base64::encode_base64().

base64_encode(base64_data)

Decodes the specified data from Base64. See MIME::Base64::decode_base64().

TODO

* Document what Spoon::Base->debug() does.

AUTHOR

Brian Ingerson <INGY@cpan.org>

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html