UnNuGetizer 1.1.0

Suggested Alternatives

NuGetizer

Additional Details

NuGetizer no longer uses SponsorLink, obsoleting this package's purpose for existence.

dotnet add package UnNuGetizer --version 1.1.0                
NuGet\Install-Package UnNuGetizer -Version 1.1.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="UnNuGetizer" Version="1.1.0">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add UnNuGetizer --version 1.1.0                
#r "nuget: UnNuGetizer, 1.1.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install UnNuGetizer as a Cake Addin
#addin nuget:?package=UnNuGetizer&version=1.1.0

// Install UnNuGetizer as a Cake Tool
#tool nuget:?package=UnNuGetizer&version=1.1.0                

NuGetizer is a drop-in replacement for the .NET SDK built-in Pack (a.k.a. "SDK Pack") which instantly supercharges your ability to customize and extend the packing process in a consistent and easy to understand process designed and centered around best practices in MSBuild design and extensibility.

Yes, this means you'll never need to write a .nuspec by hand ever again, no matter how complicated or advanced your packing scenarios are.

Comprehensive and intuitive heuristics built from experience building nuget packages for over a decade make getting started with NuGetizer seamless and easy, while still accomodating the most advanced scenarios through plain MSBuild extensibility. Out of the box, NuGetizer supports:

  • Drop-in replacement for the built-in .NET SDK Pack
  • Packing project references (including transitive references)
  • Straightforward support for smart libraries packing needs
  • Packing multi-targeted projects, including framework-specific resources and dependencies
  • Fast iterative development with complementary dotnet-nugetize command line tool
  • Comprehensive diagnostic analyzers to provide guidance on packing best practices
  • Consistent and predictable naming for package content inference behaviors:
    • Pack=[true|false] ⇒ Include/exclude from package (on any item, such as PackageReference, ProjectReference, None, Content, etc.)
    • PackFolder=[folder] ⇒ Name of known folders with special behavior, such as Lib, Build, Content, Tools, etc. (as a project property or item metadata)
    • PackagePath=[path] ⇒ Package-relative path (on any item, such as None, Content, etc.)
    • Pack[Item Type]=[true|false] ⇒ Set default pack behavior for all items of a given type via simple properties (such as PackNone, PackContent, PackBuildOutput, PackDependencies, PackFrameworkReferences, PackEmbeddedResource, PackResource etc.)
  • Packaging projects using .msbuildproj and Microsoft.Build.NoTargets SDK
  • SourceLink support to populate repository information in the package
  • Automatic readme.md inclusion in the package
  • Support for content includes in readme
  • Package validation enabled by default for release multi-targeting packages.

It's strongly recommended that you install the dotnet-nugetize tool to get the best experience with NuGetizer:

dotnet tool install -g dotnet-nugetize

Given the following project:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <GenerateDocumentationFile>true</GenerateDocumentationFile>

    <PackageId>Quickstart</PackageId>
    <Authors>NuGetizer</Authors>
    <Description>NuGetized quickstart</Description>

    <PublishRepositoryUrl>true</PublishRepositoryUrl>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="NuGetizer" />
    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" 
                      PrivateAssets="all" />
    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
  </ItemGroup>

  <ItemGroup>
    <None Include="none.txt" Pack="true" />
    <Content Include="content.txt" Pack="true" />
    <Compile Update="@(Compile)" Pack="true" />
  </ItemGroup>

</Project>

Running nugetize on the project directory will produce:

nugetize quickstart

A typical packaging .msbuildproj project for a smart multi-targeted library might look like the following:

<Project Sdk="Microsoft.Build.NoTargets/3.7.0">

  <PropertyGroup>
    <PackageId>Quickstart</PackageId>
    <TargetFramework>netstandard2.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="NuGetizer" />
    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" 
                      PrivateAssets="all" />
  </ItemGroup>

  <ItemGroup>
    <ProjectReference Include="..\Analyzer\Quickstart.CodeAnalysis.csproj" />
    <ProjectReference Include="..\Build\Quickstart.Tasks.csproj" />
    <ProjectReference Include="..\Lib\Quickstart.csproj" />
    <ProjectReference Include="..\Tools\Quickstart.csproj" />
  </ItemGroup>

</Project>

And produce the following nugetize tool output:

nugetize smart library

You can open this sample and run it directly in your browser in a GitHub Codespace

Learn more about NuGetizer and its capabilities from the project documentation site.

Sponsors

Clarius Org Kirill Osenkov MFB Technologies, Inc. Stephen Shaw Torutek DRIVE.NET, Inc. David Kean alternate text is missing from this package README image Daniel Gnägi Ashley Medway Keith Pickford bitbonk Thomas Bolon Yurii Rashkovskii Kori Francis Zdenek Havlin Sean Killeen Toni Wenzel Giorgi Dalakishvili Kelly White Allan Ritchie Mike James Uno Platform Dan Siegel Reuben Swartz Jeremy Simmons Jacob Foshee alternate text is missing from this package README image Eric Johnson Norman Mackay Certify The Web Taylor Mansfield Mårten Rånge David Petric Rich Lee Danilo Dantas alternate text is missing from this package README image Gary Woodfine alternate text is missing from this package README image alternate text is missing from this package README image Steve Bilogan Ix Technologies B.V. New Relic Chris Johnston‮ David JENNI alternate text is missing from this package README image Jonathan Oleg Kyrylchuk Juan Blanco LosManos Mariusz Kogut Charley Wu alternate text is missing from this package README image Thomas Due Jakob Tikjøb Andersen Seann Alexander Tino Hager Badre BSAILA Mark Seemann Angelo Belchior Tony Qu Daniel May Blauhaus Technology (Pty) Ltd Richard Collette Nick Vaughan Ken Bonny

Sponsor this project  

Learn more about GitHub Sponsors

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on UnNuGetizer:

Repository Stars
MonoMod/MonoMod
C# modding swiss army knife, powered by cecil.