arti/tests/shadow
Jim Newsome 7014697d0b shadow ci: avoid hard coding tgen and tor bin paths
As of shadow 2.3, shadow can locate executables from the PATH, letting
us avoid hard-coded paths here.
2022-12-19 13:29:05 -06:00
..
conf add vanila bridge to shadow sim 2022-11-30 18:40:20 +01:00
shadow.data.template/hosts add vanila bridge to shadow sim 2022-11-30 18:40:20 +01:00
README.md shadow ci: avoid hard coding tgen and tor bin paths 2022-12-19 13:29:05 -06:00
run.sh Fix typo 2022-12-12 21:36:57 +02:00
shadow.yaml shadow ci: avoid hard coding tgen and tor bin paths 2022-12-19 13:29:05 -06:00

README.md

Shadow-based integration test

This is an integration test for arti that uses the shadow simulator. It creates a simulation of a small Tor network, uses the arti client to perform some transfers across this simulated network, and validates that the transfers succeeded.

Running locally

To run locally, you'll need to install shadow itself somewhere on our PATH, following shadow's installation instructions.

Next you'll need to install executables that will run inside the simulation, in the locations where shadow.yaml expects to find them.

  • Ensure tgen is on your PATH.

  • Ensure tor is on your PATH. Typically you can install it using your host system's package manager.

  • Build the arti client for target x86_64-unknown-linux-gnu, so that the binary is at: ../../target/x86_64-unknown-linux-gnu/debug/arti.

Once those are installed, you can invoke the run.sh script from this directory.