arxlang-jupyter-kernel
arxlang-jupyter-kernel is a wrapper-style Jupyter kernel for ArxLang. Each
cell is compiled with the Arx CLI, executed as a native binary, and its
stdout/stderr is returned to Jupyter.
This first version does not require any changes inside the Arx compiler codebase.
Requirements
- Python 3.10+
- Poetry
arxCLI available onPATH(or setARX_BIN)- Jupyter Notebook/Lab or Quarto with Jupyter support
Install
poetry install
Register the kernel:
poetry run python -m arxlang_jupyter_kernel.install --user
Validate installation:
jupyter kernelspec list
You should see an arx kernelspec with display name ArxLang.
Execution model
- Each cell is compiled and run in a temporary build directory.
- The kernel keeps a session prelude with all previously successful cells.
- New cells compile as:
session prelude + current cell. - Compilation errors are returned as Jupyter error messages.
- Failed compilations do not update session source.
Quarto usage
Use the arx kernel id in document front matter:
---
title: "Arx Notebook"
jupyter: arx
---
Environment variables
ARX_BINDefault:arxPath/executable for Arx CLI.ARX_COMPILE_ARGSDefault: empty Extra compile args, parsed shell-style.ARX_RUN_ARGSDefault: empty Extra runtime args, parsed shell-style.ARX_KERNEL_KEEP_BUILDDefault:0Set to1to keep temporary build directories for debugging.ARX_KERNEL_SESSION_FILEDefault: unset Optional file path for persisting successful session source.
CLI command assumption and TODO
Current compile command guess is:
arx build <source> -o <binary> [ARX_COMPILE_ARGS...]
Runtime command is:
<binary> [ARX_RUN_ARGS...]
If the final Arx CLI differs, update src/arxlang_jupyter_kernel/compile_run.py
in build_compile_command().
Troubleshooting
ArxCompileErrorwith "No such file or directory: 'arx'" Ensure Arx CLI is installed or setARX_BIN=/full/path/to/arx.- Compiles fail due to CLI mismatch Adjust
build_compile_command()to the finalized Arx CLI syntax. - Need compiler artifacts for debugging Set
ARX_KERNEL_KEEP_BUILD=1before launching Jupyter. - Kernel installed but not visible Re-run install and verify
jupyter kernelspec listoutput.
Metadata
Release files for arxlang-jupyter-kernel 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| arxlang_jupyter_kernel-0.1.2.tar.gz | 9.7 kB | Without provenance | Details for arxlang_jupyter_kernel-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| arxlang_jupyter_kernel-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for arxlang_jupyter_kernel-0.1.2-py3-none-any.whl |
Total release size: 21.3 kB
Release files / arxlang_jupyter_kernel-0.1.2.tar.gz
| Download URL | arxlang_jupyter_kernel-0.1.2.tar.gz |
|---|---|
| Size | 9.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9b1918e2ba418d90dc5a490b81b492c3ccb67d45bd8e1e03ed6cb93c3537cd8b
|
|
BLAKE2b-256 checksum How to use checksums |
cb4afbe8ce4a0d3e66cdfd7b2f1104c370fa0e649b7f7b78713347f400eb3e8e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.10.20 Linux/6.14.0-1017-azure
|
Release files / arxlang_jupyter_kernel-0.1.2-py3-none-any.whl
| Download URL | arxlang_jupyter_kernel-0.1.2-py3-none-any.whl |
|---|---|
| Size | 11.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
14f14b09c96727beef29d58ee20ee667d202027251bb1977a9259cb9e17c4299
|
|
BLAKE2b-256 checksum How to use checksums |
a8b656fc00b9cce4d74a7b216a17f0daa5ad4c9198ad112afab50760bd2429ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.2 CPython/3.10.20 Linux/6.14.0-1017-azure
|
Security for arxlang-jupyter-kernel 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.