File Coverage

blib/lib/Net/WebSocket/HTTP.pm
Criterion Covered Total %
statement 22 22 100.0
branch 2 2 100.0
condition n/a
subroutine 5 5 100.0
pod 1 1 100.0
total 30 30 100.0


line stmt bran cond sub pod time code
1             package Net::WebSocket::HTTP;
2              
3 6     6   1596 use strict;
  6         12  
  6         291  
4 6     6   34 use warnings;
  6         11  
  6         168  
5              
6 6     6   2983 use Call::Context ();
  6         2482  
  6         123  
7              
8 6     6   2559 use Net::WebSocket::X ();
  6         18  
  6         1039  
9              
10             =encoding utf-8
11              
12             =head1 NAME
13              
14             Net::WebSocket::HTTP - HTTP utilities for Net::WebSocket
15              
16             =head1 SYNOPSIS
17              
18             @tokens = Net::WebSocket::HTTP::split_tokens($tokens_str);
19              
20             =head1 FUNCTIONS
21              
22             =head2 @tokens = split_tokens( TOKENS_STR )
23              
24             A parser for the C<1#token> format as defined in L. (C<1#> and C are defined independently of each other.)
25              
26             Returns a list of the HTTP tokens in TOKENS_STR. Throws an exception
27             if any of the tokens is invalid as per the RFC’s C definition.
28              
29             =cut
30              
31             #Would this be useful to publish separately? It seemed so at one point,
32             #but “#1token” doesn’t appear in the HTTP RFC.
33             sub split_tokens {
34 39     39 1 15499 my ($value) = @_;
35              
36 39         120 Call::Context::must_be_list();
37              
38 38         1693 $value =~ s<\A[ \t]+><>;
39 38         105 $value =~ s<[ \t]+\z><>;
40              
41 38         102 my @tokens;
42 38         218 for my $p ( split m<[ \t]*,[ \t]*>, $value ) {
43 42 100       139 if ($p =~ tr~()<>@,;:\\"/[]?={} \t~~) {
44 16         64 die Net::WebSocket::X->create('BadToken', $p);
45             }
46              
47 26         60 push @tokens, $p;
48             }
49              
50 22         80 return @tokens;
51             }
52              
53             1;