lumbda/examples/portal-http-client.lsp
russell@unturf.com 06b93c588a portal over HTTP: 9/9 cross-runtime, plus eval-to-global-env fix
Closes the last loop promised in the whitepaper's Future Work: a
node serves its state as an S-expression portal over HTTP, another
node pulls it down with tcp-connect + tcp-recv and materializes the
bindings locally via (eval (read-from-string line)).

examples/portal-http-server.lsp (90 lines):
- Holds some state (counter, my-int, my-list, my-fib, my-str)
- GET /portal → S-expression body: a sequence of (define ...) forms
- GET / → HTML index
- Uses heap-snapshot / heap-restore for O(1) memory on asm

examples/portal-http-client.lsp (90 lines):
- tcp-connect, send HTTP/1.0 GET, receive full response
- Strip headers (walk to first \r\n\r\n)
- Split body by \n, eval each non-empty, non-comment line
- The remote bindings are now live locally

3×3 server/client matrix: all 9 combinations green. Every runtime
hosts, every runtime consumes. The wire format is Scheme source;
no schema, no JSON, no Protobuf.

Prerequisite fix: `eval` semantics aligned across all three impls.

Python and C's `eval` special form previously evaluated its result
in the CALLER's env, so a nested (eval (read-from-string
"(define x 42)")) would install x in the local function scope —
invisible to later top-level code. asm's bi_eval always used the
global env (r14). With this commit, all three impls evaluate the
eval'd result in the global env, matching asm's existing behavior.

Python: uncommonlisp.py leval eval-handler now does `env = env.g`
before continuing the trampoline.
C: c/eval.c SYM_EVAL branch now does `env = env->global`.
asm: no change (already correct).

One pre-existing Python defect surfaced by the client:
`count` is a SRFI-1-style builtin (`d(S('count'), ...)`), so a
local let-loop variable named `count` collides with it in the
inline-cache lookup path and OP_LOOK_ADD1 fires on the builtin
instead of the local. Worked around by renaming the loop
accumulator to `cnt`. Underlying Env.lookup shortcut-to-global
issue is out of scope for this commit.

Regression: 975 tests still green.
2026-04-17 13:41:48 -04:00

99 lines
3.9 KiB
Text

;;; portal-http-client.lsp — fetch an S-expression portal over HTTP,
;;; evaluate each form to materialize the bindings locally.
;;;
;;; This is the concrete demo of "portal over HTTP" from the whitepaper:
;;; one machine serves its state, another pulls it down and resumes.
;;; Because the portal format is Scheme source, the client is a few
;;; lines of string-munging plus (read-from-string) + (eval).
;;;
;;; Usage (server must be running first — see portal-http-server.lsp):
;;; python3 uncommonlisp.py --fast examples/portal-http-client.lsp
;;; ./c/uncommonlisp examples/portal-http-client.lsp
;;; ./asm/uncommonlisp < examples/portal-http-client.lsp
(define *host* "127.0.0.1")
(define *port* 9085)
(define *request* "GET /portal HTTP/1.0\r\nHost: 127.0.0.1\r\nConnection: close\r\n\r\n")
;;; ── Strip HTTP headers: body starts after the first "\r\n\r\n". ──
;;; Portable implementation — walks bytes, tracks a 4-state matcher.
(define (find-crlfcrlf s)
(let ((len (string-length s)))
(let loop ((i 0))
(if (> (+ i 4) len)
-1
(if (and (= (char->integer (string-ref s i)) 13)
(= (char->integer (string-ref s (+ i 1))) 10)
(= (char->integer (string-ref s (+ i 2))) 13)
(= (char->integer (string-ref s (+ i 3))) 10))
(+ i 4)
(loop (+ i 1)))))))
(define (body-of resp)
(let ((start (find-crlfcrlf resp)))
(if (< start 0)
""
(substring resp start (string-length resp)))))
;;; ── Fetch and evaluate ──────────────────────────────────────
;;;
;;; Read up to 64 KB of response in one tcp-recv. For a small
;;; portal body this is always one packet on localhost.
;;;
;;; Then split the body by line, read+eval each non-empty,
;;; non-comment line. Top-level define forms land in the global env.
(define (first-n-chars s n)
(if (> (string-length s) n) (substring s 0 n) s))
(define (fetch-portal)
(let ((sock (tcp-connect *host* *port*)))
(if sock
(begin
(tcp-send sock *request*)
(let ((resp (tcp-recv sock 65536)))
(tcp-close sock)
(body-of resp)))
"")))
(define (line-at s start)
;; Extract line starting at index `start` (exclusive of \n).
;; Returns the substring up to the next \n (or end).
(let ((len (string-length s)))
(let loop ((i start))
(cond
((= i len) (substring s start len))
((= (char->integer (string-ref s i)) 10) (substring s start i))
(else (loop (+ i 1)))))))
(define (eval-all-lines s)
(let ((len (string-length s)))
(let loop ((i 0) (cnt 0))
(if (>= i len) cnt
(let ((line (line-at s i)))
(let ((next (+ i (string-length line) 1)))
(cond
((= (string-length line) 0)
(loop next cnt))
((= (char->integer (string-ref line 0)) 59) ; ; = comment
(loop next cnt))
(else
(eval (read-from-string line))
(loop next (+ cnt 1))))))))))
;;; ── Go ──────────────────────────────────────────────────────
(define portal-body (fetch-portal))
(display "fetched ") (display (string-length portal-body)) (display " bytes") (newline)
(display "first line: ") (display (line-at portal-body 0)) (newline)
(define evaluated (eval-all-lines portal-body))
(display "evaluated ") (display evaluated) (display " forms") (newline)
;; Now the remote bindings are live locally. Use them:
(display "counter = ") (display counter) (newline)
(display "my-int = ") (display my-int) (newline)
(display "my-fib = ") (display my-fib) (newline)
(display "my-list has ") (display (length my-list)) (display " items") (newline)
(display "my-str = ") (display my-str) (newline)