o3de/Code/Editor/Util/FileUtil.cpp

/*
 * Copyright (c) Contributors to the Open 3D Engine Project.
 * For complete copyright and license terms please see the LICENSE at the root of this distribution.
 *
 * SPDX-License-Identifier: Apache-2.0 OR MIT
 *
 */


#include "EditorDefs.h"

#include "FileUtil.h"
#include "FileUtil_Common.h"

// Qt
#include <QMenu>
#include <QMessageBox>
#include <QApplication>
#include <QClipboard>
#include <QDesktopServices>
#include <QEvent>
#include <QProcess>
#include <QPushButton>
#include <QThread>

// AzCore
#include <AzCore/Component/TickBus.h>
#include <AzCore/Settings/SettingsRegistryMergeUtils.h>
#include <AzCore/Utils/Utils.h>

// AzFramework

// AzQtComponents
#include <AzQtComponents/Utilities/DesktopUtilities.h>

// AzToolsFramework
#include <AzToolsFramework/UI/UICore/WidgetHelpers.h>
#include <AzToolsFramework/UI/UICore/ProgressShield.hxx>
#include <AzToolsFramework/API/EditorAssetSystemAPI.h>
#include <AzToolsFramework/Thumbnails/SourceControlThumbnailBus.h>

// Editor
#include "QtUtilWin.h"
#include "Settings.h"
#include "MainWindow.h"
#include "CheckOutDialog.h"
#include "Dialogs/Generic/UserOptions.h"
#include "UsedResources.h"
#include "StringHelpers.h"
#include "AutoDirectoryRestoreFileDialog.h"
#include "EditorPreferencesDialog.h"

namespace Platform
{
    // Forward declare platform specific functions
    bool RunCommandWithArguments(const QString& command, const QStringList& argsList);
    bool RunEditorWithArg(const QString& editor, const QString& arg);
    bool OpenUri(const QUrl& uri);
    QString GetDefaultEditor(const Common::EditFileType fileType);
    QString MakePlatformFileEditString(QString pathToEdit, int lineToEdit);
    bool CreatePath(const QString& strPath);
    const char* GetLuaCompilerName();
} // namespace Platform

bool CFileUtil::s_singleFileDlgPref[IFileUtil::EFILE_TYPE_LAST] = { true, true, true, true };
bool CFileUtil::s_multiFileDlgPref[IFileUtil::EFILE_TYPE_LAST] = { true, true, true, true };

CAutoRestorePrimaryCDRoot::~CAutoRestorePrimaryCDRoot()
{
    QDir::setCurrent(GetIEditor()->GetPrimaryCDFolder());
}

bool CFileUtil::ExtractFile(QString& file, bool bMsgBoxAskForExtraction, const char* pDestinationFilename)
{
    CCryFile cryfile;
    if (cryfile.Open(file.toUtf8().data(), "rb"))
    {
        // Check if in pack.
        if (cryfile.IsInPak())
        {
            if (bMsgBoxAskForExtraction)
            {
                AZ::IO::FixedMaxPath sPakName{ cryfile.GetPakPath() };
                // Cannot edit file in pack, suggest to extract it for editing.
                if (QMessageBox::critical(QApplication::activeWindow(), QString(),
                    QObject::tr("File %1 is inside a PAK file %2\r\nDo you want it to be extracted for editing ?").arg(file, sPakName.c_str()),
                    QMessageBox::Yes | QMessageBox::No) == QMessageBox::No)
                {
                    return false;
                }
            }

            if (pDestinationFilename)
            {
                file = pDestinationFilename;
            }

            CFileUtil::CreatePath(Path::GetPath(file));

            // Extract it from Pak file.
            QFile diskFile(file);

            if (diskFile.open(QFile::WriteOnly))
            {
                // Copy data from packed file to disk file.
                auto data = AZStd::make_unique<char[]>(cryfile.GetLength());
                cryfile.ReadRaw(data.get(), cryfile.GetLength());
                diskFile.write(data.get(), cryfile.GetLength());
            }
            else
            {
                Warning("Failed to create file %s on disk", file.toUtf8().data());
            }
        }
        else
        {

            if (auto fileIoBase = AZ::IO::FileIOBase::GetInstance(); fileIoBase != nullptr)
            {
                if (AZ::IO::FixedMaxPath resolvedFilePath; fileIoBase->ResolvePath(resolvedFilePath, cryfile.GetFilename()))
                {
                    file = QString::fromUtf8(resolvedFilePath.c_str(), static_cast<int>(resolvedFilePath.Native().size()));
                }
            }
        }

        return true;
    }

    return false;
}

//////////////////////////////////////////////////////////////////////////
QString CFileUtil::GetEditorForFileTypeFromPreferences(const Common::EditFileType fileType)
{
    QString textEditor;

    switch (fileType)
    {
    case Common::EditFileType::FILE_TYPE_SHADER:
        return gSettings.textEditorForShaders;
    case Common::EditFileType::FILE_TYPE_BSPACE:
        return gSettings.textEditorForBspaces;
    case Common::EditFileType::FILE_TYPE_SCRIPT:
        return gSettings.textEditorForScript;
    case Common::EditFileType::FILE_TYPE_TEXTURE:
        return gSettings.textureEditor;
    case Common::EditFileType::FILE_TYPE_ANIMATION:
        return gSettings.animEditor;
    default:
        AZ_Assert(false, "Unknown file type.");
        return "";
    }
}

void CFileUtil::HandlePrefsDialogForFileType(const Common::EditFileType fileType)
{
    // Open the preferences dialog.
    EditorPreferencesDialog dlg(MainWindow::instance());
    dlg.open();

    // Assign a filter string so that only the appropriate option shows up.
    switch (fileType)
    {
    case Common::EditFileType::FILE_TYPE_SHADER:
        dlg.SetFilterText("Shaders Editor");
        break;
    case Common::EditFileType::FILE_TYPE_BSPACE:
        dlg.SetFilterText("BSpace Editor");
        break;
    case Common::EditFileType::FILE_TYPE_SCRIPT:
        dlg.SetFilterText("Scripts Editor");
        break;
    case Common::EditFileType::FILE_TYPE_TEXTURE:
        dlg.SetFilterText("Texture Editor");
        break;
    case Common::EditFileType::FILE_TYPE_ANIMATION:
        dlg.SetFilterText("Animation Editor");
        break;
    default:
        AZ_Assert(false, "Unknown file type.");
        break;
    }

    // Wait for the dialog to complete.
    dlg.exec();
}

AZStd::string CFileUtil::GetSettingsKeyForFileType(const Common::EditFileType fileType)
{
    switch (fileType)
    {
    case Common::EditFileType::FILE_TYPE_BSPACE:
        return "Settings|TextEditorBSpaces";
    case Common::EditFileType::FILE_TYPE_SHADER:
        return "Settings|TextEditorShaders";
    case Common::EditFileType::FILE_TYPE_SCRIPT:
        return "Settings|TextEditorScript";
    case Common::EditFileType::FILE_TYPE_TEXTURE:
        return "Settings|TextureEditor";
    case Common::EditFileType::FILE_TYPE_ANIMATION:
        return "Settings|AnimationEditor";
    default:
        AZ_Assert(false, "Unknown file type.");
    }

    return "";
}

QString CFileUtil::HandleNoEditorAssigned(const Common::EditFileType fileType)
{
    QMessageBox dialog(AzToolsFramework::GetActiveWindow());
    dialog.setWindowTitle(QString());

    QAbstractButton* defaultButton = nullptr;
    QAbstractButton* assignButton = nullptr;

    QString defaultEditor = Platform::GetDefaultEditor(fileType);
    if (defaultEditor.isEmpty())
    {
        dialog.setText(QObject::tr("No editor is set for opening this file type. Would you like to go to update the default program?"));
        assignButton = dialog.addButton(QObject::tr("Settings"), QMessageBox::YesRole);
        dialog.addButton(QObject::tr("Cancel"), QMessageBox::RejectRole);
    }
    else
    {
        QString editorCapitalized = defaultEditor;
        editorCapitalized[0] = editorCapitalized[0].toUpper();
        dialog.setText(
            QObject::tr(
                "No editor is set for opening this file type. Would you like to open the file using %1 or update the default program?")
                .arg(editorCapitalized));
        defaultButton = dialog.addButton(editorCapitalized, QMessageBox::YesRole);
        assignButton = dialog.addButton(QObject::tr("Settings"), QMessageBox::YesRole);
        dialog.addButton(QObject::tr("Cancel"), QMessageBox::RejectRole);
    }

    dialog.exec();
    if (dialog.clickedButton() == defaultButton)
    {
        // Save the new default editor to settings.
        AZStd::string editorName = defaultEditor.toUtf8().data();
        AZStd::any editorAny = AZStd::make_any<AZStd::string>(defaultEditor.toUtf8().data());
        gSettings.SetValue(GetSettingsKeyForFileType(fileType), editorAny);

        return defaultEditor;
    }
    else if (dialog.clickedButton() == assignButton)
    {
        HandlePrefsDialogForFileType(fileType);

        return GetEditorForFileTypeFromPreferences(fileType);
    }
    return "";
}

