Skip to content

fix: improve error message when RUSTPYTHONPATH not loaded in Settings #8732

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lakshmip03 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

fix: improve error message when RUSTPYTHONPATH not loaded in Settings #8732

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c12cd7f
fix: improve error message when RUSTPYTHONPATH not loaded in Settings
lakshmip03 Sep 18, 2026
692dcb2
fix: address review feedback on error message
lakshmip03 Sep 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 15 additions & 1 deletion crates/vm/src/vm/mod.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1143,7 +1143,21 @@ impl VirtualMachine {
} else if path_contains_env {
"RUSTPYTHONPATH or PYTHONPATH is set, but it doesn't contain the encodings library. If you are customizing the RustPython vm/interpreter, try adding the stdlib directory to the path. If you are developing the RustPython interpreter, it might be a bug during development."
} else {
"RUSTPYTHONPATH or PYTHONPATH is set, but it wasn't loaded to `PyConfig::paths::module_search_paths`. If you are going to customize the RustPython vm/interpreter, those environment variables are not loaded in the Settings struct by default. Please try creating a customized instance of the Settings struct. If you are developing the RustPython interpreter, it might be a bug during development."
"RUSTPYTHONPATH or PYTHONPATH is set, but it wasn't loaded to `PyConfig::paths::module_search_paths`. \
Environment variables are not loaded into the Settings struct by default when embedding RustPython. \
To fix this, add the stdlib path manually:\n\
\n\
let settings = rustpython_vm::Settings::default().with_path(\"/path/to/stdlib\".to_owned());\n\
\n\
If `RUSTPYTHONPATH` is already set, explicitly load it to path:\n\
\n\
settings.path_list.extend(\n\
std::env::split_paths(&std::env::var_os(\"RUSTPYTHONPATH\").unwrap_or_default())\n\
.map(|path| path.to_string_lossy().into_owned()),\n\
);\n\
\n\
If you are developing the RustPython interpreter itself, this might be a bug during development."

};

let mut msg = format!(
Expand Down