acoustic-carpenter-78188
05/15/2026, 11:10 PMload_python_modules derives the dotted module name from a .py file path via Path.resolve().relative_to(root_dir). If the user runs flyte deploy path/to/file.py on a file that lives outside the configured project root (commonly: src-layout projects where the SDK inferred src/ but the file is elsewhere in the project), pathlib raises ValueError: '...' is not in the subpath of '...' and the raw stack lands in Sentry as an unhandled SDK crash.
• Wrap the relative_to call in a _relative_to_root helper that translates the ValueError into a click.ClickException. The user gets an actionable message pointing at the most common cause (forgot --root-dir), and the exception short-circuits the Sentry filter for click errors so we stop logging this as an SDK crash.
Sentry issues
Fixes FLYTE-SDK-2T (ValueError: '/Users/.../examples/basics/multi_status.py' is not in the subpath of '/Users/.../flyte-sdk/src')
Test plan
• New regression test test_load_python_modules_file_outside_root_raises_click_exception reproduces the Sentry crash shape and asserts a click.ClickException with the actionable message is raised
• Existing tests/flyte/utils/test_module_loader.py suite still passes
• make fmt clean
🤖 Generated with Claude Code
flyteorg/flyte-sdkacoustic-carpenter-78188
05/20/2026, 4:38 PM