#command-line-arguments #runner #smart-contracts #sierra #cairo #command-line-tool

bin+lib cairo-args-runner

Cairo Args Runner is a utility designed to execute Cairo programs with arguments directly from the command line

5 releases (stable)

2.0.1 Feb 22, 2024
1.0.1 Jan 25, 2024
1.0.0 Dec 30, 2023
0.1.1 Dec 23, 2023
0.1.0 Dec 23, 2023

#2245 in Magic Beans

Download history 1/week @ 2024-03-08 13/week @ 2024-03-29 6/week @ 2024-04-05

88 downloads per month

Custom license

51KB
303 lines

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.

Dependencies

~28–42MB
~623K SLoC