NuGet.Packaging 6.13.2

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
 89
Microsoft.DotNet.Cli.Utils
Package Description
 84
Microsoft.DotNet.Cli.Utils
Package Description
 81
Microsoft.DotNet.Cli.Utils
Microsoft.DotNet.Cli.Utils
 79
Microsoft.DotNet.ProjectModel
Types to model a .NET Project
 75
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 74
Microsoft.DotNet.Cli.Utils
Package Description
 74
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 74
Microsoft.DotNet.Cli.Utils
Package Description
 73
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 71
Microsoft.DotNet.Scaffolding.Shared
Contains interfaces for Project Model and messaging for scaffolding.
 70
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 69
NuGet.Protocol.Core.v3
NuGet Protocol for 3.1.0 servers
 69
NuGet.Protocol
NuGet client library.
 68
Microsoft.DotNet.Cli.Utils
Package Description
 68
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging. Contains only the type forwarders to the new assembly.
 68
NuGet.Protocol.Core.Types
NuGet's protocol-level base types used for connecting to API v2 and API v3 repositories.
 68

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

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