Defines functions use_namespace

Documented in use_namespace

#' Use a basic `NAMESPACE`
#' If `roxygen` is `TRUE` generates an empty `NAMESPACE` that exports nothing;
#' you'll need to explicitly export functions with `@export`. If `roxygen`
#' is `FALSE`, generates a default `NAMESPACE` that exports all functions
#' except those that start with `.`.
#' @param roxygen Do you plan to manage `NAMESPACE` with roxygen2?
#' @seealso The [namespace chapter](https://r-pkgs.org/namespace.html) of
#'   [R Packages](https://r-pkgs.org).
#' @export
use_namespace <- function(roxygen = TRUE) {

  path <- proj_path("NAMESPACE")
  if (roxygen) {
    write_over(path, c("# Generated by roxygen2: do not edit by hand", ""))
  } else {
    write_over(path, 'exportPattern("^[^\\\\.]")')

Try the usethis package in your browser

Any scripts or data that you put into this service are public.

usethis documentation built on May 28, 2022, 1:09 a.m.