Merge remote-tracking branch 'origin/main'

.github/workflows/python-package.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on: [push]
+
+jobs:
+
+  test:
+    runs-on: [self-hosted, linux]
+
+    steps:
+      - uses: actions/checkout@v1
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v1
+        with:
+          python-version: 3.11
+
+      - name: Install Poetry Action
+        uses: snok/install-poetry@v1.3.3
+   
+
+      - name: Cache Poetry virtualenv
+        uses: actions/cache@v1
+        id: cache
+        with:
+          path: ~/.virtualenvs
+          key: poetry-${{ hashFiles('**/poetry.lock') }}
+          restore-keys: |
+            poetry-${{ hashFiles('**/poetry.lock') }}
+            
+
+      - name: Install Dependencies
+        run: poetry install
+        if: steps.cache.outputs.cache-hit != 'true'
+
+      - name: Code Quality
+        run: poetry run black . --check
+
+      - name: Test with pytest
+        run: poetry run pytest --cov . -n 2

README.md

@@ -10,6 +10,14 @@ built at all (yet). Signals (i.e. Ctrl-C) need some work, so have
 another terminal handy to send a SIGTERM if things glitch
 out. 
 
+One of the main drivers of complexity in the implementation
+is that the only reliable way I found to read live from
+stdin/stdout (as opposed to line by line) _without blocking_
+required using quite a bit of `async ` code, while the
+RNS API is firmly synchronous. 
+
+Anyway, there's a lot of room for improvement.
+
 ## Quickstart
 
 Requires Python 3.10+ on Linux or Unix. WSL probably works. Cygwin might work, too.