clipr v0.3.3

0

Monthly downloads

0th

Percentile

Read and Write from the System Clipboard

Simple utility functions to read from and write to the Windows, OS X, and X11 clipboards.

Readme

clipr

CRAN status. Downloads, grand total Travis-CI Build Status AppVeyor Build Status

Simple utility functions to read and write from the system clipboards of Windows, OS X, and Unix-like systems (which require either xclip or xsel.)

Installation

Install from CRAN

install.packages("clipr")

Or try the development version

devtools::install_github("mdlincoln/clipr")

Usage

library("clipr")

cb <- read_clip()

# Character vectors with length > 1 will be collapsed with system-appropriate
# line breaks, unless otherwise specified

cb <- write_clip(c("Text", "for", "clipboard"))
cb
#> [1] "Text\nfor\nclipboard"

cb <- write_clip(c("Text", "for", "clipboard"), breaks = ", ")
cb
#> [1] "Text, for, clipboard"

write_clip also tries to intelligently handle data.frames and matrices, rendering them with write.table so that they can be pasted into a spreadsheet like Excel.

tbl <- data.frame(a = c(1, 2, 3), b = c(4, 5, 6))
cb <- write_clip(tbl)
cb
#> [1] "a\tb\n1\t4\n2\t5\n3\t6"

read_clip_tbl will try to parse clipboard contents from spreadsheets into data frames directly.

Developing with clipr

clipr's functionality on X11-based systems depends on the installation of additional software. Therefore, if you want to use clipr in your package, you will want to take some care in how you call it, and make sure that your package will respond gracefully if clipboard functionality is not working as expected. You can use the function clipr_available() to check if the clipboard is readable and writable by the current R session.

A few best practices will also help you responsibly test your clipr-using package on headless systems like CRAN or other testing infrastructure like Travis:

  1. Examples that will try to use read_clip() or write_clip() ought to be wrapped in \dontrun{}
  2. Tests calling clipr should be conditionally skipped, based on the output of clipr_available(). This is necessary to pass CRAN checks.
  3. If you are using Travis.ci to check your package build on Linux, consult the .travis.yml for this package, which includes code for setting the DISPLAY environment variable, installing xclip, and running a pre-build script that will set up xclip to run headlessly.

Nice uses of clipr

(a non-comprehensive list)

  1. reprex by @jennybc takes R code on the clipboard and renders a reproducible example from it, ready to then paste on to GitHub, Stack Overflow, or the like.
  2. datapasta by @milesmcbain eases the copying and pasting of R objects in and out of different sources (Excel, Google Sheets).
  3. curlconverter by @hrbrmstr translates cURL command lines into httr calls.

Matthew Lincoln

Functions in clipr

Name Description
clipr_available Is the system clipboard available?
read_clip Read clipboard
read_clip_tbl Transforms output of read_clip into data frame.
write_clip Write clipboard
clear_clip Clear clipboard
clipr clipr: Read and Write from the System Clipboard
No Results!

Last month downloads

Details

Type Package
SystemRequirements xclip (https://github.com/astrand/xclip) or xsel (http://www.vergenet.net/~conrad/software/xsel/) for accessing the X11 clipboard
License GPL-3
LazyData TRUE
URL https://github.com/mdlincoln/clipr
BugReports https://github.com/mdlincoln/clipr/issues
RoxygenNote 6.0.1
NeedsCompilation no
Packaged 2017-06-19 17:51:30 UTC; MLincoln
Repository CRAN
Date/Publication 2017-06-19 23:24:15 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/clipr)](http://www.rdocumentation.org/packages/clipr)