Add parse_file and run_file to Lua API

anselme/init.lua

@@ -73,11 +73,19 @@ local anselme = {
 	-- Usage:
 	-- ```lua
 	-- local ast = anselme.parse("1 + 2", "test")
-	-- ast:eval()
+	-- ast:eval(state)
 	-- ```
 	parse = function(code, source)
 		return parser(code, source)
 	end,
+	--- Same as `:parse`, but read the code from a file.
+	-- `source` will be set as the file path.
+	parse_file = function(path)
+		local f = assert(io.open(path, "r"))
+		local block = parser(f:read("a"), path)
+		f:close()
+		return block
+	end,
 	--- Return a new [State](#state).
 	new = function()
 		return State:new()

anselme/state/State.lua

@@ -41,6 +41,10 @@ State = class {
 
 	--- Load standard library.
 	-- You will probably want to call this on every State right after creation.
+	--
+	-- Optionally, you can specify `language` (string) to instead load a translated version of the standaring library. Available translations:
+	--
+	-- * `"frFR"`
 	load_stdlib = function(self, language)
 		local stdlib = require("anselme.stdlib")
 		if language then
@@ -173,7 +177,7 @@ State = class {
 	end,
 	--- Load a script in this branch. It will become the active script.
 	--
-	-- `code` is the code string or AST to run, `source` is the source name string to show in errors (optional).
+	-- `code` is the code string or AST to run. If `code` is a string, `source` is the source name string to show in errors (optional).
 	--
 	-- Note that this will only load the script; execution will only start by using the `:step` method. Will error if a script is already active in this State.
 	run = function(self, code, source)
@@ -185,6 +189,14 @@ State = class {
 			return "return", r
 		end)
 	end,
+	--- Same as `:run`, but read the code from a file.
+	-- `source` will be set as the file path.
+	run_file = function(self, path)
+		local f = assert(io.open(path, "r"))
+		local block = parser(f:read("a"), path)
+		f:close()
+		return self:run(block)
+	end,
 	--- When a script is active, will resume running it until the next event.
 	--
 	-- Will error if no script is active.