Checking the installation
oxl --version # oxl 1.0.0-beta (edition 2027)
oxl helpThe first program#
mkdir -p /tmp/oxl-smoke && cd /tmp/oxl-smoke
cat > hello.oxl <<'EOF'
fn main() io { print("Привет, OxL!") }
EOF
oxl run hello.oxl
oxl fmt --check hello.oxlIf oxl run prints linking failed, the system libraries or the linker are missing. If it prints
standard library not found, set OXL_STD_DIR to the lib/oxl/std directory of the installation.
A package, tests and a cluster#
oxl new smoke && cd smoke
oxl test # 1 passed
oxl dev --nodes 3In the oxl dev table every node must reach the state up and the VIEW column must show 3/3 (all nodes see each other).
Examples from the archive: oxl test /opt/oxl-1.0.0-beta/share/oxl/examples/bank-saga (copy the project to a writable directory:
oxl creates oxl.schema.lock and .oxl/ in the project).
Editor and debugger#
oxl lspanswers aninitializerequest: details and a check in LSP clients.oxl dap --helpfindslldb-dap; otherwise installlldb-18or setOXL_LLDB_DAP.oxl doc --std --json | headprints the documentation of the standard library, which shows thatstdis found.
Troubleshooting#
| Symptom | Cause and fix |
|---|---|
oxl: command not found | PATH does not contain <installation>/bin |
linking failed: cannot find -luring (or another -l…) | the -dev package of the library is missing, see the requirements |
linking failed without details, clang++: not found | no clang: install clang-18 and export OXL_LINKER=clang++-18 |
standard library not found / runtime library not found | a moved installation: OXL_STD_DIR, OXL_RUNTIME_LIB |
cannot start the cluster member: … no credentials | a cluster program run outside oxl dev: set OXL_CLUSTER_CERT/KEY/CA or use oxl dev |