cairo-args-runner 2.0.0

Cairo Args Runner is a utility designed to execute Cairo programs with arguments directly from the command line.
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
48
49
50
51
52
53
54
55
56
57
58
59

# Cairo Args Runner

## Overview

**Cairo Args Runner** is a streamlined utility for executing Cairo 1 programs with command-line arguments.
It enhances the user experience by enabling direct argument specification in the command line,
thus simplifying the execution of Cairo programs.

## How to Use

### Basic Usage

To use **Cairo Args Runner**, you need to:

1. Navigate to the target directory of your Cairo program.
2. Build the program using `scarb build`.
3. Run the program with the desired arguments.

## Crate Installation via Cargo

You can also install this crate directly using the `cargo install` command.
To do this, run the following command in your terminal:

```bash
cargo install cairo-args-runner
```

### Example

Run a `main` function from the `complex` package located in `examples/complex`,
passing `[[1, 2, 4, 8, 16], [1, 2, 3, 4, 5, 6]]` as the argument:

```bash
echo "[[1, 2, 4, 8, 16], [1, 2, 3, 4, 5, 6]]" | cargo run --release -- target/dev/complex.sierra.json
```

## Additional Examples

Here are more examples for running different Cairo programs:

### Fibonacci Sequence Example

```bash
echo "[10]" | cargo run --release -- target/dev/fib.sierra.json
```

### Structs Example

```bash
echo "[1, 2, 10, 5, 9, [1, 2, 3]]" | cargo run --release -- target/dev/structs.sierra.json
```

### Summation Example

```bash
echo "[[1, 3, 9, 27]]" | cargo run --release -- target/dev/sum.sierra.json
```

These examples demonstrate the versatility and ease of using **Cairo Args Runner** for different types of Cairo 1 programs.