harn-stdlib 0.10.52

Embedded Harn standard library source catalog
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

import {
  ModelBackend,
  ModelJobError,
  ModelJobEvent,
  ModelJobObservation,
  ModelJobOutput,
  ModelJobReceipt,
  model_job_error,
  model_job_request_digest,
} from "std/model_job/contracts"

/**
 * Build a strict backend from a fixed sequence of observations.
 *
 * Use this in lifecycle and UI tests. It never reads the network.
 *
 * @effects: []
 * @errors: []
 */
pub fn model_job_fake_backend(id: string, observations: list<ModelJobObservation>) -> ModelBackend {
  let cursor = 0
  fn next() -> Result<ModelJobObservation, ModelJobError> {
    if cursor >= len(observations) {
      return Err(
        model_job_error("backend", "fake model backend exhausted its observations", {backend: id}),
      )
    }
    const observation = observations[cursor]
    if observation == nil {
      return Err(model_job_error("backend", "fake model backend observation is missing"))
    }
    cursor = cursor + 1
    return Ok(observation)
  }
  return {
    id: id,
    submit: fn(_harness, _request) { return next() },
    inspect: fn(_harness, _job) { return next() },
    cancel: fn(_harness, job) { return Ok(
      {job_id: job.id, state: "canceled", backend_state: "fake_canceled"},
    ) },
  }
}

/**
 * Build an offline backend from a completed receipt.
 *
 * Replay rejects a request whose digest differs from the recording. It reads
 * only the asset paths named in the receipt.
 *
 * @effects: []
 * @errors: []
 */
pub fn model_job_replay_backend(receipt: ModelJobReceipt) -> ModelBackend {
  let cursor = 0
  fn observation_for(event: ModelJobEvent) -> ModelJobObservation {
    let observation: ModelJobObservation = {job_id: receipt.job.id, state: event.state}
    if event.progress != nil {
      observation.progress = event.progress
    }
    if event.state == "succeeded" {
      let outputs: list<ModelJobOutput> = []
      for asset in receipt.assets {
        outputs = outputs
          + [
          {
            name: asset.id,
            mime_type: asset.mime_type,
            path: asset.path,
            width: asset.width,
            height: asset.height,
            duration_ms: asset.duration_ms,
            metadata: {replayed_from: receipt.job.id},
          },
        ]
      }
      observation.outputs = outputs
    }
    if event.error != nil {
      observation.error = event.error
    }
    return observation
  }
  fn next() -> Result<ModelJobObservation, ModelJobError> {
    while cursor < len(receipt.events) {
      const event = receipt.events[cursor]
      cursor = cursor + 1
      if event == nil {
        return Err(model_job_error("replay_mismatch", "recorded model job event is missing"))
      }
      if event.kind != "output" {
        return Ok(observation_for(event))
      }
    }
    return Err(
      model_job_error(
        "replay_mismatch",
        "model job replay exhausted its recorded events",
        {backend: "replay", job_id: receipt.job.id},
      ),
    )
  }
  return {
    id: "replay:" + receipt.backend,
    submit: fn(_harness, request) {
      const digest = model_job_request_digest(request)
      if digest != receipt.request_digest {
        return Err(
          model_job_error(
            "replay_mismatch",
            "model job replay request does not match recording",
            {backend: "replay", job_id: receipt.job.id, detail: digest},
          ),
        )
      }
      return next()
    },
    inspect: fn(_harness, _job) { return next() },
    cancel: fn(_harness, job) { return Ok(
      {job_id: job.id, state: "canceled", backend_state: "replay_canceled"},
    ) },
  }
}