awesome/lib/awful/permissions/_common.lua

83 lines
2.7 KiB
Lua

-- Common code for the permission framework.
-- It is in its own file to avoid circular dependencies.
--
-- It is **NOT** a public API.
local module = {}
-- The default permissions for all requests.
-- If something is not in this list, then it is assumed it should be granted.
local default_permissions = {
client = {
autoactivate = {
-- To preserve the default from AwesomeWM 3.3-4.3, do not steal
-- focus by default for these contexts:
mouse_enter = false,
switch_tag = false,
history = false,
}
}
}
function module.check(object, class, request, context)
local ret = nil
if object._private.permissions and object._private.permissions[request] then
ret = object._private.permissions[request][context]
end
if ret ~= nil then return ret end
if not default_permissions[class] then return true end
if not default_permissions[class][request] then return true end
if default_permissions[class][request][context] == nil then return true end
return default_permissions[class][request][context]
end
function module.set(class, request, context, granted)
assert(type(granted) == "boolean")
if not default_permissions[class] then
default_permissions[class] = {}
end
if not default_permissions[class][request] then
default_permissions[class][request] = {}
end
default_permissions[class][request][context] = granted
end
-- Awesome 3.3-4.3 had an `awful.autofocus` module. That module had no APIs, but
-- was simply "enabled" when you `require()`d it for the first time. This was
-- non-standard and was the only module in `awful` to only do things when
-- explicitly `require()`d.
--
-- It is now a dummy module which will set the property to `true`.
function module._deprecated_autofocus_in_use()
module.set("client", "autoactivate", "mouse_enter", true)
module.set("client", "autoactivate", "switch_tag" , true)
module.set("client", "autoactivate", "history" , true)
end
local function set_object_permission_common(self, request, context, v)
self._private.permissions = self._private.permissions or {}
if not self._private.permissions[request] then
self._private.permissions[request] = {}
end
self._private.permissions[request][context] = v
end
-- Add the grant and deny methods to the objects.
function module.setup_grant(class, classname) -- luacheck: no unused
function class.grant(self, request, context)
set_object_permission_common(self, request, context, true)
end
function class.deny(self, request, context)
set_object_permission_common(self, request, context, false)
end
end
return module