jetstream 16.0.0

Jetstream is a RPC framework for Rust, based on the 9P protocol and QUIC.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

// JetStream WireFormat — Network Type Tests
// Copyright (c) 2024, Sevki <s@sevki.io>
// SPDX-License-Identifier: BSD-3-Clause

import XCTest
@testable import JetStreamWireFormat

final class NetworkTests: XCTestCase {

    // MARK: - IPv4

    // r[verify jetstream.wireformat.swift.ipv4]
    // r[verify jetstream.wireformat.ipv4]
    func testIPv4RoundTrip() throws {
        let addr = IPv4Address(192, 168, 1, 1)
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        var reader = BinaryReader(data: writer.data)
        let decoded = try IPv4Address.decode(reader: &reader)
        XCTAssertEqual(decoded, addr)
    }

    func testIPv4Encoding() throws {
        let addr = IPv4Address(10, 0, 0, 1)
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        XCTAssertEqual(writer.data, Data([10, 0, 0, 1]))
    }

    func testIPv4ByteSize() {
        XCTAssertEqual(IPv4Address(0, 0, 0, 0).byteSize(), 4)
    }

    // MARK: - IPv6

    // r[verify jetstream.wireformat.swift.ipv6]
    // r[verify jetstream.wireformat.ipv6]
    func testIPv6RoundTrip() throws {
        let addr = IPv6Address.loopback
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        var reader = BinaryReader(data: writer.data)
        let decoded = try IPv6Address.decode(reader: &reader)
        XCTAssertEqual(decoded, addr)
    }

    func testIPv6Encoding() throws {
        let addr = IPv6Address.loopback
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        var expected = Data(repeating: 0, count: 15)
        expected.append(1)
        XCTAssertEqual(writer.data, expected)
    }

    func testIPv6ByteSize() {
        XCTAssertEqual(IPv6Address.loopback.byteSize(), 16)
    }

    // MARK: - IpAddr

    // r[verify jetstream.wireformat.swift.ipaddr]
    // r[verify jetstream.wireformat.ipaddr]
    func testIpAddrV4RoundTrip() throws {
        let addr = IpAddr.v4(IPv4Address(127, 0, 0, 1))
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        var reader = BinaryReader(data: writer.data)
        let decoded = try IpAddr.decode(reader: &reader)
        XCTAssertEqual(decoded, addr)
    }

    func testIpAddrV6RoundTrip() throws {
        let addr = IpAddr.v6(IPv6Address.loopback)
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        var reader = BinaryReader(data: writer.data)
        let decoded = try IpAddr.decode(reader: &reader)
        XCTAssertEqual(decoded, addr)
    }

    func testIpAddrV4Encoding() throws {
        let addr = IpAddr.v4(IPv4Address(10, 0, 0, 1))
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        XCTAssertEqual(writer.data, Data([0x04, 10, 0, 0, 1]))
    }

    func testIpAddrV6Tag() throws {
        let addr = IpAddr.v6(IPv6Address.loopback)
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        XCTAssertEqual([UInt8](writer.data)[0], 0x06)
    }

    // r[verify jetstream.wireformat.swift.test-error]
    func testIpAddrInvalidTag() throws {
        var reader = BinaryReader(data: Data([0x05]))
        XCTAssertThrowsError(try IpAddr.decode(reader: &reader)) { error in
            XCTAssertEqual(error as? WireFormatError, WireFormatError.invalidIPAddressTag(5))
        }
    }

    func testIpAddrByteSize() {
        let v4 = IpAddr.v4(IPv4Address(0, 0, 0, 0))
        XCTAssertEqual(v4.byteSize(), 5) // 1 tag + 4

        let v6 = IpAddr.v6(IPv6Address.loopback)
        XCTAssertEqual(v6.byteSize(), 17) // 1 tag + 16
    }

    // MARK: - SocketAddr

    // r[verify jetstream.wireformat.swift.sockaddr]
    // r[verify jetstream.wireformat.sockaddr]
    // r[verify jetstream.wireformat.sockaddr-v4]
    // r[verify jetstream.wireformat.sockaddr-v6]
    func testSocketAddrV4RoundTrip() throws {
        let addr = SocketAddr.v4(ip: IPv4Address(192, 168, 0, 1), port: 8080)
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        var reader = BinaryReader(data: writer.data)
        let decoded = try SocketAddr.decode(reader: &reader)
        XCTAssertEqual(decoded, addr)
    }

    func testSocketAddrV6RoundTrip() throws {
        let addr = SocketAddr.v6(ip: IPv6Address.loopback, port: 443)
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        var reader = BinaryReader(data: writer.data)
        let decoded = try SocketAddr.decode(reader: &reader)
        XCTAssertEqual(decoded, addr)
    }

    func testSocketAddrV4Encoding() throws {
        let addr = SocketAddr.v4(ip: IPv4Address(127, 0, 0, 1), port: 80)
        var writer = BinaryWriter()
        try addr.encode(writer: &writer)
        // tag=4, ip=127.0.0.1, port=80 (0x50, 0x00 LE)
        XCTAssertEqual(writer.data, Data([0x04, 127, 0, 0, 1, 0x50, 0x00]))
    }

    func testSocketAddrByteSize() {
        let v4 = SocketAddr.v4(ip: IPv4Address(0, 0, 0, 0), port: 0)
        XCTAssertEqual(v4.byteSize(), 7) // 1 + 4 + 2

        let v6 = SocketAddr.v6(ip: IPv6Address.loopback, port: 0)
        XCTAssertEqual(v6.byteSize(), 19) // 1 + 16 + 2
    }

    func testSocketAddrInvalidTag() throws {
        var reader = BinaryReader(data: Data([0x05]))
        XCTAssertThrowsError(try SocketAddr.decode(reader: &reader)) { error in
            XCTAssertEqual(error as? WireFormatError, WireFormatError.invalidSocketAddrTag(5))
        }
    }
}