NuGet.Packaging 6.11.1

Nuget.Packaging

NuGet.Packaging is a NuGet client SDK library that provides a set of APIs to interact with .nupkg and .nuspec files from a stream. It provides a way for developers to create and read packages and work with the package metadata.

Usage

It is strongly recommended that NuGet packages are created using the official NuGet tooling and instead of this low-level API. There are a variety of characteristics important for a well-formed package and the latest version of tooling helps incorporate these best practices.

For more information about creating NuGet packages, see the overview of the package creation workflow and the documentation for official pack tooling (for example, using the dotnet CLI).

Examples

Create a package

Create a package, set metadata, and add dependencies.

PackageBuilder builder = new PackageBuilder();
builder.Id = "MyPackage";
builder.Version = new NuGetVersion("1.0.0-beta");
builder.Description = "My package created from the API.";
builder.Authors.Add("Sample author");
builder.DependencyGroups.Add(new PackageDependencyGroup(
    targetFramework: NuGetFramework.Parse("netstandard1.4"),
    packages: new[]
    {
        new PackageDependency("Newtonsoft.Json", VersionRange.Parse("10.0.1"))
    }));

using FileStream outputStream = new FileStream("MyPackage.nupkg", FileMode.Create);
builder.Save(outputStream);
Console.WriteLine($"Saved a package to {outputStream.Name}");

Read a package

Read a package from a file.

using FileStream inputStream = new FileStream("MyPackage.nupkg", FileMode.Open);
using PackageArchiveReader reader = new PackageArchiveReader(inputStream);
NuspecReader nuspec = reader.NuspecReader;
Console.WriteLine($"ID: {nuspec.GetId()}");
Console.WriteLine($"Version: {nuspec.GetVersion()}");
Console.WriteLine($"Description: {nuspec.GetDescription()}");
Console.WriteLine($"Authors: {nuspec.GetAuthors()}");

Console.WriteLine("Dependencies:");
foreach (PackageDependencyGroup dependencyGroup in nuspec.GetDependencyGroups())
{
    Console.WriteLine($" - {dependencyGroup.TargetFramework.GetShortFolderName()}");
    foreach (var dependency in dependencyGroup.Packages)
    {
        Console.WriteLine($"   > {dependency.Id} {dependency.VersionRange}");
    }
}

Additional documentation

More information about the NuGet.Packaging library can be found on the official Microsoft documentation page and NuGet API docs.

Showing the top 20 packages that depend on NuGet.Packaging.

Packages Downloads
Microsoft.VisualStudio.Web.CodeGeneration.Utils
Contains utilities used by ASP.NET Core Code Generation packages.
 56
Microsoft.VisualStudio.Web.CodeGeneration
Contains the CodeGenCommand that finds the appropriate code generator and invokes it from project dependencies.
 54
Nuke.Common
Cross-platform build automation system
 51
Nuke.Common
Cross-platform build automation system
 48
Nuke.Common
Cross-platform build automation system
 47
Nuke.Common
Cross-platform build automation system
 46
Nuke.Common
Cross-platform build automation system
 44
Nuke.Common
Cross-platform build automation system
 41
Nuke.Common
Cross-platform build automation system Signed by signpath.io from repository 'https://github.com/nuke-build/nuke' commit '39132f3fb1fea9f889894dfe520cf4434d6eca4e' (see contained AppVeyorSettings.json file for build settings).
 40
Nuke.Common
Cross-platform build automation system Signed by signpath.io from repository 'https://github.com/nuke-build/nuke' commit 'a69c742b7862fb624781dc20b2d9b8c088e98410' (see contained AppVeyorSettings.json file for build settings).
 40
Nuke.Common
Cross-platform build automation system
 40
Microsoft.VisualStudio.Web.CodeGeneration
Contains the CodeGenCommand that finds the appropriate code generator and invokes it from project dependencies.
 40
Microsoft.VisualStudio.Web.CodeGeneration.Utils
Contains utilities used by ASP.NET Core Code Generation packages.
 39
Nuke.Common
Cross-platform build automation system
 39
Microsoft.VisualStudio.Web.CodeGeneration.Utils
Contains utilities used by ASP.NET Core Code Generation packages.
 38
Nuke.Common
Cross-platform build automation system
 37
Nuke.Common
Cross-platform build automation system Signed by signpath.io from repository 'https://github.com/nuke-build/nuke' commit '4a24cd4e78d43b59deb8aa2033c696c8ceb51dd6' (see contained AppVeyorSettings.json file for build settings).
 36

.NET Framework 4.7.2

.NET 5.0

.NET Standard 2.0

Version Downloads Last updated
6.12.1 6 11/18/2024
6.12.0 7 11/13/2024
6.11.1 6 10/17/2024
6.11.0 7 08/19/2024
6.11.0-preview.2 11 06/06/2024
6.10.2 8 08/19/2024
6.10.1 12 07/04/2024
6.10.0 9 05/22/2024
6.9.1 13 03/09/2024
6.8.1 12 03/09/2024
6.8.0 8 12/28/2023
6.7.1 12 03/09/2024
6.7.0 11 12/30/2023
6.6.2 14 03/09/2024
6.6.1 6 12/28/2023
6.6.0 7 06/14/2023
6.6.0-preview.3 5 08/29/2023
6.5.1 2 12/03/2024
6.5.0 26 06/13/2023
6.4.3 11 03/09/2024
6.4.2 3 12/28/2023
6.4.0 14 06/13/2023
6.3.4 13 03/09/2024
6.3.3 5 12/28/2023
6.3.1 9 03/02/2023
6.2.4 3 12/30/2023
6.2.2 4 12/13/2024
6.2.1 7 08/09/2022
6.1.0 21 06/13/2023
6.0.6 12 03/09/2024
6.0.5 6 12/28/2023
6.0.3-rc.1 7 08/28/2023
6.0.2 19 06/14/2023
5.11.6 14 03/09/2024
5.11.5 7 01/14/2024
5.11.3 10 04/06/2024
5.11.0 14 03/03/2022
5.10.0 33 07/30/2023
5.9.3 5 06/13/2023
5.8.1 5 06/13/2023
5.7.3-rtm.5 6 08/28/2023
5.7.2 27 06/01/2023
5.6.0 4 12/07/2023
5.5.1 4 06/14/2023
5.4.0 2 06/13/2023
5.3.1 4 06/13/2023
5.2.1 4 06/14/2023
5.1.0 11 06/01/2023
5.0.2 5 06/14/2023
4.9.6 9 06/13/2023
4.8.2 3 10/30/2024
4.7.3 4 06/14/2023
4.6.4 11 06/13/2023
4.5.3 4 06/13/2023
4.4.3 5 06/14/2023
4.3.1 9 06/13/2023
4.2.0 5 06/13/2023
4.1.0 6 06/13/2023
4.0.0 8 06/13/2023
3.5.0 5 10/27/2024
3.4.4-rtm-final 16 06/11/2023
3.4.3 3 06/13/2023
3.3.0 10 02/15/2024
3.2.0 5 10/03/2024