← Back
Editing: confighelp.lua
local opts local known_attrs = { data = 1, example = 1, type = 1, required = 1, default = 1, mixins = 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 string.format('%s%s%s', 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 data = value['data'] if type(data) == 'string' then local nv = string.match(data, '^#%s*(.*)%s*$') or data print(string.format('%s\tDescription: %s', tabs, nv)) elseif type(data) == 'table' and data.summary then print(string.format('%s\tDescription: %s', tabs, data.summary)) end 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 value['mixins'] then local mixin_names = {} for _, mixin in ipairs(value['mixins']) do table.insert(mixin_names, mixin.name or mixin.schema_id or 'unknown') end print(string.format('%s\tMixins: %s', tabs, table.concat(mixin_names, ', '))) print(string.format('%s\t(Use `rspamadm confighelp <mixin>` for details)', tabs)) 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
Save File
Cancel