readme-src.Rmd

---
output:
  html_document:
    keep_md: yes
    variant: markdown_github
---
<!-- README.md is generated from readme-src.Rmd. Please edit that file -->

```{r, echo = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "# >",
  fig.path = "README-"
)

options(repos = "https://cran.rstudio.com/")
```

# needs
[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/needs)](http://cran.r-project.org/package=needs)

`needs` is a simple R package to make package loading / installation hassle-free &mdash; use it in place of `library` to attach packages and automatically install any that are missing. You can also supply a minimum version number, and it will update old packages as needed. No more changing your code to reinstall packages every time you update R &mdash; `needs` does it for you.

```{r eval = F}
install.packages("needs")
# for the dev version:
# devtools::install_github("joshkatz/needs", ref = "development")
library(needs)

# answer "yes" when prompted, and you will never have
# to type library or install.packages again. hooray.
```

### Usage
Once installed, use just as you would `library`. With the added bonus of being able to give multiple unquoted arguments in one single function call. Specify a required package version with a pairlist:

```{r eval = F}
needs(foo,
      bar = "0.9.1",
      baz = "0.4.3")
```


### Rprofile
`needs` can help make code-sharing easier. In your project directory:
```{r eval = F}
needs::toProfile()
```
This extracts the package contents and appends it to the Rprofile in your working directory. Now if someone else clones your project, your code runs without requiring any extra installation or throwing errors for uninstalled packages.