NuGet.Packaging 6.14.0

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
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 119
Microsoft.DotNet.Cli.Utils
Package Description
 112
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
 108
Microsoft.DotNet.Cli.Utils
Package Description
 106
Microsoft.DotNet.Cli.Utils
Microsoft.DotNet.Cli.Utils
 106
NuGet.Protocol
NuGet client library.
 104
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 103
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
 102
Microsoft.DotNet.Cli.Utils
Package Description
 102
NuGet.Protocol
NuGet client library.
 100
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging.
 100
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 100
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 99
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 99
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging.
 99
Microsoft.DotNet.Cli.Utils
Package Description
 98
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 98
Microsoft.DotNet.ProjectModel
Types to model a .NET Project
 97
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 97

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

Version Downloads Last updated
6.14.0 42 5/15/2025
6.13.2 56 2/28/2025
6.13.1 73 2/14/2025
6.12.4 64 5/9/2025
6.12.1 70 11/17/2024
6.12.0 56 11/19/2024
6.11.1 61 10/6/2024
6.11.0 65 8/15/2024
6.11.0-preview.2 63 6/5/2024
6.10.2 68 8/15/2024
6.10.1 65 6/28/2024
6.10.0 59 6/5/2024
6.9.1 70 2/23/2024
6.8.1 75 2/21/2024
6.8.0 76 11/18/2023
6.7.1 63 2/23/2024
6.7.0 99 8/18/2023
6.6.2 67 2/23/2024
6.6.1 102 7/30/2023
6.6.0 75 5/20/2023
6.6.0-preview.3 73 5/20/2023
6.5.1 68 7/21/2023
6.5.0 77 2/24/2023
6.4.3 65 2/21/2024
6.4.2 99 8/4/2023
6.4.0 80 12/6/2022
6.3.4 79 2/23/2024
6.3.3 76 8/4/2023
6.3.1 80 11/14/2022
6.3.0 88 9/17/2022
6.2.4 84 8/4/2023
6.2.2 71 11/16/2022
6.2.1 82 6/30/2022
6.2.0 79 6/30/2022
6.1.0 78 6/30/2022
6.0.6 67 2/23/2024
6.0.5 73 8/4/2023
6.0.3-rc.1 71 11/25/2022
6.0.2 103 6/30/2022
6.0.0 78 6/30/2022
6.0.0-preview.4.243 81 6/30/2022
6.0.0-preview.3 75 6/30/2022
5.11.6 67 2/23/2024
5.11.5 76 8/1/2023
5.11.3 96 10/13/2022
5.11.2 89 6/30/2022
5.11.0 80 6/30/2022
5.10.0 102 6/30/2022
5.10.0-preview.2.7185 67 6/30/2022
5.9.3 89 11/25/2022
5.9.2 95 6/30/2022
5.9.1 93 6/30/2022
5.9.0 83 6/30/2022
5.9.0-preview.2 72 6/30/2022
5.8.1 96 6/30/2022
5.8.0 97 6/30/2022
5.8.0-preview.3.6823 64 6/30/2022
5.8.0-preview.2.6776 66 6/30/2022
5.8.0-preview.1 112 6/30/2022
5.7.3-rtm.5 76 12/7/2022
5.7.2 85 6/30/2022
5.7.1 72 6/30/2022
5.7.0 77 6/30/2022
5.7.0-rtm.6702 76 6/30/2022
5.7.0-preview.3.6653 84 6/30/2022
5.7.0-preview.2.6618 75 6/30/2022
5.7.0-preview.1.6592 71 6/30/2022
5.6.0 86 6/30/2022
5.6.0-preview.3.6558 84 6/30/2022
5.6.0-preview.2.6489 81 6/30/2022
5.6.0-preview.1.6483 75 6/30/2022
5.5.1 73 6/30/2022
5.5.0 81 6/30/2022
5.5.0-preview.2.6382 89 6/30/2022
5.5.0-preview.1.6319 78 6/30/2022
5.4.0 73 6/30/2022
5.3.1 98 6/30/2022
5.3.0 81 6/30/2022
5.3.0-rtm.6192 81 6/30/2022
5.2.1 79 6/30/2022
5.2.0 89 6/30/2022
5.1.0 94 6/30/2022
5.1.0-preview2.5965 71 6/30/2022
5.0.2 113 6/30/2022
5.0.0 88 6/30/2022
5.0.0-rtm.5867 75 6/30/2022
5.0.0-rtm.5856 72 6/30/2022
5.0.0-preview3.5800 76 6/30/2022
5.0.0-preview2.5782 74 6/30/2022
4.9.6 117 10/13/2022
4.9.5 74 6/30/2022
4.9.4 93 6/30/2022
4.9.3 103 6/30/2022
4.9.2 78 6/30/2022
4.9.2-rtm.5706 78 6/30/2022
4.9.1 77 6/30/2022
4.9.0-rtm.5658 71 6/30/2022
4.8.2 77 6/30/2022
4.8.0 107 6/30/2022
4.8.0-rtm.5362 71 6/30/2022
4.8.0-preview3.5278 82 6/30/2022
4.8.0-preview1.5156 71 6/30/2022
4.7.3 93 6/30/2022
4.7.2 81 6/30/2022
4.7.0 99 6/30/2022
4.7.0-rtm.5148 66 6/30/2022
4.7.0-rtm.5104 77 6/30/2022
4.7.0-preview4.5065 75 6/30/2022
4.7.0-preview1-4986 72 6/30/2022
4.6.4 86 6/30/2022
4.6.3 75 6/30/2022
4.6.2 74 6/30/2022
4.6.1 113 6/30/2022
4.6.0 94 6/30/2022
4.6.0-rtm-4918 59 6/30/2022
4.6.0-rtm-4825 78 6/30/2022
4.6.0-rtm-4791 76 6/30/2022
4.5.3 104 6/30/2022
4.5.2 70 6/30/2022
4.5.0 100 6/30/2022
4.5.0-rtm-4651 67 6/30/2022
4.4.3 76 6/30/2022
4.4.2 77 6/30/2022
4.4.0 79 6/30/2022
4.4.0-preview3-4475 114 6/30/2022
4.3.1 115 6/30/2022
4.3.0 128 6/30/2022
4.3.0-rtm-4324 71 6/30/2022
4.3.0-preview4 79 6/30/2022
4.3.0-preview3-4168 68 6/30/2022
4.3.0-beta1-2418 103 6/30/2022
4.2.0 74 6/30/2022
4.1.0 75 6/30/2022
4.0.0 73 6/30/2022
4.0.0-rtm-2283 77 6/30/2022
4.0.0-rtm-2265 74 6/30/2022
4.0.0-rc3 88 6/30/2022
4.0.0-rc2 98 6/30/2022
4.0.0-rc-2048 73 6/30/2022
3.5.0 80 6/30/2022
3.5.0-rc1-final 72 6/30/2022
3.5.0-beta2-1484 70 6/30/2022
3.5.0-beta-final 84 6/30/2022
3.4.4-rtm-final 79 6/30/2022
3.4.4-rc 84 6/30/2022
3.4.3 78 6/29/2022
3.3.0 92 6/29/2022
3.2.0 74 6/29/2022
1.0.0-pre-20150220044603 88 6/29/2022
1.0.0-pre-20150128082032 67 6/29/2022
1.0.0-pre-20150128071326 70 6/29/2022
1.0.0-pre-20150127085617 84 6/29/2022
1.0.0-pre-20150127072405 69 6/29/2022
1.0.0-pre-20150120213149 89 6/29/2022
1.0.0-pre-20150120004808 70 6/29/2022
1.0.0-pre-20150115030027 90 6/29/2022
1.0.0-pre-20150109221036 100 6/29/2022
1.0.0-pre-20150108074227 75 6/29/2022
1.0.0-pre-20150108073125 86 6/29/2022
1.0.0-pre-20150108010629 74 6/29/2022
1.0.0-master-50072333 73 6/29/2022
1.0.0-master-50060114 65 6/29/2022
1.0.0-master-50050213 80 6/29/2022
1.0.0-master-43652058 68 6/29/2022
1.0.0-master-43642026 82 6/29/2022
1.0.0-master-43522145 71 6/29/2022
1.0.0-master-43500148 71 6/29/2022
1.0.0-master-43450313 73 6/29/2022
1.0.0-master-43440912 68 6/29/2022
1.0.0-master-43422320 74 6/29/2022
1.0.0-master-43421050 95 6/29/2022
1.0.0-master-43421019 67 6/29/2022
1.0.0-master-43402220 84 6/29/2022
1.0.0-master-43362332 76 6/29/2022
1.0.0-master-43362323 72 6/29/2022
1.0.0-master-43250244 80 6/29/2022
1.0.0-master-43250241 89 6/29/2022
1.0.0-master-43250237 72 6/29/2022
1.0.0-master-43250218 98 6/29/2022
1.0.0-juste-43290204 96 6/29/2022