Extension Details

🔋 A batteries-included Python extension for Nova!

What's in the box?

• Integration with Microsoft's Pyright language server
• Code formatting using Ruff or Black
• Linting (and import organization) with Ruff
• A Virtual Environment task for running a script or Python module as though the project's virtual environment is active
• A Cleanup task for clearing out Python cache files, build artifacts, and other files/directories
• A tree-sitter based syntax for requirements.txt files, based off of tree-sitter-requirements
• A sidebar showing all packages installed in your configured Python environment, along with any outdated versions, and optionally any known vulnerabilities using pip-audit

Requirements

If you use Homebrew, the easiest way to get started is:

brew install pyright ruff pip-audit

This extension will try to find tools installed on your PATH, so installing into your virtual environment or another location should work, as well.

Acknowledgements

This project drew inspiration (and code!) from many others that came before it:

• Pyreet
• Pyright for Nova
• Black Nova Extension and Ruff Nova Extension

Attributions

• Snowflake icons created by Good Ware - Flaticon
• Up arrow icons created by Ayub Irawan - Flaticon
• Python icon by Anja van Staden

Version 1.4.0 - 2025.01.30

• Fix an issue where imports were not sorted on save if linting errors exist in the file
• Initial support for uv!
  • Use uv when available for freezing requirements (via uv export)
  • Use uv for the package sidebar (much faster to show outdated and audit)

Version 1.3.1 - 2024.09.27

• Minor bug fix when no venvDirs set

Version 1.3.0 - 2024.05.10

• Added a Fix and Organize Imports (Workspace) command
• Search workspace root for virtual environments (.venv, etc.)
• Recognize requirements.lock and requirements-dev.lock as requirements files
• Updated to latest tree-sitter-requirements

Version 1.2.1 - 2024.04.03

• Added support for Pyright's pyright.disableTaggedHints setting

Version 1.2 - 2023.12.15

• New commands for fixing all violations or organizing all imports in your workspace
• Support (and prefer) ruff format in addition to black
• New workspace settings for fixing violations and organizing imports on editor save
• Workspace cleanup was not properly removing .egg-info directories

Version 1.1 - 2023.12.14

• Task, command, and settings for cleaning up Python cache files and build artifacts (#4)
• New setting for Pip's --upgrade-strategy option (#3)

Version 1.0

Initial release

MIT License

Copyright (c) 2023 Dan Watson

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.