NAME

OpenInteract::Config::GlobalOverride -- Process global override settings for a set of configuration directives

SYNOPSIS

 ## ----------Sample of an override file----------

 # Add a new value to 'user.track'

 [user.track.finalize]
 action  = add
 value   = 1

 # Add two new entries to the ruleset for the 'news' object, giving
 # the system a hint as to what type of data it should be

 [news.rules_from]
 action  = add
 value   = OpenInteract::RSSArticleSummarize
 value   = OpenInteract::EditorApproval
 type    = list

 # Remove 'SPOPS::Secure' from 'page.isa' list

 [page.isa]
 action  = remove
 value   = SPOPS::Secure

 # Remove key and value for 'uid' from 'user.field_map' hash

 [user.field_map]
 action  = remove
 value   = uid

 # Remove the entire 'field_alter' hashref
 [user.field_alter]
 action  = remove

 # Replace 'SPOPS::DBI::MySQL with 'SPOPS::DBI::Pg' in all keys that
 # have an 'isa' entry

 [*.isa]
 action  = replace
 replace = SPOPS::DBI::MySQL
 value   = SPOPS::DBI::Pg

 # Replace 'SPOPS::DBI::MySQL with 'SPOPS::DBI::Sybase' in the
 # 'user.isa' list

 [user.isa]
 action  = replace
 replace = SPOPS::DBI::MySQL
 value   = SPOPS::DBI::Sybase

 ## ----------End sample override file----------

 ## Read in a configuration and apply the override file, saved for
 ## this example in global_override.ini

 my $config = OpenInteract::Config->new(
                         'ini', { filename => 'server.ini' } );
 my $override_file = join( '/', $config->{dir}{config},
                                'global_override.ini' );
 my $override = OpenInteract::Config::GlobalOverride->new( $override_file );
 $override->apply_rules( $config );

 ## Values in $config are now modified based on the given rules

DESCRIPTION

This class allows you to define a set of override rules and apply them to a configuration. This is very helpful in OpenInteract because large sections of the server configuration are pieced together from information in a number of packages. Since there can be any number of packages -- at least 14, and most likely more -- modifying each of these is time-consuming and error-prone. Additionally, you need to modify the configuration for a package every time you upgrade.

Instead of this hassle, you can now define rules in a single file that will modify any configuration value. You have three ways to do this:

• add: Add/overwrite a value to an existing list or hash.

• remove: Remove a particular value from a list, or delete a hash key.

• replace: Replace a value with another in a list.

Action: Add

Action: Remove

Action: Replace

METHODS

Class Methods

new( $rule_filename )

Object Methods

apply_rules( $config )

BUGS

None known.

TO DO

Nothing known.

SEE ALSO

COPYRIGHT

Copyright (c) 2002 intes.net, inc.. All rights reserved.

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

AUTHORS

Chris Winters <chris@cwinters.com>