Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/insightsengineering/rlistings
Value formatting and ASCII rendering infrastructure for tables and listings.
https://github.com/insightsengineering/rlistings
Last synced: about 1 month ago
JSON representation
Value formatting and ASCII rendering infrastructure for tables and listings.
- Host: GitHub
- URL: https://github.com/insightsengineering/rlistings
- Owner: insightsengineering
- Created: 2021-11-30T21:44:35.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-11T10:40:21.000Z (8 months ago)
- Last Synced: 2024-04-14T15:25:02.295Z (8 months ago)
- Language: R
- Homepage: https://insightsengineering.github.io/rlistings/
- Size: 13.9 MB
- Stars: 18
- Watchers: 7
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.Rmd
- Contributing: .github/CONTRIBUTING.md
- Code of conduct: .github/CODE_OF_CONDUCT.Rmd
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- top-pharma50 - **insightsengineering/rlistings** - 06-07 13:34:58 | (Ranked by starred repositories)
- top-pharma50 - **insightsengineering/rlistings** - 06-07 13:34:58 | (Ranked by starred repositories)
- jimsghstars - insightsengineering/rlistings - Value formatting and ASCII rendering infrastructure for tables and listings. (R)
README
---
output: github_document
editor_options:
chunk_output_type: console
markdown:
wrap: 72
---
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
```
# rlistings 
[](https://insightsengineering.github.io/rlistings/main/unit-test-report/)
[](https://insightsengineering.github.io/rlistings/)
[](https://insightsengineering.github.io/rlistings/main/coverage-report/)
[](https://www.repostatus.org/#wip)
[](https://github.com/insightsengineering/rlistings/tree/main)
[](https://github.com/insightsengineering/rlistings/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
## Listings with R
The `rlistings` R package is a package that was designed to create and
display listings with R. The focus of this package is to provide
functionality for value formatting and ASCII rendering infrastructure
for tables and listings. Many of the functions contained in `rlistings`
depend on the
[`formatters`](https://insightsengineering.github.io/formatters/)
package, which provides a framework for ASCII rendering and is available
on CRAN.
`rlistings` development is driven by the need to create regulatory ready
listings for health authority review. Some of the key requirements for
this undertaking are listed below:
- flexible formatting (pagesize, column widths, alignment, labels,
etc.)
- multiple output formats (csv, out, txt)
- repeated key columns
- flexible pagination in both horizontal and vertical directions
- titles and footnotes
`rlistings` currently covers some of these requirements, and remains
under active development.
## Installation
`rlistings` is available on CRAN and you can install the latest released
version with:
``` r
install.packages("rlistings")
```
or you can install the latest development version directly from GitHub
with:
``` r
# install.packages("pak")
pak::pak("insightsengineering/rlistings")
```
Packaged releases (both those on CRAN and those between official CRAN
releases) can be found in the [releases
list](https://github.com/insightsengineering/rlistings/releases).
To understand how to use this package, please refer to the [Introduction to `rlistings`](https://insightsengineering.github.io/rlistings/latest-tag/articles/rlistings.html) article, which provides multiple examples of code implementation.
## Cheatsheet
## Usage
The following example shows a simple listing and its printed output.
```{r}
library(rlistings)
# Reducing the data
mtcars_ex <- mtcars %>% dplyr::mutate("car" = rownames(mtcars))
as_listing(mtcars_ex,
key_cols = c("gear", "carb"),
disp_cols = c("gear", "carb", "qsec", "car")
) %>% head()
```
## Acknowledgment
This package is a result of a joint effort by many developers and
stakeholders. We would like to thank everyone who contributed so far!
## Stargazers and Forkers
### Stargazers over time
[](https://starchart.cc/insightsengineering/rlistings)
### Stargazers
[](https://github.com/insightsengineering/rlistings/stargazers)
[](https://github.com/insightsengineering/rlistings/network/members)