ooni-probe-cli/internal/engine/experiment
Simone Basso ba9151d4fa
feat(webstepsx): websteps using measurex (#530)
This diff adds the prototype websteps implementation that used
to live at https://github.com/ooni/probe-cli/pull/506.

The code is reasonably good already and it's pointing to a roaming
test helper that I've properly configured.

You can run websteps with:

```
./miniooni -n websteps
```

This will go over the test list for your country.

At this stage the mechanics of the experiment is set, but we
still need to have a conversation on the following topics:

1. whether we're okay with reusing the data format used by other
OONI experiments, or we would like to use a more compact data
format (which may either be a more compact JSON or we can choose
to always submit compressed measurements for websteps);

2. the extent to which we would like to keep the measurement as
a collection of "the experiment saw this" and "the test helper
saw that" and let the pipeline choose an overall score: this is
clearly an option, but there is also the opposite option to
build a summary of the measurement on the probe.

Compared to the previous prototype of websteps, the main
architectural change we have here is that we are following
the point of view of the probe and the test helper is
much more dumb. Basically, the probe will choose which
redirection to follow and ask the test helper every time
it discovers a new URL to measure it w/o redirections.

Reference issue: https://github.com/ooni/probe/issues/1733
2021-09-30 02:06:27 +02:00
..
dash refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
dnscheck feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00
example feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00
fbmessenger refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
hhfm refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
hirl refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
httphostheader feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00
ndt7 refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
psiphon feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00
riseupvpn refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
run feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00
signal refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
sniblocking refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
stunreachability refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
telegram refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
tlstool feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00
tor refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
torsf feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02:00
urlgetter refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
webconnectivity refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
websteps refactor: merge dnsx and errorsx into netxlite (#517) 2021-09-28 12:42:01 +02:00
webstepsx feat(webstepsx): websteps using measurex (#530) 2021-09-30 02:06:27 +02:00
whatsapp feat: tutorial on how to write the torsf experiment (#390) 2021-06-22 00:12:03 +02: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.