System.Taffybar.Util

Configuration

taffyStateDir :: IO FilePath

GTK concurrency

postGUISync :: IO a -> IO a

Queue an action to be run in the GTK event loop. If called from the same process as the event loop, this runs the action directly. Otherwise, this queues it in GTK's event loop and blocks until the action is complete

You must call setGUIThread or setCurrentThreadAsGUIThread before this.

Equivalent to postGUISyncWithPriority PRIORITY_DEFAULT_IDLE

postGUIASync :: IO () -> IO ()

Queue an action to be run in the GTK event loop. This function queues the event regardless of what process it is called from, and returns immidietly.

Equivalent to postGUIASyncWithPriority PRIORITY_DEFAULT_IDLE

GLib

catchGErrorsAsLeft :: IO a -> IO (Either GError a)

Logging

logPrintF :: (MonadIO m, Show t) => String -> Priority -> String -> t -> m ()

Text

truncateString :: Int -> String -> String

truncateText :: Int -> Text -> Text

Resources

downloadURIToPath :: Request -> FilePath -> IO ()

getPixbufFromFilePath :: FilePath -> IO (Maybe Pixbuf)

safePixbufNewFromFile :: FilePath -> IO (Maybe Pixbuf)

Logic Combinators

(<||>) :: Monad m => (t -> m (Maybe a)) -> (t -> m (Maybe a)) -> t -> m (Maybe a) infixl 3

(<|||>) :: Monad m => (t -> t1 -> m (Maybe a)) -> (t -> t1 -> m (Maybe a)) -> t -> t1 -> m (Maybe a) infixl 3

forkM :: Monad m => (c -> m a) -> (c -> m b) -> c -> m (a, b)

ifM :: Monad m => m Bool -> m a -> m a -> m a

anyM :: Monad m => (a -> m Bool) -> [a] -> m Bool

maybeTCombine :: Monad m => m (Maybe a) -> m (Maybe a) -> m (Maybe a)

maybeToEither :: b -> Maybe a -> Either b a

Control

foreverWithVariableDelay :: (MonadIO m, RealFrac d) => IO d -> m ThreadId

Execute the provided IO action, and use the value it returns to decide how long to wait until executing it again. The value returned by the action is interpreted as a number of seconds.

foreverWithDelay :: (MonadIO m, RealFrac d) => d -> IO () -> m ThreadId

Execute the provided IO action at the provided interval.

Process control

runCommand :: MonadIO m => FilePath -> [String] -> m (Either String String)

Run the provided command with the provided arguments.

If the command filename does not contain a slash, then the PATH environment variable is searched for the executable.

onSigINT

Arguments

:: IO a

The main loop IO action

-> IO ()

Callback for SIGINT

-> IO a

Installs a useful posix signal handler for sigINT (i.e. Ctrl-C) for cases when the UserInterrupt exception gets swallowed within a main loop, preventing the program from exiting.

The given callback should be a command which causes the main loop action to exit. For example:

Gtk.main `onSigINT` Gtk.mainQuit

If the signal handler was invoked, the program will exit with status 130 after the main loop action returns.

Deprecated

logPrintFDebug :: (MonadIO m, Show t) => String -> String -> t -> m ()

Deprecated: Use logPrintF instead

liftReader :: Monad m => (m1 a -> m b) -> ReaderT r m1 a -> ReaderT r m b

Deprecated: Use Control.Monad.Trans.Reader.mapReaderT instead

liftActionTaker :: Monad m => ((a -> m a) -> m b) -> (a -> ReaderT c m a) -> ReaderT c m b

(??) :: Functor f => f (a -> b) -> a -> f b infixl 4

Deprecated: Use f * pure a instead

runCommandFromPath :: MonadIO m => FilePath -> [String] -> m (Either String String)

Deprecated: Use runCommand instead