tiny.python.execute

1/// Tokenizes, parses, compiles and runs the source text, then returns the program's value together2/// with the heap that owns the value's objects. The README's example and nearly every test of the3/// package call it with a short program. The call borrows the source text. Before it returns, the4/// call frees the tokens, the syntax tree, the chunk and the machine's own state, so the result's5/// heap is the only memory it hands back. The returned value borrows the result's heap and stays6/// valid only until `Result.deinit`. The returned value can also point into the source text,7/// through string literals and their slices, so the text has to stay alive while the value is used.8/// `Result.deinit` frees the heap with the allocator passed to this call. The call returns the9/// errors of `tokenize`, `parse`, `compile` and `Vm.run`, and `error.OutOfMemory`, as one inferred10/// error set. On any error the call frees everything it allocated, the heap included.11pub fn execute(allocator: std.mem.Allocator, bytes: []const u8) !Result {12    var stream = try source.tokenize(allocator, bytes);13    defer stream.deinit(allocator);14    var program = try syntax.parse(allocator, bytes, stream.tokens);15    defer program.deinit();16    var chunk_value = try compiler.compile(allocator, &program);17    defer chunk_value.deinit(allocator);18    var vm = Vm.init(allocator, &chunk_value);19    defer vm.deinit();20    const value = try vm.run();21    return .{22        .value = value,23        .heap = vm.takeHeap(),24    };25}

1pub const execute = runtime.execute;