<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<!-- Generated by HsColour, http://code.haskell.org/~malcolm/hscolour/ -->
<title>XMonad/Actions/WindowGo.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>{- |
<a name="line-2"></a>Module : XMonad.Actions.WindowGo
<a name="line-3"></a>License : Public domain
<a name="line-4"></a>
<a name="line-5"></a>Maintainer : <gwern0@gmail.com>
<a name="line-6"></a>Stability : unstable
<a name="line-7"></a>Portability : unportable
<a name="line-8"></a>
<a name="line-9"></a>Defines a few convenient operations for raising (traveling to) windows based on XMonad's Query
<a name="line-10"></a>monad, such as 'runOrRaise'. runOrRaise will run a shell command unless it can
<a name="line-11"></a>find a specified window; you would use this to automatically travel to your
<a name="line-12"></a>Firefox or Emacs session, or start a new one (for example), instead of trying to
<a name="line-13"></a>remember where you left it or whether you still have one running. -}</span>
<a name="line-14"></a>
<a name="line-15"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Actions</span><span class='hs-varop'>.</span><span class='hs-conid'>WindowGo</span> <span class='hs-layout'>(</span>
<a name="line-16"></a> <span class='hs-comment'>-- * Usage</span>
<a name="line-17"></a> <span class='hs-comment'>-- $usage</span>
<a name="line-18"></a> <span class='hs-varid'>raise</span><span class='hs-layout'>,</span>
<a name="line-19"></a> <span class='hs-varid'>raiseNext</span><span class='hs-layout'>,</span>
<a name="line-20"></a> <span class='hs-varid'>runOrRaise</span><span class='hs-layout'>,</span>
<a name="line-21"></a> <span class='hs-varid'>runOrRaiseNext</span><span class='hs-layout'>,</span>
<a name="line-22"></a> <span class='hs-varid'>raiseMaybe</span><span class='hs-layout'>,</span>
<a name="line-23"></a> <span class='hs-varid'>raiseNextMaybe</span><span class='hs-layout'>,</span>
<a name="line-24"></a>
<a name="line-25"></a> <span class='hs-varid'>raiseBrowser</span><span class='hs-layout'>,</span>
<a name="line-26"></a> <span class='hs-varid'>raiseEditor</span><span class='hs-layout'>,</span>
<a name="line-27"></a> <span class='hs-varid'>runOrRaiseAndDo</span><span class='hs-layout'>,</span>
<a name="line-28"></a> <span class='hs-varid'>runOrRaiseMaster</span><span class='hs-layout'>,</span>
<a name="line-29"></a> <span class='hs-varid'>raiseAndDo</span><span class='hs-layout'>,</span>
<a name="line-30"></a> <span class='hs-varid'>raiseMaster</span><span class='hs-layout'>,</span>
<a name="line-31"></a>
<a name="line-32"></a> <span class='hs-varid'>ifWindows</span><span class='hs-layout'>,</span>
<a name="line-33"></a> <span class='hs-varid'>ifWindow</span><span class='hs-layout'>,</span>
<a name="line-34"></a> <span class='hs-varid'>raiseHook</span><span class='hs-layout'>,</span>
<a name="line-35"></a> <span class='hs-keyword'>module</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>ManageHook</span>
<a name="line-36"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-37"></a>
<a name="line-38"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span>
<a name="line-39"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Char</span> <span class='hs-layout'>(</span><span class='hs-varid'>toLower</span><span class='hs-layout'>)</span>
<a name="line-40"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Monoid</span>
<a name="line-41"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span> <span class='hs-layout'>(</span><span class='hs-conid'>Query</span><span class='hs-conid'>()</span><span class='hs-layout'>,</span> <span class='hs-conid'>X</span><span class='hs-conid'>()</span><span class='hs-layout'>,</span> <span class='hs-conid'>ManageHook</span><span class='hs-layout'>,</span> <span class='hs-varid'>withWindowSet</span><span class='hs-layout'>,</span> <span class='hs-varid'>runQuery</span><span class='hs-layout'>,</span> <span class='hs-varid'>liftIO</span><span class='hs-layout'>,</span> <span class='hs-varid'>ask</span><span class='hs-layout'>)</span>
<a name="line-42"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>X11</span> <span class='hs-layout'>(</span><span class='hs-conid'>Window</span><span class='hs-layout'>)</span>
<a name="line-43"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>ManageHook</span>
<a name="line-44"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Operations</span> <span class='hs-layout'>(</span><span class='hs-varid'>windows</span><span class='hs-layout'>)</span>
<a name="line-45"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Prompt</span><span class='hs-varop'>.</span><span class='hs-conid'>Shell</span> <span class='hs-layout'>(</span><span class='hs-varid'>getBrowser</span><span class='hs-layout'>,</span> <span class='hs-varid'>getEditor</span><span class='hs-layout'>)</span>
<a name="line-46"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>StackSet</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>W</span> <span class='hs-layout'>(</span><span class='hs-varid'>allWindows</span><span class='hs-layout'>,</span> <span class='hs-varid'>peek</span><span class='hs-layout'>,</span> <span class='hs-varid'>swapMaster</span><span class='hs-layout'>,</span> <span class='hs-varid'>focusWindow</span><span class='hs-layout'>)</span>
<a name="line-47"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Util</span><span class='hs-varop'>.</span><span class='hs-conid'>Run</span> <span class='hs-layout'>(</span><span class='hs-varid'>safeSpawnProg</span><span class='hs-layout'>)</span>
<a name="line-48"></a><span class='hs-comment'>{- $usage
<a name="line-49"></a>
<a name="line-50"></a>Import the module into your @~\/.xmonad\/xmonad.hs@:
<a name="line-51"></a>
<a name="line-52"></a>> import XMonad.Actions.WindowGo
<a name="line-53"></a>
<a name="line-54"></a>and define appropriate key bindings:
<a name="line-55"></a>
<a name="line-56"></a>> , ((modm .|. shiftMask, xK_g), raise (className =? "Firefox"))
<a name="line-57"></a>> , ((modm .|. shiftMask, xK_b), runOrRaise "firefox" (className =? "Firefox"))
<a name="line-58"></a>
<a name="line-59"></a>(Note that Firefox v3 and up have a class-name of \"Firefox\" and \"Navigator\";
<a name="line-60"></a>lower versions use other classnames such as \"Firefox-bin\". Either choose the
<a name="line-61"></a>appropriate one, or cover your bases by using instead something like:
<a name="line-62"></a>
<a name="line-63"></a>> (className =? "Firefox" <||> className =? "Firefox-bin")
<a name="line-64"></a>
<a name="line-65"></a>For detailed instructions on editing your key bindings, see
<a name="line-66"></a>"XMonad.Doc.Extending#Editing_key_bindings". -}</span>
<a name="line-67"></a>
<a name="line-68"></a><a name="ifWindows"></a><span class='hs-comment'>-- | If windows that satisfy the query exist, apply the supplied</span>
<a name="line-69"></a><span class='hs-comment'>-- function to them, otherwise run the action given as</span>
<a name="line-70"></a><span class='hs-comment'>-- second parameter.</span>
<a name="line-71"></a><span class='hs-definition'>ifWindows</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-conid'>Window</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-72"></a><span class='hs-definition'>ifWindows</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>f</span> <span class='hs-varid'>el</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>withWindowSet</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>wins</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-73"></a> <span class='hs-varid'>matches</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>filterM</span> <span class='hs-layout'>(</span><span class='hs-varid'>runQuery</span> <span class='hs-varid'>qry</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>allWindows</span> <span class='hs-varid'>wins</span>
<a name="line-74"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>matches</span> <span class='hs-keyword'>of</span>
<a name="line-75"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>el</span>
<a name="line-76"></a> <span class='hs-varid'>ws</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span> <span class='hs-varid'>ws</span>
<a name="line-77"></a>
<a name="line-78"></a><a name="ifWindow"></a><span class='hs-comment'>-- | The same as ifWindows, but applies a ManageHook to the first match</span>
<a name="line-79"></a><span class='hs-comment'>-- instead and discards the other matches</span>
<a name="line-80"></a><span class='hs-definition'>ifWindow</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ManageHook</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-81"></a><span class='hs-definition'>ifWindow</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>mh</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ifWindows</span> <span class='hs-varid'>qry</span> <span class='hs-layout'>(</span><span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-varid'>appEndo</span> <span class='hs-varop'><=<</span> <span class='hs-varid'>runQuery</span> <span class='hs-varid'>mh</span> <span class='hs-varop'>.</span> <span class='hs-varid'>head</span><span class='hs-layout'>)</span>
<a name="line-82"></a>
<a name="line-83"></a><a name="runOrRaise"></a><span class='hs-comment'>-- | 'action' is an executable to be run via 'safeSpawnProg' (of "XMonad.Util.Run") if the Window cannot be found.</span>
<a name="line-84"></a><span class='hs-comment'>-- Presumably this executable is the same one that you were looking for.</span>
<a name="line-85"></a><span class='hs-definition'>runOrRaise</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-86"></a><span class='hs-definition'>runOrRaise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseMaybe</span> <span class='hs-varop'>.</span> <span class='hs-varid'>safeSpawnProg</span>
<a name="line-87"></a>
<a name="line-88"></a><a name="raise"></a><span class='hs-comment'>-- | See 'raiseMaybe'. If the Window can't be found, quietly give up and do nothing.</span>
<a name="line-89"></a><span class='hs-definition'>raise</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-90"></a><span class='hs-definition'>raise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseMaybe</span> <span class='hs-varop'>$</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-91"></a>
<a name="line-92"></a><a name="raiseMaybe"></a><span class='hs-comment'>{- | 'raiseMaybe' queries all Windows based on a boolean provided by the
<a name="line-93"></a> user. Currently, there are 3 such useful booleans defined in
<a name="line-94"></a> "XMonad.ManageHook": 'title', 'resource', 'className'. Each one tests based pretty
<a name="line-95"></a> much as you would think. ManageHook also defines several operators, the most
<a name="line-96"></a> useful of which is (=?). So a useful test might be finding a @Window@ whose
<a name="line-97"></a> class is Firefox. Firefox 3 declares the class \"Firefox\", so you'd want to
<a name="line-98"></a> pass in a boolean like @(className =? \"Firefox\")@.
<a name="line-99"></a>
<a name="line-100"></a> If the boolean returns @True@ on one or more windows, then XMonad will quickly
<a name="line-101"></a> make visible the first result. If no @Window@ meets the criteria, then the
<a name="line-102"></a> first argument comes into play.
<a name="line-103"></a>
<a name="line-104"></a> The first argument is an arbitrary IO function which will be executed if the
<a name="line-105"></a> tests fail. This is what enables 'runOrRaise' to use 'raiseMaybe': it simply runs
<a name="line-106"></a> the desired program if it isn't found. But you don't have to do that. Maybe
<a name="line-107"></a> you want to do nothing if the search fails (the definition of 'raise'), or
<a name="line-108"></a> maybe you want to write to a log file, or call some prompt function, or
<a name="line-109"></a> something crazy like that. This hook gives you that flexibility. You can do
<a name="line-110"></a> some cute things with this hook. Suppose you want to do the same thing for
<a name="line-111"></a> Mutt which you just did for Firefox - but Mutt runs inside a terminal window?
<a name="line-112"></a> No problem: you search for a terminal window calling itself \"mutt\", and if
<a name="line-113"></a> there isn't you run a terminal with a command to run Mutt! Here's an example
<a name="line-114"></a> (borrowing 'runInTerm' from "XMonad.Utils.Run"):
<a name="line-115"></a>
<a name="line-116"></a> > , ((modm, xK_m), raiseMaybe (runInTerm "-title mutt" "mutt") (title =? "mutt"))
<a name="line-117"></a>-}</span>
<a name="line-118"></a><span class='hs-definition'>raiseMaybe</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-119"></a><span class='hs-definition'>raiseMaybe</span> <span class='hs-varid'>f</span> <span class='hs-varid'>qry</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ifWindow</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>raiseHook</span> <span class='hs-varid'>f</span>
<a name="line-120"></a>
<a name="line-121"></a><a name="raiseHook"></a><span class='hs-comment'>-- | A manage hook that raises the window.</span>
<a name="line-122"></a><span class='hs-definition'>raiseHook</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ManageHook</span>
<a name="line-123"></a><span class='hs-definition'>raiseHook</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ask</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>doF</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>focusWindow</span>
<a name="line-124"></a>
<a name="line-125"></a><a name="runOrRaiseNext"></a><span class='hs-comment'>-- | See 'runOrRaise' and 'raiseNextMaybe'. Version that allows cycling through matches.</span>
<a name="line-126"></a><span class='hs-definition'>runOrRaiseNext</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-127"></a><span class='hs-definition'>runOrRaiseNext</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseNextMaybe</span> <span class='hs-varop'>.</span> <span class='hs-varid'>safeSpawnProg</span>
<a name="line-128"></a>
<a name="line-129"></a><a name="raiseNext"></a><span class='hs-comment'>-- | See 'raise' and 'raiseNextMaybe'. Version that allows cycling through matches.</span>
<a name="line-130"></a><span class='hs-definition'>raiseNext</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-131"></a><span class='hs-definition'>raiseNext</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseNextMaybe</span> <span class='hs-varop'>$</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-132"></a>
<a name="line-133"></a><span class='hs-comment'>{- | See 'raiseMaybe'.
<a name="line-134"></a> 'raiseNextMaybe' is an alternative version that allows cycling
<a name="line-135"></a> through the matching windows. If the focused window matches the
<a name="line-136"></a> query the next matching window is raised. If no matches are found
<a name="line-137"></a> the function f is executed.
<a name="line-138"></a>-}</span>
<a name="line-139"></a>
<a name="line-140"></a><a name="raiseNextMaybe"></a><span class='hs-definition'>raiseNextMaybe</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-141"></a><span class='hs-definition'>raiseNextMaybe</span> <span class='hs-varid'>f</span> <span class='hs-varid'>qry</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>flip</span> <span class='hs-layout'>(</span><span class='hs-varid'>ifWindows</span> <span class='hs-varid'>qry</span><span class='hs-layout'>)</span> <span class='hs-varid'>f</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>ws</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-142"></a> <span class='hs-varid'>foc</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>withWindowSet</span> <span class='hs-varop'>$</span> <span class='hs-varid'>return</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>peek</span>
<a name="line-143"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>foc</span> <span class='hs-keyword'>of</span>
<a name="line-144"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>w</span> <span class='hs-varop'>`elem`</span> <span class='hs-varid'>ws</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-keyword'>_</span><span class='hs-conop'>:</span><span class='hs-varid'>y</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>dropWhile</span> <span class='hs-layout'>(</span><span class='hs-varop'>/=</span><span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>cycle</span> <span class='hs-varid'>ws</span> <span class='hs-comment'>-- cannot fail to match</span>
<a name="line-145"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>$</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>focusWindow</span> <span class='hs-varid'>y</span>
<a name="line-146"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>focusWindow</span> <span class='hs-varop'>.</span> <span class='hs-varid'>head</span> <span class='hs-varop'>$</span> <span class='hs-varid'>ws</span>
<a name="line-147"></a>
<a name="line-148"></a><a name="raiseVar"></a><span class='hs-comment'>-- | Given a function which gets us a String, we try to raise a window with that classname,</span>
<a name="line-149"></a><span class='hs-comment'>-- or we then interpret that String as a executable name.</span>
<a name="line-150"></a><span class='hs-definition'>raiseVar</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-151"></a><span class='hs-definition'>raiseVar</span> <span class='hs-varid'>getvar</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftIO</span> <span class='hs-varid'>getvar</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>var</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runOrRaise</span> <span class='hs-varid'>var</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-layout'>(</span><span class='hs-varid'>map</span> <span class='hs-varid'>toLower</span><span class='hs-layout'>)</span> <span class='hs-varid'>className</span> <span class='hs-varop'>=?</span> <span class='hs-varid'>var</span><span class='hs-layout'>)</span>
<a name="line-152"></a>
<a name="line-153"></a><a name="raiseBrowser"></a><span class='hs-comment'>{- | 'raiseBrowser' and 'raiseEditor' grab $BROWSER and $EDITOR respectively and they either
<a name="line-154"></a> take you to the specified program's window, or they try to run it. This is most useful
<a name="line-155"></a> if your variables are simple and look like \"firefox\" or \"emacs\". -}</span>
<a name="line-156"></a><span class='hs-definition'>raiseBrowser</span><span class='hs-layout'>,</span> <span class='hs-varid'>raiseEditor</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-157"></a><span class='hs-definition'>raiseBrowser</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseVar</span> <span class='hs-varid'>getBrowser</span>
<a name="line-158"></a><a name="raiseEditor"></a><span class='hs-definition'>raiseEditor</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseVar</span> <span class='hs-varid'>getEditor</span>
<a name="line-159"></a>
<a name="line-160"></a><a name="raiseAndDo"></a><span class='hs-comment'>{- | If the window is found the window is focused and the third argument is called
<a name="line-161"></a> otherwise, the first argument is called
<a name="line-162"></a> See 'raiseMaster' for an example. -}</span>
<a name="line-163"></a><span class='hs-definition'>raiseAndDo</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Window</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-164"></a><span class='hs-definition'>raiseAndDo</span> <span class='hs-varid'>f</span> <span class='hs-varid'>qry</span> <span class='hs-varid'>after</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ifWindow</span> <span class='hs-varid'>qry</span> <span class='hs-layout'>(</span><span class='hs-varid'>afterRaise</span> <span class='hs-varop'>`mappend`</span> <span class='hs-varid'>raiseHook</span><span class='hs-layout'>)</span> <span class='hs-varid'>f</span>
<a name="line-165"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>afterRaise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ask</span> <span class='hs-varop'>>>=</span> <span class='hs-layout'>(</span><span class='hs-varop'>>></span> <span class='hs-varid'>idHook</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>liftX</span> <span class='hs-varop'>.</span> <span class='hs-varid'>after</span>
<a name="line-166"></a>
<a name="line-167"></a><a name="runOrRaiseAndDo"></a><span class='hs-comment'>{- | If a window matching the second arugment is found, the window is focused and the third argument is called;
<a name="line-168"></a> otherwise, the first argument is called. -}</span>
<a name="line-169"></a><span class='hs-definition'>runOrRaiseAndDo</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Window</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-170"></a><span class='hs-definition'>runOrRaiseAndDo</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseAndDo</span> <span class='hs-varop'>.</span> <span class='hs-varid'>safeSpawnProg</span>
<a name="line-171"></a>
<a name="line-172"></a><a name="raiseMaster"></a><span class='hs-comment'>{- | if the window is found the window is focused and set to master
<a name="line-173"></a> otherwise, the first argument is called.
<a name="line-174"></a>
<a name="line-175"></a> > raiseMaster (runInTerm "-title ghci" "zsh -c 'ghci'") (title =? "ghci") -}</span>
<a name="line-176"></a><span class='hs-definition'>raiseMaster</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-177"></a><span class='hs-definition'>raiseMaster</span> <span class='hs-varid'>raisef</span> <span class='hs-varid'>thatUserQuery</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>raiseAndDo</span> <span class='hs-varid'>raisef</span> <span class='hs-varid'>thatUserQuery</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>windows</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>swapMaster</span><span class='hs-layout'>)</span>
<a name="line-178"></a>
<a name="line-179"></a><a name="runOrRaiseMaster"></a><span class='hs-comment'>{- | If the window is found the window is focused and set to master
<a name="line-180"></a> otherwise, action is run.
<a name="line-181"></a>
<a name="line-182"></a> > runOrRaiseMaster "firefox" (className =? "Firefox"))
<a name="line-183"></a> -}</span>
<a name="line-184"></a><span class='hs-definition'>runOrRaiseMaster</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Query</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-185"></a><span class='hs-definition'>runOrRaiseMaster</span> <span class='hs-varid'>run</span> <span class='hs-varid'>query</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>runOrRaiseAndDo</span> <span class='hs-varid'>run</span> <span class='hs-varid'>query</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>windows</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>swapMaster</span><span class='hs-layout'>)</span>
</pre></body>
</html>
