interpretthis 0.4.0

Sandboxed Python AST interpreter for untrusted and LLM-generated code
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

// Copyright 2026 Thomas Santerre and Moderately AI Inc.
//
// SPDX-License-Identifier: MIT OR Apache-2.0

use rustpython_parser::{
    Parse,
    ast::{self, Suite},
};

use crate::error::InterpreterError;

/// Parse Python source code into an AST suite (list of statements).
///
/// Applies CPython's compile-time private-name mangling (`__x` inside a class
/// body → `_ClassName__x`) as a post-parse AST pass.
pub fn parse(code: &str) -> Result<Suite, InterpreterError> {
    let suite = ast::Suite::parse(code, "<interpreter>").map_err(|e| {
        // rustpython appends " at byte offset N"; CPython's SyntaxError message
        // carries no offset (the position lives in the traceback), so strip it.
        let full = format!("{e}");
        let msg = full.split(" at byte offset ").next().unwrap_or(&full).to_owned();
        InterpreterError::Syntax(msg)
    })?;
    Ok(crate::mangle::mangle_private_names(suite))
}