pins 1.0.0

CRAN release: 2021-10-02

pins 1.0.0 includes a new, more explicit, API that includes robust support for versioning. In the modern API, you create a board object which is passed to every pin_ function instead of “registering” a board that is later refereed to with a string. This leads to code like this:


board <- board_local()
board %>% pin_write(mtcars, "mtcars")
board %>% pin_read("mtcars")

The legacy API (pin(), pin_get(), and board_register()) will continue to work, but new features will only be implemented with the new API, so we encourage you to switch to the modern API as quickly as possible. Learn more in vignette("pins-update").

Modern pin functions

Modern boards

This version includes the following modern boards:

  • board_azure() stores data in Azure’s blob storage. It is built on top of AzureStor (#474).

  • board_folder() is a generalised replacement for the legacy local board. board_folder() can store data in any directory, making it possible to share boards using shared network drives or on dropbox or similar. If you using pins casually and don’t want to pick a directory, board_local() is a variant of board_folder() that stores data in a system data directory.

  • board_kaggle_dataset() and board_kaggle_competition() allow you to download data from Kaggle. The data is automatically cached so that it’s only downloaded when it changes.

  • board_ms365() allow to pin data to MS One Drive and Sharpoint (#498, @hongooi73).

  • board_rsconnect() shares data on RStudio connect. This board supports both modern and legacy APIs, so that you and your colleagues can use a mixture of pins versions as you transition to pins 1.0.0. Note that the compatibility is one directional: you can pin_read() pins created by pin(), but you can’t pin_get() pins created by pin_write().

  • board_s3() stores data in Amazon’s S3 service. It is built on top of paws.

  • board_url() lets you create a manual board from a vector of URLs. This is useful because pin_donwload() and pin_read() are cached, so they only re-download the data if it has changed since the last time you used it (#409). This board is a replacement for pin()’s ability to work directly with URLs

The legacy boards will continue to work with the legacy pins API; we will implement modern versions of the remaining legacy boards based on user feedback.

Minor improvements and bug fixes

  • All board objects now have class beginning with pins_board_ and also inherit from common superclass pins_board.

  • Pins no longer works with the connections pane. This automatically registered code tended to be either dangerous (because it’s easy to accidentally leak credentials) or useless (because it relied on variables that the connection pane doesn’t capture).

  • Pinned data frames are longer converted to tibbles.

  • The “packages” board is no longer registered by default; if you want to use this you’ll need to register with board_register("packages"). It has been radically simplified so that it will no longer download packages, and it pin_find() now searches all packages that you have installed, rather than a stale snapshot of data in CRAN packages. The CRAN files dataset has been removed from the package.

  • board_browse() now works with local boards.

  • board_rsconnect() will automatically connect to the current RSC pin board when run inside RSC itself (assuming you have version 1.8.8 or later) (#396).

  • cache_browse(), cache_info(), and cache_prune() provide some basic tooling around the local pins cache maintained by pins (#438).

  • pin_fetch() has been removed

  • option(pins.invisible) is now defunct and ignored.

  • You can no longer switch from a versioned pin to an unversioned pin without first deleting the pin (#410).

pins 0.4.5

CRAN release: 2021-01-05

Pins

  • Support downloading remote files when service returns incompatible data.txt file (#310).

  • Support for pins over 100MB in Windows systems (#313).

  • Avoid Windows crashing in pin() under some locales (#127).

Boards

  • Silenced ‘no encoding supplied’ warning (#330).

Local

  • pin_find() no longer searches text with an undocumented regular expression syntax (#270).

S3

  • Default to using HTTPS in S3 boards (#304).

  • Support for AWS V4 signatures when registering S3 boards with region parameter (#304)

Cloud

  • Support for path to register a board under a subpath for Azure, DigitalOcean, Google Cloud and S3 boards (#200).

  • Avoid creating pins named with unsupported characters for Azure, DigitalOcean, Google Cloud and S3 boards (#193).

GitHub

  • Properly store relative paths when path parameter is specified in GitHub boards (#199).

  • Add support for repos with a ‘main’ branch as default (#336).

  • Add support for large file in private repo releases (#292).

  • When a board is registered with versions = FALSE, GitHub tags are also delete when large files are present (#285).

RStudio Connect

  • Invalid ‘account’ or ‘server’ parameters show proper errors (#296).

  • Increase total entries retrieved with pin_find(), configurable with pins.search.count (#296).

  • Fix regression introduced in pins 0.4.2 (#253) preventing users from collaborating on existing pins they have access to (#302).

  • Avoid deleting pin when upload fails to avoid deleting versions (#306).

  • Support re-creating pins from pins not previously properly updated (#308).

  • Adjust pin preview to only display 1K rows instead of 10K (#315).

  • Avoid changing columns names on data frame preview (#190).

  • Improve error message when token authentication fails (#327).

pins 0.4.4

CRAN release: 2020-10-30

Pins

  • For files bigger than 100MB pin() creates symlinks to speed up uploads, can be configured using the pins.link.size option (#273).

  • When using pin(zip = TRUE) the zip no longer contains local patahs (#277).

Google Cloud

  • Disable caching on data.txt to support creating multiple pins at once (#275).

RStudio

  • Prevent connections pane from hanging when multiple pins are updated at once (#280).

Website

  • Support for pin_get(download = FALSE) to avoid checking for updates.

RStudio Connect

  • Support for servers with mismatched http vs https protocols.

  • Make use of RSCONNECT_TAR when running a report inside RStudio Connect (#293).

pins 0.4.3

CRAN release: 2020-07-10

Boards

  • Properly export board_pin_versions to allow custom boards extending versions (#265).

Website

  • Fix regression creating pins when using a brand new cloud board (#268).

pins 0.4.2

CRAN release: 2020-07-05

Website

  • Fix issue removing pins with custom domain names from cloud boards (#234).

  • Fix warning when using pin() against storage locations with custom domain name (#237).

  • Fix issue where datatxt was not refreshing deleted entries (#239).

RStudio Connect

  • Support for versions = FALSE in board_register() to avoid using too much space when creating pins (#245).

  • Prevent administrators from overriding pins they don’t own, unless the pin is specified as user/name (#253).

  • Support to connect to servers that have a redirect configured when the full server URL is not specified in board_register() (#256).

  • Throw error when multiple accounts are associated to the same server (#261).

pins 0.4.1

CRAN release: 2020-05-28

Pin

  • When running in production environments (which usually set the R_CONFIG_ACTIVE environment variable), avoid using shared caches.

  • Fix pin() failing to update cache when server returns NULL etag.

  • Support for custom_metadata in pin() to allow saving custom fields in data.txt file.

  • Improve performannce for pin() from URLs containing large files that are already been cached prerviously by pin() (#225).

  • Avoid showing upload or download progress when creating R Markdown documents and other non-interactive use cases (#227).

  • When pin(url) fails and local cache exists, produce warning and retrieve cached version (#231).

  • Support for pin(zip = TRUE) to create a zip file of the given path before creating the pin (#232).

RStudio Connect

  • Fix when overriding pin with corrupt metadata.

  • Avoid using shared caches when running inside RStudio Connect.

  • Fixed ‘invalid uid’ warning when creaating pin undner some Linux servers (#263).

Kaggle

  • Support to find and download competition datasets.

pins 0.4.0

CRAN release: 2020-04-07
  • Support for versioning in all boards.

  • Support for DigitalOcean board.

Pin

  • Finding pins with pin_find() sort results by default (#201).

  • Avoid incomplete final line found warning error wheen reading manifests.

  • Support for using pin() across multiple concurrent processes (#182).

  • Support in pin_get() to download arbitrary files from cloud boards like Azure, DigitalOcean, GitHub, Google Cloud, RStudio Connect, and S3.

  • Fix issue where http HEAD requests could tgimeout and prevent pin from downloading in very slow connections.

RStudio

  • Support access_type parameter for RStudio Connect.

  • pin() now refreshes the connections pane.

  • pin_remove() now refreshes the connections pane.

RStudio Connect

  • Support for code parameter in pin() to customize R code used in the UI to retrieve the pin (#77).

  • Improve error message for pin_get() with duplicate names (#171).

  • Fix board register error when using URL with ports (#195).

  • Enable retrieving public pins without authentication (#83).

GitHub

  • Support for versions = FALSE in board_register() to also delete release files when pin is removed (#91).

  • Support for versions = FALSE in board_register() to avoid creating versioned GitHub releases (#197).

  • Support for committing all github files with a single commit (#197).

  • Support for custom GitHub hosts including GitHub Enterprise using the host parameter in board_register_github() (#163).

Websites

  • Using pin() now searches for data.txt files in URLs when the URL contains no file extension, behavior can be turnned off with the pins.search.datatxt option.

pins 0.3.2

CRAN release: 2020-02-06

Pins

  • pin_info() adds support for metadata parameter to avoid retrieving pin contents.

S3

  • Added support for host parameter to configure “s3.amazonaws.com” to custom locations.

GitHub

  • Fix regression uploading large datasets as release files.

pins 0.3.1

CRAN release: 2020-01-10

Pins

  • pin_info() prints long character strings in their own line.

  • Fixed issue in pin_remove() for S3, Azure, GCloud, Google and website boards (#138).

  • Fixed issue when pinning complex data frames with nested lists (#142).

Azure

RStudio

  • Fixed connection suggested code when caused by pin_find() (#137).

  • Fixed connection launcher for Azure connections.

RStudio Connect

  • Fix issue uploading large pins causing is.character(type) is not TRUE error.

  • Fix issue affecting boards registered with trailing slash (#151).

  • Improve error messages when a pin fails to be created (#149).

  • Added support for CONNECT_API_KEY and CONNECT_SERVER in place of RSCONNECT_API and RSCONNECT_SERVER, which they are still supported for backwards-compatibility.

pins 0.3.0

CRAN release: 2019-11-26
  • Support for Azure board.

  • Support for Google Cloud board.

  • Support for S3 board.

Pins

  • pin() extracts URLs that end in .gz and zip, which can be disabled with pin("<url>", extract = FALSE).

  • pin() no longer prints the pin, you can revert this behavior with options(pins.invisible = FALSE) (#122).

  • Show upload progress for files larger than 10mb.

  • Avoid changing data.table when using pin() and get_pin().

  • Support for pin_info() to describe a pin and extended = TRUE in pin_find() to show all extended information about each pin.

  • Support for extract parameter in pin_get(), pin(), and pin_reactive() to override default file extraction behavior.

  • Support to extract gzip files when the R.utils package is installed.

  • Show download progress for files larger than 10mb.

  • Support for I() to force a pin to be created without additional overhead of exporting CSV and other enhancements (#73).

  • Support creating automatic name when using pin() and multiple URL.

Boards

  • Avoid “cannot create dir” warning in systems with an empty cache folder.

RStudio

  • Gracefully handle errors when a pin’s preview can’t be created.

  • Website boards now support the browse menu item in the connection.

  • Fix data frames previewing character columns with special characters.

  • Fix connection code when a board is registered automatically.

RStudio Connect

  • Fix issue where pin_find() would not show all available pins.

  • Fix issue where RStudio Connections pane would not show all pins.

  • Store all downloaded content under user subfolder insited rsconnect cache.

  • Removed pin_find() workaround for beta rsconnect server where searching was causing timeout.

  • Fix for RStudio Connect servers where /content/ is not used in content URLs.

  • Fix issue expanding pins columns in RStudio for pins with similar names in RStudio Connect boards.

  • Fix issue removing pins with similar names in RStudio Connect boards.

Python

  • Support for Python 3.

Websites

GitHub

  • Various fixes for GitHub boards using the path parameter when registering the board (#121).

pins 0.2.0

CRAN release: 2019-10-01

RStudio Connect

  • Support for retrieving pins shared by others in RStudio Connect boards.

  • Support for RStudio Connect servers running under a subpath in the server.

  • Add support for RSCONNECT_SERVER environment variable to ease configuration of automated RStudio Connect reports.

  • Fix intermittent failure to retrieve pins from RStudio Connect boards while creating them.

  • Fix in RStudio Connect boards to retrieve pins that match other pin names (#45).

  • Fix for data frames with nested data frames in rsconnect boards (#36).

GitHub

  • board_register_github() now checks for the repo to exist (#63).

  • Adjusted max upload file to 25mb to avoid “server error” in the API, larger files than 25mb uploaded as release files. This can be configured using the pins.github.release option, which deefaults to 25.

  • Allow overriding GitHub pin over a pin that partially failed to be created.

Boards

  • Using a board will attempt to automatically register, such that pin(iris, board = "rsconnect") would work for the default configuration even when the board is not explicitly registered (#50).

  • Registers “local” board by default, you no longer need to explicitly run board_register_local() (#56).

  • Make use of the rappdirs package to define the default cache path, replaces ~/.pins. Use board_cache_path() to retrieve default cache path.

Websites

  • Fix for data.txt boards created from GitHub boards using large files.

pins 0.1.2

CRAN release: 2019-09-04
  • Support to upload files larger than 50mb in GitHub boards as release files.

pins 0.1.1

CRAN release: 2019-08-30
  • Fix CRAN request to explicitly opt-in to use local home path as cache by running board_register_local().

  • Fix error when retrieving pins from Kaggle boards (#31).

  • Support for large files in GitHub board (#30).

pins 0.1.0

CRAN release: 2019-08-28
  • Support for local board.

  • Support for Kaggle board.

  • Support for packages board.

  • Support for RStudio Connect board.

  • Support for GitHub board.

  • Support for website board.