273b70bacc
## Checklist - [x] I have read the [contribution guidelines](https://github.com/ooni/probe-cli/blob/master/CONTRIBUTING.md) - [x] reference issue for this pull request: https://github.com/ooni/probe/issues/1885 - [x] related ooni/spec pull request: N/A Location of the issue tracker: https://github.com/ooni/probe ## Description This PR contains a set of changes to move important interfaces and data types into the `./internal/model` package. The criteria for including an interface or data type in here is roughly that the type should be important and used by several packages. We are especially interested to move more interfaces here to increase modularity. An additional side effect is that, by reading this package, one should be able to understand more quickly how different parts of the codebase interact with each other. This is what I want to move in `internal/model`: - [x] most important interfaces from `internal/netxlite` - [x] everything that was previously part of `internal/engine/model` - [x] mocks from `internal/netxlite/mocks` should also be moved in here as a subpackage |
||
|---|---|---|
| .. | ||
| experiment/torsf | ||
| generator | ||
| measurex | ||
| netxlite | ||
| README.md | ||
Tutorials: writing OONI nettests
This package contains a living tutorial explaining how to write OONI nettests. The code in here is based on existing nettests.
Because it's committed to the probe-cli repository and depends on real OONI code, it should always be up to date.
Index
-
Rewriting the torsf experiment: this tutorial explains to you how to write a simple experiment. After reading it, you will understand the interfaces between an experiment and the OONI core. What this tutorial does not teach you, though, is how to tell the OONI core about this experiment. To see how to do that, you should check how we do that in internal/engine/allexperiments.go.
-
Using the measurex package to write network experiments: this tutorial explains to you how to use the
measurexlibrary to write networking code that generates measurements using the OONI data format. You will learn how to perform DNS, TCP, TLS, QUIC, HTTP, HTTPS, and HTTP3 measurements. -
Low-level networking using netxlite: this tutorial introduces you to the
netxlitenetworking library. This is the underlying library used bymeasurexas well as by many other libraries inside OONI. You need to know about this library to contribute tomeasurexas well as to other parts of the OONI core that perform network operations.
Therefore, after reading these tutorials, you should have a better understanding of how an experiment interacts with the OONI core, as well as of which libraries you can use to write experiments.
Regenerating the tutorials
(cd ./internal/tutorial && go run ./generator)