containerization-framework 0.8.0

Rust bindings for Apple's Containerization framework: Linux containers in lightweight VMs, in-process and without a daemon.
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

//===----------------------------------------------------------------------===//
// What the bridge itself fails with. Containerization's own errors pass through
// unchanged; `bridged` hands either to Rust as a message.
//===----------------------------------------------------------------------===//

enum BridgeError: Error, CustomStringConvertible {
  /// Cannot happen: the semaphore is only signalled after `outcome` is set.
  case noOutcome
  /// A value the bridge could not parse: a malformed wire string, or a
  /// setting that never made sense.
  case malformed(String, String)
  /// A Rust `usize` too large for Swift's `Int`.
  case tooLarge(String, UInt)
  /// A Rust closure returned an error, which Rust keeps.
  case bodyFailed
  /// `ArchiveEntryReader.read(_:maxLength:)` returned `-1`.
  case readFailed
  /// A write to stdout or stderr after its process was deleted.
  case closed

  var description: String {
    switch self {
    case .noOutcome:
      return "the bridged task signalled completion without an outcome"
    case .bodyFailed:
      return "the Rust closure failed"
    case .readFailed:
      return "the archive entry's data could not be read"
    case .closed:
      return "the output was closed when its process was deleted"
    case .malformed(let what, let value):
      return "malformed \(what): \(value.debugDescription)"
    case .tooLarge(let what, let value):
      return "the \(what), \(value), is larger than Swift's Int can hold"
    }
  }
}