create.project: Create a new project.

Description

This function will create all of the scaffolding for a new project. It will set up all of the relevant directories and their initial contents. For those who only want the minimal functionality, the template argument can be set to minimal to create a subset of ProjectTemplate's default directories. For those who want to dump all of ProjectTemplate's functionality into a directory for extensive customization, the dump argument can be set to TRUE.

Usage

create.project(
  project.name = "new-project",
  template = "full",
  dump = FALSE,
  merge.strategy = c("require.empty", "allow.non.conflict"),
  rstudio.project = FALSE
)

Value

No value is returned; this function is called for its side effects.

Arguments

project.name: A character vector containing the name for this new project. Must be a valid directory name for your file system.
template: A character vector containing the name of the template to use for this project. By default a full and minimal template are provided, but custom templates can be created using create.template.
dump: A boolean value indicating whether the entire functionality of ProjectTemplate should be written out to flat files in the current project.
merge.strategy: What should happen if the target directory exists and is not empty? If "force.empty", the target directory must be empty; if "allow.non.conflict", the method succeeds if no files or directories with the same name exist in the target directory.
rstudio.project: A boolean value indicating whether the project should also be an 'RStudio Project'. Defaults to FALSE. If TRUE, then a `projectname.Rproj` with usable defaults is added to the ProjectTemplate directory.

Details

If the target directory does not exist, it is created. Otherwise, it can only contain files and directories allowed by the merge strategy.

Examples

Run this code

library('ProjectTemplate')

if (FALSE) create.project('MyProject')