Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

cleanup: remove httpapi and ooapi #1560

Merged
merged 91 commits into from
May 6, 2024
Merged

cleanup: remove httpapi and ooapi #1560

merged 91 commits into from
May 6, 2024

Conversation

bassosimone
Copy link
Member

@bassosimone bassosimone commented Apr 22, 2024

This diff removes httpapi and ooapi. Closes ooni/probe#2729.

This diff includes a first attempt at consolidating the patterns with
which we invoke OONI and third-party API calls.

I have refactored the code of httpx and httpapi into a new package
called httpclientx, added some tests, started converting some parts
of the tree, and explained myself in a design document.

Part of ooni/probe#2700
bassosimone added a commit that referenced this pull request Apr 23, 2024
Closes ooni/probe#2713.

We developed this diff in #1560,
which is work in the ooni/probe#2700 context.
Spotted thanks to a very paranoid check inside ./internal/oonirun.

Was not a problem before for `httpx` because of its usage pattern and may
or may not be a problem for the `httpapi` package (did not check since
this work is focused on replacing both `httpx` and `httpapi`).
Previously, we were gracefully handling this case, but honestly it is
not the best approach to pretend there's an empty structure if the server
breaks the API and returns `"null"` rather than an object.

That said, it was still awesome to have this test in place because it
helped us to figure out this extra condition of which httpclientx should
be aware and that this problem needs to be dealt with systematically
inside the httpclientx package.
Conflicts:
	internal/enginelocate/cloudflare.go
	internal/enginelocate/ubuntu.go
Conflicts:
	internal/oonirun/v2_test.go
As before, here I am going to ensure there's redundancy.
bassosimone added a commit that referenced this pull request May 3, 2024
This diff implements BuildErrorString, which we need in
#1560 to construct `multierror`
compatible error strings inside the `httpclientx` package.

While there, recognize that `multierror` should now be considered legacy
(i.e., minor changes and only bugfixes) because its implementation has
`Unwrap() error` while not it would be better to use `Unwrap() []errors`
but, if we were switching to the new callback, error wrapping would find
syscall errors and use them as the result.

Therefore, an error like:

```
httpapi: all endpoints failed: [ connection_reset; connection_reset; connection_reset; connection_reset;]
```

would be reduced to:

```
connection_reset
```

Because this behavior is subtle, I think it's best to move multierror
inside `./internal/legacy` and document this.

Part of ooni/probe#2729.
Conflicts:
	internal/httpapi/sequence.go
bassosimone added a commit that referenced this pull request May 3, 2024
While removing `httpapi` in #1560,
I noticed that I actually liked limiting the max body size, which is
particularly useful in case of gzip bombs. So, add tests for gzip bombs
and allow configuring the maximum body size. We detect truncation by
reading one more byte than needed and then checking the body length.

Part of ooni/probe#2729.
Conflicts:
	internal/httpclientx/config_test.go
	internal/httpclientx/httpclientx_test.go
@bassosimone bassosimone changed the title refactor: consolidate httpx and httpapi cleanup: remove httpapi and ooapi May 6, 2024
@bassosimone bassosimone marked this pull request as ready for review May 6, 2024 13:51
@bassosimone bassosimone requested a review from hellais as a code owner May 6, 2024 13:51
@bassosimone bassosimone merged commit f229348 into master May 6, 2024
17 of 19 checks passed
@bassosimone bassosimone deleted the issue/2700 branch May 6, 2024 14:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
1 participant