forgot name in the default_model service
[catagits/Catalyst-Runtime.git] / lib / Catalyst / IOC / Container.pm
CommitLineData
a6c13ff4 1package Catalyst::IOC::Container;
b4a6fa62 2use Bread::Board;
3use Moose;
4use Config::Any;
5use Data::Visitor::Callback;
6use Catalyst::Utils ();
2bb0da6d 7use MooseX::Types::LoadableClass qw/ LoadableClass /;
a6c13ff4 8use Catalyst::IOC::BlockInjection;
8b749525 9use namespace::autoclean;
b4a6fa62 10
11extends 'Bread::Board::Container';
12
13has config_local_suffix => (
442ab13e 14 is => 'ro',
b4a6fa62 15 isa => 'Str',
16 default => 'local',
17);
18
19has driver => (
442ab13e 20 is => 'ro',
b4a6fa62 21 isa => 'HashRef',
22 default => sub { +{} },
23);
24
25has file => (
442ab13e 26 is => 'ro',
b4a6fa62 27 isa => 'Str',
28 default => '',
29);
30
31has substitutions => (
442ab13e 32 is => 'ro',
b4a6fa62 33 isa => 'HashRef',
34 default => sub { +{} },
35);
36
37has name => (
442ab13e 38 is => 'ro',
b4a6fa62 39 isa => 'Str',
40 default => 'TestApp',
41);
42
2bb0da6d 43has sub_container_class => (
44 isa => LoadableClass,
45 is => 'ro',
46 coerce => 1,
a6c13ff4 47 default => 'Catalyst::IOC::SubContainer',
8b749525 48 handles => {
49 new_sub_container => 'new',
50 }
2bb0da6d 51);
52
b4a6fa62 53sub BUILD {
54 my $self = shift;
55
292277c1 56 $self->add_service(
57 $self->${\"build_${_}_service"}
58 ) for qw/
f97a8d0d 59 default_view
60 default_model
7451d1ea 61 substitutions
62 file
63 driver
64 name
65 prefix
66 extensions
67 path
68 config
69 raw_config
70 global_files
71 local_files
72 global_config
73 local_config
74 config_local_suffix
75 config_path
76 /;
f04816ce 77
292277c1 78 $self->add_sub_container(
79 $self->${ \"build_${_}_subcontainer" }
80 ) for qw/ model view controller /;
f04816ce 81}
82
83sub build_model_subcontainer {
84 my $self = shift;
85
b06ded69 86 return $self->new_sub_container(
5a53ef3d 87 name => 'model',
b06ded69 88 );
f04816ce 89}
90
91sub build_view_subcontainer {
92 my $self = shift;
93
b06ded69 94 return $self->new_sub_container(
5a53ef3d 95 name => 'view',
b06ded69 96 );
f04816ce 97}
98
99sub build_controller_subcontainer {
100 my $self = shift;
101
b06ded69 102 return $self->new_sub_container(
5a53ef3d 103 name => 'controller',
b06ded69 104 );
f04816ce 105}
106
f97a8d0d 107sub build_default_model_service {
0e747f0c 108 Bread::Board::BlockInjection->new(
af5df7d1 109 name => 'default_model',
0e747f0c 110 block => sub {
111 shift->param('config')->{default_model};
112 },
113 dependencies => [ depends_on('config') ],
114 );
115}
116
f97a8d0d 117sub build_default_view_service {
0e747f0c 118 Bread::Board::BlockInjection->new(
119 name => 'default_view',
120 block => sub {
121 shift->param('config')->{default_view};
122 },
123 dependencies => [ depends_on('config') ],
124 );
125}
126
f04816ce 127sub build_name_service {
128 my $self = shift;
292277c1 129
130 return Bread::Board::Literal->new( name => 'name', value => $self->name );
f04816ce 131}
132
133sub build_driver_service {
134 my $self = shift;
292277c1 135
136 return Bread::Board::Literal->new( name => 'driver', value => $self->driver );
f04816ce 137}
138
139sub build_file_service {
140 my $self = shift;
292277c1 141
142 return Bread::Board::Literal->new( name => 'file', value => $self->file );
f04816ce 143}
144
145sub build_substitutions_service {
146 my $self = shift;
292277c1 147
148 return Bread::Board::Literal->new( name => 'substitutions', value => $self->substitutions );
f04816ce 149}
150
151sub build_extensions_service {
152 my $self = shift;
292277c1 153
154 return Bread::Board::BlockInjection->new(
155 name => 'extensions',
156 block => sub {
157 return \@{Config::Any->extensions};
158 },
f04816ce 159 );
160}
b4a6fa62 161
f04816ce 162sub build_prefix_service {
163 my $self = shift;
292277c1 164
165 return Bread::Board::BlockInjection->new(
166 name => 'prefix',
167 block => sub {
168 return Catalyst::Utils::appprefix( shift->param('name') );
169 },
170 dependencies => [ depends_on('name') ],
f04816ce 171 );
172}
b4a6fa62 173
f04816ce 174sub build_path_service {
175 my $self = shift;
292277c1 176
177 return Bread::Board::BlockInjection->new(
178 name => 'path',
179 block => sub {
180 my $s = shift;
181
182 return Catalyst::Utils::env_value( $s->param('name'), 'CONFIG' )
183 || $s->param('file')
184 || $s->param('name')->path_to( $s->param('prefix') );
185 },
186 dependencies => [ depends_on('file'), depends_on('name'), depends_on('prefix') ],
f04816ce 187 );
188}
b4a6fa62 189
f04816ce 190sub build_config_service {
191 my $self = shift;
292277c1 192
193 return Bread::Board::BlockInjection->new(
194 name => 'config',
195 block => sub {
196 my $s = shift;
197
198 my $v = Data::Visitor::Callback->new(
199 plain_value => sub {
200 return unless defined $_;
201 return $self->_config_substitutions( $s->param('name'), $s->param('substitutions'), $_ );
202 }
203
204 );
205 $v->visit( $s->param('raw_config') );
206 },
207 dependencies => [ depends_on('name'), depends_on('raw_config'), depends_on('substitutions') ],
f04816ce 208 );
209}
b4a6fa62 210
f04816ce 211sub build_raw_config_service {
212 my $self = shift;
292277c1 213
214 return Bread::Board::BlockInjection->new(
215 name => 'raw_config',
216 block => sub {
217 my $s = shift;
218
219 my @global = @{$s->param('global_config')};
220 my @locals = @{$s->param('local_config')};
221
222 my $config = {};
223 for my $cfg (@global, @locals) {
224 for (keys %$cfg) {
225 $config = Catalyst::Utils::merge_hashes( $config, $cfg->{$_} );
b4a6fa62 226 }
292277c1 227 }
228 return $config;
229 },
230 dependencies => [ depends_on('global_config'), depends_on('local_config') ],
f04816ce 231 );
232}
b4a6fa62 233
f04816ce 234sub build_global_files_service {
235 my $self = shift;
b4a6fa62 236
292277c1 237 return Bread::Board::BlockInjection->new(
238 name => 'global_files',
239 block => sub {
240 my $s = shift;
b4a6fa62 241
292277c1 242 my ( $path, $extension ) = @{$s->param('config_path')};
b4a6fa62 243
292277c1 244 my @extensions = @{$s->param('extensions')};
245
246 my @files;
247 if ( $extension ) {
248 die "Unable to handle files with the extension '${extension}'" unless grep { $_ eq $extension } @extensions;
249 push @files, $path;
250 } else {
251 @files = map { "$path.$_" } @extensions;
252 }
253 return \@files;
254 },
255 dependencies => [ depends_on('extensions'), depends_on('config_path') ],
f04816ce 256 );
257}
b4a6fa62 258
f04816ce 259sub build_local_files_service {
260 my $self = shift;
292277c1 261
262 return Bread::Board::BlockInjection->new(
263 name => 'local_files',
264 block => sub {
265 my $s = shift;
266
267 my ( $path, $extension ) = @{$s->param('config_path')};
268 my $suffix = $s->param('config_local_suffix');
269
270 my @extensions = @{$s->param('extensions')};
271
272 my @files;
273 if ( $extension ) {
274 die "Unable to handle files with the extension '${extension}'" unless grep { $_ eq $extension } @extensions;
275 $path =~ s{\.$extension}{_$suffix.$extension};
276 push @files, $path;
277 } else {
278 @files = map { "${path}_${suffix}.$_" } @extensions;
279 }
280 return \@files;
281 },
282 dependencies => [ depends_on('extensions'), depends_on('config_path'), depends_on('config_local_suffix') ],
f04816ce 283 );
284}
b4a6fa62 285
f04816ce 286sub build_global_config_service {
287 my $self = shift;
292277c1 288
289 return Bread::Board::BlockInjection->new(
290 name => 'global_config',
291 block => sub {
292 my $s = shift;
293
294 return Config::Any->load_files({
295 files => $s->param('global_files'),
296 filter => \&_fix_syntax,
297 use_ext => 1,
298 driver_args => $s->param('driver'),
299 });
300 },
301 dependencies => [ depends_on('global_files') ],
f04816ce 302 );
303}
b4a6fa62 304
f04816ce 305sub build_local_config_service {
306 my $self = shift;
292277c1 307
308 return Bread::Board::BlockInjection->new(
309 name => 'local_config',
310 block => sub {
311 my $s = shift;
312
313 return Config::Any->load_files({
314 files => $s->param('local_files'),
315 filter => \&_fix_syntax,
316 use_ext => 1,
317 driver_args => $s->param('driver'),
318 });
319 },
320 dependencies => [ depends_on('local_files') ],
f04816ce 321 );
322}
b4a6fa62 323
f04816ce 324sub build_config_path_service {
325 my $self = shift;
b4a6fa62 326
292277c1 327 return Bread::Board::BlockInjection->new(
328 name => 'config_path',
329 block => sub {
330 my $s = shift;
b4a6fa62 331
292277c1 332 my $path = $s->param('path');
333 my $prefix = $s->param('prefix');
b4a6fa62 334
292277c1 335 my ( $extension ) = ( $path =~ m{\.(.{1,4})$} );
336
337 if ( -d $path ) {
338 $path =~ s{[\/\\]$}{};
339 $path .= "/$prefix";
340 }
b4a6fa62 341
292277c1 342 return [ $path, $extension ];
343 },
344 dependencies => [ depends_on('prefix'), depends_on('path') ],
f04816ce 345 );
346}
b4a6fa62 347
f04816ce 348sub build_config_local_suffix_service {
349 my $self = shift;
292277c1 350
351 return Bread::Board::BlockInjection->new(
352 name => 'config_local_suffix',
353 block => sub {
354 my $s = shift;
355 my $suffix = Catalyst::Utils::env_value( $s->param('name'), 'CONFIG_LOCAL_SUFFIX' ) || $self->config_local_suffix;
356
357 return $suffix;
358 },
359 dependencies => [ depends_on('name') ],
f04816ce 360 );
b4a6fa62 361}
362
363sub _fix_syntax {
364 my $config = shift;
365 my @components = (
366 map +{
367 prefix => $_ eq 'Component' ? '' : $_ . '::',
368 values => delete $config->{ lc $_ } || delete $config->{ $_ }
369 },
370 grep { ref $config->{ lc $_ } || ref $config->{ $_ } }
371 qw( Component Model M View V Controller C Plugin )
372 );
373
374 foreach my $comp ( @components ) {
375 my $prefix = $comp->{ prefix };
376 foreach my $element ( keys %{ $comp->{ values } } ) {
377 $config->{ "$prefix$element" } = $comp->{ values }->{ $element };
378 }
379 }
380}
381
382sub _config_substitutions {
6682389c 383 my ( $self, $name, $subs, $arg ) = @_;
b4a6fa62 384
385 $subs->{ HOME } ||= sub { shift->path_to( '' ); };
386 $subs->{ ENV } ||=
387 sub {
388 my ( $c, $v ) = @_;
389 if (! defined($ENV{$v})) {
390 Catalyst::Exception->throw( message =>
391 "Missing environment variable: $v" );
392 return "";
393 } else {
394 return $ENV{ $v };
395 }
396 };
397 $subs->{ path_to } ||= sub { shift->path_to( @_ ); };
398 $subs->{ literal } ||= sub { return $_[ 1 ]; };
399 my $subsre = join( '|', keys %$subs );
400
6682389c 401 $arg =~ s{__($subsre)(?:\((.+?)\))?__}{ $subs->{ $1 }->( $name, $2 ? split( /,/, $2 ) : () ) }eg;
402 return $arg;
b4a6fa62 403}
404
a17e0ff8 405sub get_component_from_sub_container {
406 my ( $self, $sub_container_name, $name, $c, @args ) = @_;
407
408 my $sub_container = $self->get_sub_container( $sub_container_name );
409
0e747f0c 410 if (!$name) {
411 my $default_name = 'default_' . $sub_container_name;
412 my $default = $self->resolve( service => $default_name )
413 if $self->has_service($default_name);
414
415 return $sub_container->get_component( $default, $c, @args )
416 if $default && $sub_container->has_service( $default );
417
418 # this is never a controller, so this is safe
419 $c->log->warn( "Calling \$c->$sub_container_name() is not supported unless you specify one of:" );
420 $c->log->warn( "* \$c->config(default_$sub_container_name => 'the name of the default $sub_container_name to use')" );
421 $c->log->warn( "* \$c->stash->{current_$sub_container_name} # the name of the view to use for this request" );
422 $c->log->warn( "* \$c->stash->{current_${sub_container_name}_instance} # the instance of the $sub_container_name to use for this request" );
423 }
424
a17e0ff8 425 return $sub_container->get_component_regexp( $name, $c, @args )
426 if ref $name;
427
428 return $sub_container->get_component( $name, $c, @args )
429 if $sub_container->has_service( $name );
430
431 $c->log->warn(
432 "Attempted to use $sub_container_name '$name', " .
433 "but it does not exist"
434 );
435
436 return;
437}
438
d057ddb9 4391;
440
441__END__
442
443=pod
444
445=head1 NAME
446
447Catalyst::Container - IOC for Catalyst components
448
449=head1 METHODS
450
451=head2 build_model_subcontainer
452
453=head2 build_view_subcontainer
454
455=head2 build_controller_subcontainer
456
f97a8d0d 457=head2 build_default_model_service
458
459=head2 build_default_view_service
460
d057ddb9 461=head2 build_name_service
462
463=head2 build_driver_service
464
465=head2 build_file_service
466
467=head2 build_substitutions_service
468
469=head2 build_extensions_service
470
471=head2 build_prefix_service
472
473=head2 build_path_service
474
475=head2 build_config_service
476
477=head2 build_raw_config_service
478
479=head2 build_global_files_service
480
481=head2 build_local_files_service
482
483=head2 build_global_config_service
484
485=head2 build_local_config_service
486
487=head2 build_config_path_service
488
489=head2 build_config_local_suffix_service
490
491=head2 _fix_syntax
492
493=head2 _config_substitutions
494
bf3c8088 495=head1 AUTHORS
496
e8ed391e 497Catalyst Contributors, see Catalyst.pm
bf3c8088 498
e8ed391e 499=head1 COPYRIGHT
bf3c8088 500
501This library is free software. You can redistribute it and/or modify it under
502the same terms as Perl itself.
503
504=cut