Tools for Script Editing

A collection of useful tools for programming and writing-scripts. Several functions are simple wrappers around base R functions that extend their functionality while also providing some convenient properties–regular expression functions that automatically detect look-ahead and look-behind statements, a read-line function that suppresses incomplete-final-line warnings and automatically opens and closes connections, a version of substrings that starts from the end of strings, etc. Other functions are useful for checking whether packages are installed, omitting missing data, and showing in-use connections.


Travis buildstatus Coveragestatus

lifecycle

Various useful functions for working with data and writing functions

Install

Install from CRAN

## from CRAN repo
install.packages("tfse")

Install dev version from Github

## from github
remotes::install_github("mkearney/tfse")

Usage

Scales

Rescale to standard (0-1) scale

## 0-1 scale
rescale_standard(-2:2)
#> [1] 0.00 0.25 0.50 0.75 1.00

Rescale to normal (mean = 0; sd = 1) scale

## z scores
rescale_normal(-2:2)
#> [1] -1.2649111 -0.6324555  0.0000000  0.6324555  1.2649111

Rescale to arbitrary lower/upper bounds

## specify new scale bounds
rescale_pointscale(-2:2, 1, 10)
#> [1]  1.00  3.25  5.50  7.75 10.00

Citations

Print out the APA-formatted citation for R packages.

## print out APA citation for {rtweet}
apa_citation("rtweet")
#> ↪ Adding APA citation of {rtweet} to clipboard!
#> ✔ Ready to paste!
#> 
#> Kearney, M. W. (2018). rtweet: Collecting twitter data (R package version
#>     0.6.7) [Computer software]. The Comprehensive R Archive Network. Available
#>     from https://cran.r-project.org/package=rtweet

Annotate script files

Use box_code() to add a header-like chunk to your clipboard–paste in script as desired.

## store text in clipboard
box_code("EXAMPLE #1")
 
## the pasted output:
##----------------------------------------------------------------------------##
##                                 EXAMPLE #1                                 ##
##----------------------------------------------------------------------------##

Regular expressions

Get all regular expression matches (using easier looka-heads/look-behinds)

## some text
x <- c("This *is* a test", 
  "#this *was* a test", 
  "This *will* be a test!",
  "This *has been* a test; it *is* great.")
 
## return text between asterisks, return as atomic vector
regmatches_(x, "(?<=\\*)\\S[^*]+(?=\\*)", drop = TRUE)
#> [1] "is"       "was"      "will"     "has been" "is"

Github

Figure out the name of a Github repo for a given package

## repo name of devtools
desc_gh_repo("devtools")
#> [1] "r-lib/devtools"

Convert a Github link to the raw URL version

## path to raw version of Github file
github_raw("https://github.com/mkearney/driven-snow/blob/master/theme/driven-snow.rstheme")
#> [1] "https://raw.githubusercontent.com/mkearney/driven-snow/master/theme/driven-snow.rstheme"

Help

View the help documentation

## view R help documentatoin
help(package = "tfse")

about tfse

  • This is my personal R package of utility functions
  • Why tfse? The acronym was creatively reconfigured from its originally intended state

News

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("tfse")

0.5.0 by Michael W. Kearney, 10 months ago


https://tfse.mikewk.com


Report a bug at https://github.com/mkearney/tfse/issues


Browse source code at https://github.com/cran/tfse


Authors: Michael W. Kearney [aut, cre]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports utils, magrittr, dapr, stats

Suggests testthat, covr


Imported by ppcong, textfeatures.


See at CRAN