René's URL Explorer Experiment


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

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@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-profiling0
react-import-mapreact,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-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:a1895120-9e91-784a-f4bf-8ad8c562b12a
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idD198:2A5566:1C721C7:253F943:6B021B63
html-safe-nonceef1379d83e09a40d4a3ceed3e311de4177452326596c4494818e02fe71cbfa13
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEMTk4OjJBNTU2NjoxQzcyMUM3OjI1M0Y5NDM6NkIwMjFCNjMiLCJ2aXNpdG9yX2lkIjoiMzg4MzA3MjM5MjE0NjMyODQxOSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac9ff1755e4f3777315251b98e5cb8aa816ce09aa4443106695618afabacb6e22f
hovercard-subject-tagissue:5654716572
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/158540/issue_layout
twitter:imagehttps://opengraph.githubassets.com/060393659af8b02ae5290d5d4328a65cb05020a8a21dd226028ab841cdc94473/python/cpython/issues/158540
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/060393659af8b02ae5290d5d4328a65cb05020a8a21dd226028ab841cdc94473/python/cpython/issues/158540
og:image:altBug 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:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameGrahamDumpleton
hostnamegithub.com
expected-hostnamegithub.com
None87e774ee7c6b3bee0490394e4d3e57ec9dbc956f74b87ea685dc8996c1676456
turbo-cache-controlno-preview
go-importgithub.com/python/cpython git https://github.com/python/cpython.git
octolytics-dimension-user_id1525981
octolytics-dimension-user_loginpython
octolytics-dimension-repository_id81598961
octolytics-dimension-repository_nwopython/cpython
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id81598961
octolytics-dimension-repository_network_root_nwopython/cpython
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release423dbb54c5e7bfecc838eb387c1435eb3d0e760d
ui-targetcanary-2
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/python/cpython/issues/158540#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fissues%2F158540
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fissues%2F158540
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=python%2Fcpython
Reloadhttps://github.com/python/cpython/issues/158540
Reloadhttps://github.com/python/cpython/issues/158540
Reloadhttps://github.com/python/cpython/issues/158540
pythonhttps://github.com/python
cpythonhttps://github.com/python/cpython
Codehttps://github.com/python/cpython
Issues5k+ (5k+)https://github.com/python/cpython/issues
Pull requests2.4k (2.4k)https://github.com/python/cpython/pulls
Actionshttps://github.com/python/cpython/actions
Projectshttps://github.com/python/cpython/projects
Security and qualityhttps://github.com/python/cpython/security
Insightshttps://github.com/python/cpython/insights
https://github.com/python/cpython
New issuehttps://github.com/login?return_to=https://github.com/python/cpython/issues/158540
New issuehttps://github.com/login?return_to=https://github.com/python/cpython/issues/158540
#158548https://github.com/python/cpython/pull/158548
profiling.sampling: run script.py does not put the script's directory on sys.path, so sibling imports failhttps://github.com/python/cpython/issues/158540#top
#158548https://github.com/python/cpython/pull/158548
stdlibStandard Library Python modules in the Lib/ directoryhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22stdlib%22
topic-profilinghttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-profiling%22
type-bugAn unexpected behavior, bug, or errorhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22type-bug%22
https://github.com/GrahamDumpleton
GrahamDumpletonhttps://github.com/GrahamDumpleton
on Oct 1, 2026https://github.com/python/cpython/issues/158540#issue-5654716572
https://github.com/GrahamDumpleton/tachyon-workshopshttps://github.com/GrahamDumpleton/tachyon-workshops
gh-158540: Add the profiled script's directory to sys.path #158547https://github.com/python/cpython/pull/158547
gh-158540: Add the profiled script's directory to sys.path #158548https://github.com/python/cpython/pull/158548
[3.15] gh-158540: Add the profiled script's directory to sys.path (GH-158548) #158844https://github.com/python/cpython/pull/158844
GrahamDumpletonhttps://github.com/GrahamDumpleton
type-bugAn unexpected behavior, bug, or errorhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22type-bug%22
on Oct 1, 2026https://github.com/python/cpython/issues/158540#event-32210249104
https://github.com/hetaozdh
hetaozdhhttps://github.com/hetaozdh
on Oct 1, 2026https://github.com/python/cpython/issues/158540#issuecomment-5924283728
hetaozdhhttps://github.com/hetaozdh
on Oct 1, 2026https://github.com/python/cpython/issues/158540#event-32225161351
pythongh-158540: Add the profiled script's directory to sys.pathhttps://github.com/hetaozdh/cpython/commit/16ff1ec97005f4f1c7fae278e4009b72db905256
pythongh-158540https://github.com/python/cpython/issues/158540
16ff1echttps://github.com/hetaozdh/cpython/commit/16ff1ec97005f4f1c7fae278e4009b72db905256
StanFromIrelandhttps://github.com/StanFromIreland
stdlibStandard Library Python modules in the Lib/ directoryhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22stdlib%22
topic-profilinghttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-profiling%22
on Oct 1, 2026https://github.com/python/cpython/issues/158540#event-32239808989
hetaozdhhttps://github.com/hetaozdh
on Oct 1, 2026https://github.com/python/cpython/issues/158540#event-32270641795
pythongh-158540: Resolve symlinks when adding the script directory to…https://github.com/hetaozdh/cpython/commit/64b0861358a688416eb04e8e192c59e367f273dd
pythongh-158540https://github.com/python/cpython/issues/158540
64b0861https://github.com/hetaozdh/cpython/commit/64b0861358a688416eb04e8e192c59e367f273dd
pythongh-158540: Resolve symlinks when adding the script directory to…https://github.com/hetaozdh/cpython/commit/264a36c03cc21ad5188096cc881db62a2fc6d89c
pythongh-158540https://github.com/python/cpython/issues/158540
264a36chttps://github.com/hetaozdh/cpython/commit/264a36c03cc21ad5188096cc881db62a2fc6d89c
pablogsalhttps://github.com/pablogsal
on Oct 5, 2026https://github.com/python/cpython/issues/158540#event-32513946372
gh-158540: Add the profiled script's directory to sys.path (#158548)https://github.com/python/cpython/commit/3f02aab9faa338853425da23541e44e4bd24d478
gh-158540https://github.com/python/cpython/issues/158540
#158548https://github.com/python/cpython/pull/158548
3f02aabhttps://github.com/python/cpython/commit/3f02aab9faa338853425da23541e44e4bd24d478
pablogsalhttps://github.com/pablogsal
completedhttps://github.com/python/cpython/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
#158548https://github.com/python/cpython/pull/158548
on Oct 5, 2026https://github.com/python/cpython/issues/158540#event-32513946471
pablogsalhttps://github.com/pablogsal
on Oct 5, 2026https://github.com/python/cpython/issues/158540#event-32519082354
[3.15] gh-158540: Add the profiled script's directory to sys.path (GH…https://github.com/python/cpython/commit/f52d831397ec77cf969c71c1ef339c1e28494eca
gh-158540https://github.com/python/cpython/issues/158540
GH…https://github.com/python/cpython/pull/158548
f52d831https://github.com/python/cpython/commit/f52d831397ec77cf969c71c1ef339c1e28494eca
Revert "[3.15] pythongh-158540: Add the profiled script's directory t…https://github.com/pablogsal/cpython/commit/078fa23168d667ac87d4c869e7221386685eb0cb
pythongh-158540https://github.com/python/cpython/issues/158540
078fa23https://github.com/pablogsal/cpython/commit/078fa23168d667ac87d4c869e7221386685eb0cb
[3.15] Restore deferred backports for 3.15.1, including GH-158874 (#1…https://github.com/python/cpython/commit/4ceb3faf2c1f5bf17c56be085c4b1c1b38e47f9e
GH-158874https://github.com/python/cpython/pull/158874
#1…https://github.com/python/cpython/pull/158882
4ceb3fahttps://github.com/python/cpython/commit/4ceb3faf2c1f5bf17c56be085c4b1c1b38e47f9e
Sign up for freehttps://github.com/signup?return_to=https://github.com/python/cpython/issues/158540
Sign in to commenthttps://github.com/login?return_to=https://github.com/python/cpython/issues/158540
stdlibStandard Library Python modules in the Lib/ directoryhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22stdlib%22
topic-profilinghttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-profiling%22
type-bugAn unexpected behavior, bug, or errorhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22type-bug%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.