uni-cli 0.0.12

Command-line REPL and interpreter for the Uni programming language
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# uni-cli

![Version](https://img.shields.io/badge/version-0.0.12-blue)
![License](https://img.shields.io/badge/license-MIT%20OR%20Unlicense-green)

Command-line REPL and interpreter for the Uni programming language - a homoiconic stack-based language that unifies code and data.

## Installation

```bash
cargo install uni-cli
```

This installs the `uni` command-line tool.

## Usage

### Interactive REPL

```bash
uni
```

```
 _   _       _
| | | |_ __ (_)
| | | | '_ \| |
| |_| | | | | |
 \___/|_| |_|_| v0.0.12

Type 'quit' or press Ctrl-D to exit
uni> 5 3 +
 => 8 : int32
uni> 'square [dup *] def
uni> 7 square
 => 49 : int32
```

### Execute Code

```bash
# Execute and print result
uni -e "5 3 +"
# Output: 8

# Execute code without printing
uni -c "5 3 + ."
# Output: 8
```

### Run a File

```bash
uni script.uni
```

## Language Quick Reference

### Basic Arithmetic
```
5 3 +        # Addition: 8
10 4 -       # Subtraction: 6
7 6 *        # Multiplication: 42
20 4 /       # Division: 5
```

### Stack Operations
```
dup          # Duplicate top item
swap         # Swap top two items
drop         # Remove top item
```

### Lists
```
[1 2 3]           # Create list
[1 2 3] head      # Get first element: 1
[1 2 3] tail      # Get rest: [2 3]
[1 2 3] length    # Length: 3
```

### Functions
```
'square [dup *] def    # Define function
5 square               # Use it: 25
```

### Control Flow
```
5 0 > [true] [false] if    # Conditional
```

## Embedded Targets

The CLI can also be built for embedded systems:

- **micro:bit v2** - Interactive REPL over USB serial (ARM Cortex-M4)
- **Raspberry Pi Pico** - Full interpreter on ARM Cortex-M0+ with USB CDC
- **Raspberry Pi Pico 2** - Enhanced with RP2350 dual-core @ 150MHz
- **STM32H753ZI** - Async REPL using Embassy runtime (ARM Cortex-M7 @ 480MHz)

For embedded builds and more documentation, see the main repository:

**GitHub:** https://github.com/edadma/uni

## Library Usage

To embed Uni in your own application, use the `uni-core` library crate:

```toml
[dependencies]
uni-core = "0.0.12"
```

See the `uni-core` crate documentation for API details.

## License

Dual-licensed under MIT OR Unlicense.