File Coverage

blib/lib/qbit/Packages.pm

Criterion	Covered	Total	%
statement	27	49	55.1
branch	0	4	0.0
condition	0	5	0.0
subroutine	9	13	69.2
pod			n/a
total	36	71	50.7

line	stmt	bran	cond	sub	time	code
1
2						=head1 Name
3
4						qbit::Packages - Functions to manipulate data in packages.
5
6						=cut
7
8						package qbit::Packages;
9						$qbit::Packages::VERSION = '2.3';
10	8			8	44	use strict;
	8				15
	8				287
11	8			8	38	use warnings;
	8				14
	8				290
12	8			8	49	use utf8;
	8				13
	8				54
13
14	8			8	221	use base qw(Exporter);
	8				18
	8				804
15
16	8			8	43	use Data::Dumper;
	8				25
	8				1102
17						require qbit::StringUtils;
18
19						BEGIN {
20	8			8	18	our (@EXPORT, @EXPORT_OK);
21
22	8				24	@EXPORT = qw(
23						package_sym_table
24						package_stash
25						package_merge_isa_data
26						require_class
27						);
28	8				413	@EXPORT_OK = @EXPORT;
29						}
30
31						=head1 Functions
32
33						=head2 package_sym_table
34
35						B
36
37						=over
38
39						=item
40
41						B<$package> - string, package name.
42
43						=back
44
45						B hash ref, all package's symbols.
46
47						=cut
48
49						sub package_sym_table($) {
50	0			0		my ($package) = @_;
51
52	8			8	43	no strict 'refs';
	8				14
	8				828
53	0					return \%{$package . '::'};
	0
54						}
55
56						=head2 package_stash
57
58						B
59
60						=over
61
62						=item
63
64						B<$package> - string, package name.
65
66						=back
67
68						B hash ref, package stash.
69
70						=cut
71
72						sub package_stash($) {
73	0			0		my ($package) = @_;
74
75	8			8	46	no strict 'refs';
	8				9
	8				902
76	0	0				{$package . '::QBitStash'} = {} unless {$package . '::QBitStash'};
	0
	0
77	0					return \%{$package . '::QBitStash'};
	0
78						}
79
80						=head2 package_merge_isa_data
81
82						B
83
84						=over
85
86						=item
87
88						B<$package> - string, package name;
89
90						=item
91
92						B<$res> - scalar, result's stash;
93
94						=item
95
96						B<$func> - code, function to merge. Arguments:
97
98						=over
99
100						=item
101
102						B<$package> - string, package name;
103
104						=item
105
106						B<$res> - scalar, result's stash;
107
108						=back
109
110						=item
111
112						B<$baseclass> - string, upper level package name.
113
114						=back
115
116						Recursive merge data into $res from all levels packages hierarchy.
117
118						=cut
119
120						sub package_merge_isa_data {
121	0			0		my ($package, $res, $func, $baseclass) = @_;
122
123	0					my $isa;
124						{
125	8			8	43	no strict 'refs';
	8				12
	8				1779
	0
126	0					$isa = \@{$package . '::ISA'};
	0
127						}
128	0					foreach my $pkg (@$isa) {
129	0	0	0			next if defined($baseclass) && !$pkg->isa($baseclass);
130	0					package_merge_isa_data($pkg, $res, $func, $baseclass);
131						}
132
133	0					$func->($package, $res);
134						}
135
136						=head2 require_class
137
138						B
139
140						=over
141
142						=item
143
144						B<$class> - string, class name.
145
146						=back
147
148						Convert class name to .pm file path and require it.
149
150						B return value of CORE::require if all is Ok or throw Exception if cannot load .pm file.
151
152						=cut
153
154						sub require_class {
155	0			0		my ($class) = @_;
156
157	0					$class = "$class.pm";
158	0					$class =~ s/::/\//g;
159
160	0		0			return require($class) \|\| die die "Cannot requre file \"$class\": " . qbit::StringUtils::fix_utf($!);
161						}
162
163						1;