PythonEnvironmentInfo.environmentPath is a read-only property of type Uri, inherited by the public PythonEnvironment interface. The concrete implementation, PythonEnvironmentImpl, copies this value from the information supplied by the environment manager.
Currently, the API documentation explicitly allows this property to refer to either the Python executable or the environment directory. Consequently, consumers cannot determine which kind of path they have from the property’s contract alone.
Current behavior
The meaning of environmentPath depends on the environment manager:
It can identify the Python executable, such as "/project/.venv/bin/python".
It can identify the environment directory, such as "/project/.venv".
These paths are not interchangeable. Consumers expecting an interpreter path must account for manager-specific behavior or perform additional resolution.
Expected behavior
PythonEnvironmentInfo.environmentPath, and therefore PythonEnvironment.environmentPath, should consistently identify the Python executable, regardless of the environment manager.
The property should remain a Uri; this change concerns what it points to, not its type.
PythonEnvironmentInfo.environmentPathis a read-only property of typeUri, inherited by the publicPythonEnvironmentinterface. The concrete implementation,PythonEnvironmentImpl, copies this value from the information supplied by the environment manager.Currently, the API documentation explicitly allows this property to refer to either the Python executable or the environment directory. Consequently, consumers cannot determine which kind of path they have from the property’s contract alone.
Current behavior
The meaning of
environmentPathdepends on the environment manager:It can identify the Python executable, such as
"/project/.venv/bin/python".It can identify the environment directory, such as
"/project/.venv".These paths are not interchangeable. Consumers expecting an interpreter path must account for manager-specific behavior or perform additional resolution.
Expected behavior
PythonEnvironmentInfo.environmentPath, and thereforePythonEnvironment.environmentPath, should consistently identify the Python executable, regardless of the environment manager.The property should remain a
Uri; this change concerns what it points to, not its type.