Saya sedang menulis fungsi geocoding sekarang yang mengandalkan memiliki Bing Maps Key. Jelas saya lebih suka tidak menerbitkan milik saya, dan contoh gagal tanpa satu.
Bagaimana cara menyertakan contoh bagi pengguna untuk dijalankan secara manual, tetapi tidak dieksekusi selama R CMD check
?
?example
dan Menulis Ekstensi Rroxygen2
membuat@example
tag, jadi saya pikir ituroxygen2
masalah. Saya rasa tidak\example{}
valid - lihat cran.r-project.org/doc/manuals/…@example
bukan@examples
. Kedua tag muncul dalam pelengkapan otomatis RStudio. Aku senang sekarang.Anda dapat menggunakan
\donttest{}
contoh Anda. Cuplikan akan disediakan dalam dokumentasi Anda, tetapi tidak akan diuji dengan Pemeriksaan R CMD.Untuk info lebih lanjut ->
?example
#' @example \donttest{ 2^2 }
2 ^ 2 ini tidak akan berjalan saat Anda berlari
devtools::check()
Periksa sendiri sebelum menilai. :)
sumber
Bagi mereka yang menggunakan
@example path/to/example.R
sebagai ganti@examples
tag, Anda dapat menggunakan\dontrun
lingkungan langsung diexample.R
file. Sebagai contoh# example.R \dontrun{ # this is a long running example for(i in seq(1, 1e5)) { lm(mpg ~ wt, data = mtcars) } } # some other shorter example 2 + 2
sumber
Ari, saya juga menggunakan roxygen2 (versi 4.1.0). Berikut ini adalah akhir dari mark-up roxygen2 saya dalam definisi fungsi saya (gctemplate) sampai awal bagian yang sebenarnya.
#' @examples #' ## List all G-causalities in a VAR system of 5 variables that will be searched in the pattern of 1 #' ## causer (like-independent) variable and 2 like-dependents conditional on 5-(1+2)=2 of the remaining #' ## variable(s) in the system. Variables are assigned to numbers 1 to nvars. #' ## "1 2 5 3 4" in the resulting line of gctemplate is to indicate the #' ## (conditonal, partial, etc.) G-causality from variable 1 to variables 2 and 5 #' ## conditonal on variables 3 and 4. #' # gctemplate(5,1,2) #' ## The number of all G-causalities to be searched in the above pattern. #' #dim(gctemplate(5,1,2))[[1]] #' @importFrom combinat combn #' @export gctemplate <- function(nvars, ncausers, ndependents){ ...
Saya tahu metode dontrun GSee.
Dalam teknik saya, contoh numerik dan teks yang menjelaskan contoh numerik keduanya adalah komentar. Saya menggunakan lekukan untuk membuat perbedaan antara keduanya; Perhatikan ada 1 kres dan 2 kres masing-masing setelah "# '". Saya selalu menggunakan teknik "# '## / #' #" di atas dalam paket saya. Pengguna dibiarkan melakukan operasi salin-tempel setiap kali ia ingin menguji fungsi tersebut. Teknik ini - menurut saya - lebih paralel dengan bombardir komentar klasik dari filosofi pengkodean perangkat lunak.
sumber
dontrun{}
, maka pengguna dapat memanggilexample(myFunction, run.dontrun=TRUE)
, sedangkan jika Anda hanya mengomentari contoh, Anda tidak memiliki cara untuk menjalankan contoh selain salin / tempel.