-
Notifications
You must be signed in to change notification settings - Fork 26
Coding
- Node.js 18.17.0
- An upstream-supported version of Python
- Windows, macOS, or Linux
- Visual Studio Code
- The following VS Code extensions:
- Have an issue which has a "needs PR" label (feel free to indicate you would like to provide a PR for the issue so others don't work on it as well)
Always prefer to write Python code over TypeScript code. Not only does that give us more opportunity to use the extension ourself but it makes it easier for our users to contribute back.
- Add comments to explain non-obvious decisions, or contextual knowledge that can be forgotten.
- Conciseness is important.
- Comment should start with an uppercase letter, and end with a period (i.e. be complete sentences).
- If a question can be answered by looking at the code, a comment is probably unnecessary.
- A comment should answer "Why was this done this way?" two years down the line. If it doesn't, it is probably unnecessary, or should be rewritten.
- If some logic depends on external factors or tools, a comment capturing the assumptions made at implementation time may be useful.
- If the comment refers to work that needs to be done, create an issue for it and link it in your comment.
Follow PEP 8 and use Black extension.
-
Always use
pip-compile --generate-hashes
. - Make sure all requirements files are named
requirements.txt
.
Use Prettier.
- Do lean into TypeScript's types; typing is good. 😄
- Do not silence ESLint warnings unnecessarily; have justifications as to why.
-
Do not rely on the
!
operator, if possible; assume the typing is correct. -
Do use
undefined
when necessary; do not usenull
.
- Make sure in
package.json
that thevscode
"engine" matches what@types/vscode
is set to (and vice-versa).
Do note that building the extension is to discover compiler issues, not to specifically launch the extension in a Development Extension Host window (press F5).
git clone https://github.com/microsoft/vscode-python-debugger
cd vscode-python-debugger
npm ci
python3 -m venv .venv
# Activate the virtual environment as appropriate for your shell, For example, If you're on cmd, you can use...
# ".venv/Scripts/activate.bat"
# On bash/zsh it's ...
source .venv/bin/activate
# The Python code in the extension is formatted using Black.
python3 -m pip install nox
nox --session install_bundled_libs
If you see warnings that The engine "vscode" appears to be invalid.
, you can ignore these. If python3
is not available for some reason, you can use python
instead.
Run the Compile
build task from the Run Build Task... command picker (short cut CTRL+SHIFT+B
or ⇧⌘B
). This will leave build task running in the background and which will re-run as files are edited and saved. You can see the output from either task in the Terminal panel (use the selector to choose which output to look at).
For incremental builds you can use the following commands depending on your needs:
npm run watch
Sometimes you will need to run npm run clean
and even rm -r out
.
This is especially true if you have added or removed files.