X-Git-Url: https://git.madduck.net/etc/awesome.git/blobdiff_plain/00a2951166f61cbbfe1d6e042fe0e53427c001cd..fd35485c200a52c9429f9a4f3f5c8282b64dba30:/helpers.lua diff --git a/helpers.lua b/helpers.lua index 7677768..6a47738 100644 --- a/helpers.lua +++ b/helpers.lua @@ -1,17 +1,22 @@ --[[ - - Licensed under GNU General Public License v2 - * (c) 2013, Luke Bonham - * (c) 2010-2012, Peter Hofmann - * (c) 2010, Adrian C. - + + Licensed under GNU General Public License v2 + * (c) 2013, Luke Bonham + --]] -local awful = require("awful") local debug = require("debug") -local pairs = pairs + +local assert = assert +local capi = { timer = (type(timer) == 'table' and timer or require ("gears.timer")) } +local io = { open = io.open, + lines = io.lines, + popen = io.popen } local rawget = rawget +local table = { sort = table.sort } + +local wibox = require("wibox") -- Lain helper functions for internal use -- lain.helpers @@ -30,45 +35,95 @@ end -- }}} --- {{{ --- If lain.terminal is a string, e.g. "xterm", then "xterm -e " .. cmd is --- run. But if lain.terminal is a function, then terminal(cmd) is run. - -function helpers.run_in_terminal(cmd) - if type(terminal) == "function" - then - terminal(cmd) - elseif type(terminal) == "string" - then - awful.util.spawn(terminal .. ' -e ' .. cmd) - end +-- {{{ File operations + +-- see if the file exists and is readable +function helpers.file_exists(file) + local f = io.open(file) + if f then + local s = f:read() + f:close() + f = s + end + return f ~= nil +end + +-- get all lines from a file, returns an empty +-- list/table if the file does not exist +function helpers.lines_from(file) + if not helpers.file_exists(file) then return {} end + local lines = {} + for line in io.lines(file) do + lines[#lines + 1] = line + end + return lines +end + +-- match all lines from a file, returns an empty +-- list/table if the file or match does not exist +function helpers.lines_match(regexp, file) + local lines = {} + for index,line in pairs(helpers.lines_from(file)) do + if string.match(line, regexp) then + lines[index] = line + end + end + return lines +end + +-- get first line of a file, return nil if +-- the file does not exist +function helpers.first_line(file) + return helpers.lines_from(file)[1] +end + +-- get first non empty line from a file, +-- returns nil otherwise +function helpers.first_nonempty_line(file) + for k,v in pairs(helpers.lines_from(file)) do + if #v then return v end + end + return nil end -- }}} --- {{{ Format units to one decimal point +-- {{{ Timer maker + +helpers.timer_table = {} -function helpers.uformat(array, key, value, unit) - for u, v in pairs(unit) do - array["{"..key.."_"..u.."}"] = string.format("%.1f", value/v) +function helpers.newtimer(_name, timeout, fun, nostart) + local name = timeout + if not helpers.timer_table[name] then + helpers.timer_table[name] = capi.timer({ timeout = timeout }) + helpers.timer_table[name]:start() + end + helpers.timer_table[name]:connect_signal("timeout", fun) + if not nostart then + helpers.timer_table[name]:emit_signal("timeout") end - return array end -- }}} --- {{{ Read the first line of a file or return nil. +-- {{{ Pipe operations -function helpers.first_line(f) - local fp = io.open(f) - if not fp - then - return nil - end +-- read the full output of a command output +function helpers.read_pipe(cmd) + local f = assert(io.popen(cmd)) + local output = f:read("*all") + f:close() + return output +end - local content = fp:read("*l") - fp:close() - return content +-- return line iterator of a command output +function helpers.pipelines(...) + local f = assert(io.popen(...)) + return function () -- iterator + local data = f:read() + if data == nil then f:close() end + return data + end end -- }}} @@ -87,4 +142,34 @@ end -- }}} +-- {{{ Misc + +-- iterate over table of records sorted by keys +function helpers.spairs(t) + -- collect the keys + local keys = {} + for k in pairs(t) do keys[#keys+1] = k end + + table.sort(keys) + + -- return the iterator function + local i = 0 + return function() + i = i + 1 + if keys[i] then + return keys[i], t[keys[i]] + end + end +end + +-- create a lain textbox widget +function helpers.make_widget_textbox() + local w = wibox.widget.textbox('') + local t = wibox.widget.base.make_widget(w) + t.widget = w + return t +end + +-- }}} + return helpers