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
|
/*
This source file is part of the Swift.org open source project
Copyright (c) 2021 Apple Inc. and the Swift project authors
Licensed under Apache License v2.0 with Runtime Library Exception
See https://swift.org/LICENSE.txt for license information
See https://swift.org/CONTRIBUTORS.txt for Swift project authors
*/
import Foundation
/// A bridge that provides bi-directional communication with a documentation renderer.
///
/// Use a communication bridge to send and receive messages between an IDE and an embedded documentation renderer.
public protocol CommunicationBridge {
/// Handler for sending messages.
associatedtype SendHandler
/// A closure that the communication bridge calls when it receives a message.
var onReceiveMessage: ((Message) -> ())? { get set }
/// Sends a message to the documentation renderer using the given handler.
/// - Parameter message: The message to send to the renderer.
/// - Parameter handler: A closure that performs the sending operation.
/// - Throws: Throws a `CommunicationBridgeError.unableToEncodeMessage` if the given message could not be encoded.
func send(_ message: Message, using handler: SendHandler) throws
}
/// An error that occurs when using a communication bridge.
public enum CommunicationBridgeError: Error {
/// An indication that a message could not be encoded when using a communication bridge.
case unableToEncodeMessage(_ message: Message, underlyingError: Error)
}
|
