Update GitHub actions step- uses: actions/checkout from @v3 to @v4 to switch from Node v 16 to v 20

.github/workflows/alpha-deployment.yml

@@ -26,7 +26,7 @@ jobs:
     name: ubuntu-latest
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: 'Cache: .nuke/temp, ~/.nuget/packages'

.github/workflows/macos-latest.yml

@@ -30,7 +30,7 @@ jobs:
     name: macos-latest
     runs-on: macos-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: 'Cache: .nuke/temp, ~/.nuget/packages'

.github/workflows/ubuntu-latest.yml

@@ -30,7 +30,7 @@ jobs:
     name: ubuntu-latest
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: 'Cache: .nuke/temp, ~/.nuget/packages'

.github/workflows/windows-latest.yml

@@ -30,7 +30,7 @@ jobs:
     name: windows-latest
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: 'Cache: .nuke/temp, ~/.nuget/packages'

build/Build.GlobalSolution.cs

@@ -15,7 +15,6 @@
 using Nuke.Common.Utilities;
 using Nuke.Utilities.Text.Yaml;
 using static Nuke.Common.ControlFlow;
-using static Nuke.Common.IO.FileSystemTasks;
 using static Nuke.Common.ProjectModel.SolutionModelTasks;
 using static Nuke.Common.Tools.Git.GitTasks;
 
@@ -67,18 +66,16 @@ IEnumerable<GitRepository> ExternalRepositories
 
             if ((RootDirectory / $"{Solution.FileName}.DotSettings").FileExists())
             {
-                CopyFile(
-                    source: RootDirectory / $"{Solution.FileName}.DotSettings",
+                (RootDirectory / $"{Solution.FileName}.DotSettings").Copy(
                     target: RootDirectory / $"{global.FileName}.DotSettings",
-                    FileExistsPolicy.Overwrite);
+                    policy: ExistsPolicy.FileOverwrite);
             }
 
             if ((RootDirectory / $"{Solution.FileName}.DotSettings.user").FileExists())
             {
-                CopyFile(
-                    source: RootDirectory / $"{Solution.FileName}.DotSettings.user",
+                (RootDirectory / $"{Solution.FileName}.DotSettings.user").Copy(
                     target: RootDirectory / $"{global.FileName}.DotSettings.user",
-                    FileExistsPolicy.Overwrite);
+                    policy: ExistsPolicy.FileOverwrite);
             }
         });
 }

source/Nuke.Common.Tests/CI/ConfigurationGenerationTest.Test_testName=detailed-triggers_attribute=GitHubActionsAttribute.verified.txt

@@ -53,7 +53,7 @@ jobs:
       group: ${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.run_id }}
       cancel-in-progress: true
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           submodules: recursive
           lfs: true
@@ -96,7 +96,7 @@ jobs:
       group: ${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.run_id }}
       cancel-in-progress: true
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           submodules: recursive
           lfs: true
@@ -139,7 +139,7 @@ jobs:
       group: ${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.run_id }}
       cancel-in-progress: true
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           submodules: recursive
           lfs: true

source/Nuke.Common.Tests/CI/ConfigurationGenerationTest.Test_testName=simple-triggers_attribute=GitHubActionsAttribute.verified.txt

@@ -27,7 +27,7 @@ jobs:
     name: macos-latest
     runs-on: macos-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: 'Cache: .nuke/temp, ~/.nuget/packages'
         uses: actions/cache@v4
         with:
@@ -59,7 +59,7 @@ jobs:
     name: ubuntu-latest
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: 'Cache: .nuke/temp, ~/.nuget/packages'
         uses: actions/cache@v4
         with:
@@ -91,7 +91,7 @@ jobs:
     name: windows-latest
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: 'Cache: .nuke/temp, ~/.nuget/packages'
         uses: actions/cache@v4
         with:

source/Nuke.Common/CI/GitHubActions/Configuration/GitHubActionsCheckoutStep.cs

