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
 102
Microsoft.DotNet.Cli.Utils
Package Description
 93
Microsoft.DotNet.Cli.Utils
Package Description
 91
Microsoft.DotNet.Cli.Utils
Microsoft.DotNet.Cli.Utils
 88
Microsoft.DotNet.Cli.Utils
Package Description
 84
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 83
Microsoft.DotNet.Cli.Utils
Package Description
 83
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 82
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 81
Microsoft.DotNet.ProjectModel
Types to model a .NET Project
 81
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 81
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
 80
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 80
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 78
Microsoft.DotNet.Cli.Utils
Package Description
 78
NuGet.Protocol
NuGet client library.
 77
Microsoft.DotNet.Cli.Utils
Package Description
 77

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

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