with_mock_dir

This context will switch the <code>.mockPaths()</code> to <code>tests/testthat/dir</code>
(and then resets it to what it was before).
If the <code>tests/testthat/dir</code> folder doesn't exist, <code>capture_requests()</code> will
be run to create mocks.
If it exists, <code>with_mock_api()</code> will be run.
To re-record mock files, simply delete <code>tests/testthat/dir</code> and run the test.

Testing and documenting code that communicates with remote servers
can be painful. Dealing with authentication, server state,
and other complications can make testing seem too costly to
bother with. But it doesn't need to be that hard. This package enables one
to test all of the logic on the R sides of the API in your package without
requiring access to the remote service. Importantly, it provides three
contexts that mock the network connection in different ways, as well as
testing functions to assert that HTTP requests were---or were
not---made. It also allows one to safely record real API responses to use as
test fixtures. The ability to save responses and load them offline also
enables one to write vignettes and other dynamic documents that can be
distributed without access to a live server.

Neal Richardson

httptest

A Test Environment for HTTP Requests

Jonathan Keane

Maëlle Salmon

with_mock_dir function

<dl><dt>dir</dt>
<dd>character string, unique folder name that will be used or created
under <code>tests/testthat/</code></dd>
<dt>expr</dt>
<dd>Code to run inside the fake context</dd>
<dt>simplify</dt>
<dd>logical: if <code>TRUE</code> (default), JSON responses with status 200
will be written as just the text of the response body. In all other cases,
and when <code>simplify</code> is <code>FALSE</code>, the "response" object will be written out to
a .R file using <code><a href="/link/base%3A%3Adput()?package=httptest&version=4.2.3" data-mini-rdoc="httptest::base::dput()">base::dput()</a></code>.</dd>
<dt>replace</dt>
<dd>Logical: should the mock directory replace current mock
directories? Default is <code>TRUE</code>.</dd></dl>

Arguments

Use or create mock files depending on their existence — with_mock_dir

<dl>

<dt>dir</dt>
<dd>character string, unique folder name that will be used or created
under <code>tests/testthat/</code></dd>


<dt>expr</dt>
<dd>Code to run inside the fake context</dd>


<dt>simplify</dt>
<dd>logical: if <code>TRUE</code> (default), JSON responses with status 200
will be written as just the text of the response body. In all other cases,
and when <code>simplify</code> is <code>FALSE</code>, the "response" object will be written out to
a .R file using <code><a href='https://rdrr.io/r/base/dput.html'>base::dput()</a></code>.</dd>


<dt>replace</dt>
<dd>Logical: should the mock directory replace current mock
directories? Default is <code>TRUE</code>.</dd>

</dl>

with_mock_dir: Use or create mock files depending on their existence

Description

Usage

Arguments