if not modules then modules = { } end modules ['mtx-kpse'] = {
    version   = 1.001,
    comment   = "companion to mtxrun.lua",
    author    = "Hans Hagen, PRAGMA-ADE, Hasselt NL",
    copyright = "PRAGMA ADE / ConTeXt Development Team",
    license   = "see context related readme files"
}

-- I decided to make this module after a report on the mailing list about
-- a clash with texmf-var on a system that had texlive installed. One way
-- to figure that out is to use kpse. We had the code anyway so next time
-- there is some issue ...

trackers.enable("resolvers.lib.silent")

local kpse = LUATEXENGINE == "luametatex" and require("libs-imp-kpse.lmt")

if type(kpse) ~= "table" then
    return
end

local helpinfo = [[
<?xml version="1.0"?>
<application>
 <metadata>
  <entry name="name">mtx-kpse</entry>
  <entry name="detail">ConTeXt KPSE checking utility</entry>
  <entry name="version">1.00</entry>
 </metadata>
 <flags>
  <category name="basic">
   <subcategory>
    <flag name="progname"><short>mandate, set the program name (e.g. pdftex)</short></flag>
    <flag name="findfile"><short>report the fully qualified path of the given file</short></flag>
    <flag name="findfiles"><short>report a list of all full names of the given file</short></flag>
    <flag name="expandpath"><short>expand the given path variable</short></flag>
    <flag name="expandvar"><short>expand a variable</short></flag>
    <flag name="expandbraces"><short>expand a complex variable specification</short></flag>
    <flag name="varvalue"><short>show the value of a variable</short></flag>
    <flag name="readablefile"><short>report if a file is readable</short></flag>
    <flag name="filetypes"><short>list all supported formats</short></flag>
   </subcategory>
  </category>
  <category name="additional">
   <subcategory>
    <flag name="format"><short>format type</short></flag>
    <flag name="path"><short>path variable</short></flag>
    <flag name="split"><short>split result in lines</short></flag>
   </subcategory>
  </category>
 </flags>
 <examples>
  <category>
   <title>Examples</title>
   <subcategory>
    <example><command>mtxrun --script kpse --progname=pdftex --findfile  context.mkii</command></example>
    <example><command>mtxrun --script kpse --progname=pdftex --findfile  context.mkii --format=tex</command></example>
    <example><command>mtxrun --script kpse --progname=pdftex --findfiles context.mkii --path=$TEXINPUTS</command></example>
   </subcategory>
   <subcategory>
    <example><command>mtxrun --script kpse --progname=pdftex --expandpath $TEXMFVAR</command></example>
    <example><command>mtxrun --script kpse --progname=pdftex --expandpath $TEXINPUTS -- split</command></example>
   </subcategory>
  </category>
 </examples>
</application>
]]

local application = logs.application {
    name     = "mtx-kpse",
    banner   = "ConTeXt KPSE checking utility",
    helpinfo = helpinfo,
}

local report   = application.report
local argument = environment.argument
local files    = environment.files
local target   = files[1]

if argument("progname") or argument("programname") then
    kpse.set_program_name(argument("progname"))
else
    application.help()
    return
end

local function printtable(result)
    if type(result) == "table" then
        for i=1,#result do
            print(result[i])
        end
    end
end

if argument("exporthelp") then
    application.export(environment.argument("exporthelp"),target)
elseif argument("filetypes") or argument("formats") then
    print(table.concat(kpse.get_file_types()," "))
elseif type(target) == "string" and target ~= "" then
    if argument("findfiles") or argument("find-files") then
        printtable(kpse.find_files(argument("path"),target))
    elseif argument("findfile") or argument("find-file") then
        print(kpse.find_file(target,argument("format")))
    elseif argument("expandpath") or argument("expand-path") then
        local result = kpse.expand_path(target)
        if result and argument("split") then
            printtable(string.split(result,";"))
        else
            print(result)
        end
    elseif argument("expandvar") or argument("expand-var") then
        print(kpse.expand_var(target))
    elseif argument("expandbraces") or argument("expand-braces") then
        print(kpse.expand_braces(target))
    elseif argument("varvalue") or argument("var-value") then
        print(kpse.var_value(target))
    elseif argument("readablefile") or argument("readable-file") then
        print(kpse.readable_file(target))
    else
        application.help()
    end
else
    application.help()
end