PyGuide Extension for Visual Studio Code

Provides additional Python diagnostic messages aimed at beginners.

The extension was created by researchers at the University of York. Help us to make it better by participating in our research. Participation is anonymous.

Features

PyGuide detects code issues that may indicate a misunderstanding of a concept or syntax, or a simple typo. Detected issues are underlined, just like other issues picked up by VSCode. By default, some quick feedback is displayed over underlined code. Click the message to open more detailed guidance.

If the "showCodeLens" setting is disabled, hover over underlined code to get some quick feedback.

Click the action in the lightbulb menu to open more detailed guidance.

You can also view detected issues in the Problems tab of your Terminal.

Requirements

PyGuide requires the Microsoft Python for VS Code extension. It will automatically be installed if you do not already have it.

Extension Settings

This extension contributes the following setting:

• pyguide.allowLogging: Enable/disable usage data collection for this extension only.
• pyguide.showCodeLens: Show/hide a clickable feedback message above an issue in your code. If enabled, you can click the message to see extended feedback. If disabled, you can still access the extended feedback via the lightbulb menu or the Problems pane.

Known Issues

This extension can only detect issues that are task independent—it cannot detect logic errors or strategic errors that would require knowledge of what you are working on. It is intended for beginner programmers so may not work with more advanced concepts and syntax.

Release Notes

0.1.0

First release via the extension marketplace.

0.0.5

Minor bug fixes.

0.0.4

Added CodeLens to enable easier feedback access.

0.0.2 and 0.0.3

Fixed bugs relating to false detection of issues when using advanced Python concepts.

0.0.1

Initial release of PyGuide.