ByteDev.Nuget.Nuspec 1.0.1

.NET Standard library for reading nuget nuspec manifest files.

Install-Package ByteDev.Nuget.Nuspec -Version 1.0.1
dotnet add package ByteDev.Nuget.Nuspec --version 1.0.1
<PackageReference Include="ByteDev.Nuget.Nuspec" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ByteDev.Nuget.Nuspec --version 1.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ByteDev.Nuget.Nuspec

.NET Standard library for reading nuget nuspec manifest files.

Installation

ByteDev.Nuget.Nuspec has been written as a .NET Standard 2.0 library, so you can consume it from a .NET Core or .NET Framework 4.6.1 (or greater) application.

ByteDev.Nuget.Nuspec is hosted as a package on nuget.org. To install from the Package Manager Console in Visual Studio run:

Install-Package ByteDev.Nuget.Nuspec

Further details can be found on the nuget page.

Release Notes

Releases follow semantic versioning.

Full details of the release notes can be viewed on GitHub.

Usage

The primary type in the ByteDev.Nuget.Nuspec package is NuspecManifest.

NuspecManifest can either be instantiated directly from an existing XDocument on it's constructor or by loading a nuspec file using the Load method.

// Load a manifest from file
NuspecManifest nuspec = NuspecManifest.Load(@"C:\MyProj\MyApp.nuspec");

Console.WriteLine(nuspec.MetaData.Id);
Console.WriteLine(nuspec.MetaData.Version);
Console.WriteLine(nuspec.MetaData.Description);
Console.WriteLine(nuspec.MetaData.Authors.First());
Console.WriteLine(nuspec.Files.Count());

NuspecManifest will enforce the currently mandatory elements of a valid nuspec XML file. Upon any mandatory elements missing a InvalidNuspecManifestException will be thrown.

As of writing the minimum valid nuspec XML manifest contains a root package element with metadata child element with id, version, description and authors child elements.

Example minimum valid nuspec XML manifest:

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>MyTestPackage</id>
    <version>1.0.0</version>
    <description>My test package.</description>
    <authors>John Smith, Bob Smith</authors>
  </metadata>
</package>

Not supported elements

The following metadata elements are not supported as they have now been deprecated:

  • licenseUrl (use license instead)
  • iconUrl (use icon instead)
  • summary (use description instead)

If any exist in the nuspec manifest they will simply be ignored.

ByteDev.Nuget.Nuspec

.NET Standard library for reading nuget nuspec manifest files.

Installation

ByteDev.Nuget.Nuspec has been written as a .NET Standard 2.0 library, so you can consume it from a .NET Core or .NET Framework 4.6.1 (or greater) application.

ByteDev.Nuget.Nuspec is hosted as a package on nuget.org. To install from the Package Manager Console in Visual Studio run:

Install-Package ByteDev.Nuget.Nuspec

Further details can be found on the nuget page.

Release Notes

Releases follow semantic versioning.

Full details of the release notes can be viewed on GitHub.

Usage

The primary type in the ByteDev.Nuget.Nuspec package is NuspecManifest.

NuspecManifest can either be instantiated directly from an existing XDocument on it's constructor or by loading a nuspec file using the Load method.

// Load a manifest from file
NuspecManifest nuspec = NuspecManifest.Load(@"C:\MyProj\MyApp.nuspec");

Console.WriteLine(nuspec.MetaData.Id);
Console.WriteLine(nuspec.MetaData.Version);
Console.WriteLine(nuspec.MetaData.Description);
Console.WriteLine(nuspec.MetaData.Authors.First());
Console.WriteLine(nuspec.Files.Count());

NuspecManifest will enforce the currently mandatory elements of a valid nuspec XML file. Upon any mandatory elements missing a InvalidNuspecManifestException will be thrown.

As of writing the minimum valid nuspec XML manifest contains a root package element with metadata child element with id, version, description and authors child elements.

Example minimum valid nuspec XML manifest:

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>MyTestPackage</id>
    <version>1.0.0</version>
    <description>My test package.</description>
    <authors>John Smith, Bob Smith</authors>
  </metadata>
</package>

Not supported elements

The following metadata elements are not supported as they have now been deprecated:

  • licenseUrl (use license instead)
  • iconUrl (use icon instead)
  • summary (use description instead)

If any exist in the nuspec manifest they will simply be ignored.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
1.0.1 109 8/4/2020
1.0.0 112 7/21/2020