tiny.sandbox.Result

1/// Holds the resources and captured outputs of an execution, owning the2/// standard output and standard error buffers, the recorded change set, the3/// configuration `Audit`, and the layer directory.4///5/// Calling `deinit` frees the stream buffers and change set memory, then6/// deletes the temporary layer directory. Callers that want to keep files7/// generated in the layer must read or copy them out before calling `deinit`.8pub const Result = struct {9    allocator: Allocator,10    layer: layer_data.Layer,11    status: command.Status,12    stdout: []u8,13    stderr: []u8,14    changes: change.Set,15    audit: audit_data.Audit,1617    pub fn deinit(self: *Result) void {18        self.changes.deinit();19        self.allocator.free(self.stdout);20        self.allocator.free(self.stderr);21        self.layer.deinit();22        self.* = undefined;23    }2425    /// Reads an output file through the layer directory handle into a buffer26    /// allocated with `allocator`, transferring ownership of the slice to the27    /// caller, who must free it using the supplied allocator. Relative path28    /// resolution starts at the root of the layer directory but performs no29    /// path-containment checks, allowing lookups that navigate outside the30    /// layer. The `limit` argument sets the maximum number of bytes to read.31    pub fn readFileAlloc(self: *const Result, allocator: Allocator, path: []const u8, limit: usize) ![]u8 {32        return try self.layer.readFileAlloc(allocator, path, limit);33    }34};

1pub const Result = result.Result;