pyuiua 0.0.4

Python bindings for the Uiua programming language.

PyUiua

A Python binding for Uiua, allowing interaction between Uiua and Python.

Requirements

• Python 3.10 or higher

Installation

pip install pyuiua

or see dev setup below for building from source

Example Usage

Basic Usage

import pyuiua

# Create a Uiua instance
uiua = pyuiua.Uiua()

# Basic evaluation - run code and pop result
uiua.run("/×⇡₁10") # Calculate 10 factorial
print(uiua.pop())  # 3628800

# Push Python values onto the stack
uiua.push(10)
uiua.push(20)
uiua.run("+") # Then run a Uiua operation
print(uiua.pop())  # 30

# Work with arrays
uiua.push([1, 2, 3, 4, 5])
uiua.run("/+")  # Sum the array
print(uiua.pop())  # 15

# Inspect the stack without modifying it
uiua.push(1)
uiua.push(2)
uiua.push(3)
print(uiua.stack())  # [1, 2, 3]
print(len(uiua))     # 3

# Clear the stack
uiua.clear()

API Reference

Uiua() - Create a Uiua instance

• uiua.push(value) - Push a Python value onto the stack
• uiua.pop() - Pop a value from the stack and return it as a python object
• uiua.run(code) - Execute Uiua code on the current stack
• uiua.stack() - Inspect the stack without modifying it
• uiua.clear() - Remove all values from the stack
• len(uiua) - Get the number of values on the stack

Type Conversions

The conversion of types is currently lossy. Both arrays and boxes convert to lists in Python, and Python lists convert to an array if they're homogeneous with a well-defined shape, otherwise a box. As a result, a box in Uiua of homogeneous values will become an array when converted to python and back.

• Currently supports: most scalars, multidimensional arrays, and boxed arrays
• Does not yet support: complex numbers, maps, functions, or user-defined types

Uiua → Python

Uiua Type	Python Type
Scalar number	int or float
Scalar char	str
Scalar byte	int
1D Array	list
Multi-dimensional Array	Nested list
Box Array (heterogeneous)	list

Python → Uiua

Python Type	Uiua Type
int	Scalar number
float	Scalar number
str	Character array/string
list (homogeneous)	Array
list (heterogeneous)	Box Array

Development

Requirements

• rustup (Rust installer)
• uv (Python package manager)

Set-up

# Clone
git clone https://github.com/KatieLG/python-uiua.git
cd python-uiua

# Install dependencies
uv sync

# Build and install
uv run maturin develop

Dev Commands

Command	Purpose
make dev	Rebuild after making changes to Rust code
make test	Run unit tests
make lint	Run linters and type checkers
make format	Auto-format code
make check	Format, lint, and test
make build	Build wheel for distribution
make test-release	Publish to TestPyPI
make release	Publish to PyPI

Links

• Uiua Language
• PyO3 Documentation
• Maturin Documentation