blib/lib/Protocol/HAP/TLV.pm

filter: Statementstmt 100% 27 / 27 Branchbran 83.3% 10 / 12 Conditioncond 75.0% 3 / 4 MC/DCmcdc 50.0% 1 / 2 Subroutinesub 100% 3 / 3 Podpod 100% 2 / 2 totaltotal 92.0% 46 / 50 CC 9 SCAR 15.4
CC
9
Cov
93%
decode
5.0
encode
5.0
BEGIN
1.0
CRAP 4.7
« blib/lib/Protocol/HAP/Store/File.pm ↑ Summary blib/lib/Protocol/HAP/SRP.pm »
1 2 ▶use v5.36;
Subroutine BEGIN: called CC=1 SCAR=0.0
2  
3 package Protocol::HAP::TLV;
4 2 our $VERSION = '0.1.0';
5  
6 # TLV8 encoding and decoding for the HomeKit Accessory Protocol
7 # The format is Type-Length-Value with 8-bit type and length
8 # fields. The codec splits values of more than 255 bytes into
9 # multiple chunks with the same type. The pairing type values,
10 # including the 0xFF separator, live in Protocol::HAP::Pairing.
11  
12 # encode(@items) - Encode type-value pairs in order
13 # The function takes a list of type, value pairs. It keeps the
14 # insertion order.
15 # Example: encode(0x06, $state, 0x03, $pubkey)
16 6 ▶sub encode (@items)
Subroutine encode: called CC=5 SCAR=16.1
Pod documented
17 {
18 6 my $out = '';
19  
20 6 ▶ while ( @items >= 2 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (@items >= 2) 16 6 22
21 16 my $type = shift @items;
22 16 my $value = shift @items;
23  
24 # Use the empty string for an undefined value
25 16 ▶ $value //= '';
Condition50%1/2
$value //= ""
l!l
160
MC/DC0%0/1
$value //= ""
$value
Truth table50%1/2
A
A= $value
Aresult
11
00
26  
27 # Encode empty values, for example the separator 0xFF
28 16 ▶ if ( length($value) == 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $value == 0) 3 13 16
29 3 $out .= pack( 'CC', $type, 0 );
30 3 next;
31 }
32  
33 # Split values of more than 255 bytes into chunks
34 13 ▶ while ( length($value) > 0 ) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $value > 0) 14 13 27
35 14 my $chunk = substr( $value, 0, 255, '' );
36 14 $out .= pack( 'CC', $type, length($chunk) ) . $chunk;
37 }
38 }
39  
40 6 return $out;
41 }
42  
43 # decode($data) - Decode a TLV8 buffer into a type => value hash
44 # The function concatenates consecutive records with the same
45 # type (fragmentation). It returns the empty list if the buffer
46 # is malformed. A malformed buffer has a truncated record header
47 # or a length field that points past the end of the buffer.
48 2 ▶sub decode ($data)
Subroutine decode: called CC=5 SCAR=16.2
Pod documented
49 {
50 2 my %items;
51 2 my $pos = 0;
52  
53 2 ▶ while ( $pos < length($data) ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($pos < length $data) 4 2 6
54  
55 # Reject a truncated record header
56 4 ▶ return if $pos + 2 > length($data);
Branch: 1 branch
BranchTrueFalseTotal
if $pos + 2 > length $data 0 4 4
57 4 my ( $type, $len ) = unpack( 'CC', substr( $data, $pos, 2 ) );
58 4 $pos += 2;
59  
60 # Reject a length that runs past the end of the buffer
61 4 ▶ return if $pos + $len > length($data);
Branch: 1 branch
BranchTrueFalseTotal
if $pos + $len > length $data 0 4 4
62 4 my $value = substr( $data, $pos, $len );
63 4 $pos += $len;
64  
65 # Concatenate chunks with the same type
66 4 ▶ $items{$type} = ( $items{$type} // '' ) . $value;
Condition100%2/2
$items{$type} // ""
l!l
13
MC/DC100%1/1
$items{$type} // ""
$items{$type}
Truth table100%2/2
A
A= $items{$type}
Aresult
11
00
67 }
68  
69 2 return %items;
70 }
71  
72 2 1;
« blib/lib/Protocol/HAP/Store/File.pm ↑ Summary blib/lib/Protocol/HAP/SRP.pm »