# 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.