Port to lua (#31)

* Bump nrepl-python-client

* Major overhaul

This is still experimental, but simplifies handling so commands and handlers are
implemented in lua instead of python

* Proceed with lua hardwork

* Implement some handlers in lua + better internal mechanisms

* Allow a command to be supplied

* Several corrections

* Implement require feature

* Enhancements to connections/nrepl

* Add back require autocmd

* Refactor handlers into middlewares

So they can be composed better

* Avoid connection errors

* Allow clearing virtualtexts

* Don't log 'changed-namespaces'

* Fix getcwd

* Add frontend functions

* Make frontend fns available

* Rename all files in sequence

* Use line number instead of line index

* Expose more features throguh viml functions/commands

* Add configuration mechanism

Now features and middlewares are indirectly bound throught configration.

This also allows tight control over the behavior of individual middlewares, middleware composition and a lot of good stuff.

* Don't expose 'extract' function

* Rename var

* Add import, add-require and sort-requires commands

* Allow refactoring and other stuff

* Improvements to virtualtext

* Bump nrepl middlewares

* Allow more options on built command

* Use string.sub instead of str:sub

This makes easier to spot when a non-string argument is supplied

* Allow python counterpart to make use of lua connection state

* Fix migration to obj

* Saving state

* General improvments

* Better ns handling

* Remove config and make middlewares simpler

* Add eval function that insert the result into the buffer

* Tweak path finding

* Add docs

* Add go to definition

* Add doc generation

* Cleanup on python side

Also, expose a couple of old commands as revamped functions

* Update docs

* Cleanup and fixes on the provided functions

* Change do_require so the API is kept

* Document features

* Update README.md

Author: hkupty

.gitmodules

@@ -1,6 +1,3 @@
 [submodule "deps/nrepl-python-client"]
 	path = deps/nrepl-python-client
 	url = https://github.com/clojure-vim/nrepl-python-client.git
-[submodule "deps/zen.nvim"]
-	path = deps/zen.nvim
-	url = https://github.com/hkupty/zen.nvim

API.md

@@ -0,0 +1,256 @@
+# acid.connections
+low-level connection handler
+
+## `add(this, addr)`
+Stores connection for reuse later
+
+this **(table)**: Connections object.
+
+addr **({string,string})**: Address tuple with ip and port.
+
+
+## `select(this, pwd, ix)`
+Elects selected connection as primary (thus default) for a certain address
+
+this **(table)**: Connections object.
+
+pwd **(string)**: path (usually project root).
+ Assumed to be neovim's `pwd`.
+
+ix **(int)**: index of the stored connection
+
+
+## `unselect(this, pwd)`
+Dissociates the connection for the given path
+
+this **(table)**: Connections object.
+
+pwd **(string)**: path (usually project root).
+
+
+## `get(this, pwd)`
+Return active connection for the given path
+
+this **(table)**: Connections object.
+
+pwd **(string)**: path (usually project root).
+
+
+**({string,string})** Connection tuple with ip and port.
+
+
+---
+
+# acid.core
+low-level connection handler.
+
+## `send([conn], obj, handler)`
+Forward messages to the nrepl and registers the handler.
+
+*conn* **({string,string})**: Ip and Port tuple. Will try to get one if nil.
+
+obj **(table)**: Payload to be sent to the nrepl.
+
+handler **(function)**: Handler function to deal with the response.
+
+
+---
+
+# acid.features
+User-facing features and runnable commands
+
+## `eval_cmdline(code[, ns])`
+Evaluate the given code and insert the result at the cursor position
+
+code **(string)**: Clojure s-expression to be evaluated on the nrepl
+
+*ns* **(string)**: Namespace to be used when evaluating the code.
+ Defaults to current file's ns.
+
+
+## `eval_expr([mode[, ns]])`
+Evaluate the current form or the given motion.
+
+*mode* **(string)**: motion mode
+
+*ns* **(string)**: Namespace to be used when evaluating the code.
+ Defaults to current file's ns.
+
+
+## `do_require([ns[, ...]])`
+Sends a `(require '[...])` function to the nrepl.
+
+*ns* **(string)**: Namespace to be used when evaluating the code.
+ Defaults to current file's ns.
+
+*...*: extra arguments to the require function
+
+
+## `do_import(java_ns, symbols)`
+Sends a `(import '[...])` function to the nrepl.
+
+java_ns **(string)**: Namespace of the java symbols that are being imported.
+
+symbols **({string,...})**: List of java symbols to be imported
+
+
+## `go_to([symbol[, ns]])`
+Navigates the the definition of the given symbol.
+
+*symbol* **(string)**: Symbol to navigate to. Defaults to symbol under
+ cursor.
+
+*ns* **(string)**: Namespace to be used when evaluating the code.
+ Defaults to current file's ns.
+
+
+## `docs([symbol[, ns]])`
+Shows the docstring of the given symbol.
+
+*symbol* **(string)**: Symbol which docs will be shown. Defaults to symbol under cursor.
+
+*ns* **(string)**: Namespace to be used when evaluating the code.
+ Defaults to current file's ns.
+
+
+## `preload()`
+Inject some clojure files into the nrepl sesion.
+
+
+## `load_all_nss()`
+Load all namespaces in the current session.
+
+
+## `add_require(req)`
+Refactor the current file to include the given argument in the
+`(:requires ...)` section.
+
+req **(string)**: require vector, such as `[clojure.string :as str]`.
+
+
+## `remove_require(req)`
+Refactor the current file to remove the given argument from the
+`(:requires ...)` section.
+
+req **(string)**: require namespace, such as `clojure.string`.
+
+
+## `sort_requires()`
+Refactor the current file so the `(:require ...)` form is sorted.
+
+
+---
+
+# acid.forms
+Forms extraction
+
+## `get_form_boundaries()`
+Returns the coordinates for the boundaries of the current form
+
+
+**(table)** coordinates {from = {row,col}, to = {row,col}}
+
+
+## `form_under_cursor()`
+Extracts the innermost form under the cursor
+
+
+**(string)** symbol under cursor
+
+**(table)** coordinates {from = {row,col}, to = {row,col}}
+
+
+## `symbol_under_cursor()`
+Extracts the symbol under the cursor
+
+
+**(string)** symbol under cursor
+
+**(table)** coordinates {from = {row,col}, to = {row,col}}
+
+
+---
+
+# acid
+Frontend module with most relevant functions
+
+## `connected([pwd])`
+Checks whether a connection exists for supplied path or not.
+
+*pwd* **(string)**: Path bound to connection.
+ Will call `getcwd` on neovim if not supplied
+
+
+**(boolean)** Whether a connection exists or not.
+
+
+## `run(cmd, conn)`
+Façade to core.send
+
+cmd: A command (op + payload + handler) to be executed.
+
+conn: A connection where this command will be run.
+
+
+## `callback(session, ret)`
+Callback proxy for handling command responses
+
+session: Session ID for matching response with request
+
+ret: The response from nrepl
+
+
+---
+
+# acid.nrepl
+nRepl connectivity
+
+## `middlewares`
+List of supported middlewares and the wrappers to invoke when spawning a nrepl process.
+
+Values:
+
+* `[nrepl/nrepl]`
+
+## `default_middlewares`
+Default middlewares that will be used by the nrepl server
+
+Values:
+
+* `nrepl/nrepl`
+* `cider/cider-nrepl`
+* `refactor-nrepl`
+
+## `start(obj)`
+Starts a tools.deps nrepl server
+
+obj **(table)**: Configuration for the nrepl process to be spawn
+
+Parameters for table `obj` are:
+
+* obj.pwd **(string)**: Path where the nrepl process will be started
+* *obj.middlewares* **(table)**: List of middlewares.
+* *obj.alias* **(string)**: alias on the local deps.edn
+* *obj.connect* **(string)**: -c parameter for the nrepl process
+* *obj.bind* **(string)**: -b parameter for the nrepl process
+
+**(boolean)** Whether it was possible to spawn a nrepl process
+
+
+## `stop(obj)`
+Stops a nrepl process managed by acid
+
+obj **(table)**: Configuration for the nrepl process to be stopped
+
+Parameters for table `obj` are:
+
+* obj.pwd **(string)**: Path where the nrepl process was started
+
+## `show([ch])`
+Debugs nrepl connection by returning the captured output
+
+*ch* **(int)**: Neovim's job id of given nrepl process. When not supplied return all.
+
+
+**(table)** table with the captured outputs for given (or all) nrepl process(es).
+