ExternalFilePath.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later

 
#pragma once
 
#include <optional>
 
#include <QDir>
#include <QFileInfo>
#include <QString>
 
#include "App/IO/SerializationContext.h"
 
namespace ExternalFilePath {

inline QString resolve(const QString &storedPath, const QString &contextDir)
{
    if (storedPath.isEmpty() || contextDir.isEmpty()) {
        return storedPath;
    }
 
    const QDir dir(contextDir);
    const QString asGiven = dir.filePath(storedPath);
    if (QFileInfo(asGiven).isFile()) {
        return asGiven;
    }
 
    return dir.filePath(QFileInfo(QString(storedPath).replace('\\', '/')).fileName());
}

inline QString forWriting(const QString &path, SerializationPurpose purpose)
{
    if (path.startsWith(":/") || purpose == SerializationPurpose::InMemorySnapshot) {
        return path;
    }
    return QFileInfo(path).fileName();
}

inline std::optional<QString> forReading(const QString &storedValue, const QString &contextDir, SerializationPurpose purpose)
{
    if (purpose == SerializationPurpose::InMemorySnapshot) {
        return storedValue;
    }
 
    if (storedValue.startsWith(":/")) {
        return std::nullopt;
    }
 
    return resolve(storedValue, contextDir);
}
 
} // namespace ExternalFilePath