ReleaseGen 0.3.0

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global ReleaseGen --version 0.3.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local ReleaseGen --version 0.3.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=ReleaseGen&version=0.3.0
                    
nuke :add-package ReleaseGen --version 0.3.0
                    

ReleaseGen

Latest NuGet Latest Pre-release NuGet Downloads CI License: MPL-2.0

ReleaseGen is an opinionated .NET CLI for building, packaging, and publishing .NET projects. One strict releasegen.json manifest drives every stage of a release: build, test, package, and publish.

Install

dotnet tool install ReleaseGen -g

Requires the .NET 10 SDK. The tool command is releasegen. Running bare releasegen prints command help; no stage executes without an explicit verb.

Quickstart

# 1. Write a minimal releasegen.json in the current directory
releasegen init

# 2. Edit releasegen.json: name your targets (projects and their artifact kinds),
#    declare runtimeIdentifiers, and optionally add test and publish sections

# 3. Run the pipeline the manifest names, in manifest order
releasegen run

Notes:

  • init is a one-shot command and takes no part in the chained run. It refuses to overwrite an existing manifest unless you pass --overwrite; --preset <name> seeds the manifest's build.preset key.
  • run is the chained run: it executes the stages the manifest names - build always, test when a test section is declared, package and publish when targets declare package kinds - in manifest order, aborting at the first failed stage and noting each skipped stage. The test outcome is carried to publish, so tests never run twice.
  • Each stage is also its own command - releasegen build, releasegen test, releasegen package, releasegen publish - and all of them share the same manifest, discovered by walking up from the current directory.

Build output stays local under a release/ directory; the only network destination is the publish stage's NuGet source. Publishing is gated on your tests: a manifest declaring a test section blocks publish when that stage fails.

Commands

Command Purpose
init Write a minimal manifest (one-shot)
build Publish release binaries per target and runtime identifier
test Run the projects the manifest's test section names
package Pack the package kinds each target declares
publish Push packages to NuGet sources (test-gated)
run Chained run of the stages above, in manifest order

Every command accepts the global --quiet flag; every stage command and run also accept --dry-run and --verbose (which contradict --quiet); exit code is 0 on success and 1 on any failure. See the command reference for flags and behavior.

Documentation

What ReleaseGen isn't

  • A changelog or release notes generator/formatter.
  • A test coverage checker.
  • An artifact uploader: ReleaseGen writes release binaries and archives to a local release/ directory and performs no upload of them.
  • A token broker: ReleaseGen performs no OIDC token acquisition; see the trusted publishing page for the CI-side procedure.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.4.0 94 11/9/2026
0.3.0 102 11/4/2026
0.2.0 113 11/1/2026
0.1.0-alpha.0 75 10/25/2026

# Changes since 0.2.0

## Added

- **`--skip-duplicate` on `publish`** — an opt-in flag, forwarded to every `dotnet nuget push` for the run, that lets the feed itself decide whether a package is a duplicate. When a push exits zero and reports the skip marker, it counts as skipped rather than pushed: the stage logs a note naming the package and source, and the closing summary shows pushed and skipped as two separate totals while still exiting 0. Any other nonzero exit fails the stage as before. Without the flag and without a manifest key, behaviour is unchanged: a duplicate still fails the stage.
- **`skipDuplicates` in the manifest** — set it in the publish section to make skipping your standing behaviour, so you don't have to pass the flag each time. It's absent by default, and the flag always wins over the manifest when both are given, with at most one conflict warning per run.
- **`--skip-duplicate` on `releasegen run`** — the chained run passes the flag along to publish, so a chain and a standalone `releasegen publish` resolve the same decision. Omitting the flag forwards nothing and leaves the run on today's default; `--skip-duplicate` (or `=true`) turns skipping on, and `--skip-duplicate=false` keeps "declared off" distinct from "not specified".

## Changed

- Updated System.CommandLine to 2.0.14, Microsoft.Extensions.DependencyInjection (and Abstractions) to 10.0.14, and Meziantou.Analyzer to 3.0.318.
- Docs for commands, manifest schema, and the glossary now cover the duplicate-push behaviour and the pushed/skipped summary.