update GH action to 3.13, basilisp test

.github/workflows/test.yml

@@ -11,21 +11,21 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "pypy-3.10"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "pypy-3.10"]
         include:
           - os: windows-latest
-            python-version: "3.12"
+            python-version: "3.13"
           - os: macos-latest
-            python-version: "3.12"
+            python-version: "3.13"
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-python@v4
       - name: Install dependencies
         run: |
           pip install -e ".[test]"
-      - name: Test with kernel tester
+      - name: Test
         run: |
-          python -m unittest -v
+          basilisp test
       - name: Check Kernel
         run: |
           cd $HOME

API.md

@@ -0,0 +1,57 @@
+# Table of contents
+-  [`basilisp-kernel.nrepl-server`](#basilisp-kernel.nrepl-server) 
+    -  [`server-shut`](#basilisp-kernel.nrepl-server/server-shut) - Convenience function to shutdown the <code>server</code>.
+    -  [`server-start`](#basilisp-kernel.nrepl-server/server-start) - Starts the nrepl-server in async mode according to <code>OPTS</code>, using a asyncio task to schedule any pending client work every 100ms.
+
+-----
+# <a name="basilisp-kernel.nrepl-server">basilisp-kernel.nrepl-server</a>
+
+
+
+
+
+
+## <a name="basilisp-kernel.nrepl-server/server-shut">`server-shut`</a><a name="basilisp-kernel.nrepl-server/server-shut"></a>
+``` clojure
+
+(server-shut server)
+```
+Function.
+
+Convenience function to shutdown the `server`.
+<p><sub><a href="https://github.com/ikappaki/basilisp-kernel/blob/master/basilisp_kernel/nrepl_server.lpy#L85-L88">Source</a></sub></p>
+
+## <a name="basilisp-kernel.nrepl-server/server-start">`server-start`</a><a name="basilisp-kernel.nrepl-server/server-start"></a>
+``` clojure
+
+(server-start {:keys [host port dir interval-sec], :as opts, :or {port 0, interval-sec 0.1}})
+```
+Function.
+
+Starts the nrepl-server in async mode according to `OPTS`, using a
+  asyncio task to schedule any pending client work every 100ms.
+
+  `OPTS` is a map that can have the following keys
+
+  `:dir` The directory where the `.nrepl-port` file should be created
+  at. It defaults to the current working directory if not given or
+  empty.
+
+  `:host` The interface address the server should be bound to. It
+  defaults to 127.0.0.1 if not given or empty.
+
+  `:port` The port number the server should listen to. It defaults to
+  0, which indicates a random available port number.
+
+  It return a map with the following keys
+
+  `:host` The host interface to which the server is bound.
+
+  `:nrepl-port-file` The path to the `.nrepl-port` file created by the
+  server.
+
+  `:port` The port on the host interface the server listens for client
+  connections.
+
+  `:shutdown!` A function to shutdown the server.
+<p><sub><a href="https://github.com/ikappaki/basilisp-kernel/blob/master/basilisp_kernel/nrepl_server.lpy#L25-L83">Source</a></sub></p>

bb.edn

@@ -0,0 +1,7 @@
+{:tasks
+ {quickdoc {:doc "Invoke quickdoc"
+            :extra-deps {io.github.borkdude/quickdoc {:git/sha "7e41f33d98e2ef697dd9ecdff8e84b779141c7a6"}}
+            :task (exec 'quickdoc.api/quickdoc)
+            :exec-args {:git/branch "master"
+                        :github/repo "https://github.com/ikappaki/basilisp-kernel"
+                        :source-paths ["basilisp_kernel/nrepl_server.lpy"]}}}}