.Net 10

.devcontainer/devcontainer.json

@@ -0,0 +1,10 @@
+{
+  "name": "C# Dev Container",
+  "image": "mcr.microsoft.com/devcontainers/dotnet",
+  "features": {
+    "ghcr.io/devcontainers/features/dotnet:2.2.2": {
+      "version": "9.0"
+    }
+  },
+  "postCreateCommand": "apt-get update && apt-get install -y exfatprogs"
+}

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: [Codeuctivity]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: stesee
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/workflows/dotnet.yml

@@ -1,11 +1,12 @@
-name: .NET build and test
+name: .NET build and test
 env:
   CURRENT_VERSION: 2.0.${{ github.run_number }}
   LAST_COMMIT_MESSAGE: ${{ github.event.head_commit.message }}
 
 on:
   push:
-  pull_request:
+    paths-ignore:
+      - '*.md'
 
 jobs:
   build:
@@ -14,13 +15,14 @@ jobs:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: |
             8.0.x
             9.0.x
+            10.0.x
       - name: Print OS name
         shell: bash
         run: |
@@ -48,13 +50,14 @@ jobs:
     runs-on: ubuntu-latest
     needs: build
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: |
             8.0.x
             9.0.x
+            10.0.x
       - name: Restore dependencies
         run: dotnet restore
       - name: Build
@@ -78,13 +81,14 @@ jobs:
     runs-on: ubuntu-latest
     needs: build
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4
+        uses: actions/setup-dotnet@v5
         with:
           dotnet-version: |
             8.0.x
             9.0.x
+            10.0.x
       - name: Restore dependencies
         run: dotnet restore
       - name: Build

.github/workflows/stale.yml

@@ -18,7 +18,7 @@ jobs:
       pull-requests: write
 
     steps:
-    - uses: actions/stale@v9
+    - uses: actions/stale@v10
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         stale-issue-message: 'Stale issue message'

.vscode/extensions.json

@@ -1,7 +1,6 @@
 {
     "recommendations": [
-        "ms-dotnettools.csharp",
-        "formulahendry.dotnet-test-explorer",
-        "github.vscode-pull-request-github"
+        "github.vscode-pull-request-github",
+        "ms-dotnettools.csdevkit"
     ]
 }

README.md

@@ -1,10 +1,10 @@
 # SanitizeFilename
 
