search

adrian-pavel / visual-nuget

Code for the Visual NuGet package manager extension for VS Code.
MIT License
30 stars 5 forks source link
dotnet nuget vscode vscode-extension

readme

Visual Nuget

A visual NuGet package manager. Search for, install and uninstall NuGet packages. (.Net Framework not supported)

Unfortunately I just don't have enough time to actively develop visual-nuget anymore. Maybe in the future, but for now please do not expect updates from my side and take it as is.

Need to have dotnet installed. The extension forwards the commands to the dotnet cli.

Known issues and missing features

  1. Github NuGet registry not supported properly yet. Others probably as well.
  2. Lazy loading more results not implemented yet.

Quick peek

Quick peek animation

How to use

Right click on any .csproj, .fsproj or .vbproj file in your workspace and click on the "Visual NuGet: Manage Packages" menu entry.

This will open a panel with the UI to manage your packages. It is very similar to the NuGet Package Manager in Visual Studio.

Adding new package sources

By default, Visual NuGet only uses nuget.org as a package source but you can add your own, including private ones.

For this you have to go into the setting and add a new item to the list.

Sources are defined by a JSON string with of the following format:
"{\"name\": \"nuget.org\",\"url\": \"https://api.nuget.org/v3/index.json\", "authorizationHeader": undefined}"

The name property is just the friendly name that will be displayed in the UI.
The url property needs to point to the index.json file of the API.
The authorizationHeader is only needed if the source is private and requires authentication/authorization.

To compose the authorizatonHeader check the documentation of the API you want to use as a source.
It usually is either a "Basic mybase64EncodedUsernameAndPassword" or "Bearer myPersonalPrivateAccessToken".

Example
Azure DevOps
Create a PAT by following the guide here. Make sure to give it Packaging Read access.
With the created PAT base64 encode a string of the following format: VssSessionToken:MyNewlyCreatedPAT
Compose the authorizationHeader like so: "Basic MyBase64EncodedString". It should look something like this: "Basic VnNzU2Vzc2lvblRva2VuOk15TmV3bHlDcmVhdGVkUEFU".
Use this string when defining the source in the Settings.

Release notes

Check the changelog here

Any questions or issues?

Don't hesitate to ask on https://github.com/adrian-pavel/visual-nuget/issues