Merge branch 'release/8.0.0'

Author: matkoch

.gitlab-ci.yml

@@ -1,4 +1,4 @@
-image: mcr.microsoft.com/dotnet/sdk:5.0
+image: mcr.microsoft.com/dotnet/sdk:8.0
 
 variables:
   GIT_DEPTH: 0

.space.kts

@@ -22,7 +22,7 @@ job("continuous") {
         }
     }
 
-    container("mcr.microsoft.com/dotnet/sdk:6.0") {
+    container("mcr.microsoft.com/dotnet/sdk:8.0") {
         shellScript {
             content = "./build.sh Test"
         }

CHANGELOG.md

@@ -6,6 +6,29 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [vNext]
 
+## [8.0.0] / 2024-01-18
+- Changed string parameters to violate requirement when empty or whitespace
+- Added on-demand value injection using `OnDemandAttribute` and `OnDemandValueInjectionAttribute`
+- Added `AbsolutePath` division operator for `..` range expression
+- Added `DOTNET_NOLOGO` to bootstrapping files
+- Fixed `BinaryFormatterSerialization` warning by suppression
+- Fixed .NET SDK discovery in bootstrapping files
+- Fixed quotation for bootstrapping script invocation
+- Fixed filtering on `FileAttributes`
+- Fixed quoting in `AppVeyor` generation
+- Fixed members in `AzurePipelinesImage`
+- Fixed members in `GitHubActionsImage`
+- Fixed lower-case naming in `DotNetVerbosity` members
+- Fixed missing `DotNetTasks` commands
+- Fixed missing `EntityFrameworkTasks` command
+- Fixed logging in `NpmTasks`
+- Fixed argument type in `OctopusTasks`
+- Fixed missing argument in `SonarScannerTasks`
+- Fixed value formatting in `SonarScannerTasks`
+- Fixed members in `NUnitLabelType`
+- Fixed deprecated argument in `NUnitTasks`
+- Fixed members in `ReportGeneratorReportTypes`
+
 ## [7.0.6] / 2023-09-24
 - Fixed logging of Docker target execution to fall back to debug messages
 
@@ -1103,7 +1126,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Added CLT tasks for Git
 - Fixed background color in console output
 
-[vNext]: https://github.com/nuke-build/nuke/compare/7.0.6...HEAD
+[vNext]: https://github.com/nuke-build/nuke/compare/8.0.0...HEAD
+[8.0.0]: https://github.com/nuke-build/nuke/compare/7.0.6...8.0.0
 [7.0.6]: https://github.com/nuke-build/nuke/compare/7.0.5...7.0.6
 [7.0.5]: https://github.com/nuke-build/nuke/compare/7.0.4...7.0.5
 [7.0.4]: https://github.com/nuke-build/nuke/compare/7.0.3...7.0.4

CONTRIBUTING.md

@@ -29,7 +29,6 @@ There are a number of minimal to zero efforts you can make to show your support
 - Follow [@nukebuildnet](https://twitter.com/nukebuildnet) and [@nuke@dotnet.social](https://dotnet.social/@nuke)
 - Upvote, share, and comment our content (see [#mentions](https://app.slack.com/client/T9QUKHC4A/CDJD8CGQ5) on Slack)
 - Talk about NUKE on social media and let others know where it can help (tag us!)
-- Give ratings where possible (e.g., extensions for [Rider](https://plugins.jetbrains.com/plugin/10803-nuke-support/reviews) or [Visual Studio](https://marketplace.visualstudio.com/items?itemName=nuke.visualstudio&ssr=false#review-details)) 
 
 The above points are considered somewhat of the norm in exchange for using the project free of charge.
 

Dockerfile

@@ -1,7 +1,7 @@
 # docker build --no-cache --progress=plain -t my-image .
 ARG registryUrl
 
-FROM mcr.microsoft.com/dotnet/sdk:6.0 AS builder
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS builder
 
 WORKDIR /
 COPY ./ /code

README.md

@@ -84,6 +84,7 @@ Thanks to all companies, organizations, and individuals who are sponsoring the f
 [![Daniel Valadas](https://avatars.githubusercontent.com/valadas?s=60&v=4)](https://github.com/valadas)
 [![Anton Wieslander](https://avatars.githubusercontent.com/T0shik?s=60&v=4)](https://github.com/T0shik)
 [![business//acts](https://avatars.githubusercontent.com/BusinessActs?s=60&v=4)](https://github.com/BusinessActs)
+[![Petabridge](https://avatars.githubusercontent.com/petabridge?s=60&v=4)](https://github.com/petabridge)
 [![Steven Kuhn](https://avatars.githubusercontent.com/stevenkuhn?s=60&v=4)](https://github.com/stevenkuhn)
 
 [![Stephan Müller](https://avatars.githubusercontent.com/chaquotay?s=45&v=4)](https://github.com/chaquotay)
@@ -96,6 +97,8 @@ Thanks to all companies, organizations, and individuals who are sponsoring the f
 [![Derek Beattie](https://avatars.githubusercontent.com/dbeattie71?s=45&v=4)](https://github.com/dbeattie71)
 [![Andrei Andreev](https://avatars.githubusercontent.com/Razenpok?s=45&v=4)](https://github.com/Razenpok)
 [![patrik53](https://avatars.githubusercontent.com/patrik53?s=45&v=4)](https://github.com/patrik53)
+[![Cesare Caoduro](https://avatars.githubusercontent.com/Cesare-Caoduro_aecom?s=45&v=4)](https://github.com/Cesare-Caoduro_aecom)
+[![Kirill Osenkov](https://avatars.githubusercontent.com/KirillOsenkov?s=45&v=4)](https://github.com/KirillOsenkov)
 [<img height="45px" src="https://images.opencollective.com/archon-systems-inc/85fa9b1/logo/256.png" alt="Archon Systems Inc." />](https://opencollective.com/archon-systems-inc/)
 [<img height="45px" src="https://images.opencollective.com/bitzer-electronics-as/39862ac/logo/256.png" alt="BITZER Electronics A/S" />](https://opencollective.com/bitzer-electronics-as)
 
@@ -104,3 +107,7 @@ Thanks to all companies, organizations, and individuals who are sponsoring the f
 Thanks to [JetBrains](https://jetbrains.com) for providing licenses for [Rider](https://jetbrains.com/rider) and access to a [TeamCity Cloud](https://jetbrains.com/teamcity) instance, which both make open-source development a real pleasure!
 
 [<img src="https://raw.githubusercontent.com/nuke-build/nuke/develop/images/jetbrains.png" width="450" />](https://jetbrains.com/)
+
+Thanks to [SignPath](https://signpath.io?utm_source=foundation&utm_medium=github&utm_campaign=nukebuild) for providing free code signing service and to the [SignPath Foundation](https://signpath.org?utm_source=foundation&utm_medium=github&utm_campaign=nukebuild) for a free code signing certificate.
+
+[<img src="https://raw.githubusercontent.com/SignPath/website/3168d6c7f0e60e647c13fd746df18b52cd52f59c/docs/assets/logo_signpath_500.png" width="450" />](https://signpath.io?utm_source=foundation&utm_medium=github&utm_campaign=nukebuild)

appveyor.continuous.yml

@@ -31,6 +31,6 @@ build_script:
   - sh: ./build.cmd Test Pack
 
 artifacts:
-  - path: output/test-results/*.trx
-  - path: output/test-results/*.xml
-  - path: output/packages/*.nupkg
+  - path: 'output/test-results/*.trx'
+  - path: 'output/test-results/*.xml'
+  - path: 'output/packages/*.nupkg'

appveyor.yml

@@ -29,9 +29,9 @@ build_script:
   - sh: ./build.cmd Pack Test SignPackages Publish
 
 artifacts:
-  - path: output/packages/*.nupkg
-  - path: output/test-results/*.trx
-  - path: output/test-results/*.xml
+  - path: 'output/packages/*.nupkg'
+  - path: 'output/test-results/*.trx'
+  - path: 'output/test-results/*.xml'
 
 environment:
   PublicNuGetApiKey:

azure-pipelines.qodana.yml

@@ -0,0 +1,15 @@
+pool:
+  vmImage: 'ubuntu-latest'
+
+jobs:
+  - job: QodanaScan
+    displayName: 'Qodana Scan'
+    steps:
+      - task: Cache@2  # Not required, but Qodana will open projects with cache faster.
+        inputs:
+          key: '"$(Build.Repository.Name)" | "$(Build.SourceBranchName)" | "$(Build.SourceVersion)"'
+          path: '$(Agent.TempDirectory)/qodana/cache'
+          restoreKeys: |
+            "$(Build.Repository.Name)" | "$(Build.SourceBranchName)"
+            "$(Build.Repository.Name)"
+      - task: QodanaScan@2023

build.ps1

@@ -20,9 +20,8 @@ $DotNetGlobalFile = "$PSScriptRoot\global.json"
 $DotNetInstallUrl = "https://dot.net/v1/dotnet-install.ps1"
 $DotNetChannel = "STS"
 
-$env:DOTNET_SKIP_FIRST_TIME_EXPERIENCE = 1
 $env:DOTNET_CLI_TELEMETRY_OPTOUT = 1
-$env:DOTNET_MULTILEVEL_LOOKUP = 0
+$env:DOTNET_NOLOGO = 1
 $env:DOTNET_ROLL_FORWARD = "Major"
 $env:NUKE_TELEMETRY_OPTOUT = 1
 
@@ -72,6 +71,7 @@ else {
         ExecSafe { & powershell $DotNetInstallFile -InstallDir $DotNetDirectory -Version $DotNetVersion -NoPath }
     }
     $env:DOTNET_EXE = "$DotNetDirectory\dotnet.exe"
+    $env:PATH = "$DotNetDirectory;$env:PATH"
 }
 
 Write-Output "Microsoft (R) .NET SDK version $(& $env:DOTNET_EXE --version)"

build.sh

@@ -17,8 +17,7 @@ DOTNET_INSTALL_URL="https://dot.net/v1/dotnet-install.sh"
 DOTNET_CHANNEL="STS"
 
 export DOTNET_CLI_TELEMETRY_OPTOUT=1
-export DOTNET_SKIP_FIRST_TIME_EXPERIENCE=1
-export DOTNET_MULTILEVEL_LOOKUP=0
+export DOTNET_NOLOGO=1
 export DOTNET_ROLL_FORWARD="Major"
 export NUKE_TELEMETRY_OPTOUT=1
 
@@ -65,6 +64,7 @@ else
         "$DOTNET_INSTALL_FILE" --install-dir "$DOTNET_DIRECTORY" --version "$DOTNET_VERSION" --no-path
     fi
     export DOTNET_EXE="$DOTNET_DIRECTORY/dotnet"
+    export PATH="$DOTNET_DIRECTORY:$PATH"
 fi
 
 echo "Microsoft (R) .NET SDK version $("$DOTNET_EXE" --version)"

build/Build.CI.SpaceAutomation.cs

@@ -7,7 +7,7 @@
 
 [SpaceAutomation(
     name: "continuous",
-    image: "mcr.microsoft.com/dotnet/sdk:6.0",
+    image: "mcr.microsoft.com/dotnet/sdk:8.0",
     OnPush = true,
     InvokedTargets = new[] { nameof(ITest.Test) })]
 partial class Build

build/Build.ReleaseImage.cs

@@ -71,7 +71,7 @@ partial class Build
                 .DrawText(
                     text: "New Release".ToUpperInvariant(),
                     color: Color.WhiteSmoke,
-                    textOptions: new TextOptions(thinFont.CreateFont(100))
+                    textOptions: new RichTextOptions(thinFont.CreateFont(100))
                                  {
                                      Origin = new PointF(image.Width / 2f, image.Height / 2f - 120),
                                      HorizontalAlignment = HorizontalAlignment.Center,
@@ -80,7 +80,7 @@ partial class Build
                 .DrawText(
                     text: MajorMinorPatchVersion,
                     color: Color.WhiteSmoke,
-                    textOptions: new TextOptions(boldFont.CreateFont(230))
+                    textOptions: new RichTextOptions(boldFont.CreateFont(230))
                                  {
                                      Origin = new PointF(image.Width / 2f, image.Height / 2f + 60),
                                      HorizontalAlignment = HorizontalAlignment.Center,

build/_build.csproj

@@ -4,7 +4,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <LangVersion>preview</LangVersion>
     <RootNamespace></RootNamespace>
     <NoWarn>CS0649;CS0169</NoWarn>
@@ -53,12 +53,12 @@
 
   <ItemGroup>
     <PackageReference Include="linqtotwitter" Version="6.15.0" />
-    <PackageReference Include="SixLabors.ImageSharp.Drawing" Version="1.0.0-beta14" />
-    <PackageDownload Include="Codecov.Tool" Version="[1.12.3]" />
-    <PackageDownload Include="GitVersion.Tool" Version="[5.8.0]" />
-    <PackageDownload Include="JetBrains.ReSharper.GlobalTools" Version="[2022.3.2]" />
-    <PackageDownload Include="ReportGenerator" Version="[4.6.1]" />
-    <PackageDownload Include="xunit.runner.console" Version="[2.4.1]" />
+    <PackageReference Include="SixLabors.ImageSharp.Drawing" Version="2.0.1" />
+    <PackageDownload Include="Codecov.Tool" Version="[1.13.0]" />
+    <PackageDownload Include="GitVersion.Tool" Version="[5.12.0]" />
+    <PackageDownload Include="JetBrains.ReSharper.GlobalTools" Version="[2023.2.3]" />
+    <PackageDownload Include="ReportGenerator" Version="[5.2.0]" />
+    <PackageDownload Include="xunit.runner.console" Version="[2.6.1]" />
   </ItemGroup>
 
   <ItemGroup>

docs/01-getting-started/01-installation.md

@@ -0,0 +1,39 @@
+---
+title: Installation
+---
+
+Before you can set up a build project, you need to install NUKE's dedicated [.NET global tool](https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools):
+
+```powershell
+# terminal-command
+dotnet tool install Nuke.GlobalTool --global
+```
+
+From now on, you can use the global tool to:
+
+- [Set up new builds](02-setup.md)
+- [Run existing builds](03-execution.md)
+- [Leverage shell completion](../06-global-tool/00-shell-completion.md)
+- [Add tool & library packages](../06-global-tool/01-packages.md)
+- [Navigate around root directories](../06-global-tool/03-navigation.md)
+- [Convert CAKE build scripts](../06-global-tool/04-cake.md)
+- [Manage secrets in parameter files](../06-global-tool/02-secrets.md)
+
+:::note
+If you're running on Linux-based systems, it's worth checking if the `nuke` global tool is available. This can be verified with `where nuke`. If the global tool is not found, you have to manually add `$HOME/.dotnet/tools` to your terminal configuration:
+
+<Tabs>
+  <TabItem value="zsh" label="Zsh" default>
+
+```powershell
+# terminal-command
+echo 'export PATH=$HOME/.dotnet/tools:$PATH' >> ~/.zshrc
+```
+
+  </TabItem>
+</Tabs>
+:::
+
+:::info
+While theoretically, you could use NUKE by only adding its main NuGet package, we highly recommend using the dedicated global tool to set up new builds. This ensures that your repository will run consistently in different environments and that your build implementation is always properly formatted.
+:::