From d387925c5c10df188775bf6ca5df34ca56106ac5 Mon Sep 17 00:00:00 2001 From: ghostflyby Date: Mon, 9 Nov 2026 21:08:58 +0800 Subject: [PATCH] feat(SystemIo): target .NET 10 Add a net10.0 target (the current LTS) to TruePath.SystemIo. With the source generator from #249 in place this is nearly a one-line change: the generator projects the per-target-framework BCL automatically, exposing 116 extension methods on this target, including the new span- and Memory-based overloads: - AppendAllText/WriteAllText with ReadOnlySpan contents, - AppendAllBytes/WriteAllBytes with ReadOnlySpan, - the ReadOnlyMemory-based async counterparts of all of the above. The existing netstandard2.0 and net8.0 targets are unchanged. The net10.0 public API baseline records the 102 members that already exist on the other targets as shipped, and only the 14 span- and Memory-based overloads this target adds as unshipped. Keeping them shipped matches how the net8.0 and netstandard2.0 baselines are maintained: each lists the full API surface of its target at the last release rather than its difference from the other targets. TruePath.Tests also gains a net10.0 target so the reflection completeness test validates the generated net10.0 surface against the matching runtime. --- .../PublicAPI/net10.0/PublicAPI.Shipped.txt | 104 ++++++++++++++++++ .../PublicAPI/net10.0/PublicAPI.Unshipped.txt | 15 +++ TruePath.SystemIo/TruePath.SystemIo.csproj | 2 +- TruePath.Tests/TruePath.Tests.csproj | 2 +- 4 files changed, 121 insertions(+), 2 deletions(-) create mode 100644 TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Shipped.txt create mode 100644 TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Unshipped.txt diff --git a/TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Shipped.txt b/TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Shipped.txt new file mode 100644 index 0000000..3708f67 --- /dev/null +++ b/TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Shipped.txt @@ -0,0 +1,104 @@ +#nullable enable +static TruePath.SystemIo.PathIo.AppendAllLines(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents) -> void +static TruePath.SystemIo.PathIo.AppendAllLines(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents, System.Text.Encoding! encoding) -> void +static TruePath.SystemIo.PathIo.AppendAllLinesAsync(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.AppendAllLinesAsync(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.AppendAllText(this TruePath.AbsolutePath path, string? contents) -> void +static TruePath.SystemIo.PathIo.AppendAllText(this TruePath.AbsolutePath path, string? contents, System.Text.Encoding! encoding) -> void +static TruePath.SystemIo.PathIo.AppendAllTextAsync(this TruePath.AbsolutePath path, string? contents, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.AppendAllTextAsync(this TruePath.AbsolutePath path, string? contents, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.AppendText(this TruePath.AbsolutePath path) -> System.IO.StreamWriter! +static TruePath.SystemIo.PathIo.Copy(this TruePath.AbsolutePath sourceFile, TruePath.AbsolutePath destFile) -> void +static TruePath.SystemIo.PathIo.Copy(this TruePath.AbsolutePath sourceFile, TruePath.AbsolutePath destFile, bool overwrite) -> void +static TruePath.SystemIo.PathIo.Create(this TruePath.AbsolutePath path) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.Create(this TruePath.AbsolutePath path, int bufferSize) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.Create(this TruePath.AbsolutePath path, int bufferSize, System.IO.FileOptions options) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.CreateDirectory(this TruePath.AbsolutePath path) -> void +static TruePath.SystemIo.PathIo.CreateDirectory(this TruePath.AbsolutePath path, System.IO.UnixFileMode unixCreateMode) -> System.IO.DirectoryInfo! +static TruePath.SystemIo.PathIo.CreateSymbolicLink(this TruePath.AbsolutePath path, TruePath.AbsolutePath pathToTarget) -> System.IO.FileSystemInfo! +static TruePath.SystemIo.PathIo.CreateText(this TruePath.AbsolutePath path) -> System.IO.StreamWriter! +static TruePath.SystemIo.PathIo.Decrypt(this TruePath.AbsolutePath path) -> void +static TruePath.SystemIo.PathIo.Delete(this TruePath.AbsolutePath path) -> void +static TruePath.SystemIo.PathIo.DeleteDirectoryRecursively(this TruePath.AbsolutePath path) -> void +static TruePath.SystemIo.PathIo.DeleteEmptyDirectory(this TruePath.AbsolutePath path) -> void +static TruePath.SystemIo.PathIo.Encrypt(this TruePath.AbsolutePath path) -> void +static TruePath.SystemIo.PathIo.EnumerateDirectories(this TruePath.AbsolutePath path) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateDirectories(this TruePath.AbsolutePath path, string! searchPattern) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateDirectories(this TruePath.AbsolutePath path, string! searchPattern, System.IO.EnumerationOptions! enumerationOptions) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateDirectories(this TruePath.AbsolutePath path, string! searchPattern, System.IO.SearchOption searchOption) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFiles(this TruePath.AbsolutePath path) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFiles(this TruePath.AbsolutePath path, string! searchPattern) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFiles(this TruePath.AbsolutePath path, string! searchPattern, System.IO.EnumerationOptions! enumerationOptions) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFiles(this TruePath.AbsolutePath path, string! searchPattern, System.IO.SearchOption searchOption) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFileSystemEntries(this TruePath.AbsolutePath path) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFileSystemEntries(this TruePath.AbsolutePath path, string! searchPattern) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFileSystemEntries(this TruePath.AbsolutePath path, string! searchPattern, System.IO.EnumerationOptions! enumerationOptions) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.EnumerateFileSystemEntries(this TruePath.AbsolutePath path, string! searchPattern, System.IO.SearchOption searchOption) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.Exists(this TruePath.AbsolutePath path) -> bool +static TruePath.SystemIo.PathIo.ExistsDirectory(this TruePath.AbsolutePath path) -> bool +static TruePath.SystemIo.PathIo.ExistsFile(this TruePath.AbsolutePath path) -> bool +static TruePath.SystemIo.PathIo.GetAttributes(this TruePath.AbsolutePath path) -> System.IO.FileAttributes +static TruePath.SystemIo.PathIo.GetCreationTime(this TruePath.AbsolutePath path) -> System.DateTime +static TruePath.SystemIo.PathIo.GetCreationTimeUtc(this TruePath.AbsolutePath path) -> System.DateTime +static TruePath.SystemIo.PathIo.GetDirectories(this TruePath.AbsolutePath path) -> string![]! +static TruePath.SystemIo.PathIo.GetDirectories(this TruePath.AbsolutePath path, string! searchPattern) -> string![]! +static TruePath.SystemIo.PathIo.GetDirectories(this TruePath.AbsolutePath path, string! searchPattern, System.IO.EnumerationOptions! enumerationOptions) -> string![]! +static TruePath.SystemIo.PathIo.GetDirectories(this TruePath.AbsolutePath path, string! searchPattern, System.IO.SearchOption searchOption) -> string![]! +static TruePath.SystemIo.PathIo.GetFiles(this TruePath.AbsolutePath path) -> string![]! +static TruePath.SystemIo.PathIo.GetFiles(this TruePath.AbsolutePath path, string! searchPattern) -> string![]! +static TruePath.SystemIo.PathIo.GetFiles(this TruePath.AbsolutePath path, string! searchPattern, System.IO.EnumerationOptions! enumerationOptions) -> string![]! +static TruePath.SystemIo.PathIo.GetFiles(this TruePath.AbsolutePath path, string! searchPattern, System.IO.SearchOption searchOption) -> string![]! +static TruePath.SystemIo.PathIo.GetFiles(this TruePath.AbsolutePath path, TruePath.LocalPathPattern searchPattern) -> TruePath.AbsolutePath[]! +static TruePath.SystemIo.PathIo.GetLastAccessTime(this TruePath.AbsolutePath path) -> System.DateTime +static TruePath.SystemIo.PathIo.GetLastAccessTimeUtc(this TruePath.AbsolutePath path) -> System.DateTime +static TruePath.SystemIo.PathIo.GetLastWriteTime(this TruePath.AbsolutePath path) -> System.DateTime +static TruePath.SystemIo.PathIo.GetLastWriteTimeUtc(this TruePath.AbsolutePath path) -> System.DateTime +static TruePath.SystemIo.PathIo.GetUnixFileMode(this TruePath.AbsolutePath path) -> System.IO.UnixFileMode +static TruePath.SystemIo.PathIo.Move(this TruePath.AbsolutePath sourceFile, TruePath.AbsolutePath destFile) -> void +static TruePath.SystemIo.PathIo.Move(this TruePath.AbsolutePath sourceFile, TruePath.AbsolutePath destFile, bool overwrite) -> void +static TruePath.SystemIo.PathIo.Open(this TruePath.AbsolutePath path, System.IO.FileMode mode) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.Open(this TruePath.AbsolutePath path, System.IO.FileMode mode, System.IO.FileAccess access) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.Open(this TruePath.AbsolutePath path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.Open(this TruePath.AbsolutePath path, System.IO.FileStreamOptions! options) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.OpenHandle(this TruePath.AbsolutePath path, System.IO.FileMode mode = System.IO.FileMode.Open, System.IO.FileAccess access = System.IO.FileAccess.Read, System.IO.FileShare share = System.IO.FileShare.Read, System.IO.FileOptions options = System.IO.FileOptions.None, long preallocationSize = 0) -> Microsoft.Win32.SafeHandles.SafeFileHandle! +static TruePath.SystemIo.PathIo.OpenRead(this TruePath.AbsolutePath path) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.OpenText(this TruePath.AbsolutePath path) -> System.IO.StreamReader! +static TruePath.SystemIo.PathIo.OpenWrite(this TruePath.AbsolutePath path) -> System.IO.FileStream! +static TruePath.SystemIo.PathIo.ReadAllBytes(this TruePath.AbsolutePath path) -> byte[]! +static TruePath.SystemIo.PathIo.ReadAllBytesAsync(this TruePath.AbsolutePath path, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.ReadAllLines(this TruePath.AbsolutePath path) -> string![]! +static TruePath.SystemIo.PathIo.ReadAllLines(this TruePath.AbsolutePath path, System.Text.Encoding! encoding) -> string![]! +static TruePath.SystemIo.PathIo.ReadAllLinesAsync(this TruePath.AbsolutePath path, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.ReadAllLinesAsync(this TruePath.AbsolutePath path, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.ReadAllText(this TruePath.AbsolutePath path) -> string! +static TruePath.SystemIo.PathIo.ReadAllText(this TruePath.AbsolutePath path, System.Text.Encoding! encoding) -> string! +static TruePath.SystemIo.PathIo.ReadAllTextAsync(this TruePath.AbsolutePath path, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.ReadAllTextAsync(this TruePath.AbsolutePath path, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.ReadLines(this TruePath.AbsolutePath path) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.ReadLines(this TruePath.AbsolutePath path, System.Text.Encoding! encoding) -> System.Collections.Generic.IEnumerable! +static TruePath.SystemIo.PathIo.ReadLinesAsync(this TruePath.AbsolutePath path, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable! +static TruePath.SystemIo.PathIo.ReadLinesAsync(this TruePath.AbsolutePath path, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable! +static TruePath.SystemIo.PathIo.Replace(this TruePath.AbsolutePath sourceFile, TruePath.AbsolutePath destinationFile, TruePath.AbsolutePath destinationBackupFile) -> void +static TruePath.SystemIo.PathIo.Replace(this TruePath.AbsolutePath sourceFile, TruePath.AbsolutePath destinationFile, TruePath.AbsolutePath destinationBackupFile, bool ignoreMetadataErrors) -> void +static TruePath.SystemIo.PathIo.ResolveLinkTarget(this TruePath.AbsolutePath linkPath, bool returnFinalTarget) -> System.IO.FileSystemInfo? +static TruePath.SystemIo.PathIo.SetAttributes(this TruePath.AbsolutePath path, System.IO.FileAttributes fileAttributes) -> void +static TruePath.SystemIo.PathIo.SetCreationTime(this TruePath.AbsolutePath path, System.DateTime creationTime) -> void +static TruePath.SystemIo.PathIo.SetCreationTimeUtc(this TruePath.AbsolutePath path, System.DateTime creationTimeUtc) -> void +static TruePath.SystemIo.PathIo.SetLastAccessTime(this TruePath.AbsolutePath path, System.DateTime lastAccessTime) -> void +static TruePath.SystemIo.PathIo.SetLastAccessTimeUtc(this TruePath.AbsolutePath path, System.DateTime lastAccessTimeUtc) -> void +static TruePath.SystemIo.PathIo.SetLastWriteTime(this TruePath.AbsolutePath path, System.DateTime lastWriteTime) -> void +static TruePath.SystemIo.PathIo.SetLastWriteTimeUtc(this TruePath.AbsolutePath path, System.DateTime lastWriteTimeUtc) -> void +static TruePath.SystemIo.PathIo.SetUnixFileMode(this TruePath.AbsolutePath path, System.IO.UnixFileMode mode) -> void +static TruePath.SystemIo.PathIo.WriteAllBytes(this TruePath.AbsolutePath path, byte[]! bytes) -> void +static TruePath.SystemIo.PathIo.WriteAllBytesAsync(this TruePath.AbsolutePath path, byte[]! bytes, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.WriteAllLines(this TruePath.AbsolutePath path, string![]! contents) -> void +static TruePath.SystemIo.PathIo.WriteAllLines(this TruePath.AbsolutePath path, string![]! contents, System.Text.Encoding! encoding) -> void +static TruePath.SystemIo.PathIo.WriteAllLines(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents) -> void +static TruePath.SystemIo.PathIo.WriteAllLines(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents, System.Text.Encoding! encoding) -> void +static TruePath.SystemIo.PathIo.WriteAllLinesAsync(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.WriteAllLinesAsync(this TruePath.AbsolutePath path, System.Collections.Generic.IEnumerable! contents, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.WriteAllText(this TruePath.AbsolutePath path, string? contents) -> void +static TruePath.SystemIo.PathIo.WriteAllText(this TruePath.AbsolutePath path, string? contents, System.Text.Encoding! encoding) -> void +static TruePath.SystemIo.PathIo.WriteAllTextAsync(this TruePath.AbsolutePath path, string? contents, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.WriteAllTextAsync(this TruePath.AbsolutePath path, string? contents, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +TruePath.SystemIo.PathIo diff --git a/TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Unshipped.txt b/TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Unshipped.txt new file mode 100644 index 0000000..d25a155 --- /dev/null +++ b/TruePath.SystemIo/PublicAPI/net10.0/PublicAPI.Unshipped.txt @@ -0,0 +1,15 @@ +#nullable enable +static TruePath.SystemIo.PathIo.AppendAllBytes(this TruePath.AbsolutePath path, byte[]! bytes) -> void +static TruePath.SystemIo.PathIo.AppendAllBytes(this TruePath.AbsolutePath path, System.ReadOnlySpan bytes) -> void +static TruePath.SystemIo.PathIo.AppendAllBytesAsync(this TruePath.AbsolutePath path, byte[]! bytes, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.AppendAllBytesAsync(this TruePath.AbsolutePath path, System.ReadOnlyMemory bytes, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.AppendAllText(this TruePath.AbsolutePath path, System.ReadOnlySpan contents) -> void +static TruePath.SystemIo.PathIo.AppendAllText(this TruePath.AbsolutePath path, System.ReadOnlySpan contents, System.Text.Encoding! encoding) -> void +static TruePath.SystemIo.PathIo.AppendAllTextAsync(this TruePath.AbsolutePath path, System.ReadOnlyMemory contents, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.AppendAllTextAsync(this TruePath.AbsolutePath path, System.ReadOnlyMemory contents, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.WriteAllBytes(this TruePath.AbsolutePath path, System.ReadOnlySpan bytes) -> void +static TruePath.SystemIo.PathIo.WriteAllBytesAsync(this TruePath.AbsolutePath path, System.ReadOnlyMemory bytes, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.WriteAllText(this TruePath.AbsolutePath path, System.ReadOnlySpan contents) -> void +static TruePath.SystemIo.PathIo.WriteAllText(this TruePath.AbsolutePath path, System.ReadOnlySpan contents, System.Text.Encoding! encoding) -> void +static TruePath.SystemIo.PathIo.WriteAllTextAsync(this TruePath.AbsolutePath path, System.ReadOnlyMemory contents, System.Text.Encoding! encoding, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! +static TruePath.SystemIo.PathIo.WriteAllTextAsync(this TruePath.AbsolutePath path, System.ReadOnlyMemory contents, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task! diff --git a/TruePath.SystemIo/TruePath.SystemIo.csproj b/TruePath.SystemIo/TruePath.SystemIo.csproj index a3d70e6..01b0c9d 100644 --- a/TruePath.SystemIo/TruePath.SystemIo.csproj +++ b/TruePath.SystemIo/TruePath.SystemIo.csproj @@ -7,7 +7,7 @@ SPDX-License-Identifier: MIT - netstandard2.0;net8.0 + netstandard2.0;net8.0;net10.0 true Adapters to use System.IO.File and System.IO.Directory APIs together with TruePath. TruePath.SystemIO diff --git a/TruePath.Tests/TruePath.Tests.csproj b/TruePath.Tests/TruePath.Tests.csproj index 8ef12f1..d171b43 100644 --- a/TruePath.Tests/TruePath.Tests.csproj +++ b/TruePath.Tests/TruePath.Tests.csproj @@ -7,7 +7,7 @@ SPDX-License-Identifier: MIT - net8.0 + net8.0;net10.0 Exe false true