c/ooni-probe-cli
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
28ce79eff1
ooni-probe-cli/internal/engine/netx
History
Simone Basso 28ce79eff1
feat(ooapi): add toplevel client and simplify API (#248) 
* feat(ooapi): add toplevel client and simplify API

This diff should simplify using ooapi from other packages by
adding more abstraction that wraps the existing code.

Part of https://github.com/ooni/probe/issues/1355.

* fix(ooapi): use correct comment for cloners

See https://github.com/ooni/probe-cli/pull/248#discussion_r590663843

* fix(ooapi): make sure the documentation is current

See https://github.com/ooni/probe-cli/pull/248#discussion_r590665773

* fix(ooapi): automate copying APIs

See https://github.com/ooni/probe-cli/pull/248#discussion_r590665837

* feat(ooapi): add unit tests for clientcall.go

See https://github.com/ooni/probe-cli/pull/248#discussion_r590666297

* fix(ooapi): rewrite integration tests to use toplevel API

See https://github.com/ooni/probe-cli/pull/248#discussion_r590665084
2021-03-19 09:30:42 +01:00
..
archival feat: use go1.16 and resources embedding (#235) 2021-03-02 12:08:24 +01:00
bytecounter chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
dialer Release 3.6.0 (#239) 2021-03-03 14:42:17 +01:00
errorx chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
gocertifi feat(ooapi): add toplevel client and simplify API (#248) 2021-03-19 09:30:42 +01:00
httptransport fix(http body saver): properly deal with EOF terminated bodies (#226) 2021-02-11 14:57:14 +01:00
quicdialer Release 3.6.0 (#239) 2021-03-03 14:42:17 +01:00
resolver Release 3.6.0 (#239) 2021-03-03 14:42:17 +01:00
selfcensor chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
trace chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
fake_test.go chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
integration_test.go chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
netx_internal_test.go chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
netx_test.go fix(webconnectivity): allow measuring https://1.1.1.1 (#241) 2021-03-08 12:05:43 +01:00
netx.go fix(webconnectivity): allow measuring https://1.1.1.1 (#241) 2021-03-08 12:05:43 +01:00
README.md chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00

README.md

Package github.com/ooni/probe-engine/netx

OONI extensions to the net and net/http packages. This code is used by ooni/probe-engine as a low level library to collect network, DNS, and HTTP events occurring during OONI measurements.

This library contains replacements for commonly used standard library interfaces that facilitate seamless network measurements. By using such replacements, as opposed to standard library interfaces, we can:

  • save the timing of HTTP events (e.g. received response headers)
  • save the timing and result of every Connect, Read, Write, Close operation
  • save the timing and result of the TLS handshake (including certificates)

By default, this library uses the system resolver. In addition, it is possible to configure alternative DNS transports and remote servers. We support DNS over UDP, DNS over TCP, DNS over TLS (DoT), and DNS over HTTPS (DoH). When using an alternative transport, we are also able to intercept and save DNS messages, as well as any other interaction with the remote server (e.g., the result of the TLS handshake for DoT and DoH).

This package is a fork of github.com/ooni/netx.