Spoon::Base(3)

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