blib/lib/AnyEvent/MCP/Extension.pm

filter: Statementstmt 80.7% 21 / 26 Branchbran 41.6% 5 / 12 Conditioncond 25.9% 7 / 27 MC/DCmcdc 9.0% 1 / 11 Subroutinesub 80.0% 4 / 5 Podpod 100% 2 / 2 totaltotal 48.1% 40 / 83 CC 16 SCAR 33.0
CC
16
Cov
51%
parse_url
56.0
__ANON__
14.8
accept
1.0
CRAP 27.2
« blib/lib/AnyEvent/MCP/Config.pm ↑ Summary bin/mcp-vim »
1 =head1 NAME
2  
3 AnyEvent::MCP::Extension - authenticated non-HTTP connections on an MCP listener
4  
5 =head1 DESCRIPTION
6  
7 The HTTP listeners used by the bundled servers can also accept private
8 raw-TCP protocols on the same port. This helper authenticates the initial
9 JSON handshake and passes the already-buffered connection to its protocol
10 handler; it does B<not> implement HTTP or MCP dispatch.
11  
12 C<mcp-multibroker> uses this mechanism for reverse-connecting MCP servers.
13 Vim editor and browser connections can also share an MCP HTTP listener,
14 but they use WebSocket upgrades rather than this raw JSON hello protocol.
15 Ordinary MCP clients should use
16 L<AnyEvent::MCP::Client::HTTP> or
17 L<AnyEvent::MCP::Client::JSONL>, not this extension protocol.
18  
19 my ($host, $port, $token, $alias) =
20 AnyEvent::MCP::Extension::parse_url
21 "http://127.0.0.1:31740/TOKEN/files";
22  
23 The returned address is for a raw TCP extension connection, not an HTTP
24 request. See L<AnyEvent::MCP::Server::Connect> for the MCP user of it.
25  
26 =head1 FUNCTIONS
27  
28 =over
29  
30 =item AnyEvent::MCP::Extension::accept $handle, [$token...], $callback->($handle, $hello), $reject->($handle)
31  
32 Read one bounded newline-terminated JSON array beginning with a protocol name
33 and accepted token. Authenticate before calling the protocol-specific handler.
34 Invalid hellos close the connection. The callback takes ownership of the same
35 handle, including buffered bytes after the hello. Remaining array fields belong
36 to the selected protocol. An optional C<$reject> callback releases any
37 listener ownership on rejection; otherwise the handle is destroyed.
38  
39 =item ($host, $port, $token, $alias, $scheme) = AnyEvent::MCP::Extension::parse_url $url
40  
41 Parse C<http[s]://host[:port]/token/alias>, including bracketed IPv6 hosts.
42 An omitted port defaults to 80 for HTTP and 443 for HTTPS. The URL names a
43 raw extension endpoint sharing an HTTP listener; no HTTP request is sent.
44 Tokens use the ordinary
45 listener token syntax and aliases use ASCII letters, digits, underscores and hyphens.
46  
47 =back
48  
49 =cut
50  
51 package AnyEvent::MCP::Extension;
52  
53 6 ▶use common::sense;
Subroutine BEGIN: called CC=1 SCAR=0.0
54 6 ▶use JSON::XS ();
Subroutine BEGIN: called CC=1 SCAR=0.0
55  
56 0 ▶sub parse_url {
Subroutine parse_url: not called CC=7 SCAR=40.3
Pod documented
57 0 my ($url) = @_;
58  
59 0 my ($scheme, $host, $port, $token, $alias) =
60 $url =~ m{\A(https?)://(\[[^\]]+\]|[^/:?#]+)(?::([0-9]+))?/([A-Za-z0-9_.~-]+)/([A-Za-z0-9_-]+)\z};
61 0 ▶ defined $host && (!defined $port || $port > 0 && $port <= 65535)
Branch: 1 branch
BranchTrueFalseTotal
defined $host and !defined($port) || $port > 0 && $port <= 65535 or die "Expected extension URL http[s]://host[:port]/token/alias\n" 0 0 0
Condition0%0/9
defined $host and !defined($port) || $port > 0 && $port <= 65535
!ll&&!rl&&r
000
not defined $port or $port > 0 and $port <= 65535
l!l&&r!l&&!r
000
$port > 0 and $port <= 65535
!ll&&!rl&&r
000
MC/DC0%0/4
defined $host and !defined($port) || $port > 0 && $port <= 65535
defined $host not defined $port $port > 0 $port <= 65535
Truth table0%0/5
A and not(B) or C and D
A= defined $hostB= not defined $portC= $port > 0D= $port <= 65535
ABCDresult
0XXX0
100X0
10100
11XX1
10111
62 or die "Expected extension URL http[s]://host[:port]/token/alias\n";
63 0 $host =~ s/\A\[(.*)\]\z/$1/;
64  
65 0 ▶ ($host, defined $port ? 0 + $port : $scheme eq "https" ? 443 : 80, $token, $alias, $scheme)
Branch: 2 branches
BranchTrueFalseTotal
defined $port ? : 0 0 0
$scheme eq 'https' ? : 0 0 0
66 }
67  
68 3 ▶sub accept {
Subroutine accept: called CC=1 SCAR=0.3
Pod documented
69 3 my ($handle, $tokens, $done, $reject) = @_;
70  
71 3 my $rbuf_max = $handle->{rbuf_max};
72 3 $handle->rtimeout (15);
73 3 $handle->{rbuf_max} = 4096;
74 3 ▶ $handle->push_read (line => sub {
Subroutine __ANON__: called CC=10 SCAR=27.0
75 3 my (undef, $line) = @_;
76  
77 3 my $ok = eval {
78 3 my $hello = JSON::XS->new->utf8->max_depth (8)->decode ($line);
79 3 ▶ ref $hello eq "ARRAY" && @$hello >= 2
Branch: 1 branch
BranchTrueFalseTotal
ref $hello eq "ARRAY" and @$hello >= 2 and defined $hello->[0] and not ref $hello->[0] and defined $hello->[1] and not ref $hello->[1] and grep(($_ eq $hello->[1]), @$tokens) or die "Invalid extension hello\n" 2 1 3
Condition38%7/18
ref $hello eq "ARRAY" and @$hello >= 2 and defined $hello->[0] and not ref $hello->[0] and defined $hello->[1] and not ref $hello->[1] and grep(($_ eq $hello->[1]), @$tokens)
!ll&&!rl&&r
012
ref $hello eq "ARRAY" and @$hello >= 2 and defined $hello->[0] and not ref $hello->[0] and defined $hello->[1] and not ref $hello->[1]
!ll&&!rl&&r
003
ref $hello eq "ARRAY" and @$hello >= 2 and defined $hello->[0] and not ref $hello->[0] and defined $hello->[1]
!ll&&!rl&&r
003
ref $hello eq "ARRAY" and @$hello >= 2 and defined $hello->[0] and not ref $hello->[0]
!ll&&!rl&&r
003
ref $hello eq "ARRAY" and @$hello >= 2 and defined $hello->[0]
!ll&&!rl&&r
003
ref $hello eq "ARRAY" and @$hello >= 2
!ll&&!rl&&r
003
MC/DC14%1/7
ref $hello eq "ARRAY" and @$hello >= 2 and defined $hello->[0] and not ref $hello->[0] and defined $hello->[1] and not ref $hello->[1] and grep(($_ eq $hello->[1]), @$tokens)
ref $hello eq "ARRAY" @$hello >= 2 defined $hello->[0] not ref $hello->[0] defined $hello->[1] not ref $hello->[1] grep(($_ eq $hello->[1]), @$tokens)
Truth table25%2/8
A and B and C and not(D) and E and not(F) and G
A= ref $hello eq "ARRAY"B= @$hello >= 2C= defined $hello->[0]D= not ref $hello->[0]E= defined $hello->[1]F= not ref $hello->[1]G= grep(($_ eq $hello->[1]), @$tokens)
ABCDEFGresult
0XXXXXX0
10XXXXX0
110XXXX0
1110XXX0
11110XX0
111110X0
11111100
11111111
80 && defined $hello->[0] && !ref $hello->[0]
81 && defined $hello->[1] && !ref $hello->[1]
82 && (grep $_ eq $hello->[1], @$tokens)
83 or die "Invalid extension hello\n";
84  
85 2 $handle->rtimeout (0);
86 2 $handle->{rbuf_max} = $rbuf_max;
87 2 $done->($handle, $hello);
88 2 1
89 };
90 3 ▶ ($reject ? $reject->($handle) : $handle->destroy) unless $ok;
Branch: 2 branches
BranchTrueFalseTotal
unless $ok 1 2 3
$reject ? : 0 1 1
91 3 });
92 }
93  
94 6 1;
« blib/lib/AnyEvent/MCP/Config.pm ↑ Summary bin/mcp-vim »