awful.tag: Add `gap_single_client` property and user changeable defaults.

lib/awful/layout/init.lua

@@ -137,7 +137,13 @@ function layout.parameters(t, screen)
 
     local p = {}
 
-    local useless_gap = t and t.gap or 0
+    local clients           = client.tiled(screen)
+    local gap_single_client = true
+    if(t and not (t.gap_single_client == nil)) then
+        gap_single_client = t.gap_single_client
+    end
+    local min_clients       = gap_single_client and 1 or 2
+    local useless_gap       = t and (#clients >= min_clients and t.gap or 0) or 0
 
     p.workarea = screen:get_bounding_geometry {
         honor_padding  = true,
@@ -146,7 +152,7 @@ function layout.parameters(t, screen)
     }
 
     p.geometry    = screen.geometry
-    p.clients     = client.tiled(screen)
+    p.clients     = clients
     p.screen      = screen.index
     p.padding     = screen.padding
     p.useless_gap = useless_gap

lib/awful/tag.lua

@@ -41,6 +41,41 @@ data.tags = setmetatable({}, { __mode = 'k' })
 tag.history = {}
 tag.history.limit = 20
 
+-- Default values
+tag.defaults = {}
+--- The gap between clients (in points).
+-- @tfield[opt=0] integer tag.defaults.gap
+-- @tparam[opt=0] integer gap
+-- @see gap
+-- @see gap_single_client
+tag.defaults.gap                 = 0
+--- The default gap_count.
+-- @tfield[opt=true] boolean tag.defaults.gap_single_client
+-- @tparam[opt=true] boolean gap_single_client
+-- @see gap
+-- @see gap_single_client
+tag.defaults.gap_single_client   = true
+--- The default master fill policy.
+-- @tfield[opt="expand"] string tag.defaults.master_fill_policy
+-- @tparam[opt="expand"] string master_fill_policy
+-- @see master_fill_policy
+tag.defaults.master_fill_policy  = "expand"
+--- The default master width factor.
+-- @tfield[opt=0.5] number tag.defaults.master_width_factor
+-- @tparam[opt=0.5] number master_width_factor
+-- @see master_width_factor
+tag.defaults.master_width_factor = 0.5
+--- The default master count.
+-- @tfield[opt=1] integer tag.defaults.master_count
+-- @tparam[opt=1] integer master_count
+-- @see master_count
+tag.defaults.master_count        = 1
+--- The default column count.
+-- @tfield[opt=1] integer tag.defaults.column_count
+-- @tparam[opt=1] integer column_count
+-- @see column_count
+tag.defaults.column_count        = 1
+
 -- screen.tags depend on index, it cannot be used by awful.tag
 local function raw_tags(scr)
     local tmp_tags = {}
@@ -55,6 +90,7 @@ end
 
 --- The number of elements kept in the history.
 -- @tfield integer awful.tag.history.limit
+-- @tparam[opt=20] integer limit
 
 --- The tag index.
 --
@@ -542,6 +578,13 @@ function tag.selected(s)
     return s.selected_tag
 end
 
+--- The default master width factor
+--
+-- @beautiful beautiful.master_width_factor
+-- @param number (default: 0.5)
+-- @see master_width_factor
+-- @see gap
+
 --- The tag master width factor.
 --
 -- The master width factor is one of the 5 main properties used to configure
@@ -561,6 +604,7 @@ end
 -- @see column_count
 -- @see master_fill_policy
 -- @see gap
+-- @see tag.defaults.master_width_factor
 
 function tag.object.set_master_width_factor(t, mwfact)
     if mwfact >= 0 and mwfact <= 1 then
@@ -570,7 +614,7 @@ function tag.object.set_master_width_factor(t, mwfact)
 end
 
 function tag.object.get_master_width_factor(t)
-    return tag.getproperty(t, "master_width_factor") or 0.5
+    return tag.getproperty(t, "master_width_factor") or beautiful.master_width_factor or tag.defaults.master_width_factor
 end
 
 --- Set master width factor.
@@ -764,6 +808,7 @@ end
 -- @beautiful beautiful.useless_gap
 -- @param number (default: 0)
 -- @see gap
+-- @see gap_single_client
 
 --- The gap (spacing, also called `useless_gap`) between clients.
 --
@@ -776,6 +821,8 @@ end
 --
 -- @property gap
 -- @param number The value has to be greater than zero.
+-- @see tag.defaults.gap
+-- @see gap_single_client
 
 function tag.object.set_gap(t, useless_gap)
     if useless_gap >= 0 then
@@ -784,7 +831,7 @@ function tag.object.set_gap(t, useless_gap)
 end
 
 function tag.object.get_gap(t)
-    return tag.getproperty(t, "useless_gap") or beautiful.useless_gap or 0
+    return tag.getproperty(t, "useless_gap") or beautiful.useless_gap or tag.defaults.gap
 end
 
 --- Set the spacing between clients
@@ -808,6 +855,33 @@ function tag.incgap(add, t)
     tag.object.set_gap(t, tag.object.get_gap(t) + add)
 end
 
+--- Enable gaps for a single client.
+--
+-- @beautiful beautiful.gap_single_client
+-- @param boolean (default: true)
+-- @see gap
+-- @see gap_single_client
+
+--- Enable gaps for a single client.
+--
+-- **Signal:**
+--
+-- * *property::gap\_single\_client*
+--
+-- @property gap_single_client
+-- @param boolean Enable gaps for a single client
+-- @see tag.defaults.gap_single_client
+
+function tag.object.set_gap_single_client(t, gap_single_client)
+    tag.setproperty(t, "gap_single_client", gap_single_client == true)
+end
+
+function tag.object.get_gap_single_client(t)
+    return tag.getproperty(t, "gap_single_client")
+        or beautiful.gap_single_client
+        or tag.defaults.gap_single_client
+end
+
 --- Get the spacing between clients.
 -- @deprecated awful.tag.getgap
 -- @see gap
@@ -825,6 +899,12 @@ function tag.getgap(t, numclients)
     return tag.object.get_gap(t or ascreen.focused().selected_tag)
 end
 
+--- The default fill policy
+--
+-- @beautiful beautiful.master_fill_policy
+-- @param string (default: "expand")
+-- @see master_fill_policy
+
 --- Set size fill policy for the master client(s).
 --
 -- **Signal:**
@@ -833,9 +913,10 @@ end
 --
 -- @property master_fill_policy
 -- @param string "expand" or "master_width_factor"
+-- @see tag.defaults.master_fill_policy
 
 function tag.object.get_master_fill_policy(t)
-    return tag.getproperty(t, "master_fill_policy") or "expand"
+    return tag.getproperty(t, "master_fill_policy") or beautiful.master_fill_policy or tag.defaults.master_fill_policy
 end
 
 --- Set size fill policy for the master client(s)
@@ -878,9 +959,15 @@ function tag.getmfpol(t)
     util.deprecate("Use t.master_fill_policy instead of awful.tag.getmfpol")
 
     t = t or ascreen.focused().selected_tag
-    return tag.getproperty(t, "master_fill_policy") or "expand"
+    return tag.getproperty(t, "master_fill_policy") or beautiful.master_fill_policy or tag.defaults.master_fill_policy
 end
 
+--- The default number of master windows.
+--
+-- @beautiful beautiful.master_count
+-- @param integer (default: 1)
+-- @see master_count
+
 --- Set the number of master windows.
 --
 -- **Signal:**
@@ -890,6 +977,7 @@ end
 --
 -- @property master_count
 -- @param integer nmaster Only positive values are accepted
+-- @see tag.defaults.master_count
 
 function tag.object.set_master_count(t, nmaster)
     if nmaster >= 0 then
@@ -899,7 +987,7 @@ function tag.object.set_master_count(t, nmaster)
 end
 
 function tag.object.get_master_count(t)
-    return tag.getproperty(t, "master_count") or 1
+    return tag.getproperty(t, "master_count") or beautiful.master_count or tag.defaults.master_count
 end
 
 --- 
@@ -987,6 +1075,12 @@ function tag.geticon(_tag)
     return tag.getproperty(_tag, "icon")
 end
 
+--- The default number of columns.
+--
+-- @beautiful beautiful.column_count
+-- @param integer (default: 1)
+-- @see column_count
+
 --- Set the number of columns.
 --
 -- **Signal:**
@@ -996,6 +1090,7 @@ end
 --
 -- @property column_count
 -- @tparam integer ncol Has to be greater than 1
+-- @see tag.defaults.column_count
 
 function tag.object.set_column_count(t, ncol)
     if ncol >= 1 then
@@ -1005,7 +1100,7 @@ function tag.object.set_column_count(t, ncol)
 end
 
 function tag.object.get_column_count(t)
-    return tag.getproperty(t, "column_count") or 1
+    return tag.getproperty(t, "column_count") or beautiful.column_count or tag.defaults.column_count
 end
 
 --- Set number of column windows.