using System.Collections.Generic; using System.IO; using System.Linq; using static PKHeX.Core.MessageStrings; namespace PKHeX.Core { /// /// Contains extension methods for use with a . /// public static class BoxUtil { /// /// Dumps a folder of files to the . /// /// that is being dumped from. /// Folder to store files. /// Option to save in child folders with the Box Name as the folder name. /// -1 if aborted, otherwise the amount of files dumped. public static int DumpBoxes(this SaveFile sav, string path, bool boxFolders = false) { if (!sav.HasBox) return -1; var boxData = sav.BoxData; var ctr = 0; foreach (var pk in boxData) { if (pk.Species == 0 || !pk.Valid) continue; var boxFolder = path; if (boxFolders) { var boxName = Util.CleanFileName(sav.GetBoxName(pk.Box - 1)); boxFolder = Path.Combine(path, boxName); Directory.CreateDirectory(boxFolder); } var fileName = Util.CleanFileName(pk.FileName); var fn = Path.Combine(boxFolder, fileName); if (File.Exists(fn)) continue; File.WriteAllBytes(fn, pk.DecryptedPartyData); ctr++; } return ctr; } /// /// Dumps the to a folder with individual decrypted files. /// /// that is being dumped from. /// Folder to store files. /// Box contents to be dumped. /// -1 if aborted, otherwise the amount of files dumped. public static int DumpBox(this SaveFile sav, string path, int currentBox) { if (!sav.HasBox) return -1; var boxData = sav.BoxData; var ctr = 0; foreach (var pk in boxData) { if (pk.Species == 0 || !pk.Valid || pk.Box - 1 != currentBox) continue; var fileName = Path.Combine(path, Util.CleanFileName(pk.FileName)); if (File.Exists(fileName)) continue; File.WriteAllBytes(fileName, pk.DecryptedPartyData); ctr++; } return ctr; } /// /// Loads a folder of files to the . /// /// to load folder to. /// Folder to load files from. Files are only loaded from the top directory. /// Result message from the method. /// First box to start loading to. All prior boxes are not modified. /// Instruction to clear boxes after the starting box. /// Overwrite existing full slots. If true, will only overwrite empty slots. /// Bypass option to not modify properties when setting to Save File. /// Enumerate all files even in sub-folders. /// Count of files imported. public static int LoadBoxes(this SaveFile sav, string path, out string result, int boxStart = 0, bool boxClear = false, bool overwrite = false, PKMImportSetting noSetb = PKMImportSetting.UseDefault, bool all = false) { if (string.IsNullOrWhiteSpace(path) || !Directory.Exists(path)) { result = MsgSaveBoxExportPathInvalid; return -1; } var option = all ? SearchOption.AllDirectories : SearchOption.TopDirectoryOnly; var files = Directory.EnumerateFiles(path, "*.*", option); return sav.LoadBoxes(files, out result, boxStart, boxClear, overwrite, noSetb); } /// /// Loads a folder of files to the . /// /// to load folder to. /// Files to load files from. /// Result message from the method. /// First box to start loading to. All prior boxes are not modified. /// Instruction to clear boxes after the starting box. /// Overwrite existing full slots. If true, will only overwrite empty slots. /// Bypass option to not modify properties when setting to Save File. /// Count of files imported. public static int LoadBoxes(this SaveFile sav, IEnumerable files, out string result, int boxStart = 0, bool boxClear = false, bool overwrite = false, PKMImportSetting noSetb = PKMImportSetting.UseDefault) { var pks = GetPossiblePKMsFromPaths(sav, files); return sav.LoadBoxes(pks, out result, boxStart, boxClear, overwrite, noSetb); } /// /// Loads a folder of files to the . /// /// to load folder to. /// Encounters to create files from. /// Result message from the method. /// First box to start loading to. All prior boxes are not modified. /// Instruction to clear boxes after the starting box. /// Overwrite existing full slots. If true, will only overwrite empty slots. /// Bypass option to not modify properties when setting to Save File. /// Count of files imported. public static int LoadBoxes(this SaveFile sav, IEnumerable encounters, out string result, int boxStart = 0, bool boxClear = false, bool overwrite = false, PKMImportSetting noSetb = PKMImportSetting.UseDefault) { var pks = encounters.Select(z => z.ConvertToPKM(sav)); return sav.LoadBoxes(pks, out result, boxStart, boxClear, overwrite, noSetb); } /// /// Loads a folder of files to the . /// /// to load folder to. /// Unconverted objects to load. /// Result message from the method. /// First box to start loading to. All prior boxes are not modified. /// Instruction to clear boxes after the starting box. /// Overwrite existing full slots. If true, will only overwrite empty slots. /// Bypass option to not modify properties when setting to Save File. /// True if any files are imported. public static int LoadBoxes(this SaveFile sav, IEnumerable pks, out string result, int boxStart = 0, bool boxClear = false, bool overwrite = false, PKMImportSetting noSetb = PKMImportSetting.UseDefault) { if (!sav.HasBox) { result = MsgSaveBoxFailNone; return -1; } var compat = sav.GetCompatible(pks); if (boxClear) sav.ClearBoxes(boxStart); int ctr = sav.ImportPKMs(compat, overwrite, boxStart, noSetb); if (ctr <= 0) { result = MsgSaveBoxImportNoFiles; return -1; } result = string.Format(MsgSaveBoxImportSuccess, ctr); return ctr; } public static IEnumerable GetPKMsFromPaths(IEnumerable files, int generation) { var result = files .Where(file => PKX.IsPKM(new FileInfo(file).Length)) .Select(File.ReadAllBytes) .Select(data => PKMConverter.GetPKMfromBytes(data, prefer: generation)); foreach (var pkm in result) { if (pkm != null) yield return pkm; } } private static IEnumerable GetPossiblePKMsFromPaths(SaveFile sav, IEnumerable files) { foreach (var f in files) { var obj = FileUtil.GetSupportedFile(f, sav); switch (obj) { case PKM pk: yield return pk; break; case MysteryGift g when g.IsPokémon: yield return g.ConvertToPKM(sav); break; case GP1 g when g.Species != 0: yield return g.ConvertToPB7(sav); break; case IPokeGroup g: foreach (var p in g.Contents) yield return p; break; } } } /// /// Gets box names for all boxes in the save file. /// /// that box names are being dumped for. /// Returns default English box names in the event the save file does not have names (not exportable), or fails to return a box name. public static string[] GetBoxNames(SaveFile sav) { int count = sav.BoxCount; var result = new string[count]; if (!sav.Exportable) { for (int i = 0; i < count; i++) result[i] = $"Box {i + 1}"; return result; } for (int i = 0; i < count; i++) { try { result[i] = sav.GetBoxName(i); } #pragma warning disable CA1031 // Do not catch general exception types catch { result[i] = $"Box {i + 1}"; } #pragma warning restore CA1031 // Do not catch general exception types } return result; } } }