README.Rmd

---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# fuj <a href='https://github.com/jmbarbone/fuj'><img src='man/figures/logo.png' align="right" height="139" /></a>

<!-- badges: start -->
[![R-CMD-check](https://github.com/jmbarbone/fuj/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/jmbarbone/fuj/actions/workflows/R-CMD-check.yaml)
[![Codecov test coverage](https://codecov.io/gh/jmbarbone/fuj/branch/main/graph/badge.svg)](https://app.codecov.io/gh/jmbarbone/fuj?branch=main)
[![CRAN status](https://www.r-pkg.org/badges/version/fuj)](https://CRAN.R-project.org/package=fuj)
<!-- badges: end -->

The goal of `{fuj}` is to provide low level tools for other packages by [Jordan](https://github.com/jmbarbone).

## Installation

Install `{fuj}` from CRAN with:

``` r
install.packages("fuj")
```

Alternatively, you can install the development version of `{fuj}` [GitHub](https://github.com/) with:

```
# install.packages("devtools")
devtools::install_github("jmbarbone/fuj")
```

## Example

```{r examples}
library(fuj)
```

Quicker `data.frame`s:

```{r quick_df}
quick_df(list(a = 1:5, b = letters[1:5]))
quick_dfl(a = 1:3, b = list(1:5, 6:10, 11:15))
```

More extensions:

```{r matching}
1:10 %out% c(1, 3, 5, 9)       # opposite of %in% 
letters[1:5] %wo% letters[3:7]
letters[1:5] %wi% letters[3:7]
```

Simple structures:

```{r struct}
struct(list(a = 1, b = 2), class = "foo", c = 3, d = 3)
```

Suppress messages and warnings:

```{r}
foo <- function(...) { message(paste0(list(...))) ; c(...) }
muffle(foo(1:3))
sapply(1:3, muffle(fun = foo))

x <- list("a", 1)
wuffle(as.integer(x))
sapply(x, wuffle(fun = as.integer))
```