GRUKE v10.3.0 & v10.3.1

v10.3.0:

• Added KiotaTasks, a NUKE CLI tool wrapper for microsoft/kiota.
  • Example usage can be found in this very project, as I added this to generate the API client in GreemDev.Nuke.Components.Forgejo.
  • usage; generated output
• Forgejo Actions workflow generation & CI environment support
  • Access environment variables defined in their documentation in your C# code in a type-safe manner with documentation for each variable.
  • Due to Forgejo Actions' overwhelming similarities to GitHub Actions, I was able to maintain practically 1:1 feature parity with the GitHub Actions generator.
    • The only missing feature (as far as I can tell, and only that I could have possibly encountered) is the lack of a permissions YAML block.
  • Explicit support was added to support the limits of the Codeberg public FJA runners, as well as a class containing constants for them: CodebergRunners
  • To provide GitHub Actions familiarity, Forgejo exposes GITHUB_-prefixed environment variables. However, Forgejo also exposes FORGEJO_-prefixed variables, while GitHub does not.
    • As a result, Forgejo Actions is no longer treated as being a GitHub Actions environment.
    • If you relied on this functionality you will need to replace your usages of GitHubActions with ForgejoActions where relevant.
• Woodpecker CI workflow generation & CI environment support
  • Woodpecker has no first-party job artifacts functionality, expecting you to use a plugin to provide that.
    • The only plugins I could find require some form of external storage solution, meaning you (the user of Woodpecker) is responsible for managing your own artifacts bin.
  • As a result, this is mostly only useful as a linter/tester on its own.
  • You have access to Forge-specific APIs in the new GreemDev.Nuke.Components.{GitHub, Forgejo, GitLab} NuGet packages.
    • You can use these to create releases. The Woodpecker CI generator has support for importing secrets.
      • ICreateGitHubRelease has moved to GreemDev.Nuke.Components.GitHub
      • ICreateForgejoRelease has been added to GreemDev.Nuke.Components.Forgejo, and works identically to GitHub; except where it had GitHub it has Forgejo now, what a surprise.
      • ICreateGitLabRelease has been added to GreemDev.Nuke.Components.GitLab, and is more complex, expecting a Name, Version, and PackageName.
        • GitLab works differently to GitHub & Forgejo; it does not have a dedicated "release assets" feature.
          • The solution we use is to upload to the Generic Package repository, then create a release that links to all the files in the GPR package version.
          • Requires your GitLab project to have Releases and Package Registry enabled.
      • These component interfaces do not need to be used on Woodpecker.
• Moved GitterTasks to the namespace Nuke.Common.Tools.Gitter.
• SetBranch on GitRepository has been removed; use GitRepository.ModifyCopy(branch: ...) instead.
• Removed ShutdownDotNetAfterServerBuild attribute, it existed due to the .NET CLI's lack of ability for forcibly disabling the use of build servers.
  • .NET has since added this, as such the attribute has been removed and its behavior has been nativized.
  • You can re-enable build servers (not possible before) by setting your NukeBuild's DisableDotNetBuildServers property to true.
• Dusted off the old Notifications system that existed in the project and hooked it up to a notifications JSON file I control.
  • Probably will use this to notify about breaking changes.
  • Notifications display after a build.
  • Support has also been added to DisableDefaultOutputAttribute to fully block displaying notifications at all. This will also skip requesting them.
• Removed Telemetry
  • And removed the page on the docs about it.
• nuke-build#1321: fix: Allow UTF-8 console input
  • Thanks, @rus-art!

v10.3.1:

• Exposed JSON payload in ForgejoActions CI class.