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
 103
Microsoft.DotNet.Cli.Utils
Package Description
 96
Microsoft.DotNet.Cli.Utils
Package Description
 95
Microsoft.DotNet.Cli.Utils
Microsoft.DotNet.Cli.Utils
 90
Microsoft.DotNet.Cli.Utils
Package Description
 87
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 86
Microsoft.DotNet.Cli.Utils
Package Description
 86
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
 85
Microsoft.DotNet.ProjectModel
Types to model a .NET Project
 84
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 83
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 83
Microsoft.VisualStudio.Web.CodeGenerators.Mvc
Code Generators for ASP.NET Core MVC. Contains code generators for MVC Controllers and Views.
 83
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 82
NuGet.Protocol
NuGet client library.
 82
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging.
 81
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 81
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 80

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

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