{"id":13400602,"url":"https://github.com/rstudio/pins-r","last_synced_at":"2025-12-12T01:02:32.528Z","repository":{"id":37484314,"uuid":"177171231","full_name":"rstudio/pins-r","owner":"rstudio","description":"Pin, discover, and share resources","archived":false,"fork":false,"pushed_at":"2025-04-30T19:55:46.000Z","size":39672,"stargazers_count":325,"open_issues_count":31,"forks_count":65,"subscribers_count":29,"default_branch":"main","last_synced_at":"2025-05-10T11:52:29.385Z","etag":null,"topics":["azure","gcloud","rpins","rsconnect","rstats","s3","storage"],"latest_commit_sha":null,"homepage":"https://pins.rstudio.com","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rstudio.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-03-22T16:06:23.000Z","updated_at":"2025-04-30T19:51:48.000Z","dependencies_parsed_at":"2022-07-13T13:50:36.725Z","dependency_job_id":"b21b155d-d917-4211-83bd-22b74058125d","html_url":"https://github.com/rstudio/pins-r","commit_stats":{"total_commits":2168,"total_committers":51,"mean_commits":"42.509803921568626","dds":0.2398523985239852,"last_synced_commit":"621368ce4085f2f7047f080dfdf7b40efdebebf0"},"previous_names":["rstudio/pins"],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Fpins-r","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Fpins-r/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Fpins-r/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Fpins-r/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rstudio","download_url":"https://codeload.github.com/rstudio/pins-r/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253411503,"owners_count":21904143,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure","gcloud","rpins","rsconnect","rstats","s3","storage"],"created_at":"2024-07-30T19:00:53.782Z","updated_at":"2025-12-12T01:02:23.468Z","avatar_url":"https://github.com/rstudio.png","language":"R","funding_links":[],"categories":["R","Backend"],"sub_categories":["Persistent Data Storage"],"readme":"---\noutput:\n  github_document:\n    fig_width: 8\n    fig_height: 4\n---\n\n```{r, echo=FALSE, message=FALSE}\nknitr::opts_chunk$set(\n  fig.path = \"tools/readme/\", \n  dev = \"png\",\n  dpi = 96,\n  comment = \"#\u003e\",\n  collapse = TRUE\n)\n```\n\n# pins \u003ca href=\"https://pins.rstudio.com\"\u003e\u003cimg src=\"man/figures/logo.png\" align=\"right\" height=\"138\" alt=\"pins website\" /\u003e\u003c/a\u003e\n\n\u003c!-- badges: start --\u003e\n\n[![R-CMD-check](https://github.com/rstudio/pins-r/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/rstudio/pins-r/actions/workflows/R-CMD-check.yaml)\n[![CRAN Status](https://www.r-pkg.org/badges/version/pins)](https://cran.r-project.org/package=pins) \n[![Codecov test coverage](https://codecov.io/gh/rstudio/pins-r/branch/main/graph/badge.svg)](https://app.codecov.io/gh/rstudio/pins-r?branch=main)\n[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)\n\u003c!-- badges: end --\u003e\n\nThe pins package publishes data, models, and other R objects, making it easy to share them across projects and with your colleagues.\nYou can pin objects to a variety of pin *boards*, including folders (to share on a networked drive or with services like DropBox), Posit Connect, Databricks, Amazon S3, Google Cloud Storage, Azure storage, and Microsoft 365 (OneDrive and SharePoint).\nPins can be automatically versioned, making it straightforward to track changes, re-run analyses on historical data, and undo mistakes.\n\nYou can use pins from Python as well as R. For example, you can use one language to read a pin created with the other. Learn more about [pins for Python](https://rstudio.github.io/pins-python/).\n\n## Installation\n\nYou can install pins from CRAN with:\n\n```{r, eval = FALSE}\ninstall.packages(\"pins\")\n```\n\nYou can install the development version from GitHub:\n\n```{r, eval = FALSE}\n# install.packages(\"pak\")\npak::pak(\"rstudio/pins-r\")\n```\n\n## Usage\n\nTo use the pins package, you must first create a pin board.\nA good place to start is `board_folder()`, which stores pins in a directory you specify.\nHere I'll use a special version of `board_folder()` called `board_temp()` which creates a temporary board that's automatically deleted when your R session ends.\nThis is great for examples, but obviously you shouldn't use it for real work!\n\n```{r setup}\nlibrary(pins)\n\nboard \u003c- board_temp()\nboard\n```\n\nYou can \"pin\" (save) data to a board with `pin_write()`.\nIt takes three arguments: the board to pin to, an object, and a name:\n\n```{r}\nboard %\u003e% pin_write(head(mtcars), \"mtcars\")\n```\n\nAs you can see, the data saved as an `.rds` by default, but depending on what you're saving and who else you want to read it, you might use the `type` argument to instead save it as a Parquet, Arrow, CSV, or JSON file.\n\nYou can later retrieve the pinned data with `pin_read()`:\n\n```{r}\nboard %\u003e% pin_read(\"mtcars\")\n```\n\nA board on your computer is good place to start, but the real power of pins comes when you use a board that's shared with multiple people.\nTo get started, you can use `board_folder()` with a directory on a shared drive or in dropbox, or if you use [Posit Connect](https://posit.co/products/enterprise/connect/) you can use `board_connect()`:\n\n```{r}\n#| eval: false\nboard \u003c- board_connect()\n#\u003e Connecting to Posit Connect 2024.08.0 at \u003chttps://pub.current.posit.team\u003e\nboard %\u003e% pin_write(tidy_sales_data, \"sales-summary\", type = \"rds\")\n#\u003e Writing to pin 'hadley/sales-summary'\n```\n\nThen, someone else (or an automated Quarto report) can read and use your pin:\n\n```{r}\n#| eval: false\nboard \u003c- board_connect()\nboard %\u003e% pin_read(\"hadley/sales-summary\")\n```\n\nYou can easily control who gets to access the data using the Posit Connect permissions pane.\n\nThe pins package also includes boards that allow you to share data on services like Databricks Volumes (`board_databricks()`), Amazon's S3 (`board_s3()`), Azure's blob storage (`board_azure()`), and Google Cloud Storage (`board_gcs()`). \nLearn more in `vignette(\"pins\")`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstudio%2Fpins-r","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frstudio%2Fpins-r","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstudio%2Fpins-r/lists"}