System.Taffybar.Information.XDG.DesktopEntry

Implementation of version 1.1 of the freedesktop "Desktop Entry specification", see https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-1.1.html.

Documentation

data DesktopEntry

Desktop Entry. All attributes (key-value-pairs) are stored in an association list.

Constructors

DesktopEntry

Fields

• deType :: DesktopEntryType
• deFilename :: FilePath

  unqualified filename, e.g. "taffybar.desktop"

• deAttributes :: [(String, String)]

  Key-value pairs

Instances

Eq DesktopEntry

Methods

(==) :: DesktopEntry -> DesktopEntry -> Bool

(/=) :: DesktopEntry -> DesktopEntry -> Bool

Read DesktopEntry

Methods

readsPrec :: Int -> ReadS DesktopEntry

readList :: ReadS [DesktopEntry]

readPrec :: ReadPrec DesktopEntry

readListPrec :: ReadPrec [DesktopEntry]

Show DesktopEntry

Methods

showsPrec :: Int -> DesktopEntry -> ShowS

show :: DesktopEntry -> String

showList :: [DesktopEntry] -> ShowS

deCommand :: DesktopEntry -> Maybe String

Return the command defined by the given desktop entry. TODO: should check the dbus thing. TODO: are there "field codes", i.e. %char things, that

deComment

Arguments

:: [String]

Preferred languages

-> DesktopEntry

-> Maybe String

Return the proper comment of the desktop entry, depending on the list of preferred languages.

deHasCategory

Arguments

:: DesktopEntry

desktop entry

-> String

category to be checked

-> Bool

Determine whether the Category attribute of a desktop entry contains a given value.

deIcon :: DesktopEntry -> Maybe String

Return the Icon attribute

deName

Arguments

:: [String]

Preferred languages

-> DesktopEntry

-> String

Return the proper name of the desktop entry, depending on the list of preferred languages.

deNoDisplay :: DesktopEntry -> Bool

Return True if the entry must not be displayed

deNotShowIn :: DesktopEntry -> [String]

Return the categories in which the entry shall not be shown

deOnlyShowIn :: DesktopEntry -> [String]

Return the categories in which the entry shall be shown

existingDirs :: [FilePath] -> IO [FilePath]

getDefaultDataHome :: IO FilePath

getDirectoryEntry :: [FilePath] -> String -> IO (Maybe DesktopEntry)

Retrieve a desktop entry with a specific name.

getDirectoryEntryDefault :: String -> IO (Maybe DesktopEntry)

getXDGDataDirs :: IO [FilePath]

listDesktopEntries

Arguments

:: String

The extension to use in the search

-> FilePath

The filepath at which to search

-> IO [DesktopEntry]

Return a list of all desktop entries in the given directory.