Add the dofile API function #23

docs/api/nfnl/api.md

@@ -3,6 +3,7 @@
 **Table of contents**
 
 - [`compile-all-files`](#compile-all-files)
+- [`dofile`](#dofile)
 
 ## `compile-all-files`
 Function signature:
@@ -15,6 +16,15 @@ Compiles all files in the given dir (optional), defaulting to the current workin
 
   Will do nothing if you execute it on a directory that doesn't contain an nfnl configuration file.
 
+## `dofile`
+Function signature:
+
+```
+(dofile file)
+```
+
+Just like :luafile, takes a Fennel file path (optional, defaults to current open file) and executes it from disk. However! This doesn't compile the Fennel! It maps the Fennel path to the matching Lua file already in your file system and executes that with Lua's built in dofile. So you need to have already written your .fnl and had nfnl compile that to a .lua for this to work, it's just a convinience function for you to call directly or through the :nfnlfile command.
+
 
 <!-- Generated with Fenneldoc v1.0.1
      https://gitlab.com/andreyorst/fenneldoc -->

fnl/nfnl/api.fnl

@@ -1,8 +1,11 @@
 (local {: autoload} (require :nfnl.module))
 (local compile (autoload :nfnl.compile))
 (local config (autoload :nfnl.config))
+(local fs (autoload :nfnl.fs))
 
-(fn compile-all-files [dir]
+(local mod {})
+
+(fn mod.compile-all-files [dir]
   "Compiles all files in the given dir (optional), defaulting to the current working directory. Returns a sequential table with each of the files compilation result.
 
   Will do nothing if you execute it on a directory that doesn't contain an nfnl configuration file."
@@ -11,4 +14,8 @@
     (when config
       (compile.all-files {: root-dir : cfg}))))
 
-{: compile-all-files}
+(fn mod.dofile [file]
+  "Just like :luafile, takes a Fennel file path (optional, defaults to current open file) and executes it from disk. However! This doesn't compile the Fennel! It maps the Fennel path to the matching Lua file already in your file system and executes that with Lua's built in dofile. So you need to have already written your .fnl and had nfnl compile that to a .lua for this to work, it's just a convinience function for you to call directly or through the :nfnlfile command."
+  (dofile (fs.fnl-path->lua-path (vim.fn.expand (or file "%")))))
+
+mod