pin-read-write.md
In pins: Pin, Discover and Share Resources

can't pin_read() file that was pin_uploaded()

Code
  pin_read(board, "test")
Condition
  Error in `object_read()`:
  ! Pin does not declare file type so can't be automatically read
  i Retrieve uploaded paths with `pin_download()`

useful errors on bad inputs

Code
  pin_write(mtcars)
Condition
  Error in `pin_write()`:
  ! `board` must be a pin board, not a <data.frame> object.
Code
  pin_write(board, mtcars, name = 1:10)
Condition
  Error in `pin_write()`:
  ! `name` must be a string
Code
  pin_write(board, mtcars, name = "mtcars", "json")
Condition
  Error in `pin_write()`:
  ! Arguments after the dots `...` must be named, like `type = "json"`.
Code
  pin_write(board, mtcars, name = "mtcars", type = "froopy-loops")
Condition
  Error in `object_write()`:
  ! `type` must be one of "rds", "json", "parquet", "arrow", "pickle", "csv", or "qs", not "froopy-loops".
Code
  pin_write(board, mtcars, name = "mtcars", metadata = 1)
Condition
  Error in `pin_write()`:
  ! `metadata` must be a list or `NULL`, not the number 1.
Code
  pin_write(board, mtcars, title = "title", tags = list(a = "a"))
Condition
  Error in `pin_write()`:
  ! `tags` must be a character vector or `NULL`, not a list.
Code
  pin_write(board, mtcars, title = "title", urls = list(a = "a"))
Condition
  Error in `pin_write()`:
  ! `urls` must be a character vector or `NULL`, not a list.
Code
  pin_write(board, mtcars, title = "title", metadata = c("tag1", "tag2"))
Condition
  Error in `pin_write()`:
  ! `metadata` must be a list or `NULL`, not a character vector.

pin_write() noisily generates name and type

Code
  b <- board_temp()
  pin_write(b, mtcars)
Message
  Using `name = 'mtcars'`
  Guessing `type = 'rds'`
  Creating new version '20120304T050607Z-xxxxx'
  Writing to pin 'mtcars'
Code
  pin_write(b, data.frame(x = 1))
Condition
  Error in `pin_write()`:
  ! Must supply `name` when `x` is an expression

can request specific hash

Code
  b <- board_temp()
  pin_write(b, mtcars, name = "mtcars", type = "rds")
Message
  Creating new version '20120304T050607Z-xxxxx'
  Writing to pin 'mtcars'
Code
  pin_read(b, "mtcars", hash = "ABCD")
Condition
  Error in `pin_read()`:
  ! Specified hash "ABCD" doesn't match pin hash "dfa6c1c109362781".

informative error for legacy boards

Code
  board <- legacy_temp()
  board %>% pin_write(1:10, "x")
Condition
  Error in `pin_write()`:
  ! Use `pin()` with this board, not `pin_write()`
Code
  board %>% pin_read("x")
Condition
  Error in `pin_read()`:
  ! Use `pin_get()` with this board, not `pin_read()`