xmonad-contrib-0.10: Third party extensions for xmonad

MaintainerSpencer Janssen <spencerjanssen@gmail.com>




A module for writing graphical prompts for XMonad



For usage examples see XMonad.Prompt.Shell, XMonad.Prompt.XMonad or XMonad.Prompt.Ssh


  • scrolling the completions that don't fit in the window (?)

mkXPrompt :: XPrompt p => p -> XPConfig -> ComplFunction -> (String -> X ()) -> X ()Source

Creates a prompt given:

  • a prompt type, instance of the XPrompt class.
  • a prompt configuration (defaultXPConfig can be used as a starting point)
  • a completion function (mkComplFunFromList can be used to create a completions function given a list of possible completions)
  • an action to be run: the action must take a string and return X ()

mkXPromptWithReturn :: XPrompt p => p -> XPConfig -> ComplFunction -> (String -> X a) -> X (Maybe a)Source

Same as mkXPrompt, except that the action function can have type String -> X a, for any a, and the final action returned by mkXPromptWithReturn will have type X (Maybe a). Nothing is yielded if the user cancels the prompt (by e.g. hitting Esc or Ctrl-G). For an example of use, see the XMonad.Prompt.Input module.

data XPType Source


forall p . XPrompt p => XPT p 

data XPPosition Source



data XPConfig Source




font :: String


bgColor :: String

Background color

fgColor :: String

Font color

fgHLight :: String

Font color of a highlighted completion entry

bgHLight :: String

Background color of a highlighted completion entry

borderColor :: String

Border color

promptBorderWidth :: !Dimension

Border width

position :: XPPosition

Position: Top or Bottom

height :: !Dimension

Window height

historySize :: !Int

The number of history entries to be saved

historyFilter :: [String] -> [String]

a filter to determine which history entries to remember

promptKeymap :: Map (KeyMask, KeySym) (XP ())

Mapping from key combinations to actions

completionKey :: KeySym

Key that should trigger completion

defaultText :: String

The text by default in the prompt line

autoComplete :: Maybe Int

Just x: if only one completion remains, auto-select it,

showCompletionOnTab :: Bool

Only show list of completions when Tab was pressed and delay by x microseconds

searchPredicate :: String -> String -> Bool

Given the typed string and a possible completion, is the completion valid?

class XPrompt t whereSource

The class prompt types must be an instance of. In order to create a prompt you need to create a data type, without parameters, and make it an instance of this class, by implementing a simple method, showXPrompt, which will be used to print the string to be displayed in the command line window.

This is an example of a XPrompt instance definition:

     instance XPrompt Shell where
          showXPrompt Shell = "Run: "


showXPrompt :: t -> StringSource

This method is used to print the string to be displayed in the command line window.

nextCompletion :: t -> String -> [String] -> StringSource

This method is used to generate the next completion to be printed in the command line when tab is pressed, given the string presently in the command line and the list of completion.

commandToComplete :: t -> String -> StringSource

This method is used to generate the string to be passed to the completion function.

completionToCommand :: t -> String -> StringSource

This method is used to process each completion in order to generate the string that will be compared with the command presently displayed in the command line. If the prompt is using getNextOfLastWord for implementing nextCompletion (the default implementation), this method is also used to generate, from the returned completion, the string that will form the next command line when tab is pressed.

quit :: XP ()Source


killBefore :: XP ()Source

Kill the portion of the command before the cursor

killAfter :: XP ()Source

Kill the portion of the command including and after the cursor

startOfLine :: XP ()Source

Put the cursor at the start of line

endOfLine :: XP ()Source

Put the cursor at the end of line

pasteString :: XP ()Source

Insert the current X selection string at the cursor position.

moveCursor :: Direction1D -> XP ()Source

move the cursor one position

setInput :: String -> XP ()Source

Sets the input string to the given value.

getInput :: XP StringSource

Returns the current input string. Intented for use in custom keymaps where the get or similar can't be used to retrieve it.

moveWord :: Direction1D -> XP ()Source

move the cursor one word

killWord :: Direction1D -> XP ()Source

Kill the next/previous word

deleteString :: Direction1D -> XP ()Source

Remove a character at the cursor position

data Direction1D Source

One-dimensional directions:



X Utilities


mkUnmanagedWindow :: Display -> Screen -> Window -> Position -> Position -> Dimension -> Dimension -> IO WindowSource

Creates a window with the attribute override_redirect set to True. Windows Managers should not touch this kind of windows.

fillDrawable :: Display -> Drawable -> GC -> Pixel -> Pixel -> Dimension -> Dimension -> Dimension -> IO ()Source

Fills a Drawable with a rectangle and a border

Other Utilities


mkComplFunFromList :: [String] -> String -> IO [String]Source

This function takes a list of possible completions and returns a completions function to be used with mkXPrompt

mkComplFunFromList' :: [String] -> String -> IO [String]Source

This function takes a list of possible completions and returns a completions function to be used with mkXPrompt. If the string is null it will return all completions.

nextCompletion implementations

getNextOfLastWord :: XPrompt t => t -> String -> [String] -> StringSource

Given the prompt type, the command line and the completion list, return the next completion in the list for the last word of the command line. This is the default nextCompletion implementation.

getNextCompletion :: String -> [String] -> StringSource

An alternative nextCompletion implementation: given a command and a completion list, get the next completion in the list matching the whole command line.

List utilities

getLastWord :: String -> StringSource

Gets the last word of a string or the whole string if formed by only one word

skipLastWord :: String -> StringSource

Skips the last word of the string, if the string is composed by more then one word. Otherwise returns the string.

splitInSubListsAt :: Int -> [a] -> [[a]]Source

Given a maximum length, splits a list into sublists

uniqSort :: Ord a => [a] -> [a]Source

Sort a list and remove duplicates. Like deleteAllDuplicates, but trades off laziness and stability for efficiency.

historyCompletion :: ComplFunctionSource

historyCompletion provides a canned completion function much like getShellCompl; you pass it to mkXPrompt, and it will make completions work from the query history stored in ~/.xmonad/history.

historyCompletionP :: (String -> Bool) -> ComplFunctionSource

Like historyCompletion but only uses history data from Prompts whose name satisfies the given predicate.

History filters

deleteAllDuplicates, deleteConsecutive :: [String] -> [String]Source

Functions to be used with the historyFilter setting. deleteAllDuplicates will remove all duplicate entries. deleteConsecutive will only remove duplicate elements immediately next to each other.

initMatches :: (Functor m, MonadIO m) => m HistoryMatchesSource

Initializes a new HistoryMatches structure to be passed to historyUpMatching

historyUpMatching, historyDownMatching :: HistoryMatches -> XP ()Source

Retrieve the next history element that starts with the current input. Pass it the result of initMatches when creating the prompt. Example:

 ((modMask,xK_p), shellPrompt . myPrompt =<< initMatches)
 myPrompt ref = defaultPrompt
   { promptKeymap = M.union [((0,xK_Up), historyUpMatching ref)
                            ,((0,xK_Down), historyDownMatching ref)]
                            (promptKeymap defaultPrompt)
   , .. }