QString CFileUtil::HandleEditorOpenFailure(const Common::EditFileType fileType, const QString& currentEditor)
{
    QMessageBox dialog(AzToolsFramework::GetActiveWindow());
    dialog.setWindowTitle(QString());

    QAbstractButton* defaultButton = nullptr;
    QAbstractButton* assignButton = nullptr;

    QString defaultEditor = Platform::GetDefaultEditor(fileType);
    if (defaultEditor == currentEditor)
    {
        dialog.setText(
            QObject::tr("Failed to run %1. Would you like to go to the settings and update the default program?").arg(currentEditor));
        assignButton = dialog.addButton(QObject::tr("Settings"), QMessageBox::YesRole);
        dialog.addButton(QObject::tr("Cancel"), QMessageBox::RejectRole);
    }
    else
    {
        QString editorCapitalized = defaultEditor;
        editorCapitalized[0] = editorCapitalized[0].toUpper();
        dialog.setText(QObject::tr("Failed to run %1. Would you like to use %2, or go to the settings and update the default program?")
                           .arg(currentEditor)
                           .arg(editorCapitalized));
        defaultButton = dialog.addButton(editorCapitalized, QMessageBox::YesRole);
        assignButton = dialog.addButton(QObject::tr("Settings"), QMessageBox::YesRole);
        dialog.addButton(QObject::tr("Cancel"), QMessageBox::RejectRole);
    }

    dialog.exec();
    if (dialog.clickedButton() == defaultButton)
    {
        return defaultEditor;
    }
    else if (dialog.clickedButton() == assignButton)
    {
        HandlePrefsDialogForFileType(fileType);

        return GetEditorForFileTypeFromPreferences(fileType);
    }
    return "";
}

//////////////////////////////////////////////////////////////////////////
void CFileUtil::EditTextFile(const char* txtFile, int line, IFileUtil::ETextFileType fileType)
{
    QString file = txtFile;

    QString fullPathName = Path::GamePathToFullPath(file);
    ExtractFile(fullPathName);
    QString cmd = Platform::MakePlatformFileEditString(fullPathName, line);

    Common::EditFileType editFileType = Common::EditFileType::FILE_TYPE_SCRIPT;

    switch (fileType)
    {
    case IFileUtil::ETextFileType::FILE_TYPE_BSPACE:
        editFileType = Common::EditFileType::FILE_TYPE_BSPACE;
        break;
    case IFileUtil::ETextFileType::FILE_TYPE_SCRIPT:
        editFileType = Common::EditFileType::FILE_TYPE_SCRIPT;
        break;
    case IFileUtil::ETextFileType::FILE_TYPE_SHADER:
        editFileType = Common::EditFileType::FILE_TYPE_SHADER;
        break;
    default:
        // Ensure nothing's been added to the ETextFileType enum we don't know about.
        AZ_Assert(false, "Unknown IFileUtil::ETextFileType value.");
        break;
    }

    EditFile(cmd, editFileType);
}

//////////////////////////////////////////////////////////////////////////
void CFileUtil::EditTextureFile(const char* textureFile, [[maybe_unused]] bool bUseGameFolder)
{
    using namespace AzToolsFramework;
    using namespace AzToolsFramework::AssetSystem;

    AZStd::string fullTexturePath;
    bool fullTexturePathFound = false;
    AZStd::string relativePath = textureFile;

    // First check if we have been given an empty path
    QString warningTitle = QObject::tr("Cannot open file!");
    if (relativePath.empty())
    {
        QString messageString = QObject::tr("Texture path is empty. You need to assign a texture first.");
        QMessageBox::warning(AzToolsFramework::GetActiveWindow(), warningTitle, messageString);
        return;
    }

    AssetSystemRequestBus::BroadcastResult(
        fullTexturePathFound, &AssetSystemRequest::GetFullSourcePathFromRelativeProductPath, relativePath, fullTexturePath);
    if (!fullTexturePathFound)
    {
        QString messageString = QObject::tr("Failed to find absolute path to %1 - could not open texture editor.").arg(textureFile);
        QMessageBox::warning(AzToolsFramework::GetActiveWindow(), warningTitle, messageString);
        return;
    }

    EditFile(fullTexturePath.c_str(), Common::EditFileType::FILE_TYPE_TEXTURE);
}

//////////////////////////////////////////////////////////////////////////

void CFileUtil::EditFile(const QString& filename, const Common::EditFileType fileType)
{
    QString editor = GetEditorForFileTypeFromPreferences(fileType);

    if (editor.isEmpty())
    {
        editor = HandleNoEditorAssigned(fileType);
    }

    // If editor is still not set, just drop out.
    if (editor.isEmpty())
    {
        return;
    }

    // Keep trying to open the file if the user changes the editor. If not, just drop out.
    while (!Platform::RunEditorWithArg(editor, filename))
    {
        editor = HandleEditorOpenFailure(fileType, editor);
        if (editor.isEmpty())
        {
            return;
        }
    }
}

//////////////////////////////////////////////////////////////////////////

