ooni-probe-cli/internal/engine/doc.go

// Package engine contains the engine API.
package engine
feat(engine): allow runner to return many measurements (#527) This is required to implement websteps, which is currently tracked by https://github.com/ooni/probe/issues/1733. We introduce the concept of async runner. An async runner will post measurements on a channel until it is done. When it is done, it will close the channel to notify the reader about that. This change causes sync experiments now to strictly return either a non-nil measurement or a non-nil error. While this is a pretty much obvious situation in golang, we had some parts of the codebase that were not robust to this assumption and attempted to submit a measurement after the measure call returned an error. Luckily, we had enough tests to catch this change in our assumption and this is why there are extra docs and tests changes. 2021-09-30 00:54:52 +02:00			`// Package engine contains the engine API.`
			`package engine`