Gecko [ www.jdcpatala.org ]

Name	Size	Permission
classifier_test.lua	8.32 KB	-rw-r--r--
clickhouse.lua	16.4 KB	-rw-r--r--
configgraph.lua	4.43 KB	-rw-r--r--
confighelp.lua	2.94 KB	-rw-r--r--
configwizard.lua	22.89 KB	-rw-r--r--
cookie.lua	3.03 KB	-rw-r--r--
corpus_test.lua	4.67 KB	-rw-r--r--
dkim_keygen.lua	4.91 KB	-rw-r--r--
dmarc_report.lua	21.65 KB	-rw-r--r--
dns_tool.lua	6.02 KB	-rw-r--r--
fuzzy_convert.lua	5.29 KB	-rw-r--r--
fuzzy_ping.lua	6.72 KB	-rw-r--r--
fuzzy_stat.lua	10.7 KB	-rw-r--r--
grep.lua	4.81 KB	-rw-r--r--
keypair.lua	12.66 KB	-rw-r--r--
mime.lua	31.04 KB	-rw-r--r--
neural_test.lua	6.11 KB	-rw-r--r--
publicsuffix.lua	2.25 KB	-rw-r--r--
ratelimit.lua	6.82 KB	-rw-r--r--
secretbox.lua	4.62 KB	-rw-r--r--
stat_convert.lua	1.14 KB	-rw-r--r--
statistics_dump.lua	13.96 KB	-rw-r--r--
template.lua	3.45 KB	-rw-r--r--
vault.lua	15.26 KB	-rw-r--r--

Code Editor : confighelp.lua

local opts
local known_attrs = {
  data = 1,
  example = 1,
  type = 1,
  required = 1,
  default = 1,
}
local argparse = require "argparse"
local ansicolors = require "ansicolors"

local parser = argparse()
    :name "rspamadm confighelp"
    :description "Shows help for the specified configuration options"
    :help_description_margin(32)
parser:argument "path":args "*"
      :description('Optional config paths')
parser:flag "--no-color"
      :description "Disable coloured output"
parser:flag "--short"
      :description "Show only option names"
parser:flag "--no-examples"
      :description "Do not show examples (implied by --short)"

local function maybe_print_color(key)
  if not opts['no-color'] then
    return ansicolors.white .. key .. ansicolors.reset
  else
    return key
  end
end

local function sort_values(tbl)
  local res = {}
  for k, v in pairs(tbl) do
    table.insert(res, { key = k, value = v })
  end

-- Sort order
  local order = {
    options = 1,
    dns = 2,
    upstream = 3,
    logging = 4,
    metric = 5,
    composite = 6,
    classifier = 7,
    modules = 8,
    lua = 9,
    worker = 10,
    workers = 11,
  }

table.sort(res, function(a, b)
    local oa = order[a['key']]
    local ob = order[b['key']]

if oa and ob then
      return oa < ob
    elseif oa then
      return -1 < 0
    elseif ob then
      return 1 < 0
    else
      return a['key'] < b['key']
    end

end)

return res
end

local function print_help(key, value, tabs)
  print(string.format('%sConfiguration element: %s', tabs, maybe_print_color(key)))

if not opts['short'] then
    if value['data'] then
      local nv = string.match(value['data'], '^#%s*(.*)%s*$') or value.data
      print(string.format('%s\tDescription: %s', tabs, nv))
    end
    if type(value['type']) == 'string' then
      print(string.format('%s\tType: %s', tabs, value['type']))
    end
    if type(value['required']) == 'boolean' then
      if value['required'] then
        print(string.format('%s\tRequired: %s', tabs,
            maybe_print_color(tostring(value['required']))))
      else
        print(string.format('%s\tRequired: %s', tabs,
            tostring(value['required'])))
      end
    end
    if value['default'] then
      print(string.format('%s\tDefault: %s', tabs, value['default']))
    end
    if not opts['no-examples'] and value['example'] then
      local nv = string.match(value['example'], '^%s*(.*[^%s])%s*$') or value.example
      print(string.format('%s\tExample:\n%s', tabs, nv))
    end
    if value.type and value.type == 'object' then
      print('')
    end
  end

local sorted = sort_values(value)
  for _, v in ipairs(sorted) do
    if not known_attrs[v['key']] then
      -- We need to go deeper
      print_help(v['key'], v['value'], tabs .. '\t')
    end
  end
end

return function(args, res)
  opts = parser:parse(args)

local sorted = sort_values(res)

for _, v in ipairs(sorted) do
    print_help(v['key'], v['value'], '')
    print('')
  end
end

${this.title}

Code Editor : confighelp.lua