.\" pythonall(1) — comprehensive all-in-one man page for pythonrs.
.\" Modeled after zshall(1): every section of the reference in one document.
.\" Render with: man -l man/pythonall.1
.\" Install: cp man/pythonall.1 /usr/local/share/man/man1/
.TH PYTHONALL 1 "2026-11-10" "pythonrs 0.1.15" "User Commands"
.SH NAME
pythonall \- the pythonrs comprehensive reference (invocation, language,
architecture, bytecode VM + Cranelift JIT, LSP, DAP, inline-Rust FFI)
.SH OVERVIEW
This is the all\-in\-one
.B pythonrs
manual, modeled on
.BR zshall (1).
It concatenates the major sections of the pythonrs reference into a single page so
you can grep with `/`:
.RS 2
.PP
.B 1. INVOCATION
.RB "\(em " "flags, files, exit status"
.br
.B 2. LANGUAGE
.RB "\(em " "the Python the runtime parses and runs"
.br
.B 3. ARCHITECTURE
.RB "\(em " "lex \[->] parse \[->] lower \[->] fusevm VM + JIT + rkyv cache"
.br
.B 4. TOOLING
.RB "\(em " "\-\-lsp, \-\-dap, inline-Rust FFI, AOT, dumps"
.br
.B 5. DIAGNOSTICS
.RB "\(em " "error format and common messages"
.RE
.SH 1. INVOCATION
.B python
[\fIOPTIONS\fR] \fIFILE\fR [\fIARGS\fR...] runs a Python script.
.B \-c \fISRC\fR
executes a one\-liner, and
.B \-m \fIMODULE\fR
runs a library module as a script.
.B \-\-lsp
and
.B \-\-dap
speak their protocols over stdio and take no file. See
.BR python (1)
for the per\-flag table.
.SH 2. LANGUAGE
pythonrs runs Python 3 as ordinary compiled bytecode. It lexes and parses the
source, lowers it to
.B fusevm
instructions, and lets the shared engine execute and JIT\-compile them. Arithmetic
and comparisons lower to native fusevm ops; Python\-specific behaviour \(em
truthiness, attribute and method dispatch,
.BR str / list
concatenation, bignum promotion, and object construction \(em is served by the
.B PyHost
object heap, whose
.BR str / list / dict / tuple / set
and instance cells ride through the VM as handles.
.SH 3. ARCHITECTURE
.EX
Python source \[->] lexer \[->] parser (AST) \[->] lower to fusevm bytecode \[->] fusevm VM + Cranelift JIT
.EE
.PP
There is no bespoke VM or JIT; execution and codegen live in fusevm, the shared
engine hosting other language frontends. Every script file run
transparently caches compiled bytecode in
.I ~/.pythonrs/scripts.rkyv
(an rkyv shard); a cache hit skips lex/parse/lower entirely. \fB\-c\fR and stdin
programs are not cached.
.SH 4. TOOLING
.SS Language server (\-\-lsp)
.B python \-\-lsp
speaks LSP over stdio: completion, hover, go\-to\-definition and signature help from the symbol corpus (the
same table that generates
.IR docs/reference.html )
and document scopes, and diagnostics from the runtime's own parser. It is read\-only; no output reaches
the terminal.
.SS Debugger (\-\-dap)
.B python \-\-dap
speaks the Debug Adapter Protocol over stdio: line breakpoints, single\-stepping,
a stack trace, and inspection of a frame's locals. Program output is captured and
forwarded as
.B output
events so it never corrupts the protocol channel.
.SS Inline-Rust FFI
A
.B rust { pub extern "C" fn \[u2026] }
block desugars to an internal
.BR __rust_compile ,
compiles to a cached
.B cdylib
on first run (via the shared
.B fusevm
FFI runtime), and its exports become callable by name from Python
.RB ( src/rust_ffi.rs ).
.SS Deployment and dumps
.B \-\-build
compiles the script to a standalone native executable next to the source and warms
the bytecode cache; it requires a build made with
.BR "\-\-no\-default\-features" .
.B \-\-dump\-tokens
prints the token stream,
.B \-\-dump\-ast
the parsed AST,
.B \-\-dump\-bytecode
the lowered fusevm chunk, and
.B \-\-disasm
a fusevm bytecode disassembly \(em each then exits.
.B \-\-tiers
runs the script first, then reports which fusevm execution tier took each of its
chunks.
.SS REPL and diagnostics
.B \-\-repl
starts the interactive
.B reedline
REPL (also entered when no file is given on a TTY).
.B \-\-doctor
prints a diagnostic report \(em runtime, embedded CPython, vendored
.IR pylib/ ,
fusevm engine, bytecode cache,
.B PYTHON*
environment, and every
.B python*
interpreter on
.B PATH.
.B \-\-cacheview
lists the compiled programs held in the rkyv cache, and
.B \-\-cache\-clear
deletes the shard \(em each then exits.
.SH 5. DIAGNOSTICS
Errors are written to standard error in Python's own exception form. The process
exits non\-zero on an unhandled exception and 0 on success.
.SH SEE ALSO
.BR python (1)
The focused invocation page. Source and issue tracker:
https://github.com/MenkeTechnologies/pythonrs
.SH AUTHOR
Part of the fusevm language family.