merge the C branch into HEAD

1 files changed, 66 insertions, 0 deletions

diff --git a/python/focus.py b/python/focus.py
new file mode 100644
index 00000000..9cf37e63
--- /dev/null
+++ b/python/focus.py
@@ -0,0 +1,66 @@
+###########################################################################
+###          Functions for helping out with your window focus.          ###
+###########################################################################
+
+import config, ob, hooks
+
+export_functions = ()
+
+config.add('focus',
+           'avoid_skip_taskbar',
+           'Avoid SkipTaskbar Windows',
+           "Don't focus windows which have requested to not be displayed " + \
+           "in taskbars. You will still be able to focus the windows, but " + \
+           "not through cycling, and they won't be focused as a fallback " + \
+           "if 'Focus Fallback' is enabled.",
+           'boolean',
+           1)
+
+config.add('focus',
+           'fallback',
+           'Focus Fallback',
+           "Send focus somewhere when nothing is left with the focus, if " + \
+           "possible.",
+           'boolean',
+           1)
+                    
+# maintain a list of clients, stacked in focus order
+_clients = []
+_skip = 0
+
+def focusable(client, desktop):
+    if not client.normal(): return False
+    if not (client.canFocus() or client.focusNotify()): return False
+    if client.iconic(): return False
+    if config.get('focus', 'avoid_skip_taskbar') and \
+       client.skipTaskbar(): return False
+
+    desk = client.desktop()
+    if not (desk == 0xffffffff or desk == desktop): return False
+
+    return True
+
+def _focused(client):
+    global _clients, _skip
+
+    if _skip:
+        _skip -= 1
+        return
+
+    if client:
+        # move it to the top
+        _clients.remove(client)
+        _clients.insert(0, client)
+    elif config.get('focus', 'fallback'):
+        # pass around focus
+        desktop = ob.Openbox.desktop()
+        for c in _clients:
+            if focusable(c, desktop):
+                c.focus()
+                break
+
+hooks.managed.append(lambda c: _clients.append(c))
+hooks.closed.append(lambda c: _clients.remove(c))
+hooks.focused.append(_focused)
+
+print "Loaded focus.py"