ooni-probe-cli/internal/cmd
Simone Basso 8a0beee808
refactor: start pivoting netx (#396)
What do I mean by pivoting? Netx is currently organized by row:

```
               | dialer | quicdialer | resolver | ...
 saving        |        |            |          | ...
 errorwrapping |        |            |          | ...
 logging       |        |            |          | ...
 mocking/sys   |        |            |          | ...
```

Every row needs to implement saving, errorwrapping, logging, mocking (or
adapting to the system or to some underlying library).

This causes cross package dependencies and, in turn, complexity. For
example, we need the `trace` package for supporting saving.

And `dialer`, `quickdialer`, et al. need to depend on such a package.

The same goes for errorwrapping.

This arrangement further complicates testing. For example, I am
currently working on https://github.com/ooni/probe/issues/1505 and
I realize it need to repeat integration tests in multiple places.

Let's say instead we pivot the above matrix as follows:

```
             | saving | errorwrapping | logging | ...
 dialer      |        |               |         | ...
 quicdialer  |        |               |         | ...
 logging     |        |               |         | ...
 mocking/sys |        |               |         | ...
 ...
```

In this way, now every row contains everything related to a specific
action to perform. We can now share code without relying on extra
support packages. What's more, we can write tests and, judding from
the way in which things are made, it seems we only need integration
testing in `errorwrapping` because it's where data quality matters
whereas, in all other cases, unit testing is fine.

I am going, therefore, to proceed with these changes and "pivot"
`netx`. Hopefully, it won't be too painful.
2021-06-23 15:53:12 +02:00
..
apitool refactor: flatten and separate (#353) 2021-06-04 10:34:18 +02:00
e2epostprocess cleanup(all): stop using deprecated ioutil functions (#381) 2021-06-15 14:01:45 +02:00
getresources refactor: redesign how we import assets (#260) 2021-04-01 16:57:31 +02:00
jafar cleanup(all): stop using deprecated ioutil functions (#381) 2021-06-15 14:01:45 +02:00
miniooni cleanup(all): stop using deprecated ioutil functions (#381) 2021-06-15 14:01:45 +02:00
oohelper fix(all): introduce and use iox.ReadAllContext (#379) 2021-06-15 11:57:40 +02:00
oohelperd refactor: start pivoting netx (#396) 2021-06-23 15:53:12 +02:00
ptxclient feat: introduce ptx package for pluggable transports dialers (#373) 2021-06-14 10:20:54 +02:00
README.md doc: ensure all top dirs have an explanatory README (#214) 2021-02-03 16:54:00 +01:00

Directory github.com/ooni/probe-cli/internal/cmd

This directory contains the source code for the CLI tools we build but we don't want to expose to the outside world. That is, you can only build these tools if you have cloned this repo.