Files
Chronos/src/Titano.App/Import/ImportFailures.cs
T
Claude e97b0e4f84 fix(import): staging failures of a server import name this PC, failed jobs show catalog sentences
A server import stages its copies in this PC's cache folder, yet a full disk
there read 'The destination is full.' beside every photo, and a refused
write 'Titano may not write to the destination.', which sent the user to
the server. IImportSink.StagesOnThisPc (true for ServerImportSink) selects
Import.Failed.CacheFull and Import.Failed.CacheAccess instead.

A failed archive import job showed the job engine's raw text (SQLite, file
system or framework English) as the Import screen's line. ImportFailures.Job
keeps the archive engine's own localized sentences and shows 'The import
stopped before the end.' for anything else; the raw text stays in the
tooltip and the logs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-12 19:00:51 +00:00

104 lines
5.6 KiB
C#

using System.IO;
using System.Net.Http;
using System.Text.RegularExpressions;
using Titano.App.Shell;
using Titano.Core.Archiving;
using Titano.Core.Import;
using Titano.Core.Localization;
using Titano.Data;
using Titano.Protocol.Client;
namespace Titano.App.Import;
/// <summary>
/// What the Import screen says when an import or its plan stops (BRIEF §0.2 rule 6: one sentence saying what
/// happened): a localized sentence chosen by cause. The exception's own text, which may hold full paths or several
/// sentences, goes to the tooltip and the log only.
/// </summary>
public static class ImportFailures
{
private const int DiskFull = unchecked((int)0x80070070);
private const int HandleDiskFull = unchecked((int)0x80070027);
private const int WriteProtect = unchecked((int)0x80070013);
/// <summary>The sentences an archive import job fails with when the archive's engine stops it itself.</summary>
private static readonly string[] EngineSentences =
[
"Archive.Error.Offline", "Archive.Error.ReadOnly", "Archive.Error.Busy", "Archive.Error.NewerFormat", "Archive.Error.SourceGone",
"Archive.Error.DuplicateLost",
];
/// <param name="source">The card or folder as the Devices list names it.</param>
public static string Import(Exception ex, string source) => ex switch
{
ImportSourceUnavailableException => Loc.L("Import.Failed.SourceGone", source),
IOException { HResult: DiskFull or HandleDiskFull } => Loc.L("Import.Failed.Full"),
UnauthorizedAccessException => Loc.L("Import.Failed.Access"),
TitanoApiException or HttpRequestException or UntrustedCertificateException => Loc.L("Import.Failed.Server"),
_ => Loc.L("Import.Failed.Other"),
};
/// <summary>
/// Why the photos an import into a folder or the server never reached were not copied (<see cref="LocalImport"/>):
/// the card left, the destination is full or refuses writing, or the server answered with its own sentence, does
/// not answer (a timeout too) or is no longer trusted. When the sink stages on this PC (<paramref name="stagesOnThisPc"/>,
/// the server's), a full disk or a refused write is this PC's cache folder's: the server answers for its own space.
/// </summary>
public static string Stop(Exception ex, string source, bool stagesOnThisPc = false) => ex switch
{
TitanoApiException or HttpRequestException or UntrustedCertificateException or OperationCanceledException => ErrorText.ForServer(ex),
IOException { HResult: DiskFull or HandleDiskFull } when stagesOnThisPc => Loc.L("Import.Failed.CacheFull"),
UnauthorizedAccessException when stagesOnThisPc => Loc.L("Import.Failed.CacheAccess"),
_ => Import(ex, source),
};
/// <summary>
/// What a failed archive import job says, from the text the job engine kept of what stopped it: the engine's own
/// sentence (archive offline, read-only or busy, a newer format, the card gone, a photo it could not add) in the
/// language shown now, else 'The import stopped before the end.' Framework, database and system text goes to the
/// tooltip and the logs only.
/// </summary>
public static string Job(string? error) =>
error is { Length: > 0 } && EngineSentences.Any(key => IsSentence(key, error)) ? error : Loc.L("Import.Failed.Other");
/// <summary>Why the card or folder could not be planned.</summary>
public static string Plan(Exception ex, string source) => ex switch
{
DirectoryNotFoundException or DriveNotFoundException or ImportSourceUnavailableException => Loc.L("Import.Failed.SourceGone", source),
IOException or UnauthorizedAccessException => Loc.L("Import.Status.Unreadable", source),
_ => Loc.L("Import.Status.PlanError"),
};
/// <summary>Why the check of a card (every card file and its archive copy hashed again) stopped.</summary>
/// <param name="root">Where the card is mounted: a card that left explains any read failure.</param>
public static string Check(Exception ex, string source, string root) => ex switch
{
_ when CardGone(ex, root) => Loc.L("Import.Failed.SourceGone", source),
ArchiveOfflineException => ex.Message,
DatabaseException => Loc.L("Archive.Failed.Index"),
IOException or UnauthorizedAccessException => Loc.L("Import.Failed.CheckRead"),
_ => Loc.L("Errors.Unexpected"),
};
/// <summary>Why deleting verified photos from a card stopped.</summary>
/// <param name="root">Where the card is mounted: a card that left explains any write failure.</param>
public static string Erase(Exception ex, string source, string root) => ex switch
{
_ when CardGone(ex, root) => Loc.L("Import.Failed.SourceGone", source),
// A locked card (write-protect switch) or photos the camera marked protected (read-only).
IOException { HResult: WriteProtect } or UnauthorizedAccessException => Loc.L("Import.Failed.CardLocked", source),
_ => Loc.L("Errors.Unexpected"),
};
/// <summary>Whether <paramref name="text"/> is the sentence of <paramref name="key"/>, whatever its arguments.</summary>
private static bool IsSentence(string key, string text)
{
const string Argument = "\u0001";
var pattern = Regex.Escape(Loc.L(key, Argument, Argument)).Replace(Argument, ".+", StringComparison.Ordinal);
return Regex.IsMatch(text, "^" + pattern + "$", RegexOptions.CultureInvariant | RegexOptions.Singleline);
}
private static bool CardGone(Exception ex, string root) =>
ex is DirectoryNotFoundException or DriveNotFoundException or ImportSourceUnavailableException || !Directory.Exists(root);
}