Add test framework

.github/workflows/build.yml

@@ -1,18 +1,26 @@
-name: Build DesktopRanger
+name: Build and test DesktopRanger
 
 on:
   push:
-    branches: [ "main" ]
+    branches:
+      - main
+
   pull_request:
-    branches: [ "main" ]
+    branches:
+      - main
+
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.ref }}
+  cancel-in-progress: true
+
 permissions:
   contents: read
 
 jobs:
-  build:
-    name: Build Release x64
+  build-and-test:
+    name: Build and test Release x64
     runs-on: windows-2025-vs2026
 
     steps:
@@ -38,7 +46,8 @@ jobs:
           }
 
           Write-Host "MSBuild path: $msbuild"
-          "MSBUILD_PATH=$msbuild" | Out-File -FilePath $env:GITHUB_ENV -Append
+          "MSBUILD_PATH=$msbuild" |
+            Out-File -FilePath $env:GITHUB_ENV -Append
 
       - name: Build solution
         shell: pwsh
@@ -49,10 +58,56 @@ jobs:
             /p:Platform=x64 `
             /p:TreatWarningsAsErrors=false
 
+      - name: Run unit tests
+        shell: pwsh
+        run: |
+          $testExecutable = Join-Path `
+            $env:GITHUB_WORKSPACE `
+            ".output\Release\Desktop.Ranger.Tests.exe"
+
+          $testResults = Join-Path `
+            $env:GITHUB_WORKSPACE `
+            ".output\Release\test-results.xml"
+
+          if (-not (Test-Path $testExecutable)) {
+            Write-Host "Test executable was not found."
+            Write-Host "Contents of the output directory:"
+
+            Get-ChildItem `
+              -Path ".output" `
+              -Recurse `
+              -Force `
+              -ErrorAction SilentlyContinue
+
+            throw "Missing test executable: $testExecutable"
+          }
+
+          Write-Host "Running tests: $testExecutable"
+
+          & $testExecutable `
+            "--gtest_output=xml:$testResults"
+
+          $testExitCode = $LASTEXITCODE
+
+          if ($testExitCode -ne 0) {
+            Write-Error "Unit tests failed with exit code $testExitCode."
+            exit $testExitCode
+          }
+
+          Write-Host "All unit tests passed."
+
       - name: Show output directory
+        if: ${{ always() }}
         shell: pwsh
         run: |
