Python: Iteration Plan for July 2022

[kieferrm]

This plan captures our work in July. 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

• Prompt about environments upon user action, not at start-up; @karrtikr issue
• Improve experience when starting up codespaces; @karrtikr issue
• Opening the Windows Store or appropriate walkthrough tile when Python is not installed (part of 🐍📔 Getting Started v-team); issue; @karrtikr
• Expand API for creating untitled files so as to specify the language mode; @karrtikr issue
• Make a new release of WWBD; @brettcannon

Environments

• 🏃‍♀️ Work on finalizing design of proposed API for environments; issue; @karrtikr
• Finalize on the UX for environment details in the status bar; related issue; @brettcannon @luabud
• Add a setting to control whether environment details are shown all the time, only for Python files, or never; issue, issue; @karrtikr

Editing

None

LSP

• Complete MVP of generated LSP types, take the repo public, and publish to PyPI; issue; @karthiknadig
• Explore pygls adopting programmatic definition of LSP (for notebook support); issue; @karthiknadig

Terminal

None

Debugging

• 🏃‍♀️ Investigate automatic debug configuration based on the open workspace for Django, Flask, and FastAPI; issue; @paulacamargo25
• 🏃‍♀️ Implement automatic debug configuration for Django; issue @paulacamargo25
• 🏃‍♀️ Implement automatic debug configuration for a Python script; issue @paulacamargo25
• 🏃‍♀️ Investigate and implement automatic debug configurations for Flask; issue @paulacamargo25
  • 🏃‍♀️ Investigate; discussion w/ Flask
  • 🏃‍ Implement
• 🏃‍ Investigate and implement automatic debug configurations for FastAPI; issue @paulacamargo25
  • 🏃‍♀️Investigate discussion w/ FastAPI
  • 🏃‍ Implement
• 🏃‍♀️💪 Investigate separating debug support into its own "debugy" extension; issue @paulacamargo25

Formatting

None

Linting

None

Testing

• 🏃‍♀️ Rewrite unittest execution code; issue; @ksy7588 @karthiknadig
• 🏃‍♀️ Investigate how to do pytest execution/discovery via plug-in; issue; @ksy7588 @karthiknadig

(github|vscode).dev

None

Documentation

• 🏃‍♀️ Documentation for the extension template; issue; @karthiknadig

Engineering

• 🏃‍♀️✋ Write web tests; issue; @karthiknadig
• Investigate how to transition users over from extension to tools extensions for pylint, black and isort; issue; @karthiknadig @brettcannon @luabud
• Investigate exposing settings in tools extensions for specifying the interpreter command for the server; issue; @karthiknadig
• Implement setting for using inbox copy of tools in template extensions; issue; @karthiknadig

Python community

• set up a buildbot on Azure, funded by MS; demo to explore VM requirements; @brettcannon

---

Deferred Items

• ✋ 🔵 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 @kimadeline
• Rewrite test execution for pytest
• ✋ Start work on implementing packaging.metadata; issue; @brettcannon
• ✋ 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
• Explore options for activated terminals and terminal profiles vscode-python#11039 @luabud @karrtikr
• 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