ooni-probe-cli/internal/engine/experiment
Simone Basso c5ad5eedeb
feat: create tunnel inside NewSession (#286)
* feat: create tunnel inside NewSession

We want to create the tunnel when we create the session. This change
allows us to nicely ignore the problem of creating a tunnel when we
already have a proxy, as well as the problem of locking. Everything is
happening, in fact, inside of the NewSession factory.

Modify miniooni such that --tunnel is just syntactic sugar for
--proxy, at least for now. We want, in the future, to teach the
tunnel to possibly use a socks5 proxy.

Because starting a tunnel is a slow operation, we need a context in
NewSession. This causes a bunch of places to change. Not really a big
deal except we need to propagate the changes.

Make sure that the mobile code can create a new session using a
proxy for all the APIs we support.

Make sure all tests are still green and we don't loose coverage of
the various ways in which this code could be used.

This change is part of https://github.com/ooni/probe/issues/985.

* changes after merge

* fix: only keep tests that can hopefully work

While there, identify other places where we should add more
tests or fix integration tests.

Part of https://github.com/ooni/probe/issues/985
2021-04-05 15:28:13 +02:00
..
dash refactor: miniooni should be outside of the engine (#206) 2021-02-03 11:21:10 +01:00
dnscheck refactor: redesign how we import assets (#260) 2021-04-01 16:57:31 +02:00
example chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
fbmessenger feat: create tunnel inside NewSession (#286) 2021-04-05 15:28:13 +02:00
hhfm feat: create tunnel inside NewSession (#286) 2021-04-05 15:28:13 +02:00
hirl chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
httphostheader chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
ndt7 refactor: miniooni should be outside of the engine (#206) 2021-02-03 11:21:10 +01:00
psiphon chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
riseupvpn refactor(riseupvpn): minor changes and annotations (#275) 2021-04-02 17:58:36 +02:00
run fix: always use probe-cli version (and make it alpha) (#219) 2021-02-04 11:00:27 +01:00
signal MVP of a signal messenger test (#230) 2021-02-26 10:16:34 +01:00
sniblocking MVP of a signal messenger test (#230) 2021-02-26 10:16:34 +01:00
stunreachability refactor: redesign how we import assets (#260) 2021-04-01 16:57:31 +02:00
telegram Add new telegram DC endpoint (#232) 2021-02-26 14:11:24 +01:00
tlstool release 3.9.0 process: reduce warnings (#279) 2021-03-31 15:59:19 +02:00
tor refactor: remove model.ExperimentOrchestraClient (#284) 2021-04-02 12:03:18 +02:00
urlgetter feat: create tunnel inside NewSession (#286) 2021-04-05 15:28:13 +02:00
webconnectivity feat: create tunnel inside NewSession (#286) 2021-04-05 15:28:13 +02:00
whatsapp fix: always use probe-cli version (and make it alpha) (#219) 2021-02-04 11:00:27 +01:00
README.md chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00

Directory github.com/ooni/probe-engine/experiment

This directory contains the implementation of all the supported experiments, one for each directory. The OONI spec repository contains a description of all the specified experiments.

Note that in the OONI spec repository experiments are called nettests. Originally, they were also called nettests here but that created confusion with nettests in ooni/probe-cli. Therefore, we now use the term experiment to indicate the implementation and the term nettest to indicate the user facing view of such implementation.

Note that some experiments implemented here are not part of the OONI specification. For example, the urlgetter experiment is not in the OONI spec repository. The reason why this happens is that urlgetter is an experiment "library" that other experiments use to implement their functionality.

Likewise, the example experiment is a minimal experiment that does nothing and you could use to bootstrap the implementation of a new experiment. Of course, this experiment is not part of the OONI specification.