using System;
using System.Collections.Generic;
using System.Diagnostics.CodeAnalysis;
using System.IO;
using System.Linq;
namespace PKHeX.Core;
///
/// Utility logic for detecting a from various locations on the host machine.
///
public static class SaveFinder
{
///
/// Searches the provided to find a valid 3DS drive, usually from an inserted SD card.
///
/// List of drives on the host machine.
/// Optional parameter to skip the first drive.
/// The first drive is usually the system hard drive, or can be a floppy disk drive (slower to check, never has expected data).
/// Folder path pointing to the Nintendo 3DS folder.
public static string? Get3DSLocation(IEnumerable drives, bool skipFirstDrive = true) =>
FindConsoleRootFolder(drives, "Nintendo 3DS", skipFirstDrive);
///
/// Searches the provided to find a valid Switch drive, usually from an inserted SD card.
///
/// List of drives on the host machine.
/// Optional parameter to skip the first drive.
/// The first drive is usually the system hard drive, or can be a floppy disk drive (slower to check, never has expected data).
/// Folder path pointing to the Nintendo folder.
public static string? GetSwitchLocation(IEnumerable drives, bool skipFirstDrive = true) =>
FindConsoleRootFolder(drives, "Nintendo", skipFirstDrive);
private static string? FindConsoleRootFolder(IEnumerable drives, string path, bool skipFirstDrive)
{
if (skipFirstDrive)
drives = drives.Skip(1);
var paths = drives.Select(drive => Path.Combine(drive, path));
return paths.FirstOrDefault(Directory.Exists);
}
///
/// Gets a list of 3DS save backup paths for the storage device.
///
/// Root location of device
/// List of possible 3DS save backup paths.
public static IEnumerable Get3DSBackupPaths(string root)
{
yield return Path.Combine(root, "saveDataBackup");
yield return Path.Combine(root, "filer", "UserSaveData");
yield return Path.Combine(root, "JKSV", "Saves");
yield return Path.Combine(root, "TWLSaveTool");
yield return Path.Combine(root, "fbi", "save");
yield return Path.Combine(root, "gm9", "out");
yield return Path.Combine(root, "3ds", "Checkpoint", "saves");
}
///
/// Gets a list of Switch save backup paths for the storage device.
///
/// Root location of device
/// List of possible 3DS save backup paths.
public static IEnumerable GetSwitchBackupPaths(string root)
{
yield return Path.Combine(root, "switch", "Checkpoint", "saves");
}
///
/// Extra list of Backup Paths used for detecting a save file.
///
public static readonly List CustomBackupPaths = new();
///
/// Finds a compatible save file that was most recently saved (by file write time).
///
/// List of drives on the host machine.
/// Paths to check in addition to the default paths
/// Reference to a valid save file, if any.
public static SaveFile? FindMostRecentSaveFile(IReadOnlyList drives, params string[] extra)
=> FindMostRecentSaveFile(drives, (IEnumerable)extra);
///
/// Finds a compatible save file that was most recently saved (by file write time).
///
/// List of drives on the host machine.
/// Paths to check in addition to the default paths
/// Reference to a valid save file, if any.
public static SaveFile? FindMostRecentSaveFile(IReadOnlyList drives, IEnumerable extra)
{
var foldersToCheck = GetFoldersToCheck(drives, extra);
var result = GetSaveFilePathsFromFolders(foldersToCheck, true, out var possiblePaths);
if (!result)
throw new FileNotFoundException(string.Join(Environment.NewLine, possiblePaths)); // `possiblePaths` contains the error message
// return newest save file path that is valid
var byMostRecent = possiblePaths.OrderByDescending(File.GetLastWriteTimeUtc);
var saves = byMostRecent.Select(SaveUtil.GetVariantSAV);
return saves.FirstOrDefault(z => z?.ChecksumsValid == true);
}
///
/// Gets all detectable save files ordered by most recently saved (by file write time).
///
/// List of drives on the host machine.
/// Detect save files stored in common SD card homebrew locations.
/// Paths to check in addition to the default paths
/// Option to ignore backup files.
/// Valid save files, if any.
public static IEnumerable GetSaveFiles(IReadOnlyList drives, bool detect, IEnumerable extra, bool ignoreBackups)
{
var paths = detect ? GetFoldersToCheck(drives, extra) : extra;
var result = GetSaveFilePathsFromFolders(paths, ignoreBackups, out var possiblePaths);
if (!result)
yield break;
var byMostRecent = possiblePaths.OrderByDescending(File.GetLastWriteTimeUtc);
foreach (var s in byMostRecent)
{
var sav = SaveUtil.GetVariantSAV(s);
if (sav != null)
yield return sav;
}
}
public static IEnumerable GetFoldersToCheck(IReadOnlyList drives, IEnumerable extra)
{
var foldersToCheck = extra.Where(f => !string.IsNullOrWhiteSpace(f)).Concat(CustomBackupPaths);
string? path3DS = Path.GetPathRoot(Get3DSLocation(drives));
if (!string.IsNullOrEmpty(path3DS)) // check for Homebrew/CFW backups
foldersToCheck = foldersToCheck.Concat(Get3DSBackupPaths(path3DS));
string? pathNX = Path.GetPathRoot(GetSwitchLocation(drives));
if (!string.IsNullOrEmpty(pathNX)) // check for Homebrew/CFW backups
foldersToCheck = foldersToCheck.Concat(GetSwitchBackupPaths(pathNX));
return foldersToCheck;
}
private static bool GetSaveFilePathsFromFolders(IEnumerable foldersToCheck, bool ignoreBackups, out IEnumerable possible)
{
var possiblePaths = new List();
foreach (var folder in foldersToCheck)
{
if (!SaveUtil.GetSavesFromFolder(folder, true, out IEnumerable files, ignoreBackups))
{
if (files is not string[] msg) // should always return string[]
continue;
if (msg.Length == 0) // folder doesn't exist
continue;
possible = msg;
return false;
}
possiblePaths.AddRange(files);
}
possible = possiblePaths;
return true;
}
///
public static SaveFile? FindMostRecentSaveFile() => FindMostRecentSaveFile(Environment.GetLogicalDrives(), CustomBackupPaths);
///
public static IEnumerable DetectSaveFiles() => GetSaveFiles(Environment.GetLogicalDrives(), true, CustomBackupPaths, true);
///
public static bool TryDetectSaveFile([NotNullWhen(true)] out SaveFile? sav) => TryDetectSaveFile(Environment.GetLogicalDrives(), out sav);
public static bool TryDetectSaveFile(IReadOnlyList drives, [NotNullWhen(true)] out SaveFile? sav)
{
var result = FindMostRecentSaveFile(drives, CustomBackupPaths);
if (result == null)
{
sav = null;
return false;
}
var path = result.Metadata.FilePath!;
sav = result;
return File.Exists(path);
}
}