🔋 A batteries-included Python extension for Nova!

• Integration with several language servers:
  • Pyright
  • Pyrefly
  • ty
• Code formatting using:
  • Ruff
  • Black
  • autopep8
• 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

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

brew install pyright pyrefly ty uv 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.

Selecting which language server to use can be done in Nova's extension and project settings dialogs.

Further configuration is done by writing the specific settings defined by each language server directly into .nova/Configuration.json. See the following documentaion for available settings:

• Pyright settings
• Pyrefly settings
• ty settings

For example :

{
  "python.langServer" : "pyright",
  "python.analysis.diagnosticMode": "workspace"
}

{
  "python.langServer" : "ty",
  "ty.configurationFile": "\/Users\/johndoe\/.config\/ty.toml"
}

Note: Previous versions allowed setting certain Pyright-specific settings through the UI. These UI options have been removed since settings differ greatly between language servers.

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

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

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