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
Copyright (c) 2004. Brian Ingerson. All rights reserved.
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