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

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

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