Data::Startup 0.04

SYNOPSIS
######
# Subroutine interface
#
use Data::Startup qw(config override);
$options = override(%default_options, @option_list );
$options = override(%default_options, @option_list );
$options = override(%default_options, %option_list );
@options_list = config(%options );
($key, $old_value) = config(%options, $key);
($key, $old_value) = config(%options, $key => $new_value );
($key, $old_value) = config(%options, $key => $new_value );
@old_options_list = config(%options, @option_list);
@old_options_list = config(%options, @option_list);
@old_options_list = config(%options, %option_list);
######
# Object interface
#
use Data::Startup
$startup_options = $class->Data::Startup::new( @option_list );
$startup_options = $class->Data::Startup::new( @option_list );
$startup_options = $class->Data::Startup::new( %option_list );
$options = $startup_options->override( @option_list );
$options = $startup_options->override( @option_list );
$options = $startup_options->override( %option_list );
@options_list = $options->config( );
($key, $old_value) = $options->config($key);
($key, $old_value) = $options->config($key => $new_value );
($key, $old_value) = $options->config($key => $new_value );
@old_options_list = $options->config(@option_list);
@old_options_list = $options->config(@option_list);
@old_options_list = $options->config(%option_list);
# Note: May use [@option_list] instead of @option_list
# and {@option_list} instead of %option_list
Many times there is a group of subroutines that can be tailored by different situations with a few, say global variables. However, global variables pollute namespaces, become mangled when the functions are multi-threaded and probably have many other faults that it is not worth the time discovering.
As well documented in literature, object oriented programming do not have these faults. This program module class of objects provide the objectized options for a group of subroutines or encapsulated options by using the methods directly as in an option object.
The Data::Startup class provides a way to input options in very liberal manner of either
- arrays, reference to an array, or reference to hash to a
- reference to an array or reference to a hash
- reference to a hash
- referene to an array
- many other combos
without having to cut and paste specialize, tailored code into each subroutine/method.