2022-08-15 21:58:48 +03:00
|
|
|
# add.run
|
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
## Basic usage
|
|
|
|
|
2022-08-15 21:58:48 +03:00
|
|
|
```ucm:hide
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> builtins.merge
|
2022-08-15 21:58:48 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
```unison
|
|
|
|
even : Nat -> Boolean
|
|
|
|
even x = if x == 0 then true else odd (drop x 1)
|
|
|
|
|
|
|
|
odd : Nat -> Boolean
|
|
|
|
odd x = if x == 0 then false else even (drop x 1)
|
|
|
|
|
|
|
|
is2even : 'Boolean
|
|
|
|
is2even = '(even 2)
|
|
|
|
```
|
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
it errors if there isn't a previous run
|
|
|
|
|
2022-08-15 21:58:48 +03:00
|
|
|
```ucm:error
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> add.run foo
|
2022-08-15 21:58:48 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> run is2even
|
2022-08-15 21:58:48 +03:00
|
|
|
```
|
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
it errors if the desired result name conflicts with a name in the
|
|
|
|
unison file
|
2022-08-15 21:58:48 +03:00
|
|
|
```ucm:error
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> add.run is2even
|
2022-08-15 21:58:48 +03:00
|
|
|
```
|
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
otherwise, the result is successfully persisted
|
2022-08-15 21:58:48 +03:00
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> add.run foo.bar.baz
|
2022-08-15 21:58:48 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> view foo.bar.baz
|
2022-08-15 21:58:48 +03:00
|
|
|
```
|
2022-08-15 22:46:55 +03:00
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
## It resolves references within the unison file
|
|
|
|
|
|
|
|
```unison
|
|
|
|
z b = b Nat.+ 12
|
|
|
|
y a b = a Nat.+ b Nat.+ z 10
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
main : '{IO, Exception} (Nat -> Nat -> Nat)
|
|
|
|
main _ = y
|
|
|
|
```
|
|
|
|
|
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> run main
|
|
|
|
scratch/main> add.run result
|
2022-08-17 23:50:15 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
## It resolves references within the codebase
|
2022-08-15 22:46:55 +03:00
|
|
|
|
|
|
|
```unison
|
2022-08-17 23:50:15 +03:00
|
|
|
inc : Nat -> Nat
|
|
|
|
inc x = x + 1
|
|
|
|
```
|
2022-08-15 22:46:55 +03:00
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> add inc
|
2022-08-17 23:50:15 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
```unison
|
|
|
|
main : '(Nat -> Nat)
|
|
|
|
main _ x = inc x
|
2022-08-15 22:46:55 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> run main
|
|
|
|
scratch/main> add.run natfoo
|
|
|
|
scratch/main> view natfoo
|
2022-08-15 22:46:55 +03:00
|
|
|
```
|
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
## It captures scratch file dependencies at run time
|
|
|
|
|
|
|
|
```unison
|
|
|
|
x = 1
|
|
|
|
y = x + x
|
|
|
|
main = 'y
|
|
|
|
```
|
|
|
|
|
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> run main
|
2022-08-17 23:50:15 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
|
2022-08-15 22:46:55 +03:00
|
|
|
```unison
|
2022-08-17 23:50:15 +03:00
|
|
|
x = 50
|
2022-08-15 22:46:55 +03:00
|
|
|
```
|
|
|
|
|
2022-08-17 23:50:15 +03:00
|
|
|
this saves 2 to xres, rather than 100
|
2022-08-15 22:46:55 +03:00
|
|
|
```ucm
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> add.run xres
|
|
|
|
scratch/main> view xres
|
2022-08-15 22:46:55 +03:00
|
|
|
```
|
2022-08-22 17:44:58 +03:00
|
|
|
|
|
|
|
## It fails with a message if add cannot complete cleanly
|
|
|
|
|
|
|
|
```unison
|
|
|
|
main = '5
|
|
|
|
```
|
|
|
|
|
|
|
|
```ucm:error
|
2024-06-12 01:22:09 +03:00
|
|
|
scratch/main> run main
|
|
|
|
scratch/main> add.run xres
|
2022-08-22 17:44:58 +03:00
|
|
|
```
|
2022-08-22 18:26:40 +03:00
|
|
|
|
|
|
|
## It works with absolute names
|
|
|
|
|
|
|
|
```unison
|
|
|
|
main = '5
|
|
|
|
```
|
|
|
|
|
|
|
|
```ucm
|
2024-07-01 23:27:40 +03:00
|
|
|
scratch/main> run main
|
|
|
|
scratch/main> add.run .an.absolute.name
|
|
|
|
scratch/main> view .an.absolute.name
|
2022-08-22 18:26:40 +03:00
|
|
|
```
|