tiny.sandbox.result

1const std = @import("std");2const change = @import("change.zig");3const command = @import("command.zig");4const layer_data = @import("layer.zig");5const audit_data = @import("audit.zig");67const Allocator = std.mem.Allocator;89/// Holds the resources and captured outputs of an execution, owning the10/// standard output and standard error buffers, the recorded change set, the11/// configuration `Audit`, and the layer directory.12///13/// Calling `deinit` frees the stream buffers and change set memory, then14/// deletes the temporary layer directory. Callers that want to keep files15/// generated in the layer must read or copy them out before calling `deinit`.16pub const Result = struct {17    allocator: Allocator,18    layer: layer_data.Layer,19    status: command.Status,20    stdout: []u8,21    stderr: []u8,22    changes: change.Set,23    audit: audit_data.Audit,2425    pub fn deinit(self: *Result) void {26        self.changes.deinit();27        self.allocator.free(self.stdout);28        self.allocator.free(self.stderr);29        self.layer.deinit();30        self.* = undefined;31    }3233    /// Reads an output file through the layer directory handle into a buffer34    /// allocated with `allocator`, transferring ownership of the slice to the35    /// caller, who must free it using the supplied allocator. Relative path36    /// resolution starts at the root of the layer directory but performs no37    /// path-containment checks, allowing lookups that navigate outside the38    /// layer. The `limit` argument sets the maximum number of bytes to read.39    pub fn readFileAlloc(self: *const Result, allocator: Allocator, path: []const u8, limit: usize) ![]u8 {40        return try self.layer.readFileAlloc(allocator, path, limit);41    }42};

1pub const result = @import("result.zig");