| 1 | package Rose::DBx::RegistryConfig; | ||||||||||||||||||||||||||||
| 2 | 7 | ▶ | use base qw( Rose::DB ); | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 3 | |||||||||||||||||||||||||||||
| 4 | 7 | ▶ | use strict; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 5 | 7 | ▶ | use warnings; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 6 | 7 | ▶ | use Carp; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 7 | |||||||||||||||||||||||||||||
| 8 | 7 | our $VERSION = 0.01; | |||||||||||||||||||||||||||
| 9 | |||||||||||||||||||||||||||||
| 10 | #------- | ||||||||||||||||||||||||||||
| 11 | |||||||||||||||||||||||||||||
| 12 | 6 | ▶ | sub import { | ||||||||||||||||||||||||||
|
Subroutine
import: called CC=6 SCAR=18.0
| |||||||||||||||||||||||||||||
| 13 | 6 | my ($pkg, %args) = @_; | |||||||||||||||||||||||||||
| 14 | |||||||||||||||||||||||||||||
| 15 | # Optionally set class-wide defaults... | ||||||||||||||||||||||||||||
| 16 | 6 | ▶ | $pkg->default_domain( $args{default_domain} || 'default' ); | ||||||||||||||||||||||||||
|
Condition100%2/2
$args{'default_domain'} || 'default'
MC/DC100%1/1
$args{'default_domain'} || 'default'
$args{'default_domain'}
Truth table100%2/2
A
A= $args{'default_domain'}
| |||||||||||||||||||||||||||||
| 17 | 6 | ▶ | $pkg->default_type( $args{default_type} || 'default' ); | ||||||||||||||||||||||||||
|
Condition100%2/2
$args{'default_type'} || 'default'
MC/DC100%1/1
$args{'default_type'} || 'default'
$args{'default_type'}
Truth table100%2/2
A
A= $args{'default_type'}
| |||||||||||||||||||||||||||||
| 18 | |||||||||||||||||||||||||||||
| 19 | # A registry can be passed explicitly... | ||||||||||||||||||||||||||||
| 20 | 6 | my $registry = $args{registry}; | |||||||||||||||||||||||||||
| 21 | |||||||||||||||||||||||||||||
| 22 | # Optional auto-registration of data sources... | ||||||||||||||||||||||||||||
| 23 | 6 | my $domain_config = $args{domain_config}; # DOMAIN_CONFIG file | |||||||||||||||||||||||||||
| 24 | 6 | my $target_domains = $args{target_domains}; | |||||||||||||||||||||||||||
| 25 | |||||||||||||||||||||||||||||
| 26 | # Support alternative means of interpreting domain hash... | ||||||||||||||||||||||||||||
| 27 | 6 | my $parse_domain_hash = $args{parse_domain_hash_callback}; | |||||||||||||||||||||||||||
| 28 | |||||||||||||||||||||||||||||
| 29 | # Optional data source registration... | ||||||||||||||||||||||||||||
| 30 | 0 | ▶ | $registry && do{ $pkg->registry( $registry ) }; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 31 | |||||||||||||||||||||||||||||
| 32 | 6 | ▶ | if( defined $domain_config ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 33 | # Auto-registration from DOMAIN_CONFIG... | ||||||||||||||||||||||||||||
| 34 | 3 | ▶ | (-f $domain_config) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 35 | or croak "DOMAIN_CONFIG file '$domain_config' not found"; | ||||||||||||||||||||||||||||
| 36 | # Parse DOMAIN_CONFIG and auto-register all types in the current domain... | ||||||||||||||||||||||||||||
| 37 | 3 | my $reg = $pkg->conf2registry( domain_config => $domain_config, target_domains => $target_domains, parse_domain_hash_callback => $parse_domain_hash ); | |||||||||||||||||||||||||||
| 38 | 3 | $pkg->registry( $reg ); | |||||||||||||||||||||||||||
| 39 | } | ||||||||||||||||||||||||||||
| 40 | 6 | return 1; | |||||||||||||||||||||||||||
| 41 | } | ||||||||||||||||||||||||||||
| 42 | |||||||||||||||||||||||||||||
| 43 | #------- | ||||||||||||||||||||||||||||
| 44 | |||||||||||||||||||||||||||||
| 45 | 1 | ▶ | sub auto_load_fixups { | ||||||||||||||||||||||||||
|
Subroutine
auto_load_fixups: called CC=5 SCAR=17.8
Pod
documented
| |||||||||||||||||||||||||||||
| 46 | 1 | my ($class) = @_; | |||||||||||||||||||||||||||
| 47 | |||||||||||||||||||||||||||||
| 48 | # Load fixups from YAML fixup file, supporting our compressed YAML | ||||||||||||||||||||||||||||
| 49 | # namespace representation... | ||||||||||||||||||||||||||||
| 50 | 1 | my $fixup_file = $ENV{'ROSEDBRC'}; | |||||||||||||||||||||||||||
| 51 | 1 | ▶ | $fixup_file = '/etc/rosedbrc' unless defined $fixup_file && -e $fixup_file; | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
defined $fixup_file and -e $fixup_file
MC/DC0%0/2
defined $fixup_file and -e $fixup_file
defined $fixup_file
-e $fixup_file
Truth table33%1/3
A and B
A= defined $fixup_fileB= -e $fixup_file
| |||||||||||||||||||||||||||||
| 52 | |||||||||||||||||||||||||||||
| 53 | 1 | ▶ | if( -e $fixup_file ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 54 | 1 | ▶ | if(-r $fixup_file) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 55 | 1 | $class->load_yaml_fixups_from_file( $fixup_file ); | |||||||||||||||||||||||||||
| 56 | } | ||||||||||||||||||||||||||||
| 57 | else { | ||||||||||||||||||||||||||||
| 58 | 0 | warn "Cannot read Rose::DB fixup file '$fixup_file'"; | |||||||||||||||||||||||||||
| 59 | } | ||||||||||||||||||||||||||||
| 60 | } | ||||||||||||||||||||||||||||
| 61 | # Defer to Rose::DB for alternative ways to load fixups, suppressing | ||||||||||||||||||||||||||||
| 62 | # warning about unexpected 'defaults' type... | ||||||||||||||||||||||||||||
| 63 | 1 | ▶ | local $SIG{__WARN__} = sub { | ||||||||||||||||||||||||||
|
Subroutine
__ANON__: called CC=2 SCAR=7.6
| |||||||||||||||||||||||||||||
| 64 | 1 | ▶ | $_[0] =~ /no $class data source found for .* type 'defaults'/i | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 65 | || warn( @_ ) | ||||||||||||||||||||||||||||
| 66 | 1 | }; | |||||||||||||||||||||||||||
| 67 | 1 | $class->SUPER::auto_load_fixups( @_ ); | |||||||||||||||||||||||||||
| 68 | } | ||||||||||||||||||||||||||||
| 69 | |||||||||||||||||||||||||||||
| 70 | #------- | ||||||||||||||||||||||||||||
| 71 | |||||||||||||||||||||||||||||
| 72 | 1 | ▶ | sub load_yaml_fixups_from_file { | ||||||||||||||||||||||||||
|
Subroutine
load_yaml_fixups_from_file: called CC=8 SCAR=21.8
Pod
documented
| |||||||||||||||||||||||||||||
| 73 | 1 | my ($class, $file) = @_; | |||||||||||||||||||||||||||
| 74 | |||||||||||||||||||||||||||||
| 75 | 1 | my $registry = $class->registry(); | |||||||||||||||||||||||||||
| 76 | |||||||||||||||||||||||||||||
| 77 | 1 | require YAML; | |||||||||||||||||||||||||||
| 78 | 1 | my @domains = YAML::LoadFile( $file ); | |||||||||||||||||||||||||||
| 79 | |||||||||||||||||||||||||||||
| 80 | 1 | for my $domain_hash (@domains) { | |||||||||||||||||||||||||||
| 81 | # Domain hashes have only one key -- the domain name... | ||||||||||||||||||||||||||||
| 82 | 1 | my ($domain_name) = keys %$domain_hash; | |||||||||||||||||||||||||||
| 83 | |||||||||||||||||||||||||||||
| 84 | 1 | my $this_domain_hash = $domain_hash->{ $domain_name }; | |||||||||||||||||||||||||||
| 85 | |||||||||||||||||||||||||||||
| 86 | # Get domain defaults... | ||||||||||||||||||||||||||||
| 87 | 1 | ▶ | my $defaults = $this_domain_hash->{defaults} && delete $this_domain_hash->{defaults}; | ||||||||||||||||||||||||||
|
Condition33%1/3
$this_domain_hash->{'defaults'} && delete $this_domain_hash->{'defaults'}
MC/DC0%0/2
$this_domain_hash->{'defaults'} && delete $this_domain_hash->{'defaults'}
$this_domain_hash->{'defaults'}
delete $this_domain_hash->{'defaults'}
Truth table33%1/3
A && B
A= $this_domain_hash->{'defaults'}B= delete $this_domain_hash->{'defaults'}
| |||||||||||||||||||||||||||||
| 88 | |||||||||||||||||||||||||||||
| 89 | 1 | for my $type_name (keys %$this_domain_hash) { | |||||||||||||||||||||||||||
| 90 | 3 | my $this_type_hash = $this_domain_hash->{$type_name}; | |||||||||||||||||||||||||||
| 91 | |||||||||||||||||||||||||||||
| 92 | # Override any unspecified entries from provided type with defaults... | ||||||||||||||||||||||||||||
| 93 | 3 | for my $default (keys %$defaults) { | |||||||||||||||||||||||||||
| 94 | 9 | ▶ | $this_type_hash->{$default} ||= $defaults->{$default}; | ||||||||||||||||||||||||||
|
Condition33%1/3
$this_type_hash->{$default} ||= $defaults->{$default}
MC/DC0%0/2
$this_type_hash->{$default} ||= $defaults->{$default}
$this_type_hash->{$default}
$defaults->{$default}
Truth table33%1/3
A ||= B
A= $this_type_hash->{$default}B= $defaults->{$default}
| |||||||||||||||||||||||||||||
| 95 | } | ||||||||||||||||||||||||||||
| 96 | 3 | my $entry = $registry->entry( domain => $domain_name, type => $type_name ); | |||||||||||||||||||||||||||
| 97 | 3 | ▶ | unless( $entry ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 98 | 0 | warn "No $class data source found for domain '$domain_name' and type '$type_name'"; | |||||||||||||||||||||||||||
| 99 | 0 | next; | |||||||||||||||||||||||||||
| 100 | } | ||||||||||||||||||||||||||||
| 101 | # Apply updates... | ||||||||||||||||||||||||||||
| 102 | 3 | ▶ | while( my ($method, $value) = each %{ $this_type_hash } ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 103 | 9 | $entry->$method( $value ); | |||||||||||||||||||||||||||
| 104 | } | ||||||||||||||||||||||||||||
| 105 | } | ||||||||||||||||||||||||||||
| 106 | } | ||||||||||||||||||||||||||||
| 107 | 1 | return 1; | |||||||||||||||||||||||||||
| 108 | } | ||||||||||||||||||||||||||||
| 109 | |||||||||||||||||||||||||||||
| 110 | #------- | ||||||||||||||||||||||||||||
| 111 | |||||||||||||||||||||||||||||
| 112 | 3 | ▶ | sub parse_domain { # Default domain parser implements alt namespace representation | ||||||||||||||||||||||||||
|
Subroutine
parse_domain: called CC=9 SCAR=23.9
Pod
documented
| |||||||||||||||||||||||||||||
| 113 | 3 | my ($class, %param) = @_; | |||||||||||||||||||||||||||
| 114 | |||||||||||||||||||||||||||||
| 115 | 3 | my $registry = $param{registry}; | |||||||||||||||||||||||||||
| 116 | 3 | ▶ | my $domain_name = $param{domain_name} or croak "param 'domain_name' required"; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 117 | 3 | ▶ | my $domain_hashref = $param{domain_hashref} or croak "param 'domain_hashref' required"; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 118 | |||||||||||||||||||||||||||||
| 119 | 3 | ▶ | $registry->isa( 'Rose::DB::Registry' ) or croak "param 'registry' must be a Rose::DB::Registry object"; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 120 | |||||||||||||||||||||||||||||
| 121 | # First get defaults... | ||||||||||||||||||||||||||||
| 122 | 3 | ▶ | my $defaults = $domain_hashref->{defaults} && delete $domain_hashref->{defaults}; | ||||||||||||||||||||||||||
|
Condition33%1/3
$domain_hashref->{'defaults'} && delete $domain_hashref->{'defaults'}
MC/DC0%0/2
$domain_hashref->{'defaults'} && delete $domain_hashref->{'defaults'}
$domain_hashref->{'defaults'}
delete $domain_hashref->{'defaults'}
Truth table33%1/3
A && B
A= $domain_hashref->{'defaults'}B= delete $domain_hashref->{'defaults'}
| |||||||||||||||||||||||||||||
| 123 | |||||||||||||||||||||||||||||
| 124 | # Process remaining entries... | ||||||||||||||||||||||||||||
| 125 | 3 | for my $type_name ( keys %$domain_hashref ) { | |||||||||||||||||||||||||||
| 126 | 13 | my $this_type_hash = $domain_hashref->{$type_name}; | |||||||||||||||||||||||||||
| 127 | |||||||||||||||||||||||||||||
| 128 | # Override any unspecified entries from provided type with defaults... | ||||||||||||||||||||||||||||
| 129 | 13 | for my $default (keys %$defaults) { | |||||||||||||||||||||||||||
| 130 | 42 | ▶ | $this_type_hash->{$default} ||= $defaults->{$default}; | ||||||||||||||||||||||||||
|
Condition33%1/3
$this_type_hash->{$default} ||= $defaults->{$default}
MC/DC0%0/2
$this_type_hash->{$default} ||= $defaults->{$default}
$this_type_hash->{$default}
$defaults->{$default}
Truth table33%1/3
A ||= B
A= $this_type_hash->{$default}B= $defaults->{$default}
| |||||||||||||||||||||||||||||
| 131 | } | ||||||||||||||||||||||||||||
| 132 | # If database name not provided, assume it is same as type name... | ||||||||||||||||||||||||||||
| 133 | 13 | ▶ | $this_type_hash->{database} ||= $type_name; | ||||||||||||||||||||||||||
|
Condition66%2/3
$this_type_hash->{"database"} ||= $type_name
MC/DC0%0/2
$this_type_hash->{"database"} ||= $type_name
$this_type_hash->{"database"}
$type_name
Truth table66%2/3
A ||= B
A= $this_type_hash->{"database"}B= $type_name
| |||||||||||||||||||||||||||||
| 134 | |||||||||||||||||||||||||||||
| 135 | 13 | $registry->add_entry( | |||||||||||||||||||||||||||
| 136 | domain => $domain_name, | ||||||||||||||||||||||||||||
| 137 | type => $type_name, | ||||||||||||||||||||||||||||
| 138 | %$this_type_hash | ||||||||||||||||||||||||||||
| 139 | ); | ||||||||||||||||||||||||||||
| 140 | } | ||||||||||||||||||||||||||||
| 141 | 3 | return $registry; | |||||||||||||||||||||||||||
| 142 | } | ||||||||||||||||||||||||||||
| 143 | |||||||||||||||||||||||||||||
| 144 | #------- | ||||||||||||||||||||||||||||
| 145 | |||||||||||||||||||||||||||||
| 146 | 6 | ▶ | sub conf2registry { | ||||||||||||||||||||||||||
|
Subroutine
conf2registry: called CC=6 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 147 | 6 | my ($class, %param) = @_; | |||||||||||||||||||||||||||
| 148 | |||||||||||||||||||||||||||||
| 149 | 6 | my $domain_config = $param{domain_config}; | |||||||||||||||||||||||||||
| 150 | 6 | my $target_domains = $param{target_domains}; # to register specific domains only | |||||||||||||||||||||||||||
| 151 | 6 | my $parse_domain_hash = $param{parse_domain_hash_callback}; | |||||||||||||||||||||||||||
| 152 | |||||||||||||||||||||||||||||
| 153 | 6 | ▶ | (-f $domain_config) or croak "DOMAIN_CONFIG file '$domain_config' not found"; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 154 | 6 | require YAML; | |||||||||||||||||||||||||||
| 155 | 6 | my @domains = YAML::LoadFile( $domain_config ); | |||||||||||||||||||||||||||
| 156 | |||||||||||||||||||||||||||||
| 157 | # Parse data structure derived from DOMAIN_CONFIG, creating a Registry... | ||||||||||||||||||||||||||||
| 158 | 6 | my $registry = Rose::DB::Registry->new(); | |||||||||||||||||||||||||||
| 159 | 6 | for my $domain_hash ( @domains ) { | |||||||||||||||||||||||||||
| 160 | # Domain hashes have only one key -- the domain name... | ||||||||||||||||||||||||||||
| 161 | 6 | my ($domain_name) = keys %$domain_hash; | |||||||||||||||||||||||||||
| 162 | |||||||||||||||||||||||||||||
| 163 | 6 | ▶ | if( $target_domains ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 164 | # Ignore non-target domains... | ||||||||||||||||||||||||||||
| 165 | 1 | ▶ | next unless grep { $_ eq $domain_name } @$target_domains; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 166 | } | ||||||||||||||||||||||||||||
| 167 | 6 | my $this_domain_hash = $domain_hash->{ $domain_name }; | |||||||||||||||||||||||||||
| 168 | |||||||||||||||||||||||||||||
| 169 | # Interpret this domain hash, updating registry accordingly... | ||||||||||||||||||||||||||||
| 170 | 6 | ▶ | if( $parse_domain_hash ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 171 | 1 | $parse_domain_hash->( domain_name => $domain_name, domain_hashref => $this_domain_hash, registry => $registry ); | |||||||||||||||||||||||||||
| 172 | } | ||||||||||||||||||||||||||||
| 173 | else { | ||||||||||||||||||||||||||||
| 174 | 5 | $class->parse_domain( domain_name => $domain_name, domain_hashref => $this_domain_hash, registry => $registry ); | |||||||||||||||||||||||||||
| 175 | } | ||||||||||||||||||||||||||||
| 176 | } | ||||||||||||||||||||||||||||
| 177 | 6 | return $registry; | |||||||||||||||||||||||||||
| 178 | } | ||||||||||||||||||||||||||||
| 179 | |||||||||||||||||||||||||||||
| 180 | #------- | ||||||||||||||||||||||||||||
| 181 | 7 | 1; | |||||||||||||||||||||||||||
| 182 | |||||||||||||||||||||||||||||
| 183 | __END__ | ||||||||||||||||||||||||||||