NuGet.Packaging 6.11.1

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
Microsoft.VisualStudio.Web.CodeGeneration.Utils
Contains utilities used by ASP.NET Core Code Generation packages.
 67
Microsoft.VisualStudio.Web.CodeGeneration.Utils
Contains utilities used by ASP.NET Core Code Generation packages.
 77
NuGet.Packaging.Core
The (former home to) core data structures for NuGet.Packaging.
 83
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
NuGet client library.
 66
NuGet.Protocol
NuGet client library.
 71
NuGet.Protocol
NuGet client library.
 72
NuGet.Protocol
NuGet client library.
 73
NuGet.Protocol
NuGet client library.
 80
NuGet.Protocol
NuGet client library.
 81
NuGet.Protocol
NuGet client library.
 84
NuGet.Protocol
NuGet client library.
 85
NuGet.Protocol
NuGet client library.
 90
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 64
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 67
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 75
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 82
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 83
NuGet.Protocol
NuGet's implementation for interacting with feeds. Contains functionality for all feed types.
 92

.NET Framework 4.7.2

.NET 5.0

.NET Standard 2.0

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