-Sanitizes file and directory names in a manner that is compatible with Windows, Linux and OsX.
+Sanitizes file and directory names to ensure compatibility with Windows (NTFS & exFat), Linux (ext4), and macOS (APFS).
 
 [![.NET build and test](https://github.com/Codeuctivity/SanitizeFilename/actions/workflows/dotnet.yml/badge.svg)](https://github.com/Codeuctivity/SanitizeFilename/actions/workflows/dotnet.yml) [![NuGet](https://img.shields.io/nuget/v/Codeuctivity.SanitizeFilename.svg)](https://www.nuget.org/packages/Codeuctivity.SanitizeFilename/) [![Donate](https://img.shields.io/static/v1?label=Paypal&message=Donate&color=informational)](https://www.paypal.com/donate?hosted_button_id=7M7UFMMRTS7UE)
 
-Implements rules documented by [Microsoft](https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file#naming-conventions) + file name length truncation to 255 bytes - common on [many modern](https://en.wikipedia.org/wiki/Comparison_of_file_systems) file systems. Runs on any .net8 target platform.
+Implements rules documented by [Microsoft](https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file#naming-conventions) + file name length truncation to 255 bytes, which is common on [many modern](https://en.wikipedia.org/wiki/Comparison_of_file_systems) file systems. Runs on any .NET platform.
 
 ## Example
 
@@ -25,23 +25,39 @@ Console.WriteLine($"SafeFileNameOptionalReplacementChar: {safeFileNameOptionalRe
 
 ## Rules
 
-Restrictions of Windows, Linux and OsX are alle combined to an replacement pattern, that will sanitize any filename to be compatible with any of the OS and common filesystem restrictions.
+Restrictions of Windows, Linux and macOS are all combined to an replacement pattern, that will sanitize any filename to be compatible with any of the OS and common filesystem restrictions.
 
-| Pattern                          | OS that don't support pattern | OS that support pattern | Example            |
-| -------------------------------- | ----------------------------- | ----------------------- | ------------------ |
-| Reserved keywords                | Windows                       | Linux, OsX              | CON, PRN, AUX, ... |
-| Reserved chars                   | Linux, Windows, OsX           |                         | '/', '\0'          |
-| Reserved chars windows           | Windows                       | Linux, OsX              | '\\\', '""', ...   |
-| Invalid trailing chars           | Windows                       | Linux, OsX              | ' ', ','           |
-| Max length Linux                 | Linux,                        | Windows, OsX            | 255 bytes          |
-| Max length                       | Linux, Windows, OsX           |                         | 255 chars          |
-| Unpaired Unicode surrogates      | OsX, Linux                    | Windows                 | U+D800 - U+DFFF    |
-| NotAssigned to Unicode           | OsX                           | Linux, Windows          | U+67803, ...       |
+| Pattern                       | OS that don't support pattern | OS that support pattern | Example            |
+| ----------------------------- | ----------------------------- | ----------------------- | ------------------ |
+| Reserved keywords             | Windows                       | Linux, macOS             | CON, PRN, AUX, ... |
+| Reserved chars                | Linux, Windows, macOS           |                         | '/', '\0'          |
+| Reserved chars windows       | Windows                       | Linux, macOS             | '\\\', '""', ...   |
+| Invalid trailing chars        | Windows                       | Linux, macOS             | ' ', ','           |
+| Max length Linux              | Linux,                        | [Windows, macOS](https://github.com/Codeuctivity/SanitizeFilename/blob/387103492098cd9cef0f8596a96dc6c2dfe2eba3/SanitizeFilenameTests/FilenameTests/LinuxSpecificTests.cs#L20)          | 255 bytes          |
+| Max length                    | Linux, Windows, macOS           |                         | 255 chars          |
+| Unpaired Unicode surrogates   | macOS, Linux                    | Windows                 | U+D800 - U+DFFF    |
+| NotAssigned to Unicode        | macOS                           | Linux, Windows          | U+67803, ...       |
+| "New" Unicode (today 17+) | macOS                           | Linux, Windows          | 🫩 (U+1FAE9), ...  |
 
-## .net framework support
+## .NET framework support
 
 - Support for legacy .NET versions will be maintained as long as it is [funded](https://github.com/sponsors/Codeuctivity).
-- Support for .NET Framework 4.6.2 and higher was added in Version 1.x.
+- Support for .NET Framework 4.6.2 and higher was added in Version [2.0.145](https://www.nuget.org/packages/Codeuctivity.SanitizeFilename/2.0.145).
 - Edge case Unicode sanitization: [.NET Framework](https://learn.microsoft.com/en-us/dotnet/framework/whats-new/#character-categories) uses Unicode 8.0, while .NET 8+ uses a newer version to detect unpaired surrogates and unassigned code points.
-	- This is relevant when dealing with emoticons.
-	- For example, ["💏🏻"](https://emojipedia.org/kiss-light-skin-tone) will be sanitized when running on .NET Framework 4.8, while it is supported as a valid filename on modern filesystems
+  - This is relevant when dealing with emoticons.
+  - For example, ["💏🏻"](https://emojipedia.org/kiss-light-skin-tone) will be sanitized when running on .NET Framework 4.8, while it is supported as a valid filename on modern filesystems
+
+## Test setup
+
+The exFat specific tests are skipped as long as no exFat filesystem is available. Use this snippet to enable them:
+
+### Windows
+
+```powershell
+$vhdpath = [System.IO.Path]::Combine($env:TEMP, 'ExFatTestContainer.vhd')
+Remove-Item $vhdpath -ErrorAction SilentlyContinue
+$vhdsize = 100MB
+New-VHD -Path $vhdpath -Dynamic -SizeBytes $vhdsize | Mount-VHD -Passthru |Initialize-Disk -Passthru |New-Partition -AssignDriveLetter -UseMaximumSize |Format-Volume -FileSystem 'exFAT' -Confirm:$false  -NewFileSystemLabel '{exfatLabel}' -Force|Out-Null
+```
+
+Running as admin will automatically create and mount a exFat drive while tests are running.

SanitizeFilename.sln

@@ -15,6 +15,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		.github\dependabot.yml = .github\dependabot.yml
 		.github\workflows\dotnet.yml = .github\workflows\dotnet.yml
 		README.md = README.md
+		testenvironments.json = testenvironments.json
 	EndProjectSection
 EndProject
 Global

SanitizeFilename/SanitizeFilename.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
 	<PropertyGroup>
-		<TargetFrameworks>net8.0;net9.0;netstandard2.0</TargetFrameworks>
+		<TargetFrameworks>net8.0;net9.0;net10.0;netstandard2.0</TargetFrameworks>
 		<LangVersion>latest</LangVersion>
 		<ImplicitUsings>enable</ImplicitUsings>
 		<Nullable>enable</Nullable>

SanitizeFilename/docs/nugetReadme.md

@@ -1,10 +1,8 @@
 # SanitizeFilename
 
-Sanitizes file- and directory names in a manner that is compatible with Windows, Linux and OsX.
+Sanitizes file and directory names to ensure compatibility with Windows (NTFS), Linux (ext4), and macOS (APFS).
 
-[![.NET build and test](https://github.com/Codeuctivity/SanitizeFilename/actions/workflows/dotnet.yml/badge.svg)](https://github.com/Codeuctivity/SanitizeFilename/actions/workflows/dotnet.yml) [![NuGet](https://img.shields.io/nuget/v/Codeuctivity.SanitizeFilename.svg)](https://www.nuget.org/packages/Codeuctivity.SanitizeFilename/) [![Donate](https://img.shields.io/static/v1?label=Paypal&message=Donate&color=informational)](https://www.paypal.com/donate?hosted_button_id=7M7UFMMRTS7UE)
-
-Implements rules documented by [Microsoft](https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file#naming-conventions) + file name length truncation to 255 bytes - common on [many modern](https://en.wikipedia.org/wiki/Comparison_of_file_systems) file systems. Runs on any .net8 target platform.
+Implements rules documented by [Microsoft](https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file#naming-conventions) + file name length truncation to 255 bytes - common on [many modern](https://en.wikipedia.org/wiki/Comparison_of_file_systems) file systems. Runs on any target platform.
 
 ## Example
 
@@ -21,4 +19,4 @@ Console.WriteLine($"Sanitized: {safeFileName}");
 string safeFileNameOptionalReplacementChar = unsafeString.SanitizeFilename(' ');
 Console.WriteLine($"SafeFileNameOptionalReplacementChar: {safeFileNameOptionalReplacementChar}");
 //SafeFileNameOptionalReplacementChar: file Name
-```
+```

SanitizeFilenameTests/DirectoryNameTests/LinuxSpecificTests.cs

@@ -22,7 +22,7 @@ public void ShouldBehaviorOsDependentOnCreatingDirectoryWithMoreThan255Bytes()
         {
             if (IsRunningOnNet4x())
             {
-                Assert.Pass("Test is not thought to be run with .net framwework / unicode 8");
+                Assert.Pass("Test is not thought to be run with .net framework / unicode 8");
             }
 
             var expected = !RuntimeInformation.IsOSPlatform(OSPlatform.Linux);

SanitizeFilenameTests/DirectoryNameTests/SanitizeDirectoryNamesTests.cs

@@ -53,7 +53,7 @@ public void ShouldThrow(string invalidDirectoryName, char replacement)
 
             if (IsRunningOnNet4x())
             {
-                Assert.Pass("Test is not thought to be run with .net framwework / unicode 8");
+                Assert.Pass("Test is not thought to be run with .net framework / unicode 8");
             }
 
             Assert.That(ex.Message, Is.EqualTo("Replacement '*' is invalid for Windows (Parameter 'replacement')"));
@@ -171,7 +171,7 @@ public void ShouldTruncateLongFileNamesPreserveUnicodeTextElements(string testSu
         {
             if (IsRunningOnNet4x())
             {
-                Assert.Pass("Test is not thought to be run with .net framwework / unicode 8");
+                Assert.Pass("Test is not thought to be run with .net framework / unicode 8");
             }
 
             var invalidDirectoryName = new string('a', countOfFillingAChars) + testSuffix;

SanitizeFilenameTests/ExFatTooling/AutoPlayDisabledScope.cs

@@ -0,0 +1,74 @@
+using Microsoft.Win32;
+using System.Runtime.InteropServices;
+
+public class AutoPlayDisabledScope : IDisposable
+{
+    private const string AutoPlayRegKey = @"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Explorer";
+    private const string AutoPlayRegValue = "NoDriveTypeAutoRun";
+    private const int DisableAllAutoPlay = 0xFF;
+
+    private static int? _originalValue;
+    private bool disposedValue;
+
+    public bool AutoPlayerInitialState { get; }
+
+    /// <summary>
+    /// Temporarily disables AutoPlay if it is enabled. Returns true if it was changed.
+    /// </summary>
+    public AutoPlayDisabledScope()
+    {
+        if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            AutoPlayerInitialState = false;
+            return;
+        }
+
+        object? current = Registry.GetValue(AutoPlayRegKey, AutoPlayRegValue, null);
+        if (current is int value && value == DisableAllAutoPlay)
+        {
+            // Already disabled
+            AutoPlayerInitialState = false;
+            return;
+        }
+
+        _originalValue = current as int?;
+        Registry.SetValue(AutoPlayRegKey, AutoPlayRegValue, DisableAllAutoPlay, RegistryValueKind.DWord);
+        AutoPlayerInitialState = true;
+    }
+
+    /// <summary>
+    /// Restores the original AutoPlay setting if it was changed.
+    /// </summary>
+    public static void RestoreAutoPlay()
+    {
+        if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            return;
+        }
+
+        if (_originalValue.HasValue)
+        {
+            Registry.SetValue(AutoPlayRegKey, AutoPlayRegValue, _originalValue.Value, RegistryValueKind.DWord);
+            _originalValue = null;
+        }
+    }
+
+    protected virtual void Dispose(bool disposing)
+    {
+        if (!disposedValue)
+        {
+            if (disposing)
+            {
+                RestoreAutoPlay();
+            }
+
+            disposedValue = true;
+        }
+    }
+
+    public void Dispose()
+    {
+        Dispose(disposing: true);
+        GC.SuppressFinalize(this);
+    }
+}