cairo-lang-runner 2.16.0

Basic cairo runner.
Documentation 
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

# Compiling and running cairo files

```
cargo run --bin cairo-run -- --single-file /path/to/file.cairo
```

If we want to run code that is gas tested:

```
cargo run --bin cairo-run -- --single-file /path/to/file.cairo --available-gas 200
```

We currently only run the `main` function with no arguments besides implicits.

# Example

```
// Calculates fib...
fn main() -> u128 {
    fib(1_u128, 1_u128, 100_u128)
}

fn fib(a: u128, b: u128, n: u128) -> u128 {
    if n == 0 {
        a
    } else {
        fib(b, a + b, n - 1_u128)
    }
}
```

# Command-Line Options

- `--single-file` - Treat the path as a single file instead of a project directory.
- `--available-gas <amount>` - Set the amount of gas available for execution.
- `--print-full-memory` - Print the full memory state after execution.
- `--allow-warnings` - Allow the compilation to succeed even with warnings.
- `--run-profiler` - Run the profiler and display profiling information.

# Additional Information

- When compiling with --available-gas, if there are cycles in the code, calls to
  `withdraw_gas_all` will be automatically added.
- Functions with calls to `withdraw_gas_all` will not compile without `--available-gas` value.
- Functions without calls to `withdraw_gas_all` will not compile with `--available-gas` value.
- When running functions returning arrays `--print-full-memory` should probably be used,
  to actually see the values contained in the array.