{"Type":"Package","Package":"pins","Title":"Pin, Discover and Share Resources","Version":"1.0.3","Authors@R":"c(\nperson(\"Julia\", \"Silge\", , \"julia.silge@rstudio.com\", role = c(\"cre\", \"aut\"),\ncomment = c(ORCID = \"0000-0002-3671-836X\")),\nperson(\"Hadley\", \"Wickham\", , \"hadley@rstudio.com\", role = c(\"aut\"),\ncomment = c(ORCID = \"0000-0003-4757-117X\")),\nperson(\"Javier\", \"Luraschi\", , \"jluraschi@gmail.com\", role = \"aut\"),\nperson(, \"RStudio\", role = c(\"cph\", \"fnd\"))\n)","Description":"Publish data sets, models, and other R objects, making it\neasy to share them across projects and with your colleagues. You can\npin objects to a variety of \"boards\", including local folders (to\nshare on a networked drive or with 'DropBox'), 'RStudio' connect,\nAmazon S3, and more.","License":"Apache License (>= 2)","URL":"https://pins.rstudio.com/, https://github.com/rstudio/pins-r","BugReports":"https://github.com/rstudio/pins-r/issues","Depends":"R (>= 3.3.0)","Imports":"cli, digest, ellipsis, filelock, fs, glue, httr, jsonlite,\nlifecycle, magrittr, mime, openssl, rappdirs, rlang (>=\n0.4.10), tibble, whisker, withr (>= 2.4.3), yaml, zip","Suggests":"arrow, AzureStor, data.table, datasets, gitcreds, knitr,\nMicrosoft365R, mockery, paws.storage, qs, R.utils, rmarkdown,\nrsconnect, shiny, testthat (>= 3.0.0), xml2","VignetteBuilder":"knitr","Config/testthat/edition":"3","Encoding":"UTF-8","RoxygenNote":"7.2.1","NeedsCompilation":"no","Packaged":"2022-09-23 21:27:57 UTC; juliasilge","Author":"Julia Silge [cre, aut] (),\nHadley Wickham [aut] (),\nJavier Luraschi [aut],\nRStudio [cph, fnd]","Maintainer":"Julia Silge ","Repository":"CRAN","Date/Publication":"2022-09-24 06:00:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/pins_1.0.3.tar.gz","jsonAuthors":[{"name":"Julia Silge","email":"julia.silge@rstudio.com","maintainer":true},{"name":"Hadley Wickham","email":"hadley@rstudio.com","maintainer":false},{"name":"Javier Luraschi","email":"jluraschi@gmail.com","maintainer":false},{"name":" RStudio","email":null,"maintainer":false}],"readme":"\n# pins [

](https://pins.rstudio.com)\n\n\n\n[![R-CMD-check](https://github.com/rstudio/pins-r/workflows/R-CMD-check/badge.svg)](https://github.com/rstudio/pins-r/actions)\n[![CRAN\nStatus](https://www.r-pkg.org/badges/version/pins)](https://cran.r-project.org/package=pins)\n[![Codecov test\ncoverage](https://codecov.io/gh/rstudio/pins-r/branch/main/graph/badge.svg)](https://app.codecov.io/gh/rstudio/pins-r?branch=main)\n\n\n\nThe pins package publishes data, models, and other R objects, making it\neasy to share them across projects and with your colleagues. You can pin\nobjects to a variety of pin *boards*, including folders (to share on a\nnetworked drive or with services like DropBox), RStudio Connect, Amazon\nS3, Azure storage and Microsoft 365 (OneDrive and SharePoint). Pins can\nbe automatically versioned, making it straightforward to track changes,\nre-run analyses on historical data, and undo mistakes.\n\npins 1.0.0 includes a new more explicit API and greater support for\nversioning. The legacy API (`pin()`, `pin_get()`, and\n`board_register()`) will continue to work, but new features will only be\nimplemented with the new API, so we encourage you to switch to the\nmodern API as quickly as possible. Learn more in\n`vignette(\"pins-update\")`.\n\nYou can use pins from Python as well as R. For example, you can use one\nlanguage to read a pin created with the other. Learn more about [pins\nfor Python](https://rstudio.github.io/pins-python/).\n\n## Installation\n\nYou can install pins from CRAN with:\n\n``` r\ninstall.packages(\"pins\")\n```\n\nYou can install the development version from GitHub:\n\n``` r\nremotes::install_github(\"rstudio/pins-r\")\n```\n\n## Usage\n\nTo use the pins package, you must first create a pin board. A good place\nto start is `board_folder()`, which stores pins in a directory you\nspecify. Here I’ll use a special version of `board_folder()` called\n`board_temp()` which creates a temporary board that’s automatically\ndeleted when your R session ends. This is great for examples, but\nobviously you shouldn’t use it for real work!\n\n``` r\nlibrary(pins)\n\nboard <- board_temp()\nboard\n#> Pin board \n#> Path: '/var/folders/hv/hzsmmyk9393_m7q3nscx1slc0000gn/T/RtmpIz0TnO/pins-e094532135f'\n#> Cache size: 0\n```\n\nYou can “pin” (save) data to a board with `pin_write()`. It takes three\narguments: the board to pin to, an object, and a name:\n\n``` r\nboard %>% pin_write(head(mtcars), \"mtcars\")\n#> Guessing `type = 'rds'`\n#> Creating new version '20220923T183046Z-209d4'\n#> Writing to pin 'mtcars'\n```\n\nAs you can see, the data saved as an `.rds` by default, but depending on\nwhat you’re saving and who else you want to read it, you might use the\n`type` argument to instead save it as a `csv`, `json`, or `arrow` file.\n\nYou can later retrieve the pinned data with `pin_read()`:\n\n``` r\nboard %>% pin_read(\"mtcars\")\n#> mpg cyl disp hp drat wt qsec vs am gear carb\n#> Mazda RX4 21.0 6 160 110 3.90 2.620 16.46 0 1 4 4\n#> Mazda RX4 Wag 21.0 6 160 110 3.90 2.875 17.02 0 1 4 4\n#> Datsun 710 22.8 4 108 93 3.85 2.320 18.61 1 1 4 1\n#> Hornet 4 Drive 21.4 6 258 110 3.08 3.215 19.44 1 0 3 1\n#> Hornet Sportabout 18.7 8 360 175 3.15 3.440 17.02 0 0 3 2\n#> Valiant 18.1 6 225 105 2.76 3.460 20.22 1 0 3 1\n```\n\nA board on your computer is good place to start, but the real power of\npins comes when you use a board that’s shared with multiple people. To\nget started, you can use `board_folder()` with a directory on a shared\ndrive or in dropbox, or if you use [RStudio\nConnect](https://www.rstudio.com/products/connect/) you can use\n`board_rsconnect()`:\n\n``` r\nboard <- board_rsconnect()\n#> Connecting to RSC 1.9.0.1 at \nboard %>% pin_write(tidy_sales_data, \"sales-summary\", type = \"rds\")\n#> Writing to pin 'hadley/sales-summary'\n```\n\nThen, someone else (or an automated Rmd report) can read and use your\npin:\n\n``` r\nboard <- board_rsconnect()\nboard %>% pin_read(\"hadley/sales-summary\")\n```\n\nYou can easily control who gets to access the data using the RStudio\nConnect permissions pane.\n\nThe pins package also includes boards that allow you to share data on\nservices like Amazon’s S3 (`board_s3()`), Azure’s blob storage\n(`board_azure()`), and Microsoft SharePoint (`board_ms365()`). Learn\nmore in `vignette(\"pins\")`.","jobInfo":{"package":"pins","version":"1.0.3","parsingStatus":"success","parserVersion":2,"parsedAt":"2023-01-21T10:30:09+0000"}}

Description

Usage

Arguments