]> git.madduck.net Git - etc/awesome.git/blob - asyncshell.lua

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

alsa: added card, channel to widget table
[etc/awesome.git] / asyncshell.lua
1
2 --[[
3                                                   
4      Licensed under GNU General Public License v2 
5       * (c) 2013, Alexander Yakushev              
6                                                   
7 --]]
8
9 -- Asynchronous io.popen for Awesome WM.
10 -- How to use...
11 -- ...asynchronously:
12 -- asyncshell.request('wscript -Kiev', function(f) wwidget.text = f:read("*l") end)
13 -- ...synchronously
14 -- widget:set_text(asyncshell.demand('wscript -Kiev', 5):read("*l") or "Error")
15
16 -- This is more cpu demanding, but makes things faster.
17
18 local spawn = require('awful.util').spawn
19
20 asyncshell               = {}
21 asyncshell.request_table = {}
22 asyncshell.id_counter    = 0
23 asyncshell.folder        = "/tmp/asyncshell"
24 asyncshell.file_template = asyncshell.folder .. '/req'
25
26 -- Create a directory for asynchell response files
27 os.execute("mkdir -p " .. asyncshell.folder)
28
29 -- Returns next tag - unique identifier of the request
30 local function next_id()
31    asyncshell.id_counter = (asyncshell.id_counter + 1) % 100000
32    return asyncshell.id_counter
33 end
34
35 -- Sends an asynchronous request for an output of the shell command.
36 -- @param command Command to be executed and taken output from
37 -- @param callback Function to be called when the command finishes
38 -- @return Request ID
39 function asyncshell.request(command, callback)
40    local id = next_id()
41    local tmpfname = asyncshell.file_template .. id
42    asyncshell.request_table[id] = { callback = callback }
43    local req =
44       string.format("sh -c '%s > %s; " ..
45                     'echo "asyncshell.deliver(%s)" | ' ..
46                     "awesome-client' 2> /dev/null",
47                     string.gsub(command, "'", "'\\''"), tmpfname, id)
48    spawn(req, false)
49    return id
50 end
51
52 -- Calls the remembered callback function on the output of the shell
53 -- command.
54 -- @param id Request ID
55 -- @param output The output file of the shell command to be delievered
56 function asyncshell.deliver(id)
57    if asyncshell.request_table[id] and
58       asyncshell.request_table[id].callback then
59       local output = io.open(asyncshell.file_template .. id, 'r')
60       asyncshell.request_table[id].callback(output)
61    end
62 end
63
64 -- Sends a synchronous request for an output of the command. Waits for
65 -- the output, but if the given timeout expires returns nil.
66 -- @param command Command to be executed and taken output from
67 -- @param timeout Maximum amount of time to wait for the result
68 -- @return File handler on success, nil otherwise
69 function asyncshell.demand(command, timeout)
70    local id = next_id()
71    local tmpfname = asyncshell.file_template .. id
72    local f = io.popen(string.format("(%s > %s; echo asyncshell_done) & " ..
73                                     "(sleep %s; echo asynchell_timeout)",
74                                     command, tmpfname, timeout))
75    local result = f:read("*line")
76    if result == "asyncshell_done" then
77       return io.open(tmpfname)
78    end
79 end
80
81 return asyncshell