compress: Compress or decompress a file

View source: R/compress.R

compressR Documentation

Compress or decompress a file

Description

Compress or decompress using gzip, bzip2, or xz compression.

Usage

compress(
  file,
  ext = c("gz", "bz2", "xz", "zip"),
  remove = FALSE,
  overwrite = FALSE
)

decompress(file, remove = FALSE, overwrite = FALSE)

Arguments

file

character(1). File path.

ext

character(1). Compression file format extension. Uses match.arg() internally and defaults to the first argument in the character vector.

Supported formats:

  • gz: gzip compression; calls gzfile() internally.

  • bz: bzip2 (lzma) compression; calls bzfile() internally.

  • xz: xz compression; calls xzfile() internally.

  • zip: zip compression; calls zip() or unzip() internally.

remove

logical(1). Remove the input file once the output file is fully created and the connection is closed.

overwrite

logical(1). Overwrite existing file on disk.

Details

For ZIP files, refer to zip and unzip in the utils package.

Value

Invisible character(1). File path.

Note

Updated 2023-09-21.

See Also

  • help("connections")

  • R.utils::compressFile(), R.utils::decompressFile().

  • utils::zip(), utils::unzip().

  • utils::tar(), utils::untar().

  • memCompress(), memDecompress().

Examples

## Create an example text file.
text <- c("hello", "world")
file <- "test.txt"
writeLines(text = text, con = file)
readLines(con = file)

## Apply gzip compression.
gzfile <- compress(
    file = file,
    ext = "gz",
    remove = TRUE,
    overwrite = TRUE
)
print(gzfile)
readLines(con = gzfile)
## When `remove = TRUE`, the original input file will be removed.
file.exists(file)

## Decompress the gzipped file.
file <- decompress(
    file = gzfile,
    remove = TRUE,
    overwrite = TRUE
)
print(file)

## Clean up.
unlink2(file)

acidgenomics/acidbase documentation built on Jan. 26, 2024, 4:26 p.m.