Welcome to PackSharp
PackSharp is an extension that makes working with .NET Core's dotnet
package and reference CLI commands much easier.
- Visually lists possible options so you can easily select what you want to do.
- Queries packages from the NuGet Repository so you can search and select the Package to use in a single command
The extension is a palette of commands. Simply open the Command Palette and type 'packsharp' to begin.
- Windows: SHIFT + CTRL + P
- Mac: SHIFT + CMD + P
Requirements
- This is a VS Code extension, so it requires VS Code.
- .NET Core v2.2 or greater. Not all commands will work as expected if you have a lower version of .NET Core.
- (Recommended) C# Extension installed
Features
Even though PackSharp abstracts complex logic behind the UI, each Palette Command will ultimately execute the appropriate dotnet
CLI command in the integrated terminal.
It is always helpful to see the actual CLI commands being run so you are familiarized with them, but also in case someone else isn't using VS Code or you have a more complex issue to solve.
- NOTE: All PackSharp commands are run from the Workspace Root. If you need a more complicated file structure, then you will need to run the dotnet CLI commands manually, as needed.
package.add
Add a NuGet Package to the selected Project.
- Using Palette Command => PackSharp: Add Package
- Turns to CLI Command =>
$ dotnet add [PROJECT] package [PACKAGE_NAME]
package.remove
Remove a NuGet Package from the selected Project.
- Using Palette Command => PackSharp: Remove Package
- Turns to CLI Command =>
$ dotnet remove [PROJECT] package [PACKAGE_NAME]
package.list
List Packages from the selected Project.
- Palette Command => PackSharp: List Packages
- Turns to CLI Command =>
$ dotnet list [PROJECT] package
project.add
Add a Project Reference to the selected Project.
- Using Palette Command => PackSharp: Add Project Reference
- Turns to CLI Command =>
$ dotnet add [SELECTED_PROJECT] reference [PROJECT_TO_ADD]
project.remove
Remove a Project Reference from the selected Project.
- Using Palette Command => PackSharp: Remove Project Reference
- Turns to CLI Command =>
$ dotnet remove [SELECTED_PROJECT] reference [PROJECT_TO_REMOVE]
project.list
List the Project References from the selected Project.
- Using Palette Command => PackSharp: List Project References
- Turns to CLI Command =>
$ dotnet list [PROJECT] reference
bootstrap.selenium
This one command will bootstrap Selenium to the selected Project. It's never been easier to get started with Selenium in C#!
template.new
Create a Project, Config, or Solution with a simple command.
The dotnet templates can be found at their dotnet new documentation.
- Using Palette Command => PackSharp: Create New Project
- Turns CLI Command =>
$ dotnet new [TEMPLATE] --name [NAME]
Known Issues
PackSharp does not support other dotnet
parameters like the "version" parameter in this example, $ dotnet add [PROJECT] package [PACKAGE_NAME] --version 1.2.3
The NuGet queries will return up to 20 results.
Release Notes
With the initial release of PackSharp, all questions and feedback are welcome! Please reach out to me on the GitHub repo or on the following platforms:
- Twitter : @CarlosKidman
- Email : carlos@qap.dev
1.0.0
- Initial release of PackSharp!
1.1.0
- Bootstrap Selenium in a single command
1.2.1
- Use Project filepaths instead of just their name.
1.3.1
- Easily create projects using the new Palette Command:
PackSharp: Create New Project
2.0.0
- List the Packages or References of a Project
2.1.0
- PackSharp inputs and options displayed will now persist even if focus is moved away.
2.2.0
- Removed
PackSharp: Query Packages
command since this is done by PackSharp: Add Package
already.
2.3.0
PackSharp: Bootstrap Selenium
command: Latest Stable Version detection mechanism updated