crul-package: HTTP R client

Description

HTTP R client

HttpClient() - create a connection client, set all your http options, make http requests
HttpResponse() - mostly for internal use, handles http responses
Paginator() - auto-paginate through requests
Async() - asynchronous requests
AsyncVaried() - varied asynchronous requests
HttpRequest() - generate an HTTP request, mostly for use in building requests to be used in Async or AsyncVaried
mock() - Turn on/off mocking, via webmockr
auth() - Simple authentication helper
proxy() - Proxy helper
upload() - File upload helper
set curl options globally: set_auth(), set_headers(), set_opts(), set_proxy(), and crul_settings()

HttpClient is the main interface for making HTTP requests, and includes methods for each HTTP verb
HttpRequest allows you to prepare a HTTP payload for use with AsyncVaried, which provides asynchronous requests for varied HTTP methods
Async provides asynchronous requests for a single HTTP method at a time
the verb() method can be used on all the above to request a specific HTTP verb

HttpResponse() has helpers for checking and raising warnings/errors.

content-types details the various options for checking content types and throwing a warning or error if the response content type doesn't match what you expect. Mis-matched content-types are typically a good sign of a bad response. There's methods built in for json, xml and html, with the ability to set any custom content type
raise_for_status() is a method on HttpResponse() that checks the HTTP status code, and errors with the appropriate message for the HTTP status code, optionally using the package fauxpas if it's installed.

We use fauxpas if you have it installed for handling HTTP conditions but if it's not installed we use httpcode

Mocking HTTP requests is supported via the webmockr package. See mock for guidance, and https://ropenscilabs.github.io/http-testing-book/

Caching HTTP requests is supported via the vcr package. See https://ropenscilabs.github.io/http-testing-book/