@@ -18,7 +18,7 @@ public class GitHubActionsCheckoutStep : GitHubActionsStep
 
     public override void Write(CustomFileWriter writer)
     {
-        writer.WriteLine("- uses: actions/checkout@v3");
+        writer.WriteLine("- uses: actions/checkout@v4");
 
         if (Submodules.HasValue || Lfs.HasValue || FetchDepth.HasValue)
         {

source/Nuke.Common/IO/FileSystemTasks.cs

@@ -188,6 +188,7 @@ public static void DeleteFile(string file)
         File.Delete(file);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.Copy)}")]
     public static void CopyFile(AbsolutePath source, AbsolutePath target, FileExistsPolicy policy = FileExistsPolicy.Fail, bool createDirectories = true)
     {
         if (!ShouldCopyFile(source, target, policy))
@@ -200,6 +201,7 @@ public static void CopyFile(AbsolutePath source, AbsolutePath target, FileExists
         File.Copy(source, target, overwrite: true);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.CopyToDirectory)}")]
     public static void CopyFileToDirectory(
         AbsolutePath source,
         AbsolutePath targetDirectory,
@@ -209,6 +211,7 @@ public static void CopyFileToDirectory(
         CopyFile(source, Path.Combine(targetDirectory, Path.GetFileName(source).NotNull()), policy, createDirectories);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.Move)}")]
     public static void MoveFile(AbsolutePath source, AbsolutePath target, FileExistsPolicy policy = FileExistsPolicy.Fail, bool createDirectories = true)
     {
         if (!ShouldCopyFile(source, target, policy))
@@ -224,6 +227,7 @@ public static void MoveFile(AbsolutePath source, AbsolutePath target, FileExists
         File.Move(source, target);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.MoveToDirectory)}")]
     public static void MoveFileToDirectory(
         AbsolutePath source,
         AbsolutePath targetDirectory,
@@ -233,6 +237,7 @@ public static void MoveFileToDirectory(
         MoveFile(source, Path.Combine(targetDirectory, Path.GetFileName(source).NotNull()), policy, createDirectories);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.Rename)}")]
     public static void RenameFile(AbsolutePath file, string newName, FileExistsPolicy policy = FileExistsPolicy.Fail)
     {
         if (Path.GetFileName(file) == newName)
@@ -241,6 +246,7 @@ public static void RenameFile(AbsolutePath file, string newName, FileExistsPolic
         MoveFile(file, Path.Combine(Path.GetDirectoryName(file).NotNull(), newName), policy);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.Move)}")]
     public static void MoveDirectory(
         AbsolutePath source,
         AbsolutePath target,
@@ -264,6 +270,7 @@ public static void MoveDirectory(
         }
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.MoveToDirectory)}")]
     public static void MoveDirectoryToDirectory(
         AbsolutePath source,
         AbsolutePath targetDirectory,
@@ -273,6 +280,7 @@ public static void MoveDirectoryToDirectory(
         MoveDirectory(source, Path.Combine(targetDirectory, new DirectoryInfo(source).Name), directoryPolicy, filePolicy);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.Rename)}")]
     public static void RenameDirectory(
         string directory,
         string newName,
@@ -282,6 +290,7 @@ public static void RenameDirectory(
         MoveDirectory(directory, Path.Combine(Path.GetDirectoryName(directory).NotNull(), newName), directoryPolicy, filePolicy);
     }
 
+    [Obsolete($"Use {nameof(AbsolutePath)}.{nameof(AbsolutePathExtensions.Copy)}")]
     public static void CopyDirectoryRecursively(
         AbsolutePath source,
         AbsolutePath target,

source/Nuke.Common/Tools/ReSharper/ReSharperTasks.cs

@@ -26,11 +26,9 @@ private static void PreProcess<T>(ref T toolSettings) where T : ReSharperSetting
         var wave = GetWave(toolSettings).NotNull("wave != null");
         var shadowDirectory = GetShadowDirectory(toolSettings, wave);
 
-        FileSystemTasks.CopyDirectoryRecursively(
-            Path.GetDirectoryName(toolSettings.ProcessToolPath).NotNull(),
-            shadowDirectory,
-            DirectoryExistsPolicy.Merge,
-            FileExistsPolicy.OverwriteIfNewer);
+        ((AbsolutePath)toolSettings.ProcessToolPath.NotNull()).Copy(
+            target: shadowDirectory,
+            policy: ExistsPolicy.MergeAndOverwriteIfNewer);
 
         toolSettings.Plugins
             .Select(x => (Plugin: x.Key, Version: x.Value == ReSharperPluginLatest ? null : x.Value))

source/Nuke.Common/Utilities/TemplateUtility.cs

@@ -88,20 +88,14 @@ private static void FillTemplateDirectoryRecursivelyInternal(
             FillTemplateFile(file, tokens);
 
             if (ShouldMove(file))
-                FileSystemTasks.RenameFile(file, file.Name.Replace(tokens), FileExistsPolicy.OverwriteIfNewer);
+                file.Rename(file.Name.Replace(tokens), ExistsPolicy.FileOverwriteIfNewer);
         }
 
         directory.GetDirectories()
             .ForEach(x => FillTemplateDirectoryRecursivelyInternal(x, tokens, excludeDirectory, excludeFile));
 
         if (ShouldMove(directory))
-        {
-            FileSystemTasks.RenameDirectory(
-                directory,
-                directory.Name.Replace(tokens),
-                DirectoryExistsPolicy.Merge,
-                FileExistsPolicy.OverwriteIfNewer);
-        }
+            directory.Rename(directory.Name.Replace(tokens), ExistsPolicy.MergeAndOverwriteIfNewer);
     }
 
     public static void FillTemplateFile(

source/Nuke.Utilities.Tests/IO/FileSystemDependentTest.cs

@@ -32,7 +32,7 @@ protected FileSystemDependentTest(ITestOutputHelper testOutputHelper)
         ExecutionDirectory = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location).NotNull();
         RootDirectory = Constants.TryGetRootDirectoryFrom(EnvironmentInfo.WorkingDirectory);
         TestProjectDirectory = ExecutionDirectory.FindParentOrSelf(x => x.ContainsFile("*.csproj"));
-        TestTempDirectory = ExecutionDirectory / "temp"  / $"{GetType().Name}.{TestName}";
+        TestTempDirectory = ExecutionDirectory / "temp" / $"{GetType().Name}.{TestName}";
 
         TestTempDirectory.CreateOrCleanDirectory();
     }

