To check whether the system has been properly configured to allow access to the clipboard, you may run
clipr_available() which will either return
FALSE. This will be particularly useful for Linux-based systems, where clipr’s functionality depends on the installation of additional software. If you wish to display system requirements and configuration messages to X11 and Wayland users,
dr_clipr() will print these.
If you use clipr in your own package, you must not try to call it in non-interactive sessions, as this goes against CRAN repository policy:
Packages should not write in the user’s home filespace (including clipboards), nor anywhere else on the file system apart from the R session’s temporary directory (or during installation in the location pointed to by TMPDIR: and such usage should be cleaned up). Installing into the system’s R installation (e.g., scripts to its bin directory) is not allowed.
Limited exceptions may be allowed in interactive sessions if the package obtains confirmation from the user.
For this reason,
write_clip() will error by default in non-interactive use, which includes CRAN tests.
If you want to use
write_clip() non-interactively, you may either set the environment variable
CLIPR_ALLOW=TRUE or call
write_clip(..., allow_non_interactive = TRUE).
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:
write_clip()ought to be wrapped in
clipr_available(). This is necessary to pass CRAN checks, as otherwise
write_clipwill error out.
CLIPR_ALLOWenvironment variables, installing
xsel, and running a pre-build script that will set up
xselto run headlessly under XVFB.
clipr won’t do what you expect when you call it with Shiny.
clipr talks to the clipboard of the system that is running R. If you create a Shiny app and tell one of its functions to either read from or write to the clipboard, it can only access the clipboard of the server it is running on. R running on the remote server has no way to access the local clipboard belonging to your end user.
However, you can instruct the user’s internet browser to write to the user’s clipboard by using rclipboard.