Skip to content

getporter/vscode-extension

Repository files navigation

Visual Studio Code Porter Tools

This extension helps you to edit Porter resource files and view information about installed bundles. Features include:

  • Create a Porter project
  • Create and organize bundle installation steps
  • Build your Porter project into a bundle
  • Install a Porter bundle
  • Code completion and error checking for the Porter manifest
  • Navigation around the Porter manifest (Go To Definition and Find References)

For more about Porter see https://getporter.org/.

Prerequisites

You will need the Porter binary on your system PATH. If you don't have this, you can download it from https://getporter.org/install/.

If you have the Porter binary but it's not on your path, you can specify the file path using the vscode-porter > porter-path configuration setting. This must include the full file path, not just the directory (and must include the .exe extension on Windows).

Telemetry

This extension collects telemetry data to help us build a better experience for building bundles with Porter and VS Code. We only collect the following data:

  • Which commands are executed
  • Whether a command succeeded or failed

We do not collect any information about image names, paths, error messages, etc. The extension respects the telemetry.enableTelemetry setting which you can learn more about in our FAQ.

Contributing

This project welcomes contributions and suggestions. See our Contributing Guide to learn how to build and test the Porter VS Code extension.

This project adheres to Porter's Code of Conduct.