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
 97
Microsoft.DotNet.Cli.Utils
Package Description
 88
Microsoft.DotNet.Cli.Utils
Microsoft.DotNet.Cli.Utils
 84
Microsoft.DotNet.Cli.Utils
Package Description
 79
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 78
Microsoft.DotNet.ProjectModel
Types to model a .NET Project
 78
Microsoft.DotNet.Cli.Utils
Package Description
 78
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 77
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 77
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
 75
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 75
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
 74
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 74
Microsoft.DotNet.Cli.Utils
Package Description
 73
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 73
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 73
NuGet.Protocol
NuGet client library.
 73
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 72

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

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