[Rd] Using unit-tests as examples

Hadley Wickham h.wickham at gmail.com
Mon Jan 20 14:33:21 CET 2014

The problem with extracting a single test from a file is going to be
locating the relevant lines of code and cleanly pulling them out
(along with any needed supporting code). It might be better to attack
the problem in the opposite direction by having a roxygen2 directive
that inserted the block in both the examples and in a special testthat


On Mon, Jan 20, 2014 at 3:32 AM, Alexey Sergushichev
<alsergbox at gmail.com> wrote:
> Yes, this may work, but this way I have to have one test per file,
> which is not very convenient.
> ---
> Alexey
> On Sat, Jan 18, 2014 at 7:43 PM, Hadley Wickham <h.wickham at gmail.com> wrote:
>> If you're using roxygen2, you can use @example tag to include an
>> external file into the examples.
>> Hadley
>> On Sat, Jan 18, 2014 at 7:18 AM, Alexey Sergushichev
>> <alsergbox at gmail.com> wrote:
>>> Hi,
>>> Which is the best way to use unit tests as examples for documentation?
>>> I use testthat, but if there is a good way to do this, for example,
>>> only with RUnit, it'd still be good to know.
>>> Unit-tests are usually simple and concise, so they are good candidates
>>> for example code, but I don't want to copy them into documentation and
>>> maintain by hands. I tried to google how people handle this, but
>>> didn't find anything.
>>> ---
>>> Best regards,
>>> Alexey
>>> ______________________________________________
>>> R-devel at r-project.org mailing list
>>> https://stat.ethz.ch/mailman/listinfo/r-devel
>> --
>> http://had.co.nz/


More information about the R-devel mailing list