Title: profiling.sampling: `run script.py` does not put the script's directory on sys.path, so sibling imports fail · Issue #158540 · python/cpython · GitHub
Open Graph Title: profiling.sampling: `run script.py` does not put the script's directory on sys.path, so sibling imports fail · Issue #158540 · python/cpython
X Title: profiling.sampling: `run script.py` does not put the script's directory on sys.path, so sibling imports fail · Issue #158540 · python/cpython
Description: Bug report Background I have been writing a set of guided workshops on Tachyon as a way of learning it (https://github.com/GrahamDumpleton/tachyon-workshops), using an AI agent to generate the workshop content. One of the example program...
Open Graph Description: Bug report Background I have been writing a set of guided workshops on Tachyon as a way of learning it (https://github.com/GrahamDumpleton/tachyon-workshops), using an AI agent to generate the work...
X Description: Bug report Background I have been writing a set of guided workshops on Tachyon as a way of learning it (https://github.com/GrahamDumpleton/tachyon-workshops), using an AI agent to generate the work...
Opengraph URL: https://github.com/python/cpython/issues/158540
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"profiling.sampling: `run script.py` does not put the script's directory on sys.path, so sibling imports fail","articleBody":"### Bug report\n\n## Background\n\nI have been writing a set of guided workshops on Tachyon as a way of learning it (https://github.com/GrahamDumpleton/tachyon-workshops), using an AI agent to generate the workshop content. One of the example programs being profiled in a workshop is a script that imports a helper module from its own directory. The agent found that the script ran fine as `python dir/script.py`, but failed with an import error as `python -m profiling.sampling run dir/script.py`. I am reporting it in case it is unintended; it may be a known difference.\n\n## What happens\n\nWhen a script is run with the `run` subcommand from a directory other than the script's own, `sys.path[0]` is the current working directory, not the script's directory. A script that imports a module beside it works with `python` and fails with `ModuleNotFoundError` under the profiler.\n\n```\n$ mkdir -p w/sub && cd w\n$ printf 'import sys\\nprint(\"path0:\", repr(sys.path[0]), \"argv0:\", sys.argv[0])\\nimport helper\\n' > sub/where.py\n$ printf 'print(\"helper imported\")\\n' > sub/helper.py\n\n$ python sub/where.py\npath0: '/home/tester/w/sub' argv0: sub/where.py\nhelper imported\n\n$ python -m profiling.sampling run sub/where.py\npath0: '/home/tester/w' argv0: /home/tester/w/sub/where.py\nTraceback (most recent call last):\n File \"\u003cfrozen runpy>\", line 201, in _run_module_as_main\n File \"\u003cfrozen runpy>\", line 87, in _run_code\n File \".../lib/python3.15/profiling/sampling/_sync_coordinator.py\", line 256, in \u003cmodule>\n main()\n ~~~~^^\n File \".../lib/python3.15/profiling/sampling/_sync_coordinator.py\", line 249, in main\n _execute_script(script_path, script_args, cwd)\n ~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n File \".../lib/python3.15/profiling/sampling/_sync_coordinator.py\", line 196, in _execute_script\n exec(code, main_module.__dict__)\n ~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n File \"/home/tester/w/sub/where.py\", line 3, in \u003cmodule>\n import helper\nModuleNotFoundError: No module named 'helper'\nCaptured 43 samples in 0.04 seconds\n```\n\nRunning from inside the script's directory works, since the working directory and the script's directory are then the same:\n\n```\n$ cd sub && python -m profiling.sampling run where.py\npath0: '/home/tester/w/sub' argv0: /home/tester/w/sub/where.py\nhelper imported\n```\n\nTested on 3.15.0rc2 (python-build-standalone build installed by uv, and the `python:3.15-rc-slim` image) on Linux aarch64 in a container, as a non-root user.\n\n## Why I think it is a problem\n\nThe documentation for `run` says it \"launches a Python script or module\" and gives `python -m profiling.sampling run script.py` as the way to profile a script, with nothing about the script seeing a different `sys.path` than it would under `python script.py`. A script that works on its own and fails under the profiler is a surprise, and for the usual layout of a small program, a script with a helper module or package beside it, it means the profiler can only be run from inside that directory.\n\nTwo smaller differences show in the same output, which may or may not matter: `sys.argv[0]` is made absolute (`/home/tester/w/sub/where.py` rather than `sub/where.py`), and the script runs with `sys.path[0]` set to the working directory even when that is not where the script is, which is the `python -m` rule applied to a script.\n\n## Where it comes from (from reading the source, not verified by me)\n\nThe agent's reading of `Lib/profiling/sampling/_sync_coordinator.py`: `_setup_environment` changes to the working directory and inserts it at the front of `sys.path` (\"Add current directory to sys.path if not present (for module imports)\"), which is right for `-m` but is done for scripts too. `_execute_script` then makes the script path absolute, sets `sys.argv`, and executes the compiled source with `exec` in a fresh `__main__` module, without inserting `os.path.dirname(script_path)` into `sys.path` as the interpreter does for a script. A one-line insert of the script's directory at `sys.path[0]` in the script case looks like the fix, but I cannot say whether there is a reason it was left out.\n\n\n\n### CPython versions tested on:\n\n3.15\n\n### Operating systems tested on:\n\nLinux\n\n\u003c!-- gh-linked-prs -->\n### Linked PRs\n* gh-158547\n* gh-158548\n* gh-158844\n\u003c!-- /gh-linked-prs -->\n","author":{"url":"https://github.com/GrahamDumpleton","@type":"Person","name":"GrahamDumpleton"},"datePublished":"2026-10-01T00:09:54Z","url":"https://github.com/python/cpython/issues/158540"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:a1895120-9e91-784a-f4bf-8ad8c562b12a |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D198:2A5566:1C721C7:253F943:6B021B63 |
| html-safe-nonce | ef1379d83e09a40d4a3ceed3e311de4177452326596c4494818e02fe71cbfa13 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEMTk4OjJBNTU2NjoxQzcyMUM3OjI1M0Y5NDM6NkIwMjFCNjMiLCJ2aXNpdG9yX2lkIjoiMzg4MzA3MjM5MjE0NjMyODQxOSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 9ff1755e4f3777315251b98e5cb8aa816ce09aa4443106695618afabacb6e22f |
| hovercard-subject-tag | issue:5654716572 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/158540/issue_layout |
| twitter:image | https://opengraph.githubassets.com/060393659af8b02ae5290d5d4328a65cb05020a8a21dd226028ab841cdc94473/python/cpython/issues/158540 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/060393659af8b02ae5290d5d4328a65cb05020a8a21dd226028ab841cdc94473/python/cpython/issues/158540 |
| og:image:alt | Bug report Background I have been writing a set of guided workshops on Tachyon as a way of learning it (https://github.com/GrahamDumpleton/tachyon-workshops), using an AI agent to generate the work... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | GrahamDumpleton |
| hostname | github.com |
| expected-hostname | github.com |
| None | 87e774ee7c6b3bee0490394e4d3e57ec9dbc956f74b87ea685dc8996c1676456 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/cpython git https://github.com/python/cpython.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 81598961 |
| octolytics-dimension-repository_nwo | python/cpython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 81598961 |
| octolytics-dimension-repository_network_root_nwo | python/cpython |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 423dbb54c5e7bfecc838eb387c1435eb3d0e760d |
| ui-target | canary-2 |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width