yooxn

Python tools for the Uxn ecosystem.

yooxnas

yooxnas is a fast, multi-pass assembler for the uxntal language, written in pure Python.

Features

• Multi-pass architecture: Ensures reliable label resolution and address calculation.
• Macro support: Full support for uxntal macros, including nested definitions.
• Sub-label scoping: Standard @parent and &child scoping rules.
• Include system: Assemble complex projects with multiple source files using ~include.
• Pure Python: No external dependencies for the assembler itself.

Installation

You can install yooxn via pip:

pip install yooxn

Or using uv:

uv add yooxn

Usage

After installation, the yooxnas command will be available:

yooxnas file.tal

By default, it produces output.rom. You can specify the output path with -o:

yooxnas -o project.rom main.tal

You can also run it as a Python module:

python -m yooxn main.tal

Or directly with uv run:

uv run yooxnas file.tal

CLI Options

usage: yooxnas [-h] [-o OUTPUT] [--debug] file

positional arguments:
  file                 tal file to assemble

options:
  -h, --help           show this help message and exit
  -o, --output OUTPUT  Output file to write
  --debug              Set loglevel to DEBUG

Development

yooxn uses uv for dependency management and hatchling as the build backend.

To install in editable mode:

pip install -e .

To run tests:

pytest

Using uv:

uv run pytest