mirror of
https://github.com/Reuh/anselme.git
synced 2025-10-27 16:49:31 +00:00
Étienne Reuh Fildadut
fe351b5ca4
Woke up and felt like changing a couple things. It's actually been worked on for a while, little at a time... The goal was to make the language and implementation much simpler. Well I don't know if it really ended up being simpler but it sure is more robust. Main changes: * proper first class functions and closures supports! proper scoping rules! no more namespace shenanigans! * everything is an expression, no more statements! make the implementation both simpler and more complex, but it's much more consistent now! the syntax has massively changed as a result though. * much more organized and easy to modify codebase: one file for each AST node, no more random fields or behavior set by some random node exceptionally, everything should now follow the same API defined in ast.abstract.Node Every foundational feature should be implemented right now. The vast majority of things that were possible in v2 are possible now; some things aren't, but that's usually because v2 is a bit more sane. The main missing things before a proper release are tests and documentation. There's a few other things that might be implemented later, see the ideas.md file.
80 lines
2 KiB
Lua
80 lines
2 KiB
Lua
--- The main module.
|
|
|
|
-- Naming conventions:
|
|
-- * Classes
|
|
-- * everything_else
|
|
-- * (note: "classes" that are not meat to be instancied and are just here to benefit from inheritance fall into everything_else, e.g. parsing classes)
|
|
|
|
--- Usage:
|
|
-- ```lua
|
|
-- local anselme = require("anselme")
|
|
--
|
|
-- -- create a new state
|
|
-- local state = anselme.new()
|
|
-- state:load_stdlib()
|
|
--
|
|
-- -- read an anselme script file
|
|
-- local f = assert(io.open("script.ans"))
|
|
-- local script = anselme.parse(f:read("*a"), "script.ans")
|
|
-- f:close()
|
|
--
|
|
-- -- load the script in a new branch
|
|
-- local run_state = state:branch()
|
|
-- run_state:run(script)
|
|
--
|
|
-- -- run the script
|
|
-- while run_state:active() do
|
|
-- local e, data = run_state:step()
|
|
-- if e == "text" then
|
|
-- for _, l in ipairs(data) do
|
|
-- print(l:format(run_state))
|
|
-- end
|
|
-- elseif e == "choice" then
|
|
-- for i, l in ipairs(data) do
|
|
-- print(("%s> %s"):format(i, l:format(run_state)))
|
|
-- end
|
|
-- local choice = tonumber(io.read("*l"))
|
|
-- data:choose(choice)
|
|
-- elseif e == "return" then
|
|
-- run_state:merge()
|
|
-- elseif e == "error" then
|
|
-- error(data)
|
|
-- end
|
|
-- end
|
|
-- ```
|
|
|
|
local parser = require("parser")
|
|
local State = require("state.State")
|
|
require("ast.abstract.Node"):_i_hate_cycles()
|
|
|
|
return {
|
|
--- Global version string. Follow semver.
|
|
version = "2.0.0-alpha",
|
|
|
|
--- Table containing per-category version numbers. Incremented by one for any change that may break compatibility.
|
|
versions = {
|
|
--- Version number for languages and standard library changes.
|
|
language = 27,
|
|
--- Version number for save/AST format changes.
|
|
save = 4,
|
|
--- Version number for Lua API changes.
|
|
api = 8
|
|
},
|
|
|
|
--- Parse a `code` string and return the generated AST.
|
|
--
|
|
-- `source` is an optional string; it will be used as the code source name in error messages.
|
|
--
|
|
-- Usage:
|
|
-- ```lua
|
|
-- local ast = anselme.parse("1 + 2", "test")
|
|
-- ast:eval()
|
|
-- ```
|
|
parse = function(code, source)
|
|
return parser(code, source)
|
|
end,
|
|
--- Return a new [State](#state).
|
|
new = function()
|
|
return State:new()
|
|
end,
|
|
}
|