Python: Iteration Plan for October 2022

[kieferrm]

This plan captures our work in October. We follow the same iteration cycle as VS Code. Although we plan for a whole iteration, we may not only ship at the end of an iteration but throughout.

Legend of annotations

Mark	Description
🏃‍♀️	work in progress
✋	blocked task
💪	stretch goal for this iteration
🔴	missing issue reference
🔵	more investigation required to remove uncertainty
⚫	under discussion within the team
⬛	a large work item, larger than one iteration

Getting started

• Update walkthrough to mention Create Environment issue @cwebster-99 @karrtikr @karthiknadig

Environments

• Add a way to get PYTHONPATH (due to .env files) to the extension API for Pylance issue @karrtikr
• ✋ Stabilize extension API (blocked on Jupyter feedback) issue @karrtikr

Editing

None

LSP

• 🏃‍ ✋⬛ Design document for Jupyter <--> Python <--> [ Pylance, Jedi, etc] interaction; issue; @karthiknadig

Terminal

• 🏃‍ Explore options for activated terminals and terminal profiles vscode-python#11039 @karrtikr @luabud

Debugging

• Remove dependency injection from debugger code @paulacamargo25 @karthiknadig
  • 🏃‍ Remove DI from debug configuration resolvers. issue
  • Remove DI from debug adapter factory. issue
  • Remove DI from launch and attach classes for testing. issue
  • 💪 Simplify launch and attach classes for testing. issue
• ✋⬛ Isolate debugger code in core extension so it can be extracted easily; issue @paulacamargo25 @karthiknadig

Formatting

• Control rollout of notifying about migrating to the formatting extensions; issue; @luabud @karthiknadig
• 🏃‍ Control rollout of notifying about migrating to the isort extension; issue; @luabud @karthiknadig

Linting

• 🏃‍ Control rollout of notifying about migrating to the linting extensions; issue; @luabud @karthiknadig

Testing

• 🏃‍♀️ ⬛ Rewrite pytest execution/discovery through a pytest plug-in; issue; @eleanorjboyd @karthiknadig

vscode.dev

None

Documentation

None

Engineering

• Update localization to use l10n.t API; PR; @paulacamargo25

Python community

• 🏃‍♀️ Find out the concerns blocking releasing packaging 22; @brettcannon
• Get guidance from the Python steering council about what will be required to promote WASI support to tier 2; @brettcannon
• 🏃‍♀️ Decide whether creating a library crate for the Python Launcher is worth it or to have py support some JSON output; @brettcannon

---

Deferred Items

• Select an environment based on VIRTUAL_ENV
• Select an environment based on CONDA_EXE
• ✋ 🔵 Work w/ Pylance on automatic indentation vscode-python#481 @brettcannon (blocked on VS Code issue)
• ✋ Create platform-specific VSIXs (blocked on standardizing on extension pipelines supporting platform-specific VSIXs); vscode-python#17439 @paulacamargo25
• Infer environment variables for an activated conda environment vscode-python#17332 @karrtikr
• Rewrite test discovery for pytest vscode-python#17242
• ✋ Finalize Python Launcher plug-in design (blocked on conda's feedback); discussion; @brettcannon
• Support .python-version for pyenv; issue; @karrtikr
• Investigate any remaining places we are not using conda run
• Implement a Python traceback problem matcher in core
• 🔴 Use conda run when debugging (waiting on the conda team to give us the go-ahead to rely on conda run so fundamentally); @paulacamargo25
• Provide settings to control what environment details are displayed; @karrtikr
• Investigate configuring running and debugging
• Work out how best to install debugpy into a new debugger extension; issue @paulacamargo25 @karthiknadig
• ✋ Write web tests; issue; @karthiknadig