source/Nuke.Utilities.Tests/IO/MoveCopyTest.cs

@@ -0,0 +1,135 @@
+// Copyright 2024 Maintainers of NUKE.
+// Distributed under the MIT License.
+// https://github.com/nuke-build/nuke/blob/master/LICENSE
+
+using System;
+using System.Linq;
+using FluentAssertions;
+using Nuke.Common.IO;
+using Nuke.Common.Utilities.Collections;
+using Xunit;
+using Xunit.Abstractions;
+
+namespace Nuke.Common.Tests;
+
+public class MoveCopyTest : FileSystemDependentTest
+{
+    public MoveCopyTest(ITestOutputHelper testOutputHelper) : base(testOutputHelper)
+    {
+        AbsolutePathExtensions.DefaultEofLineBreak = false;
+    }
+
+    [Fact]
+    public void TestCopyFile()
+    {
+        var source = TestTempDirectory / "source.txt";
+        source.WriteAllText("foobar");
+
+        var target = TestTempDirectory / "target.txt";
+        source.Copy(target);
+
+        target.FileExists().Should().BeTrue();
+
+        new Action(() => source.Copy(target))
+            .Should().Throw<Exception>().WithMessage("* already exists");
+
+        new Action(() => source.Copy(target, policy: ExistsPolicy.FileFail | ExistsPolicy.FileOverwrite))
+            .Should().Throw<Exception>().WithMessage("Multiple file policies *");
+
+        source.WriteAllText("fizzbuzz");
+        source.Copy(target, policy: ExistsPolicy.FileOverwrite)
+            .Should().Be(target);
+        target.ReadAllText().Should().Be("fizzbuzz");
+    }
+
+    [Fact]
+    public void TestMoveFile()
+    {
+        var source1 = (TestTempDirectory / "source1.txt").TouchFile();
+        var source2 = (TestTempDirectory / "source2.txt").TouchFile();
+        var source3 = (TestTempDirectory / "source3.txt").TouchFile();
+
+        var target = TestTempDirectory / "target.txt";
+        source2.Move(target);
+
+        target.FileExists().Should().BeTrue();
+        source2.FileExists().Should().BeFalse();
+
+        new Action(() => source1.Move(target, policy: ExistsPolicy.FileFail))
+            .Should().Throw<Exception>().WithMessage("* already exists");
+
+        source1.Move(target, policy: ExistsPolicy.FileSkip).Should().Be(source1);
+        source1.Move(target, policy: ExistsPolicy.FileOverwriteIfNewer).Should().Be(source1);
+
+        source3.TouchFile();
+        source3.Move(target, policy: ExistsPolicy.FileOverwriteIfNewer).Should().Be(target);
+    }
+
+    [Fact]
+    public void TestCopyDirectory()
+    {
+        var source = TestTempDirectory / "source";
+        var sourceFiles = new[]
+        {
+            source / "source1.txt",
+            source / "source2.txt",
+            source / "sub" / "source3.txt",
+            source / "sub" / "source4.txt",
+        };
+        sourceFiles.ForEach(x => x.WriteAllText("source"));
+
+        var target = TestTempDirectory / "target";
+        source.Copy(target);
+        target.GetFiles(depth: int.MaxValue).Select(x => target.GetRelativePathTo(x).ToString())
+            .Should().BeEquivalentTo(sourceFiles.Select(x => source.GetRelativePathTo(x).ToString()));
+
+        target.CreateOrCleanDirectory();
+        var target0 = (target / "source0.txt").TouchFile();
+        var target3 = (target / "sub" / "source3.txt").WriteAllText("target");
+        var target4 = (target / "sub" / "source4.txt").WriteAllText("target");
+        (source / target.GetRelativePathTo(target4)).TouchFile();
+
+        new Action(() => source.Copy(target, ExistsPolicy.DirectoryFail))
+            .Should().Throw<Exception>().WithMessage("Policy disallows merging directories");
+        target.GetFiles(depth: int.MaxValue).Should().HaveCount(3);
+
+        source.Copy(target, ExistsPolicy.MergeAndSkip);
+        target0.FileExists().Should().BeTrue();
+        target3.ReadAllText().Should().Be("target");
+        target4.ReadAllText().Should().Be("target");
+
+        source.Copy(target, ExistsPolicy.MergeAndOverwriteIfNewer);
+        target3.ReadAllText().Should().Be("target");
+        target4.ReadAllText().Should().Be("source");
+
+        source.Copy(target, ExistsPolicy.MergeAndOverwrite);
+        target3.ReadAllText().Should().Be("source");
+    }
+
+    [Fact]
+    public void TestMoveDirectory()
+    {
+        var source = TestTempDirectory / "source";
+        var sourceFiles = new[]
+                          {
+                              source / "source1.txt",
+                              source / "source2.txt",
+                              source / "sub" / "source3.txt",
+                              source / "sub" / "source4.txt",
+                          };
+        sourceFiles.ForEach(x => x.WriteAllText("source"));
+
+        var target = TestTempDirectory / "target";
+        (target / "source1.txt").TouchFile();
+        (target / "sub" / "source3.txt").TouchFile();
+
+        new Action(() => source.Move(target)).Should().Throw<Exception>();
+
+        source.Move(target, ExistsPolicy.MergeAndSkip);
+        source.GetFiles(depth: int.MaxValue).Should().HaveCount(2);
+
+        source.Move(target, ExistsPolicy.MergeAndSkip, deleteRemainingFiles: true)
+            .Should().Be(target);
+        source.DirectoryExists().Should().BeFalse();
+    }
+}

source/Nuke.Utilities/Collections/Enumerable.WhereNotNull.cs

@@ -18,4 +18,13 @@ public static IEnumerable<T> WhereNotNull<T>(this IEnumerable<T> enumerable)
     {
         return enumerable.Where(x => x != null);
     }
+
+    /// <summary>
+    /// Filters the collection to elements that don't meet the condition.
+    /// </summary>
+    public static IEnumerable<T> WhereNot<T>(this IEnumerable<T> enumerable, Func<T, bool> condition)
+        where T : class
+    {
+        return enumerable.Where(x => condition == null || !condition(x));
+    }
 }