https://github.com/colearendt/shinytail

A shiny input/output that tails a file for display in the browser
https://github.com/colearendt/shinytail

r r-package shiny

Last synced: 14 days ago
JSON representation

A shiny input/output that tails a file for display in the browser

• Host: GitHub
• URL: https://github.com/colearendt/shinytail
• Owner: colearendt
• License: other
• Created: 2018-08-25T02:56:38.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2018-08-31T18:43:11.000Z (about 6 years ago)
• Last Synced: 2024-10-11T18:23:17.557Z (30 days ago)
• Topics: r, r-package, shiny
• Language: R
• Homepage:
• Size: 20.5 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - colearendt/shinytail - A shiny input/output that tails a file for display in the browser (R)

README

        
# Shiny Tail

Have you ever wanted to follow a log file in real-time within a Shiny app? If you are familiar with linux, you might be looking for `tail -f my.log`.

The `shinytail` package should fill this desire. It provides helpers to easily:

 - use `processx` to execute `tail -f my.log` on the server (`tailFile`)

 - stream the results into Shiny using `readStream`

 - display the results in a "stream-friendly" UI widget called `shinyTail`

We also provide a helper for writing such streams to a file during testing (`writeStream`).

## Get Started

Install the latest development version:

```

devtools::install_github("colearendt/shinytail")

```

## Examples

There is a [simple example app](./inst/examples/01-shinytail-example) in this repository.

Another use case is to use [RStudio Server

Pro](https://www.rstudio.com/products/rstudio-server-pro/) with [R console

auditing](http://docs.rstudio.com/ide/server-pro/auditing-and-monitoring.html#auditing-configuration)

along with `shinytail` for a real-time, live-coding Shiny app! This approach can

be useful for training and workshops.

## Helpful Tips

- If you are trying to use R console auditing, be sure to restart the RStudio

Server Pro service _and_ the R session after the configuration option

`audit-r-console=input` is set. Otherwise, no auditing will happen.

- Something strange happens when _writing_ a stream in a background process of a

Shiny application. We are not sure yet if this is a `callr` and `shiny`

compatibility issue or where the problem is occurring.