req-perform.md
In httr2: Perform HTTP Requests and Process the Responses

curl errors become errors

Code
  req_perform(req)
Condition
  Error in `req_perform()`:
  ! Failed to perform HTTP request.
  Caused by error in `req_perform1()`:
  ! Failed to connect

http errors become errors

Code
  req_perform(req)
Condition
  Error in `req_perform()`:
  ! HTTP 404 Not Found.

Code
  req_perform(req)
Condition
  Error in `req_perform()`:
  ! HTTP 429 Too Many Requests.

checks input types

Code
  req_perform(req, path = 1)
Condition
  Error in `req_perform()`:
  ! `path` must be a single string or `NULL`, not the number 1.
Code
  req_perform(req, verbosity = 1.5)
Condition
  Error in `req_perform()`:
  ! `verbosity` must 0, 1, 2, or 3.
Code
  req_perform(req, mock = 7)
Condition
  Error in `req_perform()`:
  ! `mock` must be a function or `NULL`, not the number 7.

req_dry_run() shows body

Code
  request("http://example.com") %>% req_headers(`Accept-Encoding` = "gzip") %>%
    req_body_json(list(x = 1, y = TRUE, z = "c")) %>% req_user_agent("test") %>%
    req_dry_run()
Output
  POST / HTTP/1.1
  Host: example.com
  User-Agent: test
  Accept: */*
  Accept-Encoding: gzip
  Content-Type: application/json
  Content-Length: 24

  {"x":1,"y":true,"z":"c"}

authorization headers are redacted

Code
  request("http://example.com") %>% req_headers(`Accept-Encoding` = "gzip") %>%
    req_auth_basic("user", "password") %>% req_user_agent("test") %>% req_dry_run()
Output
  GET / HTTP/1.1
  Host: example.com
  User-Agent: test
  Accept: */*
  Accept-Encoding: gzip
  Authorization: <REDACTED>