Cockatrice/libcockatrice_settings/libcockatrice/settings/settings_migration.h

#ifndef SETTINGS_MIGRATION_H
#define SETTINGS_MIGRATION_H

#include <QString>

class SettingsMigration
{
public:
    static bool migrateSettingsFromGlobalIni(const QString &settingsPath);
    static bool migrateLegacySettings(const QString &settingsPath);

    /**
     * Moves pre-camelCase gamefilters.ini keys (snake_case, game_type/<hash>) to the camelCase
     * keys used since #7084, for profiles that already migrated before that rename and therefore
     * never pass through migrateLegacySettings again. Copies values only where the new key is
     * absent, never deletes the old keys, and returns true when anything was copied. Idempotent,
     * so it runs on every startup.
     */
    static bool migrateGameFiltersToCamelCase(const QString &settingsPath);

    /**
     * Moves a non-default appearance/maxFontSize value into each user-writable theme
     * directory lacking an explicit CardText max (creating/merging fonts.toml, never
     * overwriting an explicit max), then deletes the legacy key. Default (12) or absent
     * values only delete the key and create no files, since the ThemeManager fallback
     * already covers them. Idempotent, safe to run on every startup.
     */
    static bool migrateAppearanceMaxFontSizeToTheme(const QString &settingsPath);

    /**
     * Returns true when at least one of the two migrations would still do work, i.e. when a
     * backup of the settings directory is worth taking before they run.
     */
    static bool isMigrationPending(const QString &settingsPath);

    /**
     * Copies the whole settings directory to a timestamped sibling folder, so a migration that
     * overwrites per-domain files can be undone by hand. Returns the backup path, or an empty
     * string when there was nothing to back up or the copy failed. Never aborts the migration.
     */
    static QString backupSettingsDirectory(const QString &settingsPath);
};

#endif // SETTINGS_MIGRATION_H