TT/Packed.pm

filter: Statementstmt 16.7% 22 / 131 Branchbran 0.0% 0 / 42 Conditioncond 0.0% 0 / 23 MC/DCmcdc 0.0% 0 / 15 Subroutinesub 36.3% 8 / 22 Podpod 0.0% 0 / 14 totaltotal 12.1% 30 / 247 CC 32 SCAR 41.4
CC
32
Cov
11%
new
156.0
packIO
72.0
unpackIO
72.0
CRAP 62.5
« TT/Dict.pm ↑ Summary TT/Dict/JSON.pm »
1 ## -*- Mode: CPerl -*-
2 ## File: Lingua::TT::Packed.pm
3 ## Author: Bryan Jurish <TT/IO.pm>
4 ## Descript: TT I/O: packed docs
5  
6 package Lingua::TT::Packed;
7 1 ▶use Lingua::TT::Document;
Subroutine BEGIN: called CC=1 SCAR=0.0
8 1 ▶use Lingua::TT::Persistent;
Subroutine BEGIN: called CC=1 SCAR=0.0
9 1 ▶use Lingua::TT::Enum;
Subroutine BEGIN: called CC=1 SCAR=0.0
10 1 ▶use Lingua::TT::IO;
Subroutine BEGIN: called CC=1 SCAR=0.0
11 1 ▶use Encode qw(encode decode);
Subroutine BEGIN: called CC=1 SCAR=0.0
12 1 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
13  
14 ##==============================================================================
15 ## Globals & Constants
16  
17 #our @ISA = qw(Lingua::TT::Document);
18 1 our @ISA = qw(Lingua::TT::Persistent);
19  
20 ##==============================================================================
21 ## Constructors etc.
22  
23 ## $pk = CLASS_OR_OBJECT->new(%opts)
24 ## + %$pk, %opts:
25 ## data => $packed_data, ##-- pack("$PACKFMT*",@ids)
26 ## enum => $enum, ##-- for mapping text <-> id
27 ## packfmt => $packfmt, ##-- packing format (default='N')
28 ## fast => $bool, ##-- encode/decode in memory-intensive "fast" mode, without error checks
29 ## badid => $id, ##-- optional id to use for missing symbols (default=undef ~ 0)
30 ## badsym => $sym, ##-- optional symbol to use for missing ids (default=undef ~ '')
31 ## delim => $delimter, ##-- record delimiter; default='' (none)
32 0 ▶sub new {
Subroutine new: not called CC=12 SCAR=50.5
Pod undocumented
33 0 my ($that,%opts) = @_;
34 0 ▶ if ($opts{packfmt} && $opts{packfmt} eq 'z') {
Branch: 5 branches
BranchTrueFalseTotal
if ($opts{'packfmt'} and $opts{'packfmt'} eq 'z') { } 0 0 0
elsif ($opts{'packfmt'} and $opts{'packfmt'} eq 'zt') { } 0 0 0
elsif ($opts{'packfmt'} and $opts{'packfmt'} eq 'a') { } 0 0 0
elsif ($opts{'packfmt'} and $opts{'packfmt'} eq 'at') { } 0 0 0
elsif ($opts{'packfmt'} and $opts{'packfmt'} eq 'x') { } 0 0 0
Condition0%0/3
$opts{"packfmt"} and $opts{"packfmt"} eq "z"
!ll&&!rl&&r
000
MC/DC0%0/2
$opts{"packfmt"} and $opts{"packfmt"} eq "z"
$opts{"packfmt"} $opts{"packfmt"} eq "z"
Truth table0%0/3
A and B
A= $opts{"packfmt"}B= $opts{"packfmt"} eq "z"
ABresult
0X0
100
111
35 0 require Lingua::TT::Packed::z;
36 0 return Lingua::TT::Packed::z->new(%opts);
37 }
38 ▶ elsif ($opts{packfmt} && $opts{packfmt} eq 'zt') {
Condition0%0/3
$opts{"packfmt"} and $opts{"packfmt"} eq "zt"
!ll&&!rl&&r
000
MC/DC0%0/2
$opts{"packfmt"} and $opts{"packfmt"} eq "zt"
$opts{"packfmt"} $opts{"packfmt"} eq "zt"
Truth table0%0/3
A and B
A= $opts{"packfmt"}B= $opts{"packfmt"} eq "zt"
ABresult
0X0
100
111
39 0 require Lingua::TT::Packed::zt;
40 0 return Lingua::TT::Packed::zt->new(%opts);
41 }
42 ▶ elsif ($opts{packfmt} && $opts{packfmt} eq 'a') {
Condition0%0/3
$opts{"packfmt"} and $opts{"packfmt"} eq "a"
!ll&&!rl&&r
000
MC/DC0%0/2
$opts{"packfmt"} and $opts{"packfmt"} eq "a"
$opts{"packfmt"} $opts{"packfmt"} eq "a"
Truth table0%0/3
A and B
A= $opts{"packfmt"}B= $opts{"packfmt"} eq "a"
ABresult
0X0
100
111
43 0 require Lingua::TT::Packed::a;
44 0 return Lingua::TT::Packed::a->new(%opts);
45 }
46 ▶ elsif ($opts{packfmt} && $opts{packfmt} eq 'at') {
Condition0%0/3
$opts{"packfmt"} and $opts{"packfmt"} eq "at"
!ll&&!rl&&r
000
MC/DC0%0/2
$opts{"packfmt"} and $opts{"packfmt"} eq "at"
$opts{"packfmt"} $opts{"packfmt"} eq "at"
Truth table0%0/3
A and B
A= $opts{"packfmt"}B= $opts{"packfmt"} eq "at"
ABresult
0X0
100
111
47 0 require Lingua::TT::Packed::at;
48 0 return Lingua::TT::Packed::at->new(%opts);
49 }
50 ▶ elsif ($opts{packfmt} && $opts{packfmt} eq 'x') {
Condition0%0/3
$opts{"packfmt"} and $opts{"packfmt"} eq "x"
!ll&&!rl&&r
000
MC/DC0%0/2
$opts{"packfmt"} and $opts{"packfmt"} eq "x"
$opts{"packfmt"} $opts{"packfmt"} eq "x"
Truth table0%0/3
A and B
A= $opts{"packfmt"}B= $opts{"packfmt"} eq "x"
ABresult
0X0
100
111
51 0 require Lingua::TT::Packed::x;
52 0 return Lingua::TT::Packed::x->new(%opts);
53 }
54 0 ▶ return bless({
Condition0%0/3
ref $that || $that
l!l&&r!l&&!r
000
MC/DC0%0/2
ref $that || $that
ref $that $that
Truth table0%0/3
A || B
A= ref $thatB= $that
ABresult
1X1
011
000
55 data => '',
56 enum => Lingua::TT::Enum->new,
57 packfmt => 'N',
58 fast => 0,
59 badid => undef,
60 badsym => undef,
61 delim => '',
62 %opts,
63 }, ref($that)||$that);
64 }
65  
66 ## $pk = $pk->clear()
67 ## + clears data and enum
68 0 ▶sub clear {
Subroutine clear: not called CC=1 SCAR=6.9
Pod undocumented
69 0 my $pk = shift;
70 0 $pk->{enum}->clear;
71 0 $pk->{data} = '';
72 0 return $pk;
73 }
74  
75 ## $pk = $pk->clearData()
76 0 ▶sub clearData {
Subroutine clearData: not called CC=1 SCAR=6.9
Pod undocumented
77 0 $_[0]{data} = '';
78 0 return $_[0];
79 }
80  
81 ##==============================================================================
82 ## Methods: Access
83  
84 ## \@ids = $pk->ids()
85 ## \@ids = $pk->ids(\@ids)
86 ## + gets/sets packed data ids
87 0 ▶sub ids {
Subroutine ids: not called CC=6 SCAR=37.4
Pod undocumented
88 0 my ($pk,$ids) = @_;
89 0 ▶ my $delim = $pk->{delim} || '';
Condition0%0/2
$pk->{'delim'} || ''
l!l
00
MC/DC0%0/1
$pk->{'delim'} || ''
$pk->{'delim'}
Truth table0%0/2
A
A= $pk->{'delim'}
Aresult
11
00
90 0 ▶ if ($ids) {
Branch: 1 branch
BranchTrueFalseTotal
if ($ids) { } 0 0 0
91 0 ▶ if ($delim) {
Branch: 1 branch
BranchTrueFalseTotal
if ($delim) { } 0 0 0
92 ##-- set, +delim
93 0 $pk->{data} = '';
94 0 $pk->{data} .= pack($pk->{packfmt},$_).$delim foreach (@$ids);
95 } else {
96 ##-- set, -delim
97 0 $pk->{data} = pack("$pk->{packfmt}*",@$ids);
98 }
99 }
100 else {
101 0 ▶ if ($delim) {
Branch: 1 branch
BranchTrueFalseTotal
if ($delim) { } 0 0 0
102 ##-- get, +delim
103 0 my $packfmt = $pk->{packfmt};
104 0 my $delim_re = qr/\Q$pk->{delim}\E/;
105 0 $ids = [map {unpack($packfmt,$_)} split($delim_re,$pk->{data})];
106 } else {
107 ##-- get, -delim
108 0 $ids = [unpack("$pk->{packfmt}*",$pk->{data})];
109 }
110 }
111 0 return $ids;
112 }
113  
114  
115 ##==============================================================================
116 ## Methods: I/O
117  
118 ##--------------------------------------------------------------
119 ## Methods: I/O: Native (bin)
120  
121 ## $pk = $CLASS_OR_OBJECT->saveNativeFh($fh,%opts)
122 ## + saves $pk to filehandle
123 ## + does NOT save enum
124 1 ▶BEGIN { *toFh = \&saveNativeFh; }
Subroutine BEGIN: called CC=1 SCAR=0.0
125 0 ▶sub saveNativeFh {
Subroutine saveNativeFh: not called CC=1 SCAR=6.9
Pod undocumented
126 0 my ($pk,$fh,%opts) = @_;
127 0 CORE::binmode($fh,':bytes:raw');
128 0 $fh->print($pk->{data});
129 0 return $pk;
130 }
131  
132 ## $pk = $CLASS_OR_OBJECT->loadNativeFh($fh,%opts)
133 ## + saves $pk to filehandle
134 ## + does NOT save enum
135 1 ▶BEGIN { *fromFh = \&loadNativeFh; }
Subroutine BEGIN: called CC=1 SCAR=0.0
136 0 ▶sub loadNativeFh {
Subroutine loadNativeFh: not called CC=2 SCAR=17.9
Pod undocumented
137 0 my ($pk,$fh,%opts) = @_;
138 0 ▶ $pk = $pk->new if (!ref($pk));
Branch: 1 branch
BranchTrueFalseTotal
unless ref $pk 0 0 0
139 0 CORE::binmode($fh,':bytes:raw');
140 0 local $/=undef;
141 0 $pk->{data} .= <$fh>;
142 0 return $pk;
143 }
144  
145 ##--------------------------------------------------------------
146 ## Methods: I/O: TT: pack (i.e. load)
147  
148 ## $pk = $tt->packFile($ttfile,%opts)
149 ## + append data from $ttfile
150 0 ▶sub packFile {
Subroutine packFile: not called CC=1 SCAR=6.9
Pod undocumented
151 0 my ($pk,$file,%opts) = @_;
152 0 return $pk->packIO(Lingua::TT::IO->fromFile($file,%opts),%opts);
153 }
154  
155 ## $pk = $tt->packFh($ttfh,%opts)
156 ## + append data from $ttfh
157 0 ▶sub packFh {
Subroutine packFh: not called CC=1 SCAR=6.9
Pod undocumented
158 0 my ($pk,$fh,%opts) = @_;
159 0 return $pk->packIO(Lingua::TT::IO->fromFh($fh,%opts),%opts);
160 }
161  
162 ## $pk = $tt->packString(\$ttstr,%opts)
163 ## + append data from $ttstr
164 0 ▶sub packString {
Subroutine packString: not called CC=1 SCAR=6.9
Pod undocumented
165 0 my ($pk,$strref,%opts) = @_;
166 0 return $pk->packIO(Lingua::TT::IO->fromString($strref,%opts),%opts);
167 }
168  
169 ## $pk = $tt->packIO($ttio,%opts)
170 ## + append data from $ttio
171 ## + %opts overrides %$pk
172 0 ▶sub packIO {
Subroutine packIO: not called CC=8 SCAR=42.8
Pod undocumented
173 0 my ($pk,$ttio,%opts) = @_;
174 0 @$pk{keys %opts} = values(%opts);
175 0 my $infh = $ttio->{fh};
176 0 my $enum = $pk->{enum};
177 0 my $sym2id = $pk->{enum}{sym2id};
178 0 my $datar = \$pk->{data};
179 0 my $packfmt = $pk->{packfmt};
180 0 my $badid = $pk->{badid};
181 0 my $delim = $pk->{delim};
182 0 ▶ $delim = '' if (!defined($delim));
Branch: 1 branch
BranchTrueFalseTotal
unless defined $delim 0 0 0
183  
184 0 ▶ if ($pk->{fast}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($pk->{'fast'}) { } 0 0 0
185 ##-- "fast" mode
186 0 ▶ if ($delim eq '') {
Branch: 1 branch
BranchTrueFalseTotal
if ($delim eq '') { } 0 0 0
187 0 $$datar .= pack("${packfmt}*", @$sym2id{map {chomp; $_} <$infh>});
188 } else {
189 0 $$datar .= pack("${packfmt}",$_).$delim foreach (@$sym2id{map {chomp; $_} <$infh>});
190 }
191 } else {
192 ##-- "paranoid" mode
193 0 my ($id,$badid);
194 0 ▶ while (defined($_=<$infh>)) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined($_ = readline $infh)) 0 0 0
195 0 chomp;
196 #next if ((/^\s*%%/ && !$want_cmts) || ($_ eq '' && !$want_eos));
197 0 ▶ if (!defined($id = $sym2id->{$_})) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined($id = $sym2id->{$_})) 0 0 0
198 0 ▶ if (defined($badid)) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $badid) { } 0 0 0
199 ##-- clobber
200 0 warn(ref($pk)."::packIO(): WARNING: no id for input '$_'; using -badid=$badid");
201 0 $id=$badid;
202 } else {
203 0 $id = $enum->getId($_);
204 }
205 }
206 0 $$datar .= pack($packfmt,$id).$delim;
207 }
208 }
209 0 return $pk;
210 }
211  
212 ##--------------------------------------------------------------
213 ## Methods: I/O: TT: unpack (i.e. save)
214  
215 ## $pk = $tt->unpackFile($ttfile,%opts)
216 ## + unpack data to $ttfile
217 0 ▶sub unpackFile {
Subroutine unpackFile: not called CC=1 SCAR=6.9
Pod undocumented
218 0 my ($pk,$file,%opts) = @_;
219 0 return $pk->unpackIO(Lingua::TT::IO->toFile($file,%opts),%opts);
220 }
221  
222 ## $pk = $tt->unpackFh($ttfh,%opts)
223 ## + unpack data to $ttfh
224 0 ▶sub unpackFh {
Subroutine unpackFh: not called CC=1 SCAR=6.9
Pod undocumented
225 0 my ($pk,$fh,%opts) = @_;
226 0 return $pk->unpackIO(Lingua::TT::IO->toFh($fh,%opts),%opts);
227 }
228  
229 ## $pk = $tt->unpackString(\$ttstr,%opts)
230 ## + unpack data to $ttstr
231 0 ▶sub unpackString {
Subroutine unpackString: not called CC=1 SCAR=6.9
Pod undocumented
232 0 my ($pk,$strref,%opts) = @_;
233 0 return $pk->unpackIO(Lingua::TT::IO->toString($strref,%opts),%opts);
234 }
235  
236 ## $pk = $tt->unpackIO($ttio,%opts)
237 ## + unpack data to $ttio
238 ## + %opts overrides %$pk
239 0 ▶sub unpackIO {
Subroutine unpackIO: not called CC=8 SCAR=42.8
Pod undocumented
240 0 my ($pk,$ttio,%opts) = @_;
241 0 @$pk{keys %opts} = values(%opts);
242 0 my $outfh = $ttio->{fh};
243 0 my $enum = $pk->{enum};
244 0 my $id2sym = $pk->{enum}{id2sym};
245 0 my $datar = \$pk->{data};
246 0 my $badsym = $pk->{badsym};
247 0 my $packfmt = $pk->{packfmt};
248 0 ▶ my $delim_re = defined($pk->{delim}) && $pk->{delim} ne '' ? qr/\Q$pk->{delim}\E/ : undef;
Branch: 1 branch
BranchTrueFalseTotal
defined $pk->{'delim'} && $pk->{'delim'} ne '' ? : 0 0 0
Condition0%0/3
defined $pk->{"delim"} and $pk->{"delim"} ne ""
!ll&&!rl&&r
000
MC/DC0%0/2
defined $pk->{"delim"} and $pk->{"delim"} ne ""
defined $pk->{"delim"} $pk->{"delim"} ne ""
Truth table0%0/3
A and B
A= defined $pk->{"delim"}B= $pk->{"delim"} ne ""
ABresult
0X0
100
111
249  
250 0 ▶ if ($pk->{fast}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($pk->{'fast'}) { } 0 0 0
251 ##-- unpack: fast mode
252 0 ▶ if ($delim_re) {
Branch: 1 branch
BranchTrueFalseTotal
if ($delim_re) { } 0 0 0
253 ##-- +fast,+delim
254 0 $outfh->print(map {$_."\n"} @$id2sym[map {unpack($packfmt,$_)} split($delim_re,$$datar)]);
255 } else {
256 ##-- +fast,-delim
257 0 $outfh->print(map {$_."\n"} @$id2sym[unpack("${packfmt}*",$$datar)]);
258 }
259 }
260 else {
261 ##-- unpack: "paranoid" mode
262 0 my ($sym);
263 $outfh->print(
264 map {
265 0 ▶ if (!defined($sym=$id2sym->[$_])) {
Branch: 1 branch
BranchTrueFalseTotal
unless (defined($sym = $id2sym->[$_])) 0 0 0
266 0 ▶ if (defined($badsym)) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined $badsym) { } 0 0 0
267 ##-- clobber
268 0 warn(ref($pk)."::unpackIO(): WARNING: no symbol for id '$_'; using -badsym='$badsym'");
269 0 $sym = $badsym;
270 } else {
271 0 $sym = $enum->getSymbol($_);
272 }
273 }
274 0 ▶ $sym."\n"
Branch: 1 branch
BranchTrueFalseTotal
$delim_re ? : 0 0 0
275 } ($delim_re
276 0 ? map {unpack($packfmt,$_)} split($delim_re,$$datar) ##-- -fast,+delim
277 : unpack("$packfmt*", $$datar) ##-- -fast,-delim
278 )
279 );
280 }
281  
282 0 return $pk;
283 }
284  
285  
286 ##==============================================================================
287 ## Footer
288 1 1;
289  
290 __END__
« TT/Dict.pm ↑ Summary TT/Dict/JSON.pm »