1 files changed, 88 insertions, 0 deletions
diff --git a/awesome/lib/awful/client/urgent.lua b/awesome/lib/awful/client/urgent.lua
new file mode 100644
index 0000000..22f6a6d
--- /dev/null
+++ b/awesome/lib/awful/client/urgent.lua
@@ -0,0 +1,88 @@
+---------------------------------------------------------------------------
+--- Keep track of the urgent clients.
+--
+-- @author Julien Danjou &lt;julien@danjou.info&gt;
+-- @copyright 2008 Julien Danjou
+-- @submodule client
+---------------------------------------------------------------------------
+
+local urgent = {}
+
+local capi =
+{
+    client = client,
+}
+
+local client
+do
+    client = setmetatable({}, {
+        __index = function(_, k)
+            client = require("awful.client")
+            return client[k]
+        end,
+        __newindex = error -- Just to be sure in case anything ever does this
+    })
+end
+
+local data = setmetatable({}, { __mode = 'k' })
+
+--- Get the first client that got the urgent hint.
+--
+-- @function awful.urgent.get
+-- @treturn client.object The first urgent client.
+function urgent.get()
+    if #data > 0 then
+        return data[1]
+    else
+        -- fallback behaviour: iterate through clients and get the first urgent
+        local clients = capi.client.get()
+        for _, cl in pairs(clients) do
+            if cl.urgent then
+                return cl
+            end
+        end
+    end
+end
+
+--- Jump to the client that received the urgent hint first.
+--
+-- @function awful.urgent.jumpto
+-- @tparam bool|function merge If true then merge tags (select the client's
+--   first tag additionally) when the client is not visible.
+--   If it is a function, it will be called with the client as argument.
+function urgent.jumpto(merge)
+    local c = client.urgent.get()
+    if c then
+        c:jump_to(merge)
+    end
+end
+
+--- Adds client to urgent stack.
+--
+-- @function awful.urgent.add
+-- @client c The client object.
+-- @param prop The property which is updated.
+function urgent.add(c, prop)
+    if type(c) == "client" and prop == "urgent" and c.urgent then
+        table.insert(data, c)
+    end
+end
+
+--- Remove client from urgent stack.
+--
+-- @function awful.urgent.delete
+-- @client c The client object.
+function urgent.delete(c)
+    for k, cl in ipairs(data) do
+        if c == cl then
+            table.remove(data, k)
+            break
+        end
+    end
+end
+
+capi.client.connect_signal("property::urgent", urgent.add)
+capi.client.connect_signal("focus", urgent.delete)
+capi.client.connect_signal("unmanage", urgent.delete)
+
+return urgent