379 lines
11 KiB
Lua
379 lines
11 KiB
Lua
--[[
|
|
Computable Pandoc:
|
|
(C) 2023 perro hi@perrotuerto.blog
|
|
License: GPLv3 https://git.cuates.net/perro/computable-pandoc/src/branch/no-masters/LICENSE.txt
|
|
Source: https://git.cuates.net/perro/computable-pandoc
|
|
]]--
|
|
|
|
require "fennel"
|
|
require "nat"
|
|
|
|
local lua_dog = require("dog")
|
|
|
|
dog.import()
|
|
|
|
---------------------------------- LITERATE ----------------------------------
|
|
|
|
-- Variable for all literate stuff
|
|
local lit = {}
|
|
|
|
-- Status indicator
|
|
lit.status = true
|
|
|
|
-- Grammars
|
|
function lit.g(name)
|
|
|
|
-- Variable for grammars collection
|
|
local grammars = {}
|
|
|
|
local P, S, R, Cf, Cc, Ct, V, Cs, Cg, Cb, B, C, Cmt =
|
|
lpeg.P, lpeg.S, lpeg.R, lpeg.Cf, lpeg.Cc, lpeg.Ct, lpeg.V,
|
|
lpeg.Cs, lpeg.Cg, lpeg.Cb, lpeg.B, lpeg.C, lpeg.Cmt
|
|
|
|
-- Lexical elements
|
|
local newline = P"\r"^-1 * P"\n"
|
|
local space = S" \t"
|
|
local anyspace = S" \t\r\n"
|
|
local spot = (1 - anyspace)
|
|
local any = (spot + space)
|
|
local yamlheader = space^0 * P"---" * space^0 * newline
|
|
local yamlfooter = space^0 * P"..." * space^0 * newline^-1
|
|
local yamlbody = -yamlfooter * any^0 * newline
|
|
local id = R("az", "AZ") * R("az", "AZ", "09")^0
|
|
local ref = -B"\\" * P"#" * C(id)
|
|
local notref = (1 - ref)^0
|
|
|
|
-- Declaration grammar
|
|
grammars["declaration"] = P {
|
|
"Declaration";
|
|
Declaration = Ct(V"YAML" * V"Code", "name");
|
|
YAML = C(yamlheader * yamlbody^0 * yamlfooter);
|
|
Code = C((any + newline)^0);
|
|
}
|
|
|
|
-- References grammar
|
|
grammars["references"] = notref * P {
|
|
"References";
|
|
References = Ct((ref * notref)^0);
|
|
} * -1
|
|
|
|
return grammars[name]
|
|
end
|
|
|
|
-- Prints located messages
|
|
function lit.puts(yaml_key, ...)
|
|
|
|
-- Returns debug level as number
|
|
local function debuglevel(str)
|
|
if str == "ERROR" then
|
|
lit.status = false
|
|
return 2
|
|
elseif str == "WARNING" then
|
|
return 1
|
|
else
|
|
return 0
|
|
end
|
|
end
|
|
|
|
-- Gets located message
|
|
local function getmsg(key, ...)
|
|
local msg = pandoc.metatotable(pandoc.read([[---
|
|
INFO:
|
|
checking:
|
|
en: "Checking:\n#1"
|
|
es: "Comprobando:\n#1"
|
|
skip_check:
|
|
en: "Skipping '#1': this check is not supported"
|
|
es: "Skipping '#1': esta comprobación no está soportada"
|
|
WARNING:
|
|
ignore_lang:
|
|
en: "Keys 'cmd' and 'lang' present: '#1' overrides '#2'"
|
|
es: "Llaves 'cmd' y 'lang' presentes: '#1' sobrescribe '#2'"
|
|
ERROR:
|
|
invalid_key:
|
|
en: Invalid key '#1'
|
|
es: Clave '#1' inválida
|
|
invalid_path:
|
|
en: Invalid path '#1' in key '#2'
|
|
es: Ruta '#1' inválida en clave '#2'
|
|
invalid_type:
|
|
en: Invalid type '#1' in key '#2'
|
|
es: Tipo '#1' inválido en clave '#2'
|
|
invalid_value:
|
|
en: Invalid value '#1' in key '#2'
|
|
es: Valor '#1' inválido en clave '#2'
|
|
invalid_cmd:
|
|
en: Invalid cmd '#1'
|
|
es: Comando '#1' inválido
|
|
no_key:
|
|
en: Key '#1' not found
|
|
es: Clave '#1' no encontrada
|
|
aborted:
|
|
en: Aborted due previous errors
|
|
es: Abortado debido a previos errores
|
|
meta_empty:
|
|
en: Empty metadata
|
|
es: Metadatos vacíos
|
|
meta_invalid:
|
|
en: Invalid metadata
|
|
es: Metadatos inválidos
|
|
...
|
|
]]).meta)
|
|
local levelname, level, lang = "INFO", 0, os.lang()
|
|
for mtype, msgs in pairs(msg) do
|
|
if msgs[key] ~= nil then
|
|
key = (msgs[key][lang] ~= nil and msgs[key][lang] or msgs[key]["en"])
|
|
for i, str in ipairs({...}) do
|
|
key = key:gsub("#" .. i, str)
|
|
end
|
|
levelname, level = mtype, debuglevel(mtype)
|
|
break
|
|
end
|
|
end
|
|
return key, levelname, level
|
|
end
|
|
|
|
local verbosity = debuglevel(PANDOC_STATE.verbosity)
|
|
local msg, levelname, level = getmsg(yaml_key, ...)
|
|
if level >= verbosity then
|
|
print("[" .. levelname .. "] [LIT] " .. msg)
|
|
end
|
|
end
|
|
|
|
-- Examinates (parses and evaluates) document
|
|
function lit.exam(doc)
|
|
|
|
-- Evaluates code declaration
|
|
-- Evals Lisp code
|
|
--[[
|
|
local function eval(code)
|
|
local is_passed, out = pcall (
|
|
function () return fennel.eval(code) end,
|
|
function (e) return e end
|
|
)
|
|
local lua = ""
|
|
local out = tostring(out)
|
|
local preview = out:gsub("\n.*", "")
|
|
if is_passed then
|
|
lua = fennel.compileString(code)
|
|
end
|
|
return {is_passed = is_passed, preview = preview, out = out, lua = lua}
|
|
end
|
|
]]--
|
|
|
|
-- Parses code declaration
|
|
local function parse(codeblock)
|
|
|
|
-- Checks code declarations
|
|
local function check(parsed)
|
|
|
|
-- Indicates if checks passes
|
|
local ispass = true
|
|
|
|
-- Valid metadata structure
|
|
local metastruct = {
|
|
["mandatory"] = {
|
|
-- Value as table == whole patterns to match
|
|
["id"] = {"%a[_%w]*"},
|
|
},
|
|
["optional"] = {
|
|
["lang"] = {
|
|
"lua", "fennel", "python", "js", "ruby", "lisp", "graphviz",
|
|
},
|
|
["cmd"] = {".+"},
|
|
-- Value as string == type to match
|
|
["args"] = "table",
|
|
["shift"] = "boolean",
|
|
["wipe"] = "boolean",
|
|
["typed"] = "boolean",
|
|
["link"] = "path",
|
|
["img"] = "path",
|
|
["alt"] = "string",
|
|
["dump"] = "path",
|
|
["quote"] = "boolean",
|
|
},
|
|
}
|
|
|
|
-- Language commands
|
|
local langcmds = {
|
|
["lua"] = {["int_eval"] = { "CMD1", "CMD2", } },
|
|
["fennel"] = {["int_eval"] = { "CMD1", "CMD2", } },
|
|
["python"] = {["ext_eval"] = { "CMD1", "CMD2", } },
|
|
["js"] = {["ext_eval"] = { "CMD1", "CMD2", } },
|
|
["ruby"] = {["ext_eval"] = { "CMD1", "CMD2", } },
|
|
["lisp"] = {["ext_eval"] = { "CMD1", "CMD2", } },
|
|
["graphviz"] = {["ext_eval"] = { "CMD1", "CMD2", } },
|
|
}
|
|
|
|
-- Prints error and does not pass the check
|
|
local function putserr(...)
|
|
lit.puts(...)
|
|
ispass = false
|
|
end
|
|
|
|
-- Adds 'eval' key in meta
|
|
-- This keys indicates what to eval
|
|
local function addeval(meta)
|
|
meta["eval"] = {}
|
|
if ispass then
|
|
if meta["lang"] and meta["cmd"] then
|
|
lit.puts("ignore_lang", meta["cmd"], meta["lang"])
|
|
meta["eval"] = {["ext_eval"] = { meta["cmd"] } }
|
|
elseif not(meta["lang"]) and not(meta["cmd"])then
|
|
meta["lang"] = "lua"
|
|
meta["eval"] = langcmds["lua"]
|
|
elseif meta["lang"] and not(meta["cmd"]) then
|
|
meta["eval"] = langcmds[meta["lang"]]
|
|
elseif not(meta["lang"]) and meta["cmd"] then
|
|
meta["eval"] = {["ext_eval"] = { meta["cmd"] } }
|
|
end
|
|
end
|
|
return meta
|
|
end
|
|
|
|
-- Checks for valid command
|
|
local function checkcmd(meta)
|
|
if meta["cmd"] then
|
|
local cmd = meta["cmd"]:split()[1]
|
|
if os.isunix() then
|
|
local status = io.try("type", cmd)
|
|
if not(status) then
|
|
putserr("invalid_cmd", cmd)
|
|
end
|
|
else
|
|
lit.puts("skip_check", "checkcmd")
|
|
end
|
|
end
|
|
end
|
|
|
|
-- Checks for extra and unwanted metadata
|
|
local function checkextra(meta)
|
|
for key, _ in pairs(meta) do
|
|
local missing1 = metastruct["mandatory"][key] == nil
|
|
local missing2 = metastruct["optional"][key] == nil
|
|
if missing1 and missing2 then
|
|
putserr("invalid_key", key)
|
|
end
|
|
end
|
|
end
|
|
|
|
-- Checks for valid metadata
|
|
local function checkmeta(metadata, kind)
|
|
|
|
-- Checks for valid metadata type
|
|
local function checktype(type1, meta, key)
|
|
local val = meta[key]
|
|
local type2 = type(val)
|
|
if type1 ~= type2 then
|
|
if type1 == "path" then
|
|
if not(pandoc.path.directory(val):isdir()) then
|
|
putserr("invalid_path", val, key)
|
|
end
|
|
else
|
|
putserr("invalid_type", type2, key)
|
|
end
|
|
end
|
|
end
|
|
|
|
-- Checks for valid metadata pattern
|
|
local function checkpattern(table, meta, key)
|
|
local val = tostring(meta[key])
|
|
local err = key
|
|
for _, pattern in pairs(table) do
|
|
if val:match("^" .. pattern .. "$") then
|
|
err = ""
|
|
break
|
|
end
|
|
end
|
|
if not(err:isempty()) then
|
|
putserr("invalid_value", val, err)
|
|
end
|
|
end
|
|
|
|
for key, val in pairs(metastruct[kind]) do
|
|
if metadata[key] == nil and kind == "mandatory" then
|
|
putserr("no_key", key)
|
|
elseif metadata[key] and type(val) == "table" then
|
|
checkpattern(val, metadata, key)
|
|
elseif metadata[key] then
|
|
checktype(val, metadata, key)
|
|
end
|
|
end
|
|
end
|
|
|
|
-- Parses metadata
|
|
local function parsemeta(yaml)
|
|
local isok, res = pcall(pandoc.read, yaml)
|
|
local meta = {}
|
|
if isok and not(pandoc.utils.stringify(res.meta):isempty()) then
|
|
meta = pandoc.metatotable(res.meta)
|
|
checkmeta(meta, "mandatory")
|
|
checkmeta(meta, "optional")
|
|
checkextra(meta)
|
|
checkcmd(meta)
|
|
elseif isok and pandoc.utils.stringify(res.meta):isempty() then
|
|
putserr("meta_empty")
|
|
else
|
|
putserr("meta_invalid")
|
|
end
|
|
return addeval(meta)
|
|
end
|
|
|
|
-- TODO
|
|
-- NOTE: if not valid code, return meta["eval"] = {}
|
|
local function checkcode(code, meta)
|
|
local references = lpeg.match(lit.g("references"), code)
|
|
if references then
|
|
for _, ref in ipairs(references) do
|
|
print("reference:", ref)
|
|
end
|
|
end
|
|
return "TODO"
|
|
end
|
|
|
|
lit.puts("checking", table.concat(parsed, ""):indent())
|
|
local meta = parsemeta(parsed[1])
|
|
-- TODO
|
|
-- Add each meta to a variable
|
|
-- Remove meta if doesn't pass checkcode
|
|
meta["code"] = checkcode(parsed[2], meta)
|
|
return meta
|
|
end
|
|
|
|
local parsed = lpeg.match(lit.g("declaration"), codeblock.text)
|
|
local checked = (parsed ~= nil and check(parsed) or parsed)
|
|
-- TODO:
|
|
-- evaluated = eval(checked)
|
|
-- TODO: write evaluated and do overrides with warns
|
|
-- return evaluated
|
|
return codeblock
|
|
end
|
|
|
|
-- TODO
|
|
-- Evals and inserts inline code
|
|
local function insert(code)
|
|
return code
|
|
end
|
|
|
|
-- Asserts literate status
|
|
local function assert()
|
|
if not(lit.status) then
|
|
lit.puts("aborted")
|
|
os.exit(1)
|
|
end
|
|
end
|
|
|
|
return doc:walk { CodeBlock = function(block) return parse(block) end }
|
|
:walk { Code = function(inline) return insert(inline) end }
|
|
:walk { Pandoc = function(_) assert() end }
|
|
end
|
|
|
|
------------------------------------ PANDOC -----------------------------------
|
|
|
|
return {
|
|
-- Parses and evals literate programming
|
|
{ Pandoc = function(e) return lit.exam(e) end },
|
|
-- TODO Parses and evals natural programming
|
|
-- { Inlines = function(e) return nat.get(pandoc.utils.stringify(e)) end },
|
|
}
|