GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — sys.executable can be a relative path contrary to documented behavior [3.11 regression] · Issue #154160 · python/cpython

sys.executable can be a relative path contrary to documented behavior [3.11 regression] #154160

New issue
Copy link
New issue
Copy link
Open
Open
sys.executable can be a relative path contrary to documented behavior [3.11 regression]#154160
Copy link
Labels
extension-modulesC modules in the Modules dirC modules in the Modules dirtype-bugAn unexpected behavior, bug, or errorAn unexpected behavior, bug, or error

Description

@Lekensteyn
Lekensteyn
opened on Jul 19, 2026
Issue body actions

Bug report

Bug description:

When PATH contains a relative directory, sys.executable will also be a relative directory contrary to the current sys.executable documentation:

A string giving the absolute path of the executable binary for the Python interpreter, on systems where this makes sense. If Python is unable to retrieve the real path to its executable, sys.executable will be an empty string or None.

Context: I have a script that uses a custom virtualenv for dependencies that invokes itself in a different working directory. Because cwd is different, it relies on os.executable to be absolute. Minimal reproducer, set up python3 -m venv venv, then run PATH="venv/bin:$PATH" python3 script.py; using $PWD/venv/bin instead is a workaround for this issue.

import sys, subprocess; subprocess.run([sys.executable, "--version"], cwd="/tmp")

Alternative reproducer that reveals the issue:

$ python3 -m venv venv && PATH="venv/bin:$PATH" python3 -c 'import sys;print(sys.executable, sys.version.split()[0])'
<frozen site>:101: RuntimeWarning: Unexpected value in sys.prefix, expected /home/arch/venv, got venv
<frozen site>:101: RuntimeWarning: Unexpected value in sys.exec_prefix, expected /home/arch/venv, got venv
venv/bin/python3 3.14.6

This used to work in Python 3.10 and before, and is broken in Python 3.11 (2022) up to at least 3.14.6 and 3.15.0b3. I used this reproducer to confirm:

$ podman run --rm python:3.11-slim env PATH=usr/local/bin python3 -c 'import sys;print(sys.executable, sys.version.split()[0])'
usr/local/bin/python3 3.11.15

Another mild regression is the presence of an extra leading slash when using a relative path from the root directory:

$ podman run --rm python:3.15-rc-slim usr/local/bin/python3 -c 'import sys;print(sys.executable, sys.version.split()[0])'
//usr/local/bin/python3 3.15.0b3

$ podman run --rm python:3.10-slim usr/local/bin/python3 -c 'import sys;print(sys.executable, sys.version.split()[0])'
/usr/local/bin/python3 3.10.20

I suspect that both regressions have something to do with the refactoring done in https://bugs.python.org/issue45582 (#29041 by @zooba).
Somewhat related is #124241, that report is not about a relative path, but a modified argv[0]. Its current proposed fix to rely on /proc/self/exe (#145486 by @FFY00) could fix this issue, but has new regression risks.

CPython versions tested on:

3.15, 3.14, 3.13, 3.12, 3.11

Operating systems tested on:

Linux

Linked PRs

  • gh-154160: Make sys.executable absolute when resolved from a relative PATH entry #154163

Activity

  1. Lekensteyn
    added
    type-bugAn unexpected behavior, bug, or errorAn unexpected behavior, bug, or error
    on Jul 19, 2026
  2. picnixz
    added
    extension-modulesC modules in the Modules dirC modules in the Modules dir
    on Jul 19, 2026
  3. fedonman
    added a commit that references this issue on Nov 2, 2026

    Merge branch 'main' into fix-pythongh-154160-sys-executable-relative-…

    bf87267
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    extension-modulesC modules in the Modules dirC modules in the Modules dirtype-bugAn unexpected behavior, bug, or errorAn unexpected behavior, bug, or error

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      You are visitor 01402503 — GeezerVison does not store the pages you look up.
      Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.