Message-ID: <BDC8AB46-D432-4D3F-8532-7C0149FD6FF3@mathematik.uni-marburg.de>
Date: 2019-10-01T17:48:19Z
From: Dr. rer. nat. Michael Thrun
Subject: [R-pkg-devel] CRAN policies with regards to runnable examples
In-Reply-To: <CAD6tx94ckRYeLY5Uv7wz7-O7O5Zy5oRmBeJ-bAt3h3Y4S-Z6-Q@mail.gmail.com>
Hello Jim,
thank you for asking this question. I would also like to have a standard solution for this problem.
Best Regards
Michael
Michael Thrun
Postdoctoral Scholar
Databionics AG,
Mathematics and Computer Science
Philipps-Universit?t Marburg
Hans-Meerwein-Stra?e 6, 04A28
D-35032 Marburg
Phone +49 6421/ 28 23922
www.uni-marburg.de/fb12/datenbionik/
> On 1. Oct 2019, at 19:37, Jim Hester <james.f.hester at gmail.com> wrote:
>
> CRAN reviewers have somewhat recently been requesting that new
> submissions have runnable examples. This is in general a good
> recommendation, but the reviewers seem to apply this policy
> unconditionally, and there are certain classes of packages where this
> is either extremely cumbersome or impossible to do.
>
> Two in particular are packages which wrap web APIs and packages
> containing shiny applications. Even the most robust APIs will
> inevitably have network failures, causing spurious failures on CRAN's
> machines, and often the APIs require credentials to access, which
> won't be available on the build machines. Shiny applications block the
> R process and require user interaction in a browser to function, they
> cannot really be run non-interactively.
>
> In these cases it seems appropriate to put examples in a `\dontrun{}`
> or `\donttest{}` block, and this is what is suggested by writing R
> extensions. However CRAN reviewers have refused to accept packages
> taking this approach.
>
> If these workarounds are not acceptable what _does_ CRAN want package
> authors to do in these cases?
>
> Jim
>
> ______________________________________________
> R-package-devel at r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-package-devel
[[alternative HTML version deleted]]