Pytrail is an extension that brings effortless performance tracing to the VSCode IDE. Pytrail only supports Python programs. Pytrail works by running Scalene against the main.py in the root of your editor and adding performance information to all files when you run the Annotate file command in the Command Palette.

:

Install the extension from the VSCode store.

To use the extension:

1. Make sure you have a working main.py in the root of your vscode workspace. For example, open tasks/ in VSCode.
2. Open command pallette and run pytrail: Run Tracing. This requires you to have Python and Scalene installed (python3 -m pip install -U scalene).
3. You should now have timing metadata on the left of your editor for lines that ran from main.py.

1. Get the dependencies by doing npm install or use the nix-shell environment.
2. I use npm run debug during development to build and install the extension. It is easier to use the VSCode built in way for running the extension. Something shows up in the bottom bar to run it (doesn't work for me)
3. Simple way: If you have the extension file, you can run code --install-extension ./pytrail-0.0.1.vsix and then reload VSCode. Note for the extension to work, your VSCode needs to be open to the tasks/ folder (or any folder with main.py at the root).

• Or, build and install from VSIX inside VSCode by right click file -> install or use code --install-extension ./pytrail-0.0.1.vsix
• Note: If this fails, remove the folder for this extension in ~/.vscode/extensions/

Logo icon by Hill icons created by Freepik - Flaticon

Trace data provided by Scalene

• URGENT: Figure out how to unbuffer Python inside of Scalene. May be impossible without a fork.
  • This may be useful: python3 -m scalene --- -m pytest your_test.py
• Outstanding bug in VSCode means I can't put the annotation in the gutter, so deleting code makes things wonky. A compromise between rerendering every keypress and every file change should be to only rerender if the number of lines in the file has changed. Of course, this will misalign the metadata, so this needs some sort of cheap extra logic to handle that case.
  • if this gets done, would be nice to add a hover tooltip so that the annotations are self documenting. Users frequently get confused. Could say "10% of all 50% of foo()"
• bundle with scalene?
• Add ""use strict";" to all files
• Add locking mechanism to tracing. Only run one trace at a time and make it clear and interruptible. Will require major refactor to use a class for each file.
• Warn if editor is dirty before run?
• Add colored output like this
• add keybindings
• add the debug menu to interrupt scalene run
• type the JSON profile data to get type safety in my code

TODO

Use pip to install scalene.

None

There are some hard coded values. You must have a runnable main.py.

This project is tested and should work. Please file an issue if you have any problems, and I will take a look on a best effort basis.

• Initial release of pytrail
• basic tracing and editor annotation support

Contributions welcome! File a PR or issue. Note this repository is GNU GPLv3, and your code will be licensed as such.

You MAY use Conventional Commits for your PR.