SYNOPSIS

           use base qw/ App::ClusterSSH::Base /;

           # in object new method
           sub new {
               ( $class, $arg_ref ) = @_;
               my $self = $class->SUPER::new($arg_ref);
               return $self;
           }

DESCRIPTION

       Base object to provide some utility functions on objects - should not be used directly

METHODS

       These extra methods are provided on the object

       $obj = App::ClusterSSH::Base->new({ arg => val, });
           Creates object.  In higher debug levels the args are printed out.

       $obj->id
           Return the unique id of the object for use in subclasses, such as

               $info_for{ $self->id } = $info

       $obj->debug_level();
           Returns current debug level

       $obj->set_debug_level( n )
           Set debug level to 'n' for all child objects.

       $obj->debug($level, @text)
           Output @text on STDOUT if $level is the same or lower that debug_level

       $obj->set_lang
           Set the Locale::Maketext language.  Defaults to 'en'.  Expects the
           App::ClusterSSH/L10N/{lang}.pm module to exist and contain all relevant translations,
           else defaults to English.

       $obj->loc('text to translate [_1]')
           Using the App::ClusterSSH/L10N/{lang}.pm module convert the  given text to appropriate
           language.  See App::ClusterSSH::L10N for more details.  Essentially a wrapper to
           maketext in Locale::Maketext

       $obj->stdout_output(@);
           Output text on STDOUT.

       $obj->parent;
           Returned the object that is the parent of this one, if it was set when the object was
           created

       %obj->options;
           Accessor to configured options, if it is set up by this point

       $obj->exit;
           Stub to allow program to exit neatly from wherever in the code

       $config = $obj->config;
           Returns whatever configuration object has been set up.  Croaks if set_config hasnt
           been called

       $obj->set_config($config);
           Set the config to the given value - croaks if has already been called

       $sort = $obj->sort
           Code reference used to sort lists; if configured (and installed) use Sort;:Naturally,
           else use perl sort

       %results = $obj->load_file( filename => '/path/to/file', type => '(cluster|config}' )
           Load in the specified file and return a hash, parsing the file depending on wther it
           is a config file (key = value) or cluster file (key value)