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:

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:

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

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

Structs Example

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

Summation Example

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.