ooni-probe-cli/internal/engine/experiment
DecFox 5d2afaade4
cli: upgrade to lucas-clemente/quic-go@v0.27.0 (#715)
* quic-go upgrade: replaced Session/EarlySession with Connection/EarlyConnection

* quic-go upgrade: added context to RoundTripper.Dial

* quic-go upgrade: made corresponding changes to tutorial

* quic-go upgrade: changed sess variable instances to qconn

* quic-go upgrade: made corresponding changes to tutorial

* cleanup: remove unnecessary comments

Those comments made sense in terms of illustrating the changes
but they're going to be less useful once we merge.

* fix(go.mod): apparently we needed `go1.18.1 mod tidy`

VSCode just warned me about this. It seems fine to apply this
change as part of the pull request at hand.

* cleanup(netxlite): http3dialer can be removed

We used to use http3dialer to glue a QUIC dialer, which had a
context as its first argument, to the Dial function used by the
HTTP3 transport, which did not have a context as its first
argument.

Now that HTTP3 transport has a Dial function taking a context as
its first argument, we don't need http3dialer
anymore, since we can use the QUIC dialer directly.

Cc: @DecFox

* Revert "cleanup(netxlite): http3dialer can be removed"

This reverts commit c62244c620cee5fadcc2ca89d8228c8db0b96add
to investigate the build failure mentioned at
https://github.com/ooni/probe-cli/pull/715#issuecomment-1119450484

* chore(netx): show that test was already broken

We didn't see the breakage before because we were not using
the created transport, but the issue of using a nil dialer was
already present before, we just didn't see it.

Now we understand why removing the http3transport in
c62244c620cee5fadcc2ca89d8228c8db0b96add did cause the
breakage mentioned at
https://github.com/ooni/probe-cli/pull/715#issuecomment-1119450484

* fix(netx): convert broken integration test to working unit test

There's no point in using the network here. Add a fake dialer that
breaks and ensure we're getting the expected error.

We've now improved upon the original test because the original test was
not doing anything while now we're testing whether we get back a QUIC
dialer that _can be used_.

After this commit, I can then readd the cleanup commit
c62244c620cee5fadcc2ca89d8228c8db0b96add and it won't be
broken anymore (at least, this is what I expected to happen).

* Revert "Revert "cleanup(netxlite): http3dialer can be removed""

This reverts commit 0e254bfc6ba3bfd65365ce3d8de2c8ec51b925ff
because now we should have fixed the broken test.

Co-authored-by: decfox <decfox>
Co-authored-by: Simone Basso <bassosimone@gmail.com>
2022-05-06 12:24:03 +02:00
..
dash feature: merge measurex and netx archival layer (1/N) (#663) 2022-01-14 12:13:10 +01:00
dnscheck fix(dnscheck): log "ok" rather than "<nil>" on success (#695) 2022-02-16 20:47:44 +01:00
example fix: ensure experiments return nil when we want to submit (#654) 2022-01-07 13:17:20 +01:00
fbmessenger refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
hhfm cleanup: remove unnecessary legacy interfaces (#656) 2022-01-07 18:33:37 +01:00
hirl cleanup: use ErrorToStringOrOK func in other tests that returns nil (#701) 2022-03-08 11:59:44 +01:00
httphostheader refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
ndt7 fix(ndt7): force our bundled CA pool (#700) 2022-02-23 12:59:03 +01:00
psiphon fix: ensure experiments return nil when we want to submit (#654) 2022-01-07 13:17:20 +01:00
quicping feat: add an experimental quicping experiment (#677) 2022-02-14 19:21:16 +01:00
riseupvpn refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
run fix: ensure experiments return nil when we want to submit (#654) 2022-01-07 13:17:20 +01:00
signal refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
sniblocking refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
stunreachability cleanup: remove unnecessary legacy interfaces (#656) 2022-01-07 18:33:37 +01:00
telegram refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +01:00
tlstool cleanup: remove unnecessary legacy interfaces (#656) 2022-01-07 18:33:37 +01:00
tor fix: ensure experiments return nil when we want to submit (#654) 2022-01-07 13:17:20 +01:00
torsf feat(torsf): add default_timeout test keys (#709) 2022-05-06 10:47:26 +02:00
urlgetter cleanup: use ErrorToStringOrOK func in other tests that returns nil (#701) 2022-03-08 11:59:44 +01:00
webconnectivity cleanup: use ErrorToStringOrOK func in other tests that returns nil (#701) 2022-03-08 11:59:44 +01:00
websteps cli: upgrade to lucas-clemente/quic-go@v0.27.0 (#715) 2022-05-06 12:24:03 +02:00
webstepsx cleanup: remove redundant HTTPClient definition (#643) 2022-01-03 16:47:54 +01:00
whatsapp refactor: interfaces and data types into the model package (#642) 2022-01-03 13:53:23 +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.