matcher.lua

local hasitem = require("gears.table").hasitem
local unpack = unpack or table.unpack -- luacheck: globals unpack (compatibility with Lua 5.1)

local matcher = {}

function matcher.parse(sequence, modifiers, pattern)
  local captures, matches = {}

  for index, item in ipairs(pattern) do
    sequence, matches = string.gsub(sequence, '^' .. (item[#item] or item), function(capture)
      table.insert(captures, capture)
      return ''
    end)

    -- modifiers are only compared for last match (applies only if pattern is a table)
    if #sequence == 0 and type(item) == "table" then
      if #modifiers == #item - 1 then
        for _, mod in pairs(modifiers) do
          if not hasitem(item, mod) then
            return false
          end
        end
      else
        return false
      end
    end

    if matches == 0 or (#sequence > 0 and index == #pattern) then
      return false
    elseif #sequence == 0 and index < #pattern then
      return true, false
    end
  end

  return true, true, captures
end

function matcher.execute(sequence, modifiers, commands)
  local sequence_processed = true
  for _, command in ipairs(commands) do
    local valid, finished, captures = matcher.parse(sequence, modifiers, command.pattern)

    if finished then
      -- make sure to return to caller gracefully, even under error conditions
      xpcall(function() command:handler(unpack(captures)) end,
        function(err) awesome.emit_signal("debug::error", err, true) end)
      return true
    elseif valid then
      sequence_processed = false
    end
  end

  return sequence_processed
end

return matcher