desktopentry.h

Go to the documentation of this file.

#pragma once
 
#include <expected>
 
#include <QtCore/QMap>
#include <QtCore/QString>
#include <QtCore/QStringList>

class DesktopEntry {
public:
    DesktopEntry() = default; // LCOV_EXCL_LINE
    explicit DesktopEntry(const QString &filename);
    bool parse(const QString &filename);
    [[nodiscard]] bool isValid() const {
        return valid_;
    }

    [[nodiscard]] QString filename() const {
        return filename_;
    }

    [[nodiscard]] QString name() const;
    [[nodiscard]] QString exec() const {
        return exec_;
    }

    [[nodiscard]] QString executableName() const;
    [[nodiscard]] QString icon() const {
        return icon_;
    }

    [[nodiscard]] QString comment() const;
    // LCOV_EXCL_START
    [[nodiscard]] QString startupWMClass() const {
        return startupWMClass_;
    }

    [[nodiscard]] QStringList categories() const {
        return categories_;
    }

    [[nodiscard]] QStringList mimeTypes() const {
        return mimeTypes_;
    }
    // LCOV_EXCL_STOP
    [[nodiscard]] bool noDisplay() const {
        return noDisplay_;
    }
#ifdef Q_OS_MAC
    bool parseAppBundle(const QString &bundlePath);
#elif defined(Q_OS_WIN)
    bool parseFromExecutable(const QString &exePath);
#endif
 
private:
    QString getValue(const QString &key) const;
    QString getLocalizedValue(const QString &key) const;
    QStringList getListValue(const QString &key) const;
 
    QString filename_;
    QString exec_;
    QString icon_;
    QString startupWMClass_;
    QStringList categories_;
    QStringList mimeTypes_;
    bool noDisplay_ = false;
    bool valid_ = false;
    QMap<QString, QString> entries_;
};

enum class DesktopEntryError { ParseFailed };

[[nodiscard]] std::expected<DesktopEntry, DesktopEntryError>
readDesktopEntry(const QString &filename);