-          Get-ChildItem -Recurse -Force .output -ErrorAction SilentlyContinue
+          Get-ChildItem -Recurse -Force -Path ".output" -ErrorAction SilentlyContinue
+      - name: Upload test results
+        if: ${{ always() }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: DesktopRanger-Test-Results
+          path: .output/Release/test-results.xml
+          if-no-files-found: warn
 
       - name: Upload build artifacts
         uses: actions/upload-artifact@v4

.gitignore

@@ -1,25 +1,94 @@
-# User-specific files
+# Visual Studio user-specific files
+.vs/
 *.suo
 *.user
-*.venv
+*.userosscache
+*.sln.docstates
+
+# Visual Studio databases and caches
+*.VC.db
+*.VC.VC.opendb
+*.opendb
+*.opensdf
+*.sdf
+*.ncb
+ipch/
+
+# Build output directories
+.output/
+.intermediate/
 
-# Build-specific files
+# C and C++ Build-specific files
 *.exe
+*.dll
+*.lib
+*.exp
+
+# C and C++ compiler/linker output
+*.obj
+*.o
+*.pch
 *.pdb
+*.idb
+*.ilk
+*.ipdb
+*.iobj
+*.tlog
+*.lastbuildstate
 
-# Logger
-app.log
+# Incremental and profiling output
+*.pgc
+*.pgd
+*.rsp
+*.tmp
 
-# Visual C++ Cache and Build artifacts
-.intermediate/
-.output/
-.vs/
-vcpkg_installed/
-
-#GoogleTest Files
+#GoogleTest Files NuGet
 packages/
 
-#CodeCoverage Results
+# GoogleTest and test results
+
 TestResults/
+Testing/
+*.trx
+*.coverage
+*.coveragexml
+test-results.xml
+
+# CMake
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
+CTestTestfile.cmake
+cmake-build-*/
+CMakeUserPresets.json
+_deps/
+
+
+# vcpkg local output
+vcpkg_installed/
+buildtrees/
+downloads/
+
+# Logger
+*.log
+app.log
+
+# Editor and operating-system files
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Python/local environments
+# ========================================
+.venv/
+venv/
+__pycache__/
+*.pyc
 
-CLAUDE.md
+# Local assistant/tool configuration
+CLAUDE.md
+CLAUDE.md
+.claude/

.gitmodules

@@ -1,3 +1,6 @@
 [submodule "external/wil"]
 	path = external/wil
 	url = https://github.com/microsoft/wil.git
+[submodule "external/googletest"]
+	path = external/googletest
+	url = https://github.com/google/googletest.git

DesktopRanger.sln

@@ -1,10 +1,14 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 17
-VisualStudioVersion = 17.14.36915.13
+# Visual Studio Version 18
+VisualStudioVersion = 18.8.12021.73 stable
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Desktop.Ranger", "desktop.ranger\desktop.ranger.launcher.vcxproj", "{401D5967-31CF-4E85-96EE-80FF9A802EEA}"
 EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Desktop.Ranger.Tests", "Desktop.Ranger.Tests\Desktop.Ranger.Tests.vcxproj", "{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}"
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Desktop.Ranger.Core", "Desktop.Ranger.Core\Desktop.Ranger.Core.vcxproj", "{8B80B052-8D00-44B6-AF5A-A9785C26142A}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -21,6 +25,22 @@ Global
 		{401D5967-31CF-4E85-96EE-80FF9A802EEA}.Release|Any CPU.Build.0 = Release|x64
 		{401D5967-31CF-4E85-96EE-80FF9A802EEA}.Release|x64.ActiveCfg = Release|x64
 		{401D5967-31CF-4E85-96EE-80FF9A802EEA}.Release|x64.Build.0 = Release|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Debug|Any CPU.ActiveCfg = Debug|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Debug|Any CPU.Build.0 = Debug|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Debug|x64.ActiveCfg = Debug|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Debug|x64.Build.0 = Debug|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Release|Any CPU.ActiveCfg = Release|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Release|Any CPU.Build.0 = Release|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Release|x64.ActiveCfg = Release|x64
+		{01DD77D4-6425-46EA-A0A8-C9A6C7E12A0F}.Release|x64.Build.0 = Release|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Debug|Any CPU.ActiveCfg = Debug|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Debug|Any CPU.Build.0 = Debug|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Debug|x64.ActiveCfg = Debug|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Debug|x64.Build.0 = Debug|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Release|Any CPU.ActiveCfg = Release|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Release|Any CPU.Build.0 = Release|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Release|x64.ActiveCfg = Release|x64
+		{8B80B052-8D00-44B6-AF5A-A9785C26142A}.Release|x64.Build.0 = Release|x64
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

desktop.ranger.core/desktop.ranger.core.vcxproj

@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup Label="ProjectConfigurations">
+    <ProjectConfiguration Include="Debug|x64">
+      <Configuration>Debug</Configuration>
+      <Platform>x64</Platform>
+    </ProjectConfiguration>
+    <ProjectConfiguration Include="Release|x64">
+      <Configuration>Release</Configuration>
+      <Platform>x64</Platform>
+    </ProjectConfiguration>
+  </ItemGroup>
+  <PropertyGroup Label="Globals">
+    <VCProjectVersion>18.0</VCProjectVersion>
+    <Keyword>Win32Proj</Keyword>
+    <ProjectGuid>{8b80b052-8d00-44b6-af5a-a9785c26142a}</ProjectGuid>
+    <RootNamespace>DesktopRangerCore</RootNamespace>
+    <WindowsTargetPlatformVersion>10.0.26100.0</WindowsTargetPlatformVersion>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration">
+    <ConfigurationType>StaticLibrary</ConfigurationType>
+    <UseDebugLibraries>true</UseDebugLibraries>
+    <PlatformToolset>v145</PlatformToolset>
+    <CharacterSet>Unicode</CharacterSet>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'" Label="Configuration">
+    <ConfigurationType>StaticLibrary</ConfigurationType>
+    <UseDebugLibraries>false</UseDebugLibraries>
+    <PlatformToolset>v145</PlatformToolset>
+    <WholeProgramOptimization>true</WholeProgramOptimization>
+    <CharacterSet>Unicode</CharacterSet>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
+  <ImportGroup Label="ExtensionSettings">
+  </ImportGroup>
+  <ImportGroup Label="Shared">
+  </ImportGroup>
+  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <PropertyGroup Label="UserMacros" />
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
+    <OutDir>$(SolutionDir).output\$(Configuration)\</OutDir>
+    <IntDir>$(SolutionDir).intermediate\$(ProjectName)\$(Configuration)\</IntDir>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
+    <OutDir>$(SolutionDir).output\$(Configuration)\</OutDir>
+    <IntDir>$(SolutionDir).intermediate\$(ProjectName)\$(Configuration)\</IntDir>
+  </PropertyGroup>
+  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
+    <ClCompile>
+      <WarningLevel>Level3</WarningLevel>
+      <SDLCheck>true</SDLCheck>
+      <PreprocessorDefinitions>_DEBUG;_LIB;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+      <ConformanceMode>true</ConformanceMode>
+      <LanguageStandard>stdcpplatest</LanguageStandard>
+      <PrecompiledHeader>NotUsing</PrecompiledHeader>
+      <PrecompiledHeaderFile>
+      </PrecompiledHeaderFile>
+      <PrecompiledHeaderOutputFile />
+    </ClCompile>
+    <Link>
+      <SubSystem>
+      </SubSystem>
+      <GenerateDebugInformation>true</GenerateDebugInformation>
+    </Link>
+    <Manifest>
+      <EnableSegmentHeap>true</EnableSegmentHeap>
+    </Manifest>
+  </ItemDefinitionGroup>
+  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
+    <ClCompile>
+      <WarningLevel>Level3</WarningLevel>
+      <FunctionLevelLinking>true</FunctionLevelLinking>
+      <IntrinsicFunctions>true</IntrinsicFunctions>
+      <SDLCheck>true</SDLCheck>
+      <PreprocessorDefinitions>NDEBUG;_LIB;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+      <ConformanceMode>true</ConformanceMode>
+      <LanguageStandard>stdcpplatest</LanguageStandard>
+      <PrecompiledHeader>NotUsing</PrecompiledHeader>
+      <PrecompiledHeaderFile>
+      </PrecompiledHeaderFile>
+      <PrecompiledHeaderOutputFile />
+    </ClCompile>
+    <Link>
+      <SubSystem>
+      </SubSystem>
+      <GenerateDebugInformation>true</GenerateDebugInformation>
+    </Link>
+    <Manifest>
+      <EnableSegmentHeap>true</EnableSegmentHeap>
+    </Manifest>
+  </ItemDefinitionGroup>
+  <ItemGroup>
+    <ClInclude Include="desktop_name_generator.h" />
+  </ItemGroup>
+  <ItemGroup>
+    <ClCompile Include="desktop_name_generator.cpp" />
+  </ItemGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
+  <ImportGroup Label="ExtensionTargets">
+  </ImportGroup>
+</Project>

desktop.ranger.core/desktop.ranger.core.vcxproj.filters

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup>
+    <Filter Include="Source Files">
+      <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
+      <Extensions>cpp;c;cc;cxx;c++;cppm;ixx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
+    </Filter>
+    <Filter Include="Header Files">
+      <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
+      <Extensions>h;hh;hpp;hxx;h++;hm;inl;inc;ipp;xsd</Extensions>
+    </Filter>
+    <Filter Include="Resource Files">
+      <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
+      <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav;mfcribbon-ms</Extensions>
+    </Filter>
+  </ItemGroup>
+  <ItemGroup>
+    <ClInclude Include="desktop_name_generator.h">
+      <Filter>Header Files</Filter>
+    </ClInclude>
+  </ItemGroup>
+  <ItemGroup>
+    <ClCompile Include="desktop_name_generator.cpp">
+      <Filter>Source Files</Filter>
+    </ClCompile>
+  </ItemGroup>
+</Project>