<?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/Util/Dmenu.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-2"></a><span class='hs-comment'>-- |</span> <a name="line-3"></a><span class='hs-comment'>-- Module : XMonad.Util.Dmenu</span> <a name="line-4"></a><span class='hs-comment'>-- Copyright : (c) Spencer Janssen <spencerjanssen@gmail.com></span> <a name="line-5"></a><span class='hs-comment'>-- License : BSD-style (see LICENSE)</span> <a name="line-6"></a><span class='hs-comment'>--</span> <a name="line-7"></a><span class='hs-comment'>-- Maintainer : Spencer Janssen <spencerjanssen@gmail.com></span> <a name="line-8"></a><span class='hs-comment'>-- Stability : unstable</span> <a name="line-9"></a><span class='hs-comment'>-- Portability : unportable</span> <a name="line-10"></a><span class='hs-comment'>--</span> <a name="line-11"></a><span class='hs-comment'>-- A convenient binding to dmenu.</span> <a name="line-12"></a><span class='hs-comment'>--</span> <a name="line-13"></a><span class='hs-comment'>-- Requires the process-1.0 package</span> <a name="line-14"></a><span class='hs-comment'>--</span> <a name="line-15"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-16"></a> <a name="line-17"></a><span class='hs-keyword'>module</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'>Dmenu</span> <span class='hs-layout'>(</span> <a name="line-18"></a> <span class='hs-comment'>-- * Usage</span> <a name="line-19"></a> <span class='hs-comment'>-- $usage</span> <a name="line-20"></a> <span class='hs-varid'>dmenu</span><span class='hs-layout'>,</span> <span class='hs-varid'>dmenuXinerama</span><span class='hs-layout'>,</span> <span class='hs-varid'>dmenuMap</span><span class='hs-layout'>,</span> <span class='hs-varid'>menu</span><span class='hs-layout'>,</span> <span class='hs-varid'>menuArgs</span><span class='hs-layout'>,</span> <span class='hs-varid'>menuMap</span><span class='hs-layout'>,</span> <span class='hs-varid'>menuMapArgs</span> <a name="line-21"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-22"></a> <a name="line-23"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span> <a name="line-24"></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> <a name="line-25"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Map</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>M</span> <a name="line-26"></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> <a name="line-27"></a> <a name="line-28"></a><span class='hs-comment'>-- $usage</span> <a name="line-29"></a><span class='hs-comment'>-- You can use this module with the following in your Config.hs file:</span> <a name="line-30"></a><span class='hs-comment'>--</span> <a name="line-31"></a><span class='hs-comment'>-- > import XMonad.Util.Dmenu</span> <a name="line-32"></a><span class='hs-comment'>--</span> <a name="line-33"></a><span class='hs-comment'>-- These functions block xmonad's event loop until dmenu exits; this means that</span> <a name="line-34"></a><span class='hs-comment'>-- programs will not be able to open new windows and you will not be able to</span> <a name="line-35"></a><span class='hs-comment'>-- change workspaces or input focus until you have responded to the prompt one</span> <a name="line-36"></a><span class='hs-comment'>-- way or another.</span> <a name="line-37"></a> <a name="line-38"></a><span class='hs-comment'>-- %import XMonad.Util.Dmenu</span> <a name="line-39"></a> <a name="line-40"></a><a name="dmenuXinerama"></a><span class='hs-comment'>-- | Starts dmenu on the current screen. Requires this patch to dmenu:</span> <a name="line-41"></a><span class='hs-comment'>-- <<a href="http://www.jcreigh.com/dmenu/dmenu-3.2-xinerama.patch">http://www.jcreigh.com/dmenu/dmenu-3.2-xinerama.patch</a>></span> <a name="line-42"></a><span class='hs-definition'>dmenuXinerama</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>String</span> <a name="line-43"></a><span class='hs-definition'>dmenuXinerama</span> <span class='hs-varid'>opts</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-44"></a> <span class='hs-varid'>curscreen</span> <span class='hs-keyglyph'><-</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>screen</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>current</span><span class='hs-layout'>)</span> <span class='hs-varop'>`fmap`</span> <span class='hs-varid'>gets</span> <span class='hs-varid'>windowset</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>Int</span> <a name="line-45"></a> <span class='hs-varid'>runProcessWithInput</span> <span class='hs-str'>"dmenu"</span> <span class='hs-keyglyph'>[</span><span class='hs-str'>"-xs"</span><span class='hs-layout'>,</span> <span class='hs-varid'>show</span> <span class='hs-layout'>(</span><span class='hs-varid'>curscreen</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-layout'>(</span><span class='hs-varid'>unlines</span> <span class='hs-varid'>opts</span><span class='hs-layout'>)</span> <a name="line-46"></a> <span class='hs-varid'>menuArgs</span> <span class='hs-str'>"dmenu"</span> <span class='hs-keyglyph'>[</span><span class='hs-str'>"-xs"</span><span class='hs-layout'>,</span> <span class='hs-varid'>show</span> <span class='hs-layout'>(</span><span class='hs-varid'>curscreen</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-varid'>opts</span> <a name="line-47"></a> <a name="line-48"></a><a name="dmenu"></a><span class='hs-comment'>-- | Run dmenu to select an option from a list.</span> <a name="line-49"></a><span class='hs-definition'>dmenu</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>String</span> <a name="line-50"></a><span class='hs-definition'>dmenu</span> <span class='hs-varid'>opts</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>menu</span> <span class='hs-str'>"dmenu"</span> <span class='hs-varid'>opts</span> <a name="line-51"></a> <a name="line-52"></a><a name="menu"></a><span class='hs-comment'>-- | like 'dmenu' but also takes the command to run.</span> <a name="line-53"></a><span class='hs-definition'>menu</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>String</span> <a name="line-54"></a><span class='hs-definition'>menu</span> <span class='hs-varid'>menuCmd</span> <span class='hs-varid'>opts</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>menuArgs</span> <span class='hs-varid'>menuCmd</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>opts</span> <a name="line-55"></a> <a name="line-56"></a><a name="menuArgs"></a><span class='hs-comment'>-- | Like 'menu' but also takes a list of command line arguments.</span> <a name="line-57"></a><span class='hs-definition'>menuArgs</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>String</span> <a name="line-58"></a><span class='hs-definition'>menuArgs</span> <span class='hs-varid'>menuCmd</span> <span class='hs-varid'>args</span> <span class='hs-varid'>opts</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fmap</span> <span class='hs-layout'>(</span><span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varop'>/=</span><span class='hs-chr'>'\n'</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>runProcessWithInput</span> <span class='hs-varid'>menuCmd</span> <span class='hs-varid'>args</span> <span class='hs-layout'>(</span><span class='hs-varid'>unlines</span> <span class='hs-varid'>opts</span><span class='hs-layout'>)</span> <a name="line-59"></a> <a name="line-60"></a><a name="menuMap"></a><span class='hs-comment'>-- | Like 'dmenuMap' but also takes the command to run.</span> <a name="line-61"></a><span class='hs-definition'>menuMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-conid'>Map</span> <span class='hs-conid'>String</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-62"></a><span class='hs-definition'>menuMap</span> <span class='hs-varid'>menuCmd</span> <span class='hs-varid'>selectionMap</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>menuMapArgs</span> <span class='hs-varid'>menuCmd</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>selectionMap</span> <a name="line-63"></a> <a name="line-64"></a><a name="menuMapArgs"></a><span class='hs-comment'>-- | Like 'menuMap' but also takes a list of command line arguments.</span> <a name="line-65"></a><span class='hs-definition'>menuMapArgs</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-conid'>Map</span> <span class='hs-conid'>String</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-66"></a><span class='hs-definition'>menuMapArgs</span> <span class='hs-varid'>menuCmd</span> <span class='hs-varid'>args</span> <span class='hs-varid'>selectionMap</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-67"></a> <span class='hs-varid'>selection</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>menuFunction</span> <span class='hs-layout'>(</span><span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-varid'>keys</span> <span class='hs-varid'>selectionMap</span><span class='hs-layout'>)</span> <a name="line-68"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-varid'>lookup</span> <span class='hs-varid'>selection</span> <span class='hs-varid'>selectionMap</span> <a name="line-69"></a> <span class='hs-keyword'>where</span> <a name="line-70"></a> <span class='hs-varid'>menuFunction</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>menuArgs</span> <span class='hs-varid'>menuCmd</span> <span class='hs-varid'>args</span> <a name="line-71"></a> <a name="line-72"></a><a name="dmenuMap"></a><span class='hs-comment'>-- | Run dmenu to select an entry from a map based on the key.</span> <a name="line-73"></a><span class='hs-definition'>dmenuMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>M</span><span class='hs-varop'>.</span><span class='hs-conid'>Map</span> <span class='hs-conid'>String</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-74"></a><span class='hs-definition'>dmenuMap</span> <span class='hs-varid'>selectionMap</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>menuMap</span> <span class='hs-str'>"dmenu"</span> <span class='hs-varid'>selectionMap</span> </pre></body> </html>
