ooni-probe-cli/internal/tutorial/experiment/torsf
Simone Basso bbcd2e2280
refactor(netx): merge archival, trace, and the savers (#772)
This diff creates a new package under netx called tracex that
contains everything we need to perform measurements using events
tracing and postprocessing (which is the technique with which
we implement most network experiments).

The general idea here is to (1) create a unique package out of
all of these packages; (2) clean up the code a bit (improve tests,
docs, apply more recent code patterns); (3) move the resulting
code as a toplevel package inside of internal.

Once this is done, netx can be further refactored to avoid
subpackages and we can search for more code to salvage/refactor.

See https://github.com/ooni/probe/issues/2121
2022-05-31 21:53:01 +02:00
..
chapter01 refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
chapter02 refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
chapter03 refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
chapter04 refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
README.md feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00

Tutorial: rewriting the torsf experiment

This tutorial teaches you how to write a minimal implementation of the torsf experiment. We will do that in four steps.

In the first step we will write a main.go function that runs the existing torsf implementation.

In the second step we will modify the existing code to launch an empty experiment instead.

In the third step we will start to fill in the empty experiment to more closely simulate a real implementation of the torsf experiment.

In the fourth step we will replace the code simulating a real torsf experiment with a minimal implementation of such an experiment that uses other code in ooni/probe-cli to attempt to bootstrap tor over Snowflake.