void CFileUtil::FormatFilterString(QString& filter)
{
    const int numPipeChars = static_cast<int>(std::count(filter.begin(), filter.end(), '|'));
    if (numPipeChars == 1)
    {
        filter = QStringLiteral("%1||").arg(filter);
    }
    else if (numPipeChars > 1)
    {
        assert(numPipeChars % 2 != 0);
        if (!filter.contains("||"))
        {
            filter = QStringLiteral("%1||").arg(filter);
        }
    }
    else if (!filter.isEmpty())
    {
        filter = QStringLiteral("%1|%2||").arg(filter, filter);
    }
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::SelectFile(const QString& fileSpec, const QString& searchFolder, QString& fullFileName)
{
    QtUtil::QtMFCScopedHWNDCapture cap;
    CAutoDirectoryRestoreFileDialog dlg(QFileDialog::AcceptOpen, QFileDialog::ExistingFile, {}, searchFolder, fileSpec, {}, {}, cap);

    if (dlg.exec())
    {
        fullFileName = dlg.selectedFiles().first();
        return true;
        /*
        if (!fileName.IsEmpty())
        {
            relativeFileName = Path::GetRelativePath( fileName );
            if (!relativeFileName.IsEmpty())
            {
                return true;
            }
            else
            {
                Warning( "You must select files from %s folder",(const char*)GetIEditor()->GetPrimaryCDFolder(); );
            }
        }
        */
    }

    //  CSelectFileDlg cDialog;
    //  bool res = cDialog.SelectFileName( &fileName,&relativeFileName,fileSpec,searchFolder );
    return false;
}

bool CFileUtil::SelectFiles(const QString& fileSpec, const QString& searchFolder, QStringList& files)
{
    QtUtil::QtMFCScopedHWNDCapture cap;
    CAutoDirectoryRestoreFileDialog dlg(QFileDialog::AcceptOpen, QFileDialog::ExistingFiles, {}, searchFolder, fileSpec, {}, {}, cap);

    if (dlg.exec())
    {
        const QStringList selected = dlg.selectedFiles();
        foreach(const QString&file, selected)
        {
            files.push_back(file);
        }
    }

    if (!files.empty())
    {
        return true;
    }

    return false;
}

bool CFileUtil::SelectSaveFile(const QString& fileFilter, const QString& defaulExtension, const QString& startFolder, QString& fileName)
{
    QtUtil::QtMFCScopedHWNDCapture cap;
    CAutoDirectoryRestoreFileDialog dlg(QFileDialog::AcceptSave, {}, defaulExtension, startFolder, fileFilter, {}, {}, cap);

    if (dlg.exec())
    {
        fileName = dlg.selectedFiles().first();
        return true;
    }

    return false;
}

//////////////////////////////////////////////////////////////////////////
// Get directory contents.
//////////////////////////////////////////////////////////////////////////
inline bool ScanDirectoryFiles(const QString& root, const QString& path, const QString& fileSpec, IFileUtil::FileArray& files, bool bSkipPaks)
{
    bool anyFound = false;
    QString dir = Path::AddPathSlash(root + path);

    QString findFilter = Path::Make(dir, fileSpec);
    auto pIPak = GetIEditor()->GetSystem()->GetIPak();

    // Add all directories.

    AZ::IO::ArchiveFileIterator fhandle = pIPak->FindFirst(findFilter.toUtf8().data());
    if (fhandle)
    {
        do
        {
            // Skip back folders.
            if (fhandle.m_filename.front() == '.')
            {
                continue;
            }
            if ((fhandle.m_fileDesc.nAttrib & AZ::IO::FileDesc::Attribute::Subdirectory) == AZ::IO::FileDesc::Attribute::Subdirectory) // skip sub directories.
            {
                continue;
            }

            if (bSkipPaks && (fhandle.m_fileDesc.nAttrib & AZ::IO::FileDesc::Attribute::Archive) == AZ::IO::FileDesc::Attribute::Archive)
            {
                continue;
            }

            anyFound = true;

            IFileUtil::FileDesc file;
            file.filename = path + fhandle.m_filename.data();
            file.attrib = static_cast<unsigned int>(fhandle.m_fileDesc.nAttrib);
            file.size = fhandle.m_fileDesc.nSize;
            file.time_access = fhandle.m_fileDesc.tAccess;
            file.time_create = fhandle.m_fileDesc.tCreate;
            file.time_write = fhandle.m_fileDesc.tWrite;

            files.push_back(file);
        } while (fhandle = pIPak->FindNext(fhandle));
        pIPak->FindClose(fhandle);
    }

    /*
    CFileFind finder;
    bool bWorking = finder.FindFile( Path::Make(dir,fileSpec) );
    while (bWorking)
    {
        bWorking = finder.FindNextFile();

        if (finder.IsDots())
            continue;

        if (!finder.IsDirectory())
        {
            anyFound = true;

            IFileUtil::FileDesc fd;
            fd.filename = dir + finder.GetFileName();
            fd.nFileSize = finder.GetLength();

            finder.GetCreationTime( &fd.ftCreationTime );
            finder.GetLastAccessTime( &fd.ftLastAccessTime );
            finder.GetLastWriteTime( &fd.ftLastWriteTime );

            fd.dwFileAttributes = 0;
            if (finder.IsArchived())
                fd.dwFileAttributes |= FILE_ATTRIBUTE_ARCHIVE;
            if (finder.IsCompressed())
                fd.dwFileAttributes |= FILE_ATTRIBUTE_COMPRESSED;
            if (finder.IsNormal())
                fd.dwFileAttributes = FILE_ATTRIBUTE_NORMAL;
            if (finder.IsHidden())
                fd.dwFileAttributes = FILE_ATTRIBUTE_HIDDEN;
            if (finder.IsReadOnly())
                fd.dwFileAttributes = FILE_ATTRIBUTE_READONLY;
            if (finder.IsSystem())
                fd.dwFileAttributes = FILE_ATTRIBUTE_SYSTEM;
            if (finder.IsTemporary())
                fd.dwFileAttributes = FILE_ATTRIBUTE_TEMPORARY;

            files.push_back(fd);
        }
    }
    */

    return anyFound;
}

//////////////////////////////////////////////////////////////////////////
// Get directory contents.
//////////////////////////////////////////////////////////////////////////
inline int ScanDirectoryRecursive(const QString& root, const QString& path, const QString& fileSpec, IFileUtil::FileArray& files, bool recursive, bool addDirAlso,
    IFileUtil::ScanDirectoryUpdateCallBack updateCB, bool bSkipPaks)
{
    bool anyFound = false;
    QString dir = Path::AddPathSlash(root + path);

    if (updateCB)
    {
        QString msg = QObject::tr("Scanning %1...").arg(dir);
        if (updateCB(msg) == false)
        {
            return -1;
        }
    }

    if (ScanDirectoryFiles(root, Path::AddPathSlash(path), fileSpec, files, bSkipPaks))
    {
        anyFound = true;
    }

    if (recursive)
    {
        /*
        CFileFind finder;
        bool bWorking = finder.FindFile( Path::Make(dir,"*.*") );
        while (bWorking)
        {
            bWorking = finder.FindNextFile();

            if (finder.IsDots())
                continue;

            if (finder.IsDirectory())
            {
                // Scan directory.
                if (ScanDirectoryRecursive( root,Path::AddBackslash(path+finder.GetFileName()),fileSpec,files,recursive ))
                    anyFound = true;
            }
        }
        */

        auto pIPak = GetIEditor()->GetSystem()->GetIPak();

        // Add all directories.

        AZ::IO::ArchiveFileIterator fhandle = pIPak->FindFirst(Path::Make(dir, "*").toUtf8().data());
        if (fhandle)
        {
            do
            {
                // Skip back folders.
                if (fhandle.m_filename.front() == '.')
                {
                    continue;
                }

                if ((fhandle.m_fileDesc.nAttrib & AZ::IO::FileDesc::Attribute::Subdirectory) != AZ::IO::FileDesc::Attribute::Subdirectory) // skip not directories.
                {
                    continue;
                }

                if (bSkipPaks && (fhandle.m_fileDesc.nAttrib & AZ::IO::FileDesc::Attribute::Archive) == AZ::IO::FileDesc::Attribute::Archive)
                {
                    continue;
                }

                if (addDirAlso)
                {
                    IFileUtil::FileDesc Dir;
                    Dir.filename = path + QString::fromUtf8(fhandle.m_filename.data(), aznumeric_cast<int>(fhandle.m_filename.size()));
                    Dir.attrib = static_cast<unsigned int>(fhandle.m_fileDesc.nAttrib);
                    Dir.size = fhandle.m_fileDesc.nSize;
                    Dir.time_access = fhandle.m_fileDesc.tAccess;
                    Dir.time_create = fhandle.m_fileDesc.tCreate;
                    Dir.time_write = fhandle.m_fileDesc.tWrite;
                    files.push_back(Dir);
                }

                // Scan directory.
                int result = ScanDirectoryRecursive(root, Path::AddPathSlash(path + fhandle.m_filename.data()), fileSpec, files, recursive, addDirAlso, updateCB, bSkipPaks);
                if (result == -1)
                // Cancel the scan immediately.
                {
                    pIPak->FindClose(fhandle);
                    return -1;
                }
                else if (result == 1)
                {
                    anyFound = true;
                }
            } while (fhandle = pIPak->FindNext(fhandle));
            pIPak->FindClose(fhandle);
        }
    }

    return anyFound ? 1 : 0;
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::ScanDirectory(const QString& path, const QString& file, IFileUtil::FileArray& files, bool recursive,
    bool addDirAlso, IFileUtil::ScanDirectoryUpdateCallBack updateCB, bool bSkipPaks)
{
    QString fileSpec = Path::GetFile(file);
    QString localPath = Path::GetPath(file);
    return ScanDirectoryRecursive(Path::AddPathSlash(path), localPath, fileSpec, files, recursive, addDirAlso, updateCB, bSkipPaks) > 0;
}

void CFileUtil::ShowInExplorer([[maybe_unused]] const QString& path)
{
    AZStd::string assetRoot;
    if (auto settingsRegistry = AZ::SettingsRegistry::Get(); settingsRegistry != nullptr)
    {
        settingsRegistry->Get(assetRoot, AZ::SettingsRegistryMergeUtils::FilePathKey_CacheRootFolder);
    }

    auto fullpath = QString::fromUtf8(assetRoot.c_str(), aznumeric_cast<int>(assetRoot.size()));
    AzQtComponents::ShowFileOnDesktop(fullpath);
}

/*
bool CFileUtil::ScanDirectory( const QString &startDirectory,const QString &searchPath,const QString &fileSpec,FileArray &files, bool recursive=true )
{
    return ScanDirectoryRecursive(startDirectory,SearchPath,file,files,recursive );
}
*/

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::OverwriteFile(const QString& filename)
{
    AZ::IO::FileIOBase* fileIO = AZ::IO::FileIOBase::GetInstance();
    AZ_Assert(fileIO, "FileIO is not initialized.");

    QString adjFileName = Path::GamePathToFullPath(filename);

    AZStd::string filePath = adjFileName.toUtf8().data();
    if (!fileIO->IsReadOnly(filePath.c_str()))
    {
        // if its already writable, we can just RequestEdit async and return immediately
        // RequestEdit will mark it for "add" if it needs to be added.
        using namespace AzToolsFramework;
        SourceControlCommandBus::Broadcast(&SourceControlCommandBus::Events::RequestEdit, filePath.c_str(), true, [](bool, const SourceControlFileInfo&) {});
        return true;
    }

    // Otherwise, show the checkout dialog
    if (!CCheckOutDialog::IsForAll())
    {
        QtUtil::QtMFCScopedHWNDCapture cap;
        CCheckOutDialog dlg(adjFileName, cap);
        dlg.exec();
    }

    bool opSuccess = false;
    switch (CCheckOutDialog::LastResult())
    {
    case CCheckOutDialog::CANCEL:
        break;
    case CCheckOutDialog::CHECKOUT:
        opSuccess = CheckoutFile(filePath.c_str());
        break;
    case CCheckOutDialog::OVERWRITE:
        opSuccess = AZ::IO::SystemFile::SetWritable(filePath.c_str(), true);
        break;
    default:
        AZ_Assert(false, "Unsupported result returned from CCheckoutDialog");
    }

    return opSuccess;
}

//////////////////////////////////////////////////////////////////////////
void BlockAndWait(const bool& opComplete, QWidget* parent, const char* message)
{
    bool useProgressShield = false;
    bool isGUIThread = false;
    if (QApplication::instance()->thread() == QThread::currentThread())
    {
        isGUIThread = true;
        if (!parent)
        {
            parent = QApplication::activeWindow() ? QApplication::activeWindow() : MainWindow::instance();
        }

        useProgressShield = parent ? true : false;
    }

    if (useProgressShield)
    {
        // ProgressShield will internally pump the Qt Event Pump and the AZ::TickBus.
        AzToolsFramework::ProgressShield::LegacyShowAndWait(parent, parent->tr(message),
            [&opComplete](int& current, int& max)
            {
                current = 0;
                max = 0;
                return opComplete;
            },
            500);
    }
    else
    {
        // either we are not on the main thread or we are not using the progress shield.
        while (!opComplete)
        {
            // we can ONLY interact with the application event loop or the AZ::TickBus from the GUI thread.
            if (isGUIThread)
            {
                // note that 16ms below is not the amount of time to wait, its the maximum time that
                // processEvents is allowed to keep processing them if they just keep being emitted.
                // adding a maximum time here means that we get an opportunity to pump the TickBus
                // periodically even during a flood of events.
                QCoreApplication::processEvents(QEventLoop::ExcludeUserInputEvents, 16);
                AZ::TickBus::ExecuteQueuedEvents();
            }

            // if we are not the main thread then the above will be done by the main thread, and we can just wait for it to happen.
            // its fairly important we don't sleep for really long because this legacy code is often invoked in a blocking loop
            // for many items, and in the worst case, any time we spend sleeping here will be added to each item.
            AZStd::this_thread::yield();
        }
    }
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::CheckoutFile(const char* filename, QWidget* parentWindow)
{
    using namespace AzToolsFramework;

    bool scOpSuccess = false;
    bool scOpComplete = false;
    SourceControlCommandBus::Broadcast(&SourceControlCommandBus::Events::RequestEdit, filename, true,
        [&scOpSuccess, &scOpComplete, filename](bool success, const SourceControlFileInfo& /*info*/)
        {
            scOpSuccess = success;
            scOpComplete = true;
            Thumbnailer::SourceControlThumbnailRequestBus::Broadcast(&Thumbnailer::SourceControlThumbnailRequests::FileStatusChanged, filename);
        }
    );

    BlockAndWait(scOpComplete, parentWindow, "Checking out for edit...");
    return scOpSuccess;
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::RevertFile(const char* filename, QWidget* parentWindow)
{
    using namespace AzToolsFramework;

    bool scOpSuccess = false;
    bool scOpComplete = false;
    SourceControlCommandBus::Broadcast(&SourceControlCommandBus::Events::RequestRevert, filename,
        [&scOpSuccess, &scOpComplete, filename](bool success, const SourceControlFileInfo& /*info*/)
        {
            scOpSuccess = success;
            scOpComplete = true;
            Thumbnailer::SourceControlThumbnailRequestBus::Broadcast(&Thumbnailer::SourceControlThumbnailRequests::FileStatusChanged, filename);
        }
    );

    BlockAndWait(scOpComplete, parentWindow, "Discarding Changes...");
    return scOpSuccess;
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::RenameFile(const char* sourceFile, const char* targetFile, QWidget* parentWindow)
{
    using namespace AzToolsFramework;

    bool scOpSuccess = false;
    bool scOpComplete = false;
    SourceControlCommandBus::Broadcast(&SourceControlCommandBus::Events::RequestRename, sourceFile, targetFile,
        [&scOpSuccess, &scOpComplete](bool success, const SourceControlFileInfo& /*info*/)
        {
            scOpSuccess = success;
            scOpComplete = true;
        }
    );

    BlockAndWait(scOpComplete, parentWindow, "Renaming file...");
    return scOpSuccess;
}

bool  override;

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::DeleteFromSourceControl(const char* filename, QWidget* parentWindow)
{
    using namespace AzToolsFramework;

    bool scOpSuccess = false;
    bool scOpComplete = false;
    SourceControlCommandBus::Broadcast(&SourceControlCommandBus::Events::RequestDelete, filename,
        [&scOpSuccess, &scOpComplete, filename](bool success, const SourceControlFileInfo& /*info*/)
        {
            scOpSuccess = success;
            scOpComplete = true;
            Thumbnailer::SourceControlThumbnailRequestBus::Broadcast(&Thumbnailer::SourceControlThumbnailRequests::FileStatusChanged, filename);
        }
    );

    BlockAndWait(scOpComplete, parentWindow, "Marking for deletion...");
    return scOpSuccess;
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::GetLatestFromSourceControl(const char* filename, QWidget* parentWindow)
{
    using namespace AzToolsFramework;

    bool scOpSuccess = false;
    bool scOpComplete = false;
    SourceControlCommandBus::Broadcast(&SourceControlCommandBus::Events::RequestLatest, filename,
        [&scOpSuccess, &scOpComplete, filename](bool success, const SourceControlFileInfo& /*info*/)
        {
            scOpSuccess = success;
            scOpComplete = true;
            Thumbnailer::SourceControlThumbnailRequestBus::Broadcast(&Thumbnailer::SourceControlThumbnailRequests::FileStatusChanged, filename);
        }
    );

    BlockAndWait(scOpComplete, parentWindow, "Requesting latest version of file...");
    return scOpSuccess;
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::GetFileInfoFromSourceControl(const char* filename, AzToolsFramework::SourceControlFileInfo& fileInfo, QWidget* parentWindow)
{
    using namespace AzToolsFramework;

    bool scOpSuccess = false;
    bool scOpComplete = false;
    SourceControlCommandBus::Broadcast(&SourceControlCommandBus::Events::GetFileInfo, filename,
        [&fileInfo, &scOpSuccess, &scOpComplete](bool success, const SourceControlFileInfo& info)
        {
            fileInfo = info;
            scOpSuccess = success;
            scOpComplete = true;
        }
    );

    BlockAndWait(scOpComplete, parentWindow, "Getting file status...");
    return scOpSuccess;
}

// Create new directory, check if directory already exist.
static bool CheckAndCreateDirectory(const QString& path)
{
    // QFileInfo does not handle mixed separators (/ and \) gracefully, so cleaning up path
    const QString cleanPath = QDir::cleanPath(path).replace('\\', '/');
    QFileInfo fileInfo(cleanPath);
    if (fileInfo.isDir())
    {
        return true;
    }
    else if (!fileInfo.exists())
    {
        return QDir().mkpath(cleanPath);
    }
    return false;
}

static bool MoveFileReplaceExisting(const QString& existingFileName, const QString& newFileName)
{
    bool moveSuccessful = false;

    // Delete the new file if it already exists
    QFile newFile(newFileName);
    if (newFile.exists())
    {
        newFile.setPermissions(newFile.permissions() | QFile::ReadOther | QFile::WriteOther);
        newFile.remove();
    }

    // Rename the existing file if it exists
    QFile existingFile(existingFileName);
    if (existingFile.exists())
    {
        existingFile.setPermissions(existingFile.permissions() | QFile::ReadOther | QFile::WriteOther);
        moveSuccessful = existingFile.rename(newFileName);
    }

    return moveSuccessful;
}
//////////////////////////////////////////////////////////////////////////
bool CFileUtil::CreateDirectory(const char* directory)
{
    QString path = directory;
    if (GetIEditor()->GetConsoleVar("ed_lowercasepaths"))
    {
        path = path.toLower();
    }

    return CheckAndCreateDirectory(path);
}

//////////////////////////////////////////////////////////////////////////
void CFileUtil::BackupFile(const char* filename)
{
    // Make a backup of previous file.
    bool makeBackup = true;

    QString bakFilename = Path::ReplaceExtension(filename, "bak");

    // Check if backup needed.
    QFile bak(filename);
    if (bak.open(QFile::ReadOnly))
    {
        if (bak.size() <= 0)
        {
            makeBackup = false;
        }
    }
    else
    {
        makeBackup = false;
    }
    bak.close();

    if (makeBackup)
    {
        QString bakFilename2 = Path::ReplaceExtension(bakFilename, "bak2");
        MoveFileReplaceExisting(bakFilename, bakFilename2);
        MoveFileReplaceExisting(filename, bakFilename);
    }
}

//////////////////////////////////////////////////////////////////////////
void CFileUtil::BackupFileDated(const char* filename, bool bUseBackupSubDirectory /*=false*/)
{
    bool makeBackup = true;
    {
        // Check if backup needed.
        QFile bak(filename);
        if (bak.open(QFile::ReadOnly))
        {
            if (bak.size() <= 0)
            {
                makeBackup = false;
            }
        }
        else
        {
            makeBackup = false;
        }
    }

    if (makeBackup)
    {
        // Generate new filename
        time_t ltime;
        time(&ltime);
        tm today;
#if AZ_TRAIT_USE_SECURE_CRT_FUNCTIONS
        localtime_s(&today, &ltime);
#else
        today = *localtime(&ltime);
#endif

        char sTemp[128];
        strftime(sTemp, sizeof(sTemp), ".%Y%m%d.%H%M%S.", &today);
        QString bakFilename = Path::RemoveExtension(filename) + sTemp + Path::GetExt(filename);

        if (bUseBackupSubDirectory)
        {
            QString sBackupPath = Path::ToUnixPath(Path::GetPath(filename)) + QString("/backups");
            CFileUtil::CreateDirectory(sBackupPath.toUtf8().data());
            bakFilename = sBackupPath + QString("/") + Path::GetFile(bakFilename);
        }

        // Do the backup
        MoveFileReplaceExisting(filename, bakFilename);
    }
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::Deltree(const char* szFolder, [[maybe_unused]] bool bRecurse)
{
    return QDir(szFolder).removeRecursively();
}

//////////////////////////////////////////////////////////////////////////
bool   CFileUtil::Exists(const QString& strPath, bool boDirectory, IFileUtil::FileDesc* pDesc)
{
    auto pIPak = GetIEditor()->GetSystem()->GetIPak();
    bool                        boIsDirectory(false);

    AZ::IO::ArchiveFileIterator nFindHandle = pIPak->FindFirst(strPath.toUtf8().data());
    // If it found nothing, no matter if it is a file or directory, it was not found.
    if (!nFindHandle)
    {
        return false;
    }
    pIPak->FindClose(nFindHandle);

    if ((nFindHandle.m_fileDesc.nAttrib & AZ::IO::FileDesc::Attribute::Subdirectory) == AZ::IO::FileDesc::Attribute::Subdirectory)
    {
        boIsDirectory = true;
    }
    else if (pDesc)
    {
        pDesc->filename = strPath;
        pDesc->attrib = static_cast<unsigned int>(nFindHandle.m_fileDesc.nAttrib);
        pDesc->size = nFindHandle.m_fileDesc.nSize;
        pDesc->time_access = nFindHandle.m_fileDesc.tAccess;
        pDesc->time_create = nFindHandle.m_fileDesc.tCreate;
        pDesc->time_write = nFindHandle.m_fileDesc.tWrite;
    }

    // If we are seeking directories...
    if (boDirectory)
    {
        // The return value will tell us if the found element is a directory.
        return boIsDirectory;
    }
    else
    {
        // If we are not seeking directories...
        // We return true if the found element is not a directory.
        return !boIsDirectory;
    }
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::FileExists(const QString& strFilePath, IFileUtil::FileDesc* pDesc)
{
    return Exists(strFilePath, false, pDesc);
}

//////////////////////////////////////////////////////////////////////////
bool CFileUtil::PathExists(const QString& strPath)
{
    return Exists(strPath, true);
}

bool CFileUtil::GetDiskFileSize(const char* pFilePath, uint64& rOutSize)
{
    const QFileInfo fi(pFilePath);
    rOutSize = fi.size();
    return fi.exists();
}

//////////////////////////////////////////////////////////////////////////
bool   CFileUtil::IsFileExclusivelyAccessable(const QString& strFilePath)
{
    // this was simply trying to open the file before, so keep it like that
    QFile f(strFilePath);
    return f.open(QFile::ReadOnly);
}
//////////////////////////////////////////////////////////////////////////
bool   CFileUtil::CreatePath(const QString& strPath)
{
#if !AZ_TRAIT_OS_USE_WINDOWS_FILE_PATHS
    bool pathCreated = true;

    QString cleanPath = QDir::cleanPath(strPath);
    QDir path(cleanPath);
    if (!path.exists())
    {
        pathCreated = path.mkpath(cleanPath);
    }

    return pathCreated;
#else
    QString                                 strDriveLetter;
    QString                                 strDirectory;
    QString                                 strFilename;
    QString                                 strExtension;
    QString                                 strCurrentDirectoryPath;
    QStringList                             cstrDirectoryQueue;
    size_t                                  nCurrentPathQueue(0);
    size_t                                  nTotalPathQueueElements(0);
    bool                                    bnLastDirectoryWasCreated(false);

    if (PathExists(strPath))
    {
        return true;
    }

    Path::SplitPath(strPath, strDriveLetter, strDirectory, strFilename, strExtension);
    Path::GetDirectoryQueue(strDirectory, cstrDirectoryQueue);

    if (!strDriveLetter.isEmpty())
    {
        strCurrentDirectoryPath = strDriveLetter;
        strCurrentDirectoryPath += AZ_CORRECT_FILESYSTEM_SEPARATOR_STRING;
    }

    nTotalPathQueueElements = cstrDirectoryQueue.size();
    for (nCurrentPathQueue = 0; nCurrentPathQueue < nTotalPathQueueElements; ++nCurrentPathQueue)
    {
        strCurrentDirectoryPath += cstrDirectoryQueue[static_cast<int>(nCurrentPathQueue)];
        strCurrentDirectoryPath += AZ_CORRECT_FILESYSTEM_SEPARATOR_STRING;
        // The value which will go out of this loop is the result of the attempt to create the
        // last directory, only.

        strCurrentDirectoryPath = Path::CaselessPaths(strCurrentDirectoryPath);
        bnLastDirectoryWasCreated = QDir().mkpath(strCurrentDirectoryPath);
    }

    if (!bnLastDirectoryWasCreated)
    {
        if (!QDir(strCurrentDirectoryPath).exists())
        {
            return false;
        }
    }

    return true;
#endif // !AZ_TRAIT_OS_USE_WINDOWS_FILE_PATHS
}

//////////////////////////////////////////////////////////////////////////
bool   CFileUtil::DeleteFile(const QString& strPath)
{
    QFile(strPath).setPermissions(QFile::ReadOther | QFile::WriteOther);
    return QFile::remove(strPath);
}
//////////////////////////////////////////////////////////////////////////
bool CFileUtil::RemoveDirectory(const QString& strPath)
{
    return Deltree(strPath.toUtf8().data(), true);
}

void CFileUtil::ForEach(const QString& path, std::function<void(const QString&)> predicate, bool recurse)
{
    bool trailingSlash = path.endsWith('/') || path.endsWith('\\');
    const QString dirName = trailingSlash ? path.left(path.length() - 1) : path;
    QDirIterator::IteratorFlags flags = QDirIterator::NoIteratorFlags;

    if (recurse)
    {
        flags = QDirIterator::Subdirectories;
    }

    QDirIterator dirIterator(path, QDir::Files | QDir::Dirs | QDir::NoDotAndDotDot, flags);
    while (dirIterator.hasNext())
    {
        dirIterator.next();
        QString filePath = Path::ToUnixPath(dirIterator.filePath());
        predicate(filePath);
    }
}

//////////////////////////////////////////////////////////////////////////
IFileUtil::ECopyTreeResult CFileUtil::CopyTree(const QString& strSourceDirectory, const QString& strTargetDirectory, bool boRecurse, bool boConfirmOverwrite, const char* const ignoreFilesAndFolders)
{
    static CUserOptions             oFileOptions;
    static CUserOptions             oDirectoryOptions;

    CUserOptions::CUserOptionsReferenceCountHelper  oFileOptionsHelper(oFileOptions);
    CUserOptions::CUserOptionsReferenceCountHelper  oDirectoryOptionsHelper(oDirectoryOptions);

    IFileUtil::ECopyTreeResult                      eCopyResult(IFileUtil::ETREECOPYOK);

    QStringList            cFiles;
    QStringList            cDirectories;

    size_t                                      nCurrent(0);
    size_t                                      nTotal(0);

    // For this function to work properly, it has to first process all files in the directory AND JUST AFTER IT
    // work on the sub-folders...this is NOT OBVIOUS, but imagine the case where you have a hierarchy of folders,
    // all with the same names and all with the same files names inside. If you would make a depth-first search
    // you could end up with the files from the deepest folder in ALL your folders.

    std::vector<AZStd::string> ignoredPatterns;
    StringHelpers::Split(ignoreFilesAndFolders, "|", false, ignoredPatterns);

    QDirIterator::IteratorFlags flags = QDirIterator::NoIteratorFlags;

    if (boRecurse)
    {
        flags = QDirIterator::Subdirectories;
    }

    QDir sourceDir(strSourceDirectory);
    QDir targetDir(strTargetDirectory);

    QDirIterator dirIterator(strSourceDirectory, {"*.*"}, QDir::Files, flags);

    if (!dirIterator.hasNext())
    {
        return IFileUtil::ETREECOPYOK;
    }

    while (dirIterator.hasNext())
    {
        const QString filePath = dirIterator.next();
        const QString fileName = QFileInfo(filePath).fileName();

        bool ignored = false;
        for (const AZStd::string& ignoredFile : ignoredPatterns)
        {
            if (StringHelpers::CompareIgnoreCase(fileName.toStdString().c_str(), ignoredFile.c_str()) == 0)
            {
                ignored = true;
                break;
            }
        }
        if (ignored)
        {
            continue;
        }

        QFileInfo fileInfo(filePath);
        if (fileInfo.isDir())
        {
            if (boRecurse)
            {
                cDirectories.push_back(fileName);
            }
        }
        else
        {
            cFiles.push_back(fileName);
        }
    }

    // First we copy all files (maybe not all, depending on the user options...)
    nTotal = cFiles.size();
    for (nCurrent = 0; nCurrent < nTotal; ++nCurrent)
    {
        bool        bnLastFileWasCopied(false);


        if (eCopyResult == IFileUtil::ETREECOPYUSERCANCELED)
        {
            return eCopyResult;
        }

        QString sourceName = sourceDir.absoluteFilePath(cFiles[static_cast<int>(nCurrent)]);
        QString targetName = targetDir.absoluteFilePath(cFiles[static_cast<int>(nCurrent)]);

        if (boConfirmOverwrite)
        {
            if (QFileInfo::exists(targetName))
            {
                // If the directory already exists...
                // we must warn our user about the possible actions.
                int             nUserOption(0);

                if (boConfirmOverwrite)
                {
                    // If the option is not valid to all folder, we must ask anyway again the user option.
                    if (!oFileOptions.IsOptionToAll())
                    {
                        const int ret = QMessageBox::question(AzToolsFramework::GetActiveWindow(),
                            QObject::tr("Confirm file overwrite?"),
                            QObject::tr("There is already a file named \"%1\" in the target folder. Do you want to move this file anyway replacing the old one?")
                                .arg(cFiles[static_cast<int>(nCurrent)]),
                            QMessageBox::YesToAll | QMessageBox::Yes | QMessageBox::No | QMessageBox::Cancel);

                        switch (ret) {
                        case QMessageBox::YesToAll: /* fall-through */
                        case QMessageBox::Yes:    nUserOption = IDYES; break;
                        case QMessageBox::No:     nUserOption = IDNO; break;
                        case QMessageBox::Cancel: nUserOption = IDCANCEL; break;
                        }

                        oFileOptions.SetOption(nUserOption, ret == QMessageBox::YesToAll);
                    }
                    else
                    {
                        nUserOption = oFileOptions.GetOption();
                    }
                }

                switch (nUserOption)
                {
                case IDYES:
                {
                    // Actually, we need to do nothing in this case.
                }
                break;

                case IDNO:
                {
                    eCopyResult = IFileUtil::ETREECOPYUSERDIDNTCOPYSOMEITEMS;
                    continue;
                }
                break;

                // This IS ALWAYS for all... so it's easy to deal with.
                case IDCANCEL:
                {
                    return IFileUtil::ETREECOPYUSERCANCELED;
                }
                break;
                }
            }
        }

        bnLastFileWasCopied = QFile::copy(sourceName, targetName);
        if (!bnLastFileWasCopied)
        {
            eCopyResult = IFileUtil::ETREECOPYFAIL;
        }
    }

    // Now we can recurse into the directories, if needed.
    nTotal = cDirectories.size();
    for (nCurrent = 0; nCurrent < nTotal; ++nCurrent)
    {
        if (eCopyResult == IFileUtil::ETREECOPYUSERCANCELED)
        {
            return eCopyResult;
        }

        bool        bnLastDirectoryWasCreated(false);

        QString sourceName = sourceDir.absoluteFilePath(cDirectories[static_cast<int>(nCurrent)]);
        QString targetName = targetDir.absoluteFilePath(cDirectories[static_cast<int>(nCurrent)]);

        bnLastDirectoryWasCreated = QDir().mkpath(targetName);

        if (!bnLastDirectoryWasCreated)
        {
            if (!QDir(targetName).exists())
            {
                return IFileUtil::ETREECOPYFAIL;
            }
            else
            {
                // If the directory already exists...
                // we must warn our user about the possible actions.
                int             nUserOption(0);

                if (boConfirmOverwrite)
                {
                    // If the option is not valid to all folder, we must ask anyway again the user option.
                    if (!oDirectoryOptions.IsOptionToAll())
                    {
                        const int ret = QMessageBox::question(AzToolsFramework::GetActiveWindow(),
                            QObject::tr("Confirm directory overwrite?"),
                            QObject::tr("There is already a folder named \"%1\" in the target folder. Do you want to move this folder anyway?")
                                .arg(cDirectories[static_cast<int>(nCurrent)]),
                            QMessageBox::YesToAll | QMessageBox::Yes | QMessageBox::No | QMessageBox::Cancel);

                        switch (ret) {
                            case QMessageBox::YesToAll: /* fall-through */
                            case QMessageBox::Yes:    nUserOption = IDYES; break;
                            case QMessageBox::No:     nUserOption = IDNO; break;
                            case QMessageBox::Cancel: nUserOption = IDCANCEL; break;
                        }

                        oDirectoryOptions.SetOption(nUserOption, ret == QMessageBox::YesToAll);
                    }
                    else
                    {
                        nUserOption = oDirectoryOptions.GetOption();
                    }
                }

                switch (nUserOption)
                {
                case IDYES:
                {
                    // Actually, we need to do nothing in this case.
                }
                break;

                case IDNO:
                {
                    // If no, we just need to go to the next item.
                    eCopyResult = IFileUtil::ETREECOPYUSERDIDNTCOPYSOMEITEMS;
                    continue;
                }
                break;

                // This IS ALWAYS for all... so it's easy to deal with.
                case IDCANCEL:
                {
                    return IFileUtil::ETREECOPYUSERCANCELED;
                }
                break;
                }
            }
        }

        eCopyResult = CopyTree(sourceName, targetName, boRecurse, boConfirmOverwrite, ignoreFilesAndFolders);
    }

    return eCopyResult;
}
//////////////////////////////////////////////////////////////////////////
IFileUtil::ECopyTreeResult   CFileUtil::CopyFile(const QString& strSourceFile, const QString& strTargetFile, bool boConfirmOverwrite, ProgressRoutine pfnProgress, bool* pbCancel)
{
    CUserOptions                            oFileOptions;
    IFileUtil::ECopyTreeResult                      eCopyResult(IFileUtil::ETREECOPYOK);

    bool                                        bnLastFileWasCopied(false);
    QString                                     name(strSourceFile);
    QString                                     strQueryFilename;
    QString                                     strFullStargetName;

    QString strTargetName(strTargetFile);
    if (GetIEditor()->GetConsoleVar("ed_lowercasepaths"))
    {
        strTargetName = strTargetName.toLower();
    }

    QString strDriveLetter, strDirectory, strFilename, strExtension;
    Path::SplitPath(strTargetName, strDriveLetter, strDirectory, strFilename, strExtension);
    strFullStargetName = strDriveLetter;
    strFullStargetName += strDirectory;

    if (strFilename.isEmpty())
    {
        strFullStargetName += Path::GetFileName(strSourceFile);
        strFullStargetName += ".";
        strFullStargetName += Path::GetExt(strSourceFile);
    }
    else
    {
        strFullStargetName += strFilename;
        strFullStargetName += strExtension;
    }


    if (boConfirmOverwrite)
    {
        if (QFileInfo::exists(strFullStargetName))
        {
            strQueryFilename = strFilename;
            if (strFilename.isEmpty())
            {
                strQueryFilename = Path::GetFileName(strSourceFile);
                strQueryFilename += ".";
                strQueryFilename += Path::GetExt(strSourceFile);
            }
            else
            {
                strQueryFilename += strExtension;
            }

            // If the directory already exists...
            // we must warn our user about the possible actions.
            int             nUserOption(0);

            if (boConfirmOverwrite)
            {
                // If the option is not valid to all folder, we must ask anyway again the user option.
                if (!oFileOptions.IsOptionToAll())
                {
                    const int ret = QMessageBox::question(AzToolsFramework::GetActiveWindow(),
                        QObject::tr("Confirm file overwrite?"),
                        QObject::tr("There is already a file named \"%1\" in the target folder. Do you want to move this file anyway replacing the old one?")
                            .arg(strQueryFilename),
                        QMessageBox::Yes | QMessageBox::No | QMessageBox::Cancel);

                    switch (ret) {
                    case QMessageBox::Yes:    nUserOption = IDYES; break;
                    case QMessageBox::No:     nUserOption = IDNO; break;
                    case QMessageBox::Cancel: nUserOption = IDCANCEL; break;
                    }

                    oFileOptions.SetOption(nUserOption, false);
                }
                else
                {
                    nUserOption = oFileOptions.GetOption();
                }
            }

            switch (nUserOption)
            {
            case IDYES:
            {
                // Actually, we need to do nothing in this case.
            }
            break;

            case IDNO:
            {
                return eCopyResult = IFileUtil::ETREECOPYUSERCANCELED;
            }
            break;

            // This IS ALWAYS for all... so it's easy to deal with.
            case IDCANCEL:
            {
                return IFileUtil::ETREECOPYUSERCANCELED;
            }
            break;
            }
        }
    }

    bnLastFileWasCopied = false;

    QFile source(name);
    if (source.open(QFile::ReadOnly))
    {
        QFile out(strFullStargetName);
        if (out.open(QFile::ReadWrite))
        {
            bnLastFileWasCopied = true;
            char block[4096];
            qint64 totalRead = 0;
            while (!source.atEnd())
            {
                qint64 in = source.read(block, sizeof(block));
                if (in <= 0)
                {
                    break;
                }
                totalRead += in;
                if (in != out.write(block, in))
                {
                    bnLastFileWasCopied = false;
                    break;
                }
                if (pbCancel && *pbCancel == true)
                {
                    bnLastFileWasCopied = false;
                    break;
                }
                if (pfnProgress)
                {
                    pfnProgress(source.size(), totalRead, 0, 0, 0, 0, nullptr, nullptr, nullptr);
                }
            }
            if (totalRead != source.size())
            {
                bnLastFileWasCopied = false;
            }
        }
    }

    if (!bnLastFileWasCopied)
    {
        eCopyResult = IFileUtil::ETREECOPYFAIL;
    }

    return eCopyResult;
}
//////////////////////////////////////////////////////////////////////////
IFileUtil::ECopyTreeResult   CFileUtil::MoveTree(const QString& strSourceDirectory, const QString& strTargetDirectory, bool boRecurse, bool boConfirmOverwrite)
{
    static CUserOptions             oFileOptions;
    static CUserOptions             oDirectoryOptions;

    CUserOptions::CUserOptionsReferenceCountHelper  oFileOptionsHelper(oFileOptions);
    CUserOptions::CUserOptionsReferenceCountHelper  oDirectoryOptionsHelper(oDirectoryOptions);

    IFileUtil::ECopyTreeResult                  eCopyResult(IFileUtil::ETREECOPYOK);

    QStringList            cFiles;
    QStringList            cDirectories;

    size_t                                      nCurrent(0);
    size_t                                      nTotal(0);

    // For this function to work properly, it has to first process all files in the directory AND JUST AFTER IT
    // work on the sub-folders...this is NOT OBVIOUS, but imagine the case where you have a hierarchy of folders,
    // all with the same names and all with the same files names inside. If you would make a depth-first search
    // you could end up with the files from the deepest folder in ALL your folders.

    QDirIterator::IteratorFlags flags = QDirIterator::NoIteratorFlags;

    if (boRecurse)
    {
        flags = QDirIterator::Subdirectories;
    }

    QDirIterator dirIterator(strSourceDirectory, {"*.*"}, QDir::Files, flags);

    if (!dirIterator.hasNext())
    {
        return IFileUtil::ETREECOPYOK;
    }

    QDir sourceDir(strSourceDirectory);
    QDir targetDir(strTargetDirectory);

    while (dirIterator.hasNext())
    {
        const QString filePath = dirIterator.next();
        const QString fileName = QFileInfo(filePath).fileName();

        QFileInfo fileInfo(filePath);
        if (fileInfo.isDir())
        {
            if (boRecurse)
            {
                cDirectories.push_back(fileName);
            }
        }
        else
        {
            cFiles.push_back(fileName);
        }
    }

    // First we copy all files (maybe not all, depending on the user options...)
    nTotal = cFiles.size();
    for (nCurrent = 0; nCurrent < nTotal; ++nCurrent)
    {
        if (eCopyResult == IFileUtil::ETREECOPYUSERCANCELED)
        {
            return eCopyResult;
        }

        bool    bnLastFileWasCopied(false);
        QString sourceName(sourceDir.absoluteFilePath(cFiles[static_cast<int>(nCurrent)]));
        QString targetName(targetDir.absoluteFilePath(cFiles[static_cast<int>(nCurrent)]));

        if (boConfirmOverwrite)
        {
            if (QFileInfo::exists(targetName))
            {
                // If the directory already exists...
                // we must warn our user about the possible actions.
                int             nUserOption(0);

                if (boConfirmOverwrite)
                {
                    // If the option is not valid to all folder, we must ask anyway again the user option.
                    if (!oFileOptions.IsOptionToAll())
                    {
                        const int ret = QMessageBox::question(AzToolsFramework::GetActiveWindow(),
                            QObject::tr("Confirm file overwrite?"),
                            QObject::tr("There is already a file named \"%1\" in the target folder. Do you want to move this file anyway replacing the old one?")
                                .arg(cFiles[static_cast<int>(nCurrent)]),
                            QMessageBox::YesToAll | QMessageBox::Yes | QMessageBox::No | QMessageBox::Cancel);

                        switch (ret) {
                        case QMessageBox::YesToAll: /* fall-through */
                        case QMessageBox::Yes:    nUserOption = IDYES; break;
                        case QMessageBox::No:     nUserOption = IDNO; break;
                        case QMessageBox::Cancel: nUserOption = IDCANCEL; break;
                        }

                        oFileOptions.SetOption(nUserOption, ret == QMessageBox::YesToAll);
                    }
                    else
                    {
                        nUserOption = oFileOptions.GetOption();
                    }
                }

                switch (nUserOption)
                {
                case IDYES:
                {
                    // Actually, we need to do nothing in this case.
                }
                break;

                case IDNO:
                {
                    eCopyResult = IFileUtil::ETREECOPYUSERDIDNTCOPYSOMEITEMS;
                    continue;
                }
                break;

                // This IS ALWAYS for all... so it's easy to deal with.
                case IDCANCEL:
                {
                    return IFileUtil::ETREECOPYUSERCANCELED;
                }
                break;
                }
            }
        }
        bnLastFileWasCopied = MoveFileReplaceExisting(sourceName, targetName);

        if (!bnLastFileWasCopied)
        {
            eCopyResult = IFileUtil::ETREECOPYFAIL;
        }
    }

    // Now we can recurse into the directories, if needed.
    nTotal = cDirectories.size();
    for (nCurrent = 0; nCurrent < nTotal; ++nCurrent)
    {
        bool        bnLastDirectoryWasCreated(false);

        if (eCopyResult == IFileUtil::ETREECOPYUSERCANCELED)
        {
            return eCopyResult;
        }

        QString sourceName(sourceDir.absoluteFilePath(cDirectories[static_cast<int>(nCurrent)]));
        QString targetName(targetDir.absoluteFilePath(cDirectories[static_cast<int>(nCurrent)]));

        bnLastDirectoryWasCreated = QDir().mkdir(targetName);

        if (!bnLastDirectoryWasCreated)
        {
            if (!QDir(targetName).exists())
            {
                return IFileUtil::ETREECOPYFAIL;
            }
            else
            {
                // If the directory already exists...
                // we must warn our user about the possible actions.
                int             nUserOption(0);

                if (boConfirmOverwrite)
                {
                    // If the option is not valid to all folder, we must ask anyway again the user option.
                    if (!oDirectoryOptions.IsOptionToAll())
                    {
                        const int ret = QMessageBox::question(AzToolsFramework::GetActiveWindow(),
                            QObject::tr("Confirm directory overwrite?"),
                            QObject::tr("There is already a folder named \"%1\" in the target folder. Do you want to move this folder anyway?")
                                .arg(cDirectories[static_cast<int>(nCurrent)]),
                            QMessageBox::YesToAll | QMessageBox::Yes | QMessageBox::No | QMessageBox::Cancel);

                        switch (ret) {
                        case QMessageBox::YesToAll: /* fall-through */
                        case QMessageBox::Yes:    nUserOption = IDYES; break;
                        case QMessageBox::No:     nUserOption = IDNO; break;
                        case QMessageBox::Cancel: nUserOption = IDCANCEL; break;
                        }

                        oDirectoryOptions.SetOption(nUserOption, ret == QMessageBox::YesToAll);
                    }
                    else
                    {
                        nUserOption = oDirectoryOptions.GetOption();
                    }
                }

                switch (nUserOption)
                {
                case IDYES:
                {
                    // Actually, we need to do nothing in this case.
                }
                break;

                case IDNO:
                {
                    // If no, we just need to go to the next item.
                    eCopyResult = IFileUtil::ETREECOPYUSERDIDNTCOPYSOMEITEMS;
                    continue;
                }
                break;

                // This IS ALWAYS for all... so it's easy to deal with.
                case IDCANCEL:
                {
                    return IFileUtil::ETREECOPYUSERCANCELED;
                }
                break;
                }
            }
        }

        eCopyResult = MoveTree(sourceName, targetName, boRecurse, boConfirmOverwrite);
    }

    CFileUtil::RemoveDirectory(strSourceDirectory);

    return eCopyResult;
}

void CFileUtil::PopulateQMenu(QWidget* caller, QMenu* menu, AZStd::string_view fullGamePath)
{
    PopulateQMenu(caller, menu, fullGamePath, nullptr);
}

void CFileUtil::PopulateQMenu(QWidget* caller, QMenu* menu, AZStd::string_view fullGamePath, bool* isSelected)
{
    using namespace AzToolsFramework;
    
    // Normalize the full path so we get consistent separators
    AZStd::string fullFilePath(fullGamePath);
    AzFramework::StringFunc::Path::Normalize(fullFilePath);

    QString fullPath(fullFilePath.c_str());
    QFileInfo fileInfo(fullPath);

    if (isSelected)
    {
        *isSelected = false;
    }

    uint32 nFileAttr = CFileUtil::GetAttributes(fullPath.toUtf8().data());

    QAction* action;

    // NOTE: isSelected being passed in implies that the menu filled from this call must have exec() called on it, and not show.
    if (isSelected)
    {
        action = new QAction(QObject::tr("Select"), nullptr);
        QObject::connect(action, &QAction::triggered, action, [isSelected]() { *isSelected = true; });
        if (menu->isEmpty())
        {
            menu->addAction(action);
        }
        else
        {
            menu->insertAction(menu->actions()[0], action);
        }
    }

    action = menu->addAction(AzQtComponents::fileBrowserActionName(), [=]()
    {
        if (nFileAttr & SCC_FILE_ATTRIBUTE_INPAK)
        {
            QString path = QDir::toNativeSeparators(Path::GetPath(fullPath));
            QDesktopServices::openUrl(QUrl::fromLocalFile(path));
        }
        else
        {
            AzQtComponents::ShowFileOnDesktop(fullPath);
        }
    });
    action->setDisabled(nFileAttr & SCC_FILE_ATTRIBUTE_INPAK);

    action = menu->addAction(QObject::tr("Copy Name To Clipboard"), [=]()
    {
        QString fileName = fileInfo.completeBaseName();
        QApplication::clipboard()->setText(fileName);
    });

    action = menu->addAction(QObject::tr("Copy Path To Clipboard"), [fullPath]() { QApplication::clipboard()->setText(fullPath); });

    AzToolsFramework::SourceControlState sourceControlState = AzToolsFramework::SourceControlState::Disabled;
    AzToolsFramework::SourceControlConnectionRequestBus::BroadcastResult(sourceControlState, &AzToolsFramework::SourceControlConnectionRequests::GetSourceControlState);
    if (fileInfo.isFile() && sourceControlState == AzToolsFramework::SourceControlState::Active && nFileAttr != SCC_FILE_ATTRIBUTE_INVALID)
    {
        bool isEnableSC = nFileAttr & SCC_FILE_ATTRIBUTE_MANAGED;
        bool isInPak = nFileAttr & SCC_FILE_ATTRIBUTE_INPAK;
        menu->addSeparator();
        if (isInPak && !isEnableSC)
        {
            menu->addAction(QObject::tr("File In Pak (Read Only)"));
            menu->setDisabled(true);
        }
        else
        {
            action = menu->addAction(QObject::tr("Check Out"), [fullPath, caller]()
            {
                if (!CheckoutFile(fullPath.toUtf8().data(), caller))
                {
                    QMessageBox::warning(caller, QObject::tr("Error"),
                        QObject::tr("Source Control Check Out Failed.\r\nCheck if Source Control Provider is correctly setup and working directory is correct."));
                }
            });
            action->setEnabled(isEnableSC && !isInPak && (nFileAttr & SCC_FILE_ATTRIBUTE_READONLY));

            action = menu->addAction(QObject::tr("Undo Check Out"), [fullPath, caller]()
            {
                if (!RevertFile(fullPath.toUtf8().data(), caller))
                {
                    QMessageBox::warning(caller, QObject::tr("Error"),
                        QObject::tr("Source Control Undo Check Out Failed.\r\nCheck if Source Control Provider is correctly setup and working directory is correct."));
                }
            });
            action->setEnabled(isEnableSC && !isInPak && (nFileAttr & SCC_FILE_ATTRIBUTE_CHECKEDOUT));

            action = menu->addAction(QObject::tr("Get Latest Version"), [fullPath, caller]()
            {

                AzToolsFramework::SourceControlState sourceControlState = AzToolsFramework::SourceControlState::Disabled;
                AzToolsFramework::SourceControlConnectionRequestBus::BroadcastResult(sourceControlState, &AzToolsFramework::SourceControlConnectionRequests::GetSourceControlState);
                if (sourceControlState == AzToolsFramework::SourceControlState::Active)
                {
                    if (!CFileUtil::GetLatestFromSourceControl(fullPath.toUtf8().data(), caller))
                    {
                        QMessageBox::warning(caller, QObject::tr("Error"),
                            QObject::tr("Source Control failed to get latest version of file.\r\nCheck if Source Control Provider is setup correctly."
                            "\r\n\r\nAdditionally, this operation will fail on files that have local changes\r\nthat are not currently checked out, in order to prevent data loss."
                            "\r\nIn this case, please reconcile offline work directly from Source Control Provider."));
                    }
                }
            });
            action->setEnabled(isEnableSC);

            action = menu->addAction(QObject::tr("Add To Source Control"), [fullPath, caller]()
            {
                if (!CheckoutFile(fullPath.toUtf8().data(), caller))
                {
                    QMessageBox::warning(caller, QObject::tr("Error"),
                        QObject::tr("Source Control Add Failed.\r\nCheck if Source Control Provider is correctly setup and working directory is correct."));
                }
            });
            action->setDisabled(isEnableSC);
        }
    }
}

uint32 CFileUtil::GetAttributes(const char* filename, bool bUseSourceControl /*= true*/)
{
    using namespace AzToolsFramework;

    bool scOpSuccess = false;
    SourceControlFileInfo fileInfo;

    if (bUseSourceControl)
    {
        using SCRequest = SourceControlConnectionRequestBus;

        SourceControlState state = SourceControlState::Disabled;
        SCRequest::BroadcastResult(state, &SCRequest::Events::GetSourceControlState);

        if (state == SourceControlState::ConfigurationInvalid)
        {
            return SCC_FILE_ATTRIBUTE_INVALID;
        }

        if (state == SourceControlState::Active)
        {
            using SCCommand = SourceControlCommandBus;

            bool scOpComplete = false;
            SCCommand::Broadcast(&SCCommand::Events::GetFileInfo, filename,
                [&fileInfo, &scOpSuccess, &scOpComplete](bool success, const SourceControlFileInfo& info)
                {
                    fileInfo = info;
                    scOpSuccess = success;
                    scOpComplete = true;
                }
            );

            BlockAndWait(scOpComplete, nullptr, "Getting file status...");

            // we intended to use source control, but the operation failed.
            // do not fall through to checking as if bUseSourceControl was false
            if (!scOpSuccess)
            {
                return SCC_FILE_ATTRIBUTE_INVALID;
            }
        }
    }

    CCryFile file;
    bool isCryFile = file.Open(filename, "rb");

    // Using source control and our fstat succeeded.
    // Translate SourceControlStatus to (legacy) ESccFileAttributes
    if (scOpSuccess)
    {
        uint32 sccFileAttr = AZ::IO::SystemFile::Exists(filename) ? SCC_FILE_ATTRIBUTE_NORMAL : SCC_FILE_ATTRIBUTE_INVALID;

        if (fileInfo.HasFlag(SourceControlFlags::SCF_Tracked))
        {
            sccFileAttr |= SCC_FILE_ATTRIBUTE_MANAGED;
        }

        if (fileInfo.HasFlag(SourceControlFlags::SCF_OpenByUser))
        {
            sccFileAttr |= SCC_FILE_ATTRIBUTE_MANAGED | SCC_FILE_ATTRIBUTE_CHECKEDOUT;
        }

        if ((sccFileAttr & SCC_FILE_ATTRIBUTE_MANAGED) == SCC_FILE_ATTRIBUTE_MANAGED)
        {
            if (fileInfo.HasFlag(SourceControlFlags::SCF_OutOfDate))
            {
                sccFileAttr |= SCC_FILE_ATTRIBUTE_NOTATHEAD;
            }

            if (fileInfo.HasFlag(SourceControlFlags::SCF_OtherOpen))
            {
                sccFileAttr |= SCC_FILE_ATTRIBUTE_CHECKEDOUT | SCC_FILE_ATTRIBUTE_BYANOTHER;
            }

            if (fileInfo.HasFlag(SourceControlFlags::SCF_PendingAdd))
            {
                sccFileAttr |= SCC_FILE_ATTRIBUTE_ADD;
            }
        }

        if (fileInfo.IsReadOnly())
        {
            sccFileAttr |= SCC_FILE_ATTRIBUTE_READONLY;
        }

        if (file.IsInPak())
        {
            sccFileAttr |= SCC_FILE_ATTRIBUTE_READONLY | SCC_FILE_ATTRIBUTE_INPAK;
        }

        return sccFileAttr;
    }

    // We've asked not to use source control OR we disabled source control
    if (!isCryFile)
    {
        return SCC_FILE_ATTRIBUTE_INVALID;
    }

    if (file.IsInPak())
    {
        return SCC_FILE_ATTRIBUTE_READONLY | SCC_FILE_ATTRIBUTE_INPAK;
    }

    auto fileIoBase = AZ::IO::FileIOBase::GetInstance();
    if (!fileIoBase->Exists(file.GetFilename()))
    {
        return SCC_FILE_ATTRIBUTE_INVALID;
    }

    if (fileIoBase->IsReadOnly(file.GetFilename()))
    {
        return SCC_FILE_ATTRIBUTE_NORMAL | SCC_FILE_ATTRIBUTE_READONLY;
    }

    return SCC_FILE_ATTRIBUTE_NORMAL;
}

bool CFileUtil::CompareFiles(const QString& strFilePath1, const QString& strFilePath2)
{
    // Get the size of both files.  If either fails we say they are different (most likely one doesn't exist)
    uint64 size1 = 0;
    uint64 size2 = 0;
    if (!GetDiskFileSize(strFilePath1.toUtf8().data(), size1) || !GetDiskFileSize(strFilePath2.toUtf8().data(), size2))
    {
        return false;
    }

    // If the files are different sizes return false
    if (size1 != size2)
    {
        return false;
    }

    // Sizes are the same, we need to compare the bytes.  Try to open both files for read.
    CCryFile file1, file2;
    if (!file1.Open(strFilePath1.toUtf8().data(), "rb") || !file2.Open(strFilePath2.toUtf8().data(), "rb"))
    {
        return false;
    }

    const uint64 bufSize = 4096;

    char buf1[bufSize], buf2[bufSize];

    for (uint64 i = 0; i < size1; i += bufSize)
    {
        size_t amtRead1 = file1.ReadRaw(buf1, bufSize);
        size_t amtRead2 = file2.ReadRaw(buf2, bufSize);

        // Not a match if we didn't read the same amount from each file
        if (amtRead1 != amtRead2)
        {
            return false;
        }

        // Not a match if we didn't read the amount of data we expected
        if (amtRead1 != bufSize && i + amtRead1 != size1)
        {
            return false;
        }

        // Not a match if the buffers aren't the same
        if (memcmp(buf1, buf2, amtRead1) != 0)
        {
            return false;
        }
    }

    return true;
}

bool CFileUtil::SortAscendingFileNames(const IFileUtil::FileDesc& desc1, const IFileUtil::FileDesc& desc2)
{
    return desc1.filename.compare(desc2.filename) == -1 ? true : false;
}

bool CFileUtil::SortDescendingFileNames(const IFileUtil::FileDesc& desc1, const IFileUtil::FileDesc& desc2)
{
    return desc1.filename.compare(desc2.filename) == 1 ? true : false;
}

bool CFileUtil::SortAscendingDates(const IFileUtil::FileDesc& desc1, const IFileUtil::FileDesc& desc2)
{
    return desc1.time_write < desc2.time_write;
}

bool CFileUtil::SortDescendingDates(const IFileUtil::FileDesc& desc1, const IFileUtil::FileDesc& desc2)
{
    return desc1.time_write > desc2.time_write;
}

bool CFileUtil::SortAscendingSizes(const IFileUtil::FileDesc& desc1, const IFileUtil::FileDesc& desc2)
{
    return desc1.size > desc2.size;
}

bool CFileUtil::SortDescendingSizes(const IFileUtil::FileDesc& desc1, const IFileUtil::FileDesc& desc2)
{
    return desc1.size < desc2.size;
}


bool CFileUtil::IsAbsPath(const QString& filepath)
{
    return (!filepath.isEmpty() && ((filepath[1] == ':' && (filepath[2] == '\\' || filepath[2] == '/')
                          || (filepath[0] == '\\' || filepath[0] == '/'))));
}

CTempFileHelper::CTempFileHelper(const char* pFileName)
{
    char resolvedPath[AZ_MAX_PATH_LEN] = { 0 };
    AZ::IO::FileIOBase::GetDirectInstance()->ResolvePath(pFileName, resolvedPath, AZ_MAX_PATH_LEN);
    m_fileName = QString::fromUtf8(resolvedPath);

    // the official pattern for temp files in the editor is /$tmp[0-9]*_"
    // so we'll follow this pattern to make sure its ignored by asset processor.
    // the _h_ is added to be unique (helper) in case someone else is also making temp files.
    Path::ReplaceFilename(m_fileName, "$tmp_h_" + Path::GetFileName(QString::fromUtf8(pFileName)), m_tempFileName);
    CFileUtil::DeleteFile(m_tempFileName);
}

CTempFileHelper::~CTempFileHelper()
{
    CFileUtil::DeleteFile(m_tempFileName);
}

bool CTempFileHelper::UpdateFile(bool bBackup)
{
    // First, check if the files are actually different
    if (!CFileUtil::CompareFiles(m_tempFileName, m_fileName))
    {
        // If the file changed, make sure the destination file is writable
        if (!CFileUtil::OverwriteFile(m_fileName))
        {
            CFileUtil::DeleteFile(m_tempFileName);
            return false;
        }

        // Back up the current file if requested
        if (bBackup)
        {
            CFileUtil::BackupFile(m_fileName.toUtf8().data());
        }

        // Move the temp file over the top of the destination file
        return MoveFileReplaceExisting(m_tempFileName, m_fileName);
    }
    // If the files are the same, just delete the temp file and return.
    else
    {
        CFileUtil::DeleteFile(m_tempFileName);
        return true;
    }
}