Add macro do_drat()

DESCRIPTION

@@ -55,6 +55,7 @@ Imports:
     backports,
     cli (>= 2.0.0),
     crayon,
+    desc, 
     magrittr,
     memoise,
     methods,
@@ -105,6 +106,7 @@ Collate:
     'macro-package-checks.R'
     'macro-pkgdown.R'
     'macro-bookdown.R'
+    'macro-drat.R'
     'mock.R'
     'print.R'
     'repo.R'

NAMESPACE

@@ -35,6 +35,7 @@ export(ci_on_circle)
 export(ci_on_travis)
 export(deploy)
 export(do_bookdown)
+export(do_drat)
 export(do_package_checks)
 export(do_pkgdown)
 export(dsl_get)
@@ -76,6 +77,7 @@ import(cli)
 import(rlang)
 importFrom(R6,R6Class)
 importFrom(crayon,has_color)
+importFrom(desc,desc_get_version)
 importFrom(magrittr,"%>%")
 importFrom(memoise,memoise)
 importFrom(methods,setOldClass)

R/macro-drat.R

@@ -0,0 +1,114 @@
+#' do_drat
+#'
+#' The [do_drat()] macro adds the necessary steps for building
+#' and deploying a drat repository to host R package sources.
+#'
+#' @importFrom desc desc_get_version
+#'
+#' @include macro.R
+#' @include macro-package-checks.R
+#' @name macro
+NULL
+
+#' Build and deploy drat repository
+#'
+#' @description
+#' `do_drat()` builds and deploys R packages to a drat repository and adds
+#' default steps to the `"install"`, `"before_deploy"` and `"deploy"` stages:
+#'
+#' @inheritParams step_add_to_drat
+#' @inheritParams step_setup_ssh
+#' @inheritParams step_setup_push_deploy
+#' @inheritParams step_do_push_deploy
+#' @param repo_slug `[string]`\cr
+#'   The name of the drat repository to deploy to in the form `:owner/:repo`.
+#' @param path,branch By default, this macro deploys the `"master"` branch
+#'   of the drat repository. An alternative option is `"gh-pages"`.
+#' @param ssh_key_name `[string]`\cr
+#'   The name of the private SSH key which will be used for deployment.
+#'   Must be available in the build as a secure environment variable.
+#' @param deploy_dev `[logical]`\cr
+#'   Should development versions of packages also be deployed to the drat repo?
+#'   By default only "major", "minor" and "patch" releases are build and
+#'   deployed.
+#'
+#' @section Deployment: Deployment can only happen to the `master` or
+#'   `gh-pages` branch because the Github Pages functionality from Github is
+#'   used to access the drat repository later on. You need to enable this
+#'   functionality when creating the drat repository on Github via `Settings ->
+#'   Github pages` and set it to the chosen setting here.
+#'
+#'   To build and deploy Windows binaries, builds on Travis CI with deployment
+#'   permissions need to be triggered. To build and deploy macOS binaries,
+#'   builds on Travis CI with deployment permissions need to be triggered. Have
+#'   a look at \url{https://docs.ropensci.org/tic/articles/deployment.html} for more
+#'   information and instructions.
+#' @family macros
+#' @export
+#' @examples
+#' \dontrun{
+#' dsl_init()
+#'
+#' do_drat()
+#'
+#' dsl_get()
+#' }
+do_drat <- function(repo_slug = NULL,
+                    orphan = FALSE,
+                    checkout = TRUE,
+                    path = "~/git/drat",
+                    branch = "master",
+                    remote_url = NULL,
+                    commit_message = NULL,
+                    commit_paths = ".",
+                    ssh_key_name = "id_rsa",
+                    deploy_dev = FALSE) {
+
+  if (is.null(repo_slug)) {
+    stopc("A repository to deploy to is required.")
+  }
+  if (!ci_can_push(name = ssh_key_name)) {
+    stopc("Deployment not possible. Please the SSH deployment permissions of the build.")
+  }
+
+  if (!deploy_dev) {
+    ver <- desc::desc_get_version()
+    if (length(unlist(ver)) > 3) {
+      cli_alert_info("Detected dev version of current package. Not building
+                      package binaries because {.code deploy_dev = FALSE} is
+                      set.", wrap = FALSE)
+      return(invisible())
+    }
+  }
+
+  #' @description
+  #' 1. [step_setup_ssh()] in the `"before_deploy"` to setup
+  #'    the upcoming deployment
+  get_stage("before_deploy") %>%
+    add_step(step_setup_ssh(name = ssh_key_name))
+
+  #' 1. [step_setup_push_deploy()] in the `"before_deploy"` stage
+  #'    (if `deploy` is set),
+  get_stage("before_deploy") %>%
+    add_step(step_setup_push_deploy(
+      path = !!enquo(path),
+      branch = !!enquo(branch),
+      remote = paste0("git@github.com:", repo_slug, ".git"),
+      orphan = !!enquo(orphan),
+      checkout = !!enquo(checkout)
+    ))
+
+  #' 1. [step_add_to_drat()] in the `"deploy"`
+  get_stage("deploy") %>%
+    add_step(step_add_to_drat())
+
+  #' 1. [step_do_push_deploy()] in the `"deploy"` stage.
+  get_stage("deploy") %>%
+    add_step(step_do_push_deploy(
+      path = !!enquo(path),
+      commit_message = !!enquo(commit_message),
+      commit_paths = !!enquo(commit_paths)
+    ))
+
+  dsl_get()
+}

R/steps-drat.R

@@ -4,18 +4,13 @@ AddToDrat <- R6Class(
 
   public = list(
     prepare = function() {
-      verify_install(c("drat", "remotes", "knitr", "withr", "pkgbuild"))
+      verify_install(c("drat", "remotes", "rmarkdown", "withr", "pkgbuild",
+                       "desc", "usethis"))
     },
 
     run = function() {
       path <- pkgbuild::build(binary = (getOption("pkgType") != "source"))
       drat::insertPackage(path)
-      withr::with_dir(
-        "~/git/drat",
-        if (file.exists("index.Rmd")) {
-          knitr::knit("index.Rmd", "index.md")
-        }
-      )
     }
   )
 )
@@ -24,8 +19,6 @@ AddToDrat <- R6Class(
 #'
 #' Builds a package (binary on OS X or Windows) and inserts it into an existing
 #' \pkg{drat} repository via [drat::insertPackage()].
-#' Also knits the `index.Rmd` file of the drat if it exists.
-#'
 #' @family steps
 #' @export
 #' @examples

README.md

@@ -34,7 +34,7 @@ The most important improvements over existing solutions are:
 
 {tic} can be installed from GitHub with:
 
-``` r
+```r
 remotes::install_github("ropensci/tic")
 ```
 

codemeta.json

@@ -321,6 +321,18 @@
       },
       "sameAs": "https://CRAN.R-project.org/package=crayon"
     },
+    {
+      "@type": "SoftwareApplication",
+      "identifier": "desc",
+      "name": "desc",
+      "provider": {
+        "@id": "https://cran.r-project.org",
+        "@type": "Organization",
+        "name": "Comprehensive R Archive Network (CRAN)",
+        "url": "https://cran.r-project.org"
+      },
+      "sameAs": "https://CRAN.R-project.org/package=desc"
+    },
     {
       "@type": "SoftwareApplication",
       "identifier": "magrittr",
@@ -402,7 +414,7 @@
   ],
   "releaseNotes": "https://github.com/krlmlr/tic/blob/master/NEWS.md",
   "readme": "https://github.com/krlmlr/tic/blob/master/README.md",
-  "fileSize": "346.89KB",
+  "fileSize": "349.193KB",
   "contIntegration": [
     "https://travis-ci.com/ropensci/tic",
     "https://ci.appveyor.com/project/ropensci/tic",
@@ -426,5 +438,13 @@
     "https://ci.appveyor.com/project/ropensci/tic-website"
   ],
   "developmentStatus": "https://www.tidyverse.org/lifecycle/#maturing",
-  "keywords": ["r", "travis-ci", "appveyor", "continuous-integration", "deployment", "r-package", "rstats"]
+  "keywords": [
+    "r",
+    "travis-ci",
+    "appveyor",
+    "continuous-integration",
+    "deployment",
+    "r-package",
+    "rstats"
+  ]
 }