Test finalized API for python environments

Refs: https://github.com/microsoft/vscode-python/issues/19101

• anyOS: @IanMatthewHuff
• anyOS: @DonJayamanne

Complexity: 5

Create Issue

---

Requirements

Pre-assigning Jupyter team, but note builds are not available yet, testing begins tomorrow.

1. Use Pre release build of the python extension
2. Have as many types of environments as you can.
3. Interesting types to test: Conda, Pyenv global installs, Pyenv conda envs etc.

Test APIs exposed via ProposedExtensionAPI

• See ProposedExtensionAPI for APIs to test: https://github.dev/microsoft/vscode-python/blob/main/src/client/proposedApiTypes.ts
• Use Python: Clear cache and reload command to clear any pre-existing discovery cache in the extension.
• Try dry-adopting it in the Jupyter extension for discovery of Python environments and make sure it covers all scenarios.

Example usage: Copy over contents of https://github.com/microsoft/vscode-python/blob/main/src/client/proposedApiTypes.ts#L8 as needed.

const extension = extensions.getExtension('ms-python.python');
if (extension) {
    if (!extension.isActive) {
        await extension.activate();
    }
    const api: IExtensionApi & ProposedExtensionAPI = extension.exports as IExtensionApi & ProposedExtensionAPI;
    if (api.environment) {
        const envPath =  api.environment.getActiveEnvironmentPath();
    }
}

[karrtikr]

So I talked with the team and decided that we’ll finalize it in an iteration or two, hope that gives Jupyter some time to adopt the API. Meanwhile we’ll still announce it in our blog posts and release notes to get additional feedback!

[IanMatthewHuff]

Right now I’m testing this with a separate extension as opposed to trying to fully adopt into Jupyter. Seemed like a fairer test of the API itself.

• After refresh list of envs looks correct in .all
• getActiveEnvironmentPath returns the correct Env, as well as after a change
• After calling resolveEnvironment the env looks correct (venv, conda, global, pyenv)
• updateActiveEnvironmentPath updates the environment
• onDidChangeActiveEnvironmentPath fires corrected with the right arg (and doesn’t file if update parameter is already active)
• onDidChangeEnvironments changes when adding a new Env
• Cancellation token works on a full force refresh