DBIx/Class/Optional/Dependencies.pm

filter: Statementstmt 73.4% 72 / 98 Branchbran 48.6% 37 / 76 Conditioncond 30.0% 3 / 10 MC/DCmcdc 0.0% 0 / 5 Subroutinesub 81.8% 9 / 11 Podpod 100% 6 / 6 totaltotal 61.6% 127 / 206 CC 26 SCAR 37.8
CC
26
Cov
61%
_gen_pod
132.0
die_unless_req_ok_for
12.0
_check_deps
8.0
CRAP 43.9
« DBIx/Class/CDBICompat/AccessorMapping.pm ↑ Summary DBIx/Class/Storage/DBI/SQLite.pm »
1 package DBIx::Class::Optional::Dependencies;
2  
3 387 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 387 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
5  
6 387 ▶use Carp ();
Subroutine BEGIN: called CC=1 SCAR=0.0
7  
8 # NO EXTERNAL NON-5.8.1 CORE DEPENDENCIES EVER (e.g. C::A::G)
9 # This module is to be loaded by Makefile.PM on a pristine system
10  
11 # POD is generated automatically by calling _gen_pod from the
12 # Makefile.PL in $AUTHOR mode
13  
14 # NOTE: the rationale for 2 JSON::Any versions is that
15 # we need the newer only to work around JSON::XS, which
16 # itself is an optional dep
17 387 my $min_json_any = {
18 'JSON::Any' => '1.23',
19 };
20 387 my $test_and_dist_json_any = {
21 'JSON::Any' => '1.31',
22 };
23  
24 387 my $moose_basic = {
25 'Moose' => '0.98',
26 'MooseX::Types' => '0.21',
27 'MooseX::Types::LoadableClass' => '0.011',
28 };
29  
30 387 my $replicated = {
31 'Clone' => 0,
32 %$moose_basic,
33 };
34  
35 387 my $admin_basic = {
36 %$moose_basic,
37 %$min_json_any,
38 'MooseX::Types::Path::Class' => '0.05',
39 'MooseX::Types::JSON' => '0.02',
40 };
41  
42 387 my $admin_script = {
43 %$moose_basic,
44 %$admin_basic,
45 'Getopt::Long::Descriptive' => '0.081',
46 'Text::CSV' => '1.16',
47 };
48  
49 387 my $datetime_basic = {
50 'DateTime' => '0.55',
51 'DateTime::Format::Strptime' => '1.2',
52 };
53  
54 387 my $id_shortener = {
55 'Math::BigInt' => '1.80',
56 'Math::Base36' => '0.07',
57 };
58  
59 387 my $rdbms_sqlite = {
60 'DBD::SQLite' => '0',
61 };
62 387 my $rdbms_pg = {
63 'DBD::Pg' => '0',
64 };
65 387 my $rdbms_mssql_odbc = {
66 'DBD::ODBC' => '0',
67 };
68 387 my $rdbms_mssql_sybase = {
69 'DBD::Sybase' => '0',
70 };
71 387 my $rdbms_mssql_ado = {
72 'DBD::ADO' => '0',
73 };
74 387 my $rdbms_msaccess_odbc = {
75 'DBD::ODBC' => '0',
76 };
77 387 my $rdbms_msaccess_ado = {
78 'DBD::ADO' => '0',
79 };
80 387 my $rdbms_mysql = {
81 'DBD::mysql' => '0',
82 };
83 387 my $rdbms_oracle = {
84 'DBD::Oracle' => '0',
85 %$id_shortener,
86 };
87 387 my $rdbms_ase = {
88 'DBD::Sybase' => '0',
89 };
90 387 my $rdbms_db2 = {
91 'DBD::DB2' => '0',
92 };
93 387 my $rdbms_db2_400 = {
94 'DBD::ODBC' => '0',
95 };
96 387 my $rdbms_informix = {
97 'DBD::Informix' => '0',
98 };
99 387 my $rdbms_sqlanywhere = {
100 'DBD::SQLAnywhere' => '0',
101 };
102 387 my $rdbms_sqlanywhere_odbc = {
103 'DBD::ODBC' => '0',
104 };
105 387 my $rdbms_firebird = {
106 'DBD::Firebird' => '0',
107 };
108 387 my $rdbms_firebird_interbase = {
109 'DBD::InterBase' => '0',
110 };
111 387 my $rdbms_firebird_odbc = {
112 'DBD::ODBC' => '0',
113 };
114  
115 my $reqs = {
116 replicated => {
117 req => $replicated,
118 pod => {
119 title => 'Storage::Replicated',
120 desc => 'Modules required for L<DBIx::Class::Storage::DBI::Replicated>',
121 },
122 },
123  
124 test_replicated => {
125 req => {
126 %$replicated,
127 'Test::Moose' => '0',
128 },
129 },
130  
131  
132 admin => {
133 req => {
134 %$admin_basic,
135 },
136 pod => {
137 title => 'DBIx::Class::Admin',
138 desc => 'Modules required for the DBIx::Class administrative library',
139 },
140 },
141  
142 admin_script => {
143 req => {
144 %$admin_script,
145 },
146 pod => {
147 title => 'dbicadmin',
148 desc => 'Modules required for the CLI DBIx::Class interface dbicadmin',
149 },
150 },
151  
152 deploy => {
153 req => {
154 'SQL::Translator' => '0.11018',
155 },
156 pod => {
157 title => 'Storage::DBI::deploy()',
158 desc => 'Modules required for L<DBIx::Class::Storage::DBI/deployment_statements> and L<DBIx::Class::Schema/deploy>',
159 },
160 },
161  
162 id_shortener => {
163 req => $id_shortener,
164 },
165  
166 test_component_accessor => {
167 req => {
168 'Class::Unload' => '0.07',
169 },
170 },
171  
172 test_pod => {
173 req => {
174 'Test::Pod' => '1.42',
175 },
176 },
177  
178 test_podcoverage => {
179 req => {
180 'Test::Pod::Coverage' => '1.08',
181 'Pod::Coverage' => '0.20',
182 },
183 },
184  
185 test_whitespace => {
186 req => {
187 'Test::EOL' => '1.0',
188 'Test::NoTabs' => '0.9',
189 },
190 },
191  
192 test_strictures => {
193 req => {
194 'Test::Strict' => '0.20',
195 },
196 },
197  
198 test_prettydebug => {
199 req => $min_json_any,
200 },
201  
202 test_admin_script => {
203 req => {
204 %$admin_script,
205 %$test_and_dist_json_any,
206 'JSON' => 0,
207 'JSON::PP' => 0,
208 'Cpanel::JSON::XS' => 0,
209 'JSON::XS' => 0,
210 $^O eq 'MSWin32'
211 # for t/admin/10script.t
212 ? ('Win32::ShellQuote' => 0)
213 # DWIW does not compile (./configure even) on win32
214 : ('JSON::DWIW' => 0 )
215 ,
216 }
217 },
218  
219 test_leaks_heavy => {
220 req => {
221 'Class::MethodCache' => '0.02',
222 'PadWalker' => '1.06',
223 },
224 },
225  
226 test_dt => {
227 req => $datetime_basic,
228 },
229  
230 test_dt_sqlite => {
231 req => {
232 %$datetime_basic,
233 # t/36datetime.t
234 # t/60core.t
235 'DateTime::Format::SQLite' => '0',
236 },
237 },
238  
239 test_dt_mysql => {
240 req => {
241 %$datetime_basic,
242 # t/inflate/datetime_mysql.t
243 # (doesn't need Mysql itself)
244 'DateTime::Format::MySQL' => '0',
245 },
246 },
247  
248 test_dt_pg => {
249 req => {
250 %$datetime_basic,
251 # t/inflate/datetime_pg.t
252 # (doesn't need PG itself)
253 'DateTime::Format::Pg' => '0.16004',
254 },
255 },
256  
257 test_cdbicompat => {
258 req => {
259 'Class::DBI::Plugin::DeepAbstractSearch' => '0',
260 %$datetime_basic,
261 'Time::Piece::MySQL' => '0',
262 'Date::Simple' => '3.03',
263 },
264 },
265  
266 # this is just for completeness as SQLite
267 # is a core dep of DBIC for testing
268 rdbms_sqlite => {
269 req => {
270 %$rdbms_sqlite,
271 },
272 pod => {
273 title => 'SQLite support',
274 desc => 'Modules required to connect to SQLite',
275 },
276 },
277  
278 rdbms_pg => {
279 req => {
280 # when changing this list make sure to adjust xt/optional_deps.t
281 %$rdbms_pg,
282 },
283 pod => {
284 title => 'PostgreSQL support',
285 desc => 'Modules required to connect to PostgreSQL',
286 },
287 },
288  
289 rdbms_mssql_odbc => {
290 req => {
291 %$rdbms_mssql_odbc,
292 },
293 pod => {
294 title => 'MSSQL support via DBD::ODBC',
295 desc => 'Modules required to connect to MSSQL via DBD::ODBC',
296 },
297 },
298  
299 rdbms_mssql_sybase => {
300 req => {
301 %$rdbms_mssql_sybase,
302 },
303 pod => {
304 title => 'MSSQL support via DBD::Sybase',
305 desc => 'Modules required to connect to MSSQL via DBD::Sybase',
306 },
307 },
308  
309 rdbms_mssql_ado => {
310 req => {
311 %$rdbms_mssql_ado,
312 },
313 pod => {
314 title => 'MSSQL support via DBD::ADO (Windows only)',
315 desc => 'Modules required to connect to MSSQL via DBD::ADO. This particular DBD is available on Windows only',
316 },
317 },
318  
319 rdbms_msaccess_odbc => {
320 req => {
321 %$rdbms_msaccess_odbc,
322 },
323 pod => {
324 title => 'MS Access support via DBD::ODBC',
325 desc => 'Modules required to connect to MS Access via DBD::ODBC',
326 },
327 },
328  
329 rdbms_msaccess_ado => {
330 req => {
331 %$rdbms_msaccess_ado,
332 },
333 pod => {
334 title => 'MS Access support via DBD::ADO (Windows only)',
335 desc => 'Modules required to connect to MS Access via DBD::ADO. This particular DBD is available on Windows only',
336 },
337 },
338  
339 rdbms_mysql => {
340 req => {
341 %$rdbms_mysql,
342 },
343 pod => {
344 title => 'MySQL support',
345 desc => 'Modules required to connect to MySQL',
346 },
347 },
348  
349 rdbms_oracle => {
350 req => {
351 %$rdbms_oracle,
352 },
353 pod => {
354 title => 'Oracle support',
355 desc => 'Modules required to connect to Oracle',
356 },
357 },
358  
359 rdbms_ase => {
360 req => {
361 %$rdbms_ase,
362 },
363 pod => {
364 title => 'Sybase ASE support',
365 desc => 'Modules required to connect to Sybase ASE',
366 },
367 },
368  
369 rdbms_db2 => {
370 req => {
371 %$rdbms_db2,
372 },
373 pod => {
374 title => 'DB2 support',
375 desc => 'Modules required to connect to DB2',
376 },
377 },
378  
379 rdbms_db2_400 => {
380 req => {
381 %$rdbms_db2_400,
382 },
383 pod => {
384 title => 'DB2 on AS/400 support',
385 desc => 'Modules required to connect to DB2 on AS/400',
386 },
387 },
388  
389 rdbms_informix => {
390 req => {
391 %$rdbms_informix,
392 },
393 pod => {
394 title => 'Informix support',
395 desc => 'Modules required to connect to Informix',
396 },
397 },
398  
399 rdbms_sqlanywhere => {
400 req => {
401 %$rdbms_sqlanywhere,
402 },
403 pod => {
404 title => 'SQLAnywhere support',
405 desc => 'Modules required to connect to SQLAnywhere',
406 },
407 },
408  
409 rdbms_sqlanywhere_odbc => {
410 req => {
411 %$rdbms_sqlanywhere_odbc,
412 },
413 pod => {
414 title => 'SQLAnywhere support via DBD::ODBC',
415 desc => 'Modules required to connect to SQLAnywhere via DBD::ODBC',
416 },
417 },
418  
419 rdbms_firebird => {
420 req => {
421 %$rdbms_firebird,
422 },
423 pod => {
424 title => 'Firebird support',
425 desc => 'Modules required to connect to Firebird',
426 },
427 },
428  
429 rdbms_firebird_interbase => {
430 req => {
431 %$rdbms_firebird_interbase,
432 },
433 pod => {
434 title => 'Firebird support via DBD::InterBase',
435 desc => 'Modules required to connect to Firebird via DBD::InterBase',
436 },
437 },
438  
439 rdbms_firebird_odbc => {
440 req => {
441 %$rdbms_firebird_odbc,
442 },
443 pod => {
444 title => 'Firebird support via DBD::ODBC',
445 desc => 'Modules required to connect to Firebird via DBD::ODBC',
446 },
447 },
448  
449 # the order does matter because the rdbms support group might require
450 # a different version that the test group
451 test_rdbms_pg => {
452 req => {
453 $ENV{DBICTEST_PG_DSN}
454 ? (
455 # when changing this list make sure to adjust xt/optional_deps.t
456 %$rdbms_pg,
457 'DBD::Pg' => '2.009002',
458 ) : ()
459 },
460 },
461  
462 test_rdbms_mssql_odbc => {
463 req => {
464 $ENV{DBICTEST_MSSQL_ODBC_DSN}
465 ? (
466 %$rdbms_mssql_odbc,
467 ) : ()
468 },
469 },
470  
471 test_rdbms_mssql_ado => {
472 req => {
473 $ENV{DBICTEST_MSSQL_ADO_DSN}
474 ? (
475 %$rdbms_mssql_ado,
476 ) : ()
477 },
478 },
479  
480 test_rdbms_mssql_sybase => {
481 req => {
482 $ENV{DBICTEST_MSSQL_DSN}
483 ? (
484 %$rdbms_mssql_sybase,
485 ) : ()
486 },
487 },
488  
489 test_rdbms_msaccess_odbc => {
490 req => {
491 $ENV{DBICTEST_MSACCESS_ODBC_DSN}
492 ? (
493 %$rdbms_msaccess_odbc,
494 %$datetime_basic,
495 'Data::GUID' => '0',
496 ) : ()
497 },
498 },
499  
500 test_rdbms_msaccess_ado => {
501 req => {
502 $ENV{DBICTEST_MSACCESS_ADO_DSN}
503 ? (
504 %$rdbms_msaccess_ado,
505 %$datetime_basic,
506 'Data::GUID' => 0,
507 ) : ()
508 },
509 },
510  
511 test_rdbms_mysql => {
512 req => {
513 $ENV{DBICTEST_MYSQL_DSN}
514 ? (
515 %$rdbms_mysql,
516 ) : ()
517 },
518 },
519  
520 test_rdbms_oracle => {
521 req => {
522 $ENV{DBICTEST_ORA_DSN}
523 ? (
524 %$rdbms_oracle,
525 'DateTime::Format::Oracle' => '0',
526 'DBD::Oracle' => '1.24',
527 ) : ()
528 },
529 },
530  
531 test_rdbms_ase => {
532 req => {
533 $ENV{DBICTEST_SYBASE_DSN}
534 ? (
535 %$rdbms_ase,
536 ) : ()
537 },
538 },
539  
540 test_rdbms_db2 => {
541 req => {
542 $ENV{DBICTEST_DB2_DSN}
543 ? (
544 %$rdbms_db2,
545 ) : ()
546 },
547 },
548  
549 test_rdbms_db2_400 => {
550 req => {
551 $ENV{DBICTEST_DB2_400_DSN}
552 ? (
553 %$rdbms_db2_400,
554 ) : ()
555 },
556 },
557  
558 test_rdbms_informix => {
559 req => {
560 $ENV{DBICTEST_INFORMIX_DSN}
561 ? (
562 %$rdbms_informix,
563 ) : ()
564 },
565 },
566  
567 test_rdbms_sqlanywhere => {
568 req => {
569 $ENV{DBICTEST_SQLANYWHERE_DSN}
570 ? (
571 %$rdbms_sqlanywhere,
572 ) : ()
573 },
574 },
575  
576 test_rdbms_sqlanywhere_odbc => {
577 req => {
578 $ENV{DBICTEST_SQLANYWHERE_ODBC_DSN}
579 ? (
580 %$rdbms_sqlanywhere_odbc,
581 ) : ()
582 },
583 },
584  
585 test_rdbms_firebird => {
586 req => {
587 $ENV{DBICTEST_FIREBIRD_DSN}
588 ? (
589 %$rdbms_firebird,
590 ) : ()
591 },
592 },
593  
594 test_rdbms_firebird_interbase => {
595 req => {
596 $ENV{DBICTEST_FIREBIRD_INTERBASE_DSN}
597 ? (
598 %$rdbms_firebird_interbase,
599 ) : ()
600 },
601 },
602  
603 test_rdbms_firebird_odbc => {
604 req => {
605 $ENV{DBICTEST_FIREBIRD_ODBC_DSN}
606 ? (
607 %$rdbms_firebird_odbc,
608 ) : ()
609 },
610 },
611  
612 test_memcached => {
613 req => {
614 $ENV{DBICTEST_MEMCACHED}
615 ? (
616 387 ▶ 'Cache::Memcached' => 0,
Branch: 19 branches
BranchTrueFalseTotal
$^O eq 'MSWin32' ? : 0 387 387
$ENV{'DBICTEST_PG_DSN'} ? : 1 386 387
$ENV{'DBICTEST_MSSQL_ODBC_DSN'} ? : 0 387 387
$ENV{'DBICTEST_MSSQL_ADO_DSN'} ? : 0 387 387
$ENV{'DBICTEST_MSSQL_DSN'} ? : 0 387 387
$ENV{'DBICTEST_MSACCESS_ODBC_DSN'} ? : 0 387 387
$ENV{'DBICTEST_MSACCESS_ADO_DSN'} ? : 0 387 387
$ENV{'DBICTEST_MYSQL_DSN'} ? : 0 387 387
$ENV{'DBICTEST_ORA_DSN'} ? : 0 387 387
$ENV{'DBICTEST_SYBASE_DSN'} ? : 0 387 387
$ENV{'DBICTEST_DB2_DSN'} ? : 0 387 387
$ENV{'DBICTEST_DB2_400_DSN'} ? : 0 387 387
$ENV{'DBICTEST_INFORMIX_DSN'} ? : 0 387 387
$ENV{'DBICTEST_SQLANYWHERE_DSN'} ? : 0 387 387
$ENV{'DBICTEST_SQLANYWHERE_ODBC_DSN'} ? : 0 387 387
$ENV{'DBICTEST_FIREBIRD_DSN'} ? : 0 387 387
$ENV{'DBICTEST_FIREBIRD_INTERBASE_DSN'} ? : 0 387 387
$ENV{'DBICTEST_FIREBIRD_ODBC_DSN'} ? : 0 387 387
$ENV{'DBICTEST_MEMCACHED'} ? : 0 387 387
617 ) : ()
618 },
619 },
620  
621 dist_dir => {
622 req => {
623 %$admin_script,
624 %$test_and_dist_json_any,
625 'ExtUtils::MakeMaker' => '6.64',
626 'Pod::Inherit' => '0.91',
627 },
628 },
629  
630 dist_upload => {
631 req => {
632 'CPAN::Uploader' => '0.103001',
633 },
634 },
635  
636 };
637  
638 387 our %req_availability_cache;
639  
640 424 ▶sub req_list_for {
Subroutine req_list_for: called CC=3 SCAR=11.0
Pod documented
641 424 my ($class, $group) = @_;
642  
643 424 ▶ Carp::croak "req_list_for() expects a requirement group name"
Branch: 1 branch
BranchTrueFalseTotal
unless $group 4 420 424
644 unless $group;
645  
646 my $deps = $reqs->{$group}{req}
647 420 ▶ or Carp::croak "Requirement group '$group' does not exist";
Branch: 1 branch
BranchTrueFalseTotal
my $deps = $reqs->{$group}{"req"} or Carp::croak("Requirement group '${group}' does not exist") 418 2 420
648  
649 418 return { %$deps };
650 }
651  
652  
653 0 ▶sub die_unless_req_ok_for {
Subroutine die_unless_req_ok_for: not called CC=3 SCAR=24.8
Pod documented
654 0 my ($class, $group) = @_;
655  
656 0 ▶ Carp::croak "die_unless_req_ok_for() expects a requirement group name"
Branch: 1 branch
BranchTrueFalseTotal
unless $group 0 0 0
657 unless $group;
658  
659 $class->_check_deps($group)->{status}
660 0 ▶ or die sprintf( "Required modules missing, unable to continue: %s\n", $class->_check_deps($group)->{missing} );
Branch: 1 branch
BranchTrueFalseTotal
$class->_check_deps($group)->{"status"} or die sprintf("Required modules missing, unable to continue: %s\n", $class->_check_deps($group)->{"missing"}) 0 0 0
661 }
662  
663 376 ▶sub req_ok_for {
Subroutine req_ok_for: called CC=2 SCAR=7.1
Pod documented
664 376 my ($class, $group) = @_;
665  
666 376 ▶ Carp::croak "req_ok_for() expects a requirement group name"
Branch: 1 branch
BranchTrueFalseTotal
unless $group 0 376 376
667 unless $group;
668  
669 376 return $class->_check_deps($group)->{status};
670 }
671  
672 40 ▶sub req_missing_for {
Subroutine req_missing_for: called CC=2 SCAR=7.1
Pod documented
673 40 my ($class, $group) = @_;
674  
675 40 ▶ Carp::croak "req_missing_for() expects a requirement group name"
Branch: 1 branch
BranchTrueFalseTotal
unless $group 0 40 40
676 unless $group;
677  
678 40 return $class->_check_deps($group)->{missing};
679 }
680  
681 2 ▶sub req_errorlist_for {
Subroutine req_errorlist_for: called CC=2 SCAR=7.1
Pod documented
682 2 my ($class, $group) = @_;
683  
684 2 ▶ Carp::croak "req_errorlist_for() expects a requirement group name"
Branch: 1 branch
BranchTrueFalseTotal
unless $group 0 2 2
685 unless $group;
686  
687 2 return $class->_check_deps($group)->{errorlist};
688 }
689  
690 418 ▶sub _check_deps {
Subroutine _check_deps: called CC=8 SCAR=20.8
691 418 my ($class, $group) = @_;
692  
693 418 ▶ return $req_availability_cache{$group} ||= do {
Condition66%2/3
$DBIx::Class::Optional::Dependencies::req_availability_cache{$group} ||= do { my $deps = $class->req_list_for($group); my %errors; foreach my $mod (keys %$deps) { my $req_line = "require $mod;"; if (my $ver = $deps->{$mod}) { $req_line .= "$mod->VERSION($ver);"; } ; eval $req_line; $errors{$mod} = $@ if $@; } ; my $res; if (keys %errors) { my $missing = join(", ", map({$deps->{$_} ? "$_ >= $deps->{$_}" : $_;} sort(keys %errors))); $missing .= " (see $class for details)" if $reqs->{$group}{"pod"}; $res = {"status", 0, "errorlist", \%errors, "missing", $missing}; } else { $res = {"status", 1, "errorlist", {}, "missing", ""}; } ; $res }
l!l&&r!l&&!r
413770
MC/DC0%0/2
$DBIx::Class::Optional::Dependencies::req_availability_cache{$group} ||= do { my $deps = $class->req_list_for($group); my %errors; foreach my $mod (keys %$deps) { my $req_line = "require $mod;"; if (my $ver = $deps->{$mod}) { $req_line .= "$mod->VERSION($ver);"; } ; eval $req_line; $errors{$mod} = $@ if $@; } ; my $res; if (keys %errors) { my $missing = join(", ", map({$deps->{$_} ? "$_ >= $deps->{$_}" : $_;} sort(keys %errors))); $missing .= " (see $class for details)" if $reqs->{$group}{"pod"}; $res = {"status", 0, "errorlist", \%errors, "missing", $missing}; } else { $res = {"status", 1, "errorlist", {}, "missing", ""}; } ; $res }
$DBIx::Class::Optional::Dependencies::req_availability_cache{$group} do { my $deps = $class->req_list_for($group); my %errors; foreach my $mod (keys %$deps) { my $req_line = "require $mod;"; if (my $ver = $deps->{$mod}) { $req_line .= "$mod->VERSION($ver);"; } ; eval $req_line; $errors{$mod} = $@ if $@; } ; my $res; if (keys %errors) { my $missing = join(", ", map({$deps->{$_} ? "$_ >= $deps->{$_}" : $_;} sort(keys %errors))); $missing .= " (see $class for details)" if $reqs->{$group}{"pod"}; $res = {"status", 0, "errorlist", \%errors, "missing", $missing}; } else { $res = {"status", 1, "errorlist", {}, "missing", ""}; } ; $res }
Truth table66%2/3
A ||= B
A= $DBIx::Class::Optional::Dependencies::req_availability_cache{$group}B= do { my $deps = $class->req_list_for($group); my %errors; foreach my $mod (keys %$deps) { my $req_line = "require $mod;"; if (my $ver = $deps->{$mod}) { $req_line .= "$mod->VERSION($ver);"; } ; eval $req_line; $errors{$mod} = $@ if $@; } ; my $res; if (keys %errors) { my $missing = join(", ", map({$deps->{$_} ? "$_ >= $deps->{$_}" : $_;} sort(keys %errors))); $missing .= " (see $class for details)" if $reqs->{$group}{"pod"}; $res = {"status", 0, "errorlist", \%errors, "missing", $missing}; } else { $res = {"status", 1, "errorlist", {}, "missing", ""}; } ; $res }
ABresult
1X1
011
000
694  
695 377 my $deps = $class->req_list_for ($group);
696  
697 377 my %errors;
698 377 for my $mod (keys %$deps) {
699 776 my $req_line = "require $mod;";
700 776 ▶ if (my $ver = $deps->{$mod}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $ver = $deps->{$mod}) 758 18 776
701 758 $req_line .= "$mod->VERSION($ver);";
702 }
703  
704 776 eval $req_line;
705  
706 776 ▶ $errors{$mod} = $@ if $@;
Branch: 1 branch
BranchTrueFalseTotal
if $@ 437 339 776
707 }
708  
709 377 my $res;
710  
711 377 ▶ if (keys %errors) {
Branch: 1 branch
BranchTrueFalseTotal
if (keys %errors) { } 365 12 377
712 365 ▶ my $missing = join (', ', map { $deps->{$_} ? "$_ >= $deps->{$_}" : $_ } (sort keys %errors) );
Branch: 1 branch
BranchTrueFalseTotal
$deps->{$_} ? : 425 12 437
713 365 ▶ $missing .= " (see $class for details)" if $reqs->{$group}{pod};
Branch: 1 branch
BranchTrueFalseTotal
if $reqs->{$group}{"pod"} 16 349 365
714 365 $res = {
715 status => 0,
716 errorlist => \%errors,
717 missing => $missing,
718 };
719 }
720 else {
721 12 $res = {
722 status => 1,
723 errorlist => {},
724 missing => '',
725 };
726 }
727  
728 377 $res;
729 };
730 }
731  
732 1 ▶sub req_group_list {
Subroutine req_group_list: called CC=2 SCAR=7.1
Pod documented
733 1 ▶ return { map { $_ => { %{ $reqs->{$_}{req} || {} } } } (keys %$reqs) };
Condition50%1/2
$reqs->{$_}{'req'} || {}
l!l
570
MC/DC0%0/1
$reqs->{$_}{'req'} || {}
$reqs->{$_}{'req'}
Truth table50%1/2
A
A= $reqs->{$_}{'req'}
Aresult
11
00
734 }
735  
736 # This is to be called by the author only (automatically in Makefile.PL)
737 0 ▶sub _gen_pod {
Subroutine _gen_pod: not called CC=11 SCAR=48.8
738 0 my ($class, $distver, $pod_dir) = @_;
739  
740 0 ▶ die "No POD root dir supplied" unless $pod_dir;
Branch: 1 branch
BranchTrueFalseTotal
unless $pod_dir 0 0 0
741  
742 $distver ||=
743 0 ▶ eval { require DBIx::Class; DBIx::Class->VERSION; }
Condition0%0/5
$distver ||= eval { do { require DBIx::Class; "DBIx::Class"->VERSION } } || die("\n\n---------------------------------------------------------------------\nUnable to load core DBIx::Class module to determine current version, possibly due to missing dependencies. Author-mode autodocumentation halted\n\n" . $@ . "\n\n---------------------------------------------------------------------\n")
l!l&&r!l&&!r
000
eval { do { require DBIx::Class; 'DBIx::Class'->VERSION } } || die("\n\n---------------------------------------------------------------------\nUnable to load core DBIx::Class module to determine current version, possibly due to missing dependencies. Author-mode autodocumentation halted\n\n" . $@ . "\n\n---------------------------------------------------------------------\n")
l!l
00
MC/DC0%0/2
$distver ||= eval { do { require DBIx::Class; "DBIx::Class"->VERSION } } || die("\n\n---------------------------------------------------------------------\nUnable to load core DBIx::Class module to determine current version, possibly due to missing dependencies. Author-mode autodocumentation halted\n\n" . $@ . "\n\n---------------------------------------------------------------------\n")
$distver eval { do { require DBIx::Class; 'DBIx::Class'->VERSION } }
Truth table0%0/3
A ||= B
A= $distverB= eval { do { require DBIx::Class; 'DBIx::Class'->VERSION } }
ABresult
1X1
011
000
744 ||
745 die
746 "\n\n---------------------------------------------------------------------\n" .
747 'Unable to load core DBIx::Class module to determine current version, '.
748 'possibly due to missing dependencies. Author-mode autodocumentation ' .
749 "halted\n\n" . $@ .
750 "\n\n---------------------------------------------------------------------\n"
751 ;
752  
753 # do not ask for a recent version, use 1.x API calls
754 # this *may* execute on a smoker with old perl or whatnot
755 0 require File::Path;
756  
757 0 (my $modfn = __PACKAGE__ . '.pm') =~ s|::|/|g;
758  
759 0 (my $podfn = "$pod_dir/$modfn") =~ s/\.pm$/\.pod/;
760 0 (my $dir = $podfn) =~ s|/[^/]+$||;
761  
762 0 File::Path::mkpath([$dir]);
763  
764 0 ▶ my $sqltver = $class->req_list_for ('deploy')->{'SQL::Translator'}
Branch: 1 branch
BranchTrueFalseTotal
my $sqltver = $class->req_list_for("deploy")->{"SQL::Translator"} or die "Hrmm? No sqlt dep?" 0 0 0
765 or die "Hrmm? No sqlt dep?";
766  
767 0 my @chunks = (
768 <<"EOC",
769 #########################################################################
770 ##################### A U T O G E N E R A T E D ########################
771 #########################################################################
772 #
773 # The contents of this POD file are auto-generated. Any changes you make
774 # will be lost. If you need to change the generated text edit _gen_pod()
775 # at the end of $modfn
776 #
777 EOC
778 '=head1 NAME',
779 "$class - Optional module dependency specifications (for module authors)",
780 '=head1 SYNOPSIS',
781 <<"EOS",
782 Somewhere in your build-file (e.g. L<Module::Install>'s Makefile.PL):
783  
784 ...
785  
786 configure_requires 'DBIx::Class' => '$distver';
787  
788 require $class;
789  
790 my \$deploy_deps = $class->req_list_for('deploy');
791  
792 for (keys %\$deploy_deps) {
793 requires \$_ => \$deploy_deps->{\$_};
794 }
795  
796 ...
797  
798 Note that there are some caveats regarding C<configure_requires()>, more info
799 can be found at L<Module::Install/configure_requires>
800 EOS
801 '=head1 DESCRIPTION',
802 <<'EOD',
803 Some of the less-frequently used features of L<DBIx::Class> have external
804 module dependencies on their own. In order not to burden the average user
805 with modules he will never use, these optional dependencies are not included
806 in the base Makefile.PL. Instead an exception with a descriptive message is
807 thrown when a specific feature is missing one or several modules required for
808 its operation. This module is the central holding place for the current list
809 of such dependencies, for DBIx::Class core authors, and DBIx::Class extension
810 authors alike.
811 EOD
812 '=head1 CURRENT REQUIREMENT GROUPS',
813 <<'EOD',
814 Dependencies are organized in C<groups> and each group can list one or more
815 required modules, with an optional minimum version (or 0 for any version).
816 The group name can be used in the
817 EOD
818 );
819  
820 0 for my $group (sort keys %$reqs) {
821 my $p = $reqs->{$group}{pod}
822 0 ▶ or next;
Branch: 1 branch
BranchTrueFalseTotal
my $p = $reqs->{$group}{"pod"} or next 0 0 0
823  
824 my $modlist = $reqs->{$group}{req}
825 0 ▶ or next;
Branch: 1 branch
BranchTrueFalseTotal
my $modlist = $reqs->{$group}{"req"} or next 0 0 0
826  
827 0 ▶ next unless keys %$modlist;
Branch: 1 branch
BranchTrueFalseTotal
unless keys %$modlist 0 0 0
828  
829 push @chunks, (
830 "=head2 $p->{title}",
831 "$p->{desc}",
832 '=over',
833 0 ▶ ( map { "=item * $_" . ($modlist->{$_} ? " >= $modlist->{$_}" : '') } (sort keys %$modlist) ),
Branch: 1 branch
BranchTrueFalseTotal
$modlist->{$_} ? : 0 0 0
834 '=back',
835 "Requirement group: B<$group>",
836 );
837 }
838  
839 0 push @chunks, (
840 '=head1 METHODS',
841 '=head2 req_group_list',
842 '=over',
843 '=item Arguments: none',
844 '=item Return Value: \%list_of_requirement_groups',
845 '=back',
846 <<'EOD',
847 This method should be used by DBIx::Class packagers, to get a hashref of all
848 dependencies keyed by dependency group. Each key (group name) can be supplied
849 to one of the group-specific methods below.
850 EOD
851  
852 '=head2 req_list_for',
853 '=over',
854 '=item Arguments: $group_name',
855 '=item Return Value: \%list_of_module_version_pairs',
856 '=back',
857 <<'EOD',
858 This method should be used by DBIx::Class extension authors, to determine the
859 version of modules a specific feature requires in the B<current> version of
860 DBIx::Class. See the L</SYNOPSIS> for a real-world
861 example.
862 EOD
863  
864 '=head2 req_ok_for',
865 '=over',
866 '=item Arguments: $group_name',
867 '=item Return Value: 1|0',
868 '=back',
869 <<'EOD',
870 Returns true or false depending on whether all modules required by
871 C<$group_name> are present on the system and loadable.
872 EOD
873  
874 '=head2 req_missing_for',
875 '=over',
876 '=item Arguments: $group_name',
877 '=item Return Value: $error_message_string',
878 '=back',
879 <<"EOD",
880 Returns a single line string suitable for inclusion in larger error messages.
881 This method would normally be used by DBIx::Class core-module author, to
882 indicate to the user that he needs to install specific modules before he will
883 be able to use a specific feature.
884  
885 For example if some of the requirements for C<deploy> are not available,
886 the returned string could look like:
887  
888 SQL::Translator >= $sqltver (see $class for details)
889  
890 The author is expected to prepend the necessary text to this message before
891 returning the actual error seen by the user.
892 EOD
893  
894 '=head2 die_unless_req_ok_for',
895 '=over',
896 '=item Arguments: $group_name',
897 '=back',
898 <<'EOD',
899 Checks if L</req_ok_for> passes for the supplied C<$group_name>, and
900 in case of failure throws an exception including the information
901 from L</req_missing_for>.
902 EOD
903  
904 '=head2 req_errorlist_for',
905 '=over',
906 '=item Arguments: $group_name',
907 '=item Return Value: \%list_of_loaderrors_per_module',
908 '=back',
909 <<'EOD',
910 Returns a hashref containing the actual errors that occurred while attempting
911 to load each module in the requirement group.
912 EOD
913 '=head1 FURTHER QUESTIONS?',
914 'Check the list of L<additional DBIC resources|DBIx::Class/GETTING HELP/SUPPORT>.',
915 '=head1 COPYRIGHT AND LICENSE',
916 <<'EOL',
917 This module is free software L<copyright|DBIx::Class/COPYRIGHT AND LICENSE>
918 by the L<DBIx::Class (DBIC) authors|DBIx::Class/AUTHORS>. You can
919 redistribute it and/or modify it under the same terms as the
920 L<DBIx::Class library|DBIx::Class/COPYRIGHT AND LICENSE>.
921 EOL
922  
923 );
924  
925 0 ▶ open (my $fh, '>', $podfn) or Carp::croak "Unable to write to $podfn: $!";
Branch: 1 branch
BranchTrueFalseTotal
open my $fh, ">", $podfn or Carp::croak("Unable to write to ${podfn}: $!") 0 0 0
926 0 print $fh join ("\n\n", @chunks);
927 0 print $fh "\n";
928 0 close ($fh);
929 }
930  
931 387 1;
« DBIx/Class/CDBICompat/AccessorMapping.pm ↑ Summary DBIx/Class/Storage/DBI/SQLite.pm »